ralphy-spec 0.1.1 → 0.3.0

package/dist/cli/validate.js.map

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

package/dist/core/artifacts/budget-writer.d.ts

@@ -0,0 +1,11 @@
+export declare function writeBudgetReport(args: {
+    repoRoot: string;
+    rootDir?: string;
+    runId: string;
+    ledgerEvents: Array<{
+        taskId?: string;
+        kind: string;
+        data?: unknown;
+    }>;
+}): Promise<void>;
+//# sourceMappingURL=budget-writer.d.ts.map

package/dist/core/artifacts/budget-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-writer.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/budget-writer.ts"],"names":[],"mappings":"AAKA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACxE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB"}

package/dist/core/artifacts/budget-writer.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeBudgetReport = writeBudgetReport;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const folders_1 = require("../folders");
+const spend_1 = require("../reporting/spend");
+async function writeBudgetReport(args) {
+    const root = await (0, folders_1.ensureRalphyFolders)(args.repoRoot, args.rootDir);
+    const filePath = node_path_1.default.join(root, folders_1.FILES.budget);
+    const breakdown = (0, spend_1.aggregateSpend)((0, spend_1.extractSpendFromLedger)(args.ledgerEvents));
+    const md = [
+        `# BUDGET`,
+        ``,
+        `- **runId**: \`${args.runId}\``,
+        `- **updatedAt**: ${new Date().toISOString()}`,
+        ``,
+        (0, spend_1.formatSpendReport)(breakdown),
+        ``,
+        `> Note: spend is best-effort and depends on backend emitting usage. Today, wallTime/iterations are tracked; USD/tokens may be 0 for some backends.`,
+        ``,
+    ].join("\n");
+    await promises_1.default.writeFile(filePath, md, "utf8");
+}
+//# sourceMappingURL=budget-writer.js.map

package/dist/core/artifacts/budget-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-writer.js","sourceRoot":"","sources":["../../../src/core/artifacts/budget-writer.ts"],"names":[],"mappings":";;;;;AAKA,8CAuBC;AA5BD,gEAAkC;AAClC,0DAA6B;AAC7B,wCAAwD;AACxD,8CAA+F;AAExF,KAAK,UAAU,iBAAiB,CAAC,IAKvC;IACC,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAmB,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAK,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAG,IAAA,sBAAc,EAAC,IAAA,8BAAsB,EAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG;QACT,UAAU;QACV,EAAE;QACF,kBAAkB,IAAI,CAAC,KAAK,IAAI;QAChC,oBAAoB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QAC9C,EAAE;QACF,IAAA,yBAAiB,EAAC,SAAS,CAAC;QAC5B,EAAE;QACF,oJAAoJ;QACpJ,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/dist/core/artifacts/run-log-writer.d.ts

@@ -0,0 +1,20 @@
+export declare function writeRunLogOnce(args: {
+    repoRoot: string;
+    rootDir?: string;
+    runId: string;
+    outcome: {
+        ok: boolean;
+        exitCode?: number;
+        reason?: string;
+    };
+    ledgerEvents: Array<{
+        ts: string;
+        kind: string;
+        message: string;
+        taskId?: string;
+    }>;
+}): Promise<{
+    path: string;
+    created: boolean;
+}>;
+//# sourceMappingURL=run-log-writer.d.ts.map

package/dist/core/artifacts/run-log-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-log-writer.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/run-log-writer.ts"],"names":[],"mappings":"AAIA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrF,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA+B9C"}

