@llm4ts/flow 0.1.0

package/dist/Mermaid.js

@@ -0,0 +1,98 @@
+import { StageCompleted, StageFailed, StageStarted } from "./FlowEvents.js";
+const escapeLabel = (label) => label.replaceAll('"', "'");
+export const renderMermaid = (events) => {
+    const starts = events
+        .filter((event) => event._tag === "StageStarted")
+        .map((event) => event.stage);
+    const failed = new Set(events
+        .filter((event) => event._tag === "StageFailed")
+        .map((event) => event.stage));
+    if (starts.length === 0) {
+        return 'flowchart TD\n  none["(no stages)"]';
+    }
+    const order = [...new Set(starts)];
+    const counts = new Map();
+    for (const stage of starts) {
+        counts.set(stage, (counts.get(stage) ?? 0) + 1);
+    }
+    const ids = new Map();
+    order.forEach((name, index) => ids.set(name, `n${index}`));
+    const nodes = order.map((name) => {
+        const count = counts.get(name) ?? 1;
+        const label = count > 1 ? `${name} ×${count}` : name;
+        return `  ${ids.get(name)}["${escapeLabel(label)}"]${failed.has(name) ? ":::failed" : ""}`;
+    });
+    const edges = order
+        .slice(1)
+        .map((name, index) => `  ${ids.get(order[index] ?? "")} --> ${ids.get(name)}`);
+    const styles = failed.size === 0 ? [] : ["  classDef failed fill:#fdd,stroke:#c00,color:#900;"];
+    return ["flowchart TD", ...nodes, ...edges, ...styles].join("\n");
+};
+const traceStage = (line) => {
+    const field = (key) => {
+        const direct = line.fields[key];
+        if (typeof direct === "string") {
+            return direct;
+        }
+        const encoded = line.fields.event;
+        if (typeof encoded !== "string") {
+            return undefined;
+        }
+        try {
+            const event = JSON.parse(encoded);
+            if (typeof event !== "object" || event === null) {
+                return undefined;
+            }
+            const value = Reflect.get(event, key);
+            return typeof value === "string" ? value : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    switch (line.kind) {
+        case "StageStarted": {
+            const stage = field("stage");
+            return stage === undefined ? undefined : StageStarted.make({ stage });
+        }
+        case "StageCompleted": {
+            const stage = field("stage");
+            return stage === undefined ? undefined : StageCompleted.make({ stage });
+        }
+        case "StageFailed": {
+            const stage = field("stage");
+            return stage === undefined
+                ? undefined
+                : StageFailed.make({ stage, message: field("message") ?? "" });
+        }
+        default:
+            return undefined;
+    }
+};
+export const renderMermaidTrace = (lines) => renderMermaid(lines.flatMap((line) => {
+    const event = traceStage(line);
+    return event === undefined ? [] : [event];
+}));
+const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+const base64Url = (value) => {
+    const bytes = new TextEncoder().encode(value);
+    let encoded = "";
+    for (let index = 0; index < bytes.length; index += 3) {
+        const first = bytes[index] ?? 0;
+        const second = bytes[index + 1];
+        const third = bytes[index + 2];
+        const block = (first << 16) | ((second ?? 0) << 8) | (third ?? 0);
+        encoded += alphabet[(block >> 18) & 63];
+        encoded += alphabet[(block >> 12) & 63];
+        if (second !== undefined) {
+            encoded += alphabet[(block >> 6) & 63];
+        }
+        if (third !== undefined) {
+            encoded += alphabet[block & 63];
+        }
+    }
+    return encoded;
+};
+export const mermaidLiveUrl = (diagram) => `https://mermaid.ink/svg/${base64Url(diagram)}`;
+export const mermaidDocument = (diagram) => `\`\`\`mermaid\n${diagram}\n\`\`\`\n\n[View on mermaid.ink](${mermaidLiveUrl(diagram)})\n`;
+//# sourceMappingURL=Mermaid.js.map

package/dist/Mermaid.js.map

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

package/dist/Pack.d.ts

@@ -0,0 +1,40 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { Dimension } from "@llm4ts/core/eval/Eval";
+import { PlanParseError } from "./FlowError.ts";
+import { type Reviewer } from "./Reviewer.ts";
+import { CoverageRule } from "./SpecChecks.ts";
+import type { WorkspaceError, WorkspaceShape } from "./Workspace.ts";
+export { Reviewer, parseReviewer } from "./Reviewer.ts";
+export declare const ComparisonOrdering: Schema.Literals<readonly ["Ordered", "Unordered", "PerKey"]>;
+export type ComparisonOrdering = typeof ComparisonOrdering.Type;
+declare const ComparisonPolicy_base: Schema.Class<ComparisonPolicy, Schema.Struct<{
+    readonly ordering: Schema.Literals<readonly ["Ordered", "Unordered", "PerKey"]>;
+    readonly ignore: Schema.$ReadonlySet<Schema.String>;
+}>, {}>;
+export declare class ComparisonPolicy extends ComparisonPolicy_base {
+}
+export interface Pack {
+    readonly name: string;
+    readonly source: string;
+    readonly scaffold: string | undefined;
+    readonly sources: string | undefined;
+    readonly programs: string | undefined;
+    readonly specsDir: string;
+    readonly featuresDir: string;
+    readonly gates: Readonly<Record<string, ReadonlyArray<string>>>;
+    readonly replay: ReadonlyArray<string> | undefined;
+    readonly equivalence: ComparisonPolicy;
+    readonly judgeDimensions: ReadonlyArray<Dimension>;
+    readonly coverage: ReadonlyArray<CoverageRule>;
+    readonly survey: ReadonlyArray<CoverageRule>;
+    readonly prompts: Readonly<Record<string, string>>;
+    readonly lenses: ReadonlyArray<Reviewer>;
+    readonly lessons: string | undefined;
+    readonly dir: string;
+    readonly gate: (name: string) => ReadonlyArray<string> | undefined;
+    readonly prompt: (name: string) => string | undefined;
+}
+export declare const loadPack: (workspace: WorkspaceShape, directory: string) => Effect.Effect<Pack, PlanParseError | WorkspaceError, never>;
+export declare const appendPackLesson: (workspace: WorkspaceShape, directory: string, lesson: string) => Effect.Effect<void, WorkspaceError>;
+//# sourceMappingURL=Pack.d.ts.map

package/dist/Pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pack.d.ts","sourceRoot":"","sources":["../src/Pack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAEvD,eAAO,MAAM,kBAAkB,8DAAsD,CAAA;AACrF,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;;;;;AAE/D,qBAAa,gBAAiB,SAAQ,qBAGpC;CAAG;AAEL,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAC/D,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;IAClD,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAA;IACtC,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;IAC9C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;IAClE,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CACtD;AA+GD,eAAO,MAAM,QAAQ,+GAwDnB,CAAA;AAEF,eAAO,MAAM,gBAAgB,GAC3B,WAAW,cAAc,EACzB,WAAW,MAAM,EACjB,QAAQ,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CACgC,CAAA"}

package/dist/Pack.js

@@ -0,0 +1,141 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { Dimension } from "@llm4ts/core/eval/Eval";
+import { PlanParseError } from "./FlowError.js";
+import { parseReviewer } from "./Reviewer.js";
+import { CoverageRule } from "./SpecChecks.js";
+export { Reviewer, parseReviewer } from "./Reviewer.js";
+export const ComparisonOrdering = Schema.Literals(["Ordered", "Unordered", "PerKey"]);
+export class ComparisonPolicy extends Schema.Class("ComparisonPolicy")({
+    ordering: ComparisonOrdering,
+    ignore: Schema.ReadonlySet(Schema.String)
+}) {
+}
+const parseManifest = (markdown) => {
+    const chunks = markdown
+        .trim()
+        .split(/^(?=## )/m)
+        .map((chunk) => chunk.trim())
+        .filter((chunk) => chunk.length > 0);
+    const head = chunks[0];
+    const prefix = "# Pack: ";
+    if (head === undefined || !head.startsWith(prefix)) {
+        return Effect.fail(PlanParseError.make({
+            message: `expected a '${prefix}<name>' header`
+        }));
+    }
+    const lines = head.split(/\r?\n/);
+    const fields = Object.fromEntries(lines.slice(1).flatMap((line) => {
+        const index = line.indexOf(":");
+        return index < 0 || line.trim().startsWith("#") || line.trim().startsWith("-")
+            ? []
+            : [[line.slice(0, index).trim(), line.slice(index + 1).trim()]];
+    }));
+    return fields.source === undefined
+        ? Effect.fail(PlanParseError.make({
+            message: "pack manifest is missing a 'source:' field"
+        }))
+        : Effect.succeed({
+            name: lines[0]?.slice(prefix.length).trim() ?? "",
+            fields,
+            sections: chunks.slice(1)
+        });
+};
+const section = (sections, title) => sections
+    .find((candidate) => candidate.split(/\r?\n/)[0]?.trim() === `## ${title}`)
+    ?.split(/\r?\n/)
+    .slice(1)
+    .join("\n")
+    .trim();
+const namedItems = (body) => Object.fromEntries((body ?? "").split(/\r?\n/).flatMap((line) => {
+    const match = /^- ([^:]+): (.+)$/.exec(line);
+    return match?.[1] === undefined || match[2] === undefined
+        ? []
+        : [[match[1].trim(), match[2].trim()]];
+}));
+const rules = (sections, prefix) => sections.flatMap((candidate) => {
+    const lines = candidate.split(/\r?\n/);
+    const heading = lines[0]?.trim() ?? "";
+    if (!heading.startsWith(prefix)) {
+        return [];
+    }
+    const fields = Object.fromEntries(lines.slice(1).flatMap((line) => {
+        const index = line.indexOf(":");
+        return index < 0 ? [] : [[line.slice(0, index).trim(), line.slice(index + 1).trim()]];
+    }));
+    return fields.files === undefined || fields.unit === undefined
+        ? []
+        : [
+            CoverageRule.make({
+                name: heading.slice(prefix.length).trim(),
+                files: fields.files,
+                unit: fields.unit
+            })
+        ];
+});
+const dimensions = (body) => (body ?? "").split(/\r?\n/).flatMap((line) => {
+    const match = /^- ([^(]+)\(0\.\.(\d+)\): (.+)$/.exec(line);
+    const name = match?.[1]?.trim();
+    const maxScore = Number.parseInt(match?.[2] ?? "", 10);
+    const rubric = match?.[3]?.trim();
+    return name === undefined || rubric === undefined || !Number.isInteger(maxScore)
+        ? []
+        : [Dimension.make({ name, rubric, maxScore })];
+});
+const markdownSidecars = Effect.fn("@llm4ts/flow/Pack.markdownSidecars")(function* (workspace, directory) {
+    const paths = yield* workspace.discover(`${directory}/*.md`);
+    const entries = [];
+    for (const path of paths) {
+        const file = path.split("/").at(-1) ?? path;
+        entries.push([file.replace(/\.md$/, ""), (yield* workspace.read(path)).trim()]);
+    }
+    return Object.fromEntries(entries);
+});
+export const loadPack = Effect.fn("@llm4ts/flow/Pack.load")(function* (workspace, directory) {
+    const manifest = yield* parseManifest(yield* workspace.read(`${directory}/pack.md`));
+    const prompts = yield* markdownSidecars(workspace, `${directory}/prompts`);
+    const lensFiles = yield* markdownSidecars(workspace, `${directory}/reviewers`);
+    const lessons = yield* workspace.read(`${directory}/lessons.md`).pipe(Effect.map((text) => text.trim()), Effect.catch(() => Effect.succeed(undefined)));
+    const gateValues = namedItems(section(manifest.sections, "Gates"));
+    const equivalenceValues = namedItems(section(manifest.sections, "Equivalence"));
+    const ordering = equivalenceValues.ordering?.toLowerCase() === "unordered"
+        ? "Unordered"
+        : equivalenceValues.ordering?.toLowerCase() === "per-key"
+            ? "PerKey"
+            : "Ordered";
+    const gates = Object.fromEntries(Object.entries(gateValues).map(([name, command]) => [name, command.split(/\s+/)]));
+    const lenses = Object.entries(lensFiles)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([name, text]) => parseReviewer(name, text));
+    const fields = manifest.fields;
+    const pack = {
+        name: manifest.name,
+        source: fields.source ?? "",
+        scaffold: fields.scaffold,
+        sources: fields.sources,
+        programs: fields.programs,
+        specsDir: fields["specs-dir"] ?? "docs/specs",
+        featuresDir: fields["features-dir"] ?? "features",
+        gates,
+        replay: fields.replay?.split(/\s+/),
+        equivalence: ComparisonPolicy.make({
+            ordering,
+            ignore: new Set((equivalenceValues.ignore ?? "")
+                .split(",")
+                .map((item) => item.trim())
+                .filter((item) => item.length > 0))
+        }),
+        judgeDimensions: dimensions(section(manifest.sections, "Judge")),
+        coverage: rules(manifest.sections, "## Coverage: "),
+        survey: rules(manifest.sections, "## Survey: "),
+        prompts,
+        lenses,
+        lessons: lessons === undefined || lessons.length === 0 ? undefined : lessons,
+        dir: directory,
+        gate: (name) => gates[name],
+        prompt: (name) => prompts[name]
+    };
+    return pack;
+});
+export const appendPackLesson = (workspace, directory, lesson) => workspace.append(`${directory}/lessons.md`, `- ${lesson.trim()}\n`);
+//# sourceMappingURL=Pack.js.map

package/dist/Pack.js.map

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

package/dist/Package.d.ts

@@ -0,0 +1,2 @@
+export declare const packageName = "@llm4ts/flow";
+//# sourceMappingURL=Package.d.ts.map

package/dist/Package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Package.d.ts","sourceRoot":"","sources":["../src/Package.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,iBAAiB,CAAA"}

package/dist/Package.js

@@ -0,0 +1,2 @@
+export const packageName = "@llm4ts/flow";
+//# sourceMappingURL=Package.js.map

package/dist/Package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Package.js","sourceRoot":"","sources":["../src/Package.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAA"}

package/dist/Persistence.d.ts

@@ -0,0 +1,32 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { PersistenceError, PlanParseError, UnsupportedSchemaVersion } from "./FlowError.ts";
+import type { Plan } from "./Plan.ts";
+export interface PlainFileStoreShape {
+    readonly read: (path: string) => Effect.Effect<string | undefined, PersistenceError>;
+    readonly writeAtomic: (path: string, contents: string) => Effect.Effect<void, PersistenceError>;
+    readonly append: (path: string, contents: string) => Effect.Effect<void, PersistenceError>;
+    readonly remove: (path: string) => Effect.Effect<void, PersistenceError>;
+    readonly hashSha256: (path: string) => Effect.Effect<string, PersistenceError>;
+}
+declare const PlainFileStore_base: Context.ServiceClass<PlainFileStore, "@llm4ts/flow/PlainFileStore", PlainFileStoreShape>;
+export declare class PlainFileStore extends PlainFileStore_base {
+}
+export interface MemoryPlainFileStore {
+    readonly store: PlainFileStoreShape;
+    readonly files: Effect.Effect<Readonly<Record<string, string>>>;
+    readonly replace: (files: Readonly<Record<string, string>>) => Effect.Effect<void>;
+}
+export declare const makeMemoryPlainFileStore: (initial?: Readonly<Record<string, string>>) => Effect.Effect<MemoryPlainFileStore>;
+export interface PlanStoreShape {
+    readonly save: (path: string, plan: Plan) => Effect.Effect<void, PersistenceError>;
+    readonly load: (path: string) => Effect.Effect<Plan | undefined, PersistenceError | PlanParseError>;
+    readonly remove: (path: string) => Effect.Effect<void, PersistenceError>;
+    readonly recoverOrCreate: <E, R>(path: string, create: Effect.Effect<Plan, E, R>) => Effect.Effect<Plan, E | PersistenceError | PlanParseError, R>;
+}
+export declare const makePlanStore: (files: PlainFileStoreShape) => PlanStoreShape;
+export declare const saveVersioned: <A, E, RD, RE>(files: PlainFileStoreShape, path: string, schemaVersion: number, schema: Schema.ConstraintCodec<A, E, RD, RE>, value: A) => Effect.Effect<void, PersistenceError | PlanParseError | UnsupportedSchemaVersion | import("./FlowError.ts").WorkspacePathError | import("./FlowError.ts").WorkspaceLimitError | import("./FlowError.ts").WorkspaceIoError | import("./FlowError.ts").FlowAborted | import("./FlowError.ts").ProcessError | import("./FlowError.ts").FlowLlmError | import("./FlowError.ts").FlowCapabilityDenied | import("./FlowError.ts").BudgetExceeded, RE>;
+export declare const loadVersioned: <A, E, RD, RE>(files: PlainFileStoreShape, path: string, expectedVersion: number, schema: Schema.ConstraintCodec<A, E, RD, RE>) => Effect.Effect<A | undefined, PersistenceError | PlanParseError | UnsupportedSchemaVersion | import("./FlowError.ts").WorkspacePathError | import("./FlowError.ts").WorkspaceLimitError | import("./FlowError.ts").WorkspaceIoError | import("./FlowError.ts").FlowAborted | import("./FlowError.ts").ProcessError | import("./FlowError.ts").FlowLlmError | import("./FlowError.ts").FlowCapabilityDenied | import("./FlowError.ts").BudgetExceeded, RD>;
+export {};
+//# sourceMappingURL=Persistence.d.ts.map

package/dist/Persistence.d.ts.map

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

package/dist/Persistence.js

@@ -0,0 +1,85 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import { PersistenceError, PlanParseError, UnsupportedSchemaVersion } from "./FlowError.js";
+import { parsePlan } from "./Plan.js";
+export class PlainFileStore extends Context.Service()("@llm4ts/flow/PlainFileStore") {
+}
+const hexDigest = (buffer) => Array.from(new Uint8Array(buffer))
+    .map((byte) => byte.toString(16).padStart(2, "0"))
+    .join("");
+const sha256Hex = (path, contents) => Effect.tryPromise({
+    try: async () => hexDigest(await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(contents))),
+    catch: (error) => PersistenceError.make({
+        message: `failed to hash ${path}: ${error instanceof Error ? error.message : String(error)}`,
+        cause: error
+    })
+});
+export const makeMemoryPlainFileStore = (initial = {}) => Ref.make(initial).pipe(Effect.map((state) => {
+    const store = {
+        read: (path) => Ref.get(state).pipe(Effect.map((files) => files[path])),
+        writeAtomic: (path, contents) => Ref.update(state, (files) => ({ ...files, [path]: contents })),
+        append: (path, contents) => Ref.update(state, (files) => ({
+            ...files,
+            [path]: `${files[path] ?? ""}${contents}`
+        })),
+        remove: (path) => Ref.update(state, (files) => Object.fromEntries(Object.entries(files).filter(([candidate]) => candidate !== path))),
+        hashSha256: (path) => Ref.get(state).pipe(Effect.flatMap((files) => {
+            const contents = files[path];
+            return contents === undefined
+                ? Effect.fail(PersistenceError.make({
+                    message: `failed to hash ${path}: file does not exist`
+                }))
+                : sha256Hex(path, contents);
+        }))
+    };
+    return {
+        store,
+        files: Ref.get(state),
+        replace: (files) => Ref.set(state, files)
+    };
+}));
+export const makePlanStore = (files) => {
+    const save = (path, plan) => files.writeAtomic(path, plan.render);
+    const load = (path) => Effect.flatMap(files.read(path), (contents) => contents === undefined
+        ? Effect.succeed(undefined)
+        : parsePlan(contents).pipe(Effect.map((plan) => plan)));
+    const recoverOrCreate = (path, create) => Effect.flatMap(load(path), (stored) => stored === undefined ? Effect.tap(create, (plan) => save(path, plan)) : Effect.succeed(stored));
+    return {
+        save,
+        load,
+        remove: files.remove,
+        recoverOrCreate
+    };
+};
+const VersionedEnvelope = Schema.Struct({
+    schemaVersion: Schema.Int,
+    value: Schema.Unknown
+});
+export const saveVersioned = Effect.fn("@llm4ts/flow/Persistence.saveVersioned")(function* (files, path, schemaVersion, schema, value) {
+    const encoded = yield* Schema.encodeEffect(schema)(value).pipe(Effect.mapError((error) => PlanParseError.make({
+        message: `failed to encode versioned document ${path}: ${String(error)}`
+    })));
+    yield* files.writeAtomic(path, `${JSON.stringify({ schemaVersion, value: encoded }, undefined, 2)}\n`);
+});
+export const loadVersioned = Effect.fn("@llm4ts/flow/Persistence.loadVersioned")(function* (files, path, expectedVersion, schema) {
+    const contents = yield* files.read(path);
+    if (contents === undefined) {
+        return undefined;
+    }
+    const envelope = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(VersionedEnvelope))(contents).pipe(Effect.mapError((error) => PlanParseError.make({
+        message: `malformed versioned document ${path}: ${String(error)}`
+    })));
+    if (envelope.schemaVersion !== expectedVersion) {
+        return yield* UnsupportedSchemaVersion.make({
+            path,
+            expected: expectedVersion,
+            actual: envelope.schemaVersion
+        });
+    }
+    return yield* Schema.decodeUnknownEffect(schema)(envelope.value).pipe(Effect.mapError((error) => PlanParseError.make({
+        message: `invalid versioned document ${path}: ${String(error)}`
+    })));
+});
+//# sourceMappingURL=Persistence.js.map

package/dist/Persistence.js.map

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

package/dist/Plan.d.ts

@@ -0,0 +1,26 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { PlanParseError } from "./FlowError.ts";
+declare const Task_base: Schema.Class<Task, Schema.Struct<{
+    readonly title: Schema.String;
+    readonly description: Schema.String;
+    readonly completed: Schema.withConstructorDefault<Schema.Boolean>;
+}>, {}>;
+export declare class Task extends Task_base {
+}
+declare const Plan_base: Schema.Class<Plan, Schema.Struct<{
+    readonly epicId: Schema.String;
+    readonly tasks: Schema.$Array<typeof Task>;
+    readonly brief: Schema.optionalKey<Schema.String>;
+}>, {}>;
+export declare class Plan extends Plan_base {
+    get nextIncomplete(): Task | undefined;
+    complete(title: string): Plan;
+    taskPrompt(task: Task): string;
+    get render(): string;
+}
+export declare const stableHash: (input: string) => string;
+export declare const defaultPlanPath: (prompt: string, directory?: string) => string;
+export declare const parsePlan: (markdown: string) => Effect.Effect<Plan, PlanParseError, never>;
+export {};
+//# sourceMappingURL=Plan.d.ts.map

package/dist/Plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plan.d.ts","sourceRoot":"","sources":["../src/Plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;;;;;;AAE/C,qBAAa,IAAK,SAAQ,SAIxB;CAAG;;;;;;AAEL,qBAAa,IAAK,SAAQ,SAIxB;IACA,IAAI,cAAc,IAAI,IAAI,GAAG,SAAS,CAErC;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS7B,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAO9B,IAAI,MAAM,IAAI,MAAM,CAQnB;CACF;AAED,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAO1C,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,EAAE,kBAAqB,KAAG,MAC1B,CAAA;AAoC9C,eAAO,MAAM,SAAS,kEA0BpB,CAAA"}

package/dist/Plan.js

@@ -0,0 +1,101 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { PlanParseError } from "./FlowError.js";
+export class Task extends Schema.Class("Task")({
+    title: Schema.String,
+    description: Schema.String,
+    completed: Schema.Boolean.pipe(Schema.withConstructorDefault(Effect.succeed(false)))
+}) {
+}
+export class Plan extends Schema.Class("Plan")({
+    epicId: Schema.String,
+    tasks: Schema.Array(Task),
+    brief: Schema.optionalKey(Schema.String)
+}) {
+    get nextIncomplete() {
+        return this.tasks.find((task) => !task.completed);
+    }
+    complete(title) {
+        return new Plan({
+            ...this,
+            tasks: this.tasks.map((task) => task.title === title ? new Task({ ...task, completed: true }) : task)
+        });
+    }
+    taskPrompt(task) {
+        const brief = this.brief?.trim();
+        return brief === undefined || brief.length === 0
+            ? task.description
+            : `${brief}\n\n---\n\n${task.description}`;
+    }
+    get render() {
+        const blocks = this.tasks.map((task) => {
+            const box = task.completed ? "[x]" : "[ ]";
+            return `## ${box} ${task.title}\n${task.description}`.trimEnd();
+        });
+        const core = [`# Plan: ${this.epicId}`, ...blocks].join("\n\n");
+        const brief = this.brief?.trim();
+        return brief === undefined || brief.length === 0 ? core : `${core}\n\n# Brief\n\n${brief}`;
+    }
+}
+export const stableHash = (input) => {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < input.length; index += 1) {
+        hash ^= input.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16);
+};
+export const defaultPlanPath = (prompt, directory = ".llm4ts") => `${directory}/plan-${stableHash(prompt)}.md`;
+const parseTask = (chunk) => {
+    const lines = chunk.split("\n");
+    const head = lines[0] ?? "";
+    const match = /^## \[([ xX])\] (.+)$/.exec(head);
+    const marker = match?.[1];
+    const title = match?.[2]?.trim();
+    return marker === undefined || title === undefined
+        ? Effect.fail(PlanParseError.make({
+            message: head.length === 0 ? "empty task chunk" : `malformed task header: ${head}`
+        }))
+        : Effect.succeed(Task.make({
+            title,
+            description: lines.slice(1).join("\n").trim(),
+            completed: marker.toLowerCase() === "x"
+        }));
+};
+const splitBrief = (body) => {
+    const lines = body.split("\n");
+    const index = lines.findIndex((line) => line.trim() === "# Brief");
+    if (index < 0) {
+        return [body.trim(), undefined];
+    }
+    const brief = lines
+        .slice(index + 1)
+        .join("\n")
+        .trim();
+    return [lines.slice(0, index).join("\n").trim(), brief.length === 0 ? undefined : brief];
+};
+export const parsePlan = Effect.fn("@llm4ts/flow/Plan.parse")(function* (markdown) {
+    const stripped = markdown.trim();
+    const lines = stripped.split("\n");
+    const header = lines[0] ?? "";
+    const prefix = "# Plan: ";
+    if (!header.startsWith(prefix)) {
+        return yield* PlanParseError.make({
+            message: `expected a '${prefix}<epicId>' header`
+        });
+    }
+    const [taskBody, brief] = splitBrief(lines.slice(1).join("\n").trim());
+    const chunks = taskBody.length === 0
+        ? []
+        : taskBody
+            .split(/^(?=## )/m)
+            .map((chunk) => chunk.trim())
+            .filter((chunk) => chunk.length > 0);
+    const tasks = yield* Effect.forEach(chunks, parseTask);
+    return Plan.make({
+        epicId: header.slice(prefix.length).trim(),
+        tasks,
+        ...(brief === undefined ? {} : { brief })
+    });
+});
+//# sourceMappingURL=Plan.js.map

package/dist/Plan.js.map

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

package/dist/PlanExecution.d.ts

@@ -0,0 +1,7 @@
+import * as Effect from "effect/Effect";
+import { type FlowEventsShape } from "./FlowEvents.ts";
+import type { Plan, Task } from "./Plan.ts";
+import type { PlanStoreShape } from "./Persistence.ts";
+export declare const stage: <A, E, R>(events: FlowEventsShape, name: string, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+export declare const implementTaskLoop: <E, R>(store: PlanStoreShape, events: FlowEventsShape, planPath: string, plan: Plan, perTask: (task: Task) => Effect.Effect<void, E, R>) => Effect.Effect<Plan, import("./FlowError.ts").PersistenceError | import("./FlowError.ts").PlanParseError | import("./FlowError.ts").UnsupportedSchemaVersion | import("./FlowError.ts").WorkspacePathError | import("./FlowError.ts").WorkspaceLimitError | import("./FlowError.ts").WorkspaceIoError | import("./FlowError.ts").FlowAborted | import("./FlowError.ts").ProcessError | import("./FlowError.ts").FlowLlmError | import("./FlowError.ts").FlowCapabilityDenied | import("./FlowError.ts").BudgetExceeded | E, R>;
+//# sourceMappingURL=PlanExecution.d.ts.map

package/dist/PlanExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanExecution.d.ts","sourceRoot":"","sources":["../src/PlanExecution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAA6C,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjG,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAKtD,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAC3B,QAAQ,eAAe,EACvB,MAAM,MAAM,EACZ,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAYrB,CAAA;AAEH,eAAO,MAAM,iBAAiB,GACjB,CAAC,EAAE,CAAC,gGAKG,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,kgBAYrD,CAAA"}