@lwelliott/cortex-cli 1.0.3

package/dist/services/graph-validation-service.d.ts

@@ -0,0 +1,13 @@
+import type Database from 'better-sqlite3';
+import type { ValidationResult } from '../models/entity';
+/**
+ * Validate the entire graph for integrity violations.
+ * Read-only: does not modify any data.
+ *
+ * Checks:
+ * 1. Dangling relations (from_id or to_id references non-existent document)
+ * 2. Type constraint violations (doc type not in relation type's from_types/to_types)
+ * 3. Cardinality violations (one_to_one/one_to_many/many_to_one exceeded)
+ */
+export declare function validateGraph(db: Database.Database): ValidationResult;
+//# sourceMappingURL=graph-validation-service.d.ts.map

package/dist/services/graph-validation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-validation-service.d.ts","sourceRoot":"","sources":["../../src/services/graph-validation-service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAA2B,MAAM,kBAAkB,CAAC;AAElF;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,gBAAgB,CA2JrE"}

package/dist/services/graph-validation-service.js

@@ -0,0 +1,171 @@
+"use strict";
+// Graph validation service: read-only graph integrity checks
+// SAD-0003: MOD-011 Graph Validation
+// AD-0009: Validation services are read-only
+// SAD-0035: Updated to use documents(id) instead of entities(id)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateGraph = validateGraph;
+/**
+ * Validate the entire graph for integrity violations.
+ * Read-only: does not modify any data.
+ *
+ * Checks:
+ * 1. Dangling relations (from_id or to_id references non-existent document)
+ * 2. Type constraint violations (doc type not in relation type's from_types/to_types)
+ * 3. Cardinality violations (one_to_one/one_to_many/many_to_one exceeded)
+ */
+function validateGraph(db) {
+    const violations = [];
+    // 1. Check for dangling relations (SAD-0035: use documents instead of entities)
+    const danglingFrom = db.prepare(`
+    SELECT r.id, r.from_id, r.rel_type, r.to_id
+    FROM relations r
+    LEFT JOIN documents d ON r.from_id = d.id
+    WHERE d.id IS NULL
+  `).all();
+    for (const rel of danglingFrom) {
+        violations.push({
+            type: 'dangling',
+            relationId: rel.id,
+            fromId: rel.from_id,
+            relType: rel.rel_type,
+            toId: rel.to_id,
+            message: `Relation ${rel.id}: from_id "${rel.from_id}" references non-existent document`,
+        });
+    }
+    const danglingTo = db.prepare(`
+    SELECT r.id, r.from_id, r.rel_type, r.to_id
+    FROM relations r
+    LEFT JOIN documents d ON r.to_id = d.id
+    WHERE d.id IS NULL
+  `).all();
+    for (const rel of danglingTo) {
+        violations.push({
+            type: 'dangling',
+            relationId: rel.id,
+            fromId: rel.from_id,
+            relType: rel.rel_type,
+            toId: rel.to_id,
+            message: `Relation ${rel.id}: to_id "${rel.to_id}" references non-existent document`,
+        });
+    }
+    // 2. Check type constraint violations (SAD-0035: use documents instead of entities)
+    const relationTypes = db.prepare('SELECT * FROM relation_types').all();
+    const relations = db.prepare('SELECT r.id, r.from_id, r.rel_type, r.to_id, d_from.type as from_type, d_to.type as to_type FROM relations r LEFT JOIN documents d_from ON r.from_id = d_from.id LEFT JOIN documents d_to ON r.to_id = d_to.id').all();
+    for (const rel of relations) {
+        const rt = relationTypes.find(t => t.name === rel.rel_type);
+        if (!rt)
+            continue;
+        const fromTypes = safeParseJson(rt.from_types, []);
+        const toTypes = safeParseJson(rt.to_types, []);
+        if (fromTypes.length > 0 && rel.from_type && !fromTypes.includes(rel.from_type)) {
+            violations.push({
+                type: 'type_constraint',
+                relationId: rel.id,
+                fromId: rel.from_id,
+                relType: rel.rel_type,
+                toId: rel.to_id,
+                message: `Relation ${rel.id}: from entity type "${rel.from_type}" not in allowed types [${fromTypes.join(', ')}]`,
+            });
+        }
+        if (toTypes.length > 0 && rel.to_type && !toTypes.includes(rel.to_type)) {
+            violations.push({
+                type: 'type_constraint',
+                relationId: rel.id,
+                fromId: rel.from_id,
+                relType: rel.rel_type,
+                toId: rel.to_id,
+                message: `Relation ${rel.id}: to entity type "${rel.to_type}" not in allowed types [${toTypes.join(', ')}]`,
+            });
+        }
+    }
+    // 3. Check cardinality violations
+    for (const rt of relationTypes) {
+        const cardinality = (rt.cardinality ?? 'many_to_many');
+        if (cardinality === 'many_to_many')
+            continue;
+        if (cardinality === 'one_to_one') {
+            const violators = db.prepare(`
+        SELECT from_id, rel_type, COUNT(*) as cnt
+        FROM relations WHERE rel_type = ?
+        GROUP BY from_id HAVING cnt > 1
+      `).all(rt.name);
+            for (const v of violators) {
+                violations.push({
+                    type: 'cardinality',
+                    relationId: 0,
+                    fromId: v.from_id,
+                    relType: v.rel_type,
+                    toId: '',
+                    message: `Cardinality one_to_one violated: entity "${v.from_id}" has ${v.cnt} outgoing "${v.rel_type}" relations`,
+                });
+            }
+            const violatorsTo = db.prepare(`
+        SELECT to_id, rel_type, COUNT(*) as cnt
+        FROM relations WHERE rel_type = ?
+        GROUP BY to_id HAVING cnt > 1
+      `).all(rt.name);
+            for (const v of violatorsTo) {
+                violations.push({
+                    type: 'cardinality',
+                    relationId: 0,
+                    fromId: '',
+                    relType: v.rel_type,
+                    toId: v.to_id,
+                    message: `Cardinality one_to_one violated: entity "${v.to_id}" has ${v.cnt} incoming "${v.rel_type}" relations`,
+                });
+            }
+        }
+        if (cardinality === 'one_to_many') {
+            // one_to_many: each target (to_id) can have at most one incoming relation of this type
+            const violatorsTo = db.prepare(`
+        SELECT to_id, rel_type, COUNT(*) as cnt
+        FROM relations WHERE rel_type = ?
+        GROUP BY to_id HAVING cnt > 1
+      `).all(rt.name);
+            for (const v of violatorsTo) {
+                violations.push({
+                    type: 'cardinality',
+                    relationId: 0,
+                    fromId: '',
+                    relType: v.rel_type,
+                    toId: v.to_id,
+                    message: `Cardinality one_to_many violated: entity "${v.to_id}" has ${v.cnt} incoming "${v.rel_type}" relations`,
+                });
+            }
+        }
+        if (cardinality === 'many_to_one') {
+            // many_to_one: each source (from_id) can have at most one outgoing relation of this type
+            const violators = db.prepare(`
+        SELECT from_id, rel_type, COUNT(*) as cnt
+        FROM relations WHERE rel_type = ?
+        GROUP BY from_id HAVING cnt > 1
+      `).all(rt.name);
+            for (const v of violators) {
+                violations.push({
+                    type: 'cardinality',
+                    relType: v.rel_type,
+                    relationId: 0,
+                    fromId: v.from_id,
+                    toId: '',
+                    message: `Cardinality many_to_one violated: entity "${v.from_id}" has ${v.cnt} outgoing "${v.rel_type}" relations`,
+                });
+            }
+        }
+    }
+    return {
+        valid: violations.length === 0,
+        violations,
+    };
+}
+function safeParseJson(raw, fallback) {
+    if (!raw)
+        return fallback;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return fallback;
+    }
+}
+//# sourceMappingURL=graph-validation-service.js.map

