@nerviq/cli 1.20.1 → 1.21.0

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 (181) hide show
  1. package/LICENSE +23 -23
  2. package/README.md +2 -2
  3. package/package.json +1 -1
  4. package/src/activity.js +1039 -1039
  5. package/src/adoption-advisor.js +299 -299
  6. package/src/aider/config-parser.js +166 -166
  7. package/src/aider/context.js +4 -1
  8. package/src/aider/deep-review.js +316 -316
  9. package/src/aider/domain-packs.js +303 -303
  10. package/src/aider/freshness.js +93 -93
  11. package/src/aider/governance.js +253 -253
  12. package/src/aider/interactive.js +334 -334
  13. package/src/aider/mcp-packs.js +329 -329
  14. package/src/aider/patch.js +214 -214
  15. package/src/aider/plans.js +186 -186
  16. package/src/aider/premium.js +360 -360
  17. package/src/aider/setup.js +404 -404
  18. package/src/aider/techniques.js +312 -67
  19. package/src/analyze.js +951 -951
  20. package/src/anti-patterns.js +485 -485
  21. package/src/audit/instruction-files.js +180 -180
  22. package/src/audit/recommendations.js +577 -577
  23. package/src/auto-suggest.js +154 -154
  24. package/src/badge.js +13 -13
  25. package/src/behavioral-drift.js +801 -801
  26. package/src/benchmark.js +67 -67
  27. package/src/catalog.js +103 -103
  28. package/src/certification.js +128 -128
  29. package/src/codex/config-parser.js +183 -183
  30. package/src/codex/context.js +223 -223
  31. package/src/codex/deep-review.js +493 -493
  32. package/src/codex/domain-packs.js +394 -394
  33. package/src/codex/freshness.js +84 -84
  34. package/src/codex/governance.js +192 -192
  35. package/src/codex/interactive.js +618 -618
  36. package/src/codex/mcp-packs.js +914 -914
  37. package/src/codex/patch.js +209 -209
  38. package/src/codex/plans.js +251 -251
  39. package/src/codex/premium.js +614 -614
  40. package/src/codex/setup.js +591 -591
  41. package/src/continuous-ops.js +681 -681
  42. package/src/copilot/activity.js +309 -309
  43. package/src/copilot/deep-review.js +346 -346
  44. package/src/copilot/domain-packs.js +372 -372
  45. package/src/copilot/freshness.js +57 -57
  46. package/src/copilot/governance.js +222 -222
  47. package/src/copilot/interactive.js +406 -406
  48. package/src/copilot/mcp-packs.js +826 -826
  49. package/src/copilot/plans.js +253 -253
  50. package/src/copilot/premium.js +451 -451
  51. package/src/copilot/setup.js +488 -488
  52. package/src/cost-tracking.js +61 -61
  53. package/src/cursor/activity.js +301 -301
  54. package/src/cursor/config-parser.js +265 -265
  55. package/src/cursor/context.js +256 -256
  56. package/src/cursor/deep-review.js +334 -334
  57. package/src/cursor/domain-packs.js +368 -368
  58. package/src/cursor/freshness.js +65 -65
  59. package/src/cursor/governance.js +229 -229
  60. package/src/cursor/interactive.js +391 -391
  61. package/src/cursor/mcp-packs.js +828 -828
  62. package/src/cursor/plans.js +254 -254
  63. package/src/cursor/premium.js +469 -469
  64. package/src/cursor/setup.js +488 -488
  65. package/src/dashboard.js +493 -493
  66. package/src/deep-review.js +428 -428
  67. package/src/deprecation.js +98 -98
  68. package/src/diff-only.js +280 -280
  69. package/src/doctor.js +119 -119
  70. package/src/domain-pack-expansion.js +1033 -1033
  71. package/src/domain-packs.js +387 -387
  72. package/src/feedback.js +178 -178
  73. package/src/fix-engine.js +783 -783
  74. package/src/fix-prompts.js +122 -122
  75. package/src/formatters/sarif.js +115 -115
  76. package/src/freshness.js +74 -74
  77. package/src/gemini/config-parser.js +275 -275
  78. package/src/gemini/deep-review.js +559 -559
  79. package/src/gemini/domain-packs.js +393 -393
  80. package/src/gemini/freshness.js +66 -66
  81. package/src/gemini/governance.js +201 -201
  82. package/src/gemini/interactive.js +860 -860
  83. package/src/gemini/mcp-packs.js +915 -915
  84. package/src/gemini/plans.js +269 -269
  85. package/src/gemini/premium.js +760 -760
  86. package/src/gemini/setup.js +692 -692
  87. package/src/governance.js +72 -72
  88. package/src/harmony/add.js +68 -68
  89. package/src/harmony/advisor.js +333 -333
  90. package/src/harmony/canon.js +565 -565
  91. package/src/harmony/cli.js +591 -591
  92. package/src/harmony/drift.js +401 -401
  93. package/src/harmony/governance.js +313 -313
  94. package/src/harmony/memory.js +239 -239
  95. package/src/harmony/sync.js +475 -475
  96. package/src/harmony/watch.js +370 -370
  97. package/src/hook-validation.js +342 -342
  98. package/src/index.js +271 -271
  99. package/src/init.js +184 -184
  100. package/src/instruction-surfaces.js +185 -185
  101. package/src/integrations.js +144 -144
  102. package/src/interactive.js +118 -118
  103. package/src/locales/en.json +1 -1
  104. package/src/locales/es.json +1 -1
  105. package/src/mcp-packs.js +830 -830
  106. package/src/mcp-server.js +726 -726
  107. package/src/mcp-validation.js +337 -337
  108. package/src/nerviq-sync.json +7 -7
  109. package/src/opencode/config-parser.js +109 -109
  110. package/src/opencode/context.js +247 -247
  111. package/src/opencode/deep-review.js +313 -313
  112. package/src/opencode/domain-packs.js +262 -262
  113. package/src/opencode/freshness.js +66 -66
  114. package/src/opencode/governance.js +159 -159
  115. package/src/opencode/interactive.js +392 -392
  116. package/src/opencode/mcp-packs.js +705 -705
  117. package/src/opencode/patch.js +184 -184
  118. package/src/opencode/plans.js +231 -231
  119. package/src/opencode/premium.js +413 -413
  120. package/src/opencode/setup.js +449 -449
  121. package/src/opencode/techniques.js +27 -27
  122. package/src/operating-profile.js +574 -574
  123. package/src/org.js +152 -152
  124. package/src/permission-rules.js +218 -218
  125. package/src/plans.js +839 -839
  126. package/src/platform-change-manifest.js +86 -86
  127. package/src/plugins.js +110 -110
  128. package/src/policy-layers.js +210 -210
  129. package/src/profiles.js +124 -124
  130. package/src/prompt-injection.js +74 -74
  131. package/src/public-api.js +173 -173
  132. package/src/recommendation-rules.js +84 -84
  133. package/src/repo-archetype.js +386 -386
  134. package/src/secret-patterns.js +39 -39
  135. package/src/server.js +527 -527
  136. package/src/setup/analysis.js +607 -607
  137. package/src/setup/runtime.js +172 -172
  138. package/src/setup.js +677 -677
  139. package/src/shared/capabilities.js +194 -194
  140. package/src/source-urls.js +132 -132
  141. package/src/stack-checks.js +565 -565
  142. package/src/supplemental-checks.js +13 -13
  143. package/src/synergy/adaptive.js +261 -261
  144. package/src/synergy/compensation.js +137 -137
  145. package/src/synergy/evidence.js +193 -193
  146. package/src/synergy/learning.js +199 -199
  147. package/src/synergy/patterns.js +227 -227
  148. package/src/synergy/ranking.js +83 -83
  149. package/src/synergy/report.js +165 -165
  150. package/src/synergy/routing.js +146 -146
  151. package/src/techniques/api.js +407 -407
  152. package/src/techniques/automation.js +316 -316
  153. package/src/techniques/compliance.js +257 -257
  154. package/src/techniques/hygiene.js +294 -294
  155. package/src/techniques/instructions.js +243 -243
  156. package/src/techniques/observability.js +226 -226
  157. package/src/techniques/optimization.js +142 -142
  158. package/src/techniques/quality.js +318 -318
  159. package/src/techniques/security.js +237 -237
  160. package/src/techniques/shared.js +443 -443
  161. package/src/techniques/stacks.js +2294 -2294
  162. package/src/techniques/tools.js +106 -106
  163. package/src/techniques/workflow.js +413 -413
  164. package/src/techniques.js +81 -81
  165. package/src/terminology.js +73 -73
  166. package/src/token-estimate.js +35 -35
  167. package/src/usage-patterns.js +99 -99
  168. package/src/verification-metadata.js +145 -145
  169. package/src/watch.js +247 -247
  170. package/src/windsurf/activity.js +302 -302
  171. package/src/windsurf/config-parser.js +267 -267
  172. package/src/windsurf/deep-review.js +337 -337
  173. package/src/windsurf/domain-packs.js +370 -370
  174. package/src/windsurf/freshness.js +36 -36
  175. package/src/windsurf/governance.js +231 -231
  176. package/src/windsurf/interactive.js +388 -388
  177. package/src/windsurf/mcp-packs.js +792 -792
  178. package/src/windsurf/plans.js +247 -247
  179. package/src/windsurf/premium.js +468 -468
  180. package/src/windsurf/setup.js +471 -471
  181. package/src/workspace.js +375 -375
