@neuroverseos/governance 0.3.4 → 0.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 (129) hide show
  1. package/README.md +280 -405
  2. package/dist/adapters/autoresearch.cjs +63 -9
  3. package/dist/adapters/autoresearch.d.cts +2 -1
  4. package/dist/adapters/autoresearch.d.ts +2 -1
  5. package/dist/adapters/autoresearch.js +3 -3
  6. package/dist/adapters/deep-agents.cjs +63 -9
  7. package/dist/adapters/deep-agents.d.cts +3 -2
  8. package/dist/adapters/deep-agents.d.ts +3 -2
  9. package/dist/adapters/deep-agents.js +3 -3
  10. package/dist/adapters/express.cjs +63 -9
  11. package/dist/adapters/express.d.cts +2 -1
  12. package/dist/adapters/express.d.ts +2 -1
  13. package/dist/adapters/express.js +3 -3
  14. package/dist/adapters/index.cjs +961 -9
  15. package/dist/adapters/index.d.cts +4 -2
  16. package/dist/adapters/index.d.ts +4 -2
  17. package/dist/adapters/index.js +54 -17
  18. package/dist/adapters/langchain.cjs +63 -9
  19. package/dist/adapters/langchain.d.cts +3 -2
  20. package/dist/adapters/langchain.d.ts +3 -2
  21. package/dist/adapters/langchain.js +3 -3
  22. package/dist/adapters/mentraos.cjs +2181 -0
  23. package/dist/adapters/mentraos.d.cts +319 -0
  24. package/dist/adapters/mentraos.d.ts +319 -0
  25. package/dist/adapters/mentraos.js +48 -0
  26. package/dist/adapters/openai.cjs +63 -9
  27. package/dist/adapters/openai.d.cts +3 -2
  28. package/dist/adapters/openai.d.ts +3 -2
  29. package/dist/adapters/openai.js +3 -3
  30. package/dist/adapters/openclaw.cjs +63 -9
  31. package/dist/adapters/openclaw.d.cts +3 -2
  32. package/dist/adapters/openclaw.d.ts +3 -2
  33. package/dist/adapters/openclaw.js +3 -3
  34. package/dist/{add-ROOZLU62.js → add-XSANI3FK.js} +1 -1
  35. package/dist/{behavioral-MJO34S6Q.js → behavioral-SLW7ALEK.js} +4 -4
  36. package/dist/{bootstrap-CQRZVOXK.js → bootstrap-2OW5ZLBL.js} +4 -4
  37. package/dist/bootstrap-contract-DcV6t-8M.d.cts +216 -0
  38. package/dist/bootstrap-contract-DcV6t-8M.d.ts +216 -0
  39. package/dist/browser.global.js +149 -5
  40. package/dist/{build-ZHPMX5AZ.js → build-EGBGZFIJ.js} +6 -6
  41. package/dist/{chunk-A7GKPPU7.js → chunk-2VAWP6FI.js} +1 -1
  42. package/dist/{chunk-3WQLXYTP.js → chunk-3AYKQHYI.js} +2 -2
  43. package/dist/{chunk-EMQDLDAF.js → chunk-3NZMMSOW.js} +80 -2
  44. package/dist/chunk-3S5AD4AB.js +421 -0
  45. package/dist/{chunk-VXHSMA3I.js → chunk-6CV4XG3J.js} +1 -1
  46. package/dist/{chunk-BNKJPUPQ.js → chunk-A7SHG75T.js} +2 -2
  47. package/dist/{chunk-U6U7EJZL.js → chunk-AV7XJJWK.js} +2 -2
  48. package/dist/{chunk-ZWI3NIXK.js → chunk-CYDMUJVZ.js} +54 -3
  49. package/dist/{chunk-F66BVUYB.js → chunk-DA5MHFRR.js} +3 -3
  50. package/dist/{chunk-YEKMVDWK.js → chunk-FHXXD2TI.js} +7 -7
  51. package/dist/{chunk-5TPFNWRU.js → chunk-FS2UUJJO.js} +3 -3
  52. package/dist/{chunk-4FLICVVA.js → chunk-FVOGUCB6.js} +2 -2
  53. package/dist/chunk-GTPV2XGO.js +893 -0
  54. package/dist/{chunk-CTZHONLA.js → chunk-I4RTIMLX.js} +2 -2
  55. package/dist/{chunk-B6OXJLJ5.js → chunk-J2IZBHXJ.js} +4 -4
  56. package/dist/{chunk-TG6SEF24.js → chunk-OQU65525.js} +1 -1
  57. package/dist/{chunk-QXBFT7NI.js → chunk-QMVQ6KPL.js} +2 -2
  58. package/dist/{chunk-G7DJ6VOD.js → chunk-RDA7ISWC.js} +2 -2
  59. package/dist/{chunk-O5ABKEA7.js → chunk-YJ34R5NB.js} +2 -2
  60. package/dist/{chunk-PVTQQS3Y.js → chunk-YPCVY4GS.js} +31 -0
  61. package/dist/{chunk-W7LLXRGY.js → chunk-ZAF6JH23.js} +65 -10
  62. package/dist/{chunk-IS4WUH6Y.js → chunk-ZEIT2QLM.js} +4 -4
  63. package/dist/cli/neuroverse.cjs +4436 -1035
  64. package/dist/cli/neuroverse.js +40 -24
  65. package/dist/cli/plan.cjs +176 -12
  66. package/dist/cli/plan.js +2 -2
  67. package/dist/cli/run.cjs +63 -9
  68. package/dist/cli/run.js +2 -2
  69. package/dist/configure-world-XU2COHOZ.js +705 -0
  70. package/dist/{decision-flow-M63D47LO.js → decision-flow-3K4D72G4.js} +2 -2
  71. package/dist/{demo-G43RLCPK.js → demo-6OQYWRR6.js} +4 -4
  72. package/dist/{derive-LMDUTXDD.js → derive-7Y7YWVLU.js} +5 -5
  73. package/dist/{doctor-6BC6X2VO.js → doctor-NHXI7OQW.js} +3 -1
  74. package/dist/engine/bootstrap-emitter.cjs +241 -0
  75. package/dist/engine/bootstrap-emitter.d.cts +27 -0
  76. package/dist/engine/bootstrap-emitter.d.ts +27 -0
  77. package/dist/{bootstrap-emitter-Q7UIJZ2O.js → engine/bootstrap-emitter.js} +2 -2
  78. package/dist/engine/bootstrap-parser.cjs +560 -0
  79. package/dist/engine/bootstrap-parser.d.cts +96 -0
  80. package/dist/engine/bootstrap-parser.d.ts +96 -0
  81. package/dist/{bootstrap-parser-EEF36XDU.js → engine/bootstrap-parser.js} +2 -2
  82. package/dist/engine/guard-engine.cjs +1116 -0
  83. package/dist/engine/guard-engine.d.cts +60 -0
  84. package/dist/engine/guard-engine.d.ts +60 -0
  85. package/dist/engine/guard-engine.js +12 -0
  86. package/dist/engine/simulate-engine.cjs +390 -0
  87. package/dist/engine/simulate-engine.d.cts +105 -0
  88. package/dist/engine/simulate-engine.d.ts +105 -0
  89. package/dist/engine/simulate-engine.js +9 -0
  90. package/dist/{equity-penalties-SG5IZQ7I.js → equity-penalties-NVBAB5WL.js} +4 -4
  91. package/dist/{explain-RHBU2GBR.js → explain-HDFN4ION.js} +1 -1
  92. package/dist/github-TIKTWOGU.js +27 -0
  93. package/dist/{guard-AEEJNWLD.js → guard-6KSCWT2W.js} +4 -4
  94. package/dist/{guard-contract-B7lplwm9.d.cts → guard-contract-C991HDZp.d.cts} +32 -309
  95. package/dist/{guard-contract-B7lplwm9.d.ts → guard-contract-hHjTTjtR.d.ts} +32 -309
  96. package/dist/{impact-3XVDSCBU.js → impact-WIAM66IH.js} +3 -3
  97. package/dist/{improve-TQP4ECSY.js → improve-2PWGGO5B.js} +3 -3
  98. package/dist/index.cjs +682 -14
  99. package/dist/index.d.cts +231 -423
  100. package/dist/index.d.ts +231 -423
  101. package/dist/index.js +81 -58
  102. package/dist/{init-FYPV4SST.js → init-TKIJDR7I.js} +5 -1
  103. package/dist/lens-MHMUDCMQ.js +1084 -0
  104. package/dist/{mcp-server-5Y3ZM7TV.js → mcp-server-TNIWZ7B5.js} +3 -3
  105. package/dist/{playground-VZBNPPBO.js → playground-3FLDGBET.js} +3 -3
  106. package/dist/{redteam-MZPZD3EF.js → redteam-HV6LMKEH.js} +3 -3
  107. package/dist/{session-JYOARW54.js → session-XZP2754M.js} +3 -3
  108. package/dist/{shared-C_zpdvBm.d.cts → shared-DGnn1jiS.d.cts} +1 -1
  109. package/dist/{shared-Cf7yxx4-.d.ts → shared-U405h52W.d.ts} +1 -1
  110. package/dist/{simulate-LJXYBC6M.js → simulate-VT437EEL.js} +17 -4
  111. package/dist/spatial/index.cjs +682 -0
  112. package/dist/spatial/index.d.cts +517 -0
  113. package/dist/spatial/index.d.ts +517 -0
  114. package/dist/spatial/index.js +633 -0
  115. package/dist/{test-BOOR4A5F.js → test-4WTX6RKQ.js} +3 -3
  116. package/dist/{trace-PKV4KX56.js → trace-2YDNAXMK.js} +2 -2
  117. package/dist/types.cjs +18 -0
  118. package/dist/types.d.cts +370 -0
  119. package/dist/types.d.ts +370 -0
  120. package/dist/types.js +0 -0
  121. package/dist/{validate-RALX7CZS.js → validate-M52DX22Y.js} +1 -1
  122. package/dist/{world-BIP4GZBZ.js → world-O4HTQPDP.js} +1 -1
  123. package/dist/{world-loader-Y6HMQH2D.js → world-loader-YTYFOP7D.js} +1 -1
  124. package/dist/worlds/mentraos-smartglasses.nv-world.md +423 -0
  125. package/dist/worlds/mentraos-spatial.nv-world.md +68 -0
  126. package/dist/worlds/user-rules.nv-world.md +328 -0
  127. package/package.json +46 -3
  128. package/dist/guard-engine-PNR6MHCM.js +0 -10
  129. package/dist/{configure-ai-5MP5DWTT.js → configure-ai-LL3VAPQW.js} +3 -3
