@tea-agent/loop-agent 0.40.0-next.3 → 0.40.0-next.5

package/dist/worker/observe/static/state.d.ts

@@ -0,0 +1,50 @@
+/** 与 state.js 对应的类型声明（供 vitest/TS 侧导入契约测试）。 */
+
+export type ViewStateKind = "loading" | "empty" | "degraded" | "error";
+
+export type ViewStateDescriptor = {
+	kind: ViewStateKind;
+	className: string;
+	role: string | null;
+	ariaLive: string | null;
+	message: string;
+	detail: string | null;
+	messageClass: string | null;
+};
+
+export const uiState: {
+	lastSnapshot: unknown;
+	specEvidenceDetail: {
+		source: string;
+		path: string;
+		loading: boolean;
+		error: string | null;
+		data: unknown;
+		triggerId: string | null;
+	} | null;
+	dagNodeExecutionOutputCache: Map<string, unknown> | null;
+	[key: string]: unknown;
+};
+
+export function setWorkspaceScope(workspaceId: string | null): void;
+export function workspaceScope(): string | null;
+export function scopedApiUrl(url: string): string;
+export function workspaceRequestSignal(): AbortSignal | undefined;
+export function fetchWithWorkspaceScope(
+	url: string,
+	init?: RequestInit,
+): Promise<Response>;
+export function abortWorkspaceRequests(): void;
+export function setWorkspaceActive(active: boolean): void;
+export function stopTimers(): void;
+export function pauseForegroundTimers(): void;
+
+/** Multi-workspace atomic scope switch (2026-08-26, AC-006). */
+export function applyWorkspaceScopeSwitch(
+	nextWorkspaceId: string | null,
+	routeValue?: (() => void) | string,
+	options?: {
+		route?: (hashValue: string) => void;
+		onTrace?: (trace: string[]) => void;
+	},
+): string[];

package/dist/worker/observe/static/state.js

@@ -116,6 +116,8 @@ export const uiState = {
 	/** Last-rendered spec-evidence list, used to restore the list synchronously. */
 	specEvidenceListEvidence: null,
 	pollingGeneration: 0,
+	/** Hosted Inspect workspace is foreground. Standalone defaults to active. */
+	workspaceActive: true,
 };
 
 /** Per-dagRunId graph viewport restore map (stable Map instance). */
@@ -279,16 +281,186 @@ export function isPageVisible() {
 	);
 }
 
