@cleocode/adapters 2026.3.37 → 2026.3.40

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.
Files changed (234) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +503 -0
  3. package/dist/index.js +621 -496
  4. package/dist/index.js.map +4 -4
  5. package/package.json +12 -7
  6. package/src/__tests__/claude-code-adapter.test.d.ts +10 -0
  7. package/src/__tests__/claude-code-adapter.test.d.ts.map +1 -0
  8. package/src/__tests__/claude-code-adapter.test.js +192 -0
  9. package/src/__tests__/claude-code-adapter.test.js.map +1 -0
  10. package/src/__tests__/claude-code-adapter.test.ts +235 -0
  11. package/src/__tests__/cursor-adapter.test.d.ts +10 -0
  12. package/src/__tests__/cursor-adapter.test.d.ts.map +1 -0
  13. package/src/__tests__/cursor-adapter.test.js +196 -0
  14. package/src/__tests__/cursor-adapter.test.js.map +1 -0
  15. package/src/__tests__/cursor-adapter.test.ts +246 -0
  16. package/src/__tests__/opencode-adapter.test.d.ts +10 -0
  17. package/src/__tests__/opencode-adapter.test.d.ts.map +1 -0
  18. package/src/__tests__/opencode-adapter.test.js +204 -0
  19. package/src/__tests__/opencode-adapter.test.js.map +1 -0
  20. package/src/__tests__/opencode-adapter.test.ts +250 -0
  21. package/src/index.d.ts +28 -20
  22. package/src/index.d.ts.map +1 -1
  23. package/src/index.js +4 -19
  24. package/src/index.js.map +1 -1
  25. package/src/index.ts +25 -25
  26. package/src/providers/claude-code/__tests__/adapter.test.d.ts +1 -1
  27. package/src/providers/claude-code/__tests__/adapter.test.d.ts.map +0 -0
  28. package/src/providers/claude-code/__tests__/adapter.test.js +2 -2
  29. package/src/providers/claude-code/__tests__/adapter.test.js.map +1 -1
  30. package/src/providers/claude-code/__tests__/adapter.test.ts +2 -2
  31. package/src/providers/claude-code/adapter.d.ts +54 -50
  32. package/src/providers/claude-code/adapter.d.ts.map +0 -0
  33. package/src/providers/claude-code/adapter.js +1 -1
  34. package/src/providers/claude-code/adapter.js.map +1 -1
  35. package/src/providers/claude-code/adapter.ts +1 -1
  36. package/src/providers/claude-code/context-monitor.d.ts +6 -6
  37. package/src/providers/claude-code/context-monitor.d.ts.map +0 -0
  38. package/src/providers/claude-code/context-monitor.js +0 -0
  39. package/src/providers/claude-code/context-monitor.js.map +0 -0
  40. package/src/providers/claude-code/context-monitor.ts +0 -0
  41. package/src/providers/claude-code/hooks.d.ts +36 -36
  42. package/src/providers/claude-code/hooks.d.ts.map +0 -0
  43. package/src/providers/claude-code/hooks.js +0 -0
  44. package/src/providers/claude-code/hooks.js.map +0 -0
  45. package/src/providers/claude-code/hooks.ts +0 -0
  46. package/src/providers/claude-code/index.d.ts +6 -2
  47. package/src/providers/claude-code/index.d.ts.map +1 -1
  48. package/src/providers/claude-code/index.js +1 -1
  49. package/src/providers/claude-code/index.js.map +1 -1
  50. package/src/providers/claude-code/index.ts +2 -2
  51. package/src/providers/claude-code/install.d.ts +52 -52
  52. package/src/providers/claude-code/install.d.ts.map +1 -1
  53. package/src/providers/claude-code/install.js +1 -4
  54. package/src/providers/claude-code/install.js.map +1 -1
  55. package/src/providers/claude-code/install.ts +1 -4
  56. package/src/providers/claude-code/manifest.json +0 -0
  57. package/src/providers/claude-code/paths.d.ts +5 -5
  58. package/src/providers/claude-code/paths.d.ts.map +0 -0
  59. package/src/providers/claude-code/paths.js +0 -0
  60. package/src/providers/claude-code/paths.js.map +0 -0
  61. package/src/providers/claude-code/paths.ts +0 -0
  62. package/src/providers/claude-code/spawn.d.ts +37 -37
  63. package/src/providers/claude-code/spawn.d.ts.map +1 -1
  64. package/src/providers/claude-code/spawn.js +4 -0
  65. package/src/providers/claude-code/spawn.js.map +1 -1
  66. package/src/providers/claude-code/spawn.ts +5 -0
  67. package/src/providers/claude-code/statusline.d.ts +1 -2
  68. package/src/providers/claude-code/statusline.d.ts.map +0 -0
  69. package/src/providers/claude-code/statusline.js +2 -1
  70. package/src/providers/claude-code/statusline.js.map +1 -1
  71. package/src/providers/claude-code/statusline.ts +3 -3
  72. package/src/providers/claude-code/task-sync.js +1 -3
  73. package/src/providers/claude-code/task-sync.js.map +1 -1
  74. package/src/providers/claude-code/task-sync.ts +5 -22
  75. package/src/providers/claude-code/transport.d.ts +3 -3
  76. package/src/providers/claude-code/transport.d.ts.map +0 -0
  77. package/src/providers/claude-code/transport.js +0 -0
  78. package/src/providers/claude-code/transport.js.map +0 -0
  79. package/src/providers/claude-code/transport.ts +0 -0
  80. package/src/providers/cursor/__tests__/adapter.test.d.ts +1 -1
  81. package/src/providers/cursor/__tests__/adapter.test.d.ts.map +0 -0
  82. package/src/providers/cursor/__tests__/adapter.test.js +2 -2
  83. package/src/providers/cursor/__tests__/adapter.test.js.map +1 -1
  84. package/src/providers/cursor/__tests__/adapter.test.ts +2 -2
  85. package/src/providers/cursor/adapter.d.ts +44 -40
  86. package/src/providers/cursor/adapter.d.ts.map +0 -0
  87. package/src/providers/cursor/adapter.js +0 -0
  88. package/src/providers/cursor/adapter.js.map +0 -0
  89. package/src/providers/cursor/adapter.ts +0 -0
  90. package/src/providers/cursor/hooks.d.ts +29 -29
  91. package/src/providers/cursor/hooks.d.ts.map +0 -0
  92. package/src/providers/cursor/hooks.js +0 -0
  93. package/src/providers/cursor/hooks.js.map +0 -0
  94. package/src/providers/cursor/hooks.ts +0 -0
  95. package/src/providers/cursor/index.d.ts +1 -1
  96. package/src/providers/cursor/index.d.ts.map +0 -0
  97. package/src/providers/cursor/index.js +0 -0
  98. package/src/providers/cursor/index.js.map +0 -0
  99. package/src/providers/cursor/index.ts +0 -0
  100. package/src/providers/cursor/install.d.ts +67 -67
  101. package/src/providers/cursor/install.d.ts.map +1 -1
  102. package/src/providers/cursor/install.js +1 -4
  103. package/src/providers/cursor/install.js.map +1 -1
  104. package/src/providers/cursor/install.ts +1 -4
  105. package/src/providers/cursor/manifest.json +0 -0
  106. package/src/providers/cursor/spawn.d.ts +31 -31
  107. package/src/providers/cursor/spawn.d.ts.map +0 -0
  108. package/src/providers/cursor/spawn.js +0 -0
  109. package/src/providers/cursor/spawn.js.map +1 -1
  110. package/src/providers/cursor/spawn.ts +2 -2
  111. package/src/providers/opencode/__tests__/adapter.test.d.ts +1 -1
  112. package/src/providers/opencode/__tests__/adapter.test.d.ts.map +0 -0
  113. package/src/providers/opencode/__tests__/adapter.test.js +2 -2
  114. package/src/providers/opencode/__tests__/adapter.test.js.map +1 -1
  115. package/src/providers/opencode/__tests__/adapter.test.ts +2 -2
  116. package/src/providers/opencode/adapter.d.ts +50 -46
  117. package/src/providers/opencode/adapter.d.ts.map +0 -0
  118. package/src/providers/opencode/adapter.js +0 -0
  119. package/src/providers/opencode/adapter.js.map +0 -0
  120. package/src/providers/opencode/adapter.ts +0 -0
  121. package/src/providers/opencode/hooks.d.ts +36 -36
  122. package/src/providers/opencode/hooks.d.ts.map +0 -0
  123. package/src/providers/opencode/hooks.js +1 -1
  124. package/src/providers/opencode/hooks.js.map +1 -1
  125. package/src/providers/opencode/hooks.ts +1 -1
  126. package/src/providers/opencode/index.d.ts +2 -2
  127. package/src/providers/opencode/index.d.ts.map +1 -1
  128. package/src/providers/opencode/index.js +1 -1
  129. package/src/providers/opencode/index.js.map +1 -1
  130. package/src/providers/opencode/index.ts +1 -1
  131. package/src/providers/opencode/install.d.ts +46 -46
  132. package/src/providers/opencode/install.d.ts.map +1 -1
  133. package/src/providers/opencode/install.js +1 -4
  134. package/src/providers/opencode/install.js.map +1 -1
  135. package/src/providers/opencode/install.ts +1 -4
  136. package/src/providers/opencode/manifest.json +0 -0
  137. package/src/providers/opencode/spawn.d.ts +42 -39
  138. package/src/providers/opencode/spawn.d.ts.map +1 -1
  139. package/src/providers/opencode/spawn.js +0 -0
  140. package/src/providers/opencode/spawn.js.map +1 -1
  141. package/src/providers/opencode/spawn.ts +2 -7
  142. package/src/registry.d.ts +12 -12
  143. package/src/registry.d.ts.map +1 -1
  144. package/src/registry.js +0 -0
  145. package/src/registry.js.map +1 -1
  146. package/src/registry.ts +1 -3
  147. package/dist/index.d.ts +0 -27
  148. package/dist/index.d.ts.map +0 -1
  149. package/dist/providers/claude-code/adapter.d.ts +0 -75
  150. package/dist/providers/claude-code/adapter.d.ts.map +0 -1
  151. package/dist/providers/claude-code/adapter.js +0 -154
  152. package/dist/providers/claude-code/adapter.js.map +0 -1
  153. package/dist/providers/claude-code/context-monitor.d.ts +0 -24
  154. package/dist/providers/claude-code/context-monitor.d.ts.map +0 -1
  155. package/dist/providers/claude-code/context-monitor.js +0 -148
  156. package/dist/providers/claude-code/context-monitor.js.map +0 -1
  157. package/dist/providers/claude-code/hooks.d.ts +0 -59
  158. package/dist/providers/claude-code/hooks.d.ts.map +0 -1
  159. package/dist/providers/claude-code/hooks.js +0 -77
  160. package/dist/providers/claude-code/hooks.js.map +0 -1
  161. package/dist/providers/claude-code/index.d.ts +0 -24
  162. package/dist/providers/claude-code/index.d.ts.map +0 -1
  163. package/dist/providers/claude-code/index.js +0 -26
  164. package/dist/providers/claude-code/index.js.map +0 -1
  165. package/dist/providers/claude-code/install.d.ts +0 -75
  166. package/dist/providers/claude-code/install.d.ts.map +0 -1
  167. package/dist/providers/claude-code/install.js +0 -237
  168. package/dist/providers/claude-code/install.js.map +0 -1
  169. package/dist/providers/claude-code/paths.d.ts +0 -24
  170. package/dist/providers/claude-code/paths.d.ts.map +0 -1
  171. package/dist/providers/claude-code/paths.js +0 -33
  172. package/dist/providers/claude-code/paths.js.map +0 -1
  173. package/dist/providers/claude-code/spawn.d.ts +0 -60
  174. package/dist/providers/claude-code/spawn.d.ts.map +0 -1
  175. package/dist/providers/claude-code/spawn.js +0 -160
  176. package/dist/providers/claude-code/spawn.js.map +0 -1
  177. package/dist/providers/claude-code/statusline.d.ts +0 -24
  178. package/dist/providers/claude-code/statusline.d.ts.map +0 -1
  179. package/dist/providers/claude-code/statusline.js +0 -85
  180. package/dist/providers/claude-code/statusline.js.map +0 -1
  181. package/dist/providers/claude-code/task-sync.d.ts +0 -27
  182. package/dist/providers/claude-code/task-sync.d.ts.map +0 -1
  183. package/dist/providers/claude-code/task-sync.js +0 -124
  184. package/dist/providers/claude-code/task-sync.js.map +0 -1
  185. package/dist/providers/claude-code/transport.d.ts +0 -14
  186. package/dist/providers/claude-code/transport.d.ts.map +0 -1
  187. package/dist/providers/claude-code/transport.js +0 -18
  188. package/dist/providers/claude-code/transport.js.map +0 -1
  189. package/dist/providers/cursor/adapter.d.ts +0 -62
  190. package/dist/providers/cursor/adapter.d.ts.map +0 -1
  191. package/dist/providers/cursor/adapter.js +0 -124
  192. package/dist/providers/cursor/adapter.js.map +0 -1
  193. package/dist/providers/cursor/hooks.d.ts +0 -48
  194. package/dist/providers/cursor/hooks.d.ts.map +0 -1
  195. package/dist/providers/cursor/hooks.js +0 -55
  196. package/dist/providers/cursor/hooks.js.map +0 -1
  197. package/dist/providers/cursor/index.d.ts +0 -19
  198. package/dist/providers/cursor/index.d.ts.map +0 -1
  199. package/dist/providers/cursor/index.js +0 -21
  200. package/dist/providers/cursor/index.js.map +0 -1
  201. package/dist/providers/cursor/install.d.ts +0 -94
  202. package/dist/providers/cursor/install.d.ts.map +0 -1
  203. package/dist/providers/cursor/install.js +0 -241
  204. package/dist/providers/cursor/install.js.map +0 -1
  205. package/dist/providers/cursor/spawn.d.ts +0 -50
  206. package/dist/providers/cursor/spawn.d.ts.map +0 -1
  207. package/dist/providers/cursor/spawn.js +0 -59
  208. package/dist/providers/cursor/spawn.js.map +0 -1
  209. package/dist/providers/opencode/adapter.d.ts +0 -67
  210. package/dist/providers/opencode/adapter.d.ts.map +0 -1
  211. package/dist/providers/opencode/adapter.js +0 -144
  212. package/dist/providers/opencode/adapter.js.map +0 -1
  213. package/dist/providers/opencode/hooks.d.ts +0 -66
  214. package/dist/providers/opencode/hooks.d.ts.map +0 -1
  215. package/dist/providers/opencode/hooks.js +0 -89
  216. package/dist/providers/opencode/hooks.js.map +0 -1
  217. package/dist/providers/opencode/index.d.ts +0 -20
  218. package/dist/providers/opencode/index.d.ts.map +0 -1
  219. package/dist/providers/opencode/index.js +0 -22
  220. package/dist/providers/opencode/index.js.map +0 -1
  221. package/dist/providers/opencode/install.d.ts +0 -65
  222. package/dist/providers/opencode/install.d.ts.map +0 -1
  223. package/dist/providers/opencode/install.js +0 -183
  224. package/dist/providers/opencode/install.js.map +0 -1
  225. package/dist/providers/opencode/spawn.d.ts +0 -72
  226. package/dist/providers/opencode/spawn.d.ts.map +0 -1
  227. package/dist/providers/opencode/spawn.js +0 -219
  228. package/dist/providers/opencode/spawn.js.map +0 -1
  229. package/dist/registry.d.ts +0 -36
  230. package/dist/registry.d.ts.map +0 -1
  231. package/dist/registry.js +0 -55
  232. package/dist/registry.js.map +0 -1
  233. package/src/providers/claude-code/task-sync.d.ts +0 -27
  234. package/src/providers/claude-code/task-sync.d.ts.map +0 -1
