@clonst/clonst 1.0.0

package/dist/index.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CodexProvider } from "./providers/codex.js";
+import { formatReviewError, reviewInputShape, reviewOutputShape, runReview } from "./tools/review.js";
+import { loadConfig } from "./utils/config.js";
+import { logStderr } from "./utils/logger.js";
+import { logsDir } from "./utils/paths.js";
+import { spawnCLI } from "./utils/process.js";
+export const SERVER_NAME = "clonst";
+export const SERVER_VERSION = "1.0.0";
+// IMPORTANT: with the stdio transport, stdout is reserved for the MCP protocol.
+// All human-readable logging goes to stderr (logStderr), never console.log.
+async function main() {
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    server.registerTool("clonst_ping", {
+        description: "Full Clonst server diagnostic: health, codex CLI availability and version, " +
+            "login status, loaded config, logs directory. Consumes no LLM quota.",
+        inputSchema: {},
+    }, async () => {
+        const [versionResult, loginResult] = await Promise.all([
+            spawnCLI("codex", ["--version"], { timeoutMs: 15_000 }).catch(() => null),
+            spawnCLI("codex", ["login", "status"], { timeoutMs: 15_000 }).catch(() => null),
+        ]);
+        const codexAvailable = versionResult?.exitCode === 0;
+        const loggedIn = loginResult?.exitCode === 0;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        status: "ok",
+                        server: SERVER_NAME,
+                        version: SERVER_VERSION,
+                        node: process.version,
+                        codex_available: codexAvailable,
+                        codex_version: codexAvailable ? versionResult.stdout.trim() : null,
+                        codex_logged_in: codexAvailable ? loggedIn : null,
+                        config: loadConfig(),
+                        logs_dir: logsDir(),
+                        ...(codexAvailable
+                            ? loggedIn
+                                ? {}
+                                : { hint: "Reconnect the CLI: codex login" }
+                            : { hint: "Install the CLI: npm install -g @openai/codex, then codex login" }),
+                    }),
+                },
+            ],
+        };
+    });
+    server.registerTool("clonst_review", {
+        description: "Have a plan, code or proposal critiqued by Codex (a second LLM, through its CLI and the user's " +
+            "ChatGPT subscription). One call = one structured critique (APPROVED/CHANGES_NEEDED verdict, " +
+            "required changes, suggestions, risks). The revision loop lives on your side: apply the critiques, " +
+            "then call this tool again with the revised content and the returned thread_id - the reviewer keeps " +
+            "its session memory across rounds. Loop until consensus=true, following the returned next_action " +
+            "field, or until the user decides to stop. " +
+            "WHEN TO USE IT: the criterion is LOGIC, not size. Call it by default, without being asked, for any " +
+            "development that touches the project's logic or behavior (business logic, computations, data flows, " +
+            "models, routes, APIs, state, error handling, concurrency, security, migrations), and for plans and " +
+            "architecture decisions before coding. Do NOT use it for pure presentation (static HTML/CSS, copy), " +
+            "documentation, renames without behavior change, or throwaway content the user will not run. Every " +
+            "call consumes the user's subscription quota; when the scope is unclear, ask the user.",
+        inputSchema: reviewInputShape,
+        outputSchema: reviewOutputShape,
+    }, async (input) => {
+        try {
+            const result = await runReview(input, new CodexProvider(), loadConfig());
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: JSON.stringify(formatReviewError(err), null, 2) }],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logStderr(`v${SERVER_VERSION} started (stdio transport)`);
+}
+main().catch((err) => {
+    logStderr(`Fatal startup error: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/providers/base.js

@@ -0,0 +1,17 @@
+/**
+ * Typed provider error. `hint` is a concrete action for the user
+ * (e.g. "codex login"), forwarded as is to the calling LLM which presents it.
+ * The complete raw outputs are already saved to disk by the time this error is
+ * thrown (rule: never lose a paid response).
+ */
+export class ProviderError extends Error {
+    kind;
+    hint;
+    constructor(kind, message, hint) {
+        super(message);
+        this.kind = kind;
+        this.hint = hint;
+        this.name = "ProviderError";
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IAEA;IAHlB,YACkB,IAAuB,EACvC,OAAe,EACC,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAmB;QAEvB,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/providers/codex.js

@@ -0,0 +1,300 @@
+import { readFileSync, rmSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { assertSafeArg, spawnCLI } from "../utils/process.js";
+import { logStderr } from "../utils/logger.js";
+import { ProviderError, } from "./base.js";
+/**
+ * Reads the codex CLI's effective defaults from its config (~/.codex/config.toml,
+ * or CODEX_HOME when set - the same variable the CLI itself uses).
+ * Best-effort, for DISPLAY only: just the ROOT keys count, reading stops at the
+ * first [section] table ([profiles.x] blocks carry their own model keys, which
+ * do not apply here). null when the file is absent, unreadable or the key is
+ * missing: codex's internal default cannot be known without spending quota, so
+ * we show "unknown" rather than an invention.
+ */
+export function readCodexDefaults() {
+    const home = process.env.CODEX_HOME ?? path.join(os.homedir(), ".codex");
+    const result = {
+        model: null,
+        reasoningEffort: null,
+    };
+    // Same whitelist as the overrides: exotic TOML (escapes, spaces...) becomes
+    // null ("unknown") instead of an incorrectly displayed value.
+    const safe = (value) => (/^[A-Za-z0-9._-]+$/.test(value) ? value : null);
+    try {
+        const raw = readFileSync(path.join(home, "config.toml"), "utf-8");
+        for (const line of raw.split(/\r?\n/)) {
+            if (/^\s*\[/.test(line))
+                break; // end of the TOML root keys
+            const model = line.match(/^\s*model\s*=\s*"([^"]+)"/);
+            if (model) {
+                result.model = safe(model[1]);
+                continue;
+            }
+            const effort = line.match(/^\s*model_reasoning_effort\s*=\s*"([^"]+)"/);
+            if (effort)
+                result.reasoningEffort = safe(effort[1]);
+        }
+    }
+    catch {
+        // File absent or unreadable: defaults unknown, null assumed (display only)
+    }
+    return result;
+}
+export function parseCodexEvents(jsonl) {
+    const result = {
+        threadId: null,
+        agentMessages: [],
+        usage: null,
+        malformedLines: 0,
+    };
+    for (const line of jsonl.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let event;
+        try {
+            event = JSON.parse(trimmed);
+        }
+        catch {
+            result.malformedLines++;
+            continue;
+        }
+        if (typeof event !== "object" || event === null) {
+            result.malformedLines++;
+            continue;
+        }
+        const e = event;
+        if (e.type === "thread.started") {
+            if (typeof e.thread_id === "string" && e.thread_id.length > 0) {
+                result.threadId = e.thread_id;
+            }
+            else {
+                result.malformedLines++;
+            }
+        }
+        else if (e.type === "item.completed") {
+            const item = (e.item ?? null);
+            if (item && item.type === "agent_message") {
+                if (typeof item.text === "string") {
+                    result.agentMessages.push(item.text);
+                }
+                else {
+                    result.malformedLines++;
+                }
+            }
+            // Other item types (reasoning, tool calls...) are legitimate and ignored.
+        }
+        else if (e.type === "turn.completed") {
+            const usage = (e.usage ?? null);
+            if (usage && typeof usage === "object" && !Array.isArray(usage)) {
+                const numeric = {};
+                for (const [key, value] of Object.entries(usage)) {
+                    if (typeof value === "number")
+                        numeric[key] = value;
+                }
+                result.usage = numeric;
+            }
+            else {
+                result.malformedLines++;
+            }
+        }
+        // Other event types (turn.started, ...) are ignored.
+    }
+    return result;
+}
+const DEFAULT_RUNTIME = { command: "codex", prefixArgs: [] };
+const INSTALL_HINT = "Install the CLI: npm install -g @openai/codex, then codex login";
+const LOGIN_HINT = "Reconnect the CLI: codex login (auth is shared with the VS Code extension)";
+const QUOTA_HINT_BASE = "Codex usage quota reached (ChatGPT subscription limit, rolling window). " +
+    "Continue the work WITHOUT review and note what will need reviewing; ";
+const QUOTA_HINT_RESUME = QUOTA_HINT_BASE +
+    "the Codex session stays resumable later through the same thread_id, once the window resets.";
+const QUOTA_HINT_NEW = QUOTA_HINT_BASE + "relaunch the review later (new session: no thread_id was created for this round).";
+export class CodexProvider {
+    runtime;
+    name = "codex";
+    constructor(runtime = DEFAULT_RUNTIME) {
+        this.runtime = runtime;
+    }
+    async isAvailable() {
+        try {
+            const result = await spawnCLI(this.runtime.command, [...this.runtime.prefixArgs, "--version"], {
+                timeoutMs: 15_000,
+            });
+            return result.exitCode === 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Builds the invocation arguments. Exposed for tests.
+     * New session: `[-c ...] exec - --sandbox read-only ...`
+     * Resume:      `[-c ...] exec resume <thread_id> - ...` (no --sandbox: the
+     * resume subcommand rejects it, the sandbox is inherited from the session).
+     * Model/effort overrides are ROOT-level codex `-c` flags (before the
+     * subcommand), accepted uniformly by exec and resume: without them the CLI
+     * uses ~/.codex/config.toml as before.
+     */
+    buildArgs(threadId, lastMessagePath, overrides) {
+        const args = [...this.runtime.prefixArgs];
+        if (overrides?.model !== undefined) {
+            args.push("-c", `model=${assertSafeArg(overrides.model, "codex_model")}`);
+        }
+        if (overrides?.reasoningEffort !== undefined) {
+            args.push("-c", `model_reasoning_effort=${assertSafeArg(overrides.reasoningEffort, "codex_reasoning_effort")}`);
+        }
+        if (threadId !== undefined) {
+            args.push("exec", "resume", assertSafeArg(threadId, "thread_id"), "-");
+        }
+        else {
+            args.push("exec", "-", "--sandbox", "read-only");
+        }
+        args.push("--json", "--skip-git-repo-check", "--output-last-message", lastMessagePath);
+        return args;
+    }
+    async invoke(invocation) {
+        const { logger, tag } = invocation;
+        const lastMessagePath = logger.rawPath(`${tag}_last-message.txt`);
+        // Deterministic path: a file left by a previous invocation would be re-read
+        // as if it came from this one (silent stale response). Removed BEFORE the spawn.
+        try {
+            rmSync(lastMessagePath, { force: true });
+        }
+        catch (err) {
+            // force:true covers ENOENT; this is a lock/permission issue. Continuing
+            // would risk re-reading a stale file: fail explicitly with context.
+            throw new Error(`Cannot remove the stale last-message file (session ${logger.sessionId}, tag ${tag}): ` +
+                `${err instanceof Error ? err.message : String(err)}`);
+        }
+        const args = this.buildArgs(invocation.threadId, lastMessagePath, {
+            model: invocation.model,
+            reasoningEffort: invocation.reasoningEffort,
+        });
+        let spawnResult;
+        try {
+            spawnResult = await spawnCLI(this.runtime.command, args, {
+                cwd: invocation.cwd,
+                timeoutMs: invocation.timeoutMs,
+                stdin: invocation.prompt,
+            });
+        }
+        catch (err) {
+            throw new ProviderError("cli_not_found", `Cannot launch the codex CLI: ${err instanceof Error ? err.message : String(err)}`, INSTALL_HINT);
+        }
+        // Raw save BEFORE any interpretation (rule: never lose a paid response)
+        logger.saveRaw(`${tag}_stdout.jsonl`, spawnResult.stdout);
+        if (spawnResult.stderr.trim()) {
+            logger.saveRaw(`${tag}_stderr.txt`, spawnResult.stderr);
+        }
+        if (spawnResult.timedOut) {
+            logger.log({ tag, actor: this.name, event: "timeout", duration_ms: spawnResult.durationMs });
+            throw new ProviderError("timeout", `codex did not respond within the allotted time (${spawnResult.durationMs} ms). ` +
+                `Partial outputs are saved in the session logs.`);
+        }
+        if (spawnResult.exitCode !== 0) {
+            const stderr = spawnResult.stderr.trim();
+            // Locale-independent detection: cmd.exe returns 9009 for an unknown
+            // command, sh returns 127. Text patterns (including localized Windows
+            // messages) are only a secondary net.
+            const notFound = spawnResult.exitCode === 9009 ||
+                spawnResult.exitCode === 127 ||
+                /not recognized|command not found|pas reconnu|introuvable/i.test(stderr);
+            const authIssue = /login|logged out|unauthorized|401/i.test(stderr);
+            const quotaIssue = /usage limit|rate limit|too many requests|quota|429/i.test(stderr);
+            logger.log({
+                tag,
+                actor: this.name,
+                event: notFound ? "cli_not_found" : "exec_failed",
+                exit_code: spawnResult.exitCode,
+                duration_ms: spawnResult.durationMs,
+            });
+            const hint = notFound
+                ? INSTALL_HINT
+                : quotaIssue
+                    ? invocation.threadId !== undefined
+                        ? QUOTA_HINT_RESUME
+                        : QUOTA_HINT_NEW
+                    : authIssue
+                        ? LOGIN_HINT
+                        : undefined;
+            throw new ProviderError(notFound ? "cli_not_found" : "exec_failed", `codex failed (exit ${spawnResult.exitCode}).\nFull stderr:\n${stderr || "(empty)"}`, hint);
+        }
+        const events = parseCodexEvents(spawnResult.stdout);
+        if (events.malformedLines > 0) {
+            logStderr(`codex: ${events.malformedLines} unparsable JSONL line(s) (raw saved: ${tag}_stdout.jsonl)`);
+        }
+        // Primary source: the --output-last-message file written by the CLI itself.
+        // Fallback: the last agent_message event of the JSONL stream.
+        let text = null;
+        try {
+            const fromFile = readFileSync(lastMessagePath, "utf-8");
+            if (fromFile.trim())
+                text = fromFile;
+        }
+        catch {
+            // file absent: fall back to the JSONL stream
+        }
+        if (text === null && events.agentMessages.length > 0) {
+            text = events.agentMessages[events.agentMessages.length - 1];
+        }
+        if (text === null) {
+            logger.log({ tag, actor: this.name, event: "empty_response", duration_ms: spawnResult.durationMs });
+            throw new ProviderError("empty_response", `codex finished (exit 0) without a usable agent message. ` +
+                `Raw stream saved: ${tag}_stdout.jsonl`);
+        }
+        if (events.threadId === null) {
+            // Session resumption is Clonst's central mechanism: a response without a
+            // thread_id makes the next round impossible, so this must be visible.
+            logStderr(`codex: usable response but NO thread_id emitted (${tag}): session resumption will be impossible for this round`);
+            logger.log({ tag, actor: this.name, event: "missing_thread_id" });
+        }
+        else if (invocation.threadId !== undefined && events.threadId !== invocation.threadId) {
+            // Session divergence: the CLI re-emitted a thread_id different from the
+            // resumed one. A serious anomaly (later rounds would target another
+            // session), but not fatal: the response is already paid for and the
+            // critique remains usable.
+            logStderr(`codex: re-emitted thread_id (${events.threadId}) DIFFERS from the resumed one (${invocation.threadId}) - possible session divergence (${tag})`);
+            logger.log({
+                tag,
+                actor: this.name,
+                event: "thread_id_mismatch",
+                requested: invocation.threadId,
+                received: events.threadId,
+            });
+        }
+        // Best-effort resolution of the model/effort actually used (for display in
+        // the final report): requested override, else the ~/.codex/config.toml
+        // default. Codex JSONL events do not expose the model (verified on 0.142.5).
+        const defaults = invocation.model === undefined || invocation.reasoningEffort === undefined
+            ? readCodexDefaults()
+            : { model: null, reasoningEffort: null };
+        const model = invocation.model ?? defaults.model;
+        const reasoningEffort = invocation.reasoningEffort ?? defaults.reasoningEffort;
+        logger.log({
+            tag,
+            actor: this.name,
+            event: "invoke_ok",
+            thread_id: events.threadId,
+            resumed: invocation.threadId !== undefined,
+            duration_ms: spawnResult.durationMs,
+            usage: events.usage,
+            model,
+            reasoning_effort: reasoningEffort,
+            // File name (not an absolute path): the session's raw directory may be
+            // renamed by a migration, the name stays valid by construction.
+            last_message_file: `${tag}_last-message.txt`,
+        });
+        return {
+            text,
+            threadId: events.threadId,
+            durationMs: spawnResult.durationMs,
+            usage: events.usage,
+            model,
+            reasoningEffort,
+        };
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/providers/codex.js.map

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