instar 1.3.472 → 1.3.474

package/dist/core/StandardEnforcementExtractor.d.ts

@@ -0,0 +1,44 @@
+/**
+ * StandardEnforcementExtractor — pull the structural enforcement references a
+ * constitutional standard NAMES in its prose (cartographer-conformance-audit spec #3,
+ * Part A).
+ *
+ * The constitution declares its own enforcement: nearly every article carries an
+ * `**In practice.**` / `**Applied through.**` line naming the mechanism that enforces
+ * it — a test ratchet (`tests/unit/no-silent-llm-fallback.test.ts`), a gate marker
+ * (`B16_UNVERIFIED_WALL` in `MessagingToneGate`), a route (`POST /spec/conformance-check`),
+ * a lint (`scripts/lint-*.js`), or a spec (`docs/specs/*.md`). This module extracts
+ * those references so the auditor can VERIFY each one actually resolves on disk.
+ *
+ * PURE — no I/O. It only recognizes enforcement-shaped tokens; verification (does the
+ * file/route/symbol actually exist?) is the auditor's job. Extraction is conservative:
+ * a reference is only pulled if it matches a known enforcement shape. Unmatched prose
+ * contributes nothing (→ the standard reads as having no NAMED guard, itself a signal).
+ *
+ * Provenance refs (`#NNN` PR/issue numbers) are deliberately NOT treated as enforcement
+ * — they record where a guard was built, not a live guard.
+ */
+import type { StandardArticle } from './StandardsRegistryParser.js';
+/** A single enforcement reference extracted from a standard's prose. */
+export interface EnforcementRef {
+    /** The reference token (a repo-relative path, a `METHOD /route`, or a symbol/marker). */
+    ref: string;
+    /** Which recognizer matched it. */
+    kind: 'file' | 'route' | 'marker';
+}
+export interface ExtractedRefs {
+    files: string[];
+    routes: string[];
+    markers: string[];
+}
+/**
+ * Extract enforcement references from a single article. Scans both `inPractice` and
+ * `appliedThrough` (the two prose lines that name enforcement). Pure + deterministic:
+ * same article in → same refs out, in stable (sorted) order.
+ */
+export declare function extractEnforcementRefs(article: StandardArticle): ExtractedRefs;
+/** Flatten an ExtractedRefs into a typed list (auditor convenience). */
+export declare function flattenRefs(refs: ExtractedRefs): EnforcementRef[];
+/** True if the article names ANY enforcement reference at all. */
+export declare function hasAnyRef(refs: ExtractedRefs): boolean;
+//# sourceMappingURL=StandardEnforcementExtractor.d.ts.map

package/dist/core/StandardEnforcementExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StandardEnforcementExtractor.d.ts","sourceRoot":"","sources":["../../src/core/StandardEnforcementExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA4CD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CA2B9E;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,EAAE,CAMjE;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAEtD"}

package/dist/core/StandardEnforcementExtractor.js

