@lwelliott/cortex-cli 1.0.3

package/dist/config/resolver.js

@@ -0,0 +1,87 @@
+"use strict";
+// Project resolution logic
+// Implements AD-0005: Project Resolution Cascade
+// Resolution order: --project flag → env var → default → CWD → error
+// + FS-SS-002-0007 (error codes), FS-SS-002-0008 (resolution error)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENV_PROJECT_VAR = void 0;
+exports.resolveProject = resolveProject;
+const errors_1 = require("../utils/errors");
+const registry_1 = require("./registry");
+/** Environment variable name for project override */
+exports.ENV_PROJECT_VAR = 'CORTEX_CLI_PROJECT';
+/**
+ * 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)
+ */
+function resolveProject(opts) {
+    const options = opts ?? {};
+    const registry = (0, registry_1.loadRegistry)(options.registryPath);
+    // Track attempted methods for error reporting (FS-SS-002-0008 VR-001)
+    const attemptedMethods = [];
+    // 1. Check --project flag
+    if (options.flag) {
+        const entry = registry.projects[options.flag];
+        if (!entry) {
+            throw new errors_1.ProjectFlagNotFoundError(options.flag);
+        }
+        return {
+            name: options.flag,
+            folder: entry.folder,
+            dbPath: `${entry.folder}/pmp/project.db`,
+            resolutionMethod: 'flag',
+        };
+    }
+    // 2. Check environment variable
+    const envProject = options.envVar ?? process.env[exports.ENV_PROJECT_VAR];
+    if (envProject) {
+        const entry = registry.projects[envProject];
+        if (!entry) {
+            throw new errors_1.ProjectEnvNotFoundError(envProject);
+        }
+        return {
+            name: envProject,
+            folder: entry.folder,
+            dbPath: `${entry.folder}/pmp/project.db`,
+            resolutionMethod: 'env',
+        };
+    }
+    attemptedMethods.push('CORTEX_CLI_PROJECT not set');
+    // 3. Check default project
+    if (registry.default) {
+        const entry = registry.projects[registry.default];
+        if (entry) {
+            return {
+                name: registry.default,
+                folder: entry.folder,
+                dbPath: `${entry.folder}/pmp/project.db`,
+                resolutionMethod: 'default',
+            };
+        }
+        attemptedMethods.push(`default '${registry.default}' not in registry`);
+    }
+    else {
+        attemptedMethods.push('no default project configured');
+    }
+    // 4. Check CWD match
+    const cwd = options.cwd ?? process.cwd();
+    const match = (0, registry_1.findProjectByFolder)(cwd, options.registryPath);
+    if (match) {
+        return {
+            name: match.name,
+            folder: match.entry.folder,
+            dbPath: `${match.entry.folder}/pmp/project.db`,
+            resolutionMethod: 'cwd',
+        };
+    }
+    attemptedMethods.push(`CWD '${cwd}' not inside any registered project`);
+    // 5. No project found — list attempted methods (FS-SS-002-0008 VR-001)
+    throw new errors_1.ProjectResolutionError(attemptedMethods);
+}
+//# sourceMappingURL=resolver.js.map

package/dist/config/resolver.js.map

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

package/dist/db/builtin-schema-constants.d.ts

