@coreyuan/vector-mind 1.0.49 → 1.0.53

package/dist/database-runtime.js

@@ -0,0 +1,512 @@
+import fs from "node:fs";
+import path from "node:path";
+import Database from "better-sqlite3";
+import { MEMORY_ITEMS_FTS_TABLE } from "./memory-recall.js";
+export const FTS_TABLE_NAME = MEMORY_ITEMS_FTS_TABLE;
+let db;
+let dbPath = "";
+let ftsAvailable = false;
+let insertRequirementStmt;
+let getActiveRequirementStmt;
+let listActiveRequirementsStmt;
+let listRecentRequirementsStmt;
+let completeAllActiveRequirementsStmt;
+let completeRequirementByIdStmt;
+let completeAllActiveRequirementMemoryItemsStmt;
+let completeRequirementMemoryItemByReqIdStmt;
+let listChangeLogsForRequirementStmt;
+let insertChangeLogStmt;
+let insertMemoryItemStmt;
+let getMemoryItemByIdStmt;
+let getRequirementMemoryItemIdStmt;
+let getConventionByKeyStmt;
+let insertConventionStmt;
+let updateConventionByIdStmt;
+let listConventionsStmt;
+let upsertDecisionStmt;
+let getDecisionByKeyStmt;
+let listCurrentDecisionsStmt;
+let upsertProjectSummaryStmt;
+let getProjectSummaryStmt;
+let getLatestChangeIntentForFileStmt;
+let deleteFileChunkItemsStmt;
+let upsertPendingChangeStmt;
+let listPendingChangesStmt;
+let countPendingChangesStmt;
+let deletePendingChangeStmt;
+let deleteAllPendingChangesStmt;
+let deleteOldPendingChangesStmt = null;
+let deleteOldestPendingChangesStmt = null;
+let deleteSymbolsForFileStmt;
+let upsertSymbolStmt;
+let searchSymbolsStmt;
+let insertTokenSavingsStmt;
+let summarizeTokenSavingsStmt;
+let summarizeTokenSavingsByToolStmt;
+let listRecentTokenSavingsStmt;
+let getKvStmt;
+let setKvStmt;
+let indexFileSymbolsTx = null;
+function initMemoryItemsFts() {
+    ftsAvailable = false;
+    try {
+        const existed = db
+            .prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name=?`)
+            .get(FTS_TABLE_NAME);
+        const alreadyExists = !!existed;
+        if (!alreadyExists) {
+            try {
+                db.exec(`
+          CREATE VIRTUAL TABLE ${FTS_TABLE_NAME} USING fts5(
+            kind,
+            title,
+            content,
+            file_path,
+            metadata_json,
+            content='memory_items',
+            content_rowid='id',
+            tokenize='trigram'
+          );
+        `);
+            }
+            catch {
+                db.exec(`
+          CREATE VIRTUAL TABLE ${FTS_TABLE_NAME} USING fts5(
+            kind,
+            title,
+            content,
+            file_path,
+            metadata_json,
+            content='memory_items',
+            content_rowid='id'
+          );
+        `);
+            }
+            try {
+                db.exec(`INSERT INTO ${FTS_TABLE_NAME}(${FTS_TABLE_NAME}) VALUES('rebuild');`);
+            }
+            catch (err) {
+                console.error("[vectormind] fts rebuild failed:", err);
+            }
+        }
+        db.exec(`
+      CREATE TRIGGER IF NOT EXISTS vectormind_memory_items_fts_ai
+      AFTER INSERT ON memory_items BEGIN
+        INSERT INTO ${FTS_TABLE_NAME}(rowid, kind, title, content, file_path, metadata_json)
+        VALUES (new.id, new.kind, new.title, new.content, new.file_path, new.metadata_json);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS vectormind_memory_items_fts_ad
+      AFTER DELETE ON memory_items BEGIN
+        INSERT INTO ${FTS_TABLE_NAME}(${FTS_TABLE_NAME}, rowid, kind, title, content, file_path, metadata_json)
+        VALUES ('delete', old.id, old.kind, old.title, old.content, old.file_path, old.metadata_json);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS vectormind_memory_items_fts_au
+      AFTER UPDATE ON memory_items BEGIN
+        INSERT INTO ${FTS_TABLE_NAME}(${FTS_TABLE_NAME}, rowid, kind, title, content, file_path, metadata_json)
+        VALUES ('delete', old.id, old.kind, old.title, old.content, old.file_path, old.metadata_json);
+        INSERT INTO ${FTS_TABLE_NAME}(rowid, kind, title, content, file_path, metadata_json)
+        VALUES (new.id, new.kind, new.title, new.content, new.file_path, new.metadata_json);
+      END;
+    `);
+        db.prepare(`SELECT rowid FROM ${FTS_TABLE_NAME} LIMIT 1`).get();
+        ftsAvailable = true;
+    }
+    catch (err) {
+        ftsAvailable = false;
+    }
+}
+function columnExists(table, column) {
+    try {
+        const rows = db.prepare(`PRAGMA table_info(${table})`).all();
+        return rows.some((row) => row.name === column);
+    }
+    catch {
+        return false;
+    }
+}
+export function openDatabaseRuntime(projectRoot) {
+    const vmDir = path.join(projectRoot, ".vectormind");
+    try {
+        fs.mkdirSync(vmDir, { recursive: true });
+    }
+    catch {
+        // ignore
+    }
+    dbPath = path.join(vmDir, "vectormind.db");
+    db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS requirements (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      title TEXT NOT NULL,
+      status TEXT DEFAULT 'active',
+      context_data TEXT,
+      created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+      updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+    );
+
+    CREATE TABLE IF NOT EXISTS change_logs (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      req_id INTEGER,
+      file_path TEXT,
+      intent_summary TEXT,
+      timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
+      FOREIGN KEY(req_id) REFERENCES requirements(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS symbols (
+      name TEXT,
+      type TEXT,
+      file_path TEXT,
+      signature TEXT,
+      PRIMARY KEY(name, file_path)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_change_logs_req_id_timestamp
+      ON change_logs(req_id, timestamp DESC);
+
+    CREATE INDEX IF NOT EXISTS idx_symbols_name
+      ON symbols(name);
+
+    CREATE TABLE IF NOT EXISTS memory_items (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      kind TEXT NOT NULL,
+      title TEXT,
+      content TEXT NOT NULL,
+      file_path TEXT,
+      start_line INTEGER,
+      end_line INTEGER,
+      req_id INTEGER,
+      metadata_json TEXT,
+      content_hash TEXT,
+      created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+      updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+    );
+
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_memory_items_chunk_locator
+      ON memory_items(kind, file_path, start_line, end_line);
+
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_memory_items_project_summary
+      ON memory_items(kind) WHERE kind = 'project_summary';
+
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_memory_items_convention_key
+      ON memory_items(kind, title) WHERE kind = 'convention';
+
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_memory_items_decision_key
+      ON memory_items(kind, title) WHERE kind = 'decision';
+
+    CREATE INDEX IF NOT EXISTS idx_memory_items_kind_updated_at
+      ON memory_items(kind, updated_at DESC);
+
+    CREATE INDEX IF NOT EXISTS idx_memory_items_file_path
+      ON memory_items(file_path);
+
+    CREATE INDEX IF NOT EXISTS idx_memory_items_req_id
+      ON memory_items(req_id);
+
+    CREATE TABLE IF NOT EXISTS pending_changes (
+      file_path TEXT PRIMARY KEY,
+      last_event TEXT NOT NULL,
+      updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_pending_changes_updated_at
+      ON pending_changes(updated_at DESC);
+
+    CREATE TABLE IF NOT EXISTS token_savings (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      tool TEXT NOT NULL,
+      raw_tokens INTEGER NOT NULL,
+      output_tokens INTEGER NOT NULL,
+      saved_tokens INTEGER NOT NULL,
+      savings_pct REAL NOT NULL,
+      created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_token_savings_created_at
+      ON token_savings(created_at DESC);
+
+    CREATE INDEX IF NOT EXISTS idx_token_savings_tool
+      ON token_savings(tool);
+
+    CREATE TABLE IF NOT EXISTS memory_item_archive (
+      memory_id INTEGER PRIMARY KEY,
+      original_kind TEXT NOT NULL,
+      original_title TEXT,
+      original_content TEXT NOT NULL,
+      original_file_path TEXT,
+      original_start_line INTEGER,
+      original_end_line INTEGER,
+      original_req_id INTEGER,
+      original_metadata_json TEXT,
+      original_content_hash TEXT,
+      original_created_at DATETIME,
+      original_updated_at DATETIME,
+      archive_reason TEXT NOT NULL,
+      compacted_into_id INTEGER,
+      archived_at DATETIME DEFAULT CURRENT_TIMESTAMP
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_memory_item_archive_compacted_into
+      ON memory_item_archive(compacted_into_id);
+
+    CREATE TABLE IF NOT EXISTS meta_kv (
+      key TEXT PRIMARY KEY,
+      value TEXT NOT NULL,
+      updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+    );
+  `);
+    if (!columnExists("requirements", "updated_at")) {
+        db.exec(`ALTER TABLE requirements ADD COLUMN updated_at DATETIME`);
+        db.exec(`UPDATE requirements SET updated_at = COALESCE(created_at, CURRENT_TIMESTAMP) WHERE updated_at IS NULL`);
+    }
+    db.exec(`
+    UPDATE requirements SET updated_at = COALESCE(updated_at, created_at, CURRENT_TIMESTAMP) WHERE updated_at IS NULL;
+    CREATE INDEX IF NOT EXISTS idx_requirements_status_updated_at
+      ON requirements(status, updated_at DESC, id DESC);
+    CREATE TRIGGER IF NOT EXISTS vectormind_requirements_touch_updated_at
+    AFTER UPDATE ON requirements
+    FOR EACH ROW
+    WHEN NEW.updated_at = OLD.updated_at
+    BEGIN
+      UPDATE requirements SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id;
+    END;
+  `);
+    initMemoryItemsFts();
+    insertRequirementStmt = db.prepare(`INSERT INTO requirements (title, context_data, status) VALUES (?, ?, 'active')`);
+    completeAllActiveRequirementsStmt = db.prepare(`UPDATE requirements SET status = 'completed' WHERE status = 'active'`);
+    completeRequirementByIdStmt = db.prepare(`UPDATE requirements SET status = 'completed' WHERE id = ?`);
+    getActiveRequirementStmt = db.prepare(`SELECT id, title, status, context_data, created_at
+     FROM requirements
+     WHERE status = 'active'
+     ORDER BY updated_at DESC, created_at DESC, id DESC
+     LIMIT 1`);
+    listActiveRequirementsStmt = db.prepare(`SELECT id, title, status, context_data, created_at
+     FROM requirements
+     WHERE status = 'active'
+     ORDER BY updated_at DESC, created_at DESC, id DESC
+     LIMIT ?`);
+    listRecentRequirementsStmt = db.prepare(`SELECT id, title, status, context_data, created_at
+     FROM requirements
+     ORDER BY updated_at DESC, created_at DESC, id DESC
+     LIMIT ?`);
+    completeAllActiveRequirementMemoryItemsStmt = db.prepare(`UPDATE memory_items
+     SET metadata_json = json_set(
+         CASE
+           WHEN json_valid(COALESCE(metadata_json, '{}')) THEN COALESCE(metadata_json, '{}')
+           ELSE '{}'
+         END,
+         '$.status',
+         ?
+       ),
+       updated_at = CURRENT_TIMESTAMP
+     WHERE kind = 'requirement'
+       AND json_extract(
+         CASE
+           WHEN json_valid(COALESCE(metadata_json, '{}')) THEN COALESCE(metadata_json, '{}')
+           ELSE '{}'
+         END,
+         '$.status'
+       ) = ?`);
+    completeRequirementMemoryItemByReqIdStmt = db.prepare(`UPDATE memory_items
+     SET metadata_json = json_set(
+         CASE
+           WHEN json_valid(COALESCE(metadata_json, '{}')) THEN COALESCE(metadata_json, '{}')
+           ELSE '{}'
+         END,
+         '$.status',
+         ?
+       ),
+       updated_at = CURRENT_TIMESTAMP
+     WHERE kind = 'requirement'
+       AND req_id = ?`);
+    listChangeLogsForRequirementStmt = db.prepare(`SELECT id, req_id, file_path, intent_summary, timestamp
+     FROM change_logs
+     WHERE req_id = ?
+     ORDER BY timestamp DESC, id DESC
+     LIMIT ?`);
+    insertChangeLogStmt = db.prepare(`INSERT INTO change_logs (req_id, file_path, intent_summary) VALUES (?, ?, ?)`);
+    insertMemoryItemStmt = db.prepare(`INSERT INTO memory_items
+       (kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash)
+     VALUES
+       (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+    getMemoryItemByIdStmt = db.prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+     FROM memory_items
+     WHERE id = ?`);
+    getConventionByKeyStmt = db.prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+     FROM memory_items
+     WHERE kind = 'convention' AND title = ?
+     ORDER BY updated_at DESC, id DESC
+     LIMIT 1`);
+    insertConventionStmt = db.prepare(`INSERT INTO memory_items (kind, title, content, metadata_json, content_hash)
+     VALUES ('convention', ?, ?, ?, ?)`);
+    updateConventionByIdStmt = db.prepare(`UPDATE memory_items
+     SET content = ?, metadata_json = ?, content_hash = ?, updated_at = CURRENT_TIMESTAMP
+     WHERE id = ?`);
+    listConventionsStmt = db.prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+     FROM memory_items
+     WHERE kind = 'convention'
+     ORDER BY updated_at DESC, id DESC
+     LIMIT ?`);
+    upsertDecisionStmt = db.prepare(`INSERT INTO memory_items (kind, title, content, metadata_json, content_hash)
+     VALUES ('decision', ?, ?, ?, ?)
+     ON CONFLICT DO UPDATE SET
+       content = excluded.content,
+       metadata_json = excluded.metadata_json,
+       content_hash = excluded.content_hash,
+       updated_at = CURRENT_TIMESTAMP`);
+    getDecisionByKeyStmt = db.prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+     FROM memory_items
+     WHERE kind = 'decision' AND title = ?
+     ORDER BY updated_at DESC, id DESC
+     LIMIT 1`);
+    listCurrentDecisionsStmt = db.prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+     FROM memory_items
+     WHERE kind = 'decision'
+     ORDER BY updated_at DESC, id DESC
+     LIMIT ?`);
+    getRequirementMemoryItemIdStmt = db.prepare(`SELECT id
+     FROM memory_items
+     WHERE kind = 'requirement' AND req_id = ?
+     ORDER BY id DESC
+     LIMIT 1`);
+    upsertProjectSummaryStmt = db.prepare(`INSERT INTO memory_items (kind, title, content, metadata_json, content_hash)
+     VALUES ('project_summary', 'Project Summary', ?, ?, ?)
+     ON CONFLICT DO UPDATE SET
+       title = excluded.title,
+       content = excluded.content,
+       metadata_json = excluded.metadata_json,
+       content_hash = excluded.content_hash,
+       updated_at = CURRENT_TIMESTAMP`);
+    getProjectSummaryStmt = db.prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+     FROM memory_items
+     WHERE kind = 'project_summary'
+     LIMIT 1`);
+    getLatestChangeIntentForFileStmt = db.prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+     FROM memory_items
+     WHERE kind = 'change_intent' AND file_path = ?
+     ORDER BY updated_at DESC, id DESC
+     LIMIT 1`);
+    deleteFileChunkItemsStmt = db.prepare(`DELETE FROM memory_items
+     WHERE file_path = ?
+       AND (kind = 'code_chunk' OR kind = 'doc_chunk')`);
+    upsertPendingChangeStmt = db.prepare(`INSERT INTO pending_changes (file_path, last_event)
+     VALUES (?, ?)
+     ON CONFLICT(file_path) DO UPDATE SET
+       last_event = excluded.last_event,
+       updated_at = CURRENT_TIMESTAMP`);
+    listPendingChangesStmt = db.prepare(`SELECT file_path, last_event, updated_at
+     FROM pending_changes
+     ORDER BY updated_at DESC`);
+    countPendingChangesStmt = db.prepare(`SELECT COUNT(*) as total FROM pending_changes`);
+    deletePendingChangeStmt = db.prepare(`DELETE FROM pending_changes WHERE file_path = ?`);
+    deleteAllPendingChangesStmt = db.prepare(`DELETE FROM pending_changes`);
+    deleteOldPendingChangesStmt = db.prepare(`DELETE FROM pending_changes WHERE updated_at < datetime('now', ?)`);
+    deleteOldestPendingChangesStmt = db.prepare(`DELETE FROM pending_changes
+     WHERE file_path IN (
+       SELECT file_path FROM pending_changes
+       ORDER BY updated_at ASC
+       LIMIT ?
+     )`);
+    deleteSymbolsForFileStmt = db.prepare(`DELETE FROM symbols WHERE file_path = ?`);
+    upsertSymbolStmt = db.prepare(`INSERT OR REPLACE INTO symbols (name, type, file_path, signature) VALUES (?, ?, ?, ?)`);
+    searchSymbolsStmt = db.prepare(`SELECT name, type, file_path, signature
+     FROM symbols
+     WHERE name LIKE ? ESCAPE '\\'
+        OR signature LIKE ? ESCAPE '\\'
+     ORDER BY
+       CASE
+         WHEN name = ? THEN 0
+         WHEN name LIKE ? ESCAPE '\\' THEN 1
+         ELSE 2
+       END,
+       name
+     LIMIT ?`);
+    insertTokenSavingsStmt = db.prepare(`INSERT INTO token_savings (tool, raw_tokens, output_tokens, saved_tokens, savings_pct)
+     VALUES (?, ?, ?, ?, ?)`);
+    summarizeTokenSavingsStmt = db.prepare(`SELECT
+       COUNT(*) as calls,
+       COALESCE(SUM(raw_tokens), 0) as raw_tokens,
+       COALESCE(SUM(output_tokens), 0) as output_tokens,
+       COALESCE(SUM(saved_tokens), 0) as saved_tokens,
+       COALESCE(AVG(savings_pct), 0) as avg_savings_pct
+     FROM token_savings`);
+    summarizeTokenSavingsByToolStmt = db.prepare(`SELECT
+       tool,
+       COUNT(*) as calls,
+       COALESCE(SUM(raw_tokens), 0) as raw_tokens,
+       COALESCE(SUM(output_tokens), 0) as output_tokens,
+       COALESCE(SUM(saved_tokens), 0) as saved_tokens,
+       COALESCE(AVG(savings_pct), 0) as avg_savings_pct
+     FROM token_savings
+     GROUP BY tool
+     ORDER BY saved_tokens DESC, calls DESC
+     LIMIT ?`);
+    listRecentTokenSavingsStmt = db.prepare(`SELECT id, tool, raw_tokens, output_tokens, saved_tokens, savings_pct, created_at
+     FROM token_savings
+     ORDER BY created_at DESC, id DESC
+     LIMIT ?`);
+    getKvStmt = db.prepare(`SELECT value FROM meta_kv WHERE key = ?`);
+    setKvStmt = db.prepare(`INSERT INTO meta_kv (key, value)
+     VALUES (?, ?)
+     ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = CURRENT_TIMESTAMP`);
+    indexFileSymbolsTx = db.transaction((filePath, symbols) => {
+        deleteSymbolsForFileStmt.run(filePath);
+        for (const s of symbols) {
+            upsertSymbolStmt.run(s.name, s.type, filePath, s.signature);
+        }
+    });
+    return {
+        db,
+        dbPath,
+        ftsAvailable,
+        ftsTableName: FTS_TABLE_NAME,
+        indexFileSymbolsTx,
+        statements: {
+            insertRequirementStmt,
+            getActiveRequirementStmt,
+            listActiveRequirementsStmt,
+            listRecentRequirementsStmt,
+            completeAllActiveRequirementsStmt,
+            completeRequirementByIdStmt,
+            completeAllActiveRequirementMemoryItemsStmt,
+            completeRequirementMemoryItemByReqIdStmt,
+            listChangeLogsForRequirementStmt,
+            insertChangeLogStmt,
+            insertMemoryItemStmt,
+            getMemoryItemByIdStmt,
+            getRequirementMemoryItemIdStmt,
+            getConventionByKeyStmt,
+            insertConventionStmt,
+            updateConventionByIdStmt,
+            listConventionsStmt,
+            upsertDecisionStmt,
+            getDecisionByKeyStmt,
+            listCurrentDecisionsStmt,
+            upsertProjectSummaryStmt,
+            getProjectSummaryStmt,
+            getLatestChangeIntentForFileStmt,
+            deleteFileChunkItemsStmt,
+            upsertPendingChangeStmt,
+            listPendingChangesStmt,
+            countPendingChangesStmt,
+            deletePendingChangeStmt,
+            deleteAllPendingChangesStmt,
+            deleteOldPendingChangesStmt,
+            deleteOldestPendingChangesStmt,
+            deleteSymbolsForFileStmt,
+            upsertSymbolStmt,
+            searchSymbolsStmt,
+            insertTokenSavingsStmt,
+            summarizeTokenSavingsStmt,
+            summarizeTokenSavingsByToolStmt,
+            listRecentTokenSavingsStmt,
+            getKvStmt,
+            setKvStmt,
+        },
+    };
+}
+//# sourceMappingURL=database-runtime.js.map

