kodingo-cli 1.1.13 → 1.2.0

package/dist/cli.js

@@ -19,6 +19,7 @@ const sync_dependencies_1 = require("./commands/sync-dependencies");
 const security_scan_1 = require("./commands/security-scan");
 const init_1 = require("./commands/init");
 const build_1 = require("./commands/build");
+const plan_1 = require("./commands/plan");
 const install_hook_1 = require("./commands/install-hook");
 const update_1 = require("./commands/update");
 const sync_1 = require("./commands/sync");
@@ -39,7 +40,7 @@ program
     .argument("<task>", "what to build or fix")
     .option("--repo <path>", "repo path (defaults to the current repo)")
     .option("--max-turns <n>", "override the agent loop's turn budget")
-    .option("--scope <small|substantial>", "manual scope estimate sizing the initial token budget (stands in for Plan mode, not built yet)")
+    .option("--scope <small|substantial>", "manual scope estimate sizing the initial token budget — overrides the scope from a prior `kodingo plan` run against this repo, if any")
     .action(async (task, options) => {
     if (options.scope && options.scope !== "small" && options.scope !== "substantial") {
         console.error(`✖ --scope must be "small" or "substantial", got "${options.scope}".`);
@@ -52,6 +53,19 @@ program
         ...(options.scope ? { scope: options.scope } : {}),
     });
 });
+// ── plan ──────────────────────────────────────────────────────────────────────
+program
+    .command("plan")
+    .description("Run Kortex Plan's local, observation-only agent loop against this repo (test-driver for kodingo-agent)")
+    .argument("<task>", "what to plan")
+    .option("--repo <path>", "repo path (defaults to the current repo)")
+    .option("--max-turns <n>", "override the agent loop's turn budget")
+    .action(async (task, options) => {
+    await (0, plan_1.planCommand)(String(task), {
+        ...(options.repo ? { repo: String(options.repo) } : {}),
+        ...(options.maxTurns ? { maxTurns: Number.parseInt(String(options.maxTurns), 10) } : {}),
+    });
+});
 // ── update ────────────────────────────────────────────────────────────────────
 program
     .command("update")

package/dist/commands/build.js

@@ -118,6 +118,18 @@ async function buildCommand(input, options = {}) {
         return;
     }
     const apiBaseUrl = apiConfig.apiUrl.replace(/\/$/, "");
+    // A real `kodingo plan` run against this same repo left a one-shot scope
+    // estimate behind — use it unless a human explicitly passed --scope,
+    // which always wins. Consumed (cleared) here so a stale plan from a
+    // different task never silently sizes a later, unrelated build.
+    let scope = options.scope;
+    const existingWs = (0, persistence_config_1.readWorkspaceConfig)(repoRoot);
+    if (!scope && existingWs?.lastPlan) {
+        scope = existingWs.lastPlan.scope;
+        console.log(`Using scope:${scope} from the last \`kodingo plan\` run against this repo (${existingWs.lastPlan.createdAt}).`);
+        const { lastPlan: _consumed, ...rest } = existingWs;
+        (0, persistence_config_1.writeWorkspaceConfig)(repoRoot, rest);
+    }
     // Bring-your-own, if configured (~/.kodingo/byo-model.json — same file
     // kodingo-vscode already uses) — never logged, only forwarded.
     const byoModelConfig = (0, kodingo_agent_1.getByoModelConfig)();
