@damian87/omp 0.1.0

package/dist/src/mcp/tools/shared-memory.js

@@ -0,0 +1,148 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { jsonResult } from "../types.js";
+function smDir(cwd) {
+    return join(resolve(cwd), ".omp", "shared-memory");
+}
+function smPath(cwd, key) {
+    if (!/^[\w.-]+$/.test(key))
+        throw new Error(`invalid key: ${key}`);
+    return join(smDir(cwd), `${key}.json`);
+}
+function atomicWrite(path, value) {
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, JSON.stringify(value, null, 2), "utf8");
+    renameSync(tmp, path);
+}
+export const sharedMemoryTools = [
+    {
+        name: "shared_memory_write",
+        category: "shared_memory",
+        description: "Write a shared-memory entry. Optional TTL in seconds.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                key: { type: "string" },
+                value: {},
+                ttlSeconds: { type: "number" },
+                cwd: { type: "string" },
+            },
+            required: ["key", "value"],
+        },
+        handler: (args) => {
+            const cwd = args.cwd ?? process.cwd();
+            const ttl = typeof args.ttlSeconds === "number" ? args.ttlSeconds : undefined;
+            const entry = {
+                value: args.value,
+                writtenAt: new Date().toISOString(),
+                expiresAt: ttl != null ? new Date(Date.now() + ttl * 1000).toISOString() : undefined,
+            };
+            atomicWrite(smPath(cwd, args.key), entry);
+            return jsonResult({ ok: true, expiresAt: entry.expiresAt });
+        },
+    },
+    {
+        name: "shared_memory_read",
+        category: "shared_memory",
+        description: "Read a shared-memory entry. Returns null if missing or expired.",
+        inputSchema: {
+            type: "object",
+            properties: { key: { type: "string" }, cwd: { type: "string" } },
+            required: ["key"],
+        },
+        handler: (args) => {
+            const cwd = args.cwd ?? process.cwd();
+            const path = smPath(cwd, args.key);
+            if (!existsSync(path))
+                return jsonResult({ value: null });
+            try {
+                const entry = JSON.parse(readFileSync(path, "utf8"));
+                if (entry.expiresAt && Date.parse(entry.expiresAt) < Date.now()) {
+                    unlinkSync(path);
+                    return jsonResult({ value: null, expired: true });
+                }
+                return jsonResult({ value: entry.value, writtenAt: entry.writtenAt, expiresAt: entry.expiresAt });
+            }
+            catch {
+                return jsonResult({ value: null });
+            }
+        },
+    },
+    {
+        name: "shared_memory_list",
+        category: "shared_memory",
+        description: "List shared-memory keys (excluding expired entries).",
+        inputSchema: { type: "object", properties: { cwd: { type: "string" } } },
+        handler: (args) => {
+            const cwd = args.cwd ?? process.cwd();
+            const dir = smDir(cwd);
+            if (!existsSync(dir))
+                return jsonResult({ keys: [] });
+            const now = Date.now();
+            const keys = [];
+            for (const file of readdirSync(dir)) {
+                if (!file.endsWith(".json"))
+                    continue;
+                try {
+                    const entry = JSON.parse(readFileSync(join(dir, file), "utf8"));
+                    if (entry.expiresAt && Date.parse(entry.expiresAt) < now)
+                        continue;
+                    keys.push(file.replace(/\.json$/, ""));
+                }
+                catch {
+                    // skip unparseable
+                }
+            }
+            return jsonResult({ keys: keys.sort() });
+        },
+    },
+    {
+        name: "shared_memory_delete",
+        category: "shared_memory",
+        description: "Delete a shared-memory entry.",
+        inputSchema: {
+            type: "object",
+            properties: { key: { type: "string" }, cwd: { type: "string" } },
+            required: ["key"],
+        },
+        handler: (args) => {
+            const cwd = args.cwd ?? process.cwd();
+            const path = smPath(cwd, args.key);
+            if (existsSync(path))
+                unlinkSync(path);
+            return jsonResult({ ok: true });
+        },
+    },
+    {
+        name: "shared_memory_cleanup",
+        category: "shared_memory",
+        description: "Delete all expired shared-memory entries.",
+        inputSchema: { type: "object", properties: { cwd: { type: "string" } } },
+        handler: (args) => {
+            const cwd = args.cwd ?? process.cwd();
+            const dir = smDir(cwd);
+            if (!existsSync(dir))
+                return jsonResult({ deleted: 0 });
+            const now = Date.now();
+            let deleted = 0;
+            for (const file of readdirSync(dir)) {
+                if (!file.endsWith(".json"))
+                    continue;
+                const path = join(dir, file);
+                try {
+                    const entry = JSON.parse(readFileSync(path, "utf8"));
+                    if (entry.expiresAt && Date.parse(entry.expiresAt) < now) {
+                        unlinkSync(path);
+                        deleted++;
+                    }
+                }
+                catch {
+                    // skip
+                }
+            }
+            return jsonResult({ deleted });
+        },
+    },
+];
+//# sourceMappingURL=shared-memory.js.map

