@askdkc/kiokuko 0.1.16 → 0.1.19

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 (549) hide show
  1. package/README.ja.md +91 -112
  2. package/README.ko.md +90 -102
  3. package/README.md +103 -260
  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 +14 -24
  18. package/dist/akinator/agent-task.d.ts.map +1 -1
  19. package/dist/akinator/agent-task.js +460 -103
  20. package/dist/akinator/agent-task.js.map +1 -1
  21. package/dist/akinator/capabilities.d.ts +52 -7
  22. package/dist/akinator/capabilities.d.ts.map +1 -1
  23. package/dist/akinator/capabilities.js +226 -28
  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/bin/kiokuko.js +0 -0
  52. package/dist/cli.d.ts +2 -0
  53. package/dist/cli.d.ts.map +1 -1
  54. package/dist/cli.js +561 -144
  55. package/dist/cli.js.map +1 -1
  56. package/dist/client/server-client.d.ts +5 -3
  57. package/dist/client/server-client.d.ts.map +1 -1
  58. package/dist/client/server-client.js +486 -181
  59. package/dist/client/server-client.js.map +1 -1
  60. package/dist/commands/agent.d.ts +2 -0
  61. package/dist/commands/agent.d.ts.map +1 -1
  62. package/dist/commands/agent.js +861 -86
  63. package/dist/commands/agent.js.map +1 -1
  64. package/dist/commands/backup.d.ts +2 -1
  65. package/dist/commands/backup.d.ts.map +1 -1
  66. package/dist/commands/backup.js +64 -8
  67. package/dist/commands/backup.js.map +1 -1
  68. package/dist/commands/doctor.d.ts +5 -1
  69. package/dist/commands/doctor.d.ts.map +1 -1
  70. package/dist/commands/doctor.js +70 -26
  71. package/dist/commands/doctor.js.map +1 -1
  72. package/dist/commands/export.d.ts +0 -4
  73. package/dist/commands/export.d.ts.map +1 -1
  74. package/dist/commands/export.js +191 -32
  75. package/dist/commands/export.js.map +1 -1
  76. package/dist/commands/import.d.ts +10 -1
  77. package/dist/commands/import.d.ts.map +1 -1
  78. package/dist/commands/import.js +592 -113
  79. package/dist/commands/import.js.map +1 -1
  80. package/dist/commands/init.d.ts +19 -1
  81. package/dist/commands/init.d.ts.map +1 -1
  82. package/dist/commands/init.js +569 -22
  83. package/dist/commands/init.js.map +1 -1
  84. package/dist/commands/purge.d.ts.map +1 -1
  85. package/dist/commands/purge.js +3 -0
  86. package/dist/commands/purge.js.map +1 -1
  87. package/dist/commands/setup.d.ts +34 -8
  88. package/dist/commands/setup.d.ts.map +1 -1
  89. package/dist/commands/setup.js +418 -86
  90. package/dist/commands/setup.js.map +1 -1
  91. package/dist/commands/skills.d.ts +9 -0
  92. package/dist/commands/skills.d.ts.map +1 -0
  93. package/dist/commands/skills.js +317 -0
  94. package/dist/commands/skills.js.map +1 -0
  95. package/dist/commands/use.d.ts +10 -2
  96. package/dist/commands/use.d.ts.map +1 -1
  97. package/dist/commands/use.js +851 -73
  98. package/dist/commands/use.js.map +1 -1
  99. package/dist/config/paths.d.ts +11 -1
  100. package/dist/config/paths.d.ts.map +1 -1
  101. package/dist/config/paths.js +64 -29
  102. package/dist/config/paths.js.map +1 -1
  103. package/dist/config/project-config.d.ts +1 -0
  104. package/dist/config/project-config.d.ts.map +1 -1
  105. package/dist/config/project-config.js +70 -32
  106. package/dist/config/project-config.js.map +1 -1
  107. package/dist/context/broker.d.ts +30 -14
  108. package/dist/context/broker.d.ts.map +1 -1
  109. package/dist/context/broker.js +628 -150
  110. package/dist/context/broker.js.map +1 -1
  111. package/dist/context/delivery.d.ts +8 -22
  112. package/dist/context/delivery.d.ts.map +1 -1
  113. package/dist/context/delivery.js +204 -152
  114. package/dist/context/delivery.js.map +1 -1
  115. package/dist/context/feedback.d.ts +11 -12
  116. package/dist/context/feedback.d.ts.map +1 -1
  117. package/dist/context/feedback.js +250 -268
  118. package/dist/context/feedback.js.map +1 -1
  119. package/dist/context/origin.d.ts +9 -0
  120. package/dist/context/origin.d.ts.map +1 -0
  121. package/dist/context/origin.js +15 -0
  122. package/dist/context/origin.js.map +1 -0
  123. package/dist/context/ranking.d.ts +4 -13
  124. package/dist/context/ranking.d.ts.map +1 -1
  125. package/dist/context/ranking.js +21 -5
  126. package/dist/context/ranking.js.map +1 -1
  127. package/dist/context/recommendations.d.ts +0 -5
  128. package/dist/context/recommendations.d.ts.map +1 -1
  129. package/dist/context/recommendations.js +0 -1
  130. package/dist/context/recommendations.js.map +1 -1
  131. package/dist/context/run-state.d.ts +26 -0
  132. package/dist/context/run-state.d.ts.map +1 -0
  133. package/dist/context/run-state.js +399 -0
  134. package/dist/context/run-state.js.map +1 -0
  135. package/dist/context/scoped-broker.d.ts +19 -6
  136. package/dist/context/scoped-broker.d.ts.map +1 -1
  137. package/dist/context/scoped-broker.js +530 -131
  138. package/dist/context/scoped-broker.js.map +1 -1
  139. package/dist/context/selection-state.d.ts +19 -0
  140. package/dist/context/selection-state.d.ts.map +1 -0
  141. package/dist/context/selection-state.js +250 -0
  142. package/dist/context/selection-state.js.map +1 -0
  143. package/dist/db/adapter.d.ts +5 -3
  144. package/dist/db/adapter.d.ts.map +1 -1
  145. package/dist/db/adapter.js +6 -3
  146. package/dist/db/adapter.js.map +1 -1
  147. package/dist/db/capabilities.d.ts.map +1 -1
  148. package/dist/db/capabilities.js +34 -16
  149. package/dist/db/capabilities.js.map +1 -1
  150. package/dist/db/connection.d.ts +8 -0
  151. package/dist/db/connection.d.ts.map +1 -1
  152. package/dist/db/connection.js +55 -26
  153. package/dist/db/connection.js.map +1 -1
  154. package/dist/db/migrate.d.ts +28 -7
  155. package/dist/db/migrate.d.ts.map +1 -1
  156. package/dist/db/migrate.js +106 -78
  157. package/dist/db/migrate.js.map +1 -1
  158. package/dist/db/sqlite-retry.d.ts +11 -0
  159. package/dist/db/sqlite-retry.d.ts.map +1 -0
  160. package/dist/db/sqlite-retry.js +66 -0
  161. package/dist/db/sqlite-retry.js.map +1 -0
  162. package/dist/db/transaction.d.ts +13 -0
  163. package/dist/db/transaction.d.ts.map +1 -1
  164. package/dist/db/transaction.js +53 -24
  165. package/dist/db/transaction.js.map +1 -1
  166. package/dist/db/upgrade-backup.d.ts +58 -2
  167. package/dist/db/upgrade-backup.d.ts.map +1 -1
  168. package/dist/db/upgrade-backup.js +757 -28
  169. package/dist/db/upgrade-backup.js.map +1 -1
  170. package/dist/errors.js +1 -1
  171. package/dist/errors.js.map +1 -1
  172. package/dist/gateway/agent-service.d.ts +4 -1
  173. package/dist/gateway/agent-service.d.ts.map +1 -1
  174. package/dist/gateway/agent-service.js +71 -58
  175. package/dist/gateway/agent-service.js.map +1 -1
  176. package/dist/gateway/checkpoint-service.d.ts +1 -0
  177. package/dist/gateway/checkpoint-service.d.ts.map +1 -1
  178. package/dist/gateway/checkpoint-service.js +47 -24
  179. package/dist/gateway/checkpoint-service.js.map +1 -1
  180. package/dist/ledger/archive.d.ts +1 -4
  181. package/dist/ledger/archive.d.ts.map +1 -1
  182. package/dist/ledger/archive.js +134 -54
  183. package/dist/ledger/archive.js.map +1 -1
  184. package/dist/ledger/maintenance.d.ts +0 -11
  185. package/dist/ledger/maintenance.d.ts.map +1 -1
  186. package/dist/ledger/maintenance.js +41 -44
  187. package/dist/ledger/maintenance.js.map +1 -1
  188. package/dist/ledger/projection.d.ts +0 -1
  189. package/dist/ledger/projection.d.ts.map +1 -1
  190. package/dist/ledger/projection.js.map +1 -1
  191. package/dist/ledger/promotion.d.ts +0 -9
  192. package/dist/ledger/promotion.d.ts.map +1 -1
  193. package/dist/ledger/promotion.js.map +1 -1
  194. package/dist/ledger/query.d.ts +1 -15
  195. package/dist/ledger/query.d.ts.map +1 -1
  196. package/dist/ledger/query.js.map +1 -1
  197. package/dist/ledger/store.d.ts +0 -1
  198. package/dist/ledger/store.d.ts.map +1 -1
  199. package/dist/ledger/store.js +11 -8
  200. package/dist/ledger/store.js.map +1 -1
  201. package/dist/ledger/types.d.ts +0 -4
  202. package/dist/ledger/types.d.ts.map +1 -1
  203. package/dist/ledger/types.js.map +1 -1
  204. package/dist/ledger/validate.d.ts.map +1 -1
  205. package/dist/ledger/validate.js +0 -5
  206. package/dist/ledger/validate.js.map +1 -1
  207. package/dist/mcp/bounded-stdio-transport.d.ts +23 -0
  208. package/dist/mcp/bounded-stdio-transport.d.ts.map +1 -0
  209. package/dist/mcp/bounded-stdio-transport.js +109 -0
  210. package/dist/mcp/bounded-stdio-transport.js.map +1 -0
  211. package/dist/mcp/server.d.ts +4 -0
  212. package/dist/mcp/server.d.ts.map +1 -1
  213. package/dist/mcp/server.js +111 -75
  214. package/dist/mcp/server.js.map +1 -1
  215. package/dist/memory/audit.d.ts +0 -1
  216. package/dist/memory/audit.d.ts.map +1 -1
  217. package/dist/memory/audit.js +0 -1
  218. package/dist/memory/audit.js.map +1 -1
  219. package/dist/memory/curator.d.ts +45 -1
  220. package/dist/memory/curator.d.ts.map +1 -1
  221. package/dist/memory/curator.js +290 -68
  222. package/dist/memory/curator.js.map +1 -1
  223. package/dist/memory/entries.d.ts +12 -2
  224. package/dist/memory/entries.d.ts.map +1 -1
  225. package/dist/memory/entries.js +198 -114
  226. package/dist/memory/entries.js.map +1 -1
  227. package/dist/memory/federated-retrieval.d.ts +78 -0
  228. package/dist/memory/federated-retrieval.d.ts.map +1 -0
  229. package/dist/memory/federated-retrieval.js +441 -0
  230. package/dist/memory/federated-retrieval.js.map +1 -0
  231. package/dist/memory/hybrid-retrieval.d.ts +5 -11
  232. package/dist/memory/hybrid-retrieval.d.ts.map +1 -1
  233. package/dist/memory/hybrid-retrieval.js +78 -58
  234. package/dist/memory/hybrid-retrieval.js.map +1 -1
  235. package/dist/memory/lifecycle.d.ts.map +1 -1
  236. package/dist/memory/lifecycle.js +17 -13
  237. package/dist/memory/lifecycle.js.map +1 -1
  238. package/dist/memory/portability.d.ts +10 -0
  239. package/dist/memory/portability.d.ts.map +1 -0
  240. package/dist/memory/portability.js +44 -0
  241. package/dist/memory/portability.js.map +1 -0
  242. package/dist/memory/rebuild-search.d.ts +5 -0
  243. package/dist/memory/rebuild-search.d.ts.map +1 -1
  244. package/dist/memory/rebuild-search.js +101 -76
  245. package/dist/memory/rebuild-search.js.map +1 -1
  246. package/dist/memory/retrieval-query.d.ts +0 -5
  247. package/dist/memory/retrieval-query.d.ts.map +1 -1
  248. package/dist/memory/retrieval-query.js +0 -5
  249. package/dist/memory/retrieval-query.js.map +1 -1
  250. package/dist/memory/retrieval.d.ts +11 -0
  251. package/dist/memory/retrieval.d.ts.map +1 -1
  252. package/dist/memory/retrieval.js +34 -120
  253. package/dist/memory/retrieval.js.map +1 -1
  254. package/dist/memory/revisions.d.ts +76 -1
  255. package/dist/memory/revisions.d.ts.map +1 -1
  256. package/dist/memory/revisions.js +539 -35
  257. package/dist/memory/revisions.js.map +1 -1
  258. package/dist/memory/scoped-memory.d.ts +22 -13
  259. package/dist/memory/scoped-memory.d.ts.map +1 -1
  260. package/dist/memory/scoped-memory.js +248 -139
  261. package/dist/memory/scoped-memory.js.map +1 -1
  262. package/dist/memory/secrets.d.ts +2 -0
  263. package/dist/memory/secrets.d.ts.map +1 -1
  264. package/dist/memory/secrets.js +36 -0
  265. package/dist/memory/secrets.js.map +1 -1
  266. package/dist/memory/structured-memory.d.ts +8 -1
  267. package/dist/memory/structured-memory.d.ts.map +1 -1
  268. package/dist/memory/structured-memory.js +74 -20
  269. package/dist/memory/structured-memory.js.map +1 -1
  270. package/dist/memory/workspaces.d.ts +9 -0
  271. package/dist/memory/workspaces.d.ts.map +1 -1
  272. package/dist/memory/workspaces.js +67 -0
  273. package/dist/memory/workspaces.js.map +1 -1
  274. package/dist/package-version.d.ts +2 -0
  275. package/dist/package-version.d.ts.map +1 -0
  276. package/dist/package-version.js +7 -0
  277. package/dist/package-version.js.map +1 -0
  278. package/dist/repository/binding.d.ts +5 -0
  279. package/dist/repository/binding.d.ts.map +1 -1
  280. package/dist/repository/binding.js +117 -17
  281. package/dist/repository/binding.js.map +1 -1
  282. package/dist/repository/framework-version.d.ts +8 -0
  283. package/dist/repository/framework-version.d.ts.map +1 -0
  284. package/dist/repository/framework-version.js +29 -0
  285. package/dist/repository/framework-version.js.map +1 -0
  286. package/dist/repository/identity-value.d.ts +4 -0
  287. package/dist/repository/identity-value.d.ts.map +1 -0
  288. package/dist/repository/identity-value.js +24 -0
  289. package/dist/repository/identity-value.js.map +1 -0
  290. package/dist/repository/identity.d.ts.map +1 -1
  291. package/dist/repository/identity.js +2 -0
  292. package/dist/repository/identity.js.map +1 -1
  293. package/dist/repository/project-fingerprint.d.ts +33 -0
  294. package/dist/repository/project-fingerprint.d.ts.map +1 -0
  295. package/dist/repository/project-fingerprint.js +429 -0
  296. package/dist/repository/project-fingerprint.js.map +1 -0
  297. package/dist/repository/remote-url.d.ts +0 -1
  298. package/dist/repository/remote-url.d.ts.map +1 -1
  299. package/dist/repository/remote-url.js +0 -1
  300. package/dist/repository/remote-url.js.map +1 -1
  301. package/dist/runtime-version.d.ts +2 -1
  302. package/dist/runtime-version.d.ts.map +1 -1
  303. package/dist/runtime-version.js +21 -4
  304. package/dist/runtime-version.js.map +1 -1
  305. package/dist/serialization/boundary-json.d.ts +20 -0
  306. package/dist/serialization/boundary-json.d.ts.map +1 -0
  307. package/dist/serialization/boundary-json.js +129 -0
  308. package/dist/serialization/boundary-json.js.map +1 -0
  309. package/dist/serialization/envelope.js +1 -1
  310. package/dist/serialization/envelope.js.map +1 -1
  311. package/dist/serialization/validate.d.ts +7 -0
  312. package/dist/serialization/validate.d.ts.map +1 -1
  313. package/dist/serialization/validate.js +53 -13
  314. package/dist/serialization/validate.js.map +1 -1
  315. package/dist/server/app.js +1 -1
  316. package/dist/server/app.js.map +1 -1
  317. package/dist/server/http.d.ts +4 -3
  318. package/dist/server/http.d.ts.map +1 -1
  319. package/dist/server/http.js +90 -50
  320. package/dist/server/http.js.map +1 -1
  321. package/dist/server/idempotency.d.ts +0 -6
  322. package/dist/server/idempotency.d.ts.map +1 -1
  323. package/dist/server/idempotency.js.map +1 -1
  324. package/dist/server/router.d.ts.map +1 -1
  325. package/dist/server/router.js +21 -4
  326. package/dist/server/router.js.map +1 -1
  327. package/dist/server/routes/agent-capability-gate.d.ts +40 -0
  328. package/dist/server/routes/agent-capability-gate.d.ts.map +1 -0
  329. package/dist/server/routes/agent-capability-gate.js +182 -0
  330. package/dist/server/routes/agent-capability-gate.js.map +1 -0
  331. package/dist/server/routes/agent-events.d.ts.map +1 -1
  332. package/dist/server/routes/agent-events.js +8 -1
  333. package/dist/server/routes/agent-events.js.map +1 -1
  334. package/dist/server/routes/agent-intake.d.ts.map +1 -1
  335. package/dist/server/routes/agent-intake.js +10 -2
  336. package/dist/server/routes/agent-intake.js.map +1 -1
  337. package/dist/server/routes/agent-promotions.d.ts.map +1 -1
  338. package/dist/server/routes/agent-promotions.js +5 -2
  339. package/dist/server/routes/agent-promotions.js.map +1 -1
  340. package/dist/server/routes/agent-runs.d.ts.map +1 -1
  341. package/dist/server/routes/agent-runs.js +18 -4
  342. package/dist/server/routes/agent-runs.js.map +1 -1
  343. package/dist/server/routes/request-binding.d.ts +5 -0
  344. package/dist/server/routes/request-binding.d.ts.map +1 -0
  345. package/dist/server/routes/request-binding.js +49 -0
  346. package/dist/server/routes/request-binding.js.map +1 -0
  347. package/dist/server/routes/task5-support.d.ts +1 -8
  348. package/dist/server/routes/task5-support.d.ts.map +1 -1
  349. package/dist/server/routes/task5-support.js +1 -17
  350. package/dist/server/routes/task5-support.js.map +1 -1
  351. package/dist/server/routes/task5.d.ts.map +1 -1
  352. package/dist/server/routes/task5.js +106 -36
  353. package/dist/server/routes/task5.js.map +1 -1
  354. package/dist/server/write-queue.js +2 -2
  355. package/dist/server/write-queue.js.map +1 -1
  356. package/dist/setup/claude-config.d.ts +2 -1
  357. package/dist/setup/claude-config.d.ts.map +1 -1
  358. package/dist/setup/claude-config.js +54 -4
  359. package/dist/setup/claude-config.js.map +1 -1
  360. package/dist/setup/client-detection.d.ts +7 -2
  361. package/dist/setup/client-detection.d.ts.map +1 -1
  362. package/dist/setup/client-detection.js +27 -9
  363. package/dist/setup/client-detection.js.map +1 -1
  364. package/dist/setup/hermes-config.d.ts +2 -1
  365. package/dist/setup/hermes-config.d.ts.map +1 -1
  366. package/dist/setup/hermes-config.js +53 -12
  367. package/dist/setup/hermes-config.js.map +1 -1
  368. package/dist/setup/legacy-client-cleanup.d.ts +6 -0
  369. package/dist/setup/legacy-client-cleanup.d.ts.map +1 -0
  370. package/dist/setup/legacy-client-cleanup.js +152 -0
  371. package/dist/setup/legacy-client-cleanup.js.map +1 -0
  372. package/dist/setup/managed-text.d.ts.map +1 -1
  373. package/dist/setup/managed-text.js +11 -1
  374. package/dist/setup/managed-text.js.map +1 -1
  375. package/dist/setup/opencode-config.d.ts +2 -1
  376. package/dist/setup/opencode-config.d.ts.map +1 -1
  377. package/dist/setup/opencode-config.js +57 -5
  378. package/dist/setup/opencode-config.js.map +1 -1
  379. package/dist/setup/render.d.ts +2 -1
  380. package/dist/setup/render.d.ts.map +1 -1
  381. package/dist/setup/render.js +91 -17
  382. package/dist/setup/render.js.map +1 -1
  383. package/dist/setup/standard-skills.d.ts +16 -2
  384. package/dist/setup/standard-skills.d.ts.map +1 -1
  385. package/dist/setup/standard-skills.js +37 -13
  386. package/dist/setup/standard-skills.js.map +1 -1
  387. package/dist/setup/strict-json.d.ts +7 -0
  388. package/dist/setup/strict-json.d.ts.map +1 -0
  389. package/dist/setup/strict-json.js +98 -0
  390. package/dist/setup/strict-json.js.map +1 -0
  391. package/dist/setup/strict-toml.d.ts +7 -0
  392. package/dist/setup/strict-toml.d.ts.map +1 -0
  393. package/dist/setup/strict-toml.js +470 -0
  394. package/dist/setup/strict-toml.js.map +1 -0
  395. package/dist/skills/cache.d.ts +15 -0
  396. package/dist/skills/cache.d.ts.map +1 -0
  397. package/dist/skills/cache.js +19 -0
  398. package/dist/skills/cache.js.map +1 -0
  399. package/dist/skills/candidate-ranking.d.ts +15 -0
  400. package/dist/skills/candidate-ranking.d.ts.map +1 -0
  401. package/dist/skills/candidate-ranking.js +52 -0
  402. package/dist/skills/candidate-ranking.js.map +1 -0
  403. package/dist/skills/chunking.d.ts +11 -0
  404. package/dist/skills/chunking.d.ts.map +1 -0
  405. package/dist/skills/chunking.js +291 -0
  406. package/dist/skills/chunking.js.map +1 -0
  407. package/dist/skills/config.d.ts +19 -0
  408. package/dist/skills/config.d.ts.map +1 -0
  409. package/dist/skills/config.js +103 -0
  410. package/dist/skills/config.js.map +1 -0
  411. package/dist/skills/discovery-service.d.ts +26 -0
  412. package/dist/skills/discovery-service.d.ts.map +1 -0
  413. package/dist/skills/discovery-service.js +921 -0
  414. package/dist/skills/discovery-service.js.map +1 -0
  415. package/dist/skills/external-transport.d.ts +2 -0
  416. package/dist/skills/external-transport.d.ts.map +1 -0
  417. package/dist/skills/external-transport.js +30 -0
  418. package/dist/skills/external-transport.js.map +1 -0
  419. package/dist/skills/find.d.ts +16 -0
  420. package/dist/skills/find.d.ts.map +1 -0
  421. package/dist/skills/find.js +58 -0
  422. package/dist/skills/find.js.map +1 -0
  423. package/dist/skills/gap-detection.d.ts +23 -0
  424. package/dist/skills/gap-detection.d.ts.map +1 -0
  425. package/dist/skills/gap-detection.js +62 -0
  426. package/dist/skills/gap-detection.js.map +1 -0
  427. package/dist/skills/import-preparation.d.ts +4 -0
  428. package/dist/skills/import-preparation.d.ts.map +1 -0
  429. package/dist/skills/import-preparation.js +20 -0
  430. package/dist/skills/import-preparation.js.map +1 -0
  431. package/dist/skills/materialization-authority.d.ts +11 -0
  432. package/dist/skills/materialization-authority.d.ts.map +1 -0
  433. package/dist/skills/materialization-authority.js +92 -0
  434. package/dist/skills/materialization-authority.js.map +1 -0
  435. package/dist/skills/materialization-service.d.ts +22 -0
  436. package/dist/skills/materialization-service.d.ts.map +1 -0
  437. package/dist/skills/materialization-service.js +101 -0
  438. package/dist/skills/materialization-service.js.map +1 -0
  439. package/dist/skills/official-catalog.d.ts +31 -0
  440. package/dist/skills/official-catalog.d.ts.map +1 -0
  441. package/dist/skills/official-catalog.js +110 -0
  442. package/dist/skills/official-catalog.js.map +1 -0
  443. package/dist/skills/providers/schema.d.ts +30 -0
  444. package/dist/skills/providers/schema.d.ts.map +1 -0
  445. package/dist/skills/providers/schema.js +354 -0
  446. package/dist/skills/providers/schema.js.map +1 -0
  447. package/dist/skills/providers/skills-sh-compat.d.ts +17 -0
  448. package/dist/skills/providers/skills-sh-compat.d.ts.map +1 -0
  449. package/dist/skills/providers/skills-sh-compat.js +71 -0
  450. package/dist/skills/providers/skills-sh-compat.js.map +1 -0
  451. package/dist/skills/providers/skills-sh-v1.d.ts +23 -0
  452. package/dist/skills/providers/skills-sh-v1.d.ts.map +1 -0
  453. package/dist/skills/providers/skills-sh-v1.js +134 -0
  454. package/dist/skills/providers/skills-sh-v1.js.map +1 -0
  455. package/dist/skills/query-builder.d.ts +18 -0
  456. package/dist/skills/query-builder.d.ts.map +1 -0
  457. package/dist/skills/query-builder.js +93 -0
  458. package/dist/skills/query-builder.js.map +1 -0
  459. package/dist/skills/source/errors.d.ts +9 -0
  460. package/dist/skills/source/errors.d.ts.map +1 -0
  461. package/dist/skills/source/errors.js +15 -0
  462. package/dist/skills/source/errors.js.map +1 -0
  463. package/dist/skills/source/frontmatter.d.ts +9 -0
  464. package/dist/skills/source/frontmatter.d.ts.map +1 -0
  465. package/dist/skills/source/frontmatter.js +77 -0
  466. package/dist/skills/source/frontmatter.js.map +1 -0
  467. package/dist/skills/source/github-fetcher.d.ts +20 -0
  468. package/dist/skills/source/github-fetcher.d.ts.map +1 -0
  469. package/dist/skills/source/github-fetcher.js +292 -0
  470. package/dist/skills/source/github-fetcher.js.map +1 -0
  471. package/dist/skills/source/snapshot-validator.d.ts +28 -0
  472. package/dist/skills/source/snapshot-validator.d.ts.map +1 -0
  473. package/dist/skills/source/snapshot-validator.js +186 -0
  474. package/dist/skills/source/snapshot-validator.js.map +1 -0
  475. package/dist/skills/store.d.ts +181 -0
  476. package/dist/skills/store.d.ts.map +1 -0
  477. package/dist/skills/store.js +1710 -0
  478. package/dist/skills/store.js.map +1 -0
  479. package/dist/skills/types.d.ts +169 -0
  480. package/dist/skills/types.d.ts.map +1 -0
  481. package/dist/skills/types.js +2 -0
  482. package/dist/skills/types.js.map +1 -0
  483. package/dist/web/i18n.d.ts +56 -8
  484. package/dist/web/i18n.d.ts.map +1 -1
  485. package/dist/web/i18n.js +224 -32
  486. package/dist/web/i18n.js.map +1 -1
  487. package/dist/web/server.d.ts.map +1 -1
  488. package/dist/web/server.js +458 -42
  489. package/dist/web/server.js.map +1 -1
  490. package/dist/web/ui.d.ts +4 -0
  491. package/dist/web/ui.d.ts.map +1 -1
  492. package/dist/web/ui.js +697 -61
  493. package/dist/web/ui.js.map +1 -1
  494. package/migrations/008_federated_memory.sql +46 -0
  495. package/migrations/009_external_skill_discovery.sql +126 -0
  496. package/package.json +6 -3
  497. package/skills/kiokuko-single-purpose-functions/SKILL.md +288 -0
  498. package/skills/kiokuko-single-purpose-functions/references/kiokuko-patterns.md +344 -0
  499. package/skills/kiokuko-single-purpose-functions/references/review-checklist.md +97 -0
  500. package/skills/kiokuko-ui-design-soul/SKILL.md +1186 -28
  501. package/templates/AGENTS.md +8 -7
  502. package/dist/client/runtime-discovery.d.ts +0 -15
  503. package/dist/client/runtime-discovery.d.ts.map +0 -1
  504. package/dist/client/runtime-discovery.js +0 -45
  505. package/dist/client/runtime-discovery.js.map +0 -1
  506. package/dist/commands/call.d.ts +0 -7
  507. package/dist/commands/call.d.ts.map +0 -1
  508. package/dist/commands/call.js +0 -10
  509. package/dist/commands/call.js.map +0 -1
  510. package/dist/commands/link.d.ts +0 -6
  511. package/dist/commands/link.d.ts.map +0 -1
  512. package/dist/commands/link.js +0 -6
  513. package/dist/commands/link.js.map +0 -1
  514. package/dist/commands/promote.d.ts +0 -6
  515. package/dist/commands/promote.d.ts.map +0 -1
  516. package/dist/commands/promote.js +0 -6
  517. package/dist/commands/promote.js.map +0 -1
  518. package/dist/commands/read.d.ts +0 -6
  519. package/dist/commands/read.d.ts.map +0 -1
  520. package/dist/commands/read.js +0 -4
  521. package/dist/commands/read.js.map +0 -1
  522. package/dist/commands/recall.d.ts +0 -6
  523. package/dist/commands/recall.d.ts.map +0 -1
  524. package/dist/commands/recall.js +0 -4
  525. package/dist/commands/recall.js.map +0 -1
  526. package/dist/commands/record.d.ts +0 -6
  527. package/dist/commands/record.d.ts.map +0 -1
  528. package/dist/commands/record.js +0 -4
  529. package/dist/commands/record.js.map +0 -1
  530. package/dist/commands/search.d.ts +0 -6
  531. package/dist/commands/search.d.ts.map +0 -1
  532. package/dist/commands/search.js +0 -4
  533. package/dist/commands/search.js.map +0 -1
  534. package/dist/commands/supersede.d.ts +0 -6
  535. package/dist/commands/supersede.d.ts.map +0 -1
  536. package/dist/commands/supersede.js +0 -6
  537. package/dist/commands/supersede.js.map +0 -1
  538. package/dist/knowledge/sources.d.ts +0 -72
  539. package/dist/knowledge/sources.d.ts.map +0 -1
  540. package/dist/knowledge/sources.js +0 -388
  541. package/dist/knowledge/sources.js.map +0 -1
  542. package/dist/setup/opencode-evidence.d.ts +0 -37
  543. package/dist/setup/opencode-evidence.d.ts.map +0 -1
  544. package/dist/setup/opencode-evidence.js +0 -58
  545. package/dist/setup/opencode-evidence.js.map +0 -1
  546. package/dist/setup/opencode-loop-guard.d.ts +0 -9
  547. package/dist/setup/opencode-loop-guard.d.ts.map +0 -1
  548. package/dist/setup/opencode-loop-guard.js +0 -248
  549. package/dist/setup/opencode-loop-guard.js.map +0 -1
