@jagilber-org/index-server 1.19.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 (360) hide show
  1. package/CHANGELOG.md +1218 -0
  2. package/CODE_OF_CONDUCT.md +49 -0
  3. package/CONTRIBUTING.md +75 -0
  4. package/LICENSE +21 -0
  5. package/README.md +523 -0
  6. package/SECURITY.md +50 -0
  7. package/dist/config/configUtils.d.ts +11 -0
  8. package/dist/config/configUtils.js +87 -0
  9. package/dist/config/dashboardConfig.d.ts +45 -0
  10. package/dist/config/dashboardConfig.js +63 -0
  11. package/dist/config/defaultValues.d.ts +61 -0
  12. package/dist/config/defaultValues.js +70 -0
  13. package/dist/config/dirConstants.d.ts +17 -0
  14. package/dist/config/dirConstants.js +28 -0
  15. package/dist/config/featureConfig.d.ts +61 -0
  16. package/dist/config/featureConfig.js +121 -0
  17. package/dist/config/runtimeConfig.d.ts +145 -0
  18. package/dist/config/runtimeConfig.js +334 -0
  19. package/dist/config/serverConfig.d.ts +90 -0
  20. package/dist/config/serverConfig.js +164 -0
  21. package/dist/dashboard/analytics/AnalyticsEngine.d.ts +142 -0
  22. package/dist/dashboard/analytics/AnalyticsEngine.js +373 -0
  23. package/dist/dashboard/analytics/BusinessIntelligence.d.ts +187 -0
  24. package/dist/dashboard/analytics/BusinessIntelligence.js +594 -0
  25. package/dist/dashboard/client/admin.html +2150 -0
  26. package/dist/dashboard/client/chunks/mermaid-layout-elk.esm.min/chunk-SP2CHFBE.mjs +1 -0
  27. package/dist/dashboard/client/chunks/mermaid-layout-elk.esm.min/render-T6MDALS3.mjs +27 -0
  28. package/dist/dashboard/client/css/admin.css +1466 -0
  29. package/dist/dashboard/client/js/admin.boot.js +359 -0
  30. package/dist/dashboard/client/js/admin.config.js +196 -0
  31. package/dist/dashboard/client/js/admin.embeddings.js +425 -0
  32. package/dist/dashboard/client/js/admin.graph.js +583 -0
  33. package/dist/dashboard/client/js/admin.instances.js +120 -0
  34. package/dist/dashboard/client/js/admin.instructions.js +552 -0
  35. package/dist/dashboard/client/js/admin.logs.js +113 -0
  36. package/dist/dashboard/client/js/admin.maintenance.js +354 -0
  37. package/dist/dashboard/client/js/admin.messaging.js +635 -0
  38. package/dist/dashboard/client/js/admin.monitor.js +181 -0
  39. package/dist/dashboard/client/js/admin.overview.js +221 -0
  40. package/dist/dashboard/client/js/admin.performance.js +61 -0
  41. package/dist/dashboard/client/js/admin.sessions.js +293 -0
  42. package/dist/dashboard/client/js/admin.sqlite.js +366 -0
  43. package/dist/dashboard/client/js/admin.utils.js +49 -0
  44. package/dist/dashboard/client/js/chart.umd.js +14 -0
  45. package/dist/dashboard/client/js/elk.bundled.js +6696 -0
  46. package/dist/dashboard/client/js/marked.umd.js +74 -0
  47. package/dist/dashboard/client/js/mermaid.min.js +3022 -0
  48. package/dist/dashboard/client/mermaid-layout-elk.esm.min.mjs +1 -0
  49. package/dist/dashboard/export/DataExporter.d.ts +169 -0
  50. package/dist/dashboard/export/DataExporter.js +737 -0
  51. package/dist/dashboard/export/exporters/csvExporter.d.ts +11 -0
  52. package/dist/dashboard/export/exporters/csvExporter.js +46 -0
  53. package/dist/dashboard/export/exporters/exportTypes.d.ts +89 -0
  54. package/dist/dashboard/export/exporters/exportTypes.js +5 -0
  55. package/dist/dashboard/export/exporters/jsonExporter.d.ts +7 -0
  56. package/dist/dashboard/export/exporters/jsonExporter.js +22 -0
  57. package/dist/dashboard/export/exporters/xmlExporter.d.ts +17 -0
  58. package/dist/dashboard/export/exporters/xmlExporter.js +175 -0
  59. package/dist/dashboard/integration/APIIntegration.d.ts +41 -0
  60. package/dist/dashboard/integration/APIIntegration.js +95 -0
  61. package/dist/dashboard/security/SecurityMonitor.d.ts +167 -0
  62. package/dist/dashboard/security/SecurityMonitor.js +559 -0
  63. package/dist/dashboard/server/AdminPanel.d.ts +183 -0
  64. package/dist/dashboard/server/AdminPanel.js +792 -0
  65. package/dist/dashboard/server/AdminPanelConfig.d.ts +42 -0
  66. package/dist/dashboard/server/AdminPanelConfig.js +80 -0
  67. package/dist/dashboard/server/AdminPanelState.d.ts +47 -0
  68. package/dist/dashboard/server/AdminPanelState.js +214 -0
  69. package/dist/dashboard/server/ApiRoutes.d.ts +17 -0
  70. package/dist/dashboard/server/ApiRoutes.js +149 -0
  71. package/dist/dashboard/server/DashboardServer.d.ts +49 -0
  72. package/dist/dashboard/server/DashboardServer.js +159 -0
  73. package/dist/dashboard/server/FileMetricsStorage.d.ts +49 -0
  74. package/dist/dashboard/server/FileMetricsStorage.js +195 -0
  75. package/dist/dashboard/server/HttpTransport.d.ts +23 -0
  76. package/dist/dashboard/server/HttpTransport.js +116 -0
  77. package/dist/dashboard/server/InstanceManager.d.ts +53 -0
  78. package/dist/dashboard/server/InstanceManager.js +284 -0
  79. package/dist/dashboard/server/KnowledgeStore.d.ts +35 -0
  80. package/dist/dashboard/server/KnowledgeStore.js +105 -0
  81. package/dist/dashboard/server/LeaderElection.d.ts +81 -0
  82. package/dist/dashboard/server/LeaderElection.js +268 -0
  83. package/dist/dashboard/server/MetricsCollector.d.ts +200 -0
  84. package/dist/dashboard/server/MetricsCollector.js +803 -0
  85. package/dist/dashboard/server/SessionPersistenceManager.d.ts +88 -0
  86. package/dist/dashboard/server/SessionPersistenceManager.js +457 -0
  87. package/dist/dashboard/server/ThinClient.d.ts +64 -0
  88. package/dist/dashboard/server/ThinClient.js +237 -0
  89. package/dist/dashboard/server/WebSocketManager.d.ts +161 -0
  90. package/dist/dashboard/server/WebSocketManager.js +463 -0
  91. package/dist/dashboard/server/httpLifecycle.d.ts +17 -0
  92. package/dist/dashboard/server/httpLifecycle.js +35 -0
  93. package/dist/dashboard/server/legacyDashboardHtml.d.ts +9 -0
  94. package/dist/dashboard/server/legacyDashboardHtml.js +618 -0
  95. package/dist/dashboard/server/legacyDashboardStyles.d.ts +5 -0
  96. package/dist/dashboard/server/legacyDashboardStyles.js +490 -0
  97. package/dist/dashboard/server/metricsAggregation.d.ts +252 -0
  98. package/dist/dashboard/server/metricsAggregation.js +206 -0
  99. package/dist/dashboard/server/metricsSerializer.d.ts +25 -0
  100. package/dist/dashboard/server/metricsSerializer.js +195 -0
  101. package/dist/dashboard/server/routes/admin.routes.d.ts +16 -0
  102. package/dist/dashboard/server/routes/admin.routes.js +596 -0
  103. package/dist/dashboard/server/routes/alerts.routes.d.ts +7 -0
  104. package/dist/dashboard/server/routes/alerts.routes.js +93 -0
  105. package/dist/dashboard/server/routes/api.feedback.routes.d.ts +73 -0
  106. package/dist/dashboard/server/routes/api.feedback.routes.js +171 -0
  107. package/dist/dashboard/server/routes/api.instructions.routes.d.ts +101 -0
  108. package/dist/dashboard/server/routes/api.instructions.routes.js +213 -0
  109. package/dist/dashboard/server/routes/api.usage.routes.d.ts +57 -0
  110. package/dist/dashboard/server/routes/api.usage.routes.js +374 -0
  111. package/dist/dashboard/server/routes/embeddings.routes.d.ts +6 -0
  112. package/dist/dashboard/server/routes/embeddings.routes.js +246 -0
  113. package/dist/dashboard/server/routes/graph.routes.d.ts +6 -0
  114. package/dist/dashboard/server/routes/graph.routes.js +280 -0
  115. package/dist/dashboard/server/routes/index.d.ts +38 -0
  116. package/dist/dashboard/server/routes/index.js +194 -0
  117. package/dist/dashboard/server/routes/instances.routes.d.ts +6 -0
  118. package/dist/dashboard/server/routes/instances.routes.js +35 -0
  119. package/dist/dashboard/server/routes/instructions.routes.d.ts +8 -0
  120. package/dist/dashboard/server/routes/instructions.routes.js +336 -0
  121. package/dist/dashboard/server/routes/knowledge.routes.d.ts +6 -0
  122. package/dist/dashboard/server/routes/knowledge.routes.js +82 -0
  123. package/dist/dashboard/server/routes/logs.routes.d.ts +6 -0
  124. package/dist/dashboard/server/routes/logs.routes.js +164 -0
  125. package/dist/dashboard/server/routes/messaging.routes.d.ts +16 -0
  126. package/dist/dashboard/server/routes/messaging.routes.js +293 -0
  127. package/dist/dashboard/server/routes/metrics.routes.d.ts +10 -0
  128. package/dist/dashboard/server/routes/metrics.routes.js +346 -0
  129. package/dist/dashboard/server/routes/scripts.routes.d.ts +9 -0
  130. package/dist/dashboard/server/routes/scripts.routes.js +84 -0
  131. package/dist/dashboard/server/routes/sqlite.routes.d.ts +9 -0
  132. package/dist/dashboard/server/routes/sqlite.routes.js +569 -0
  133. package/dist/dashboard/server/routes/status.routes.d.ts +7 -0
  134. package/dist/dashboard/server/routes/status.routes.js +183 -0
  135. package/dist/dashboard/server/routes/synthetic.routes.d.ts +7 -0
  136. package/dist/dashboard/server/routes/synthetic.routes.js +195 -0
  137. package/dist/dashboard/server/routes/tools.routes.d.ts +6 -0
  138. package/dist/dashboard/server/routes/tools.routes.js +46 -0
  139. package/dist/dashboard/server/routes/usage.routes.d.ts +6 -0
  140. package/dist/dashboard/server/routes/usage.routes.js +25 -0
  141. package/dist/dashboard/server/wsInit.d.ts +16 -0
  142. package/dist/dashboard/server/wsInit.js +35 -0
  143. package/dist/externalClientLib.d.ts +1 -0
  144. package/dist/externalClientLib.js +2 -0
  145. package/dist/minimal/index.d.ts +1 -0
  146. package/dist/minimal/index.js +140 -0
  147. package/dist/models/SessionPersistence.d.ts +115 -0
  148. package/dist/models/SessionPersistence.js +66 -0
  149. package/dist/models/instruction.d.ts +45 -0
  150. package/dist/models/instruction.js +2 -0
  151. package/dist/perf/benchmark.d.ts +1 -0
  152. package/dist/perf/benchmark.js +50 -0
  153. package/dist/portableClientWrapper.d.ts +1 -0
  154. package/dist/portableClientWrapper.js +2 -0
  155. package/dist/schemas/index.d.ts +128 -0
  156. package/dist/schemas/index.js +371 -0
  157. package/dist/scripts/runPerformanceBaseline.d.ts +1 -0
  158. package/dist/scripts/runPerformanceBaseline.js +17 -0
  159. package/dist/server/handshakeManager.d.ts +25 -0
  160. package/dist/server/handshakeManager.js +472 -0
  161. package/dist/server/index-server.d.ts +56 -0
  162. package/dist/server/index-server.js +822 -0
  163. package/dist/server/registry.d.ts +44 -0
  164. package/dist/server/registry.js +236 -0
  165. package/dist/server/sdkServer.d.ts +8 -0
  166. package/dist/server/sdkServer.js +299 -0
  167. package/dist/server/shutdownGuard.d.ts +41 -0
  168. package/dist/server/shutdownGuard.js +52 -0
  169. package/dist/server/thin-client.d.ts +22 -0
  170. package/dist/server/thin-client.js +111 -0
  171. package/dist/server/transport.d.ts +41 -0
  172. package/dist/server/transport.js +312 -0
  173. package/dist/server/transportFactory.d.ts +21 -0
  174. package/dist/server/transportFactory.js +429 -0
  175. package/dist/services/atomicFs.d.ts +22 -0
  176. package/dist/services/atomicFs.js +103 -0
  177. package/dist/services/auditLog.d.ts +38 -0
  178. package/dist/services/auditLog.js +142 -0
  179. package/dist/services/autoBackup.d.ts +14 -0
  180. package/dist/services/autoBackup.js +171 -0
  181. package/dist/services/autoSplit.d.ts +32 -0
  182. package/dist/services/autoSplit.js +113 -0
  183. package/dist/services/backupZip.d.ts +25 -0
  184. package/dist/services/backupZip.js +110 -0
  185. package/dist/services/bootstrapGating.d.ts +123 -0
  186. package/dist/services/bootstrapGating.js +221 -0
  187. package/dist/services/canonical.d.ts +23 -0
  188. package/dist/services/canonical.js +65 -0
  189. package/dist/services/categoryRules.d.ts +7 -0
  190. package/dist/services/categoryRules.js +37 -0
  191. package/dist/services/classificationService.d.ts +42 -0
  192. package/dist/services/classificationService.js +168 -0
  193. package/dist/services/embeddingService.d.ts +62 -0
  194. package/dist/services/embeddingService.js +259 -0
  195. package/dist/services/errors.d.ts +22 -0
  196. package/dist/services/errors.js +31 -0
  197. package/dist/services/featureFlags.d.ts +25 -0
  198. package/dist/services/featureFlags.js +89 -0
  199. package/dist/services/features.d.ts +13 -0
  200. package/dist/services/features.js +35 -0
  201. package/dist/services/handlers/instructions.add.d.ts +1 -0
  202. package/dist/services/handlers/instructions.add.js +496 -0
  203. package/dist/services/handlers/instructions.groom.d.ts +1 -0
  204. package/dist/services/handlers/instructions.groom.js +523 -0
  205. package/dist/services/handlers/instructions.import.d.ts +1 -0
  206. package/dist/services/handlers/instructions.import.js +173 -0
  207. package/dist/services/handlers/instructions.patch.d.ts +1 -0
  208. package/dist/services/handlers/instructions.patch.js +167 -0
  209. package/dist/services/handlers/instructions.query.d.ts +163 -0
  210. package/dist/services/handlers/instructions.query.js +522 -0
  211. package/dist/services/handlers/instructions.reload.d.ts +1 -0
  212. package/dist/services/handlers/instructions.reload.js +13 -0
  213. package/dist/services/handlers/instructions.remove.d.ts +1 -0
  214. package/dist/services/handlers/instructions.remove.js +118 -0
  215. package/dist/services/handlers/instructions.shared.d.ts +31 -0
  216. package/dist/services/handlers/instructions.shared.js +124 -0
  217. package/dist/services/handlers.activation.d.ts +1 -0
  218. package/dist/services/handlers.activation.js +203 -0
  219. package/dist/services/handlers.bootstrap.d.ts +1 -0
  220. package/dist/services/handlers.bootstrap.js +38 -0
  221. package/dist/services/handlers.dashboardConfig.d.ts +34 -0
  222. package/dist/services/handlers.dashboardConfig.js +108 -0
  223. package/dist/services/handlers.diagnostics.d.ts +1 -0
  224. package/dist/services/handlers.diagnostics.js +64 -0
  225. package/dist/services/handlers.feedback.d.ts +15 -0
  226. package/dist/services/handlers.feedback.js +378 -0
  227. package/dist/services/handlers.gates.d.ts +1 -0
  228. package/dist/services/handlers.gates.js +46 -0
  229. package/dist/services/handlers.graph.d.ts +53 -0
  230. package/dist/services/handlers.graph.js +231 -0
  231. package/dist/services/handlers.help.d.ts +1 -0
  232. package/dist/services/handlers.help.js +119 -0
  233. package/dist/services/handlers.instructionSchema.d.ts +1 -0
  234. package/dist/services/handlers.instructionSchema.js +227 -0
  235. package/dist/services/handlers.instructions.d.ts +8 -0
  236. package/dist/services/handlers.instructions.js +14 -0
  237. package/dist/services/handlers.instructionsDiagnostics.d.ts +1 -0
  238. package/dist/services/handlers.instructionsDiagnostics.js +14 -0
  239. package/dist/services/handlers.integrity.d.ts +1 -0
  240. package/dist/services/handlers.integrity.js +35 -0
  241. package/dist/services/handlers.manifest.d.ts +1 -0
  242. package/dist/services/handlers.manifest.js +24 -0
  243. package/dist/services/handlers.messaging.d.ts +12 -0
  244. package/dist/services/handlers.messaging.js +203 -0
  245. package/dist/services/handlers.metrics.d.ts +1 -0
  246. package/dist/services/handlers.metrics.js +43 -0
  247. package/dist/services/handlers.promote.d.ts +1 -0
  248. package/dist/services/handlers.promote.js +306 -0
  249. package/dist/services/handlers.prompt.d.ts +1 -0
  250. package/dist/services/handlers.prompt.js +7 -0
  251. package/dist/services/handlers.search.d.ts +69 -0
  252. package/dist/services/handlers.search.js +645 -0
  253. package/dist/services/handlers.testPrimitive.d.ts +1 -0
  254. package/dist/services/handlers.testPrimitive.js +5 -0
  255. package/dist/services/handlers.trace.d.ts +1 -0
  256. package/dist/services/handlers.trace.js +31 -0
  257. package/dist/services/handlers.usage.d.ts +1 -0
  258. package/dist/services/handlers.usage.js +11 -0
  259. package/dist/services/hotScore.d.ts +137 -0
  260. package/dist/services/hotScore.js +244 -0
  261. package/dist/services/indexContext.d.ts +117 -0
  262. package/dist/services/indexContext.js +968 -0
  263. package/dist/services/indexLoader.d.ts +44 -0
  264. package/dist/services/indexLoader.js +921 -0
  265. package/dist/services/indexRepository.d.ts +32 -0
  266. package/dist/services/indexRepository.js +71 -0
  267. package/dist/services/indexingService.d.ts +1 -0
  268. package/dist/services/indexingService.js +2 -0
  269. package/dist/services/instructions.dispatcher.d.ts +1 -0
  270. package/dist/services/instructions.dispatcher.js +231 -0
  271. package/dist/services/logPrefix.d.ts +1 -0
  272. package/dist/services/logPrefix.js +30 -0
  273. package/dist/services/logger.d.ts +52 -0
  274. package/dist/services/logger.js +268 -0
  275. package/dist/services/manifestManager.d.ts +82 -0
  276. package/dist/services/manifestManager.js +200 -0
  277. package/dist/services/messaging/agentMailbox.d.ts +60 -0
  278. package/dist/services/messaging/agentMailbox.js +353 -0
  279. package/dist/services/messaging/messagingPersistence.d.ts +20 -0
  280. package/dist/services/messaging/messagingPersistence.js +111 -0
  281. package/dist/services/messaging/messagingTypes.d.ts +150 -0
  282. package/dist/services/messaging/messagingTypes.js +66 -0
  283. package/dist/services/ownershipService.d.ts +1 -0
  284. package/dist/services/ownershipService.js +38 -0
  285. package/dist/services/performanceBaseline.d.ts +19 -0
  286. package/dist/services/performanceBaseline.js +210 -0
  287. package/dist/services/preflight.d.ts +12 -0
  288. package/dist/services/preflight.js +79 -0
  289. package/dist/services/promptReviewService.d.ts +44 -0
  290. package/dist/services/promptReviewService.js +101 -0
  291. package/dist/services/responseEnvelope.d.ts +6 -0
  292. package/dist/services/responseEnvelope.js +25 -0
  293. package/dist/services/seedBootstrap.d.ts +34 -0
  294. package/dist/services/seedBootstrap.js +427 -0
  295. package/dist/services/storage/factory.d.ts +17 -0
  296. package/dist/services/storage/factory.js +35 -0
  297. package/dist/services/storage/hashUtils.d.ts +11 -0
  298. package/dist/services/storage/hashUtils.js +35 -0
  299. package/dist/services/storage/index.d.ts +12 -0
  300. package/dist/services/storage/index.js +18 -0
  301. package/dist/services/storage/jsonFileStore.d.ts +32 -0
  302. package/dist/services/storage/jsonFileStore.js +241 -0
  303. package/dist/services/storage/migrationEngine.d.ts +35 -0
  304. package/dist/services/storage/migrationEngine.js +93 -0
  305. package/dist/services/storage/sqliteMessageStore.d.ts +53 -0
  306. package/dist/services/storage/sqliteMessageStore.js +146 -0
  307. package/dist/services/storage/sqliteSchema.d.ts +12 -0
  308. package/dist/services/storage/sqliteSchema.js +122 -0
  309. package/dist/services/storage/sqliteStore.d.ts +41 -0
  310. package/dist/services/storage/sqliteStore.js +339 -0
  311. package/dist/services/storage/sqliteUsageStore.d.ts +35 -0
  312. package/dist/services/storage/sqliteUsageStore.js +94 -0
  313. package/dist/services/storage/types.d.ts +171 -0
  314. package/dist/services/storage/types.js +12 -0
  315. package/dist/services/toolHandlers.d.ts +23 -0
  316. package/dist/services/toolHandlers.js +50 -0
  317. package/dist/services/toolRegistry.d.ts +20 -0
  318. package/dist/services/toolRegistry.js +490 -0
  319. package/dist/services/toolRegistry.zod.d.ts +10 -0
  320. package/dist/services/toolRegistry.zod.js +323 -0
  321. package/dist/services/tracing.d.ts +26 -0
  322. package/dist/services/tracing.js +260 -0
  323. package/dist/services/usageBuckets.d.ts +161 -0
  324. package/dist/services/usageBuckets.js +364 -0
  325. package/dist/services/validationService.d.ts +38 -0
  326. package/dist/services/validationService.js +125 -0
  327. package/dist/utils/BufferRing.d.ts +203 -0
  328. package/dist/utils/BufferRing.js +551 -0
  329. package/dist/utils/BufferRingExamples.d.ts +55 -0
  330. package/dist/utils/BufferRingExamples.js +188 -0
  331. package/dist/utils/envUtils.d.ts +42 -0
  332. package/dist/utils/envUtils.js +80 -0
  333. package/dist/utils/memoryMonitor.d.ts +83 -0
  334. package/dist/utils/memoryMonitor.js +275 -0
  335. package/dist/versioning/schemaVersion.d.ts +6 -0
  336. package/dist/versioning/schemaVersion.js +93 -0
  337. package/package.json +134 -0
  338. package/schemas/README.md +13 -0
  339. package/schemas/feedback-entry.schema.json +27 -0
  340. package/schemas/graph-export-v2.schema.json +60 -0
  341. package/schemas/index-server.code-schema.json +38477 -0
  342. package/schemas/instruction.schema.json +262 -0
  343. package/schemas/json-schema/SessionPersistence-persisted-admin-session.schema.json +54 -0
  344. package/schemas/json-schema/SessionPersistence-persisted-session-history-entry.schema.json +51 -0
  345. package/schemas/json-schema/SessionPersistence-persisted-web-socket-connection.schema.json +54 -0
  346. package/schemas/json-schema/SessionPersistence-session-persistence-config.schema.json +110 -0
  347. package/schemas/json-schema/SessionPersistence-session-persistence-data.schema.json +229 -0
  348. package/schemas/json-schema/SessionPersistence-session-persistence-manifest.schema.json +109 -0
  349. package/schemas/json-schema/SessionPersistence-session-persistence-metadata.schema.json +55 -0
  350. package/schemas/json-schema/instruction-audience-scope.schema.json +14 -0
  351. package/schemas/json-schema/instruction-content-type.schema.json +17 -0
  352. package/schemas/json-schema/instruction-instruction-entry.schema.json +206 -0
  353. package/schemas/json-schema/instruction-requirement-level.schema.json +16 -0
  354. package/schemas/manifest.json +78 -0
  355. package/schemas/manifest.schema.json +33 -0
  356. package/schemas/usage-batch.schema.json +16 -0
  357. package/schemas/usage-buckets.schema.json +30 -0
  358. package/schemas/usage-event.schema.json +17 -0
  359. package/scripts/copy-dashboard-assets.mjs +170 -0
  360. package/scripts/setup-hooks.cjs +28 -0
