@principal-ai/subsystems-react 0.24.0 → 0.24.2

package/dist/subsystem/DiagnosticToggle.d.ts

@@ -0,0 +1,46 @@
+/**
+ * DiagnosticToggle — the subsystem graph's status/report chip.
+ *
+ * A compact button that lives in the sidebar title row (beside the description
+ * toggle). It carries the *status* of the graph's last verification pass in its
+ * icon color + count and, on click, opens the full report (the host owns that
+ * report; this component only surfaces state and calls `onOpen`).
+ *
+ * Status → color (theme):
+ * - `ok`      → success (green)
+ * - `issues`  → error   (red)
+ * - `gaps`    → warning (amber) — nothing failed, but some claims are unconfirmed
+ * - `unknown` → muted   (never checked)
+ *
+ * `stale` means the inputs changed since the report was produced — the color
+ * stays, a hollow ring marks it. `busy` swaps the icon for a spinner.
+ */
+/// <reference types="react" />
+export type SubsystemDiagnosticStatus = 'ok' | 'issues' | 'gaps' | 'unknown';
+export interface SubsystemDiagnostic {
+    status: SubsystemDiagnosticStatus;
+    /** Count shown beside the icon (e.g. error + warn findings). Hidden when 0/undefined. */
+    issueCount?: number;
+    /** Inputs changed since the report was produced. */
+    stale?: boolean;
+    /** A verification pass is running right now. */
+    busy?: boolean;
+    /** Tooltip / a11y label override; otherwise derived from `status`. */
+    title?: string;
+    /** Click — open the report. */
+    onOpen?: () => void;
+}
+/** Resolve the status accent from the active theme. */
+export declare function diagnosticStatusColor(status: SubsystemDiagnosticStatus, colors: {
+    success: string;
+    error: string;
+    warning: string;
+}, muted: string): string;
+/** Human tooltip for the current diagnostic state. */
+export declare function diagnosticTitle(diagnostic: SubsystemDiagnostic): string;
+export interface SubsystemDiagnosticToggleProps extends SubsystemDiagnostic {
+    /** Icon size in px. @default 14 */
+    size?: number;
+}
+export declare function SubsystemDiagnosticToggle({ status, issueCount, stale, busy, size, onOpen, ...rest }: SubsystemDiagnosticToggleProps): import("react").JSX.Element;
+//# sourceMappingURL=DiagnosticToggle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticToggle.d.ts","sourceRoot":"","sources":["../../src/subsystem/DiagnosticToggle.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;;AAMH,MAAM,MAAM,yBAAyB,GAAG,IAAI,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,yBAAyB,CAAC;IAClC,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,yBAAyB,EACjC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC3D,KAAK,EAAE,MAAM,GACZ,MAAM,CAKR;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAmBvE;AAED,MAAM,WAAW,8BAA+B,SAAQ,mBAAmB;IACzE,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,yBAAyB,CAAC,EACxC,MAAM,EACN,UAAU,EACV,KAAa,EACb,IAAY,EACZ,IAAS,EACT,MAAM,EACN,GAAG,IAAI,EACR,EAAE,8BAA8B,+BA0EhC"}

package/dist/subsystem/DiagnosticToggle.js

