@principal-ai/subsystems-react 0.20.6 → 0.21.1

package/dist/stories/Subsystem/ComponentGraph/fixtures.js

@@ -1,8 +1,9 @@
+import { derivedGraphEdgeId } from '../../../subsystem/model';
 // ---------------------------------------------------------------------------
 // Build a subsystem graph from a compact spec - helpers
 // ---------------------------------------------------------------------------
 export function components(spec) {
-    return spec.map(([id, name, construct, file, purl, purpose, symbol, detail]) => ({
+    return spec.map(([id, name, construct, file, purl, purpose, symbol, declaration]) => ({
         id,
         name,
         construct,
@@ -10,9 +11,46 @@ export function components(spec) {
         purl,
         purpose,
         symbol,
-        detail,
+        declaration,
     }));
 }
+const RELATION_TYPES = new Set([
+    'imports',
+    'imports_from',
+    're_exports',
+    'defines',
+    'extends',
+    'inherits',
+    'implements',
+    'mixes_in',
+    'method',
+    'references',
+    'contains',
+]);
+export function relations(spec) {
+    return spec.map(([from, to, relationType, refs], i) => ({
+        id: `r${i}`,
+        from,
+        to,
+        relationType,
+        refs,
+    }));
+}
+/** Story helper: one walkthrough whose hops derive Set B display edges. */
+export function walkthroughFromHops(id, title, hops) {
+    return {
+        id,
+        title,
+        steps: hops.map(([from, to, mechanism, file, line]) => ({
+            from,
+            to,
+            mechanism,
+            file,
+            line,
+        })),
+    };
+}
+/** @deprecated story helper — prefer `relations` + `walkthroughFromHops`. */
 export function edges(spec) {
     return spec.map(([from, to, mechanism, refs], i) => ({
         id: `e${i}`,
@@ -22,6 +60,37 @@ export function edges(spec) {
         refs,
     }));
 }
+/** Split mixed mechanism lists into relations + optional walkthrough for stories. */
+export function graphSpecFromEdges(spec) {
+    const rels = [];
+    const hops = [];
+    for (const [from, to, mechanism, refs] of spec) {
+        if (RELATION_TYPES.has(mechanism)) {
+            rels.push({
+                id: derivedGraphEdgeId(from, to, mechanism),
+                from,
+                to,
+                relationType: mechanism,
+                refs,
+            });
+        }
+        else {
+            hops.push({
+                from,
+                to,
+                mechanism: mechanism,
+                file: 'story-placeholder.ts',
+                line: 1,
+            });
+        }
+    }
+    return {
+        relations: rels,
+        walkthroughs: hops.length > 0
+            ? [{ id: 'story-hops', title: 'Story hops', steps: hops }]
+            : undefined,
+    };
+}
 export const readerDetail = {
     kind: 'class',
     methods: [
@@ -66,39 +135,28 @@ export const investigateOnlyComponents = [
         purl: 'pkg:github/principal-ai/agent-monitoring',
         purpose: 'the subsystem\u2019s input type — a repo-normalized universal event the readers produce and the accumulator consumes',
         symbol: 'RepoNormalizedUniversalAgentSessionEvent',
-        detail: {
-            kind: 'type',
-            properties: [
-                { name: 'eventType', type: 'NormalizedEventType' },
-                { name: 'sessionId', type: 'string' },
-                { name: 'timestamp', type: 'number' },
-            ],
-            usedBy: [{ nodeId: 'acc', name: 'accumulateToAgentSessionEvents', context: 'parameter_type' }],
-            implementors: [],
-        },
     },
     {
         id: 'acc',
         name: 'accumulateToAgentSessionEvents',
         construct: 'function',
-        file: 'src/event-processing/accumulator.ts',
+        file: 'src/accumulateToAgentSessionEvents.ts',
         purl: 'pkg:github/principal-ai/agent-monitoring',
-        purpose: 'accumulates normalized events into agent session events',
+        purpose: 'folds normalized events into agent session events',
         symbol: 'accumulateToAgentSessionEvents',
     },
     {
         id: 'out',
         name: 'AgentSessionEvent',
         construct: 'interface',
-        file: 'src/event-processing/accumulator.ts',
+        file: 'types/AgentSessionEvent.ts',
         purl: 'pkg:github/principal-ai/agent-monitoring',
-        purpose: 'the subsystem\u2019s output type — an accumulated agent-session event',
+        purpose: 'output event shape',
         symbol: 'AgentSessionEvent',
-        detail: {
+        declaration: {
             kind: 'type',
             properties: [
-                { name: 'sessionName', type: 'string' },
-                { name: 'operation', type: 'AgentSessionEventOperation' },
+                { name: 'sessionId', type: 'string' },
                 { name: 'description', type: 'string' },
             ],
             usedBy: [{ nodeId: 'acc', name: 'accumulateToAgentSessionEvents', context: 'return_type' }],
@@ -106,8 +164,16 @@ export const investigateOnlyComponents = [
         },
     },
 ];
+const investigateSpec = graphSpecFromEdges([
+    ['v1', 'input', 'produces'],
+    ['v2', 'input', 'produces'],
+    ['input', 'acc', 'feeds'],
+    ['acc', 'out', 'produces'],
+]);
+export const investigateOnlyRelations = investigateSpec.relations;
+export const investigateOnlyWalkthroughs = investigateSpec.walkthroughs;
+/** @deprecated use investigateOnlyRelations + investigateOnlyWalkthroughs */
 export const investigateOnlyEdges = edges([
-    // Concept-level data flow — the LLM's semantic intent.
     ['v1', 'input', 'produces'],
     ['v2', 'input', 'produces'],
     ['input', 'acc', 'feeds'],

package/dist/stories/Subsystem/ComponentGraph/fixtures.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../../src/stories/Subsystem/ComponentGraph/fixtures.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../../src/stories/Subsystem/ComponentGraph/fixtures.ts"],"names":[],"mappings":"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"}

package/dist/subsystem/FileDrawer.d.ts

@@ -1,7 +1,7 @@
 /**
  * FileDrawer — bottom panel that slides up from the bottom of the graph area
- * to show file / throughline code. Opened by sidebar file-tree clicks,
- * declaration links, and throughline step focus; content is injected as
+ * to show file / walkthrough code. Opened by sidebar file-tree clicks,
+ * declaration links, and walkthrough step focus; content is injected as
  * children by the graph component.
  */
 import type { ReactNode } from 'react';

package/dist/subsystem/FileDrawer.js

@@ -1,8 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * FileDrawer — bottom panel that slides up from the bottom of the graph area
- * to show file / throughline code. Opened by sidebar file-tree clicks,
- * declaration links, and throughline step focus; content is injected as
+ * to show file / walkthrough code. Opened by sidebar file-tree clicks,
+ * declaration links, and walkthrough step focus; content is injected as
  * children by the graph component.
  */
 import { useEffect } from 'react';

package/dist/subsystem/SubsystemComponentGraph.d.ts

@@ -12,28 +12,29 @@
  * injection, onNodeClick) adapted to the subsystem model — read-only.
  */
 import type { ReactNode } from 'react';
-import { type SubsystemComponentEdge, type SubsystemComponent, type SubsystemThroughline } from './model';
+import { type SubsystemComponentEdge, type SubsystemComponent, type SubsystemRelation, type SubsystemWalkthrough } from './model';
 import type { SubsystemOpenFileOptions } from './declarationRef';
 import type { ComponentVerificationState } from './ComponentDeclaration';
-/** Context passed to `renderThroughlineViewer` when a flow/step is focused. */
-export interface ThroughlineViewerContext {
-    throughline: SubsystemThroughline;
+/** Context passed to `renderWalkthroughViewer` when a flow/step is focused. */
+export interface WalkthroughViewerContext {
+    walkthrough: SubsystemWalkthrough;
     /** Focused step index; `null` means the whole flow (no specific step). */
     stepIndex: number | null;
 }
 export interface SubsystemComponentGraphProps {
     components: SubsystemComponent[];
-    edges: SubsystemComponentEdge[];
+    /** Topology relations (structural / module / type). Display edges are derived with walkthrough hops. */
+    relations: SubsystemRelation[];
     /**
-     * Ordered execution stories over the graph's edges — one throughline per
-     * flow. When present the sidebar's bottom half offers a Files/Flows toggle:
-     * the flows panel lists each throughline's steps (`symbol` or `file:line`);
+     * Ordered runtime walkthroughs — one walkthrough per flow. When present the
+     * sidebar's bottom half offers a Files/Walkthroughs toggle:
+     * the flows panel lists each walkthrough's steps (`symbol` or `file:line`);
      * clicking a flow row toggles its steps; clicking a step focuses that
-     * step's edge and (when `renderThroughlineViewer` is set) opens the bottom
+     * step's edge and (when `renderWalkthroughViewer` is set) opens the bottom
      * drawer on that flow's snippets. Opened flows stay on the canvas
      * (unselected ones dimmed); everything else is hidden.
      */
-    throughlines?: SubsystemThroughline[];
+    walkthroughs?: SubsystemWalkthrough[];
     onSelect?: (componentId: string) => void;
     /** Called when an edge is clicked (relationship / mechanism + refs seam). */
     onEdgeSelect?: (edge: SubsystemComponentEdge) => void;
@@ -46,29 +47,29 @@ export interface SubsystemComponentGraphProps {
     title?: string;
     /**
      * Suppresses the sidebar entirely (title, description, file tree,
-     * throughlines) for graph-only embeds. Pair with `graphTitle` to keep the
+     * walkthroughs) for graph-only embeds. Pair with `graphTitle` to keep the
      * subsystem name visible as an overlay on the canvas.
      */
     hideSidebar?: boolean;
     /**
-     * How throughline step highlighting behaves on the canvas.
+     * How walkthrough step highlighting behaves on the canvas.
      * - `focus` (default): zoom to the step, hide non-participants, open drawer
      * - `dim`: keep the full graph, dim non-participants (same as hovering a step)
      */
-    throughlineStepMode?: 'focus' | 'dim';
+    walkthroughStepMode?: 'focus' | 'dim';
     /**
-     * When true, cycles throughline steps automatically using `dim` highlighting
-     * (no zoom, no drawer). Loops across all throughlines that have steps.
+     * When true, cycles walkthrough steps automatically using `dim` highlighting
+     * (no zoom, no drawer). Loops across all walkthroughs that have steps.
      * Useful for graph-only embeds (`hideSidebar`).
      */
-    autoPlayThroughlines?: boolean;
+    autoPlayWalkthroughs?: boolean;
     /** Pause between autoplay steps in ms. @default 2500 */
-    throughlineAutoPlayIntervalMs?: number;
+    walkthroughAutoPlayIntervalMs?: number;
     /**
-     * When false, focusing a throughline/step does not call `fitView`.
+     * When false, focusing a walkthrough/step does not call `fitView`.
      * @default true
      */
-    zoomOnThroughlineFocus?: boolean;
+    zoomOnWalkthroughFocus?: boolean;
     /**
      * Subsystem title rendered as a non-interactive overlay chip on the graph
      * canvas (top-center). Does not trigger the sidebar — for graph-only
@@ -76,11 +77,11 @@ export interface SubsystemComponentGraphProps {
      */
     graphTitle?: string;
     /**
-     * When true, shows the active throughline's title as a non-interactive
+     * When true, shows the active walkthrough's title as a non-interactive
      * overlay chip on the canvas (under `graphTitle` when both are set).
-     * Uses the focused or hover-highlighted throughline.
+     * Uses the focused or hover-highlighted walkthrough.
      */
-    showThroughlineTitle?: boolean;
+    showWalkthroughTitle?: boolean;
     /** Markdown description rendered in the sidebar. */
     description?: string;
     /** Rendered over the graph canvas only (not the title/legend sidebar). */
@@ -96,11 +97,11 @@ export interface SubsystemComponentGraphProps {
      */
     renderFileViewer?: (file: string, opts?: SubsystemOpenFileOptions) => ReactNode;
     /**
-     * Host-injected multi-snippet viewer for a focused throughline. When set,
+     * Host-injected multi-snippet viewer for a focused walkthrough. When set,
      * clicking a flow step opens the bottom drawer with this content and
      * updates it as the focused step changes.
      */
-    renderThroughlineViewer?: (ctx: ThroughlineViewerContext) => ReactNode;
+    renderWalkthroughViewer?: (ctx: WalkthroughViewerContext) => ReactNode;
     /**
      * Legacy component-keyed variant, kept for backward compatibility. When
      * `renderFileViewer` is absent, drawer content resolves via the first

package/dist/subsystem/SubsystemComponentGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubsystemComponentGraph.d.ts","sourceRoot":"","sources":["../../src/subsystem/SubsystemComponentGraph.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAiC,SAAS,EAAE,MAAM,OAAO,CAAC;AAqBtE,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EAEvB,KAAK,oBAAoB,EAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAKjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAYzE,+EAA+E;AAC/E,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,oBAAoB,CAAC;IAClC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAMD,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACtD;kFAC8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACtC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wDAAwD;IACxD,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,gFAAgF;IAChF,uBAAuB,CAAC,EAAE,SAAS,CAAC;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,KAAK,SAAS,CAAC;IAChF;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,SAAS,CAAC;IACvE;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,kBAAkB,KAAK,SAAS,CAAC;IAC9D;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,2DAA2D;IAC3D,qBAAqB,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC3D;AAy/DD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,+BAsC1E"}
+{"version":3,"file":"SubsystemComponentGraph.d.ts","sourceRoot":"","sources":["../../src/subsystem/SubsystemComponentGraph.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAiC,SAAS,EAAE,MAAM,OAAO,CAAC;AAqBtE,OAAO,EAOL,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAKjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAYzE,+EAA+E;AAC/E,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,oBAAoB,CAAC;IAClC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAMD,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,wGAAwG;IACxG,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACtD;kFAC8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACtC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wDAAwD;IACxD,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,gFAAgF;IAChF,uBAAuB,CAAC,EAAE,SAAS,CAAC;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,KAAK,SAAS,CAAC;IAChF;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,SAAS,CAAC;IACvE;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,kBAAkB,KAAK,SAAS,CAAC;IAC9D;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,2DAA2D;IAC3D,qBAAqB,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC3D;AA8/DD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,+BAsC1E"}