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

package/backend/dist/tracks/__tests__/verify-track.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * T0 verification script for the Track subsystem.
+ *
+ * NOT a vitest/jest test — ccweb backend has no test framework yet.
+ * Runs as a standalone Node script to verify end-to-end:
+ *
+ *   1. TrackRunner can load a .tr file
+ *   2. train-lang composes prompt + calls CcwebTrainAdapter
+ *   3. CcwebTrainAdapter injects prompt (capture into a mock buffer)
+ *   4. We programmatically simulate the LLM writing outputs by editing
+ *      workflow_data.json + setting task_progress[].finish = true
+ *   5. WorkflowDataWatcher detects the finish signal
+ *   6. Adapter reads variables.<name> → returns FaiResult.success
+ *   7. train continues execution → main() returns
+ *   8. TrackRunner reports ok=true with the returned value
+ *
+ * Run:  cd backend && npx ts-node src/tracks/__tests__/verify-track.ts
+ */
+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 });
+const fs = __importStar(require("fs/promises"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const __1 = require("..");
+let failed = 0;
+function check(name, cond, msg) {
+    if (cond) {
+        console.log(`  ✓ ${name}`);
+    }
+    else {
+        failed++;
+        console.error(`  ✗ ${name}${msg ? ': ' + msg : ''}`);
+    }
+}
+const DEMO_TR = `
+fai analyze(file_path: string, prompt: prompt) -> rating: int 0-10, comment: string maxLen=500 { }
+
+func main(input_path: string) -> string {
+  let r = analyze(input_path, "评分 0-10")
+  return r.comment
+}
+
+export main
+`;
+async function readWf(p) {
+    const text = await fs.readFile(p, 'utf8');
+    return JSON.parse(text);
+}
+async function writeWf(p, w) {
+    await fs.writeFile(p, JSON.stringify(w, null, 2), 'utf8');
+}
+async function main() {
+    console.log('=== Track T0 verification ===\n');
+    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ccweb-track-t0-'));
+    console.log(`tmpDir = ${tmpDir}`);
+    const trackPath = path.join(tmpDir, 'demo.tr');
+    const wfPath = path.join(tmpDir, 'workflow_data.json');
+    await fs.writeFile(trackPath, DEMO_TR, 'utf8');
+    await writeWf(wfPath, {
+        constants: {},
+        variables: {},
+        task_progress: [],
+    });
+    const watcher = (0, __1.createWorkflowDataWatcher)(wfPath);
+    // Capture prompts injected by adapter
+    const promptsInjected = [];
+    // Mock injector: instead of writing to a PTY, it parses the
+    // [Required outputs] section from the prompt, fabricates legal
+    // values, and writes them to workflow_data.json after a short
+    // delay (simulating LLM round-trip latency).
+    const injector = async (text) => {
+        promptsInjected.push(text);
+        // Extract taskIndex from the ccweb header (first 3 lines)
+        const m = text.match(/taskIndex = (\d+)/);
+        if (!m)
+            throw new Error('no taskIndex in prompt — adapter contract broken');
+        const taskIndex = Number(m[1]);
+        // Simulate LLM writing outputs after 30ms
+        setTimeout(async () => {
+            const wf = await readWf(wfPath);
+            // Pretend the LLM gave rating=8 + comment="OK"
+            wf.variables.rating = 8;
+            wf.variables.comment = 'OK';
+            wf.task_progress.push({
+                nodeId: taskIndex,
+                name: 'analyze',
+                finish: true,
+                startedAt: Date.now() - 10,
+                finishedAt: Date.now(),
+            });
+            await writeWf(wfPath, wf);
+        }, 30);
+    };
+    const runner = (0, __1.createTrackRunner)({
+        projectId: 'demo-proj',
+        injector,
+        watcher,
+        maxFaiAttempts: 2,
+        defaultFaiTimeoutMs: 5000,
+    });
+    const result = await runner.run(trackPath, ['src/foo.ts']);
+    // Assertions
+    check('result.ok is true', result.ok, JSON.stringify(result.error));
+    check('result.value is the LLM-supplied comment ("OK")', result.value === 'OK', `got: ${JSON.stringify(result.value)}`);
+    check('injector called exactly once', promptsInjected.length === 1);
+    check('prompt contains writeProtocolHint marker', promptsInjected[0]?.includes('[Write outputs to .ccweb/workflow_data.json') ?? false);
+    check('prompt does NOT contain stale train default hint', !(promptsInjected[0]?.includes('stack[<callId>]') ?? false));
+    check('prompt contains ccweb track context header (taskIndex)', promptsInjected[0]?.includes('taskIndex = ') ?? false);
+    check('final workflow_data.task_progress has 1 finished entry', (await readWf(wfPath)).task_progress.length === 1);
+    // Verify cancellation path
+    console.log('\n--- cancellation path ---');
+    await writeWf(wfPath, {
+        constants: {},
+        variables: {},
+        task_progress: [],
+    });
+    // Use an injector that never resolves the finish signal
+    const slowPromptsInjected = [];
+    const slowInjector = async (text) => {
+        slowPromptsInjected.push(text);
+        // Don't write anything — simulate LLM hung
+    };
+    const watcher2 = (0, __1.createWorkflowDataWatcher)(wfPath);
+    const cancelRunner = (0, __1.createTrackRunner)({
+        projectId: 'demo-proj',
+        injector: slowInjector,
+        watcher: watcher2,
+        maxFaiAttempts: 1,
+        defaultFaiTimeoutMs: 60000, // long timeout — we'll cancel before this
+    });
+    // Cancel after 100ms
+    const cancelTimer = setTimeout(() => cancelRunner.cancel(), 100);
+    const cancelResult = await cancelRunner.run(trackPath, ['src/foo.ts']);
+    clearTimeout(cancelTimer);
+    check('cancel: ok is false', !cancelResult.ok);
+    check('cancel: error is UserCancelError-like', /cancel/i.test(cancelResult.error?.errorType ?? '') ||
+        /cancel/i.test(cancelResult.error?.message ?? ''), `got: ${JSON.stringify(cancelResult.error)}`);
+    // Verify writeProtocolHint factory shape (smoke test)
+    console.log('\n--- buildCcwebWriteProtocolHint shape ---');
+    const hint = (0, __1.buildCcwebWriteProtocolHint)();
+    check('hint mentions workflow_data.json', hint.includes('workflow_data.json'));
+    check('hint mentions variables', hint.includes('variables.<name>'));
+    check('hint mentions task_progress', hint.includes('task_progress'));
+    check('hint mentions finish: true', hint.includes('finish: true'));
+    // Cleanup
+    await fs.rm(tmpDir, { recursive: true, force: true });
+    console.log(`\n${failed === 0 ? '✅ ALL CHECKS PASSED' : `❌ ${failed} CHECK(S) FAILED`}`);
+    process.exit(failed === 0 ? 0 : 1);
+}
+main().catch((e) => {
+    console.error('verify-track crashed:', e);
+    process.exit(2);
+});
+//# sourceMappingURL=verify-track.js.map

package/backend/dist/tracks/__tests__/verify-track.js.map

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

package/backend/dist/tracks/ask-user-bridge.d.ts

@@ -0,0 +1,59 @@
+/**
+ * AskUserBridge — bridges train-lang's host builtin call to the ccweb
+ * frontend.
+ *
+ * Flow:
+ *   1. .tr code calls `__ccweb_ask_user({ fields: [...] })`
+ *   2. train evaluates this as a builtin → call our bridge.requestInput()
+ *   3. bridge pushes a "track_ask_user" event (via onPush callback)
+ *      to the WebSocket layer, which broadcasts to the frontend
+ *   4. frontend renders a form, user submits → POST /api/.../tracks/input
+ *   5. route handler calls bridge.submitInput(runId, requestId, data)
+ *   6. bridge resolves the pending Promise → train continues
+ *
+ * The bridge maintains one pending request per runId. Concurrent
+ * ask_user calls within one track would queue (only the most recent
+ * pending request is active). For T1 this is fine; multi-prompt would
+ * need a queue (T2+).
+ *
+ * Cancellation: AbortSignal aborts the pending request immediately,
+ * rejecting the Promise with a TrainException-shaped error.
+ */
+import type { Value, BuiltinFunction } from '../tracks/types-train';
+export interface AskUserFieldSpec {
+    key: string;
+    label: string;
+    type: 'text' | 'enum' | 'number' | 'bool';
+    variants?: string[];
+    placeholder?: string;
+    required?: boolean;
+}
+export interface AskUserRequest {
+    runId: string;
+    requestId: string;
+    fields: AskUserFieldSpec[];
+}
+export interface AskUserPushEvent extends AskUserRequest {
+    kind: 'track_ask_user';
+}
+export type AskUserPushFn = (event: AskUserPushEvent) => void;
+export interface AskUserBridge {
+    /** Called from the builtin when train evaluates __ccweb_ask_user(...). */
+    requestInput(runId: string, spec: AskUserFieldSpec[], signal?: AbortSignal): Promise<Record<string, Value>>;
+    /** Called from the route handler when the user submits the form. */
+    submitInput(runId: string, requestId: string, data: Record<string, Value>): {
+        ok: boolean;
+        message?: string;
+    };
+    /** Reject all pending requests for a runId (e.g. on track cancel). */
+    cancelAllForRun(runId: string, reason?: string): void;
+    /** For diagnostics + tests. */
+    getPending(runId: string): AskUserRequest | null;
+}
+export declare function createAskUserBridge(onPush: AskUserPushFn): AskUserBridge;
+/**
+ * Build the `__ccweb_ask_user` builtin function bound to this run's
+ * bridge + AbortSignal. Pass into TrainOptions.extraBuiltins.
+ */
+export declare function createAskUserBuiltin(bridge: AskUserBridge, runId: string, signal?: AbortSignal): Promise<BuiltinFunction>;
+//# sourceMappingURL=ask-user-bridge.d.ts.map

package/backend/dist/tracks/ask-user-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-bridge.d.ts","sourceRoot":"","sources":["../../src/tracks/ask-user-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGnE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;IACzC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,IAAI,EAAE,gBAAgB,CAAA;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAE7D,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,YAAY,CACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,gBAAgB,EAAE,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IAEjC,oEAAoE;IACpE,WAAW,CACT,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAC1B;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAEpC,sEAAsE;IACtE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAErD,+BAA+B;IAC/B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAA;CACjD;AAiBD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CA2IxE;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CAiB1B"}

package/backend/dist/tracks/ask-user-bridge.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * AskUserBridge — bridges train-lang's host builtin call to the ccweb
+ * frontend.
+ *
+ * Flow:
+ *   1. .tr code calls `__ccweb_ask_user({ fields: [...] })`
+ *   2. train evaluates this as a builtin → call our bridge.requestInput()
+ *   3. bridge pushes a "track_ask_user" event (via onPush callback)
+ *      to the WebSocket layer, which broadcasts to the frontend
+ *   4. frontend renders a form, user submits → POST /api/.../tracks/input
+ *   5. route handler calls bridge.submitInput(runId, requestId, data)
+ *   6. bridge resolves the pending Promise → train continues
+ *
+ * The bridge maintains one pending request per runId. Concurrent
+ * ask_user calls within one track would queue (only the most recent
+ * pending request is active). For T1 this is fine; multi-prompt would
+ * need a queue (T2+).
+ *
+ * Cancellation: AbortSignal aborts the pending request immediately,
+ * rejecting the Promise with a TrainException-shaped error.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAskUserBridge = createAskUserBridge;
+exports.createAskUserBuiltin = createAskUserBuiltin;
+const train_loader_1 = require("./train-loader");
+function detachSignal(entry) {
+    if (entry.signal && entry.signalHandler) {
+        entry.signal.removeEventListener('abort', entry.signalHandler);
+        entry.signalHandler = undefined;
+    }
+}
+function createAskUserBridge(onPush) {
+    const pending = new Map(); // runId → PendingRequest
+    function newRequestId() {
+        return 'req-' + Math.random().toString(36).slice(2, 10);
+    }
+    function validateSpec(spec) {
+        if (!Array.isArray(spec) || spec.length === 0) {
+            throw new Error('ask_user requires a non-empty fields array');
+        }
+        const seen = new Set();
+        for (const f of spec) {
+            if (!f.key || typeof f.key !== 'string') {
+                throw new Error('ask_user field missing string key');
+            }
+            if (seen.has(f.key)) {
+                throw new Error(`ask_user duplicate field key: ${f.key}`);
+            }
+            seen.add(f.key);
+            if (f.type === 'enum' && (!f.variants || f.variants.length === 0)) {
+                throw new Error(`ask_user enum field "${f.key}" missing variants`);
+            }
+        }
+    }
+    function validateResponse(spec, data) {
+        for (const f of spec) {
+            const v = data[f.key];
+            if (v === undefined && f.required !== false) {
+                return { ok: false, message: `missing required field: ${f.key}` };
+            }
+            if (v === undefined)
+                continue;
+            switch (f.type) {
+                case 'text':
+                    if (typeof v !== 'string') {
+                        return { ok: false, message: `${f.key}: expected string` };
+                    }
+                    break;
+                case 'number':
+                    if (typeof v !== 'number') {
+                        return { ok: false, message: `${f.key}: expected number` };
+                    }
+                    break;
+                case 'bool':
+                    if (typeof v !== 'boolean') {
+                        return { ok: false, message: `${f.key}: expected boolean` };
+                    }
+                    break;
+                case 'enum':
+                    if (typeof v !== 'string' || !f.variants?.includes(v)) {
+                        return {
+                            ok: false,
+                            message: `${f.key}: must be one of [${f.variants?.join(', ') ?? ''}]`,
+                        };
+                    }
+                    break;
+            }
+        }
+        return { ok: true };
+    }
+    return {
+        requestInput(runId, spec, signal) {
+            validateSpec(spec);
+            return new Promise((resolve, reject) => {
+                // If a previous request for this runId is still pending,
+                // detach its abort listener BEFORE rejecting + replacing.
+                // Otherwise an abort on the old signal would `pending.delete(runId)`
+                // and clobber the new request.
+                const existing = pending.get(runId);
+                if (existing) {
+                    detachSignal(existing);
+                    pending.delete(runId);
+                    existing.reject(new Error('superseded by new ask_user request'));
+                }
+                const request = {
+                    runId,
+                    requestId: newRequestId(),
+                    fields: spec,
+                };
+                const entry = { request, resolve, reject, signal };
+                if (signal) {
+                    if (signal.aborted) {
+                        reject(new Error('ask_user cancelled'));
+                        return;
+                    }
+                    // The handler validates that THIS entry is still the active one
+                    // before mutating the map (defense in depth — supersede path above
+                    // already detaches, but a separate abort + supersede race could
+                    // still try to fire stale handlers).
+                    entry.signalHandler = () => {
+                        const current = pending.get(runId);
+                        if (current === entry) {
+                            pending.delete(runId);
+                            reject(new Error('ask_user cancelled'));
+                        }
+                    };
+                    signal.addEventListener('abort', entry.signalHandler, { once: true });
+                }
+                pending.set(runId, entry);
+                onPush({ kind: 'track_ask_user', ...request });
+            });
+        },
+        submitInput(runId, requestId, data) {
+            const entry = pending.get(runId);
+            if (!entry) {
+                return { ok: false, message: `no pending ask_user for runId=${runId}` };
+            }
+            if (entry.request.requestId !== requestId) {
+                return {
+                    ok: false,
+                    message: `requestId mismatch (expected ${entry.request.requestId}, got ${requestId})`,
+                };
+            }
+            const v = validateResponse(entry.request.fields, data);
+            if (!v.ok)
+                return v;
+            pending.delete(runId);
+            detachSignal(entry);
+            entry.resolve(data);
+            return { ok: true };
+        },
+        cancelAllForRun(runId, reason = 'cancelled') {
+            const entry = pending.get(runId);
+            if (!entry)
+                return;
+            pending.delete(runId);
+            detachSignal(entry);
+            entry.reject(new Error(`ask_user ${reason}`));
+        },
+        getPending(runId) {
+            return pending.get(runId)?.request ?? null;
+        },
+    };
+}
+/**
+ * Build the `__ccweb_ask_user` builtin function bound to this run's
+ * bridge + AbortSignal. Pass into TrainOptions.extraBuiltins.
+ */
+async function createAskUserBuiltin(bridge, runId, signal) {
+    return (0, train_loader_1.makeBuiltinDynamic)('__ccweb_ask_user', async (args) => {
+        // args[0] is the spec object passed from .tr:
+        //   __ccweb_ask_user({ fields: [...] })
+        const arg = args[0];
+        if (!arg || typeof arg !== 'object') {
+            throw new Error('__ccweb_ask_user expects 1 argument: { fields: [...] }');
+        }
+        const fields = arg.fields;
+        if (!Array.isArray(fields)) {
+            throw new Error('__ccweb_ask_user spec.fields must be an array');
+        }
+        const result = await bridge.requestInput(runId, fields, signal);
+        return result;
+    });
+}
+//# sourceMappingURL=ask-user-bridge.js.map

package/backend/dist/tracks/ask-user-bridge.js.map

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

package/backend/dist/tracks/ccweb-train-adapter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * CcwebTrainAdapter — bridges train-lang's LLMAdapter interface to
+ * ccweb's PTY + workflow_data.json infrastructure.
+ *
+ * Paradigm: writesWorkflowData=true (agent CLI). train-lang composes
+ * the [System][Inputs][Task][Outputs] prompt; ccweb appends a
+ * writeProtocolHint that tells the LLM to write outputs into
+ * `.ccweb/workflow_data.json` at `variables.<name>`, then signal
+ * completion via `task_progress.push({...finish:true})`.
+ *
+ * 详见 ~/Obsidian/Base/cc-web/工作轨重构规划.md §5。
+ */
+import type { LLMAdapter } from '@train-lang/adapter-spec';
+import type { WorkflowDataWatcher } from './workflow-data-watcher';
+export interface CcwebAdapterDeps {
+    projectId: string;
+    runId: string;
+    /** Inject text into the project's active CLI PTY. */
+    injector: (text: string) => Promise<void> | void;
+    /** Watcher for `.ccweb/workflow_data.json`. */
+    watcher: WorkflowDataWatcher;
+    /** Per-run monotonic counter assigning task_progress[] index. */
+    nextTaskIndex: () => number;
+    /** Optional logger (pino-compatible interface). */
+    logger?: {
+        debug?: (msg: string, ...args: unknown[]) => void;
+        info?: (msg: string, ...args: unknown[]) => void;
+        warn?: (msg: string, ...args: unknown[]) => void;
+        error?: (msg: string, ...args: unknown[]) => void;
+    };
+}
+/**
+ * The writeProtocolHint string injected into train's prompt. ccweb's
+ * single authoritative "how to write back" instruction — replaces
+ * train's default `stack[<callId>].outputs` hint (which doesn't match
+ * ccweb v2 schema).
+ */
+export declare function buildCcwebWriteProtocolHint(): string;
+export declare function createCcwebTrainAdapter(deps: CcwebAdapterDeps): LLMAdapter;
+//# sourceMappingURL=ccweb-train-adapter.d.ts.map

package/backend/dist/tracks/ccweb-train-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccweb-train-adapter.d.ts","sourceRoot":"","sources":["../../src/tracks/ccweb-train-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAElE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAChD,+CAA+C;IAC/C,OAAO,EAAE,mBAAmB,CAAA;IAC5B,iEAAiE;IACjE,aAAa,EAAE,MAAM,MAAM,CAAA;IAC3B,mDAAmD;IACnD,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;QACjD,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;QAChD,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;QAChD,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAClD,CAAA;CACF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAapD;AA+BD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,GAAG,UAAU,CAgE1E"}

package/backend/dist/tracks/ccweb-train-adapter.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * CcwebTrainAdapter — bridges train-lang's LLMAdapter interface to
+ * ccweb's PTY + workflow_data.json infrastructure.
+ *
+ * Paradigm: writesWorkflowData=true (agent CLI). train-lang composes
+ * the [System][Inputs][Task][Outputs] prompt; ccweb appends a
+ * writeProtocolHint that tells the LLM to write outputs into
+ * `.ccweb/workflow_data.json` at `variables.<name>`, then signal
+ * completion via `task_progress.push({...finish:true})`.
+ *
+ * 详见 ~/Obsidian/Base/cc-web/工作轨重构规划.md §5。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCcwebWriteProtocolHint = buildCcwebWriteProtocolHint;
+exports.createCcwebTrainAdapter = createCcwebTrainAdapter;
+/**
+ * The writeProtocolHint string injected into train's prompt. ccweb's
+ * single authoritative "how to write back" instruction — replaces
+ * train's default `stack[<callId>].outputs` hint (which doesn't match
+ * ccweb v2 schema).
+ */
+function buildCcwebWriteProtocolHint() {
+    return [
+        '[Write outputs to .ccweb/workflow_data.json, then signal completion:]',
+        '  1. For each declared output `<name>` in [Required outputs] above:',
+        '       set variables.<name> = <your value matching the declared type>',
+        '  2. Append to task_progress:',
+        '       { nodeId: <taskIndex from prompt header>, name: "<fai name>", ' +
+            'finish: true, finishedAt: <unix ms> }',
+        '',
+        'Do NOT touch other variables. Do NOT modify constants. Do NOT remove ' +
+            'existing task_progress entries.',
+        'After writing, the train runtime will read variables.<name> and continue.',
+    ].join('\n');
+}
+/**
+ * Compose the ccweb-specific prompt prefix that identifies the current
+ * call's taskIndex (for the writeProtocolHint instructions to reference).
+ *
+ * This is prepended (NOT appended) to the prompt train already composed,
+ * so it's visible above [Required outputs].
+ */
+function buildCcwebHeader(taskIndex, fnName) {
+    return `[ccweb track context]\n  taskIndex = ${taskIndex}\n  fai = ${fnName}\n`;
+}
+/**
+ * Filter workflow_data.variables to just the outputs declared on the
+ * fai call. Extra keys are ignored (train validator will catch missing
+ * keys as schema mismatch).
+ */
+function pickOutputs(variables, outputSchema) {
+    const out = {};
+    for (const key of Object.keys(outputSchema)) {
+        if (key in variables) {
+            out[key] = variables[key];
+        }
+    }
+    return out;
+}
+function createCcwebTrainAdapter(deps) {
+    return {
+        name: 'ccweb',
+        version: '0.0.0',
+        capabilities: {
+            parallel: false, // one CLI process per project
+            cancellation: true, // honors req.options.signal
+            writesWorkflowData: true,
+        },
+        async call(req) {
+            const taskIndex = deps.nextTaskIndex();
+            deps.logger?.debug?.('[CcwebTrainAdapter] dispatch', { fnName: req.fnName, taskIndex, callId: req.callId, attempt: req.options.attempt });
+            // Compose final prompt = ccweb header + train's prompt (which
+            // already includes writeProtocolHint from RunOptions).
+            const finalPrompt = buildCcwebHeader(taskIndex, req.fnName) + '\n' + req.prompt;
+            // 1. Inject into PTY
+            try {
+                await deps.injector(finalPrompt);
+            }
+            catch (e) {
+                return {
+                    kind: 'error',
+                    message: `ccweb adapter: failed to inject prompt: ${e.message}`,
+                    recoverable: false,
+                };
+            }
+            // 2. Wait for task_progress[taskIndex].finish=true
+            const outcome = await deps.watcher.waitForFinish(taskIndex, req.options.timeoutMs, req.options.signal);
+            if (outcome.kind === 'timeout') {
+                deps.logger?.warn?.('[CcwebTrainAdapter] timeout', { taskIndex });
+                return { kind: 'timeout' };
+            }
+            if (outcome.kind === 'cancelled') {
+                deps.logger?.info?.('[CcwebTrainAdapter] cancelled', { taskIndex });
+                return { kind: 'cancelled' };
+            }
+            if (outcome.kind === 'error') {
+                return {
+                    kind: 'error',
+                    message: `ccweb adapter: watcher error: ${outcome.message}`,
+                    recoverable: false,
+                };
+            }
+            // 3. Read outputs from workflow_data.variables
+            const outputs = pickOutputs(outcome.data.variables ?? {}, req.outputs);
+            deps.logger?.debug?.('[CcwebTrainAdapter] success', { taskIndex, outputKeys: Object.keys(outputs) });
+            return { kind: 'success', outputs };
+        },
+    };
+}
+//# sourceMappingURL=ccweb-train-adapter.js.map

package/backend/dist/tracks/ccweb-train-adapter.js.map

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

package/backend/dist/tracks/cross-lock.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Cross-subsystem lock between flows and tracks.
+ *
+ * Both flows/runner.ts and tracks/registry.ts write
+ * <project>/.ccweb/workflow_data.json. Concurrent runs on the same
+ * project would corrupt that file (RMW race). This module exposes a
+ * small registry so each side can ask "is the other currently running
+ * on this project?" without creating an import cycle between
+ * routes/flows.ts and routes/tracks.ts or between flows/runner.ts and
+ * tracks/registry.ts.
+ *
+ * Usage:
+ *   - index.ts constructs `trackRegistry` and calls
+ *     `setTrackRunningProbe((pid) => trackRegistry.isRunning(pid))`
+ *   - routes/flows.ts's run handler calls `isTrackRunning(pid)` before
+ *     starting a flow; rejects with 409 if a track is in flight.
+ *   - routes/tracks.ts's run handler imports flowRunner directly
+ *     (already in the same module graph) and calls
+ *     `flowRunner.isRunning(pid)` before starting a track.
+ *
+ * The asymmetry (flows side uses a probe, tracks side imports
+ * flowRunner) is intentional: flowRunner has been a stable module
+ * singleton since v1; trackRegistry was created later inside index.ts
+ * to avoid leaking PTY infra into module init.
+ */
+type RunningProbe = (projectId: string) => boolean;
+export declare function setTrackRunningProbe(fn: RunningProbe): void;
+export declare function isTrackRunning(projectId: string): boolean;
+export {};
+//# sourceMappingURL=cross-lock.d.ts.map

package/backend/dist/tracks/cross-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-lock.d.ts","sourceRoot":"","sources":["../../src/tracks/cross-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,KAAK,YAAY,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;AAIlD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAE3D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAOzD"}