knodin 0.7.6 → 0.8.2

package/dist/bin/launcher.js

@@ -1,4 +1,26 @@
 #!/usr/bin/env node
-import{spawnSync as w}from"node:child_process";import g from"node:fs";import O from"node:os";import M from"node:path";var S=24;function T(e){let r=e?.trim().match(/^v?(\d+)(?:\.|$)/);if(!r)return;let t=Number(r[1]);return Number.isSafeInteger(t)?t:void 0}function h(e){return(T(e)??0)>=S}function y(e,r){let t=e.replace(/^v/,"").split(".").map(Number),n=r.replace(/^v/,"").split(".").map(Number);for(let o=0;o<Math.max(t.length,n.length);o+=1){let s=(n[o]??0)-(t[o]??0);if(s!==0)return s}return r.localeCompare(e)}function P(e,r,t){for(let n of(e.env.PATH??"").split(e.pathApi.delimiter))n&&e.pathApi.isAbsolute(n)&&t(e.pathApi.join(n,r))}function x(e,r){return e.platform==="darwin"?e.pathApi.join(e.homeDirectory,"Library","Application Support","fnm"):e.platform==="win32"&&r?e.pathApi.join(r,"fnm"):e.pathApi.join(e.homeDirectory,".local","share","fnm")}function K(e,r,t,n,o){if(e.platform==="darwin"&&(n("/opt/homebrew/opt/node@24/bin/node"),n("/opt/homebrew/opt/node/bin/node"),n("/usr/local/opt/node@24/bin/node"),n("/usr/local/opt/node/bin/node")),e.platform==="win32"){o(t(e.env.NVM_HOME),[]);let s=t(e.env.ProgramFiles);n(s?e.pathApi.join(s,"nodejs",r):void 0)}}function U(e){let{env:r,homeDirectory:t,pathApi:n,platform:o}=e,s=o==="win32"?"node.exe":"node",f=[],m=new Set([e.currentExecutable]),l=i=>{!i||m.has(i)||(m.add(i),f.push(i))},a=(i,A)=>{if(!(!i||!n.isAbsolute(i)))for(let R of e.listDirectories(i).sort(y))l(n.join(i,R,...A,s))};if(r.KNODIN_NODE_RUNTIME&&!n.isAbsolute(r.KNODIN_NODE_RUNTIME))throw new Error("KNODIN_NODE_RUNTIME must be an absolute path to a Node.js executable.");l(r.KNODIN_NODE_RUNTIME),P(e,s,l);let c=i=>i&&n.isAbsolute(i)?i:void 0,E=c(r.MISE_DATA_DIR)??n.join(t,".local","share","mise"),u=o==="win32"?[]:["bin"];a(n.join(E,"installs","node"),u),a(n.join(t,".mise","installs","node"),u);let p=c(r.NVM_DIR);a(p?n.join(p,"versions","node"):void 0,u),a(n.join(t,".nvm","versions","node"),u);let _=c(r.APPDATA),j=x(e,_),N=c(r.FNM_DIR);a(N?n.join(N,"node-versions"):void 0,o==="win32"?["installation"]:["installation","bin"]),a(n.join(j,"node-versions"),o==="win32"?["installation"]:["installation","bin"]);let v=c(r.ASDF_DATA_DIR)??n.join(t,".asdf");a(n.join(v,"installs","nodejs"),u);let I=c(r.VOLTA_HOME)??n.join(t,".volta");return a(n.join(I,"tools","image","node"),u),K(e,s,c,l,a),f}function C(e){if(h(e.currentVersion))return{kind:"current"};let r=e.env.KNODIN_NODE_RUNTIME;if(r===e.currentExecutable)throw new Error(`KNODIN_NODE_RUNTIME points to the active Node.js ${e.currentVersion} executable; Node.js 24 or newer is required.`);for(let t of U(e)){let n=e.probe(t);if(!h(n)){if(t===r)throw new Error(`KNODIN_NODE_RUNTIME points to ${t}, but it reports ${n??"no usable Node.js version"}; Node.js 24 or newer is required.`);continue}let o=e.spawn(t,e.launcherArguments,{env:e.env,stdio:"inherit"});if(o.error)throw new Error(`Unable to launch Knodin with ${t}: ${o.error.message}`);if(o.status===null&&o.signal===null)throw new Error(`Knodin's Node.js 24+ runtime at ${t} exited without a status.`);return{kind:"relaunched",status:o.status,signal:o.signal}}throw new Error(`Knodin requires Node.js 24 or newer, but the active runtime is ${e.currentVersion}. Install Node.js 24+ with Homebrew or your version manager, or set KNODIN_NODE_RUNTIME=/absolute/path/to/node. Your project may remain pinned to Node.js 20.`)}function V(e){try{return g.readdirSync(e,{withFileTypes:!0}).filter(r=>r.isDirectory()||r.isSymbolicLink()).map(r=>r.name)}catch{return[]}}function $(e){let r=w(e,["-p","process.versions.node"],{encoding:"utf8",stdio:["ignore","pipe","ignore"],timeout:2e3});return r.status===0?r.stdout.trim():void 0}function b(){return C({currentExecutable:process.execPath,currentVersion:process.versions.node,env:process.env,homeDirectory:O.homedir(),platform:process.platform,launcherArguments:process.argv.slice(1),probe:$,spawn:(e,r,t)=>w(e,r,t),pathApi:M,listDirectories:V})}var d;try{d=b()}catch(e){let r=e instanceof Error?e.message:String(e);process.stderr.write(`knodin: ${r}
-`),process.exit(1)}d.kind==="relaunched"&&(d.signal&&process.kill(process.pid,d.signal),process.exit(d.status??1));var D=process.argv.slice(2),{tryStructuralFastPath:F}=await import("../chunks/structural-fast-path-KD5KQSPX.js"),k=F(D);if(!k){let{tryPureCompressionFastPath:e}=await import("../chunks/pure-compression-cli-4TA2TQD5.js");await e(D)||await import("./cli.js")}process.env.KNODIN_BENCH_PROCESS_UPTIME==="1"&&process.stderr.write(`KNODIN_PROCESS_UPTIME_MS=${(process.uptime()*1e3).toFixed(3)}
-`);
+import { handoffCurrentProcessToSupportedNodeRuntime } from "../src/node-runtime.js";
+let runtime;
+try {
+    runtime = handoffCurrentProcessToSupportedNodeRuntime();
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`knodin: ${message}\n`);
+    process.exit(1);
+}
+if (runtime.kind === "relaunched") {
+    if (runtime.signal)
+        process.kill(process.pid, runtime.signal);
+    process.exit(runtime.status ?? 1);
+}
+const argv = process.argv.slice(2);
+const { tryStructuralFastPath } = await import("../src/structural-fast-path.js");
+const fast = tryStructuralFastPath(argv);
+if (!fast) {
+    const { tryPureCompressionFastPath } = await import("../src/pure-compression-cli.js");
+    if (!(await tryPureCompressionFastPath(argv)))
+        await import("./cli.js");
+}
+if (process.env.KNODIN_BENCH_PROCESS_UPTIME === "1")
+    process.stderr.write(`KNODIN_PROCESS_UPTIME_MS=${(process.uptime() * 1000).toFixed(3)}\n`);

