@deftai/directive-core 0.69.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"];
@@ -191,11 +191,11 @@ export declare const registryData: {
         readonly "task triage:welcome": {
             readonly name: "task triage:welcome";
             readonly summary: "Single-entry-point upgrade ritual";
-            readonly refs: "(N3 / #1143)";
-            readonly description: "6-phase onboarding ritual: detect prior state, prompt for subscription scope, run triage:bootstrap, prompt for wipCap, offer WIP relief, print triage:summary. Idempotent on re-run; safe entrypoint for fresh consumers.";
-            readonly usage: "task triage:welcome [-- --no-subprocess]";
-            readonly flags: readonly [readonly ["--no-subprocess", "(off)", "Dry-mode: don't shell out to sibling tasks."]];
-            readonly examples: readonly ["task triage:welcome"];
+            readonly refs: "(N3 / #1143, #2295)";
+            readonly description: "6-phase onboarding ritual: detect prior state, prompt for subscription scope, run triage:bootstrap, prompt for wipCap, offer WIP relief, print triage:summary. Idempotent on re-run; safe entrypoint for fresh consumers. Pass --onboard for the non-interactive path that applies a triage-scope preset (and optional --wip-cap) without prompting -- the form agents/CI use.";
+            readonly usage: "task triage:welcome [-- --onboard [--preset small|mid|mega] [--wip-cap N]] [--no-subprocess]";
+            readonly flags: readonly [readonly ["--onboard", "(off)", "Non-interactive onboarding: apply a triage-scope preset (and optional WIP cap) without prompting."], readonly ["--preset small|mid|mega", "small", "Subscription-scope preset applied by --onboard."], readonly ["--wip-cap N", "(policy default)", "Persist an explicit in-flight scope cap during --onboard (positive integer)."], readonly ["--no-subprocess", "(off)", "Dry-mode: don't shell out to sibling tasks."]];
+            readonly examples: readonly ["task triage:welcome", "task triage:welcome -- --onboard --preset small"];
             readonly see_also: readonly ["task triage:bootstrap", "task triage:summary", "#1119 / N3"];
             readonly placeholder: false;
         };
@@ -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."],
@@ -296,11 +296,24 @@ export const registryData = {
         "task triage:welcome": {
             name: "task triage:welcome",
             summary: "Single-entry-point upgrade ritual",
-            refs: "(N3 / #1143)",
-            description: "6-phase onboarding ritual: detect prior state, prompt for subscription scope, run triage:bootstrap, prompt for wipCap, offer WIP relief, print triage:summary. Idempotent on re-run; safe entrypoint for fresh consumers.",
-            usage: "task triage:welcome [-- --no-subprocess]",
-            flags: [["--no-subprocess", "(off)", "Dry-mode: don't shell out to sibling tasks."]],
-            examples: ["task triage:welcome"],
+            refs: "(N3 / #1143, #2295)",
+            description: "6-phase onboarding ritual: detect prior state, prompt for subscription scope, run triage:bootstrap, prompt for wipCap, offer WIP relief, print triage:summary. Idempotent on re-run; safe entrypoint for fresh consumers. Pass --onboard for the non-interactive path that applies a triage-scope preset (and optional --wip-cap) without prompting -- the form agents/CI use.",
+            usage: "task triage:welcome [-- --onboard [--preset small|mid|mega] [--wip-cap N]] [--no-subprocess]",
+            flags: [
+                [
+                    "--onboard",
+                    "(off)",
+                    "Non-interactive onboarding: apply a triage-scope preset (and optional WIP cap) without prompting.",
+                ],
+                ["--preset small|mid|mega", "small", "Subscription-scope preset applied by --onboard."],
+                [
+                    "--wip-cap N",
+                    "(policy default)",
+                    "Persist an explicit in-flight scope cap during --onboard (positive integer).",
+                ],
+                ["--no-subprocess", "(off)", "Dry-mode: don't shell out to sibling tasks."],
+            ],
+            examples: ["task triage:welcome", "task triage:welcome -- --onboard --preset small"],
             see_also: ["task triage:bootstrap", "task triage:summary", "#1119 / N3"],
             placeholder: false,
         },
@@ -308,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: [
                 [
@@ -422,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."],
@@ -491,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"],
@@ -500,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",
@@ -535,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."],
@@ -685,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,
@@ -746,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/cli.d.ts

@@ -6,13 +6,14 @@ export interface ParsedCliArgs {
     addLabel: string | undefined;
     addMilestone: string | undefined;
     ignoreLabel: string | undefined;
+    setPreset: string | undefined;
     diffFromUpstream: boolean;
     source: string;
     cacheRoot: string | undefined;
     count: number | undefined;
 }
 export declare function parseCliArgs(argv: string[]): ParsedCliArgs;
-export declare const CLI_HELP = "usage: triage_scope.py [-h] [--project-root PROJECT_ROOT] [--list]\n                       [--refresh-denominator] [--repo REPO]\n                       [--add-label ADD_LABEL] [--add-milestone ADD_MILESTONE]\n                       [--ignore-label IGNORE_LABEL] [--diff-from-upstream]\n                       [--source SOURCE] [--cache-root CACHE_ROOT]\n                       [--count COUNT]\n\nInspect, mutate, and diff the typed plan.policy.triageScope[] subscription +\nplan.policy.triageScopeIgnores[] (#1131 / D12, #1133 / D14, #1182 / D14c).\nRead paths never trigger a recompute; use --refresh-denominator to update the\ncoverage cache. Mutation flags --add-label / --add-milestone / --ignore-label\nare idempotent and atomic; every mutation appends a subscription-change audit\nentry to vbrief/.eval/subscription-history.jsonl.\n";
+export declare const CLI_HELP = "usage: triage_scope.py [-h] [--project-root PROJECT_ROOT] [--list]\n                       [--refresh-denominator] [--repo REPO]\n                       [--add-label ADD_LABEL] [--add-milestone ADD_MILESTONE]\n                       [--ignore-label IGNORE_LABEL] [--set-preset PRESET]\n                       [--diff-from-upstream]\n                       [--source SOURCE] [--cache-root CACHE_ROOT]\n                       [--count COUNT]\n\nInspect, mutate, and diff the typed plan.policy.triageScope[] subscription +\nplan.policy.triageScopeIgnores[] (#1131 / D12, #1133 / D14, #1182 / D14c).\nRead paths never trigger a recompute; use --refresh-denominator to update the\ncoverage cache. Mutation flags --add-label / --add-milestone / --ignore-label /\n--set-preset are idempotent and atomic; every mutation appends a\nsubscription-change audit entry to vbrief/.eval/subscription-history.jsonl.\n--set-preset small|mid|mega overwrites plan.policy.triageScope[] with a named\nsubscription preset via the same writer that backs triage:welcome --onboard (#2301).\n";
 /** Run triage:scope CLI; returns exit code and captured output for parity. */
 export declare function runCliCapture(argv: string[]): {
     code: number;

package/dist/triage/scope/cli.js

@@ -2,7 +2,7 @@ import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { coveragePath, writeCoverageDenominator } from "./coverage.js";
-import { addLabelToIgnores, addLabelToScope, addMilestoneToScope, computeDiffFromUpstream, fetchUpstreamLabelsAndMilestones, renderDiffReport, } from "./mutations.js";
+import { addLabelToIgnores, addLabelToScope, addMilestoneToScope, computeDiffFromUpstream, fetchUpstreamLabelsAndMilestones, renderDiffReport, setScopePreset, } from "./mutations.js";
 import { subscriptionHash } from "./normalize.js";
 import { pyListRepr } from "./python-repr.js";
 import { renderIgnores, renderList } from "./renderers.js";
@@ -17,6 +17,7 @@ export function parseCliArgs(argv) {
         addLabel: undefined,
         addMilestone: undefined,
         ignoreLabel: undefined,
+        setPreset: undefined,
         diffFromUpstream: false,
         source: "github-issue",
         cacheRoot: undefined,
@@ -60,6 +61,12 @@ export function parseCliArgs(argv) {
         }
         else if (arg?.startsWith("--ignore-label="))
             parsed.ignoreLabel = arg.slice("--ignore-label=".length);
+        else if (arg === "--set-preset") {
+            parsed.setPreset = argv[i + 1];
+            i += 1;
+        }
+        else if (arg?.startsWith("--set-preset="))
+            parsed.setPreset = arg.slice("--set-preset=".length);
         else if (arg === "--source") {
             parsed.source = argv[i + 1] ?? "github-issue";
             i += 1;
@@ -86,16 +93,19 @@ export function parseCliArgs(argv) {
 export const CLI_HELP = `usage: triage_scope.py [-h] [--project-root PROJECT_ROOT] [--list]
                        [--refresh-denominator] [--repo REPO]
                        [--add-label ADD_LABEL] [--add-milestone ADD_MILESTONE]
-                       [--ignore-label IGNORE_LABEL] [--diff-from-upstream]
+                       [--ignore-label IGNORE_LABEL] [--set-preset PRESET]
+                       [--diff-from-upstream]
                        [--source SOURCE] [--cache-root CACHE_ROOT]
                        [--count COUNT]
 
 Inspect, mutate, and diff the typed plan.policy.triageScope[] subscription +
 plan.policy.triageScopeIgnores[] (#1131 / D12, #1133 / D14, #1182 / D14c).
 Read paths never trigger a recompute; use --refresh-denominator to update the
-coverage cache. Mutation flags --add-label / --add-milestone / --ignore-label
-are idempotent and atomic; every mutation appends a subscription-change audit
-entry to vbrief/.eval/subscription-history.jsonl.
+coverage cache. Mutation flags --add-label / --add-milestone / --ignore-label /
+--set-preset are idempotent and atomic; every mutation appends a
+subscription-change audit entry to vbrief/.eval/subscription-history.jsonl.
+--set-preset small|mid|mega overwrites plan.policy.triageScope[] with a named
+subscription preset via the same writer that backs triage:welcome --onboard (#2301).
 `;
 function handleMutation(projectRoot, args) {
     const out = { stdout: [], stderr: [] };
@@ -115,6 +125,10 @@ function handleMutation(projectRoot, args) {
             [changed, message] = addLabelToIgnores(projectRoot, args.ignoreLabel);
             verb = "ignore-label";
         }
+        else if (args.setPreset !== undefined) {
+            [changed, message] = setScopePreset(projectRoot, args.setPreset);
+            verb = "set-preset";
+        }
         else {
             throw new Error("internal: mutation flag set but no handler matched");
         }
@@ -148,12 +162,13 @@ export function runCliCapture(argv) {
         args.addLabel !== undefined ? "--add-label" : null,
         args.addMilestone !== undefined ? "--add-milestone" : null,
         args.ignoreLabel !== undefined ? "--ignore-label" : null,
+        args.setPreset !== undefined ? "--set-preset" : null,
     ].filter((f) => f !== null);
     if (mutationFlags.length > 1) {
         return {
             code: 2,
             stdout: "",
-            stderr: "triage:scope: --add-label / --add-milestone / --ignore-label " +
+            stderr: "triage:scope: --add-label / --add-milestone / --ignore-label / --set-preset " +
                 `are mutually exclusive (got ${pyListRepr(mutationFlags)}).\n`,
         };
     }
@@ -171,6 +186,15 @@ export function runCliCapture(argv) {
         if (mutation.code !== 0) {
             return { code: mutation.code, stdout: stdout.join(""), stderr: stderr.join("") };
         }
+        // A preset write comes from the trusted SUBSCRIPTION_PRESETS constant (the
+        // same source the onboard path writes). The `mega` preset intentionally
+        // ships an `explicit-watch` scaffold with an empty `issues` list for the
+        // operator to fill in, which the strict hand-edit validator below flags.
+        // Bypass that re-validation for a preset write so `--set-preset` reports the
+        // successful, persisted mutation instead of a spurious exit 1 (#2301).
+        if (args.setPreset !== undefined) {
+            return { code: 0, stdout: stdout.join(""), stderr: stderr.join("") };
+        }
     }
     const data = loadProjectDefinition(projectRoot);
     const rules = resolveScopeRules(projectRoot, data);

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/scope/mutations.d.ts

@@ -18,4 +18,14 @@ export declare function fetchUpstreamLabelsAndMilestones(repo: string, binary?:
 export declare function addLabelToScope(projectRoot: string, label: string, actor?: string | null): [boolean, string];
 export declare function addMilestoneToScope(projectRoot: string, milestone: string, actor?: string | null): [boolean, string];
 export declare function addLabelToIgnores(projectRoot: string, label: string): [boolean, string];
+/** Valid subscription preset keys for `triage:scope --set-preset` (#2301). */
+export declare function scopePresetKeys(): string[];
+/**
+ * Overwrite plan.policy.triageScope with a named subscription preset (#2301).
+ * Reuses the shared `subscriptionPreset` + `writeTriageScope` helper that backs
+ * `triage:welcome --onboard`, so the write path (namespaced key, legacy-key
+ * migration, audit trail, mutation lock) stays identical across surfaces rather
+ * than being duplicated here.
+ */
+export declare function setScopePreset(projectRoot: string, presetKey: string): [boolean, string];
 //# sourceMappingURL=mutations.d.ts.map

package/dist/triage/scope/mutations.js

@@ -1,5 +1,7 @@
 import { spawnSync } from "node:child_process";
 import { SUBPROCESS_MAX_BUFFER } from "../../subprocess/max-buffer.js";
+import { SUBSCRIPTION_PRESETS } from "../welcome/constants.js";
+import { subscriptionPreset, writeTriageScope } from "../welcome/writers.js";
 import { collectMilestoneSubscribedNames, rulesRequestIsOpen } from "./milestone.js";
 import { addIgnore, subscribe } from "./mutations-core.js";
 import { resolveScopeIgnores, resolveScopeRules } from "./resolve.js";
@@ -200,4 +202,24 @@ export function addLabelToIgnores(projectRoot, label) {
         throw new Error(`label must be a non-empty string; got ${JSON.stringify(label)}`);
     return addIgnore(projectRoot, label);
 }
+/** Valid subscription preset keys for `triage:scope --set-preset` (#2301). */
+export function scopePresetKeys() {
+    return Object.keys(SUBSCRIPTION_PRESETS);
+}
+/**
+ * Overwrite plan.policy.triageScope with a named subscription preset (#2301).
+ * Reuses the shared `subscriptionPreset` + `writeTriageScope` helper that backs
+ * `triage:welcome --onboard`, so the write path (namespaced key, legacy-key
+ * migration, audit trail, mutation lock) stays identical across surfaces rather
+ * than being duplicated here.
+ */
+export function setScopePreset(projectRoot, presetKey) {
+    const key = presetKey.trim();
+    const validKeys = scopePresetKeys();
+    if (!validKeys.includes(key)) {
+        throw new Error(`unknown preset ${JSON.stringify(presetKey)}; valid presets: ${validKeys.join(", ")}`);
+    }
+    const rules = subscriptionPreset(key);
+    return writeTriageScope(projectRoot, rules, { presetLabel: key });
+}
 //# sourceMappingURL=mutations.js.map