@transitrix/diagrams 1.0.0 → 1.0.1

package/dist/compliance/__tests__/impact.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect } from 'vitest';
 import { emptyCanon } from '../classify.js';
-import { buildImpactMatrix, renderImpactMarkdown, parseImpactViewConfig, COMPLIANCE_IMPACT_DEFAULTS, extractObjectDetails, computeDeadlineStatus, } from '../impact.js';
+import { buildImpactMatrix, renderImpactMarkdown, parseImpactViewConfig, COMPLIANCE_IMPACT_DEFAULTS, extractObjectDetails, extractProcessFlowTasks, mergeStageTaskDetails, computeDeadlineStatus, } from '../impact.js';
 // Industry- and regime-agnostic synthetic fixture: opaque ids only, no real
 // regulator / product names, per #166 acceptance ("Output is aggregates only —
 // no subject/obligation names tied to any real corpus").
@@ -160,6 +160,94 @@ describe('renderImpactMarkdown', () => {
         const md = renderImpactMarkdown(matrix);
         expect(md).toContain('Report snapshot: 2026-06-09');
     });
+    it('resolves capability subject names from canon.subjects', () => {
+        const canon = emptyCanon();
+        canon.subjects.push({ id: 'CAPABILITY-CRM-1', name: 'CRM Platform' });
+        canon.requirements.push({ id: 'REQUIREMENT-FOO-1', name: 'Foo' });
+        canon.assertions.push({
+            id: 'ASSERTION-1',
+            about: 'REQUIREMENT-FOO-1',
+            subject: 'CAPABILITY-CRM-1',
+            status: 'compliant',
+        });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V-1', name: 'Test',
+            subjects: { capabilities: ['CAPABILITY-CRM-1'] },
+            obligations: {},
+        });
+        expect(matrix.columns[0].subjectId).toBe('CAPABILITY-CRM-1');
+        expect(matrix.columns[0].subjectName).toBe('CRM Platform');
+        expect(matrix.cells[0][0].status).toBe('compliant');
+    });
+    it('resolves process subject names from canon.subjects', () => {
+        const canon = emptyCanon();
+        canon.subjects.push({ id: 'PROCESS-CS-1', name: 'Customer Support' });
+        canon.requirements.push({ id: 'REQUIREMENT-BAR-1', name: 'Bar' });
+        canon.assertions.push({
+            id: 'ASSERTION-P1',
+            about: 'REQUIREMENT-BAR-1',
+            subject: 'PROCESS-CS-1',
+            status: 'partial',
+        });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V-2', name: 'Test',
+            subjects: { processes: ['PROCESS-CS-1'] },
+            obligations: {},
+        });
+        expect(matrix.columns[0].subjectName).toBe('Customer Support');
+        expect(matrix.cells[0][0].status).toBe('partial');
+    });
+    it('mixed product + capability columns — names resolved from respective buckets', () => {
+        const canon = buildCanon();
+        canon.subjects.push({ id: 'CAPABILITY-CRM-1', name: 'CRM' });
+        canon.requirements.push({ id: 'REQUIREMENT-CRM-1', name: 'CRM req' });
+        canon.assertions.push({
+            id: 'ASSERTION-CRM-1',
+            about: 'REQUIREMENT-CRM-1',
+            subject: 'CAPABILITY-CRM-1',
+            status: 'under_review',
+        });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V-3', name: 'Mixed',
+            subjects: { products: ['PRODUCT-A-1'], capabilities: ['CAPABILITY-CRM-1'] },
+            obligations: {},
+        });
+        expect(matrix.columns.map(c => c.subjectId)).toEqual(['PRODUCT-A-1', 'CAPABILITY-CRM-1']);
+        expect(matrix.columns[0].subjectName).toBe('Product A');
+        expect(matrix.columns[1].subjectName).toBe('CRM');
+    });
+    it('pending_owner cell renders as bound with PENDING status', () => {
+        const canon = emptyCanon();
+        canon.products.push({ id: 'PRODUCT-A-1', name: 'Product A' });
+        canon.requirements.push({ id: 'REQUIREMENT-PO-1', name: 'PO req' });
+        canon.assertions.push({
+            id: 'ASSERTION-PO-1',
+            about: 'REQUIREMENT-PO-1',
+            subject: 'PRODUCT-A-1',
+            status: 'pending_owner',
+            owner_to_confirm: 'alice@example.com',
+        });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V-PO', name: 'PO Test',
+            subjects: { products: ['PRODUCT-A-1'] },
+            obligations: {},
+        });
+        expect(matrix.cells[0][0].kind).toBe('bound');
+        expect(matrix.cells[0][0].status).toBe('pending_owner');
+        expect(matrix.cells[0][0].assertions[0].owner_to_confirm).toBe('alice@example.com');
+    });
+    it('pending_owner loses to partial in aggregation', () => {
+        const canon = emptyCanon();
+        canon.products.push({ id: 'PRODUCT-A-1', name: 'Product A' });
+        canon.requirements.push({ id: 'REQUIREMENT-PO-2', name: 'PO req 2' });
+        canon.assertions.push({ id: 'ASSERTION-PO-2a', about: 'REQUIREMENT-PO-2', subject: 'PRODUCT-A-1', status: 'partial' }, { id: 'ASSERTION-PO-2b', about: 'REQUIREMENT-PO-2', subject: 'PRODUCT-A-1', status: 'pending_owner' });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V-PO2', name: 'PO Agg',
+            subjects: { products: ['PRODUCT-A-1'] },
+            obligations: {},
+        });
+        expect(matrix.cells[0][0].status).toBe('partial');
+    });
 });
 // ── parseImpactViewConfig ───────────────────────────────────────────────────
 describe('parseImpactViewConfig', () => {
@@ -193,6 +281,7 @@ describe('parseImpactViewConfig', () => {
         const c = r.config;
         expect(c.subjects.products).toEqual([]);
         expect(c.subjects.processes).toEqual([]);
+        expect(c.subjects.capabilities).toEqual([]);
         expect(c.status_display?.show).toEqual(COMPLIANCE_IMPACT_DEFAULTS.status_display.show);
         expect(c.order_rows_by).toBe('id');
         expect(c.empty_cells?.no_obligation_label).toBe(COMPLIANCE_IMPACT_DEFAULTS.empty_cells.no_obligation_label);
@@ -239,7 +328,7 @@ describe('CV-3a — stage grouping (ImpactColumn, extractObjectDetails, buildImp
     });
     it('product-stage grain: expands columns by stage, label is subjectId:stageId', () => {
         const canon = buildCanon();
-        const matrix = buildImpactMatrix(canon, { ...baseConfig, subjects: { products: ['PRODUCT-A-1'] }, grouping: { columns: 'object-details' } }, [{ objectId: 'PRODUCT-A-1', details: [{ id: 'STAGE-1', name: 'Stage One' }, { id: 'STAGE-2', name: 'Stage Two' }] }]);
+        const matrix = buildImpactMatrix(canon, { ...baseConfig, subjects: { products: ['PRODUCT-A-1'] }, grouping: { columns: 'product-stage' } }, [{ objectId: 'PRODUCT-A-1', details: [{ id: 'STAGE-1', name: 'Stage One' }, { id: 'STAGE-2', name: 'Stage Two' }] }]);
         expect(matrix.columns.map(c => c.label)).toEqual(['PRODUCT-A-1:STAGE-1', 'PRODUCT-A-1:STAGE-2']);
         expect(matrix.columns.map(c => c.stageId)).toEqual(['STAGE-1', 'STAGE-2']);
     });
@@ -252,7 +341,7 @@ describe('CV-3a — stage grouping (ImpactColumn, extractObjectDetails, buildImp
             id: 'V', name: 'V',
             subjects: { products: ['PROD-1'] },
             obligations: {},
-            grouping: { columns: 'object-details' },
+            grouping: { columns: 'product-stage' },
         }, [{ objectId: 'PROD-1', details: [{ id: 'S1', name: 's1' }, { id: 'S2', name: 's2' }] }]);
         // Both stage columns should be bound (no realised_via means all stages inherit).
         expect(matrix.cells[0][0].kind).toBe('bound');
@@ -270,7 +359,7 @@ describe('CV-3a — stage grouping (ImpactColumn, extractObjectDetails, buildImp
             id: 'V', name: 'V',
             subjects: { products: ['PROD-1'] },
             obligations: {},
-            grouping: { columns: 'object-details' },
+            grouping: { columns: 'product-stage' },
         }, [{ objectId: 'PROD-1', details: [{ id: 'STAGE-A', name: 'a' }, { id: 'STAGE-B', name: 'b' }] }]);
         expect(matrix.cells[0][0].kind).toBe('bound'); // STAGE-A: covered
         expect(matrix.cells[0][1].kind).toBe('gap'); // STAGE-B: gap
@@ -280,7 +369,7 @@ describe('CV-3a — stage grouping (ImpactColumn, extractObjectDetails, buildImp
         const matrix = buildImpactMatrix(canon, {
             ...baseConfig,
             subjects: { products: ['PRODUCT-A-1', 'PRODUCT-B-1'] },
-            grouping: { columns: 'object-details' },
+            grouping: { columns: 'product-stage' },
         }, 
         // Only provide stages for A — B falls back to a single column.
         [{ objectId: 'PRODUCT-A-1', details: [{ id: 'S1', name: 's1' }] }]);
@@ -308,7 +397,7 @@ describe('CV-3a — stage grouping (ImpactColumn, extractObjectDetails, buildImp
             id: 'V', name: 'Stage Report',
             subjects: { products: ['PROD-1'] },
             obligations: {},
-            grouping: { columns: 'object-details' },
+            grouping: { columns: 'product-stage' },
         }, [{ objectId: 'PROD-1', details: [{ id: 'S1', name: 'Stage One' }] }]);
         const md = renderImpactMarkdown(matrix);
         expect(md).toContain('PROD-1:S1');
@@ -408,3 +497,219 @@ describe('computeDeadlineStatus', () => {
         expect(computeDeadlineStatus('2026-12-31', '2026-06-01')).toBe('upcoming');
     });
 });
