@deftai/directive-core 0.70.0 → 0.71.1

package/dist/triage/bootstrap/gitignore.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, relative } from "node:path";
-import { resolveEvalPath } from "../../layout/resolve.js";
+import { resolveLifecycleLayout } from "../../layout/resolve.js";
+import { resolveCandidatesLogPath, resolveTriageCachePath, TRIAGE_CACHE_DIR_NAME, triageCacheRelPath, } from "../cache-path.js";
 /** POSIX-style display path for `absPath` relative to `projectRoot` (#2109). */
 function evalRelDisplay(projectRoot, absPath) {
     return relative(projectRoot, absPath).split(/[\\/]/).join("/");
@@ -10,21 +11,41 @@ export const GITIGNORE_DEFT_RUNTIME_SENTINELS = [
     ".deft/ritual-state.json",
     ".deft/last-session.json",
 ];
+/** Legacy static vbrief paths kept for tests referencing the pre-#1703 constant shape. */
 export const GITIGNORE_EVAL_ENTRIES = [
-    "vbrief/.eval/candidates.jsonl",
-    "vbrief/.eval/summary-history.jsonl",
-    "vbrief/.eval/scope-lifecycle.jsonl",
-    "vbrief/.eval/decompositions/",
-    "vbrief/.eval/doctor-state.json",
+    "vbrief/.triage-cache/candidates.jsonl",
+    "vbrief/.triage-cache/summary-history.jsonl",
+    "vbrief/.triage-cache/scope-lifecycle.jsonl",
+    "vbrief/.triage-cache/decompositions/",
+    "vbrief/.triage-cache/doctor-state.json",
+];
+/** Layout-aware gitignore lines for triage working-set files (#1703). */
+export function gitignoreTriageCacheEntries(projectRoot) {
+    const decomp = triageCacheRelPath(projectRoot, "decompositions");
+    return [
+        triageCacheRelPath(projectRoot, "candidates.jsonl"),
+        triageCacheRelPath(projectRoot, "summary-history.jsonl"),
+        triageCacheRelPath(projectRoot, "scope-lifecycle.jsonl"),
+        decomp.endsWith("/") ? decomp : `${decomp}/`,
+        triageCacheRelPath(projectRoot, "doctor-state.json"),
+    ];
+}
+export function gitattributesTriageCacheGlob(projectRoot) {
+    const layout = resolveLifecycleLayout(projectRoot);
+    return `${layout.artifactDir}/${TRIAGE_CACHE_DIR_NAME}/*.jsonl`;
+}
+export const GITATTRIBUTES_EVAL_RULE = "vbrief/.triage-cache/*.jsonl  merge=union";
+export const FORBIDDEN_BLANKET_EVAL_LINES = [
+    "vbrief/.triage-cache/",
+    "vbrief/.triage-cache",
+    "vbrief/.triage-cache/",
+    "vbrief/.eval",
 ];
-export const GITATTRIBUTES_EVAL_RULE = "vbrief/.eval/*.jsonl  merge=union";
-export const FORBIDDEN_BLANKET_EVAL_LINES = ["vbrief/.eval/", "vbrief/.eval"];
-const GITATTRIBUTES_EVAL_GLOB = "vbrief/.eval/*.jsonl";
 const DEFT_CACHE_RATIONALE = "\n# Triage v1 local content cache (#845, #883). Mirrors upstream\n" +
     "# issues into .deft-cache/github-issue/<owner>/<repo>/<N>/. See\n" +
     "# docs/privacy-nfr.md for the gitignore-default + opt-in-commit-cache\n" +
     "# contract. Comment this line out to opt in to committing the cache.\n";
-const EVAL_ENTRIES_RATIONALE = "\n# vbrief/.eval/ tracking governance (#1144, N4 of #1119).\n" +
+const EVAL_ENTRIES_RATIONALE = "\n# vbrief/.triage-cache/ tracking governance (#1144, N4 of #1119).\n" +
     "# Hybrid policy from the Current Shape comment on #1144:\n" +
     "#   - candidates.jsonl       -> gitignored (operator-private triage\n" +
     "#                               decisions; re-derive via\n" +
@@ -50,15 +71,15 @@ const EVAL_ENTRIES_RATIONALE = "\n# vbrief/.eval/ tracking governance (#1144, N4
     "#   - slices.jsonl           -> TRACKED (team-shared cohort records\n" +
     "#                               produced by slicing skills; see\n" +
     "#                               #1132 / D13).\n" +
-    "# See vbrief/.eval/README.md for the full policy + merge=union\n" +
+    "# See vbrief/.triage-cache/README.md for the full policy + merge=union\n" +
     "# rebase note.\n";
-const GITATTRIBUTES_EVAL_RATIONALE = "\n# Append-only JSON-lines logs under vbrief/.eval/ use the union merge driver\n" +
+const GITATTRIBUTES_EVAL_RATIONALE = "\n# Append-only JSON-lines logs under vbrief/.triage-cache/ use the union merge driver\n" +
     "# (#1144, N4 of #1119). Both branches' appended lines are concatenated on\n" +
     "# auto-merge so single-operator rebases of two append branches resolve\n" +
     "# without manual conflict surgery. Note: merge=union does NOT dedupe; see\n" +
-    "# vbrief/.eval/README.md for the operator-facing semantics.\n";
-const EVAL_ENTRIES_RATIONALE_SENTINEL = "# vbrief/.eval/ tracking governance (#1144, N4 of #1119).";
-export const EVAL_README_BODY = `# \`vbrief/.eval/\` -- triage + slicing evaluation artefacts
+    "# vbrief/.triage-cache/README.md for the operator-facing semantics.\n";
+const EVAL_ENTRIES_RATIONALE_SENTINEL = "# vbrief/.triage-cache/ tracking governance (#1144, N4 of #1119).";
+export const EVAL_README_BODY = `# \`vbrief/.triage-cache/\` -- triage working-set artefacts
 
 This directory holds the append-only JSON-lines logs that the triage and
 slicing skills emit. The framework governs which files in here are tracked
@@ -75,9 +96,9 @@ by git versus gitignored using a **hybrid policy** (#1144, child of #1119).
 | \`decompositions/\` | No -- **gitignored** | Temporary story-decomposition proposal drafts. These JSON drafts are local scratch artifacts, not vBRIEFs; generated child story vBRIEFs are created by \`task scope:decompose\` in lifecycle folders, defaulting to \`vbrief/pending/\`. |
 | \`doctor-state.json\` | No -- **gitignored** | Per-machine \`task doctor\` throttle state (last exit code + timestamps) persisted to gate the 24h/4h re-probe window (#1308 / #1464). Local to each clone; never committed. |
 
-The gitignore lines live in the repo-root \`.gitignore\` (\`vbrief/.eval/candidates.jsonl\`,
-\`vbrief/.eval/summary-history.jsonl\`, \`vbrief/.eval/scope-lifecycle.jsonl\`,
-\`vbrief/.eval/decompositions/\`, and \`vbrief/.eval/doctor-state.json\`). All paths
+The gitignore lines live in the repo-root \`.gitignore\` (\`vbrief/.triage-cache/candidates.jsonl\`,
+\`vbrief/.triage-cache/summary-history.jsonl\`, \`vbrief/.triage-cache/scope-lifecycle.jsonl\`,
+\`vbrief/.triage-cache/decompositions/\`, and \`vbrief/.triage-cache/doctor-state.json\`). All paths
 not listed above remain committed by default.
 
 ## Fresh-clone regeneration
@@ -90,7 +111,7 @@ task triage:bootstrap
 \`\`\`
 
 The bootstrap path detects the missing file, runs the auto-classifier, and
-writes a fresh \`vbrief/.eval/candidates.jsonl\`. It does NOT touch the tracked
+writes a fresh \`vbrief/.triage-cache/candidates.jsonl\`. It does NOT touch the tracked
 \`slices.jsonl\`; cohort records remain a team-shared resource.
 
 ## \`merge=union\` policy for \`*.jsonl\`
@@ -98,7 +119,7 @@ writes a fresh \`vbrief/.eval/candidates.jsonl\`. It does NOT touch the tracked
 The repo-root \`.gitattributes\` declares:
 
 \`\`\`
-vbrief/.eval/*.jsonl  merge=union
+vbrief/.triage-cache/*.jsonl  merge=union
 \`\`\`
 
 The \`union\` merge driver concatenates both sides' appended lines on
@@ -131,6 +152,12 @@ operators should know:
 - \`.gitattributes\` -- the \`merge=union\` rule.
 - \`scripts/candidates_log.py\` -- the writer for \`candidates.jsonl\`.
 `;
+/** Layout-aware triage-cache README body for the active lifecycle tree (#2344 / #2349). */
+export function generateTriageCacheReadmeBody(projectRoot) {
+    const layout = resolveLifecycleLayout(projectRoot);
+    const triagePrefix = `${layout.artifactDir}/${TRIAGE_CACHE_DIR_NAME}`;
+    return EVAL_README_BODY.replaceAll("vbrief/.triage-cache", triagePrefix);
+}
 function stepOutcome(name, ok, message, details = {}, error = null) {
     return { name, ok, message, error, details };
 }
@@ -217,10 +244,10 @@ export function stepEnsureGitignoreEntry(projectRoot) {
 function formatBlanketWarning(blanketPresent) {
     if (!blanketPresent)
         return "";
-    return (" WARNING: stale blanket vbrief/.eval/ line detected in .gitignore -- " +
+    return (" WARNING: stale blanket vbrief/.triage-cache/ line detected in .gitignore -- " +
         "remove it manually (it hides tracked slices.jsonl from git per #1251)");
 }
-function gitattributesHasEvalMergeUnion(body) {
+function gitattributesHasEvalMergeUnion(body, glob) {
     for (const raw of body.split("\n")) {
         const stripped = raw.trim();
         if (stripped.length === 0 || stripped.startsWith("#"))
@@ -228,14 +255,14 @@ function gitattributesHasEvalMergeUnion(body) {
         const parts = stripped.split(/\s+/);
         if (parts.length === 0)
             continue;
-        if (parts[0] !== GITATTRIBUTES_EVAL_GLOB)
+        if (parts[0] !== glob)
             continue;
         if (parts.slice(1).includes("merge=union"))
             return true;
     }
     return false;
 }
-function ensureGitignoreSelectiveEntries(gitignorePath, stepName) {
+function ensureGitignoreSelectiveEntries(gitignorePath, stepName, entries) {
     let existing;
     try {
         existing = readFileSync(gitignorePath, { encoding: "utf8" });
@@ -249,7 +276,7 @@ function ensureGitignoreSelectiveEntries(gitignorePath, stepName) {
         .filter((stripped) => stripped.length > 0));
     const blanketPresent = FORBIDDEN_BLANKET_EVAL_LINES.some((forbidden) => existingLines.has(forbidden));
     const rationaleAlreadyPresent = existing.includes(EVAL_ENTRIES_RATIONALE_SENTINEL);
-    const missing = GITIGNORE_EVAL_ENTRIES.filter((entry) => !existingLines.has(entry));
+    const missing = entries.filter((entry) => !existingLines.has(entry));
     const blanketWarning = formatBlanketWarning(blanketPresent);
     if (missing.length === 0) {
         return stepOutcome(stepName, true, `all #1144 selective entries already in .gitignore (no-op)${blanketWarning}`, {
@@ -277,7 +304,7 @@ function ensureGitignoreSelectiveEntries(gitignorePath, stepName) {
         rationale_already_present: rationaleAlreadyPresent,
     });
 }
-function ensureGitattributesMergeUnion(gitattributesPath, stepName) {
+function ensureGitattributesMergeUnion(gitattributesPath, stepName, glob, ruleLine) {
     if (existsSync(gitattributesPath)) {
         let existing;
         try {
@@ -286,32 +313,39 @@ function ensureGitattributesMergeUnion(gitattributesPath, stepName) {
         catch (exc) {
             return stepOutcome(stepName, false, "could not read .gitattributes", { gitattributes_appended: false }, String(exc));
         }
-        if (gitattributesHasEvalMergeUnion(existing)) {
-            return stepOutcome(stepName, true, "vbrief/.eval/*.jsonl merge=union already in .gitattributes (no-op)", {
+        if (gitattributesHasEvalMergeUnion(existing, glob)) {
+            return stepOutcome(stepName, true, `${glob} merge=union already in .gitattributes (no-op)`, {
                 gitattributes_appended: false,
                 gitattributes_already_present: true,
             });
         }
         const suffix = existing.endsWith("\n") || existing === "" ? "" : "\n";
-        const newContent = `${existing + suffix + GITATTRIBUTES_EVAL_RATIONALE + GITATTRIBUTES_EVAL_RULE}\n`;
+        const newContent = `${existing + suffix + GITATTRIBUTES_EVAL_RATIONALE + ruleLine}\n`;
         try {
             writeFileSync(gitattributesPath, newContent, { encoding: "utf8" });
         }
         catch (exc) {
             return stepOutcome(stepName, false, "could not write .gitattributes", { gitattributes_appended: false }, String(exc));
         }
-        return stepOutcome(stepName, true, "appended vbrief/.eval/*.jsonl merge=union to .gitattributes", { gitattributes_appended: true, gitattributes_created: false });
+        return stepOutcome(stepName, true, `appended ${glob} merge=union to .gitattributes`, {
+            gitattributes_appended: true,
+            gitattributes_created: false,
+        });
     }
-    const newContent = `${GITATTRIBUTES_EVAL_RATIONALE + GITATTRIBUTES_EVAL_RULE}\n`;
+    const newContent = `${GITATTRIBUTES_EVAL_RATIONALE + ruleLine}\n`;
     try {
         writeFileSync(gitattributesPath, newContent, { encoding: "utf8" });
     }
     catch (exc) {
         return stepOutcome(stepName, false, "could not create .gitattributes", { gitattributes_appended: false }, String(exc));
     }
-    return stepOutcome(stepName, true, "created .gitattributes with vbrief/.eval/*.jsonl merge=union", { gitattributes_appended: true, gitattributes_created: true });
+    return stepOutcome(stepName, true, `created .gitattributes with ${glob} merge=union`, {
+        gitattributes_appended: true,
+        gitattributes_created: true,
+    });
 }
-function ensureEvalReadme(readmePath, readmeRel, stepName) {
+function ensureEvalReadme(options) {
+    const { projectRoot, readmePath, readmeRel, stepName } = options;
     try {
         readFileSync(readmePath, { encoding: "utf8" });
         return stepOutcome(stepName, true, `${readmeRel} already present (no-op)`, {
@@ -324,7 +358,7 @@ function ensureEvalReadme(readmePath, readmeRel, stepName) {
     }
     try {
         mkdirSync(dirname(readmePath), { recursive: true });
-        writeFileSync(readmePath, EVAL_README_BODY, { encoding: "utf8" });
+        writeFileSync(readmePath, generateTriageCacheReadmeBody(projectRoot), { encoding: "utf8" });
     }
     catch (exc) {
         return stepOutcome(stepName, false, `could not create ${readmePath}`, { readme_created: false }, String(exc));
@@ -339,23 +373,26 @@ export function stepEnsureGitignoreEvalEntries(projectRoot) {
     const gitattributesPath = `${projectRoot}/.gitattributes`;
     // Layout-aware (#2109): resolve the README under the active lifecycle `.eval`
     // dir (xbrief/ when migrated, else vbrief/) instead of a hardcoded vbrief/ path.
-    const readmePath = resolveEvalPath(projectRoot, "README.md");
+    const readmePath = resolveTriageCachePath(projectRoot, "README.md");
     const readmeRel = evalRelDisplay(projectRoot, readmePath);
+    const entries = gitignoreTriageCacheEntries(projectRoot);
+    const glob = gitattributesTriageCacheGlob(projectRoot);
+    const ruleLine = `${glob}  merge=union`;
     const stepName = "ensure_gitignore_eval_entries";
     const details = {};
-    const giResult = ensureGitignoreSelectiveEntries(gitignorePath, stepName);
+    const giResult = ensureGitignoreSelectiveEntries(gitignorePath, stepName, entries);
     if (!giResult.ok) {
         Object.assign(details, giResult.details);
         return stepOutcome(stepName, false, giResult.message, details, giResult.error ?? null);
     }
     Object.assign(details, giResult.details);
-    const gaResult = ensureGitattributesMergeUnion(gitattributesPath, stepName);
+    const gaResult = ensureGitattributesMergeUnion(gitattributesPath, stepName, glob, ruleLine);
     if (!gaResult.ok) {
         Object.assign(details, gaResult.details);
         return stepOutcome(stepName, false, gaResult.message, details, gaResult.error ?? null);
     }
     Object.assign(details, gaResult.details);
-    const rdResult = ensureEvalReadme(readmePath, readmeRel, stepName);
+    const rdResult = ensureEvalReadme({ projectRoot, readmePath, readmeRel, stepName });
     if (!rdResult.ok) {
         Object.assign(details, rdResult.details);
         return stepOutcome(stepName, false, rdResult.message, details, rdResult.error ?? null);
@@ -386,11 +423,11 @@ export function stepEnsureGitignoreEvalEntries(projectRoot) {
     message += formatBlanketWarning(Boolean(details.blanket_present));
     return stepOutcome(stepName, true, message, details);
 }
-/** Ensure `vbrief/.eval/candidates.jsonl` exists (#1240 option A). */
+/** Ensure `vbrief/.triage-cache/candidates.jsonl` exists (#1240 option A). */
 export function stepSeedCandidatesLog(projectRoot) {
     // Layout-aware (#2109): seed under the active lifecycle `.eval` dir (xbrief/
     // when migrated, else vbrief/) instead of a hardcoded vbrief/ path.
-    const auditPath = resolveEvalPath(projectRoot, "candidates.jsonl");
+    const auditPath = resolveCandidatesLogPath(projectRoot);
     const auditRel = evalRelDisplay(projectRoot, auditPath);
     const auditDir = dirname(auditPath);
     try {

package/dist/triage/bootstrap/index.d.ts

@@ -2,7 +2,7 @@ import type { BootstrapResult, CacheModule, RunBootstrapOptions, StepOutcome } f
 export * from "./gitignore.js";
 export * from "./types.js";
 export declare const CACHE_DIR_NAME = ".deft-cache";
-export declare const AUDIT_LOG_RELPATH = "vbrief/.eval/candidates.jsonl";
+export declare const AUDIT_LOG_RELPATH = "vbrief/.triage-cache/candidates.jsonl";
 export declare const BACKFILL_FOLDERS: readonly ["proposed", "pending", "active"];
 export declare const BOOTSTRAP_ACTOR = "agent:bootstrap";
 export declare const DEFAULT_FETCH_TIMEOUT_S = 3600;

package/dist/triage/bootstrap/index.js

@@ -3,14 +3,15 @@ import { randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { promisify } from "node:util";
-import { hasArtifactSuffix, resolveEvalPath, resolveLifecycleRoot } from "../../layout/resolve.js";
+import { hasArtifactSuffix, resolveLifecycleRoot } from "../../layout/resolve.js";
 import { SUBPROCESS_MAX_BUFFER } from "../../subprocess/max-buffer.js";
+import { resolveCandidatesLogPath } from "../cache-path.js";
 import { stepEnsureGitignoreEntry, stepEnsureGitignoreEvalEntries, stepSeedCandidatesLog, } from "./gitignore.js";
 import { PROGRESS_DEFAULT } from "./types.js";
 export * from "./gitignore.js";
 export * from "./types.js";
 export const CACHE_DIR_NAME = ".deft-cache";
-export const AUDIT_LOG_RELPATH = "vbrief/.eval/candidates.jsonl";
+export const AUDIT_LOG_RELPATH = "vbrief/.triage-cache/candidates.jsonl";
 export const BACKFILL_FOLDERS = ["proposed", "pending", "active"];
 export const BOOTSTRAP_ACTOR = "agent:bootstrap";
 export const DEFAULT_FETCH_TIMEOUT_S = 3600;
@@ -377,7 +378,7 @@ export function stepBackfillAuditLog(projectRoot, repo, options = {}) {
     if (!existsSync(vbriefRoot)) {
         return stepOutcome("backfill_audit_log", true, `skipped (no vbrief/ directory under ${projectRoot})`, { skipped: "no-vbrief" });
     }
-    const auditPath = resolveEvalPath(projectRoot, "candidates.jsonl");
+    const auditPath = resolveCandidatesLogPath(projectRoot);
     const alreadyLogged = existingAuditIssueNumbers(auditPath);
     const nowIso = options.nowIso ?? nowIsoDefault;
     const appendEntry = options.appendAuditEntry ?? appendAuditEntryDefault;

package/dist/triage/bulk/index.js

@@ -1,8 +1,8 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { resolveEvalPath } from "../../layout/resolve.js";
 import { createDefaultDeps, accept as nativeAccept, deferAction as nativeDefer, needsAc as nativeNeedsAc, reject as nativeReject, } from "../actions/index.js";
+import { resolveCandidatesLogPath } from "../cache-path.js";
 export const ACTION_FN_NAMES = {
     accept: "accept",
     reject: "reject",
@@ -377,7 +377,7 @@ export function createFilesystemCacheModule() {
         CacheError,
     };
 }
-export function createFilesystemCandidatesLogModule(logPath = resolveEvalPath(process.cwd(), "candidates.jsonl")) {
+export function createFilesystemCandidatesLogModule(logPath = resolveCandidatesLogPath(process.cwd())) {
     return {
         readAll(options) {
             if (!existsSync(logPath)) {

package/dist/triage/cache-path.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Layout-aware triage working-set cache paths (#1703 namespace cleanup).
+ *
+ * Triage append-only logs and scratch dirs live under `.triage-cache/` so the
+ * `.eval/` namespace can be reclaimed for version-eval results (#1703 Tier 2).
+ */
+/** Directory name for the triage working-set cache (not version-eval results). */
+export declare const TRIAGE_CACHE_DIR_NAME = ".triage-cache";
+/** Legacy directory that previously held triage cache files before #1703. */
+export declare const LEGACY_TRIAGE_EVAL_DIR_NAME = ".eval";
+/** Known triage-cache file basenames migrated off the legacy `.eval/` tree. */
+export declare const TRIAGE_CACHE_FILE_NAMES: readonly ["candidates.jsonl", "summary-history.jsonl", "scope-lifecycle.jsonl", "subscription-history.jsonl", "slices.jsonl", "doctor-state.json", "README.md"];
+/** Known triage-cache directory names migrated off the legacy `.eval/` tree. */
+export declare const TRIAGE_CACHE_DIR_NAMES: readonly ["decompositions"];
+export interface TriageCacheMigrationResult {
+    readonly migratedFiles: readonly string[];
+    readonly skippedFiles: readonly string[];
+    readonly migratedDirs: readonly string[];
+    readonly regeneratedFiles: readonly string[];
+    readonly removedLegacyFiles: readonly string[];
+}
+/** Absolute path to the layout-aware `.triage-cache/` directory. */
+export declare function resolveTriageCacheDir(projectRoot: string): string;
+/** POSIX-style path relative to project root (e.g. `xbrief/.triage-cache/foo`). */
+export declare function triageCacheRelPath(projectRoot: string, ...segments: string[]): string;
+/**
+ * Idempotently move triage working-set artefacts from legacy `.eval/` into
+ * `.triage-cache/` when the new location is absent.
+ */
+export declare function migrateLegacyTriageCacheFromEval(projectRoot: string): TriageCacheMigrationResult;
+/** Resolve a path under `.triage-cache/`, migrating legacy `.eval/` files first. */
+export declare function resolveTriageCachePath(projectRoot: string, ...segments: string[]): string;
+/** Display helper: project-root-relative POSIX path for logs and gitignore copy. */
+export declare function triageCacheDisplayPath(projectRoot: string, absPath: string): string;
+/** Back-compat display constant; resolution flows through `resolveTriageCachePath`. */
+export declare const TRIAGE_CANDIDATES_LOG_REL_PATH = "vbrief/.triage-cache/candidates.jsonl";
+/** Layout-aware candidates audit-log path. */
+export declare function resolveCandidatesLogPath(projectRoot: string): string;
+/** Ensure the triage cache directory exists (post-migration). */
+export declare function ensureTriageCacheDir(projectRoot: string): string;
+//# sourceMappingURL=cache-path.d.ts.map

package/dist/triage/cache-path.js

@@ -0,0 +1,115 @@
+/**
+ * Layout-aware triage working-set cache paths (#1703 namespace cleanup).
+ *
+ * Triage append-only logs and scratch dirs live under `.triage-cache/` so the
+ * `.eval/` namespace can be reclaimed for version-eval results (#1703 Tier 2).
+ */
+import { existsSync, mkdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { join, relative } from "node:path";
+import { resolveEvalDir, resolveLifecycleLayout, resolveLifecycleRoot } from "../layout/resolve.js";
+import { generateTriageCacheReadmeBody } from "./bootstrap/gitignore.js";
+/** Directory name for the triage working-set cache (not version-eval results). */
+export const TRIAGE_CACHE_DIR_NAME = ".triage-cache";
+/** Legacy directory that previously held triage cache files before #1703. */
+export const LEGACY_TRIAGE_EVAL_DIR_NAME = ".eval";
+/** Known triage-cache file basenames migrated off the legacy `.eval/` tree. */
+export const TRIAGE_CACHE_FILE_NAMES = [
+    "candidates.jsonl",
+    "summary-history.jsonl",
+    "scope-lifecycle.jsonl",
+    "subscription-history.jsonl",
+    "slices.jsonl",
+    "doctor-state.json",
+    "README.md",
+];
+/** Known triage-cache directory names migrated off the legacy `.eval/` tree. */
+export const TRIAGE_CACHE_DIR_NAMES = ["decompositions"];
+/** Absolute path to the layout-aware `.triage-cache/` directory. */
+export function resolveTriageCacheDir(projectRoot) {
+    return join(resolveLifecycleRoot(projectRoot), TRIAGE_CACHE_DIR_NAME);
+}
+/** POSIX-style path relative to project root (e.g. `xbrief/.triage-cache/foo`). */
+export function triageCacheRelPath(projectRoot, ...segments) {
+    const layout = resolveLifecycleLayout(projectRoot);
+    return [layout.artifactDir, TRIAGE_CACHE_DIR_NAME, ...segments].join("/");
+}
+/**
+ * Idempotently move triage working-set artefacts from legacy `.eval/` into
+ * `.triage-cache/` when the new location is absent.
+ */
+export function migrateLegacyTriageCacheFromEval(projectRoot) {
+    const legacyDir = resolveEvalDir(projectRoot);
+    const targetDir = resolveTriageCacheDir(projectRoot);
+    const migratedFiles = [];
+    const skippedFiles = [];
+    const migratedDirs = [];
+    const regeneratedFiles = [];
+    const removedLegacyFiles = [];
+    if (!existsSync(legacyDir)) {
+        return { migratedFiles, skippedFiles, migratedDirs, regeneratedFiles, removedLegacyFiles };
+    }
+    mkdirSync(targetDir, { recursive: true });
+    for (const name of TRIAGE_CACHE_FILE_NAMES) {
+        const legacyPath = join(legacyDir, name);
+        const targetPath = join(targetDir, name);
+        if (!existsSync(legacyPath)) {
+            continue;
+        }
+        if (name === "README.md") {
+            if (existsSync(targetPath)) {
+                unlinkSync(legacyPath);
+                removedLegacyFiles.push(name);
+            }
+            else {
+                writeFileSync(targetPath, generateTriageCacheReadmeBody(projectRoot), "utf8");
+                unlinkSync(legacyPath);
+                regeneratedFiles.push(name);
+            }
+            continue;
+        }
+        if (existsSync(targetPath)) {
+            unlinkSync(legacyPath);
+            removedLegacyFiles.push(name);
+            continue;
+        }
+        renameSync(legacyPath, targetPath);
+        migratedFiles.push(name);
+    }
+    for (const name of TRIAGE_CACHE_DIR_NAMES) {
+        const legacyPath = join(legacyDir, name);
+        const targetPath = join(targetDir, name);
+        if (!existsSync(legacyPath)) {
+            continue;
+        }
+        if (existsSync(targetPath)) {
+            skippedFiles.push(`${name}/`);
+            continue;
+        }
+        renameSync(legacyPath, targetPath);
+        migratedDirs.push(name);
+    }
+    return { migratedFiles, skippedFiles, migratedDirs, regeneratedFiles, removedLegacyFiles };
+}
+/** Resolve a path under `.triage-cache/`, migrating legacy `.eval/` files first. */
+export function resolveTriageCachePath(projectRoot, ...segments) {
+    migrateLegacyTriageCacheFromEval(projectRoot);
+    return join(resolveTriageCacheDir(projectRoot), ...segments);
+}
+/** Display helper: project-root-relative POSIX path for logs and gitignore copy. */
+export function triageCacheDisplayPath(projectRoot, absPath) {
+    return relative(projectRoot, absPath).split(/[\\/]/).join("/");
+}
+/** Back-compat display constant; resolution flows through `resolveTriageCachePath`. */
+export const TRIAGE_CANDIDATES_LOG_REL_PATH = "vbrief/.triage-cache/candidates.jsonl";
+/** Layout-aware candidates audit-log path. */
+export function resolveCandidatesLogPath(projectRoot) {
+    return resolveTriageCachePath(projectRoot, "candidates.jsonl");
+}
+/** Ensure the triage cache directory exists (post-migration). */
+export function ensureTriageCacheDir(projectRoot) {
+    migrateLegacyTriageCacheFromEval(projectRoot);
+    const dir = resolveTriageCacheDir(projectRoot);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+//# sourceMappingURL=cache-path.js.map

package/dist/triage/help/registry-data.d.ts

@@ -5,7 +5,7 @@ export declare const registryData: {
             readonly name: "task triage:summary";
             readonly summary: "One-line state for session-start ritual";
             readonly refs: "(D2 / #1122)";
-            readonly description: "Emit the one-line triage state consumed by the session-start ritual. Always exits 0 (status surface, not a gate); appends a JSONL record to vbrief/.eval/summary-history.jsonl for observability.";
+            readonly description: "Emit the one-line triage state consumed by the session-start ritual. Always exits 0 (status surface, not a gate); appends a JSONL record to vbrief/.triage-cache/summary-history.jsonl for observability.";
             readonly usage: "task triage:summary [-- --json] [--no-history]";
             readonly flags: readonly [readonly ["--json", "(off)", "Emit the structured record as JSON instead of the one-liner."], readonly ["--no-history", "(off)", "Suppress the history sidecar append (test-only)."], readonly ["--project-root PATH", "(cwd)", "Project root override (Taskfile threads USER_WORKING_DIR)."]];
             readonly examples: readonly ["task triage:summary", "task triage:summary -- --json | jq"];
@@ -203,7 +203,7 @@ export declare const registryData: {
             readonly name: "task triage:reconcile";
             readonly summary: "Self-heal audit log from on-disk vBRIEFs";
             readonly refs: "(#1468)";
-            readonly description: "Idempotent repair verb: derive missing `accept` decisions for proposed/pending/active vBRIEFs that carry an x-vbrief/github-issue reference but have no entry in vbrief/.eval/candidates.jsonl. Recovers triage state after the gitignored audit log is reset/lost (#1464) without a full cache re-fetch. Never overrides an existing decision, so a re-run is a no-op.";
+            readonly description: "Idempotent repair verb: derive missing `accept` decisions for proposed/pending/active vBRIEFs that carry an x-vbrief/github-issue reference but have no entry in vbrief/.triage-cache/candidates.jsonl. Recovers triage state after the gitignored audit log is reset/lost (#1464) without a full cache re-fetch. Never overrides an existing decision, so a re-run is a no-op.";
             readonly usage: "task triage:reconcile [-- --repo owner/name] [--dry-run] [--json]";
             readonly flags: readonly [readonly ["--repo owner/name", "(ref URI / git remote)", "Fallback repo for refs lacking owner/name."], readonly ["--dry-run", "(off)", "Report what would be restored without writing."], readonly ["--json", "(off)", "Structured JSON output."]];
             readonly examples: readonly ["task triage:reconcile -- --dry-run", "task triage:reconcile -- --repo deftai/directive"];
@@ -280,7 +280,7 @@ export declare const registryData: {
             readonly name: "task triage:subscribe";
             readonly summary: "Add label/milestone/issue to subscription";
             readonly refs: "(D14 / #1133)";
-            readonly description: "Subscribe to a label / milestone / issue by appending a rule to plan.policy.triageScope[]. Emits a JSONL audit record to vbrief/.eval/subscription-history.jsonl.";
+            readonly description: "Subscribe to a label / milestone / issue by appending a rule to plan.policy.triageScope[]. Emits a JSONL audit record to vbrief/.triage-cache/subscription-history.jsonl.";
             readonly usage: "task triage:subscribe -- (--label=L | --milestone=M | --issue=N)";
             readonly flags: readonly [readonly ["--label L", "(none)", "Subscribe to a label."], readonly ["--milestone M", "(none)", "Subscribe to a milestone."], readonly ["--issue N", "(none)", "Subscribe to a single issue."]];
             readonly examples: readonly ["task triage:subscribe -- --label='area:swarm'", "task triage:subscribe -- --milestone='v0.32.0'"];
@@ -335,7 +335,7 @@ export declare const registryData: {
             readonly name: "task triage:audit-log:rotate";
             readonly summary: "Rotate candidates.jsonl when bounded";
             readonly refs: "(D20, coming)";
-            readonly description: "Rotate vbrief/.eval/candidates.jsonl when it exceeds the configured bound. Compacts terminal entries and preserves the open-work tail.";
+            readonly description: "Rotate vbrief/.triage-cache/candidates.jsonl when it exceeds the configured bound. Compacts terminal entries and preserves the open-work tail.";
             readonly usage: "task triage:audit-log:rotate [-- --max-lines N]";
             readonly flags: readonly [readonly ["--max-lines N", "(consumer default)", "Bound at which rotation fires."]];
             readonly examples: readonly ["task triage:audit-log:rotate -- --max-lines 10000"];
@@ -344,14 +344,47 @@ export declare const registryData: {
         };
         readonly "task triage:metrics": {
             readonly name: "task triage:metrics";
-            readonly summary: "Trend lines from summary-history.jsonl";
-            readonly refs: "(D17, coming)";
-            readonly description: "Print trend lines computed from vbrief/.eval/summary-history.jsonl: decisions-per-day, defer/accept ratio, stale-defer drift, etc.";
+            readonly summary: "Attributed-value trend from the events ledger";
+            readonly refs: "(#1709)";
+            readonly description: "Report value-feedback attribution trends from .deft-cache/events.jsonl: total signal count plus per-class (value, bypass, adoption, friction) and per-event breakdowns over a time window. Alias of the value:show handler. Requires plan.policy.valueFeedback.enabled (default OFF) — exits blocked when disabled; an empty ledger prints a no-signals message. In the maintainer repo, skipped unless DEFT_VALUE_SELF_DOGFOOD=1.";
             readonly usage: "task triage:metrics [-- --window=7d] [--format=text|json]";
-            readonly flags: readonly [readonly ["--window WINDOW", "7d", "Time window over which to aggregate."], readonly ["--format text|json", "text", "Output shape."]];
-            readonly examples: readonly ["task triage:metrics -- --window 30d"];
-            readonly see_also: readonly ["task triage:summary", "#1119 / D17"];
-            readonly placeholder: true;
+            readonly flags: readonly [readonly ["--window WINDOW", "7d", "Time window (e.g. 7d, 30d, 24h)."], readonly ["--format text|json", "text", "Output shape (json emits the full trend object)."]];
+            readonly examples: readonly ["task triage:metrics", "task triage:metrics -- --window=30d --format=json"];
+            readonly see_also: readonly ["task policy:show --field=valueFeedback", "task policy:enable-value-feedback -- --confirm", "#1709"];
+            readonly placeholder: false;
+        };
+        readonly "task eval:health": {
+            readonly name: "task eval:health";
+            readonly summary: "Tier 0 static framework health score";
+            readonly refs: "(#1703)";
+            readonly description: "Aggregate static self-consistency gates (encoding, links, vBRIEF conformance, AGENTS.md freshness; content-manifest on framework-source trees) into a versioned 0–100 score. Detects contradictory / unsatisfiable gate pairs (#1694). Appends each run to .eval/results/health-history.jsonl. Session start may emit a budgeted [eval] advisory when health degrades.";
+            readonly usage: "task eval:health [-- --json] [--no-persist] [--project-root PATH]";
+            readonly flags: readonly [readonly ["--json", "(off)", "Emit the structured HealthReport instead of the human summary."], readonly ["--no-persist", "(off)", "Run probes without appending to the health history ledger."], readonly ["--project-root PATH", "(cwd)", "Project root override (Taskfile threads USER_WORKING_DIR)."]];
+            readonly examples: readonly ["task eval:health", "task eval:health -- --json"];
+            readonly see_also: readonly ["task eval:run", "task eval:report", "#1703"];
+            readonly placeholder: false;
+        };
+        readonly "task eval:run": {
+            readonly name: "task eval:run";
+            readonly summary: "Tier 2 golden corpus eval for a model";
+            readonly refs: "(#1703)";
+            readonly description: "Execute the fixed golden corpus with objective graders (CRUD schema/invention, surgical update, health fixture, rotating holdout tasks). Persists results to .eval/results/golden-runs.jsonl for champion–challenger diffs.";
+            readonly usage: "task eval:run -- --model MODEL [--seed N] [--directive-version V] [--harness NAME] [--json] [--no-persist]";
+            readonly flags: readonly [readonly ["--model MODEL", "(required)", "Model identifier for the run record."], readonly ["--seed N", "(1,2,3)", "Repeatable seed(s); pass multiple --seed flags."], readonly ["--directive-version V", "(engine version)", "Pin the directive version label."], readonly ["--harness NAME", "deterministic-fixture", "Harness label stored on the run record."], readonly ["--json", "(off)", "Emit the GoldenRunRecord JSON."], readonly ["--no-persist", "(off)", "Run without appending to golden-runs.jsonl."], readonly ["--project-root PATH", "(cwd)", "Project root override (Taskfile threads USER_WORKING_DIR)."]];
+            readonly examples: readonly ["task eval:run -- --model gpt-5", "task eval:run -- --model claude-sonnet --seed 1 --seed 2 --json"];
+            readonly see_also: readonly ["task eval:report", "task eval:health", "#1703"];
+            readonly placeholder: false;
+        };
+        readonly "task eval:report": {
+            readonly name: "task eval:report";
+            readonly summary: "Tier 2 champion–challenger diff with significance";
+            readonly refs: "(#1703)";
+            readonly description: "Diff two directive versions' latest golden runs for a model: primary/holdout/overall pass-rate deltas with two-proportion significance and a holdout tripwire when primary gains do not generalize (#1703 Goodhart guard).";
+            readonly usage: "task eval:report -- --champion V --challenger V --model MODEL [--json] [--project-root PATH]";
+            readonly flags: readonly [readonly ["--champion V", "(required)", "Baseline directive version."], readonly ["--challenger V", "(required)", "Candidate directive version."], readonly ["--model MODEL", "(required)", "Model identifier shared by both runs."], readonly ["--json", "(off)", "Emit the GoldenEvalReport JSON."], readonly ["--project-root PATH", "(cwd)", "Project root override (Taskfile threads USER_WORKING_DIR)."]];
+            readonly examples: readonly ["task eval:report -- --champion 0.58.0 --challenger 0.59.0 --model gpt-5"];
+            readonly see_also: readonly ["task eval:run", "task eval:health", "#1703"];
+            readonly placeholder: false;
         };
         readonly "task scope:promote": {
             readonly name: "task scope:promote";
@@ -368,7 +401,7 @@ export declare const registryData: {
             readonly name: "task scope:demote";
             readonly summary: "pending/ -> proposed/ (set status proposed)";
             readonly refs: "(D1 / #1121)";
-            readonly description: "Demote a vBRIEF scope from vbrief/pending/ back to vbrief/proposed/ and append a structured audit entry (including a demote_meta block) to vbrief/.eval/scope-lifecycle.jsonl. Supports single-file and --batch (cohort shrink / cap relief) modes.";
+            readonly description: "Demote a vBRIEF scope from vbrief/pending/ back to vbrief/proposed/ and append a structured audit entry (including a demote_meta block) to vbrief/.triage-cache/scope-lifecycle.jsonl. Supports single-file and --batch (cohort shrink / cap relief) modes.";
             readonly usage: "task scope:demote -- <file> [--reason TEXT] | task scope:demote -- --batch [--older-than-days N]";
             readonly flags: readonly [readonly ["<file>", "(required for single)", "Path to vBRIEF."], readonly ["--batch", "(off)", "Batch mode: demote every pending older than --older-than-days."], readonly ["--older-than-days N", "45", "Batch-mode age threshold."], readonly ["--reason TEXT", "operator-requested", "Free-text reason for single-demote."], readonly ["--actor STR", "operator", "Actor identity recorded in the audit entry."]];
             readonly examples: readonly ["task scope:demote -- vbrief/pending/2026-05-19-foo.vbrief.json", "task scope:demote -- --batch --older-than-days 60"];
@@ -469,13 +502,13 @@ export declare const registryData: {
             readonly refs: "(deft-directive-decompose skill)";
             readonly description: "Validate or apply an approved epic/phase -> story decomposition draft. The draft is a temporary proposal artifact, not a vBRIEF. Writes pending child vBRIEFs and wires references back into the parent epic.";
             readonly usage: "task scope:decompose -- <parent> --draft <draft> [--check] [--date YYYY-MM-DD]";
-            readonly flags: readonly [readonly ["<parent>", "(conditional)", "Parent epic/phase vBRIEF path; required with --draft, omit only for --check no-op."], readonly ["--draft PATH", "(required)", "Approved decomposition JSON draft; prefer vbrief/.eval/decompositions/<parent-slug>.json."], readonly ["--check", "(off)", "Validate only; do not write."], readonly ["--date YYYY-MM-DD", "today", "Creation date for generated child filenames."]];
-            readonly examples: readonly ["task scope:decompose -- vbrief/active/epic.vbrief.json --draft vbrief/.eval/decompositions/epic.json --check"];
+            readonly flags: readonly [readonly ["<parent>", "(conditional)", "Parent epic/phase vBRIEF path; required with --draft, omit only for --check no-op."], readonly ["--draft PATH", "(required)", "Approved decomposition JSON draft; prefer vbrief/.triage-cache/decompositions/<parent-slug>.json."], readonly ["--check", "(off)", "Validate only; do not write."], readonly ["--date YYYY-MM-DD", "today", "Creation date for generated child filenames."]];
+            readonly examples: readonly ["task scope:decompose -- vbrief/active/epic.vbrief.json --draft vbrief/.triage-cache/decompositions/epic.json --check"];
             readonly see_also: readonly ["task scope:promote", "skills/deft-directive-decompose/SKILL.md"];
             readonly placeholder: false;
         };
     };
-    readonly categoriesTriage: readonly [readonly ["Session-start", readonly ["task triage:summary", "task verify:cache-fresh"]], readonly ["State verbs (mutate audit log)", readonly ["task triage:accept", "task triage:defer", "task triage:reject", "task triage:needs-ac", "task triage:mark-duplicate", "task triage:reset", "task triage:status", "task triage:history"]], readonly ["Read verbs", readonly ["task triage:queue", "task triage:audit", "task triage:show", "task triage:scope", "task triage:scope-drift", "task triage:classify"]], readonly ["Lifecycle", readonly ["task triage:bootstrap", "task triage:welcome", "task triage:reconcile"]], readonly ["Bulk variants", readonly ["task triage:bulk-accept", "task triage:bulk-reject", "task triage:bulk-defer", "task triage:bulk-needs-ac", "task triage:refresh-active", "task triage:smoketest"]], readonly ["Subscription mutation", readonly ["task triage:subscribe", "task triage:unsubscribe"]], readonly ["Archive / rotation", readonly ["task triage:audit:prune", "task triage:archive-list", "task triage:restore-from-archive", "task triage:audit-log:rotate", "task triage:metrics"]]];
+    readonly categoriesTriage: readonly [readonly ["Session-start", readonly ["task triage:summary", "task verify:cache-fresh"]], readonly ["State verbs (mutate audit log)", readonly ["task triage:accept", "task triage:defer", "task triage:reject", "task triage:needs-ac", "task triage:mark-duplicate", "task triage:reset", "task triage:status", "task triage:history"]], readonly ["Read verbs", readonly ["task triage:queue", "task triage:audit", "task triage:show", "task triage:scope", "task triage:scope-drift", "task triage:classify"]], readonly ["Lifecycle", readonly ["task triage:bootstrap", "task triage:welcome", "task triage:reconcile"]], readonly ["Bulk variants", readonly ["task triage:bulk-accept", "task triage:bulk-reject", "task triage:bulk-defer", "task triage:bulk-needs-ac", "task triage:refresh-active", "task triage:smoketest"]], readonly ["Subscription mutation", readonly ["task triage:subscribe", "task triage:unsubscribe"]], readonly ["Archive / rotation", readonly ["task triage:audit:prune", "task triage:archive-list", "task triage:restore-from-archive", "task triage:audit-log:rotate", "task triage:metrics"]], readonly ["Framework eval (#1703)", readonly ["task eval:health", "task eval:run", "task eval:report"]]];
     readonly categoriesScope: readonly [readonly ["Promote / demote", readonly ["task scope:promote", "task scope:demote"]], readonly ["Activate / complete", readonly ["task scope:activate", "task scope:complete", "task scope:fail", "task scope:cancel", "task scope:block", "task scope:unblock"]], readonly ["Reversibility", readonly ["task scope:undo", "task scope:restore"]], readonly ["Decomposition", readonly ["task scope:decompose"]]];
     readonly scriptSubcommandMap: {
         readonly triage_actions: {