@cleocode/contracts 2026.4.85 → 2026.4.86

package/dist/agent-registry-v3.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Agent Registry v3 — Extended registry fields for tier-aware resolution.
+ *
+ * Introduced by T889 / T897 (agent_registry v3 migration). These types layer
+ * on top of the existing `AgentCredential` contract (see `./agent-registry.js`)
+ * to carry tier, spawn capability, orchestration level, and on-disk `.cant`
+ * provenance metadata.
+ *
+ * @see packages/core/migrations/drizzle-signaldock/*_T897_agent_registry_v3.sql
+ * @module agent-registry-v3
+ * @task T897
+ * @epic T889
+ */
+/**
+ * Tier where an agent is installed or resolved from.
+ *
+ * - `project`  — installed in the current project (`.cleo/agents/`)
+ * - `global`   — installed at the user/global scope (`$XDG_DATA_HOME/cleo/agents/`)
+ * - `packaged` — bundled with the CLEO distribution
+ * - `fallback` — synthesized at resolve-time when no concrete `.cant` exists
+ *
+ * @task T897
+ * @epic T889
+ */
+export type AgentTier = 'project' | 'global' | 'packaged' | 'fallback';
+/**
+ * Whether an agent is permitted to spawn other agents and its role in the
+ * orchestration hierarchy.
+ *
+ * - `orchestrator` — top-level coordinator, may spawn leads and workers
+ * - `lead`         — may spawn workers only
+ * - `worker`       — terminal; may not spawn
+ *
+ * @task T897
+ * @epic T889
+ */
+export type AgentSpawnCapability = 'orchestrator' | 'lead' | 'worker';
+/**
+ * Taxonomy for the `agent_skills.source` column, identifying how a skill
+ * binding was derived.
+ *
+ * - `cant`     — parsed from the agent's `.cant` manifest
+ * - `manual`   — attached explicitly by a CLI call
+ * - `computed` — derived by a background indexer (e.g. doctor / index)
+ *
+ * @task T897
+ * @epic T889
+ */
+export type AgentSkillSource = 'cant' | 'manual' | 'computed';
+/**
+ * Extended agent registry row fields added in the T889 / T897 v3 migration.
+ *
+ * These fields live directly on the global `signaldock.db:agents` table and
+ * supplement the pre-existing `AgentCredential` shape with tier-aware
+ * resolution metadata.
+ *
+ * @task T897
+ * @epic T889
+ */
+export interface AgentRegistryExtendedFields {
+    /** Tier where the row was installed / resolved from. */
+    tier: AgentTier;
+    /** `true` when the agent is permitted to spawn subagents. */
+    canSpawn: boolean;
+    /**
+     * Orchestration level (0 = orchestrator, 1 = lead, 2 = worker). Constrained
+     * to the closed interval [0, 2] by the v3 CHECK constraint.
+     */
+    orchLevel: number;
+    /** `agent_id` of the supervising agent, or `null` for top-level agents. */
+    reportsTo: string | null;
+    /** Absolute path to the `.cant` manifest that provisioned this row. */
+    cantPath: string | null;
+    /** SHA-256 checksum of the `.cant` manifest at install time (hex-encoded). */
+    cantSha256: string | null;
+    /** Source of the install record (`seed` = bundled, `user` = CLI attach, `manual` = hand-edited). */
+    installedFrom: 'seed' | 'user' | 'manual' | null;
+    /** ISO 8601 timestamp when the row was installed. */
+    installedAt: string | null;
+}
+/**
+ * Resolved agent record returned from the future `resolveAgent()` lookup.
+ *
+ * Aggregates tier-ranked registry state with the merged skill list and an
+ * optional alias record. Returned as an LAFS-compatible envelope so callers
+ * can inline the record in `data` without further shaping.
+ *
+ * @task T897
+ * @epic T889
+ */
+export interface ResolvedAgent {
+    /** Agent business identifier (matches `agents.agent_id`). */
+    agentId: string;
+    /** Tier the resolved row was sourced from. */
+    tier: AgentTier;
+    /** Absolute path to the resolved `.cant` manifest. */
+    cantPath: string;
+    /** SHA-256 checksum of the resolved `.cant` manifest (hex-encoded). */
+    cantSha256: string;
+    /** `true` when the agent may spawn subagents. */
+    canSpawn: boolean;
+    /** Orchestration level (0..2). */
+    orchLevel: number;
+    /** `agent_id` of the supervising agent, or `null`. */
+    reportsTo: string | null;
+    /** Merged skill slugs (union of catalog bindings and `.cant`-declared skills). */
+    skills: string[];
+    /** Concrete source tier of the chosen row (mirrors `tier`). */
+    source: 'project' | 'global' | 'packaged' | 'fallback';
+    /** `true` when an alias redirected the lookup to another agentId. */
+    aliasApplied: boolean;
+    /** When `aliasApplied` is true, the terminal canonical agentId the alias pointed at. */
+    aliasTarget?: string;
+}
+/**
+ * Stable diagnostic codes emitted by the `cleo agent doctor` walk. Codes are
+ * frozen for the lifetime of the v3 schema; new checks MUST claim a fresh
+ * code rather than reusing a retired one.
+ *
+ * @task T897
+ * @epic T889
+ */
+export type AgentDoctorCode = 'D-001' | 'D-002' | 'D-003' | 'D-004' | 'D-005' | 'D-006' | 'D-007' | 'D-008' | 'D-009' | 'D-010';
+/**
+ * Single finding produced by the agent doctor. A `fixCommand` is populated
+ * when the diagnostic is auto-remediable.
+ *
+ * @task T897
+ * @epic T889
+ */
+export interface AgentDoctorFinding {
+    /** Stable diagnostic code (see `AgentDoctorCode`). */
+    code: AgentDoctorCode;
+    /** Severity classification. */
+    severity: 'error' | 'warn' | 'info';
+    /** Entity under inspection (usually an `agent_id` or `.cant` path). */
+    subject: string;
+    /** Human-readable description of the finding. */
+    message: string;
+    /** Optional `cleo` command that will repair the finding when applied. */
+    fixCommand?: string;
+}
+/**
+ * Aggregate doctor report envelope. `summary` tallies findings by severity
+ * for quick triage.
+ *
+ * @task T897
+ * @epic T889
+ */
+export interface DoctorReport {
+    /** Ordered findings, first-detected-first. */
+    findings: AgentDoctorFinding[];
+    /** Severity histogram. */
+    summary: {
+        error: number;
+        warn: number;
+        info: number;
+    };
+    /** ISO 8601 timestamp when the report was generated. */
+    generatedAt: string;
+}
+//# sourceMappingURL=agent-registry-v3.d.ts.map

