mewkit 1.10.3 → 1.10.4

package/dist/core/build-inventory.js

@@ -0,0 +1,222 @@
+import fs from "node:fs";
+import path from "node:path";
+import yaml from "js-yaml";
+/** Runtime/tooling dirs that are never harness artifacts. */
+const DENYLIST_DIRS = new Set([".venv", "__pycache__", "node_modules"]);
+const REQUIRED_FIELDS = ["owner", "criticality", "status", "runtime"];
+function listMarkdown(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir).filter((f) => f.endsWith(".md"));
+}
+/**
+ * The canonical "what counts" enumeration. Returns artifact references plus any
+ * structural anomalies (e.g. a skill subdir with no SKILL.md that is not a known
+ * runtime dir). Counting is presence-based; rules and rules-conditional are
+ * deliberately NOT merged — callers label them as separate buckets.
+ */
+export function enumerateArtifacts(claudeDir) {
+    const refs = [];
+    const issues = [];
+    // skills — subdirs containing SKILL.md
+    const skillsDir = path.join(claudeDir, "skills");
+    if (fs.existsSync(skillsDir)) {
+        for (const entry of fs.readdirSync(skillsDir)) {
+            if (DENYLIST_DIRS.has(entry))
+                continue;
+            const subdir = path.join(skillsDir, entry);
+            if (!fs.statSync(subdir).isDirectory())
+                continue;
+            const skillMd = path.join(subdir, "SKILL.md");
+            if (fs.existsSync(skillMd)) {
+                const fm = readFrontmatter(skillMd);
+                const id = typeof fm.name === "string" ? fm.name : entry;
+                refs.push({ type: "skill", rel: `skills/${entry}/SKILL.md`, abs: skillMd, id, metaSource: "frontmatter" });
+            }
+            else {
+                issues.push({ path: `skills/${entry}`, type: "unknown", problem: "skill directory has no SKILL.md (not a known runtime dir)" });
+            }
+        }
+    }
+    // agents — *.md excluding *_INDEX.md
+    const agentsDir = path.join(claudeDir, "agents");
+    for (const f of listMarkdown(agentsDir)) {
+        if (f.endsWith("_INDEX.md"))
+            continue;
+        refs.push({ type: "agent", rel: `agents/${f}`, abs: path.join(agentsDir, f), id: f.replace(/\.md$/, ""), metaSource: "frontmatter" });
+    }
+    // rules + rules-conditional — separate buckets, registry-sourced
+    for (const f of listMarkdown(path.join(claudeDir, "rules"))) {
+        refs.push({ type: "rule", rel: `rules/${f}`, abs: path.join(claudeDir, "rules", f), id: f.replace(/\.md$/, ""), metaSource: "registry" });
+    }
+    for (const f of listMarkdown(path.join(claudeDir, "rules-conditional"))) {
+        refs.push({ type: "rule", rel: `rules-conditional/${f}`, abs: path.join(claudeDir, "rules-conditional", f), id: f.replace(/\.md$/, ""), metaSource: "registry" });
+    }
+    // commands — commands/mk/*.md, registry-sourced
+    const cmdDir = path.join(claudeDir, "commands", "mk");
+    for (const f of listMarkdown(cmdDir)) {
+        refs.push({ type: "command", rel: `commands/mk/${f}`, abs: path.join(cmdDir, f), id: f.replace(/\.md$/, ""), metaSource: "registry" });
+    }
+    // hooks — isHookScript-true files, registry-sourced
+    const hooksDir = path.join(claudeDir, "hooks");
+    if (fs.existsSync(hooksDir)) {
+        for (const f of fs.readdirSync(hooksDir)) {
+            const abs = path.join(hooksDir, f);
+            if (!fs.statSync(abs).isFile())
+                continue;
+            if (!f.endsWith(".sh"))
+                continue; // top-level shell hooks are the counted set
+            refs.push({ type: "hook", rel: `hooks/${f}`, abs, id: f.replace(/\.sh$/, ""), metaSource: "registry" });
+        }
+    }
+    return { refs, issues };
+}
+/** Extract the YAML frontmatter block of a markdown file, or {} if none. */
+function readFrontmatter(abs) {
+    try {
+        const body = fs.readFileSync(abs, "utf-8");
+        const m = /^---\n([\s\S]*?)\n---/.exec(body);
+        if (!m)
+            return {};
+        const parsed = yaml.load(m[1]);
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** Read the central registry for rules/commands/hooks. */
+export function readRegistry(claudeDir) {
+    const regPath = path.join(claudeDir, "harness-inventory.json");
+    if (!fs.existsSync(regPath))
+        return {};
+    try {
+        const parsed = JSON.parse(fs.readFileSync(regPath, "utf-8"));
+        return parsed.artifacts ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+function str(v) {
+    return typeof v === "string" ? v : "";
+}
+/**
+ * Build the unified inventory. Each artifact's metadata comes from frontmatter
+ * (skills/agents) or the registry (rules/commands/hooks). Missing records and
+ * missing required fields are recorded as issues — never silently defaulted to
+ * a passing value.
+ */
+export function buildInventory(claudeDir) {
+    const { refs, issues } = enumerateArtifacts(claudeDir);
+    const registry = readRegistry(claudeDir);
+    const entries = [];
+    const allIssues = [...issues];
+    for (const ref of refs) {
+        const meta = ref.metaSource === "frontmatter" ? readFrontmatter(ref.abs) : registry[ref.rel] ?? {};
+        const hasRecord = ref.metaSource === "frontmatter" ? Object.keys(meta).length > 0 : ref.rel in registry;
+        if (!hasRecord) {
+            allIssues.push({ path: ref.rel, type: ref.type, problem: `no governance metadata (${ref.metaSource})` });
+        }
+        const entry = {
+            type: ref.type,
+            path: ref.rel,
+            id: ref.id,
+            owner: str(meta.owner),
+            criticality: str(meta.criticality),
+            status: str(meta.status),
+            runtime: str(meta.runtime),
+            source: ref.metaSource,
+        };
+        if (typeof meta.context_cost === "string")
+            entry.contextCost = meta.context_cost;
+        if (Array.isArray(meta.depends_on))
+            entry.dependsOn = meta.depends_on.map(String);
+        entries.push(entry);
+    }
+    // Registry keys that point at no enumerated artifact (stale registry entry).
+    const enumerated = new Set(refs.map((r) => r.rel));
+    for (const key of Object.keys(registry)) {
+        if (!enumerated.has(key)) {
+            allIssues.push({ path: key, type: "unknown", problem: "registry entry has no matching artifact on disk" });
+        }
+    }
+    return { entries, issues: allIssues };
+}
+/** Load the allowed-enum sets from the governance schema (single source). */
+export function loadSchemaEnums(claudeDir) {
+    const schemaPath = path.join(claudeDir, "schemas", "harness-metadata-schema.json");
+    if (!fs.existsSync(schemaPath))
+        return null;
+    try {
+        const schema = JSON.parse(fs.readFileSync(schemaPath, "utf-8"));
+        const props = schema.properties ?? {};
+        return {
+            owner: new Set(props.owner?.enum ?? []),
+            criticality: new Set(props.criticality?.enum ?? []),
+            status: new Set(props.status?.enum ?? []),
+            runtime: new Set(props.runtime?.enum ?? []),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Ownership-completeness validation. FAILS when any artifact lacks a metadata
+ * record, is missing a required field, or carries an out-of-enum value, or when
+ * a structural anomaly exists (unknown dir, stale registry entry). PASSES only
+ * when every discovered artifact is 100% covered with valid values.
+ */
+export function checkOwnership(claudeDir, opts = {}) {
+    // The governance schema is the install signal: absent ⇒ the metadata layer
+    // is not installed. In a non-scoped run that downgrades to WARN (prompt the
+    // upgrade); the scoped `--ownership` CI check keeps it a hard FAIL.
+    const schemaPath = path.join(claudeDir, "schemas", "harness-metadata-schema.json");
+    if (!fs.existsSync(schemaPath)) {
+        const status = opts.missingInfraSeverity ?? "fail";
+        const detail = status === "warn"
+            ? "Ownership metadata not installed (no harness-metadata-schema.json) — run `mewkit upgrade`"
+            : "Missing/unreadable .claude/schemas/harness-metadata-schema.json";
+        return [{ name: "Governance metadata installed", status, detail, section: "Ownership" }];
+    }
+    const enums = loadSchemaEnums(claudeDir);
+    if (!enums) {
+        return [{ name: "Governance schema loads", status: "fail", detail: "Unreadable .claude/schemas/harness-metadata-schema.json", section: "Ownership" }];
+    }
+    const { entries, issues } = buildInventory(claudeDir);
+    const results = [];
+    for (const issue of issues) {
+        results.push({ name: `Ownership: ${issue.path}`, status: "fail", detail: `${issue.type}: ${issue.problem}`, section: "Ownership" });
+    }
+    const enumOf = {
+        owner: enums.owner,
+        criticality: enums.criticality,
+        status: enums.status,
+        runtime: enums.runtime,
+    };
+    for (const e of entries) {
+        const problems = [];
+        for (const field of REQUIRED_FIELDS) {
+            const value = e[field];
+            if (!value) {
+                problems.push(`missing ${field}`);
+            }
+            else if (!enumOf[field].has(value)) {
+                problems.push(`${field}="${value}" not in enum`);
+            }
+        }
+        if (problems.length > 0) {
+            results.push({ name: `Ownership: ${e.path}`, status: "fail", detail: problems.join("; "), section: "Ownership" });
+        }
+    }
+    const failed = results.filter((r) => r.status === "fail").length;
+    results.push({
+        name: "Ownership coverage",
+        status: failed === 0 ? "pass" : "fail",
+        detail: failed === 0 ? `${entries.length} artifacts, 100% governance coverage` : `${failed} artifact(s) with missing/invalid metadata`,
+        section: "Ownership",
+    });
+    return results;
+}
+//# sourceMappingURL=build-inventory.js.map

package/dist/core/build-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-inventory.js","sourceRoot":"","sources":["../../src/core/build-inventory.ts"],"names":[],"mappings":"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"}

package/dist/core/check-packs.d.ts

@@ -0,0 +1,13 @@
+import type { CheckResult } from "../commands/validate.js";
+import type { Status } from "../commands/doctor-checks.js";
+/**
+ * Safety surface that MUST resolve into `base` for every profile — the Phase-1
+ * gate + privacy hooks, the dispatch chain, settings, statusline, and the always-on
+ * rules. Paths are exact (note `hooks/lib/...`); a missing one makes a profile
+ * shippable without enforcement, so each absence is a hard FAIL.
+ */
+export declare const SAFETY_PATHS: string[];
+export declare function checkPacks(claudeDir: string, opts?: {
+    missingInfraSeverity?: Status;
+}): CheckResult[];
+//# sourceMappingURL=check-packs.d.ts.map

package/dist/core/check-packs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-packs.d.ts","sourceRoot":"","sources":["../../src/core/check-packs.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,YAAY,UAqBxB,CAAC;AAKF,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,EAAE,CA4GzG"}

package/dist/core/check-packs.js

@@ -0,0 +1,131 @@
+// Static `validate --packs` coherence + safety check. Proves the pack manifest is
+// internally consistent (resolvable profiles, real override ids, resolvable
+// depends_on), that every governed artifact belongs to ≥1 pack or base, and — the
+// non-negotiable safety invariant — that base carries the full gate/privacy/dispatch
+// chain at its exact verified paths. Mirrors checkOwnership's quad-state pattern.
+import { buildInventory } from "./build-inventory.js";
+import { availablePacks, availableProfiles, BASE_PACK, flattenProfile, hasPackManifest, loadPackManifest, } from "./pack-manifest.js";
+import { resolvePacksDetailed } from "./pack-resolver.js";
+/**
+ * Safety surface that MUST resolve into `base` for every profile — the Phase-1
+ * gate + privacy hooks, the dispatch chain, settings, statusline, and the always-on
+ * rules. Paths are exact (note `hooks/lib/...`); a missing one makes a profile
+ * shippable without enforcement, so each absence is a hard FAIL.
+ */
+export const SAFETY_PATHS = [
+    "statusline.cjs",
+    "settings.json",
+    "hooks/gate-enforcement.sh",
+    "hooks/privacy-block.sh",
+    "hooks/pre-completion-check.sh",
+    "hooks/lib/read-hook-input.sh",
+    "hooks/lib/load-dotenv.sh",
+    "hooks/dispatch.cjs",
+    "hooks/lib/parse-stdin.cjs",
+    "hooks/lib/shared-state.cjs",
+    "hooks/handlers.json",
+    "rules/security-rules.md",
+    "rules/injection-rules.md",
+    "rules/gate-rules.md",
+    "rules/core-behaviors.md",
+    "rules/development-rules.md",
+    // essential cross-profile commands — a profile without these has no /mk:plan etc.
+    "commands/mk/plan.md",
+    "commands/mk/upgrade.md",
+    "commands/mk/validate.md",
+];
+const PASS = (name, detail) => ({ name, status: "pass", detail, section: "Packs" });
+const FAIL = (name, detail) => ({ name, status: "fail", detail, section: "Packs" });
+export function checkPacks(claudeDir, opts = {}) {
+    // Manifest absent ⇒ pack modularization not installed. Default run downgrades to
+    // WARN (prompt upgrade); scoped `--packs` keeps it a hard FAIL for CI.
+    if (!hasPackManifest(claudeDir)) {
+        const status = opts.missingInfraSeverity ?? "fail";
+        return [
+            {
+                name: "Pack manifest installed",
+                status,
+                detail: status === "warn"
+                    ? "No pack-manifest.json — pack modularization not installed; run `mewkit upgrade`"
+                    : "Missing .claude/pack-manifest.json",
+                section: "Packs",
+            },
+        ];
+    }
+    let manifest;
+    try {
+        manifest = loadPackManifest(claudeDir);
+    }
+    catch (err) {
+        return [FAIL("Pack manifest loads", err.message)];
+    }
+    const results = [];
+    // 1. Every profile flattens without an unknown ref or cycle.
+    for (const profile of availableProfiles(manifest)) {
+        try {
+            flattenProfile(manifest, profile);
+        }
+        catch (err) {
+            results.push(FAIL(`Profile resolves: ${profile}`, err.message));
+        }
+    }
+    const inv = buildInventory(claudeDir);
+    const invIds = new Set(inv.entries.map((e) => e.id));
+    // 2. Every artifactsAdd/Exclude id is a real artifact (catches phantom ids).
+    for (const [packName, def] of Object.entries(manifest.packs)) {
+        for (const id of [...(def.artifactsAdd ?? []), ...(def.artifactsExclude ?? [])]) {
+            if (!invIds.has(id)) {
+                results.push(FAIL(`Pack override id: ${packName}`, `references unknown artifact id "${id}"`));
+            }
+        }
+    }
+    // 3. Completeness: every governed artifact belongs to ≥1 pack OR base.
+    const coveredOwners = new Set();
+    const coveredAddIds = new Set();
+    for (const def of Object.values(manifest.packs)) {
+        for (const o of def.owners ?? [])
+            coveredOwners.add(o);
+        for (const id of def.artifactsAdd ?? [])
+            coveredAddIds.add(id);
+    }
+    let baseSet;
+    try {
+        baseSet = resolvePacksDetailed(claudeDir, manifest, []).packMembership.get(BASE_PACK) ?? new Set();
+    }
+    catch (err) {
+        return [...results, FAIL("Base resolves", err.message)];
+    }
+    const strays = inv.entries.filter((e) => !coveredOwners.has(e.owner) && !coveredAddIds.has(e.id) && !baseSet.has(e.path));
+    if (strays.length > 0) {
+        results.push(FAIL("Pack completeness", `${strays.length} artifact(s) in no pack/base: ${strays.slice(0, 8).map((e) => `${e.id}(${e.owner || "no-owner"})`).join(", ")}`));
+    }
+    // 4. Safety invariant: base carries every gate/privacy/dispatch path.
+    const missingSafety = SAFETY_PATHS.filter((p) => !baseSet.has(p));
+    if (missingSafety.length > 0) {
+        results.push(FAIL("Base safety invariant", `base missing required safety file(s): ${missingSafety.join(", ")}`));
+    }
+    // 5. depends_on resolvability + the empty-edges advisory.
+    let anyEdges = false;
+    for (const e of inv.entries) {
+        for (const dep of e.dependsOn ?? []) {
+            anyEdges = true;
+            if (!invIds.has(dep)) {
+                results.push(FAIL(`depends_on: ${e.id}`, `unresolvable dependency "${dep}"`));
+            }
+        }
+    }
+    if (!anyEdges && inv.entries.length > 0) {
+        results.push({
+            name: "depends_on edges",
+            status: "warn",
+            detail: `inventory has ${inv.entries.length} artifacts but no depends_on edges — closure is inert (future-proofing only)`,
+            section: "Packs",
+        });
+    }
+    const failed = results.filter((r) => r.status === "fail").length;
+    results.push(failed === 0
+        ? PASS("Pack coherence", `${availableProfiles(manifest).length} profiles, ${availablePacks(manifest).length} packs, ${inv.entries.length} artifacts — 100% covered`)
+        : FAIL("Pack coherence", `${failed} pack defect(s)`));
+    return results;
+}
+//# sourceMappingURL=check-packs.js.map

package/dist/core/check-packs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-packs.js","sourceRoot":"","sources":["../../src/core/check-packs.ts"],"names":[],"mappings":"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"}

package/dist/core/check-stale-index.d.ts

@@ -0,0 +1,35 @@
+import type { CheckResult } from "../commands/validate.js";
+/** A single declared-vs-actual count claim found in a doc. */
+export interface CountDiff {
+    source: string;
+    label: string;
+    declared: number;
+    actual: number;
+}
+/** A canonical count token: its file, a human label, the regex, and the truth. */
+interface CountSpec {
+    source: string;
+    label: string;
+    pattern: RegExp;
+    actual: number;
+}
+/** Build the list of count specifications anchored to each doc's real format. */
+export declare function countSpecs(repoRoot: string): CountSpec[];
+/** Parse declared counts and diff them against the inventory. */
+export declare function compareCounts(repoRoot: string): CountDiff[];
+/** Completeness: every artifact id must appear in its index file. */
+export declare function missingRows(repoRoot: string): {
+    source: string;
+    type: string;
+    missingIds: string[];
+}[];
+/** Full stale-index check → CheckResults under the "Inventory" section. */
+export declare function checkStaleIndex(repoRoot: string): CheckResult[];
+/**
+ * Rewrite ONLY the count number tokens in README + index headers to match the
+ * inventory. Curated index prose/rows are never touched. Returns the files it
+ * changed. Missing completeness rows are reported by the check, never auto-filled.
+ */
+export declare function emitCounts(repoRoot: string): string[];
+export {};
+//# sourceMappingURL=check-stale-index.d.ts.map

package/dist/core/check-stale-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-stale-index.d.ts","sourceRoot":"","sources":["../../src/core/check-stale-index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AA+B3D,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,kFAAkF;AAClF,UAAU,SAAS;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf;AAOD,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAaxD;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAkB3D;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAkBtG;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CA4B/D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAuBrD"}

package/dist/core/check-stale-index.js

@@ -0,0 +1,132 @@
+import fs from "node:fs";
+import path from "node:path";
+import { buildInventory } from "./build-inventory.js";
+function actualCounts(claudeDir) {
+    const { entries } = buildInventory(claudeDir);
+    const byType = (t) => entries.filter((e) => e.type === t);
+    const rules = byType("rule");
+    return {
+        skills: byType("skill"),
+        agents: byType("agent"),
+        commands: byType("command"),
+        rules: rules.filter((e) => e.path.startsWith("rules/")),
+        rulesConditional: rules.filter((e) => e.path.startsWith("rules-conditional/")),
+        hooks: byType("hook"),
+    };
+}
+function read(repoRoot, rel) {
+    const p = path.join(repoRoot, rel);
+    return fs.existsSync(p) ? fs.readFileSync(p, "utf-8") : "";
+}
+/** Build the list of count specifications anchored to each doc's real format. */
+export function countSpecs(repoRoot) {
+    const claudeDir = path.join(repoRoot, ".claude");
+    const a = actualCounts(claudeDir);
+    return [
+        { source: "README.md", label: "skills", pattern: /(\d+)\s+skills/g, actual: a.skills.length },
+        { source: "README.md", label: "agents", pattern: /(\d+)\s+(?:specialist\s+)?agents/g, actual: a.agents.length },
+        { source: "README.md", label: "commands", pattern: /(\d+)\s+(?:slash\s+)?commands/g, actual: a.commands.length },
+        { source: "README.md", label: "rules", pattern: /(\d+)\s+(?:enforcement\s+)?rules/g, actual: a.rules.length },
+        { source: "README.md", label: "hook scripts", pattern: /(\d+)\s+hook scripts/g, actual: a.hooks.length },
+        { source: ".claude/agents/SKILLS_INDEX.md", label: "skills total", pattern: /\*\*Total\*\*\|\*\*(\d+)\*\*/g, actual: a.skills.length },
+        { source: ".claude/agents/AGENTS_INDEX.md", label: "agents index header", pattern: /\[(\d+)\]\{agent_file/g, actual: a.agents.length },
+        { source: ".claude/hooks/HOOKS_INDEX.md", label: "shell hooks", pattern: /(\d+)\s+shell hook/g, actual: a.hooks.length },
+    ];
+}
+/** Parse declared counts and diff them against the inventory. */
+export function compareCounts(repoRoot) {
+    const diffs = [];
+    for (const spec of countSpecs(repoRoot)) {
+        const body = read(repoRoot, spec.source);
+        const matches = [...body.matchAll(spec.pattern)];
+        if (matches.length === 0) {
+            // A count token that cannot be found is itself a failure — never pass-on-no-match.
+            diffs.push({ source: spec.source, label: `${spec.label} (token not found)`, declared: -1, actual: spec.actual });
+            continue;
+        }
+        for (const m of matches) {
+            const declared = Number(m[1]);
+            if (declared !== spec.actual) {
+                diffs.push({ source: spec.source, label: spec.label, declared, actual: spec.actual });
+            }
+        }
+    }
+    return diffs;
+}
+/** Completeness: every artifact id must appear in its index file. */
+export function missingRows(repoRoot) {
+    const claudeDir = path.join(repoRoot, ".claude");
+    const a = actualCounts(claudeDir);
+    const out = [];
+    const skillsIndex = read(repoRoot, ".claude/agents/SKILLS_INDEX.md");
+    const missSkills = a.skills.filter((e) => !skillsIndex.includes(e.id)).map((e) => e.id);
+    if (missSkills.length > 0)
+        out.push({ source: ".claude/agents/SKILLS_INDEX.md", type: "skill", missingIds: missSkills });
+    const agentsIndex = read(repoRoot, ".claude/agents/AGENTS_INDEX.md");
+    const missAgents = a.agents.filter((e) => !agentsIndex.includes(e.id)).map((e) => e.id);
+    if (missAgents.length > 0)
+        out.push({ source: ".claude/agents/AGENTS_INDEX.md", type: "agent", missingIds: missAgents });
+    const hooksIndex = read(repoRoot, ".claude/hooks/HOOKS_INDEX.md");
+    const missHooks = a.hooks.filter((e) => !hooksIndex.includes(e.id)).map((e) => e.id);
+    if (missHooks.length > 0)
+        out.push({ source: ".claude/hooks/HOOKS_INDEX.md", type: "hook", missingIds: missHooks });
+    return out;
+}
+/** Full stale-index check → CheckResults under the "Inventory" section. */
+export function checkStaleIndex(repoRoot) {
+    const results = [];
+    const diffs = compareCounts(repoRoot);
+    for (const d of diffs) {
+        const declared = d.declared < 0 ? "not found" : String(d.declared);
+        results.push({
+            name: `Count drift: ${d.source} (${d.label})`,
+            status: "fail",
+            detail: `declared ${declared}, found ${d.actual}`,
+            section: "Inventory",
+        });
+    }
+    const missing = missingRows(repoRoot);
+    for (const m of missing) {
+        results.push({
+            name: `Index incomplete: ${m.source}`,
+            status: "fail",
+            detail: `${m.missingIds.length} ${m.type}(s) missing: ${m.missingIds.join(", ")}`,
+            section: "Inventory",
+        });
+    }
+    if (diffs.length === 0 && missing.length === 0) {
+        results.push({ name: "Index counts & completeness", status: "pass", detail: "README + index files match the inventory", section: "Inventory" });
+    }
+    return results;
+}
+/**
+ * Rewrite ONLY the count number tokens in README + index headers to match the
+ * inventory. Curated index prose/rows are never touched. Returns the files it
+ * changed. Missing completeness rows are reported by the check, never auto-filled.
+ */
+export function emitCounts(repoRoot) {
+    const changed = new Set();
+    // Group specs by source so each file is read/written once.
+    const bySource = new Map();
+    for (const spec of countSpecs(repoRoot)) {
+        const list = bySource.get(spec.source) ?? [];
+        list.push(spec);
+        bySource.set(spec.source, list);
+    }
+    for (const [source, specs] of bySource) {
+        const abs = path.join(repoRoot, source);
+        if (!fs.existsSync(abs))
+            continue;
+        const body = fs.readFileSync(abs, "utf-8");
+        let next = body;
+        for (const spec of specs) {
+            next = next.replace(spec.pattern, (full, num) => full.replace(num, String(spec.actual)));
+        }
+        if (next !== body) {
+            fs.writeFileSync(abs, next);
+            changed.add(source);
+        }
+    }
+    return [...changed];
+}
+//# sourceMappingURL=check-stale-index.js.map

package/dist/core/check-stale-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-stale-index.js","sourceRoot":"","sources":["../../src/core/check-stale-index.ts"],"names":[],"mappings":"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"}

package/dist/core/check-workflow-drift.d.ts

@@ -0,0 +1,49 @@
+import type { CheckResult } from "../commands/validate.js";
+import type { Status } from "../commands/doctor-checks.js";
+/** A single drift finding with enough context to locate and fix it. */
+export interface Violation {
+    file: string;
+    line: number;
+    found: string;
+    expected: string;
+}
+/** The canonical lifecycle, distilled from workflow.yaml into checkable sets. */
+export interface CanonicalSpec {
+    /** Every phase + substep name (Orient, Plan, ..., Simplify, Verify). */
+    phaseNames: Set<string>;
+    /** id (as written: "0".."6", "3.5", "3.6") → canonical name. */
+    nameById: Map<string, string>;
+    /** Integer phase ids that an `applies_to:` list must fully enumerate. */
+    integerPhaseIds: number[];
+    /** Gate id → its single required-output glob. */
+    gateOutput: Map<string, string>;
+    /** Canonical second path-segments under tasks/ that carry required outputs. */
+    outputDirs: Set<string>;
+    /** Reflect-phase canonical leads (all must co-occur where leads are listed). */
+    reflectLeads: string[];
+    /** Prose files to scan, relative to project root. */
+    sources: string[];
+}
+export declare class WorkflowSpecError extends Error {
+    readonly kind: "missing" | "unparseable" | "malformed";
+    /** "missing" = file absent (downgradable to WARN in a non-scoped run);
+     *  "unparseable"/"malformed" = present but broken (always a FAIL). */
+    constructor(message: string, kind?: "missing" | "unparseable" | "malformed");
+}
+/**
+ * Parse `.claude/workflow.yaml` into a CanonicalSpec. Throws WorkflowSpecError
+ * if the file is missing or unparseable — NEVER returns a degenerate "empty"
+ * spec that would let drift pass silently.
+ */
+export declare function loadWorkflowSpec(projectRoot: string): CanonicalSpec;
+/** Scan one prose file for tokens that contradict the canonical spec. */
+export declare function scanForViolations(spec: CanonicalSpec, projectRoot: string, relPath: string): Violation[];
+/**
+ * Run the full drift check. Returns CheckResults under the "Workflow" section:
+ * a hard FAIL if the spec can't load, a per-source PASS/FAIL otherwise, and a
+ * spec-level FAIL if any canonical phase name appears in NO source file.
+ */
+export declare function checkWorkflowDrift(projectRoot: string, opts?: {
+    missingSpecSeverity?: Status;
+}): CheckResult[];
+//# sourceMappingURL=check-workflow-drift.d.ts.map

package/dist/core/check-workflow-drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-workflow-drift.d.ts","sourceRoot":"","sources":["../../src/core/check-workflow-drift.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAgB3D,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC7B,wEAAwE;IACxE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,gEAAgE;IAChE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,yEAAyE;IACzE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iDAAiD;IACjD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,+EAA+E;IAC/E,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,gFAAgF;IAChF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qDAAqD;IACrD,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAK1C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW;IAJvD;0EACsE;gBAErE,OAAO,EAAE,MAAM,EACN,IAAI,GAAE,SAAS,GAAG,aAAa,GAAG,WAA2B;CAIvE;AAgCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA4DnE;AAQD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAkFxG;AAOD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,EAAE,CAgDlH"}