@askdkc/kiokuko 0.1.17 → 0.1.20

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 (539) hide show
  1. package/README.ja.md +91 -112
  2. package/README.ko.md +90 -102
  3. package/README.md +103 -262
  4. package/README.zh-CN.md +88 -102
  5. package/dist/agent-file/atomic-write.d.ts +90 -3
  6. package/dist/agent-file/atomic-write.d.ts.map +1 -1
  7. package/dist/agent-file/atomic-write.js +990 -14
  8. package/dist/agent-file/atomic-write.js.map +1 -1
  9. package/dist/agent-file/managed-block.d.ts +12 -1
  10. package/dist/agent-file/managed-block.d.ts.map +1 -1
  11. package/dist/agent-file/managed-block.js +49 -4
  12. package/dist/agent-file/managed-block.js.map +1 -1
  13. package/dist/agent-file/render.d.ts +1 -1
  14. package/dist/agent-file/render.d.ts.map +1 -1
  15. package/dist/agent-file/render.js +10 -7
  16. package/dist/agent-file/render.js.map +1 -1
  17. package/dist/akinator/agent-task.d.ts +11 -22
  18. package/dist/akinator/agent-task.d.ts.map +1 -1
  19. package/dist/akinator/agent-task.js +454 -99
  20. package/dist/akinator/agent-task.js.map +1 -1
  21. package/dist/akinator/capabilities.d.ts +18 -6
  22. package/dist/akinator/capabilities.d.ts.map +1 -1
  23. package/dist/akinator/capabilities.js +72 -35
  24. package/dist/akinator/capabilities.js.map +1 -1
  25. package/dist/akinator/capability-binding.d.ts +11 -0
  26. package/dist/akinator/capability-binding.d.ts.map +1 -0
  27. package/dist/akinator/capability-binding.js +56 -0
  28. package/dist/akinator/capability-binding.js.map +1 -0
  29. package/dist/akinator/domain.js +2 -2
  30. package/dist/akinator/domain.js.map +1 -1
  31. package/dist/akinator/knowledge-path.d.ts.map +1 -1
  32. package/dist/akinator/knowledge-path.js +409 -39
  33. package/dist/akinator/knowledge-path.js.map +1 -1
  34. package/dist/akinator/orchestrator.d.ts +3 -4
  35. package/dist/akinator/orchestrator.d.ts.map +1 -1
  36. package/dist/akinator/orchestrator.js +1 -4
  37. package/dist/akinator/orchestrator.js.map +1 -1
  38. package/dist/akinator/service.d.ts +0 -4
  39. package/dist/akinator/service.d.ts.map +1 -1
  40. package/dist/akinator/service.js +19 -35
  41. package/dist/akinator/service.js.map +1 -1
  42. package/dist/akinator/skill-discovery-attempt.d.ts +20 -0
  43. package/dist/akinator/skill-discovery-attempt.d.ts.map +1 -0
  44. package/dist/akinator/skill-discovery-attempt.js +390 -0
  45. package/dist/akinator/skill-discovery-attempt.js.map +1 -0
  46. package/dist/akinator/store.d.ts.map +1 -1
  47. package/dist/akinator/store.js +107 -52
  48. package/dist/akinator/store.js.map +1 -1
  49. package/dist/akinator/types.d.ts +0 -12
  50. package/dist/akinator/types.d.ts.map +1 -1
  51. package/dist/cli.d.ts +2 -0
  52. package/dist/cli.d.ts.map +1 -1
  53. package/dist/cli.js +560 -150
  54. package/dist/cli.js.map +1 -1
  55. package/dist/client/server-client.d.ts +5 -3
  56. package/dist/client/server-client.d.ts.map +1 -1
  57. package/dist/client/server-client.js +486 -181
  58. package/dist/client/server-client.js.map +1 -1
  59. package/dist/commands/agent.d.ts +2 -0
  60. package/dist/commands/agent.d.ts.map +1 -1
  61. package/dist/commands/agent.js +861 -86
  62. package/dist/commands/agent.js.map +1 -1
  63. package/dist/commands/backup.d.ts +2 -1
  64. package/dist/commands/backup.d.ts.map +1 -1
  65. package/dist/commands/backup.js +71 -8
  66. package/dist/commands/backup.js.map +1 -1
  67. package/dist/commands/doctor.d.ts +5 -1
  68. package/dist/commands/doctor.d.ts.map +1 -1
  69. package/dist/commands/doctor.js +70 -26
  70. package/dist/commands/doctor.js.map +1 -1
  71. package/dist/commands/export.d.ts +0 -4
  72. package/dist/commands/export.d.ts.map +1 -1
  73. package/dist/commands/export.js +191 -32
  74. package/dist/commands/export.js.map +1 -1
  75. package/dist/commands/import.d.ts +10 -1
  76. package/dist/commands/import.d.ts.map +1 -1
  77. package/dist/commands/import.js +592 -113
  78. package/dist/commands/import.js.map +1 -1
  79. package/dist/commands/init.d.ts +19 -1
  80. package/dist/commands/init.d.ts.map +1 -1
  81. package/dist/commands/init.js +569 -22
  82. package/dist/commands/init.js.map +1 -1
  83. package/dist/commands/purge.d.ts.map +1 -1
  84. package/dist/commands/purge.js +3 -0
  85. package/dist/commands/purge.js.map +1 -1
  86. package/dist/commands/setup.d.ts +37 -8
  87. package/dist/commands/setup.d.ts.map +1 -1
  88. package/dist/commands/setup.js +448 -86
  89. package/dist/commands/setup.js.map +1 -1
  90. package/dist/commands/skills.d.ts +9 -0
  91. package/dist/commands/skills.d.ts.map +1 -0
  92. package/dist/commands/skills.js +317 -0
  93. package/dist/commands/skills.js.map +1 -0
  94. package/dist/commands/use.d.ts +10 -2
  95. package/dist/commands/use.d.ts.map +1 -1
  96. package/dist/commands/use.js +851 -73
  97. package/dist/commands/use.js.map +1 -1
  98. package/dist/config/paths.d.ts +11 -1
  99. package/dist/config/paths.d.ts.map +1 -1
  100. package/dist/config/paths.js +64 -29
  101. package/dist/config/paths.js.map +1 -1
  102. package/dist/config/project-config.d.ts +1 -0
  103. package/dist/config/project-config.d.ts.map +1 -1
  104. package/dist/config/project-config.js +70 -32
  105. package/dist/config/project-config.js.map +1 -1
  106. package/dist/context/broker.d.ts +28 -14
  107. package/dist/context/broker.d.ts.map +1 -1
  108. package/dist/context/broker.js +604 -145
  109. package/dist/context/broker.js.map +1 -1
  110. package/dist/context/delivery.d.ts +6 -21
  111. package/dist/context/delivery.d.ts.map +1 -1
  112. package/dist/context/delivery.js +196 -147
  113. package/dist/context/delivery.js.map +1 -1
  114. package/dist/context/feedback.d.ts +11 -12
  115. package/dist/context/feedback.d.ts.map +1 -1
  116. package/dist/context/feedback.js +229 -261
  117. package/dist/context/feedback.js.map +1 -1
  118. package/dist/context/ranking.d.ts +1 -12
  119. package/dist/context/ranking.d.ts.map +1 -1
  120. package/dist/context/ranking.js +13 -4
  121. package/dist/context/ranking.js.map +1 -1
  122. package/dist/context/recommendations.d.ts +0 -5
  123. package/dist/context/recommendations.d.ts.map +1 -1
  124. package/dist/context/recommendations.js +0 -1
  125. package/dist/context/recommendations.js.map +1 -1
  126. package/dist/context/run-state.d.ts +26 -0
  127. package/dist/context/run-state.d.ts.map +1 -0
  128. package/dist/context/run-state.js +399 -0
  129. package/dist/context/run-state.js.map +1 -0
  130. package/dist/context/scoped-broker.d.ts +17 -5
  131. package/dist/context/scoped-broker.d.ts.map +1 -1
  132. package/dist/context/scoped-broker.js +512 -106
  133. package/dist/context/scoped-broker.js.map +1 -1
  134. package/dist/context/selection-state.d.ts +19 -0
  135. package/dist/context/selection-state.d.ts.map +1 -0
  136. package/dist/context/selection-state.js +250 -0
  137. package/dist/context/selection-state.js.map +1 -0
  138. package/dist/db/adapter.d.ts +5 -3
  139. package/dist/db/adapter.d.ts.map +1 -1
  140. package/dist/db/adapter.js +7 -3
  141. package/dist/db/adapter.js.map +1 -1
  142. package/dist/db/capabilities.d.ts.map +1 -1
  143. package/dist/db/capabilities.js +34 -16
  144. package/dist/db/capabilities.js.map +1 -1
  145. package/dist/db/connection.d.ts +8 -0
  146. package/dist/db/connection.d.ts.map +1 -1
  147. package/dist/db/connection.js +55 -26
  148. package/dist/db/connection.js.map +1 -1
  149. package/dist/db/migrate.d.ts +28 -7
  150. package/dist/db/migrate.d.ts.map +1 -1
  151. package/dist/db/migrate.js +106 -78
  152. package/dist/db/migrate.js.map +1 -1
  153. package/dist/db/sqlite-retry.d.ts +11 -0
  154. package/dist/db/sqlite-retry.d.ts.map +1 -0
  155. package/dist/db/sqlite-retry.js +66 -0
  156. package/dist/db/sqlite-retry.js.map +1 -0
  157. package/dist/db/transaction.d.ts +13 -0
  158. package/dist/db/transaction.d.ts.map +1 -1
  159. package/dist/db/transaction.js +53 -24
  160. package/dist/db/transaction.js.map +1 -1
  161. package/dist/db/upgrade-backup.d.ts +58 -2
  162. package/dist/db/upgrade-backup.d.ts.map +1 -1
  163. package/dist/db/upgrade-backup.js +758 -28
  164. package/dist/db/upgrade-backup.js.map +1 -1
  165. package/dist/errors.d.ts +4 -0
  166. package/dist/errors.d.ts.map +1 -1
  167. package/dist/errors.js +29 -1
  168. package/dist/errors.js.map +1 -1
  169. package/dist/gateway/agent-service.d.ts +4 -1
  170. package/dist/gateway/agent-service.d.ts.map +1 -1
  171. package/dist/gateway/agent-service.js +71 -58
  172. package/dist/gateway/agent-service.js.map +1 -1
  173. package/dist/gateway/checkpoint-service.d.ts +1 -0
  174. package/dist/gateway/checkpoint-service.d.ts.map +1 -1
  175. package/dist/gateway/checkpoint-service.js +47 -24
  176. package/dist/gateway/checkpoint-service.js.map +1 -1
  177. package/dist/ledger/archive.d.ts +1 -4
  178. package/dist/ledger/archive.d.ts.map +1 -1
  179. package/dist/ledger/archive.js +77 -39
  180. package/dist/ledger/archive.js.map +1 -1
  181. package/dist/ledger/maintenance.d.ts +0 -11
  182. package/dist/ledger/maintenance.d.ts.map +1 -1
  183. package/dist/ledger/maintenance.js +24 -40
  184. package/dist/ledger/maintenance.js.map +1 -1
  185. package/dist/ledger/projection.d.ts +0 -1
  186. package/dist/ledger/projection.d.ts.map +1 -1
  187. package/dist/ledger/projection.js.map +1 -1
  188. package/dist/ledger/promotion.d.ts +0 -9
  189. package/dist/ledger/promotion.d.ts.map +1 -1
  190. package/dist/ledger/promotion.js.map +1 -1
  191. package/dist/ledger/query.d.ts +1 -15
  192. package/dist/ledger/query.d.ts.map +1 -1
  193. package/dist/ledger/query.js.map +1 -1
  194. package/dist/ledger/store.d.ts +0 -1
  195. package/dist/ledger/store.d.ts.map +1 -1
  196. package/dist/ledger/store.js +11 -8
  197. package/dist/ledger/store.js.map +1 -1
  198. package/dist/ledger/types.d.ts +0 -4
  199. package/dist/ledger/types.d.ts.map +1 -1
  200. package/dist/ledger/types.js.map +1 -1
  201. package/dist/ledger/validate.d.ts.map +1 -1
  202. package/dist/ledger/validate.js +0 -5
  203. package/dist/ledger/validate.js.map +1 -1
  204. package/dist/mcp/server.d.ts +4 -0
  205. package/dist/mcp/server.d.ts.map +1 -1
  206. package/dist/mcp/server.js +105 -54
  207. package/dist/mcp/server.js.map +1 -1
  208. package/dist/memory/audit.d.ts +0 -1
  209. package/dist/memory/audit.d.ts.map +1 -1
  210. package/dist/memory/audit.js +0 -1
  211. package/dist/memory/audit.js.map +1 -1
  212. package/dist/memory/curator.d.ts.map +1 -1
  213. package/dist/memory/curator.js +172 -96
  214. package/dist/memory/curator.js.map +1 -1
  215. package/dist/memory/entries.d.ts +12 -2
  216. package/dist/memory/entries.d.ts.map +1 -1
  217. package/dist/memory/entries.js +199 -115
  218. package/dist/memory/entries.js.map +1 -1
  219. package/dist/memory/federated-retrieval.d.ts +12 -1
  220. package/dist/memory/federated-retrieval.d.ts.map +1 -1
  221. package/dist/memory/federated-retrieval.js +183 -70
  222. package/dist/memory/federated-retrieval.js.map +1 -1
  223. package/dist/memory/hybrid-retrieval.d.ts +5 -11
  224. package/dist/memory/hybrid-retrieval.d.ts.map +1 -1
  225. package/dist/memory/hybrid-retrieval.js +78 -58
  226. package/dist/memory/hybrid-retrieval.js.map +1 -1
  227. package/dist/memory/lifecycle.d.ts.map +1 -1
  228. package/dist/memory/lifecycle.js +17 -13
  229. package/dist/memory/lifecycle.js.map +1 -1
  230. package/dist/memory/rebuild-search.d.ts +5 -0
  231. package/dist/memory/rebuild-search.d.ts.map +1 -1
  232. package/dist/memory/rebuild-search.js +101 -76
  233. package/dist/memory/rebuild-search.js.map +1 -1
  234. package/dist/memory/retrieval-query.d.ts +0 -5
  235. package/dist/memory/retrieval-query.d.ts.map +1 -1
  236. package/dist/memory/retrieval-query.js +0 -5
  237. package/dist/memory/retrieval-query.js.map +1 -1
  238. package/dist/memory/retrieval.d.ts.map +1 -1
  239. package/dist/memory/retrieval.js +25 -131
  240. package/dist/memory/retrieval.js.map +1 -1
  241. package/dist/memory/revisions.d.ts +76 -1
  242. package/dist/memory/revisions.d.ts.map +1 -1
  243. package/dist/memory/revisions.js +540 -36
  244. package/dist/memory/revisions.js.map +1 -1
  245. package/dist/memory/scoped-memory.d.ts +16 -1
  246. package/dist/memory/scoped-memory.d.ts.map +1 -1
  247. package/dist/memory/scoped-memory.js +240 -107
  248. package/dist/memory/scoped-memory.js.map +1 -1
  249. package/dist/memory/secrets.d.ts +2 -0
  250. package/dist/memory/secrets.d.ts.map +1 -1
  251. package/dist/memory/secrets.js +36 -0
  252. package/dist/memory/secrets.js.map +1 -1
  253. package/dist/memory/structured-memory.d.ts +3 -2
  254. package/dist/memory/structured-memory.d.ts.map +1 -1
  255. package/dist/memory/structured-memory.js +54 -22
  256. package/dist/memory/structured-memory.js.map +1 -1
  257. package/dist/memory/workspaces.d.ts +9 -0
  258. package/dist/memory/workspaces.d.ts.map +1 -1
  259. package/dist/memory/workspaces.js +67 -0
  260. package/dist/memory/workspaces.js.map +1 -1
  261. package/dist/package-version.d.ts +2 -0
  262. package/dist/package-version.d.ts.map +1 -0
  263. package/dist/package-version.js +7 -0
  264. package/dist/package-version.js.map +1 -0
  265. package/dist/repository/binding.d.ts +5 -0
  266. package/dist/repository/binding.d.ts.map +1 -1
  267. package/dist/repository/binding.js +117 -17
  268. package/dist/repository/binding.js.map +1 -1
  269. package/dist/repository/framework-version.d.ts +8 -0
  270. package/dist/repository/framework-version.d.ts.map +1 -0
  271. package/dist/repository/framework-version.js +29 -0
  272. package/dist/repository/framework-version.js.map +1 -0
  273. package/dist/repository/identity-value.d.ts +4 -0
  274. package/dist/repository/identity-value.d.ts.map +1 -0
  275. package/dist/repository/identity-value.js +24 -0
  276. package/dist/repository/identity-value.js.map +1 -0
  277. package/dist/repository/identity.d.ts.map +1 -1
  278. package/dist/repository/identity.js +2 -0
  279. package/dist/repository/identity.js.map +1 -1
  280. package/dist/repository/project-fingerprint.d.ts +14 -2
  281. package/dist/repository/project-fingerprint.d.ts.map +1 -1
  282. package/dist/repository/project-fingerprint.js +312 -33
  283. package/dist/repository/project-fingerprint.js.map +1 -1
  284. package/dist/repository/remote-url.d.ts +0 -1
  285. package/dist/repository/remote-url.d.ts.map +1 -1
  286. package/dist/repository/remote-url.js +0 -1
  287. package/dist/repository/remote-url.js.map +1 -1
  288. package/dist/runtime-version.d.ts +2 -1
  289. package/dist/runtime-version.d.ts.map +1 -1
  290. package/dist/runtime-version.js +21 -4
  291. package/dist/runtime-version.js.map +1 -1
  292. package/dist/serialization/boundary-json.d.ts +20 -0
  293. package/dist/serialization/boundary-json.d.ts.map +1 -0
  294. package/dist/serialization/boundary-json.js +129 -0
  295. package/dist/serialization/boundary-json.js.map +1 -0
  296. package/dist/serialization/envelope.js +1 -1
  297. package/dist/serialization/envelope.js.map +1 -1
  298. package/dist/serialization/validate.d.ts +7 -0
  299. package/dist/serialization/validate.d.ts.map +1 -1
  300. package/dist/serialization/validate.js +53 -13
  301. package/dist/serialization/validate.js.map +1 -1
  302. package/dist/server/app.js +1 -1
  303. package/dist/server/app.js.map +1 -1
  304. package/dist/server/http.d.ts +4 -3
  305. package/dist/server/http.d.ts.map +1 -1
  306. package/dist/server/http.js +90 -50
  307. package/dist/server/http.js.map +1 -1
  308. package/dist/server/idempotency.d.ts +0 -6
  309. package/dist/server/idempotency.d.ts.map +1 -1
  310. package/dist/server/idempotency.js.map +1 -1
  311. package/dist/server/router.d.ts.map +1 -1
  312. package/dist/server/router.js +21 -4
  313. package/dist/server/router.js.map +1 -1
  314. package/dist/server/routes/agent-capability-gate.d.ts +40 -0
  315. package/dist/server/routes/agent-capability-gate.d.ts.map +1 -0
  316. package/dist/server/routes/agent-capability-gate.js +182 -0
  317. package/dist/server/routes/agent-capability-gate.js.map +1 -0
  318. package/dist/server/routes/agent-events.d.ts.map +1 -1
  319. package/dist/server/routes/agent-events.js +8 -1
  320. package/dist/server/routes/agent-events.js.map +1 -1
  321. package/dist/server/routes/agent-intake.d.ts.map +1 -1
  322. package/dist/server/routes/agent-intake.js +10 -2
  323. package/dist/server/routes/agent-intake.js.map +1 -1
  324. package/dist/server/routes/agent-promotions.d.ts.map +1 -1
  325. package/dist/server/routes/agent-promotions.js +5 -2
  326. package/dist/server/routes/agent-promotions.js.map +1 -1
  327. package/dist/server/routes/agent-runs.d.ts.map +1 -1
  328. package/dist/server/routes/agent-runs.js +18 -4
  329. package/dist/server/routes/agent-runs.js.map +1 -1
  330. package/dist/server/routes/request-binding.d.ts +5 -0
  331. package/dist/server/routes/request-binding.d.ts.map +1 -0
  332. package/dist/server/routes/request-binding.js +49 -0
  333. package/dist/server/routes/request-binding.js.map +1 -0
  334. package/dist/server/routes/task5-support.d.ts +1 -8
  335. package/dist/server/routes/task5-support.d.ts.map +1 -1
  336. package/dist/server/routes/task5-support.js +1 -17
  337. package/dist/server/routes/task5-support.js.map +1 -1
  338. package/dist/server/routes/task5.d.ts.map +1 -1
  339. package/dist/server/routes/task5.js +106 -36
  340. package/dist/server/routes/task5.js.map +1 -1
  341. package/dist/server/write-queue.js +2 -2
  342. package/dist/server/write-queue.js.map +1 -1
  343. package/dist/setup/claude-config.d.ts +4 -1
  344. package/dist/setup/claude-config.d.ts.map +1 -1
  345. package/dist/setup/claude-config.js +62 -4
  346. package/dist/setup/claude-config.js.map +1 -1
  347. package/dist/setup/client-detection.d.ts +7 -2
  348. package/dist/setup/client-detection.d.ts.map +1 -1
  349. package/dist/setup/client-detection.js +27 -9
  350. package/dist/setup/client-detection.js.map +1 -1
  351. package/dist/setup/hermes-config.d.ts +4 -1
  352. package/dist/setup/hermes-config.d.ts.map +1 -1
  353. package/dist/setup/hermes-config.js +71 -17
  354. package/dist/setup/hermes-config.js.map +1 -1
  355. package/dist/setup/legacy-client-cleanup.d.ts +6 -0
  356. package/dist/setup/legacy-client-cleanup.d.ts.map +1 -0
  357. package/dist/setup/legacy-client-cleanup.js +152 -0
  358. package/dist/setup/legacy-client-cleanup.js.map +1 -0
  359. package/dist/setup/managed-text.d.ts.map +1 -1
  360. package/dist/setup/managed-text.js +11 -1
  361. package/dist/setup/managed-text.js.map +1 -1
  362. package/dist/setup/mcp-conflict.d.ts +4 -0
  363. package/dist/setup/mcp-conflict.d.ts.map +1 -0
  364. package/dist/setup/mcp-conflict.js +15 -0
  365. package/dist/setup/mcp-conflict.js.map +1 -0
  366. package/dist/setup/opencode-config.d.ts +4 -1
  367. package/dist/setup/opencode-config.d.ts.map +1 -1
  368. package/dist/setup/opencode-config.js +65 -5
  369. package/dist/setup/opencode-config.js.map +1 -1
  370. package/dist/setup/render.d.ts +4 -1
  371. package/dist/setup/render.d.ts.map +1 -1
  372. package/dist/setup/render.js +168 -18
  373. package/dist/setup/render.js.map +1 -1
  374. package/dist/setup/standard-skills.d.ts +16 -2
  375. package/dist/setup/standard-skills.d.ts.map +1 -1
  376. package/dist/setup/standard-skills.js +37 -13
  377. package/dist/setup/standard-skills.js.map +1 -1
  378. package/dist/setup/strict-json.d.ts +7 -0
  379. package/dist/setup/strict-json.d.ts.map +1 -0
  380. package/dist/setup/strict-json.js +98 -0
  381. package/dist/setup/strict-json.js.map +1 -0
  382. package/dist/setup/strict-toml.d.ts +18 -0
  383. package/dist/setup/strict-toml.d.ts.map +1 -0
  384. package/dist/setup/strict-toml.js +491 -0
  385. package/dist/setup/strict-toml.js.map +1 -0
  386. package/dist/skills/cache.d.ts +15 -0
  387. package/dist/skills/cache.d.ts.map +1 -0
  388. package/dist/skills/cache.js +19 -0
  389. package/dist/skills/cache.js.map +1 -0
  390. package/dist/skills/candidate-ranking.d.ts +15 -0
  391. package/dist/skills/candidate-ranking.d.ts.map +1 -0
  392. package/dist/skills/candidate-ranking.js +52 -0
  393. package/dist/skills/candidate-ranking.js.map +1 -0
  394. package/dist/skills/chunking.d.ts +11 -0
  395. package/dist/skills/chunking.d.ts.map +1 -0
  396. package/dist/skills/chunking.js +291 -0
  397. package/dist/skills/chunking.js.map +1 -0
  398. package/dist/skills/config.d.ts +19 -0
  399. package/dist/skills/config.d.ts.map +1 -0
  400. package/dist/skills/config.js +103 -0
  401. package/dist/skills/config.js.map +1 -0
  402. package/dist/skills/discovery-service.d.ts +26 -0
  403. package/dist/skills/discovery-service.d.ts.map +1 -0
  404. package/dist/skills/discovery-service.js +921 -0
  405. package/dist/skills/discovery-service.js.map +1 -0
  406. package/dist/skills/external-transport.d.ts +2 -0
  407. package/dist/skills/external-transport.d.ts.map +1 -0
  408. package/dist/skills/external-transport.js +30 -0
  409. package/dist/skills/external-transport.js.map +1 -0
  410. package/dist/skills/find.d.ts +16 -0
  411. package/dist/skills/find.d.ts.map +1 -0
  412. package/dist/skills/find.js +58 -0
  413. package/dist/skills/find.js.map +1 -0
  414. package/dist/skills/gap-detection.d.ts +23 -0
  415. package/dist/skills/gap-detection.d.ts.map +1 -0
  416. package/dist/skills/gap-detection.js +62 -0
  417. package/dist/skills/gap-detection.js.map +1 -0
  418. package/dist/skills/import-preparation.d.ts +4 -0
  419. package/dist/skills/import-preparation.d.ts.map +1 -0
  420. package/dist/skills/import-preparation.js +20 -0
  421. package/dist/skills/import-preparation.js.map +1 -0
  422. package/dist/skills/materialization-authority.d.ts +11 -0
  423. package/dist/skills/materialization-authority.d.ts.map +1 -0
  424. package/dist/skills/materialization-authority.js +92 -0
  425. package/dist/skills/materialization-authority.js.map +1 -0
  426. package/dist/skills/materialization-service.d.ts +22 -0
  427. package/dist/skills/materialization-service.d.ts.map +1 -0
  428. package/dist/skills/materialization-service.js +101 -0
  429. package/dist/skills/materialization-service.js.map +1 -0
  430. package/dist/skills/official-catalog.d.ts +31 -0
  431. package/dist/skills/official-catalog.d.ts.map +1 -0
  432. package/dist/skills/official-catalog.js +110 -0
  433. package/dist/skills/official-catalog.js.map +1 -0
  434. package/dist/skills/providers/schema.d.ts +30 -0
  435. package/dist/skills/providers/schema.d.ts.map +1 -0
  436. package/dist/skills/providers/schema.js +354 -0
  437. package/dist/skills/providers/schema.js.map +1 -0
  438. package/dist/skills/providers/skills-sh-compat.d.ts +17 -0
  439. package/dist/skills/providers/skills-sh-compat.d.ts.map +1 -0
  440. package/dist/skills/providers/skills-sh-compat.js +71 -0
  441. package/dist/skills/providers/skills-sh-compat.js.map +1 -0
  442. package/dist/skills/providers/skills-sh-v1.d.ts +23 -0
  443. package/dist/skills/providers/skills-sh-v1.d.ts.map +1 -0
  444. package/dist/skills/providers/skills-sh-v1.js +134 -0
  445. package/dist/skills/providers/skills-sh-v1.js.map +1 -0
  446. package/dist/skills/query-builder.d.ts +18 -0
  447. package/dist/skills/query-builder.d.ts.map +1 -0
  448. package/dist/skills/query-builder.js +93 -0
  449. package/dist/skills/query-builder.js.map +1 -0
  450. package/dist/skills/source/errors.d.ts +9 -0
  451. package/dist/skills/source/errors.d.ts.map +1 -0
  452. package/dist/skills/source/errors.js +15 -0
  453. package/dist/skills/source/errors.js.map +1 -0
  454. package/dist/skills/source/frontmatter.d.ts +9 -0
  455. package/dist/skills/source/frontmatter.d.ts.map +1 -0
  456. package/dist/skills/source/frontmatter.js +77 -0
  457. package/dist/skills/source/frontmatter.js.map +1 -0
  458. package/dist/skills/source/github-fetcher.d.ts +20 -0
  459. package/dist/skills/source/github-fetcher.d.ts.map +1 -0
  460. package/dist/skills/source/github-fetcher.js +292 -0
  461. package/dist/skills/source/github-fetcher.js.map +1 -0
  462. package/dist/skills/source/snapshot-validator.d.ts +28 -0
  463. package/dist/skills/source/snapshot-validator.d.ts.map +1 -0
  464. package/dist/skills/source/snapshot-validator.js +186 -0
  465. package/dist/skills/source/snapshot-validator.js.map +1 -0
  466. package/dist/skills/store.d.ts +181 -0
  467. package/dist/skills/store.d.ts.map +1 -0
  468. package/dist/skills/store.js +1710 -0
  469. package/dist/skills/store.js.map +1 -0
  470. package/dist/skills/types.d.ts +169 -0
  471. package/dist/skills/types.d.ts.map +1 -0
  472. package/dist/skills/types.js +2 -0
  473. package/dist/skills/types.js.map +1 -0
  474. package/dist/web/i18n.d.ts +32 -0
  475. package/dist/web/i18n.d.ts.map +1 -1
  476. package/dist/web/i18n.js +128 -0
  477. package/dist/web/i18n.js.map +1 -1
  478. package/dist/web/server.d.ts.map +1 -1
  479. package/dist/web/server.js +386 -38
  480. package/dist/web/server.js.map +1 -1
  481. package/dist/web/ui.d.ts +4 -0
  482. package/dist/web/ui.d.ts.map +1 -1
  483. package/dist/web/ui.js +382 -6
  484. package/dist/web/ui.js.map +1 -1
  485. package/migrations/009_external_skill_discovery.sql +126 -0
  486. package/package.json +6 -3
  487. package/skills/kiokuko-single-purpose-functions/SKILL.md +288 -0
  488. package/skills/kiokuko-single-purpose-functions/references/kiokuko-patterns.md +344 -0
  489. package/skills/kiokuko-single-purpose-functions/references/review-checklist.md +97 -0
  490. package/skills/kiokuko-ui-design-soul/SKILL.md +1186 -28
  491. package/templates/AGENTS.md +8 -7
  492. package/dist/client/runtime-discovery.d.ts +0 -15
  493. package/dist/client/runtime-discovery.d.ts.map +0 -1
  494. package/dist/client/runtime-discovery.js +0 -45
  495. package/dist/client/runtime-discovery.js.map +0 -1
  496. package/dist/commands/call.d.ts +0 -7
  497. package/dist/commands/call.d.ts.map +0 -1
  498. package/dist/commands/call.js +0 -10
  499. package/dist/commands/call.js.map +0 -1
  500. package/dist/commands/link.d.ts +0 -6
  501. package/dist/commands/link.d.ts.map +0 -1
  502. package/dist/commands/link.js +0 -6
  503. package/dist/commands/link.js.map +0 -1
  504. package/dist/commands/promote.d.ts +0 -6
  505. package/dist/commands/promote.d.ts.map +0 -1
  506. package/dist/commands/promote.js +0 -6
  507. package/dist/commands/promote.js.map +0 -1
  508. package/dist/commands/read.d.ts +0 -6
  509. package/dist/commands/read.d.ts.map +0 -1
  510. package/dist/commands/read.js +0 -4
  511. package/dist/commands/read.js.map +0 -1
  512. package/dist/commands/recall.d.ts +0 -6
  513. package/dist/commands/recall.d.ts.map +0 -1
  514. package/dist/commands/recall.js +0 -4
  515. package/dist/commands/recall.js.map +0 -1
  516. package/dist/commands/record.d.ts +0 -6
  517. package/dist/commands/record.d.ts.map +0 -1
  518. package/dist/commands/record.js +0 -4
  519. package/dist/commands/record.js.map +0 -1
  520. package/dist/commands/search.d.ts +0 -6
  521. package/dist/commands/search.d.ts.map +0 -1
  522. package/dist/commands/search.js +0 -4
  523. package/dist/commands/search.js.map +0 -1
  524. package/dist/commands/supersede.d.ts +0 -6
  525. package/dist/commands/supersede.d.ts.map +0 -1
  526. package/dist/commands/supersede.js +0 -6
  527. package/dist/commands/supersede.js.map +0 -1
  528. package/dist/knowledge/sources.d.ts +0 -72
  529. package/dist/knowledge/sources.d.ts.map +0 -1
  530. package/dist/knowledge/sources.js +0 -388
  531. package/dist/knowledge/sources.js.map +0 -1
  532. package/dist/setup/opencode-evidence.d.ts +0 -37
  533. package/dist/setup/opencode-evidence.d.ts.map +0 -1
  534. package/dist/setup/opencode-evidence.js +0 -58
  535. package/dist/setup/opencode-evidence.js.map +0 -1
  536. package/dist/setup/opencode-loop-guard.d.ts +0 -9
  537. package/dist/setup/opencode-loop-guard.d.ts.map +0 -1
  538. package/dist/setup/opencode-loop-guard.js +0 -248
  539. package/dist/setup/opencode-loop-guard.js.map +0 -1
