@cleocode/contracts 2026.5.96 → 2026.5.98

package/dist/__tests__/scaffold-diagnostics.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Structural-equivalence tests for the scaffold-diagnostics contracts.
+ *
+ * These tests pin the field shapes of {@link ScaffoldResult},
+ * {@link CheckStatus}, {@link CheckResult}, and {@link HookCheckResult}
+ * so accidental narrowing or widening triggers a compile-time failure
+ * during `tsc -b` in the CI gate.
+ *
+ * The compile-time assertions use the conditional-equality trick
+ * (`Equals<A, B>`) so any structural drift produces a TS2322 or TS2344
+ * at build time. The runtime `expect` shape sanity check below is a
+ * thin smoke verification that constructible literals satisfy each
+ * interface — it does NOT exercise behavior (these are pure type
+ * contracts with no runtime).
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 (Phase 0a)
+ */
+export {};
+//# sourceMappingURL=scaffold-diagnostics.test.d.ts.map

package/dist/__tests__/scaffold-diagnostics.test.d.ts.map

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

package/dist/__tests__/scaffold-diagnostics.test.js

@@ -0,0 +1,70 @@
+/**
+ * Structural-equivalence tests for the scaffold-diagnostics contracts.
+ *
+ * These tests pin the field shapes of {@link ScaffoldResult},
+ * {@link CheckStatus}, {@link CheckResult}, and {@link HookCheckResult}
+ * so accidental narrowing or widening triggers a compile-time failure
+ * during `tsc -b` in the CI gate.
+ *
+ * The compile-time assertions use the conditional-equality trick
+ * (`Equals<A, B>`) so any structural drift produces a TS2322 or TS2344
+ * at build time. The runtime `expect` shape sanity check below is a
+ * thin smoke verification that constructible literals satisfy each
+ * interface — it does NOT exercise behavior (these are pure type
+ * contracts with no runtime).
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 (Phase 0a)
+ */
+import { describe, expect, it } from 'vitest';
+// ─── Runtime constructibility smoke ─────────────────────────────────
+describe('scaffold-diagnostics contracts', () => {
+    it('ScaffoldResult is constructible with the canonical shape', () => {
+        const r = { action: 'created', path: '/tmp/x' };
+        expect(r.action).toBe('created');
+        expect(r.path).toBe('/tmp/x');
+        expect(r.details).toBeUndefined();
+    });
+    it('ScaffoldResult accepts the optional details field', () => {
+        const r = {
+            action: 'repaired',
+            path: '/tmp/y',
+            details: 'rewrote stale entry',
+        };
+        expect(r.details).toBe('rewrote stale entry');
+    });
+    it('CheckResult is constructible with the canonical shape', () => {
+        const r = {
+            id: 'cleo_structure',
+            category: 'scaffold',
+            status: 'passed',
+            message: 'All subdirs present',
+            details: { missing: [] },
+            fix: null,
+        };
+        expect(r.status).toBe('passed');
+        expect(r.fix).toBeNull();
+    });
+    it('CheckStatus union covers exactly the 4 documented values', () => {
+        const statuses = ['passed', 'failed', 'warning', 'info'];
+        expect(statuses).toHaveLength(4);
+    });
+    it('HookCheckResult is constructible with the canonical shape', () => {
+        const r = {
+            hook: 'pre-commit',
+            installed: true,
+            current: false,
+            sourcePath: '/pkg/templates/git-hooks/pre-commit',
+            installedPath: '/proj/.git/hooks/pre-commit',
+        };
+        expect(r.installed).toBe(true);
+        expect(r.current).toBe(false);
+    });
+    // The four `_Assert…Pinned` aliases above will fail compilation if
+    // any shape drifts. The following references prevent unused-locals
+    // diagnostics from removing them.
+    it('compile-time pins are wired (no-op at runtime)', () => {
+        const pinned = [1, 1, 1, 1];
+        expect(pinned).toEqual([1, 1, 1, 1]);
+    });
+});
+//# sourceMappingURL=scaffold-diagnostics.test.js.map

