ctxinit 0.1.0

package/dist/bootstrap/validator.js

@@ -0,0 +1,412 @@
+"use strict";
+/**
+ * Bootstrap Output Validator
+ *
+ * Validates LLM-generated context files for:
+ * - Valid file/directory references
+ * - Valid glob patterns
+ * - Correct YAML frontmatter structure
+ * - LLM-specific best practices
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBootstrapOutput = validateBootstrapOutput;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+/**
+ * Validate bootstrap output
+ */
+async function validateBootstrapOutput(output, projectRoot, analysis) {
+    const errors = [];
+    const warnings = [];
+    const suggestions = [];
+    // Validate project.md
+    if (output.projectMd) {
+        const projectValidation = validateMarkdownContent(output.projectMd, 'project.md', projectRoot, analysis);
+        errors.push(...projectValidation.errors);
+        warnings.push(...projectValidation.warnings);
+    }
+    // Validate architecture.md
+    if (output.architectureMd) {
+        const archValidation = validateMarkdownContent(output.architectureMd, 'architecture.md', projectRoot, analysis);
+        errors.push(...archValidation.errors);
+        warnings.push(...archValidation.warnings);
+    }
+    // Validate rules
+    for (const rule of output.rules) {
+        const ruleValidation = await validateRule(rule, projectRoot, analysis);
+        errors.push(...ruleValidation.errors);
+        warnings.push(...ruleValidation.warnings);
+        suggestions.push(...ruleValidation.suggestions);
+    }
+    // Check for best practices
+    const bestPractices = checkBestPractices(output, analysis);
+    warnings.push(...bestPractices.warnings);
+    suggestions.push(...bestPractices.suggestions);
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        suggestions,
+    };
+}
+/**
+ * Validate markdown content for file references
+ */
+function validateMarkdownContent(content, fileName, projectRoot, _analysis) {
+    const errors = [];
+    const warnings = [];
+    // Extract @file references
+    const fileRefs = extractFileReferences(content);
+    for (const ref of fileRefs) {
+        const fullPath = path.join(projectRoot, ref);
+        if (!fs.existsSync(fullPath)) {
+            // Check if it's a directory
+            const dirPath = fullPath.replace(/\/$/, '');
+            if (!fs.existsSync(dirPath)) {
+                errors.push(`${fileName}: Invalid file reference '@${ref}' - file does not exist`);
+            }
+        }
+    }
+    // Extract markdown links
+    const links = extractMarkdownLinks(content);
+    for (const link of links) {
+        // Skip external URLs
+        if (link.startsWith('http://') || link.startsWith('https://')) {
+            continue;
+        }
+        // Check relative paths
+        if (!link.startsWith('#')) {
+            const fullPath = path.join(projectRoot, link);
+            if (!fs.existsSync(fullPath)) {
+                warnings.push(`${fileName}: Potentially broken link '${link}'`);
+            }
+        }
+    }
+    // Check for generic/vague content
+    const genericPhrases = [
+        'write clean code',
+        'follow best practices',
+        'be careful',
+        'use appropriate',
+        'ensure quality',
+    ];
+    for (const phrase of genericPhrases) {
+        if (content.toLowerCase().includes(phrase)) {
+            warnings.push(`${fileName}: Contains generic phrase '${phrase}' - be more specific`);
+        }
+    }
+    return { errors, warnings };
+}
+/**
+ * Validate a rule file
+ */
+async function validateRule(rule, projectRoot, _analysis) {
+    const errors = [];
+    const warnings = [];
+    const suggestions = [];
+    // Parse frontmatter
+    const frontmatter = parseFrontmatter(rule.content);
+    if (!frontmatter) {
+        errors.push(`${rule.path}: Missing or invalid YAML frontmatter`);
+        return { valid: false, errors, warnings, suggestions };
+    }
+    // Validate required frontmatter fields
+    if (!frontmatter.id) {
+        errors.push(`${rule.path}: Missing required 'id' in frontmatter`);
+    }
+    else if (!/^[a-z0-9-]+$/.test(frontmatter.id)) {
+        warnings.push(`${rule.path}: Rule ID '${frontmatter.id}' should be lowercase with hyphens`);
+    }
+    if (!frontmatter.description) {
+        warnings.push(`${rule.path}: Missing 'description' in frontmatter`);
+    }
+    // Validate globs
+    if (frontmatter.globs && Array.isArray(frontmatter.globs)) {
+        for (const glob of frontmatter.globs) {
+            const globValidation = validateGlobPattern(glob, projectRoot);
+            if (!globValidation.valid) {
+                errors.push(`${rule.path}: Invalid glob pattern '${glob}': ${globValidation.reason}`);
+            }
+            else if (globValidation.warning) {
+                warnings.push(`${rule.path}: Glob warning for '${glob}': ${globValidation.warning}`);
+            }
+            // Check if glob matches any files
+            const matches = await (0, fast_glob_1.default)(glob, { cwd: projectRoot, onlyFiles: true, dot: true });
+            if (matches.length === 0) {
+                warnings.push(`${rule.path}: Glob '${glob}' matches no files in project`);
+            }
+        }
+    }
+    else {
+        warnings.push(`${rule.path}: Missing 'globs' array in frontmatter`);
+    }
+    // Validate priority
+    if (frontmatter.priority !== undefined) {
+        if (typeof frontmatter.priority !== 'number' || frontmatter.priority < 0 || frontmatter.priority > 100) {
+            errors.push(`${rule.path}: Priority must be a number between 0 and 100`);
+        }
+    }
+    // Validate content
+    const contentValidation = validateMarkdownContent(rule.content, rule.path, projectRoot, _analysis);
+    errors.push(...contentValidation.errors);
+    warnings.push(...contentValidation.warnings);
+    // Check content quality
+    const bodyContent = rule.content.replace(/^---[\s\S]*?---/, '').trim();
+    if (bodyContent.length < 100) {
+        warnings.push(`${rule.path}: Rule content is very short (${bodyContent.length} chars)`);
+    }
+    // Check for imperative style
+    const sentences = bodyContent.split(/[.!]\s+/);
+    let nonImperativeCount = 0;
+    for (const sentence of sentences) {
+        const trimmed = sentence.trim();
+        if (trimmed.length > 10) {
+            // Check for non-imperative patterns
+            if (/^(you should|you must|we should|it is|there are|this is)/i.test(trimmed)) {
+                nonImperativeCount++;
+            }
+        }
+    }
+    if (nonImperativeCount > 2) {
+        suggestions.push(`${rule.path}: Consider using more imperative style (e.g., "Use X" instead of "You should use X")`);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        suggestions,
+    };
+}
+/**
+ * Parse YAML frontmatter from content
+ */
+function parseFrontmatter(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match)
+        return null;
+    try {
+        const yaml = match[1];
+        const frontmatter = {};
+        // Simple YAML parser for frontmatter
+        const lines = yaml.split('\n');
+        let currentKey = null;
+        let inArray = false;
+        let arrayValues = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('- ') && inArray && currentKey) {
+                // Array item
+                const value = trimmed.slice(2).trim().replace(/^["']|["']$/g, '');
+                arrayValues.push(value);
+            }
+            else if (trimmed.includes(':')) {
+                // Save previous array if exists
+                if (inArray && currentKey && arrayValues.length > 0) {
+                    frontmatter[currentKey] = arrayValues;
+                    arrayValues = [];
+                    inArray = false;
+                }
+                const colonIndex = trimmed.indexOf(':');
+                const key = trimmed.slice(0, colonIndex).trim();
+                const value = trimmed.slice(colonIndex + 1).trim();
+                if (value === '' || value === '|' || value === '>') {
+                    // Start of array or multiline
+                    currentKey = key;
+                    inArray = true;
+                    arrayValues = [];
+                }
+                else {
+                    // Simple value
+                    currentKey = key;
+                    let parsedValue = value.replace(/^["']|["']$/g, '');
+                    // Parse numbers and booleans
+                    if (parsedValue === 'true')
+                        parsedValue = true;
+                    else if (parsedValue === 'false')
+                        parsedValue = false;
+                    else if (/^\d+$/.test(parsedValue))
+                        parsedValue = parseInt(parsedValue, 10);
+                    frontmatter[key] = parsedValue;
+                    inArray = false;
+                }
+            }
+        }
+        // Save final array if exists
+        if (inArray && currentKey && arrayValues.length > 0) {
+            frontmatter[currentKey] = arrayValues;
+        }
+        return frontmatter;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Validate a glob pattern
+ */
+function validateGlobPattern(pattern, _projectRoot) {
+    // Check for common glob syntax errors
+    if (pattern.includes('[') && !pattern.includes(']')) {
+        return { valid: false, reason: 'Unclosed bracket' };
+    }
+    if (pattern.includes('{') && !pattern.includes('}')) {
+        return { valid: false, reason: 'Unclosed brace' };
+    }
+    // Check for overly broad patterns
+    if (pattern === '**' || pattern === '**/*') {
+        return { valid: true, warning: 'Pattern matches all files - consider being more specific' };
+    }
+    // Check for common mistakes
+    if (pattern.includes('***')) {
+        return { valid: false, reason: 'Invalid glob: ***' };
+    }
+    // Check for missing ** in deep patterns
+    if (/^[^*]+\/\*\.[a-z]+$/.test(pattern) && !pattern.includes('**')) {
+        return {
+            valid: true,
+            warning: `Pattern '${pattern}' only matches one level - use ** for recursive matching`,
+        };
+    }
+    // Validate by trying to compile the pattern
+    try {
+        // Use os.tmpdir() for cross-platform compatibility (Windows support)
+        fast_glob_1.default.sync(pattern, { cwd: os.tmpdir(), onlyFiles: true });
+        return { valid: true };
+    }
+    catch {
+        return { valid: false, reason: 'Invalid glob syntax' };
+    }
+}
+/**
+ * Extract @file references from content
+ */
+function extractFileReferences(content) {
+    const refs = [];
+    const regex = /@([a-zA-Z0-9_\-./]+)/g;
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+        // Filter out common false positives
+        const ref = match[1];
+        if (!ref.includes('@') && !ref.startsWith('param') && !ref.startsWith('returns')) {
+            refs.push(ref);
+        }
+    }
+    return refs;
+}
+/**
+ * Extract markdown links from content
+ */
+function extractMarkdownLinks(content) {
+    const links = [];
+    // [text](url) style links
+    const linkRegex = /\[([^\]]*)\]\(([^)]+)\)/g;
+    let match;
+    while ((match = linkRegex.exec(content)) !== null) {
+        links.push(match[2]);
+    }
+    return links;
+}
+/**
+ * Check for best practices in generated content
+ */
+function checkBestPractices(output, analysis) {
+    const warnings = [];
+    const suggestions = [];
+    // Check rule coverage
+    const hasProjectIdentity = output.rules.some((r) => r.path.includes('project-identity') || r.content.includes('mission'));
+    if (!hasProjectIdentity) {
+        suggestions.push('Consider adding a project-identity rule with mission and tech stack');
+    }
+    const hasArchitectureMap = output.rules.some((r) => r.path.includes('architecture') || r.path.includes('structure'));
+    if (!hasArchitectureMap) {
+        suggestions.push('Consider adding an architecture-map rule with directory purposes');
+    }
+    const hasCommands = output.rules.some((r) => r.path.includes('command') || r.content.includes('npm run') || r.content.includes('yarn'));
+    if (!hasCommands && analysis.packageInfo?.scripts) {
+        suggestions.push('Consider adding a commands rule with available npm scripts');
+    }
+    // Check for language-specific rules
+    const primaryLanguages = analysis.languages.slice(0, 2).map((l) => l.name.toLowerCase());
+    for (const lang of primaryLanguages) {
+        const hasLangRule = output.rules.some((r) => r.path.toLowerCase().includes(lang) || r.content.toLowerCase().includes(`${lang} patterns`));
+        if (!hasLangRule) {
+            suggestions.push(`Consider adding ${lang}-specific coding patterns rule`);
+        }
+    }
+    // Check total rule count
+    if (output.rules.length < 3) {
+        warnings.push('Very few rules generated - consider adding more specific guidance');
+    }
+    else if (output.rules.length > 20) {
+        warnings.push('Many rules generated - LLMs may struggle with too many instructions');
+    }
+    // Check for token efficiency
+    const totalContent = (output.projectMd || '').length +
+        (output.architectureMd || '').length +
+        output.rules.reduce((sum, r) => sum + r.content.length, 0);
+    if (totalContent > 50000) {
+        warnings.push(`Total content is ${Math.round(totalContent / 1000)}KB - consider condensing for token efficiency`);
+    }
+    // Check for duplicate content
+    const ruleContents = output.rules.map((r) => r.content.toLowerCase());
+    for (let i = 0; i < ruleContents.length; i++) {
+        for (let j = i + 1; j < ruleContents.length; j++) {
+            const similarity = calculateSimilarity(ruleContents[i], ruleContents[j]);
+            if (similarity > 0.7) {
+                warnings.push(`Rules '${output.rules[i].path}' and '${output.rules[j].path}' have similar content (${Math.round(similarity * 100)}%)`);
+            }
+        }
+    }
+    return { warnings, suggestions };
+}
+/**
+ * Calculate simple similarity between two strings
+ */
+function calculateSimilarity(a, b) {
+    const wordsA = new Set(a.split(/\s+/).filter((w) => w.length > 3));
+    const wordsB = new Set(b.split(/\s+/).filter((w) => w.length > 3));
+    if (wordsA.size === 0 || wordsB.size === 0)
+        return 0;
+    const intersection = new Set([...wordsA].filter((w) => wordsB.has(w)));
+    const union = new Set([...wordsA, ...wordsB]);
+    return intersection.size / union.size;
+}
+//# sourceMappingURL=validator.js.map

