claudemd-cli 0.26.0 → 0.26.2

package/CHANGELOG.md

@@ -8,6 +8,24 @@ All notable changes to the `claudemd` plugin. This changelog tracks plugin artif
 - **Canonical spec version source**: `spec/CLAUDE.md` top-line title (`# AI-CODING-SPEC vX.Y.Z — Core`) + `spec/CLAUDE-changelog.md` top `##` entry.
 - **Plugin semver vs spec semver** are independent: plugin patch (0.2.0 → 0.2.1) may ship when spec is unchanged (this release); plugin minor (0.1.9 → 0.2.0) ships when spec minor updates (v0.2.0 shipped spec v6.10.0).
 
+## [0.26.2] - 2026-07-07
+
+**Patch — dogfood QA hardening: three false-positive / data-loss fixes surfaced by an end-to-end usage pass.** All `fix:` (restore intended behavior); spec unchanged (stays v6.14.1). No new user-facing features.
+
+- **statusLine multi-supersede data loss** (`scripts/lib/statusline.js`): `/claudemd-statusline adopt --supersede=A` then `--supersede=B` on a composite host overwrote the single `{superseded:<prov>}` restore record, so `remove()` restored only B — A was permanently lost from the host registry. The record is now a `{superseded:[…]}` list: `adopt()` appends (dedup by id), `remove()` restores ALL entries in reverse order (front-insert) so they regain their original relative order. Legacy singular records written by ≤0.26.1 are still restored (`readSupersededList()` normalizes both shapes), so an upgrade taken mid-supersede loses nothing.
+- **banned-vocab `-am` false positive** (`hooks/banned-vocab-check.sh`): the commit-message extractor matched `-m`/`--message` but not combined short-flag blocks, so `git commit -am "…"` (one of the most common forms) fell through to the whole-command fallback — a banned word in a *chained* segment (`git commit -am "clean fix" && npm run comprehensive-x`) falsely denied a clean-message commit that the identical `-m` form passed. The extract + strip regexes now use `-[[:alpha:]]*m` (matches `-m`/`-am`/`-vam`; a strict superset — bare `-m` still matches with zero leading alphas).
+- **§10-V identifier/path FP in the standalone CLI + transcript scan** (`scripts/lib/lint.js`, `bin/claudemd-lint.js`, `hooks/transcript-vocab-scan.sh`): the v0.23.19 Path 2 sanitizer was never ported to two siblings. `claudemd-cli lint` (used in git pre-commit hooks / CI) flagged commit messages naming a file/branch/backtick-identifier that embeds a high-fire word (`refactor comprehensive-parser.js` → exit 1 → **blocked commit**); `transcript-vocab-scan` inflated §10-V advisory telemetry the same way. Added `stripIdentifiers()` (new `lib/lint.js` export) + a `scan({sanitize})` opt-in wired into the CLI `lint`/`audit` paths, and the mirror awk+sed in `transcript-vocab-scan.sh`. Rule set: fenced blocks → inline backtick spans → slashed-path runs → bare `name.ext` files (lowercase-extension only, so decimals/versions like `3.5x`/`v6.14` survive and a baseline-less ratio claim is not swallowed — no false negative). Bare hyphenated identifiers with no extension/slash (`robust-retry`) remain a residual FP, the same `\b`-boundary limitation Path 2 has.
+- **Tests (+8 → 611 Node tests; +5 shell hook tests)**: `statusline-adopt.test.js` multi-supersede + legacy-singular restore; `lint.test.js` `stripIdentifiers` + `scan({sanitize})` FP-fix + FN-guards; `banned-vocab.test.sh` 41 → 44 (`-am`/`-vam` isolation); `transcript-vocab-scan.test.sh` 12 → 14 (identifier-only clean / bare-prose-beside-id still fires).
+
+## [0.26.1] - 2026-07-06
+
+**Patch — post-release review hardening of v0.26.0 statusLine coexistence.** Three fixes from an independent post-ship review (`superpowers:requesting-code-review`); no user-visible behavior change on the normal path. Spec unchanged (stays v6.14.1).
+
+- **Durability fix** (`scripts/lib/statusline-hosts.js`): the guest-registry write now writes the durable `~/.claude` mirror **first** and no longer swallows its errors. Previously the volatile `~/.cache` primary was written first and unguarded while the durable mirror — the backstop code-graph self-heals the primary from — was best-effort; a silently-dropped mirror write could diverge from the primary and, after a `~/.cache` eviction, drop claudemd's segment. A failed durable write now surfaces instead of hiding.
+- **Observability** (`scripts/lib/statusline.js`, `scripts/statusline-adopt.js`): `adopt --supersede=<id>` for an id not in the host registry no longer silently no-ops — `adopt()` returns `supersedeMissed:<id>` and the CLI warns, so a stale / TOCTOU id is visible instead of passing as a successful supersede.
+- **Single source of truth for the supersede heuristic** (`scripts/lib/statusline.js`, `commands/claudemd-statusline.md`): `detect()` now surfaces the tested `manualPsCandidates()` predicate as a `psCandidates` array; the command reads that field instead of re-deriving the hand-made-PS1 heuristic in prose, removing drift between the tested predicate and the one that runs.
+- **Tests (+5 → 603 Node tests)**: durable-mirror-first-no-swallow (`statusline-hosts.test.js`), `psCandidates` on host + null off-host and `supersedeMissed` (`statusline-adopt.test.js`), CLI supersede-missed warning (`statusline-cli.test.js`).
+
 ## [0.26.0] - 2026-07-06
 
 **Minor — statusLine multi-provider coexistence.** When a composite host (code-graph) owns the `statusLine` slot, `/claudemd-statusline` now registers claudemd as a *guest* provider in the host's registry so both segments render (`claudemd | code-graph`), instead of clobbering the slot. Empty-slot behavior is unchanged. Spec content unchanged (v6.14.1).

