@afokapu/atdd-bun 0.10.31 → 0.10.33

package/detectors/delivery_evidence/detect.mjs

@@ -1,9 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname } from "node:path";
-import { validateDelivery } from "../../src/delivery.ts";
-
-const roots = JSON.parse(process.env.ATDD_SCAN_ROOTS ?? "[]"), report = process.env.ATDD_VIOLATIONS_REPORT;
-if (!report) throw new Error("ATDD_VIOLATIONS_REPORT is required");
-const violations = (await Promise.all(roots.map(root => validateDelivery(root)))).flat().map(item => ({ ...item, line: 1, col: 1, source_line: "" }));
-await mkdir(dirname(report), { recursive: true });
-await writeFile(report, JSON.stringify({ violations }, null, 2));

package/detectors/delivery_evidence/fixtures/clean/atdd-bun.yaml

@@ -1,8 +0,0 @@
-profiles: [delivery]
-delivery:
-  independence: fresh-process
-  stages:
-    plan_review: { authors: [codex], reviewers: [glm, claude] }
-    test_review: { authors: [glm, claude], reviewers: [codex, claude] }
-    code_review: { authors: [glm, claude], reviewers: [glm, claude], independence: different-model }
-    final_review: { authors: [codex], reviewers: [codex, claude] }

package/detectors/delivery_evidence/fixtures/clean/docs/delivery/tranches/api/evidence.yaml

@@ -1,54 +0,0 @@
-# In progress: every stage reviewed, the code-review dispute settled, the PR not yet marked ready.
-tranche: api
-status: open
-base_sha: 3f2a91c
-reviews:
-  - stage: plan_review
-    sha: 8b10e44
-    author: { model: codex, run: driver-api }
-    reviewer: { model: glm, run: glm-plan-1 }
-    verdict: approve
-    checked: [ACC-API-001, ACC-API-002, planner.decomposition]
-  - stage: test_review
-    sha: 91aa0b2
-    author: { model: glm, run: glm-red-1 }
-    reviewer: { model: codex, run: codex-test-1 }
-    verdict: approve
-    checked: [ACC-API-001, ACC-API-002, tester.bun.red]
-  - stage: code_review
-    sha: a4c0f11
-    author: { model: glm, run: glm-green-1 }
-    reviewer: { model: claude, run: claude-code-1 }
-    fallback:
-      - { from: glm, kind: rate_limit, failures: 3, window: { from: "2026-09-25T09:00:00Z", to: "2026-09-25T09:08:00Z" }, reason: "rate limit: 3 failures in 10 minutes" }
-    verdict: request_changes
-    checked: [ACC-API-001, ACC-API-002, src/wagons/api, coder.bun.error-response]
-    findings:
-      - id: F1
-        severity: high
-        evidence: src/wagons/api/handler.ts:42 returns a bare string
-        invariant: every error response carries a coded body
-        affects: [ui]
-        proposed_fix: return { code "API_NOT_FOUND" } instead of the bare string
-        outcome: fixed
-      - id: F2
-        severity: medium
-        evidence: src/wagons/api/handler.ts:57 retries without a bound
-        invariant: outbound calls are bounded
-        proposed_fix: cap the retry loop at three attempts
-        rebuttal: "The loop is bounded by the caller's AbortSignal; see handler.test.ts:31 which proves it stops."
-        outcome: withdrawn
-  - stage: code_review
-    sha: c77d0a2
-    author: { model: glm, run: glm-green-2 }
-    reviewer: { model: claude, run: claude-code-2 }
-    fallback:
-      - { from: glm, kind: rate_limit, failures: 3, window: { from: "2026-09-25T09:00:00Z", to: "2026-09-25T09:08:00Z" }, reason: "rate limit: 3 failures in 10 minutes" }
-    verdict: approve
-    checked: [ACC-API-001, ACC-API-002, src/wagons/api, F1, F2]
-  - stage: final_review
-    sha: c77d0a2
-    author: { model: codex, run: driver-api }
-    reviewer: { model: codex, run: codex-final-1 }
-    verdict: approve
-    checked: [src/wagons/api, contracts, ui]

package/detectors/delivery_evidence/fixtures/dirty/atdd-bun.yaml

@@ -1,3 +0,0 @@
-profiles: [delivery]
-delivery:
-  independence: loose

