npm - @tea-agent/loop-agent - Versions diffs - 0.35.0-beta.2 → 0.35.1-beta.0 - Mend

@tea-agent/loop-agent 0.35.0-beta.2 → 0.35.1-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (154) hide show

package/AGENTS.md +108 -108
package/CHANGELOG.md +55 -4
package/README.md +165 -165
package/bin/agent-worker.js +0 -0
package/bin/loop-agent.js +21 -21
package/dist/application/task-lifecycle/advance.js +1 -0
package/dist/commands/cursor-prompt.js +6 -6
package/dist/commands/init-upgrade.js +351 -19
package/dist/commands/init.js +14 -67
package/dist/commands/loop-benchmark.js +11 -11
package/dist/commands/pi-reuse-benchmark.js +16 -16
package/dist/commands/run-dag-progress.js +14 -0
package/dist/commands/task-advance.js +33 -3
package/dist/shared/operator/capabilities.js +38 -1
package/dist/sidecars/cursor-prompt/executor.js +1 -1
package/dist/worker/console/chat/pi-runtime.js +41 -25
package/dist/worker/console/chat/routes.js +27 -4
package/dist/worker/console/operation-runner.js +24 -0
package/dist/worker/console/operation-wait.js +241 -0
package/dist/worker/console/operator-actions.js +58 -0
package/dist/worker/console/static/assets/{index-hJqCPs_g.css → index-Dups4sSM.css} +1 -1
package/dist/worker/console/static/assets/index-SjjjZnV3.js +56 -0
package/dist/worker/console/static/index.html +2 -2
package/dist/worker/console/static-src/operator-chat/slash-palette-nav.js +141 -0
package/dist/worker/console/static-src/operator-chat/useChatSessions.js +13 -2
package/dist/worker/console/static-src/operator-chat/useComposer.js +30 -7
package/dist/worker/observe/static/copy.js +67 -67
package/dist/worker/observe/static/dag-layout.d.ts +36 -36
package/dist/worker/observe/static/dom.js +220 -220
package/dist/worker/observe/static/relations.js +133 -133
package/dist/worker/observe/static/run-processing.js +148 -148
package/dist/worker/observe/static/views/batch.js +227 -227
package/dist/worker/observe/static/views/failures.js +143 -143
package/dist/worker/observe/static/views/feature.js +492 -492
package/dist/worker/observe/static/views/run.js +453 -453
package/dist/worker/observe/static/views/shell.js +7 -7
package/dist/worker/observe/static/views/timeline.js +163 -163
package/dist/workflows/dag/canvas-observer.js +275 -275
package/dist/workflows/dag/frontend-prewrite-gate.js +9 -1
package/dist/workflows/dag/init-hybrid.js +2 -0
package/docs/architecture/evolution.md +73 -73
package/docs/architecture/system-overview.md +100 -100
package/docs/architecture/worker-and-feature.md +122 -122
package/docs/skills/README.md +7 -7
package/docs/templates/adr.md +60 -60
package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
package/docs/templates/agent-dag-report.schema.json +473 -473
package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
package/docs/templates/backend-test-result.schema.json +99 -99
package/docs/templates/evaluation/agents-map-slim-v1.md +87 -87
package/docs/templates/evaluation/agents-map-verbose-v0.md +153 -153
package/docs/templates/feature-spec.md +53 -53
package/docs/templates/frontend-design-contract.md +42 -42
package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
package/docs/templates/frontend-eval/metrics.md +138 -138
package/docs/templates/frontend-eval/smoke-targets.md +53 -53
package/docs/templates/frontend-task-constraints.md +35 -35
package/docs/templates/frontend-task-requirement.md +70 -70
package/docs/templates/init-evolution-review.md +35 -35
package/docs/templates/init-managed-agents.md +156 -154
package/docs/templates/interactive-ui-round2-experiment.md +66 -66
package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
package/docs/templates/knowledge-sync-dag.json +178 -178
package/docs/templates/knowledge-sync-draft.schema.json +71 -71
package/docs/templates/product-line/closeout.yaml +9 -9
package/docs/templates/product-line/design.md +13 -13
package/docs/templates/product-line/links.md +10 -10
package/docs/templates/product-line/requirement.md +17 -17
package/docs/templates/product-line/test-plan.md +7 -7
package/docs/templates/project-start-checklist.md +9 -9
package/docs/templates/qa-report.md +48 -48
package/docs/templates/sprint-contract.md +29 -29
package/docs/templates/worker-dogfood-evidence.md +80 -80
package/docs/templates/worker-dogfood-setup.md +68 -68
package/harness.json +5 -2
package/package.json +1 -1
package/scripts/kb-bootstrap-init-skeleton.sh +0 -0
package/scripts/kb-graph-incremental-prepare.mjs +0 -0
package/scripts/kb-graph-materialize.mjs +105 -105
package/scripts/kb-graph-promote.mjs +164 -164
package/scripts/kb-query.mjs +554 -554
package/skills/agent-worker/SKILL.md +48 -48
package/skills/agent-worker/references/agent-worker-operator.md +159 -159
package/skills/ai-engineering-context/SKILL.md +48 -48
package/skills/analyze-product-dependencies/scripts/test-validators.mjs +0 -0
package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +0 -0
package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +0 -0
package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +0 -0
package/skills/analyze-product-requirements/scripts/compute-source-identity.mjs +0 -0
package/skills/analyze-product-requirements/scripts/test-validators.mjs +0 -0
package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +0 -0
package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +0 -0
package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +0 -0
package/skills/browser-tools/browser-content.js +103 -103
package/skills/browser-tools/browser-cookies.js +35 -35
package/skills/browser-tools/browser-eval.js +53 -53
package/skills/browser-tools/browser-hn-scraper.js +108 -108
package/skills/browser-tools/browser-nav.js +44 -44
package/skills/browser-tools/browser-pick.js +162 -162
package/skills/browser-tools/browser-screenshot.js +34 -34
package/skills/browser-tools/browser-start.js +86 -86
package/skills/browser-tools/package-lock.json +2556 -2556
package/skills/browser-tools/package.json +19 -19
package/skills/code-review-core/SKILL.md +20 -20
package/skills/codebase-scout/SKILL.md +19 -19
package/skills/grill-me/SKILL.md +10 -10
package/skills/local-jacoco-coverage/scripts/run-coverage-analysis.sh +0 -0
package/skills/local-jacoco-coverage/scripts/start-jacoco-agent.sh +0 -0
package/skills/loop-agent/SKILL.md +1 -0
package/skills/loop-agent/references/command-reference.md +641 -639
package/skills/loop-agent/references/docs-converge.md +126 -126
package/skills/loop-agent/references/learned/README.md +21 -21
package/skills/loop-agent/references/pi-prompt.md +23 -23
package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
package/skills/playwright-cli/references/element-attributes.md +23 -23
package/skills/playwright-cli/references/playwright-tests.md +39 -39
package/skills/playwright-cli/references/request-mocking.md +87 -87
package/skills/playwright-cli/references/running-code.md +241 -241
package/skills/playwright-cli/references/session-management.md +225 -225
package/skills/playwright-cli/references/storage-state.md +275 -275
package/skills/playwright-cli/references/test-generation.md +433 -433
package/skills/requesting-code-review/SKILL.md +101 -101
package/skills/requesting-code-review/code-reviewer.md +168 -168
package/skills/systematic-debugging/CREATION-LOG.md +119 -119
package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
package/skills/systematic-debugging/condition-based-waiting.md +115 -115
package/skills/systematic-debugging/defense-in-depth.md +122 -122
package/skills/systematic-debugging/find-polluter.sh +63 -63
package/skills/systematic-debugging/root-cause-tracing.md +169 -169
package/skills/systematic-debugging/test-academic.md +14 -14
package/skills/systematic-debugging/test-pressure-1.md +58 -58
package/skills/systematic-debugging/test-pressure-2.md +68 -68
package/skills/systematic-debugging/test-pressure-3.md +69 -69
package/skills/using-git-worktrees/SKILL.md +215 -215
package/skills/verification-before-completion/SKILL.md +154 -154
package/skills/webapp-testing/SKILL.md +19 -19
package/dist/worker/console/static/assets/index-fsjzREob.js +0 -56