@@ -0,0 +1,95 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * DiagnosticToggle — the subsystem graph's status/report chip.
+ *
+ * A compact button that lives in the sidebar title row (beside the description
+ * toggle). It carries the *status* of the graph's last verification pass in its
+ * icon color + count and, on click, opens the full report (the host owns that
+ * report; this component only surfaces state and calls `onOpen`).
+ *
+ * Status → color (theme):
+ * - `ok`      → success (green)
+ * - `issues`  → error   (red)
+ * - `gaps`    → warning (amber) — nothing failed, but some claims are unconfirmed
+ * - `unknown` → muted   (never checked)
+ *
+ * `stale` means the inputs changed since the report was produced — the color
+ * stays, a hollow ring marks it. `busy` swaps the icon for a spinner.
+ */
+import { useState } from 'react';
+import { Activity, Loader2 } from 'lucide-react';
+import { useTheme } from '@principal-ade/industry-theme';
+/** Resolve the status accent from the active theme. */
+export function diagnosticStatusColor(status, colors, muted) {
+    if (status === 'ok')
+        return colors.success;
+    if (status === 'issues')
+        return colors.error;
+    if (status === 'gaps')
+        return colors.warning;
+    return muted;
+}
+/** Human tooltip for the current diagnostic state. */
+export function diagnosticTitle(diagnostic) {
+    if (diagnostic.title)
+        return diagnostic.title;
+    const { status, issueCount, stale, busy } = diagnostic;
+    let head;
+    if (status === 'ok')
+        head = 'Diagnostics: no issues';
+    else if (status === 'issues')
+        head =
+            issueCount != null && issueCount > 0
+                ? `Diagnostics: ${issueCount} issue${issueCount === 1 ? '' : 's'}`
+                : 'Diagnostics: issues found';
+    else if (status === 'gaps')
+        head =
+            issueCount != null && issueCount > 0
+                ? `Diagnostics: ${issueCount} unconfirmed`
+                : 'Diagnostics: unconfirmed claims';
+    else
+        head = 'Diagnostics: not checked yet';
+    if (busy)
+        return `${head} — checking…`;
+    if (stale)
+        return `${head} (stale) — open for details`;
+    return `${head} — open report`;
+}
+export function SubsystemDiagnosticToggle({ status, issueCount, stale = false, busy = false, size = 14, onOpen, ...rest }) {
+    const { theme } = useTheme();
+    const [hover, setHover] = useState(false);
+    const muted = theme.colors.textMuted ?? theme.colors.textSecondary;
+    const color = diagnosticStatusColor(status, theme.colors, muted);
+    const label = diagnosticTitle({ status, issueCount, stale, busy, ...rest });
+    const showCount = issueCount != null && issueCount > 0;
+    return (_jsxs(_Fragment, { children: [busy && (_jsx("style", { children: '@keyframes subsystem-diagnostic-spin{to{transform:rotate(360deg)}}' })), _jsxs("button", { type: "button", onClick: onOpen, onMouseEnter: () => setHover(true), onMouseLeave: () => setHover(false), title: label, "aria-label": label, "aria-haspopup": "dialog", style: {
+                    display: 'inline-flex',
+                    alignItems: 'center',
+                    gap: 4,
+                    height: 22,
+                    padding: showCount ? '0 7px 0 6px' : '0 5px',
+                    border: 'none',
+                    borderRadius: 4,
+                    background: hover ? theme.colors.border : 'transparent',
+                    color,
+                    cursor: 'pointer',
+                    flexShrink: 0,
+                    transition: 'background 120ms ease, opacity 120ms ease',
+                    opacity: stale && !busy ? 0.55 : 1,
+                }, children: [_jsxs("span", { style: { position: 'relative', display: 'inline-flex' }, children: [busy ? (_jsx(Loader2, { size: size, style: { animation: 'subsystem-diagnostic-spin 900ms linear infinite' } })) : (_jsx(Activity, { size: size })), stale && !busy && (_jsx("span", { "aria-hidden": true, style: {
+                                    position: 'absolute',
+                                    top: -2,
+                                    right: -2,
+                                    width: 6,
+                                    height: 6,
+                                    borderRadius: '50%',
+                                    border: `1.5px solid ${color}`,
+                                    background: theme.colors.backgroundSecondary ?? theme.colors.background,
+                                } }))] }), showCount && (_jsx("span", { style: {
+                            fontFamily: theme.fonts.monospace,
+                            fontSize: theme.fontSizes[0],
+                            fontWeight: 600,
+                            lineHeight: 1,
+                        }, children: issueCount }))] })] }));
+}
+//# sourceMappingURL=DiagnosticToggle.js.map