package/dist/services/graph-validation-service.js.map

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

package/dist/services/project.d.ts

@@ -0,0 +1,80 @@
+import type { ProjectResult, ProjectInfo, ProjectsRegistry } from '../models/project';
+import { resolveProject } from '../config/resolver';
+/** Options for project operations */
+export interface ProjectServiceOptions {
+    /** Override registry path (for testing) */
+    registryPath?: string;
+    /** Override cwd for resolution (for testing) */
+    cwd?: string;
+}
+/**
+ * Validate project name format per FR-URD-002-0011:
+ * - Lowercase alphanumeric and hyphens only
+ * - Starts with a letter
+ * - Ends with a letter or digit
+ * - No consecutive hyphens
+ * - 1–64 characters
+ *
+ * @throws ProjectEmptyNameError (ERR-PROJ-003) if name is empty/whitespace
+ * @throws ProjectInvalidNameError (ERR-PROJ-008) if name format is invalid
+ */
+export declare function validateProjectName(name: string): void;
+/**
+ * Create a new project: make the folder, initialize pmp/project.db,
+ * register in ~/.config/cortex-cli/registry.json.
+ *
+ * @throws ProjectEmptyNameError (ERR-PROJ-003) if name is empty
+ * @throws ProjectInvalidNameError (ERR-PROJ-008) if name format is invalid
+ * @throws DuplicateProjectError (ERR-PROJ-001) if the project name already exists
+ * @throws ProjectPathExistsError (ERR-PROJ-002) if the folder path already exists (directory)
+ * @throws ProjectPathNotDirectoryError (ERR-PROJ-013) if the path exists as a file/symlink
+ */
+export declare function createProject(name: string, folder: string, opts?: ProjectServiceOptions): ProjectResult;
+/**
+ * Register an existing project folder.
+ * Creates pmp/project.db if it doesn't exist.
+ * Adds to ~/.config/cortex-cli/registry.json.
+ *
+ * @throws ProjectEmptyNameError (ERR-PROJ-003) if name is empty
+ * @throws ProjectInvalidNameError (ERR-PROJ-008) if name format is invalid
+ * @throws DuplicateProjectError (ERR-PROJ-001) if the project name already exists
+ * @throws ProjectFolderNotFoundError (ERR-PROJ-005) if the folder doesn't exist
+ */
+export declare function registerProject(name: string, folder: string, opts?: ProjectServiceOptions): ProjectResult;
+/**
+ * Remove a project from the global registry.
+ * Does NOT delete the project folder or database.
+ *
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+export declare function removeProject(name: string, opts?: ProjectServiceOptions): {
+    name: string;
+    folder: string;
+    dbPath: string;
+};
+/**
+ * List all registered projects.
+ */
+export declare function listAllProjects(opts?: ProjectServiceOptions): ProjectsRegistry;
+/**
+ * Set the default project.
+ *
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+export declare function setProjectDefault(name: string, opts?: ProjectServiceOptions): void;
+/**
+ * Get the current default project name.
+ */
+export declare function getDefaultProjectName(opts?: ProjectServiceOptions): string | null;
+/**
+ * Show project details: folder, database path, sprint summary, entity counts.
+ *
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+export declare function getProjectInfo(name: string, opts?: ProjectServiceOptions): ProjectInfo;
+/**
+ * Resolve the project to use for a command.
+ * Delegates to ProjectResolver.
+ */
+export declare function resolveProjectForCommand(opts?: ProjectServiceOptions): ReturnType<typeof resolveProject>;
+//# sourceMappingURL=project.d.ts.map

