@principal-ai/subsystems-core 0.44.0 → 0.44.1

package/dist/types/subsystem-model.d.ts

@@ -0,0 +1,388 @@
+/**
+ * Subsystem Model Types
+ *
+ * Two layers — do not conflate them:
+ *
+ * 1. **Portable document** (`SubsystemModelDocument`) — the shareable standard.
+ *    Schema: `schemas/subsystem-model.schema.json`
+ *    (`https://principal-ai.dev/schemas/subsystem-model.schema.json`).
+ *
+ * 2. **Hydrated envelope** (`SubsystemModelHydrated`) — portable document plus
+ *    host/machine binding (local roots, provenance, store ids, verification).
+ *    Used by viewers and stores; not part of the portable standard.
+ *
+ * Ontology: construct = what a node is, framework + stereotype = which
+ * framework pattern it plays, role = where it sits, process = where it runs,
+ * module = which source file/module the export belongs to,
+ * proposed = not yet in source (design / migration placeholder).
+ * Package (repo) frames are derived from component `purl` when a graph spans
+ * multiple repos — there is no separate `package` field.
+ * `symbol` is the code identity; `name` is the display label.
+ */
+/** What the node IS as a declaration. `module` is not an authored construct —
+ *  a module is its own subsystem. `custom_entity` is an authored actor
+ *  (Person / agent / queue), not code. */
+export type SubsystemConstruct = 'class' | 'function' | 'method' | 'interface' | 'type_alias' | 'enum' | 'store' | 'external' | 'custom_entity';
+/** Where the node sits in the topology, orthogonal to construct. */
+export type SubsystemComponentRole = 'entry' | 'service';
+/**
+ * Actor kind for `construct: custom_entity` (open string).
+ * Examples: `Person`, `agent`, `queue`, `slack-channel`.
+ * Only meaningful on custom entities.
+ */
+export type SubsystemEntityKind = string;
+/**
+ * Framework that owns a stereotype vocabulary (open string).
+ * Examples: `react`, `vue`, `nestjs`, `django`, `spring`.
+ * Empty when the node is language-only / framework-agnostic.
+ */
+export type SubsystemFramework = string;
+/**
+ * Framework-level pattern stamped on a language construct (open string).
+ * Examples: `component`, `hook`, `middleware`, `controller`, `guard`.
+ * Empty when no framework pattern applies. Pair with `framework` when set.
+ */
+export type SubsystemStereotype = string;
+/**
+ * Trail step mechanism — runtime seams with a `file:line` site.
+ * Belongs on trail steps; graph edges for these are derived.
+ */
+export type SubsystemTrailMechanism = 'calls' | 'uses' | 'feeds' | 'produces' | 'writes' | 'reads' | 'watches' | 'registers-into';
+/**
+ * Edge mechanism used by derived display edges / styling. Display edges are
+ * derived from trail steps, so this is the trail mechanism.
+ */
+export type SubsystemEdgeMechanism = SubsystemTrailMechanism;
+export type SubsystemDeclarationProvenance = 'verified' | 'authored';
+export type SubsystemDeclTokenKind = 'keyword' | 'name' | 'member' | 'type' | 'punctuation' | 'string' | 'newline';
+export interface SubsystemDeclToken {
+    text: string;
+    kind: SubsystemDeclTokenKind;
+    /** Optional foreground when pre-tokenized for a theme. */
+    color?: string;
+}
+/** Anchored declaration location (usually from verify tooling). */
+export interface SubsystemDeclarationRef {
+    file: string;
+    startLine: number;
+    lineHash: string;
+    graphifyNodeId?: string;
+    capturedAt: string;
+}
+export interface SubsystemParamInfo {
+    name?: string;
+    type: string;
+    ref?: SubsystemReferenceInfo;
+}
+export interface SubsystemPropertyInfo {
+    name: string;
+    type?: string;
+    typeRef?: SubsystemReferenceInfo;
+    nodeId?: string;
+}
+export interface SubsystemMethodInfo {
+    nodeId: string;
+    name: string;
+    parameters?: SubsystemParamInfo[];
+    returnType?: string;
+    returnTypeRef?: SubsystemReferenceInfo;
+}
+export interface SubsystemCallInfo {
+    nodeId: string;
+    name: string;
+    source_location?: string;
+}
+export interface SubsystemReferenceInfo {
+    nodeId: string;
+    name: string;
+    context?: string;
+    source_location?: string;
+}
+export interface SubsystemClassDeclaration {
+    kind: 'class';
+    methods: SubsystemMethodInfo[];
+    properties: SubsystemPropertyInfo[];
+    extends: string[];
+    implements: string[];
+    instantiations: SubsystemCallInfo[];
+    references: SubsystemReferenceInfo[];
+}
+export interface SubsystemFunctionDeclaration {
+    kind: 'function';
+    parameters: SubsystemParamInfo[];
+    returnType?: string;
+    returnTypeRef?: SubsystemReferenceInfo;
+    callers: SubsystemCallInfo[];
+    callees: SubsystemCallInfo[];
+}
+export interface SubsystemMethodDeclaration {
+    kind: 'method';
+    hostClass: string;
+    parameters?: SubsystemParamInfo[];
+    returnType?: string;
+}
+/** One generic type parameter, e.g. `T` or `K extends keyof StudioMessages`. */
+export interface SubsystemTypeParamInfo {
+    name: string;
+    /** Constraint written after `extends` (or language equivalent). */
+    constraint?: string;
+}
+/** A callable/function type: `(params) => returnType`. */
+export interface SubsystemCallableTypeInfo {
+    parameters?: SubsystemParamInfo[];
+    returnType?: string;
+}
+/** One enum member, with its optional literal value. */
+export interface SubsystemEnumMemberInfo {
+    name: string;
+    value?: string;
+}
+/**
+ * Type-family declaration (interface / type alias / enum). Structured buckets
+ * cover common shapes; `rhs` is the verbatim escape hatch when none fit.
+ */
+export interface SubsystemTypeDeclaration {
+    kind: 'type';
+    properties: SubsystemPropertyInfo[];
+    usedBy: SubsystemReferenceInfo[];
+    implementors: string[];
+    /** Generic type parameters, e.g. `<K extends keyof StudioMessages>`. */
+    generics?: SubsystemTypeParamInfo[];
+    /** Callable type — `(params) => returnType`. */
+    signature?: SubsystemCallableTypeInfo;
+    /** Enum members (name, optional literal value). */
+    enumMembers?: SubsystemEnumMemberInfo[];
+    /** Alias whose RHS is a plain reference, e.g. `ServerSessionRow[]`. */
+    aliasOf?: string;
+    /** Simple union of alternatives, e.g. `'started' | 'stopped'`. */
+    unionOf?: string[];
+    /**
+     * Verbatim RHS — escape hatch for shapes the structured fields can't
+     * express. Wins over every shape above when set.
+     */
+    rhs?: string;
+}
+export interface SubsystemExternalDeclaration {
+    kind: 'external';
+    label: string;
+}
+export interface SubsystemStoreDeclaration {
+    kind: 'store';
+    /** Where retained state lives / who mediates access. Authored, never
+     *  extracted: `memory` (process-lifetime RAM), `disk` (this process
+     *  reads/writes files), or `external` (another system — db/service; carries
+     *  no `process`). */
+    storage?: 'memory' | 'disk' | 'external';
+    /**
+     * The type of the retained state itself — a store declares its type the way
+     * every other declaration does. A state block names its value type
+     * (`Map<string, FeedState>`, `Set<Listener>`); a table names its row/record
+     * type. Orthogonal to `storage`: an in-memory store still has a value type.
+     *
+     * Optional because a store with neither a `valueType` nor named `properties`
+     * has no declared type — that is a gap the audit can flag, not an error.
+     */
+    valueType?: string;
+    /** Resolvable target of `valueType` — makes the type navigable like a
+     *  property's `typeRef`. */
+    valueTypeRef?: SubsystemReferenceInfo;
+    properties: SubsystemPropertyInfo[];
+}
+/** A single authored attribute on a custom entity — free-form key/value. */
+export interface SubsystemCustomEntityAttribute {
+    key: string;
+    value: string;
+}
+/**
+ * Declaration for `construct: custom_entity` (an actor — Person/agent/queue).
+ * Authored, never extracted: there is no backing source declaration.
+ * `attributes` is authored key/value (e.g. `slack`, `permission`, `level`).
+ */
+export interface SubsystemCustomEntityDeclaration {
+    kind: 'custom_entity';
+    attributes: SubsystemCustomEntityAttribute[];
+}
+/** Structured declaration shape of a construct. */
+export type SubsystemConstructDeclaration = SubsystemClassDeclaration | SubsystemFunctionDeclaration | SubsystemMethodDeclaration | SubsystemTypeDeclaration | SubsystemExternalDeclaration | SubsystemStoreDeclaration | SubsystemCustomEntityDeclaration;
+/** A component node — the named unit, construct-tagged. */
+export interface SubsystemComponent {
+    /**
+     * Model-local stable alias. Referenced by trail `from` /
+     * `to`; unique per model. Edges point at the alias, not the location — a
+     * file move or symbol rename leaves edges intact. Code identity lives on
+     * `purl` + `file` + `symbol` and is what composed (multi-model) views
+     * join on, not this field.
+     */
+    alias: string;
+    /** Display label. Prefer aligning with `symbol` when present. */
+    name: string;
+    construct: SubsystemConstruct;
+    /** Repo-root-relative source path. */
+    file: string;
+    /** PURL for repo/package grouping. Multi-repo graphs draw package frames from distinct purl repo keys. */
+    purl: string;
+    purpose?: string;
+    role?: SubsystemComponentRole;
+    /**
+     * Design / migration placeholder — participates in edges and flows but is
+     * not a live source declaration yet. Verification skips source checks until
+     * promoted (`proposed` cleared, `file` + `symbol` filled). Orthogonal to
+     * `construct` (intended shape) and `role` (topology).
+     */
+    proposed?: boolean;
+    /**
+     * Framework that owns the stereotype (e.g. `react`, `nestjs`).
+     * Orthogonal to `construct` — a React component is still `construct: function`.
+     */
+    framework?: SubsystemFramework;
+    /**
+     * Framework pattern this declaration plays (e.g. `component`, `hook`).
+     * Prefer this over inventing framework-specific constructs.
+     */
+    stereotype?: SubsystemStereotype;
+    process?: string;
+    /**
+     * Source-module membership — which file/module this export belongs to
+     * (e.g. `src/session/transcript.ts`). Nodes sharing a `module` are drawn
+     * inside one boundary frame. Prefer this over inventing a module construct:
+     * anchor each export as its real construct (`function` / `class` / …) and
+     * set `module` so the file reads as a frame, not a node. Orthogonal to
+     * `process` (runtime deployment unit).
+     */
+    module?: string;
+    /** Code identity — real declaration in `file` when set. */
+    symbol?: string;
+    /**
+     * Actor kind for `construct: custom_entity` (e.g. `Person`, `agent`,
+     * `queue`), rendered as the node badge. Ignored on code constructs.
+     */
+    entityKind?: SubsystemEntityKind;
+    /**
+     * Node + declaration accent override (hex). Wins over the construct-derived
+     * color. Typically used to theme a custom entity (agent, queue).
+     */
+    color?: string;
+    layer?: number;
+    /** Structured declaration shape of the construct (params, members, …). */
+    declaration?: SubsystemConstructDeclaration;
+    declarationProvenance?: SubsystemDeclarationProvenance;
+    tokens?: SubsystemDeclToken[];
+    /** Location anchor (file/line/hash) — distinct from `declaration` (shape). */
+    declarationRef?: SubsystemDeclarationRef;
+}
+/**
+ * Derived / display graph edge used by renderers. Built from trail
+ * steps — not authored as its own document field.
+ */
+export interface SubsystemComponentEdge {
+    id: string;
+    from: string;
+    to: string;
+    mechanism: SubsystemEdgeMechanism;
+}
+export interface SubsystemTrailStep {
+    /** Source component alias. */
+    from: string;
+    /** Target component alias. */
+    to: string;
+    /** Runtime seam label (Set B). */
+    mechanism: SubsystemTrailMechanism;
+    file: string;
+    /** 1-based line within `file`. */
+    line: number;
+    /**
+     * File-anchored purl of the seam site (e.g.
+     * `pkg:github/owner/name#path/to/file.ts`), mirroring component `purl`.
+     * Required: readers resolve the checkout from this instead of guessing
+     * the repo from the step's endpoint components.
+     */
+    purl: string;
+    /**
+     * Frame name for this step — the function/method on the stack at the site.
+     * Required: the Trails list shows this instead of a bare
+     * mechanism + filename fallback.
+     */
+    symbol: string;
+    /**
+     * Free-text note anchored to this step's site line. Optional — informative
+     * only, never verified against source; viewers surface it via the codeview's
+     * annotation column.
+     */
+    annotation?: string;
+}
+/** Ordered runtime trail (one named behavior story). */
+export interface SubsystemTrail {
+    id: string;
+    title: string;
+    steps: SubsystemTrailStep[];
+}
+/**
+ * Portable subsystem model — the shareable standard.
+ * No host paths, provenance, document-level repo, store ids, or verification.
+ * Repo identity lives on each component's `purl`.
+ */
+/**
+ * A pinned commit for one referenced repo. Keyed by `purlRepoKey` (the purl
+ * with its fragment stripped). Commit-only — a dirty tree has no reproducible
+ * name and is never recorded as a coordinate.
+ */
+export type PurlCommit = string;
+export interface SubsystemModelDocument {
+    /**
+     * Optional pointer to the JSON Schema that describes this file. Lets editors
+     * give autocomplete and validation when the field is set.
+     */
+    $schema?: string;
+    title: string;
+    description?: string;
+    components: SubsystemComponent[];
+    /** Runtime trails (ordered steps with sites). */
+    trails?: SubsystemTrail[];
+    /**
+     * The commit each referenced repo was at when the model was created. The
+     * coordinate system for every `file:line` in the document: without it, a
+     * line pointer is ambiguous across commits. Immutable after create.
+     */
+    createdAtCommits?: Record<string, PurlCommit>;
+    /**
+     * The commit each referenced repo was at when a full audit last passed
+     * against a clean referenced state. Absent until an audit earns it.
+     */
+    verifiedAtCommits?: Record<string, PurlCommit>;
+}
+/**
+ * Hydrated model: portable document + store metadata.
+ * Shape used after a host accepts/persists a model for viewing on a machine.
+ * Local path binding is resolved from Alexandria (via each component's purl)
+ * and repo identity is derived from purls — neither is stored here.
+ */
+export interface SubsystemModelHydrated extends SubsystemModelDocument {
+    /** Store-assigned id when persisted. */
+    id?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    /** Host verification result; shape is host-defined. */
+    verification?: unknown;
+}
+/**
+ * Type guard: true when the value plausibly conforms to a portable
+ * subsystem model. Shallow check — full validation belongs to the schema /
+ * host validator.
+ */
+export declare function isSubsystemModelDocument(value: unknown): value is SubsystemModelDocument;
+/**
+ * Keep only portable fields — drop host bindings / store metadata if a
+ * hydrated record is passed in. Use before writing a gist or any other
+ * share surface that must stay schema-clean.
+ */
+export declare function toPortableDocument(doc: SubsystemModelDocument): SubsystemModelDocument;
+/** Stable id for a derived graph edge from a trail step. */
+export declare function derivedGraphEdgeId(from: string, to: string, mechanism: SubsystemEdgeMechanism): string;
+/**
+ * Build display edges for the graph canvas from trail steps
+ * (deduped by from/to/mechanism).
+ */
+export declare function deriveGraphEdges(doc: {
+    trails?: SubsystemTrail[];
+}): SubsystemComponentEdge[];
+//# sourceMappingURL=subsystem-model.d.ts.map

