@monoes/monograph 1.0.0 → 1.2.0

package/dist/src/storage/node-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-store.js","sourceRoot":"","sources":["../../../src/storage/node-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,UAAU,CAAC,EAAqB,EAAE,IAAmB;IACnE,EAAE,CAAC,OAAO,CAAC;;;;;GAKV,CAAC,CAAC,GAAG,CACJ,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EACxC,IAAI,CAAC,QAAQ,IAAI,IAAI,EACrB,IAAI,CAAC,SAAS,IAAI,IAAI,EACtB,IAAI,CAAC,OAAO,IAAI,IAAI,EACpB,IAAI,CAAC,WAAW,IAAI,IAAI,EACxB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACvB,IAAI,CAAC,QAAQ,IAAI,IAAI,EACrB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAqB,EAAE,KAAsB;IACvE,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,IAAqB,EAAE,EAAE;QAC1D,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAqB,EAAE,EAAU;IACvD,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,kCAAkC,CAAC;SAC3C,GAAG,CAAC,EAAE,CAAwC,CAAC;IAClD,OAAO,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAqB,EAAE,QAAgB;IACrE,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,yCAAyC,CAAC;SAClD,GAAG,CAAC,QAAQ,CAA8B,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAqB,EAAE,QAAgB;IACxE,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAqB;IAC9C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,GAAG,EAAmB,CAAC;IACjF,OAAO,GAAG,CAAC,CAAC,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,GAA4B;IAC7C,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAY;QACpB,KAAK,EAAE,GAAG,CAAC,KAA+B;QAC1C,IAAI,EAAE,GAAG,CAAC,IAAc;QACxB,SAAS,EAAE,GAAG,CAAC,UAAoB;QACnC,QAAQ,EAAE,GAAG,CAAC,SAA+B;QAC7C,SAAS,EAAE,GAAG,CAAC,UAAgC;QAC/C,OAAO,EAAE,GAAG,CAAC,QAA8B;QAC3C,WAAW,EAAE,GAAG,CAAC,YAAkC;QACnD,UAAU,EAAG,GAAG,CAAC,WAAsB,KAAK,CAAC;QAC7C,QAAQ,EAAE,GAAG,CAAC,QAA8B;QAC5C,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAoB,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"node-store.js","sourceRoot":"","sources":["../../../src/storage/node-store.ts"],"names":[],"mappings":"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"}

package/dist/src/storage/schema.d.ts

@@ -1,8 +1,14 @@
-export declare const CREATE_NODES = "\nCREATE TABLE IF NOT EXISTS nodes (\n  id TEXT PRIMARY KEY,\n  label TEXT NOT NULL,\n  name TEXT NOT NULL,\n  norm_label TEXT NOT NULL DEFAULT '',\n  file_path TEXT,\n  start_line INTEGER,\n  end_line INTEGER,\n  community_id INTEGER,\n  is_exported INTEGER NOT NULL DEFAULT 0,\n  language TEXT,\n  properties TEXT\n)";
-export declare const CREATE_EDGES = "\nCREATE TABLE IF NOT EXISTS edges (\n  id TEXT PRIMARY KEY,\n  source_id TEXT NOT NULL,\n  target_id TEXT NOT NULL,\n  relation TEXT NOT NULL,\n  confidence TEXT NOT NULL DEFAULT 'EXTRACTED',\n  confidence_score REAL NOT NULL DEFAULT 1.0,\n  FOREIGN KEY (source_id) REFERENCES nodes(id),\n  FOREIGN KEY (target_id) REFERENCES nodes(id)\n)";
+export declare const CREATE_NODES = "\nCREATE TABLE IF NOT EXISTS nodes (\n  id TEXT PRIMARY KEY,\n  label TEXT NOT NULL,\n  name TEXT NOT NULL,\n  norm_label TEXT NOT NULL DEFAULT '',\n  file_path TEXT,\n  start_line INTEGER,\n  end_line INTEGER,\n  community_id INTEGER,\n  is_exported INTEGER NOT NULL DEFAULT 0,\n  language TEXT,\n  properties TEXT,\n  embedding TEXT\n)";
+export declare const CREATE_EDGES = "\nCREATE TABLE IF NOT EXISTS edges (\n  id TEXT PRIMARY KEY,\n  source_id TEXT NOT NULL,\n  target_id TEXT NOT NULL,\n  relation TEXT NOT NULL,\n  confidence TEXT NOT NULL DEFAULT 'EXTRACTED',\n  confidence_score REAL NOT NULL DEFAULT 1.0,\n  weight REAL NOT NULL DEFAULT 1.0,\n  reason TEXT,\n  evidence TEXT,\n  FOREIGN KEY (source_id) REFERENCES nodes(id),\n  FOREIGN KEY (target_id) REFERENCES nodes(id)\n)";
 export declare const CREATE_COMMUNITIES = "\nCREATE TABLE IF NOT EXISTS communities (\n  id INTEGER PRIMARY KEY,\n  label TEXT,\n  size INTEGER NOT NULL DEFAULT 0,\n  cohesion_score REAL NOT NULL DEFAULT 0.0\n)";
 export declare const CREATE_INDEX_META = "\nCREATE TABLE IF NOT EXISTS index_meta (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL\n)";