package/bin/claudemd-lint.js

@@ -252,7 +252,7 @@ function lintCmd(rawArgs) {
   const HAS_BASELINE = /baseline/i;
   const baselineExempt = HAS_NUMERIC_ARROW.test(text) || HAS_BASELINE.test(text);
 
-  const hits = scan(text, { excludeRatio: baselineExempt });
+  const hits = scan(text, { excludeRatio: baselineExempt, sanitize: true });
   if (json) {
     process.stdout.write(formatJSON({ scope: 'lint', text, hits }) + '\n');
   } else {
@@ -332,7 +332,7 @@ function auditCmd(rawArgs) {
   const patterns = readPatterns();
   const annotated = turns.map(t => ({
     ...t,
-    hits: scan(t.text, { excludeRatio: !includeRatio, patterns }),
+    hits: scan(t.text, { excludeRatio: !includeRatio, patterns, sanitize: true }),
   }));
   const flaggedCount = annotated.reduce((n, t) => n + (t.hits.length > 0 ? 1 : 0), 0);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudemd-cli",
-  "version": "0.26.0",
+  "version": "0.26.2",
   "description": "Standalone CLI for §10-V banned-vocab + transcript scanning. Companion to the claudemd Claude Code plugin (github.com/sdsrss/claudemd) for use in git pre-commit hooks, GitHub Actions, and other agents.",
   "type": "module",
   "bin": {

package/scripts/lib/lint.js

@@ -80,8 +80,47 @@ function posixClassesToJs(regex) {
   return out;
 }
 
-export function scan(text, { excludeRatio = false, patterns } = {}) {
+// stripIdentifiers — remove code / identifier / path regions before §10-V
+// matching so a filename, branch, or backtick span quoting a high-fire word is
+// not read as a value claim. `\b` treats '-', '/', '.' as word boundaries, so
+// `\bcomprehensive\b` fires INSIDE `comprehensive-parser.js` or a branch name
+// `docs/comprehensive-audit`. Mirrors hooks/banned-vocab-check.sh's v0.23.19
+// Path 2 sanitizer (fenced blocks → inline backtick spans → slashed-path runs)
+// and adds a bare dotted-file token strip, because the CLI's primary input —
+// commit messages — commonly names bare files (`refactor comprehensive-parser.js`)
+// without backticks or a leading path. Token classes are ASCII-only so 中文
+// prose and bare-word claims (the real violations) stay intact and still match.
+export function stripIdentifiers(text) {
+  if (!text) return text;
+  // 1. Fenced code blocks: line-based fence toggle, mirroring the bash awk
+  //    `/^[[:space:]]*```/{f=!f; next} !f` — drop the ``` marker lines AND the
+  //    body between them. An unterminated fence drops to EOF (in_fence stays on).
+  const kept = [];
+  let inFence = false;
+  for (const line of text.split('\n')) {
+    if (/^\s*```/.test(line)) { inFence = !inFence; continue; }
+    if (!inFence) kept.push(line);
+  }
+  return kept.join('\n')
+    // 2. Inline backtick spans.
+    .replace(/`[^`]*`/g, ' ')
+    // 3. Slashed-path runs (branch names, file paths, URLs) — Path 2's rule.
+    .replace(/[A-Za-z0-9._@~-]*\/[A-Za-z0-9._/@~-]*/g, ' ')
+    // 4. Bare dotted-file tokens (foo.js, comprehensive-parser.ts) — CLI
+    //    extension. The extension must start with a LOWERCASE letter, which
+    //    (a) excludes decimals / versions ("3.5x", "v6.14") whose ".5x"/".14"
+    //    could otherwise swallow a baseline-less ratio claim → false negative,
+    //    and (b) excludes sentence-boundary typos ("comprehensive.Next", capital
+    //    after the dot) so a real claim isn't stripped. Only true `name.ext`
+    //    identifiers with a lowercase extension are removed.
+    .replace(/[A-Za-z0-9_-]+\.[a-z][a-z0-9]*/g, ' ');
+}
+
+export function scan(text, { excludeRatio = false, patterns, sanitize = false } = {}) {
   if (!text) return [];
+  // Sanitize identifier/path regions when asked (CLI lint/audit opt in). Match
+  // against the stripped text; the caller keeps the original for display.
+  const scanText = sanitize ? stripIdentifiers(text) : text;
   const pats = patterns || readPatterns();
   const hits = [];
   for (const p of pats) {
@@ -92,7 +131,7 @@ export function scan(text, { excludeRatio = false, patterns } = {}) {
     } catch {
       continue; // bad regex — skip (fail-open)
     }
-    const m = text.match(re);
+    const m = scanText.match(re);
     if (m) hits.push({ match: m[0], regex: p.regex, reason: p.reason, isRatio: p.isRatio });
   }
   return hits;