@cleocode/contracts 2026.5.129 → 2026.5.131

package/dist/supervisor-ipc/messages.js

@@ -0,0 +1,312 @@
+/**
+ * `supervisor-ipc` v1.0 — FROZEN message contract (Zod schemas).
+ *
+ * This is the byte-for-byte TypeScript mirror of the Rust serde types in
+ * `crates/cleo-supervisor/src/ipc.rs`. The wire format is newline-delimited
+ * JSON (NDJSON): one {@link SupervisorIpcEnvelope} per line. The supervisor
+ * (Rust) is the server; CLEO/Studio (TypeScript) are clients that send
+ * {@link SupervisorIpcRequest}s and receive {@link SupervisorIpcResponse}s and
+ * unsolicited {@link LifecycleEvent}s.
+ *
+ * Wire-shape contract (snake_case keys — matches serde defaults):
+ *
+ * ```jsonc
+ * // request
+ * { "protocol_version": "1.0.0", "id": "abc", "direction": "request",
+ *   "request": { "kind": "spawn", "child_id": "w1", "program": "/bin/node",
+ *                "args": [], "env": [] } }
+ * // response
+ * { "protocol_version": "1.0.0", "id": "abc", "direction": "response",
+ *   "response": { "kind": "spawned", "child_id": "w1", "pid": 4242 } }
+ * ```
+ *
+ * FROZEN v1.0: R2 (T11253) consumes this exact set. Do not add/rename/remove
+ * fields in place — see {@link SUPERVISOR_IPC_PROTOCOL_VERSION}.
+ *
+ * @task T11339
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+// ─── Shared value types ───────────────────────────────────────────────────────
+/**
+ * A single environment key/value override applied to a spawned child, layered
+ * on top of the supervisor's own environment. Mirrors `EnvPair` in Rust.
+ */
+export const EnvPairSchema = z
+    .object({
+    /** Environment variable name. */
+    key: z.string().min(1),
+    /** Environment variable value. */
+    value: z.string(),
+})
+    .strict();
+/**
+ * Liveness state of a supervised child. Mirrors `ChildState` in Rust.
+ *
+ * - `running`    — the child process is alive.
+ * - `restarting` — the child exited and a backoff-delayed restart is pending.
+ * - `stopped`    — the child exited and will not be restarted.
+ */
+export const ChildStateSchema = z.enum(['running', 'restarting', 'stopped']);
+/**
+ * A single child's status row in a monitor snapshot. Mirrors `ChildStatus`.
+ */
+export const ChildStatusSchema = z
+    .object({
+    /** Logical id of the child (stable across restarts). */
+    child_id: z.string().min(1),
+    /** Current OS pid (0 when not currently running). */
+    pid: z.number().int().nonnegative(),
+    /** Current liveness state. */
+    state: ChildStateSchema,
+    /** Total restarts observed for this child. */
+    restart_count: z.number().int().nonnegative(),
+})
+    .strict();
+// ─── Requests (client → supervisor) ───────────────────────────────────────────
+/**
+ * Ask the supervisor to spawn a new child worker. Mirrors `SpawnRequest`.
+ */
+export const SpawnRequestSchema = z
+    .object({
+    /** Tag discriminating this request variant. */
+    kind: z.literal('spawn'),
+    /** Caller-chosen logical id for the child (stable across restarts). */
+    child_id: z.string().min(1),
+    /** Absolute path to the program to execute. */
+    program: z.string().min(1),
+    /** Arguments passed to the program. */
+    args: z.array(z.string()).default([]),
+    /** Environment overrides applied on top of the supervisor's environment. */
+    env: z.array(EnvPairSchema).default([]),
+    /** Optional working directory for the child. */
+    cwd: z.string().optional(),
+})
+    .strict();
+/**
+ * Ask the supervisor to restart an existing child by id. Mirrors `RestartRequest`.
+ */
+export const RestartRequestSchema = z
+    .object({
+    /** Tag discriminating this request variant. */
+    kind: z.literal('restart'),
+    /** Logical id of the child to restart. */
+    child_id: z.string().min(1),
+})
+    .strict();
+/**
+ * Ask the supervisor for the status of one or all children. Mirrors `MonitorRequest`.
+ */
+export const MonitorRequestSchema = z
+    .object({
+    /** Tag discriminating this request variant. */
+    kind: z.literal('monitor'),
+    /** Specific child id to monitor; omit to request all children. */
+    child_id: z.string().optional(),
+})
+    .strict();
+/**
+ * Ask the supervisor for its own health. Mirrors `HealthRequest` (no fields
+ * beyond the discriminator).
+ */
+export const HealthRequestSchema = z
+    .object({
+    /** Tag discriminating this request variant. */
+    kind: z.literal('health'),
+})
+    .strict();
+/**
+ * The discriminated union of all client → supervisor requests. The `kind`
+ * field selects the variant, matching the serde `#[serde(tag = "kind")]`
+ * tagging on the Rust `IpcRequest` enum.
+ */
+export const SupervisorIpcRequestSchema = z.discriminatedUnion('kind', [
+    SpawnRequestSchema,
+    RestartRequestSchema,
+    MonitorRequestSchema,
+    HealthRequestSchema,
+]);
+// ─── Responses (supervisor → client) ──────────────────────────────────────────
+/**
+ * Result of a {@link SpawnRequest}. Mirrors `SpawnResult` carried by the
+ * `spawned` response variant.
+ */
+export const SpawnedResponseSchema = z
+    .object({
+    /** Tag discriminating this response variant. */
+    kind: z.literal('spawned'),
+    /** Logical id of the spawned child. */
+    child_id: z.string().min(1),
+    /** OS pid assigned to the spawned child. */
+    pid: z.number().int().nonnegative(),
+})
+    .strict();
+/**
+ * Result of a {@link RestartRequest}. Mirrors `RestartResult`.
+ */
+export const RestartedResponseSchema = z
+    .object({
+    /** Tag discriminating this response variant. */
+    kind: z.literal('restarted'),
+    /** Logical id of the restarted child. */
+    child_id: z.string().min(1),
+    /** New OS pid after the restart. */
+    pid: z.number().int().nonnegative(),
+    /** Number of times this child has been restarted in total. */
+    restart_count: z.number().int().nonnegative(),
+})
+    .strict();
+/**
+ * A monitor snapshot for one or more children. Mirrors `MonitorResult`.
+ */
+export const MonitorResponseSchema = z
+    .object({
+    /** Tag discriminating this response variant. */
+    kind: z.literal('monitor'),
+    /** One row per monitored child. */
+    children: z.array(ChildStatusSchema),
+})
+    .strict();
+/**
+ * A health snapshot for the supervisor itself. Mirrors `HealthResult`.
+ */
+export const HealthResponseSchema = z
+    .object({
+    /** Tag discriminating this response variant. */
+    kind: z.literal('health'),
+    /** Supervisor process pid. */
+    pid: z.number().int().nonnegative(),
+    /** Number of children currently tracked. */
+    child_count: z.number().int().nonnegative(),
+    /** Seconds the supervisor has been running. */
+    uptime_secs: z.number().int().nonnegative(),
+    /** Frozen protocol version the supervisor speaks. */
+    protocol_version: z.string(),
+})
+    .strict();
+/**
+ * Lifecycle event kind. Mirrors `LifecycleEventKind`.
+ *
+ * - `child_exited`    — a child process exited.
+ * - `child_restarted` — a child was restarted after a crash.
+ */
+export const LifecycleEventKindSchema = z.enum(['child_exited', 'child_restarted']);
+/**
+ * An unsolicited lifecycle event broadcast to all connected clients. Mirrors
+ * the `event` response variant wrapping `LifecycleEvent`.
+ */
+export const LifecycleEventResponseSchema = z
+    .object({
+    /** Tag discriminating this response variant. */
+    kind: z.literal('event'),
+    /** What happened. */
+    event: LifecycleEventKindSchema,
+    /** Logical id of the affected child. */
+    child_id: z.string().min(1),
+    /** Exit code, when the OS reported one. */
+    exit_code: z.number().int().optional(),
+    /** Terminating signal name, when the child was signalled (Unix). */
+    signal: z.string().optional(),
+    /** Backoff delay (ms) before the pending restart, when applicable. */
+    restart_delay_ms: z.number().int().nonnegative().optional(),
+})
+    .strict();
+/**
+ * An error response correlated to a request. Mirrors `ErrorResult`.
+ */
+export const ErrorResponseSchema = z
+    .object({
+    /** Tag discriminating this response variant. */
+    kind: z.literal('error'),
+    /** Machine-readable error code (e.g. `E_UNKNOWN_CHILD`). */
+    code: z.string().min(1),
+    /** Human-readable error message. */
+    message: z.string(),
+})
+    .strict();
+/**
+ * The discriminated union of all supervisor → client responses and events. The
+ * `kind` field selects the variant, matching the serde `#[serde(tag = "kind")]`
+ * tagging on the Rust `IpcResponse` enum.
+ */
+export const SupervisorIpcResponseSchema = z.discriminatedUnion('kind', [
+    SpawnedResponseSchema,
+    RestartedResponseSchema,
+    MonitorResponseSchema,
+    HealthResponseSchema,
+    LifecycleEventResponseSchema,
+    ErrorResponseSchema,
+]);
+// ─── Envelope ──────────────────────────────────────────────────────────────────
+/**
+ * A client → supervisor request envelope.
+ *
+ * The `direction` discriminator + flattened `request` payload mirror the serde
+ * `#[serde(tag = "direction")]` `IpcPayload::Request { request }` variant.
+ */
+export const SupervisorIpcRequestEnvelopeSchema = z
+    .object({
+    /** Frozen protocol version. */
+    protocol_version: z.string(),
+    /** Correlation id echoed back on the matching response. */
+    id: z.string().min(1),
+    /** Direction discriminator. */
+    direction: z.literal('request'),
+    /** The request body. */
+    request: SupervisorIpcRequestSchema,
+})
+    .strict();
+/**
+ * A supervisor → client response/event envelope.
+ *
+ * The `direction` discriminator + flattened `response` payload mirror the serde
+ * `IpcPayload::Response { response }` variant.
+ */
+export const SupervisorIpcResponseEnvelopeSchema = z
+    .object({
+    /** Frozen protocol version. */
+    protocol_version: z.string(),
+    /** Correlation id echoed from the originating request (or a fresh id for events). */
+    id: z.string().min(1),
+    /** Direction discriminator. */
+    direction: z.literal('response'),
+    /** The response body. */
+    response: SupervisorIpcResponseSchema,
+})
+    .strict();
+/**
+ * The top-level IPC envelope: a versioned, correlated wrapper that is either a
+ * request or a response, discriminated by `direction`. One envelope per NDJSON
+ * line. Mirrors the Rust `IpcEnvelope`.
+ */
+export const SupervisorIpcEnvelopeSchema = z.discriminatedUnion('direction', [
+    SupervisorIpcRequestEnvelopeSchema,
+    SupervisorIpcResponseEnvelopeSchema,
+]);
+// ─── Frozen message-set guard ──────────────────────────────────────────────────
+/**
+ * The FROZEN v1.0 request `kind` values. The schema-drift guard test pins this
+ * tuple; any addition/removal is a contract-breaking change.
+ */
+export const SUPERVISOR_IPC_REQUEST_KINDS = ['spawn', 'restart', 'monitor', 'health'];
+/**
+ * The FROZEN v1.0 response `kind` values. The schema-drift guard test pins this
+ * tuple; any addition/removal is a contract-breaking change.
+ */
+export const SUPERVISOR_IPC_RESPONSE_KINDS = [
+    'spawned',
+    'restarted',
+    'monitor',
+    'health',
+    'event',
+    'error',
+];
+/**
+ * The complete FROZEN v1.0 message kind set (requests + responses), used by the
+ * drift guard on both the TS and Rust sides.
+ */
+export const SUPERVISOR_IPC_MESSAGE_KINDS = [
+    ...SUPERVISOR_IPC_REQUEST_KINDS,
+    ...SUPERVISOR_IPC_RESPONSE_KINDS,
+];
+//# sourceMappingURL=messages.js.map