package/dist/core/artifacts/run-log-writer.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeRunLogOnce = writeRunLogOnce;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const folders_1 = require("../folders");
+async function writeRunLogOnce(args) {
+    const root = await (0, folders_1.ensureRalphyFolders)(args.repoRoot, args.rootDir);
+    const filePath = node_path_1.default.join(root, folders_1.FOLDERS.runs, `${args.runId}.md`);
+    const lines = [];
+    lines.push(`# Run log`);
+    lines.push(``);
+    lines.push(`- **runId**: \`${args.runId}\``);
+    lines.push(`- **status**: ${args.outcome.ok ? "success" : "stopped"}`);
+    if (!args.outcome.ok) {
+        lines.push(`- **exitCode**: ${args.outcome.exitCode ?? "?"}`);
+        lines.push(`- **reason**: ${args.outcome.reason ?? "unknown"}`);
+    }
+    lines.push(`- **createdAt**: ${new Date().toISOString()}`);
+    lines.push(``);
+    lines.push(`## Ledger (chronological)`);
+    lines.push(``);
+    for (const ev of args.ledgerEvents) {
+        lines.push(`- ${ev.ts} ${ev.kind}${ev.taskId ? ` [${ev.taskId}]` : ""}: ${ev.message}`);
+    }
+    lines.push(``);
+    try {
+        await promises_1.default.writeFile(filePath, lines.join("\n"), { encoding: "utf8", flag: "wx" });
+        return { path: filePath, created: true };
+    }
+    catch (e) {
+        if (e?.code === "EEXIST")
+            return { path: filePath, created: false };
+        throw e;
+    }
+}
+//# sourceMappingURL=run-log-writer.js.map

package/dist/core/artifacts/run-log-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-log-writer.js","sourceRoot":"","sources":["../../../src/core/artifacts/run-log-writer.ts"],"names":[],"mappings":";;;;;AAIA,0CAqCC;AAzCD,gEAAkC;AAClC,0DAA6B;AAC7B,wCAA0D;AAEnD,KAAK,UAAU,eAAe,CAAC,IAMrC;IACC,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAmB,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAO,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;IAEnE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CACR,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,CAC5E,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,CAAC;QACH,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACpE,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}

package/dist/core/artifacts/run-log-writer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-log-writer.test.d.ts.map

package/dist/core/artifacts/run-log-writer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-log-writer.test.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/run-log-writer.test.ts"],"names":[],"mappings":""}

package/dist/core/artifacts/run-log-writer.test.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const run_log_writer_1 = require("./run-log-writer");
+const folders_1 = require("../folders");
+(0, vitest_1.describe)("writeRunLogOnce", () => {
+    (0, vitest_1.it)("creates the run log once and does not overwrite", async () => {
+        const repoRoot = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-runlog-"));
+        const runId = "run_test";
+        const first = await (0, run_log_writer_1.writeRunLogOnce)({
+            repoRoot,
+            runId,
+            outcome: { ok: true },
+            ledgerEvents: [{ ts: "t", kind: "run_started", message: "Run started" }],
+        });
+        const second = await (0, run_log_writer_1.writeRunLogOnce)({
+            repoRoot,
+            runId,
+            outcome: { ok: false, exitCode: 4, reason: "nope" },
+            ledgerEvents: [{ ts: "t2", kind: "run_error", message: "error" }],
+        });
+        (0, vitest_1.expect)(first.created).toBe(true);
+        (0, vitest_1.expect)(second.created).toBe(false);
+        const p = node_path_1.default.join((0, folders_1.getRalphyRoot)(repoRoot), folders_1.FOLDERS.runs, `${runId}.md`);
+        const md = await promises_1.default.readFile(p, "utf8");
+        (0, vitest_1.expect)(md).toContain("# Run log");
+        (0, vitest_1.expect)(md).toContain("run_started");
+        (0, vitest_1.expect)(md).not.toContain("run_error");
+    });
+});
+//# sourceMappingURL=run-log-writer.test.js.map

package/dist/core/artifacts/run-log-writer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-log-writer.test.js","sourceRoot":"","sources":["../../../src/core/artifacts/run-log-writer.test.ts"],"names":[],"mappings":";;;;;AAAA,mCAA8C;AAC9C,gEAAkC;AAClC,sDAAyB;AACzB,0DAA6B;AAC7B,qDAAmD;AACnD,wCAAoD;AAEpD,IAAA,iBAAQ,EAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAA,WAAE,EAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,QAAQ,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,mBAAI,CAAC,IAAI,CAAC,iBAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,UAAU,CAAC;QAEzB,MAAM,KAAK,GAAG,MAAM,IAAA,gCAAe,EAAC;YAClC,QAAQ;YACR,KAAK;YACL,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;YACrB,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;SACzE,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAe,EAAC;YACnC,QAAQ;YACR,KAAK;YACL,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE;YACnD,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;SAClE,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEnC,MAAM,CAAC,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAA,uBAAa,EAAC,QAAQ,CAAC,EAAE,iBAAO,CAAC,IAAI,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC;QAC1E,MAAM,EAAE,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACxC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAClC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACpC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/artifacts/status-writer.d.ts

