@deployanyway/ship-it-meter 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.4.0
+
+Twelve named demonstration scenarios show passing evidence, Friday releases, missing evidence, failed builds, failing tests, low coverage, critical issues, lint failures, dirty worktrees, feature branches, zero tests and weekend incidents. These are examples, never evidence about your real project.
+
+```sh
+
+
 ## 0.3.0 — 2026-10-08
 
 - Useful structured API/CLI additions described in README.
@@ -21,3 +28,4 @@
 
 - Deterministic readiness score with explanations and technical blocker caps.
 - CLI, documented scoring rules, tests, linting, formatting, and Node 22/24 CI.
+```

package/MIGRATION.md

@@ -3,3 +3,9 @@
 Node 22.13+ is required. Existing core APIs remain available; TypeScript declarations and CommonJS exports are new. The CLI now lives in src/cli.js behind the same executable path. Input/stdout behavior for new options is documented in README.
 
 Install 0.3.0 with npm. Seeds and exact humorous wording are version-specific. Do not treat jokes or heuristic scores as production evidence.
+
+## 0.3.0 to 0.4.0
+
+12 discoverable evidence scenarios and releasePlan with ordered blocker/review/release tasks and observable completion criteria; API and CLI scenarios/plans; passing/blocked gate exit codes preserved.
+
+Existing defaults and entry points remain available. The new release plan and demonstration scenarios are opt-in; the original scoring and gate rules are retained.

package/README.md

@@ -1,6 +1,29 @@
 # ship-it-meter
 
