@transitrix/diagrams 1.8.21 → 1.10.0

package/dist/verification/types.d.ts

@@ -0,0 +1,31 @@
+import type { GateChecks } from '../requirement/types.js';
+import type { Evidence } from '../assertion/types.js';
+/** V&V method vocabulary (27-verification.md §3). */
+export type VerificationMethod = 'test' | 'analysis' | 'inspection' | 'demonstration';
+export declare const VERIFICATION_METHODS: readonly VerificationMethod[];
+/** Pass/fail judgement vocabulary (27-verification.md §3). */
+export type VerificationOutcome = 'pass' | 'fail' | 'inconclusive' | 'not_yet_run';
+export declare const VERIFICATION_OUTCOMES: readonly VerificationOutcome[];
+/** Outcomes that count as "closed" — the trace link has resolved one way or
+ *  the other, distinct from still-open (`not_yet_run` / `inconclusive`)
+ *  (27-verification.md §5, REQ-VERIF-COVERAGE-002). */
+export declare const CLOSED_VERIFICATION_OUTCOMES: readonly VerificationOutcome[];
+export interface Verification {
+    notation: 'verification';
+    id: string;
+    /** Typed ID of the REQUIREMENT this verification targets. */
+    verifies: string;
+    method: VerificationMethod;
+    protocol: string;
+    result?: string;
+    outcome: VerificationOutcome;
+    evidence?: Evidence[];
+    performed_at?: string;
+    performed_by?: string;
+    zone: 'canon';
+    admitted_at: string;
+    admitted_by: string;
+    gate_checks: GateChecks;
+    valid_from: string;
+    valid_to: string | null;
+}

package/dist/verification/types.js

@@ -0,0 +1,12 @@
+// VERIFICATION — engineering V&V claim against a REQUIREMENT.
+// Schema: methodology notations/elements/27-verification.md §2.
+export const VERIFICATION_METHODS = [
+    'test', 'analysis', 'inspection', 'demonstration',
+];
+export const VERIFICATION_OUTCOMES = [
+    'pass', 'fail', 'inconclusive', 'not_yet_run',
+];
+/** Outcomes that count as "closed" — the trace link has resolved one way or
+ *  the other, distinct from still-open (`not_yet_run` / `inconclusive`)
+ *  (27-verification.md §5, REQ-VERIF-COVERAGE-002). */
+export const CLOSED_VERIFICATION_OUTCOMES = ['pass', 'fail'];

package/dist/verification/validate.d.ts

@@ -0,0 +1,7 @@
+import type { ValidationResult } from '../validation-types.js';
+import { type CanonCatalog } from '../typed-id.js';
+export interface VerificationValidateOptions {
+    /** When provided, the resolution rules enforce artefact existence. */
+    catalog?: CanonCatalog;
+}
+export declare function validateVerification(input: unknown, options?: VerificationValidateOptions): ValidationResult;

package/dist/verification/validate.js

