@cleocode/contracts 2026.4.114 → 2026.4.115

package/dist/index.d.ts

@@ -53,7 +53,9 @@ export type { CittyArgDef, OperationParams, ParamCliDef, ParamDef, ParamType, }
 export { paramsToCittyArgs } from './operations/params.js';
 export type { DecisionRecord, SessionBriefingShowParams, SessionBriefingShowResult, SessionContextDriftParams, SessionContextDriftResult, SessionDecisionLogParams, SessionDecisionLogResult, SessionEndParams, SessionEndResult, SessionFindParams, SessionFindResult, SessionGcParams, SessionGcResult, SessionHandoffShowParams, SessionHandoffShowResult, SessionListParams, SessionListResult, SessionOps, SessionRecordAssumptionParams, SessionRecordAssumptionResult, SessionRecordDecisionParams, SessionRecordDecisionResult, SessionResumeParams, SessionResumeResult, SessionShowParams, SessionShowResult, SessionStartParams, SessionStatusParams, SessionStatusResult, SessionSuspendParams, SessionSuspendResult, } from './operations/session.js';
 export type { ResolvedVariable, SubstitutionContext, SubstitutionOptions, SubstitutionResult, SubstitutionSource, VariableResolver, } from './operations/variable-substitution.js';
+export type { CreateWorktreeOptions, CreateWorktreeResult, DestroyWorktreeOptions, DestroyWorktreeResult, ListWorktreesOptions, PruneWorktreesOptions, PruneWorktreesResult, WorktreeHook, WorktreeHookResult, WorktreeIncludePattern, WorktreeListEntry, } from './operations/worktree.js';
 export { type AgentHierarchy, type AgentHierarchyEntry, type EscalationChain, type OrchestrationHierarchyAPI, OrchestrationLevel, } from './orchestration-hierarchy.js';
+export { assertPeerIdentity, filterPeerIdentities, isPeerIdentity, type PeerIdentity, type PeerKind, } from './peer.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';

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

@@ -25,6 +25,8 @@ export * as ops from './operations/index.js';
 export { paramsToCittyArgs } from './operations/params.js';
 // === Orchestration Hierarchy ===
 export { OrchestrationLevel, } from './orchestration-hierarchy.js';
+// === Peer Identity (T1210 — SDK-first CANT persona contract) ===
+export { assertPeerIdentity, filterPeerIdentities, isPeerIdentity, } from './peer.js';
 // === Session Types ===
 export { SessionView } from './session.js';
 // === Status Registry (MUST be first — everything depends on this) ===

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;AA0DrC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AA8ChC,iDAAiD;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAwE3D,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,yBAAyB,EACzB,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;AAgCzB,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;AA2EnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAW7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA8C3D,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AA4DtC,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;AA8C9B,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;AA8ChC,iDAAiD;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAwE3D,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,yBAAyB,EACzB,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;AAgCzB,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;AA2EnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAW7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA8D3D,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,kEAAkE;AAClE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GAGf,MAAM,WAAW,CAAC;AA4DnB,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;AA8C9B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAiD5B,yCAAyC"}

package/dist/operations/index.d.ts

@@ -20,4 +20,5 @@ export * from './system.js';
 export * from './tasks.js';
 export * from './validate.js';
 export * from './variable-substitution.js';
+export * from './worktree.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/operations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}

package/dist/operations/index.js

@@ -20,4 +20,5 @@ export * from './system.js';
 export * from './tasks.js';
 export * from './validate.js';
 export * from './variable-substitution.js';
+export * from './worktree.js';
 //# sourceMappingURL=index.js.map

package/dist/operations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}

