@knowledgine/cli 0.1.0 → 0.2.0

package/dist/commands/tool.js

@@ -0,0 +1,247 @@
+import { resolve } from "path";
+import { existsSync } from "fs";
+import { loadConfig, 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 = options.path ? resolve(options.path) : resolve(process.cwd());
+    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 = options.path ? resolve(options.path) : resolve(process.cwd());
+    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 = options.path ? resolve(options.path) : resolve(process.cwd());
+    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 = options.path ? resolve(options.path) : resolve(process.cwd());
+    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":"AAgBA,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,CA+F3E"}

package/dist/commands/upgrade.js

@@ -0,0 +1,91 @@
+import { resolve } from "path";
+import { existsSync } from "fs";
+import { loadConfig, writeRcConfig, createDatabase, loadSqliteVecExtension, Migrator, KnowledgeRepository, ALL_MIGRATIONS, OnnxEmbeddingProvider, ModelManager, downloadModel, } from "@knowledgine/core";
+import { createProgress } from "../lib/progress.js";
+export async function upgradeCommand(options) {
+    const rootPath = resolve(options.path ?? process.cwd());
+    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(`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);
+    await loadSqliteVecExtension(db);
+    new Migrator(db, ALL_MIGRATIONS).migrate();
+    const repository = new KnowledgeRepository(db);
+    // Download model
+    const modelManager = new ModelManager();
+    if (!modelManager.isModelAvailable()) {
+        console.error("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  [done] ${file}          \n`);
+                },
+            });
+            console.error("Model download complete.");
+        }
+        catch (error) {
+            console.error(`\nModel download failed: ${error instanceof Error ? error.message : String(error)}`);
+            console.error("Semantic search upgrade aborted.");
+            db.close();
+            process.exitCode = 1;
+            return;
+        }
+    }
+    else {
+        console.error("Embedding model already available.");
+    }
+    // Generate embeddings for notes that don't have them
+    const embeddingProvider = new OnnxEmbeddingProvider(undefined, modelManager);
+    const notesWithout = repository.getNotesWithoutEmbeddings();
+    if (notesWithout.length > 0) {
+        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(`  Generated: ${generated}, Failed: ${failed}`);
+    }
+    else {
+        console.error("All notes already have embeddings.");
+    }
+    // Write .knowledginerc.json
+    writeRcConfig(rootPath, { semantic: true });
+    console.error("");
+    console.error("Semantic search enabled successfully.");
+    console.error("  Config: .knowledginerc.json written (semantic: true)");
+    console.error("");
+    console.error("Restart the MCP server to activate semantic search.");
+    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,162 @@ 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, } from "./commands/feedback.js";
+import { demoCommand } from "./commands/demo.js";
+import { searchCommand } from "./commands/search.js";
+import { captureCommand } from "./commands/capture.js";
+import { registerToolCommands } from "./commands/tool.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)")
+    .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`)
+    .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")
+    .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);
+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,
+    });
+});
+program
+    .command("capture [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(captureCommand);
+registerToolCommands(program);
 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"}

package/dist/lib/demo-manager.js

@@ -0,0 +1,37 @@
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+import { cpSync, rmSync, existsSync, mkdirSync, readdirSync } from "fs";
+/**
+ * Resolve the path to the bundled demo fixture notes.
+ * Works from both src/ (development) and dist/ (published package).
+ */
+export function getDemoDir() {
+    const currentDir = dirname(fileURLToPath(import.meta.url));
+    // In dist: dist/lib/demo-manager.js -> package root
+    // In src:  src/lib/demo-manager.js  -> package root
+    const packageRoot = resolve(currentDir, "..", "..");
+    return resolve(packageRoot, "fixtures", "demo", "notes");
+}
+/**
+ * Copy demo fixtures into the target directory.
+ * Returns the number of markdown files copied.
+ */
+export function copyDemoFixtures(targetDir) {
+    const demoDir = getDemoDir();
+    if (!existsSync(demoDir)) {
+        throw new Error(`Demo fixtures not found at ${demoDir}`);
+    }
+    mkdirSync(targetDir, { recursive: true });
+    cpSync(demoDir, targetDir, { recursive: true });
+    return readdirSync(targetDir).filter((f) => f.endsWith(".md")).length;
+}
+/**
+ * Remove the demo notes directory.
+ * Only removes the notes directory — does NOT touch .knowledgine.
+ */
+export function cleanDemo(demoPath) {
+    if (existsSync(demoPath)) {
+        rmSync(demoPath, { recursive: true });
+    }
+}
+//# sourceMappingURL=demo-manager.js.map

package/dist/lib/demo-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-manager.js","sourceRoot":"","sources":["../../src/lib/demo-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAExE;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,oDAAoD;IACpD,oDAAoD;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/lib/formatter.d.ts

@@ -0,0 +1,7 @@
+import type { SearchKnowledgeResult, FindRelatedResult, StatsResult, SearchEntitiesResult } from "@knowledgine/core";
+export type OutputFormat = "json" | "table" | "plain";
+export declare function formatSearchResults(results: SearchKnowledgeResult["results"], format: OutputFormat): string;
+export declare function formatRelatedNotes(result: FindRelatedResult, format: OutputFormat): string;
+export declare function formatStats(stats: StatsResult, format: OutputFormat): string;
+export declare function formatEntities(result: SearchEntitiesResult, format: OutputFormat): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/lib/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/lib/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC,EACzC,MAAM,EAAE,YAAY,GACnB,MAAM,CAgBR;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAwB1F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CA+B5E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAkBzF"}