package/README.zh-CN.md CHANGED
@@ -1,150 +1,136 @@
1
- # Kiokuko
1
+ # Kiokuko(记忆库)
2
2
 
3
3
  [English](README.md) | [日本語](README.ja.md) | 简体中文 | [한국어](README.ko.md)
4
4
 
5
- Kiokuko 是面向 AI 编程智能体、与模型无关的外部记忆工具。通过一次 npm 全局安装,它会将结构化记忆保存在当前操作系统用户的 SQLite 数据库中,并通过 native stdio MCP Codex、OpenCode、Claude Code 和 Hermes Agent 提供任务准备及 recall/checkpoint 工具。
5
+ **通过 MCP 连接、用 RAG 回忆,并在工作后保存记忆。**
6
6
 
7
- ## 全局安装与启用
7
+ Kiokuko 是面向 AI 编程智能体的外部记忆。
8
8
 
9
- 需要Node.js 24或更高版本。
9
+ 它会将过去工作中获得的知识保存到本地 SQLite,并在下一次请求中仅检索相关记忆传递给 AI。
10
10
 
11
- ```bash
12
- npm install --global @askdkc/kiokuko
13
- kiokuko setup
14
- ```
11
+ 用户无需每次都在提示词中粘贴过去的背景,也无需手动查找记忆。只需像平常一样使用 AI,项目特有的知识就会逐步积累,并在下一次工作中复用。
15
12
 
