sela-core 1.0.0

package/dist/cli/commands/status.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStatus = registerStatus;
+const ConfigLoader_js_1 = require("../../config/ConfigLoader.js");
+const DnaIndexService_js_1 = require("../../services/DnaIndexService.js");
+const HealthReportService_js_1 = require("../../services/HealthReportService.js");
+const ProgressReporter_js_1 = require("../ui/ProgressReporter.js");
+// Compact JSON shape for CI/CD consumers — avoids serialising full DnaRecord arrays.
+function toJsonOutput(report) {
+    const { total, orphaned, recentlyHealed, neverHealed, topHealedFiles } = report;
+    const brokenTotal = orphaned.length + report.unverifiedHeals.length;
+    const brokenRatio = total > 0 ? parseFloat(((brokenTotal / total) * 100).toFixed(2)) : 0;
+    return {
+        generatedAt: report.generatedAt,
+        snapshotDir: report.snapshotDir,
+        stats: {
+            total,
+            orphaned: orphaned.length,
+            unverifiedHeals: report.unverifiedHeals.length,
+            healedLast7Days: recentlyHealed.length,
+            healedAllTime: total - neverHealed.length,
+            neverHealed: neverHealed.length,
+            brokenRatioPct: brokenRatio,
+        },
+        orphanedKeys: orphaned.map((r) => r.key),
+        unverifiedKeys: report.unverifiedHeals.map((r) => r.key),
+        topHealedFiles: topHealedFiles.slice(0, 10),
+    };
+}
+function registerStatus(program) {
+    program
+        .command('status')
+        .description('Show ecosystem health report')
+        .option('--json', 'Emit raw JSON instead of formatted output')
+        .option('--dir <path>', 'Override snapshot directory')
+        .action(async (opts) => {
+        const config = ConfigLoader_js_1.ConfigLoader.getInstance();
+        const snapshotDir = opts.dir ?? config.dnaStoragePath;
+        const progress = new ProgressReporter_js_1.ProgressReporter(opts.json);
+        const dnaIndex = new DnaIndexService_js_1.DnaIndexService();
+        const index = await progress.run('Scanning DNA snapshots…', () => dnaIndex.buildIndex(snapshotDir));
+        const healthSvc = new HealthReportService_js_1.HealthReportService();
+        const report = await progress.run('Generating health report…', async () => healthSvc.generate(index));
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(toJsonOutput(report), null, 2) + '\n');
+        }
+        else {
+            process.stdout.write(healthSvc.format(report));
+        }
+    });
+}

package/dist/cli/commands/sync.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerSyncSource(dna: Command): void;
+//# sourceMappingURL=sync.d.ts.map

package/dist/cli/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CA+HrD"}

