@transitrix/diagrams 1.15.0 → 1.16.1

package/dist/standalone/validate.js

@@ -1,6 +1,6 @@
 // Standalone forms from ELEMENT_PRIMITIVES and CONTRACT (Methodology 7).
 // Field payloads are opaque: only their published identity/admission contract is checked.
-import { isCanonicalIdOfType, typeOfId } from '../typed-id.js';
+import { isCanonicalId, isCanonicalIdOfType, typeOfId } from '../typed-id.js';
 export const mapping = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
 const text = (v) => typeof v === 'string' && v.trim().length > 0;
 export const isoDate = (v) => typeof v === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(v) && Number.isFinite(Date.parse(v)) && new Date(v).toISOString().slice(0, 10) === v;
@@ -68,8 +68,8 @@ export function validateStandalone(notation, input, options = {}) {
     };
     optionalText('description');
     if (notation === 'product') {
-        if (!['digital_product', 'service', 'platform', 'bundle'].includes(d.type))
-            fail('type', 'digital_product|service|platform|bundle', d.type);
+        if (!['physical_product', 'digital_product', 'service', 'platform', 'bundle'].includes(d.type))
+            fail('type', 'physical_product|digital_product|service|platform|bundle', d.type);
         optionalText('domain');
         reference('owner_role', ['ROLE']);
         if ('maturity' in d && !(Number.isInteger(d.maturity) && Number(d.maturity) >= 1 && Number(d.maturity) <= 5))
@@ -78,6 +78,67 @@ export function validateStandalone(notation, input, options = {}) {
         references('processes', ['PROCESS']);
         references('supporting_apps', ['APPLICATION']);
     }
+    else if (notation === 'process') {
+        reference('owner_role', ['ROLE']);
+        reference('capability', ['CAPABILITY']);
+        references('participants', ['ROLE', 'ACTOR']);
+        optionalText('goal');
+        optionalText('result');
+        for (const key of ['parent', 'bpmn_file', 'maturity'])
+            if (key in d)
+                fail(key, 'absent inline; use canonical relations, flow or history', d[key]);
+        if (Array.isArray(d.participants) && new Set(d.participants).size !== d.participants.length)
+            fail('participants', 'unique references', d.participants);
+        if ('flow' in d) {
+            if (!mapping(d.flow))
+                fail('flow', 'mapping', d.flow);
+            else {
+                const flow = d.flow;
+                const steps = Array.isArray(flow.steps) ? flow.steps : [];
+                const sequence = Array.isArray(flow.sequence) ? flow.sequence : [];
+                if (!Array.isArray(flow.steps) || !steps.length)
+                    fail('flow.steps', 'nonempty list', flow.steps);
+                if (!Array.isArray(flow.sequence))
+                    fail('flow.sequence', 'list', flow.sequence);
+                const ids = new Set();
+                const types = ['startEvent', 'endEvent', 'task', 'userTask', 'serviceTask', 'exclusiveGateway', 'parallelGateway'];
+                steps.forEach((step, i) => {
+                    const key = `flow.steps[${i}]`;
+                    if (!mapping(step)) {
+                        fail(key, 'mapping', step);
+                        return;
+                    }
+                    if (!isCanonicalId(step.id) || ids.has(step.id))
+                        fail(`${key}.id`, 'unique canonical step ID', step.id);
+                    else
+                        ids.add(step.id);
+                    if (!types.includes(step.type))
+                        fail(`${key}.type`, types.join('|'), step.type);
+                    if ((!['startEvent', 'endEvent'].includes(step.type) || 'name' in step) && !text(step.name))
+                        fail(`${key}.name`, 'nonempty string', step.name);
+                    ref(`${key}.performed_by`, step.performed_by, ['ROLE', 'ACTOR']);
+                    if (!Array.isArray(d.participants) || !d.participants.includes(step.performed_by))
+                        fail(`${key}.performed_by`, 'member of participants', step.performed_by);
+                    if ('supported_by_application' in step)
+                        ref(`${key}.supported_by_application`, step.supported_by_application, ['APPLICATION']);
+                });
+                sequence.forEach((edge, i) => {
+                    const key = `flow.sequence[${i}]`;
+                    if (!mapping(edge)) {
+                        fail(key, 'mapping', edge);
+                        return;
+                    }
+                    for (const end of ['from', 'to'])
+                        if (typeof edge[end] !== 'string' || !ids.has(edge[end]))
+                            fail(`${key}.${end}`, 'ID in flow.steps', edge[end]);
+                    if ('condition' in edge && !text(edge.condition))
+                        fail(`${key}.condition`, 'nonempty string', edge.condition);
+                    if ('default' in edge && typeof edge.default !== 'boolean')
+                        fail(`${key}.default`, 'boolean', edge.default);
+                });
+            }
+        }
+    }
     else if (notation === 'capability') {
         if (!['domain', 'supporting'].includes(d.type))
             fail('type', 'domain|supporting', d.type);

package/dist/webview/render-activities.d.ts

@@ -1,6 +1,7 @@
 import { computeCpm } from '../activities/cpm.js';
 import type { ActivityDoc, ActivitiesLayout, ActivitiesLayoutOptions } from '../activities/types.js';
 import { type NodeSizePreset } from '../node-size-presets.js';
+import { type ThemeId } from '../theme/index.js';
 /**
  * Network-view diagram CSS (critical path, milestones, edge colours) — the
  * canonical rules shared with the VS Code preview's `ACTIVITIES_DIAGRAM_CSS`
@@ -54,6 +55,11 @@ export interface RenderActivitiesOptions {
      * Action name in the view header.
      */
     suppressProjectNodes?: boolean;
+    /**
+     * Theme CSS embedded as `<style>` so the SVG is self-contained.
+     * Defaults to `'transitrix'`. VS Code live preview uses body emitters + webview CSS instead.
+     */
+    embedCssTheme?: ThemeId;
 }
 /**
  * Render the network (PSND) view of an already-validated ActivityDoc to a

package/dist/webview/render-activities.js

@@ -194,7 +194,7 @@ export function renderActivitiesNetworkBody(layout, cpm, ox, oy, curvature, entr
  * than short-circuiting.
  */
 export function renderActivitiesSvg(doc, options = {}) {
-    const { title = '', gaps = {}, nodeSizePreset = 'normal', curvature = DEFAULT_EDGE_CURVATURE, entryCurvature, suppressProjectNodes = true, } = options;
+    const { title = '', gaps = {}, nodeSizePreset = 'normal', curvature = DEFAULT_EDGE_CURVATURE, entryCurvature, suppressProjectNodes = true, embedCssTheme = 'transitrix', } = options;
     const nodeSize = resolveActionNodeSize(parseNodeSizePreset(nodeSizePreset));
     const layoutGaps = {
         ...gaps,
@@ -228,7 +228,7 @@ export function renderActivitiesSvg(doc, options = {}) {
     // drop the SVG into the DOM and styling resolves without any cooperation from
     // the host stylesheet. Matches what the VS Code path produces via
     // `prepareSvgForExport`.
-    const embedCss = generateSvgEmbedCss('transitrix') + ACTIVITIES_NETWORK_CSS;
+    const embedCss = generateSvgEmbedCss(embedCssTheme) + ACTIVITIES_NETWORK_CSS;
     return `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">
 <style>${embedCss}</style>
 ${ACTIVITIES_NETWORK_DEFS}

package/dist/webview/render-activity-card.d.ts

@@ -1,6 +1,12 @@
 import type { ActivityCardDoc, ActivityCardLayout } from '../activity-card/types.js';
+import { type ThemeId } from '../theme/index.js';
 export interface RenderActivityCardOptions {
     title?: string;
+    /**
+     * Theme CSS embedded as `<style>` so the SVG is self-contained.
+     * Defaults to `'transitrix'`. VS Code live preview uses body emitters + webview CSS instead.
+     */
+    embedCssTheme?: ThemeId;
 }
 /**
  * The single Activity Card SVG body emitter shared by every host. Takes an

package/dist/webview/render-activity-card.js

@@ -175,7 +175,7 @@ export function renderActivityCardSvg(doc, options = {}) {
     // `ARCHIMATE_CLASS` is referenced so the host-neutral module pins the same
     // §5.1 class convention the layout applies; keeps the import meaningful.
     void ARCHIMATE_CLASS;
-    const { title = '' } = options;
+    const { title = '', embedCssTheme = 'transitrix' } = options;
     const resolved = resolveSingleDoc(doc);
     const layout = layoutActivityCard(resolved);
     if (layout.bounds.width <= 0 || layout.bounds.height <= 0)
@@ -189,7 +189,7 @@ export function renderActivityCardSvg(doc, options = {}) {
     const titleSvg = title
         ? `<text class="text-header" x="${PAD}" y="${PAD + 14}">${escXml(`Activity Card — ${title}`)}</text>`
         : '';
-    const embedCss = generateSvgEmbedCss('transitrix');
+    const embedCss = generateSvgEmbedCss(embedCssTheme);
     return `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">
 <style>${embedCss}</style>
 <defs>

package/dist/webview/render-blocks.d.ts

@@ -5,6 +5,11 @@ export interface RenderBlocksOptions {
     title?: string;
     nodeSizePreset?: NodeSizePreset;
     layoutOptions?: BlocksLayoutOptions;
+    /**
+     * Theme CSS embedded via {@link renderBlocksLayoutSvg}.
+     * Defaults to `'transitrix'` for self-contained host-neutral SVG.
+     */
+    embedCssTheme?: ThemeId;
 }
 export interface RenderBlocksLayoutOptions {
     /** Extra vertical space reserved at the top of the canvas (e.g. for a title block). */
@@ -48,6 +53,11 @@ export declare function renderGridLayoutSvg(layout: GridLayout, options?: Render
 export interface RenderGridOptions {
     title?: string;
     layoutOptions?: GridLayoutOptions;
+    /**
+     * Theme CSS embedded via {@link renderGridLayoutSvg}.
+     * Defaults to `'transitrix'` for self-contained host-neutral SVG.
+     */
+    embedCssTheme?: ThemeId;
 }
 /** Host-neutral grid (matrix subset) renderer (IntelliJ/UI). */
 export declare function renderGridSvg(doc: GridFile, options?: RenderGridOptions): string;

package/dist/webview/render-blocks.js

@@ -90,7 +90,7 @@ ${parts.join('\n')}
  * with the shared theme CSS embedded so the output is self-contained.
  */
 export function renderBlocksSvg(doc, options = {}) {
-    const { title = '', nodeSizePreset = 'normal', layoutOptions } = options;
+    const { title = '', nodeSizePreset = 'normal', layoutOptions, embedCssTheme = 'transitrix' } = options;
     const leaf = resolveBlocksLeafSize(parseNodeSizePreset(nodeSizePreset));
     const layout = layoutNestedBlocks(doc, {
         leafWidth: leaf.width,
@@ -103,7 +103,7 @@ export function renderBlocksSvg(doc, options = {}) {
     const titleSvg = title
         ? `<text class="text-header" x="${PAD}" y="${PAD - 6}">${escXml(`Nested Blocks — ${title}`)}</text>`
         : '';
-    return renderBlocksLayoutSvg(layout, { title: titleSvg, embedCssTheme: 'transitrix' });
+    return renderBlocksLayoutSvg(layout, { title: titleSvg, embedCssTheme });
 }
 /**
  * Matrix subset (08-blocks.md §4a) — first cut: a single-layer rectangular
@@ -195,7 +195,7 @@ ${body}
 }
 /** Host-neutral grid (matrix subset) renderer (IntelliJ/UI). */
 export function renderGridSvg(doc, options = {}) {
-    const { title = '', layoutOptions } = options;
+    const { title = '', layoutOptions, embedCssTheme = 'transitrix' } = options;
     const layout = layoutGrid(doc, layoutOptions);
     if (layout.columns.length === 0 || layout.rows.length === 0) {
         return `<svg xmlns="http://www.w3.org/2000/svg" width="0" height="0" viewBox="0 0 0 0"></svg>`;
@@ -203,5 +203,5 @@ export function renderGridSvg(doc, options = {}) {
     const titleSvg = title
         ? `<text class="text-header" x="${PAD}" y="${PAD - 6}">${escXml(`Nested Blocks — ${title}`)}</text>`
         : '';
-    return renderGridLayoutSvg(layout, { title: titleSvg, embedCssTheme: 'transitrix' });
+    return renderGridLayoutSvg(layout, { title: titleSvg, embedCssTheme });
 }

package/dist/webview/render-fgca.d.ts

@@ -2,6 +2,7 @@ import { layoutFGCAPreview } from '../fgca/preview-layout.js';
 import type { FGCADoc } from '../fgca/validate.js';
 import { type EdgeStyle } from '../edge-path.js';
 import { type NodeSizePreset } from '../node-size-presets.js';
+import { type ThemeId } from '../theme/index.js';
 type FgcaLayout = ReturnType<typeof layoutFGCAPreview>;
 export interface RenderFgcaBodyOptions {
     nodeWidth?: number;
@@ -35,6 +36,11 @@ export interface RenderFgcaOptions {
     scopeCaption?: boolean;
     /** Show completion percent badges on action nodes. */
     showCompletionPercent?: boolean;
+    /**
+     * Theme CSS embedded as `<style>` so the SVG is self-contained.
+     * Defaults to `'transitrix'`. VS Code live preview uses body emitters + webview CSS instead.
+     */
+    embedCssTheme?: ThemeId;
 }
 export declare function renderFgcaSvg(doc: FGCADoc, options?: RenderFgcaOptions): string;
 export {};

package/dist/webview/render-fgca.js

@@ -86,7 +86,7 @@ export function renderFgcaBody(columns, nodes, edges, curvature, entryCurvature,
     return `${headerSvg}\n${nodeSvg}\n${edgeSvg}`;
 }
 export function renderFgcaSvg(doc, options = {}) {
-    const { variant = 'dgca', title = '', curvature = DEFAULT_EDGE_CURVATURE, entryCurvature, edgeStyle, nodeSizePreset = 'normal', layoutOptions, scopeCaption = false, showCompletionPercent = true, } = options;
+    const { variant = 'dgca', title = '', curvature = DEFAULT_EDGE_CURVATURE, entryCurvature, edgeStyle, nodeSizePreset = 'normal', layoutOptions, scopeCaption = false, showCompletionPercent = true, embedCssTheme = 'transitrix', } = options;
     const hideChanges = variant === 'dga' || doc.hideChanges === true;
     const nodeSize = resolveDgcaNodeSize(parseNodeSizePreset(nodeSizePreset));
     const { nodes, edges, columns, width, height } = layoutFGCAPreview(doc, {
@@ -110,7 +110,7 @@ export function renderFgcaSvg(doc, options = {}) {
     const captionSvg = scopeCaption
         ? `<text class="text-caption" x="${PAD}" y="${height + 16}">${escXml('This diagram is shown for the selected goal scope. Actions on it may also serve goals outside that scope.')}</text>`
         : '';
-    const embedCss = generateSvgEmbedCss('transitrix');
+    const embedCss = generateSvgEmbedCss(embedCssTheme);
     // Calculate final height including caption if present
     const finalHeight = scopeCaption ? height + 24 : height;
     return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${finalHeight}" viewBox="0 0 ${width} ${finalHeight}">

package/dist/webview/render-goals.d.ts

@@ -8,6 +8,11 @@ export interface RenderGoalsOptions {
     entryCurvature?: number;
     edgeStyle?: EdgeStyle;
     nodeSizePreset?: NodeSizePreset;
+    /**
+     * Theme CSS embedded via {@link renderGoalsLayoutSvg}.
+     * Defaults to `'transitrix'` for self-contained host-neutral SVG.
+     */
+    embedCssTheme?: ThemeId;
 }
 /**
  * Host-neutral goals renderer (IntelliJ/UI). Lays the tree out with the default

package/dist/webview/render-goals.js

@@ -27,7 +27,7 @@ const PAD = 24;
  * with the shared theme CSS embedded so the output is self-contained.
  */
 export function renderGoalsSvg(tree, options = {}) {
-    const { treeName = '', curvature = DEFAULT_EDGE_CURVATURE, entryCurvature, edgeStyle, nodeSizePreset = 'normal' } = options;
+    const { treeName = '', curvature = DEFAULT_EDGE_CURVATURE, entryCurvature, edgeStyle, nodeSizePreset = 'normal', embedCssTheme = 'transitrix', } = options;
     const nodeSize = resolveGoalsNodeSize(parseNodeSizePreset(nodeSizePreset));
     const layout = layoutGoalTree(tree, {
         nodeWidth: nodeSize.width,
@@ -42,7 +42,14 @@ export function renderGoalsSvg(tree, options = {}) {
         ? `<text class="text-header" x="${PAD}" y="${PAD - 6}">${escXml(`Goal tree — ${treeName}`)}</text>`
         : '';
     // Reserve a separate header row; the theme centers text on its y coordinate.
-    return renderGoalsLayoutSvg(layout, { curvature, entryCurvature, edgeStyle, title, topInset: title ? PAD : 0, embedCssTheme: 'transitrix' });
+    return renderGoalsLayoutSvg(layout, {
+        curvature,
+        entryCurvature,
+        edgeStyle,
+        title,
+        topInset: title ? PAD : 0,
+        embedCssTheme,
+    });
 }
 /**
  * The single goals SVG emitter shared by every host. Takes an already-computed

package/dist/webview/render-process-blueprint.d.ts

@@ -1,9 +1,15 @@
 import type { ProcessBlueprintFile, ProcessBlueprintLayout, ProcessBlueprintLayoutOptions } from '../process-blueprint/types.js';
 import { type NodeSizePreset } from '../node-size-presets.js';
+import { type ThemeId } from '../theme/index.js';
 export declare function renderProcessBlueprintBody(layout: ProcessBlueprintLayout, ox: number, oy: number, clipId?: string): string;
 export interface RenderProcessBlueprintOptions {
     title?: string;
     nodeSizePreset?: NodeSizePreset;
     layoutOptions?: ProcessBlueprintLayoutOptions;
+    /**
+     * Theme CSS embedded as `<style>` so the SVG is self-contained.
+     * Defaults to `'transitrix'`. VS Code live preview uses body emitters + webview CSS instead.
+     */
+    embedCssTheme?: ThemeId;
 }
 export declare function renderProcessBlueprintSvg(doc: ProcessBlueprintFile, options?: RenderProcessBlueprintOptions): string;

package/dist/webview/render-process-blueprint.js

@@ -127,7 +127,7 @@ export function renderProcessBlueprintBody(layout, ox, oy, clipId = 'bp-clip') {
     return parts.join('\n');
 }
 export function renderProcessBlueprintSvg(doc, options = {}) {
-    const { title = '', nodeSizePreset = 'normal', layoutOptions } = options;
+    const { title = '', nodeSizePreset = 'normal', layoutOptions, embedCssTheme = 'transitrix' } = options;
     const sizing = resolveProcessBlueprintSize(parseNodeSizePreset(nodeSizePreset));
     const layout = layoutProcessBlueprint(doc, {
         ...sizing,
@@ -145,7 +145,7 @@ export function renderProcessBlueprintSvg(doc, options = {}) {
     const titleSvg = title
         ? `<text class="text-header" x="${PAD}" y="${PAD - 6}">${escXml(title)}</text>`
         : '';
-    const embedCss = generateSvgEmbedCss('transitrix') + BP_EMBED_CSS;
+    const embedCss = generateSvgEmbedCss(embedCssTheme) + BP_EMBED_CSS;
     return `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">
 <style>${embedCss}</style>
 ${titleSvg}

package/dist/webview/render-products.js

@@ -1,5 +1,6 @@
 import { escHtml } from './render-util.js';
 const TYPE_LABEL = {
+    physical_product: 'Physical Product',
     digital_product: 'Digital Product',
     service: 'Service',
     platform: 'Platform',

package/dist/yaml-normalize.d.ts

@@ -15,6 +15,8 @@
  * A bare `2026-06-01` parses to midnight UTC and round-trips to
  * `"2026-06-01"` regardless of `process.env.TZ`.
  *
- * Walks in place and returns the same reference for convenience.
+ * Walks in place and returns the same reference for convenience. Shared
+ * object graphs from YAML aliases (and cycles) are visited once via WeakSet
+ * so diamond / recursive anchors cannot amplify the walk into a hang.
  */
 export declare function coerceDatesToIsoStrings<T>(value: T): T;

package/dist/yaml-normalize.js

@@ -15,9 +15,14 @@
  * A bare `2026-06-01` parses to midnight UTC and round-trips to
  * `"2026-06-01"` regardless of `process.env.TZ`.
  *
- * Walks in place and returns the same reference for convenience.
+ * Walks in place and returns the same reference for convenience. Shared
+ * object graphs from YAML aliases (and cycles) are visited once via WeakSet
+ * so diamond / recursive anchors cannot amplify the walk into a hang.
  */
 export function coerceDatesToIsoStrings(value) {
+    return walk(value, new WeakSet());
+}
+function walk(value, seen) {
     if (value === null || value === undefined)
         return value;
     if (value instanceof Date) {
@@ -25,6 +30,9 @@ export function coerceDatesToIsoStrings(value) {
     }
     if (typeof value !== 'object')
         return value;
+    if (seen.has(value))
+        return value;
+    seen.add(value);
     if (Array.isArray(value)) {
         for (let i = 0; i < value.length; i++) {
             const v = value[i];
@@ -32,7 +40,7 @@ export function coerceDatesToIsoStrings(value) {
                 value[i] = dateToIsoYmd(v);
             }
             else if (v !== null && typeof v === 'object') {
-                coerceDatesToIsoStrings(v);
+                walk(v, seen);
             }
         }
         return value;
@@ -44,7 +52,7 @@ export function coerceDatesToIsoStrings(value) {
             obj[key] = dateToIsoYmd(v);
         }
         else if (v !== null && typeof v === 'object') {
-            coerceDatesToIsoStrings(v);
+            walk(v, seen);
         }
     }
     return value;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@transitrix/diagrams",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "type": "module",
   "description": "Shared rendering, validation, and pure mutations for Transitrix custom diagram formats.",
   "license": "MIT",

package/src/compliance/catalogue.ts

@@ -0,0 +1,49 @@
+import { emptyCanon, ingestComplianceDoc } from './classify.js';
+
+/** Relative POSIX paths keep scanning policy and content identity independent of host APIs. */
+export interface RequirementCatalogueIO {
+  read(path: string): Promise<string>;
+  list(path: string): Promise<Array<{ name: string; kind: 'file' | 'directory' | 'symlink' | 'other' }>>;
+  missing(error: unknown): boolean;
+  parse(content: string): unknown;
+  digest(content: string): string;
+  sourcePath?(path: string): string;
+}
+
+/** Shared disk/editor policy: one manifest boundary, all three zones, lossless failures. */
+export async function scanRequirementCatalogue(io: RequirementCatalogueIO) {
+  const canon = emptyCanon();
+  const transcript: unknown[] = [];
+  const manifest = await io.read('transitrix.yaml');
+  const parsed = io.parse(manifest);
+  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) throw new Error('Invalid transitrix.yaml manifest: expected a mapping');
+  transcript.push(['transitrix.yaml', manifest]);
+  const fail = (path: string, message: string) => {
+    transcript.push(['failure', path, message]);
+    canon.findings.push({ id: `${path}:load`, owner: path, field: '', code: 'LOAD', message, reference: false, severity: 'error' });
+  };
+  const walk = async (dir: string, top = false): Promise<void> => {
+    let entries: Awaited<ReturnType<RequirementCatalogueIO['list']>>;
+    try { entries = await io.list(dir); }
+    catch (error) {
+      if (top && io.missing(error)) { transcript.push(['absent-zone', dir]); return; }
+      fail(dir, 'Directory could not be enumerated'); return;
+    }
+    if (!top && entries.some(e => e.name === 'transitrix.yaml')) { transcript.push(['catalogue-boundary', dir]); return; }
+    for (const { name, kind } of entries.sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0)) {
+      const path = `${dir}/${name}`;
+      if (kind === 'symlink') { fail(path, 'Symbolic link was not enumerated'); continue; }
+      if (kind === 'directory') { await walk(path); continue; }
+      if (!/\.ya?ml$/i.test(name)) continue;
+      if (kind !== 'file') { fail(path, 'Unsupported file type'); continue; }
+      let content: string;
+      try { content = await io.read(path); }
+      catch { fail(path, 'Unreadable YAML record'); continue; }
+      transcript.push([path, content]);
+      try { ingestComplianceDoc(canon, io.parse(content), io.sourcePath?.(path) ?? path); }
+      catch { fail(path, 'Malformed YAML record'); }
+    }
+  };
+  for (const zone of ['canon', 'codex', 'field']) await walk(zone, true);
+  return { canon, snapshotId: `sha256:${io.digest(JSON.stringify(transcript))}` };
+}

package/src/compliance/index.ts

@@ -76,6 +76,9 @@ export type {
   TraceElementRef,
   TraceSourceRef,
 } from './types.js';
-export { buildRequirementChain, requirementReleaseCounts, selectRequirementChain, RequirementChainSnapshot, CHAIN_STAGES, chainDate } from './requirement-chain.js';
-export type { ChainInput, ChainScope, ChainSet, RequirementChainNode, RequirementChainEdge, RequirementChainProjection } from './requirement-chain.js';
+export { buildSubjectRequirementChain, buildRequirementChain, requirementReleaseCounts, selectRequirementChain, RequirementChainSnapshot, CHAIN_STAGES, chainDate } from './requirement-chain.js';
+export type { ChainSubject, ChainInput, ChainScope, ChainSet, RequirementChainNode, RequirementChainEdge, RequirementChainProjection } from './requirement-chain.js';
 export type { ChainRecord, ChainFinding } from './types.js';
+
+export { scanRequirementCatalogue } from './catalogue.js';
+export type { RequirementCatalogueIO } from './catalogue.js';