@ctxkit/cli 0.2.0

package/dist/commands/drift.js

@@ -0,0 +1,65 @@
+import { Command } from 'commander';
+import { resolve, join, dirname } from 'node:path';
+import { existsSync } from 'node:fs';
+import { detectDrift, detectAllDrift } from '@ctxkit/core';
+export const driftCommand = new Command('drift')
+    .description('Check .ctx files for stale references and drift')
+    .argument('[path]', 'Path to .ctx file or repo root to scan all', '.')
+    .action((pathArg) => {
+    const targetPath = resolve(pathArg);
+    const repoRoot = findRepoRoot(targetPath);
+    if (targetPath.endsWith('.ctx') && existsSync(targetPath)) {
+        // Single .ctx file
+        const result = detectDrift(targetPath, repoRoot);
+        printDriftResult(result);
+    }
+    else {
+        // Scan all .ctx files from the target directory
+        const scanRoot = existsSync(join(targetPath, '.git')) ? targetPath : repoRoot;
+        const results = detectAllDrift(scanRoot);
+        if (results.length === 0) {
+            console.log('No .ctx files found.');
+            return;
+        }
+        let totalStale = 0;
+        for (const result of results) {
+            if (result.stale_entries.length > 0) {
+                printDriftResult(result);
+                console.log();
+            }
+            totalStale += result.total_stale;
+        }
+        if (totalStale === 0) {
+            console.log(`All ${results.length} .ctx file(s) are up to date.`);
+        }
+        else {
+            console.log(`\nTotal: ${totalStale} stale entry/entries across ${results.length} .ctx file(s)`);
+            process.exitCode = 1;
+        }
+    }
+});
+function printDriftResult(result) {
+    if (result.total_stale === 0) {
+        console.log(`✓ ${result.ctx_path} — no drift detected`);
+        return;
+    }
+    console.log(`✗ ${result.ctx_path} — ${result.total_stale} stale entry/entries:`);
+    for (const entry of result.stale_entries) {
+        console.log(`  ${entry.section}/${entry.entry_id}`);
+        console.log(`    Reason: ${entry.reason}`);
+        console.log(`    Details: ${entry.details}`);
+        console.log(`    Verified at: ${entry.verified_at}`);
+    }
+}
+function findRepoRoot(startDir) {
+    let current = startDir;
+    while (true) {
+        if (existsSync(join(current, '.git')))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return startDir;
+        current = parent;
+    }
+}
+//# sourceMappingURL=drift.js.map

package/dist/commands/drift.js.map

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

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

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

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

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

package/dist/commands/history-cmd.js

