kaimon-cli 0.1.2

package/README.md

@@ -0,0 +1,73 @@
+# Kaimon CLI
+
+> Sync your Kaimon documentation with your codebase from the command line.
+
+## Installation
+
+```bash
+npm install -g kaimon-cli
+```
+
+## Usage
+
+### Authenticate
+
+```bash
+# Login to your Kaimon account
+kaimon auth login
+
+# Check your auth status
+kaimon auth status
+
+# Logout
+kaimon auth logout
+```
+
+### Sync Documentation
+
+```bash
+# Pull documentation from Kaimon
+kaimon sync --pull
+
+# Push local documentation to Kaimon
+kaimon sync --push
+
+# See what would change
+kaimon sync --diff
+```
+
+### Configuration
+
+```bash
+# Initialize CLI in your project
+kaimon config init
+
+# View configuration
+kaimon config show
+
+# Set a configuration value
+kaimon config set key value
+```
+
+## Features
+
+- 🔐 Secure authentication with Kaimon
+- 📁 Bidirectional sync (pull/push)
+- 🔍 Diff preview before sync
+- ⚙️ Project-level configuration
+- 🚀 Fast and lightweight
+
+## Getting Started
+
+1. Install the CLI: `npm install -g kaimon-cli`
+2. Login: `kaimon auth login`
+3. Initialize your project: `kaimon config init`
+4. Sync docs: `kaimon sync --pull` or `kaimon sync --push`
+
+## Documentation
+
+For more details, visit [kaimon.ai/cli](https://kaimon.ai)
+
+## License
+
+MIT

package/bin/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { main } from '../dist/index.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+main().catch(error => {
+  console.error('Fatal error:', error.message);
+  process.exit(1);
+});

package/dist/commands/auth.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+declare const auth: Command;
+export { auth };
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC,QAAA,MAAM,IAAI,SACgC,CAAC;AAwJ3C,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/commands/auth.js

