@zq-silk/yui 0.6.13 → 0.6.15

package/README.md

@@ -250,22 +250,36 @@ operation and requires the checkout to be on that branch; detached or mismatched
 
 Use `task context` as the first detailed read of an existing Task. It combines the Task, Brief, active Decisions, recent Milestones, Roles, current and recent WorkItems with their Runs, recent Messages, open and resolved InputRequests, and recent Events. Terminal output keeps histories and long text compact; `yui --json task context <task-id>` returns the complete records in the top-level `data` field.
 
+Leader wakeups stay deliberately small: the wake envelope carries only the
+aggregated wake reasons, a delta window, and read pointers. The durable wake
+ledger is the on-demand read for what changed:
+
+```sh
+yui task wake list <task-id>
+yui task wake show <task-id> <wake-id>
+```
+
+`wake list` shows the dispatch history with status, reasons, and consuming
+Run; `wake show` renders one wake's delta window — the Events, Messages, and
+Runs recorded between its cursors. A human or Agent can still force a wake
+with `yui task wake <task-id> --force --reason "<text>"`.
+
 Human-facing timestamps default to Beijing time (`Asia/Shanghai`) while durable
 records and `--json` data remain UTC/RFC 3339. Inspect or change the IANA
 timezone with:
 
 ```sh
 yui config show
-yui config set --time-zone Europe/London
+yui config set time-zone Europe/London
 ```
 
 WorkItem review is one global, optional rule that reuses an existing Global
 Role's Agent, model, permissions, prompt, and Skills:
 
 ```sh
-yui config review set --role reviewer --trigger always
-yui config review show
-yui config review clear
+yui config set review --role reviewer --trigger always
+yui config show
+yui config clear review
 ```
 
 For Project-backed software delivery, use `--trigger final` to keep WorkItem
@@ -273,7 +287,7 @@ acceptance and Integration independent and run one fresh ReviewRound over the
 complete frozen integrated Task candidate before completion:
 
 ```sh
-yui config review set --role reviewer --trigger final
+yui config set review --role reviewer --trigger final
 ```
 
 Every result entering Leader acceptance is one explicit candidate on its
@@ -343,6 +357,20 @@ yui task create "Update authentication" \
 yui task project add <task-id> shared-sdk --base main
 ```
 
+Project-backed Tasks record the local baseline, redacted remote identity, and
+the remote-tracking commit observed when their main workspace is created.
+Inspect delivery freshness with:
+
+```sh
+yui task base status <task-id>
+yui task base status <task-id> --refresh
+```
+
+The default check is offline and uses local remote-tracking refs. `--refresh`
+is the explicit authorization to query the configured remote; Yui never
+fetches, rebases, merges, or force-pushes as a hidden side effect of Task
+completion.
+
 Implementation WorkItems declare the Projects they may modify. Their workspace
 keeps the same relative layout, creates isolated worktrees only for that write
 scope, and exposes the other Task Projects as context from Task main. Yui puts
@@ -610,6 +638,7 @@ When the requested outcome is finished, complete the Task to stop automatic Lead
 
 ```sh
 yui task complete <task-id> --summary "CSV export shipped and verified"