package/dist/worker/console/static/index.html CHANGED Viewed

@@ -6,8 +6,8 @@
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
     <link rel="stylesheet" href="/inspect/operator-chrome.css" />
     <title>Loop 操作台 · Operator Console</title>
-    <script type="module" crossorigin src="/assets/index-fsjzREob.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-hJqCPs_g.css">
+    <script type="module" crossorigin src="/assets/index-SjjjZnV3.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-Dups4sSM.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/worker/console/static-src/operator-chat/slash-palette-nav.js ADDED Viewed

@@ -0,0 +1,141 @@
+/**
+ * Slash palette display + navigation model (UI-12 card grid).
+ *
+ * Display order (SLASH_GROUP_DISPLAY_ORDER) is intentionally decoupled from
+ * the conflict/priority order in shortcuts.ts (SOURCE_PRIORITY): merge and
+ * dedupe keep SOURCE_PRIORITY semantics (skill 3 < prompt 4), while rendering
+ * follows the display order (prompt group before skill group). buildPaletteModel
+ * models that divergence explicitly — every card carries its flat-list
+ * globalIndex so keyboard/AT state round-trips from the rendered position back
+ * to filteredShortcuts[globalIndex]. shortcuts.ts itself stays untouched.
+ *
+ * All functions here are pure/DOM-free so the geometric and row-aware
+ * navigation can be unit-tested in node with fixture rects.
+ */
+import { SLASH_SOURCE_LABEL, } from "../../chat/shortcuts.js";
+/** Group render order (independent from SOURCE_PRIORITY conflict order). */
+export const SLASH_GROUP_DISPLAY_ORDER = [
+    "operator",
+    "web",
+    "extension",
+    "prompt",
+    "skill",
+];
+/** Group filtered candidates by display order, skipping empty groups. */
+export function buildPaletteModel(entries) {
+    const groups = [];
+    for (const source of SLASH_GROUP_DISPLAY_ORDER) {
+        const items = [];
+        for (let i = 0; i < entries.length; i += 1) {
+            if (entries[i].source === source) {
+                items.push({ entry: entries[i], globalIndex: i });
+            }
+        }
+        if (items.length === 0)
+            continue;
+        groups.push({ source, label: SLASH_SOURCE_LABEL[source], items });
+    }
+    return groups;
+}
+/** Keep the active option index inside the current candidate range. */
+export function clampShortcutIndex(index, length) {
+    if (!Number.isFinite(length) || length <= 0)
+        return 0;
+    if (!Number.isFinite(index) || index < 0)
+        return 0;
+    if (index >= length)
+        return length - 1;
+    return index;
+}
+/** CSS grid columns per workspace layout mode (single source: layoutMode). */
+export function paletteColumnCount(mode) {
+    if (mode === "comfortable")
+        return 3;
+    if (mode === "compact")
+        return 2;
+    return 1;
+}
+/**
+ * Group- and row-aware movement on the displayed card grid.
+ *
+ * Left/Right move to the adjacent card in the current row and stay inside the
+ * current group (row start/end stick; group headers are never entered; narrow
+ * 1-column layout is a no-op). Up/Down move within the same column to the
+ * adjacent row, may cross group boundaries, and stick at grid edges — never
+ * wrapping around and never leaving [0, entries.length - 1].
+ */
+export function movePaletteIndex(currentIndex, model, columns, direction) {
+    const groupPos = model.findIndex((group) => group.items.some((card) => card.globalIndex === currentIndex));
+    if (groupPos < 0)
+        return currentIndex;
+    const group = model[groupPos];
+    const offset = group.items.findIndex((card) => card.globalIndex === currentIndex);
+    if (offset < 0)
+        return currentIndex;
+    const row = Math.floor(offset / columns);
+    const col = offset % columns;
+    if (direction === "left" || direction === "right") {
+        if (columns <= 1)
+            return currentIndex;
+        const delta = direction === "left" ? -1 : 1;
+        const targetOffset = offset + delta;
+        if (targetOffset < 0 || targetOffset >= group.items.length) {
+            return currentIndex;
+        }
+        if (Math.floor(targetOffset / columns) !== row)
+            return currentIndex;
+        return group.items[targetOffset].globalIndex;
+    }
+    const delta = direction === "up" ? -1 : 1;
+    const targetOffset = offset + delta * columns;
+    if (targetOffset >= 0 && targetOffset < group.items.length) {
+        return group.items[targetOffset].globalIndex;
+    }
+    // Cross-group: walk to the previous/next non-empty group and target the
+    // same column on its last (up) / first (down) row; stick when that column
+    // does not exist in the partial edge row.
+    for (let cursor = groupPos + delta; cursor >= 0 && cursor < model.length; cursor += delta) {
+        const candidate = model[cursor];
+        if (candidate.items.length === 0)
+            continue;
+        const lastRowStart = Math.floor((candidate.items.length - 1) / columns) * columns;
+        const target = direction === "up" ? lastRowStart + col : col;
+        if (target >= candidate.items.length)
+            return currentIndex;
+        return candidate.items[target].globalIndex;
+    }
+    return currentIndex;
+}
+/**
+ * Geometry-first Up/Down targeting: from the active card's measured rect,
+ * pick the adjacent row's candidate whose horizontal center is nearest the
+ * active card's center (group boundaries may be crossed). Returns null when
+ * no candidate exists above/below (or the layout was not measured), so the
+ * caller falls back to movePaletteIndex. globalIndex comes from
+ * data-shortcut-index — never from the DOM list position.
+ */
+export function pickAdjacentRowTarget(activeRect, cells, direction) {
+    const activeCenterX = (activeRect.left + activeRect.right) / 2;
+    let best = null;
+    for (const cell of cells) {
+        if (cell.globalIndex === activeRect.globalIndex)
+            continue;
+        const gap = direction === "up"
+            ? activeRect.top - cell.bottom
+            : cell.top - activeRect.bottom;
+        // Same-row cells overlap vertically (gap < 0) and must be ignored.
+        if (gap < 0)
+            continue;
+        const centerX = (cell.left + cell.right) / 2;
+        const dist = Math.abs(centerX - activeCenterX);
+        if (best === null ||
+            gap < best.gap ||
+            (gap === best.gap && dist < best.dist) ||
+            (gap === best.gap &&
+                dist === best.dist &&
+                cell.globalIndex < best.index)) {
+            best = { gap, dist, index: cell.globalIndex };
+        }
+    }
+    return best?.index ?? null;
+}

