lacuna-cli 0.1.1

package/dist/lib/worker-display.js

@@ -0,0 +1,168 @@
+import chalk from 'chalk';
+const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const ACTIVE = new Set(['generating', 'writing', 'running', 'retrying']);
+// tip rotates every ~5 seconds at 80ms tick interval
+const TIP_TICKS = 62;
+export class WorkerDisplay {
+    states;
+    done = 0;
+    passed = 0;
+    failedCount = 0;
+    total;
+    rendered = 0;
+    tick = 0;
+    timer = null;
+    isTTY;
+    tips;
+    tipIndex = 0;
+    successLabel;
+    constructor(workerCount, total, tips = [], successLabel = 'passed') {
+        this.states = Array.from({ length: workerCount }, () => ({ phase: 'idle' }));
+        this.total = total;
+        this.isTTY = Boolean(process.stdout.isTTY);
+        this.tips = tips;
+        this.successLabel = successLabel;
+    }
+    start() {
+        if (!this.isTTY)
+            return;
+        this.render();
+        this.timer = setInterval(() => {
+            this.tick++;
+            if (this.tips.length > 0 && this.tick % TIP_TICKS === 0) {
+                this.tipIndex = (this.tipIndex + 1) % this.tips.length;
+            }
+            this.render();
+        }, 80);
+    }
+    update(workerId, state) {
+        const prev = this.states[workerId];
+        this.states[workerId] = state;
+        if (prev.phase !== 'passed' && prev.phase !== 'failed') {
+            if (state.phase === 'passed') {
+                this.done++;
+                this.passed++;
+            }
+            else if (state.phase === 'failed') {
+                this.done++;
+                this.failedCount++;
+            }
+        }
+        if (!this.isTTY) {
+            // fallback: plain log line for CI / piped output
+            const label = this.plainLabel(state);
+            process.stdout.write(`  [w${workerId + 1}] ${label}\n`);
+        }
+    }
+    finish() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (this.isTTY && this.rendered > 0) {
+            process.stdout.write(`\x1B[${this.rendered}A\x1B[0J`);
+            this.rendered = 0;
+        }
+    }
+    render() {
+        if (!this.isTTY)
+            return;
+        if (this.rendered > 0) {
+            process.stdout.write(`\x1B[${this.rendered}A\x1B[0J`);
+        }
+        const cols = Math.max(60, process.stdout.columns ?? 80);
+        const lines = [''];
+        for (let i = 0; i < this.states.length; i++) {
+            lines.push(this.formatRow(i, this.states[i], cols));
+        }
+        const barWidth = Math.min(28, cols - 26);
+        const filled = this.total === 0 ? barWidth : Math.round(barWidth * this.done / this.total);
+        const bar = chalk.green('█'.repeat(filled)) + chalk.dim('░'.repeat(barWidth - filled));
+        const pct = this.total === 0 ? 100 : Math.round((this.done / this.total) * 100);
+        const remaining = this.total - this.done;
+        lines.push('');
+        lines.push(`  ${chalk.dim('Progress')}  ${bar}  ${chalk.bold(String(this.done))}${chalk.dim(`/${this.total}`)}  ${chalk.dim(pct + '%')}`);
+        lines.push('');
+        lines.push(`  ` +
+            chalk.green(`✓ ${this.passed} ${this.successLabel}`) +
+            chalk.dim('  ·  ') +
+            (this.failedCount > 0 ? chalk.red(`✗ ${this.failedCount} failed`) : chalk.dim(`✗ 0 failed`)) +
+            chalk.dim('  ·  ') +
+            chalk.dim(`${remaining} remaining`));
+        if (this.tips.length > 0) {
+            const tip = this.tips[this.tipIndex];
+            const maxTipLen = cols - 10;
+            const displayTip = tip.length > maxTipLen ? tip.slice(0, maxTipLen - 1) + '…' : tip;
+            lines.push('');
+            lines.push(`  ${chalk.cyan('Tip:')} ${chalk.dim(displayTip)}`);
+        }
+        lines.push('');
+        const out = lines.join('\n');
+        process.stdout.write(out);
+        this.rendered = (out.match(/\n/g) ?? []).length;
+    }
+    formatRow(id, state, cols) {
+        const wLabel = chalk.dim(`w${id + 1}`.padEnd(2));
+        const frame = FRAMES[this.tick % FRAMES.length];
+        const isActive = ACTIVE.has(state.phase);
+        let icon;
+        let label;
+        let file = '';
+        switch (state.phase) {
+            case 'idle':
+                icon = chalk.dim('○');
+                label = chalk.dim('idle      ');
+                break;
+            case 'generating':
+                icon = chalk.cyan(frame);
+                label = chalk.cyan('generating');
+                file = state.file;
+                break;
+            case 'writing':
+                icon = chalk.blue(frame);
+                label = chalk.blue('writing   ');
+                file = state.file;
+                break;
+            case 'running':
+                icon = chalk.yellow(frame);
+                label = chalk.yellow('running   ');
+                file = state.file;
+                break;
+            case 'retrying':
+                icon = chalk.yellow('↺');
+                label = chalk.yellow(`retry ${state.attempt}/${state.max}  `.slice(0, 10));
+                file = state.file;
+                break;
+            case 'passed':
+                icon = chalk.green('✓');
+                label = chalk.green('passed    ');
+                file = state.file;
+                break;
+            case 'failed':
+                icon = chalk.red('✗');
+                label = chalk.red('failed    ');
+                file = state.file;
+                break;
+        }
+        // fixed prefix width: "  w1  ⠙  generating  " ≈ 22 chars
+        const prefixWidth = 24;
+        const maxFileLen = cols - prefixWidth;
+        const shortFile = file.length > maxFileLen
+            ? '…' + file.slice(-(maxFileLen - 1))
+            : file;
+        void isActive; // used implicitly via frame reference in the switch
+        return `  ${wLabel}  ${icon}  ${label}  ${chalk.dim(shortFile)}`;
+    }
+    plainLabel(state) {
+        switch (state.phase) {
+            case 'idle': return 'idle';
+            case 'generating': return `generating  ${state.file}`;
+            case 'writing': return `writing     ${state.file}`;
+            case 'running': return `running     ${state.file}`;
+            case 'retrying': return `retry ${state.attempt}/${state.max}  ${state.file}`;
+            case 'passed': return `✓ passed    ${state.file}`;
+            case 'failed': return `✗ failed    ${state.file}`;
+        }
+    }
+}
+//# sourceMappingURL=worker-display.js.map

