runlist 0.98.0 → 0.98.1

package/README.md

@@ -71,8 +71,8 @@ controls are experimental; live retrieval depends on a compatible external
 provider. Local chat and push are deferred.
 
 <!-- runlist:release:start -->
-CLI and desktop release version: **0.98.0**.
-[Mac installer and release notes](https://github.com/reowens/runlist/releases/tag/desktop-v0.98.0).
+CLI and desktop release version: **0.98.1**.
+[Mac installer and release notes](https://github.com/reowens/runlist/releases/tag/desktop-v0.98.1).
 Normal product releases publish both components; an installed Mac app is updated with rollback after it has quit.
 <!-- runlist:release:end -->
 
@@ -105,11 +105,12 @@ Host source, cache and registry copies are labelled separately; a cache entry
 alone does not prove which copy a running host has loaded. No package manager or
 host command runs to produce the `doctor --project` installation report.
 
-**0.97.0 is published and installed locally.** It adds the `runlist show`
-brief (outline, open boxes and `--section` reads with line numbers), counts
-checklists outside code fences only, and trims session and subagent start-up
-context. The desktop app's own code is unchanged from 0.96.1; it bundles the
-0.97.0 engine. The Mac installer is signed, notarized and verified; installation
+**0.98.0 is published and installed locally.** `runlist show` briefs a plan
+(outline, open boxes and `--section` reads with line numbers), marks each
+phase's tally and the active phase, and groups open boxes by phase;
+`runlist use <doc>` briefs a doc over 500 lines. The agent workflow says to
+read plans that way. The desktop app's own code is unchanged from 0.96.1; it
+bundles the 0.98.0 engine. The Mac installer is signed, notarized and verified; installation
 retained the previous app for rollback. Open it with `rl desktop`. See the
 [release validation](desktop/VALIDATION.md#current-mac-release--2026-10-22)
 for checks and evidence. Full-app dialog accessibility remains an open finding;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runlist",
-  "version": "0.98.0",
+  "version": "0.98.1",
   "description": "CLI for managing markdown documents with YAML frontmatter — index, query, validate, graph, export, lifecycle, and AI summaries.",
   "type": "module",
   "license": "MIT",

package/plugins/runlist-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "runlist-codex",
-  "version": "0.98.0",
+  "version": "0.98.1",
   "description": "Runlist workflow skill, session orientation, and tool guard for Codex",
   "author": {
     "name": "Reo Owens"

package/src/brief.mjs

@@ -16,7 +16,7 @@ export const LIMITS = {
 };
 
 // Several files at once is a survey; each one gets less.
-export const SURVEY_LIMITS = { ...LIMITS, outline: 20, boxes: 10 };
+export const SURVEY_LIMITS = { ...LIMITS, outline: 20, boxes: 10, listItems: 4 };
 
 export const cut = (text, width = LIMITS.width) =>
   text.length > width ? `${text.slice(0, width - 3)}...` : text;

package/src/show.mjs

@@ -79,6 +79,9 @@ export function showDoc(abs, config) {
   };
 }
 
+// A long next step is cut in the brief, as the pickup card cuts it.
+const NEXT_STEP_WIDTH = 300;
+
 // Fields the text card prints. Everything else non-empty is named on one line
 // so a reader knows it is there without printing the frontmatter.
 const CARD_FIELDS = new Set(['title', 'status', 'next_step', 'blockers']);
@@ -228,12 +231,25 @@ export function runShow(args, config) {
   cards.forEach((c, n) => {
     if (n) process.stdout.write('\n');
     const out = [`${c.title}  (${c.status ?? 'no status'})`, c.path];
-    if (c.nextStep) out.push(`Next: ${c.nextStep}`);
+    if (c.nextStep) out.push(`Next: ${c.brief ? cut(c.nextStep, NEXT_STEP_WIDTH) : c.nextStep}`);
     for (const b of c.blockers) out.push(`Blocker: ${b}`);
     // The brief's open-box line carries the same count, read outside code fences.
     if (c.checklist?.total && !c.brief) out.push(`Checklist: ${c.checklist.completed} of ${c.checklist.total} done`);
-    for (const r of c.related) out.push(`${r.field}: ${r.path ?? `${r.ref} (missing)`}${r.status ? `  (${r.status})` : ''}`);
-    if (c.links.length) out.push(`Linked from the body: ${c.links.map(l => l.path).join(', ')}`);
+    // With the brief, each related field and the body links show their first
+    // few entries and a count: a hub's dozens of related plans outweighed the
+    // brief itself. --card and --json list every one.
+    const cap = c.brief ? limits.listItems : Infinity;
+    const perField = new Map();
+    for (const r of c.related) {
+      const n = (perField.get(r.field) ?? 0) + 1;
+      perField.set(r.field, n);
+      if (n <= cap) out.push(`${r.field}: ${r.path ?? `${r.ref} (missing)`}${r.status ? `  (${r.status})` : ''}`);
+    }
+    for (const [field, n] of perField) if (n > cap) out.push(`${field}: +${n - cap} more (--card lists all)`);
+    if (c.links.length) {
+      const shown = c.links.slice(0, cap).map(l => l.path).join(', ');
+      out.push(`Linked from the body: ${shown}${c.links.length > cap ? ` (+${c.links.length - cap} more)` : ''}`);
+    }
     if (c.brief) out.push(...renderBrief(c, c.brief));
     process.stdout.write(out.join('\n') + '\n');
   });