package/dist/supervisor-ipc/messages.js.map

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

package/dist/supervisor-ipc/version.d.ts

@@ -0,0 +1,29 @@
+/**
+ * FROZEN protocol version for the `supervisor-ipc` v1.0 contract.
+ *
+ * The Rust supervisor (`crates/cleo-supervisor/src/ipc.rs`) and this TypeScript
+ * contract MUST agree on this value. R2 (T11253) consumes the v1.0 message set
+ * without churn, so the version is **frozen**: bump only via a new major
+ * contract revision in a new directory, never edit this value in place.
+ *
+ * @see {@link SUPERVISOR_IPC_MESSAGE_KINDS} for the frozen v1.0 message set.
+ * @task T11339
+ * @packageDocumentation
+ */
+/**
+ * The frozen `supervisor-ipc` protocol version string.
+ *
+ * Mirrors `cleo_supervisor::ipc::IPC_PROTOCOL_VERSION` on the Rust side. Both a
+ * Rust schema-drift guard (`crates/cleo-supervisor` `ipc::tests`) and the TS
+ * drift test (`__tests__/freeze.test.ts`) pin this exact value.
+ */
+export declare const SUPERVISOR_IPC_PROTOCOL_VERSION: "1.0.0";
+/**
+ * Default base name for the IPC channel.
+ *
+ * Unix sockets are created under the CLEO home as `<basename>.sock`; Windows
+ * named pipes use `\\.\pipe\<basename>.<pid>`. Mirrors
+ * `cleo_supervisor::ipc::IPC_CHANNEL_BASENAME`.
+ */
+export declare const SUPERVISOR_IPC_CHANNEL_BASENAME: "cleo-supervisor";
+//# sourceMappingURL=version.d.ts.map

