Bookmark triage

nika: bookmark-triage

const:
  bookmarks:
    # The saved-links pile to triage.
    #
    # A TYPED constant is `{ type, value }` — both keys, exactly those two
    # (`description:` here is NIKA-PARSE-005 · unknown field). The
    # discriminator is normative (01-envelope.md §const): an object missing
    # either key is a bare literal object constant. So `{ type, default }` is
    # not a declaration at all — `${{ const.bookmarks }}` would yield the whole
    # `{type, default}` map and `for_each` would die NIKA-VAR-006 ·
    # « for_each collection must be an array · got object ».
    type: { array: string }
    value:
      - "https://example.com"
      - "https://github.com/supernovae-st/nika"
      - "https://this-domain-does-not-exist-0000.invalid" # the dead one · the recover path IS the demo

permits:
  exec: false
  tools: ["nika:fetch", "nika:jq", "nika:write"]
  net:
    http: ["example.com", "github.com", "this-domain-does-not-exist-0000.invalid"]
  fs:
    # One report, one literal: the body's only write is this exact static path,
    # so the grant names it — the audit line reads `risk supervised` where
    # `out/**` read `risk unbounded`.
    write: ["out/bookmarks.md"]

tasks:
  # The fan-out · one metadata fetch per URL · a dead link recovers to a
  # marker object (the batch NEVER dies at bookmark 14).
  pages:
    for_each:
      items: ${{ const.bookmarks }}
      max_parallel: 3
      fail_fast: false
    retry: { max_attempts: 2, backoff_ms: 500 } # a transient blip retries BEFORE the dead verdict
    on_error:
      recover: { dead: true } # a YAML value, not a JSON string — the marker row
    invoke:
      tool: "nika:fetch"
      args:
        url: "${{ item }}"
        mode: metadata

  # The fan-in · zip results back to their URLs · split live from dead.
  table:
    with:
      pages: ${{ tasks.pages.output }}
    invoke:
      tool: "nika:jq"
      args:
        input:
          urls: ${{ const.bookmarks }}
          pages: ${{ with.pages }}
        expression: >-
          def esc: tostring | gsub("\\|"; "\\|") | gsub("\n"; " ");
          ([.urls, .pages] | transpose | map({ url: .[0], page: .[1] })) as $rows |
          {
            live: ([$rows[] | select(.page.dead != true) |
              "| \(.url) | \(.page.title // "—" | esc) | \((.page.description // "—" | esc) | .[0:80]) |"] | join("\n")),
            dead: ([$rows[] | select(.page.dead == true) | "| \(.url) | DEAD | link rot |"] | join("\n"))
          }

  report:
    with:
      table_live: ${{ tasks.table.output.live }}
      table_dead: ${{ tasks.table.output.dead }}
    invoke:
      tool: "nika:write"
      args:
        path: out/bookmarks.md
        create_dirs: true
        content: |
          # Bookmark triage

          | url | title | description |
          | --- | --- | --- |
          ${{ with.table_live }}
          ${{ with.table_dead }}

          *Generated by [nika](https://nika.sh) — dead links survived the batch (`on_error: recover:`).*

outputs:
  table:
    value: ${{ tasks.table.output }}
    description: "Live rows + dead rows · the triage split"