package/dist/cli/commands/sync.js

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSyncSource = registerSyncSource;
+const chalk_1 = __importDefault(require("chalk"));
+const path_1 = __importDefault(require("path"));
+const ConfigLoader_js_1 = require("../../config/ConfigLoader.js");
+const DnaIndexService_js_1 = require("../../services/DnaIndexService.js");
+const SourceLinkService_js_1 = require("../../services/SourceLinkService.js");
+const ProgressReporter_js_1 = require("../ui/ProgressReporter.js");
+function registerSyncSource(dna) {
+    dna
+        .command('sync-source <key>')
+        .description('Write current DNA selector back to .spec.ts via AST')
+        .option('--locator-index <n>', 'Which locator on the line (0-based)', '0')
+        .option('--dry-run', 'Preview without writing')
+        .option('--json', 'Emit JSON result')
+        .option('--dir <path>', 'Override snapshot directory')
+        .action(async (key, opts) => {
+        const config = ConfigLoader_js_1.ConfigLoader.getInstance();
+        const snapshotDir = opts.dir ?? config.dnaStoragePath;
+        const locatorIndex = Math.max(0, parseInt(opts.locatorIndex, 10) || 0);
+        const progress = new ProgressReporter_js_1.ProgressReporter(opts.json);
+        const dnaIndex = new DnaIndexService_js_1.DnaIndexService();
+        await progress.run('Scanning DNA snapshots…', () => dnaIndex.buildIndex(snapshotDir));
+        const record = dnaIndex.getByKey(key);
+        if (!record) {
+            if (opts.json) {
+                process.stdout.write(JSON.stringify({ success: false, reason: `DNA not found: ${key}` }, null, 2) + '\n');
+                process.exit(3);
+            }
+            const err = new Error(`DNA not found: ${key}`);
+            err.code = 'DNA_NOT_FOUND';
+            throw err;
+        }
+        if (!record.sourceFile || record.sourceLine <= 0) {
+            if (opts.json) {
+                process.stdout.write(JSON.stringify({ success: false, reason: `DNA "${key}" has no sourceFile/sourceLine` }, null, 2) + '\n');
+            }
+            else {
+                process.stdout.write(chalk_1.default.yellow(`  ⚠  DNA "${key}" has no sourceFile/sourceLine — cannot sync.\n`));
+            }
+            return;
+        }
+        const sourceLink = new SourceLinkService_js_1.SourceLinkService();
+        const locators = await progress.run('Analyzing AST for locator update…', async () => sourceLink.enumerateLocatorsOnLine(record.sourceFile, record.sourceLine));
+        const target = locators[locatorIndex] ?? locators[0];
+        const relPath = path_1.default.relative(process.cwd(), record.sourceFile);
+        if (!opts.json) {
+            process.stdout.write('\n');
+            process.stdout.write(`  ${chalk_1.default.bold('DNA selector:')}   ${chalk_1.default.green(record.selector)}\n`);
+            process.stdout.write(`  ${chalk_1.default.bold('Source file:')}    ${relPath}:${record.sourceLine}\n`);
+        }
+        if (!target) {
+            if (opts.json) {
+                process.stdout.write(JSON.stringify({ success: false, reason: `No locator at index ${locatorIndex} on line ${record.sourceLine}` }, null, 2) + '\n');
+            }
+            else {
+                process.stdout.write(chalk_1.default.yellow(`  ⚠  No locator found at index ${locatorIndex} on line ${record.sourceLine}.\n\n`));
+            }
+            return;
+        }
+        if (!opts.json) {
+            process.stdout.write(`  ${chalk_1.default.bold('Locator found:')}  [${locatorIndex}] ${chalk_1.default.yellow(target.preview)}\n`);
+            process.stdout.write(`  ${chalk_1.default.bold('Current value:')}  ${chalk_1.default.red(target.selector)}\n`);
+            process.stdout.write(`  ${chalk_1.default.bold('Will become:')}    ${chalk_1.default.green(record.selector)}\n\n`);
+        }
+        if (target.selector === record.selector) {
+            if (opts.json) {
+                process.stdout.write(JSON.stringify({ success: true, reason: 'Already in sync — nothing to do' }, null, 2) + '\n');
+            }
+            else {
+                process.stdout.write(chalk_1.default.dim('  Source already matches DNA selector. Nothing to do.\n\n'));
+            }
+            return;
+        }
+        if (opts.dryRun) {
+            if (opts.json) {
+                process.stdout.write(JSON.stringify({
+                    dryRun: true,
+                    key,
+                    sourceFile: record.sourceFile,
+                    sourceLine: record.sourceLine,
+                    locatorIndex,
+                    oldSelector: target.selector,
+                    newSelector: record.selector,
+                }, null, 2) + '\n');
+            }
+            else {
+                process.stdout.write(chalk_1.default.dim('  [dry-run] No files written.\n\n'));
+            }
+            return;
+        }
+        const patch = {
+            key,
+            field: 'selector',
+            oldValue: target.selector,
+            newValue: record.selector,
+            applySourceUpdate: true,
+            locatorIndex,
+        };
+        const result = await progress.run('Applying AST source update…', () => sourceLink.applySourceUpdate(record, patch));
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+            if (!result.success)
+                process.exit(5);
+        }
+        else {
+            if (result.success) {
+                const lineInfo = result.lineUpdated ? ` (line ${result.lineUpdated})` : '';
+                process.stdout.write(`  ${chalk_1.default.green('✓')} Source updated${lineInfo}\n\n`);
+            }
+            else {
+                process.stdout.write(`  ${chalk_1.default.red('✗')} Source update failed: ${result.reason}\n\n`);
+                const err = new Error(result.reason);
+                err.code = 'AST_ERROR';
+                throw err;
+            }
+        }
+    });
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const ErrorHandler_js_1 = require("./ErrorHandler.js");
+const init_js_1 = require("./commands/init.js");
+const status_js_1 = require("./commands/status.js");
+const list_js_1 = require("./commands/list.js");
+const find_js_1 = require("./commands/find.js");
+const refactor_js_1 = require("./commands/refactor.js");
+const bulk_js_1 = require("./commands/bulk.js");
+const sync_js_1 = require("./commands/sync.js");
+(0, ErrorHandler_js_1.registerGlobalHandlers)();
+// Diagnostic console.log from services (ConfigLoader etc.) → stderr so stdout stays pipe-clean
+console.log = (...args) => process.stderr.write(args.map(String).join(' ') + '\n');
+const program = new commander_1.Command();
+program
+    .name('sela')
+    .description('Sela CLI — proactive DNA management for Fixwright')
+    .version('1.0.0')
+    .exitOverride(ErrorHandler_js_1.handleError)
+    .configureOutput({ outputError: () => { } });
+// ── sela init ────────────────────────────────────────────────────────────────
+(0, init_js_1.registerInit)(program);
+// ── sela status (T-06) ────────────────────────────────────────────────────────
+(0, status_js_1.registerStatus)(program);
+// ── sela list (T-07) ─────────────────────────────────────────────────────────
+(0, list_js_1.registerList)(program);
+// ── sela dna <subcommand> ─────────────────────────────────────────────────────
+const dna = new commander_1.Command('dna')
+    .description('DNA management commands')
+    .exitOverride(ErrorHandler_js_1.handleError)
+    .configureOutput({ outputError: () => { } });
+// ── sela dna find (T-08) ─────────────────────────────────────────────────────
+(0, find_js_1.registerFind)(dna);
+// ── sela dna refactor (T-12/T-13) ────────────────────────────────────────────
+(0, refactor_js_1.registerRefactor)(dna);
+// ── sela dna bulk-update (T-14) ───────────────────────────────────────────────
+(0, bulk_js_1.registerBulkUpdate)(dna);
+// ── sela dna sync-source (T-15) ───────────────────────────────────────────────
+(0, sync_js_1.registerSyncSource)(dna);
+program.addCommand(dna);
+program.parseAsync(process.argv).catch(ErrorHandler_js_1.handleError);

