@blockspool/cli 0.4.1 → 0.4.3

package/dist/lib/formulas.js

@@ -0,0 +1,295 @@
+/**
+ * Formulas - User-defined repeatable sweep recipes
+ *
+ * A formula is a YAML config that defines what an auto run should
+ * look for and how to fix it. Formulas live in .blockspool/formulas/
+ * and can be invoked with --formula <name>.
+ *
+ * Example:
+ *   blockspool solo auto --formula security-audit
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// =============================================================================
+// Built-in Formulas
+// =============================================================================
+export const BUILTIN_FORMULAS = [
+    {
+        name: 'security-audit',
+        description: 'Find and fix security vulnerabilities',
+        categories: ['security'],
+        minConfidence: 80,
+        prompt: [
+            'Look for OWASP Top 10 vulnerabilities, insecure defaults,',
+            'missing input validation, credential exposure, and injection risks.',
+            'Focus on real vulnerabilities, not style issues.',
+        ].join(' '),
+        maxPrs: 10,
+        tags: ['security'],
+    },
+    {
+        name: 'test-coverage',
+        description: 'Add missing unit tests for untested code',
+        categories: ['test'],
+        minConfidence: 70,
+        prompt: [
+            'Find functions and modules with no test coverage.',
+            'Write focused unit tests with edge cases.',
+            'Prioritize business logic over utility functions.',
+        ].join(' '),
+        maxPrs: 15,
+        tags: ['quality'],
+    },
+    {
+        name: 'type-safety',
+        description: 'Strengthen TypeScript types and remove any/unknown',
+        categories: ['types'],
+        minConfidence: 75,
+        prompt: [
+            'Find uses of any, unknown, or weak typing.',
+            'Add proper type annotations, interfaces, and type guards.',
+            'Do not change runtime behavior.',
+        ].join(' '),
+        maxPrs: 10,
+        tags: ['quality'],
+    },
+    {
+        name: 'cleanup',
+        description: 'Remove dead code, unused imports, and stale comments',
+        categories: ['refactor'],
+        minConfidence: 85,
+        prompt: [
+            'Find dead code, unused imports, unreachable branches,',
+            'commented-out code, and stale TODO comments.',
+            'Only remove things that are clearly unused.',
+        ].join(' '),
+        maxPrs: 10,
+        tags: ['cleanup'],
+    },
+    {
+        name: 'deep',
+        description: 'Find high-impact structural and architectural improvements',
+        categories: ['refactor', 'perf', 'security'],
+        minConfidence: 60,
+        model: 'opus',
+        maxPrs: 5,
+        prompt: [
+            'Principal engineer architecture review. Ignore trivial issues.',
+            'Focus on: leaky abstractions, silent error swallowing, coupling/circular deps,',
+            'mixed concerns (business logic + I/O), algorithmic perf issues,',
+            'missing security boundaries, brittle integration points.',
+            'Prefer moderate/complex complexity. Set impact_score 1-10.',
+        ].join(' '),
+        tags: ['architecture', 'deep'],
+    },
+    {
+        name: 'docs',
+        description: 'Add or improve documentation for public APIs',
+        categories: ['docs'],
+        minConfidence: 70,
+        prompt: [
+            'Find exported functions, classes, and types missing JSDoc.',
+            'Add clear, concise documentation that explains the purpose,',
+            'parameters, and return values. Do not over-document obvious code.',
+        ].join(' '),
+        maxPrs: 10,
+        tags: ['docs'],
+    },
+    {
+        name: 'docs-audit',
+        description: 'Find stale, inaccurate, or missing documentation across code and markdown',
+        scope: '.',
+        categories: ['docs'],
+        minConfidence: 70,
+        exclude: ['CLAUDE.md', '.claude/**'],
+        prompt: [
+            'Cross-reference documentation files (README.md, CLAUDE.md, docs/*.md, CONTRIBUTING.md)',
+            'against the actual codebase to find inaccuracies.',
+            'Look for: CLI flags/options documented that no longer exist or have changed,',
+            'features described that have been renamed or removed,',
+            'setup instructions that reference old paths or commands,',
+            'outdated architecture descriptions that no longer match the code,',
+            'missing documentation for recently added features or flags.',
+            'Read both the markdown files AND the source code they reference to verify accuracy.',
+            'Each proposal should fix one specific doc file with concrete corrections.',
+            'Do NOT add new documentation — only fix what is wrong or outdated.',
+        ].join(' '),
+        maxPrs: 10,
+        tags: ['docs', 'audit'],
+    },
+];
+// =============================================================================
+// Formula Loader
+// =============================================================================
+/**
+ * Load a formula by name.
+ *
+ * Search order:
+ * 1. .blockspool/formulas/<name>.yaml (or .yml)
+ * 2. Built-in formulas
+ *
+ * @returns The formula, or null if not found
+ */
+export function loadFormula(name, repoPath) {
+    // Try user-defined formulas first
+    const userFormula = loadUserFormula(name, repoPath);
+    if (userFormula)
+        return userFormula;
+    // Fall back to built-in formulas
+    return BUILTIN_FORMULAS.find(f => f.name === name) ?? null;
+}
+/**
+ * List all available formulas (built-in + user-defined)
+ */
+export function listFormulas(repoPath) {
+    const userFormulas = loadAllUserFormulas(repoPath);
+    // User formulas override built-in ones with the same name
+    const userNames = new Set(userFormulas.map(f => f.name));
+    const builtins = BUILTIN_FORMULAS.filter(f => !userNames.has(f.name));
+    return [...userFormulas, ...builtins];
+}
+/**
+ * Load a user-defined formula from .blockspool/formulas/
+ */
+function loadUserFormula(name, repoPath) {
+    const dir = getFormulasDir(repoPath);
+    if (!dir)
+        return null;
+    for (const ext of ['.yaml', '.yml']) {
+        const filePath = path.join(dir, `${name}${ext}`);
+        if (fs.existsSync(filePath)) {
+            return parseFormulaFile(filePath, name);
+        }
+    }
+    return null;
+}
+/**
+ * Load all user-defined formulas
+ */
+function loadAllUserFormulas(repoPath) {
+    const dir = getFormulasDir(repoPath);
+    if (!dir || !fs.existsSync(dir))
+        return [];
+    const files = fs.readdirSync(dir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+    const formulas = [];
+    for (const file of files) {
+        const name = path.basename(file, path.extname(file));
+        const formula = parseFormulaFile(path.join(dir, file), name);
+        if (formula)
+            formulas.push(formula);
+    }
+    return formulas;
+}
+/**
+ * Get the formulas directory path
+ */
+function getFormulasDir(repoPath) {
+    const base = repoPath || process.cwd();
+    return path.join(base, '.blockspool', 'formulas');
+}
+/**
+ * Parse a YAML formula file.
+ * Uses a simple key: value parser to avoid adding a YAML dependency.
+ */
+function parseFormulaFile(filePath, name) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const parsed = parseSimpleYaml(content);
+        return {
+            name,
+            description: parsed.description || `Formula: ${name}`,
+            scope: parsed.scope,
+            categories: parsed.categories ? parseStringList(parsed.categories) : undefined,
+            minConfidence: parsed.min_confidence ? parseInt(parsed.min_confidence, 10) : undefined,
+            prompt: parsed.prompt,
+            maxPrs: parsed.max_prs ? parseInt(parsed.max_prs, 10) : undefined,
+            maxTime: parsed.max_time,
+            focusAreas: parsed.focus_areas ? parseStringList(parsed.focus_areas) : undefined,
+            exclude: parsed.exclude ? parseStringList(parsed.exclude) : undefined,
+            useRoadmap: parsed.use_roadmap !== undefined ? parsed.use_roadmap === 'true' : undefined,
+            tags: parsed.tags ? parseStringList(parsed.tags) : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Simple YAML-like parser for flat key: value files.
+ * Handles single-line values and multi-line | blocks.
+ * Does NOT handle nested objects, anchors, or complex YAML features.
+ */
+function parseSimpleYaml(content) {
+    const result = {};
+    const lines = content.split('\n');
+    let currentKey = null;
+    let multilineValue = [];
+    let multilineIndent = 0;
+    for (const line of lines) {
+        // Skip comments and empty lines (unless in multiline)
+        if (!currentKey && (line.trim().startsWith('#') || line.trim() === ''))
+            continue;
+        // Check for multiline continuation
+        if (currentKey) {
+            const indent = line.length - line.trimStart().length;
+            if (indent > multilineIndent && line.trim() !== '') {
+                multilineValue.push(line.trim());
+                continue;
+            }
+            else {
+                // End of multiline block
+                result[currentKey] = multilineValue.join(' ');
+                currentKey = null;
+                multilineValue = [];
+            }
+        }
+        // Parse key: value
+        const match = line.match(/^(\w[\w_-]*)\s*:\s*(.*)/);
+        if (match) {
+            const [, key, value] = match;
+            const trimmedValue = value.trim();
+            if (trimmedValue === '|' || trimmedValue === '>') {
+                // Start multiline block
+                currentKey = key;
+                multilineIndent = line.length - line.trimStart().length;
+                multilineValue = [];
+            }
+            else {
+                result[key] = trimmedValue;
+            }
+        }
+    }
+    // Flush remaining multiline
+    if (currentKey) {
+        result[currentKey] = multilineValue.join(' ');
+    }
+    return result;
+}
+/**
+ * Parse a YAML-style list string: "[a, b, c]" or "a, b, c" -> ["a", "b", "c"]
+ */
+function parseStringList(value) {
+    // Handle YAML array syntax: [a, b, c]
+    const stripped = value.replace(/^\[/, '').replace(/\]$/, '');
+    return stripped.split(',').map(s => s.trim()).filter(s => s.length > 0);
+}
+/**
+ * Apply a formula's settings to auto options.
+ * Formula values override defaults but CLI flags take precedence.
+ */
+export function applyFormula(formula, cliOptions) {
+    return {
+        // CLI flags override formula values
+        scope: cliOptions.scope || formula.scope || 'src',
+        types: cliOptions.types || formula.categories,
+        minConfidence: cliOptions.minConfidence ?? formula.minConfidence,
+        maxPrs: cliOptions.maxPrs ?? formula.maxPrs,
+        maxTime: cliOptions.maxTime || formula.maxTime,
+        exclude: cliOptions.exclude || formula.exclude,
+        noRoadmap: cliOptions.noRoadmap ?? (formula.useRoadmap === false ? true : undefined),
+        // Formula-only fields (no CLI override)
+        prompt: formula.prompt,
+        focusAreas: formula.focusAreas,
+    };
+}
+//# sourceMappingURL=formulas.js.map

package/dist/lib/formulas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formulas.js","sourceRoot":"","sources":["../../src/lib/formulas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAgDlC,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,uCAAuC;QACpD,UAAU,EAAE,CAAC,UAA8B,CAAC;QAC5C,aAAa,EAAE,EAAE;QACjB,MAAM,EAAE;YACN,2DAA2D;YAC3D,qEAAqE;YACrE,kDAAkD;SACnD,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,CAAC,UAAU,CAAC;KACnB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,0CAA0C;QACvD,UAAU,EAAE,CAAC,MAA0B,CAAC;QACxC,aAAa,EAAE,EAAE;QACjB,MAAM,EAAE;YACN,mDAAmD;YACnD,2CAA2C;YAC3C,mDAAmD;SACpD,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,CAAC,SAAS,CAAC;KAClB;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,oDAAoD;QACjE,UAAU,EAAE,CAAC,OAA2B,CAAC;QACzC,aAAa,EAAE,EAAE;QACjB,MAAM,EAAE;YACN,4CAA4C;YAC5C,2DAA2D;YAC3D,iCAAiC;SAClC,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,CAAC,SAAS,CAAC;KAClB;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sDAAsD;QACnE,UAAU,EAAE,CAAC,UAA8B,CAAC;QAC5C,aAAa,EAAE,EAAE;QACjB,MAAM,EAAE;YACN,uDAAuD;YACvD,8CAA8C;YAC9C,6CAA6C;SAC9C,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,CAAC,SAAS,CAAC;KAClB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,4DAA4D;QACzE,UAAU,EAAE,CAAC,UAA8B,EAAE,MAA0B,EAAE,UAA8B,CAAC;QACxG,aAAa,EAAE,EAAE;QACjB,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,CAAC;QACT,MAAM,EAAE;YACN,gEAAgE;YAChE,gFAAgF;YAChF,iEAAiE;YACjE,0DAA0D;YAC1D,4DAA4D;SAC7D,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,IAAI,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC;KAC/B;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,8CAA8C;QAC3D,UAAU,EAAE,CAAC,MAA0B,CAAC;QACxC,aAAa,EAAE,EAAE;QACjB,MAAM,EAAE;YACN,4DAA4D;YAC5D,6DAA6D;YAC7D,mEAAmE;SACpE,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,CAAC,MAAM,CAAC;KACf;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,2EAA2E;QACxF,KAAK,EAAE,GAAG;QACV,UAAU,EAAE,CAAC,MAA0B,CAAC;QACxC,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;QACpC,MAAM,EAAE;YACN,wFAAwF;YACxF,mDAAmD;YACnD,8EAA8E;YAC9E,uDAAuD;YACvD,0DAA0D;YAC1D,mEAAmE;YACnE,6DAA6D;YAC7D,qFAAqF;YACrF,2EAA2E;YAC3E,oEAAoE;SACrE,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KACxB;CACF,CAAC;AAEF,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,QAAiB;IACzD,kCAAkC;IAClC,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACpD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,iCAAiC;IACjC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAiB;IAC5C,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAEnD,0DAA0D;IAC1D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEtE,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,QAAiB;IACtD,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;QACjD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,QAAiB;IAC5C,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3C,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACzF,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAC7D,IAAI,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,QAAiB;IACvC,MAAM,IAAI,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,QAAgB,EAAE,IAAY;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAExC,OAAO;YACL,IAAI;YACJ,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,YAAY,IAAI,EAAE;YACrD,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAuB,CAAC,CAAC,CAAC,SAAS;YACpG,aAAa,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YACtF,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YACjE,OAAO,EAAE,MAAM,CAAC,QAAQ;YACxB,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;YAChF,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YACrE,UAAU,EAAE,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS;YACxF,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC7D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,cAAc,GAAa,EAAE,CAAC;IAClC,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,sDAAsD;QACtD,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YAAE,SAAS;QAEjF,mCAAmC;QACnC,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;YACrD,IAAI,MAAM,GAAG,eAAe,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACnD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjC,SAAS;YACX,CAAC;iBAAM,CAAC;gBACN,yBAAyB;gBACzB,MAAM,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC9C,UAAU,GAAG,IAAI,CAAC;gBAClB,cAAc,GAAG,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACpD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;YAC7B,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAElC,IAAI,YAAY,KAAK,GAAG,IAAI,YAAY,KAAK,GAAG,EAAE,CAAC;gBACjD,wBAAwB;gBACxB,UAAU,GAAG,GAAG,CAAC;gBACjB,eAAe,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;gBACxD,cAAc,GAAG,EAAE,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,KAAa;IACpC,sCAAsC;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7D,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,UAQC;IAYD,OAAO;QACL,oCAAoC;QACpC,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,KAAK;QACjD,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,OAAO,CAAC,UAAU;QAC7C,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa;QAChE,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;QAC3C,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO;QAC9C,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO;QAC9C,SAAS,EAAE,UAAU,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,wCAAwC;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC"}

package/dist/lib/git.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Git service implementation for CLI
+ */
+import type { GitService } from '@blockspool/core/services';
+/**
+ * Create a GitService instance
+ */
+export declare function createGitService(): GitService;
+//# sourceMappingURL=git.d.ts.map

package/dist/lib/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAmD5D;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAM7C"}

package/dist/lib/git.js

@@ -0,0 +1,60 @@
+/**
+ * Git service implementation for CLI
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+/**
+ * Find git repository root from a path
+ */
+async function findRepoRoot(startPath) {
+    let current = path.resolve(startPath);
+    while (current !== path.dirname(current)) {
+        if (fs.existsSync(path.join(current, '.git'))) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    return null;
+}
+/**
+ * Get remote URL from git
+ */
+async function getRemoteUrl(repoRoot) {
+    try {
+        const url = execSync('git remote get-url origin', {
+            cwd: repoRoot,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return url || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Generate deterministic project ID from repo
+ */
+function getProjectId(repoRoot, remoteUrl) {
+    const source = remoteUrl || repoRoot;
+    // Simple hash for deterministic ID
+    let hash = 0;
+    for (let i = 0; i < source.length; i++) {
+        const char = source.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    return `proj_${Math.abs(hash).toString(36)}`;
+}
+/**
+ * Create a GitService instance
+ */
+export function createGitService() {
+    return {
+        findRepoRoot,
+        getRemoteUrl,
+        getProjectId,
+    };
+}
+//# sourceMappingURL=git.js.map

package/dist/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,SAAiB;IAC3C,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtC,OAAO,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,2BAA2B,EAAE;YAChD,GAAG,EAAE,QAAQ;YACb,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,IAAI,IAAI,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,QAAgB,EAAE,SAAwB;IAC9D,MAAM,MAAM,GAAG,SAAS,IAAI,QAAQ,CAAC;IAErC,mCAAmC;IACnC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACnC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,2BAA2B;IACjD,CAAC;IAED,OAAO,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,YAAY;QACZ,YAAY;QACZ,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/lib/guidelines.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Project guidelines loader — loads CLAUDE.md or AGENTS.md for prompt injection.
+ *
+ * For Claude-based runs: searches for CLAUDE.md
+ * For Codex-based runs: searches for AGENTS.md
+ * Falls back to whichever exists if the preferred one is missing.
+ */
+/**
+ * Loaded project guidelines with metadata.
+ */
+export interface ProjectGuidelines {
+    content: string;
+    source: string;
+    loadedAt: number;
+}
+export type GuidelinesBackend = 'claude' | 'codex';
+export interface GuidelinesOptions {
+    /** Which backend is running. Determines default file search order. */
+    backend?: GuidelinesBackend;
+    /** Auto-create baseline file if none found. */
+    autoCreate?: boolean;
+    /**
+     * Custom path (relative to repoRoot) to the guidelines file.
+     * Overrides the default CLAUDE.md / AGENTS.md search.
+     * Set to false to disable guidelines entirely.
+     */
+    customPath?: string | false | null;
+}
+/**
+ * Load project guidelines.
+ *
+ * Resolution order:
+ * 1. If customPath is false → disabled, return null
+ * 2. If customPath is a string → use that exact file
+ * 3. Otherwise → search default paths by backend (primary then fallback)
+ * 4. If nothing found and autoCreate → generate baseline
+ */
+export declare function loadGuidelines(repoRoot: string, opts?: GuidelinesOptions): ProjectGuidelines | null;
+/**
+ * Wrap guidelines in XML tags for prompt injection.
+ */
+export declare function formatGuidelinesForPrompt(guidelines: ProjectGuidelines): string;
+//# sourceMappingURL=guidelines.d.ts.map

package/dist/lib/guidelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidelines.d.ts","sourceRoot":"","sources":["../../src/lib/guidelines.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAYnD,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,iBAAiB,GAAG,IAAI,CAwB1B;AAkCD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAO/E"}

package/dist/lib/guidelines.js

@@ -0,0 +1,195 @@
+/**
+ * Project guidelines loader — loads CLAUDE.md or AGENTS.md for prompt injection.
+ *
+ * For Claude-based runs: searches for CLAUDE.md
+ * For Codex-based runs: searches for AGENTS.md
+ * Falls back to whichever exists if the preferred one is missing.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Search paths by backend, in priority order.
+ * Primary search uses the backend-appropriate file, fallback uses the other.
+ */
+const CLAUDE_PATHS = ['CLAUDE.md'];
+const CODEX_PATHS = ['AGENTS.md'];
+const MAX_CHARS = 4000;
+/**
+ * Load project guidelines.
+ *
+ * Resolution order:
+ * 1. If customPath is false → disabled, return null
+ * 2. If customPath is a string → use that exact file
+ * 3. Otherwise → search default paths by backend (primary then fallback)
+ * 4. If nothing found and autoCreate → generate baseline
+ */
+export function loadGuidelines(repoRoot, opts = {}) {
+    const { backend = 'claude', autoCreate = false, customPath } = opts;
+    // Explicitly disabled
+    if (customPath === false)
+        return null;
+    // Custom path — single file, no fallback
+    if (typeof customPath === 'string') {
+        return readGuidelinesFile(repoRoot, customPath);
+    }
+    // Default search: primary paths then fallback
+    const primaryPaths = backend === 'codex' ? CODEX_PATHS : CLAUDE_PATHS;
+    const fallbackPaths = backend === 'codex' ? CLAUDE_PATHS : CODEX_PATHS;
+    const result = searchPaths(repoRoot, primaryPaths) ?? searchPaths(repoRoot, fallbackPaths);
+    if (result)
+        return result;
+    // Nothing found — auto-create if enabled
+    if (autoCreate) {
+        return createBaselineGuidelines(repoRoot, backend);
+    }
+    return null;
+}
+function readGuidelinesFile(repoRoot, rel) {
+    const full = path.join(repoRoot, rel);
+    if (!fs.existsSync(full))
+        return null;
+    try {
+        let content = fs.readFileSync(full, 'utf-8');
+        if (content.length > MAX_CHARS) {
+            content = content.slice(0, MAX_CHARS) + '\n\n[truncated]';
+        }
+        return { content, source: rel, loadedAt: Date.now() };
+    }
+    catch {
+        return null;
+    }
+}
+function searchPaths(repoRoot, paths) {
+    for (const rel of paths) {
+        const full = path.join(repoRoot, rel);
+        if (fs.existsSync(full)) {
+            try {
+                let content = fs.readFileSync(full, 'utf-8');
+                if (content.length > MAX_CHARS) {
+                    content = content.slice(0, MAX_CHARS) + '\n\n[truncated]';
+                }
+                return { content, source: rel, loadedAt: Date.now() };
+            }
+            catch {
+                // Unreadable — skip
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Wrap guidelines in XML tags for prompt injection.
+ */
+export function formatGuidelinesForPrompt(guidelines) {
+    return [
+        '<project-guidelines>',
+        `<!-- Source: ${guidelines.source} -->`,
+        guidelines.content,
+        '</project-guidelines>',
+    ].join('\n');
+}
+/**
+ * Generate a baseline guidelines file from project metadata.
+ * Writes AGENTS.md for codex, CLAUDE.md for claude.
+ * Returns the loaded guidelines, or null if creation fails.
+ */
+function createBaselineGuidelines(repoRoot, backend) {
+    const filename = backend === 'codex' ? 'AGENTS.md' : 'CLAUDE.md';
+    const fullPath = path.join(repoRoot, filename);
+    // Don't overwrite existing files
+    if (fs.existsSync(fullPath))
+        return null;
+    const content = generateBaseline(repoRoot, backend);
+    try {
+        fs.writeFileSync(fullPath, content, 'utf-8');
+        return { content, source: filename, loadedAt: Date.now() };
+    }
+    catch {
+        // Can't write — not fatal
+        return null;
+    }
+}
+/**
+ * Build baseline guidelines content from project metadata.
+ */
+function generateBaseline(repoRoot, backend) {
+    const projectName = path.basename(repoRoot);
+    const parts = [];
+    parts.push(`# ${projectName}`);
+    parts.push('');
+    // Detect project type from package.json
+    let description = '';
+    let hasTypeScript = false;
+    let testCmd = '';
+    let lintCmd = '';
+    let buildCmd = '';
+    const scripts = {};
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(repoRoot, 'package.json'), 'utf-8'));
+        description = pkg.description || '';
+        Object.assign(scripts, pkg.scripts || {});
+        hasTypeScript = !!(pkg.devDependencies?.typescript ||
+            pkg.dependencies?.typescript);
+        if (scripts.test)
+            testCmd = `npm test`;
+        if (scripts.lint)
+            lintCmd = `npm run lint`;
+        if (scripts.typecheck || scripts['type-check']) {
+            lintCmd = lintCmd ? `${lintCmd} && npm run typecheck` : 'npm run typecheck';
+        }
+        if (scripts.build)
+            buildCmd = `npm run build`;
+    }
+    catch {
+        // No package.json — keep defaults
+    }
+    if (description) {
+        parts.push(description);
+        parts.push('');
+    }
+    // Conventions section
+    parts.push('## Conventions');
+    parts.push('');
+    if (hasTypeScript) {
+        parts.push('- This project uses TypeScript. Prefer strict types over `any`.');
+    }
+    parts.push('- Keep changes minimal and focused on the task at hand.');
+    parts.push('- Follow existing code style and patterns in the codebase.');
+    parts.push('- Do not introduce new dependencies without justification.');
+    parts.push('');
+    // Verification section
+    const verifyCommands = [];
+    if (lintCmd)
+        verifyCommands.push(lintCmd);
+    if (testCmd)
+        verifyCommands.push(testCmd);
+    if (buildCmd)
+        verifyCommands.push(buildCmd);
+    if (verifyCommands.length > 0) {
+        parts.push('## Verification');
+        parts.push('');
+        parts.push('After making changes, verify with:');
+        parts.push('');
+        for (const cmd of verifyCommands) {
+            parts.push(`\`\`\`bash`);
+            parts.push(cmd);
+            parts.push(`\`\`\``);
+        }
+        parts.push('');
+    }
+    // Detect monorepo
+    const hasWorkspaces = !!scripts['workspaces'] ||
+        fs.existsSync(path.join(repoRoot, 'pnpm-workspace.yaml')) ||
+        fs.existsSync(path.join(repoRoot, 'lerna.json'));
+    if (hasWorkspaces || fs.existsSync(path.join(repoRoot, 'packages'))) {
+        parts.push('## Structure');
+        parts.push('');
+        parts.push('This is a monorepo. When modifying code in one package, check for cross-package impacts.');
+        parts.push('');
+    }
+    const header = backend === 'codex'
+        ? '<!-- Generated by BlockSpool. Edit freely to customize agent behavior. -->'
+        : '<!-- Generated by BlockSpool. Edit freely to customize agent behavior. -->';
+    return header + '\n\n' + parts.join('\n');
+}
+//# sourceMappingURL=guidelines.js.map

package/dist/lib/guidelines.js.map

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

package/dist/lib/logger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Logger implementation for CLI
+ */
+import type { Logger } from '@blockspool/core/services';
+export interface LoggerOptions {
+    verbose?: boolean;
+    quiet?: boolean;
+}
+/**
+ * Create a logger instance
+ */
+export declare function createLogger(opts?: LoggerOptions): Logger;
+/**
+ * Silent logger (for tests or quiet mode)
+ */
+export declare const silentLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,aAAkB,GAAG,MAAM,CA4B7D;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAK1B,CAAC"}