package/dist/agent-registry-v3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry-v3.d.ts","sourceRoot":"","sources":["../src/agent-registry-v3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAM9D;;;;;;;;;GASG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oGAAoG;IACpG,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IACjD,qDAAqD;IACrD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,IAAI,EAAE,SAAS,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kFAAkF;IAClF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+DAA+D;IAC/D,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IACvD,qEAAqE;IACrE,YAAY,EAAE,OAAO,CAAC;IACtB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,IAAI,EAAE,eAAe,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,0BAA0B;IAC1B,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/agent-registry-v3.js

@@ -0,0 +1,15 @@
+/**
+ * Agent Registry v3 — Extended registry fields for tier-aware resolution.
+ *
+ * Introduced by T889 / T897 (agent_registry v3 migration). These types layer
+ * on top of the existing `AgentCredential` contract (see `./agent-registry.js`)
+ * to carry tier, spawn capability, orchestration level, and on-disk `.cant`
+ * provenance metadata.
+ *
+ * @see packages/core/migrations/drizzle-signaldock/*_T897_agent_registry_v3.sql
+ * @module agent-registry-v3
+ * @task T897
+ * @epic T889
+ */
+export {};
+//# sourceMappingURL=agent-registry-v3.js.map

package/dist/agent-registry-v3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry-v3.js","sourceRoot":"","sources":["../src/agent-registry-v3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/errors.d.ts

@@ -6,6 +6,43 @@
  *
  * @task T5702
  */
+import { ExitCode } from './exit-codes.js';
+/**
+ * Thrown when a non-orchestrator role attempts to spawn another agent,
+ * violating the thin-agent inversion-of-control rule (ORC-012).
+ *
+ * Only orchestrators may spawn subagents. Leads and workers must escalate
+ * via the playbook approval gate defined in T889 Orchestration Coherence v3.
+ *
+ * @remarks
+ * Emitted by the spawn-guard middleware when an agent's declared role does
+ * not satisfy the orchestrator precondition. Carries `exitCode` aligned with
+ * {@link ExitCode.THIN_AGENT_VIOLATION} so the CLI can surface exit 68 to
+ * callers without additional mapping.
+ *
+ * @example
+ * ```typescript
+ * throw new ThinAgentViolationError('worker-42', 'lead', 'orchestrate spawn');
+ * ```
+ *
+ * @task T889 Orchestration Coherence v3
+ * @task T907 Thin-agent enforcement
+ */
+export declare class ThinAgentViolationError extends Error {
+    readonly agentId: string;
+    readonly role: string;
+    readonly attemptedAction: string;
+    /** Stable LAFS error code string for envelope emission. */
+    readonly code = "E_THIN_AGENT_VIOLATION";
+    /** Numeric exit code aligned with {@link ExitCode.THIN_AGENT_VIOLATION}. */
+    readonly exitCode: ExitCode;
+    /**
+     * @param agentId - The offending agent's unique identifier.
+     * @param role - The offending agent's declared role (lead, worker, etc.).
+     * @param attemptedAction - The spawn action that was blocked.
+     */
+    constructor(agentId: string, role: string, attemptedAction: string);
+}
 /**
  * Normalize any thrown value into a standardized error object.
  *

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,eAAe,SAAiC,GAC/C,KAAK,CAmBP;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAkB,GAAG,MAAM,CAmBlF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,MAAM,CAU1F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAWvE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAKnF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAEvD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAE9C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAY9B,OAAO,EAAE,MAAM;aACf,IAAI,EAAE,MAAM;aACZ,eAAe,EAAE,MAAM;IAbzC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,4BAA4B;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAiC;IAE5D;;;;OAIG;gBAEe,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM;CAQ1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,eAAe,SAAiC,GAC/C,KAAK,CAmBP;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAkB,GAAG,MAAM,CAmBlF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,MAAM,CAU1F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAWvE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAKnF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAEvD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAE9C"}

package/dist/errors.js

@@ -6,6 +6,50 @@
  *
  * @task T5702
  */
+import { ExitCode } from './exit-codes.js';
+/**
+ * Thrown when a non-orchestrator role attempts to spawn another agent,
+ * violating the thin-agent inversion-of-control rule (ORC-012).
+ *
+ * Only orchestrators may spawn subagents. Leads and workers must escalate
+ * via the playbook approval gate defined in T889 Orchestration Coherence v3.
+ *
+ * @remarks
+ * Emitted by the spawn-guard middleware when an agent's declared role does
+ * not satisfy the orchestrator precondition. Carries `exitCode` aligned with
+ * {@link ExitCode.THIN_AGENT_VIOLATION} so the CLI can surface exit 68 to
+ * callers without additional mapping.
+ *
+ * @example
+ * ```typescript
+ * throw new ThinAgentViolationError('worker-42', 'lead', 'orchestrate spawn');
+ * ```
+ *
+ * @task T889 Orchestration Coherence v3
+ * @task T907 Thin-agent enforcement
+ */
+export class ThinAgentViolationError extends Error {
+    agentId;
+    role;
+    attemptedAction;
+    /** Stable LAFS error code string for envelope emission. */
+    code = 'E_THIN_AGENT_VIOLATION';
+    /** Numeric exit code aligned with {@link ExitCode.THIN_AGENT_VIOLATION}. */
+    exitCode = ExitCode.THIN_AGENT_VIOLATION;
+    /**
+     * @param agentId - The offending agent's unique identifier.
+     * @param role - The offending agent's declared role (lead, worker, etc.).
+     * @param attemptedAction - The spawn action that was blocked.
+     */
+    constructor(agentId, role, attemptedAction) {
+        super(`E_THIN_AGENT_VIOLATION: agent '${agentId}' (role=${role}) attempted '${attemptedAction}'. ` +
+            'Only orchestrators may spawn. Escalate via playbook approval gate.');
+        this.agentId = agentId;
+        this.role = role;
+        this.attemptedAction = attemptedAction;
+        this.name = 'ThinAgentViolationError';
+    }
+}
 /**
  * Normalize any thrown value into a standardized error object.
  *

package/dist/errors.js.map

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

package/dist/exit-codes.d.ts

@@ -61,6 +61,28 @@ export declare enum ExitCode {
     HANDOFF_REQUIRED = 65,
     RESUME_FAILED = 66,
     CONCURRENT_SESSION = 67,
+    /**
+     * E_THIN_AGENT_VIOLATION — A worker or lead agent attempted to spawn another
+     * agent, violating the thin-agent inversion-of-control rule (ORC-012).
+     * Only orchestrators may spawn subagents; non-orchestrator roles must
+     * escalate via the playbook approval gate.
+     *
+     * @task T889 Orchestration Coherence v3
+     * @task T907 Thin-agent enforcement
+     */
+    THIN_AGENT_VIOLATION = 68,
+    /**
+     * E_ATOMICITY_VIOLATION — A worker-role spawn was attempted for a task that
+     * exceeds the atomicity budget (more than {@link MAX_WORKER_FILES} files) or
+     * lacks an explicit file-scope declaration on its acceptance criteria.
+     *
+     * Workers MUST remain atomic (≤ 3 files with declared AC.files). Violations
+     * should be split into child tasks or promoted to a lead role.
+     *
+     * @task T889 Orchestration Coherence v3
+     * @task T894 Atomicity guard (W3-3)
+     */
+    ATOMICITY_VIOLATION = 69,
     NEXUS_NOT_INITIALIZED = 70,
     NEXUS_PROJECT_NOT_FOUND = 71,
     NEXUS_PERMISSION_DENIED = 72,