package/dist/index.js CHANGED
@@ -1,24 +1,8 @@
1
- import {
2
- actionToGuardEvent,
3
- createGovernor,
4
- govern,
5
- handleCreateCapsule,
6
- handleHealthCheck,
7
- handleListPresets,
8
- handleReasonRequest,
9
- writeTempWorld
10
- } from "./chunk-U6U7EJZL.js";
11
1
  import {
12
2
  generateImpactReport,
13
3
  generateImpactReportFromFile,
14
4
  renderImpactReport
15
- } from "./chunk-TG6SEF24.js";
16
- import {
17
- adaptationFromVerdict,
18
- classifyAdaptation,
19
- detectBehavioralPatterns,
20
- generateAdaptationNarrative
21
- } from "./chunk-CNSO6XW5.js";
5
+ } from "./chunk-OQU65525.js";
22
6
  import {
23
7
  CompositeAuditLogger,
24
8
  ConsoleAuditLogger,
@@ -27,11 +11,7 @@ import {
27
11
  readAuditLog,
28
12
  summarizeAuditEvents,
29
13
  verdictToAuditEvent
30
- } from "./chunk-A7GKPPU7.js";
31
- import {
32
- improveWorld,
33
- renderImproveText
34
- } from "./chunk-F66BVUYB.js";
14
+ } from "./chunk-2VAWP6FI.js";
35
15
  import {
36
16
  BOOTSTRAP_EXIT_CODES
37
17
  } from "./chunk-4NGDRRQH.js";