@@ -0,0 +1,100 @@
+import { Command } from 'commander';
+import { accessSync, readFileSync } from 'node:fs';
+import { resolve, relative, join, dirname } from 'node:path';
+import { parseCtxFile, readMergedHistory } from '@ctxkit/core';
+export const historyCommand = new Command('history')
+    .description('Show version history for a .ctx file')
+    .argument('[path]', 'Path to .ctx file', '.ctx')
+    .option('--cwd <dir>', 'Working directory', process.cwd())
+    .option('--all', 'Include archived history entries', false)
+    .option('--count <n>', 'Number of entries to show', '10')
+    .option('--diff <range>', 'Show diff between versions (e.g., 1..5)')
+    .option('--json', 'Output as JSON', false)
+    .action((ctxPath, options) => {
+    const cwd = resolve(options.cwd);
+    const fullPath = resolve(cwd, ctxPath);
+    const repoRoot = findRepoRoot(cwd);
+    const relativePath = relative(repoRoot, fullPath);
+    let content;
+    try {
+        content = readFileSync(fullPath, 'utf-8');
+    }
+    catch {
+        console.error(`Error: Cannot read ${fullPath}`);
+        process.exit(1);
+    }
+    const { ctx } = parseCtxFile(content);
+    // Handle diff mode
+    if (options.diff) {
+        const [fromStr, toStr] = options.diff.split('..');
+        const from = parseInt(fromStr, 10);
+        const to = parseInt(toStr, 10);
+        if (isNaN(from) || isNaN(to)) {
+            console.error('Error: Invalid diff range. Use format: N..M');
+            process.exit(1);
+        }
+        // For a real diff we'd need version snapshots — use diff_summary from history entries
+        const history = options.all
+            ? readMergedHistory(ctx, relativePath, repoRoot)
+            : (ctx._history ?? []);
+        const relevant = history.filter((h) => h.version > from && h.version <= to);
+        if (options.json) {
+            console.log(JSON.stringify({
+                from_version: from,
+                to_version: to,
+                entries: relevant,
+                summary: relevant.map((h) => h.diff_summary).join('; '),
+            }, null, 2));
+            return;
+        }
+        console.log(`\nDiff: v${from}..v${to}`);
+        for (const entry of relevant) {
+            console.log(`  v${entry.version} (${entry.timestamp}) by ${entry.author}: ${entry.diff_summary}`);
+        }
+        return;
+    }
+    // Show history
+    const count = parseInt(options.count, 10);
+    const history = options.all
+        ? readMergedHistory(ctx, relativePath, repoRoot)
+        : (ctx._history ?? []);
+    const shown = history.slice(0, count);
+    if (options.json) {
+        console.log(JSON.stringify({
+            path: relativePath,
+            current_version: ctx.version,
+            entries: shown,
+            has_more: history.length > count,
+        }, null, 2));
+        return;
+    }
+    console.log(`\n${relativePath} (v${ctx.version})`);
+    if (shown.length === 0) {
+        console.log('  No history entries');
+        return;
+    }
+    for (const entry of shown) {
+        console.log(`  v${entry.version} | ${entry.timestamp} | ${entry.author} | ${entry.diff_summary}`);
+        if (entry.reason)
+            console.log(`         Reason: ${entry.reason}`);
+    }
+    if (history.length > count) {
+        console.log(`  ... ${history.length - count} more entries (use --all or --count)`);
+    }
+});
+function findRepoRoot(startDir) {
+    let dir = startDir;
+    while (true) {
+        try {
+            accessSync(join(dir, '.git'));
+            return dir;
+        }
+        catch {
+            const parent = dirname(dir);
+            if (parent === dir)
+                return startDir;
+            dir = parent;
+        }
+    }
+}
+//# sourceMappingURL=history-cmd.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/hooks-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,YAAY,SACY,CAAC"}

package/dist/commands/hooks-cmd.js