-export declare const CREATE_NODES_FTS = "\nCREATE VIRTUAL TABLE IF NOT EXISTS nodes_fts USING fts5(\n  id UNINDEXED,\n  name,\n  norm_label,\n  file_path,\n  label UNINDEXED,\n  content='nodes',\n  content_rowid='rowid'\n)";
+export declare const CREATE_NODES_FTS = "\nCREATE VIRTUAL TABLE IF NOT EXISTS nodes_fts USING fts5(\n  id UNINDEXED,\n  name,\n  norm_label,\n  file_path,\n  label UNINDEXED,\n  content='nodes',\n  content_rowid='rowid',\n  tokenize='trigram'\n)";
+export declare const CREATE_EMBEDDINGS = "\nCREATE TABLE IF NOT EXISTS embeddings (\n  node_id TEXT PRIMARY KEY,\n  vector BLOB NOT NULL\n)";
+export declare const CREATE_WIKI_PAGES = "\nCREATE TABLE IF NOT EXISTS wiki_pages (\n  community_id TEXT PRIMARY KEY,\n  content TEXT NOT NULL,\n  generated_at TEXT NOT NULL\n)";
 export declare const CREATE_INDEXES: string[];
+export declare const CREATE_NODE_PROPERTIES = "\nCREATE TABLE IF NOT EXISTS node_properties (\n  ident TEXT PRIMARY KEY,\n  type TEXT NOT NULL CHECK(type IN ('text','number','boolean','date','node-ref','closed')),\n  cardinality TEXT NOT NULL DEFAULT 'one' CHECK(cardinality IN ('one','many')),\n  view_context TEXT NOT NULL DEFAULT 'all' CHECK(view_context IN ('all','graph','query','never')),\n  closed_values TEXT,\n  description TEXT,\n  queryable INTEGER NOT NULL DEFAULT 1\n)";
+export declare const SEED_NODE_PROPERTIES = "\nINSERT OR IGNORE INTO node_properties (ident, type, cardinality, view_context, description, queryable) VALUES\n  ('ua_type',       'closed',  'one',  'query', 'Understand-Anything node type',        1),\n  ('summary',       'text',    'one',  'all',   'LLM-generated description',            1),\n  ('tags',          'text',    'many', 'all',   'Semantic tags from analysis',          1),\n  ('complexity',    'closed',  'one',  'query', 'Code complexity rating',               1),\n  ('layer',         'closed',  'one',  'graph', 'Architectural layer (community name)', 1),\n  ('community_id',  'number',  'one',  'query', 'Community cluster id',                 1),\n  ('language',      'text',    'one',  'query', 'Programming language',                 1),\n  ('is_exported',   'boolean', 'one',  'query', 'Whether symbol is exported',           1)";
+export declare const CREATE_SUPPRESSIONS = "\nCREATE TABLE IF NOT EXISTS suppressions (\n  id TEXT PRIMARY KEY,\n  file_path TEXT NOT NULL,\n  line INTEGER NOT NULL DEFAULT 0,\n  rule TEXT NOT NULL,\n  added_at TEXT NOT NULL,\n  last_seen_at TEXT\n)";
+export declare const CREATE_FILE_CACHE = "\n  CREATE TABLE IF NOT EXISTS file_cache (\n    file_path TEXT PRIMARY KEY,\n    content_hash TEXT NOT NULL,\n    last_parsed INTEGER NOT NULL,\n    node_count INTEGER NOT NULL DEFAULT 0,\n    edge_count INTEGER NOT NULL DEFAULT 0\n  )\n";
 export declare const FTS_SYNC_TRIGGERS = "\nCREATE TRIGGER IF NOT EXISTS nodes_fts_insert AFTER INSERT ON nodes BEGIN\n  INSERT INTO nodes_fts(rowid, id, name, norm_label, file_path, label)\n  VALUES (new.rowid, new.id, new.name, new.norm_label, new.file_path, new.label);\nEND;\nCREATE TRIGGER IF NOT EXISTS nodes_fts_delete AFTER DELETE ON nodes BEGIN\n  INSERT INTO nodes_fts(nodes_fts, rowid, id, name, norm_label, file_path, label)\n  VALUES ('delete', old.rowid, old.id, old.name, old.norm_label, old.file_path, old.label);\nEND;\nCREATE TRIGGER IF NOT EXISTS nodes_fts_update AFTER UPDATE ON nodes BEGIN\n  INSERT INTO nodes_fts(nodes_fts, rowid, id, name, norm_label, file_path, label)\n  VALUES ('delete', old.rowid, old.id, old.name, old.norm_label, old.file_path, old.label);\n  INSERT INTO nodes_fts(rowid, id, name, norm_label, file_path, label)\n  VALUES (new.rowid, new.id, new.name, new.norm_label, new.file_path, new.label);\nEND";
 //# sourceMappingURL=schema.d.ts.map

