"nika: v1\nworkflow:\n  id: csv-chart-report\n  description: \"CSV → aggregate → rendered bar chart + markdown report · offline · deterministic\"\n\nconst:\n  sales_csv: \"examples/fixtures/sales.csv\" # columns · region,revenue (revenue a plain number)\n\npermits:\n  exec: false\n  tools: [\"nika:chart\", \"nika:convert\", \"nika:jq\", \"nika:read\", \"nika:write\"]\n  fs:\n    # The one CSV this reads, named exactly. `data/**` would have granted a\n    # whole tree to a workflow that opens a single file.\n    read: [\"examples/fixtures/sales.csv\"]\n    # Two artifacts land here — the SVG and the report page. `**` because the\n    # chart and the report are written by two different builtins into the\n    # same tree, and both are covered by one honest entry.\n    write: [\"out/**\"]\n\ntasks:\n  raw:\n    invoke:\n      tool: \"nika:read\"\n      args: { path: \"\u0024{{ const.sales_csv }}\" }\n\n  rows:\n    with:\n      raw: \u0024{{ tasks.raw.output }}\n    invoke:\n      tool: \"nika:convert\"\n      args:\n        input: \"\u0024{{ with.raw }}\"\n        from: csv\n        to: json\n        has_header: true\n\n  # Sum revenue per region · a deterministic reduce, no model.\n  by_region:\n    with:\n      rows: \u0024{{ tasks.rows.output }}\n    invoke:\n      tool: \"nika:jq\"\n      args:\n        input: \"\u0024{{ with.rows }}\"\n        expression: 'group_by(.region) | map({ region: .[0].region, revenue: (map(.revenue | tonumber) | add) })'\n\n  # The picture · one SVG, its sha lands in the trace.\n  chart:\n    with:\n      by_region: \u0024{{ tasks.by_region.output }}\n    invoke:\n      tool: \"nika:chart\"\n      args:\n        data: \"\u0024{{ with.by_region }}\"\n        semantics: { region: category, revenue: usd }\n        chart: { type: bar, x: region, y: revenue, title: \"Revenue by region\" }\n        out: out/revenue-by-region.svg\n\n  # The rows as MARKDOWN · a report renders lines, never a JSON blob\n  # (region names are user data — the esc guards a `|` in them).\n  rows_md:\n    with:\n      by_region: \u0024{{ tasks.by_region.output }}\n    invoke:\n      tool: \"nika:jq\"\n      args:\n        input: \"\u0024{{ with.by_region }}\"\n        expression: >-\n          def esc: tostring | gsub(\"\\\\|\"; \"\\\\|\") | gsub(\"\\n\"; \" \");\n          map(\"| \\(.region | esc) | \\(.revenue) |\") | join(\"\\n\")\n\n  # The page · the report references the picture beside it.\n  report:\n    with:\n      rows_md: \u0024{{ tasks.rows_md.output }}\n    after:\n      chart: success\n    invoke:\n      tool: \"nika:write\"\n      args:\n        path: out/revenue-report.md\n        content: |\n          # Revenue by region\n\n          ![Revenue by region](revenue-by-region.svg)\n\n          | region | revenue |\n          | --- | --- |\n          \u0024{{ with.rows_md }}\n\n          *Generated offline by [nika](https://nika.sh) · the chart's sha is in the run trace (`nika trace verify`).*\n\noutputs:\n  by_region:\n    value: \u0024{{ tasks.by_region.output }}\n    description: \"Per-region revenue totals · the chart + report render from this\"\n"

{"a":{"graph_format":2,"workflow":"csv-chart-report","nodes":[{"id":"raw","verb":"invoke","tool":"nika:read","permits":["tool: nika:read"]},{"id":"rows","verb":"invoke","tool":"nika:convert","permits":["tool: nika:convert"]},{"id":"by_region","verb":"invoke","tool":"nika:jq","permits":["tool: nika:jq"]},{"id":"chart","verb":"invoke","tool":"nika:chart","permits":["fs.write: out/revenue-by-region.svg","tool: nika:chart"]},{"id":"rows_md","verb":"invoke","tool":"nika:jq","permits":["tool: nika:jq"]},{"id":"report","verb":"invoke","tool":"nika:write","permits":["fs.write: out/revenue-report.md","tool: nika:write"]}],"edges":[{"from":"by_region","to":"chart","kind":"value"},{"from":"by_region","to":"rows_md","kind":"value"},{"from":"chart","to":"report","kind":"control"},{"from":"raw","to":"rows","kind":"value"},{"from":"rows","to":"by_region","kind":"value"},{"from":"rows_md","to":"report","kind":"value"}]},"engine":"0.106.1"}

