@deftai/directive-core 0.95.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; Tier-1 SCM label mirror";
-            readonly refs: "(D10 / #1129, #1423 Wave 1)";
-            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 runs the Tier-1 deterministic SCM label mirror over the github-issue cache (dry-run default; --apply writes via SCM boundary). Never calls triage:accept / never writes proposed/ xBRIEFs.";
-            readonly usage: "task triage:classify -- [--list | --validate | --mirror [--apply] [--repo owner/name] [--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)", "Tier-1 label mirror: classify cache → planned/applied labels (dry-run default)."], readonly ["--apply", "(off)", "With --mirror: write labels via SCM (requires github SCM boundary)."], readonly ["--repo owner/name", "(all cached)", "Limit mirror to one repo."], readonly ["--json", "(off)", "With --mirror: structured JSON outcome."], 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 --apply --repo owner/name"];
-            readonly see_also: readonly ["task triage:bootstrap", "task triage:queue", "task vbrief:reconcile:labels", "#1119 / D10", "#1423"];
+            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,28 +277,49 @@ export const registryData = {
         },
         "task triage:classify": {
             name: "task triage:classify",
-            summary: "Inspect / validate auto-classification surface; Tier-1 SCM label mirror",
-            refs: "(D10 / #1129, #1423 Wave 1)",
-            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 runs the Tier-1 deterministic SCM label mirror over the github-issue cache (dry-run default; --apply writes via SCM boundary). Never calls triage:accept / never writes proposed/ xBRIEFs.",
-            usage: "task triage:classify -- [--list | --validate | --mirror [--apply] [--repo owner/name] [--json] [--allow-cross-repo]]",
+            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 + triageLabelMirror."],
                 [
                     "--mirror",
                     "(off)",
-                    "Tier-1 label mirror: classify cache → planned/applied labels (dry-run default).",
+                    "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).",
                 ],
-                ["--apply", "(off)", "With --mirror: write labels via SCM (requires github SCM boundary)."],
+                ["--author-mine", "(off)", "With --mirror: alias for --author @me (#3129)."],
                 ["--repo owner/name", "(all cached)", "Limit mirror to one repo."],
-                ["--json", "(off)", "With --mirror: structured JSON outcome."],
+                ["--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 --apply --repo owner/name",
+                "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",
@@ -293,6 +327,8 @@ export const registryData = {
                 "task vbrief:reconcile:labels",
                 "#1119 / D10",
                 "#1423",
+                "#3125",
+                "#3129",
             ],
             placeholder: false,
         },
@@ -493,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.95.0",
+  "version": "0.96.0",
   "description": "TypeScript engine core for the Directive framework.",
   "license": "MIT",
   "type": "module",
@@ -247,6 +247,10 @@
       "types": "./dist/freshness/index.d.ts",
       "default": "./dist/freshness/index.js"
     },
+    "./parent-turn-shape": {
+      "types": "./dist/parent-turn-shape/index.d.ts",
+      "default": "./dist/parent-turn-shape/index.js"
+    },
     "./intake": {
       "types": "./dist/intake/index.d.ts",
       "default": "./dist/intake/index.js"
@@ -346,8 +350,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.95.0",
-    "@deftai/directive-types": "^0.95.0",
+    "@deftai/directive-content": "^0.96.0",
+    "@deftai/directive-types": "^0.96.0",
     "archiver": "^8.0.0"
   },
   "scripts": {