@cluesmith/codev 3.2.4 → 3.3.0

package/dist/lib/prompt-behavior-metrics.d.ts

@@ -0,0 +1,67 @@
+export interface ScarHit {
+    rule: string;
+    file: string;
+    line: number;
+    excerpt: string;
+}
+export interface BehaviorMetrics {
+    /** B1 — share of all CMAP verdicts that are REQUEST_CHANGES. */
+    b1_requestChangesRate: number;
+    b1_verdictCounts: Record<string, number>;
+    b1_totalVerdicts: number;
+    /** B2 — review rounds per plan phase: max(iteration) per plan_phase. */
+    b2_roundsPerPhaseMean: number;
+    b2_roundsPerPhaseMedian: number;
+    b2_roundsPerPhaseMax: number;
+    b2_phaseCount: number;
+    /** B3 — candidate scar-rule violations (REQUIRES HUMAN ADJUDICATION). */
+    b3_candidateHits: ScarHit[];
+    b3_filesScanned: number;
+    /** B4 — review rounds per project. */
+    b4_roundsPerProjectMean: number;
+    b4_roundsPerProjectMedian: number;
+    b4_projectCount: number;
+    /** Sample provenance. */
+    sampleProjects: string[];
+}
+export interface MeasureOptions {
+    /**
+     * Project directory names to exclude from B1/B2/B4.
+     *
+     * The baseline is defined as the PRE-PROJECT state (spec 1252, M12): the
+     * project doing the measuring must not contaminate its own baseline. Its
+     * review verdicts accumulate in its status.yaml *while it runs*, so an
+     * unexcluded rerun mid-project would drift from the committed artifact —
+     * which is exactly how this option came to exist (the Phase-1 reproduction
+     * test failed the moment this project's own iter-1 review landed).
+     */
+    excludeProjects?: string[];
+    /**
+     * Project directory names to measure EXCLUSIVELY (an allowlist), applied
+     * before `excludeProjects`. Unset means "every project on disk".
+     *
+     * A frozen baseline needs a frozen sample: the committed baseline artifact
+     * was computed over the projects that existed at baseline time, so a
+     * reproduction against live history must pin that set — otherwise every
+     * subsequent project that runs consultations perturbs the numbers and the
+     * reproduction fails for reasons that have nothing to do with the metrics
+     * (discovered when project 1286's first review iteration moved B1 160 → 163).
+     */
+    includeProjects?: string[];
+    /**
+     * Basename prefixes excluded from B3's prose scan, for the same reason: this
+     * project's own thread/review discuss scar rules at length and grow with
+     * every phase, so scanning them makes B3 non-reproducible AND self-inflating.
+     */
+    excludeFilePrefixes?: string[];
+}
+/** This project's own artifacts — excluded from its own baseline by default. */
+export declare const SELF_PROJECT_DIR = "1252-prompt-architecture-single-own";
+export declare const SELF_FILE_PREFIXES: string[];
+/** Collect all behavioural metrics for a repo root. Deterministic over B1–B4. */
+export declare function measureBehavior(root: string, opts?: MeasureOptions): BehaviorMetrics;
+/** Render metrics as the committed markdown baseline artifact. */
+export declare function render(m: BehaviorMetrics): string;
+/** CLI entry, invoked by `packages/codev/scripts/measure-prompt-behavior.ts`. */
+export declare function runCli(argv: string[], cwd: string): string;
+//# sourceMappingURL=prompt-behavior-metrics.d.ts.map

package/dist/lib/prompt-behavior-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-behavior-metrics.d.ts","sourceRoot":"","sources":["../../src/lib/prompt-behavior-metrics.ts"],"names":[],"mappings":"AAoEA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAiKD,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,wCAAwC,CAAC;AACtE,eAAO,MAAM,kBAAkB,UAA0B,CAAC;AAE1D,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,eAAe,CAkBxF;AAMD,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CA2EjD;AAED,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK1D"}

package/dist/lib/prompt-behavior-metrics.js