16
- 不带参数的 `setup` 会在 `PATH` 中检查每个受支持客户端(`codex`、`opencode`、`claude` 和 `hermes`)的可执行文件。在交互式终端中会显示选择列表,并预先勾选检测到的客户端。直接按 Enter 会接受当前选择;也可以输入以逗号分隔的客户端名称或编号来修改选择,输入 `none` 则不配置客户端。非交互终端或使用 `--json` 时不会显示提示,只配置检测到的客户端。检测到 `hermes` 时,Kiokuko 会通过 `hermes config path` 获取当前 profile;否则使用有效的 `active_profile` 标记或默认的 `$HOME/.hermes`。如果一个受支持的客户端都没有检测到,setup 仍会初始化数据库,但不会写入客户端配置。需要显式配置客户端时请使用 `--clients`;显式传入 `--clients` 时始终优先使用该选择。
13
+ ## 快速开始
17
14
 
18
- npm 包名是 `@askdkc/kiokuko`,安装后的 CLI 命令名仍然是 `kiokuko`。
19
-
20
- 设置完成后,请重启 setup 结果中显示的客户端。Hermes 的 `/reload-mcp` 可以重新加载 MCP 注册,但更新后的标准技能仍需要重启或新会话才能发现;可用 `hermes mcp test kiokuko` 做 smoke test。Hermes 使用有效 profile 中的原生 stdio MCP;Kiokuko 不会创建全局指令文件、Hermes plugin 或 hook。
21
-
22
- `setup` 是显式且幂等的操作。npm 的 `postinstall` 永远不会修改 AI 客户端配置。现有 TOML/JSON/JSONC/YAML 设置、注释、指令内容、换行符和文件权限都会保留;Kiokuko 只管理自己的区块。默认情况下,setup 还会从固定的本地清单安装 `kiokuko-ui-design-soul` 标准技能,不会在 setup 时下载或抓取 HIG 页面。
23
-
24
- 如果现有数据库存在尚未应用的迁移,setup 会先在当前用户数据目录下的 `backups/` 中创建备份并执行完整性检查。由更新版本 Kiokuko 写入的数据库会被拒绝,且不会受到修改。
15
+ 需要 Node.js 24.16 或更高版本。
16
+ 使用以下两条命令即可轻松开始 💕
25
17
 
