@slopus/beer 0.1.1 → 0.1.2

package/dist/_workflows/steps/generateFrontmatter.d.ts

@@ -0,0 +1,17 @@
+import type { ZodTypeAny } from "zod";
+import { type GenerateFilePermissions } from "@/modules/ai/generateFile.js";
+import type { Context } from "@/types";
+export interface GenerateFrontmatterOptions extends Omit<GenerateFilePermissions, "verify"> {
+}
+export interface GenerateFrontmatterResult {
+    provider?: string;
+    sessionId?: string;
+    text: string;
+    filePath: string;
+}
+/**
+ * Generates a file and requires YAML frontmatter that matches the given schema.
+ * Expects: outputFilePath is project-relative or absolute and schema is a zod object-like validator.
+ */
+export declare function generateFrontmatter(ctx: Context, prompt: string, outputFilePath: string, schema: ZodTypeAny, options?: GenerateFrontmatterOptions): Promise<GenerateFrontmatterResult>;
+//# sourceMappingURL=generateFrontmatter.d.ts.map

package/dist/_workflows/steps/generateFrontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateFrontmatter.d.ts","sourceRoot":"","sources":["../../../sources/_workflows/steps/generateFrontmatter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,UAAU,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,KAAK,uBAAuB,EAAgB,MAAM,8BAA8B,CAAC;AAC1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC;CAAG;AAE9F,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACrC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,0BAA+B,GACzC,OAAO,CAAC,yBAAyB,CAAC,CAepC"}

package/dist/_workflows/steps/generateFrontmatter.js

@@ -0,0 +1,51 @@
+import path from "node:path";
+import matter from "gray-matter";
+import { generateFile } from "@/modules/ai/generateFile.js";
+/**
+ * Generates a file and requires YAML frontmatter that matches the given schema.
+ * Expects: outputFilePath is project-relative or absolute and schema is a zod object-like validator.
+ */
+export async function generateFrontmatter(ctx, prompt, outputFilePath, schema, options = {}) {
+    const resolvedOutputPath = pathResolveInProject(ctx.projectPath, outputFilePath);
+    const result = await generateFile(ctx, prompt, resolvedOutputPath, {
+        ...options,
+        verify: ({ filePath, fileContent }) => {
+            generateFrontmatterVerify(resolvedOutputPath, filePath, fileContent, schema);
+        }
+    });
+    return {
+        provider: result.provider,
+        sessionId: result.sessionId,
+        text: result.text,
+        filePath: resolvedOutputPath
+    };
+}
+function pathResolveInProject(projectPath, outputFilePath) {
+    if (path.isAbsolute(outputFilePath)) {
+        return path.resolve(outputFilePath);
+    }
+    return path.resolve(projectPath, outputFilePath);
+}
+function generateFrontmatterVerify(expectedFilePath, filePath, fileContent, schema) {
+    if (path.resolve(filePath) !== expectedFilePath) {
+        throw new Error(`File must be generated at path: ${expectedFilePath}`);
+    }
+    if (!matter.test(fileContent)) {
+        throw new Error(`Generated file must include frontmatter: ${expectedFilePath}`);
+    }
+    const parsed = matter(fileContent);
+    const parsedFrontmatter = schema.safeParse(parsed.data);
+    if (!parsedFrontmatter.success) {
+        const details = generateFrontmatterIssuesFormat(parsedFrontmatter.error.issues);
+        throw new Error(`Generated frontmatter does not match schema: ${details}`);
+    }
+}
+function generateFrontmatterIssuesFormat(issues) {
+    return issues
+        .map((issue) => {
+        const issuePath = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+        return `${issuePath}: ${issue.message}`;
+    })
+        .join("; ");
+}
+//# sourceMappingURL=generateFrontmatter.js.map