package/detectors/delivery_evidence/fixtures/dirty/docs/delivery/tranches/api/evidence.yaml

@@ -1,31 +0,0 @@
-# Ready, but the approved SHA is not what final_review approved and exists nowhere, a reviewer is off-list,
-# one reviewer also authored, and a finding was never resolved.
-tranche: api
-status: ready
-base_sha: 3f2a91c
-approved_sha: "0000000"
-reviews:
-  - stage: plan_review
-    sha: 8b10e44
-    author: { model: codex, run: driver-api }
-    reviewer: { model: gpt, run: gpt-plan-1 }
-    verdict: approve
-    checked: [ACC-API-001]
-  - stage: final_review
-    sha: 91aa0b2
-    author: { model: codex, run: codex-green-1 }
-    reviewer: { model: codex, run: driver-api }
-    verdict: request_changes
-    checked: [ACC-API-001]
-    findings:
-      - id: F1
-        severity: high
-        evidence: src/wagons/api/handler.ts:42 returns a bare string
-        invariant: every error response carries a coded body
-        proposed_fix: return a coded error body
-  - stage: final_review
-    sha: a4c0f11
-    author: { model: codex, run: codex-green-2 }
-    reviewer: { model: codex, run: codex-final-2 }
-    verdict: approve
-    checked: [ACC-API-001, F1]

package/detectors/delivery_evidence/fixtures/dirty/docs/delivery/tranches/data/evidence.yaml

@@ -1,8 +0,0 @@
-# A reviewer without a verdict or a checklist.
-tranche: data
-status: open
-base_sha: 3f2a91c
-reviews:
-  - stage: plan_review
-    sha: 8b10e44
-    reviewer: { model: glm, run: glm-plan-1 }

package/detectors/delivery_evidence/fixtures/dirty/docs/delivery/tranches/orphan/README.md

@@ -1 +0,0 @@
-The orphan tranche has a folder and no evidence.yaml.

package/detectors/delivery_evidence/fixtures/dirty/docs/delivery/tranches/ui/evidence.yaml

@@ -1,5 +0,0 @@
-# The folder says ui, the record says web.
-tranche: web
-status: open
-base_sha: 3f2a91c
-reviews: []

package/detectors/planner_docs_capability/fixtures/dirty_missing_index/docs/delivery/release.adoc

@@ -1,10 +0,0 @@
-= Release
-:doc-id: delivery.release
-:status: current
-
-The delivery area exists and holds this document — but carries no index.adoc.
-
-This file is what makes the fixture REAL. Expressing "the area exists with no
-index" as an empty directory made the defect invisible to git, so the fixture
-arrived empty on a fresh clone and the rule it proves never fired. A fixture that
-only works on the machine that authored it proves nothing.

package/detectors/planner_docs_capability/fixtures/dirty_missing_index/docs/purpose/index.adoc

@@ -1,5 +0,0 @@
-= Purpose
-:doc-id: purpose.index
-:status: current
-
-WHY and WHAT.

package/planner-schemas/delivery-config.schema.json

