@kentwynn/kgraph 0.1.4 → 0.1.5

package/README.md

@@ -86,10 +86,10 @@ KGraph writes local instruction files and command/prompt packs so AI tools can u
 
 | Integration | Always-on guidance | KGraph command assets |
 | --- | --- | --- |
-| Codex | `AGENTS.md` | `.agents/skills/kgraph*/SKILL.md` |
-| GitHub Copilot | `.github/copilot-instructions.md` | `.github/prompts/kgraph*.prompt.md` |
-| Cursor | `.cursor/rules/kgraph.mdc` | `.cursor/rules/kgraph-commands.mdc` |
-| Claude Code | `CLAUDE.md` | `.claude/commands/kgraph*.md` |
+| Codex | `AGENTS.md` | `.agents/skills/kgraph/SKILL.md` |
+| GitHub Copilot | `.github/copilot-instructions.md` | `.github/prompts/kgraph.prompt.md` |
+| Cursor | `.cursor/rules/kgraph.mdc` | Built into the KGraph Cursor rule |
+| Claude Code | `CLAUDE.md` | `.claude/commands/kgraph.md` |
 
 Example:
 
@@ -98,13 +98,13 @@ kgraph integrate add codex copilot cursor claude-code
 kgraph integrate list
 ```
 
-This gives supported tools reusable KGraph workflows similar to Spec Kit-style commands:
+This gives each supported tool one reusable KGraph entry point similar to a Spec Kit-style command:
 
 - KGraph context: query `kgraph context "<topic>"` before broad repo exploration
 - KGraph update: save durable chat/debugging/workflow discoveries to `.kgraph/inbox/`, then run `kgraph update`
 - KGraph scan: run `kgraph scan` after refactors, file moves, renamed functions, or dependency changes
 
-The exact invocation depends on the host tool. Copilot uses prompt files, Codex uses skills, Cursor uses rules, and Claude Code uses command files.
+The exact invocation depends on the host tool. Copilot uses one prompt file, Codex uses one skill, Cursor uses one rule, and Claude Code uses one command file. Scan and update are workflows inside that single KGraph entry point, not separate duplicated commands.
 
 KGraph-managed instruction blocks preserve existing user-authored content.
 

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

@@ -19,21 +19,9 @@ export const claudeCodeAdapter = {
 2. Run \`kgraph context "<topic>"\`.
 3. Use the returned files, symbols, relationships, and cognition before broad exploration.
 4. Save durable discoveries to \`.kgraph/inbox/\` and run \`kgraph update\` when appropriate.
-`
-        },
-        {
-            path: ".claude/commands/kgraph-update.md",
-            content: `Preserve useful chat knowledge in KGraph.
-
-Create a concise Markdown note in \`.kgraph/inbox/\` from durable discoveries in this conversation, then run \`kgraph update\`.
-`
-        },
-        {
-            path: ".claude/commands/kgraph-scan.md",
-            content: `Refresh KGraph structural maps.
-
-Run \`kgraph scan\` after code structure changes and report the scan summary.
+5. Run \`kgraph scan\` after structural changes and report the scan summary.
 `
         }
-    ]
+    ],
+    obsoleteCommandFiles: [".claude/commands/kgraph-update.md", ".claude/commands/kgraph-scan.md"]
 };

package/dist/integrations/adapters/codex.js

@@ -28,29 +28,8 @@ Workflow:
 4. After durable discoveries, write a concise Markdown note to \`.kgraph/inbox/\`.
 5. Run \`kgraph update\` if you created an inbox note.
 6. Run \`kgraph scan\` after structural changes.
-`
-        },
-        {
-            path: ".agents/skills/kgraph-update/SKILL.md",
-            content: `---
-name: "kgraph-update"
-description: "Preserve useful chat discoveries into KGraph cognition."
----
-
-Use this skill when the user asks to update KGraph memory or preserve what was learned.
-
-Write a concise Markdown note under \`.kgraph/inbox/\` with durable architecture, debugging, workflow, file, symbol, or gotcha knowledge. Then run \`kgraph update\`.
-`
-        },
-        {
-            path: ".agents/skills/kgraph-scan/SKILL.md",
-            content: `---
-name: "kgraph-scan"
-description: "Refresh KGraph structural maps after code changes."
----
-
-Run \`kgraph scan\` after files move, functions are renamed, folders are refactored, or dependencies change. Report the scan summary and any obvious exclude/config problems.
 `
         }