package/dist/_workflows/steps/generateFrontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateFrontmatter.js","sourceRoot":"","sources":["../../../sources/_workflows/steps/generateFrontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAgC,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAY1F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,GAAY,EACZ,MAAc,EACd,cAAsB,EACtB,MAAkB,EAClB,UAAsC,EAAE;IAExC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,GAAG,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,kBAAkB,EAAE;QAC/D,GAAG,OAAO;QACV,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE;YAClC,yBAAyB,CAAC,kBAAkB,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACjF,CAAC;KACJ,CAAC,CAAC;IAEH,OAAO;QACH,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,kBAAkB;KAC/B,CAAC;AACN,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAmB,EAAE,cAAsB;IACrE,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,yBAAyB,CAC9B,gBAAwB,EACxB,QAAgB,EAChB,WAAmB,EACnB,MAAkB;IAElB,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,gBAAgB,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,mCAAmC,gBAAgB,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,4CAA4C,gBAAgB,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACnC,MAAM,iBAAiB,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,+BAA+B,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,gDAAgD,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;AACL,CAAC;AAED,SAAS,+BAA+B,CAAC,MAA2B;IAChE,OAAO,MAAM;SACR,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACX,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1E,OAAO,GAAG,SAAS,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC"}

package/dist/_workflows/steps/generateProgressMessageResolve.d.ts

@@ -0,0 +1,10 @@
+import type { GenerateEvent } from "@/types";
+/**
+ * Resolves a user-facing progress message for inference events.
+ * Expects: baseMessage is already trimmed and non-empty.
+ */
+export declare function generateProgressMessageResolve(baseMessage: string, event: GenerateEvent, previousTokenCount?: number): {
+    message: string;
+    tokenCount: number;
+};
+//# sourceMappingURL=generateProgressMessageResolve.d.ts.map

package/dist/_workflows/steps/generateProgressMessageResolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateProgressMessageResolve.d.ts","sourceRoot":"","sources":["../../../sources/_workflows/steps/generateProgressMessageResolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,8BAA8B,CAC1C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,EACpB,kBAAkB,SAAI,GACvB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAOzC"}

package/dist/_workflows/steps/generateProgressMessageResolve.js

@@ -0,0 +1,75 @@
+/**
+ * Resolves a user-facing progress message for inference events.
+ * Expects: baseMessage is already trimmed and non-empty.
+ */
+export function generateProgressMessageResolve(baseMessage, event, previousTokenCount = 0) {
+    const tokenCount = Math.max(previousTokenCount, generateEventTokenCountResolve(event) ?? 0);
+    const label = generateEventHumanize(event);
+    return {
+        message: `${baseMessage} (${label}, tokens ${tokenCount})`,
+        tokenCount
+    };
+}
+function generateEventHumanize(event) {
+    switch (event.type) {
+        case "provider_status":
+            return event.status === "started" ? "starting" : "working";
+        case "thinking":
+            return "thinking";
+        case "tool_call":
+            return event.toolName ? generateToolHumanize(event.toolName) : "using tools";
+        case "text":
+            return "writing";
+        case "usage":
+            return "writing";
+        default:
+            return "working";
+    }
+}
+function generateEventTokenCountResolve(event) {
+    if (event.type === "usage") {
+        return event.tokens.total;
+    }
+    if (event.type === "provider_status") {
+        return event.tokens?.total;
+    }
+    if (event.type === "thinking" || event.type === "tool_call" || event.type === "text") {
+        return event.tokens?.total;
+    }
+    return undefined;
+}
+/** Maps provider tool names to short user-facing labels. */
+function generateToolHumanize(toolName) {
+    switch (toolName) {
+        case "Read":
+        case "read_file":
+            return "reading files";
+        case "Write":
+        case "write_file":
+            return "writing files";
+        case "Edit":
+        case "edit_file":
+            return "editing files";
+        case "Bash":
+        case "bash":
+        case "execute_command":
+            return "running command";
+        case "Grep":
+        case "grep":
+        case "search":
+            return "searching code";
+        case "Glob":
+        case "glob":
+        case "list_files":
+            return "finding files";
+        case "WebFetch":
+        case "web_fetch":
+            return "fetching web content";
+        case "WebSearch":
+        case "web_search":
+            return "searching web";
+        default:
+            return `using ${toolName}`;
+    }
+}
+//# sourceMappingURL=generateProgressMessageResolve.js.map