package/dist/exit-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oBAAY,QAAQ;IAElB,OAAO,IAAI;IAGX,aAAa,IAAI;IACjB,aAAa,IAAI;IACjB,UAAU,IAAI;IACd,SAAS,IAAI;IACb,gBAAgB,IAAI;IACpB,gBAAgB,IAAI;IACpB,YAAY,IAAI;IAChB,YAAY,IAAI;IAGhB,gBAAgB,KAAK;IACrB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,kBAAkB,KAAK;IACvB,eAAe,KAAK;IACpB,YAAY,KAAK;IACjB,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,cAAc,KAAK;IAGnB,iBAAiB,KAAK;IACtB,uBAAuB,KAAK;IAC5B,YAAY,KAAK;IAGjB,cAAc,KAAK;IACnB,iBAAiB,KAAK;IACtB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,iBAAiB,KAAK;IACtB,YAAY,KAAK;IACjB,gBAAgB,KAAK;IACrB,qBAAqB,KAAK;IAC1B,oBAAoB,KAAK;IACzB,cAAc,KAAK;IAGnB,wBAAwB,KAAK;IAC7B,kBAAkB,KAAK;IACvB,YAAY,KAAK;IACjB,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,eAAe,KAAK;IACpB,mBAAmB,KAAK;IACxB,cAAc,KAAK;IAGnB,eAAe,KAAK;IACpB,eAAe,KAAK;IACpB,gBAAgB,KAAK;IACrB,iBAAiB,KAAK;IACtB,aAAa,KAAK;IAGlB,gBAAgB,KAAK;IACrB,sBAAsB,KAAK;IAC3B,sBAAsB,KAAK;IAC3B,uBAAuB,KAAK;IAC5B,mBAAmB,KAAK;IACxB,gBAAgB,KAAK;IACrB,aAAa,KAAK;IAClB,kBAAkB,KAAK;IAGvB,qBAAqB,KAAK;IAC1B,uBAAuB,KAAK;IAC5B,uBAAuB,KAAK;IAC5B,oBAAoB,KAAK;IACzB,iBAAiB,KAAK;IACtB,sBAAsB,KAAK;IAC3B,oBAAoB,KAAK;IACzB,kBAAkB,KAAK;IACvB,iBAAiB,KAAK;IACtB,cAAc,KAAK;IAGnB,qBAAqB,KAAK;IAC1B,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,4BAA4B,KAAK;IACjC,mBAAmB,KAAK;IAGxB,qBAAqB,KAAK;IAC1B,0BAA0B,KAAK;IAC/B,qBAAqB,KAAK;IAC1B,uBAAuB,KAAK;IAC5B,wBAAwB,KAAK;IAG7B,yBAAyB,KAAK;IAC9B,mBAAmB,KAAK;IACxB,iBAAiB,KAAK;IACtB,eAAe,KAAK;IACpB,mBAAmB,KAAK;IAGxB,iBAAiB,KAAK;IACtB,mBAAmB,KAAK;IACxB,mBAAmB,KAAK;IACxB,oBAAoB,KAAK;IACzB,sBAAsB,KAAK;IAG3B,OAAO,MAAM;IACb,cAAc,MAAM;IACpB,SAAS,MAAM;IACf,aAAa,MAAM;IAGnB;;;;;;;OAOG;IACH,cAAc,MAAM;CACrB;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEnD;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErD;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CA0BzD;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oBAAY,QAAQ;IAElB,OAAO,IAAI;IAGX,aAAa,IAAI;IACjB,aAAa,IAAI;IACjB,UAAU,IAAI;IACd,SAAS,IAAI;IACb,gBAAgB,IAAI;IACpB,gBAAgB,IAAI;IACpB,YAAY,IAAI;IAChB,YAAY,IAAI;IAGhB,gBAAgB,KAAK;IACrB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,kBAAkB,KAAK;IACvB,eAAe,KAAK;IACpB,YAAY,KAAK;IACjB,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,cAAc,KAAK;IAGnB,iBAAiB,KAAK;IACtB,uBAAuB,KAAK;IAC5B,YAAY,KAAK;IAGjB,cAAc,KAAK;IACnB,iBAAiB,KAAK;IACtB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,iBAAiB,KAAK;IACtB,YAAY,KAAK;IACjB,gBAAgB,KAAK;IACrB,qBAAqB,KAAK;IAC1B,oBAAoB,KAAK;IACzB,cAAc,KAAK;IAGnB,wBAAwB,KAAK;IAC7B,kBAAkB,KAAK;IACvB,YAAY,KAAK;IACjB,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,eAAe,KAAK;IACpB,mBAAmB,KAAK;IACxB,cAAc,KAAK;IAGnB,eAAe,KAAK;IACpB,eAAe,KAAK;IACpB,gBAAgB,KAAK;IACrB,iBAAiB,KAAK;IACtB,aAAa,KAAK;IAGlB,gBAAgB,KAAK;IACrB,sBAAsB,KAAK;IAC3B,sBAAsB,KAAK;IAC3B,uBAAuB,KAAK;IAC5B,mBAAmB,KAAK;IACxB,gBAAgB,KAAK;IACrB,aAAa,KAAK;IAClB,kBAAkB,KAAK;IACvB;;;;;;;;OAQG;IACH,oBAAoB,KAAK;IAEzB;;;;;;;;;;OAUG;IACH,mBAAmB,KAAK;IAGxB,qBAAqB,KAAK;IAC1B,uBAAuB,KAAK;IAC5B,uBAAuB,KAAK;IAC5B,oBAAoB,KAAK;IACzB,iBAAiB,KAAK;IACtB,sBAAsB,KAAK;IAC3B,oBAAoB,KAAK;IACzB,kBAAkB,KAAK;IACvB,iBAAiB,KAAK;IACtB,cAAc,KAAK;IAGnB,qBAAqB,KAAK;IAC1B,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,4BAA4B,KAAK;IACjC,mBAAmB,KAAK;IAGxB,qBAAqB,KAAK;IAC1B,0BAA0B,KAAK;IAC/B,qBAAqB,KAAK;IAC1B,uBAAuB,KAAK;IAC5B,wBAAwB,KAAK;IAG7B,yBAAyB,KAAK;IAC9B,mBAAmB,KAAK;IACxB,iBAAiB,KAAK;IACtB,eAAe,KAAK;IACpB,mBAAmB,KAAK;IAGxB,iBAAiB,KAAK;IACtB,mBAAmB,KAAK;IACxB,mBAAmB,KAAK;IACxB,oBAAoB,KAAK;IACzB,sBAAsB,KAAK;IAG3B,OAAO,MAAM;IACb,cAAc,MAAM;IACpB,SAAS,MAAM;IACf,aAAa,MAAM;IAGnB;;;;;;;OAOG;IACH,cAAc,MAAM;CACrB;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEnD;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErD;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CA0BzD;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEtD"}