@@ -1,95 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "Delivery Profile Configuration",
-  "description": "The `delivery:` block of atdd-bun.yaml: which models may author and review each lifecycle stage, in preference order, how independent a reviewer must be, and when a model counts as unavailable. Every key is optional; an omitted key takes the package default (src/delivery.ts). `stages`, when given, replaces the default stage set: a stage it omits is not required.",
-  "$comment": "Shipped by the delivery profile (delivery_evidence). Cross-field checks (a reviewer listed twice, a stage override naming an unknown mode) are schema-level; loosening against the base branch is judged by the integrity check.",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "root": {
-      "type": "string",
-      "pattern": "^[a-z0-9_][a-z0-9_.-]*(?:/[a-z0-9_][a-z0-9_.-]*)*$",
-      "description": "Repository-relative folder holding one <tranche>/evidence.yaml per tranche, in canonical form: no leading, trailing or doubled slash, no dot segments. Default: docs/delivery/tranches, beside the program's reasoning in the docs profile's delivery area. Changing it after adoption is a loosening the integrity check reports."
-    },
-    "require_record": {
-      "type": "boolean",
-      "description": "At the gate, a change outside the delivery root needs a tranche record in the same change, unless atdd-bun.yaml is the only such file. Default: true; turning it off is a loosening."
-    },
-    "multiplexer": {
-      "type": "string",
-      "pattern": "^[a-z][a-z0-9-]*$",
-      "description": "The terminal multiplexer the coordinator drives agents through, named by its command. Default: herdr. Any other name is accepted; the agent learns its commands from the multiplexer's own help."
-    },
-    "board": {
-      "type": "object",
-      "additionalProperties": false,
-      "description": "Opt-in: when present, agents talk through this local message board (delivery.board); when absent there is no board. $ATDD_BOARD_URL moves it on one machine but never switches it on.",
-      "properties": {
-        "url": { "type": "string", "pattern": "^https?://(127\\.0\\.0\\.1|localhost|\\[::1\\])(:[0-9]{1,5})?/?$", "description": "A local address only. Default: http://127.0.0.1:2586." }
-      }
-    },
-    "independence": { "$ref": "#/definitions/independence" },
-    "stages": {
-      "type": "object",
-      "additionalProperties": false,
-      "minProperties": 1,
-      "properties": {
-        "plan": { "$ref": "#/definitions/stage" },
-        "red": { "$ref": "#/definitions/stage" },
-        "green": { "$ref": "#/definitions/stage" },
-        "refactor": { "$ref": "#/definitions/stage" },
-        "final": { "$ref": "#/definitions/stage" },
-        "plan_review": { "$ref": "#/definitions/stage" },
-        "test_review": { "$ref": "#/definitions/stage" },
-        "code_review": { "$ref": "#/definitions/stage" },
-        "final_review": { "$ref": "#/definitions/stage" }
-      }
-    },
-    "fallback": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "after_failures": { "type": "integer", "minimum": 1, "description": "Failures (outage, rate limit, no auditable report) before a model counts as unavailable. A REQUEST CHANGES verdict is never a failure." },
-        "within_minutes": { "type": "integer", "minimum": 1 },
-        "when_exhausted": { "enum": ["block", "wait"], "description": "block: the tranche emits BLOCKED provider-unavailable and the coordinator reassigns the slot. wait: the driver keeps retrying the last model in the list." }
-      }
-    },
-    "commands": {
-      "type": "object",
-      "description": "Headless invocation per model, overriding the skill's built-in defaults. {prompt} and {worktree} are substituted by the driver. Adding or changing an entry after adoption is a loosening the integrity check reports; removing one returns to the default.",
-      "additionalProperties": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "author": { "type": "string", "minLength": 1 },
-          "review": { "type": "string", "minLength": 1 }
-        }
-      }
-    }
-  },
-  "definitions": {
-    "independence": {
-      "enum": ["fresh-process", "different-model"],
-      "description": "fresh-process: the reviewer is a new process that wrote nothing in the tranche. different-model (the default): additionally, its model wrote none of the work the review covers."
-    },
-    "models": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "items": { "type": "string", "pattern": "^(\\*|[a-z][a-z0-9-]*)$" },
-      "description": "The models allowed for the role, in no order: any listed model may do the work, and \"*\" allows any model."
-    },
-    "stage": {
-      "type": "object",
-      "additionalProperties": false,
-      "anyOf": [{ "required": ["writer"] }, { "required": ["reviewer"] }, { "required": ["reviewers"] }],
-      "properties": {
-        "writer": { "$ref": "#/definitions/models", "description": "Who may write this stage, in preference order. Absent: nobody writes it, as for final." },
-        "reviewer": { "$ref": "#/definitions/models", "description": "Who reviews this stage, in preference order. Absent: the stage is held by its gate alone." },
-        "authors": { "$ref": "#/definitions/models", "description": "0.9 spelling of writer, on a 0.9 stage name." },
-        "reviewers": { "$ref": "#/definitions/models", "description": "0.9 spelling of reviewer, on a 0.9 stage name." },
-        "independence": { "$ref": "#/definitions/independence" }
-      }
-    }
-  }
-}

package/planner-schemas/delivery-evidence.schema.json

