knodin 0.7.4 → 0.7.6

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "knodin",
-	"version": "0.7.4",
+	"version": "0.7.6",
 	"description": "knodin — source-evidenced local code intelligence with known bounds. Stable identity, fresh evidence, truthful budgets, and recoverable bounded views.",
 	"license": "MIT",
 	"repository": {
@@ -11,105 +11,13 @@
 	"bugs": {
 		"url": "https://github.com/knodin/knodin/issues"
 	},
-	"publishConfig": {
-		"access": "public",
-		"registry": "https://registry.npmjs.org/"
-	},
 	"type": "module",
 	"bin": {
 		"knodin": "dist/bin/launcher.js"
 	},
-	"files": [
-		"dist",
-		"docs/DEAD-CODE-AND-IMPACT.md",
-		"docs/DOCTOR-AND-UPDATES.md",
-		"docs/DIAGNOSTICS.md",
-		"docs/INDEXING-POLICY-AND-PROVENANCE.md",
-		"docs/INSTALLATION.md",
-		"docs/MCP.md",
-		"docs/COMMAND-OUTPUT-COMPRESSION.md",
-		"docs/CONTAINED-EXECUTION.md",
-		"docs/PROGRESSIVE-EVIDENCE.md",
-		"docs/GIT-HISTORY-REVIEW.md",
-		"docs/SCIP-IMPORT.md",
-		"docs/CLI.md",
-		"docs/PT-ACCESS-RECOMMENDATION.md",
-		"docs/REPOSITORIES-AND-WORKTREES.md",
-		"docs/RELEASE-0.3-EVIDENCE.md",
-		"docs/SIGNED-UPDATES.md",
-		"docs/releases/0.3.0.md",
-		"docs/releases/0.4.0.md",
-		"docs/releases/0.4.1.md",
-		"docs/releases/0.4.2.md",
-		"docs/releases/0.4.3.md",
-		"docs/releases/0.5.0.md",
-		"docs/releases/0.5.1.md",
-		"docs/releases/0.6.0.md",
-		"docs/releases/0.7.0.md",
-		"docs/releases/0.7.1.md",
-		"docs/releases/0.7.2.md",
-		"docs/releases/0.7.3.md",
-		"docs/releases/0.7.4.md",
-		"docs/assets/knodin-favicon.svg",
-		"docs/SYSTEMS-AND-RELATIONSHIPS.md",
-		"docs/TELEMETRY.md",
-		"schemas/release-attestation-v1.schema.json",
-		"*.wasm"
-	],
 	"engines": {
 		"node": ">=24.0.0"
 	},
-	"scripts": {
-		"prepack": "npm run build",
-		"hooks:install": "tsx scripts/prepare-hooks.ts",
-		"dev": "tsx watch src/server.ts",
-		"start": "tsx src/server.ts",
-		"cli": "tsx bin/cli.ts",
-		"clean": "node scripts/clean-dist.mjs",
-		"build": "npm run clean && tsc -p tsconfig.build.json",
-		"typecheck": "tsc --noEmit",
-		"test": "tsx scripts/run-vitest-shards.ts",
-		"test:handles": "vitest run --reporter=verbose --reporter=hanging-process",
-		"test:watch": "vitest --watch",
-		"test:coverage": "tsx scripts/run-vitest-shards.ts --coverage",
-		"scan:sonar": "npm run test:coverage && sh scripts/run-sonar-scan.sh",
-		"mirror:sync": "sh tools/hooks/sync-ghes-mirror.sh",
-		"test:pack-install": "tsx scripts/pack-install-smoke.ts",
-		"test:package-managers": "tsx scripts/package-manager-smoke.ts",
-		"test:naming-screen": "node --test scripts/naming-screen.test.js",
-		"measure:schema": "tsx scripts/measure-tool-schema.ts",
-		"check:dependency-deprecations": "tsx scripts/check-dependency-deprecations.ts",
-		"check:hygiene": "node scripts/check-repository-hygiene.mjs",
-		"check:roadmap": "tsx scripts/check-roadmap.ts",
-		"verify:c79": "tsx scripts/verify-c79.ts",
-		"bench:c80": "tsx benchmarks/evaluations/c80-structural-routing/runner.ts",
-		"verify:c80": "tsx scripts/verify-c80.ts",
-		"bench:c81": "tsx benchmarks/evaluations/c81-powered-benchmark/runner.ts",
-		"verify:c81": "tsx scripts/verify-c81.ts",
-		"bench:c82": "tsx benchmarks/evaluations/c82-compress-diagnose/runner.ts",
-		"verify:c82": "tsx scripts/verify-c82.ts",
-		"bench:c83": "tsx benchmarks/evaluations/c83-progressive-evidence/runner.ts",
-		"verify:c83": "tsx scripts/verify-c83.ts",
-		"bench:c84": "tsx benchmarks/evaluations/c84-scip-import/runner.ts",
-		"verify:c84": "tsx scripts/verify-c84.ts",
-		"bench:c85": "tsx benchmarks/evaluations/c85-git-history/runner.ts",
-		"verify:c85": "tsx scripts/verify-c85.ts",
-		"bench:c86": "tsx benchmarks/evaluations/c86-static-embeddings/runner.ts",
-		"verify:c86": "tsx scripts/verify-c86.ts",
-		"bench:c87": "tsx benchmarks/evaluations/c87-structural-cold-start/runner.ts",
-		"verify:c87": "tsx scripts/verify-c87.ts",
-		"bench:c88": "tsx benchmarks/evaluations/c88-contained-execution/runner.ts",
-		"verify:c88": "tsx scripts/verify-c88.ts",
-		"bench:ann": "bun scripts/ann-bench.ts",
-		"bench:perf": "tsx scripts/perf-bench.ts",
-		"bench:competitive": "tsx scripts/competitive-bakeoff.ts",
-		"bench:token-optimizer": "tsx benchmarks/evaluations/token-optimizer-20260730/runner.ts",
-		"audit:token-optimizer": "tsx scripts/token-optimizer-source-audit.ts",
-		"release:attestation": "tsx scripts/release-attestation.ts",
-		"release:preflight": "tsx scripts/release-preflight.ts",
-		"lint": "biome check .",
-		"lint:fix": "biome check --write ."
-	},
 	"dependencies": {
 		"@huggingface/transformers": "^4.2.0",
 		"@modelcontextprotocol/sdk": "^1.30.0",
@@ -123,22 +31,5 @@
 		"web-tree-sitter-sfapex": "2.4.1",
 		"yaml": "2.9.0",
 		"zod": "^4.3.6"
-	},
-	"overrides": {
-		"@hono/node-server": "^2.0.5",
-		"adm-zip": "^0.6.0",
-		"fast-uri": "^4.1.1",
-		"sharp": "^0.35.3"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "2.4.6",
-		"@types/bun": "^1.3.14",
-		"@types/node": "^24.10.0",
-		"@vitest/coverage-v8": "^4.1.10",
-		"ajv": "8.20.0",
-		"lefthook": "^2.1.5",
-		"tsx": "^4.21.0",
-		"typescript": "^5.9.3",
-		"vitest": "^4.1.3"
 	}
 }