package/dist/_workflows/steps/generateProgressMessageResolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateProgressMessageResolve.js","sourceRoot":"","sources":["../../../sources/_workflows/steps/generateProgressMessageResolve.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC1C,WAAmB,EACnB,KAAoB,EACpB,kBAAkB,GAAG,CAAC;IAEtB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,8BAA8B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO;QACH,OAAO,EAAE,GAAG,WAAW,KAAK,KAAK,YAAY,UAAU,GAAG;QAC1D,UAAU;KACb,CAAC;AACN,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAoB;IAC/C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,iBAAiB;YAClB,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/D,KAAK,UAAU;YACX,OAAO,UAAU,CAAC;QACtB,KAAK,WAAW;YACZ,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QACjF,KAAK,MAAM;YACP,OAAO,SAAS,CAAC;QACrB,KAAK,OAAO;YACR,OAAO,SAAS,CAAC;QACrB;YACI,OAAO,SAAS,CAAC;IACzB,CAAC;AACL,CAAC;AAED,SAAS,8BAA8B,CAAC,KAAoB;IACxD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACnF,OAAO,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,4DAA4D;AAC5D,SAAS,oBAAoB,CAAC,QAAgB;IAC1C,QAAQ,QAAQ,EAAE,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,WAAW;YACZ,OAAO,eAAe,CAAC;QAC3B,KAAK,OAAO,CAAC;QACb,KAAK,YAAY;YACb,OAAO,eAAe,CAAC;QAC3B,KAAK,MAAM,CAAC;QACZ,KAAK,WAAW;YACZ,OAAO,eAAe,CAAC;QAC3B,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,iBAAiB;YAClB,OAAO,iBAAiB,CAAC;QAC7B,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACT,OAAO,gBAAgB,CAAC;QAC5B,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,YAAY;YACb,OAAO,eAAe,CAAC;QAC3B,KAAK,UAAU,CAAC;QAChB,KAAK,WAAW;YACZ,OAAO,sBAAsB,CAAC;QAClC,KAAK,WAAW,CAAC;QACjB,KAAK,YAAY;YACb,OAAO,eAAe,CAAC;QAC3B;YACI,OAAO,SAAS,QAAQ,EAAE,CAAC;IACnC,CAAC;AACL,CAAC"}

package/dist/_workflows/steps/generateProgressMessageResolve.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generateProgressMessageResolve.spec.d.ts.map

package/dist/_workflows/steps/generateProgressMessageResolve.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateProgressMessageResolve.spec.d.ts","sourceRoot":"","sources":["../../../sources/_workflows/steps/generateProgressMessageResolve.spec.ts"],"names":[],"mappings":""}

package/dist/_workflows/steps/generateProgressMessageResolve.spec.js

@@ -0,0 +1,53 @@
+import { describe, expect, it } from "vitest";
+import { generateProgressMessageResolve } from "./generateProgressMessageResolve.js";
+describe("generateProgressMessageResolve", () => {
+    it("always renders tokens even when an event has no token usage", () => {
+        const event = {
+            type: "provider_status",
+            providerId: "pi",
+            status: "started"
+        };
+        const result = generateProgressMessageResolve("Generating", event);
+        expect(result).toEqual({
+            message: "Generating (starting, tokens 0)",
+            tokenCount: 0
+        });
+    });
+    it("keeps token counts monotonic across events", () => {
+        const usage = {
+            type: "usage",
+            providerId: "pi",
+            tokens: {
+                input: 10,
+                output: 5,
+                cacheRead: 0,
+                cacheWrite: 0,
+                total: 15
+            }
+        };
+        const lowerText = {
+            type: "text",
+            providerId: "pi",
+            status: "updated",
+            text: "partial",
+            tokens: {
+                input: 1,
+                output: 1,
+                cacheRead: 0,
+                cacheWrite: 0,
+                total: 2
+            }
+        };
+        const first = generateProgressMessageResolve("Generating", usage);
+        const second = generateProgressMessageResolve("Generating", lowerText, first.tokenCount);
+        expect(first).toEqual({
+            message: "Generating (writing, tokens 15)",
+            tokenCount: 15
+        });
+        expect(second).toEqual({
+            message: "Generating (writing, tokens 15)",
+            tokenCount: 15
+        });
+    });
+});
+//# sourceMappingURL=generateProgressMessageResolve.spec.js.map

