@mutmutco/codex-plugin 4.6.25 → 4.6.26

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mmi",
-  "version": "4.6.25",
+  "version": "4.6.26",
   "mmiCompat": "4.x",
   "description": "MMI workflow skills and org gates delivery.",
   "author": {

package/cli/dist/main.cjs

@@ -25243,6 +25243,9 @@ var CMD_RE = /`mmi-cli ((?:[a-z][a-z-]*)(?: [a-z][a-z-]*){0,3})/g;
 var RETIRED_RE = /\b(retired|historical|removed|deleted|gone|no longer|superseded|legacy)\b/i;
 var ROOT_DOCS = ["README.md", "architecture.md"];
 var SKIP_WALK = ["docs/decisions/"];
+function formatDocRefFinding(finding) {
+  return `${finding.doc}:${finding.line} [${finding.kind}] ${finding.detail}${finding.suggest?.length ? ` (did you mean ${finding.suggest[0]}?)` : ""}`;
+}
 function refFirstSegment(ref) {
   return ref.replace(/^(\.\/)+/, "").split("/")[0];
 }
@@ -25663,21 +25666,14 @@ function defaultIsIgnored(root, relPaths, exec3 = import_node_child_process6.exe
     throw error;
   }
 }
-function defaultTrackedFirstSegments(root, firstSegments, exec3 = import_node_child_process6.execFileSync) {
-  if (firstSegments.length === 0) return /* @__PURE__ */ new Set();
+function defaultTrackedFiles(root, firstSegments, exec3 = import_node_child_process6.execFileSync) {
   try {
     const out = exec3("git", ["ls-files", "-z", "--", ...firstSegments.map((s) => `:(literal)${s}`)], {
       cwd: root,
       encoding: "utf8",
       maxBuffer: CHECK_IGNORE_MAX_BUFFER
     });
-    const tracked = /* @__PURE__ */ new Set();
-    for (const path2 of out.split("\0")) {
-      if (path2) for (const segment of firstSegments) {
-        if (path2 === segment || path2.startsWith(`${segment}/`)) tracked.add(segment);
-      }
-    }
-    return tracked;
+    return out.split("\0").filter(Boolean);
   } catch (error) {
     if (error?.status === 128) return null;
     if (error?.code === "ENOENT") return null;
@@ -25721,7 +25717,12 @@ function runDocRefs(root, deps = {}) {
   const exists = deps.exists ?? import_node_fs19.existsSync;
   const listDocs = deps.listDocs ?? defaultListDocs;
   const isIgnored = deps.isIgnored ?? ((paths) => defaultIsIgnored(root, paths));
-  const trackedFirstSegments = deps.trackedFirstSegments ?? ((segs) => defaultTrackedFirstSegments(root, segs));
+  let inventory;
+  const trackedFiles = () => inventory === void 0 ? inventory = deps.trackedFiles ? deps.trackedFiles() : deps.trackedFirstSegments ? null : defaultTrackedFiles(root, []) : inventory;
+  const trackedFirstSegments = deps.trackedFirstSegments ?? ((segs) => {
+    const files = trackedFiles();
+    return files == null ? null : new Set(segs.filter((seg) => files.some((path2) => path2 === seg || path2.startsWith(`${seg}/`))));
+  });
   const commandPaths = deps.commandPaths ?? null;
   const walked = listDocs(root);
   const ignoredDocs = walked.length ? isIgnored(walked) : /* @__PURE__ */ new Set();
@@ -25761,6 +25762,18 @@ ${sourceMessages}`;
     (override ? warnings : findings).push(...stale);
     if (!/^Seed-Runbook-Affected:[ \t]*\S.*$/m.test(allMessages)) findings.push(...seedStale);
   }
