@besales/ops-framework 0.1.16 → 0.1.17

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.1.17
+
+- Broadened the schema compatibility gate so it blocks any schema/foundation requirement that omits fields required by approved dependent requirements, even when the schema text is not written as an explicit closed list.
+- Expanded the schema gate action to call out `person_aliases` or alias storage plus required `meetings.*` fields for track classification and speaker resolution.
+
 ## 0.1.16
 
 - Added a schema compatibility readiness gate that blocks planning when a closed/minimal schema requirement does not support dependent approved requirements such as speaker resolution, aliases and meeting track classification.

package/bin/initiative.mjs

@@ -1126,14 +1126,15 @@ function addSchemaCompatibilityGate({ gates, sourceText, requirements }) {
   if (!schemaSupportsMeetingOperationalFields) {
     missing.push('meeting operational fields mentioned by sources, such as `series_id` and `asr_quality`');
   }
-  if (missing.length && schemaLooksClosed) {
+  if (missing.length) {
+    const schemaShape = schemaLooksClosed ? 'closed/minimal schema list' : 'schema/foundation contract';
     gates.push({
       id: 'schema-supports-derived-requirements',
       severity: 'critical',
       blocking: true,
       title: 'Schema requirement does not support dependent requirements',
-      issue: `Schema requirement ${schemaReq.id} is written as a closed/minimal schema list but omits ${missing.join(', ')}.`,
-      action: 'Update the schema requirement before WP planning: add the missing schema support, or explicitly state the alternative Phase 1 storage contract and defer the dependent behavior.',
+      issue: `Schema requirement ${schemaReq.id} is written as a ${schemaShape} but omits ${missing.join(', ')}.`,
+      action: 'Update the schema requirement before WP planning: add the missing schema support, or explicitly state the alternative Phase 1 storage contract and defer the dependent behavior. For meeting extraction this usually means `person_aliases` or documented alias storage plus `meetings.meeting_track`, `meetings.series_id`, `meetings.asr_quality`, `meetings.speaker_resolution_status` and `meetings.raw_speaker_labels` when those behaviors are approved.',
     });
   }
 }

package/bin/initiative.test.mjs

@@ -593,6 +593,92 @@ describe('initiative framework', () => {
     });
     expect(synthesis.rewriteRequired).toBe(true);
   });
+
+  it('blocks planning when a non-closed schema foundation omits speaker and meeting fields', () => {
+    const root = makeProject();
+    const docsDir = path.join(root, 'docs', 'delivery-os');
+    fs.mkdirSync(docsDir, { recursive: true });
+    fs.writeFileSync(path.join(docsDir, '06-roadmap.md'), [
+      '# Phase 1',
+      '',
+      '- Migration 001b: person_aliases. Meeting fields: meeting_track, series_id, asr_quality, speaker_resolution_status, raw_speaker_labels.',
+    ].join('\n'));
+    createInitiative({
+      projectRoot: root,
+      initiativeId: 'delivery-os-mvp',
+      title: 'Delivery OS MVP',
+    });
+    initiativeIntake({
+      projectRoot: root,
+      initiativeId: 'delivery-os-mvp',
+      docsDir: 'docs/delivery-os',
+      phase: 'phase-1',
+    });
+    const initiativeDir = path.join(root, 'ops', 'agent-pipeline', 'initiatives', 'delivery-os-mvp');
+    fs.writeFileSync(path.join(initiativeDir, 'requirements-map.md'), [
+      '# Requirements Map',
+      '',
+      '## Requirement Details',
+      '',
+      '### REQ-002',
+      '',
+      '- Status: `approved`',
+      '- Source: `docs/delivery-os/04-data-model.md:1206`',
+      '- Source hash: `sha`',
+      '- Phase: `phase-1`',
+      '- Quality: `complete`',
+      '- Quality issue: (none)',
+      '- Work package: WP-001',
+      '- Acceptance: Schema includes approved Phase 1 entities plus attribution/access foundations: created_by, app.current_user_id, owner_id, entity_history, enforcement-deferred.',
+      '- Decision: `approve`',
+      '- Notes: Human-approved attribution update.',
+      '- Requirement: Minimal Phase 1 Schema And Attribution Foundations.',
+      '',
+      '### REQ-003',
+      '',
+      '- Status: `approved`',
+      '- Source: `docs/delivery-os/06-roadmap.md:10`',
+      '- Source hash: `sha`',
+      '- Phase: `phase-1`',
+      '- Quality: `complete`',
+      '- Quality issue: (none)',
+      '- Work package: WP-003',
+      '- Acceptance: Meetings are classified with meeting_track.',
+      '- Decision: `approve`',
+      '- Notes: (empty)',
+      '- Requirement: Phase 1 classification uses meeting_track for client/internal/tracker/advisor_network/investor/grant_funding.',
+      '',
+      '### REQ-004',
+      '',
+      '- Status: `approved`',
+      '- Source: `docs/delivery-os/13-meeting-extraction-profiles.md:240`',
+      '- Source hash: `sha`',
+      '- Phase: `phase-1`',
+      '- Quality: `complete`',
+      '- Quality issue: (none)',
+      '- Work package: WP-001, WP-003',
+      '- Acceptance: Speaker resolution stores raw speaker labels/aliases and speaker_resolution_status.',
+      '- Decision: `approve`',
+      '- Notes: (empty)',
+      '- Requirement: Phase 1 supports speaker identity resolution and alias storage.',
+      '',
+    ].join('\n'));
+
+    const synthesis = initiativeRequirementsSynthesis({
+      projectRoot: root,
+      initiativeId: 'delivery-os-mvp',
+    });
+
+    const schemaGate = synthesis.gates.find((gate) => gate.id === 'schema-supports-derived-requirements');
+    expect(schemaGate).toMatchObject({
+      severity: 'critical',
+      blocking: true,
+    });
+    expect(schemaGate.issue).toContain('schema/foundation contract');
+    expect(schemaGate.issue).toContain('person_aliases');
+    expect(schemaGate.issue).toContain('meeting_track');
+    expect(schemaGate.action).toContain('meetings.raw_speaker_labels');
+  });
 });
 
 function makeProject() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@besales/ops-framework",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "type": "module",
   "bin": {
     "ops-agent": "bin/ops-agent.mjs"