@keel_flow/build-mode 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jglasskatz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/approve.d.ts

@@ -0,0 +1,14 @@
+import type { Build } from "@keel_flow/schema";
+export interface RecordApprovalOptions {
+    approvedBy?: string;
+}
+export declare function readSummary(slug: string, cwd: string): Promise<string>;
+export declare function recordApproval(slug: string, opts: RecordApprovalOptions, cwd: string): Promise<Build>;
+export declare function recordRejection(slug: string, reason: string, cwd: string): Promise<Build>;
+export interface SummaryHashCheckResult {
+    matches: boolean;
+    expected: string;
+    actual: string;
+}
+export declare function checkSummaryHash(slug: string, cwd: string): Promise<SummaryHashCheckResult>;
+//# sourceMappingURL=approve.d.ts.map

package/dist/approve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../src/approve.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5E;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,qBAAqB,EAC3B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC,CAsBhB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC,CAahB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,sBAAsB,CAAC,CAMjC"}

package/dist/approve.js

@@ -0,0 +1,51 @@
+import { promises as fs } from "node:fs";
+import { existsSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { getBuildPaths, loadBuild, saveBuild, transitionTo } from "./state.js";
+import { appendConversation } from "./draft.js";
+function sha256(s) {
+    return createHash("sha256").update(s, "utf-8").digest("hex");
+}
+export async function readSummary(slug, cwd) {
+    const paths = getBuildPaths(slug, cwd);
+    if (!existsSync(paths.summary)) {
+        throw new Error(`No summary.md found for build ${slug}; run distillation first`);
+    }
+    return fs.readFile(paths.summary, "utf-8");
+}
+export async function recordApproval(slug, opts, cwd) {
+    const build = await loadBuild(slug, cwd);
+    if (build.state !== "awaiting-approval") {
+        throw new Error(`Cannot approve build in state ${build.state} (slug=${slug}); summary must be awaiting-approval`);
+    }
+    const summary = await readSummary(slug, cwd);
+    const summaryHash = sha256(summary);
+    const approved = transitionTo(build, "approved");
+    approved.approvedAt = new Date().toISOString();
+    approved.approvedSummaryHash = summaryHash;
+    if (opts.approvedBy) {
+        await appendConversation(slug, "system", `Approved by ${opts.approvedBy} at ${approved.approvedAt}`, cwd);
+    }
+    await saveBuild(approved, cwd);
+    return approved;
+}
+export async function recordRejection(slug, reason, cwd) {
+    const build = await loadBuild(slug, cwd);
+    if (build.state !== "awaiting-approval") {
+        throw new Error(`Cannot reject build in state ${build.state} (slug=${slug}); only awaiting-approval is rejectable`);
+    }
+    await appendConversation(slug, "rejection", reason, cwd);
+    const rejected = transitionTo(build, "rejected");
+    await saveBuild(rejected, cwd);
+    const backToDrafting = transitionTo(rejected, "drafting");
+    await saveBuild(backToDrafting, cwd);
+    return backToDrafting;
+}
+export async function checkSummaryHash(slug, cwd) {
+    const build = await loadBuild(slug, cwd);
+    const expected = build.approvedSummaryHash ?? "";
+    const summary = await readSummary(slug, cwd);
+    const actual = sha256(summary);
+    return { matches: expected === actual, expected, actual };
+}
+//# sourceMappingURL=approve.js.map

package/dist/approve.js.map

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

package/dist/codify.d.ts

@@ -0,0 +1,21 @@
+import type { ModelProvider } from "@keel_flow/runtime";
+import type { TelemetryEmitter } from "@keel_flow/telemetry";
+export declare class SummaryDriftError extends Error {
+    readonly expected: string;
+    readonly actual: string;
+    constructor(expected: string, actual: string);
+}
+export interface CodifyOptions {
+    slug: string;
+    cwd: string;
+    provider: ModelProvider;
+    model?: string;
+    telemetry?: TelemetryEmitter;
+    parentSessionId?: string;
+}
+export interface CodifyResult {
+    specPath: string;
+    spec: string;
+}
+export declare function codifySpec(opts: CodifyOptions): Promise<CodifyResult>;
+//# sourceMappingURL=codify.d.ts.map

package/dist/codify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codify.d.ts","sourceRoot":"","sources":["../src/codify.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAS7D,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAS7C;AA8BD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAqBD,wBAAsB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAuF3E"}

package/dist/codify.js

@@ -0,0 +1,132 @@
+import { promises as fs } from "node:fs";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { getBuildPaths, loadBuild, saveBuild, transitionTo, } from "./state.js";
+import { checkSummaryHash, readSummary } from "./approve.js";
+export class SummaryDriftError extends Error {
+    expected;
+    actual;
+    constructor(expected, actual) {
+        super(`summary.md has been edited since approval (expected hash ${expected}, got ${actual}). ` +
+            "Re-run `keel build approve <slug>` to re-record the approval, or revert summary.md.");
+        this.name = "SummaryDriftError";
+        this.expected = expected;
+        this.actual = actual;
+    }
+}
+const CODIFY_SYSTEM_PROMPT = `You are the codification assistant for Keel's build mode.
+Given an approved summary, the architecture map, and the active principles, you emit a build-ready spec.md that sub-agents can implement against.
+
+Output a single markdown document with these sections, in this order:
+
+# Spec: <topic>
+
+## Acceptance Criteria
+- one bullet per testable behavior
+
+## Affected Files
+- file path — what changes
+
+## Schema Additions
+- (none) or a per-schema bullet list
+
+## Principles To Uphold
+- principle-id — why it applies
+
+## Test Cases
+- name — assertion
+
+Hard constraints:
+- Be specific: file paths, identifiers, exact assertions
+- Do not invent decisions absent from the summary
+- Reference principle ids exactly as listed in the principles input
+- No preamble, no closing remarks — just the document`;
+async function atomicWrite(path, content) {
+    await fs.mkdir(dirname(path), { recursive: true });
+    const tmpFile = `${path}.tmp-${process.pid}-${Date.now()}`;
+    await fs.writeFile(tmpFile, content, "utf-8");
+    await fs.rename(tmpFile, path);
+}
+async function readArchitectureBrief(cwd) {
+    const candidate = join(resolve(cwd), "architecture", "data.ts");
+    if (!existsSync(candidate))
+        return "(no architecture/data.ts found)";
+    return fs.readFile(candidate, "utf-8");
+}
+async function readPrinciplesBrief(cwd) {
+    const candidate = join(resolve(cwd), "principles", "index.ts");
+    if (!existsSync(candidate))
+        return "(no principles/index.ts found)";
+    return fs.readFile(candidate, "utf-8");
+}
+export async function codifySpec(opts) {
+    const { slug, cwd, provider, model, telemetry, parentSessionId } = opts;
+    const paths = getBuildPaths(slug, cwd);
+    const build = await loadBuild(slug, cwd);
+    if (build.state !== "approved") {
+        throw new Error(`codifySpec requires state=approved (slug=${slug}, current=${build.state})`);
+    }
+    const drift = await checkSummaryHash(slug, cwd);
+    if (!drift.matches) {
+        throw new SummaryDriftError(drift.expected, drift.actual);
+    }
+    const codifying = transitionTo(build, "codifying");
+    await saveBuild(codifying, cwd);
+    const summary = await readSummary(slug, cwd);
+    const architectureBrief = await readArchitectureBrief(cwd);
+    const principlesBrief = await readPrinciplesBrief(cwd);
+    const userPrompt = `Topic: ${build.topic}\n\n` +
+        `## Approved summary\n\n${summary}\n\n` +
+        `## Architecture map (architecture/data.ts excerpt)\n\n\`\`\`ts\n${architectureBrief.slice(0, 6000)}\n\`\`\`\n\n` +
+        `## Active principles (principles/index.ts excerpt)\n\n\`\`\`ts\n${principlesBrief.slice(0, 3000)}\n\`\`\`\n\n` +
+        `Produce the spec now.`;
+    const startedAt = Date.now();
+    let res;
+    try {
+        res = await provider.generate({
+            system: CODIFY_SYSTEM_PROMPT,
+            messages: [
+                {
+                    role: "user",
+                    content: [{ type: "text", text: userPrompt }],
+                },
+            ],
+            maxTokens: 2048,
+            model: model ?? provider.defaultModel,
+        });
+    }
+    catch (err) {
+        const recovered = transitionTo(codifying, "approved");
+        await saveBuild(recovered, cwd);
+        throw err;
+    }
+    const spec = res.content
+        .map((b) => (b.type === "text" ? b.text : ""))
+        .join("")
+        .trim();
+    if (spec.length === 0) {
+        throw new Error(`Codification produced no text (slug=${slug})`);
+    }
+    await atomicWrite(paths.spec, spec + "\n");
+    const executing = transitionTo({ ...codifying, specPath: build.specPath ?? paths.spec }, "executing");
+    executing.specPath = paths.spec;
+    await saveBuild(executing, cwd);
+    telemetry?.emit({
+        sessionId: parentSessionId ?? "",
+        parentEventId: null,
+        workspaceId: null,
+        triggeredBy: { kind: "user" },
+        kind: "build.spec-codified",
+        payload: {
+            slug,
+            specPath: paths.spec,
+            specChars: spec.length,
+        },
+        latencyMs: Date.now() - startedAt,
+        inputTokens: res.usage.inputTokens,
+        outputTokens: res.usage.outputTokens,
+        model: model ?? provider.defaultModel,
+    });
+    return { specPath: paths.spec, spec };
+}
+//# sourceMappingURL=codify.js.map

package/dist/codify.js.map

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

package/dist/distill.d.ts

@@ -0,0 +1,16 @@
+import type { ModelProvider } from "@keel_flow/runtime";
+import type { TelemetryEmitter } from "@keel_flow/telemetry";
+export interface DistillOptions {
+    slug: string;
+    cwd: string;
+    provider: ModelProvider;
+    model?: string;
+    telemetry?: TelemetryEmitter;
+    parentSessionId?: string;
+}
+export interface DistillResult {
+    summary: string;
+    summaryHash: string;
+}
+export declare function distillSummary(opts: DistillOptions): Promise<DistillResult>;
+//# sourceMappingURL=distill.d.ts.map

package/dist/distill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distill.d.ts","sourceRoot":"","sources":["../src/distill.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA2B7D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAaD,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA0EjF"}

package/dist/distill.js

@@ -0,0 +1,94 @@
+import { promises as fs } from "node:fs";
+import { createHash } from "node:crypto";
+import { dirname } from "node:path";
+import { getBuildPaths, loadBuild, saveBuild, transitionTo } from "./state.js";
+import { readConversation } from "./draft.js";
+const DISTILL_SYSTEM_PROMPT = `You are the distillation assistant for Keel's build mode.
+You compress a planning conversation into a concise summary that the user will approve before any code is written.
+
+Output a single markdown document with these sections, in this order:
+
+## Decisions
+- one bullet per decision the conversation has converged on
+
+## Scope
+**In scope**
+- bullets
+**Out of scope**
+- bullets
+
+## Open Questions
+- bullets
+
+Hard constraints:
+- ≤500 tokens total
+- Do not invent decisions not present in the conversation
+- If a section is empty, write "(none yet)" — do not omit the header
+- No preamble, no closing remarks, no apologies — just the document`;
+function sha256(s) {
+    return createHash("sha256").update(s, "utf-8").digest("hex");
+}
+async function atomicWrite(path, content) {
+    await fs.mkdir(dirname(path), { recursive: true });
+    const tmpFile = `${path}.tmp-${process.pid}-${Date.now()}`;
+    await fs.writeFile(tmpFile, content, "utf-8");
+    await fs.rename(tmpFile, path);
+}
+export async function distillSummary(opts) {
+    const { slug, cwd, provider, model, telemetry, parentSessionId } = opts;
+    const paths = getBuildPaths(slug, cwd);
+    const build = await loadBuild(slug, cwd);
+    if (build.state !== "drafting" && build.state !== "summarizing") {
+        throw new Error(`distillSummary requires state=drafting or state=summarizing (slug=${slug}, current=${build.state})`);
+    }
+    if (build.state === "drafting") {
+        const transitioning = transitionTo(build, "summarizing");
+        await saveBuild(transitioning, cwd);
+    }
+    const conversation = await readConversation(slug, cwd);
+    const userPrompt = `Topic: ${build.topic}\n\n` +
+        `Conversation transcript (markdown blocks per turn follow):\n\n${conversation}\n\n` +
+        `Produce the summary now.`;
+    const startedAt = Date.now();
+    const res = await provider.generate({
+        system: DISTILL_SYSTEM_PROMPT,
+        messages: [
+            {
+                role: "user",
+                content: [{ type: "text", text: userPrompt }],
+            },
+        ],
+        maxTokens: 1024,
+        model: model ?? provider.defaultModel,
+    });
+    const text = res.content
+        .map((b) => (b.type === "text" ? b.text : ""))
+        .join("")
+        .trim();
+    if (text.length === 0) {
+        throw new Error(`Distillation produced no text (slug=${slug})`);
+    }
+    await atomicWrite(paths.summary, text + "\n");
+    const summaryHash = sha256(text + "\n");
+    const summarized = transitionTo({ ...build, state: "summarizing", updatedAt: new Date().toISOString() }, "awaiting-approval");
+    await saveBuild(summarized, cwd);
+    telemetry?.emit({
+        sessionId: parentSessionId ?? "",
+        parentEventId: null,
+        workspaceId: null,
+        triggeredBy: { kind: "user" },
+        kind: "build.summary",
+        payload: {
+            slug,
+            summaryHash,
+            conversationChars: conversation.length,
+            summaryChars: text.length,
+        },
+        latencyMs: Date.now() - startedAt,
+        inputTokens: res.usage.inputTokens,
+        outputTokens: res.usage.outputTokens,
+        model: model ?? provider.defaultModel,
+    });
+    return { summary: text, summaryHash };
+}
+//# sourceMappingURL=distill.js.map

package/dist/distill.js.map

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

package/dist/draft.d.ts

@@ -0,0 +1,5 @@
+export type ConversationRole = "user" | "assistant" | "system" | "rejection";
+export declare function appendConversation(slug: string, role: ConversationRole, content: string, cwd: string): Promise<void>;
+export declare function readConversation(slug: string, cwd: string): Promise<string>;
+export declare function countTurns(conversation: string): number;
+//# sourceMappingURL=draft.d.ts.map

package/dist/draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../src/draft.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE7E,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIjF;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/draft.js

@@ -0,0 +1,21 @@
+import { promises as fs } from "node:fs";
+import { existsSync } from "node:fs";
+import { dirname } from "node:path";
+import { getBuildPaths } from "./state.js";
+export async function appendConversation(slug, role, content, cwd) {
+    const paths = getBuildPaths(slug, cwd);
+    await fs.mkdir(dirname(paths.conversation), { recursive: true });
+    const timestamp = new Date().toISOString();
+    const block = `\n## ${timestamp} — ${role}\n\n${content.trim()}\n`;
+    await fs.appendFile(paths.conversation, block, "utf-8");
+}
+export async function readConversation(slug, cwd) {
+    const paths = getBuildPaths(slug, cwd);
+    if (!existsSync(paths.conversation))
+        return "";
+    return fs.readFile(paths.conversation, "utf-8");
+}
+export function countTurns(conversation) {
+    return (conversation.match(/^## .* — (user|assistant)$/gm) ?? []).length;
+}
+//# sourceMappingURL=draft.js.map

package/dist/draft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.js","sourceRoot":"","sources":["../src/draft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI3C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,IAAsB,EACtB,OAAe,EACf,GAAW;IAEX,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,QAAQ,SAAS,MAAM,IAAI,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;IACnE,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,GAAW;IAC9D,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/C,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC7C,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,8BAA8B,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;AAC3E,CAAC"}

package/dist/execute.d.ts

@@ -0,0 +1,31 @@
+import type { TelemetryEmitter } from "@keel_flow/telemetry";
+export interface ExecutorContext {
+    slug: string;
+    cwd: string;
+    spec: string;
+    specPath: string;
+    topic: string;
+    dryRun: boolean;
+}
+export interface ExecutorOutcome {
+    finalMessage: string;
+    toolCalls: number;
+    iterations: number;
+    verifyExitCode: number;
+    commits?: string[];
+}
+export type ExecutorFn = (ctx: ExecutorContext) => Promise<ExecutorOutcome>;
+export interface ExecuteBuildOptions {
+    slug: string;
+    cwd: string;
+    executeFn: ExecutorFn;
+    telemetry?: TelemetryEmitter;
+    parentSessionId?: string;
+    dryRun?: boolean;
+}
+export interface ExecuteBuildResult {
+    resultPath: string;
+    verifyExitCode: number;
+}
+export declare function executeBuild(opts: ExecuteBuildOptions): Promise<ExecuteBuildResult>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAS7D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiEzF"}

package/dist/execute.js

@@ -0,0 +1,55 @@
+import { promises as fs } from "node:fs";
+import { getBuildPaths, loadBuild, saveBuild, transitionTo, } from "./state.js";
+import { writeResult } from "./result.js";
+export async function executeBuild(opts) {
+    const { slug, cwd, executeFn, telemetry, parentSessionId, dryRun } = opts;
+    const paths = getBuildPaths(slug, cwd);
+    const build = await loadBuild(slug, cwd);
+    if (build.state !== "executing") {
+        throw new Error(`executeBuild requires state=executing (slug=${slug}, current=${build.state}). Run codify first.`);
+    }
+    const spec = await fs.readFile(paths.spec, "utf-8");
+    const startedAt = Date.now();
+    telemetry?.emit({
+        sessionId: parentSessionId ?? "",
+        parentEventId: null,
+        workspaceId: null,
+        triggeredBy: { kind: "user" },
+        kind: "build.executing",
+        payload: { slug, specPath: paths.spec, dryRun: dryRun ?? false },
+    });
+    const outcome = await executeFn({
+        slug,
+        cwd,
+        spec,
+        specPath: paths.spec,
+        topic: build.topic,
+        dryRun: dryRun ?? false,
+    });
+    const resultPath = await writeResult(slug, {
+        finalMessage: outcome.finalMessage,
+        toolCalls: outcome.toolCalls,
+        iterations: outcome.iterations,
+        verifyExitCode: outcome.verifyExitCode,
+        commits: outcome.commits ?? [],
+    }, cwd);
+    const complete = transitionTo(build, "complete");
+    complete.resultPath = resultPath;
+    await saveBuild(complete, cwd);
+    telemetry?.emit({
+        sessionId: parentSessionId ?? "",
+        parentEventId: null,
+        workspaceId: null,
+        triggeredBy: { kind: "user" },
+        kind: "build.complete",
+        payload: {
+            slug,
+            verifyExitCode: outcome.verifyExitCode,
+            iterations: outcome.iterations,
+            toolCalls: outcome.toolCalls,
+        },
+        latencyMs: Date.now() - startedAt,
+    });
+    return { resultPath, verifyExitCode: outcome.verifyExitCode };
+}
+//# sourceMappingURL=execute.js.map

package/dist/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,EACL,aAAa,EACb,SAAS,EACT,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAmC1C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAyB;IAC1D,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE1E,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAEzC,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,+CAA+C,IAAI,aAAa,KAAK,CAAC,KAAK,sBAAsB,CAClG,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,SAAS,EAAE,IAAI,CAAC;QACd,SAAS,EAAE,eAAe,IAAI,EAAE;QAChC,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QAC7B,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,KAAK,EAAE;KACjE,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC;QAC9B,IAAI;QACJ,GAAG;QACH,IAAI;QACJ,QAAQ,EAAE,KAAK,CAAC,IAAI;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,MAAM,IAAI,KAAK;KACxB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,WAAW,CAClC,IAAI,EACJ;QACE,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;KAC/B,EACD,GAAG,CACJ,CAAC;IAEF,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAE/B,SAAS,EAAE,IAAI,CAAC;QACd,SAAS,EAAE,eAAe,IAAI,EAAE;QAChC,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QAC7B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE;YACP,IAAI;YACJ,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B;QACD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KAClC,CAAC,CAAC;IAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;AAChE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { slugFromTopic, canTransition, transitionTo, getBuildPaths, createBuild, loadBuild, tryLoadBuild, listBuilds, saveBuild, buildsRoot, } from "./state.js";
+export type { BuildPaths } from "./state.js";
+export { appendConversation, readConversation, countTurns, } from "./draft.js";
+export type { ConversationRole } from "./draft.js";
+export { distillSummary } from "./distill.js";
+export type { DistillOptions, DistillResult } from "./distill.js";
+export { recordApproval, recordRejection, checkSummaryHash, readSummary, } from "./approve.js";
+export type { RecordApprovalOptions, SummaryHashCheckResult, } from "./approve.js";
+export { codifySpec, SummaryDriftError } from "./codify.js";
+export type { CodifyOptions, CodifyResult } from "./codify.js";
+export { executeBuild } from "./execute.js";
+export type { ExecuteBuildOptions, ExecuteBuildResult, ExecutorContext, ExecutorOutcome, ExecutorFn, } from "./execute.js";
+export { writeResult } from "./result.js";
+export type { WriteResultOptions } from "./result.js";
+export type { Build, BuildState } from "@keel_flow/schema";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EACL,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { slugFromTopic, canTransition, transitionTo, getBuildPaths, createBuild, loadBuild, tryLoadBuild, listBuilds, saveBuild, buildsRoot, } from "./state.js";
+export { appendConversation, readConversation, countTurns, } from "./draft.js";
+export { distillSummary } from "./distill.js";
+export { recordApproval, recordRejection, checkSummaryHash, readSummary, } from "./approve.js";
+export { codifySpec, SummaryDriftError } from "./codify.js";
+export { executeBuild } from "./execute.js";
+export { writeResult } from "./result.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EACL,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,cAAc,CAAC;AAMtB,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAS5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/result.d.ts

@@ -0,0 +1,9 @@
+export interface WriteResultOptions {
+    finalMessage: string;
+    toolCalls: number;
+    iterations: number;
+    verifyExitCode: number;
+    commits: string[];
+}
+export declare function writeResult(slug: string, opts: WriteResultOptions, cwd: string): Promise<string>;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AASD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,kBAAkB,EACxB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/dist/result.js

@@ -0,0 +1,24 @@
+import { promises as fs } from "node:fs";
+import { dirname } from "node:path";
+import { getBuildPaths } from "./state.js";
+async function atomicWrite(path, content) {
+    await fs.mkdir(dirname(path), { recursive: true });
+    const tmpFile = `${path}.tmp-${process.pid}-${Date.now()}`;
+    await fs.writeFile(tmpFile, content, "utf-8");
+    await fs.rename(tmpFile, path);
+}
+export async function writeResult(slug, opts, cwd) {
+    const paths = getBuildPaths(slug, cwd);
+    const commitsList = opts.commits.length === 0
+        ? "(none)"
+        : opts.commits.map((c) => `- ${c}`).join("\n");
+    const body = `# Result: ${slug}\n\n` +
+        `Completed: ${new Date().toISOString()}\n\n` +
+        `## Verify\n\n- exitCode: ${opts.verifyExitCode}\n\n` +
+        `## Execution\n\n- iterations: ${opts.iterations}\n- toolCalls: ${opts.toolCalls}\n\n` +
+        `## Commits\n\n${commitsList}\n\n` +
+        `## Orchestrator Final Message\n\n${opts.finalMessage.trim()}\n`;
+    await atomicWrite(paths.result, body);
+    return paths.result;
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAU3C,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,OAAe;IACtD,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,IAAwB,EACxB,GAAW;IAEX,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,WAAW,GACf,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnD,MAAM,IAAI,GACR,aAAa,IAAI,MAAM;QACvB,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM;QAC5C,4BAA4B,IAAI,CAAC,cAAc,MAAM;QACrD,iCAAiC,IAAI,CAAC,UAAU,kBAAkB,IAAI,CAAC,SAAS,MAAM;QACtF,iBAAiB,WAAW,MAAM;QAClC,oCAAoC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC;IAEnE,MAAM,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,23 @@
+import { type Build, type BuildState } from "@keel_flow/schema";
+export interface BuildPaths {
+    dir: string;
+    conversation: string;
+    summary: string;
+    spec: string;
+    result: string;
+    state: string;
+}
+export declare function buildsRoot(cwd: string): string;
+export declare function getBuildPaths(slug: string, cwd: string): BuildPaths;
+export declare function slugFromTopic(topic: string, existing?: Set<string>): string;
+export declare function canTransition(from: BuildState, to: BuildState): boolean;
+export declare function transitionTo(build: Build, nextState: BuildState): Build;
+export declare function saveBuild(build: Build, cwd: string): Promise<void>;
+export declare function loadBuild(slug: string, cwd: string): Promise<Build>;
+export declare function tryLoadBuild(slug: string, cwd: string): Promise<Build | null>;
+export declare function listBuilds(cwd: string): Promise<Build[]>;
+export declare function createBuild(args: {
+    slug: string;
+    topic: string;
+}, cwd: string): Promise<Build>;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAyB7E,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAUnE;AAMD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,MAAM,CAetF;AAcD,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAEvE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,GAAG,KAAK,CAWvE;AASD,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAKzE;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAInF;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAY9D;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACrC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC,CA0BhB"}

package/dist/state.js

@@ -0,0 +1,149 @@
+import { promises as fs } from "node:fs";
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { BuildSchema } from "@keel_flow/schema";
+const STOPWORDS = new Set([
+    "a",
+    "an",
+    "the",
+    "and",
+    "or",
+    "of",
+    "to",
+    "for",
+    "in",
+    "on",
+    "with",
+    "is",
+    "are",
+    "be",
+    "by",
+    "at",
+    "as",
+    "it",
+    "this",
+    "that",
+]);
+export function buildsRoot(cwd) {
+    return join(resolve(cwd), ".keel", "builds");
+}
+export function getBuildPaths(slug, cwd) {
+    const dir = join(buildsRoot(cwd), slug);
+    return {
+        dir,
+        conversation: join(dir, "conversation.md"),
+        summary: join(dir, "summary.md"),
+        spec: join(dir, "spec.md"),
+        result: join(dir, "result.md"),
+        state: join(dir, "state.json"),
+    };
+}
+function normalizeWord(w) {
+    return w.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+export function slugFromTopic(topic, existing = new Set()) {
+    const tokens = topic
+        .split(/\s+/)
+        .map(normalizeWord)
+        .filter((w) => w.length > 0);
+    const meaningful = tokens.filter((w) => !STOPWORDS.has(w));
+    const source = meaningful.length > 0 ? meaningful : tokens;
+    const head = source.slice(0, 3);
+    const base = head.length > 0 ? head.join("-") : "build";
+    if (!existing.has(base))
+        return base;
+    let n = 2;
+    while (existing.has(`${base}-${n}`))
+        n += 1;
+    return `${base}-${n}`;
+}
+const LEGAL_TRANSITIONS = {
+    drafting: ["summarizing", "abandoned"],
+    summarizing: ["awaiting-approval", "drafting", "abandoned"],
+    "awaiting-approval": ["approved", "rejected", "abandoned"],
+    approved: ["codifying", "abandoned"],
+    rejected: ["drafting", "abandoned"],
+    codifying: ["executing", "approved", "abandoned"],
+    executing: ["complete", "abandoned"],
+    complete: ["abandoned"],
+    abandoned: [],
+};
+export function canTransition(from, to) {
+    return LEGAL_TRANSITIONS[from]?.includes(to) ?? false;
+}
+export function transitionTo(build, nextState) {
+    if (!canTransition(build.state, nextState)) {
+        throw new Error(`Illegal build-state transition: ${build.state} → ${nextState} (slug=${build.slug})`);
+    }
+    return {
+        ...build,
+        state: nextState,
+        updatedAt: new Date().toISOString(),
+    };
+}
+async function atomicWrite(path, content) {
+    await fs.mkdir(join(path, ".."), { recursive: true });
+    const tmpFile = `${path}.tmp-${process.pid}-${Date.now()}`;
+    await fs.writeFile(tmpFile, content, "utf-8");
+    await fs.rename(tmpFile, path);
+}
+export async function saveBuild(build, cwd) {
+    const paths = getBuildPaths(build.slug, cwd);
+    await fs.mkdir(paths.dir, { recursive: true });
+    await atomicWrite(paths.state, JSON.stringify(build, null, 2));
+}
+export async function loadBuild(slug, cwd) {
+    const paths = getBuildPaths(slug, cwd);
+    const raw = await fs.readFile(paths.state, "utf-8");
+    const parsed = JSON.parse(raw);
+    return BuildSchema.parse(parsed);
+}
+export async function tryLoadBuild(slug, cwd) {
+    const paths = getBuildPaths(slug, cwd);
+    if (!existsSync(paths.state))
+        return null;
+    return loadBuild(slug, cwd);
+}
+export async function listBuilds(cwd) {
+    const root = buildsRoot(cwd);
+    if (!existsSync(root))
+        return [];
+    const entries = await fs.readdir(root, { withFileTypes: true });
+    const out = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const build = await tryLoadBuild(entry.name, cwd);
+        if (build)
+            out.push(build);
+    }
+    out.sort((a, b) => (a.updatedAt < b.updatedAt ? 1 : -1));
+    return out;
+}
+export async function createBuild(args, cwd) {
+    const paths = getBuildPaths(args.slug, cwd);
+    const rel = (p) => p.startsWith(resolve(cwd))
+        ? p.slice(resolve(cwd).length + 1)
+        : p;
+    const now = new Date().toISOString();
+    const build = {
+        slug: args.slug,
+        topic: args.topic,
+        state: "drafting",
+        conversationPath: rel(paths.conversation),
+        summaryPath: rel(paths.summary),
+        specPath: null,
+        resultPath: null,
+        approvedAt: null,
+        approvedSummaryHash: null,
+        createdAt: now,
+        updatedAt: now,
+    };
+    await fs.mkdir(paths.dir, { recursive: true });
+    if (!existsSync(paths.conversation)) {
+        await fs.writeFile(paths.conversation, "", "utf-8");
+    }
+    await saveBuild(build, cwd);
+    return build;
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@keel_flow/build-mode",
+  "version": "0.2.0",
+  "private": false,
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.23.0",
+    "@keel_flow/runtime": "0.2.0",
+    "@keel_flow/schema": "0.2.0",
+    "@keel_flow/telemetry": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}