@@ -0,0 +1,229 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$ref": "#/definitions/SessionPersistenceData",
4
+ "definitions": {
5
+ "SessionPersistenceData": {
6
+ "type": "object",
7
+ "properties": {
8
+ "adminSessions": {
9
+ "type": "array",
10
+ "items": {
11
+ "$ref": "#/definitions/PersistedAdminSession"
12
+ }
13
+ },
14
+ "webSocketConnections": {
15
+ "type": "array",
16
+ "items": {
17
+ "$ref": "#/definitions/PersistedWebSocketConnection"
18
+ }
19
+ },
20
+ "sessionHistory": {
21
+ "type": "array",
22
+ "items": {
23
+ "$ref": "#/definitions/PersistedSessionHistoryEntry"
24
+ }
25
+ },
26
+ "metadata": {
27
+ "$ref": "#/definitions/SessionPersistenceMetadata"
28
+ }
29
+ },
30
+ "required": [
31
+ "adminSessions",
32
+ "webSocketConnections",
33
+ "sessionHistory",
34
+ "metadata"
35
+ ],
36
+ "additionalProperties": false
37
+ },
38
+ "PersistedAdminSession": {
39
+ "type": "object",
40
+ "properties": {
41
+ "id": {
42
+ "type": "string"
43
+ },
44
+ "userId": {
45
+ "type": "string"
46
+ },
47
+ "startTime": {
48
+ "type": "string"
49
+ },
50
+ "lastActivity": {
51
+ "type": "string"
52
+ },
53
+ "ipAddress": {
54
+ "type": "string"
55
+ },
56
+ "userAgent": {
57
+ "type": "string"
58
+ },
59
+ "permissions": {
60
+ "type": "array",
61
+ "items": {
62
+ "type": "string"
63
+ }
64
+ },
65
+ "persistedAt": {
66
+ "type": "string"
67
+ },
68
+ "version": {
69
+ "type": "number"
70
+ }
71
+ },
72
+ "required": [
73
+ "id",
74
+ "userId",
75
+ "startTime",
76
+ "lastActivity",
77
+ "ipAddress",
78
+ "userAgent",
79
+ "permissions",
80
+ "persistedAt",
81
+ "version"
82
+ ],
83
+ "additionalProperties": false,
84
+ "description": "Session Persistence Schema Design\n\nPersistent storage design for admin sessions, websocket connections, and session history with deduplication, atomic writes, and backup integration."
85
+ },
86
+ "PersistedWebSocketConnection": {
87
+ "type": "object",
88
+ "properties": {
89
+ "id": {
90
+ "type": "string"
91
+ },
92
+ "clientId": {
93
+ "type": "string"
94
+ },
95
+ "connectedAt": {
96
+ "type": "string"
97
+ },
98
+ "lastActivity": {
99
+ "type": "string"
100
+ },
101
+ "ipAddress": {
102
+ "type": "string"
103
+ },
104
+ "userAgent": {
105
+ "type": "string"
106
+ },
107
+ "isActive": {
108
+ "type": "boolean"
109
+ },
110
+ "disconnectedAt": {
111
+ "type": "string"
112
+ },
113
+ "disconnectReason": {
114
+ "type": "string"
115
+ },
116
+ "persistedAt": {
117
+ "type": "string"
118
+ },
119
+ "version": {
120
+ "type": "number"
121
+ }
122
+ },
123
+ "required": [
124
+ "id",
125
+ "clientId",
126
+ "connectedAt",
127
+ "lastActivity",
128
+ "isActive",
129
+ "persistedAt",
130
+ "version"
131
+ ],
132
+ "additionalProperties": false
133
+ },
134
+ "PersistedSessionHistoryEntry": {
135
+ "type": "object",
136
+ "properties": {
137
+ "id": {
138
+ "type": "string"
139
+ },
140
+ "userId": {
141
+ "type": "string"
142
+ },
143
+ "startTime": {
144
+ "type": "string"
145
+ },
146
+ "endTime": {
147
+ "type": "string"
148
+ },
149
+ "ipAddress": {
150
+ "type": "string"
151
+ },
152
+ "userAgent": {
153
+ "type": "string"
154
+ },
155
+ "terminated": {
156
+ "type": "boolean"
157
+ },
158
+ "terminationReason": {
159
+ "type": "string"
160
+ },
161
+ "persistedAt": {
162
+ "type": "string"
163
+ },
164
+ "version": {
165
+ "type": "number"
166
+ }
167
+ },
168
+ "required": [
169
+ "id",
170
+ "userId",
171
+ "startTime",
172
+ "ipAddress",
173
+ "userAgent",
174
+ "persistedAt",
175
+ "version"
176
+ ],
177
+ "additionalProperties": false
178
+ },
179
+ "SessionPersistenceMetadata": {
180
+ "type": "object",
181
+ "properties": {
182
+ "lastPersisted": {
183
+ "type": "string"
184
+ },
185
+ "version": {
186
+ "type": "number"
187
+ },
188
+ "totalSessions": {
189
+ "type": "number"
190
+ },
191
+ "totalConnections": {
192
+ "type": "number"
193
+ },
194
+ "totalHistoryEntries": {
195
+ "type": "number"
196
+ },
197
+ "checksums": {
198
+ "type": "object",
199
+ "properties": {
200
+ "sessions": {
201
+ "type": "string"
202
+ },
203
+ "connections": {
204
+ "type": "string"
205
+ },
206
+ "history": {
207
+ "type": "string"
208
+ }
209
+ },
210
+ "required": [
211
+ "sessions",
212
+ "connections",
213
+ "history"
214
+ ],
215
+ "additionalProperties": false
216
+ }
217
+ },
218
+ "required": [
219
+ "lastPersisted",
220
+ "version",
221
+ "totalSessions",
222
+ "totalConnections",
223
+ "totalHistoryEntries",
224
+ "checksums"
225
+ ],
226
+ "additionalProperties": false
227
+ }
228
+ }
229
+ }
@@ -0,0 +1,109 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$ref": "#/definitions/SessionPersistenceManifest",
4
+ "definitions": {
5
+ "SessionPersistenceManifest": {
6
+ "type": "object",
7
+ "properties": {
8
+ "metadata": {
9
+ "$ref": "#/definitions/SessionPersistenceMetadata"
10
+ },
11
+ "files": {
12
+ "type": "object",
13
+ "properties": {
14
+ "adminSessions": {
15
+ "type": "string"
16
+ },
17
+ "webSocketConnections": {
18
+ "type": "string"
19
+ },
20
+ "sessionHistory": {
21
+ "type": "string"
22
+ }
23
+ },
24
+ "required": [
25
+ "adminSessions",
26
+ "webSocketConnections",
27
+ "sessionHistory"
28
+ ],
29
+ "additionalProperties": false
30
+ },
31
+ "retention": {
32
+ "type": "object",
33
+ "properties": {
34
+ "maxHistoryEntries": {
35
+ "type": "number"
36
+ },
37
+ "maxHistoryDays": {
38
+ "type": "number"
39
+ },
40
+ "maxConnectionHistoryDays": {
41
+ "type": "number"
42
+ }
43
+ },
44
+ "required": [
45
+ "maxHistoryEntries",
46
+ "maxHistoryDays",
47
+ "maxConnectionHistoryDays"
48
+ ],
49
+ "additionalProperties": false
50
+ }
51
+ },
52
+ "required": [
53
+ "metadata",
54
+ "files",
55
+ "retention"
56
+ ],
57
+ "additionalProperties": false
58
+ },
59
+ "SessionPersistenceMetadata": {
60
+ "type": "object",
61
+ "properties": {
62
+ "lastPersisted": {
63
+ "type": "string"
64
+ },
65
+ "version": {
66
+ "type": "number"
67
+ },
68
+ "totalSessions": {
69
+ "type": "number"
70
+ },
71
+ "totalConnections": {
72
+ "type": "number"
73
+ },
74
+ "totalHistoryEntries": {
75
+ "type": "number"
76
+ },
77
+ "checksums": {
78
+ "type": "object",
79
+ "properties": {
80
+ "sessions": {
81
+ "type": "string"
82
+ },
83
+ "connections": {
84
+ "type": "string"
85
+ },
86
+ "history": {
87
+ "type": "string"
88
+ }
89
+ },
90
+ "required": [
91
+ "sessions",
92
+ "connections",
93
+ "history"
94
+ ],
95
+ "additionalProperties": false
96
+ }
97
+ },
98
+ "required": [
99
+ "lastPersisted",
100
+ "version",
101
+ "totalSessions",
102
+ "totalConnections",
103
+ "totalHistoryEntries",
104
+ "checksums"
105
+ ],
106
+ "additionalProperties": false
107
+ }
108
+ }
109
+ }
@@ -0,0 +1,55 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$ref": "#/definitions/SessionPersistenceMetadata",
4
+ "definitions": {
5
+ "SessionPersistenceMetadata": {
6
+ "type": "object",
7
+ "properties": {
8
+ "lastPersisted": {
9
+ "type": "string"
10
+ },
11
+ "version": {
12
+ "type": "number"
13
+ },
14
+ "totalSessions": {
15
+ "type": "number"
16
+ },
17
+ "totalConnections": {
18
+ "type": "number"
19
+ },
20
+ "totalHistoryEntries": {
21
+ "type": "number"
22
+ },
23
+ "checksums": {
24
+ "type": "object",
25
+ "properties": {
26
+ "sessions": {
27
+ "type": "string"
28
+ },
29
+ "connections": {
30
+ "type": "string"
31
+ },
32
+ "history": {
33
+ "type": "string"
34
+ }
35
+ },
36
+ "required": [
37
+ "sessions",
38
+ "connections",
39
+ "history"
40
+ ],
41
+ "additionalProperties": false
42
+ }
43
+ },
44
+ "required": [
45
+ "lastPersisted",
46
+ "version",
47
+ "totalSessions",
48
+ "totalConnections",
49
+ "totalHistoryEntries",
50
+ "checksums"
51
+ ],
52
+ "additionalProperties": false
53
+ }
54
+ }
55
+ }
@@ -0,0 +1,14 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$ref": "#/definitions/AudienceScope",
4
+ "definitions": {
5
+ "AudienceScope": {
6
+ "type": "string",
7
+ "enum": [
8
+ "individual",
9
+ "group",
10
+ "all"
11
+ ]
12
+ }
13
+ }
14
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$ref": "#/definitions/ContentType",
4
+ "definitions": {
5
+ "ContentType": {
6
+ "type": "string",
7
+ "enum": [
8
+ "instruction",
9
+ "template",
10
+ "chat-session",
11
+ "reference",
12
+ "example",
13
+ "agent"
14
+ ]
15
+ }
16
+ }
17
+ }
@@ -0,0 +1,206 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$ref": "#/definitions/InstructionEntry",
4
+ "definitions": {
5
+ "InstructionEntry": {
6
+ "type": "object",
7
+ "properties": {
8
+ "id": {
9
+ "type": "string"
10
+ },
11
+ "title": {
12
+ "type": "string"
13
+ },
14
+ "body": {
15
+ "type": "string"
16
+ },
17
+ "rationale": {
18
+ "type": "string"
19
+ },
20
+ "priority": {
21
+ "type": "number"
22
+ },
23
+ "audience": {
24
+ "$ref": "#/definitions/AudienceScope"
25
+ },
26
+ "requirement": {
27
+ "$ref": "#/definitions/RequirementLevel"
28
+ },
29
+ "categories": {
30
+ "type": "array",
31
+ "items": {
32
+ "type": "string"
33
+ }
34
+ },
35
+ "contentType": {
36
+ "$ref": "#/definitions/ContentType"
37
+ },
38
+ "primaryCategory": {
39
+ "type": "string"
40
+ },
41
+ "sourceHash": {
42
+ "type": "string"
43
+ },
44
+ "schemaVersion": {
45
+ "type": "string"
46
+ },
47
+ "deprecatedBy": {
48
+ "type": "string"
49
+ },
50
+ "createdAt": {
51
+ "type": "string"
52
+ },
53
+ "updatedAt": {
54
+ "type": "string"
55
+ },
56
+ "usageCount": {
57
+ "type": "number"
58
+ },
59
+ "firstSeenTs": {
60
+ "type": "string"
61
+ },
62
+ "lastUsedAt": {
63
+ "type": "string"
64
+ },
65
+ "riskScore": {
66
+ "type": "number"
67
+ },
68
+ "workspaceId": {
69
+ "type": "string"
70
+ },
71
+ "userId": {
72
+ "type": "string"
73
+ },
74
+ "teamIds": {
75
+ "type": "array",
76
+ "items": {
77
+ "type": "string"
78
+ }
79
+ },
80
+ "version": {
81
+ "type": "string"
82
+ },
83
+ "status": {
84
+ "type": "string",
85
+ "enum": [
86
+ "draft",
87
+ "review",
88
+ "approved",
89
+ "deprecated"
90
+ ]
91
+ },
92
+ "owner": {
93
+ "type": "string"
94
+ },
95
+ "priorityTier": {
96
+ "type": "string",
97
+ "enum": [
98
+ "P1",
99
+ "P2",
100
+ "P3",
101
+ "P4"
102
+ ]
103
+ },
104
+ "classification": {
105
+ "type": "string",
106
+ "enum": [
107
+ "public",
108
+ "internal",
109
+ "restricted"
110
+ ]
111
+ },
112
+ "lastReviewedAt": {
113
+ "type": "string"
114
+ },
115
+ "nextReviewDue": {
116
+ "type": "string"
117
+ },
118
+ "reviewIntervalDays": {
119
+ "type": "number"
120
+ },
121
+ "changeLog": {
122
+ "type": "array",
123
+ "items": {
124
+ "type": "object",
125
+ "properties": {
126
+ "version": {
127
+ "type": "string"
128
+ },
129
+ "changedAt": {
130
+ "type": "string"
131
+ },
132
+ "summary": {
133
+ "type": "string"
134
+ }
135
+ },
136
+ "required": [
137
+ "version",
138
+ "changedAt",
139
+ "summary"
140
+ ],
141
+ "additionalProperties": false
142
+ }
143
+ },
144
+ "supersedes": {
145
+ "type": "string"
146
+ },
147
+ "archivedAt": {
148
+ "type": "string"
149
+ },
150
+ "semanticSummary": {
151
+ "type": "string"
152
+ },
153
+ "createdByAgent": {
154
+ "type": "string"
155
+ },
156
+ "sourceWorkspace": {
157
+ "type": "string"
158
+ }
159
+ },
160
+ "required": [
161
+ "id",
162
+ "title",
163
+ "body",
164
+ "priority",
165
+ "audience",
166
+ "requirement",
167
+ "categories",
168
+ "contentType",
169
+ "sourceHash",
170
+ "schemaVersion",
171
+ "createdAt",
172
+ "updatedAt"
173
+ ],
174
+ "additionalProperties": false
175
+ },
176
+ "AudienceScope": {
177
+ "type": "string",
178
+ "enum": [
179
+ "individual",
180
+ "group",
181
+ "all"
182
+ ]
183
+ },
184
+ "RequirementLevel": {
185
+ "type": "string",
186
+ "enum": [
187
+ "mandatory",
188
+ "critical",
189
+ "recommended",
190
+ "optional",
191
+ "deprecated"
192
+ ]
193
+ },
194
+ "ContentType": {
195
+ "type": "string",
196
+ "enum": [
197
+ "instruction",
198
+ "template",
199
+ "chat-session",
200
+ "reference",
201
+ "example",
202
+ "agent"
203
+ ]
204
+ }
205
+ }
206
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$ref": "#/definitions/RequirementLevel",
4
+ "definitions": {
5
+ "RequirementLevel": {
6
+ "type": "string",
7
+ "enum": [
8
+ "mandatory",
9
+ "critical",
10
+ "recommended",
11
+ "optional",
12
+ "deprecated"
13
+ ]
14
+ }
15
+ }
16
+ }