@knowledgine/cli 0.1.0 → 0.2.1

package/dist/commands/tool.js

@@ -0,0 +1,247 @@
+import { resolve } from "path";
+import { existsSync } from "fs";
+import { loadConfig, resolveDefaultPath, createDatabase, Migrator, KnowledgeRepository, GraphRepository, ALL_MIGRATIONS, KnowledgeService, } from "@knowledgine/core";
+import { formatSearchResults, formatRelatedNotes, formatStats, formatEntities, } from "../lib/formatter.js";
+const CLI_ERRORS = {
+    NOT_INITIALIZED: 'Not initialized. Run "knowledgine init --path <dir>" first.',
+    GRAPH_NOT_AVAILABLE: "Knowledge graph is not available. Run init with graph support.",
+    FEEDBACK_NOT_AVAILABLE: "Feedback system is not available.",
+    NOTE_ID_OR_FILE_REQUIRED: "Either --id <noteId> or --file <path> is required.",
+    ENTITY_ID_OR_NAME_REQUIRED: "Either entityId or entityName is required.",
+    INVALID_PATH: "Invalid file path: outside of root directory.",
+};
+function validateLimit(value) {
+    if (value === undefined)
+        return 20;
+    const n = parseInt(value, 10);
+    if (isNaN(n) || n < 1 || n > 10000)
+        throw new Error("--limit must be a positive integer (1-10000)");
+    return n;
+}
+function validateMode(value) {
+    if (value === undefined)
+        return "keyword";
+    if (!["keyword", "semantic", "hybrid"].includes(value))
+        throw new Error("--mode must be one of: keyword, semantic, hybrid");
+    return value;
+}
+function validateFormat(value) {
+    if (value === undefined)
+        return "table";
+    if (!["json", "table", "plain"].includes(value))
+        throw new Error("--format must be one of: json, table, plain");
+    return value;
+}
+export async function toolSearchCommand(query, options) {
+    const rootPath = resolveDefaultPath(options.path);
+    const knowledgineDir = resolve(rootPath, ".knowledgine");
+    if (!existsSync(knowledgineDir)) {
+        console.error(CLI_ERRORS.NOT_INITIALIZED);
+        process.exitCode = 1;
+        return;
+    }
+    let limit;
+    let mode;
+    let format;
+    try {
+        limit = validateLimit(options.limit);
+        mode = validateMode(options.mode);
+        format = validateFormat(options.format);
+    }
+    catch (e) {
+        console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
+        process.exitCode = 1;
+        return;
+    }
+    const config = loadConfig(rootPath);
+    const db = createDatabase(config.dbPath);
+    try {
+        new Migrator(db, ALL_MIGRATIONS).migrate();
+        const repository = new KnowledgeRepository(db);
+        const graphRepository = new GraphRepository(db);
+        const service = new KnowledgeService({ repository, rootPath, graphRepository });
+        const result = await service.search({ query, limit, mode });
+        if (result.results.length === 0) {
+            console.error(`No results for "${query}"`);
+        }
+        else {
+            console.error(formatSearchResults(result.results, format));
+        }
+    }
+    catch (error) {
+        console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+    }
+    finally {
+        db.close();
+    }
+}
+export async function toolRelatedCommand(options) {
+    const rootPath = resolveDefaultPath(options.path);
+    const knowledgineDir = resolve(rootPath, ".knowledgine");
+    if (!existsSync(knowledgineDir)) {
+        console.error(CLI_ERRORS.NOT_INITIALIZED);
+        process.exitCode = 1;
+        return;
+    }
+    if (!options.id && !options.file) {
+        console.error(`Error: ${CLI_ERRORS.NOTE_ID_OR_FILE_REQUIRED}`);
+        process.exitCode = 1;
+        return;
+    }
+    let limit;
+    let format;
+    try {
+        limit = validateLimit(options.limit);
+        format = validateFormat(options.format);
+    }
+    catch (e) {
+        console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
+        process.exitCode = 1;
+        return;
+    }
+    const noteId = options.id ? parseInt(options.id, 10) : undefined;
+    if (options.id && (isNaN(noteId) || noteId < 1)) {
+        console.error("Error: --id must be a positive integer");
+        process.exitCode = 1;
+        return;
+    }
+    const config = loadConfig(rootPath);
+    const db = createDatabase(config.dbPath);
+    try {
+        new Migrator(db, ALL_MIGRATIONS).migrate();
+        const repository = new KnowledgeRepository(db);
+        const graphRepository = new GraphRepository(db);
+        const service = new KnowledgeService({ repository, rootPath, graphRepository });
+        const result = await service.findRelated({
+            noteId,
+            filePath: options.file,
+            limit,
+        });
+        console.error(formatRelatedNotes(result, format));
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        if (msg.includes("Invalid file path")) {
+            console.error(`Error: ${CLI_ERRORS.INVALID_PATH}`);
+        }
+        else {
+            console.error(`Error: ${msg}`);
+        }
+        process.exitCode = 1;
+    }
+    finally {
+        db.close();
+    }
+}
+export async function toolStatsCommand(options) {
+    const rootPath = resolveDefaultPath(options.path);
+    const knowledgineDir = resolve(rootPath, ".knowledgine");
+    if (!existsSync(knowledgineDir)) {
+        console.error(CLI_ERRORS.NOT_INITIALIZED);
+        process.exitCode = 1;
+        return;
+    }
+    let format;
+    try {
+        format = validateFormat(options.format);
+    }
+    catch (e) {
+        console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
+        process.exitCode = 1;
+        return;
+    }
+    const config = loadConfig(rootPath);
+    const db = createDatabase(config.dbPath);
+    try {
+        new Migrator(db, ALL_MIGRATIONS).migrate();
+        const repository = new KnowledgeRepository(db);
+        const graphRepository = new GraphRepository(db);
+        const service = new KnowledgeService({ repository, rootPath, graphRepository });
+        const result = service.getStats();
+        console.error(formatStats(result, format));
+    }
+    catch (error) {
+        console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+    }
+    finally {
+        db.close();
+    }
+}
+export async function toolEntitiesCommand(query, options) {
+    const rootPath = resolveDefaultPath(options.path);
+    const knowledgineDir = resolve(rootPath, ".knowledgine");
+    if (!existsSync(knowledgineDir)) {
+        console.error(CLI_ERRORS.NOT_INITIALIZED);
+        process.exitCode = 1;
+        return;
+    }
+    let limit;
+    let format;
+    try {
+        limit = validateLimit(options.limit);
+        format = validateFormat(options.format);
+    }
+    catch (e) {
+        console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
+        process.exitCode = 1;
+        return;
+    }
+    const config = loadConfig(rootPath);
+    const db = createDatabase(config.dbPath);
+    try {
+        new Migrator(db, ALL_MIGRATIONS).migrate();
+        const repository = new KnowledgeRepository(db);
+        const graphRepository = new GraphRepository(db);
+        const service = new KnowledgeService({ repository, rootPath, graphRepository });
+        const result = service.searchEntities({ query, limit });
+        if (result.totalResults === 0) {
+            console.error(`No entities found for "${query}"`);
+        }
+        else {
+            console.error(formatEntities(result, format));
+        }
+    }
+    catch (error) {
+        console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+    }
+    finally {
+        db.close();
+    }
+}
+export function registerToolCommands(program) {
+    const toolCmd = program.command("tool").description("Knowledge base query tools");
+    toolCmd
+        .command("search <query>")
+        .description("Search indexed notes")
+        .option("--path <dir>", "Root directory")
+        .option("--limit <n>", "Maximum results (1-10000)", "20")
+        .option("--mode <mode>", "Search mode: keyword, semantic, hybrid", "keyword")
+        .option("--format <format>", "Output format: json, table, plain", "table")
+        .action(toolSearchCommand);
+    toolCmd
+        .command("related")
+        .description("Find related notes for a given note")
+        .option("--path <dir>", "Root directory")
+        .option("--id <noteId>", "Note ID")
+        .option("--file <path>", "File path")
+        .option("--limit <n>", "Maximum results (1-10000)", "5")
+        .option("--format <format>", "Output format: json, table, plain", "table")
+        .action(toolRelatedCommand);
+    toolCmd
+        .command("stats")
+        .description("Show knowledge base statistics")
+        .option("--path <dir>", "Root directory")
+        .option("--format <format>", "Output format: json, table, plain", "table")
+        .action(toolStatsCommand);
+    toolCmd
+        .command("entities <query>")
+        .description("Search entities in the knowledge graph")
+        .option("--path <dir>", "Root directory")
+        .option("--limit <n>", "Maximum results (1-10000)", "20")
+        .option("--format <format>", "Output format: json, table, plain", "table")
+        .action(toolEntitiesCommand);
+}
+//# sourceMappingURL=tool.js.map