@@ -1,148 +0,0 @@
1
- /**
2
- * Claude Code context monitor provider.
3
- *
4
- * Implements AdapterContextMonitorProvider for Claude Code's context window
5
- * tracking and statusline integration.
6
- *
7
- * @task T5240
8
- */
9
- import { existsSync, readFileSync, writeFileSync } from 'node:fs';
10
- import { mkdir } from 'node:fs/promises';
11
- import { homedir } from 'node:os';
12
- import { dirname, join } from 'node:path';
13
- import { ClaudeCodePathProvider } from './paths.js';
14
- /** Thresholds for context window status levels. */
15
- const THRESHOLDS = {
16
- WARNING: 50,
17
- CAUTION: 70,
18
- CRITICAL: 85,
19
- EMERGENCY: 95,
20
- };
21
- function getContextStatusFromPercentage(percentage) {
22
- if (percentage >= THRESHOLDS.EMERGENCY)
23
- return 'emergency';
24
- if (percentage >= THRESHOLDS.CRITICAL)
25
- return 'critical';
26
- if (percentage >= THRESHOLDS.CAUTION)
27
- return 'caution';
28
- if (percentage >= THRESHOLDS.WARNING)
29
- return 'warning';
30
- return 'ok';
31
- }
32
- /**
33
- * Context monitor provider for Claude Code.
34
- *
35
- * Processes context window JSON from Claude Code and writes state files
36
- * for statusline display. Also provides statusline configuration
37
- * and setup instructions specific to Claude Code's settings.json.
38
- */
39
- export class ClaudeCodeContextMonitorProvider {
40
- pathProvider = new ClaudeCodePathProvider();
41
- async processContextInput(input, cwd) {
42
- const typed = input;
43
- const contextSize = typed.context_window?.context_window_size ?? 200000;
44
- const usage = typed.context_window?.current_usage;
45
- if (!usage)
46
- return '-- no data';
47
- const inputTokens = usage.input_tokens ?? 0;
48
- const outputTokens = usage.output_tokens ?? 0;
49
- const cacheCreate = usage.cache_creation_input_tokens ?? 0;
50
- const totalTokens = inputTokens + outputTokens + cacheCreate;
51
- const percentage = Math.floor((totalTokens * 100) / contextSize);
52
- const status = getContextStatusFromPercentage(percentage);
53
- // Write state file if CLEO dir exists
54
- const cleoDir = cwd ? join(cwd, '.cleo') : '.cleo';
55
- if (existsSync(cleoDir)) {
56
- const stateDir = join(cleoDir, 'context-states');
57
- const statePath = join(stateDir, '.context-state.json');
58
- const state = {
59
- $schema: 'https://cleo-dev.com/schemas/v1/context-state.schema.json',
60
- version: '1.0.0',
61
- timestamp: new Date().toISOString().replace(/\.\d{3}Z$/, 'Z'),
62
- staleAfterMs: 5000,
63
- contextWindow: {
64
- maxTokens: contextSize,
65
- currentTokens: totalTokens,
66
- percentage,
67
- breakdown: {
68
- inputTokens,
69
- outputTokens,
70
- cacheCreationTokens: cacheCreate,
71
- cacheReadTokens: usage.cache_read_input_tokens ?? 0,
72
- },
73
- },
74
- thresholds: {
75
- warning: THRESHOLDS.WARNING,
76
- caution: THRESHOLDS.CAUTION,
77
- critical: THRESHOLDS.CRITICAL,
78
- emergency: THRESHOLDS.EMERGENCY,
79
- },
80
- status,
81
- cleoSessionId: '',
82
- };
83
- try {
84
- await mkdir(dirname(statePath), { recursive: true });
85
- writeFileSync(statePath, JSON.stringify(state, null, 2));
86
- }
87
- catch {
88
- // Non-fatal
89
- }
90
- }
91
- return `${percentage}% | ${totalTokens}/${contextSize}`;
92
- }
93
- checkStatuslineIntegration() {
94
- const settingsPath = this.pathProvider.getSettingsPath();
95
- if (!settingsPath || !existsSync(settingsPath))
96
- return 'no_settings';
97
- try {
98
- const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
99
- const statusLine = settings.statusLine;
100
- if (!statusLine?.type)
101
- return 'not_configured';
102
- if (statusLine.type !== 'command')
103
- return 'custom_no_cleo';
104
- const cmd = statusLine.command ?? '';
105
- if (cmd.includes('context-monitor.sh') ||
106
- cmd.includes('cleo-statusline') ||
107
- cmd.includes('.context-state.json') ||
108
- cmd.includes('context-states')) {
109
- return 'configured';
110
- }
111
- const scriptPath = cmd.startsWith('~') ? cmd.replace('~', homedir()) : cmd;
112
- if (existsSync(scriptPath)) {
113
- try {
114
- const content = readFileSync(scriptPath, 'utf-8');
115
- if (content.includes('context-state.json'))
116
- return 'configured';
117
- }
118
- catch {
119
- /* unreadable */
120
- }
121
- }
122
- return 'custom_no_cleo';
123
- }
124
- catch {
125
- return 'no_settings';
126
- }
127
- }
128
- getStatuslineConfig() {
129
- return {
130
- statusLine: {
131
- type: 'command',
132
- command: join(homedir(), '.cleo', 'lib', 'session', 'context-monitor.sh'),
133
- },
134
- };
135
- }
136
- getSetupInstructions() {
137
- const settingsPath = this.pathProvider.getSettingsPath() ?? '~/.claude/settings.json';
138
- return [
139
- 'To enable context monitoring, add to your Claude Code settings:',
140
- `File: ${settingsPath}`,
141
- '',
142
- JSON.stringify(this.getStatuslineConfig(), null, 2),
143
- '',
144
- 'This enables real-time context window tracking in the CLI.',
145
- ].join('\n');
146
- }
147
- }
148
- //# sourceMappingURL=context-monitor.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"context-monitor.js","sourceRoot":"","sources":["../../../src/providers/claude-code/context-monitor.ts"],"names":[],"mappings":"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"}
@@ -1,59 +0,0 @@
1
- /**
2
- * Claude Code Hook Provider
3
- *
4
- * Maps Claude Code's native hook events to CAAMP hook events.
5
- * Claude Code uses: SessionStart, PostToolUse, UserPromptSubmit, Stop
6
- * CAAMP defines: onSessionStart, onToolComplete, onPromptSubmit, onSessionEnd
7
- *
8
- * @task T5240
9
- */
10
- import type { AdapterHookProvider } from '@cleocode/contracts';
11
- /**
12
- * Hook provider for Claude Code.
13
- *
14
- * Claude Code registers hooks via a plugin directory
15
- * with a hooks.json descriptor. The actual hook scripts are shell scripts
16
- * that invoke CLEO's brain observation system.
17
- *
18
- * Since hooks are registered through the plugin system (installed via
19
- * the install provider), registerNativeHooks and unregisterNativeHooks
20
- * are effectively no-ops here — the plugin installer handles registration.
21
- */
22
- export declare class ClaudeCodeHookProvider implements AdapterHookProvider {
23
- private registered;
24
- /**
25
- * Map a Claude Code native event name to a CAAMP hook event name.
26
- *
27
- * @param providerEvent - Claude Code event name (e.g. "SessionStart", "PostToolUse")
28
- * @returns CAAMP event name or null if unmapped
29
- */
30
- mapProviderEvent(providerEvent: string): string | null;
31
- /**
32
- * Register native hooks for a project.
33
- *
34
- * For Claude Code, hooks are registered via the plugin system
35
- * (hooks.json descriptor), which is handled by the
36
- * install provider. This method is a no-op since registration
37
- * is managed through the plugin install lifecycle.
38
- *
39
- * @param _projectDir - Project directory (unused; hooks are global)
40
- */
41
- registerNativeHooks(_projectDir: string): Promise<void>;
42
- /**
43
- * Unregister native hooks.
44
- *
45
- * For Claude Code, this is a no-op since hooks are managed through
46
- * the plugin system. Unregistration happens via the install provider's
47
- * uninstall method.
48
- */
49
- unregisterNativeHooks(): Promise<void>;
50
- /**
51
- * Check whether hooks have been registered via registerNativeHooks.
52
- */
53
- isRegistered(): boolean;
54
- /**
55
- * Get the full event mapping for introspection/debugging.
56
- */
57
- getEventMap(): Readonly<Record<string, string>>;
58
- }
59
- //# sourceMappingURL=hooks.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAY/D;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;OAKG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;OASG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;OAMG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAGhD"}
@@ -1,77 +0,0 @@
1
- /**
2
- * Claude Code Hook Provider
3
- *
4
- * Maps Claude Code's native hook events to CAAMP hook events.
5
- * Claude Code uses: SessionStart, PostToolUse, UserPromptSubmit, Stop
6
- * CAAMP defines: onSessionStart, onToolComplete, onPromptSubmit, onSessionEnd
7
- *
8
- * @task T5240
9
- */
10
- /**
11
- * Mapping from Claude Code native event names to CAAMP event names.
12
- */
13
- const CLAUDE_CODE_EVENT_MAP = {
14
- SessionStart: 'onSessionStart',
15
- PostToolUse: 'onToolComplete',
16
- UserPromptSubmit: 'onPromptSubmit',
17
- Stop: 'onSessionEnd',
18
- };
19
- /**
20
- * Hook provider for Claude Code.
21
- *
22
- * Claude Code registers hooks via a plugin directory
23
- * with a hooks.json descriptor. The actual hook scripts are shell scripts
24
- * that invoke CLEO's brain observation system.
25
- *
26
- * Since hooks are registered through the plugin system (installed via
27
- * the install provider), registerNativeHooks and unregisterNativeHooks
28
- * are effectively no-ops here — the plugin installer handles registration.
29
- */
30
- export class ClaudeCodeHookProvider {
31
- registered = false;
32
- /**
33
- * Map a Claude Code native event name to a CAAMP hook event name.
34
- *
35
- * @param providerEvent - Claude Code event name (e.g. "SessionStart", "PostToolUse")
36
- * @returns CAAMP event name or null if unmapped
37
- */
38
- mapProviderEvent(providerEvent) {
39
- return CLAUDE_CODE_EVENT_MAP[providerEvent] ?? null;
40
- }
41
- /**
42
- * Register native hooks for a project.
43
- *
44
- * For Claude Code, hooks are registered via the plugin system
45
- * (hooks.json descriptor), which is handled by the
46
- * install provider. This method is a no-op since registration
47
- * is managed through the plugin install lifecycle.
48
- *
49
- * @param _projectDir - Project directory (unused; hooks are global)
50
- */
51
- async registerNativeHooks(_projectDir) {
52
- this.registered = true;
53
- }
54
- /**
55
- * Unregister native hooks.
56
- *
57
- * For Claude Code, this is a no-op since hooks are managed through
58
- * the plugin system. Unregistration happens via the install provider's
59
- * uninstall method.
60
- */
61
- async unregisterNativeHooks() {
62
- this.registered = false;
63
- }
64
- /**
65
- * Check whether hooks have been registered via registerNativeHooks.
66
- */
67
- isRegistered() {
68
- return this.registered;
69
- }
70
- /**
71
- * Get the full event mapping for introspection/debugging.
72
- */
73
- getEventMap() {
74
- return { ...CLAUDE_CODE_EVENT_MAP };
75
- }
76
- }
77
- //# sourceMappingURL=hooks.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,qBAAqB,GAA2B;IACpD,YAAY,EAAE,gBAAgB;IAC9B,WAAW,EAAE,gBAAgB;IAC7B,gBAAgB,EAAE,gBAAgB;IAClC,IAAI,EAAE,cAAc;CACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,sBAAsB;IACzB,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;OAKG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,qBAAqB,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IACtD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACtC,CAAC;CACF"}
@@ -1,24 +0,0 @@
1
- /**
2
- * Claude Code provider adapter.
3
- *
4
- * CLEO provider adapter for Anthropic Claude Code CLI.
5
- * Default export is the adapter class for dynamic loading by AdapterManager.
6
- *
7
- * @task T5240
8
- */
9
- import { ClaudeCodeAdapter } from './adapter.js';
10
- export { ClaudeCodeAdapter } from './adapter.js';
11
- export { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
12
- export { ClaudeCodeHookProvider } from './hooks.js';
13
- export { ClaudeCodeInstallProvider } from './install.js';
14
- export { ClaudeCodePathProvider } from './paths.js';
15
- export { ClaudeCodeSpawnProvider } from './spawn.js';
16
- export { ClaudeCodeTransportProvider } from './transport.js';
17
- export { checkStatuslineIntegration, getStatuslineConfig, getSetupInstructions, } from './statusline.js';
18
- export default ClaudeCodeAdapter;
19
- /**
20
- * Factory function for creating adapter instances.
21
- * Used by AdapterManager's dynamic import fallback.
22
- */
23
- export declare function createAdapter(): ClaudeCodeAdapter;
24
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,eAAe,iBAAiB,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CAEjD"}
@@ -1,26 +0,0 @@
1
- /**
2
- * Claude Code provider adapter.
3
- *
4
- * CLEO provider adapter for Anthropic Claude Code CLI.
5
- * Default export is the adapter class for dynamic loading by AdapterManager.
6
- *
7
- * @task T5240
8
- */
9
- import { ClaudeCodeAdapter } from './adapter.js';
10
- export { ClaudeCodeAdapter } from './adapter.js';
11
- export { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
12
- export { ClaudeCodeHookProvider } from './hooks.js';
13
- export { ClaudeCodeInstallProvider } from './install.js';
14
- export { ClaudeCodePathProvider } from './paths.js';
15
- export { ClaudeCodeSpawnProvider } from './spawn.js';
16
- export { ClaudeCodeTransportProvider } from './transport.js';
17
- export { checkStatuslineIntegration, getStatuslineConfig, getSetupInstructions, } from './statusline.js';
18
- export default ClaudeCodeAdapter;
19
- /**
20
- * Factory function for creating adapter instances.
21
- * Used by AdapterManager's dynamic import fallback.
22
- */
23
- export function createAdapter() {
24
- return new ClaudeCodeAdapter();
25
- }
26
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/claude-code/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,eAAe,iBAAiB,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,iBAAiB,EAAE,CAAC;AACjC,CAAC"}
@@ -1,75 +0,0 @@
1
- /**
2
- * Claude Code Install Provider
3
- *
4
- * Handles CLEO installation into Claude Code environments:
5
- * - Registers CLEO MCP server in .mcp.json
6
- * - Ensures CLAUDE.md has CLEO @-references
7
- * - Manages plugin registration in ~/.claude/settings.json
8
- *
9
- * Migrated from src/core/install/claude-plugin.ts
10
- *
11
- * @task T5240
12
- */
13
- import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
14
- /**
15
- * Install provider for Claude Code.
16
- *
17
- * Manages CLEO's integration with Claude Code by:
18
- * 1. Registering the CLEO MCP server in the project's .mcp.json
19
- * 2. Ensuring CLAUDE.md contains @-references to CLEO instruction files
20
- * 3. Registering the brain observation plugin in ~/.claude/settings.json
21
- */
22
- export declare class ClaudeCodeInstallProvider implements AdapterInstallProvider {
23
- private installedProjectDir;
24
- /**
25
- * Install CLEO into a Claude Code project.
26
- *
27
- * @param options - Installation options including project directory and MCP server path
28
- * @returns Result describing what was installed
29
- */
30
- install(options: InstallOptions): Promise<InstallResult>;
31
- /**
32
- * Uninstall CLEO from the current Claude Code project.
33
- *
34
- * Removes the MCP server registration from .mcp.json.
35
- * Does not remove CLAUDE.md references (they are harmless if CLEO is not present).
36
- */
37
- uninstall(): Promise<void>;
38
- /**
39
- * Check whether CLEO is installed in the current environment.
40
- *
41
- * Checks for:
42
- * 1. MCP server registered in .mcp.json
43
- * 2. Plugin enabled in ~/.claude/settings.json
44
- *
45
- * Returns true if either condition is met (partial install counts).
46
- */
47
- isInstalled(): Promise<boolean>;
48
- /**
49
- * Ensure CLAUDE.md contains @-references to CLEO instruction files.
50
- *
51
- * Creates CLAUDE.md if it does not exist. Appends any missing references.
52
- *
53
- * @param projectDir - Project root directory
54
- */
55
- ensureInstructionReferences(projectDir: string): Promise<void>;
56
- /**
57
- * Register the CLEO MCP server in .mcp.json.
58
- *
59
- * @returns true if registration was performed or updated
60
- */
61
- private registerMcpServer;
62
- /**
63
- * Update CLAUDE.md with CLEO @-references.
64
- *
65
- * @returns true if the file was created or modified
66
- */
67
- private updateInstructionFile;
68
- /**
69
- * Register the CLEO brain plugin in ~/.claude/settings.json.
70
- *
71
- * @returns Description of what was registered, or null if no change needed
72
- */
73
- private registerPlugin;
74
- }
75
- //# sourceMappingURL=install.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWjG;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAsC9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBhC;;;;;;;;OAQG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgCrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAiCvB"}
@@ -1,237 +0,0 @@
1
- /**
2
- * Claude Code Install Provider
3
- *
4
- * Handles CLEO installation into Claude Code environments:
5
- * - Registers CLEO MCP server in .mcp.json
6
- * - Ensures CLAUDE.md has CLEO @-references
7
- * - Manages plugin registration in ~/.claude/settings.json
8
- *
9
- * Migrated from src/core/install/claude-plugin.ts
10
- *
11
- * @task T5240
12
- */
13
- import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
14
- import { homedir } from 'node:os';
15
- import { join } from 'node:path';
16
- /** Lines that should appear in CLAUDE.md to reference CLEO. */
17
- const INSTRUCTION_REFERENCES = [
18
- '@~/.cleo/templates/CLEO-INJECTION.md',
19
- '@.cleo/memory-bridge.md',
20
- ];
21
- /** MCP server registration key used in .mcp.json. */
22
- const MCP_SERVER_KEY = 'cleo';
23
- /**
24
- * Install provider for Claude Code.
25
- *
26
- * Manages CLEO's integration with Claude Code by:
27
- * 1. Registering the CLEO MCP server in the project's .mcp.json
28
- * 2. Ensuring CLAUDE.md contains @-references to CLEO instruction files
29
- * 3. Registering the brain observation plugin in ~/.claude/settings.json
30
- */
31
- export class ClaudeCodeInstallProvider {
32
- installedProjectDir = null;
33
- /**
34
- * Install CLEO into a Claude Code project.
35
- *
36
- * @param options - Installation options including project directory and MCP server path
37
- * @returns Result describing what was installed
38
- */
39
- async install(options) {
40
- const { projectDir, mcpServerPath } = options;
41
- const installedAt = new Date().toISOString();
42
- let instructionFileUpdated = false;
43
- let mcpRegistered = false;
44
- const details = {};
45
- // Step 1: Register MCP server in .mcp.json
46
- if (mcpServerPath) {
47
- mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
48
- if (mcpRegistered) {
49
- details.mcpConfigPath = join(projectDir, '.mcp.json');
50
- }
51
- }
52
- // Step 2: Ensure CLAUDE.md has @-references
53
- instructionFileUpdated = this.updateInstructionFile(projectDir);
54
- if (instructionFileUpdated) {
55
- details.instructionFile = join(projectDir, 'CLAUDE.md');
56
- }
57
- // Step 3: Register plugin in ~/.claude/settings.json
58
- const pluginResult = this.registerPlugin();
59
- if (pluginResult) {
60
- details.plugin = pluginResult;
61
- }
62
- this.installedProjectDir = projectDir;
63
- return {
64
- success: true,
65
- installedAt,
66
- instructionFileUpdated,
67
- mcpRegistered,
68
- details,
69
- };
70
- }
71
- /**
72
- * Uninstall CLEO from the current Claude Code project.
73
- *
74
- * Removes the MCP server registration from .mcp.json.
75
- * Does not remove CLAUDE.md references (they are harmless if CLEO is not present).
76
- */
77
- async uninstall() {
78
- if (!this.installedProjectDir)
79
- return;
80
- const mcpPath = join(this.installedProjectDir, '.mcp.json');
81
- if (existsSync(mcpPath)) {
82
- try {
83
- const raw = readFileSync(mcpPath, 'utf-8');
84
- const config = JSON.parse(raw);
85
- const mcpServers = config.mcpServers;
86
- if (mcpServers && MCP_SERVER_KEY in mcpServers) {
87
- delete mcpServers[MCP_SERVER_KEY];
88
- writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
89
- }
90
- }
91
- catch {
92
- // Ignore errors during uninstall
93
- }
94
- }
95
- this.installedProjectDir = null;
96
- }
97
- /**
98
- * Check whether CLEO is installed in the current environment.
99
- *
100
- * Checks for:
101
- * 1. MCP server registered in .mcp.json
102
- * 2. Plugin enabled in ~/.claude/settings.json
103
- *
104
- * Returns true if either condition is met (partial install counts).
105
- */
106
- async isInstalled() {
107
- // Check ~/.claude/settings.json for plugin registration
108
- const settingsPath = join(homedir(), '.claude', 'settings.json');
109
- if (existsSync(settingsPath)) {
110
- try {
111
- const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
112
- const plugins = settings.enabledPlugins;
113
- if (plugins && plugins['cleo@cleocode'] === true) {
114
- return true;
115
- }
116
- }
117
- catch {
118
- // Fall through
119
- }
120
- }
121
- // Check current directory for .mcp.json with cleo server
122
- const mcpPath = join(process.cwd(), '.mcp.json');
123
- if (existsSync(mcpPath)) {
124
- try {
125
- const config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
126
- const mcpServers = config.mcpServers;
127
- if (mcpServers && MCP_SERVER_KEY in mcpServers) {
128
- return true;
129
- }
130
- }
131
- catch {
132
- // Fall through
133
- }
134
- }
135
- return false;
136
- }
137
- /**
138
- * Ensure CLAUDE.md contains @-references to CLEO instruction files.
139
- *
140
- * Creates CLAUDE.md if it does not exist. Appends any missing references.
141
- *
142
- * @param projectDir - Project root directory
143
- */
144
- async ensureInstructionReferences(projectDir) {
145
- this.updateInstructionFile(projectDir);
146
- }
147
- /**
148
- * Register the CLEO MCP server in .mcp.json.
149
- *
150
- * @returns true if registration was performed or updated
151
- */
152
- registerMcpServer(projectDir, mcpServerPath) {
153
- const mcpPath = join(projectDir, '.mcp.json');
154
- let config = {};
155
- if (existsSync(mcpPath)) {
156
- try {
157
- config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
158
- }
159
- catch {
160
- // Start fresh on parse error
161
- }
162
- }
163
- if (!config.mcpServers || typeof config.mcpServers !== 'object') {
164
- config.mcpServers = {};
165
- }
166
- const mcpServers = config.mcpServers;
167
- mcpServers[MCP_SERVER_KEY] = {
168
- command: 'node',
169
- args: [mcpServerPath],
170
- };
171
- writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
172
- return true;
173
- }
174
- /**
175
- * Update CLAUDE.md with CLEO @-references.
176
- *
177
- * @returns true if the file was created or modified
178
- */
179
- updateInstructionFile(projectDir) {
180
- const claudeMdPath = join(projectDir, 'CLAUDE.md');
181
- let content = '';
182
- let existed = false;
183
- if (existsSync(claudeMdPath)) {
184
- content = readFileSync(claudeMdPath, 'utf-8');
185
- existed = true;
186
- }
187
- const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
188
- if (missingRefs.length === 0) {
189
- return false;
190
- }
191
- const refsBlock = missingRefs.join('\n');
192
- if (existed) {
193
- // Append missing references
194
- const separator = content.endsWith('\n') ? '' : '\n';
195
- content = content + separator + refsBlock + '\n';
196
- }
197
- else {
198
- // Create new CLAUDE.md with references
199
- content = refsBlock + '\n';
200
- }
201
- writeFileSync(claudeMdPath, content, 'utf-8');
202
- return true;
203
- }
204
- /**
205
- * Register the CLEO brain plugin in ~/.claude/settings.json.
206
- *
207
- * @returns Description of what was registered, or null if no change needed
208
- */
209
- registerPlugin() {
210
- const home = homedir();
211
- const settingsPath = join(home, '.claude', 'settings.json');
212
- let settings = {};
213
- if (existsSync(settingsPath)) {
214
- try {
215
- settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
216
- }
217
- catch {
218
- // Start fresh
219
- }
220
- }
221
- const enabledPlugins = settings.enabledPlugins ?? {};
222
- const pluginKey = 'cleo@cleocode';
223
- if (enabledPlugins[pluginKey] === true) {
224
- return null;
225
- }
226
- // Disable old claude-mem if present
227
- if (enabledPlugins['claude-mem@thedotmack'] === true) {
228
- enabledPlugins['claude-mem@thedotmack'] = false;
229
- }
230
- enabledPlugins[pluginKey] = true;
231
- settings.enabledPlugins = enabledPlugins;
232
- mkdirSync(join(home, '.claude'), { recursive: true });
233
- writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
234
- return `Enabled ${pluginKey} in ~/.claude/settings.json`;
235
- }
236
- }
237
- //# sourceMappingURL=install.js.map