@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
@@ -27,39 +27,39 @@ const P0_SOURCES = [
27
27
  stalenessThresholdDays: 30,
28
28
  verifiedAt: '2026-04-07',
29
29
  },
30
- {
31
- key: 'copilot-cloud-agent-docs',
32
- label: 'Copilot Coding Agent',
33
- url: 'https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent',
34
- stalenessThresholdDays: 14,
35
- verifiedAt: '2026-04-07',
36
- },
37
- {
38
- key: 'copilot-cli-docs',
39
- label: 'Copilot CLI Documentation',
40
- url: 'https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli',
41
- stalenessThresholdDays: 14,
42
- verifiedAt: '2026-04-10',
43
- },
44
- {
45
- key: 'copilot-model-lts-docs',
46
- label: 'Copilot Base & LTS Models',
47
- url: 'https://docs.github.com/en/copilot/concepts/fallback-and-lts-models',
48
- stalenessThresholdDays: 14,
49
- verifiedAt: '2026-04-10',
50
- },
51
- {
52
- key: 'copilot-cli-custom-agents-docs',
53
- label: 'Copilot CLI Custom Agents',
54
- url: 'https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli',
55
- stalenessThresholdDays: 30,
56
- verifiedAt: '2026-04-10',
57
- },
58
- {
59
- key: 'copilot-prompt-files-docs',
60
- label: 'Copilot Prompt Files Documentation',
61
- url: 'https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot#creating-prompt-files',
62
- stalenessThresholdDays: 30,
30
+ {
31
+ key: 'copilot-cloud-agent-docs',
32
+ label: 'Copilot Coding Agent',
33
+ url: 'https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent',
34
+ stalenessThresholdDays: 14,
35
+ verifiedAt: '2026-04-07',
36
+ },
37
+ {
38
+ key: 'copilot-cli-docs',
39
+ label: 'Copilot CLI Documentation',
40
+ url: 'https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli',
41
+ stalenessThresholdDays: 14,
42
+ verifiedAt: '2026-04-10',
43
+ },
44
+ {
45
+ key: 'copilot-model-lts-docs',
46
+ label: 'Copilot Base & LTS Models',
47
+ url: 'https://docs.github.com/en/copilot/concepts/fallback-and-lts-models',
48
+ stalenessThresholdDays: 14,
49
+ verifiedAt: '2026-04-10',
50
+ },
51
+ {
52
+ key: 'copilot-cli-custom-agents-docs',
53
+ label: 'Copilot CLI Custom Agents',
54
+ url: 'https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli',
55
+ stalenessThresholdDays: 30,
56
+ verifiedAt: '2026-04-10',
57
+ },
58
+ {
59
+ key: 'copilot-prompt-files-docs',
60
+ label: 'Copilot Prompt Files Documentation',
61
+ url: 'https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot#creating-prompt-files',
62
+ stalenessThresholdDays: 30,
63
63
  verifiedAt: '2026-04-07',
64
64
  },
65
65
  {
@@ -144,30 +144,30 @@ const PROPAGATION_CHECKLIST = [
144
144
  'src/copilot/setup.js — update content exclusions guide',
145
145
  ],
146
146
  },
147
- {
148
- trigger: 'Organization policy change or new policy type',
149
- targets: [
150
- 'src/copilot/techniques.js — update organization checks (CP-F01..CP-F05)',
151
- 'src/copilot/governance.js — update enterprise-managed profile',
152
- ],
153
- },
154
- {
155
- trigger: 'Copilot CLI behavior change (CLI custom agents, hooks, memory, prompt layering)',
156
- targets: [
157
- 'src/copilot/techniques.js — update CLI-agent and instruction-surface checks',
158
- 'src/copilot/setup.js — update starter guidance when CLI agent or hook behavior changes',
159
- 'src/source-urls.js — refresh Copilot source mappings for CLI-specific surfaces',
160
- ],
161
- },
162
- {
163
- trigger: 'Copilot model / fallback / LTS policy change',
164
- targets: [
165
- 'src/copilot/governance.js — update model-selection and enterprise policy caveats',
166
- 'src/copilot/techniques.js — update trust/availability assumptions tied to model fallback behavior',
167
- 'src/source-urls.js — refresh Copilot model and maturity source mappings',
168
- ],
169
- },
170
- ];
147
+ {
148
+ trigger: 'Organization policy change or new policy type',
149
+ targets: [
150
+ 'src/copilot/techniques.js — update organization checks (CP-F01..CP-F05)',
151
+ 'src/copilot/governance.js — update enterprise-managed profile',
152
+ ],
153
+ },
154
+ {
155
+ trigger: 'Copilot CLI behavior change (CLI custom agents, hooks, memory, prompt layering)',
156
+ targets: [
157
+ 'src/copilot/techniques.js — update CLI-agent and instruction-surface checks',
158
+ 'src/copilot/setup.js — update starter guidance when CLI agent or hook behavior changes',
159
+ 'src/source-urls.js — refresh Copilot source mappings for CLI-specific surfaces',
160
+ ],
161
+ },
162
+ {
163
+ trigger: 'Copilot model / fallback / LTS policy change',
164
+ targets: [
165
+ 'src/copilot/governance.js — update model-selection and enterprise policy caveats',
166
+ 'src/copilot/techniques.js — update trust/availability assumptions tied to model fallback behavior',
167
+ 'src/source-urls.js — refresh Copilot model and maturity source mappings',
168
+ ],
169
+ },
170
+ ];
171
171
 
