fivocell 3.1.0 → 4.1.0

package/dist/core/knowledge-graph-store.d.ts

@@ -0,0 +1,69 @@
+import { KnowledgeGraph as FileGraph } from '../knowledge-graph-builder';
+export interface PatternGraphNode {
+    id: string;
+    type: string;
+    label: string;
+    weight: number;
+}
+export interface PatternGraphEdge {
+    from: string;
+    to: string;
+    type: string;
+    weight: number;
+}
+export interface TechProficiency {
+    technology: string;
+    category: string;
+    signalsCount: number;
+    proficiencyScore: number;
+    lastSeen: string;
+    trend: 'up' | 'down' | 'stable';
+}
+export interface BlastRadius {
+    target: string;
+    riskScore: number;
+    dependents: string[];
+    totalFiles: number;
+    complexity: number;
+    recommendation: string;
+}
+export declare function saveFileKnowledgeGraph(project: string, dirPath: string): FileGraph;
+export declare function getFileKnowledgeGraph(project: string): {
+    files: Array<{
+        file: string;
+        complexity: number;
+        importedBy: number;
+        isEntryPoint: boolean;
+        riskScore: number;
+    }>;
+    deps: Array<{
+        from: string;
+        to: string;
+    }>;
+    stats: {
+        totalFiles: number;
+        totalDeps: number;
+        avgComplexity: number;
+        highRiskCount: number;
+    };
+};
+export declare function savePatternEntities(project: string, nodes: PatternGraphNode[]): number;
+export declare function savePatternRelationships(project: string, edges: PatternGraphEdge[]): number;
+export declare function getPatternGraphStats(project: string): {
+    totalNodes: number;
+    totalEdges: number;
+    byType: Record<string, number>;
+    byRelType: Record<string, number>;
+};
+export declare function saveTechProficiency(project: string, tech: TechProficiency): void;
+export declare function getTechProficiency(project: string): TechProficiency[];
+export declare function computeBlastRadius(project: string, targetFile: string): BlastRadius;
+export declare function getTopBlastRadii(project: string, limit?: number): BlastRadius[];
+export declare function getPredictiveInsights(project: string, limit?: number): Array<{
+    type: string;
+    target: string;
+    score: number;
+    recommendation: string;
+    createdAt: string;
+}>;
+//# sourceMappingURL=knowledge-graph-store.d.ts.map

package/dist/core/knowledge-graph-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph-store.d.ts","sourceRoot":"","sources":["../../src/core/knowledge-graph-store.ts"],"names":[],"mappings":"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"}

package/dist/core/knowledge-graph-store.js

