@kentwynn/kgraph 0.2.29 → 0.2.30

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

@@ -12,16 +12,9 @@ ${numberedWorkflow('claude-code', {
     commandFiles: [
         {
             path: '.claude/commands/kgraph.md',
-            content: `Use KGraph persistent repo intelligence through the single normal \`kgraph "<topic>" --agent claude-code\` entry point.
+            content: `## KGraph Workflow
 
-1. Infer a concise topic from the user's request.
-2. Run exactly one command from the repository root: \`kgraph "<topic>" --agent claude-code\`.
-3. Treat the returned files, symbols, relationships, atoms, and warnings as the first-pass source of truth.
-4. If the user asked for an edit, inspect only the returned candidate file or the smallest necessary range, then make the edit.
-5. Verify the change actually landed before claiming completion. Prefer a narrow read of the changed range or \`git diff -- <path>\`; if there is no diff or the expected text is missing, say the edit did not apply and fix it before summarizing.
-6. Do not run \`kgraph\` again, \`kgraph context\`, \`kgraph pack\`, \`kgraph knowledge\`, \`kgraph stale\`, \`kgraph blame\`, \`kgraph scan\`, \`kgraph update\`, \`kgraph compact\`, or \`kgraph repair\` unless the user explicitly asks for that lower-level command.
-7. Do not continue broad repository search after the target file is identified. If a path must be located, prefer \`rg --files\` and quote paths containing spaces or parentheses.
-8. At the end of repository-file changes, run \`kgraph "<topic>" --final --agent claude-code\`. If KGraph reports capture-required, run \`kgraph "<topic>" --capture "<durable conclusion>" --capture-file <path> --capture-symbol <name> --agent claude-code\`, or explicitly say "No durable knowledge created" only when there is genuinely no reusable knowledge.
+${numberedWorkflow('claude-code')}
 `,
         },
         {

package/dist/integrations/adapters/copilot.js

@@ -8,6 +8,19 @@ export const copilotAdapter = {
 
 ${numberedWorkflow('copilot')}
 `,
-    commandFiles: agentSkillFiles('copilot'),
+    commandFiles: [
+        ...agentSkillFiles('copilot'),
+        {
+            path: '.github/agents/kgraph.agent.md',
+            content: `---
+description: Use KGraph persistent repo intelligence — runs kgraph before answering to provide file maps, symbols, relationships, and durable knowledge atoms.
+---
+
+## KGraph Workflow
+
+${numberedWorkflow('copilot')}
+`,
+        },
+    ],
     obsoleteCommandFiles: [],
 };

package/dist/integrations/workflow-steps.js

@@ -8,8 +8,11 @@ const REPAIR_STEP = `Run \`kgraph repair --dry-run\` before cleanup when stale/n
 const COMPACT_STEP = `Run \`kgraph compact --dry-run\` when cognition looks duplicated, noisy, or stale. Run \`kgraph compact\` only when the user asks to merge/archive cognition.`;
 const HISTORY_STEP = `Run \`kgraph history\` or \`kgraph history "<topic>"\` to review past cognition sessions with git author attribution.`;
 const KNOWLEDGE_STEP = `Run \`kgraph knowledge list --topic "<topic>"\` or \`kgraph knowledge get <atom-id>\` when the user asks what KGraph remembers or atom provenance/lifecycle matters.`;
+function inboxStep(agentName) {
+    return `If the previous command output contains "pending inbox" or a \`pendingInbox\` field with count > 0, you MUST run \`kgraph "<topic>" --agent ${agentName}\` or \`kgraph update\` immediately before proceeding. Do not skip this step.`;
+}
 function packStep(agentName) {
-    return `For normal coding context, treat \`kgraph pack "<task>" --budget 8000 --json --agent ${agentName}\` as the machine-readable context contract: use atoms, source ranges, git changes, omitted items, and inclusion reasons from the ContextPack before reading files. If the pack reports pending inbox notes, run \`kgraph "<topic>" --agent ${agentName}\` or \`kgraph update\` before relying on history or newly captured atoms.`;
+    return `For normal coding context, treat \`kgraph pack "<task>" --budget 8000 --json --agent ${agentName}\` as the machine-readable context contract: use atoms, source ranges, git changes, omitted items, and inclusion reasons from the ContextPack before reading files.`;
 }
 function smartRootStep(agentName) {
     return `Use the root workflow when refresh or memory processing matters: run \`kgraph "<topic>" --agent ${agentName}\` to refresh maps, process inbox notes, and return a briefing; run \`kgraph "<topic>" --final --agent ${agentName}\` before the final answer when repository files changed; run \`kgraph "<topic>" --capture "<durable conclusion>" --capture-file <path> --capture-symbol <name> --agent ${agentName}\` when the final check requires durable knowledge.`;
@@ -29,24 +32,25 @@ function sessionStep(agentName, qualifier) {
 export function numberedWorkflow(agentName, options = {}) {
     return `1. Infer the topic from the user's request.
 2. {{KGRAPH_CONTEXT_POLICY}}
-3. ${ROUTING_STEP}
-4. Use the returned files, symbols, relationships, and cognition before broad exploration.
-5. ${EXPLORATION_BOUNDARY_STEP}
-6. ${VERIFY_EDIT_STEP}
-7. ${smartRootStep(agentName)}
-8. ${packStep(agentName)}
-9. ${KNOWLEDGE_STEP}
-10. ${DOCTOR_STEP}
-11. ${STALE_STEP}
-12. ${sessionStep(agentName, options.sessionQualifier)}
-13. ${IMPACT_STEP}
+3. ${inboxStep(agentName)}
+4. ${ROUTING_STEP}
+5. Use the returned files, symbols, relationships, and cognition before broad exploration.
+6. ${EXPLORATION_BOUNDARY_STEP}
+7. ${VERIFY_EDIT_STEP}
+8. ${smartRootStep(agentName)}
+9. ${packStep(agentName)}
+10. ${KNOWLEDGE_STEP}
+11. ${DOCTOR_STEP}
+12. ${STALE_STEP}
+13. ${sessionStep(agentName, options.sessionQualifier)}
+14. ${IMPACT_STEP}
 
 {{KGRAPH_CAPTURE_POLICY}}
 
-14. ${REPAIR_STEP}
-15. ${COMPACT_STEP}
-16. Run \`kgraph visualize\` when the user wants to inspect the dependency graph — opens an interactive graph at http://localhost:4242 with PNG export.
-17. ${HISTORY_STEP}`;
+15. ${REPAIR_STEP}
+16. ${COMPACT_STEP}
+17. Run \`kgraph visualize\` when the user wants to inspect the dependency graph — opens an interactive graph at http://localhost:4242 with PNG export.
+18. ${HISTORY_STEP}`;
 }
 /**
  * Returns the bullet-list workflow for rules files.
@@ -54,6 +58,7 @@ export function numberedWorkflow(agentName, options = {}) {
  */
 export function bulletWorkflow(agentName, options = {}) {
     return `- {{KGRAPH_CONTEXT_POLICY}}
+- ${inboxStep(agentName)}
 - ${ROUTING_STEP}
 - ${EXPLORATION_BOUNDARY_STEP}
 - ${VERIFY_EDIT_STEP}

package/package.json

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