@cleocode/contracts 2026.10.8 → 2026.10.9

package/dist/project-hooks.js

@@ -0,0 +1,113 @@
+/** Project-owned checks shared by Git, harness and worktree adapters (T13343). */
+import { z } from 'zod';
+/** Invocation origin; CI has stricter failure handling than local adapters. */
+export const HookSourceSchema = z.enum(['agent', 'git', 'worktree', 'direct', 'ci']);
+/** A checkout-relative path; runtime validation also resolves symlinks. */
+export const ProjectHookPathSchema = z
+    .string()
+    .min(1)
+    .max(4096)
+    .refine((value) => !value.startsWith('/') &&
+    !value.includes('\\') &&
+    !value.split('/').includes('..') &&
+    !/^[A-Za-z]:/.test(value), 'Expected a project-relative path without traversal');
+/** One project definition; CLEO IDs are reserved for shipped infrastructure. */
+export const ProjectHookDefinitionSchema = z
+    .object({
+    id: z
+        .string()
+        .regex(/^[a-z][a-z0-9.-]{0,127}$/)
+        .refine((value) => !value.startsWith('cleo.'), 'CLEO IDs are reserved'),
+    owner: z.literal('project'),
+    bindings: z
+        .array(z.object({ source: HookSourceSchema, event: z.string().min(1).max(128) }).strict())
+        .min(1)
+        .max(16),
+    executable: z.string().min(1).max(4096),
+    handler: ProjectHookPathSchema,
+    args: z.array(z.string().max(8192)).max(64).default([]),
+    dependencies: z.array(ProjectHookPathSchema).max(128).default([]),
+    timeoutMs: z.number().int().min(1).max(120000).default(30000),
+    checkerErrorPolicy: z.enum(['warn', 'block']).default('warn'),
+})
+    .strict();
+/** Tracked single source of truth; array order defines execution order. */
+export const ProjectHooksManifestSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    hooks: z.array(ProjectHookDefinitionSchema).max(64),
+})
+    .strict()
+    .superRefine((manifest, context) => {
+    const ids = new Set();
+    for (const hook of manifest.hooks) {
+        if (ids.has(hook.id))
+            context.addIssue({ code: 'custom', message: `Duplicate hook ID: ${hook.id}` });
+        ids.add(hook.id);
+        const bindings = new Set();
+        for (const binding of hook.bindings) {
+            const key = `${binding.source}:${binding.event}`;
+            if (bindings.has(key))
+                context.addIssue({ code: 'custom', message: `Duplicate binding: ${hook.id}:${key}` });
+            bindings.add(key);
+        }
+    }
+});
+/** Structured checker verdict written as one JSON object on stdout. */
+export const ProjectHookVerdictSchema = z
+    .object({
+    status: z.enum(['pass', 'block', 'warn', 'skip', 'checker-error']),
+    message: z.string().max(4096).optional(),
+})
+    .strict();
+/** Content hashes approved explicitly on this machine. */
+export const HookActivationSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    projectRoot: z.string(),
+    projectIdentity: z.string(),
+    manifestHash: z.string().regex(/^[a-f0-9]{64}$/),
+    files: z.record(z.string(), z.string().regex(/^[a-f0-9]{64}$/)),
+    executables: z.record(z.string(), z.string()),
+    activatedAt: z.string(),
+})
+    .strict();
+/** Local feature state; activation never confers native harness trust. */
+export const ProjectHooksLocalStateSchema = z
+    .object({
+    hooks: z.object({ project: z.object({ enabled: z.boolean() }).strict() }).strict(),
+    activation: HookActivationSchema.optional(),
+})
+    .strict();
+/** Validator for sanitized execution records, rejecting unexpected payload fields. */
+export const HookExecutionReceiptSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    manifestHash: z.string().regex(/^[a-f0-9]{64}$/),
+    source: HookSourceSchema,
+    event: z.string().max(128),
+    recordedAt: z.string(),
+    outcomes: z
+        .array(z
+        .object({
+        id: z.string().max(128),
+        status: z.enum([
+            'pass',
+            'block',
+            'warn',
+            'skip',
+            'checker-error',
+            'timeout',
+            'infrastructure-error',
+        ]),
+        blocks: z.boolean(),
+        code: z.string().regex(/^HOOK_[A-Z_]+$/),
+        exitCode: z.number().int().nullable(),
+        signal: z.string().max(32).nullable(),
+        durationMs: z.number().nonnegative(),
+    })
+        .strict())
+        .max(65),
+})
+    .strict();
+//# sourceMappingURL=project-hooks.js.map

