@cleocode/contracts 2026.4.101 → 2026.4.102

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,225 @@
1
+ /**
2
+ * Branch-lock and owner-override authentication contracts for T1118.
3
+ *
4
+ * Defines types, error codes, and interfaces for the four-layer agent
5
+ * branch-protection system:
6
+ *
7
+ * - L1: Git worktree isolation per spawned agent
8
+ * - L2: cleo-git-shim binary on PATH for harness-agnostic enforcement
9
+ * - L3: Filesystem hardening via chmod (+ optional chattr on Linux)
10
+ * - L4: Owner-override HMAC session authentication with TTY + rate-limit gates
11
+ *
12
+ * @task T1118
13
+ * @adr ADR-055
14
+ */
15
+ /**
16
+ * State of an agent worktree created by orchestrate.spawn.
17
+ *
18
+ * @task T1118
19
+ * @task T1120
20
+ */
21
+ export interface AgentWorktreeState {
22
+ /** Absolute path to the worktree directory. */
23
+ path: string;
24
+ /** Branch name (format: task/<taskId>). */
25
+ branch: string;
26
+ /** Task ID that owns this worktree. */
27
+ taskId: string;
28
+ /** Base ref the branch was created from (e.g. "main"). */
29
+ baseRef: string;
30
+ /** Project hash for env-var injection. */
31
+ projectHash: string;
32
+ /** ISO 8601 timestamp when the worktree was created. */
33
+ createdAt: string;
34
+ /** Whether git worktree lock was applied to this entry. */
35
+ locked: boolean;
36
+ }
37
+ /**
38
+ * Result of creating a worktree during spawn.
39
+ *
40
+ * @task T1118
41
+ * @task T1120
42
+ */
43
+ export interface WorktreeSpawnResult {
44
+ /** The created worktree state. */
45
+ worktree: AgentWorktreeState;
46
+ /** Environment variables to inject into the agent's process. */
47
+ envVars: Record<string, string>;
48
+ /** CWD the agent MUST be started in. */
49
+ cwd: string;
50
+ /** Preamble text to prepend to the agent's spawn prompt. */
51
+ preamble: string;
52
+ }
53
+ /**
54
+ * Result from the orchestrate.worktree.complete operation.
55
+ *
56
+ * @task T1118
57
+ * @task T1120
58
+ */
59
+ export interface WorktreeCompleteResult {
60
+ /** Task ID that was completed. */
61
+ taskId: string;
62
+ /** Whether the cherry-pick succeeded. */
63
+ cherryPicked: boolean;
64
+ /** Number of commits cherry-picked. */
65
+ commitCount: number;
66
+ /** Whether the worktree was removed. */
67
+ worktreeRemoved: boolean;
68
+ /** Whether the task branch was deleted. */
69
+ branchDeleted: boolean;
70
+ /** Error message if any step failed (non-fatal — caller decides). */
71
+ error?: string;
72
+ }
73
+ /**
74
+ * Result from the orchestrate.worktree.cleanup operation.
75
+ *
76
+ * @task T1118
77
+ * @task T1120
78
+ */
79
+ export interface WorktreeCleanupResult {
80
+ /** Number of stale worktrees removed. */
81
+ removed: number;
82
+ /** Paths that were removed. */
83
+ removedPaths: string[];
84
+ /** Paths that failed to remove (with reasons). */
85
+ errors: Array<{
86
+ path: string;
87
+ reason: string;
88
+ }>;
89
+ }
90
+ /**
91
+ * Environment variables read by the cleo-git-shim binary.
92
+ *
93
+ * @task T1118
94
+ * @task T1121
95
+ */
96
+ export interface GitShimEnv {
97
+ /** Agent role. When set to worker|lead|subagent, branch-mutating ops are blocked. */
98
+ CLEO_AGENT_ROLE?: 'orchestrator' | 'worker' | 'lead' | 'subagent';
99
+ /** When set to "1", bypass the branch-mutation denylist for one command. */
100
+ CLEO_ALLOW_BRANCH_OPS?: '1';
101
+ /** Worktree root path — informational for shim error messages. */
102
+ CLEO_WORKTREE_ROOT?: string;
103
+ /** Branch protection mode. */
104
+ CLEO_BRANCH_PROTECTION?: 'strict' | 'permissive' | 'off';
105
+ }
106
+ /**
107
+ * A blocked git subcommand entry in the denylist.
108
+ *
109
+ * @task T1118
110
+ * @task T1121
111
+ */
112
+ export interface DeniedGitOp {
113
+ /** The git subcommand (e.g. "checkout"). */
114
+ subcommand: string;
115
+ /** Optional flag that triggers the denial (e.g. "--hard" for reset). */
116
+ flag?: string;
117
+ /** Human-readable reason shown in the shim's stderr output. */
118
+ reason: string;
119
+ }
120
+ /**
121
+ * Platform capability report for filesystem hardening.
122
+ *
123
+ * @task T1118
124
+ * @task T1122
125
+ */
126
+ export interface FsHardenCapabilities {
127
+ /** Whether chmod is available (always true on POSIX). */
128
+ chmod: boolean;
129
+ /** Whether chattr is available (Linux ext2/3/4/xfs only). */
130
+ chattr: boolean;
131
+ /** Whether chflags is available (macOS). */
132
+ chflags: boolean;
133
+ /** Detected platform. */
134
+ platform: 'linux' | 'macos' | 'windows' | 'wsl' | 'unknown';
135
+ }
136
+ /**
137
+ * State of the filesystem hard-lock for the orchestrator's HEAD.
138
+ *
139
+ * @task T1118
140
+ * @task T1122
141
+ */
142
+ export interface FsHardenState {
143
+ /** Whether any lock is currently active. */
144
+ active: boolean;
145
+ /** Which mechanism was applied (chmod, chattr, or chflags). */
146
+ mechanism: 'chmod' | 'chattr' | 'chflags' | 'none';
147
+ /** Absolute path(s) that were locked. */
148
+ lockedPaths: string[];
149
+ /** ISO 8601 timestamp when the lock was applied. */
150
+ appliedAt?: string;
151
+ }
152
+ /**
153
+ * Record appended to force-bypass.jsonl when an override is used.
154
+ *
155
+ * Extends the base ForceBypassRecord with L4-specific authentication fields.
156
+ *
157
+ * @task T1118
158
+ * @task T1123
159
+ */
160
+ export interface OwnerOverrideAuditRecord {
161
+ /** ISO 8601 timestamp. */
162
+ timestamp: string;
163
+ /** Task ID being verified (may be "*" for session-level). */
164
+ taskId: string;
165
+ /** Gate being bypassed. */
166
+ gate: string;
167
+ /** Write action performed. */
168
+ action: string;
169
+ /** Agent ID that performed the bypass. */
170
+ agent_id: string;
171
+ /** Session ID. */
172
+ session_id: string | null;
173
+ /** Whether the HMAC token was validated (L4a). */
174
+ token_validated: boolean;
175
+ /** Whether TTY was present (L4c). */
176
+ tty_present: boolean;
177
+ /** Override count within the current session (L4d). */
178
+ override_count: number;
179
+ /** Webhook delivery status (L4d). */
180
+ webhook_delivered?: boolean;
181
+ /** Reason supplied by the operator. */
182
+ reason: string;
183
+ /** Process ID. */
184
+ pid: number;
185
+ }
186
+ /**
187
+ * Configuration for the owner override system.
188
+ *
189
+ * @task T1118
190
+ * @task T1123
191
+ */
192
+ export interface OwnerOverrideConfig {
193
+ /** Maximum number of overrides allowed per session (default: 3). */
194
+ maxPerSession: number;
195
+ /** Optional webhook URL to POST on each bypass. */
196
+ alertWebhook?: string;
197
+ }
198
+ /**
199
+ * Error codes emitted by the branch-lock + override-auth system.
200
+ *
201
+ * @task T1118
202
+ */
203
+ export declare const BRANCH_LOCK_ERROR_CODES: {
204
+ /** L2: git shim blocked a branch-mutating operation. */
205
+ readonly E_GIT_OP_BLOCKED: "E_GIT_OP_BLOCKED";
206
+ /** L1: spawn attempted without a worktree handle. */
207
+ readonly E_WORKTREE_REQUIRED: "E_WORKTREE_REQUIRED";
208
+ /** L1: worktree path does not exist or is not a valid git worktree. */
209
+ readonly E_WORKTREE_INVALID: "E_WORKTREE_INVALID";
210
+ /** L1: cherry-pick failed during worktree.complete. */
211
+ readonly E_CHERRY_PICK_FAILED: "E_CHERRY_PICK_FAILED";
212
+ /** L3: filesystem harden failed. */
213
+ readonly E_FS_HARDEN_FAILED: "E_FS_HARDEN_FAILED";
214
+ /** L4a: HMAC token invalid or missing. */
215
+ readonly E_OVERRIDE_TOKEN_INVALID: "E_OVERRIDE_TOKEN_INVALID";
216
+ /** L4b: caller has CLEO_AGENT_ROLE=worker|lead|subagent — override forbidden. */
217
+ readonly E_OVERRIDE_FORBIDDEN_AGENT_ROLE: "E_OVERRIDE_FORBIDDEN_AGENT_ROLE";
218
+ /** L4c: override requires TTY but stdin/stderr is not a TTY. */
219
+ readonly E_OVERRIDE_NEEDS_TTY: "E_OVERRIDE_NEEDS_TTY";
220
+ /** L4d: session override limit exceeded. */
221
+ readonly E_OVERRIDE_RATE_LIMIT: "E_OVERRIDE_RATE_LIMIT";
222
+ };
223
+ /** Union of all branch-lock error code strings. */
224
+ export type BranchLockErrorCode = (typeof BRANCH_LOCK_ERROR_CODES)[keyof typeof BRANCH_LOCK_ERROR_CODES];
225
+ //# sourceMappingURL=branch-lock.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"branch-lock.d.ts","sourceRoot":"","sources":["../src/branch-lock.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Branch-lock and owner-override authentication contracts for T1118.
3
+ *
4
+ * Defines types, error codes, and interfaces for the four-layer agent
5
+ * branch-protection system:
6
+ *
7
+ * - L1: Git worktree isolation per spawned agent
8
+ * - L2: cleo-git-shim binary on PATH for harness-agnostic enforcement
9
+ * - L3: Filesystem hardening via chmod (+ optional chattr on Linux)
10
+ * - L4: Owner-override HMAC session authentication with TTY + rate-limit gates
11
+ *
12
+ * @task T1118
13
+ * @adr ADR-055
14
+ */
15
+ // ---------------------------------------------------------------------------
16
+ // Error codes for branch-lock enforcement
17
+ // ---------------------------------------------------------------------------
18
+ /**
19
+ * Error codes emitted by the branch-lock + override-auth system.
20
+ *
21
+ * @task T1118
22
+ */
23
+ export const BRANCH_LOCK_ERROR_CODES = {
24
+ /** L2: git shim blocked a branch-mutating operation. */
25
+ E_GIT_OP_BLOCKED: 'E_GIT_OP_BLOCKED',
26
+ /** L1: spawn attempted without a worktree handle. */
27
+ E_WORKTREE_REQUIRED: 'E_WORKTREE_REQUIRED',
28
+ /** L1: worktree path does not exist or is not a valid git worktree. */
29
+ E_WORKTREE_INVALID: 'E_WORKTREE_INVALID',
30
+ /** L1: cherry-pick failed during worktree.complete. */
31
+ E_CHERRY_PICK_FAILED: 'E_CHERRY_PICK_FAILED',
32
+ /** L3: filesystem harden failed. */
33
+ E_FS_HARDEN_FAILED: 'E_FS_HARDEN_FAILED',
34
+ /** L4a: HMAC token invalid or missing. */
35
+ E_OVERRIDE_TOKEN_INVALID: 'E_OVERRIDE_TOKEN_INVALID',
36
+ /** L4b: caller has CLEO_AGENT_ROLE=worker|lead|subagent — override forbidden. */
37
+ E_OVERRIDE_FORBIDDEN_AGENT_ROLE: 'E_OVERRIDE_FORBIDDEN_AGENT_ROLE',
38
+ /** L4c: override requires TTY but stdin/stderr is not a TTY. */
39
+ E_OVERRIDE_NEEDS_TTY: 'E_OVERRIDE_NEEDS_TTY',
40
+ /** L4d: session override limit exceeded. */
41
+ E_OVERRIDE_RATE_LIMIT: 'E_OVERRIDE_RATE_LIMIT',
42
+ };
43
+ //# sourceMappingURL=branch-lock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"branch-lock.js","sourceRoot":"","sources":["../src/branch-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgNH,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,wDAAwD;IACxD,gBAAgB,EAAE,kBAAkB;IACpC,qDAAqD;IACrD,mBAAmB,EAAE,qBAAqB;IAC1C,uEAAuE;IACvE,kBAAkB,EAAE,oBAAoB;IACxC,uDAAuD;IACvD,oBAAoB,EAAE,sBAAsB;IAC5C,oCAAoC;IACpC,kBAAkB,EAAE,oBAAoB;IACxC,0CAA0C;IAC1C,wBAAwB,EAAE,0BAA0B;IACpD,iFAAiF;IACjF,+BAA+B,EAAE,iCAAiC;IAClE,gEAAgE;IAChE,oBAAoB,EAAE,sBAAsB;IAC5C,4CAA4C;IAC5C,qBAAqB,EAAE,uBAAuB;CACtC,CAAC"}
package/dist/index.d.ts CHANGED
@@ -18,10 +18,12 @@ export { attachmentMetadataSchema, attachmentRefSchema, attachmentSchema, blobAt
18
18
  export type { BackupDatabaseEntry, BackupGlobalFileEntry, BackupIntegrity, BackupJsonEntry, BackupManifest, BackupMetadata, BackupScope, } from './backup-manifest.js';
19
19
  export type { BrainCognitiveType, BrainEntryRef, BrainEntrySummary, BrainMemoryTier, BrainSourceConfidence, ContradictionDetail, SupersededEntry, } from './brain.js';
20
20
  export type { BrainConnectionStatus, BrainEdge, BrainGraph, BrainNode, BrainNodeKind, BrainProjectContext, BrainQueryOptions, BrainStreamEvent, BrainSubstrate, } from './brain-graph.js';
21
+ export type { AgentWorktreeState, BranchLockErrorCode, DeniedGitOp, FsHardenCapabilities, FsHardenState, GitShimEnv, OwnerOverrideAuditRecord, OwnerOverrideConfig, WorktreeCleanupResult, WorktreeCompleteResult, WorktreeSpawnResult, } from './branch-lock.js';
22
+ export { BRANCH_LOCK_ERROR_CODES } from './branch-lock.js';
21
23
  export type { AdapterCapabilities } from './capabilities.js';
22
24
  export type { BatchParseResult, CodeSymbol, CodeSymbolKind, ParseResult, } from './code-symbol.js';
23
25
  export type { Conduit, ConduitConfig, ConduitMessage, ConduitSendOptions, ConduitSendResult, ConduitState, ConduitStateChange, ConduitUnsubscribe, } from './conduit.js';
24
- export type { BackupConfig, BrainConfig, BrainEmbeddingConfig, BrainLlmExtractionConfig, BrainMemoryBridgeConfig, BrainSummarizationConfig, BrainTieringConfig, ClaudeProviderConfig, ClaudeSpawnMode, CleoConfig, ConfigSource, DateFormat, EnforcementProfile, HierarchyConfig, LifecycleConfig, LifecycleEnforcementMode, LoggingConfig, LogLevel, OutputConfig, OutputFormat, ProviderConfig, ResolvedValue, SessionConfig, SessionSummaryInput, SharingConfig, SharingMode, SignalDockConfig, SignalDockMode, } from './config.js';
26
+ export type { BackupConfig, BrainConfig, BrainEmbeddingConfig, BrainLlmExtractionConfig, BrainMemoryBridgeConfig, BrainSummarizationConfig, BrainTieringConfig, ClaudeProviderConfig, ClaudeSpawnMode, CleoConfig, ConfigSource, DateFormat, EnforcementProfile, HierarchyConfig, LifecycleConfig, LifecycleEnforcementMode, LoggingConfig, LogLevel, MemoryBridgeMode, OutputConfig, OutputFormat, ProviderConfig, ResolvedValue, SessionConfig, SessionSummaryInput, SharingConfig, SharingMode, SignalDockConfig, SignalDockMode, } from './config.js';
25
27
  export type { AdapterContextMonitorProvider } from './context-monitor.js';
26
28
  export type { ArchiveFields, ArchiveFile, DataAccessor, DataAccessorAgentInstance, QueryTasksResult, TaskFieldUpdates, TaskQueryFilters, TransactionAccessor, } from './data-accessor.js';
27
29
  export type { DependencyCategory, DependencyCheckResult, DependencyReport, DependencySpec, } from './dependency.js';
@@ -44,7 +46,7 @@ export type { BlastRadiusSummary, BrainMemoryRef, BrainRiskNote, CodeAnchorResul
44
46
  export type { NexusCteAlias, NexusCteMarkdownTable, NexusCteParams, NexusCtePlaceholder, NexusCteResult, } from './nexus-query-ops.js';
45
47
  export type { RouteMapEntry, RouteMapResult, ShapeCheckCaller, ShapeCheckResult, ShapeCheckStatus, } from './nexus-route-ops.js';
46
48
  export type { GitLogLinkerResult, LinkTaskResult, SymbolReference, TaskReference, } from './nexus-tasks-bridge-ops.js';
47
- export type { CommunityWikiStats, NexusWikiResult, WikiSymbolRow, } from './nexus-wiki-ops.js';
49
+ export type { CommunityWikiStats, GenerateNexusWikiOptions, NexusWikiResult, WikiDbHandle, WikiStateFile, WikiSymbolRow, } from './nexus-wiki-ops.js';
48
50
  export * as ops from './operations/index.js';
49
51
  export type { BrainState } from './operations/orchestrate.js';
50
52
  export type { CittyArgDef, OperationParams, ParamCliDef, ParamDef, ParamType, } from './operations/params.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -8,6 +8,8 @@
8
8
  // === Acceptance Gate Zod Schemas (runtime validation) ===
9
9
  export { acceptanceArraySchema, acceptanceGateResultSchema, acceptanceGateSchema, acceptanceItemSchema, commandGateSchema, fileAssertionSchema, fileGateSchema, gateBaseSchema, gateResultDetailsSchema, httpGateSchema, lintGateSchema, manualGateSchema, testGateSchema, } from './acceptance-gate-schema.js';
10
10
  export { attachmentMetadataSchema, attachmentRefSchema, attachmentSchema, blobAttachmentSchema, llmsTxtAttachmentSchema, llmtxtDocAttachmentSchema, localFileAttachmentSchema, urlAttachmentSchema, } from './attachment-schema.js';
11
+ // === Branch-Lock + Owner-Auth Types (T1118) ===
12
+ export { BRANCH_LOCK_ERROR_CODES } from './branch-lock.js';
11
13
  // === Error Utilities ===
12
14
  export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, ThinAgentViolationError, } from './errors.js';
13
15
  // === Evidence Record Zod Schemas (runtime validation) ===
package/dist/index.js.map CHANGED
@@ -1 +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;AAuGhC,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;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;AAwEnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAW7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAoC3D,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"}
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,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;AAoC3D,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"}
@@ -5,6 +5,7 @@
5
5
  * from the nexus code graph.
6
6
  *
7
7
  * @task T1060
8
+ * @task T1109
8
9
  * @epic T1042
9
10
  */
10
11
  /**
@@ -32,6 +33,10 @@ export interface NexusWikiResult {
32
33
  communities: CommunityWikiStats[];
33
34
  /** Error message if success is false */
34
35
  error?: string;
36
+ /** IDs of communities that were skipped (incremental mode) */
37
+ skippedCommunities?: string[];
38
+ /** Whether LOOM LLM narrative was generated */
39
+ loomEnabled?: boolean;
35
40
  }