package/dist/subsystem/DiagnosticToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticToggle.js","sourceRoot":"","sources":["../../src/subsystem/DiagnosticToggle.tsx"],"names":[],"mappings":"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"}

package/dist/subsystem/IssueList.d.ts

@@ -0,0 +1,103 @@
+/**
+ * SubsystemIssueList — the diagnostics sidebar list.
+ *
+ * A catalogue of verification issues (audit findings), grouped by *target* so
+ * every broken component / relation / module / flow clusters together. Each
+ * card is severity-colored, names its kind, states the message, and offers the
+ * deterministic fix inline when one exists.
+ *
+ * The list is presentation-only: it owns no verification logic. Hosts map their
+ * findings into `SubsystemIssue[]` and handle `onSelectIssue` / `onApplyFix`
+ * (e.g. focus the node on the graph, or apply the fix in the report).
+ */
+/// <reference types="react" />
+export type SubsystemIssueSeverity = 'error' | 'warn' | 'info';
+export type SubsystemIssueTargetKind = 'component' | 'relation' | 'module' | 'walkthrough' | 'graph';
+/**
+ * The four verification layers, in order. Mirrors the docs' progression:
+ * constructs → static topology → runtime topology → walkthrough.
+ */
+export type SubsystemIssueCategory = 'construct' | 'static-topology' | 'runtime-topology' | 'walkthrough';
+/** Layer order + display names, shared by the list and its headers. */
+export declare const SUBSYSTEM_ISSUE_CATEGORIES: SubsystemIssueCategory[];
+export declare const SUBSYSTEM_ISSUE_CATEGORY_LABEL: Record<SubsystemIssueCategory, string>;
+/**
+ * Verification layer for an issue. An explicit `category` wins; otherwise the
+ * audit `kind` is mapped, defaulting to `construct` (the base layer).
+ */
+export declare function issueCategory(issue: SubsystemIssue): SubsystemIssueCategory;
+export interface SubsystemIssueTarget {
+    kind: SubsystemIssueTargetKind;
+    /** Stable id used to group and to focus the target on the graph. */
+    id?: string;
+    /** Display label (component name, `from → to`, module path, flow title). */
+    label: string;
+    /** Optional sub-label (relation type, step number, …). */
+    detail?: string;
+}
+/** One issue to surface in the sidebar (and later, on the graph). */
+export interface SubsystemIssue {
+    id: string;
+    severity: SubsystemIssueSeverity;
+    /** Machine kind, e.g. `missing_file`. Drives the label when `kindLabel` is absent. */
+    kind: string;
+    /** Human label override for the kind. */
+    kindLabel?: string;
+    message: string;
+    target?: SubsystemIssueTarget;
+    /** Verification layer override; defaults from `kind`. */
+    category?: SubsystemIssueCategory;
+    /** Deterministic fix the user can apply without an agent. */
+    fix?: {
+        label: string;
+    };
+}
+/** `missing_file` → `Missing file`. */
+export declare function humanizeIssueKind(kind: string): string;
+/** Label for an issue's kind. Explicit `kindLabel` wins; unknown kinds humanize. */
+export declare function issueKindLabel(issue: SubsystemIssue): string;
+export declare function severityRank(severity: SubsystemIssueSeverity): number;
+/** Worst (most severe) severity in a list; `info` for an empty list. */
+export declare function worstSeverity(issues: SubsystemIssue[]): SubsystemIssueSeverity;
+export interface SubsystemIssueGroup {
+    key: string;
+    kind: SubsystemIssueTargetKind;
+    label: string;
+    detail?: string;
+    issues: SubsystemIssue[];
+    severity: SubsystemIssueSeverity;
+}
+/**
+ * Group issues by their target, worst-severity first, then by label. Within a
+ * group, issues are ordered error → warn → info (stable for ties).
+ */
+export declare function groupIssuesByTarget(issues: SubsystemIssue[]): SubsystemIssueGroup[];
+export interface SubsystemIssueCategoryGroup {
+    category: SubsystemIssueCategory;
+    label: string;
+    issues: SubsystemIssue[];
+    /** Worst severity present; `null` when the layer is clean. */
+    severity: SubsystemIssueSeverity | null;
+    count: number;
+}
+/**
+ * Group issues into the four verification layers — always all four, in order,
+ * so a clean layer can render its "happy" state. Issues within a layer are
+ * ordered error → warn → info (stable for ties).
+ */
+export declare function groupIssuesByCategory(issues: SubsystemIssue[]): SubsystemIssueCategoryGroup[];
+export interface SubsystemIssueCardProps {
+    issue: SubsystemIssue;
+    onSelect?: (issue: SubsystemIssue) => void;
+    onApplyFix?: (issue: SubsystemIssue) => void;
+    onHover?: (issue: SubsystemIssue | null) => void;
+}
+export declare function SubsystemIssueCard({ issue, onSelect, onApplyFix, onHover, }: SubsystemIssueCardProps): import("react").JSX.Element;
+export interface SubsystemIssueListProps {
+    issues: SubsystemIssue[];
+    onSelectIssue?: (issue: SubsystemIssue) => void;
+    onApplyFix?: (issue: SubsystemIssue) => void;
+    onHoverIssue?: (issue: SubsystemIssue | null) => void;
+}
+export declare function SubsystemIssueList({ issues, onSelectIssue, onApplyFix, onHoverIssue, }: SubsystemIssueListProps): import("react").JSX.Element;
+//# sourceMappingURL=IssueList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IssueList.d.ts","sourceRoot":"","sources":["../../src/subsystem/IssueList.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;;AAWH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/D,MAAM,MAAM,wBAAwB,GAChC,WAAW,GACX,UAAU,GACV,QAAQ,GACR,aAAa,GACb,OAAO,CAAC;AAEZ;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,iBAAiB,GACjB,kBAAkB,GAClB,aAAa,CAAC;AAElB,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,EAAE,sBAAsB,EAK9D,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,MAAM,CACjD,sBAAsB,EACtB,MAAM,CAMP,CAAC;AAsBF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,sBAAsB,CAE3E;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,oEAAoE;IACpE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,sBAAsB,CAAC;IACjC,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,6DAA6D;IAC7D,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzB;AAQD,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AA2BD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE5D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAErE;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EAAE,GACvB,sBAAsB,CAMxB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAQD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EAAE,GACvB,mBAAmB,EAAE,CA+BvB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EAAE,GACvB,2BAA2B,EAAE,CAiB/B;AAoBD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;CAClD;AAED,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,UAAU,EACV,OAAO,GACR,EAAE,uBAAuB,+BA4IzB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;CACvD;AAED,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,aAAa,EACb,UAAU,EACV,YAAY,GACb,EAAE,uBAAuB,+BA2EzB"}