@@ -0,0 +1,16 @@
+import type { BudgetStatus } from "../budgets/tiers";
+export type StatusWriterInput = {
+    repoRoot: string;
+    rootDir?: string;
+    runId: string;
+    backendId?: string;
+    workspaceMode?: string;
+    phase: string;
+    taskId?: string;
+    iteration?: number;
+    message?: string;
+    tier?: "optimal" | "warning" | "hard";
+    budgetStatus?: BudgetStatus | null;
+};
+export declare function writeStatus(input: StatusWriterInput): Promise<void>;
+//# sourceMappingURL=status-writer.d.ts.map

package/dist/core/artifacts/status-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-writer.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/status-writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACtC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC,CAAC;AAEF,wBAAsB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCzE"}

package/dist/core/artifacts/status-writer.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeStatus = writeStatus;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const folders_1 = require("../folders");
+async function writeStatus(input) {
+    const root = await (0, folders_1.ensureRalphyFolders)(input.repoRoot, input.rootDir);
+    const filePath = node_path_1.default.join(root, folders_1.FILES.status);
+    const lines = [];
+    lines.push(`# STATUS`);
+    lines.push(``);
+    lines.push(`- **runId**: \`${input.runId}\``);
+    if (input.backendId)
+        lines.push(`- **backend**: ${input.backendId}`);
+    if (input.workspaceMode)
+        lines.push(`- **workspace**: ${input.workspaceMode}`);
+    if (input.taskId)
+        lines.push(`- **taskId**: \`${input.taskId}\``);
+    lines.push(`- **phase**: ${input.phase}`);
+    if (typeof input.iteration === "number")
+        lines.push(`- **iteration**: ${input.iteration}`);
+    if (input.tier)
+        lines.push(`- **tier**: ${input.tier}`);
+    lines.push(`- **updatedAt**: ${new Date().toISOString()}`);
+    lines.push(``);
+    if (input.message) {
+        lines.push(`## Message`);
+        lines.push(``);
+        lines.push(input.message);
+        lines.push(``);
+    }
+    if (input.budgetStatus) {
+        const s = input.budgetStatus;
+        lines.push(`## Budget`);
+        lines.push(``);
+        lines.push(`- used: $${s.usedUsd.toFixed(4)}, ${s.usedTokens.toLocaleString()} tokens, ${s.usedIterations} iterations`);
+        lines.push(`- tier: ${s.tier}${s.isAtHardCap ? " (HARD CAP)" : ""}`);
+        lines.push(``);
+    }
+    lines.push(`## Files`);
+    lines.push(``);
+    lines.push(`- root: \`${(0, folders_1.getRalphyRoot)(input.repoRoot, input.rootDir)}\``);
+    lines.push(`- runs: \`runs/<runId>.md\` (immutable on completion)`);
+    lines.push(`- tasks: \`tasks/<taskId>/\` (CONTEXT.md / REPAIR.md / NOTES.md)`);
+    lines.push(``);
+    await promises_1.default.writeFile(filePath, lines.join("\n"), "utf8");
+}
+//# sourceMappingURL=status-writer.js.map

package/dist/core/artifacts/status-writer.js.map

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

package/dist/core/artifacts/status-writer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=status-writer.test.d.ts.map

package/dist/core/artifacts/status-writer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-writer.test.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/status-writer.test.ts"],"names":[],"mappings":""}

