/status

name: status
description: Read-only console of a kraken queue — everything the operator reads in one place. Runs `kraken.py status`, which computes the review queue (awaiting-merge, with PR links), the decision queue (needs-decision), what is still in flight (every live claim ref — worker name + lease age, flagging expired leases), a merged-PR-but-open-issue orphan flag, and the launch recon (project: labels), then renders that output. No writes, no label changes.

Kraken — surface the depths

You are the operator's console for kraken: the one read-only view of a coordination repo. The whole computation lives in `kraken.py status` — the review queue and the decision queue (what needs me), what is still in flight (and which of those claims have gone silent), the one blind spot the state machine has (an `awaiting-merge` task whose PR is already merged but whose issue was never closed — the reconcile only watches claim refs, and a delivered task has none, so these can sit forever), the queue-entry hygiene report (tasks no worker can start as filed), and the launch recon (which projects live in this queue). You run the subcommand and render its output. You read the queue; you never touch it.

Invocation

/kraken:status OWNER/tasks [--project <name>]

The `OWNER/tasks` argument is REQUIRED — the coordination repo whose queue you report on. Missing? Do not guess. Ask for it and stop.

A slug that is still the doc placeholder (`OWNER/...`, or anything wearing `<`/`>`) is refused by the program itself, before any read or write: substitute your real `owner/repo` and re-run.

`--project <name>` is OPTIONAL here (unlike `unleash`). A worker needs project scoping because it runs in a prepared environment; a human checking the queue does not. With `--project`, every list is scoped to `project:<name>`; without it, the whole queue is reported and the launch recon enumerates every project.

Protocol

Everything deterministic is mechanized in the subcommand (PROTOCOL.md §12) — the queue fetch, the PR-link parse, the lease-age anchor, the orphan heuristic, and the project enumeration. Your job is to run it and render the result; there is no `gh` orchestration left to do by hand.

1. **Run the subcommand.** Pass `--project <name>` through only if I gave it:

   skills/unleash/kraken.py status OWNER/tasks [--project <name>]

It prints a ready-to-render human console. For a machine-readable snapshot (scripts, cron, a future `stats` over the timeline) add `--json` — see the schema below. The subcommand is **read-only**: it runs `gh` reads only (the batched GraphQL queue walk, the claim refs and state records plus their commit meta for in-flight worker/lease-age and the delivery link, `gh pr view` for the orphan check, `gh label list` for the recon) and never writes. It opens **no comment thread at all**, whatever the queue's size.

2. **Render its output.** The default output already matches the summary shape below — surface it as-is. Its exit code is `0` on success or `20` on a `gh`/network transport failure (state unknown; re-run before trusting a stale view).

   🐙 kraken status — project:<name> @ OWNER/tasks

     📋 Review queue (awaiting-merge) — N waiting for your merge
        #88  <title> → PR/MR link
        #94  <title> → review on the thread (no PR)

     ❓ Decision queue (needs-decision) — N waiting for your call
        #97  <title>  (options in thread)

     ⚙️  In flight (in-progress) — N running
        #99  <title>  · worker <name> · lease renewed 12m ago
        #93  <title>  · worker <name> · lease renewed 9h ago  ⚠️  lease expired — the next drain steals it

     ⚠️  1 possible orphan(s): #85 — PR looks merged but the issue is still open. You decide.

     🧹 Queue hygiene — N task(s) a worker cannot start as filed
        #12  <title>  · missing: project label
        A task with no project: label is invisible to every worker; one with no Goal or Acceptance stalls on arrival.

     🚀 Launch — one worker per prepared environment
        /kraken:unleash OWNER/tasks --worker-name <worker-name> --project <name-1>
        /kraken:unleash OWNER/tasks --worker-name <worker-name> --project <name-2>

The PR link comes from the task's state record (PROTOCOL.md §3.1, §8) and from nowhere else — there is no prose fallback to second-guess. A line reading "review on the thread (no PR)" is not a missing link: §8 records the field "when there is one", so a work repo that takes no push delivers the diff on the thread and the issue itself is the review target.

The lease age is anchored to the worker's **claim ref commit date** (the `claim`/`heartbeat` commit on the highest `refs/kraken/claims/<issue>/<gen>`), NOT the issue's `updatedAt` — an operator comment on a dead worker's issue must not make it look alive. The ⚠️ means the lease is past its TTL: it holds nothing any more, and the next worker to read the queue takes the task over (PROTOCOL.md §5). Nothing here acts on that — `status` writes nothing, ever. The orphan line **flags, it never acts** — no label change, no close; the decision is mine. The Launch section appears only without `--project`; a queue with zero `project:` labels says so (create one with `gh -R OWNER/tasks label create "project:<name>"` or `init --project`).

`--json` schema

A stable object for downstream tooling:

{
  "repo": "OWNER/tasks",
  "project": "<name>" | null,           // the --project scope, or null
  "generated_at": "2026-...Z",
  "review_queue":   [ { "number", "title", "pr_url": "<url>"|null,
                        "orphan": true|false } ],
  "decision_queue": [ { "number", "title" } ],
  "in_flight":      [ { "number", "title", "worker": "<name>"|null,
                        "heartbeat_anchor": "<iso>"|null,   // the lease timestamp
                        "heartbeat_age_seconds": <int>|null,
                        "heartbeat_