26
18
  ```bash
27
- # 不写入任何内容,预览确切的目标文件和计划变更
28
- kiokuko setup --dry-run --json
29
-
30
- # 只配置一个客户端
31
- kiokuko setup --clients codex
32
- kiokuko setup --clients opencode
33
- kiokuko setup --clients claude
34
- kiokuko setup --clients hermes
35
-
36
- # 如果客户端进程未继承 npm 的 PATH,请使用可执行文件绝对路径
37
- kiokuko setup --command /absolute/path/to/kiokuko
38
-
39
- # 跳过新的标准技能放置;不会删除已安装的副本
40
- kiokuko setup --no-standard-skills
19
+ npm install --global @askdkc/kiokuko
20
+ kiokuko setup
41
21
  ```
42
22
 
43
- Hermes 设置按 profile 隔离。像 `$HOME/.hermes/profiles/work/config.yaml` 这样的 named profile 只接收该 profile 的 MCP 配置和标准技能,root 及非活动 profile 不会被修改。另一个进程中临时使用的 `hermes -p <name>` 不会被 setup 自动推断。要明确指定 named profile,请将 profile 目录传给 `HERMES_HOME`:
44
-
45
- ```bash
46
- HERMES_HOME="$HOME/.hermes/profiles/work" kiokuko setup --clients hermes
23
+ `setup` 会检测已安装的受支持客户端,并自动配置 SQLite 数据库和 MCP 连接。
24
+ 交互式setup会询问是否也将已审计的community技能用作参考资料,默认选择“否”。
25
+ 面向模型的记忆只能通过带 capability gate 的 MCP 工具 `task_prepare` 和
26
+ `task_answer` 进入任务。Kiokuko 不会安装在这些调用之前静默检索记忆的客户端
27
+ Hook 或插件。
28
+
29
+ 设置完成后,启动目标 AI 客户端即可像平时一样使用。如果客户端已经启动,请先退出,再重新启动。
30
+
31
+ 支持的客户端:
32
+
33
+ - Codex
34
+ - OpenCode
35
+ - Claude Code
36
+ - Hermes Agent
37
+
38
+ ## 越用越聪明的机制
39
+
40
+ ```text
41
+ 用户的请求
42
+
43
+ 搜索相关的过去记忆
44
+
45
+ AI 参考这些记忆开展工作
46
+
47
+ 保存可复用的成果或经验
48
+
49
+ 在下一次请求中再次搜索
47
50
  ```
48
51
 
49
- 如果桌面进程无法通过 `PATH` 找到 `kiokuko`,不要传入空的 `command -v` 结果,而应迁移到绝对路径:
52
+ Kiokuko 会重复以下流程。
50
53
 
51
- ```bash
52
- KIOKUKO_BIN="$(command -v kiokuko)"
53
- test -n "$KIOKUKO_BIN" && test -x "$KIOKUKO_BIN" || { echo "kiokuko executable not found" >&2; exit 1; }
54
- kiokuko setup --clients hermes --command "$KIOKUKO_BIN"
55
- ```
56
-
57
- 设置目标如下:
54
+ 1. 工作前,搜索当前项目和 Global 记忆
55
+ 2. 仅将相关性高的记忆传递给 AI
56
+ 3. AI 执行工作
57
+ 4. 工作后,保存可复用的知识作为记忆
58
+ 5. 在下一次工作中复用这些记忆
58
59
 
59
- | 客户端 | MCP 配置 | 全局指令 | 运行时防护 | 标准技能 |
60
- |---|---|---|---|---|
61
- | Codex | `$CODEX_HOME/config.toml` 或 `~/.codex/config.toml` | `$CODEX_HOME/AGENTS.md` 或 `~/.codex/AGENTS.md` | — | `~/.agents/skills/kiokuko-ui-design-soul` |
62
- | OpenCode | `$XDG_CONFIG_HOME/opencode/opencode.json` 或 `~/.config/opencode/opencode.json` | 同目录下的 `AGENTS.md` | `plugins/kiokuko-loop-guard.js` | 全局配置中的 `skills/kiokuko-ui-design-soul` |
63
- | Claude Code | `$CLAUDE_CONFIG_DIR/.claude.json` 或 `~/.claude.json` | `$CLAUDE_CONFIG_DIR/CLAUDE.md` 或 `~/.claude/CLAUDE.md` | — | Claude 配置中的 `skills/kiokuko-ui-design-soul` |
64
- | Hermes Agent | 有效 profile 的 `config.yaml`(`$HERMES_HOME`、`$HOME/.hermes` 或 `%LOCALAPPDATA%/hermes`) | 无 | 无 | 有效 profile 中的 `skills/kiokuko-ui-design-soul` |
60
+ 也就是说,Kiokuko 是一个**不断积累持久记忆的 RAG 系统**。
65
61
 
66
- Hermes 配置是 profile 级别的 native stdio MCP,注册 `mcp_servers.kiokuko`,其中 `command: kiokuko`、`args: [mcp]`。受管理的 canonical entry 可以通过 `--command` 只迁移 command,同时保留 args、注释和其他 server;未管理 entry、额外 field 或非 `mcp` args 仍然会产生 conflict。Hermes 内置 memory 和 skills 与 Kiokuko 分离;模型是否使用这些 MCP 工具取决于 MCP tool descriptions,属于 best effort
62
+ MCP AI 客户端与 Kiokuko 连接起来,RAG 则检索所需记忆并传递给 AI
67
63
 
68
- 如果 OpenCode 的 `opencode.jsonc` 已存在,Kiokuko 会保留注释并更新该文件。如果 Codex 中已存在不受 Kiokuko 管理的 `[mcp_servers.kiokuko]` 表,设置程序不会猜测应该覆盖哪项配置,而是直接停止。受管理的 OpenCode 防护会把可见智能体限制为 12 个 step;每个用户请求最多调用一次 `task_prepare` 和一次 `memory_checkpoint`;检查点完成后关闭工具阶段;连续三次出现相同调用或相同的只读检索结果后阻止再次执行。计数器和指纹仅保存在进程内存中。
64
+ ## 记忆按项目分离
69
65
 
70
- 每个标准技能文件都带有 Kiokuko 管理标记。setup 只更新固定的已知文件,完全相同时报告 `unchanged`,并保留无关的同级文件。如果同名文件没有管理标记,setup 会在任何文件或数据库写入前以 `CONFLICT` 停止。
66
+ 普通搜索不会混入无关项目的记忆。
71
67
 
72
- ## 记忆作用域
68
+ - **Project 记忆**
69
+ 仅在当前仓库中使用的知识
73
70
 
74
- 数据库由当前操作系统用户全局共享,但普通 recall 不会搜索整个全局数据库:
71
+ - **Global 记忆**
72
+ 可在多个项目中复用的知识,例如语言、框架、数据库和工具
75
73
 
76
- - `project` 记忆会根据 `.kiokuko.json`、已知规范路径或 Git remote 自动解析。其他项目的记忆会被排除。
77
- - `global` 记忆仅用于真正跨项目适用的偏好和经验。
78
- - 默认的 `auto` recall 只返回当前项目与 global 记忆。
79
- - 没有 remote 的仓库会获得由路径派生的稳定标识。自动解析时,Kiokuko 不会向仓库写入任何文件。
74
+ 项目会根据 Git remote 或路径自动判断。
80
75
 
81
- MCP 接口被有意保持为最小范围:
76
+ 如果要将 Project 记忆迁移到 Global 记忆,请通过 Curator 确认候选项并明确批准。
82
77
 
83
- - `task_prepare`:每个用户请求仅执行一次 Akinator 式采集、有界记忆/参考检索,并与当前客户端提供的技能和 MCP 工具名称进行匹配。
84
- - `task_answer`:仅使用用户请求或已验证仓库证据支持的答案继续采集。
85
- - `memory_recall`:读取有界的 project/global 上下文,并始终标记为 untrusted。
86
- - `memory_checkpoint`:在用户请求结束时仅执行一次,将有界的持久性条目保存为 `candidate` 和 `untrusted`;疑似密钥的内容会被拒绝。
78
+ ```bash
79
+ kiokuko curator
80
+ ```
87
81
 
88
- 这种自动使用由指令驱动,并不会拦截提示词。Codex、OpenCode、Claude Code 和 Hermes Agent 仍可能决定在某个回合不调用工具;Hermes 的自动/模型使用是基于 MCP tool descriptions 的 best effort。Hermes 内置 memory 和 skills 保持独立。Kiokuko 不会创建 Hermes 全局指令文件、plugin 或 hook,不会捕获完整对话、自动安装外部获取的技能,也不会静默地将记忆提升为 verified 状态。OpenCode 唯一安装的 plugin 是上述受限的本地循环防护;同捆标准技能是客户端原生 skill,不是 plugin。
82
+ ## 查看记忆
89
83
 
90
- ## 开发
84
+ 通过本地 Web UI,可以搜索、查看和编辑已保存的记忆。
91
85
 
92
86
  ```bash