package/dist/project-hooks.js.map

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

package/dist/release/channel.d.ts

@@ -9,7 +9,7 @@
  * @adr ADR-063
  */
 /** npm dist-tag channel for a release. */
-export type ReleaseChannel = 'latest' | 'beta' | 'alpha';
+export type ReleaseChannel = 'latest' | 'beta' | 'alpha' | 'canary';
 /** Result of validating a version string against a channel's expectations. */
 export interface ChannelValidationResult {
     valid: boolean;

package/dist/release/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/release/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/release/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpE,8EAA8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/release/hook-pilot.d.ts

@@ -0,0 +1,179 @@
+/** Bound, retained evidence required before promoting project hooks to stable (T13350). */
+import { z } from 'zod';
+/** Required pilot checks; every named check must pass on the same implementation. */
+export declare const HOOK_PILOT_CHECKS: readonly ["packedArtifact", "publishedCanary", "readOnlyDev", "readOnlyProd", "liveClaude", "liveCodex", "hostedCi"];
+/** A required hook pilot check. */
+export type HookPilotCheck = (typeof HOOK_PILOT_CHECKS)[number];
+/** SHA-256 evidence or implementation digest. */
+export declare const HookPilotDigestSchema: z.ZodString;
+/** An independent, numbered canary release; RC/beta does not satisfy this pilot. */
+export declare const HookPilotCanarySchema: z.ZodString;
+/** Exact live harness versions, kept separate from source-version normalization. */
+export declare const HookPilotHarnessVersionsSchema: z.ZodObject<{
+    claude: z.ZodString;
+    codex: z.ZodString;
+}, z.core.$strict>;
+/** Retained proof path remains inside the evidence artifact directory. */
+export declare const HookPilotProofReferenceSchema: z.ZodObject<{
+    path: z.ZodString;
+    sha256: z.ZodString;
+}, z.core.$strict>;
+/** Common identity attached to every retained proof, never inferred from similar releases. */
+export declare const HookPilotIdentitySchema: z.ZodObject<{
+    canaryVersion: z.ZodString;
+    sourceDigest: z.ZodString;
+    vidaCommit: z.ZodString;
+    harnessVersions: z.ZodObject<{
+        claude: z.ZodString;
+        codex: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** A bounded collection of actual pilot receipts. Missing or partial checks hold promotion. */
+export declare const HookPilotEvidenceSchema: z.ZodObject<{
+    canaryVersion: z.ZodString;
+    sourceDigest: z.ZodString;
+    vidaCommit: z.ZodString;
+    harnessVersions: z.ZodObject<{
+        claude: z.ZodString;
+        codex: z.ZodString;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    vidaRepository: z.ZodString;
+    hostedRunId: z.ZodNumber;
+    checks: z.ZodObject<{
+        packedArtifact: z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>;
+        publishedCanary: z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>;
+        readOnlyDev: z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>;
+        readOnlyProd: z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>;
+        liveClaude: z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>;
+        liveCodex: z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>;
+        hostedCi: z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** Validated evidence bundle index. */
+export type HookPilotEvidence = z.infer<typeof HookPilotEvidenceSchema>;
+/** Structured, redacted proof produced by a real check and retained with its hash. */
+export declare const HookPilotProofSchema: z.ZodObject<{
+    canaryVersion: z.ZodString;
+    sourceDigest: z.ZodString;
+    vidaCommit: z.ZodString;
+    harnessVersions: z.ZodObject<{
+        claude: z.ZodString;
+        codex: z.ZodString;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    check: z.ZodEnum<{
+        packedArtifact: "packedArtifact";
+        publishedCanary: "publishedCanary";
+        readOnlyDev: "readOnlyDev";
+        readOnlyProd: "readOnlyProd";
+        liveClaude: "liveClaude";
+        liveCodex: "liveCodex";
+        hostedCi: "hostedCi";
+    }>;
+    status: z.ZodLiteral<"pass">;
+    observedAt: z.ZodString;
+    checkedCount: z.ZodNumber;
+    exitCode: z.ZodLiteral<0>;
+    mode: z.ZodEnum<{
+        "read-only": "read-only";
+        "packed-artifact": "packed-artifact";
+        "published-canary": "published-canary";
+        "live-harness": "live-harness";
+        "hosted-ci": "hosted-ci";
+    }>;
+    packageVersions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    ordinaryCommands: z.ZodOptional<z.ZodNumber>;
+    disposablePushes: z.ZodOptional<z.ZodNumber>;
+    hostedRunId: z.ZodOptional<z.ZodNumber>;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** A validated retained proof. */
+export type HookPilotProof = z.infer<typeof HookPilotProofSchema>;
+/** Minimal authoritative GitHub response required for an actual successful workflow run. */
+export declare const HookPilotHostedRunSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    head_sha: z.ZodString;
+    status: z.ZodLiteral<"completed">;
+    conclusion: z.ZodLiteral<"success">;
+    path: z.ZodString;
+    html_url: z.ZodString;
+    repository: z.ZodObject<{
+        full_name: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Minimal runner/step evidence; an empty never-started job cannot satisfy hosted CI. */
+export declare const HookPilotHostedJobsSchema: z.ZodObject<{
+    jobs: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodString;
+        conclusion: z.ZodNullable<z.ZodString>;
+        runner_id: z.ZodNumber;
+        runner_name: z.ZodNullable<z.ZodString>;
+        labels: z.ZodArray<z.ZodString>;
+        steps: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            status: z.ZodString;
+            conclusion: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** A bounded API JSON reader. Production uses gh; tests inject only transport responses. */
+export type HookPilotApiReader = (endpoint: string) => string;
+/** Inputs that bind validation to the release currently being promoted. */
+export interface HookPilotValidationOptions {
+    /** Repository checkout used for the normalized implementation digest. */
+    root: string;
+    /** Retained evidence index; its directory contains all proof files. */
+    evidencePath: string;
+    /** Stable version receiving promotion; cannot precede the canary base. Source proof must match. */
+    stableVersion: string;
+    /** Trusted release-side pilot repository; evidence cannot redirect authority. */
+    vidaRepository: string;
+    /** Authoritative read transport, injectable for sanitized tests. */
+    readApi?: HookPilotApiReader;
+}
+/** Reusable normalized source digest and exact publish cohort. */
+export interface HookPilotSourceDigest {
+    /** Algorithm format, including inclusion and normalization rules. */
+    schemaVersion: 1;
+    /** SHA-256 of sorted framed mode/path/content records with manifest normalization. */
+    digest: string;
+    /** Number of assessed tracked files. */
+    fileCount: number;
+    /** Package names from release.yml's publish_pkg SSoT. */
+    cohort: string[];
+}
+/** Validation result contains attribution only, never proof payloads or credentials. */
+export interface HookPilotValidationResult {
+    /** Confirmed independent canary. */
+    canaryVersion: string;
+    /** Normalized source digest used by this validation. */
+    sourceDigest: string;
+    /** Exact VidaPeps commit validated by hosted CI. */
+    vidaCommit: string;
+    /** Required checks validated. */
+    checks: HookPilotCheck[];
+}
+//# sourceMappingURL=hook-pilot.d.ts.map

package/dist/release/hook-pilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-pilot.d.ts","sourceRoot":"","sources":["../../src/release/hook-pilot.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,sHAQpB,CAAC;AACX,mCAAmC;AACnC,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,aAAqC,CAAC;AACxE,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,aAAoD,CAAC;AACvF,oFAAoF;AACpF,eAAO,MAAM,8BAA8B;;;kBAKhC,CAAC;AACZ,0EAA0E;AAC1E,eAAO,MAAM,6BAA6B;;;kBAgB/B,CAAC;AACZ,8FAA8F;AAC9F,eAAO,MAAM,uBAAuB;;;;;;;;kBAOzB,CAAC;AACZ,+FAA+F;AAC/F,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBzB,CAAC;AACZ,uCAAuC;AACvC,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,sFAAsF;AACtF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAatB,CAAC;AACZ,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,4FAA4F;AAC5F,eAAO,MAAM,wBAAwB;;;;;;;;;;iBAQnC,CAAC;AACH,yFAAyF;AACzF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;iBAsBpC,CAAC;AACH,4FAA4F;AAC5F,MAAM,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;AAC9D,2EAA2E;AAC3E,MAAM,WAAW,0BAA0B;IACzC,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,aAAa,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AACD,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,aAAa,EAAE,CAAC,CAAC;IACjB,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AACD,wFAAwF;AACxF,MAAM,WAAW,yBAAyB;IACxC,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B"}

package/dist/release/hook-pilot.js

@@ -0,0 +1,112 @@
+/** Bound, retained evidence required before promoting project hooks to stable (T13350). */
+import { z } from 'zod';
+/** Required pilot checks; every named check must pass on the same implementation. */
+export const HOOK_PILOT_CHECKS = [
+    'packedArtifact',
+    'publishedCanary',
+    'readOnlyDev',
+    'readOnlyProd',
+    'liveClaude',
+    'liveCodex',
+    'hostedCi',
+];
+/** SHA-256 evidence or implementation digest. */
+export const HookPilotDigestSchema = z.string().regex(/^[a-f0-9]{64}$/);
+/** An independent, numbered canary release; RC/beta does not satisfy this pilot. */
+export const HookPilotCanarySchema = z.string().regex(/^\d{4}\.\d+\.\d+-canary\.\d+$/);
+/** Exact live harness versions, kept separate from source-version normalization. */
+export const HookPilotHarnessVersionsSchema = z
+    .object({
+    claude: z.string().min(1).max(128),
+    codex: z.string().min(1).max(128),
+})
+    .strict();
+/** Retained proof path remains inside the evidence artifact directory. */
+export const HookPilotProofReferenceSchema = z
+    .object({
+    path: z
+        .string()
+        .min(1)
+        .max(4096)
+        .refine((value) => !value.startsWith('/') &&
+        !value.includes('\\') &&
+        !value.split('/').includes('..') &&
+        !/^[A-Za-z]:/.test(value), 'Expected a relative proof path without traversal'),
+    sha256: HookPilotDigestSchema,
+})
+    .strict();
+/** Common identity attached to every retained proof, never inferred from similar releases. */
+export const HookPilotIdentitySchema = z
+    .object({
+    canaryVersion: HookPilotCanarySchema,
+    sourceDigest: HookPilotDigestSchema,
+    vidaCommit: z.string().regex(/^[a-f0-9]{40}$/),
+    harnessVersions: HookPilotHarnessVersionsSchema,
+})
+    .strict();
+/** A bounded collection of actual pilot receipts. Missing or partial checks hold promotion. */
+export const HookPilotEvidenceSchema = HookPilotIdentitySchema.extend({
+    schemaVersion: z.literal(1),
+    vidaRepository: z
+        .string()
+        .regex(/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/)
+        .max(256),
+    hostedRunId: z.number().int().positive().safe(),
+    checks: z
+        .object({
+        packedArtifact: HookPilotProofReferenceSchema,
+        publishedCanary: HookPilotProofReferenceSchema,
+        readOnlyDev: HookPilotProofReferenceSchema,
+        readOnlyProd: HookPilotProofReferenceSchema,
+        liveClaude: HookPilotProofReferenceSchema,
+        liveCodex: HookPilotProofReferenceSchema,
+        hostedCi: HookPilotProofReferenceSchema,
+    })
+        .strict(),
+}).strict();
+/** Structured, redacted proof produced by a real check and retained with its hash. */
+export const HookPilotProofSchema = HookPilotIdentitySchema.extend({
+    schemaVersion: z.literal(1),
+    check: z.enum(HOOK_PILOT_CHECKS),
+    status: z.literal('pass'),
+    observedAt: z.string().datetime(),
+    checkedCount: z.number().int().min(1).max(100000),
+    exitCode: z.literal(0),
+    mode: z.enum(['packed-artifact', 'published-canary', 'read-only', 'live-harness', 'hosted-ci']),
+    packageVersions: z.record(z.string().max(256), z.string().max(128)).optional(),
+    ordinaryCommands: z.number().int().min(1).max(100000).optional(),
+    disposablePushes: z.number().int().min(1).max(100000).optional(),
+    hostedRunId: z.number().int().positive().safe().optional(),
+    url: z.string().url().max(2048).optional(),
+}).strict();
+/** Minimal authoritative GitHub response required for an actual successful workflow run. */
+export const HookPilotHostedRunSchema = z.object({
+    id: z.number().int().positive(),
+    head_sha: z.string().regex(/^[a-f0-9]{40}$/),
+    status: z.literal('completed'),
+    conclusion: z.literal('success'),
+    path: z.string().max(4096),
+    html_url: z.string().url().max(2048),
+    repository: z.object({ full_name: z.string().max(256) }),
+});
+/** Minimal runner/step evidence; an empty never-started job cannot satisfy hosted CI. */
+export const HookPilotHostedJobsSchema = z.object({
+    jobs: z
+        .array(z.object({
+        name: z.string().max(256),
+        status: z.string().max(32),
+        conclusion: z.string().nullable(),
+        runner_id: z.number().int(),
+        runner_name: z.string().nullable(),
+        labels: z.array(z.string().max(128)).max(32),
+        steps: z
+            .array(z.object({
+            name: z.string().max(512),
+            status: z.string().max(32),
+            conclusion: z.string().nullable(),
+        }))
+            .max(256),
+    }))
+        .max(100),
+});
+//# sourceMappingURL=hook-pilot.js.map

package/dist/release/hook-pilot.js.map

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

package/dist/release/plan.d.ts

@@ -44,7 +44,15 @@ export declare const RELEASE_PLAN_SCHEMA_URL = "https://cleocode.io/schemas/rele
  * Includes `rc` in addition to the legacy `latest|beta|alpha` triple to allow
  * release candidates without conflating with `beta` per SPEC §6.1.
  */
-export declare const RELEASE_CHANNEL: readonly ["latest", "beta", "alpha", "rc"];
+export declare const RELEASE_CHANNEL: readonly ["latest", "beta", "alpha", "rc", "canary"];
+/** Persisted prerelease classification, shared by planning and reconciliation. */
+export declare const RELEASE_PERSISTED_CHANNEL: {
+    readonly latest: "latest";
+    readonly beta: "beta";
+    readonly alpha: "dev";
+    readonly rc: "beta";
+    readonly canary: "beta";
+};
 /**
  * Version-scheme variants. `calver-suffix` is the hotfix grammar
  * `vYYYY.M.DD.N` per SPEC R-402.
@@ -101,6 +109,7 @@ export declare const ReleaseChannelSchema: z.ZodEnum<{
     beta: "beta";
     latest: "latest";
     alpha: "alpha";
+    canary: "canary";
     rc: "rc";
 }>;
 /** Zod schema for {@link RELEASE_SCHEME}. */
@@ -351,6 +360,7 @@ export declare const ReleasePlanSchema: z.ZodObject<{
         beta: "beta";
         latest: "latest";
         alpha: "alpha";
+        canary: "canary";
         rc: "rc";
     }>;
     epicId: z.ZodNullable<z.ZodString>;
@@ -359,6 +369,7 @@ export declare const ReleasePlanSchema: z.ZodObject<{
         regular: "regular";
         prerelease: "prerelease";
     }>;
+    hooksV1Promotion: z.ZodOptional<z.ZodBoolean>;
     createdAt: z.ZodISODateTime;
     createdBy: z.ZodString;
     previousVersion: z.ZodNullable<z.ZodString>;

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

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

package/dist/release/plan.js

@@ -46,7 +46,15 @@ export const RELEASE_PLAN_SCHEMA_URL = 'https://cleocode.io/schemas/release-plan
  * 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'];
+export const RELEASE_CHANNEL = ['latest', 'beta', 'alpha', 'rc', 'canary'];
+/** Persisted prerelease classification, shared by planning and reconciliation. */
+export const RELEASE_PERSISTED_CHANNEL = {
+    latest: 'latest',
+    beta: 'beta',
+    alpha: 'dev',
+    rc: 'beta',
+    canary: 'beta',
+};
 /**
  * Version-scheme variants. `calver-suffix` is the hotfix grammar
  * `vYYYY.M.DD.N` per SPEC R-402.
@@ -307,7 +315,8 @@ export const ReleasePlanMetaSchema = z
  * - R-305: `platformMatrix[]` non-empty.
  * - R-306: deterministic re-validation inside `open` and `reconcile`.
  */
-export const ReleasePlanSchema = z.object({
+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`. */
@@ -328,6 +337,8 @@ export const ReleasePlanSchema = z.object({
     epicId: NonEmptyString.nullable(),
     /** Release-kind classification. */
     releaseKind: ReleaseKindSchema,
+    /** Explicit hooks-v1 stable promotion; ordinary and hotfix releases are exempt. */
+    hooksV1Promotion: z.boolean().optional(),
     /** ISO-8601 timestamp the plan was written. */
     createdAt: Iso8601,
     /** Identifier of the actor that wrote the plan (agent name or operator). */
@@ -361,6 +372,18 @@ export const ReleasePlanSchema = z.object({
     status: ReleaseStatusSchema,
     /** Informational / forward-compat metadata. */
     meta: ReleasePlanMetaSchema.optional(),
+})
+    .superRefine((plan, context) => {
+    const canaryVersion = /-canary\.\d+$/.test(plan.resolvedVersion);
+    const canarySuffix = /-canary(?:\.|$)/.test(plan.resolvedVersion);
+    if ((plan.channel === 'canary' && !canaryVersion) ||
+        (plan.channel !== 'canary' && canarySuffix)) {
+        context.addIssue({
+            code: 'custom',
+            path: ['channel'],
+            message: 'Numbered canary versions require the independent canary channel.',
+        });
+    }
 });
 // ─── Parse helper ────────────────────────────────────────────────────────────
 /**

package/dist/release/plan.js.map

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

package/dist/release/plan.test.js

@@ -103,8 +103,8 @@ describe('Release plan constant tuples', () => {
         ]);
         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 independent canary channel alongside existing channels', () => {
+        expect(new Set(RELEASE_CHANNEL)).toEqual(new Set(['latest', 'beta', 'alpha', 'rc', 'canary']));
     });
     it('exports the 3-scheme set including calver-suffix', () => {
         expect(RELEASE_SCHEME).toContain('calver');
@@ -202,9 +202,20 @@ describe('ReleasePlanSchema — status FSM', () => {
 // ─── Enum rejection per field ────────────────────────────────────────────────
 describe('ReleasePlanSchema — enum rejection', () => {
     it('rejects unknown channel', () => {
-        const plan = { ...makeValidPlan(), channel: 'canary' };
+        const plan = { ...makeValidPlan(), channel: 'rolling' };
         expect(() => parseReleasePlan(plan)).toThrow();
     });
+    it('accepts numbered canaries and rejects channel/version disagreement', () => {
+        const plan = {
+            ...makeValidPlan(),
+            version: 'v2026.10.6-canary.1',
+            resolvedVersion: 'v2026.10.6-canary.1',
+            channel: 'canary',
+        };
+        expect(parseReleasePlan(plan).channel).toBe('canary');
+        expect(() => parseReleasePlan({ ...plan, channel: 'latest' })).toThrow();
+        expect(() => parseReleasePlan({ ...plan, resolvedVersion: 'v2026.10.6-canary' })).toThrow();
+    });
     it('rejects unknown scheme', () => {
         const plan = { ...makeValidPlan(), scheme: 'rolling' };
         expect(() => parseReleasePlan(plan)).toThrow();