package/dist/database-runtime.js.map

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

package/dist/development-warnings.d.ts

@@ -0,0 +1,93 @@
+import fs from "node:fs";
+import type { MemoryItemRow, RequirementRow } from "./types.js";
+type DevelopmentWarningsContext = {
+    getProjectRoot: () => string;
+    normalizeToDbPath: (inputPath: string) => string;
+    listActiveRequirements: (limit: number) => RequirementRow[];
+    getRequirementMemoryItemId: (reqId: number) => {
+        id: number;
+    } | undefined;
+    getMemoryItemById: (id: number) => MemoryItemRow | undefined;
+    parseMetadataJson: (raw: string | null | undefined) => Record<string, unknown>;
+};
+export declare function configureDevelopmentWarnings(context: DevelopmentWarningsContext): void;
+type DevelopmentWarning = {
+    code: "large_file" | "very_large_file" | "huge_file_modularization_required" | "many_pending_files" | "broad_change_surface" | "unspecified_change_target" | "large_file_read" | "cross_project_path" | "multiple_active_requirements" | "broad_requirement_scope" | "scope_drift" | "scope_contract_missing" | "requirement_mapping_missing";
+    severity: "info" | "warning" | "blocker";
+    message: string;
+    files?: string[];
+    details?: Record<string, unknown>;
+};
+export type ChangeMode = "feature" | "bugfix" | "refactor" | "mechanical_modularization" | "emergency_hotfix";
+type DevelopmentWarningFileInput = {
+    file_path: string;
+    last_event?: string;
+    event?: string;
+    updated_at?: string;
+};
+type RequirementScopeContract = {
+    allow_terms: string[];
+    deny_terms: string[];
+    allowed_paths: string[];
+    denied_paths: string[];
+    inferred_from: string[];
+};
+type RequirementItem = {
+    id: string;
+    text: string;
+};
+type PlannedRequirementChange = {
+    file?: string;
+    change: string;
+    requirement_refs?: string[];
+    supporting_change?: boolean;
+    change_type?: string;
+};
+export declare function isLikelySourceImplementationFile(filePath: string): boolean;
+export declare function countFileLinesBounded(absPath: string, maxBytes: number): {
+    lines: number;
+    truncated: boolean;
+} | null;
+export declare function buildCrossProjectPathWarnings(paths: string[] | null | undefined): DevelopmentWarning[];
+export declare function buildFileReadDevelopmentWarnings(filePath: string, absPath: string, stat?: fs.Stats): DevelopmentWarning[];
+export declare function buildMatchedFileDevelopmentWarnings(filePaths: Array<string | null | undefined>): DevelopmentWarning[];
+export declare function buildRequirementStartWarnings(args: {
+    title: string;
+    background: string;
+    close_previous: boolean;
+}): DevelopmentWarning[];
+export declare function normalizeRequirementItems(values: string[] | undefined): RequirementItem[];
+export declare function getRequirementItems(reqId: number): RequirementItem[];
+export declare function buildRequirementMappingWarnings(args: {
+    requirement?: RequirementRow;
+    requirement_items?: RequirementItem[];
+    planned_changes?: PlannedRequirementChange[];
+    files: Array<{
+        file_path: string;
+    }>;
+    change_mode: ChangeMode;
+}): DevelopmentWarning[];
+export declare function buildRequirementScopeContract(args: {
+    title: string;
+    background: string;
+    scope_allow?: string[];
+    scope_deny?: string[];
+    allowed_paths?: string[];
+    denied_paths?: string[];
+}): RequirementScopeContract;
+export declare function getRequirementScopeContract(reqId: number): RequirementScopeContract | null;
+export declare function mergeScopeContracts(base: RequirementScopeContract | null | undefined, extra: RequirementScopeContract | null | undefined): RequirementScopeContract | null;
+export declare function buildScopeDriftWarnings(args: {
+    requirement?: RequirementRow;
+    contract?: RequirementScopeContract | null;
+    intent?: string;
+    files: Array<{
+        file_path: string;
+    }>;
+    includeMissingContractHint?: boolean;
+}): DevelopmentWarning[];
+export declare function buildDevelopmentWarnings(files: DevelopmentWarningFileInput[], opts?: {
+    includeUnspecified?: boolean;
+}): DevelopmentWarning[];
+export declare function isDevelopmentWarningBlockingForChangeMode(warning: DevelopmentWarning, changeMode: ChangeMode): boolean;
+export {};