package/dist/exit-codes.js

@@ -61,7 +61,7 @@ export var ExitCode;
     ExitCode[ExitCode["CONTEXT_CRITICAL"] = 52] = "CONTEXT_CRITICAL";
     ExitCode[ExitCode["CONTEXT_EMERGENCY"] = 53] = "CONTEXT_EMERGENCY";
     ExitCode[ExitCode["CONTEXT_STALE"] = 54] = "CONTEXT_STALE";
-    // === ORCHESTRATOR ERRORS (60-67) ===
+    // === ORCHESTRATOR ERRORS (60-68) ===
     ExitCode[ExitCode["PROTOCOL_MISSING"] = 60] = "PROTOCOL_MISSING";
     ExitCode[ExitCode["INVALID_RETURN_MESSAGE"] = 61] = "INVALID_RETURN_MESSAGE";
     ExitCode[ExitCode["MANIFEST_ENTRY_MISSING"] = 62] = "MANIFEST_ENTRY_MISSING";
@@ -70,6 +70,28 @@ export var ExitCode;
     ExitCode[ExitCode["HANDOFF_REQUIRED"] = 65] = "HANDOFF_REQUIRED";
     ExitCode[ExitCode["RESUME_FAILED"] = 66] = "RESUME_FAILED";
     ExitCode[ExitCode["CONCURRENT_SESSION"] = 67] = "CONCURRENT_SESSION";
+    /**
+     * E_THIN_AGENT_VIOLATION — A worker or lead agent attempted to spawn another
+     * agent, violating the thin-agent inversion-of-control rule (ORC-012).
+     * Only orchestrators may spawn subagents; non-orchestrator roles must
+     * escalate via the playbook approval gate.
+     *
+     * @task T889 Orchestration Coherence v3
+     * @task T907 Thin-agent enforcement
+     */
+    ExitCode[ExitCode["THIN_AGENT_VIOLATION"] = 68] = "THIN_AGENT_VIOLATION";
+    /**
+     * E_ATOMICITY_VIOLATION — A worker-role spawn was attempted for a task that
+     * exceeds the atomicity budget (more than {@link MAX_WORKER_FILES} files) or
+     * lacks an explicit file-scope declaration on its acceptance criteria.
+     *
+     * Workers MUST remain atomic (≤ 3 files with declared AC.files). Violations
+     * should be split into child tasks or promoted to a lead role.
+     *
+     * @task T889 Orchestration Coherence v3
+     * @task T894 Atomicity guard (W3-3)
+     */
+    ExitCode[ExitCode["ATOMICITY_VIOLATION"] = 69] = "ATOMICITY_VIOLATION";
     // === NEXUS ERRORS (70-79) ===
     ExitCode[ExitCode["NEXUS_NOT_INITIALIZED"] = 70] = "NEXUS_NOT_INITIALIZED";
     ExitCode[ExitCode["NEXUS_PROJECT_NOT_FOUND"] = 71] = "NEXUS_PROJECT_NOT_FOUND";