-> **Version 0.3.0:** install from npm with Node 22.13+ or Node 24. See MIGRATION.md for changes from 0.2.0.
+## Evidence into an actual release plan (0.4.0)
+
+Twelve named demonstration scenarios show passing evidence, Friday releases, missing evidence, failed builds, failing tests, low coverage, critical issues, lint failures, dirty worktrees, feature branches, zero tests and weekend incidents. These are examples, never evidence about your real project.
+
+```sh
+npx @deployanyway/ship-it-meter --list-scenarios
+npx @deployanyway/ship-it-meter --scenario failed-build --plan
+npx @deployanyway/ship-it-meter --scenario ready --plan --json
+```
+
+```js
+import {
+  releasePlan,
+  releaseScenarios,
+  scenarioEvidence,
+} from "@deployanyway/ship-it-meter";
+console.log(releaseScenarios());
+const plan = releasePlan(scenarioEvidence("failing-tests"), { minScore: 80 });
+console.log(plan.passed, plan.summary, plan.tasks);
+```
+
+`releasePlan(evidence?, options?)` includes the existing gate plus prioritized tasks with stable IDs and observable verification criteria. Priorities are blocker, review and release. `scenarioEvidence(name)` and `releaseScenarios()` return independent evidence copies. CLI flags override scenario fields; stdin and scenario cannot be combined. Choose one of plan, gate or checklist. A blocked plan/gate exits 1; invalid input exits 2. Readiness remains a heuristic based on caller-supplied evidence; it does not run CI or approve deployment automatically. Coverage below 80 adds a review task, not a separate hard blocker; the configured score threshold and existing gate rules still decide the gate.
+
+> **Version 0.4.0:** install from npm with Node 22.13+ or Node 24. See MIGRATION.md for changes from 0.2.0.
 
 [![npm version](https://img.shields.io/npm/v/%40deployanyway%2Fship-it-meter)](https://www.npmjs.com/package/@deployanyway/ship-it-meter)
 [![CI](https://github.com/DeployAnyway/ship-it-meter/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/DeployAnyway/ship-it-meter/actions/workflows/ci.yml)

package/dist/index.cjs

@@ -22,9 +22,136 @@ var index_exports = {};
 __export(index_exports, {
   preflight: () => preflight,
   releaseGate: () => releaseGate,
+  releasePlan: () => releasePlan,
+  releaseScenarios: () => releaseScenarios,
+  scenarioEvidence: () => scenarioEvidence,
   shipIt: () => shipIt
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/scenarios.js
+var scenarios = {
+  ready: {
+    description: "Passing evidence, clean worktree and main branch. Boring is a compliment.",
+    evidence: {
+      tests: 125,
+      coverage: 96,
+      build: true,
+      branch: "main",
+      day: "tuesday"
+    }
+  },
+  friday: {
+    description: "Good evidence on Friday. Confirm rollback and on-call before the victory lap.",
+    evidence: {
+      tests: 125,
+      coverage: 92,
+      build: true,
+      branch: "main",
+      day: "friday"
+    }
+  },
+  "no-evidence": {
+    description: "Confidence is present. Test, coverage and build evidence have not arrived.",
+    evidence: {}
+  },
+  "failed-build": {
+    description: "The build is red. The deploy button is not a color correction tool.",
+    evidence: {
+      tests: 125,
+      coverage: 92,
+      build: false
+    }
+  },
+  "failing-tests": {
+    description: "Some tests fail. Green deployment lights will not repair assertions.",
+    evidence: {
+      tests: 125,
+      failingTests: 3,
+      coverage: 92,
+      build: true
+    }
+  },
+  "low-coverage": {
+    description: "A passing build with many untested paths. The bugs appreciate the privacy.",
+    evidence: {
+      tests: 125,
+      coverage: 45,
+      build: true
+    }
+  },
+  "critical-issue": {
+    description: "A critical issue blocks the gate even when everything else looks cheerful.",
+    evidence: {
+      tests: 125,
+      coverage: 96,
+      build: true,
+      criticalIssues: 1
+    }
+  },
+  "lint-failures": {
+    description: "Lint failures are still failures, however decorative the semicolons feel.",
+    evidence: {
+      tests: 125,
+      coverage: 96,
+      build: true,
+      lintFailures: 2
+    }
+  },
+  "dirty-worktree": {
+    description: "The laptop contains uncommitted changes. It is not the release archive.",
+    evidence: {
+      tests: 125,
+      coverage: 96,
+      build: true,
+      uncommittedChanges: true
+    }
+  },
+  "feature-branch": {
+    description: "Healthy evidence on a feature branch. Verify the intended release source.",
+    evidence: {
+      tests: 125,
+      coverage: 96,
+      build: true,
+      branch: "feature/zoomies"
+    }
+  },
+  "zero-tests": {
+    description: "No tests ran. Zero failures is an especially small achievement here.",
+    evidence: {
+      tests: 0,
+      coverage: 0,
+      build: true
+    }
+  },
+  "weekend-incident": {
+    description: "A failed build, failing tests and a critical issue. Bring evidence, not a bigger confidence hat.",
+    evidence: {
+      tests: 125,
+      failingTests: 12,
+      coverage: 60,
+      build: false,
+      criticalIssues: 1,
+      day: "saturday"
+    }
+  }
+};
+function releaseScenarios() {
+  return Object.entries(scenarios).map(([name, value]) => ({
+    name,
+    description: value.description,
+    evidence: { ...value.evidence }
+  }));
+}
+function scenarioEvidence(name) {
+  if (typeof name !== "string" || !Object.hasOwn(scenarios, name))
+    throw new RangeError(
+      "Unknown scenario. Choose: " + Object.keys(scenarios).join(", ")
+    );
+  return { ...scenarios[name].evidence };
+}
+
+// src/index.js
 var days = [
   "monday",
   "tuesday",
@@ -175,9 +302,116 @@ function preflight(input = {}) {
     );
   return { ...result, actions };
 }
+function releasePlan(input = {}, options = {}) {
+  const gate = releaseGate(input, options);
+  const tasks = [];
+  const add = (id, priority, title, verify) => tasks.push({ id, priority, title, verify });
+  if (input.build !== true)
+    add(
+      "build",
+      "blocker",
+      "Get a passing build",
+      "Run the release build for the exact commit and record its successful result."
+    );
+  if (!input.tests)
+    add(
+      "tests",
+      "blocker",
+      "Run a nonempty test suite",
+      "Record the test count and outcome for the release commit."
+    );
+  if (input.failingTests)
+    add(
+      "failing-tests",
+      "blocker",
+      "Repair failing tests",
+      "Reproduce each failure, fix its cause and rerun the suite."
+    );
+  if (input.coverage === void 0)
+    add(
+      "coverage-evidence",
+      "blocker",
+      "Measure coverage",
+      "Generate coverage for the release commit and record the percentage."
+    );
+  else if (input.coverage < 80)
+    add(
+      "coverage-review",
+      "review",
+      "Review untested paths",
+      "Inspect uncovered critical paths and add meaningful tests where needed."
+    );
+  if (input.criticalIssues)
+    add(
+      "critical-issues",
+      "blocker",
+      "Resolve critical issues",
+      "Record the resolution and verify the affected behavior."
+    );
+  if (input.lintFailures)
+    add(
+      "lint",
+      "blocker",
+      "Fix lint failures",
+      "Run the configured lint checks successfully."
+    );
+  if (input.uncommittedChanges)
+    add(
+      "worktree",
+      "blocker",
+      "Reconcile local changes",
+      "Commit or stash intentionally and verify the exact release source."
+    );
+  if (input.branch && !["main", "master"].includes(input.branch.trim()))
+    add(
+      "branch",
+      "review",
+      "Confirm release branch",
+      "Verify that this branch is the intended release source and that its CI passed."
+    );
+  if (input.day?.trim().toLowerCase() === "friday")
+    add(
+      "friday",
+      "review",
+      "Confirm weekend support",
+      "Identify monitoring ownership and a tested rollback path."
+    );
+  if (gate.score < gate.minScore)
+    add(
+      "score",
+      "blocker",
+      "Improve evidence to the configured threshold",
+      "Address score deductions, rerun the checks and reevaluate the gate."
+    );
+  add(
+    "rollback",
+    "release",
+    "Prepare the return route",
+    "Verify the rollback artifact and procedure before deployment."
+  );
+  add(
+    "monitoring",
+    "release",
+    "Watch the actual release",
+    "Check health and error metrics after deployment and name an owner."
+  );
+  const summaries = {
+    "Absolutely Not": "The evidence says stop. The confidence hat can wait.",
+    Questionable: "The release has questions. Answer them before adding confetti.",
+    "Probably Fine": "Close is a useful direction, not a deployment receipt.",
+    "Ship It": "Good evidence. Keep the parachute and watch the landing.",
+    "Suspiciously Ready": "Boring, verified readiness. Give the checks their share of the applause."
+  };
+  const rank = { blocker: 0, review: 1, release: 2 };
+  tasks.sort((a, b) => rank[a.priority] - rank[b.priority]);
+  return { ...gate, summary: summaries[gate.verdict], tasks };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   preflight,
   releaseGate,
+  releasePlan,
+  releaseScenarios,
+  scenarioEvidence,
   shipIt
 });

package/index.d.cts

@@ -41,3 +41,25 @@ export function releaseGate(
   input?: Evidence,
   options?: { minScore?: number },
 ): Gate;
+
+export interface ReleaseTask {
+  id: string;
+  priority: "blocker" | "review" | "release";
+  title: string;
+  verify: string;
+}
+export interface ReleasePlan extends Gate {
+  summary: string;
+  tasks: ReleaseTask[];
+}
+export interface ReleaseScenario {
+  name: string;
+  description: string;
+  evidence: Evidence;
+}
+export function releaseScenarios(): ReleaseScenario[];
+export function scenarioEvidence(name: string): Evidence;
+export function releasePlan(
+  input?: Evidence,
+  options?: { minScore?: number },
+): ReleasePlan;

package/index.d.ts

@@ -41,3 +41,25 @@ export function releaseGate(
   input?: Evidence,
   options?: { minScore?: number },
 ): Gate;
+
+export interface ReleaseTask {
+  id: string;
+  priority: "blocker" | "review" | "release";
+  title: string;
+  verify: string;
+}
+export interface ReleasePlan extends Gate {
+  summary: string;
+  tasks: ReleaseTask[];
+}
+export interface ReleaseScenario {
+  name: string;
+  description: string;
+  evidence: Evidence;
+}
+export function releaseScenarios(): ReleaseScenario[];
+export function scenarioEvidence(name: string): Evidence;
+export function releasePlan(
+  input?: Evidence,
+  options?: { minScore?: number },
+): ReleasePlan;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deployanyway/ship-it-meter",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Explainable deployment readiness scoring for tests, coverage, and builds. Turns questionable confidence into a number.",
   "type": "module",
   "exports": {

package/src/cli.js

@@ -1,7 +1,14 @@
 import { parseArgs } from "node:util";
 import { readFileSync } from "node:fs";
 import { URL } from "node:url";
-import { shipIt, preflight, releaseGate } from "./index.js";
+import {
+  shipIt,
+  preflight,
+  releaseGate,
+  releasePlan,
+  releaseScenarios,
+  scenarioEvidence,
+} from "./index.js";
 
 import { readStdin } from "./input.js";
 
@@ -13,6 +20,9 @@ try {
       json: { type: "boolean" },
       stdin: { type: "boolean" },
       gate: { type: "boolean" },
+      plan: { type: "boolean" },
+      scenario: { type: "string" },
+      "list-scenarios": { type: "boolean" },
       "min-score": { type: "string" },
       checklist: { type: "boolean" },
       tests: { type: "string" },
@@ -28,7 +38,7 @@ try {
   });
   if (values.help) {
     console.log(
-      "Usage: ship-it-meter [options]\n\nOptions:\n  --tests number    Total tests\n  --failing number  Failing tests\n  --coverage number Coverage percent\n  --build pass|fail Build result\n  --critical number Open critical issues\n  --lint number     Lint failures\n  --dirty           Uncommitted changes\n  --branch name     Branch name\n  --day weekday     Full weekday name\n  --checklist       Actionable, mildly concerned preflight\n  --json            Structured output\n  -h, --help        Help\n  -v, --version     Version\n\n--stdin reads a JSON evidence object (256 KiB); explicit flags override it. --gate requires passing evidence; --min-score 80 selects its threshold. A blocked gate exits 1. Missing test, coverage, and build evidence reduces readiness.\nExit codes: 0 scored successfully; 2 invalid arguments.",
+      "Usage: ship-it-meter [options]\n\nOptions:\n  --tests number    Total tests\n  --failing number  Failing tests\n  --coverage number Coverage percent\n  --build pass|fail Build result\n  --critical number Open critical issues\n  --lint number     Lint failures\n  --dirty           Uncommitted changes\n  --branch name     Branch name\n  --day weekday     Full weekday name\n  --scenario name   Explore a named evidence scenario\n  --list-scenarios  List sample scenarios\n  --plan            Gate plus prioritized tasks and verification criteria\n  --checklist       Actionable, mildly concerned preflight\n  --json            Structured output\n  -h, --help        Help\n  -v, --version     Version\n\n--stdin reads a JSON evidence object (256 KiB); explicit flags override it. --gate requires passing evidence; --min-score 80 selects its threshold. A blocked gate exits 1. Missing test, coverage, and build evidence reduces readiness.\nExit codes: 0 scored successfully; 2 invalid arguments.",
     );
   } else if (values.version) {
     console.log(
@@ -36,15 +46,32 @@ try {
         readFileSync(new URL("../package.json", import.meta.url), "utf8"),
       ).version,
     );
+  } else if (values["list-scenarios"]) {
+    console.log(
+      releaseScenarios()
+        .map((item) => item.name + " — " + item.description)
+        .join("\n"),
+    );
   } else {
-    const input = values.stdin ? JSON.parse(await readStdin()) : {};
+    const input = values.stdin
+      ? JSON.parse(await readStdin())
+      : values.scenario !== undefined
+        ? scenarioEvidence(values.scenario)
+        : {};
+    if (values.stdin && values.scenario !== undefined)
+      throw new TypeError("Choose --stdin or --scenario, not both.");
+    if ([values.gate, values.plan, values.checklist].filter(Boolean).length > 1)
+      throw new TypeError("Choose one of --gate, --plan or --checklist.");
     if (!input || typeof input !== "object" || Array.isArray(input))
       throw new TypeError("stdin must contain an evidence object.");
     if (
       values["min-score"] !== undefined &&
-      (!values.gate || !/^\d+(?:\.\d+)?$/.test(values["min-score"]))
+      (!(values.gate || values.plan) ||
+        !/^\d+(?:\.\d+)?$/.test(values["min-score"]))
     )
-      throw new TypeError("--min-score requires --gate and a decimal number.");
+      throw new TypeError(
+        "--min-score requires --gate or --plan and a decimal number.",
+      );
     for (const [flag, key] of Object.entries({
       tests: "tests",
       failing: "failingTests",
@@ -66,21 +93,34 @@ try {
     for (const key of ["day", "branch"])
       if (values[key] !== undefined) input[key] = values[key];
     if (values.dirty) input.uncommittedChanges = true;
-    const result = values.gate
-      ? releaseGate(input, {
-          minScore:
-            values["min-score"] === undefined
-              ? undefined
-              : Number(values["min-score"]),
-        })
-      : values.checklist
-        ? preflight(input)
-        : shipIt(input);
-    if (values.gate && !result.passed) process.exitCode = 1;
+    const result =
+      values.gate || values.plan
+        ? (values.plan ? releasePlan : releaseGate)(input, {
+            minScore:
+              values["min-score"] === undefined
+                ? undefined
+                : Number(values["min-score"]),
+          })
+        : values.checklist
+          ? preflight(input)
+          : shipIt(input);
+    if ((values.gate || values.plan) && !result.passed) process.exitCode = 1;
+    if (values.plan && !values.json)
+      console.log(
+        result.summary +
+          "\n" +
+          result.tasks
+            .map(
+              (task) =>
+                `[${task.priority}] ${task.title}\n  Verify: ${task.verify}`,
+            )
+            .join("\n") +
+          "\n",
+      );
     console.log(
       values.json
         ? JSON.stringify(result, null, 2)
-        : `${result.score}/100 — ${result.verdict}${values.gate ? (result.passed ? " — gate passed" : " — gate blocked") : ""}\n${result.reasons.map((reason) => `- ${reason}`).join("\n")}${result.actions ? "\n\nBefore you ship:\n" + result.actions.map((action) => `[ ] ${action}`).join("\n") : ""}`,
+        : `${result.score}/100 — ${result.verdict}${values.gate || values.plan ? (result.passed ? " — gate passed" : " — gate blocked") : ""}\n${result.reasons.map((reason) => `- ${reason}`).join("\n")}${result.actions ? "\n\nBefore you ship:\n" + result.actions.map((action) => `[ ] ${action}`).join("\n") : ""}`,
     );
   }
 } catch (error) {

package/src/index.js

@@ -187,3 +187,113 @@ export function preflight(input = {}) {
     );
   return { ...result, actions };
 }
+
+export { releaseScenarios, scenarioEvidence } from "./scenarios.js";
+/** Explain the gate as ordered work with observable completion criteria. */
+export function releasePlan(input = {}, options = {}) {
+  const gate = releaseGate(input, options);
+  const tasks = [];
+  const add = (id, priority, title, verify) =>
+    tasks.push({ id, priority, title, verify });
+  if (input.build !== true)
+    add(
+      "build",
+      "blocker",
+      "Get a passing build",
+      "Run the release build for the exact commit and record its successful result.",
+    );
+  if (!input.tests)
+    add(
+      "tests",
+      "blocker",
+      "Run a nonempty test suite",
+      "Record the test count and outcome for the release commit.",
+    );
+  if (input.failingTests)
+    add(
+      "failing-tests",
+      "blocker",
+      "Repair failing tests",
+      "Reproduce each failure, fix its cause and rerun the suite.",
+    );
+  if (input.coverage === undefined)
+    add(
+      "coverage-evidence",
+      "blocker",
+      "Measure coverage",
+      "Generate coverage for the release commit and record the percentage.",
+    );
+  else if (input.coverage < 80)
+    add(
+      "coverage-review",
+      "review",
+      "Review untested paths",
+      "Inspect uncovered critical paths and add meaningful tests where needed.",
+    );
+  if (input.criticalIssues)
+    add(
+      "critical-issues",
+      "blocker",
+      "Resolve critical issues",
+      "Record the resolution and verify the affected behavior.",
+    );
+  if (input.lintFailures)
+    add(
+      "lint",
+      "blocker",
+      "Fix lint failures",
+      "Run the configured lint checks successfully.",
+    );
+  if (input.uncommittedChanges)
+    add(
+      "worktree",
+      "blocker",
+      "Reconcile local changes",
+      "Commit or stash intentionally and verify the exact release source.",
+    );
+  if (input.branch && !["main", "master"].includes(input.branch.trim()))
+    add(
+      "branch",
+      "review",
+      "Confirm release branch",
+      "Verify that this branch is the intended release source and that its CI passed.",
+    );
+  if (input.day?.trim().toLowerCase() === "friday")
+    add(
+      "friday",
+      "review",
+      "Confirm weekend support",
+      "Identify monitoring ownership and a tested rollback path.",
+    );
+  if (gate.score < gate.minScore)
+    add(
+      "score",
+      "blocker",
+      "Improve evidence to the configured threshold",
+      "Address score deductions, rerun the checks and reevaluate the gate.",
+    );
+  add(
+    "rollback",
+    "release",
+    "Prepare the return route",
+    "Verify the rollback artifact and procedure before deployment.",
+  );
+  add(
+    "monitoring",
+    "release",
+    "Watch the actual release",
+    "Check health and error metrics after deployment and name an owner.",
+  );
+  const summaries = {
+    "Absolutely Not": "The evidence says stop. The confidence hat can wait.",
+    Questionable:
+      "The release has questions. Answer them before adding confetti.",
+    "Probably Fine": "Close is a useful direction, not a deployment receipt.",
+    "Ship It": "Good evidence. Keep the parachute and watch the landing.",
+    "Suspiciously Ready":
+      "Boring, verified readiness. Give the checks their share of the applause.",
+  };
+  const rank = { blocker: 0, review: 1, release: 2 };
+  tasks.sort((a, b) => rank[a.priority] - rank[b.priority]);
+  return { ...gate, summary: summaries[gate.verdict], tasks };
+}

package/src/scenarios.js

@@ -0,0 +1,133 @@
+// Demonstration inputs, never a claim about a real release.
+const scenarios = {
+  ready: {
+    description:
+      "Passing evidence, clean worktree and main branch. Boring is a compliment.",
+    evidence: {
+      tests: 125,
+      coverage: 96,
+      build: true,
+      branch: "main",
+      day: "tuesday",
+    },
+  },
+  friday: {
+    description:
+      "Good evidence on Friday. Confirm rollback and on-call before the victory lap.",
+    evidence: {
+      tests: 125,
+      coverage: 92,
+      build: true,
+      branch: "main",
+      day: "friday",
+    },
+  },
+  "no-evidence": {
+    description:
+      "Confidence is present. Test, coverage and build evidence have not arrived.",
+    evidence: {},
+  },
+  "failed-build": {
+    description:
+      "The build is red. The deploy button is not a color correction tool.",
+    evidence: {
+      tests: 125,
+      coverage: 92,
+      build: false,
+    },
+  },
+  "failing-tests": {
+    description:
+      "Some tests fail. Green deployment lights will not repair assertions.",
+    evidence: {
+      tests: 125,
+      failingTests: 3,
+      coverage: 92,
+      build: true,
+    },
+  },
+  "low-coverage": {
+    description:
+      "A passing build with many untested paths. The bugs appreciate the privacy.",
+    evidence: {
+      tests: 125,
+      coverage: 45,
+      build: true,
+    },
+  },
+  "critical-issue": {
+    description:
+      "A critical issue blocks the gate even when everything else looks cheerful.",
+    evidence: {
+      tests: 125,
+      coverage: 96,
+      build: true,
+      criticalIssues: 1,
+    },
+  },
+  "lint-failures": {
+    description:
+      "Lint failures are still failures, however decorative the semicolons feel.",
+    evidence: {
+      tests: 125,
+      coverage: 96,
+      build: true,
+      lintFailures: 2,
+    },
+  },
+  "dirty-worktree": {
+    description:
+      "The laptop contains uncommitted changes. It is not the release archive.",
+    evidence: {
+      tests: 125,
+      coverage: 96,
+      build: true,
+      uncommittedChanges: true,
+    },
+  },
+  "feature-branch": {
+    description:
+      "Healthy evidence on a feature branch. Verify the intended release source.",
+    evidence: {
+      tests: 125,
+      coverage: 96,
+      build: true,
+      branch: "feature/zoomies",
+    },
+  },
+  "zero-tests": {
+    description:
+      "No tests ran. Zero failures is an especially small achievement here.",
+    evidence: {
+      tests: 0,
+      coverage: 0,
+      build: true,
+    },
+  },
+  "weekend-incident": {
+    description:
+      "A failed build, failing tests and a critical issue. Bring evidence, not a bigger confidence hat.",
+    evidence: {
+      tests: 125,
+      failingTests: 12,
+      coverage: 60,
+      build: false,
+      criticalIssues: 1,
+      day: "saturday",
+    },
+  },
+};
+export function releaseScenarios() {
+  return Object.entries(scenarios).map(([name, value]) => ({
+    name,
+    description: value.description,
+    evidence: { ...value.evidence },
+  }));
+}
+export function scenarioEvidence(name) {
+  if (typeof name !== "string" || !Object.hasOwn(scenarios, name))
+    throw new RangeError(
+      "Unknown scenario. Choose: " + Object.keys(scenarios).join(", "),
+    );
+  return { ...scenarios[name].evidence };
+}