@precisionutilityguild/liquid-shadow 1.0.4 → 1.0.5

package/README.md

@@ -46,8 +46,8 @@ Change one function, see the ripple. Trace execution flows and predict the **Bla
 
 Organized into specialized intelligence suites for the modern agent:
 
-| Suite            | Tactical Purpose                | Key Tools                                          |
-| :--------------- | :------------------------------ | :------------------------------------------------- |
+| Suite                  | Tactical Purpose                | Key Tools                                              |
+| :--------------------- | :------------------------------ | :----------------------------------------------------- |
 | **Ops Control**  | Mission & context management    | `shadow_ops_context`, `shadow_ops_briefing`        |
 | **Intelligence** | Deep architectural reasoning    | `shadow_analyze_impact`, `shadow_analyze_flow`     |
 | **Discovery**    | Semantic & config retrieval     | `shadow_search_concept`, `shadow_search_config`    |

package/dist/data/migrations/000_baseline.sql

@@ -0,0 +1,277 @@
+-- ============================================================
+-- Liquid Shadow — Baseline Schema (consolidated)
+-- Applied once on fresh databases instead of replaying all
+-- incremental migrations. Existing DBs keep their history.
+-- ============================================================
+
+-- ── Core index tables ────────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS files (
+    path               TEXT    PRIMARY KEY,
+    mtime              REAL,
+    last_scanned_at    REAL,
+    classification     TEXT,
+    summary            TEXT,
+    embedding          TEXT,
+    content_hash       TEXT
+);
+
+CREATE TABLE IF NOT EXISTS exports (
+    id             INTEGER PRIMARY KEY AUTOINCREMENT,
+    file_path      TEXT,
+    name           TEXT,
+    kind           TEXT,
+    signature      TEXT,
+    doc            TEXT,
+    start_line     INTEGER,
+    end_line       INTEGER,
+    classification TEXT,
+    capabilities   TEXT,
+    parent_id      INTEGER,
+    embedding      TEXT,
+    FOREIGN KEY(file_path)  REFERENCES files(path)   ON DELETE CASCADE,
+    FOREIGN KEY(parent_id)  REFERENCES exports(id)   ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS imports (
+    id                INTEGER PRIMARY KEY AUTOINCREMENT,
+    file_path         TEXT,
+    module_specifier  TEXT,
+    imported_symbols  TEXT,
+    resolved_path     TEXT,
+    FOREIGN KEY(file_path) REFERENCES files(path) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS configs (
+    id        INTEGER PRIMARY KEY AUTOINCREMENT,
+    file_path TEXT,
+    key       TEXT,
+    value     TEXT,
+    kind      TEXT,
+    FOREIGN KEY(file_path) REFERENCES files(path) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS file_content (
+    file_path TEXT PRIMARY KEY,
+    content   TEXT,
+    FOREIGN KEY(file_path) REFERENCES files(path) ON DELETE CASCADE
+);
+
+-- ── FTS5 virtual tables ──────────────────────────────────────
+
+CREATE VIRTUAL TABLE IF NOT EXISTS exports_fts USING fts5(
+    name,
+    signature,
+    doc,
+    content='exports',
+    content_rowid='id'
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS files_fts USING fts5(
+    path,
+    summary,
+    content='files',
+    content_rowid='rowid'
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS content_fts USING fts5(
+    file_path,
+    content,
+    content='file_content',
+    content_rowid='rowid'
+);
+
+-- ── FTS sync triggers ────────────────────────────────────────
+
+CREATE TRIGGER IF NOT EXISTS exports_ai AFTER INSERT ON exports BEGIN
+    INSERT INTO exports_fts(rowid, name, signature, doc)
+    VALUES (new.id, new.name, new.signature, new.doc);
+END;
+
+CREATE TRIGGER IF NOT EXISTS exports_ad AFTER DELETE ON exports BEGIN
+    INSERT INTO exports_fts(exports_fts, rowid, name, signature, doc)
+    VALUES('delete', old.id, old.name, old.signature, old.doc);
+END;
+
+CREATE TRIGGER IF NOT EXISTS exports_au AFTER UPDATE ON exports BEGIN
+    INSERT INTO exports_fts(exports_fts, rowid, name, signature, doc)
+    VALUES('delete', old.id, old.name, old.signature, old.doc);
+    INSERT INTO exports_fts(rowid, name, signature, doc)
+    VALUES (new.id, new.name, new.signature, new.doc);
+END;
+
+CREATE TRIGGER IF NOT EXISTS files_ai AFTER INSERT ON files BEGIN
+    INSERT INTO files_fts(rowid, path, summary)
+    VALUES (new.rowid, new.path, new.summary);
+END;
+
+CREATE TRIGGER IF NOT EXISTS files_ad AFTER DELETE ON files BEGIN
+    INSERT INTO files_fts(files_fts, rowid, path, summary)
+    VALUES('delete', old.rowid, old.path, old.summary);
+END;
+
+CREATE TRIGGER IF NOT EXISTS files_au AFTER UPDATE ON files BEGIN
+    INSERT INTO files_fts(files_fts, rowid, path, summary)
+    VALUES('delete', old.rowid, old.path, old.summary);
+    INSERT INTO files_fts(rowid, path, summary)
+    VALUES (new.rowid, new.path, new.summary);
+END;
+
+CREATE TRIGGER IF NOT EXISTS content_ai AFTER INSERT ON file_content BEGIN
+    INSERT INTO content_fts(rowid, file_path, content)
+    VALUES (new.rowid, new.file_path, new.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS content_ad AFTER DELETE ON file_content BEGIN
+    INSERT INTO content_fts(content_fts, rowid, file_path, content)
+    VALUES('delete', old.rowid, old.file_path, old.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS content_au AFTER UPDATE ON file_content BEGIN
+    INSERT INTO content_fts(content_fts, rowid, file_path, content)
+    VALUES('delete', old.rowid, old.file_path, old.content);
+    INSERT INTO content_fts(rowid, file_path, content)
+    VALUES (new.rowid, new.file_path, new.content);
+END;
+
+-- ── Mission / cognitive overlay ──────────────────────────────
+
+CREATE TABLE IF NOT EXISTS missions (
+    id                   INTEGER PRIMARY KEY AUTOINCREMENT,
+    name                 TEXT    NOT NULL,
+    goal                 TEXT,
+    status               TEXT    DEFAULT 'planned',
+    strategy_graph       TEXT,
+    git_branch           TEXT,
+    commit_sha           TEXT,
+    parent_id            INTEGER,
+    verification_context TEXT,
+    outcome_contract     TEXT,
+    created_at           REAL    DEFAULT (unixepoch()),
+    updated_at           REAL    DEFAULT (unixepoch()),
+    FOREIGN KEY(parent_id) REFERENCES missions(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS mission_artifacts (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    mission_id  INTEGER NOT NULL,
+    type        TEXT    NOT NULL,
+    identifier  TEXT    NOT NULL,
+    metadata    TEXT,
+    created_at  INTEGER DEFAULT (unixepoch()),
+    FOREIGN KEY(mission_id) REFERENCES missions(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS intent_logs (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    mission_id      INTEGER,                          -- NULL = unanchored (heritage, system)
+    symbol_id       INTEGER,
+    file_path       TEXT,
+    type            TEXT,
+    content         TEXT,
+    confidence      REAL    DEFAULT 1.0,
+    symbol_name     TEXT,
+    signature       TEXT,
+    commit_sha      TEXT,
+    is_crystallized INTEGER DEFAULT 0,
+    crystal_id      INTEGER REFERENCES intent_logs(id) ON DELETE SET NULL,
+    embedding       TEXT    DEFAULT NULL,
+    created_at      REAL    DEFAULT (unixepoch()),
+    FOREIGN KEY(mission_id) REFERENCES missions(id)  ON DELETE CASCADE,
+    FOREIGN KEY(symbol_id)  REFERENCES exports(id)   ON DELETE SET NULL,
+    FOREIGN KEY(file_path)  REFERENCES files(path)   ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS working_set (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    mission_id  INTEGER,
+    file_path   TEXT,
+    symbol_id   INTEGER,
+    type        TEXT,
+    created_at  REAL DEFAULT (unixepoch()),
+    FOREIGN KEY(mission_id) REFERENCES missions(id)  ON DELETE CASCADE,
+    FOREIGN KEY(file_path)  REFERENCES files(path)   ON DELETE CASCADE,
+    FOREIGN KEY(symbol_id)  REFERENCES exports(id)   ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS cross_repo_links (
+    id                INTEGER PRIMARY KEY AUTOINCREMENT,
+    mission_id        INTEGER NOT NULL,
+    linked_repo_path  TEXT    NOT NULL,
+    linked_mission_id INTEGER NOT NULL,
+    relationship      TEXT,
+    direction         TEXT,
+    created_at        REAL    DEFAULT (unixepoch()),
+    FOREIGN KEY(mission_id) REFERENCES missions(id) ON DELETE CASCADE
+);
+
+-- ── Event mesh ───────────────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS event_synapses (
+    id           INTEGER PRIMARY KEY AUTOINCREMENT,
+    type         TEXT    NOT NULL,  -- 'socket_event' | 'api_route'
+    name         TEXT    NOT NULL,  -- string contract e.g. 'user:created'
+    direction    TEXT    NOT NULL,  -- 'produce' | 'consume'
+    file_path    TEXT    NOT NULL,
+    line_number  INTEGER,
+    code_snippet TEXT,
+    created_at   REAL    DEFAULT (unixepoch())
+);
+
+-- ── Metadata / caches ────────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS index_metadata (
+    key        TEXT PRIMARY KEY,
+    value      TEXT,
+    updated_at REAL DEFAULT (unixepoch())
+);
+
+INSERT OR IGNORE INTO index_metadata (key, value) VALUES ('index_completed', 'false');
+INSERT OR IGNORE INTO index_metadata (key, value) VALUES ('index_version', '1');
+INSERT OR IGNORE INTO index_metadata (key, value) VALUES ('last_indexed_at', NULL);
+
+CREATE TABLE IF NOT EXISTS search_history (
+    id         INTEGER PRIMARY KEY AUTOINCREMENT,
+    query      TEXT    NOT NULL,
+    mode       TEXT    NOT NULL,
+    branch     TEXT,
+    created_at REAL    DEFAULT (unixepoch())
+);
+
+CREATE TABLE IF NOT EXISTS hologram_snapshot (
+    section    TEXT PRIMARY KEY,
+    data       TEXT NOT NULL,
+    updated_at REAL DEFAULT (unixepoch())
+);
+
+-- ── Indexes ──────────────────────────────────────────────────
+
+-- Core index
+CREATE INDEX IF NOT EXISTS idx_exports_file_path        ON exports(file_path);
+CREATE INDEX IF NOT EXISTS idx_exports_name             ON exports(name);
+CREATE INDEX IF NOT EXISTS idx_exports_parent_id        ON exports(parent_id);
+CREATE INDEX IF NOT EXISTS idx_exports_classification   ON exports(classification);
+CREATE INDEX IF NOT EXISTS idx_imports_file_path        ON imports(file_path);
+CREATE INDEX IF NOT EXISTS idx_imports_resolved_path    ON imports(resolved_path);
+CREATE INDEX IF NOT EXISTS idx_configs_file_path        ON configs(file_path);
+CREATE INDEX IF NOT EXISTS idx_configs_kind             ON configs(kind);
+CREATE INDEX IF NOT EXISTS idx_files_classification     ON files(classification);
+
+-- Mission system
+CREATE INDEX IF NOT EXISTS idx_intent_mission           ON intent_logs(mission_id);
+CREATE INDEX IF NOT EXISTS idx_intent_symbol            ON intent_logs(symbol_id);
+CREATE INDEX IF NOT EXISTS idx_intent_crystal           ON intent_logs(crystal_id);
+CREATE INDEX IF NOT EXISTS idx_intent_crystallized      ON intent_logs(is_crystallized);
+CREATE INDEX IF NOT EXISTS idx_intent_embedding         ON intent_logs(id) WHERE embedding IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_working_set_mission      ON working_set(mission_id);
+CREATE INDEX IF NOT EXISTS idx_cross_repo_mission       ON cross_repo_links(mission_id);
+CREATE INDEX IF NOT EXISTS idx_mission_artifacts_mission ON mission_artifacts(mission_id);
+
+-- Event mesh
+CREATE INDEX IF NOT EXISTS idx_events_name              ON event_synapses(name);
+CREATE INDEX IF NOT EXISTS idx_events_file              ON event_synapses(file_path);
+
+-- Caches
+CREATE INDEX IF NOT EXISTS idx_search_history_created_at ON search_history(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_search_history_mode       ON search_history(mode);
+CREATE INDEX IF NOT EXISTS idx_hologram_snapshot_updated_at ON hologram_snapshot(updated_at DESC);