@lwelliott/cortex-cli 1.0.3

package/dist/cli/test-report.js

@@ -0,0 +1,134 @@
+"use strict";
+// CLI subcommands for test-report group
+// SAD-0031: Explicit Command IDs, --task removal, --content-file import
+// SAD-0010: --content-file replaces --report-path, atomic import, show command
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestReportGroup = createTestReportGroup;
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const review_service_1 = require("../services/review-service");
+const sprint_1 = require("../services/sprint");
+const connection_1 = require("../db/connection");
+const migration_1 = require("../db/migration");
+const project_resolver_1 = require("./project-resolver");
+const format_selector_1 = require("./format-selector");
+const errors_1 = require("../utils/errors");
+function run(fn, optsOrCmd) {
+    try {
+        const opts = optsOrCmd instanceof commander_1.Command ? optsOrCmd.optsWithGlobals() : optsOrCmd;
+        console.log(fn(opts));
+    }
+    catch (err) {
+        const opts = optsOrCmd instanceof commander_1.Command ? optsOrCmd.optsWithGlobals() : optsOrCmd;
+        const format = (0, format_selector_1.selectFormat)({ quiet: opts.quiet, json: opts.json, format: opts.format });
+        console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), format));
+        process.exit(1);
+    }
+}
+function createTestReportGroup() {
+    const group = new commander_1.Command('test-report').description('Test execution reports');
+    // test-report add — uses --content-file (atomic import), positional <id> (SAD-0031/FS-SS-028-0001)
+    group.command('add')
+        .description('Add a test report')
+        .argument('<id>', 'Test report ID (4-digit zero-padded, e.g., 0001)')
+        .option('--sprint <id>', 'Sprint ID')
+        .requiredOption('--total <n>', 'Total tests')
+        .requiredOption('--passed <n>', 'Passed tests')
+        .requiredOption('--failed <n>', 'Failed tests')
+        .option('--skipped <n>', 'Skipped tests', '0')
+        .option('--command <cmd>', 'Test command')
+        .option('--duration <ms>', 'Duration in milliseconds')
+        .option('--content-file <path>', 'File to read report content from (replaces --report-path)')
+        .action((testReportId, _opts, _cmd) => {
+        run((opts) => {
+            const format = (0, format_selector_1.selectFormat)(opts);
+            const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+            const db = (0, connection_1.openConnection)(resolved.dbPath);
+            const contentFilePath = (opts.contentFile ?? opts.contentfile ?? opts.content_file);
+            try {
+                (0, migration_1.initializeSchema)(db);
+                // Reject deprecated --report-path (SAD-0031 Part A)
+                if (opts.reportPath !== undefined || opts.report_path !== undefined) {
+                    throw new errors_1.TestReportReportPathRejectedError();
+                }
+                // Count consistency warning (non-blocking)
+                const total = Number(opts.total);
+                const passed = Number(opts.passed);
+                const failed = Number(opts.failed);
+                const skipped = Number(opts.skipped);
+                // Step 1: Read content file (before transaction — fail fast)
+                let content = '';
+                if (contentFilePath) {
+                    try {
+                        content = (0, fs_1.readFileSync)(contentFilePath, 'utf-8');
+                    }
+                    catch {
+                        throw new errors_1.TestReportContentFileError(contentFilePath);
+                    }
+                }
+                const sprintId = (0, sprint_1.resolveSprint)(db, opts.sprint).id;
+                // Steps 3-5: DB write + commit
+                const result = (0, review_service_1.addTestReport)(db, sprintId, testReportId, total, passed, failed, {
+                    skipCount: skipped,
+                    command: opts.command,
+                    duration: opts.duration ? Number(opts.duration) : undefined,
+                    content,
+                });
+                // Step 6: Delete file after successful commit
+                if (contentFilePath) {
+                    try {
+                        (0, fs_1.unlinkSync)(contentFilePath);
+                    }
+                    catch { /* best effort */ }
+                }
+                return (0, format_selector_1.formatOutput)(result, format, 'test-report');
+            }
+            finally {
+                db.close();
+            }
+        }, _cmd);
+    });
+    // test-report list — --task removed per SAD-0031 Part B
+    group.command('list')
+        .description('List test reports')
+        .option('--sprint <id>', 'Filter by sprint')
+        .action((_opts, _cmd) => {
+        run((opts) => {
+            const format = (0, format_selector_1.selectFormat)(opts);
+            const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+            const db = (0, connection_1.openConnection)(resolved.dbPath);
+            try {
+                (0, migration_1.initializeSchema)(db);
+                const sprintId = (0, sprint_1.resolveSprint)(db, opts.sprint).id;
+                const results = (0, review_service_1.listTestReports)(db, sprintId);
+                return (0, format_selector_1.formatOutput)(results, format, 'test-report');
+            }
+            finally {
+                db.close();
+            }
+        }, _cmd);
+    });
+    // test-report show — sprint-scoped (URD-026 Part A, SAD-0031)
+    group.command('show')
+        .description('Show test report detail')
+        .argument('<id>', 'Test report ID')
+        .option('--sprint <id>', 'Sprint ID')
+        .action((id, _opts, _cmd) => {
+        run((opts) => {
+            const format = (0, format_selector_1.selectFormat)(opts, true); // isShowCommand = true → default markdown
+            const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+            const db = (0, connection_1.openConnection)(resolved.dbPath);
+            try {
+                (0, migration_1.initializeSchema)(db);
+                const sprintId = (0, sprint_1.resolveSprint)(db, opts.sprint).id;
+                const result = (0, review_service_1.getTestReport)(db, id, sprintId);
+                return (0, format_selector_1.formatOutput)(result, format, 'test-report');
+            }
+            finally {
+                db.close();
+            }
+        }, _cmd);
+    });
+    return group;
+}
+//# sourceMappingURL=test-report.js.map

package/dist/cli/test-report.js.map

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

package/dist/cli/validate.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+export declare function createValidateBoardCommand(): Command;
+export declare function createValidateSpawnCommand(): Command;
+/**
+ * Create the validate command group with all subcommands.
+ */
+export declare function createValidateGroup(): Command;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/cli/validate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,0BAA0B,IAAI,OAAO,CAqBpD;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CA8BpD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAQ7C"}

package/dist/cli/validate.js

@@ -0,0 +1,86 @@
+"use strict";
+// CLI subcommands for validation group
+// MOD-006: Validation
+// Follows same pattern as src/cli/project.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createValidateBoardCommand = createValidateBoardCommand;
+exports.createValidateSpawnCommand = createValidateSpawnCommand;
+exports.createValidateGroup = createValidateGroup;
+const commander_1 = require("commander");
+const validation_1 = require("../services/validation");
+const connection_1 = require("../db/connection");
+const migration_1 = require("../db/migration");
+const project_resolver_1 = require("./project-resolver");
+const format_selector_1 = require("./format-selector");
+function executeHandler(runner, optsOrCmd) {
+    try {
+        const options = optsOrCmd instanceof commander_1.Command ? optsOrCmd.optsWithGlobals() : optsOrCmd;
+        console.log(runner(options));
+    }
+    catch (err) {
+        const options = optsOrCmd instanceof commander_1.Command ? optsOrCmd.optsWithGlobals() : optsOrCmd;
+        const format = (0, format_selector_1.selectFormat)({
+            quiet: options.quiet,
+            json: options.json,
+            format: options.format,
+        });
+        console.error((0, format_selector_1.formatErrorOutput)(err instanceof Error ? err : new Error(String(err)), format));
+        process.exit(1);
+    }
+}
+function createValidateBoardCommand() {
+    const cmd = new commander_1.Command('board')
+        .description('Validate board integrity for a sprint')
+        .option('--sprint <id>', 'Sprint ID (uses default if omitted)');
+    cmd.action(() => {
+        executeHandler((opts) => {
+            const format = (0, format_selector_1.selectFormat)(opts);
+            const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+            const db = (0, connection_1.openConnection)(resolved.dbPath);
+            try {
+                (0, migration_1.initializeSchema)(db);
+                const result = (0, validation_1.validateBoard)(db, opts.sprint);
+                return (0, format_selector_1.formatOutput)(result, format, 'validation');
+            }
+            finally {
+                db.close();
+            }
+        }, cmd);
+    });
+    return cmd;
+}
+function createValidateSpawnCommand() {
+    const cmd = new commander_1.Command('spawn')
+        .description('Check spawn legality')
+        .requiredOption('--sprint <id>', 'Sprint ID')
+        .requiredOption('--task <id>', 'Task ID to spawn from')
+        .requiredOption('--stage <s>', 'Spawn stage (analyst, architect, coder, tester)')
+        .requiredOption('--role <r>', 'Role that will own the spawned task');
+    cmd.action(() => {
+        executeHandler((opts) => {
+            const format = (0, format_selector_1.selectFormat)(opts);
+            const resolved = (0, project_resolver_1.resolveFromCLI)(opts);
+            const db = (0, connection_1.openConnection)(resolved.dbPath);
+            try {
+                (0, migration_1.initializeSchema)(db);
+                const result = (0, validation_1.validateSpawn)(db, opts.sprint, opts.task, opts.stage, opts.role);
+                return (0, format_selector_1.formatOutput)(result, format, 'spawn');
+            }
+            finally {
+                db.close();
+            }
+        }, cmd);
+    });
+    return cmd;
+}
+/**
+ * Create the validate command group with all subcommands.
+ */
+function createValidateGroup() {
+    const cmd = new commander_1.Command('validate')
+        .description('Validate board integrity and spawn legality');
+    cmd.addCommand(createValidateBoardCommand());
+    cmd.addCommand(createValidateSpawnCommand());
+    return cmd;
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/validate.js.map

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

package/dist/config/config.d.ts

@@ -0,0 +1,18 @@
+import type { GlobalConfig } from '../models/project';
+/** Default path for the global config */
+export declare const DEFAULT_CONFIG_PATH: string;
+/**
+ * Load the global config from disk.
+ * Creates the file with empty config if it doesn't exist.
+ */
+export declare function loadConfig(configPath?: string): GlobalConfig;
+/**
+ * Save the global config to disk.
+ * Creates parent directories if they don't exist.
+ */
+export declare function saveConfig(config: GlobalConfig, configPath?: string): void;
+/**
+ * Update config with partial changes.
+ */
+export declare function updateConfig(updates: Partial<GlobalConfig>, configPath?: string): GlobalConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,yCAAyC;AACzC,eAAO,MAAM,mBAAmB,QAAyB,CAAC;AAQ1D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CAwB5D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAgB1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CAK9F"}

package/dist/config/config.js

@@ -0,0 +1,70 @@
+"use strict";
+// Global config manager
+// Manages ~/.config/cortex-cli/config.json
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG_PATH = void 0;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.updateConfig = updateConfig;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const project_1 = require("../models/project");
+const errors_1 = require("../utils/errors");
+/** Default path for the global config */
+exports.DEFAULT_CONFIG_PATH = getDefaultConfigPath();
+function getDefaultConfigPath() {
+    const xdgConfig = process.env.XDG_CONFIG_HOME;
+    const configDir = xdgConfig || `${process.env.HOME}/.config`;
+    return `${configDir}/cortex-cli/config.json`;
+}
+/**
+ * Load the global config from disk.
+ * Creates the file with empty config if it doesn't exist.
+ */
+function loadConfig(configPath) {
+    const path = configPath ?? exports.DEFAULT_CONFIG_PATH;
+    if (!(0, fs_1.existsSync)(path)) {
+        saveConfig(project_1.EMPTY_CONFIG, path);
+        return { ...project_1.EMPTY_CONFIG };
+    }
+    try {
+        const content = (0, fs_1.readFileSync)(path, 'utf-8');
+        const data = JSON.parse(content);
+        if (typeof data.version !== 'number') {
+            throw new errors_1.ConfigError(`Invalid config format at "${path}"`);
+        }
+        return data;
+    }
+    catch (err) {
+        if (err instanceof errors_1.ConfigError)
+            throw err;
+        throw new errors_1.ConfigError(`Failed to read config at "${path}": ${err instanceof Error ? err.message : String(err)}`, { path, originalError: err });
+    }
+}
+/**
+ * Save the global config to disk.
+ * Creates parent directories if they don't exist.
+ */
+function saveConfig(config, configPath) {
+    const path = configPath ?? exports.DEFAULT_CONFIG_PATH;
+    try {
+        const dir = (0, path_1.dirname)(path);
+        if (!(0, fs_1.existsSync)(dir)) {
+            (0, fs_1.mkdirSync)(dir, { recursive: true });
+        }
+        (0, fs_1.writeFileSync)(path, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    }
+    catch (err) {
+        throw new errors_1.ConfigError(`Failed to write config at "${path}": ${err instanceof Error ? err.message : String(err)}`, { path, originalError: err });
+    }
+}
+/**
+ * Update config with partial changes.
+ */
+function updateConfig(updates, configPath) {
+    const config = loadConfig(configPath);
+    Object.assign(config, updates);
+    saveConfig(config, configPath);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":";AAAA,wBAAwB;AACxB,2CAA2C;;;AAqB3C,gCAwBC;AAMD,gCAgBC;AAKD,oCAKC;AA3ED,2BAAwE;AACxE,+BAA+B;AAE/B,+CAAiD;AACjD,4CAA8C;AAE9C,yCAAyC;AAC5B,QAAA,mBAAmB,GAAG,oBAAoB,EAAE,CAAC;AAE1D,SAAS,oBAAoB;IAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC9C,MAAM,SAAS,GAAG,SAAS,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC;IAC7D,OAAO,GAAG,SAAS,yBAAyB,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,UAAmB;IAC5C,MAAM,IAAI,GAAG,UAAU,IAAI,2BAAmB,CAAC;IAE/C,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QACtB,UAAU,CAAC,sBAAY,EAAE,IAAI,CAAC,CAAC;QAC/B,OAAO,EAAE,GAAG,sBAAY,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;QAEjD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,oBAAW,CAAC,6BAA6B,IAAI,GAAG,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,oBAAW;YAAE,MAAM,GAAG,CAAC;QAC1C,MAAM,IAAI,oBAAW,CACnB,6BAA6B,IAAI,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACzF,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAC7B,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,MAAoB,EAAE,UAAmB;IAClE,MAAM,IAAI,GAAG,UAAU,IAAI,2BAAmB,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAA,eAAU,EAAC,GAAG,CAAC,EAAE,CAAC;YACrB,IAAA,cAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,IAAA,kBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,oBAAW,CACnB,8BAA8B,IAAI,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC1F,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAC7B,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,OAA8B,EAAE,UAAmB;IAC9E,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/config/registry.d.ts

@@ -0,0 +1,52 @@
+import type { ProjectsRegistry, ProjectEntry } from '../models/project';
+/** Default path for the global projects registry */
+export declare const DEFAULT_REGISTRY_PATH: string;
+/**
+ * Load the projects registry from disk.
+ * Creates the file with empty registry if it doesn't exist.
+ * Per FS-SS-002-0010 VR-003: cleans up stale .tmp files from interrupted writes.
+ */
+export declare function loadRegistry(registryPath?: string): ProjectsRegistry;
+/**
+ * Save the projects registry to disk atomically.
+ * Per FS-SS-002-0010 VR-003: write to temp file, then rename.
+ * Rename is atomic on POSIX (same filesystem).
+ */
+export declare function saveRegistry(registry: ProjectsRegistry, registryPath?: string): void;
+/**
+ * Add a project to the registry.
+ * @throws DuplicateProjectError (ERR-PROJ-001) if the project name already exists
+ */
+export declare function addProject(name: string, folder: string, registryPath?: string): ProjectsRegistry;
+/**
+ * Remove a project from the registry.
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+export declare function removeProject(name: string, registryPath?: string): ProjectsRegistry;
+/**
+ * Get a project entry from the registry.
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+export declare function getProject(name: string, registryPath?: string): ProjectEntry;
+/**
+ * List all registered projects.
+ */
+export declare function listProjects(registryPath?: string): ProjectsRegistry;
+/**
+ * Set the default project.
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+export declare function setDefaultProject(name: string, registryPath?: string): ProjectsRegistry;
+/**
+ * Get the default project name (or null if none set).
+ */
+export declare function getDefaultProject(registryPath?: string): string | null;
+/**
+ * Find a project by folder path (for CWD resolution).
+ * Uses longest-prefix match to handle subdirectories.
+ */
+export declare function findProjectByFolder(folder: string, registryPath?: string): {
+    name: string;
+    entry: ProjectEntry;
+} | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/config/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/config/registry.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWxE,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AAQ9D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA+CpE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAyBpF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAmBhG;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAgBnF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CAS5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAEpE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAUvF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CAiBvH"}

package/dist/config/registry.js

@@ -0,0 +1,193 @@
+"use strict";
+// Global project registry manager
+// Implements AD-0001: JSON Registry for Global Project Registry
+// Manages ~/.config/cortex-cli/registry.json
+// + FS-SS-002-0010 VR-003 (atomic writes), ERR-REG-001..005
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_REGISTRY_PATH = void 0;
+exports.loadRegistry = loadRegistry;
+exports.saveRegistry = saveRegistry;
+exports.addProject = addProject;
+exports.removeProject = removeProject;
+exports.getProject = getProject;
+exports.listProjects = listProjects;
+exports.setDefaultProject = setDefaultProject;
+exports.getDefaultProject = getDefaultProject;
+exports.findProjectByFolder = findProjectByFolder;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const errors_1 = require("../utils/errors");
+/** Default path for the global projects registry */
+exports.DEFAULT_REGISTRY_PATH = getDefaultRegistryPath();
+function getDefaultRegistryPath() {
+    const xdgConfig = process.env.XDG_CONFIG_HOME;
+    const configDir = xdgConfig || `${process.env.HOME}/.config`;
+    return `${configDir}/cortex-cli/registry.json`;
+}
+/**
+ * Load the projects registry from disk.
+ * Creates the file with empty registry if it doesn't exist.
+ * Per FS-SS-002-0010 VR-003: cleans up stale .tmp files from interrupted writes.
+ */
+function loadRegistry(registryPath) {
+    const path = registryPath ?? getDefaultRegistryPath();
+    // Clean up stale temp file from interrupted write (VR-003 safety)
+    const tmpPath = `${path}.tmp`;
+    if ((0, fs_1.existsSync)(tmpPath)) {
+        try {
+            (0, fs_1.unlinkSync)(tmpPath);
+        }
+        catch {
+            // Ignore cleanup failures — the main file is authoritative
+        }
+    }
+    if (!(0, fs_1.existsSync)(path)) {
+        const empty = { version: 1, default: null, projects: {} };
+        saveRegistry(empty, path);
+        return empty;
+    }
+    let content;
+    try {
+        content = (0, fs_1.readFileSync)(path, 'utf-8');
+    }
+    catch (err) {
+        throw new errors_1.RegistryReadError(err instanceof Error ? err.message : String(err));
+    }
+    let data;
+    try {
+        data = JSON.parse(content);
+    }
+    catch (err) {
+        throw new errors_1.RegistryInvalidJsonError(err instanceof Error ? err.message : String(err));
+    }
+    // Basic validation (VR-004: tolerate formatting differences)
+    if (typeof data !== 'object' || data === null ||
+        typeof data.version !== 'number' ||
+        typeof data.projects !== 'object') {
+        throw new errors_1.RegistryInvalidStructureError('missing or invalid "version" (number) or "projects" (object) fields');
+    }
+    return data;
+}
+/**
+ * Save the projects registry to disk atomically.
+ * Per FS-SS-002-0010 VR-003: write to temp file, then rename.
+ * Rename is atomic on POSIX (same filesystem).
+ */
+function saveRegistry(registry, registryPath) {
+    const path = registryPath ?? exports.DEFAULT_REGISTRY_PATH;
+    try {
+        const dir = (0, path_1.dirname)(path);
+        if (!(0, fs_1.existsSync)(dir)) {
+            try {
+                (0, fs_1.mkdirSync)(dir, { recursive: true });
+            }
+            catch (err) {
+                throw new errors_1.RegistryDirCreateError(err instanceof Error ? err.message : String(err));
+            }
+        }
+        // Atomic write: write to .tmp then rename (VR-003)
+        const tmpPath = `${path}.tmp`;
+        (0, fs_1.writeFileSync)(tmpPath, JSON.stringify(registry, null, 2) + '\n', 'utf-8');
+        (0, fs_1.renameSync)(tmpPath, path);
+    }
+    catch (err) {
+        if (err instanceof errors_1.RegistryDirCreateError)
+            throw err;
+        throw new errors_1.RegistryWriteError(err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * Add a project to the registry.
+ * @throws DuplicateProjectError (ERR-PROJ-001) if the project name already exists
+ */
+function addProject(name, folder, registryPath) {
+    const registry = loadRegistry(registryPath);
+    if (registry.projects[name]) {
+        throw new errors_1.DuplicateProjectError(name);
+    }
+    registry.projects[name] = {
+        folder,
+        added_at: new Date().toISOString(),
+    };
+    // If this is the first project, set it as default
+    if (Object.keys(registry.projects).length === 1 && !registry.default) {
+        registry.default = name;
+    }
+    saveRegistry(registry, registryPath);
+    return registry;
+}
+/**
+ * Remove a project from the registry.
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+function removeProject(name, registryPath) {
+    const registry = loadRegistry(registryPath);
+    if (!registry.projects[name]) {
+        throw new errors_1.ProjectNotFoundError(name);
+    }
+    delete registry.projects[name];
+    // If we removed the default project, clear the default
+    if (registry.default === name) {
+        registry.default = null;
+    }
+    saveRegistry(registry, registryPath);
+    return registry;
+}
+/**
+ * Get a project entry from the registry.
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+function getProject(name, registryPath) {
+    const registry = loadRegistry(registryPath);
+    const entry = registry.projects[name];
+    if (!entry) {
+        throw new errors_1.ProjectNotFoundError(name);
+    }
+    return entry;
+}
+/**
+ * List all registered projects.
+ */
+function listProjects(registryPath) {
+    return loadRegistry(registryPath);
+}
+/**
+ * Set the default project.
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+function setDefaultProject(name, registryPath) {
+    const registry = loadRegistry(registryPath);
+    if (!registry.projects[name]) {
+        throw new errors_1.ProjectNotFoundError(name);
+    }
+    registry.default = name;
+    saveRegistry(registry, registryPath);
+    return registry;
+}
+/**
+ * Get the default project name (or null if none set).
+ */
+function getDefaultProject(registryPath) {
+    const registry = loadRegistry(registryPath);
+    return registry.default;
+}
+/**
+ * Find a project by folder path (for CWD resolution).
+ * Uses longest-prefix match to handle subdirectories.
+ */
+function findProjectByFolder(folder, registryPath) {
+    const registry = loadRegistry(registryPath);
+    let bestMatch = null;
+    for (const [name, entry] of Object.entries(registry.projects)) {
+        // Normalize both paths for comparison
+        const normalizedFolder = folder.replace(/\/+$/, '');
+        const normalizedEntry = entry.folder.replace(/\/+$/, '');
+        if (normalizedFolder === normalizedEntry || normalizedFolder.startsWith(normalizedEntry + '/')) {
+            if (!bestMatch || normalizedEntry.length > bestMatch.matchLen) {
+                bestMatch = { name, entry, matchLen: normalizedEntry.length };
+            }
+        }
+    }
+    return bestMatch ? { name: bestMatch.name, entry: bestMatch.entry } : null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/config/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/config/registry.ts"],"names":[],"mappings":";AAAA,kCAAkC;AAClC,gEAAgE;AAChE,6CAA6C;AAC7C,4DAA4D;;;AA6B5D,oCA+CC;AAOD,oCAyBC;AAMD,gCAmBC;AAMD,sCAgBC;AAMD,gCASC;AAKD,oCAEC;AAMD,8CAUC;AAKD,8CAGC;AAMD,kDAiBC;AA9ND,2BAAgG;AAChG,+BAA+B;AAE/B,4CAQyB;AAEzB,oDAAoD;AACvC,QAAA,qBAAqB,GAAG,sBAAsB,EAAE,CAAC;AAE9D,SAAS,sBAAsB;IAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC9C,MAAM,SAAS,GAAG,SAAS,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC;IAC7D,OAAO,GAAG,SAAS,2BAA2B,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,YAAqB;IAChD,MAAM,IAAI,GAAG,YAAY,IAAI,sBAAsB,EAAE,CAAC;IAEtD,kEAAkE;IAClE,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC;IAC9B,IAAI,IAAA,eAAU,EAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,IAAA,eAAU,EAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,GAAqB,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC5E,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,IAAA,iBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,0BAAiB,CACzB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;IACJ,CAAC;IAED,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,iCAAwB,CAChC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QACzC,OAAQ,IAAgC,CAAC,OAAO,KAAK,QAAQ;QAC7D,OAAQ,IAAgC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,IAAI,sCAA6B,CACrC,qEAAqE,CACtE,CAAC;IACJ,CAAC;IAED,OAAO,IAAwB,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,QAA0B,EAAE,YAAqB;IAC5E,MAAM,IAAI,GAAG,YAAY,IAAI,6BAAqB,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAA,eAAU,EAAC,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,IAAA,cAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,+BAAsB,CAC9B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC;QAC9B,IAAA,kBAAa,EAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1E,IAAA,eAAU,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,+BAAsB;YAAE,MAAM,GAAG,CAAC;QACrD,MAAM,IAAI,2BAAkB,CAC1B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,IAAY,EAAE,MAAc,EAAE,YAAqB;IAC5E,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,8BAAqB,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG;QACxB,MAAM;QACN,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC;IAEF,kDAAkD;IAClD,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrE,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACrC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,IAAY,EAAE,YAAqB;IAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,6BAAoB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE/B,uDAAuD;IACvD,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC9B,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACrC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,IAAY,EAAE,YAAqB;IAC5D,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,6BAAoB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,YAAqB;IAChD,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,IAAY,EAAE,YAAqB;IACnE,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,6BAAoB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACrC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,YAAqB;IACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,MAAc,EAAE,YAAqB;IACvE,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,SAAS,GAAmE,IAAI,CAAC;IAErF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,sCAAsC;QACtC,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAEzD,IAAI,gBAAgB,KAAK,eAAe,IAAI,gBAAgB,CAAC,UAAU,CAAC,eAAe,GAAG,GAAG,CAAC,EAAE,CAAC;YAC/F,IAAI,CAAC,SAAS,IAAI,eAAe,CAAC,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;gBAC9D,SAAS,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,CAAC,MAAM,EAAE,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7E,CAAC"}

package/dist/config/resolver.d.ts

@@ -0,0 +1,26 @@
+import type { ResolvedProject } from '../models/project';
+/** Environment variable name for project override */
+export declare const ENV_PROJECT_VAR = "CORTEX_CLI_PROJECT";
+/** Options for project resolution */
+export interface ResolveOptions {
+    /** Explicit project name from --project flag */
+    flag?: string;
+    /** Override environment variable (for testing) */
+    envVar?: string;
+    /** Override current working directory (for testing) */
+    cwd?: string;
+    /** Override registry path (for testing) */
+    registryPath?: string;
+}
+/**
+ * Resolve which project to use.
+ *
+ * Priority cascade (AD-0005):
+ * 1. --project flag (explicit)
+ * 2. CORTEX_CLI_PROJECT environment variable
+ * 3. Default project from registry
+ * 4. Current working directory matches a registered project folder
+ * 5. Error: ProjectResolutionError (ERR-PROJ-011)
+ */
+export declare function resolveProject(opts?: ResolveOptions): ResolvedProject;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/config/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/config/resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAQzD,qDAAqD;AACrD,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,eAAe,CAoErE"}