@@ -0,0 +1,104 @@
+// VERIFICATION validator — methodology notations/elements/27-verification.md §5.
+//
+// Implements VERIF-001..006. The shared HDR-/LIFECYCLE- rules and the
+// cross-cutting REQ-VERIF-COVERAGE-001/002 reverse-trace rules are owned
+// elsewhere (CONTRACT.md §8) and are out of scope for this single-artefact
+// validator — same posture as `validateAssertion` (../assertion/validate.ts).
+//
+// Resolution rules (VERIF-002/005) that need artefact *existence* run only
+// when a `CanonCatalog` is supplied; the TYPE check VERIF-002 also carries is
+// derivable from the id prefix and runs either way.
+import { typeOfId, isCanonicalIdOfType } from '../typed-id.js';
+import { VERIFICATION_METHODS, VERIFICATION_OUTCOMES } from './types.js';
+export function validateVerification(input, options = {}) {
+    const errors = [];
+    const warnings = [];
+    const { catalog } = options;
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        errors.push({ code: 'VERIF-001', message: 'Verification must be a YAML mapping.' });
+        return { valid: false, errors, warnings };
+    }
+    const v = input;
+    // ── VERIF-001 — id grammar + plain required fields ───────────────────────
+    if (!isCanonicalIdOfType(v.id, 'VERIFICATION')) {
+        errors.push({ code: 'VERIF-001', message: `id "${String(v.id)}" must match VERIFICATION-[<middle>-]<INTEGER>.`, path: 'id' });
+    }
+    if (v.notation !== 'verification') {
+        errors.push({ code: 'VERIF-001', message: 'notation must be the fixed value "verification".', path: 'notation' });
+    }
+    if (v.zone !== 'canon') {
+        errors.push({ code: 'VERIF-001', message: 'zone is required and must be "canon".', path: 'zone' });
+    }
+    for (const f of ['admitted_at', 'admitted_by', 'valid_from', 'protocol']) {
+        if (typeof v[f] !== 'string' || v[f].trim() === '') {
+            errors.push({ code: 'VERIF-001', message: `${f} is required.`, path: f });
+        }
+    }
+    if (v.gate_checks === null || typeof v.gate_checks !== 'object') {
+        errors.push({ code: 'VERIF-001', message: 'gate_checks is required and must be a mapping.', path: 'gate_checks' });
+    }
+    if (!('valid_to' in v) || !(typeof v.valid_to === 'string' || v.valid_to === null)) {
+        errors.push({ code: 'VERIF-001', message: 'valid_to is required (an ISO date string or null).', path: 'valid_to' });
+    }
+    // ── VERIF-002 — verifies → REQUIREMENT ───────────────────────────────────
+    const verifies = v.verifies;
+    if (typeof verifies !== 'string' || verifies.trim() === '') {
+        errors.push({ code: 'VERIF-002', message: 'verifies is required and must be a typed REQUIREMENT id.', path: 'verifies' });
+    }
+    else if (catalog) {
+        const t = catalog.typeOf(verifies);
+        if (t === undefined) {
+            errors.push({ code: 'VERIF-002', message: `verifies "${verifies}" does not resolve to an admitted artefact.`, path: 'verifies' });
+        }
+        else if (t !== 'REQUIREMENT') {
+            errors.push({ code: 'VERIF-002', message: `verifies "${verifies}" resolves to a ${t}, not a REQUIREMENT.`, path: 'verifies' });
+        }
+    }
+    else if (typeOfId(verifies) !== 'REQUIREMENT') {
+        errors.push({ code: 'VERIF-002', message: `verifies "${verifies}" must be a REQUIREMENT typed id.`, path: 'verifies' });
+    }
+    // ── VERIF-003 — method enum ───────────────────────────────────────────────
+    const method = v.method;
+    if (method === undefined || method === null) {
+        errors.push({ code: 'VERIF-001', message: 'method is required.', path: 'method' });
+    }
+    else if (!VERIFICATION_METHODS.includes(method)) {
+        errors.push({ code: 'VERIF-003', message: `method "${String(method)}" must be one of ${VERIFICATION_METHODS.join(', ')}.`, path: 'method' });
+    }
+    // ── VERIF-004 — outcome enum ──────────────────────────────────────────────
+    const outcome = v.outcome;
+    if (outcome === undefined || outcome === null) {
+        errors.push({ code: 'VERIF-001', message: 'outcome is required.', path: 'outcome' });
+    }
+    else if (!VERIFICATION_OUTCOMES.includes(outcome)) {
+        errors.push({ code: 'VERIF-004', message: `outcome "${String(outcome)}" must be one of ${VERIFICATION_OUTCOMES.join(', ')}.`, path: 'outcome' });
+    }
+    // ── VERIF-005 — canonical_ref evidence resolves ──────────────────────────
+    if (v.evidence !== undefined) {
+        if (!Array.isArray(v.evidence)) {
+            errors.push({ code: 'VERIF-001', message: 'evidence must be a list.', path: 'evidence' });
+        }
+        else {
+            v.evidence.forEach((e, i) => {
+                if (e === null || typeof e !== 'object')
+                    return;
+                const entry = e;
+                if (entry.kind !== 'canonical_ref')
+                    return;
+                const ref = entry.ref;
+                if (!typeOfId(ref)) {
+                    errors.push({ code: 'VERIF-005', message: `evidence[${i}] canonical_ref "${String(ref)}" is not a resolvable typed ID.`, path: `evidence[${i}].ref` });
+                }
+                else if (catalog && catalog.typeOf(ref) === undefined) {
+                    errors.push({ code: 'VERIF-005', message: `evidence[${i}] canonical_ref "${String(ref)}" does not resolve.`, path: `evidence[${i}].ref` });
+                }
+            });
+        }
+    }
+    // ── VERIF-006 (warning) — pass outcome with no evidence ──────────────────
+    const evidenceEmpty = !Array.isArray(v.evidence) || v.evidence.length === 0;
+    if (evidenceEmpty && outcome === 'pass') {
+        warnings.push({ code: 'VERIF-006', message: 'outcome "pass" has no evidence — an undefended positive claim.', path: 'evidence' });
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}

package/dist/versioned-attribute/index.d.ts

@@ -0,0 +1,4 @@
+export type { AttributeVersionEntry, VersionedAttributeSidecar } from './types.js';
+export { resolveAttributeValue, resolveAttributes, todayIso } from './resolve.js';
+export type { AttributeArrayFinding } from './validate.js';
+export { parseSidecar, validateAttributeArray, validateSidecar } from './validate.js';

package/dist/versioned-attribute/index.js

@@ -0,0 +1,2 @@
+export { resolveAttributeValue, resolveAttributes, todayIso } from './resolve.js';
+export { parseSidecar, validateAttributeArray, validateSidecar } from './validate.js';

package/dist/versioned-attribute/resolve.d.ts

