nika: v1
workflow:
  id: release-radar
  description: "dependency release feed → diff vs last run → only the NEW ships"

model: ollama/qwen3.5:4b   # local · zero key · swap for any provider in the catalog

vars:
  releases_feed: "https://github.com/tokio-rs/tokio/releases.atom"
  state_path: "./state/release-radar.json"

tasks:
  # First run has no state file · recover to an empty list.
  no_state:
    invoke:
      tool: "nika:jq"
      args: { input: [], expression: "." }

  previous:
    invoke:
      tool: "nika:read"
      args: { path: "${{ vars.state_path }}" }
    on_error:
      on_codes: [NIKA-BUILTIN-READ-001]   # not-found ONLY · a permission error still fails loudly
      recover: ${{ tasks.no_state.output }}

  feed:
    invoke:
      tool: "nika:fetch"
      args:
        url: "${{ vars.releases_feed }}"
        mode: feed
    output:
      entries: "[.items[] | {title, url, published}]"

  fresh:
    with:
      previous: ${{ tasks.previous.output }}
      entries: ${{ tasks.feed.entries }}
    invoke:
      tool: "nika:json_diff"
      args:
        before: "${{ with.previous }}"
        after: "${{ with.entries }}"

  digest:
    with:
      fresh: ${{ tasks.fresh.output }}
      entries: ${{ tasks.feed.entries }}
    when: ${{ size(with.fresh) > 0 }}
    infer:
      prompt: |
        New releases appeared on our dependency radar (RFC 6902 patch
        against last run) ·
        ${{ with.fresh }}
        Full current feed · ${{ with.entries }}
        Write 3 bullets · what shipped · whether it looks breaking ·
        what to check in our code.

  save_state:
    with:
      entries: ${{ tasks.feed.entries }}
    invoke:
      tool: "nika:write"
      args:
        path: "${{ vars.state_path }}"
        content: "${{ with.entries }}"
        create_dirs: true
        overwrite: true

outputs:
  new_entries:
    value: ${{ tasks.fresh.output }}
    description: "RFC 6902 ops · empty = nothing new since last run"

{"a":{"graph_format":2,"workflow":"release-radar","nodes":[{"id":"no_state","verb":"invoke","tool":"nika:jq","permits":["tool: nika:jq"]},{"id":"previous","verb":"invoke","tool":"nika:read","permits":["tool: nika:read"]},{"id":"feed","verb":"invoke","tool":"nika:fetch","permits":["tool: nika:fetch"]},{"id":"fresh","verb":"invoke","tool":"nika:json_diff","permits":["tool: nika:json_diff"]},{"id":"save_state","verb":"invoke","tool":"nika:write","permits":["tool: nika:write"]},{"id":"digest","verb":"infer","model":"ollama/qwen3.5:4b","when":"${{ size(with.fresh) > 0 }}","permits":[]}],"edges":[{"from":"feed","to":"digest","kind":"value"},{"from":"feed","to":"fresh","kind":"value"},{"from":"feed","to":"save_state","kind":"value"},{"from":"fresh","to":"digest","kind":"value"},{"from":"no_state","to":"previous","kind":"recovery"},{"from":"previous","to":"fresh","kind":"value"}]},"engine":"0.105.0"}

showcase · tier 2 · builders

Release radar

Reads your dependencies’ release feeds and diffs against last run, so only new ships reach you.

No ping, nothing shipped. A ping, something worth a look. You stop checking tabs. · conformance-gated in nika-spec ↗ · re-proven at every push

The whole file

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

t2-release-radar.nika.yamlsource

1nika: v12workflow:3  id: release-radar4  description: "dependency release feed → diff vs last run → only the NEW ships"56model: ollama/qwen3.5:4b   # local · zero key · swap for any provider in the catalog78vars:9  releases_feed: "https://github.com/tokio-rs/tokio/releases.atom"10  state_path: "./state/release-radar.json"1112tasks:13  # First run has no state file · recover to an empty list.14  no_state:15    ◆invoke:16      tool: "nika:jq"17      args: { input: [], expression: "." }1819  previous:20    ◆invoke:21      tool: "nika:read"22      args: { path: "${{ vars.state_path }}" }23    on_error:24      on_codes: [NIKA-BUILTIN-READ-001]   # not-found ONLY · a permission error still fails loudly25      recover: ${{ tasks.no_state.output }}2627  feed:28    ◆invoke:29      tool: "nika:fetch"30      args:31        url: "${{ vars.releases_feed }}"32        mode: feed33    output:34      entries: "[.items[] | {title, url, published}]"3536  fresh:37    with:38      previous: ${{ tasks.previous.output }}39      entries: ${{ tasks.feed.entries }}40    ◆invoke:41      tool: "nika:json_diff"42      args:43        before: "${{ with.previous }}"44        after: "${{ with.entries }}"4546  digest:47    with:48      fresh: ${{ tasks.fresh.output }}49      entries: ${{ tasks.feed.entries }}50    when: ${{ size(with.fresh) > 0 }}51    ◇infer:52      prompt: |53        New releases appeared on our dependency radar (RFC 6902 patch54        against last run) ·55        ${{ with.fresh }}56        Full current feed · ${{ with.entries }}57        Write 3 bullets · what shipped · whether it looks breaking ·58        what to check in our code.5960  save_state:61    with:62      entries: ${{ tasks.feed.entries }}63    ◆invoke:64      tool: "nika:write"65      args:66        path: "${{ vars.state_path }}"67        content: "${{ with.entries }}"68        create_dirs: true69        overwrite: true7071outputs:72  new_entries:73    value: ${{ tasks.fresh.output }}74    description: "RFC 6902 ops · empty = nothing new since last run"75

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

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

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