Document Graph Cache runtime scheduler architecture

[joesobo]

Summary

• Adds planning notes for the Graph Cache/runtime memory/update scheduling follow-up card.
• Captures the simplified architecture: Graph Cache as indexed evidence, runtime memory as the loaded graph, projection/settings as lightweight view state, and D3 rendering from memory.
• Records the senior-architect review points: explicit intent policy, plugin API impact metadata, runtime generation/versioning, fallback rules, and edge cases.

Deterministic Measurement Plan

• Primary metric: Graph Cache save count per scripted burst.
• Secondary metrics: index work count, progress restart count, and latest-state-wins correctness checks.
• Target examples: 10 visual/plugin-setting/filter/scope toggles should schedule 0 Graph Cache saves; 10 analysis-affecting plugin toggles should coalesce to at most 1 cache/index job.

Trello

• https://trello.com/c/sawpINvf

Validation

• git diff --check

Notes

• Docs-only setup PR for the rearchitecture lane. No production behavior changed.

[changeset-bot]

🦋 Changeset detected

Latest commit: 57ef65a

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

This PR includes changesets to release 11 packages

Name	Type
@codegraphy-dev/plugin-godot	Patch
@codegraphy-dev/core	Patch
@codegraphy-dev/extension	Patch
@codegraphy-dev/plugin-typescript	Patch
@codegraphy-dev/plugin-api	Minor
@codegraphy-dev/plugin-markdown	Patch
@codegraphy-dev/plugin-particles	Patch
@codegraphy-dev/plugin-svelte	Patch
@codegraphy-dev/plugin-unity	Patch
@codegraphy-dev/plugin-vue	Patch
@codegraphy-dev/mcp	Patch

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