package/dist/core/artifacts/status-writer.test.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const status_writer_1 = require("./status-writer");
+const folders_1 = require("../folders");
+(0, vitest_1.describe)("writeStatus", () => {
+    (0, vitest_1.it)("includes backend/workspace and budget when provided", async () => {
+        const repoRoot = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-status-"));
+        await (0, status_writer_1.writeStatus)({
+            repoRoot,
+            runId: "run_1",
+            backendId: "noop",
+            workspaceMode: "patch",
+            phase: "EXEC",
+            taskId: "t1",
+            iteration: 2,
+            tier: "warning",
+            budgetStatus: {
+                tier: "warning",
+                usedUsd: 1.23,
+                usedTokens: 100,
+                usedTimeMs: 1000,
+                usedIterations: 2,
+                usdPctOfOptimal: null,
+                usdPctOfHard: null,
+                tokensPctOfOptimal: null,
+                tokensPctOfHard: null,
+                timePctOfOptimal: null,
+                timePctOfHard: null,
+                isInWarning: true,
+                isAtHardCap: false,
+            },
+        });
+        const p = node_path_1.default.join((0, folders_1.getRalphyRoot)(repoRoot), folders_1.FILES.status);
+        const md = await promises_1.default.readFile(p, "utf8");
+        (0, vitest_1.expect)(md).toContain("**backend**");
+        (0, vitest_1.expect)(md).toContain("**workspace**");
+        (0, vitest_1.expect)(md).toContain("## Budget");
+    });
+});
+//# sourceMappingURL=status-writer.test.js.map

package/dist/core/artifacts/status-writer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-writer.test.js","sourceRoot":"","sources":["../../../src/core/artifacts/status-writer.test.ts"],"names":[],"mappings":";;;;;AAAA,mCAA8C;AAC9C,gEAAkC;AAClC,sDAAyB;AACzB,0DAA6B;AAC7B,mDAA8C;AAC9C,wCAAkD;AAElD,IAAA,iBAAQ,EAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAA,WAAE,EAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,QAAQ,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,mBAAI,CAAC,IAAI,CAAC,iBAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC5E,MAAM,IAAA,2BAAW,EAAC;YAChB,QAAQ;YACR,KAAK,EAAE,OAAO;YACd,SAAS,EAAE,MAAM;YACjB,aAAa,EAAE,OAAO;YACtB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,IAAI;gBAChB,cAAc,EAAE,CAAC;gBACjB,eAAe,EAAE,IAAI;gBACrB,YAAY,EAAE,IAAI;gBAClB,kBAAkB,EAAE,IAAI;gBACxB,eAAe,EAAE,IAAI;gBACrB,gBAAgB,EAAE,IAAI;gBACtB,aAAa,EAAE,IAAI;gBACnB,WAAW,EAAE,IAAI;gBACjB,WAAW,EAAE,KAAK;aACnB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAA,uBAAa,EAAC,QAAQ,CAAC,EAAE,eAAK,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,EAAE,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACxC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACpC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACtC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/artifacts/task-artifacts.d.ts

@@ -0,0 +1,19 @@
+export declare function writeTaskContext(args: {
+    repoRoot: string;
+    rootDir?: string;
+    taskId: string;
+    markdown: string;
+}): Promise<void>;
+export declare function writeTaskRepair(args: {
+    repoRoot: string;
+    rootDir?: string;
+    taskId: string;
+    markdown: string;
+}): Promise<void>;
+export declare function appendTaskNotes(args: {
+    repoRoot: string;
+    rootDir?: string;
+    taskId: string;
+    note: string;
+}): Promise<void>;
+//# sourceMappingURL=task-artifacts.d.ts.map

package/dist/core/artifacts/task-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-artifacts.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/task-artifacts.ts"],"names":[],"mappings":"AAeA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}

package/dist/core/artifacts/task-artifacts.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeTaskContext = writeTaskContext;
+exports.writeTaskRepair = writeTaskRepair;
+exports.appendTaskNotes = appendTaskNotes;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const folders_1 = require("../folders");
+function safeTaskDirName(taskId) {
+    return taskId.replace(/[^a-zA-Z0-9-_]/g, "_");
+}
+async function ensureTaskDir(repoRoot, rootDir, taskId) {
+    const root = await (0, folders_1.ensureRalphyFolders)(repoRoot, rootDir);
+    const dir = node_path_1.default.join(root, folders_1.FOLDERS.tasks, safeTaskDirName(taskId));
+    await promises_1.default.mkdir(dir, { recursive: true });
+    return dir;
+}
+async function writeTaskContext(args) {
+    const dir = await ensureTaskDir(args.repoRoot, args.rootDir, args.taskId);
+    await promises_1.default.writeFile(node_path_1.default.join(dir, "CONTEXT.md"), args.markdown, "utf8");
+}
+async function writeTaskRepair(args) {
+    const dir = await ensureTaskDir(args.repoRoot, args.rootDir, args.taskId);
+    await promises_1.default.writeFile(node_path_1.default.join(dir, "REPAIR.md"), args.markdown, "utf8");
+}
+async function appendTaskNotes(args) {
+    const dir = await ensureTaskDir(args.repoRoot, args.rootDir, args.taskId);
+    const p = node_path_1.default.join(dir, "NOTES.md");
+    const line = `- ${new Date().toISOString()} ${args.note}\n`;
+    await promises_1.default.appendFile(p, line, "utf8").catch(async () => promises_1.default.writeFile(p, line, "utf8"));
+}
+//# sourceMappingURL=task-artifacts.js.map

