@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
@@ -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
+ };