93
- npm install
94
- npm run typecheck
95
- npm test
96
- npm run build
97
- npm pack --dry-run
87
+ kiokuko web
98
88
  ```
99
89
 
100
- ## 开发环境用法
90
+ 请在浏览器中打开以下地址。
101
91
 
102
- ```bash
103
- npm exec -- tsx src/bin/kiokuko.ts setup --dry-run --json
104
- npm exec -- tsx src/bin/kiokuko.ts mcp
92
+ ```text
93
+ http://127.0.0.1:4173
105
94
  ```
106
95
 
107
- `kiokuko use` 仍可作为可选功能,用于创建可移植的显式绑定。它会创建 `.kiokuko.json` 和 `AGENTS.md` 中的托管区块;普通 MCP 使用不再需要它。
96
+ Web UI 仅在本地环境运行,不会暴露到外部网络。
97
+ Web UI 和显式 memory CLI 命令是供人类/operator使用的管理界面,不是模型绕过
98
+ `task_prepare` / `task_answer` 获取任务记忆的路径。
108
99
 
109
- ## Akinator 式知识采集
100
+ ## 外部技能
110
101
 
111
- 对于重要工作,设置好的智能体指令会调用 `task_prepare`。该工具只询问任务类型、目标和成功条件等缺失的高价值字段,再根据查询和角色与用途标签选择本地记忆。如果客户端提供当前可用的技能和 MCP 工具名称,结果还会匹配所需能力,并区分 `available`、`missing` 和 `unknown`;该目录仅临时使用,不会存储。CLI 的 `guide` 命令可手动执行同一流程:
102
+ 外部技能发现仅用于参考数据,Akinator任务准备默认使用 `official` 模式。Kiokuko会
103
+ 验证当前GitHub提交,将有界内容保存为不可信候选记忆,并且不会自动安装或执行。
104
+ 如需关闭自动发现,请设置 `KIOKUKO_SKILL_DISCOVERY=off`;`community` 仍须明确启用。
105
+ 交互式 `kiokuko setup` 会询问是否启用;批处理可使用 `--skill-discovery community`。
112
106
 
