runlist 0.95.5 → 0.95.6

package/README.md

@@ -47,8 +47,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.95.5**.
-[Mac installer and release notes](https://github.com/reowens/runlist/releases/tag/desktop-v0.95.5).
+CLI and desktop release version: **0.95.6**.
+[Mac installer and release notes](https://github.com/reowens/runlist/releases/tag/desktop-v0.95.6).
 Normal product releases publish both components; an installed Mac app is updated with rollback after it has quit.
 <!-- runlist:release:end -->
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runlist",
-  "version": "0.95.5",
+  "version": "0.95.6",
   "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.95.5",
+  "version": "0.95.6",
   "description": "Runlist workflow skill, session orientation, and tool guard for Codex",
   "author": {
     "name": "Reo Owens"

package/src/extractors.mjs

@@ -81,7 +81,7 @@ export function extractBodyLinks(body) {
 }
 
 export function extractChecklistCounts(body) {
-  const matches = [...body.matchAll(/^\s*[-*]\s+\[([ xX])\]\s+/gm)];
+  const matches = [...body.matchAll(/^\s*[-*]\s+\[([ xX~])\]\s+/gm)];
   let completed = 0;
   let open = 0;
 

package/src/index.mjs

@@ -335,12 +335,14 @@ export function parseDocFile(filePath, config, opts = {}) {
   if (text && text.shipsMetadataVersion !== 1) text = null;
   // Validation reads the body itself, so only a fast build can skip the read.
   let body = null;
+  let bodyLineOffset = 0;
   let rawSource = null;
   if (!text || !fast) {
     const raw = opts.source ?? readFileSync(filePath, 'utf8');
     rawSource = raw;
     const extracted = extractFrontmatter(raw);
     body = extracted.body;
+    bodyLineOffset = extracted.bodyLineOffset;
     // A file rewritten between the stat and the read no longer matches its stamp.
     if (text && Buffer.byteLength(raw) !== stampSize(stamp)) text = null;
     if (!text) {
@@ -471,7 +473,7 @@ export function parseDocFile(filePath, config, opts = {}) {
       return doc;
     }
     validateDoc(doc, parsedFrontmatter, headingTitle, config);
-    validatePlanShape(doc, body, parsedFrontmatter, config);
+    validatePlanShape(doc, body, parsedFrontmatter, config, bodyLineOffset);
     validateDocShape(doc, body, parsedFrontmatter, config);
   }
   return doc;

package/src/parse-cache.mjs

@@ -17,7 +17,7 @@ import { readEnv, stateDir } from './naming.mjs';
 // a missing, unreadable or foreign-version file is treated as empty, a failed
 // write is dropped, and `RUNLIST_NO_PARSE_CACHE=1` turns it off.
 
-const SCHEMA = 1;
+const SCHEMA = 2;
 const FILE_NAME = 'parse-cache';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const VERSION = (() => {

package/src/section.mjs

@@ -73,7 +73,7 @@ export function findSection(sections, name) {
 const GLYPH_PATTERNS = [
   { kind: 'shipped',     re: /(✅|☑|✔|✓)/ },
   { kind: 'skipped',     re: /(⏭)/ },
-  { kind: 'in-progress', re: /(🟡|🔄)/ },
+  { kind: 'in-progress', re: /(🟡|🟨|🔄)/ },
   { kind: 'blocked',     re: /(🚧|🔴)/ },
   { kind: 'todo',        re: /(⬜|⬛|◻|☐)/ },
 ];
@@ -115,7 +115,7 @@ export function detectMarker(heading) {
 // and the space, is not \s, and ends the run — so a heading led by the
 // emoji-presentation form was not a phase heading at all, while the bare
 // codepoint was. Reported by the owner, 2026-08-16.
-const PHASE_DECORATION = String.raw`[\s>*_~\`#-]*(?:[✅🚧⬜🟡⏭☑✔✓◻☐⬛🔴🔄][︎️]?\s*)*`;
+const PHASE_DECORATION = String.raw`[\s>*_~\`#-]*(?:[✅🚧⬜🟡🟨⏭☑✔✓◻☐⬛🔴🔄][︎️]?\s*)*`;
 const PHASE_LEAD = new RegExp(`^${PHASE_DECORATION}phase\\b`, 'i');
 const FILES_MANIFEST_ANCESTOR = new RegExp(`^${PHASE_DECORATION}files\\b`, 'i');
 
@@ -157,18 +157,25 @@ const PHASE_COMPOUND_COMMENTARY = new RegExp(
 // Dated execution receipts describe an attempt or acceptance record, not a work phase.
 const PHASE_DATED_RECEIPT = new RegExp(
   `^${PHASE_DECORATION}phase\\s+\\S+\\s+` +
-  `(?:execution|completed[- ]work\\s+record|personal\\s+billing\\s+acceptance|portal\\s+attempt)` +
+  `(?:execution|completed[- ]work\\s+record|personal\\s+billing\\s+acceptance|portal\\s+attempt|` +
+  `receipts?|state|verification|build|shaping\\s+walk)` +
   `\\s*,\\s*(?:closed\\s+)?(?:[A-Z][a-z]+\\s+\\d{1,2},\\s+\\d{4}|\\d{4}-\\d{2}-\\d{2})\\b`,
   'i',
 );
 
+const PHASE_RECORDED_MECHANICS = new RegExp(
+  `^${PHASE_DECORATION}phase\\s+\\S+\\s+mechanics\\s*,\\s*recorded\\b`,
+  'i',
+);
+
 export function isPhaseHeading(section) {
   if (section.level !== 3) return false;
   if (FILES_MANIFEST_ANCESTOR.test(section.h2Ancestor ?? '')) return false;
   return PHASE_LEAD.test(section.heading)
     && !PHASE_COMMENTARY.test(section.heading)
     && !PHASE_COMPOUND_COMMENTARY.test(section.heading)
-    && !PHASE_DATED_RECEIPT.test(section.heading);
+    && !PHASE_DATED_RECEIPT.test(section.heading)
+    && !PHASE_RECORDED_MECHANICS.test(section.heading);
 }
 
 // A phase's OWN checklist — the boxes directly under its heading, stopping at
@@ -179,7 +186,7 @@ export function phaseTally(section) {
   for (const line of String(section?.body ?? '').split('\n')) {
     if (/^#{1,6}\s/.test(line)) break;
     if (/^\s*[-*]\s*\[x\]/i.test(line)) checked++;
-    else if (/^\s*[-*]\s*\[ \]/.test(line)) unchecked++;
+    else if (/^\s*[-*]\s*\[[ ~]\]/.test(line)) unchecked++;
   }
   return { checked, unchecked, total: checked + unchecked };
 }

package/src/validate.mjs

@@ -626,7 +626,7 @@ export function checkGitStaleness(docs, config, options = {}) {
 
 // Plan-shape lint: soft warnings on convention drift. Plan-only.
 // Body is the unparsed plan body (everything after the closing `---`).
-export function validatePlanShape(doc, body, frontmatter, config) {
+export function validatePlanShape(doc, body, frontmatter, config, bodyLineOffset = 0) {
   if (doc.type !== 'plan') return;
   // Skip plans in terminal/archive statuses (closed work shouldn't generate noise)
   if (config.lifecycle.terminalStatuses.has(doc.status) || config.lifecycle.archiveStatuses.has(doc.status)) return;
@@ -707,7 +707,7 @@ export function validatePlanShape(doc, body, frontmatter, config) {
     doc.warnings.push({
       path: doc.path,
       level: 'warning',
-      message: `Phase marker contradicts its own checklist (line ${phase.lineStart}): \`${phase.heading.trim()}\` is marked ${conflict.declared}, but ${conflict.checked}/${conflict.total} boxes are checked — that reads as ${conflict.implied}. Update whichever half is stale.`,
+      message: `Phase marker contradicts its own checklist (line ${bodyLineOffset + phase.lineStart}): \`${phase.heading.trim()}\` is marked ${conflict.declared}, but ${conflict.checked}/${conflict.total} boxes are checked — that reads as ${conflict.implied}. Update whichever half is stale.`,
     });
   }
 }