@principal-ai/subsystems-react 0.24.27 → 0.25.1

package/src/stories/Subsystem/ComponentGraph/ModuleBadges.stories.tsx

@@ -39,7 +39,7 @@ const DEEP_VIEWS = 'packages/subsystems-studio/src/mainview/views/AnalysisView.t
  */
 const deepComponents: SubsystemComponent[] = [
   {
-    id: 'node-comp',
+    alias: 'node-comp',
     name: 'SubsystemComponentNode',
     construct: 'function',
     symbol: 'SubsystemComponentNode',
@@ -49,7 +49,7 @@ const deepComponents: SubsystemComponent[] = [
     purpose: 'Leaf component renderer',
   },
   {
-    id: 'group-comp',
+    alias: 'group-comp',
     name: 'SubsystemGroupNode',
     construct: 'function',
     symbol: 'SubsystemGroupNode',
@@ -59,7 +59,7 @@ const deepComponents: SubsystemComponent[] = [
     purpose: 'Boundary frame renderer',
   },
   {
-    id: 'edge-comp',
+    alias: 'edge-comp',
     name: 'SubsystemEdge',
     construct: 'function',
     symbol: 'SubsystemEdge',
@@ -69,7 +69,7 @@ const deepComponents: SubsystemComponent[] = [
     purpose: 'Edge renderer',
   },
   {
-    id: 'analysis',
+    alias: 'analysis',
     name: 'AnalysisView',
     construct: 'function',
     symbol: 'AnalysisView',
@@ -79,7 +79,7 @@ const deepComponents: SubsystemComponent[] = [
     purpose: 'Renders an analysis',
   },
   {
-    id: 'layers',
+    alias: 'layers',
     name: 'LayersProvider',
     construct: 'function',
     symbol: 'LayersProvider',
@@ -89,7 +89,7 @@ const deepComponents: SubsystemComponent[] = [
     purpose: 'Provides the layer UI',
   },
   {
-    id: 'use-drawings',
+    alias: 'use-drawings',
     name: 'useDrawingsHost',
     construct: 'function',
     symbol: 'useDrawingsHost',
@@ -135,7 +135,7 @@ const harnessRegion: SubsystemProcessRegion = {
   kind: 'module',
   key: DEEP_NODES,
   label: DEEP_NODES,
-  memberIds: ['node-comp', 'group-comp', 'edge-comp'],
+  memberAliases: ['node-comp', 'group-comp', 'edge-comp'],
 };
 
 /** Fixed frame; the badge is the only thing that grows on click. */

package/src/stories/Subsystem/ComponentGraph/Modules.stories.tsx

@@ -30,7 +30,7 @@ const PURL = 'pkg:github/principal-ai/agent-monitoring';
  */
 const moduleComponents: SubsystemComponent[] = [
   {
-    id: 'record',
+    alias: 'record',
     name: 'CodexRolloutRecord',
     construct: 'type_alias',
     symbol: 'CodexRolloutRecord',
@@ -41,7 +41,7 @@ const moduleComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'is-rollout',
+    alias: 'is-rollout',
     name: 'isCodexRollout',
     construct: 'function',
     symbol: 'isCodexRollout',
@@ -52,7 +52,7 @@ const moduleComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'parse',
+    alias: 'parse',
     name: 'parseTranscript',
     construct: 'function',
     symbol: 'parseTranscript',
@@ -63,7 +63,7 @@ const moduleComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'tool-name',
+    alias: 'tool-name',
     name: 'extractToolName',
     construct: 'function',
     symbol: 'extractToolName',
@@ -74,7 +74,7 @@ const moduleComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'file-path',
+    alias: 'file-path',
     name: 'extractFilePath',
     construct: 'function',
     symbol: 'extractFilePath',
@@ -85,7 +85,7 @@ const moduleComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'reader',
+    alias: 'reader',
     name: 'SessionReader',
     construct: 'class',
     symbol: 'SessionReader',
@@ -96,7 +96,7 @@ const moduleComponents: SubsystemComponent[] = [
     layer: 3,
   },
   {
-    id: 'normalize',
+    alias: 'normalize',
     name: 'normalize',
     construct: 'method',
     symbol: 'SessionReader.normalize',
@@ -107,7 +107,7 @@ const moduleComponents: SubsystemComponent[] = [
     layer: 3,
   },
   {
-    id: 'registry',
+    alias: 'registry',
     name: 'registerAgent',
     construct: 'function',
     symbol: 'registerAgent',
@@ -147,7 +147,7 @@ export const ModuleBoundaries: Story = {
 /** Process → module → export nesting (host / renderer). */
 const nestedComponents: SubsystemComponent[] = [
   {
-    id: 'boot',
+    alias: 'boot',
     name: 'boot',
     construct: 'function',
     symbol: 'boot',
@@ -160,7 +160,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'create-host',
+    alias: 'create-host',
     name: 'createHost',
     construct: 'function',
     symbol: 'createHost',
@@ -172,7 +172,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'session-store',
+    alias: 'session-store',
     name: 'SessionStore',
     construct: 'store',
     symbol: 'SessionStore',
@@ -184,7 +184,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'write-session',
+    alias: 'write-session',
     name: 'writeSession',
     construct: 'function',
     symbol: 'writeSession',
@@ -196,7 +196,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'bridge',
+    alias: 'bridge',
     name: 'bridge',
     construct: 'function',
     symbol: 'bridge',
@@ -209,7 +209,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 3,
   },
   {
-    id: 'post-to-host',
+    alias: 'post-to-host',
     name: 'postToHost',
     construct: 'function',
     symbol: 'postToHost',
@@ -221,7 +221,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 3,
   },
   {
-    id: 'trail-view',
+    alias: 'trail-view',
     name: 'TrailView',
     construct: 'function',
     symbol: 'TrailView',
@@ -235,7 +235,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 4,
   },
   {
-    id: 'use-trail',
+    alias: 'use-trail',
     name: 'useTrail',
     construct: 'function',
     symbol: 'useTrail',
@@ -249,7 +249,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 4,
   },
   {
-    id: 'telemetry',
+    alias: 'telemetry',
     name: 'telemetry',
     construct: 'external',
     role: 'service',

package/src/stories/Subsystem/ComponentGraph/NodeAnatomy.stories.tsx

@@ -73,7 +73,7 @@ const CHANNELS: Channel[] = [
     label: 'baseline — function',
     note: 'border color = construct (function-indigo); left badge = construct.',
     component: {
-      id: 'fn',
+      alias: 'fn',
       name: 'auditSubsystemModel',
       construct: 'function',
       file: 'src/bun/verify-subsystem-component.ts',
@@ -85,7 +85,7 @@ const CHANNELS: Channel[] = [
     label: 'class',
     note: 'construct color changes per kind; nothing else moves.',
     component: {
-      id: 'cls',
+      alias: 'cls',
       name: 'MaintainModelAgent',
       construct: 'class',
       file: 'src/bun/maintain-model.ts',
@@ -97,7 +97,7 @@ const CHANNELS: Channel[] = [
     label: 'external',
     note: 'outside the system — square corners, no file.',
     component: {
-      id: 'ext',
+      alias: 'ext',
       name: '@opencode-ai/cli',
       construct: 'external',
       file: '',
@@ -109,7 +109,7 @@ const CHANNELS: Channel[] = [
     label: 'role badge',
     note: 'top-right badge = role.',
     component: {
-      id: 'role',
+      alias: 'role',
       name: 'handleRequest',
       construct: 'function',
       file: 'src/bun/http-server.ts',
@@ -122,7 +122,7 @@ const CHANNELS: Channel[] = [
     label: 'store + storage badge',
     note: 'store backs a storage badge beside the role badge.',
     component: {
-      id: 'store',
+      alias: 'store',
       name: 'sessionCache',
       construct: 'store',
       file: 'src/bun/session-cache.ts',
@@ -135,7 +135,7 @@ const CHANNELS: Channel[] = [
     label: 'proposed',
     note: 'dashed goldenrod border + right badge; fileless.',
     component: {
-      id: 'prop',
+      alias: 'prop',
       name: 'OpenCodeV2Lifecycle',
       construct: 'function',
       file: '',
@@ -148,7 +148,7 @@ const CHANNELS: Channel[] = [
     label: 'proposed + role',
     note: 'proposed wins the right badge; role stays on the model.',
     component: {
-      id: 'prop-role',
+      alias: 'prop-role',
       name: 'startMaintainFlow',
       construct: 'function',
       file: '',
@@ -162,7 +162,7 @@ const CHANNELS: Channel[] = [
     label: 'framework stereotype',
     note: 'left badge prefers "framework · stereotype"; border stays construct.',
     component: {
-      id: 'react',
+      alias: 'react',
       name: 'SubsystemComponentNode',
       construct: 'function',
       file: 'src/subsystem/nodes.tsx',
@@ -176,7 +176,7 @@ const CHANNELS: Channel[] = [
     label: 'custom entity',
     note: 'left badge wears the entityKind.',
     component: {
-      id: 'entity',
+      alias: 'entity',
       name: 'WorkRequester',
       construct: 'custom_entity',
       file: '',
@@ -188,7 +188,7 @@ const CHANNELS: Channel[] = [
     label: 'selected',
     note: 'selection only thickens the border (2 → 4); color stays construct.',
     component: {
-      id: 'sel',
+      alias: 'sel',
       name: 'runMaintainModel',
       construct: 'function',
       file: 'src/bun/maintain-model.ts',
@@ -246,7 +246,7 @@ export const Channels: Story = {
           }}
         >
           {CHANNELS.map((c) => (
-            <ChannelCell key={c.component.id} channel={c} />
+            <ChannelCell key={c.component.alias} channel={c} />
           ))}
         </div>
       </div>
@@ -423,32 +423,32 @@ const ISSUE_EXAMPLES: Array<{
   },
   {
     caption: 'error · earliest rung is file (declaration file missing)',
-    component: { ...CHANNELS[0]!.component, id: 'e-file' },
+    component: { ...CHANNELS[0]!.component, alias: 'e-file' },
     severity: 'error',
     rung: 'file',
     count: 2,
   },
   {
     caption: 'error · earliest rung is symbol (multiple symbol matches)',
-    component: { ...CHANNELS[1]!.component, id: 'e-sym' },
+    component: { ...CHANNELS[1]!.component, alias: 'e-sym' },
     severity: 'error',
     rung: 'symbol',
   },
   {
     caption: 'info/gap · dashed ring · declaration drift',
-    component: { ...CHANNELS[1]!.component, id: 'e-decl' },
+    component: { ...CHANNELS[1]!.component, alias: 'e-decl' },
     severity: 'info',
     rung: 'declaration',
   },
   {
     caption: 'error · type mismatch',
-    component: { ...CHANNELS[7]!.component, id: 'e-type' },
+    component: { ...CHANNELS[7]!.component, alias: 'e-type' },
     severity: 'error',
     rung: 'type',
   },
   {
     caption: 'error · signature mismatch (deepest rung)',
-    component: { ...CHANNELS[0]!.component, id: 'e-sig' },
+    component: { ...CHANNELS[0]!.component, alias: 'e-sig' },
     severity: 'error',
     rung: 'signature',
   },

package/src/stories/Subsystem/ComponentGraph/Packages.stories.tsx

@@ -31,7 +31,7 @@ const LIB = 'pkg:github/acme/lib';
  */
 const multiRepoComponents: SubsystemComponent[] = [
   {
-    id: 'dispatch',
+    alias: 'dispatch',
     name: 'dispatch',
     construct: 'function',
     symbol: 'dispatch',
@@ -43,7 +43,7 @@ const multiRepoComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'session',
+    alias: 'session',
     name: 'SessionService',
     construct: 'class',
     symbol: 'SessionService',
@@ -55,7 +55,7 @@ const multiRepoComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'parse',
+    alias: 'parse',
     name: 'parseEvent',
     construct: 'function',
     symbol: 'parseEvent',
@@ -67,7 +67,7 @@ const multiRepoComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'normalize',
+    alias: 'normalize',
     name: 'normalize',
     construct: 'function',
     symbol: 'normalize',
@@ -123,7 +123,7 @@ export const SingleRepoNoPackageFrames: Story = {
  */
 const nestedComponents: SubsystemComponent[] = [
   {
-    id: 'dispatch',
+    alias: 'dispatch',
     name: 'dispatch',
     construct: 'function',
     symbol: 'dispatch',
@@ -135,7 +135,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'boot',
+    alias: 'boot',
     name: 'boot',
     construct: 'function',
     symbol: 'boot',
@@ -147,7 +147,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'session',
+    alias: 'session',
     name: 'SessionService',
     construct: 'class',
     symbol: 'SessionService',
@@ -159,7 +159,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'session-types',
+    alias: 'session-types',
     name: 'SessionRecord',
     construct: 'type_alias',
     symbol: 'SessionRecord',
@@ -171,7 +171,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'parse',
+    alias: 'parse',
     name: 'parseEvent',
     construct: 'function',
     symbol: 'parseEvent',
@@ -183,7 +183,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'parse-types',
+    alias: 'parse-types',
     name: 'RawEvent',
     construct: 'type_alias',
     symbol: 'RawEvent',
@@ -195,7 +195,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'normalize',
+    alias: 'normalize',
     name: 'normalize',
     construct: 'function',
     symbol: 'normalize',
@@ -207,7 +207,7 @@ const nestedComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'normalize-types',
+    alias: 'normalize-types',
     name: 'NormalizedEvent',
     construct: 'type_alias',
     symbol: 'NormalizedEvent',

package/src/stories/Subsystem/ComponentGraph/Processes.stories.tsx

@@ -31,7 +31,7 @@ const processComponents = [
     ['bridge', 'bridge', 'function', 'src/renderer/bridge.ts', 'pkg:github/principal-ai/principal-studio', 'IPC bridge to the host', 'bridge'],
   ]),
   {
-    id: 'svc',
+    alias: 'svc',
     name: 'telemetry',
     construct: 'external' as const,
     file: '',

package/src/stories/Subsystem/ComponentGraph/Proposed.stories.tsx

@@ -95,7 +95,7 @@ const spotlightRows: Array<{ label: string; component: SubsystemComponent }> = [
   {
     label: 'normal function (baseline)',
     component: {
-      id: 'live-fn',
+      alias: 'live-fn',
       name: 'ensureOpencode',
       construct: 'function',
       file: 'src/bun/opencode-v2.ts',
@@ -107,7 +107,7 @@ const spotlightRows: Array<{ label: string; component: SubsystemComponent }> = [
   {
     label: 'proposed function — dashed border + right badge',
     component: {
-      id: 'prop-fn',
+      alias: 'prop-fn',
       name: 'OpenCodeV2Lifecycle',
       construct: 'function',
       file: '',
@@ -120,7 +120,7 @@ const spotlightRows: Array<{ label: string; component: SubsystemComponent }> = [
   {
     label: 'proposed class',
     component: {
-      id: 'prop-class',
+      alias: 'prop-class',
       name: 'MaintainModelAgent',
       construct: 'class',
       file: 'src/bun/maintain-model-agent.ts',
@@ -133,7 +133,7 @@ const spotlightRows: Array<{ label: string; component: SubsystemComponent }> = [
   {
     label: 'proposed + role: entry (badge shows proposed only)',
     component: {
-      id: 'prop-entry',
+      alias: 'prop-entry',
       name: 'startMaintainFlow',
       construct: 'function',
       file: '',
@@ -147,7 +147,7 @@ const spotlightRows: Array<{ label: string; component: SubsystemComponent }> = [
   {
     label: 'external (contrast — real outside system)',
     component: {
-      id: 'ext',
+      alias: 'ext',
       name: 'OpenCode CLI',
       construct: 'external',
       file: '',
@@ -174,7 +174,7 @@ export const Spotlights: Story = {
       }}
     >
       {spotlightRows.map((row) => (
-        <NodeSpotlight key={row.component.id} {...row} />
+        <NodeSpotlight key={row.component.alias} {...row} />
       ))}
     </div>
   ),
@@ -185,7 +185,7 @@ export const Spotlights: Story = {
 // ---------------------------------------------------------------------------
 const migrationComponents: SubsystemComponent[] = [
   {
-    id: 'audit',
+    alias: 'audit',
     name: 'auditSubsystemModel',
     construct: 'function',
     file: 'src/bun/verify-subsystem-component.ts',
@@ -195,7 +195,7 @@ const migrationComponents: SubsystemComponent[] = [
     role: 'entry',
   },
   {
-    id: 'lifecycle',
+    alias: 'lifecycle',
     name: 'OpenCodeV2Lifecycle',
     construct: 'function',
     file: '',
@@ -205,7 +205,7 @@ const migrationComponents: SubsystemComponent[] = [
     proposed: true,
   },
   {
-    id: 'maintain',
+    alias: 'maintain',
     name: 'runMaintainModel',
     construct: 'function',
     file: 'src/bun/maintain-model.ts',
@@ -214,7 +214,7 @@ const migrationComponents: SubsystemComponent[] = [
     purpose: 'Existing maintain agent runner',
   },
   {
-    id: 'cli',
+    alias: 'cli',
     name: '@opencode-ai/cli',
     construct: 'external',
     file: '',