36
41
  /**
37
42
  * Symbol metadata as it appears in the wiki index.
@@ -48,4 +53,75 @@ export interface WikiSymbolRow {
48
53
  /** Number of symbols this symbol calls */
49
54
  calleeCount: number;
50
55
  }
56
+ /**
57
+ * Subset of SQLite-compatible parameter values accepted by `DatabaseSync.prepare()`.
58
+ * Mirrors node:sqlite's `SQLInputValue` without importing from node internals.
59
+ */
60
+ export type WikiSqlParam = null | number | bigint | string | Uint8Array;
61
+ /**
62
+ * Minimal interface for an injectable SQLite database handle.
63
+ * Used in tests to provide an isolated in-memory or temp-file database
64
+ * instead of the real nexus.db singleton.
65
+ *
66
+ * Matches the subset of `DatabaseSync` (node:sqlite) used by the wiki generator.
67
+ */
68
+ export interface WikiDbHandle {
69
+ /**
70
+ * Prepare a SQL statement and return a statement object with
71
+ * `all(...params)` and `get(...params)` accessors.
72
+ * Compatible with both `DatabaseSync.prepare()` and test mocks.
73
+ */
74
+ prepare: (sql: string) => {
75
+ all: (...params: WikiSqlParam[]) => Record<string, WikiSqlParam>[];
76
+ get: (...params: WikiSqlParam[]) => Record<string, WikiSqlParam> | undefined;
77
+ };
78
+ }
79
+ /**
80
+ * Options for generating the nexus wiki index.
81
+ */
82
+ export interface GenerateNexusWikiOptions {
83
+ /**
84
+ * Filter generation to a single community ID.
85
+ * When set, only that community's markdown file is generated.
86
+ * The overview.md is NOT generated in single-community mode.
87
+ */
88
+ communityFilter?: string;
89
+ /**
90
+ * Enable incremental mode: use `cleo nexus diff` data to skip
91
+ * communities whose symbols have not changed since the last wiki run.
92
+ *
93
+ * Reads `.cleo/wiki-state.json` for the last-run commit SHA.
94
+ * On first run (no state file), performs a full generation and writes
95
+ * the state file.
96
+ */
97
+ incremental?: boolean;
98
+ /**
99
+ * LOOM provider function for generating narrative module summaries.
100
+ * Injected by the caller (CLI or test harness). When `null`, scaffold
101
+ * mode is used (no LLM narrative).
102
+ *
103
+ * Signature: `(prompt: string) => Promise<string>`
104
+ */
105
+ loomProvider?: ((prompt: string) => Promise<string>) | null;
106
+ /**
107
+ * Project root directory (used for resolving `.cleo/wiki-state.json`
108
+ * and running git operations). Defaults to `process.cwd()`.
109
+ */
110
+ projectRoot?: string;
111
+ /**
112
+ * Injectable database handle for testing.
113
+ * When provided, this handle is used instead of the real nexus.db singleton.
114
+ * Allows unit/integration tests to use isolated in-memory SQLite databases.
115
+ */
116
+ _dbForTesting?: WikiDbHandle;
117
+ }
118
+ /**
119
+ * State file persisted to `.cleo/wiki-state.json` for incremental mode.
120
+ */
121
+ export interface WikiStateFile {
122
+ /** Git commit SHA of the last full or incremental wiki generation run. */
123
+ lastRunCommit: string;
124
+ /** List of community IDs generated in the last run. */
125
+ generatedCommunities: string[];
126
+ }
51
127
  //# sourceMappingURL=nexus-wiki-ops.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"nexus-wiki-ops.d.ts","sourceRoot":"","sources":["../src/nexus-wiki-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB"}