@@ -2,7 +2,12 @@ import { constants } from 'node:fs';
2
2
  import { access, stat } from 'node:fs/promises';
3
3
  import path from 'node:path';
4
4
  export const DETECTABLE_CLIENTS = ['codex', 'opencode', 'claude', 'hermes'];
5
- async function hasExecutable(platform, pathModule, env, executableBaseName) {
5
+ function errorCode(error) {
6
+ return error instanceof Error && 'code' in error
7
+ ? String(error.code)
8
+ : undefined;
9
+ }
10
+ async function hasExecutable(platform, pathModule, env, executableBaseName, dependencies) {
6
11
  const pathValue = env.PATH;
7
12
  if (!pathValue)
8
13
  return false;
@@ -14,33 +19,46 @@ async function hasExecutable(platform, pathModule, env, executableBaseName) {
14
19
  for (const executableName of executableNames) {
15
20
  const executable = pathModule.join(directory, executableName);
16
21
  try {
17
- const info = await stat(executable);
22
+ const info = await dependencies.stat(executable);
18
23
  if (!info.isFile())
19
24
  continue;
20
- await access(executable, platform === 'win32' ? constants.F_OK : constants.X_OK);
25
+ }
26
+ catch (error) {
27
+ if (['ENOENT', 'ENOTDIR'].includes(errorCode(error) ?? ''))
28
+ continue;
29
+ throw error;
30
+ }
31
+ try {
32
+ await dependencies.access(executable, platform === 'win32' ? constants.F_OK : constants.X_OK);
21
33
  return true;
22
34
  }
23
- catch {
24
- // Continue checking the remaining PATH candidates.
35
+ catch (error) {
36
+ if (['EACCES', 'EPERM', 'ENOENT', 'ENOTDIR'].includes(errorCode(error) ?? ''))
37
+ continue;
38
+ throw error;
25
39
  }
26
40
  }
27
41
  }
28
42
  return false;
29
43
  }
30
44
  /** Detect supported client executables without mutating client state. */
31
- export async function detectInstalledClients(options = {}) {
45
+ export async function detectInstalledClients(options = {}, dependencyOverrides = {}) {
32
46
  const platform = options.platform ?? process.platform;
33
47
  const pathModule = platform === 'win32' ? path.win32 : path.posix;
34
48
  const env = options.env ?? process.env;
49
+ const dependencies = {
50
+ stat: dependencyOverrides.stat ?? stat,
51
+ access: dependencyOverrides.access ?? access,
52
+ };
35
53
  const installed = [];
36
54
  for (const client of DETECTABLE_CLIENTS) {
37
- if (await hasExecutable(platform, pathModule, env, client))
55
+ if (await hasExecutable(platform, pathModule, env, client, dependencies))
38
56
  installed.push(client);
39
57
  }
40
58
  return installed;
41
59
  }
42
60
  /** Detect an installed Hermes executable without mutating client state. */
43
- export async function isHermesAgentInstalled(options = {}) {
44
- return (await detectInstalledClients(options)).includes('hermes');
61
+ export async function isHermesAgentInstalled(options = {}, dependencyOverrides = {}) {
62
+ return (await detectInstalledClients(options, dependencyOverrides)).includes('hermes');
45
63
  }
46
64
  //# sourceMappingURL=client-detection.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"client-detection.js","sourceRoot":"","sources":["../../src/setup/client-detection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAGrF,KAAK,UAAU,aAAa,CAC1B,QAAyB,EACzB,UAA6B,EAC7B,GAAsB,EACtB,kBAA0B;IAE1B,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC;IAC3B,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,aAAa,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,MAAM,eAAe,GAAG,QAAQ,KAAK,OAAO;QAC1C,CAAC,CAAC,CAAC,GAAG,kBAAkB,MAAM,EAAE,GAAG,kBAAkB,MAAM,EAAE,GAAG,kBAAkB,MAAM,EAAE,kBAAkB,CAAC;QAC7G,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAEzB,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;oBAAE,SAAS;gBAC7B,MAAM,MAAM,CAAC,UAAU,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACjF,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,mDAAmD;YACrD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAA2B,EAAE;IACxE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,UAAU,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAClE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACxC,IAAI,MAAM,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAA2B,EAAE;IACxE,OAAO,CAAC,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC"}
1
+ {"version":3,"file":"client-detection.js","sourceRoot":"","sources":["../../src/setup/client-detection.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,7 @@
1
+ import type { SkillDiscoveryMode } from '../skills/types.js';
1
2
  import type { DelimitedBlockResult } from './managed-text.js';
2
3
  export declare const HERMES_MANAGED_MARKER = "Managed by `kiokuko setup`.";
3
- export declare function renderHermesConfig(existing: string | undefined, command?: string): DelimitedBlockResult;
4
+ export declare function renderHermesConfig(existing: string | undefined, command?: string, skillDiscoveryMode?: SkillDiscoveryMode, options?: {
5
+ replaceConflictingIdentity?: boolean;
6
+ }): DelimitedBlockResult;
4
7
  //# sourceMappingURL=hermes-config.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"hermes-config.d.ts","sourceRoot":"","sources":["../../src/setup/hermes-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AA6DnE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,SAAY,GAAG,oBAAoB,CAoC1G"}
1
+ {"version":3,"file":"hermes-config.d.ts","sourceRoot":"","sources":["../../src/setup/hermes-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AAiGnE,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,SAAY,EACnB,kBAAkB,CAAC,EAAE,kBAAkB,EACvC,OAAO,GAAE;IAAE,0BAA0B,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,oBAAoB,CA4DtB"}
@@ -1,5 +1,7 @@
1
1
  import { parseDocument, isMap, isNode, isPair, isScalar, isSeq } from 'yaml';
2
2
  import { KiokukoError } from '../errors.js';
3
+ import { isSkillDiscoveryMode, SKILL_DISCOVERY_ENV } from '../skills/config.js';
4
+ import { setupMcpIdentityConflict } from './mcp-conflict.js';
3
5
  export const HERMES_MANAGED_MARKER = 'Managed by `kiokuko setup`.';
4
6
  function scalarValue(value) {
5
7
  return isScalar(value) ? value.value : undefined;
@@ -8,21 +10,35 @@ function findKeyPair(map, key) {
8
10
  return map.items.find((item) => isPair(item) && scalarValue(item.key) === key);
9
11
  }
10
12
  function hasManagedMarker(pair) {
11
- return (isNode(pair.key) && pair.key.commentBefore?.includes(HERMES_MANAGED_MARKER) === true)
12
- || (isNode(pair.value) && pair.value.commentBefore?.includes(HERMES_MANAGED_MARKER) === true);
13
+ return isNode(pair.value) && pair.value.commentBefore?.trim() === HERMES_MANAGED_MARKER;
13
14
  }
14
15
  function hasCanonicalManagedShape(pair) {
15
16
  if (!isMap(pair.value))
16
17
  return false;
17
18
  const fields = pair.value.items.map((item) => isPair(item) ? scalarValue(item.key) : undefined);
18
- if (fields.length !== 2 || fields[0] === fields[1] || !fields.includes('command') || !fields.includes('args'))
19
+ if (fields.length !== 3
20
+ || new Set(fields).size !== fields.length
21
+ || !fields.includes('command')
22
+ || !fields.includes('args')
23
+ || fields.some((field) => field !== 'command' && field !== 'args' && field !== 'env'))
19
24
  return false;
20
25
  const commandNode = pair.value.get('command', true);
21
26
  const argsNode = pair.value.get('args', true);
22
- return typeof scalarValue(commandNode) === 'string'
23
- && isSeq(argsNode)
24
- && argsNode.items.length === 1
25
- && scalarValue(argsNode.items[0]) === 'mcp';
27
+ const command = scalarValue(commandNode);
28
+ if (typeof command !== 'string'
29
+ || command.trim().length === 0
30
+ || command.includes('\0')
31
+ || !isSeq(argsNode)
32
+ || argsNode.items.length !== 1
33
+ || scalarValue(argsNode.items[0]) !== 'mcp')
34
+ return false;
35
+ const envNode = pair.value.get('env', true);
36
+ if (!isMap(envNode) || envNode.items.length !== 1)
37
+ return false;
38
+ const environmentPair = envNode.items[0];
39
+ return isPair(environmentPair)
40
+ && scalarValue(environmentPair.key) === SKILL_DISCOVERY_ENV
41
+ && isSkillDiscoveryMode(scalarValue(environmentPair.value));
26
42
  }
27
43
  function currentManagedCommand(pair) {
28
44
  if (!hasCanonicalManagedShape(pair))
@@ -30,14 +46,35 @@ function currentManagedCommand(pair) {
30
46
  const command = scalarValue(pair.value.get('command', true));
31
47
  return typeof command === 'string' ? command : undefined;
32
48
  }
33
- function hasRequestedState(pair, command) {
34
- return currentManagedCommand(pair) === command;
49
+ function currentManagedSkillDiscoveryMode(pair) {
50
+ if (!hasCanonicalManagedShape(pair) || !isMap(pair.value))
51
+ return undefined;
52
+ const environment = pair.value.get('env', true);
53
+ if (!isMap(environment))
54
+ return undefined;
55
+ const mode = scalarValue(environment.get(SKILL_DISCOVERY_ENV, true));
56
+ return isSkillDiscoveryMode(mode) ? mode : undefined;
57
+ }
58
+ function hasRequestedState(pair, command, skillDiscoveryMode) {
59
+ return currentManagedCommand(pair) === command
60
+ && currentManagedSkillDiscoveryMode(pair) === skillDiscoveryMode;
35
61
  }
36
62
  function validation() {
37
63
  throw new KiokukoError('VALIDATION_ERROR', 'Hermes config is not a valid YAML mapping');
38
64
  }
39
65
  function conflict() {
40
- throw new KiokukoError('CONFLICT', 'Hermes config already contains a conflicting kiokuko MCP server');
66
+ setupMcpIdentityConflict('hermes', 'Hermes config already contains a conflicting kiokuko MCP server');
67
+ }
68
+ function managedHermesServerValue(document, command, skillDiscoveryMode) {
69
+ const value = document.createNode({
70
+ command,
71
+ args: ['mcp'],
72
+ env: { [SKILL_DISCOVERY_ENV]: skillDiscoveryMode },
73
+ });
74
+ if (!isNode(value))
75
+ validation();
76
+ value.commentBefore = ` ${HERMES_MANAGED_MARKER}`;
77
+ return value;
41
78
  }
42
79
  function serializeHermesDocument(document, source, existing) {
43
80
  const eol = source.includes('\r\n') ? '\r\n' : '\n';
@@ -48,7 +85,17 @@ function serializeHermesDocument(document, source, existing) {
48
85
  action: existing === undefined ? 'created' : content === existing ? 'unchanged' : 'updated',
49
86
  };
50
87
  }
51
- export function renderHermesConfig(existing, command = 'kiokuko') {
88
+ export function renderHermesConfig(existing, command = 'kiokuko', skillDiscoveryMode, options = {}) {
89
+ if (typeof command !== 'string' || command.trim().length === 0 || command.includes('\0')) {
90
+ throw new KiokukoError('VALIDATION_ERROR', 'Hermes MCP command must be a non-empty executable path or name');
91
+ }
92
+ if (skillDiscoveryMode !== undefined && !isSkillDiscoveryMode(skillDiscoveryMode)) {
93
+ throw new KiokukoError('VALIDATION_ERROR', 'Hermes Skill discovery mode is invalid');
94
+ }
95
+ if (options.replaceConflictingIdentity !== undefined
96
+ && typeof options.replaceConflictingIdentity !== 'boolean') {
97
+ throw new KiokukoError('VALIDATION_ERROR', 'Hermes MCP replacement authorization is invalid');
98
+ }
52
99
  const source = existing ?? '';
53
100
  const document = parseDocument(source);
54
101
  if (document.errors.length > 0)
@@ -72,19 +119,26 @@ export function renderHermesConfig(existing, command = 'kiokuko') {
72
119
  const serverMap = mcpServers;
73
120
  const existingPair = findKeyPair(serverMap, 'kiokuko');
74
121
  if (existingPair !== undefined) {
75
- if (!hasManagedMarker(existingPair) || !hasCanonicalManagedShape(existingPair))
122
+ if (!hasManagedMarker(existingPair) || !hasCanonicalManagedShape(existingPair)) {
123
+ if (!options.replaceConflictingIdentity)
124
+ conflict();
125
+ existingPair.value = managedHermesServerValue(document, command, skillDiscoveryMode ?? 'official');
126
+ return serializeHermesDocument(document, source, existing);
127
+ }
128
+ const currentSkillDiscoveryMode = currentManagedSkillDiscoveryMode(existingPair);
129
+ if (currentSkillDiscoveryMode === undefined)
76
130
  conflict();
77
- if (hasRequestedState(existingPair, command))
131
+ const effectiveSkillDiscoveryMode = skillDiscoveryMode ?? currentSkillDiscoveryMode;
132
+ if (hasRequestedState(existingPair, command, effectiveSkillDiscoveryMode))
78
133
  return { content: source, action: 'unchanged' };
79
134
  if (!isMap(existingPair.value))
80
135
  conflict();
81
136
  existingPair.value.set('command', command);
137
+ existingPair.value.set('env', { [SKILL_DISCOVERY_ENV]: effectiveSkillDiscoveryMode });
82
138
  return serializeHermesDocument(document, source, existing);
83
139
  }
84
- const pair = document.createPair('kiokuko', { command, args: ['mcp'] });
85
- if (!isNode(pair.value))
86
- validation();
87
- pair.value.commentBefore = ` ${HERMES_MANAGED_MARKER}`;
140
+ const effectiveSkillDiscoveryMode = skillDiscoveryMode ?? 'official';
141
+ const pair = document.createPair('kiokuko', managedHermesServerValue(document, command, effectiveSkillDiscoveryMode));
88
142
  serverMap.add(pair);
89
143
  return serializeHermesDocument(document, source, existing);
90
144
  }
@@ -1 +1 @@
1
- {"version":3,"file":"hermes-config.js","sourceRoot":"","sources":["../../src/setup/hermes-config.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"hermes-config.js","sourceRoot":"","sources":["../../src/setup/hermes-config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ export declare const LEGACY_OPENCODE_LOOP_GUARD_MARKER = "// Managed by `kiokuko setup`: OpenCode loop guard v1";
2
+ /** Remove one exact hook written by the retired Claude integration. */
3
+ export declare function cleanupLegacyClaudePromptHook(source: string): string;
4
+ /** Accept only byte-exact files emitted by the retired OpenCode guard renderer. */
5
+ export declare function assertExactLegacyOpenCodeLoopGuard(source: string): void;
6
+ //# sourceMappingURL=legacy-client-cleanup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"legacy-client-cleanup.d.ts","sourceRoot":"","sources":["../../src/setup/legacy-client-cleanup.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,iCAAiC,0DAA0D,CAAC;AAyFzG,uEAAuE;AACvE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAyCpE;AAED,mFAAmF;AACnF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CASvE"}
@@ -0,0 +1,152 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { applyEdits, modify, parse } from 'jsonc-parser';
3
+ import { KiokukoError } from '../errors.js';
4
+ import { assertStrictJsonSyntax } from './strict-json.js';
5
+ const CLAUDE_HOOK_EVENT = 'UserPromptSubmit';
6
+ const LEGACY_HOOK_INPUT = Object.freeze({
7
+ prompt: '${prompt}',
8
+ cwd: '${cwd}',
9
+ sessionId: '${session_id}',
10
+ });
11
+ const LEGACY_HOOK_STATUS = 'Kiokuko: recalling relevant memory';
12
+ export const LEGACY_OPENCODE_LOOP_GUARD_MARKER = '// Managed by `kiokuko setup`: OpenCode loop guard v1';
13
+ const LEGACY_OPENCODE_LOOP_GUARD_SHA256 = new Set([
14
+ '9a9a5430942a3632c7b73958d49fc5e456b439741ef31db34fec38c2ebcb9f0a',
15
+ '6910ad5cae126371397ca3dda4adadca8b07f80dcd4ba995192c46e167758cde',
16
+ 'a34f3e3c3009ae622bda92a77ea33cc24aaa75ab05a338f795acbe8346effbfe',
17
+ 'd86f45354797f586748fd7beaa6c66c8df0705a0ac7d07db45118aa1dbdccece',
18
+ '598d919ed088e725311e567d3ee305bdbb026b538972c41e84ed450d4cd79620',
19
+ '04898710f67a451177e351f5343aed2b2a9c75c4fcc233829b2062aa804bd040',
20
+ 'd044cc7947dd4b41e14ed8891a01f21bb28f83c14765e542192172202e7ab6b2',
21
+ '26facf4203b66c25d0305a7ec919cfba6e55e4b2b4dcd7333af0002eb87255d2',
22
+ '4226cfe43306871e3fda95f87e4d4c1c98c54150e8a9ec876e941d7aaf5a8431',
23
+ 'efe0b9274b6f0de8976989639810cff6d55f50d759a6e1a3839834f3b3386931',
24
+ '2aecaf04354cb76d0e2c8fa63f96f7fb91e8bd3720aaee827e5794f0eb6d94a6',
25
+ '361c7b1a8d0993597d139ab6703d130d788dfcf01e4911bb7966c54afa57201b',
26
+ ]);
27
+ function isObject(value) {
28
+ if (typeof value !== 'object' || value === null || Array.isArray(value))
29
+ return false;
30
+ const prototype = Object.getPrototypeOf(value);
31
+ return prototype === Object.prototype || prototype === null;
32
+ }
33
+ function invalidClaudeSettings() {
34
+ throw new KiokukoError('VALIDATION_ERROR', 'Claude settings are not a valid JSON object with valid hook arrays');
35
+ }
36
+ function legacyClaudeHookConflict() {
37
+ throw new KiokukoError('CONFLICT', 'Claude settings contain an ambiguous or modified legacy Kiokuko prompt hook; remove it manually before running setup');
38
+ }
39
+ function validateHookGroups(value) {
40
+ if (!Array.isArray(value))
41
+ invalidClaudeSettings();
42
+ for (const group of value) {
43
+ if (!isObject(group) || (group.matcher !== undefined && typeof group.matcher !== 'string') || !Array.isArray(group.hooks))
44
+ invalidClaudeSettings();
45
+ for (const handler of group.hooks) {
46
+ if (!isObject(handler))
47
+ invalidClaudeSettings();
48
+ }
49
+ }
50
+ }
51
+ function validateSettings(value) {
52
+ if (!isObject(value))
53
+ invalidClaudeSettings();
54
+ if (value.hooks === undefined)
55
+ return;
56
+ if (!isObject(value.hooks))
57
+ invalidClaudeSettings();
58
+ for (const groups of Object.values(value.hooks))
59
+ validateHookGroups(groups);
60
+ }
61
+ function hasLegacyIdentityPart(handler) {
62
+ if (handler.server === 'kiokuko'
63
+ || handler.tool === 'claude_prompt_context'
64
+ || handler.statusMessage === LEGACY_HOOK_STATUS)
65
+ return true;
66
+ if (!isObject(handler.input))
67
+ return false;
68
+ const inputMatches = [
69
+ handler.input.prompt === LEGACY_HOOK_INPUT.prompt,
70
+ handler.input.cwd === LEGACY_HOOK_INPUT.cwd,
71
+ handler.input.sessionId === LEGACY_HOOK_INPUT.sessionId,
72
+ ].filter(Boolean).length;
73
+ return inputMatches >= 2
74
+ || (handler.type === 'mcp_tool' && handler.timeout === 5 && inputMatches >= 1);
75
+ }
76
+ function isCanonicalLegacyHook(handler) {
77
+ const keys = Object.keys(handler).sort();
78
+ if (keys.join('\0') !== ['input', 'server', 'statusMessage', 'timeout', 'tool', 'type'].sort().join('\0'))
79
+ return false;
80
+ if (handler.type !== 'mcp_tool'
81
+ || handler.server !== 'kiokuko'
82
+ || handler.tool !== 'claude_prompt_context'
83
+ || handler.timeout !== 5
84
+ || handler.statusMessage !== LEGACY_HOOK_STATUS
85
+ || !isObject(handler.input))
86
+ return false;
87
+ const inputKeys = Object.keys(handler.input).sort();
88
+ return inputKeys.join('\0') === Object.keys(LEGACY_HOOK_INPUT).sort().join('\0')
89
+ && handler.input.prompt === LEGACY_HOOK_INPUT.prompt
90
+ && handler.input.cwd === LEGACY_HOOK_INPUT.cwd
91
+ && handler.input.sessionId === LEGACY_HOOK_INPUT.sessionId;
92
+ }
93
+ function formattingOptions(source) {
94
+ const indentation = source.match(/^([ \t]+)(?=["}])/mu)?.[1];
95
+ const eol = source.includes('\r\n') ? '\r\n' : '\n';
96
+ if (indentation?.includes('\t'))
97
+ return { insertSpaces: false, tabSize: 1, eol };
98
+ return { insertSpaces: true, tabSize: indentation?.length || 2, eol };
99
+ }
100
+ /** Remove one exact hook written by the retired Claude integration. */
101
+ export function cleanupLegacyClaudePromptHook(source) {
102
+ assertStrictJsonSyntax(source, { allowTrailingComma: false, disallowComments: true }, 'Claude settings are not a valid JSON object with unique keys');
103
+ const errors = [];
104
+ const parsed = parse(source, errors, { allowTrailingComma: false, disallowComments: true });
105
+ if (errors.length > 0)
106
+ invalidClaudeSettings();
107
+ validateSettings(parsed);
108
+ const hooks = parsed.hooks;
109
+ const matches = [];
110
+ for (const [event, groupsValue] of Object.entries(hooks ?? {})) {
111
+ const groups = groupsValue;
112
+ groups.forEach((group, groupIndex) => {
113
+ group.hooks.forEach((handler, handlerIndex) => {
114
+ if (!hasLegacyIdentityPart(handler))
115
+ return;
116
+ if (event !== CLAUDE_HOOK_EVENT || !isCanonicalLegacyHook(handler))
117
+ legacyClaudeHookConflict();
118
+ matches.push({ event, groupIndex, handlerIndex });
119
+ });
120
+ });
121
+ }
122
+ if (matches.length === 0)
123
+ return source;
124
+ if (matches.length !== 1)
125
+ legacyClaudeHookConflict();
126
+ const groups = (hooks?.[CLAUDE_HOOK_EVENT]).map((group) => ({
127
+ ...group,
128
+ hooks: [...group.hooks],
129
+ }));
130
+ const match = matches[0];
131
+ const group = groups[match.groupIndex];
132
+ group.hooks.splice(match.handlerIndex, 1);
133
+ if (group.hooks.length === 0 && Object.keys(group).length === 1) {
134
+ groups.splice(match.groupIndex, 1);
135
+ }
136
+ const edits = modify(source, ['hooks', CLAUDE_HOOK_EVENT], groups.length === 0 ? undefined : groups, {
137
+ formattingOptions: formattingOptions(source),
138
+ });
139
+ return applyEdits(source, edits);
140
+ }
141
+ /** Accept only byte-exact files emitted by the retired OpenCode guard renderer. */
142
+ export function assertExactLegacyOpenCodeLoopGuard(source) {
143
+ if (!source.startsWith(`${LEGACY_OPENCODE_LOOP_GUARD_MARKER}\n`)
144
+ && !source.startsWith(`${LEGACY_OPENCODE_LOOP_GUARD_MARKER}\r\n`)) {
145
+ throw new KiokukoError('CONFLICT', 'The retired OpenCode Kiokuko plugin path contains an unmanaged file; move or remove it before running setup');
146
+ }
147
+ const digest = createHash('sha256').update(source).digest('hex');
148
+ if (!LEGACY_OPENCODE_LOOP_GUARD_SHA256.has(digest)) {
149
+ throw new KiokukoError('CONFLICT', 'The retired OpenCode Kiokuko plugin was modified; move or remove it before running setup');
150
+ }
151
+ }
152
+ //# sourceMappingURL=legacy-client-cleanup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"legacy-client-cleanup.js","sourceRoot":"","sources":["../../src/setup/legacy-client-cleanup.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"managed-text.d.ts","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;CAC7C;AAiBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAsBtB"}
1
+ {"version":3,"file":"managed-text.d.ts","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;CAC7C;AAwBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,oBAAoB,CA0BtB"}
@@ -10,13 +10,23 @@ function positions(content, marker) {
10
10
  offset = position + marker.length;
11
11
  }
12
12
  }
13
+ function isStandaloneMarker(content, marker, position) {
14
+ const before = position === 0 ? '' : content[position - 1];
15
+ const after = content.slice(position + marker.length, position + marker.length + 2);
16
+ return (position === 0 || before === '\n')
17
+ && (position + marker.length === content.length || after.startsWith('\n') || after === '\r\n');
18
+ }
13
19
  function eolFor(content) {
14
20
  return content.includes('\r\n') ? '\r\n' : '\n';
15
21
  }
16
22
  export function upsertDelimitedBlock(existing, block, beginMarker, endMarker, label) {
17
23
  const begins = positions(existing, beginMarker);
18
24
  const ends = positions(existing, endMarker);
19
- if ((begins.length === 0) !== (ends.length === 0) || begins.length > 1 || ends.length > 1) {
25
+ if ((begins.length === 0) !== (ends.length === 0)
26
+ || begins.length > 1
27
+ || ends.length > 1
28
+ || (begins[0] !== undefined && !isStandaloneMarker(existing, beginMarker, begins[0]))
29
+ || (ends[0] !== undefined && !isStandaloneMarker(existing, endMarker, ends[0]))) {
20
30
  throw new KiokukoError('VALIDATION_ERROR', `${label} contains malformed Kiokuko managed markers`);
21
31
  }
22
32
  const eol = eolFor(existing);
@@ -1 +1 @@
1
- {"version":3,"file":"managed-text.js","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"managed-text.js","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export type SetupMcpClient = 'codex' | 'opencode' | 'claude' | 'hermes';
2
+ export declare function setupMcpIdentityConflict(client: SetupMcpClient, message: string): never;
3
+ export declare function setupMcpIdentityConflictClient(error: unknown): SetupMcpClient | undefined;
4
+ //# sourceMappingURL=mcp-conflict.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-conflict.d.ts","sourceRoot":"","sources":["../../src/setup/mcp-conflict.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAWxE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAEvF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAEzF"}
@@ -0,0 +1,15 @@
1
+ import { KiokukoError } from '../errors.js';
2
+ class SetupMcpIdentityConflictError extends KiokukoError {
3
+ client;
4
+ constructor(client, message) {
5
+ super('CONFLICT', message);
6
+ this.client = client;
7
+ }
8
+ }
9
+ export function setupMcpIdentityConflict(client, message) {
10
+ throw new SetupMcpIdentityConflictError(client, message);
11
+ }
12
+ export function setupMcpIdentityConflictClient(error) {
13
+ return error instanceof SetupMcpIdentityConflictError ? error.client : undefined;
14
+ }
15
+ //# sourceMappingURL=mcp-conflict.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-conflict.js","sourceRoot":"","sources":["../../src/setup/mcp-conflict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,MAAM,6BAA8B,SAAQ,YAAY;IAE3C;IADX,YACW,MAAsB,EAC/B,OAAe;QAEf,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAHlB,WAAM,GAAN,MAAM,CAAgB;IAIjC,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAsB,EAAE,OAAe;IAC9E,MAAM,IAAI,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAc;IAC3D,OAAO,KAAK,YAAY,6BAA6B,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC"}
@@ -1,3 +1,6 @@
1
+ import type { SkillDiscoveryMode } from '../skills/types.js';
1
2
  import type { DelimitedBlockResult } from './managed-text.js';
2
- export declare function renderOpenCodeConfig(existing: string | undefined, command?: string): DelimitedBlockResult;
3
+ export declare function renderOpenCodeConfig(existing: string | undefined, command?: string, skillDiscoveryMode?: SkillDiscoveryMode, options?: {
4
+ replaceConflictingIdentity?: boolean;
5
+ }): DelimitedBlockResult;
3
6
  //# sourceMappingURL=opencode-config.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"opencode-config.d.ts","sourceRoot":"","sources":["../../src/setup/opencode-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,SAAY,GAAG,oBAAoB,CAsB5G"}
1
+ {"version":3,"file":"opencode-config.d.ts","sourceRoot":"","sources":["../../src/setup/opencode-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAyC9D,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,SAAY,EACnB,kBAAkB,CAAC,EAAE,kBAAkB,EACvC,OAAO,GAAE;IAAE,0BAA0B,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,oBAAoB,CA8CtB"}
@@ -1,19 +1,79 @@
1
1
  import { applyEdits, modify, parse } from 'jsonc-parser';
2
2
  import { KiokukoError } from '../errors.js';
3
- export function renderOpenCodeConfig(existing, command = 'kiokuko') {
4
- const source = existing === undefined || existing.trim().length === 0
5
- ? '{\n "$schema": "https://opencode.ai/config.json"\n}\n'
6
- : existing;
3
+ import { isSkillDiscoveryMode, SKILL_DISCOVERY_ENV } from '../skills/config.js';
4
+ import { setupMcpIdentityConflict } from './mcp-conflict.js';
5
+ import { assertStrictJsonSyntax } from './strict-json.js';
6
+ function object(value) {
7
+ return typeof value === 'object' && value !== null && !Array.isArray(value)
8
+ ? value
9
+ : undefined;
10
+ }
11
+ function hasExactKeys(value, expected) {
12
+ const keys = Object.keys(value);
13
+ return keys.length === expected.length && expected.every((key) => keys.includes(key));
14
+ }
15
+ function isNonEmptyCommand(value) {
16
+ return typeof value === 'string' && value.trim().length > 0 && !value.includes('\0');
17
+ }
18
+ function isCanonicalManagedServer(value) {
19
+ const server = object(value);
20
+ if (server === undefined || !hasExactKeys(server, ['type', 'command', 'enabled', 'environment']))
21
+ return false;
22
+ if (server.type !== 'local' || server.enabled !== true)
23
+ return false;
24
+ if (!Array.isArray(server.command)
25
+ || server.command.length !== 2
26
+ || !isNonEmptyCommand(server.command[0])
27
+ || server.command[1] !== 'mcp')
28
+ return false;
29
+ const environment = object(server.environment);
30
+ return environment !== undefined
31
+ && hasExactKeys(environment, [SKILL_DISCOVERY_ENV])
32
+ && isSkillDiscoveryMode(environment[SKILL_DISCOVERY_ENV]);
33
+ }
34
+ function validation(message) {
35
+ throw new KiokukoError('VALIDATION_ERROR', message);
36
+ }
37
+ function conflict() {
38
+ setupMcpIdentityConflict('opencode', 'OpenCode config already contains a conflicting kiokuko MCP server');
39
+ }
40
+ export function renderOpenCodeConfig(existing, command = 'kiokuko', skillDiscoveryMode, options = {}) {
41
+ if (!isNonEmptyCommand(command))
42
+ validation('OpenCode MCP command must be a non-empty executable path or name');
43
+ if (skillDiscoveryMode !== undefined && !isSkillDiscoveryMode(skillDiscoveryMode)) {
44
+ validation('OpenCode Skill discovery mode is invalid');
45
+ }
46
+ if (options.replaceConflictingIdentity !== undefined
47
+ && typeof options.replaceConflictingIdentity !== 'boolean') {
48
+ validation('OpenCode MCP replacement authorization is invalid');
49
+ }
50
+ const source = existing ?? '{\n "$schema": "https://opencode.ai/config.json"\n}\n';
51
+ assertStrictJsonSyntax(source, { allowTrailingComma: true, disallowComments: false }, 'OpenCode config is not a valid JSON/JSONC object with unique keys');
7
52
  const errors = [];
8
53
  const parsed = parse(source, errors, { allowTrailingComma: true, disallowComments: false });
9
54
  if (errors.length > 0 || typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
10
- throw new KiokukoError('VALIDATION_ERROR', 'OpenCode config is not a valid JSON/JSONC object');
55
+ validation('OpenCode config is not a valid JSON/JSONC object');
11
56
  }
57
+ const root = parsed;
58
+ const mcp = object(root.mcp);
59
+ if (root.mcp !== undefined && mcp === undefined)
60
+ validation('OpenCode config has an invalid mcp object');
61
+ const currentServer = mcp?.kiokuko;
62
+ const canonicalServer = currentServer !== undefined && isCanonicalManagedServer(currentServer)
63
+ ? currentServer
64
+ : undefined;
65
+ if (currentServer !== undefined && canonicalServer === undefined && !options.replaceConflictingIdentity)
66
+ conflict();
67
+ const currentEnvironment = canonicalServer === undefined ? undefined : object(canonicalServer.environment);
68
+ const effectiveSkillDiscoveryMode = skillDiscoveryMode
69
+ ?? currentEnvironment?.[SKILL_DISCOVERY_ENV]
70
+ ?? 'official';
12
71
  const eol = source.includes('\r\n') ? '\r\n' : '\n';
13
72
  const edits = modify(source, ['mcp', 'kiokuko'], {
14
73
  type: 'local',
15
74
  command: [command, 'mcp'],
16
75
  enabled: true,
76
+ environment: { [SKILL_DISCOVERY_ENV]: effectiveSkillDiscoveryMode },
17
77
  }, {
18
78
  formattingOptions: { insertSpaces: true, tabSize: 2, eol },
19
79
  });