@@ -0,0 +1,269 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveFileKnowledgeGraph = saveFileKnowledgeGraph;
+exports.getFileKnowledgeGraph = getFileKnowledgeGraph;
+exports.savePatternEntities = savePatternEntities;
+exports.savePatternRelationships = savePatternRelationships;
+exports.getPatternGraphStats = getPatternGraphStats;
+exports.saveTechProficiency = saveTechProficiency;
+exports.getTechProficiency = getTechProficiency;
+exports.computeBlastRadius = computeBlastRadius;
+exports.getTopBlastRadii = getTopBlastRadii;
+exports.getPredictiveInsights = getPredictiveInsights;
+const database_1 = require("./database");
+const knowledge_graph_builder_1 = require("../knowledge-graph-builder");
+const path = __importStar(require("path"));
+function ensureKGProjectDir(project) {
+    return project;
+}
+function saveFileKnowledgeGraph(project, dirPath) {
+    const db = (0, database_1.getDb)();
+    const graph = (0, knowledge_graph_builder_1.buildKnowledgeGraph)(dirPath);
+    db.prepare('DELETE FROM knowledge_graph_files WHERE project = ?').run(project);
+    db.prepare('DELETE FROM knowledge_graph_deps WHERE project = ?').run(project);
+    const insertFile = db.prepare(`
+    INSERT OR REPLACE INTO knowledge_graph_files
+      (project, file_path, complexity, import_count, imported_by_count, is_entry_point, risk_score, built_at)
+    VALUES (?, ?, ?, ?, ?, ?, 0, datetime('now'))
+  `);
+    const insertDep = db.prepare(`
+    INSERT OR IGNORE INTO knowledge_graph_deps (project, from_file, to_file, built_at)
+    VALUES (?, ?, ?, datetime('now'))
+  `);
+    const insertFiles = db.transaction((nodes) => {
+        for (const n of nodes) {
+            insertFile.run(project, n.file.split(path.sep).join('/'), n.complexity, n.imports.length, n.importedBy.length, n.isEntryPoint ? 1 : 0);
+        }
+    });
+    const insertDeps = db.transaction((nodes) => {
+        for (const n of nodes) {
+            for (const dep of n.imports) {
+                insertDep.run(project, n.file.split(path.sep).join('/'), dep.split(path.sep).join('/'));
+            }
+        }
+    });
+    insertFiles(graph.nodes);
+    insertDeps(graph.nodes);
+    // Compute risk score = complexity * (importedBy + 1)
+    for (const n of graph.nodes) {
+        const dependents = n.importedBy.length;
+        const risk = Math.min(100, Math.round(n.complexity * (dependents + 1) / 2));
+        db.prepare('UPDATE knowledge_graph_files SET risk_score = ? WHERE project = ? AND file_path = ?')
+            .run(risk, project, n.file.split(path.sep).join('/'));
+    }
+    return graph;
+}
+function getFileKnowledgeGraph(project) {
+    const db = (0, database_1.getDb)();
+    const files = db.prepare(`
+    SELECT file_path, complexity, imported_by_count, is_entry_point, risk_score
+    FROM knowledge_graph_files WHERE project = ? ORDER BY risk_score DESC, complexity DESC
+  `).all(project);
+    const deps = db.prepare(`
+    SELECT from_file, to_file FROM knowledge_graph_deps WHERE project = ?
+  `).all(project);
+    const totalComplexity = files.reduce((s, f) => s + f.complexity, 0);
+    const highRisk = files.filter(f => f.risk_score >= 50).length;
+    return {
+        files: files.map(f => ({
+            file: f.file_path,
+            complexity: f.complexity,
+            importedBy: f.imported_by_count,
+            isEntryPoint: f.is_entry_point === 1,
+            riskScore: f.risk_score,
+        })),
+        deps: deps.map(d => ({ from: d.from_file, to: d.to_file })),
+        stats: {
+            totalFiles: files.length,
+            totalDeps: deps.length,
+            avgComplexity: files.length > 0 ? Math.round(totalComplexity / files.length) : 0,
+            highRiskCount: highRisk,
+        },
+    };
+}
+function savePatternEntities(project, nodes) {
+    const db = (0, database_1.getDb)();
+    const stmt = db.prepare(`
+    INSERT OR REPLACE INTO graph_entities (entity_name, entity_type, pattern_id, weight, built_at)
+    VALUES (?, ?, ?, ?, datetime('now'))
+  `);
+    let count = 0;
+    const tx = db.transaction((ns) => {
+        for (const n of ns) {
+            stmt.run(n.id, n.type, n.id, n.weight);
+            count++;
+        }
+    });
+    tx(nodes);
+    return count;
+}
+function savePatternRelationships(project, edges) {
+    const db = (0, database_1.getDb)();
+    const stmt = db.prepare(`
+    INSERT OR REPLACE INTO graph_relationships (from_pattern, to_pattern, rel_type, strength, built_at)
+    VALUES (?, ?, ?, ?, datetime('now'))
+  `);
+    let count = 0;
+    const tx = db.transaction((es) => {
+        for (const e of es) {
+            stmt.run(e.from, e.to, e.type, e.weight);
+            count++;
+        }
+    });
+    tx(edges);
+    return count;
+}
+function getPatternGraphStats(project) {
+    const db = (0, database_1.getDb)();
+    const nodes = db.prepare('SELECT entity_type, COUNT(*) as c FROM graph_entities GROUP BY entity_type').all();
+    const edges = db.prepare('SELECT rel_type, COUNT(*) as c FROM graph_relationships GROUP BY rel_type').all();
+    return {
+        totalNodes: nodes.reduce((s, n) => s + n.c, 0),
+        totalEdges: edges.reduce((s, e) => s + e.c, 0),
+        byType: Object.fromEntries(nodes.map(n => [n.entity_type, n.c])),
+        byRelType: Object.fromEntries(edges.map(e => [e.rel_type, e.c])),
+    };
+}
+function saveTechProficiency(project, tech) {
+    const db = (0, database_1.getDb)();
+    db.prepare(`
+    INSERT INTO tech_proficiency (project, technology, category, signals_count, proficiency_score, last_seen, trend)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT(project, technology) DO UPDATE SET
+      category = excluded.category,
+      signals_count = tech_proficiency.signals_count + excluded.signals_count,
+      proficiency_score = MAX(tech_proficiency.proficiency_score, excluded.proficiency_score),
+      last_seen = excluded.last_seen,
+      trend = excluded.trend
+  `).run(project, tech.technology, tech.category, tech.signalsCount, tech.proficiencyScore, tech.lastSeen, tech.trend);
+}
+function getTechProficiency(project) {
+    const db = (0, database_1.getDb)();
+    const rows = db.prepare(`
+    SELECT technology, category, signals_count, proficiency_score, last_seen, trend
+    FROM tech_proficiency WHERE project = ? ORDER BY proficiency_score DESC
+  `).all(project);
+    return rows.map(r => ({
+        technology: r.technology,
+        category: r.category,
+        signalsCount: r.signals_count,
+        proficiencyScore: r.proficiency_score,
+        lastSeen: r.last_seen,
+        trend: r.trend,
+    }));
+}
+// Phase 3.5: Blast radius — given a risky file, find all dependents
+function computeBlastRadius(project, targetFile) {
+    const db = (0, database_1.getDb)();
+    const target = targetFile.split(path.sep).join('/');
+    // BFS to find all transitive dependents
+    const visited = new Set();
+    const queue = [target];
+    const dependents = new Set();
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (visited.has(current))
+            continue;
+        visited.add(current);
+        const rows = db.prepare(`
+      SELECT from_file FROM knowledge_graph_deps WHERE project = ? AND to_file = ?
+    `).all(project, current.split(path.sep).join('/'));
+        for (const r of rows) {
+            if (!visited.has(r.from_file)) {
+                dependents.add(r.from_file);
+                queue.push(r.from_file);
+            }
+        }
+    }
+    const fileRow = db.prepare(`
+    SELECT complexity, risk_score FROM knowledge_graph_files WHERE project = ? AND file_path = ?
+  `).get(project, target);
+    const complexity = fileRow?.complexity || 0;
+    const totalDependents = dependents.size;
+    // Blast radius = complexity * log(dependents + 1), capped at 100
+    const blast = Math.min(100, Math.round(complexity * Math.log(totalDependents + 1)));
+    let recommendation = '';
+    if (blast >= 75) {
+        recommendation = `CRITICAL: changes to ${target} will impact ${totalDependents} files. Add regression tests before editing.`;
+    }
+    else if (blast >= 50) {
+        recommendation = `HIGH RISK: ${totalDependents} dependents. Test all of them after changes.`;
+    }
+    else if (blast >= 25) {
+        recommendation = `MODERATE: ${totalDependents} dependents. Spot-check related code.`;
+    }
+    else {
+        recommendation = `LOW RISK: ${totalDependents} dependents. Safe to refactor.`;
+    }
+    // Save insight
+    db.prepare(`
+    INSERT INTO predictive_insights (project, insight_type, target, score, recommendation)
+    VALUES (?, 'blast_radius', ?, ?, ?)
+  `).run(project, target, blast, recommendation);
+    return {
+        target,
+        riskScore: blast,
+        dependents: Array.from(dependents).slice(0, 20),
+        totalFiles: totalDependents,
+        complexity,
+        recommendation,
+    };
+}
+function getTopBlastRadii(project, limit = 5) {
+    const db = (0, database_1.getDb)();
+    const rows = db.prepare(`
+    SELECT file_path FROM knowledge_graph_files
+    WHERE project = ? AND risk_score >= 50
+    ORDER BY risk_score DESC LIMIT ?
+  `).all(project, limit);
+    return rows.map(r => computeBlastRadius(project, r.file_path));
+}
+function getPredictiveInsights(project, limit = 20) {
+    const db = (0, database_1.getDb)();
+    const rows = db.prepare(`
+    SELECT insight_type, target, score, recommendation, created_at
+    FROM predictive_insights WHERE project = ?
+    ORDER BY score DESC, created_at DESC LIMIT ?
+  `).all(project, limit);
+    return rows.map(r => ({
+        type: r.insight_type,
+        target: r.target,
+        score: r.score,
+        recommendation: r.recommendation,
+        createdAt: r.created_at,
+    }));
+}
+//# sourceMappingURL=knowledge-graph-store.js.map

package/dist/core/knowledge-graph-store.js.map

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

package/dist/core/live-watcher.d.ts

@@ -0,0 +1,52 @@
+export type LiveEventType = 'file_save' | 'file_create' | 'file_delete' | 'file_rename' | 'git_commit' | 'package_change';
+export interface LiveEvent {
+    id: number;
+    project: string;
+    eventType: LiveEventType;
+    filePath: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+export interface WatcherInfo {
+    project: string;
+    dirPath: string;
+    active: boolean;
+    eventCount: number;
+    lastEventAt: string;
+    startedAt: string;
+}
+export interface RefreshTrigger {
+    type: 'manual' | 'stale' | 'scheduled' | 'file_change' | 'package_change';
+    project: string;
+    success: boolean;
+    durationMs: number;
+    details: string;
+    createdAt: string;
+}
+export declare function startWatcher(project: string, dirPath: string): {
+    started: boolean;
+    message: string;
+};
+export declare function stopWatcher(project: string): {
+    stopped: boolean;
+    message: string;
+};
+export declare function getWatcherStatus(project: string): WatcherInfo | null;
+export declare function getActiveWatchers(): WatcherInfo[];
+export declare function getLiveEvents(project: string, limit?: number, eventType?: LiveEventType): LiveEvent[];
+export declare function logRefresh(trigger: RefreshTrigger): {
+    id: number;
+};
+export declare function getRefreshHistory(project: string, limit?: number): RefreshTrigger[];
+export interface AutoRefreshCheck {
+    needsRefresh: boolean;
+    reason: string;
+    dataAge: string;
+    recommendedAction: 'none' | 're-evaluate' | 'full-rescan';
+}
+export declare function checkIfNeedsRefresh(project: string): AutoRefreshCheck;
+export declare function performAutoRefresh(project: string, force?: boolean): RefreshTrigger;
+export declare function cleanupOldEvents(project: string, keepCount?: number): {
+    deleted: number;
+};
+//# sourceMappingURL=live-watcher.d.ts.map

package/dist/core/live-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-watcher.d.ts","sourceRoot":"","sources":["../../src/core/live-watcher.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAE1H,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,GAAG,gBAAgB,CAAC;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAwED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAuFpG;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAoBlF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAepE;AAED,wBAAgB,iBAAiB,IAAI,WAAW,EAAE,CAcjD;AAID,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,SAAS,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,CAmBjG;AASD,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAOlE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE,CAc/E;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;CAC3D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAqBrE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,cAAc,CA0BjF;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAStF"}