package/dist/exit-codes.js.map

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

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export type { AcceptanceArrayInput, AcceptanceGateResultInput, AcceptanceGateSch
 export { acceptanceArraySchema, acceptanceGateResultSchema, acceptanceGateSchema, acceptanceItemSchema, commandGateSchema, fileAssertionSchema, fileGateSchema, gateBaseSchema, gateResultDetailsSchema, httpGateSchema, lintGateSchema, manualGateSchema, testGateSchema, } from './acceptance-gate-schema.js';
 export type { AdapterHealthStatus, CLEOProviderAdapter } from './adapter.js';
 export type { AgentCredential, AgentListFilter, AgentRegistryAPI, AgentWithProjectOverride, ProjectAgentRef, TransportConfig, } from './agent-registry.js';
+export type { AgentDoctorCode, AgentDoctorFinding, AgentRegistryExtendedFields, AgentSkillSource, AgentSpawnCapability, AgentTier, DoctorReport, ResolvedAgent, } from './agent-registry-v3.js';
 export type { ArchiveCycleTimesReport, ArchiveDailyTrend, ArchivedTask, ArchiveLabelEntry, ArchiveMetadata, ArchiveMonthlyTrend, ArchivePhaseEntry, ArchivePriorityEntry, ArchiveReportType, ArchiveStatsEnvelope, ArchiveSummaryReport, ArchiveTrendsReport, CycleTimeDistribution, CycleTimePercentiles, } from './archive.js';
 export type { Attachment, AttachmentKind, AttachmentMetadata, AttachmentRef, BlobAttachment, LlmsTxtAttachment, LlmtxtDocAttachment, LocalFileAttachment, UrlAttachment, } from './attachment.js';
 export type { AttachmentMetadataSchemaInput, AttachmentRefSchemaInput, AttachmentSchemaInput, } from './attachment-schema.js';
@@ -24,7 +25,7 @@ export type { AdapterContextMonitorProvider } from './context-monitor.js';
 export type { ArchiveFields, ArchiveFile, DataAccessor, DataAccessorAgentInstance, QueryTasksResult, TaskFieldUpdates, TaskQueryFilters, TransactionAccessor, } from './data-accessor.js';
 export type { DependencyCategory, DependencyCheckResult, DependencyReport, DependencySpec, } from './dependency.js';
 export type { AdapterManifest, DetectionPattern } from './discovery.js';
-export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, } from './errors.js';
+export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, ThinAgentViolationError, } from './errors.js';
 export type { CommandOutputRecord, EvidenceRecord, EvidenceRecordKind, ImplDiffRecord, LintReportRecord, TestOutputRecord, ValidateSpecCheckRecord, } from './evidence-record.js';
 export type { CommandOutputRecordInput, EvidenceRecordInput, ImplDiffRecordInput, LintReportRecordInput, TestOutputRecordInput, ValidateSpecCheckRecordInput, } from './evidence-record-schema.js';
 export { commandOutputRecordSchema, evidenceRecordSchema, implDiffRecordSchema, lintReportRecordSchema, testOutputRecordSchema, validateSpecCheckRecordSchema, } from './evidence-record-schema.js';
@@ -42,6 +43,7 @@ export type { BrainState } from './operations/orchestrate.js';
 export type { CittyArgDef, OperationParams, ParamCliDef, ParamDef, ParamType, } from './operations/params.js';
 export { paramsToCittyArgs } from './operations/params.js';
 export { type AgentHierarchy, type AgentHierarchyEntry, type EscalationChain, type OrchestrationHierarchyAPI, OrchestrationLevel, } from './orchestration-hierarchy.js';
+export type { PlaybookAgenticNode, PlaybookApproval, PlaybookApprovalNode, PlaybookApprovalStatus, PlaybookDefinition, PlaybookDeterministicNode, PlaybookEdge, PlaybookEnsures, PlaybookErrorHandler, PlaybookInput, PlaybookNode, PlaybookNodeBase, PlaybookNodeOnFailure, PlaybookNodeType, PlaybookPolicy, PlaybookRequires, PlaybookRun, PlaybookRunStatus, } from './playbook.js';
 export type { AdapterPathProvider } from './provider-paths.js';
 export type { BottleneckTask, CompleteTaskUnblocked, ContextResult, DashboardResult, LabelCount, LeveragedTask, LogQueryResult, SequenceResult, StatsActivityMetrics, StatsAllTime, StatsCompletionMetrics, StatsCurrentState, StatsCycleTimes, StatsResult, TaskAnalysisResult, TaskDepsResult, TaskRef, TaskRefPriority, TaskSummary, } from './results.js';
 export type { Session, SessionScope, SessionStartResult, SessionStats, SessionTaskWork, } from './session.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -9,7 +9,7 @@
 export { acceptanceArraySchema, acceptanceGateResultSchema, acceptanceGateSchema, acceptanceItemSchema, commandGateSchema, fileAssertionSchema, fileGateSchema, gateBaseSchema, gateResultDetailsSchema, httpGateSchema, lintGateSchema, manualGateSchema, testGateSchema, } from './acceptance-gate-schema.js';
 export { attachmentMetadataSchema, attachmentRefSchema, attachmentSchema, blobAttachmentSchema, llmsTxtAttachmentSchema, llmtxtDocAttachmentSchema, localFileAttachmentSchema, urlAttachmentSchema, } from './attachment-schema.js';
 // === Error Utilities ===
-export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, } from './errors.js';
+export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, ThinAgentViolationError, } from './errors.js';
 // === Evidence Record Zod Schemas (runtime validation) ===
 export { commandOutputRecordSchema, evidenceRecordSchema, implDiffRecordSchema, lintReportRecordSchema, testOutputRecordSchema, validateSpecCheckRecordSchema, } from './evidence-record-schema.js';
 // === Exit Codes ===

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,2DAA2D;AAC3D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AA+CrC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AA2FhC,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAmBrB,2DAA2D;AAC3D,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AACrC,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAuCrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAW7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAgCtC,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA0C9B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAiD5B,yCAAyC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,2DAA2D;AAC3D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AA0DrC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AA2FhC,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAmBrB,2DAA2D;AAC3D,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AACrC,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAuCrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAW7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAqDtC,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA0C9B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAiD5B,yCAAyC"}