+// ── parseImpactViewConfig — grouping field ────────────────────────────────────
+describe('parseImpactViewConfig — grouping field', () => {
+    it('parses grouping.columns: product-stage', () => {
+        const r = parseImpactViewConfig({ id: 'V', name: 'V', subjects: {}, grouping: { columns: 'product-stage' } });
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.config.grouping?.columns).toBe('product-stage');
+    });
+    it('parses grouping.columns: product-stage-task', () => {
+        const r = parseImpactViewConfig({ id: 'V', name: 'V', subjects: {}, grouping: { columns: 'product-stage-task' } });
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.config.grouping?.columns).toBe('product-stage-task');
+    });
+    it('parses grouping.columns: product (coarsest grain)', () => {
+        const r = parseImpactViewConfig({ id: 'V', name: 'V', subjects: {}, grouping: { columns: 'product' } });
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.config.grouping?.columns).toBe('product');
+    });
+    it('normalises backward-compat alias object-details → product-stage', () => {
+        const r = parseImpactViewConfig({ id: 'V', name: 'V', subjects: {}, grouping: { columns: 'object-details' } });
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.config.grouping?.columns).toBe('product-stage');
+    });
+    it('normalises backward-compat alias object → product', () => {
+        const r = parseImpactViewConfig({ id: 'V', name: 'V', subjects: {}, grouping: { columns: 'object' } });
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.config.grouping?.columns).toBe('product');
+    });
+    it('leaves grouping undefined when the field is absent', () => {
+        const r = parseImpactViewConfig({ id: 'V', name: 'V', subjects: {} });
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.config.grouping).toBeUndefined();
+    });
+    it('leaves grouping undefined for an unrecognised columns value', () => {
+        const r = parseImpactViewConfig({ id: 'V', name: 'V', subjects: {}, grouping: { columns: 'unknown-grain' } });
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.config.grouping).toBeUndefined();
+    });
+});
+// ── CV-3a — product-stage-task grain ─────────────────────────────────────────
+describe('CV-3a — product-stage-task grain (buildImpactMatrix, buildTaskColumns)', () => {
+    it('expands columns to (subject, stage, task) triples; label is subjectId:stageId:taskId', () => {
+        const canon = emptyCanon();
+        canon.requirements.push({ id: 'REQ-1', name: 'R1' });
+        canon.assertions.push({ id: 'ASS-1', about: 'REQ-1', subject: 'PROD-1', status: 'compliant' });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V', name: 'V',
+            subjects: { products: ['PROD-1'] },
+            obligations: {},
+            grouping: { columns: 'product-stage-task' },
+        }, [{
+                objectId: 'PROD-1',
+                details: [
+                    { id: 'STAGE-A', name: 'Stage A', tasks: [{ id: 'TASK-1', name: 'Task 1' }, { id: 'TASK-2', name: 'Task 2' }] },
+                ],
+            }]);
+        expect(matrix.columns.map(c => c.label)).toEqual(['PROD-1:STAGE-A:TASK-1', 'PROD-1:STAGE-A:TASK-2']);
+        expect(matrix.columns[0]).toMatchObject({ subjectId: 'PROD-1', stageId: 'STAGE-A', taskId: 'TASK-1' });
+        expect(matrix.columns[1]).toMatchObject({ subjectId: 'PROD-1', stageId: 'STAGE-A', taskId: 'TASK-2' });
+    });
+    it('assertion without realised_via fills every task column for its subject', () => {
+        const canon = emptyCanon();
+        canon.requirements.push({ id: 'REQ-1', name: 'R1' });
+        canon.assertions.push({ id: 'ASS-1', about: 'REQ-1', subject: 'PROD-1', status: 'compliant' });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V', name: 'V',
+            subjects: { products: ['PROD-1'] },
+            obligations: {},
+            grouping: { columns: 'product-stage-task' },
+        }, [{ objectId: 'PROD-1', details: [{ id: 'S1', name: 's1', tasks: [{ id: 'T1', name: 't1' }, { id: 'T2', name: 't2' }] }] }]);
+        expect(matrix.cells[0][0].kind).toBe('bound');
+        expect(matrix.cells[0][1].kind).toBe('bound');
+    });
+    it('assertion with realised_via: [taskId] fills only the matching task column', () => {
+        const canon = emptyCanon();
+        canon.requirements.push({ id: 'REQ-1', name: 'R1' });
+        canon.assertions.push({ id: 'ASS-1', about: 'REQ-1', subject: 'PROD-1', status: 'compliant', realised_via: ['T1'] });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V', name: 'V',
+            subjects: { products: ['PROD-1'] },
+            obligations: {},
+            grouping: { columns: 'product-stage-task' },
+        }, [{ objectId: 'PROD-1', details: [{ id: 'S1', name: 's1', tasks: [{ id: 'T1', name: 't1' }, { id: 'T2', name: 't2' }] }] }]);
+        expect(matrix.cells[0][0].kind).toBe('bound'); // T1: covered
+        expect(matrix.cells[0][1].kind).toBe('gap'); // T2: not covered
+    });
+    it('assertion with realised_via: [stageId] fills all task columns in that stage', () => {
+        const canon = emptyCanon();
+        canon.requirements.push({ id: 'REQ-1', name: 'R1' });
+        canon.assertions.push({ id: 'ASS-1', about: 'REQ-1', subject: 'PROD-1', status: 'compliant', realised_via: ['S1'] });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V', name: 'V',
+            subjects: { products: ['PROD-1'] },
+            obligations: {},
+            grouping: { columns: 'product-stage-task' },
+        }, [{ objectId: 'PROD-1', details: [{ id: 'S1', name: 's1', tasks: [{ id: 'T1', name: 't1' }, { id: 'T2', name: 't2' }] }] }]);
+        expect(matrix.cells[0][0].kind).toBe('bound');
+        expect(matrix.cells[0][1].kind).toBe('bound');
+    });
+    it('stage with no tasks falls back to stage-grain column', () => {
+        const canon = emptyCanon();
+        canon.requirements.push({ id: 'REQ-1', name: 'R1' });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V', name: 'V',
+            subjects: { products: ['PROD-1'] },
+            obligations: {},
+            grouping: { columns: 'product-stage-task' },
+        }, [{ objectId: 'PROD-1', details: [{ id: 'S1', name: 's1' }] }]);
+        expect(matrix.columns.map(c => c.label)).toEqual(['PROD-1:S1']);
+        expect(matrix.columns[0].taskId).toBeUndefined();
+        expect(matrix.columns[0].stageId).toBe('S1');
+    });
+    it('subject with no objectDetails falls back to product-grain column', () => {
+        const canon = emptyCanon();
+        canon.requirements.push({ id: 'REQ-1', name: 'R1' });
+        const matrix = buildImpactMatrix(canon, {
+            id: 'V', name: 'V',
+            subjects: { products: ['PROD-1'] },
+            obligations: {},
+            grouping: { columns: 'product-stage-task' },
+        });
+        expect(matrix.columns.map(c => c.label)).toEqual(['PROD-1']);
+        expect(matrix.columns[0].stageId).toBeUndefined();
+    });
+});
+// ── extractProcessFlowTasks ───────────────────────────────────────────────────
+describe('extractProcessFlowTasks', () => {
+    it('returns null for non-process documents', () => {
+        expect(extractProcessFlowTasks(null)).toBeNull();
+        expect(extractProcessFlowTasks({ notation: 'requirement', id: 'R1' })).toBeNull();
+        expect(extractProcessFlowTasks({ notation: 'process_blueprint', id: 'BP-1' })).toBeNull();
+    });
+    it('returns null when process has no flow.steps', () => {
+        expect(extractProcessFlowTasks({ notation: 'process', id: 'PROC-1' })).toBeNull();
+        expect(extractProcessFlowTasks({ notation: 'process', id: 'PROC-1', flow: { sequence: [] } })).toBeNull();
+    });
+    it('returns null when no task-type steps exist', () => {
+        const doc = {
+            notation: 'process', id: 'PROC-1',
+            flow: { steps: [
+                    { id: 'S-1', type: 'startEvent' },
+                    { id: 'G-1', type: 'exclusiveGateway' },
+                    { id: 'E-1', type: 'endEvent' },
+                ] },
+        };
+        expect(extractProcessFlowTasks(doc)).toBeNull();
+    });
+    it('extracts task-type steps and skips events/gateways', () => {
+        const doc = {
+            notation: 'process', id: 'PROC-1',
+            flow: { steps: [
+                    { id: 'S-1', type: 'startEvent' },
+                    { id: 'STEP-T1', type: 'task', name: 'Task One' },
+                    { id: 'G-1', type: 'exclusiveGateway', name: 'Branch?' },
+                    { id: 'STEP-T2', type: 'userTask', name: 'User Task' },
+                    { id: 'E-1', type: 'endEvent' },
+                ] },
+        };
+        const result = extractProcessFlowTasks(doc);
+        expect(result).not.toBeNull();
+        expect(result.objectId).toBe('PROC-1');
+        expect(result.details.map(d => d.id)).toEqual(['STEP-T1', 'STEP-T2']);
+        expect(result.details[0].name).toBe('Task One');
+    });
+    it('falls back to step id as name when name is absent', () => {
+        const doc = {
+            notation: 'process', id: 'PROC-1',
+            flow: { steps: [{ id: 'STEP-T1', type: 'serviceTask' }] },
+        };
+        const result = extractProcessFlowTasks(doc);
+        expect(result.details[0].name).toBe('STEP-T1');
+    });
+});
+// ── mergeStageTaskDetails ─────────────────────────────────────────────────────
+describe('mergeStageTaskDetails', () => {
+    const stages = {
+        objectId: 'PROC-1',
+        details: [
+            { id: 'S1', name: 'Stage 1' },
+            { id: 'S2', name: 'Stage 2' },
+        ],
+    };
+    it('returns stageInput unchanged when taskInput is null', () => {
+        expect(mergeStageTaskDetails(stages, null)).toBe(stages);
+    });
+    it('returns stageInput unchanged when objectIds do not match', () => {
+        const other = { objectId: 'PROC-99', details: [{ id: 'T1', name: 't1' }] };
+        expect(mergeStageTaskDetails(stages, other)).toBe(stages);
+    });
+    it('embeds all tasks into every stage when no stageOwner map is provided', () => {
+        const tasks = { objectId: 'PROC-1', details: [{ id: 'T1', name: 't1' }, { id: 'T2', name: 't2' }] };
+        const merged = mergeStageTaskDetails(stages, tasks);
+        expect(merged.objectId).toBe('PROC-1');
+        expect(merged.details[0].tasks?.map(t => t.id)).toEqual(['T1', 'T2']);
+        expect(merged.details[1].tasks?.map(t => t.id)).toEqual(['T1', 'T2']);
+    });
+    it('distributes tasks by stageOwner map', () => {
+        const tasks = { objectId: 'PROC-1', details: [{ id: 'T1', name: 't1' }, { id: 'T2', name: 't2' }] };
+        const merged = mergeStageTaskDetails(stages, tasks, { S1: ['T1'], S2: ['T2'] });
+        expect(merged.details[0].tasks?.map(t => t.id)).toEqual(['T1']);
+        expect(merged.details[1].tasks?.map(t => t.id)).toEqual(['T2']);
+    });
+    it('leaves stages without matching stageOwner entries task-free', () => {
+        const tasks = { objectId: 'PROC-1', details: [{ id: 'T1', name: 't1' }] };
+        const merged = mergeStageTaskDetails(stages, tasks, { S1: ['T1'], S2: [] });
+        expect(merged.details[0].tasks?.map(t => t.id)).toEqual(['T1']);
+        // S2 has no tasks in stageOwner, filter returns [] → no tasks embedded
+        expect(merged.details[1].tasks).toBeUndefined();
+    });
+});

