@cleocode/contracts 2026.5.78 → 2026.5.81

package/dist/release/plan.test.js

@@ -0,0 +1,414 @@
+/**
+ * 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
+ */
+import { describe, expect, it } from 'vitest';
+import { GATE_NAME, GATE_STATUS, IMPACT, PLATFORM_TUPLE, PUBLISHER, parseReleasePlan, RELEASE_CHANNEL, RELEASE_KIND, RELEASE_PLAN_SCHEMA_URL, RELEASE_PLAN_SCHEMA_VERSION, RELEASE_SCHEME, RELEASE_STATUS, RESOLVED_SOURCE, ReleaseGateSchema, ReleasePlanChangelogSchema, ReleasePlanMetaSchema, ReleasePlanSchema, ReleasePlanTaskSchema, ReleasePlatformMatrixEntrySchema, ReleasePreflightSummarySchema, safeParseReleasePlan, TASK_KIND, } from './plan.js';
+// ─── Fixtures ────────────────────────────────────────────────────────────────
+/**
+ * Returns a fresh deep clone of a minimal-but-complete valid plan. Each test
+ * mutates its own copy to test field-level rejection paths.
+ */
+function makeValidPlan() {
+    return {
+        $schema: RELEASE_PLAN_SCHEMA_URL,
+        version: 'v2026.6.0',
+        resolvedVersion: 'v2026.6.0',
+        suffixApplied: false,
+        scheme: 'calver',
+        channel: 'latest',
+        epicId: 'T9999',
+        releaseKind: 'regular',
+        createdAt: '2026-06-01T12:00:00Z',
+        createdBy: 'cleo-prime',
+        previousVersion: 'v2026.5.74',
+        previousTag: 'v2026.5.74',
+        previousShippedAt: '2026-05-15T08:00:00Z',
+        tasks: [
+            {
+                id: 'T10001',
+                kind: 'feat',
+                impact: 'minor',
+                userFacingSummary: 'Add release plan schema',
+                evidenceAtoms: ['commit:abc123', 'test-run:vitest.json', 'tool:lint'],
+                ivtrPhaseAtPlan: 'released',
+                epicAncestor: 'T9999',
+            },
+        ],
+        changelog: {
+            features: ['T10001'],
+            fixes: [],
+            chores: [],
+            breaking: [],
+        },
+        gates: [
+            {
+                name: 'test',
+                atom: 'tool:test',
+                status: 'passed',
+                lastVerifiedAt: '2026-06-01T11:50:00Z',
+                resolvedCommand: 'pnpm run test',
+                resolvedSource: 'project-context',
+            },
+        ],
+        platformMatrix: [
+            {
+                platform: 'linux-x64',
+                publisher: 'npm',
+                package: '@cleocode/cleo',
+                smoke: true,
+            },
+        ],
+        preflightSummary: {
+            esbuildExternalsDrift: false,
+            lockfileDrift: false,
+            epicCompletenessClean: true,
+            doubleListingClean: true,
+            preflightWarnings: [],
+        },
+        workflowRunUrl: null,
+        prUrl: null,
+        mergeCommitSha: null,
+        status: 'planned',
+        meta: {
+            firstEverRelease: false,
+            unresolvedTools: [],
+            archetype: 'monorepo-w-workspaces',
+        },
+    };
+}
+// ─── Constant tuples ─────────────────────────────────────────────────────────
+describe('Release plan constant tuples', () => {
+    it('exports an 8-state status FSM', () => {
+        expect(RELEASE_STATUS).toEqual([
+            'planned',
+            'pr-opened',
+            'pr-merged',
+            'published',
+            'reconciled',
+            'rolled_back',
+            'failed',
+            'cancelled',
+        ]);
+        expect(RELEASE_STATUS).toHaveLength(8);
+    });
+    it('exports the 4-channel set (latest|beta|alpha|rc)', () => {
+        expect(new Set(RELEASE_CHANNEL)).toEqual(new Set(['latest', 'beta', 'alpha', 'rc']));
+    });
+    it('exports the 3-scheme set including calver-suffix', () => {
+        expect(RELEASE_SCHEME).toContain('calver');
+        expect(RELEASE_SCHEME).toContain('semver');
+        expect(RELEASE_SCHEME).toContain('calver-suffix');
+    });
+    it('exports release-kind variants', () => {
+        expect(new Set(RELEASE_KIND)).toEqual(new Set(['regular', 'hotfix', 'prerelease']));
+    });
+    it('exports the 4-status gate enum', () => {
+        expect(new Set(GATE_STATUS)).toEqual(new Set(['passed', 'failed', 'skipped', 'unresolved']));
+    });
+    it('exports canonical gate names (R-310)', () => {
+        expect(GATE_NAME).toContain('test');
+        expect(GATE_NAME).toContain('build');
+        expect(GATE_NAME).toContain('lint');
+        expect(GATE_NAME).toContain('typecheck');
+        expect(GATE_NAME).toContain('audit');
+        expect(GATE_NAME).toContain('security-scan');
+    });
+    it('exports platform tuples aligned with T1737', () => {
+        expect(PLATFORM_TUPLE).toContain('linux-x64');
+        expect(PLATFORM_TUPLE).toContain('linux-arm64');
+        expect(PLATFORM_TUPLE).toContain('macos-x64');
+        expect(PLATFORM_TUPLE).toContain('macos-arm64');
+        expect(PLATFORM_TUPLE).toContain('windows-x64');
+        expect(PLATFORM_TUPLE).toContain('any');
+    });
+    it('exports publisher backends covering npm/cargo/docker/pypi/github-release/binary', () => {
+        expect(new Set(PUBLISHER)).toEqual(new Set(['npm', 'cargo', 'docker', 'pypi', 'github-release', 'binary']));
+    });
+    it('exports task-kind classification', () => {
+        expect(TASK_KIND).toContain('feat');
+        expect(TASK_KIND).toContain('fix');
+        expect(TASK_KIND).toContain('hotfix');
+        expect(TASK_KIND).toContain('breaking');
+    });
+    it('exports SemVer impact tuple', () => {
+        expect(IMPACT).toEqual(['major', 'minor', 'patch']);
+    });
+    it('exports resolved-source attribution per ADR-061', () => {
+        expect(RESOLVED_SOURCE).toEqual(['project-context', 'language-default', 'legacy-alias']);
+    });
+    it('exposes a stable schema version + URL', () => {
+        expect(RELEASE_PLAN_SCHEMA_VERSION).toBe('1.0.0');
+        expect(RELEASE_PLAN_SCHEMA_URL).toBe('https://cleocode.io/schemas/release-plan/v1.json');
+    });
+});
+// ─── Happy path ──────────────────────────────────────────────────────────────
+describe('ReleasePlanSchema — happy path', () => {
+    it('parses a complete valid plan', () => {
+        const plan = parseReleasePlan(makeValidPlan());
+        expect(plan.version).toBe('v2026.6.0');
+        expect(plan.status).toBe('planned');
+        expect(plan.tasks).toHaveLength(1);
+        expect(plan.tasks[0]?.id).toBe('T10001');
+        expect(plan.platformMatrix[0]?.publisher).toBe('npm');
+    });
+    it('safeParse returns success for a valid plan', () => {
+        const result = safeParseReleasePlan(makeValidPlan());
+        expect(result.success).toBe(true);
+    });
+    it('round-trips through JSON.stringify / parse', () => {
+        const original = makeValidPlan();
+        const serialized = JSON.stringify(original);
+        const reparsed = parseReleasePlan(JSON.parse(serialized));
+        expect(reparsed).toEqual(original);
+    });
+    it('accepts a first-ever release with null previousVersion + meta.firstEverRelease', () => {
+        const plan = makeValidPlan();
+        plan.previousVersion = null;
+        plan.previousTag = null;
+        plan.previousShippedAt = null;
+        plan.meta = { firstEverRelease: true };
+        expect(() => parseReleasePlan(plan)).not.toThrow();
+    });
+});
+// ─── Status FSM coverage ─────────────────────────────────────────────────────
+describe('ReleasePlanSchema — status FSM', () => {
+    it.each(RELEASE_STATUS)('accepts status = "%s"', (status) => {
+        const plan = makeValidPlan();
+        plan.status = status;
+        expect(() => parseReleasePlan(plan)).not.toThrow();
+    });
+    it('rejects unknown status literals', () => {
+        const plan = { ...makeValidPlan(), status: 'in-flight' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+});
+// ─── Enum rejection per field ────────────────────────────────────────────────
+describe('ReleasePlanSchema — enum rejection', () => {
+    it('rejects unknown channel', () => {
+        const plan = { ...makeValidPlan(), channel: 'canary' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown scheme', () => {
+        const plan = { ...makeValidPlan(), scheme: 'rolling' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown releaseKind', () => {
+        const plan = { ...makeValidPlan(), releaseKind: 'patch' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown task kind', () => {
+        const plan = makeValidPlan();
+        plan.tasks[0] = { ...plan.tasks[0], kind: 'misc' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown impact', () => {
+        const plan = makeValidPlan();
+        plan.tasks[0] = { ...plan.tasks[0], impact: 'huge' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown gate name', () => {
+        const plan = makeValidPlan();
+        plan.gates[0] = { ...plan.gates[0], name: 'fmt' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown gate status', () => {
+        const plan = makeValidPlan();
+        plan.gates[0] = { ...plan.gates[0], status: 'flaky' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown platform tuple', () => {
+        const plan = makeValidPlan();
+        plan.platformMatrix[0] = { ...plan.platformMatrix[0], platform: 'haiku-x64' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown publisher', () => {
+        const plan = makeValidPlan();
+        plan.platformMatrix[0] = { ...plan.platformMatrix[0], publisher: 'gemfury' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects unknown resolvedSource', () => {
+        const plan = makeValidPlan();
+        plan.gates[0] = { ...plan.gates[0], resolvedSource: 'env-override' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+});
+// ─── Required-field rejection ────────────────────────────────────────────────
+describe('ReleasePlanSchema — required fields', () => {
+    it('rejects missing version', () => {
+        const plan = makeValidPlan();
+        delete plan.version;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects missing epicId', () => {
+        const plan = makeValidPlan();
+        delete plan.epicId;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects empty epicId string', () => {
+        const plan = { ...makeValidPlan(), epicId: '' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects missing tasks array', () => {
+        const plan = makeValidPlan();
+        delete plan.tasks;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects missing changelog object', () => {
+        const plan = makeValidPlan();
+        delete plan.changelog;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects missing preflightSummary', () => {
+        const plan = makeValidPlan();
+        delete plan.preflightSummary;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects missing epicAncestor on a task row', () => {
+        const plan = makeValidPlan();
+        const taskWithoutAncestor = { ...plan.tasks[0] };
+        delete taskWithoutAncestor.epicAncestor;
+        plan.tasks[0] = taskWithoutAncestor;
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+    it('rejects malformed createdAt timestamp', () => {
+        const plan = { ...makeValidPlan(), createdAt: 'yesterday' };
+        expect(() => parseReleasePlan(plan)).toThrow();
+    });
+});
+// ─── Evidence atoms (contract permissive — R-301 verb-enforced) ─────────────
+describe('ReleasePlanTaskSchema — evidenceAtoms', () => {
+    it('accepts a string[] for evidenceAtoms', () => {
+        const result = ReleasePlanTaskSchema.parse({
+            id: 'T1',
+            kind: 'feat',
+            impact: 'patch',
+            userFacingSummary: '',
+            evidenceAtoms: ['commit:abc'],
+            epicAncestor: 'E1',
+        });
+        expect(result.evidenceAtoms).toEqual(['commit:abc']);
+    });
+    it('permits an empty evidenceAtoms array at the contract layer (R-301 is verb-enforced)', () => {
+        const result = ReleasePlanTaskSchema.safeParse({
+            id: 'T1',
+            kind: 'feat',
+            impact: 'patch',
+            userFacingSummary: '',
+            evidenceAtoms: [],
+            epicAncestor: 'E1',
+        });
+        expect(result.success).toBe(true);
+    });
+    it('rejects non-array evidenceAtoms', () => {
+        const result = ReleasePlanTaskSchema.safeParse({
+            id: 'T1',
+            kind: 'feat',
+            impact: 'patch',
+            userFacingSummary: '',
+            evidenceAtoms: 'commit:abc',
+            epicAncestor: 'E1',
+        });
+        expect(result.success).toBe(false);
+    });
+    it('rejects empty-string atom entries (NonEmptyString)', () => {
+        const result = ReleasePlanTaskSchema.safeParse({
+            id: 'T1',
+            kind: 'feat',
+            impact: 'patch',
+            userFacingSummary: '',
+            evidenceAtoms: [''],
+            epicAncestor: 'E1',
+        });
+        expect(result.success).toBe(false);
+    });
+});
+// ─── meta forward-compat ─────────────────────────────────────────────────────
+describe('ReleasePlanMetaSchema — forward compatibility', () => {
+    it('preserves unknown keys via catchall', () => {
+        const result = ReleasePlanMetaSchema.parse({
+            firstEverRelease: false,
+            futureField: 'someValue',
+            anotherUnknown: { nested: true },
+        });
+        expect(result.futureField).toBe('someValue');
+        expect(result.anotherUnknown).toEqual({ nested: true });
+    });
+    it('still validates known fields strictly', () => {
+        const result = ReleasePlanMetaSchema.safeParse({
+            firstEverRelease: 'yes',
+        });
+        expect(result.success).toBe(false);
+    });
+    it('accepts a fully-empty meta object', () => {
+        expect(() => ReleasePlanMetaSchema.parse({})).not.toThrow();
+    });
+});
+// ─── Nested-schema sanity ────────────────────────────────────────────────────
+describe('Nested schemas — sanity', () => {
+    it('ReleaseGateSchema requires lastVerifiedAt to be ISO-8601', () => {
+        const result = ReleaseGateSchema.safeParse({
+            name: 'test',
+            atom: 'tool:test',
+            status: 'passed',
+            lastVerifiedAt: 'Tuesday',
+        });
+        expect(result.success).toBe(false);
+    });
+    it('ReleasePlatformMatrixEntrySchema applies smoke=true default when omitted', () => {
+        const result = ReleasePlatformMatrixEntrySchema.parse({
+            platform: 'any',
+            publisher: 'npm',
+            package: '@cleocode/lafs',
+        });
+        expect(result.smoke).toBe(true);
+    });
+    it('ReleasePreflightSummarySchema requires the four boolean preflight gates', () => {
+        const result = ReleasePreflightSummarySchema.safeParse({
+            esbuildExternalsDrift: false,
+            lockfileDrift: false,
+            epicCompletenessClean: true,
+            // doubleListingClean omitted
+        });
+        expect(result.success).toBe(false);
+    });
+    it('ReleasePlanChangelogSchema applies empty-array defaults for omitted buckets', () => {
+        const result = ReleasePlanChangelogSchema.parse({});
+        expect(result.features).toEqual([]);
+        expect(result.fixes).toEqual([]);
+        expect(result.chores).toEqual([]);
+        expect(result.breaking).toEqual([]);
+    });
+    it('ReleasePlanSchema accepts plans with no tasks (e.g. config-only releases)', () => {
+        const plan = makeValidPlan();
+        plan.tasks = [];
+        plan.changelog.features = [];
+        expect(() => parseReleasePlan(plan)).not.toThrow();
+    });
+    it('safeParseReleasePlan surfaces issues for bad enums', () => {
+        const result = safeParseReleasePlan({ ...makeValidPlan(), channel: 'invalid-channel' });
+        expect(result.success).toBe(false);
+        if (!result.success) {
+            expect(result.error.issues.length).toBeGreaterThan(0);
+        }
+    });
+});
+// ─── Schema export sanity ────────────────────────────────────────────────────
+describe('ReleasePlanSchema — module surface', () => {
+    it('exports a Zod object schema at the top level', () => {
+        expect(typeof ReleasePlanSchema.parse).toBe('function');
+        expect(typeof ReleasePlanSchema.safeParse).toBe('function');
+    });
+});
+//# sourceMappingURL=plan.test.js.map

package/dist/release/plan.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.test.js","sourceRoot":"","sources":["../../src/release/plan.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,SAAS,EACT,WAAW,EACX,MAAM,EACN,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,2BAA2B,EAC3B,cAAc,EACd,cAAc,EACd,eAAe,EACf,iBAAiB,EAEjB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,gCAAgC,EAChC,6BAA6B,EAC7B,oBAAoB,EACpB,SAAS,GACV,MAAM,WAAW,CAAC;AAEnB,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,aAAa;IACpB,OAAO;QACL,OAAO,EAAE,uBAAuB;QAChC,OAAO,EAAE,WAAW;QACpB,eAAe,EAAE,WAAW;QAC5B,aAAa,EAAE,KAAK;QACpB,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,OAAO;QACf,WAAW,EAAE,SAAS;QACtB,SAAS,EAAE,sBAAsB;QACjC,SAAS,EAAE,YAAY;QACvB,eAAe,EAAE,YAAY;QAC7B,WAAW,EAAE,YAAY;QACzB,iBAAiB,EAAE,sBAAsB;QACzC,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,QAAQ;gBACZ,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,OAAO;gBACf,iBAAiB,EAAE,yBAAyB;gBAC5C,aAAa,EAAE,CAAC,eAAe,EAAE,sBAAsB,EAAE,WAAW,CAAC;gBACrE,eAAe,EAAE,UAAU;gBAC3B,YAAY,EAAE,OAAO;aACtB;SACF;QACD,SAAS,EAAE;YACT,QAAQ,EAAE,CAAC,QAAQ,CAAC;YACpB,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;SACb;QACD,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,QAAQ;gBAChB,cAAc,EAAE,sBAAsB;gBACtC,eAAe,EAAE,eAAe;gBAChC,cAAc,EAAE,iBAAiB;aAClC;SACF;QACD,cAAc,EAAE;YACd;gBACE,QAAQ,EAAE,WAAW;gBACrB,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,gBAAgB;gBACzB,KAAK,EAAE,IAAI;aACZ;SACF;QACD,gBAAgB,EAAE;YAChB,qBAAqB,EAAE,KAAK;YAC5B,aAAa,EAAE,KAAK;YACpB,qBAAqB,EAAE,IAAI;YAC3B,kBAAkB,EAAE,IAAI;YACxB,iBAAiB,EAAE,EAAE;SACtB;QACD,cAAc,EAAE,IAAI;QACpB,KAAK,EAAE,IAAI;QACX,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE;YACJ,gBAAgB,EAAE,KAAK;YACvB,eAAe,EAAE,EAAE;YACnB,SAAS,EAAE,uBAAuB;SACnC;KACF,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC;YAC7B,SAAS;YACT,WAAW;YACX,WAAW;YACX,WAAW;YACX,YAAY;YACZ,aAAa;YACb,QAAQ;YACR,WAAW;SACZ,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,MAAM,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAChC,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CACxE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,IAAI,GAAG,gBAAgB,CAAC,aAAa,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,oBAAoB,CAAC,aAAa,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,uBAAuB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1D,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QACzD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QACvD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACvD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;QAC1D,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;QAC7D,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,MAAM,EAAE,MAAe,EAAE,CAAC;QAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,KAAc,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,MAAM,EAAE,OAAgB,EAAE,CAAC;QAChE,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAE,EAAE,QAAQ,EAAE,WAAoB,EAAE,CAAC;QACxF,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAE,EAAE,SAAS,EAAE,SAAkB,EAAE,CAAC;QACvF,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,cAAc,EAAE,cAAuB,EAAE,CAAC;QAC/E,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,IAAI,GAAG,aAAa,EAA0B,CAAC;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC;QACpB,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,IAAI,GAAG,aAAa,EAA0B,CAAC;QACrD,OAAO,IAAI,CAAC,MAAM,CAAC;QACnB,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,IAAI,GAAG,aAAa,EAA0B,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC;QAClB,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,IAAI,GAAG,aAAa,EAA0B,CAAC;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC;QACtB,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,IAAI,GAAG,aAAa,EAA0B,CAAC;QACrD,OAAO,IAAI,CAAC,gBAAgB,CAAC;QAC7B,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,MAAM,mBAAmB,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,EAA2C,CAAC;QAC3F,OAAO,mBAAmB,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,mBAAmD,CAAC;QACpE,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAE/E,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC;YACzC,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,OAAO;YACf,iBAAiB,EAAE,EAAE;YACrB,aAAa,EAAE,CAAC,YAAY,CAAC;YAC7B,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qFAAqF,EAAE,GAAG,EAAE;QAC7F,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC;YAC7C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,OAAO;YACf,iBAAiB,EAAE,EAAE;YACrB,aAAa,EAAE,EAAE;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC;YAC7C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,OAAO;YACf,iBAAiB,EAAE,EAAE;YACrB,aAAa,EAAE,YAAY;YAC3B,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC;YAC7C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,OAAO;YACf,iBAAiB,EAAE,EAAE;YACrB,aAAa,EAAE,CAAC,EAAE,CAAC;YACnB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,QAAQ,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC7D,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC;YACzC,gBAAgB,EAAE,KAAK;YACvB,WAAW,EAAE,WAAW;YACxB,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;SACjC,CAAC,CAAC;QACH,MAAM,CAAE,MAAkC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1E,MAAM,CAAE,MAAkC,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC;YAC7C,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC;YACzC,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,QAAQ;YAChB,cAAc,EAAE,SAAS;SAC1B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,MAAM,GAAG,gCAAgC,CAAC,KAAK,CAAC;YACpD,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,gBAAgB;SAC1B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC;YACrD,qBAAqB,EAAE,KAAK;YAC5B,aAAa,EAAE,KAAK;YACpB,qBAAqB,EAAE,IAAI;YAC3B,6BAA6B;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,GAAG,aAAa,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,MAAM,CAAC,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tasks/archive.d.ts

@@ -51,8 +51,8 @@ import { z } from 'zod';
 export declare const ArchiveReason: z.ZodEnum<{
     cancelled: "cancelled";
     superseded: "superseded";
-    verified: "verified";
     reconciled: "reconciled";
+    verified: "verified";
     shadowed: "shadowed";
     "completed-unverified": "completed-unverified";
 }>;
@@ -67,8 +67,8 @@ export declare const ArchiveReason: z.ZodEnum<{
 export declare const ArchiveReasonSchema: z.ZodEnum<{
     cancelled: "cancelled";
     superseded: "superseded";
-    verified: "verified";
     reconciled: "reconciled";
+    verified: "verified";
     shadowed: "shadowed";
     "completed-unverified": "completed-unverified";
 }>;
@@ -93,7 +93,7 @@ export type ArchiveReasonValue = z.infer<typeof ArchiveReason>;
  * Useful when a Drizzle column or a discriminated union needs the raw
  * tuple form (e.g. `text('archive_reason', { enum: ARCHIVE_REASON_VALUES })`).
  */
-export declare const ARCHIVE_REASON_VALUES: ("cancelled" | "superseded" | "verified" | "reconciled" | "shadowed" | "completed-unverified")[];
+export declare const ARCHIVE_REASON_VALUES: ("cancelled" | "superseded" | "reconciled" | "verified" | "shadowed" | "completed-unverified")[];
 /**
  * The single tombstone value within {@link ArchiveReason}.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.5.78",
+  "version": "2026.5.81",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",
@@ -98,7 +98,7 @@
   "dependencies": {
     "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.2",
-    "@cleocode/lafs": "2026.5.78"
+    "@cleocode/lafs": "2026.5.81"
   },
   "scripts": {
     "build": "tsc -b --force && node scripts/emit-schemas.mjs",

package/src/exit-codes.ts

@@ -226,6 +226,60 @@ export enum ExitCode {
   LEAD_BYPASS_DETECTED = 107,
 }
 
+// ---------------------------------------------------------------------------
+// Release pipeline v2 error code names (SPEC-T9345 §4.7)
+//
+// String-valued error codes emitted by the new release verbs (plan, open,
+// reconcile, rollback). These are the `code` field of EngineErrorPayload;
+// the numeric exit code is the bucket the verb resolves to (per SPEC §4.7).
+//
+// @task T9525
+// @epic T9492
+// @spec .cleo/rcasd/T9345/research/SPEC-T9345-release-pipeline-v2.md §4.7
+// ---------------------------------------------------------------------------
+
+/** Dirty version files block `cleo release plan` (R-020). Exit code 13. */
+export const E_DIRTY_TREE = 'E_DIRTY_TREE' as const;
+/** Epic referenced by `--epic` has zero children (R-021). Exit code 4. */
+export const E_EPIC_EMPTY = 'E_EPIC_EMPTY' as const;
+/** Epic referenced by `--epic` does not exist (R-021). Exit code 10. */
+export const E_EPIC_NOT_FOUND = 'E_EPIC_NOT_FOUND' as const;
+/** Channel + version scheme are incompatible (R-022). Exit code 6. */
+export const E_CHANNEL_MISMATCH = 'E_CHANNEL_MISMATCH' as const;
+/**
+ * One or more tasks in the plan are missing required ADR-051 evidence atoms
+ * (R-301 / R-310). Exit code 83. `error.details.tasks[]` lists offenders.
+ */
+export const E_EVIDENCE_INSUFFICIENT = 'E_EVIDENCE_INSUFFICIENT' as const;
+/** Plan file at `.cleo/release/<version>.plan.json` is absent. Exit code 4. */
+export const E_PLAN_NOT_FOUND = 'E_PLAN_NOT_FOUND' as const;
+/** Generic release-plan validation failure (e.g. schema). Exit code 6. */
+export const E_RELEASE_PLAN_INVALID = 'E_RELEASE_PLAN_INVALID' as const;
+/**
+ * Release row exists but is not in the status FSM state required by the
+ * caller (R-051 — `cleo release open` requires status='planned'). Exit code 6.
+ * `error.details.currentStatus` MUST report the actual status; `error.details.expectedStatus`
+ * SHOULD list the accepted state(s).
+ *
+ * @task T9530
+ */
+export const E_INVALID_STATE = 'E_INVALID_STATE' as const;
+/**
+ * `gh auth status` exited non-zero (R-052). The GitHub CLI is either not
+ * installed or not authenticated for the active hostname. Exit code 5.
+ *
+ * @task T9530
+ */
+export const E_GH_NOT_AUTHENTICATED = 'E_GH_NOT_AUTHENTICATED' as const;
+/**
+ * The expected GitHub Actions workflow file is missing under `.github/workflows/`
+ * (R-053). Without it, `gh workflow run` would fail with a non-recoverable error.
+ * Exit code 4.
+ *
+ * @task T9530
+ */
+export const E_WORKFLOW_NOT_FOUND = 'E_WORKFLOW_NOT_FOUND' as const;
+
 /** Check if an exit code represents an error (1-99). */
 export function isErrorCode(code: ExitCode): boolean {
   return code >= 1 && code < 100;

package/src/index.ts

@@ -332,6 +332,18 @@ export {
 } from './evidence-record-schema.js';
 // === Exit Codes ===
 export {
+  // SPEC-T9345 release pipeline v2 error code names (T9525)
+  E_CHANNEL_MISMATCH,
+  E_DIRTY_TREE,
+  E_EPIC_EMPTY,
+  E_EPIC_NOT_FOUND,
+  E_EVIDENCE_INSUFFICIENT,
+  // SPEC-T9345 release pipeline v2 error code names (T9530)
+  E_GH_NOT_AUTHENTICATED,
+  E_INVALID_STATE,
+  E_PLAN_NOT_FOUND,
+  E_RELEASE_PLAN_INVALID,
+  E_WORKFLOW_NOT_FOUND,
   ExitCode,
   getExitCodeName,
   isErrorCode,
@@ -1144,13 +1156,24 @@ export type {
   CreateWorktreeResult,
   DestroyWorktreeOptions,
   DestroyWorktreeResult,
+  ForceUnlockWorktreeOpts,
+  ForceUnlockWorktreeResult,
   ListWorktreesOptions,
+  ListWorktreesOpts,
+  ListWorktreesResult,
+  PrunedWorktreeOutcome,
+  PruneOrphanedWorktreesOpts,
+  PruneOrphanedWorktreesResult,
   PruneWorktreesOptions,
   PruneWorktreesResult,
   WorktreeHook,
   WorktreeHookResult,
   WorktreeIncludePattern,
+  WorktreeInfo,
+  WorktreeLifecycleAction,
+  WorktreeLifecycleAuditEntry,
   WorktreeListEntry,
+  WorktreeStatusCategory,
 } from './operations/worktree.js';
 // === Orchestration Roll-up Types (T9082, ADR-070) ===
 export type {
@@ -1235,6 +1258,62 @@ export type {
   ReleaseVersionScheme,
   VerifyResult,
 } from './release/pipeline.js';
+// === Release Plan Envelope (T9527 / SPEC-T9345 §6) ===
+export type {
+  GateName as ReleaseGateName,
+  GateStatus as ReleaseGateExecutionStatus,
+  Impact as ReleasePlanImpact,
+  PlatformTuple,
+  Publisher,
+  ReleaseChannel as ReleasePlanChannel,
+  ReleaseGate,
+  ReleaseKind,
+  ReleasePlan,
+  ReleasePlanChangelog,
+  ReleasePlanMeta,
+  ReleasePlanTask,
+  ReleasePlatformMatrixEntry,
+  ReleasePreflightSummary,
+  ReleaseScheme,
+  ReleaseStatus as ReleasePlanStatus,
+  ResolvedSource,
+  TaskKind as ReleaseTaskKind,
+} from './release/plan.js';
+export {
+  GATE_NAME,
+  GATE_STATUS,
+  GateNameSchema,
+  GateStatusSchema,
+  IMPACT,
+  ImpactSchema,
+  PLATFORM_TUPLE,
+  PlatformTupleSchema,
+  PUBLISHER,
+  PublisherSchema,
+  parseReleasePlan,
+  RELEASE_CHANNEL,
+  RELEASE_KIND,
+  RELEASE_PLAN_SCHEMA_URL,
+  RELEASE_PLAN_SCHEMA_VERSION,
+  RELEASE_SCHEME,
+  RELEASE_STATUS,
+  RESOLVED_SOURCE,
+  ReleaseChannelSchema,
+  ReleaseGateSchema,
+  ReleaseKindSchema,
+  ReleasePlanChangelogSchema,
+  ReleasePlanMetaSchema,
+  ReleasePlanSchema,
+  ReleasePlanTaskSchema,
+  ReleasePlatformMatrixEntrySchema,
+  ReleasePreflightSummarySchema,
+  ReleaseSchemeSchema,
+  ReleaseStatusSchema,
+  ResolvedSourceSchema,
+  safeParseReleasePlan,
+  TASK_KIND,
+  TaskKindSchema,
+} from './release/plan.js';
 // === Release Version Bump ===
 export type {
   BumpResult,