@rness/cli 0.10.0 → 0.11.0

package/dist/{chunk-R4BRAAC2.js → chunk-LW4S5OLI.js}

@@ -1198,6 +1198,12 @@ function badge(text, tone = "intro", stream = process.stdout) {
   });
   return painted === padded ? text : painted;
 }
+function inverse(text, stream = process.stdout) {
+  const plain = `[${text.slice(1, -1)}]`;
+  if (noColor()) return plain;
+  const painted = styleText("inverse", text, { stream, validateStream: true });
+  return painted === text ? plain : painted;
+}
 function grey(text, stream = process.stdout) {
   if (noColor()) return text;
   return styleText("gray", text, { stream, validateStream: true });
@@ -1213,8 +1219,8 @@ function warn(text) {
 var WORD = [" \u2588\u2580\u2588 \u2588\u2584 \u2588 \u2588\u2580\u2580 \u2588\u2580\u2580 \u2588\u2580\u2580", " \u2588\u2580\u2584 \u2588 \u2580\u2588 \u2588\u2588\u2584 \u2584\u2584\u2588 \u2584\u2584\u2588"];
 var FROM = [63, 185, 80];
 var TO = [57, 197, 207];
-function gradient(line2) {
-  const chars = [...line2];
+function gradient(line3) {
+  const chars = [...line3];
   const last = Math.max(1, chars.length - 1);
   const painted = chars.map((ch, i) => {
     if (ch === " ") return ch;
@@ -1231,7 +1237,7 @@ function banner(version, stream = process.stdout) {
   const coloured = paint("done", "x", stream) !== "x";
   const trueColour = coloured && typeof stream.hasColors === "function" && stream.hasColors(2 ** 24);
   const word = WORD.map(
-    (line2) => trueColour ? gradient(line2) : paint("done", line2, stream)
+    (line3) => trueColour ? gradient(line3) : paint("done", line3, stream)
   );
   return [
     "",
@@ -1405,7 +1411,7 @@ function reportError(e) {
 }
 
 // src/version.ts
-var VERSION = "0.10.0";
+var VERSION = "0.11.0";
 
 // src/core/block.ts
 import { createHash } from "crypto";
@@ -1457,8 +1463,8 @@ ${rules.join("\n\n")}`;
   const text = [BEGIN, header(scope, hash), body, END].join("\n");
   return { text, hash, bytes: Buffer.byteLength(text, "utf8") };
 }
-function parseHeader(line2) {
-  const m = HEADER.exec(line2.trimEnd());
+function parseHeader(line3) {
+  const m = HEADER.exec(line3.trimEnd());
   if (m === null) return null;
   return { version: m[1] ?? null, scope: m[2] ?? "", hash: m[3] ?? "" };
 }
@@ -1629,8 +1635,8 @@ import { join as join8 } from "path";
 function findBlock(lines) {
   const begins = [];
   const ends = [];
-  lines.forEach((line2, i) => {
-    const l = line2.trimEnd();
+  lines.forEach((line3, i) => {
+    const l = line3.trimEnd();
     if (l === BEGIN) begins.push(i);
     if (l === END) ends.push(i);
   });
@@ -1746,6 +1752,48 @@ function hooks(rness) {
     }
   ];
 }
+var PLUGIN = ".claude/skills/rness";
+var PLUGIN_JSON = `${JSON.stringify(
+  {
+    name: "rness",
+    description: "The rness workspace in Claude Code: /rness:status."
+  },
+  null,
+  2
+)}
+`;
+function statusSkill(rness) {
+  const command = `node "\${CLAUDE_PROJECT_DIR}/${rness}/${PINNED_BIN}" status --cwd "\${CLAUDE_PROJECT_DIR}"`;
+  return `---
+name: status
+description: The status of every decision, specification, plan and other tracked document of the rness workspace, one table per directory. Read-only.
+argument-hint: '[tab]'
+disable-model-invocation: true
+allowed-tools: Bash(${command})
+---
+
+!\`${command}\`
+
+Show the output above to the user as it is: the heading and the tables,
+nothing added, nothing summarised, no other tool. Arguments: \`$ARGUMENTS\`.
+When they name a tab, show only that tab's section. If the output says the
+module cannot be found, say instead that ${rness} is not installed next to
+this repository.
+
+End with this line: _For the view with tabs and scrolling: Ctrl+Z, then
+\`npx @rness/cli status\` (q to close), then \`fg\`._
+`;
+}
+function plugin(rness, at) {
+  return [
+    { file: `${PLUGIN}/.claude-plugin/plugin.json`, at, content: PLUGIN_JSON },
+    {
+      file: `${PLUGIN}/skills/status/SKILL.md`,
+      at,
+      content: statusSkill(rness)
+    }
+  ];
+}
 var TARGETS = {
   claude: {
     name: "claude",
@@ -1786,13 +1834,15 @@ var TARGETS = {
           }
         ]
       },
+      ...plugin("../../.rness", "clones"),
       // A session opened at the workspace root reads this file, one opened
       // in a clone does not (spec 0011 §1): the hooks only, `.rness` inside.
       {
         file: ".claude/settings.json",
         at: "root",
         guarantees: hooks(".rness")
-      }
+      },
+      ...plugin(".rness", "root")
     ]
   }
 };
@@ -1907,6 +1957,10 @@ function describeGuarantee(g) {
 }
 
 // src/core/agent-targets.ts
+function wholeDiff(existing, content) {
+  if (existing === content) return null;
+  return existing === null ? "missing" : "differs from what rness writes";
+}
 async function filesOf(root, manifest, targets) {
   const files = [];
   if (!await exists(join9(root, "org"))) return files;
@@ -1914,7 +1968,7 @@ async function filesOf(root, manifest, targets) {
     for (const owned of target.files)
       if (owned.at === "root")
         files.push({
-          guarantees: owned.guarantees,
+          ...owned,
           file: join9(root, ...owned.file.split("/")),
           label: owned.file
         });
@@ -1924,7 +1978,7 @@ async function filesOf(root, manifest, targets) {
       for (const owned of target.files)
         if (owned.at === "clones")
           files.push({
-            guarantees: owned.guarantees,
+            ...owned,
             file: join9(root, "org", repo, ...owned.file.split("/")),
             label: `org/${repo}/${owned.file}`
           });
@@ -1947,12 +2001,23 @@ function writtenFiles(manifest) {
 }
 async function agentTargets(root, manifest, opts) {
   const outcomes = [];
-  for (const { guarantees, file, label } of await filesOf(
-    root,
-    manifest,
-    declared(manifest)
-  )) {
+  for (const owned of await filesOf(root, manifest, declared(manifest))) {
+    const { file, label } = owned;
     const existing = await readOrNull(file);
+    if ("content" in owned) {
+      const diff = wholeDiff(existing, owned.content);
+      if (diff === null)
+        outcomes.push({ label, status: "unchanged", detail: null });
+      else if (opts.check)
+        outcomes.push({ label, status: "stale", detail: diff });
+      else {
+        await mkdir2(dirname4(file), { recursive: true });
+        await writeFileAtomic(file, owned.content);
+        outcomes.push({ label, status: "updated", detail: null });
+      }
+      continue;
+    }
+    const { guarantees } = owned;
     if (opts.check) {
       const missing = missingGuarantees(existing, guarantees);
       if ("invalid" in missing)
@@ -1988,15 +2053,16 @@ async function leftoverTargets(root, manifest) {
     (t) => !agents.includes(t.name)
   );
   const leftovers = [];
-  for (const { guarantees, file, label } of await filesOf(
-    root,
-    manifest,
-    undeclared
-  )) {
-    const existing = await readOrNull(file);
+  for (const owned of await filesOf(root, manifest, undeclared)) {
+    const existing = await readOrNull(owned.file);
     if (existing === null) continue;
-    const missing = missingGuarantees(existing, guarantees);
-    if (!("invalid" in missing) && missing.length === 0) leftovers.push(label);
+    if ("content" in owned) {
+      if (existing === owned.content) leftovers.push(owned.label);
+      continue;
+    }
+    const missing = missingGuarantees(existing, owned.guarantees);
+    if (!("invalid" in missing) && missing.length === 0)
+      leftovers.push(owned.label);
   }
   return leftovers;
 }
@@ -2106,8 +2172,8 @@ var plainUi = {
       { label: options.doing, animate: options.git !== true },
       work
     );
-    const line2 = options.quiet === true ? null : done?.(result) ?? null;
-    if (line2 !== null) this.line(line2[0], line2[1]);
+    const line3 = options.quiet === true ? null : done?.(result) ?? null;
+    if (line3 !== null) this.line(line3[0], line3[1]);
     return result;
   }
 };
@@ -2140,7 +2206,7 @@ function sessionUi(p) {
       p.log.warn(text);
     },
     note: (title, lines) => {
-      p.note(lines.join("\n"), title, { format: (line2) => grey(line2) });
+      p.note(lines.join("\n"), title, { format: (line3) => grey(line3) });
     },
     hint: (text) => {
       p.log.message(paint("idle", text));
@@ -2154,20 +2220,20 @@ function sessionUi(p) {
     async step(options, work, done) {
       const label = options.sentence ?? tidy(options.doing);
       const finish2 = (result) => done?.(result) ?? null;
-      const label_ = (line2) => line2[2] ?? `${line2[1]} ${line2[0]}`;
+      const label_ = (line3) => line3[2] ?? `${line3[1]} ${line3[0]}`;
       if (options.git === true && !this.gitIsSilent) {
         p.log.message(paint("idle", `${label}\u2026`));
         const result = await work();
-        const line2 = finish2(result);
-        if (line2 !== null) say(line2[0], label_(line2));
+        const line3 = finish2(result);
+        if (line3 !== null) say(line3[0], label_(line3));
         return result;
       }
       const spin = p.spinner();
       spin.start(label);
       try {
         const result = await work();
-        const line2 = finish2(result);
-        spin.stop(line2 === null ? label : label_(line2));
+        const line3 = finish2(result);
+        spin.stop(line3 === null ? label : label_(line3));
         return result;
       } catch (e) {
         spin.error(`${label} \u2014 failed`);
@@ -3185,11 +3251,11 @@ function summariseSync(stdout) {
   const blocks = /* @__PURE__ */ new Map();
   const agentFiles = /* @__PURE__ */ new Map();
   const others = [];
-  for (const line2 of stdout.split("\n")) {
-    if (line2.trim() === "") continue;
-    const m = /^(updated|unchanged|stale)\s+(\S+)/.exec(line2);
+  for (const line3 of stdout.split("\n")) {
+    if (line3.trim() === "") continue;
+    const m = /^(updated|unchanged|stale)\s+(\S+)/.exec(line3);
     if (m === null) {
-      others.push(line2);
+      others.push(line3);
       continue;
     }
     const [, verb = "", path = ""] = m;
@@ -3419,8 +3485,8 @@ async function mergeScaffold(rnessDir, commit, base) {
     "--name-status",
     "HEAD"
   ]);
-  for (const line2 of status2.split("\n")) {
-    const [letter = "", path = ""] = line2.split("	");
+  for (const line3 of status2.split("\n")) {
+    const [letter = "", path = ""] = line3.split("	");
     if (path === "" || conflicts.includes(path)) continue;
     if (letter === "A") changes.push(["added", path]);
     else if (letter === "D") changes.push(["removed", path]);
@@ -3566,8 +3632,8 @@ async function syncBlocks(ui, root, shown, inPlace, sshWorks) {
     return 1;
   }
   const outcome = syncOutcome(result, { sshWorks: sshWorks === true });
-  for (const line2 of outcome.hints) ui.hint(line2);
-  for (const line2 of outcome.errors) ui.error(line2);
+  for (const line3 of outcome.hints) ui.hint(line3);
+  for (const line3 of outcome.errors) ui.error(line3);
   return outcome.code;
 }
 
@@ -3672,7 +3738,7 @@ async function createBlank(input) {
         `Workspace \`${name}\` is ready in ${shown}/.`,
         "",
         "Next:",
-        ...next.map((line2) => `  ${line2}`),
+        ...next.map((line3) => `  ${line3}`),
         ""
       ].join("\n")
     );
@@ -4315,7 +4381,7 @@ ${next2.map((l) => `  ${l}`).join("\n")}
           `Workspace for \`${org}\` is ready in ${shown}/.`,
           "",
           "Next:",
-          ...next.map((line2) => `  ${line2}`),
+          ...next.map((line3) => `  ${line3}`),
           ""
         ].join("\n")
       );
@@ -4592,7 +4658,7 @@ function finish(ui, cwd, rnessDir, label, target, ending) {
         "",
         status("upgraded", `${label} to @rness/cli ${target}`),
         "",
-        ...next.length > 0 ? ["Next:", ...next.map((line2) => `  ${line2}`), ""] : []
+        ...next.length > 0 ? ["Next:", ...next.map((line3) => `  ${line3}`), ""] : []
       ].join("\n")
     );
   return ending.commit === "refused" ? 1 : 0;
@@ -4813,8 +4879,8 @@ async function upgradeCommand(version, opts, terminal = defaultTerminal, deps =
       ui.error(
         `the commit of ${label} was refused; everything is staged \u2014 deal with what git said, then commit`
       );
-      for (const line2 of committed.output.split("\n"))
-        if (line2.trim() !== "") ui.hint(line2, "stderr");
+      for (const line3 of committed.output.split("\n"))
+        if (line3.trim() !== "") ui.hint(line3, "stderr");
     }
     return finish(ui, cwd, ws.rnessDir, label, target, {
       commit: committed.kind,
@@ -4923,9 +4989,9 @@ async function readStdin() {
 async function gitCredentialCommand(operation, input) {
   if (operation !== "get") return 0;
   const fields = /* @__PURE__ */ new Map();
-  for (const line2 of (input ?? await readStdin()).split("\n")) {
-    const eq = line2.indexOf("=");
-    if (eq > 0) fields.set(line2.slice(0, eq), line2.slice(eq + 1).trimEnd());
+  for (const line3 of (input ?? await readStdin()).split("\n")) {
+    const eq = line3.indexOf("=");
+    if (eq > 0) fields.set(line3.slice(0, eq), line3.slice(eq + 1).trimEnd());
   }
   if (fields.get("protocol") !== "https" || fields.get("host") !== "github.com")
     return 0;
@@ -4939,11 +5005,24 @@ password=${resolved.token}
 
 // src/commands/hook.ts
 import { realpath as realpath4 } from "fs/promises";
-import { isAbsolute as isAbsolute2, posix as posix5, relative as relative7, resolve as resolve7, sep as sep5 } from "path";
+import { isAbsolute as isAbsolute2, posix as posix6, relative as relative7, resolve as resolve7, sep as sep5 } from "path";
 
 // src/mcp/tools.ts
 import { readFile as readFile10, realpath as realpath3, stat as stat4 } from "fs/promises";
-import { isAbsolute, join as join23, posix as posix4, relative as relative6, resolve as resolve6, sep as sep4 } from "path";
+import { isAbsolute, join as join23, posix as posix5, relative as relative6, resolve as resolve6, sep as sep4 } from "path";
+
+// src/core/documents.ts
+import { posix as posix4 } from "path";
+function documentNumber(rel) {
+  return /^(\d{4})-/.exec(posix4.basename(rel))?.[1] ?? null;
+}
+function documentTitle(heading, number) {
+  if (number === null) return heading;
+  const rest = new RegExp(`^${number}\\s*[\u2014\u2013:-]\\s*(.+)$`).exec(heading)?.[1];
+  return rest ?? heading;
+}
+
+// src/mcp/tools.ts
 var LABELS = {
   standards: "Standards",
   adr: "Decisions",
@@ -4968,11 +5047,6 @@ async function workspaceAt(cwd) {
   const ws = await findWorkspace(cwd);
   return { ws, manifest: await loadManifest(ws.rnessDir) };
 }
-function titleOf(heading, id) {
-  if (id === null) return heading;
-  const rest = new RegExp(`^${id}\\s*[\u2014\u2013:-]\\s*(.+)$`).exec(heading)?.[1];
-  return rest ?? heading;
-}
 async function documents(rnessDir, only) {
   const docs = [];
   for (const collection of COLLECTIONS) {
@@ -4981,14 +5055,14 @@ async function documents(rnessDir, only) {
       const path = `${collection}/${item.rel}`;
       if (path === TEMPLATE) continue;
       const status2 = item.fields?.["status"];
-      const id = /^(\d{4})-/.exec(posix4.basename(item.rel))?.[1] ?? null;
+      const id = documentNumber(item.rel);
       docs.push({
         collection,
         path,
         scope: ownerScope(item.rel),
         id,
         status: typeof status2 === "string" ? status2 : null,
-        title: titleOf(item.title ?? posix4.basename(item.rel, ".md"), id),
+        title: documentTitle(item.title ?? posix5.basename(item.rel, ".md"), id),
         text: item.body
       });
     }
@@ -5018,7 +5092,7 @@ async function context(cwd, args) {
   } else
     scope = resolveScope(
       manifest,
-      relative6(ws.root, cwd).split(sep4).join(posix4.sep)
+      relative6(ws.root, cwd).split(sep4).join(posix5.sep)
     );
   const summary = await scopeSummary(ws, manifest, scope);
   return {
@@ -5231,7 +5305,7 @@ function cwdOf(input, env) {
   if (typeof cwd === "string" && cwd !== "") return cwd;
   return env["CLAUDE_PROJECT_DIR"] ?? process.cwd();
 }
-var toPosix2 = (p) => p.split(sep5).join(posix5.sep);
+var toPosix2 = (p) => p.split(sep5).join(posix6.sep);
 function count(n, [one, many]) {
   return `${n} ${n === 1 ? one : many}`;
 }
@@ -5383,10 +5457,10 @@ function errorLine(id, code, message2, data) {
 function createProtocol(opts) {
   const serverInfo = { name: opts.name, version: opts.version };
   return {
-    async handle(line2) {
+    async handle(line3) {
       let message2;
       try {
-        message2 = JSON.parse(line2);
+        message2 = JSON.parse(line3);
       } catch {
         return errorLine(null, -32700, "Parse error");
       }
@@ -5495,15 +5569,349 @@ async function mcpCommand(opts, io = {
     tools: mcpTools(opts.cwd ?? process.cwd())
   });
   const lines = createInterface({ input: io.input, crlfDelay: Infinity });
-  for await (const line2 of lines) {
-    if (line2.trim() === "") continue;
-    const answer = await protocol.handle(line2);
+  for await (const line3 of lines) {
+    if (line3.trim() === "") continue;
+    const answer = await protocol.handle(line3);
     if (answer !== null) io.output.write(`${answer}
 `);
   }
   return 0;
 }
 
+// src/commands/status.ts
+import { emitKeypressEvents } from "readline";
+
+// src/core/status.ts
+import { readdir as readdir3 } from "fs/promises";
+import { join as join24, posix as posix7 } from "path";
+var FIXED = [
+  ["adr", "ADR"],
+  ["specs", "Specs"],
+  ["plans", "Plans"]
+];
+var NOT_DISCOVERED = /* @__PURE__ */ new Set([
+  ...FIXED.map(([name]) => name),
+  "standards",
+  "skills",
+  "node_modules"
+]);
+var TEMPLATE2 = "adr/0000-template.md";
+function statusOf(item) {
+  const status2 = item.fields?.["status"];
+  return typeof status2 === "string" && status2 !== "" ? status2 : null;
+}
+function rowOf(dir, item) {
+  const base = posix7.basename(item.rel, ".md");
+  const date = /^(\d{4}-\d{2}-\d{2})-/.exec(base)?.[1] ?? null;
+  const number = date === null ? documentNumber(item.rel) : null;
+  return {
+    id: date ?? number ?? base,
+    title: documentTitle(item.title ?? base, number),
+    status: statusOf(item),
+    path: `${dir}/${item.rel}`
+  };
+}
+function newestFirst(a, b) {
+  const [x, y] = [posix7.basename(a.path), posix7.basename(b.path)];
+  if (x !== y) return x < y ? 1 : -1;
+  return a.path < b.path ? 1 : a.path > b.path ? -1 : 0;
+}
+async function statusTabs(rnessDir) {
+  const tabs = [];
+  for (const [name, label] of FIXED) {
+    const rows = (await collectMarkdown(join24(rnessDir, name))).map((item) => rowOf(name, item)).filter((row) => row.path !== TEMPLATE2);
+    tabs.push({ name, label, rows: rows.sort(newestFirst) });
+  }
+  const entries = await readdir3(rnessDir, { withFileTypes: true }).catch(
+    () => []
+  );
+  const discovered = entries.filter(
+    (e) => e.isDirectory() && !e.name.startsWith(".") && !NOT_DISCOVERED.has(e.name)
+  ).map((e) => e.name).sort();
+  for (const name of discovered) {
+    const rows = (await collectMarkdown(join24(rnessDir, name))).filter((item) => statusOf(item) !== null).map((item) => rowOf(name, item));
+    if (rows.length > 0)
+      tabs.push({
+        name,
+        label: `${name.charAt(0).toUpperCase()}${name.slice(1)}`,
+        rows: rows.sort(newestFirst)
+      });
+  }
+  return tabs;
+}
+function findTab(tabs, wanted) {
+  const w = wanted.toLowerCase();
+  return tabs.find(
+    (tab) => tab.name.toLowerCase() === w || tab.label.toLowerCase() === w
+  );
+}
+var DONE2 = /* @__PURE__ */ new Set([
+  "accepted",
+  "implemented",
+  "completed",
+  "published"
+]);
+var DROPPED = /* @__PURE__ */ new Set([
+  "rejected",
+  "superseded",
+  "abandoned"
+]);
+function statusTone(status2) {
+  if (status2 === null) return "missing";
+  const s = status2.toLowerCase();
+  if (DONE2.has(s)) return "done";
+  if (DROPPED.has(s)) return "dropped";
+  return "active";
+}
+var cell = (text) => text.replaceAll("|", "\\|");
+function statusMarkdown(workspace, tabs) {
+  const out = [`${workspace} \xB7 status`, ""];
+  for (const tab of tabs) {
+    out.push(`## ${tab.label} (${tab.rows.length})`, "");
+    if (tab.rows.length === 0) {
+      out.push("_Nothing yet._", "");
+      continue;
+    }
+    out.push("| Id | Title | Status |", "| --- | --- | --- |");
+    for (const row of tab.rows)
+      out.push(
+        `| ${cell(row.id)} | ${cell(row.title)} | ${cell(row.status ?? "?")} |`
+      );
+    out.push("");
+  }
+  return out.join("\n");
+}
+
+// src/core/status-view.ts
+var FRAME = 5;
+function pageSize(height) {
+  return Math.max(1, height - FRAME);
+}
+function lastTop(tab, page) {
+  return Math.max(0, (tab?.rows.length ?? 0) - page);
+}
+function press(view, key, tabs, page) {
+  const n = tabs.length;
+  if (key === "right" || key === "tab")
+    return { tab: (view.tab + 1) % n, top: 0 };
+  if (key === "left" || key === "backtab")
+    return { tab: (view.tab - 1 + n) % n, top: 0 };
+  const moved = {
+    up: view.top - 1,
+    down: view.top + 1,
+    pageup: view.top - page,
+    pagedown: view.top + page,
+    home: 0,
+    end: Number.MAX_SAFE_INTEGER
+  };
+  const top = moved[key] ?? view.top;
+  return {
+    tab: view.tab,
+    top: Math.min(Math.max(0, top), lastTop(tabs[view.tab], page))
+  };
+}
+function clampView(view, tabs, page) {
+  return {
+    tab: view.tab,
+    top: Math.min(view.top, lastTop(tabs[view.tab], page))
+  };
+}
+var width = (text) => [...text].length;
+function fit(text, n) {
+  if (n <= 0) return "";
+  const chars = [...text];
+  if (chars.length <= n) return text + " ".repeat(n - chars.length);
+  return `${chars.slice(0, n - 1).join("").trimEnd()}\u2026`.padEnd(n);
+}
+function line2(segments, columns) {
+  let left = columns;
+  let out = "";
+  for (const [text, style] of segments) {
+    if (left <= 0) break;
+    const chars = [...text];
+    const kept = chars.length <= left ? text : chars.slice(0, left).join("");
+    left -= width(kept);
+    out += style === void 0 ? kept : style(kept);
+  }
+  return out;
+}
+function tabBar(tabs, active, look) {
+  const segments = [[" "]];
+  tabs.forEach((tab, i) => {
+    if (i > 0) segments.push([" "]);
+    const label = ` ${tab.label} (${tab.rows.length}) `;
+    segments.push(i === active ? [label, look.inverse] : [label]);
+  });
+  return segments;
+}
+function rowLines(tab, top, page, columns, look) {
+  if (tab === void 0 || tab.rows.length === 0)
+    return [[["  Nothing here yet.", look.dim]]];
+  const idWidth = Math.max(...tab.rows.map((r) => width(r.id)));
+  const statusWidth = Math.max(...tab.rows.map((r) => width(r.status ?? "?")));
+  const titleWidth = Math.max(
+    1,
+    columns - 1 - (2 + idWidth + 2 + 2 + statusWidth)
+  );
+  return tab.rows.slice(top, top + page).map((row) => [
+    ["  "],
+    [row.id.padEnd(idWidth)],
+    ["  "],
+    [fit(row.title, titleWidth)],
+    ["  "],
+    [
+      (row.status ?? "?").padEnd(statusWidth),
+      (text) => look.tone(statusTone(row.status), text)
+    ]
+  ]);
+}
+function footer(above, below) {
+  const parts = [
+    ...above > 0 ? [`\u2191 ${above} above`] : [],
+    ...below > 0 ? [`\u2193 ${below} more`] : [],
+    "\u2190/\u2192 tab \xB7 \u2191/\u2193 scroll \xB7 q close"
+  ];
+  return `  ${parts.join(" \xB7 ")}`;
+}
+function renderView(view, tabs, workspace, columns, height, look) {
+  const page = pageSize(height);
+  const tab = tabs[view.tab];
+  const rule = [[` ${"\u2500".repeat(Math.max(0, columns - 2))}`]];
+  const rows = rowLines(tab, view.top, page, columns, look);
+  const shown = Math.min(page, rows.length);
+  const total = tab?.rows.length ?? 0;
+  const lines = [
+    [[` rness \xB7 ${workspace}`, look.bold]],
+    tabBar(tabs, view.tab, look),
+    rule,
+    ...rows,
+    ...Array.from({ length: page - shown }, () => [[""]]),
+    rule,
+    [[footer(view.top, Math.max(0, total - view.top - page)), look.dim]]
+  ];
+  return lines.slice(0, Math.max(0, height)).map((l) => line2(l, columns));
+}
+
+// src/commands/status.ts
+var ENTER = "\x1B[?1049h\x1B[?25l";
+var LEAVE = "\x1B[?25h\x1B[?1049l";
+function lookFor(output) {
+  return {
+    bold: (text) => bold(text, output),
+    dim: (text) => grey(text, output),
+    inverse: (text) => inverse(text, output),
+    tone: (tone, text) => tone === "done" ? paint("done", text, output) : tone === "dropped" ? grey(text, output) : tone === "missing" ? paint("error", text, output) : paint("warn", text, output)
+  };
+}
+var MOVES = /* @__PURE__ */ new Set([
+  "left",
+  "right",
+  "up",
+  "down",
+  "pageup",
+  "pagedown",
+  "home",
+  "end"
+]);
+function keyOf(key) {
+  const name = key?.name;
+  if (name === void 0) return null;
+  if (name === "q" || name === "escape" || key?.ctrl === true && name === "c")
+    return "close";
+  if (name === "tab") return key?.shift === true ? "backtab" : "tab";
+  return MOVES.has(name) ? name : null;
+}
+function showView(tabs, workspace, start, { input, output }) {
+  return new Promise((resolve8, reject) => {
+    const look = lookFor(output);
+    let view = { tab: start, top: 0 };
+    const rows = () => output.rows || 24;
+    const draw = () => {
+      view = clampView(view, tabs, pageSize(rows()));
+      const lines = renderView(
+        view,
+        tabs,
+        workspace,
+        output.columns || 80,
+        rows(),
+        look
+      );
+      output.write(`\x1B[H${lines.map((l) => `${l}\x1B[K`).join("\r\n")}\x1B[J`);
+    };
+    const restore = () => {
+      output.write(LEAVE);
+    };
+    const close = (error) => {
+      input.off("keypress", onKey);
+      output.off("resize", onResize);
+      process.off("exit", restore);
+      input.setRawMode(false);
+      input.pause();
+      restore();
+      if (error === void 0) resolve8();
+      else reject(error);
+    };
+    const guarded = (step2) => {
+      try {
+        step2();
+      } catch (e) {
+        close(e);
+      }
+    };
+    const onKey = (_, key) => {
+      const k = keyOf(key);
+      if (k === "close") close();
+      else if (k !== null)
+        guarded(() => {
+          view = press(view, k, tabs, pageSize(rows()));
+          draw();
+        });
+    };
+    const onResize = () => {
+      guarded(draw);
+    };
+    emitKeypressEvents(input);
+    input.setRawMode(true);
+    input.resume();
+    output.write(ENTER);
+    process.on("exit", restore);
+    input.on("keypress", onKey);
+    output.on("resize", onResize);
+    guarded(draw);
+  });
+}
+async function statusCommand(tab, opts, terminal = { input: process.stdin, output: process.stdout }) {
+  try {
+    const ws = await findWorkspace(opts.cwd ?? process.cwd());
+    const manifest = await loadManifest(ws.rnessDir);
+    const workspace = workspaceName(manifest, ws.root);
+    const tabs = await statusTabs(ws.rnessDir);
+    const wanted = tab === void 0 ? void 0 : findTab(tabs, tab);
+    if (tab !== void 0 && wanted === void 0) {
+      process.stderr.write(
+        `unknown tab "${tab}" (tabs: ${tabs.map((t) => t.name).join(", ")})
+`
+      );
+      return 2;
+    }
+    if (terminal.input.isTTY === true && terminal.output.isTTY === true) {
+      await showView(
+        tabs,
+        workspace,
+        wanted === void 0 ? 0 : tabs.indexOf(wanted),
+        terminal
+      );
+      return 0;
+    }
+    terminal.output.write(
+      statusMarkdown(workspace, wanted === void 0 ? tabs : [wanted])
+    );
+    return 0;
+  } catch (e) {
+    return reportError(e);
+  }
+}
+
 // src/cli.ts
 function buildProgram(state) {
   const program = new Command().name("rness").description("Configuration-plane CLI for rness workspaces").version(VERSION, "-v, --version", "print the version").exitOverride().showHelpAfterError().configureOutput({
@@ -5531,6 +5939,11 @@ function buildProgram(state) {
   ).option("--json", "print JSON instead of Markdown").addOption(new Option("--cwd <dir>").hideHelp()).action(async (opts) => {
     state.code = await contextCommand(opts);
   });
+  program.command("status").description(
+    "Show the status of every decision, specification and plan, a tab per directory"
+  ).argument("[tab]", "open on this tab: adr, specs, plans, \u2026").addOption(new Option("--cwd <dir>").hideHelp()).action(async (tab, opts) => {
+    state.code = await statusCommand(tab, opts);
+  });
   program.command("validate").description(
     "Check the .rness/ tree against the contract and every generated block"
   ).addOption(new Option("--cwd <dir>").hideHelp()).action(async (opts) => {
@@ -5759,4 +6172,4 @@ export {
   OWN_COMMANDS,
   catchUp
 };
-//# sourceMappingURL=chunk-R4BRAAC2.js.map
+//# sourceMappingURL=chunk-LW4S5OLI.js.map