@tea-agent/loop-agent 0.31.1 → 0.32.1

package/AGENTS.md

@@ -38,7 +38,7 @@
 4. 涉及测试纪律/验证声明/调试时继续读：`docs/governance/harness-methodology-*.md`。
 5. 查看最近提交、相关 plan/progress/report；`git status --short --branch`；跑最小基线验证。
 6. 后端/接口/pytest → `taskKind: "backend-test"`（不是 `--profile`）；知识回写 `knowledge-sync`；图谱开荒 `knowledge-graph-bootstrap`。`--profile` 仅 `auto|minimal|standard|reviewed|supervised`。
-7. 看板/observe → `agent-worker console`（默认 repo=当前目录、port=8790；兼容入口 `agent-worker console serve --repo . --port 8790`）（`/inspect/` 只读）；`observe serve` 仅为兼容入口。
+7. 看板/observe → `agent-worker console`（默认 repo=当前目录、port=8790；兼容入口 `agent-worker console serve --repo . --port 8790`）（`/inspect/` 只读）；`observe serve` 已下线（`OBSERVE_SERVE_REMOVED` + exit 2）；`observe snapshot` 仍可用。
 8. 分支合并 → 先读 `docs/operations/branch-merge-guideline.md`。
 
 ## 会话协议

package/CHANGELOG.md

@@ -2,6 +2,52 @@
 
 ## [Unreleased]
 
+## [0.32.1] - 2026-08-09
+
+### 改进
+
+- Operator Console 前端重构视觉层级与代码结构：`OperatorChat.tsx`（3656→407 行）、`App.tsx`（3044→182 行）、`NightJobsWorkbench.tsx`（852→90 行）按职责拆为 `operator-chat/`、`app/`、`pages/`、`shell/`、`night/` 模块，消息流 / 工具卡 / gate 卡 / composer / 侧栏各自独立；样式统一为单一语义 token 层，人工决策 gate 卡以决策卡规格（橙色左边条 + 浮起阴影 + 状态徽标 + 未决时吸附 composer 上方）突出，工具过程卡默认退后
+- Agent Worker Production Readiness v1 Phase 8：在已发布 `@0.32.0` 上完成 published-tarball deterministic campaign 与 burn-in day 0 开窗；scorecard 仍为 **`NOT_READY`**（待 burn-in 累计、live Pi canary、live Closeout、C4/C7 进程 crash）
+
+### 修复
+
+- Operator Console：补齐 `--accent` / `--danger` / `--surface-raised` 等 14 个被引用但从未定义的 CSS 变量（pi-web 遗留命名与 warm canvas 命名两代并存），此前 HumanGateCard 的橙色左边条、confirmed 态、红色错误文本实际不渲染；设置页仓库指纹截断为短哈希展示
+- Operator Console：新增 `console:typecheck` 门禁并修复拆分后 `.ts/.tsx` 未纳入类型检查的盲区；`ChatComposer` 错误从 `ToolsCatalog` 导入未导出的 `ToolCatalogView`；将 46 处旧式 `JSX.Element` 迁移为 React 19 兼容的 `React.JSX.Element`
+- Operator Chat 会话切换硬化：activate / create / restore 改为版本化提交，慢响应的旧会话选择不再覆盖较新的用户选择；新建 / 删除 / 归档会话完整清理 messages、tool calls、operation / gate / artifact cards、usage、streaming、unread、composer draft、图片附件与文件预览，createSession 改为服务端创建成功后再重置
+- Operator Console：新增 `styles.css` 自定义属性完整性契约与会话选择一致性源码契约；测试中以 `URL.parse` 替换会抛错的 `new URL` 构造
+
+## [0.32.0] - 2026-08-09
+
+### 重点更新
+
+- 启动 Agent Worker Production Readiness v1 分阶段落地：Running Attempt 归属不再依赖 terminal ledger；safe `run-error` 可直接 `task retry`，不再要求 emergency `mark-failed`
+- Harness Task 新 identity 改为 lineage/revision digest，同日 retry 不再依赖修改 title
+- 新增 Task-scoped attempt lease、controller protocol compatibility 评估，以及 agent-worker production readiness 操作合同/checklist
+- Attempt 终态释放 lease；写入前评估 controllerProtocol；scaffold 强制 ADR 0007 acceptance_policy；reconcile dry-run inventory 给出唯一恢复命令
+- 硬下线 `agent-worker observe serve`，只读检视统一走 Console `/inspect/`
+
+### 新增
+
+- `WorkerAttemptIdentity` / immutable run-owner store / `beginWorkerAttempt`（含 lease 路径）
+- `WorkerAttemptFailureV2`、`resolveWorkerRecoveryDecision`、Attempt transition reducer
+- Harness Task lineage/revision digests 与 `MaterializeOutcome` 元数据
+- `docs/operations/agent-worker-production-readiness.md` 与 checklist 模板
+- operator capabilities `controllerProtocol` envelope；`buildRuntimeReconcileInventoryDryRun`；command lifecycle official 命令清单
+- Feature scaffold `acceptance_policy` 与 AC `verification.authority` / `required_evidence_kinds`
+
+### 改进
+
+- Feature Review / Observe 对 Running 与 terminal 分层投影，ownership 告警按 `workerRunId` 聚合
+- Task-scoped WorkerEvent 携带 `featureId`
+- `batch run-ready` / `runSingleTaskAttempt` 在 terminal 后 CAS 释放 lease；有 controller identity 时先做 protocol preflight
+- Feature next-action 优先消费 acceptanceGaps.nextCommand
+
+### 修复
+
+- 硬下线 `agent-worker observe serve`：调用后不再监听端口，stderr 输出稳定标记 `OBSERVE_SERVE_REMOVED` 与替代入口，进程以退出码 2 结束
+- 只读检视统一走 `agent-worker console`（默认 `127.0.0.1:8790`）的 `/inspect/`；`observe snapshot` 仍输出 GlobalSnapshot JSON
+- Console doctor / health-match 不再以外部 8787 Observe 进程为健康前提
+
 ## [0.31.1] - 2026-08-09
 
 ### 重点更新

