@kentwynn/kgraph 0.2.20 → 0.2.21

package/dist/cli/commands/workflow.js

@@ -4,6 +4,7 @@ import { loadConfig } from '../../config/config.js';
 import { queryContext } from '../../context/context-query.js';
 import { refreshKnowledgeAtomStatuses } from '../../knowledge/atom-store.js';
 import { getWorkingTreeChanges } from '../../scanner/git-utils.js';
+import { shouldExclude } from '../../scanner/file-classifier.js';
 import { scanRepository } from '../../scanner/repo-scanner.js';
 import { listInboxNotes } from '../../storage/cognition-store.js';
 import { assertWorkspace, pathExists, resolveWorkspace, } from '../../storage/kgraph-paths.js';
@@ -74,7 +75,7 @@ export async function runDefaultWorkflow(query, options = {}) {
         const activeAtoms = atoms.filter((atom) => atom.status === 'active');
         const captureCheck = await buildCaptureCheck(workspace.rootPath, {
             topic,
-            previousFiles: previousMaps.fileMap.files,
+            previousFiles: previousMaps.fileMap.files.filter((file) => !shouldExclude(file.path, config)),
             files: scan.files,
             atoms,
         });
@@ -107,7 +108,7 @@ export async function runDefaultWorkflow(query, options = {}) {
         if (options.final) {
             console.log('');
             renderFinalCaptureCheck(captureCheck, topic);
-            if (captureCheck.required) {
+            if (captureCheck.required || captureCheck.unresolvedAtoms.length > 0) {
                 process.exitCode = 1;
             }
             return;
@@ -146,6 +147,11 @@ async function buildCaptureCheck(rootPath, input) {
         return Number.isFinite(createdAt) && createdAt >= recentCutoff;
     });
     const invalidatedAtoms = matchingInvalidatedAtoms(input.atoms, input.topic).filter((atom) => !isInvalidatedAtomCovered(atom, recentActiveAtoms));
+    const unresolvedAtoms = input.atoms.filter((atom) => atom.status === 'needs-review' || atom.status === 'stale');
+    const reviewItems = unresolvedAtoms.map((atom) => ({
+        atom,
+        replacement: findReplacementAtom(atom, recentActiveAtoms),
+    }));
     const covered = new Set();
     for (const atom of recentActiveAtoms) {
         for (const ref of atom.evidenceRefs) {
@@ -165,32 +171,75 @@ async function buildCaptureCheck(rootPath, input) {
         changedFiles,
         coveredFiles: [...covered],
         invalidatedAtoms,
+        unresolvedAtoms,
+        reviewItems,
     };
 }
 function isInvalidatedAtomCovered(invalidated, recentActiveAtoms) {
-    const invalidatedFiles = new Set(invalidated.scopeRefs.files);
-    const invalidatedSymbols = new Set(invalidated.scopeRefs.symbols);
-    for (const ref of invalidated.evidenceRefs) {
+    return recentActiveAtoms.some((atom) => atomsOverlap(invalidated, atom));
+}
+function findReplacementAtom(invalidated, recentActiveAtoms) {
+    return recentActiveAtoms.find((atom) => atomsHaveReplacementSignal(invalidated, atom));
+}
+function atomsOverlap(a, b) {
+    const invalidatedFiles = new Set(a.scopeRefs.files);
+    const invalidatedSymbols = new Set(a.scopeRefs.symbols);
+    for (const ref of a.evidenceRefs) {
         if (ref.type === 'file')
             invalidatedFiles.add(ref.path);
         if (ref.type === 'symbol')
             invalidatedSymbols.add(ref.name);
     }
-    return recentActiveAtoms.some((atom) => {
-        const atomFiles = new Set(atom.scopeRefs.files);
-        const atomSymbols = new Set(atom.scopeRefs.symbols);
-        for (const ref of atom.evidenceRefs) {
-            if (ref.type === 'file')
-                atomFiles.add(ref.path);
-            if (ref.type === 'symbol')
-                atomSymbols.add(ref.name);
-        }
-        const fileOverlap = [...invalidatedFiles].some((file) => atomFiles.has(file));
-        const symbolOverlap = [...invalidatedSymbols].some((symbol) => atomSymbols.has(symbol));
-        if (fileOverlap || symbolOverlap)
-            return true;
-        return tokenOverlap(invalidated.topic, atom.topic);
-    });
+    const atomFiles = new Set(b.scopeRefs.files);
+    const atomSymbols = new Set(b.scopeRefs.symbols);
+    for (const ref of b.evidenceRefs) {
+        if (ref.type === 'file')
+            atomFiles.add(ref.path);
+        if (ref.type === 'symbol')
+            atomSymbols.add(ref.name);
+    }
+    const fileOverlap = [...invalidatedFiles].some((file) => atomFiles.has(file));
+    const symbolOverlap = [...invalidatedSymbols].some((symbol) => atomSymbols.has(symbol));
+    if (fileOverlap || symbolOverlap)
+        return true;
+    return tokenOverlap(a.topic, b.topic);
+}
+function atomsHaveReplacementSignal(a, b) {
+    const aSymbols = new Set(a.scopeRefs.symbols);
+    for (const ref of a.evidenceRefs) {
+        if (ref.type === 'symbol')
+            aSymbols.add(ref.name);
+    }
+    const bSymbols = new Set(b.scopeRefs.symbols);
+    for (const ref of b.evidenceRefs) {
+        if (ref.type === 'symbol')
+            bSymbols.add(ref.name);
+    }
+    const symbolOverlap = [...aSymbols].some((symbol) => bSymbols.has(symbol));
+    return symbolOverlap || meaningfulTopicOverlap(a.topic, b.topic);
+}
+function meaningfulTopicOverlap(a, b) {
+    const weakTokens = new Set([
+        'add',
+        'after',
+        'behavior',
+        'change',
+        'changed',
+        'new',
+        'old',
+        'review',
+        'update',
+        'with',
+    ]);
+    const aTokens = new Set(a
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((token) => token.length > 2 && !weakTokens.has(token)));
+    return b
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((token) => token.length > 2 && !weakTokens.has(token))
+        .some((token) => aTokens.has(token));
 }
 function tokenOverlap(a, b) {
     const aTokens = new Set(a
@@ -228,11 +277,19 @@ function matchingInvalidatedAtoms(atoms, topic) {
 }
 function renderFinalCaptureCheck(check, topic) {
     console.log('KGraph Final Check');
+    if (!check.required && check.unresolvedAtoms.length > 0) {
+        console.log('  status        memory-review-required');
+        console.log(`  unresolved    ${check.unresolvedAtoms.length}`);
+        console.log('  conclusion    stale or needs-review atoms remain');
+        renderMemoryReviewItems(check.reviewItems);
+        return;
+    }
     if (check.changedFiles.length === 0) {
         if (check.required) {
             console.log('  status        capture-required');
             console.log('  changed files 0');
             console.log(`  invalid atoms ${check.invalidatedAtoms.length}`);
+            renderMemoryReviewItems(check.reviewItems.filter((item) => check.invalidatedAtoms.some((atom) => atom.id === item.atom.id)));
             console.log('  conclusion    missing for needs-review or stale knowledge');
             console.log(`  next          kgraph "${topic || '<topic>'}" --capture "<durable conclusion>" --capture-file <path>`);
             return;
@@ -251,7 +308,24 @@ function renderFinalCaptureCheck(check, topic) {
     console.log(`  changed files ${check.changedFiles.length}`);
     if (check.invalidatedAtoms.length > 0) {
         console.log(`  invalid atoms ${check.invalidatedAtoms.length}`);
+        renderMemoryReviewItems(check.reviewItems.filter((item) => check.invalidatedAtoms.some((atom) => atom.id === item.atom.id)));
     }
     console.log('  conclusion    missing for one or more changed files');
     console.log(`  next          kgraph "${topic || '<topic>'}" --capture "<durable conclusion>" --capture-file <path>`);
 }
+function renderMemoryReviewItems(items) {
+    const visible = items.slice(0, 3);
+    for (const item of visible) {
+        console.log(`  review atom   ${item.atom.id}`);
+        console.log(`  review topic  ${item.atom.status}: ${item.atom.topic}`);
+        if (item.replacement) {
+            console.log(`  supersede     kgraph knowledge supersede ${item.atom.id} ${item.replacement.id}`);
+        }
+        else {
+            console.log(`  inspect       kgraph knowledge get ${item.atom.id}`);
+        }
+    }
+    if (items.length > visible.length) {
+        console.log(`  review more   ${items.length - visible.length} more atom(s)`);
+    }
+}

package/dist/config/config.js

@@ -23,6 +23,7 @@ export const DEFAULT_CONFIG = {
         '.agents',
         '.specify',
         'specs',
+        'tmp',
         '.cursor',
         '.claude',
         '.windsurf',

package/package.json

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