showcase · tier 2 · business

CSV chart report

convert types the spreadsheet, jq aggregates, chart renders a real image, write assembles the report. Zero model calls.

Paste the export, get the slide: same data, same bytes, works on a plane. · conformance-gated in nika-spec ↗ · re-proven at every push

6tasksthe plan falls out of the bindings
5wavesparallel by construction
1verbs exercisedinvoke
T2the tierbusiness

The whole file

6 tasks · 5 waves

The plan falls out of the bindings, nothing is scheduled by hand.

csv-chart-report.nika.yamlsource

1nika: v12workflow:3  id: csv-chart-report4  description: "CSV → aggregate → rendered bar chart + markdown report · offline · deterministic"56const:7  sales_csv: "examples/fixtures/sales.csv" # columns · region,revenue (revenue a plain number)89⛨permits:10  ⛨exec: false11  ⛨tools: ["nika:chart", "nika:convert", "nika:jq", "nika:read", "nika:write"]12  ⛨fs:13    # The one CSV this reads, named exactly. `data/**` would have granted a14    # whole tree to a workflow that opens a single file.15    ⛨read: ["examples/fixtures/sales.csv"]16    # Two artifacts land here — the SVG and the report page. `**` because the17    # chart and the report are written by two different builtins into the18    # same tree, and both are covered by one honest entry.19    ⛨write: ["out/**"]2021tasks:22  raw:23    ◆invoke:24      tool: "nika:read"25      args: { path: "${{ const.sales_csv }}" }2627  rows:28    with:29      raw: ${{ tasks.raw.output }}30    ◆invoke:31      tool: "nika:convert"32      args:33        input: "${{ with.raw }}"34        from: csv35        to: json36        has_header: true3738  # Sum revenue per region · a deterministic reduce, no model.39  by_region:40    with:41      rows: ${{ tasks.rows.output }}42    ◆invoke:43      tool: "nika:jq"44      args:45        input: "${{ with.rows }}"46        expression: 'group_by(.region) | map({ region: .[0].region, revenue: (map(.revenue | tonumber) | add) })'4748  # The picture · one SVG, its sha lands in the trace.49  chart:50    with:51      by_region: ${{ tasks.by_region.output }}52    ◆invoke:53      tool: "nika:chart"54      args:55        data: "${{ with.by_region }}"56        semantics: { region: category, revenue: usd }57        chart: { type: bar, x: region, y: revenue, title: "Revenue by region" }58        out: out/revenue-by-region.svg5960  # The rows as MARKDOWN · a report renders lines, never a JSON blob61  # (region names are user data — the esc guards a `|` in them).62  rows_md:63    with:64      by_region: ${{ tasks.by_region.output }}65    ◆invoke:66      tool: "nika:jq"67      args:68        input: "${{ with.by_region }}"69        expression: >-70          def esc: tostring | gsub("\\|"; "\\|") | gsub("\n"; " ");71          map("| \(.region | esc) | \(.revenue) |") | join("\n")7273  # The page · the report references the picture beside it.74  report:75    with:76      rows_md: ${{ tasks.rows_md.output }}77    after:78      chart: success79    ◆invoke:80      tool: "nika:write"81      args:82        path: out/revenue-report.md83        content: |84          # Revenue by region8586          ![Revenue by region](revenue-by-region.svg)8788          | region | revenue |89          | --- | --- |90          ${{ with.rows_md }}9192          *Generated offline by [nika](https://nika.sh) · the chart's sha is in the run trace (`nika trace verify`).*9394outputs:95  by_region:96    value: ${{ tasks.by_region.output }}97    description: "Per-region revenue totals · the chart + report render from this"98

nika inspect · engine 0.106.1 · vendored graph, never re-derived

6 declared edges · 5 waves · the plan falls out of the bindings

try itopen in the playground guidethe walkthrough · docs verbinvoke toolnika:read toolnika:convert toolnika:jq toolnika:chart toolnika:write