package/dist/__tests__/scaffold-diagnostics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-diagnostics.test.js","sourceRoot":"","sources":["../../src/__tests__/scaffold-diagnostics.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAyD9C,uEAAuE;AAEvE,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAmB,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAChE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,GAAmB;YACxB,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,qBAAqB;SAC/B,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,GAAgB;YACrB,EAAE,EAAE,gBAAgB;YACpB,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,qBAAqB;YAC9B,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YACxB,GAAG,EAAE,IAAI;SACV,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,QAAQ,GAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACxE,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,GAAoB;YACzB,IAAI,EAAE,YAAY;YAClB,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,qCAAqC;YACjD,aAAa,EAAE,6BAA6B;SAC7C,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,mEAAmE;IACnE,mEAAmE;IACnE,kCAAkC;IAClC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAKR,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACjB,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/dispatch/identity.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Dispatch identity contracts.
+ *
+ * Canonical home for the three primitive identity types every dispatch
+ * operation is keyed on:
+ *
+ *   - {@link Gateway}          — CQRS read vs write classification
+ *   - {@link Tier}             — progressive-disclosure tier (0/1/2)
+ *   - {@link CanonicalDomain}  — the closed set of dispatch domains
+ *
+ * Promoted to `@cleocode/contracts` in Phase 0b of the SG-ARCH-SOLID
+ * Saga (T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954) alongside
+ * {@link OperationDef} / {@link Resolution}. Originally defined in
+ * `packages/cleo/src/dispatch/types.ts` (lines 16, 27, 58, 86). The
+ * `packages/cleo` definition is now a re-export shim — every consumer
+ * continues to compile unchanged.
+ *
+ * `CANONICAL_DOMAINS` remains the runtime SSoT — adding/removing a
+ * domain still requires editing the array here exactly as before.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+/**
+ * CQRS gateway: read-only queries vs state-modifying mutations.
+ *
+ * Originally defined in `packages/cleo/src/dispatch/types.ts:16`.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+export type Gateway = 'query' | 'mutate';
+/**
+ * Progressive disclosure tier.
+ *
+ * - `0` — tasks + session (~80% of agents)
+ * - `1` — + memory + check (~15% of agents)
+ * - `2` — + pipeline + orchestrate + tools + admin + nexus (~5%)
+ *
+ * Originally defined in `packages/cleo/src/dispatch/types.ts:27`.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+export type Tier = 0 | 1 | 2;
+/**
+ * The closed set of dispatch canonical-domain names.
+ *
+ * T964: `conduit` promoted to first-class domain (supersedes ADR-042 Decision 1).
+ * CONDUIT is agent-to-agent messaging and is semantically disjoint from
+ * ORCHESTRATE (wave planning + spawn-prompt generation). The original
+ * "exactly 10 canonical domains" invariant that justified folding CONDUIT
+ * under ORCHESTRATE has been broken multiple times (intelligence, diagnostics,
+ * docs, playbook); promoting CONDUIT aligns registry with wire-format, CLI,
+ * and core module structure at zero behavior cost.
+ *
+ * T1726: `sentient` and `release` promoted to first-class domains. Both were
+ * reachable via the CLI and had registered DomainHandlers but were absent from
+ * CANONICAL_DOMAINS, making them invisible to SDK consumers via OPERATIONS.
+ *
+ * Originally defined in `packages/cleo/src/dispatch/types.ts:58`.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+export declare const CANONICAL_DOMAINS: readonly ["tasks", "session", "memory", "check", "pipeline", "orchestrate", "tools", "admin", "nexus", "sticky", "intelligence", "diagnostics", "docs", "playbook", "conduit", "sentient", "release", "llm", "provenance", "upgrade", "worktree", "focus"];
+/**
+ * One of the canonical dispatch domain names.
+ *
+ * Derived as a string-literal union from {@link CANONICAL_DOMAINS} so
+ * adding/removing a domain in the array automatically updates the type.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+export type CanonicalDomain = (typeof CANONICAL_DOMAINS)[number];
+//# sourceMappingURL=identity.d.ts.map

package/dist/dispatch/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/dispatch/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAIzC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAI7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,4PA4BpB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/dispatch/identity.js

@@ -0,0 +1,72 @@
+/**
+ * Dispatch identity contracts.
+ *
+ * Canonical home for the three primitive identity types every dispatch
+ * operation is keyed on:
+ *
+ *   - {@link Gateway}          — CQRS read vs write classification
+ *   - {@link Tier}             — progressive-disclosure tier (0/1/2)
+ *   - {@link CanonicalDomain}  — the closed set of dispatch domains
+ *
+ * Promoted to `@cleocode/contracts` in Phase 0b of the SG-ARCH-SOLID
+ * Saga (T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954) alongside
+ * {@link OperationDef} / {@link Resolution}. Originally defined in
+ * `packages/cleo/src/dispatch/types.ts` (lines 16, 27, 58, 86). The
+ * `packages/cleo` definition is now a re-export shim — every consumer
+ * continues to compile unchanged.
+ *
+ * `CANONICAL_DOMAINS` remains the runtime SSoT — adding/removing a
+ * domain still requires editing the array here exactly as before.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+// ── CanonicalDomain ──────────────────────────────────────────────────
+/**
+ * The closed set of dispatch canonical-domain names.
+ *
+ * T964: `conduit` promoted to first-class domain (supersedes ADR-042 Decision 1).
+ * CONDUIT is agent-to-agent messaging and is semantically disjoint from
+ * ORCHESTRATE (wave planning + spawn-prompt generation). The original
+ * "exactly 10 canonical domains" invariant that justified folding CONDUIT
+ * under ORCHESTRATE has been broken multiple times (intelligence, diagnostics,
+ * docs, playbook); promoting CONDUIT aligns registry with wire-format, CLI,
+ * and core module structure at zero behavior cost.
+ *
+ * T1726: `sentient` and `release` promoted to first-class domains. Both were
+ * reachable via the CLI and had registered DomainHandlers but were absent from
+ * CANONICAL_DOMAINS, making them invisible to SDK consumers via OPERATIONS.
+ *
+ * Originally defined in `packages/cleo/src/dispatch/types.ts:58`.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+export const CANONICAL_DOMAINS = [
+    'tasks',
+    'session',
+    'memory',
+    'check',
+    'pipeline',
+    'orchestrate',
+    'tools',
+    'admin',
+    'nexus',
+    'sticky',
+    'intelligence',
+    'diagnostics',
+    'docs',
+    'playbook',
+    'conduit',
+    'sentient',
+    'release',
+    'llm',
+    // T9528: provenance-graph maintenance verbs (backfill, verify, repair).
+    'provenance',
+    // T9536: `cleo upgrade workflows` — re-render release-pipeline workflow
+    // templates + 3-way merge with `.workflow-overrides.yml`.
+    'upgrade',
+    // T9546/T9547: 'cleo worktree list/prune/force-unlock' — worktree lifecycle.
+    'worktree',
+    // T9973: 'cleo focus <id>' — single-envelope task orientation (8 calls → 1).
+    'focus',
+];
+//# sourceMappingURL=identity.js.map

package/dist/dispatch/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/dispatch/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA4BH,wEAAwE;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO;IACP,SAAS;IACT,QAAQ;IACR,OAAO;IACP,UAAU;IACV,aAAa;IACb,OAAO;IACP,OAAO;IACP,OAAO;IACP,QAAQ;IACR,cAAc;IACd,aAAa;IACb,MAAM;IACN,UAAU;IACV,SAAS;IACT,UAAU;IACV,SAAS;IACT,KAAK;IACL,wEAAwE;IACxE,YAAY;IACZ,wEAAwE;IACxE,0DAA0D;IAC1D,SAAS;IACT,6EAA6E;IAC7E,UAAU;IACV,6EAA6E;IAC7E,OAAO;CACC,CAAC"}

package/dist/dispatch/operation-def.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Dispatch operation-def contracts.
+ *
+ * Canonical home for the {@link OperationDef} and {@link Resolution}
+ * interfaces that describe a single dispatchable CQRS operation and the
+ * result of resolving one from the operation registry.
+ *
+ * Promoted to `@cleocode/contracts` in Phase 0b of the SG-ARCH-SOLID Saga
+ * (T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954). Originally defined in
+ * `packages/cleo/src/dispatch/registry.ts` (lines 14-41 / 43-53). The
+ * `packages/cleo` definition is now a re-export shim — every consumer of
+ * `OperationDef` / `Resolution` continues to compile unchanged.
+ *
+ * This promotion unblocks E-CLI-BOUNDARY (T9833) — the registry data
+ * relocation can now move {@link OPERATIONS} into `@cleocode/contracts`
+ * (or split it without changing the type's canonical home) without
+ * crossing a circular dependency.
+ *
+ * NOT promoted (intentional — different concern):
+ *   - `OPERATIONS: OperationDef[]` — the registry data itself remains in
+ *     `packages/cleo/src/dispatch/registry.ts` and is the subject of the
+ *     follow-up E-CLI-BOUNDARY epic.
+ *   - The helper functions (`resolve`, `validateRequiredParams`,
+ *     `getByDomain`, `getByGateway`, `getByTier`, `getActiveDomains`,
+ *     `getCounts`, `deriveGatewayMatrix`, `getGatewayDomains`) — they
+ *     operate on the data and remain colocated with it.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+import type { ParamDef } from '../operations/params.js';
+import type { CanonicalDomain, Gateway, Tier } from './identity.js';
+export type { CanonicalDomain, Gateway, ParamDef, Tier };
+/**
+ * Definition of a single dispatchable operation.
+ *
+ * Each entry in the operation registry (currently in
+ * `packages/cleo/src/dispatch/registry.ts`'s `OPERATIONS` array)
+ * conforms to this interface. The dispatcher uses these definitions to
+ * (1) route a {@link CanonicalDomain} + operation-name + {@link Gateway}
+ * triple to its handler, (2) validate that all required parameters are
+ * present, and (3) emit dispatch-validation telemetry.
+ *
+ * Originally defined in `packages/cleo/src/dispatch/registry.ts:14-41`.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+export interface OperationDef {
+    /** The CQRS gateway ('query' or 'mutate'). */
+    gateway: Gateway;
+    /** The canonical domain this operation belongs to. */
+    domain: CanonicalDomain;
+    /** The specific operation name (e.g. 'show', 'skill.list'). */
+    operation: string;
+    /** Brief description of what the operation does. */
+    description: string;
+    /** Agent progressive-disclosure tier (0=basic, 1=memory/check, 2=full). */
+    tier: Tier;
+    /** Whether the operation is safe to retry. */
+    idempotent: boolean;
+    /** Whether this operation requires an active session. */
+    sessionRequired: boolean;
+    /** List of parameter keys that MUST be present in the request. */
+    requiredParams: string[];
+    /**
+     * Fully-described parameter list. Replaces `requiredParams` when populated.
+     * Empty array = "no declared params" (not "no params accepted").
+     * Optional during T4897 migration — defaults to [] when absent.
+     * @see T4897 for progressive migration
+     */
+    params?: ParamDef[];
+}
+/**
+ * Resolution output for a dispatch request.
+ *
+ * Returned by the `resolve(gateway, domain, operation)` helper in the
+ * operation registry. Bundles the resolved {@link OperationDef} with the
+ * already-typed `domain` + `operation` strings so downstream consumers
+ * don't have to re-narrow them.
+ *
+ * Originally defined in `packages/cleo/src/dispatch/registry.ts:43-53`.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+export interface Resolution {
+    /** The canonical domain. */
+    domain: CanonicalDomain;
+    /** The operation name. */
+    operation: string;
+    /** The definition of the matched operation. */
+    def: OperationDef;
+}
+//# sourceMappingURL=operation-def.d.ts.map

