joesobo · joesobo · Jul 16, 2026 · Jul 16, 2026
diff --git a/.changeset/custom-graph-renderer.md b/.changeset/custom-graph-renderer.md
diff --git a/.changeset/honest-graph-performance-hud.md b/.changeset/honest-graph-performance-hud.md
diff --git a/.changeset/remove-3d-graph.md b/.changeset/remove-3d-graph.md
diff --git a/.changeset/remove-layout-and-uniform-controls.md b/.changeset/remove-layout-and-uniform-controls.md
diff --git a/.changeset/remove-timeline-view.md b/.changeset/remove-timeline-view.md
diff --git a/docs/PLUGINS.md b/docs/PLUGINS.md
@@ -68,7 +68,7 @@ Plugin packages declare package-level CodeGraphy metadata in `package.json` so r
   },
   "codegraphy": {
     "type": "plugin",
-    "apiVersion": "^2.0.0",
+    "apiVersion": "^3.0.0",
     "defaultOptions": {
       "includeTests": true
     },
@@ -85,7 +85,7 @@ The same package must also include a static `codegraphy.json` descriptor. Core r
   "id": "codegraphy.vue",
   "name": "Vue",
   "version": "1.0.0",
-  "apiVersion": "^2.0.0",
+  "apiVersion": "^3.0.0",
   "supportedExtensions": [".vue"],
   "defaultFilters": []
 }
