nika: v1
workflow:
  id: release-notes
  description: "git log → typed release notes → CHANGELOG insert → team ping"

model: ollama/qwen3.5:4b   # local · zero key · swap for mistral/mistral-large

vars:
  since_tag: "v0.80.0"

secrets:
  team_webhook:
    source: env
    key: TEAM_WEBHOOK_URL
    egress:                       # sanction the one send · the secret IS the URL
      - to: "nika:notify"
        host_from_self: true

tasks:
  history:
    exec:
      command: ["git", "log", "${{ vars.since_tag }}..HEAD", "--oneline", "--no-merges"]

  notes:
    with:
      history: ${{ tasks.history.output }}
    infer:
      prompt: |
        Write release notes from these commits ·
        ${{ with.history }}
        Tone · plain, direct, no marketing fluff.
      schema:
        type: object
        required: [headline, body]
        properties:
          headline: { type: string }
          breaking: { type: array, items: { type: string } }
          body: { type: string }

  changelog:
    with:
      notes_headline: ${{ tasks.notes.output.headline }}
      notes_body: ${{ tasks.notes.output.body }}
    invoke:
      tool: "nika:edit"
      args:
        path: "./CHANGELOG.md"
        find: "# Changelog"
        replace: |
          # Changelog

          ## ${{ vars.since_tag }}..HEAD · ${{ with.notes_headline }}

          ${{ with.notes_body }}

  announce:
    with:
      notes_headline: ${{ tasks.notes.output.headline }}
    after:
      changelog: succeeded
    invoke:
      tool: "nika:notify"
      args:
        channel: webhook
        target: "${{ secrets.team_webhook }}"
        message: "Release notes ready · ${{ with.notes_headline }}"
        severity: info

outputs:
  headline: ${{ tasks.notes.output.headline }}
  body: ${{ tasks.notes.output.body }}

{"a":{"graph_format":2,"workflow":"release-notes","nodes":[{"id":"history","verb":"exec","permits":["exec: git"]},{"id":"notes","verb":"infer","model":"ollama/qwen3.5:4b","permits":[]},{"id":"changelog","verb":"invoke","tool":"nika:edit","permits":["fs.read: ./CHANGELOG.md","fs.write: ./CHANGELOG.md","tool: nika:edit"]},{"id":"announce","verb":"invoke","tool":"nika:notify","permits":["tool: nika:notify"]}],"edges":[{"from":"changelog","to":"announce","kind":"control"},{"from":"history","to":"notes","kind":"value"},{"from":"notes","to":"announce","kind":"value"},{"from":"notes","to":"changelog","kind":"value"},{"from":"notes","to":"changelog","kind":"value"}]},"engine":"0.105.0"}

showcase · tier 2 · builders

Release notes

git log in, typed notes out, the CHANGELOG edited in place and the team pinged with the headline.

Release day: one command, a changelog in your voice, zero copy-paste. · conformance-gated in nika-spec ↗ · re-proven at every push

The whole file

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

t2-release-notes.nika.yamlsource

1nika: v12workflow:3  id: release-notes4  description: "git log → typed release notes → CHANGELOG insert → team ping"56model: ollama/qwen3.5:4b   # local · zero key · swap for mistral/mistral-large78vars:9  since_tag: "v0.80.0"1011secrets:12  team_webhook:13    source: env14    key: TEAM_WEBHOOK_URL15    egress:                       # sanction the one send · the secret IS the URL16      - to: "nika:notify"17        host_from_self: true1819tasks:20  history:21    ▷exec:22      command: ["git", "log", "${{ vars.since_tag }}..HEAD", "--oneline", "--no-merges"]2324  notes:25    with:26      history: ${{ tasks.history.output }}27    ◇infer:28      prompt: |29        Write release notes from these commits ·30        ${{ with.history }}31        Tone · plain, direct, no marketing fluff.32      schema:33        type: object34        required: [headline, body]35        properties:36          headline: { type: string }37          breaking: { type: array, items: { type: string } }38          body: { type: string }3940  changelog:41    with:42      notes_headline: ${{ tasks.notes.output.headline }}43      notes_body: ${{ tasks.notes.output.body }}44    ◆invoke:45      tool: "nika:edit"46      args:47        path: "./CHANGELOG.md"48        find: "# Changelog"49        replace: |50          # Changelog5152          ## ${{ vars.since_tag }}..HEAD · ${{ with.notes_headline }}5354          ${{ with.notes_body }}5556  announce:57    with:58      notes_headline: ${{ tasks.notes.output.headline }}59    after:60      changelog: succeeded61    ◆invoke:62      tool: "nika:notify"63      args:64        channel: webhook65        target: "${{ secrets.team_webhook }}"66        message: "Release notes ready · ${{ with.notes_headline }}"67        severity: info6869outputs:70  headline: ${{ tasks.notes.output.headline }}71  body: ${{ tasks.notes.output.body }}72

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

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

try itopen in the playground guidethe walkthrough · docs verbexec verbinfer verbinvoke toolnika:edit toolnika:notify