@@ -0,0 +1,98 @@
+/**
+ * StandardEnforcementExtractor — pull the structural enforcement references a
+ * constitutional standard NAMES in its prose (cartographer-conformance-audit spec #3,
+ * Part A).
+ *
+ * The constitution declares its own enforcement: nearly every article carries an
+ * `**In practice.**` / `**Applied through.**` line naming the mechanism that enforces
+ * it — a test ratchet (`tests/unit/no-silent-llm-fallback.test.ts`), a gate marker
+ * (`B16_UNVERIFIED_WALL` in `MessagingToneGate`), a route (`POST /spec/conformance-check`),
+ * a lint (`scripts/lint-*.js`), or a spec (`docs/specs/*.md`). This module extracts
+ * those references so the auditor can VERIFY each one actually resolves on disk.
+ *
+ * PURE — no I/O. It only recognizes enforcement-shaped tokens; verification (does the
+ * file/route/symbol actually exist?) is the auditor's job. Extraction is conservative:
+ * a reference is only pulled if it matches a known enforcement shape. Unmatched prose
+ * contributes nothing (→ the standard reads as having no NAMED guard, itself a signal).
+ *
+ * Provenance refs (`#NNN` PR/issue numbers) are deliberately NOT treated as enforcement
+ * — they record where a guard was built, not a live guard.
+ */
+// ── Recognizers (the prototype regexes, broadened) ──────────────────────────
+/**
+ * Backtick-fenced file paths with a known source/test/script/spec/config extension.
+ * Matches `scripts/lint-foo.js`, `tests/unit/x.test.ts`, `docs/specs/y.md`,
+ * `src/core/Z.ts`, `.instar/config.json`, a `.sh` hook. The leading char class
+ * tolerates a leading `.` (e.g. `.github/...`).
+ */
+const FILE_RE = /`([a-zA-Z0-9_./-]+\.(?:ts|js|mjs|cjs|md|json|sh))`/g;
+/** Backtick-fenced `METHOD /route` tokens (the route table shape). */
+const ROUTE_RE = /`(GET|POST|PUT|DELETE|PATCH)\s+(\/[a-zA-Z0-9/_:-]+)`/g;
+/**
+ * CONSTANT_CASE gate markers (e.g. `B16_UNVERIFIED_WALL`, `B17_FALSE_BLOCKER`).
+ * Requires at least one underscore so it doesn't sweep up ALL-CAPS prose words
+ * (`RLHF`, `CI`, `LLM`), while still catching the real gate-marker shape. Matched
+ * with OR without surrounding backticks (the registry uses both).
+ */
+const MARKER_RE = /\b([A-Z][A-Z0-9]{2,}_[A-Z0-9_]{2,})\b/g;
+/**
+ * Named class / symbol guards the registry cites in backticks but WITHOUT a file
+ * extension or method — `MessagingToneGate`, `IntelligenceRouter.failureSwap`,
+ * `FencedLease`, `UserManager`. PascalCase (optionally `.member`), ≥2 segments of
+ * casing so it isn't a bare lowercase word. Treated as a `marker` (a symbol the
+ * auditor greps src/** for).
+ */
+const SYMBOL_RE = /`([A-Z][a-zA-Z0-9]+(?:\.[a-zA-Z][a-zA-Z0-9]*)?)`/g;
+/** Prefixes that count as a real on-disk enforcement artifact (vs. arbitrary prose). */
+const ENFORCEMENT_PATH_PREFIXES = ['tests/', 'scripts/', 'src/', 'docs/', '.github/', '.instar/', '.husky/'];
+/** True if a path looks like an enforcement artifact (a guard we can verify on disk). */
+function isEnforcementPath(p) {
+    return ENFORCEMENT_PATH_PREFIXES.some((pre) => p.startsWith(pre));
+}
+function dedupe(xs) {
+    return [...new Set(xs)];
+}
+/**
+ * Extract enforcement references from a single article. Scans both `inPractice` and
+ * `appliedThrough` (the two prose lines that name enforcement). Pure + deterministic:
+ * same article in → same refs out, in stable (sorted) order.
+ */
+export function extractEnforcementRefs(article) {
+    const text = `${article.inPractice ?? ''}\n${article.appliedThrough ?? ''}`;
+    const files = [];
+    for (const m of text.matchAll(FILE_RE)) {
+        const p = m[1];
+        if (isEnforcementPath(p))
+            files.push(p);
+    }
+    const routes = [];
+    for (const m of text.matchAll(ROUTE_RE)) {
+        routes.push(`${m[1].toUpperCase()} ${m[2]}`);
+    }
+    const markers = [];
+    for (const m of text.matchAll(MARKER_RE))
+        markers.push(m[1]);
+    for (const m of text.matchAll(SYMBOL_RE)) {
+        // A `.member` symbol (IntelligenceRouter.failureSwap) → grep the base class name.
+        const base = m[1].split('.')[0];
+        markers.push(base);
+    }
+    return {
+        files: dedupe(files).sort(),
+        routes: dedupe(routes).sort(),
+        markers: dedupe(markers).sort(),
+    };
+}
+/** Flatten an ExtractedRefs into a typed list (auditor convenience). */
+export function flattenRefs(refs) {
+    return [
+        ...refs.files.map((ref) => ({ ref, kind: 'file' })),
+        ...refs.routes.map((ref) => ({ ref, kind: 'route' })),
+        ...refs.markers.map((ref) => ({ ref, kind: 'marker' })),
+    ];
+}
+/** True if the article names ANY enforcement reference at all. */
+export function hasAnyRef(refs) {
+    return refs.files.length > 0 || refs.routes.length > 0 || refs.markers.length > 0;
+}
+//# sourceMappingURL=StandardEnforcementExtractor.js.map

