@tom2012/cc-web 2026.5.12-c → 2026.5.14-a

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

@@ -1,44 +1,43 @@
 /**
- * Task-flow data model. Three persisted JSON files:
- *  - <project>/.ccweb/flows/<name>.json   — flow definition (design-time)
- *  - <project>/.ccweb/task_todo.json      — co-maintained progress (system + LLM)
- *  - <project>/.ccweb/flow_state.json     — runtime status (system-only)
+ * Task-flow data model (schemaVersion 2).
+ *
+ * All persistent data lives in a single file under each project:
+ *   <project>/.ccweb/workflow_data.json
+ *
+ * It holds three sections:
+ *   - constants:     immutable values declared in FlowDef.constants (initialized
+ *                    once at flow start; never written by user-input/LLM)
+ *   - variables:     mutable values written by user-input nodes and/or LLM nodes
+ *                    (read by any node, branched on by system-logic)
+ *   - task_progress: append-only progress log; the LLM signals node completion
+ *                    by flipping `task_progress[N].finish = true` via Edit/Write
+ *
+ * The runner's transient bookkeeping (currentNodeId, history, loopCounters,
+ * pauseReason, etc.) lives separately in <project>/.ccweb/flow_state.json so
+ * the data file stays user-readable and version-controllable.
  */
