kb-tool 0.1.4 → 0.1.6

package/dist/commands/agent-context.d.ts

@@ -0,0 +1,5 @@
+import { Command } from "commander";
+export declare function readSchemaLines(schemaPath: string): Promise<string>;
+export declare function buildBlock(projectName: string, schemaLines: string): Promise<string>;
+export declare function makeAgentContextCommand(): Command;
+//# sourceMappingURL=agent-context.d.ts.map

package/dist/commands/agent-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../../src/commands/agent-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASzE;AAED,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAWD,wBAAgB,uBAAuB,IAAI,OAAO,CAqCjD"}

package/dist/commands/agent-context.js

@@ -0,0 +1,83 @@
+import { readFile, writeFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import { Command } from "commander";
+import chalk from "chalk";
+import { loadProject } from "kb-core";
+export async function readSchemaLines(schemaPath) {
+    let content;
+    try {
+        content = await readFile(schemaPath, "utf8");
+    }
+    catch {
+        return "_No `.kb/schema.md` found in this project._";
+    }
+    const lines = content.split("\n").slice(0, 20);
+    return lines.join("\n");
+}
+export async function buildBlock(projectName, schemaLines) {
+    return `## Knowledge Base: ${projectName}
+
+This project has an LLM-maintained knowledge base at \`./wiki/\`.
+- Wiki index: \`wiki/_index.md\`
+- Schema/conventions: \`.kb/schema.md\`
+- Raw sources: \`sources/\`
+- Activity log: \`log.md\`
+
+### Available CLI commands
+- \`kb search <query>\` — Search the wiki
+- \`kb ingest <path> --apply\` — Process a new source into the wiki
+- \`kb query <question>\` — Ask a question against the wiki
+- \`kb lint\` — Health-check the wiki
+- \`kb lint --deep\` — LLM-assisted deep health check
+
+### MCP tools available
+This project exposes an MCP server via \`kb mcp\`.
+Tools: kb_search, kb_get_page, kb_get_index, kb_ingest, kb_lint, kb_backlinks, kb_status.
+
+### Wiki conventions
+${schemaLines}`;
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function makeAgentContextCommand() {
+    const cmd = new Command("agent-context");
+    cmd
+        .description("Generate a markdown context block for CLAUDE.md / AGENTS.md")
+        .option("--write", "Append block to CLAUDE.md in project root", false)
+        .action(async (options) => {
+        try {
+            const project = await loadProject(process.cwd());
+            const schemaPath = join(project.root, ".kb", "schema.md");
+            const schemaLines = await readSchemaLines(schemaPath);
+            const block = await buildBlock(project.name, schemaLines);
+            if (!options.write) {
+                console.log(block);
+                return;
+            }
+            const claudeMdPath = join(project.root, "CLAUDE.md");
+            const exists = await fileExists(claudeMdPath);
+            if (exists) {
+                const existing = await readFile(claudeMdPath, "utf8");
+                await writeFile(claudeMdPath, `${existing}\n---\n${block}`, "utf8");
+            }
+            else {
+                await writeFile(claudeMdPath, block, "utf8");
+            }
+            console.log(chalk.green("Written to CLAUDE.md"));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`Error: ${message}`));
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=agent-context.js.map

package/dist/commands/agent-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.js","sourceRoot":"","sources":["../../src/commands/agent-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB;IACtD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,6CAA6C,CAAC;IACvD,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,WAAmB;IAEnB,OAAO,sBAAsB,WAAW;;;;;;;;;;;;;;;;;;;;EAoBxC,WAAW,EAAE,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAEzC,GAAG;SACA,WAAW,CAAC,6DAA6D,CAAC;SAC1E,MAAM,CAAC,SAAS,EAAE,2CAA2C,EAAE,KAAK,CAAC;SACrE,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACjD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;YAC1D,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAE1D,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;YAE9C,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;gBACtD,MAAM,SAAS,CAAC,YAAY,EAAE,GAAG,QAAQ,UAAU,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;YACtE,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC/C,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/agent-context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-context.test.d.ts.map

package/dist/commands/agent-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.test.d.ts","sourceRoot":"","sources":["../../src/commands/agent-context.test.ts"],"names":[],"mappings":""}

package/dist/commands/agent-context.test.js

@@ -0,0 +1,84 @@
+// packages/cli/src/commands/agent-context.test.ts
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm, writeFile, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { buildBlock, readSchemaLines } from "./agent-context.js";
+describe("buildBlock", () => {
+    it("includes the project name in the heading", async () => {
+        const block = await buildBlock("my-project", "## Schema\nConventions here.");
+        expect(block).toContain("## Knowledge Base: my-project");
+    });
+    it("includes all CLI commands", async () => {
+        const block = await buildBlock("test", "");
+        expect(block).toContain("kb search");
+        expect(block).toContain("kb ingest");
+        expect(block).toContain("kb query");
+        expect(block).toContain("kb lint");
+    });
+    it("includes all MCP tool names", async () => {
+        const block = await buildBlock("test", "");
+        expect(block).toContain("kb_search");
+        expect(block).toContain("kb_get_page");
+        expect(block).toContain("kb_lint");
+    });
+    it("includes the schema lines in the output", async () => {
+        const block = await buildBlock("test", "Custom schema content here.");
+        expect(block).toContain("Custom schema content here.");
+    });
+});
+describe("readSchemaLines", () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await mkdtemp(join(tmpdir(), "kb-agent-test-"));
+    });
+    afterEach(async () => {
+        await rm(tmpDir, { recursive: true, force: true });
+    });
+    it("returns fallback message when schema file does not exist", async () => {
+        const result = await readSchemaLines(join(tmpDir, "nonexistent.md"));
+        expect(result).toContain("schema.md");
+    });
+    it("returns first 20 lines of schema file", async () => {
+        const lines = Array.from({ length: 30 }, (_, i) => `Line ${i + 1}`);
+        await writeFile(join(tmpDir, "schema.md"), lines.join("\n"), "utf8");
+        const result = await readSchemaLines(join(tmpDir, "schema.md"));
+        const resultLines = result.split("\n");
+        expect(resultLines).toHaveLength(20);
+        expect(resultLines[0]).toBe("Line 1");
+        expect(resultLines[19]).toBe("Line 20");
+    });
+    it("returns full content when file has fewer than 20 lines", async () => {
+        await writeFile(join(tmpDir, "schema.md"), "Line 1\nLine 2\nLine 3", "utf8");
+        const result = await readSchemaLines(join(tmpDir, "schema.md"));
+        expect(result).toBe("Line 1\nLine 2\nLine 3");
+    });
+});
+describe("--write behavior (via file manipulation)", () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await mkdtemp(join(tmpdir(), "kb-write-test-"));
+    });
+    afterEach(async () => {
+        await rm(tmpDir, { recursive: true, force: true });
+    });
+    it("creates CLAUDE.md when it does not exist", async () => {
+        const claudePath = join(tmpDir, "CLAUDE.md");
+        const block = await buildBlock("test-project", "Schema.");
+        await writeFile(claudePath, block, "utf8");
+        const content = await readFile(claudePath, "utf8");
+        expect(content).toContain("## Knowledge Base: test-project");
+    });
+    it("appends to existing CLAUDE.md with separator", async () => {
+        const claudePath = join(tmpDir, "CLAUDE.md");
+        await writeFile(claudePath, "# Existing Content\n", "utf8");
+        const block = await buildBlock("test-project", "Schema.");
+        const existing = await readFile(claudePath, "utf8");
+        await writeFile(claudePath, `${existing}\n---\n${block}`, "utf8");
+        const content = await readFile(claudePath, "utf8");
+        expect(content).toContain("# Existing Content");
+        expect(content).toContain("---");
+        expect(content).toContain("## Knowledge Base: test-project");
+    });
+});
+//# sourceMappingURL=agent-context.test.js.map