package/dist/types/subsystem-model.d.ts.map

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

package/dist/types/subsystem-model.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Subsystem Model Types
+ *
+ * Two layers — do not conflate them:
+ *
+ * 1. **Portable document** (`SubsystemModelDocument`) — the shareable standard.
+ *    Schema: `schemas/subsystem-model.schema.json`
+ *    (`https://principal-ai.dev/schemas/subsystem-model.schema.json`).
+ *
+ * 2. **Hydrated envelope** (`SubsystemModelHydrated`) — portable document plus
+ *    host/machine binding (local roots, provenance, store ids, verification).
+ *    Used by viewers and stores; not part of the portable standard.
+ *
+ * Ontology: construct = what a node is, framework + stereotype = which
+ * framework pattern it plays, role = where it sits, process = where it runs,
+ * module = which source file/module the export belongs to,
+ * proposed = not yet in source (design / migration placeholder).
+ * Package (repo) frames are derived from component `purl` when a graph spans
+ * multiple repos — there is no separate `package` field.
+ * `symbol` is the code identity; `name` is the display label.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveGraphEdges = exports.derivedGraphEdgeId = exports.toPortableDocument = exports.isSubsystemModelDocument = void 0;
+/**
+ * Type guard: true when the value plausibly conforms to a portable
+ * subsystem model. Shallow check — full validation belongs to the schema /
+ * host validator.
+ */
+function isSubsystemModelDocument(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const v = value;
+    return typeof v.title === 'string' && Array.isArray(v.components);
+}
+exports.isSubsystemModelDocument = isSubsystemModelDocument;
+/**
+ * Keep only portable fields — drop host bindings / store metadata if a
+ * hydrated record is passed in. Use before writing a gist or any other
+ * share surface that must stay schema-clean.
+ */
+function toPortableDocument(doc) {
+    const out = {
+        title: doc.title,
+        components: doc.components,
+    };
+    if (doc.$schema)
+        out.$schema = doc.$schema;
+    if (doc.description)
+        out.description = doc.description;
+    if (doc.trails)
+        out.trails = doc.trails;
+    if (doc.createdAtCommits)
+        out.createdAtCommits = doc.createdAtCommits;
+    if (doc.verifiedAtCommits)
+        out.verifiedAtCommits = doc.verifiedAtCommits;
+    return out;
+}
+exports.toPortableDocument = toPortableDocument;
+/** Stable id for a derived graph edge from a trail step. */
+function derivedGraphEdgeId(from, to, mechanism) {
+    return `${from}--${mechanism}-->${to}`;
+}
+exports.derivedGraphEdgeId = derivedGraphEdgeId;
+/**
+ * Build display edges for the graph canvas from trail steps
+ * (deduped by from/to/mechanism).
+ */
+function deriveGraphEdges(doc) {
+    const byId = new Map();
+    for (const w of doc.trails ?? []) {
+        for (const step of w.steps) {
+            const id = derivedGraphEdgeId(step.from, step.to, step.mechanism);
+            if (!byId.has(id)) {
+                byId.set(id, {
+                    id,
+                    from: step.from,
+                    to: step.to,
+                    mechanism: step.mechanism,
+                });
+            }
+        }
+    }
+    return [...byId.values()];
+}
+exports.deriveGraphEdges = deriveGraphEdges;
+//# sourceMappingURL=subsystem-model.js.map