package/dist/supervisor-ipc/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/supervisor-ipc/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,EAAG,OAAgB,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,EAAG,iBAA0B,CAAC"}

package/dist/supervisor-ipc/version.js

@@ -0,0 +1,29 @@
+/**
+ * FROZEN protocol version for the `supervisor-ipc` v1.0 contract.
+ *
+ * The Rust supervisor (`crates/cleo-supervisor/src/ipc.rs`) and this TypeScript
+ * contract MUST agree on this value. R2 (T11253) consumes the v1.0 message set
+ * without churn, so the version is **frozen**: bump only via a new major
+ * contract revision in a new directory, never edit this value in place.
+ *
+ * @see {@link SUPERVISOR_IPC_MESSAGE_KINDS} for the frozen v1.0 message set.
+ * @task T11339
+ * @packageDocumentation
+ */
+/**
+ * The frozen `supervisor-ipc` protocol version string.
+ *
+ * Mirrors `cleo_supervisor::ipc::IPC_PROTOCOL_VERSION` on the Rust side. Both a
+ * Rust schema-drift guard (`crates/cleo-supervisor` `ipc::tests`) and the TS
+ * drift test (`__tests__/freeze.test.ts`) pin this exact value.
+ */
+export const SUPERVISOR_IPC_PROTOCOL_VERSION = '1.0.0';
+/**
+ * Default base name for the IPC channel.
+ *
+ * Unix sockets are created under the CLEO home as `<basename>.sock`; Windows
+ * named pipes use `\\.\pipe\<basename>.<pid>`. Mirrors
+ * `cleo_supervisor::ipc::IPC_CHANNEL_BASENAME`.
+ */
+export const SUPERVISOR_IPC_CHANNEL_BASENAME = 'cleo-supervisor';
+//# sourceMappingURL=version.js.map

