@lwelliott/cortex-cli 1.0.3

package/dist/models/relation.js

@@ -0,0 +1,212 @@
+"use strict";
+// Relation model: CRUD operations for graph relations
+// MOD-010: Relations with constraint enforcement (AD-0017)
+// + MOD-008: Schema dependency
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRelationType = getRelationType;
+exports.createRelation = createRelation;
+exports.removeRelation = removeRelation;
+exports.queryRelations = queryRelations;
+exports.listRelationTypes = listRelationTypes;
+const retry_1 = require("../db/retry");
+const errors_1 = require("../utils/errors");
+/** Parse JSON field safely */
+function parseJson(raw, fallback) {
+    if (!raw)
+        return fallback;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return fallback;
+    }
+}
+/**
+ * Get a relation type definition by name.
+ */
+function getRelationType(db, name) {
+    const row = db.prepare(`
+    SELECT name, description, from_types, to_types, cardinality, inverse_of, created_at, updated_at
+    FROM relation_types WHERE name = ?
+  `).get(name);
+    return row;
+}
+/**
+ * Create a relation with full constraint enforcement (AD-0017).
+ * All checks run in a single transaction; inverse auto-created if defined.
+ *
+ * Validation order per AD-0017:
+ * 1. Self-relation check
+ * 2. Entity existence
+ * 3. Relation type existence
+ * 4. Type constraint
+ * 5. Cardinality constraint
+ * 6. Duplicate check
+ * 7. Insert primary
+ * 8. Insert inverse
+ */
+function createRelation(db, fromId, relType, toId, properties) {
+    return (0, retry_1.withTransaction)(db, () => {
+        // 1. Self-relation check
+        if (fromId === toId) {
+            throw new errors_1.GraphSelfRelationError(fromId, relType);
+        }
+        // 2. Document existence (SAD-0035: entities table dropped, use documents)
+        const fromDoc = db.prepare('SELECT id, type AS type_name FROM documents WHERE id = ?').get(fromId);
+        if (!fromDoc)
+            throw new errors_1.GraphEntityNotFoundError(fromId);
+        const toDoc = db.prepare('SELECT id, type AS type_name FROM documents WHERE id = ?').get(toId);
+        if (!toDoc)
+            throw new errors_1.GraphEntityNotFoundError(toId);
+        // 3. Relation type existence
+        const rt = getRelationType(db, relType);
+        if (!rt)
+            throw new errors_1.GraphRelationTypeNotFoundError(relType);
+        // 4. Type constraint check
+        const fromTypes = parseJson(rt.from_types, []);
+        const toTypes = parseJson(rt.to_types, []);
+        if (fromTypes.length > 0 && !fromTypes.includes(fromDoc.type_name)) {
+            throw new errors_1.GraphTypeConstraintError(relType, 'from', fromDoc.type_name, fromTypes);
+        }
+        if (toTypes.length > 0 && !toTypes.includes(toDoc.type_name)) {
+            throw new errors_1.GraphTypeConstraintError(relType, 'to', toDoc.type_name, toTypes);
+        }
+        // 5. Cardinality constraint check
+        enforceCardinality(db, rt, fromId, toId, relType);
+        // 6. Duplicate check
+        const existing = db.prepare('SELECT id FROM relations WHERE from_id = ? AND rel_type = ? AND to_id = ?').get(fromId, relType, toId);
+        if (existing)
+            throw new errors_1.GraphDuplicateRelationError(fromId, relType, toId);
+        const now = new Date().toISOString();
+        const propsJson = JSON.stringify(properties ?? {});
+        // 7. Insert primary relation
+        const result = db.prepare(`
+      INSERT INTO relations (from_id, rel_type, to_id, properties, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(fromId, relType, toId, propsJson, now, now);
+        const relation = {
+            id: Number(result.lastInsertRowid),
+            from_id: fromId,
+            rel_type: relType,
+            to_id: toId,
+            properties: propsJson,
+            created_at: now,
+            updated_at: now,
+        };
+        // 8. Insert inverse relation if defined
+        if (rt.inverse_of) {
+            const inverseRt = getRelationType(db, rt.inverse_of);
+            if (inverseRt) {
+                // Check cardinality for inverse too
+                enforceCardinality(db, inverseRt, toId, fromId, rt.inverse_of);
+                const existingInverse = db.prepare('SELECT id FROM relations WHERE from_id = ? AND rel_type = ? AND to_id = ?').get(toId, rt.inverse_of, fromId);
+                if (!existingInverse) {
+                    db.prepare(`
+            INSERT INTO relations (from_id, rel_type, to_id, properties, created_at, updated_at)
+            VALUES (?, ?, ?, ?, ?, ?)
+          `).run(toId, rt.inverse_of, fromId, propsJson, now, now);
+                }
+            }
+        }
+        return relation;
+    });
+}
+/**
+ * Enforce cardinality constraints for a relation type.
+ */
+function enforceCardinality(db, rt, fromId, toId, relType) {
+    const cardinality = (rt.cardinality ?? 'many_to_many');
+    switch (cardinality) {
+        case 'one_to_one': {
+            const fromCount = db.prepare('SELECT COUNT(*) as cnt FROM relations WHERE from_id = ? AND rel_type = ?').get(fromId, relType);
+            if (fromCount.cnt > 0) {
+                throw new errors_1.GraphCardinalityError(relType, cardinality, fromId);
+            }
+            const toCount = db.prepare('SELECT COUNT(*) as cnt FROM relations WHERE to_id = ? AND rel_type = ?').get(toId, relType);
+            if (toCount.cnt > 0) {
+                throw new errors_1.GraphCardinalityError(relType, cardinality, toId);
+            }
+            break;
+        }
+        case 'one_to_many': {
+            // one_to_many: each target (to_id) can have at most one incoming relation of this type
+            const toCount = db.prepare('SELECT COUNT(*) as cnt FROM relations WHERE to_id = ? AND rel_type = ?').get(toId, relType);
+            if (toCount.cnt > 0) {
+                throw new errors_1.GraphCardinalityError(relType, cardinality, toId);
+            }
+            break;
+        }
+        case 'many_to_one': {
+            // many_to_one: each source (from_id) can have at most one outgoing relation of this type
+            const fromCount = db.prepare('SELECT COUNT(*) as cnt FROM relations WHERE from_id = ? AND rel_type = ?').get(fromId, relType);
+            if (fromCount.cnt > 0) {
+                throw new errors_1.GraphCardinalityError(relType, cardinality, fromId);
+            }
+            break;
+        }
+        // many_to_many: no constraint
+    }
+}
+/**
+ * Remove a relation by ID.
+ * Also removes any inverse relation.
+ */
+function removeRelation(db, relationId) {
+    (0, retry_1.withTransaction)(db, () => {
+        const rel = db.prepare('SELECT from_id, rel_type, to_id FROM relations WHERE id = ?')
+            .get(relationId);
+        if (!rel)
+            throw new errors_1.GraphRelationNotFoundError(relationId);
+        db.prepare('DELETE FROM relations WHERE id = ?').run(relationId);
+        // Remove inverse if defined
+        const rt = getRelationType(db, rel.rel_type);
+        if (rt?.inverse_of) {
+            db.prepare('DELETE FROM relations WHERE from_id = ? AND rel_type = ? AND to_id = ?')
+                .run(rel.to_id, rt.inverse_of, rel.from_id);
+        }
+    });
+}
+/**
+ * Query relations for an entity.
+ */
+function queryRelations(db, options) {
+    const { entityId, relType, direction = 'both', limit = 100, offset = 0 } = options;
+    let sql;
+    const params = [];
+    if (relType) {
+        if (direction === 'outgoing') {
+            sql = 'SELECT * FROM relations WHERE from_id = ? AND rel_type = ? ORDER BY created_at DESC LIMIT ? OFFSET ?';
+            params.push(entityId, relType, limit, offset);
+        }
+        else if (direction === 'incoming') {
+            sql = 'SELECT * FROM relations WHERE to_id = ? AND rel_type = ? ORDER BY created_at DESC LIMIT ? OFFSET ?';
+            params.push(entityId, relType, limit, offset);
+        }
+        else {
+            sql = 'SELECT * FROM relations WHERE (from_id = ? OR to_id = ?) AND rel_type = ? ORDER BY created_at DESC LIMIT ? OFFSET ?';
+            params.push(entityId, entityId, relType, limit, offset);
+        }
+    }
+    else {
+        if (direction === 'outgoing') {
+            sql = 'SELECT * FROM relations WHERE from_id = ? ORDER BY created_at DESC LIMIT ? OFFSET ?';
+            params.push(entityId, limit, offset);
+        }
+        else if (direction === 'incoming') {
+            sql = 'SELECT * FROM relations WHERE to_id = ? ORDER BY created_at DESC LIMIT ? OFFSET ?';
+            params.push(entityId, limit, offset);
+        }
+        else {
+            sql = 'SELECT * FROM relations WHERE from_id = ? OR to_id = ? ORDER BY created_at DESC LIMIT ? OFFSET ?';
+            params.push(entityId, entityId, limit, offset);
+        }
+    }
+    return db.prepare(sql).all(...params);
+}
+/**
+ * Get all relation types.
+ */
+function listRelationTypes(db) {
+    return db.prepare('SELECT * FROM relation_types ORDER BY name').all();
+}
+//# sourceMappingURL=relation.js.map

package/dist/models/relation.js.map

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

package/dist/models/review.d.ts

@@ -0,0 +1,86 @@
+import type { ReviewType, ReviewVerdict } from './common';
+/** Review record */
+export interface Review {
+    id: number;
+    review_num: string;
+    sprint_id: string;
+    asset_name: string;
+    review_type: ReviewType;
+    verdict: ReviewVerdict;
+    critical_count: number;
+    major_count: number;
+    minor_count: number;
+    suggestion_count: number;
+    open_questions_count: number;
+    content: string;
+    asset_ref: string | null;
+    updated_at: string;
+    created_at: string;
+}
+/** Review detail (full record) */
+export interface ReviewDetail extends Review {
+}
+/** Review add options */
+export interface ReviewAddOptions {
+    assetName?: string;
+    assetRef?: string;
+    critical?: number;
+    major?: number;
+    minor?: number;
+    suggestion?: number;
+}
+/** Test report record (SAD-0031: explicit caller-provided id, task removed) */
+export interface TestReport {
+    id: string;
+    sprint_id: string;
+    module_id: string | null;
+    status: string;
+    content: string;
+    pass_count: number;
+    fail_count: number;
+    skip_count: number;
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    blocked: number;
+    result: string;
+    command: string | null;
+    duration_ms: number | null;
+    report_path: string | null;
+    updated_at: string;
+    created_at: string;
+}
+/** Test report detail */
+export interface TestReportDetail extends TestReport {
+}
+/** Test report add options (SAD-0031: task removed, content via content-file) */
+export interface TestReportAddOptions {
+    skipCount?: number;
+    command?: string;
+    duration?: number;
+    content?: string;
+}
+/** Lesson record (post-URD-026: metadata removed) */
+export interface Lesson {
+    id: number;
+    text: string;
+    description: string;
+    updated_at: string;
+    created_at: string;
+}
+/** @deprecated Lesson add options removed per URD-026 */
+export interface LessonAddOptions {
+}
+/** Lesson result (for show/update output) — content-only, no metadata */
+export interface LessonResult {
+    project_id: string;
+    content: string;
+    created_at: string;
+    updated_at: string;
+}
+/** Lesson update fields — content only, no metadata */
+export interface LessonUpdateFields {
+    content?: string;
+}
+//# sourceMappingURL=review.d.ts.map

package/dist/models/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/models/review.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE1D,oBAAoB;AACpB,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kCAAkC;AAClC,MAAM,WAAW,YAAa,SAAQ,MAAM;CAAG;AAE/C,yBAAyB;AACzB,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yBAAyB;AACzB,MAAM,WAAW,gBAAiB,SAAQ,UAAU;CAAG;AAEvD,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qDAAqD;AACrD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;CAEhC;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/models/review.js

@@ -0,0 +1,5 @@
+"use strict";
+// Review-related type definitions
+// SAD-0003: MOD-013 Review & Test Report Commands
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=review.js.map

package/dist/models/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/models/review.ts"],"names":[],"mappings":";AAAA,kCAAkC;AAClC,kDAAkD"}

package/dist/models/sprint.d.ts

@@ -0,0 +1,38 @@
+import type { SprintStatus, TaskStatus } from './common';
+/** Sprint record from database */
+export interface Sprint {
+    id: string;
+    name: string;
+    status: SprintStatus;
+    goal: string | null;
+    started_at: string | null;
+    closed_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/** Result of sprint creation */
+export interface SprintResult {
+    id: string;
+    name: string;
+    goal: string | null;
+    status: SprintStatus;
+    created_at: string;
+}
+/** Sprint overview with task counts by status */
+export interface SprintOverview {
+    id: string;
+    name: string;
+    goal: string | null;
+    status: SprintStatus;
+    taskCounts: Record<TaskStatus, number>;
+    totalTasks: number;
+    created_at: string;
+    updated_at: string;
+    closed_at: string | null;
+}
+/** Options for sprint creation */
+export interface SprintCreateOptions {
+    name?: string;
+    goal?: string;
+}
+//# sourceMappingURL=sprint.d.ts.map

package/dist/models/sprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprint.d.ts","sourceRoot":"","sources":["../../src/models/sprint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEzD,kCAAkC;AAClC,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/models/sprint.js

@@ -0,0 +1,4 @@
+"use strict";
+// Sprint-related type definitions
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sprint.js.map

package/dist/models/sprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprint.js","sourceRoot":"","sources":["../../src/models/sprint.ts"],"names":[],"mappings":";AAAA,kCAAkC"}

package/dist/models/task.d.ts

@@ -0,0 +1,75 @@
+import type { TaskType, TaskPriority, TaskStatus, RoleName, TaskStage } from './common';
+/** Task record from database */
+export interface Task {
+    id: string;
+    sprint_id: string;
+    parent_id: string | null;
+    description: string;
+    task_type: TaskType;
+    priority: TaskPriority;
+    owner: RoleName;
+    points: number;
+    status: TaskStatus;
+    stage: TaskStage;
+    session_key: string | null;
+    started_at: string | null;
+    completed_at: string | null;
+    scope_in: string | null;
+    scope_out: string | null;
+    decisions: string | null;
+    dependencies: string | null;
+    acceptance: string | null;
+    created_at: string;
+    updated_at: string;
+    removed_at: string | null;
+}
+/** Result of task creation */
+export interface TaskResult {
+    id: string;
+    sprint_id: string;
+    parent_id: string | null;
+    description: string;
+    task_type: TaskType;
+    priority: TaskPriority;
+    owner: RoleName;
+    points: number;
+    status: TaskStatus;
+    stage: TaskStage;
+    created_at: string;
+}
+/** Detailed task information for `task show` */
+export interface TaskDetail extends Task {
+    sprint_name: string | null;
+    parent_description: string | null;
+}
+/** Options for task creation */
+export interface TaskAddOptions {
+    /** Explicit task ID (4-digit zero-padded NNNN). If not provided, auto-generated. */
+    task_id?: string;
+    parent_id?: string;
+    task_type?: TaskType;
+    priority?: TaskPriority;
+    points?: number;
+    /** Initial stage (defaults to 'Planning') */
+    stage?: TaskStage;
+}
+/** Options for task move */
+export interface TaskMoveContext {
+    session_key?: string;
+    owner?: string;
+}
+/** Fields that can be updated on a task (metadata only — no stage/owner/sprint) */
+export interface TaskUpdateFields {
+    description?: string;
+    task_type?: TaskType;
+    priority?: TaskPriority;
+    points?: number;
+    scope_in?: string;
+    scope_out?: string;
+    acceptance?: string;
+    decisions?: string;
+    dependencies?: string;
+    /** Raw content from --content-file (frontmatter extraction handled by service) */
+    content_file_content?: string;
+}
+//# sourceMappingURL=task.d.ts.map

package/dist/models/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/models/task.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAExF,gCAAgC;AAChC,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,UAAW,SAAQ,IAAI;IACtC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,4BAA4B;AAC5B,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/models/task.js

@@ -0,0 +1,4 @@
+"use strict";
+// Task-related type definitions
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=task.js.map

package/dist/models/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/models/task.ts"],"names":[],"mappings":";AAAA,gCAAgC"}

package/dist/models/validation.d.ts

@@ -0,0 +1,25 @@
+/** Severity of a validation issue */
+export type IssueSeverity = 'error' | 'warning' | 'info';
+/** A single validation issue */
+export interface ValidationIssue {
+    category: string;
+    severity: IssueSeverity;
+    message: string;
+    entity?: string;
+    detail?: string;
+}
+/** Result of board validation */
+export interface ValidationResult {
+    sprint_id: string;
+    isValid: boolean;
+    issues: ValidationIssue[];
+}
+/** Result of spawn legality check */
+export interface SpawnResult {
+    sprint_id: string;
+    task_id: string;
+    isLegal: boolean;
+    verdict: 'OK' | 'ERR-SPAWN-SPRINT' | 'ERR-SPAWN-STATE' | 'ERR-SPAWN-ROLE';
+    reason?: string;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/models/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/models/validation.ts"],"names":[],"mappings":"AAEA,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,IAAI,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/models/validation.js

@@ -0,0 +1,4 @@
+"use strict";
+// Validation-related type definitions
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=validation.js.map

package/dist/models/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/models/validation.ts"],"names":[],"mappings":";AAAA,sCAAsC"}

package/dist/services/audit-check-service.d.ts

@@ -0,0 +1,16 @@
+import type Database from 'better-sqlite3';
+import type { AuditReport, AuditOptions } from './audit-checks/types';
+import { ALL_CHECK_NAMES } from './audit-checks/types';
+import { FixEngine } from './audit-checks/fix-engine';
+/**
+ * Run a full audit with the given options.
+ *
+ * @param db - Database connection
+ * @param opts - Audit options (checks, sprintId, fix, fixDryRun)
+ * @returns AuditReport with results and exit code
+ * @throws AuditUnknownCheckError if unknown check name
+ * @throws AuditSprintNotFoundError if sprint not found
+ */
+export declare function runAudit(db: Database.Database, opts: AuditOptions): AuditReport;
+export { ALL_CHECK_NAMES, FixEngine };
+//# sourceMappingURL=audit-check-service.d.ts.map

package/dist/services/audit-check-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-check-service.d.ts","sourceRoot":"","sources":["../../src/services/audit-check-service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAA+B,MAAM,sBAAsB,CAAC;AACnG,OAAO,EAAE,eAAe,EAAsB,MAAM,sBAAsB,CAAC;AAY3E,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAuBtD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,CA0F/E;AAED,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC"}