@@ -0,0 +1,15 @@
+import type { AttributeVersionEntry, VersionedAttributeSidecar } from './types.js';
+/** Pick the entry with the largest `valid_from <= atDate`.
+ *  Returns `undefined` when no entry has taken effect yet as of `atDate`
+ *  (the attribute has not yet taken its first value — CONTRACT.md §9.2 rule
+ *  4). Returns `null` when the resolved entry is itself a gap marker
+ *  (`value: null` — attribute currently unset). */
+export declare function resolveAttributeValue(entries: AttributeVersionEntry[] | undefined, atDate: string): unknown;
+/** Resolve every attribute in a sidecar at `atDate`. An attribute with no
+ *  entry yet in effect is omitted from the result (equivalent to
+ *  `resolveAttributeValue` returning `undefined`) rather than reported as
+ *  `null`, which is reserved for an explicit gap marker. */
+export declare function resolveAttributes(sidecar: VersionedAttributeSidecar | null | undefined, atDate: string): Record<string, unknown>;
+/** Today, as a quoted-ISO-8601 date string — the default projection date
+ *  every resolver/renderer falls back to when the caller supplies none. */
+export declare function todayIso(): string;

package/dist/versioned-attribute/resolve.js

@@ -0,0 +1,37 @@
+// Current-value resolution for a versioned attribute — CONTRACT.md §9.2.
+/** Pick the entry with the largest `valid_from <= atDate`.
+ *  Returns `undefined` when no entry has taken effect yet as of `atDate`
+ *  (the attribute has not yet taken its first value — CONTRACT.md §9.2 rule
+ *  4). Returns `null` when the resolved entry is itself a gap marker
+ *  (`value: null` — attribute currently unset). */
+export function resolveAttributeValue(entries, atDate) {
+    if (!entries || entries.length === 0)
+        return undefined;
+    let best;
+    for (const entry of entries) {
+        if (entry.valid_from <= atDate && (!best || entry.valid_from > best.valid_from)) {
+            best = entry;
+        }
+    }
+    return best ? best.value : undefined;
+}
+/** Resolve every attribute in a sidecar at `atDate`. An attribute with no
+ *  entry yet in effect is omitted from the result (equivalent to
+ *  `resolveAttributeValue` returning `undefined`) rather than reported as
+ *  `null`, which is reserved for an explicit gap marker. */
+export function resolveAttributes(sidecar, atDate) {
+    const out = {};
+    if (!sidecar)
+        return out;
+    for (const name of Object.keys(sidecar.attribute_versions)) {
+        const value = resolveAttributeValue(sidecar.attribute_versions[name], atDate);
+        if (value !== undefined)
+            out[name] = value;
+    }
+    return out;
+}
+/** Today, as a quoted-ISO-8601 date string — the default projection date
+ *  every resolver/renderer falls back to when the caller supplies none. */
+export function todayIso() {
+    return new Date().toISOString().slice(0, 10);
+}

package/dist/versioned-attribute/types.d.ts

@@ -0,0 +1,12 @@
+/** One version entry in an attribute's history. `value: null` is a gap
+ *  marker — the attribute is unset from `valid_from` until the next entry. */
+export interface AttributeVersionEntry {
+    valid_from: string;
+    value: unknown;
+}
+/** A parsed sidecar document, keyed by attribute name. */
+export interface VersionedAttributeSidecar {
+    /** Canonical id of the primitive this sidecar versions. */
+    target: string;
+    attribute_versions: Record<string, AttributeVersionEntry[]>;
+}

package/dist/versioned-attribute/types.js

@@ -0,0 +1,6 @@
+// Versioned-attribute sidecar (CONTRACT.md §9) — shared shape across every
+// notation that declares a `time_varying` field. A sidecar is a co-located
+// `<primitive_id>.history.yaml` document: no `id`, no admission record, no
+// lifecycle of its own — its temporal window is governed by the target
+// primitive's own `valid_from`/`valid_to` (CONTRACT.md §9.1).
+export {};

package/dist/versioned-attribute/validate.d.ts

@@ -0,0 +1,17 @@
+import type { AttributeVersionEntry, VersionedAttributeSidecar } from './types.js';
+export interface AttributeArrayFinding {
+    code: 'VERSIONED-002' | 'VERSIONED-003' | 'VERSIONED-005';
+    severity: 'error' | 'warning';
+    message: string;
+}
+/** Parse a raw parsed-YAML mapping into a typed sidecar, or `null` if it
+ *  isn't shaped like one (missing `target` string or `attribute_versions`
+ *  map) — not every doc under `canon/elements/**` is a sidecar. */
+export declare function parseSidecar(data: Record<string, unknown> | null | undefined): VersionedAttributeSidecar | null;
+/** VERSIONED-002/003/005 for one attribute's version array.
+ *  `targetValidFrom`/`targetValidTo` bound VERSIONED-005 — pass `undefined`
+ *  for either to skip that half of the check (e.g. the target element could
+ *  not be found, which is already reported separately as VERSIONED-001). */
+export declare function validateAttributeArray(attributeName: string, entries: AttributeVersionEntry[], targetValidFrom?: string, targetValidTo?: string | null): AttributeArrayFinding[];
+/** Run VERSIONED-002/003/005 over every attribute in a parsed sidecar. */
+export declare function validateSidecar(sidecar: VersionedAttributeSidecar, targetValidFrom?: string, targetValidTo?: string | null): AttributeArrayFinding[];