package/dist/lib/worker-display.js.map

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

package/oclif.manifest.json

@@ -0,0 +1,295 @@
+{
+  "commands": {
+    "analyze": {
+      "aliases": [],
+      "args": {},
+      "description": "Analyze test coverage and show gaps — no files are changed",
+      "examples": [
+        "$ lacuna analyze",
+        "$ lacuna analyze --threshold 90",
+        "$ lacuna analyze --format json",
+        "$ lacuna analyze --format markdown"
+      ],
+      "flags": {
+        "threshold": {
+          "char": "t",
+          "description": "Minimum coverage percentage",
+          "name": "threshold",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "char": "F",
+          "description": "Output format",
+          "name": "format",
+          "default": "terminal",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "terminal",
+            "json",
+            "markdown"
+          ],
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Write report to file instead of stdout",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show uncovered line numbers per file",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "analyze",
+      "pluginAlias": "lacuna",
+      "pluginName": "lacuna",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "analyze.js"
+      ]
+    },
+    "fix": {
+      "aliases": [],
+      "args": {},
+      "description": "Find and fix failing tests using AI — preserves existing tests, only repairs what is broken",
+      "examples": [
+        "$ lacuna fix",
+        "$ lacuna fix --workers 4",
+        "$ lacuna fix --file src/utils/math.test.ts",
+        "$ lacuna fix --dry-run"
+      ],
+      "flags": {
+        "dry-run": {
+          "description": "Show what would be changed without writing files",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "file": {
+          "char": "f",
+          "description": "Target a specific test file instead of all failing tests",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show model output and full test runner logs",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "model": {
+          "char": "m",
+          "description": "Model to use (overrides .lacuna.json)",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workers": {
+          "char": "w",
+          "description": "Number of parallel workers (each handles one file at a time)",
+          "name": "workers",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "fresh": {
+          "description": "Re-run the full test suite even if a recent failing-files cache exists",
+          "name": "fresh",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "fix",
+      "pluginAlias": "lacuna",
+      "pluginName": "lacuna",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "fix.js"
+      ]
+    },
+    "generate": {
+      "aliases": [],
+      "args": {},
+      "description": "Run the full agent loop: analyze gaps, generate tests, verify they pass",
+      "examples": [
+        "$ lacuna generate",
+        "$ lacuna generate --dry-run",
+        "$ lacuna generate --file src/utils/math.ts",
+        "$ lacuna generate --format json --output report.json"
+      ],
+      "flags": {
+        "dry-run": {
+          "description": "Print what would be written without touching the filesystem",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "file": {
+          "char": "f",
+          "description": "Target a specific source file instead of the whole project",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show model output and full test runner logs",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "model": {
+          "char": "m",
+          "description": "Model to use (overrides .lacuna.json)",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "threshold": {
+          "char": "t",
+          "description": "Override coverage threshold",
+          "name": "threshold",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "char": "F",
+          "description": "Output format for the final report",
+          "name": "format",
+          "default": "terminal",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "terminal",
+            "json",
+            "markdown"
+          ],
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Write report to file instead of stdout",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workers": {
+          "char": "w",
+          "description": "Number of parallel workers (each handles one file at a time)",
+          "name": "workers",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "fresh": {
+          "description": "Force a fresh coverage run even if a recent report already exists",
+          "name": "fresh",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generate",
+      "pluginAlias": "lacuna",
+      "pluginName": "lacuna",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generate.js"
+      ]
+    },
+    "init": {
+      "aliases": [],
+      "args": {},
+      "description": "Interactive setup wizard — configure lacuna for your project",
+      "examples": [
+        "$ lacuna init"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "init",
+      "pluginAlias": "lacuna",
+      "pluginName": "lacuna",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "init.js"
+      ]
+    },
+    "run": {
+      "aliases": [],
+      "args": {},
+      "description": "Run the test suite and report coverage",
+      "examples": [
+        "$ lacuna run"
+      ],
+      "flags": {
+        "verbose": {
+          "char": "v",
+          "description": "Show full test output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "run",
+      "pluginAlias": "lacuna",
+      "pluginName": "lacuna",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "run.js"
+      ]
+    }
+  },
+  "version": "0.1.0"
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "lacuna-cli",
+  "version": "0.1.1",
+  "description": "Agentic CLI that finds coverage gaps, generates tests, and verifies them in a loop",
+  "keywords": [
+    "testing",
+    "coverage",
+    "ai",
+    "agent",
+    "cli"
+  ],
+  "homepage": "https://octagon-simon.github.io/lacuna/",
+  "license": "MIT",
+  "bin": {
+    "lacuna": "./bin/run.js"
+  },
+  "main": "dist/index.js",
+  "type": "module",
+  "files": [
+    "/bin",
+    "/dist",
+    "/oclif.manifest.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "watch": "tsc -p tsconfig.json --watch",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write 'src/**/*.ts'",
+    "test": "node --loader ts-node/esm --test src/**/*.test.ts",
+    "prepack": "npm run build",
+    "dev": "ts-node --esm src/index.ts"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "@inquirer/prompts": "^8.5.0",
+    "@oclif/core": "^4",
+    "chalk": "^5",
+    "cosmiconfig": "^9",
+    "lcov-parse": "^1",
+    "openai": "^6.39.0",
+    "ora": "^8",
+    "zod": "^3"
+  },
+  "devDependencies": {
+    "@oclif/test": "^4",
+    "@types/node": "^22",
+    "eslint": "^9",
+    "prettier": "^3",
+    "ts-node": "^10",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "oclif": {
+    "bin": "lacuna",
+    "dirname": "lacuna",
+    "commands": "./dist/commands",
+    "plugins": [],
+    "topicSeparator": " "
+  }
+}