@@ -0,0 +1,109 @@
+export declare const ENTITY_TYPES: readonly [{
+    readonly name: "Person";
+    readonly description: "A human agent (analyst, architect, coder, tester, captain)";
+    readonly required_fields: {};
+}, {
+    readonly name: "Project";
+    readonly description: "A cortex-cli project workspace";
+    readonly required_fields: {};
+}, {
+    readonly name: "Sprint";
+    readonly description: "A named sprint with a status lifecycle";
+    readonly required_fields: {};
+}, {
+    readonly name: "Task";
+    readonly description: "A work item belonging to a sprint";
+    readonly required_fields: {};
+}, {
+    readonly name: "Document";
+    readonly description: "A registered document artifact";
+    readonly required_fields: {};
+}, {
+    readonly name: "Review";
+    readonly description: "A review record with verdict";
+    readonly required_fields: {};
+}, {
+    readonly name: "TestReport";
+    readonly description: "A test execution report";
+    readonly required_fields: {};
+}, {
+    readonly name: "Lesson";
+    readonly description: "A lessons-learned entry";
+    readonly required_fields: {};
+}, {
+    readonly name: "Bug";
+    readonly description: "A tracked bug";
+    readonly required_fields: {};
+}, {
+    readonly name: "SourceFile";
+    readonly description: "A source code file";
+    readonly required_fields: {};
+}, {
+    readonly name: "Decision";
+    readonly description: "An architecture or design decision";
+    readonly required_fields: {};
+}];
+export declare const RELATION_TYPES: readonly [{
+    readonly name: "has_member";
+    readonly from_types: readonly ["Sprint"];
+    readonly to_types: readonly ["Task"];
+    readonly cardinality: "one_to_many";
+    readonly description: "Sprint contains tasks";
+}, {
+    readonly name: "depends_on";
+    readonly from_types: readonly ["Task"];
+    readonly to_types: readonly ["Task"];
+    readonly cardinality: "many_to_many";
+    readonly description: "Task dependency";
+}, {
+    readonly name: "relates_to";
+    readonly from_types: readonly ["Task"];
+    readonly to_types: readonly ["Task"];
+    readonly cardinality: "many_to_many";
+    readonly description: "Generic task relation";
+}, {
+    readonly name: "written_by";
+    readonly from_types: readonly ["Document"];
+    readonly to_types: readonly ["Person"];
+    readonly cardinality: "many_to_one";
+    readonly description: "Document author";
+}, {
+    readonly name: "reviewed_by";
+    readonly from_types: readonly ["Document"];
+    readonly to_types: readonly ["Review"];
+    readonly cardinality: "many_to_one";
+    readonly description: "Review of a document";
+}, {
+    readonly name: "approved_by";
+    readonly from_types: readonly ["Review"];
+    readonly to_types: readonly ["Person"];
+    readonly cardinality: "many_to_one";
+    readonly description: "Reviewer who gave verdict";
+}, {
+    readonly name: "tracks";
+    readonly from_types: readonly ["Bug"];
+    readonly to_types: readonly ["Task"];
+    readonly cardinality: "many_to_one";
+    readonly description: "Bug is tracked by a task";
+}, {
+    readonly name: "implements";
+    readonly from_types: readonly ["SourceFile"];
+    readonly to_types: readonly ["Task"];
+    readonly cardinality: "many_to_one";
+    readonly description: "Source file implements a task";
+}, {
+    readonly name: "decides";
+    readonly from_types: readonly ["Person"];
+    readonly to_types: readonly ["Decision"];
+    readonly cardinality: "many_to_one";
+    readonly description: "Person made a decision";
+}, {
+    readonly name: "contains";
+    readonly from_types: readonly ["Project"];
+    readonly to_types: readonly ["Document"];
+    readonly cardinality: "one_to_many";
+    readonly description: "Project contains document";
+}];
+export type BuiltinEntityType = typeof ENTITY_TYPES[number];
+export type BuiltinRelationType = typeof RELATION_TYPES[number];
+//# sourceMappingURL=builtin-schema-constants.d.ts.map

package/dist/db/builtin-schema-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-schema-constants.d.ts","sourceRoot":"","sources":["../../src/db/builtin-schema-constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYf,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWjB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/dist/db/builtin-schema-constants.js