172
172
  /**
173
173
  * Release gate: check if all P0 sources are within staleness threshold.
@@ -1,222 +1,222 @@
1
- /**
2
- * Copilot Governance Module
3
- *
4
- * 6 permission profiles, 7 hook equivalents, 5 policy packs.
5
- *
6
- * Copilot-specific differences from Gemini/Codex:
7
- * - Org policies are admin-managed, not file-based
8
- * - 3 separate surfaces (VS Code, cloud, CLI) with different trust models
9
- * - Terminal sandbox is macOS/Linux/WSL2 only (NOT native Windows)
10
- * - Content exclusions are glob-based, NOT enforced on cloud agent
11
- */
12
-
13
- const { COPILOT_DOMAIN_PACKS } = require('./domain-packs');
14
- const { COPILOT_MCP_PACKS } = require('./mcp-packs');
15
-
16
- const COPILOT_PERMISSION_PROFILES = [
17
- {
18
- key: 'locked-down',
19
- label: 'Locked Down',
20
- risk: 'low',
21
- defaultSandbox: 'terminal-sandbox-enabled',
22
- approvalPolicy: 'always-confirm',
23
- useWhen: 'First contact with a repo, security review, or regulated environments.',
24
- behavior: 'Terminal sandbox enabled, no auto-approval, content exclusions active. All tool calls require user confirmation.',
25
- surfaces: ['vscode'],
26
- },
27
- {
28
- key: 'standard',
29
- label: 'Standard',
30
- risk: 'medium',
31
- defaultSandbox: 'terminal-sandbox-enabled',
32
- approvalPolicy: 'selective-approval',
33
- useWhen: 'Default product work where Copilot edits locally but risky commands still need review.',
34
- behavior: 'Terminal sandbox enabled. Specific safe commands (test, lint) can be auto-approved. Edits require confirmation.',
35
- surfaces: ['vscode'],
36
- },
37
- {
38
- key: 'agent-mode',
39
- label: 'Agent Mode',
40
- risk: 'medium',
41
- defaultSandbox: 'terminal-sandbox-enabled',
42
- approvalPolicy: 'auto-approve-safe',
43
- useWhen: 'Trusted repos where Copilot agent mode is the primary workflow.',
44
- behavior: 'Full agent mode enabled. Auto-approval for safe terminal patterns. Terminal sandbox protects against escapes.',
45
- surfaces: ['vscode'],
46
- },
47
- {
48
- key: 'cloud-agent',
49
- label: 'Cloud Agent',
50
- risk: 'high',
51
- defaultSandbox: 'ephemeral-vm',
52
- approvalPolicy: 'pr-gate',
53
- useWhen: 'Cloud agent tasks assigned via GitHub Issues. Ephemeral VM provides containment.',
54
- behavior: 'Runs on GitHub Actions runner (Ubuntu). PRs created for review. Content exclusions NOT enforced. Cold-boot ~90 seconds.',
55
- surfaces: ['cloud'],
56
- },
57
- {
58
- key: 'enterprise-managed',
59
- label: 'Enterprise Managed',
60
- risk: 'low',
61
- defaultSandbox: 'org-policy-enforced',
62
- approvalPolicy: 'org-admin-controlled',
63
- useWhen: 'Enterprise tier with org-level policies, audit logs, and model access controls.',
64
- behavior: 'Admin-managed policies override individual settings. Audit logs enabled. MCP allowlist enforced. BYOK optional.',
65
- surfaces: ['vscode', 'cloud', 'cli'],
66
- },
67
- {
68
- key: 'no-sandbox-windows',
69
- label: 'No Sandbox (Windows)',
70
- risk: 'critical',
71
- defaultSandbox: 'none',
72
- approvalPolicy: 'always-confirm',
73
- useWhen: 'Native Windows environment where terminal sandbox is unavailable.',
74
- behavior: 'Terminal sandbox NOT available on native Windows. All terminal commands must be manually reviewed. Consider WSL2 for sandboxed execution.',
75
- surfaces: ['vscode'],
76
- },
77
- ];
78
-
79
- const COPILOT_HOOK_REGISTRY = [
80
- {
81
- key: 'auto-approval-terminal',
82
- file: '.vscode/settings.json',
83
- triggerPoint: 'chat.agent.autoApproval.terminalCommands',
84
- matcher: 'terminal command patterns',
85
- purpose: 'Auto-approve specific terminal command patterns without user confirmation.',
86
- risk: 'high',
87
- },
88
- {
89
- key: 'auto-approval-tools',
90
- file: '.vscode/settings.json',
91
- triggerPoint: 'chat.agent.autoApproval.tools',
92
- matcher: 'tool name patterns',
93
- purpose: 'Auto-approve specific tool invocations in agent mode.',
94
- risk: 'high',
95
- },
96
- {
97
- key: 'review-instructions',
98
- file: '.vscode/settings.json',
99
- triggerPoint: 'github.copilot.chat.reviewSelection.instructions',
100
- matcher: 'code review context',
101
- purpose: 'Inject custom review instructions when Copilot reviews selected code.',
102
- risk: 'low',
103
- },
104
- {
105
- key: 'commit-message-instructions',
106
- file: '.vscode/settings.json',
107
- triggerPoint: 'github.copilot.chat.commitMessageGeneration.instructions',
108
- matcher: 'commit context',
109
- purpose: 'Guide commit message generation format and conventions.',
110
- risk: 'low',
111
- },
112
- {
113
- key: 'pr-description-instructions',
114
- file: '.vscode/settings.json',
115
- triggerPoint: 'github.copilot.chat.pullRequestDescriptionGeneration.instructions',
116
- matcher: 'PR context',
117
- purpose: 'Guide pull request description generation.',
118
- risk: 'low',
119
- },
120
- {
121
- key: 'content-exclusion',
122
- file: 'org-admin-settings',
123
- triggerPoint: 'content-exclusion-patterns',
124
- matcher: 'file glob patterns',
125
- purpose: 'Prevent Copilot from reading sensitive files. NOTE: Not enforced on cloud agent.',
126
- risk: 'medium',
127
- },
128
- {
129
- key: 'cloud-setup-steps',
130
- file: '.github/workflows/copilot-setup-steps.yml',
131
- triggerPoint: 'cloud-agent-boot',
132
- matcher: 'environment setup',
133
- purpose: 'Configure cloud agent environment: install dependencies, set env vars, prepare test commands.',
134
- risk: 'medium',
135
- },
136
- ];
137
-
138
- const COPILOT_POLICY_PACKS = [
139
- {
140
- key: 'baseline-safe',
141
- label: 'Baseline Safe',
142
- modules: ['copilot-instructions.md baseline', 'sandbox enabled', 'no wildcard auto-approval', 'content exclusions for .env'],
143
- useWhen: 'Default local Copilot rollout.',
144
- },
145
- {
146
- key: 'cloud-agent-safe',
147
- label: 'Cloud Agent Safe',
148
- modules: ['copilot-setup-steps.yml configured', 'PR review gate', 'content exclusion gap documented', 'signed commits enabled'],
149
- useWhen: 'Repos using the Copilot cloud agent for automated tasks.',
150
- },
151
- {
152
- key: 'multi-surface-consistent',
153
- label: 'Multi-Surface Consistent',
154
- modules: ['instructions consistent across surfaces', 'MCP aligned across surfaces', 'security posture consistent'],
155
- useWhen: 'Repos using both VS Code agent and cloud agent.',
156
- },
157
- {
158
- key: 'enterprise-governed',
159
- label: 'Enterprise Governed',
160
- modules: ['org policies configured', 'audit logs enabled', 'MCP allowlist', 'model access policy', 'data training opt-out'],
161
- useWhen: 'Enterprise/Business tier repos with strict governance requirements.',
162
- },
163
- {
164
- key: 'privacy-first',
165
- label: 'Privacy First',
166
- modules: ['content exclusions active', 'data training opt-out', 'no secrets in instructions', 'cloud gap documented'],
167
- useWhen: 'Repos handling sensitive data (PII, PHI, financial) where data privacy is paramount.',
168
- },
169
- ];
170
-
171
- const COPILOT_PILOT_ROLLOUT_KIT = {
172
- recommendedScope: [
173
- 'Start with audit and setup on one trusted repo before enabling cloud agent.',
174
- 'Keep copilot-instructions.md and .vscode/settings.json in version control.',
175
- 'Test cloud agent on a non-critical repo first (90s cold-boot per task).',
176
- 'Document content exclusion limitations for the team.',
177
- 'If on Windows, document that terminal sandbox is unavailable.',
178
- ],
179
- approvals: [
180
- 'Engineering owner approves sandbox mode and auto-approval patterns.',
181
- 'Security owner approves content exclusion configuration and cloud agent usage.',
182
- 'Pilot owner records before/after audit deltas and rollback expectations.',
183
- 'Org admin approves third-party agent policy and MCP allowlist.',
184
- ],
185
- successMetrics: [
186
- 'Audit score delta',
187
- 'Surface coverage (VS Code + cloud + CLI)',
188
- 'Time to first useful Copilot agent task',
189
- 'No-overwrite rate on existing repo files',
190
- 'Content exclusion coverage for sensitive paths',
191
- ],
192
- rollbackExpectations: [
193
- 'Every Copilot setup/apply write path should emit a rollback artifact.',
194
- 'Re-run audit after rollback to confirm the repo returned to the expected state.',
195
- 'Cloud agent can be disabled via org settings without affecting VS Code config.',
196
- ],
197
- };
198
-
199
- function getCopilotGovernanceSummary() {
200
- return {
201
- platform: 'copilot',
202
- platformLabel: 'GitHub Copilot',
203
- permissionProfiles: COPILOT_PERMISSION_PROFILES,
204
- hookRegistry: COPILOT_HOOK_REGISTRY,
205
- policyPacks: COPILOT_POLICY_PACKS,
206
- domainPacks: COPILOT_DOMAIN_PACKS,
207
- mcpPacks: COPILOT_MCP_PACKS,
208
- pilotRolloutKit: COPILOT_PILOT_ROLLOUT_KIT,
209
- platformCaveats: [
210
- { id: 'cloud-content-exclusion', severity: 'critical', message: 'Content exclusions are NOT enforced on the cloud agent.' },
211
- { id: 'cold-boot', severity: 'medium', message: 'Cloud agent cold-boot takes ~90 seconds per task.' },
212
- { id: 'no-windows-sandbox', severity: 'high', message: 'Terminal sandbox is unavailable on native Windows. macOS/Linux/WSL2 only.' },
213
- { id: 'data-training', severity: 'medium', message: 'Interaction data used for training since April 24, 2026 (opt-out required on Free/Pro/Pro+).' },
214
- { id: 'agents-md-off', severity: 'high', message: 'AGENTS.md support is off by default in VS Code — must be explicitly enabled.' },
215
- { id: 'deprecated-codegen', severity: 'medium', message: 'codeGeneration.instructions is deprecated since VS Code 1.102 — silently ignored.' },
216
- ],
217
- };
218
- }
219
-
220
- module.exports = {
221
- getCopilotGovernanceSummary,
222
- };
1
+ /**
2
+ * Copilot Governance Module
3
+ *
4
+ * 6 permission profiles, 7 hook equivalents, 5 policy packs.
5
+ *
6
+ * Copilot-specific differences from Gemini/Codex:
7
+ * - Org policies are admin-managed, not file-based
8
+ * - 3 separate surfaces (VS Code, cloud, CLI) with different trust models
9
+ * - Terminal sandbox is macOS/Linux/WSL2 only (NOT native Windows)
10
+ * - Content exclusions are glob-based, NOT enforced on cloud agent
11
+ */
12
+
13
+ const { COPILOT_DOMAIN_PACKS } = require('./domain-packs');
14
+ const { COPILOT_MCP_PACKS } = require('./mcp-packs');
15
+
16
+ const COPILOT_PERMISSION_PROFILES = [
17
+ {
18
+ key: 'locked-down',
19
+ label: 'Locked Down',
20
+ risk: 'low',
21
+ defaultSandbox: 'terminal-sandbox-enabled',
22
+ approvalPolicy: 'always-confirm',
23
+ useWhen: 'First contact with a repo, security review, or regulated environments.',
24
+ behavior: 'Terminal sandbox enabled, no auto-approval, content exclusions active. All tool calls require user confirmation.',
25
+ surfaces: ['vscode'],
26
+ },
27
+ {
28
+ key: 'standard',
29
+ label: 'Standard',
30
+ risk: 'medium',
31
+ defaultSandbox: 'terminal-sandbox-enabled',
32
+ approvalPolicy: 'selective-approval',
33
+ useWhen: 'Default product work where Copilot edits locally but risky commands still need review.',
34
+ behavior: 'Terminal sandbox enabled. Specific safe commands (test, lint) can be auto-approved. Edits require confirmation.',
35
+ surfaces: ['vscode'],
36
+ },
37
+ {
38
+ key: 'agent-mode',
39
+ label: 'Agent Mode',
40
+ risk: 'medium',
41
+ defaultSandbox: 'terminal-sandbox-enabled',
42
+ approvalPolicy: 'auto-approve-safe',
43
+ useWhen: 'Trusted repos where Copilot agent mode is the primary workflow.',
44
+ behavior: 'Full agent mode enabled. Auto-approval for safe terminal patterns. Terminal sandbox protects against escapes.',
45
+ surfaces: ['vscode'],
46
+ },
47
+ {
48
+ key: 'cloud-agent',
49
+ label: 'Cloud Agent',
50
+ risk: 'high',
51
+ defaultSandbox: 'ephemeral-vm',
52
+ approvalPolicy: 'pr-gate',
53
+ useWhen: 'Cloud agent tasks assigned via GitHub Issues. Ephemeral VM provides containment.',
54
+ behavior: 'Runs on GitHub Actions runner (Ubuntu). PRs created for review. Content exclusions NOT enforced. Cold-boot ~90 seconds.',
55
+ surfaces: ['cloud'],
56
+ },
57
+ {
58
+ key: 'enterprise-managed',
59
+ label: 'Enterprise Managed',
60
+ risk: 'low',
61
+ defaultSandbox: 'org-policy-enforced',
62
+ approvalPolicy: 'org-admin-controlled',
63
+ useWhen: 'Enterprise tier with org-level policies, audit logs, and model access controls.',
64
+ behavior: 'Admin-managed policies override individual settings. Audit logs enabled. MCP allowlist enforced. BYOK optional.',
65
+ surfaces: ['vscode', 'cloud', 'cli'],
66
+ },
67
+ {
68
+ key: 'no-sandbox-windows',
69
+ label: 'No Sandbox (Windows)',
70
+ risk: 'critical',
71
+ defaultSandbox: 'none',
72
+ approvalPolicy: 'always-confirm',
73
+ useWhen: 'Native Windows environment where terminal sandbox is unavailable.',
74
+ behavior: 'Terminal sandbox NOT available on native Windows. All terminal commands must be manually reviewed. Consider WSL2 for sandboxed execution.',
75
+ surfaces: ['vscode'],
76
+ },
77
+ ];
78
+
79
+ const COPILOT_HOOK_REGISTRY = [
80
+ {
81
+ key: 'auto-approval-terminal',
82
+ file: '.vscode/settings.json',
83
+ triggerPoint: 'chat.agent.autoApproval.terminalCommands',
84
+ matcher: 'terminal command patterns',
85
+ purpose: 'Auto-approve specific terminal command patterns without user confirmation.',
86
+ risk: 'high',
87
+ },
88
+ {
89
+ key: 'auto-approval-tools',
90
+ file: '.vscode/settings.json',
91
+ triggerPoint: 'chat.agent.autoApproval.tools',
92
+ matcher: 'tool name patterns',
93
+ purpose: 'Auto-approve specific tool invocations in agent mode.',
94
+ risk: 'high',
95
+ },
96
+ {
97
+ key: 'review-instructions',
98
+ file: '.vscode/settings.json',
99
+ triggerPoint: 'github.copilot.chat.reviewSelection.instructions',
100
+ matcher: 'code review context',
101
+ purpose: 'Inject custom review instructions when Copilot reviews selected code.',
102
+ risk: 'low',
103
+ },
104
+ {
105
+ key: 'commit-message-instructions',
106
+ file: '.vscode/settings.json',
107
+ triggerPoint: 'github.copilot.chat.commitMessageGeneration.instructions',
108
+ matcher: 'commit context',
109
+ purpose: 'Guide commit message generation format and conventions.',
110
+ risk: 'low',
111
+ },
112
+ {
113
+ key: 'pr-description-instructions',
114
+ file: '.vscode/settings.json',
115
+ triggerPoint: 'github.copilot.chat.pullRequestDescriptionGeneration.instructions',
116
+ matcher: 'PR context',
117
+ purpose: 'Guide pull request description generation.',
118
+ risk: 'low',
119
+ },
120
+ {
121
+ key: 'content-exclusion',
122
+ file: 'org-admin-settings',
123
+ triggerPoint: 'content-exclusion-patterns',
124
+ matcher: 'file glob patterns',
125
+ purpose: 'Prevent Copilot from reading sensitive files. NOTE: Not enforced on cloud agent.',
126
+ risk: 'medium',
127
+ },
128
+ {
129
+ key: 'cloud-setup-steps',
130
+ file: '.github/workflows/copilot-setup-steps.yml',
131
+ triggerPoint: 'cloud-agent-boot',
132
+ matcher: 'environment setup',
133
+ purpose: 'Configure cloud agent environment: install dependencies, set env vars, prepare test commands.',
134
+ risk: 'medium',
135
+ },
136
+ ];
137
+
138
+ const COPILOT_POLICY_PACKS = [
139
+ {
140
+ key: 'baseline-safe',
141
+ label: 'Baseline Safe',
142
+ modules: ['copilot-instructions.md baseline', 'sandbox enabled', 'no wildcard auto-approval', 'content exclusions for .env'],
143
+ useWhen: 'Default local Copilot rollout.',
144
+ },
145
+ {
146
+ key: 'cloud-agent-safe',
147
+ label: 'Cloud Agent Safe',
148
+ modules: ['copilot-setup-steps.yml configured', 'PR review gate', 'content exclusion gap documented', 'signed commits enabled'],
149
+ useWhen: 'Repos using the Copilot cloud agent for automated tasks.',
150
+ },
151
+ {
152
+ key: 'multi-surface-consistent',
153
+ label: 'Multi-Surface Consistent',
154
+ modules: ['instructions consistent across surfaces', 'MCP aligned across surfaces', 'security posture consistent'],
155
+ useWhen: 'Repos using both VS Code agent and cloud agent.',
156
+ },
157
+ {
158
+ key: 'enterprise-governed',
159
+ label: 'Enterprise Governed',
160
+ modules: ['org policies configured', 'audit logs enabled', 'MCP allowlist', 'model access policy', 'data training opt-out'],
161
+ useWhen: 'Enterprise/Business tier repos with strict governance requirements.',
162
+ },
163
+ {
164
+ key: 'privacy-first',
165
+ label: 'Privacy First',
166
+ modules: ['content exclusions active', 'data training opt-out', 'no secrets in instructions', 'cloud gap documented'],
167
+ useWhen: 'Repos handling sensitive data (PII, PHI, financial) where data privacy is paramount.',
168
+ },
169
+ ];
170
+
171
+ const COPILOT_PILOT_ROLLOUT_KIT = {
172
+ recommendedScope: [
173
+ 'Start with audit and setup on one trusted repo before enabling cloud agent.',
174
+ 'Keep copilot-instructions.md and .vscode/settings.json in version control.',
175
+ 'Test cloud agent on a non-critical repo first (90s cold-boot per task).',
176
+ 'Document content exclusion limitations for the team.',
177
+ 'If on Windows, document that terminal sandbox is unavailable.',
178
+ ],
179
+ approvals: [
180
+ 'Engineering owner approves sandbox mode and auto-approval patterns.',
181
+ 'Security owner approves content exclusion configuration and cloud agent usage.',
182
+ 'Pilot owner records before/after audit deltas and rollback expectations.',
183
+ 'Org admin approves third-party agent policy and MCP allowlist.',
184
+ ],
185
+ successMetrics: [
186
+ 'Audit score delta',
187
+ 'Surface coverage (VS Code + cloud + CLI)',
188
+ 'Time to first useful Copilot agent task',
189
+ 'No-overwrite rate on existing repo files',
190
+ 'Content exclusion coverage for sensitive paths',
191
+ ],
192
+ rollbackExpectations: [
193
+ 'Every Copilot setup/apply write path should emit a rollback artifact.',
194
+ 'Re-run audit after rollback to confirm the repo returned to the expected state.',
195
+ 'Cloud agent can be disabled via org settings without affecting VS Code config.',
196
+ ],
197
+ };
198
+
199
+ function getCopilotGovernanceSummary() {
200
+ return {
201
+ platform: 'copilot',
202
+ platformLabel: 'GitHub Copilot',
203
+ permissionProfiles: COPILOT_PERMISSION_PROFILES,
204
+ hookRegistry: COPILOT_HOOK_REGISTRY,
205
+ policyPacks: COPILOT_POLICY_PACKS,
206
+ domainPacks: COPILOT_DOMAIN_PACKS,
207
+ mcpPacks: COPILOT_MCP_PACKS,
208
+ pilotRolloutKit: COPILOT_PILOT_ROLLOUT_KIT,
209
+ platformCaveats: [
210
+ { id: 'cloud-content-exclusion', severity: 'critical', message: 'Content exclusions are NOT enforced on the cloud agent.' },
211
+ { id: 'cold-boot', severity: 'medium', message: 'Cloud agent cold-boot takes ~90 seconds per task.' },
212
+ { id: 'no-windows-sandbox', severity: 'high', message: 'Terminal sandbox is unavailable on native Windows. macOS/Linux/WSL2 only.' },
213
+ { id: 'data-training', severity: 'medium', message: 'Interaction data used for training since April 24, 2026 (opt-out required on Free/Pro/Pro+).' },
214
+ { id: 'agents-md-off', severity: 'high', message: 'AGENTS.md support is off by default in VS Code — must be explicitly enabled.' },
215
+ { id: 'deprecated-codegen', severity: 'medium', message: 'codeGeneration.instructions is deprecated since VS Code 1.102 — silently ignored.' },
216
+ ],
217
+ };
218
+ }
219
+
220
+ module.exports = {
221
+ getCopilotGovernanceSummary,
222
+ };