sdd-agent-platform 0.4.1 → 0.5.0

package/node_modules/@sdd-agent-platform/core/src/workflow-gate/types.ts

@@ -1,114 +1,111 @@
-import type { FanInEvidenceSetRecord, LlmAdvisorAssessmentRecord } from '../execution/stage-team-runtime.js';
-import type { RuntimeDurableGapRecord, RuntimeSyncBackDecisionRecord } from '../storage/runtime-store.js';
-import type { LatestEligibleRunSelection } from '../workflow-state/latest-eligible-run.js';
-import type { WorkflowDependencyBlocker } from '../workflow-state/dependencies.js';
-import type { WorkflowAffectedFileConflict } from '../workflow-state/affected-file-conflicts.js';
-import type { SddTaskModel } from '../sdd-docs/task-parser.js';
-
-export type WorkflowGateStatus = 'PASS' | 'WARN' | 'BLOCKED' | 'HUMAN_REQUIRED' | 'ADVISORY_ONLY';
-export type WorkflowGateHardCheckSeverity = 'info' | 'warning' | 'blocked';
-export type WorkflowGateAdvisorSummaryStatus = 'none' | 'low_concern' | 'medium_concern' | 'high_concern' | 'invalid';
-export type WorkflowGateDecisionKind = 'test' | 'validation_wave' | 'review_gate' | 'sync_back' | 'ship' | 'stage_transition';
-
-export type WorkflowGateHardCheckCode =
-  | 'schema_health_unavailable'
-  | 'missing_documents'
-  | 'stale_documents'
-  | 'contract_hash_mismatch'
-  | 'run_rejected'
-  | 'blocked_failed_or_archived_run'
-  | 'latest_eligible_missing'
-  | 'missing_payload'
-  | 'digest_drift'
-  | 'missing_required_artifact'
-  | 'validation_failure'
-  | 'dependency_blocker'
-  | 'authority_violation'
-  | 'sync_back_divergence'
-  | 'affected_file_conflict'
-  | 'durable_gap_blocking';
-
-export interface WorkflowGateHardCheck {
-  code: WorkflowGateHardCheckCode;
-  severity: WorkflowGateHardCheckSeverity;
-  scope: string;
-  message: string;
-  recovery: string;
-  refs: string[];
-}
-
-export interface WorkflowGateArtifactPayloadHealth {
-  payloadId: string;
-  logicalRef: string;
-  physicalPayloadPath: string;
-  expectedDigest: string;
-  actualDigest: string | null;
-  status: 'ok' | 'missing' | 'digest_drift';
-}
-
-export interface WorkflowGateRuntimeHealth {
-  status: 'ok' | 'unavailable';
-  issues: string[];
-}
-
-export interface WorkflowGateScope {
-  waveRunId: string | null;
-  taskIds: string[];
-  runIds: string[];
-  evidenceRefs: string[];
-}
-
-export interface WorkflowGateEvidencePacket {
-  packetId: string;
-  generatedAt: string;
-  decisionKind: WorkflowGateDecisionKind;
-  partition: string;
-  taskId: string | null;
-  runId: string | null;
-  documents: SddTaskModel['documents'];
-  latestEligibleSelection: LatestEligibleRunSelection | null;
-  latestEligibleSelections: LatestEligibleRunSelection[];
-  workflowScope: WorkflowGateScope;
-  runtimeHealth: WorkflowGateRuntimeHealth;
-  durableGaps: RuntimeDurableGapRecord[];
-  dependencyBlockers: WorkflowDependencyBlocker[];
-  affectedFileConflicts: WorkflowAffectedFileConflict[];
-  syncBackDecision: RuntimeSyncBackDecisionRecord | null;
-  syncBackDecisions: RuntimeSyncBackDecisionRecord[];
-  fanInEvidenceSets: FanInEvidenceSetRecord[];
-  advisorAssessments: LlmAdvisorAssessmentRecord[];
-  canonicalEvidenceRefs: string[];
-  requiredArtifactRefs: string[];
-  artifactPayloadHealth: WorkflowGateArtifactPayloadHealth[];
-  hardChecks: WorkflowGateHardCheck[];
-}
-
-export interface WorkflowGateAdvisorSummary {
-  status: WorkflowGateAdvisorSummaryStatus;
-  highConcernCount: number;
-  mediumConcernCount: number;
-  invalidCount: number;
-  lowConfidenceCount: number;
-  summaries: string[];
-}
-
-export interface WorkflowGateDecision {
-  decisionId: string;
-  inputHash: string;
-  generatedAt: string;
-  partition: string;
-  taskId: string | null;
-  runId: string | null;
-  decisionKind: WorkflowGateDecisionKind;
-  status: WorkflowGateStatus;
-  decidedBy: 'runtime_policy';
-  hardBlocks: WorkflowGateHardCheck[];
-  warnings: WorkflowGateHardCheck[];
-  advisorSummary: WorkflowGateAdvisorSummary;
-  allowedNextActions: string[];
-  forbiddenNextActions: string[];
-  humanRequired: boolean;
-  reasons: string[];
-  evidenceRefs: string[];
-  payload: unknown;
-}
+import type { FanInEvidenceSetRecord, LlmAdvisorAssessmentRecord } from '../execution/stage-team-runtime.js';
+import type { RuntimeDurableGapRecord } from '../storage/runtime-store.js';
+import type { LatestEligibleRunSelection } from '../workflow-state/latest-eligible-run.js';
+import type { WorkflowDependencyBlocker } from '../workflow-state/dependencies.js';
+import type { WorkflowAffectedFileConflict } from '../workflow-state/affected-file-conflicts.js';
+import type { SddTaskModel } from '../sdd-docs/task-parser.js';
+
+export type WorkflowGateStatus = 'PASS' | 'WARN' | 'BLOCKED' | 'HUMAN_REQUIRED' | 'ADVISORY_ONLY';
+export type WorkflowGateHardCheckSeverity = 'info' | 'warning' | 'blocked';
+export type WorkflowGateAdvisorSummaryStatus = 'none' | 'low_concern' | 'medium_concern' | 'high_concern' | 'invalid';
+export type WorkflowGateDecisionKind = 'test' | 'validation_wave' | 'review_gate' | 'ship' | 'stage_transition';
+
+export type WorkflowGateHardCheckCode =
+  | 'schema_health_unavailable'
+  | 'missing_documents'
+  | 'stale_documents'
+  | 'contract_hash_mismatch'
+  | 'run_rejected'
+  | 'blocked_failed_or_archived_run'
+  | 'latest_eligible_missing'
+  | 'missing_payload'
+  | 'digest_drift'
+  | 'missing_required_artifact'
+  | 'validation_failure'
+  | 'dependency_blocker'
+  | 'authority_violation'
+  | 'affected_file_conflict'
+  | 'durable_gap_blocking';
+
+export interface WorkflowGateHardCheck {
+  code: WorkflowGateHardCheckCode;
+  severity: WorkflowGateHardCheckSeverity;
+  scope: string;
+  message: string;
+  recovery: string;
+  refs: string[];
+}
+
+export interface WorkflowGateArtifactPayloadHealth {
+  payloadId: string;
+  logicalRef: string;
+  physicalPayloadPath: string;
+  expectedDigest: string;
+  actualDigest: string | null;
+  status: 'ok' | 'missing' | 'digest_drift';
+}
+
+export interface WorkflowGateRuntimeHealth {
+  status: 'ok' | 'unavailable';
+  issues: string[];
+}
+
+export interface WorkflowGateScope {
+  waveRunId: string | null;
+  taskIds: string[];
+  runIds: string[];
+  evidenceRefs: string[];
+}
+
+export interface WorkflowGateEvidencePacket {
+  packetId: string;
+  generatedAt: string;
+  decisionKind: WorkflowGateDecisionKind;
+  partition: string;
+  taskId: string | null;
+  runId: string | null;
+  documents: SddTaskModel['documents'];
+  latestEligibleSelection: LatestEligibleRunSelection | null;
+  latestEligibleSelections: LatestEligibleRunSelection[];
+  workflowScope: WorkflowGateScope;
+  runtimeHealth: WorkflowGateRuntimeHealth;
+  durableGaps: RuntimeDurableGapRecord[];
+  dependencyBlockers: WorkflowDependencyBlocker[];
+  affectedFileConflicts: WorkflowAffectedFileConflict[];
+  fanInEvidenceSets: FanInEvidenceSetRecord[];
+  advisorAssessments: LlmAdvisorAssessmentRecord[];
+  canonicalEvidenceRefs: string[];
+  requiredArtifactRefs: string[];
+  artifactPayloadHealth: WorkflowGateArtifactPayloadHealth[];
+  hardChecks: WorkflowGateHardCheck[];
+}
+
+export interface WorkflowGateAdvisorSummary {
+  status: WorkflowGateAdvisorSummaryStatus;
+  highConcernCount: number;
+  mediumConcernCount: number;
+  invalidCount: number;
+  lowConfidenceCount: number;
+  summaries: string[];
+}
+
+export interface WorkflowGateDecision {
+  decisionId: string;
+  inputHash: string;
+  generatedAt: string;
+  partition: string;
+  taskId: string | null;
+  runId: string | null;
+  decisionKind: WorkflowGateDecisionKind;
+  status: WorkflowGateStatus;
+  decidedBy: 'runtime_policy';
+  hardBlocks: WorkflowGateHardCheck[];
+  warnings: WorkflowGateHardCheck[];
+  advisorSummary: WorkflowGateAdvisorSummary;
+  allowedNextActions: string[];
+  forbiddenNextActions: string[];
+  humanRequired: boolean;
+  reasons: string[];
+  evidenceRefs: string[];
+  payload: unknown;
+}