@@ -43,44 +23,88 @@ import {
43
23
  classifyIntentWithAI,
44
24
  evaluateGuardWithAI,
45
25
  extractContentFields
46
- } from "./chunk-VXHSMA3I.js";
26
+ } from "./chunk-6CV4XG3J.js";
47
27
  import {
48
- ModelAdapter,
49
- PROVIDERS,
50
- resolveProvider
51
- } from "./chunk-A5W4GNQO.js";
28
+ actionToGuardEvent,
29
+ createGovernor,
30
+ govern,
31
+ handleCreateCapsule,
32
+ handleHealthCheck,
33
+ handleListPresets,
34
+ handleReasonRequest,
35
+ writeTempWorld
36
+ } from "./chunk-AV7XJJWK.js";
52
37
  import {
53
- McpGovernanceServer
54
- } from "./chunk-B6OXJLJ5.js";
38
+ adaptationFromVerdict,
39
+ classifyAdaptation,
40
+ detectBehavioralPatterns,
41
+ generateAdaptationNarrative
42
+ } from "./chunk-CNSO6XW5.js";
43
+ import {
44
+ GitHubGovernanceBlockedError,
45
+ GitHubGovernor,
46
+ GitHubWebhookHandler,
47
+ createGitHubGovernor,
48
+ createGitHubGovernorFromWorld,
49
+ createGitHubWebhookHandler,
50
+ createGitHubWebhookHandlerFromWorld,
51
+ formatForActions,
52
+ formatPRComment
53
+ } from "./chunk-3S5AD4AB.js";
55
54
  import {
56
55
  addGuard,
57
56
  addInvariant,
58
57
  addRule,
59
58
  classifyIntent,
60
59
  parseGuardDescription
61
- } from "./chunk-5TPFNWRU.js";
60
+ } from "./chunk-FS2UUJJO.js";
62
61
  import {
63
62
  deriveWorld,
64
63
  extractWorldMarkdown,
65
64
  normalizeWorldMarkdown
66
- } from "./chunk-YEKMVDWK.js";
65
+ } from "./chunk-FHXXD2TI.js";
67
66
  import {
68
67
  CONFIGURE_AI_EXIT_CODES,
69
68
  DERIVE_EXIT_CODES
70
69
  } from "./chunk-FMSTRBBS.js";