1
+ {"version":3,"file":"nexus-wiki-ops.d.ts","sourceRoot":"","sources":["../src/nexus-wiki-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QACxB,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;QACnE,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;KAC9E,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5D;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC"}
@@ -5,6 +5,7 @@
5
5
  * from the nexus code graph.
6
6
  *
7
7
  * @task T1060
8
+ * @task T1109
8
9
  * @epic T1042
9
10
  */
10
11
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"nexus-wiki-ops.js","sourceRoot":"","sources":["../src/nexus-wiki-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}
1
+ {"version":3,"file":"nexus-wiki-ops.js","sourceRoot":"","sources":["../src/nexus-wiki-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}
@@ -167,6 +167,14 @@ export interface SessionStartParams {
167
167
  focus?: string;
168
168
  /** Enable full query+mutation audit logging for behavioral grading. */
169
169
  grade?: boolean;
170
+ /**
171
+ * HMAC-SHA256 owner-auth token for L4a override authentication (T1118).
172
+ *
173
+ * Derived from HMAC-SHA256(key=password, data=sessionId) during
174
+ * `cleo session start --owner-auth`. Stored in sessions.owner_auth_token
175
+ * and validated on every `CLEO_OWNER_OVERRIDE` call.
176
+ */
177
+ ownerAuthToken?: string;
170
178
  }
171
179
  /** Result of `session.start` — the newly created session. */
172
180
  export type SessionStartResult = Session;
@@ -1 +1 @@
1
- {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/operations/session.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/operations/session.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cleocode/contracts",
3
- "version": "2026.4.101",
3
+ "version": "2026.4.102",
4
4
  "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -0,0 +1,254 @@
1
+ /**
2
+ * Branch-lock and owner-override authentication contracts for T1118.
3
+ *
4
+ * Defines types, error codes, and interfaces for the four-layer agent
5
+ * branch-protection system:
6
+ *
7
+ * - L1: Git worktree isolation per spawned agent
8
+ * - L2: cleo-git-shim binary on PATH for harness-agnostic enforcement
9
+ * - L3: Filesystem hardening via chmod (+ optional chattr on Linux)
10
+ * - L4: Owner-override HMAC session authentication with TTY + rate-limit gates
11
+ *
12
+ * @task T1118
13
+ * @adr ADR-055
14
+ */
15
+
16
+ // ---------------------------------------------------------------------------
17
+ // L1 — Worktree lifecycle types
18
+ // ---------------------------------------------------------------------------
19
+
20
+ /**
21
+ * State of an agent worktree created by orchestrate.spawn.
22
+ *
23
+ * @task T1118
24
+ * @task T1120
25
+ */
26
+ export interface AgentWorktreeState {
27
+ /** Absolute path to the worktree directory. */
28
+ path: string;
29
+ /** Branch name (format: task/<taskId>). */
30
+ branch: string;
31
+ /** Task ID that owns this worktree. */
32
+ taskId: string;
33
+ /** Base ref the branch was created from (e.g. "main"). */
34
+ baseRef: string;
35
+ /** Project hash for env-var injection. */
36
+ projectHash: string;
37
+ /** ISO 8601 timestamp when the worktree was created. */
38
+ createdAt: string;
39
+ /** Whether git worktree lock was applied to this entry. */
40
+ locked: boolean;
41
+ }
42
+
43
+ /**
44
+ * Result of creating a worktree during spawn.
45
+ *
46
+ * @task T1118
47
+ * @task T1120
48
+ */
49
+ export interface WorktreeSpawnResult {
50
+ /** The created worktree state. */
51
+ worktree: AgentWorktreeState;
52
+ /** Environment variables to inject into the agent's process. */
53
+ envVars: Record<string, string>;
54
+ /** CWD the agent MUST be started in. */
55
+ cwd: string;
56
+ /** Preamble text to prepend to the agent's spawn prompt. */
57
+ preamble: string;
58
+ }
59
+
60
+ /**
61
+ * Result from the orchestrate.worktree.complete operation.
62
+ *
63
+ * @task T1118
64
+ * @task T1120
65
+ */
66
+ export interface WorktreeCompleteResult {
67
+ /** Task ID that was completed. */
68
+ taskId: string;
69
+ /** Whether the cherry-pick succeeded. */
70
+ cherryPicked: boolean;
71
+ /** Number of commits cherry-picked. */
72
+ commitCount: number;
73
+ /** Whether the worktree was removed. */
74
+ worktreeRemoved: boolean;
75
+ /** Whether the task branch was deleted. */
76
+ branchDeleted: boolean;
77
+ /** Error message if any step failed (non-fatal — caller decides). */
78
+ error?: string;
79
+ }
80
+
81
+ /**
82
+ * Result from the orchestrate.worktree.cleanup operation.
83
+ *
84
+ * @task T1118
85
+ * @task T1120
86
+ */
87
+ export interface WorktreeCleanupResult {
88
+ /** Number of stale worktrees removed. */
89
+ removed: number;
90
+ /** Paths that were removed. */
91
+ removedPaths: string[];
92
+ /** Paths that failed to remove (with reasons). */
93
+ errors: Array<{ path: string; reason: string }>;
94
+ }
95
+
96
+ // ---------------------------------------------------------------------------
97
+ // L2 — Git shim contract types
98
+ // ---------------------------------------------------------------------------
99
+
100
+ /**
101
+ * Environment variables read by the cleo-git-shim binary.
102
+ *
103
+ * @task T1118
104
+ * @task T1121
105
+ */
106
+ export interface GitShimEnv {
107
+ /** Agent role. When set to worker|lead|subagent, branch-mutating ops are blocked. */
108
+ CLEO_AGENT_ROLE?: 'orchestrator' | 'worker' | 'lead' | 'subagent';
109
+ /** When set to "1", bypass the branch-mutation denylist for one command. */
110
+ CLEO_ALLOW_BRANCH_OPS?: '1';
111
+ /** Worktree root path — informational for shim error messages. */
112
+ CLEO_WORKTREE_ROOT?: string;
113
+ /** Branch protection mode. */
114
+ CLEO_BRANCH_PROTECTION?: 'strict' | 'permissive' | 'off';
115
+ }
116
+
117
+ /**
118
+ * A blocked git subcommand entry in the denylist.
119
+ *
120
+ * @task T1118
121
+ * @task T1121
122
+ */
123
+ export interface DeniedGitOp {
124
+ /** The git subcommand (e.g. "checkout"). */
125
+ subcommand: string;
126
+ /** Optional flag that triggers the denial (e.g. "--hard" for reset). */
127
+ flag?: string;
128
+ /** Human-readable reason shown in the shim's stderr output. */
129
+ reason: string;
130
+ }
131
+
132
+ // ---------------------------------------------------------------------------
133
+ // L3 — Filesystem hardening types
134
+ // ---------------------------------------------------------------------------
135
+
136
+ /**
137
+ * Platform capability report for filesystem hardening.
138
+ *
139
+ * @task T1118
140
+ * @task T1122
141
+ */
142
+ export interface FsHardenCapabilities {
143
+ /** Whether chmod is available (always true on POSIX). */
144
+ chmod: boolean;
145
+ /** Whether chattr is available (Linux ext2/3/4/xfs only). */
146
+ chattr: boolean;
147
+ /** Whether chflags is available (macOS). */
148
+ chflags: boolean;
149
+ /** Detected platform. */
150
+ platform: 'linux' | 'macos' | 'windows' | 'wsl' | 'unknown';
151
+ }
152
+
153
+ /**
154
+ * State of the filesystem hard-lock for the orchestrator's HEAD.
155
+ *
156
+ * @task T1118
157
+ * @task T1122
158
+ */
159
+ export interface FsHardenState {
160
+ /** Whether any lock is currently active. */
161
+ active: boolean;
162
+ /** Which mechanism was applied (chmod, chattr, or chflags). */
163
+ mechanism: 'chmod' | 'chattr' | 'chflags' | 'none';
164
+ /** Absolute path(s) that were locked. */
165
+ lockedPaths: string[];
166
+ /** ISO 8601 timestamp when the lock was applied. */
167
+ appliedAt?: string;
168
+ }
169
+
170
+ // ---------------------------------------------------------------------------
171
+ // L4 — Owner override authentication types
172
+ // ---------------------------------------------------------------------------
173
+
174
+ /**
175
+ * Record appended to force-bypass.jsonl when an override is used.
176
+ *
177
+ * Extends the base ForceBypassRecord with L4-specific authentication fields.
178
+ *
179
+ * @task T1118
180
+ * @task T1123
181
+ */
182
+ export interface OwnerOverrideAuditRecord {
183
+ /** ISO 8601 timestamp. */
184
+ timestamp: string;
185
+ /** Task ID being verified (may be "*" for session-level). */
186
+ taskId: string;
187
+ /** Gate being bypassed. */
188
+ gate: string;
189
+ /** Write action performed. */
190
+ action: string;
191
+ /** Agent ID that performed the bypass. */
192
+ agent_id: string;
193
+ /** Session ID. */
194
+ session_id: string | null;
195
+ /** Whether the HMAC token was validated (L4a). */
196
+ token_validated: boolean;
197
+ /** Whether TTY was present (L4c). */
198
+ tty_present: boolean;
199
+ /** Override count within the current session (L4d). */
200
+ override_count: number;
201
+ /** Webhook delivery status (L4d). */
202
+ webhook_delivered?: boolean;
203
+ /** Reason supplied by the operator. */
204
+ reason: string;
205
+ /** Process ID. */
206
+ pid: number;
207
+ }
208
+
209
+ /**
210
+ * Configuration for the owner override system.
211
+ *
212
+ * @task T1118
213
+ * @task T1123
214
+ */
215
+ export interface OwnerOverrideConfig {
216
+ /** Maximum number of overrides allowed per session (default: 3). */
217
+ maxPerSession: number;
218
+ /** Optional webhook URL to POST on each bypass. */
219
+ alertWebhook?: string;
220
+ }
221
+
222
+ // ---------------------------------------------------------------------------
223
+ // Error codes for branch-lock enforcement
224
+ // ---------------------------------------------------------------------------
225
+
226
+ /**
227
+ * Error codes emitted by the branch-lock + override-auth system.
228
+ *
229
+ * @task T1118
230
+ */
231
+ export const BRANCH_LOCK_ERROR_CODES = {
232
+ /** L2: git shim blocked a branch-mutating operation. */
233
+ E_GIT_OP_BLOCKED: 'E_GIT_OP_BLOCKED',
234
+ /** L1: spawn attempted without a worktree handle. */
235
+ E_WORKTREE_REQUIRED: 'E_WORKTREE_REQUIRED',
236
+ /** L1: worktree path does not exist or is not a valid git worktree. */
237
+ E_WORKTREE_INVALID: 'E_WORKTREE_INVALID',
238
+ /** L1: cherry-pick failed during worktree.complete. */
239
+ E_CHERRY_PICK_FAILED: 'E_CHERRY_PICK_FAILED',
240
+ /** L3: filesystem harden failed. */
241
+ E_FS_HARDEN_FAILED: 'E_FS_HARDEN_FAILED',
242
+ /** L4a: HMAC token invalid or missing. */
243
+ E_OVERRIDE_TOKEN_INVALID: 'E_OVERRIDE_TOKEN_INVALID',
244
+ /** L4b: caller has CLEO_AGENT_ROLE=worker|lead|subagent — override forbidden. */
245
+ E_OVERRIDE_FORBIDDEN_AGENT_ROLE: 'E_OVERRIDE_FORBIDDEN_AGENT_ROLE',
246
+ /** L4c: override requires TTY but stdin/stderr is not a TTY. */
247
+ E_OVERRIDE_NEEDS_TTY: 'E_OVERRIDE_NEEDS_TTY',
248
+ /** L4d: session override limit exceeded. */
249
+ E_OVERRIDE_RATE_LIMIT: 'E_OVERRIDE_RATE_LIMIT',
250
+ } as const;
251
+
252
+ /** Union of all branch-lock error code strings. */
253
+ export type BranchLockErrorCode =
254
+ (typeof BRANCH_LOCK_ERROR_CODES)[keyof typeof BRANCH_LOCK_ERROR_CODES];
package/src/index.ts CHANGED
@@ -144,6 +144,21 @@ export type {
144
144
  BrainStreamEvent,
145
145
  BrainSubstrate,
146
146
  } from './brain-graph.js';
147
+ export type {
148
+ AgentWorktreeState,
149
+ BranchLockErrorCode,
150
+ DeniedGitOp,
151
+ FsHardenCapabilities,
152
+ FsHardenState,
153
+ GitShimEnv,
154
+ OwnerOverrideAuditRecord,
155
+ OwnerOverrideConfig,
156
+ WorktreeCleanupResult,
157
+ WorktreeCompleteResult,
158
+ WorktreeSpawnResult,
159
+ } from './branch-lock.js';
160
+ // === Branch-Lock + Owner-Auth Types (T1118) ===
161
+ export { BRANCH_LOCK_ERROR_CODES } from './branch-lock.js';
147
162
  export type { AdapterCapabilities } from './capabilities.js';
148
163
  // === Code Symbol Types (tree-sitter AST) ===
149
164
  export type {
@@ -183,6 +198,7 @@ export type {
183
198
  LifecycleEnforcementMode,
184
199
  LoggingConfig,
185
200
  LogLevel,
201
+ MemoryBridgeMode,
186
202
  OutputConfig,
187
203
  OutputFormat,
188
204
  ProviderConfig,
@@ -410,7 +426,10 @@ export type {
410
426
  } from './nexus-tasks-bridge-ops.js';
411
427
  export type {
412
428
  CommunityWikiStats,
429
+ GenerateNexusWikiOptions,
413
430
  NexusWikiResult,
431
+ WikiDbHandle,
432
+ WikiStateFile,
414
433
  WikiSymbolRow,
415
434
  } from './nexus-wiki-ops.js';
416
435
  // === Operations Types (API wire format, namespaced to avoid collision with domain types) ===
@@ -5,6 +5,7 @@
5
5
  * from the nexus code graph.
6
6
  *
7
7
  * @task T1060
8
+ * @task T1109
8
9
  * @epic T1042
9
10
  */
10
11
 
@@ -34,6 +35,10 @@ export interface NexusWikiResult {
34
35
  communities: CommunityWikiStats[];
35
36
  /** Error message if success is false */
36
37
  error?: string;
38
+ /** IDs of communities that were skipped (incremental mode) */
39
+ skippedCommunities?: string[];
40
+ /** Whether LOOM LLM narrative was generated */
41
+ loomEnabled?: boolean;
37
42
  }
38
43
 
39
44
  /**
@@ -51,3 +56,78 @@ export interface WikiSymbolRow {
51
56
  /** Number of symbols this symbol calls */
52
57
  calleeCount: number;
53
58
  }
59
+
60
+ /**
61
+ * Subset of SQLite-compatible parameter values accepted by `DatabaseSync.prepare()`.
62
+ * Mirrors node:sqlite's `SQLInputValue` without importing from node internals.
63
+ */
64
+ export type WikiSqlParam = null | number | bigint | string | Uint8Array;
65
+
66
+ /**
67
+ * Minimal interface for an injectable SQLite database handle.
68
+ * Used in tests to provide an isolated in-memory or temp-file database
69
+ * instead of the real nexus.db singleton.
70
+ *
71
+ * Matches the subset of `DatabaseSync` (node:sqlite) used by the wiki generator.
72
+ */
73
+ export interface WikiDbHandle {
74
+ /**
75
+ * Prepare a SQL statement and return a statement object with
76
+ * `all(...params)` and `get(...params)` accessors.
77
+ * Compatible with both `DatabaseSync.prepare()` and test mocks.
78
+ */
79
+ prepare: (sql: string) => {
80
+ all: (...params: WikiSqlParam[]) => Record<string, WikiSqlParam>[];
81
+ get: (...params: WikiSqlParam[]) => Record<string, WikiSqlParam> | undefined;
82
+ };
83
+ }
84
+
85
+ /**
86
+ * Options for generating the nexus wiki index.
87
+ */
88
+ export interface GenerateNexusWikiOptions {
89
+ /**
90
+ * Filter generation to a single community ID.
91
+ * When set, only that community's markdown file is generated.
92
+ * The overview.md is NOT generated in single-community mode.
93
+ */
94
+ communityFilter?: string;
95
+ /**
96
+ * Enable incremental mode: use `cleo nexus diff` data to skip
97
+ * communities whose symbols have not changed since the last wiki run.
98
+ *
99
+ * Reads `.cleo/wiki-state.json` for the last-run commit SHA.
100
+ * On first run (no state file), performs a full generation and writes
101
+ * the state file.
102
+ */
103
+ incremental?: boolean;
104
+ /**
105
+ * LOOM provider function for generating narrative module summaries.
106
+ * Injected by the caller (CLI or test harness). When `null`, scaffold
107
+ * mode is used (no LLM narrative).
108
+ *
109
+ * Signature: `(prompt: string) => Promise<string>`
110
+ */
111
+ loomProvider?: ((prompt: string) => Promise<string>) | null;
112
+ /**
113
+ * Project root directory (used for resolving `.cleo/wiki-state.json`
114
+ * and running git operations). Defaults to `process.cwd()`.
115
+ */
116
+ projectRoot?: string;
117
+ /**
118
+ * Injectable database handle for testing.
119
+ * When provided, this handle is used instead of the real nexus.db singleton.
120
+ * Allows unit/integration tests to use isolated in-memory SQLite databases.
121
+ */
122
+ _dbForTesting?: WikiDbHandle;
123
+ }
124
+
125
+ /**
126
+ * State file persisted to `.cleo/wiki-state.json` for incremental mode.
127
+ */
128
+ export interface WikiStateFile {
129
+ /** Git commit SHA of the last full or incremental wiki generation run. */
130
+ lastRunCommit: string;
131
+ /** List of community IDs generated in the last run. */
132
+ generatedCommunities: string[];
133
+ }
@@ -202,6 +202,14 @@ export interface SessionStartParams {
202
202
  focus?: string;
203
203
  /** Enable full query+mutation audit logging for behavioral grading. */
204
204
  grade?: boolean;
205
+ /**
206
+ * HMAC-SHA256 owner-auth token for L4a override authentication (T1118).
207
+ *
208
+ * Derived from HMAC-SHA256(key=password, data=sessionId) during
209
+ * `cleo session start --owner-auth`. Stored in sessions.owner_auth_token
210
+ * and validated on every `CLEO_OWNER_OVERRIDE` call.
211
+ */
212
+ ownerAuthToken?: string;
205
213
  }
206
214
  /** Result of `session.start` — the newly created session. */
207
215
  export type SessionStartResult = Session;