@nerviq/cli 1.17.3 → 1.19.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 (190) hide show
  1. package/LICENSE +23 -23
  2. package/README.md +4 -4
  3. package/bin/cli.js +61 -274
  4. package/package.json +60 -60
  5. package/src/activity.js +1039 -1039
  6. package/src/adoption-advisor.js +299 -299
  7. package/src/aider/config-parser.js +166 -166
  8. package/src/aider/context.js +158 -158
  9. package/src/aider/deep-review.js +316 -316
  10. package/src/aider/domain-packs.js +303 -303
  11. package/src/aider/freshness.js +93 -93
  12. package/src/aider/governance.js +253 -253
  13. package/src/aider/interactive.js +334 -334
  14. package/src/aider/mcp-packs.js +329 -329
  15. package/src/aider/patch.js +214 -214
  16. package/src/aider/plans.js +186 -186
  17. package/src/aider/premium.js +360 -360
  18. package/src/aider/setup.js +404 -404
  19. package/src/aider/techniques.js +16 -16
  20. package/src/analyze.js +951 -951
  21. package/src/anti-patterns.js +485 -485
  22. package/src/audit/instruction-files.js +180 -180
  23. package/src/audit/recommendations.js +577 -577
  24. package/src/auto-suggest.js +154 -154
  25. package/src/badge.js +13 -13
  26. package/src/behavioral-drift.js +801 -801
  27. package/src/benchmark.js +67 -67
  28. package/src/catalog.js +103 -103
  29. package/src/certification.js +128 -128
  30. package/src/codex/config-parser.js +183 -183
  31. package/src/codex/context.js +223 -223
  32. package/src/codex/deep-review.js +493 -493
  33. package/src/codex/domain-packs.js +394 -394
  34. package/src/codex/freshness.js +84 -84
  35. package/src/codex/governance.js +192 -192
  36. package/src/codex/interactive.js +618 -618
  37. package/src/codex/mcp-packs.js +914 -914
  38. package/src/codex/patch.js +209 -209
  39. package/src/codex/plans.js +251 -251
  40. package/src/codex/premium.js +614 -614
  41. package/src/codex/setup.js +591 -591
  42. package/src/context.js +320 -320
  43. package/src/continuous-ops.js +681 -681
  44. package/src/copilot/activity.js +309 -309
  45. package/src/copilot/config-parser.js +280 -226
  46. package/src/copilot/context.js +218 -197
  47. package/src/copilot/deep-review.js +346 -346
  48. package/src/copilot/domain-packs.js +372 -372
  49. package/src/copilot/freshness.js +57 -57
  50. package/src/copilot/governance.js +222 -222
  51. package/src/copilot/interactive.js +406 -406
  52. package/src/copilot/mcp-packs.js +826 -826
  53. package/src/copilot/plans.js +253 -253
  54. package/src/copilot/premium.js +451 -451
  55. package/src/copilot/setup.js +488 -488
  56. package/src/copilot/techniques.js +219 -78
  57. package/src/cost-tracking.js +61 -61
  58. package/src/cursor/activity.js +301 -301
  59. package/src/cursor/config-parser.js +265 -265
  60. package/src/cursor/context.js +256 -256
  61. package/src/cursor/deep-review.js +334 -334
  62. package/src/cursor/domain-packs.js +368 -368
  63. package/src/cursor/freshness.js +65 -65
  64. package/src/cursor/governance.js +229 -229
  65. package/src/cursor/interactive.js +391 -391
  66. package/src/cursor/mcp-packs.js +828 -828
  67. package/src/cursor/plans.js +254 -254
  68. package/src/cursor/premium.js +469 -469
  69. package/src/cursor/setup.js +488 -488
  70. package/src/dashboard.js +493 -493
  71. package/src/deep-review.js +428 -428
  72. package/src/deprecation.js +98 -98
  73. package/src/diff-only.js +280 -280
  74. package/src/doctor.js +119 -119
  75. package/src/domain-pack-expansion.js +1033 -1033
  76. package/src/domain-packs.js +387 -387
  77. package/src/feedback.js +178 -178
  78. package/src/fix-engine.js +783 -0
  79. package/src/fix-prompts.js +122 -122
  80. package/src/formatters/sarif.js +115 -115
  81. package/src/freshness.js +74 -74
  82. package/src/gemini/config-parser.js +275 -275
  83. package/src/gemini/context.js +221 -221
  84. package/src/gemini/deep-review.js +559 -559
  85. package/src/gemini/domain-packs.js +393 -393
  86. package/src/gemini/freshness.js +66 -66
  87. package/src/gemini/governance.js +201 -201
  88. package/src/gemini/interactive.js +860 -860
  89. package/src/gemini/mcp-packs.js +915 -915
  90. package/src/gemini/plans.js +269 -269
  91. package/src/gemini/premium.js +760 -760
  92. package/src/gemini/setup.js +692 -692
  93. package/src/gemini/techniques.js +14 -14
  94. package/src/governance.js +72 -72
  95. package/src/harmony/add.js +68 -68
  96. package/src/harmony/advisor.js +333 -333
  97. package/src/harmony/canon.js +565 -565
  98. package/src/harmony/cli.js +591 -591
  99. package/src/harmony/drift.js +401 -401
  100. package/src/harmony/governance.js +313 -313
  101. package/src/harmony/memory.js +239 -239
  102. package/src/harmony/sync.js +475 -475
  103. package/src/harmony/watch.js +370 -370
  104. package/src/hook-validation.js +342 -342
  105. package/src/index.js +271 -271
  106. package/src/init.js +184 -184
  107. package/src/instruction-surfaces.js +185 -185
  108. package/src/integrations.js +144 -144
  109. package/src/interactive.js +118 -118
  110. package/src/locales/en.json +1 -1
  111. package/src/locales/es.json +1 -1
  112. package/src/mcp-packs.js +830 -830
  113. package/src/mcp-server.js +726 -726
  114. package/src/mcp-validation.js +337 -337
  115. package/src/nerviq-sync.json +7 -7
  116. package/src/opencode/config-parser.js +109 -109
  117. package/src/opencode/context.js +247 -247
  118. package/src/opencode/deep-review.js +313 -313
  119. package/src/opencode/domain-packs.js +262 -262
  120. package/src/opencode/freshness.js +66 -66
  121. package/src/opencode/governance.js +159 -159
  122. package/src/opencode/interactive.js +392 -392
  123. package/src/opencode/mcp-packs.js +705 -705
  124. package/src/opencode/patch.js +184 -184
  125. package/src/opencode/plans.js +231 -231
  126. package/src/opencode/premium.js +413 -413
  127. package/src/opencode/setup.js +449 -449
  128. package/src/opencode/techniques.js +27 -27
  129. package/src/operating-profile.js +574 -574
  130. package/src/org.js +152 -152
  131. package/src/permission-rules.js +218 -218
  132. package/src/plans.js +839 -839
  133. package/src/platform-change-manifest.js +86 -86
  134. package/src/plugins.js +110 -110
  135. package/src/policy-layers.js +210 -210
  136. package/src/profiles.js +124 -124
  137. package/src/prompt-injection.js +74 -74
  138. package/src/public-api.js +173 -173
  139. package/src/recommendation-rules.js +84 -84
  140. package/src/repo-archetype.js +386 -386
  141. package/src/secret-patterns.js +39 -39
  142. package/src/server.js +527 -527
  143. package/src/setup/analysis.js +607 -607
  144. package/src/setup/runtime.js +172 -172
  145. package/src/setup.js +677 -677
  146. package/src/shared/capabilities.js +194 -194
  147. package/src/source-urls.js +132 -132
  148. package/src/stack-checks.js +565 -565
  149. package/src/supplemental-checks.js +13 -13
  150. package/src/synergy/adaptive.js +261 -261
  151. package/src/synergy/compensation.js +137 -137
  152. package/src/synergy/evidence.js +193 -193
  153. package/src/synergy/learning.js +199 -199
  154. package/src/synergy/patterns.js +227 -227
  155. package/src/synergy/ranking.js +83 -83
  156. package/src/synergy/report.js +165 -165
  157. package/src/synergy/routing.js +146 -146
  158. package/src/techniques/api.js +407 -407
  159. package/src/techniques/automation.js +316 -316
  160. package/src/techniques/compliance.js +257 -257
  161. package/src/techniques/hygiene.js +294 -294
  162. package/src/techniques/instructions.js +243 -243
  163. package/src/techniques/observability.js +226 -226
  164. package/src/techniques/optimization.js +142 -142
  165. package/src/techniques/quality.js +318 -318
  166. package/src/techniques/security.js +237 -237
  167. package/src/techniques/shared.js +443 -443
  168. package/src/techniques/stacks.js +2294 -2294
  169. package/src/techniques/tools.js +106 -106
  170. package/src/techniques/workflow.js +413 -413
  171. package/src/techniques.js +81 -81
  172. package/src/terminology.js +73 -73
  173. package/src/token-estimate.js +35 -35
  174. package/src/usage-patterns.js +99 -99
  175. package/src/verification-metadata.js +145 -145
  176. package/src/watch.js +247 -247
  177. package/src/windsurf/activity.js +302 -302
  178. package/src/windsurf/config-parser.js +267 -267
  179. package/src/windsurf/context.js +249 -249
  180. package/src/windsurf/deep-review.js +337 -337
  181. package/src/windsurf/domain-packs.js +370 -370
  182. package/src/windsurf/freshness.js +36 -36
  183. package/src/windsurf/governance.js +231 -231
  184. package/src/windsurf/interactive.js +388 -388
  185. package/src/windsurf/mcp-packs.js +792 -792
  186. package/src/windsurf/plans.js +247 -247
  187. package/src/windsurf/premium.js +468 -468
  188. package/src/windsurf/setup.js +471 -471
  189. package/src/windsurf/techniques.js +17 -17
  190. 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
+ };