package/dist/_workflows/steps/generateProgressMessageResolve.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateProgressMessageResolve.spec.js","sourceRoot":"","sources":["../../../sources/_workflows/steps/generateProgressMessageResolve.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAErF,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACnE,MAAM,KAAK,GAAkB;YACzB,IAAI,EAAE,iBAAiB;YACvB,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,SAAS;SACpB,CAAC;QACF,MAAM,MAAM,GAAG,8BAA8B,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACnE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,iCAAiC;YAC1C,UAAU,EAAE,CAAC;SAChB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,KAAK,GAAkB;YACzB,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE;gBACJ,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,CAAC;gBACT,SAAS,EAAE,CAAC;gBACZ,UAAU,EAAE,CAAC;gBACb,KAAK,EAAE,EAAE;aACZ;SACJ,CAAC;QACF,MAAM,SAAS,GAAkB;YAC7B,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE;gBACJ,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,CAAC;gBACT,SAAS,EAAE,CAAC;gBACZ,UAAU,EAAE,CAAC;gBACb,KAAK,EAAE,CAAC;aACX;SACJ,CAAC;QAEF,MAAM,KAAK,GAAG,8BAA8B,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,8BAA8B,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAEzF,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YAClB,OAAO,EAAE,iCAAiC;YAC1C,UAAU,EAAE,EAAE;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,iCAAiC;YAC1C,UAAU,EAAE,EAAE;SACjB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/_workflows/steps/generateReadme.d.ts

@@ -0,0 +1,21 @@
+import type { Context } from "@/types";
+export interface GenerateReadmeInput {
+    sourceFullName: string;
+    publishFullName: string;
+    originalCheckoutPath: string;
+}
+export interface GenerateReadmeOptions {
+    showProgress?: boolean;
+}
+export interface GenerateReadmeResult {
+    provider?: string;
+    sessionId?: string;
+    text: string;
+    readmePath: string;
+}
+/**
+ * Generates README.md at project root using sonnet-biased inference.
+ * Expects: input fields are non-empty repository identifiers and checkout path.
+ */
+export declare function generateReadme(ctx: Context, input: GenerateReadmeInput, options?: GenerateReadmeOptions): Promise<GenerateReadmeResult>;
+//# sourceMappingURL=generateReadme.d.ts.map

package/dist/_workflows/steps/generateReadme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateReadme.d.ts","sourceRoot":"","sources":["../../../sources/_workflows/steps/generateReadme.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACtB;AAOD;;;GAGG;AACH,wBAAsB,cAAc,CAChC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,qBAA0B,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAsB/B"}

package/dist/_workflows/steps/generateReadme.js

@@ -0,0 +1,32 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { text, textFormat } from "@text";
+import { generateFile } from "@/modules/ai/generateFile.js";
+const promptTemplate = readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "../prompts/PROMPT_README.md"), "utf-8");
+/**
+ * Generates README.md at project root using sonnet-biased inference.
+ * Expects: input fields are non-empty repository identifiers and checkout path.
+ */
+export async function generateReadme(ctx, input, options = {}) {
+    const prompt = textFormat(promptTemplate, {
+        sourceFullName: input.sourceFullName,
+        publishFullName: input.publishFullName,
+        originalCheckoutPath: input.originalCheckoutPath
+    });
+    const readmePath = path.resolve(ctx.projectPath, "README.md");
+    const runGenerate = () => generateFile(ctx, prompt, readmePath, {
+        showProgress: false,
+        modelSelectionMode: "sonnet"
+    });
+    const result = options.showProgress
+        ? await ctx.progress(text.bootstrap_readme_generating, async () => runGenerate())
+        : await runGenerate();
+    return {
+        provider: result.provider,
+        sessionId: result.sessionId,
+        text: result.text,
+        readmePath
+    };
+}
+//# sourceMappingURL=generateReadme.js.map

package/dist/_workflows/steps/generateReadme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateReadme.js","sourceRoot":"","sources":["../../../sources/_workflows/steps/generateReadme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAoB5D,MAAM,cAAc,GAAG,YAAY,CAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,6BAA6B,CAAC,EACtF,OAAO,CACV,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,GAAY,EACZ,KAA0B,EAC1B,UAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,UAAU,CAAC,cAAc,EAAE;QACtC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;KACnD,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,GAAG,EAAE,CACrB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE;QAClC,YAAY,EAAE,KAAK;QACnB,kBAAkB,EAAE,QAAQ;KAC/B,CAAC,CAAC;IACP,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY;QAC/B,CAAC,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,2BAA4B,EAAE,KAAK,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAClF,CAAC,CAAC,MAAM,WAAW,EAAE,CAAC;IAE1B,OAAO;QACH,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU;KACb,CAAC;AACN,CAAC"}