113
- 当任务包含 UI、UX、frontend、screen、SwiftUI、画面或 accessibility 等具体界面词汇时,`task_prepare` 会明确推荐客户端 capability 目录中的 `kiokuko-ui-design-soul`。仅有通用 `design`、backend-only 工作或纯图像生成不会触发该规则。
107
+ 命令示例:
114
108
 
115
109
  ```bash
116
- kiokuko guide start "Implement the API change and add tests" \
117
- --workspace <workspace> --json
118
- kiokuko guide answer <session-id> --workspace <workspace> \
119
- --question-id target --value src/api.ts --json
120
- kiokuko guide answer <session-id> --workspace <workspace> \
121
- --question-id expected --value "All tests pass" --json
122
- kiokuko guide context <session-id> --workspace <workspace> --json
110
+ kiokuko skills find svelte --official-only --json
111
+ kiokuko skills list
112
+ kiokuko skills disable sveltejs/ai-tools/svelte-code-writer
113
+ kiokuko skills refresh sveltejs/ai-tools/svelte-code-writer
123
114
  ```
124
115
 
125
- 只有在本地检索没有相关条目,且客户端明确报告可用技能为零时,`task_prepare` 才能从以下唯一白名单公开仓库获取当前 `main` 分支树:
126
-
127
- - https://github.com/mattpocock/skills
116
+ Web UI的外部技能页面可查看来源状态并禁用或重新启用导入映射;其中没有安装、脚本
117
+ 执行或MCP注册操作。
128
118
 
