@psnext/lscg 0.1.5 → 0.1.6

package/dist/src/storage/explore-queries.js

@@ -0,0 +1,184 @@
+import { DatabaseSync } from 'node:sqlite';
+import { parseMetadata, parsePoint } from './row-decoders.js';
+const EXPLORE_KINDS = ['contains', 'defines', 'calls', 'imports', 'exports'];
+export function selectExploreAggregates(db, repositoryId, search) {
+    const predicates = ['f.repository_id = ?'];
+    const params = [repositoryId];
+    if (search?.trim()) {
+        predicates.push('(lower(f.path) LIKE ? OR lower(f.path) = ?)');
+        const normalized = search.trim().toLocaleLowerCase();
+        params.push(`%${normalized}%`, normalized);
+    }
+    const rows = db.prepare(`
+    SELECT f.id, f.path, f.language, f.repository_id AS repositoryId,
+      (SELECT count(*) FROM nodes n WHERE n.repository_id = f.repository_id AND n.file_id = f.id) AS childCount
+    FROM files f
+    WHERE ${predicates.join(' AND ')}
+    ORDER BY lower(f.path), f.id
+  `).all(...params);
+    return rows.map((row) => ({ ...row, id: aggregateId(repositoryId, row.id), childCount: Number(row.childCount) }));
+}
+export function selectExploreAggregateEdges(db, repositoryId, kinds = EXPLORE_KINDS) {
+    const safeKinds = kinds.filter((kind) => EXPLORE_KINDS.includes(kind));
+    if (safeKinds.length === 0)
+        return [];
+    const placeholders = safeKinds.map(() => '?').join(', ');
+    const rows = db.prepare(`
+    SELECT MIN(e.id) AS id, e.kind,
+      'aggregate:' || e.repository_id || ':' || sf.id AS sourceAggregateId,
+      'aggregate:' || e.repository_id || ':' || tf.id AS targetAggregateId,
+      AVG(e.confidence) AS confidence, count(*) AS count
+    FROM edges e
+    JOIN nodes s ON s.id = e.source_id AND s.repository_id = e.repository_id
+    JOIN nodes t ON t.id = e.target_id AND t.repository_id = e.repository_id
+    LEFT JOIN files sf ON sf.id = s.file_id
+    LEFT JOIN files tf ON tf.id = t.file_id
+    WHERE e.repository_id = ? AND e.kind IN (${placeholders}) AND sf.id IS NOT NULL AND tf.id IS NOT NULL AND sf.id <> tf.id
+    GROUP BY sf.id, tf.id, e.kind
+    ORDER BY sourceAggregateId, targetAggregateId, e.kind
+  `).all(repositoryId, ...safeKinds);
+    return rows.map((row) => ({
+        id: String(row.id), sourceId: String(row.sourceAggregateId), targetId: String(row.targetAggregateId),
+        sourceAggregateId: String(row.sourceAggregateId), targetAggregateId: String(row.targetAggregateId),
+        kind: row.kind, confidence: Number(row.confidence ?? 0), count: Number(row.count ?? 0), metadata: {}
+    }));
+}
+export function selectExploreSourcesForSearch(db, repositoryId, term, limit = 200) {
+    const normalized = term.trim().toLocaleLowerCase();
+    if (!normalized)
+        return [];
+    const rows = db.prepare(`
+    SELECT n.id, n.kind, n.type, n.name, n.file_id AS fileId,
+      n.start_point AS startPoint, n.end_point AS endPoint, n.metadata_json AS metadataJson, f.path AS path
+    FROM nodes n LEFT JOIN files f ON f.id = n.file_id
+    WHERE n.repository_id = ? AND (
+      lower(COALESCE(n.name, '')) = ? OR
+      lower(COALESCE(f.path, '') || ':' || COALESCE(n.name, '')) = ? OR
+      lower(COALESCE(n.name, '')) LIKE ? OR
+      lower(COALESCE(n.name, '')) LIKE ?
+    )
+    ORDER BY CASE
+      WHEN lower(COALESCE(f.path, '') || ':' || COALESCE(n.name, '')) = ? THEN 0
+      WHEN lower(COALESCE(n.name, '')) = ? THEN 1
+      WHEN lower(COALESCE(n.name, '')) LIKE ? THEN 2 ELSE 3 END,
+      lower(COALESCE(f.path, '')), lower(COALESCE(n.name, '')), n.id
+    LIMIT ?
+  `).all(repositoryId, normalized, normalized, `${normalized}%`, `%${normalized}%`, normalized, normalized, `${normalized}%`, Math.max(1, Math.min(1000, limit)));
+    return rows.map(sourceFromRow);
+}
+export function selectExploreCandidates(db, repositoryId, term, { kind, file, fileAnchor = false, limit = 20 } = {}) {
+    const normalized = term.trim().toLocaleLowerCase();
+    if (!normalized)
+        return [];
+    const safeLimit = Math.max(1, Math.min(100, Math.trunc(limit)));
+    const explicitFiles = db.prepare('SELECT id, path FROM files WHERE repository_id = ? AND path = ? ORDER BY id LIMIT ?').all(repositoryId, term.trim(), safeLimit);
+    if (fileAnchor && explicitFiles.length > 0)
+        return explicitFiles.map((row, index) => {
+            const fileId = String(row.id);
+            const filePath = String(row.path);
+            return { id: aggregateId(repositoryId, fileId), kind: 'file', type: 'file', name: filePath, fileId, path: filePath, startPoint: { row: 0, column: 0 }, endPoint: { row: 0, column: 0 }, metadata: {}, rank: index, match: 'path', qualifiedName: filePath, aggregateId: aggregateId(repositoryId, fileId) };
+        });
+    const stages = [
+        { match: 'exact', predicate: 'lower(COALESCE(n.name, \'\')) = ?', params: [normalized] },
+        { match: 'qualified', predicate: "lower(COALESCE(f.path, '') || ':' || COALESCE(n.name, '')) = ?", params: [normalized] },
+        { match: 'prefix', predicate: 'lower(COALESCE(n.name, \'\')) LIKE ?', params: [`${normalized}%`] },
+        { match: 'substring', predicate: 'lower(COALESCE(n.name, \'\')) LIKE ?', params: [`%${normalized}%`] }
+    ];
+    const result = [];
+    const seen = new Set();
+    for (const stage of stages) {
+        const predicates = ['n.repository_id = ?', stage.predicate];
+        const params = [repositoryId, ...stage.params];
+        if (kind) {
+            predicates.push('n.kind = ?');
+            params.push(kind);
+        }
+        if (file) {
+            predicates.push('f.path = ?');
+            params.push(file);
+        }
+        const rows = db.prepare(`
+      SELECT n.id, n.kind, n.type, n.name, n.file_id AS fileId,
+        n.start_point AS startPoint, n.end_point AS endPoint, n.metadata_json AS metadataJson, f.path AS path
+      FROM nodes n LEFT JOIN files f ON f.id = n.file_id
+      WHERE ${predicates.join(' AND ')}
+      ORDER BY lower(COALESCE(f.path, '')), lower(COALESCE(n.name, '')), n.id LIMIT ?
+    `).all(...params, safeLimit);
+        for (const row of rows) {
+            const source = sourceFromRow(row);
+            if (seen.has(source.id))
+                continue;
+            seen.add(source.id);
+            result.push({ ...source, rank: result.length, match: stage.match, qualifiedName: qualifiedName(source), aggregateId: source.fileId ? aggregateId(repositoryId, source.fileId) : null });
+        }
+        if (result.length > 0)
+            break;
+    }
+    // A path is an explicit file identity and resolves to its aggregate.
+    for (const row of explicitFiles) {
+        const fileId = String(row.id);
+        const id = aggregateId(repositoryId, fileId);
+        if (seen.has(id))
+            continue;
+        result.push({ id, kind: 'file', type: 'file', name: String(row.path), fileId, path: String(row.path), startPoint: { row: 0, column: 0 }, endPoint: { row: 0, column: 0 }, metadata: {}, rank: result.length, match: 'path', qualifiedName: String(row.path), aggregateId: id });
+    }
+    return result.slice(0, safeLimit);
+}
+export function selectExploreNode(db, repositoryId, id) {
+    const row = db.prepare(`
+    SELECT n.id, n.kind, n.type, n.name, n.file_id AS fileId,
+      n.start_point AS startPoint, n.end_point AS endPoint, n.metadata_json AS metadataJson, f.path AS path
+    FROM nodes n LEFT JOIN files f ON f.id = n.file_id WHERE n.repository_id = ? AND n.id = ?
+  `).get(repositoryId, id);
+    return row ? sourceFromRow(row) : null;
+}
+export function selectExploreTraversalEdges(db, repositoryId, frontier, direction, kinds, limit) {
+    if (frontier.length === 0 || limit <= 0)
+        return [];
+    const safeKinds = kinds.filter((kind) => EXPLORE_KINDS.includes(kind));
+    if (safeKinds.length === 0)
+        return [];
+    const nodePlaceholders = frontier.map(() => '?').join(', ');
+    const kindPlaceholders = safeKinds.map(() => '?').join(', ');
+    const adjacency = direction === 'incoming'
+        ? `(e.target_id IN (${nodePlaceholders}))`
+        : direction === 'outgoing'
+            ? `(e.source_id IN (${nodePlaceholders}))`
+            : `(e.source_id IN (${nodePlaceholders}) OR e.target_id IN (${nodePlaceholders}))`;
+    const nodeParams = direction === 'both' ? [...frontier, ...frontier] : [...frontier];
+    const rows = db.prepare(`
+    SELECT e.id, e.source_id AS sourceId, e.target_id AS targetId, e.kind, e.confidence, e.metadata_json AS metadataJson
+    FROM edges e
+    WHERE e.repository_id = ? AND e.kind IN (${kindPlaceholders}) AND ${adjacency}
+    ORDER BY e.kind, e.id
+    LIMIT ?
+  `).all(repositoryId, ...safeKinds, ...nodeParams, Math.max(1, limit));
+    return rows.map((row) => ({ id: String(row.id), sourceId: String(row.sourceId), targetId: String(row.targetId), kind: row.kind, confidence: Number(row.confidence ?? 0), metadata: parseMetadata(row.metadataJson) }));
+}
+export function selectExploreNodeRows(db, repositoryId, ids) {
+    if (ids.length === 0)
+        return [];
+    const placeholders = ids.map(() => '?').join(', ');
+    const rows = db.prepare(`
+    SELECT n.id, n.kind, n.type, n.name, n.file_id AS fileId,
+      n.start_point AS startPoint, n.end_point AS endPoint, n.metadata_json AS metadataJson, f.path AS path
+    FROM nodes n LEFT JOIN files f ON f.id = n.file_id
+    WHERE n.repository_id = ? AND n.id IN (${placeholders})
+  `).all(repositoryId, ...ids);
+    const byId = new Map(rows.map((row) => [String(row.id), sourceFromRow(row)]));
+    return ids.flatMap((id) => byId.get(id) ? [byId.get(id)] : []);
+}
+export function aggregateId(repositoryId, fileId) {
+    return `aggregate:${repositoryId}:${fileId}`;
+}
+function sourceFromRow(row) {
+    return {
+        id: String(row.id), kind: row.kind, type: String(row.type), name: row.name == null ? null : String(row.name),
+        fileId: row.fileId == null ? null : String(row.fileId), path: row.path == null ? null : String(row.path),
+        startPoint: parsePoint(row.startPoint), endPoint: parsePoint(row.endPoint), metadata: parseMetadata(row.metadataJson)
+    };
+}
+function qualifiedName(source) {
+    return source.name && source.path ? `${source.path}:${source.name}` : source.name;
+}
+//# sourceMappingURL=explore-queries.js.map