+export function isWorkspaceActive() {
+	return uiState.workspaceActive !== false;
+}
+
+export function setWorkspaceActive(active) {
+	uiState.workspaceActive = Boolean(active);
+}
+
+/**
+ * Multi-workspace scope (2026-08-23): every Observe GET must carry the
+ * current workspaceId (AC-002/AC-003). The scope is synced from the parent
+ * Console shell hash (`?workspaceId=`) or via postMessage for hosted mode;
+ * standalone pages default to null and all workspace-scoped routes fail closed
+ * until the host or hash publishes an explicit workspace id.
+ */
+let currentWorkspaceScope = null;
+let currentWorkspaceRequestController =
+	typeof AbortController === "undefined" ? null : new AbortController();
+
+export function setWorkspaceScope(workspaceId) {
+	currentWorkspaceScope =
+		typeof workspaceId === "string" && workspaceId.trim()
+			? workspaceId.trim()
+			: null;
+}
+
+export function workspaceScope() {
+	return currentWorkspaceScope;
+}
+
+/** Signal shared by every workspace-scoped Observe request in the active scope. */
+export function workspaceRequestSignal() {
+	if (
+		typeof AbortController !== "undefined" &&
+		(!currentWorkspaceRequestController ||
+			currentWorkspaceRequestController.signal.aborted)
+	) {
+		currentWorkspaceRequestController = new AbortController();
+	}
+	return currentWorkspaceRequestController?.signal;
+}
+
+function combinedRequestSignal(scopeSignal, requestSignal) {
+	const signals = [scopeSignal, requestSignal].filter(Boolean);
+	if (signals.length <= 1) return { signal: signals[0], cleanup: () => {} };
+	const controller = new AbortController();
+	const abort = () => controller.abort();
+	for (const signal of signals) {
+		if (signal.aborted) abort();
+		else signal.addEventListener("abort", abort, { once: true });
+	}
+	return {
+		signal: controller.signal,
+		cleanup: () => {
+			for (const signal of signals) signal.removeEventListener("abort", abort);
+		},
+	};
+}
+
+/** Fetch through the current workspace boundary and abort on any scope swap. */
+export async function fetchWithWorkspaceScope(url, init = {}) {
+	const { signal: requestSignal, ...rest } = init;
+	const combined = combinedRequestSignal(
+		workspaceRequestSignal(),
+		requestSignal,
+	);
+	try {
+		return await fetch(scopedApiUrl(url), {
+			...rest,
+			...(combined.signal ? { signal: combined.signal } : {}),
+		});
+	} finally {
+		combined.cleanup();
+	}
+}
+
+/** Abort every old-scope request and invalidate request identity guards. */
+export function abortWorkspaceRequests() {
+	currentWorkspaceRequestController?.abort();
+	currentWorkspaceRequestController =
+		typeof AbortController === "undefined" ? null : new AbortController();
+	uiState.dagHistoryAbortController?.abort?.();
+	uiState.dagHistoryAbortController = null;
+	uiState.dagHistoryRequestSeq += 1;
+	uiState.dagHistoryPrefetchGeneration += 1;
+	uiState.dagNodeInputRequestSeq += 1;
+	uiState.dagNodeProcessRequestSeq += 1;
+	uiState.dagNodeExecutionOutputRequestSeq += 1;
+}
+
+/** Multi-workspace atomic scope switch (2026-08-26, AC-006).
+ *
+ * Contract order — strictly sequential, no interleaving:
+ *   1. abort old   — stop every poll/SSE so no late request can race the swap;
+ *   2. clear old   — drop cached run/task/selection state of the old scope;
+ *   3. set scope   — publish the new workspaceId for scopedApiUrl;
+ *   4. reload new  — re-route/re-render with the new scope active.
+ *
+ * Observability: each stage appends to the returned trace so tests (and
+ * diagnostics) can assert the exact ordering; there is no window in which a
+ * new route is requested with the old scope or vice versa.
+ */
+export function applyWorkspaceScopeSwitch(
+	nextWorkspaceId,
+	routeValue,
+	options = {},
+) {
+	const trace = [];
+	// 1. abort old
+	abortWorkspaceRequests();
+	stopTimers();
+	pauseForegroundTimers();
+	trace.push("abort-old");
+	// 2. clear old
+	uiState.lastSnapshot = null;
+	uiState.specEvidenceDetail = null;
+	uiState.specEvidenceListEvidence = null;
+	clearDagNodeExecutionOutputCache();
+	trace.push("clear-old");
+	// 3. set scope
+	setWorkspaceScope(nextWorkspaceId);
+	trace.push(`set-scope:${workspaceScope() ?? ""}`);
+	// 4. route/reload new
+	if (typeof routeValue === "function") routeValue();
+	else if (typeof routeValue === "string") options.route?.(routeValue);
+	trace.push("route-new");
+	if (options.onTrace) options.onTrace(trace);
+	return trace;
+}
+
+/** Append ?workspaceId= to an observe API URL (real request path kept). */
+export function scopedApiUrl(url) {
+	const raw = String(url ?? "");
+	if (!currentWorkspaceScope || !raw.startsWith("/api/")) return raw;
+	const qIndex = raw.indexOf("?");
+	if (qIndex >= 0) {
+		const params = new URLSearchParams(raw.slice(qIndex + 1));
+		if (params.has("workspaceId")) return raw;
+		params.set("workspaceId", currentWorkspaceScope);
+		return `${raw.slice(0, qIndex)}?${params.toString()}`;
+	}
+	return `${raw}?workspaceId=${encodeURIComponent(currentWorkspaceScope)}`;
+}
+
 export function detailPollDelay(status, isVisible) {
 	const normalizedStatus = (status ?? "").toLowerCase().replace(/-/g, "_");
 	if (TERMINAL_RUN_STATUSES.has(normalizedStatus)) return null;
+	if (!isWorkspaceActive()) return null;
 	return isVisible ? ACTIVE_DETAIL_POLL_MS : HIDDEN_POLL_MS;
 }
 
 export function dashboardPollDelay() {
+	if (!isWorkspaceActive()) return null;
 	return isPageVisible() ? DASHBOARD_POLL_MS : HIDDEN_POLL_MS;
 }
 