package/dist/compliance/classify.d.ts

@@ -15,6 +15,12 @@ export interface ComplianceCanon {
     requirements: IndexRequirement[];
     assertions: IndexAssertion[];
     codex: ComplianceCodexDoc[];
+    /**
+     * Named elements that can serve as assertion subjects beyond `products`:
+     * capabilities, processes, applications, and systems. Populated by
+     * `ingestComplianceDoc` for the corresponding notation values.
+     */
+    subjects: ComplianceProduct[];
 }
 export declare function emptyCanon(): ComplianceCanon;
 /**

package/dist/compliance/classify.js

@@ -3,7 +3,7 @@
 // (webview previews) and the CLI scan (`export-compliance`), so the recognition
 // rules live once. Pure: takes a parsed YAML document, no IO.
 export function emptyCanon() {
-    return { products: [], requirements: [], assertions: [], codex: [] };
+    return { products: [], requirements: [], assertions: [], codex: [], subjects: [] };
 }
 const str = (v) => (typeof v === 'string' ? v : undefined);
 const strArray = (v) => Array.isArray(v) ? v.filter((x) => typeof x === 'string') : undefined;
@@ -25,6 +25,13 @@ export function ingestComplianceDoc(canon, doc) {
         canon.products.push({ id, name: str(d.name) ?? id });
         return id;
     }
+    if (d.notation === 'capability' ||
+        d.notation === 'process' ||
+        d.notation === 'application' ||
+        d.notation === 'system') {
+        canon.subjects.push({ id, name: str(d.name) ?? id });
+        return id;
+    }
     if (d.notation === 'requirement') {
         canon.requirements.push({
             id,
@@ -49,6 +56,7 @@ export function ingestComplianceDoc(canon, doc) {
             evidenceCount: Array.isArray(d.evidence) ? d.evidence.length : 0,
             admitted_at: str(d.admitted_at),
             realised_via: strArray(d.realised_via),
+            owner_to_confirm: str(d.owner_to_confirm),
         });
         return id;
     }

package/dist/compliance/coverage-metric.d.ts

@@ -1,12 +1,22 @@
 import type { ComplianceCanon } from './classify.js';
+/** Declarative filter resolved at build time from the canon's codex catalogue. */
+export interface CoverageMetricRegimesFilter {
+    jurisdiction?: string[];
+    codex_type?: string[];
+}
+/**
+ * Regime (codex) selection for the coverage view.
+ * - `include`: explicit list of codex IDs — takes precedence over `filter`.
+ * - `filter`: resolved against the workspace canon at render time.
+ * - Omit entirely → all codex artefacts in the canon become regime columns.
+ */
+export interface CoverageMetricRegimes {
+    include?: string[];
+    filter?: CoverageMetricRegimesFilter;
+}
 export interface CoverageMetricSubjects {
     products?: string[];
 }