@@ -0,0 +1,32 @@
+"use strict";
+// Builtin graph schema constants
+// URD-003 §4: Predefined entity types and relation types
+// Used by initializeBuiltinSchema() in migration.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RELATION_TYPES = exports.ENTITY_TYPES = void 0;
+exports.ENTITY_TYPES = [
+    { name: 'Person', description: 'A human agent (analyst, architect, coder, tester, captain)', required_fields: {} },
+    { name: 'Project', description: 'A cortex-cli project workspace', required_fields: {} },
+    { name: 'Sprint', description: 'A named sprint with a status lifecycle', required_fields: {} },
+    { name: 'Task', description: 'A work item belonging to a sprint', required_fields: {} },
+    { name: 'Document', description: 'A registered document artifact', required_fields: {} },
+    { name: 'Review', description: 'A review record with verdict', required_fields: {} },
+    { name: 'TestReport', description: 'A test execution report', required_fields: {} },
+    { name: 'Lesson', description: 'A lessons-learned entry', required_fields: {} },
+    { name: 'Bug', description: 'A tracked bug', required_fields: {} },
+    { name: 'SourceFile', description: 'A source code file', required_fields: {} },
+    { name: 'Decision', description: 'An architecture or design decision', required_fields: {} },
+];
+exports.RELATION_TYPES = [
+    { name: 'has_member', from_types: ['Sprint'], to_types: ['Task'], cardinality: 'one_to_many', description: 'Sprint contains tasks' },
+    { name: 'depends_on', from_types: ['Task'], to_types: ['Task'], cardinality: 'many_to_many', description: 'Task dependency' },
+    { name: 'relates_to', from_types: ['Task'], to_types: ['Task'], cardinality: 'many_to_many', description: 'Generic task relation' },
+    { name: 'written_by', from_types: ['Document'], to_types: ['Person'], cardinality: 'many_to_one', description: 'Document author' },
+    { name: 'reviewed_by', from_types: ['Document'], to_types: ['Review'], cardinality: 'many_to_one', description: 'Review of a document' },
+    { name: 'approved_by', from_types: ['Review'], to_types: ['Person'], cardinality: 'many_to_one', description: 'Reviewer who gave verdict' },
+    { name: 'tracks', from_types: ['Bug'], to_types: ['Task'], cardinality: 'many_to_one', description: 'Bug is tracked by a task' },
+    { name: 'implements', from_types: ['SourceFile'], to_types: ['Task'], cardinality: 'many_to_one', description: 'Source file implements a task' },
+    { name: 'decides', from_types: ['Person'], to_types: ['Decision'], cardinality: 'many_to_one', description: 'Person made a decision' },
+    { name: 'contains', from_types: ['Project'], to_types: ['Document'], cardinality: 'one_to_many', description: 'Project contains document' },
+];
+//# sourceMappingURL=builtin-schema-constants.js.map

package/dist/db/builtin-schema-constants.js.map

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

package/dist/db/connection.d.ts

@@ -0,0 +1,34 @@
+import Database from 'better-sqlite3';
+export interface ConnectionOptions {
+    /** Enable WAL mode (default: true) */
+    walMode?: boolean;
+    /** Busy timeout in ms (default: 5000) */
+    busyTimeout?: number;
+    /** Foreign keys enabled (default: true) */
+    foreignKeys?: boolean;
+    /** Journal mode (overrides walMode if set) */
+    journalMode?: string;
+    /** Synchronous mode (default: 'NORMAL') */
+    synchronous?: string;
+}
+/**
+ * Open a SQLite database connection with proper configuration.
+ * Creates parent directories if they don't exist (for file-based databases).
+ *
+ * @param dbPath - Path to the database file, or ':memory:' for in-memory
+ * @param options - Connection configuration options
+ * @returns Configured better-sqlite3 Database instance
+ * @throws ERR-DB-001 through ERR-DB-004, ERR-CONN-001, ERR-CONN-002
+ */
+export declare function openConnection(dbPath: string, options?: ConnectionOptions): Database.Database;
+/**
+ * Verify that a database connection is properly configured.
+ * Returns an object with the current pragma settings.
+ */
+export declare function verifyConnection(db: Database.Database): {
+    journalMode: string;
+    busyTimeout: number;
+    foreignKeys: number;
+    synchronous: number;
+};
+//# sourceMappingURL=connection.d.ts.map

package/dist/db/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAKA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAYtC,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiDD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,QAAQ,CAAC,QAAQ,CAyE7F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAOA"}

package/dist/db/connection.js

