ctxinit 0.1.0

package/dist/cli.js

@@ -0,0 +1,262 @@
+"use strict";
+/**
+ * CLI Entry Point
+ *
+ * Unified `ctx` command for context architecture management.
+ * Supports init, build, lint, diff, verify, and migrate subcommands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const commander_1 = require("commander");
+const init_1 = require("./cli/init");
+const build_1 = require("./cli/build");
+const lint_1 = require("./cli/lint");
+const verify_1 = require("./cli/verify");
+const diff_1 = require("./cli/diff");
+const migrate_1 = require("./cli/migrate");
+const hooks_1 = require("./cli/hooks");
+const bootstrap_1 = require("./bootstrap");
+const llm_1 = require("./llm");
+const program = new commander_1.Command();
+program
+    .name('ctx')
+    .description('Unified context architecture for AI coding assistants')
+    .version('0.1.0');
+// Init command
+program
+    .command('init')
+    .description('Initialize .context directory in your project')
+    .option('-f, --force', 'Overwrite existing .context directory (creates backup)')
+    .option('--no-interactive', 'Run without prompts (use defaults)')
+    .option('--wizard', 'Launch guided migration wizard')
+    .option('--dry-run', 'Show what would happen without making changes')
+    // Back-compat: init runs bootstrap by default, but keep --bootstrap flag accepted.
+    .option('-b, --bootstrap', 'Run LLM bootstrap after init (default)')
+    .option('--no-bootstrap', 'Skip LLM bootstrap (only create templates)')
+    .action(async (options) => {
+    try {
+        const exitCode = await (0, init_1.runInit)({
+            force: options.force,
+            interactive: options.interactive,
+            wizard: options.wizard,
+            dryRun: options.dryRun,
+            bootstrap: options.bootstrap,
+        });
+        process.exit(exitCode);
+    }
+    catch (error) {
+        console.error('Error:', error.message);
+        process.exit(2);
+    }
+});
+// Build command
+program
+    .command('build [targets...]')
+    .description('Compile rules into target formats')
+    .option('-i, --incremental', 'Only rebuild changed files')
+    .option('--check', 'Check whether compiled outputs are up to date (no writes)')
+    .option('-v, --verbose', 'Show detailed output')
+    .option('-q, --quiet', 'Suppress output except errors')
+    .option('--skip-validation', 'Skip validation step')
+    .option('--force', 'Force full rebuild')
+    .option('-t, --target <targets...>', 'Specific targets to build (claude, cursor, agents)')
+    .action(async (targets, options) => {
+    try {
+        let targetArgs = options.target;
+        if (!targetArgs || targetArgs.length === 0) {
+            if (Array.isArray(targets)) {
+                targetArgs = targets.length > 0 ? targets : undefined;
+            }
+            else if (targets) {
+                targetArgs = [targets];
+            }
+        }
+        const exitCode = await (0, build_1.runBuild)({
+            incremental: options.incremental,
+            check: options.check,
+            verbose: options.verbose,
+            quiet: options.quiet,
+            skipValidation: options.skipValidation,
+            force: options.force,
+            target: targetArgs,
+        });
+        process.exit(exitCode);
+    }
+    catch (error) {
+        console.error('Error:', error.message);
+        process.exit(2);
+    }
+});
+const runLintCommand = async (files = [], options) => {
+    try {
+        const exitCode = await (0, lint_1.runLint)({
+            json: options.json,
+            verbose: options.verbose,
+            quiet: options.quiet,
+            files: files.length > 0 ? files : undefined,
+        });
+        process.exit(exitCode);
+    }
+    catch (error) {
+        console.error('Error:', error.message);
+        process.exit(2);
+    }
+};
+// Lint command
+program
+    .command('lint [files...]')
+    .description('Validate rules without building')
+    .option('--json', 'Output in JSON format')
+    .option('-v, --verbose', 'Show detailed output')
+    .option('-q, --quiet', 'Suppress output except errors')
+    .action(runLintCommand);
+// Validate command (alias for lint)
+program
+    .command('validate [files...]')
+    .description('Alias for lint: validate rules without building')
+    .option('--json', 'Output in JSON format')
+    .option('-v, --verbose', 'Show detailed output')
+    .option('-q, --quiet', 'Suppress output except errors')
+    .action(runLintCommand);
+// Verify command
+program
+    .command('verify')
+    .description('Verify checksums of compiled outputs')
+    .option('-v, --verbose', 'Show detailed output')
+    .option('--json', 'Output in JSON format')
+    .action(async (options) => {
+    try {
+        const exitCode = await (0, verify_1.runVerify)({
+            verbose: options.verbose,
+            json: options.json,
+        });
+        process.exit(exitCode);
+    }
+    catch (error) {
+        console.error('Error:', error.message);
+        process.exit(2);
+    }
+});
+// Diff command
+program
+    .command('diff')
+    .description('Compare compiled outputs with legacy files')
+    .option('--legacy', 'Compare with legacy context files')
+    .option('--unified', 'Show unified diff format')
+    .option('-v, --verbose', 'Show detailed diff output')
+    .action(async (options) => {
+    try {
+        const exitCode = await (0, diff_1.runDiff)({
+            legacy: options.legacy,
+            unified: options.unified,
+            verbose: options.verbose,
+        });
+        process.exit(exitCode);
+    }
+    catch (error) {
+        console.error('Error:', error.message);
+        process.exit(2);
+    }
+});
+// Migrate command
+program
+    .command('migrate')
+    .description('Manage migration from legacy context files')
+    .option('--analyze', 'Analyze existing legacy files')
+    .option('--attach', 'Create .context alongside legacy files')
+    .option('--complete', 'Remove legacy files after migration')
+    .option('-f, --force', 'Skip confirmation prompts')
+    .option('--dry-run', 'Show what would happen without making changes')
+    .action(async (options) => {
+    try {
+        const exitCode = await (0, migrate_1.runMigrate)({
+            analyze: options.analyze,
+            attach: options.attach,
+            complete: options.complete,
+            force: options.force,
+            dryRun: options.dryRun,
+        });
+        process.exit(exitCode);
+    }
+    catch (error) {
+        console.error('Error:', error.message);
+        process.exit(2);
+    }
+});
+// Hooks command
+program
+    .command('hooks')
+    .description('Manage git hooks integration')
+    .option('--install', 'Install hooks without prompts')
+    .option('--remove', 'Remove ctx git hooks')
+    .option('--skip-husky', 'Skip Husky installation')
+    .option('--skip-gitignore', 'Skip .gitignore updates')
+    .option('-f, --force', 'Force overwrite existing hooks')
+    .option('--dry-run', 'Show what would happen without making changes')
+    .option('-v, --verbose', 'Show detailed output')
+    .action(async (options) => {
+    try {
+        const exitCode = await (0, hooks_1.runHooks)({
+            install: options.install,
+            remove: options.remove,
+            skipHusky: options.skipHusky,
+            skipGitignore: options.skipGitignore,
+            force: options.force,
+            dryRun: options.dryRun,
+            verbose: options.verbose,
+        });
+        process.exit(exitCode);
+    }
+    catch (error) {
+        console.error('Error:', error.message);
+        process.exit(2);
+    }
+});
+// Bootstrap command (enhanced LLM-powered context generation)
+program
+    .command('bootstrap')
+    .description('Generate context files using LLM analysis')
+    .option('-p, --provider <type>', 'LLM provider to use (auto-detect if not specified)')
+    .option('--analyze-only', 'Only analyze codebase, skip LLM invocation')
+    .option('--skip-validation', 'Skip output validation')
+    .option('--auto-build', 'Automatically run build after bootstrap')
+    .option('-v, --verbose', 'Show detailed output including prompts')
+    .option('--dry-run', 'Show what would be generated without writing files')
+    .option('--list-providers', 'List available LLM providers')
+    .action(async (options) => {
+    try {
+        // List providers if requested
+        if (options.listProviders) {
+            console.log('\nAvailable LLM providers:\n');
+            for (const provider of (0, llm_1.listProviderTypes)()) {
+                console.log(`  ${provider.type.padEnd(15)} ${provider.description}`);
+            }
+            console.log('\nUse --provider <type> to specify a provider.');
+            console.log('If not specified, the best available provider will be auto-selected.\n');
+            process.exit(0);
+        }
+        const result = await (0, bootstrap_1.runEnhancedBootstrap)(process.cwd(), {
+            provider: options.provider,
+            analyzeOnly: options.analyzeOnly,
+            skipValidation: options.skipValidation,
+            autoBuild: options.autoBuild,
+            verbose: options.verbose,
+            dryRun: options.dryRun,
+        });
+        process.exit(result.success ? 0 : 1);
+    }
+    catch (error) {
+        console.error('Error:', error.message);
+        process.exit(2);
+    }
+});
+// Handle unknown commands
+program.on('command:*', () => {
+    console.error('Unknown command: %s', program.args.join(' '));
+    console.log('Run `ctx --help` for available commands.');
+    process.exit(1);
+});
+function run() {
+    program.parse();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/compiler/agents-compiler.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Agents Compiler
+ *
+ * Compiles rules to a comprehensive AGENTS.md file for general AI agents.
+ * Includes full project context, architecture, and rule summaries.
+ */
+import { BaseCompiler, CompilerContext, CompilationResult } from './base-compiler';
+/**
+ * Agents compiler implementation
+ */
+export declare class AgentsCompiler extends BaseCompiler {
+    constructor(context: CompilerContext);
+    get targetName(): string;
+    compile(): Promise<CompilationResult>;
+    /**
+     * Build the complete AGENTS.md content
+     */
+    private buildOutput;
+    /**
+     * Build a failure result
+     */
+    private buildFailureResult;
+}
+//# sourceMappingURL=agents-compiler.d.ts.map

