@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,35 @@
1
+ "use strict";
2
+ // Feature flag & metrics infrastructure (Phase 0)
3
+ // INDEX_SERVER_FEATURES=usage,window,hotness,drift,risk
4
+ Object.defineProperty(exports, "__esModule", { value: true });
5
+ exports.hasFeature = hasFeature;
6
+ exports.incrementCounter = incrementCounter;
7
+ exports.getCounters = getCounters;
8
+ exports.featureStatus = featureStatus;
9
+ exports.enableFeature = enableFeature;
10
+ const runtimeConfig_1 = require("../config/runtimeConfig");
11
+ const BASE_FEATURES = Array.from((0, runtimeConfig_1.getRuntimeConfig)().featureFlags.indexFeatures);
12
+ const SET = new Set(BASE_FEATURES);
13
+ function hasFeature(name) { return SET.has(name); }
14
+ // Simple in-memory counters (could be exposed via metrics_snapshot already existing)
15
+ const counters = {};
16
+ function incrementCounter(name, by = 1) { counters[name] = (counters[name] || 0) + by; }
17
+ function getCounters() { return { ...counters }; }
18
+ // Record activation counts once at module load
19
+ for (const f of SET) {
20
+ incrementCounter(`featureActivated:${f}`);
21
+ }
22
+ function featureStatus() {
23
+ return {
24
+ features: Array.from(SET.values()).sort(),
25
+ counters: getCounters(),
26
+ env: BASE_FEATURES.length ? [...BASE_FEATURES] : [],
27
+ };
28
+ }
29
+ // Test helper / dynamic enable (used in tests to activate features post-initial load)
30
+ function enableFeature(name) {
31
+ if (!SET.has(name)) {
32
+ SET.add(name);
33
+ incrementCounter(`featureActivated:${name}`);
34
+ }
35
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,510 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const fs_1 = __importDefault(require("fs"));
7
+ const path_1 = __importDefault(require("path"));
8
+ const crypto_1 = __importDefault(require("crypto"));
9
+ const registry_1 = require("../../server/registry");
10
+ const indexContext_1 = require("../indexContext");
11
+ const features_1 = require("../features");
12
+ const schemaVersion_1 = require("../../versioning/schemaVersion");
13
+ const classificationService_1 = require("../classificationService");
14
+ const ownershipService_1 = require("../ownershipService");
15
+ const auditLog_1 = require("../auditLog");
16
+ const toolRegistry_1 = require("../toolRegistry");
17
+ const runtimeConfig_1 = require("../../config/runtimeConfig");
18
+ const canonical_1 = require("../canonical");
19
+ const manifestManager_1 = require("../manifestManager");
20
+ const tracing_1 = require("../tracing");
21
+ const instructions_shared_1 = require("./instructions.shared");
22
+ (0, registry_1.registerHandler)('index_add', (0, instructions_shared_1.guard)('index_add', (p) => {
23
+ const e = p.entry;
24
+ const instructionsCfg = (0, runtimeConfig_1.getRuntimeConfig)().instructions;
25
+ const SEMVER_REGEX = /^([0-9]+)\.([0-9]+)\.([0-9]+)(?:[-+].*)?$/;
26
+ const ADD_INPUT_SCHEMA = (0, toolRegistry_1.getToolRegistry)({ tier: 'admin' }).find(t => t.name === 'index_add')?.inputSchema;
27
+ const fail = (error, opts) => {
28
+ const id = opts?.id || (e && e.id) || 'unknown';
29
+ const rawBody = e && typeof e.body === 'string' ? e.body : (e && e.body ? String(e.body) : '');
30
+ const bodyPreview = rawBody.trim().slice(0, 200);
31
+ const reproEntry = e ? {
32
+ id,
33
+ title: e.title || id,
34
+ requirement: e.requirement,
35
+ priorityTier: e.priorityTier,
36
+ owner: e.owner,
37
+ bodyPreview
38
+ } : { id };
39
+ const base = {
40
+ id,
41
+ created: false,
42
+ overwritten: false,
43
+ skipped: false,
44
+ error,
45
+ hash: opts?.hash,
46
+ feedbackHint: 'Creation failed. If unexpected, call feedback_submit with reproEntry.',
47
+ reproEntry
48
+ };
49
+ if (/^missing (entry|id|required fields)/.test(error) || error === 'missing required fields') {
50
+ if (ADD_INPUT_SCHEMA) {
51
+ base.schemaRef = "meta_tools[name='index_add'].inputSchema";
52
+ base.inputSchema = ADD_INPUT_SCHEMA;
53
+ }
54
+ else {
55
+ base.schemaRef = 'meta_tools (lookup index_add)';
56
+ }
57
+ }
58
+ return base;
59
+ };
60
+ const metadataEquals = (left, right) => {
61
+ if (left === right)
62
+ return true;
63
+ if (left == null || right == null)
64
+ return left === right;
65
+ if (typeof left === 'object' || typeof right === 'object') {
66
+ try {
67
+ return JSON.stringify(left) === JSON.stringify(right);
68
+ }
69
+ catch {
70
+ return false;
71
+ }
72
+ }
73
+ return false;
74
+ };
75
+ if (!e)
76
+ return fail('missing entry');
77
+ const lax = !!(p.lax || e?.lax);
78
+ if (lax) {
79
+ if (!e.id)
80
+ return fail('missing id');
81
+ const mutable = e;
82
+ if (!mutable.title)
83
+ mutable.title = mutable.id;
84
+ if (typeof mutable.priority !== 'number')
85
+ mutable.priority = 50;
86
+ if (!mutable.audience)
87
+ mutable.audience = 'all';
88
+ if (!mutable.requirement)
89
+ mutable.requirement = 'optional';
90
+ if (!Array.isArray(mutable.categories))
91
+ mutable.categories = [];
92
+ }
93
+ if (p.overwrite && (!e.body || !e.title)) {
94
+ try {
95
+ // Try in-memory state first (covers SQLite and JSON backends), fall back to disk
96
+ let raw;
97
+ const stHydrate = (0, indexContext_1.ensureLoaded)();
98
+ const memEntry = stHydrate.byId.get(e.id);
99
+ if (memEntry) {
100
+ raw = { ...memEntry };
101
+ }
102
+ if (!raw) {
103
+ const dirCandidate = (0, indexContext_1.getInstructionsDir)();
104
+ const fileCandidate = path_1.default.join(dirCandidate, `${e.id}.json`);
105
+ if (fs_1.default.existsSync(fileCandidate)) {
106
+ try {
107
+ raw = JSON.parse(fs_1.default.readFileSync(fileCandidate, 'utf8'));
108
+ }
109
+ catch { /* ignore parse */ }
110
+ }
111
+ }
112
+ if (raw) {
113
+ const mutableExisting = e;
114
+ if (!mutableExisting.body && typeof raw.body === 'string' && raw.body.trim()) {
115
+ mutableExisting.body = raw.body;
116
+ }
117
+ if (!mutableExisting.title && typeof raw.title === 'string' && raw.title.trim()) {
118
+ mutableExisting.title = raw.title;
119
+ }
120
+ }
121
+ }
122
+ catch { /* ignore hydration errors */ }
123
+ }
124
+ if (!e.id || !e.title || !e.body)
125
+ return fail('missing required fields');
126
+ const dir = (0, indexContext_1.getInstructionsDir)();
127
+ if (!fs_1.default.existsSync(dir))
128
+ fs_1.default.mkdirSync(dir, { recursive: true });
129
+ const file = path_1.default.join(dir, `${e.id}.json`);
130
+ const existsInStore = (0, indexContext_1.ensureLoaded)().byId.has(e.id);
131
+ const existsOnDisk = !existsInStore && fs_1.default.existsSync(file);
132
+ const exists = existsInStore || existsOnDisk;
133
+ const existedBeforeOriginal = exists;
134
+ const overwrite = !!p.overwrite;
135
+ if (exists && !overwrite) {
136
+ let st0 = (0, indexContext_1.ensureLoaded)();
137
+ let visible = st0.byId.has(e.id);
138
+ let repaired = false;
139
+ if (!visible) {
140
+ try {
141
+ (0, indexContext_1.invalidate)();
142
+ st0 = (0, indexContext_1.ensureLoaded)();
143
+ visible = st0.byId.has(e.id);
144
+ if (visible)
145
+ repaired = true;
146
+ }
147
+ catch { /* ignore reload */ }
148
+ }
149
+ (0, auditLog_1.logAudit)('add', e.id, { skipped: true, late_visible: visible, repaired });
150
+ if ((0, instructions_shared_1.traceVisibility)()) {
151
+ (0, tracing_1.emitTrace)('[trace:add:skip]', { id: e.id, visible, repaired });
152
+ }
153
+ if ((0, instructions_shared_1.traceVisibility)()) {
154
+ (0, instructions_shared_1.traceInstructionVisibility)(e.id, 'add-skip-pre-return', { visible, repaired });
155
+ if (!visible)
156
+ (0, instructions_shared_1.traceEnvSnapshot)('add-skip-anomalous', { repaired });
157
+ }
158
+ if (!visible) {
159
+ return { id: e.id, skipped: true, created: false, overwritten: false, hash: st0.hash, visibilityWarning: 'skipped_file_not_in_index' };
160
+ }
161
+ return { id: e.id, skipped: true, created: false, overwritten: false, hash: st0.hash, repaired: repaired ? true : undefined };
162
+ }
163
+ const now = new Date().toISOString();
164
+ const rawBody = typeof e.body === 'string' ? e.body : String(e.body || '');
165
+ const bodyTrimmed = rawBody.trim();
166
+ const { bodyWarnLength } = (0, runtimeConfig_1.getRuntimeConfig)().index;
167
+ if (bodyTrimmed.length > bodyWarnLength) {
168
+ return {
169
+ ...fail('body_too_large', { id: e.id }),
170
+ bodyLength: bodyTrimmed.length,
171
+ maxLength: bodyWarnLength,
172
+ guidance: `Body exceeds the ${bodyWarnLength}-character limit (${bodyTrimmed.length} chars). Please split into multiple cross-linked instructions, refine/compress content, or categorize sections as separate entries. Use categories and cross-references (e.g., "See also: <sibling-id>") to maintain discoverability.`
173
+ };
174
+ }
175
+ let categories = Array.from(new Set((Array.isArray(e.categories) ? e.categories : []).filter((c) => typeof c === 'string' && c.trim().length > 0).map(c => c.toLowerCase()))).sort();
176
+ if (!categories.length) {
177
+ const allowAuto = lax || !instructionsCfg.requireCategory;
178
+ if (allowAuto) {
179
+ categories = ['uncategorized'];
180
+ if ((0, instructions_shared_1.traceVisibility)())
181
+ (0, tracing_1.emitTrace)('[trace:add:auto-category]', { id: e.id });
182
+ (0, features_1.incrementCounter)('instructions:autoCategory');
183
+ }
184
+ else {
185
+ return fail('category_required', { id: e.id });
186
+ }
187
+ }
188
+ const suppliedPrimary = e.primaryCategory;
189
+ const primaryCategory = (suppliedPrimary && categories.includes(suppliedPrimary.toLowerCase())) ? suppliedPrimary.toLowerCase() : categories[0];
190
+ const sourceHash = instructionsCfg.canonicalDisable
191
+ ? crypto_1.default.createHash('sha256').update(bodyTrimmed, 'utf8').digest('hex')
192
+ : (0, canonical_1.hashBody)(rawBody);
193
+ if (e.priorityTier === 'P1' && (!categories.length || !e.owner))
194
+ return fail('P1 requires category & owner', { id: e.id });
195
+ if ((e.requirement === 'mandatory' || e.requirement === 'critical') && !e.owner)
196
+ return fail('mandatory/critical require owner', { id: e.id });
197
+ const classifier = new classificationService_1.ClassificationService();
198
+ let base;
199
+ if (exists) {
200
+ try {
201
+ let existing;
202
+ // Try store first (covers SQLite), fall back to disk (JSON backend)
203
+ const stMerge = (0, indexContext_1.ensureLoaded)();
204
+ const memEntry = stMerge.byId.get(e.id);
205
+ if (memEntry) {
206
+ existing = { ...memEntry };
207
+ }
208
+ else if (existsOnDisk) {
209
+ existing = JSON.parse(fs_1.default.readFileSync(file, 'utf8'));
210
+ }
211
+ else {
212
+ throw new Error('entry not found in store or on disk');
213
+ }
214
+ base = { ...existing };
215
+ const prevBody = existing.body;
216
+ const prevVersion = existing.version || '1.0.0';
217
+ if (e.title)
218
+ base.title = e.title;
219
+ if (e.body)
220
+ base.body = bodyTrimmed;
221
+ if (e.rationale !== undefined)
222
+ base.rationale = e.rationale;
223
+ if (typeof e.priority === 'number')
224
+ base.priority = e.priority;
225
+ if (e.audience)
226
+ base.audience = e.audience;
227
+ if (e.requirement)
228
+ base.requirement = e.requirement;
229
+ if (categories.length) {
230
+ base.categories = categories;
231
+ base.primaryCategory = primaryCategory;
232
+ }
233
+ base.updatedAt = now;
234
+ if (e.version !== undefined)
235
+ base.version = e.version;
236
+ if (e.changeLog !== undefined)
237
+ base.changeLog = e.changeLog;
238
+ const semverRegex = SEMVER_REGEX;
239
+ const parse = (v) => { const m = semverRegex.exec(v); if (!m)
240
+ return null; return { major: +m[1], minor: +m[2], patch: +m[3] }; };
241
+ const gt = (a, b) => { const pa = parse(a), pb = parse(b); if (!pa || !pb)
242
+ return false; if (pa.major !== pb.major)
243
+ return pa.major > pb.major; if (pa.minor !== pb.minor)
244
+ return pa.minor > pb.minor; return pa.patch > pb.patch; };
245
+ const bodyChanged = e.body ? (bodyTrimmed !== prevBody) : false;
246
+ const titleChanged = e.title !== undefined && e.title !== existing.title;
247
+ const eRec = e;
248
+ const mutableMetadataKeys = ['owner', 'status', 'priorityTier', 'classification', 'lastReviewedAt', 'nextReviewDue', 'semanticSummary', 'contentType', 'extensions'];
249
+ const metadataChanged = mutableMetadataKeys.some((key) => eRec[key] !== undefined && !metadataEquals(eRec[key], existing[key]));
250
+ const versionChanged = e.version !== undefined && e.version !== existing.version;
251
+ const categoriesChanged = categories.length > 0 && JSON.stringify(categories.sort()) !== JSON.stringify((existing.categories || []).sort());
252
+ const governanceMetaChanged = titleChanged || metadataChanged || versionChanged || categoriesChanged;
253
+ if (overwrite && !bodyChanged && !governanceMetaChanged) {
254
+ const stNoop = (0, indexContext_1.ensureLoaded)();
255
+ const respNoop = { id: e.id, created: false, overwritten: false, skipped: true, hash: stNoop.hash, verified: true };
256
+ if (instructionsCfg.strictCreate)
257
+ respNoop.strictVerified = true;
258
+ (0, auditLog_1.logAudit)('add', e.id, { created: false, overwritten: false, skipped: true, verified: true, noop: true });
259
+ if ((0, instructions_shared_1.traceVisibility)())
260
+ (0, tracing_1.emitTrace)('[trace:add:noop-overwrite]', { id: e.id, hash: stNoop.hash, reason: 'no body/governance delta' });
261
+ return respNoop;
262
+ }
263
+ let incomingVersion = e.version;
264
+ if (incomingVersion && !semverRegex.test(incomingVersion))
265
+ return fail('invalid_semver', { id: e.id });
266
+ if (bodyChanged) {
267
+ if (incomingVersion) {
268
+ if (!gt(incomingVersion, prevVersion))
269
+ return fail('version_not_bumped', { id: e.id });
270
+ }
271
+ else {
272
+ const pv = parse(prevVersion) || { major: 1, minor: 0, patch: 0 };
273
+ const autoVersion = `${pv.major}.${pv.minor}.${pv.patch + 1}`;
274
+ base.version = autoVersion;
275
+ incomingVersion = autoVersion;
276
+ }
277
+ }
278
+ else if (incomingVersion) {
279
+ if (!gt(incomingVersion, prevVersion))
280
+ return fail('version_not_bumped', { id: e.id });
281
+ }
282
+ else {
283
+ base.version = prevVersion;
284
+ incomingVersion = prevVersion;
285
+ }
286
+ if (!Array.isArray(base.changeLog) || !base.changeLog.length) {
287
+ base.changeLog = [{ version: prevVersion, changedAt: existing.createdAt || now, summary: 'initial import' }];
288
+ }
289
+ const finalVersion = base.version || incomingVersion || prevVersion;
290
+ const last = base.changeLog[base.changeLog.length - 1];
291
+ if (last.version !== finalVersion) {
292
+ const summary = bodyChanged ? (e.version ? 'body update' : 'auto bump (body change)') : 'metadata update';
293
+ base.changeLog.push({ version: finalVersion, changedAt: now, summary });
294
+ }
295
+ const repairChangeLog = (cl) => {
296
+ const out = [];
297
+ if (Array.isArray(cl)) {
298
+ for (const entry of cl) {
299
+ if (!entry || typeof entry !== 'object')
300
+ continue;
301
+ const { version: v, changedAt: ca, summary: sum } = entry;
302
+ if (typeof v === 'string' && v.trim() && typeof sum === 'string' && sum.trim()) {
303
+ const caIso = typeof ca === 'string' && /T/.test(ca) ? ca : now;
304
+ out.push({ version: v.trim(), changedAt: caIso, summary: sum.trim() });
305
+ }
306
+ }
307
+ }
308
+ if (!out.length) {
309
+ out.push({ version: prevVersion, changedAt: existing.createdAt || now, summary: 'initial import (repaired)' });
310
+ }
311
+ const lastVer = out[out.length - 1].version;
312
+ if (lastVer !== finalVersion) {
313
+ out.push({ version: finalVersion, changedAt: now, summary: bodyChanged ? 'body update (repaired)' : 'metadata update (repaired)' });
314
+ }
315
+ return out;
316
+ };
317
+ base.changeLog = repairChangeLog(base.changeLog);
318
+ }
319
+ catch {
320
+ base = { id: e.id, title: e.title, body: bodyTrimmed, rationale: e.rationale, priority: e.priority, audience: e.audience, requirement: e.requirement, categories, primaryCategory, sourceHash, schemaVersion: schemaVersion_1.SCHEMA_VERSION, deprecatedBy: e.deprecatedBy, createdAt: now, updatedAt: now, riskScore: e.riskScore, createdByAgent: instructionsCfg.agentId, sourceWorkspace: instructionsCfg.workspaceId, extensions: e.extensions };
321
+ base.version = '1.0.0';
322
+ base.changeLog = [{ version: '1.0.0', changedAt: now, summary: 'initial import' }];
323
+ }
324
+ }
325
+ else {
326
+ base = { id: e.id, title: e.title, body: bodyTrimmed, rationale: e.rationale, priority: e.priority, audience: e.audience, requirement: e.requirement, categories, primaryCategory, sourceHash, schemaVersion: schemaVersion_1.SCHEMA_VERSION, deprecatedBy: e.deprecatedBy, createdAt: now, updatedAt: now, riskScore: e.riskScore, createdByAgent: instructionsCfg.agentId, sourceWorkspace: instructionsCfg.workspaceId, extensions: e.extensions };
327
+ if (e.version !== undefined) {
328
+ if (!SEMVER_REGEX.test(e.version))
329
+ return fail('invalid_semver', { id: e.id });
330
+ base.version = e.version;
331
+ }
332
+ else {
333
+ base.version = '1.0.0';
334
+ }
335
+ if (!Array.isArray(base.changeLog) || !base.changeLog.length) {
336
+ base.changeLog = [{ version: base.version, changedAt: now, summary: 'initial import' }];
337
+ }
338
+ if (Array.isArray(base.changeLog)) {
339
+ const repaired = [];
340
+ for (const entry of base.changeLog) {
341
+ if (!entry || typeof entry !== 'object')
342
+ continue;
343
+ const { version: v, changedAt: ca, summary: sum } = entry;
344
+ if (typeof v === 'string' && v.trim() && typeof sum === 'string' && sum.trim()) {
345
+ const caIso = typeof ca === 'string' && /T/.test(ca) ? ca : now;
346
+ repaired.push({ version: v.trim(), changedAt: caIso, summary: sum.trim() });
347
+ }
348
+ }
349
+ if (!repaired.length) {
350
+ repaired.push({ version: base.version, changedAt: now, summary: 'initial import (repaired)' });
351
+ }
352
+ if (repaired[repaired.length - 1].version !== base.version) {
353
+ repaired.push({ version: base.version, changedAt: now, summary: 'initial import (normalized)' });
354
+ }
355
+ base.changeLog = repaired;
356
+ }
357
+ }
358
+ const govKeys = ['version', 'owner', 'status', 'priorityTier', 'classification', 'lastReviewedAt', 'nextReviewDue', 'semanticSummary', 'contentType', 'extensions'];
359
+ for (const k of govKeys) {
360
+ const v = e[k];
361
+ if (v !== undefined) {
362
+ base[k] = v;
363
+ }
364
+ }
365
+ if (!base.sourceWorkspace)
366
+ base.sourceWorkspace = instructionsCfg.workspaceId;
367
+ if (!exists || base.body === bodyTrimmed) {
368
+ base.sourceHash = sourceHash;
369
+ }
370
+ else {
371
+ base.sourceHash = instructionsCfg.canonicalDisable
372
+ ? crypto_1.default.createHash('sha256').update(base.body, 'utf8').digest('hex')
373
+ : (0, canonical_1.hashBody)(base.body);
374
+ }
375
+ const record = classifier.normalize(base);
376
+ if (record.owner === 'unowned') {
377
+ const auto = (0, ownershipService_1.resolveOwner)(record.id);
378
+ if (auto) {
379
+ record.owner = auto;
380
+ record.updatedAt = new Date().toISOString();
381
+ }
382
+ }
383
+ try {
384
+ (0, indexContext_1.writeEntry)(record);
385
+ }
386
+ catch (err) {
387
+ return fail(err.message || 'write-failed', { id: e.id });
388
+ }
389
+ try {
390
+ (0, indexContext_1.touchIndexVersion)();
391
+ }
392
+ catch { /* ignore */ }
393
+ let stReloaded;
394
+ const strictMode = instructionsCfg.strictVisibility;
395
+ if (strictMode) {
396
+ try {
397
+ const current = (0, indexContext_1.ensureLoaded)();
398
+ stReloaded = current;
399
+ if (!current.byId.has(record.id)) {
400
+ current.byId.set(record.id, record);
401
+ current.list.push(record);
402
+ }
403
+ }
404
+ catch { /* fallback to reload path below if anything fails */ }
405
+ }
406
+ if (!stReloaded) {
407
+ try {
408
+ (0, indexContext_1.invalidate)();
409
+ }
410
+ catch { /* ignore */ }
411
+ stReloaded = (0, indexContext_1.ensureLoaded)();
412
+ }
413
+ const createdNow = !existedBeforeOriginal;
414
+ const overwrittenNow = overwrite && existedBeforeOriginal;
415
+ let strictVerified = false;
416
+ const verifyIssues = [];
417
+ try {
418
+ let parsed;
419
+ // Verify from in-memory store first (covers SQLite), fall back to disk (JSON backend)
420
+ parsed = stReloaded.byId.get(e.id) ?? undefined;
421
+ if (!parsed) {
422
+ if (fs_1.default.existsSync(file)) {
423
+ let diskRaw;
424
+ try {
425
+ diskRaw = fs_1.default.readFileSync(file, 'utf8');
426
+ }
427
+ catch (ex) {
428
+ verifyIssues.push('read-failed:' + ex.message);
429
+ }
430
+ if (diskRaw) {
431
+ try {
432
+ parsed = JSON.parse(diskRaw);
433
+ }
434
+ catch (ex) {
435
+ verifyIssues.push('parse-failed:' + ex.message);
436
+ }
437
+ }
438
+ }
439
+ }
440
+ if (parsed) {
441
+ if (parsed.id !== e.id)
442
+ verifyIssues.push('id-mismatch');
443
+ if (!parsed.title)
444
+ verifyIssues.push('missing-title');
445
+ if (!parsed.body)
446
+ verifyIssues.push('missing-body');
447
+ const wantCats = Array.isArray(e.categories) ? e.categories.filter((c) => typeof c === 'string').map(c => c.toLowerCase()) : [];
448
+ if (wantCats.length) {
449
+ for (const c of wantCats) {
450
+ if (!parsed.categories?.includes(c)) {
451
+ verifyIssues.push('missing-category:' + c);
452
+ }
453
+ }
454
+ }
455
+ }
456
+ const mem = stReloaded.byId.get(e.id);
457
+ if (!mem) {
458
+ verifyIssues.push('not-in-index');
459
+ }
460
+ const wantCats2 = Array.isArray(e.categories) ? e.categories.filter((c) => typeof c === 'string').map(c => c.toLowerCase()) : [];
461
+ if (wantCats2.length) {
462
+ const catHit = stReloaded.list.some(rec => rec.id === e.id && wantCats2.every(c => rec.categories.includes(c)));
463
+ if (!catHit)
464
+ verifyIssues.push('category-query-miss');
465
+ }
466
+ try {
467
+ if (parsed) {
468
+ const classifier2 = new classificationService_1.ClassificationService();
469
+ const issues = classifier2.validate(parsed);
470
+ if (issues.length) {
471
+ verifyIssues.push('classification-issues:' + issues.join(','));
472
+ }
473
+ }
474
+ }
475
+ catch (err) {
476
+ verifyIssues.push('classification-exception:' + err.message);
477
+ }
478
+ if (verifyIssues.includes('not-in-index')) {
479
+ try {
480
+ (0, indexContext_1.invalidate)();
481
+ const st2 = (0, indexContext_1.ensureLoaded)();
482
+ if (st2.byId.has(e.id)) {
483
+ const idx = verifyIssues.indexOf('not-in-index');
484
+ if (idx >= 0)
485
+ verifyIssues.splice(idx, 1);
486
+ }
487
+ }
488
+ catch { /* ignore */ }
489
+ }
490
+ if (!verifyIssues.length)
491
+ strictVerified = true;
492
+ }
493
+ catch (err) {
494
+ verifyIssues.push('verify-exception:' + err.message);
495
+ }
496
+ try {
497
+ if (instructionsCfg.manifest.writeEnabled)
498
+ (0, manifestManager_1.writeManifestFromIndex)();
499
+ else
500
+ setImmediate(() => { try {
501
+ (0, manifestManager_1.attemptManifestUpdate)();
502
+ }
503
+ catch { /* ignore */ } });
504
+ }
505
+ catch { /* ignore manifest */ }
506
+ (0, auditLog_1.logAudit)('add', e.id, { created: createdNow, overwritten: overwrittenNow, verified: true, forcedReload: true });
507
+ if ((0, instructions_shared_1.traceVisibility)())
508
+ (0, tracing_1.emitTrace)('[trace:add:forced-reload]', { id: e.id, created: createdNow, overwritten: overwrittenNow, hash: stReloaded.hash, strictVerified, issues: verifyIssues.slice(0, 5), strictMode });
509
+ return { id: e.id, created: createdNow, overwritten: overwrittenNow, skipped: false, hash: stReloaded.hash, verified: true, strictVerified, verifyIssues: verifyIssues.length ? verifyIssues : undefined, strictMode, bodyLength: bodyTrimmed.length };
510
+ }));
@@ -0,0 +1 @@
1
+ export {};