@@ -41,39 +41,39 @@ const P0_SOURCES = [
41
41
  stalenessThresholdDays: 14,
42
42
  verifiedAt: '2026-04-07',
43
43
  },
44
- {
45
- key: 'cursor-automations',
46
- label: 'Automations Documentation',
47
- url: 'https://cursor.com/docs/cloud-agent/automations',
48
- stalenessThresholdDays: 14,
49
- verifiedAt: '2026-04-07',
50
- },
51
- {
52
- key: 'cursor-agent-modes',
53
- label: 'Cursor Agent Modes',
54
- url: 'https://docs.cursor.com/en/chat/agent',
55
- stalenessThresholdDays: 14,
56
- verifiedAt: '2026-04-10',
57
- },
58
- {
59
- key: 'cursor-models-docs',
60
- label: 'Cursor Models & Auto Selection',
61
- url: 'https://docs.cursor.com/models',
62
- stalenessThresholdDays: 14,
63
- verifiedAt: '2026-04-10',
64
- },
65
- {
66
- key: 'cursor-cli-docs',
67
- label: 'Cursor CLI Usage',
68
- url: 'https://docs.cursor.com/en/cli/using',
69
- stalenessThresholdDays: 30,
70
- verifiedAt: '2026-04-10',
71
- },
72
- {
73
- key: 'cursor-bugbot',
74
- label: 'BugBot Documentation',
75
- url: 'https://cursor.com/docs/bugbot',
76
- stalenessThresholdDays: 30,
44
+ {
45
+ key: 'cursor-automations',
46
+ label: 'Automations Documentation',
47
+ url: 'https://cursor.com/docs/cloud-agent/automations',
48
+ stalenessThresholdDays: 14,
49
+ verifiedAt: '2026-04-07',
50
+ },
51
+ {
52
+ key: 'cursor-agent-modes',
53
+ label: 'Cursor Agent Modes',
54
+ url: 'https://docs.cursor.com/en/chat/agent',
55
+ stalenessThresholdDays: 14,
56
+ verifiedAt: '2026-04-10',
57
+ },
58
+ {
59
+ key: 'cursor-models-docs',
60
+ label: 'Cursor Models & Auto Selection',
61
+ url: 'https://docs.cursor.com/models',
62
+ stalenessThresholdDays: 14,
63
+ verifiedAt: '2026-04-10',
64
+ },
65
+ {
66
+ key: 'cursor-cli-docs',
67
+ label: 'Cursor CLI Usage',
68
+ url: 'https://docs.cursor.com/en/cli/using',
69
+ stalenessThresholdDays: 30,
70
+ verifiedAt: '2026-04-10',
71
+ },
72
+ {
73
+ key: 'cursor-bugbot',
74
+ label: 'BugBot Documentation',
75
+ url: 'https://cursor.com/docs/bugbot',
76
+ stalenessThresholdDays: 30,
77
77
  verifiedAt: '2026-04-07',
78
78
  },
79
79
  {
@@ -161,38 +161,38 @@ const PROPAGATION_CHECKLIST = [
161
161
  'src/cursor/deep-review.js — update trust class detection',
162
162
  ],
163
163
  },
164
- {
165
- trigger: 'Design Mode feature update',
166
- targets: [
167
- 'src/cursor/setup.js — update Design Mode guide template',
168
- 'src/cursor/techniques.js — update CU-L01 modern features check',
169
- ],
170
- },
171
- {
172
- trigger: 'Cursor mode behavior change (Agent/Ask/Custom, auto-run, auto-fix, tool scopes)',
173
- targets: [
174
- 'src/cursor/techniques.js — update agent-mode and autonomy checks',
175
- 'src/cursor/governance.js — update mode-related permission caveats',
176
- 'src/source-urls.js — refresh Cursor mode source mappings',
177
- ],
178
- },
179
- {
180
- trigger: 'Cursor model catalog or auto-selection change',
181
- targets: [
182
- 'src/cursor/techniques.js — update model-awareness and cost/trust assumptions',
183
- 'src/cursor/governance.js — update privacy and model-selection caveats',
184
- 'src/source-urls.js — refresh Cursor model source mappings',
185
- ],
186
- },
187
- {
188
- trigger: 'Cursor CLI behavior change',
189
- targets: [
190
- 'src/cursor/setup.js — update CLI-oriented starter guidance',
191
- 'src/cursor/techniques.js — update CLI/rules expectations where relevant',
192
- 'src/source-urls.js — refresh Cursor CLI source mappings',
193
- ],
194
- },
195
- ];
164
+ {
165
+ trigger: 'Design Mode feature update',
166
+ targets: [
167
+ 'src/cursor/setup.js — update Design Mode guide template',
168
+ 'src/cursor/techniques.js — update CU-L01 modern features check',
169
+ ],
170
+ },
171
+ {
172
+ trigger: 'Cursor mode behavior change (Agent/Ask/Custom, auto-run, auto-fix, tool scopes)',
173
+ targets: [
174
+ 'src/cursor/techniques.js — update agent-mode and autonomy checks',
175
+ 'src/cursor/governance.js — update mode-related permission caveats',
176
+ 'src/source-urls.js — refresh Cursor mode source mappings',
177
+ ],
178
+ },
179
+ {
180
+ trigger: 'Cursor model catalog or auto-selection change',
181
+ targets: [
182
+ 'src/cursor/techniques.js — update model-awareness and cost/trust assumptions',
183
+ 'src/cursor/governance.js — update privacy and model-selection caveats',
184
+ 'src/source-urls.js — refresh Cursor model source mappings',
185
+ ],
186
+ },
187
+ {
188
+ trigger: 'Cursor CLI behavior change',
189
+ targets: [
190
+ 'src/cursor/setup.js — update CLI-oriented starter guidance',
191
+ 'src/cursor/techniques.js — update CLI/rules expectations where relevant',
192
+ 'src/source-urls.js — refresh Cursor CLI source mappings',
193
+ ],
194
+ },
195
+ ];
196
196
 
