@kentwynn/kgraph 0.2.10 → 0.2.12

package/dist/visualization/graph-builder.js

@@ -8,10 +8,10 @@ const LANGUAGE_COLORS = {
     html: '#f97316',
 };
 const STATUS_COLORS = {
-    current: '#10b981',
-    mixed: '#f59e0b',
+    active: '#10b981',
+    'needs-review': '#f59e0b',
     stale: '#ef4444',
-    unresolved: '#6b7280',
+    archived: '#6b7280',
 };
 const SYMBOL_COLORS = {
     function: '#22c55e',
@@ -20,7 +20,8 @@ const SYMBOL_COLORS = {
     export: '#f97316',
     import: '#64748b',
 };
-export function buildGraph(fileMap, symbolMap, dependencyMap, relationshipMap, cognitionNotes) {
+const MAX_ATOM_NODES = 250;
+export function buildGraph(fileMap, symbolMap, dependencyMap, relationshipMap, knowledgeAtoms) {
     const elements = [];
     const edgeIds = new Set();
     const nodeIds = new Set();
@@ -59,22 +60,30 @@ export function buildGraph(fileMap, symbolMap, dependencyMap, relationshipMap, c
             classes: `symbol ${symbol.kind}`,
         });
     }
-    for (const note of cognitionNotes) {
-        const id = `cognition-${note.id}`;
+    const atomsForGraph = selectAtomsForGraph(knowledgeAtoms);
+    for (const atom of atomsForGraph) {
+        const id = `atom-${atom.id}`;
         elements.push({
             data: {
                 id,
-                label: note.title,
-                color: STATUS_COLORS[note.referencesStatus] ?? STATUS_COLORS.unresolved,
-                type: 'cognition',
-                referencesStatus: note.referencesStatus,
-                domain: note.domain ?? '',
-                relatedFiles: note.relatedFiles,
-                relatedSymbols: note.relatedSymbols,
+                label: atom.topic,
+                color: STATUS_COLORS[atom.status] ?? STATUS_COLORS.archived,
+                type: 'atom',
+                atomId: atom.id,
+                atomType: atom.type,
+                confidence: atom.confidence,
+                status: atom.status,
+                sourceCommand: atom.provenance.sourceCommand,
+                domain: atom.scopeRefs.domains[0] ?? '',
+                relatedFiles: atom.scopeRefs.files,
+                relatedSymbols: atom.scopeRefs.symbols,
+                supersededBy: atom.lifecycle.supersededBy ?? '',
+                supersedes: atom.lifecycle.supersedes,
+                invalidatedBy: atom.lifecycle.invalidatedBy ?? [],
             },
-            classes: `cognition ${note.referencesStatus}`,
+            classes: `atom ${atom.status}`,
         });
-        for (const filePath of note.relatedFiles) {
+        for (const filePath of atom.scopeRefs.files) {
             const target = fileMap.files.find((f) => f.path === filePath);
             if (target) {
                 const edgeId = `${id}-ref-${target.id}`;
@@ -85,10 +94,10 @@ export function buildGraph(fileMap, symbolMap, dependencyMap, relationshipMap, c
                             id: edgeId,
                             source: id,
                             target: target.id,
-                            type: 'cognition-ref',
+                            type: 'atom-ref',
                             label: '',
                         },
-                        classes: 'cognition-ref',
+                        classes: 'atom-ref',
                     });
                 }
             }
@@ -142,12 +151,28 @@ export function buildGraph(fileMap, symbolMap, dependencyMap, relationshipMap, c
         meta: {
             fileCount: fileMap.files.length,
             symbolCount: symbolMap.symbols.length,
-            cognitionCount: cognitionNotes.length,
+            atomCount: knowledgeAtoms.filter((atom) => atom.status !== 'archived').length,
+            hiddenAtomCount: Math.max(0, knowledgeAtoms.filter((atom) => atom.status !== 'archived').length -
+                atomsForGraph.length),
+            cognitionCount: knowledgeAtoms.filter((atom) => atom.status !== 'archived').length,
             tokenEstimate,
             generatedAt: new Date().toISOString(),
         },
     };
 }
+function selectAtomsForGraph(atoms) {
+    return atoms
+        .filter((atom) => atom.status !== 'archived')
+        .sort((left, right) => atomGraphScore(right) - atomGraphScore(left))
+        .slice(0, MAX_ATOM_NODES);
+}
+function atomGraphScore(atom) {
+    const statusScore = atom.status === 'active' ? 6 : atom.status === 'needs-review' ? 4 : 2;
+    const confidenceScore = atom.confidence === 'high' ? 3 : atom.confidence === 'medium' ? 2 : 0;
+    const evidenceScore = Math.min(4, atom.scopeRefs.files.length + atom.scopeRefs.symbols.length);
+    const typeScore = atom.type === 'decision' || atom.type === 'gotcha' ? 1 : 0;
+    return statusScore + confidenceScore + evidenceScore + typeScore;
+}
 function getTokenBucket(tokenEstimate) {
     const tokens = tokenEstimate ?? 0;
     if (tokens >= 1000)

package/dist/visualization/html-template.js

@@ -51,10 +51,10 @@ select:hover,button:hover{background:#475569}
 <body>
 <div id="toolbar">
   <span id="t-title">\u29e1 KGraph \u00b7 ${repoName}</span>
-  <span id="t-stats">${meta.fileCount} files &middot; ${meta.symbolCount} symbols &middot; ${meta.cognitionCount} notes &middot; ~${meta.tokenEstimate} tokens</span>
+  <span id="t-stats">${meta.fileCount} files &middot; ${meta.symbolCount} symbols &middot; ${meta.atomCount} atoms${meta.hiddenAtomCount ? ' (' + meta.hiddenAtomCount + ' hidden)' : ''} &middot; ~${meta.tokenEstimate} tokens</span>
   <div id="t-controls">
     <label class="clabel"><input type="checkbox" id="tog-lbl" checked> Labels</label>
-    <label class="clabel"><input type="checkbox" id="tog-cog" checked> Cognition</label>
+    <label class="clabel"><input type="checkbox" id="tog-cog" checked> Memory</label>
     <select id="sel-layout" title="Graph layout algorithm">
       <option value="dagre">Hierarchical</option>
       <option value="cose">Force-directed</option>
@@ -85,9 +85,9 @@ select:hover,button:hover{background:#475569}
   <span class="li"><span class="li-dot" style="background:#475569"></span>200+ tok</span>
   <span class="li"><span class="li-dot" style="background:#ef4444"></span>1000+ tok</span>
   <span class="li-sep"></span>
-  <span class="li-head">Cognition</span>
-  <span class="li"><span class="li-dia" style="background:#10b981"></span>Current</span>
-  <span class="li"><span class="li-dia" style="background:#f59e0b"></span>Mixed</span>
+  <span class="li-head">Atoms</span>
+  <span class="li"><span class="li-dia" style="background:#10b981"></span>Active</span>
+  <span class="li"><span class="li-dia" style="background:#f59e0b"></span>Review</span>
   <span class="li"><span class="li-dia" style="background:#ef4444"></span>Stale</span>
   <span class="li-sep"></span>
   <span class="li" style="margin-left:auto;color:#334155;font-size:10px">KGraph v${meta.generatedAt.slice(0, 10)}</span>
@@ -166,7 +166,7 @@ select:hover,button:hover{background:#475569}
         }
       },
       {
-        selector: 'node.cognition',
+        selector: 'node.atom',
         style: {
           shape: 'diamond',
           width: 40,
@@ -212,7 +212,7 @@ select:hover,button:hover{background:#475569}
         }
       },
       {
-        selector: 'edge.cognition-ref',
+        selector: 'edge.atom-ref',
         style: {
           width: 1.5,
           'line-color': '#7dd3fc',
@@ -267,25 +267,32 @@ select:hover,button:hover{background:#475569}
       symHtml;
   }
 
-  function renderCognitionPanel(d) {
-    var sc = { current: '#10b981', mixed: '#f59e0b', stale: '#ef4444', unresolved: '#6b7280' }[d.referencesStatus] || '#6b7280';
+  function renderAtomPanel(d) {
+    var sc = { active: '#10b981', 'needs-review': '#f59e0b', stale: '#ef4444', archived: '#6b7280' }[d.status] || '#6b7280';
     var files = d.relatedFiles && d.relatedFiles.length
       ? '<ul class="sb-list">' + d.relatedFiles.map(function (f) { return '<li>' + esc(f) + '</li>'; }).join('') + '</ul>'
       : '<span class="sb-val">none</span>';
     var syms = d.relatedSymbols && d.relatedSymbols.length
       ? d.relatedSymbols.slice(0, 15).map(function (s) { return '<span class="sb-code">' + esc(s) + '</span>'; }).join(' ')
       : '<span class="sb-val">none</span>';
-    return '<div class="sb-badge" style="background:' + sc + '22;color:' + sc + ';border:1px solid ' + sc + '44">' + esc(d.referencesStatus) + '</div>' +
+    var invalidated = d.invalidatedBy && d.invalidatedBy.length
+      ? '<div class="sb-sect"><div class="sb-lbl">Invalidated By</div><ul class="sb-list">' + d.invalidatedBy.map(function (r) { return '<li>' + esc(r) + '</li>'; }).join('') + '</ul></div>'
+      : '';
+    return '<div class="sb-badge" style="background:' + sc + '22;color:' + sc + ';border:1px solid ' + sc + '44">' + esc(d.status) + '</div>' +
       '<div class="sb-title">' + esc(d.label) + '</div>' +
+      '<div class="sb-sect"><div class="sb-lbl">Atom</div><div class="sb-val"><span class="sb-code">' + esc(d.atomId) + '</span></div></div>' +
+      '<div class="sb-sect"><div class="sb-lbl">Type / Confidence</div><div class="sb-val">' + esc(d.atomType) + ' / ' + esc(d.confidence) + '</div></div>' +
+      '<div class="sb-sect"><div class="sb-lbl">Source</div><div class="sb-val">' + esc(d.sourceCommand) + '</div></div>' +
       (d.domain ? '<div class="sb-sect"><div class="sb-lbl">Domain</div><div class="sb-val">' + esc(d.domain) + '</div></div>' : '') +
       '<div class="sb-sect"><div class="sb-lbl">Related Files</div>' + files + '</div>' +
-      '<div class="sb-sect"><div class="sb-lbl">Symbols</div><div class="sb-val">' + syms + '</div></div>';
+      '<div class="sb-sect"><div class="sb-lbl">Symbols</div><div class="sb-val">' + syms + '</div></div>' +
+      invalidated;
   }
 
   cy.on('tap', 'node', function (evt) {
     var d = evt.target.data();
-    document.getElementById('sb-type').textContent = d.type === 'cognition' ? 'Cognition Note' : 'File';
-    document.getElementById('sb-body').innerHTML = d.type === 'cognition' ? renderCognitionPanel(d) : renderFilePanel(d);
+    document.getElementById('sb-type').textContent = d.type === 'atom' ? 'Knowledge Atom' : 'File';
+    document.getElementById('sb-body').innerHTML = d.type === 'atom' ? renderAtomPanel(d) : renderFilePanel(d);
     document.getElementById('sidebar').classList.add('open');
   });
 
@@ -305,11 +312,11 @@ select:hover,button:hover{background:#475569}
 
   document.getElementById('tog-cog').addEventListener('change', function (e) {
     if (e.target.checked) {
-      cy.nodes('.cognition').removeClass('hidden');
-      cy.edges('.cognition-ref').removeClass('hidden');
+      cy.nodes('.atom').removeClass('hidden');
+      cy.edges('.atom-ref').removeClass('hidden');
     } else {
-      cy.nodes('.cognition').addClass('hidden');
-      cy.edges('.cognition-ref').addClass('hidden');
+      cy.nodes('.atom').addClass('hidden');
+      cy.edges('.atom-ref').addClass('hidden');
     }
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kentwynn/kgraph",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Persistent repo intelligence for AI coding assistants.",
   "type": "module",
   "bin": {