+yui task complete <task-id> --summary-file delivery.txt --refresh-remote
 yui task reopen <task-id>
 ```
 

package/dist/cli/commandCatalog.js

@@ -1,4 +1,5 @@
 import { supportedAgentAdapterIds } from "../agent/adapterCatalog.js";
+import { CONFIG_KEYS } from "../commands/configCommands.js";
 function buildNode(input, parentPath = []) {
     const path = [...parentPath, input.name];
     const children = (input.children ?? []).map((child) => buildNode(child, path));
@@ -36,6 +37,24 @@ function buildNode(input, parentPath = []) {
 function freezeRecord(record) {
     return Object.freeze(Object.fromEntries(Object.entries(record ?? {}).map(([key, values]) => [key, Object.freeze([...values])])));
 }
+const CONFIG_KEY_VALUES = [
+    { name: "time-zone", summary: "IANA timezone for human-facing timestamps (default: Asia/Shanghai)." },
+    { name: "reconciliation-interval-seconds", summary: "Recovery reconciliation interval, 5-300 seconds (default: 120)." },
+    { name: "leader-next-action", summary: "Leader next-action mode: display, warn, or enforce (default: display)." },
+    { name: "context-budget", summary: "Per-Session context token budget; set with --soft-tokens <n> --hard-tokens <n> (default: soft 100000 / hard 120000)." },
+    { name: "resources-gc-mode", summary: "Resource GC mode: report or quarantine (default: report)." },
+    { name: "resources-gc-auto-quarantine", summary: "Auto-quarantine terminal Task resources: true or false (default: false)." },
+    { name: "provider-retry-mode", summary: "Provider retry mode: off, shadow, or enforce (default: enforce)." },
+    { name: "provider-retry-adapters", summary: "Adapters with in-place retry: all, comma-separated adapter ids, or off (default: all)." },
+    { name: "provider-retry-max-window-ms", summary: "Total retry budget per Run lineage in milliseconds (default: 600000)." },
+    { name: "yield-receipt-replay", summary: "Replay committed yield receipts on resend: true or false (default: true)." },
+    { name: "tmux-bin", summary: "Path to the tmux binary (default: tmux)." },
+    { name: "git-bin", summary: "Path to the git binary (default: git)." },
+    { name: "telemetry-mode", summary: "Telemetry mode: legacy, dual, or bounded (default: legacy)." },
+    { name: "telemetry-terminal-keep", summary: "Telemetry terminal retention count (default: 200)." },
+    { name: "telemetry-run-cap", summary: "Telemetry per-run row cap (default: 50000)." },
+    { name: "review", summary: "Global WorkItem review rule; set with --role <global-role> --trigger <always|leader|final> [--finding-ledger <shadow|enforce>] [--delta-recheck <enabled|disabled>] (default: disabled)." }
+];
 const agentChildren = [
     {
         name: "add",
@@ -195,10 +214,23 @@ const taskChildren = [
     {
         name: "complete",
         summary: "Complete an active Task and stop automatic wakeups.",
-        usage: "yui task complete <id> (--summary <text>|--summary-file <path|->)",
-        options: ["--summary", "--summary-file"],
+        usage: "yui task complete <id> (--summary <text>|--summary-file <path|->) [--refresh-remote]",
+        options: ["--summary", "--summary-file", "--refresh-remote"],
         fileOptions: ["--summary-file"]
     },
+    {
+        name: "base",
+        summary: "Inspect Task Project baseline freshness.",
+        sections: [{ id: "manage", title: "Commands", entries: ["status"] }],
+        children: [
+            {
+                name: "status",
+                summary: "Classify Task Project bases against local or refreshed remote refs.",
+                usage: "yui task base status <task> [--refresh]",
+                options: ["--refresh"]
+            }
+        ]
+    },
     { name: "reopen", summary: "Reopen a completed Task.", usage: "yui task reopen <id>" },
     {
         name: "retire",
@@ -246,13 +278,12 @@ const taskChildren = [
             {
                 name: "list",
                 summary: "List legacy Task refs and their live owners.",
-                usage: "yui task history list [--task <task>]"
+                usage: "yui task history list [task]"
             },
             {
                 name: "archive",
                 summary: "Archive legacy Task refs without a live owner.",
-                usage: "yui task history archive [<task>] [--force]",
-                options: ["--force"]
+                usage: "yui task history archive [task]"
             }
         ]
     },
@@ -271,10 +302,19 @@ const taskChildren = [
                 name: "send",
                 summary: "Send a Task message.",
                 usage: "yui task message send <id> (<body>|--body-file <path|->) [--wake-policy leader|none] [--delivery-mode followup|steer]",
-                options: ["--body-file"],
+                options: ["--body-file", "--wake-policy", "--delivery-mode"],
+                optionValues: {
+                    "--wake-policy": ["leader", "none"],
+                    "--delivery-mode": ["followup", "steer"]
+                },
                 fileOptions: ["--body-file"]
             },
-            { name: "list", summary: "List Task messages.", usage: "yui task message list <id>" }
+            {
+                name: "list",
+                summary: "List Task messages.",
+                usage: "yui task message list <id> [--after <timestamp>] [--limit <n>]",
+                options: ["--after", "--limit"]
+            }
         ]
     },
     {
@@ -383,6 +423,29 @@ const taskChildren = [
             }
         ]
     },
+    {
+        name: "publication",
+        summary: "Record external PR/MR publication evidence for a Task.",
+        sections: [{ id: "manage", title: "Commands", entries: ["add", "list", "show"] }],
+        children: [
+            {
+                name: "add",
+                summary: "Record an external PR/MR and its publication state.",
+                usage: "yui task publication add <task> --project <project> --provider <github|gitlab> --repository <owner/name> --kind <pull-request|merge-request> --id <external-id> [--url <url>] [--title <text>] [--source-branch <branch>] [--target-branch <branch>] [--local-commit <sha>] [--remote-commit <sha>] [--state <open|merged|closed>] [--reported|--verified] [--evidence <text>] [--supersede <publication-id>] [--merged-at <iso-timestamp>]",
+                options: ["--project", "--provider", "--repository", "--kind", "--id", "--url", "--title", "--source-branch", "--target-branch", "--local-commit", "--remote-commit", "--state", "--reported", "--verified", "--evidence", "--supersede", "--merged-at"]
+            },
+            {
+                name: "list",
+                summary: "List external publication evidence for a Task.",
+                usage: "yui task publication list <task>"
+            },
+            {
+                name: "show",
+                summary: "Show one external publication reference.",
+                usage: "yui task publication show (<task>/<publication-id> | <task> <publication-id>)"
+            }
+        ]
+    },
     {
         name: "role",
         summary: "Manage Roles within a Task.",
@@ -549,9 +612,14 @@ const taskChildren = [
     {
         name: "run",
         summary: "Inspect and control Task Role Agent Runs.",
-        sections: [{ id: "manage", title: "Commands", entries: ["list", "retry", "settle", "recover", "yield", "checkpoint"] }],
+        sections: [{ id: "manage", title: "Commands", entries: ["list", "show", "retry", "settle", "recover", "yield", "checkpoint"] }],
         children: [
             { name: "list", summary: "List Runs for a work item.", usage: "yui task run list <task>/<work>" },
+            {
+                name: "show",
+                summary: "Show one Run with its canonical recovery fence and exact recovery actions.",
+                usage: "yui task run show <task>/<run> [--json]"
+            },
             {
                 name: "retry",
                 summary: "Retry a failed execution Run or request a fresh Round for an exact failed final Review Run.",
@@ -565,8 +633,8 @@ const taskChildren = [
             {
                 name: "recover",
                 summary: "Record one exact Leader-controlled Run recovery decision.",
-                usage: "yui task run recover <task>/<run> --action <diagnose|retry|replace-session|terminate> --expected-progress-at <timestamp> --provider-acceptance <accepted|rejected|ambiguous> --reason <text>",
-                options: ["--action", "--expected-progress-at", "--provider-acceptance", "--reason", "--role", "--agent-id", "--adapter-id", "--native-session-id", "--launch-id"]
+                usage: "yui task run recover <task>/<run> --action <diagnose|retry|replace-session|terminate> (--expected-progress-at <timestamp>|--from-next-action <fingerprint>) --provider-acceptance <accepted|rejected|ambiguous> --reason <text>",
+                options: ["--action", "--expected-progress-at", "--progress-at", "--from-next-action", "--provider-acceptance", "--reason", "--role", "--agent-id", "--adapter-id", "--native-session-id", "--launch-id"]
             },
             {
                 name: "yield",
@@ -593,8 +661,8 @@ const taskChildren = [
             {
                 name: "request",
                 summary: "Request one Task-local final ReviewRound from a Global Role.",
-                usage: "yui task review request <task> --role <global-role> [--strategy fixed:<count>|adaptive:<max>] [--lane-role <role> ...]",
-                options: ["--role", "--strategy", "--lane-role"]
+                usage: "yui task review request <task> --role <global-role> [--strategy fixed:<count>|adaptive:<max>] [--lane-role <role> ...] [--delta-recheck]",
+                options: ["--role", "--strategy", "--lane-role", "--delta-recheck"]
             },
             {
                 name: "group",
@@ -764,10 +832,37 @@ const taskChildren = [
         summary: "Inspect the durable Task event history.",
         sections: [{ id: "manage", title: "Commands", entries: ["list", "show"] }],
         children: [
-            { name: "list", summary: "List Task events.", usage: "yui task event list <task>" },
+            {
+                name: "list",
+                summary: "List Task events.",
+                usage: "yui task event list <task> [--after <timestamp>] [--limit <n>]",
+                options: ["--after", "--limit"]
+            },
             { name: "show", summary: "Show one Task event.", usage: "yui task event show <task> <event>" }
         ]
     },
+    {
+        name: "continuation",
+        summary: "Inspect native Provider child continuations and their durability mode.",
+        sections: [{ id: "manage", title: "Commands", entries: ["list"] }],
+        children: [
+            {
+                name: "list",
+                summary: "List native child continuations for a Task.",
+                usage: "yui task continuation list <task> [--json]",
+                options: ["--json"]
+            }
+        ]
+    },
+    {
+        name: "wake",
+        summary: "Inspect the durable Leader wake ledger and its delta content.",
+        sections: [{ id: "manage", title: "Commands", entries: ["list", "show"] }],
+        children: [
+            { name: "list", summary: "List recorded Leader wakes.", usage: "yui task wake list <task>" },
+            { name: "show", summary: "Show one wake and its delta content.", usage: "yui task wake show <task> <wake>" }
+        ]
+    },
     {
         name: "overlap",
         summary: "Show read-only cross-Task overlap diagnostics.",
@@ -933,51 +1028,28 @@ export const ROOT_COMMAND = buildNode({
         {
             name: "config",
             summary: "Inspect or update Yui configuration.",
-            sections: [{ id: "manage", title: "Commands", entries: ["show", "set", "review", "leader-next-action"] }],
+            sections: [{ id: "manage", title: "Commands", entries: ["show", "set", "clear"] }],
             children: [
                 { name: "show", summary: "Show effective Yui configuration." },
                 {
                     name: "set",
-                    summary: "Update Yui configuration.",
-                    usage: "yui config set <--time-zone <IANA timezone> | --reconciliation-interval-seconds <5-300> | --resources-gc-mode <report|quarantine> | --resources-gc-auto-quarantine <true|false>>",
-                    options: ["--time-zone", "--reconciliation-interval-seconds", "--resources-gc-mode", "--resources-gc-auto-quarantine"],
+                    summary: "Set one Yui configuration key.",
+                    usage: "yui config set <key> <value...>",
+                    sections: [{ id: "keys", title: "Configuration keys", entries: [...CONFIG_KEYS] }],
+                    values: CONFIG_KEY_VALUES,
+                    options: ["--role", "--trigger", "--finding-ledger", "--delta-recheck", "--delta-recheck-max-lines", "--delta-recheck-max-files"],
                     optionValues: {
-                        "--resources-gc-mode": ["report", "quarantine"],
-                        "--resources-gc-auto-quarantine": ["true", "false"]
+                        "--trigger": ["always", "leader", "final"],
+                        "--finding-ledger": ["shadow", "enforce"],
+                        "--delta-recheck": ["enabled", "disabled"]
                     }
                 },
                 {
-                    name: "review",
-                    summary: "Configure WorkItem review.",
-                    sections: [{ id: "manage", title: "Commands", entries: ["show", "set", "clear"] }],
-                    children: [
-                        { name: "show", summary: "Show the global review rule." },
-                        {
-                            name: "set",
-                            summary: "Enable review with a Global Role.",
-                            usage: "yui config review set --role <global-role> --trigger <always|leader|final> [--finding-ledger <shadow|enforce>]",
-                            options: ["--role", "--trigger", "--finding-ledger"],
-                            optionValues: {
-                                "--trigger": ["always", "leader", "final"],
-                                "--finding-ledger": ["shadow", "enforce"]
-                            }
-                        },
-                        { name: "clear", summary: "Disable global review." }
-                    ]
-                },
-                {
-                    name: "leader-next-action",
-                    summary: "Configure the Leader next-action/duplicate-guard mode.",
-                    sections: [{ id: "manage", title: "Commands", entries: ["show", "set", "clear"] }],
-                    children: [
-                        { name: "show", summary: "Show the Leader next-action mode." },
-                        {
-                            name: "set",
-                            summary: "Set the Leader next-action mode (display|warn|enforce).",
-                            usage: "yui config leader-next-action set <display|warn|enforce>"
-                        },
-                        { name: "clear", summary: "Reset to the default display mode." }
-                    ]
+                    name: "clear",
+                    summary: "Reset one Yui configuration key to its default.",
+                    usage: "yui config clear <key>",
+                    sections: [{ id: "keys", title: "Configuration keys", entries: [...CONFIG_KEYS] }],
+                    values: CONFIG_KEY_VALUES
                 }
             ]
         },
@@ -1061,23 +1133,23 @@ export const ROOT_COMMAND = buildNode({
                 {
                     name: "knowledge",
                     summary: "Manage durable Project knowledge stored by Yui.",
-                    sections: [{ id: "manage", title: "Commands", entries: ["add", "update", "retire", "list", "show"] }],
+                    sections: [
+                        {
+                            id: "manage",
+                            title: "Commands",
+                            entries: ["add", "retire", "list", "show", "propose", "proposals", "accept", "reject"]
+                        }
+                    ],
                     children: [
                         {
                             name: "add",
-                            summary: "Add Project knowledge.",
+                            summary: "Add Project knowledge (Operator authority).",
                             usage: "yui project knowledge add <project> <title> --body <text>",
                             options: ["--body"]
                         },
-                        {
-                            name: "update",
-                            summary: "Update active Project knowledge.",
-                            usage: "yui project knowledge update <project> <knowledge> [--title <text>] [--body <text>]",
-                            options: ["--title", "--body"]
-                        },
                         {
                             name: "retire",
-                            summary: "Retire Project knowledge without deleting its record.",
+                            summary: "Retire Project knowledge without deleting its record (Operator authority).",
                             usage: "yui project knowledge retire <project> <knowledge>"
                         },
                         {
@@ -1090,6 +1162,44 @@ export const ROOT_COMMAND = buildNode({
                             name: "show",
                             summary: "Read one Project knowledge entry.",
                             usage: "yui project knowledge show <project> <knowledge>"
+                        },
+                        {
+                            name: "propose",
+                            summary: "Propose a Task conclusion for promotion into Project knowledge.",
+                            usage: "yui project knowledge propose <project> --title <text> --body <text> --task <task>"
+                                + " [--decision <id>] [--milestone <id>] [--commit <sha>] [--scope <text>]"
+                                + " [--expires-when <text>] [--supersedes <knowledge-id>]",
+                            options: ["--title", "--body", "--task", "--decision", "--milestone", "--commit", "--scope", "--expires-when", "--supersedes"]
+                        },
+                        {
+                            name: "proposals",
+                            summary: "List or show Knowledge promotion proposals.",
+                            sections: [{ id: "manage", title: "Commands", entries: ["list", "show"] }],
+                            children: [
+                                {
+                                    name: "list",
+                                    summary: "List Knowledge promotion proposals (pending by default).",
+                                    usage: "yui project knowledge proposals list <project> [--status pending|accepted|rejected] [--all]",
+                                    options: ["--status", "--all"]
+                                },
+                                {
+                                    name: "show",
+                                    summary: "Show one Knowledge promotion proposal.",
+                                    usage: "yui project knowledge proposals show <project> <proposal>"
+                                }
+                            ]
+                        },
+                        {
+                            name: "accept",
+                            summary: "Accept a Knowledge promotion proposal (Operator authority).",
+                            usage: "yui project knowledge accept <project> <proposal> [--update <knowledge-id>]",
+                            options: ["--update"]
+                        },
+                        {
+                            name: "reject",
+                            summary: "Reject a Knowledge promotion proposal (Operator authority).",
+                            usage: "yui project knowledge reject <project> <proposal> --reason <text>",
+                            options: ["--reason"]
                         }
                     ]
                 }
@@ -1127,9 +1237,9 @@ export const ROOT_COMMAND = buildNode({
             name: "task",
             summary: "Manage Tasks, WorkItems, Agent Runs, and integration.",
             sections: [
-                { id: "lifecycle", title: "Lifecycle", entries: ["create", "project", "update", "activate", "complete", "reopen", "retire", "list", "show", "context", "next-action", "archive", "rebuild", "history", "replace", "reconcile"] },
-                { id: "collaboration", title: "Collaboration", entries: ["message", "input", "grant", "workflow", "work", "run", "review", "integration", "role", "enter", "overlap", "change-set"] },
-                { id: "knowledge", title: "Task Knowledge", entries: ["brief", "decision", "milestone", "event"] }
+                { id: "lifecycle", title: "Lifecycle", entries: ["create", "project", "base", "update", "activate", "complete", "reopen", "retire", "list", "show", "context", "next-action", "archive", "rebuild", "history", "replace", "reconcile"] },
+                { id: "collaboration", title: "Collaboration", entries: ["message", "input", "grant", "workflow", "publication", "work", "run", "review", "integration", "role", "enter", "overlap", "change-set"] },
+                { id: "knowledge", title: "Task Knowledge", entries: ["brief", "decision", "milestone", "event", "continuation", "wake"] }
             ],
             children: taskChildren
         },

package/dist/cli/helpRenderer.js

@@ -28,7 +28,9 @@ function describeOption(option) {
         "--project": "Select a Project.",
         "--role": "Select a Task role.",
         "--summary": "Set summary text.",
-        "--task": "Select a Task."
+        "--task": "Select a Task.",
+        "--trigger": "Set the review trigger (always, leader, final).",
+        "--finding-ledger": "Set the review finding ledger mode (shadow, enforce)."
     };
     return descriptions[option] ?? `Set ${option.slice(2).replaceAll("-", " ")}.`;
 }