129
- 省略 capability 目录表示“未知”而不是零,并会禁用该回退;存在任何技能也会禁用它。手动 CLI 使用必须通过 `guide context ... --no-client-skills` 明确声明同一条件。标记为 `disable-model-invocation: true` 的技能不会被自动选择。
119
+ ## 安全性
130
120
 
131
- 每个导入条目都会记录其仓库、commit SHA 和源路径。这些内容是不受信任的参考资料,永远不会自动提升为 `verified`,也不会作为命令执行。重复同步通过内容哈希保持幂等。
121
+ Kiokuko 不会保存完整对话。
132
122
 
133
- ## 本地 Web UI
123
+ 对于密码、API 密钥、令牌、私钥等看起来像机密的内容,会拒绝保存。
134
124
 
135
- 启动仅限回环地址的 HTTP 服务器,即可按角色与用途、记忆类型和跨类别标签浏览记忆条目,并在浏览器中编辑 candidate 条目:
125
+ 保存的记忆始终作为参考信息处理。当前代码、配置和执行结果优先于过去的记忆。
136
126
 
137
- ```bash
138
- kiokuko web
139
- # 打开 http://127.0.0.1:4173
140
- ```
141
-
142
- UI支持英语、日语、简体中文和韩语。首次使用时采用浏览器语言,明确选择的语言会保存在浏览器中;也可以使用`?lang=en`、`?lang=ja`、`?lang=zh-CN`或`?lang=ko`覆盖。
127
+ ## 注意
143
128
 