package/dist/subsystem/IssueList.js

@@ -0,0 +1,310 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * SubsystemIssueList — the diagnostics sidebar list.
+ *
+ * A catalogue of verification issues (audit findings), grouped by *target* so
+ * every broken component / relation / module / flow clusters together. Each
+ * card is severity-colored, names its kind, states the message, and offers the
+ * deterministic fix inline when one exists.
+ *
+ * The list is presentation-only: it owns no verification logic. Hosts map their
+ * findings into `SubsystemIssue[]` and handle `onSelectIssue` / `onApplyFix`
+ * (e.g. focus the node on the graph, or apply the fix in the report).
+ */
+import { useState } from 'react';
+import { ChevronDown, ChevronRight, CircleCheck, Wrench, } from 'lucide-react';
+import { useTheme } from '@principal-ade/industry-theme';
+/** Layer order + display names, shared by the list and its headers. */
+export const SUBSYSTEM_ISSUE_CATEGORIES = [
+    'construct',
+    'static-topology',
+    'runtime-topology',
+    'walkthrough',
+];
+export const SUBSYSTEM_ISSUE_CATEGORY_LABEL = {
+    construct: 'Constructs',
+    'static-topology': 'Static topology',
+    'runtime-topology': 'Runtime topology',
+    walkthrough: 'Walkthrough',
+};
+/** Default `kind` → layer. `boundary_*` splits by module (static) vs process (runtime). */
+const KIND_CATEGORY = {
+    missing_file: 'construct',
+    missing_symbol: 'construct',
+    stale_declaration: 'construct',
+    construct_mismatch: 'construct',
+    construct_unconfirmed: 'construct',
+    signature_mismatch: 'construct',
+    signature_unconfirmed: 'construct',
+    anchor: 'construct',
+    unresolved: 'construct',
+    topology_broken_endpoint: 'static-topology',
+    topology_import_unconfirmed: 'static-topology',
+    topology_relation_unconfirmed: 'static-topology',
+    boundary_module_without_file: 'static-topology',
+    boundary_module_file_mismatch: 'static-topology',
+    boundary_process_nest_disagree: 'runtime-topology',
+    walkthrough: 'walkthrough',
+};
+/**
+ * Verification layer for an issue. An explicit `category` wins; otherwise the
+ * audit `kind` is mapped, defaulting to `construct` (the base layer).
+ */
+export function issueCategory(issue) {
+    return issue.category ?? KIND_CATEGORY[issue.kind] ?? 'construct';
+}
+const SEVERITY_RANK = {
+    error: 0,
+    warn: 1,
+    info: 2,
+};
+/** `missing_file` → `Missing file`. */
+export function humanizeIssueKind(kind) {
+    const spaced = kind.replace(/[_-]+/g, ' ').trim();
+    return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+/**
+ * Curated short labels, trimmed of prefixes the grouping already implies
+ * (`topology_`, `boundary_`) but kept unambiguous within a layer — so
+ * `construct_mismatch` reads "Wrong construct", not a bare "Mismatch" that
+ * would collide with `signature_mismatch`. Explicit `issue.kindLabel` wins.
+ */
+const KIND_LABEL = {
+    missing_file: 'Missing file',
+    missing_symbol: 'Missing symbol',
+    stale_declaration: 'Stale declaration',
+    construct_mismatch: 'Wrong construct',
+    construct_unconfirmed: 'Unconfirmed construct',
+    signature_mismatch: 'Signature mismatch',
+    signature_unconfirmed: 'Signature unconfirmed',
+    anchor: 'Anchor',
+    unresolved: 'Unresolved',
+    topology_broken_endpoint: 'Broken endpoint',
+    topology_import_unconfirmed: 'Import unconfirmed',
+    topology_relation_unconfirmed: 'Relation unconfirmed',
+    boundary_module_without_file: 'Module without file',
+    boundary_module_file_mismatch: 'Module file mismatch',
+    boundary_process_nest_disagree: 'Process nest disagree',
+    walkthrough: 'Step issue',
+};
+/** Label for an issue's kind. Explicit `kindLabel` wins; unknown kinds humanize. */
+export function issueKindLabel(issue) {
+    return issue.kindLabel ?? KIND_LABEL[issue.kind] ?? humanizeIssueKind(issue.kind);
+}
+export function severityRank(severity) {
+    return SEVERITY_RANK[severity] ?? SEVERITY_RANK.info;
+}
+/** Worst (most severe) severity in a list; `info` for an empty list. */
+export function worstSeverity(issues) {
+    let worst = 'info';
+    for (const issue of issues) {
+        if (severityRank(issue.severity) < severityRank(worst))
+            worst = issue.severity;
+    }
+    return worst;
+}
+function targetKey(issue) {
+    const t = issue.target;
+    if (!t)
+        return 'graph';
+    return `${t.kind}:${t.id ?? t.label}`;
+}
+/**
+ * Group issues by their target, worst-severity first, then by label. Within a
+ * group, issues are ordered error → warn → info (stable for ties).
+ */
+export function groupIssuesByTarget(issues) {
+    const byKey = new Map();
+    for (const issue of issues) {
+        const key = targetKey(issue);
+        let group = byKey.get(key);
+        if (!group) {
+            group = {
+                key,
+                kind: issue.target?.kind ?? 'graph',
+                label: issue.target?.label ?? 'Model',
+                detail: issue.target?.detail,
+                issues: [],
+                severity: 'info',
+            };
+            byKey.set(key, group);
+        }
+        group.issues.push(issue);
+    }
+    const groups = [...byKey.values()];
+    for (const group of groups) {
+        group.issues.sort((a, b) => severityRank(a.severity) - severityRank(b.severity));
+        group.severity = worstSeverity(group.issues);
+    }
+    groups.sort((a, b) => {
+        const bySeverity = severityRank(a.severity) - severityRank(b.severity);
+        if (bySeverity !== 0)
+            return bySeverity;
+        return a.label.localeCompare(b.label);
+    });
+    return groups;
+}
+/**
+ * Group issues into the four verification layers — always all four, in order,
+ * so a clean layer can render its "happy" state. Issues within a layer are
+ * ordered error → warn → info (stable for ties).
+ */
+export function groupIssuesByCategory(issues) {
+    const byCategory = new Map();
+    for (const category of SUBSYSTEM_ISSUE_CATEGORIES)
+        byCategory.set(category, []);
+    for (const issue of issues) {
+        byCategory.get(issueCategory(issue))?.push(issue);
+    }
+    return SUBSYSTEM_ISSUE_CATEGORIES.map((category) => {
+        const grouped = byCategory.get(category) ?? [];
+        grouped.sort((a, b) => severityRank(a.severity) - severityRank(b.severity));
+        return {
+            category,
+            label: SUBSYSTEM_ISSUE_CATEGORY_LABEL[category],
+            issues: grouped,
+            severity: grouped.length > 0 ? worstSeverity(grouped) : null,
+            count: grouped.length,
+        };
+    });
+}
+function severityColor(severity, colors, muted) {
+    if (severity === 'error')
+        return colors.error ?? '#e5534b';
+    if (severity === 'warn')
+        return colors.warning ?? '#d4a017';
+    return colors.info ?? muted;
+}
+const TARGET_KIND_LABEL = {
+    component: 'component',
+    relation: 'relation',
+    module: 'module',
+    walkthrough: 'flow',
+    graph: 'model',
+};
+export function SubsystemIssueCard({ issue, onSelect, onApplyFix, onHover, }) {
+    const { theme } = useTheme();
+    const [hover, setHover] = useState(false);
+    // Every issue is collapsed to its kind by default so the list scans as a
+    // catalogue of problems; clicking a card reveals the message and any fix.
+    const [expanded, setExpanded] = useState(false);
+    const showDetail = expanded;
+    const muted = theme.colors.textMuted ?? theme.colors.textSecondary;
+    const color = severityColor(issue.severity, theme.colors, muted);
+    const activate = () => {
+        setExpanded((v) => !v);
+        onSelect?.(issue);
+    };
+    return (_jsxs("div", { role: "button", tabIndex: 0, "aria-expanded": expanded, onClick: activate, onKeyDown: (e) => {
+            if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault();
+                activate();
+            }
+        }, onMouseEnter: () => {
+            setHover(true);
+            onHover?.(issue);
+        }, onMouseLeave: () => {
+            setHover(false);
+            onHover?.(null);
+        }, style: {
+            display: 'flex',
+            flexDirection: 'column',
+            gap: 5,
+            padding: '9px 12px 10px',
+            borderBottom: `1px solid ${theme.colors.border}`,
+            background: hover ? theme.colors.background : 'transparent',
+            cursor: 'pointer',
+            transition: 'background 120ms ease',
+            fontFamily: theme.fonts.body,
+        }, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'flex-start', gap: 6, minWidth: 0 }, children: [_jsxs("div", { style: {
+                            flex: 1,
+                            minWidth: 0,
+                            display: 'flex',
+                            flexDirection: 'column',
+                            gap: 1,
+                        }, children: [_jsx("span", { style: {
+                                    fontFamily: theme.fonts.monospace,
+                                    fontSize: theme.fontSizes[0],
+                                    fontWeight: 600,
+                                    letterSpacing: 0.3,
+                                    textTransform: 'uppercase',
+                                    color,
+                                    whiteSpace: 'nowrap',
+                                }, children: issueKindLabel(issue) }), issue.target && (_jsx("span", { style: {
+                                    minWidth: 0,
+                                    fontFamily: theme.fonts.monospace,
+                                    fontSize: theme.fontSizes[0],
+                                    color: theme.colors.text,
+                                    whiteSpace: 'nowrap',
+                                    overflow: 'hidden',
+                                    textOverflow: 'ellipsis',
+                                }, title: `${TARGET_KIND_LABEL[issue.target.kind]} · ${issue.target.label}`, children: issue.target.label }))] }), _jsx("span", { style: {
+                            display: 'inline-flex',
+                            color: muted,
+                            flexShrink: 0,
+                            marginTop: 1,
+                        }, children: expanded ? _jsx(ChevronDown, { size: 13 }) : _jsx(ChevronRight, { size: 13 }) })] }), showDetail && (_jsx("div", { style: {
+                    fontSize: theme.fontSizes[0],
+                    color: theme.colors.text,
+                    lineHeight: 1.45,
+                    overflowWrap: 'anywhere',
+                }, children: issue.message })), showDetail && issue.fix && (_jsx("div", { style: { display: 'flex', marginTop: 1 }, children: _jsxs("button", { type: "button", onClick: (e) => {
+                        e.stopPropagation();
+                        onApplyFix?.(issue);
+                    }, disabled: onApplyFix == null, style: {
+                        display: 'inline-flex',
+                        alignItems: 'center',
+                        gap: 5,
+                        padding: '3px 8px',
+                        border: `1px solid ${theme.colors.primary}`,
+                        borderRadius: 4,
+                        background: 'transparent',
+                        color: theme.colors.primary,
+                        fontFamily: theme.fonts.monospace,
+                        fontSize: theme.fontSizes[0],
+                        cursor: onApplyFix == null ? 'default' : 'pointer',
+                        opacity: onApplyFix == null ? 0.5 : 1,
+                    }, children: [_jsx(Wrench, { size: 12 }), issue.fix.label] }) }))] }));
+}
+export function SubsystemIssueList({ issues, onSelectIssue, onApplyFix, onHoverIssue, }) {
+    const { theme } = useTheme();
+    const muted = theme.colors.textMuted ?? theme.colors.textSecondary;
+    const categories = groupIssuesByCategory(issues);
+    return (_jsx("div", { style: { flex: 1, minHeight: 0, overflowY: 'auto' }, children: categories.map((category) => {
+            // A layer with no findings renders its happy state: a green check in
+            // the header, no count, no cards.
+            const clean = category.count === 0;
+            const accent = category.severity
+                ? severityColor(category.severity, theme.colors, muted)
+                : theme.colors.success;
+            return (_jsxs("div", { children: [_jsxs("div", { style: {
+                            position: 'sticky',
+                            top: 0,
+                            zIndex: 1,
+                            display: 'flex',
+                            alignItems: 'center',
+                            gap: 7,
+                            padding: '7px 12px',
+                            background: theme.colors.backgroundSecondary ?? theme.colors.background,
+                            borderBottom: `1px solid ${theme.colors.border}`,
+                        }, children: [_jsx("span", { style: {
+                                    flex: 1,
+                                    minWidth: 0,
+                                    fontSize: theme.fontSizes[1],
+                                    fontWeight: 600,
+                                    color: clean ? muted : theme.colors.text,
+                                    fontFamily: theme.fonts.body,
+                                    whiteSpace: 'nowrap',
+                                    overflow: 'hidden',
+                                    textOverflow: 'ellipsis',
+                                }, children: category.label }), clean ? (_jsx(CircleCheck, { size: 13, color: accent, style: { flexShrink: 0 } })) : (_jsx("span", { style: {
+                                    fontFamily: theme.fonts.monospace,
+                                    fontSize: theme.fontSizes[0],
+                                    fontWeight: 600,
+                                    color: accent,
+                                    flexShrink: 0,
+                                }, children: category.count }))] }), !clean &&
+                        category.issues.map((issue) => (_jsx(SubsystemIssueCard, { issue: issue, onSelect: onSelectIssue, onApplyFix: onApplyFix, onHover: onHoverIssue }, issue.id)))] }, category.category));
+        }) }));
+}
+//# sourceMappingURL=IssueList.js.map