-export type FileProvider = 'user' | 'llm' | 'system';
-/** Default destination for variables whose `file` is left blank in the
- *  editor. Lives under `.ccweb/` so it doesn't clutter the project root. */
-export declare const DEFAULT_VAR_FILE = ".ccweb/task_var.json";
-/** Flow-level shared variables. Defined at edit time; LLM nodes can mark a
- *  subset as "initialize here" (prompt augmentation), and system-logic
- *  branches can reference them by name (auto-resolve to file+field). */
+export declare const SCHEMA_VERSION: 2;
+/** Default location of the unified workflow data file. */
+export declare const WORKFLOW_DATA_PATH = ".ccweb/workflow_data.json";
+/** Immutable value declared at flow-definition time. Written into
+ *  workflow_data.constants[name] once at flow start; nodes can read it but
+ *  cannot overwrite it (validator forbids constants in writeVariables, etc.). */
+export interface FlowConstant {
+    /** Unique within the flow; shares a namespace with FlowVariable.name —
+     *  variables and constants must not collide. */
+    name: string;
+    /** Any JSON-serializable value: string / number / boolean / array / object. */
+    value: unknown;
+    description?: string;
+}
+/** Mutable value written at runtime by user-input or LLM nodes. */
 export interface FlowVariable {
-    /** Unique within a flow. Used as the JSON top-level field name in `file`. */
+    /** Unique within the flow (with constants). */
     name: string;
-    /** Relative path; UI defaults to DEFAULT_VAR_FILE when blank. */
-    file: string;
-    /** Human-readable meaning — injected into LLM prompt at init nodes so the
-     *  agent knows what value to derive. */
     description: string;
-}
-export interface UserInputField {
-    key: string;
-    label: string;
-    /** Phase-1 supports `text` (single line) and `textarea` (multi-line). */
-    type: 'text' | 'textarea';
-}
-export interface FileRef {
-    path: string;
-    provider: FileProvider;
-}
-export interface BranchRule {
-    /** Variable-mode (preferred): reference a flow variable by name; runner
-     *  resolves to its file + uses `name` as the JSON top-level field. */
-    variable?: string;
-    /** Field-mode (legacy): explicit JSON field on the node's first input
-     *  file. Kept for backward compat with pre-variable flow defs. */
-    field?: string;
-    equals: unknown;
-    goto: number;
+    /** Optional initial value written into workflow_data.variables[name] at
+     *  flow start. Without it, the variable starts as `undefined` (missing key). */
+    initialValue?: unknown;
 }
 export type NodeKind = 'user-input' | 'llm' | 'system-logic';
 interface NodeBase {
@@ -46,50 +45,82 @@ interface NodeBase {
     name: string;
     kind: NodeKind;
 }
+/** User-input form field. A field may be in exactly one of three modes —
+ *  read-write input, read-only variable display, or read-only constant display.
+ *  Validator enforces XOR. */
+export interface UserInputField {
+    key: string;
+    label: string;
+    type: 'text' | 'textarea';
+    /** Mode A: submitted value is merged into variables[name]. */
+    outputVariable?: string;
+    /** Mode B: render variables[name]'s current value, read-only. */
+    bindVariable?: string;
+    /** Mode C: render constants[name]'s value, read-only. */
+    bindConstant?: string;
+}
 export interface UserInputNode extends NodeBase {
     kind: 'user-input';
     userInputSchema: {
         fields: UserInputField[];
     };
-    outputs: FileRef[];
     next: number | null;
 }
 export interface LlmNode extends NodeBase {
     kind: 'llm';
-    inputs: FileRef[];
-    /** Template supports {{file:relpath}} substitution. */
+    /** Supports {{var:name}} and {{const:name}} interpolation. */
     promptTemplate: string;
-    outputs: FileRef[];
+    /** Variable names whose current values are prepended to the prompt as a
+     *  read-only "current values" context block. */
+    readVariables?: string[];
+    /** Constant names whose values are prepended to the prompt as a context
+     *  block. */
+    readConstants?: string[];
+    /** Variable names this node is asked to produce. A per-variable write
+     *  instruction is appended at the end of the prompt (description + target
+     *  path workflow_data.variables[name]). */
+    writeVariables?: string[];
+    /** Seconds to wait for `task_progress[N].finish = true` before pausing. */
     timeoutSec: number;
     next: number | null;
-    /** Names of flow variables this node should produce and write to disk.
-     *  Runner injects a per-variable init instruction at the end of the prompt
-     *  using the variable's description + file. */
-    initVariables?: string[];
+}
+/** Branch rule for system-logic nodes. Either `variable` or `constant`
+ *  must be set (XOR) — the runner reads workflow_data accordingly and
+ *  matches via loose equality. */
+export interface BranchRule {
+    variable?: string;
+    constant?: string;
+    equals: unknown;
+    goto: number;
 }
 export interface SystemLogicNode extends NodeBase {
     kind: 'system-logic';
-    inputs: FileRef[];
     branches: BranchRule[];
-    /** Loop-cap for backward goto edges. If exceeded → pause flow. */
+    /** Loop-cap for backward goto edges. */
     maxRetries: number;
     /** Where to go if no branch matches. null = terminal, otherwise nodeId. */
     defaultGoto?: number | null;
 }
 export type FlowNode = UserInputNode | LlmNode | SystemLogicNode;
 export interface FlowDef {
+    /** Schema version. Hard-break from v1; loader rejects anything but 2. */
+    schemaVersion: typeof SCHEMA_VERSION;
     id: string;
     name: string;
     description?: string;
     /** Node id of the first node to execute. */
     entryNodeId: number;
     nodes: FlowNode[];
-    /** Flow-level shared variables. Optional for backward compat with pre-
-     *  variables flow defs (treated as []). Names must be unique. */
+    /** Immutable values, initialized into workflow_data once. Optional → []. */
+    constants?: FlowConstant[];
+    /** Mutable values. Optional → []. */
     variables?: FlowVariable[];
 }
 export type RunStatus = 'running' | 'paused' | 'completed' | 'failed' | 'aborted';
-export type PauseReason = 'awaiting-user-input' | 'user-file-read-error' | 'llm-file-read-error' | 'timeout' | 'max-retries-exceeded' | 'user-paused' | null;
+/** Reduced pause reasons (vs v1): file-read-error variants are gone — v2
+ *  doesn't read user-supplied filesystem paths, so file-read failures are
+ *  impossible by construction. */
+export type PauseReason = 'awaiting-user-input' | 'timeout' | 'max-retries-exceeded' | 'user-paused' | null;
 export interface NodeHistoryEntry {
     nodeId: number;
     startedAt: number;
@@ -99,33 +130,47 @@ export interface NodeHistoryEntry {
 }
 export interface FlowState {
     flowId: string;
-    /** Disk filename of the flow def (under `.ccweb/flows/`). Persisted so the
-     *  frontend can re-fetch the FlowDef on page reload without an extra
-     *  list-then-match round-trip. */
     flowFilename: string;
     runId: string;
     startedAt: number;
     status: RunStatus;
     currentNodeId: number | null;
-    /** nodeId → number of times that backward edge was taken in this run. */
     loopCounters: Record<number, number>;
     history: NodeHistoryEntry[];
     pauseReason: PauseReason;
     pauseDetail?: string;
     /** When status='paused' and reason='awaiting-user-input', the schema to
-     *  show; cleared on submit. */
+     *  show. `contextValues` carries pre-read snapshot of bindVariable and
+     *  bindConstant referenced by the form so the frontend can render them
+     *  read-only without an extra fetch. */
     pendingUserInput?: {
         nodeId: number;
         fields: UserInputField[];
+        contextValues?: {
+            variables?: Record<string, unknown>;
+            constants?: Record<string, unknown>;
+        };
     };
 }
-export interface TaskTodoEntry {
-    id: number;
+export interface TaskProgressEntry {
+    /** Node id. Same id may repeat on loop re-entries — entries are append-only. */
+    nodeId: number;
     name: string;
     finish: boolean;
+    startedAt: number;
+    finishedAt?: number;
 }
-export interface TaskTodo {
-    tasks: TaskTodoEntry[];
+export interface WorkflowData {
+    /** Snapshot of FlowDef.constants. The runner writes this once at start and
+     *  never mutates it again. */
+    constants: Record<string, unknown>;
+    /** Mutable variables. Top-level key = variable name. Values are arbitrary
+     *  JSON. Missing keys = undefined (variable was never written). */
+    variables: Record<string, unknown>;
+    /** Append-only progress log. The runner appends an entry when an llm node
+     *  starts; the LLM flips `finish = true` to signal completion. The runner
+     *  watches this file (50ms debounce) for the current entry's finish. */
+    task_progress: TaskProgressEntry[];
 }
 export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/flows/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/flows/types.ts"],"names":[],"mappings":"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"}

package/backend/dist/flows/types.js

@@ -1,13 +1,25 @@
 "use strict";
 /**
- * Task-flow data model. Three persisted JSON files:
- *  - <project>/.ccweb/flows/<name>.json   — flow definition (design-time)
- *  - <project>/.ccweb/task_todo.json      — co-maintained progress (system + LLM)
- *  - <project>/.ccweb/flow_state.json     — runtime status (system-only)
+ * Task-flow data model (schemaVersion 2).
+ *
+ * All persistent data lives in a single file under each project:
+ *   <project>/.ccweb/workflow_data.json
+ *
+ * It holds three sections:
+ *   - constants:     immutable values declared in FlowDef.constants (initialized
+ *                    once at flow start; never written by user-input/LLM)
+ *   - variables:     mutable values written by user-input nodes and/or LLM nodes
+ *                    (read by any node, branched on by system-logic)
+ *   - task_progress: append-only progress log; the LLM signals node completion
+ *                    by flipping `task_progress[N].finish = true` via Edit/Write
+ *
+ * The runner's transient bookkeeping (currentNodeId, history, loopCounters,
+ * pauseReason, etc.) lives separately in <project>/.ccweb/flow_state.json so
+ * the data file stays user-readable and version-controllable.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_VAR_FILE = void 0;
-/** Default destination for variables whose `file` is left blank in the
- *  editor. Lives under `.ccweb/` so it doesn't clutter the project root. */
-exports.DEFAULT_VAR_FILE = '.ccweb/task_var.json';
+exports.WORKFLOW_DATA_PATH = exports.SCHEMA_VERSION = void 0;
+exports.SCHEMA_VERSION = 2;
+/** Default location of the unified workflow data file. */
+exports.WORKFLOW_DATA_PATH = '.ccweb/workflow_data.json';
 //# sourceMappingURL=types.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/flows/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH;4EAC4E;AAC/D,QAAA,gBAAgB,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/flows/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEU,QAAA,cAAc,GAAG,CAAU,CAAC;AAEzC,0DAA0D;AAC7C,QAAA,kBAAkB,GAAG,2BAA2B,CAAC"}

package/backend/dist/routes/flows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/routes/flows.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAK9C,QAAA,MAAM,MAAM,4CAAW,CAAC;AAexB,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,CAoH5D;AAoND,eAAe,MAAM,CAAC"}
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/routes/flows.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,QAAA,MAAM,MAAM,4CAAW,CAAC;AAqBxB,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,CA6M5D;AAyJD,eAAe,MAAM,CAAC"}