nika: v1
workflow:
  id: localization-factory
  description: "glob docs → parallel read → parallel translate → mirror tree"

model: ollama/qwen3.5:4b   # local default · swap for mistral/mistral-large (EU model for EU locales)

vars:
  lang: "fr"
  source_glob: "./docs/**/*.md"

tasks:
  files:
    invoke:
      tool: "nika:glob"
      args:
        pattern: "${{ vars.source_glob }}"
        exclude: ["**/node_modules/**"]

  texts:
    with:
      files: ${{ tasks.files.output }}
    for_each: ${{ with.files }}
    max_parallel: 8
    invoke:
      tool: "nika:read"
      args: { path: "${{ item }}" }

  pairs:
    with:
      files: ${{ tasks.files.output }}
      texts: ${{ tasks.texts.output }}
    invoke:
      tool: "nika:jq"
      args:
        input: ["${{ with.files }}", "${{ with.texts }}"]
        expression: "transpose | map({path: .[0], text: .[1]})"

  translated:
    with:
      pairs: ${{ tasks.pairs.output }}
    for_each: ${{ with.pairs }}
    max_parallel: 3                    # rate-limit the provider
    fail_fast: false                   # finish the batch · a failed file yields null at its index
    on_error:
      recover: null                    # null keeps the transpose zip aligned (order preserved)
    infer:
      prompt: |
        Translate to ${{ vars.lang }} · keep markdown structure, code blocks
        untouched, and the original tone ·
        ${{ item.text }}

  bundle:
    with:
      pairs: ${{ tasks.pairs.output }}
      translated: ${{ tasks.translated.output }}
    invoke:
      tool: "nika:jq"
      args:
        input: ["${{ with.pairs }}", "${{ with.translated }}"]
        expression: "transpose | map(select(.[1] != null)) | map({path: .[0].path, text: .[1]})"

  mirror:
    with:
      bundle: ${{ tasks.bundle.output }}
    for_each: ${{ with.bundle }}
    max_parallel: 8
    invoke:
      tool: "nika:write"
      args:
        path: "./i18n/${{ vars.lang }}/${{ item.path }}"
        content: "${{ item.text }}"
        create_dirs: true

outputs:
  files:
    value: ${{ tasks.files.output }}
    description: "Every source file that was mirrored"

{"a":{"graph_format":2,"workflow":"localization-factory","nodes":[{"id":"files","verb":"invoke","tool":"nika:glob","permits":["tool: nika:glob"]},{"id":"texts","verb":"invoke","tool":"nika:read","fan_out":{"kind":"expression"},"permits":["tool: nika:read"]},{"id":"pairs","verb":"invoke","tool":"nika:jq","permits":["tool: nika:jq"]},{"id":"translated","verb":"infer","model":"ollama/qwen3.5:4b","fan_out":{"kind":"expression"},"permits":[]},{"id":"bundle","verb":"invoke","tool":"nika:jq","permits":["tool: nika:jq"]},{"id":"mirror","verb":"invoke","tool":"nika:write","fan_out":{"kind":"expression"},"permits":["tool: nika:write"]}],"edges":[{"from":"bundle","to":"mirror","kind":"value"},{"from":"files","to":"pairs","kind":"value"},{"from":"files","to":"texts","kind":"value"},{"from":"pairs","to":"bundle","kind":"value"},{"from":"pairs","to":"translated","kind":"value"},{"from":"texts","to":"pairs","kind":"value"},{"from":"translated","to":"bundle","kind":"value"}]},"engine":"0.105.0"}

showcase · tier 3 · content

Localization factory

glob finds every doc, two fan-outs read + translate in parallel, jq zips the mirror tree back.

“Can we have the docs in French?” Yes, by lunch, with the original paths preserved. · conformance-gated in nika-spec ↗ · re-proven at every push

The whole file

6 tasks · 6 waves · the plan falls out of the bindings, nothing is scheduled by hand.

t3-localization-factory.nika.yamlsource

1nika: v12workflow:3  id: localization-factory4  description: "glob docs → parallel read → parallel translate → mirror tree"56model: ollama/qwen3.5:4b   # local default · swap for mistral/mistral-large (EU model for EU locales)78vars:9  lang: "fr"10  source_glob: "./docs/**/*.md"1112tasks:13  files:14    ◆invoke:15      tool: "nika:glob"16      args:17        pattern: "${{ vars.source_glob }}"18        exclude: ["**/node_modules/**"]1920  texts:21    with:22      files: ${{ tasks.files.output }}23    for_each: ${{ with.files }}24    max_parallel: 825    ◆invoke:26      tool: "nika:read"27      args: { path: "${{ item }}" }2829  pairs:30    with:31      files: ${{ tasks.files.output }}32      texts: ${{ tasks.texts.output }}33    ◆invoke:34      tool: "nika:jq"35      args:36        input: ["${{ with.files }}", "${{ with.texts }}"]37        expression: "transpose | map({path: .[0], text: .[1]})"3839  translated:40    with:41      pairs: ${{ tasks.pairs.output }}42    for_each: ${{ with.pairs }}43    max_parallel: 3                    # rate-limit the provider44    fail_fast: false                   # finish the batch · a failed file yields null at its index45    on_error:46      recover: null                    # null keeps the transpose zip aligned (order preserved)47    ◇infer:48      prompt: |49        Translate to ${{ vars.lang }} · keep markdown structure, code blocks50        untouched, and the original tone ·51        ${{ item.text }}5253  bundle:54    with:55      pairs: ${{ tasks.pairs.output }}56      translated: ${{ tasks.translated.output }}57    ◆invoke:58      tool: "nika:jq"59      args:60        input: ["${{ with.pairs }}", "${{ with.translated }}"]61        expression: "transpose | map(select(.[1] != null)) | map({path: .[0].path, text: .[1]})"6263  mirror:64    with:65      bundle: ${{ tasks.bundle.output }}66    for_each: ${{ with.bundle }}67    max_parallel: 868    ◆invoke:69      tool: "nika:write"70      args:71        path: "./i18n/${{ vars.lang }}/${{ item.path }}"72        content: "${{ item.text }}"73        create_dirs: true7475outputs:76  files:77    value: ${{ tasks.files.output }}78    description: "Every source file that was mirrored"79

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

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

try itopen in the playground guidethe walkthrough · docs verbinvoke verbinfer toolnika:glob toolnika:read toolnika:jq toolnika:write