package/dist/core/artifacts/task-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-artifacts.js","sourceRoot":"","sources":["../../../src/core/artifacts/task-artifacts.ts"],"names":[],"mappings":";;;;;AAeA,4CAQC;AAED,0CAQC;AAED,0CAUC;AA7CD,gEAAkC;AAClC,0DAA6B;AAC7B,wCAA0D;AAE1D,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,OAA2B,EAAE,MAAc;IACxF,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAmB,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAO,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,MAAM,kBAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC;AACb,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,IAKtC;IACC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,kBAAE,CAAC,SAAS,CAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,IAKrC;IACC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,kBAAE,CAAC,SAAS,CAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,IAKrC;IACC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,CAAC,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;IAC5D,MAAM,kBAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,kBAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/core/artifacts/tasks-writer.d.ts

@@ -0,0 +1,19 @@
+import type { TaskSpec } from "../spec/types";
+import type { TaskStatus } from "../memory/persistence";
+export type StatusIconMode = "emoji" | "ascii" | "none";
+export type TaskRow = {
+    taskId: string;
+    status: TaskStatus;
+    phase?: string;
+    iteration: number;
+    lastError?: string;
+};
+export declare function writeTasksBoard(args: {
+    repoRoot: string;
+    rootDir?: string;
+    runId: string;
+    statusIcons?: StatusIconMode;
+    specTasks: TaskSpec[];
+    rows: TaskRow[];
+}): Promise<void>;
+//# sourceMappingURL=tasks-writer.d.ts.map

package/dist/core/artifacts/tasks-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-writer.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/tasks-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAkBxD,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4ChB"}

package/dist/core/artifacts/tasks-writer.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeTasksBoard = writeTasksBoard;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const folders_1 = require("../folders");
+const STATUS_ICON_EMOJI = {
+    pending: "⬜",
+    running: "⏳",
+    done: "✅",
+    blocked: "⛔",
+    error: "❌",
+};
+const STATUS_ICON_ASCII = {
+    pending: "[ ]",
+    running: "[~]",
+    done: "[x]",
+    blocked: "[!]",
+    error: "[x!]",
+};
+async function writeTasksBoard(args) {
+    const root = await (0, folders_1.ensureRalphyFolders)(args.repoRoot, args.rootDir);
+    const filePath = node_path_1.default.join(root, folders_1.FILES.tasks);
+    const titleById = new Map(args.specTasks.map((t) => [t.id, t.title]));
+    const goalById = new Map(args.specTasks.map((t) => [t.id, t.goal]));
+    const lines = [];
+    lines.push(`# TASKS`);
+    lines.push(``);
+    lines.push(`- **runId**: \`${args.runId}\``);
+    lines.push(`- **updatedAt**: ${new Date().toISOString()}`);
+    lines.push(``);
+    lines.push(`| Task | Status | Phase | Iter | Title |`);
+    lines.push(`|------|--------|-------|------|-------|`);
+    for (const r of args.rows) {
+        const mode = args.statusIcons ?? "emoji";
+        const icon = mode === "none"
+            ? ""
+            : (mode === "ascii" ? STATUS_ICON_ASCII : STATUS_ICON_EMOJI)[r.status] ?? "";
+        const title = titleById.get(r.taskId) ?? "";
+        const statusCell = `${icon ? `${icon} ` : ""}${r.status}`;
+        lines.push(`| \`${r.taskId}\` | ${statusCell} | ${r.phase ?? ""} | ${r.iteration} | ${escapePipes(title)} |`);
+    }
+    lines.push(``);
+    // Optional details for blocked/error tasks.
+    const trouble = args.rows.filter((r) => r.status === "blocked" || r.status === "error");
+    if (trouble.length) {
+        lines.push(`## Attention`);
+        lines.push(``);
+        for (const r of trouble) {
+            lines.push(`### ${r.taskId}`);
+            const goal = goalById.get(r.taskId);
+            if (goal)
+                lines.push(goal.trim());
+            if (r.lastError)
+                lines.push(`\nLast error: ${r.lastError}`);
+            lines.push(``);
+        }
+    }
+    await promises_1.default.writeFile(filePath, lines.join("\n"), "utf8");
+}
+function escapePipes(s) {
+    return s.replace(/\|/g, "\\|");
+}
+//# sourceMappingURL=tasks-writer.js.map