package/dist/_workflows/steps/ralphExecute.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "@/types";
+/**
+ * Executes the finalized ralph plan with codex-xhigh.
+ * Expects: planPath points to an existing plan markdown file.
+ */
+export declare function ralphExecute(ctx: Context, buildGoal: string, planPath: string): Promise<{
+    provider?: string;
+    sessionId?: string;
+    text: string;
+}>;
+//# sourceMappingURL=ralphExecute.d.ts.map

package/dist/_workflows/steps/ralphExecute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphExecute.d.ts","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphExecute.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAavC;;;GAGG;AACH,wBAAsB,YAAY,CAC9B,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBlE"}

package/dist/_workflows/steps/ralphExecute.js

@@ -0,0 +1,39 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { text } from "@text";
+import { generate } from "@/_workflows/steps/generate.js";
+const executePromptTemplate = [
+    "Implement this build goal in the current repository: {{buildGoal}}",
+    "Use this finalized plan as the exact scope of work:",
+    "{{planContent}}",
+    "Execution rules:",
+    "- apply code and test changes directly in the repository",
+    "- keep changes minimal and composable",
+    "- run relevant tests and typecheck before final response",
+    "- summarize files changed and checks run"
+].join("\n\n");
+/**
+ * Executes the finalized ralph plan with codex-xhigh.
+ * Expects: planPath points to an existing plan markdown file.
+ */
+export async function ralphExecute(ctx, buildGoal, planPath) {
+    const projectPath = ctx.projectPath;
+    const planContent = await readFile(path.resolve(projectPath, planPath), "utf-8");
+    const result = await generate(ctx, executePromptTemplate, {
+        buildGoal: buildGoal.trim(),
+        planContent
+    }, {
+        progressMessage: text.inference_ralph_executing,
+        modelSelectionMode: "codex-xhigh",
+        writePolicy: {
+            mode: "write-whitelist",
+            writablePaths: [projectPath]
+        }
+    });
+    return {
+        provider: result.provider,
+        sessionId: result.sessionId,
+        text: result.text.trim()
+    };
+}
+//# sourceMappingURL=ralphExecute.js.map

package/dist/_workflows/steps/ralphExecute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphExecute.js","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphExecute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG1D,MAAM,qBAAqB,GAAG;IAC1B,oEAAoE;IACpE,qDAAqD;IACrD,iBAAiB;IACjB,kBAAkB;IAClB,0DAA0D;IAC1D,uCAAuC;IACvC,0DAA0D;IAC1D,0CAA0C;CAC7C,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEf;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,GAAY,EACZ,SAAiB,EACjB,QAAgB;IAEhB,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACpC,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,MAAM,QAAQ,CACzB,GAAG,EACH,qBAAqB,EACrB;QACI,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE;QAC3B,WAAW;KACd,EACD;QACI,eAAe,EAAE,IAAI,CAAC,yBAA0B;QAChD,kBAAkB,EAAE,aAAa;QACjC,WAAW,EAAE;YACT,IAAI,EAAE,iBAAiB;YACvB,aAAa,EAAE,CAAC,WAAW,CAAC;SAC/B;KACJ,CACJ,CAAC;IACF,OAAO;QACH,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;KAC3B,CAAC;AACN,CAAC"}

package/dist/_workflows/steps/ralphLoopExecute.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "@/types";
+/**
+ * Executes the generated ralph-loop plan using built-in inference.
+ * Expects: planPath points to an existing markdown plan file.
+ */
+export declare function ralphLoopExecute(ctx: Context, buildGoal: string, planPath: string): Promise<{
+    provider?: string;
+    sessionId?: string;
+    text: string;
+}>;
+//# sourceMappingURL=ralphLoopExecute.d.ts.map

package/dist/_workflows/steps/ralphLoopExecute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphLoopExecute.d.ts","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphLoopExecute.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAavC;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBlE"}

package/dist/_workflows/steps/ralphLoopExecute.js

