pi-taskflow 0.0.11 → 0.0.13

package/extensions/store.ts

@@ -40,6 +40,10 @@ export interface PhaseState {
 	model?: string;
 	error?: string;
 	inputHash?: string;
+	/** When this result was served from cache: 'cross-run' for the persistent
+	 *  cross-run store. (Within-run resume reuses prior state verbatim and is not
+	 *  flagged here.) */
+	cacheHit?: "cross-run";
 	startedAt?: number;
 	endedAt?: number;
 	/** Live fan-out progress for map/parallel phases. */
@@ -54,6 +58,10 @@ export interface PhaseState {
 	budgetTruncated?: boolean;
 	/** Human-in-the-loop outcome (approval phases only). */
 	approval?: { decision: "approve" | "reject" | "edit"; note?: string; auto?: boolean };
+	/** Loop iteration accounting (loop phases only). */
+	loop?: { iterations: number; stop: "until" | "converged" | "maxIterations" | "failed" };
+	/** Tournament outcome (tournament phases only). */
+	tournament?: { variants: number; winner: number; mode: "best" | "aggregate"; reason?: string };
 	/** Non-fatal diagnostic warnings accumulated during this phase (e.g.
 	 *  unresolved interpolation placeholders, suspicious templates). */
 	warnings?: string[];
@@ -249,7 +257,7 @@ function releaseLock(lockPath: string): void {
 /**
  * Execute `fn` while holding a file lock.  Guarantees release even on throw.
  */
-function withLock<T>(lockPath: string, fn: () => T): T {
+export function withLock<T>(lockPath: string, fn: () => T): T {
 	acquireLock(lockPath);
 	try {
 		return fn();
@@ -560,6 +568,12 @@ function runsDir(cwd: string): string {
 	return path.join(projDir, "runs");
 }
 
+/** Root dir for the cross-run memoization cache (sibling of `runs`). */
+export function cacheDir(cwd: string): string {
+	const projDir = findProjectFlowsDir(cwd, true)!;
+	return path.join(projDir, "cache");
+}
+
 export function newRunId(flowName: string): string {
 	const safe = flowName.replace(/[^\w.-]+/g, "_").slice(0, 24);
 	return `${safe}-${Date.now().toString(36)}-${crypto.randomBytes(3).toString("hex")}`;
@@ -743,7 +757,7 @@ export function hashInput(...parts: string[]): string {
  * then rename over the target (rename is atomic on the same filesystem). Prevents
  * a crash or concurrent write from leaving a half-written, corrupt JSON file.
  */
-function writeFileAtomic(filePath: string, data: string): void {
+export function writeFileAtomic(filePath: string, data: string): void {
 	// Ensure parent directory exists.
 	fs.mkdirSync(path.dirname(filePath), { recursive: true });
 	const tmp = `${filePath}.${process.pid}.${crypto.randomBytes(4).toString("hex")}.tmp`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-taskflow",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Lightweight workflow orchestration for the Pi coding agent — declarative multi-phase taskflows with dynamic fan-out, isolated subagent context, resumable runs, and saveable commands.",
   "keywords": [
     "pi-package",
@@ -36,8 +36,9 @@
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "test": "node --experimental-strip-types --test test/interpolate.test.ts test/condition.test.ts test/schema.test.ts test/usage.test.ts test/runtime.test.ts test/features.test.ts test/runner.test.ts test/store.test.ts test/agents.test.ts test/render.test.ts test/desugar.test.ts",
-    "test:e2e": "PI_TASKFLOW_PI_BIN=pi node --experimental-strip-types test/e2e.mts"
+    "test": "PI_TASKFLOW_BUILTIN_AGENTS_DIR= node --experimental-strip-types --test test/interpolate.test.ts test/condition.test.ts test/schema.test.ts test/usage.test.ts test/runtime.test.ts test/features.test.ts test/runner.test.ts test/store.test.ts test/agents.test.ts test/init.test.ts test/render.test.ts test/desugar.test.ts test/cache.test.ts test/loop.test.ts test/tournament.test.ts",
+    "test:e2e": "PI_TASKFLOW_PI_BIN=pi node --experimental-strip-types test/e2e.mts",
+    "test:dogfood-cache": "node --experimental-strip-types test/dogfood-cache.mts"
   },
   "pi": {
     "extensions": [