package/dist/core/StandardEnforcementExtractor.js.map

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

package/dist/core/StandardsEnforcementAuditor.d.ts

@@ -0,0 +1,78 @@
+/**
+ * StandardsEnforcementAuditor — the registry-wide enforcement-coverage audit
+ * (cartographer-conformance-audit spec #3, Parts B + C).
+ *
+ * For each constitutional standard in `docs/STANDARDS-REGISTRY.md`, it:
+ *   1. parses the article (StandardsRegistryParser),
+ *   2. extracts the enforcement references its prose NAMES (StandardEnforcementExtractor),
+ *   3. VERIFIES each reference resolves against the live repo — a file via
+ *      `fs.existsSync`, a route via a regex scan of `src/server/routes.ts`, a
+ *      symbol/marker via a bounded grep of `src/**`,
+ *   4. classifies the standard by its STRONGEST verified guard
+ *      (`ratchet` > `gate` > `lint` > `spec-only` > `documented-only` gap),
+ *   5. records DANGLING refs — a guard a standard names that no longer exists on
+ *      disk (a broken guarantee, the loudest signal).
+ *
+ * Deterministic + idempotent: two runs over an unchanged registry+repo produce a
+ * byte-identical report (refs are sorted; classifiedAt is omitted from the hashable
+ * core). A content-hash short-circuit (registry hash + a cheap repo-structure signal)
+ * skips recompute when nothing changed — the `docs-coverage.mjs` pattern.
+ *
+ * Observe-only, non-gating: it NEVER blocks anything. It produces a read-only
+ * coverage report. "Signal vs. Authority" — a gap is a signal to build a guard.
+ */
+export type EnforcementKind = 'ratchet' | 'gate' | 'lint' | 'spec-only' | 'documented-only';
+export interface VerifiedGuard {
+    /** The reference token (path / `METHOD /route` / symbol). */
+    ref: string;
+    /** Recognizer kind from extraction. */
+    kind: 'file' | 'route' | 'marker';
+    /** Did the reference resolve on disk / in the route table / in src? */
+    verified: boolean;
+    /** The classification weight this guard contributes (only when verified). */
+    guardKind?: Exclude<EnforcementKind, 'documented-only'>;
+}
+export interface StandardCoverage {
+    standard: string;
+    family: string;
+    enforcementKind: EnforcementKind;
+    guards: VerifiedGuard[];
+    /** Refs named in prose but NOT found on disk — broken guarantees (loud signal). */
+    danglingRefs: string[];
+    classifiedAt: string;
+}
+export interface CoverageSummary {
+    total: number;
+    byKind: Record<EnforcementKind, number>;
+    /** (ratchet + gate + lint) / total — the fraction of standards with a verified structural guard. */
+    enforcedRatio: number;
+    /** Names of `documented-only` standards (the gaps). */
+    gaps: string[];
+    /** Total dangling refs across all standards. */
+    danglingCount: number;
+}
+export interface CoverageReport {
+    generatedAt: string;
+    /** Hash of the inputs (registry content + repo-structure signal) — drives the short-circuit. */
+    inputHash: string;
+    standards: StandardCoverage[];
+    summary: CoverageSummary;
+}
+export interface AuditorOptions {
+    /** Path to docs/STANDARDS-REGISTRY.md. */
+    registryPath: string;
+    /** Repo root — all refs resolve relative to this. */
+    projectDir: string;
+}
+/** Compute the input hash that drives the recompute short-circuit. */
+export declare function computeInputHash(opts: AuditorOptions): string;
+/**
+ * Compute the full enforcement-coverage report. Deterministic: the per-standard order
+ * follows the registry parse order; refs within a standard are sorted; the only
+ * non-deterministic field is `generatedAt`/`classifiedAt` (a timestamp, excluded from
+ * `inputHash`). Pass `prior` to short-circuit when the input hash is unchanged.
+ */
+export declare function computeCoverage(opts: AuditorOptions, prior?: CoverageReport | null): CoverageReport;
+/** A stable, timestamp-free view used to assert determinism (two runs → identical). */
+export declare function stableView(report: CoverageReport): unknown;
+//# sourceMappingURL=StandardsEnforcementAuditor.d.ts.map