@@ -0,0 +1,150 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import open from 'open';
+import { getAuthUrl, CLI_AUTH_PATH } from '../config/constants.js';
+import { loadConfig, saveConfig, clearConfig, isAuthenticated } from '../utils/config.js';
+// Mask token for display (show first 8 and last 8 characters)
+function maskToken(token) {
+    if (!token)
+        return '';
+    if (token.length <= 20)
+        return token; // Don't mask if too short
+    const start = token.substring(0, 8);
+    const end = token.substring(token.length - 8);
+    const maskLength = Math.min(token.length - 16, 40); // Max 40 dots
+    return `${start}${'•'.repeat(maskLength)}${end}`;
+}
+const auth = new Command('auth')
+    .description('Authenticate with Kaimon');
+// Login command
+auth
+    .command('login')
+    .description('Login to your Kaimon account')
+    .option('--dev', 'Use development URL (localhost)')
+    .action(async (options) => {
+    try {
+        console.log(chalk.blue('🔐 Opening browser for authentication...\n'));
+        // Construct auth URL
+        const baseUrl = options.dev ? 'http://localhost:5173' : getAuthUrl();
+        const authUrl = `${baseUrl}${CLI_AUTH_PATH}`;
+        console.log(chalk.gray(`URL: ${authUrl}\n`));
+        // Open browser
+        await open(authUrl);
+        console.log(chalk.yellow('Please complete authentication in your browser.'));
+        console.log(chalk.gray('After logging in, copy the access token and paste it here.\n'));
+        // Wait for user to paste token with hidden input
+        const readline = await import('readline');
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+        // Mute output to hide token input
+        const mutableStdout = process.stdout;
+        console.log(chalk.cyan('Paste your access token below:'));
+        console.log(chalk.dim('(Your paste will be invisible for security - press Enter when done)'));
+        mutableStdout.write(chalk.cyan('> '));
+        let token = '';
+        rl.on('line', (input) => {
+            token = input;
+            rl.close();
+        });
+        // Mute the output while typing
+        const oldWrite = mutableStdout.write;
+        mutableStdout.write = (chunk) => {
+            // Only show the prompt, hide everything else
+            return true;
+        };
+        rl.on('close', () => {
+            // Restore normal output
+            mutableStdout.write = oldWrite;
+            if (!token || token.trim() === '') {
+                console.log(chalk.red('\n❌ No token provided. Authentication cancelled.'));
+                process.exit(1);
+            }
+            // Show confirmation that token was received
+            console.log(chalk.green(`\n✓ Token received (${token.trim().length} characters)`));
+            console.log(chalk.gray('Verifying and saving...\n'));
+            // Save token to config
+            saveConfig({
+                access_token: token.trim(),
+                expires_at: new Date(Date.now() + 60 * 60 * 1000).toISOString() // 1 hour from now
+            });
+            console.log(chalk.green('✅ Authentication successful!'));
+            console.log(chalk.gray(`Token: ${maskToken(token.trim())}`));
+            console.log(chalk.gray('Saved to ~/.kaimon/config.json\n'));
+            console.log(chalk.blue('You can now use other CLI commands like:'));
+            console.log(chalk.gray('  kaimon sync --pull'));
+            console.log(chalk.gray('  kaimon sync --push\n'));
+        });
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Login failed:'), error.message);
+        process.exit(1);
+    }
+});
+// Logout command
+auth
+    .command('logout')
+    .description('Logout from Kaimon')
+    .action(async () => {
+    try {
+        if (!isAuthenticated()) {
+            console.log(chalk.yellow('⚠️  You are not logged in.'));
+            return;
+        }
+        clearConfig();
+        console.log(chalk.green('✅ Logged out successfully!'));
+        console.log(chalk.gray('Token removed from ~/.kaimon/config.json\n'));
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Logout failed:'), error.message);
+        process.exit(1);
+    }
+});
+// Status command
+auth
+    .command('status')
+    .description('Check authentication status')
+    .option('--show-token', 'Show full access token (security risk)')
+    .action(async (options) => {
+    try {
+        const config = loadConfig();
+        if (!config.access_token) {
+            console.log(chalk.yellow('❌ Not authenticated'));
+            console.log(chalk.gray('Run "kaimon auth login" to authenticate\n'));
+            return;
+        }
+        console.log(chalk.green('✅ Authenticated'));
+        if (config.user_email) {
+            console.log(chalk.gray(`Email: ${config.user_email}`));
+        }
+        // Show token (masked by default)
+        if (options.showToken) {
+            console.log(chalk.gray(`Token: ${config.access_token}`));
+            console.log(chalk.yellow('⚠️  Full token shown above - keep it secure!'));
+        }
+        else {
+            console.log(chalk.gray(`Token: ${maskToken(config.access_token)}`));
+            console.log(chalk.dim('Use --show-token to reveal full token'));
+        }
+        if (config.expires_at) {
+            const expiresAt = new Date(config.expires_at);
+            const now = new Date();
+            const isExpired = expiresAt < now;
+            if (isExpired) {
+                console.log(chalk.red('Status: Expired'));
+                console.log(chalk.yellow('Please login again: kaimon auth login\n'));
+            }
+            else {
+                console.log(chalk.gray(`Expires: ${expiresAt.toLocaleString()}`));
+            }
+        }
+        console.log(chalk.gray(`Config: ~/.kaimon/config.json\n`));
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Status check failed:'), error.message);
+        process.exit(1);
+    }
+});
+export { auth };
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+declare const config: Command;
+export { config };
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,QAAA,MAAM,MAAM,SACqC,CAAC;AAkElD,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/commands/config.js

@@ -0,0 +1,60 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { loadConfig, getConfigPath } from '../utils/config.js';
+const config = new Command('config')
+    .description('Manage Kaimon CLI configuration');
+config
+    .command('init')
+    .description('Initialize .kaimon config in current directory')
+    .action(async () => {
+    console.log(chalk.blue('⚙️ Config init - coming soon!'));
+    console.log(chalk.yellow('\n⚠️  Project-level config not yet implemented'));
+    console.log(chalk.dim('For now, all config is stored globally at:'));
+    console.log(chalk.dim(`  ${getConfigPath()}\n`));
+});
+config
+    .command('show')
+    .description('Show current configuration')
+    .action(async () => {
+    try {
+        const configData = loadConfig();
+        const configPath = getConfigPath();
+        console.log(chalk.blue('🔍 Current Configuration\n'));
+        console.log(chalk.gray(`Location: ${configPath}\n`));
+        if (Object.keys(configData).length === 0) {
+            console.log(chalk.yellow('No configuration found'));
+            console.log(chalk.dim('Run "kaimon auth login" to authenticate\n'));
+            return;
+        }
+        // Show config (mask sensitive data)
+        console.log(chalk.cyan('Settings:'));
+        if (configData.access_token) {
+            const masked = configData.access_token.substring(0, 10) + '...';
+            console.log(chalk.gray(`  access_token: ${masked}`));
+        }
+        if (configData.refresh_token) {
+            const masked = configData.refresh_token.substring(0, 10) + '...';
+            console.log(chalk.gray(`  refresh_token: ${masked}`));
+        }
+        if (configData.user_email) {
+            console.log(chalk.gray(`  user_email: ${configData.user_email}`));
+        }
+        if (configData.expires_at) {
+            console.log(chalk.gray(`  expires_at: ${configData.expires_at}`));
+        }
+        console.log();
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Failed to show config:'), error.message);
+        process.exit(1);
+    }
+});
+config
+    .command('set <key> <value>')
+    .description('Set a configuration value')
+    .action(async (key, value) => {
+    console.log(chalk.yellow(`⚠️  Manual config editing not yet supported`));
+    console.log(chalk.dim('Use "kaimon auth login" to authenticate\n'));
+});
+export { config };
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/commands/sync.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+declare const sync: Command;
+export { sync };
+//# sourceMappingURL=sync.d.ts.map

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

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