package/dist/src/storage/graph-writes.d.ts

@@ -1,21 +1,27 @@
 import { DatabaseSync } from 'node:sqlite';
 import type { AttributionApplyResult, AttributionOutcome, FileRecord, GraphEdge, GraphNode, RepositoryRecord } from '../types.js';
 export declare function upsertRepository(db: DatabaseSync, repository: RepositoryRecord): void;
-export declare function replaceFileGraph(db: DatabaseSync, { repository, file, nodes, edges }: {
+export declare function replaceFileGraph(db: DatabaseSync, { repository, file, nodes, edges, enrichment }: {
     repository: RepositoryRecord;
     file: FileRecord;
     nodes: GraphNode[];
     edges: GraphEdge[];
+    enrichment?: {
+        pluginName: string;
+        historyFingerprint: string | null;
+    };
 }): void;
 /**
  * Applies optional attribution only when it still matches the structural file
  * hash. Failed outcomes never mutate existing attribution.
  */
-export declare function applyFileAttribution(db: DatabaseSync, { repository, fileId, sourceHash, outcome }: {
+export declare function applyFileAttribution(db: DatabaseSync, { repository, fileId, sourceHash, outcome, pluginName, historyFingerprint }: {
     repository: RepositoryRecord;
     fileId: string;
     sourceHash: string;
     outcome: AttributionOutcome;
+    pluginName?: string;
+    historyFingerprint?: string | null;
 }): AttributionApplyResult;
 export declare function reconcileDeletedFiles(db: DatabaseSync, repositoryId: string, discoveredPaths: string[]): void;
 export declare function recordFileScanFailure(db: DatabaseSync, repositoryId: string, filePath: string, diagnostic: string): void;

package/dist/src/storage/graph-writes.js

@@ -10,7 +10,7 @@ export function upsertRepository(db, repository) {
       updated_at = datetime('now')
   `).run(repository.id, repository.root, repository.name);
 }
-export function replaceFileGraph(db, { repository, file, nodes, edges }) {
+export function replaceFileGraph(db, { repository, file, nodes, edges, enrichment }) {
     upsertRepository(db, repository);
     db.exec('BEGIN IMMEDIATE');
     try {
@@ -42,14 +42,15 @@ export function replaceFileGraph(db, { repository, file, nodes, edges }) {
         }
         const insertEdge = db.prepare(`
       INSERT INTO edges(
-        id, repository_id, file_id, source_id, target_id, kind, confidence, metadata_json
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        id, repository_id, file_id, source_id, target_id, kind, type, confidence, metadata_json
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
     `);
         for (const edge of edges) {
-            insertEdge.run(edge.id, repository.id, file.id, edge.sourceId, edge.targetId, edge.kind, edge.confidence ?? 1, JSON.stringify(edge.metadata ?? {}));
+            insertEdge.run(edge.id, repository.id, file.id, edge.sourceId, edge.targetId, edge.kind, edge.type ?? edge.kind, edge.confidence ?? 1, JSON.stringify(edge.metadata ?? {}));
         }
         restorePriorAttribution(db, file.id, new Set(nodes.map((node) => node.id)), priorAttribution);
-        queueFileEnrichment(db, repository.id, file.id, file.hash);
+        if (enrichment)
+            queueFileEnrichment(db, repository.id, file.id, file.hash, enrichment.pluginName, enrichment.historyFingerprint);
         db.exec('COMMIT');
     }
     catch (error) {
@@ -61,27 +62,34 @@ export function replaceFileGraph(db, { repository, file, nodes, edges }) {
  * Applies optional attribution only when it still matches the structural file
  * hash. Failed outcomes never mutate existing attribution.
  */
-export function applyFileAttribution(db, { repository, fileId, sourceHash, outcome }) {
+export function applyFileAttribution(db, { repository, fileId, sourceHash, outcome, pluginName = 'git-attribution-plugin', historyFingerprint = null }) {
     db.exec('BEGIN IMMEDIATE');
     try {
         const current = db.prepare(`
-      SELECT f.hash AS sourceHash, e.source_hash AS enrichmentHash
-      FROM files f LEFT JOIN file_enrichment_state e ON e.file_id = f.id
-      WHERE f.id = ? AND f.repository_id = ?
-    `).get(fileId, repository.id);
-        if (current?.sourceHash !== sourceHash || current.enrichmentHash !== sourceHash) {
+        SELECT f.hash AS sourceHash, e.source_hash AS enrichmentHash,
+          e.plugin_name AS pluginName, e.history_fingerprint AS historyFingerprint
+        FROM files f LEFT JOIN file_enrichment_state e ON e.file_id = f.id
+        WHERE f.id = ? AND f.repository_id = ?
+      `).get(fileId, repository.id);
+        if (current?.sourceHash === sourceHash && current.enrichmentHash === undefined) {
+            queueFileEnrichment(db, repository.id, fileId, sourceHash, pluginName, historyFingerprint);
+        }
+        const refreshed = current?.enrichmentHash === undefined
+            ? { ...current, enrichmentHash: sourceHash, pluginName, historyFingerprint }
+            : current;
+        if (refreshed?.sourceHash !== sourceHash || refreshed.enrichmentHash !== sourceHash || refreshed.pluginName !== pluginName || refreshed.historyFingerprint !== historyFingerprint) {
             db.exec('ROLLBACK');
             return 'stale';
         }
         if (outcome.status === 'complete') {
             replaceAttribution(db, repository, fileId, outcome.attribution);
-            setFileEnrichmentState(db, repository.id, fileId, 'complete', null);
+            setFileEnrichmentState(db, repository.id, fileId, 'complete', 'complete', null);
         }
         else if (outcome.status === 'unavailable') {
-            setFileEnrichmentState(db, repository.id, fileId, 'complete', null);
+            setFileEnrichmentState(db, repository.id, fileId, 'complete', 'unavailable', `unavailable:${outcome.reason}`);
         }
         else {
-            setFileEnrichmentState(db, repository.id, fileId, 'failed', outcome.diagnostic);
+            setFileEnrichmentState(db, repository.id, fileId, 'failed', 'failed', outcome.diagnostic);
         }
         db.exec('COMMIT');
         return 'applied';
@@ -136,49 +144,63 @@ export function selectFileInventory(db, repositoryId) {
 function captureFileAttribution(db, fileId) {
     return {
         lastModified: db.prepare(`
-      SELECT id AS nodeId, last_modified_user_id AS userId
+      SELECT id AS nodeId, last_modified_user_id AS userId,
+        kind || ':' || type || ':' || COALESCE(name, '') AS key
       FROM nodes
       WHERE file_id = ? AND last_modified_user_id IS NOT NULL
     `).all(fileId),
         edges: db.prepare(`
-      SELECT id, source_id AS sourceId, target_id AS targetId, confidence, metadata_json AS metadataJson
-      FROM edges
-      WHERE file_id = ? AND kind = 'attributed_to'
+      SELECT e.id, e.source_id AS sourceId,
+        n.kind || ':' || n.type || ':' || COALESCE(n.name, '') AS sourceKey,
+        e.target_id AS targetId, e.confidence, e.metadata_json AS metadataJson
+      FROM edges e JOIN nodes n ON n.id = e.source_id
+      WHERE e.file_id = ? AND e.kind = 'attributed_to'
     `).all(fileId)
     };
 }
 function restorePriorAttribution(db, fileId, currentNodeIds, prior) {
+    const currentByKey = new Map(db.prepare(`
+    SELECT id, kind || ':' || type || ':' || COALESCE(name, '') AS key
+    FROM nodes WHERE file_id = ?
+  `).all(fileId).map((row) => [row.key, row.id]));
+    const mappedNodeId = (nodeId, key) => currentNodeIds.has(nodeId) ? nodeId : currentByKey.get(key);
     const updateLastModified = db.prepare('UPDATE nodes SET last_modified_user_id = ? WHERE id = ? AND file_id = ?');
     for (const entry of prior.lastModified) {
-        if (currentNodeIds.has(entry.nodeId))
-            updateLastModified.run(entry.userId, entry.nodeId, fileId);
+        const currentId = mappedNodeId(entry.nodeId, entry.key);
+        if (currentId)
+            updateLastModified.run(entry.userId, currentId, fileId);
     }
     const insertEdge = db.prepare(`
-    INSERT OR IGNORE INTO edges(id, repository_id, file_id, source_id, target_id, kind, confidence, metadata_json)
-    SELECT ?, repository_id, ?, ?, ?, 'attributed_to', ?, ?
+    INSERT OR IGNORE INTO edges(id, repository_id, file_id, source_id, target_id, kind, type, confidence, metadata_json)
+    SELECT ?, repository_id, ?, ?, ?, 'attributed_to', 'attributed_to', ?, ?
     FROM files WHERE id = ?
   `);
     for (const edge of prior.edges) {
-        if (currentNodeIds.has(edge.sourceId)) {
-            insertEdge.run(edge.id, fileId, edge.sourceId, edge.targetId, edge.confidence, edge.metadataJson, fileId);
+        const currentSourceId = mappedNodeId(edge.sourceId, edge.sourceKey);
+        if (currentSourceId) {
+            const edgeId = currentSourceId === edge.sourceId ? edge.id : hashParts([fileId, currentSourceId, edge.targetId, 'attributed_to']);
+            insertEdge.run(edgeId, fileId, currentSourceId, edge.targetId, edge.confidence, edge.metadataJson, fileId);
         }
     }
 }
-function queueFileEnrichment(db, repositoryId, fileId, sourceHash) {
+function queueFileEnrichment(db, repositoryId, fileId, sourceHash, pluginName, historyFingerprint) {
     db.prepare(`
     INSERT INTO file_enrichment_state(
-      repository_id, file_id, source_hash, state, diagnostic, queued_at, updated_at, completed_at, failed_at
-    ) VALUES (?, ?, ?, 'pending', NULL, datetime('now'), datetime('now'), NULL, NULL)
+      repository_id, file_id, plugin_name, source_hash, history_fingerprint, state, outcome, diagnostic, queued_at, updated_at, completed_at, failed_at
+    ) VALUES (?, ?, ?, ?, ?, 'pending', NULL, NULL, datetime('now'), datetime('now'), NULL, NULL)
     ON CONFLICT(file_id) DO UPDATE SET
       repository_id = excluded.repository_id,
+      plugin_name = excluded.plugin_name,
       source_hash = excluded.source_hash,
+      history_fingerprint = excluded.history_fingerprint,
       state = 'pending',
+      outcome = NULL,
       diagnostic = NULL,
       queued_at = datetime('now'),
       updated_at = datetime('now'),
       completed_at = NULL,
       failed_at = NULL
-  `).run(repositoryId, fileId, sourceHash);
+  `).run(repositoryId, fileId, pluginName, sourceHash, historyFingerprint);
 }
 function replaceAttribution(db, repository, fileId, attribution) {
     upsertContributorNodes(db, repository, attribution.contributorEmails);
@@ -186,8 +208,8 @@ function replaceAttribution(db, repository, fileId, attribution) {
     db.prepare('UPDATE nodes SET last_modified_user_id = NULL WHERE file_id = ?').run(fileId);
     const updateLastModified = db.prepare('UPDATE nodes SET last_modified_user_id = ? WHERE id = ? AND file_id = ?');
     const insertEdge = db.prepare(`
-    INSERT INTO edges(id, repository_id, file_id, source_id, target_id, kind, confidence, metadata_json)
-    VALUES (?, ?, ?, ?, ?, 'attributed_to', 1, ?)
+    INSERT INTO edges(id, repository_id, file_id, source_id, target_id, kind, type, confidence, metadata_json)
+    VALUES (?, ?, ?, ?, ?, 'attributed_to', 'attributed_to', 1, ?)
   `);
     for (const entry of attribution.nodeAttributions) {
         const lastModifiedUserId = resolveUserId(repository, entry.lastModifiedEmail);
@@ -201,14 +223,14 @@ function replaceAttribution(db, repository, fileId, attribution) {
         }
     }
 }
-function setFileEnrichmentState(db, repositoryId, fileId, state, diagnostic) {
+function setFileEnrichmentState(db, repositoryId, fileId, state, outcome, diagnostic) {
     db.prepare(`
     UPDATE file_enrichment_state
-    SET state = ?, diagnostic = ?, updated_at = datetime('now'),
+    SET state = ?, outcome = ?, diagnostic = ?, updated_at = datetime('now'),
       completed_at = CASE WHEN ? = 'complete' THEN datetime('now') ELSE NULL END,
       failed_at = CASE WHEN ? = 'failed' THEN datetime('now') ELSE NULL END
     WHERE repository_id = ? AND file_id = ?
-  `).run(state, diagnostic, state, state, repositoryId, fileId);
+  `).run(state, outcome, diagnostic, state, state, repositoryId, fileId);
 }
 function upsertContributorNodes(db, repository, contributorEmails) {
     const insertNode = db.prepare(`

package/dist/src/storage/plugin-graph.js

@@ -13,8 +13,8 @@ export function reconcilePluginEdges(db, repository, edges, fileIdByPath, active
       `).run(repository.id, plugin);
         }
         const insert = db.prepare(`
-      INSERT OR REPLACE INTO edges(id, repository_id, file_id, source_id, target_id, kind, confidence, metadata_json)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      INSERT OR REPLACE INTO edges(id, repository_id, file_id, source_id, target_id, kind, type, confidence, metadata_json)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
     `);
         for (const edge of edges) {
             const plugin = typeof edge.metadata.plugin === 'string' ? edge.metadata.plugin : undefined;
@@ -29,7 +29,7 @@ export function reconcilePluginEdges(db, repository, edges, fileIdByPath, active
             const requiredEndpoints = edge.sourceId === edge.targetId ? 1 : 2;
             if (endpoints.count !== requiredEndpoints)
                 continue;
-            insert.run(edge.id, repository.id, fileId, edge.sourceId, edge.targetId, edge.kind, edge.confidence ?? 1, JSON.stringify(edge.metadata ?? {}));
+            insert.run(edge.id, repository.id, fileId, edge.sourceId, edge.targetId, edge.kind, edge.type ?? edge.kind, edge.confidence ?? 1, JSON.stringify(edge.metadata ?? {}));
             inserted += 1;
         }
         db.exec('COMMIT');

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

@@ -19,12 +19,14 @@ export declare function selectAllNodeTextRows(db: DatabaseSync, repositoryId: st
 export declare function selectAllNodes(db: DatabaseSync, repositoryId: string, { kind }?: {
     kind?: string | undefined;
 }): GraphNodeRow[];
-export declare function selectEdges(db: DatabaseSync, repositoryId: string, { kind, limit }?: {
+export declare function selectEdges(db: DatabaseSync, repositoryId: string, { kind, type, limit }?: {
     kind?: string | undefined;
+    type?: string | undefined;
     limit?: number | undefined;
 }): GraphEdgeRow[];
-export declare function selectAllEdges(db: DatabaseSync, repositoryId: string, { kind }?: {
+export declare function selectAllEdges(db: DatabaseSync, repositoryId: string, { kind, type }?: {
     kind?: string | undefined;
+    type?: string | undefined;
 }): GraphEdgeRow[];
 export declare function clampLimit(limit: number | undefined, max?: number): number;
 //# sourceMappingURL=queries.d.ts.map

package/dist/src/storage/queries.js

@@ -13,8 +13,9 @@ export function selectFreshnessReport(db, repositoryId) {
 }
 export function selectFileEnrichmentState(db, repositoryId, fileId) {
     const row = db.prepare(`
-    SELECT repository_id AS repositoryId, file_id AS fileId, source_hash AS sourceHash,
-      state, diagnostic, queued_at AS queuedAt, updated_at AS updatedAt,
+    SELECT repository_id AS repositoryId, file_id AS fileId, plugin_name AS pluginName,
+      source_hash AS sourceHash, history_fingerprint AS historyFingerprint,
+      state, outcome, diagnostic, queued_at AS queuedAt, updated_at AS updatedAt,
       completed_at AS completedAt, failed_at AS failedAt
     FROM file_enrichment_state
     WHERE repository_id = ? AND file_id = ?
@@ -26,8 +27,9 @@ export function selectFileEnrichmentStates(db, repositoryId, states = ['pending'
         return [];
     const placeholders = states.map(() => '?').join(', ');
     return db.prepare(`
-    SELECT repository_id AS repositoryId, file_id AS fileId, source_hash AS sourceHash,
-      state, diagnostic, queued_at AS queuedAt, updated_at AS updatedAt,
+    SELECT repository_id AS repositoryId, file_id AS fileId, plugin_name AS pluginName,
+      source_hash AS sourceHash, history_fingerprint AS historyFingerprint,
+      state, outcome, diagnostic, queued_at AS queuedAt, updated_at AS updatedAt,
       completed_at AS completedAt, failed_at AS failedAt
     FROM file_enrichment_state
     WHERE repository_id = ? AND state IN (${placeholders})
@@ -39,8 +41,9 @@ export function selectEnrichmentWork(db, repositoryId, states = ['pending', 'fai
         return [];
     const placeholders = states.map(() => '?').join(', ');
     return db.prepare(`
-    SELECT e.repository_id AS repositoryId, e.file_id AS fileId, e.source_hash AS sourceHash,
-      e.state, e.diagnostic, e.queued_at AS queuedAt, e.updated_at AS updatedAt,
+    SELECT e.repository_id AS repositoryId, e.file_id AS fileId, e.plugin_name AS pluginName,
+      e.source_hash AS sourceHash, e.history_fingerprint AS historyFingerprint,
+      e.state, e.outcome, e.diagnostic, e.queued_at AS queuedAt, e.updated_at AS updatedAt,
       e.completed_at AS completedAt, e.failed_at AS failedAt, f.path, f.language
     FROM file_enrichment_state e
     JOIN files f ON f.id = e.file_id
@@ -51,11 +54,14 @@ export function selectEnrichmentWork(db, repositoryId, states = ['pending', 'fai
 export function selectEnrichmentSummary(db, repositoryId) {
     const states = selectFileEnrichmentStates(db, repositoryId, ['pending', 'complete', 'failed']);
     const failedEntries = states.filter((entry) => entry.state === 'failed');
+    const unavailable = states.filter((entry) => entry.outcome === 'unavailable');
     return {
-        state: failedEntries.length > 0 ? 'failed' : states.some((entry) => entry.state === 'pending') ? 'pending' : 'complete',
+        state: states.length === 0 ? 'disabled' : failedEntries.length > 0 ? 'failed' : states.some((entry) => entry.state === 'pending') ? 'pending' : 'complete',
         pending: states.filter((entry) => entry.state === 'pending').length,
-        complete: states.filter((entry) => entry.state === 'complete').length,
+        complete: states.filter((entry) => entry.state === 'complete' && entry.outcome !== 'unavailable').length,
         failed: failedEntries.length,
+        unavailable: unavailable.length,
+        notApplicable: unavailable.filter((entry) => entry.diagnostic === 'unavailable:not_applicable').length,
         diagnostics: failedEntries.flatMap((entry) => entry.diagnostic ? [entry.diagnostic] : [])
     };
 }
@@ -153,40 +159,43 @@ export function selectAllNodes(db, repositoryId, { kind } = {}) {
     ORDER BY kind, name IS NULL, name, id
   `).all(repositoryId);
 }
-export function selectEdges(db, repositoryId, { kind, limit = 50 } = {}) {
+export function selectEdges(db, repositoryId, { kind, type, limit = 50 } = {}) {
     const safeLimit = clampLimit(limit);
+    const where = ['repository_id = ?'];
+    const parameters = [repositoryId];
     if (kind) {
-        return db.prepare(`
-      SELECT id, kind, source_id AS sourceId, target_id AS targetId, file_id AS fileId, confidence, metadata_json AS metadataJson
-      FROM edges
-      WHERE repository_id = ? AND kind = ?
-      ORDER BY kind, id
-      LIMIT ?
-    `).all(repositoryId, kind, safeLimit);
+        where.push('kind = ?');
+        parameters.push(kind);
+    }
+    if (type) {
+        where.push('type = ?');
+        parameters.push(type);
     }
     return db.prepare(`
-    SELECT id, kind, source_id AS sourceId, target_id AS targetId, file_id AS fileId, confidence, metadata_json AS metadataJson
+    SELECT id, kind, type, source_id AS sourceId, target_id AS targetId, file_id AS fileId, confidence, metadata_json AS metadataJson
     FROM edges
-    WHERE repository_id = ?
-    ORDER BY kind, id
+    WHERE ${where.join(' AND ')}
+    ORDER BY kind, type, id
     LIMIT ?
-  `).all(repositoryId, safeLimit);
+  `).all(...parameters, safeLimit);
 }
-export function selectAllEdges(db, repositoryId, { kind } = {}) {
+export function selectAllEdges(db, repositoryId, { kind, type } = {}) {
+    const where = ['repository_id = ?'];
+    const parameters = [repositoryId];
     if (kind) {
-        return db.prepare(`
-      SELECT id, kind, source_id AS sourceId, target_id AS targetId, file_id AS fileId, confidence, metadata_json AS metadataJson
-      FROM edges
-      WHERE repository_id = ? AND kind = ?
-      ORDER BY kind, id
-    `).all(repositoryId, kind);
+        where.push('kind = ?');
+        parameters.push(kind);
+    }
+    if (type) {
+        where.push('type = ?');
+        parameters.push(type);
     }
     return db.prepare(`
-    SELECT id, kind, source_id AS sourceId, target_id AS targetId, file_id AS fileId, confidence, metadata_json AS metadataJson
+    SELECT id, kind, type, source_id AS sourceId, target_id AS targetId, file_id AS fileId, confidence, metadata_json AS metadataJson
     FROM edges
-    WHERE repository_id = ?
-    ORDER BY kind, id
-  `).all(repositoryId);
+    WHERE ${where.join(' AND ')}
+    ORDER BY kind, type, id
+  `).all(...parameters);
 }
 export function clampLimit(limit, max = 500) {
     const value = Number(limit) || 50;

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

@@ -1,4 +1,4 @@
-export declare const SCHEMA_VERSION = 7;
-export declare const CREATE_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS schema_migrations (\n  version INTEGER PRIMARY KEY,\n  applied_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS repositories (\n  id TEXT PRIMARY KEY,\n  root TEXT NOT NULL,\n  name TEXT NOT NULL,\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS files (\n  id TEXT PRIMARY KEY,\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  path TEXT NOT NULL,\n  language TEXT NOT NULL,\n  hash TEXT NOT NULL,\n  size INTEGER NOT NULL,\n  mtime_ms INTEGER NOT NULL,\n  scanned_at TEXT NOT NULL DEFAULT (datetime('now')),\n  UNIQUE(repository_id, path)\n);\n\nCREATE TABLE IF NOT EXISTS nodes (\n  id TEXT PRIMARY KEY,\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  file_id TEXT REFERENCES files(id) ON DELETE CASCADE,\n  kind TEXT NOT NULL,\n  type TEXT NOT NULL,\n  name TEXT,\n  start_byte INTEGER NOT NULL,\n  end_byte INTEGER NOT NULL,\n  start_point TEXT NOT NULL,\n  end_point TEXT NOT NULL,\n  source_hash TEXT NOT NULL,\n  parser TEXT NOT NULL,\n  parser_version TEXT NOT NULL,\n  metadata_json TEXT NOT NULL DEFAULT '{}',\n  last_modified_user_id TEXT\n);\n\nCREATE TABLE IF NOT EXISTS edges (\n  id TEXT PRIMARY KEY,\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  file_id TEXT REFERENCES files(id) ON DELETE CASCADE,\n  source_id TEXT NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,\n  target_id TEXT NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,\n  kind TEXT NOT NULL,\n  confidence REAL NOT NULL DEFAULT 1.0,\n  metadata_json TEXT NOT NULL DEFAULT '{}'\n);\n\nCREATE TABLE IF NOT EXISTS overlays (\n  id TEXT PRIMARY KEY,\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  subject_id TEXT NOT NULL,\n  subject_kind TEXT NOT NULL,\n  operation TEXT NOT NULL,\n  metadata_json TEXT NOT NULL DEFAULT '{}',\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_files_repo_path ON files(repository_id, path);\nCREATE INDEX IF NOT EXISTS idx_nodes_repo_kind ON nodes(repository_id, kind);\nCREATE INDEX IF NOT EXISTS idx_nodes_repo_name ON nodes(repository_id, name);\nCREATE INDEX IF NOT EXISTS idx_edges_repo_kind ON edges(repository_id, kind);\nCREATE INDEX IF NOT EXISTS idx_edges_source ON edges(source_id);\nCREATE INDEX IF NOT EXISTS idx_edges_target ON edges(target_id);\n\nCREATE TABLE IF NOT EXISTS plugin_contributions (\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  plugin_name TEXT NOT NULL,\n  generation INTEGER NOT NULL,\n  nodes_json TEXT NOT NULL,\n  edges_json TEXT NOT NULL,\n  updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n  PRIMARY KEY(repository_id, plugin_name)\n);\nCREATE INDEX IF NOT EXISTS idx_plugin_contributions_repo ON plugin_contributions(repository_id);\n\nCREATE TABLE IF NOT EXISTS file_scan_failures (\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  path TEXT NOT NULL,\n  diagnostic TEXT NOT NULL,\n  failed_at TEXT NOT NULL DEFAULT (datetime('now')),\n  PRIMARY KEY(repository_id, path)\n);\n\nCREATE TABLE IF NOT EXISTS repository_scan_state (\n  repository_id TEXT PRIMARY KEY REFERENCES repositories(id) ON DELETE CASCADE,\n  state TEXT NOT NULL CHECK(state IN ('fresh', 'degraded', 'stale')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS file_enrichment_state (\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  file_id TEXT PRIMARY KEY REFERENCES files(id) ON DELETE CASCADE,\n  source_hash TEXT NOT NULL,\n  state TEXT NOT NULL CHECK(state IN ('pending', 'complete', 'failed')),\n  diagnostic TEXT,\n  queued_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n  completed_at TEXT,\n  failed_at TEXT\n);\nCREATE INDEX IF NOT EXISTS idx_file_enrichment_state_repo_state ON file_enrichment_state(repository_id, state);\n\nCREATE TABLE IF NOT EXISTS repository_manifest_inventory (\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  path TEXT NOT NULL,\n  kind TEXT NOT NULL CHECK(kind IN ('maven-pom', 'gradle-groovy', 'gradle-kotlin')),\n  module_identity TEXT NOT NULL,\n  status TEXT NOT NULL CHECK(status IN ('observed', 'read_failed', 'traversal_incomplete', 'confirmed_deleted')),\n  size INTEGER NOT NULL,\n  mtime_ms INTEGER NOT NULL,\n  source_hash TEXT,\n  generation INTEGER NOT NULL,\n  updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n  PRIMARY KEY(repository_id, path)\n);\nCREATE INDEX IF NOT EXISTS idx_repository_manifest_inventory_repo_status\n  ON repository_manifest_inventory(repository_id, status);\n";
+export declare const SCHEMA_VERSION = 9;
+export declare const CREATE_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS schema_migrations (\n  version INTEGER PRIMARY KEY,\n  applied_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS repositories (\n  id TEXT PRIMARY KEY,\n  root TEXT NOT NULL,\n  name TEXT NOT NULL,\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS files (\n  id TEXT PRIMARY KEY,\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  path TEXT NOT NULL,\n  language TEXT NOT NULL,\n  hash TEXT NOT NULL,\n  size INTEGER NOT NULL,\n  mtime_ms INTEGER NOT NULL,\n  scanned_at TEXT NOT NULL DEFAULT (datetime('now')),\n  UNIQUE(repository_id, path)\n);\n\nCREATE TABLE IF NOT EXISTS nodes (\n  id TEXT PRIMARY KEY,\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  file_id TEXT REFERENCES files(id) ON DELETE CASCADE,\n  kind TEXT NOT NULL,\n  type TEXT NOT NULL,\n  name TEXT,\n  start_byte INTEGER NOT NULL,\n  end_byte INTEGER NOT NULL,\n  start_point TEXT NOT NULL,\n  end_point TEXT NOT NULL,\n  source_hash TEXT NOT NULL,\n  parser TEXT NOT NULL,\n  parser_version TEXT NOT NULL,\n  metadata_json TEXT NOT NULL DEFAULT '{}',\n  last_modified_user_id TEXT\n);\n\nCREATE TABLE IF NOT EXISTS edges (\n  id TEXT PRIMARY KEY,\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  file_id TEXT REFERENCES files(id) ON DELETE CASCADE,\n  source_id TEXT NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,\n  target_id TEXT NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,\n  kind TEXT NOT NULL,\n  type TEXT NOT NULL,\n  confidence REAL NOT NULL DEFAULT 1.0,\n  metadata_json TEXT NOT NULL DEFAULT '{}'\n);\n\nCREATE TABLE IF NOT EXISTS overlays (\n  id TEXT PRIMARY KEY,\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  subject_id TEXT NOT NULL,\n  subject_kind TEXT NOT NULL,\n  operation TEXT NOT NULL,\n  metadata_json TEXT NOT NULL DEFAULT '{}',\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_files_repo_path ON files(repository_id, path);\nCREATE INDEX IF NOT EXISTS idx_nodes_repo_kind ON nodes(repository_id, kind);\nCREATE INDEX IF NOT EXISTS idx_nodes_repo_name ON nodes(repository_id, name);\nCREATE INDEX IF NOT EXISTS idx_edges_repo_kind ON edges(repository_id, kind);\nCREATE INDEX IF NOT EXISTS idx_edges_source ON edges(source_id);\nCREATE INDEX IF NOT EXISTS idx_edges_target ON edges(target_id);\n\nCREATE TABLE IF NOT EXISTS plugin_contributions (\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  plugin_name TEXT NOT NULL,\n  generation INTEGER NOT NULL,\n  nodes_json TEXT NOT NULL,\n  edges_json TEXT NOT NULL,\n  updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n  PRIMARY KEY(repository_id, plugin_name)\n);\nCREATE INDEX IF NOT EXISTS idx_plugin_contributions_repo ON plugin_contributions(repository_id);\n\nCREATE TABLE IF NOT EXISTS file_scan_failures (\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  path TEXT NOT NULL,\n  diagnostic TEXT NOT NULL,\n  failed_at TEXT NOT NULL DEFAULT (datetime('now')),\n  PRIMARY KEY(repository_id, path)\n);\n\nCREATE TABLE IF NOT EXISTS repository_scan_state (\n  repository_id TEXT PRIMARY KEY REFERENCES repositories(id) ON DELETE CASCADE,\n  state TEXT NOT NULL CHECK(state IN ('fresh', 'degraded', 'stale')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS file_enrichment_state (\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  file_id TEXT PRIMARY KEY REFERENCES files(id) ON DELETE CASCADE,\n  plugin_name TEXT NOT NULL DEFAULT 'git-attribution-plugin',\n  source_hash TEXT NOT NULL,\n  history_fingerprint TEXT,\n  state TEXT NOT NULL CHECK(state IN ('pending', 'complete', 'failed')),\n  outcome TEXT CHECK(outcome IN ('complete', 'unavailable', 'failed')),\n  diagnostic TEXT,\n  queued_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n  completed_at TEXT,\n  failed_at TEXT\n);\nCREATE INDEX IF NOT EXISTS idx_file_enrichment_state_repo_state ON file_enrichment_state(repository_id, state);\n\nCREATE TABLE IF NOT EXISTS repository_manifest_inventory (\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  path TEXT NOT NULL,\n  kind TEXT NOT NULL CHECK(kind IN ('maven-pom', 'gradle-groovy', 'gradle-kotlin')),\n  module_identity TEXT NOT NULL,\n  status TEXT NOT NULL CHECK(status IN ('observed', 'read_failed', 'traversal_incomplete', 'confirmed_deleted')),\n  size INTEGER NOT NULL,\n  mtime_ms INTEGER NOT NULL,\n  source_hash TEXT,\n  generation INTEGER NOT NULL,\n  updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n  PRIMARY KEY(repository_id, path)\n);\nCREATE INDEX IF NOT EXISTS idx_repository_manifest_inventory_repo_status\n  ON repository_manifest_inventory(repository_id, status);\n";
 export declare const CREATE_NODES_TABLE_SQL = "\nCREATE TABLE nodes_new (\n  id TEXT PRIMARY KEY,\n  repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,\n  file_id TEXT REFERENCES files(id) ON DELETE CASCADE,\n  kind TEXT NOT NULL,\n  type TEXT NOT NULL,\n  name TEXT,\n  start_byte INTEGER NOT NULL,\n  end_byte INTEGER NOT NULL,\n  start_point TEXT NOT NULL,\n  end_point TEXT NOT NULL,\n  source_hash TEXT NOT NULL,\n  parser TEXT NOT NULL,\n  parser_version TEXT NOT NULL,\n  metadata_json TEXT NOT NULL DEFAULT '{}',\n  last_modified_user_id TEXT\n);\n";
 //# sourceMappingURL=schema.d.ts.map

package/dist/src/storage/schema.js

@@ -1,4 +1,4 @@
-export const SCHEMA_VERSION = 7;
+export const SCHEMA_VERSION = 9;
 export const CREATE_SCHEMA_SQL = `
 CREATE TABLE IF NOT EXISTS schema_migrations (
   version INTEGER PRIMARY KEY,
@@ -50,6 +50,7 @@ CREATE TABLE IF NOT EXISTS edges (
   source_id TEXT NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
   target_id TEXT NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
   kind TEXT NOT NULL,
+  type TEXT NOT NULL,
   confidence REAL NOT NULL DEFAULT 1.0,
   metadata_json TEXT NOT NULL DEFAULT '{}'
 );
@@ -99,8 +100,11 @@ CREATE TABLE IF NOT EXISTS repository_scan_state (
 CREATE TABLE IF NOT EXISTS file_enrichment_state (
   repository_id TEXT NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,
   file_id TEXT PRIMARY KEY REFERENCES files(id) ON DELETE CASCADE,
+  plugin_name TEXT NOT NULL DEFAULT 'git-attribution-plugin',
   source_hash TEXT NOT NULL,
+  history_fingerprint TEXT,
   state TEXT NOT NULL CHECK(state IN ('pending', 'complete', 'failed')),
+  outcome TEXT CHECK(outcome IN ('complete', 'unavailable', 'failed')),
   diagnostic TEXT,
   queued_at TEXT NOT NULL DEFAULT (datetime('now')),
   updated_at TEXT NOT NULL DEFAULT (datetime('now')),