@design-ai/cli 4.56.0 → 4.57.0

package/cli/lib/site-bundle-handoff-runbook-human-lines.mjs

@@ -0,0 +1,167 @@
+// Human-readable stage line rows and summaries for the bundle-handoff operator runbook.
+
+import {
+  formatBundleHandoffOperatorRunbookStageLine,
+} from "./site-bundle-handoff-runbook-format.mjs";
+import {
+  byKey,
+  hasCommands,
+  isManualStage,
+  isOptionalStage,
+  isRequiredStage,
+} from "./site-bundle-handoff-runbook-maps.mjs";
+
+export function buildStageHumanLineMaps(
+  stages,
+  stageActionRows,
+  stageActionEvidenceCaptureInitialValidationChecklistSummaryByKey,
+) {
+  const stageHumanLines = stages.map((stage) => formatBundleHandoffOperatorRunbookStageLine(
+    stage,
+    stageActionEvidenceCaptureInitialValidationChecklistSummaryByKey[stage.key],
+  ));
+  const stageHumanLineByKey = byKey(stages, (_stage, index) => stageHumanLines[index]);
+  const stageHumanLineDisplayRows = stages.map((stage, index) => {
+    const actionRow = stageActionRows[index];
+    const evidenceProgress = actionRow.actionEvidenceCaptureInitialValidationChecklistSummary;
+    const displayRowIdentity = {
+      step: stage.step,
+      key: stage.key,
+      label: stage.label,
+      line: stageHumanLines[index],
+    };
+    const displayRowExecutionContext = {
+      required: stage.required,
+      manual: isManualStage(stage),
+      commandCount: stage.commandCount,
+    };
+    const displayRowActionStatus = {
+      actionType: actionRow.actionType,
+      actionLabel: actionRow.actionLabel,
+      actionStatus: actionRow.actionStatus,
+      actionStatusLabel: actionRow.actionStatusLabel,
+      actionStatusTone: actionRow.actionStatusTone,
+    };
+    const displayRowEvidenceProgress = {
+      hasEvidenceProgress: evidenceProgress.itemCount > 0,
+      evidenceProgressStatus: evidenceProgress.status || "",
+      evidenceProgressStatusLabel: evidenceProgress.statusLabel || "",
+      evidenceProgressStatusTone: evidenceProgress.statusTone || "",
+      evidenceProgressIconName: evidenceProgress.iconName || "",
+      evidenceProgressLabel: evidenceProgress.progressLabel || "",
+      evidenceCompletionPercent: evidenceProgress.completionPercent ?? 0,
+      firstUncheckedEvidenceItemLabel: evidenceProgress.firstUncheckedItemLabel || "",
+    };
+    return {
+      ...displayRowIdentity,
+      ...displayRowExecutionContext,
+      ...displayRowActionStatus,
+      ...displayRowEvidenceProgress,
+    };
+  });
+  const stageHumanLineDisplayRowByKey = byKey(stageHumanLineDisplayRows, (row) => row);
+  const countBy = (predicate) => stages.filter(predicate).length;
+  const stageKeysBy = (predicate) => stages.filter(predicate).map((stage) => stage.key);
+  const countActions = (predicate) => stageActionRows.filter(predicate).length;
+  const firstActionKey = (predicate) => stageActionRows.find(predicate)?.key || "";
+  const displayRowKeysBy = (predicate) => stageHumanLineDisplayRows.filter(predicate).map((row) => row.key);
+  const countDisplayRows = (predicate) => stageHumanLineDisplayRows.filter(predicate).length;
+  const firstDisplayRowKey = (predicate) => stageHumanLineDisplayRows.find(predicate)?.key || "";
+  const isRequiredDisplayRow = (row) => row.required;
+  const isOptionalDisplayRow = (row) => !row.required;
+  const hasCommandDisplayRow = (row) => row.commandCount > 0;
+  const isManualDisplayRow = (row) => row.manual;
+  const hasReadyActionStatus = (row) => row.actionStatus === "ready";
+  const hasOptionalActionStatus = (row) => row.actionStatus === "optional";
+  const hasManualActionStatus = (row) => row.actionStatus === "manual";
+  const hasBlockedActionStatus = (row) => row.actionStatus === "blocked";
+  const hasDisplayRowEvidenceProgress = (row) => row.hasEvidenceProgress;
+  const hasBlockedDisplayRowEvidenceProgress = (row) => row.evidenceProgressStatus === "blocked";
+  const hasReadyDisplayRowEvidenceProgress = (row) => row.evidenceProgressStatus === "ready";
+  const hasEvidenceProgress = (stage) => (
+    stage.actionEvidenceCaptureInitialValidationChecklistSummary.itemCount > 0
+  );
+  const hasBlockedEvidenceProgress = (stage) => (
+    stage.actionEvidenceCaptureInitialValidationChecklistSummary.status === "blocked"
+  );
+  const hasReadyEvidenceProgress = (stage) => (
+    stage.actionEvidenceCaptureInitialValidationChecklistSummary.status === "ready"
+  );
+  const stageHumanLineDisplayRowKeysByActionStatus = {
+    ready: displayRowKeysBy(hasReadyActionStatus),
+    optional: displayRowKeysBy(hasOptionalActionStatus),
+    manual: displayRowKeysBy(hasManualActionStatus),
+    blocked: displayRowKeysBy(hasBlockedActionStatus),
+  };
+  const stageHumanLineDisplayRowKeysByEvidenceProgressStatus = {
+    blocked: displayRowKeysBy(hasBlockedDisplayRowEvidenceProgress),
+    ready: displayRowKeysBy(hasReadyDisplayRowEvidenceProgress),
+  };
+  const stageHumanLineDisplayRowCountSummary = {
+    count: stageHumanLineDisplayRows.length,
+    byKeyCount: Object.keys(stageHumanLineDisplayRowByKey).length,
+    requiredCount: countDisplayRows(isRequiredDisplayRow),
+    optionalCount: countDisplayRows(isOptionalDisplayRow),
+    commandCount: countDisplayRows(hasCommandDisplayRow),
+    manualCount: countDisplayRows(isManualDisplayRow),
+  };
+  const stageHumanLineDisplayRowActionStatusSummary = {
+    readyActionStatusCount: countDisplayRows(hasReadyActionStatus),
+    optionalActionStatusCount: countDisplayRows(hasOptionalActionStatus),
+    manualActionStatusCount: countDisplayRows(hasManualActionStatus),
+    blockedActionStatusCount: countDisplayRows(hasBlockedActionStatus),
+  };
+  const stageHumanLineDisplayRowEvidenceProgressSummary = {
+    evidenceProgressCount: countDisplayRows(hasDisplayRowEvidenceProgress),
+    blockedEvidenceProgressCount: countDisplayRows(hasBlockedDisplayRowEvidenceProgress),
+    readyEvidenceProgressCount: countDisplayRows(hasReadyDisplayRowEvidenceProgress),
+  };
+  const stageHumanLineDisplayRowFirstKeySummary = {
+    firstRowKey: stageHumanLineDisplayRows[0]?.key || "",
+    firstReadyActionRowKey: firstDisplayRowKey(hasReadyActionStatus),
+    firstOptionalActionRowKey: firstDisplayRowKey(hasOptionalActionStatus),
+    firstManualActionRowKey: firstDisplayRowKey(hasManualActionStatus),
+    firstBlockedEvidenceProgressRowKey: firstDisplayRowKey(hasBlockedDisplayRowEvidenceProgress),
+    firstReadyEvidenceProgressRowKey: firstDisplayRowKey(hasReadyDisplayRowEvidenceProgress),
+  };
+  const stageHumanLineDisplayRowSummary = {
+    ...stageHumanLineDisplayRowCountSummary,
+    ...stageHumanLineDisplayRowActionStatusSummary,
+    ...stageHumanLineDisplayRowEvidenceProgressSummary,
+    ...stageHumanLineDisplayRowFirstKeySummary,
+  };
+  const stageHumanLineCountSummary = {
+    count: stageHumanLines.length,
+    byKeyCount: Object.keys(stageHumanLineByKey).length,
+    requiredCount: countBy(isRequiredStage),
+    optionalCount: countBy(isOptionalStage),
+    commandCount: countBy(hasCommands),
+    manualCount: countBy(isManualStage),
+  };
+  const stageHumanLineEvidenceProgressSummary = {
+    evidenceProgressCount: countActions(hasEvidenceProgress),
+    blockedEvidenceProgressCount: countActions(hasBlockedEvidenceProgress),
+    readyEvidenceProgressCount: countActions(hasReadyEvidenceProgress),
+  };
+  const stageHumanLineFirstValueSummary = {
+    firstStageKey: stages[0]?.key || "",
+    firstLine: stageHumanLines[0] || "",
+    firstEvidenceProgressStageKey: firstActionKey(hasEvidenceProgress),
+    firstBlockedEvidenceProgressStageKey: firstActionKey(hasBlockedEvidenceProgress),
+  };
+  const stageHumanLineSummary = {
+    ...stageHumanLineCountSummary,
+    ...stageHumanLineEvidenceProgressSummary,
+    ...stageHumanLineFirstValueSummary,
+  };
+  return {
+    stageHumanLines,
+    stageHumanLineByKey,
+    stageHumanLineDisplayRows,
+    stageHumanLineDisplayRowByKey,
+    stageHumanLineDisplayRowKeysByActionStatus,
+    stageHumanLineDisplayRowKeysByEvidenceProgressStatus,
+    stageHumanLineDisplayRowSummary,
+    stageHumanLineSummary,
+  };
+}