@@ -150,13 +162,17 @@ async function buildCommand(input, options = {}) {
                 "Explore before you edit: read files, grep for symbols, and look around as needed — looking is just " +
                 "another turn, you can call tools as many times as it takes to actually understand the real code " +
                 "before changing it. Only use edit_file for surgical, minimal changes to existing files; use " +
-                "write_file only for brand-new files. Before reporting done, verify your change with run_command.",
+                "write_file only for brand-new files. Before reporting done, verify your change with run_command. " +
+                "If you discover mid-task that a prior plan, assumption, or existing memory was meaningfully wrong — " +
+                "a file assumed to exist that doesn't, an existing pattern that's actually different from what was " +
+                "documented — call propose_memory_correction to record it for human review. Only for real, meaningful " +
+                "corrections, not routine exploration findings.",
         },
         { role: "user", content: input },
     ];
     const result = await (0, kodingo_agent_1.runAgentLoop)({
         cwd: repoRoot,
-        tools: (0, kodingo_agent_1.createDefaultToolSet)(),
+        tools: (0, kodingo_agent_1.createDefaultToolSet)({ memoryCorrection: { apiBaseUrl, projectToken: apiConfig.token } }),
         initialMessages,
         modelPort,
         reporter: (0, kodingo_agent_1.createTerminalReporter)(),
@@ -164,7 +180,7 @@ async function buildCommand(input, options = {}) {
         // not a silent hard kill. See kodingo-agent's terminalCheckpointPort.
         checkpointPort: (0, kodingo_agent_1.createTerminalCheckpointPort)(),
         budgets: {
-            ...(0, kodingo_agent_1.resolveBudgetForScope)(options.scope),
+            ...(0, kodingo_agent_1.resolveBudgetForScope)(scope),
             ...(options.maxTurns ? { maxTurns: options.maxTurns } : {}),
         },
     });

package/dist/commands/plan.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * kodingo plan
+ *
+ * Runs Kortex Plan's real local agentic loop (kodingo-agent) against the
+ * current repo — observation only (read_file, grep, list_directory, glob,
+ * query_memory), never edit_file/write_file/run_command. Same real
+ * test-driver identity as `kodingo build` (see build.ts's own header
+ * comment): this exercises kodingo-agent's Plan tool set headlessly, not a
+ * polished second UX.
+ *
+ * On success, the real structured output (scope, filesLikelyInvolved,
+ * openQuestions) is written to this repo's workspace config as a one-shot
+ * handoff — `kodingo build` reads and consumes it to size its own budget,
+ * so a plain `kodingo build "<task>"` run after a `kodingo plan` run for
+ * the same repo picks up a real scope estimate without a manual --scope flag.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planCommand = planCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const kodingo_agent_1 = require("kodingo-agent");
+const persistence_config_1 = require("../utils/persistence-config");
+function findRepoRoot(startPath) {
+    let current = startPath;
+    while (true) {
+        if (fs.existsSync(path.join(current, ".git")))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return startPath;
+        current = parent;
+    }
+}
+function resolveApiConfig(repoRoot) {
+    const config = (0, persistence_config_1.readConfig)();
+    const ws = (0, persistence_config_1.readWorkspaceConfig)(repoRoot);
+    const apiUrl = ws?.apiUrl ?? config.apiUrl;
+    const token = ws?.token ?? config.token;
+    if (!apiUrl || !token)
+        return null;
+    return { apiUrl, token };
+}
+async function planCommand(input, options = {}) {
+    const repoRoot = options.repo ? path.resolve(options.repo) : findRepoRoot(process.cwd());
+    const apiConfig = resolveApiConfig(repoRoot);
+    if (!apiConfig) {
+        console.error(`✖ No Kodingo project connected for ${repoRoot}. Run \`kodingo init\` in this repo first.`);
+        process.exitCode = 1;
+        return;
+    }
+    // Plan only ever reads — the trust prompt exists for Build's write/execute
+    // capability, so Plan doesn't need to ask for it, but it still respects an
+    // existing "always allow" grant by not double-prompting within it either way.
+    if (!(0, kodingo_agent_1.isProjectTrusted)(repoRoot)) {
+        console.log(`Note: ${repoRoot} isn't marked trusted yet — Plan only reads, so this runs regardless, but \`kodingo build\` will still ask.`);
+    }
+    const apiBaseUrl = apiConfig.apiUrl.replace(/\/$/, "");
+    const byoModelConfig = (0, kodingo_agent_1.getByoModelConfig)();
+    if (byoModelConfig) {
+        console.log(`Using bring-your-own model${byoModelConfig.label ? ` (${byoModelConfig.label})` : ""} — no shared quota consumed.`);
+    }
+    console.log(`Starting Kortex Plan against ${repoRoot} ...`);
+    const startRes = await fetch(`${apiBaseUrl}/build/agent-start`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "X-Kodingo-Token": apiConfig.token },
+        body: JSON.stringify({
+            input,
+            repo: path.basename(repoRoot),
+            mode: "plan",
+            ...(byoModelConfig ? { modelConfig: byoModelConfig } : {}),
+        }),
+    });
+    const startBody = (await startRes.json());
+    if (!startRes.ok || !startBody.sessionId) {
+        console.error(`✖ Could not start Plan session: ${startBody.error ?? startRes.status}`);
+        process.exitCode = 1;
+        return;
+    }
+    const sessionId = startBody.sessionId;
+    console.log(`Session: ${sessionId}`);
+    const modelPort = (0, kodingo_agent_1.createHttpModelCallPort)({ apiBaseUrl, projectToken: apiConfig.token, sessionId });
+    const initialMessages = [
+        {
+            role: "system",
+            content: "You are Kortex Plan, working directly against the developer's real local repository. Your job is to " +
+                "produce a real, grounded plan for the task below — not a guess. You have NO ability to edit files or " +
+                "run commands — observation only.\n\n" +
+                "Explore in this order, narrow before wide, memory before raw content — this is enforced, not just " +
+                "advice: read_file will be mechanically rejected unless you've already either (a) called query_memory " +
+                "with a query naming that file, or (b) called list_directory/glob so it actually appears in the results. " +
+                "1) Start from query_memory with a question shaped by the task itself (e.g. 'how does rate limiting work " +
+                "in this codebase'). If the answer is genuinely sufficient, reason from it directly — a well-maintained " +
+                "project should let you produce a grounded plan with little or no raw file reading at all; that's the " +
+                "point, not a shortcut you're avoiding. 2) If insufficient, either ask a different, more specific memory " +
+                "question, or fall back to real exploration — that fallback is legitimate and expected for anything " +
+                "memory doesn't cover yet. 3) When falling back, start with list_directory/glob — file names and " +
+                "structure only, never full contents at this stage. 4) Once a specific file looks relevant, query memory " +
+                "again scoped to that file ('what do we know about authRoutes.js') before reading it — memory may cover " +
+                "it even if your broader query didn't. 5) Only then read_file, as a genuine last resort.\n\n" +
+                "If something is genuinely ambiguous and you can't proceed confidently without knowing the answer, use " +
+                "ask_clarifying_question — sparingly, only for real blockers, not things you could resolve yourself by " +
+                "reading more code. Before calling submit_plan, double-check your own draft against the real codebase: " +
+                "re-verify that every file path you're about to list under filesLikelyInvolved actually exists and is " +
+                "really relevant — submit_plan will mechanically reject any path that doesn't really exist. Give an " +
+                "honest scope estimate: 'small' for a narrow, single-file change; 'substantial' for a real multi-file " +
+                "feature. Your planMarkdown has two real destinations — sent straight to Build, or downloaded and taken " +
+                "somewhere else entirely with zero further involvement from Kortex — so write it as a genuinely complete, " +
+                "standalone document: real file paths, specific locations within them, real reasoning for each change.",
+        },
+        { role: "user", content: input },
+    ];
+    const { tools, drainBackgroundWork } = (0, kodingo_agent_1.createPlanToolSet)({
+        queryMemory: { apiBaseUrl, projectToken: apiConfig.token },
+        modelPort,
+        clarificationPort: (0, kodingo_agent_1.createTerminalClarificationPort)(),
+    });
+    const result = await (0, kodingo_agent_1.runAgentLoop)({
+        cwd: repoRoot,
+        tools,
+        initialMessages,
+        modelPort,
+        reporter: (0, kodingo_agent_1.createTerminalReporter)(),
+        checkpointPort: (0, kodingo_agent_1.createTerminalCheckpointPort)(),
+        drainBackgroundWork,
+        // Plan's whole job is thorough exploration BEFORE any task-specific
+        // scope is known, so it needs real headroom by default, not the flat
+        // 40-turn default — confirmed directly: a real Plan run against Pulse
+        // hit budget_exceeded at exactly 40 turns of pure reading (689,805
+        // tokens, well under the token budget) without ever reaching
+        // submit_plan. Using the same "substantial" floor Build gets for a
+        // real multi-file task, not the bare default.
+        budgets: {
+            ...(0, kodingo_agent_1.resolveBudgetForScope)("substantial"),
+            ...(options.maxTurns ? { maxTurns: options.maxTurns } : {}),
+        },
+    });
+    try {
+        await fetch(`${apiBaseUrl}/build/${sessionId}/agent-complete`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", "X-Kodingo-Token": apiConfig.token },
+            body: JSON.stringify({ status: result.status, message: result.error }),
+        });
+    }
+    catch {
+        // Best-effort — the loop's own outcome already printed to the terminal regardless.
+    }
+    if (result.status !== "completed" || !result.structuredOutput) {
+        console.error(`✖ Plan did not complete: ${result.status}${result.error ? ` — ${result.error}` : ""}`);
+        process.exitCode = 1;
+        return;
+    }
+    const output = result.structuredOutput;
+    console.log(`\n${output.planMarkdown}\n`);
+    console.log(`Scope: ${output.scope}`);
+    console.log(`Files likely involved: ${output.filesLikelyInvolved.join(", ") || "(none)"}`);
+    if (output.openQuestions.length > 0) {
+        console.log(`Open questions:\n${output.openQuestions.map((q) => `  - ${q}`).join("\n")}`);
+    }
+    // One-shot handoff: kodingo build reads and clears this on its next run
+    // against the same repo, sizing its own budget without a manual --scope.
+    const existingWs = (0, persistence_config_1.readWorkspaceConfig)(repoRoot);
+    (0, persistence_config_1.writeWorkspaceConfig)(repoRoot, {
+        mode: "cloud",
+        apiUrl: apiConfig.apiUrl,
+        token: apiConfig.token,
+        ...existingWs,
+        lastPlan: {
+            scope: output.scope,
+            planMarkdown: output.planMarkdown,
+            filesLikelyInvolved: output.filesLikelyInvolved,
+            openQuestions: output.openQuestions,
+            createdAt: new Date().toISOString(),
+        },
+    });
+    console.log(`\n✔ Saved as this repo's last plan — \`kodingo build\` will use scope:${output.scope} automatically on its next run here.`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kodingo-cli",
-  "version": "1.1.13",
+  "version": "1.2.0",
   "description": "Kodingo CLI",
   "license": "MIT",
   "private": false,
@@ -25,7 +25,7 @@
     "@typescript-eslint/types": "^8.61.1",
     "@typescript-eslint/typescript-estree": "^8.61.1",
     "commander": "^12.1.0",
-    "kodingo-agent": "^0.1.3",
+    "kodingo-agent": "^0.2.0",
     "kodingo-core": "^0.2.1",
     "open": "^11.0.0",
     "simple-git": "^3.30.0",