package/dist/src/mcp/tools/shared-memory.js.map

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

package/dist/src/mcp/tools/state.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDefinition } from "../types.js";
+export declare const stateTools: ToolDefinition[];

package/dist/src/mcp/tools/state.js

@@ -0,0 +1,107 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { jsonResult } from "../types.js";
+function stateDir(cwd) {
+    return join(resolve(cwd), ".omp", "state", "kv");
+}
+function statePath(cwd, key) {
+    if (!/^[\w.-]+$/.test(key))
+        throw new Error(`invalid key: ${key}`);
+    return join(stateDir(cwd), `${key}.json`);
+}
+function atomicWriteJson(path, value) {
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, JSON.stringify(value, null, 2), "utf8");
+    renameSync(tmp, path);
+}
+export const stateTools = [
+    {
+        name: "state_read",
+        category: "state",
+        description: "Read a key-value entry from .omp/state/kv/<key>.json.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                key: { type: "string", description: "Key name (letters, digits, ., -, _)." },
+                cwd: { type: "string", description: "Optional working directory." },
+            },
+            required: ["key"],
+        },
+        handler: (args) => {
+            const path = statePath(args.cwd ?? process.cwd(), args.key);
+            if (!existsSync(path))
+                return jsonResult({ value: null });
+            return jsonResult({ value: JSON.parse(readFileSync(path, "utf8")) });
+        },
+    },
+    {
+        name: "state_write",
+        category: "state",
+        description: "Write a key-value entry to .omp/state/kv/<key>.json (atomic).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                key: { type: "string" },
+                value: {},
+                cwd: { type: "string" },
+            },
+            required: ["key", "value"],
+        },
+        handler: (args) => {
+            const path = statePath(args.cwd ?? process.cwd(), args.key);
+            atomicWriteJson(path, args.value);
+            return jsonResult({ ok: true, path });
+        },
+    },
+    {
+        name: "state_clear",
+        category: "state",
+        description: "Delete a key-value entry.",
+        inputSchema: {
+            type: "object",
+            properties: { key: { type: "string" }, cwd: { type: "string" } },
+            required: ["key"],
+        },
+        handler: (args) => {
+            const path = statePath(args.cwd ?? process.cwd(), args.key);
+            if (existsSync(path))
+                unlinkSync(path);
+            return jsonResult({ ok: true });
+        },
+    },
+    {
+        name: "state_list_active",
+        category: "state",
+        description: "List all active state keys under .omp/state/kv/.",
+        inputSchema: { type: "object", properties: { cwd: { type: "string" } } },
+        handler: (args) => {
+            const dir = stateDir(args.cwd ?? process.cwd());
+            if (!existsSync(dir))
+                return jsonResult({ keys: [] });
+            const keys = readdirSync(dir)
+                .filter((f) => f.endsWith(".json"))
+                .map((f) => f.replace(/\.json$/, ""))
+                .sort();
+            return jsonResult({ keys });
+        },
+    },
+    {
+        name: "state_get_status",
+        category: "state",
+        description: "Get existence + mtime for a single state key.",
+        inputSchema: {
+            type: "object",
+            properties: { key: { type: "string" }, cwd: { type: "string" } },
+            required: ["key"],
+        },
+        handler: (args) => {
+            const path = statePath(args.cwd ?? process.cwd(), args.key);
+            if (!existsSync(path))
+                return jsonResult({ exists: false });
+            const stats = statSync(path);
+            return jsonResult({ exists: true, mtime: stats.mtime.toISOString(), bytes: stats.size });
+        },
+    },
+];
+//# sourceMappingURL=state.js.map