package/dist/services/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/services/project.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAWtF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAYpD,qCAAqC;AACrC,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA4BtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,aAAa,CA2DvG;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,aAAa,CA2CzG;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAS1H;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,gBAAgB,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAElF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAGjF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,WAAW,CAmCtF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAKxG"}

package/dist/services/project.js

@@ -0,0 +1,256 @@
+"use strict";
+// Project service: orchestrates database and registry
+// Implements AD-0004: ProjectService Orchestrates Database and Registry
+// + FS-SS-002-0001 (create), FS-SS-002-0002 (register)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateProjectName = validateProjectName;
+exports.createProject = createProject;
+exports.registerProject = registerProject;
+exports.removeProject = removeProject;
+exports.listAllProjects = listAllProjects;
+exports.setProjectDefault = setProjectDefault;
+exports.getDefaultProjectName = getDefaultProjectName;
+exports.getProjectInfo = getProjectInfo;
+exports.resolveProjectForCommand = resolveProjectForCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const connection_1 = require("../db/connection");
+const migration_1 = require("../db/migration");
+const registry_1 = require("../config/registry");
+const resolver_1 = require("../config/resolver");
+const errors_1 = require("../utils/errors");
+/**
+ * Validate project name format per FR-URD-002-0011:
+ * - Lowercase alphanumeric and hyphens only
+ * - Starts with a letter
+ * - Ends with a letter or digit
+ * - No consecutive hyphens
+ * - 1–64 characters
+ *
+ * @throws ProjectEmptyNameError (ERR-PROJ-003) if name is empty/whitespace
+ * @throws ProjectInvalidNameError (ERR-PROJ-008) if name format is invalid
+ */
+function validateProjectName(name) {
+    if (!name || name.trim().length === 0) {
+        throw new errors_1.ProjectEmptyNameError();
+    }
+    // Single character: just needs to be a lowercase letter
+    if (name.length === 1) {
+        if (!/^[a-z]$/.test(name)) {
+            throw new errors_1.ProjectInvalidNameError(name);
+        }
+        return;
+    }
+    // Multi-character: full regex
+    // /^[a-z][a-z0-9-]{0,62}[a-z0-9]$/ plus no consecutive hyphens
+    if (!/^[a-z][a-z0-9-]{0,62}[a-z0-9]$/.test(name)) {
+        throw new errors_1.ProjectInvalidNameError(name);
+    }
+    // Check for consecutive hyphens
+    if (name.includes('--')) {
+        throw new errors_1.ProjectInvalidNameError(name);
+    }
+    // Check total length (1-64)
+    if (name.length > 64) {
+        throw new errors_1.ProjectInvalidNameError(name);
+    }
+}
+/**
+ * Create a new project: make the folder, initialize pmp/project.db,
+ * register in ~/.config/cortex-cli/registry.json.
+ *
+ * @throws ProjectEmptyNameError (ERR-PROJ-003) if name is empty
+ * @throws ProjectInvalidNameError (ERR-PROJ-008) if name format is invalid
+ * @throws DuplicateProjectError (ERR-PROJ-001) if the project name already exists
+ * @throws ProjectPathExistsError (ERR-PROJ-002) if the folder path already exists (directory)
+ * @throws ProjectPathNotDirectoryError (ERR-PROJ-013) if the path exists as a file/symlink
+ */
+function createProject(name, folder, opts) {
+    // Validate name format (FS-SS-002-0001 VR-003/VR-006)
+    validateProjectName(name);
+    // Check for duplicate name
+    try {
+        const existing = (0, registry_1.getProject)(name, opts?.registryPath);
+        if (existing) {
+            throw new errors_1.DuplicateProjectError(name);
+        }
+    }
+    catch (err) {
+        // ProjectNotFoundError is expected if name doesn't exist yet
+        if (!(err instanceof errors_1.ProjectNotFoundError))
+            throw err;
+    }
+    const absoluteFolder = (0, path_1.resolve)(folder);
+    // Check if path already exists (FS-SS-002-0001 VR-002)
+    if ((0, fs_1.existsSync)(absoluteFolder)) {
+        const stat = (0, fs_1.lstatSync)(absoluteFolder);
+        if (stat.isDirectory()) {
+            throw new errors_1.ProjectPathExistsError(absoluteFolder);
+        }
+        else {
+            throw new errors_1.ProjectPathNotDirectoryError(absoluteFolder);
+        }
+    }
+    // Create the project folder
+    try {
+        (0, fs_1.mkdirSync)(absoluteFolder, { recursive: true });
+    }
+    catch (err) {
+        throw new errors_1.ProjectFolderCreateError(absoluteFolder, err instanceof Error ? err.message : String(err));
+    }
+    const dbPath = `${absoluteFolder}/pmp/project.db`;
+    const dbExisted = (0, fs_1.existsSync)(dbPath);
+    // Initialize the database
+    const db = (0, connection_1.openConnection)(dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+    }
+    finally {
+        db.close();
+    }
+    // Register in global registry
+    const registry = (0, registry_1.addProject)(name, absoluteFolder, opts?.registryPath);
+    const isDefault = registry.default === name;
+    return {
+        name,
+        folder: absoluteFolder,
+        dbPath,
+        isNew: !dbExisted,
+        isDefault,
+    };
+}
+/**
+ * Register an existing project folder.
+ * Creates pmp/project.db if it doesn't exist.
+ * Adds to ~/.config/cortex-cli/registry.json.
+ *
+ * @throws ProjectEmptyNameError (ERR-PROJ-003) if name is empty
+ * @throws ProjectInvalidNameError (ERR-PROJ-008) if name format is invalid
+ * @throws DuplicateProjectError (ERR-PROJ-001) if the project name already exists
+ * @throws ProjectFolderNotFoundError (ERR-PROJ-005) if the folder doesn't exist
+ */
+function registerProject(name, folder, opts) {
+    // Validate name format (FS-SS-002-0002 VR-005)
+    validateProjectName(name);
+    // Check for duplicate name
+    try {
+        const existing = (0, registry_1.getProject)(name, opts?.registryPath);
+        if (existing) {
+            throw new errors_1.DuplicateProjectError(name);
+        }
+    }
+    catch (err) {
+        if (!(err instanceof errors_1.ProjectNotFoundError))
+            throw err;
+    }
+    const absoluteFolder = (0, path_1.resolve)(folder);
+    // Verify folder exists (FS-SS-002-0002 VR-001)
+    if (!(0, fs_1.existsSync)(absoluteFolder)) {
+        throw new errors_1.ProjectFolderNotFoundError(absoluteFolder);
+    }
+    const dbPath = `${absoluteFolder}/pmp/project.db`;
+    const dbExisted = (0, fs_1.existsSync)(dbPath);
+    // Initialize the database
+    const db = (0, connection_1.openConnection)(dbPath);
+    try {
+        (0, migration_1.initializeSchema)(db);
+    }
+    finally {
+        db.close();
+    }
+    // Register in global registry
+    const registry = (0, registry_1.addProject)(name, absoluteFolder, opts?.registryPath);
+    const isDefault = registry.default === name;
+    return {
+        name,
+        folder: absoluteFolder,
+        dbPath,
+        isNew: !dbExisted,
+        isDefault,
+    };
+}
+/**
+ * Remove a project from the global registry.
+ * Does NOT delete the project folder or database.
+ *
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+function removeProject(name, opts) {
+    const entry = (0, registry_1.getProject)(name, opts?.registryPath);
+    (0, registry_1.removeProject)(name, opts?.registryPath);
+    return {
+        name,
+        folder: entry.folder,
+        dbPath: `${entry.folder}/pmp/project.db`,
+    };
+}
+/**
+ * List all registered projects.
+ */
+function listAllProjects(opts) {
+    return (0, registry_1.listProjects)(opts?.registryPath);
+}
+/**
+ * Set the default project.
+ *
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+function setProjectDefault(name, opts) {
+    (0, registry_1.setDefaultProject)(name, opts?.registryPath);
+}
+/**
+ * Get the current default project name.
+ */
+function getDefaultProjectName(opts) {
+    const registry = (0, registry_1.loadRegistry)(opts?.registryPath);
+    return registry.default;
+}
+/**
+ * Show project details: folder, database path, sprint summary, entity counts.
+ *
+ * @throws ProjectNotFoundError (ERR-PROJ-007) if the project doesn't exist
+ */
+function getProjectInfo(name, opts) {
+    const entry = (0, registry_1.getProject)(name, opts?.registryPath);
+    const registry = (0, registry_1.loadRegistry)(opts?.registryPath);
+    const dbPath = `${entry.folder}/pmp/project.db`;
+    const isDefault = registry.default === name;
+    // Query the database for summary counts
+    let sprintCount = 0;
+    let activeSprintCount = 0;
+    let docCount = 0;
+    let taskCount = 0;
+    if ((0, fs_1.existsSync)(dbPath)) {
+        const db = (0, connection_1.openConnection)(dbPath);
+        try {
+            sprintCount = db.prepare('SELECT COUNT(*) as c FROM sprints').get().c;
+            activeSprintCount = db.prepare("SELECT COUNT(*) as c FROM sprints WHERE status IN ('PLANNING','IN EXECUTION','CLOSING')").get().c;
+            docCount = db.prepare('SELECT COUNT(*) as c FROM documents').get().c;
+            taskCount = db.prepare('SELECT COUNT(*) as c FROM tasks').get().c;
+        }
+        finally {
+            db.close();
+        }
+    }
+    return {
+        name,
+        folder: entry.folder,
+        dbPath,
+        isDefault,
+        sprintCount,
+        activeSprintCount,
+        docCount,
+        taskCount,
+    };
+}
+/**
+ * Resolve the project to use for a command.
+ * Delegates to ProjectResolver.
+ */
+function resolveProjectForCommand(opts) {
+    return (0, resolver_1.resolveProject)({
+        registryPath: opts?.registryPath,
+        cwd: opts?.cwd,
+    });
+}
+//# sourceMappingURL=project.js.map

