@deftai/directive-core 0.70.0 → 0.71.1

package/dist/triage/help/registry-data.js

@@ -5,7 +5,7 @@ export const registryData = {
             name: "task triage:summary",
             summary: "One-line state for session-start ritual",
             refs: "(D2 / #1122)",
-            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.",
+            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.",
             usage: "task triage:summary [-- --json] [--no-history]",
             flags: [
                 ["--json", "(off)", "Emit the structured record as JSON instead of the one-liner."],
@@ -321,7 +321,7 @@ export const registryData = {
             name: "task triage:reconcile",
             summary: "Self-heal audit log from on-disk vBRIEFs",
             refs: "(#1468)",
-            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.",
+            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.",
             usage: "task triage:reconcile [-- --repo owner/name] [--dry-run] [--json]",
             flags: [
                 [
@@ -435,7 +435,7 @@ export const registryData = {
             name: "task triage:subscribe",
             summary: "Add label/milestone/issue to subscription",
             refs: "(D14 / #1133)",
-            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.",
+            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.",
             usage: "task triage:subscribe -- (--label=L | --milestone=M | --issue=N)",
             flags: [
                 ["--label L", "(none)", "Subscribe to a label."],
@@ -504,7 +504,7 @@ export const registryData = {
             name: "task triage:audit-log:rotate",
             summary: "Rotate candidates.jsonl when bounded",
             refs: "(D20, coming)",
-            description: "Rotate vbrief/.eval/candidates.jsonl when it exceeds the configured bound. Compacts terminal entries and preserves the open-work tail.",
+            description: "Rotate vbrief/.triage-cache/candidates.jsonl when it exceeds the configured bound. Compacts terminal entries and preserves the open-work tail.",
             usage: "task triage:audit-log:rotate [-- --max-lines N]",
             flags: [["--max-lines N", "(consumer default)", "Bound at which rotation fires."]],
             examples: ["task triage:audit-log:rotate -- --max-lines 10000"],
@@ -513,17 +513,87 @@ export const registryData = {
         },
         "task triage:metrics": {
             name: "task triage:metrics",
-            summary: "Trend lines from summary-history.jsonl",
-            refs: "(D17, coming)",
-            description: "Print trend lines computed from vbrief/.eval/summary-history.jsonl: decisions-per-day, defer/accept ratio, stale-defer drift, etc.",
+            summary: "Attributed-value trend from the events ledger",
+            refs: "(#1709)",
+            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.",
             usage: "task triage:metrics [-- --window=7d] [--format=text|json]",
             flags: [
-                ["--window WINDOW", "7d", "Time window over which to aggregate."],
-                ["--format text|json", "text", "Output shape."],
+                ["--window WINDOW", "7d", "Time window (e.g. 7d, 30d, 24h)."],
+                ["--format text|json", "text", "Output shape (json emits the full trend object)."],
             ],
-            examples: ["task triage:metrics -- --window 30d"],
-            see_also: ["task triage:summary", "#1119 / D17"],
-            placeholder: true,
+            examples: ["task triage:metrics", "task triage:metrics -- --window=30d --format=json"],
+            see_also: [
+                "task policy:show --field=valueFeedback",
+                "task policy:enable-value-feedback -- --confirm",
+                "#1709",
+            ],
+            placeholder: false,
+        },
+        "task eval:health": {
+            name: "task eval:health",
+            summary: "Tier 0 static framework health score",
+            refs: "(#1703)",
+            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.",
+            usage: "task eval:health [-- --json] [--no-persist] [--project-root PATH]",
+            flags: [
+                ["--json", "(off)", "Emit the structured HealthReport instead of the human summary."],
+                ["--no-persist", "(off)", "Run probes without appending to the health history ledger."],
+                [
+                    "--project-root PATH",
+                    "(cwd)",
+                    "Project root override (Taskfile threads USER_WORKING_DIR).",
+                ],
+            ],
+            examples: ["task eval:health", "task eval:health -- --json"],
+            see_also: ["task eval:run", "task eval:report", "#1703"],
+            placeholder: false,
+        },
+        "task eval:run": {
+            name: "task eval:run",
+            summary: "Tier 2 golden corpus eval for a model",
+            refs: "(#1703)",
+            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.",
+            usage: "task eval:run -- --model MODEL [--seed N] [--directive-version V] [--harness NAME] [--json] [--no-persist]",
+            flags: [
+                ["--model MODEL", "(required)", "Model identifier for the run record."],
+                ["--seed N", "(1,2,3)", "Repeatable seed(s); pass multiple --seed flags."],
+                ["--directive-version V", "(engine version)", "Pin the directive version label."],
+                ["--harness NAME", "deterministic-fixture", "Harness label stored on the run record."],
+                ["--json", "(off)", "Emit the GoldenRunRecord JSON."],
+                ["--no-persist", "(off)", "Run without appending to golden-runs.jsonl."],
+                [
+                    "--project-root PATH",
+                    "(cwd)",
+                    "Project root override (Taskfile threads USER_WORKING_DIR).",
+                ],
+            ],
+            examples: [
+                "task eval:run -- --model gpt-5",
+                "task eval:run -- --model claude-sonnet --seed 1 --seed 2 --json",
+            ],
+            see_also: ["task eval:report", "task eval:health", "#1703"],
+            placeholder: false,
+        },
+        "task eval:report": {
+            name: "task eval:report",
+            summary: "Tier 2 champion–challenger diff with significance",
+            refs: "(#1703)",
+            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).",
+            usage: "task eval:report -- --champion V --challenger V --model MODEL [--json] [--project-root PATH]",
+            flags: [
+                ["--champion V", "(required)", "Baseline directive version."],
+                ["--challenger V", "(required)", "Candidate directive version."],
+                ["--model MODEL", "(required)", "Model identifier shared by both runs."],
+                ["--json", "(off)", "Emit the GoldenEvalReport JSON."],
+                [
+                    "--project-root PATH",
+                    "(cwd)",
+                    "Project root override (Taskfile threads USER_WORKING_DIR).",
+                ],
+            ],
+            examples: ["task eval:report -- --champion 0.58.0 --challenger 0.59.0 --model gpt-5"],
+            see_also: ["task eval:run", "task eval:health", "#1703"],
+            placeholder: false,
         },
         "task scope:promote": {
             name: "task scope:promote",
@@ -548,7 +618,7 @@ export const registryData = {
             name: "task scope:demote",
             summary: "pending/ -> proposed/ (set status proposed)",
             refs: "(D1 / #1121)",
-            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.",
+            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.",
             usage: "task scope:demote -- <file> [--reason TEXT] | task scope:demote -- --batch [--older-than-days N]",
             flags: [
                 ["<file>", "(required for single)", "Path to vBRIEF."],
@@ -698,13 +768,13 @@ export const registryData = {
                 [
                     "--draft PATH",
                     "(required)",
-                    "Approved decomposition JSON draft; prefer vbrief/.eval/decompositions/<parent-slug>.json.",
+                    "Approved decomposition JSON draft; prefer vbrief/.triage-cache/decompositions/<parent-slug>.json.",
                 ],
                 ["--check", "(off)", "Validate only; do not write."],
                 ["--date YYYY-MM-DD", "today", "Creation date for generated child filenames."],
             ],
             examples: [
-                "task scope:decompose -- vbrief/active/epic.vbrief.json --draft vbrief/.eval/decompositions/epic.json --check",
+                "task scope:decompose -- vbrief/active/epic.vbrief.json --draft vbrief/.triage-cache/decompositions/epic.json --check",
             ],
             see_also: ["task scope:promote", "skills/deft-directive-decompose/SKILL.md"],
             placeholder: false,
@@ -759,6 +829,7 @@ export const registryData = {
                 "task triage:metrics",
             ],
         ],
+        ["Framework eval (#1703)", ["task eval:health", "task eval:run", "task eval:report"]],
     ],
     categoriesScope: [
         ["Promote / demote", ["task scope:promote", "task scope:demote"]],

package/dist/triage/index.d.ts

@@ -9,6 +9,8 @@
 export * as actions from "./actions/index.js";
 export * as bootstrap from "./bootstrap/index.js";
 export * as bulk from "./bulk/index.js";
+export * as cachePath from "./cache-path.js";
+export * from "./cache-path.js";
 export * as classify from "./classify/index.js";
 export * as help from "./help/index.js";
 export * as queue from "./queue/index.js";

package/dist/triage/index.js

@@ -9,6 +9,8 @@
 export * as actions from "./actions/index.js";
 export * as bootstrap from "./bootstrap/index.js";
 export * as bulk from "./bulk/index.js";
+export * as cachePath from "./cache-path.js";
+export * from "./cache-path.js";
 export * as classify from "./classify/index.js";
 export * as help from "./help/index.js";
 export * as queue from "./queue/index.js";

package/dist/triage/queue/audit.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
-import { resolveEvalPath } from "../../layout/resolve.js";
+import { resolveCandidatesLogPath } from "../cache-path.js";
 /** Resolve audit log path; mirrors candidates_log._resolve_path (framework root). */
 export function resolveAuditLogPath(options = {}) {
     if (options.auditLogPath !== null && options.auditLogPath !== undefined) {
@@ -12,7 +12,7 @@ export function resolveAuditLogPath(options = {}) {
         : envRoot.length > 0
             ? resolve(envRoot)
             : process.cwd();
-    return resolveEvalPath(root, "candidates.jsonl");
+    return resolveCandidatesLogPath(root);
 }
 /** Read audit log entries, optionally filtered by repo. */
 export function readAuditEntries(repo, options = {}) {

package/dist/triage/queue/cache.js

@@ -1,6 +1,6 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { resolveEvalPath } from "../../layout/resolve.js";
+import { resolveTriageCachePath } from "../cache-path.js";
 import { extractAuthor, extractMilestone } from "../scope-drift/cache-walker.js";
 import { CACHE_DIR_NAME, CACHE_SOURCE_GITHUB_ISSUE } from "./constants.js";
 import { hasActiveScopeIgnores, isRawIssueScopeIgnored, resolveScopeIgnores, } from "./scope-ignores-filter.js";
@@ -23,7 +23,7 @@ export function resolveSlicesLogPath(options = {}) {
         : envRoot.length > 0
             ? resolve(envRoot)
             : process.cwd();
-    return resolveEvalPath(root, "slices.jsonl");
+    return resolveTriageCachePath(root, "slices.jsonl");
 }
 /** Read slices.jsonl records. */
 export function loadSliceRecords(options = {}) {

package/dist/triage/reconcile/reconcile.js

@@ -2,7 +2,8 @@ import { execFileSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { appendFileSync, mkdirSync } from "node:fs";
 import { dirname, resolve } from "node:path";
-import { resolveEvalPath, resolveLifecycleFolder } from "../../layout/resolve.js";
+import { resolveLifecycleFolder } from "../../layout/resolve.js";
+import { resolveCandidatesLogPath } from "../cache-path.js";
 import { auditKey, existingAuditRefs, scanLifecycleRefs } from "./audit.js";
 import { BACKFILL_FOLDERS, RECONCILE_ACTOR, } from "./types.js";
 const GIT_ORIGIN_RE = /^(?:https?:\/\/(?:[^@/]+@)?github\.com\/|git@github\.com:|ssh:\/\/git@github\.com[:/])([A-Za-z0-9][A-Za-z0-9._-]*)\/([A-Za-z0-9][A-Za-z0-9._-]*?)(?:\.git)?\/?\s*$/;
@@ -33,7 +34,7 @@ function newDecisionId() {
 }
 export function findReconcilable(projectRoot, options = {}) {
     const root = resolve(projectRoot);
-    const auditPath = options.auditLogPath ?? resolveEvalPath(root, "candidates.jsonl");
+    const auditPath = options.auditLogPath ?? resolveCandidatesLogPath(root);
     const existing = existingAuditRefs(auditPath);
     const defaultRepo = options.defaultRepo ?? null;
     const items = [];
@@ -116,7 +117,7 @@ export function reconcile(projectRoot, options = {}) {
     if (defaultRepo === null) {
         defaultRepo = inferRepoFromGit(root);
     }
-    const auditPath = options.auditLogPath ?? resolveEvalPath(root, "candidates.jsonl");
+    const auditPath = options.auditLogPath ?? resolveCandidatesLogPath(root);
     const dryRun = options.dryRun ?? false;
     const result = {
         projectRoot: root,

package/dist/triage/scope/mutations-core.js

@@ -2,9 +2,10 @@ import { randomUUID } from "node:crypto";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
-import { resolveEvalPath, resolveProjectDefinitionPath } from "../../layout/resolve.js";
+import { resolveProjectDefinitionPath } from "../../layout/resolve.js";
 import { migrateLegacyPolicyKey, PLAN_POLICY_KEY } from "../../policy/plan-extensions.js";
 import { projectDefinitionMutationLock } from "../../vbrief-build/project-definition-io.js";
+import { resolveTriageCachePath } from "../cache-path.js";
 import { SUBSCRIPTION_HISTORY_SCHEMA } from "./constants.js";
 import { pyStrRepr } from "./python-repr.js";
 import { utcIso } from "./time.js";
@@ -61,7 +62,7 @@ function resolveActor(actor) {
     }
 }
 export function recordSubscriptionChange(projectRoot, options) {
-    const historyPath = resolveEvalPath(projectRoot, "subscription-history.jsonl");
+    const historyPath = resolveTriageCachePath(projectRoot, "subscription-history.jsonl");
     const record = {
         schema: SUBSCRIPTION_HISTORY_SCHEMA,
         change_id: randomUUID(),

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

@@ -1,4 +1,4 @@
-export declare const SUBSCRIPTION_HISTORY_REL_PATH = "vbrief/.eval/subscription-history.jsonl";
+export declare const SUBSCRIPTION_HISTORY_REL_PATH = "vbrief/.triage-cache/subscription-history.jsonl";
 export declare const SUBSCRIPTION_HISTORY_SCHEMA = "deft.triage.subscription-change.v1";
 export declare const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
 /** Python ``!r``-style quoting for parity with triage_subscribe.py messages. */

package/dist/triage/subscribe/index.js

@@ -1,10 +1,11 @@
 import { randomUUID } from "node:crypto";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
 import { basename, join } from "node:path";
-import { resolveEvalPath, resolveProjectDefinitionPath } from "../../layout/resolve.js";
+import { resolveProjectDefinitionPath } from "../../layout/resolve.js";
 import { migrateLegacyPolicyKey, PLAN_POLICY_KEY } from "../../policy/plan-extensions.js";
 import { projectDefinitionMutationLock } from "../../vbrief-build/project-definition-io.js";
-export const SUBSCRIPTION_HISTORY_REL_PATH = "vbrief/.eval/subscription-history.jsonl";
+import { resolveTriageCachePath } from "../cache-path.js";
+export const SUBSCRIPTION_HISTORY_REL_PATH = "vbrief/.triage-cache/subscription-history.jsonl";
 export const SUBSCRIPTION_HISTORY_SCHEMA = "deft.triage.subscription-change.v1";
 export const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
 /** Python ``!r``-style quoting for parity with triage_subscribe.py messages. */
@@ -90,7 +91,7 @@ function resolveActor(actor) {
     }
 }
 export function recordSubscriptionChange(projectRoot, options) {
-    const historyPath = resolveEvalPath(projectRoot, "subscription-history.jsonl");
+    const historyPath = resolveTriageCachePath(projectRoot, "subscription-history.jsonl");
     const record = {
         schema: SUBSCRIPTION_HISTORY_SCHEMA,
         change_id: randomUUID(),

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

@@ -4,9 +4,9 @@ export declare const MAX_LINE_CHARS = 120;
 export { DEFAULT_WIP_CAP, PROJECT_DEFINITION_REL_PATH };
 export declare const CACHE_DIR_NAME = ".deft-cache";
 export declare const CACHE_SOURCE = "github-issue";
-export declare const CANDIDATES_LOG_REL_PATH = "vbrief/.eval/candidates.jsonl";
+export declare const CANDIDATES_LOG_REL_PATH = "vbrief/.triage-cache/candidates.jsonl";
 export { latestDecisions, readAuditLog } from "../actions/candidates-log.js";
-export declare const SUMMARY_HISTORY_REL_PATH = "vbrief/.eval/summary-history.jsonl";
+export declare const SUMMARY_HISTORY_REL_PATH = "vbrief/.triage-cache/summary-history.jsonl";
 export declare const SUMMARY_HISTORY_SCHEMA = "deft.triage.summary.v1";
 /** D2 repeat-suppression window for session-start triage one-liner (#1122 / #1279). */
 export declare const D2_SUPPRESSION_WINDOW_HOURS = 4;

package/dist/triage/summary/index.js

@@ -1,11 +1,12 @@
 import { createHash } from "node:crypto";
 import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync } from "node:fs";
 import { join, resolve as pathResolve } from "node:path";
-import { hasArtifactSuffix, resolveEvalPath, resolveLifecycleFolder, resolveProjectDefinitionPath, } from "../../layout/resolve.js";
+import { hasArtifactSuffix, resolveLifecycleFolder, resolveProjectDefinitionPath, } from "../../layout/resolve.js";
 import { readPlanPolicy } from "../../policy/plan-extensions.js";
 import { loadProjectDefinition, PROJECT_DEFINITION_REL_PATH } from "../../policy/resolve.js";
 import { countVbriefWip, DEFAULT_WIP_CAP, resolveWipCap } from "../../policy/wip.js";
 import { AUDIT_LOG_REL_PATH, latestDecisions, readAuditLog } from "../actions/candidates-log.js";
+import { resolveCandidatesLogPath } from "../cache-path.js";
 import { countReconcilable } from "./reconcilable.js";
 import { computeScopeDriftTotal } from "./scope-drift.js";
 // ---------------------------------------------------------------------------
@@ -17,7 +18,7 @@ export const CACHE_DIR_NAME = ".deft-cache";
 export const CACHE_SOURCE = "github-issue";
 export const CANDIDATES_LOG_REL_PATH = AUDIT_LOG_REL_PATH;
 export { latestDecisions, readAuditLog } from "../actions/candidates-log.js";
-export const SUMMARY_HISTORY_REL_PATH = "vbrief/.eval/summary-history.jsonl";
+export const SUMMARY_HISTORY_REL_PATH = "vbrief/.triage-cache/summary-history.jsonl";
 export const SUMMARY_HISTORY_SCHEMA = "deft.triage.summary.v1";
 /** D2 repeat-suppression window for session-start triage one-liner (#1122 / #1279). */
 export const D2_SUPPRESSION_WINDOW_HOURS = 4;
@@ -189,7 +190,7 @@ export function isCachedIssueOpen(cacheRoot, repo, issueNumber) {
 export function computeSummary(projectRoot, options = {}) {
     const root = pathResolve(projectRoot);
     const resolvedCacheRoot = options.cacheRoot ?? join(root, CACHE_DIR_NAME);
-    const resolvedLogPath = options.auditLogPath ?? resolveEvalPath(root, "candidates.jsonl");
+    const resolvedLogPath = options.auditLogPath ?? resolveCandidatesLogPath(root);
     const cached = iterCachedIssues(resolvedCacheRoot);
     const repos = [...new Set(cached.map(([repo]) => repo))].sort();
     const wipCap = resolveWipCapInt(root);

package/dist/triage/summary/reconcilable.d.ts

@@ -1,6 +1,6 @@
 /** Lifecycle folders scanned for reconcilable vBRIEFs (#1468). */
 export declare const BACKFILL_FOLDERS: readonly ["proposed", "pending", "active"];
-export declare const CANDIDATES_LOG_REL_PATH = "vbrief/.eval/candidates.jsonl";
+export declare const CANDIDATES_LOG_REL_PATH = "vbrief/.triage-cache/candidates.jsonl";
 /**
  * Count reconcilable issues (#1468) — mirrors `triage_reconcile.count_reconcilable`.
  */

package/dist/triage/summary/reconcilable.js

@@ -1,8 +1,9 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { referenceTypeMatches } from "@deftai/directive-types";
-import { hasArtifactSuffix, resolveEvalPath, resolveLifecycleRoot } from "../../layout/resolve.js";
+import { hasArtifactSuffix, resolveLifecycleRoot } from "../../layout/resolve.js";
 import { AUDIT_LOG_REL_PATH, readAuditLog } from "../actions/candidates-log.js";
+import { resolveCandidatesLogPath } from "../cache-path.js";
 /** Lifecycle folders scanned for reconcilable vBRIEFs (#1468). */
 export const BACKFILL_FOLDERS = ["proposed", "pending", "active"];
 export const CANDIDATES_LOG_REL_PATH = AUDIT_LOG_REL_PATH;
@@ -63,7 +64,7 @@ function auditKey(repo, issueNumber) {
  */
 export function countReconcilable(projectRoot, options = {}) {
     try {
-        const auditPath = options.auditLogPath ?? resolveEvalPath(projectRoot, "candidates.jsonl");
+        const auditPath = options.auditLogPath ?? resolveCandidatesLogPath(projectRoot);
         const existing = existingAuditRefs(auditPath);
         const defaultRepo = options.defaultRepo ?? null;
         const keys = new Set();

package/dist/triage/welcome/constants.d.ts

@@ -1,13 +1,13 @@
 export declare const CACHE_DIR_NAME = ".deft-cache";
 export declare const CACHE_SOURCE = "github-issue";
-export declare const CANDIDATES_RELPATH: readonly ["vbrief", ".eval", "candidates.jsonl"];
+export declare const CANDIDATES_RELPATH: readonly ["vbrief", ".triage-cache", "candidates.jsonl"];
 export declare const WIP_LIFECYCLE_DIRS: readonly ["pending", "active"];
 export declare const AUDIT_LOG_REL_PATH = "meta/policy-changes.log";
 export declare const DEFAULT_WIP_CAP = 20;
 export declare const DEFAULT_RELIEF_AGE_DAYS = 30;
 export declare const TRIAGE_SKILL_PATH = "skills/deft-directive-triage/SKILL.md";
 export declare const WELCOME_AUDIT_TAG = "triage-welcome";
-export declare const SUMMARY_HISTORY_REL_PATH = "vbrief/.eval/summary-history.jsonl";
+export declare const SUMMARY_HISTORY_REL_PATH = "vbrief/.triage-cache/summary-history.jsonl";
 export declare const SUMMARY_HISTORY_SCHEMA = "deft.triage.summary.v1";
 export declare const EMPTY_CACHE_LINE = "[triage] cache empty -- run task triage:bootstrap";
 export declare const MAX_LINE_CHARS = 120;

package/dist/triage/welcome/constants.js

@@ -1,13 +1,13 @@
 export const CACHE_DIR_NAME = ".deft-cache";
 export const CACHE_SOURCE = "github-issue";
-export const CANDIDATES_RELPATH = ["vbrief", ".eval", "candidates.jsonl"];
+export const CANDIDATES_RELPATH = ["vbrief", ".triage-cache", "candidates.jsonl"];
 export const WIP_LIFECYCLE_DIRS = ["pending", "active"];
 export const AUDIT_LOG_REL_PATH = "meta/policy-changes.log";
 export const DEFAULT_WIP_CAP = 20;
 export const DEFAULT_RELIEF_AGE_DAYS = 30;
 export const TRIAGE_SKILL_PATH = "skills/deft-directive-triage/SKILL.md";
 export const WELCOME_AUDIT_TAG = "triage-welcome";
-export const SUMMARY_HISTORY_REL_PATH = "vbrief/.eval/summary-history.jsonl";
+export const SUMMARY_HISTORY_REL_PATH = "vbrief/.triage-cache/summary-history.jsonl";
 export const SUMMARY_HISTORY_SCHEMA = "deft.triage.summary.v1";
 export const EMPTY_CACHE_LINE = "[triage] cache empty -- run task triage:bootstrap";
 export const MAX_LINE_CHARS = 120;

package/dist/triage/welcome/prior-state.js

@@ -1,7 +1,8 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { hasArtifactSuffix, resolveAuditPath, resolveEvalPath, resolveLifecycleRoot, resolveProjectDefinitionPath, } from "../../layout/resolve.js";
+import { hasArtifactSuffix, resolveAuditPath, resolveLifecycleRoot, resolveProjectDefinitionPath, } from "../../layout/resolve.js";
 import { readPlanPolicy } from "../../policy/plan-extensions.js";
+import { resolveCandidatesLogPath } from "../cache-path.js";
 import { CACHE_DIR_NAME, CACHE_SOURCE, DEFAULT_WIP_CAP, SUBSCRIPTION_PRESETS, WIP_LIFECYCLE_DIRS, } from "./constants.js";
 function loadProjectDefinition(projectRoot) {
     const path = resolveProjectDefinitionPath(projectRoot);
@@ -39,7 +40,7 @@ function countCacheEntries(projectRoot) {
     return count;
 }
 export function candidatesLogPath(projectRoot) {
-    return resolveEvalPath(projectRoot, "candidates.jsonl");
+    return resolveCandidatesLogPath(projectRoot);
 }
 function countWip(projectRoot) {
     let total = 0;

package/dist/triage/welcome/summary.js

@@ -1,8 +1,9 @@
 import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { hasArtifactSuffix, resolveEvalPath, resolveLifecycleFolder, resolveProjectDefinitionPath, } from "../../layout/resolve.js";
+import { hasArtifactSuffix, resolveLifecycleFolder, resolveProjectDefinitionPath, } from "../../layout/resolve.js";
 import { readPlanPolicy } from "../../policy/plan-extensions.js";
-import { countVbriefWip, DEFAULT_WIP_CAP, resolveWipCap } from "../../policy/wip.js";
+import { countVbriefWip, resolveWipCap } from "../../policy/wip.js";
+import { resolveCandidatesLogPath, resolveTriageCachePath } from "../cache-path.js";
 import { countReconcilable } from "../reconcile/reconcile.js";
 import { computeDrift } from "../scope-drift/compute.js";
 import { shouldSuppressD2Emission } from "../summary/index.js";
@@ -119,7 +120,7 @@ function utcIso() {
 export function computeSummary(projectRoot) {
     const root = resolve(projectRoot);
     const cacheRoot = join(root, CACHE_DIR_NAME);
-    const logPath = resolveEvalPath(root, "candidates.jsonl");
+    const logPath = resolveCandidatesLogPath(root);
     const cached = iterCachedIssues(cacheRoot);
     const repos = [...new Set(cached.map(([r]) => r))].sort().slice(0, 8);
     const wipCapResult = resolveWipCap(root);
@@ -293,7 +294,7 @@ export function appendHistory(historyPath, result, line) {
 export function emitOneliner(projectRoot, options = {}) {
     const result = computeSummary(projectRoot);
     const line = formatSummary(result);
-    const historyPath = resolveEvalPath(projectRoot, "summary-history.jsonl");
+    const historyPath = resolveTriageCachePath(projectRoot, "summary-history.jsonl");
     const applySuppression = options.applyD2Suppression !== false;
     if (applySuppression && shouldSuppressD2Emission(result, historyPath, { now: options.now })) {
         return line;

package/dist/value/adoption-emit.d.ts

@@ -0,0 +1,14 @@
+import { type ValueFeedbackResolved } from "../policy/value-feedback.js";
+import { type WorkContext } from "./adoption-registry.js";
+export interface AdoptionEmitOptions {
+    readonly logPath?: string | null;
+    readonly policyOverride?: ValueFeedbackResolved;
+    readonly workContext?: WorkContext;
+}
+/** Best-effort WorkContext snapshot from git porcelain status (#2339). */
+export declare function buildWorkContextFromGit(projectRoot: string): WorkContext;
+/** Record adoption signals for applicable-but-unused capabilities (#2339). */
+export declare function recordAdoptionSignalsFromWorkContext(projectRoot: string, ctx: WorkContext, options?: AdoptionEmitOptions): number;
+/** Session/work-boundary adoption probe — builds WorkContext when omitted (#2339). */
+export declare function probeAdoptionAtWorkBoundary(projectRoot: string, options?: AdoptionEmitOptions): number;
+//# sourceMappingURL=adoption-emit.d.ts.map

package/dist/value/adoption-emit.js

@@ -0,0 +1,67 @@
+import { execFileSync } from "node:child_process";
+import { recordAdoptionSignal } from "../events/attribution-ledger.js";
+import { isValueFeedbackPathAllowed, resolveValueFeedback, } from "../policy/value-feedback.js";
+import { detectApplicableButUnusedGated } from "./adoption-registry.js";
+/** Best-effort WorkContext snapshot from git porcelain status (#2339). */
+export function buildWorkContextFromGit(projectRoot) {
+    try {
+        const porcelain = execFileSync("git", ["status", "--porcelain"], {
+            cwd: projectRoot,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        const paths = new Set();
+        for (const line of porcelain.split("\n")) {
+            if (line.length < 4) {
+                continue;
+            }
+            let path = line.slice(3).trim();
+            if (path.startsWith('"') && path.endsWith('"')) {
+                path = path.slice(1, -1);
+            }
+            if (path.length > 0) {
+                paths.add(path);
+            }
+        }
+        const modules = new Set();
+        for (const filePath of paths) {
+            const segment = filePath.split("/")[0];
+            if (segment !== undefined && segment.length > 0) {
+                modules.add(segment);
+            }
+        }
+        return {
+            filesTouched: paths.size,
+            distinctModuleGlobs: modules.size,
+            usedCapabilities: [],
+        };
+    }
+    catch {
+        return { filesTouched: 0, distinctModuleGlobs: 0, usedCapabilities: [] };
+    }
+}
+/** Record adoption signals for applicable-but-unused capabilities (#2339). */
+export function recordAdoptionSignalsFromWorkContext(projectRoot, ctx, options = {}) {
+    const policy = options.policyOverride ?? resolveValueFeedback(projectRoot);
+    if (!isValueFeedbackPathAllowed("emitEvents", policy)) {
+        return 0;
+    }
+    const signals = detectApplicableButUnusedGated(ctx, policy);
+    let recorded = 0;
+    for (const signal of signals) {
+        const record = recordAdoptionSignal(projectRoot, signal.capabilityId, signal.message, {
+            logPath: options.logPath,
+            policyOverride: policy,
+        });
+        if (record !== null) {
+            recorded += 1;
+        }
+    }
+    return recorded;
+}
+/** Session/work-boundary adoption probe — builds WorkContext when omitted (#2339). */
+export function probeAdoptionAtWorkBoundary(projectRoot, options = {}) {
+    const ctx = options.workContext ?? buildWorkContextFromGit(projectRoot);
+    return recordAdoptionSignalsFromWorkContext(projectRoot, ctx, options);
+}
+//# sourceMappingURL=adoption-emit.js.map

package/dist/value/adoption-registry.d.ts

@@ -0,0 +1,62 @@
+import { type ValueFeedbackResolved } from "../policy/value-feedback.js";
+/** Canonical directive capabilities tracked for underutilization nudges (#1709). */
+export type CapabilityId = "planning" | "cost" | "decompose" | "swarm" | "pre-pr" | "debug" | "glossary" | "lessons";
+/** How downstream instrumentation knows a capability was exercised. */
+export type UsageSignalSource = "command:/deft:directive:run:interview" | "command:/deft:directive:run:speckit" | "command:task capacity:show" | "command:split-to-prs" | "command:task swarm:launch" | "skill:deft-directive-pre-pr" | "skill:debug-mode" | "command:/deft:glossary" | "command:deft packs:slice";
+export interface CapabilityRecord {
+    readonly id: CapabilityId;
+    readonly label: string;
+    readonly description: string;
+    readonly usageSignals: readonly UsageSignalSource[];
+    readonly nudgeHint: string;
+}
+/** Work snapshot supplied by callers when evaluating adoption heuristics. */
+export interface WorkContext {
+    readonly filesTouched: number;
+    /** Distinct module globs from the codebase map (parallelizability proxy). */
+    readonly distinctModuleGlobs: number;
+    readonly usedCapabilities: readonly CapabilityId[];
+    readonly isBuildIntent?: boolean;
+    readonly isPrOpening?: boolean;
+}
+export interface ApplicabilityVerdict {
+    readonly applicable: boolean;
+    readonly reason: string;
+}
+export interface AdoptionSignal {
+    readonly signalClass: "adoption";
+    readonly event: string;
+    readonly capabilityId: CapabilityId;
+    readonly message: string;
+    readonly evidence: Readonly<Record<string, unknown>>;
+}
+/** Conservative thresholds — adoption nudges fire only above these bars (#1709). */
+export declare const ADOPTION_THRESHOLDS: {
+    readonly smallWorkMaxFiles: 2;
+    readonly planningMinFiles: 4;
+    readonly costMinFiles: 3;
+    readonly largeMultiFileMinFiles: 5;
+    readonly largeMultiFileMinModules: 2;
+    readonly swarmMinFiles: 8;
+    readonly swarmMinModules: 3;
+    readonly glossaryMinFiles: 6;
+    readonly lessonsMinFiles: 5;
+};
+export declare const ADOPTION_SIGNAL_CLASS: "adoption";
+/** Event name for the attribution ledger (`adoption:<capability>`). */
+export declare function formatAdoptionEventName(id: CapabilityId): string;
+/** True when work is too small for any adoption nudge (#1709-adoption-registry-a3). */
+export declare function isWorkTooSmallForAdoptionNudges(ctx: WorkContext): boolean;
+/** Evaluate whether a capability's conservative heuristic applies to the work snapshot. */
+export declare function evaluateApplicability(id: CapabilityId, ctx: WorkContext): ApplicabilityVerdict;
+/**
+ * Detect applicable-but-unused capabilities (#1709-adoption-registry-a2).
+ * Does not consult the value-feedback policy — use `detectApplicableButUnusedGated`.
+ */
+export declare function detectApplicableButUnused(ctx: WorkContext): AdoptionSignal[];
+/**
+ * Policy-gated adoption detection — returns signals only when value feedback
+ * is enabled and the emitEvents path is allowed (#1709 opt-in gate).
+ */
+export declare function detectApplicableButUnusedGated(ctx: WorkContext, policy: ValueFeedbackResolved): AdoptionSignal[];
+//# sourceMappingURL=adoption-registry.d.ts.map