@vibecheckai/cli 3.4.0 → 3.5.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 (228) hide show
  1. package/bin/registry.js +154 -338
  2. package/bin/runners/context/generators/mcp.js +13 -15
  3. package/bin/runners/context/proof-context.js +1 -248
  4. package/bin/runners/lib/analysis-core.js +180 -198
  5. package/bin/runners/lib/analyzers.js +223 -1669
  6. package/bin/runners/lib/cli-output.js +210 -242
  7. package/bin/runners/lib/detectors-v2.js +785 -547
  8. package/bin/runners/lib/entitlements-v2.js +458 -96
  9. package/bin/runners/lib/error-handler.js +9 -16
  10. package/bin/runners/lib/global-flags.js +0 -37
  11. package/bin/runners/lib/route-truth.js +322 -1167
  12. package/bin/runners/lib/scan-output.js +469 -448
  13. package/bin/runners/lib/ship-output.js +27 -280
  14. package/bin/runners/lib/terminal-ui.js +733 -231
  15. package/bin/runners/lib/truth.js +321 -1004
  16. package/bin/runners/lib/unified-output.js +158 -162
  17. package/bin/runners/lib/upsell.js +204 -104
  18. package/bin/runners/runAllowlist.js +324 -0
  19. package/bin/runners/runAuth.js +95 -324
  20. package/bin/runners/runCheckpoint.js +21 -39
  21. package/bin/runners/runContext.js +24 -136
  22. package/bin/runners/runDoctor.js +67 -115
  23. package/bin/runners/runEvidencePack.js +219 -0
  24. package/bin/runners/runFix.js +5 -6
  25. package/bin/runners/runGuard.js +118 -212
  26. package/bin/runners/runInit.js +2 -14
  27. package/bin/runners/runInstall.js +281 -0
  28. package/bin/runners/runLabs.js +341 -0
  29. package/bin/runners/runMcp.js +52 -130
  30. package/bin/runners/runPolish.js +20 -43
  31. package/bin/runners/runProve.js +3 -13
  32. package/bin/runners/runReality.js +0 -14
  33. package/bin/runners/runReport.js +2 -3
  34. package/bin/runners/runScan.js +44 -511
  35. package/bin/runners/runShip.js +14 -28
  36. package/bin/runners/runValidate.js +2 -19
  37. package/bin/runners/runWatch.js +54 -118
  38. package/bin/vibecheck.js +41 -148
  39. package/mcp-server/ARCHITECTURE.md +339 -0
  40. package/mcp-server/__tests__/cache.test.ts +313 -0
  41. package/mcp-server/__tests__/executor.test.ts +239 -0
  42. package/mcp-server/__tests__/fixtures/exclusion-test/.cache/webpack/cache.pack +1 -0
  43. package/mcp-server/__tests__/fixtures/exclusion-test/.next/server/chunk.js +3 -0
  44. package/mcp-server/__tests__/fixtures/exclusion-test/.turbo/cache.json +3 -0
  45. package/mcp-server/__tests__/fixtures/exclusion-test/.venv/lib/env.py +3 -0
  46. package/mcp-server/__tests__/fixtures/exclusion-test/dist/bundle.js +3 -0
  47. package/mcp-server/__tests__/fixtures/exclusion-test/package.json +5 -0
  48. package/mcp-server/__tests__/fixtures/exclusion-test/src/app.ts +5 -0
  49. package/mcp-server/__tests__/fixtures/exclusion-test/venv/lib/config.py +4 -0
  50. package/mcp-server/__tests__/ids.test.ts +345 -0
  51. package/mcp-server/__tests__/integration/tools.test.ts +410 -0
  52. package/mcp-server/__tests__/registry.test.ts +365 -0
  53. package/mcp-server/__tests__/sandbox.test.ts +323 -0
  54. package/mcp-server/__tests__/schemas.test.ts +372 -0
  55. package/mcp-server/benchmarks/run-benchmarks.ts +304 -0
  56. package/mcp-server/examples/doctor.request.json +14 -0
  57. package/mcp-server/examples/doctor.response.json +53 -0
  58. package/mcp-server/examples/error.response.json +15 -0
  59. package/mcp-server/examples/scan.request.json +14 -0
  60. package/mcp-server/examples/scan.response.json +108 -0
  61. package/mcp-server/handlers/tool-handler.ts +671 -0
  62. package/mcp-server/index-v3.ts +293 -0
  63. package/mcp-server/index.js +1072 -1573
  64. package/mcp-server/index.old.js +4137 -0
  65. package/mcp-server/lib/cache.ts +341 -0
  66. package/mcp-server/lib/errors.ts +346 -0
  67. package/mcp-server/lib/executor.ts +792 -0
  68. package/mcp-server/lib/ids.ts +238 -0
  69. package/mcp-server/lib/logger.ts +368 -0
  70. package/mcp-server/lib/metrics.ts +365 -0
  71. package/mcp-server/lib/sandbox.ts +337 -0
  72. package/mcp-server/lib/validator.ts +229 -0
  73. package/mcp-server/package-lock.json +165 -0
  74. package/mcp-server/package.json +32 -7
  75. package/mcp-server/premium-tools.js +2 -2
  76. package/mcp-server/registry/tools.json +476 -0
  77. package/mcp-server/schemas/error-envelope.schema.json +125 -0
  78. package/mcp-server/schemas/finding.schema.json +167 -0
  79. package/mcp-server/schemas/report-artifact.schema.json +88 -0
  80. package/mcp-server/schemas/run-request.schema.json +75 -0
  81. package/mcp-server/schemas/verdict.schema.json +168 -0
  82. package/mcp-server/tier-auth.d.ts +71 -0
  83. package/mcp-server/tier-auth.js +371 -183
  84. package/mcp-server/truth-context.js +90 -131
  85. package/mcp-server/truth-firewall-tools.js +1000 -1611
  86. package/mcp-server/tsconfig.json +34 -0
  87. package/mcp-server/vibecheck-tools.js +2 -2
  88. package/mcp-server/vitest.config.ts +16 -0
  89. package/package.json +3 -4
  90. package/bin/runners/lib/agent-firewall/ai/false-positive-analyzer.js +0 -474
  91. package/bin/runners/lib/agent-firewall/change-packet/builder.js +0 -488
  92. package/bin/runners/lib/agent-firewall/change-packet/schema.json +0 -228
  93. package/bin/runners/lib/agent-firewall/change-packet/store.js +0 -200
  94. package/bin/runners/lib/agent-firewall/claims/claim-types.js +0 -21
  95. package/bin/runners/lib/agent-firewall/claims/extractor.js +0 -303
  96. package/bin/runners/lib/agent-firewall/claims/patterns.js +0 -24
  97. package/bin/runners/lib/agent-firewall/critic/index.js +0 -151
  98. package/bin/runners/lib/agent-firewall/critic/judge.js +0 -432
  99. package/bin/runners/lib/agent-firewall/critic/prompts.js +0 -305
  100. package/bin/runners/lib/agent-firewall/evidence/auth-evidence.js +0 -88
  101. package/bin/runners/lib/agent-firewall/evidence/contract-evidence.js +0 -75
  102. package/bin/runners/lib/agent-firewall/evidence/env-evidence.js +0 -127
  103. package/bin/runners/lib/agent-firewall/evidence/resolver.js +0 -102
  104. package/bin/runners/lib/agent-firewall/evidence/route-evidence.js +0 -213
  105. package/bin/runners/lib/agent-firewall/evidence/side-effect-evidence.js +0 -145
  106. package/bin/runners/lib/agent-firewall/fs-hook/daemon.js +0 -19
  107. package/bin/runners/lib/agent-firewall/fs-hook/installer.js +0 -87
  108. package/bin/runners/lib/agent-firewall/fs-hook/watcher.js +0 -184
  109. package/bin/runners/lib/agent-firewall/git-hook/pre-commit.js +0 -163
  110. package/bin/runners/lib/agent-firewall/ide-extension/cursor.js +0 -107
  111. package/bin/runners/lib/agent-firewall/ide-extension/vscode.js +0 -68
  112. package/bin/runners/lib/agent-firewall/ide-extension/windsurf.js +0 -66
  113. package/bin/runners/lib/agent-firewall/interceptor/base.js +0 -304
  114. package/bin/runners/lib/agent-firewall/interceptor/cursor.js +0 -35
  115. package/bin/runners/lib/agent-firewall/interceptor/vscode.js +0 -35
  116. package/bin/runners/lib/agent-firewall/interceptor/windsurf.js +0 -34
  117. package/bin/runners/lib/agent-firewall/lawbook/distributor.js +0 -465
  118. package/bin/runners/lib/agent-firewall/lawbook/evaluator.js +0 -604
  119. package/bin/runners/lib/agent-firewall/lawbook/index.js +0 -304
  120. package/bin/runners/lib/agent-firewall/lawbook/registry.js +0 -514
  121. package/bin/runners/lib/agent-firewall/lawbook/schema.js +0 -420
  122. package/bin/runners/lib/agent-firewall/logger.js +0 -141
  123. package/bin/runners/lib/agent-firewall/policy/default-policy.json +0 -90
  124. package/bin/runners/lib/agent-firewall/policy/engine.js +0 -103
  125. package/bin/runners/lib/agent-firewall/policy/loader.js +0 -451
  126. package/bin/runners/lib/agent-firewall/policy/rules/auth-drift.js +0 -50
  127. package/bin/runners/lib/agent-firewall/policy/rules/contract-drift.js +0 -50
  128. package/bin/runners/lib/agent-firewall/policy/rules/fake-success.js +0 -86
  129. package/bin/runners/lib/agent-firewall/policy/rules/ghost-env.js +0 -162
  130. package/bin/runners/lib/agent-firewall/policy/rules/ghost-route.js +0 -189
  131. package/bin/runners/lib/agent-firewall/policy/rules/scope.js +0 -93
  132. package/bin/runners/lib/agent-firewall/policy/rules/unsafe-side-effect.js +0 -57
  133. package/bin/runners/lib/agent-firewall/policy/schema.json +0 -183
  134. package/bin/runners/lib/agent-firewall/policy/verdict.js +0 -54
  135. package/bin/runners/lib/agent-firewall/proposal/extractor.js +0 -394
  136. package/bin/runners/lib/agent-firewall/proposal/index.js +0 -212
  137. package/bin/runners/lib/agent-firewall/proposal/schema.js +0 -251
  138. package/bin/runners/lib/agent-firewall/proposal/validator.js +0 -386
  139. package/bin/runners/lib/agent-firewall/reality/index.js +0 -332
  140. package/bin/runners/lib/agent-firewall/reality/state.js +0 -625
  141. package/bin/runners/lib/agent-firewall/reality/watcher.js +0 -322
  142. package/bin/runners/lib/agent-firewall/risk/index.js +0 -173
  143. package/bin/runners/lib/agent-firewall/risk/scorer.js +0 -328
  144. package/bin/runners/lib/agent-firewall/risk/thresholds.js +0 -321
  145. package/bin/runners/lib/agent-firewall/risk/vectors.js +0 -421
  146. package/bin/runners/lib/agent-firewall/simulator/diff-simulator.js +0 -472
  147. package/bin/runners/lib/agent-firewall/simulator/import-resolver.js +0 -346
  148. package/bin/runners/lib/agent-firewall/simulator/index.js +0 -181
  149. package/bin/runners/lib/agent-firewall/simulator/route-validator.js +0 -380
  150. package/bin/runners/lib/agent-firewall/time-machine/incident-correlator.js +0 -661
  151. package/bin/runners/lib/agent-firewall/time-machine/index.js +0 -267
  152. package/bin/runners/lib/agent-firewall/time-machine/replay-engine.js +0 -436
  153. package/bin/runners/lib/agent-firewall/time-machine/state-reconstructor.js +0 -490
  154. package/bin/runners/lib/agent-firewall/time-machine/timeline-builder.js +0 -530
  155. package/bin/runners/lib/agent-firewall/truthpack/index.js +0 -67
  156. package/bin/runners/lib/agent-firewall/truthpack/loader.js +0 -137
  157. package/bin/runners/lib/agent-firewall/unblock/planner.js +0 -337
  158. package/bin/runners/lib/agent-firewall/utils/ignore-checker.js +0 -118
  159. package/bin/runners/lib/api-client.js +0 -269
  160. package/bin/runners/lib/authority-badge.js +0 -425
  161. package/bin/runners/lib/engines/accessibility-engine.js +0 -190
  162. package/bin/runners/lib/engines/api-consistency-engine.js +0 -162
  163. package/bin/runners/lib/engines/ast-cache.js +0 -99
  164. package/bin/runners/lib/engines/code-quality-engine.js +0 -255
  165. package/bin/runners/lib/engines/console-logs-engine.js +0 -115
  166. package/bin/runners/lib/engines/cross-file-analysis-engine.js +0 -268
  167. package/bin/runners/lib/engines/dead-code-engine.js +0 -198
  168. package/bin/runners/lib/engines/deprecated-api-engine.js +0 -226
  169. package/bin/runners/lib/engines/empty-catch-engine.js +0 -150
  170. package/bin/runners/lib/engines/file-filter.js +0 -131
  171. package/bin/runners/lib/engines/hardcoded-secrets-engine.js +0 -251
  172. package/bin/runners/lib/engines/mock-data-engine.js +0 -272
  173. package/bin/runners/lib/engines/parallel-processor.js +0 -71
  174. package/bin/runners/lib/engines/performance-issues-engine.js +0 -265
  175. package/bin/runners/lib/engines/security-vulnerabilities-engine.js +0 -243
  176. package/bin/runners/lib/engines/todo-fixme-engine.js +0 -115
  177. package/bin/runners/lib/engines/type-aware-engine.js +0 -152
  178. package/bin/runners/lib/engines/unsafe-regex-engine.js +0 -225
  179. package/bin/runners/lib/engines/vibecheck-engines/README.md +0 -53
  180. package/bin/runners/lib/engines/vibecheck-engines/index.js +0 -15
  181. package/bin/runners/lib/engines/vibecheck-engines/lib/ast-cache.js +0 -164
  182. package/bin/runners/lib/engines/vibecheck-engines/lib/code-quality-engine.js +0 -291
  183. package/bin/runners/lib/engines/vibecheck-engines/lib/console-logs-engine.js +0 -83
  184. package/bin/runners/lib/engines/vibecheck-engines/lib/dead-code-engine.js +0 -198
  185. package/bin/runners/lib/engines/vibecheck-engines/lib/deprecated-api-engine.js +0 -275
  186. package/bin/runners/lib/engines/vibecheck-engines/lib/empty-catch-engine.js +0 -167
  187. package/bin/runners/lib/engines/vibecheck-engines/lib/file-filter.js +0 -217
  188. package/bin/runners/lib/engines/vibecheck-engines/lib/hardcoded-secrets-engine.js +0 -139
  189. package/bin/runners/lib/engines/vibecheck-engines/lib/mock-data-engine.js +0 -140
  190. package/bin/runners/lib/engines/vibecheck-engines/lib/parallel-processor.js +0 -164
  191. package/bin/runners/lib/engines/vibecheck-engines/lib/performance-issues-engine.js +0 -234
  192. package/bin/runners/lib/engines/vibecheck-engines/lib/type-aware-engine.js +0 -217
  193. package/bin/runners/lib/engines/vibecheck-engines/lib/unsafe-regex-engine.js +0 -78
  194. package/bin/runners/lib/engines/vibecheck-engines/package.json +0 -13
  195. package/bin/runners/lib/exit-codes.js +0 -275
  196. package/bin/runners/lib/fingerprint.js +0 -377
  197. package/bin/runners/lib/help-formatter.js +0 -413
  198. package/bin/runners/lib/logger.js +0 -38
  199. package/bin/runners/lib/ship-output-enterprise.js +0 -239
  200. package/bin/runners/lib/unified-cli-output.js +0 -604
  201. package/bin/runners/runAgent.d.ts +0 -5
  202. package/bin/runners/runAgent.js +0 -161
  203. package/bin/runners/runApprove.js +0 -1200
  204. package/bin/runners/runClassify.js +0 -859
  205. package/bin/runners/runContext.d.ts +0 -4
  206. package/bin/runners/runFirewall.d.ts +0 -5
  207. package/bin/runners/runFirewall.js +0 -134
  208. package/bin/runners/runFirewallHook.d.ts +0 -5
  209. package/bin/runners/runFirewallHook.js +0 -56
  210. package/bin/runners/runPolish.d.ts +0 -4
  211. package/bin/runners/runProof.zip +0 -0
  212. package/bin/runners/runTruth.d.ts +0 -5
  213. package/bin/runners/runTruth.js +0 -101
  214. package/mcp-server/HARDENING_SUMMARY.md +0 -299
  215. package/mcp-server/agent-firewall-interceptor.js +0 -500
  216. package/mcp-server/authority-tools.js +0 -569
  217. package/mcp-server/conductor/conflict-resolver.js +0 -588
  218. package/mcp-server/conductor/execution-planner.js +0 -544
  219. package/mcp-server/conductor/index.js +0 -377
  220. package/mcp-server/conductor/lock-manager.js +0 -615
  221. package/mcp-server/conductor/request-queue.js +0 -550
  222. package/mcp-server/conductor/session-manager.js +0 -500
  223. package/mcp-server/conductor/tools.js +0 -510
  224. package/mcp-server/lib/api-client.cjs +0 -13
  225. package/mcp-server/lib/logger.cjs +0 -30
  226. package/mcp-server/logger.js +0 -173
  227. package/mcp-server/tools-v3.js +0 -706
  228. package/mcp-server/vibecheck-mcp-server-3.2.0.tgz +0 -0