package/dist/bootstrap/validator.js.map

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

package/dist/build/atomic.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Atomic File Operations
+ *
+ * Provides safe file writing with:
+ * - Temp file → atomic rename pattern
+ * - Multi-file transactions (all-or-nothing)
+ * - Cleanup on error
+ */
+/**
+ * Pending file write in a transaction
+ */
+export interface PendingWrite {
+    /** Target file path */
+    targetPath: string;
+    /** Content to write */
+    content: string;
+    /** Temp file path (set during write) */
+    tempPath?: string;
+}
+/**
+ * Transaction result
+ */
+export interface TransactionResult {
+    /** Whether all files were written successfully */
+    success: boolean;
+    /** Files that were successfully written */
+    writtenFiles: string[];
+    /** Errors encountered */
+    errors: Array<{
+        path: string;
+        error: Error;
+    }>;
+}
+/**
+ * Generate temp file path for atomic write
+ *
+ * @param targetPath - Target file path
+ * @returns Temp file path with pid suffix
+ */
+export declare function getTempPath(targetPath: string): string;
+/**
+ * Write file atomically using temp file + rename
+ *
+ * @param targetPath - Target file path
+ * @param content - Content to write
+ * @throws Error if write or rename fails
+ */
+export declare function atomicWrite(targetPath: string, content: string): Promise<void>;
+/**
+ * Write file atomically (synchronous version)
+ *
+ * @param targetPath - Target file path
+ * @param content - Content to write
+ * @throws Error if write or rename fails
+ */
+export declare function atomicWriteSync(targetPath: string, content: string): void;
+/**
+ * Execute a multi-file transaction (all-or-nothing)
+ *
+ * If any file fails to write, all temp files are cleaned up
+ * and no target files are modified.
+ *
+ * @param writes - Array of pending writes
+ * @returns Transaction result
+ */
+export declare function transaction(writes: PendingWrite[]): Promise<TransactionResult>;
+/**
+ * Cleanup stale temp files from a previous crashed build
+ *
+ * @param directory - Directory to scan for temp files
+ * @param pattern - Pattern to match temp files (default: *.tmp.*)
+ */
+export declare function cleanupStaleTempFiles(directory: string, pattern?: RegExp): Promise<string[]>;
+//# sourceMappingURL=atomic.d.ts.map

package/dist/build/atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.d.ts","sourceRoot":"","sources":["../../src/build/atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yBAAyB;IACzB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAsBzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmEpF;AAiBD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,MAAsB,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB"}