package/cli/lib/site-bundle-handoff-runbook-maps.mjs

@@ -0,0 +1,238 @@
+// Stage/action key-map builders and stage predicates for the bundle-handoff operator runbook.
+
+export const byKey = (rows, getValue) => Object.fromEntries(
+  rows.map((row, index) => [row.key, getValue(row, index)]),
+);
+export const fieldByKey = (rows, field) => byKey(rows, (row) => row[field]);
+export const hasCommands = (stage) => stage.commandCount > 0;
+export const isManualStage = (stage) => !hasCommands(stage);
+export const isRequiredStage = (stage) => stage.required;
+export const isOptionalStage = (stage) => !stage.required;
+export const usesReadOnlyRunPolicy = (stage) => stage.runPolicy === "read-only";
+export const usesLocalOutputRunPolicy = (stage) => stage.runPolicy === "writes-local-file";
+export const hasOutputFile = (stage) => stage.outputFiles.length > 0;
+export const callsExternalSystem = (stage) => stage.externalCalls;
+export const mutatesTargetRepo = (stage) => stage.targetRepoMutation;
+
+export function buildStageIdentityMaps(stages) {
+  const stageFieldByKey = (field) => fieldByKey(stages, field);
+  const stageKeys = stages.map((stage) => stage.key);
+  const stageByKey = byKey(stages, (stage) => stage);
+  const stageLabelByKey = stageFieldByKey("label");
+  const stageSummaryByKey = stageFieldByKey("reason");
+  return {
+    stageKeys,
+    stageByKey,
+    stageLabelByKey,
+    stageSummaryByKey,
+  };
+}
+
+export function buildStageActionStatusMaps(stageActionRows) {
+  const actionFieldByKey = (field) => fieldByKey(stageActionRows, field);
+  const stageActionTypeByKey = actionFieldByKey("actionType");
+  const stageActionLabelByKey = actionFieldByKey("actionLabel");
+  const stageActionInstructionsByKey = actionFieldByKey("actionInstruction");
+  const stageActionButtonLabelsByKey = actionFieldByKey("actionButtonLabel");
+  const stageActionAffordanceByKey = actionFieldByKey("actionAffordance");
+  const stageActionEnabledByKey = actionFieldByKey("actionEnabled");
+  const stageActionStatusByKey = actionFieldByKey("actionStatus");
+  const stageActionStatusLabelsByKey = actionFieldByKey("actionStatusLabel");
+  const stageActionStatusToneByKey = actionFieldByKey("actionStatusTone");
+  const stageActionDisabledReasonCodeByKey = actionFieldByKey("actionDisabledReasonCode");
+  const stageActionDisabledReasonByKey = actionFieldByKey("actionDisabledReason");
+  return {
+    stageActionRows,
+    stageActionTypeByKey,
+    stageActionLabelByKey,
+    stageActionInstructionsByKey,
+    stageActionButtonLabelsByKey,
+    stageActionAffordanceByKey,
+    stageActionEnabledByKey,
+    stageActionStatusByKey,
+    stageActionStatusLabelsByKey,
+    stageActionStatusToneByKey,
+    stageActionDisabledReasonCodeByKey,
+    stageActionDisabledReasonByKey,
+  };
+}
+
+export function buildStageActionDependencyMaps(stageActionRows) {
+  const actionFieldByKey = (field) => fieldByKey(stageActionRows, field);
+  const stageActionPrerequisiteKeysByKey = actionFieldByKey("actionPrerequisiteKeys");
+  const stageActionPrerequisiteLabelsByKey = actionFieldByKey("actionPrerequisiteLabels");
+  const stageActionPrerequisiteCountByKey = actionFieldByKey("actionPrerequisiteCount");
+  const stageActionHasPrerequisitesByKey = actionFieldByKey("actionHasPrerequisites");
+  const stageActionDependencyReasonCodeByKey = actionFieldByKey("actionDependencyReasonCode");
+  const stageActionDependencyReasonByKey = actionFieldByKey("actionDependencyReason");
+  const stageActionBlockedStageKeysByKey = actionFieldByKey("actionBlockedStageKeys");
+  const stageActionBlockedStageLabelsByKey = actionFieldByKey("actionBlockedStageLabels");
+  const stageActionBlockedStageCountByKey = actionFieldByKey("actionBlockedStageCount");
+  const stageActionBlocksStagesByKey = actionFieldByKey("actionBlocksStages");
+  const stageActionCompletionCriteriaByKey = actionFieldByKey("actionCompletionCriteria");
+  const stageActionCompletionCriteriaCountByKey = actionFieldByKey("actionCompletionCriteriaCount");
+  const stageActionHasCompletionCriteriaByKey = actionFieldByKey("actionHasCompletionCriteria");
+  return {
+    stageActionPrerequisiteKeysByKey,
+    stageActionPrerequisiteLabelsByKey,
+    stageActionPrerequisiteCountByKey,
+    stageActionHasPrerequisitesByKey,
+    stageActionDependencyReasonCodeByKey,
+    stageActionDependencyReasonByKey,
+    stageActionBlockedStageKeysByKey,
+    stageActionBlockedStageLabelsByKey,
+    stageActionBlockedStageCountByKey,
+    stageActionBlocksStagesByKey,
+    stageActionCompletionCriteriaByKey,
+    stageActionCompletionCriteriaCountByKey,
+    stageActionHasCompletionCriteriaByKey,
+  };
+}
+
+export function buildStageActionEvidenceMaps(stageActionRows) {
+  const actionFieldByKey = (field) => fieldByKey(stageActionRows, field);
+  const stageActionEvidenceRequirementsByKey = actionFieldByKey("actionEvidenceRequirements");
+  const stageActionEvidenceRequirementCountByKey = actionFieldByKey("actionEvidenceRequirementCount");
+  const stageActionRequiresEvidenceByKey = actionFieldByKey("actionRequiresEvidence");
+  const stageActionEvidenceTargetByKey = actionFieldByKey("actionEvidenceTarget");
+  const stageActionEvidenceTargetLabelByKey = actionFieldByKey("actionEvidenceTargetLabel");
+  return {
+    stageActionEvidenceRequirementsByKey,
+    stageActionEvidenceRequirementCountByKey,
+    stageActionRequiresEvidenceByKey,
+    stageActionEvidenceTargetByKey,
+    stageActionEvidenceTargetLabelByKey,
+  };
+}
+
+export function buildStageActionEvidenceCaptureMaps(stageActionRows) {
+  const actionFieldByKey = (field) => fieldByKey(stageActionRows, field);
+  const stageActionEvidenceCaptureFieldsByKey = actionFieldByKey("actionEvidenceCaptureFields");
+  const stageActionEvidenceCaptureFieldKeysByKey = actionFieldByKey("actionEvidenceCaptureFieldKeys");
+  const stageActionEvidenceCaptureFieldLabelsByKey = actionFieldByKey("actionEvidenceCaptureFieldLabels");
+  const stageActionEvidenceCaptureFieldPlaceholdersByKey = actionFieldByKey("actionEvidenceCaptureFieldPlaceholders");
+  const stageActionEvidenceCaptureFieldRequirementLabelsByKey = actionFieldByKey("actionEvidenceCaptureFieldRequirementLabels");
+  const stageActionEvidenceCaptureFieldAriaLabelsByKey = actionFieldByKey("actionEvidenceCaptureFieldAriaLabels");
+  const stageActionEvidenceCaptureFieldHelpTextsByKey = actionFieldByKey("actionEvidenceCaptureFieldHelpTexts");
+  const stageActionEvidenceCaptureFieldSectionKeysByKey = actionFieldByKey("actionEvidenceCaptureFieldSectionKeys");
+  const stageActionEvidenceCaptureFieldSectionLabelsByKey = actionFieldByKey("actionEvidenceCaptureFieldSectionLabels");
+  const stageActionEvidenceCaptureSectionKeysByKey = actionFieldByKey("actionEvidenceCaptureSectionKeys");
+  const stageActionEvidenceCaptureSectionLabelsByKey = actionFieldByKey("actionEvidenceCaptureSectionLabels");
+  const stageActionEvidenceCaptureSectionCountByKey = actionFieldByKey("actionEvidenceCaptureSectionCount");
+  const stageActionEvidenceCaptureFieldPayloadNamespacesByKey = actionFieldByKey("actionEvidenceCaptureFieldPayloadNamespaces");
+  const stageActionEvidenceCaptureFieldPayloadPathsByKey = actionFieldByKey("actionEvidenceCaptureFieldPayloadPaths");
+  const stageActionEvidenceCapturePayloadNamespacesByKey = actionFieldByKey("actionEvidenceCapturePayloadNamespaces");
+  const stageActionEvidenceCapturePayloadNamespaceCountByKey = actionFieldByKey("actionEvidenceCapturePayloadNamespaceCount");
+  const stageActionEvidenceCapturePayloadTemplateByKey = actionFieldByKey("actionEvidenceCapturePayloadTemplate");
+  const stageActionEvidenceCapturePayloadFlatTemplateByKey = actionFieldByKey("actionEvidenceCapturePayloadFlatTemplate");
+  const stageActionEvidenceCapturePayloadBindingsByKey = actionFieldByKey("actionEvidenceCapturePayloadBindings");
+  const stageActionEvidenceCaptureValidationSpecsByKey = actionFieldByKey("actionEvidenceCaptureValidationSpecs");
+  const stageActionEvidenceCaptureInitialValidationStatesByKey = actionFieldByKey("actionEvidenceCaptureInitialValidationStates");
+  const stageActionEvidenceCaptureInitialValidationDisplayMetadataByKey = actionFieldByKey("actionEvidenceCaptureInitialValidationDisplayMetadata");
+  const stageActionEvidenceCaptureInitialValidationChecklistByKey = actionFieldByKey("actionEvidenceCaptureInitialValidationChecklist");
+  const stageActionEvidenceCaptureInitialValidationChecklistSummaryByKey = actionFieldByKey("actionEvidenceCaptureInitialValidationChecklistSummary");
+  const stageActionEvidenceCaptureInitialValidationSummaryByKey = actionFieldByKey("actionEvidenceCaptureInitialValidationSummary");
+  const stageActionEvidenceCaptureFieldInputTypesByKey = actionFieldByKey("actionEvidenceCaptureFieldInputTypes");
+  const stageActionEvidenceCaptureFieldValueShapesByKey = actionFieldByKey("actionEvidenceCaptureFieldValueShapes");
+  const stageActionEvidenceCaptureFieldAcceptsMultipleByKey = actionFieldByKey("actionEvidenceCaptureFieldAcceptsMultiple");
+  const stageActionEvidenceCaptureFieldDefaultValuesByKey = actionFieldByKey("actionEvidenceCaptureFieldDefaultValues");
+  const stageActionEvidenceCaptureFieldEmptyValuesByKey = actionFieldByKey("actionEvidenceCaptureFieldEmptyValues");
+  const stageActionEvidenceCaptureFieldValidationRulesByKey = actionFieldByKey("actionEvidenceCaptureFieldValidationRules");
+  const stageActionEvidenceCaptureFieldMinLengthsByKey = actionFieldByKey("actionEvidenceCaptureFieldMinLengths");
+  const stageActionEvidenceCaptureFieldExamplesByKey = actionFieldByKey("actionEvidenceCaptureFieldExamples");
+  const stageActionEvidenceCaptureFieldValidationHintsByKey = actionFieldByKey("actionEvidenceCaptureFieldValidationHints");
+  const stageActionRequiredEvidenceCaptureFieldKeysByKey = actionFieldByKey("actionRequiredEvidenceCaptureFieldKeys");
+  const stageActionOptionalEvidenceCaptureFieldKeysByKey = actionFieldByKey("actionOptionalEvidenceCaptureFieldKeys");
+  const stageActionEvidenceCaptureFieldCountByKey = actionFieldByKey("actionEvidenceCaptureFieldCount");
+  const stageActionRequiredEvidenceCaptureFieldCountByKey = actionFieldByKey("actionRequiredEvidenceCaptureFieldCount");
+  const stageActionOptionalEvidenceCaptureFieldCountByKey = actionFieldByKey("actionOptionalEvidenceCaptureFieldCount");
+  const stageActionHasEvidenceCaptureFieldsByKey = actionFieldByKey("actionHasEvidenceCaptureFields");
+  return {
+    stageActionEvidenceCaptureFieldsByKey,
+    stageActionEvidenceCaptureFieldKeysByKey,
+    stageActionEvidenceCaptureFieldLabelsByKey,
+    stageActionEvidenceCaptureFieldPlaceholdersByKey,
+    stageActionEvidenceCaptureFieldRequirementLabelsByKey,
+    stageActionEvidenceCaptureFieldAriaLabelsByKey,
+    stageActionEvidenceCaptureFieldHelpTextsByKey,
+    stageActionEvidenceCaptureFieldSectionKeysByKey,
+    stageActionEvidenceCaptureFieldSectionLabelsByKey,
+    stageActionEvidenceCaptureSectionKeysByKey,
+    stageActionEvidenceCaptureSectionLabelsByKey,
+    stageActionEvidenceCaptureSectionCountByKey,
+    stageActionEvidenceCaptureFieldPayloadNamespacesByKey,
+    stageActionEvidenceCaptureFieldPayloadPathsByKey,
+    stageActionEvidenceCapturePayloadNamespacesByKey,
+    stageActionEvidenceCapturePayloadNamespaceCountByKey,
+    stageActionEvidenceCapturePayloadTemplateByKey,
+    stageActionEvidenceCapturePayloadFlatTemplateByKey,
+    stageActionEvidenceCapturePayloadBindingsByKey,
+    stageActionEvidenceCaptureValidationSpecsByKey,
+    stageActionEvidenceCaptureInitialValidationStatesByKey,
+    stageActionEvidenceCaptureInitialValidationDisplayMetadataByKey,
+    stageActionEvidenceCaptureInitialValidationChecklistByKey,
+    stageActionEvidenceCaptureInitialValidationChecklistSummaryByKey,
+    stageActionEvidenceCaptureInitialValidationSummaryByKey,
+    stageActionEvidenceCaptureFieldInputTypesByKey,
+    stageActionEvidenceCaptureFieldValueShapesByKey,
+    stageActionEvidenceCaptureFieldAcceptsMultipleByKey,
+    stageActionEvidenceCaptureFieldDefaultValuesByKey,
+    stageActionEvidenceCaptureFieldEmptyValuesByKey,
+    stageActionEvidenceCaptureFieldValidationRulesByKey,
+    stageActionEvidenceCaptureFieldMinLengthsByKey,
+    stageActionEvidenceCaptureFieldExamplesByKey,
+    stageActionEvidenceCaptureFieldValidationHintsByKey,
+    stageActionRequiredEvidenceCaptureFieldKeysByKey,
+    stageActionOptionalEvidenceCaptureFieldKeysByKey,
+    stageActionEvidenceCaptureFieldCountByKey,
+    stageActionRequiredEvidenceCaptureFieldCountByKey,
+    stageActionOptionalEvidenceCaptureFieldCountByKey,
+    stageActionHasEvidenceCaptureFieldsByKey,
+  };
+}
+
+export function buildStageExecutionMaps(stages) {
+  const stageFieldByKey = (field) => fieldByKey(stages, field);
+  const commandListByKey = (getValue) => byKey(stages, (stage) => stage.commands.map(getValue));
+  const stageKeysBy = (predicate) => stages.filter(predicate).map((stage) => stage.key);
+  const stageKindByKey = stageFieldByKey("kind");
+  const stageRequiredByKey = stageFieldByKey("required");
+  const stageRunPolicyByKey = stageFieldByKey("runPolicy");
+  const stageSafetyLevelByKey = stageFieldByKey("safetyLevel");
+  const stageCommandCountByKey = stageFieldByKey("commandCount");
+  const stageCommandKeysByKey = stageFieldByKey("commandKeys");
+  const stageCommandLabelsByKey = commandListByKey((command) => command.label);
+  const stageCommandStringsByKey = commandListByKey((command) => command.command);
+  const stageCommandArgsByKey = commandListByKey((command) => command.commandArgs);
+  const stageCommandRunPoliciesByKey = commandListByKey((command) => command.runPolicy);
+  const stageCommandSafetyLevelsByKey = commandListByKey((command) => command.safety?.safetyLevel || "");
+  const stageOutputFilesByKey = stageFieldByKey("outputFiles");
+  const stageHasCommandsByKey = byKey(stages, hasCommands);
+  const stageManualByKey = byKey(stages, isManualStage);
+  const stageWritesLocalFileByKey = stageFieldByKey("writesLocalFile");
+  const stageExternalCallsByKey = stageFieldByKey("externalCalls");
+  const stageTargetRepoMutationByKey = stageFieldByKey("targetRepoMutation");
+  const commandStageKeys = stageKeysBy(hasCommands);
+  const manualStageKeys = stageKeysBy(isManualStage);
+  return {
+    stageKindByKey,
+    stageRequiredByKey,
+    stageRunPolicyByKey,
+    stageSafetyLevelByKey,
+    stageCommandCountByKey,
+    stageCommandKeysByKey,
+    stageCommandLabelsByKey,
+    stageCommandStringsByKey,
+    stageCommandArgsByKey,
+    stageCommandRunPoliciesByKey,
+    stageCommandSafetyLevelsByKey,
+    stageOutputFilesByKey,
+    stageHasCommandsByKey,
+    stageManualByKey,
+    stageWritesLocalFileByKey,
+    stageExternalCallsByKey,
+    stageTargetRepoMutationByKey,
+    commandStageKeys,
+    manualStageKeys,
+  };
+}