package/dist/compiler/agents-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-compiler.d.ts","sourceRoot":"","sources":["../../src/compiler/agents-compiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EAIlB,MAAM,iBAAiB,CAAC;AAIzB;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBAClC,OAAO,EAAE,eAAe;IAIpC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAEK,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAwH3C;;OAEG;IACH,OAAO,CAAC,WAAW;IAiEnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB3B"}

package/dist/compiler/agents-compiler.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * Agents Compiler
+ *
+ * Compiles rules to a comprehensive AGENTS.md file for general AI agents.
+ * Includes full project context, architecture, and rule summaries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsCompiler = void 0;
+const base_compiler_1 = require("./base-compiler");
+const token_estimator_1 = require("./token-estimator");
+const rule_selector_1 = require("./rule-selector");
+/**
+ * Agents compiler implementation
+ */
+class AgentsCompiler extends base_compiler_1.BaseCompiler {
+    constructor(context) {
+        super(context);
+    }
+    get targetName() {
+        return 'agents';
+    }
+    async compile() {
+        const errors = [];
+        const warnings = [];
+        // Get agents config
+        const agentsConfig = this.context.config.compile?.agents;
+        const maxTokens = agentsConfig?.max_tokens || 8000;
+        // Load project.md (required)
+        const projectContent = await this.loadProjectContent();
+        if (!projectContent) {
+            errors.push({
+                type: 'missing_file',
+                message: 'project.md is required for Agents compilation but was not found',
+                path: '.context/project.md',
+            });
+            return this.buildFailureResult(errors, warnings);
+        }
+        // Load architecture.md (optional)
+        const architectureContent = await this.loadArchitectureContent();
+        if (!architectureContent) {
+            warnings.push({
+                type: 'missing_optional',
+                message: 'architecture.md not found, compilation will continue without it',
+                path: '.context/architecture.md',
+            });
+        }
+        // Calculate token usage for required content
+        let usedTokens = 0;
+        usedTokens += (0, token_estimator_1.estimateTokens)(projectContent).tokens;
+        if (architectureContent) {
+            usedTokens += (0, token_estimator_1.estimateTokens)(architectureContent).tokens;
+        }
+        // Reserve tokens for meta-rule
+        const metaRule = this.generateMetaRule();
+        usedTokens += (0, token_estimator_1.estimateTokens)(metaRule).tokens;
+        // Calculate remaining budget for rules
+        const effectiveBudget = (0, token_estimator_1.applyBudgetMargin)(maxTokens);
+        const rulesBudget = Math.max(0, effectiveBudget - usedTokens);
+        // For agents, we use summaries instead of full content
+        const allRules = (0, rule_selector_1.sortByPriority)(this.context.rules);
+        const selectedRules = [];
+        let ruleTokens = 0;
+        for (const rule of allRules) {
+            const summary = this.getRuleSummary(rule);
+            const summaryTokens = (0, token_estimator_1.estimateTokens)(summary).tokens;
+            if (ruleTokens + summaryTokens <= rulesBudget) {
+                selectedRules.push(rule);
+                ruleTokens += summaryTokens;
+            }
+            else {
+                warnings.push({
+                    type: 'token_limit',
+                    message: `Rule ${rule.frontmatter.id} excluded due to token budget`,
+                });
+            }
+        }
+        if (selectedRules.length === 0 && this.context.rules.length > 0) {
+            warnings.push({
+                type: 'empty_rules',
+                message: 'No rules included in AGENTS.md due to token budget constraints',
+            });
+        }
+        // Build output content
+        let content = this.buildOutput(projectContent, architectureContent, selectedRules, metaRule);
+        // Add checksum and timestamp metadata
+        content = this.addMetadata(content);
+        const totalTokens = (0, token_estimator_1.estimateTokens)(content).tokens;
+        // Create output
+        const output = {
+            path: 'AGENTS.md',
+            content,
+            tokens: totalTokens,
+        };
+        // Write output (optional - callers like the build orchestrator may write atomically)
+        if (this.context.writeToDisk !== false) {
+            try {
+                this.writeOutput(output.path, output.content);
+            }
+            catch (error) {
+                errors.push({
+                    type: 'write_error',
+                    message: `Failed to write AGENTS.md: ${error.message}`,
+                    path: 'AGENTS.md',
+                });
+            }
+        }
+        return {
+            success: errors.length === 0,
+            outputs: [output],
+            errors,
+            warnings,
+            totalTokens,
+            stats: {
+                rulesProcessed: this.context.rules.length,
+                rulesIncluded: selectedRules.length,
+                outputFiles: 1,
+                totalTokens,
+                tokenBudget: maxTokens,
+            },
+        };
+    }
+    /**
+     * Build the complete AGENTS.md content
+     */
+    buildOutput(projectContent, architectureContent, rules, metaRule) {
+        const sections = [];
+        // Header
+        sections.push('# Agent Context\n');
+        sections.push('This document provides context for AI agents working with this project.\n');
+        // Full project content
+        sections.push('## Project Overview\n');
+        sections.push(projectContent.trim());
+        sections.push('');
+        // Full architecture content
+        if (architectureContent) {
+            sections.push('## Architecture\n');
+            sections.push(architectureContent.trim());
+            sections.push('');
+        }
+        // Rule summaries
+        if (rules.length > 0) {
+            sections.push('## Rules and Guidelines\n');
+            for (const rule of rules) {
+                sections.push(`### ${rule.frontmatter.id}\n`);
+                // Include description
+                if (rule.frontmatter.description) {
+                    sections.push(`**Description:** ${rule.frontmatter.description}\n`);
+                }
+                // Include tags if present
+                if (rule.frontmatter.tags && rule.frontmatter.tags.length > 0) {
+                    sections.push(`**Tags:** ${rule.frontmatter.tags.join(', ')}\n`);
+                }
+                // Include domain if present
+                if (rule.frontmatter.domain) {
+                    sections.push(`**Domain:** ${rule.frontmatter.domain}\n`);
+                }
+                // Include summary (first paragraph)
+                const firstParagraph = rule.content.split('\n\n')[0];
+                if (firstParagraph) {
+                    sections.push(firstParagraph.trim());
+                }
+                sections.push('');
+            }
+        }
+        // Directory index for navigation
+        sections.push(this.generateDirectoryIndex(rules));
+        // Meta-rule
+        sections.push(metaRule);
+        return sections.join('\n');
+    }
+    /**
+     * Build a failure result
+     */
+    buildFailureResult(errors, warnings) {
+        return {
+            success: false,
+            outputs: [],
+            errors,
+            warnings,
+            totalTokens: 0,
+            stats: {
+                rulesProcessed: 0,
+                rulesIncluded: 0,
+                outputFiles: 0,
+                totalTokens: 0,
+            },
+        };
+    }
+}
+exports.AgentsCompiler = AgentsCompiler;
+//# sourceMappingURL=agents-compiler.js.map