package/dist/playbook.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Playbook DSL types — shared between parser, runtime, and CLI.
+ * Aligns with CLEO `.cantbook` YAML schema.
+ *
+ * @task T889 / T904 / W4-6
+ */
+export type PlaybookNodeType = 'agentic' | 'deterministic' | 'approval';
+export type PlaybookRunStatus = 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+export type PlaybookApprovalStatus = 'pending' | 'approved' | 'rejected';
+export type PlaybookPolicy = 'conservative' | 'permissive' | 'custom';
+export interface PlaybookInput {
+    name: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+}
+export interface PlaybookEnsures {
+    outputFiles?: string[];
+    exitCode?: number;
+    schema?: string;
+}
+export interface PlaybookRequires {
+    from?: string;
+    fields?: string[];
+    schema?: string;
+}
+export interface PlaybookNodeOnFailure {
+    inject_into?: string;
+    max_iterations?: number;
+    escalate?: boolean;
+}
+export interface PlaybookNodeBase {
+    id: string;
+    type: PlaybookNodeType;
+    description?: string;
+    depends?: string[];
+    requires?: PlaybookRequires;
+    ensures?: PlaybookEnsures;
+    on_failure?: PlaybookNodeOnFailure;
+}
+export interface PlaybookAgenticNode extends PlaybookNodeBase {
+    type: 'agentic';
+    skill?: string;
+    agent?: string;
+    role?: 'orchestrator' | 'lead' | 'worker';
+    inputs?: Record<string, string>;
+}
+export interface PlaybookDeterministicNode extends PlaybookNodeBase {
+    type: 'deterministic';
+    command: string;
+    args: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    timeout_ms?: number;
+}
+export interface PlaybookApprovalNode extends PlaybookNodeBase {
+    type: 'approval';
+    prompt: string;
+    policy?: PlaybookPolicy;
+}
+export type PlaybookNode = PlaybookAgenticNode | PlaybookDeterministicNode | PlaybookApprovalNode;
+export interface PlaybookEdge {
+    from: string;
+    to: string;
+    contract?: {
+        requires?: string[];
+        ensures?: string[];
+    };
+}
+export interface PlaybookErrorHandler {
+    on: 'agentic_timeout' | 'iteration_cap_exceeded' | 'contract_violation';
+    action: 'inject_hint' | 'hitl_escalate' | 'abort';
+    message?: string;
+}
+export interface PlaybookDefinition {
+    version: string;
+    name: string;
+    description?: string;
+    inputs?: PlaybookInput[];
+    nodes: PlaybookNode[];
+    edges: PlaybookEdge[];
+    error_handlers?: PlaybookErrorHandler[];
+}
+export interface PlaybookRun {
+    runId: string;
+    playbookName: string;
+    playbookHash: string;
+    currentNode: string | null;
+    bindings: Record<string, unknown>;
+    errorContext: string | null;
+    status: PlaybookRunStatus;
+    iterationCounts: Record<string, number>;
+    epicId?: string;
+    sessionId?: string;
+    startedAt: string;
+    completedAt?: string;
+}
+export interface PlaybookApproval {
+    approvalId: string;
+    runId: string;
+    nodeId: string;
+    token: string;
+    requestedAt: string;
+    approvedAt?: string;
+    approver?: string;
+    reason?: string;
+    status: PlaybookApprovalStatus;
+    autoPassed: boolean;
+}
+//# sourceMappingURL=playbook.d.ts.map

package/dist/playbook.d.ts.map

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

package/dist/playbook.js

@@ -0,0 +1,8 @@
+/**
+ * Playbook DSL types — shared between parser, runtime, and CLI.
+ * Aligns with CLEO `.cantbook` YAML schema.
+ *
+ * @task T889 / T904 / W4-6
+ */
+export {};
+//# sourceMappingURL=playbook.js.map

package/dist/playbook.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.4.85",
+  "version": "2026.4.86",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/agent-registry-v3.ts

@@ -0,0 +1,187 @@
+/**
+ * Agent Registry v3 — Extended registry fields for tier-aware resolution.
+ *
+ * Introduced by T889 / T897 (agent_registry v3 migration). These types layer
+ * on top of the existing `AgentCredential` contract (see `./agent-registry.js`)
+ * to carry tier, spawn capability, orchestration level, and on-disk `.cant`
+ * provenance metadata.
+ *
+ * @see packages/core/migrations/drizzle-signaldock/*_T897_agent_registry_v3.sql
+ * @module agent-registry-v3
+ * @task T897
+ * @epic T889
+ */
+
+// ============================================================================
+// Tier / capability taxonomies
+// ============================================================================
+
+/**
+ * Tier where an agent is installed or resolved from.
+ *
+ * - `project`  — installed in the current project (`.cleo/agents/`)
+ * - `global`   — installed at the user/global scope (`$XDG_DATA_HOME/cleo/agents/`)
+ * - `packaged` — bundled with the CLEO distribution
+ * - `fallback` — synthesized at resolve-time when no concrete `.cant` exists
+ *
+ * @task T897
+ * @epic T889
+ */
+export type AgentTier = 'project' | 'global' | 'packaged' | 'fallback';
+
+/**
+ * Whether an agent is permitted to spawn other agents and its role in the
+ * orchestration hierarchy.
+ *
+ * - `orchestrator` — top-level coordinator, may spawn leads and workers
+ * - `lead`         — may spawn workers only
+ * - `worker`       — terminal; may not spawn
+ *
+ * @task T897
+ * @epic T889
+ */
+export type AgentSpawnCapability = 'orchestrator' | 'lead' | 'worker';
+
+/**
+ * Taxonomy for the `agent_skills.source` column, identifying how a skill
+ * binding was derived.
+ *
+ * - `cant`     — parsed from the agent's `.cant` manifest
+ * - `manual`   — attached explicitly by a CLI call
+ * - `computed` — derived by a background indexer (e.g. doctor / index)
+ *
+ * @task T897
+ * @epic T889
+ */
+export type AgentSkillSource = 'cant' | 'manual' | 'computed';
+
+// ============================================================================
+// Extended row / resolved envelopes
+// ============================================================================
+
+/**
+ * Extended agent registry row fields added in the T889 / T897 v3 migration.
+ *
+ * These fields live directly on the global `signaldock.db:agents` table and
+ * supplement the pre-existing `AgentCredential` shape with tier-aware
+ * resolution metadata.
+ *
+ * @task T897
+ * @epic T889
+ */
+export interface AgentRegistryExtendedFields {
+  /** Tier where the row was installed / resolved from. */
+  tier: AgentTier;
+  /** `true` when the agent is permitted to spawn subagents. */
+  canSpawn: boolean;
+  /**
+   * Orchestration level (0 = orchestrator, 1 = lead, 2 = worker). Constrained
+   * to the closed interval [0, 2] by the v3 CHECK constraint.
+   */
+  orchLevel: number;
+  /** `agent_id` of the supervising agent, or `null` for top-level agents. */
+  reportsTo: string | null;
+  /** Absolute path to the `.cant` manifest that provisioned this row. */
+  cantPath: string | null;
+  /** SHA-256 checksum of the `.cant` manifest at install time (hex-encoded). */
+  cantSha256: string | null;
+  /** Source of the install record (`seed` = bundled, `user` = CLI attach, `manual` = hand-edited). */
+  installedFrom: 'seed' | 'user' | 'manual' | null;
+  /** ISO 8601 timestamp when the row was installed. */
+  installedAt: string | null;
+}
+
+/**
+ * Resolved agent record returned from the future `resolveAgent()` lookup.
+ *
+ * Aggregates tier-ranked registry state with the merged skill list and an
+ * optional alias record. Returned as an LAFS-compatible envelope so callers
+ * can inline the record in `data` without further shaping.
+ *
+ * @task T897
+ * @epic T889
+ */
+export interface ResolvedAgent {
+  /** Agent business identifier (matches `agents.agent_id`). */
+  agentId: string;
+  /** Tier the resolved row was sourced from. */
+  tier: AgentTier;
+  /** Absolute path to the resolved `.cant` manifest. */
+  cantPath: string;
+  /** SHA-256 checksum of the resolved `.cant` manifest (hex-encoded). */
+  cantSha256: string;
+  /** `true` when the agent may spawn subagents. */
+  canSpawn: boolean;
+  /** Orchestration level (0..2). */
+  orchLevel: number;
+  /** `agent_id` of the supervising agent, or `null`. */
+  reportsTo: string | null;
+  /** Merged skill slugs (union of catalog bindings and `.cant`-declared skills). */
+  skills: string[];
+  /** Concrete source tier of the chosen row (mirrors `tier`). */
+  source: 'project' | 'global' | 'packaged' | 'fallback';
+  /** `true` when an alias redirected the lookup to another agentId. */
+  aliasApplied: boolean;
+  /** When `aliasApplied` is true, the terminal canonical agentId the alias pointed at. */
+  aliasTarget?: string;
+}
+
+// ============================================================================
+// Doctor diagnostic contracts
+// ============================================================================
+
+/**
+ * Stable diagnostic codes emitted by the `cleo agent doctor` walk. Codes are
+ * frozen for the lifetime of the v3 schema; new checks MUST claim a fresh
+ * code rather than reusing a retired one.
+ *
+ * @task T897
+ * @epic T889
+ */
+export type AgentDoctorCode =
+  | 'D-001'
+  | 'D-002'
+  | 'D-003'
+  | 'D-004'
+  | 'D-005'
+  | 'D-006'
+  | 'D-007'
+  | 'D-008'
+  | 'D-009'
+  | 'D-010';
+
+/**
+ * Single finding produced by the agent doctor. A `fixCommand` is populated
+ * when the diagnostic is auto-remediable.
+ *
+ * @task T897
+ * @epic T889
+ */
+export interface AgentDoctorFinding {
+  /** Stable diagnostic code (see `AgentDoctorCode`). */
+  code: AgentDoctorCode;
+  /** Severity classification. */
+  severity: 'error' | 'warn' | 'info';
+  /** Entity under inspection (usually an `agent_id` or `.cant` path). */
+  subject: string;
+  /** Human-readable description of the finding. */
+  message: string;
+  /** Optional `cleo` command that will repair the finding when applied. */
+  fixCommand?: string;
+}
+
+/**
+ * Aggregate doctor report envelope. `summary` tallies findings by severity
+ * for quick triage.
+ *
+ * @task T897
+ * @epic T889
+ */
+export interface DoctorReport {
+  /** Ordered findings, first-detected-first. */
+  findings: AgentDoctorFinding[];
+  /** Severity histogram. */
+  summary: { error: number; warn: number; info: number };
+  /** ISO 8601 timestamp when the report was generated. */
+  generatedAt: string;
+}