package/dist/src/mcp/tools/state.js.map

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

package/dist/src/mcp/tools/trace.d.ts

@@ -0,0 +1,10 @@
+import { type ToolDefinition } from "../types.js";
+interface TraceEntry {
+    ts: string;
+    sessionId?: string;
+    event?: string;
+    payload?: unknown;
+}
+export declare function appendTraceEntry(cwd: string, sessionId: string, entry: Omit<TraceEntry, "ts" | "sessionId">): void;
+export declare const traceTools: ToolDefinition[];
+export {};

package/dist/src/mcp/tools/trace.js

@@ -0,0 +1,102 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { jsonResult } from "../types.js";
+function traceDir(cwd) {
+    return join(resolve(cwd), ".omp", "state", "trace");
+}
+function tracePath(cwd, sessionId) {
+    if (!/^[\w.-]+$/.test(sessionId))
+        throw new Error(`invalid sessionId: ${sessionId}`);
+    return join(traceDir(cwd), `${sessionId}.jsonl`);
+}
+export function appendTraceEntry(cwd, sessionId, entry) {
+    const path = tracePath(cwd, sessionId);
+    mkdirSync(dirname(path), { recursive: true });
+    appendFileSync(path, `${JSON.stringify({ ts: new Date().toISOString(), sessionId, ...entry })}\n`, "utf8");
+}
+function readEntries(path) {
+    if (!existsSync(path))
+        return [];
+    return readFileSync(path, "utf8")
+        .split("\n")
+        .filter((l) => l.trim().length > 0)
+        .map((l) => {
+        try {
+            return JSON.parse(l);
+        }
+        catch {
+            return undefined;
+        }
+    })
+        .filter((e) => Boolean(e));
+}
+function pickSessionId(cwd, sessionId) {
+    if (sessionId)
+        return sessionId;
+    const dir = traceDir(cwd);
+    if (!existsSync(dir))
+        return undefined;
+    const files = readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
+    if (files.length === 0)
+        return undefined;
+    // pick most recently modified
+    return files
+        .map((f) => ({ name: f.replace(/\.jsonl$/, ""), path: join(dir, f) }))
+        .sort((a, b) => {
+        try {
+            const ai = Number(require("node:fs").statSync(a.path).mtimeMs);
+            const bi = Number(require("node:fs").statSync(b.path).mtimeMs);
+            return bi - ai;
+        }
+        catch {
+            return 0;
+        }
+    })[0]?.name;
+}
+export const traceTools = [
+    {
+        name: "trace_timeline",
+        category: "trace",
+        description: "Read the last N entries of a session trace (default 50). Defaults to the most recently active session.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                sessionId: { type: "string" },
+                limit: { type: "number" },
+                cwd: { type: "string" },
+            },
+        },
+        handler: (args) => {
+            const cwd = args.cwd ?? process.cwd();
+            const sessionId = pickSessionId(cwd, args.sessionId);
+            if (!sessionId)
+                return jsonResult({ entries: [] });
+            const limit = typeof args.limit === "number" ? Math.max(1, args.limit) : 50;
+            const all = readEntries(tracePath(cwd, sessionId));
+            return jsonResult({ sessionId, entries: all.slice(-limit) });
+        },
+    },
+    {
+        name: "trace_summary",
+        category: "trace",
+        description: "Summarise a session trace as event-name counts.",
+        inputSchema: {
+            type: "object",
+            properties: { sessionId: { type: "string" }, cwd: { type: "string" } },
+        },
+        handler: (args) => {
+            const cwd = args.cwd ?? process.cwd();
+            const sessionId = pickSessionId(cwd, args.sessionId);
+            if (!sessionId)
+                return jsonResult({ counts: {} });
+            const entries = readEntries(tracePath(cwd, sessionId));
+            const counts = {};
+            for (const e of entries) {
+                const key = e.event ?? "unknown";
+                counts[key] = (counts[key] ?? 0) + 1;
+            }
+            return jsonResult({ sessionId, total: entries.length, counts });
+        },
+    },
+];
+//# sourceMappingURL=trace.js.map