package/dist/core/artifacts/tasks-writer.js.map

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

package/dist/core/artifacts/tasks-writer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tasks-writer.test.d.ts.map

package/dist/core/artifacts/tasks-writer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-writer.test.d.ts","sourceRoot":"","sources":["../../../src/core/artifacts/tasks-writer.test.ts"],"names":[],"mappings":""}

package/dist/core/artifacts/tasks-writer.test.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const tasks_writer_1 = require("./tasks-writer");
+const folders_1 = require("../folders");
+(0, vitest_1.describe)("writeTasksBoard", () => {
+    (0, vitest_1.it)("writes TASKS.md with configurable icon mode", async () => {
+        const repoRoot = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "ralphy-artifacts-"));
+        await (0, tasks_writer_1.writeTasksBoard)({
+            repoRoot,
+            runId: "run_1",
+            statusIcons: "ascii",
+            specTasks: [{ id: "t1", title: "Hello" }],
+            rows: [{ taskId: "t1", status: "running", iteration: 2 }],
+        });
+        const tasksPath = node_path_1.default.join((0, folders_1.getRalphyRoot)(repoRoot), folders_1.FILES.tasks);
+        const md = await promises_1.default.readFile(tasksPath, "utf8");
+        (0, vitest_1.expect)(md).toContain("# TASKS");
+        (0, vitest_1.expect)(md).toContain("[~] running");
+    });
+});
+//# sourceMappingURL=tasks-writer.test.js.map

package/dist/core/artifacts/tasks-writer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-writer.test.js","sourceRoot":"","sources":["../../../src/core/artifacts/tasks-writer.test.ts"],"names":[],"mappings":";;;;;AAAA,mCAA8C;AAC9C,gEAAkC;AAClC,sDAAyB;AACzB,0DAA6B;AAC7B,iDAAiD;AACjD,wCAAkD;AAElD,IAAA,iBAAQ,EAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAA,WAAE,EAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,QAAQ,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,mBAAI,CAAC,IAAI,CAAC,iBAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;QAC/E,MAAM,IAAA,8BAAe,EAAC;YACpB,QAAQ;YACR,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,OAAO;YACpB,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAS,CAAC;YAChD,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;SAC1D,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAA,uBAAa,EAAC,QAAQ,CAAC,EAAE,eAAK,CAAC,KAAK,CAAC,CAAC;QAClE,MAAM,EAAE,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChD,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAChC,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/backends/claude-code.d.ts

@@ -0,0 +1,17 @@
+import type { BackendEnv, CodingBackend, ImplementInput, ImplementOutput } from "./types";
+/**
+ * ClaudeCodeBackend shells out to the `claude` CLI for code implementation.
+ *
+ * Claude Code (Anthropic's coding assistant) supports headless operation
+ * via the claude CLI with --print or --output-format json flags.
+ */
+export declare class ClaudeCodeBackend implements CodingBackend {
+    private readonly opts;
+    readonly id = "claude-code";
+    constructor(opts?: {
+        timeoutMs?: number;
+    });
+    implement(env: BackendEnv, input: ImplementInput): Promise<ImplementOutput>;
+    private buildPrompt;
+}
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/core/backends/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/core/backends/claude-code.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1F;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAGzC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,EAAE,iBAAiB;gBAEC,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAExD,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgDjF,OAAO,CAAC,WAAW;CA0BpB"}