package/dist/src/agent-integration.js

@@ -0,0 +1,304 @@
+import child_process from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+export function parseInitScope(value) {
+    if (value === "personal" || value === "team" || value === "cli-only")
+        return value;
+    throw new Error("knodin: --scope must be personal, team, or cli-only");
+}
+const MCP_NAME = "knodin";
+const TOML_START = "# knodin:start";
+const TOML_END = "# knodin:end";
+const TOML_BLOCK = `${TOML_START}
+[mcp_servers."${MCP_NAME}"]
+command = "knodin"
+args = ["serve"]
+${TOML_END}`;
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function commandPath(command) {
+    try {
+        const resolver = process.platform === "win32" ? "where.exe" : "which";
+        return (child_process
+            .execFileSync(resolver, [command], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        })
+            .split(/\r?\n/, 1)[0]
+            ?.trim() || null);
+    }
+    catch {
+        return null;
+    }
+}
+function hasGitHubCopilotExtension() {
+    const code = commandPath("code");
+    if (!code)
+        return false;
+    try {
+        const extensions = child_process.execFileSync(code, ["--list-extensions"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return extensions
+            .split(/\r?\n/)
+            .some((extension) => ["github.copilot", "github.copilot-chat"].includes(extension.toLowerCase()));
+    }
+    catch {
+        return false;
+    }
+}
+/** Detect primary MCP-capable coding agents without launching them. */
+export function detectSupportedAgents() {
+    const detected = [];
+    if (commandPath("claude"))
+        detected.push("claude");
+    if (commandPath("codex"))
+        detected.push("codex");
+    if (commandPath("gemini"))
+        detected.push("gemini");
+    if (hasGitHubCopilotExtension())
+        detected.push("copilot");
+    if (commandPath("antigravity") || commandPath("agy"))
+        detected.push("antigravity");
+    return detected;
+}
+function defaultRunner(command) {
+    try {
+        child_process.execFileSync(command.executable, command.args, {
+            cwd: command.cwd,
+            stdio: ["ignore", "ignore", "pipe"],
+        });
+    }
+    catch (error) {
+        if (command.executable !== "claude" || !command.args.includes("add"))
+            throw error;
+        child_process.execFileSync("claude", ["mcp", "get", MCP_NAME], {
+            cwd: command.cwd,
+            stdio: ["ignore", "ignore", "pipe"],
+        });
+    }
+}
+/**
+ * Configure command-backed personal integrations. Claude stores local scope
+ * outside the checkout; Codex/Gemini/Antigravity use excluded project files.
+ */
+export function configurePersonalAgents(options) {
+    const run = options.run ?? defaultRunner;
+    const configured = [];
+    const removed = [];
+    const failed = [];
+    for (const agent of options.detected) {
+        if (agent !== "claude")
+            continue;
+        const command = options.remove
+            ? {
+                executable: "claude",
+                args: ["mcp", "remove", MCP_NAME, "--scope", "local"],
+            }
+            : {
+                executable: "claude",
+                args: ["mcp", "add", MCP_NAME, "--scope", "local", "--", "knodin", "serve"],
+            };
+        try {
+            run(command);
+            (options.remove ? removed : configured).push(agent);
+        }
+        catch (error) {
+            // Claude reports a missing local registration as a remove failure. Keep
+            // this backward-compatible result conservative at the presentation layer:
+            // it means removal was attempted, not that absence was verified.
+            if (options.remove)
+                removed.push(agent);
+            else
+                failed.push({ agent, message: errorMessage(error) });
+        }
+    }
+    return { configured, removed, failed, projectFiles: [] };
+}
+function readJsonObject(filePath) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+            throw new Error("expected a JSON object");
+        return parsed;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return {};
+        throw new Error(`${filePath}: ${errorMessage(error)}`);
+    }
+}
+function assertSafeProjectPath(repo, filePath) {
+    const relative = path.relative(repo, filePath);
+    if (relative.startsWith("..") || path.isAbsolute(relative))
+        throw new Error(`${filePath}: agent configuration must stay inside the repository`);
+    let current = repo;
+    for (const part of relative.split(path.sep)) {
+        current = path.join(current, part);
+        try {
+            if (fs.lstatSync(current).isSymbolicLink())
+                throw new Error(`${filePath}: refusing to follow a symbolic link`);
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                break;
+            throw error;
+        }
+    }
+}
+function formatProjectJson(document) {
+    return `${JSON.stringify(document, null, "\t").replace(/"args": \[\n(\t+)"serve"\n\t+\]/g, '"args": ["serve"]')}\n`;
+}
+function removeEmptyParent(filePath) {
+    try {
+        fs.rmdirSync(path.dirname(filePath));
+    }
+    catch (error) {
+        if (!["ENOENT", "ENOTEMPTY"].includes(error.code ?? ""))
+            throw error;
+    }
+}
+function updateJsonMcp(filePath, remove) {
+    const document = readJsonObject(filePath);
+    const existing = document.mcpServers;
+    const servers = typeof existing === "object" && existing !== null && !Array.isArray(existing)
+        ? { ...existing }
+        : {};
+    if (remove)
+        delete servers[MCP_NAME];
+    else
+        servers[MCP_NAME] = { command: "knodin", args: ["serve"] };
+    if (Object.keys(servers).length > 0)
+        document.mcpServers = servers;
+    else
+        delete document.mcpServers;
+    if (remove && Object.keys(document).length === 0) {
+        fs.rmSync(filePath, { force: true });
+        return false;
+    }
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, formatProjectJson(document), "utf-8");
+    return true;
+}
+function updateVsCodeMcp(filePath, remove) {
+    const document = readJsonObject(filePath);
+    const existing = document.servers;
+    if (existing !== undefined &&
+        (typeof existing !== "object" || existing === null || Array.isArray(existing)))
+        throw new Error(`${filePath}: expected "servers" to be an object`);
+    const servers = typeof existing === "object" && existing !== null && !Array.isArray(existing)
+        ? { ...existing }
+        : {};
+    if (remove)
+        delete servers[MCP_NAME];
+    else
+        servers[MCP_NAME] = { type: "stdio", command: "knodin", args: ["serve"] };
+    if (Object.keys(servers).length > 0)
+        document.servers = servers;
+    else
+        delete document.servers;
+    if (remove && Object.keys(document).length === 0) {
+        fs.rmSync(filePath, { force: true });
+        removeEmptyParent(filePath);
+        return false;
+    }
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, formatProjectJson(document), "utf-8");
+    return true;
+}
+/** Strips a marker-delimited managed block, leaving surrounding user config intact. */
+function removeManagedBlock(content, startMarker, endMarker) {
+    const start = content.indexOf(startMarker);
+    const end = content.indexOf(endMarker);
+    return start >= 0 && end >= start
+        ? `${content.slice(0, start)}${content.slice(end + endMarker.length)}`.trim()
+        : content.trim();
+}
+function updateTomlMcp(filePath, remove) {
+    let existing = "";
+    try {
+        existing = fs.readFileSync(filePath, "utf-8");
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    const without = removeManagedBlock(existing, TOML_START, TOML_END);
+    const next = remove ? without : [without, TOML_BLOCK].filter(Boolean).join("\n\n");
+    if (!next) {
+        fs.rmSync(filePath, { force: true });
+        return false;
+    }
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, `${next}\n`, "utf-8");
+    return true;
+}
+/** Merge or remove knodin's project-local agent adapters without replacing user configuration. */
+export function configureProjectAgents(options) {
+    const repo = path.resolve(options.repo);
+    const remove = options.scope === "cli-only";
+    const agents = options.scope === "team" || options.scope === "cli-only"
+        ? ["claude", "codex", "gemini", "copilot", "antigravity"]
+        : options.agents;
+    const commandResult = options.scope === "team"
+        ? { configured: [], removed: [], failed: [], projectFiles: [] }
+        : configurePersonalAgents({
+            detected: agents,
+            remove,
+            run: options.run ?? ((command) => defaultRunner({ ...command, cwd: repo })),
+        });
+    const configured = [...commandResult.configured];
+    const removed = [...commandResult.removed];
+    const failed = [...commandResult.failed];
+    const projectFiles = [];
+    for (const agent of agents) {
+        try {
+            let relative = null;
+            let remains = false;
+            if (agent === "claude" && options.scope === "team") {
+                relative = ".mcp.json";
+                assertSafeProjectPath(repo, path.join(repo, relative));
+                remains = updateJsonMcp(path.join(repo, relative), false);
+            }
+            else if (agent === "claude") {
+                relative = ".mcp.json";
+                assertSafeProjectPath(repo, path.join(repo, relative));
+                remains = updateJsonMcp(path.join(repo, relative), true);
+            }
+            else if (agent === "codex") {
+                relative = ".codex/config.toml";
+                assertSafeProjectPath(repo, path.join(repo, relative));
+                remains = updateTomlMcp(path.join(repo, relative), remove);
+            }
+            else if (agent === "gemini") {
+                relative = ".gemini/settings.json";
+                assertSafeProjectPath(repo, path.join(repo, relative));
+                remains = updateJsonMcp(path.join(repo, relative), remove);
+            }
+            else if (agent === "copilot") {
+                relative = ".vscode/mcp.json";
+                assertSafeProjectPath(repo, path.join(repo, relative));
+                remains = updateVsCodeMcp(path.join(repo, relative), remove);
+            }
+            else if (agent === "antigravity") {
+                relative = ".agents/mcp_config.json";
+                assertSafeProjectPath(repo, path.join(repo, relative));
+                remains = updateJsonMcp(path.join(repo, relative), remove);
+            }
+            if (relative && remains)
+                projectFiles.push(relative);
+            if (agent === "claude" && options.scope === "team" && !configured.includes(agent))
+                configured.push(agent);
+            if (agent !== "claude" && !remove && !configured.includes(agent))
+                configured.push(agent);
+            if (remove && !removed.includes(agent))
+                removed.push(agent);
+        }
+        catch (error) {
+            failed.push({ agent, message: errorMessage(error) });
+        }
+    }
+    return { configured, removed, failed, projectFiles };
+}

