@lwelliott/cortex-cli 1.0.3

package/dist/services/review-service.js

@@ -0,0 +1,242 @@
+"use strict";
+// Review service: orchestrates review, test report, and lesson operations
+// SAD-0031: Explicit Command IDs, Duplicate ID Validation, Test-Report --task Removal
+// SAD-0010: Lesson singleton, review show sprint binding, content-file import
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addReview = addReview;
+exports.listReviews = listReviews;
+exports.getReview = getReview;
+exports.addTestReport = addTestReport;
+exports.listTestReports = listTestReports;
+exports.getTestReport = getTestReport;
+exports.addLesson = addLesson;
+exports.listLessons = listLessons;
+exports.getLesson = getLesson;
+exports.updateLesson = updateLesson;
+const errors_1 = require("../utils/errors");
+const retry_1 = require("../db/retry");
+const sprint_1 = require("./sprint");
+// ─── Error helper ───
+function reviewError(code, message, details) {
+    throw new errors_1.CortexError(code, message, details);
+}
+// ─── ID Validation ───
+const FOUR_DIGIT_ID_RE = /^\d{4}$/;
+function validateFourDigitId(id, errCtor) {
+    if (!FOUR_DIGIT_ID_RE.test(id)) {
+        throw new errCtor(id);
+    }
+}
+// ─── Review API ───
+/**
+ * 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).
+ */
+function addReview(db, sprintId, reviewId, reviewType, verdict, content, opts) {
+    // Validate sprint exists
+    (0, sprint_1.resolveSprint)(db, sprintId);
+    // Validate ID format: /^\d{4}$/
+    validateFourDigitId(reviewId, errors_1.ReviewBadIdError);
+    if (!content) {
+        throw new errors_1.ReviewContentRemovedError();
+    }
+    // Duplicate check via EXISTS on composite index (sprint_id, review_num)
+    const exists = db.prepare('SELECT EXISTS(SELECT 1 FROM reviews WHERE sprint_id = ? AND review_num = ?) AS e').get(sprintId, reviewId);
+    if (exists.e) {
+        throw new errors_1.ReviewDuplicateIdError(reviewId, sprintId);
+    }
+    const now = new Date().toISOString();
+    const rowId = (0, retry_1.withTransaction)(db, () => {
+        const result = db.prepare(`INSERT INTO reviews (review_num, sprint_id, asset_name, review_type, verdict, critical_count, major_count, minor_count, suggestion_count, open_questions_count, content, asset_ref, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(reviewId, sprintId, opts?.assetName ?? '', reviewType, verdict, opts?.critical ?? 0, opts?.major ?? 0, opts?.minor ?? 0, opts?.suggestion ?? 0, 0, content, opts?.assetRef ?? null, now, now);
+        return Number(result.lastInsertRowid);
+    });
+    return getReviewById(db, rowId);
+}
+/**
+ * List reviews for a sprint.
+ */
+function listReviews(db, sprintId, filters) {
+    const clauses = ['sprint_id = ?'];
+    const params = [sprintId];
+    if (filters?.type) {
+        clauses.push('review_type = ?');
+        params.push(filters.type);
+    }
+    if (filters?.verdict) {
+        clauses.push('verdict = ?');
+        params.push(filters.verdict);
+    }
+    return db.prepare(`SELECT * FROM reviews WHERE ${clauses.join(' AND ')} ORDER BY review_num ASC`).all(...params);
+}
+/**
+ * Show a single review by internal ID (used internally for add results).
+ */
+function getReviewById(db, id) {
+    const row = db.prepare('SELECT * FROM reviews WHERE id = ?').get(id);
+    if (!row)
+        reviewError('ERR-REVIEW-002', `Review ${id} not found`, { id });
+    return row;
+}
+/**
+ * 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
+ */
+function getReview(db, reviewNum, sprintId) {
+    // Sprint must exist
+    (0, sprint_1.resolveSprint)(db, sprintId);
+    const numStr = String(reviewNum).padStart(4, '0');
+    const row = db.prepare('SELECT * FROM reviews WHERE review_num = ? AND sprint_id = ?').get(numStr, sprintId);
+    if (!row) {
+        throw new errors_1.ReviewNotInSprintError(reviewNum, sprintId);
+    }
+    return row;
+}
+// ─── Test Report API ───
+/**
+ * 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).
+ */
+function addTestReport(db, sprintId, testReportId, total, passed, failed, opts) {
+    (0, sprint_1.resolveSprint)(db, sprintId);
+    // Validate ID format: /^\d{4}$/
+    validateFourDigitId(testReportId, errors_1.TestReportBadIdError);
+    const skipped = opts?.skipCount ?? 0;
+    // Count consistency check (FS-SS-028-0008: WRN-TEST-REPORT-001)
+    if (passed + failed + skipped !== total) {
+        console.warn(`WRN-TEST-REPORT-001: passed (${passed}) + failed (${failed}) + skipped (${skipped}) != total (${total})`);
+    }
+    const blocked = 0;
+    const computeResult = failed > 0 ? 'FAIL' : 'PASS';
+    const now = new Date().toISOString();
+    const reportContent = opts?.content ?? '';
+    // Duplicate check via EXISTS on composite index (sprint_id, id)
+    const exists = db.prepare('SELECT EXISTS(SELECT 1 FROM test_reports WHERE sprint_id = ? AND id = ?) AS e').get(sprintId, testReportId);
+    if (exists.e) {
+        throw new errors_1.TestReportDuplicateIdError(testReportId, sprintId);
+    }
+    (0, retry_1.withTransaction)(db, () => {
+        db.prepare(`INSERT INTO test_reports (id, sprint_id, total, passed, failed, skipped, blocked, result, command, duration_ms, report_path, module_id, status, content, pass_count, fail_count, skip_count, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(testReportId, sprintId, total, passed, failed, skipped, blocked, computeResult, opts?.command ?? null, opts?.duration ?? null, null, null, computeResult, reportContent, passed, failed, skipped, now, now);
+    });
+    return getTestReport(db, testReportId, sprintId);
+}
+/**
+ * List test reports. Task filter removed per SAD-0031 Part B.
+ */
+function listTestReports(db, sprintId) {
+    if (sprintId) {
+        return db.prepare('SELECT * FROM test_reports WHERE sprint_id = ? ORDER BY created_at DESC').all(sprintId);
+    }
+    return db.prepare('SELECT * FROM test_reports ORDER BY created_at DESC').all();
+}
+/**
+ * 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
+ */
+function getTestReport(db, testReportId, sprintId) {
+    const row = db.prepare('SELECT * FROM test_reports WHERE id = ? AND sprint_id = ?').get(testReportId, sprintId);
+    if (!row) {
+        reviewError('ERR-TESTREPORT-004', `Test report "${testReportId}" not found in sprint "${sprintId}"`, { testReportId, sprintId });
+    }
+    return row;
+}
+// ─── Lesson API ───
+/** Map a Lesson DB row to LessonResult (post-URD-026: content-only) */
+function mapLessonResult(row) {
+    return {
+        project_id: String(row.id),
+        content: row.description,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    };
+}
+/**
+ * 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.
+ */
+function addLesson(db, _sprintId, _title, description, _category, _opts) {
+    const now = new Date().toISOString();
+    const content = description;
+    const id = (0, retry_1.withTransaction)(db, () => {
+        const result = db.prepare(`INSERT INTO lessons (description, text, created_at, updated_at)
+       VALUES (?, ?, ?, ?)`).run(content, content, now, now);
+        return Number(result.lastInsertRowid);
+    });
+    // Re-read to get the full row
+    const row = db.prepare('SELECT * FROM lessons WHERE id = ?').get(id);
+    if (!row)
+        throw new errors_1.LessonNotFoundError();
+    return row;
+}
+/**
+ * List lessons (retained for internal use; post-URD-026 no longer sprint-scoped).
+ * Not CLI-facing.
+ */
+function listLessons(db, _sprintId) {
+    return db.prepare('SELECT * FROM lessons ORDER BY created_at ASC').all();
+}
+/**
+ * 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
+ */
+function getLesson(db) {
+    const row = db.prepare('SELECT * FROM lessons ORDER BY id LIMIT 1').get();
+    if (!row) {
+        throw new errors_1.LessonNotFoundError();
+    }
+    return mapLessonResult(row);
+}
+/**
+ * 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
+ */
+function updateLesson(db, updates) {
+    // Validate content provided
+    if (updates.content === undefined || updates.content === null || updates.content.trim().length === 0) {
+        throw new errors_1.LessonNoUpdateFieldsError();
+    }
+    const content = updates.content.trim();
+    const now = new Date().toISOString();
+    // Upsert: check if lesson exists
+    const existing = db.prepare('SELECT id FROM lessons LIMIT 1').get();
+    (0, retry_1.withTransaction)(db, () => {
+        if (existing) {
+            // Update existing lesson
+            db.prepare('UPDATE lessons SET description = ?, text = ?, updated_at = ? WHERE id = ?').run(content, content, now, existing.id);
+        }
+        else {
+            // Create new lesson (upsert — AD-0029)
+            db.prepare('INSERT INTO lessons (description, text, created_at, updated_at) VALUES (?, ?, ?, ?)').run(content, content, now, now);
+        }
+    });
+    return getLesson(db);
+}
+//# sourceMappingURL=review-service.js.map

package/dist/services/review-service.js.map

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

package/dist/services/schema-migration-service.d.ts

@@ -0,0 +1,44 @@
+import type Database from 'better-sqlite3';
+export interface MigrationResult {
+    success: boolean;
+    phases: PhaseResult[];
+    totalElapsedMs: number;
+    errors: string[];
+}
+export interface PhaseResult {
+    phase: string;
+    elapsedMs: number;
+    details: Record<string, number | string>;
+    error?: string;
+}
+export interface MigrationPhase {
+    name: string;
+    execute(db: Database.Database, projectRoot: string): PhaseResult;
+    validatePre(db: Database.Database): boolean;
+    validatePost(db: Database.Database): boolean;
+}
+export declare function getAvailablePhases(): string[];
+/**
+ * Run a single named phase. Throws if phase name is unknown.
+ */
+export declare function runPhase(db: Database.Database, phaseName: string, projectRoot: string): PhaseResult;
+/**
+ * Run the full 9-phase Sprint 31 migration on the given database.
+ * Phases execute in order. Each phase runs in its own transaction.
+ * Idempotent: phases skip work when preconditions are already met.
+ *
+ * @param db - Database connection
+ * @param projectRoot - Project root directory (for YAML/script paths in Phase 8)
+ * @returns MigrationResult with phase details and elapsed times
+ */
+export declare function runMigration(db: Database.Database, projectRoot: string): MigrationResult;
+/**
+ * Pre-migration validation: check that the database has the expected pre-migration state.
+ * (builtin:2.0 characteristics — entity_types table, 27+ relation types)
+ */
+export declare function validatePreMigration(db: Database.Database): void;
+/**
+ * Post-migration validation: verify the database is in builtin:3.0 state.
+ */
+export declare function validatePostMigration(db: Database.Database): void;
+//# sourceMappingURL=schema-migration-service.d.ts.map

package/dist/services/schema-migration-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-migration-service.d.ts","sourceRoot":"","sources":["../../src/services/schema-migration-service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAY3C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAAC;IACjE,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC5C,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC;CAC9C;AAs4BD,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAMnG;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,CAmExF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAkBhE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CA8CjE"}