@deftai/directive-core 0.94.0 → 0.96.0

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

@@ -114,12 +114,12 @@ export declare const registryData: {
         readonly "task triage:queue": {
             readonly name: "task triage:queue";
             readonly summary: "Ranked candidate list";
-            readonly refs: "(D11 / #1128)";
-            readonly description: "Print the ranked triage queue from the local cache. Groups (display order): [ORPHAN] -> [RESUME] -> [URGENT] -> untriaged -> other -> [BLOCKED]. Within-group default = updated_at desc; consumer plan.policy.triageRankingLabels[] re-orders within-group by matched-label declared order. Items whose linked vBRIEF is blocked (status:blocked / unresolved depends_on) are demoted into [BLOCKED] unless --include-blocked is passed (#1286).";
-            readonly usage: "task triage:queue [-- --limit=N] [--include-blocked] [--repo=owner/name]";
-            readonly flags: readonly [readonly ["--limit N", "10", "Max rows to print."], readonly ["--include-blocked", "(off)", "Re-surface blocked items into their natural group (#1286)."], readonly ["--repo owner/name", "(git remote)", "Explicit repo override."]];
-            readonly examples: readonly ["task triage:queue", "task triage:queue -- --limit=20 --state=accept", "task triage:queue -- --format=json | jq '.[] | select(.score > 5)'"];
-            readonly see_also: readonly ["task triage:show", "task triage:audit", "#1119 / D11"];
+            readonly refs: "(D11 / #1128, #3129 / #1318 Layer 1)";
+            readonly description: "Print the ranked triage queue from the local cache. Groups (display order): [ORPHAN] -> [RESUME] -> [URGENT] -> untriaged -> other -> [BLOCKED]. Within-group default = updated_at desc; consumer plan.policy.triageRankingLabels[] re-orders within-group by matched-label declared order. Items whose linked vBRIEF is blocked (status:blocked / unresolved depends_on) are demoted into [BLOCKED] unless --include-blocked is passed (#1286). Optional --author LOGIN filters to cache author.login (exact; @me resolves to authenticated login; comma allow-list; missing author counted as unknown and disclosed in the header) (#3129 / #1318 Layer 1).";
+            readonly usage: "task triage:queue [-- --limit=N] [--include-blocked] [--repo=owner/name] [--author LOGIN|@me] [--author-mine]";
+            readonly flags: readonly [readonly ["--limit N", "10", "Max rows to print."], readonly ["--include-blocked", "(off)", "Re-surface blocked items into their natural group (#1286)."], readonly ["--repo owner/name", "(git remote)", "Explicit repo override."], readonly ["--author LOGIN|@me", "(none)", "Only issues whose cache author.login matches (exact; @me = gh user; comma allow-list) (#3129)."], readonly ["--author-mine", "(off)", "Alias for --author @me (#1318 / #3129)."]];
+            readonly examples: readonly ["task triage:queue", "task triage:queue -- --limit=20", "task triage:queue -- --author @me", "task triage:queue -- --author alice,bob --limit=20"];
+            readonly see_also: readonly ["task triage:show", "task triage:audit", "task triage:classify", "#1119 / D11", "#3129"];
             readonly placeholder: false;
         };
         readonly "task triage:audit": {
@@ -168,13 +168,13 @@ export declare const registryData: {
         };
         readonly "task triage:classify": {
             readonly name: "task triage:classify";
-            readonly summary: "Inspect / validate auto-classification surface";
-            readonly refs: "(D10 / #1129)";
-            readonly description: "Inspect or validate the auto-classification rule set. --list renders effective rules (framework universal first, consumer overrides next). --validate exits non-zero on a malformed plan.policy.triageAutoClassify.";
-            readonly usage: "task triage:classify -- [--list | --validate]";
-            readonly flags: readonly [readonly ["--list", "(default)", "Print effective rules + hold markers."], readonly ["--validate", "(off)", "Validate plan.policy.triageAutoClassify."]];
-            readonly examples: readonly ["task triage:classify -- --list", "task triage:classify -- --validate"];
-            readonly see_also: readonly ["task triage:bootstrap", "task triage:queue", "#1119 / D10"];
+            readonly summary: "Inspect / validate auto-classification; bootstrap mass-triage label mirror";
+            readonly refs: "(D10 / #1129, #1423 Wave 1–2 / #3125, #3129)";
+            readonly description: "Inspect or validate the auto-classification rule set. --list renders effective rules (framework universal first, consumer overrides next). --validate exits non-zero on a malformed plan.policy.triageAutoClassify or triageLabelMirror. --mirror is the bootstrap mass-triage entrypoint (#3125): classifies the github-issue cache and mirrors outcomes as SCM labels. Open-only by default (opt-in --include-closed); optional --author LOGIN scopes plan/apply to matching author.login (AND with open-only; #3129); dry-run digest shows totals + by state/rule/action + samples and surfaces the author filter; --apply batches writes with rate-limit delay. Never calls triage:accept / never writes proposed/ xBRIEFs.";
+            readonly usage: "task triage:classify -- [--list | --validate | --mirror [--apply] [--include-closed] [--author LOGIN|@me] [--repo owner/name] [--batch-size N] [--delay-ms N] [--sample-limit N] [--json] [--allow-cross-repo]]";
+            readonly flags: readonly [readonly ["--list", "(default)", "Print effective rules + hold markers."], readonly ["--validate", "(off)", "Validate plan.policy.triageAutoClassify + triageLabelMirror."], readonly ["--mirror", "(off)", "Bootstrap mass-triage label mirror: classify cache → planned/applied labels (dry-run default, open-only)."], readonly ["--apply", "(off)", "With --mirror: write labels via SCM (batched; requires github SCM boundary)."], readonly ["--include-closed", "(off)", "With --mirror: include closed issues (default open-only avoids archive mass-stamp)."], readonly ["--author LOGIN|@me", "(none)", "With --mirror: only plan/apply issues whose cache author.login matches (exact; @me; comma allow-list) (#3129)."], readonly ["--author-mine", "(off)", "With --mirror: alias for --author @me (#3129)."], readonly ["--repo owner/name", "(all cached)", "Limit mirror to one repo."], readonly ["--batch-size N", "10", "With --mirror --apply: writes per batch before delay."], readonly ["--delay-ms N", "1000", "With --mirror --apply: ms sleep between batches (rate-limit)."], readonly ["--sample-limit N", "15", "With --mirror: max samples in human digest."], readonly ["--json", "(off)", "With --mirror: structured JSON outcome including digest aggregates."], readonly ["--allow-cross-repo", "(off)", "With --mirror --apply: allow non-project repos (#2601)."]];
+            readonly examples: readonly ["task triage:classify -- --list", "task triage:classify -- --validate", "task triage:classify -- --mirror", "task triage:classify -- --mirror --author @me --repo owner/name", "task triage:classify -- --mirror --repo owner/name --json", "task triage:classify -- --mirror --apply --repo owner/name --batch-size 10 --delay-ms 1000", "task triage:classify -- --mirror --include-closed --repo owner/name"];
+            readonly see_also: readonly ["task triage:bootstrap", "task triage:queue", "task vbrief:reconcile:labels", "#1119 / D10", "#1423", "#3125", "#3129"];
             readonly placeholder: false;
         };
         readonly "task triage:bootstrap": {
@@ -298,37 +298,48 @@ export declare const registryData: {
             readonly see_also: readonly ["task triage:subscribe", "task triage:scope", "#1119 / D14"];
             readonly placeholder: false;
         };
-        readonly "task triage:audit:prune": {
-            readonly name: "task triage:audit:prune";
-            readonly summary: "Operator-invoked archive of closed-terminal entries";
-            readonly refs: "(D19, coming)";
-            readonly description: "Move closed-terminal audit entries (accept/reject/mark-duplicate after the upstream issue is closed) into the archive sidecar so the live cache stays focused on open work.";
-            readonly usage: "task triage:audit:prune [-- --dry-run] [--older-than-days N]";
-            readonly flags: readonly [readonly ["--dry-run", "(off)", "Preview eligible entries without writing."], readonly ["--older-than-days N", "30", "Age threshold."]];
-            readonly examples: readonly ["task triage:audit:prune -- --dry-run"];
-            readonly see_also: readonly ["task triage:archive-list", "task triage:restore-from-archive", "#1119 / D19"];
-            readonly placeholder: true;
+        readonly "task triage:cache-archive": {
+            readonly name: "task triage:cache-archive";
+            readonly summary: "Reversible archive of closed github-issue cache entries";
+            readonly refs: "(#1137)";
+            readonly description: "Move closed-and-aged live `.deft-cache/github-issue/` entries under `.deft-cache/archived/github-issue/...` with archive-meta.json. Operator-only; never auto on check/session/sync. Distinct from task cache:prune (TTL hard-delete). Skips issues referenced in xbrief/{proposed,pending,active}. Alias: cache:archive-closed.";
+            readonly usage: "task triage:cache-archive -- [--dry-run] [--older-than-days 30] [--repo owner/name] [--json] [--terminal-decision-only]";
+            readonly flags: readonly [readonly ["--dry-run", "(off)", "Report eligible entries without moving."], readonly ["--older-than-days N", "30", "Minimum age of closed_at (or fetched_at/mtime fallback)."], readonly ["--repo owner/name", "(all)", "Limit to one repo."], readonly ["--json", "(off)", "Structured summary."], readonly ["--terminal-decision-only", "(off)", "Only archive when latest candidates decision is reject or mark-duplicate."]];
+            readonly examples: readonly ["task triage:cache-archive -- --dry-run", "task triage:cache-archive -- --older-than-days 30 --repo deftai/directive"];
+            readonly see_also: readonly ["task triage:archive-list", "task triage:restore-from-archive", "task cache:prune", "#1137"];
+            readonly placeholder: false;
         };
         readonly "task triage:archive-list": {
             readonly name: "task triage:archive-list";
-            readonly summary: "List archived entries";
-            readonly refs: "(D19, coming)";
-            readonly description: "Read-only listing of archived audit entries from the archive sidecar. Useful before restoring an entry.";
-            readonly usage: "task triage:archive-list [-- --since=WINDOW]";
-            readonly flags: readonly [readonly ["--since WINDOW", "(all)", "Time window (e.g. '30d', '6mo')."]];
-            readonly examples: readonly ["task triage:archive-list"];
-            readonly see_also: readonly ["task triage:audit:prune", "#1119 / D19"];
-            readonly placeholder: true;
+            readonly summary: "List archived github-issue cache entries";
+            readonly refs: "(#1137)";
+            readonly description: "List `.deft-cache/archived/github-issue/...` entries newest archived_at first. Alias: cache:archive-list.";
+            readonly usage: "task triage:archive-list -- [--repo owner/name] [--format=json] [--since ISO] [--limit N]";
+            readonly flags: readonly [readonly ["--repo owner/name", "(all)", "Limit to one repo."], readonly ["--format=json", "text", "JSON listing."], readonly ["--since ISO", "(none)", "Only entries archived at/after this timestamp."], readonly ["--limit N", "(none)", "Cap result count."]];
+            readonly examples: readonly ["task triage:archive-list -- --format=json"];
+            readonly see_also: readonly ["task triage:cache-archive", "task triage:restore-from-archive", "#1137"];
+            readonly placeholder: false;
         };
         readonly "task triage:restore-from-archive": {
             readonly name: "task triage:restore-from-archive";
-            readonly summary: "Restore archived entry to live cache";
-            readonly refs: "(D19, coming)";
-            readonly description: "Move an archived entry back to the live audit log so it becomes visible to triage:queue / triage:audit again.";
-            readonly usage: "task triage:restore-from-archive -- <N>";
-            readonly flags: readonly [readonly ["<N>", "(required)", "Archived entry number to restore."]];
-            readonly examples: readonly ["task triage:restore-from-archive -- 42"];
-            readonly see_also: readonly ["task triage:archive-list", "#1119 / D19"];
+            readonly summary: "Restore archived issue entry to live cache";
+            readonly refs: "(#1137)";
+            readonly description: "Move an archived github-issue entry back to the live key path. Idempotent if already live with matching content; refuse live conflict unless --force. Alias: cache:restore-from-archive.";
+            readonly usage: "task triage:restore-from-archive -- --issue N --repo owner/name [--force]";
+            readonly flags: readonly [readonly ["--issue N", "(required unless --key)", "Issue number."], readonly ["--repo owner/name", "(required with --issue)", "Upstream repo."], readonly ["--key owner/repo/N", "(alt)", "Full cache key."], readonly ["--force", "(off)", "Replace live path when content differs."]];
+            readonly examples: readonly ["task triage:restore-from-archive -- --issue 1234 --repo deftai/directive"];
+            readonly see_also: readonly ["task triage:cache-archive", "task triage:show", "#1137"];
+            readonly placeholder: false;
+        };
+        readonly "task triage:audit:prune": {
+            readonly name: "task triage:audit:prune";
+            readonly summary: "Legacy name — use triage:cache-archive";
+            readonly refs: "(#1137 supersedes D19 name)";
+            readonly description: "Historical D19 placeholder name. Implemented surface is task triage:cache-archive (reversible closed github-issue cache archive). Do not confuse with task cache:prune (TTL hard-delete).";
+            readonly usage: "task triage:cache-archive -- [--dry-run] [--older-than-days N]";
+            readonly flags: readonly [readonly ["--dry-run", "(off)", "Preview eligible entries without writing."], readonly ["--older-than-days N", "30", "Age threshold."]];
+            readonly examples: readonly ["task triage:cache-archive -- --dry-run"];
+            readonly see_also: readonly ["task triage:cache-archive", "task triage:archive-list", "#1137"];
             readonly placeholder: true;
         };
         readonly "task triage:audit-log:rotate": {

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

@@ -170,9 +170,9 @@ export const registryData = {
         "task triage:queue": {
             name: "task triage:queue",
             summary: "Ranked candidate list",
-            refs: "(D11 / #1128)",
-            description: "Print the ranked triage queue from the local cache. Groups (display order): [ORPHAN] -> [RESUME] -> [URGENT] -> untriaged -> other -> [BLOCKED]. Within-group default = updated_at desc; consumer plan.policy.triageRankingLabels[] re-orders within-group by matched-label declared order. Items whose linked vBRIEF is blocked (status:blocked / unresolved depends_on) are demoted into [BLOCKED] unless --include-blocked is passed (#1286).",
-            usage: "task triage:queue [-- --limit=N] [--include-blocked] [--repo=owner/name]",
+            refs: "(D11 / #1128, #3129 / #1318 Layer 1)",
+            description: "Print the ranked triage queue from the local cache. Groups (display order): [ORPHAN] -> [RESUME] -> [URGENT] -> untriaged -> other -> [BLOCKED]. Within-group default = updated_at desc; consumer plan.policy.triageRankingLabels[] re-orders within-group by matched-label declared order. Items whose linked vBRIEF is blocked (status:blocked / unresolved depends_on) are demoted into [BLOCKED] unless --include-blocked is passed (#1286). Optional --author LOGIN filters to cache author.login (exact; @me resolves to authenticated login; comma allow-list; missing author counted as unknown and disclosed in the header) (#3129 / #1318 Layer 1).",
+            usage: "task triage:queue [-- --limit=N] [--include-blocked] [--repo=owner/name] [--author LOGIN|@me] [--author-mine]",
             flags: [
                 ["--limit N", "10", "Max rows to print."],
                 [
@@ -181,13 +181,26 @@ export const registryData = {
                     "Re-surface blocked items into their natural group (#1286).",
                 ],
                 ["--repo owner/name", "(git remote)", "Explicit repo override."],
+                [
+                    "--author LOGIN|@me",
+                    "(none)",
+                    "Only issues whose cache author.login matches (exact; @me = gh user; comma allow-list) (#3129).",
+                ],
+                ["--author-mine", "(off)", "Alias for --author @me (#1318 / #3129)."],
             ],
             examples: [
                 "task triage:queue",
-                "task triage:queue -- --limit=20 --state=accept",
-                "task triage:queue -- --format=json | jq '.[] | select(.score > 5)'",
+                "task triage:queue -- --limit=20",
+                "task triage:queue -- --author @me",
+                "task triage:queue -- --author alice,bob --limit=20",
+            ],
+            see_also: [
+                "task triage:show",
+                "task triage:audit",
+                "task triage:classify",
+                "#1119 / D11",
+                "#3129",
             ],
-            see_also: ["task triage:show", "task triage:audit", "#1119 / D11"],
             placeholder: false,
         },
         "task triage:audit": {
@@ -264,16 +277,59 @@ export const registryData = {
         },
         "task triage:classify": {
             name: "task triage:classify",
-            summary: "Inspect / validate auto-classification surface",
-            refs: "(D10 / #1129)",
-            description: "Inspect or validate the auto-classification rule set. --list renders effective rules (framework universal first, consumer overrides next). --validate exits non-zero on a malformed plan.policy.triageAutoClassify.",
-            usage: "task triage:classify -- [--list | --validate]",
+            summary: "Inspect / validate auto-classification; bootstrap mass-triage label mirror",
+            refs: "(D10 / #1129, #1423 Wave 1–2 / #3125, #3129)",
+            description: "Inspect or validate the auto-classification rule set. --list renders effective rules (framework universal first, consumer overrides next). --validate exits non-zero on a malformed plan.policy.triageAutoClassify or triageLabelMirror. --mirror is the bootstrap mass-triage entrypoint (#3125): classifies the github-issue cache and mirrors outcomes as SCM labels. Open-only by default (opt-in --include-closed); optional --author LOGIN scopes plan/apply to matching author.login (AND with open-only; #3129); dry-run digest shows totals + by state/rule/action + samples and surfaces the author filter; --apply batches writes with rate-limit delay. Never calls triage:accept / never writes proposed/ xBRIEFs.",
+            usage: "task triage:classify -- [--list | --validate | --mirror [--apply] [--include-closed] [--author LOGIN|@me] [--repo owner/name] [--batch-size N] [--delay-ms N] [--sample-limit N] [--json] [--allow-cross-repo]]",
             flags: [
                 ["--list", "(default)", "Print effective rules + hold markers."],
-                ["--validate", "(off)", "Validate plan.policy.triageAutoClassify."],
+                ["--validate", "(off)", "Validate plan.policy.triageAutoClassify + triageLabelMirror."],
+                [
+                    "--mirror",
+                    "(off)",
+                    "Bootstrap mass-triage label mirror: classify cache → planned/applied labels (dry-run default, open-only).",
+                ],
+                [
+                    "--apply",
+                    "(off)",
+                    "With --mirror: write labels via SCM (batched; requires github SCM boundary).",
+                ],
+                [
+                    "--include-closed",
+                    "(off)",
+                    "With --mirror: include closed issues (default open-only avoids archive mass-stamp).",
+                ],
+                [
+                    "--author LOGIN|@me",
+                    "(none)",
+                    "With --mirror: only plan/apply issues whose cache author.login matches (exact; @me; comma allow-list) (#3129).",
+                ],
+                ["--author-mine", "(off)", "With --mirror: alias for --author @me (#3129)."],
+                ["--repo owner/name", "(all cached)", "Limit mirror to one repo."],
+                ["--batch-size N", "10", "With --mirror --apply: writes per batch before delay."],
+                ["--delay-ms N", "1000", "With --mirror --apply: ms sleep between batches (rate-limit)."],
+                ["--sample-limit N", "15", "With --mirror: max samples in human digest."],
+                ["--json", "(off)", "With --mirror: structured JSON outcome including digest aggregates."],
+                ["--allow-cross-repo", "(off)", "With --mirror --apply: allow non-project repos (#2601)."],
+            ],
+            examples: [
+                "task triage:classify -- --list",
+                "task triage:classify -- --validate",
+                "task triage:classify -- --mirror",
+                "task triage:classify -- --mirror --author @me --repo owner/name",
+                "task triage:classify -- --mirror --repo owner/name --json",
+                "task triage:classify -- --mirror --apply --repo owner/name --batch-size 10 --delay-ms 1000",
+                "task triage:classify -- --mirror --include-closed --repo owner/name",
+            ],
+            see_also: [
+                "task triage:bootstrap",
+                "task triage:queue",
+                "task vbrief:reconcile:labels",
+                "#1119 / D10",
+                "#1423",
+                "#3125",
+                "#3129",
             ],
-            examples: ["task triage:classify -- --list", "task triage:classify -- --validate"],
-            see_also: ["task triage:bootstrap", "task triage:queue", "#1119 / D10"],
             placeholder: false,
         },
         "task triage:bootstrap": {
@@ -473,40 +529,79 @@ export const registryData = {
             see_also: ["task triage:subscribe", "task triage:scope", "#1119 / D14"],
             placeholder: false,
         },
-        "task triage:audit:prune": {
-            name: "task triage:audit:prune",
-            summary: "Operator-invoked archive of closed-terminal entries",
-            refs: "(D19, coming)",
-            description: "Move closed-terminal audit entries (accept/reject/mark-duplicate after the upstream issue is closed) into the archive sidecar so the live cache stays focused on open work.",
-            usage: "task triage:audit:prune [-- --dry-run] [--older-than-days N]",
+        "task triage:cache-archive": {
+            name: "task triage:cache-archive",
+            summary: "Reversible archive of closed github-issue cache entries",
+            refs: "(#1137)",
+            description: "Move closed-and-aged live `.deft-cache/github-issue/` entries under `.deft-cache/archived/github-issue/...` with archive-meta.json. Operator-only; never auto on check/session/sync. Distinct from task cache:prune (TTL hard-delete). Skips issues referenced in xbrief/{proposed,pending,active}. Alias: cache:archive-closed.",
+            usage: "task triage:cache-archive -- [--dry-run] [--older-than-days 30] [--repo owner/name] [--json] [--terminal-decision-only]",
             flags: [
-                ["--dry-run", "(off)", "Preview eligible entries without writing."],
-                ["--older-than-days N", "30", "Age threshold."],
+                ["--dry-run", "(off)", "Report eligible entries without moving."],
+                ["--older-than-days N", "30", "Minimum age of closed_at (or fetched_at/mtime fallback)."],
+                ["--repo owner/name", "(all)", "Limit to one repo."],
+                ["--json", "(off)", "Structured summary."],
+                [
+                    "--terminal-decision-only",
+                    "(off)",
+                    "Only archive when latest candidates decision is reject or mark-duplicate.",
+                ],
             ],
-            examples: ["task triage:audit:prune -- --dry-run"],
-            see_also: ["task triage:archive-list", "task triage:restore-from-archive", "#1119 / D19"],
-            placeholder: true,
+            examples: [
+                "task triage:cache-archive -- --dry-run",
+                "task triage:cache-archive -- --older-than-days 30 --repo deftai/directive",
+            ],
+            see_also: [
+                "task triage:archive-list",
+                "task triage:restore-from-archive",
+                "task cache:prune",
+                "#1137",
+            ],
+            placeholder: false,
         },
         "task triage:archive-list": {
             name: "task triage:archive-list",
-            summary: "List archived entries",
-            refs: "(D19, coming)",
-            description: "Read-only listing of archived audit entries from the archive sidecar. Useful before restoring an entry.",
-            usage: "task triage:archive-list [-- --since=WINDOW]",
-            flags: [["--since WINDOW", "(all)", "Time window (e.g. '30d', '6mo')."]],
-            examples: ["task triage:archive-list"],
-            see_also: ["task triage:audit:prune", "#1119 / D19"],
-            placeholder: true,
+            summary: "List archived github-issue cache entries",
+            refs: "(#1137)",
+            description: "List `.deft-cache/archived/github-issue/...` entries newest archived_at first. Alias: cache:archive-list.",
+            usage: "task triage:archive-list -- [--repo owner/name] [--format=json] [--since ISO] [--limit N]",
+            flags: [
+                ["--repo owner/name", "(all)", "Limit to one repo."],
+                ["--format=json", "text", "JSON listing."],
+                ["--since ISO", "(none)", "Only entries archived at/after this timestamp."],
+                ["--limit N", "(none)", "Cap result count."],
+            ],
+            examples: ["task triage:archive-list -- --format=json"],
+            see_also: ["task triage:cache-archive", "task triage:restore-from-archive", "#1137"],
+            placeholder: false,
         },
         "task triage:restore-from-archive": {
             name: "task triage:restore-from-archive",
-            summary: "Restore archived entry to live cache",
-            refs: "(D19, coming)",
-            description: "Move an archived entry back to the live audit log so it becomes visible to triage:queue / triage:audit again.",
-            usage: "task triage:restore-from-archive -- <N>",
-            flags: [["<N>", "(required)", "Archived entry number to restore."]],
-            examples: ["task triage:restore-from-archive -- 42"],
-            see_also: ["task triage:archive-list", "#1119 / D19"],
+            summary: "Restore archived issue entry to live cache",
+            refs: "(#1137)",
+            description: "Move an archived github-issue entry back to the live key path. Idempotent if already live with matching content; refuse live conflict unless --force. Alias: cache:restore-from-archive.",
+            usage: "task triage:restore-from-archive -- --issue N --repo owner/name [--force]",
+            flags: [
+                ["--issue N", "(required unless --key)", "Issue number."],
+                ["--repo owner/name", "(required with --issue)", "Upstream repo."],
+                ["--key owner/repo/N", "(alt)", "Full cache key."],
+                ["--force", "(off)", "Replace live path when content differs."],
+            ],
+            examples: ["task triage:restore-from-archive -- --issue 1234 --repo deftai/directive"],
+            see_also: ["task triage:cache-archive", "task triage:show", "#1137"],
+            placeholder: false,
+        },
+        "task triage:audit:prune": {
+            name: "task triage:audit:prune",
+            summary: "Legacy name — use triage:cache-archive",
+            refs: "(#1137 supersedes D19 name)",
+            description: "Historical D19 placeholder name. Implemented surface is task triage:cache-archive (reversible closed github-issue cache archive). Do not confuse with task cache:prune (TTL hard-delete).",
+            usage: "task triage:cache-archive -- [--dry-run] [--older-than-days N]",
+            flags: [
+                ["--dry-run", "(off)", "Preview eligible entries without writing."],
+                ["--older-than-days N", "30", "Age threshold."],
+            ],
+            examples: ["task triage:cache-archive -- --dry-run"],
+            see_also: ["task triage:cache-archive", "task triage:archive-list", "#1137"],
             placeholder: true,
         },
         "task triage:audit-log:rotate": {

package/dist/triage/index.d.ts

@@ -7,6 +7,7 @@
  * ...) without colliding.
  */
 export * as actions from "./actions/index.js";
+export * as authorFilter from "./author-filter.js";
 export * as bootstrap from "./bootstrap/index.js";
 export * as bulk from "./bulk/index.js";
 export * as cachePath from "./cache-path.js";

package/dist/triage/index.js

@@ -7,6 +7,7 @@
  * ...) without colliding.
  */
 export * as actions from "./actions/index.js";
+export * as authorFilter from "./author-filter.js";
 export * as bootstrap from "./bootstrap/index.js";
 export * as bulk from "./bulk/index.js";
 export * as cachePath from "./cache-path.js";

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

@@ -1,3 +1,4 @@
+export { type AuthorFilter, type AuthorFilterResolveResult, type AuthorPartitionResult, authorLoginFromRawIssue, defaultResolveAuthenticatedLogin, formatAuthorFilterLine, matchesAuthorFilter, normalizeAuthorLogin, parseAuthorTokens, partitionByAuthorFilter, type ResolveAuthenticatedLogin, resolveAuthorFilter, } from "../author-filter.js";
 export * from "./audit.js";
 export * from "./build-queue.js";
 export * from "./cache.js";

package/dist/triage/queue/index.js

@@ -1,3 +1,4 @@
+export { authorLoginFromRawIssue, defaultResolveAuthenticatedLogin, formatAuthorFilterLine, matchesAuthorFilter, normalizeAuthorLogin, parseAuthorTokens, partitionByAuthorFilter, resolveAuthorFilter, } from "../author-filter.js";
 export * from "./audit.js";
 export * from "./build-queue.js";
 export * from "./cache.js";

package/dist/triage/queue/render.d.ts

@@ -5,5 +5,7 @@ export declare function renderQueue(options: {
     readonly repo: string;
     readonly limit?: number | null;
     readonly rankingLabels?: readonly string[];
+    /** Active author filter disclosure line (#3129 / #1318 Layer 1). */
+    readonly authorFilterLine?: string | null;
 }): string;
 //# sourceMappingURL=render.d.ts.map

package/dist/triage/queue/render.js

@@ -16,6 +16,12 @@ export function renderQueue(options) {
     else {
         lines.push("  consumer ranking labels: <empty> (framework default; within-group = updated_at desc)");
     }
+    if (options.authorFilterLine !== null && options.authorFilterLine !== undefined) {
+        const line = options.authorFilterLine.trim();
+        if (line.length > 0) {
+            lines.push(`  ${line}`);
+        }
+    }
     if (options.limit !== null && options.limit !== undefined) {
         lines.push(`  limit: ${options.limit}`);
     }

package/dist/triage/queue/show.d.ts

@@ -58,7 +58,7 @@ export declare function extractBodySummary(body: string, maxLines?: number): str
  * Looks for AC / Acceptance headings and checkbox / bullet lists under them.
  */
 export declare function extractAcceptanceCriteria(body: string): readonly string[];
-/** Operator-facing pasteable brief backbone for Phase 3 decisions (#2890). */
+/** Operator-facing pasteable brief backbone for Phase 3 decisions (#2890 / #3116). */
 export declare function renderOperatorBrief(options: {
     readonly issue: CachedIssueDetail | null;
     readonly repo: string;

package/dist/triage/queue/show.js

@@ -245,7 +245,7 @@ export function extractAcceptanceCriteria(body) {
     }
     return bullets.slice(0, 12);
 }
-/** Operator-facing pasteable brief backbone for Phase 3 decisions (#2890). */
+/** Operator-facing pasteable brief backbone for Phase 3 decisions (#2890 / #3116). */
 export function renderOperatorBrief(options) {
     const lines = [];
     lines.push(`triage:show --format=operator -- ${options.repo}#${options.number}`);
@@ -258,9 +258,11 @@ export function renderOperatorBrief(options) {
     const issue = options.issue;
     const link = issue.htmlUrl ?? resolveIssueHtmlUrl(options.repo, options.number);
     const labels = issue.labels.length > 0 ? issue.labels.map(oneLine).join(", ") : "<none>";
+    // URL-first lead line (#3116): canonical issue URL before title/body fields.
+    lines.push(oneLine(link));
     lines.push(`#${options.number}  ${oneLine(issue.title)}`);
-    lines.push(`link:    ${oneLine(link)}`);
     lines.push(`labels:  ${labels}`);
+    lines.push("validity: (agent-owned — still-open | partial | likely-shipped | needs-re-scope + evidence)");
     lines.push("");
     lines.push("summary:");
     for (const line of extractBodySummary(issue.body).split("\n")) {

package/dist/vbrief-validate/project-definition.js

@@ -78,7 +78,7 @@ export function validateProjectDefinition(filepath, data, vbriefDir) {
                 }
                 const uriRaw = ref.uri;
                 const uri = typeof uriRaw === "string" ? uriRaw : "";
-                if (uri && uri.startsWith("file://")) {
+                if (uri.startsWith("file://")) {
                     const refPath = uri.replace("file://", "");
                     const fullPath = resolve(vbriefDir, refPath);
                     if (!isRelativeTo(fullPath, resolvedRoot)) {

package/dist/verify-env/agent-hook-readiness.d.ts

@@ -0,0 +1,42 @@
+import type { HookHost } from "../hooks/dispatcher.js";
+import type { AgentHookInspection } from "../init-deposit/agent-hooks.js";
+import type { HostHooksPolicy } from "../policy/host-hooks.js";
+import { type AgentHookHealthResult } from "./agent-hooks.js";
+import { type AgentHookLiveProbeResult, type AgentHookLiveProbeSeams } from "./agent-hooks-live-probe.js";
+import type { OutputStream } from "./verify-hooks-installed.js";
+export type AgentHookReadinessRegistration = "registered" | "disabled" | "missing" | "drifted" | "not-applicable";
+export type AgentHookReadinessFunctionality = "functional" | "non-functional" | "unavailable" | "not-run" | "disabled" | "not-applicable";
+export type AgentHookReadinessTrust = "manual-review-required" | "not-applicable" | "disabled";
+export type AgentHookReadinessInterception = "not-directly-verified" | "not-applicable" | "disabled";
+export type AgentHookReadinessLiveStatus = "functional" | "non-functional" | "unavailable" | "not-run" | "disabled" | "skipped";
+export interface AgentHookReadinessHostResult {
+    readonly host: HookHost;
+    readonly registration: AgentHookReadinessRegistration;
+    readonly functionality: AgentHookReadinessFunctionality;
+    readonly trust: AgentHookReadinessTrust;
+    readonly interception: AgentHookReadinessInterception;
+}
+export interface AgentHookReadinessResult {
+    readonly code: 0 | 1 | 2;
+    readonly message: string;
+    readonly stream: OutputStream;
+    readonly skipped: boolean;
+    readonly liveStatus: AgentHookReadinessLiveStatus;
+    readonly hosts: readonly AgentHookReadinessHostResult[];
+    readonly registrations: readonly AgentHookInspection[];
+    readonly liveProbe: AgentHookLiveProbeResult | null;
+}
+export interface AgentHookReadinessOptions {
+    readonly hostHooksPolicy?: HostHooksPolicy;
+    readonly consumerContext?: (projectRoot: string) => boolean;
+    readonly evaluateStructural?: (projectRoot: string, policy: HostHooksPolicy) => AgentHookHealthResult;
+    readonly probeLive?: (projectRoot: string, seams?: AgentHookLiveProbeSeams) => AgentHookLiveProbeResult;
+    readonly liveProbeSeams?: Omit<AgentHookLiveProbeSeams, "hosts">;
+}
+/** Stable CLI JSON projection; keep the four readiness dimensions orthogonal. */
+export declare function agentHookReadinessJson(result: AgentHookReadinessResult): Record<string, unknown>;
+/** Preserve fail-closed readiness semantics when an unexpected evaluator dependency throws. */
+export declare function evaluateAgentHookReadinessSafely(projectRoot: string, evaluate?: (projectRoot: string) => AgentHookReadinessResult): AgentHookReadinessResult;
+/** Fail-closed consumer readiness: structural registration first, installed-shim live probe second. */
+export declare function evaluateAgentHookReadiness(projectRoot: string, options?: AgentHookReadinessOptions): AgentHookReadinessResult;
+//# sourceMappingURL=agent-hook-readiness.d.ts.map