197
197
  /**
198
198
  * Release gate: check if all P0 sources are within staleness threshold.
@@ -1,229 +1,229 @@
1
- /**
2
- * Cursor Governance Module
3
- *
4
- * 6 permission profiles, 7 hook equivalents, 5 policy packs.
5
- *
6
- * Cursor-specific differences from Copilot/Gemini:
7
- * - 3 execution surfaces: foreground (IDE), background (cloud VM), automations (event-driven)
8
- * - Privacy Mode OFF by default (code sent to model providers)
9
- * - No terminal sandbox (unlike Copilot's VS Code sandbox)
10
- * - Settings stored in SQLite (state.vscdb), NOT JSON
11
- * - Automations run without approval — trigger misconfiguration = runaway agents
12
- * - MCP hard limit ~40 tools, silent drop beyond
13
- * - Background agent has full home directory read access (security finding Nov 2025)
14
- */
15
-
16
- const { CURSOR_DOMAIN_PACKS } = require('./domain-packs');
17
- const { CURSOR_MCP_PACKS } = require('./mcp-packs');
18
-
19
- const CURSOR_PERMISSION_PROFILES = [
20
- {
21
- key: 'read-only',
22
- label: 'Read Only',
23
- risk: 'low',
24
- defaultSandbox: 'no-writes',
25
- approvalPolicy: 'always-confirm',
26
- useWhen: 'First contact with a repo, security review, or auditing.',
27
- behavior: 'Agent can read and suggest, but all edits and terminal commands require explicit confirmation.',
28
- surfaces: ['foreground'],
29
- },
30
- {
31
- key: 'standard',
32
- label: 'Standard',
33
- risk: 'medium',
34
- defaultSandbox: 'user-approval',
35
- approvalPolicy: 'selective-approval',
36
- useWhen: 'Default product work where agent edits locally but risky commands need review.',
37
- behavior: 'Agent proposes edits. Terminal commands require per-command approval unless auto-run enabled.',
38
- surfaces: ['foreground'],
39
- },
40
- {
41
- key: 'agent-mode',
42
- label: 'Agent Mode',
43
- risk: 'medium',
44
- defaultSandbox: 'auto-run-trusted',
45
- approvalPolicy: 'auto-approve-safe',
46
- useWhen: 'Trusted repos where full agent mode is the primary workflow.',
47
- behavior: 'Full agent mode. Auto-run for trusted commands. YOLO mode available but discouraged.',
48
- surfaces: ['foreground'],
49
- },
50
- {
51
- key: 'background-agent',
52
- label: 'Background Agent',
53
- risk: 'high',
54
- defaultSandbox: 'ephemeral-vm',
55
- approvalPolicy: 'pr-gate',
56
- useWhen: 'Async tasks that create branches and PRs. Privacy Mode must be disabled.',
57
- behavior: 'Runs on ephemeral Ubuntu VM. Auto-approved terminal. Creates branch + PR. Full home directory readable (security finding). No max tool call limit.',
58
- surfaces: ['background'],
59
- },
60
- {
61
- key: 'automation',
62
- label: 'Automation',
63
- risk: 'high',
64
- defaultSandbox: 'ephemeral-vm',
65
- approvalPolicy: 'event-triggered',
66
- useWhen: 'Event-driven triggers (push, PR, Slack, timer). No human approval before execution.',
67
- behavior: 'Cloud VM per run. 30-minute cap. Diffs staged for review. Secrets via vault only. Can run hundreds per hour.',
68
- surfaces: ['automations'],
69
- },
70
- {
71
- key: 'enterprise',
72
- label: 'Enterprise',
73
- risk: 'low',
74
- defaultSandbox: 'org-policy-enforced',
75
- approvalPolicy: 'org-admin-controlled',
76
- useWhen: 'Enterprise tier with SSO, SCIM, audit logs, MCP/model allowlists.',
77
- behavior: 'Admin-managed policies. Privacy Mode enforced org-wide. Audit logs and AI code tracking APIs. BugBot for automated PR review.',
78
- surfaces: ['foreground', 'background', 'automations'],
79
- },
80
- ];
81
-
82
- const CURSOR_HOOK_REGISTRY = [
83
- {
84
- key: 'always-apply-rules',
85
- file: '.cursor/rules/*.mdc',
86
- triggerPoint: 'alwaysApply: true',
87
- matcher: 'every chat and agent message',
88
- purpose: 'Inject core instructions into every agent interaction.',
89
- risk: 'low',
90
- },
91
- {
92
- key: 'auto-attached-rules',
93
- file: '.cursor/rules/*.mdc',
94
- triggerPoint: 'globs match',
95
- matcher: 'file glob patterns',
96
- purpose: 'Inject context-specific rules when matching files are open or referenced.',
97
- risk: 'low',
98
- },
99
- {
100
- key: 'auto-run-terminal',
101
- file: 'Cursor Settings (SQLite)',
102
- triggerPoint: 'terminal command execution',
103
- matcher: 'terminal command patterns',
104
- purpose: 'Auto-approve terminal commands without user confirmation (YOLO mode).',
105
- risk: 'critical',
106
- },
107
- {
108
- key: 'automation-trigger',
109
- file: '.cursor/automations/*.yaml',
110
- triggerPoint: 'event (push, PR, Slack, timer, webhook)',
111
- matcher: 'event configuration',
112
- purpose: 'Trigger cloud agent execution on specified events. Runs WITHOUT approval.',
113
- risk: 'high',
114
- },
115
- {
116
- key: 'bugbot-review',
117
- file: 'BugBot config (per-repo)',
118
- triggerPoint: 'PR opened/updated',
119
- matcher: 'PR diff',
120
- purpose: 'Automated code review on PRs. Can spawn cloud agent for auto-fixes.',
121
- risk: 'medium',
122
- },
123
- {
124
- key: 'environment-setup',
125
- file: '.cursor/environment.json',
126
- triggerPoint: 'background agent boot',
127
- matcher: 'VM configuration',
128
- purpose: 'Configure background agent VM: base image, env vars, persisted dirs, processes.',
129
- risk: 'medium',
130
- },
131
- {
132
- key: 'mcp-tool-approval',
133
- file: '.cursor/mcp.json',
134
- triggerPoint: 'MCP tool invocation',
135
- matcher: 'tool name/server',
136
- purpose: 'Control which MCP tools are available. Auto-run model for approved tools.',
137
- risk: 'medium',
138
- },
139
- ];
140
-
141
- const CURSOR_POLICY_PACKS = [
142
- {
143
- key: 'baseline-safe',
144
- label: 'Baseline Safe',
145
- modules: ['.cursor/rules/ with alwaysApply', 'no .cursorrules', 'Privacy Mode awareness', 'no secrets in rules'],
146
- useWhen: 'Default local Cursor rollout.',
147
- },
148
- {
149
- key: 'background-agent-safe',
150
- label: 'Background Agent Safe',
151
- modules: ['environment.json configured', 'PR review gate', 'KMS secrets only', 'no direct push to main'],
152
- useWhen: 'Repos using background agents for async tasks.',
153
- },
154
- {
155
- key: 'automation-safe',
156
- label: 'Automation Safe',
157
- modules: ['scoped triggers (no wildcards)', 'debounce on frequent events', 'error notification', 'rate limits documented'],
158
- useWhen: 'Repos using event-driven automations.',
159
- },
160
- {
161
- key: 'enterprise-governed',
162
- label: 'Enterprise Governed',
163
- modules: ['SSO configured', 'audit logs enabled', 'MCP allowlist', 'Privacy Mode enforced', 'model access policy'],
164
- useWhen: 'Enterprise tier repos with strict governance requirements.',
165
- },
166
- {
167
- key: 'privacy-first',
168
- label: 'Privacy First',
169
- modules: ['Privacy Mode enabled', 'no secrets in any Cursor config', 'MCP env vars use ${env:} syntax', 'background agent home dir exposure documented'],
170
- useWhen: 'Repos handling sensitive data where Privacy Mode and data protection are paramount.',
171
- },
172
- ];
173
-
174
- const CURSOR_PILOT_ROLLOUT_KIT = {
175
- recommendedScope: [
176
- 'Start with audit and setup on one trusted repo before enabling background agents.',
177
- 'Keep .cursor/rules/ and .cursor/mcp.json in version control.',
178
- 'Enable Privacy Mode before using with sensitive code.',
179
- 'Migrate .cursorrules to .cursor/rules/*.mdc before relying on agent mode.',
180
- 'Test background agents on a non-critical repo first.',
181
- 'If using automations, start with manual triggers before event-driven.',
182
- ],
183
- approvals: [
184
- 'Engineering owner approves auto-run terminal policy and background agent usage.',
185
- 'Security owner approves Privacy Mode status and MCP server allowlist.',
186
- 'Pilot owner records before/after audit deltas and rollback expectations.',
187
- 'Org admin approves automation trigger scope and model access policy.',
188
- ],
189
- successMetrics: [
190
- 'Audit score delta',
191
- 'Surface coverage (foreground + background + automations)',
192
- 'Time to first useful agent task',
193
- 'No-overwrite rate on existing repo files',
194
- 'Legacy .cursorrules migration completion',
195
- 'MCP tool count within 40-tool limit',
196
- ],
197
- rollbackExpectations: [
198
- 'Every Cursor setup/apply write path should emit a rollback artifact.',
199
- 'Re-run audit after rollback to confirm the repo returned to expected state.',
200
- 'Background agents can be disabled by removing .cursor/environment.json.',
201
- 'Automations can be disabled by removing .cursor/automations/ directory.',
202
- ],
203
- };
204
-
205
- function getCursorGovernanceSummary() {
206
- return {
207
- platform: 'cursor',
208
- platformLabel: 'Cursor AI',
209
- permissionProfiles: CURSOR_PERMISSION_PROFILES,
210
- hookRegistry: CURSOR_HOOK_REGISTRY,
211
- policyPacks: CURSOR_POLICY_PACKS,
212
- domainPacks: CURSOR_DOMAIN_PACKS,
213
- mcpPacks: CURSOR_MCP_PACKS,
214
- pilotRolloutKit: CURSOR_PILOT_ROLLOUT_KIT,
215
- platformCaveats: [
216
- { id: 'cursorrules-ignored', severity: 'critical', message: 'Agent mode ignores .cursorrules — only .cursor/rules/*.mdc files work.' },
217
- { id: 'privacy-off', severity: 'high', message: 'Privacy Mode OFF by default — code sent to model providers without zero-retention.' },
218
- { id: 'mcp-tool-limit', severity: 'medium', message: 'MCP hard limit ~40 tools. Exceeding silently drops tools without warning.' },
219
- { id: 'code-reversion', severity: 'critical', message: 'Code reversion risk from agent review + format-on-save + cloud sync conflict.' },
220
- { id: 'no-terminal-sandbox', severity: 'high', message: 'No terminal sandbox equivalent (unlike Copilot). All terminal commands execute directly.' },
221
- { id: 'bg-agent-home-dir', severity: 'critical', message: 'Background agents have full read access to home directory (~/.ssh/, ~/.aws/credentials, ~/.npmrc).' },
222
- { id: 'automation-no-approval', severity: 'high', message: 'Automations run without human approval. Misconfigured triggers = uncontrolled execution.' },
223
- ],
224
- };
225
- }
226
-
227
- module.exports = {
228
- getCursorGovernanceSummary,
229
- };
1
+ /**
2
+ * Cursor Governance Module
3
+ *
4
+ * 6 permission profiles, 7 hook equivalents, 5 policy packs.
5
+ *
6
+ * Cursor-specific differences from Copilot/Gemini:
7
+ * - 3 execution surfaces: foreground (IDE), background (cloud VM), automations (event-driven)
8
+ * - Privacy Mode OFF by default (code sent to model providers)
9
+ * - No terminal sandbox (unlike Copilot's VS Code sandbox)
10
+ * - Settings stored in SQLite (state.vscdb), NOT JSON
11
+ * - Automations run without approval — trigger misconfiguration = runaway agents
12
+ * - MCP hard limit ~40 tools, silent drop beyond
13
+ * - Background agent has full home directory read access (security finding Nov 2025)
14
+ */
15
+
16
+ const { CURSOR_DOMAIN_PACKS } = require('./domain-packs');
17
+ const { CURSOR_MCP_PACKS } = require('./mcp-packs');
18
+
19
+ const CURSOR_PERMISSION_PROFILES = [
20
+ {
21
+ key: 'read-only',
22
+ label: 'Read Only',
23
+ risk: 'low',
24
+ defaultSandbox: 'no-writes',
25
+ approvalPolicy: 'always-confirm',
26
+ useWhen: 'First contact with a repo, security review, or auditing.',
27
+ behavior: 'Agent can read and suggest, but all edits and terminal commands require explicit confirmation.',
28
+ surfaces: ['foreground'],
29
+ },
30
+ {
31
+ key: 'standard',
32
+ label: 'Standard',
33
+ risk: 'medium',
34
+ defaultSandbox: 'user-approval',
35
+ approvalPolicy: 'selective-approval',
36
+ useWhen: 'Default product work where agent edits locally but risky commands need review.',
37
+ behavior: 'Agent proposes edits. Terminal commands require per-command approval unless auto-run enabled.',
38
+ surfaces: ['foreground'],
39
+ },
40
+ {
41
+ key: 'agent-mode',
42
+ label: 'Agent Mode',
43
+ risk: 'medium',
44
+ defaultSandbox: 'auto-run-trusted',
45
+ approvalPolicy: 'auto-approve-safe',
46
+ useWhen: 'Trusted repos where full agent mode is the primary workflow.',
47
+ behavior: 'Full agent mode. Auto-run for trusted commands. YOLO mode available but discouraged.',
48
+ surfaces: ['foreground'],
49
+ },
50
+ {
51
+ key: 'background-agent',
52
+ label: 'Background Agent',
53
+ risk: 'high',
54
+ defaultSandbox: 'ephemeral-vm',
55
+ approvalPolicy: 'pr-gate',
56
+ useWhen: 'Async tasks that create branches and PRs. Privacy Mode must be disabled.',
57
+ behavior: 'Runs on ephemeral Ubuntu VM. Auto-approved terminal. Creates branch + PR. Full home directory readable (security finding). No max tool call limit.',
58
+ surfaces: ['background'],
59
+ },
60
+ {
61
+ key: 'automation',
62
+ label: 'Automation',
63
+ risk: 'high',
64
+ defaultSandbox: 'ephemeral-vm',
65
+ approvalPolicy: 'event-triggered',
66
+ useWhen: 'Event-driven triggers (push, PR, Slack, timer). No human approval before execution.',
67
+ behavior: 'Cloud VM per run. 30-minute cap. Diffs staged for review. Secrets via vault only. Can run hundreds per hour.',
68
+ surfaces: ['automations'],
69
+ },
70
+ {
71
+ key: 'enterprise',
72
+ label: 'Enterprise',
73
+ risk: 'low',
74
+ defaultSandbox: 'org-policy-enforced',
75
+ approvalPolicy: 'org-admin-controlled',
76
+ useWhen: 'Enterprise tier with SSO, SCIM, audit logs, MCP/model allowlists.',
77
+ behavior: 'Admin-managed policies. Privacy Mode enforced org-wide. Audit logs and AI code tracking APIs. BugBot for automated PR review.',
78
+ surfaces: ['foreground', 'background', 'automations'],
79
+ },
80
+ ];
81
+
82
+ const CURSOR_HOOK_REGISTRY = [
83
+ {
84
+ key: 'always-apply-rules',
85
+ file: '.cursor/rules/*.mdc',
86
+ triggerPoint: 'alwaysApply: true',
87
+ matcher: 'every chat and agent message',
88
+ purpose: 'Inject core instructions into every agent interaction.',
89
+ risk: 'low',
90
+ },
91
+ {
92
+ key: 'auto-attached-rules',
93
+ file: '.cursor/rules/*.mdc',
94
+ triggerPoint: 'globs match',
95
+ matcher: 'file glob patterns',
96
+ purpose: 'Inject context-specific rules when matching files are open or referenced.',
97
+ risk: 'low',
98
+ },
99
+ {
100
+ key: 'auto-run-terminal',
101
+ file: 'Cursor Settings (SQLite)',
102
+ triggerPoint: 'terminal command execution',
103
+ matcher: 'terminal command patterns',
104
+ purpose: 'Auto-approve terminal commands without user confirmation (YOLO mode).',
105
+ risk: 'critical',
106
+ },
107
+ {
108
+ key: 'automation-trigger',
109
+ file: '.cursor/automations/*.yaml',
110
+ triggerPoint: 'event (push, PR, Slack, timer, webhook)',
111
+ matcher: 'event configuration',
112
+ purpose: 'Trigger cloud agent execution on specified events. Runs WITHOUT approval.',
113
+ risk: 'high',
114
+ },
115
+ {
116
+ key: 'bugbot-review',
117
+ file: 'BugBot config (per-repo)',
118
+ triggerPoint: 'PR opened/updated',
119
+ matcher: 'PR diff',
120
+ purpose: 'Automated code review on PRs. Can spawn cloud agent for auto-fixes.',
121
+ risk: 'medium',
122
+ },
123
+ {
124
+ key: 'environment-setup',
125
+ file: '.cursor/environment.json',
126
+ triggerPoint: 'background agent boot',
127
+ matcher: 'VM configuration',
128
+ purpose: 'Configure background agent VM: base image, env vars, persisted dirs, processes.',
129
+ risk: 'medium',
130
+ },
131
+ {
132
+ key: 'mcp-tool-approval',
133
+ file: '.cursor/mcp.json',
134
+ triggerPoint: 'MCP tool invocation',
135
+ matcher: 'tool name/server',
136
+ purpose: 'Control which MCP tools are available. Auto-run model for approved tools.',
137
+ risk: 'medium',
138
+ },
139
+ ];
140
+
141
+ const CURSOR_POLICY_PACKS = [
142
+ {
143
+ key: 'baseline-safe',
144
+ label: 'Baseline Safe',
145
+ modules: ['.cursor/rules/ with alwaysApply', 'no .cursorrules', 'Privacy Mode awareness', 'no secrets in rules'],
146
+ useWhen: 'Default local Cursor rollout.',
147
+ },
148
+ {
149
+ key: 'background-agent-safe',
150
+ label: 'Background Agent Safe',
151
+ modules: ['environment.json configured', 'PR review gate', 'KMS secrets only', 'no direct push to main'],
152
+ useWhen: 'Repos using background agents for async tasks.',
153
+ },
154
+ {
155
+ key: 'automation-safe',
156
+ label: 'Automation Safe',
157
+ modules: ['scoped triggers (no wildcards)', 'debounce on frequent events', 'error notification', 'rate limits documented'],
158
+ useWhen: 'Repos using event-driven automations.',
159
+ },
160
+ {
161
+ key: 'enterprise-governed',
162
+ label: 'Enterprise Governed',
163
+ modules: ['SSO configured', 'audit logs enabled', 'MCP allowlist', 'Privacy Mode enforced', 'model access policy'],
164
+ useWhen: 'Enterprise tier repos with strict governance requirements.',
165
+ },
166
+ {
167
+ key: 'privacy-first',
168
+ label: 'Privacy First',
169
+ modules: ['Privacy Mode enabled', 'no secrets in any Cursor config', 'MCP env vars use ${env:} syntax', 'background agent home dir exposure documented'],
170
+ useWhen: 'Repos handling sensitive data where Privacy Mode and data protection are paramount.',
171
+ },
172
+ ];
173
+
174
+ const CURSOR_PILOT_ROLLOUT_KIT = {
175
+ recommendedScope: [
176
+ 'Start with audit and setup on one trusted repo before enabling background agents.',
177
+ 'Keep .cursor/rules/ and .cursor/mcp.json in version control.',
178
+ 'Enable Privacy Mode before using with sensitive code.',
179
+ 'Migrate .cursorrules to .cursor/rules/*.mdc before relying on agent mode.',
180
+ 'Test background agents on a non-critical repo first.',
181
+ 'If using automations, start with manual triggers before event-driven.',
182
+ ],
183
+ approvals: [
184
+ 'Engineering owner approves auto-run terminal policy and background agent usage.',
185
+ 'Security owner approves Privacy Mode status and MCP server allowlist.',
186
+ 'Pilot owner records before/after audit deltas and rollback expectations.',
187
+ 'Org admin approves automation trigger scope and model access policy.',
188
+ ],
189
+ successMetrics: [
190
+ 'Audit score delta',
191
+ 'Surface coverage (foreground + background + automations)',
192
+ 'Time to first useful agent task',
193
+ 'No-overwrite rate on existing repo files',
194
+ 'Legacy .cursorrules migration completion',
195
+ 'MCP tool count within 40-tool limit',
196
+ ],
197
+ rollbackExpectations: [
198
+ 'Every Cursor setup/apply write path should emit a rollback artifact.',
199
+ 'Re-run audit after rollback to confirm the repo returned to expected state.',
200
+ 'Background agents can be disabled by removing .cursor/environment.json.',
201
+ 'Automations can be disabled by removing .cursor/automations/ directory.',
202
+ ],
203
+ };
204
+
205
+ function getCursorGovernanceSummary() {
206
+ return {
207
+ platform: 'cursor',
208
+ platformLabel: 'Cursor AI',
209
+ permissionProfiles: CURSOR_PERMISSION_PROFILES,
210
+ hookRegistry: CURSOR_HOOK_REGISTRY,
211
+ policyPacks: CURSOR_POLICY_PACKS,
212
+ domainPacks: CURSOR_DOMAIN_PACKS,
213
+ mcpPacks: CURSOR_MCP_PACKS,
214
+ pilotRolloutKit: CURSOR_PILOT_ROLLOUT_KIT,
215
+ platformCaveats: [
216
+ { id: 'cursorrules-ignored', severity: 'critical', message: 'Agent mode ignores .cursorrules — only .cursor/rules/*.mdc files work.' },
217
+ { id: 'privacy-off', severity: 'high', message: 'Privacy Mode OFF by default — code sent to model providers without zero-retention.' },
218
+ { id: 'mcp-tool-limit', severity: 'medium', message: 'MCP hard limit ~40 tools. Exceeding silently drops tools without warning.' },
219
+ { id: 'code-reversion', severity: 'critical', message: 'Code reversion risk from agent review + format-on-save + cloud sync conflict.' },
220
+ { id: 'no-terminal-sandbox', severity: 'high', message: 'No terminal sandbox equivalent (unlike Copilot). All terminal commands execute directly.' },
221
+ { id: 'bg-agent-home-dir', severity: 'critical', message: 'Background agents have full read access to home directory (~/.ssh/, ~/.aws/credentials, ~/.npmrc).' },
222
+ { id: 'automation-no-approval', severity: 'high', message: 'Automations run without human approval. Misconfigured triggers = uncontrolled execution.' },
223
+ ],
224
+ };
225
+ }
226
+
227
+ module.exports = {
228
+ getCursorGovernanceSummary,
229
+ };