package/dist/commands/sync.js

@@ -0,0 +1,27 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { requireAuth } from '../utils/requireAuth.js';
+const sync = new Command('sync')
+    .description('Sync Kaimon documentation with your codebase')
+    .option('--pull', 'Pull docs from Kaimon to local')
+    .option('--push', 'Push local docs to Kaimon')
+    .option('--diff', 'Show differences without syncing')
+    .option('--config <path>', 'Path to sync config file')
+    .action(async (options) => {
+    try {
+        // Validate authentication first
+        const token = await requireAuth();
+        console.log(chalk.blue('📁 Sync command - coming soon!'));
+        console.log(chalk.gray(`Authenticated with token: ${token.substring(0, 10)}...`));
+        console.log(chalk.gray('Options:'), options);
+        // TODO: Implement sync logic
+        console.log(chalk.yellow('\n⚠️  Sync functionality not yet implemented'));
+        console.log(chalk.dim('This will sync your documents with Kaimon in the future\n'));
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Sync failed:'), error.message);
+        process.exit(1);
+    }
+});
+export { sync };
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC7B,WAAW,CAAC,8CAA8C,CAAC;KAC3D,MAAM,CAAC,QAAQ,EAAE,gCAAgC,CAAC;KAClD,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC;KAC7C,MAAM,CAAC,QAAQ,EAAE,kCAAkC,CAAC;KACpD,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;KACrD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,gCAAgC;QAChC,MAAM,KAAK,GAAG,MAAM,WAAW,EAAE,CAAC;QAElC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,6BAA6B,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAClF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;QAE7C,6BAA6B;QAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,8CAA8C,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC,CAAC;IAEtF,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/config/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const BASE_URL: string;
+export declare const DEV_URL = "http://localhost:5173";
+export declare const getAuthUrl: () => string;
+export declare const CLI_AUTH_PATH = "/cli-auth";
+export declare const CONFIG_DIR = ".kaimon";
+export declare const CONFIG_FILE = "config.json";
+export declare const SUPABASE_URL: string;
+export declare const SUPABASE_ANON_KEY: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,QAAQ,QAAoD,CAAC;AAG1E,eAAO,MAAM,OAAO,0BAA0B,CAAC;AAG/C,eAAO,MAAM,UAAU,QAAO,MAI7B,CAAC;AAGF,eAAO,MAAM,aAAa,cAAc,CAAC;AAGzC,eAAO,MAAM,UAAU,YAAY,CAAC;AACpC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAGzC,eAAO,MAAM,YAAY,QAAwE,CAAC;AAClG,eAAO,MAAM,iBAAiB,QAA6C,CAAC"}

package/dist/config/constants.js

@@ -0,0 +1,22 @@
+// Configuration constants for Kaimon CLI
+// Determine the base URL based on environment
+// In development, use localhost
+// In production, use the actual domain
+export const BASE_URL = process.env.KAIMON_API_URL || 'https://kaimon.ai';
+// For local development testing
+export const DEV_URL = 'http://localhost:5173';
+// Determine which URL to use
+export const getAuthUrl = () => {
+    // Check if we're in development mode
+    const isDev = process.env.NODE_ENV === 'development' || process.env.KAIMON_DEV === 'true';
+    return isDev ? DEV_URL : BASE_URL;
+};
+// CLI auth endpoint
+export const CLI_AUTH_PATH = '/cli-auth';
+// Config file location
+export const CONFIG_DIR = '.kaimon';
+export const CONFIG_FILE = 'config.json';
+// Supabase config (will be same as web app)
+export const SUPABASE_URL = process.env.KAIMON_SUPABASE_URL || 'https://your-project.supabase.co';
+export const SUPABASE_ANON_KEY = process.env.KAIMON_SUPABASE_ANON_KEY || '';
+//# sourceMappingURL=constants.js.map