package/dist/operations/worktree.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Worktree backend SDK operation types (T1161).
+ *
+ * Wire-format types for the `@cleocode/worktree-backend` SDK surface.
+ * Defines the contract for createWorktree, destroyWorktree, listWorktrees,
+ * and pruneWorktrees operations with XDG path canon (D029) and declarative
+ * hooks (D030 native lift of worktrunk missing features).
+ *
+ * @task T1161
+ * @adr ADR-055
+ */
+/**
+ * A declarative lifecycle hook definition for worktree events.
+ *
+ * Hooks are executed synchronously (shell commands) or via node spawns
+ * in the worktree directory. Mirrors the worktrunk hooks contract lifted
+ * natively per D030.
+ *
+ * @task T1161
+ */
+export interface WorktreeHook {
+    /** Shell command to run (executed via `sh -c` in the worktree dir). */
+    command: string;
+    /**
+     * When to run the hook.
+     *
+     * - `post-create` — immediately after `git worktree add` succeeds.
+     * - `post-start`  — after the agent CWD is established (env vars injected).
+     */
+    event: 'post-create' | 'post-start';
+    /**
+     * Optional timeout in milliseconds before the hook is killed.
+     *
+     * @default 30000
+     */
+    timeoutMs?: number;
+    /**
+     * When true, a non-zero exit from this hook causes the worktree operation
+     * to fail. When false (default), errors are logged but ignored.
+     *
+     * @default false
+     */
+    failOnError?: boolean;
+}
+/**
+ * Result of a single hook execution.
+ *
+ * @task T1161
+ */
+export interface WorktreeHookResult {
+    /** The hook that was executed. */
+    hook: WorktreeHook;
+    /** Whether the hook exited with code 0. */
+    success: boolean;
+    /** Hook stdout (trimmed). */
+    stdout: string;
+    /** Hook stderr (trimmed). */
+    stderr: string;
+    /** Exit code (null if killed by timeout). */
+    exitCode: number | null;
+    /** Duration in milliseconds. */
+    durationMs: number;
+}
+/**
+ * A parsed entry from `.cleo/worktree-include`.
+ *
+ * The file lists glob patterns (one per line, `#` comments stripped) that
+ * control which files from the main project tree are symlinked or copied
+ * into new worktrees on creation. This is a native lift of the worktrunk
+ * `.cleo/worktree-include` feature (D030).
+ *
+ * @task T1161
+ */
+export interface WorktreeIncludePattern {
+    /** The raw glob pattern string (e.g. `node_modules/.pnpm/**`). */
+    pattern: string;
+    /**
+     * Whether this entry was negated (prefixed with `!`).
+     *
+     * @default false
+     */
+    negated: boolean;
+}
+/**
+ * Options for creating a new agent worktree.
+ *
+ * @task T1161
+ */
+export interface CreateWorktreeOptions {
+    /** The task ID that will own this worktree. */
+    taskId: string;
+    /** The base ref to branch from (default: current HEAD). */
+    baseRef?: string;
+    /** Explicit branch name. Defaults to `task/<taskId>`. */
+    branchName?: string;
+    /**
+     * Reason for creation. Used for git worktree lock comment and audit logs.
+     *
+     * @default 'subagent'
+     */
+    reason?: 'subagent' | 'experiment' | 'parallel-wave';
+    /** Declarative hooks to run after creation. */
+    hooks?: WorktreeHook[];
+    /**
+     * When true, read `.cleo/worktree-include` from the project root and apply
+     * any declared include patterns to the new worktree.
+     *
+     * @default true
+     */
+    applyIncludePatterns?: boolean;
+    /**
+     * When true, apply git worktree lock (`git worktree lock`) to prevent
+     * accidental pruning by git.
+     *
+     * @default true
+     */
+    lockWorktree?: boolean;
+}
+/**
+ * Result of a successful worktree creation.
+ *
+ * @task T1161
+ */
+export interface CreateWorktreeResult {
+    /**
+     * Absolute path to the created worktree directory.
+     *
+     * Always under `~/.local/share/cleo/worktrees/<projectHash>/<taskId>/`
+     * per D029 canonical layout.
+     */
+    path: string;
+    /** Branch name created for this worktree (format: `task/<taskId>`). */
+    branch: string;
+    /** Base ref the branch was created from. */
+    baseRef: string;
+    /** Task ID that owns this worktree. */
+    taskId: string;
+    /** Project hash scoping this worktree under the XDG root. */
+    projectHash: string;
+    /** ISO 8601 timestamp when the worktree was created. */
+    createdAt: string;
+    /** Whether git worktree lock was applied. */
+    locked: boolean;
+    /** Environment variables to inject into the spawned agent process. */
+    envVars: Record<string, string>;
+    /** Prompt preamble text for agent isolation context. */
+    preamble: string;
+    /** Results of any post-create hooks that were executed. */
+    hookResults: WorktreeHookResult[];
+    /** Include patterns that were applied (empty if none). */
+    appliedPatterns: WorktreeIncludePattern[];
+}
+/**
+ * Options for destroying a worktree.
+ *
+ * @task T1161
+ */
+export interface DestroyWorktreeOptions {
+    /** Task ID whose worktree to destroy. */
+    taskId: string;
+    /**
+     * When true, delete the associated git branch after removing the worktree.
+     *
+     * @default true
+     */
+    deleteBranch?: boolean;
+    /**
+     * When true, cherry-pick any commits on the task branch back to the
+     * orchestrator's current branch before destroying.
+     *
+     * @default false
+     */
+    cherryPickFirst?: boolean;
+}
+/**
+ * Result of a worktree destroy operation.
+ *
+ * @task T1161
+ */
+export interface DestroyWorktreeResult {
+    /** Task ID that was destroyed. */
+    taskId: string;
+    /** Whether the worktree directory was successfully removed. */
+    worktreeRemoved: boolean;
+    /** Whether the task branch was deleted. */
+    branchDeleted: boolean;
+    /** Whether cherry-pick was attempted and succeeded. */
+    cherryPicked: boolean;
+    /** Number of commits cherry-picked (0 if none or not requested). */
+    commitCount: number;
+    /** Error message if any step failed (non-fatal — caller decides). */
+    error?: string;
+}
+/**
+ * A single entry from the worktree listing.
+ *
+ * @task T1161
+ */
+export interface WorktreeListEntry {
+    /** Absolute path to the worktree directory. */
+    path: string;
+    /** Branch checked out in this worktree. */
+    branch: string;
+    /**
+     * Task ID derived from the worktree directory name.
+     *
+     * Convention: the last path segment is the taskId.
+     */
+    taskId: string;
+    /** Project hash derived from the path. */
+    projectHash: string;
+}
+/**
+ * Options for listing worktrees.
+ *
+ * @task T1161
+ */
+export interface ListWorktreesOptions {
+    /** Filter to only return worktrees for a specific project hash. */
+    projectHash?: string;
+}
+/**
+ * Options for pruning orphaned worktrees.
+ *
+ * @task T1161
+ */
+export interface PruneWorktreesOptions {
+    /** Absolute path to the project root (used to resolve the worktree root). */
+    projectRoot: string;
+    /**
+     * Set of task IDs to preserve. Any worktree directory whose name is NOT in
+     * this set will be pruned.
+     *
+     * When omitted, only stale git administrative entries are pruned (via
+     * `git worktree prune`). No worktree directories are removed.
+     */
+    preserveTaskIds?: Set<string>;
+    /**
+     * When true, also run `git worktree prune` to clean up stale git
+     * administrative entries even if `preserveTaskIds` is not provided.
+     *
+     * @default true
+     */
+    gitPrune?: boolean;
+}
+/**
+ * Result of a prune operation.
+ *
+ * @task T1161
+ */
+export interface PruneWorktreesResult {
+    /** Number of worktree directories removed. */
+    removed: number;
+    /** Absolute paths that were removed. */
+    removedPaths: string[];
+    /** Entries that failed to remove (with reasons). */
+    errors: Array<{
+        path: string;
+        reason: string;
+    }>;
+    /** Whether `git worktree prune` was run. */
+    gitPruneRan: boolean;
+}
+//# sourceMappingURL=worktree.d.ts.map