+/** Stop pausable timers without destroying route/selection/scroll. */
+export function pauseForegroundTimers() {
+	if (uiState.dashboardTimer) {
+		clearTimeout(uiState.dashboardTimer);
+		uiState.dashboardTimer = null;
+	}
+	if (uiState.runPollTimer) {
+		clearTimeout(uiState.runPollTimer);
+		uiState.runPollTimer = null;
+	}
+	if (uiState.dagPollTimer) {
+		clearTimeout(uiState.dagPollTimer);
+		uiState.dagPollTimer = null;
+	}
+	if (uiState.poolTimer) {
+		clearTimeout(uiState.poolTimer);
+		uiState.poolTimer = null;
+	}
+	if (uiState.taskPollTimer) {
+		clearTimeout(uiState.taskPollTimer);
+		uiState.taskPollTimer = null;
+	}
+}
+
 export function updateDagGraphViewportState(
 	_previous,
 	dagRunId,

package/dist/worker/observe/static/styles.css

@@ -3580,6 +3580,10 @@ button.copy-command:focus-visible {
 #dag-inspector-panel-prompt-restart {
 	display: flex;
 	flex-direction: column;
+	min-height: 0;
+}
+#dag-inspector-panel-prompt-restart:has(.prompt-restart-panel.is-readonly) {
+	overflow: hidden;
 }
 .prompt-restart-panel,
 .prompt-restart-box {
@@ -3589,6 +3593,14 @@ button.copy-command:focus-visible {
 	min-width: 0;
 	flex: 1;
 }
+.prompt-restart-panel.is-readonly {
+	min-height: 0;
+	overflow: hidden;
+}
+.prompt-restart-panel.is-readonly .prompt-restart-prompt-card {
+	flex: 1 1 auto;
+	min-height: 12rem;
+}
 .prompt-restart-toolbar {
 	display: grid;
 	grid-template-columns: minmax(0, 1fr) auto;
@@ -3814,7 +3826,6 @@ button.copy-command:focus-visible {
 .prompt-restart-readonly {
 	margin: 0;
 	padding: 14px 16px;
-	max-height: min(36vh, 18rem);
 	overflow: auto;
 	background: var(--canvas-soft);
 	color: var(--ink);
@@ -3825,6 +3836,14 @@ button.copy-command:focus-visible {
 	overflow-wrap: anywhere;
 	tab-size: 2;
 }
+.prompt-restart-panel.is-readonly .prompt-restart-readonly {
+	flex: 1 1 auto;
+	min-height: 0;
+	max-height: none;
+}
+.prompt-restart-panel.is-edit .prompt-restart-readonly {
+	max-height: min(36vh, 18rem);
+}
 .prompt-restart-textarea {
 	width: 100%;
 	min-height: 8rem;

package/dist/worker/observe/static/views/dag-inspector.js

@@ -25,6 +25,7 @@ import { describeDagNodePurpose } from "../dag-node-purpose.js";
 import { buildPromptRestartCandidateOptions } from "../prompt-restart-candidates.js";
 import { copyText } from "../copy.js";
 import {
+	fetchWithWorkspaceScope,
 	uiState,
 	makeSessionEventIdentity,
 	makeDagNodeInputIdentity,
@@ -1286,7 +1287,7 @@ export function frontendGateLedgerLines(input) {
 /** DAG run 专属 prewrite-result 只读拉取（内联 fetch，不新增 api.js 依赖）。 */
 async function fetchPrewriteResultJson(dagRunId) {
 	try {
-		const res = await fetch(
+		const res = await fetchWithWorkspaceScope(
 			`/api/dag-runs/${encodeURIComponent(dagRunId)}/prewrite-result`,
 			{ credentials: "same-origin" },
 		);
@@ -1404,7 +1405,7 @@ async function renderPromptRestart(content, dagRunId, node) {
 
 	if (node.status !== "ERROR") {
 		// Non-failed nodes still show their frozen prompt — read-only.
-		const panel = el("div", "prompt-restart-panel");
+		const panel = el("div", "prompt-restart-panel is-readonly");
 		panel.appendChild(
 			createPromptRestartBanner({
 				tone: "readonly",
@@ -2012,7 +2013,7 @@ function effectiveExecutionKey(dagRunId, node) {
 async function fetchExecutionOutput(dagRunId, nodeId, key) {
 	const url = `/api/dag-runs/${encodeURIComponent(dagRunId)}/nodes/${encodeURIComponent(nodeId)}/execution-output?key=${encodeURIComponent(key)}`;
 	try {
-		const res = await fetch(url);
+		const res = await fetchWithWorkspaceScope(url);
 		let body = null;
 		try {
 			body = await res.json();

package/dist/worker/observe/static/views/dag.js

@@ -364,7 +364,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 			"page-action-btn",
 			"在操作台中止此运行 →",
 		);
-		interruptLink.href = `/#/recovery?dagRunId=${encodeURIComponent(dag.dagRunId)}&intent=interrupt`;
+		interruptLink.href = `/#/operate/recovery?dagRunId=${encodeURIComponent(dag.dagRunId)}&intent=interrupt`;
 		interruptLink.setAttribute("data-testid", "inspect-dag-interrupt-link");
 		interruptLink.title = "只跳转到操作台 Recovery，不会在观测页执行中止";
 		primaryEntries.push(["协作中止", interruptLink]);
@@ -482,6 +482,7 @@ export function startDagPolling(dagRunId, initial = true) {
 		const active = await renderDagDetail(dagRunId, isInitial);
 		if (generation !== uiState.pollingGeneration || !active) return;
 		const delay = detailPollDelay("running", isPageVisible());
+		if (delay == null) return;
 		uiState.dagPollTimer = setTimeout(() => {
 			uiState.dagPollTimer = null;
 			void poll(false);

package/dist/worker/observe/static/views/dashboard.js

@@ -84,7 +84,7 @@ let dashboardLoadingNode = null;
 
 /**
  * 「昨夜班次」条带：夜间结果在观测侧的唯一一级呈现（替代旧「夜间任务」tab）。
- * 管理动作（晨审处置）始终落在操作侧 /#/night，保持 Inspect 只读不变式。
+ * 管理动作（晨审处置）始终落在操作侧 /#/operate/night，保持 Inspect 只读不变式。
  */
 async function renderNightStrip() {
 	const strip = document.getElementById("dashboard-night");
@@ -118,14 +118,14 @@ async function renderNightStrip() {
 
 	const actions = el("div", "night-strip-actions");
 	const detail = el("a", "page-action-btn", "夜间详情");
-	detail.href = "#/night";
+	detail.href = "/#/inspect/night";
 	detail.addEventListener("click", (e) => {
 		e.preventDefault();
 		navigate("/night");
 	});
 	actions.appendChild(detail);
 	const manage = el("a", "page-action-btn night-strip-manage", "晨审处置 →");
-	manage.href = "/#/night";
+	manage.href = "/#/operate/night";
 	manage.title = "夜间计划的管理与晨审处置在操作台完成（Inspect 保持只读）";
 	actions.appendChild(manage);
 	strip.appendChild(actions);
@@ -738,10 +738,12 @@ export function startDashboardPolling(scrollTo) {
 	const poll = async (initialScrollTo) => {
 		await renderDashboard(initialScrollTo);
 		if (generation !== uiState.pollingGeneration) return;
+		const delay = dashboardPollDelay();
+		if (delay == null) return;
 		uiState.dashboardTimer = setTimeout(() => {
 			uiState.dashboardTimer = null;
 			void poll();
-		}, dashboardPollDelay());
+		}, delay);
 	};
 	void poll(scrollTo);
 }

package/dist/worker/observe/static/views/night.js

@@ -46,8 +46,8 @@ export async function renderNightJobs(scheduleId) {
 	showView("night");
 	bindNightToolbar();
 	const crumbs = [
-		{ label: UI_TEXT.dashboard, href: "#/" },
-		{ label: UI_TEXT.nightJobs, href: "#/night" },
+		{ label: UI_TEXT.dashboard, href: "/#/inspect" },
+		{ label: UI_TEXT.nightJobs, href: "/#/inspect/night" },
 	];
 	if (scheduleId) crumbs.push({ label: scheduleId });
 	setBreadcrumb(crumbs);

package/dist/worker/observe/static/views/pool.js

@@ -93,6 +93,7 @@ function startPoolAutoPolling() {
 		if (generation !== uiState.pollingGeneration) return;
 		if (!poolAutoRefreshEnabled()) return;
 		const delay = isPageVisible() ? POOL_POLL_MS : dashboardPollDelay();
+		if (delay == null) return;
 		uiState.poolTimer = setTimeout(() => {
 			uiState.poolTimer = null;
 			void poll();

package/dist/worker/observe/static/views/run.js

@@ -50,6 +50,7 @@ import {
 } from "../relations.js";
 import { copyText, renderRecommendedCommand } from "../copy.js";
 import {
+	fetchWithWorkspaceScope,
 	isPageVisible,
 	detailPollDelay,
 	dashboardPollDelay,
@@ -126,7 +127,7 @@ export function renderInlineArtifactList(container, artifacts) {
 		list.appendChild(li);
 		void (async () => {
 			try {
-				const res = await fetch(artifactUrl(artifactPath));
+				const res = await fetchWithWorkspaceScope(artifactUrl(artifactPath));
 				const text = await res.text();
 				if (!res.ok) {
 					let message = text;
@@ -444,6 +445,7 @@ export function startRunPolling(workerRunId, initial = true) {
 		const active = await renderRun(workerRunId, isInitial);
 		if (generation !== uiState.pollingGeneration || !active) return;
 		const delay = detailPollDelay("running", isPageVisible());
+		if (delay == null) return;
 		uiState.runPollTimer = setTimeout(() => {
 			uiState.runPollTimer = null;
 			void poll(false);

package/dist/worker/observe/static/views/task.js

@@ -86,7 +86,7 @@ export async function renderTaskDetail(featureId, taskId) {
 	showView("task");
 	setBreadcrumb([
 		{ label: UI_TEXT.dashboard, href: "#/" },
-		{ label: "资源池", href: "#/pool" },
+		{ label: "资源池", href: "/#/inspect/pool" },
 		{ label: displayLabel },
 	]);
 

package/dist/workflows/dag/init-hybrid.js

@@ -4412,6 +4412,7 @@ async function buildBackendTestGapFillDag(sources) {
         ],
     };
     spec.backendTestLayout = layout;
+    applyBackendTestWorkspaceControl(spec, taskConfig.backendTest?.workspaceControl ?? "git");
     if (sharedSetup) {
         spec.backendTestSharedSetup = { ...sharedSetup };
     }
@@ -4868,6 +4869,7 @@ async function buildBackendTestHybridDag(sources) {
     // against the resolved layout. The default layout is identity, so the
     // packaged template stays byte-identical with the historical contract.
     applyBackendTestLayoutToDagSpec(spec, layout);
+    applyBackendTestWorkspaceControl(spec, taskConfig.backendTest?.workspaceControl ?? "git");
     // Plan B: carry the bound shared-setup document on the spec so runtime
     // validators (N6 markdown case validation) see the same binding as prompts.
     if (intake.sharedSetup) {
@@ -4878,6 +4880,23 @@ async function buildBackendTestHybridDag(sources) {
     assertValidDagSpec(spec);
     return spec;
 }
+function applyBackendTestWorkspaceControl(spec, control) {
+    if (control !== "filesystem-only") {
+        delete spec.backendTestWorkspaceControl;
+        return;
+    }
+    spec.backendTestWorkspaceControl = control;
+    for (const task of spec.tasks) {
+        if ((task.executor === "pi" && task.toolProfile === "write") ||
+            task.shell?.backendTestPipeline) {
+            task.writeGuardPolicy = "filesystem-only";
+        }
+        const child = task.dynamicExpansion?.childTask;
+        if (child?.executor === "pi" && child.toolProfile === "write") {
+            child.writeGuardPolicy = "filesystem-only";
+        }
+    }
+}
 /** Rewrite layout-dependent strings across a compiled backend-test DAG spec (plan A). */
 function applyBackendTestLayoutToDagSpec(spec, layout) {
     if (layout.isDefault) {

package/dist/workflows/dag/interrupt-request.js

@@ -1,8 +1,8 @@
 import { watch } from "node:fs";
-import { mkdir, readFile } from "node:fs/promises";
+import { mkdir } from "node:fs/promises";
 import { hostname as localHostname } from "node:os";
 import path from "node:path";
-import { writeJsonAtomic } from "../../infrastructure/harness/atomic-write.js";
+import { readJsonWithTransientRetry, writeJsonAtomic, } from "../../infrastructure/harness/atomic-write.js";
 import { assessDagRunLiveness, getDagRunDir, locateDagRun, readDagRunState, } from "./lifecycle.js";
 export const INTERRUPT_ARTIFACT_REL = path.posix.join(".runtime", "interrupt.json");
 export const INTERRUPT_REASON_CODES = [
@@ -140,7 +140,7 @@ export function parseInterruptRequest(raw) {
 }
 export async function readInterruptRequest(runDir) {
     try {
-        const raw = JSON.parse(await readFile(interruptArtifactPath(runDir), "utf-8"));
+        const raw = await readJsonWithTransientRetry(interruptArtifactPath(runDir));
         return parseInterruptRequest(raw);
     }
     catch (error) {

package/dist/workflows/dag/lifecycle.js

@@ -1,7 +1,7 @@
 import { access, mkdir, readFile, readdir, rename } from "node:fs/promises";
 import path from "node:path";
 import { hostname as localHostname } from "node:os";
-import { writeJsonAtomic, } from "../../infrastructure/harness/atomic-write.js";
+import { readJsonWithTransientRetry, writeJsonAtomic, } from "../../infrastructure/harness/atomic-write.js";
 import { parseDagSpec } from "./types.js";
 import { normalizeDagFailureCategory, } from "./failure-category.js";
 import { dagProductLineFailureCategoryValues, routeDagFailure, } from "./failure-routing.js";
@@ -43,14 +43,14 @@ export async function dagRunDirExists(runDir) {
     }
 }
 export async function readDagRunState(runDir) {
-    const raw = JSON.parse(await readFile(path.join(runDir, "state.json"), "utf-8"));
+    const raw = await readJsonWithTransientRetry(path.join(runDir, "state.json"));
     return raw;
 }
 export async function writeDagRunState(runDir, state, options) {
     await writeJsonAtomic(path.join(runDir, "state.json"), state, options);
 }
 export async function readDagRunSpec(runDir) {
-    const raw = JSON.parse(await readFile(path.join(runDir, "run.json"), "utf-8"));
+    const raw = await readJsonWithTransientRetry(path.join(runDir, "run.json"));
     return parseDagSpec(raw);
 }
 export async function locateDagRun(cwd, runId) {

package/dist/workflows/dag/types.js

@@ -382,7 +382,7 @@ export const dagWritePolicySchema = z.enum([
     "none",
 ]);
 /** Git/post-diff write guard intensity for exclusive Pi writers. */
-export const dagWriteGuardPolicySchema = z.enum(["full", "tools-only"]);
+export const dagWriteGuardPolicySchema = z.enum(["full", "tools-only", "filesystem-only"]);
 /**
  * Fail-closed outcome/diff consistency contract for bounded Pi writers.
  * The writer must begin with IMPLEMENTATION_OUTCOME: changed,
@@ -997,6 +997,8 @@ export const dagSpecSchema = z
     taskContractBinding: dagTaskContractBindingSchema.optional(),
     /** Optional unresolved parent-run feedback for a full task rerun. */
     rerunFeedback: dagRerunFeedbackSchema.optional(),
+    /** Backend-test-only workspace mutation control; absent means Git. */
+    backendTestWorkspaceControl: z.enum(["git", "filesystem-only"]).optional(),
     /** Frozen backend-test artifact layout (plan A); absent = historical default testcase/ layout. */
     backendTestLayout: z
         .object({

package/docs/README.md

@@ -73,6 +73,7 @@
 | `design/active/` | 仍会影响后续决策的设计输入、路线与契约 |
 | `design/visual-references/` | 长期视觉参考，不表达实现状态 |
 | `design/archive/` | 历史设计和已被实现/替代的阶段性设计 |
+| `superpowers/specs/` | Superpowers 工作流产出的阶段性实现设计输入 |
 | `exec-plans/active/` | 仍需推进或明确保持 open 的任务合同 |
 | `exec-plans/completed/` | 已完成任务合同归档 |
 | `progress/` | 仍需下一次会话接手的当前 handoff 入口 |

package/docs/operations/local-development-environment.md

@@ -2,6 +2,27 @@
 
 本文记录仅与特定开发环境有关、但可能反复影响验证结果的问题。它不是通用工程规则；标准验证命令仍以 [`verification-matrix.md`](../governance/verification-matrix.md) 为准。
 
+## Operator Console 前端快速迭代
+
+对 `src/worker/console/static-src/` 内的对话样式和前端交互做高频调整时，使用固定 8790 的开发入口：
+
+```bash
+npm run console:dev
+```
+
+它从当前源码启动真实 Console 后端，并在内部 `8791` 常驻 Vite dev server。浏览器始终访问 `http://127.0.0.1:8790/`：API、HttpOnly Cookie、确认令牌和 Origin 校验仍由真实 Console 处理，前端 HTML/模块请求才由 8790 转发给 Vite。CSS 保存后原地热替换，TSX 保存后自动整页刷新；不生成 `static-dev` bundle，也不重复运行生产 build。
+
+常用参数：
+
+```bash
+npm run console:dev -- --no-open
+npm run console:dev -- --port 8792 --reload-port 8793 --no-open
+```
+
+默认端口是 Console `8790`、内部 Vite/HMR `8791`；两者都只允许 loopback。端口已占用时命令会失败并报告端口，不会停止或接管已有进程。前端类型检查在后台持续输出诊断，但不阻塞 HMR；后端源码变化时只重启 Console 子进程，Vite 保持常驻。
+
+该命令只优化编辑反馈，不构成验收。独立交互修复完成后仍需运行定向 Vitest；交付前按验证矩阵运行 typecheck、正式 `npm run console:build` / `npm run build`。正式构建继续写入 `dist/worker/console/static/`，不会包含 `/@vite/client`、8791 或开发代理代码。
+
 ## Git hooks（本仓库）
 
 每个 clone 安装一次：

package/harness.json

@@ -82,9 +82,9 @@
   "executors": {
     "pi": {
       "description": "Pi 负责规划、评审、诊断；当 DAG toolProfile=write 时也可做有界写入。模型按复杂度三档配置，支持 provider/model 字符串或带 thinking 的对象；斜杠前为 Pi provider，后为 modelId，勿只写裸 modelId。",
-      "LOW": "deepseek/deepseek-v4-flash",
-      "MED": "deepseek/deepseek-v4-flash",
-      "HIGH": "deepseek/deepseek-v4-flash"
+      "LOW": "wizard-local/minimax-m3",
+			"MED": "wizard-local/glm-5.3",
+      "HIGH": "wizard-local/gpt-5.6-sol"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tea-agent/loop-agent",
-  "version": "0.40.0-next.3",
+  "version": "0.40.0-next.5",
   "type": "module",
   "bin": {
     "loop-agent": "bin/loop-agent.js",
@@ -54,6 +54,7 @@
     "build": "npm run brand:sync && npm run clean && tsc -p tsconfig.build.json && node -e \"const fs=require('node:fs');const p='dist/worker/observe/static';fs.mkdirSync(p,{recursive:true});fs.cpSync('src/worker/observe/static',p,{recursive:true});\" && npm run console:build && node scripts/write-build-stamp.mjs",
     "console:typecheck": "tsc -p src/worker/console/tsconfig.json",
     "console:build": "npm run console:typecheck && vite build --config src/worker/console/vite.config.ts",
+    "console:dev": "node --import tsx/esm scripts/console-dev.mjs",
     "prepack": "npm run build",
     "prepublishOnly": "node scripts/check-npm-publish-policy.mjs && npm run typecheck && npm test && npm run build",
     "lint": "npm run typecheck",
@@ -71,6 +72,7 @@
     "verify:tree": "node scripts/pre-push-verify.mjs --verify-current-tree"
   },
   "dependencies": {
+    "@deepseek-ai/dsh-host-directory-picker-native": "0.1.1-rc.2",
     "@earendil-works/pi-ai": "0.83.0",
     "@earendil-works/pi-coding-agent": "0.83.0",
     "commander": "^12.1.0",

package/dist/worker/console/static/assets/channel-Dj_4Moei.js

@@ -1 +0,0 @@
-import{ag as o,ah as n}from"./mermaid.core-Biyo-tqA.js";const t=(a,r)=>o.lang.round(n.parse(a)[r]);export{t as c};

package/dist/worker/console/static/assets/classDiagram-JCYQIIEL-C0YYAyCa.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-GF5L2VYU-TJ5JuEBT.js";import{_ as i}from"./mermaid.core-Biyo-tqA.js";import"./chunk-5VM5RSS4-JCNGkXYT.js";import"./chunk-XXDRQBXY-By9VQoi1.js";import"./chunk-KBJHAD2P-D60-Mny4.js";import"./chunk-2GRJ4B5K-wRO_iRNc.js";import"./index-CW88Fjbw.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};

package/dist/worker/console/static/assets/classDiagram-v2-OCEON4UE-C0YYAyCa.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-GF5L2VYU-TJ5JuEBT.js";import{_ as i}from"./mermaid.core-Biyo-tqA.js";import"./chunk-5VM5RSS4-JCNGkXYT.js";import"./chunk-XXDRQBXY-By9VQoi1.js";import"./chunk-KBJHAD2P-D60-Mny4.js";import"./chunk-2GRJ4B5K-wRO_iRNc.js";import"./index-CW88Fjbw.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};