+  for (const finding of findings) {
+    if (finding.kind !== "missing-path") continue;
+    const directory = import_node_path16.posix.dirname(import_node_path16.posix.normalize(finding.detail)).split("/");
+    const distance = (path2) => {
+      const parts = import_node_path16.posix.dirname(path2).split("/");
+      let common = 0;
+      while (common < directory.length && common < parts.length && directory[common] === parts[common]) common += 1;
+      return directory.length + parts.length - 2 * common;
+    };
+    const suggest = [...new Set(trackedFiles() ?? [])].filter((path2) => import_node_path16.posix.basename(path2) === import_node_path16.posix.basename(finding.detail) && exists((0, import_node_path16.join)(root, path2))).sort((a, b) => distance(a) - distance(b) || a.localeCompare(b)).slice(0, 3);
+    if (suggest.length) finding.suggest = suggest;
+  }
   return {
     ok: findings.length === 0,
     findings,
@@ -28166,10 +28179,10 @@ var rollout_plan_default = {
     note: "The v4.0.0 stamp happens at cut time (D6e #4463); until then the candidate is the origin/development head artifacts (built cli/dist + npm pack), identity proven by dist content hash (D6a)."
   },
   baseline: {
-    version: "4.6.25",
-    tag: "v4.6.25",
-    commit: "8ca2371aca5a",
-    npm: "@mutmutco/cli@4.6.25"
+    version: "4.6.26",
+    tag: "v4.6.26",
+    commit: "bab0b3157d41",
+    npm: "@mutmutco/cli@4.6.26"
   },
   exitCriterion: "fleet-n-of-n",
   hubOnlyShortcut: "forbidden",
@@ -28186,14 +28199,14 @@ var rollout_plan_default = {
           repo: "mutmutco/mmi-hub",
           role: "canary",
           schedule: "train",
-          v3Target: "v4.6.25"
+          v3Target: "v4.6.26"
         }
       ],
       rollbackTrigger: "Any red inside the post-contract soak window: `devops train gate` FAIL attributable to the v4 doors, Hub endpoint health probe failure, a pre-v4 client admitted instead of receiving actionable HTTP 426, or npm consumer install/doctor failure on the v4-only dist.",
       rollback: {
         independent: true,
-        mechanism: "npm dist-tag latest -> 4.6.25 and redeploy the Hub Lambda from tag v4.6.25 (8ca2371aca5a); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
-        v3Target: "v4.6.25 (@mutmutco/cli@4.6.25, tag commit 8ca2371aca5a \u2014 last known-good release carrying the repo-index v4-only contract)"
+        mechanism: "npm dist-tag latest -> 4.6.26 and redeploy the Hub Lambda from tag v4.6.26 (bab0b3157d41); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
+        v3Target: "v4.6.26 (@mutmutco/cli@4.6.26, tag commit bab0b3157d41 \u2014 last known-good release carrying the repo-index v4-only contract)"
       }
     },
     {
@@ -72535,7 +72548,7 @@ function registerDeveloperCommands(program3) {
         if (!result.ok) process.exitCode = 1;
         return;
       }
-      for (const w of result.warnings) console.warn(`WARNING: ${w.doc}:${w.line} [${w.kind}] ${w.detail}`);
+      for (const w of result.warnings) console.warn(`WARNING: ${formatDocRefFinding(w)}`);
       if (result.ok) {
         console.log(
           `doc refs: ${result.docCount} docs, every reference resolves` + (result.warnings.length ? ` (${result.warnings.length} warning(s))` : "")
@@ -72545,7 +72558,7 @@ function registerDeveloperCommands(program3) {
       const hasStale = result.findings.some((f) => f.kind === "runbook-section-stale" || f.kind === "seed-runbook-unreviewed");
       const hasRefs = result.findings.some((f) => f.kind !== "runbook-section-stale" && f.kind !== "seed-runbook-unreviewed");
       console.error(hasStale && !hasRefs ? "doc refs: stale runbook section(s)" : hasStale && hasRefs ? "doc refs: unresolved references and stale runbook section(s)" : "doc refs: unresolved references");
-      for (const f of result.findings) console.error(`- ${f.doc}:${f.line} [${f.kind}] ${f.detail}`);
+      for (const f of result.findings) console.error(`- ${formatDocRefFinding(f)}`);
       process.exitCode = 1;
     } catch (e) {
       await failGraceful(e.message);

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "4.6.25",
+  "version": "4.6.26",
   "description": "MMI Future CLI — the org dev toolbox and shared cross-IDE engine for every registry-declared MMI coding surface.",
   "type": "module",
   "license": "UNLICENSED",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/codex-plugin",
-  "version": "4.6.25",
+  "version": "4.6.26",
   "description": "MMI workflow skills and org gates delivery.",
   "author": {
     "name": "MMI Future",

package/skills/bootstrap/seeds/suite-guide.template.md

@@ -114,7 +114,11 @@ requests like this should follow this structure, not prose guide."
      Before building visual A/B boards, use front-loaded **Impeccable v4.7.0** alongside **21st.dev MCP**
      (`https://21st.dev/api/mcp`; verbatim owner ruling: `"we don't need the mcp better design yet,
      impeccable and 21st is enough"`, dropping Better Design MCP) to study high-craft reference patterns,
-     layout proportions, and interaction details. Always translate inspired patterns into zero-GPU
+     layout proportions, and interaction details. Actually query the 21st.dev MCP; in the Phase 0
+     handoff/A-B brief, report the queries issued and returned component/pattern names and IDs
+     (where provided). If unreachable, report the exact error; if empty, report "no results".
+     Neither case supports a 21st inspiration claim. Never describe patterns as 21st-inspired
+     without this query/result record. Always translate inspired patterns into zero-GPU
      `@mutmutco/mmwork-ds` tokens (`--card-blur: none`, `--card-tint-dark: 0%`, `--card-tint-light: 0%`,
      sleek translucent glass cards) and Atomic Design layers; never copy raw third-party CSS/HTML or
      GPU-heavy effects. `MM-Inspo` is strictly a customer/tenant module inside the MM-Work suite, never

package/skills/org-guide/references/design.md

@@ -285,7 +285,11 @@ requests like this should follow this structure, not prose guide."
      Before building visual A/B boards, use front-loaded **Impeccable v4.7.0** alongside **21st.dev MCP**
      (`https://21st.dev/api/mcp`; verbatim owner ruling: `"we don't need the mcp better design yet,
      impeccable and 21st is enough"`, dropping Better Design MCP) to study high-craft reference patterns,
-     layout proportions, and interaction details. Always translate inspired patterns into zero-GPU
+     layout proportions, and interaction details. Actually query the 21st.dev MCP; in the Phase 0
+     handoff/A-B brief, report the queries issued and returned component/pattern names and IDs
+     (where provided). If unreachable, report the exact error; if empty, report "no results".
+     Neither case supports a 21st inspiration claim. Never describe patterns as 21st-inspired
+     without this query/result record. Always translate inspired patterns into zero-GPU
      `@mutmutco/mmwork-ds` tokens (`--card-blur: none`, `--card-tint-dark: 0%`, `--card-tint-light: 0%`,
      sleek translucent glass cards) and Atomic Design layers; never copy raw third-party CSS/HTML or
      GPU-heavy effects. `MM-Inspo` is strictly a customer/tenant module inside the MM-Work suite, never