@@ -0,0 +1,98 @@
+import { Command } from 'commander';
+import { writeFileSync, existsSync, mkdirSync, chmodSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+export const hooksCommand = new Command('hooks')
+    .description('Git hook management');
+hooksCommand
+    .command('init')
+    .description('Install git hooks for context validation')
+    .option('--force', 'Overwrite existing hooks')
+    .action(async (options) => {
+    try {
+        let repoRoot;
+        try {
+            repoRoot = execSync('git rev-parse --show-toplevel', {
+                encoding: 'utf-8',
+                timeout: 3000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+        }
+        catch {
+            console.error('Error: Not a git repository');
+            process.exit(1);
+            return;
+        }
+        const hooksDir = join(repoRoot, '.git', 'hooks');
+        if (!existsSync(hooksDir)) {
+            mkdirSync(hooksDir, { recursive: true });
+        }
+        const hooks = [
+            {
+                name: 'pre-commit',
+                content: `#!/bin/sh
+# ctxkit pre-commit hook — validates .ctx files before committing
+# Installed by: ctxkit hooks init
+
+# Check if ctxkit is available
+if ! command -v ctxkit &> /dev/null; then
+  echo "[ctxkit] Warning: ctxkit not found, skipping .ctx validation"
+  exit 0
+fi
+
+# Get list of staged .ctx files
+STAGED_CTX=$(git diff --cached --name-only --diff-filter=ACM | grep '\\.ctx$' || true)
+
+if [ -n "$STAGED_CTX" ]; then
+  echo "[ctxkit] Validating staged .ctx files..."
+  ctxkit validate --json > /dev/null 2>&1
+  if [ $? -ne 0 ]; then
+    echo "[ctxkit] Validation failed. Fix issues before committing."
+    exit 1
+  fi
+  echo "[ctxkit] All .ctx files valid."
+fi
+`,
+            },
+            {
+                name: 'post-commit',
+                content: `#!/bin/sh
+# ctxkit post-commit hook — updates .ctxl index after commit
+# Installed by: ctxkit hooks init
+
+# Check if ctxkit is available
+if ! command -v ctxkit &> /dev/null; then
+  exit 0
+fi
+
+# Check if any .ctx files were changed
+CHANGED_CTX=$(git diff-tree --no-commit-id --name-only -r HEAD | grep '\\.ctx$' || true)
+
+if [ -n "$CHANGED_CTX" ]; then
+  echo "[ctxkit] Updating .ctxl index..."
+  ctxkit index generate --json > /dev/null 2>&1 || true
+fi
+`,
+            },
+        ];
+        const installed = [];
+        for (const hook of hooks) {
+            const hookPath = join(hooksDir, hook.name);
+            if (existsSync(hookPath) && !options.force) {
+                console.error(`Hook already exists: ${hook.name}. Use --force to overwrite.`);
+                process.exit(1);
+                return;
+            }
+            writeFileSync(hookPath, hook.content, 'utf-8');
+            chmodSync(hookPath, 0o755);
+            installed.push(hook.name);
+        }
+        console.log(`Installed hooks: ${installed.join(', ')}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Error: ${message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=hooks-cmd.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-cmd.js","sourceRoot":"","sources":["../../src/commands/hooks-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,qBAAqB,CAAC,CAAC;AAEtC,YAAY;KACT,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,SAAS,EAAE,0BAA0B,CAAC;KAC7C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,QAAQ,CAAC,+BAA+B,EAAE;gBACnD,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,KAAK,GAA6C;YACtD;gBACE,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;CAsBlB;aACQ;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE;;;;;;;;;;;;;;;;CAgBlB;aACQ;SACF,CAAC;QAEF,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAE3C,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC3C,OAAO,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,IAAI,6BAA6B,CAAC,CAAC;gBAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC/C,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC3B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,oBAAoB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,YAAY,SACe,CAAC"}

package/dist/commands/index-cmd.js

@@ -0,0 +1,112 @@
+import { Command } from 'commander';
+import { generateIndex, writeIndex, readIndex, selectFromIndex } from '@ctxkit/core';
+import { resolve, join, dirname } from 'node:path';
+import { accessSync } from 'node:fs';
+export const indexCommand = new Command('index')
+    .description('Manage the .ctxl index');
+indexCommand
+    .command('generate')
+    .description('Generate or regenerate the .ctxl index from existing .ctx files')
+    .option('--cwd <path>', 'Repository root', process.cwd())
+    .option('--repo <name>', 'Repository name')
+    .option('--force', 'Force regeneration even if index exists', false)
+    .option('--json', 'Output as JSON', false)
+    .action((options) => {
+    const repoRoot = resolve(options.cwd);
+    const index = generateIndex(repoRoot, options.repo);
+    const indexPath = writeIndex(repoRoot, index);
+    if (options.json) {
+        console.log(JSON.stringify({
+            index_path: indexPath,
+            entries_count: index.entries.length,
+            total_tokens: index.entries.reduce((sum, e) => sum + e.token_estimate, 0),
+            dependencies_found: Object.values(index.graph).reduce((sum, n) => sum + n.depends_on.length, 0),
+            generated_at: index.generated_at,
+        }, null, 2));
+        return;
+    }
+    console.log(`Generated .ctxl index with ${index.entries.length} entries`);
+    console.log(`  Total tokens: ${index.entries.reduce((sum, e) => sum + e.token_estimate, 0)}`);
+    console.log(`  Dependencies: ${Object.values(index.graph).reduce((sum, n) => sum + n.depends_on.length, 0)}`);
+    console.log(`  Path: ${indexPath}`);
+});
+indexCommand
+    .command('select')
+    .description('Select context from the index for a task')
+    .requiredOption('--prompt <text>', 'The task prompt')
+    .option('--cwd <path>', 'Working directory', process.cwd())
+    .option('--budget <tokens>', 'Token budget', '4000')
+    .option('--json', 'Output as JSON', false)
+    .action((options) => {
+    const cwd = resolve(options.cwd);
+    const repoRoot = findRepoRoot(cwd);
+    const budgetTokens = parseInt(options.budget, 10);
+    const index = readIndex(repoRoot);
+    if (!index) {
+        console.error('Error: No .ctxl index found. Run `ctxkit index generate` first.');
+        process.exit(1);
+    }
+    const result = selectFromIndex(index, {
+        prompt: options.prompt,
+        cwd,
+        repoRoot,
+        budgetTokens,
+    });
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`\nSelected ${result.selected.length} .ctx files:`);
+    for (const s of result.selected) {
+        console.log(`  ${s.entry.path} (score: ${s.score}, reasons: ${s.reasons.join(', ')})`);
+    }
+    if (result.omitted.length > 0) {
+        console.log(`\nOmitted ${result.omitted.length} .ctx files:`);
+        for (const o of result.omitted) {
+            console.log(`  ${o.entry.path}: ${o.reason}`);
+        }
+    }
+    console.log(`\nBudget used: ${result.budget_used.total} tokens`);
+});
+indexCommand
+    .command('show')
+    .description('Display the current .ctxl index')
+    .option('--cwd <path>', 'Repository root', process.cwd())
+    .option('--json', 'Output as JSON', false)
+    .action((options) => {
+    const repoRoot = resolve(options.cwd);
+    const index = readIndex(repoRoot);
+    if (!index) {
+        console.error('Error: No .ctxl index found. Run `ctxkit index generate` first.');
+        process.exit(1);
+    }
+    if (options.json) {
+        console.log(JSON.stringify(index, null, 2));
+        return;
+    }
+    console.log(`\n.ctxl Index (${index.entries.length} entries)`);
+    console.log(`  Generated: ${index.generated_at}`);
+    console.log(`  Updated: ${index.updated_at}`);
+    console.log(`\nEntries:`);
+    for (const entry of index.entries) {
+        console.log(`  ${entry.path} (v${entry.ctx_version}, ${entry.token_estimate} tokens, tags: [${entry.tags.join(', ')}])`);
+    }
+    console.log(`\nScoring: locality=${index.defaults.scoring.locality_weight} recency=${index.defaults.scoring.recency_weight} tags=${index.defaults.scoring.tag_match_weight}`);
+    console.log(`Budget: total=${index.defaults.budget.total} contracts=${index.defaults.budget.contracts} local=${index.defaults.budget.local_ctx} related=${index.defaults.budget.related_ctx}`);
+});
+function findRepoRoot(startDir) {
+    let dir = startDir;
+    while (true) {
+        try {
+            accessSync(join(dir, '.git'));
+            return dir;
+        }
+        catch {
+            const parent = dirname(dir);
+            if (parent === dir)
+                return startDir; // reached root
+            dir = parent;
+        }
+    }
+}
+//# sourceMappingURL=index-cmd.js.map

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

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

package/dist/commands/init.d.ts

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

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

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

package/dist/commands/init.js

@@ -0,0 +1,158 @@
+import { Command } from 'commander';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve, join, basename } from 'node:path';
+import { serializeCtxFile } from '@ctxkit/core';
+export const initCommand = new Command('init')
+    .description('Initialize a .ctx file by scanning directory metadata')
+    .option('--dir <path>', 'Target directory', process.cwd())
+    .option('--force', 'Overwrite existing .ctx file', false)
+    .action((options) => {
+    const targetDir = resolve(options.dir);
+    const ctxPath = join(targetDir, '.ctx');
+    if (existsSync(ctxPath) && !options.force) {
+        console.error(`Error: .ctx file already exists at ${ctxPath}`);
+        console.error('Use --force to overwrite.');
+        process.exitCode = 1;
+        return;
+    }
+    const ctx = scanAndGenerate(targetDir);
+    writeFileSync(ctxPath, serializeCtxFile(ctx), 'utf-8');
+    console.log(`Created .ctx at ${ctxPath}`);
+    console.log(`  Summary: ${ctx.summary}`);
+    console.log(`  Key files: ${ctx.key_files.length}`);
+    console.log(`  Commands: ${Object.keys(ctx.commands).length}`);
+    console.log(`  Tags: ${ctx.tags.join(', ') || '(none)'}`);
+});
+function scanAndGenerate(dir) {
+    const dirName = basename(dir);
+    let summary = `Context for ${dirName}`;
+    const keyFiles = [];
+    const commands = {};
+    const tags = [];
+    // Scan package.json
+    const pkgPath = join(dir, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            if (pkg.description) {
+                summary = pkg.description;
+            }
+            else if (pkg.name) {
+                summary = `${pkg.name} project`;
+            }
+            keyFiles.push({
+                path: 'package.json',
+                purpose: 'Package manifest and dependency definitions',
+                tags: ['config'],
+                verified_at: new Date().toISOString().split('T')[0],
+                locked: false,
+                owner: null,
+            });
+            // Extract scripts as commands
+            if (pkg.scripts && typeof pkg.scripts === 'object') {
+                for (const [name, script] of Object.entries(pkg.scripts)) {
+                    if (typeof script === 'string') {
+                        commands[name] = script;
+                    }
+                }
+            }
+            // Extract tags from keywords
+            if (Array.isArray(pkg.keywords)) {
+                tags.push(...pkg.keywords.map(String));
+            }
+            // Detect tech stack
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (allDeps.typescript)
+                tags.push('typescript');
+            if (allDeps.react)
+                tags.push('react');
+            if (allDeps.vue)
+                tags.push('vue');
+            if (allDeps.express || allDeps.hono || allDeps.fastify)
+                tags.push('api');
+            if (allDeps.vitest || allDeps.jest || allDeps.mocha)
+                tags.push('testing');
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    // Scan tsconfig.json
+    const tsconfigPath = join(dir, 'tsconfig.json');
+    if (existsSync(tsconfigPath)) {
+        keyFiles.push({
+            path: 'tsconfig.json',
+            purpose: 'TypeScript compiler configuration',
+            tags: ['config', 'typescript'],
+            verified_at: new Date().toISOString().split('T')[0],
+            locked: false,
+            owner: null,
+        });
+        if (!tags.includes('typescript')) {
+            tags.push('typescript');
+        }
+    }
+    // Scan README
+    const readmeNames = ['README.md', 'README', 'readme.md'];
+    for (const name of readmeNames) {
+        const readmePath = join(dir, name);
+        if (existsSync(readmePath)) {
+            keyFiles.push({
+                path: name,
+                purpose: 'Project documentation and overview',
+                tags: ['docs'],
+                verified_at: new Date().toISOString().split('T')[0],
+                locked: false,
+                owner: null,
+            });
+            // Try to extract a better summary from first line of README
+            try {
+                const content = readFileSync(readmePath, 'utf-8');
+                const firstLine = content.split('\n').find((l) => l.trim() && !l.startsWith('#') && !l.startsWith('!'));
+                if (firstLine && firstLine.trim().length > 10) {
+                    summary = firstLine.trim().slice(0, 200);
+                }
+            }
+            catch {
+                // Ignore
+            }
+            break;
+        }
+    }
+    // Scan common entry points
+    const entryPoints = [
+        { file: 'src/index.ts', purpose: 'Main entry point' },
+        { file: 'src/index.js', purpose: 'Main entry point' },
+        { file: 'src/main.ts', purpose: 'Application entry point' },
+        { file: 'src/main.tsx', purpose: 'Application entry point' },
+        { file: 'src/app.ts', purpose: 'Application setup' },
+        { file: 'index.ts', purpose: 'Main entry point' },
+        { file: 'index.js', purpose: 'Main entry point' },
+    ];
+    for (const entry of entryPoints) {
+        if (existsSync(join(dir, entry.file))) {
+            keyFiles.push({
+                path: entry.file,
+                purpose: entry.purpose,
+                tags: ['entry'],
+                verified_at: new Date().toISOString().split('T')[0],
+                locked: false,
+                owner: null,
+            });
+            break; // Only add the first found entry point
+        }
+    }
+    return {
+        version: 1,
+        summary,
+        key_files: keyFiles,
+        contracts: [],
+        decisions: [],
+        commands,
+        gotchas: [],
+        tags: [...new Set(tags)],
+        refs: [],
+        ignore: { never_read: [], never_log: [] },
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/inject.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../src/commands/inject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,aAAa,SAgEtB,CAAC"}