package/dist/services/project.js.map

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

package/dist/services/review-service.d.ts

@@ -0,0 +1,81 @@
+import type Database from 'better-sqlite3';
+import type { Review, ReviewDetail, ReviewAddOptions, TestReport, TestReportAddOptions, Lesson, LessonAddOptions, LessonResult, LessonUpdateFields } from '../models/review';
+/**
+ * Add a review with explicit caller-provided 4-digit ID.
+ * Content must be provided (from --content-file).
+ *
+ * SAD-0031 Part A: No advisory lock — caller provides explicit ID.
+ * Duplicate validation via EXISTS on composite index (sprint_id, review_num).
+ */
+export declare function addReview(db: Database.Database, sprintId: string, reviewId: string, reviewType: string, verdict: string, content: string, opts?: ReviewAddOptions): Review;
+/**
+ * List reviews for a sprint.
+ */
+export declare function listReviews(db: Database.Database, sprintId: string, filters?: {
+    type?: string;
+    verdict?: string;
+}): Review[];
+/**
+ * Get a review by review number within a sprint (SAD-0010 Part C).
+ * Both reviewNum and sprintId are required.
+ *
+ * @param db - Database connection
+ * @param reviewNum - Review number (1-based, displayed to user)
+ * @param sprintId - Sprint ID (required)
+ * @returns Review detail
+ * @throws ReviewNotInSprintError if review not found in the specified sprint
+ */
+export declare function getReview(db: Database.Database, reviewNum: number, sprintId: string): ReviewDetail;
+/**
+ * Add a test report with explicit caller-provided 4-digit ID.
+ * SAD-0031 Part A: No advisory lock, no task association.
+ * Duplicate validation via EXISTS on composite index (sprint_id, id).
+ */
+export declare function addTestReport(db: Database.Database, sprintId: string, testReportId: string, total: number, passed: number, failed: number, opts?: TestReportAddOptions): TestReport;
+/**
+ * List test reports. Task filter removed per SAD-0031 Part B.
+ */
+export declare function listTestReports(db: Database.Database, sprintId?: string): TestReport[];
+/**
+ * Get a single test report by caller-provided ID and sprint.
+ * SAD-0031 Part A: sprint-scoped lookup by explicit ID string.
+ *
+ * @param db - Database connection
+ * @param testReportId - Caller-provided test report ID (e.g., "0001")
+ * @param sprintId - Sprint ID (required per URD-026)
+ * @returns Test report
+ * @throws error with ERR-TESTREPORT-004 if not found
+ */
+export declare function getTestReport(db: Database.Database, testReportId: string, sprintId: string): TestReport;
+/**
+ * Add a lesson (retained for internal use, e.g., sprint lessons-data export).
+ * Not CLI-facing — the CLI exposes only show and update.
+ * Post-URD-026: metadata removed, content-only.
+ */
+export declare function addLesson(db: Database.Database, _sprintId: string, _title: string, description: string, _category: string, _opts?: LessonAddOptions): Lesson;
+/**
+ * List lessons (retained for internal use; post-URD-026 no longer sprint-scoped).
+ * Not CLI-facing.
+ */
+export declare function listLessons(db: Database.Database, _sprintId?: string): Lesson[];
+/**
+ * Get the project's single lesson (singleton pattern, SAD-0010 Part B).
+ * No ID argument — exactly one lesson per project.
+ *
+ * @param db - Database connection
+ * @returns LessonResult
+ * @throws LessonNotFoundError (ERR-LESSON-001) if no lesson exists
+ */
+export declare function getLesson(db: Database.Database): LessonResult;
+/**
+ * Update the project's single lesson (singleton pattern, post-URD-026).
+ * Upsert semantics per AD-0029: creates if absent, updates if exists.
+ * Content-only — all metadata fields removed (URD-026 Part B).
+ *
+ * @param db - Database connection
+ * @param updates - Fields to update; content required
+ * @returns Updated LessonResult
+ * @throws LessonNoUpdateFieldsError if content is empty/missing
+ */
+export declare function updateLesson(db: Database.Database, updates: LessonUpdateFields): LessonResult;
+//# sourceMappingURL=review-service.d.ts.map

package/dist/services/review-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-service.d.ts","sourceRoot":"","sources":["../../src/services/review-service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAiC7K;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,gBAAgB,GACtB,MAAM,CAuCR;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,MAAM,EAAE,CAUV;AAWD;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAalG;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,oBAAoB,GAC1B,UAAU,CAsCZ;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,EAAE,CAOd;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAQvG;AAcD;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,gBAAgB,GACvB,MAAM,CAgBR;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/E;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,YAAY,CAM7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,kBAAkB,GAC1B,YAAY,CA2Bd"}