package/dist/types/subsystem-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subsystem-model.js","sourceRoot":"","sources":["../../src/types/subsystem-model.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AA8ZH;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,KAAc;IACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAGT,CAAC;IACF,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AACpE,CAAC;AAPD,4DAOC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAChC,GAA2B;IAE3B,MAAM,GAAG,GAA2B;QAClC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC;IACF,IAAI,GAAG,CAAC,OAAO;QAAE,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,CAAC,WAAW;QAAE,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACvD,IAAI,GAAG,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IACxC,IAAI,GAAG,CAAC,gBAAgB;QAAE,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACtE,IAAI,GAAG,CAAC,iBAAiB;QAAE,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC;IACzE,OAAO,GAAG,CAAC;AACb,CAAC;AAbD,gDAaC;AAED,4DAA4D;AAC5D,SAAgB,kBAAkB,CAChC,IAAY,EACZ,EAAU,EACV,SAAiC;IAEjC,OAAO,GAAG,IAAI,KAAK,SAAS,MAAM,EAAE,EAAE,CAAC;AACzC,CAAC;AAND,gDAMC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,GAEhC;IACC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkC,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE;QAChC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE;YAC1B,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAClE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;gBACjB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;oBACX,EAAE;oBACF,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,CAAC,CAAC;aACJ;SACF;KACF;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5B,CAAC;AAlBD,4CAkBC"}

