@docscode/cli 1.0.0

package/dist/index.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import chalk from "chalk";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
+var program = new Command();
+program.name("kairo").description("Kairo \u2014 Universal Document AI. Add an AI peer to any document in one line.").version("1.0.0");
+program.command("init [name]").description("Initialize a new Kairo project").option("--llm <provider>", "Default LLM provider (openai|anthropic|ollama|gemini)", "openai").action((name = "my-kairo-project", opts) => {
+  const dir = name === "." ? process.cwd() : path.join(process.cwd(), name);
+  if (name !== "." && !fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  console.log(chalk.cyan("\n\u{1F300} Initializing Kairo project...\n"));
+  const pkg = {
+    name,
+    version: "1.0.0",
+    type: "module",
+    scripts: {
+      start: "node src/index.js",
+      dev: "tsx src/index.ts"
+    },
+    dependencies: {
+      "@kairo/core": "latest",
+      "@kairo/adapter-markdown": "latest",
+      "@kairo/adapter-docx": "latest",
+      "yjs": "^13.6.30"
+    },
+    devDependencies: { "typescript": "^5.0.0", "tsx": "^4.0.0" }
+  };
+  const llmImport = {
+    openai: "import { OpenAIAdapter } from '@kairo/core';",
+    anthropic: "import { AnthropicAdapter } from '@kairo/core';",
+    ollama: "import { OllamaAdapter } from '@kairo/core';",
+    gemini: "import { GeminiAdapter } from '@kairo/core';"
+  };
+  const llmInit = {
+    openai: "new OpenAIAdapter() // Reads OPENAI_API_KEY from env",
+    anthropic: "new AnthropicAdapter() // Reads ANTHROPIC_API_KEY from env",
+    ollama: "new OllamaAdapter() // Local model, no API key needed",
+    gemini: "new GeminiAdapter() // Reads GOOGLE_AI_API_KEY from env"
+  };
+  const provider = opts.llm in llmImport ? opts.llm : "openai";
+  const entrypoint = `${llmImport[provider]}
+import { kairo } from '@kairo/core';
+import { MarkdownAdapter } from '@kairo/adapter-markdown';
+import fs from 'fs';
+
+// Register format adapters
+kairo.registerFormatAdapter(new MarkdownAdapter());
+
+// Connect to your document
+const fileContent = fs.readFileSync('document.md', 'utf-8');
+const session = await kairo.connect({
+  content: fileContent,
+  fileName: 'document.md',
+  llm: ${llmInit[provider]},
+});
+
+// Get a reference to the document text
+const yText = session.doc.getText('content');
+
+// Ask the AI to collaborate
+await session.ai.streamToDoc(yText, 'Improve the clarity of this document');
+
+// Export the result
+const output = await session.export();
+fs.writeFileSync('document-revised.md', output);
+
+console.log('Done! AI has collaborated on your document.');
+session.destroy();
+`;
+  if (!fs.existsSync(path.join(dir, "src"))) fs.mkdirSync(path.join(dir, "src"));
+  fs.writeFileSync(path.join(dir, "package.json"), JSON.stringify(pkg, null, 2));
+  fs.writeFileSync(path.join(dir, "src", "index.ts"), entrypoint);
+  fs.writeFileSync(path.join(dir, "document.md"), "# My Document\n\nStart writing here...\n");
+  fs.writeFileSync(path.join(dir, ".env.example"), `# Add your API key here
+OPENAI_API_KEY=sk-...
+ANTHROPIC_API_KEY=sk-ant-...
+GOOGLE_AI_API_KEY=...
+`);
+  console.log(chalk.green("\u2705 Project initialized!\n"));
+  console.log(chalk.white(`Next steps:
+`));
+  if (name !== ".") console.log(chalk.white(`  cd ${name}`));
+  console.log(chalk.white(`  npm install`));
+  console.log(chalk.white(`  # Add your API key to .env`));
+  console.log(chalk.white(`  npx tsx src/index.ts
+`));
+});
+program.command("create-adapter <name>").description("Scaffold a new Kairo format adapter").option("--dir <path>", "Output directory", "packages/adapters").action((name, opts) => {
+  const adapterName = name.toLowerCase();
+  const className = adapterName.charAt(0).toUpperCase() + adapterName.slice(1) + "Adapter";
+  const dir = path.join(process.cwd(), opts.dir, `adapter-${adapterName}`);
+  const srcDir = path.join(dir, "src");
+  if (!fs.existsSync(srcDir)) fs.mkdirSync(srcDir, { recursive: true });
+  const pkg = {
+    name: `@kairo/adapter-${adapterName}`,
+    version: "1.0.0",
+    type: "module",
+    main: "dist/index.cjs",
+    module: "dist/index.js",
+    types: "dist/index.d.ts",
+    exports: {
+      ".": { import: "./dist/index.js", require: "./dist/index.cjs" }
+    },
+    peerDependencies: { "@kairo/core": "*", "yjs": "*" }
+  };
+  const tsconfig = {
+    extends: "../../../../tsconfig.json",
+    compilerOptions: { outDir: "./dist", rootDir: "./src" },
+    include: ["src"]
+  };
+  const source = `import * as Y from 'yjs';
+import type { FormatAdapter } from '@kairo/core';
+import { CanonicalDoc } from '@kairo/core';
+
+/**
+ * ${className} \u2014 Kairo format adapter for .${adapterName} files.
+ *
+ * Implement read() to parse ${adapterName} \u2192 Y.Doc.
+ * Implement write() to serialize Y.Doc \u2192 ${adapterName} Buffer.
+ */
+export class ${className} implements FormatAdapter {
+  readonly format = '${adapterName}';
+
+  async read(source: Buffer | string): Promise<Y.Doc> {
+    const yDoc = new Y.Doc();
+    const canonical = new CanonicalDoc(yDoc);
+
+    // TODO: Parse ${adapterName} format and call canonical.addBlock(...)
+    // Example:
+    //   canonical.addParagraph('Hello from ${adapterName}!');
+
+    const content = Buffer.isBuffer(source) ? source.toString('utf-8') : source;
+    canonical.addParagraph(content);
+
+    return yDoc;
+  }
+
+  async write(doc: Y.Doc): Promise<Buffer> {
+    const canonical = new CanonicalDoc(doc);
+
+    // TODO: Serialize blocks back to ${adapterName} format
+    const text = canonical.toPlainText();
+    return Buffer.from(text, 'utf-8');
+  }
+}
+`;
+  const readme = `# @kairo/adapter-${adapterName}
+
+Kairo format adapter for \`.${adapterName}\` files.
+
+## Usage
+
+\`\`\`typescript
+import { kairo } from '@kairo/core';
+import { ${className} } from '@kairo/adapter-${adapterName}';
+
+kairo.registerFormatAdapter(new ${className}());
+
+const session = await kairo.connect({ file: 'document.${adapterName}', llm });
+\`\`\`
+
+## Development
+
+Implement \`read()\` and \`write()\` in \`src/index.ts\`.
+`;
+  fs.writeFileSync(path.join(dir, "package.json"), JSON.stringify(pkg, null, 2));
+  fs.writeFileSync(path.join(dir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2));
+  fs.writeFileSync(path.join(srcDir, "index.ts"), source);
+  fs.writeFileSync(path.join(dir, "README.md"), readme);
+  console.log(chalk.green(`
+\u2705 Adapter scaffolded: @kairo/adapter-${adapterName}
+`));
+  console.log(chalk.white(`  ${path.join(dir, "src", "index.ts")}`));
+  console.log(chalk.white(`
+Implement read() and write() then publish to npm.
+`));
+});
+program.command("connect <file>").description("Quick-connect to a document and show AI analysis").option("--model <model>", "Ollama model to use (local)", "llama3.2").option("--cloud", "Use OpenAI instead of Ollama").action(async (file, opts) => {
+  if (!fs.existsSync(file)) {
+    console.error(chalk.red(`File not found: ${file}`));
+    process.exit(1);
+  }
+  console.log(chalk.cyan(`
+\u{1F300} Kairo connecting to ${path.basename(file)}...
+`));
+  try {
+    const { kairo } = await import("@kairo/core");
+    const { MarkdownAdapter } = await import("@kairo/adapter-markdown");
+    let llm;
+    if (opts.cloud) {
+      const { OpenAIAdapter } = await import("@kairo/core");
+      llm = new OpenAIAdapter();
+      console.log(chalk.yellow("  Using OpenAI GPT-4o-mini"));
+    } else {
+      const { OllamaAdapter } = await import("@kairo/core");
+      llm = new OllamaAdapter({ model: opts.model });
+      console.log(chalk.yellow(`  Using Ollama (${opts.model})`));
+    }
+    kairo.registerFormatAdapter(new MarkdownAdapter());
+    const rawContent = fs.readFileSync(file, "utf-8");
+    const session = await kairo.connect({ content: rawContent, fileName: file, llm });
+    const { CanonicalDoc } = await import("@kairo/core");
+    const canonical = new CanonicalDoc(session.doc);
+    const stats = canonical.stats();
+    const wordCount = Math.ceil(stats.charCount / 5);
+    console.log(chalk.green(`
+\u2705 Connected!`));
+    console.log(chalk.white(`  Words: ~${wordCount}`));
+    console.log(chalk.white(`  Format: ${path.extname(file).slice(1)}`));
+    console.log(chalk.white(`
+  AI peer status: ${session.ai.getStatus ? session.ai["_status"] ?? "idle" : "idle"}`));
+    console.log(chalk.cyan(`
+  Use kairo mcp to expose this as an MCP server for Claude/Cursor.
+`));
+    session.destroy();
+  } catch (e) {
+    console.error(chalk.red(`Error: ${e.stack}`));
+  }
+});
+program.command("mcp").description("Start the Kairo MCP Server for Claude Desktop / Cursor / Windsurf").action(async () => {
+  console.error(chalk.magenta("\u{1F680} Starting Kairo MCP Server..."));
+  const { default: run } = await import("@kairo/mcp-server");
+  if (run) await run();
+});
+program.parse();

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@docscode/cli",
+  "version": "1.0.0",
+  "description": "Kairo CLI Tool",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "type": "module",
+  "bin": {
+    "kairo": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean --external @docscode/core --external @docscode/adapter-markdown --external @docscode/adapter-docx --external @docscode/mcp-server"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "chalk": "^5.6.2",
+    "fs-extra": "^11.2.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,268 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const program = new Command();
+
+// ─── Kairo CLI ────────────────────────────────────────────────────────────────
+// The fastest way to go from document to AI-collaborative session.
+// ─────────────────────────────────────────────────────────────────────────────
+
+program
+  .name('kairo')
+  .description('Kairo — Universal Document AI. Add an AI peer to any document in one line.')
+  .version('1.0.0');
+
+// ── kairo init ────────────────────────────────────────────────────────────────
+program
+  .command('init [name]')
+  .description('Initialize a new Kairo project')
+  .option('--llm <provider>', 'Default LLM provider (openai|anthropic|ollama|gemini)', 'openai')
+  .action((name: string = 'my-kairo-project', opts: any) => {
+    const dir = name === '.' ? process.cwd() : path.join(process.cwd(), name);
+    if (name !== '.' && !fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+    console.log(chalk.cyan('\n🌀 Initializing Kairo project...\n'));
+
+    const pkg = {
+      name,
+      version: '1.0.0',
+      type: 'module',
+      scripts: {
+        start: 'node src/index.js',
+        dev: 'tsx src/index.ts',
+      },
+      dependencies: {
+        '@docscode/core': 'latest',
+        '@docscode/adapter-markdown': 'latest',
+        '@docscode/adapter-docx': 'latest',
+        'yjs': '^13.6.30',
+      },
+      devDependencies: { 'typescript': '^5.0.0', 'tsx': '^4.0.0' },
+    };
+
+    const llmImport: Record<string, string> = {
+      openai: "import { OpenAIAdapter } from '@docscode/core';",
+      anthropic: "import { AnthropicAdapter } from '@docscode/core';",
+      ollama: "import { OllamaAdapter } from '@docscode/core';",
+      gemini: "import { GeminiAdapter } from '@docscode/core';",
+    };
+
+    const llmInit: Record<string, string> = {
+      openai: "new OpenAIAdapter() // Reads OPENAI_API_KEY from env",
+      anthropic: "new AnthropicAdapter() // Reads ANTHROPIC_API_KEY from env",
+      ollama: "new OllamaAdapter() // Local model, no API key needed",
+      gemini: "new GeminiAdapter() // Reads GOOGLE_AI_API_KEY from env",
+    };
+
+    const provider = opts.llm in llmImport ? opts.llm : 'openai';
+
+    const entrypoint = `${llmImport[provider]}
+import { kairo } from '@docscode/core';
+import { MarkdownAdapter } from '@docscode/adapter-markdown';
+import fs from 'fs';
+
+// Register format adapters
+kairo.registerFormatAdapter(new MarkdownAdapter());
+
+// Connect to your document
+const fileContent = fs.readFileSync('document.md', 'utf-8');
+const session = await kairo.connect({
+  content: fileContent,
+  fileName: 'document.md',
+  llm: ${llmInit[provider]},
+});
+
+// Get a reference to the document text
+const yText = session.doc.getText('content');
+
+// Ask the AI to collaborate
+await session.ai.streamToDoc(yText, 'Improve the clarity of this document');
+
+// Export the result
+const output = await session.export();
+fs.writeFileSync('document-revised.md', output);
+
+console.log('Done! AI has collaborated on your document.');
+session.destroy();
+`;
+
+    if (!fs.existsSync(path.join(dir, 'src'))) fs.mkdirSync(path.join(dir, 'src'));
+    fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify(pkg, null, 2));
+    fs.writeFileSync(path.join(dir, 'src', 'index.ts'), entrypoint);
+    fs.writeFileSync(path.join(dir, 'document.md'), '# My Document\n\nStart writing here...\n');
+    fs.writeFileSync(path.join(dir, '.env.example'), `# Add your API key here\nOPENAI_API_KEY=sk-...\nANTHROPIC_API_KEY=sk-ant-...\nGOOGLE_AI_API_KEY=...\n`);
+
+    console.log(chalk.green('✅ Project initialized!\n'));
+    console.log(chalk.white(`Next steps:\n`));
+    if (name !== '.') console.log(chalk.white(`  cd ${name}`));
+    console.log(chalk.white(`  npm install`));
+    console.log(chalk.white(`  # Add your API key to .env`));
+    console.log(chalk.white(`  npx tsx src/index.ts\n`));
+  });
+
+// ── kairo create-adapter ──────────────────────────────────────────────────────
+program
+  .command('create-adapter <name>')
+  .description('Scaffold a new Kairo format adapter')
+  .option('--dir <path>', 'Output directory', 'packages/adapters')
+  .action((name: string, opts: any) => {
+    const adapterName = name.toLowerCase();
+    const className = adapterName.charAt(0).toUpperCase() + adapterName.slice(1) + 'Adapter';
+    const dir = path.join(process.cwd(), opts.dir, `adapter-${adapterName}`);
+    const srcDir = path.join(dir, 'src');
+
+    if (!fs.existsSync(srcDir)) fs.mkdirSync(srcDir, { recursive: true });
+
+    const pkg = {
+      name: `@docscode/adapter-${adapterName}`,
+      version: '1.0.0',
+      type: 'module',
+      main: 'dist/index.cjs',
+      module: 'dist/index.js',
+      types: 'dist/index.d.ts',
+      exports: {
+        '.': { import: './dist/index.js', require: './dist/index.cjs' },
+      },
+      peerDependencies: { '@docscode/core': '*', 'yjs': '*' },
+    };
+
+    const tsconfig = {
+      extends: '../../../../tsconfig.json',
+      compilerOptions: { outDir: './dist', rootDir: './src' },
+      include: ['src'],
+    };
+
+    const source = `import * as Y from 'yjs';
+import type { FormatAdapter } from '@docscode/core';
+import { CanonicalDoc } from '@docscode/core';
+
+/**
+ * ${className} — Kairo format adapter for .${adapterName} files.
+ *
+ * Implement read() to parse ${adapterName} → Y.Doc.
+ * Implement write() to serialize Y.Doc → ${adapterName} Buffer.
+ */
+export class ${className} implements FormatAdapter {
+  readonly format = '${adapterName}';
+
+  async read(source: Buffer | string): Promise<Y.Doc> {
+    const yDoc = new Y.Doc();
+    const canonical = new CanonicalDoc(yDoc);
+
+    // TODO: Parse ${adapterName} format and call canonical.addBlock(...)
+    // Example:
+    //   canonical.addParagraph('Hello from ${adapterName}!');
+
+    const content = Buffer.isBuffer(source) ? source.toString('utf-8') : source;
+    canonical.addParagraph(content);
+
+    return yDoc;
+  }
+
+  async write(doc: Y.Doc): Promise<Buffer> {
+    const canonical = new CanonicalDoc(doc);
+
+    // TODO: Serialize blocks back to ${adapterName} format
+    const text = canonical.toPlainText();
+    return Buffer.from(text, 'utf-8');
+  }
+}
+`;
+
+    const readme = `# @docscode/adapter-${adapterName}
+
+Kairo format adapter for \`.${adapterName}\` files.
+
+## Usage
+
+\`\`\`typescript
+import { kairo } from '@docscode/core';
+import { ${className} } from '@docscode/adapter-${adapterName}';
+
+kairo.registerFormatAdapter(new ${className}());
+
+const session = await kairo.connect({ file: 'document.${adapterName}', llm });
+\`\`\`
+
+## Development
+
+Implement \`read()\` and \`write()\` in \`src/index.ts\`.
+`;
+
+    fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify(pkg, null, 2));
+    fs.writeFileSync(path.join(dir, 'tsconfig.json'), JSON.stringify(tsconfig, null, 2));
+    fs.writeFileSync(path.join(srcDir, 'index.ts'), source);
+    fs.writeFileSync(path.join(dir, 'README.md'), readme);
+
+    console.log(chalk.green(`\n✅ Adapter scaffolded: @docscode/adapter-${adapterName}\n`));
+    console.log(chalk.white(`  ${path.join(dir, 'src', 'index.ts')}`));
+    console.log(chalk.white(`\nImplement read() and write() then publish to npm.\n`));
+  });
+
+// ── kairo connect (quick CLI test) ────────────────────────────────────────────
+program
+  .command('connect <file>')
+  .description('Quick-connect to a document and show AI analysis')
+  .option('--model <model>', 'Ollama model to use (local)', 'llama3.2')
+  .option('--cloud', 'Use OpenAI instead of Ollama')
+  .action(async (file: string, opts: any) => {
+    if (!fs.existsSync(file)) {
+      console.error(chalk.red(`File not found: ${file}`));
+      process.exit(1);
+    }
+
+    console.log(chalk.cyan(`\n🌀 Kairo connecting to ${path.basename(file)}...\n`));
+
+    try {
+      const { kairo } = await import('@docscode/core');
+      const { MarkdownAdapter } = await import('@docscode/adapter-markdown');
+
+      let llm;
+      if (opts.cloud) {
+        const { OpenAIAdapter } = await import('@docscode/core');
+        llm = new OpenAIAdapter();
+        console.log(chalk.yellow('  Using OpenAI GPT-4o-mini'));
+      } else {
+        const { OllamaAdapter } = await import('@docscode/core');
+        llm = new OllamaAdapter({ model: opts.model });
+        console.log(chalk.yellow(`  Using Ollama (${opts.model})`));
+      }
+
+      kairo.registerFormatAdapter(new MarkdownAdapter());
+
+      const rawContent = fs.readFileSync(file, 'utf-8');
+      const session = await kairo.connect({ content: rawContent, fileName: file, llm });
+      
+      const { CanonicalDoc } = await import('@docscode/core');
+      const canonical = new CanonicalDoc(session.doc);
+      const stats = canonical.stats();
+      const wordCount = Math.ceil(stats.charCount / 5); // approximate words
+
+      console.log(chalk.green(`\n✅ Connected!`));
+      console.log(chalk.white(`  Words: ~${wordCount}`));
+      console.log(chalk.white(`  Format: ${path.extname(file).slice(1)}`));
+      console.log(chalk.white(`\n  AI peer status: ${session.ai.getStatus ? session.ai['_status'] ?? 'idle' : 'idle'}`));
+      console.log(chalk.cyan(`\n  Use kairo mcp to expose this as an MCP server for Claude/Cursor.\n`));
+
+      session.destroy();
+    } catch (e: any) {
+      console.error(chalk.red(`Error: ${e.stack}`));
+    }
+  });
+
+// ── kairo mcp ─────────────────────────────────────────────────────────────────
+program
+  .command('mcp')
+  .description('Start the Kairo MCP Server for Claude Desktop / Cursor / Windsurf')
+  .action(async () => {
+    console.error(chalk.magenta('🚀 Starting Kairo MCP Server...'));
+    const { default: run } = await import('@docscode/mcp-server');
+    if (run) await run();
+  });
+
+program.parse();