package/dist/compiler/agents-compiler.js.map

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

package/dist/compiler/base-compiler.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Base compiler interface and abstract class for target-specific compilation
+ */
+import { ParsedRule } from '../schemas/rule';
+import { Config } from '../schemas/config';
+/**
+ * Compilation result
+ */
+export interface CompilationResult {
+    /** Whether compilation succeeded */
+    success: boolean;
+    /** Output files generated */
+    outputs: OutputFile[];
+    /** Errors encountered */
+    errors: CompilationError[];
+    /** Warnings generated */
+    warnings: CompilationWarning[];
+    /** Total tokens in output */
+    totalTokens: number;
+    /** Compilation statistics */
+    stats: CompilationStats;
+}
+/**
+ * Output file generated by compilation
+ */
+export interface OutputFile {
+    /** Output file path (relative to project root) */
+    path: string;
+    /** File content */
+    content: string;
+    /** Estimated tokens */
+    tokens: number;
+}
+/**
+ * Compilation error
+ */
+export interface CompilationError {
+    /** Error type */
+    type: 'missing_file' | 'write_error' | 'parse_error' | 'config_error';
+    /** Error message */
+    message: string;
+    /** Related file path */
+    path?: string;
+}
+/**
+ * Compilation warning
+ */
+export interface CompilationWarning {
+    /** Warning type */
+    type: 'missing_optional' | 'truncated' | 'empty_rules' | 'token_limit';
+    /** Warning message */
+    message: string;
+    /** Related file path */
+    path?: string;
+}
+/**
+ * Compilation statistics
+ */
+export interface CompilationStats {
+    /** Number of rules processed */
+    rulesProcessed: number;
+    /** Number of rules included */
+    rulesIncluded: number;
+    /** Number of output files */
+    outputFiles: number;
+    /** Total tokens in output */
+    totalTokens: number;
+    /** Token budget (if applicable) */
+    tokenBudget?: number;
+}
+/**
+ * Compiler context with project information
+ */
+export interface CompilerContext {
+    /** Project root directory */
+    projectRoot: string;
+    /** Configuration */
+    config: Config;
+    /** Parsed rules */
+    rules: ParsedRule[];
+    /**
+     * Whether compilers should write outputs to disk.
+     * When false, compilers only return `outputs` and the caller is responsible for writing.
+     * (Default: true)
+     */
+    writeToDisk?: boolean;
+    /** Project description content (from project.md) */
+    projectContent?: string;
+    /** Architecture content (from architecture.md) */
+    architectureContent?: string;
+}
+/**
+ * Abstract base compiler class
+ */
+export declare abstract class BaseCompiler {
+    protected context: CompilerContext;
+    constructor(context: CompilerContext);
+    /**
+     * Compile rules to target format
+     */
+    abstract compile(): Promise<CompilationResult>;
+    /**
+     * Get the target name (e.g., 'cursor', 'claude', 'agents')
+     */
+    abstract get targetName(): string;
+    /**
+     * Load project.md content
+     */
+    protected loadProjectContent(): Promise<string | undefined>;
+    /**
+     * Load architecture.md content
+     */
+    protected loadArchitectureContent(): Promise<string | undefined>;
+    /**
+     * Ensure output directory exists
+     */
+    protected ensureDirectory(dirPath: string): void;
+    /**
+     * Write output file
+     */
+    protected writeOutput(filePath: string, content: string): void;
+    /**
+     * Generate Context Hygiene meta-rule content
+     */
+    protected generateMetaRule(): string;
+    /**
+     * Generate directory index for agent navigation
+     */
+    protected generateDirectoryIndex(rules: ParsedRule[]): string;
+    /**
+     * Get summary of rule (description + first paragraph)
+     */
+    protected getRuleSummary(rule: ParsedRule): string;
+    /**
+     * Generate SHA-256 checksum for content
+     */
+    protected generateChecksum(content: string): string;
+    /**
+     * Generate build timestamp in ISO format
+     */
+    protected generateTimestamp(): string;
+    /**
+     * Generate footer with checksum and timestamp
+     * The checksum is calculated on the content BEFORE appending this footer
+     */
+    protected generateFooter(content: string): string;
+    /**
+     * Add checksum and timestamp footer to content
+     */
+    protected addMetadata(content: string): string;
+}
+//# sourceMappingURL=base-compiler.d.ts.map

package/dist/compiler/base-compiler.d.ts.map

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