package/dist/src/storage/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/storage/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,mUAavB,CAAC;AAEH,eAAO,MAAM,YAAY,wVAUvB,CAAC;AAEH,eAAO,MAAM,kBAAkB,4KAM7B,CAAC;AAEH,eAAO,MAAM,iBAAiB,iGAI5B,CAAC;AAEH,eAAO,MAAM,gBAAgB,0LAS3B,CAAC;AAEH,eAAO,MAAM,cAAc,UAQ1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,64BAc1B,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/storage/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,sVAcvB,CAAC;AAEH,eAAO,MAAM,YAAY,+ZAavB,CAAC;AAEH,eAAO,MAAM,kBAAkB,4KAM7B,CAAC;AAEH,eAAO,MAAM,iBAAiB,iGAI5B,CAAC;AAEH,eAAO,MAAM,gBAAgB,iNAU3B,CAAC;AAEH,eAAO,MAAM,iBAAiB,sGAI5B,CAAC;AAEH,eAAO,MAAM,iBAAiB,2IAK5B,CAAC;AAEH,eAAO,MAAM,cAAc,UAQ1B,CAAC;AAEF,eAAO,MAAM,sBAAsB,ubASjC,CAAC;AAEH,eAAO,MAAM,oBAAoB,21BAS0D,CAAC;AAE5F,eAAO,MAAM,mBAAmB,kNAQ9B,CAAC;AAEH,eAAO,MAAM,iBAAiB,mPAQ7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,64BAc1B,CAAC"}

package/dist/src/storage/schema.js