package/dist/src/artifact-refresh.js

@@ -0,0 +1,82 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { resolveStateDir } from "./engine/state-paths.js";
+const REFRESH_TIMEOUT_MS = 30_000;
+function defaultRuntime() {
+    return {
+        commandExists: (command) => {
+            const probe = spawnSync(command, ["--help"], { stdio: "ignore", timeout: 5_000 });
+            return (probe.status !== null ||
+                probe.error?.code !== "ENOENT");
+        },
+        run: (command, cwd) => {
+            const startedAt = performance.now();
+            const result = spawnSync(command[0], command.slice(1), {
+                stdio: "ignore",
+                timeout: REFRESH_TIMEOUT_MS,
+                cwd,
+            });
+            return {
+                exitCode: result.status,
+                elapsedMs: Math.round(performance.now() - startedAt),
+                timedOut: result.signal === "SIGTERM" || result.signal === "SIGKILL",
+            };
+        },
+    };
+}
+/**
+ * Explicitly refresh supported local, external graph artifacts. This is never a
+ * commit hook: callers opt in, each rebuild is time-bounded, and unavailable
+ * tools are recorded as skipped rather than being represented as fresh.
+ */
+export function refreshExternalGraphArtifacts(repoPath, event, runtime = defaultRuntime()) {
+    const repo = path.resolve(repoPath);
+    const gitNexusRunner = path.join(repo, ".gitnexus", "run.cjs");
+    const commands = [
+        fs.existsSync(gitNexusRunner)
+            ? {
+                artifact: "gitnexus",
+                command: ["node", gitNexusRunner, "analyze"],
+                requiredCommand: "node",
+            }
+            : {
+                artifact: "gitnexus",
+                command: ["gitnexus", "analyze", repo],
+                requiredCommand: "gitnexus",
+            },
+        { artifact: "graphify", command: ["graphify", "update", repo], requiredCommand: "graphify" },
+    ];
+    const artifacts = commands.map(({ artifact, command, requiredCommand }) => {
+        if (!runtime.commandExists(requiredCommand)) {
+            return { artifact, state: "skipped", reason: `${artifact} is not installed` };
+        }
+        const result = runtime.run(command, repo);
+        if (result.exitCode === 0) {
+            return { artifact, state: "success", command, elapsedMs: result.elapsedMs };
+        }
+        return {
+            artifact,
+            state: "failed",
+            command,
+            elapsedMs: result.elapsedMs,
+            reason: result.timedOut
+                ? `timed out after ${REFRESH_TIMEOUT_MS}ms`
+                : `exited ${result.exitCode ?? "unknown"}`,
+        };
+    });
+    const successes = artifacts.filter((artifact) => artifact.state === "success").length;
+    const failures = artifacts.filter((artifact) => artifact.state === "failed").length;
+    const status = failures > 0 && successes === 0
+        ? "failed"
+        : failures > 0 || successes > 0
+            ? "partial"
+            : "skipped";
+    return { event, status, artifacts };
+}
+/** Persist an audit record locally; no source content or tool output is retained. */
+export function writeArtifactRefreshRecord(repoPath, result) {
+    const knodinDir = resolveStateDir(repoPath);
+    fs.mkdirSync(knodinDir, { recursive: true });
+    fs.appendFileSync(path.join(knodinDir, "artifact-refresh.jsonl"), `${JSON.stringify({ at: new Date().toISOString(), ...result })}\n`, "utf8");
+}