@jagilber-org/index-server 1.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (372) hide show
  1. package/CHANGELOG.md +1354 -0
  2. package/CODE_OF_CONDUCT.md +49 -0
  3. package/CONTRIBUTING.md +99 -0
  4. package/LICENSE +21 -0
  5. package/README.md +228 -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 +46 -0
  10. package/dist/config/dashboardConfig.js +67 -0
  11. package/dist/config/defaultValues.d.ts +63 -0
  12. package/dist/config/defaultValues.js +72 -0
  13. package/dist/config/dirConstants.d.ts +18 -0
  14. package/dist/config/dirConstants.js +29 -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 +151 -0
  18. package/dist/config/runtimeConfig.js +380 -0
  19. package/dist/config/serverConfig.d.ts +90 -0
  20. package/dist/config/serverConfig.js +167 -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 +2175 -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 +1587 -0
  29. package/dist/dashboard/client/js/admin.auth.js +179 -0
  30. package/dist/dashboard/client/js/admin.boot.js +359 -0
  31. package/dist/dashboard/client/js/admin.config.js +196 -0
  32. package/dist/dashboard/client/js/admin.embeddings.js +426 -0
  33. package/dist/dashboard/client/js/admin.graph.js +615 -0
  34. package/dist/dashboard/client/js/admin.instances.js +120 -0
  35. package/dist/dashboard/client/js/admin.instructions.js +579 -0
  36. package/dist/dashboard/client/js/admin.logs.js +113 -0
  37. package/dist/dashboard/client/js/admin.maintenance.js +393 -0
  38. package/dist/dashboard/client/js/admin.messaging.js +636 -0
  39. package/dist/dashboard/client/js/admin.monitor.js +184 -0
  40. package/dist/dashboard/client/js/admin.overview.js +221 -0
  41. package/dist/dashboard/client/js/admin.performance.js +61 -0
  42. package/dist/dashboard/client/js/admin.sessions.js +292 -0
  43. package/dist/dashboard/client/js/admin.sqlite.js +373 -0
  44. package/dist/dashboard/client/js/admin.utils.js +49 -0
  45. package/dist/dashboard/client/js/chart.umd.js +14 -0
  46. package/dist/dashboard/client/js/elk.bundled.js +6696 -0
  47. package/dist/dashboard/client/js/marked.umd.js +74 -0
  48. package/dist/dashboard/client/js/mermaid.min.js +3022 -0
  49. package/dist/dashboard/client/mermaid-layout-elk.esm.min.mjs +1 -0
  50. package/dist/dashboard/export/DataExporter.d.ts +169 -0
  51. package/dist/dashboard/export/DataExporter.js +737 -0
  52. package/dist/dashboard/export/exporters/csvExporter.d.ts +11 -0
  53. package/dist/dashboard/export/exporters/csvExporter.js +47 -0
  54. package/dist/dashboard/export/exporters/exportTypes.d.ts +89 -0
  55. package/dist/dashboard/export/exporters/exportTypes.js +5 -0
  56. package/dist/dashboard/export/exporters/jsonExporter.d.ts +7 -0
  57. package/dist/dashboard/export/exporters/jsonExporter.js +23 -0
  58. package/dist/dashboard/export/exporters/xmlExporter.d.ts +17 -0
  59. package/dist/dashboard/export/exporters/xmlExporter.js +176 -0
  60. package/dist/dashboard/integration/APIIntegration.d.ts +41 -0
  61. package/dist/dashboard/integration/APIIntegration.js +95 -0
  62. package/dist/dashboard/security/SecurityMonitor.d.ts +167 -0
  63. package/dist/dashboard/security/SecurityMonitor.js +560 -0
  64. package/dist/dashboard/server/AdminPanel.d.ts +195 -0
  65. package/dist/dashboard/server/AdminPanel.js +861 -0
  66. package/dist/dashboard/server/AdminPanelConfig.d.ts +42 -0
  67. package/dist/dashboard/server/AdminPanelConfig.js +80 -0
  68. package/dist/dashboard/server/AdminPanelState.d.ts +47 -0
  69. package/dist/dashboard/server/AdminPanelState.js +215 -0
  70. package/dist/dashboard/server/ApiRoutes.d.ts +17 -0
  71. package/dist/dashboard/server/ApiRoutes.js +184 -0
  72. package/dist/dashboard/server/DashboardServer.d.ts +49 -0
  73. package/dist/dashboard/server/DashboardServer.js +160 -0
  74. package/dist/dashboard/server/FileMetricsStorage.d.ts +49 -0
  75. package/dist/dashboard/server/FileMetricsStorage.js +196 -0
  76. package/dist/dashboard/server/HttpTransport.d.ts +23 -0
  77. package/dist/dashboard/server/HttpTransport.js +116 -0
  78. package/dist/dashboard/server/InstanceManager.d.ts +53 -0
  79. package/dist/dashboard/server/InstanceManager.js +295 -0
  80. package/dist/dashboard/server/KnowledgeStore.d.ts +35 -0
  81. package/dist/dashboard/server/KnowledgeStore.js +105 -0
  82. package/dist/dashboard/server/LeaderElection.d.ts +81 -0
  83. package/dist/dashboard/server/LeaderElection.js +268 -0
  84. package/dist/dashboard/server/MetricsCollector.d.ts +200 -0
  85. package/dist/dashboard/server/MetricsCollector.js +810 -0
  86. package/dist/dashboard/server/SessionPersistenceManager.d.ts +88 -0
  87. package/dist/dashboard/server/SessionPersistenceManager.js +458 -0
  88. package/dist/dashboard/server/ThinClient.d.ts +64 -0
  89. package/dist/dashboard/server/ThinClient.js +237 -0
  90. package/dist/dashboard/server/WebSocketManager.d.ts +161 -0
  91. package/dist/dashboard/server/WebSocketManager.js +448 -0
  92. package/dist/dashboard/server/httpLifecycle.d.ts +17 -0
  93. package/dist/dashboard/server/httpLifecycle.js +35 -0
  94. package/dist/dashboard/server/legacyDashboardHtml.d.ts +9 -0
  95. package/dist/dashboard/server/legacyDashboardHtml.js +618 -0
  96. package/dist/dashboard/server/legacyDashboardStyles.d.ts +5 -0
  97. package/dist/dashboard/server/legacyDashboardStyles.js +490 -0
  98. package/dist/dashboard/server/metricsAggregation.d.ts +252 -0
  99. package/dist/dashboard/server/metricsAggregation.js +210 -0
  100. package/dist/dashboard/server/metricsSerializer.d.ts +25 -0
  101. package/dist/dashboard/server/metricsSerializer.js +195 -0
  102. package/dist/dashboard/server/middleware/ensureLoadedMiddleware.d.ts +25 -0
  103. package/dist/dashboard/server/middleware/ensureLoadedMiddleware.js +24 -0
  104. package/dist/dashboard/server/routes/admin.routes.d.ts +16 -0
  105. package/dist/dashboard/server/routes/admin.routes.js +574 -0
  106. package/dist/dashboard/server/routes/adminAuth.d.ts +4 -0
  107. package/dist/dashboard/server/routes/adminAuth.js +46 -0
  108. package/dist/dashboard/server/routes/alerts.routes.d.ts +7 -0
  109. package/dist/dashboard/server/routes/alerts.routes.js +91 -0
  110. package/dist/dashboard/server/routes/api.feedback.routes.d.ts +73 -0
  111. package/dist/dashboard/server/routes/api.feedback.routes.js +171 -0
  112. package/dist/dashboard/server/routes/api.instructions.routes.d.ts +101 -0
  113. package/dist/dashboard/server/routes/api.instructions.routes.js +213 -0
  114. package/dist/dashboard/server/routes/api.usage.routes.d.ts +57 -0
  115. package/dist/dashboard/server/routes/api.usage.routes.js +374 -0
  116. package/dist/dashboard/server/routes/embeddings.routes.d.ts +6 -0
  117. package/dist/dashboard/server/routes/embeddings.routes.js +246 -0
  118. package/dist/dashboard/server/routes/graph.routes.d.ts +6 -0
  119. package/dist/dashboard/server/routes/graph.routes.js +279 -0
  120. package/dist/dashboard/server/routes/index.d.ts +39 -0
  121. package/dist/dashboard/server/routes/index.js +229 -0
  122. package/dist/dashboard/server/routes/instances.routes.d.ts +6 -0
  123. package/dist/dashboard/server/routes/instances.routes.js +35 -0
  124. package/dist/dashboard/server/routes/instructions.routes.d.ts +8 -0
  125. package/dist/dashboard/server/routes/instructions.routes.js +268 -0
  126. package/dist/dashboard/server/routes/knowledge.routes.d.ts +6 -0
  127. package/dist/dashboard/server/routes/knowledge.routes.js +80 -0
  128. package/dist/dashboard/server/routes/logs.routes.d.ts +6 -0
  129. package/dist/dashboard/server/routes/logs.routes.js +166 -0
  130. package/dist/dashboard/server/routes/messaging.routes.d.ts +16 -0
  131. package/dist/dashboard/server/routes/messaging.routes.js +307 -0
  132. package/dist/dashboard/server/routes/metrics.routes.d.ts +10 -0
  133. package/dist/dashboard/server/routes/metrics.routes.js +335 -0
  134. package/dist/dashboard/server/routes/scripts.routes.d.ts +9 -0
  135. package/dist/dashboard/server/routes/scripts.routes.js +84 -0
  136. package/dist/dashboard/server/routes/sqlite.routes.d.ts +9 -0
  137. package/dist/dashboard/server/routes/sqlite.routes.js +570 -0
  138. package/dist/dashboard/server/routes/status.routes.d.ts +7 -0
  139. package/dist/dashboard/server/routes/status.routes.js +179 -0
  140. package/dist/dashboard/server/routes/synthetic.routes.d.ts +7 -0
  141. package/dist/dashboard/server/routes/synthetic.routes.js +197 -0
  142. package/dist/dashboard/server/routes/tools.routes.d.ts +6 -0
  143. package/dist/dashboard/server/routes/tools.routes.js +47 -0
  144. package/dist/dashboard/server/routes/usage.routes.d.ts +6 -0
  145. package/dist/dashboard/server/routes/usage.routes.js +26 -0
  146. package/dist/dashboard/server/wsInit.d.ts +16 -0
  147. package/dist/dashboard/server/wsInit.js +35 -0
  148. package/dist/externalClientLib.d.ts +1 -0
  149. package/dist/externalClientLib.js +2 -0
  150. package/dist/minimal/index.d.ts +1 -0
  151. package/dist/minimal/index.js +140 -0
  152. package/dist/models/SessionPersistence.d.ts +115 -0
  153. package/dist/models/SessionPersistence.js +66 -0
  154. package/dist/models/instruction.d.ts +46 -0
  155. package/dist/models/instruction.js +2 -0
  156. package/dist/perf/benchmark.d.ts +1 -0
  157. package/dist/perf/benchmark.js +50 -0
  158. package/dist/portableClientWrapper.d.ts +1 -0
  159. package/dist/portableClientWrapper.js +2 -0
  160. package/dist/schemas/index.d.ts +132 -0
  161. package/dist/schemas/index.js +372 -0
  162. package/dist/scripts/runPerformanceBaseline.d.ts +1 -0
  163. package/dist/scripts/runPerformanceBaseline.js +17 -0
  164. package/dist/server/backgroundServicesStartup.d.ts +3 -0
  165. package/dist/server/backgroundServicesStartup.js +51 -0
  166. package/dist/server/handshakeManager.d.ts +25 -0
  167. package/dist/server/handshakeManager.js +470 -0
  168. package/dist/server/index-server.d.ts +38 -0
  169. package/dist/server/index-server.js +620 -0
  170. package/dist/server/multiInstanceStartup.d.ts +6 -0
  171. package/dist/server/multiInstanceStartup.js +132 -0
  172. package/dist/server/registry.d.ts +44 -0
  173. package/dist/server/registry.js +236 -0
  174. package/dist/server/sdkServer.d.ts +8 -0
  175. package/dist/server/sdkServer.js +299 -0
  176. package/dist/server/shutdownGuard.d.ts +41 -0
  177. package/dist/server/shutdownGuard.js +52 -0
  178. package/dist/server/startupDiagnostics.d.ts +2 -0
  179. package/dist/server/startupDiagnostics.js +33 -0
  180. package/dist/server/thin-client.d.ts +22 -0
  181. package/dist/server/thin-client.js +111 -0
  182. package/dist/server/transport.d.ts +41 -0
  183. package/dist/server/transport.js +312 -0
  184. package/dist/server/transportFactory.d.ts +21 -0
  185. package/dist/server/transportFactory.js +429 -0
  186. package/dist/services/atomicFs.d.ts +22 -0
  187. package/dist/services/atomicFs.js +103 -0
  188. package/dist/services/auditLog.d.ts +38 -0
  189. package/dist/services/auditLog.js +142 -0
  190. package/dist/services/autoBackup.d.ts +14 -0
  191. package/dist/services/autoBackup.js +171 -0
  192. package/dist/services/autoSplit.d.ts +32 -0
  193. package/dist/services/autoSplit.js +113 -0
  194. package/dist/services/backupZip.d.ts +25 -0
  195. package/dist/services/backupZip.js +112 -0
  196. package/dist/services/bootstrapGating.d.ts +123 -0
  197. package/dist/services/bootstrapGating.js +221 -0
  198. package/dist/services/canonical.d.ts +23 -0
  199. package/dist/services/canonical.js +65 -0
  200. package/dist/services/categoryRules.d.ts +7 -0
  201. package/dist/services/categoryRules.js +37 -0
  202. package/dist/services/classificationService.d.ts +42 -0
  203. package/dist/services/classificationService.js +168 -0
  204. package/dist/services/embeddingService.d.ts +62 -0
  205. package/dist/services/embeddingService.js +264 -0
  206. package/dist/services/errors.d.ts +22 -0
  207. package/dist/services/errors.js +31 -0
  208. package/dist/services/featureFlags.d.ts +25 -0
  209. package/dist/services/featureFlags.js +89 -0
  210. package/dist/services/features.d.ts +13 -0
  211. package/dist/services/features.js +35 -0
  212. package/dist/services/handlers/instructions.add.d.ts +1 -0
  213. package/dist/services/handlers/instructions.add.js +510 -0
  214. package/dist/services/handlers/instructions.groom.d.ts +1 -0
  215. package/dist/services/handlers/instructions.groom.js +575 -0
  216. package/dist/services/handlers/instructions.import.d.ts +1 -0
  217. package/dist/services/handlers/instructions.import.js +205 -0
  218. package/dist/services/handlers/instructions.patch.d.ts +1 -0
  219. package/dist/services/handlers/instructions.patch.js +121 -0
  220. package/dist/services/handlers/instructions.query.d.ts +159 -0
  221. package/dist/services/handlers/instructions.query.js +469 -0
  222. package/dist/services/handlers/instructions.reload.d.ts +1 -0
  223. package/dist/services/handlers/instructions.reload.js +13 -0
  224. package/dist/services/handlers/instructions.remove.d.ts +1 -0
  225. package/dist/services/handlers/instructions.remove.js +122 -0
  226. package/dist/services/handlers/instructions.shared.d.ts +32 -0
  227. package/dist/services/handlers/instructions.shared.js +91 -0
  228. package/dist/services/handlers.activation.d.ts +1 -0
  229. package/dist/services/handlers.activation.js +203 -0
  230. package/dist/services/handlers.bootstrap.d.ts +1 -0
  231. package/dist/services/handlers.bootstrap.js +38 -0
  232. package/dist/services/handlers.dashboardConfig.d.ts +34 -0
  233. package/dist/services/handlers.dashboardConfig.js +110 -0
  234. package/dist/services/handlers.diagnostics.d.ts +1 -0
  235. package/dist/services/handlers.diagnostics.js +64 -0
  236. package/dist/services/handlers.feedback.d.ts +15 -0
  237. package/dist/services/handlers.feedback.js +389 -0
  238. package/dist/services/handlers.gates.d.ts +1 -0
  239. package/dist/services/handlers.gates.js +47 -0
  240. package/dist/services/handlers.graph.d.ts +53 -0
  241. package/dist/services/handlers.graph.js +231 -0
  242. package/dist/services/handlers.help.d.ts +1 -0
  243. package/dist/services/handlers.help.js +119 -0
  244. package/dist/services/handlers.instructionSchema.d.ts +1 -0
  245. package/dist/services/handlers.instructionSchema.js +227 -0
  246. package/dist/services/handlers.instructions.d.ts +8 -0
  247. package/dist/services/handlers.instructions.js +14 -0
  248. package/dist/services/handlers.instructionsDiagnostics.d.ts +1 -0
  249. package/dist/services/handlers.instructionsDiagnostics.js +14 -0
  250. package/dist/services/handlers.integrity.d.ts +1 -0
  251. package/dist/services/handlers.integrity.js +35 -0
  252. package/dist/services/handlers.manifest.d.ts +1 -0
  253. package/dist/services/handlers.manifest.js +24 -0
  254. package/dist/services/handlers.messaging.d.ts +12 -0
  255. package/dist/services/handlers.messaging.js +203 -0
  256. package/dist/services/handlers.metrics.d.ts +1 -0
  257. package/dist/services/handlers.metrics.js +43 -0
  258. package/dist/services/handlers.promote.d.ts +1 -0
  259. package/dist/services/handlers.promote.js +326 -0
  260. package/dist/services/handlers.prompt.d.ts +1 -0
  261. package/dist/services/handlers.prompt.js +7 -0
  262. package/dist/services/handlers.search.d.ts +69 -0
  263. package/dist/services/handlers.search.js +669 -0
  264. package/dist/services/handlers.testPrimitive.d.ts +1 -0
  265. package/dist/services/handlers.testPrimitive.js +5 -0
  266. package/dist/services/handlers.trace.d.ts +1 -0
  267. package/dist/services/handlers.trace.js +35 -0
  268. package/dist/services/handlers.usage.d.ts +1 -0
  269. package/dist/services/handlers.usage.js +11 -0
  270. package/dist/services/hotScore.d.ts +137 -0
  271. package/dist/services/hotScore.js +244 -0
  272. package/dist/services/indexContext.d.ts +117 -0
  273. package/dist/services/indexContext.js +989 -0
  274. package/dist/services/indexLoader.d.ts +44 -0
  275. package/dist/services/indexLoader.js +920 -0
  276. package/dist/services/indexRepository.d.ts +32 -0
  277. package/dist/services/indexRepository.js +71 -0
  278. package/dist/services/indexingService.d.ts +1 -0
  279. package/dist/services/indexingService.js +2 -0
  280. package/dist/services/instructions.dispatcher.d.ts +1 -0
  281. package/dist/services/instructions.dispatcher.js +231 -0
  282. package/dist/services/logPrefix.d.ts +1 -0
  283. package/dist/services/logPrefix.js +30 -0
  284. package/dist/services/logger.d.ts +52 -0
  285. package/dist/services/logger.js +268 -0
  286. package/dist/services/manifestManager.d.ts +82 -0
  287. package/dist/services/manifestManager.js +200 -0
  288. package/dist/services/messaging/agentMailbox.d.ts +60 -0
  289. package/dist/services/messaging/agentMailbox.js +353 -0
  290. package/dist/services/messaging/messagingPersistence.d.ts +20 -0
  291. package/dist/services/messaging/messagingPersistence.js +111 -0
  292. package/dist/services/messaging/messagingTypes.d.ts +150 -0
  293. package/dist/services/messaging/messagingTypes.js +66 -0
  294. package/dist/services/ownershipService.d.ts +1 -0
  295. package/dist/services/ownershipService.js +36 -0
  296. package/dist/services/performanceBaseline.d.ts +19 -0
  297. package/dist/services/performanceBaseline.js +210 -0
  298. package/dist/services/preflight.d.ts +12 -0
  299. package/dist/services/preflight.js +79 -0
  300. package/dist/services/promptReviewService.d.ts +44 -0
  301. package/dist/services/promptReviewService.js +101 -0
  302. package/dist/services/responseEnvelope.d.ts +6 -0
  303. package/dist/services/responseEnvelope.js +25 -0
  304. package/dist/services/seedBootstrap.d.ts +34 -0
  305. package/dist/services/seedBootstrap.js +259 -0
  306. package/dist/services/storage/factory.d.ts +17 -0
  307. package/dist/services/storage/factory.js +35 -0
  308. package/dist/services/storage/hashUtils.d.ts +11 -0
  309. package/dist/services/storage/hashUtils.js +35 -0
  310. package/dist/services/storage/index.d.ts +12 -0
  311. package/dist/services/storage/index.js +18 -0
  312. package/dist/services/storage/jsonFileStore.d.ts +32 -0
  313. package/dist/services/storage/jsonFileStore.js +241 -0
  314. package/dist/services/storage/migrationEngine.d.ts +35 -0
  315. package/dist/services/storage/migrationEngine.js +93 -0
  316. package/dist/services/storage/sqliteMessageStore.d.ts +53 -0
  317. package/dist/services/storage/sqliteMessageStore.js +146 -0
  318. package/dist/services/storage/sqliteSchema.d.ts +12 -0
  319. package/dist/services/storage/sqliteSchema.js +123 -0
  320. package/dist/services/storage/sqliteStore.d.ts +42 -0
  321. package/dist/services/storage/sqliteStore.js +361 -0
  322. package/dist/services/storage/sqliteUsageStore.d.ts +35 -0
  323. package/dist/services/storage/sqliteUsageStore.js +94 -0
  324. package/dist/services/storage/types.d.ts +171 -0
  325. package/dist/services/storage/types.js +12 -0
  326. package/dist/services/toolHandlers.d.ts +23 -0
  327. package/dist/services/toolHandlers.js +50 -0
  328. package/dist/services/toolRegistry.d.ts +20 -0
  329. package/dist/services/toolRegistry.js +490 -0
  330. package/dist/services/toolRegistry.zod.d.ts +10 -0
  331. package/dist/services/toolRegistry.zod.js +325 -0
  332. package/dist/services/tracing.d.ts +26 -0
  333. package/dist/services/tracing.js +260 -0
  334. package/dist/services/usageBuckets.d.ts +161 -0
  335. package/dist/services/usageBuckets.js +364 -0
  336. package/dist/services/validationService.d.ts +38 -0
  337. package/dist/services/validationService.js +125 -0
  338. package/dist/utils/BufferRing.d.ts +203 -0
  339. package/dist/utils/BufferRing.js +551 -0
  340. package/dist/utils/BufferRingExamples.d.ts +55 -0
  341. package/dist/utils/BufferRingExamples.js +188 -0
  342. package/dist/utils/envUtils.d.ts +42 -0
  343. package/dist/utils/envUtils.js +80 -0
  344. package/dist/utils/memoryMonitor.d.ts +83 -0
  345. package/dist/utils/memoryMonitor.js +275 -0
  346. package/dist/versioning/schemaVersion.d.ts +6 -0
  347. package/dist/versioning/schemaVersion.js +94 -0
  348. package/package.json +139 -0
  349. package/schemas/README.md +13 -0
  350. package/schemas/feedback-entry.schema.json +27 -0
  351. package/schemas/graph-export-v2.schema.json +60 -0
  352. package/schemas/index-server.code-schema.json +40670 -0
  353. package/schemas/instruction.schema.json +262 -0
  354. package/schemas/json-schema/SessionPersistence-persisted-admin-session.schema.json +54 -0
  355. package/schemas/json-schema/SessionPersistence-persisted-session-history-entry.schema.json +51 -0
  356. package/schemas/json-schema/SessionPersistence-persisted-web-socket-connection.schema.json +54 -0
  357. package/schemas/json-schema/SessionPersistence-session-persistence-config.schema.json +110 -0
  358. package/schemas/json-schema/SessionPersistence-session-persistence-data.schema.json +229 -0
  359. package/schemas/json-schema/SessionPersistence-session-persistence-manifest.schema.json +109 -0
  360. package/schemas/json-schema/SessionPersistence-session-persistence-metadata.schema.json +55 -0
  361. package/schemas/json-schema/instruction-audience-scope.schema.json +14 -0
  362. package/schemas/json-schema/instruction-content-type.schema.json +17 -0
  363. package/schemas/json-schema/instruction-instruction-entry.schema.json +210 -0
  364. package/schemas/json-schema/instruction-requirement-level.schema.json +16 -0
  365. package/schemas/manifest.json +78 -0
  366. package/schemas/manifest.schema.json +33 -0
  367. package/schemas/usage-batch.schema.json +16 -0
  368. package/schemas/usage-buckets.schema.json +30 -0
  369. package/schemas/usage-event.schema.json +17 -0
  370. package/scripts/copy-dashboard-assets.mjs +170 -0
  371. package/scripts/dist/README.md +15 -0
  372. package/scripts/setup-hooks.cjs +28 -0