package/node_modules/@sdd-agent-platform/core/src/workflow-state/affected-file-conflicts.ts

@@ -1,96 +1,96 @@
-import type { RunState } from '../run-state/model.js';
-
-export interface WorkflowAffectedFileConflict {
-  file: string;
-  partition: string;
-  gitBranch: string | null;
-  taskId: string;
-  runId: string;
-  runStatus: RunState['status'];
-  syncBackStatus: RunState['syncBack']['status'];
-  updatedAt: string;
-}
-
-export function affectedFileConflictsForSelectedRun(states: RunState[], selected: RunState): WorkflowAffectedFileConflict[] {
-  if (!selected.partition || !selected.taskId || selected.affectedFiles.length === 0) {
-    return [];
-  }
-
-  const selectedFiles = new Set(selected.affectedFiles);
-  const conflicts: WorkflowAffectedFileConflict[] = [];
-  for (const state of states) {
-    if (!isAffectedFileConflictCandidate(state, selected)) {
-      continue;
-    }
-    for (const file of state.affectedFiles) {
-      if (selectedFiles.has(file)) {
-        conflicts.push({
-          file,
-          partition: state.partition,
-          gitBranch: state.gitBranch,
-          taskId: state.taskId,
-          runId: state.runId,
-          runStatus: state.status,
-          syncBackStatus: state.syncBack.status,
-          updatedAt: state.updatedAt
-        });
-      }
-    }
-  }
-  return conflicts.sort((left, right) => left.file.localeCompare(right.file) || left.partition.localeCompare(right.partition) || left.taskId.localeCompare(right.taskId) || left.runId.localeCompare(right.runId));
-}
-
-export function affectedFileConflictsForSelectedRuns(states: RunState[], selectedRuns: RunState[]): WorkflowAffectedFileConflict[] {
-  const conflicts = selectedRuns.flatMap((selected) => affectedFileConflictsForSelectedRun(states, selected));
-  return uniqueBy(conflicts, (conflict) => `${conflict.file}:${conflict.partition}:${conflict.taskId}:${conflict.runId}`);
-}
-
-function isAffectedFileConflictCandidate(candidate: RunState, selected: RunState): candidate is RunState & { partition: string; taskId: string } {
-  if (candidate.runId === selected.runId || candidate.status === 'archived' || !candidate.partition || !candidate.taskId) {
-    return false;
-  }
-  if (isNonAuthoritativeForegroundRun(candidate)) {
-    return false;
-  }
-  if (selectedSupersedesCandidate(selected, candidate)) {
-    return false;
-  }
-  return isActiveAffectedFileRun(candidate);
-}
-
-function isActiveAffectedFileRun(state: RunState): boolean {
-  return state.status === 'created' || state.status === 'running';
-}
-
-function selectedSupersedesCandidate(selected: RunState, candidate: RunState): boolean {
-  return Boolean(
-    selected.partition &&
-    selected.taskId &&
-    selected.partition === candidate.partition &&
-    selected.taskId === candidate.taskId &&
-    selected.status === 'completed' &&
-    selected.validation.status === 'pass' &&
-    Date.parse(selected.updatedAt) > Date.parse(candidate.updatedAt) &&
-    (candidate.status === 'failed' || candidate.status === 'blocked' || candidate.validation.status === 'fail' || candidate.validation.status === 'blocked' || candidate.syncBack.status === 'proposed')
-  );
-}
-
-function isNonAuthoritativeForegroundRun(state: RunState): boolean {
-  if (state.phase === 'foreground-subagents') {
-    return true;
-  }
-  const delegations = Object.values(state.delegations);
-  return delegations.length > 0 && delegations.every((delegation) => delegation.runMode === 'foreground' && !delegation.blocking && !delegation.requiredForPhaseExit);
-}
-
-function uniqueBy<T>(items: T[], keyOf: (item: T) => string): T[] {
-  const seen = new Set<string>();
-  return items.filter((item) => {
-    const key = keyOf(item);
-    if (seen.has(key)) {
-      return false;
-    }
-    seen.add(key);
-    return true;
-  });
+import type { RunState } from '../run-state/model.js';
+
+export interface WorkflowAffectedFileConflict {
+  file: string;
+  partition: string;
+  gitBranch: string | null;
+  taskId: string;
+  runId: string;
+  runStatus: RunState['status'];
+  syncBackStatus: RunState['syncBack']['status'];
+  updatedAt: string;
+}
+
+export function affectedFileConflictsForSelectedRun(states: RunState[], selected: RunState): WorkflowAffectedFileConflict[] {
+  if (!selected.partition || !selected.taskId || selected.affectedFiles.length === 0) {
+    return [];
+  }
+
+  const selectedFiles = new Set(selected.affectedFiles);
+  const conflicts: WorkflowAffectedFileConflict[] = [];
+  for (const state of states) {
+    if (!isAffectedFileConflictCandidate(state, selected)) {
+      continue;
+    }
+    for (const file of state.affectedFiles) {
+      if (selectedFiles.has(file)) {
+        conflicts.push({
+          file,
+          partition: state.partition,
+          gitBranch: state.gitBranch,
+          taskId: state.taskId,
+          runId: state.runId,
+          runStatus: state.status,
+          syncBackStatus: state.syncBack.status,
+          updatedAt: state.updatedAt
+        });
+      }
+    }
+  }
+  return conflicts.sort((left, right) => left.file.localeCompare(right.file) || left.partition.localeCompare(right.partition) || left.taskId.localeCompare(right.taskId) || left.runId.localeCompare(right.runId));
+}
+
+export function affectedFileConflictsForSelectedRuns(states: RunState[], selectedRuns: RunState[]): WorkflowAffectedFileConflict[] {
+  const conflicts = selectedRuns.flatMap((selected) => affectedFileConflictsForSelectedRun(states, selected));
+  return uniqueBy(conflicts, (conflict) => `${conflict.file}:${conflict.partition}:${conflict.taskId}:${conflict.runId}`);
+}
+
+function isAffectedFileConflictCandidate(candidate: RunState, selected: RunState): candidate is RunState & { partition: string; taskId: string } {
+  if (candidate.runId === selected.runId || candidate.status === 'archived' || !candidate.partition || !candidate.taskId) {
+    return false;
+  }
+  if (isNonAuthoritativeForegroundRun(candidate)) {
+    return false;
+  }
+  if (selectedSupersedesCandidate(selected, candidate)) {
+    return false;
+  }
+  return isActiveAffectedFileRun(candidate);
+}
+
+function isActiveAffectedFileRun(state: RunState): boolean {
+  return state.status === 'created' || state.status === 'running';
+}
+
+function selectedSupersedesCandidate(selected: RunState, candidate: RunState): boolean {
+  return Boolean(
+    selected.partition &&
+    selected.taskId &&
+    selected.partition === candidate.partition &&
+    selected.taskId === candidate.taskId &&
+    selected.status === 'completed' &&
+    selected.validation.status === 'pass' &&
+    Date.parse(selected.updatedAt) > Date.parse(candidate.updatedAt) &&
+    (candidate.status === 'failed' || candidate.status === 'blocked' || candidate.validation.status === 'fail' || candidate.validation.status === 'blocked' || candidate.syncBack.status === 'proposed')
+  );
+}
+
+function isNonAuthoritativeForegroundRun(state: RunState): boolean {
+  if (state.phase === 'foreground-subagents') {
+    return true;
+  }
+  const delegations = Object.values(state.delegations);
+  return delegations.length > 0 && delegations.every((delegation) => delegation.runMode === 'foreground' && !delegation.blocking && !delegation.requiredForPhaseExit);
+}
+
+function uniqueBy<T>(items: T[], keyOf: (item: T) => string): T[] {
+  const seen = new Set<string>();
+  return items.filter((item) => {
+    const key = keyOf(item);
+    if (seen.has(key)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
 }

package/node_modules/@sdd-agent-platform/core/src/workflow-state/dependencies.test.ts

@@ -1,32 +1,32 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-
-import { parseSddTasksMarkdown } from '../sdd-docs/task-parser.js';
-import { resolveTaskDependencyReadiness, workflowDependencyBlockers } from './dependencies.js';
-
-function taskBlock(id: string, status: string, dependsOn: string[]): string {
-  const dependsOnBlock = dependsOn.length === 0 ? 'depends_on: []' : `depends_on:\n${dependsOn.map((dependency) => `  - ${dependency}`).join('\n')}`;
-  return `### ${id}: Dependency fixture\n\n\`\`\`sdd-task\nid: ${id}\nstatus: ${status}\nwave: 1\n${dependsOnBlock}\nacceptance_refs:\n  - AC-${id}\nplan_refs:\n  - Plan\naffected_files:\n  - docs/${id}.md\nvalidation:\n  - npm test\nrisk: []\n\`\`\`\n`;
-}
-
-test('dependency readiness blocks tasks until dependencies are completed', () => {
-  const model = parseSddTasksMarkdown(`# Tasks\n\n${taskBlock('DEP1', 'pending', [])}\n${taskBlock('DEP2', 'pending', ['DEP1'])}`, { tasksPath: 'tasks.md' });
-
-  const readiness = resolveTaskDependencyReadiness(model, 'DEP2');
-
-  assert.equal(readiness.ready, false);
-  assert.deepEqual(readiness.dependencies.map((dependency) => `${dependency.taskId}:${dependency.status}:${dependency.ready}`), ['DEP1:pending:false']);
-  assert.match(readiness.blockingReasons[0], /DEP2 depends on DEP1, but DEP1 has not passed required verification/);
-  assert.deepEqual(workflowDependencyBlockers(model).map((blocker) => `${blocker.taskId}->${blocker.dependencyId}:${blocker.dependencyStatus}`), ['DEP2->DEP1:pending']);
-});
-
-test('dependency readiness accepts completed dependencies and reports missing dependencies', () => {
-  const readyModel = parseSddTasksMarkdown(`# Tasks\n\n${taskBlock('DEP1', 'completed', [])}\n${taskBlock('DEP2', 'pending', ['DEP1'])}`, { tasksPath: 'tasks.md' });
-  const missingModel = parseSddTasksMarkdown(`# Tasks\n\n${taskBlock('DEP2', 'pending', ['MISSING'])}`, { tasksPath: 'tasks.md' });
-
-  assert.equal(resolveTaskDependencyReadiness(readyModel, 'DEP2').ready, true);
-  const missing = resolveTaskDependencyReadiness(missingModel, 'DEP2');
-  assert.equal(missing.ready, false);
-  assert.equal(missing.dependencies[0].status, 'missing');
-  assert.match(missing.blockingReasons[0], /MISSING was not found/);
-});
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { parseSddTasksMarkdown } from '../sdd-docs/task-parser.js';
+import { resolveTaskDependencyReadiness, workflowDependencyBlockers } from './dependencies.js';
+
+function taskBlock(id: string, status: string, dependsOn: string[]): string {
+  const dependsOnBlock = dependsOn.length === 0 ? 'depends_on: []' : `depends_on:\n${dependsOn.map((dependency) => `  - ${dependency}`).join('\n')}`;
+  return `### ${id}: Dependency fixture\n\n\`\`\`sdd-task\nid: ${id}\nstatus: ${status}\nwave: 1\n${dependsOnBlock}\nacceptance_refs:\n  - AC-${id}\nplan_refs:\n  - Plan\naffected_files:\n  - docs/${id}.md\nvalidation:\n  - npm test\nrisk: []\n\`\`\`\n`;
+}
+
+test('dependency readiness blocks tasks until dependencies are completed', () => {
+  const model = parseSddTasksMarkdown(`# Tasks\n\n${taskBlock('DEP1', 'pending', [])}\n${taskBlock('DEP2', 'pending', ['DEP1'])}`, { tasksPath: 'tasks.md' });
+
+  const readiness = resolveTaskDependencyReadiness(model, 'DEP2');
+
+  assert.equal(readiness.ready, false);
+  assert.deepEqual(readiness.dependencies.map((dependency) => `${dependency.taskId}:${dependency.status}:${dependency.ready}`), ['DEP1:pending:false']);
+  assert.match(readiness.blockingReasons[0], /DEP2 depends on DEP1, but DEP1 has not passed required verification/);
+  assert.deepEqual(workflowDependencyBlockers(model).map((blocker) => `${blocker.taskId}->${blocker.dependencyId}:${blocker.dependencyStatus}`), ['DEP2->DEP1:pending']);
+});
+
+test('dependency readiness accepts completed dependencies and reports missing dependencies', () => {
+  const readyModel = parseSddTasksMarkdown(`# Tasks\n\n${taskBlock('DEP1', 'completed', [])}\n${taskBlock('DEP2', 'pending', ['DEP1'])}`, { tasksPath: 'tasks.md' });
+  const missingModel = parseSddTasksMarkdown(`# Tasks\n\n${taskBlock('DEP2', 'pending', ['MISSING'])}`, { tasksPath: 'tasks.md' });
+
+  assert.equal(resolveTaskDependencyReadiness(readyModel, 'DEP2').ready, true);
+  const missing = resolveTaskDependencyReadiness(missingModel, 'DEP2');
+  assert.equal(missing.ready, false);
+  assert.equal(missing.dependencies[0].status, 'missing');
+  assert.match(missing.blockingReasons[0], /MISSING was not found/);
+});