@@ -0,0 +1,140 @@
+"use strict";
+// SQLite connection factory with WAL mode, busy retry, and pragmas
+// Implements AD-0003: WAL Mode with Busy Timeout and Exponential Backoff
+// + FS-SS-001-0001 error codes (ERR-DB-001 through ERR-DB-004)
+// + FS-SS-001-0003 (ERR-CONN-001, ERR-CONN-002)
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openConnection = openConnection;
+exports.verifyConnection = verifyConnection;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const errors_1 = require("../utils/errors");
+const DEFAULT_OPTIONS = {
+    walMode: true,
+    busyTimeout: 5000,
+    foreignKeys: true,
+    journalMode: 'wal',
+    synchronous: 'NORMAL',
+};
+/**
+ * Classify a connection/open error into the appropriate typed error class
+ * per FS-SS-001-0001 error conditions table.
+ */
+function classifyConnectionError(err, dbPath) {
+    const msg = err instanceof Error ? err.message : String(err);
+    // ERR-DB-001: Parent directory does not exist
+    if (msg.includes('ENOENT') || msg.includes('no such file or directory')) {
+        throw new errors_1.DatabaseParentDirMissingError((0, path_1.dirname)(dbPath));
+    }
+    // ERR-DB-002: Permission denied
+    if (msg.includes('EACCES') || msg.includes('EPERM') || msg.includes('permission denied')) {
+        throw new errors_1.DatabasePermissionDeniedError(dbPath);
+    }
+    // ERR-DB-003: Disk full
+    if (msg.includes('ENOSPC') || msg.includes('disk full') || msg.includes('no space left')) {
+        throw new errors_1.DatabaseDiskFullError(dbPath);
+    }
+    // ERR-DB-004: Database file exists but is not valid (corrupt)
+    if (msg.includes('file is not a database') || msg.includes('malformed') || msg.includes('corrupt')) {
+        throw new errors_1.DatabaseCorruptError(dbPath);
+    }
+    // ERR-CONN-002: Database busy at open time
+    if (msg.includes('SQLITE_BUSY') || msg.includes('database is locked')) {
+        throw new errors_1.ConnectionBusyError(dbPath);
+    }
+    // Fallback: generic connection error (ERR-CONN-001)
+    throw new errors_1.ConnectionError(`Failed to open database at "${dbPath}": ${msg}`, { dbPath, originalError: err });
+}
+/**
+ * Open a SQLite database connection with proper configuration.
+ * Creates parent directories if they don't exist (for file-based databases).
+ *
+ * @param dbPath - Path to the database file, or ':memory:' for in-memory
+ * @param options - Connection configuration options
+ * @returns Configured better-sqlite3 Database instance
+ * @throws ERR-DB-001 through ERR-DB-004, ERR-CONN-001, ERR-CONN-002
+ */
+function openConnection(dbPath, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    // Create parent directories for file-based databases
+    if (dbPath !== ':memory:') {
+        const dir = (0, path_1.dirname)(dbPath);
+        if (!(0, fs_1.existsSync)(dir)) {
+            try {
+                (0, fs_1.mkdirSync)(dir, { recursive: true });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.includes('EACCES') || msg.includes('EPERM') || msg.includes('permission denied')) {
+                    throw new errors_1.DatabasePermissionDeniedError(dir);
+                }
+                if (msg.includes('ENOSPC') || msg.includes('disk full')) {
+                    throw new errors_1.DatabaseDiskFullError(dbPath);
+                }
+                throw new errors_1.DatabaseParentDirMissingError(dir);
+            }
+        }
+    }
+    // Check if file exists and is not a valid SQLite database
+    if (dbPath !== ':memory:' && (0, fs_1.existsSync)(dbPath)) {
+        try {
+            const stat = (0, fs_1.statSync)(dbPath);
+            if (stat.size > 0) {
+                // Try to open to verify it's a valid SQLite file
+                // better-sqlite3 will throw if it's corrupt
+            }
+        }
+        catch {
+            // statSync failed — proceed to open attempt
+        }
+    }
+    let db;
+    try {
+        db = new better_sqlite3_1.default(dbPath);
+    }
+    catch (err) {
+        classifyConnectionError(err, dbPath);
+    }
+    try {
+        // Enable WAL mode first (AD-0003)
+        if (opts.walMode) {
+            db.pragma(`journal_mode = ${opts.journalMode}`);
+        }
+        // Set busy timeout (AD-0003)
+        db.pragma(`busy_timeout = ${opts.busyTimeout}`);
+        // Set foreign keys
+        if (opts.foreignKeys) {
+            db.pragma('foreign_keys = ON');
+        }
+        else {
+            db.pragma('foreign_keys = OFF');
+        }
+        // Set synchronous mode (NORMAL is safe with WAL)
+        db.pragma(`synchronous = ${opts.synchronous}`);
+    }
+    catch (err) {
+        db.close();
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('SQLITE_BUSY') || msg.includes('database is locked')) {
+            throw new errors_1.ConnectionBusyError(dbPath);
+        }
+        throw new errors_1.ConnectionError(`Failed to configure database: ${msg}`, { dbPath, originalError: err });
+    }
+    return db;
+}
+/**
+ * Verify that a database connection is properly configured.
+ * Returns an object with the current pragma settings.
+ */
+function verifyConnection(db) {
+    const journalMode = db.pragma('journal_mode', { simple: true });
+    const busyTimeout = db.pragma('busy_timeout', { simple: true });
+    const foreignKeys = db.pragma('foreign_keys', { simple: true });
+    const synchronous = Number(db.pragma('synchronous', { simple: true }));
+    return { journalMode, busyTimeout, foreignKeys, synchronous };
+}
+//# sourceMappingURL=connection.js.map