package/dist/validation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cross-field validation for a subsystem model document.
+ *
+ * These are the rules the JSON Schema (`schemas/subsystem-model.schema.json`)
+ * cannot express — anything that spans fields or arrays: alias uniqueness,
+ * referential integrity between trails and components, and the
+ * `module` implies `file` invariant. Structural checks (types, `required`,
+ * enums, ranges, closed objects) belong to the schema and are enforced per
+ * surface; this module owns only what the schema can't.
+ *
+ * Pure and dependency-free (browser-safe) — no JSON Schema validator here.
+ */
+import type { SubsystemModelDocument } from './types/subsystem-model';
+export interface SubsystemValidationProblem {
+    /** JSON-pointer-ish location, e.g. `/components/2` or `/trails/0/steps/0/from`. */
+    path: string;
+    message: string;
+}
+/**
+ * Validate the cross-field rules of a subsystem model document. Returns an
+ * empty array when the document is consistent.
+ */
+export declare function validateSubsystemModelCrossField(doc: SubsystemModelDocument): SubsystemValidationProblem[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,0BAA0B;IACzC,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAyBD;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,sBAAsB,GAC1B,0BAA0B,EAAE,CAuE9B"}

package/dist/validation.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Cross-field validation for a subsystem model document.
+ *
+ * These are the rules the JSON Schema (`schemas/subsystem-model.schema.json`)
+ * cannot express — anything that spans fields or arrays: alias uniqueness,
+ * referential integrity between trails and components, and the
+ * `module` implies `file` invariant. Structural checks (types, `required`,
+ * enums, ranges, closed objects) belong to the schema and are enforced per
+ * surface; this module owns only what the schema can't.
+ *
+ * Pure and dependency-free (browser-safe) — no JSON Schema validator here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSubsystemModelCrossField = void 0;
+function isUngrounded(c) {
+    return c.construct === 'external' || c.proposed === true;
+}
+/**
+ * `file` is a path *inside the repo named by `purl`* — it resolves against that
+ * checkout, never against an installed artifact. `node_modules/` is installed,
+ * gitignored, and its layout depends on hoisting, so a claim anchored there can
+ * never resolve and is unverifiable by construction.
+ *
+ * Such a component is a third-party dependency: model it as `construct:
+ * 'external'` with `purl: 'pkg:npm/<package>'` and no file. Applies to externals
+ * too — they carry no file by design, so an install path there is dead weight
+ * that draws a link nothing can open. `proposed` is exempt like every other
+ * grounding rule: its file is a placeholder for something not placed yet.
+ *
+ * The same rule covers trail step files — a seam into an external belongs
+ * at the call site in the caller, which *is* in the repo.
+ */
+function mentionsNodeModules(path) {
+    return /(^|\/)node_modules(\/|$)/.test(path);
+}
+/**
+ * Validate the cross-field rules of a subsystem model document. Returns an
+ * empty array when the document is consistent.
+ */
+function validateSubsystemModelCrossField(doc) {
+    const problems = [];
+    const components = doc.components ?? [];
+    const trails = doc.trails ?? [];
+    // Component aliases must be unique, and the set is the referential target
+    // for trail steps.
+    const ids = new Set();
+    components.forEach((c, i) => {
+        if (ids.has(c.alias)) {
+            problems.push({
+                path: `/components/${i}/alias`,
+                message: `component ${JSON.stringify(c.alias)}: duplicate alias`,
+            });
+        }
+        else {
+            ids.add(c.alias);
+        }
+        // A grounded component that claims a `module` needs a `file` to ground the
+        // frame. Externals / proposed carry no file by design.
+        const module = typeof c.module === 'string' ? c.module.trim() : '';
+        const file = typeof c.file === 'string' ? c.file.trim() : '';
+        if (module && !file && !isUngrounded(c)) {
+            problems.push({
+                path: `/components/${i}/module`,
+                message: `component ${JSON.stringify(c.alias)}: module ${JSON.stringify(module)} is set but file is empty — a module frame needs a file to ground it (mark the component proposed if it is not placed yet).`,
+            });
+        }
+        if (file && c.proposed !== true && mentionsNodeModules(file)) {
+            problems.push({
+                path: `/components/${i}/file`,
+                message: `component ${JSON.stringify(c.alias)}: file ${JSON.stringify(file)} points into node_modules — installed artifacts are not part of the repo and cannot be verified. Model the dependency as construct "external" with purl "pkg:npm/<package>" and no file, or anchor the claim to the package's real source.`,
+            });
+        }
+    });
+    trails.forEach((w, ti) => {
+        (w.steps ?? []).forEach((step, si) => {
+            if (!ids.has(step.from)) {
+                problems.push({
+                    path: `/trails/${ti}/steps/${si}/from`,
+                    message: `trail ${JSON.stringify(w.id)}: step ${si} from ${JSON.stringify(step.from)} does not match any component alias`,
+                });
+            }
+            if (!ids.has(step.to)) {
+                problems.push({
+                    path: `/trails/${ti}/steps/${si}/to`,
+                    message: `trail ${JSON.stringify(w.id)}: step ${si} to ${JSON.stringify(step.to)} does not match any component alias`,
+                });
+            }
+            // A file-anchored step purl names its own site: the fragment must be
+            // the step file. Repo-only purls still resolve, so only the anchored
+            // form is checked.
+            if (typeof step.purl === 'string' && step.purl.includes('#')) {
+                const fragment = step.purl.split('#').slice(1).join('#');
+                if (fragment !== step.file) {
+                    problems.push({
+                        path: `/trails/${ti}/steps/${si}/purl`,
+                        message: `trail ${JSON.stringify(w.id)}: step ${si} purl fragment ${JSON.stringify(fragment)} does not match step file ${JSON.stringify(step.file)}`,
+                    });
+                }
+            }
+            if (mentionsNodeModules(step.file)) {
+                problems.push({
+                    path: `/trails/${ti}/steps/${si}/file`,
+                    message: `trail ${JSON.stringify(w.id)}: step ${si} file ${JSON.stringify(step.file)} points into node_modules — anchor the seam at the call site inside the repo instead.`,
+                });
+            }
+        });
+    });
+    return problems;
+}
+exports.validateSubsystemModelCrossField = validateSubsystemModelCrossField;
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principal-ai/subsystems-core",
-  "version": "0.44.0",
+  "version": "0.44.1",
   "description": "Subsystem model types and agent-session tooling for Principal AI",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -39,6 +39,7 @@
     "test": "bun test",
     "test:watch": "bun test --watch",
     "test:coverage": "bun test --coverage",
+    "prepack": "bun run build",
     "lint": "cd ../.. && eslint packages/subsystems-core --ext .ts,.tsx,.js,.jsx",
     "lint:fix": "cd ../.. && eslint packages/subsystems-core --ext .ts,.tsx,.js,.jsx --fix"
   },