package/dist/commands/tool.js.map

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

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,6 @@
+export interface UpgradeOptions {
+    semantic?: boolean;
+    path?: string;
+}
+export declare function upgradeCommand(options: UpgradeOptions): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA8J3E"}

package/dist/commands/upgrade.js

@@ -0,0 +1,137 @@
+import { resolve } from "path";
+import { existsSync } from "fs";
+import { loadConfig, writeRcConfig, resolveDefaultPath, createDatabase, loadSqliteVecExtension, Migrator, KnowledgeRepository, ALL_MIGRATIONS, OnnxEmbeddingProvider, ModelManager, DEFAULT_MODEL_NAME, downloadModel, } from "@knowledgine/core";
+import { createProgress } from "../lib/progress.js";
+import { colors, symbols, createBox } from "../lib/ui/index.js";
+export async function upgradeCommand(options) {
+    const rootPath = resolveDefaultPath(options.path);
+    if (!options.semantic) {
+        console.error("Usage: knowledgine upgrade --semantic");
+        console.error("");
+        console.error("Available upgrades:");
+        console.error("  --semantic   Enable semantic search (download model + generate embeddings)");
+        return;
+    }
+    // Check initialization
+    const knowledgineDir = resolve(rootPath, ".knowledgine");
+    if (!existsSync(knowledgineDir)) {
+        console.error(colors.error(`Error: Not initialized. Run 'knowledgine init --path ${rootPath}' first.`));
+        process.exitCode = 1;
+        return;
+    }
+    const config = loadConfig(rootPath);
+    config.embedding.enabled = true;
+    const db = createDatabase(config.dbPath);
+    const vecLoaded = await loadSqliteVecExtension(db);
+    new Migrator(db, ALL_MIGRATIONS).migrate();
+    // Ensure vec0 virtual table exists and is populated
+    if (vecLoaded) {
+        // Create vec table if it doesn't exist
+        try {
+            db.prepare("SELECT COUNT(*) FROM note_embeddings_vec").get();
+        }
+        catch {
+            db.exec(`
+        CREATE VIRTUAL TABLE IF NOT EXISTS note_embeddings_vec USING vec0(
+          note_id INTEGER PRIMARY KEY,
+          embedding FLOAT[384]
+        );
+        CREATE TRIGGER IF NOT EXISTS note_embeddings_ad AFTER DELETE ON note_embeddings BEGIN
+          DELETE FROM note_embeddings_vec WHERE note_id = old.note_id;
+        END;
+      `);
+        }
+        // Backfill: sync embeddings that exist in note_embeddings but not in note_embeddings_vec
+        const vecCount = db.prepare("SELECT COUNT(*) as c FROM note_embeddings_vec").get().c;
+        const embCount = db.prepare("SELECT COUNT(*) as c FROM note_embeddings").get().c;
+        if (embCount > 0 && vecCount < embCount) {
+            // Find embeddings missing from vec table
+            const missing = db
+                .prepare(`
+        SELECT e.note_id, e.embedding FROM note_embeddings e
+        WHERE e.note_id NOT IN (SELECT note_id FROM note_embeddings_vec)
+      `)
+                .all();
+            if (missing.length > 0) {
+                const insert = db.prepare("INSERT INTO note_embeddings_vec (note_id, embedding) VALUES (CAST(? AS INTEGER), ?)");
+                const tx = db.transaction(() => {
+                    for (const row of missing) {
+                        insert.run(row.note_id, row.embedding);
+                    }
+                });
+                tx();
+                console.error(`Synced ${missing.length} embeddings into vector index.`);
+            }
+        }
+    }
+    const repository = new KnowledgeRepository(db);
+    // Download model
+    const modelManager = new ModelManager();
+    if (!modelManager.isModelAvailable()) {
+        console.error(colors.info("Downloading embedding model (~23MB)..."));
+        try {
+            await downloadModel(modelManager, {
+                onProgress: (progress) => {
+                    if (progress.total) {
+                        const mb = (progress.downloaded / (1024 * 1024)).toFixed(1);
+                        const totalMb = (progress.total / (1024 * 1024)).toFixed(1);
+                        process.stderr.write(`\r  ${progress.file}: ${mb}/${totalMb} MB`);
+                    }
+                },
+                onFileComplete: (file) => {
+                    process.stderr.write(`\r  ${symbols.success} ${file}          \n`);
+                },
+            });
+            console.error(`${symbols.success} ${colors.success("Model download complete.")}`);
+        }
+        catch (error) {
+            console.error(colors.error(`\nModel download failed: ${error instanceof Error ? error.message : String(error)}`));
+            console.error(colors.error("Semantic search upgrade aborted."));
+            db.close();
+            process.exitCode = 1;
+            return;
+        }
+    }
+    else {
+        console.error(`${symbols.success} ${colors.success("Embedding model already available.")}`);
+    }
+    // Generate embeddings for notes that don't have them
+    const embeddingProvider = new OnnxEmbeddingProvider(DEFAULT_MODEL_NAME, modelManager);
+    const notesWithout = repository.getNotesWithoutEmbeddings();
+    if (notesWithout.length > 0) {
+        // Warm up the ONNX session (first call is slow due to model loading)
+        console.error(colors.info("\nLoading embedding model..."));
+        await embeddingProvider.embed("warmup");
+        console.error("");
+        const embProgress = createProgress(notesWithout.length, "Generating embeddings");
+        let generated = 0;
+        let failed = 0;
+        for (const note of notesWithout) {
+            try {
+                const embedding = await embeddingProvider.embed(note.content);
+                repository.saveEmbedding(note.id, embedding, config.embedding.modelName);
+                generated++;
+                embProgress.update(generated);
+            }
+            catch {
+                failed++;
+            }
+        }
+        embProgress.finish();
+        console.error(`  ${symbols.success} ${colors.success(`Generated: ${generated}`)}, Failed: ${failed}`);
+    }
+    else {
+        console.error(`${symbols.success} ${colors.success("All notes already have embeddings.")}`);
+    }
+    // Write .knowledginerc.json
+    writeRcConfig(rootPath, { semantic: true });
+    console.error("\n" +
+        createBox([
+            `${symbols.success} ${colors.success("Semantic search enabled")}`,
+            `  Config: .knowledginerc.json written`,
+            "",
+            `${symbols.arrow} ${colors.hint("Restart MCP server to activate.")}`,
+        ].join("\n"), { title: "Upgrade Complete", type: "success" }));
+    db.close();
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/commands/upgrade.js.map

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

package/dist/index.js

@@ -3,20 +3,196 @@ import { Command } from "commander";
 import { VERSION } from "@knowledgine/core";
 import { initCommand } from "./commands/init.js";
 import { startCommand } from "./commands/start.js";
+import { setupCommand } from "./commands/setup.js";
+import { statusCommand } from "./commands/status.js";
+import { upgradeCommand } from "./commands/upgrade.js";
+import { ingestCommand } from "./commands/ingest.js";
+import { pluginsListCommand, pluginsStatusCommand } from "./commands/plugins.js";
+import { feedbackListCommand, feedbackApplyCommand, feedbackDismissCommand, feedbackStatsCommand, feedbackReportCommand, } from "./commands/feedback.js";
+import { demoCommand } from "./commands/demo.js";
+import { searchCommand } from "./commands/search.js";
+import { captureAddCommand, captureListCommand, captureDeleteCommand } from "./commands/capture.js";
+import { registerToolCommands } from "./commands/tool.js";
+import { createOutputErrorHandler } from "./lib/unknown-command-handler.js";
 const program = new Command();
 program
     .name("knowledgine")
     .description("Developer Knowledge Infrastructure - Extract structured knowledge from your codebase")
-    .version(VERSION);
+    .version(VERSION)
+    .addHelpText("after", `
+Workflow:
+  1. knowledgine init --path ~/notes    Index your files (FTS5 full-text search)
+  2. knowledgine setup --target claude-desktop  Configure AI tool
+  3. knowledgine start --path ~/notes    Start MCP server
+
+Optional:
+  knowledgine upgrade --semantic         Enable semantic search (downloads ~23MB model)
+
+Run 'knowledgine <command> --help' for more information on a command.`);
 program
     .command("init")
-    .description("Scan and index markdown files in the current directory")
+    .description("Scan and index markdown files (FTS5 full-text search by default)")
     .option("--path <dir>", "Root directory to scan")
+    .option("--semantic", "Enable semantic search (download model + generate embeddings)")
+    .option("--skip-embeddings", "[deprecated] Use default behavior instead (embeddings are now opt-in)")
+    .option("--demo", "Initialize with sample demo notes")
+    .addHelpText("after", `
+Examples:
+  knowledgine init --path ~/notes
+  knowledgine init --path ~/project --semantic
+  knowledgine init --demo`)
     .action(initCommand);
 program
     .command("start")
     .description("Start MCP server with file watching")
     .option("--path <dir>", "Root directory to serve")
+    .option("--ingest", "Enable IngestEngine for all plugins")
+    .addHelpText("after", `
+Example:
+  knowledgine start --path ~/notes
+  knowledgine start --path ~/notes --ingest`)
     .action(startCommand);
+program
+    .command("setup")
+    .description("Generate MCP configuration for AI tools")
+    .option("--target <tool>", "Target AI tool (claude-desktop, cursor, claude-code)")
+    .option("--path <dir>", "Root directory of indexed notes")
+    .option("--write", "Write configuration to file (default: dry-run)")
+    .addHelpText("after", `
+Examples:
+  knowledgine setup --target claude-desktop --path ~/notes
+  knowledgine setup --target cursor --path ~/notes --write
+  knowledgine setup --target claude-code --path ~/notes`)
+    .action(setupCommand);
+program
+    .command("status")
+    .description("Check knowledgine setup and configuration status")
+    .option("--path <dir>", "Root directory to check")
+    .addHelpText("after", `
+Example:
+  knowledgine status --path ~/notes`)
+    .action(statusCommand);
+program
+    .command("upgrade")
+    .description("Upgrade knowledgine capabilities")
+    .option("--semantic", "Enable semantic search (download model + generate embeddings)")
+    .option("--path <dir>", "Root directory")
+    .addHelpText("after", `
+Example:
+  knowledgine upgrade --semantic --path ~/notes`)
+    .action(upgradeCommand);
+program
+    .command("ingest")
+    .description("Ingest knowledge from configured sources")
+    .option("--source <pluginId>", "Specific plugin to run")
+    .option("--path <dir>", "Root directory")
+    .option("--full", "Force full re-ingest (ignore cursor)")
+    .option("--all", "Run all registered plugins")
+    .option("--repo <owner/repo>", "GitHub repository (required for --source github)")
+    .addHelpText("after", `
+Examples:
+  knowledgine ingest --source markdown --path ~/notes
+  knowledgine ingest --source github --repo owner/repo --path ~/notes
+  knowledgine ingest --source claude-sessions --path ~/notes
+  knowledgine ingest --all --path ~/notes
+  knowledgine ingest --source markdown --full --path ~/notes`)
+    .action(ingestCommand);
+const pluginsCmd = program.command("plugins").description("Manage ingest plugins");
+pluginsCmd.command("list").description("List registered plugins").action(pluginsListCommand);
+pluginsCmd
+    .command("status")
+    .option("--path <dir>", "Root directory")
+    .description("Show plugin ingest status")
+    .action(pluginsStatusCommand);
+const feedbackCmd = program.command("feedback").description("Manage extraction feedback");
+feedbackCmd
+    .command("list")
+    .description("List feedback records")
+    .option("--status <status>", "Filter by status (pending, applied, dismissed)")
+    .option("--path <dir>", "Root directory")
+    .action(feedbackListCommand);
+feedbackCmd
+    .command("apply <id>")
+    .description("Apply feedback and update extraction rules")
+    .option("--path <dir>", "Root directory")
+    .action(feedbackApplyCommand);
+feedbackCmd
+    .command("dismiss <id>")
+    .description("Dismiss feedback without applying")
+    .option("--path <dir>", "Root directory")
+    .action(feedbackDismissCommand);
+feedbackCmd
+    .command("stats")
+    .description("Show feedback statistics")
+    .option("--path <dir>", "Root directory")
+    .action(feedbackStatsCommand);
+feedbackCmd
+    .command("report")
+    .description("Report an entity extraction error")
+    .requiredOption("--entity <name>", "Entity name")
+    .requiredOption("--type <errorType>", "Error type: false_positive, wrong_type, missed_entity")
+    .option("--entity-type <type>", "Current entity type")
+    .option("--correct-type <type>", "Correct entity type (for wrong_type)")
+    .option("--details <text>", "Additional details")
+    .option("--path <dir>", "Root directory")
+    .action(feedbackReportCommand);
+program
+    .command("demo")
+    .description("Show demo usage information or clean up demo files")
+    .option("--clean", "Remove demo notes and data")
+    .action(demoCommand);
+program
+    .command("search <query>")
+    .description("Search indexed notes")
+    .option("--demo", "Search in demo notes")
+    .option("--mode <mode>", "Search mode: keyword, semantic, hybrid", "keyword")
+    .option("--limit <n>", "Maximum results", "20")
+    .option("--format <format>", "Output format: json, table, plain", "plain")
+    .option("--related <noteId>", "Find related notes by note ID")
+    .option("--related-file <path>", "Find related notes by file path")
+    .option("--path <dir>", "Root directory")
+    .action((query, opts) => {
+    return searchCommand(query, {
+        demo: opts.demo,
+        mode: opts.mode,
+        limit: Number(opts.limit),
+        format: opts.format,
+        related: opts.related,
+        relatedFile: opts.relatedFile,
+        path: opts.path,
+    });
+});
+const captureCmd = program.command("capture").description("Capture and manage knowledge snippets");
+captureCmd
+    .command("add [text]")
+    .description("Capture knowledge from text, URL, or file")
+    .option("-u, --url <url>", "URL to fetch and capture")
+    .option("-f, --file <path>", "File path to capture")
+    .option("-t, --tags <tags>", "Comma-separated tags")
+    .option("--title <title>", "Title for the captured knowledge")
+    .option("--path <dir>", "Root directory")
+    .option("--format <format>", "Output format: json, plain", "plain")
+    .action(captureAddCommand);
+captureCmd
+    .command("list")
+    .description("List captured notes")
+    .option("--path <dir>", "Root directory")
+    .option("--format <format>", "Output format: json, plain", "plain")
+    .action(captureListCommand);
+captureCmd
+    .command("delete <id>")
+    .description("Delete a captured note")
+    .option("--path <dir>", "Root directory")
+    .action(captureDeleteCommand);
+registerToolCommands(program);
+program.showSuggestionAfterError(true);
+program.configureOutput({
+    outputError: createOutputErrorHandler(() => program.commands.map((c) => c.name())),
+});
+// Global error handler for unhandled exceptions (e.g., native module errors)
+process.on("uncaughtException", (error) => {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+});
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CACV,sFAAsF,CACvF;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,wDAAwD,CAAC;KACrE,MAAM,CAAC,cAAc,EAAE,wBAAwB,CAAC;KAChD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,cAAc,EAAE,yBAAyB,CAAC;KACjD,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/demo-manager.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolve the path to the bundled demo fixture notes.
+ * Works from both src/ (development) and dist/ (published package).
+ */
+export declare function getDemoDir(): string;
+/**
+ * Copy demo fixtures into the target directory.
+ * Returns the number of markdown files copied.
+ */
+export declare function copyDemoFixtures(targetDir: string): number;
+/**
+ * Remove the demo notes directory.
+ * Only removes the notes directory — does NOT touch .knowledgine.
+ */
+export declare function cleanDemo(demoPath: string): void;
+//# sourceMappingURL=demo-manager.d.ts.map

package/dist/lib/demo-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-manager.d.ts","sourceRoot":"","sources":["../../src/lib/demo-manager.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAMnC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIhD"}