@@ -0,0 +1,39 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { text } from "@text";
+import { generate } from "@/_workflows/steps/generate.js";
+const executePromptTemplate = [
+    "Implement this request in the current repository: {{buildGoal}}",
+    "Follow this plan exactly, then complete all pending implementation and test tasks:",
+    "{{planContent}}",
+    "Execution rules:",
+    "- apply code and test changes directly in the repository",
+    "- keep changes minimal and composable",
+    "- run relevant tests/typechecks before final response",
+    "- in final response, summarize what changed and what checks were run"
+].join("\n\n");
+/**
+ * Executes the generated ralph-loop plan using built-in inference.
+ * Expects: planPath points to an existing markdown plan file.
+ */
+export async function ralphLoopExecute(ctx, buildGoal, planPath) {
+    const projectPath = ctx.projectPath;
+    const planContent = await readFile(path.resolve(projectPath, planPath), "utf-8");
+    const result = await generate(ctx, executePromptTemplate, {
+        buildGoal: buildGoal.trim(),
+        planContent
+    }, {
+        progressMessage: text.inference_plan_executing,
+        modelSelectionMode: "codex-xhigh",
+        writePolicy: {
+            mode: "write-whitelist",
+            writablePaths: [projectPath]
+        }
+    });
+    return {
+        provider: result.provider,
+        sessionId: result.sessionId,
+        text: result.text.trim()
+    };
+}
+//# sourceMappingURL=ralphLoopExecute.js.map

package/dist/_workflows/steps/ralphLoopExecute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphLoopExecute.js","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphLoopExecute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG1D,MAAM,qBAAqB,GAAG;IAC1B,iEAAiE;IACjE,oFAAoF;IACpF,iBAAiB;IACjB,kBAAkB;IAClB,0DAA0D;IAC1D,uCAAuC;IACvC,uDAAuD;IACvD,sEAAsE;CACzE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEf;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,GAAY,EACZ,SAAiB,EACjB,QAAgB;IAEhB,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACpC,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,MAAM,QAAQ,CACzB,GAAG,EACH,qBAAqB,EACrB;QACI,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE;QAC3B,WAAW;KACd,EACD;QACI,eAAe,EAAE,IAAI,CAAC,wBAAyB;QAC/C,kBAAkB,EAAE,aAAa;QACjC,WAAW,EAAE;YACT,IAAI,EAAE,iBAAiB;YACvB,aAAa,EAAE,CAAC,WAAW,CAAC;SAC/B;KACJ,CACJ,CAAC;IACF,OAAO;QACH,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;KAC3B,CAAC;AACN,CAAC"}

package/dist/_workflows/steps/ralphLoopPlanGenerate.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from "@/types";
+export interface RalphLoopPlanGenerateOptions {
+    planPath?: string;
+}
+/**
+ * Generates a plan markdown file for ralph-loop via built-in inference.
+ * Expects: buildGoal is non-empty user intent and planPath is repo-relative when provided.
+ */
+export declare function ralphLoopPlanGenerate(ctx: Context, buildGoal: string, options?: RalphLoopPlanGenerateOptions): Promise<{
+    planPath: string;
+    provider?: string;
+    sessionId?: string;
+    text: string;
+}>;
+//# sourceMappingURL=ralphLoopPlanGenerate.d.ts.map

package/dist/_workflows/steps/ralphLoopPlanGenerate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphLoopPlanGenerate.d.ts","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphLoopPlanGenerate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,4BAA4B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD;;;GAGG;AACH,wBAAsB,qBAAqB,CACvC,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,4BAAiC,GAC3C,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCpF"}

package/dist/_workflows/steps/ralphLoopPlanGenerate.js