@@ -1,103 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "Delivery Evidence Schema",
-  "description": "Validates one <delivery root>/<tranche>/evidence.yaml: the record a tranche leaves of who wrote each stage and of its reviews. Local shape only: stage completeness, allowed models and fallbacks, reviewer independence, finding outcomes and SHA resolution are cross-field validator concerns (src/delivery.ts).",
-  "$comment": "Shipped by the delivery profile (delivery_evidence). `reviews` is chronological: a repair loop appends a new entry for the same stage rather than editing the earlier one.",
-  "type": "object",
-  "required": ["tranche", "status", "reviews"],
-  "additionalProperties": false,
-  "properties": {
-    "tranche": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "description": "Must equal the tranche folder name." },
-    "status": { "enum": ["open", "ready"], "description": "open: the lifecycle is in progress. ready: every configured stage is approved and approved_sha is the commit to merge." },
-    "base_sha": { "$ref": "#/definitions/sha", "$comment": "Informational: the commit the tranche started from. Not checked; the gate derives its range from Git." },
-    "approved_sha": { "$ref": "#/definitions/sha" },
-    "pr": { "type": "string", "minLength": 1, "$comment": "Informational: the pull request URL. Not checked." },
-    "work": { "type": "array", "items": { "$ref": "#/definitions/work" }, "description": "Who wrote each stage, in order: one entry per stage written, more after a repair." },
-    "reviews": { "type": "array", "items": { "$ref": "#/definitions/review" } }
-  },
-  "if": { "required": ["status"], "properties": { "status": { "const": "ready" } } },
-  "then": { "required": ["approved_sha"] },
-  "definitions": {
-    "sha": { "type": "string", "pattern": "^[0-9a-f]{7,40}$" },
-    "actor": {
-      "type": "object",
-      "required": ["model", "run"],
-      "additionalProperties": false,
-      "properties": {
-        "model": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
-        "run": { "type": "string", "minLength": 1, "description": "Identifies the process: a session id, a pane id plus start time, or the report file. Two entries with the same run are the same process." }
-      }
-    },
-    "fallback": {
-      "type": "object",
-      "required": ["from", "kind", "reason"],
-      "additionalProperties": false,
-      "description": "Why a later model in the stage's list was used: counted failures of the preferred one, or the operator's order (kind operator), which references its ruling instead and is accepted only for a model the stage lists.",
-      "if": { "required": ["kind"], "properties": { "kind": { "const": "operator" } } },
-      "then": { "required": ["decided_by", "decided_at", "ruling"], "not": { "anyOf": [{ "required": ["failures"] }, { "required": ["window"] }] } },
-      "else": { "required": ["failures", "window"] },
-      "properties": {
-        "role": { "enum": ["writer", "author", "reviewer"], "description": "Which actor fell back; author is the 0.9 spelling of writer. Default: writer on a work entry, reviewer on a review." },
-        "from": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
-        "kind": { "enum": ["outage", "rate_limit", "no_report", "timeout", "operator"], "description": "Why the model counts as unavailable, or operator when the operator ordered the substitution. A verdict is never one of these." },
-        "failures": { "type": "integer", "minimum": 1, "description": "Failures observed before falling back; at least delivery.fallback.after_failures." },
-        "window": {
-          "type": "object",
-          "required": ["from", "to"],
-          "additionalProperties": false,
-          "description": "When the first and last counted failures happened; the span is at most delivery.fallback.within_minutes.",
-          "properties": { "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" } }
-        },
-        "decided_by": { "type": "string", "minLength": 2, "description": "operator only: who ruled, by name or board identity. Never the driver on its own authority." },
-        "decided_at": { "type": "string", "format": "date-time", "description": "operator only: when the ruling was given." },
-        "ruling": { "type": "string", "minLength": 3, "description": "operator only: where the ruling is recorded (a board message id, an ADR or a PR)." },
-        "reason": { "type": "string", "minLength": 10, "description": "Why the preferred model was not used: an outage, a rate limit, no auditable report, or the operator's order. Never a verdict." }
-      }
-    },
-    "finding": {
-      "type": "object",
-      "required": ["id", "severity", "evidence", "invariant", "proposed_fix"],
-      "additionalProperties": false,
-      "properties": {
-        "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "description": "Stable across re-reviews, so an upheld finding keeps its id." },
-        "severity": { "enum": ["critical", "high", "medium", "low"] },
-        "evidence": { "type": "string", "minLength": 5, "description": "Concrete: file:line, a failing command, a counter-example." },
-        "invariant": { "type": "string", "minLength": 5 },
-        "affects": { "type": "array", "items": { "type": "string", "minLength": 1 } },
-        "proposed_fix": { "type": "string", "minLength": 5, "description": "A precise correction for the author to apply; the reviewer never applies it." },
-        "rebuttal": { "type": "string", "minLength": 20, "description": "The author's written dispute, with evidence. One round only." },
-        "outcome": { "enum": ["fixed", "withdrawn", "human"] },
-        "decision": { "type": "string", "minLength": 5, "description": "The human's ruling when outcome is human." }
-      }
-    },
-    "work": {
-      "type": "object",
-      "required": ["stage", "sha", "writer"],
-      "additionalProperties": false,
-      "properties": {
-        "stage": { "enum": ["plan", "red", "green", "refactor", "final", "plan_review", "test_review", "code_review", "final_review"] },
-        "sha": { "$ref": "#/definitions/sha", "description": "The commit the stage's work ended at." },
-        "writer": { "$ref": "#/definitions/actor" },
-        "fallback": { "type": "array", "items": { "$ref": "#/definitions/fallback" } }
-      }
-    },
-    "review": {
-      "type": "object",
-      "required": ["stage", "sha", "reviewer", "verdict", "checked"],
-      "additionalProperties": false,
-      "properties": {
-        "stage": { "enum": ["plan", "red", "green", "refactor", "final", "plan_review", "test_review", "code_review", "final_review"], "description": "The stage reviewed. The 0.9 names read as plan, red, refactor and final." },
-        "sha": { "$ref": "#/definitions/sha" },
-        "author": { "$ref": "#/definitions/actor", "$comment": "0.9: the writer of the reviewed work. Records now name writers under work." },
-        "reviewer": { "$ref": "#/definitions/actor" },
-        "fallback": { "type": "array", "items": { "$ref": "#/definitions/fallback" } },
-        "verdict": { "enum": ["approve", "request_changes"] },
-        "checked": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 }, "description": "Everything the reviewer went through, not only what failed." },
-        "findings": { "type": "array", "items": { "$ref": "#/definitions/finding" } },
-        "report": { "type": "string", "minLength": 1, "description": "Path of the retained raw reviewer output, inside the tranche's folder." }
-      },
-      "if": { "required": ["verdict"], "properties": { "verdict": { "const": "request_changes" } } },
-      "then": { "required": ["findings"], "properties": { "findings": { "minItems": 1 } } }
-    }
-  }
-}