package/dist/db/connection.js.map

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

package/dist/db/generated/schema-types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Canonical relation types sourced from plan/project-schema.yaml (builtin:3.0).
+ * Entity types are derived dynamically from documents.type — no static registry.
+ * Total: 18 relation types.
+ */
+export declare const RELATION_TYPES: readonly [{
+    readonly name: "contained_in";
+    readonly from_types: readonly ["US", "FR", "NFR"];
+    readonly to_types: readonly ["MDL"];
+    readonly cardinality: "many_to_one";
+    readonly inverse_of: "contains";
+    readonly description: "A requirement or feature belongs to a module (e.g., FR-001 is contained in MDL-Auth)";
+}, {
+    readonly name: "contains";
+    readonly from_types: readonly ["MDL"];
+    readonly to_types: readonly ["US", "FR", "NFR"];
+    readonly cardinality: "one_to_many";
+    readonly inverse_of: "contained_in";
+    readonly description: "A module contains requirements or features (inverse of contained_in)";
+}, {
+    readonly name: "covered_by";
+    readonly from_types: readonly ["FS", "NFS"];
+    readonly to_types: readonly ["SAD", "AD", "QA"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "covers";
+    readonly description: "A specification is covered by design or QA artifacts (e.g., FS-001 is covered by SAD-0035)";
+}, {
+    readonly name: "covers";
+    readonly from_types: readonly ["SAD", "AD", "QA"];
+    readonly to_types: readonly ["FS", "NFS"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "covered_by";
+    readonly description: "A design or QA artifact covers a specification (inverse of covered_by)";
+}, {
+    readonly name: "decomposed_to";
+    readonly from_types: readonly ["SAD"];
+    readonly to_types: readonly ["AD", "QA"];
+    readonly cardinality: "one_to_many";
+    readonly inverse_of: "decomposes";
+    readonly description: "A SAD decomposes into AD and QA artifacts (e.g., SAD-0035 decomposes to AD-0035, QA-SAD-0035)";
+}, {
+    readonly name: "decomposes";
+    readonly from_types: readonly ["AD", "QA"];
+    readonly to_types: readonly ["SAD"];
+    readonly cardinality: "many_to_one";
+    readonly inverse_of: "decomposed_to";
+    readonly description: "An AD or QA artifact decomposes from a SAD (inverse of decomposed_to)";
+}, {
+    readonly name: "depended_on_by";
+    readonly from_types: readonly ["MDL"];
+    readonly to_types: readonly ["MDL"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "depends_on";
+    readonly description: "A module is depended on by another module (inverse of depends_on)";
+}, {
+    readonly name: "depends_on";
+    readonly from_types: readonly ["MDL"];
+    readonly to_types: readonly ["MDL"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "depended_on_by";
+    readonly description: "A module depends on another module (e.g., MDL-Auth depends on MDL-User)";
+}, {
+    readonly name: "divided_from";
+    readonly from_types: readonly ["TC"];
+    readonly to_types: readonly ["TS"];
+    readonly cardinality: "many_to_one";
+    readonly inverse_of: "divided_into";
+    readonly description: "A test case is divided from a test suite (e.g., TC-0711 divided from TS-033)";
+}, {
+    readonly name: "divided_into";
+    readonly from_types: readonly ["TS"];
+    readonly to_types: readonly ["TC"];
+    readonly cardinality: "one_to_many";
+    readonly inverse_of: "divided_from";
+    readonly description: "A test suite is divided into test cases (inverse of divided_from)";
+}, {
+    readonly name: "fulfilled_by";
+    readonly from_types: readonly ["US"];
+    readonly to_types: readonly ["FR", "NFR"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "fulfills";
+    readonly description: "A user story is fulfilled by functional or non-functional requirements (e.g., US-001 fulfilled by FR-001)";
+}, {
+    readonly name: "fulfills";
+    readonly from_types: readonly ["FR", "NFR"];
+    readonly to_types: readonly ["US"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "fulfilled_by";
+    readonly description: "A requirement fulfills a user story (inverse of fulfilled_by)";
+}, {
+    readonly name: "implemented_by";
+    readonly from_types: readonly ["SAD", "AD", "QA"];
+    readonly to_types: readonly ["SRC"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "implements";
+    readonly description: "A design or QA artifact is implemented by source code (e.g., SAD-0035 implemented by SRC-auth)";
+}, {
+    readonly name: "implements";
+    readonly from_types: readonly ["SRC"];
+    readonly to_types: readonly ["SAD", "AD", "QA"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "implemented_by";
+    readonly description: "Source code implements a design or QA artifact (inverse of implemented_by)";
+}, {
+    readonly name: "realized_by";
+    readonly from_types: readonly ["FR"];
+    readonly to_types: readonly ["FS"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "realizes";
+    readonly description: "A functional requirement is realized by a functional specification (e.g., FR-001 realized by FS-001)";
+}, {
+    readonly name: "realizes";
+    readonly from_types: readonly ["FS"];
+    readonly to_types: readonly ["FR"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "realized_by";
+    readonly description: "A functional specification realizes a functional requirement (inverse of realized_by)";
+}, {
+    readonly name: "verified_by";
+    readonly from_types: readonly ["FS", "NFS"];
+    readonly to_types: readonly ["TS"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "verifies";
+    readonly description: "A specification is verified by a test suite (e.g., FS-001 verified by TS-033)";
+}, {
+    readonly name: "verifies";
+    readonly from_types: readonly ["TS"];
+    readonly to_types: readonly ["FS", "NFS"];
+    readonly cardinality: "many_to_many";
+    readonly inverse_of: "verified_by";
+    readonly description: "A test suite verifies a specification (inverse of verified_by)";
+}];
+export type BuiltinRelationType = typeof RELATION_TYPES[number];
+//# sourceMappingURL=schema-types.d.ts.map

package/dist/db/generated/schema-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-types.d.ts","sourceRoot":"","sources":["../../../src/db/generated/schema-types.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBjB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/dist/db/generated/schema-types.js

@@ -0,0 +1,31 @@
+"use strict";
+// AUTO-GENERATED by scripts/generate-schema-types.js
+// Do not edit manually. Regenerate by running the script after changing plan/project-schema.yaml.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RELATION_TYPES = void 0;
+/**
+ * Canonical relation types sourced from plan/project-schema.yaml (builtin:3.0).
+ * Entity types are derived dynamically from documents.type — no static registry.
+ * Total: 18 relation types.
+ */
+exports.RELATION_TYPES = [
+    { name: 'contained_in', from_types: ["US", "FR", "NFR"], to_types: ["MDL"], cardinality: "many_to_one", inverse_of: "contains", description: "A requirement or feature belongs to a module (e.g., FR-001 is contained in MDL-Auth)" },
+    { name: 'contains', from_types: ["MDL"], to_types: ["US", "FR", "NFR"], cardinality: "one_to_many", inverse_of: "contained_in", description: "A module contains requirements or features (inverse of contained_in)" },
+    { name: 'covered_by', from_types: ["FS", "NFS"], to_types: ["SAD", "AD", "QA"], cardinality: "many_to_many", inverse_of: "covers", description: "A specification is covered by design or QA artifacts (e.g., FS-001 is covered by SAD-0035)" },
+    { name: 'covers', from_types: ["SAD", "AD", "QA"], to_types: ["FS", "NFS"], cardinality: "many_to_many", inverse_of: "covered_by", description: "A design or QA artifact covers a specification (inverse of covered_by)" },
+    { name: 'decomposed_to', from_types: ["SAD"], to_types: ["AD", "QA"], cardinality: "one_to_many", inverse_of: "decomposes", description: "A SAD decomposes into AD and QA artifacts (e.g., SAD-0035 decomposes to AD-0035, QA-SAD-0035)" },
+    { name: 'decomposes', from_types: ["AD", "QA"], to_types: ["SAD"], cardinality: "many_to_one", inverse_of: "decomposed_to", description: "An AD or QA artifact decomposes from a SAD (inverse of decomposed_to)" },
+    { name: 'depended_on_by', from_types: ["MDL"], to_types: ["MDL"], cardinality: "many_to_many", inverse_of: "depends_on", description: "A module is depended on by another module (inverse of depends_on)" },
+    { name: 'depends_on', from_types: ["MDL"], to_types: ["MDL"], cardinality: "many_to_many", inverse_of: "depended_on_by", description: "A module depends on another module (e.g., MDL-Auth depends on MDL-User)" },
+    { name: 'divided_from', from_types: ["TC"], to_types: ["TS"], cardinality: "many_to_one", inverse_of: "divided_into", description: "A test case is divided from a test suite (e.g., TC-0711 divided from TS-033)" },
+    { name: 'divided_into', from_types: ["TS"], to_types: ["TC"], cardinality: "one_to_many", inverse_of: "divided_from", description: "A test suite is divided into test cases (inverse of divided_from)" },
+    { name: 'fulfilled_by', from_types: ["US"], to_types: ["FR", "NFR"], cardinality: "many_to_many", inverse_of: "fulfills", description: "A user story is fulfilled by functional or non-functional requirements (e.g., US-001 fulfilled by FR-001)" },
+    { name: 'fulfills', from_types: ["FR", "NFR"], to_types: ["US"], cardinality: "many_to_many", inverse_of: "fulfilled_by", description: "A requirement fulfills a user story (inverse of fulfilled_by)" },
+    { name: 'implemented_by', from_types: ["SAD", "AD", "QA"], to_types: ["SRC"], cardinality: "many_to_many", inverse_of: "implements", description: "A design or QA artifact is implemented by source code (e.g., SAD-0035 implemented by SRC-auth)" },
+    { name: 'implements', from_types: ["SRC"], to_types: ["SAD", "AD", "QA"], cardinality: "many_to_many", inverse_of: "implemented_by", description: "Source code implements a design or QA artifact (inverse of implemented_by)" },
+    { name: 'realized_by', from_types: ["FR"], to_types: ["FS"], cardinality: "many_to_many", inverse_of: "realizes", description: "A functional requirement is realized by a functional specification (e.g., FR-001 realized by FS-001)" },
+    { name: 'realizes', from_types: ["FS"], to_types: ["FR"], cardinality: "many_to_many", inverse_of: "realized_by", description: "A functional specification realizes a functional requirement (inverse of realized_by)" },
+    { name: 'verified_by', from_types: ["FS", "NFS"], to_types: ["TS"], cardinality: "many_to_many", inverse_of: "verifies", description: "A specification is verified by a test suite (e.g., FS-001 verified by TS-033)" },
+    { name: 'verifies', from_types: ["TS"], to_types: ["FS", "NFS"], cardinality: "many_to_many", inverse_of: "verified_by", description: "A test suite verifies a specification (inverse of verified_by)" }
+];
+//# sourceMappingURL=schema-types.js.map

package/dist/db/generated/schema-types.js.map

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