package/src/errors.ts

@@ -7,6 +7,53 @@
  * @task T5702
  */
 
+import { ExitCode } from './exit-codes.js';
+
+/**
+ * Thrown when a non-orchestrator role attempts to spawn another agent,
+ * violating the thin-agent inversion-of-control rule (ORC-012).
+ *
+ * Only orchestrators may spawn subagents. Leads and workers must escalate
+ * via the playbook approval gate defined in T889 Orchestration Coherence v3.
+ *
+ * @remarks
+ * Emitted by the spawn-guard middleware when an agent's declared role does
+ * not satisfy the orchestrator precondition. Carries `exitCode` aligned with
+ * {@link ExitCode.THIN_AGENT_VIOLATION} so the CLI can surface exit 68 to
+ * callers without additional mapping.
+ *
+ * @example
+ * ```typescript
+ * throw new ThinAgentViolationError('worker-42', 'lead', 'orchestrate spawn');
+ * ```
+ *
+ * @task T889 Orchestration Coherence v3
+ * @task T907 Thin-agent enforcement
+ */
+export class ThinAgentViolationError extends Error {
+  /** Stable LAFS error code string for envelope emission. */
+  readonly code = 'E_THIN_AGENT_VIOLATION';
+  /** Numeric exit code aligned with {@link ExitCode.THIN_AGENT_VIOLATION}. */
+  readonly exitCode: ExitCode = ExitCode.THIN_AGENT_VIOLATION;
+
+  /**
+   * @param agentId - The offending agent's unique identifier.
+   * @param role - The offending agent's declared role (lead, worker, etc.).
+   * @param attemptedAction - The spawn action that was blocked.
+   */
+  constructor(
+    public readonly agentId: string,
+    public readonly role: string,
+    public readonly attemptedAction: string,
+  ) {
+    super(
+      `E_THIN_AGENT_VIOLATION: agent '${agentId}' (role=${role}) attempted '${attemptedAction}'. ` +
+        'Only orchestrators may spawn. Escalate via playbook approval gate.',
+    );
+    this.name = 'ThinAgentViolationError';
+  }
+}
+
 /**
  * Normalize any thrown value into a standardized error object.
  *

package/src/exit-codes.ts

@@ -68,7 +68,7 @@ export enum ExitCode {
   CONTEXT_EMERGENCY = 53,
   CONTEXT_STALE = 54,
 
-  // === ORCHESTRATOR ERRORS (60-67) ===
+  // === ORCHESTRATOR ERRORS (60-68) ===
   PROTOCOL_MISSING = 60,
   INVALID_RETURN_MESSAGE = 61,
   MANIFEST_ENTRY_MISSING = 62,
@@ -77,6 +77,29 @@ export enum ExitCode {
   HANDOFF_REQUIRED = 65,
   RESUME_FAILED = 66,
   CONCURRENT_SESSION = 67,
+  /**
+   * E_THIN_AGENT_VIOLATION — A worker or lead agent attempted to spawn another
+   * agent, violating the thin-agent inversion-of-control rule (ORC-012).
+   * Only orchestrators may spawn subagents; non-orchestrator roles must
+   * escalate via the playbook approval gate.
+   *
+   * @task T889 Orchestration Coherence v3
+   * @task T907 Thin-agent enforcement
+   */
+  THIN_AGENT_VIOLATION = 68,
+
+  /**
+   * E_ATOMICITY_VIOLATION — A worker-role spawn was attempted for a task that
+   * exceeds the atomicity budget (more than {@link MAX_WORKER_FILES} files) or
+   * lacks an explicit file-scope declaration on its acceptance criteria.
+   *
+   * Workers MUST remain atomic (≤ 3 files with declared AC.files). Violations
+   * should be split into child tasks or promoted to a lead role.
+   *
+   * @task T889 Orchestration Coherence v3
+   * @task T894 Atomicity guard (W3-3)
+   */
+  ATOMICITY_VIOLATION = 69,
 
   // === NEXUS ERRORS (70-79) ===
   NEXUS_NOT_INITIALIZED = 70,