@@ -0,0 +1,46 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { text } from "@text";
+import { generate } from "@/_workflows/steps/generate.js";
+import { ralphLoopPlanPathResolve } from "@/_workflows/steps/ralphLoopPlanPathResolve.js";
+const planPromptTemplate = [
+    "Create a markdown implementation plan for this request: {{buildGoal}}",
+    "Output only the final plan markdown (no wrappers).",
+    "Plan requirements:",
+    "- include Overview",
+    "- include Validation Commands",
+    "- include Implementation Steps with checkbox tasks",
+    "- include test tasks for each code task",
+    "- keep steps concrete and scoped to this repository",
+    "- avoid placeholders like TBD"
+].join("\n");
+/**
+ * Generates a plan markdown file for ralph-loop via built-in inference.
+ * Expects: buildGoal is non-empty user intent and planPath is repo-relative when provided.
+ */
+export async function ralphLoopPlanGenerate(ctx, buildGoal, options = {}) {
+    const goal = buildGoal.trim();
+    if (!goal) {
+        throw new Error("Build goal is required.");
+    }
+    const planPath = options.planPath ?? ralphLoopPlanPathResolve(ctx, goal);
+    const result = await generate(ctx, planPromptTemplate, { buildGoal: goal }, {
+        progressMessage: text.inference_plan_generating,
+        modelSelectionMode: "codex-xhigh",
+        writePolicy: { mode: "read-only" }
+    });
+    const planText = result.text.trim();
+    if (!planText) {
+        throw new Error("Inference returned empty plan.");
+    }
+    const absolutePath = path.resolve(ctx.projectPath, planPath);
+    await mkdir(path.dirname(absolutePath), { recursive: true });
+    await writeFile(absolutePath, `${planText}\n`, "utf-8");
+    return {
+        planPath,
+        provider: result.provider,
+        sessionId: result.sessionId,
+        text: planText
+    };
+}
+//# sourceMappingURL=ralphLoopPlanGenerate.js.map

package/dist/_workflows/steps/ralphLoopPlanGenerate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphLoopPlanGenerate.js","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphLoopPlanGenerate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAO1F,MAAM,kBAAkB,GAAG;IACvB,uEAAuE;IACvE,oDAAoD;IACpD,oBAAoB;IACpB,oBAAoB;IACpB,+BAA+B;IAC/B,oDAAoD;IACpD,yCAAyC;IACzC,qDAAqD;IACrD,+BAA+B;CAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,GAAY,EACZ,SAAiB,EACjB,UAAwC,EAAE;IAE1C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,QAAQ,CACzB,GAAG,EACH,kBAAkB,EAClB,EAAE,SAAS,EAAE,IAAI,EAAE,EACnB;QACI,eAAe,EAAE,IAAI,CAAC,yBAA0B;QAChD,kBAAkB,EAAE,aAAa;QACjC,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;KACrC,CACJ,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7D,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,YAAY,EAAE,GAAG,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,OAAO;QACH,QAAQ;QACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,QAAQ;KACjB,CAAC;AACN,CAAC"}

package/dist/_workflows/steps/ralphLoopPlanPathResolve.d.ts

@@ -0,0 +1,7 @@
+import type { Context } from "@/types";
+/**
+ * Resolves a deterministic plan file path for ralph-loop.
+ * Expects: buildGoal is user-entered free text describing what to build.
+ */
+export declare function ralphLoopPlanPathResolve(_ctx: Context, buildGoal: string, nowMs?: number): string;
+//# sourceMappingURL=ralphLoopPlanPathResolve.d.ts.map

package/dist/_workflows/steps/ralphLoopPlanPathResolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphLoopPlanPathResolve.d.ts","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphLoopPlanPathResolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM,CAI7G"}

package/dist/_workflows/steps/ralphLoopPlanPathResolve.js

@@ -0,0 +1,21 @@
+/**
+ * Resolves a deterministic plan file path for ralph-loop.
+ * Expects: buildGoal is user-entered free text describing what to build.
+ */
+export function ralphLoopPlanPathResolve(_ctx, buildGoal, nowMs = Date.now()) {
+    const date = new Date(nowMs).toISOString().slice(0, 10).replace(/-/g, "");
+    const slug = ralphLoopSlugResolve(buildGoal);
+    return `doc/plans/${date}-${slug}.md`;
+}
+function ralphLoopSlugResolve(input) {
+    const base = input
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (!base) {
+        return "task";
+    }
+    return base.slice(0, 48).replace(/-+$/g, "") || "task";
+}
+//# sourceMappingURL=ralphLoopPlanPathResolve.js.map

package/dist/_workflows/steps/ralphLoopPlanPathResolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphLoopPlanPathResolve.js","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphLoopPlanPathResolve.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAa,EAAE,SAAiB,EAAE,QAAgB,IAAI,CAAC,GAAG,EAAE;IACjG,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,aAAa,IAAI,IAAI,IAAI,KAAK,CAAC;AAC1C,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACvC,MAAM,IAAI,GAAG,KAAK;SACb,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC;AAC3D,CAAC"}