package/dist/src/mcp/tools/trace.js.map

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

package/dist/src/mcp/types.d.ts

@@ -0,0 +1,29 @@
+export interface JsonSchema {
+    type: string;
+    properties?: Record<string, JsonSchema | {
+        type: string;
+        description?: string;
+        enum?: readonly string[];
+    }>;
+    required?: string[];
+    description?: string;
+    items?: JsonSchema;
+    additionalProperties?: boolean;
+}
+export interface ToolContent {
+    type: "text";
+    text: string;
+}
+export interface ToolResult {
+    content: ToolContent[];
+    isError?: boolean;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    category: string;
+    inputSchema: JsonSchema;
+    handler: (args: Record<string, unknown>) => Promise<ToolResult> | ToolResult;
+}
+export declare function textResult(text: string, isError?: boolean): ToolResult;
+export declare function jsonResult(value: unknown, isError?: boolean): ToolResult;

package/dist/src/mcp/types.js

@@ -0,0 +1,7 @@
+export function textResult(text, isError = false) {
+    return { content: [{ type: "text", text }], isError };
+}
+export function jsonResult(value, isError = false) {
+    return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }], isError };
+}
+//# sourceMappingURL=types.js.map

package/dist/src/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp/types.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAO,GAAG,KAAK;IACtD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,OAAO,GAAG,KAAK;IACxD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AACxF,CAAC"}

package/dist/src/mode-state/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./paths.js";
+export * from "./ralph.js";
+export * from "./ultrawork.js";
+export * from "./ultraqa.js";

package/dist/src/mode-state/index.js

@@ -0,0 +1,5 @@
+export * from "./paths.js";
+export * from "./ralph.js";
+export * from "./ultrawork.js";
+export * from "./ultraqa.js";
+//# sourceMappingURL=index.js.map

package/dist/src/mode-state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mode-state/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/src/mode-state/paths.d.ts

@@ -0,0 +1,5 @@
+export type LoopMode = "ralph" | "ultrawork" | "ultraqa";
+export declare function modeStatePath(cwd: string, mode: LoopMode): string;
+export declare function readModeStateJson<T>(cwd: string, mode: LoopMode): T | undefined;
+export declare function writeModeStateJson<T>(cwd: string, mode: LoopMode, value: T): void;
+export declare function clearModeState(cwd: string, mode: LoopMode): void;

package/dist/src/mode-state/paths.js

