@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.
- package/dist/branch-lock.d.ts +225 -0
- package/dist/branch-lock.d.ts.map +1 -0
- package/dist/branch-lock.js +43 -0
- package/dist/branch-lock.js.map +1 -0
- package/dist/index.d.ts +4 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/nexus-wiki-ops.d.ts +76 -0
- package/dist/nexus-wiki-ops.d.ts.map +1 -1
- package/dist/nexus-wiki-ops.js +1 -0
- package/dist/nexus-wiki-ops.js.map +1 -1
- package/dist/operations/session.d.ts +8 -0
- package/dist/operations/session.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/branch-lock.ts +254 -0
- package/src/index.ts +19 -0
- package/src/nexus-wiki-ops.ts +80 -0
- package/src/operations/session.ts +8 -0
|
@@ -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';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -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;
|
|
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"}
|
package/dist/nexus-wiki-ops.d.ts
CHANGED
|
@@ -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
|
|
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"}
|
package/dist/nexus-wiki-ops.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"nexus-wiki-ops.js","sourceRoot":"","sources":["../src/nexus-wiki-ops.ts"],"names":[],"mappings":"AAAA
|
|
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
|
@@ -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) ===
|
package/src/nexus-wiki-ops.ts
CHANGED
|
@@ -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;
|