package/dist/worker/console/static-src/operator-chat/useChatSessions.js CHANGED Viewed

@@ -364,15 +364,26 @@ export function useChatSessions(params) {
         createSessionAndPrimeTitleWatcherForHook,
     ]);
     // Phase-1: fork / in-session branch / mainline switch UI deferred; API routes remain.
-    const compactSession = useCallback(async () => {
+    /** Single compact helper for toolbar + `/compact <instructions>` (AC-1). */
+    const compactSession = useCallback(async (instructions) => {
         const current = refs.sessionRef.current;
         if (!current || refs.streamingRef.current)
             return;
+        const trimmed = typeof instructions === "string" ? instructions.trim() : "";
         try {
+            const headers = {
+                "x-loop-console-confirmation": confirmationToken(),
+            };
+            if (trimmed) {
+                headers["content-type"] = "application/json";
+            }
             const response = await fetch(`${origin}/api/operator/v1/chat/sessions/${encodeURIComponent(current.sessionId)}/compact`, {
                 method: "POST",
                 credentials: "include",
-                headers: { "x-loop-console-confirmation": confirmationToken() },
+                headers,
+                ...(trimmed
+                    ? { body: JSON.stringify({ instructions: trimmed }) }
+                    : {}),
             });
             const body = (await response.json().catch(() => ({})));
             if (!response.ok) {

package/dist/worker/console/static-src/operator-chat/useComposer.js CHANGED Viewed

@@ -1,6 +1,7 @@
 import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from "react";
 import { filterSlashCommands, mergeSlashCommands, } from "../../chat/shortcuts.js";
 import { confirmationToken } from "./format.js";
+import { clampShortcutIndex } from "./slash-palette-nav.js";
 import { attachRuntimeSnapshotController } from "./useRuntimeSnapshot.js";
 /** Composer state: input text, @file palette, image attachments, /shortcuts,
  *  IME composition guards, auto-grow and server-side draft sync. */
@@ -16,12 +17,22 @@ export function useComposer(params) {
     const [dynamicCommandsError, setDynamicCommandsError] = useState(null);
     const [commandsEpoch, setCommandsEpoch] = useState(0);
     const textareaRef = useRef(null);
-    const commandsSessionRef = useRef(undefined);
+    /** Active session generation for /commands; bumped immediately on switch (AC-2). */
+    const commandsSessionRef = useRef(sessionId);
+    const commandsGenerationRef = useRef(0);
     const handleInputChange = useCallback((value) => {
         setInput(value);
         setShortcutOpen(value.startsWith("/"));
         setShortcutIndex(0);
     }, []);
+    // Immediate invalidation on A→B even when B palette never opens (AC-2).
+    useLayoutEffect(() => {
+        commandsSessionRef.current = sessionId;
+        commandsGenerationRef.current += 1;
+        setDynamicCommands([]);
+        setDynamicCommandsError(null);
+        setDynamicCommandsLoading(false);
+    }, [sessionId]);
     const loadDynamicCommands = useCallback(async () => {
         if (!sessionId) {
             setDynamicCommands([]);
@@ -30,12 +41,15 @@ export function useComposer(params) {
             return;
         }
         const target = sessionId;
+        const generation = commandsGenerationRef.current;
         commandsSessionRef.current = target;
         setDynamicCommandsLoading(true);
         setDynamicCommandsError(null);
+        const isCurrent = () => commandsSessionRef.current === target &&
+            commandsGenerationRef.current === generation;
         try {
             const res = await fetch(`${origin}/api/operator/v1/chat/sessions/${encodeURIComponent(target)}/commands`, { credentials: "include" });
-            if (commandsSessionRef.current !== target)
+            if (!isCurrent())
                 return;
             if (!res.ok) {
                 setDynamicCommandsError("动态命令加载失败");
@@ -61,26 +75,27 @@ export function useComposer(params) {
                     source,
                 });
             }
-            if (commandsSessionRef.current !== target)
+            if (!isCurrent())
                 return;
             setDynamicCommands(items);
+            // Compact server fail-soft / partial-source warning; local Operator/Web still merge.
+            const warning = typeof body?.warning === "string" ? body.warning.trim() : "";
+            setDynamicCommandsError(warning ? warning.slice(0, 160) : null);
         }
         catch {
-            if (commandsSessionRef.current !== target)
+            if (!isCurrent())
                 return;
             setDynamicCommandsError("动态命令加载失败");
             setDynamicCommands([]);
         }
         finally {
-            if (commandsSessionRef.current === target) {
+            if (isCurrent()) {
                 setDynamicCommandsLoading(false);
             }
         }
     }, [origin, sessionId]);
     // Lazy-load dynamic commands when slash palette opens or session changes.
     useEffect(() => {
-        setDynamicCommands([]);
-        setDynamicCommandsError(null);
         if (!sessionId)
             return;
         if (!shortcutOpen && commandsEpoch === 0)
@@ -172,6 +187,14 @@ export function useComposer(params) {
     const filteredShortcuts = useMemo(() => input.startsWith("/")
         ? filterSlashCommands(mergedCommands, input)
         : [], [input, mergedCommands]);
+    // Keep the active option index inside the current candidate range (UI-12
+    // AC-011): dynamic loads completing/failing empty, retries, session
+    // switches, late responses and search shrink all funnel through
+    // filteredShortcuts.length. The clamped index always matches a rendered
+    // `oc-shortcut-option-${globalIndex}` id (same source of truth).
+    useEffect(() => {
+        setShortcutIndex((index) => clampShortcutIndex(index, filteredShortcuts.length));
+    }, [filteredShortcuts.length]);
     const onCompositionStart = useCallback(() => {
         refs.isComposingRef.current = true;
     }, [refs]);

package/dist/worker/observe/static/copy.js CHANGED Viewed

@@ -1,67 +1,67 @@
-/** Copy-only recommended commands (Observe UI R5). */
-import { el } from "./dom.js";
-export async function copyText(text) {
-	const value = String(text ?? "");
-	if (!value) return false;
-	try {
-		if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
-			await navigator.clipboard.writeText(value);
-			return true;
-		}
-	} catch {
-		// fall through
-	}
-	try {
-		const ta = document.createElement("textarea");
-		ta.value = value;
-		ta.setAttribute("readonly", "");
-		ta.style.position = "fixed";
-		ta.style.left = "-9999px";
-		document.body.appendChild(ta);
-		ta.select();
-		const ok = document.execCommand("copy");
-		document.body.removeChild(ta);
-		return ok;
-	} catch {
-		return false;
-	}
-}
-/** Advisory recommended command: copy-only, never executes. */
-export function renderRecommendedCommand(action) {
-	const block = el("div", "recommended-command");
-	if (!action) {
-		block.appendChild(el("span", "muted", "缺失"));
-		return block;
-	}
-	const head = el("div", "recommended-command-head");
-	if (action.kind) {
-		head.appendChild(el("span", "recommended-command-kind", action.kind));
-	}
-	head.appendChild(
-		el("span", "recommended-command-label", action.label ?? "—"),
-	);
-	block.appendChild(head);
-	if (action.command) {
-		const body = el("div", "recommended-command-body");
-		const code = el("code", "recommended-command-text", action.command);
-		body.appendChild(code);
-		const btn = el("button", "copy-command", "复制");
-		btn.type = "button";
-		btn.addEventListener("click", (e) => {
-			e.preventDefault();
-			e.stopPropagation();
-			void copyText(action.command).then((ok) => {
-				btn.textContent = ok ? "已复制" : "复制失败";
-				setTimeout(() => {
-					btn.textContent = "复制";
-				}, 1500);
-			});
-		});
-		body.appendChild(btn);
-		block.appendChild(body);
-	}
-	return block;
-}
+/** Copy-only recommended commands (Observe UI R5). */
+import { el } from "./dom.js";
+export async function copyText(text) {
+	const value = String(text ?? "");
+	if (!value) return false;
+	try {
+		if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
+			await navigator.clipboard.writeText(value);
+			return true;
+		}
+	} catch {
+		// fall through
+	}
+	try {
+		const ta = document.createElement("textarea");
+		ta.value = value;
+		ta.setAttribute("readonly", "");
+		ta.style.position = "fixed";
+		ta.style.left = "-9999px";
+		document.body.appendChild(ta);
+		ta.select();
+		const ok = document.execCommand("copy");
+		document.body.removeChild(ta);
+		return ok;
+	} catch {
+		return false;
+	}
+}
+/** Advisory recommended command: copy-only, never executes. */
+export function renderRecommendedCommand(action) {
+	const block = el("div", "recommended-command");
+	if (!action) {
+		block.appendChild(el("span", "muted", "缺失"));
+		return block;
+	}
+	const head = el("div", "recommended-command-head");
+	if (action.kind) {
+		head.appendChild(el("span", "recommended-command-kind", action.kind));
+	}
+	head.appendChild(
+		el("span", "recommended-command-label", action.label ?? "—"),
+	);
+	block.appendChild(head);
+	if (action.command) {
+		const body = el("div", "recommended-command-body");
+		const code = el("code", "recommended-command-text", action.command);
+		body.appendChild(code);
+		const btn = el("button", "copy-command", "复制");
+		btn.type = "button";
+		btn.addEventListener("click", (e) => {
+			e.preventDefault();
+			e.stopPropagation();
+			void copyText(action.command).then((ok) => {
+				btn.textContent = ok ? "已复制" : "复制失败";
+				setTimeout(() => {
+					btn.textContent = "复制";
+				}, 1500);
+			});
+		});
+		body.appendChild(btn);
+		block.appendChild(body);
+	}
+	return block;
+}

package/dist/worker/observe/static/dag-layout.d.ts CHANGED Viewed

@@ -1,36 +1,36 @@
-export type DagLayoutNodeInput = { nodeId: string };
-export type DagLayoutEdgeInput = { from: string; to: string };
-export type DagLayoutNode = {
-	nodeId: string;
-	rank: number;
-	index: number;
-	x: number;
-	y: number;
-	width: number;
-	height: number;
-};
-export type DagLayoutEdge = DagLayoutEdgeInput & { path: string };
-export type DagLayout = {
-	width: number;
-	height: number;
-	nodes: DagLayoutNode[];
-	edges: DagLayoutEdge[];
-};
-export type DagLayoutOptions = Partial<{
-	nodeWidth: number;
-	nodeHeight: number;
-	rankGap: number;
-	nodeGap: number;
-	padding: number;
-	controlLaneCount: number;
-	/** Per-node visual card height overrides; ordinary ports still use nodeHeight axis. */
-	nodeHeights: Record<string, number>;
-}>;
-export function layoutDag(
-	nodes?: DagLayoutNodeInput[],
-	edges?: DagLayoutEdgeInput[],
-	ranks?: string[][],
-	options?: DagLayoutOptions,
-): DagLayout;
+export type DagLayoutNodeInput = { nodeId: string };
+export type DagLayoutEdgeInput = { from: string; to: string };
+export type DagLayoutNode = {
+	nodeId: string;
+	rank: number;
+	index: number;
+	x: number;
+	y: number;
+	width: number;
+	height: number;
+};
+export type DagLayoutEdge = DagLayoutEdgeInput & { path: string };
+export type DagLayout = {
+	width: number;
+	height: number;
+	nodes: DagLayoutNode[];
+	edges: DagLayoutEdge[];
+};
+export type DagLayoutOptions = Partial<{
+	nodeWidth: number;
+	nodeHeight: number;
+	rankGap: number;
+	nodeGap: number;
+	padding: number;
+	controlLaneCount: number;
+	/** Per-node visual card height overrides; ordinary ports still use nodeHeight axis. */
+	nodeHeights: Record<string, number>;
+}>;
+export function layoutDag(
+	nodes?: DagLayoutNodeInput[],
+	edges?: DagLayoutEdgeInput[],
+	ranks?: string[][],
+	options?: DagLayoutOptions,
+): DagLayout;