@@ -1,35 +0,0 @@
1
- /**
2
- * Cursor IDE Interceptor
3
- *
4
- * Cursor-specific integration for agent firewall.
5
- * Hooks into Cursor's file write events.
6
- */
7
-
8
- "use strict";
9
-
10
- const { interceptFileWrite } = require("./base");
11
-
12
- /**
13
- * Intercept file write in Cursor
14
- * This would be called by Cursor's extension/plugin system
15
- */
16
- async function interceptCursorWrite({
17
- projectRoot,
18
- filePath,
19
- content,
20
- oldContent,
21
- agentId = "cursor"
22
- }) {
23
- return await interceptFileWrite({
24
- projectRoot,
25
- agentId,
26
- intent: "Cursor AI edit",
27
- filePath,
28
- content,
29
- oldContent
30
- });
31
- }
32
-
33
- module.exports = {
34
- interceptCursorWrite
35
- };
@@ -1,35 +0,0 @@
1
- /**
2
- * VS Code LSP Interceptor
3
- *
4
- * VS Code LSP integration for agent firewall.
5
- * Generic LSP hook for file writes.
6
- */
7
-
8
- "use strict";
9
-
10
- const { interceptFileWrite } = require("./base");
11
-
12
- /**
13
- * Intercept file write via LSP
14
- * This would be called by VS Code's LSP server
15
- */
16
- async function interceptVSCodeWrite({
17
- projectRoot,
18
- filePath,
19
- content,
20
- oldContent,
21
- agentId = "vscode"
22
- }) {
23
- return await interceptFileWrite({
24
- projectRoot,
25
- agentId,
26
- intent: "VS Code AI edit",
27
- filePath,
28
- content,
29
- oldContent
30
- });
31
- }
32
-
33
- module.exports = {
34
- interceptVSCodeWrite
35
- };
@@ -1,34 +0,0 @@
1
- /**
2
- * Windsurf IDE Interceptor
3
- *
4
- * Windsurf-specific integration for agent firewall.
5
- */
6
-
7
- "use strict";
8
-
9
- const { interceptFileWrite } = require("./base");
10
-
11
- /**
12
- * Intercept file write in Windsurf
13
- * This would be called by Windsurf's extension/plugin system
14
- */
15
- async function interceptWindsurfWrite({
16
- projectRoot,
17
- filePath,
18
- content,
19
- oldContent,
20
- agentId = "windsurf"
21
- }) {
22
- return await interceptFileWrite({
23
- projectRoot,
24
- agentId,
25
- intent: "Windsurf AI edit",
26
- filePath,
27
- content,
28
- oldContent
29
- });
30
- }
31
-
32
- module.exports = {
33
- interceptWindsurfWrite
34
- };
@@ -1,465 +0,0 @@
1
- /**
2
- * Lawbook Distributor
3
- *
4
- * Syncs org-level policies to projects via API.
5
- * Manages version control and conflict resolution.
6
- *
7
- * Codename: Lawbook
8
- */
9
-
10
- "use strict";
11
-
12
- const fs = require("fs");
13
- const path = require("path");
14
- const crypto = require("crypto");
15
-
16
- const { parseLawbook, serializeLawbook, validateInvariant } = require("./schema.js");
17
- const { lawbookLogger: log, getErrorMessage } = require("../logger.js");
18
-
19
- /**
20
- * @typedef {Object} SyncResult
21
- * @property {boolean} success - Sync successful
22
- * @property {number} added - Invariants added
23
- * @property {number} updated - Invariants updated
24
- * @property {number} removed - Invariants removed
25
- * @property {string[]} conflicts - Conflict descriptions
26
- * @property {string} version - Synced version
27
- */
28
-
29
- /**
30
- * Merge strategies for conflict resolution
31
- */
32
- const MERGE_STRATEGIES = {
33
- ORG_WINS: "org_wins", // Org policies override local
34
- LOCAL_WINS: "local_wins", // Local policies override org
35
- STRICT: "strict", // Fail on conflicts
36
- MERGE: "merge", // Merge with local taking precedence on conflicts
37
- };
38
-
39
- /**
40
- * Lawbook Distributor class
41
- */
42
- class LawbookDistributor {
43
- constructor(options = {}) {
44
- this.projectRoot = options.projectRoot || process.cwd();
45
- this.apiEndpoint = options.apiEndpoint || process.env.VIBECHECK_API_URL || "https://api.vibecheck.ai";
46
- this.apiKey = options.apiKey || process.env.VIBECHECK_API_KEY;
47
- this.cacheDir = path.join(this.projectRoot, ".vibecheck", "lawbook-cache");
48
- this.syncHistoryPath = path.join(this.projectRoot, ".vibecheck", "lawbook-sync.json");
49
- }
50
-
51
- /**
52
- * Fetch org lawbook from API
53
- * @param {string} orgId - Organization ID
54
- * @param {string} libraryId - Library ID (optional)
55
- * @returns {Object} Fetched lawbook
56
- */
57
- async fetchOrgLawbook(orgId, libraryId = "default") {
58
- try {
59
- const url = `${this.apiEndpoint}/v1/orgs/${orgId}/lawbooks/${libraryId}`;
60
-
61
- const response = await fetch(url, {
62
- headers: {
63
- "Authorization": `Bearer ${this.apiKey}`,
64
- "Content-Type": "application/json",
65
- },
66
- });
67
-
68
- if (!response.ok) {
69
- throw new Error(`Failed to fetch lawbook: ${response.status}`);
70
- }
71
-
72
- const data = await response.json();
73
-
74
- // Cache the result
75
- this.cacheLawbook(orgId, libraryId, data);
76
-
77
- return data;
78
- } catch (error) {
79
- // Try to use cached version
80
- const cached = this.getCachedLawbook(orgId, libraryId);
81
- if (cached) {
82
- log.warn(`Using cached lawbook: ${getErrorMessage(error)}`);
83
- return cached;
84
- }
85
- throw error;
86
- }
87
- }
88
-
89
- /**
90
- * Sync org lawbook to local project
91
- * @param {string} orgId - Organization ID
92
- * @param {Object} options - Sync options
93
- * @returns {SyncResult} Sync result
94
- */
95
- async sync(orgId, options = {}) {
96
- const {
97
- libraryId = "default",
98
- strategy = MERGE_STRATEGIES.MERGE,
99
- dryRun = false,
100
- } = options;
101
-
102
- const result = {
103
- success: false,
104
- added: 0,
105
- updated: 0,
106
- removed: 0,
107
- conflicts: [],
108
- version: null,
109
- };
110
-
111
- try {
112
- // Fetch org lawbook
113
- const orgLawbook = await this.fetchOrgLawbook(orgId, libraryId);
114
- result.version = orgLawbook.version;
115
-
116
- // Load local lawbook
117
- const localPath = path.join(this.projectRoot, ".vibecheck", "invariants.yaml");
118
- let localLawbook = null;
119
-
120
- if (fs.existsSync(localPath)) {
121
- const content = fs.readFileSync(localPath, "utf-8");
122
- localLawbook = parseLawbook(content);
123
- }
124
-
125
- // Merge lawbooks
126
- const merged = this.mergeLawbooks(orgLawbook, localLawbook, strategy, result);
127
-
128
- // Apply changes if not dry run
129
- if (!dryRun && result.conflicts.length === 0) {
130
- const dir = path.dirname(localPath);
131
- if (!fs.existsSync(dir)) {
132
- fs.mkdirSync(dir, { recursive: true });
133
- }
134
-
135
- const content = serializeLawbook(merged);
136
- fs.writeFileSync(localPath, content);
137
-
138
- // Record sync
139
- this.recordSync(orgId, libraryId, result.version);
140
-
141
- result.success = true;
142
- } else if (dryRun) {
143
- result.success = true;
144
- }
145
-
146
- return result;
147
- } catch (error) {
148
- result.success = false;
149
- result.conflicts.push(`Sync error: ${error.message}`);
150
- return result;
151
- }
152
- }
153
-
154
- /**
155
- * Merge org and local lawbooks
156
- * @param {Object} orgLawbook - Org lawbook
157
- * @param {Object} localLawbook - Local lawbook
158
- * @param {string} strategy - Merge strategy
159
- * @param {Object} result - Result object to update
160
- * @returns {Object} Merged lawbook
161
- */
162
- mergeLawbooks(orgLawbook, localLawbook, strategy, result) {
163
- const merged = {
164
- version: orgLawbook.version,
165
- name: localLawbook?.name || orgLawbook.name,
166
- description: localLawbook?.description || orgLawbook.description,
167
- extends: orgLawbook.name,
168
- invariants: [],
169
- };
170
-
171
- // Index invariants by ID
172
- const orgInvariants = new Map();
173
- const localInvariants = new Map();
174
-
175
- for (const inv of orgLawbook.invariants || []) {
176
- inv._source = "org";
177
- orgInvariants.set(inv.id, inv);
178
- }
179
-
180
- for (const inv of localLawbook?.invariants || []) {
181
- inv._source = "local";
182
- localInvariants.set(inv.id, inv);
183
- }
184
-
185
- // Process org invariants
186
- for (const [id, orgInv] of orgInvariants) {
187
- const localInv = localInvariants.get(id);
188
-
189
- if (!localInv) {
190
- // New from org
191
- merged.invariants.push({ ...orgInv, _source: undefined });
192
- result.added++;
193
- } else {
194
- // Exists in both - check for conflicts
195
- const conflict = this.detectConflict(orgInv, localInv);
196
-
197
- if (conflict) {
198
- switch (strategy) {
199
- case MERGE_STRATEGIES.ORG_WINS:
200
- merged.invariants.push({ ...orgInv, _source: undefined });
201
- result.updated++;
202
- break;
203
-
204
- case MERGE_STRATEGIES.LOCAL_WINS:
205
- merged.invariants.push({ ...localInv, _source: undefined });
206
- break;
207
-
208
- case MERGE_STRATEGIES.STRICT:
209
- result.conflicts.push(`Conflict on '${id}': ${conflict}`);
210
- break;
211
-
212
- case MERGE_STRATEGIES.MERGE:
213
- default:
214
- // Merge with local taking precedence
215
- const mergedInv = { ...orgInv, ...localInv, _source: undefined };
216
- merged.invariants.push(mergedInv);
217
- result.updated++;
218
- break;
219
- }
220
- } else {
221
- // No conflict - use org version (might have updates)
222
- merged.invariants.push({ ...orgInv, _source: undefined });
223
- }
224
-
225
- localInvariants.delete(id);
226
- }
227
- }
228
-
229
- // Add remaining local-only invariants
230
- for (const [, localInv] of localInvariants) {
231
- merged.invariants.push({ ...localInv, _source: undefined });
232
- }
233
-
234
- return merged;
235
- }
236
-
237
- /**
238
- * Detect conflict between org and local invariant
239
- * @param {Object} orgInv - Org invariant
240
- * @param {Object} localInv - Local invariant
241
- * @returns {string|null} Conflict description or null
242
- */
243
- detectConflict(orgInv, localInv) {
244
- // Check for rule type conflict
245
- if (orgInv.rule !== localInv.rule) {
246
- return `Rule type mismatch: org='${orgInv.rule}', local='${localInv.rule}'`;
247
- }
248
-
249
- // Check for severity conflict
250
- if (orgInv.severity !== localInv.severity) {
251
- return `Severity mismatch: org='${orgInv.severity}', local='${localInv.severity}'`;
252
- }
253
-
254
- // Check for scope conflict
255
- if (orgInv.scope !== localInv.scope) {
256
- return `Scope mismatch: org='${orgInv.scope}', local='${localInv.scope}'`;
257
- }
258
-
259
- return null;
260
- }
261
-
262
- /**
263
- * Cache a lawbook locally
264
- * @param {string} orgId - Org ID
265
- * @param {string} libraryId - Library ID
266
- * @param {Object} lawbook - Lawbook to cache
267
- */
268
- cacheLawbook(orgId, libraryId, lawbook) {
269
- try {
270
- if (!fs.existsSync(this.cacheDir)) {
271
- fs.mkdirSync(this.cacheDir, { recursive: true });
272
- }
273
-
274
- const cachePath = path.join(this.cacheDir, `${orgId}-${libraryId}.json`);
275
- fs.writeFileSync(cachePath, JSON.stringify({
276
- lawbook,
277
- cachedAt: new Date().toISOString(),
278
- }, null, 2));
279
- } catch (error) {
280
- log.warn(`Failed to cache lawbook: ${getErrorMessage(error)}`);
281
- }
282
- }
283
-
284
- /**
285
- * Get cached lawbook
286
- * @param {string} orgId - Org ID
287
- * @param {string} libraryId - Library ID
288
- * @returns {Object|null} Cached lawbook or null
289
- */
290
- getCachedLawbook(orgId, libraryId) {
291
- try {
292
- const cachePath = path.join(this.cacheDir, `${orgId}-${libraryId}.json`);
293
-
294
- if (fs.existsSync(cachePath)) {
295
- const content = fs.readFileSync(cachePath, "utf-8");
296
- const cached = JSON.parse(content);
297
-
298
- // Check cache age (24 hours max)
299
- const cacheAge = Date.now() - new Date(cached.cachedAt).getTime();
300
- if (cacheAge < 24 * 60 * 60 * 1000) {
301
- return cached.lawbook;
302
- }
303
- }
304
- } catch (error) {
305
- log.warn(`Failed to read cached lawbook: ${getErrorMessage(error)}`);
306
- }
307
- return null;
308
- }
309
-
310
- /**
311
- * Record a sync event
312
- * @param {string} orgId - Org ID
313
- * @param {string} libraryId - Library ID
314
- * @param {string} version - Synced version
315
- */
316
- recordSync(orgId, libraryId, version) {
317
- try {
318
- let history = [];
319
-
320
- if (fs.existsSync(this.syncHistoryPath)) {
321
- const content = fs.readFileSync(this.syncHistoryPath, "utf-8");
322
- history = JSON.parse(content);
323
- }
324
-
325
- history.push({
326
- orgId,
327
- libraryId,
328
- version,
329
- syncedAt: new Date().toISOString(),
330
- });
331
-
332
- // Keep last 50 entries
333
- if (history.length > 50) {
334
- history = history.slice(-50);
335
- }
336
-
337
- const dir = path.dirname(this.syncHistoryPath);
338
- if (!fs.existsSync(dir)) {
339
- fs.mkdirSync(dir, { recursive: true });
340
- }
341
-
342
- fs.writeFileSync(this.syncHistoryPath, JSON.stringify(history, null, 2));
343
- } catch (error) {
344
- log.warn(`Failed to record sync: ${getErrorMessage(error)}`);
345
- }
346
- }
347
-
348
- /**
349
- * Get sync history
350
- * @returns {Object[]} Sync history
351
- */
352
- getSyncHistory() {
353
- try {
354
- if (fs.existsSync(this.syncHistoryPath)) {
355
- const content = fs.readFileSync(this.syncHistoryPath, "utf-8");
356
- return JSON.parse(content);
357
- }
358
- } catch (error) {
359
- log.warn(`Failed to read sync history: ${getErrorMessage(error)}`);
360
- }
361
- return [];
362
- }
363
-
364
- /**
365
- * Check if sync is needed
366
- * @param {string} orgId - Org ID
367
- * @param {string} libraryId - Library ID
368
- * @returns {Object} Sync status
369
- */
370
- async checkSyncStatus(orgId, libraryId = "default") {
371
- const history = this.getSyncHistory();
372
- const lastSync = history.filter(h => h.orgId === orgId && h.libraryId === libraryId).pop();
373
-
374
- // Fetch current version from API
375
- try {
376
- const url = `${this.apiEndpoint}/v1/orgs/${orgId}/lawbooks/${libraryId}/version`;
377
- const response = await fetch(url, {
378
- headers: {
379
- "Authorization": `Bearer ${this.apiKey}`,
380
- },
381
- });
382
-
383
- if (response.ok) {
384
- const data = await response.json();
385
-
386
- return {
387
- needsSync: !lastSync || lastSync.version !== data.version,
388
- currentVersion: data.version,
389
- lastSyncVersion: lastSync?.version || null,
390
- lastSyncTime: lastSync?.syncedAt || null,
391
- };
392
- }
393
- } catch (error) {
394
- // Ignore - will use cached data
395
- }
396
-
397
- return {
398
- needsSync: !lastSync,
399
- currentVersion: null,
400
- lastSyncVersion: lastSync?.version || null,
401
- lastSyncTime: lastSync?.syncedAt || null,
402
- };
403
- }
404
-
405
- /**
406
- * Publish local invariants to org (requires admin)
407
- * @param {string} orgId - Org ID
408
- * @param {Object[]} invariants - Invariants to publish
409
- * @returns {Object} Publish result
410
- */
411
- async publishToOrg(orgId, invariants, options = {}) {
412
- const {
413
- libraryId = "default",
414
- message = "Published from local project",
415
- } = options;
416
-
417
- try {
418
- // Validate all invariants first
419
- for (const inv of invariants) {
420
- const validation = validateInvariant(inv);
421
- if (!validation.valid) {
422
- throw new Error(`Invalid invariant '${inv.id}': ${validation.errors.map(e => e.message).join(", ")}`);
423
- }
424
- }
425
-
426
- const url = `${this.apiEndpoint}/v1/orgs/${orgId}/lawbooks/${libraryId}/publish`;
427
-
428
- const response = await fetch(url, {
429
- method: "POST",
430
- headers: {
431
- "Authorization": `Bearer ${this.apiKey}`,
432
- "Content-Type": "application/json",
433
- },
434
- body: JSON.stringify({
435
- invariants,
436
- message,
437
- publishedAt: new Date().toISOString(),
438
- }),
439
- });
440
-
441
- if (!response.ok) {
442
- const error = await response.json().catch(() => ({}));
443
- throw new Error(error.message || `Publish failed: ${response.status}`);
444
- }
445
-
446
- return await response.json();
447
- } catch (error) {
448
- return {
449
- success: false,
450
- error: error.message,
451
- };
452
- }
453
- }
454
- }
455
-
456
- /**
457
- * Create a distributor instance
458
- * @param {Object} options - Options
459
- * @returns {LawbookDistributor} Distributor instance
460
- */
461
- function createDistributor(options = {}) {
462
- return new LawbookDistributor(options);
463
- }
464
-
465
- module.exports = { LawbookDistributor, createDistributor, MERGE_STRATEGIES };