@tom2012/cc-web 2026.5.14-a → 2026.5.15-a

package/backend/dist/tracks/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/tracks/store.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBH,sDAYC;AAUD,gCAgBC;AASD,8BAgBC;AAED,8BAyBC;AAED,kCASC;AAGD,4CAKC;AAYD,4CAgBC;AAED,0CAgBC;AAED,0CAsBC;AAED,8CASC;AAED,wDAKC;AAtND,uCAAwB;AACxB,2CAA4B;AAC5B,uCAAwB;AAExB,MAAM,SAAS,GAAG,KAAK,CAAA;AACvB,MAAM,cAAc,GAAG,QAAQ,CAAA;AAQ/B;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,KAAc;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACzB,yCAAyC;IACzC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAChE,mBAAmB;IACnB,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IAC5C,uBAAuB;IACvB,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,SAAS,CAAA;IAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,aAAqB;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAA;AAC3D,CAAC;AAED,SAAS,SAAS,CAAC,aAAqB,EAAE,QAAgB;IACxD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAA;AACtD,CAAC;AAED,SAAgB,UAAU,CAAC,aAAqB;IAC9C,MAAM,GAAG,GAAG,SAAS,CAAC,aAAa,CAAC,CAAA;IACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5D,MAAM,GAAG,GAAoB,EAAE,CAAA;IAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,SAAQ;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;QACpB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;AACjE,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CACvB,aAAqB,EACrB,QAAgB;IAEhB,MAAM,CAAC,GAAG,SAAS,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QAC1B,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAgB,SAAS,CACvB,aAAqB,EACrB,QAAgB,EAChB,MAAc;IAEd,MAAM,GAAG,GAAG,SAAS,CAAC,aAAa,CAAC,CAAA;IACpC,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACtC,MAAM,CAAC,GAAG,SAAS,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;QAC5C,8DAA8D;QAC9D,kEAAkE;QAClE,0DAA0D;QAC1D,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAC1B,IAAI,EAAE,CAAC,cAAc,EAAE;gBAAE,OAAO,KAAK,CAAA;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,GAAG,CAAA;QACrC,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QACrC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAgB,WAAW,CAAC,aAAqB,EAAE,QAAgB;IACjE,MAAM,CAAC,GAAG,SAAS,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IACnC,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,6DAA6D;AAC7D,SAAgB,gBAAgB,CAC9B,aAAqB,EACrB,QAAgB;IAEhB,OAAO,SAAS,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;AAC3C,CAAC;AAED,2EAA2E;AAE3E,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB,EAAE,QAAgB;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;AACvD,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IACrC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5D,MAAM,GAAG,GAAoB,EAAE,CAAA;IAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,SAAQ;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;AACjE,CAAC;AAED,SAAgB,eAAe,CAC7B,QAAgB,EAChB,QAAgB;IAEhB,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QAC1B,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAC7B,QAAgB,EAChB,QAAgB,EAChB,MAAc;IAEd,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IACrC,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACtC,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAC7C,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAC1B,IAAI,EAAE,CAAC,cAAc,EAAE;gBAAE,OAAO,KAAK,CAAA;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,GAAG,CAAA;QACrC,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QACrC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAAC,QAAgB,EAAE,QAAgB;IAClE,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IACnC,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAgB,sBAAsB,CACpC,QAAgB,EAChB,QAAgB;IAEhB,OAAO,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;AAC5C,CAAC"}

package/backend/dist/tracks/track-runner.d.ts