package/dist/cli/ui/DnaTable.d.ts

@@ -0,0 +1,3 @@
+import type { DnaRecord } from '../../services/types.js';
+export declare function renderTable(records: DnaRecord[]): string;
+//# sourceMappingURL=DnaTable.d.ts.map

package/dist/cli/ui/DnaTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DnaTable.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/DnaTable.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAuCzD,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAoBxD"}

package/dist/cli/ui/DnaTable.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTable = renderTable;
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const chalk_1 = __importDefault(require("chalk"));
+const path_1 = __importDefault(require("path"));
+// Truncate before chalk so ANSI codes don't corrupt visual width calculations.
+function trunc(s, maxLen, fallback = '—') {
+    if (s == null || s.trim() === '')
+        return chalk_1.default.dim(fallback);
+    return s.length <= maxLen ? s : s.slice(0, maxLen - 1) + '…';
+}
+function relativeTime(iso) {
+    if (!iso)
+        return chalk_1.default.dim('never');
+    const d = Math.floor((Date.now() - new Date(iso).getTime()) / 86_400_000);
+    if (d === 0)
+        return chalk_1.default.green('today');
+    if (d < 7)
+        return `${d}d ago`;
+    if (d < 30)
+        return `${Math.floor(d / 7)}w ago`;
+    return `${Math.floor(d / 30)}mo ago`;
+}
+function statusBadge(r) {
+    if (r.isOrphaned)
+        return chalk_1.default.red('orphaned');
+    if (r.status === 'healed')
+        return chalk_1.default.yellow('⚠ unverified');
+    if (r.status === 'broken')
+        return chalk_1.default.red('broken');
+    if (r.lastHealed !== null)
+        return chalk_1.default.green('healed');
+    return chalk_1.default.cyan('active');
+}
+function sourceCell(r) {
+    if (!r.sourceFile)
+        return chalk_1.default.dim('—');
+    const rel = path_1.default.relative(process.cwd(), r.sourceFile);
+    const display = rel.length < r.sourceFile.length ? rel : r.sourceFile;
+    const suffix = r.sourceLine > 0 ? `:${r.sourceLine}` : '';
+    return trunc(display + suffix, 32);
+}
+// colWidths = content + 2 (1-space padding each side)
+const COLS = {
+    head: ['Key', 'Test Title', 'Source : Line', 'Selector', 'Last Healed', 'Status'],
+    colWidths: [11, 24, 36, 44, 13, 11],
+};
+function renderTable(records) {
+    const table = new cli_table3_1.default({
+        head: COLS.head.map((h) => chalk_1.default.bold(h)),
+        colWidths: COLS.colWidths,
+        wordWrap: false,
+        style: { head: [], border: ['dim'] },
+    });
+    for (const r of records) {
+        table.push([
+            chalk_1.default.dim(r.key.slice(0, 9)),
+            trunc(r.testTitle, 22),
+            sourceCell(r),
+            chalk_1.default.yellow(trunc(r.selector, 42)),
+            relativeTime(r.lastHealed),
+            statusBadge(r),
+        ]);
+    }
+    return table.toString();
+}

package/dist/cli/ui/LocatorPicker.d.ts