package/dist/operations/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/operations/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,KAAK,EAAE,aAAa,GAAG,YAAY,CAAC;IACpC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,eAAe,CAAC;IACrD,+CAA+C;IAC/C,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,0DAA0D;IAC1D,eAAe,EAAE,sBAAsB,EAAE,CAAC;CAC3C;AAMD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,eAAe,EAAE,OAAO,CAAC;IACzB,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,YAAY,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oDAAoD;IACpD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/operations/worktree.js

@@ -0,0 +1,13 @@
+/**
+ * Worktree backend SDK operation types (T1161).
+ *
+ * Wire-format types for the `@cleocode/worktree-backend` SDK surface.
+ * Defines the contract for createWorktree, destroyWorktree, listWorktrees,
+ * and pruneWorktrees operations with XDG path canon (D029) and declarative
+ * hooks (D030 native lift of worktrunk missing features).
+ *
+ * @task T1161
+ * @adr ADR-055
+ */
+export {};
+//# sourceMappingURL=worktree.js.map

package/dist/operations/worktree.js.map

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

package/dist/peer.d.ts

@@ -0,0 +1,125 @@
+/**
+ * PeerIdentity — canonical type for CANT agent persona records.
+ *
+ * Introduced by T1210 (v2026.4.110 Wave 0.2) as the SDK-first contract
+ * for agent identity. `packages/cant/src/native-loader.ts` produces
+ * `PeerIdentity[]` from the canonical seed-agents path; dispatch and
+ * CLI layers consume it to drive `cleo agents list` and spawn routing.
+ *
+ * Design constraints (ADR-055 / D028 boundary rules):
+ *  - Lives in `packages/contracts/` — ZERO runtime dependencies.
+ *  - Consumed by `packages/cant/` (loader) and `packages/cleo/` (CLI).
+ *  - No cross-package relative imports.
+ *
+ * @module peer
+ * @task T1210
+ * @epic T1144
+ */
+/**
+ * Classification of a peer agent's role in the orchestration hierarchy.
+ *
+ * Mirrors the three-tier model in {@link AgentSpawnCapability}:
+ *  - `orchestrator` — coordinates multi-agent workflows; may spawn leads and workers
+ *  - `lead`         — specialist; dispatches workers only
+ *  - `worker`       — terminal; executes tasks, cannot spawn
+ *  - `subagent`     — universal base role; resolved to a specific tier at spawn time
+ */
+export type PeerKind = 'orchestrator' | 'lead' | 'worker' | 'subagent';
+/**
+ * Canonical identity record for a CANT-defined agent persona.
+ *
+ * Produced by `loadSeedAgentIdentities()` in `packages/cant/src/native-loader.ts`
+ * and consumed by the dispatch layer + `cleo agents list`. Every field is
+ * required — loaders MUST supply a value for each field, using empty strings
+ * for absent optional content in the source `.cant` file.
+ *
+ * @example
+ * ```ts
+ * import type { PeerIdentity } from '@cleocode/contracts';
+ *
+ * const personas: PeerIdentity[] = loadSeedAgentIdentities();
+ * for (const p of personas) {
+ *   console.log(`${p.peerId} (${p.peerKind}): ${p.displayName}`);
+ * }
+ * ```
+ *
+ * @task T1210
+ * @epic T1144
+ */
+export interface PeerIdentity {
+    /**
+     * Stable business identifier for the agent, matching the `agent <id>:` block
+     * name in the `.cant` file and the `agents.agent_id` column in the registry.
+     *
+     * @example `"cleo-prime"`, `"cleo-dev"`, `"cleo-subagent"`
+     */
+    peerId: string;
+    /**
+     * Role classification derived from the `role:` field in the `.cant` agent
+     * block. Determines spawn authority in the orchestration hierarchy.
+     */
+    peerKind: PeerKind;
+    /**
+     * Absolute path to the canonical `.cant` file that defines this persona.
+     *
+     * For seed-agents this is inside `packages/agents/seed-agents/` or
+     * `packages/agents/cleo-subagent.cant` (universal base). For project-tier
+     * personas it is inside `.cleo/cant/agents/`.
+     */
+    cantFile: string;
+    /**
+     * Human-readable name for the persona, derived from the `display_name:` or
+     * `description:` field. Falls back to the `peerId` value when neither field
+     * is present in the source `.cant`.
+     */
+    displayName: string;
+    /**
+     * Short description of the persona's purpose, taken from the `description:`
+     * field in the `.cant` agent block. Empty string when absent.
+     */
+    description: string;
+}
+/**
+ * Validate that an unknown value conforms to the {@link PeerIdentity} shape.
+ *
+ * Performs a lightweight structural check without Zod to keep `packages/contracts`
+ * dependency-free at runtime. Callers that need schema-level validation
+ * (e.g., test fixtures) can use {@link assertPeerIdentity}.
+ *
+ * @param value - Value to test.
+ * @returns `true` when `value` is a valid {@link PeerIdentity}.
+ *
+ * @example
+ * ```ts
+ * if (isPeerIdentity(raw)) {
+ *   console.log(raw.peerId);
+ * }
+ * ```
+ */
+export declare function isPeerIdentity(value: unknown): value is PeerIdentity;
+/**
+ * Assert that a value is a valid {@link PeerIdentity}, throwing a descriptive
+ * error when the shape does not conform.
+ *
+ * @param value - Value to assert.
+ * @throws {TypeError} When the value does not satisfy {@link isPeerIdentity}.
+ *
+ * @example
+ * ```ts
+ * assertPeerIdentity(raw); // throws if invalid
+ * console.log(raw.peerId); // safe
+ * ```
+ */
+export declare function assertPeerIdentity(value: unknown): asserts value is PeerIdentity;
+/**
+ * Validate and filter an array of unknown values to {@link PeerIdentity}[].
+ *
+ * Invalid entries are silently dropped. This is the safe variant for loading
+ * from untrusted sources (e.g., the result of parsing a directory of `.cant`
+ * files whose format may vary).
+ *
+ * @param values - Array of unknown values.
+ * @returns Array containing only values that pass {@link isPeerIdentity}.
+ */
+export declare function filterPeerIdentities(values: unknown[]): PeerIdentity[];
+//# sourceMappingURL=peer.d.ts.map

