@zq-silk/yui 1.0.0 → 1.0.1

package/dist/commands/taskCommands.js

@@ -827,9 +827,8 @@ function createTaskCommand(args, store, options) {
     return output(`Created Draft task ${created.task.id}: ${created.task.title}\n`
         + `Assigned role: ${created.leader.name}\n`
         + `Type: ${created.task.type ?? "unspecified"}\n`
-        + (created.task.projectBindings.length > 0
-            ? "Execution: Leader decides whether independent WorkItems are warranted\n"
-            : "Execution: no Project delivery evidence required\n"), {
+        + "Status: Draft; discussion and development have not started\n"
+        + "Next: explicitly submit with intent discuss or develop when the Task should start\n", {
         task: created.task,
         leader: created.leader
     });

package/dist/executor/fileRoleLaunchPlanner.js

@@ -17,7 +17,7 @@ import { managedRuntimeAdmission } from "../runtime/agentDriver.js";
 import { builtinAgentEndpointImplementation, validateAgentEndpointImplementation } from "../runtime/agentEndpointIdentity.js";
 import { builtinAgentDriverRegistry, builtinDriverIdForAdapter } from "../runtime/builtinAgentDrivers.js";
 import { assertProviderConversationReplaceable } from "../runtime/providerRuntimeIdentity.js";
-import { resolveTaskRoleSessionTitle } from "../runtime/sessionTitle.js";
+import { operatorSessionTitle, resolveTaskRoleSessionTitle } from "../runtime/sessionTitle.js";
 import { parseTaskRuntimeIsolationDescriptor, taskRuntimeIsolationEnvironment } from "../runtime/taskRuntimeIsolation.js";
 import { planningRuntimeCwd } from "../storage/homeLayout.js";
 import { resolveAgentAdapter } from "./agentAdapter.js";
@@ -33,6 +33,7 @@ export class FileRoleLaunchPlanner {
     #agentEnvironment;
     #nativeAgentEnvironment;
     #createNativeSessionId;
+    #now;
     #cliPath;
     #inspectWorkspacePhysicalState;
     #entryPoint;
@@ -51,6 +52,7 @@ export class FileRoleLaunchPlanner {
         this.#agentEnvironment = this.#selectConfiguredAgentEnvironment(sourceEnvironment);
         this.#nativeAgentEnvironment = this.#selectConfiguredNativeEnvironment(sourceEnvironment);
         this.#createNativeSessionId = options.createNativeSessionId ?? randomUUID;
+        this.#now = options.now ?? (() => new Date());
         this.#inspectWorkspacePhysicalState = options.inspectWorkspacePhysicalState
             ?? inspectWorkspacePhysicalState;
         this.#cliPath = canonicalPath(options.cliPath
@@ -259,7 +261,9 @@ export class FileRoleLaunchPlanner {
         if (input.mode === "new" && sessionSet?.providerBinding != null) {
             assertProviderConversationReplaceable(sessionSet.providerBinding);
         }
-        return this.#compile(role, input, { scope: "global" }, undefined, input.mode === "resume" && compatibleExisting ? existing.nativeSessionId : undefined, undefined, effective, { purpose: "execution" });
+        return this.#compile(role, input, { scope: "global" }, input.mode === "new" && role.name === "operator"
+            ? operatorSessionTitle(this.#now(), this.store.getConfig().timeZone)
+            : undefined, input.mode === "resume" && compatibleExisting ? existing.nativeSessionId : undefined, undefined, effective, { purpose: "execution" });
     }
     #compile(role, input, owner, sessionTitle, knownNativeSessionId, workspaceOverride, effective, sessionPolicy) {
         const launchRole = effectiveRoleForLaunch(role, effective);
@@ -389,11 +393,16 @@ export class FileRoleLaunchPlanner {
         const effectiveConfig = withNativeProjectDirectories(roleConfig, effective.executionEnvironment === undefined
             ? nativeAdditionalDirectories(effective.workspace, agentWorkspace)
             : []);
+        const postCreateOperatorTitle = owner.scope === "global"
+            && role.name === "operator"
+            && sessionTitle !== undefined;
         const compileInput = {
             agent,
             config: effectiveConfig,
             workspace: agentWorkspace,
-            ...(sessionTitle === undefined ? {} : { sessionTitle }),
+            ...(sessionTitle === undefined || postCreateOperatorTitle
+                ? {}
+                : { sessionTitle }),
             ...sessionContext
         };
         if (input.mode === "resume"

package/dist/runtime/agentHost.js

@@ -328,7 +328,12 @@ export async function runAgentHost(input) {
                 kind: "restore",
                 mode: "resume",
                 nativeSessionId: disconnectedSession.nativeSessionId,
+                // The dated Operator title is a one-shot effect of creating the
+                // Conversation. Reattaching this client must not replay metadata whose
+                // earlier outcome may be unknown.
                 ...(previousControl.sessionTitle === undefined
+                    || (currentPayload.environment.YUI_SESSION_SCOPE === "global"
+                        && currentPayload.environment.YUI_ROLE === "operator")
                     ? {}
                     : { sessionTitle: previousControl.sessionTitle }),
                 codexThread: disconnectedSession.configuration.threadOptions,

package/dist/runtime/sessionTitle.js

@@ -1,3 +1,4 @@
+import { resolveTimeZone } from "../config/timeZone.js";
 const TITLE_SEPARATOR = " · ";
 export const MAX_SESSION_TITLE_LENGTH = 80;
 const TASK_TITLE_MAX_LENGTH = 20;
@@ -22,6 +23,20 @@ export function resolveTaskRoleSessionTitle(existingTitle, task, roleName) {
     }
     return taskRoleSessionTitle(task, roleName);
 }
+export function operatorSessionTitle(now, configuredTimeZone) {
+    if (!(now instanceof Date) || !Number.isFinite(now.getTime())) {
+        throw new TypeError("Operator session title date is invalid.");
+    }
+    const parts = Object.fromEntries(new Intl.DateTimeFormat("en-CA", {
+        timeZone: resolveTimeZone(configuredTimeZone),
+        month: "2-digit",
+        day: "2-digit"
+    }).formatToParts(now).map(({ type, value }) => [type, value]));
+    if (parts.month === undefined || parts.day === undefined) {
+        throw new TypeError("Operator session title date is unavailable.");
+    }
+    return `Yui${TITLE_SEPARATOR}Operator${TITLE_SEPARATOR}${parts.month}${parts.day}`;
+}
 function displayTitle(value, maxLength) {
     if (value.length <= maxLength)
         return value;

package/dist/runtime/structuredProviderHost.js

@@ -68,10 +68,21 @@ export async function startStructuredProviderSession(payload, input = {}) {
                 ...(input.onDiagnostic === undefined ? {} : { onDiagnostic: input.onDiagnostic }),
                 mirror
             });
+            if (isPostCreateOperatorTitle(payload)) {
+                input.onDiagnostic?.({
+                    nativeSessionId: session.nativeSessionId,
+                    failure: {
+                        detail: "This Agent protocol does not support setting a native Session title.",
+                        phase: "session-start",
+                        inputDisposition: "not-accepted",
+                        sessionDisposition: "recoverable"
+                    }
+                });
+            }
             return Object.freeze({ session });
         }
         if (control.adapterId === "codex") {
-            const opened = await CodexStructuredProviderSession.open(child, exit, processInstanceId, payload, control, input.onStarted, input.onTerminal, input.onGoal, input.onInput, input.onActivity, mirror);
+            const opened = await CodexStructuredProviderSession.open(child, exit, processInstanceId, payload, control, input.onStarted, input.onTerminal, input.onGoal, input.onInput, input.onActivity, input.onDiagnostic, mirror);
             return Object.freeze({
                 session: opened.session,
                 ...(opened.recoveredTerminal === undefined
@@ -81,6 +92,17 @@ export async function startStructuredProviderSession(payload, input = {}) {
             });
         }
         const session = await ClaudeStructuredProviderSession.open(child, exit, processInstanceId, control, input.onAccepted, input.onTerminal, input.onGoal, input.onActivity, input.onDiagnostic, mirror);
+        if (isPostCreateOperatorTitle(payload)) {
+            input.onDiagnostic?.({
+                nativeSessionId: session.nativeSessionId,
+                failure: {
+                    detail: "This Agent provider does not support renaming a Session after creation.",
+                    phase: "session-start",
+                    inputDisposition: "not-accepted",
+                    sessionDisposition: "recoverable"
+                }
+            });
+        }
         return Object.freeze({ session });
     }
     catch (error) {
@@ -88,6 +110,12 @@ export async function startStructuredProviderSession(payload, input = {}) {
         throw error;
     }
 }
+function isPostCreateOperatorTitle(payload) {
+    return payload.providerControl?.sessionTitle !== undefined
+        && payload.providerControl.mode === "new"
+        && payload.environment.YUI_SESSION_SCOPE === "global"
+        && payload.environment.YUI_ROLE === "operator";
+}
 /**
  * Open an uninitialized, transparent connection for a native TUI. The TUI
  * owns its requests; Yui observes only its exact startup response.
@@ -351,7 +379,7 @@ class CodexStructuredProviderSession {
         this.mirror = mirror;
         this.nativeAccountHome = nativeAccountHome;
     }
-    static async open(child, exit, processInstanceId, payload, control, onStarted, onTerminal, onGoal, onInput, onActivity, mirror) {
+    static async open(child, exit, processInstanceId, payload, control, onStarted, onTerminal, onGoal, onInput, onActivity, onDiagnostic, mirror) {
         const channel = await CodexProxyWebSocketChannel.connect(child, mirror);
         const openingMessages = [];
         const stopOpeningBuffer = channel.onMessage((message) => openingMessages.push(message));
@@ -385,10 +413,22 @@ class CodexStructuredProviderSession {
             }
         }
         if (control.sessionTitle !== undefined) {
-            await runtime.setConversationName({
-                conversationId,
-                name: control.sessionTitle
-            });
+            try {
+                await runtime.setConversationName({
+                    conversationId,
+                    name: control.sessionTitle
+                });
+            }
+            catch (error) {
+                onDiagnostic?.({
+                    nativeSessionId: conversationId,
+                    failure: providerDeliveryFailureFrom(error, {
+                        phase: "session-start",
+                        inputDisposition: "not-accepted",
+                        sessionDisposition: "recoverable"
+                    })
+                });
+            }
         }
         const session = new CodexStructuredProviderSession(child, exit, processInstanceId, conversationId, runtime, onStarted, onTerminal, onGoal, onInput, onActivity, mirror, optionalId(initialized.codexHome));
         session.#activeTurnId = resumedActiveTurnId;

package/docs/managed-turn-and-session-runtime.md

@@ -11,6 +11,13 @@ notifications cannot restart an explicitly stopped Session; normal Host detach
 preserves an active Session and remains reconnectable. A switch after a partial
 failure still settles the retained input before selecting a new conversation.
 
+A newly created global Operator conversation requests the native title
+`Yui · Operator · MMdd`, using Yui's configured time zone. The request is made
+only after the provider returns the exact new conversation identity; restore
+and reconnect paths never replay it. Providers without a post-create rename
+capability keep the usable Session and expose a diagnostic instead of treating
+metadata failure as Session-creation failure.
+
 ## Authority
 
 Task, WorkItem, Message, Decision, Artifact and Project Knowledge preserve

package/docs/managed-turn-and-session-runtime.zh-CN.md

@@ -8,6 +8,11 @@ Provider binding，再结算执行占用。Global 停止证据保存为仅记录
 不触发新的原生输入。待投递通知不能重启已明确停止的 Session；普通 Host 脱离仍
 保留 active Session，可正常重连。部分切换失败后，仍须先结算旧输入再选择新会话。
 
+新建 global Operator 对话会按 Yui 当前配置时区请求原生标题
+`Yui · Operator · MMdd`。只有 Provider 返回新对话的确切身份后才执行该请求；
+恢复与重连路径不会重放。若 Provider 不支持创建后改名，已创建的 Session 仍保持
+可用，并留下诊断，而不会把元数据失败冒充为 Session 创建失败。
+
 ## 权威
 
 Task、WorkItem、Message、Decision、Artifact 和 Project Knowledge 保存持久工作。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zq-silk/yui",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Local control plane for long-running native agent CLI sessions backed by tmux.",
   "license": "MIT",
   "private": false,

package/skills/yui-operator/SKILL.md

@@ -74,13 +74,30 @@ determine Task identity. They also do not determine WorkItem count. Let
 isolated workspaces and Integration handle independent Git changes.
 
 Keep the Task title concise and put detailed intent, constraints, and evidence
-in its description or routed Message. The examples below are separate
-operations, not an automatic create/submit/activate sequence. For creation-only
-intent, save the Task without starting planning. Discussion does not authorize
-delivery; follow the Leader's [planning and activation boundary](../yui-leader/references/planning.md)
-before activation. Queries, record-only input and discussion do not authorize
-reopening. An explicit request to continue the same completed result can authorize
-the necessary reopening; follow the delivery guidance below.
+in its description or routed Message.
+
+Treat Task creation and Task submission as separate user-authorized actions.
+When the user asks only to add, create, register, or record a Task, create the
+Draft and write all known requirements into its metadata, then stop. Do not
+submit a `discuss` or `develop` Message, request activation, start a Leader
+Session, or create execution resources. A detailed or immediately actionable
+requirement, or the user's desire for its eventual completion, is not permission
+to start it. Report that the Task is a Draft and has not started, and explain
+that the user can explicitly ask to discuss/plan it or to develop/implement it.
+
+Start the corresponding route only when the user's current request contains
+that additional intent: discussion or planning authorizes `discuss`;
+development, implementation, fixing, continuing execution, or immediate
+progress authorizes `develop` or the applicable lifecycle continuation. Do not
+weaken explicit intent merely because the request also says “create a Task.”
+The examples below are separate operations, never an automatic
+create/submit/activate sequence.
+
+Discussion does not authorize delivery; follow the Leader's
+[planning and activation boundary](../yui-leader/references/planning.md) before
+activation. Queries, record-only input and discussion do not authorize
+reopening. An explicit request to continue the same completed result can
+authorize the necessary reopening; follow the delivery guidance below.
 
 ```sh
 yui operator submit "<related request and delta>" --task <task-id> --intent discuss
@@ -94,14 +111,17 @@ Inspect an existing request before creating another. `task activate <task-id>`
 can adopt an eligible request in the foreground; it never activates a Draft
 without a recorded request and environment plan.
 
-Choose the submission intent explicitly; it is never inferred from the message
-text. `discuss` (the default) routes the Draft to
-planning; `record` saves the message without waking the Leader; `develop` asks an
-unplanned Draft to activate now, and reports the exact next step when it cannot
-(already planned → request activation explicitly; execution stopped → start it first). Pass
-`--request-id <key>` to make a submission idempotent: retrying the same key
-returns the original message and routing instead of creating a duplicate, and the
-same key with different text is refused as a conflict.
+After the user has authorized a submission, choose its intent explicitly; it is
+never inferred by the CLI from the message text. `discuss` (the CLI default when
+`operator submit` is already being invoked) routes the Draft to planning;
+`record` saves the message without waking the Leader; `develop` asks an unplanned
+Draft to activate now, and reports the exact next step when it cannot (already
+planned → request activation explicitly; execution stopped → start it first).
+The CLI default is not permission for the Operator to invoke submission after a
+creation-only request. Pass `--request-id <key>` to make a submission idempotent:
+retrying the same key returns the original message and routing instead of
+creating a duplicate, and the same key with different text is refused as a
+conflict.
 
 Resolve all known Projects before repository-backed execution. A stable Project
 checkout is read-only reference state, not the Task base authority. Yui records