@@ -0,0 +1,8 @@
+import type { LocatorEnumeration } from '../../services/SourceLinkService.js';
+/**
+ * Presents an interactive list when a source line contains multiple locators.
+ * Returns the 0-based index of the user's selection.
+ * Pre-selects the entry whose selector matches currentSelector (normalized comparison).
+ */
+export declare function pickLocator(locators: LocatorEnumeration[], currentSelector: string): Promise<number>;
+//# sourceMappingURL=LocatorPicker.d.ts.map

package/dist/cli/ui/LocatorPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocatorPicker.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/LocatorPicker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAsBjB"}

package/dist/cli/ui/LocatorPicker.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pickLocator = pickLocator;
+const enquirer_js_1 = require("../../vendor/enquirer.js");
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Presents an interactive list when a source line contains multiple locators.
+ * Returns the 0-based index of the user's selection.
+ * Pre-selects the entry whose selector matches currentSelector (normalized comparison).
+ */
+async function pickLocator(locators, currentSelector) {
+    const norm = currentSelector.trim();
+    const defaultIdx = locators.findIndex((l) => l.selector.trim() === norm);
+    const choices = locators.map((l) => {
+        const isCurrent = l.selector.trim() === norm;
+        const hint = isCurrent ? chalk_1.default.dim('  ← current DNA selector') : '';
+        return {
+            name: String(l.index),
+            message: `[${l.index}]  ${chalk_1.default.yellow(l.preview)}${hint}`,
+        };
+    });
+    const prompt = new enquirer_js_1.Select({
+        name: 'locatorIndex',
+        message: `Line has ${locators.length} locators. Which are you refactoring?`,
+        choices,
+        initial: defaultIdx >= 0 ? defaultIdx : 0,
+    });
+    const result = (await prompt.run());
+    return parseInt(result, 10);
+}

package/dist/cli/ui/ProgressReporter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Wraps ora spinners. Pass silent=true (e.g. when --json active) to skip all
+ * spinner output and run the task directly. All spinner output goes to stderr
+ * so stdout stays pipe-clean.
+ */
+export declare class ProgressReporter {
+    private silent;
+    constructor(silent?: boolean);
+    run<T>(label: string, fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=ProgressReporter.d.ts.map

package/dist/cli/ui/ProgressReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressReporter.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/ProgressReporter.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAU;gBAEZ,MAAM,UAAQ;IAIpB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAY9D"}

package/dist/cli/ui/ProgressReporter.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressReporter = void 0;
+const ora_1 = __importDefault(require("ora"));
+/**
+ * Wraps ora spinners. Pass silent=true (e.g. when --json active) to skip all
+ * spinner output and run the task directly. All spinner output goes to stderr
+ * so stdout stays pipe-clean.
+ */
+class ProgressReporter {
+    silent;
+    constructor(silent = false) {
+        this.silent = silent;
+    }
+    async run(label, fn) {
+        if (this.silent)
+            return fn();
+        const spinner = (0, ora_1.default)({ text: label, stream: process.stderr }).start();
+        try {
+            const result = await fn();
+            spinner.succeed();
+            return result;
+        }
+        catch (err) {
+            spinner.fail();
+            throw err;
+        }
+    }
+}
+exports.ProgressReporter = ProgressReporter;

package/dist/cli/ui/RefactorWizard.d.ts

@@ -0,0 +1,26 @@
+import type { IDnaIndexService } from '../../services/DnaIndexService.js';
+import type { IDnaEditorService } from '../../services/DnaEditorService.js';
+import type { ISourceLinkService } from '../../services/SourceLinkService.js';
+export interface WizardOptions {
+    noSource?: boolean;
+    dryRun?: boolean;
+}
+interface WizardServices {
+    dnaIndex: IDnaIndexService;
+    dnaEditor: IDnaEditorService;
+    sourceLink: ISourceLinkService;
+}
+export declare class RefactorWizard {
+    private readonly svc;
+    private readonly opts;
+    constructor(svc: WizardServices, opts?: WizardOptions);
+    run(initialKey?: string): Promise<void>;
+    private resolveKey;
+    private selectDna;
+    private selectField;
+    private editValue;
+    private confirm;
+    private buildDnaPatch;
+}
+export {};
+//# sourceMappingURL=RefactorWizard.d.ts.map

package/dist/cli/ui/RefactorWizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RefactorWizard.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/RefactorWizard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,oCAAoC,CAAC;AACjG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAM9E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,cAAc;IACtB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAwFD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,GAAG,EAAE,cAAc,EACnB,IAAI,GAAE,aAAkB;IAGrC,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4G7C,OAAO,CAAC,UAAU;YAUJ,SAAS;YAwBT,WAAW;YAgBX,SAAS;YAyBT,OAAO;IAKrB,OAAO,CAAC,aAAa;CAGtB"}