package/dist/versioned-attribute/validate.js

@@ -0,0 +1,87 @@
+// Versioned-attribute sidecar validation — CONTRACT.md §9.3, `VERSIONED-00x`.
+//
+// Split by what each check needs to know:
+//   - `parseSidecar` + `validateAttributeArray` here cover VERSIONED-002/003/005,
+//     which only need the sidecar document itself (plus, for 005, the target
+//     primitive's own lifecycle window).
+//   - `VERSIONED-001` (target resolves to an admitted primitive) and
+//     `VERSIONED-004` (a time_varying field present inline on the primitive)
+//     both need cross-document knowledge — which ids exist, which notation a
+//     primitive is — that a single sidecar document doesn't carry. Those are
+//     repo-scope concerns; see `repo-validate/check-versioned-attributes.ts`.
+function isAttributeVersionEntry(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v) && typeof v['valid_from'] === 'string';
+}
+/** Parse a raw parsed-YAML mapping into a typed sidecar, or `null` if it
+ *  isn't shaped like one (missing `target` string or `attribute_versions`
+ *  map) — not every doc under `canon/elements/**` is a sidecar. */
+export function parseSidecar(data) {
+    if (!data)
+        return null;
+    const target = data['target'];
+    const attributeVersions = data['attribute_versions'];
+    if (typeof target !== 'string' || target.trim() === '')
+        return null;
+    if (typeof attributeVersions !== 'object' || attributeVersions === null || Array.isArray(attributeVersions))
+        return null;
+    const out = {};
+    for (const [name, value] of Object.entries(attributeVersions)) {
+        if (!Array.isArray(value))
+            continue;
+        out[name] = value.filter(isAttributeVersionEntry);
+    }
+    return { target, attribute_versions: out };
+}
+/** VERSIONED-002/003/005 for one attribute's version array.
+ *  `targetValidFrom`/`targetValidTo` bound VERSIONED-005 — pass `undefined`
+ *  for either to skip that half of the check (e.g. the target element could
+ *  not be found, which is already reported separately as VERSIONED-001). */
+export function validateAttributeArray(attributeName, entries, targetValidFrom, targetValidTo) {
+    const findings = [];
+    const seen = new Set();
+    let sorted = true;
+    let prev;
+    for (const entry of entries) {
+        if (seen.has(entry.valid_from)) {
+            findings.push({
+                code: 'VERSIONED-002',
+                severity: 'error',
+                message: `attribute '${attributeName}': duplicate valid_from '${entry.valid_from}'.`,
+            });
+        }
+        seen.add(entry.valid_from);
+        if (prev !== undefined && entry.valid_from < prev)
+            sorted = false;
+        prev = entry.valid_from;
+        if (targetValidFrom !== undefined && entry.valid_from < targetValidFrom) {
+            findings.push({
+                code: 'VERSIONED-005',
+                severity: 'error',
+                message: `attribute '${attributeName}': entry valid_from '${entry.valid_from}' is before the target's valid_from '${targetValidFrom}'.`,
+            });
+        }
+        if (targetValidTo !== undefined && targetValidTo !== null && entry.valid_from > targetValidTo) {
+            findings.push({
+                code: 'VERSIONED-005',
+                severity: 'error',
+                message: `attribute '${attributeName}': entry valid_from '${entry.valid_from}' is after the target's valid_to '${targetValidTo}'.`,
+            });
+        }
+    }
+    if (!sorted) {
+        findings.push({
+            code: 'VERSIONED-003',
+            severity: 'warning',
+            message: `attribute '${attributeName}': entries are not sorted by valid_from ascending.`,
+        });
+    }
+    return findings;
+}
+/** Run VERSIONED-002/003/005 over every attribute in a parsed sidecar. */
+export function validateSidecar(sidecar, targetValidFrom, targetValidTo) {
+    const findings = [];
+    for (const [name, entries] of Object.entries(sidecar.attribute_versions)) {
+        findings.push(...validateAttributeArray(name, entries, targetValidFrom, targetValidTo));
+    }
+    return findings;
+}

package/dist/webview/entry.js

@@ -28,7 +28,7 @@ import yaml from 'js-yaml';
 import { validateActivities } from '../activities/index.js';
 import { validateActivityCard } from '../activity-card/index.js';
 import { validateApplicationsCatalogue } from '../applications/index.js';
-import { validateNestedBlocks } from '../blocks/index.js';
+import { validateBlocks } from '../blocks/index.js';
 import { validateCapabilityMap } from '../capability-map/validate.js';
 import { parseCanonicalFGCA, parseCanonicalFGA } from '../fgca/parse-canonical.js';
 import { parseCanonicalGoals } from '../goals/parse-canonical.js';