package/dist/supervisor-ipc/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/supervisor-ipc/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,OAAgB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,iBAA0B,CAAC"}

package/dist/tools/__tests__/composite.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Contract-shape tests for the composite meta-tool contracts (T11484).
+ *
+ * The RUNTIME for `module-relocation` / `add-workspace-package` is deferred to
+ * epic T11456 (the TOOLS canonical structure that supplies their correct home,
+ * category enum, descriptor schema, and registry — see composite.ts header).
+ * These tests lock the CONTRACT surface that ships now: the breakage-class and
+ * wiring-point SoT arrays, and that the input/result shapes are constructible.
+ *
+ * @epic T11480
+ * @task T11484
+ */
+export {};
+//# sourceMappingURL=composite.test.d.ts.map

package/dist/tools/__tests__/composite.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/composite.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/tools/__tests__/composite.test.js

@@ -0,0 +1,75 @@
+/**
+ * Contract-shape tests for the composite meta-tool contracts (T11484).
+ *
+ * The RUNTIME for `module-relocation` / `add-workspace-package` is deferred to
+ * epic T11456 (the TOOLS canonical structure that supplies their correct home,
+ * category enum, descriptor schema, and registry — see composite.ts header).
+ * These tests lock the CONTRACT surface that ships now: the breakage-class and
+ * wiring-point SoT arrays, and that the input/result shapes are constructible.
+ *
+ * @epic T11480
+ * @task T11484
+ */
+import { describe, expect, expectTypeOf, it } from 'vitest';
+import { ADD_WORKSPACE_PACKAGE_WIRING_POINTS, MODULE_RELOCATION_BREAKAGE_CLASSES, } from '../composite.js';
+describe('module-relocation contract (DHQ-032)', () => {
+    it('enumerates exactly the seven breakage classes', () => {
+        expect([...MODULE_RELOCATION_BREAKAGE_CLASSES]).toEqual([
+            'relative-import-depth',
+            'barrels',
+            'js-form-and-dynamic-import',
+            'mirror-test-dirs',
+            'deprecations-yml',
+            'doc-comments',
+            'cross-package-importers',
+        ]);
+        expect(new Set(MODULE_RELOCATION_BREAKAGE_CLASSES).size).toBe(7);
+    });
+    it('has a constructible input + result shape', () => {
+        const input = {
+            fromPath: 'packages/core/src/a.ts',
+            toPath: 'packages/core/src/sub/a.ts',
+            repoRoot: '/repo',
+        };
+        expect(input.fromPath).toBe('packages/core/src/a.ts');
+        const result = {
+            toPath: input.toPath,
+            shimLeft: false,
+            dryRun: true,
+            classes: [{ class: 'barrels', files: ['packages/core/src/index.ts'], edits: 1 }],
+            filesTouched: ['packages/core/src/index.ts'],
+        };
+        expect(result.classes[0]?.class).toBe('barrels');
+        expectTypeOf(result.classes).items.toHaveProperty('class');
+    });
+});
+describe('add-workspace-package contract (DHQ-027)', () => {
+    it('enumerates exactly the six wiring points', () => {
+        expect([...ADD_WORKSPACE_PACKAGE_WIRING_POINTS]).toEqual([
+            'deps',
+            'tsconfig-refs',
+            'build-mjs-buildpkg',
+            'inline-maps',
+            'boundary-entry',
+            'private-no-readme',
+        ]);
+        expect(new Set(ADD_WORKSPACE_PACKAGE_WIRING_POINTS).size).toBe(6);
+    });
+    it('has a constructible input + result shape', () => {
+        const input = {
+            packageName: '@cleocode/foo',
+            repoRoot: '/repo',
+            consumers: ['@cleocode/core'],
+        };
+        expect(input.packageName).toBe('@cleocode/foo');
+        const result = {
+            packageName: input.packageName,
+            packageDir: 'packages/foo',
+            dryRun: true,
+            points: [{ point: 'deps', files: ['packages/core/package.json'] }],
+        };
+        expect(result.points[0]?.point).toBe('deps');
+        expectTypeOf(result.points).items.toHaveProperty('point');
+    });
+});
+//# sourceMappingURL=composite.test.js.map

package/dist/tools/__tests__/composite.test.js.map

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