package/src/board-ui.ts

@@ -1,91 +0,0 @@
-import { allowedTopics, DIRECTORY, format, read, type Message } from "./board";
-
-/** `atdd-bun chat` alone: a terminal view of the board, every topic in a panel on the left and the selected topic's
- * conversation on the right, refreshed every second. ntfy cannot list its topics, so the board keeps a directory
- * topic (atdd-topics) that atdd-bun chat post fills with each topic's name on its first message. */
-
-/** Every topic the directory names, in order. */
-export async function knownTopics(url: string): Promise<string[]> {
-  const entries = await read(url, [DIRECTORY]).catch(() => [] as Message[]);
-  return [...new Set(entries.map(entry => entry.raw.trim()).filter(topic => /^[A-Za-z0-9_-]{1,64}$/.test(topic)))].sort((a, b) => a.localeCompare(b, "en", { numeric: true }));
-}
-
-export type UiState = { topics: string[]; messages: Map<string, Message[]>; selected: number; scroll: number; url: string };
-
-/** A topic's parent is the longest other topic it extends (atdd-p-t3-final-1 under atdd-p-t3 under atdd-p). */
-function tree(topics: string[]): Array<{ topic: string; depth: number; label: string }> {
-  return topics.map(topic => {
-    const ancestors = topics.filter(other => other !== topic && topic.startsWith(`${other}-`));
-    const parent = ancestors.sort((a, b) => b.length - a.length)[0];
-    return { topic, depth: ancestors.length, label: parent ? topic.slice(parent.length + 1) : topic };
-  });
-}
-
-const fit = (text: string, width: number) => text.length > width ? `${text.slice(0, Math.max(0, width - 1))}…` : text.padEnd(width);
-function wrap(text: string, width: number): string[] {
-  const out: string[] = [];
-  for (const line of text.split("\n")) {
-    if (!line) { out.push(""); continue; }
-    for (let i = 0; i < line.length; i += width) out.push(line.slice(i, i + width));
-  }
-  return out;
-}
-
-/** The screen as lines, without escape codes except the selection's inverse video: pure, so it can be tested. */
-export function render(state: UiState, width: number, height: number): string[] {
-  const left = Math.max(20, Math.min(40, Math.floor(width / 3))), right = Math.max(10, width - left - 3), rows = Math.max(1, height - 2);
-  const nodes = tree(state.topics), selected = nodes[state.selected]?.topic;
-  const panel = nodes.map((node, i) => {
-    const count = String(state.messages.get(node.topic)?.length ?? 0);
-    const text = `${"  ".repeat(node.depth)}${node.label}`;
-    const cell = `${fit(text, left - count.length - 1)} ${count}`;
-    return i === state.selected ? `\x1b[7m${cell}\x1b[0m` : cell;
-  });
-  if (!panel.length) panel.push(fit("no topics yet", left));
-  const body = selected ? (state.messages.get(selected) ?? []).flatMap(message => wrap(format(message), right)) : wrap("Nothing posted yet. Topics appear here as agents post to them.", right);
-  const end = Math.max(0, body.length - state.scroll), start = Math.max(0, end - rows), view = body.slice(start, end);
-  const first = Math.max(0, Math.min(state.selected - Math.floor(rows / 2), panel.length - rows));
-  const header = fit(` Delivery board  ${state.url}  ·  ${state.topics.length} topics  ·  ↑↓ topic  PgUp/PgDn scroll  q quit`, width);
-  const lines = [header, `${"─".repeat(left)}─┬─${"─".repeat(right)}`];
-  for (let row = 0; row < rows - 1; row++) lines.push(`${panel[first + row] ?? " ".repeat(left)} │ ${fit(view[row] ?? "", right)}`);
-  lines.push(fit(selected ? ` ${selected}${state.scroll ? `  (scrolled up ${state.scroll})` : ""}` : "", width));
-  return lines;
-}
-
-/** Runs the view until q. Without a terminal it prints the topic list and exits. */
-export async function runUi(url: string, env: Record<string, string | undefined> = process.env): Promise<number> {
-  const visible = async () => { const all = await knownTopics(url); return env.ATDD_AGENT ? all.filter(topic => allowedTopics(env).includes(topic)) : all; };
-  const state: UiState = { topics: [], messages: new Map(), selected: 0, scroll: 0, url };
-  const refresh = async () => {
-    state.topics = await visible();
-    for (const topic of state.topics) {
-      const known = state.messages.get(topic) ?? [], since = known.at(-1)?.id ?? "all";
-      const fresh = await read(url, [topic], since).catch(() => [] as Message[]);
-      if (fresh.length || !state.messages.has(topic)) state.messages.set(topic, [...known, ...fresh]);
-    }
-  };
-  await refresh();
-  if (!process.stdout.isTTY || !process.stdin.isTTY) {
-    for (const topic of state.topics) console.log(`${topic}  ${state.messages.get(topic)?.length ?? 0}`);
-    return 0;
-  }
-  const draw = () => process.stdout.write(`\x1b[H\x1b[2J${render(state, process.stdout.columns || 100, process.stdout.rows || 30).join("\n")}`);
-  process.stdout.write("\x1b[?1049h\x1b[?25l");
-  process.stdin.setRawMode(true); process.stdin.resume();
-  let done: (code: number) => void = () => {};
-  const finished = new Promise<number>(resolve => { done = resolve; });
-  const quit = () => { clearInterval(timer); process.stdin.setRawMode(false); process.stdin.pause(); process.stdout.write("\x1b[?25h\x1b[?1049l"); done(0); };
-  process.stdin.on("data", (data: Buffer) => {
-    const key = data.toString();
-    if (key === "q" || key === "\x03") return quit();
-    if (key === "\x1b[A" || key === "k") { state.selected = Math.max(0, state.selected - 1); state.scroll = 0; }
-    if (key === "\x1b[B" || key === "j") { state.selected = Math.min(state.topics.length - 1, state.selected + 1); state.scroll = 0; }
-    if (key === "\x1b[5~") state.scroll += 10;
-    if (key === "\x1b[6~") state.scroll = Math.max(0, state.scroll - 10);
-    draw();
-  });
-  process.stdout.on("resize", draw);
-  const timer = setInterval(async () => { await refresh(); draw(); }, 1000);
-  draw();
-  return finished;
-}