@@ -0,0 +1,62 @@
+/**
+ * TrackRunner — thin wrapper around train-lang's runFile that wires
+ * the CcwebTrainAdapter + WorkflowDataWatcher + writeProtocolHint into
+ * a single ergonomic API for the rest of the ccweb backend.
+ *
+ * Lifecycle:
+ *   const runner = createTrackRunner({ ... deps ... })
+ *   const result = await runner.run(absTrackPath)
+ *   // result.ok / result.value / result.error
+ *
+ * Cancel mid-run: runner.cancel() → AbortController fires → train
+ * short-circuits next fai dispatch + adapter reports FaiCancelled.
+ *
+ * train-lang is ESM and ccweb backend is CommonJS, so we use a
+ * dynamic import (cached at first call). This is the standard
+ * CJS→ESM interop pattern.
+ *
+ * 详见 ~/Obsidian/Base/cc-web/工作轨重构规划.md §9 T0。
+ */
+import { type CcwebAdapterDeps } from './ccweb-train-adapter';
+import type { WorkflowDataWatcher } from './workflow-data-watcher';
+import type { TrackRunState } from './types';
+import { type AskUserBridge } from './ask-user-bridge';
+export interface TrackRunnerDeps {
+    projectId: string;
+    injector: CcwebAdapterDeps['injector'];
+    watcher: WorkflowDataWatcher;
+    /** Total fai attempts per call. Default 3. */
+    maxFaiAttempts?: number;
+    /** Per-fai-call timeout (ms). Default 600_000. */
+    defaultFaiTimeoutMs?: number;
+    /** Logger (pino). */
+    logger?: CcwebAdapterDeps['logger'];
+    /** Optional extra trace listener for UI progress. */
+    onState?: (state: TrackRunState) => void;
+    /**
+     * Bridge for __ccweb_ask_user builtin. When provided, .tr code can
+     * call __ccweb_ask_user({fields:[...]}) to suspend on user input.
+     * Without a bridge, the builtin is not registered; calls fail with
+     * "Undefined identifier '__ccweb_ask_user'".
+     */
+    askUserBridge?: AskUserBridge;
+}
+export interface TrackRunResult {
+    ok: boolean;
+    value: unknown;
+    error?: {
+        errorType: string;
+        message: string;
+        code?: string;
+    };
+}
+export interface TrackRunner {
+    /** Run a .tr file. Resolves when the track terminates (success/fail/cancel). */
+    run(absTrackPath: string, args?: unknown[]): Promise<TrackRunResult>;
+    /** Cancel an in-flight run. */
+    cancel(): void;
+    /** Current state snapshot. */
+    getState(): TrackRunState | null;
+}
+export declare function createTrackRunner(deps: TrackRunnerDeps): TrackRunner;
+//# sourceMappingURL=track-runner.d.ts.map

package/backend/dist/tracks/track-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-runner.d.ts","sourceRoot":"","sources":["../../src/tracks/track-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAA;IACtC,OAAO,EAAE,mBAAmB,CAAA;IAC5B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kDAAkD;IAClD,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,qBAAqB;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACnC,qDAAqD;IACrD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IACxC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9D;AAyBD,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACpE,+BAA+B;IAC/B,MAAM,IAAI,IAAI,CAAA;IACd,8BAA8B;IAC9B,QAAQ,IAAI,aAAa,GAAG,IAAI,CAAA;CACjC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAoHpE"}