package/dist/src/agent-integration.js

@@ -1,238 +0,0 @@
-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 commandExists(command) {
-    try {
-        child_process.execFileSync("which", [command], { stdio: "ignore" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** Detect primary MCP-capable coding agents without launching them. */
-export function detectSupportedAgents() {
-    const detected = [];
-    if (commandExists("claude"))
-        detected.push("claude");
-    if (commandExists("codex"))
-        detected.push("codex");
-    if (commandExists("gemini"))
-        detected.push("gemini");
-    if (commandExists("antigravity") || commandExists("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 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 updateTomlMcp(filePath, remove) {
-    let existing = "";
-    try {
-        existing = fs.readFileSync(filePath, "utf-8");
-    }
-    catch (error) {
-        if (error.code !== "ENOENT")
-            throw error;
-    }
-    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();
-    }
-    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"
-        ? ["claude", "codex", "gemini", "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 === "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

@@ -1,81 +0,0 @@
-import { spawnSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-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 = path.join(path.resolve(repoPath), ".knodin");
-    fs.mkdirSync(knodinDir, { recursive: true });
-    fs.appendFileSync(path.join(knodinDir, "artifact-refresh.jsonl"), `${JSON.stringify({ at: new Date().toISOString(), ...result })}\n`, "utf8");
-}