package/dist/peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../src/peer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAMvE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAapE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAMhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAEtE"}

package/dist/peer.js

@@ -0,0 +1,82 @@
+/**
+ * PeerIdentity — canonical type for CANT agent persona records.
+ *
+ * Introduced by T1210 (v2026.4.110 Wave 0.2) as the SDK-first contract
+ * for agent identity. `packages/cant/src/native-loader.ts` produces
+ * `PeerIdentity[]` from the canonical seed-agents path; dispatch and
+ * CLI layers consume it to drive `cleo agents list` and spawn routing.
+ *
+ * Design constraints (ADR-055 / D028 boundary rules):
+ *  - Lives in `packages/contracts/` — ZERO runtime dependencies.
+ *  - Consumed by `packages/cant/` (loader) and `packages/cleo/` (CLI).
+ *  - No cross-package relative imports.
+ *
+ * @module peer
+ * @task T1210
+ * @epic T1144
+ */
+// ============================================================================
+// Runtime validation
+// ============================================================================
+/**
+ * Validate that an unknown value conforms to the {@link PeerIdentity} shape.
+ *
+ * Performs a lightweight structural check without Zod to keep `packages/contracts`
+ * dependency-free at runtime. Callers that need schema-level validation
+ * (e.g., test fixtures) can use {@link assertPeerIdentity}.
+ *
+ * @param value - Value to test.
+ * @returns `true` when `value` is a valid {@link PeerIdentity}.
+ *
+ * @example
+ * ```ts
+ * if (isPeerIdentity(raw)) {
+ *   console.log(raw.peerId);
+ * }
+ * ```
+ */
+export function isPeerIdentity(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return (typeof v['peerId'] === 'string' &&
+        v['peerId'].length > 0 &&
+        typeof v['peerKind'] === 'string' &&
+        ['orchestrator', 'lead', 'worker', 'subagent'].includes(v['peerKind']) &&
+        typeof v['cantFile'] === 'string' &&
+        v['cantFile'].length > 0 &&
+        typeof v['displayName'] === 'string' &&
+        typeof v['description'] === 'string');
+}
+/**
+ * Assert that a value is a valid {@link PeerIdentity}, throwing a descriptive
+ * error when the shape does not conform.
+ *
+ * @param value - Value to assert.
+ * @throws {TypeError} When the value does not satisfy {@link isPeerIdentity}.
+ *
+ * @example
+ * ```ts
+ * assertPeerIdentity(raw); // throws if invalid
+ * console.log(raw.peerId); // safe
+ * ```
+ */
+export function assertPeerIdentity(value) {
+    if (!isPeerIdentity(value)) {
+        throw new TypeError(`Expected PeerIdentity { peerId, peerKind, cantFile, displayName, description } — got: ${JSON.stringify(value)}`);
+    }
+}
+/**
+ * Validate and filter an array of unknown values to {@link PeerIdentity}[].
+ *
+ * Invalid entries are silently dropped. This is the safe variant for loading
+ * from untrusted sources (e.g., the result of parsing a directory of `.cant`
+ * files whose format may vary).
+ *
+ * @param values - Array of unknown values.
+ * @returns Array containing only values that pass {@link isPeerIdentity}.
+ */
+export function filterPeerIdentities(values) {
+    return values.filter(isPeerIdentity);
+}
+//# sourceMappingURL=peer.js.map