package/backend/dist/tracks/track-runner.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * TrackRunner — thin wrapper around train-lang's runFile that wires
+ * the CcwebTrainAdapter + WorkflowDataWatcher + writeProtocolHint into
+ * a single ergonomic API for the rest of the ccweb backend.
+ *
+ * Lifecycle:
+ *   const runner = createTrackRunner({ ... deps ... })
+ *   const result = await runner.run(absTrackPath)
+ *   // result.ok / result.value / result.error
+ *
+ * Cancel mid-run: runner.cancel() → AbortController fires → train
+ * short-circuits next fai dispatch + adapter reports FaiCancelled.
+ *
+ * train-lang is ESM and ccweb backend is CommonJS, so we use a
+ * dynamic import (cached at first call). This is the standard
+ * CJS→ESM interop pattern.
+ *
+ * 详见 ~/Obsidian/Base/cc-web/工作轨重构规划.md §9 T0。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTrackRunner = createTrackRunner;
+const ccweb_train_adapter_1 = require("./ccweb-train-adapter");
+const ask_user_bridge_1 = require("./ask-user-bridge");
+const train_loader_1 = require("./train-loader");
+async function loadTrain() {
+    // Reuse the shared cache in train-loader.ts so multiple consumers
+    // (TrackRunner, AskUserBuiltin factory, any future host extension)
+    // get the same module instance — avoids ESM module-graph duplication
+    // and removes the double-cache foot-gun.
+    return (0, train_loader_1.loadTrainCore)();
+}
+function createTrackRunner(deps) {
+    let state = null;
+    let abortController = null;
+    let taskIndexCounter = 0;
+    function updateState(patch) {
+        if (!state)
+            return;
+        state = { ...state, ...patch };
+        deps.onState?.(state);
+    }
+    return {
+        async run(absTrackPath, args = []) {
+            const train = await loadTrain();
+            const runId = `track-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+            state = {
+                runId,
+                trackFilename: absTrackPath.split('/').pop() ?? absTrackPath,
+                startedAt: Date.now(),
+                status: 'running',
+            };
+            deps.onState?.(state);
+            abortController = new AbortController();
+            // Start watcher just before run begins
+            deps.watcher.start();
+            const adapter = (0, ccweb_train_adapter_1.createCcwebTrainAdapter)({
+                projectId: deps.projectId,
+                runId,
+                injector: deps.injector,
+                watcher: deps.watcher,
+                nextTaskIndex: () => {
+                    const i = taskIndexCounter++;
+                    updateState({ currentTaskIndex: i });
+                    return i;
+                },
+                logger: deps.logger,
+            });
+            // Build extraBuiltins map (currently: __ccweb_ask_user if bridge provided)
+            const extraBuiltins = new Map();
+            if (deps.askUserBridge) {
+                const askUserFn = await (0, ask_user_bridge_1.createAskUserBuiltin)(deps.askUserBridge, runId, abortController.signal);
+                extraBuiltins.set('__ccweb_ask_user', askUserFn);
+            }
+            try {
+                const result = await train.runFile(absTrackPath, {
+                    args,
+                    adapter,
+                    maxFaiAttempts: deps.maxFaiAttempts ?? 3,
+                    defaultFaiTimeoutMs: deps.defaultFaiTimeoutMs ?? 600000,
+                    writeProtocolHint: (0, ccweb_train_adapter_1.buildCcwebWriteProtocolHint)(),
+                    signal: abortController.signal,
+                    extraBuiltins,
+                });
+                if (result.lexErrors.length > 0 || result.parseErrors.length > 0) {
+                    const message = `parse errors in ${absTrackPath} (${result.lexErrors.length + result.parseErrors.length})`;
+                    updateState({
+                        status: 'failed',
+                        endedAt: Date.now(),
+                        error: { errorType: 'ParseError', message },
+                    });
+                    return { ok: false, value: null, error: { errorType: 'ParseError', message } };
+                }
+                if (!result.ok) {
+                    const exc = result.error;
+                    const errObj = exc
+                        ? {
+                            errorType: exc.errorType ?? 'RuntimeError',
+                            message: exc.message,
+                            code: exc.code,
+                        }
+                        : { errorType: 'RuntimeError', message: 'unknown failure' };
+                    const finalStatus = errObj.errorType === 'UserCancelError' ? 'cancelled' : 'failed';
+                    updateState({ status: finalStatus, endedAt: Date.now(), error: errObj });
+                    return { ok: false, value: null, error: errObj };
+                }
+                updateState({
+                    status: 'completed',
+                    endedAt: Date.now(),
+                    result: result.value,
+                });
+                return { ok: true, value: result.value };
+            }
+            finally {
+                deps.watcher.stop();
+                if (deps.askUserBridge && state) {
+                    // Drain any pending ask_user that the bridge still holds.
+                    deps.askUserBridge.cancelAllForRun(state.runId, 'run ended');
+                }
+                abortController = null;
+            }
+        },
+        cancel() {
+            if (abortController) {
+                abortController.abort();
+                deps.logger?.info?.('[TrackRunner] cancel requested');
+            }
+        },
+        getState() {
+            return state;
+        },
+    };
+}
+//# sourceMappingURL=track-runner.js.map

package/backend/dist/tracks/track-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-runner.js","sourceRoot":"","sources":["../../src/tracks/track-runner.ts"],"names":[],"mappings":"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"}

package/backend/dist/tracks/train-loader.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Dynamic loader for train-lang (ESM) from ccweb backend (CommonJS).
+ *
+ * `import('@train-lang/core')` is rewritten by ts-node/tsc as `require()`
+ * which fails because train-lang is ESM-only. Wrapping the expression in
+ * `new Function(...)` defers it past the TS compiler, leaving a native
+ * dynamic import at runtime.
+ *
+ * Single cache for the whole process. Idempotent.
+ */
+import type { Value, BuiltinFunction } from './types-train';
+/**
+ * Minimal facade over @train-lang/core. Only the entry points we use
+ * from CJS code are listed; keep the type narrow so we don't leak ESM
+ * types across the boundary and so changes to train-lang surface here
+ * loudly.
+ */
+export interface TrainCoreModule {
+    makeBuiltin: (name: string, call: (args: Value[]) => Value | Promise<Value>) => BuiltinFunction;
+    runFile: (absPath: string, opts: unknown) => Promise<{
+        ok: boolean;
+        value: unknown;
+        error?: {
+            errorType?: string;
+            message: string;
+            code?: string;
+        };
+        lexErrors: ReadonlyArray<unknown>;
+        parseErrors: ReadonlyArray<unknown>;
+    }>;
+    TrainException: new (...args: unknown[]) => Error & {
+        errorType: string;
+        message: string;
+        code?: string;
+    };
+}
+export declare function loadTrainCore(): Promise<TrainCoreModule>;
+/**
+ * Async wrapper for makeBuiltin — loads train-lang on first call and
+ * forwards the rest. Use whenever you need to construct a BuiltinFunction
+ * from CommonJS code.
+ */
+export declare function makeBuiltinDynamic(name: string, call: (args: Value[]) => Value | Promise<Value>): Promise<BuiltinFunction>;
+//# sourceMappingURL=train-loader.d.ts.map

package/backend/dist/tracks/train-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"train-loader.d.ts","sourceRoot":"","sources":["../../src/tracks/train-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAO3D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAC5C,eAAe,CAAA;IACpB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;QACnD,EAAE,EAAE,OAAO,CAAA;QACX,KAAK,EAAE,OAAO,CAAA;QACd,KAAK,CAAC,EAAE;YACN,SAAS,CAAC,EAAE,MAAM,CAAA;YAClB,OAAO,EAAE,MAAM,CAAA;YACf,IAAI,CAAC,EAAE,MAAM,CAAA;SACd,CAAA;QACD,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;QACjC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;KACpC,CAAC,CAAA;IACF,cAAc,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,GAAG;QAClD,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAID,wBAAsB,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CAK9D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAC9C,OAAO,CAAC,eAAe,CAAC,CAG1B"}

package/backend/dist/tracks/train-loader.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Dynamic loader for train-lang (ESM) from ccweb backend (CommonJS).
+ *
+ * `import('@train-lang/core')` is rewritten by ts-node/tsc as `require()`
+ * which fails because train-lang is ESM-only. Wrapping the expression in
+ * `new Function(...)` defers it past the TS compiler, leaving a native
+ * dynamic import at runtime.
+ *
+ * Single cache for the whole process. Idempotent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTrainCore = loadTrainCore;
+exports.makeBuiltinDynamic = makeBuiltinDynamic;
+const dynamicImport = new Function('p', 'return import(p)');
+let modPromise = null;
+async function loadTrainCore() {
+    if (!modPromise) {
+        modPromise = dynamicImport('@train-lang/core');
+    }
+    return modPromise;
+}
+/**
+ * Async wrapper for makeBuiltin — loads train-lang on first call and
+ * forwards the rest. Use whenever you need to construct a BuiltinFunction
+ * from CommonJS code.
+ */
+async function makeBuiltinDynamic(name, call) {
+    const train = await loadTrainCore();
+    return train.makeBuiltin(name, call);
+}
+//# sourceMappingURL=train-loader.js.map

package/backend/dist/tracks/train-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"train-loader.js","sourceRoot":"","sources":["../../src/tracks/train-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAwCH,sCAKC;AAOD,gDAMC;AAtDD,MAAM,aAAa,GAAG,IAAI,QAAQ,CAChC,GAAG,EACH,kBAAkB,CACgB,CAAA;AA+BpC,IAAI,UAAU,GAAoC,IAAI,CAAA;AAE/C,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,aAAa,CAAC,kBAAkB,CAA6B,CAAA;IAC5E,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,IAA+C;IAE/C,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAA;IACnC,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AACtC,CAAC"}

package/backend/dist/tracks/types-train.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Re-export train-lang types for CommonJS consumers.
+ *
+ * train-lang is ESM-only, so direct `import { Value } from '@train-lang/core'`
+ * in ts-node CJS mode is risky (TS sometimes resolves types fine, but
+ * isolatedModules / module resolution corner cases can break it).
+ *
+ * Using `import type` here is purely a compile-time alias — the import
+ * is fully erased at JS emit, so no runtime require() is generated.
+ */
+export type { Value, BuiltinFunction, TrainException, RuntimeContext, } from '@train-lang/core';
+//# sourceMappingURL=types-train.d.ts.map

package/backend/dist/tracks/types-train.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-train.d.ts","sourceRoot":"","sources":["../../src/tracks/types-train.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,KAAK,EACL,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAA"}

package/backend/dist/tracks/types-train.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Re-export train-lang types for CommonJS consumers.
+ *
+ * train-lang is ESM-only, so direct `import { Value } from '@train-lang/core'`
+ * in ts-node CJS mode is risky (TS sometimes resolves types fine, but
+ * isolatedModules / module resolution corner cases can break it).
+ *
+ * Using `import type` here is purely a compile-time alias — the import
+ * is fully erased at JS emit, so no runtime require() is generated.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types-train.js.map

package/backend/dist/tracks/types-train.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-train.js","sourceRoot":"","sources":["../../src/tracks/types-train.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/backend/dist/tracks/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * ccweb "工作轨" (Track) — types.
+ *
+ * Track 是 ccweb 重构后的工作流，源码是 .tr 文件，执行引擎是 train-lang
+ * (@train-lang/core)。本文件定义 ccweb 侧的辅助类型（pipe between
+ * train-lang and ccweb's PTY infrastructure）。
+ *
+ * 详见 ~/Obsidian/Base/cc-web/工作轨重构规划.md §3-§5。
+ */
+/**
+ * workflow_data.json schema (v2，与 backend/src/flows/types.ts 保持一致).
+ * Track 沿用同一文件 + 同一协议，只是 train-lang 写入语义化的 outputs
+ * 到 variables，task_progress 标记 finish。
+ */
+export interface WorkflowData {
+    constants: Record<string, unknown>;
+    variables: Record<string, unknown>;
+    task_progress: TaskProgressEntry[];
+}
+export interface TaskProgressEntry {
+    nodeId: number;
+    name: string;
+    finish: boolean;
+    startedAt: number;
+    finishedAt?: number;
+}
+/**
+ * Per-call accounting state held by TrackRunner. `taskIndex` is a
+ * monotonically increasing counter scoped to a single track run; it
+ * indexes into workflow_data.task_progress[].
+ */
+export interface TrackCallState {
+    taskIndex: number;
+    faiName: string;
+    startedAt: number;
+    finishedAt?: number;
+}
+export type TrackRunStatus = 'idle' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+export interface TrackRunState {
+    runId: string;
+    trackFilename: string;
+    startedAt: number;
+    endedAt?: number;
+    status: TrackRunStatus;
+    /** Latest fai call index dispatched (for UI progress display). */
+    currentTaskIndex?: number;
+    /** Final return value when status === completed. */
+    result?: unknown;
+    /** Error message when status === failed. */
+    error?: {
+        errorType: string;
+        message: string;
+        code?: string;
+    };
+}
+/** Identity of a running adapter call — used by watcher.waitForFinish. */
+export interface AdapterCallContext {
+    /** Project + run ids for log/trace correlation. */
+    projectId: string;
+    runId: string;
+    /** Index into workflow_data.task_progress[] for this call. */
+    taskIndex: number;
+    /** Fai function name (for prompt header + log). */
+    fnName: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/backend/dist/tracks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tracks/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,aAAa,EAAE,iBAAiB,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,SAAS,GACT,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,WAAW,CAAA;AAEf,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,cAAc,CAAA;IACtB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9D;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;CACf"}

package/backend/dist/tracks/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * ccweb "工作轨" (Track) — types.
+ *
+ * Track 是 ccweb 重构后的工作流，源码是 .tr 文件，执行引擎是 train-lang
+ * (@train-lang/core)。本文件定义 ccweb 侧的辅助类型（pipe between
+ * train-lang and ccweb's PTY infrastructure）。
+ *
+ * 详见 ~/Obsidian/Base/cc-web/工作轨重构规划.md §3-§5。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/backend/dist/tracks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tracks/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/backend/dist/tracks/workflow-data-watcher.d.ts

@@ -0,0 +1,47 @@
+/**
+ * WorkflowDataWatcher — observe `<project>/.ccweb/workflow_data.json`
+ * for `task_progress[taskIndex].finish === true` signals.
+ *
+ * Replaces (and inlines a more focused version of) the inline polling
+ * loop in backend/src/flows/runner.ts:waitForTaskFinish. The track
+ * subsystem needs the same primitive but decoupled from FlowRunner.
+ *
+ * Strategy:
+ *   - fs.watch with 50ms debounce
+ *   - on each event, read file + parse JSON
+ *   - for any pending waiter whose taskIndex.finish is true → resolve
+ *   - AbortSignal cancels the wait (returns 'cancelled')
+ *   - timeoutMs caps the wait (returns 'timeout')
+ *
+ * The watcher does NOT write to workflow_data.json. Only the LLM (via
+ * the PTY process the adapter injects into) is expected to write.
+ */
+import type { WorkflowData } from './types';
+export type FinishOutcome = {
+    kind: 'ok';
+    finishedAt: number;
+    data: WorkflowData;
+} | {
+    kind: 'timeout';
+} | {
+    kind: 'cancelled';
+} | {
+    kind: 'error';
+    message: string;
+};
+export interface WorkflowDataWatcher {
+    /** Begin watching the file. Idempotent. */
+    start(): void;
+    /** Stop watching + reject all pending waiters with cancelled. */
+    stop(): void;
+    /**
+     * Wait until workflow_data.task_progress[taskIndex].finish === true
+     * for the given taskIndex, OR timeoutMs elapses, OR signal aborts.
+     * Returns the post-finish WorkflowData snapshot on success.
+     */
+    waitForFinish(taskIndex: number, timeoutMs: number, signal?: AbortSignal): Promise<FinishOutcome>;
+    /** One-shot read of the file (used by tests + adapter). */
+    read(): Promise<WorkflowData>;
+}
+export declare function createWorkflowDataWatcher(workflowDataPath: string): WorkflowDataWatcher;
+//# sourceMappingURL=workflow-data-watcher.d.ts.map

package/backend/dist/tracks/workflow-data-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-data-watcher.d.ts","sourceRoot":"","sources":["../../src/tracks/workflow-data-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtC,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,KAAK,IAAI,IAAI,CAAA;IACb,iEAAiE;IACjE,IAAI,IAAI,IAAI,CAAA;IACZ;;;;OAIG;IACH,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAAA;IACzB,2DAA2D;IAC3D,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,CAAA;CAC9B;AAYD,wBAAgB,yBAAyB,CACvC,gBAAgB,EAAE,MAAM,GACvB,mBAAmB,CA2GrB"}

package/backend/dist/tracks/workflow-data-watcher.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * WorkflowDataWatcher — observe `<project>/.ccweb/workflow_data.json`
+ * for `task_progress[taskIndex].finish === true` signals.
+ *
+ * Replaces (and inlines a more focused version of) the inline polling
+ * loop in backend/src/flows/runner.ts:waitForTaskFinish. The track
+ * subsystem needs the same primitive but decoupled from FlowRunner.
+ *
+ * Strategy:
+ *   - fs.watch with 50ms debounce
+ *   - on each event, read file + parse JSON
+ *   - for any pending waiter whose taskIndex.finish is true → resolve
+ *   - AbortSignal cancels the wait (returns 'cancelled')
+ *   - timeoutMs caps the wait (returns 'timeout')
+ *
+ * The watcher does NOT write to workflow_data.json. Only the LLM (via
+ * the PTY process the adapter injects into) is expected to write.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkflowDataWatcher = createWorkflowDataWatcher;
+const fs = __importStar(require("fs"));
+const fsp = __importStar(require("fs/promises"));
+const DEBOUNCE_MS = 50;
+function createWorkflowDataWatcher(workflowDataPath) {
+    let watcher = null;
+    let debounceTimer = null;
+    const waiters = [];
+    async function readSafe() {
+        try {
+            const text = await fsp.readFile(workflowDataPath, 'utf8');
+            return JSON.parse(text);
+        }
+        catch {
+            return null;
+        }
+    }
+    async function checkAll() {
+        const data = await readSafe();
+        if (!data)
+            return;
+        // Snapshot waiters list so resolving doesn't mutate during iteration
+        const pending = waiters.slice();
+        for (const w of pending) {
+            const entry = data.task_progress?.[w.taskIndex];
+            if (entry && entry.finish === true) {
+                finalize(w, {
+                    kind: 'ok',
+                    finishedAt: entry.finishedAt ?? Date.now(),
+                    data,
+                });
+            }
+        }
+    }
+    function finalize(w, outcome) {
+        const idx = waiters.indexOf(w);
+        if (idx >= 0)
+            waiters.splice(idx, 1);
+        clearTimeout(w.timer);
+        if (w.signal && w.signalHandler) {
+            w.signal.removeEventListener('abort', w.signalHandler);
+        }
+        w.resolve(outcome);
+    }
+    function scheduleCheck() {
+        if (debounceTimer)
+            return;
+        debounceTimer = setTimeout(() => {
+            debounceTimer = null;
+            void checkAll();
+        }, DEBOUNCE_MS);
+    }
+    return {
+        start() {
+            if (watcher)
+                return;
+            try {
+                watcher = fs.watch(workflowDataPath, { persistent: false }, () => {
+                    scheduleCheck();
+                });
+            }
+            catch {
+                // File may not exist yet; we'll still attempt to poll on-demand
+                // when a waiter is added (see waitForFinish below).
+            }
+        },
+        stop() {
+            if (watcher) {
+                watcher.close();
+                watcher = null;
+            }
+            if (debounceTimer) {
+                clearTimeout(debounceTimer);
+                debounceTimer = null;
+            }
+            while (waiters.length > 0) {
+                const w = waiters[0];
+                finalize(w, { kind: 'cancelled' });
+            }
+        },
+        waitForFinish(taskIndex, timeoutMs, signal) {
+            return new Promise((resolve) => {
+                const waiter = {
+                    taskIndex,
+                    resolve,
+                    timer: setTimeout(() => finalize(waiter, { kind: 'timeout' }), timeoutMs),
+                    signal,
+                };
+                if (signal) {
+                    if (signal.aborted) {
+                        // already aborted before we even started
+                        resolve({ kind: 'cancelled' });
+                        clearTimeout(waiter.timer);
+                        return;
+                    }
+                    waiter.signalHandler = () => finalize(waiter, { kind: 'cancelled' });
+                    signal.addEventListener('abort', waiter.signalHandler, { once: true });
+                }
+                waiters.push(waiter);
+                // Eager check in case the signal landed before the watcher started
+                void checkAll();
+            });
+        },
+        async read() {
+            const data = await readSafe();
+            if (!data) {
+                throw new Error(`workflow_data.json not readable: ${workflowDataPath}`);
+            }
+            return data;
+        },
+    };
+}
+//# sourceMappingURL=workflow-data-watcher.js.map