@cluesmith/codev 3.2.3 → 3.3.0

package/dist/lib/gitignore.d.ts

@@ -8,14 +8,23 @@
  * Extracted from `scaffold.ts` (issue #882) once the file accumulated three distinct
  * gitignore behaviors and the "scaffold" name stopped matching the contents.
  */
+/**
+ * Architect state files (`codev/state/<name>.md`) are per-person and must be
+ * gitignored; builder thread files (`codev/state/*_thread.md`) share the
+ * directory but must stay versioned (they ship with each builder PR). Defined
+ * once here and referenced both in the entries block below and in the doctor
+ * audit's warning text (issue #1192), so the two can't drift out of sync.
+ */
+export declare const STATE_IGNORE_RULE = "codev/state/*.md";
+export declare const THREAD_KEEP_RULE = "!codev/state/*_thread.md";
 /**
  * Standard gitignore entries for codev projects
  */
-export declare const CODEV_GITIGNORE_ENTRIES = "# Codev\n.agent-farm/\n.consult/\ncodev/.update-hashes.json\n.builders/\n.architect-role.md\n";
+export declare const CODEV_GITIGNORE_ENTRIES = "# Codev\n.agent-farm/\n.consult/\ncodev/.update-hashes.json\n.builders/\n.architect-role.md\ncodev/state/*.md\n!codev/state/*_thread.md\n";
 /**
  * Full gitignore content for new projects
  */
-export declare const FULL_GITIGNORE_CONTENT = "# Codev\n.agent-farm/\n.consult/\ncodev/.update-hashes.json\n.builders/\n.architect-role.md\n\n# Dependencies\nnode_modules/\n\n# Build output\ndist/\n\n# OS files\n.DS_Store\n*.swp\n*.swo\n";
+export declare const FULL_GITIGNORE_CONTENT = "# Codev\n.agent-farm/\n.consult/\ncodev/.update-hashes.json\n.builders/\n.architect-role.md\ncodev/state/*.md\n!codev/state/*_thread.md\n\n# Dependencies\nnode_modules/\n\n# Build output\ndist/\n\n# OS files\n.DS_Store\n*.swp\n*.swo\n";
 /**
  * Create a new .gitignore file with full content (for init)
  */
@@ -56,5 +65,19 @@ export interface BackfillGitignoreResult {
  * (creation belongs to init/adopt).
  */
 export declare function backfillGitignore(targetDir: string, block: string, options?: BackfillGitignoreOptions): BackfillGitignoreResult;
+/**
+ * Audit the architect-state-file versioning split for `codev doctor` (issue #1192).
+ *
+ * Architect state files (`codev/state/<name>.md`) are per-person and must be
+ * gitignored; builder thread files (`codev/state/*_thread.md`) share the
+ * directory but must stay versioned (they ship with each builder PR).
+ *
+ * Probes git's actual ignore behavior via `git check-ignore` on phantom paths
+ * (check-ignore does not require the path to exist) rather than string-matching
+ * `.gitignore`, so hand-written equivalent rules pass and rule-ordering bugs
+ * (a shadowed negation) are caught. Returns warning strings; empty outside a
+ * git repository.
+ */
+export declare function auditStateFileIgnore(workspaceRoot: string): string[];
 export {};
 //# sourceMappingURL=gitignore.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/lib/gitignore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;GAEG;AACH,eAAO,MAAM,uBAAuB,kGAMnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,mMAWlC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGvD;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,CAaxE;AAED,UAAU,wBAAwB;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,IAAI,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAYD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAmCzB"}
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/lib/gitignore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AACpD,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,uBAAuB,8IAQnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,+OAWlC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGvD;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,CAaxE;AAED,UAAU,wBAAwB;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,IAAI,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAYD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAmCzB;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAmDpE"}

package/dist/lib/gitignore.js

@@ -10,6 +10,16 @@
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { spawnSync } from 'node:child_process';
+/**
+ * Architect state files (`codev/state/<name>.md`) are per-person and must be
+ * gitignored; builder thread files (`codev/state/*_thread.md`) share the
+ * directory but must stay versioned (they ship with each builder PR). Defined
+ * once here and referenced both in the entries block below and in the doctor
+ * audit's warning text (issue #1192), so the two can't drift out of sync.
+ */
+export const STATE_IGNORE_RULE = 'codev/state/*.md';
+export const THREAD_KEEP_RULE = '!codev/state/*_thread.md';
 /**
  * Standard gitignore entries for codev projects
  */
@@ -19,6 +29,8 @@ export const CODEV_GITIGNORE_ENTRIES = `# Codev
 codev/.update-hashes.json
 .builders/
 .architect-role.md
+${STATE_IGNORE_RULE}
+${THREAD_KEEP_RULE}
 `;
 /**
  * Full gitignore content for new projects
@@ -111,4 +123,62 @@ export function backfillGitignore(targetDir, block, options = {}) {
     fs.appendFileSync(gitignorePath, appended);
     return { added, alreadyPresent, skipped: false };
 }
+function gitExitStatus(args, cwd) {
+    try {
+        const result = spawnSync('git', args, { cwd, stdio: 'pipe', timeout: 5000 });
+        return result.status;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Audit the architect-state-file versioning split for `codev doctor` (issue #1192).
+ *
+ * Architect state files (`codev/state/<name>.md`) are per-person and must be
+ * gitignored; builder thread files (`codev/state/*_thread.md`) share the
+ * directory but must stay versioned (they ship with each builder PR).
+ *
+ * Probes git's actual ignore behavior via `git check-ignore` on phantom paths
+ * (check-ignore does not require the path to exist) rather than string-matching
+ * `.gitignore`, so hand-written equivalent rules pass and rule-ordering bugs
+ * (a shadowed negation) are caught. Returns warning strings; empty outside a
+ * git repository.
+ */
+export function auditStateFileIgnore(workspaceRoot) {
+    const warnings = [];
+    if (gitExitStatus(['rev-parse', '--is-inside-work-tree'], workspaceRoot) !== 0) {
+        return warnings;
+    }
+    const architectProbe = gitExitStatus(['check-ignore', '-q', 'codev/state/__doctor-probe__.md'], workspaceRoot);
+    if (architectProbe !== 0) {
+        warnings.push(`Architect state files (codev/state/<name>.md) are not gitignored. They are per-person and must not be committed. Run "codev update" to backfill the rule, or add "${STATE_IGNORE_RULE}" + "${THREAD_KEEP_RULE}" to .gitignore`);
+    }
+    const threadProbe = gitExitStatus(['check-ignore', '-q', 'codev/state/__doctor-probe___thread.md'], workspaceRoot);
+    if (threadProbe === 0) {
+        warnings.push(`Builder thread files (codev/state/*_thread.md) are gitignored. They must stay versioned (they ship with each builder PR). The "${THREAD_KEEP_RULE}" negation is missing or shadowed by a later rule in .gitignore`);
+    }
+    // gitignore has no effect on already-tracked files; pre-existing installs may
+    // have committed an architect state file before the rule existed.
+    try {
+        const result = spawnSync('git', ['ls-files', 'codev/state/*.md'], {
+            cwd: workspaceRoot,
+            encoding: 'utf-8',
+            timeout: 5000,
+        });
+        if (result.status === 0) {
+            const tracked = result.stdout
+                .split('\n')
+                .map(line => line.trim())
+                .filter(line => line.length > 0 && !line.endsWith('_thread.md'));
+            for (const file of tracked) {
+                warnings.push(`Architect state file is tracked by git: ${file}. It is per-person and should not be versioned. Run: git rm --cached ${file}`);
+            }
+        }
+    }
+    catch {
+        // git unavailable or timed out; nothing to report
+    }
+    return warnings;
+}
 //# sourceMappingURL=gitignore.js.map

package/dist/lib/gitignore.js.map

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

package/dist/lib/migration-backup-audit.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Migration-backup audit for `codev doctor` (issue #1239).
+ *
+ * State migrations leave copies of the pre-migration state behind and nothing
+ * ever removes them. A disk audit on 2026-07-25 found an 18 GB
+ * `~/.agent-farm.bak-*` directory still on disk three weeks after the migration
+ * that created it — a full copy of the agent-farm dir, dominated by the logs it
+ * duplicated.
+ *
+ * Two leftover families exist:
+ *
+ *  1. `~/{.,}agent-farm*bak*` — whole-directory copies of the agent-farm home,
+ *     taken by hand during the #1118 state consolidation. These are the big
+ *     ones (they include `logs/`).
+ *  2. `*.pre-merge-<timestamp>` — the source `state.db` (plus `-wal`/`-shm`
+ *     sidecars) that `db/consolidate.ts` renames rather than deletes after
+ *     merging it into `global.db`. Small, but equally unreaped.
+ *
+ * This module reports; it never deletes. These are multi-gigabyte copies of the
+ * user's own state, and the decision to remove them is the human's. Doctor
+ * prints age + size + the exact `rm -rf` command so that decision is one
+ * paste away.
+ */
+/**
+ * A leftover is only worth nagging about once the migration that produced it
+ * has demonstrably held up. Below this age it is reported informationally;
+ * at or above it, doctor counts it as a warning.
+ */
+export declare const STALE_BACKUP_AGE_DAYS = 7;
+export type MigrationBackupKind = 'home-copy' | 'pre-merge';
+export interface MigrationBackup {
+    /** Absolute path to the leftover file or directory. */
+    path: string;
+    kind: MigrationBackupKind;
+    /** Whole days since last modification. */
+    ageDays: number;
+    /** Size on disk in bytes, or null when it could not be measured. */
+    sizeBytes: number | null;
+    /** True once `ageDays >= STALE_BACKUP_AGE_DAYS`. */
+    stale: boolean;
+}
+/** Human-readable byte size, e.g. `18.0 GB`. */
+export declare function formatBytes(bytes: number): string;
+export interface FindMigrationBackupsOptions {
+    /** Home directory to scan. Defaults to the real home; overridable for tests. */
+    home?: string;
+    /** Workspace root whose `.agent-farm/` is scanned for `*.pre-merge-*`. */
+    workspaceRoot?: string | null;
+    /** Reference time for age computation. Defaults to now. */
+    now?: Date;
+}
+/**
+ * Find every migration leftover on disk, newest first.
+ *
+ * Scans the home directory for whole-directory copies, and both the agent-farm
+ * home (`~/.agent-farm/`) and the workspace's `.agent-farm/` for `*.pre-merge-*`
+ * renames. Read-only; safe to call unconditionally.
+ */
+export declare function findMigrationBackups(options?: FindMigrationBackupsOptions): MigrationBackup[];
+/** One-line doctor rendering: path, age, size. */
+export declare function formatMigrationBackup(backup: MigrationBackup): string;
+/** Total measured bytes across a set of leftovers (unmeasurable ones count 0). */
+export declare function totalBytes(backups: MigrationBackup[]): number;
+//# sourceMappingURL=migration-backup-audit.d.ts.map

package/dist/lib/migration-backup-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-backup-audit.d.ts","sourceRoot":"","sources":["../../src/lib/migration-backup-audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,WAAW,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,mBAAmB,CAAC;IAC1B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;CAChB;AAoCD,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASjD;AA+CD,MAAM,WAAW,2BAA2B;IAC1C,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2DAA2D;IAC3D,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,eAAe,EAAE,CAgBnB;AAED,kDAAkD;AAClD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAIrE;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAE7D"}

package/dist/lib/migration-backup-audit.js

@@ -0,0 +1,145 @@
+/**
+ * Migration-backup audit for `codev doctor` (issue #1239).
+ *
+ * State migrations leave copies of the pre-migration state behind and nothing
+ * ever removes them. A disk audit on 2026-07-25 found an 18 GB
+ * `~/.agent-farm.bak-*` directory still on disk three weeks after the migration
+ * that created it — a full copy of the agent-farm dir, dominated by the logs it
+ * duplicated.
+ *
+ * Two leftover families exist:
+ *
+ *  1. `~/{.,}agent-farm*bak*` — whole-directory copies of the agent-farm home,
+ *     taken by hand during the #1118 state consolidation. These are the big
+ *     ones (they include `logs/`).
+ *  2. `*.pre-merge-<timestamp>` — the source `state.db` (plus `-wal`/`-shm`
+ *     sidecars) that `db/consolidate.ts` renames rather than deletes after
+ *     merging it into `global.db`. Small, but equally unreaped.
+ *
+ * This module reports; it never deletes. These are multi-gigabyte copies of the
+ * user's own state, and the decision to remove them is the human's. Doctor
+ * prints age + size + the exact `rm -rf` command so that decision is one
+ * paste away.
+ */
+import { readdirSync, lstatSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { spawnSync } from 'node:child_process';
+/**
+ * A leftover is only worth nagging about once the migration that produced it
+ * has demonstrably held up. Below this age it is reported informationally;
+ * at or above it, doctor counts it as a warning.
+ */
+export const STALE_BACKUP_AGE_DAYS = 7;
+/**
+ * Matches a hand-taken whole-directory copy of the agent-farm home.
+ *
+ * Requires BOTH an `agent-farm` prefix (so an unrelated `my-backups/` is never
+ * touched) and a backup marker. The marker spelling has varied across the
+ * migrations that produced these — `.agent-farm.bak-<ts>` and
+ * `agent-farm-db-backup-<ts>` are both real — so match `bak` and `back` alike.
+ * The live `.agent-farm` itself has no separator after the prefix and is never
+ * matched.
+ */
+function isHomeCopy(name) {
+    return /^\.?agent-farm[.-]/i.test(name) && /bac?k/i.test(name);
+}
+/** Matches the `*.pre-merge-<timestamp>` renames left by db/consolidate.ts. */
+function isPreMerge(name) {
+    return name.includes('.pre-merge-');
+}
+/**
+ * Measure a path's size on disk with `du -sk`.
+ *
+ * A recursive Node walk would stat tens of thousands of log files on exactly
+ * the multi-GB directories this audit exists to find, so shell out instead.
+ * Returns null (reported as "size unknown") when `du` is unavailable or times
+ * out — never a guessed number.
+ */
+function measureBytes(path) {
+    const result = spawnSync('du', ['-sk', path], { encoding: 'utf-8', timeout: 20000 });
+    if (result.status !== 0 || !result.stdout)
+        return null;
+    const kb = parseInt(result.stdout.trim().split(/\s+/)[0], 10);
+    return Number.isFinite(kb) ? kb * 1024 : null;
+}
+/** Human-readable byte size, e.g. `18.0 GB`. */
+export function formatBytes(bytes) {
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let value = bytes;
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit++;
+    }
+    return unit === 0 ? `${value} B` : `${value.toFixed(1)} ${units[unit]}`;
+}
+function inspect(path, kind, now) {
+    let stat;
+    try {
+        stat = lstatSync(path);
+    }
+    catch {
+        // Vanished between readdir and lstat — nothing to report.
+        return null;
+    }
+    const ageDays = Math.floor((now - stat.mtimeMs) / 86_400_000);
+    return {
+        path,
+        kind,
+        ageDays,
+        sizeBytes: measureBytes(path),
+        stale: ageDays >= STALE_BACKUP_AGE_DAYS,
+    };
+}
+function scanDir(dir, match, kind, now) {
+    if (!existsSync(dir))
+        return [];
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        // Unreadable directory (permissions) — not something doctor should fail on.
+        return [];
+    }
+    const found = [];
+    for (const name of names) {
+        if (!match(name))
+            continue;
+        const entry = inspect(join(dir, name), kind, now);
+        if (entry)
+            found.push(entry);
+    }
+    return found;
+}
+/**
+ * Find every migration leftover on disk, newest first.
+ *
+ * Scans the home directory for whole-directory copies, and both the agent-farm
+ * home (`~/.agent-farm/`) and the workspace's `.agent-farm/` for `*.pre-merge-*`
+ * renames. Read-only; safe to call unconditionally.
+ */
+export function findMigrationBackups(options = {}) {
+    const home = options.home ?? homedir();
+    const now = (options.now ?? new Date()).getTime();
+    const backups = [
+        ...scanDir(home, isHomeCopy, 'home-copy', now),
+        ...scanDir(join(home, '.agent-farm'), isPreMerge, 'pre-merge', now),
+    ];
+    if (options.workspaceRoot) {
+        backups.push(...scanDir(join(options.workspaceRoot, '.agent-farm'), isPreMerge, 'pre-merge', now));
+    }
+    return backups.sort((a, b) => a.ageDays - b.ageDays);
+}
+/** One-line doctor rendering: path, age, size. */
+export function formatMigrationBackup(backup) {
+    const age = backup.ageDays === 1 ? '1 day old' : `${backup.ageDays} days old`;
+    const size = backup.sizeBytes === null ? 'size unknown' : formatBytes(backup.sizeBytes);
+    return `${backup.path} — ${age}, ${size}`;
+}
+/** Total measured bytes across a set of leftovers (unmeasurable ones count 0). */
+export function totalBytes(backups) {
+    return backups.reduce((sum, b) => sum + (b.sizeBytes ?? 0), 0);
+}
+//# sourceMappingURL=migration-backup-audit.js.map

package/dist/lib/migration-backup-audit.js.map

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

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"}