package/dist/_workflows/steps/ralphLoopReviewRound.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "@/types";
+/**
+ * Runs one built-in-inference review round and applies fixes in-place.
+ * Expects: round is 1..3 and planPath points to an existing plan file.
+ */
+export declare function ralphLoopReviewRound(ctx: Context, round: number, planPath: string): Promise<{
+    provider?: string;
+    sessionId?: string;
+    text: string;
+}>;
+//# sourceMappingURL=ralphLoopReviewRound.d.ts.map

package/dist/_workflows/steps/ralphLoopReviewRound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphLoopReviewRound.d.ts","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphLoopReviewRound.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAavC;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BlE"}

package/dist/_workflows/steps/ralphLoopReviewRound.js

@@ -0,0 +1,42 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { textFormatKey } from "@text";
+import { generate } from "@/_workflows/steps/generate.js";
+const reviewPromptTemplate = [
+    "Run review round {{round}} of 3 for this implementation plan:",
+    "{{planContent}}",
+    "Review and fix workflow:",
+    "- inspect changed code for bugs, regressions, and missing tests",
+    "- apply necessary fixes directly in repository files",
+    "- keep scope aligned to the plan",
+    "- run relevant tests/typechecks",
+    "- respond with findings fixed and remaining risks"
+].join("\n\n");
+/**
+ * Runs one built-in-inference review round and applies fixes in-place.
+ * Expects: round is 1..3 and planPath points to an existing plan file.
+ */
+export async function ralphLoopReviewRound(ctx, round, planPath) {
+    if (round < 1 || round > 3) {
+        throw new Error(`Invalid review round: ${round}`);
+    }
+    const projectPath = ctx.projectPath;
+    const planContent = await readFile(path.resolve(projectPath, planPath), "utf-8");
+    const result = await generate(ctx, reviewPromptTemplate, {
+        round,
+        planContent
+    }, {
+        progressMessage: textFormatKey("inference_review_round", { round }),
+        modelSelectionMode: "codex-xhigh",
+        writePolicy: {
+            mode: "write-whitelist",
+            writablePaths: [projectPath]
+        }
+    });
+    return {
+        provider: result.provider,
+        sessionId: result.sessionId,
+        text: result.text.trim()
+    };
+}
+//# sourceMappingURL=ralphLoopReviewRound.js.map

package/dist/_workflows/steps/ralphLoopReviewRound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphLoopReviewRound.js","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphLoopReviewRound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG1D,MAAM,oBAAoB,GAAG;IACzB,+DAA+D;IAC/D,iBAAiB;IACjB,0BAA0B;IAC1B,iEAAiE;IACjE,sDAAsD;IACtD,kCAAkC;IAClC,iCAAiC;IACjC,mDAAmD;CACtD,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEf;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,GAAY,EACZ,KAAa,EACb,QAAgB;IAEhB,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACpC,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,MAAM,QAAQ,CACzB,GAAG,EACH,oBAAoB,EACpB;QACI,KAAK;QACL,WAAW;KACd,EACD;QACI,eAAe,EAAE,aAAa,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,CAAC;QACnE,kBAAkB,EAAE,aAAa;QACjC,WAAW,EAAE;YACT,IAAI,EAAE,iBAAiB;YACvB,aAAa,EAAE,CAAC,WAAW,CAAC;SAC/B;KACJ,CACJ,CAAC;IAEF,OAAO;QACH,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;KAC3B,CAAC;AACN,CAAC"}

package/dist/_workflows/steps/ralphPlan.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from "@/types";
+export interface RalphPlanOptions {
+    planPath?: string;
+}
+/**
+ * Runs an Opus planning loop with clarifying questions until user approval.
+ * Expects: buildGoal is non-empty and ctx.projectPath is writable for plan persistence.
+ */
+export declare function ralphPlan(ctx: Context, buildGoal: string, options?: RalphPlanOptions): Promise<{
+    planPath: string;
+    provider?: string;
+    sessionId?: string;
+    text: string;
+}>;
+//# sourceMappingURL=ralphPlan.d.ts.map

package/dist/_workflows/steps/ralphPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralphPlan.d.ts","sourceRoot":"","sources":["../../../sources/_workflows/steps/ralphPlan.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AA8BD;;;GAGG;AACH,wBAAsB,SAAS,CAC3B,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC/B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA8DpF"}