Release radar

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

model: mock/echo            # swap for ollama/llama3.1 (local · zero key)

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.
  - id: no_state
    invoke:
      tool: "nika:jq"
      args: { input: [], expression: "." }

  - id: 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 }}

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

  - id: fresh
    depends_on: [previous, feed]
    invoke:
      tool: "nika:json_diff"
      args:
        before: "${{ tasks.previous.output }}"
        after: "${{ tasks.feed.entries }}"

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

  - id: save_state
    depends_on: [feed]
    invoke:
      tool: "nika:write"
      args:
        path: "${{ vars.state_path }}"
        content: "${{ tasks.feed.entries }}"
        create_dirs: true
        overwrite: true

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