@@ -0,0 +1,372 @@
1
+ "use strict";
2
+ // JSON Schemas for tool response contracts. These are used in tests to lock interfaces.
3
+ // Increment version in docs/tools.md when changing any stable schema.
4
+ Object.defineProperty(exports, "__esModule", { value: true });
5
+ exports.schemas = exports.instructionEntry = void 0;
6
+ exports.instructionEntry = {
7
+ type: 'object',
8
+ additionalProperties: false,
9
+ required: [
10
+ 'id', 'title', 'body', 'priority', 'audience', 'requirement', 'categories', 'sourceHash', 'schemaVersion', 'createdAt', 'updatedAt',
11
+ 'version', 'status', 'owner', 'priorityTier', 'classification', 'lastReviewedAt', 'nextReviewDue', 'changeLog', 'semanticSummary'
12
+ ],
13
+ properties: {
14
+ id: { type: 'string', minLength: 1 },
15
+ title: { type: 'string' },
16
+ body: { type: 'string' },
17
+ rationale: { type: 'string' },
18
+ priority: { type: 'number' },
19
+ audience: { enum: ['individual', 'group', 'all'] },
20
+ requirement: { enum: ['mandatory', 'critical', 'recommended', 'optional', 'deprecated'] },
21
+ categories: { type: 'array', items: { type: 'string' } },
22
+ sourceHash: { type: 'string' },
23
+ schemaVersion: { type: 'string' },
24
+ deprecatedBy: { type: 'string' },
25
+ createdAt: { type: 'string' },
26
+ updatedAt: { type: 'string' },
27
+ usageCount: { type: 'number' },
28
+ firstSeenTs: { type: 'string' },
29
+ lastUsedAt: { type: 'string' },
30
+ riskScore: { type: 'number' },
31
+ workspaceId: { type: 'string' },
32
+ userId: { type: 'string' },
33
+ teamIds: { type: 'array', items: { type: 'string' } },
34
+ version: { type: 'string' },
35
+ status: { enum: ['draft', 'review', 'approved', 'deprecated'] },
36
+ owner: { type: 'string' },
37
+ priorityTier: { enum: ['P1', 'P2', 'P3', 'P4'] },
38
+ classification: { enum: ['public', 'internal', 'restricted'] },
39
+ lastReviewedAt: { type: 'string' },
40
+ nextReviewDue: { type: 'string' },
41
+ changeLog: { type: 'array', items: { type: 'object', required: ['version', 'changedAt', 'summary'], additionalProperties: false, properties: { version: { type: 'string' }, changedAt: { type: 'string' }, summary: { type: 'string' } } } },
42
+ supersedes: { type: 'string' },
43
+ semanticSummary: { type: 'string' },
44
+ createdByAgent: { type: 'string' },
45
+ sourceWorkspace: { type: 'string' },
46
+ extensions: { type: 'object', additionalProperties: true }
47
+ }
48
+ };
49
+ // (listLike schema removed after dispatcher consolidation of read-only instruction methods)
50
+ // Using unknown for schema values to avoid any and preserve flexibility
51
+ exports.schemas = {
52
+ 'health_check': {
53
+ type: 'object', additionalProperties: false,
54
+ required: ['status', 'timestamp', 'version'],
55
+ properties: {
56
+ status: { const: 'ok' },
57
+ timestamp: { type: 'string' },
58
+ version: { type: 'string' }
59
+ }
60
+ },
61
+ 'index_dispatch': {
62
+ // Dispatcher returns varying shapes; keep loose but assert required action echo when capabilities.
63
+ anyOf: [
64
+ { type: 'object', required: ['supportedActions', 'mutationEnabled', 'version'], additionalProperties: true, properties: {
65
+ version: { type: 'string' },
66
+ supportedActions: { type: 'array', items: { type: 'string' } },
67
+ mutationEnabled: { type: 'boolean' }
68
+ } },
69
+ { type: 'object', required: ['results'], additionalProperties: true, properties: { results: { type: 'array' } } },
70
+ { type: 'object', required: ['hash'], additionalProperties: true, properties: { hash: { type: 'string' } } },
71
+ { type: 'object', required: ['error'], additionalProperties: true, properties: { error: { type: 'string' } } }
72
+ ]
73
+ },
74
+ 'index_import': {
75
+ anyOf: [
76
+ { type: 'object', required: ['error'], properties: { error: { type: 'string' } }, additionalProperties: true },
77
+ { type: 'object', required: ['hash', 'imported', 'skipped', 'overwritten', 'errors', 'total'], additionalProperties: false, properties: {
78
+ hash: { type: 'string' }, imported: { type: 'number' }, skipped: { type: 'number' }, overwritten: { type: 'number' }, total: { type: 'number' }, errors: { type: 'array', items: { type: 'object', required: ['id', 'error'], properties: { id: { type: 'string' }, error: { type: 'string' } }, additionalProperties: false } }
79
+ } }
80
+ ]
81
+ },
82
+ 'index_repair': { type: 'object', required: ['repaired', 'updated'], additionalProperties: false, properties: { repaired: { type: 'number' }, updated: { type: 'array', items: { type: 'string' } } } },
83
+ 'prompt_review': {
84
+ anyOf: [
85
+ { type: 'object', required: ['truncated', 'message', 'max'], additionalProperties: false, properties: {
86
+ truncated: { const: true },
87
+ message: { type: 'string' },
88
+ max: { type: 'number' }
89
+ } },
90
+ { type: 'object', required: ['issues', 'summary', 'length'], additionalProperties: false, properties: {
91
+ issues: { type: 'array', items: { type: 'object' } },
92
+ summary: { type: 'object' },
93
+ length: { type: 'number' }
94
+ } }
95
+ ]
96
+ },
97
+ 'integrity_verify': {
98
+ type: 'object', additionalProperties: false,
99
+ required: ['hash', 'count', 'issues', 'issueCount'],
100
+ properties: {
101
+ hash: { type: 'string' },
102
+ count: { type: 'number' },
103
+ issues: { type: 'array', items: { type: 'object', required: ['id', 'expected', 'actual'], properties: { id: { type: 'string' }, expected: { type: 'string' }, actual: { type: 'string' } }, additionalProperties: false } },
104
+ issueCount: { type: 'number' }
105
+ }
106
+ },
107
+ 'usage_track': {
108
+ anyOf: [
109
+ { type: 'object', required: ['error'], properties: { error: { type: 'string' } }, additionalProperties: true },
110
+ { type: 'object', required: ['notFound'], properties: { notFound: { const: true } }, additionalProperties: true },
111
+ { type: 'object', required: ['featureDisabled'], properties: { featureDisabled: { const: true } }, additionalProperties: true },
112
+ { type: 'object', required: ['id', 'usageCount', 'lastUsedAt'], additionalProperties: false, properties: {
113
+ id: { type: 'string' }, usageCount: { type: 'number' }, firstSeenTs: { type: 'string' }, lastUsedAt: { type: 'string' }
114
+ } }
115
+ ]
116
+ },
117
+ 'usage_hotset': {
118
+ type: 'object', additionalProperties: false,
119
+ required: ['hash', 'count', 'limit', 'items'],
120
+ properties: {
121
+ hash: { type: 'string' },
122
+ count: { type: 'number' },
123
+ 'feature_status': {
124
+ type: 'object',
125
+ properties: {},
126
+ additionalProperties: false
127
+ },
128
+ limit: { type: 'number' },
129
+ items: { type: 'array', items: { type: 'object', required: ['id', 'usageCount'], additionalProperties: false, properties: {
130
+ id: { type: 'string' }, usageCount: { type: 'number' }, lastUsedAt: { type: 'string' }
131
+ } } }
132
+ }
133
+ },
134
+ 'metrics_snapshot': {
135
+ type: 'object', additionalProperties: false,
136
+ required: ['generatedAt', 'methods'],
137
+ properties: {
138
+ generatedAt: { type: 'string' },
139
+ methods: { type: 'array', items: { type: 'object', required: ['method', 'count', 'avgMs', 'maxMs'], additionalProperties: false, properties: {
140
+ method: { type: 'string' }, count: { type: 'number' }, avgMs: { type: 'number' }, maxMs: { type: 'number' }
141
+ } } },
142
+ features: { type: 'object', additionalProperties: true }
143
+ }
144
+ },
145
+ 'index_governanceHash': {
146
+ type: 'object', additionalProperties: false,
147
+ required: ['count', 'governanceHash', 'items'],
148
+ properties: {
149
+ count: { type: 'number' },
150
+ governanceHash: { type: 'string' },
151
+ items: { type: 'array', items: { type: 'object', required: ['id', 'title', 'version', 'owner', 'priorityTier', 'nextReviewDue', 'semanticSummarySha256', 'changeLogLength'], additionalProperties: false, properties: {
152
+ id: { type: 'string' }, title: { type: 'string' }, version: { type: 'string' }, owner: { type: 'string' }, priorityTier: { type: 'string' }, nextReviewDue: { type: 'string' }, semanticSummarySha256: { type: 'string' }, changeLogLength: { type: 'number' }
153
+ } } }
154
+ }
155
+ },
156
+ 'index_health': {
157
+ anyOf: [
158
+ { type: 'object', required: ['snapshot', 'hash', 'count'], additionalProperties: true, properties: { snapshot: { const: 'missing' }, hash: { type: 'string' }, count: { type: 'number' } } },
159
+ { type: 'object', required: ['snapshot', 'hash', 'count', 'missing', 'changed', 'extra', 'drift'], additionalProperties: true, properties: {
160
+ snapshot: { const: 'present' }, hash: { type: 'string' }, count: { type: 'number' },
161
+ missing: { type: 'array', items: { type: 'string' } },
162
+ changed: { type: 'array', items: { type: 'string' } },
163
+ extra: { type: 'array', items: { type: 'string' } },
164
+ drift: { type: 'number' }
165
+ } },
166
+ { type: 'object', required: ['snapshot', 'hash', 'error'], additionalProperties: true, properties: { snapshot: { const: 'error' }, hash: { type: 'string' }, error: { type: 'string' } } }
167
+ ]
168
+ },
169
+ 'gates_evaluate': {
170
+ anyOf: [
171
+ { type: 'object', required: ['notConfigured'], properties: { notConfigured: { const: true } }, additionalProperties: true },
172
+ { type: 'object', required: ['error'], properties: { error: { type: 'string' } }, additionalProperties: true },
173
+ { type: 'object', required: ['generatedAt', 'results', 'summary'], additionalProperties: false, properties: {
174
+ generatedAt: { type: 'string' },
175
+ results: { type: 'array', items: { type: 'object', required: ['id', 'passed', 'count', 'op', 'value', 'severity'], additionalProperties: true, properties: {
176
+ id: { type: 'string' }, passed: { type: 'boolean' }, count: { type: 'number' }, op: { type: 'string' }, value: { type: 'number' }, severity: { type: 'string' }, description: { type: 'string' }
177
+ } } },
178
+ summary: { type: 'object', required: ['errors', 'warnings', 'total'], properties: { errors: { type: 'number' }, warnings: { type: 'number' }, total: { type: 'number' } }, additionalProperties: false }
179
+ } }
180
+ ]
181
+ },
182
+ // Graph export (legacy v1 + enriched v2). Optional contract registration enabling future schema locking.
183
+ 'graph_export': {
184
+ anyOf: [
185
+ { type: 'object', required: ['meta', 'nodes', 'edges'], additionalProperties: true, properties: {
186
+ meta: { type: 'object', required: ['graphSchemaVersion', 'nodeCount', 'edgeCount'], additionalProperties: true, properties: { graphSchemaVersion: { const: 1 }, nodeCount: { type: 'number' }, edgeCount: { type: 'number' } } },
187
+ nodes: { type: 'array', items: { type: 'object', required: ['id'], additionalProperties: true, properties: { id: { type: 'string' } } } },
188
+ edges: { type: 'array', items: { type: 'object', required: ['from', 'to', 'type'], additionalProperties: true, properties: { from: { type: 'string' }, to: { type: 'string' }, type: { enum: ['primary', 'category'] } } } }
189
+ } },
190
+ { type: 'object', required: ['meta', 'nodes', 'edges'], additionalProperties: true, properties: {
191
+ meta: { type: 'object', required: ['graphSchemaVersion', 'nodeCount', 'edgeCount'], additionalProperties: true, properties: { graphSchemaVersion: { const: 2 }, nodeCount: { type: 'number' }, edgeCount: { type: 'number' } } },
192
+ nodes: { type: 'array', items: { type: 'object', required: ['id'], additionalProperties: true, properties: { id: { type: 'string' }, nodeType: { enum: ['instruction', 'category'] }, categories: { type: 'array', items: { type: 'string' } }, primaryCategory: { type: 'string' }, usageCount: { type: 'number' } } } },
193
+ edges: { type: 'array', items: { type: 'object', required: ['from', 'to', 'type'], additionalProperties: true, properties: { from: { type: 'string' }, to: { type: 'string' }, type: { enum: ['primary', 'category', 'belongs'] } } } },
194
+ mermaid: { type: 'string' }, dot: { type: 'string' }
195
+ } }
196
+ ]
197
+ },
198
+ 'meta_tools': {
199
+ type: 'object', additionalProperties: true,
200
+ required: ['stable', 'dynamic', 'tools'],
201
+ properties: {
202
+ // Legacy flat list (includes disabled flag)
203
+ tools: { type: 'array', items: { type: 'object', required: ['method'], additionalProperties: true, properties: {
204
+ method: { type: 'string' }, stable: { type: 'boolean' }, mutation: { type: 'boolean' }, disabled: { type: 'boolean' }
205
+ } } },
206
+ stable: {
207
+ type: 'object', additionalProperties: false,
208
+ required: ['tools'],
209
+ properties: {
210
+ tools: { type: 'array', items: { type: 'object', required: ['method', 'stable', 'mutation'], additionalProperties: true, properties: {
211
+ method: { type: 'string' },
212
+ stable: { type: 'boolean' },
213
+ mutation: { type: 'boolean' }
214
+ } } }
215
+ }
216
+ },
217
+ dynamic: {
218
+ type: 'object', additionalProperties: true,
219
+ required: ['generatedAt', 'mutationEnabled', 'disabled'],
220
+ properties: {
221
+ generatedAt: { type: 'string' },
222
+ mutationEnabled: { type: 'boolean' },
223
+ disabled: { type: 'array', items: { type: 'object', required: ['method'], additionalProperties: false, properties: { method: { type: 'string' } } } }
224
+ }
225
+ },
226
+ // New MCP style registry (optional for now)
227
+ mcp: {
228
+ type: 'object', additionalProperties: true,
229
+ required: ['registryVersion', 'tools'],
230
+ properties: {
231
+ registryVersion: { type: 'string' },
232
+ tools: { type: 'array', items: { type: 'object', required: ['name', 'description', 'stable', 'mutation', 'inputSchema'], additionalProperties: false, properties: {
233
+ name: { type: 'string' },
234
+ description: { type: 'string' },
235
+ stable: { type: 'boolean' },
236
+ mutation: { type: 'boolean' },
237
+ inputSchema: { type: 'object' },
238
+ outputSchema: { type: 'object' }
239
+ } } }
240
+ }
241
+ }
242
+ }
243
+ },
244
+ 'help_overview': {
245
+ type: 'object',
246
+ additionalProperties: true,
247
+ required: ['generatedAt', 'version', 'sections'],
248
+ properties: {
249
+ generatedAt: { type: 'string' },
250
+ version: { type: 'string' },
251
+ summary: { type: 'string' },
252
+ sections: { type: 'array', items: { type: 'object', required: ['id', 'title', 'content'], additionalProperties: true, properties: {
253
+ id: { type: 'string' },
254
+ title: { type: 'string' },
255
+ content: { type: 'string' },
256
+ bullets: { type: 'array', items: { type: 'string' } },
257
+ nextActions: { type: 'array', items: { type: 'string' } }
258
+ } } },
259
+ lifecycleModel: { type: 'object', additionalProperties: true, properties: {
260
+ tiers: { type: 'array', items: { type: 'object', required: ['tier', 'purpose'], additionalProperties: true, properties: { tier: { type: 'string' }, purpose: { type: 'string' } } } },
261
+ promotionChecklist: { type: 'array', items: { type: 'string' } }
262
+ } },
263
+ toolDiscovery: { type: 'object', additionalProperties: true, properties: {
264
+ primary: { type: 'array', items: { type: 'string' } },
265
+ diagnostics: { type: 'array', items: { type: 'string' } }
266
+ } }
267
+ }
268
+ },
269
+ 'index_schema': {
270
+ type: 'object',
271
+ additionalProperties: false,
272
+ required: ['generatedAt', 'version', 'summary', 'schema', 'minimalExample', 'requiredFields', 'optionalFieldsCommon', 'promotionWorkflow', 'validationRules', 'nextSteps'],
273
+ properties: {
274
+ generatedAt: { type: 'string' },
275
+ version: { type: 'string' },
276
+ summary: { type: 'string' },
277
+ schema: { type: 'object', additionalProperties: true },
278
+ minimalExample: { type: 'object', additionalProperties: true },
279
+ requiredFields: { type: 'array', items: { type: 'string' } },
280
+ optionalFieldsCommon: { type: 'array', items: { type: 'string' } },
281
+ promotionWorkflow: { type: 'array', items: { type: 'object', required: ['stage', 'description', 'checklistItems'], additionalProperties: false, properties: {
282
+ stage: { type: 'string' },
283
+ description: { type: 'string' },
284
+ checklistItems: { type: 'array', items: { type: 'string' } }
285
+ } } },
286
+ validationRules: { type: 'array', items: { type: 'object', required: ['field', 'rule', 'constraint'], additionalProperties: false, properties: {
287
+ field: { type: 'string' },
288
+ rule: { type: 'string' },
289
+ constraint: { type: 'string' }
290
+ } } },
291
+ nextSteps: { type: 'array', items: { type: 'string' } }
292
+ }
293
+ },
294
+ 'usage_flush': { type: 'object', required: ['flushed'], additionalProperties: false, properties: { flushed: { const: true } } },
295
+ 'index_reload': { type: 'object', required: ['reloaded', 'hash', 'count'], additionalProperties: false, properties: { reloaded: { const: true }, hash: { type: 'string' }, count: { type: 'number' } } },
296
+ 'index_remove': { type: 'object', required: ['removed', 'removedIds', 'missing', 'errorCount', 'errors'], additionalProperties: false, properties: {
297
+ removed: { type: 'number' },
298
+ removedIds: { type: 'array', items: { type: 'string' } },
299
+ missing: { type: 'array', items: { type: 'string' } },
300
+ errorCount: { type: 'number' },
301
+ errors: { type: 'array', items: { type: 'object', required: ['id', 'error'], additionalProperties: false, properties: { id: { type: 'string' }, error: { type: 'string' } } } }
302
+ } },
303
+ 'index_enrich': { type: 'object', required: ['rewritten', 'updated', 'skipped'], additionalProperties: false, properties: {
304
+ rewritten: { type: 'number' },
305
+ updated: { type: 'array', items: { type: 'string' } },
306
+ skipped: { type: 'array', items: { type: 'string' } }
307
+ } },
308
+ 'index_add': {
309
+ anyOf: [
310
+ { type: 'object', required: ['error'], properties: { error: { type: 'string' }, id: { type: 'string' } }, additionalProperties: true },
311
+ { type: 'object', required: ['id', 'hash', 'skipped', 'created', 'overwritten'], additionalProperties: false, properties: {
312
+ id: { type: 'string' }, hash: { type: 'string' }, skipped: { type: 'boolean' }, created: { type: 'boolean' }, overwritten: { type: 'boolean' }
313
+ } }
314
+ ]
315
+ },
316
+ 'index_groom': {
317
+ type: 'object', additionalProperties: false,
318
+ required: ['previousHash', 'hash', 'scanned', 'repairedHashes', 'normalizedCategories', 'deprecatedRemoved', 'duplicatesMerged', 'signalApplied', 'filesRewritten', 'purgedScopes', 'dryRun', 'notes'],
319
+ properties: {
320
+ previousHash: { type: 'string' },
321
+ hash: { type: 'string' },
322
+ scanned: { type: 'number' },
323
+ repairedHashes: { type: 'number' },
324
+ normalizedCategories: { type: 'number' },
325
+ deprecatedRemoved: { type: 'number' },
326
+ duplicatesMerged: { type: 'number' },
327
+ signalApplied: { type: 'number' },
328
+ filesRewritten: { type: 'number' },
329
+ purgedScopes: { type: 'number' },
330
+ migrated: { type: 'number' },
331
+ remappedCategories: { type: 'number' },
332
+ dryRun: { type: 'boolean' },
333
+ notes: { type: 'array', items: { type: 'string' } }
334
+ }
335
+ },
336
+ 'index_search': {
337
+ type: 'object',
338
+ additionalProperties: false,
339
+ required: ['results', 'totalMatches', 'query', 'executionTimeMs'],
340
+ properties: {
341
+ results: {
342
+ type: 'array',
343
+ items: {
344
+ type: 'object',
345
+ additionalProperties: false,
346
+ required: ['instructionId', 'relevanceScore', 'matchedFields'],
347
+ properties: {
348
+ instructionId: { type: 'string' },
349
+ relevanceScore: { type: 'number' },
350
+ matchedFields: {
351
+ type: 'array',
352
+ items: { enum: ['title', 'body', 'categories'] }
353
+ }
354
+ }
355
+ }
356
+ },
357
+ totalMatches: { type: 'number' },
358
+ query: {
359
+ type: 'object',
360
+ additionalProperties: false,
361
+ required: ['keywords', 'limit', 'includeCategories', 'caseSensitive'],
362
+ properties: {
363
+ keywords: { type: 'array', items: { type: 'string' } },
364
+ limit: { type: 'number' },
365
+ includeCategories: { type: 'boolean' },
366
+ caseSensitive: { type: 'boolean' }
367
+ }
368
+ },
369
+ executionTimeMs: { type: 'number' }
370
+ }
371
+ }
372
+ };
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ // CLI runner for performance baseline measurement
4
+ const performanceBaseline_1 = require("../services/performanceBaseline");
5
+ async function main() {
6
+ try {
7
+ const results = await (0, performanceBaseline_1.runPerformanceBaseline)();
8
+ process.exit(results.summary.meetsTarget ? 0 : 1);
9
+ }
10
+ catch (error) {
11
+ console.error('❌ Performance baseline failed:', error instanceof Error ? error.message : String(error));
12
+ process.exit(1);
13
+ }
14
+ }
15
+ if (require.main === module) {
16
+ main();
17
+ }
@@ -0,0 +1,3 @@
1
+ import type { RuntimeConfig } from '../config/runtimeConfig';
2
+ export declare function startOptionalMemoryMonitoring(_runtime: RuntimeConfig): void;
3
+ export declare function startDeferredBackgroundServices(runtime: RuntimeConfig): void;
@@ -0,0 +1,51 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.startOptionalMemoryMonitoring = startOptionalMemoryMonitoring;
4
+ exports.startDeferredBackgroundServices = startDeferredBackgroundServices;
5
+ const envUtils_1 = require("../utils/envUtils");
6
+ const indexContext_1 = require("../services/indexContext");
7
+ const autoBackup_1 = require("../services/autoBackup");
8
+ const memoryMonitor_1 = require("../utils/memoryMonitor");
9
+ function startOptionalMemoryMonitoring(_runtime) {
10
+ if ((0, envUtils_1.getBooleanEnv)('INDEX_SERVER_DEBUG') || (0, envUtils_1.getBooleanEnv)('INDEX_SERVER_MEMORY_MONITOR')) {
11
+ try {
12
+ const memMonitor = (0, memoryMonitor_1.getMemoryMonitor)();
13
+ memMonitor.startMonitoring(10000);
14
+ process.stderr.write('[startup] Memory monitoring enabled (interval: 10s)\n');
15
+ process.stderr.write('[startup] Memory monitor commands: memStatus(), startMemWatch(), stopMemWatch(), memReport(), forceGC(), checkListeners()\n');
16
+ }
17
+ catch (error) {
18
+ process.stderr.write(`[startup] Memory monitoring failed: ${error}\n`);
19
+ }
20
+ }
21
+ }
22
+ function startDeferredBackgroundServices(runtime) {
23
+ try {
24
+ if (runtime.server.indexPolling.enabled) {
25
+ (0, indexContext_1.startIndexVersionPoller)({
26
+ proactive: runtime.server.indexPolling.proactive,
27
+ intervalMs: runtime.server.indexPolling.intervalMs,
28
+ });
29
+ if (runtime.logging.diagnostics) {
30
+ try {
31
+ process.stderr.write(`[startup] index version poller started proactive=${runtime.server.indexPolling.proactive}\n`);
32
+ }
33
+ catch { /* ignore */ }
34
+ }
35
+ }
36
+ else if (runtime.logging.diagnostics) {
37
+ try {
38
+ process.stderr.write('[startup] index version poller not enabled (set INDEX_SERVER_ENABLE_INDEX_SERVER_POLLER=1)\n');
39
+ }
40
+ catch { /* ignore */ }
41
+ }
42
+ }
43
+ catch { /* ignore */ }
44
+ try {
45
+ setImmediate(() => { try {
46
+ (0, autoBackup_1.startAutoBackup)();
47
+ }
48
+ catch { /* ignore */ } });
49
+ }
50
+ catch { /* ignore */ }
51
+ }
@@ -0,0 +1,25 @@
1
+ export declare function isHandshakeTraceEnabled(): boolean;
2
+ export declare function handshakeLog(stage: string, data?: Record<string, unknown>): void;
3
+ export declare function isHandshakeFallbacksEnabled(): boolean;
4
+ export declare const SUPPORTED_PROTOCOL_VERSIONS: string[];
5
+ export interface HandshakeEvent {
6
+ seq: number;
7
+ ts: string;
8
+ stage: string;
9
+ extra?: Record<string, unknown>;
10
+ }
11
+ export declare function record(stage: string, extra?: Record<string, unknown>): void;
12
+ export declare function isInitFrameDiagEnabled(): boolean;
13
+ export declare function initFrameLog(stage: string, extra?: Record<string, unknown>): void;
14
+ export declare function negotiateProtocolVersion(requested?: string): string;
15
+ export declare function emitReadyGlobal(server: any, reason: string): void;
16
+ /**
17
+ * Pre-connect stdin sniffer: if we observe an initialize request but downstream logic fails
18
+ * to emit server/ready, schedule a guarded fallback emission.
19
+ */
20
+ export declare function setupStdinSniffer(server: any): void;
21
+ /**
22
+ * Safety fallback timers for missed ready emissions, unconditional DIAG fallback,
23
+ * and _oninitialize patch for protocol negotiation.
24
+ */
25
+ export declare function setupSafetyFallbacks(server: any): void;