runlist 0.98.0 → 0.98.2

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.2**.
+[Mac installer and release notes](https://github.com/reowens/runlist/releases/tag/desktop-v0.98.2).
 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.1 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, groups open boxes by phase, and caps long
+related-plan and link lists; `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.1 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;
@@ -742,7 +743,7 @@ replacement checks.
 To associate a child handoff with its parent, use
 `runlist baton --subagent review --parent resume-session-name @/tmp/review.md`.
 This saves `parent_prompt: resume-session-name`; the parent can be saved later.
-`rl prompts` collapses children into a `[+ N subagent prompts]` count on
+`rl prompts` collapses children into a `[+N subagent]` count on
 the matching `resume-*` prompt's line. Use `rl prompts --verbose` to expand their names
 and target plans. Existing `subagent-*`, `agent-*`
 and `session-*` names also group when they share the parent's name stem (the

package/bin/runlist.mjs

@@ -1313,7 +1313,7 @@ Pass \`--no-claim\` to read and archive the prompt without starting the plan.
 
 Default prompt statuses: pending, archived.
 
-The default list shows [+ N subagent prompts] on their resume-* parent's line.
+The default list shows [+N subagent] on their resume-* parent's line.
 Use --verbose to expand their names and targets.
 Record the parent with \`baton --subagent <task> --parent resume-<name>\`;
 legacy child names sharing the parent's name stem also group. Missing-parent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runlist",
-  "version": "0.98.0",
+  "version": "0.98.2",
   "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.2",
   "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/prompts.mjs

@@ -186,7 +186,7 @@ function renderPromptQueueList(index, config) {
   const visible = groups.filter(group => !isAgentHandoff(group.doc));
   const maxSlug = Math.min(36, Math.max(0, ...visible.map(({ doc }) => path.basename(doc.path, '.md').length)));
   const nextPath = queue[0]?.doc.path;
-  const childCount = children => `[+ ${children.length} subagent prompt${children.length === 1 ? '' : 's'}]`;
+  const childCount = children => `[+${children.length} subagent]`;
   for (const { doc: p, children } of visible) {
     const slug = path.basename(p.path, '.md').padEnd(maxSlug);
     const marker = p.path === nextPath ? green('[NEXT]') : '      ';

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');
   });