@zq-silk/yui 2.1.0 → 2.3.0

package/README.md

@@ -42,6 +42,10 @@ not from terminal windows you juggle or details you have to remember.
 
 ## Quick start
 
+For the self-built coding Agent (without a Controller or Yui Home), see
+[`yui agent`](docs/native-agent.md). Its explicit configuration and product state
+are separate from the orchestration setup below.
+
 You need Linux x64 (glibc) or macOS (x64 or Apple Silicon), Git, tmux, and
 Node.js `^20.17.0`, `^22.9.0`, `^24.0.0` or `^26.0.0`. On macOS install tmux with
 `brew install tmux`. For the simplest setup, have Codex CLI or Claude Code CLI
@@ -158,8 +162,10 @@ The task list remains at the left, task details occupy the primary reading area,
 and recorded Task messages live in a secondary discussion pane. You can resize,
 swap or hide that pane; on narrow screens it opens over the detail. Native Sessions
 remain separate from recorded Task messages.
-The detail prioritizes user input, native Session activity, Task progress and key
-conclusions; fixed file results and delivery evidence open on demand. See
+The detail has four tabs: Overview (user input, progress and key Decisions),
+Delivery (WorkItems, Reviews, Integration and remote delivery, read on demand),
+Runtime (Roles, native Session activity, open execution and usage) and Records
+(a timeline of Decisions, milestones, executions and questions). See
 [attention and progress](docs/observability/README.md#web-attention-and-progress).
 See [Web permissions](docs/architecture/capabilities-and-resources.md#cli-and-web)
 and [input timing](docs/managed-turn-and-session-runtime.md#input-timing-queue-steer-and-interrupt).

package/dist/cli/commandCatalog.js

@@ -1,5 +1,7 @@
 import { supportedAgentAdapterIds } from "../agent/adapterCatalog.js";
 import { supportedAgentExecutionComponentIds } from "../agent/executionComponents.js";
+import { productConfigurationOptions } from "../nativeAgent/product/config.js";
+import { catalogCommands, catalogCommandOptions } from "../nativeAgent/product/catalog.js";
 import { CONFIG_DEFINITIONS, CONFIG_DOMAINS, configDefinitionsForDomain } from "../config/configCatalog.js";
 function buildNode(input, parentPath = []) {
     const path = [...parentPath, input.name];
@@ -420,9 +422,14 @@ const taskChildren = [
         usage: "yui task archive-preflight <id> (--integrated|--abandon) [--force] [--json]",
         options: ["--integrated", "--abandon", "--force", "--json"]
     },
+    {
+        name: "archive-cleanup", discovery: { surface: "public", audiences: ["public", "operator", "leader"] },
+        summary: "Retry one foreground exact-owner cleanup for an archived Task; retain unsafe resources and all history.",
+        usage: "yui task archive-cleanup <id>"
+    },
     {
         name: "archive", discovery: { surface: "public", audiences: ["public", "operator", "leader"], optionAudiences: { "--force": ["public", "operator"] } },
-        summary: "Archive a terminal Task; explicit --force commits despite delivery/cleanup warnings, retaining unsafe resources.",
+        summary: "Archive settled, delivered, stopped work, then attempt exact-owner cleanup. Retained physical resources do not require --force; force separately bypasses business admission.",
         usage: "yui task archive <id> (--integrated|--abandon) [--force] [--source-message <id> --purpose <verbatim-authorization> --request-id <id>]",
         options: ["--integrated", "--abandon", "--force", "--source-message", "--purpose", "--request-id"]
     },
@@ -794,8 +801,8 @@ const taskChildren = [
             {
                 name: "dispatch", discovery: { surface: "managed", audiences: ["operator", "leader"] },
                 summary: "Dispatch a work item to its Role.",
-                usage: "yui task work dispatch <task>/<work> [--input <text>] [--lane-role <role> ...]",
-                options: ["--input", "--lane-role"]
+                usage: "yui task work dispatch <task>/<work> [--input <text>] [--context-ref <store/refId@digest> ...] [--lane-role <role> ...]",
+                options: ["--input", "--context-ref", "--lane-role"]
             },
             {
                 name: "synthesize", discovery: { surface: "managed", audiences: ["operator", "leader"] },
@@ -990,7 +997,7 @@ const taskChildren = [
             },
             { name: "list", discovery: { surface: "managed", audiences: ["operator", "leader"] }, summary: "List Integration Attempts.", usage: "yui task integration list <task>" },
             { name: "show", discovery: { surface: "managed", audiences: ["operator", "leader"] }, summary: "Show one Integration Attempt.", usage: "yui task integration show <task>/<integration>" },
-            { name: "cleanup", discovery: { surface: "managed", audiences: ["operator", "leader"] }, summary: "Remove a terminal Integration worktree and branch.", usage: "yui task integration cleanup <task>/<integration>" }
+            { name: "cleanup", discovery: { surface: "managed", audiences: ["operator", "leader"] }, summary: "Release clean terminal Integration resources; preserve attempt history, check logs and dirty diagnostics.", usage: "yui task integration cleanup <task>/<integration>" }
         ]
     },
     {
@@ -1113,13 +1120,32 @@ export const ROOT_COMMAND = buildNode({
         { id: "general", title: "General", entries: [
                 "help", "version", "update", "upgrade", "setup", "start", "doctor"
             ] },
-        { id: "workflow", title: "Workflow", entries: ["operator", "role", "project", "task"] },
+        { id: "workflow", title: "Workflow", entries: ["agent", "operator", "role", "project", "task"] },
         { id: "configuration", title: "Configuration", entries: ["config"] },
         { id: "operations", title: "Operations", entries: ["web", "controller", "session", "execution", "capability", "job", "jobs", "telemetry", "release"] },
         { id: "resources", title: "Resources", entries: ["resources"] },
         { id: "internal", title: "Internal", entries: ["internal"] }
     ],
     children: [
+        {
+            name: "agent", discovery: { surface: "public", audiences: ["public", "operator"] },
+            summary: "Run the independent coding Agent without a Controller or Yui Home.",
+            sections: [{ id: "product", title: "Independent Agent", entries: ["check-config", "start", "run", ...catalogCommands] }],
+            children: [
+                { name: "check-config", discovery: { surface: "public", audiences: ["public", "operator"] },
+                    summary: "Validate explicit configuration without model requests or state initialization.",
+                    options: productConfigurationOptions, fileOptions: ["--config"] },
+                { name: "start", discovery: { surface: "public", audiences: ["public", "operator"] },
+                    summary: "Open a foreground line UI; select --session ID to resume saved history.",
+                    options: [...productConfigurationOptions, "--session"], fileOptions: ["--config"] },
+                { name: "run", discovery: { surface: "public", audiences: ["public", "operator"] },
+                    summary: "Submit one input and return real result/save evidence as JSON.",
+                    options: [...productConfigurationOptions, "--session", "--input"], fileOptions: ["--config"] },
+                ...catalogCommands.map(name => ({ name, discovery: { surface: "public", audiences: ["public", "operator"] },
+                    summary: "Use the real persistent Session catalog without starting execution.",
+                    options: catalogCommandOptions(name) }))
+            ]
+        },
         {
             name: "role", discovery: { surface: "public", audiences: ["public", "operator"] },
             summary: "Queue input or control an exact current Global Role Turn.",
@@ -1558,7 +1584,7 @@ export const ROOT_COMMAND = buildNode({
             name: "task", discovery: { surface: "public", audiences: ["public", "operator"] },
             summary: "Manage Tasks, WorkItems, AgentRuns, and integration.",
             sections: [
-                { id: "lifecycle", title: "Lifecycle", entries: ["create", "project", "base", "update", "activate", "activation", "execution", "complete", "cancel", "reopen", "retire", "list", "show", "context", "next-action", "remote-delivery", "archive-preflight", "archive", "replace", "reconcile", "upstream", "artifact"] },
+                { id: "lifecycle", title: "Lifecycle", entries: ["create", "project", "base", "update", "activate", "activation", "execution", "complete", "cancel", "reopen", "retire", "list", "show", "context", "next-action", "remote-delivery", "archive-preflight", "archive", "archive-cleanup", "replace", "reconcile", "upstream", "artifact"] },
                 { id: "collaboration", title: "Collaboration", entries: ["message", "input", "grant", "workflow", "publication", "work", "run", "review", "integration", "role", "overlap", "change-set"] },
                 { id: "knowledge", title: "Task Knowledge", entries: ["brief", "decision", "milestone", "event", "continuation", "wake"] }
             ],

package/dist/cli/commandDiscovery.js

@@ -5,7 +5,10 @@ import { hasManagedIdentity } from "../runtime/managedIdentity.js";
 export function discoveryAudience(env) {
     if (!hasManagedIdentity(env))
         return "public";
-    if (!env.YUI_ROLE || !env.YUI_NATIVE_SESSION_ID)
+    const nativeSessionId = env.YUI_ADAPTER_ID === "codex"
+        ? env.CODEX_THREAD_ID ?? env.YUI_NATIVE_SESSION_ID : env.YUI_NATIVE_SESSION_ID;
+    if (!env.YUI_ROLE || !nativeSessionId || nativeSessionId.trim() !== nativeSessionId
+        || nativeSessionId.includes("\0"))
         return "unbound";
     if (env.YUI_SESSION_SCOPE === "global")
         return env.YUI_ROLE === "operator" ? "operator" : "global";

package/dist/cli/interactionPolicy.js

@@ -236,6 +236,10 @@ export const INTERACTION_POLICIES = Object.freeze([
         ...taskTarget("archive-preflight"),
         trailingOptions: { "--integrated": "flag", "--abandon": "flag", "--force": "flag", "--json": "flag" }
     },
+    {
+        ...taskTarget("archive-cleanup", 2, ["archived"]),
+        confirmation: { action: "Clean archived Task resources", targetArgumentIndex: 2 }
+    },
     {
         ...taskTarget("archive", 2, ["completed", "cancelled"]),
         trailingOptions: { "--integrated": "flag", "--abandon": "flag", "--force": "flag" },