@kentwynn/kgraph 0.2.37 → 0.2.38

package/dist/cli/commands/pack.js

@@ -2,6 +2,7 @@ import path from 'node:path';
 import { loadConfig } from '../../config/config.js';
 import { buildContextPack } from '../../context/context-pack.js';
 import { queryContext } from '../../context/context-query.js';
+import { getCurrentCommit, isGitRepo } from '../../scanner/git-utils.js';
 import { assertSessionAgent, recordSessionEvent, } from '../../session/session-store.js';
 import { listInboxNotes } from '../../storage/cognition-store.js';
 import { assertWorkspace } from '../../storage/kgraph-paths.js';
@@ -34,6 +35,35 @@ export function registerPackCommand(program) {
         ]);
         const response = await queryContext(workspace, config, maps, task);
         const pack = buildContextPack(response, budget, workspace.rootPath);
+        // P4: warn when maps are behind HEAD (user edited files without re-scanning)
+        if (await isGitRepo(workspace.rootPath)) {
+            const head = await getCurrentCommit(workspace.rootPath);
+            if (head &&
+                maps.fileMap.scannedAtCommit &&
+                maps.fileMap.scannedAtCommit !== head) {
+                pack.warnings = [
+                    `Maps are behind HEAD — run \`kgraph scan\` or \`kgraph "${task}"${agent ? ` --agent ${agent}` : ''}\` for accurate atom status. Knowledge freshness may be reduced.`,
+                    ...pack.warnings,
+                ];
+            }
+        }
+        // P1: warn when needs-review or stale atoms are served in context
+        const degradedAtoms = pack.items.filter((item) => item.kind === 'atom' &&
+            (item.data.status === 'needs-review' ||
+                item.data.status === 'stale'));
+        if (degradedAtoms.length > 0) {
+            const needsReview = degradedAtoms.filter((item) => item.data.status === 'needs-review').length;
+            const stale = degradedAtoms.filter((item) => item.data.status === 'stale').length;
+            const parts = [];
+            if (needsReview > 0)
+                parts.push(`${needsReview} needs-review`);
+            if (stale > 0)
+                parts.push(`${stale} stale`);
+            pack.warnings = [
+                ...pack.warnings,
+                `${parts.join(', ')} atom(s) in context may reflect outdated knowledge — run \`kgraph stale\` to inspect, or \`kgraph "${task}" --final${agent ? ` --agent ${agent}` : ''}\` to resolve.`,
+            ];
+        }
         if (agent) {
             const omittedTokens = pack.omitted.reduce((sum, item) => sum + item.tokenEstimate, 0);
             await recordSessionEvent(workspace, {

package/dist/context/ranking.js

@@ -14,7 +14,10 @@ export function rankByFields(query, items, fields) {
         for (const field of fields) {
             const value = field.value(item);
             const values = Array.isArray(value) ? value : value ? [value] : [];
-            const haystack = values.flatMap((value) => [value, splitIdentifier(value).join(' ')]).join(' ').toLowerCase();
+            const haystack = values
+                .flatMap((value) => [value, splitIdentifier(value).join(' ')])
+                .join(' ')
+                .toLowerCase();
             for (const token of tokens) {
                 if (haystack.includes(token)) {
                     const baseScore = field.name === 'path' || field.name === 'name'
@@ -36,7 +39,25 @@ export function rankByFields(query, items, fields) {
         .sort((a, b) => b.score - a.score);
 }
 function expandTokens(tokens) {
-    return [...new Set(tokens.flatMap((token) => [token, ...splitIdentifier(token)]))];
+    return [
+        ...new Set(tokens.flatMap((token) => {
+            const parts = [token, ...splitIdentifier(token)];
+            // Add prefix stems so "authentication" also matches "auth",
+            // "configuration" matches "config", etc. Only for longer tokens
+            // to avoid over-matching short words.
+            // Use a short 4-char stem (catches root prefixes like "auth", "conf", "init")
+            // and a half-length stem (catches "config" from "configuration", "authent" from
+            // "authentication"). Both are narrower than the full token so they find real matches
+            // without over-fetching.
+            if (token.length >= 8) {
+                parts.push(token.slice(0, 4));
+                const half = Math.floor(token.length * 0.5);
+                if (half > 4)
+                    parts.push(token.slice(0, half));
+            }
+            return parts;
+        })),
+    ];
 }
 function splitIdentifier(value) {
     return value

package/dist/integrations/adapters/claude-code.js

@@ -202,6 +202,22 @@ const filePath = payload?.tool_input?.file_path || payload?.toolInput?.file_path
 if (!filePath) process.exit(0);
 args.push(filePath);`
         : '';
+    // On session end: run stale check first (refreshes atom statuses against current
+    // maps without needing a topic), then end the session with --conclude so any
+    // pending knowledge is captured. Both run regardless of each other's exit code.
+    if (event === 'end') {
+        return `#!/usr/bin/env node
+const { spawnSync } = require('node:child_process');
+
+// P3: refresh atom statuses against current maps so needs-review/stale atoms
+// are up to date before the session ends. Output ignored — hook is silent.
+spawnSync('kgraph', ['stale', '--json'], { stdio: 'ignore' });
+
+// P2: end the session and trigger conclude so durable knowledge is captured.
+const result = spawnSync('kgraph', ['session', 'end', '--agent', 'claude-code', '--conclude', '--source', 'automatic'], { stdio: 'ignore' });
+process.exit(result.status || 0);
+`;
+    }
     return `#!/usr/bin/env node
 const { spawnSync } = require('node:child_process');
 

package/dist/integrations/adapters/cline.js

@@ -1,3 +1,4 @@
+import { agentSkillFiles } from '../agent-skills.js';
 import { bulletWorkflow } from '../workflow-steps.js';
 export const clineAdapter = {
     name: 'cline',
@@ -7,4 +8,5 @@ export const clineAdapter = {
 
 ${bulletWorkflow('cline')}
 `,
+    commandFiles: agentSkillFiles('cline'),
 };

package/dist/integrations/adapters/cursor.js

@@ -1,3 +1,4 @@
+import { agentSkillFiles } from '../agent-skills.js';
 import { bulletWorkflow } from '../workflow-steps.js';
 export const cursorAdapter = {
     name: 'cursor',
@@ -12,5 +13,6 @@ alwaysApply: true
 
 ${bulletWorkflow('cursor')}
 `,
+    commandFiles: agentSkillFiles('cursor'),
     obsoleteCommandFiles: ['.cursor/rules/kgraph-commands.mdc'],
 };

package/dist/integrations/adapters/gemini.js

@@ -1,10 +1,13 @@
-import { bulletWorkflow } from '../workflow-steps.js';
+import { agentSkillFiles } from '../agent-skills.js';
+import { numberedWorkflow } from '../workflow-steps.js';
 export const geminiAdapter = {
     name: 'gemini',
     label: 'Gemini CLI',
     targetPath: 'GEMINI.md',
     instructions: `## KGraph Workflow
 
-${bulletWorkflow('gemini')}
+${numberedWorkflow('gemini')}
 `,
+    commandFiles: agentSkillFiles('gemini'),
+    obsoleteCommandFiles: [],
 };

package/dist/integrations/adapters/windsurf.js

@@ -1,3 +1,4 @@
+import { agentSkillFiles } from '../agent-skills.js';
 import { bulletWorkflow } from '../workflow-steps.js';
 export const windsurfAdapter = {
     name: 'windsurf',
@@ -7,4 +8,6 @@ export const windsurfAdapter = {
 
 ${bulletWorkflow('windsurf')}
 `,
+    commandFiles: agentSkillFiles('windsurf'),
+    obsoleteCommandFiles: [],
 };

package/package.json

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