package/dist/subsystem/IssueList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IssueList.js","sourceRoot":"","sources":["../../src/subsystem/IssueList.tsx"],"names":[],"mappings":"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"}

package/dist/subsystem/SubsystemComponentGraph.d.ts

@@ -7,6 +7,9 @@
  * inside one labeled boundary frame; nodes without one sit outside every
  * boundary. Clicking a component invokes `onSelect`.
  *
+ * When the model has components but no topology or walkthrough edges, the
+ * canvas is a constructs catalog (list + signature) instead of a graph.
+ *
  * This is a focused fork of the package's `GraphRenderer` pipeline (same ELK
  * edge routing, delayed fitView, Background/Controls/MiniMap, node/edge type
  * injection, onNodeClick) adapted to the subsystem model — read-only.
@@ -14,6 +17,8 @@
 import type { ReactNode } from 'react';
 import { type SubsystemComponentEdge, type SubsystemComponent, type SubsystemEdgeView, type SubsystemRelation, type SubsystemWalkthrough } from './model';
 import type { SubsystemOpenFileOptions } from './declarationRef';
+import { type SubsystemDiagnostic } from './DiagnosticToggle';
+import { type SubsystemIssue } from './IssueList';
 import type { ComponentVerificationState } from './ComponentDeclaration';
 /** Context passed to `renderWalkthroughViewer` when a flow/step is focused. */
 export interface WalkthroughViewerContext {
@@ -103,6 +108,29 @@ export interface SubsystemComponentGraphProps {
     sidebarExtra?: ReactNode;
     /** Rendered in the sidebar under the description (e.g. selection inspector). */
     sidebarAfterDescription?: ReactNode;
+    /**
+     * Diagnostics status chip in the sidebar title row (beside the description
+     * toggle). Shows the last verification pass's state as an icon color + count;
+     * `onOpen` opens the full report. Omit to hide the chip.
+     */
+    diagnostic?: SubsystemDiagnostic;
+    /**
+     * Verification issues for this graph (audit findings). When diagnostics are
+     * active (see `showIssues`) the sidebar's bottom panel becomes the issue
+     * list instead of the file tree / walkthroughs.
+     */
+    issues?: SubsystemIssue[];
+    /**
+     * Force the sidebar into diagnostics mode. Defaults to `true` whenever
+     * `issues` is non-empty (and nothing else has been forced).
+     */
+    showIssues?: boolean;
+    /** Click an issue — focus its target on the graph / open detail. */
+    onSelectIssue?: (issue: SubsystemIssue) => void;
+    /** Apply an issue's deterministic fix. */
+    onApplyIssueFix?: (issue: SubsystemIssue) => void;
+    /** Hover an issue — transiently highlight its target (null on leave). */
+    onHoverIssue?: (issue: SubsystemIssue | null) => void;
     /**
      * Host-injected reader/renderer for the bottom file drawer, keyed by
      * repo-root-relative path. Opening happens on declaration/file-tree clicks.