package/dist/core/StandardsEnforcementAuditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StandardsEnforcementAuditor.d.ts","sourceRoot":"","sources":["../../src/core/StandardsEnforcementAuditor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAQH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAE5F,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClC,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,mFAAmF;IACnF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACxC,oGAAoG;IACpG,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;CACpB;AAiKD,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAK7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,GAC5B,cAAc,CA0ChB;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAY1D"}

package/dist/core/StandardsEnforcementAuditor.js

@@ -0,0 +1,295 @@
+/**
+ * StandardsEnforcementAuditor — the registry-wide enforcement-coverage audit
+ * (cartographer-conformance-audit spec #3, Parts B + C).
+ *
+ * For each constitutional standard in `docs/STANDARDS-REGISTRY.md`, it:
+ *   1. parses the article (StandardsRegistryParser),
+ *   2. extracts the enforcement references its prose NAMES (StandardEnforcementExtractor),
+ *   3. VERIFIES each reference resolves against the live repo — a file via
+ *      `fs.existsSync`, a route via a regex scan of `src/server/routes.ts`, a
+ *      symbol/marker via a bounded grep of `src/**`,
+ *   4. classifies the standard by its STRONGEST verified guard
+ *      (`ratchet` > `gate` > `lint` > `spec-only` > `documented-only` gap),
+ *   5. records DANGLING refs — a guard a standard names that no longer exists on
+ *      disk (a broken guarantee, the loudest signal).
+ *
+ * Deterministic + idempotent: two runs over an unchanged registry+repo produce a
+ * byte-identical report (refs are sorted; classifiedAt is omitted from the hashable
+ * core). A content-hash short-circuit (registry hash + a cheap repo-structure signal)
+ * skips recompute when nothing changed — the `docs-coverage.mjs` pattern.
+ *
+ * Observe-only, non-gating: it NEVER blocks anything. It produces a read-only
+ * coverage report. "Signal vs. Authority" — a gap is a signal to build a guard.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { loadStandardsRegistry } from './StandardsRegistryParser.js';
+import { extractEnforcementRefs, flattenRefs } from './StandardEnforcementExtractor.js';
+const KIND_RANK = {
+    ratchet: 4, gate: 3, lint: 2, 'spec-only': 1,
+};
+/** Classify a VERIFIED file ref into its guard weight. */
+function classifyFileGuard(ref) {
+    const base = ref.split('/').pop() ?? ref;
+    // Ratchet: a CI test that fails on regression — `*.test.ts`, a `no-*` guard, a
+    // `*-coverage` script.
+    if (/\.test\.(ts|js|mjs)$/.test(base) || base.startsWith('no-') || /-coverage\.(mjs|js)$/.test(base)) {
+        return 'ratchet';
+    }
+    // Lint: a `scripts/lint-*` static check.
+    if (ref.startsWith('scripts/') && base.startsWith('lint-'))
+        return 'lint';
+    // Gate: a precommit/husky hook, or a server/source guard file (a hook script, a
+    // gate module under src/). `.husky/*` and `scripts/*-precommit*` count as gates.
+    if (ref.startsWith('.husky/') || /precommit/i.test(base))
+        return 'gate';
+    if (ref.startsWith('scripts/'))
+        return 'lint'; // a generic script guard → lint-strength
+    // A docs/specs/* reference designed-but-maybe-unenforced → spec-only.
+    if (ref.startsWith('docs/specs/'))
+        return 'spec-only';
+    if (ref.startsWith('docs/'))
+        return 'spec-only';
+    // A src/** guard file (a gate/marker module) → gate-strength.
+    if (ref.startsWith('src/'))
+        return 'gate';
+    return 'spec-only';
+}
+/**
+ * Build a regex-scannable route token set from the server route files. Routes are
+ * registered across `routes.ts` AND several sibling `*Routes.ts` modules
+ * (specReviewRoutes, machineRoutes, usherRoutes, …); scanning only routes.ts would
+ * report a route registered elsewhere as a (false) dangling ref. We scan every
+ * `*.ts` under `src/server/` for the `router.<verb>('…')` pattern.
+ */
+function loadRouteTable(projectDir) {
+    const serverDir = path.join(projectDir, 'src', 'server');
+    const out = new Set();
+    let files;
+    try {
+        files = fs.readdirSync(serverDir).filter((f) => f.endsWith('.ts') && !f.endsWith('.test.ts'));
+    }
+    catch {
+        return out;
+    }
+    const re = /router\.(get|post|put|delete|patch)\s*\(\s*['"`]([^'"`]+)['"`]/g;
+    for (const f of files) {
+        let content;
+        try {
+            content = fs.readFileSync(path.join(serverDir, f), 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        for (const m of content.matchAll(re))
+            out.add(`${m[1].toUpperCase()} ${m[2]}`);
+    }
+    return out;
+}
+/**
+ * Bounded grep for a symbol across src/** — returns the set of all symbols found so a
+ * batch of marker refs is resolved in ONE walk (not one walk per ref). Skips test
+ * files and node_modules; caps total bytes read for safety.
+ */
+function buildSymbolIndex(projectDir, wanted) {
+    const found = new Set();
+    if (wanted.size === 0)
+        return found;
+    const srcDir = path.join(projectDir, 'src');
+    let exists = false;
+    try {
+        exists = fs.statSync(srcDir).isDirectory();
+    }
+    catch {
+        exists = false;
+    }
+    if (!exists)
+        return found;
+    const MAX_TOTAL_BYTES = 64 * 1024 * 1024;
+    let readBytes = 0;
+    // Pre-compile a single alternation regex over the wanted symbols (word-bounded).
+    const escaped = [...wanted].map((s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+    const re = new RegExp(`\\b(${escaped.join('|')})\\b`, 'g');
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (found.size === wanted.size)
+                return; // all resolved — stop early
+            const full = path.join(dir, e.name);
+            if (e.isDirectory()) {
+                if (e.name === 'node_modules' || e.name.startsWith('.'))
+                    continue;
+                walk(full);
+            }
+            else if (/\.(ts|js|mjs|cjs)$/.test(e.name)) {
+                if (readBytes > MAX_TOTAL_BYTES)
+                    return;
+                let content;
+                try {
+                    content = fs.readFileSync(full, 'utf-8');
+                }
+                catch {
+                    continue;
+                }
+                readBytes += content.length;
+                for (const m of content.matchAll(re))
+                    found.add(m[1]);
+            }
+        }
+    };
+    walk(srcDir);
+    return found;
+}
+/** Verify each ref of an article against the prepared lookups. */
+function verifyRefs(refs, projectDir, routeTable, symbolIndex) {
+    return refs.map((r) => {
+        let verified = false;
+        if (r.kind === 'file') {
+            // An fs.existsSync that throws (a malformed path, an EACCES) means the referenced
+            // guard is NOT resolvable on disk — which IS the correct, complete answer here
+            // (verified=false → the standard reads as having a dangling ref, the loud signal
+            // this auditor exists to surface). Not a degradation.
+            try {
+                verified = fs.existsSync(path.join(projectDir, r.ref));
+            }
+            catch {
+                verified = false; /* @silent-fallback-ok — unresolvable path = a real dangling-ref finding, not a degraded result */
+            }
+        }
+        else if (r.kind === 'route') {
+            verified = routeTable.has(r.ref);
+        }
+        else {
+            verified = symbolIndex.has(r.ref);
+        }
+        const g = { ref: r.ref, kind: r.kind, verified };
+        if (verified) {
+            g.guardKind = r.kind === 'file' ? classifyFileGuard(r.ref) : 'gate'; // route/marker → gate-strength
+        }
+        return g;
+    });
+}
+/** Classify a standard by its strongest VERIFIED guard. */
+function classifyStandard(guards) {
+    let best = null;
+    for (const g of guards) {
+        if (!g.verified || !g.guardKind)
+            continue;
+        if (best === null || KIND_RANK[g.guardKind] > KIND_RANK[best])
+            best = g.guardKind;
+    }
+    return best ?? 'documented-only';
+}
+/**
+ * A cheap repo-structure signal for the short-circuit: a hash over the sorted mtimes
+ * + sizes of the directories whose contents the audit reads (the route table source
+ * and the top-level src/scripts/tests/docs/.husky trees' immediate listings). Cheap,
+ * deterministic on an unchanged tree, and changes when a referenced guard file is
+ * added/removed.
+ */
+function repoStructureSignal(projectDir) {
+    const hash = crypto.createHash('sha256');
+    const probe = (rel) => {
+        const full = path.join(projectDir, rel);
+        try {
+            const st = fs.statSync(full);
+            if (st.isDirectory()) {
+                const names = fs.readdirSync(full).sort();
+                hash.update(`${rel}:${names.join(',')}\n`);
+            }
+            else {
+                hash.update(`${rel}:${st.size}:${Math.floor(st.mtimeMs)}\n`);
+            }
+        }
+        catch {
+            hash.update(`${rel}:absent\n`);
+        }
+    };
+    for (const p of [
+        'src', 'src/server', 'scripts', 'tests', 'tests/unit', 'docs', 'docs/specs', '.husky',
+        'src/server/routes.ts',
+    ])
+        probe(p);
+    return hash.digest('hex').slice(0, 16);
+}
+/** Compute the input hash that drives the recompute short-circuit. */
+export function computeInputHash(opts) {
+    let registry = '';
+    try {
+        registry = fs.readFileSync(opts.registryPath, 'utf-8');
+    }
+    catch {
+        registry = '';
+    }
+    const regHash = crypto.createHash('sha256').update(registry).digest('hex').slice(0, 16);
+    return `${regHash}.${repoStructureSignal(opts.projectDir)}`;
+}
+/**
+ * Compute the full enforcement-coverage report. Deterministic: the per-standard order
+ * follows the registry parse order; refs within a standard are sorted; the only
+ * non-deterministic field is `generatedAt`/`classifiedAt` (a timestamp, excluded from
+ * `inputHash`). Pass `prior` to short-circuit when the input hash is unchanged.
+ */
+export function computeCoverage(opts, prior) {
+    const inputHash = computeInputHash(opts);
+    if (prior && prior.inputHash === inputHash) {
+        // Inputs unchanged → the deterministic report is byte-identical to the prior;
+        // return it (only its timestamp would differ on recompute). The short-circuit.
+        return prior;
+    }
+    const articles = loadStandardsRegistry(opts.registryPath);
+    const routeTable = loadRouteTable(opts.projectDir);
+    // Collect every wanted marker across all articles → ONE bounded src walk.
+    const extracted = articles.map((a) => ({ a, refs: extractEnforcementRefs(a) }));
+    const wantedMarkers = new Set();
+    for (const { refs } of extracted)
+        for (const m of refs.markers)
+            wantedMarkers.add(m);
+    const symbolIndex = buildSymbolIndex(opts.projectDir, wantedMarkers);
+    const classifiedAt = new Date().toISOString();
+    const standards = extracted.map(({ a, refs }) => {
+        const flat = flattenRefs(refs);
+        const guards = verifyRefs(flat, opts.projectDir, routeTable, symbolIndex);
+        const enforcementKind = classifyStandard(guards);
+        const danglingRefs = guards.filter((g) => !g.verified).map((g) => g.ref).sort();
+        return { standard: a.name, family: a.family, enforcementKind, guards, danglingRefs, classifiedAt };
+    });
+    const byKind = {
+        ratchet: 0, gate: 0, lint: 0, 'spec-only': 0, 'documented-only': 0,
+    };
+    for (const s of standards)
+        byKind[s.enforcementKind] += 1;
+    const total = standards.length;
+    const enforced = byKind.ratchet + byKind.gate + byKind.lint;
+    const enforcedRatio = total === 0 ? 0 : Number((enforced / total).toFixed(4));
+    const gaps = standards.filter((s) => s.enforcementKind === 'documented-only').map((s) => s.standard);
+    const danglingCount = standards.reduce((n, s) => n + s.danglingRefs.length, 0);
+    return {
+        generatedAt: classifiedAt,
+        inputHash,
+        standards,
+        summary: { total, byKind, enforcedRatio, gaps, danglingCount },
+    };
+}
+/** A stable, timestamp-free view used to assert determinism (two runs → identical). */
+export function stableView(report) {
+    return {
+        inputHash: report.inputHash,
+        standards: report.standards.map((s) => ({
+            standard: s.standard,
+            family: s.family,
+            enforcementKind: s.enforcementKind,
+            guards: s.guards.map((g) => ({ ref: g.ref, kind: g.kind, verified: g.verified, guardKind: g.guardKind ?? null })),
+            danglingRefs: s.danglingRefs,
+        })),
+        summary: report.summary,
+    };
+}
+//# sourceMappingURL=StandardsEnforcementAuditor.js.map

package/dist/core/StandardsEnforcementAuditor.js.map

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

package/dist/core/StandardsRegistryParser.d.ts

@@ -24,6 +24,13 @@ export interface StandardArticle {
     rule: string;
     /** The `**In practice.**` line, when present. */
     inPractice: string;
+    /**
+     * The `**Applied through.**` line, when present — names the structural guard(s)
+     * that enforce the article (a test, lint, gate marker, route, or spec). Additive
+     * field (cartographer-conformance-audit spec #3); the enforcement-coverage audit
+     * scans `inPractice` + `appliedThrough` for verifiable enforcement references.
+     */
+    appliedThrough?: string;
 }
 /**
  * Parse the registry markdown into standards articles. Pure function — no I/O —

package/dist/core/StandardsRegistryParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StandardsRegistryParser.d.ts","sourceRoot":"","sources":["../../src/core/StandardsRegistryParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,WAAW,eAAe;IAC9B,2GAA2G;IAC3G,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB;AAkBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CA2C1E;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,EAAE,CAG7E;AAID,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAM5C,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,oBAAoB,CAWnF"}
+{"version":3,"file":"StandardsRegistryParser.d.ts","sourceRoot":"","sources":["../../src/core/StandardsRegistryParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,WAAW,eAAe;IAC9B,2GAA2G;IAC3G,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAkBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CA+C1E;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,EAAE,CAG7E;AAID,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAM5C,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,oBAAoB,CAWnF"}

package/dist/core/StandardsRegistryParser.js

@@ -78,6 +78,13 @@ export function parseStandardsRegistry(markdown) {
             cur.inPractice = inPractice;
             continue;
         }
+        // Additive (spec #3): capture the `**Applied through.**` line if present. Same
+        // `fieldAfter` extraction as Rule/In practice; absent on articles without one.
+        const appliedThrough = fieldAfter(line, 'Applied through');
+        if (appliedThrough !== null) {
+            cur.appliedThrough = appliedThrough;
+            continue;
+        }
     }
     flush();
     return articles;

package/dist/core/StandardsRegistryParser.js.map

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

package/dist/core/componentCategories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"componentCategories.d.ts","sourceRoot":"","sources":["../../src/core/componentCategories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,OAAO,CAAC;AAEpF,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,iBAAiB,CAEjE,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,iBAAiB,CAEtE;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CA+C1E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAIrF;AAED,gGAAgG;AAChG,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C"}
+{"version":3,"file":"componentCategories.d.ts","sourceRoot":"","sources":["../../src/core/componentCategories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,OAAO,CAAC;AAEpF,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,iBAAiB,CAEjE,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,iBAAiB,CAEtE;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAqD1E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAIrF;AAED,gGAAgG;AAChG,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C"}

package/dist/core/componentCategories.js

@@ -72,6 +72,12 @@ export const COMPONENT_CATEGORY = {
     // this registration guards the categoryForComponent path so a missing entry
     // fails the wiring test rather than silently routing to the default framework.
     CartographerSweep: 'job',
+    // The OPTIONAL dark LLM-enrichment path of the standards enforcement-coverage
+    // audit (cartographer-conformance-audit spec #3). Category 'job' so an operator
+    // can route it OFF Claude via sessions.componentFrameworks.categories.job — the
+    // enrichment then never spends Anthropic quota. Only used by the dark
+    // llmEnrichment path; the shipped deterministic auditor makes no LLM calls.
+    StandardsCoverageEnrichment: 'job',
 };
 /**
  * Resolve a component's category. Strips a trailing "/segment" call-site suffix

package/dist/core/componentCategories.js.map

@@ -1 +1 @@
-{"version":3,"file":"componentCategories.js","sourceRoot":"","sources":["../../src/core/componentCategories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAqC;IACpE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO;CAChD,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,CAAU;IAC5C,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,oBAA0C,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgD;IAC7E,uEAAuE;IACvE,aAAa,EAAE,UAAU;IACzB,UAAU,EAAE,UAAU;IACtB,uBAAuB,EAAE,UAAU;IACnC,gBAAgB,EAAE,UAAU;IAC5B,kBAAkB,EAAE,UAAU;IAC9B,aAAa,EAAE,UAAU;IACzB,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,UAAU;IAC3B,mBAAmB,EAAE,UAAU;IAC/B,wBAAwB,EAAE,UAAU;IACpC,mBAAmB,EAAE,UAAU;IAC/B,eAAe,EAAE,UAAU;IAC3B,mBAAmB,EAAE,UAAU;IAE/B,iDAAiD;IACjD,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE,MAAM;IACpB,eAAe,EAAE,MAAM;IACvB,qBAAqB,EAAE,MAAM;IAC7B,iBAAiB,EAAE,MAAM;IACzB,mBAAmB,EAAE,MAAM;IAC3B,aAAa,EAAE,MAAM;IACrB,iBAAiB,EAAE,MAAM;IACzB,iBAAiB,EAAE,MAAM;IAEzB,gEAAgE;IAChE,YAAY,EAAE,WAAW;IACzB,kBAAkB,EAAE,WAAW;IAC/B,iBAAiB,EAAE,WAAW;IAC9B,UAAU,EAAE,WAAW;IACvB,eAAe,EAAE,WAAW;IAC5B,mBAAmB,EAAE,WAAW;IAChC,mBAAmB,EAAE,WAAW;IAChC,4BAA4B,EAAE,WAAW;IACzC,kBAAkB,EAAE,WAAW;IAE/B,8BAA8B;IAC9B,kBAAkB,EAAE,KAAK;IACzB,8EAA8E;IAC9E,4EAA4E;IAC5E,8EAA8E;IAC9E,4EAA4E;IAC5E,4EAA4E;IAC5E,+EAA+E;IAC/E,iBAAiB,EAAE,KAAK;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA6B;IAChE,IAAI,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC;IAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;AAC7C,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC"}
+{"version":3,"file":"componentCategories.js","sourceRoot":"","sources":["../../src/core/componentCategories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAqC;IACpE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO;CAChD,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,CAAU;IAC5C,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,oBAA0C,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgD;IAC7E,uEAAuE;IACvE,aAAa,EAAE,UAAU;IACzB,UAAU,EAAE,UAAU;IACtB,uBAAuB,EAAE,UAAU;IACnC,gBAAgB,EAAE,UAAU;IAC5B,kBAAkB,EAAE,UAAU;IAC9B,aAAa,EAAE,UAAU;IACzB,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,UAAU;IAC3B,mBAAmB,EAAE,UAAU;IAC/B,wBAAwB,EAAE,UAAU;IACpC,mBAAmB,EAAE,UAAU;IAC/B,eAAe,EAAE,UAAU;IAC3B,mBAAmB,EAAE,UAAU;IAE/B,iDAAiD;IACjD,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE,MAAM;IACpB,eAAe,EAAE,MAAM;IACvB,qBAAqB,EAAE,MAAM;IAC7B,iBAAiB,EAAE,MAAM;IACzB,mBAAmB,EAAE,MAAM;IAC3B,aAAa,EAAE,MAAM;IACrB,iBAAiB,EAAE,MAAM;IACzB,iBAAiB,EAAE,MAAM;IAEzB,gEAAgE;IAChE,YAAY,EAAE,WAAW;IACzB,kBAAkB,EAAE,WAAW;IAC/B,iBAAiB,EAAE,WAAW;IAC9B,UAAU,EAAE,WAAW;IACvB,eAAe,EAAE,WAAW;IAC5B,mBAAmB,EAAE,WAAW;IAChC,mBAAmB,EAAE,WAAW;IAChC,4BAA4B,EAAE,WAAW;IACzC,kBAAkB,EAAE,WAAW;IAE/B,8BAA8B;IAC9B,kBAAkB,EAAE,KAAK;IACzB,8EAA8E;IAC9E,4EAA4E;IAC5E,8EAA8E;IAC9E,4EAA4E;IAC5E,4EAA4E;IAC5E,+EAA+E;IAC/E,iBAAiB,EAAE,KAAK;IACxB,8EAA8E;IAC9E,gFAAgF;IAChF,gFAAgF;IAChF,sEAAsE;IACtE,4EAA4E;IAC5E,2BAA2B,EAAE,KAAK;CACnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA6B;IAChE,IAAI,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC;IAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;AAC7C,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC"}