@codegraphy-pro/organize

Private CodeGraphy plugin for Organize behavior.

The package contributes Organize behavior through the public CodeGraphy plugin API. During local Extract Pro testing it intentionally does not require an Access gate; purchase and account enforcement belongs to the future website/server work. It should not depend on VS Code-specific extension internals.

Owned features:

• collapse
• live-2D pinned nodes
• Graph Sections
• Section Frames
• Section Members
• ownership
• selected paid exports
• section physics
• Organize context menu commands

Local Package Shape

createOrganizePlugin() accepts an optional CodeGraphy IPluginDataHost. The plugin uses that host for Obsidian-style plugin-owned layout data instead of VS Code configuration keys.

import { createOrganizePlugin } from '@codegraphy-pro/organize';

const plugin = createOrganizePlugin({ dataHost });

The package exports the pure Organize model for host integration:

• graph layout contracts, normalization, section creation, updates, deletion, live-2D pins, collapse, and ownership
• plugin-data-backed graph layout store
• Organize layout JSON and Graph Section Markdown exporters registered through the host API
• Graph View runtime section nodes and section ownership projection
• collapsed section projection
• Section Bounds force adapter
• live-2D pinned-node drag-end policy and pin badge renderer
• Section Frame geometry and drag model helpers
• Graph View context menu contributions for creating sections, live-2D pinning, toggling section collapse, and deleting sections

The host is still responsible for loading the package, rendering registered Graph View UI slots, adapting the runtime node/edge metadata into its concrete canvas implementation, preserving core graph coordinate fields, and relaying webview messages. Organize-specific controls, pin badges, and fixed-position drag behavior should appear only while this package is enabled, its Graph View contributions are registered, and the live graph mode supports that feature.

The section creation contribution is labeled New Section... and uses the Graph View create-menu placement. When Organize is enabled in the live 2D graph, the action appears beside New File... and New Folder... in the background context menu and in the toolbar New... popup. Pin Node is also live-2D only; 3D graph views ignore pin menu actions, drag updates, and saved 3D pin coordinates without deleting user-owned layout data. When Organize is disabled, the section action and pin action should disappear with the rest of the package contributions.

Projection contributions use the live Graph View context. Collapsed Graph Sections project member nodes only in the active 2D graph, and timeline snapshots stay unprojected so historical views remain literal.