@cleocode/contracts 2026.5.78 → 2026.5.79

package/dist/release/plan.js

@@ -0,0 +1,393 @@
+/**
+ * Release Plan contracts — canonical Zod schema for `.cleo/release/<version>.plan.json`.
+ *
+ * The plan file is the source-of-truth state record for a release as it moves
+ * through the canonical FSM:
+ *
+ *   planned → pr-opened → pr-merged → published → reconciled
+ *
+ * Off-ramp terminal states: `rolled_back`, `failed`, `cancelled`.
+ *
+ * This module defines the normative shape per SPEC-T9345 §6.1/§6.2. Consumers:
+ *
+ * - `cleo release plan`      (T9525) — INSERTs status=planned
+ * - `cleo release open`      (T9525) — UPDATEs status=pr-opened
+ * - `cleo release reconcile` (T9526) — re-validates and UPDATEs status=reconciled
+ *
+ * The schema is permissive on `evidenceAtoms` (length-zero arrays are
+ * structurally valid) — the non-empty invariant (R-301) is enforced by the
+ * verb implementations, not the contract, so backfill / migration tooling can
+ * load historical plans without contract-level rejection.
+ *
+ * @task T9527
+ * @epic T9492
+ * @adr  ADR-T9345 (IVTR-release-overhaul)
+ * @spec .cleo/rcasd/T9345/research/SPEC-T9345-release-pipeline-v2.md §6
+ */
+import { z } from 'zod';
+// ─── Schema version ──────────────────────────────────────────────────────────
+/**
+ * Semantic version of the Release Plan contract.
+ *
+ * Increment the MAJOR component on incompatible field renames or removals.
+ * Increment MINOR on additive optional-field changes. The plan JSON `$schema`
+ * URL is keyed off the MAJOR component (`/release-plan/v1.json` for `1.x.y`).
+ */
+export const RELEASE_PLAN_SCHEMA_VERSION = '1.0.0';
+/**
+ * Canonical `$schema` URL embedded in plan files at write time. Consumers MAY
+ * use this string to identify the contract version when parsing legacy plans.
+ */
+export const RELEASE_PLAN_SCHEMA_URL = 'https://cleocode.io/schemas/release-plan/v1.json';
+// ─── Enum literal tuples (exported for external introspection) ───────────────
+/**
+ * Canonical npm dist-tag channels supported by the release pipeline.
+ *
+ * Includes `rc` in addition to the legacy `latest|beta|alpha` triple to allow
+ * release candidates without conflating with `beta` per SPEC §6.1.
+ */
+export const RELEASE_CHANNEL = ['latest', 'beta', 'alpha', 'rc'];
+/**
+ * Version-scheme variants. `calver-suffix` is the hotfix grammar
+ * `vYYYY.M.DD.N` per SPEC R-402.
+ */
+export const RELEASE_SCHEME = ['calver', 'semver', 'calver-suffix'];
+/**
+ * Release-kind classification. `hotfix` triggers the scope-strict completeness
+ * path per SPEC R-401; `prerelease` allows non-`latest` channels.
+ */
+export const RELEASE_KIND = ['regular', 'hotfix', 'prerelease'];
+/**
+ * Lifecycle FSM states for a release plan. Ordered for documentation only —
+ * the runtime FSM enforces monotonic forward progress per SPEC R-302.
+ */
+export const RELEASE_STATUS = [
+    'planned',
+    'pr-opened',
+    'pr-merged',
+    'published',
+    'reconciled',
+    'rolled_back',
+    'failed',
+    'cancelled',
+];
+/**
+ * Gate verification status. `unresolved` indicates ADR-061's resolver could
+ * not produce a command for the project archetype (SPEC R-304).
+ */
+export const GATE_STATUS = ['passed', 'failed', 'skipped', 'unresolved'];
+/**
+ * Canonical gate names recognized by the release pipeline. Mirrors the
+ * ADR-051 / ADR-061 evidence-atom canonical names (R-310).
+ */
+export const GATE_NAME = ['test', 'build', 'lint', 'typecheck', 'audit', 'security-scan'];
+/**
+ * Platform tuples used by the release matrix per T1737 alignment (R-370).
+ *
+ * `any` collapses single platform-agnostic artifacts (R-371).
+ */
+export const PLATFORM_TUPLE = [
+    'linux-x64',
+    'linux-arm64',
+    'macos-x64',
+    'macos-arm64',
+    'windows-x64',
+    'any',
+];
+/**
+ * Supported publisher backends — the registries / distribution channels the
+ * release matrix may target.
+ */
+export const PUBLISHER = ['npm', 'cargo', 'docker', 'pypi', 'github-release', 'binary'];
+/**
+ * Conventional-commit-aligned task classification used to slot tasks into the
+ * changelog `features` / `fixes` / `chores` / `breaking` buckets (§6.1).
+ */
+export const TASK_KIND = [
+    'feat',
+    'fix',
+    'chore',
+    'docs',
+    'refactor',
+    'test',
+    'perf',
+    'revert',
+    'breaking',
+    'hotfix',
+];
+/**
+ * SemVer-impact classification per task. The plan-time aggregate determines
+ * the release scheme bump when scheme=`semver` (informational under `calver`).
+ */
+export const IMPACT = ['major', 'minor', 'patch'];
+/**
+ * Source attribution for resolved tool commands. Mirrors ADR-061 §1 surfaces.
+ */
+export const RESOLVED_SOURCE = ['project-context', 'language-default', 'legacy-alias'];
+// ─── Enum schemas ────────────────────────────────────────────────────────────
+/** Zod schema for {@link RELEASE_CHANNEL}. */
+export const ReleaseChannelSchema = z.enum(RELEASE_CHANNEL);
+/** Zod schema for {@link RELEASE_SCHEME}. */
+export const ReleaseSchemeSchema = z.enum(RELEASE_SCHEME);
+/** Zod schema for {@link RELEASE_KIND}. */
+export const ReleaseKindSchema = z.enum(RELEASE_KIND);
+/** Zod schema for {@link RELEASE_STATUS}. */
+export const ReleaseStatusSchema = z.enum(RELEASE_STATUS);
+/** Zod schema for {@link GATE_STATUS}. */
+export const GateStatusSchema = z.enum(GATE_STATUS);
+/** Zod schema for {@link GATE_NAME}. */
+export const GateNameSchema = z.enum(GATE_NAME);
+/** Zod schema for {@link PLATFORM_TUPLE}. */
+export const PlatformTupleSchema = z.enum(PLATFORM_TUPLE);
+/** Zod schema for {@link PUBLISHER}. */
+export const PublisherSchema = z.enum(PUBLISHER);
+/** Zod schema for {@link TASK_KIND}. */
+export const TaskKindSchema = z.enum(TASK_KIND);
+/** Zod schema for {@link IMPACT}. */
+export const ImpactSchema = z.enum(IMPACT);
+/** Zod schema for {@link RESOLVED_SOURCE}. */
+export const ResolvedSourceSchema = z.enum(RESOLVED_SOURCE);
+// ─── Field-level constraint helpers ──────────────────────────────────────────
+/**
+ * ISO-8601 timestamp constraint. Accepts the subset Zod's `z.iso.datetime()`
+ * validates — RFC-3339 with optional fractional seconds and required offset.
+ */
+const Iso8601 = z.iso.datetime({ offset: true });
+/**
+ * Non-empty trimmed string. Used for required text fields like task IDs and
+ * user-facing summaries to reject pure whitespace.
+ */
+const NonEmptyString = z.string().min(1);
+// ─── Nested schemas ──────────────────────────────────────────────────────────
+/**
+ * Zod schema for one task row in `plan.tasks[]`. Mirrors the SPEC §6.1 task
+ * shape exactly. `evidenceAtoms` is a permissive `string[]` — verbs enforce
+ * non-empty per R-301; the contract permits empty arrays so legacy plans
+ * remain parseable.
+ *
+ * `epicAncestor` is locked at plan time (R-303) and MUST NOT be re-derived
+ * by downstream consumers.
+ *
+ * `ivtrPhaseAtPlan` is informational only (R-316) — consumers MUST NOT
+ * gate decisions on its value.
+ */
+export const ReleasePlanTaskSchema = z.object({
+    /** Task ID (e.g. "T10001"). Format intentionally loose so historical IDs validate. */
+    id: NonEmptyString,
+    /** Conventional-commit-aligned task classification. */
+    kind: TaskKindSchema,
+    /** SemVer impact classification. */
+    impact: ImpactSchema,
+    /** Human-readable changelog line for this task. */
+    userFacingSummary: z.string(),
+    /**
+     * ADR-051 evidence atoms attesting the task's gate results. Format is
+     * `kind:value` (e.g. `commit:abc123`, `test-run:vitest.json`). The contract
+     * accepts empty arrays so legacy plans validate; `cleo release plan`
+     * enforces non-empty via R-301.
+     */
+    evidenceAtoms: z.array(NonEmptyString),
+    /** IVTR phase at plan time — informational only per R-316. */
+    ivtrPhaseAtPlan: z.string().optional(),
+    /** Epic this task rolls up to, locked at plan time per R-303. */
+    epicAncestor: NonEmptyString,
+});
+/**
+ * Zod schema for one gate row in `plan.gates[]`. Each gate carries the
+ * resolved ADR-061 tool command + source attribution for forensic re-runs.
+ */
+export const ReleaseGateSchema = z.object({
+    /** Canonical gate name. */
+    name: GateNameSchema,
+    /** ADR-051 atom string identifying the resolved tool (e.g. `tool:test`). */
+    atom: NonEmptyString,
+    /** Gate execution status at plan time. */
+    status: GateStatusSchema,
+    /** ISO-8601 timestamp the gate was last verified. */
+    lastVerifiedAt: Iso8601,
+    /** Resolved shell command (e.g. `pnpm run test`). Optional for unresolved gates. */
+    resolvedCommand: z.string().optional(),
+    /** Provenance of the resolved command. Optional for unresolved gates. */
+    resolvedSource: ResolvedSourceSchema.optional(),
+});
+/**
+ * Zod schema for one row in `plan.platformMatrix[]`. Each entry encodes a
+ * (platform-tuple, publisher) pair the release will produce per R-370.
+ *
+ * `smoke` defaults to `true`; archetypes that produce platform-agnostic
+ * artifacts MAY set `false` to skip per-platform smoke tests (R-371).
+ */
+export const ReleasePlatformMatrixEntrySchema = z.object({
+    /** Target platform tuple. */
+    platform: PlatformTupleSchema,
+    /** Distribution backend. */
+    publisher: PublisherSchema,
+    /** Package identifier on the target backend (e.g. `@cleocode/cleo`). */
+    package: NonEmptyString,
+    /** Whether to run the GHA smoke job for this matrix entry. */
+    smoke: z.boolean().default(true).optional(),
+});
+/**
+ * Zod schema for `plan.preflightSummary`. Captures the four preflight checks
+ * runs by `cleo release plan` (R-024 / R-261).
+ */
+export const ReleasePreflightSummarySchema = z.object({
+    /** True if esbuild externals are out of sync with package.json. */
+    esbuildExternalsDrift: z.boolean(),
+    /** True if `pnpm-lock.yaml` diverges from the workspace manifest. */
+    lockfileDrift: z.boolean(),
+    /** True if all epic children are in terminal lifecycle states. */
+    epicCompletenessClean: z.boolean(),
+    /** True if no task appears in multiple in-flight release plans. */
+    doubleListingClean: z.boolean(),
+    /** Non-fatal preflight warnings (e.g. unresolved tools per R-024). */
+    preflightWarnings: z.array(z.string()).default([]).optional(),
+});
+/**
+ * Zod schema for `plan.changelog`. Tasks are bucketed by `kind` into the four
+ * canonical changelog sections; each section holds an array of task IDs
+ * preserving plan-time ordering.
+ */
+export const ReleasePlanChangelogSchema = z.object({
+    /** `kind=feat` tasks. */
+    features: z.array(NonEmptyString).default([]),
+    /** `kind=fix` or `kind=hotfix` tasks. */
+    fixes: z.array(NonEmptyString).default([]),
+    /** `kind=chore`, `docs`, `refactor`, `test`, `perf` tasks. */
+    chores: z.array(NonEmptyString).default([]),
+    /** `kind=breaking` or `kind=revert` tasks. */
+    breaking: z.array(NonEmptyString).default([]),
+});
+/**
+ * Zod schema for `plan.meta` — open-ended bag of informational fields.
+ *
+ * The catchall is `z.unknown()` (forward-compat: parsers MUST NOT reject
+ * fields the contract does not yet recognize) per ADR-039 envelope discipline.
+ *
+ * Documented keys:
+ *
+ * - `firstEverRelease` (R-023)         — escape hatch for the first ever
+ *   release where `previousVersion` is `null`.
+ * - `unresolvedTools` (R-024)          — canonical tool names whose
+ *   resolution failed during planning.
+ * - `archetype`       (R-361)          — detected project archetype string.
+ */
+export const ReleasePlanMetaSchema = z
+    .object({
+    /** True if this is the project's first ever release. */
+    firstEverRelease: z.boolean().optional(),
+    /** Canonical tool names that could not be resolved at plan time. */
+    unresolvedTools: z.array(z.string()).optional(),
+    /** Project archetype detected at plan time. */
+    archetype: z.string().optional(),
+})
+    .catchall(z.unknown());
+// ─── Top-level schema ────────────────────────────────────────────────────────
+/**
+ * Canonical Zod schema for the entire `.cleo/release/<version>.plan.json`
+ * envelope. Mirrors SPEC-T9345 §6.1 1:1.
+ *
+ * Schema invariants enforced by this schema:
+ *
+ * - All enum fields reject unknown literal values (R-302 / R-304).
+ * - `tasks[]` MUST contain only fully-typed task rows (R-303 / R-316).
+ * - `gates[]` MUST contain only canonical gate names (R-310).
+ * - `platformMatrix[]` MUST be a homogeneous array of entry rows (R-370).
+ *
+ * Schema invariants enforced by VERBS (NOT this schema):
+ *
+ * - R-300: `previousVersion` non-null unless `meta.firstEverRelease=true`.
+ * - R-301: `tasks[*].evidenceAtoms` non-empty.
+ * - R-305: `platformMatrix[]` non-empty.
+ * - R-306: deterministic re-validation inside `open` and `reconcile`.
+ */
+export const ReleasePlanSchema = z.object({
+    /** Schema URL for this plan version. */
+    $schema: z.string().optional(),
+    /** Requested version string (e.g. "v2026.6.0"). Includes the leading `v`. */
+    version: NonEmptyString,
+    /** Resolved version string after suffix application (e.g. "v2026.6.0.2"). */
+    resolvedVersion: NonEmptyString,
+    /** True if a `calver-suffix` was applied to disambiguate a same-day hotfix. */
+    suffixApplied: z.boolean(),
+    /** Versioning scheme governing `version` / `resolvedVersion`. */
+    scheme: ReleaseSchemeSchema,
+    /** npm dist-tag channel for this release. */
+    channel: ReleaseChannelSchema,
+    /** Epic ID this release ships. */
+    epicId: NonEmptyString,
+    /** Release-kind classification. */
+    releaseKind: ReleaseKindSchema,
+    /** ISO-8601 timestamp the plan was written. */
+    createdAt: Iso8601,
+    /** Identifier of the actor that wrote the plan (agent name or operator). */
+    createdBy: NonEmptyString,
+    /**
+     * Version of the previous release on the same channel. MUST be `null` only
+     * for first-ever releases (R-300, enforced at the verb layer).
+     */
+    previousVersion: z.string().nullable(),
+    /** Git tag of the previous release (typically `previousVersion` prefixed). */
+    previousTag: z.string().nullable(),
+    /** ISO-8601 timestamp the previous release was published. */
+    previousShippedAt: Iso8601.nullable(),
+    /** Tasks rolled into this release. */
+    tasks: z.array(ReleasePlanTaskSchema),
+    /** Bucketed changelog. */
+    changelog: ReleasePlanChangelogSchema,
+    /** Per-gate verification status. */
+    gates: z.array(ReleaseGateSchema),
+    /** Platform / publisher matrix. */
+    platformMatrix: z.array(ReleasePlatformMatrixEntrySchema),
+    /** Preflight summary from `cleo release plan`. */
+    preflightSummary: ReleasePreflightSummarySchema,
+    /** URL of the GHA workflow run (populated by `release-prepare.yml`). */
+    workflowRunUrl: z.string().nullable(),
+    /** URL of the bump PR (populated by `cleo release open`). */
+    prUrl: z.string().nullable(),
+    /** Merge commit SHA on `main` (populated by `release-publish.yml`). */
+    mergeCommitSha: z.string().nullable(),
+    /** Current FSM state per R-302. */
+    status: ReleaseStatusSchema,
+    /** Informational / forward-compat metadata. */
+    meta: ReleasePlanMetaSchema.optional(),
+});
+// ─── Parse helper ────────────────────────────────────────────────────────────
+/**
+ * Parse and validate a raw JSON value as a {@link ReleasePlan}.
+ *
+ * Throws `ZodError` on any structural mismatch with detailed `.issues[]`
+ * pinpointing every offending field path. Callers SHOULD surface those issues
+ * via the LAFS `error.details` field for operator triage.
+ *
+ * Use {@link safeParseReleasePlan} if you prefer the non-throwing variant.
+ *
+ * @param input — Untyped value loaded from disk / wire / database.
+ * @returns The validated, fully-typed plan object.
+ * @throws ZodError when validation fails.
+ *
+ * @example
+ * ```ts
+ * import { readFileSync } from 'node:fs';
+ * import { parseReleasePlan } from '@cleocode/contracts';
+ *
+ * const raw = JSON.parse(readFileSync('.cleo/release/v2026.6.0.plan.json', 'utf8'));
+ * const plan = parseReleasePlan(raw);
+ * console.log(plan.status); // type-narrowed to ReleaseStatus
+ * ```
+ */
+export function parseReleasePlan(input) {
+    return ReleasePlanSchema.parse(input);
+}
+/**
+ * Safe variant of {@link parseReleasePlan} that returns a discriminated-union
+ * result instead of throwing. Useful when validating user-supplied or
+ * persisted plans where structured error reporting is required.
+ *
+ * @param input — Untyped value to validate.
+ * @returns Zod safe-parse result.
+ */
+export function safeParseReleasePlan(input) {
+    return ReleasePlanSchema.safeParse(input);
+}
+//# sourceMappingURL=plan.js.map

package/dist/release/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/release/plan.ts"],"names":[],"mappings":"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"}

package/dist/release/plan.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Zod schema tests for the Release Plan envelope (T9527).
+ *
+ * Validates the canonical SPEC-T9345 §6.1 shape against the Zod schema defined
+ * in {@link ./plan.ts}. Coverage targets:
+ *
+ * - Happy-path parse round-trip
+ * - Each enum field rejects unknown literal values
+ * - Required fields cannot be missing
+ * - `evidenceAtoms` stays permissive (verb-level enforcement, NOT contract)
+ * - All 8 `status` FSM values parse
+ * - `meta` is forward-compat (unknown keys pass through via `.catchall`)
+ *
+ * @task T9527
+ */
+export {};
+//# sourceMappingURL=plan.test.d.ts.map

package/dist/release/plan.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.test.d.ts","sourceRoot":"","sources":["../../src/release/plan.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}