@danielblomma/cortex-mcp 2.2.5 → 2.4.1

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 (196) hide show
  1. package/CHANGELOG.md +201 -0
  2. package/README.md +73 -3
  3. package/bin/cortex.mjs +339 -242
  4. package/bin/daemon-control.mjs +162 -0
  5. package/package.json +7 -3
  6. package/scaffold/mcp/dist/.cortex-build-hash +1 -0
  7. package/scaffold/mcp/dist/cli/enterprise-setup.js +134 -0
  8. package/scaffold/mcp/dist/cli/govern.js +937 -0
  9. package/scaffold/mcp/dist/cli/query.js +409 -0
  10. package/scaffold/mcp/dist/cli/run.js +295 -0
  11. package/scaffold/mcp/dist/cli/stage.js +308 -0
  12. package/scaffold/mcp/dist/cli/telemetry-test.js +141 -0
  13. package/scaffold/mcp/dist/cli/ungoverned-detector.js +133 -0
  14. package/scaffold/mcp/dist/contextEntities.js +282 -0
  15. package/scaffold/mcp/dist/core/audit/query.js +72 -0
  16. package/scaffold/mcp/dist/core/audit/writer.js +28 -0
  17. package/scaffold/mcp/dist/core/config.js +235 -0
  18. package/scaffold/mcp/dist/core/enterprise-host-identity.js +193 -0
  19. package/scaffold/mcp/dist/core/enterprise-identity.js +18 -0
  20. package/scaffold/mcp/dist/core/enterprise-rotation.js +158 -0
  21. package/scaffold/mcp/dist/core/govern-paths.js +21 -0
  22. package/scaffold/mcp/dist/core/index.js +14 -0
  23. package/scaffold/mcp/dist/core/license.js +278 -0
  24. package/scaffold/mcp/dist/core/policy/enforce.js +66 -0
  25. package/scaffold/mcp/dist/core/policy/injection.js +172 -0
  26. package/scaffold/mcp/dist/core/policy/store.js +179 -0
  27. package/scaffold/mcp/dist/core/rbac/check.js +30 -0
  28. package/scaffold/mcp/dist/core/secure-endpoint.js +25 -0
  29. package/scaffold/mcp/dist/core/telemetry/collector.js +285 -0
  30. package/scaffold/mcp/dist/core/telemetry/state-dir.js +31 -0
  31. package/scaffold/mcp/dist/core/validators/builtins.js +632 -0
  32. package/scaffold/mcp/dist/core/validators/config.js +44 -0
  33. package/scaffold/mcp/dist/core/validators/engine.js +120 -0
  34. package/scaffold/mcp/dist/core/validators/evaluators/code_comments.js +236 -0
  35. package/scaffold/mcp/dist/core/validators/evaluators/regex.js +116 -0
  36. package/scaffold/mcp/dist/core/workflow/artifact-io.js +103 -0
  37. package/scaffold/mcp/dist/core/workflow/capabilities.js +88 -0
  38. package/scaffold/mcp/dist/core/workflow/default-workflows.js +102 -0
  39. package/scaffold/mcp/dist/core/workflow/enforcement.js +164 -0
  40. package/scaffold/mcp/dist/core/workflow/envelope.js +132 -0
  41. package/scaffold/mcp/dist/core/workflow/index.js +11 -0
  42. package/scaffold/mcp/dist/core/workflow/mcp-tools.js +175 -0
  43. package/scaffold/mcp/dist/core/workflow/resolution.js +69 -0
  44. package/scaffold/mcp/dist/core/workflow/run-lifecycle.js +123 -0
  45. package/scaffold/mcp/dist/core/workflow/schemas.js +141 -0
  46. package/scaffold/mcp/dist/core/workflow/synced-capability-registry.js +60 -0
  47. package/scaffold/mcp/dist/core/workflow/synced-registry.js +60 -0
  48. package/scaffold/mcp/dist/daemon/capability-sync-checker.js +242 -0
  49. package/scaffold/mcp/dist/daemon/client.js +130 -0
  50. package/scaffold/mcp/dist/daemon/egress-proxy.js +288 -0
  51. package/scaffold/mcp/dist/daemon/global-host-events.js +222 -0
  52. package/scaffold/mcp/dist/daemon/heartbeat-pusher.js +116 -0
  53. package/scaffold/mcp/dist/daemon/heartbeat-tracker.js +165 -0
  54. package/scaffold/mcp/dist/daemon/host-events-pusher.js +249 -0
  55. package/scaffold/mcp/dist/daemon/main.js +449 -0
  56. package/scaffold/mcp/dist/daemon/paths.js +36 -0
  57. package/scaffold/mcp/dist/daemon/project-service-registry.js +78 -0
  58. package/scaffold/mcp/dist/daemon/protocol.js +8 -0
  59. package/scaffold/mcp/dist/daemon/server.js +180 -0
  60. package/scaffold/mcp/dist/daemon/skill-sync-checker.js +557 -0
  61. package/scaffold/mcp/dist/daemon/sync-checker.js +165 -0
  62. package/scaffold/mcp/dist/daemon/ungoverned-scanner.js +136 -0
  63. package/scaffold/mcp/dist/daemon/workflow-sync-checker.js +249 -0
  64. package/scaffold/mcp/dist/defaults.js +6 -0
  65. package/scaffold/mcp/dist/embed.js +627 -0
  66. package/scaffold/mcp/dist/embedScheduler.js +479 -0
  67. package/scaffold/mcp/dist/embeddings.js +167 -0
  68. package/scaffold/mcp/dist/enterprise/audit/push.js +66 -0
  69. package/scaffold/mcp/dist/enterprise/index.js +327 -0
  70. package/scaffold/mcp/dist/enterprise/model/deploy.js +27 -0
  71. package/scaffold/mcp/dist/enterprise/policy/sync.js +129 -0
  72. package/scaffold/mcp/dist/enterprise/privacy/boundary.js +184 -0
  73. package/scaffold/mcp/dist/enterprise/reviews/changed-files.js +33 -0
  74. package/scaffold/mcp/dist/enterprise/reviews/pattern-context.js +202 -0
  75. package/scaffold/mcp/dist/enterprise/reviews/policy-selection.js +46 -0
  76. package/scaffold/mcp/dist/enterprise/reviews/push.js +102 -0
  77. package/scaffold/mcp/dist/enterprise/reviews/trust-state.js +186 -0
  78. package/scaffold/mcp/dist/enterprise/telemetry/sync.js +57 -0
  79. package/scaffold/mcp/dist/enterprise/tools/enterprise.js +826 -0
  80. package/scaffold/mcp/dist/enterprise/tools/harness.js +40 -0
  81. package/scaffold/mcp/dist/enterprise/tools/walk.js +73 -0
  82. package/scaffold/mcp/dist/enterprise/violations/push.js +77 -0
  83. package/scaffold/mcp/dist/enterprise/workflow/push.js +44 -0
  84. package/scaffold/mcp/dist/enterprise/workflow/state.js +329 -0
  85. package/scaffold/mcp/dist/frontmatter.js +33 -0
  86. package/scaffold/mcp/dist/graph.js +769 -0
  87. package/scaffold/mcp/dist/graphCsv.js +55 -0
  88. package/scaffold/mcp/dist/graphMetrics.js +8 -0
  89. package/scaffold/mcp/dist/hooks/permission-request.js +89 -0
  90. package/scaffold/mcp/dist/hooks/post-tool-use.js +105 -0
  91. package/scaffold/mcp/dist/hooks/pre-compact.js +29 -0
  92. package/scaffold/mcp/dist/hooks/pre-tool-use.js +78 -0
  93. package/scaffold/mcp/dist/hooks/session-end.js +43 -0
  94. package/scaffold/mcp/dist/hooks/session-start.js +41 -0
  95. package/scaffold/mcp/dist/hooks/shared.js +194 -0
  96. package/scaffold/mcp/dist/hooks/stop.js +28 -0
  97. package/scaffold/mcp/dist/hooks/user-prompt-submit.js +33 -0
  98. package/scaffold/mcp/dist/impactPresentation.js +137 -0
  99. package/scaffold/mcp/dist/impactRanking.js +191 -0
  100. package/scaffold/mcp/dist/impactResponse.js +30 -0
  101. package/scaffold/mcp/dist/impactResults.js +105 -0
  102. package/scaffold/mcp/dist/impactSeed.js +20 -0
  103. package/scaffold/mcp/dist/impactTraversal.js +64 -0
  104. package/scaffold/mcp/dist/jsonl.js +77 -0
  105. package/scaffold/mcp/dist/loadGraph.js +759 -0
  106. package/scaffold/mcp/dist/lruCache.js +38 -0
  107. package/scaffold/mcp/dist/paths.js +97 -0
  108. package/scaffold/mcp/dist/patternEvidence.js +272 -0
  109. package/scaffold/mcp/dist/plugin.js +81 -0
  110. package/scaffold/mcp/dist/presets.js +78 -0
  111. package/scaffold/mcp/dist/relatedResponse.js +18 -0
  112. package/scaffold/mcp/dist/relatedTraversal.js +78 -0
  113. package/scaffold/mcp/dist/rules.js +23 -0
  114. package/scaffold/mcp/dist/search.js +212 -0
  115. package/scaffold/mcp/dist/searchCore.js +457 -0
  116. package/scaffold/mcp/dist/searchResults.js +230 -0
  117. package/scaffold/mcp/dist/server.js +317 -0
  118. package/scaffold/mcp/dist/types.js +1 -0
  119. package/scaffold/mcp/package-lock.json +336 -212
  120. package/scaffold/mcp/package.json +15 -6
  121. package/scaffold/mcp/src/cli/enterprise-setup.ts +82 -8
  122. package/scaffold/mcp/src/cli/govern.ts +137 -52
  123. package/scaffold/mcp/src/cli/query.ts +36 -2
  124. package/scaffold/mcp/src/cli/run.ts +53 -19
  125. package/scaffold/mcp/src/cli/stage.ts +8 -3
  126. package/scaffold/mcp/src/core/config.ts +9 -2
  127. package/scaffold/mcp/src/core/enterprise-host-identity.ts +259 -0
  128. package/scaffold/mcp/src/core/enterprise-identity.ts +20 -0
  129. package/scaffold/mcp/src/core/enterprise-rotation.ts +185 -0
  130. package/scaffold/mcp/src/core/govern-paths.ts +30 -0
  131. package/scaffold/mcp/src/core/license.ts +186 -17
  132. package/scaffold/mcp/src/core/secure-endpoint.ts +23 -0
  133. package/scaffold/mcp/src/core/workflow/enforcement.ts +8 -1
  134. package/scaffold/mcp/src/core/workflow/mcp-tools.ts +3 -0
  135. package/scaffold/mcp/src/core/workflow/resolution.ts +9 -1
  136. package/scaffold/mcp/src/core/workflow/synced-capability-registry.ts +15 -0
  137. package/scaffold/mcp/src/core/workflow/synced-registry.ts +15 -0
  138. package/scaffold/mcp/src/daemon/capability-sync-checker.ts +38 -2
  139. package/scaffold/mcp/src/daemon/egress-proxy.ts +14 -8
  140. package/scaffold/mcp/src/daemon/global-host-events.ts +288 -0
  141. package/scaffold/mcp/src/daemon/heartbeat-pusher.ts +4 -0
  142. package/scaffold/mcp/src/daemon/heartbeat-tracker.ts +2 -0
  143. package/scaffold/mcp/src/daemon/host-events-pusher.ts +5 -0
  144. package/scaffold/mcp/src/daemon/main.ts +99 -25
  145. package/scaffold/mcp/src/daemon/project-service-registry.ts +107 -0
  146. package/scaffold/mcp/src/daemon/skill-sync-checker.ts +368 -31
  147. package/scaffold/mcp/src/daemon/sync-checker.ts +4 -0
  148. package/scaffold/mcp/src/daemon/ungoverned-scanner.ts +57 -25
  149. package/scaffold/mcp/src/daemon/workflow-sync-checker.ts +41 -2
  150. package/scaffold/mcp/src/embed.ts +211 -10
  151. package/scaffold/mcp/src/enterprise/audit/push.ts +8 -0
  152. package/scaffold/mcp/src/enterprise/index.ts +1 -1
  153. package/scaffold/mcp/src/enterprise/policy/sync.ts +12 -0
  154. package/scaffold/mcp/src/enterprise/reviews/changed-files.ts +34 -0
  155. package/scaffold/mcp/src/enterprise/reviews/pattern-context.ts +231 -0
  156. package/scaffold/mcp/src/enterprise/reviews/push.ts +9 -0
  157. package/scaffold/mcp/src/enterprise/reviews/trust-state.ts +3 -1
  158. package/scaffold/mcp/src/enterprise/telemetry/sync.ts +9 -0
  159. package/scaffold/mcp/src/enterprise/tools/enterprise.ts +49 -36
  160. package/scaffold/mcp/src/enterprise/violations/push.ts +9 -0
  161. package/scaffold/mcp/src/enterprise/workflow/push.ts +7 -0
  162. package/scaffold/mcp/src/paths.ts +3 -5
  163. package/scaffold/mcp/src/patternEvidence.ts +347 -0
  164. package/scaffold/mcp/src/plugin.ts +20 -0
  165. package/scaffold/mcp/src/search.ts +35 -9
  166. package/scaffold/mcp/src/searchCore.ts +254 -12
  167. package/scaffold/mcp/src/searchResults.ts +96 -9
  168. package/scaffold/mcp/src/types.ts +7 -0
  169. package/scaffold/mcp/tests/changed-files.test.mjs +41 -0
  170. package/scaffold/mcp/tests/copilot-shim.test.mjs +19 -1
  171. package/scaffold/mcp/tests/egress-proxy.test.mjs +37 -0
  172. package/scaffold/mcp/tests/embed-entities.test.mjs +109 -1
  173. package/scaffold/mcp/tests/enterprise-identity-sync.test.mjs +401 -0
  174. package/scaffold/mcp/tests/enterprise-pattern-context.test.mjs +322 -0
  175. package/scaffold/mcp/tests/enterprise-setup.test.mjs +189 -0
  176. package/scaffold/mcp/tests/global-host-events.test.mjs +81 -0
  177. package/scaffold/mcp/tests/govern-install.test.mjs +95 -2
  178. package/scaffold/mcp/tests/govern-repair.test.mjs +20 -3
  179. package/scaffold/mcp/tests/heartbeat-tracker.test.mjs +26 -0
  180. package/scaffold/mcp/tests/license.test.mjs +367 -0
  181. package/scaffold/mcp/tests/paths.test.mjs +11 -3
  182. package/scaffold/mcp/tests/pattern-evidence.test.mjs +321 -0
  183. package/scaffold/mcp/tests/project-service-registry.test.mjs +172 -0
  184. package/scaffold/mcp/tests/query-cli.test.mjs +73 -1
  185. package/scaffold/mcp/tests/review-trust-contract.test.mjs +18 -0
  186. package/scaffold/mcp/tests/search-graph-score.test.mjs +167 -0
  187. package/scaffold/mcp/tests/secure-enterprise-endpoint.test.mjs +46 -0
  188. package/scaffold/mcp/tests/skill-sync-checker.test.mjs +446 -2
  189. package/scaffold/mcp/tests/ungoverned-scanner.test.mjs +104 -22
  190. package/scaffold/mcp/tests/workflow-cli.test.mjs +14 -1
  191. package/scaffold/mcp/tests/workflow-synced-capabilities.test.mjs +37 -0
  192. package/scaffold/mcp/tests/workflow-synced-registry.test.mjs +40 -1
  193. package/scaffold/scripts/dashboard.mjs +29 -18
  194. package/scaffold/scripts/doctor.sh +26 -8
  195. package/scaffold/scripts/ingest.mjs +37 -4
  196. package/scaffold/scripts/status.sh +13 -6