package/dist/dispatch/operation-def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-def.d.ts","sourceRoot":"","sources":["../../src/dispatch/operation-def.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAKpE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAIzD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,MAAM,EAAE,eAAe,CAAC;IACxB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,IAAI,EAAE,IAAI,CAAC;IACX,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,yDAAyD;IACzD,eAAe,EAAE,OAAO,CAAC;IACzB,kEAAkE;IAClE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAID;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,GAAG,EAAE,YAAY,CAAC;CACnB"}

package/dist/dispatch/operation-def.js

@@ -0,0 +1,31 @@
+/**
+ * Dispatch operation-def contracts.
+ *
+ * Canonical home for the {@link OperationDef} and {@link Resolution}
+ * interfaces that describe a single dispatchable CQRS operation and the
+ * result of resolving one from the operation registry.
+ *
+ * Promoted to `@cleocode/contracts` in Phase 0b of the SG-ARCH-SOLID Saga
+ * (T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954). Originally defined in
+ * `packages/cleo/src/dispatch/registry.ts` (lines 14-41 / 43-53). The
+ * `packages/cleo` definition is now a re-export shim — every consumer of
+ * `OperationDef` / `Resolution` continues to compile unchanged.
+ *
+ * This promotion unblocks E-CLI-BOUNDARY (T9833) — the registry data
+ * relocation can now move {@link OPERATIONS} into `@cleocode/contracts`
+ * (or split it without changing the type's canonical home) without
+ * crossing a circular dependency.
+ *
+ * NOT promoted (intentional — different concern):
+ *   - `OPERATIONS: OperationDef[]` — the registry data itself remains in
+ *     `packages/cleo/src/dispatch/registry.ts` and is the subject of the
+ *     follow-up E-CLI-BOUNDARY epic.
+ *   - The helper functions (`resolve`, `validateRequiredParams`,
+ *     `getByDomain`, `getByGateway`, `getByTier`, `getActiveDomains`,
+ *     `getCounts`, `deriveGatewayMatrix`, `getGatewayDomains`) — they
+ *     operate on the data and remain colocated with it.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
+ */
+export {};
+//# sourceMappingURL=operation-def.js.map