144
- 使用 `--port 0` 可自动选择可用端口,使用 `--json` 可将所选 URL 以 JSON 输出。Web UI 不会在非回环接口上公开服务器。verified 和 superseded 条目为只读;编辑 candidate 时会使用乐观修订检查,并保留审计记录。
129
+ Kiokuko 不是拦截提示词的机制。由于自动使用依赖于各 AI 客户端和模型对 MCP 的调用,因此不保证每一轮都会调用。
145
130
 
146
- `bot:researcher`、`bot:builder` 和 `bot:reviewer` 等标签可以作为跨类型筛选器。点击条目或侧边栏中的标签,会显示所有匹配条目,而不受记忆类型限制。
131
+ 详细命令请查看以下内容。
147
132
 
148
- 记忆条目是未经信任的存储数据。依赖历史条目前,请验证当前文件和运行时状态。切勿存储密码、API 密钥、令牌、私钥或会话 Cookie。
149
-
150
- 本仓库不会自动发布。执行 `npm publish`、commit 和 push 均需要用户明确授权。
133
+ ```bash
134
+ kiokuko --help
135
+ kiokuko setup --help
136
+ ```
@@ -1,6 +1,93 @@
1
- export declare function readRegularFile(filePath: string): Promise<{
1
+ import { chmod, type FileHandle } from 'node:fs/promises';
2
+ export interface FileIdentity {
3
+ device: bigint;
4
+ inode: bigint;
5
+ }
6
+ export interface RegularFileSnapshot {
2
7
  content: string;
3
8
  mode: number;
4
- } | undefined>;
5
- export declare function atomicWriteText(filePath: string, content: string, mode?: number): Promise<void>;
9
+ identity: FileIdentity;
10
+ }
11
+ export interface FileExpectation {
12
+ expected: RegularFileSnapshot | undefined;
13
+ /** Paths whose absence is part of the same decision (for example an alternate config path). */
14
+ mustRemainAbsent?: readonly string[];
15
+ /** Reject every symbolic-link component below this already-resolved root. */
16
+ containmentRoot?: string;
17
+ /** When present, the parent must preexist and retain this exact directory identity. */
18
+ expectedParentDirectory?: FileIdentity;
19
+ }
20
+ export declare class AtomicCleanupFailure extends Error {
21
+ /** Exact pathname of the owned artifact, when its full binding was proven after the failure. */
22
+ readonly artifactPath: string | undefined;
23
+ constructor(
24
+ /** Exact pathname of the owned artifact, when its full binding was proven after the failure. */
25
+ artifactPath: string | undefined, options: {
26
+ cause: unknown;
27
+ });
28
+ }
29
+ export interface AtomicWriteResult {
30
+ installed: RegularFileSnapshot;
31
+ cleanupFailures: readonly AtomicCleanupFailure[];
32
+ }
33
+ export interface AtomicUnlinkResult {
34
+ cleanupFailures: readonly AtomicCleanupFailure[];
35
+ }
36
+ export declare class AtomicCommittedMutationError extends AggregateError {
37
+ readonly outcome: AtomicWriteResult;
38
+ readonly operationError: unknown;
39
+ constructor(outcome: AtomicWriteResult, operationError: unknown);
40
+ }
41
+ export declare class AtomicCommittedUnlinkError extends AggregateError {
42
+ readonly outcome: AtomicUnlinkResult;
43
+ readonly operationError: unknown;
44
+ constructor(outcome: AtomicUnlinkResult, operationError: unknown);
45
+ }
46
+ export declare function assertAtomicCleanupComplete(result: Pick<AtomicWriteResult | AtomicUnlinkResult, 'cleanupFailures'>): void;
47
+ export interface AtomicWriteDependencies {
48
+ chmod?: typeof chmod;
49
+ beforeLink?: (source: string, destination: string) => void | Promise<void>;
50
+ afterLink?: (source: string, destination: string) => void | Promise<void>;
51
+ beforeRename?: (source: string, destination: string) => void | Promise<void>;
52
+ afterRename?: (source: string, destination: string) => void | Promise<void>;
53
+ beforeCleanup?: (artifactPath: string) => void | Promise<void>;
54
+ beforeCommit?: (filePath: string) => void | Promise<void>;
55
+ afterQuarantine?: (filePath: string) => void | Promise<void>;
56
+ afterInstall?: (filePath: string) => void | Promise<void>;
57
+ }
58
+ export interface ReadRegularFileDependencies {
59
+ /** Test seam for proving that reads remain bound to the opened descriptor. */
60
+ afterOpen?: (filePath: string, handle: FileHandle) => void | Promise<void>;
61
+ /** Test seam for preserving an operation failure when descriptor close also fails. */
62
+ closeHandle?: (handle: FileHandle) => Promise<void>;
63
+ /** Test seam for exercising the Windows no-O_NOFOLLOW strategy on any host. */
64
+ platform?: NodeJS.Platform;
65
+ }
66
+ export interface ConditionalUnlinkDependencies {
67
+ beforeRename?: (source: string, destination: string) => void | Promise<void>;
68
+ afterRename?: (source: string, destination: string) => void | Promise<void>;
69
+ beforeCleanup?: (artifactPath: string) => void | Promise<void>;
70
+ beforeCommit?: (filePath: string) => void | Promise<void>;
71
+ }
72
+ export declare function readRegularFile(filePath: string, dependencies?: ReadRegularFileDependencies & {
73
+ containmentRoot?: string;
74
+ }): Promise<RegularFileSnapshot | undefined>;
75
+ /** Read an exact directory identity without following its final path component. */
76
+ export declare function readDirectoryIdentity(directoryPath: string): Promise<FileIdentity | undefined>;
77
+ export interface PendingAtomicMutation {
78
+ kind: 'deleted' | 'previous' | 'rollback';
79
+ snapshot: RegularFileSnapshot;
80
+ }
81
+ /**
82
+ * Bind a native atomic-write quarantine for this exact basename without
83
+ * following path components. Its snapshot may constrain convergence, but it
84
+ * never grants the caller ownership of the artifact.
85
+ */
86
+ export declare function readPendingAtomicMutation(filePath: string, expectedParentDirectory: FileIdentity, containmentRoot?: string): Promise<PendingAtomicMutation | undefined>;
87
+ export declare function assertFileExpectation(filePath: string, expectation: FileExpectation): Promise<void>;
88
+ export declare function atomicWriteText(filePath: string, content: string, mode?: number, dependencyOverrides?: AtomicWriteDependencies): Promise<AtomicWriteResult>;
89
+ /** Write only when the target is still the exact file observed at planning time. */
90
+ export declare function atomicWriteTextIfUnchanged(filePath: string, content: string, expectation: FileExpectation, mode?: number, dependencyOverrides?: AtomicWriteDependencies): Promise<AtomicWriteResult>;
91
+ /** Delete only when the target is still the exact planned file identity and content. */
92
+ export declare function unlinkRegularFileIfUnchanged(filePath: string, expectation: FileExpectation, dependencyOverrides?: ConditionalUnlinkDependencies): Promise<AtomicUnlinkResult>;
6
93
  //# sourceMappingURL=atomic-write.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/agent-file/atomic-write.ts"],"names":[],"mappings":"AAKA,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAU9G;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,SAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAcpG"}
1
+ {"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/agent-file/atomic-write.ts"],"names":[],"mappings":"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"}