package/dist/peer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer.js","sourceRoot":"","sources":["../src/peer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAgFH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ;QAC/B,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;QACtB,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,QAAQ;QACjC,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAW,CAAC;QAChF,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,QAAQ;QACjC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC;QACxB,OAAO,CAAC,CAAC,aAAa,CAAC,KAAK,QAAQ;QACpC,OAAO,CAAC,CAAC,aAAa,CAAC,KAAK,QAAQ,CACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,SAAS,CACjB,yFAAyF,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CACjH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AACvC,CAAC"}

package/package.json

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

package/src/index.ts

@@ -491,6 +491,22 @@ export type {
   SubstitutionSource,
   VariableResolver,
 } from './operations/variable-substitution.js';
+// === Worktree Backend SDK Types (T1161) ===
+// Re-exported at top level so @cleocode/worktree-backend and callers can
+// import without the `ops.` namespace hop.
+export type {
+  CreateWorktreeOptions,
+  CreateWorktreeResult,
+  DestroyWorktreeOptions,
+  DestroyWorktreeResult,
+  ListWorktreesOptions,
+  PruneWorktreesOptions,
+  PruneWorktreesResult,
+  WorktreeHook,
+  WorktreeHookResult,
+  WorktreeIncludePattern,
+  WorktreeListEntry,
+} from './operations/worktree.js';
 // === Orchestration Hierarchy ===
 export {
   type AgentHierarchy,
@@ -499,6 +515,14 @@ export {
   type OrchestrationHierarchyAPI,
   OrchestrationLevel,
 } from './orchestration-hierarchy.js';
+// === Peer Identity (T1210 — SDK-first CANT persona contract) ===
+export {
+  assertPeerIdentity,
+  filterPeerIdentities,
+  isPeerIdentity,
+  type PeerIdentity,
+  type PeerKind,
+} from './peer.js';
 // === Playbook DSL Types (T889 / T904 / W4-6) ===
 export type {
   PlaybookAgenticNode,

package/src/operations/index.ts

@@ -21,3 +21,4 @@ export * from './system.js';
 export * from './tasks.js';
 export * from './validate.js';
 export * from './variable-substitution.js';
+export * from './worktree.js';

package/src/operations/worktree.ts

@@ -0,0 +1,295 @@
+/**
+ * Worktree backend SDK operation types (T1161).
+ *
+ * Wire-format types for the `@cleocode/worktree-backend` SDK surface.
+ * Defines the contract for createWorktree, destroyWorktree, listWorktrees,
+ * and pruneWorktrees operations with XDG path canon (D029) and declarative
+ * hooks (D030 native lift of worktrunk missing features).
+ *
+ * @task T1161
+ * @adr ADR-055
+ */
+
+// ---------------------------------------------------------------------------
+// Hooks framework
+// ---------------------------------------------------------------------------
+
+/**
+ * A declarative lifecycle hook definition for worktree events.
+ *
+ * Hooks are executed synchronously (shell commands) or via node spawns
+ * in the worktree directory. Mirrors the worktrunk hooks contract lifted
+ * natively per D030.
+ *
+ * @task T1161
+ */
+export interface WorktreeHook {
+  /** Shell command to run (executed via `sh -c` in the worktree dir). */
+  command: string;
+  /**
+   * When to run the hook.
+   *
+   * - `post-create` — immediately after `git worktree add` succeeds.
+   * - `post-start`  — after the agent CWD is established (env vars injected).
+   */
+  event: 'post-create' | 'post-start';
+  /**
+   * Optional timeout in milliseconds before the hook is killed.
+   *
+   * @default 30000
+   */
+  timeoutMs?: number;
+  /**
+   * When true, a non-zero exit from this hook causes the worktree operation
+   * to fail. When false (default), errors are logged but ignored.
+   *
+   * @default false
+   */
+  failOnError?: boolean;
+}
+
+/**
+ * Result of a single hook execution.
+ *
+ * @task T1161
+ */
+export interface WorktreeHookResult {
+  /** The hook that was executed. */
+  hook: WorktreeHook;
+  /** Whether the hook exited with code 0. */
+  success: boolean;
+  /** Hook stdout (trimmed). */
+  stdout: string;
+  /** Hook stderr (trimmed). */
+  stderr: string;
+  /** Exit code (null if killed by timeout). */
+  exitCode: number | null;
+  /** Duration in milliseconds. */
+  durationMs: number;
+}
+
+// ---------------------------------------------------------------------------
+// Worktree-include glob pattern
+// ---------------------------------------------------------------------------
+
+/**
+ * A parsed entry from `.cleo/worktree-include`.
+ *
+ * The file lists glob patterns (one per line, `#` comments stripped) that
+ * control which files from the main project tree are symlinked or copied
+ * into new worktrees on creation. This is a native lift of the worktrunk
+ * `.cleo/worktree-include` feature (D030).
+ *
+ * @task T1161
+ */
+export interface WorktreeIncludePattern {
+  /** The raw glob pattern string (e.g. `node_modules/.pnpm/**`). */
+  pattern: string;
+  /**
+   * Whether this entry was negated (prefixed with `!`).
+   *
+   * @default false
+   */
+  negated: boolean;
+}
+
+// ---------------------------------------------------------------------------
+// Create operation
+// ---------------------------------------------------------------------------
+
+/**
+ * Options for creating a new agent worktree.
+ *
+ * @task T1161
+ */
+export interface CreateWorktreeOptions {
+  /** The task ID that will own this worktree. */
+  taskId: string;
+  /** The base ref to branch from (default: current HEAD). */
+  baseRef?: string;
+  /** Explicit branch name. Defaults to `task/<taskId>`. */
+  branchName?: string;
+  /**
+   * Reason for creation. Used for git worktree lock comment and audit logs.
+   *
+   * @default 'subagent'
+   */
+  reason?: 'subagent' | 'experiment' | 'parallel-wave';
+  /** Declarative hooks to run after creation. */
+  hooks?: WorktreeHook[];
+  /**
+   * When true, read `.cleo/worktree-include` from the project root and apply
+   * any declared include patterns to the new worktree.
+   *
+   * @default true
+   */
+  applyIncludePatterns?: boolean;
+  /**
+   * When true, apply git worktree lock (`git worktree lock`) to prevent
+   * accidental pruning by git.
+   *
+   * @default true
+   */
+  lockWorktree?: boolean;
+}
+
+/**
+ * Result of a successful worktree creation.
+ *
+ * @task T1161
+ */
+export interface CreateWorktreeResult {
+  /**
+   * Absolute path to the created worktree directory.
+   *
+   * Always under `~/.local/share/cleo/worktrees/<projectHash>/<taskId>/`
+   * per D029 canonical layout.
+   */
+  path: string;
+  /** Branch name created for this worktree (format: `task/<taskId>`). */
+  branch: string;
+  /** Base ref the branch was created from. */
+  baseRef: string;
+  /** Task ID that owns this worktree. */
+  taskId: string;
+  /** Project hash scoping this worktree under the XDG root. */
+  projectHash: string;
+  /** ISO 8601 timestamp when the worktree was created. */
+  createdAt: string;
+  /** Whether git worktree lock was applied. */
+  locked: boolean;
+  /** Environment variables to inject into the spawned agent process. */
+  envVars: Record<string, string>;
+  /** Prompt preamble text for agent isolation context. */
+  preamble: string;
+  /** Results of any post-create hooks that were executed. */
+  hookResults: WorktreeHookResult[];
+  /** Include patterns that were applied (empty if none). */
+  appliedPatterns: WorktreeIncludePattern[];
+}
+
+// ---------------------------------------------------------------------------
+// Destroy operation
+// ---------------------------------------------------------------------------
+
+/**
+ * Options for destroying a worktree.
+ *
+ * @task T1161
+ */
+export interface DestroyWorktreeOptions {
+  /** Task ID whose worktree to destroy. */
+  taskId: string;
+  /**
+   * When true, delete the associated git branch after removing the worktree.
+   *
+   * @default true
+   */
+  deleteBranch?: boolean;
+  /**
+   * When true, cherry-pick any commits on the task branch back to the
+   * orchestrator's current branch before destroying.
+   *
+   * @default false
+   */
+  cherryPickFirst?: boolean;
+}
+
+/**
+ * Result of a worktree destroy operation.
+ *
+ * @task T1161
+ */
+export interface DestroyWorktreeResult {
+  /** Task ID that was destroyed. */
+  taskId: string;
+  /** Whether the worktree directory was successfully removed. */
+  worktreeRemoved: boolean;
+  /** Whether the task branch was deleted. */
+  branchDeleted: boolean;
+  /** Whether cherry-pick was attempted and succeeded. */
+  cherryPicked: boolean;
+  /** Number of commits cherry-picked (0 if none or not requested). */
+  commitCount: number;
+  /** Error message if any step failed (non-fatal — caller decides). */
+  error?: string;
+}
+
+// ---------------------------------------------------------------------------
+// List operation
+// ---------------------------------------------------------------------------
+
+/**
+ * A single entry from the worktree listing.
+ *
+ * @task T1161
+ */
+export interface WorktreeListEntry {
+  /** Absolute path to the worktree directory. */
+  path: string;
+  /** Branch checked out in this worktree. */
+  branch: string;
+  /**
+   * Task ID derived from the worktree directory name.
+   *
+   * Convention: the last path segment is the taskId.
+   */
+  taskId: string;
+  /** Project hash derived from the path. */
+  projectHash: string;
+}
+
+/**
+ * Options for listing worktrees.
+ *
+ * @task T1161
+ */
+export interface ListWorktreesOptions {
+  /** Filter to only return worktrees for a specific project hash. */
+  projectHash?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Prune operation
+// ---------------------------------------------------------------------------
+
+/**
+ * Options for pruning orphaned worktrees.
+ *
+ * @task T1161
+ */
+export interface PruneWorktreesOptions {
+  /** Absolute path to the project root (used to resolve the worktree root). */
+  projectRoot: string;
+  /**
+   * Set of task IDs to preserve. Any worktree directory whose name is NOT in
+   * this set will be pruned.
+   *
+   * When omitted, only stale git administrative entries are pruned (via
+   * `git worktree prune`). No worktree directories are removed.
+   */
+  preserveTaskIds?: Set<string>;
+  /**
+   * When true, also run `git worktree prune` to clean up stale git
+   * administrative entries even if `preserveTaskIds` is not provided.
+   *
+   * @default true
+   */
+  gitPrune?: boolean;
+}
+
+/**
+ * Result of a prune operation.
+ *
+ * @task T1161
+ */
+export interface PruneWorktreesResult {
+  /** Number of worktree directories removed. */
+  removed: number;
+  /** Absolute paths that were removed. */
+  removedPaths: string[];
+  /** Entries that failed to remove (with reasons). */
+  errors: Array<{ path: string; reason: string }>;
+  /** Whether `git worktree prune` was run. */
+  gitPruneRan: boolean;
+}

package/src/peer.ts

@@ -0,0 +1,166 @@
+/**
+ * PeerIdentity — canonical type for CANT agent persona records.
+ *
+ * Introduced by T1210 (v2026.4.110 Wave 0.2) as the SDK-first contract
+ * for agent identity. `packages/cant/src/native-loader.ts` produces
+ * `PeerIdentity[]` from the canonical seed-agents path; dispatch and
+ * CLI layers consume it to drive `cleo agents list` and spawn routing.
+ *
+ * Design constraints (ADR-055 / D028 boundary rules):
+ *  - Lives in `packages/contracts/` — ZERO runtime dependencies.
+ *  - Consumed by `packages/cant/` (loader) and `packages/cleo/` (CLI).
+ *  - No cross-package relative imports.
+ *
+ * @module peer
+ * @task T1210
+ * @epic T1144
+ */
+
+// ============================================================================
+// PeerKind taxonomy
+// ============================================================================
+
+/**
+ * Classification of a peer agent's role in the orchestration hierarchy.
+ *
+ * Mirrors the three-tier model in {@link AgentSpawnCapability}:
+ *  - `orchestrator` — coordinates multi-agent workflows; may spawn leads and workers
+ *  - `lead`         — specialist; dispatches workers only
+ *  - `worker`       — terminal; executes tasks, cannot spawn
+ *  - `subagent`     — universal base role; resolved to a specific tier at spawn time
+ */
+export type PeerKind = 'orchestrator' | 'lead' | 'worker' | 'subagent';
+
+// ============================================================================
+// PeerIdentity
+// ============================================================================
+
+/**
+ * Canonical identity record for a CANT-defined agent persona.
+ *
+ * Produced by `loadSeedAgentIdentities()` in `packages/cant/src/native-loader.ts`
+ * and consumed by the dispatch layer + `cleo agents list`. Every field is
+ * required — loaders MUST supply a value for each field, using empty strings
+ * for absent optional content in the source `.cant` file.
+ *
+ * @example
+ * ```ts
+ * import type { PeerIdentity } from '@cleocode/contracts';
+ *
+ * const personas: PeerIdentity[] = loadSeedAgentIdentities();
+ * for (const p of personas) {
+ *   console.log(`${p.peerId} (${p.peerKind}): ${p.displayName}`);
+ * }
+ * ```
+ *
+ * @task T1210
+ * @epic T1144
+ */
+export interface PeerIdentity {
+  /**
+   * Stable business identifier for the agent, matching the `agent <id>:` block
+   * name in the `.cant` file and the `agents.agent_id` column in the registry.
+   *
+   * @example `"cleo-prime"`, `"cleo-dev"`, `"cleo-subagent"`
+   */
+  peerId: string;
+
+  /**
+   * Role classification derived from the `role:` field in the `.cant` agent
+   * block. Determines spawn authority in the orchestration hierarchy.
+   */
+  peerKind: PeerKind;
+
+  /**
+   * Absolute path to the canonical `.cant` file that defines this persona.
+   *
+   * For seed-agents this is inside `packages/agents/seed-agents/` or
+   * `packages/agents/cleo-subagent.cant` (universal base). For project-tier
+   * personas it is inside `.cleo/cant/agents/`.
+   */
+  cantFile: string;
+
+  /**
+   * Human-readable name for the persona, derived from the `display_name:` or
+   * `description:` field. Falls back to the `peerId` value when neither field
+   * is present in the source `.cant`.
+   */
+  displayName: string;
+
+  /**
+   * Short description of the persona's purpose, taken from the `description:`
+   * field in the `.cant` agent block. Empty string when absent.
+   */
+  description: string;
+}
+
+// ============================================================================
+// Runtime validation
+// ============================================================================
+
+/**
+ * Validate that an unknown value conforms to the {@link PeerIdentity} shape.
+ *
+ * Performs a lightweight structural check without Zod to keep `packages/contracts`
+ * dependency-free at runtime. Callers that need schema-level validation
+ * (e.g., test fixtures) can use {@link assertPeerIdentity}.
+ *
+ * @param value - Value to test.
+ * @returns `true` when `value` is a valid {@link PeerIdentity}.
+ *
+ * @example
+ * ```ts
+ * if (isPeerIdentity(raw)) {
+ *   console.log(raw.peerId);
+ * }
+ * ```
+ */
+export function isPeerIdentity(value: unknown): value is PeerIdentity {
+  if (typeof value !== 'object' || value === null) return false;
+  const v = value as Record<string, unknown>;
+  return (
+    typeof v['peerId'] === 'string' &&
+    v['peerId'].length > 0 &&
+    typeof v['peerKind'] === 'string' &&
+    ['orchestrator', 'lead', 'worker', 'subagent'].includes(v['peerKind'] as string) &&
+    typeof v['cantFile'] === 'string' &&
+    v['cantFile'].length > 0 &&
+    typeof v['displayName'] === 'string' &&
+    typeof v['description'] === 'string'
+  );
+}
+
+/**
+ * Assert that a value is a valid {@link PeerIdentity}, throwing a descriptive
+ * error when the shape does not conform.
+ *
+ * @param value - Value to assert.
+ * @throws {TypeError} When the value does not satisfy {@link isPeerIdentity}.
+ *
+ * @example
+ * ```ts
+ * assertPeerIdentity(raw); // throws if invalid
+ * console.log(raw.peerId); // safe
+ * ```
+ */
+export function assertPeerIdentity(value: unknown): asserts value is PeerIdentity {
+  if (!isPeerIdentity(value)) {
+    throw new TypeError(
+      `Expected PeerIdentity { peerId, peerKind, cantFile, displayName, description } — got: ${JSON.stringify(value)}`,
+    );
+  }
+}
+
+/**
+ * Validate and filter an array of unknown values to {@link PeerIdentity}[].
+ *
+ * Invalid entries are silently dropped. This is the safe variant for loading
+ * from untrusted sources (e.g., the result of parsing a directory of `.cant`
+ * files whose format may vary).
+ *
+ * @param values - Array of unknown values.
+ * @returns Array containing only values that pass {@link isPeerIdentity}.
+ */
+export function filterPeerIdentities(values: unknown[]): PeerIdentity[] {
+  return values.filter(isPeerIdentity);
+}