package/dist/dispatch/operation-def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-def.js","sourceRoot":"","sources":["../../src/dispatch/operation-def.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}

package/dist/doctor.d.ts

@@ -136,6 +136,49 @@ export interface ComprehensiveAuditResult {
     anomalies: WorktreeAnomaly[];
     /** Total anomaly count. Non-zero triggers exit code 2. */
     count: number;
+    /**
+     * `true` when the audit was aborted early due to a width budget overflow
+     * or a timeout. The `anomalies` list reflects only the entries scanned
+     * before the abort — results may be incomplete.
+     */
+    isPartial?: boolean;
+    /**
+     * Machine-readable reason the scan was cut short.
+     * - `'timeout'`: the configured `timeoutMs` was exceeded.
+     * - `'overflow'`: a per-level entry count exceeded `maxEntriesPerLevel`.
+     */
+    partialReason?: 'timeout' | 'overflow';
+}
+/**
+ * Result shape returned by the budgeted orphan scanner
+ * ({@link scanWorktreeOrphansBudgeted}).
+ *
+ * Wraps the bare `OrphanEntry[]` from `scanWorktreeOrphans` with optional
+ * partial-result metadata so callers can surface incomplete scans to the
+ * operator without changing the existing `OrphanEntry[]` return type.
+ */
+export interface OrphanScanResult {
+    /** Discovered orphan entries (may be incomplete when `isPartial` is `true`). */
+    orphans: OrphanEntry[];
+    /**
+     * `true` when the scan was aborted before completion due to a budget
+     * overflow or timeout. The `orphans` list reflects only entries found
+     * before the abort.
+     */
+    isPartial: boolean;
+    /**
+     * Machine-readable reason the scan was cut short.
+     * - `'timeout'`: the configured `timeoutMs` was exceeded.
+     * - `'overflow'`: a per-level entry count exceeded `maxEntriesPerLevel`.
+     * `undefined` when `isPartial` is `false`.
+     */
+    partialReason?: 'timeout' | 'overflow';
+    /**
+     * Human-readable warning message produced when the soft-warn threshold
+     * was crossed (entries per level exceeded `softWarnEntriesPerLevel` but
+     * stayed under the hard stop). `undefined` when no warning was triggered.
+     */
+    softWarnMessage?: string;
 }
 /**
  * One line appended to `.cleo/audit/worktree-prune.jsonl` per prune

package/dist/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAElB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,yEAAyE;IACzE,MAAM,EAAE,OAAO,CAAC;IAEhB,2EAA2E;IAC3E,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAExD,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,wBAAwB,GACxB,2BAA2B,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4DAA4D;IAC5D,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,EAAE,uBAAuB,CAAC;IAChC,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAC;CACjB"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAElB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,yEAAyE;IACzE,MAAM,EAAE,OAAO,CAAC;IAEhB,2EAA2E;IAC3E,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAExD,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,wBAAwB,GACxB,2BAA2B,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4DAA4D;IAC5D,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACvC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,EAAE,uBAAuB,CAAC;IAChC,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/enums.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Canonical task-axis enum constants.
+ *
+ * Single source of truth for the runtime const arrays that back the
+ * task-axis discriminators (kind, scope, severity, size, archive reason,
+ * relation type). Promoted from `packages/core/src/store/tasks-schema.ts`
+ * in Phase 0c of the SG-ARCH-SOLID Saga so that downstream packages can
+ * import the values without pulling in the Drizzle schema runtime.
+ *
+ * `tasks-schema.ts` imports these arrays back for Drizzle's
+ * `text({ enum: ... })` column declarations, which preserves byte-identical
+ * row-type narrowing and produces zero schema DDL change. `tasks-schema.ts`
+ * also re-exports each constant under its original name to preserve the
+ * existing public surface for every internal `import * as schema` consumer.
+ *
+ * The corresponding union types (`TaskKind`, `TaskScope`, `TaskSeverity`,
+ * `TaskSize`, `ArchiveReasonValue`, etc.) already live in their respective
+ * domain modules (`./task.ts`, `./tasks/archive.ts`) and are re-exported
+ * from the package root.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9955 (Phase 0c)
+ */
+/**
+ * Task kind axis — describes the intent of the work rather than its
+ * position in the hierarchy. Defaults to `'work'` to preserve semantics
+ * for tasks created before T944.
+ *
+ * Note: the DB column is named `role`; the TypeScript field is `kind`
+ * (T9067 deferral).
+ *
+ * @task T944
+ * @task T9072
+ */
+export declare const TASK_KINDS: readonly ["work", "research", "experiment", "bug", "spike", "release"];
+/**
+ * Task scope axis — describes the granularity of the work (project-wide
+ * vs. feature-scoped vs. unit-scoped). Orthogonal to type and kind.
+ *
+ * Backfill mapping from legacy `type` during migration:
+ *   - `type='epic'`    → `scope='project'`
+ *   - `type='task'`    → `scope='feature'` (also used for NULL legacy rows)
+ *   - `type='subtask'` → `scope='unit'`
+ *
+ * @task T944
+ */
+export declare const TASK_SCOPES: readonly ["project", "feature", "unit"];
+/**
+ * Task severity axis — applies to ANY task kind (not just `kind='bug'`).
+ *
+ * Enforced by a CHECK constraint:
+ *   `severity IS NULL OR severity IN ('P0','P1','P2','P3')`
+ *
+ * The original T944 constraint coupled severity to `role='bug'`. T9073
+ * widened the constraint so that spikes, incidents, research tasks, and
+ * any other kind can carry a severity level. Priority and severity are
+ * fully orthogonal axes — setting severity does NOT auto-map to priority
+ * (no SEVERITY_MAP on add/update).
+ *
+ * OWNER-WRITE-ONLY (T944 / T9073 / owner mandate): severity is set
+ * through owner-authenticated paths only (signed attestation via
+ * `appendSignedSeverityAttestation`). This prevents a prompt-injection
+ * exploit where a compromised agent could mark a P0 task as P3 to
+ * force-ship.
+ *
+ * @task T944
+ * @task T9073
+ */
+export declare const TASK_SEVERITIES: readonly ["P0", "P1", "P2", "P3"];
+/**
+ * Task size sentinel values matching the DB CHECK constraint on
+ * `tasks.size`. CLEO favors qualitative sizing over time estimates
+ * (see `cleo memory` rule "No time estimates").
+ *
+ * @task T944
+ */
+export declare const TASK_SIZES: readonly ["small", "medium", "large"];
+/**
+ * Truth-grade archive reason values enforced by a SQLite CHECK
+ * constraint on `tasks.archive_reason` (see migration
+ * `20260424000000_t1408-archive-reason-enum`).
+ *
+ * Council 2026-04-24 (FINDING #28 + T1407 follow-through) replaced the
+ * legacy unconstrained TEXT column with this 6-value enum. Rows that
+ * pre-dated the migration with non-conforming values (`completed`,
+ * `deleted`, etc.) were normalized to `'completed-unverified'` before
+ * the CHECK was applied, so EVERY existing row satisfies one of these
+ * literals (or is `NULL`).
+ *
+ * Semantics:
+ *   - `verified`             — closure passed all gates with audit-grade evidence.
+ *   - `reconciled`           — closure derived by reconciliation against an
+ *                              external source of truth (e.g. external task tracker).
+ *   - `superseded`           — closure because another task subsumes the work.
+ *   - `shadowed`             — closure because the task was experiment- or
+ *                              proposal-shadowed by a newer plan.
+ *   - `cancelled`            — closure via explicit cancellation
+ *                              (`status='cancelled'`).
+ *   - `completed-unverified` — closure happened but verification was skipped,
+ *                              incomplete, or failed; metrics MUST NOT count
+ *                              these as quality completions without opt-in.
+ *
+ * @task T1408
+ * @epic T1407
+ */
+export declare const ARCHIVE_REASONS: readonly ["verified", "reconciled", "superseded", "shadowed", "cancelled", "completed-unverified"];
+/**
+ * Task relation types matching the DB CHECK constraint on
+ * `task_relations.relation_type`.
+ *
+ *   - `related`     — generic non-blocking association
+ *   - `blocks`      — source MUST complete before target can proceed
+ *   - `duplicates`  — source is a duplicate of target (target is canonical)
+ *   - `absorbs`     — source's work was absorbed into target
+ *   - `fixes`       — source fixes target (bug→fix linkage)
+ *   - `extends`     — source extends or refines target
+ *   - `supersedes`  — source replaces target (target is retired)
+ *   - `groups`      — source groups target (Saga→Epic per ADR-073)
+ *
+ * @task T944
+ * @task ADR-073 (`groups` relation for Saga membership)
+ */
+export declare const TASK_RELATION_TYPES: readonly ["related", "blocks", "duplicates", "absorbs", "fixes", "extends", "supersedes", "groups"];
+//# sourceMappingURL=enums.d.ts.map

package/dist/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,wEAAyE,CAAC;AAEjG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,yCAA0C,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,mCAAoC,CAAC;AAEjE;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,uCAAwC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,eAAe,oGAOlB,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,qGAStB,CAAC"}