Update Graph Cache from VS Code file events

[joesobo]

Result

Keep an existing Graph Cache current from VS Code save, create, delete, and rename events. The extension uses the existing targeted Core refresh path and does not start Core watch mode or a foreground filesystem watcher.

Plan

• Add a bounded, serialized workspace-event scheduler.
• Route changed paths through the extension pipeline and Core targeted refresh.
• Preserve explicit initial Index and coordinate with explicit re-index operations.
• Exclude generated .codegraphy writes and surface queued, updating, idle, and error state.
• Update cache lifecycle documentation and add a user-facing changeset.
• Run focused tests, TypeScript, ESLint, and the VS Code production build.
• Attempt a bounded real VS Code extension-host save scenario.

CPU safeguards

• No activation-time source analysis.
• No polling and no Core watch process.
• 500 ms trailing debounce with a 2 second maximum batch age.
• Deduplicated paths and one update at a time.
• No updates before the initial Graph Cache exists.
• Abort and timer cleanup on extension disposal.

Verification

• 66 focused tests pass across 15 files.
• Extension source and test TypeScript checks pass.
• Focused ESLint passes.
• pnpm --filter @codegraphy-dev/extension run build:vscode passes.
• A coverage/CRAP attempt ran 5,562 extension tests: 5,561 passed and one hardcoded subscription-count test failed. That branch-caused test was updated and then passed.
• A bounded workspace unit attempt reached 15 of 16 successful package tasks before manual stop at 1m37 with no reported failure.
• The real extension-host save scenario could not launch VS Code 1.131 after download because the test runner executable path was absent (Electron ENOENT). This matches the current local VS Code 1.131 harness failure and occurred before extension activation.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
codegraphy	Skipped		Jul 30, 2026 4:54pm

[changeset-bot]

🦋 Changeset detected

Latest commit: d215df9

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@codegraphy-dev/extension	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR