pumuki 6.3.7

package/scripts/phase5-execution-closure-status-markdown-next-actions-lib.ts

@@ -0,0 +1,24 @@
+import type { Phase5ExecutionClosureSummary } from './phase5-execution-closure-status-contract';
+
+export const appendPhase5ExecutionClosureStatusNextActions = (
+  lines: string[],
+  summary: Phase5ExecutionClosureSummary
+): void => {
+  lines.push('## Next Actions');
+  lines.push('');
+  if (summary.verdict === 'READY') {
+    lines.push('- Phase 5 execution closure criteria are satisfied.');
+    lines.push('- Archive generated reports and update rollout tracker references.');
+    lines.push('');
+    return;
+  }
+
+  if (summary.verdict === 'MISSING_INPUTS') {
+    lines.push('- Generate missing reports first, then re-run this status command.');
+  }
+  if (summary.verdict === 'BLOCKED') {
+    lines.push('- Resolve blockers from report inputs and regenerate reports.');
+  }
+  lines.push('- Re-run: `npm run validation:phase5-execution-closure-status`.');
+  lines.push('');
+};

package/scripts/phase5-execution-closure-status-markdown-sections-lib.ts

@@ -0,0 +1,7 @@
+export {
+  appendPhase5ExecutionClosureStatusFindings,
+  appendPhase5ExecutionClosureStatusHeader,
+  appendPhase5ExecutionClosureStatusInputs,
+  appendPhase5ExecutionClosureStatusVerdicts,
+} from './phase5-execution-closure-status-markdown-static-sections-lib';
+export { appendPhase5ExecutionClosureStatusNextActions } from './phase5-execution-closure-status-markdown-next-actions-lib';

package/scripts/phase5-execution-closure-status-markdown-static-sections-lib.ts

@@ -0,0 +1,58 @@
+import type {
+  BuildPhase5ExecutionClosureStatusMarkdownParams,
+  Phase5ExecutionClosureSummary,
+} from './phase5-execution-closure-status-contract';
+import { appendPhase5ExecutionClosureStatusList } from './phase5-execution-closure-status-markdown-list-lib';
+
+export const appendPhase5ExecutionClosureStatusHeader = (
+  lines: string[],
+  params: BuildPhase5ExecutionClosureStatusMarkdownParams
+): void => {
+  lines.push('# Phase 5 Execution Closure Status');
+  lines.push('');
+  lines.push(`- generated_at: ${params.generatedAt}`);
+  lines.push(`- verdict: ${params.summary.verdict}`);
+  lines.push('');
+};
+
+export const appendPhase5ExecutionClosureStatusInputs = (
+  lines: string[],
+  params: BuildPhase5ExecutionClosureStatusMarkdownParams
+): void => {
+  lines.push('## Inputs');
+  lines.push('');
+  lines.push(
+    `- phase5_blockers_report: \`${params.phase5BlockersReportPath}\` (${params.hasPhase5BlockersReport ? 'found' : 'missing'})`
+  );
+  lines.push(
+    `- consumer_unblock_report: \`${params.consumerUnblockReportPath}\` (${params.hasConsumerUnblockReport ? 'found' : 'missing'})`
+  );
+  lines.push(
+    `- adapter_readiness_report: \`${params.adapterReadinessReportPath}\` (${params.hasAdapterReadinessReport ? 'found' : 'missing'})`
+  );
+  lines.push(
+    `- adapter_readiness_required: ${params.summary.requireAdapterReadiness ? 'YES' : 'NO'}`
+  );
+  lines.push('');
+};
+
+export const appendPhase5ExecutionClosureStatusVerdicts = (
+  lines: string[],
+  summary: Phase5ExecutionClosureSummary
+): void => {
+  lines.push('## Parsed Verdicts');
+  lines.push('');
+  lines.push(`- phase5_blockers: ${summary.phase5BlockersVerdict ?? 'unknown'}`);
+  lines.push(`- consumer_unblock: ${summary.consumerUnblockVerdict ?? 'unknown'}`);
+  lines.push(`- adapter_readiness: ${summary.adapterReadinessVerdict ?? 'unknown'}`);
+  lines.push('');
+};
+
+export const appendPhase5ExecutionClosureStatusFindings = (
+  lines: string[],
+  summary: Phase5ExecutionClosureSummary
+): void => {
+  appendPhase5ExecutionClosureStatusList(lines, '## Missing Inputs', summary.missingInputs);
+  appendPhase5ExecutionClosureStatusList(lines, '## Blockers', summary.blockers);
+  appendPhase5ExecutionClosureStatusList(lines, '## Warnings', summary.warnings);
+};

package/scripts/phase5-execution-closure-status-missing-inputs-lib.ts

@@ -0,0 +1,19 @@
+import type { SummarizePhase5ExecutionClosureParams } from './phase5-execution-closure-status-contract';
+
+export const collectPhase5ExecutionClosureMissingInputs = (
+  params: SummarizePhase5ExecutionClosureParams
+): string[] => {
+  const missingInputs: string[] = [];
+
+  if (!params.hasPhase5BlockersReport) {
+    missingInputs.push('Missing Phase 5 blockers readiness report');
+  }
+  if (!params.hasConsumerUnblockReport) {
+    missingInputs.push('Missing consumer startup unblock status report');
+  }
+  if (params.requireAdapterReadiness && !params.hasAdapterReadinessReport) {
+    missingInputs.push('Missing adapter readiness report');
+  }
+
+  return missingInputs;
+};

package/scripts/phase5-execution-closure-status-parser-lib.ts

@@ -0,0 +1,4 @@
+export const parseVerdictFromMarkdown = (markdown: string): string | undefined => {
+  const raw = markdown.match(/- verdict:\s*([A-Z_]+)/)?.[1]?.trim();
+  return raw && raw.length > 0 ? raw : undefined;
+};

package/scripts/phase5-execution-closure-status-summary-helpers-lib.ts

@@ -0,0 +1,6 @@
+export { collectPhase5ExecutionClosureMissingInputs } from './phase5-execution-closure-status-missing-inputs-lib';
+export {
+  collectPhase5ExecutionClosureBlockers,
+  collectPhase5ExecutionClosureWarnings,
+} from './phase5-execution-closure-status-blockers-lib';
+export { resolvePhase5ExecutionClosureSummaryVerdict } from './phase5-execution-closure-status-verdict-lib';

package/scripts/phase5-execution-closure-status-summary-lib.ts

@@ -0,0 +1,34 @@
+import {
+  dedupePhase5ExecutionClosureValues,
+  type Phase5ExecutionClosureSummary,
+  type SummarizePhase5ExecutionClosureParams,
+} from './phase5-execution-closure-status-contract';
+import {
+  collectPhase5ExecutionClosureBlockers,
+  collectPhase5ExecutionClosureMissingInputs,
+  collectPhase5ExecutionClosureWarnings,
+  resolvePhase5ExecutionClosureSummaryVerdict,
+} from './phase5-execution-closure-status-summary-helpers-lib';
+
+export const summarizePhase5ExecutionClosure = (
+  params: SummarizePhase5ExecutionClosureParams
+): Phase5ExecutionClosureSummary => {
+  const missingInputs = collectPhase5ExecutionClosureMissingInputs(params);
+  const blockers = missingInputs.length === 0 ? collectPhase5ExecutionClosureBlockers(params) : [];
+  const warnings = missingInputs.length === 0 ? collectPhase5ExecutionClosureWarnings(params) : [];
+  const verdict = resolvePhase5ExecutionClosureSummaryVerdict({
+    missingInputs,
+    blockers,
+  });
+
+  return {
+    verdict,
+    blockers: dedupePhase5ExecutionClosureValues(blockers),
+    missingInputs: dedupePhase5ExecutionClosureValues(missingInputs),
+    warnings: dedupePhase5ExecutionClosureValues(warnings),
+    phase5BlockersVerdict: params.phase5BlockersVerdict,
+    consumerUnblockVerdict: params.consumerUnblockVerdict,
+    adapterReadinessVerdict: params.adapterReadinessVerdict,
+    requireAdapterReadiness: params.requireAdapterReadiness,
+  };
+};

package/scripts/phase5-execution-closure-status-verdict-lib.ts

@@ -0,0 +1,11 @@
+import type { Phase5ExecutionClosureSummary } from './phase5-execution-closure-status-contract';
+
+export const resolvePhase5ExecutionClosureSummaryVerdict = (params: {
+  missingInputs: ReadonlyArray<string>;
+  blockers: ReadonlyArray<string>;
+}): Phase5ExecutionClosureSummary['verdict'] =>
+  params.missingInputs.length > 0
+    ? 'MISSING_INPUTS'
+    : params.blockers.length > 0
+      ? 'BLOCKED'
+      : 'READY';

package/scripts/phase5-external-handoff-contract.ts

@@ -0,0 +1,51 @@
+export type Phase5ExternalHandoffSummary = {
+  verdict: 'READY' | 'BLOCKED' | 'MISSING_INPUTS';
+  blockers: ReadonlyArray<string>;
+  missingInputs: ReadonlyArray<string>;
+  warnings: ReadonlyArray<string>;
+  phase5StatusVerdict?: string;
+  phase5BlockersVerdict?: string;
+  consumerUnblockVerdict?: string;
+  mockAbVerdict?: string;
+  runReportVerdict?: string;
+  consumerStartupFailureRuns?: number;
+  consumerStartupStalledRuns?: number;
+  artifactUrls: ReadonlyArray<string>;
+  requireArtifactUrls: boolean;
+  requireMockAbReport: boolean;
+};
+
+export type SummarizePhase5ExternalHandoffParams = {
+  hasPhase5StatusReport: boolean;
+  hasPhase5BlockersReport: boolean;
+  hasConsumerUnblockReport: boolean;
+  hasMockAbReport: boolean;
+  hasRunReport: boolean;
+  phase5StatusVerdict?: string;
+  phase5BlockersVerdict?: string;
+  consumerUnblockVerdict?: string;
+  mockAbVerdict?: string;
+  runReportVerdict?: string;
+  consumerStartupFailureRuns?: number;
+  consumerStartupStalledRuns?: number;
+  artifactUrls: ReadonlyArray<string>;
+  requireArtifactUrls: boolean;
+  requireMockAbReport: boolean;
+};
+
+export const dedupePhase5ExternalHandoffValues = (
+  values: ReadonlyArray<string>
+): string[] => {
+  const seen = new Set<string>();
+  const output: string[] = [];
+
+  for (const value of values) {
+    if (seen.has(value)) {
+      continue;
+    }
+    seen.add(value);
+    output.push(value);
+  }
+
+  return output;
+};

package/scripts/phase5-external-handoff-inputs-artifacts-lib.ts

@@ -0,0 +1,45 @@
+import type { SummarizePhase5ExternalHandoffParams } from './phase5-external-handoff-contract';
+
+export const collectPhase5ExternalHandoffMissingInputs = (
+  params: SummarizePhase5ExternalHandoffParams
+): string[] => {
+  const missingInputs: string[] = [];
+
+  if (!params.hasPhase5StatusReport) {
+    missingInputs.push('Missing Phase 5 execution closure status report');
+  }
+  if (!params.hasPhase5BlockersReport) {
+    missingInputs.push('Missing Phase 5 blockers readiness report');
+  }
+  if (!params.hasConsumerUnblockReport) {
+    missingInputs.push('Missing consumer startup unblock status report');
+  }
+  if (params.requireMockAbReport && !params.hasMockAbReport) {
+    missingInputs.push('Missing mock consumer A/B report');
+  }
+
+  return missingInputs;
+};
+
+export const collectPhase5ExternalHandoffArtifactFindings = (
+  params: SummarizePhase5ExternalHandoffParams
+): { blockers: string[]; warnings: string[] } => {
+  if (params.requireArtifactUrls && params.artifactUrls.length === 0) {
+    return {
+      blockers: ['No artifact URLs were provided'],
+      warnings: [],
+    };
+  }
+
+  if (!params.requireArtifactUrls && params.artifactUrls.length === 0) {
+    return {
+      blockers: [],
+      warnings: ['No artifact URLs were provided (recommended before external handoff)'],
+    };
+  }
+
+  return {
+    blockers: [],
+    warnings: [],
+  };
+};

package/scripts/phase5-external-handoff-lib.ts

@@ -0,0 +1,3 @@
+export type { Phase5ExternalHandoffSummary } from './phase5-external-handoff-contract';
+export { summarizePhase5ExternalHandoff } from './phase5-external-handoff-summary-lib';
+export { buildPhase5ExternalHandoffMarkdown } from './phase5-external-handoff-markdown-lib';

package/scripts/phase5-external-handoff-markdown-core-sections-lib.ts

@@ -0,0 +1,70 @@
+import type { Phase5ExternalHandoffSummary } from './phase5-external-handoff-contract';
+
+export const appendInputsSection = (params: {
+  lines: string[];
+  phase5StatusReportPath: string;
+  phase5BlockersReportPath: string;
+  consumerUnblockReportPath: string;
+  mockAbReportPath: string;
+  runReportPath: string;
+  hasPhase5StatusReport: boolean;
+  hasPhase5BlockersReport: boolean;
+  hasConsumerUnblockReport: boolean;
+  hasMockAbReport: boolean;
+  hasRunReport: boolean;
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  params.lines.push('## Inputs');
+  params.lines.push('');
+  params.lines.push(
+    `- phase5_status_report: \`${params.phase5StatusReportPath}\` (${params.hasPhase5StatusReport ? 'found' : 'missing'})`
+  );
+  params.lines.push(
+    `- phase5_blockers_report: \`${params.phase5BlockersReportPath}\` (${params.hasPhase5BlockersReport ? 'found' : 'missing'})`
+  );
+  params.lines.push(
+    `- consumer_unblock_report: \`${params.consumerUnblockReportPath}\` (${params.hasConsumerUnblockReport ? 'found' : 'missing'})`
+  );
+  params.lines.push(
+    `- mock_ab_report: \`${params.mockAbReportPath}\` (${params.hasMockAbReport ? 'found' : 'missing'})`
+  );
+  params.lines.push(
+    `- phase5_run_report: \`${params.runReportPath}\` (${params.hasRunReport ? 'found' : 'missing'})`
+  );
+  params.lines.push(
+    `- require_mock_ab_report: ${params.summary.requireMockAbReport ? 'YES' : 'NO'}`
+  );
+  params.lines.push(
+    `- require_artifact_urls: ${params.summary.requireArtifactUrls ? 'YES' : 'NO'}`
+  );
+  params.lines.push('');
+};
+
+export const appendParsedVerdictsSection = (params: {
+  lines: string[];
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  params.lines.push('## Parsed Verdicts');
+  params.lines.push('');
+  params.lines.push(`- phase5_status: ${params.summary.phase5StatusVerdict ?? 'unknown'}`);
+  params.lines.push(`- phase5_blockers: ${params.summary.phase5BlockersVerdict ?? 'unknown'}`);
+  params.lines.push(`- consumer_unblock: ${params.summary.consumerUnblockVerdict ?? 'unknown'}`);
+  params.lines.push(`- mock_ab: ${params.summary.mockAbVerdict ?? 'unknown'}`);
+  params.lines.push(`- phase5_run_report: ${params.summary.runReportVerdict ?? 'unknown'}`);
+  params.lines.push('');
+};
+
+export const appendConsumerStartupSignalsSection = (params: {
+  lines: string[];
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  params.lines.push('## Consumer Startup Signals');
+  params.lines.push('');
+  params.lines.push(
+    `- startup_failure_runs: ${params.summary.consumerStartupFailureRuns ?? 'unknown'}`
+  );
+  params.lines.push(
+    `- startup_stalled_runs: ${params.summary.consumerStartupStalledRuns ?? 'unknown'}`
+  );
+  params.lines.push('');
+};

package/scripts/phase5-external-handoff-markdown-header-lib.ts

@@ -0,0 +1,15 @@
+import type { Phase5ExternalHandoffSummary } from './phase5-external-handoff-contract';
+
+export const appendPhase5ExternalHandoffHeaderLines = (params: {
+  lines: string[];
+  generatedAt: string;
+  repo: string;
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  params.lines.push('# Phase 5 External Handoff Report');
+  params.lines.push('');
+  params.lines.push(`- generated_at: ${params.generatedAt}`);
+  params.lines.push(`- target_repo: \`${params.repo}\``);
+  params.lines.push(`- verdict: ${params.summary.verdict}`);
+  params.lines.push('');
+};

package/scripts/phase5-external-handoff-markdown-lib.ts

@@ -0,0 +1,44 @@
+import type { Phase5ExternalHandoffSummary } from './phase5-external-handoff-contract';
+import { appendPhase5ExternalHandoffHeaderLines } from './phase5-external-handoff-markdown-header-lib';
+import { appendPhase5ExternalHandoffSections } from './phase5-external-handoff-markdown-sections-append-lib';
+
+export const buildPhase5ExternalHandoffMarkdown = (params: {
+  generatedAt: string;
+  repo: string;
+  phase5StatusReportPath: string;
+  phase5BlockersReportPath: string;
+  consumerUnblockReportPath: string;
+  mockAbReportPath: string;
+  runReportPath: string;
+  hasPhase5StatusReport: boolean;
+  hasPhase5BlockersReport: boolean;
+  hasConsumerUnblockReport: boolean;
+  hasMockAbReport: boolean;
+  hasRunReport: boolean;
+  summary: Phase5ExternalHandoffSummary;
+}): string => {
+  const lines: string[] = [];
+
+  appendPhase5ExternalHandoffHeaderLines({
+    lines,
+    generatedAt: params.generatedAt,
+    repo: params.repo,
+    summary: params.summary,
+  });
+  appendPhase5ExternalHandoffSections({
+    lines,
+    phase5StatusReportPath: params.phase5StatusReportPath,
+    phase5BlockersReportPath: params.phase5BlockersReportPath,
+    consumerUnblockReportPath: params.consumerUnblockReportPath,
+    mockAbReportPath: params.mockAbReportPath,
+    runReportPath: params.runReportPath,
+    hasPhase5StatusReport: params.hasPhase5StatusReport,
+    hasPhase5BlockersReport: params.hasPhase5BlockersReport,
+    hasConsumerUnblockReport: params.hasConsumerUnblockReport,
+    hasMockAbReport: params.hasMockAbReport,
+    hasRunReport: params.hasRunReport,
+    summary: params.summary,
+  });
+
+  return `${lines.join('\n')}\n`;
+};

package/scripts/phase5-external-handoff-markdown-list-lib.ts

@@ -0,0 +1,16 @@
+export const appendPhase5ExternalHandoffListSection = (params: {
+  lines: string[];
+  title: string;
+  values: ReadonlyArray<string>;
+}): void => {
+  params.lines.push(params.title);
+  params.lines.push('');
+  if (params.values.length === 0) {
+    params.lines.push('- none');
+  } else {
+    for (const value of params.values) {
+      params.lines.push(`- ${value}`);
+    }
+  }
+  params.lines.push('');
+};

package/scripts/phase5-external-handoff-markdown-list-sections-lib.ts

@@ -0,0 +1,54 @@
+import type { Phase5ExternalHandoffSummary } from './phase5-external-handoff-contract';
+import { appendPhase5ExternalHandoffListSection } from './phase5-external-handoff-markdown-list-lib';
+import { appendPhase5ExternalHandoffNextActions } from './phase5-external-handoff-markdown-next-actions-lib';
+
+export const appendArtifactUrlsSection = (params: {
+  lines: string[];
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  appendPhase5ExternalHandoffListSection({
+    lines: params.lines,
+    title: '## Artifact URLs',
+    values: params.summary.artifactUrls,
+  });
+};
+
+export const appendMissingInputsSection = (params: {
+  lines: string[];
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  appendPhase5ExternalHandoffListSection({
+    lines: params.lines,
+    title: '## Missing Inputs',
+    values: params.summary.missingInputs,
+  });
+};
+
+export const appendBlockersSection = (params: {
+  lines: string[];
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  appendPhase5ExternalHandoffListSection({
+    lines: params.lines,
+    title: '## Blockers',
+    values: params.summary.blockers,
+  });
+};
+
+export const appendWarningsSection = (params: {
+  lines: string[];
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  appendPhase5ExternalHandoffListSection({
+    lines: params.lines,
+    title: '## Warnings',
+    values: params.summary.warnings,
+  });
+};
+
+export const appendNextActionsSection = (params: {
+  lines: string[];
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  appendPhase5ExternalHandoffNextActions(params);
+};

package/scripts/phase5-external-handoff-markdown-next-actions-lib.ts

@@ -0,0 +1,27 @@
+import type { Phase5ExternalHandoffSummary } from './phase5-external-handoff-contract';
+
+export const appendPhase5ExternalHandoffNextActions = (params: {
+  lines: string[];
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  params.lines.push('## Next Actions');
+  params.lines.push('');
+  if (params.summary.verdict === 'READY') {
+    params.lines.push('- External handoff packet is ready to attach to rollout tracker.');
+    params.lines.push('- Share this report and referenced artifact URLs with consumer owners.');
+    params.lines.push('');
+    return;
+  }
+
+  if (params.summary.verdict === 'MISSING_INPUTS') {
+    params.lines.push('- Generate missing reports and re-run this command.');
+  }
+  if (params.summary.verdict === 'BLOCKED') {
+    params.lines.push('- Resolve blocking verdicts before external handoff.');
+  }
+  if (params.summary.artifactUrls.length === 0) {
+    params.lines.push('- Attach artifact URLs from CI/workflow runs to complete handoff context.');
+  }
+  params.lines.push('- Re-run: `npm run validation:phase5-external-handoff`.');
+  params.lines.push('');
+};

package/scripts/phase5-external-handoff-markdown-sections-append-lib.ts

@@ -0,0 +1,69 @@
+import type { Phase5ExternalHandoffSummary } from './phase5-external-handoff-contract';
+import {
+  appendArtifactUrlsSection,
+  appendBlockersSection,
+  appendConsumerStartupSignalsSection,
+  appendInputsSection,
+  appendMissingInputsSection,
+  appendNextActionsSection,
+  appendParsedVerdictsSection,
+  appendWarningsSection,
+} from './phase5-external-handoff-markdown-sections-lib';
+
+export const appendPhase5ExternalHandoffSections = (params: {
+  lines: string[];
+  phase5StatusReportPath: string;
+  phase5BlockersReportPath: string;
+  consumerUnblockReportPath: string;
+  mockAbReportPath: string;
+  runReportPath: string;
+  hasPhase5StatusReport: boolean;
+  hasPhase5BlockersReport: boolean;
+  hasConsumerUnblockReport: boolean;
+  hasMockAbReport: boolean;
+  hasRunReport: boolean;
+  summary: Phase5ExternalHandoffSummary;
+}): void => {
+  appendInputsSection({
+    lines: params.lines,
+    phase5StatusReportPath: params.phase5StatusReportPath,
+    phase5BlockersReportPath: params.phase5BlockersReportPath,
+    consumerUnblockReportPath: params.consumerUnblockReportPath,
+    mockAbReportPath: params.mockAbReportPath,
+    runReportPath: params.runReportPath,
+    hasPhase5StatusReport: params.hasPhase5StatusReport,
+    hasPhase5BlockersReport: params.hasPhase5BlockersReport,
+    hasConsumerUnblockReport: params.hasConsumerUnblockReport,
+    hasMockAbReport: params.hasMockAbReport,
+    hasRunReport: params.hasRunReport,
+    summary: params.summary,
+  });
+  appendParsedVerdictsSection({
+    lines: params.lines,
+    summary: params.summary,
+  });
+  appendConsumerStartupSignalsSection({
+    lines: params.lines,
+    summary: params.summary,
+  });
+  appendArtifactUrlsSection({
+    lines: params.lines,
+    summary: params.summary,
+  });
+  appendMissingInputsSection({
+    lines: params.lines,
+    summary: params.summary,
+  });
+  appendBlockersSection({
+    lines: params.lines,
+    summary: params.summary,
+  });
+  appendWarningsSection({
+    lines: params.lines,
+    summary: params.summary,
+  });
+  appendNextActionsSection({
+    lines: params.lines,
+    summary: params.summary,
+  });
+};

package/scripts/phase5-external-handoff-markdown-sections-lib.ts

@@ -0,0 +1,12 @@
+export {
+  appendConsumerStartupSignalsSection,
+  appendInputsSection,
+  appendParsedVerdictsSection,
+} from './phase5-external-handoff-markdown-core-sections-lib';
+export {
+  appendArtifactUrlsSection,
+  appendBlockersSection,
+  appendMissingInputsSection,
+  appendNextActionsSection,
+  appendWarningsSection,
+} from './phase5-external-handoff-markdown-list-sections-lib';

package/scripts/phase5-external-handoff-summary-helpers-lib.ts

@@ -0,0 +1,9 @@
+export {
+  collectPhase5ExternalHandoffArtifactFindings,
+  collectPhase5ExternalHandoffMissingInputs,
+} from './phase5-external-handoff-inputs-artifacts-lib';
+export {
+  collectPhase5ExternalHandoffVerdictBlockers,
+  collectPhase5ExternalHandoffVerdictWarnings,
+  resolvePhase5ExternalHandoffSummaryVerdict,
+} from './phase5-external-handoff-verdict-evaluators-lib';

package/scripts/phase5-external-handoff-summary-lib.ts

@@ -0,0 +1,46 @@
+import {
+  dedupePhase5ExternalHandoffValues,
+  type Phase5ExternalHandoffSummary,
+  type SummarizePhase5ExternalHandoffParams,
+} from './phase5-external-handoff-contract';
+import {
+  collectPhase5ExternalHandoffArtifactFindings,
+  collectPhase5ExternalHandoffMissingInputs,
+  collectPhase5ExternalHandoffVerdictBlockers,
+  collectPhase5ExternalHandoffVerdictWarnings,
+  resolvePhase5ExternalHandoffSummaryVerdict,
+} from './phase5-external-handoff-summary-helpers-lib';
+
+export const summarizePhase5ExternalHandoff = (
+  params: SummarizePhase5ExternalHandoffParams
+): Phase5ExternalHandoffSummary => {
+  const missingInputs = collectPhase5ExternalHandoffMissingInputs(params);
+  const blockers =
+    missingInputs.length === 0 ? collectPhase5ExternalHandoffVerdictBlockers(params) : [];
+  const warnings =
+    missingInputs.length === 0 ? collectPhase5ExternalHandoffVerdictWarnings(params) : [];
+  const artifactFindings = collectPhase5ExternalHandoffArtifactFindings(params);
+  blockers.push(...artifactFindings.blockers);
+  warnings.push(...artifactFindings.warnings);
+  const verdict = resolvePhase5ExternalHandoffSummaryVerdict({
+    missingInputs,
+    blockers,
+  });
+
+  return {
+    verdict,
+    blockers: dedupePhase5ExternalHandoffValues(blockers),
+    missingInputs: dedupePhase5ExternalHandoffValues(missingInputs),
+    warnings: dedupePhase5ExternalHandoffValues(warnings),
+    phase5StatusVerdict: params.phase5StatusVerdict,
+    phase5BlockersVerdict: params.phase5BlockersVerdict,
+    consumerUnblockVerdict: params.consumerUnblockVerdict,
+    mockAbVerdict: params.mockAbVerdict,
+    runReportVerdict: params.runReportVerdict,
+    consumerStartupFailureRuns: params.consumerStartupFailureRuns,
+    consumerStartupStalledRuns: params.consumerStartupStalledRuns,
+    artifactUrls: dedupePhase5ExternalHandoffValues(params.artifactUrls),
+    requireArtifactUrls: params.requireArtifactUrls,
+    requireMockAbReport: params.requireMockAbReport,
+  };
+};