@cleocode/adapters 2026.4.11 → 2026.4.13

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 (159) hide show
  1. package/package.json +3 -3
  2. package/src/__tests__/claude-code-adapter.test.ts +1 -3
  3. package/src/__tests__/cursor-adapter.test.ts +1 -3
  4. package/src/__tests__/opencode-adapter.test.ts +1 -3
  5. package/src/providers/claude-code/__tests__/adapter.test.ts +0 -12
  6. package/src/providers/claude-code/adapter.ts +0 -1
  7. package/src/providers/claude-code/install.ts +0 -1
  8. package/src/providers/codex/adapter.ts +0 -1
  9. package/src/providers/codex/install.ts +0 -1
  10. package/src/providers/cursor/__tests__/adapter.test.ts +0 -12
  11. package/src/providers/cursor/adapter.ts +0 -1
  12. package/src/providers/cursor/install.ts +0 -1
  13. package/src/providers/gemini-cli/adapter.ts +0 -1
  14. package/src/providers/gemini-cli/install.ts +0 -1
  15. package/src/providers/kimi/adapter.ts +0 -1
  16. package/src/providers/kimi/install.ts +0 -1
  17. package/src/providers/opencode/__tests__/adapter.test.ts +0 -12
  18. package/src/providers/opencode/adapter.ts +0 -1
  19. package/src/providers/opencode/install.ts +0 -1
  20. package/dist/index.d.ts +0 -23
  21. package/dist/index.d.ts.map +0 -1
  22. package/dist/index.js +0 -3258
  23. package/dist/index.js.map +0 -7
  24. package/dist/providers/claude-code/adapter.d.ts +0 -95
  25. package/dist/providers/claude-code/adapter.d.ts.map +0 -1
  26. package/dist/providers/claude-code/adapter.js +0 -185
  27. package/dist/providers/claude-code/adapter.js.map +0 -1
  28. package/dist/providers/claude-code/context-monitor.d.ts +0 -35
  29. package/dist/providers/claude-code/context-monitor.d.ts.map +0 -1
  30. package/dist/providers/claude-code/context-monitor.js +0 -159
  31. package/dist/providers/claude-code/context-monitor.js.map +0 -1
  32. package/dist/providers/claude-code/hooks.d.ts +0 -146
  33. package/dist/providers/claude-code/hooks.d.ts.map +0 -1
  34. package/dist/providers/claude-code/hooks.js +0 -286
  35. package/dist/providers/claude-code/hooks.js.map +0 -1
  36. package/dist/providers/claude-code/index.d.ts +0 -39
  37. package/dist/providers/claude-code/index.d.ts.map +0 -1
  38. package/dist/providers/claude-code/index.js +0 -41
  39. package/dist/providers/claude-code/index.js.map +0 -1
  40. package/dist/providers/claude-code/install.d.ts +0 -67
  41. package/dist/providers/claude-code/install.d.ts.map +0 -1
  42. package/dist/providers/claude-code/install.js +0 -161
  43. package/dist/providers/claude-code/install.js.map +0 -1
  44. package/dist/providers/claude-code/paths.d.ts +0 -32
  45. package/dist/providers/claude-code/paths.d.ts.map +0 -1
  46. package/dist/providers/claude-code/paths.js +0 -41
  47. package/dist/providers/claude-code/paths.js.map +0 -1
  48. package/dist/providers/claude-code/spawn.d.ts +0 -67
  49. package/dist/providers/claude-code/spawn.d.ts.map +0 -1
  50. package/dist/providers/claude-code/spawn.js +0 -171
  51. package/dist/providers/claude-code/spawn.js.map +0 -1
  52. package/dist/providers/claude-code/statusline.d.ts +0 -68
  53. package/dist/providers/claude-code/statusline.d.ts.map +0 -1
  54. package/dist/providers/claude-code/statusline.js +0 -130
  55. package/dist/providers/claude-code/statusline.js.map +0 -1
  56. package/dist/providers/claude-code/task-sync.d.ts +0 -32
  57. package/dist/providers/claude-code/task-sync.d.ts.map +0 -1
  58. package/dist/providers/claude-code/task-sync.js +0 -119
  59. package/dist/providers/claude-code/task-sync.js.map +0 -1
  60. package/dist/providers/claude-code/transport.d.ts +0 -25
  61. package/dist/providers/claude-code/transport.d.ts.map +0 -1
  62. package/dist/providers/claude-code/transport.js +0 -29
  63. package/dist/providers/claude-code/transport.js.map +0 -1
  64. package/dist/providers/codex/adapter.d.ts +0 -83
  65. package/dist/providers/codex/adapter.d.ts.map +0 -1
  66. package/dist/providers/codex/adapter.js +0 -147
  67. package/dist/providers/codex/adapter.js.map +0 -1
  68. package/dist/providers/codex/hooks.d.ts +0 -91
  69. package/dist/providers/codex/hooks.d.ts.map +0 -1
  70. package/dist/providers/codex/hooks.js +0 -113
  71. package/dist/providers/codex/hooks.js.map +0 -1
  72. package/dist/providers/codex/index.d.ts +0 -37
  73. package/dist/providers/codex/index.d.ts.map +0 -1
  74. package/dist/providers/codex/index.js +0 -39
  75. package/dist/providers/codex/index.js.map +0 -1
  76. package/dist/providers/codex/install.d.ts +0 -65
  77. package/dist/providers/codex/install.d.ts.map +0 -1
  78. package/dist/providers/codex/install.js +0 -125
  79. package/dist/providers/codex/install.js.map +0 -1
  80. package/dist/providers/cursor/adapter.d.ts +0 -76
  81. package/dist/providers/cursor/adapter.d.ts.map +0 -1
  82. package/dist/providers/cursor/adapter.js +0 -152
  83. package/dist/providers/cursor/adapter.js.map +0 -1
  84. package/dist/providers/cursor/hooks.d.ts +0 -140
  85. package/dist/providers/cursor/hooks.d.ts.map +0 -1
  86. package/dist/providers/cursor/hooks.js +0 -208
  87. package/dist/providers/cursor/hooks.js.map +0 -1
  88. package/dist/providers/cursor/index.d.ts +0 -34
  89. package/dist/providers/cursor/index.d.ts.map +0 -1
  90. package/dist/providers/cursor/index.js +0 -36
  91. package/dist/providers/cursor/index.js.map +0 -1
  92. package/dist/providers/cursor/install.d.ts +0 -87
  93. package/dist/providers/cursor/install.d.ts.map +0 -1
  94. package/dist/providers/cursor/install.js +0 -181
  95. package/dist/providers/cursor/install.js.map +0 -1
  96. package/dist/providers/cursor/spawn.d.ts +0 -50
  97. package/dist/providers/cursor/spawn.d.ts.map +0 -1
  98. package/dist/providers/cursor/spawn.js +0 -59
  99. package/dist/providers/cursor/spawn.js.map +0 -1
  100. package/dist/providers/gemini-cli/adapter.d.ts +0 -84
  101. package/dist/providers/gemini-cli/adapter.d.ts.map +0 -1
  102. package/dist/providers/gemini-cli/adapter.js +0 -159
  103. package/dist/providers/gemini-cli/adapter.js.map +0 -1
  104. package/dist/providers/gemini-cli/hooks.d.ts +0 -99
  105. package/dist/providers/gemini-cli/hooks.d.ts.map +0 -1
  106. package/dist/providers/gemini-cli/hooks.js +0 -128
  107. package/dist/providers/gemini-cli/hooks.js.map +0 -1
  108. package/dist/providers/gemini-cli/index.d.ts +0 -37
  109. package/dist/providers/gemini-cli/index.d.ts.map +0 -1
  110. package/dist/providers/gemini-cli/index.js +0 -39
  111. package/dist/providers/gemini-cli/index.js.map +0 -1
  112. package/dist/providers/gemini-cli/install.d.ts +0 -65
  113. package/dist/providers/gemini-cli/install.d.ts.map +0 -1
  114. package/dist/providers/gemini-cli/install.js +0 -125
  115. package/dist/providers/gemini-cli/install.js.map +0 -1
  116. package/dist/providers/kimi/adapter.d.ts +0 -85
  117. package/dist/providers/kimi/adapter.d.ts.map +0 -1
  118. package/dist/providers/kimi/adapter.js +0 -146
  119. package/dist/providers/kimi/adapter.js.map +0 -1
  120. package/dist/providers/kimi/hooks.d.ts +0 -70
  121. package/dist/providers/kimi/hooks.d.ts.map +0 -1
  122. package/dist/providers/kimi/hooks.js +0 -79
  123. package/dist/providers/kimi/hooks.js.map +0 -1
  124. package/dist/providers/kimi/index.d.ts +0 -37
  125. package/dist/providers/kimi/index.d.ts.map +0 -1
  126. package/dist/providers/kimi/index.js +0 -39
  127. package/dist/providers/kimi/index.js.map +0 -1
  128. package/dist/providers/kimi/install.d.ts +0 -65
  129. package/dist/providers/kimi/install.d.ts.map +0 -1
  130. package/dist/providers/kimi/install.js +0 -125
  131. package/dist/providers/kimi/install.js.map +0 -1
  132. package/dist/providers/opencode/adapter.d.ts +0 -83
  133. package/dist/providers/opencode/adapter.d.ts.map +0 -1
  134. package/dist/providers/opencode/adapter.js +0 -167
  135. package/dist/providers/opencode/adapter.js.map +0 -1
  136. package/dist/providers/opencode/hooks.d.ts +0 -136
  137. package/dist/providers/opencode/hooks.d.ts.map +0 -1
  138. package/dist/providers/opencode/hooks.js +0 -206
  139. package/dist/providers/opencode/hooks.js.map +0 -1
  140. package/dist/providers/opencode/index.d.ts +0 -35
  141. package/dist/providers/opencode/index.d.ts.map +0 -1
  142. package/dist/providers/opencode/index.js +0 -37
  143. package/dist/providers/opencode/index.js.map +0 -1
  144. package/dist/providers/opencode/install.d.ts +0 -56
  145. package/dist/providers/opencode/install.d.ts.map +0 -1
  146. package/dist/providers/opencode/install.js +0 -116
  147. package/dist/providers/opencode/install.js.map +0 -1
  148. package/dist/providers/opencode/spawn.d.ts +0 -94
  149. package/dist/providers/opencode/spawn.d.ts.map +0 -1
  150. package/dist/providers/opencode/spawn.js +0 -241
  151. package/dist/providers/opencode/spawn.js.map +0 -1
  152. package/dist/providers/shared/transcript-reader.d.ts +0 -58
  153. package/dist/providers/shared/transcript-reader.d.ts.map +0 -1
  154. package/dist/providers/shared/transcript-reader.js +0 -124
  155. package/dist/providers/shared/transcript-reader.js.map +0 -1
  156. package/dist/registry.d.ts +0 -88
  157. package/dist/registry.d.ts.map +0 -1
  158. package/dist/registry.js +0 -88
  159. package/dist/registry.js.map +0 -1