-export interface CoverageMetricScope {
-    jurisdictions?: string[];
-    codex?: string[];
-    subjects?: CoverageMetricSubjects;
-}
 export interface CoverageMetricThresholds {
     /** Coverage fraction (0–1) at or above which the status is green. */
     green: number;
@@ -19,8 +29,13 @@ export interface CoverageMetricConfig {
     description?: string;
     date?: string;
     version?: string;
-    scope: CoverageMetricScope;
+    /** Regime (codex) selection. Absent = all canon codex entries. */
+    regimes?: CoverageMetricRegimes;
+    /** Products to scope assertions to. Absent = all products. */
+    subjects?: CoverageMetricSubjects;
     thresholds: CoverageMetricThresholds;
+    /** Non-fatal parse warnings (e.g. deprecated keys). */
+    warnings?: string[];
 }
 export type ParseCoverageMetricResult = {
     ok: true;
@@ -39,6 +54,8 @@ export interface CoverageRow {
     partial: number;
     non_compliant: number;
     under_review: number;
+    /** Requirements with at least one pending-owner assertion and no stronger binding. */
+    pending_owner: number;
     /** Requirements with no admitted assertion for the scoped products. */
     gap: number;
     /** compliant + partial. */
@@ -57,17 +74,20 @@ export interface CoverageMatrix {
     thresholds: CoverageMetricThresholds;
 }
 /**
- * Validate and normalise a raw (YAML-parsed) document into a
- * `CoverageMetricConfig`. Accepts both the bare top-level object and the
- * wrapped form (`{ coverage_metric: { … } }`).
+ * Parse and validate a raw (YAML-parsed) document into a `CoverageMetricConfig`.
+ *
+ * Accepts:
+ * - `{ view: { id, name, regimes, subjects, thresholds } }` — canonical (new spec)
+ * - `{ coverage_metric: { … } }` — deprecated; `scope.codex` → `regimes.include`
+ * - Bare top-level object — same as deprecated wrapper, no wrapper warning
  */
 export declare function parseCoverageMetricConfig(raw: unknown): ParseCoverageMetricResult;
 /**
  * Compute per-codex coverage statistics.
  *
- * For each law (codex ID) in `config.scope.codex`:
+ * For each law (codex ID) resolved from `config.regimes`:
  *  - Collect requirements whose `derived_from` includes that law.
- *  - Optionally restrict to assertions for `config.scope.subjects.products`.
+ *  - Optionally restrict to assertions for `config.subjects.products`.
  *  - Compute compliant / partial / non_compliant / under_review / gap counts.
  *  - Compute coverage % = (compliant + partial) / total and apply RAG.
  */