@@ -10,7 +10,8 @@ CREATE TABLE IF NOT EXISTS nodes (
   community_id INTEGER,
   is_exported INTEGER NOT NULL DEFAULT 0,
   language TEXT,
-  properties TEXT
+  properties TEXT,
+  embedding TEXT
 )`;
 export const CREATE_EDGES = `
 CREATE TABLE IF NOT EXISTS edges (
@@ -20,6 +21,9 @@ CREATE TABLE IF NOT EXISTS edges (
   relation TEXT NOT NULL,
   confidence TEXT NOT NULL DEFAULT 'EXTRACTED',
   confidence_score REAL NOT NULL DEFAULT 1.0,
+  weight REAL NOT NULL DEFAULT 1.0,
+  reason TEXT,
+  evidence TEXT,
   FOREIGN KEY (source_id) REFERENCES nodes(id),
   FOREIGN KEY (target_id) REFERENCES nodes(id)
 )`;
@@ -43,7 +47,19 @@ CREATE VIRTUAL TABLE IF NOT EXISTS nodes_fts USING fts5(
   file_path,
   label UNINDEXED,
   content='nodes',
-  content_rowid='rowid'
+  content_rowid='rowid',
+  tokenize='trigram'
+)`;
+export const CREATE_EMBEDDINGS = `
+CREATE TABLE IF NOT EXISTS embeddings (
+  node_id TEXT PRIMARY KEY,
+  vector BLOB NOT NULL
+)`;
+export const CREATE_WIKI_PAGES = `
+CREATE TABLE IF NOT EXISTS wiki_pages (
+  community_id TEXT PRIMARY KEY,
+  content TEXT NOT NULL,
+  generated_at TEXT NOT NULL
 )`;
 export const CREATE_INDEXES = [
     `CREATE INDEX IF NOT EXISTS idx_nodes_file ON nodes(file_path)`,
@@ -54,6 +70,44 @@ export const CREATE_INDEXES = [
     `CREATE INDEX IF NOT EXISTS idx_edges_relation ON edges(relation)`,
     `CREATE INDEX IF NOT EXISTS idx_edges_confidence ON edges(confidence)`,
 ];
+export const CREATE_NODE_PROPERTIES = `
+CREATE TABLE IF NOT EXISTS node_properties (
+  ident TEXT PRIMARY KEY,
+  type TEXT NOT NULL CHECK(type IN ('text','number','boolean','date','node-ref','closed')),
+  cardinality TEXT NOT NULL DEFAULT 'one' CHECK(cardinality IN ('one','many')),
+  view_context TEXT NOT NULL DEFAULT 'all' CHECK(view_context IN ('all','graph','query','never')),
+  closed_values TEXT,
+  description TEXT,
+  queryable INTEGER NOT NULL DEFAULT 1
+)`;
+export const SEED_NODE_PROPERTIES = `
+INSERT OR IGNORE INTO node_properties (ident, type, cardinality, view_context, description, queryable) VALUES
+  ('ua_type',       'closed',  'one',  'query', 'Understand-Anything node type',        1),
+  ('summary',       'text',    'one',  'all',   'LLM-generated description',            1),
+  ('tags',          'text',    'many', 'all',   'Semantic tags from analysis',          1),
+  ('complexity',    'closed',  'one',  'query', 'Code complexity rating',               1),
+  ('layer',         'closed',  'one',  'graph', 'Architectural layer (community name)', 1),
+  ('community_id',  'number',  'one',  'query', 'Community cluster id',                 1),
+  ('language',      'text',    'one',  'query', 'Programming language',                 1),
+  ('is_exported',   'boolean', 'one',  'query', 'Whether symbol is exported',           1)`;
+export const CREATE_SUPPRESSIONS = `
+CREATE TABLE IF NOT EXISTS suppressions (
+  id TEXT PRIMARY KEY,
+  file_path TEXT NOT NULL,
+  line INTEGER NOT NULL DEFAULT 0,
+  rule TEXT NOT NULL,
+  added_at TEXT NOT NULL,
+  last_seen_at TEXT
+)`;
+export const CREATE_FILE_CACHE = `
+  CREATE TABLE IF NOT EXISTS file_cache (
+    file_path TEXT PRIMARY KEY,
+    content_hash TEXT NOT NULL,
+    last_parsed INTEGER NOT NULL,
+    node_count INTEGER NOT NULL DEFAULT 0,
+    edge_count INTEGER NOT NULL DEFAULT 0
+  )
+`;
 export const FTS_SYNC_TRIGGERS = `
 CREATE TRIGGER IF NOT EXISTS nodes_fts_insert AFTER INSERT ON nodes BEGIN
   INSERT INTO nodes_fts(rowid, id, name, norm_label, file_path, label)

package/dist/src/storage/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/storage/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;EAa1B,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;EAU1B,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;EAMhC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;EAI/B,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;EAS9B,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,+DAA+D;IAC/D,4DAA4D;IAC5D,gEAAgE;IAChE,iEAAiE;IACjE,iEAAiE;IACjE,kEAAkE;IAClE,sEAAsE;CACvE,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;IAc7B,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/storage/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;EAc1B,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;EAa1B,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;EAMhC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;EAI/B,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;EAU9B,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;EAI/B,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;EAK/B,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,+DAA+D;IAC/D,4DAA4D;IAC5D,gEAAgE;IAChE,iEAAiE;IACjE,iEAAiE;IACjE,kEAAkE;IAClE,sEAAsE;CACvE,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;EASpC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;2FASuD,CAAC;AAE5F,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;EAQjC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;CAQhC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;IAc7B,CAAC"}

package/dist/src/storage/suppressions.d.ts

@@ -0,0 +1,21 @@
+import type Database from 'better-sqlite3';
+export interface Suppression {
+    id: string;
+    filePath: string;
+    line: number;
+    rule: string;
+    addedAt: string;
+    lastSeenAt?: string;
+}
+export interface StaleSuppression extends Suppression {
+    reason: string;
+}
+export declare function addSuppression(db: Database.Database, filePath: string, line: number, rule: string): Suppression;
+export declare function listSuppressions(db: Database.Database, filePath?: string, rule?: string): Suppression[];
+export declare function removeSuppression(db: Database.Database, id: string): void;
+export declare function isSuppressed(db: Database.Database, filePath: string, line: number, rule: string): Suppression | null;
+export declare function findStaleSuppressions(db: Database.Database, activeFindings: Array<{
+    filePath: string;
+    rule: string;
+}>): StaleSuppression[];
+//# sourceMappingURL=suppressions.d.ts.map

package/dist/src/storage/suppressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppressions.d.ts","sourceRoot":"","sources":["../../../src/storage/suppressions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,WAAW,CAUb;AAGD,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW,EAAE,CA+Bf;AAGD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzE;AAID,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,IAAI,CAyBpB;AAMD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,cAAc,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACxD,gBAAgB,EAAE,CA0BpB"}

package/dist/src/storage/suppressions.js

@@ -0,0 +1,83 @@
+import { randomUUID } from 'crypto';
+// Add a suppression
+export function addSuppression(db, filePath, line, rule) {
+    const id = randomUUID();
+    const addedAt = new Date().toISOString();
+    db.prepare(`
+    INSERT INTO suppressions (id, file_path, line, rule, added_at, last_seen_at)
+    VALUES (?, ?, ?, ?, ?, NULL)
+  `).run(id, filePath, line, rule, addedAt);
+    return { id, filePath, line, rule, addedAt };
+}
+// List all suppressions (optionally filter by rule or file)
+export function listSuppressions(db, filePath, rule) {
+    let sql = `SELECT id, file_path, line, rule, added_at, last_seen_at FROM suppressions WHERE 1=1`;
+    const params = [];
+    if (filePath) {
+        sql += ` AND file_path = ?`;
+        params.push(filePath);
+    }
+    if (rule) {
+        sql += ` AND rule = ?`;
+        params.push(rule);
+    }
+    sql += ` ORDER BY added_at DESC`;
+    const rows = db.prepare(sql).all(...params);
+    return rows.map(r => ({
+        id: r.id,
+        filePath: r.file_path,
+        line: r.line,
+        rule: r.rule,
+        addedAt: r.added_at,
+        ...(r.last_seen_at != null ? { lastSeenAt: r.last_seen_at } : {}),
+    }));
+}
+// Remove a suppression
+export function removeSuppression(db, id) {
+    db.prepare(`DELETE FROM suppressions WHERE id = ?`).run(id);
+}
+// Check if a finding is suppressed
+// A suppression with line=0 is file-wide and matches any line for the same file+rule
+export function isSuppressed(db, filePath, line, rule) {
+    const row = db.prepare(`
+    SELECT id, file_path, line, rule, added_at, last_seen_at
+    FROM suppressions
+    WHERE file_path = ? AND rule = ? AND (line = 0 OR line = ?)
+    LIMIT 1
+  `).get(filePath, rule, line);
+    if (!row)
+        return null;
+    return {
+        id: row.id,
+        filePath: row.file_path,
+        line: row.line,
+        rule: row.rule,
+        addedAt: row.added_at,
+        ...(row.last_seen_at != null ? { lastSeenAt: row.last_seen_at } : {}),
+    };
+}
+// Find stale suppressions
+// A suppression is stale if:
+//   - the file no longer exists in the graph (reason: 'file_deleted')
+//   - the file exists but no active finding matches file+rule (reason: 'issue_resolved')
+export function findStaleSuppressions(db, activeFindings) {
+    const suppressions = listSuppressions(db);
+    if (suppressions.length === 0)
+        return [];
+    // Build a set of all file paths in the graph
+    const graphFiles = new Set(db.prepare(`SELECT DISTINCT file_path FROM nodes WHERE file_path IS NOT NULL`).all()
+        .map(r => r.file_path));
+    // Build a set of active finding keys: "filePath::rule"
+    const activeFindingKeys = new Set(activeFindings.map(f => `${f.filePath}::${f.rule}`));
+    const stale = [];
+    for (const s of suppressions) {
+        if (!graphFiles.has(s.filePath)) {
+            stale.push({ ...s, reason: 'file_deleted' });
+        }
+        else if (!activeFindingKeys.has(`${s.filePath}::${s.rule}`)) {
+            stale.push({ ...s, reason: 'issue_resolved' });
+        }
+    }
+    return stale;
+}
+//# sourceMappingURL=suppressions.js.map

package/dist/src/storage/suppressions.js.map

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

package/dist/src/storage/unlinked-refs.d.ts

@@ -0,0 +1,25 @@
+import type Database from 'better-sqlite3';
+export interface UnlinkedReference {
+    sourceId: string;
+    sourceName: string;
+    sourceFilePath: string | null;
+    sourceLabel: string;
+    targetName: string;
+    mentionContext: string | null;
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Find nodes that mention a target symbol by name in their metadata
+ * (summary, file_path, norm_label) but have no explicit edge to any node
+ * with that name. These are "mentioned but not linked" — latent coupling.
+ *
+ * @param db - open monograph database
+ * @param targetName - symbol name to search for (e.g. "UserService")
+ * @param options.limit - max results (default 50)
+ * @param options.excludeSourceId - skip this node id (avoid self-match)
+ */
+export declare function findUnlinkedReferences(db: Database.Database, targetName: string, options?: {
+    limit?: number;
+    excludeSourceId?: string;
+}): UnlinkedReference[];
+//# sourceMappingURL=unlinked-refs.d.ts.map

package/dist/src/storage/unlinked-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlinked-refs.d.ts","sourceRoot":"","sources":["../../../src/storage/unlinked-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,iBAAiB,EAAE,CA0FrB"}

package/dist/src/storage/unlinked-refs.js

@@ -0,0 +1,91 @@
+/**
+ * Find nodes that mention a target symbol by name in their metadata
+ * (summary, file_path, norm_label) but have no explicit edge to any node
+ * with that name. These are "mentioned but not linked" — latent coupling.
+ *
+ * @param db - open monograph database
+ * @param targetName - symbol name to search for (e.g. "UserService")
+ * @param options.limit - max results (default 50)
+ * @param options.excludeSourceId - skip this node id (avoid self-match)
+ */
+export function findUnlinkedReferences(db, targetName, options = {}) {
+    const limit = options.limit ?? 50;
+    const excludeSourceId = options.excludeSourceId ?? '';
+    const pattern = `%${targetName}%`;
+    // Step 1: Find all node IDs that already have an explicit edge to any node
+    // whose name matches targetName — these are "already linked" and excluded.
+    const linkedRows = db.prepare(`
+    SELECT DISTINCT e.source_id FROM edges e
+    JOIN nodes n ON n.id = e.target_id
+    WHERE n.name = ?
+  `).all(targetName);
+    const linkedIds = new Set(linkedRows.map(r => r.source_id));
+    // Step 2: Find nodes that mention targetName in name, norm_label, or
+    // properties JSON — but are NOT in the linked set and not self.
+    const rows = db.prepare(`
+    SELECT n.id, n.name, n.file_path, n.label, n.properties
+    FROM nodes n
+    WHERE (
+      n.name LIKE ? OR
+      n.norm_label LIKE ? OR
+      (n.properties IS NOT NULL AND n.properties LIKE ?)
+    )
+    AND n.name != ?
+    LIMIT ?
+  `).all(pattern, pattern, pattern, targetName, limit * 4);
+    const results = [];
+    for (const row of rows) {
+        // Skip nodes that already have an explicit edge to the target
+        if (linkedIds.has(row.id))
+            continue;
+        // Skip the excluded node (e.g. the target node itself)
+        if (excludeSourceId && row.id === excludeSourceId)
+            continue;
+        // Determine confidence and extract mention context
+        let confidence;
+        let mentionContext = null;
+        if (row.name.includes(targetName)) {
+            // Target name appears in the symbol's own name
+            confidence = 'high';
+        }
+        else if (row.file_path !== null && row.file_path.includes(targetName)) {
+            // Appears in the file path
+            confidence = 'medium';
+        }
+        else {
+            // Only in properties.summary
+            confidence = 'low';
+        }
+        // Extract a 100-char context window from properties.summary if available
+        if (row.properties !== null) {
+            try {
+                const props = JSON.parse(row.properties);
+                const summary = typeof props['summary'] === 'string' ? props['summary'] : null;
+                if (summary !== null && summary.includes(targetName)) {
+                    const idx = summary.indexOf(targetName);
+                    const start = Math.max(0, idx - 50);
+                    const end = Math.min(summary.length, idx + targetName.length + 50);
+                    mentionContext = summary.slice(start, end);
+                    // Refine confidence: if we previously set 'low' due to no name/path match,
+                    // and properties match confirms it, keep 'low'. Otherwise stay as-is.
+                }
+            }
+            catch {
+                // Malformed JSON — skip
+            }
+        }
+        results.push({
+            sourceId: row.id,
+            sourceName: row.name,
+            sourceFilePath: row.file_path,
+            sourceLabel: row.label,
+            targetName,
+            mentionContext,
+            confidence,
+        });
+        if (results.length >= limit)
+            break;
+    }
+    return results;
+}
+//# sourceMappingURL=unlinked-refs.js.map

package/dist/src/storage/unlinked-refs.js.map

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

package/dist/src/types.d.ts

@@ -1,6 +1,6 @@
-export type NodeLabel = 'File' | 'Folder' | 'Function' | 'Class' | 'Method' | 'Interface' | 'Variable' | 'Struct' | 'Enum' | 'Macro' | 'Typedef' | 'Union' | 'Namespace' | 'Trait' | 'Impl' | 'TypeAlias' | 'Const' | 'Static' | 'Property' | 'Record' | 'Delegate' | 'Annotation' | 'Constructor' | 'Template' | 'Module' | 'Process' | 'Route' | 'Community' | 'Concept';
+export type NodeLabel = 'File' | 'Folder' | 'Function' | 'Class' | 'Method' | 'Interface' | 'Variable' | 'Struct' | 'Enum' | 'Macro' | 'Typedef' | 'Union' | 'Namespace' | 'Trait' | 'Impl' | 'TypeAlias' | 'Const' | 'Static' | 'Property' | 'Record' | 'Delegate' | 'Annotation' | 'Constructor' | 'Template' | 'Module' | 'Process' | 'Route' | 'Community' | 'Concept' | 'Section' | 'Document' | 'Tool' | 'Entity' | 'Field';
 export declare const SYMBOL_NODE_LABELS: Set<NodeLabel>;
-export type EdgeRelation = 'CONTAINS' | 'DEFINES' | 'CALLS' | 'IMPORTS' | 'EXTENDS' | 'IMPLEMENTS' | 'HAS_METHOD' | 'HAS_PROPERTY' | 'ACCESSES' | 'METHOD_OVERRIDES' | 'METHOD_IMPLEMENTS' | 'MEMBER_OF' | 'STEP_IN_PROCESS' | 'HANDLES_ROUTE' | 'FETCHES' | 'HANDLES_TOOL' | 'ENTRY_POINT_OF' | 'WRAPS' | 'QUERIES';
+export type EdgeRelation = 'CONTAINS' | 'DEFINES' | 'CALLS' | 'IMPORTS' | 'RE_EXPORTS' | 'EXTENDS' | 'IMPLEMENTS' | 'HAS_METHOD' | 'HAS_PROPERTY' | 'ACCESSES' | 'METHOD_OVERRIDES' | 'METHOD_IMPLEMENTS' | 'MEMBER_OF' | 'STEP_IN_PROCESS' | 'HANDLES_ROUTE' | 'FETCHES' | 'HANDLES_TOOL' | 'ENTRY_POINT_OF' | 'WRAPS' | 'QUERIES' | 'REFERENCES' | 'PARENT_SECTION' | 'TAGGED_AS' | 'HAS_FIELD' | 'CO_OCCURS' | 'DESCRIBES' | 'CAUSES' | 'CONTRASTS_WITH' | 'PART_OF' | 'RELATED_TO' | 'USES' | 'STRUCTURALLY_SIMILAR';
 export type EdgeConfidence = 'EXTRACTED' | 'INFERRED' | 'AMBIGUOUS';
 export declare const CONFIDENCE_SCORE: Record<EdgeConfidence, number>;
 export interface MonographNode {
@@ -14,8 +14,14 @@ export interface MonographNode {
     communityId?: number;
     isExported: boolean;
     language?: string;
+    reachabilityRole?: 'runtime' | 'test' | 'support' | 'unreachable';
     properties?: Record<string, unknown>;
 }
+export interface EvidenceEntry {
+    kind: string;
+    weight: number;
+    note?: string;
+}
 export interface MonographEdge {
     id: string;
     sourceId: string;
@@ -23,6 +29,9 @@ export interface MonographEdge {
     relation: EdgeRelation;
     confidence: EdgeConfidence;
     confidenceScore: number;
+    weight?: number;
+    reason?: string;
+    evidence?: EvidenceEntry[];
 }
 export interface MonographCommunity {
     id: number;
@@ -35,6 +44,18 @@ export interface GodNode extends MonographNode {
     inDegree: number;
     outDegree: number;
 }
+export interface ComplexityMetrics {
+    cyclomaticComplexity: number;
+    cognitiveComplexity: number;
+    linesOfCode: number;
+    paramCount: number;
+}
+export interface CrapScore {
+    cc: number;
+    coverage: number;
+    score: number;
+    risk: 'low' | 'medium' | 'high' | 'critical';
+}
 export interface SurprisingConnection {
     edge: MonographEdge;
     score: number;
@@ -60,7 +81,33 @@ export type SuggestedQuestion = {
 } | {
     type: 'low_cohesion';
     community: MonographCommunity;
+} | {
+    type: 'no_signal';
+    edge: MonographEdge;
+    reason: string;
+} | {
+    type: 'thin_community';
+    communityId: number;
+    memberCount: number;
+    reason: string;
 };
+export type FindingActionType = 'investigate' | 'refactor' | 'delete' | 'add-test' | 'add-import' | 'extract' | 'review' | 'add-edge';
+export interface FindingAction {
+    type: FindingActionType;
+    file?: string;
+    symbol?: string;
+    description: string;
+    confidence: 'high' | 'medium' | 'low';
+}
+export interface AnnotatedFinding {
+    title: string;
+    severity: 'error' | 'warning' | 'info';
+    nodeId?: string;
+    nodeName?: string;
+    filePath?: string | null;
+    introduced?: boolean;
+    actions: FindingAction[];
+}
 export declare function makeId(...parts: string[]): string;
 export declare function toNormLabel(name: string): string;
 export interface PipelineProgress {

package/dist/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GACjB,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GACjE,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAC9D,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GACjE,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,GACjE,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GACrE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzD,eAAO,MAAM,kBAAkB,gBAK7B,CAAC;AAIH,MAAM,MAAM,YAAY,GACpB,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GACtF,YAAY,GAAG,cAAc,GAAG,UAAU,GAAG,kBAAkB,GAC/D,mBAAmB,GAAG,WAAW,GAAG,iBAAiB,GAAG,eAAe,GACvE,SAAS,GAAG,cAAc,GAAG,gBAAgB,GAAG,OAAO,GAAG,SAAS,GACnE,YAAY,GAAG,gBAAgB,GAAG,WAAW,GAAG,WAAW,GAE3D,WAAW,GAEX,WAAW,GAAG,QAAQ,GAAG,gBAAgB,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,sBAAsB,CAAC;AAI3G,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAI3D,CAAC;AAIF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAID,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,cAAc,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAID,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,OAAQ,SAAQ,aAAa;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,iBAAiB;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CAC9C;AAID,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAID,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,kBAAkB,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAIzF,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,UAAU,GACV,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAID,wBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAMjD;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,cAAe,SAAQ,KAAK;aACM,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D"}

package/dist/src/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,iFAAiF;AASjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAY;IACnD,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IACxE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW;IACtE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY;IACjE,aAAa,EAAE,UAAU,EAAE,QAAQ;CACpC,CAAC,CAAC;AAcH,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC9D,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,SAAS,EAAE,GAAG;CACf,CAAC;AA+DF,iFAAiF;AAEjF,MAAM,UAAU,MAAM,CAAC,GAAG,KAAe;IACvC,OAAO,KAAK;SACT,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI;SACR,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE,CAAC;AACnB,CAAC;AAWD,iFAAiF;AAEjF,MAAM,OAAO,cAAe,SAAQ,KAAK;IACM;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAUjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAY;IACnD,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IACxE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW;IACtE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY;IACjE,aAAa,EAAE,UAAU,EAAE,QAAQ;CACpC,CAAC,CAAC;AAmBH,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC9D,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,SAAS,EAAE,GAAG;CACf,CAAC;AA2HF,iFAAiF;AAEjF,MAAM,UAAU,MAAM,CAAC,GAAG,KAAe;IACvC,OAAO,KAAK;SACT,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI;SACR,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE,CAAC;AACnB,CAAC;AAWD,iFAAiF;AAEjF,MAAM,OAAO,cAAe,SAAQ,KAAK;IACM;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/src/validation/extraction-validator.d.ts

@@ -0,0 +1,7 @@
+import type { MonographNode, MonographEdge } from '../types.js';
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateExtraction(nodes: MonographNode[], edges: MonographEdge[]): ValidationResult;
+//# sourceMappingURL=extraction-validator.d.ts.map

package/dist/src/validation/extraction-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-validator.d.ts","sourceRoot":"","sources":["../../../src/validation/extraction-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAaD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EAAE,EACtB,KAAK,EAAE,aAAa,EAAE,GACrB,gBAAgB,CAgClB"}

package/dist/src/validation/extraction-validator.js

@@ -0,0 +1,43 @@
+const VALID_LABELS = new Set([
+    'File', 'Folder', 'Function', 'Class', 'Method', 'Interface',
+    'Variable', 'Struct', 'Enum', 'Macro', 'Typedef', 'Union',
+    'Namespace', 'Trait', 'Impl', 'TypeAlias', 'Const', 'Static',
+    'Property', 'Record', 'Delegate', 'Annotation', 'Constructor',
+    'Template', 'Module', 'Process', 'Route', 'Community', 'Concept',
+    'Document', 'Tool', 'Entity', 'Field',
+]);
+const VALID_CONFIDENCES = new Set(['EXTRACTED', 'INFERRED', 'AMBIGUOUS']);
+export function validateExtraction(nodes, edges) {
+    const errors = [];
+    const nodeIds = new Set(nodes.map(n => n.id));
+    for (const n of nodes) {
+        if (!n.id)
+            errors.push(`Node missing id: ${JSON.stringify(n.name)}`);
+        if (!n.name)
+            errors.push(`Node ${n.id} missing name`);
+        if (!VALID_LABELS.has(n.label)) {
+            errors.push(`Node ${n.id} has invalid label: ${n.label}`);
+        }
+        if (typeof n.isExported !== 'boolean') {
+            errors.push(`Node ${n.id}: isExported must be boolean`);
+        }
+    }
+    for (const e of edges) {
+        if (!e.id)
+            errors.push(`Edge missing id`);
+        if (!nodeIds.has(e.sourceId)) {
+            errors.push(`Edge ${e.id}: sourceId '${e.sourceId}' references unknown node`);
+        }
+        if (!nodeIds.has(e.targetId)) {
+            errors.push(`Edge ${e.id}: targetId '${e.targetId}' references unknown node`);
+        }
+        if (!VALID_CONFIDENCES.has(e.confidence)) {
+            errors.push(`Edge ${e.id}: invalid confidence '${e.confidence}'`);
+        }
+        if (typeof e.confidenceScore !== 'number') {
+            errors.push(`Edge ${e.id}: confidenceScore must be number`);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=extraction-validator.js.map

package/dist/src/validation/extraction-validator.js.map

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

package/dist/src/watch/watch-runner.d.ts

@@ -0,0 +1,16 @@
+export declare function isRelevantSource(filePath: string): boolean;
+export declare function isRelevantConfig(filePath: string): boolean;
+export declare function collectChangedPaths(rawPaths: string[], root: string): string[];
+export interface WatchRunnerOptions {
+    root: string;
+    noCache?: boolean;
+    quiet?: boolean;
+    clearScreen?: boolean;
+    debounceMs?: number;
+    includeEntryExports?: boolean;
+    onAnalysis: (changedPaths: string[]) => Promise<void>;
+    loadConfig: () => Promise<unknown>;
+}
+export declare function reloadConfigOrKeepPrevious<T>(current: T, loader: () => Promise<T>, onError?: (err: unknown) => void): Promise<T>;
+export declare function debounce<T extends (...args: unknown[]) => void>(fn: T, ms: number): T;
+//# sourceMappingURL=watch-runner.d.ts.map

package/dist/src/watch/watch-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-runner.d.ts","sourceRoot":"","sources":["../../../src/watch/watch-runner.ts"],"names":[],"mappings":"AAaA,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9E;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC;AAED,wBAAsB,0BAA0B,CAAC,CAAC,EAChD,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAC/B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,CAMrF"}