package/dist/config/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,8CAA8C;AAC9C,gCAAgC;AAChC,uCAAuC;AACvC,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,mBAAmB,CAAC;AAE1E,gCAAgC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAG,uBAAuB,CAAC;AAE/C,6BAA6B;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,GAAW,EAAE;IACrC,qCAAqC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC;IAC1F,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpC,CAAC,CAAC;AAEF,oBAAoB;AACpB,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC,uBAAuB;AACvB,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AAEzC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,kCAAkC,CAAC;AAClG,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare function main(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,wBAAsB,IAAI,kBAEzB"}

package/dist/index.js

@@ -0,0 +1,17 @@
+import { Command } from 'commander';
+import { auth } from './commands/auth.js';
+import { sync } from './commands/sync.js';
+import { config } from './commands/config.js';
+const program = new Command();
+program
+    .name('kaimon')
+    .description('Sync Kaimon documentation with your codebase')
+    .version('0.1.0');
+// Register commands
+program.addCommand(auth);
+program.addCommand(sync);
+program.addCommand(config);
+export async function main() {
+    await program.parseAsync(process.argv);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACzB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACzB,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAE3B,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,15 @@
+export interface CLIConfig {
+    access_token?: string;
+    refresh_token?: string;
+    expires_at?: string;
+    user_email?: string;
+}
+export declare function getConfigDir(): string;
+export declare function getConfigPath(): string;
+export declare function ensureConfigDir(): void;
+export declare function loadConfig(): CLIConfig;
+export declare function saveConfig(config: CLIConfig): void;
+export declare function clearConfig(): void;
+export declare function isAuthenticated(): boolean;
+export declare function getAccessToken(): string | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAGD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAGD,wBAAgB,eAAe,IAAI,IAAI,CAKtC;AAGD,wBAAgB,UAAU,IAAI,SAAS,CActC;AAGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAWlD;AAGD,wBAAgB,WAAW,IAAI,IAAI,CAMlC;AAGD,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAGD,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAG9C"}

package/dist/utils/config.js

@@ -0,0 +1,65 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { CONFIG_DIR, CONFIG_FILE } from '../config/constants.js';
+// Get config directory path
+export function getConfigDir() {
+    return path.join(os.homedir(), CONFIG_DIR);
+}
+// Get config file path
+export function getConfigPath() {
+    return path.join(getConfigDir(), CONFIG_FILE);
+}
+// Ensure config directory exists
+export function ensureConfigDir() {
+    const configDir = getConfigDir();
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true, mode: 0o700 }); // Only user can read/write
+    }
+}
+// Load config from file
+export function loadConfig() {
+    const configPath = getConfigPath();
+    if (!fs.existsSync(configPath)) {
+        return {};
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error('Failed to load config:', error);
+        return {};
+    }
+}
+// Save config to file
+export function saveConfig(config) {
+    ensureConfigDir();
+    const configPath = getConfigPath();
+    try {
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2), {
+            mode: 0o600 // Only user can read/write
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to save config: ${error}`);
+    }
+}
+// Clear config (logout)
+export function clearConfig() {
+    const configPath = getConfigPath();
+    if (fs.existsSync(configPath)) {
+        fs.unlinkSync(configPath);
+    }
+}
+// Check if user is authenticated
+export function isAuthenticated() {
+    const config = loadConfig();
+    return !!config.access_token;
+}
+// Get access token
+export function getAccessToken() {
+    const config = loadConfig();
+    return config.access_token || null;
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AASjE,4BAA4B;AAC5B,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,2BAA2B;IACxF,CAAC;AACH,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,UAAU;IACxB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,UAAU,CAAC,MAAiB;IAC1C,eAAe,EAAE,CAAC;IAClB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;YAC5D,IAAI,EAAE,KAAK,CAAC,2BAA2B;SACxC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,WAAW;IACzB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,OAAO,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;AAC/B,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,OAAO,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;AACrC,CAAC"}

package/dist/utils/requireAuth.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Validates authentication and returns the access token.
+ * Exits the process with helpful error message if not authenticated or token expired.
+ */
+export declare function requireAuth(): Promise<string>;
+/**
+ * Checks if user is authenticated without exiting.
+ * Returns true if authenticated and token is valid.
+ */
+export declare function checkAuth(): boolean;
+//# sourceMappingURL=requireAuth.d.ts.map

package/dist/utils/requireAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requireAuth.d.ts","sourceRoot":"","sources":["../../src/utils/requireAuth.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAkCnD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAiBnC"}

package/dist/utils/requireAuth.js

@@ -0,0 +1,54 @@
+import chalk from 'chalk';
+import { loadConfig } from './config.js';
+/**
+ * Validates authentication and returns the access token.
+ * Exits the process with helpful error message if not authenticated or token expired.
+ */
+export async function requireAuth() {
+    const config = loadConfig();
+    // Check if token exists
+    if (!config.access_token) {
+        console.log(chalk.red('\n❌ Not authenticated'));
+        console.log(chalk.yellow('Please login first:'));
+        console.log(chalk.cyan('  kaimon auth login\n'));
+        process.exit(1);
+    }
+    // Check if token is expired
+    if (config.expires_at) {
+        const expiresAt = new Date(config.expires_at);
+        const now = new Date();
+        if (expiresAt < now) {
+            console.log(chalk.red('\n❌ Authentication expired'));
+            console.log(chalk.yellow('Your session has expired. Please login again:'));
+            console.log(chalk.cyan('  kaimon auth login\n'));
+            process.exit(1);
+        }
+        // Warn if expiring soon (within 5 minutes)
+        const fiveMinutes = 5 * 60 * 1000;
+        const timeUntilExpiry = expiresAt.getTime() - now.getTime();
+        if (timeUntilExpiry < fiveMinutes && timeUntilExpiry > 0) {
+            console.log(chalk.yellow(`⚠️  Token expires in ${Math.floor(timeUntilExpiry / 60000)} minutes`));
+            console.log(chalk.dim('Consider re-authenticating soon\n'));
+        }
+    }
+    return config.access_token;
+}
+/**
+ * Checks if user is authenticated without exiting.
+ * Returns true if authenticated and token is valid.
+ */
+export function checkAuth() {
+    const config = loadConfig();
+    if (!config.access_token) {
+        return false;
+    }
+    if (config.expires_at) {
+        const expiresAt = new Date(config.expires_at);
+        const now = new Date();
+        if (expiresAt < now) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=requireAuth.js.map

package/dist/utils/requireAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requireAuth.js","sourceRoot":"","sources":["../../src/utils/requireAuth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,wBAAwB;IACxB,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,4BAA4B;IAC5B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,+CAA+C,CAAC,CAAC,CAAC;YAC3E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,2CAA2C;QAC3C,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,eAAe,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;QAE5D,IAAI,eAAe,GAAG,WAAW,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,wBAAwB,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;YACjG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,YAAY,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "kaimon-cli",
+  "version": "0.1.2",
+  "description": "CLI tool to sync Kaimon documentation with your codebase",
+  "type": "module",
+  "bin": {
+    "kaimon": "./bin/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write src",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "kaimon",
+    "documentation",
+    "sync",
+    "cli"
+  ],
+  "author": "Kaimon",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^14.0.0",
+    "axios": "^1.7.0",
+    "chalk": "^5.3.0",
+    "ora": "^9.0.0",
+    "dotenv": "^17.0.0",
+    "conf": "^15.0.0",
+    "open": "^10.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.0",
+    "typescript": "^5.4.0",
+    "ts-node": "^10.9.2",
+    "eslint": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "prettier": "^3.2.0",
+    "vitest": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/commands/auth.ts

@@ -0,0 +1,170 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import open from 'open';
+import { getAuthUrl, CLI_AUTH_PATH } from '../config/constants.js';
+import { loadConfig, saveConfig, clearConfig, isAuthenticated } from '../utils/config.js';
+
+// Mask token for display (show first 8 and last 8 characters)
+function maskToken(token: string): string {
+  if (!token) return '';
+  if (token.length <= 20) return token; // Don't mask if too short
+  const start = token.substring(0, 8);
+  const end = token.substring(token.length - 8);
+  const maskLength = Math.min(token.length - 16, 40); // Max 40 dots
+  return `${start}${'•'.repeat(maskLength)}${end}`;
+}
+
+const auth = new Command('auth')
+  .description('Authenticate with Kaimon');
+
+// Login command
+auth
+  .command('login')
+  .description('Login to your Kaimon account')
+  .option('--dev', 'Use development URL (localhost)')
+  .action(async (options) => {
+    try {
+      console.log(chalk.blue('🔐 Opening browser for authentication...\n'));
+      
+      // Construct auth URL
+      const baseUrl = options.dev ? 'http://localhost:5173' : getAuthUrl();
+      const authUrl = `${baseUrl}${CLI_AUTH_PATH}`;
+      
+      console.log(chalk.gray(`URL: ${authUrl}\n`));
+      
+      // Open browser
+      await open(authUrl);
+      
+      console.log(chalk.yellow('Please complete authentication in your browser.'));
+      console.log(chalk.gray('After logging in, copy the access token and paste it here.\n'));
+      
+      // Wait for user to paste token with hidden input
+      const readline = await import('readline');
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+      
+      // Mute output to hide token input
+      const mutableStdout = process.stdout as any;
+      console.log(chalk.cyan('Paste your access token below:'));
+      console.log(chalk.dim('(Your paste will be invisible for security - press Enter when done)'));
+      mutableStdout.write(chalk.cyan('> '));
+      
+      let token = '';
+      rl.on('line', (input) => {
+        token = input;
+        rl.close();
+      });
+      
+      // Mute the output while typing
+      const oldWrite = mutableStdout.write;
+      mutableStdout.write = (chunk: string) => {
+        // Only show the prompt, hide everything else
+        return true;
+      };
+      
+      rl.on('close', () => {
+        // Restore normal output
+        mutableStdout.write = oldWrite;
+        
+        if (!token || token.trim() === '') {
+          console.log(chalk.red('\n❌ No token provided. Authentication cancelled.'));
+          process.exit(1);
+        }
+        
+        // Show confirmation that token was received
+        console.log(chalk.green(`\n✓ Token received (${token.trim().length} characters)`));
+        console.log(chalk.gray('Verifying and saving...\n'));
+        
+        // Save token to config
+        saveConfig({
+          access_token: token.trim(),
+          expires_at: new Date(Date.now() + 60 * 60 * 1000).toISOString() // 1 hour from now
+        });
+        
+        console.log(chalk.green('✅ Authentication successful!'));
+        console.log(chalk.gray(`Token: ${maskToken(token.trim())}`));
+        console.log(chalk.gray('Saved to ~/.kaimon/config.json\n'));
+        console.log(chalk.blue('You can now use other CLI commands like:'));
+        console.log(chalk.gray('  kaimon sync --pull'));
+        console.log(chalk.gray('  kaimon sync --push\n'));
+      });
+      
+    } catch (error: any) {
+      console.error(chalk.red('❌ Login failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Logout command
+auth
+  .command('logout')
+  .description('Logout from Kaimon')
+  .action(async () => {
+    try {
+      if (!isAuthenticated()) {
+        console.log(chalk.yellow('⚠️  You are not logged in.'));
+        return;
+      }
+      
+      clearConfig();
+      console.log(chalk.green('✅ Logged out successfully!'));
+      console.log(chalk.gray('Token removed from ~/.kaimon/config.json\n'));
+    } catch (error: any) {
+      console.error(chalk.red('❌ Logout failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Status command
+auth
+  .command('status')
+  .description('Check authentication status')
+  .option('--show-token', 'Show full access token (security risk)')
+  .action(async (options) => {
+    try {
+      const config = loadConfig();
+      
+      if (!config.access_token) {
+        console.log(chalk.yellow('❌ Not authenticated'));
+        console.log(chalk.gray('Run "kaimon auth login" to authenticate\n'));
+        return;
+      }
+      
+      console.log(chalk.green('✅ Authenticated'));
+      
+      if (config.user_email) {
+        console.log(chalk.gray(`Email: ${config.user_email}`));
+      }
+      
+      // Show token (masked by default)
+      if (options.showToken) {
+        console.log(chalk.gray(`Token: ${config.access_token}`));
+        console.log(chalk.yellow('⚠️  Full token shown above - keep it secure!'));
+      } else {
+        console.log(chalk.gray(`Token: ${maskToken(config.access_token)}`));
+        console.log(chalk.dim('Use --show-token to reveal full token'));
+      }
+      
+      if (config.expires_at) {
+        const expiresAt = new Date(config.expires_at);
+        const now = new Date();
+        const isExpired = expiresAt < now;
+        
+        if (isExpired) {
+          console.log(chalk.red('Status: Expired'));
+          console.log(chalk.yellow('Please login again: kaimon auth login\n'));
+        } else {
+          console.log(chalk.gray(`Expires: ${expiresAt.toLocaleString()}`));
+        }
+      }
+      
+      console.log(chalk.gray(`Config: ~/.kaimon/config.json\n`));
+    } catch (error: any) {
+      console.error(chalk.red('❌ Status check failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+export { auth };

package/src/commands/config.ts

@@ -0,0 +1,72 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { loadConfig, getConfigPath } from '../utils/config.js';
+
+const config = new Command('config')
+  .description('Manage Kaimon CLI configuration');
+
+config
+  .command('init')
+  .description('Initialize .kaimon config in current directory')
+  .action(async () => {
+    console.log(chalk.blue('⚙️ Config init - coming soon!'));
+    console.log(chalk.yellow('\n⚠️  Project-level config not yet implemented'));
+    console.log(chalk.dim('For now, all config is stored globally at:'));
+    console.log(chalk.dim(`  ${getConfigPath()}\n`));
+  });
+
+config
+  .command('show')
+  .description('Show current configuration')
+  .action(async () => {
+    try {
+      const configData = loadConfig();
+      const configPath = getConfigPath();
+      
+      console.log(chalk.blue('🔍 Current Configuration\n'));
+      console.log(chalk.gray(`Location: ${configPath}\n`));
+      
+      if (Object.keys(configData).length === 0) {
+        console.log(chalk.yellow('No configuration found'));
+        console.log(chalk.dim('Run "kaimon auth login" to authenticate\n'));
+        return;
+      }
+      
+      // Show config (mask sensitive data)
+      console.log(chalk.cyan('Settings:'));
+      
+      if (configData.access_token) {
+        const masked = configData.access_token.substring(0, 10) + '...';
+        console.log(chalk.gray(`  access_token: ${masked}`));
+      }
+      
+      if (configData.refresh_token) {
+        const masked = configData.refresh_token.substring(0, 10) + '...';
+        console.log(chalk.gray(`  refresh_token: ${masked}`));
+      }
+      
+      if (configData.user_email) {
+        console.log(chalk.gray(`  user_email: ${configData.user_email}`));
+      }
+      
+      if (configData.expires_at) {
+        console.log(chalk.gray(`  expires_at: ${configData.expires_at}`));
+      }
+      
+      console.log();
+      
+    } catch (error: any) {
+      console.error(chalk.red('❌ Failed to show config:'), error.message);
+      process.exit(1);
+    }
+  });
+
+config
+  .command('set <key> <value>')
+  .description('Set a configuration value')
+  .action(async (key, value) => {
+    console.log(chalk.yellow(`⚠️  Manual config editing not yet supported`));
+    console.log(chalk.dim('Use "kaimon auth login" to authenticate\n'));
+  });
+
+export { config };

package/src/commands/sync.ts

@@ -0,0 +1,30 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { requireAuth } from '../utils/requireAuth.js';
+
+const sync = new Command('sync')
+  .description('Sync Kaimon documentation with your codebase')
+  .option('--pull', 'Pull docs from Kaimon to local')
+  .option('--push', 'Push local docs to Kaimon')
+  .option('--diff', 'Show differences without syncing')
+  .option('--config <path>', 'Path to sync config file')
+  .action(async (options) => {
+    try {
+      // Validate authentication first
+      const token = await requireAuth();
+      
+      console.log(chalk.blue('📁 Sync command - coming soon!'));
+      console.log(chalk.gray(`Authenticated with token: ${token.substring(0, 10)}...`));
+      console.log(chalk.gray('Options:'), options);
+      
+      // TODO: Implement sync logic
+      console.log(chalk.yellow('\n⚠️  Sync functionality not yet implemented'));
+      console.log(chalk.dim('This will sync your documents with Kaimon in the future\n'));
+      
+    } catch (error: any) {
+      console.error(chalk.red('❌ Sync failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+export { sync };

package/src/config/constants.ts

@@ -0,0 +1,27 @@
+// Configuration constants for Kaimon CLI
+
+// Determine the base URL based on environment
+// In development, use localhost
+// In production, use the actual domain
+export const BASE_URL = process.env.KAIMON_API_URL || 'https://kaimon.ai';
+
+// For local development testing
+export const DEV_URL = 'http://localhost:5173';
+
+// Determine which URL to use
+export const getAuthUrl = (): string => {
+  // Check if we're in development mode
+  const isDev = process.env.NODE_ENV === 'development' || process.env.KAIMON_DEV === 'true';
+  return isDev ? DEV_URL : BASE_URL;
+};
+
+// CLI auth endpoint
+export const CLI_AUTH_PATH = '/cli-auth';
+
+// Config file location
+export const CONFIG_DIR = '.kaimon';
+export const CONFIG_FILE = 'config.json';
+
+// Supabase config (will be same as web app)
+export const SUPABASE_URL = process.env.KAIMON_SUPABASE_URL || 'https://your-project.supabase.co';
+export const SUPABASE_ANON_KEY = process.env.KAIMON_SUPABASE_ANON_KEY || '';

package/src/index.ts

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+import { auth } from './commands/auth.js';
+import { sync } from './commands/sync.js';
+import { config } from './commands/config.js';
+
+const program = new Command();
+
+program
+  .name('kaimon')
+  .description('Sync Kaimon documentation with your codebase')
+  .version('0.1.0');
+
+// Register commands
+program.addCommand(auth);
+program.addCommand(sync);
+program.addCommand(config);
+
+export async function main() {
+  await program.parseAsync(process.argv);
+}

package/src/utils/config.ts

@@ -0,0 +1,81 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { CONFIG_DIR, CONFIG_FILE } from '../config/constants.js';
+
+export interface CLIConfig {
+  access_token?: string;
+  refresh_token?: string;
+  expires_at?: string;
+  user_email?: string;
+}
+
+// Get config directory path
+export function getConfigDir(): string {
+  return path.join(os.homedir(), CONFIG_DIR);
+}
+
+// Get config file path
+export function getConfigPath(): string {
+  return path.join(getConfigDir(), CONFIG_FILE);
+}
+
+// Ensure config directory exists
+export function ensureConfigDir(): void {
+  const configDir = getConfigDir();
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true, mode: 0o700 }); // Only user can read/write
+  }
+}
+
+// Load config from file
+export function loadConfig(): CLIConfig {
+  const configPath = getConfigPath();
+  
+  if (!fs.existsSync(configPath)) {
+    return {};
+  }
+  
+  try {
+    const content = fs.readFileSync(configPath, 'utf-8');
+    return JSON.parse(content);
+  } catch (error) {
+    console.error('Failed to load config:', error);
+    return {};
+  }
+}
+
+// Save config to file
+export function saveConfig(config: CLIConfig): void {
+  ensureConfigDir();
+  const configPath = getConfigPath();
+  
+  try {
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), {
+      mode: 0o600 // Only user can read/write
+    });
+  } catch (error) {
+    throw new Error(`Failed to save config: ${error}`);
+  }
+}
+
+// Clear config (logout)
+export function clearConfig(): void {
+  const configPath = getConfigPath();
+  
+  if (fs.existsSync(configPath)) {
+    fs.unlinkSync(configPath);
+  }
+}
+
+// Check if user is authenticated
+export function isAuthenticated(): boolean {
+  const config = loadConfig();
+  return !!config.access_token;
+}
+
+// Get access token
+export function getAccessToken(): string | null {
+  const config = loadConfig();
+  return config.access_token || null;
+}

package/src/utils/requireAuth.ts

@@ -0,0 +1,65 @@
+import chalk from 'chalk';
+import { loadConfig } from './config.js';
+
+/**
+ * Validates authentication and returns the access token.
+ * Exits the process with helpful error message if not authenticated or token expired.
+ */
+export async function requireAuth(): Promise<string> {
+  const config = loadConfig();
+  
+  // Check if token exists
+  if (!config.access_token) {
+    console.log(chalk.red('\n❌ Not authenticated'));
+    console.log(chalk.yellow('Please login first:'));
+    console.log(chalk.cyan('  kaimon auth login\n'));
+    process.exit(1);
+  }
+  
+  // Check if token is expired
+  if (config.expires_at) {
+    const expiresAt = new Date(config.expires_at);
+    const now = new Date();
+    
+    if (expiresAt < now) {
+      console.log(chalk.red('\n❌ Authentication expired'));
+      console.log(chalk.yellow('Your session has expired. Please login again:'));
+      console.log(chalk.cyan('  kaimon auth login\n'));
+      process.exit(1);
+    }
+    
+    // Warn if expiring soon (within 5 minutes)
+    const fiveMinutes = 5 * 60 * 1000;
+    const timeUntilExpiry = expiresAt.getTime() - now.getTime();
+    
+    if (timeUntilExpiry < fiveMinutes && timeUntilExpiry > 0) {
+      console.log(chalk.yellow(`⚠️  Token expires in ${Math.floor(timeUntilExpiry / 60000)} minutes`));
+      console.log(chalk.dim('Consider re-authenticating soon\n'));
+    }
+  }
+  
+  return config.access_token;
+}
+
+/**
+ * Checks if user is authenticated without exiting.
+ * Returns true if authenticated and token is valid.
+ */
+export function checkAuth(): boolean {
+  const config = loadConfig();
+  
+  if (!config.access_token) {
+    return false;
+  }
+  
+  if (config.expires_at) {
+    const expiresAt = new Date(config.expires_at);
+    const now = new Date();
+    
+    if (expiresAt < now) {
+      return false;
+    }
+  }
+  
+  return true;
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020"],
+    "moduleResolution": "node",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "tests"]
+}