@@ -0,0 +1,29 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+export function modeStatePath(cwd, mode) {
+    return join(resolve(cwd), ".omp", "state", `${mode}.json`);
+}
+export function readModeStateJson(cwd, mode) {
+    const p = modeStatePath(cwd, mode);
+    if (!existsSync(p))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(p, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function writeModeStateJson(cwd, mode, value) {
+    const p = modeStatePath(cwd, mode);
+    mkdirSync(dirname(p), { recursive: true });
+    const tmp = `${p}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, JSON.stringify(value, null, 2), "utf8");
+    renameSync(tmp, p);
+}
+export function clearModeState(cwd, mode) {
+    const p = modeStatePath(cwd, mode);
+    if (existsSync(p))
+        unlinkSync(p);
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/mode-state/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/mode-state/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAInD,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,IAAc;IACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAI,GAAW,EAAE,IAAc;IAC9D,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAM,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAI,GAAW,EAAE,IAAc,EAAE,KAAQ;IACzE,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACpD,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3D,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,IAAc;IACxD,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,UAAU,CAAC,CAAC,CAAC;QAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/src/mode-state/ralph.d.ts

@@ -0,0 +1,25 @@
+export interface RalphState {
+    active: boolean;
+    iteration: number;
+    maxIterations: number;
+    startedAt: string;
+    prompt: string;
+    sessionId?: string;
+    projectPath: string;
+}
+export interface StartRalphOptions {
+    cwd?: string;
+    prompt: string;
+    sessionId?: string;
+    maxIterations?: number;
+}
+export declare function startRalph(opts: StartRalphOptions): RalphState;
+export declare function readRalph(cwd?: string): RalphState | undefined;
+export declare function cancelRalph(cwd?: string): void;
+export interface RalphTickResult {
+    ok: boolean;
+    state?: RalphState;
+    reason?: string;
+}
+export declare function tickRalph(cwd?: string): RalphTickResult;
+export declare function buildRalphContext(state: RalphState): string;

package/dist/src/mode-state/ralph.js

@@ -0,0 +1,44 @@
+import { clearModeState, readModeStateJson, writeModeStateJson } from "./paths.js";
+export function startRalph(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const state = {
+        active: true,
+        iteration: 0,
+        maxIterations: opts.maxIterations ?? 10,
+        startedAt: new Date().toISOString(),
+        prompt: opts.prompt,
+        sessionId: opts.sessionId,
+        projectPath: cwd,
+    };
+    writeModeStateJson(cwd, "ralph", state);
+    return state;
+}
+export function readRalph(cwd = process.cwd()) {
+    return readModeStateJson(cwd, "ralph");
+}
+export function cancelRalph(cwd = process.cwd()) {
+    clearModeState(cwd, "ralph");
+}
+export function tickRalph(cwd = process.cwd()) {
+    const state = readRalph(cwd);
+    if (!state)
+        return { ok: false, reason: "not active" };
+    if (!state.active)
+        return { ok: false, reason: "loop already cleared" };
+    if (state.iteration >= state.maxIterations) {
+        cancelRalph(cwd);
+        return { ok: false, reason: `max iterations (${state.maxIterations}) reached` };
+    }
+    const advanced = { ...state, iteration: state.iteration + 1 };
+    writeModeStateJson(cwd, "ralph", advanced);
+    return { ok: true, state: advanced };
+}
+export function buildRalphContext(state) {
+    return [
+        `[RALPH ACTIVE: iteration ${state.iteration}/${state.maxIterations}]`,
+        `Started: ${state.startedAt}`,
+        `Prompt: ${state.prompt}`,
+        "Continue the loop. Report concrete progress.",
+    ].join("\n");
+}
+//# sourceMappingURL=ralph.js.map

package/dist/src/mode-state/ralph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph.js","sourceRoot":"","sources":["../../../src/mode-state/ralph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmBnF,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,KAAK,GAAe;QACxB,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC;QACZ,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;QACvC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,GAAG;KACjB,CAAC;IACF,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACnD,OAAO,iBAAiB,CAAa,GAAG,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACrD,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAQD,MAAM,UAAU,SAAS,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACnD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACxE,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QAC3C,WAAW,CAAC,GAAG,CAAC,CAAC;QACjB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,KAAK,CAAC,aAAa,WAAW,EAAE,CAAC;IAClF,CAAC;IACD,MAAM,QAAQ,GAAe,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;IAC1E,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAiB;IACjD,OAAO;QACL,4BAA4B,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,aAAa,GAAG;QACrE,YAAY,KAAK,CAAC,SAAS,EAAE;QAC7B,WAAW,KAAK,CAAC,MAAM,EAAE;QACzB,8CAA8C;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/src/mode-state/ultraqa.d.ts

@@ -0,0 +1,26 @@
+export interface UltraqaState {
+    active: boolean;
+    goal: string;
+    cycleCount: number;
+    maxCycles: number;
+    startedAt: string;
+    sessionId?: string;
+    projectPath: string;
+    lastVerdict?: "pass" | "fail" | "pending";
+}
+export interface StartUltraqaOptions {
+    cwd?: string;
+    goal: string;
+    maxCycles?: number;
+    sessionId?: string;
+}
+export declare function startUltraqa(opts: StartUltraqaOptions): UltraqaState;
+export declare function readUltraqa(cwd?: string): UltraqaState | undefined;
+export declare function cancelUltraqa(cwd?: string): void;
+export interface UltraqaCycleResult {
+    ok: boolean;
+    state?: UltraqaState;
+    reason?: string;
+}
+export declare function recordUltraqaCycle(cwd: string | undefined, verdict: "pass" | "fail" | "pending"): UltraqaCycleResult;
+export declare function buildUltraqaContext(state: UltraqaState): string;