@ctxkit/cli 0.2.0

package/dist/commands/speckit-cmd.js

@@ -0,0 +1,196 @@
+import { Command } from 'commander';
+import { execSync } from 'node:child_process';
+export const speckitCommand = new Command('speckit')
+    .description('Spec-kit integration bridge');
+function getRepoRoot() {
+    try {
+        return 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 '';
+    }
+}
+speckitCommand
+    .command('import')
+    .description('Import spec-kit artifacts into .ctx files')
+    .option('--constitution <path>', 'Path to constitution file', '.specify/memory/constitution.md')
+    .option('--specs <dir>', 'Path to spec-kit specs directory', 'specs/')
+    .option('--dry-run', 'Preview changes without writing')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const repoRoot = getRepoRoot();
+        const { importConstitution, importSpecs } = await import('@ctxkit/speckit-bridge');
+        let totalDecisions = 0;
+        let totalContracts = 0;
+        let totalGotchas = 0;
+        const allFilesUpdated = [];
+        // Import constitution
+        const constResult = importConstitution(repoRoot, options.constitution, options.dryRun);
+        totalDecisions += constResult.decisions;
+        totalContracts += constResult.contracts;
+        allFilesUpdated.push(...constResult.files_updated);
+        // Import specs
+        const specsResult = importSpecs(repoRoot, options.specs, options.dryRun);
+        totalContracts += specsResult.contracts;
+        totalGotchas += specsResult.gotchas;
+        allFilesUpdated.push(...specsResult.files_updated);
+        if (options.json) {
+            console.log(JSON.stringify({
+                imported: {
+                    decisions: totalDecisions,
+                    contracts: totalContracts,
+                    gotchas: totalGotchas,
+                },
+                files_updated: allFilesUpdated,
+                dry_run: !!options.dryRun,
+            }, null, 2));
+        }
+        else {
+            console.log(`Import ${options.dryRun ? '(dry-run) ' : ''}complete:`);
+            console.log(`  Decisions: ${totalDecisions}`);
+            console.log(`  Contracts: ${totalContracts}`);
+            console.log(`  Gotchas: ${totalGotchas}`);
+            if (allFilesUpdated.length > 0) {
+                console.log(`  Files updated: ${allFilesUpdated.join(', ')}`);
+            }
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (options.json) {
+            console.log(JSON.stringify({ error: message }));
+        }
+        else {
+            console.error(`Error: ${message}`);
+        }
+        process.exit(1);
+    }
+});
+speckitCommand
+    .command('export')
+    .description('Export .ctx content to spec-kit format')
+    .option('--output <dir>', 'Output directory for spec-kit files', 'specs/exported/')
+    .option('--format <md|yaml>', 'Output format', 'md')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const repoRoot = getRepoRoot();
+        const { exportToSpecKit } = await import('@ctxkit/speckit-bridge');
+        const result = exportToSpecKit(repoRoot, options.output, options.format);
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            if (result.exported_files.length === 0) {
+                console.log('No .ctx files with exportable content found.');
+            }
+            else {
+                console.log('Export complete:');
+                for (const f of result.exported_files) {
+                    console.log(`  - ${f}`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (options.json) {
+            console.log(JSON.stringify({ error: message }));
+        }
+        else {
+            console.error(`Error: ${message}`);
+        }
+        process.exit(1);
+    }
+});
+speckitCommand
+    .command('validate')
+    .description('Validate .ctx files against constitution')
+    .option('--constitution <path>', 'Path to constitution file', '.specify/memory/constitution.md')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const repoRoot = getRepoRoot();
+        const { validateConstitution } = await import('@ctxkit/speckit-bridge');
+        const result = validateConstitution(repoRoot, options.constitution);
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            if (result.valid) {
+                console.log('All .ctx files are compliant with the constitution.');
+            }
+            else {
+                console.log('Validation failed:');
+                for (const v of result.violations) {
+                    console.log(`  [${v.severity}] ${v.ctx_path}: ${v.violation}`);
+                    console.log(`    Principle: ${v.principle}`);
+                }
+            }
+        }
+        if (!result.valid) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (options.json) {
+            console.log(JSON.stringify({ error: message }));
+        }
+        else {
+            console.error(`Error: ${message}`);
+        }
+        process.exit(1);
+    }
+});
+speckitCommand
+    .command('sync')
+    .description('Bidirectional sync between spec-kit and .ctx')
+    .option('--dry-run', 'Preview changes without writing')
+    .option('--force <direction>', 'Force sync direction (spec-to-ctx | ctx-to-spec)')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const repoRoot = getRepoRoot();
+        const { syncBidirectional } = await import('@ctxkit/speckit-bridge');
+        const result = syncBidirectional(repoRoot, {
+            dryRun: options.dryRun,
+            forceDirection: options.force,
+        });
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log(`Sync ${options.dryRun ? '(dry-run) ' : ''}complete:`);
+            console.log(`  Synced: ${result.synced}`);
+            console.log(`  Conflicts: ${result.conflicts}`);
+            if (result.files_updated.length > 0) {
+                console.log(`  .ctx files updated: ${result.files_updated.join(', ')}`);
+            }
+            if (result.specs_updated.length > 0) {
+                console.log(`  Spec files updated: ${result.specs_updated.join(', ')}`);
+            }
+            if (result.conflicts > 0) {
+                console.log('\n  Conflicts detected. Use --force to resolve.');
+            }
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (options.json) {
+            console.log(JSON.stringify({ error: message }));
+        }
+        else {
+            console.error(`Error: ${message}`);
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=speckit-cmd.js.map

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

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

package/dist/commands/validate.d.ts

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

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

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

package/dist/commands/validate.js

@@ -0,0 +1,75 @@
+import { Command } from 'commander';
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, join, dirname } from 'node:path';
+import { parseCtxFile, validateCtxFile } from '@ctxkit/core';
+export const validateCommand = new Command('validate')
+    .description('Validate a .ctx file for structural correctness')
+    .argument('[path]', 'Path to .ctx file or directory containing one', '.')
+    .option('--check-files', 'Verify referenced files exist on disk', false)
+    .action((pathArg, options) => {
+    const targetPath = resolve(pathArg);
+    const ctxPath = targetPath.endsWith('.ctx')
+        ? targetPath
+        : join(targetPath, '.ctx');
+    if (!existsSync(ctxPath)) {
+        console.error(`Error: No .ctx file found at ${ctxPath}`);
+        process.exitCode = 1;
+        return;
+    }
+    let content;
+    try {
+        content = readFileSync(ctxPath, 'utf-8');
+    }
+    catch (err) {
+        console.error(`Error reading ${ctxPath}: ${err.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    let ctx;
+    try {
+        const result = parseCtxFile(content);
+        ctx = result.ctx;
+        if (result.warnings.length > 0) {
+            for (const w of result.warnings) {
+                console.error(`Warning: ${w}`);
+            }
+        }
+    }
+    catch (err) {
+        console.error(`Parse error: ${err.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    const errors = validateCtxFile(ctx);
+    // Check referenced files exist
+    if (options.checkFiles) {
+        const ctxDir = dirname(ctxPath);
+        for (const kf of ctx.key_files) {
+            if (kf.path && !existsSync(join(ctxDir, kf.path))) {
+                errors.push({
+                    path: `key_files: ${kf.path}`,
+                    message: `Referenced file does not exist: ${kf.path}`,
+                    severity: 'warning',
+                });
+            }
+        }
+    }
+    // Output results
+    const errorCount = errors.filter((e) => e.severity === 'error').length;
+    const warningCount = errors.filter((e) => e.severity === 'warning').length;
+    if (errors.length === 0) {
+        console.log(`✓ ${ctxPath} is valid`);
+        return;
+    }
+    console.log(`Validation results for ${ctxPath}:\n`);
+    for (const err of errors) {
+        const prefix = err.severity === 'error' ? '✗ ERROR' : '⚠ WARN ';
+        console.log(`  ${prefix}  ${err.path}: ${err.message}`);
+    }
+    console.log();
+    console.log(`  ${errorCount} error(s), ${warningCount} warning(s)`);
+    if (errorCount > 0) {
+        process.exitCode = 1;
+    }
+});
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { injectCommand } from './commands/inject.js';
+import { initCommand } from './commands/init.js';
+import { validateCommand } from './commands/validate.js';
+import { proposeCommand } from './commands/propose.js';
+import { applyCommand } from './commands/apply.js';
+import { sessionsCommand } from './commands/sessions.js';
+import { driftCommand } from './commands/drift.js';
+import { daemonCommand, dashboardCommand } from './commands/daemon.js';
+import { runCommand } from './commands/run.js';
+import { codexCommand } from './commands/codex.js';
+import { pluginCommand } from './commands/plugin.js';
+import { indexCommand } from './commands/index-cmd.js';
+import { historyCommand } from './commands/history-cmd.js';
+import { conflictsCommand } from './commands/conflicts-cmd.js';
+import { bootstrapCommand } from './commands/bootstrap-cmd.js';
+import { migrateCommand } from './commands/migrate-cmd.js';
+import { hooksCommand } from './commands/hooks-cmd.js';
+import { speckitCommand } from './commands/speckit-cmd.js';
+import { prContextCommand } from './commands/pr-context-cmd.js';
+const program = new Command();
+program
+    .name('ctxkit')
+    .description('Context & Memory Manager CLI')
+    .version('0.1.0');
+// Register subcommands
+program.addCommand(injectCommand);
+program.addCommand(initCommand);
+program.addCommand(validateCommand);
+program.addCommand(proposeCommand);
+program.addCommand(applyCommand);
+program.addCommand(sessionsCommand);
+program.addCommand(driftCommand);
+program.addCommand(daemonCommand);
+program.addCommand(dashboardCommand);
+program.addCommand(runCommand);
+program.addCommand(codexCommand);
+program.addCommand(pluginCommand);
+program.addCommand(indexCommand);
+program.addCommand(historyCommand);
+program.addCommand(conflictsCommand);
+program.addCommand(bootstrapCommand);
+program.addCommand(migrateCommand);
+program.addCommand(hooksCommand);
+program.addCommand(speckitCommand);
+program.addCommand(prContextCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,8BAA8B,CAAC;KAC3C,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,uBAAuB;AACvB,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AAErC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/services/agents-md.d.ts

@@ -0,0 +1,34 @@
+import { type CtxFile } from '@ctxkit/core';
+export interface SyncResult {
+    dir: string;
+    relativePath: string;
+    action: 'created' | 'updated' | 'unchanged';
+    tokens: number;
+}
+export interface SyncOptions {
+    repoRoot: string;
+    budget: number;
+    dryRun: boolean;
+}
+/**
+ * Walk the repo to find all directories containing .ctx files.
+ */
+export declare function findCtxDirectories(repoRoot: string): string[];
+/**
+ * Generate the CtxKit-managed content block for a directory's .ctx file.
+ */
+export declare function generateCtxKitSection(ctx: CtxFile, dir: string, repoRoot: string, budget: number): string;
+/**
+ * Merge CtxKit-managed content into an existing AGENTS.md file,
+ * preserving user-written content outside the markers.
+ */
+export declare function mergeWithExisting(existingContent: string, ctxkitSection: string): string;
+/**
+ * Extract the CtxKit-managed section from an existing file.
+ */
+export declare function extractManagedSection(content: string): string | null;
+/**
+ * Run the sync-agents command: walk .ctx hierarchy, generate AGENTS.md files.
+ */
+export declare function syncAgents(options: SyncOptions): SyncResult[];
+//# sourceMappingURL=agents-md.d.ts.map

package/dist/services/agents-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../src/services/agents-md.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,OAAO,EAEb,MAAM,cAAc,CAAC;AAKtB,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAiC7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAsGR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKpE;AAUD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,EAAE,CA+E7D"}

package/dist/services/agents-md.js

@@ -0,0 +1,248 @@
+import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { parseCtxFile, redactSecrets, estimateTokens, loadProfile, } from '@ctxkit/core';
+const CTXKIT_BEGIN = '<!-- CTXKIT:BEGIN - Managed by CtxKit. Do not edit this section. -->';
+const CTXKIT_END = '<!-- CTXKIT:END -->';
+/**
+ * Walk the repo to find all directories containing .ctx files.
+ */
+export function findCtxDirectories(repoRoot) {
+    const dirs = [];
+    function walk(dir) {
+        const ctxPath = join(dir, '.ctx');
+        if (existsSync(ctxPath) && statSync(ctxPath).isFile()) {
+            dirs.push(dir);
+        }
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.startsWith('.') || entry === 'node_modules' || entry === 'dist') {
+                continue;
+            }
+            const fullPath = join(dir, entry);
+            try {
+                if (statSync(fullPath).isDirectory()) {
+                    walk(fullPath);
+                }
+            }
+            catch {
+                // Skip inaccessible dirs
+            }
+        }
+    }
+    walk(repoRoot);
+    return dirs;
+}
+/**
+ * Generate the CtxKit-managed content block for a directory's .ctx file.
+ */
+export function generateCtxKitSection(ctx, dir, repoRoot, budget) {
+    const contextBudget = Math.floor(budget * 0.7);
+    const lines = [];
+    lines.push(`<!-- Generated: ${new Date().toISOString()} | Source: .ctx hierarchy -->`);
+    lines.push('');
+    lines.push('## CtxKit Project Context');
+    lines.push('');
+    if (ctx.summary) {
+        lines.push(redactSecrets(ctx.summary));
+        lines.push('');
+    }
+    // Key Files
+    if (ctx.key_files.length > 0) {
+        lines.push('### Key Files');
+        for (const kf of ctx.key_files) {
+            const purpose = kf.purpose ? ` \u2014 ${redactSecrets(kf.purpose)}` : '';
+            lines.push(`- \`${kf.path}\`${purpose}`);
+        }
+        lines.push('');
+    }
+    // Decisions (only active ones)
+    const activeDecisions = ctx.decisions.filter((d) => d.status === 'accepted');
+    if (activeDecisions.length > 0) {
+        lines.push('### Decisions');
+        for (const d of activeDecisions) {
+            const date = d.date ? ` (decided ${d.date})` : '';
+            lines.push(`- ${redactSecrets(d.title)}${date}`);
+        }
+        lines.push('');
+    }
+    // Gotchas
+    if (ctx.gotchas.length > 0) {
+        lines.push('### Gotchas');
+        for (const g of ctx.gotchas) {
+            lines.push(`- ${redactSecrets(g.text)}`);
+        }
+        lines.push('');
+    }
+    // Contracts
+    if (ctx.contracts.length > 0) {
+        lines.push('### Contracts');
+        for (const c of ctx.contracts) {
+            lines.push(`- **${c.name}**: ${redactSecrets(c.content).slice(0, 100)}`);
+        }
+        lines.push('');
+    }
+    // Check context budget — truncate if needed
+    let contextContent = lines.join('\n');
+    let contextTokens = estimateTokens(contextContent);
+    if (contextTokens > contextBudget) {
+        // Progressively remove sections to fit budget
+        // Remove contracts first (least critical for AGENTS.md)
+        if (ctx.contracts.length > 0) {
+            const contractIdx = contextContent.indexOf('### Contracts');
+            if (contractIdx >= 0) {
+                contextContent = contextContent.slice(0, contractIdx).trimEnd() + '\n';
+                contextTokens = estimateTokens(contextContent);
+            }
+        }
+        // If still over, remove gotchas
+        if (contextTokens > contextBudget && ctx.gotchas.length > 0) {
+            const gotchaIdx = contextContent.indexOf('### Gotchas');
+            if (gotchaIdx >= 0) {
+                contextContent = contextContent.slice(0, gotchaIdx).trimEnd() + '\n';
+                contextTokens = estimateTokens(contextContent);
+            }
+        }
+    }
+    // Policy section (uses remaining budget)
+    const policyLines = [];
+    policyLines.push('## CtxKit Usage Policy');
+    policyLines.push('');
+    policyLines.push('When working in this project, you have access to CtxKit tools for context and memory management.');
+    policyLines.push('');
+    policyLines.push('### Preferred: MCP Tools');
+    policyLines.push('If CtxKit MCP server is available (check with `/mcp`), use these tools:');
+    policyLines.push('- `ctxkit.context_pack` \u2014 Get relevant context before responding');
+    policyLines.push('- `ctxkit.log_event` \u2014 Log tool calls for session tracking');
+    policyLines.push('- `ctxkit.propose_update` \u2014 Propose .ctx memory updates');
+    policyLines.push('- `ctxkit.memory.search` \u2014 Search project memory');
+    policyLines.push('');
+    policyLines.push('### Fallback: CLI Commands');
+    policyLines.push('If MCP is unavailable, use the CLI directly:');
+    policyLines.push('- `ctxkit inject "<request>" --json` \u2014 Get context pack');
+    policyLines.push('- `ctxkit sessions list --json` \u2014 List sessions');
+    policyLines.push('- `ctxkit propose --json` \u2014 Propose updates');
+    policyLines.push('');
+    policyLines.push('### Best Practices');
+    policyLines.push('- Call `ctxkit.context_pack(mode=turn)` before responding to user prompts');
+    policyLines.push('- Call `ctxkit.log_event` after each tool invocation');
+    policyLines.push('- Call `ctxkit.propose_update` when you learn something new about the project');
+    const fullContent = contextContent + '\n' + policyLines.join('\n');
+    return fullContent;
+}
+/**
+ * Merge CtxKit-managed content into an existing AGENTS.md file,
+ * preserving user-written content outside the markers.
+ */
+export function mergeWithExisting(existingContent, ctxkitSection) {
+    const beginIdx = existingContent.indexOf(CTXKIT_BEGIN);
+    const endIdx = existingContent.indexOf(CTXKIT_END);
+    const managedBlock = `${CTXKIT_BEGIN}\n${ctxkitSection}\n${CTXKIT_END}`;
+    if (beginIdx >= 0 && endIdx >= 0) {
+        // Replace existing managed section
+        const before = existingContent.slice(0, beginIdx);
+        const after = existingContent.slice(endIdx + CTXKIT_END.length);
+        return before + managedBlock + after;
+    }
+    // No markers found — append at the end
+    const separator = existingContent.endsWith('\n') ? '\n' : '\n\n';
+    return existingContent + separator + managedBlock + '\n';
+}
+/**
+ * Extract the CtxKit-managed section from an existing file.
+ */
+export function extractManagedSection(content) {
+    const beginIdx = content.indexOf(CTXKIT_BEGIN);
+    const endIdx = content.indexOf(CTXKIT_END);
+    if (beginIdx < 0 || endIdx < 0)
+        return null;
+    return content.slice(beginIdx + CTXKIT_BEGIN.length, endIdx).trim();
+}
+/**
+ * Strip the generated timestamp line for idempotency comparison.
+ * The timestamp changes on every run but the content is otherwise identical.
+ */
+function stripTimestamp(text) {
+    return text.replace(/<!-- Generated: .* \| Source: .ctx hierarchy -->\n?/, '');
+}
+/**
+ * Run the sync-agents command: walk .ctx hierarchy, generate AGENTS.md files.
+ */
+export function syncAgents(options) {
+    const { repoRoot, budget, dryRun } = options;
+    const results = [];
+    // Load profile for ignore policies
+    const profile = loadProfile(repoRoot);
+    const neverRead = new Set(profile.ignore.never_read);
+    // Find all directories with .ctx files
+    const ctxDirs = findCtxDirectories(repoRoot);
+    for (const dir of ctxDirs) {
+        const ctxPath = join(dir, '.ctx');
+        const relDir = relative(repoRoot, dir) || '.';
+        const agentsPath = join(dir, 'AGENTS.md');
+        // Check ignore policy
+        const relCtxPath = relative(repoRoot, ctxPath);
+        if (neverRead.has(relCtxPath) || neverRead.has(relDir)) {
+            continue;
+        }
+        // Parse .ctx file
+        let ctx;
+        try {
+            const raw = readFileSync(ctxPath, 'utf-8');
+            const result = parseCtxFile(raw);
+            ctx = result.ctx;
+        }
+        catch {
+            continue; // Skip invalid .ctx files
+        }
+        // Generate CtxKit section
+        const section = generateCtxKitSection(ctx, dir, repoRoot, budget);
+        const tokens = estimateTokens(section);
+        // Check existing file for idempotency
+        if (existsSync(agentsPath)) {
+            const existing = readFileSync(agentsPath, 'utf-8');
+            const existingManaged = extractManagedSection(existing);
+            // Compare without timestamps (they change every run)
+            if (existingManaged !== null && stripTimestamp(existingManaged) === stripTimestamp(section.trim())) {
+                results.push({
+                    dir: relDir,
+                    relativePath: relative(repoRoot, agentsPath),
+                    action: 'unchanged',
+                    tokens,
+                });
+                continue;
+            }
+            // Merge with existing content (preserve user sections)
+            const merged = mergeWithExisting(existing, section);
+            if (!dryRun) {
+                writeFileSync(agentsPath, merged, 'utf-8');
+            }
+            results.push({
+                dir: relDir,
+                relativePath: relative(repoRoot, agentsPath),
+                action: 'updated',
+                tokens,
+            });
+        }
+        else {
+            // Create new file
+            const newContent = `${CTXKIT_BEGIN}\n${section}\n${CTXKIT_END}\n`;
+            if (!dryRun) {
+                writeFileSync(agentsPath, newContent, 'utf-8');
+            }
+            results.push({
+                dir: relDir,
+                relativePath: relative(repoRoot, agentsPath),
+                action: 'created',
+                tokens,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=agents-md.js.map