71
- import "./chunk-OT6PXH54.js";
72
70
  import "./chunk-INWQHLPS.js";
73
- import {
74
- validateWorld
75
- } from "./chunk-7P3S7MAY.js";
71
+ import "./chunk-OT6PXH54.js";
76
72
  import {
77
73
  explainWorld,
78
74
  renderExplainText
79
75
  } from "./chunk-ZJTDUCC2.js";
76
+ import {
77
+ improveWorld,
78
+ renderImproveText
79
+ } from "./chunk-DA5MHFRR.js";
80
80
  import {
81
81
  renderSimulateText,
82
82
  simulateWorld
83
- } from "./chunk-ZWI3NIXK.js";
83
+ } from "./chunk-CYDMUJVZ.js";
84
+ import {
85
+ SessionManager,
86
+ runInteractiveMode,
87
+ runPipeMode
88
+ } from "./chunk-ZEIT2QLM.js";
89
+ import {
90
+ applyConsequence,
91
+ applyReward,
92
+ createAgentState,
93
+ generateDecisionFlow,
94
+ renderDecisionFlow,
95
+ tickAgentStates
96
+ } from "./chunk-D2UCV5AK.js";
97
+ import {
98
+ ModelAdapter,
99
+ PROVIDERS,
100
+ resolveProvider
101
+ } from "./chunk-A5W4GNQO.js";
102
+ import {
103
+ McpGovernanceServer
104
+ } from "./chunk-J2IZBHXJ.js";
105
+ import {
106
+ validateWorld
107
+ } from "./chunk-7P3S7MAY.js";
84
108
  import {
85
109
  PLAN_EXIT_CODES,
86
110
  parsePlanMarkdown
@@ -92,39 +116,28 @@ import {
92
116
  resolveWorldPath,
93
117
  setActiveWorld
94
118
  } from "./chunk-AKW5YVCE.js";
95
- import {
96
- parseWorldMarkdown
97
- } from "./chunk-EMQDLDAF.js";
98
119
  import {
99
120
  emitWorldDefinition
100
- } from "./chunk-PVTQQS3Y.js";
121
+ } from "./chunk-YPCVY4GS.js";
101
122
  import {
102
- SessionManager,
103
- runInteractiveMode,
104
- runPipeMode
105
- } from "./chunk-IS4WUH6Y.js";
106
- import {
107
- applyConsequence,
108
- applyReward,
109
- createAgentState,
110
- generateDecisionFlow,
111
- renderDecisionFlow,
112
- tickAgentStates
113
- } from "./chunk-D2UCV5AK.js";
123
+ parseWorldMarkdown
124
+ } from "./chunk-3NZMMSOW.js";
125
+ import "./chunk-5U2MQO5P.js";
114
126
  import {
115
127
  evaluateGuard,
116
- eventToAllowlistKey
117
- } from "./chunk-W7LLXRGY.js";
128
+ eventToAllowlistKey,
129
+ verdictToEvent
130
+ } from "./chunk-ZAF6JH23.js";
131
+ import {
132
+ loadWorld,
133
+ loadWorldFromDirectory
134
+ } from "./chunk-I4RTIMLX.js";
118
135
  import {
119
136
  advancePlan,
120
137
  buildPlanCheck,
121
138
  evaluatePlan,
122
139
  getPlanProgress
123
140
  } from "./chunk-QLPTHTVB.js";
