@principal-ai/subsystems-react 0.24.27 → 0.25.1

package/src/stories/Subsystem/ComponentDeclarationAudit.stories.tsx

@@ -37,7 +37,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'function — no params',
     component: {
-      id: 'fn-void',
+      alias: 'fn-void',
       name: 'flush',
       construct: 'function',
       file: 'src/event-processing/sink.ts',
@@ -52,7 +52,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'function — single param',
     component: {
-      id: 'fn-one',
+      alias: 'fn-one',
       name: 'normalize',
       construct: 'function',
       file: 'src/session/SessionReader.ts',
@@ -68,7 +68,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'function — two params',
     component: {
-      id: 'fn-two',
+      alias: 'fn-two',
       name: 'normalizeSession',
       construct: 'function',
       file: 'src/event-processing/normalize.ts',
@@ -87,7 +87,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'function — rich params (positional, union, callback, generic return)',
     component: {
-      id: 'fn-rich',
+      alias: 'fn-rich',
       name: 'mergeSessions',
       construct: 'function',
       file: 'src/session/merge.ts',
@@ -108,7 +108,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'class — no body',
     component: {
-      id: 'class-empty',
+      alias: 'class-empty',
       name: 'EmptyClass',
       construct: 'class',
       file: 'src/empty.ts',
@@ -122,7 +122,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'class — properties only',
     component: {
-      id: 'class-props',
+      alias: 'class-props',
       name: 'Config',
       construct: 'class',
       file: 'src/config.ts',
@@ -141,7 +141,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'class — methods + properties + extends + implements',
     component: {
-      id: 'class-rich',
+      alias: 'class-rich',
       name: 'EventProcessor',
       construct: 'class',
       file: 'src/event-processing/EventProcessor.ts',
@@ -168,7 +168,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'type — properties',
     component: {
-      id: 'type-props',
+      alias: 'type-props',
       name: 'SessionRecord',
       construct: 'interface',
       file: 'src/session/transcript.ts',
@@ -186,7 +186,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'type — no properties',
     component: {
-      id: 'type-empty',
+      alias: 'type-empty',
       name: 'BrandedId',
       construct: 'interface',
       file: 'src/types.ts',
@@ -200,7 +200,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'external',
     component: {
-      id: 'ext',
+      alias: 'ext',
       name: 'principal-studio',
       construct: 'external',
       file: '',
@@ -215,7 +215,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'function — no symbol (uses name fallback)',
     component: {
-      id: 'fn-no-symbol',
+      alias: 'fn-no-symbol',
       name: 'anonymousHelper',
       construct: 'function',
       file: 'src/helpers.ts',
@@ -230,7 +230,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'method — standalone from class',
     component: {
-      id: 'method-normalize',
+      alias: 'method-normalize',
       name: 'normalize',
       construct: 'method',
       file: 'src/session/SessionReader.ts',
@@ -247,7 +247,7 @@ const cases: { label: string; component: SubsystemComponent }[] = [
   {
     label: 'method — no params',
     component: {
-      id: 'method-dispose',
+      alias: 'method-dispose',
       name: 'dispose',
       construct: 'method',
       file: 'src/event-processing/EventProcessor.ts',

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

@@ -44,7 +44,7 @@ export const NarrowMaxWidth: Story = {
 // ---------------------------------------------------------------------------
 const namingConventionComponents: SubsystemComponent[] = [
   {
-    id: 'camel',
+    alias: 'camel',
     name: 'accumulateToAgentSessionEvents',
     construct: 'function',
     file: 'src/event-processing/accumulator.ts',
@@ -52,7 +52,7 @@ const namingConventionComponents: SubsystemComponent[] = [
     symbol: 'accumulateToAgentSessionEvents',
   },
   {
-    id: 'snake',
+    alias: 'snake',
     name: 'repo_normalized_universal_event',
     construct: 'interface',
     file: 'src/event-processing/repo_normalized.ts',
@@ -60,7 +60,7 @@ const namingConventionComponents: SubsystemComponent[] = [
     symbol: 'repo_normalized_universal_event',
   },
   {
-    id: 'pascal',
+    alias: 'pascal',
     name: 'RepoNormalizedUniversalAgentSessionEvent',
     construct: 'class',
     file: 'src/event-processing/RepoNormalized.ts',
@@ -68,7 +68,7 @@ const namingConventionComponents: SubsystemComponent[] = [
     symbol: 'RepoNormalizedUniversalAgentSessionEvent',
   },
   {
-    id: 'acronym',
+    alias: 'acronym',
     name: 'ProcessSSEStreamForEventToken',
     construct: 'function',
     file: 'src/event-processing/sse.ts',
@@ -76,7 +76,7 @@ const namingConventionComponents: SubsystemComponent[] = [
     symbol: 'ProcessSSEStreamForEventToken',
   },
   {
-    id: 'method',
+    alias: 'method',
     name: 'normalize',
     construct: 'function',
     file: 'src/session/SessionReader.ts',
@@ -84,7 +84,7 @@ const namingConventionComponents: SubsystemComponent[] = [
     symbol: 'SessionReader.normalize',
   },
   {
-    id: 'pkg',
+    alias: 'pkg',
     name: 'principal-studio',
     construct: 'external',
     file: '',
@@ -118,7 +118,7 @@ const variationPurl = 'pkg:github/principal-ai/agent-monitoring';
 const kindVariationComponents: SubsystemComponent[] = [
   // --- class: bare → members only → relationships only
   {
-    id: 'cls-bare',
+    alias: 'cls-bare',
     name: 'SessionStore',
     construct: 'class',
     file: 'src/session/SessionStore.ts',
@@ -128,7 +128,7 @@ const kindVariationComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'cls-members',
+    alias: 'cls-members',
     name: 'Transcoder',
     construct: 'class',
     file: 'src/session/Transcoder.ts',
@@ -151,7 +151,7 @@ const kindVariationComponents: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'cls-relations',
+    alias: 'cls-relations',
     name: 'HttpTransport',
     construct: 'class',
     file: 'src/transport/HttpTransport.ts',
@@ -172,7 +172,7 @@ const kindVariationComponents: SubsystemComponent[] = [
 
   // --- function: bare → signature only → signature + call relationships
   {
-    id: 'fn-bare',
+    alias: 'fn-bare',
     name: 'bootstrap',
     construct: 'function',
     file: 'src/bootstrap.ts',
@@ -182,7 +182,7 @@ const kindVariationComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'fn-signature',
+    alias: 'fn-signature',
     name: 'normalizeSession',
     construct: 'function',
     file: 'src/event-processing/normalize.ts',
@@ -202,7 +202,7 @@ const kindVariationComponents: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'fn-calls',
+    alias: 'fn-calls',
     name: 'mergeSessions',
     construct: 'function',
     file: 'src/session/merge.ts',
@@ -224,7 +224,7 @@ const kindVariationComponents: SubsystemComponent[] = [
 
   // --- type: bare → fields only → fields + implementors + used-by
   {
-    id: 'ty-bare',
+    alias: 'ty-bare',
     name: 'RawFrame',
     construct: 'interface',
     file: 'src/session/RawFrame.ts',
@@ -234,7 +234,7 @@ const kindVariationComponents: SubsystemComponent[] = [
     layer: 3,
   },
   {
-    id: 'ty-fields',
+    alias: 'ty-fields',
     name: 'SessionRecord',
     construct: 'interface',
     file: 'src/session/transcript.ts',
@@ -253,7 +253,7 @@ const kindVariationComponents: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'ty-full',
+    alias: 'ty-full',
     name: 'Transport',
     construct: 'interface',
     file: 'src/transport/Transport.ts',
@@ -271,7 +271,7 @@ const kindVariationComponents: SubsystemComponent[] = [
 
   // --- external: bare → labeled
   {
-    id: 'ext-bare',
+    alias: 'ext-bare',
     name: 'left-pad',
     construct: 'external',
     file: '',
@@ -281,7 +281,7 @@ const kindVariationComponents: SubsystemComponent[] = [
     layer: 5,
   },
   {
-    id: 'ext-label',
+    alias: 'ext-label',
     name: 'principal-studio',
     construct: 'external',
     file: '',

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

@@ -78,7 +78,7 @@ function PlaygroundDemo({ leftCount, rightCount, showEdgeLabels }: { leftCount:
 
   for (let i = 0; i < leftCount; i++) {
     comps.push({
-      id: `l${i}`,
+      alias: `l${i}`,
       name: `Left${i}`,
       construct: 'class',
       file: `left${i}.ts`,
@@ -88,7 +88,7 @@ function PlaygroundDemo({ leftCount, rightCount, showEdgeLabels }: { leftCount:
   }
   for (let i = 0; i < rightCount; i++) {
     comps.push({
-      id: `r${i}`,
+      alias: `r${i}`,
       name: `Right${i}`,
       construct: 'class',
       file: `right${i}.ts`,

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

@@ -163,7 +163,7 @@ export const ResolvedPostGraphify: Story = {
 // ---------------------------------------------------------------------------
 const investigationComponents: SubsystemComponent[] = [
   {
-    id: 'adapter',
+    alias: 'adapter',
     name: 'OpenCodeAdapter',
     construct: 'function',
     file: 'apps/server/src/provider/Layers/OpenCodeAdapter.ts',
@@ -172,7 +172,7 @@ const investigationComponents: SubsystemComponent[] = [
     symbol: 'makeOpenCodeAdapter',
   },
   {
-    id: 'ingestion',
+    alias: 'ingestion',
     name: 'ProviderRuntimeIngestion',
     construct: 'function',
     file: 'apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.ts',
@@ -181,7 +181,7 @@ const investigationComponents: SubsystemComponent[] = [
     symbol: 'ProviderRuntimeIngestion',
   },
   {
-    id: 'contracts',
+    alias: 'contracts',
     name: 'orchestration',
     construct: 'function',
     file: 'packages/contracts/src/orchestration.ts',

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

@@ -32,7 +32,7 @@ const PURL = 'pkg:github/you/notes-intake';
 /** One construct of each core kind, no relations — the catalog view. */
 const constructsOnly: SubsystemComponent[] = [
   {
-    id: 'submit-note',
+    alias: 'submit-note',
     name: 'submitNote',
     construct: 'function',
     symbol: 'submitNote',
@@ -58,7 +58,7 @@ const constructsOnly: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'note-service',
+    alias: 'note-service',
     name: 'NoteService',
     construct: 'class',
     symbol: 'NoteService',
@@ -86,7 +86,7 @@ const constructsOnly: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'note-service-persist',
+    alias: 'note-service-persist',
     name: 'persist',
     construct: 'method',
     symbol: 'NoteService.persist',
@@ -108,7 +108,7 @@ const constructsOnly: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'note-repository',
+    alias: 'note-repository',
     name: 'NoteRepository',
     construct: 'interface',
     symbol: 'NoteRepository',
@@ -131,7 +131,7 @@ const constructsOnly: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'note-id',
+    alias: 'note-id',
     name: 'NoteId',
     construct: 'type_alias',
     symbol: 'NoteId',
@@ -150,7 +150,7 @@ const constructsOnly: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'note-kind',
+    alias: 'note-kind',
     name: 'NoteKind',
     construct: 'enum',
     symbol: 'NoteKind',

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

@@ -25,7 +25,7 @@ function entityDetail(attributes: Array<[string, string]>): GraphifyCustomEntity
 
 const components: SubsystemComponent[] = [
   {
-    id: 'wr',
+    alias: 'wr',
     name: 'WorkRequester',
     construct: 'custom_entity',
     entityKind: 'Person',
@@ -39,7 +39,7 @@ const components: SubsystemComponent[] = [
     ]),
   },
   {
-    id: 'tech',
+    alias: 'tech',
     name: 'FacilitiesTechnician',
     construct: 'custom_entity',
     entityKind: 'Person',
@@ -54,7 +54,7 @@ const components: SubsystemComponent[] = [
     ]),
   },
   {
-    id: 'sup',
+    alias: 'sup',
     name: 'ShiftSupervisor',
     construct: 'custom_entity',
     entityKind: 'Person',
@@ -69,7 +69,7 @@ const components: SubsystemComponent[] = [
     ]),
   },
   {
-    id: 'mgr',
+    alias: 'mgr',
     name: 'CampusOpsManager',
     construct: 'custom_entity',
     entityKind: 'Person',
@@ -84,7 +84,7 @@ const components: SubsystemComponent[] = [
     ]),
   },
   {
-    id: 'vp',
+    alias: 'vp',
     name: 'VPOperations',
     construct: 'custom_entity',
     entityKind: 'Person',
@@ -99,7 +99,7 @@ const components: SubsystemComponent[] = [
     ]),
   },
   {
-    id: 'agent',
+    alias: 'agent',
     name: 'OpsInsightAgent',
     construct: 'custom_entity',
     entityKind: 'agent',
@@ -115,7 +115,7 @@ const components: SubsystemComponent[] = [
     ]),
   },
   {
-    id: 'queue',
+    alias: 'queue',
     name: 'NudgeQueue',
     construct: 'custom_entity',
     entityKind: 'queue',
@@ -131,7 +131,7 @@ const components: SubsystemComponent[] = [
     ]),
   },
   {
-    id: 'store',
+    alias: 'store',
     name: 'WorkRequestStore',
     construct: 'store',
     file: 'src/ops/workRequests.ts',

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

@@ -35,7 +35,7 @@ type Story = StoryObj<typeof meta>;
 // ---------------------------------------------------------------------------
 const detailKindComponents: SubsystemComponent[] = [
   {
-    id: 'detail-class',
+    alias: 'detail-class',
     name: 'SessionReader',
     construct: 'class',
     file: 'src/session/SessionReader.ts',
@@ -45,7 +45,7 @@ const detailKindComponents: SubsystemComponent[] = [
     declaration: readerDetail,
   },
   {
-    id: 'detail-method',
+    alias: 'detail-method',
     name: 'normalize',
     construct: 'function',
     file: 'src/session/SessionReader.ts',
@@ -61,7 +61,7 @@ const detailKindComponents: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'detail-fn',
+    alias: 'detail-fn',
     name: 'normalizeSession',
     construct: 'function',
     file: 'src/event-processing/normalize.ts',
@@ -80,7 +80,7 @@ const detailKindComponents: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'detail-fn-rich',
+    alias: 'detail-fn-rich',
     name: 'mergeSessions',
     construct: 'function',
     file: 'src/session/merge.ts',
@@ -104,7 +104,7 @@ const detailKindComponents: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'detail-fn-void',
+    alias: 'detail-fn-void',
     name: 'flush',
     construct: 'function',
     file: 'src/event-processing/sink.ts',
@@ -119,7 +119,7 @@ const detailKindComponents: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'detail-class-rich',
+    alias: 'detail-class-rich',
     name: 'EventProcessor',
     construct: 'class',
     file: 'src/event-processing/EventProcessor.ts',
@@ -149,7 +149,7 @@ const detailKindComponents: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'detail-type',
+    alias: 'detail-type',
     name: 'SessionRecord',
     construct: 'interface',
     file: 'src/session/transcript.ts',
@@ -167,7 +167,7 @@ const detailKindComponents: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'detail-module',
+    alias: 'detail-module',
     name: 'CodexRolloutRecord',
     construct: 'interface',
     file: 'src/session/transcript.ts',
@@ -185,7 +185,7 @@ const detailKindComponents: SubsystemComponent[] = [
     } satisfies GraphifyComponentDetail,
   },
   {
-    id: 'detail-external',
+    alias: 'detail-external',
     // name = the package's name after the namespace; namespace shown above.
     name: 'principal-studio',
     construct: 'external',
@@ -232,7 +232,7 @@ const storyFileContents: Record<string, string> = {
 
 const declarationOpenComponents: SubsystemComponent[] = [
   {
-    id: 'detail',
+    alias: 'detail',
     name: 'ComponentDeclaration',
     construct: 'function',
     file: 'packages/subsystems-react/src/subsystem/ComponentDeclaration.tsx',
@@ -247,7 +247,7 @@ const declarationOpenComponents: SubsystemComponent[] = [
     },
   },
   {
-    id: 'resolver',
+    alias: 'resolver',
     name: 'resolve.ts',
     construct: 'function',
     file: 'packages/subsystems-react/src/graphify/resolve.ts',

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

@@ -61,7 +61,7 @@ function readStoryFile(path: string): Promise<string> {
 
 const drawingComponents: SubsystemComponent[] = [
   {
-    id: 'panel',
+    alias: 'panel',
     name: 'DrawingsLeftPanel',
     construct: 'class',
     file: 'src/panels/DrawingsLeftPanel.tsx',
@@ -71,7 +71,7 @@ const drawingComponents: SubsystemComponent[] = [
     process: 'draw-list',
   },
   {
-    id: 'host',
+    alias: 'host',
     name: 'useDrawingsHost',
     construct: 'function',
     file: 'src/hooks/useDrawingsHost.ts',
@@ -81,7 +81,7 @@ const drawingComponents: SubsystemComponent[] = [
     process: 'draw-list',
   },
   {
-    id: 'storage',
+    alias: 'storage',
     name: 'DrawingsStorage',
     construct: 'class',
     file: 'src/storage/drawingsStorage.ts',
@@ -91,7 +91,7 @@ const drawingComponents: SubsystemComponent[] = [
     process: 'draw-host',
   },
   {
-    id: 'fs',
+    alias: 'fs',
     name: 'FileSystemService',
     construct: 'external',
     file: 'src/services/fileSystem.ts',
@@ -101,7 +101,7 @@ const drawingComponents: SubsystemComponent[] = [
     role: 'service',
   },
   {
-    id: 'shell',
+    alias: 'shell',
     name: 'WorkspaceShell',
     construct: 'class',
     file: 'src/workspace/WorkspaceShell.tsx',
@@ -111,7 +111,7 @@ const drawingComponents: SubsystemComponent[] = [
     process: 'draw-host',
   },
   {
-    id: 'tab',
+    alias: 'tab',
     name: 'DrawingTabContent',
     construct: 'class',
     file: 'src/components/DrawingTabContent.tsx',

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

@@ -30,7 +30,7 @@ const purl = 'pkg:github/principal-ai/principal-view-core-library';
  */
 const reactUiComponents: SubsystemComponent[] = [
   {
-    id: 'create-graph',
+    alias: 'create-graph',
     name: 'createSubsystemModel',
     construct: 'function',
     file: 'packages/subsystems-studio/src/bun/subsystem-model-store.ts',
@@ -41,7 +41,7 @@ const reactUiComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'http-entry',
+    alias: 'http-entry',
     name: 'handleSubsystemModelRequest',
     construct: 'function',
     file: 'packages/subsystems-studio/src/bun/http-server.ts',
@@ -53,7 +53,7 @@ const reactUiComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'sessions-view',
+    alias: 'sessions-view',
     name: 'AgentSessionsOverviewView',
     construct: 'function',
     file: 'packages/subsystems-studio/src/mainview/views/AgentSessions.tsx',
@@ -66,7 +66,7 @@ const reactUiComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'analysis-view',
+    alias: 'analysis-view',
     name: 'AnalysisView',
     construct: 'function',
     file: 'packages/subsystems-studio/src/mainview/views/AnalysisView.tsx',
@@ -79,7 +79,7 @@ const reactUiComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'drawings-host',
+    alias: 'drawings-host',
     name: 'useDrawingsHost',
     construct: 'function',
     file: 'packages/subsystems-studio/src/mainview/hooks/useDrawingsHost.ts',
@@ -92,7 +92,7 @@ const reactUiComponents: SubsystemComponent[] = [
     layer: 2,
   },
   {
-    id: 'graph-doc-type',
+    alias: 'graph-doc-type',
     name: 'SubsystemModelDocument',
     construct: 'type_alias',
     file: 'packages/subsystems-core/src/types/subsystem-model.ts',
@@ -146,7 +146,7 @@ export const ReactComponentsAndHooks: Story = {
 /** Nest-style stereotypes on the same ontology — controller / middleware / guard. */
 const nestComponents: SubsystemComponent[] = [
   {
-    id: 'graphs-controller',
+    alias: 'graphs-controller',
     name: 'SubsystemModelsController',
     construct: 'class',
     file: 'src/graphs/graphs.controller.ts',
@@ -159,7 +159,7 @@ const nestComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'auth-guard',
+    alias: 'auth-guard',
     name: 'AuthGuard',
     construct: 'class',
     file: 'src/auth/auth.guard.ts',
@@ -171,7 +171,7 @@ const nestComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'logging-mw',
+    alias: 'logging-mw',
     name: 'LoggingMiddleware',
     construct: 'function',
     file: 'src/logging/logging.middleware.ts',
@@ -183,7 +183,7 @@ const nestComponents: SubsystemComponent[] = [
     layer: 1,
   },
   {
-    id: 'graphs-service',
+    alias: 'graphs-service',
     name: 'GraphsService',
     construct: 'class',
     file: 'src/graphs/graphs.service.ts',