@@ -0,0 +1,322 @@
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import fs from "node:fs";
4
+ import os from "node:os";
5
+ import path from "node:path";
6
+ import { execFileSync } from "node:child_process";
7
+ import {
8
+ buildPatternReviewContext,
9
+ createLocalPatternRunner,
10
+ PATTERN_REVIEW_QUESTION,
11
+ } from "../dist/enterprise/reviews/pattern-context.js";
12
+ import {
13
+ buildContextReviewAuditInput,
14
+ registerEnterpriseTools,
15
+ } from "../dist/enterprise/tools/enterprise.js";
16
+
17
+ function evidence(overrides = {}) {
18
+ return {
19
+ query: "error handling",
20
+ query_source: "explicit",
21
+ local_pattern_found: false,
22
+ fallback_used: false,
23
+ evidence_order: ["same_file", "same_module", "same_feature_area", "repo_wide"],
24
+ tiers: [
25
+ { name: "same_file", evidence: [] },
26
+ { name: "same_module", evidence: [] },
27
+ { name: "same_feature_area", evidence: [] },
28
+ { name: "repo_wide", evidence: [] },
29
+ ],
30
+ ...overrides,
31
+ };
32
+ }
33
+
34
+ test("composes deterministic non-blocking pattern context without inventing pass or fail", async () => {
35
+ const runner = async ({ target }) => {
36
+ if (target === "missing.ts") {
37
+ throw new Error("Pattern target was not found in indexed context: /private/repo/missing.ts");
38
+ }
39
+ if (target === "error.ts") {
40
+ throw new Error("secret internal stack detail");
41
+ }
42
+ if (target === "a.ts") {
43
+ return evidence({
44
+ local_pattern_found: true,
45
+ tiers: [
46
+ {
47
+ name: "same_file",
48
+ evidence: [{ id: "chunk:a", path: "a.ts", start_line: 2, end_line: 8 }],
49
+ },
50
+ ],
51
+ });
52
+ }
53
+ if (target === "b.ts") {
54
+ return evidence({
55
+ fallback_used: true,
56
+ tiers: [
57
+ {
58
+ name: "repo_wide",
59
+ evidence: [{ id: "file:docs/review.md", path: "docs/review.md" }],
60
+ },
61
+ ],
62
+ });
63
+ }
64
+ return evidence();
65
+ };
66
+
67
+ const result = await buildPatternReviewContext({
68
+ files: ["z.ts", "a.ts", "b.ts", "a.ts", "../secret.ts", "c.ts", "missing.ts", "error.ts"],
69
+ enabled: true,
70
+ query: "error handling",
71
+ topK: 2,
72
+ limit: 10,
73
+ runner,
74
+ });
75
+
76
+ assert.equal(result.enabled, true);
77
+ assert.equal(result.non_blocking, true);
78
+ assert.equal(result.affects_policy_summary, false);
79
+ assert.equal(result.review_question, PATTERN_REVIEW_QUESTION);
80
+ assert.deepEqual(result.targets.map((target) => target.path), [
81
+ "a.ts",
82
+ "b.ts",
83
+ "c.ts",
84
+ "error.ts",
85
+ "missing.ts",
86
+ "z.ts",
87
+ ]);
88
+ assert.deepEqual(result.targets.map((target) => target.status), [
89
+ "local_evidence",
90
+ "repo_fallback",
91
+ "no_evidence",
92
+ "error",
93
+ "not_indexed",
94
+ "no_evidence",
95
+ ]);
96
+ assert.equal(result.targets[0].tiers[0].evidence[0].start_line, 2);
97
+ assert.equal(result.targets[3].message, "Pattern evidence could not be produced for this target.");
98
+ assert.equal(result.targets[3].local_pattern_found, false);
99
+ assert.equal(result.targets[3].fallback_used, false);
100
+ assert.equal(result.targets[3].tiers.length, 4);
101
+ assert.equal(result.targets[4].query, "error handling");
102
+ const targetKeys = Object.keys(result.targets[0]).sort();
103
+ for (const target of result.targets) {
104
+ assert.deepEqual(Object.keys(target).sort(), targetKeys);
105
+ }
106
+ assert.doesNotMatch(JSON.stringify(result), /secret internal stack detail|\/private\/repo/u);
107
+ assert.deepEqual(result.summary, {
108
+ requested: 8,
109
+ eligible: 6,
110
+ analyzed: 6,
111
+ local_evidence: 1,
112
+ repo_fallback: 1,
113
+ no_evidence: 2,
114
+ not_indexed: 1,
115
+ errors: 1,
116
+ omitted: 0,
117
+ invalid_paths: 1,
118
+ });
119
+ });
120
+
121
+ test("sanitizes runtime warnings and unsafe citation paths", async () => {
122
+ const result = await buildPatternReviewContext({
123
+ files: ["src/a.ts"],
124
+ enabled: true,
125
+ topK: 5,
126
+ limit: 1,
127
+ runner: async () => evidence({
128
+ warning: "model cache failed at /Users/alice/private/model and C:\\Users\\alice\\model",
129
+ tiers: [
130
+ {
131
+ name: "same_file",
132
+ evidence: [
133
+ { id: "chunk:src/a.ts:run", path: "src/a.ts", start_line: 1, end_line: 3 },
134
+ { id: "chunk:/Users/alice/private", path: "/Users/alice/private/a.ts" },
135
+ { id: "chunk:C:/Users/alice/private", path: "C:\\Users\\alice\\private\\a.ts" },
136
+ { id: "chunk:../secret", path: "../secret.ts" },
137
+ ],
138
+ },
139
+ ],
140
+ }),
141
+ });
142
+
143
+ assert.equal(result.targets[0].status, "local_evidence");
144
+ assert.equal(result.targets[0].tiers[0].evidence.length, 1);
145
+ assert.equal(result.targets[0].citations_dropped, 3);
146
+ assert.equal(result.targets[0].warning, "Pattern evidence completed with local runtime warnings.");
147
+ assert.doesNotMatch(JSON.stringify(result), /Users[\\/]alice|\.\.\/secret/u);
148
+ });
149
+
150
+ test("audit projection records query size but not query text", () => {
151
+ const input = buildContextReviewAuditInput({
152
+ scope: "changed",
153
+ include_passed: true,
154
+ include_pattern_evidence: true,
155
+ pattern_query: "SECRET_API_KEY=do-not-retain",
156
+ pattern_top_k: 2,
157
+ pattern_limit: 10,
158
+ });
159
+
160
+ assert.equal(input.pattern_query_present, true);
161
+ assert.equal(input.pattern_query_length, 28);
162
+ assert.equal("pattern_query" in input, false);
163
+ assert.doesNotMatch(JSON.stringify(input), /SECRET_API_KEY/u);
164
+ });
165
+
166
+ test("bounds review targets after normalized deterministic ordering", async () => {
167
+ const calls = [];
168
+ const result = await buildPatternReviewContext({
169
+ files: ["z.ts", "./b.ts", "a.ts", "b.ts"],
170
+ enabled: true,
171
+ topK: 1,
172
+ limit: 2,
173
+ runner: async ({ target }) => {
174
+ calls.push(target);
175
+ return evidence();
176
+ },
177
+ });
178
+
179
+ assert.deepEqual(calls, ["a.ts", "b.ts"]);
180
+ assert.equal(result.summary.requested, 4);
181
+ assert.equal(result.summary.eligible, 3);
182
+ assert.equal(result.summary.analyzed, 2);
183
+ assert.equal(result.summary.omitted, 1);
184
+ });
185
+
186
+ test("default local pattern runner loads context data once across targets", async () => {
187
+ const document = (id, filePath) => ({
188
+ id,
189
+ path: filePath,
190
+ kind: "CODE",
191
+ updated_at: "2026-07-12T00:00:00.000Z",
192
+ source_of_truth: false,
193
+ trust_level: 60,
194
+ status: "active",
195
+ excerpt: "export const value = 1;",
196
+ content: "export const value = 1;",
197
+ });
198
+ const data = {
199
+ documents: [document("file:src/a.ts", "src/a.ts"), document("file:src/b.ts", "src/b.ts")],
200
+ chunks: [],
201
+ rules: [],
202
+ adrs: [],
203
+ modules: [],
204
+ projects: [],
205
+ relations: [],
206
+ ranking: { semantic: 0.4, graph: 0.25, trust: 0.2, recency: 0.15 },
207
+ source: "cache",
208
+ };
209
+ let loads = 0;
210
+ const runner = createLocalPatternRunner(async () => {
211
+ loads += 1;
212
+ return data;
213
+ });
214
+
215
+ await runner({ target: "src/a.ts", top_k: 1 });
216
+ await runner({ target: "src/b.ts", top_k: 1 });
217
+
218
+ assert.equal(loads, 1);
219
+ });
220
+
221
+ test("disabled mode does not invoke pattern retrieval", async () => {
222
+ let called = false;
223
+ const result = await buildPatternReviewContext({
224
+ files: ["a.ts", "b.ts"],
225
+ enabled: false,
226
+ topK: 2,
227
+ limit: 10,
228
+ runner: async () => {
229
+ called = true;
230
+ return evidence();
231
+ },
232
+ });
233
+
234
+ assert.equal(called, false);
235
+ assert.equal(result.enabled, false);
236
+ assert.equal(result.affects_policy_summary, false);
237
+ assert.equal(result.summary.requested, 2);
238
+ assert.deepEqual(result.targets, []);
239
+ });
240
+
241
+ test("context.review includes pattern context without changing validator summary", async () => {
242
+ const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), "cortex-pattern-review-tool-"));
243
+ const contextDir = path.join(projectRoot, ".context");
244
+ const previousProjectRoot = process.env.CORTEX_PROJECT_ROOT;
245
+ fs.mkdirSync(path.join(projectRoot, "src"), { recursive: true });
246
+ fs.writeFileSync(path.join(projectRoot, ".gitignore"), ".context/\nignored.ts\n", "utf8");
247
+ execFileSync("git", ["init"], { cwd: projectRoot, stdio: "ignore" });
248
+ execFileSync("git", ["add", ".gitignore"], { cwd: projectRoot, stdio: "ignore" });
249
+ execFileSync("git", ["-c", "user.name=Cortex Test", "-c", "user.email=cortex@example.invalid", "commit", "-m", "fixture"], {
250
+ cwd: projectRoot,
251
+ stdio: "ignore",
252
+ });
253
+ fs.mkdirSync(contextDir, { recursive: true });
254
+ fs.writeFileSync(path.join(projectRoot, "src", "new-file.ts"), "export const value = 1;\n", "utf8");
255
+ fs.writeFileSync(path.join(projectRoot, "ignored.ts"), "ignored\n", "utf8");
256
+ process.env.CORTEX_PROJECT_ROOT = projectRoot;
257
+
258
+ try {
259
+ const tools = new Map();
260
+ const server = {
261
+ registerTool(name, definition, handler) {
262
+ tools.set(name, { definition, handler });
263
+ },
264
+ };
265
+ const config = {
266
+ enterprise: { endpoint: "", api_key: "", base_url: "" },
267
+ telemetry: { enabled: false, endpoint: "", api_key: "", interval_minutes: 10 },
268
+ audit: { enabled: false, retention_days: 90 },
269
+ policy: { enabled: false, endpoint: "", api_key: "", sync_interval_minutes: 240 },
270
+ rbac: { enabled: false, default_role: "developer" },
271
+ validators: {},
272
+ compliance: { frameworks: [], eu_addons: false },
273
+ govern: {
274
+ mode: "off",
275
+ sync_on_startup: false,
276
+ sync_interval_minutes: 60,
277
+ tier_claude: "prevent",
278
+ tier_codex: "prevent",
279
+ tier_copilot: "wrap",
280
+ detect_ungoverned: false,
281
+ govern_endpoint: "",
282
+ },
283
+ };
284
+ registerEnterpriseTools(
285
+ server,
286
+ {},
287
+ null,
288
+ config,
289
+ contextDir,
290
+ { getMergedPolicies: () => [] },
291
+ "2.3.0",
292
+ );
293
+
294
+ const reviewTool = tools.get("context.review");
295
+ assert.ok(reviewTool);
296
+ const result = await reviewTool.handler({
297
+ scope: "changed",
298
+ include_passed: true,
299
+ });
300
+ const output = result.structuredContent;
301
+
302
+ assert.equal(output.summary.total, 0);
303
+ assert.equal("pattern_analyzed" in output.summary, false);
304
+ assert.equal(output.pattern_review.enabled, true);
305
+ assert.equal(output.pattern_review.affects_policy_summary, false);
306
+ assert.equal(output.pattern_review.limit, 10);
307
+ assert.equal(output.pattern_review.top_k_per_tier, 2);
308
+ assert.equal(output.pattern_review.summary.analyzed, 1);
309
+ assert.equal(output.pattern_review.targets[0].path, "src/new-file.ts");
310
+ assert.equal(output.pattern_review.targets[0].status, "not_indexed");
311
+ assert.equal(output.pattern_review.targets[0].local_pattern_found, false);
312
+ assert.equal(output.pattern_review.targets[0].fallback_used, false);
313
+ assert.equal(output.pattern_review.targets[0].tiers.length, 4);
314
+ } finally {
315
+ if (previousProjectRoot === undefined) {
316
+ delete process.env.CORTEX_PROJECT_ROOT;
317
+ } else {
318
+ process.env.CORTEX_PROJECT_ROOT = previousProjectRoot;
319
+ }
320
+ fs.rmSync(projectRoot, { recursive: true, force: true });
321
+ }
322
+ });
@@ -0,0 +1,189 @@
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import fs from "node:fs";
4
+ import os from "node:os";
5
+ import path from "node:path";
6
+
7
+ import {
8
+ bindEnterpriseIdentity,
9
+ runEnterpriseSetup,
10
+ } from "../dist/cli/enterprise-setup.js";
11
+
12
+ function makeWorkspace() {
13
+ const cwd = fs.mkdtempSync(path.join(os.tmpdir(), "cortex-enterprise-setup-"));
14
+ fs.mkdirSync(path.join(cwd, ".context"), { recursive: true });
15
+ const homeDir = path.join(cwd, "home");
16
+ fs.mkdirSync(homeDir);
17
+ process.env.HOME = homeDir;
18
+ return cwd;
19
+ }
20
+
21
+ function stubValidLicense() {
22
+ globalThis.fetch = async () => ({
23
+ ok: true,
24
+ status: 200,
25
+ json: async () => ({
26
+ valid: true,
27
+ edition: "enterprise",
28
+ features: ["govern"],
29
+ expires_at: "2099-01-01T00:00:00.000Z",
30
+ max_repos: 10,
31
+ }),
32
+ });
33
+ }
34
+
35
+ test.afterEach(() => {
36
+ delete process.env.HOME;
37
+ globalThis.fetch = undefined;
38
+ });
39
+
40
+ test("runEnterpriseSetup: atomically creates enterprise.yml with mode 0600", async () => {
41
+ const cwd = makeWorkspace();
42
+ stubValidLicense();
43
+
44
+ try {
45
+ const result = await runEnterpriseSetup({
46
+ cwd,
47
+ endpoint: "https://licenses.example.com",
48
+ apiKey: "ent_secure_12345678",
49
+ });
50
+ assert.equal(result.ok, true);
51
+ assert.ok(result.configPath);
52
+ assert.equal(fs.statSync(result.configPath).mode & 0o777, 0o600);
53
+ assert.match(fs.readFileSync(result.configPath, "utf8"), /ent_secure_12345678/);
54
+ assert.equal(
55
+ fs.existsSync(
56
+ path.join(process.env.HOME, ".cortex", "enterprise-host-identity.json"),
57
+ ),
58
+ false,
59
+ "license/config validation must not implicitly enroll host-global state",
60
+ );
61
+ assert.deepEqual(
62
+ fs.readdirSync(path.join(cwd, ".context")).filter((name) => name.endsWith(".tmp")),
63
+ [],
64
+ );
65
+ } finally {
66
+ fs.rmSync(cwd, { recursive: true, force: true });
67
+ }
68
+ });
69
+
70
+ test("bindEnterpriseIdentity creates a user-owned marker and permits explicit same-endpoint rotation", () => {
71
+ const cwd = makeWorkspace();
72
+ const homeDir = process.env.HOME;
73
+ const endpoint = "https://licenses.example.com";
74
+ try {
75
+ assert.equal(
76
+ bindEnterpriseIdentity({
77
+ endpoint,
78
+ apiKey: "ent_first_rotation_12345678",
79
+ }),
80
+ true,
81
+ );
82
+ const markerPath = path.join(
83
+ homeDir,
84
+ ".cortex",
85
+ "enterprise-host-identity.json",
86
+ );
87
+ assert.equal(fs.statSync(markerPath).mode & 0o777, 0o600);
88
+ assert.equal(fs.statSync(markerPath).uid, process.getuid());
89
+ const first = JSON.parse(fs.readFileSync(markerPath, "utf8"));
90
+
91
+ assert.equal(
92
+ bindEnterpriseIdentity({
93
+ endpoint,
94
+ apiKey: "ent_second_rotation_12345678",
95
+ }),
96
+ true,
97
+ );
98
+ const second = JSON.parse(fs.readFileSync(markerPath, "utf8"));
99
+ assert.notEqual(second.credential_id, first.credential_id);
100
+ assert.equal(second.endpoint_sha256, first.endpoint_sha256);
101
+
102
+ assert.equal(
103
+ bindEnterpriseIdentity({
104
+ endpoint: "https://another-org.example.com",
105
+ apiKey: "ent_other_endpoint_12345678",
106
+ }),
107
+ false,
108
+ );
109
+ assert.deepEqual(JSON.parse(fs.readFileSync(markerPath, "utf8")), second);
110
+ } finally {
111
+ fs.rmSync(cwd, { recursive: true, force: true });
112
+ }
113
+ });
114
+
115
+ test("bindEnterpriseIdentity refuses a symlinked user-global Cortex directory", () => {
116
+ const cwd = makeWorkspace();
117
+ const homeDir = process.env.HOME;
118
+ const outside = fs.mkdtempSync(path.join(os.tmpdir(), "cortex-host-outside-"));
119
+ fs.symlinkSync(outside, path.join(homeDir, ".cortex"), "dir");
120
+ try {
121
+ assert.equal(
122
+ bindEnterpriseIdentity({
123
+ endpoint: "https://licenses.example.com",
124
+ apiKey: "ent_symlink_guard_12345678",
125
+ }),
126
+ false,
127
+ );
128
+ assert.equal(
129
+ fs.existsSync(path.join(outside, "enterprise-host-identity.json")),
130
+ false,
131
+ );
132
+ } finally {
133
+ fs.rmSync(cwd, { recursive: true, force: true });
134
+ fs.rmSync(outside, { recursive: true, force: true });
135
+ }
136
+ });
137
+
138
+ test("runEnterpriseSetup: replacing a permissive config leaves mode 0600", async () => {
139
+ const cwd = makeWorkspace();
140
+ const configPath = path.join(cwd, ".context", "enterprise.yml");
141
+ fs.writeFileSync(configPath, "old", { encoding: "utf8", mode: 0o644 });
142
+ fs.chmodSync(configPath, 0o644);
143
+ stubValidLicense();
144
+
145
+ try {
146
+ const result = await runEnterpriseSetup({
147
+ cwd,
148
+ endpoint: "https://licenses.example.com",
149
+ apiKey: "ent_replaced_12345678",
150
+ });
151
+ assert.equal(result.ok, true);
152
+ assert.equal(fs.statSync(configPath).mode & 0o777, 0o600);
153
+ assert.doesNotMatch(fs.readFileSync(configPath, "utf8"), /^old$/);
154
+ } finally {
155
+ fs.rmSync(cwd, { recursive: true, force: true });
156
+ }
157
+ });
158
+
159
+ test("runEnterpriseSetup: rejects non-loopback HTTP before transmitting the API key", async () => {
160
+ const cwd = makeWorkspace();
161
+ let calls = 0;
162
+ globalThis.fetch = async () => {
163
+ calls += 1;
164
+ return {
165
+ ok: true,
166
+ status: 200,
167
+ json: async () => ({
168
+ valid: true,
169
+ edition: "enterprise",
170
+ features: ["govern"],
171
+ expires_at: "2099-01-01T00:00:00.000Z",
172
+ max_repos: 10,
173
+ }),
174
+ };
175
+ };
176
+
177
+ try {
178
+ const result = await runEnterpriseSetup({
179
+ cwd,
180
+ endpoint: "http://licenses.example.com",
181
+ apiKey: "ent_secure_12345678",
182
+ });
183
+ assert.equal(result.ok, false);
184
+ assert.match(result.message, /must use HTTPS/);
185
+ assert.equal(calls, 0);
186
+ } finally {
187
+ fs.rmSync(cwd, { recursive: true, force: true });
188
+ }
189
+ });
@@ -0,0 +1,81 @@
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import fs from "node:fs";
4
+ import os from "node:os";
5
+ import path from "node:path";
6
+
7
+ import {
8
+ pushGlobalUngovernedEvents,
9
+ writeGlobalUngovernedEvent,
10
+ } from "../dist/daemon/global-host-events.js";
11
+ import { claimEnterpriseHostIdentity } from "../dist/core/enterprise-host-identity.js";
12
+ import { enterpriseCredentialId } from "../dist/core/license.js";
13
+
14
+ test("global host events push only under their enrolled credential", async () => {
15
+ const cwd = fs.mkdtempSync(path.join(os.tmpdir(), "cortex-global-push-"));
16
+ const homeDir = fs.mkdtempSync(path.join(os.tmpdir(), "cortex-global-home-"));
17
+ const endpoint = "https://govern.example.com";
18
+ const apiKey = "ent_global_push_12345678";
19
+ const credentialId = enterpriseCredentialId(endpoint, apiKey);
20
+ fs.mkdirSync(path.join(cwd, ".context"));
21
+ fs.writeFileSync(
22
+ path.join(cwd, ".context", "enterprise.yml"),
23
+ [
24
+ "enterprise:",
25
+ ` api_key: ${apiKey}`,
26
+ ` endpoint: ${endpoint}`,
27
+ "",
28
+ ].join("\n"),
29
+ );
30
+ process.env.HOME = homeDir;
31
+ const requests = [];
32
+ globalThis.fetch = async (input, init) => {
33
+ requests.push({ input: String(input), init });
34
+ return { ok: true, status: 200, statusText: "OK" };
35
+ };
36
+
37
+ try {
38
+ assert.equal(claimEnterpriseHostIdentity(credentialId, endpoint), true);
39
+ assert.equal(
40
+ writeGlobalUngovernedEvent(credentialId, {
41
+ event_type: "ungoverned_ai_session_detected",
42
+ timestamp: "2026-07-28T10:00:00.000Z",
43
+ host_id: "host-1",
44
+ cli: "claude",
45
+ binary: "/usr/local/bin/claude",
46
+ pid: 42,
47
+ ppid: 1,
48
+ user: "alice",
49
+ args: "claude --prompt secret",
50
+ parent_chain: [],
51
+ mode: "advisory",
52
+ action: "logged",
53
+ }),
54
+ true,
55
+ );
56
+
57
+ assert.deepEqual(
58
+ await pushGlobalUngovernedEvents(cwd, credentialId),
59
+ { pushed: 1 },
60
+ );
61
+ assert.equal(requests.length, 1);
62
+ assert.equal(
63
+ requests[0].init.headers.Authorization,
64
+ `Bearer ${apiKey}`,
65
+ );
66
+ const body = JSON.parse(requests[0].init.body);
67
+ assert.equal(body.events[0].pid, 42);
68
+ assert.equal(body.events[0].args, "claude --prompt secret");
69
+
70
+ assert.deepEqual(
71
+ await pushGlobalUngovernedEvents(cwd, credentialId),
72
+ { pushed: 0 },
73
+ );
74
+ assert.equal(requests.length, 1);
75
+ } finally {
76
+ delete process.env.HOME;
77
+ globalThis.fetch = undefined;
78
+ fs.rmSync(cwd, { recursive: true, force: true });
79
+ fs.rmSync(homeDir, { recursive: true, force: true });
80
+ }
81
+ });