@deftai/directive-core 0.70.0 → 0.71.0

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: {

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;