-    ]
+    ],
+    obsoleteCommandFiles: [".agents/skills/kgraph-update", ".agents/skills/kgraph-scan"]
 };

package/dist/integrations/adapters/copilot.js

@@ -25,29 +25,8 @@ Use KGraph for the current task.
 3. If you discover durable architecture, debugging, workflow, or gotcha knowledge, create a Markdown note in \`.kgraph/inbox/\`.
 4. If you add an inbox note, run \`kgraph update\`.
 5. If code structure changed, run \`kgraph scan\`.
-`
-        },
-        {
-            path: ".github/prompts/kgraph-update.prompt.md",
-            content: `---
-mode: agent
-description: Preserve recent useful chat knowledge in KGraph
----
-
-Create a concise Markdown cognition note in \`.kgraph/inbox/\` from the useful stable knowledge in this conversation, then run \`kgraph update\`.
-
-Capture only durable information: architecture discoveries, debugging conclusions, workflow conventions, important files, important functions, and gotchas. Do not store temporary chatter.
-`
-        },
-        {
-            path: ".github/prompts/kgraph-scan.prompt.md",
-            content: `---
-mode: agent
-description: Refresh KGraph structural maps after repository changes
----
-
-Run \`kgraph scan\` and report the number of files and symbols scanned. If scan output suggests generated/cache files were included, mention that the exclude configuration may need adjustment.
 `
         }
-    ]
+    ],
+    obsoleteCommandFiles: [".github/prompts/kgraph-update.prompt.md", ".github/prompts/kgraph-scan.prompt.md"]
 };

package/dist/integrations/adapters/cursor.js

@@ -15,22 +15,5 @@ alwaysApply: true
 - Run \`kgraph scan\` after refactors, moved folders, renamed functions, or other structure changes.
 - Run \`kgraph visualize\` when visualization support is available and the developer asks to inspect the KGraph map.
 `,
-    commandFiles: [
-        {
-            path: ".cursor/rules/kgraph-commands.mdc",
-            content: `---
-description: KGraph command workflows for repo context, update, and scan
-alwaysApply: false
----
-
-# KGraph Commands
-
-Use these workflows when the user asks for KGraph:
-
-- KGraph context: run \`kgraph context "<topic>"\` before broad exploration.
-- KGraph update: write durable findings to \`.kgraph/inbox/\`, then run \`kgraph update\`.
-- KGraph scan: run \`kgraph scan\` after refactors, file moves, renamed functions, or dependency changes.
-`
-        }
-    ]
+    obsoleteCommandFiles: [".cursor/rules/kgraph-commands.mdc"]
 };

package/dist/integrations/integration-registry.d.ts

@@ -5,6 +5,7 @@ export interface IntegrationAdapter {
     targetPath: string;
     instructions: string;
     commandFiles?: IntegrationCommandFile[];
+    obsoleteCommandFiles?: string[];
 }
 export interface IntegrationCommandFile {
     path: string;

package/dist/integrations/integration-store.js

@@ -27,6 +27,7 @@ export async function addIntegrations(workspace, names) {
         };
         byName.set(adapter.name, next);
         await writeIntegrationInstructions(workspace.rootPath, adapter.targetPath, adapter.name, adapter.instructions);
+        await removeIntegrationCommandFiles(workspace.rootPath, adapter.obsoleteCommandFiles ?? []);
         await writeIntegrationCommandFiles(workspace.rootPath, adapter.commandFiles ?? []);
         changed.push(next);
     }
@@ -42,6 +43,7 @@ export async function removeIntegrations(workspace, names) {
         const adapter = getIntegrationAdapter(name);
         await removeIntegrationInstructions(workspace.rootPath, adapter.targetPath, adapter.name);
         await removeIntegrationCommandFiles(workspace.rootPath, adapter.commandFiles ?? []);
+        await removeIntegrationCommandFiles(workspace.rootPath, adapter.obsoleteCommandFiles ?? []);
         removed.push(adapter.name);
     }
     config.integrations = config.integrations.filter((integration) => !removeNames.has(integration.name));
@@ -77,6 +79,7 @@ async function writeIntegrationCommandFiles(rootPath, files) {
 }
 async function removeIntegrationCommandFiles(rootPath, files) {
     for (const file of files) {
-        await rm(path.join(rootPath, file.path), { force: true });
+        const filePath = typeof file === "string" ? file : file.path;
+        await rm(path.join(rootPath, filePath), { force: true, recursive: true });
     }
 }

package/package.json

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