package/README.md

@@ -100,7 +100,7 @@ loop-agent dag report --run-id <run-id>
 | --- | --- | --- |
 | 受治理 CLI | `loop-agent …` / `agent-worker …` | 权威写入与诊断 |
 | Loop Operator Console | `agent-worker console` | Official 本地控制面（默认 repo=当前目录、`127.0.0.1:8790`，含 Operate 与 Inspect） |
-| Observe | `agent-worker observe serve --repo . --port 8787` | 兼容期独立只读入口；不再作为推荐路径 |
+| Inspect（只读） | `agent-worker console` → `/inspect/`；`observe snapshot` | 统一 Console 内只读检视；`observe serve` 已下线（REMOVED / exit 2） |
 
 ```bash
 # 终端 A：Console（任务/运行操作面；canonical mutation 只经 sibling loop-agent）

package/dist/shared/operator/capabilities.js

@@ -1,4 +1,18 @@
+import { createRequire } from "node:module";
 import { OPERATOR_ERROR_CODES_V1, OPERATOR_OUTCOMES_V1 } from "./registry.js";
+import { WORKER_ADAPTER_PROTOCOL_RANGE } from "../../worker/loop-agent/controller-protocol.js";
+const require = createRequire(import.meta.url);
+const PACKAGE_VERSION = require("../../../package.json").version ?? "0.0.0";
+/** Keep aligned with WORKER_CONTROLLER_REQUIREMENTS_V1 in controller-protocol.ts */
+const CONTROLLER_PROTOCOL_CAPABILITIES = [
+    "task-advance-managed-contract-v2",
+    "worker-association-v1",
+    "events-jsonl-v1",
+    "document-index-closure-v1",
+    "worker-attempt-owner-v1",
+    "worker-attempt-revision-v1",
+    "recovery-decision-v2",
+];
 const officialAction = (action, cli, kind, coverage) => ({
     action,
     cli,
@@ -1348,6 +1362,13 @@ export function buildOperatorCapabilitiesDocument() {
             canonicalizerVersion: 1,
             taskConfigSchemaVersion: 1,
         },
+        controllerProtocol: {
+            schemaVersion: 1,
+            controllerProtocolVersion: 1,
+            workerAdapterProtocolRange: WORKER_ADAPTER_PROTOCOL_RANGE,
+            capabilities: CONTROLLER_PROTOCOL_CAPABILITIES,
+            packageVersion: PACKAGE_VERSION,
+        },
         actions,
     };
 }
@@ -2215,7 +2236,7 @@ export const OPERATOR_COMMAND_COVERAGE = Object.freeze([
         coverage: "excluded",
         action: null,
         source: "agent-worker",
-        exclusionReason: "Not exposed to Operator Chat in M5.",
+        exclusionReason: "Removed (Wave 5): OBSERVE_SERVE_REMOVED + exit 2; use agent-worker console + /inspect/.",
     },
     {
         command: "agent-worker observe snapshot",

package/dist/shared/operator/command-lifecycle.js

@@ -0,0 +1,94 @@
+/**
+ * Public command lifecycle machine facts (Phase 7 Track B).
+ * Implementation remains in CLI modules; this registry is the shared tombstone /
+ * deprecation source for capabilities, drift checks, and operator envelopes.
+ */
+const COMMAND_LIFECYCLE_REGISTRY = {
+    "agent-worker observe serve": {
+        command: "agent-worker observe serve",
+        product: "agent-worker",
+        lifecycle: "removed",
+        replacement: "agent-worker console",
+        removedVersion: "0.19.0",
+        diagnosticCode: "OBSERVE_SERVE_REMOVED",
+        removedExitCode: 2,
+        docsSummary: "Independent observe HTTP server removed; use unified Operator Console /inspect/.",
+        operatorCategory: "observe",
+    },
+    "agent-worker console": {
+        command: "agent-worker console",
+        product: "agent-worker",
+        lifecycle: "official",
+        introducedVersion: "0.19.0",
+        docsSummary: "Official unified Operator Console (Operate + Inspect on default loopback :8790).",
+        operatorCategory: "console",
+    },
+    "agent-worker feature review": {
+        command: "agent-worker feature review",
+        product: "agent-worker",
+        lifecycle: "official",
+        docsSummary: "Project Feature readiness, acceptance gaps, and next action.",
+        operatorCategory: "feature",
+    },
+    "agent-worker feature advance": {
+        command: "agent-worker feature advance",
+        product: "agent-worker",
+        lifecycle: "official",
+        docsSummary: "ADR 0007 orchestration: verify-final → delivery → closeout.",
+        operatorCategory: "feature",
+    },
+    "agent-worker feature verify-final": {
+        command: "agent-worker feature verify-final",
+        product: "agent-worker",
+        lifecycle: "official",
+        docsSummary: "Canonical Final Verification writer (ADR 0007); only authority for coverage facts.",
+        operatorCategory: "feature",
+    },
+    "agent-worker batch run-ready": {
+        command: "agent-worker batch run-ready",
+        product: "agent-worker",
+        lifecycle: "official",
+        docsSummary: "Execute Ready Feature tasks with Task Pool attempt lease.",
+        operatorCategory: "batch",
+    },
+    "agent-worker task reconcile": {
+        command: "agent-worker task reconcile",
+        product: "agent-worker",
+        lifecycle: "official",
+        docsSummary: "Reconcile partial/orphan Worker attempt facts without deleting evidence.",
+        operatorCategory: "task",
+    },
+    "agent-worker pool doctor": {
+        command: "agent-worker pool doctor",
+        product: "agent-worker",
+        lifecycle: "official",
+        docsSummary: "Diagnose Task Pool / lease / ownership consistency.",
+        operatorCategory: "pool",
+    },
+    "loop-agent operator capabilities": {
+        command: "loop-agent operator capabilities",
+        product: "loop-agent",
+        lifecycle: "official",
+        docsSummary: "Publish operator + controllerProtocol envelope for Console/Worker negotiation.",
+        operatorCategory: "operator",
+    },
+};
+export function listCommandLifecycleEntries() {
+    return Object.values(COMMAND_LIFECYCLE_REGISTRY);
+}
+export function normalizeCommandLifecycleKey(command) {
+    return command.trim().replace(/\s+/g, " ");
+}
+export function resolveCommandLifecycle(command) {
+    const key = normalizeCommandLifecycleKey(command);
+    return COMMAND_LIFECYCLE_REGISTRY[key];
+}
+export function isRemovedCommand(command) {
+    return resolveCommandLifecycle(command)?.lifecycle === "removed";
+}
+export function listOfficialCommands(product) {
+    return listCommandLifecycleEntries()
+        .filter((entry) => entry.lifecycle === "official" &&
+        (product === undefined || entry.product === product))
+        .map((entry) => entry.command);
+}

package/dist/shared/operator/index.js

@@ -2,3 +2,4 @@ export * from "./types.js";
 export * from "./registry.js";
 export * from "./envelope.js";
 export * from "./capabilities.js";
+export * from "./command-lifecycle.js";

package/dist/worker/cli.js

@@ -13,7 +13,6 @@ import { createProgressReporter } from "./progress-reporter.js";
 import { createCompositeProgressReporter } from "./observability/progress-composite.js";
 import { createRoutedWorkerEventStore } from "./observability/event-store.js";
 import { buildGlobalSnapshot } from "./observability/read-model.js";
-import { createObserveServer } from "./observe/server.js";
 import { diagnoseTaskPoolStates, formatDoctorHuman, loadOperatorMapping, } from "./pool/doctor.js";
 import { migrateTaskPoolStates } from "./pool/migrate-state.js";
 import { markTaskPoolFailed, reconcileTaskPoolAbandon, } from "./pool/reconcile.js";
@@ -690,29 +689,16 @@ export function buildAgentWorkerProgram() {
     });
     observe
         .command("serve")
-        .requiredOption("--repo <repo-root>", "Target repo root")
-        .option("--port <port>", "HTTP port", "8787")
-        .option("--host <host>", "Bind host (default 127.0.0.1; use 0.0.0.0 for LAN, no network auth)", "127.0.0.1")
-        .option("--debug", "Log request source/method/path/status to stderr")
-        .description("Start read-only observe HTTP server (compat entry; prefer console serve)")
-        .action(async (options) => {
-        const repoRoot = path.resolve(options.repo);
-        const server = await createObserveServer({
-            repoRoot,
-            host: options.host,
-            port: Number.parseInt(options.port, 10),
-            debug: options.debug === true,
-        });
-        process.stderr.write("[OBSERVE_SERVE_DEPRECATED] agent-worker observe serve 作为独立看板入口将在兼容窗口后下线。\n" +
-            "请改用：agent-worker console serve --repo <repo> --port 8790\n" +
-            "统一 Operator Console 已包含原 Observe 的只读检视能力：http://127.0.0.1:8790/\n");
-        process.stdout.write(`${server.url}\n`);
-        await new Promise((resolve) => {
-            const shutdown = () => resolve();
-            process.once("SIGINT", shutdown);
-            process.once("SIGTERM", shutdown);
-        });
-        await server.close();
+        .option("--repo <repo-root>", "Target repo root (ignored; command removed)")
+        .option("--port <port>", "HTTP port (ignored; command removed)", "8787")
+        .option("--host <host>", "Bind host (ignored; command removed)", "127.0.0.1")
+        .option("--debug", "Ignored; command removed")
+        .description("Removed: independent observe HTTP server (use agent-worker console + /inspect/)")
+        .action(() => {
+        process.stderr.write("[OBSERVE_SERVE_REMOVED] agent-worker observe serve 已下线。\n" +
+            "请改用：agent-worker console --repo <repo> --port 8790\n" +
+            "只读检视：http://127.0.0.1:8790/inspect/\n");
+        process.exitCode = 2;
     });
     observe
         .command("snapshot")

package/dist/worker/console/doctor.js

@@ -161,12 +161,19 @@ export async function runConsoleDoctor(options) {
         };
     }
     const inspect = await probeInspect(options.consoleBaseUrl, options.fetchImpl ?? fetch);
-    const observe = options.observeBaseUrl
-        ? await probeObserve(options.observeBaseUrl, fingerprint, options.fetchImpl ?? fetch)
+    // Wave 5: do not probe retired independent observe serve (8787).
+    // Optional observeBaseUrl only accepted when it is the same origin as Console.
+    const consoleOrigin = options.consoleBaseUrl?.replace(/\/+$/, "");
+    const observeOrigin = options.observeBaseUrl?.replace(/\/+$/, "");
+    const observe = observeOrigin &&
+        consoleOrigin &&
+        observeOrigin === consoleOrigin
+        ? await probeObserve(observeOrigin, fingerprint, options.fetchImpl ?? fetch)
         : {
             status: "unavailable",
             url: `${DEFAULT_OBSERVE_BASE_URL}/api/health`,
-            message: "未探测兼容 Observe；统一 Inspect 不依赖 8787",
+            message: "独立 observe serve 已下线；健康以统一 Operator Console / Inspect 为准",
+            startCommand: OBSERVE_START_COMMAND,
         };
     const pi = await probePiReadiness({
         override: options.piReadinessProbe,
@@ -204,7 +211,7 @@ export function formatConsoleDoctorHuman(report) {
     ];
     if (report.observe.status === "unavailable" ||
         report.observe.status === "mismatch") {
-        lines.push(`observe.startCommand: ${report.observe.startCommand ?? OBSERVE_START_COMMAND}`);
+        lines.push(`observe.startCommand: ${report.observe.startCommand ?? OBSERVE_START_COMMAND} (use console + /inspect/)`);
     }
     if (report.siblingLoopAgentBin) {
         lines.push(`siblingLoopAgentBin: ${report.siblingLoopAgentBin}`);

package/dist/worker/console/observe-health-match.js

@@ -1,9 +1,12 @@
 /**
- * Observe health match classification (Phase 3).
- * Fail-closed deep links: only same-repo + schema + required capability.
+ * Observe link capability mapping + retired cross-process health-match stubs.
+ * Wave 5: independent observe serve (8787) is removed; doctor uses Console surface.
+ * capabilityForObserveTarget remains for Inspect deep-links / night-jobs.
  */
-export const OBSERVE_START_COMMAND = "agent-worker observe serve --repo . --port 8787";
-export const DEFAULT_OBSERVE_BASE_URL = "http://127.0.0.1:8787";
+/** @deprecated Wave 5 — observe serve removed; use agent-worker console */
+export const OBSERVE_START_COMMAND = "agent-worker console --repo . --port 8790";
+/** @deprecated Wave 5 — default unified Console origin (not independent Observe) */
+export const DEFAULT_OBSERVE_BASE_URL = "http://127.0.0.1:8790";
 export function capabilityForObserveTarget(target) {
     switch (target.kind) {
         case "dag":
@@ -25,8 +28,8 @@ export function capabilityForObserveTarget(target) {
     }
 }
 /**
- * Classify Observe /api/health body against local repo fingerprint + required capability.
- * Pure function — no I/O.
+ * Classify Console/Inspect /api/health body against local repo fingerprint + capability.
+ * Pure function — no I/O. Prefer unified Console origin (8790), not retired 8787 Observe.
  */
 export function classifyObserveHealth(input) {
     const url = input.healthUrl ?? `${DEFAULT_OBSERVE_BASE_URL}/api/health`;
@@ -36,7 +39,7 @@ export function classifyObserveHealth(input) {
         return {
             status: "unavailable",
             url,
-            message: "Observe health body missing or not JSON object",
+            message: "Operator surface health body missing or not JSON object",
             startCommand,
             body,
             localFingerprint: input.localFingerprint,
@@ -48,7 +51,7 @@ export function classifyObserveHealth(input) {
         return {
             status: "unavailable",
             url,
-            message: "Observe health ok !== true",
+            message: "Operator surface health ok !== true",
             startCommand,
             body,
             localFingerprint: input.localFingerprint,
@@ -60,7 +63,7 @@ export function classifyObserveHealth(input) {
         return {
             status: "mismatch",
             url,
-            message: `Observe schemaVersion mismatch (expected 1, got ${String(health.schemaVersion)})`,
+            message: `Operator surface schemaVersion mismatch (expected 1, got ${String(health.schemaVersion)})`,
             startCommand,
             body,
             localFingerprint: input.localFingerprint,
@@ -75,7 +78,7 @@ export function classifyObserveHealth(input) {
         return {
             status: "mismatch",
             url,
-            message: "Observe repoFingerprint does not match local worktree",
+            message: "Operator surface repoFingerprint does not match local worktree",
             startCommand,
             body,
             localFingerprint: input.localFingerprint,
@@ -91,7 +94,7 @@ export function classifyObserveHealth(input) {
             return {
                 status: "mismatch",
                 url,
-                message: `Observe missing route capability: ${input.requiredCapability}`,
+                message: `Operator surface missing route capability: ${input.requiredCapability}`,
                 startCommand,
                 body,
                 localFingerprint: input.localFingerprint,
@@ -104,7 +107,7 @@ export function classifyObserveHealth(input) {
         return {
             status: "match",
             url,
-            message: "Observe health matches local repo and required capability",
+            message: "Operator surface health matches local repo and required capability",
             startCommand,
             body,
             localFingerprint: input.localFingerprint,
@@ -117,7 +120,7 @@ export function classifyObserveHealth(input) {
     return {
         status: "match",
         url,
-        message: "Observe health matches local repo",
+        message: "Operator surface health matches local repo",
         startCommand,
         body,
         localFingerprint: input.localFingerprint,
@@ -126,8 +129,8 @@ export function classifyObserveHealth(input) {
     };
 }
 /**
- * Probe Observe /api/health and classify against local fingerprint.
- * Network failure → unavailable (non-blocking for Console doctor).
+ * Probe /api/health and classify against local fingerprint.
+ * Network failure → unavailable. Prefer Console origin; independent Observe serve is removed.
  */
 export async function probeAndClassifyObserve(input) {
     const base = input.baseUrl.replace(/\/+$/, "");

package/dist/worker/console/operator-actions.js

@@ -537,7 +537,8 @@ export async function dispatchOperatorAction(ctx, req) {
         }
         case "observeLink": {
             const consoleOrigin = ctx.getConsoleOrigin?.();
-            const baseUrl = ctx.observeBaseUrl ?? consoleOrigin ?? DEFAULT_OBSERVE_BASE_URL;
+            // Wave 5: prefer unified Console origin; do not fall back to retired 8787 Observe.
+            const baseUrl = consoleOrigin ?? ctx.observeBaseUrl ?? DEFAULT_OBSERVE_BASE_URL;
             const dagRunId = str(p.dagRunId);
             const taskId = str(p.taskId);
             const featureId = str(p.featureId);