@@ -40,7 +40,7 @@ import { coerceDatesToIsoStrings } from '../yaml-normalize.js';
 import { renderActivitiesSvg } from './render-activities.js';
 import { renderActivityCardSvg } from './render-activity-card.js';
 import { renderApplicationsHtml } from './render-applications.js';
-import { renderBlocksSvg } from './render-blocks.js';
+import { renderBlocksSvg, renderGridSvg } from './render-blocks.js';
 import { renderCapabilityMapHtml } from './render-capability-map.js';
 import { renderFgcaSvg } from './render-fgca.js';
 import { renderGoalsSvg } from './render-goals.js';
@@ -138,8 +138,15 @@ function dispatchValidate(kind, doc) {
             return renderFromValidation('action-card', validateActivityCard(doc), () => renderActivityCardSvg(doc));
         case 'process-blueprint':
             return renderFromValidation('process-blueprint', validateProcessBlueprint(doc), () => renderProcessBlueprintSvg(doc));
-        case 'blocks':
-            return renderFromValidation('blocks', validateNestedBlocks(doc), () => renderBlocksSvg(doc));
+        case 'blocks': {
+            // Two alternative root forms (08-blocks.md §4): a `nested_blocks:`
+            // containment tree, or a `grid:` matrix subset (§4a). `validateBlocks`
+            // is the shared root-form dispatcher (BL-020 on both/neither present);
+            // mirrors the VS Code path's `hasGrid` branch in `blocks-preview.ts`.
+            const raw = (doc && typeof doc === 'object' ? doc : {});
+            const hasGrid = raw['grid'] !== undefined && raw['grid'] !== null;
+            return renderFromValidation('blocks', validateBlocks(doc), () => hasGrid ? renderGridSvg(doc) : renderBlocksSvg(doc));
+        }
         // Catalogue notations render an HTML fragment from the header nested under
         // their top-level wrapper key (`<thing>_catalogue` / `scenario` / …).
         case 'applications':

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

@@ -8,4 +8,18 @@
  * `#transitrix-root` exactly the way it drops the goals SVG (Step 3 contract).
  */
 import type { ApplicationsCatalogueHeader } from '../applications/types.js';
-export declare function renderApplicationsHtml(catalogue: ApplicationsCatalogueHeader): string;
+import type { ResolvedApplicationAttributes } from '../applications/resolve-maturity.js';
+/**
+ * Resolved values for owner_role/vendor/maturity — sidecar-bound
+ * (CONTRACT.md §9.4) and never inline on an admitted catalogue entry
+ * (VERSIONED-004). The host resolves these upstream (see
+ * `applications/resolve-maturity.ts`) and passes the result in; this
+ * function stays a pure renderer of whatever it's given — no I/O, no
+ * write-back. `asOf` is the date the resolution ran at, shown so the view
+ * never states an undated value.
+ */
+export interface ApplicationsMaturityResolution {
+    asOf: string;
+    byAppId: Map<string, ResolvedApplicationAttributes>;
+}
+export declare function renderApplicationsHtml(catalogue: ApplicationsCatalogueHeader, resolution?: ApplicationsMaturityResolution): string;

package/dist/webview/render-applications.js

@@ -1,3 +1,4 @@
+import { withResolvedAttributes } from '../applications/resolve-maturity.js';
 import { escHtml } from './render-util.js';
 const TYPE_LABEL = {
     application: 'Application',
@@ -68,8 +69,11 @@ function renderRow(a) {
   <td class="col-owner">${a.owner_role ? escHtml(a.owner_role) : '<span class="cell-empty">—</span>'}</td>
 </tr>`;
 }
-export function renderApplicationsHtml(catalogue) {
-    const rows = catalogue.applications.map(renderRow).join('\n');
+export function renderApplicationsHtml(catalogue, resolution) {
+    const applications = resolution
+        ? catalogue.applications.map((a) => withResolvedAttributes(a, resolution.byAppId))
+        : catalogue.applications;
+    const rows = applications.map(renderRow).join('\n');
     const emptyRow = catalogue.applications.length === 0
         ? `<tr><td colspan="7" class="empty-catalogue">No applications defined.</td></tr>`
         : '';
@@ -81,6 +85,7 @@ export function renderApplicationsHtml(catalogue) {
       ${catalogue.version ? `<span class="catalogue-version">v${escHtml(catalogue.version)}</span>` : ''}
     </div>
     ${catalogue.description ? `<div class="catalogue-subtitle">${escHtml(catalogue.description)}</div>` : ''}
+    ${resolution ? `<div class="catalogue-resolved-note">Owner Role, Vendor, Maturity resolved as of ${escHtml(resolution.asOf)}</div>` : ''}
   </header>`;
     return `<section class="tx-catalogue tx-applications">
 ${header}

package/dist/webview/render-blocks.js

@@ -115,8 +115,6 @@ export function renderBlocksSvg(doc, options = {}) {
  */
 const GRID_CELL_PAD_X = 8;
 const GRID_LINE_HEIGHT = 15;
-const GRID_EMBED_CSS = `
-.blocks-grid-border { fill: none; stroke: var(--ts-border, #cbd5e1); }`;
 function centeredGridCellTextSvg(lines, cls, cx, cellTop, cellHeight) {
     const ls = lines.length > 0 ? lines : [''];
     const firstY = cellTop + cellHeight / 2 - ((ls.length - 1) / 2) * GRID_LINE_HEIGHT;
@@ -174,7 +172,11 @@ export function renderGridBody(layout, ox, oy) {
         const colLineX = ox + col.x + col.width;
         parts.push(`<line class="diagram-edge" x1="${colLineX}" y1="${gridY1}" x2="${colLineX}" y2="${gridY2}"/>`);
     }
-    parts.push(`<rect class="blocks-grid-border" x="${ox}" y="${oy}" width="${tw}" height="${th}"/>`);
+    // Explicit fill="none" alongside the class: this rect covers the full grid
+    // bounds and is the last (topmost) element emitted, so if `.blocks-grid-border`
+    // is ever missing from a host's CSS (as it was in the VS Code webview path —
+    // see the grid-preview regression), it must not fall back to SVG's default opaque black fill.
+    parts.push(`<rect class="blocks-grid-border" fill="none" x="${ox}" y="${oy}" width="${tw}" height="${th}"/>`);
     return parts.join('\n');
 }
 /** The single grid (matrix subset) SVG emitter shared by every host. */
@@ -185,7 +187,7 @@ export function renderGridLayoutSvg(layout, options = {}) {
     const ox = PAD;
     const oy = PAD + topInset;
     const body = renderGridBody(layout, ox, oy);
-    const styleLine = embedCssTheme ? `\n<style>${generateSvgEmbedCss(embedCssTheme)}${GRID_EMBED_CSS}</style>` : '';
+    const styleLine = embedCssTheme ? `\n<style>${generateSvgEmbedCss(embedCssTheme)}</style>` : '';
     return `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">${styleLine}
 ${title}
 ${body}

package/dist/webview/render-capability-map.d.ts

@@ -4,4 +4,19 @@
  * HTML fragment for the JCEF host (Step 4 of ADR 0001).
  */
 import type { CapabilityMapHeader } from '../capability-map/types.js';
-export declare function renderCapabilityMapHtml(map: CapabilityMapHeader): string;
+import type { ResolvedCapabilityAttributes } from '../capability-map/resolve-maturity.js';
+/**
+ * Resolved values for current_maturity/target_maturity/owner_role/
+ * target_date — sidecar-bound (CONTRACT.md §9.4) on the standalone
+ * CAPABILITY-* primitive a nested entry references (the 2026-08-05
+ * packages decision). The host resolves
+ * these upstream (see `capability-map/resolve-maturity.ts`) and passes the
+ * result in; this function stays a pure renderer of whatever it's given —
+ * no I/O, no write-back. `asOf` is the date the resolution ran at, shown so
+ * the view never states an undated value.
+ */
+export interface CapabilityMapMaturityResolution {
+    asOf: string;
+    byId: Map<string, ResolvedCapabilityAttributes>;
+}
+export declare function renderCapabilityMapHtml(rawMap: CapabilityMapHeader, resolution?: CapabilityMapMaturityResolution): string;

package/dist/webview/render-capability-map.js

@@ -1,3 +1,4 @@
+import { withResolvedCapabilityMap } from '../capability-map/resolve-maturity.js';
 import { escHtml } from './render-util.js';
 const MATURITY_LABEL = {
     1: 'Initial',
@@ -52,7 +53,8 @@ function renderCapabilityCard(node, depth) {
   ${childBlock}
 </div>`;
 }
-export function renderCapabilityMapHtml(map) {
+export function renderCapabilityMapHtml(rawMap, resolution) {
+    const map = resolution ? withResolvedCapabilityMap(rawMap, resolution.byId) : rawMap;
     const header = `<header class="catalogue-header">
     <div class="catalogue-title">${escHtml(map.name)}</div>
     <div class="catalogue-meta">
@@ -60,6 +62,7 @@ export function renderCapabilityMapHtml(map) {
       <span class="catalogue-updated">Assessed ${escHtml(map.assessment_date)}</span>
     </div>
     ${map.description ? `<div class="catalogue-subtitle">${escHtml(map.description)}</div>` : ''}
+    ${resolution ? `<div class="catalogue-resolved-note">Current Maturity, Target Maturity, Owner Role, Target Date resolved as of ${escHtml(resolution.asOf)}</div>` : ''}
   </header>`;
     if (map.capabilities.length === 0) {
         return `<section class="tx-catalogue tx-capability-map">

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

@@ -70,7 +70,7 @@ export interface RenderProcessOptions {
     /** Extra vertical space (px) reserved above the pool for a title block. */
     topInset?: number;
 }
-export declare const BPMN_PROCESS_CSS = "\n.bpmn-pool { fill: var(--ts-bg-surface,#f8fafc); stroke: var(--ts-node-stroke,#004d67); stroke-width: 1.5; }\n.bpmn-pool-name { fill: var(--ts-bg-elevated,#f1f5f9); stroke: var(--ts-node-stroke,#004d67); stroke-width: 0.75; }\n.bpmn-lane { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 0.75; }\n.bpmn-lane-header { fill: var(--ts-bg-elevated,#f1f5f9); stroke: var(--ts-node-stroke,#004d67); stroke-width: 0.75; }\n.bpmn-pool-label { fill: var(--ts-text-primary,#0d2b35); font-size: 11px; font-weight: 700; }\n.bpmn-lane-label { fill: var(--ts-text-primary,#0d2b35); font-size: 11px; font-weight: 600; }\n.bpmn-task { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 1.5; }\n.bpmn-task-name { fill: var(--ts-text-primary,#0d2b35); font-size: 11px; text-anchor: middle; }\n.bpmn-event { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); }\n.bpmn-event-start { stroke-width: 1.5; }\n.bpmn-event-end { stroke-width: 4; }\n.bpmn-event-label { fill: var(--ts-text-secondary,#516970); font-size: 10px; text-anchor: middle; }\n.bpmn-gateway { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 1.5; }\n.bpmn-gateway-marker { stroke: var(--ts-node-stroke,#004d67); stroke-width: 2.5; stroke-linecap: round; fill: none; }\n.bpmn-gateway-label { fill: var(--ts-text-secondary,#516970); font-size: 10px; text-anchor: middle; }\n.bpmn-seq-flow { fill: none; stroke: var(--ts-edge-stroke,#004d67); stroke-width: 1.5; }\n.bpmn-default-mark { stroke: var(--ts-edge-stroke,#004d67); stroke-width: 1.5; stroke-linecap: round; }\n.bpmn-assoc { fill: none; stroke: var(--ts-edge-stroke,#004d67); stroke-width: 1; stroke-dasharray: 4 2; }\n.bpmn-data-obj { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 1; }\n.bpmn-data-obj-label { fill: var(--ts-text-secondary,#516970); font-size: 10px; text-anchor: middle; }\n.bpmn-event-intermediate { fill: none; stroke: var(--ts-node-stroke,#004d67); stroke-width: 1; }\n.bpmn-event-icon { fill: none; stroke: var(--ts-node-stroke,#004d67); stroke-width: 1.5; stroke-linecap: round; stroke-linejoin: round; }\n";
+export declare const BPMN_PROCESS_CSS = "\n.bpmn-pool { fill: var(--ts-bg-surface,#f8fafc); stroke: var(--ts-node-stroke,#004d67); stroke-width: 1.5; }\n.bpmn-pool-name { fill: var(--ts-bg-elevated,#f1f5f9); stroke: var(--ts-node-stroke,#004d67); stroke-width: 0.75; }\n.bpmn-lane { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 0.75; }\n.bpmn-lane-header { fill: var(--ts-bg-elevated,#f1f5f9); stroke: var(--ts-node-stroke,#004d67); stroke-width: 0.75; }\n.bpmn-pool-label { fill: var(--ts-text-primary,#0d2b35); font-family: var(--vscode-font-family, system-ui, -apple-system, sans-serif); font-size: 11px; font-weight: 700; }\n.bpmn-lane-label { fill: var(--ts-text-primary,#0d2b35); font-family: var(--vscode-font-family, system-ui, -apple-system, sans-serif); font-size: 11px; font-weight: 600; }\n.bpmn-task { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 1.5; }\n.bpmn-task-name { fill: var(--ts-text-primary,#0d2b35); font-family: var(--vscode-font-family, system-ui, -apple-system, sans-serif); font-size: 11px; text-anchor: middle; }\n.bpmn-event { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); }\n.bpmn-event-start { stroke-width: 1.5; }\n.bpmn-event-end { stroke-width: 4; }\n.bpmn-event-label { fill: var(--ts-text-secondary,#516970); font-family: var(--vscode-font-family, system-ui, -apple-system, sans-serif); font-size: 10px; text-anchor: middle; }\n.bpmn-gateway { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 1.5; }\n.bpmn-gateway-marker { stroke: var(--ts-node-stroke,#004d67); stroke-width: 2.5; stroke-linecap: round; fill: none; }\n.bpmn-gateway-label { fill: var(--ts-text-secondary,#516970); font-family: var(--vscode-font-family, system-ui, -apple-system, sans-serif); font-size: 10px; text-anchor: middle; }\n.bpmn-seq-flow { fill: none; stroke: var(--ts-edge-stroke,#004d67); stroke-width: 1.5; }\n.bpmn-default-mark { stroke: var(--ts-edge-stroke,#004d67); stroke-width: 1.5; stroke-linecap: round; }\n.bpmn-assoc { fill: none; stroke: var(--ts-edge-stroke,#004d67); stroke-width: 1; stroke-dasharray: 4 2; }\n.bpmn-data-obj { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 1; }\n.bpmn-data-obj-label { fill: var(--ts-text-secondary,#516970); font-size: 10px; text-anchor: middle; }\n.bpmn-event-intermediate { fill: none; stroke: var(--ts-node-stroke,#004d67); stroke-width: 1; }\n.bpmn-event-icon { fill: none; stroke: var(--ts-node-stroke,#004d67); stroke-width: 1.5; stroke-linecap: round; stroke-linejoin: round; }\n";
 /**
  * Canonical body emitter, shared by every host (VS Code, JCEF, static export).
  *

package/dist/webview/render-process.js

@@ -39,17 +39,17 @@ export const BPMN_PROCESS_CSS = `
 .bpmn-pool-name { fill: var(--ts-bg-elevated,#f1f5f9); stroke: var(--ts-node-stroke,#004d67); stroke-width: 0.75; }
 .bpmn-lane { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 0.75; }
 .bpmn-lane-header { fill: var(--ts-bg-elevated,#f1f5f9); stroke: var(--ts-node-stroke,#004d67); stroke-width: 0.75; }
-.bpmn-pool-label { fill: var(--ts-text-primary,#0d2b35); font-size: 11px; font-weight: 700; }
-.bpmn-lane-label { fill: var(--ts-text-primary,#0d2b35); font-size: 11px; font-weight: 600; }
+.bpmn-pool-label { fill: var(--ts-text-primary,#0d2b35); font-family: var(--vscode-font-family, system-ui, -apple-system, sans-serif); font-size: 11px; font-weight: 700; }
+.bpmn-lane-label { fill: var(--ts-text-primary,#0d2b35); font-family: var(--vscode-font-family, system-ui, -apple-system, sans-serif); font-size: 11px; font-weight: 600; }
 .bpmn-task { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 1.5; }
-.bpmn-task-name { fill: var(--ts-text-primary,#0d2b35); font-size: 11px; text-anchor: middle; }
+.bpmn-task-name { fill: var(--ts-text-primary,#0d2b35); font-family: var(--vscode-font-family, system-ui, -apple-system, sans-serif); font-size: 11px; text-anchor: middle; }
 .bpmn-event { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); }
 .bpmn-event-start { stroke-width: 1.5; }
 .bpmn-event-end { stroke-width: 4; }
-.bpmn-event-label { fill: var(--ts-text-secondary,#516970); font-size: 10px; text-anchor: middle; }
+.bpmn-event-label { fill: var(--ts-text-secondary,#516970); font-family: var(--vscode-font-family, system-ui, -apple-system, sans-serif); font-size: 10px; text-anchor: middle; }
 .bpmn-gateway { fill: var(--ts-bg,#ffffff); stroke: var(--ts-node-stroke,#004d67); stroke-width: 1.5; }
 .bpmn-gateway-marker { stroke: var(--ts-node-stroke,#004d67); stroke-width: 2.5; stroke-linecap: round; fill: none; }
-.bpmn-gateway-label { fill: var(--ts-text-secondary,#516970); font-size: 10px; text-anchor: middle; }
+.bpmn-gateway-label { fill: var(--ts-text-secondary,#516970); font-family: var(--vscode-font-family, system-ui, -apple-system, sans-serif); font-size: 10px; text-anchor: middle; }
 .bpmn-seq-flow { fill: none; stroke: var(--ts-edge-stroke,#004d67); stroke-width: 1.5; }
 .bpmn-default-mark { stroke: var(--ts-edge-stroke,#004d67); stroke-width: 1.5; stroke-linecap: round; }
 .bpmn-assoc { fill: none; stroke: var(--ts-edge-stroke,#004d67); stroke-width: 1; stroke-dasharray: 4 2; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@transitrix/diagrams",
-  "version": "1.8.21",
+  "version": "1.10.0",
   "type": "module",
   "description": "Shared rendering, validation, and pure mutations for Transitrix custom diagram formats.",
   "license": "MIT",
@@ -15,6 +15,9 @@
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "engines": {
+    "node": ">=20"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -51,13 +54,13 @@
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
-    "@types/react": "^18.3.28",
-    "@types/react-dom": "^19.2.3",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.4",
     "jsdom": "^29.1.1",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
     "reactflow": "^11.11.4",
     "typescript": "^5.0.0",
-    "vitest": "^3.0.0"
+    "vitest": "^4.1.10"
   }
 }

package/src/activity-card/types.ts

@@ -1,7 +1,7 @@
 // Activity Card notation — single-project narrative view.
 //
 // Spec: transitrix/methodology `notations/views/18-activity-card.md` (v0.1).
-// Epic vkgeorgia/strategy#97, Studio track #134.
+// Studio track #134.
 //
 // The Activity Card is the first MULTI-DOCUMENT Studio notation. The card
 // YAML itself holds only `id`, `project` (an Activity ID), `description`,