124
- import {
125
- loadWorld,
126
- loadWorldFromDirectory
127
- } from "./chunk-CTZHONLA.js";
128
141
  import "./chunk-QWGCMQQD.js";
129
142
 
130
143
  // src/engine/verdict-formatter.ts
@@ -405,6 +418,9 @@ export {
405
418
  DERIVE_EXIT_CODES,
406
419
  FileAuditLogger,
407
420
  GUARD_EXIT_CODES,
421
+ GitHubGovernanceBlockedError,
422
+ GitHubGovernor,
423
+ GitHubWebhookHandler,
408
424
  McpGovernanceServer,
409
425
  ModelAdapter,
410
426
  PLAN_EXIT_CODES,
@@ -424,6 +440,10 @@ export {
424
440
  classifyIntent,
425
441
  classifyIntentWithAI,
426
442
  createAgentState,
443
+ createGitHubGovernor,
444
+ createGitHubGovernorFromWorld,
445
+ createGitHubWebhookHandler,
446
+ createGitHubWebhookHandlerFromWorld,
427
447
  createGovernanceEngine,
428
448
  createGovernor,
429
449
  deriveWorld,
@@ -438,6 +458,8 @@ export {
438
458
  explainWorld,
439
459
  extractContentFields,
440
460
  extractWorldMarkdown,
461
+ formatForActions,
462
+ formatPRComment,
441
463
  formatVerdict,
442
464
  formatVerdictOneLine,
443
465
  generateAdaptationNarrative,
@@ -475,5 +497,6 @@ export {
475
497
  tickAgentStates,
476
498
  validateWorld,
477
499
  verdictToAuditEvent,
500
+ verdictToEvent,
478
501
  writeTempWorld
479
502
  };
@@ -129,9 +129,13 @@ async function main(argv = process.argv.slice(2)) {
129
129
  `neuroverse bootstrap --input ${args.outputPath} --output ./world/ --validate`,
130
130
  "neuroverse validate --world ./world/",
131
131
  `echo '{"intent":"test action"}' | neuroverse guard --world ./world/`
132
- ]
132
+ ],
133
+ tip: "Run `neuroverse configure-world` for an interactive wizard that builds state variables, rules, and gates from plain language \u2014 no syntax required."
133
134
  };
134
135
  process.stdout.write(JSON.stringify(result, null, 2) + "\n");
136
+ process.stderr.write(
137
+ "\nTip: Run `neuroverse configure-world` for an interactive wizard\nthat builds state, rules, and gates from plain language \u2014 no syntax required.\n"
138
+ );
135
139
  process.exit(0);
136
140
  } catch (e) {
137
141
  process.stderr.write(`Init failed: ${e}