package/dist/commands/agent-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.test.js","sourceRoot":"","sources":["../../src/commands/agent-context.test.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEjE,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,KAAK,GAAG,MAAM,UAAU,CAC5B,YAAY,EACZ,8BAA8B,CAC/B,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;QACtE,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,MAAc,CAAC;IAEnB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,SAAS,CACb,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EACzB,wBAAwB,EACxB,MAAM,CACP,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,IAAI,MAAc,CAAC;IAEnB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAC1D,MAAM,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7C,MAAM,SAAS,CAAC,UAAU,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,QAAQ,UAAU,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAChD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/index-cmd.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function makeIndexCommand(): Command;
+//# sourceMappingURL=index-cmd.d.ts.map

package/dist/commands/index-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,gBAAgB,IAAI,OAAO,CAuC1C"}

package/dist/commands/index-cmd.js

@@ -0,0 +1,40 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { loadProject, indexProject } from "kb-core";
+export function makeIndexCommand() {
+    const cmd = new Command("index");
+    cmd
+        .description("Index wiki pages into the search database")
+        .option("--rebuild", "delete all entries and re-index from scratch", false)
+        .action(async (options) => {
+        try {
+            const project = await loadProject(process.cwd());
+            console.log("Indexing wiki pages...");
+            const stats = await indexProject(project, options.rebuild);
+            const updated = stats.indexed;
+            const unchanged = stats.skipped;
+            const total = updated + unchanged;
+            const details = [];
+            if (updated > 0)
+                details.push(`${updated} updated`);
+            if (unchanged > 0)
+                details.push(`${unchanged} unchanged`);
+            if (stats.deleted > 0)
+                details.push(`${stats.deleted} deleted`);
+            if (stats.errors > 0)
+                details.push(`${stats.errors} errors`);
+            const detailStr = details.length > 0 ? ` (${details.join(", ")})` : "";
+            console.log(`${chalk.green("✓")} Indexed ${total} page${total !== 1 ? "s" : ""}${detailStr}`);
+            if (stats.errors > 0) {
+                process.exit(1);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`Error: ${message}`));
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=index-cmd.js.map

package/dist/commands/index-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-cmd.js","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEpD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjC,GAAG;SACA,WAAW,CAAC,2CAA2C,CAAC;SACxD,MAAM,CAAC,WAAW,EAAE,8CAA8C,EAAE,KAAK,CAAC;SAC1E,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YAEtC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAE3D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC;YAChC,MAAM,KAAK,GAAG,OAAO,GAAG,SAAS,CAAC;YAElC,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAI,OAAO,GAAG,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,UAAU,CAAC,CAAC;YACpD,IAAI,SAAS,GAAG,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,YAAY,CAAC,CAAC;YAC1D,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;YAChE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;YAE7D,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,OAAO,CAAC,GAAG,CACT,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,CACjF,CAAC;YAEF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/ingest.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function makeIngestCommand(): Command;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/commands/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0EpC,wBAAgB,iBAAiB,IAAI,OAAO,CA4D3C"}

package/dist/commands/ingest.js

@@ -0,0 +1,103 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { readdir, stat } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { loadProject, ingestSource, createLlmAdapter } from "kb-core";
+function printPlan(plan, sourcePath) {
+    const sourceBase = basename(sourcePath);
+    const sourceFilename = basename(plan.sourceFile);
+    const { result } = plan;
+    console.log(chalk.yellow("Dry run — use --apply to write changes\n"));
+    console.log(`Source: ${chalk.cyan(sourceBase)} → ${chalk.cyan(`sources/${sourceFilename}`)}`);
+    const hasChanges = result.newPages.length > 0 ||
+        result.updates.length > 0 ||
+        result.summary.path;
+    if (!hasChanges) {
+        console.log(chalk.gray("\nNo changes would be made."));
+        return;
+    }
+    console.log(chalk.bold("\nWould create:"));
+    console.log(`  ${chalk.green("+")} ${result.summary.path} ${chalk.gray("(new page)")}`);
+    for (const p of result.newPages) {
+        console.log(`  ${chalk.green("+")} ${p.path} ${chalk.gray(`(new page)`)}`);
+    }
+    if (result.updates.length > 0) {
+        console.log(chalk.bold("\nWould update:"));
+        for (const u of result.updates) {
+            console.log(`  ${chalk.yellow("~")} ${u.path} ${chalk.gray(`(${u.reason})`)}`);
+        }
+    }
+    console.log(`\nWould update index: ${chalk.cyan("wiki/_index.md")}`);
+    console.log(`Log entry: ${chalk.gray(`"${result.logEntry}"`)}`);
+    console.log(chalk.gray("\nRun with --apply to write these changes."));
+}
+function printApplied(plan, sourcePath) {
+    const sourceBase = basename(sourcePath);
+    const sourceFilename = basename(plan.sourceFile);
+    const { result } = plan;
+    console.log(`${chalk.green("✓")} Ingested ${chalk.cyan(sourceBase)} → ${chalk.cyan(`sources/${sourceFilename}`)}`);
+    console.log(`  ${chalk.green("+")} ${result.summary.path}`);
+    for (const p of result.newPages) {
+        console.log(`  ${chalk.green("+")} ${p.path}`);
+    }
+    for (const u of result.updates) {
+        console.log(`  ${chalk.yellow("~")} ${u.path}`);
+    }
+    console.log(`  ${chalk.yellow("~")} wiki/_index.md`);
+    console.log(chalk.gray(`  Log: "${result.logEntry}"`));
+}
+async function collectFiles(dirPath) {
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    return entries.filter((e) => e.isFile()).map((e) => join(dirPath, e.name));
+}
+export function makeIngestCommand() {
+    const cmd = new Command("ingest");
+    cmd
+        .description("Ingest a source document into the wiki using LLM")
+        .argument("<source-path>", "path to file or URL to ingest")
+        .option("--apply", "write changes to wiki (default: dry-run)", false)
+        .option("--batch", "process all files in a directory", false)
+        .action(async (sourcePath, options) => {
+        try {
+            const project = await loadProject(process.cwd());
+            const llm = createLlmAdapter(project.config);
+            let sources;
+            if (options.batch) {
+                const s = await stat(sourcePath);
+                if (!s.isDirectory()) {
+                    console.error(chalk.red("Error: --batch requires a directory path"));
+                    process.exit(1);
+                }
+                sources = await collectFiles(sourcePath);
+                if (sources.length === 0) {
+                    console.log(chalk.gray("No files found in directory."));
+                    return;
+                }
+            }
+            else {
+                sources = [sourcePath];
+            }
+            for (const src of sources) {
+                if (options.batch) {
+                    console.log(chalk.bold(`\nProcessing: ${basename(src)}`));
+                }
+                const plan = await ingestSource(project, src, llm, {
+                    apply: options.apply,
+                });
+                if (plan.dryRun) {
+                    printPlan(plan, src);
+                }
+                else {
+                    printApplied(plan, src);
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`Error: ${message}`));
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=ingest.js.map

package/dist/commands/ingest.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function makeInitCommand(): Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,eAAe,IAAI,OAAO,CAoCzC"}

package/dist/commands/init.js

@@ -0,0 +1,34 @@
+import { Command } from "commander";
+import { basename, resolve } from "node:path";
+import chalk from "chalk";
+import { initProject } from "kb-core";
+export function makeInitCommand() {
+    const cmd = new Command("init");
+    cmd
+        .description("Initialize a new knowledge base in the current directory")
+        .argument("[project-name]", "Name of the project (defaults to directory name)")
+        .action(async (projectName) => {
+        const directory = resolve(process.cwd());
+        const name = projectName ?? basename(directory);
+        try {
+            await initProject({ name, directory });
+            console.log(chalk.green(`✓ Knowledge base initialized: ${name}`));
+            console.log("");
+            console.log(chalk.dim("Created:"));
+            console.log(chalk.dim("  .kb/config.toml    — project manifest"));
+            console.log(chalk.dim("  .kb/schema.md      — LLM instructions"));
+            console.log(chalk.dim("  sources/           — raw source materials"));
+            console.log(chalk.dim("  wiki/_index.md     — wiki root"));
+            console.log(chalk.dim("  log.md             — activity log"));
+            console.log("");
+            console.log(chalk.cyan(`Run ${chalk.bold("kb ingest <source>")} to add content.`));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`Error: ${message}`));
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhC,GAAG;SACA,WAAW,CAAC,0DAA0D,CAAC;SACvE,QAAQ,CACP,gBAAgB,EAChB,kDAAkD,CACnD;SACA,MAAM,CAAC,KAAK,EAAE,WAA+B,EAAE,EAAE;QAChD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,WAAW,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YAEvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CACtE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/lint.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function makeLintCommand(): Command;
+//# sourceMappingURL=lint.d.ts.map

package/dist/commands/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,eAAe,IAAI,OAAO,CAqEzC"}

package/dist/commands/lint.js

@@ -0,0 +1,53 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { loadProject, lintProject } from "kb-core";
+export function makeLintCommand() {
+    const cmd = new Command("lint");
+    cmd
+        .description("Check wiki health for broken links, orphan pages, and more")
+        .option("--deep", "LLM-assisted checks (Phase 2)", false)
+        .action(async (options) => {
+        try {
+            if (options.deep) {
+                console.log(chalk.yellow("--deep requires LLM, not yet implemented"));
+                return;
+            }
+            const project = await loadProject(process.cwd());
+            console.log("Checking wiki health...\n");
+            const result = await lintProject(project);
+            if (result.issues.length === 0) {
+                console.log(chalk.green(`✓ Wiki is healthy (${result.pagesChecked} pages checked)`));
+                return;
+            }
+            for (const issue of result.issues) {
+                const code = chalk.gray(`[${issue.code}]`);
+                if (issue.severity === "warning") {
+                    if (issue.code === "BROKEN_LINK") {
+                        console.log(`${chalk.yellow("⚠")}  ${chalk.cyan(issue.path)} → [[${issue.detail}]] not found ${code}`);
+                    }
+                    else {
+                        console.log(`${chalk.yellow("⚠")}  ${chalk.cyan(issue.path)} — ${issue.message} ${code}`);
+                    }
+                }
+                else {
+                    console.log(`${chalk.blue("ℹ")}  ${chalk.cyan(issue.path)} — ${issue.message} ${code}`);
+                }
+            }
+            const warnings = result.issues.filter((i) => i.severity === "warning").length;
+            const infos = result.issues.filter((i) => i.severity === "info").length;
+            const parts = [];
+            if (warnings > 0)
+                parts.push(`${chalk.yellow(String(warnings))} warning${warnings !== 1 ? "s" : ""}`);
+            if (infos > 0)
+                parts.push(`${chalk.blue(String(infos))} info`);
+            console.log(`\nFound ${parts.join(", ")}. Run with --deep for LLM-assisted checks.`);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`Error: ${message}`));
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

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

package/dist/commands/log-cmd.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function makeLogCommand(): Command;
+//# sourceMappingURL=log-cmd.d.ts.map

package/dist/commands/log-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/log-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,cAAc,IAAI,OAAO,CAiDxC"}

package/dist/commands/log-cmd.js

@@ -0,0 +1,50 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { loadProject, parseLogEntries } from "kb-core";
+export function makeLogCommand() {
+    const cmd = new Command("log");
+    cmd
+        .description("Show recent activity log entries")
+        .option("--last <n>", "number of entries to show", "10")
+        .action(async (options) => {
+        try {
+            const project = await loadProject(process.cwd());
+            const logPath = join(project.wikiDir, "log.md");
+            let content;
+            try {
+                content = await readFile(logPath, "utf8");
+            }
+            catch {
+                console.log(chalk.gray("No activity log found."));
+                return;
+            }
+            const n = parseInt(options.last, 10);
+            if (isNaN(n) || n < 1) {
+                console.error(chalk.red("Error: --last must be a positive integer"));
+                process.exit(1);
+            }
+            const entries = parseLogEntries(content);
+            if (entries.length === 0) {
+                console.log(chalk.gray("Activity log is empty."));
+                return;
+            }
+            const last = entries.slice(-n);
+            for (const entry of last) {
+                console.log(chalk.bold(`## ${entry.heading}`));
+                if (entry.body) {
+                    console.log(entry.body);
+                }
+                console.log();
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`Error: ${message}`));
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=log-cmd.js.map

package/dist/commands/log-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-cmd.js","sourceRoot":"","sources":["../../src/commands/log-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAuB,MAAM,SAAS,CAAC;AAE5E,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAE/B,GAAG;SACA,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,YAAY,EAAE,2BAA2B,EAAE,IAAI,CAAC;SACvD,MAAM,CAAC,KAAK,EAAE,OAAyB,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEhD,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YAED,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACrC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC,CAAC;gBACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAEzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAE/B,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC/C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;gBACD,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function makeMcpCommand(): Command;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,cAAc,IAAI,OAAO,CAMxC"}

package/dist/commands/mcp.js

@@ -0,0 +1,10 @@
+import { Command } from "commander";
+import { startMcpServer } from "kb-mcp";
+export function makeMcpCommand() {
+    return new Command("mcp")
+        .description("Start MCP server (stdio)")
+        .action(async () => {
+        await startMcpServer();
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;SACtB,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/query.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function makeQueryCommand(): Command;
+//# sourceMappingURL=query.d.ts.map

package/dist/commands/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,gBAAgB,IAAI,OAAO,CAmC1C"}