@@ -1,125 +0,0 @@
1
- /**
2
- * Codex CLI Install Provider
3
- *
4
- * Handles CLEO installation into Codex CLI environments:
5
- * - Ensures AGENTS.md has CLEO @-references
6
- *
7
- * @task T162
8
- * @epic T134
9
- */
10
- import { existsSync, readFileSync, writeFileSync } from 'node:fs';
11
- import { join } from 'node:path';
12
- /** Lines that should appear in AGENTS.md to reference CLEO. */
13
- const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
14
- /**
15
- * Install provider for Codex CLI.
16
- *
17
- * Manages CLEO's integration with Codex CLI by:
18
- * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
19
- *
20
- * @remarks
21
- * Installation is idempotent -- running install multiple times on the same
22
- * project produces the same result. Only AGENTS.md is managed; Codex CLI
23
- * does not have an MCP or plugin registration mechanism.
24
- *
25
- * @task T162
26
- * @epic T134
27
- */
28
- export class CodexInstallProvider {
29
- /**
30
- * Install CLEO into a Codex CLI environment.
31
- *
32
- * @param options - Installation options including project directory
33
- * @returns Result describing what was installed
34
- * @task T162
35
- */
36
- async install(options) {
37
- const { projectDir } = options;
38
- const installedAt = new Date().toISOString();
39
- let instructionFileUpdated = false;
40
- const details = {};
41
- // Step 1: Ensure AGENTS.md has @-references
42
- instructionFileUpdated = this.updateInstructionFile(projectDir);
43
- if (instructionFileUpdated) {
44
- details.instructionFile = join(projectDir, 'AGENTS.md');
45
- }
46
- return {
47
- success: true,
48
- installedAt,
49
- instructionFileUpdated,
50
- mcpRegistered: false,
51
- details,
52
- };
53
- }
54
- /**
55
- * Uninstall CLEO from the Codex CLI environment.
56
- *
57
- * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
58
- * @task T162
59
- */
60
- async uninstall() {
61
- // No-op: no MCP registration to remove
62
- }
63
- /**
64
- * Check whether CLEO is installed in the Codex CLI environment.
65
- *
66
- * Checks for CLEO references in AGENTS.md.
67
- * @task T162
68
- */
69
- async isInstalled() {
70
- const agentsMdPath = join(process.cwd(), 'AGENTS.md');
71
- if (existsSync(agentsMdPath)) {
72
- try {
73
- const content = readFileSync(agentsMdPath, 'utf-8');
74
- if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
75
- return true;
76
- }
77
- }
78
- catch {
79
- // Fall through
80
- }
81
- }
82
- return false;
83
- }
84
- /**
85
- * Ensure AGENTS.md contains @-references to CLEO instruction files.
86
- *
87
- * Creates AGENTS.md if it does not exist. Appends any missing references.
88
- *
89
- * @param projectDir - Project root directory
90
- * @task T162
91
- */
92
- async ensureInstructionReferences(projectDir) {
93
- this.updateInstructionFile(projectDir);
94
- }
95
- /**
96
- * Update AGENTS.md with CLEO @-references.
97
- *
98
- * @param projectDir - Project root directory
99
- * @returns true if the file was created or modified
100
- */
101
- updateInstructionFile(projectDir) {
102
- const agentsMdPath = join(projectDir, 'AGENTS.md');
103
- let content = '';
104
- let existed = false;
105
- if (existsSync(agentsMdPath)) {
106
- content = readFileSync(agentsMdPath, 'utf-8');
107
- existed = true;
108
- }
109
- const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
110
- if (missingRefs.length === 0) {
111
- return false;
112
- }
113
- const refsBlock = missingRefs.join('\n');
114
- if (existed) {
115
- const separator = content.endsWith('\n') ? '' : '\n';
116
- content = content + separator + refsBlock + '\n';
117
- }
118
- else {
119
- content = refsBlock + '\n';
120
- }
121
- writeFileSync(agentsMdPath, content, 'utf-8');
122
- return true;
123
- }
124
- }
125
- //# sourceMappingURL=install.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"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"}
@@ -1,76 +0,0 @@
1
- /**
2
- * Cursor Adapter
3
- *
4
- * Main CLEOProviderAdapter implementation for Cursor AI code editor.
5
- * Provides install capabilities for CLEO integration. Hooks and spawn
6
- * are not supported since Cursor lacks CLI-based lifecycle events
7
- * and subagent spawning.
8
- *
9
- * @task T5240
10
- */
11
- import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
12
- import { CursorHookProvider } from './hooks.js';
13
- import { CursorInstallProvider } from './install.js';
14
- /**
15
- * CLEO provider adapter for Cursor AI code editor.
16
- *
17
- * Bridges CLEO's adapter system with Cursor's capabilities:
18
- * - Install: Manages .cursorrules and .cursor/rules/cleo.mdc rule files
19
- * - Hooks: Stub provider (Cursor has no lifecycle event system)
20
- * - Spawn: Not supported (Cursor has no CLI for subagent spawning)
21
- *
22
- * @remarks
23
- * Cursor is a GUI-based editor, so many CLI-oriented capabilities
24
- * (spawn, transport, task sync, context monitor) are unsupported.
25
- * Integration is primarily through instruction rule files placed in
26
- * `.cursor/rules/` (modern MDC format) and `.cursorrules` (legacy).
27
- */
28
- export declare class CursorAdapter implements CLEOProviderAdapter {
29
- /** Unique provider identifier. */
30
- readonly id = "cursor";
31
- /** Human-readable provider name. */
32
- readonly name = "Cursor";
33
- /** Adapter version string. */
34
- readonly version = "1.0.0";
35
- /** Declared capabilities for this provider. */
36
- capabilities: AdapterCapabilities;
37
- /** Hook provider for CAAMP event mapping. */
38
- hooks: CursorHookProvider;
39
- /** Install provider for managing rule files. */
40
- install: CursorInstallProvider;
41
- /** Project directory this adapter was initialized with, or null. */
42
- private projectDir;
43
- /** Whether {@link initialize} has been called. */
44
- private initialized;
45
- constructor();
46
- /**
47
- * Initialize the adapter for a given project directory.
48
- *
49
- * @param projectDir - Root directory of the project
50
- */
51
- initialize(projectDir: string): Promise<void>;
52
- /**
53
- * Dispose the adapter and clean up resources.
54
- */
55
- dispose(): Promise<void>;
56
- /**
57
- * Run a health check to verify Cursor is accessible.
58
- *
59
- * Checks:
60
- * 1. Adapter has been initialized
61
- * 2. .cursor/ configuration directory exists in the project
62
- * 3. CURSOR_EDITOR env var is set
63
- *
64
- * @returns Health status with details about each check
65
- */
66
- healthCheck(): Promise<AdapterHealthStatus>;
67
- /**
68
- * Check whether the adapter has been initialized.
69
- */
70
- isInitialized(): boolean;
71
- /**
72
- * Get the project directory this adapter was initialized with.
73
- */
74
- getProjectDir(): string | null;
75
- }
76
- //# sourceMappingURL=adapter.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,mBAAmB;IACvD,kCAAkC;IAClC,QAAQ,CAAC,EAAE,YAAY;IACvB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,YAAY;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CA2B/B;IAEF,6CAA6C;IAC7C,KAAK,EAAE,kBAAkB,CAAC;IAC1B,gDAAgD;IAChD,OAAO,EAAE,qBAAqB,CAAC;IAE/B,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;OAIG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAwCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}
@@ -1,152 +0,0 @@
1
- /**
2
- * Cursor Adapter
3
- *
4
- * Main CLEOProviderAdapter implementation for Cursor AI code editor.
5
- * Provides install capabilities for CLEO integration. Hooks and spawn
6
- * are not supported since Cursor lacks CLI-based lifecycle events
7
- * and subagent spawning.
8
- *
9
- * @task T5240
10
- */
11
- import { existsSync } from 'node:fs';
12
- import { join } from 'node:path';
13
- import { CursorHookProvider } from './hooks.js';
14
- import { CursorInstallProvider } from './install.js';
15
- /**
16
- * CLEO provider adapter for Cursor AI code editor.
17
- *
18
- * Bridges CLEO's adapter system with Cursor's capabilities:
19
- * - Install: Manages .cursorrules and .cursor/rules/cleo.mdc rule files
20
- * - Hooks: Stub provider (Cursor has no lifecycle event system)
21
- * - Spawn: Not supported (Cursor has no CLI for subagent spawning)
22
- *
23
- * @remarks
24
- * Cursor is a GUI-based editor, so many CLI-oriented capabilities
25
- * (spawn, transport, task sync, context monitor) are unsupported.
26
- * Integration is primarily through instruction rule files placed in
27
- * `.cursor/rules/` (modern MDC format) and `.cursorrules` (legacy).
28
- */
29
- export class CursorAdapter {
30
- /** Unique provider identifier. */
31
- id = 'cursor';
32
- /** Human-readable provider name. */
33
- name = 'Cursor';
34
- /** Adapter version string. */
35
- version = '1.0.0';
36
- /** Declared capabilities for this provider. */
37
- capabilities = {
38
- supportsHooks: true,
39
- // 10/16 canonical events — derived from getProviderHookProfile('cursor') in CAAMP 1.9.1.
40
- // PermissionRequest, PreModel, PostModel, PostCompact, Notification, ConfigChange are
41
- // not supported by Cursor's hook system.
42
- supportedHookEvents: [
43
- 'SessionStart',
44
- 'SessionEnd',
45
- 'PromptSubmit',
46
- 'ResponseComplete',
47
- 'PreToolUse',
48
- 'PostToolUse',
49
- 'PostToolUseFailure',
50
- 'SubagentStart',
51
- 'SubagentStop',
52
- 'PreCompact',
53
- ],
54
- supportsSpawn: false,
55
- supportsInstall: true,
56
- supportsMcp: false,
57
- supportsInstructionFiles: true,
58
- instructionFilePattern: '.cursor/rules/*.mdc',
59
- supportsContextMonitor: false,
60
- supportsStatusline: false,
61
- supportsProviderPaths: true,
62
- supportsTransport: false,
63
- supportsTaskSync: false,
64
- };
65
- /** Hook provider for CAAMP event mapping. */
66
- hooks;
67
- /** Install provider for managing rule files. */
68
- install;
69
- /** Project directory this adapter was initialized with, or null. */
70
- projectDir = null;
71
- /** Whether {@link initialize} has been called. */
72
- initialized = false;
73
- constructor() {
74
- this.hooks = new CursorHookProvider();
75
- this.install = new CursorInstallProvider();
76
- }
77
- /**
78
- * Initialize the adapter for a given project directory.
79
- *
80
- * @param projectDir - Root directory of the project
81
- */
82
- async initialize(projectDir) {
83
- this.projectDir = projectDir;
84
- this.initialized = true;
85
- }
86
- /**
87
- * Dispose the adapter and clean up resources.
88
- */
89
- async dispose() {
90
- if (this.hooks.isRegistered()) {
91
- await this.hooks.unregisterNativeHooks();
92
- }
93
- this.initialized = false;
94
- this.projectDir = null;
95
- }
96
- /**
97
- * Run a health check to verify Cursor is accessible.
98
- *
99
- * Checks:
100
- * 1. Adapter has been initialized
101
- * 2. .cursor/ configuration directory exists in the project
102
- * 3. CURSOR_EDITOR env var is set
103
- *
104
- * @returns Health status with details about each check
105
- */
106
- async healthCheck() {
107
- const details = {};
108
- if (!this.initialized) {
109
- return {
110
- healthy: false,
111
- provider: this.id,
112
- details: { error: 'Adapter not initialized' },
113
- };
114
- }
115
- // Check for Cursor config directory in the project
116
- let configExists = false;
117
- if (this.projectDir) {
118
- const cursorConfigDir = join(this.projectDir, '.cursor');
119
- configExists = existsSync(cursorConfigDir);
120
- details.configDirExists = configExists;
121
- }
122
- // Check for CURSOR_EDITOR env var
123
- const editorEnvSet = process.env.CURSOR_EDITOR !== undefined;
124
- details.editorEnvSet = editorEnvSet;
125
- // Check for legacy .cursorrules file
126
- if (this.projectDir) {
127
- const legacyRulesExist = existsSync(join(this.projectDir, '.cursorrules'));
128
- details.legacyRulesExist = legacyRulesExist;
129
- }
130
- // Healthy if we detect Cursor presence (config dir or env var)
131
- const healthy = configExists || editorEnvSet;
132
- details.detected = healthy;
133
- return {
134
- healthy,
135
- provider: this.id,
136
- details,
137
- };
138
- }
139
- /**
140
- * Check whether the adapter has been initialized.
141
- */
142
- isInitialized() {
143
- return this.initialized;
144
- }
145
- /**
146
- * Get the project directory this adapter was initialized with.
147
- */
148
- getProjectDir() {
149
- return this.projectDir;
150
- }
151
- }
152
- //# sourceMappingURL=adapter.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/cursor/adapter.ts"],"names":[],"mappings":"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"}
@@ -1,140 +0,0 @@
1
- /**
2
- * Cursor Hook Provider
3
- *
4
- * Maps Cursor's native hook events to CAAMP canonical hook events.
5
- * Cursor supports 10 of 16 canonical events through its config-based hook system.
6
- *
7
- * Event translation uses CAAMP normalizer APIs:
8
- * - `toCanonical(nativeName, 'cursor')` for runtime event name resolution
9
- * - `getSupportedEvents('cursor')` to enumerate supported canonical events
10
- * - `getProviderHookProfile('cursor')` for the full provider profile
11
- *
12
- * Cursor uses camelCase native event names (e.g. `sessionStart`, `preToolUse`).
13
- * Hooks are configured via `.cursor/hooks.json`. Supported handler types:
14
- * command, prompt.
15
- *
16
- * Unsupported events: PermissionRequest, PreModel, PostModel, PostCompact,
17
- * Notification, ConfigChange.
18
- *
19
- * @task T165
20
- * @epic T134
21
- */
22
- import type { AdapterHookProvider } from '@cleocode/contracts';
23
- /**
24
- * Hook provider for Cursor.
25
- *
26
- * Cursor registers hooks via its config system at `.cursor/hooks.json`.
27
- * Supported handler types: command, prompt.
28
- *
29
- * CAAMP 1.9.1 reveals Cursor supports 10 of 16 canonical events. Previously
30
- * this provider was a no-op stub. It now provides full event mapping and CAAMP
31
- * normalizer integration.
32
- *
33
- * Event mapping is based on `getProviderHookProfile('cursor')` from CAAMP 1.9.1.
34
- * Async accessors (`getSupportedCanonicalEvents`, `getProviderProfile`) call
35
- * CAAMP directly when available.
36
- *
37
- * Since hooks are registered through the config system (managed by the install
38
- * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
39
- * state without performing filesystem operations.
40
- *
41
- * @remarks
42
- * This provider was originally a no-op stub. It now provides full event
43
- * mapping for all 10 canonical events supported by Cursor, plus CAAMP
44
- * normalizer integration via async accessors. Registration state is
45
- * tracked in-memory because Cursor manages hooks through its own config.
46
- *
47
- * @task T165
48
- * @epic T134
49
- */
50
- export declare class CursorHookProvider implements AdapterHookProvider {
51
- /** Whether hooks have been registered for the current session. */
52
- private registered;
53
- /**
54
- * Map a Cursor native event name to a CAAMP canonical hook event name.
55
- *
56
- * Looks up the native event name in the map derived from
57
- * `getProviderHookProfile('cursor').mappings` (CAAMP 1.9.1). Cursor uses
58
- * camelCase names (e.g. "preToolUse", "sessionStart").
59
- *
60
- * Returns null for unsupported events (PermissionRequest, PreModel,
61
- * PostModel, PostCompact, Notification, ConfigChange).
62
- *
63
- * @param providerEvent - Cursor native event name (e.g. "preToolUse", "sessionStart")
64
- * @returns CAAMP canonical event name, or null if unmapped
65
- * @task T165
66
- */
67
- mapProviderEvent(providerEvent: string): string | null;
68
- /**
69
- * Register native hooks for a project.
70
- *
71
- * For Cursor, hooks are registered via the config system
72
- * (`.cursor/hooks.json`), managed by the install provider.
73
- * This method marks hooks as registered without performing filesystem operations.
74
- *
75
- * Iterating supported events is handled at install time using
76
- * `getSupportedCanonicalEvents()` to enumerate all 10 supported hooks.
77
- *
78
- * @param _projectDir - Project directory (unused; Cursor config manages registration)
79
- * @task T165
80
- */
81
- registerNativeHooks(_projectDir: string): Promise<void>;
82
- /**
83
- * Unregister native hooks.
84
- *
85
- * For Cursor, this is a no-op since hooks are managed through the config
86
- * system. Unregistration happens via the install provider's uninstall method.
87
- *
88
- * @task T165
89
- */
90
- unregisterNativeHooks(): Promise<void>;
91
- /**
92
- * Check whether hooks have been registered via `registerNativeHooks`.
93
- */
94
- isRegistered(): boolean;
95
- /**
96
- * Get the native→canonical event mapping for introspection and debugging.
97
- *
98
- * Returns the map derived from `getProviderHookProfile('cursor').mappings`
99
- * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
100
- * names via live CAAMP APIs.
101
- *
102
- * @returns Immutable record of native event name → canonical event name
103
- */
104
- getEventMap(): Readonly<Record<string, string>>;
105
- /**
106
- * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
107
- *
108
- * Calls `getSupportedEvents('cursor')` from the CAAMP normalizer to get the
109
- * authoritative list. Cursor supports 10 of 16 canonical events. Falls back
110
- * to the values of the static event map when CAAMP is unavailable at runtime.
111
- *
112
- * @returns Array of CAAMP canonical event names supported by Cursor
113
- * @task T165
114
- */
115
- getSupportedCanonicalEvents(): Promise<string[]>;
116
- /**
117
- * Retrieve the full provider hook profile from CAAMP.
118
- *
119
- * Calls `getProviderHookProfile('cursor')` from the CAAMP normalizer to
120
- * get the complete profile: hook system type (`config`), config path
121
- * (`.cursor/hooks.json`), handler types (command, prompt), and all event
122
- * mappings. Returns null when CAAMP is unavailable at runtime.
123
- *
124
- * @returns Provider hook profile or null if CAAMP is unavailable
125
- * @task T165
126
- */
127
- getProviderProfile(): Promise<unknown | null>;
128
- /**
129
- * Translate a CAAMP canonical event to its Cursor native name via CAAMP.
130
- *
131
- * Calls `toNative(canonical, 'cursor')` from the CAAMP normalizer.
132
- * Returns null for unsupported events or when CAAMP is unavailable.
133
- *
134
- * @param canonical - CAAMP canonical event name (e.g. "PreToolUse")
135
- * @returns Cursor native event name (e.g. "preToolUse") or null
136
- * @task T165
137
- */
138
- toNativeEvent(canonical: string): Promise<string | null>;
139
- }
140
- //# sourceMappingURL=hooks.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAqC/D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;OASG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;OASG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAU/D"}