package/src/index.ts

@@ -56,6 +56,17 @@ export type {
   ProjectAgentRef,
   TransportConfig,
 } from './agent-registry.js';
+// === Agent Registry v3 (T889 / T897 — tier-aware resolution extensions) ===
+export type {
+  AgentDoctorCode,
+  AgentDoctorFinding,
+  AgentRegistryExtendedFields,
+  AgentSkillSource,
+  AgentSpawnCapability,
+  AgentTier,
+  DoctorReport,
+  ResolvedAgent,
+} from './agent-registry-v3.js';
 // === Archive Types ===
 export type {
   ArchiveCycleTimesReport,
@@ -200,6 +211,7 @@ export {
   isErrorResult,
   isErrorType,
   normalizeError,
+  ThinAgentViolationError,
 } from './errors.js';
 // === Evidence Record Types (IVTR typed proof artifacts) ===
 export type {
@@ -347,6 +359,27 @@ export {
   type OrchestrationHierarchyAPI,
   OrchestrationLevel,
 } from './orchestration-hierarchy.js';
+// === Playbook DSL Types (T889 / T904 / W4-6) ===
+export type {
+  PlaybookAgenticNode,
+  PlaybookApproval,
+  PlaybookApprovalNode,
+  PlaybookApprovalStatus,
+  PlaybookDefinition,
+  PlaybookDeterministicNode,
+  PlaybookEdge,
+  PlaybookEnsures,
+  PlaybookErrorHandler,
+  PlaybookInput,
+  PlaybookNode,
+  PlaybookNodeBase,
+  PlaybookNodeOnFailure,
+  PlaybookNodeType,
+  PlaybookPolicy,
+  PlaybookRequires,
+  PlaybookRun,
+  PlaybookRunStatus,
+} from './playbook.js';
 export type { AdapterPathProvider } from './provider-paths.js';
 // === Result Types (Dashboard, Stats, Log, Context, Sequence, Analysis, Deps) ===
 export type {

package/src/playbook.ts

@@ -0,0 +1,124 @@
+/**
+ * Playbook DSL types — shared between parser, runtime, and CLI.
+ * Aligns with CLEO `.cantbook` YAML schema.
+ *
+ * @task T889 / T904 / W4-6
+ */
+
+export type PlaybookNodeType = 'agentic' | 'deterministic' | 'approval';
+export type PlaybookRunStatus = 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+export type PlaybookApprovalStatus = 'pending' | 'approved' | 'rejected';
+export type PlaybookPolicy = 'conservative' | 'permissive' | 'custom';
+
+export interface PlaybookInput {
+  name: string;
+  required?: boolean;
+  default?: unknown;
+  description?: string;
+}
+
+export interface PlaybookEnsures {
+  outputFiles?: string[];
+  exitCode?: number;
+  schema?: string;
+}
+
+export interface PlaybookRequires {
+  from?: string;
+  fields?: string[];
+  schema?: string;
+}
+
+export interface PlaybookNodeOnFailure {
+  inject_into?: string;
+  max_iterations?: number;
+  escalate?: boolean;
+}
+
+export interface PlaybookNodeBase {
+  id: string;
+  type: PlaybookNodeType;
+  description?: string;
+  depends?: string[];
+  requires?: PlaybookRequires;
+  ensures?: PlaybookEnsures;
+  on_failure?: PlaybookNodeOnFailure;
+}
+
+export interface PlaybookAgenticNode extends PlaybookNodeBase {
+  type: 'agentic';
+  skill?: string;
+  agent?: string;
+  role?: 'orchestrator' | 'lead' | 'worker';
+  inputs?: Record<string, string>;
+}
+
+export interface PlaybookDeterministicNode extends PlaybookNodeBase {
+  type: 'deterministic';
+  command: string;
+  args: string[];
+  cwd?: string;
+  env?: Record<string, string>;
+  timeout_ms?: number;
+}
+
+export interface PlaybookApprovalNode extends PlaybookNodeBase {
+  type: 'approval';
+  prompt: string;
+  policy?: PlaybookPolicy;
+}
+
+export type PlaybookNode = PlaybookAgenticNode | PlaybookDeterministicNode | PlaybookApprovalNode;
+
+export interface PlaybookEdge {
+  from: string;
+  to: string;
+  contract?: {
+    requires?: string[];
+    ensures?: string[];
+  };
+}
+
+export interface PlaybookErrorHandler {
+  on: 'agentic_timeout' | 'iteration_cap_exceeded' | 'contract_violation';
+  action: 'inject_hint' | 'hitl_escalate' | 'abort';
+  message?: string;
+}
+
+export interface PlaybookDefinition {
+  version: string;
+  name: string;
+  description?: string;
+  inputs?: PlaybookInput[];
+  nodes: PlaybookNode[];
+  edges: PlaybookEdge[];
+  error_handlers?: PlaybookErrorHandler[];
+}
+
+export interface PlaybookRun {
+  runId: string;
+  playbookName: string;
+  playbookHash: string;
+  currentNode: string | null;
+  bindings: Record<string, unknown>;
+  errorContext: string | null;
+  status: PlaybookRunStatus;
+  iterationCounts: Record<string, number>;
+  epicId?: string;
+  sessionId?: string;
+  startedAt: string;
+  completedAt?: string;
+}
+
+export interface PlaybookApproval {
+  approvalId: string;
+  runId: string;
+  nodeId: string;
+  token: string;
+  requestedAt: string;
+  approvedAt?: string;
+  approver?: string;
+  reason?: string;
+  status: PlaybookApprovalStatus;
+  autoPassed: boolean;
+}