@@ -122,7 +122,7 @@ const createPlugin: IPluginFactory = ({ dataHost, options } = {}) => ({
   id: 'acme.graph-tools',
   name: 'Acme Graph Tools',
   version: '1.0.0',
-  apiVersion: '^2.0.0',
+  apiVersion: '^3.0.0',
   supportedExtensions: [],
   async initialize() {
     await dataHost?.saveData({ mode: options?.mode ?? 'default' });
@@ -140,7 +140,7 @@ Default options are copied into workspace settings when the plugin is enabled so
 {
   "codegraphy": {
     "type": "plugin",
-    "apiVersion": "^2.0.0",
+    "apiVersion": "^3.0.0",
     "defaultOptions": {
       "includeSceneResources": true,
       "includeAutoloads": true,

diff --git a/docs/plugin-api/LIFECYCLE.md b/docs/plugin-api/LIFECYCLE.md
@@ -23,7 +23,7 @@ Registration reads global package metadata without importing plugin runtime code
   },
   "codegraphy": {
     "type": "plugin",
-    "apiVersion": "^2.0.0",
+    "apiVersion": "^3.0.0",
     "defaultOptions": {
       "includeTests": true
     },
@@ -40,7 +40,7 @@ The same package declares its static Plugin ID and display metadata in `codegrap
   "id": "acme.plugin",
   "name": "Acme Plugin",
   "version": "1.0.0",
-  "apiVersion": "^2.0.0",
+  "apiVersion": "^3.0.0",
   "supportedExtensions": [".ts"]
 }
 ```
@@ -58,7 +58,7 @@ const plugin: IPlugin = {
   id: 'acme.plugin',
   name: 'Acme Plugin',
   version: '1.0.0',
-  apiVersion: '^2.0.0',
+  apiVersion: '^3.0.0',
   supportedExtensions: ['.ts'],
 };
 ```
@@ -165,7 +165,7 @@ export function createMetricsPlugin(): IPlugin {
     id: 'codegraphy-metrics',
     name: 'Metrics',
     version: '1.0.0',
-    apiVersion: '^2.0.0',
+    apiVersion: '^3.0.0',
     supportedExtensions: ['*'],
 
     async initialize(workspaceRoot, context) {

diff --git a/docs/plugin-api/TYPES.md b/docs/plugin-api/TYPES.md
@@ -39,7 +39,7 @@ The public package is host-agnostic. VS Code-specific bridge types, decorations,
 Defined in `plugin.ts`.
 
 Key points:
-- `apiVersion: string` is required (for example `'^2.0.0'`).
+- `apiVersion: string` is required (for example `'^3.0.0'`).
 - `sources?: IConnectionSource[]` declares the plugin's Relationship Source families.
 - `fileColors?: Record<string, string | IPluginFileColorDefinition>` lets plugins provide default color/shape/imagePath styling by pattern.
 - `analyzeFile(filePath, content, workspaceRoot, context?)` is the plugin analysis hook for returning relationships, symbols, and contributed Node Types or Edge Types.

diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -1,5 +1,25 @@
 # @codegraphy-dev/core
 
+## 2.0.0
+
+### Major Changes
+
+- Advance the host runtime compatibility protocol to Plugin API 3. Plugins must declare `apiVersion: '^3.0.0'`; plugins targeting the removed v2 contracts are rejected before registration.
+
+- [#308](https://github.com/joesobo/CodeGraphyV4/pull/308) [`b744f20`](https://github.com/joesobo/CodeGraphyV4/commit/b744f20bb1391e9a0c40d3e448a4f3f78bde4974) Thanks [@joesobo](https://github.com/joesobo)! - CodeGraphy now provides one supported 2D Relationship Graph and removes the 3D graph mode, its toolbar toggle, 3D node shapes, 3D camera state, and Three.js renderer settings. Existing workspaces open directly in the 2D graph; saved 3D preferences are ignored.
+
+  This is a breaking Plugin API change. Plugin authors must remove `GraphNodeShape3D`, `shape3D`, `graphMode`, three-dimensional node coordinates (`z`, `fz`, and `vz`), and 3D values in selected-node position payloads. Graph View contributions, drag callbacks, context-menu selectors, and viewport adapters now receive only two-dimensional graph state. The Unity plugin continues to contribute Unity graph data but no longer supplies 3D presentation metadata.
+
+- [#308](https://github.com/joesobo/CodeGraphyV4/pull/308) [`5a65047`](https://github.com/joesobo/CodeGraphyV4/commit/5a65047d1a715f005760ace0ebf0f550a16efa2e) Thanks [@joesobo](https://github.com/joesobo)! - CodeGraphy now opens one current-workspace Relationship Graph and removes the Timeline panel, commit-by-commit Graph Revision playback, revision controls, and Git-history Churn node sizing. Existing workspaces keep their current graph settings, but saved Timeline state and Churn sizing selections no longer affect the graph. Choose Connections or File Size for semantic node sizing.
+
+  This is a breaking Plugin API and Core package change. Plugin authors must remove the `timeline-panel` slot, Timeline lifecycle events and payloads, `timelineActive` contribution/context fields, Timeline analysis mode and `commitSha`, and the optional `churn` graph-node field. Core callers must stop passing churn counts into graph construction. Plugins should analyze the current CodeGraphy Workspace and contribute to the normal Graph View instead of branching on Timeline state.
+
+### Patch Changes
+
+- Updated dependencies [[`b744f20`](https://github.com/joesobo/CodeGraphyV4/commit/b744f20bb1391e9a0c40d3e448a4f3f78bde4974), [`5a65047`](https://github.com/joesobo/CodeGraphyV4/commit/5a65047d1a715f005760ace0ebf0f550a16efa2e)]:
+  - @codegraphy-dev/plugin-api@6.0.0
+  - @codegraphy-dev/plugin-markdown@1.1.9
+
 ## 1.7.2
 
 ### Patch Changes

diff --git a/packages/core/README.md b/packages/core/README.md
@@ -57,7 +57,7 @@ Plugin npm packages identify themselves with package metadata:
   "version": "1.2.3",
   "codegraphy": {
     "type": "plugin",
-    "apiVersion": "^2.0.0",
+    "apiVersion": "^3.0.0",
     "defaultOptions": {
       "includeTests": true
     },

diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@codegraphy-dev/core",
-  "version": "1.7.2",
+  "version": "2.0.0",
   "description": "CodeGraphy core indexing and graph query engine",
   "license": "MIT",
   "type": "module",

diff --git a/packages/core/src/plugins/api.ts b/packages/core/src/plugins/api.ts
@@ -1 +1 @@
-export const CORE_PLUGIN_API_VERSION = '2.0.0';
+export const CORE_PLUGIN_API_VERSION = '3.0.0';
diff --git a/packages/core/src/plugins/markdown/metadata.ts b/packages/core/src/plugins/markdown/metadata.ts
@@ -8,7 +8,7 @@ export const CODEGRAPHY_MARKDOWN_PLUGIN_METADATA = {
   id: CODEGRAPHY_MARKDOWN_PLUGIN_ID,
   name: 'Markdown',
   version: '1.0.0',
-  apiVersion: '^2.0.0',
+  apiVersion: '^3.0.0',
   supportedExtensions: ['*'],
   updateImpact: {
     toggle: 'reanalyze-plugin-files',
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		export const CORE_PLUGIN_API_VERSION = '2.0.0';
		export const CORE_PLUGIN_API_VERSION = '3.0.0';