@imayuur/contexthub-knowledge-graph 1.0.0 → 1.0.1

package/dist/deepsync-report.d.ts

@@ -0,0 +1,30 @@
+export interface DeepSyncReportOptions {
+    repoPath: string;
+    filesAnalyzed: number;
+    symbolCount: number;
+    nodeCount: number;
+    edgeCount: number;
+    docsIngested: number;
+    commitsAnalyzed: number;
+    memoryCount: number;
+    gitBranch?: string;
+    languageBreakdown?: Record<string, number>;
+    docFiles?: Array<{
+        path: string;
+        sizeKB: number;
+    }>;
+    hotFiles?: Array<{
+        path: string;
+        changes: number;
+    }>;
+    recentFocusAreas?: string[];
+    durationMs: number;
+}
+/**
+ * Generate a DEEPSYNC.md report summarising the deep sync results.
+ */
+export declare function generateDeepSyncReport(options: DeepSyncReportOptions): Promise<string>;
+/**
+ * Write the DeepSync report to .contexthub/DEEPSYNC.md
+ */
+export declare function writeDeepSyncReport(options: DeepSyncReportOptions): Promise<string>;

package/dist/deepsync-report.js

@@ -0,0 +1,211 @@
+"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.generateDeepSyncReport = generateDeepSyncReport;
+exports.writeDeepSyncReport = writeDeepSyncReport;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const index_1 = require("./index");
+/**
+ * Generate a DEEPSYNC.md report summarising the deep sync results.
+ */
+async function generateDeepSyncReport(options) {
+    const graphManager = new index_1.CodeGraphManager(options.repoPath);
+    const projectName = path.basename(options.repoPath);
+    const syncedAt = new Date().toISOString();
+    // Language breakdown table
+    let langTable = '| Language | Files |\n|----------|-------|\n';
+    if (options.languageBreakdown) {
+        const sorted = Object.entries(options.languageBreakdown).sort((a, b) => b[1] - a[1]);
+        const total = sorted.reduce((s, [, c]) => s + c, 0);
+        for (const [lang, count] of sorted) {
+            const pct = total > 0 ? ((count / total) * 100).toFixed(0) : '0';
+            langTable += `| ${lang} | ${count} (${pct}%) |\n`;
+        }
+    }
+    else {
+        langTable += '| — | No data |\n';
+    }
+    // God-nodes section
+    let godNodesSection = '';
+    try {
+        const godNodes = await graphManager.getGodNodes(10);
+        if (godNodes.length > 0) {
+            const rows = godNodes
+                .map((gn, i) => `| ${i + 1} | \`${gn.path}\` | ${gn.degree} | ${gn.inDegree} | ${gn.outDegree} |`)
+                .join('\n');
+            godNodesSection = `### 🔗 God-Nodes (Most Connected Files)
+
+| Rank | File | Degree | In | Out |
+|------|------|--------|----|-----|
+${rows}
+`;
+        }
+    }
+    catch { }
+    // Communities section
+    let communitiesSection = '';
+    try {
+        const communities = await graphManager.detectCommunities();
+        if (communities.length > 0) {
+            const topCommunities = communities.slice(0, 8);
+            const rows = topCommunities
+                .map((c) => {
+                const preview = c.files
+                    .slice(0, 4)
+                    .map((f) => `\`${f}\``)
+                    .join(', ');
+                const more = c.size > 4 ? ` +${c.size - 4} more` : '';
+                return `| ${c.id} | ${c.size} | ${preview}${more} |`;
+            })
+                .join('\n');
+            communitiesSection = `### 🏘️ Code Communities
+
+Total: **${communities.length}** communities across **${communities.reduce((s, c) => s + c.size, 0)}** files.
+
+| ID | Size | Files |
+|----|------|-------|
+${rows}
+`;
+        }
+    }
+    catch { }
+    // Documentation index
+    let docsSection = '';
+    if (options.docFiles && options.docFiles.length > 0) {
+        const rows = options.docFiles
+            .slice(0, 20)
+            .map((d) => `| \`${d.path}\` | ${d.sizeKB.toFixed(1)} KB |`)
+            .join('\n');
+        docsSection = `### 📄 Documentation Index
+
+| File | Size |
+|------|------|
+${rows}
+`;
+    }
+    // Git intelligence
+    let gitSection = '';
+    if (options.gitBranch || (options.hotFiles && options.hotFiles.length > 0)) {
+        gitSection = `### 🔀 Git Intelligence
+
+`;
+        if (options.gitBranch) {
+            gitSection += `- **Active Branch:** \`${options.gitBranch}\`\n`;
+        }
+        gitSection += `- **Commits Analyzed:** ${options.commitsAnalyzed}\n`;
+        if (options.hotFiles && options.hotFiles.length > 0) {
+            gitSection += `\n**Hot Files** (most changed recently):\n`;
+            for (const hf of options.hotFiles.slice(0, 10)) {
+                gitSection += `- \`${hf.path}\` — ${hf.changes} changes\n`;
+            }
+        }
+        if (options.recentFocusAreas && options.recentFocusAreas.length > 0) {
+            gitSection += `\n**Recent Focus Areas:** ${options.recentFocusAreas.join(', ')}\n`;
+        }
+    }
+    const durationSec = (options.durationMs / 1000).toFixed(1);
+    const report = `# 🧠 DeepSync Report — ${projectName}
+
+> Auto-generated by ContextHub DeepSync. Do not edit manually.
+> Last synced: ${syncedAt} | Duration: ${durationSec}s
+
+---
+
+## 📊 Overview
+
+| Metric | Count |
+|--------|-------|
+| Files Analyzed | ${options.filesAnalyzed} |
+| Symbols Indexed | ${options.symbolCount} |
+| Graph Nodes | ${options.nodeCount} |
+| Graph Edges | ${options.edgeCount} |
+| Docs Ingested | ${options.docsIngested} |
+| Commits Analyzed | ${options.commitsAnalyzed} |
+| Total Memories | ${options.memoryCount} |
+
+## 🗂️ Languages
+
+${langTable}
+
+## 🏗️ Architecture
+
+${godNodesSection || '> No high-connectivity files detected.\n'}
+${communitiesSection || '> No communities detected.\n'}
+
+${docsSection}
+
+${gitSection}
+
+---
+
+## 🔄 Auto-Sync
+
+DeepSync auto-updates the knowledge graph on every \`ensure_session\` call.
+Changed files are detected via git and incrementally patched — no manual re-scan needed.
+
+---
+
+*Generated by [ContextHub DeepSync](https://github.com/iMayuuR/contexthub) — One scan. Total recall. Forever in context.*
+`;
+    return report;
+}
+/**
+ * Write the DeepSync report to .contexthub/DEEPSYNC.md
+ */
+async function writeDeepSyncReport(options) {
+    const report = await generateDeepSyncReport(options);
+    const outputPath = path.join(options.repoPath, '.contexthub', 'DEEPSYNC.md');
+    // Ensure .contexthub exists
+    const dir = path.dirname(outputPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Atomic write
+    const tmpPath = outputPath + `.tmp.${crypto.randomBytes(4).toString('hex')}`;
+    try {
+        fs.writeFileSync(tmpPath, report, { mode: 0o600 });
+        fs.renameSync(tmpPath, outputPath);
+    }
+    catch (e) {
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch { }
+        throw e;
+    }
+    return outputPath;
+}

package/dist/index.d.ts

@@ -89,3 +89,5 @@ export declare class CodeGraphManager {
 }
 export { generateGraphReport, writeGraphReport } from './report';
 export type { GraphReportOptions } from './report';
+export { generateDeepSyncReport, writeDeepSyncReport } from './deepsync-report';
+export type { DeepSyncReportOptions } from './deepsync-report';

package/dist/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeGraphReport = exports.generateGraphReport = exports.CodeGraphManager = void 0;
+exports.writeDeepSyncReport = exports.generateDeepSyncReport = exports.writeGraphReport = exports.generateGraphReport = exports.CodeGraphManager = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const crypto = __importStar(require("crypto"));
@@ -750,3 +750,7 @@ exports.CodeGraphManager = CodeGraphManager;
 var report_1 = require("./report");
 Object.defineProperty(exports, "generateGraphReport", { enumerable: true, get: function () { return report_1.generateGraphReport; } });
 Object.defineProperty(exports, "writeGraphReport", { enumerable: true, get: function () { return report_1.writeGraphReport; } });
+// Re-export DeepSync report utilities
+var deepsync_report_1 = require("./deepsync-report");
+Object.defineProperty(exports, "generateDeepSyncReport", { enumerable: true, get: function () { return deepsync_report_1.generateDeepSyncReport; } });
+Object.defineProperty(exports, "writeDeepSyncReport", { enumerable: true, get: function () { return deepsync_report_1.writeDeepSyncReport; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imayuur/contexthub-knowledge-graph",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Code knowledge graph builder and query engine for ContextHub",
   "license": "MIT",
   "repository": {
@@ -27,9 +27,9 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@imayuur/contexthub-shared-types": "^1.0.0",
-    "@imayuur/contexthub-core": "^1.0.0",
-    "@imayuur/contexthub-repo-parser": "^1.0.0"
+    "@imayuur/contexthub-shared-types": "^1.0.1",
+    "@imayuur/contexthub-core": "^1.0.1",
+    "@imayuur/contexthub-repo-parser": "^1.0.1"
   },
   "devDependencies": {
     "@types/node": "^18.0.0",