@@ -0,0 +1,290 @@
+/**
+ * prompt-behavior-metrics.ts — behavioural-impact measurement of prompt changes.
+ * Spec 1252, criterion M12 / Appendix D / test T14.
+ *
+ * Lives in `src/lib/` beside `protocol-drift-audit.ts` and
+ * `framework-ref-audit.ts` — same module shape (a measurement library, unit
+ * tested), and it needs this package's `js-yaml` dependency, which a root-level
+ * `scripts/` file cannot resolve in this pnpm workspace. The runnable entry
+ * point is `packages/codev/scripts/measure-prompt-behavior.ts`.
+ *
+ * ## Why this exists
+ *
+ * M6 counts words. A word reduction that degrades agent compliance is a loss,
+ * and word counts cannot see that. This script measures BEHAVIOUR: how often
+ * reviewers demand changes, how many rounds phases take, and whether scar rules
+ * are being violated.
+ *
+ * Run at Phase 1 (before any prompt content changes) to produce the baseline,
+ * and again in the post-merge verify phase to compare.
+ *
+ * ## What is deliberately NOT measured, and why
+ *
+ * Two metrics were requested and cannot be delivered from committed history.
+ * They are omitted rather than faked, because a plausible-looking zero is worse
+ * than an absent metric:
+ *
+ *   - GATE REJECTION COUNTS. Across all projects, a gate's `status` only ever
+ *     takes `approved | complete | in_progress | pending` — there is no
+ *     `rejected` state — and `requested_at` is a scalar that a re-request
+ *     OVERWRITES rather than appends to. A rejected-then-approved gate is
+ *     indistinguishable from a clean first-time approval. (Making this minable
+ *     would need porch to append gate events; out of scope here.)
+ *
+ *   - HISTORICAL CONSULT TOKENS/COST. Raw consult logs (`codev/projects/*​/*.txt`)
+ *     are gitignored, and `consult stats` is a rolling 30-day machine-local DB.
+ *     There is no historical series to baseline against, so B5 is captured as a
+ *     FORWARD snapshot only — advisory, non-deterministic, and excluded from
+ *     T14's determinism assertion and from every rollback trigger.
+ *
+ * Usage (from packages/codev):
+ *   npx tsx scripts/measure-prompt-behavior.ts [repo-root]
+ *   npx tsx scripts/measure-prompt-behavior.ts --json
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as yaml from 'js-yaml';
+// ---------------------------------------------------------------------------
+// The eight ratified scar rules (decision D3) and their violation markers.
+//
+// These patterns look for the DANGEROUS COMMAND / ACT, not for the rule text.
+// That is still fuzzy: documentation *about* a rule reads much like a violation
+// of it. Hence excerpts, not just counts — a human adjudicates before the hard
+// rollback trigger fires.
+// ---------------------------------------------------------------------------
+const SCAR_PATTERNS = [
+    { rule: 'git-add-all', re: /\bgit\s+add\s+(-A\b|--all\b|\.(?:\s|$))/ },
+    { rule: 'destroy-worktree', re: /\bgit\s+worktree\s+remove\b|\bgit\s+branch\s+-D\b/ },
+    { rule: 'destructive-git', re: /\bgit\s+(reset\s+--hard|checkout\s+--\s+\.|clean\s+-[a-z]*f|stash\b)/ },
+    { rule: 'auto-approve-gate', re: /auto-?approv\w*/i },
+    { rule: 'hand-edit-status', re: /(hand|manual\w*)[- ]edit\w*\s+status\.yaml|edited?\s+status\.yaml\s+(directly|by hand)/i },
+    { rule: 'afx-from-worktree', re: /\bafx\s+spawn\b[^\n]*\bfrom\s+(inside\s+)?(a\s+)?worktree/i },
+    { rule: 'kill-shellper', re: /kill\w*\s+[^\n]{0,40}shellper/i },
+    { rule: 'restart-tower', re: /\b(restart|stop)\w*\s+tower\b/i },
+];
+/** Phrases indicating the surrounding text DESCRIBES a rule rather than reports a breach. */
+const DOCUMENTATION_MARKERS = /\b(never|do not|don'?t|must not|forbidden|prohibited|avoid|rule|policy|reminder|guard|prevent)\b/i;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function mean(xs) {
+    return xs.length ? xs.reduce((a, b) => a + b, 0) / xs.length : 0;
+}
+function median(xs) {
+    if (!xs.length)
+        return 0;
+    const s = [...xs].sort((a, b) => a - b);
+    const m = Math.floor(s.length / 2);
+    return s.length % 2 ? s[m] : (s[m - 1] + s[m]) / 2;
+}
+function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+function walk(dir, pred) {
+    if (!fs.existsSync(dir))
+        return [];
+    const out = [];
+    for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+        const p = path.join(dir, e.name);
+        if (e.isDirectory())
+            out.push(...walk(p, pred));
+        else if (pred(p))
+            out.push(p);
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Metric collection
+// ---------------------------------------------------------------------------
+/**
+ * B1/B2/B4 — CMAP verdicts and review rounds.
+ *
+ * Sample: projects whose `status.yaml` has a non-empty `history`. In practice
+ * this is SPIR (and one legacy `spider`) — porch only persists per-plan-phase
+ * review history for protocols that loop that way, so pir/bugfix/air contribute
+ * nothing. Sorted for deterministic output.
+ */
+function collectReviewMetrics(root, excludeProjects, includeProjects) {
+    const projDir = path.join(root, 'codev', 'projects');
+    const files = fs.existsSync(projDir)
+        ? fs
+            .readdirSync(projDir)
+            .filter((d) => (includeProjects ? includeProjects.includes(d) : true))
+            .filter((d) => !excludeProjects.includes(d))
+            .map((d) => path.join(projDir, d, 'status.yaml'))
+            .filter((f) => fs.existsSync(f))
+            .sort()
+        : [];
+    const verdictCounts = {};
+    const phaseRounds = [];
+    const projectRounds = [];
+    const sampleProjects = [];
+    for (const f of files) {
+        let doc;
+        try {
+            doc = yaml.load(fs.readFileSync(f, 'utf-8'));
+        }
+        catch {
+            continue; // a malformed status file must not abort the measurement
+        }
+        const history = doc?.history ?? [];
+        if (!history.length)
+            continue;
+        sampleProjects.push(path.basename(path.dirname(f)));
+        const byPhase = new Map();
+        for (const item of history) {
+            for (const r of item.reviews ?? []) {
+                const v = r.verdict ?? 'UNKNOWN';
+                verdictCounts[v] = (verdictCounts[v] ?? 0) + 1;
+            }
+            const ph = item.plan_phase ?? '__none__';
+            byPhase.set(ph, Math.max(byPhase.get(ph) ?? 0, item.iteration ?? 0));
+        }
+        const rounds = [...byPhase.values()];
+        phaseRounds.push(...rounds);
+        projectRounds.push(rounds.reduce((a, b) => a + b, 0));
+    }
+    const total = Object.values(verdictCounts).reduce((a, b) => a + b, 0);
+    return {
+        verdictCounts,
+        total,
+        rcRate: total ? (verdictCounts['REQUEST_CHANGES'] ?? 0) / total : 0,
+        phaseRounds,
+        projectRounds,
+        sampleProjects: sampleProjects.sort(),
+    };
+}
+/**
+ * B3 — candidate scar-rule violations mined from committed prose.
+ *
+ * Scans `codev/reviews/*.md` and `codev/state/*_thread.md`. Emits EXCERPTS, not
+ * just counts: the mining cannot distinguish "we violated this" from "never do
+ * this", so every hit is a candidate requiring human adjudication. Lines that
+ * look like rule documentation are filtered out to cut the obvious noise, but
+ * the filter is conservative by design — it is better to hand a human a false
+ * positive than to silently drop a real breach.
+ */
+function collectScarHits(root, excludeBasenamePrefixes) {
+    const excluded = (p) => excludeBasenamePrefixes.some((pre) => path.basename(p).startsWith(pre));
+    const targets = [
+        ...walk(path.join(root, 'codev', 'reviews'), (p) => p.endsWith('.md')),
+        ...walk(path.join(root, 'codev', 'state'), (p) => p.endsWith('_thread.md')),
+    ]
+        .filter((p) => !excluded(p))
+        .sort();
+    const hits = [];
+    for (const file of targets) {
+        const lines = fs.readFileSync(file, 'utf-8').split('\n');
+        lines.forEach((line, i) => {
+            if (DOCUMENTATION_MARKERS.test(line))
+                return; // prescriptive, not a breach report
+            for (const { rule, re } of SCAR_PATTERNS) {
+                if (re.test(line)) {
+                    hits.push({
+                        rule,
+                        file: path.relative(root, file),
+                        line: i + 1,
+                        excerpt: line.trim().slice(0, 200),
+                    });
+                    break;
+                }
+            }
+        });
+    }
+    return { hits, filesScanned: targets.length };
+}
+/** This project's own artifacts — excluded from its own baseline by default. */
+export const SELF_PROJECT_DIR = '1252-prompt-architecture-single-own';
+export const SELF_FILE_PREFIXES = ['spir-1252_', '1252-'];
+/** Collect all behavioural metrics for a repo root. Deterministic over B1–B4. */
+export function measureBehavior(root, opts = {}) {
+    const rv = collectReviewMetrics(root, opts.excludeProjects ?? [SELF_PROJECT_DIR], opts.includeProjects);
+    const scar = collectScarHits(root, opts.excludeFilePrefixes ?? SELF_FILE_PREFIXES);
+    return {
+        b1_requestChangesRate: round2(rv.rcRate * 100),
+        b1_verdictCounts: rv.verdictCounts,
+        b1_totalVerdicts: rv.total,
+        b2_roundsPerPhaseMean: round2(mean(rv.phaseRounds)),
+        b2_roundsPerPhaseMedian: median(rv.phaseRounds),
+        b2_roundsPerPhaseMax: rv.phaseRounds.length ? Math.max(...rv.phaseRounds) : 0,
+        b2_phaseCount: rv.phaseRounds.length,
+        b3_candidateHits: scar.hits,
+        b3_filesScanned: scar.filesScanned,
+        b4_roundsPerProjectMean: round2(mean(rv.projectRounds)),
+        b4_roundsPerProjectMedian: median(rv.projectRounds),
+        b4_projectCount: rv.projectRounds.length,
+        sampleProjects: rv.sampleProjects,
+    };
+}
+// ---------------------------------------------------------------------------
+// Rendering
+// ---------------------------------------------------------------------------
+/** Render metrics as the committed markdown baseline artifact. */
+export function render(m) {
+    const byRule = new Map();
+    for (const h of m.b3_candidateHits)
+        byRule.set(h.rule, (byRule.get(h.rule) ?? 0) + 1);
+    const lines = [
+        '# Behavioural metrics (Spec 1252, M12 / Appendix D)',
+        '',
+        '## B1 — CMAP verdict distribution',
+        '',
+        `Total verdicts: **${m.b1_totalVerdicts}** across ${m.b4_projectCount} projects with review history.`,
+        '',
+        '| Verdict | Count | Share |',
+        '|---|---:|---:|',
+        ...Object.entries(m.b1_verdictCounts)
+            .sort((a, b) => b[1] - a[1])
+            .map(([v, c]) => `| ${v} | ${c} | ${round2((c / Math.max(m.b1_totalVerdicts, 1)) * 100)}% |`),
+        '',
+        `**B1 REQUEST_CHANGES rate: ${m.b1_requestChangesRate}%** — the load-bearing metric.`,
+        '',
+        '## B2 — review rounds per plan phase',
+        '',
+        `mean **${m.b2_roundsPerPhaseMean}**, median ${m.b2_roundsPerPhaseMedian}, max ${m.b2_roundsPerPhaseMax} (n=${m.b2_phaseCount} phases)`,
+        '',
+        '> Advisory only. The observed range is too narrow to detect a subtle',
+        '> regression. Note also that phases advance on builder *rebuttal*, not on',
+        '> unanimous approval — 0 terminal phases in this corpus end with 3x APPROVE —',
+        '> so a "rounds to unanimity" metric would never resolve.',
+        '',
+        '## B4 — review rounds per project',
+        '',
+        `mean **${m.b4_roundsPerProjectMean}**, median ${m.b4_roundsPerProjectMedian} (n=${m.b4_projectCount} projects). Advisory.`,
+        '',
+        '## B3 — candidate scar-rule violations',
+        '',
+        `Scanned **${m.b3_filesScanned}** files (codev/reviews + codev/state threads).`,
+        `Candidate hits: **${m.b3_candidateHits.length}**`,
+        '',
+        '> **These are CANDIDATES, not findings.** Keyword mining cannot distinguish',
+        '> "we did this" from "never do this". Every hit requires human adjudication',
+        '> before the hard rollback trigger fires. B3 is the metric that matters most —',
+        '> it is the only one that would catch a compressed scar rule losing its force.',
+        '',
+    ];
+    if (byRule.size) {
+        lines.push('| Rule | Candidate hits |', '|---|---:|');
+        for (const [r, c] of [...byRule.entries()].sort((a, b) => b[1] - a[1])) {
+            lines.push(`| ${r} | ${c} |`);
+        }
+        lines.push('', '### Excerpts for adjudication', '');
+        for (const h of m.b3_candidateHits.slice(0, 50)) {
+            lines.push(`- \`${h.file}:${h.line}\` **[${h.rule}]** — ${h.excerpt}`);
+        }
+        if (m.b3_candidateHits.length > 50) {
+            lines.push(`- …and ${m.b3_candidateHits.length - 50} more (see --json for the full list)`);
+        }
+        lines.push('');
+    }
+    lines.push('## B5 — consult cost/duration', '', '**Not captured here.** `consult stats` is a rolling 30-day machine-local DB,', 'so it is not reproducible from a commit. Capture it separately as advisory', 'context; it is excluded from T14 determinism and drives no rollback trigger.', '', '## Sample provenance', '', ...m.sampleProjects.map((p) => `- ${p}`), '');
+    return lines.join('\n');
+}
+/** CLI entry, invoked by `packages/codev/scripts/measure-prompt-behavior.ts`. */
+export function runCli(argv, cwd) {
+    const json = argv.includes('--json');
+    const root = argv.find((a) => !a.startsWith('--')) ?? cwd;
+    const m = measureBehavior(path.resolve(root));
+    return json ? JSON.stringify(m, null, 2) : render(m);
+}
+//# sourceMappingURL=prompt-behavior-metrics.js.map

package/dist/lib/prompt-behavior-metrics.js.map

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

package/dist/lib/skeleton.d.ts

@@ -57,7 +57,28 @@ export declare function readCodevFile(relativePath: string, workspaceRoot?: stri
  */
 export declare function hasLocalOverride(relativePath: string, workspaceRoot?: string): boolean;
 /**
- * List all files in the skeleton directory matching a pattern
+ * Every protocol name visible at ANY tier, plus any aliases those protocols declare.
+ *
+ * Union, not precedence: a name present at any tier is a name porch can run, so configuring it is
+ * legitimate. Aliases are included because porch resolves by them (`spir`/`spider`,
+ * `maintain`/`maint`, `pir`/`plan-implement-review`), so rejecting an alias would reject config the
+ * CLI itself accepts.
+ */
+export declare function listProtocolNames(workspaceRoot?: string): Set<string>;
+/**
+ * Map a protocol name or alias to its canonical (directory) name.
+ *
+ * Returns the input unchanged when it is already canonical or cannot be resolved — callers use this
+ * for identity comparison, so an unresolvable name simply compares equal only to itself.
+ */
+export declare function canonicalProtocolName(workspaceRoot: string | undefined, nameOrAlias: string): string;
+/**
+ * Every review type (`phases[].verify.type`) declared by the protocols available here.
+ *
+ * Unlike listProtocolNames, this reads the RESOLVED protocol.json per name (tier precedence via
+ * resolveCodevFile) rather than unioning across tiers: only the file that will actually execute
+ * defines which review types can occur, so a shadowed skeleton copy's types must not leak in.
  */
+export declare function listReviewTypes(workspaceRoot?: string): Set<string>;
 export declare function listSkeletonFiles(subdir?: string): string[];
 //# sourceMappingURL=skeleton.d.ts.map

package/dist/lib/skeleton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skeleton.d.ts","sourceRoot":"","sources":["../../src/lib/skeleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgC5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,EACtB,KAAK,SAAI,GACR,MAAM,CAOR;AAaD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAG7D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAEpD;AA0CD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAItF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAwB3D"}
+{"version":3,"file":"skeleton.d.ts","sourceRoot":"","sources":["../../src/lib/skeleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgC5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,EACtB,KAAK,SAAI,GACR,MAAM,CAOR;AAaD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAG7D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAEpD;AA0CD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAItF;AAgCD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAoBrE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAsBpG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAcnE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAwB3D"}

package/dist/lib/skeleton.js

@@ -181,6 +181,126 @@ export function hasLocalOverride(relativePath, workspaceRoot) {
 /**
  * List all files in the skeleton directory matching a pattern
  */
+/**
+ * All directories that may contain protocols, in resolution order.
+ *
+ * NOTE: this includes the framework cache. `porch/protocol.ts`'s alias scan historically checked
+ * only three tiers (omitting the cache) — that is a pre-existing inconsistency with
+ * resolveCodevFile's four tiers, and is deliberately NOT reproduced here.
+ */
+function protocolDirs(workspaceRoot) {
+    const root = workspaceRoot || findWorkspaceRoot();
+    const dirs = [
+        path.join(root, '.codev', 'protocols'),
+        path.join(root, 'codev', 'protocols'),
+    ];
+    const cacheDir = _getFrameworkCacheDir(root);
+    if (cacheDir)
+        dirs.push(path.join(cacheDir, 'protocols'));
+    dirs.push(path.join(getSkeletonDir(), 'protocols'));
+    return dirs;
+}
+function readProtocolJson(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null; // unreadable or invalid JSON — not this function's error to raise
+    }
+}
+/**
+ * Every protocol name visible at ANY tier, plus any aliases those protocols declare.
+ *
+ * Union, not precedence: a name present at any tier is a name porch can run, so configuring it is
+ * legitimate. Aliases are included because porch resolves by them (`spir`/`spider`,
+ * `maintain`/`maint`, `pir`/`plan-implement-review`), so rejecting an alias would reject config the
+ * CLI itself accepts.
+ */
+export function listProtocolNames(workspaceRoot) {
+    const names = new Set();
+    for (const dir of protocolDirs(workspaceRoot)) {
+        if (!fs.existsSync(dir))
+            continue;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true }).filter(d => d.isDirectory());
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const jsonPath = path.join(dir, entry.name, 'protocol.json');
+            if (!fs.existsSync(jsonPath))
+                continue;
+            names.add(entry.name);
+            const parsed = readProtocolJson(jsonPath);
+            const alias = parsed?.alias;
+            if (typeof alias === 'string' && alias.length > 0)
+                names.add(alias);
+        }
+    }
+    return names;
+}
+/**
+ * Map a protocol name or alias to its canonical (directory) name.
+ *
+ * Returns the input unchanged when it is already canonical or cannot be resolved — callers use this
+ * for identity comparison, so an unresolvable name simply compares equal only to itself.
+ */
+export function canonicalProtocolName(workspaceRoot, nameOrAlias) {
+    for (const dir of protocolDirs(workspaceRoot)) {
+        if (!fs.existsSync(dir))
+            continue;
+        // A directory of this name is already canonical.
+        if (fs.existsSync(path.join(dir, nameOrAlias, 'protocol.json')))
+            return nameOrAlias;
+    }
+    for (const dir of protocolDirs(workspaceRoot)) {
+        if (!fs.existsSync(dir))
+            continue;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true }).filter(d => d.isDirectory());
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const jsonPath = path.join(dir, entry.name, 'protocol.json');
+            if (!fs.existsSync(jsonPath))
+                continue;
+            const parsed = readProtocolJson(jsonPath);
+            if (parsed?.alias === nameOrAlias)
+                return entry.name;
+        }
+    }
+    return nameOrAlias;
+}
+/**
+ * Every review type (`phases[].verify.type`) declared by the protocols available here.
+ *
+ * Unlike listProtocolNames, this reads the RESOLVED protocol.json per name (tier precedence via
+ * resolveCodevFile) rather than unioning across tiers: only the file that will actually execute
+ * defines which review types can occur, so a shadowed skeleton copy's types must not leak in.
+ */
+export function listReviewTypes(workspaceRoot) {
+    const types = new Set();
+    for (const name of listProtocolNames(workspaceRoot)) {
+        const resolved = resolveCodevFile(`protocols/${name}/protocol.json`, workspaceRoot);
+        if (!resolved)
+            continue; // alias entries have no directory of their own
+        const parsed = readProtocolJson(resolved);
+        const phases = parsed?.phases;
+        if (!Array.isArray(phases))
+            continue;
+        for (const phase of phases) {
+            const verifyType = phase?.verify?.type;
+            if (typeof verifyType === 'string' && verifyType.length > 0)
+                types.add(verifyType);
+        }
+    }
+    return types;
+}
 export function listSkeletonFiles(subdir) {
     const skeletonDir = getSkeletonDir();
     const targetDir = subdir ? path.join(skeletonDir, subdir) : skeletonDir;

package/dist/lib/skeleton.js.map

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

package/dist/lib/test-env.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Test-runner detection and the escape hatches that go with it (#1323).
+ *
+ * Two consult side effects are *user-global*: spawning the real `agy` binary
+ * (which opens a browser login window when agy is unauthenticated) and writing
+ * to `~/.codev/metrics.db`. Both used to be reachable from the test suites by
+ * simple omission — a test that never pinned `CODEV_AGY_BIN` resolved the
+ * developer's real binary, and every in-process test recorded metrics into the
+ * developer's real database.
+ *
+ * The vitest harness (`vitest-setup.ts`) now pins a sandbox for both. These
+ * helpers are the belt-and-braces half: production code consults them so that a
+ * *future* test which slips past the harness fails loudly instead of silently
+ * reaching the real world.
+ */
+/**
+ * True when this process is running under a test runner.
+ *
+ * `VITEST` is set by the runner and covers every suite Codev actually has;
+ * CLI-integration and e2e tests spawn `codev` / `consult` children with
+ * `{ ...process.env }`, so children inherit it and fall under the same guards.
+ *
+ * `CODEV_TEST_ISOLATION` is the opt-in for a harness that is not vitest. It is
+ * deliberately a name Codev owns: these guards make `consult` *throw*, so a
+ * false positive breaks a real consultation. A generic marker like `CODEV_TEST`
+ * or `CI` could already be exported in an adopter's environment for unrelated
+ * reasons, and inheriting someone else's variable is not worth the blast radius.
+ */
+export declare function isUnderTestRunner(): boolean;
+/**
+ * Explicit opt-in for deliberately exercising the REAL `agy` binary from a test.
+ *
+ * Unset by default, so no suite can spawn the real CLI by accident. Set it to
+ * run the guarded real-agy integration smoke, or a real-AI e2e benchmark:
+ *
+ *   CODEV_ALLOW_REAL_AGY=1 pnpm --filter @cluesmith/codev test:e2e:cli
+ *
+ * When set, the vitest harness leaves `CODEV_AGY_BIN` alone and the lane guard
+ * stands down — you get the real binary, and the real browser tab if agy's
+ * login has lapsed.
+ */
+export declare function realAgyOptIn(): boolean;
+/**
+ * Guard the gemini (agy) lane against reaching the real binary from a test.
+ *
+ * Throws when running under a test runner with neither an explicit
+ * `CODEV_AGY_BIN` pin nor the real-agy opt-in. Deliberately louder than the
+ * lane's usual non-blocking skip: a misconfigured test must fail the suite, not
+ * quietly degrade to a COMMENT verdict (which would hide the misconfiguration
+ * on a machine where agy simply isn't installed).
+ *
+ * **Where this is called, and why there.** There is exactly one call site:
+ * `resolveAgyBin()`, in the branch taken when `CODEV_AGY_BIN` is unset. That is
+ * the chokepoint — every route to the real binary passes through it, and there
+ * is more than one route:
+ *
+ *   - `runAgyConsultation()` — the consult lane (`consult -m gemini`)
+ *   - `doctor.ts:verifyAgy()` — `codev doctor`'s OAuth probe, a second spawn
+ *     site that issue #1323 did not mention
+ *   - `doctor.ts:checkAgy()` — presence check; does not spawn, but resolution
+ *     itself is not passive
+ *
+ * That last point is the reason the guard sits at resolution rather than at the
+ * spawn sites: the unpinned lookup runs `agyRespondsToVersion()`, which
+ * *executes* the candidate binary with `--version`. Guarding only the spawns
+ * would leave a suite executing the developer's real agy — no browser window
+ * from a version print, but a violation of the invariant all the same.
+ *
+ * Guarding here is safe for the resolution tests because they all pin
+ * `CODEV_AGY_BIN` before calling (they are testing override handling), and
+ * `agy-integration.e2e.test.ts` short-circuits on the opt-in before resolving.
+ */
+export declare function assertAgyLaneAllowedUnderTest(): void;
+//# sourceMappingURL=test-env.d.ts.map