openryoko 2026.10.8 → 2026.10.13

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 (691) hide show
  1. package/dist/bin/jimmy.js +51 -1
  2. package/dist/bin/jimmy.js.map +1 -1
  3. package/dist/package.json +2 -1
  4. package/dist/src/backup/archive.d.ts +65 -0
  5. package/dist/src/backup/archive.d.ts.map +1 -0
  6. package/dist/src/backup/archive.js +214 -0
  7. package/dist/src/backup/archive.js.map +1 -0
  8. package/dist/src/backup/catalog.d.ts +64 -0
  9. package/dist/src/backup/catalog.d.ts.map +1 -0
  10. package/dist/src/backup/catalog.js +252 -0
  11. package/dist/src/backup/catalog.js.map +1 -0
  12. package/dist/src/backup/database-restore.d.ts +63 -0
  13. package/dist/src/backup/database-restore.d.ts.map +1 -0
  14. package/dist/src/backup/database-restore.js +236 -0
  15. package/dist/src/backup/database-restore.js.map +1 -0
  16. package/dist/src/backup/database-source.d.ts +70 -0
  17. package/dist/src/backup/database-source.d.ts.map +1 -0
  18. package/dist/src/backup/database-source.js +70 -0
  19. package/dist/src/backup/database-source.js.map +1 -0
  20. package/dist/src/backup/format.d.ts +4 -0
  21. package/dist/src/backup/format.d.ts.map +1 -0
  22. package/dist/src/backup/format.js +15 -0
  23. package/dist/src/backup/format.js.map +1 -0
  24. package/dist/src/backup/gateway-liveness.d.ts +44 -0
  25. package/dist/src/backup/gateway-liveness.d.ts.map +1 -0
  26. package/dist/src/backup/gateway-liveness.js +120 -0
  27. package/dist/src/backup/gateway-liveness.js.map +1 -0
  28. package/dist/src/backup/inspect.d.ts +45 -0
  29. package/dist/src/backup/inspect.d.ts.map +1 -0
  30. package/dist/src/backup/inspect.js +291 -0
  31. package/dist/src/backup/inspect.js.map +1 -0
  32. package/dist/src/backup/layout.d.ts +11 -0
  33. package/dist/src/backup/layout.d.ts.map +1 -0
  34. package/dist/src/backup/layout.js +16 -0
  35. package/dist/src/backup/layout.js.map +1 -0
  36. package/dist/src/backup/limits.d.ts +54 -0
  37. package/dist/src/backup/limits.d.ts.map +1 -0
  38. package/dist/src/backup/limits.js +59 -0
  39. package/dist/src/backup/limits.js.map +1 -0
  40. package/dist/src/backup/manifest.d.ts +45 -0
  41. package/dist/src/backup/manifest.d.ts.map +1 -0
  42. package/dist/src/backup/manifest.js +77 -0
  43. package/dist/src/backup/manifest.js.map +1 -0
  44. package/dist/src/backup/restore.d.ts +73 -0
  45. package/dist/src/backup/restore.d.ts.map +1 -0
  46. package/dist/src/backup/restore.js +685 -0
  47. package/dist/src/backup/restore.js.map +1 -0
  48. package/dist/src/backup/run.d.ts +76 -0
  49. package/dist/src/backup/run.d.ts.map +1 -0
  50. package/dist/src/backup/run.js +181 -0
  51. package/dist/src/backup/run.js.map +1 -0
  52. package/dist/src/backup/scheduler.d.ts +51 -0
  53. package/dist/src/backup/scheduler.d.ts.map +1 -0
  54. package/dist/src/backup/scheduler.js +198 -0
  55. package/dist/src/backup/scheduler.js.map +1 -0
  56. package/dist/src/backup/settings.d.ts +44 -0
  57. package/dist/src/backup/settings.d.ts.map +1 -0
  58. package/dist/src/backup/settings.js +91 -0
  59. package/dist/src/backup/settings.js.map +1 -0
  60. package/dist/src/backup/space.d.ts +22 -0
  61. package/dist/src/backup/space.d.ts.map +1 -0
  62. package/dist/src/backup/space.js +47 -0
  63. package/dist/src/backup/space.js.map +1 -0
  64. package/dist/src/backup/state.d.ts +46 -0
  65. package/dist/src/backup/state.d.ts.map +1 -0
  66. package/dist/src/backup/state.js +137 -0
  67. package/dist/src/backup/state.js.map +1 -0
  68. package/dist/src/backup/tar.d.ts +64 -0
  69. package/dist/src/backup/tar.d.ts.map +1 -0
  70. package/dist/src/backup/tar.js +274 -0
  71. package/dist/src/backup/tar.js.map +1 -0
  72. package/dist/src/backup/targets.d.ts +85 -0
  73. package/dist/src/backup/targets.d.ts.map +1 -0
  74. package/dist/src/backup/targets.js +104 -0
  75. package/dist/src/backup/targets.js.map +1 -0
  76. package/dist/src/backup/walk.d.ts +42 -0
  77. package/dist/src/backup/walk.d.ts.map +1 -0
  78. package/dist/src/backup/walk.js +324 -0
  79. package/dist/src/backup/walk.js.map +1 -0
  80. package/dist/src/cli/backup.d.ts +45 -0
  81. package/dist/src/cli/backup.d.ts.map +1 -0
  82. package/dist/src/cli/backup.js +344 -0
  83. package/dist/src/cli/backup.js.map +1 -0
  84. package/dist/src/cli/bundled-skills.d.ts +7 -1
  85. package/dist/src/cli/bundled-skills.d.ts.map +1 -1
  86. package/dist/src/cli/bundled-skills.js +12 -2
  87. package/dist/src/cli/bundled-skills.js.map +1 -1
  88. package/dist/src/cli/config-failure.d.ts +18 -0
  89. package/dist/src/cli/config-failure.d.ts.map +1 -0
  90. package/dist/src/cli/config-failure.js +39 -0
  91. package/dist/src/cli/config-failure.js.map +1 -0
  92. package/dist/src/cli/gateway-audit.d.ts +3 -0
  93. package/dist/src/cli/gateway-audit.d.ts.map +1 -1
  94. package/dist/src/cli/gateway-audit.js +61 -14
  95. package/dist/src/cli/gateway-audit.js.map +1 -1
  96. package/dist/src/cli/gateway-url-backup.d.ts +21 -0
  97. package/dist/src/cli/gateway-url-backup.d.ts.map +1 -0
  98. package/dist/src/cli/gateway-url-backup.js +87 -0
  99. package/dist/src/cli/gateway-url-backup.js.map +1 -0
  100. package/dist/src/cli/home-copy.d.ts +37 -0
  101. package/dist/src/cli/home-copy.d.ts.map +1 -0
  102. package/dist/src/cli/home-copy.js +155 -0
  103. package/dist/src/cli/home-copy.js.map +1 -0
  104. package/dist/src/cli/interactive-config.d.ts +5 -0
  105. package/dist/src/cli/interactive-config.d.ts.map +1 -1
  106. package/dist/src/cli/interactive-config.js +16 -7
  107. package/dist/src/cli/interactive-config.js.map +1 -1
  108. package/dist/src/cli/migrate.d.ts +20 -0
  109. package/dist/src/cli/migrate.d.ts.map +1 -1
  110. package/dist/src/cli/migrate.js +365 -68
  111. package/dist/src/cli/migrate.js.map +1 -1
  112. package/dist/src/cli/migration-declarations.d.ts +24 -0
  113. package/dist/src/cli/migration-declarations.d.ts.map +1 -0
  114. package/dist/src/cli/migration-declarations.js +54 -0
  115. package/dist/src/cli/migration-declarations.js.map +1 -0
  116. package/dist/src/cli/start.d.ts.map +1 -1
  117. package/dist/src/cli/start.js +40 -1
  118. package/dist/src/cli/start.js.map +1 -1
  119. package/dist/src/connectors/chunked-send.d.ts +27 -0
  120. package/dist/src/connectors/chunked-send.d.ts.map +1 -0
  121. package/dist/src/connectors/chunked-send.js +40 -0
  122. package/dist/src/connectors/chunked-send.js.map +1 -0
  123. package/dist/src/connectors/cron/index.d.ts +10 -0
  124. package/dist/src/connectors/cron/index.d.ts.map +1 -1
  125. package/dist/src/connectors/cron/index.js +26 -3
  126. package/dist/src/connectors/cron/index.js.map +1 -1
  127. package/dist/src/connectors/discord/attachments.d.ts +25 -0
  128. package/dist/src/connectors/discord/attachments.d.ts.map +1 -0
  129. package/dist/src/connectors/discord/attachments.js +33 -0
  130. package/dist/src/connectors/discord/attachments.js.map +1 -0
  131. package/dist/src/connectors/discord/format.d.ts +17 -1
  132. package/dist/src/connectors/discord/format.d.ts.map +1 -1
  133. package/dist/src/connectors/discord/format.js +36 -6
  134. package/dist/src/connectors/discord/format.js.map +1 -1
  135. package/dist/src/connectors/discord/index.d.ts +12 -0
  136. package/dist/src/connectors/discord/index.d.ts.map +1 -1
  137. package/dist/src/connectors/discord/index.js +47 -40
  138. package/dist/src/connectors/discord/index.js.map +1 -1
  139. package/dist/src/connectors/discord/remote.d.ts +45 -1
  140. package/dist/src/connectors/discord/remote.d.ts.map +1 -1
  141. package/dist/src/connectors/discord/remote.js +147 -22
  142. package/dist/src/connectors/discord/remote.js.map +1 -1
  143. package/dist/src/connectors/slack/attachments.d.ts +25 -0
  144. package/dist/src/connectors/slack/attachments.d.ts.map +1 -0
  145. package/dist/src/connectors/slack/attachments.js +32 -0
  146. package/dist/src/connectors/slack/attachments.js.map +1 -0
  147. package/dist/src/connectors/slack/auth-test-cache.d.ts +22 -0
  148. package/dist/src/connectors/slack/auth-test-cache.d.ts.map +1 -0
  149. package/dist/src/connectors/slack/auth-test-cache.js +34 -0
  150. package/dist/src/connectors/slack/auth-test-cache.js.map +1 -0
  151. package/dist/src/connectors/slack/format.d.ts +6 -1
  152. package/dist/src/connectors/slack/format.d.ts.map +1 -1
  153. package/dist/src/connectors/slack/format.js +65 -13
  154. package/dist/src/connectors/slack/format.js.map +1 -1
  155. package/dist/src/connectors/slack/index.d.ts +4 -0
  156. package/dist/src/connectors/slack/index.d.ts.map +1 -1
  157. package/dist/src/connectors/slack/index.js +64 -52
  158. package/dist/src/connectors/slack/index.js.map +1 -1
  159. package/dist/src/connectors/slack/provider-auth-blocks.d.ts +62 -0
  160. package/dist/src/connectors/slack/provider-auth-blocks.d.ts.map +1 -0
  161. package/dist/src/connectors/slack/provider-auth-blocks.js +204 -0
  162. package/dist/src/connectors/slack/provider-auth-blocks.js.map +1 -0
  163. package/dist/src/connectors/slack/provider-auth.d.ts +126 -0
  164. package/dist/src/connectors/slack/provider-auth.d.ts.map +1 -0
  165. package/dist/src/connectors/slack/provider-auth.js +357 -0
  166. package/dist/src/connectors/slack/provider-auth.js.map +1 -0
  167. package/dist/src/connectors/telegram/index.d.ts +5 -0
  168. package/dist/src/connectors/telegram/index.d.ts.map +1 -1
  169. package/dist/src/connectors/telegram/index.js +14 -22
  170. package/dist/src/connectors/telegram/index.js.map +1 -1
  171. package/dist/src/connectors/whatsapp/index.d.ts +3 -0
  172. package/dist/src/connectors/whatsapp/index.d.ts.map +1 -1
  173. package/dist/src/connectors/whatsapp/index.js +33 -14
  174. package/dist/src/connectors/whatsapp/index.js.map +1 -1
  175. package/dist/src/cron/alert-throttle.d.ts +28 -0
  176. package/dist/src/cron/alert-throttle.d.ts.map +1 -0
  177. package/dist/src/cron/alert-throttle.js +106 -0
  178. package/dist/src/cron/alert-throttle.js.map +1 -0
  179. package/dist/src/cron/jobs.d.ts +8 -0
  180. package/dist/src/cron/jobs.d.ts.map +1 -1
  181. package/dist/src/cron/jobs.js +27 -1
  182. package/dist/src/cron/jobs.js.map +1 -1
  183. package/dist/src/cron/run-outcome.d.ts +28 -0
  184. package/dist/src/cron/run-outcome.d.ts.map +1 -0
  185. package/dist/src/cron/run-outcome.js +66 -0
  186. package/dist/src/cron/run-outcome.js.map +1 -0
  187. package/dist/src/cron/runner.d.ts.map +1 -1
  188. package/dist/src/cron/runner.js +68 -5
  189. package/dist/src/cron/runner.js.map +1 -1
  190. package/dist/src/cron/scheduler.d.ts +8 -1
  191. package/dist/src/cron/scheduler.d.ts.map +1 -1
  192. package/dist/src/cron/scheduler.js +11 -4
  193. package/dist/src/cron/scheduler.js.map +1 -1
  194. package/dist/src/cron/waiting-fires.d.ts +18 -0
  195. package/dist/src/cron/waiting-fires.d.ts.map +1 -0
  196. package/dist/src/cron/waiting-fires.js +49 -0
  197. package/dist/src/cron/waiting-fires.js.map +1 -0
  198. package/dist/src/engines/claude-interactive.d.ts +19 -3
  199. package/dist/src/engines/claude-interactive.d.ts.map +1 -1
  200. package/dist/src/engines/claude-interactive.js +42 -17
  201. package/dist/src/engines/claude-interactive.js.map +1 -1
  202. package/dist/src/engines/claude.d.ts.map +1 -1
  203. package/dist/src/engines/claude.js +38 -5
  204. package/dist/src/engines/claude.js.map +1 -1
  205. package/dist/src/engines/codex.d.ts.map +1 -1
  206. package/dist/src/engines/codex.js +1 -0
  207. package/dist/src/engines/codex.js.map +1 -1
  208. package/dist/src/engines/gemini.d.ts.map +1 -1
  209. package/dist/src/engines/gemini.js +1 -0
  210. package/dist/src/engines/gemini.js.map +1 -1
  211. package/dist/src/gateway/api.d.ts.map +1 -1
  212. package/dist/src/gateway/api.js +184 -160
  213. package/dist/src/gateway/api.js.map +1 -1
  214. package/dist/src/gateway/config-redaction.d.ts +32 -0
  215. package/dist/src/gateway/config-redaction.d.ts.map +1 -0
  216. package/dist/src/gateway/config-redaction.js +139 -0
  217. package/dist/src/gateway/config-redaction.js.map +1 -0
  218. package/dist/src/gateway/config-revision.d.ts +46 -0
  219. package/dist/src/gateway/config-revision.d.ts.map +1 -0
  220. package/dist/src/gateway/config-revision.js +63 -0
  221. package/dist/src/gateway/config-revision.js.map +1 -0
  222. package/dist/src/gateway/connector-config.d.ts +21 -0
  223. package/dist/src/gateway/connector-config.d.ts.map +1 -0
  224. package/dist/src/gateway/connector-config.js +24 -0
  225. package/dist/src/gateway/connector-config.js.map +1 -0
  226. package/dist/src/gateway/daemon-entry.js +5 -0
  227. package/dist/src/gateway/daemon-entry.js.map +1 -1
  228. package/dist/src/gateway/engine-health-monitor.d.ts +67 -0
  229. package/dist/src/gateway/engine-health-monitor.d.ts.map +1 -0
  230. package/dist/src/gateway/engine-health-monitor.js +221 -0
  231. package/dist/src/gateway/engine-health-monitor.js.map +1 -0
  232. package/dist/src/gateway/files.d.ts +7 -1
  233. package/dist/src/gateway/files.d.ts.map +1 -1
  234. package/dist/src/gateway/files.js +110 -217
  235. package/dist/src/gateway/files.js.map +1 -1
  236. package/dist/src/gateway/onboarding-personalize.d.ts +2 -0
  237. package/dist/src/gateway/onboarding-personalize.d.ts.map +1 -1
  238. package/dist/src/gateway/onboarding-personalize.js +17 -1
  239. package/dist/src/gateway/onboarding-personalize.js.map +1 -1
  240. package/dist/src/gateway/portal-config.d.ts +17 -3
  241. package/dist/src/gateway/portal-config.d.ts.map +1 -1
  242. package/dist/src/gateway/portal-config.js +52 -3
  243. package/dist/src/gateway/portal-config.js.map +1 -1
  244. package/dist/src/gateway/request-origin.d.ts +9 -0
  245. package/dist/src/gateway/request-origin.d.ts.map +1 -1
  246. package/dist/src/gateway/request-origin.js +10 -0
  247. package/dist/src/gateway/request-origin.js.map +1 -1
  248. package/dist/src/gateway/server.d.ts.map +1 -1
  249. package/dist/src/gateway/server.js +82 -59
  250. package/dist/src/gateway/server.js.map +1 -1
  251. package/dist/src/gateway/slack-connect-rollback.d.ts +23 -0
  252. package/dist/src/gateway/slack-connect-rollback.d.ts.map +1 -0
  253. package/dist/src/gateway/slack-connect-rollback.js +53 -0
  254. package/dist/src/gateway/slack-connect-rollback.js.map +1 -0
  255. package/dist/src/gateway/status-reconciler.d.ts +25 -7
  256. package/dist/src/gateway/status-reconciler.d.ts.map +1 -1
  257. package/dist/src/gateway/status-reconciler.js +86 -43
  258. package/dist/src/gateway/status-reconciler.js.map +1 -1
  259. package/dist/src/gateway/watcher.d.ts.map +1 -1
  260. package/dist/src/gateway/watcher.js +44 -3
  261. package/dist/src/gateway/watcher.js.map +1 -1
  262. package/dist/src/mcp/gateway-server.js +21 -3
  263. package/dist/src/mcp/gateway-server.js.map +1 -1
  264. package/dist/src/mcp/resolver.d.ts.map +1 -1
  265. package/dist/src/mcp/resolver.js +51 -1
  266. package/dist/src/mcp/resolver.js.map +1 -1
  267. package/dist/src/models/service.d.ts.map +1 -1
  268. package/dist/src/models/service.js +14 -8
  269. package/dist/src/models/service.js.map +1 -1
  270. package/dist/src/provider-auth/discovery.d.ts +16 -0
  271. package/dist/src/provider-auth/discovery.d.ts.map +1 -0
  272. package/dist/src/provider-auth/discovery.js +66 -0
  273. package/dist/src/provider-auth/discovery.js.map +1 -0
  274. package/dist/src/provider-auth/failure-notices.d.ts +29 -0
  275. package/dist/src/provider-auth/failure-notices.d.ts.map +1 -0
  276. package/dist/src/provider-auth/failure-notices.js +48 -0
  277. package/dist/src/provider-auth/failure-notices.js.map +1 -0
  278. package/dist/src/provider-auth/failure-signal.d.ts +22 -0
  279. package/dist/src/provider-auth/failure-signal.d.ts.map +1 -0
  280. package/dist/src/provider-auth/failure-signal.js +79 -0
  281. package/dist/src/provider-auth/failure-signal.js.map +1 -0
  282. package/dist/src/provider-auth/index.d.ts +26 -0
  283. package/dist/src/provider-auth/index.d.ts.map +1 -0
  284. package/dist/src/provider-auth/index.js +51 -0
  285. package/dist/src/provider-auth/index.js.map +1 -0
  286. package/dist/src/provider-auth/input.d.ts +44 -0
  287. package/dist/src/provider-auth/input.d.ts.map +1 -0
  288. package/dist/src/provider-auth/input.js +86 -0
  289. package/dist/src/provider-auth/input.js.map +1 -0
  290. package/dist/src/provider-auth/providers.d.ts +26 -0
  291. package/dist/src/provider-auth/providers.d.ts.map +1 -0
  292. package/dist/src/provider-auth/providers.js +86 -0
  293. package/dist/src/provider-auth/providers.js.map +1 -0
  294. package/dist/src/provider-auth/runtime.d.ts +21 -0
  295. package/dist/src/provider-auth/runtime.d.ts.map +1 -0
  296. package/dist/src/provider-auth/runtime.js +104 -0
  297. package/dist/src/provider-auth/runtime.js.map +1 -0
  298. package/dist/src/provider-auth/service.d.ts +70 -0
  299. package/dist/src/provider-auth/service.d.ts.map +1 -0
  300. package/dist/src/provider-auth/service.js +349 -0
  301. package/dist/src/provider-auth/service.js.map +1 -0
  302. package/dist/src/provider-auth/terminal.d.ts +21 -0
  303. package/dist/src/provider-auth/terminal.d.ts.map +1 -0
  304. package/dist/src/provider-auth/terminal.js +46 -0
  305. package/dist/src/provider-auth/terminal.js.map +1 -0
  306. package/dist/src/provider-auth/types.d.ts +123 -0
  307. package/dist/src/provider-auth/types.d.ts.map +1 -0
  308. package/dist/src/provider-auth/types.js +10 -0
  309. package/dist/src/provider-auth/types.js.map +1 -0
  310. package/dist/src/sessions/accounting.d.ts +3 -0
  311. package/dist/src/sessions/accounting.d.ts.map +1 -1
  312. package/dist/src/sessions/accounting.js +5 -0
  313. package/dist/src/sessions/accounting.js.map +1 -1
  314. package/dist/src/sessions/backup-integrity.d.ts +45 -0
  315. package/dist/src/sessions/backup-integrity.d.ts.map +1 -0
  316. package/dist/src/sessions/backup-integrity.js +122 -0
  317. package/dist/src/sessions/backup-integrity.js.map +1 -0
  318. package/dist/src/sessions/backup.d.ts +40 -2
  319. package/dist/src/sessions/backup.d.ts.map +1 -1
  320. package/dist/src/sessions/backup.js +88 -12
  321. package/dist/src/sessions/backup.js.map +1 -1
  322. package/dist/src/sessions/callbacks.d.ts +9 -0
  323. package/dist/src/sessions/callbacks.d.ts.map +1 -1
  324. package/dist/src/sessions/callbacks.js +55 -10
  325. package/dist/src/sessions/callbacks.js.map +1 -1
  326. package/dist/src/sessions/completion-batching.d.ts +82 -0
  327. package/dist/src/sessions/completion-batching.d.ts.map +1 -0
  328. package/dist/src/sessions/completion-batching.js +126 -0
  329. package/dist/src/sessions/completion-batching.js.map +1 -0
  330. package/dist/src/sessions/connector-command-guard.d.ts +66 -0
  331. package/dist/src/sessions/connector-command-guard.d.ts.map +1 -0
  332. package/dist/src/sessions/connector-command-guard.js +145 -0
  333. package/dist/src/sessions/connector-command-guard.js.map +1 -0
  334. package/dist/src/sessions/context.d.ts.map +1 -1
  335. package/dist/src/sessions/context.js +3 -4
  336. package/dist/src/sessions/context.js.map +1 -1
  337. package/dist/src/sessions/engine-fallback.d.ts +43 -1
  338. package/dist/src/sessions/engine-fallback.d.ts.map +1 -1
  339. package/dist/src/sessions/engine-fallback.js +266 -15
  340. package/dist/src/sessions/engine-fallback.js.map +1 -1
  341. package/dist/src/sessions/engine-health-gate.d.ts +83 -0
  342. package/dist/src/sessions/engine-health-gate.d.ts.map +1 -0
  343. package/dist/src/sessions/engine-health-gate.js +186 -0
  344. package/dist/src/sessions/engine-health-gate.js.map +1 -0
  345. package/dist/src/sessions/engine-login.d.ts +58 -0
  346. package/dist/src/sessions/engine-login.d.ts.map +1 -0
  347. package/dist/src/sessions/engine-login.js +107 -0
  348. package/dist/src/sessions/engine-login.js.map +1 -0
  349. package/dist/src/sessions/fork.d.ts.map +1 -1
  350. package/dist/src/sessions/fork.js +3 -1
  351. package/dist/src/sessions/fork.js.map +1 -1
  352. package/dist/src/sessions/goal-execution.d.ts.map +1 -1
  353. package/dist/src/sessions/goal-execution.js +8 -1
  354. package/dist/src/sessions/goal-execution.js.map +1 -1
  355. package/dist/src/sessions/limit-failure-notice.d.ts +41 -0
  356. package/dist/src/sessions/limit-failure-notice.d.ts.map +1 -0
  357. package/dist/src/sessions/limit-failure-notice.js +87 -0
  358. package/dist/src/sessions/limit-failure-notice.js.map +1 -0
  359. package/dist/src/sessions/lost-turn.d.ts +39 -0
  360. package/dist/src/sessions/lost-turn.d.ts.map +1 -0
  361. package/dist/src/sessions/lost-turn.js +32 -0
  362. package/dist/src/sessions/lost-turn.js.map +1 -0
  363. package/dist/src/sessions/manager.d.ts.map +1 -1
  364. package/dist/src/sessions/manager.js +104 -47
  365. package/dist/src/sessions/manager.js.map +1 -1
  366. package/dist/src/sessions/new-session-engine.d.ts +42 -0
  367. package/dist/src/sessions/new-session-engine.d.ts.map +1 -0
  368. package/dist/src/sessions/new-session-engine.js +100 -0
  369. package/dist/src/sessions/new-session-engine.js.map +1 -0
  370. package/dist/src/sessions/origin-delivery.d.ts +50 -4
  371. package/dist/src/sessions/origin-delivery.d.ts.map +1 -1
  372. package/dist/src/sessions/origin-delivery.js +108 -9
  373. package/dist/src/sessions/origin-delivery.js.map +1 -1
  374. package/dist/src/sessions/queue.d.ts +14 -0
  375. package/dist/src/sessions/queue.d.ts.map +1 -1
  376. package/dist/src/sessions/queue.js +38 -2
  377. package/dist/src/sessions/queue.js.map +1 -1
  378. package/dist/src/sessions/registry.d.ts +4 -2
  379. package/dist/src/sessions/registry.d.ts.map +1 -1
  380. package/dist/src/sessions/registry.js +21 -4
  381. package/dist/src/sessions/registry.js.map +1 -1
  382. package/dist/src/sessions/reply-disposition.d.ts +8 -0
  383. package/dist/src/sessions/reply-disposition.d.ts.map +1 -1
  384. package/dist/src/sessions/reply-disposition.js +8 -0
  385. package/dist/src/sessions/reply-disposition.js.map +1 -1
  386. package/dist/src/sessions/restart-resume.d.ts +234 -0
  387. package/dist/src/sessions/restart-resume.d.ts.map +1 -0
  388. package/dist/src/sessions/restart-resume.js +596 -0
  389. package/dist/src/sessions/restart-resume.js.map +1 -0
  390. package/dist/src/sessions/speaker-prefix.d.ts.map +1 -1
  391. package/dist/src/sessions/speaker-prefix.js +3 -1
  392. package/dist/src/sessions/speaker-prefix.js.map +1 -1
  393. package/dist/src/sessions/turn-delivery.d.ts +26 -0
  394. package/dist/src/sessions/turn-delivery.d.ts.map +1 -0
  395. package/dist/src/sessions/turn-delivery.js +34 -0
  396. package/dist/src/sessions/turn-delivery.js.map +1 -0
  397. package/dist/src/sessions/unrequested-stop.d.ts +26 -0
  398. package/dist/src/sessions/unrequested-stop.d.ts.map +1 -0
  399. package/dist/src/sessions/unrequested-stop.js +19 -0
  400. package/dist/src/sessions/unrequested-stop.js.map +1 -0
  401. package/dist/src/sessions/usage-limit-wait.d.ts +14 -0
  402. package/dist/src/sessions/usage-limit-wait.d.ts.map +1 -0
  403. package/dist/src/sessions/usage-limit-wait.js +9 -0
  404. package/dist/src/sessions/usage-limit-wait.js.map +1 -0
  405. package/dist/src/shared/attachment-download.d.ts +41 -0
  406. package/dist/src/shared/attachment-download.d.ts.map +1 -0
  407. package/dist/src/shared/attachment-download.js +110 -0
  408. package/dist/src/shared/attachment-download.js.map +1 -0
  409. package/dist/src/shared/attachment-notice.d.ts +24 -0
  410. package/dist/src/shared/attachment-notice.d.ts.map +1 -0
  411. package/dist/src/shared/attachment-notice.js +37 -0
  412. package/dist/src/shared/attachment-notice.js.map +1 -0
  413. package/dist/src/shared/attachments.d.ts +65 -0
  414. package/dist/src/shared/attachments.d.ts.map +1 -0
  415. package/dist/src/shared/attachments.js +153 -0
  416. package/dist/src/shared/attachments.js.map +1 -0
  417. package/dist/src/shared/childEnv.d.ts +15 -0
  418. package/dist/src/shared/childEnv.d.ts.map +1 -1
  419. package/dist/src/shared/childEnv.js +15 -0
  420. package/dist/src/shared/childEnv.js.map +1 -1
  421. package/dist/src/shared/claude-auto-memory.d.ts +33 -0
  422. package/dist/src/shared/claude-auto-memory.d.ts.map +1 -0
  423. package/dist/src/shared/claude-auto-memory.js +156 -0
  424. package/dist/src/shared/claude-auto-memory.js.map +1 -0
  425. package/dist/src/shared/claude-limit-reset.d.ts +54 -0
  426. package/dist/src/shared/claude-limit-reset.d.ts.map +1 -0
  427. package/dist/src/shared/claude-limit-reset.js +99 -0
  428. package/dist/src/shared/claude-limit-reset.js.map +1 -0
  429. package/dist/src/shared/config-error.d.ts +21 -0
  430. package/dist/src/shared/config-error.d.ts.map +1 -0
  431. package/dist/src/shared/config-error.js +37 -0
  432. package/dist/src/shared/config-error.js.map +1 -0
  433. package/dist/src/shared/config-file.d.ts +57 -0
  434. package/dist/src/shared/config-file.d.ts.map +1 -0
  435. package/dist/src/shared/config-file.js +217 -0
  436. package/dist/src/shared/config-file.js.map +1 -0
  437. package/dist/src/shared/config-yaml-edit.d.ts +20 -0
  438. package/dist/src/shared/config-yaml-edit.d.ts.map +1 -0
  439. package/dist/src/shared/config-yaml-edit.js +468 -0
  440. package/dist/src/shared/config-yaml-edit.js.map +1 -0
  441. package/dist/src/shared/config.d.ts.map +1 -1
  442. package/dist/src/shared/config.js +12 -4
  443. package/dist/src/shared/config.js.map +1 -1
  444. package/dist/src/shared/engine-fallback.d.ts +22 -0
  445. package/dist/src/shared/engine-fallback.d.ts.map +1 -1
  446. package/dist/src/shared/engine-fallback.js +55 -4
  447. package/dist/src/shared/engine-fallback.js.map +1 -1
  448. package/dist/src/shared/engine-health.d.ts +16 -0
  449. package/dist/src/shared/engine-health.d.ts.map +1 -1
  450. package/dist/src/shared/engine-health.js +42 -0
  451. package/dist/src/shared/engine-health.js.map +1 -1
  452. package/dist/src/shared/list-alignment.d.ts +23 -0
  453. package/dist/src/shared/list-alignment.d.ts.map +1 -0
  454. package/dist/src/shared/list-alignment.js +61 -0
  455. package/dist/src/shared/list-alignment.js.map +1 -0
  456. package/dist/src/shared/logger.d.ts.map +1 -1
  457. package/dist/src/shared/logger.js +104 -33
  458. package/dist/src/shared/logger.js.map +1 -1
  459. package/dist/src/shared/map-limited.d.ts +11 -0
  460. package/dist/src/shared/map-limited.d.ts.map +1 -0
  461. package/dist/src/shared/map-limited.js +30 -0
  462. package/dist/src/shared/map-limited.js.map +1 -0
  463. package/dist/src/shared/oneShotCli.d.ts.map +1 -1
  464. package/dist/src/shared/oneShotCli.js +4 -2
  465. package/dist/src/shared/oneShotCli.js.map +1 -1
  466. package/dist/src/shared/partial-delivery.d.ts +24 -0
  467. package/dist/src/shared/partial-delivery.d.ts.map +1 -0
  468. package/dist/src/shared/partial-delivery.js +46 -0
  469. package/dist/src/shared/partial-delivery.js.map +1 -0
  470. package/dist/src/shared/process-safety-net.d.ts +44 -0
  471. package/dist/src/shared/process-safety-net.d.ts.map +1 -0
  472. package/dist/src/shared/process-safety-net.js +88 -0
  473. package/dist/src/shared/process-safety-net.js.map +1 -0
  474. package/dist/src/shared/rateLimit.d.ts +45 -2
  475. package/dist/src/shared/rateLimit.d.ts.map +1 -1
  476. package/dist/src/shared/rateLimit.js +64 -2
  477. package/dist/src/shared/rateLimit.js.map +1 -1
  478. package/dist/src/shared/redact.d.ts.map +1 -1
  479. package/dist/src/shared/redact.js +11 -1
  480. package/dist/src/shared/redact.js.map +1 -1
  481. package/dist/src/shared/safe-file-name.d.ts +9 -0
  482. package/dist/src/shared/safe-file-name.d.ts.map +1 -0
  483. package/dist/src/shared/safe-file-name.js +16 -0
  484. package/dist/src/shared/safe-file-name.js.map +1 -0
  485. package/dist/src/shared/terminal-safe-text.d.ts +2 -0
  486. package/dist/src/shared/terminal-safe-text.d.ts.map +1 -0
  487. package/dist/src/shared/terminal-safe-text.js +21 -0
  488. package/dist/src/shared/terminal-safe-text.js.map +1 -0
  489. package/dist/src/shared/types.d.ts +75 -4
  490. package/dist/src/shared/types.d.ts.map +1 -1
  491. package/dist/src/skills-sync/apply.d.ts +21 -0
  492. package/dist/src/skills-sync/apply.d.ts.map +1 -0
  493. package/dist/src/skills-sync/apply.js +209 -0
  494. package/dist/src/skills-sync/apply.js.map +1 -0
  495. package/dist/src/skills-sync/backup-run.d.ts +47 -0
  496. package/dist/src/skills-sync/backup-run.d.ts.map +1 -0
  497. package/dist/src/skills-sync/backup-run.js +150 -0
  498. package/dist/src/skills-sync/backup-run.js.map +1 -0
  499. package/dist/src/skills-sync/bounded-read.d.ts +32 -0
  500. package/dist/src/skills-sync/bounded-read.d.ts.map +1 -0
  501. package/dist/src/skills-sync/bounded-read.js +104 -0
  502. package/dist/src/skills-sync/bounded-read.js.map +1 -0
  503. package/dist/src/skills-sync/bundled.d.ts +28 -0
  504. package/dist/src/skills-sync/bundled.d.ts.map +1 -0
  505. package/dist/src/skills-sync/bundled.js +84 -0
  506. package/dist/src/skills-sync/bundled.js.map +1 -0
  507. package/dist/src/skills-sync/fingerprint.d.ts +32 -0
  508. package/dist/src/skills-sync/fingerprint.d.ts.map +1 -0
  509. package/dist/src/skills-sync/fingerprint.js +58 -0
  510. package/dist/src/skills-sync/fingerprint.js.map +1 -0
  511. package/dist/src/skills-sync/history.d.ts +44 -0
  512. package/dist/src/skills-sync/history.d.ts.map +1 -0
  513. package/dist/src/skills-sync/history.js +115 -0
  514. package/dist/src/skills-sync/history.js.map +1 -0
  515. package/dist/src/skills-sync/home-skill.d.ts +28 -0
  516. package/dist/src/skills-sync/home-skill.d.ts.map +1 -0
  517. package/dist/src/skills-sync/home-skill.js +67 -0
  518. package/dist/src/skills-sync/home-skill.js.map +1 -0
  519. package/dist/src/skills-sync/instance.d.ts +26 -0
  520. package/dist/src/skills-sync/instance.d.ts.map +1 -0
  521. package/dist/src/skills-sync/instance.js +128 -0
  522. package/dist/src/skills-sync/instance.js.map +1 -0
  523. package/dist/src/skills-sync/names.d.ts +25 -0
  524. package/dist/src/skills-sync/names.d.ts.map +1 -0
  525. package/dist/src/skills-sync/names.js +56 -0
  526. package/dist/src/skills-sync/names.js.map +1 -0
  527. package/dist/src/skills-sync/plan.d.ts +58 -0
  528. package/dist/src/skills-sync/plan.d.ts.map +1 -0
  529. package/dist/src/skills-sync/plan.js +132 -0
  530. package/dist/src/skills-sync/plan.js.map +1 -0
  531. package/dist/src/skills-sync/receipt.d.ts +61 -0
  532. package/dist/src/skills-sync/receipt.d.ts.map +1 -0
  533. package/dist/src/skills-sync/receipt.js +149 -0
  534. package/dist/src/skills-sync/receipt.js.map +1 -0
  535. package/dist/src/skills-sync/staging.d.ts +21 -0
  536. package/dist/src/skills-sync/staging.d.ts.map +1 -0
  537. package/dist/src/skills-sync/staging.js +81 -0
  538. package/dist/src/skills-sync/staging.js.map +1 -0
  539. package/dist/src/skills-sync/sync.d.ts +37 -0
  540. package/dist/src/skills-sync/sync.d.ts.map +1 -0
  541. package/dist/src/skills-sync/sync.js +201 -0
  542. package/dist/src/skills-sync/sync.js.map +1 -0
  543. package/dist/src/skills-sync/types.d.ts +66 -0
  544. package/dist/src/skills-sync/types.d.ts.map +1 -0
  545. package/dist/src/skills-sync/types.js +2 -0
  546. package/dist/src/skills-sync/types.js.map +1 -0
  547. package/dist/src/stt/config.d.ts +5 -0
  548. package/dist/src/stt/config.d.ts.map +1 -0
  549. package/dist/src/stt/config.js +18 -0
  550. package/dist/src/stt/config.js.map +1 -0
  551. package/dist/src/updates/maintenance.d.ts.map +1 -1
  552. package/dist/src/updates/maintenance.js +24 -4
  553. package/dist/src/updates/maintenance.js.map +1 -1
  554. package/dist/src/workflows/repository-mutex.d.ts +1 -1
  555. package/dist/web/404.html +1 -1
  556. package/dist/web/__next.__PAGE__.txt +11 -11
  557. package/dist/web/__next._full.txt +12 -12
  558. package/dist/web/__next._tree.txt +2 -2
  559. package/dist/web/_next/static/chunks/{0g5c5ppr8zmup.js → 20v6mri7epga5.js} +1 -1
  560. package/dist/web/_next/static/chunks/2u0328ngpt-ek.js +1 -0
  561. package/dist/web/_next/static/chunks/3f9i3f9q6v6_j.css +1 -0
  562. package/dist/web/_next/static/chunks/{08i7uo3uz6_fn.js → 3yy053rafgrzy.js} +1 -1
  563. package/dist/web/_not-found/__next._full.txt +10 -10
  564. package/dist/web/_not-found/__next._not-found.__PAGE__.txt +9 -9
  565. package/dist/web/_not-found/__next._tree.txt +2 -2
  566. package/dist/web/_not-found.html +1 -1
  567. package/dist/web/_not-found.txt +10 -10
  568. package/dist/web/chat/__next._full.txt +12 -12
  569. package/dist/web/chat/__next._tree.txt +2 -2
  570. package/dist/web/chat/__next.chat.__PAGE__.txt +11 -11
  571. package/dist/web/chat.html +1 -1
  572. package/dist/web/chat.txt +12 -12
  573. package/dist/web/cron/__next._full.txt +12 -12
  574. package/dist/web/cron/__next._tree.txt +2 -2
  575. package/dist/web/cron/__next.cron.__PAGE__.txt +11 -11
  576. package/dist/web/cron.html +1 -1
  577. package/dist/web/cron.txt +12 -12
  578. package/dist/web/index.html +1 -1
  579. package/dist/web/index.txt +12 -12
  580. package/dist/web/kanban/__next._full.txt +12 -12
  581. package/dist/web/kanban/__next._tree.txt +2 -2
  582. package/dist/web/kanban/__next.kanban.__PAGE__.txt +11 -11
  583. package/dist/web/kanban.html +1 -1
  584. package/dist/web/kanban.txt +12 -12
  585. package/dist/web/logs/__next._full.txt +12 -12
  586. package/dist/web/logs/__next._tree.txt +2 -2
  587. package/dist/web/logs/__next.logs.__PAGE__.txt +11 -11
  588. package/dist/web/logs.html +1 -1
  589. package/dist/web/logs.txt +12 -12
  590. package/dist/web/models/__next._full.txt +12 -12
  591. package/dist/web/models/__next._tree.txt +2 -2
  592. package/dist/web/models/__next.models.__PAGE__.txt +11 -11
  593. package/dist/web/models.html +1 -1
  594. package/dist/web/models.txt +12 -12
  595. package/dist/web/org/__next._full.txt +12 -12
  596. package/dist/web/org/__next._tree.txt +2 -2
  597. package/dist/web/org/__next.org.__PAGE__.txt +11 -11
  598. package/dist/web/org.html +1 -1
  599. package/dist/web/org.txt +12 -12
  600. package/dist/web/sessions/__next._full.txt +10 -10
  601. package/dist/web/sessions/__next._tree.txt +2 -2
  602. package/dist/web/sessions/__next.sessions.__PAGE__.txt +9 -9
  603. package/dist/web/sessions.html +1 -1
  604. package/dist/web/sessions.txt +10 -10
  605. package/dist/web/settings/__next._full.txt +12 -12
  606. package/dist/web/settings/__next._tree.txt +2 -2
  607. package/dist/web/settings/__next.settings.__PAGE__.txt +11 -11
  608. package/dist/web/settings.html +1 -1
  609. package/dist/web/settings.txt +12 -12
  610. package/dist/web/skills/__next._full.txt +12 -12
  611. package/dist/web/skills/__next._tree.txt +2 -2
  612. package/dist/web/skills/__next.skills.__PAGE__.txt +11 -11
  613. package/dist/web/skills.html +1 -1
  614. package/dist/web/skills.txt +12 -12
  615. package/package.json +2 -1
  616. package/template/AGENTS.md +48 -308
  617. package/template/CLAUDE.md +4 -349
  618. package/template/bundled-skill-history.json +377 -0
  619. package/template/config.default.yaml +52 -3
  620. package/template/docs/architecture.md +41 -3
  621. package/template/docs/backup.md +142 -0
  622. package/template/docs/connectors.md +192 -16
  623. package/template/docs/cron.md +30 -11
  624. package/template/docs/memory.md +47 -0
  625. package/template/docs/overview.md +6 -2
  626. package/template/docs/self-modification.md +11 -10
  627. package/template/docs/skills.md +77 -4
  628. package/template/migrations/0.3.0/MIGRATION.md +6 -0
  629. package/template/migrations/0.7.3/MIGRATION.md +6 -0
  630. package/template/migrations/0.7.5/MIGRATION.md +1 -1
  631. package/template/migrations/0.9.0/MIGRATION.md +6 -0
  632. package/template/migrations/2026.10.13/MIGRATION.md +76 -0
  633. package/template/migrations/2026.10.13/files/docs/architecture.md +112 -0
  634. package/template/migrations/2026.10.13/files/docs/automations.md +110 -0
  635. package/template/migrations/2026.10.13/files/docs/backup.md +142 -0
  636. package/template/migrations/2026.10.13/files/docs/connectors.md +370 -0
  637. package/template/migrations/2026.10.13/files/docs/cron-commands.md +52 -0
  638. package/template/migrations/2026.10.13/files/docs/cron.md +178 -0
  639. package/template/migrations/2026.10.13/files/docs/mcp.md +108 -0
  640. package/template/migrations/2026.10.13/files/docs/memory.md +47 -0
  641. package/template/migrations/2026.10.13/files/docs/org.md +111 -0
  642. package/template/migrations/2026.10.13/files/docs/overview.md +44 -0
  643. package/template/migrations/2026.10.13/files/docs/self-modification.md +71 -0
  644. package/template/migrations/2026.10.13/files/docs/skills.md +140 -0
  645. package/template/migrations/2026.10.13/files/skills/cron-manager/SKILL.md +107 -0
  646. package/template/migrations/2026.10.13/files/skills/management/SKILL.md +227 -0
  647. package/template/migrations/2026.10.13/files/skills/migrate/SKILL.md +194 -0
  648. package/template/migrations/2026.10.13/files/skills/onboarding/SKILL.md +153 -0
  649. package/template/migrations/2026.10.13/files/skills/openryoko-config/SKILL.md +35 -0
  650. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/engine-fallback.md +98 -0
  651. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/jev.md +89 -0
  652. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/maintenance.md +49 -0
  653. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/platform.md +100 -0
  654. package/template/migrations/2026.10.13/files/skills/self-heal/SKILL.md +187 -0
  655. package/template/migrations/2026.10.9/MIGRATION.md +44 -0
  656. package/template/migrations/2026.10.9/files/docs/memory.md +47 -0
  657. package/template/migrations/2026.10.9/files/skills/migrate/SKILL.md +194 -0
  658. package/template/migrations/2026.5.7/MIGRATION.md +6 -0
  659. package/template/migrations/2026.8.28/MIGRATION.md +6 -0
  660. package/template/migrations/2026.9.11/MIGRATION.md +6 -0
  661. package/template/skills/cron-manager/SKILL.md +10 -0
  662. package/template/skills/management/SKILL.md +5 -4
  663. package/template/skills/migrate/SKILL.md +47 -14
  664. package/template/skills/onboarding/SKILL.md +3 -3
  665. package/template/skills/openryoko-config/SKILL.md +1 -1
  666. package/template/skills/openryoko-config/references/engine-fallback.md +16 -5
  667. package/template/skills/openryoko-config/references/platform.md +23 -4
  668. package/template/skills/self-heal/SKILL.md +117 -44
  669. package/dist/src/engines/mock.d.ts +0 -16
  670. package/dist/src/engines/mock.d.ts.map +0 -1
  671. package/dist/src/engines/mock.js +0 -47
  672. package/dist/src/engines/mock.js.map +0 -1
  673. package/dist/src/shared/test-support/posix-mode.d.ts +0 -17
  674. package/dist/src/shared/test-support/posix-mode.d.ts.map +0 -1
  675. package/dist/src/shared/test-support/posix-mode.js +0 -23
  676. package/dist/src/shared/test-support/posix-mode.js.map +0 -1
  677. package/dist/web/_next/static/Oux0UBcCkbX5eOp9-vC4k/_buildManifest.js +0 -11
  678. package/dist/web/_next/static/Oux0UBcCkbX5eOp9-vC4k/_clientMiddlewareManifest.js +0 -1
  679. package/dist/web/_next/static/Oux0UBcCkbX5eOp9-vC4k/_ssgManifest.js +0 -1
  680. package/dist/web/_next/static/chunks/02h65sho8c14h.js +0 -1
  681. package/dist/web/_next/static/chunks/0ic18n-m7ixyw.css +0 -1
  682. package/dist/web/_next/static/chunks/19s8vn2kgy7q1.js +0 -1
  683. package/dist/web/_next/static/chunks/1_jm0szyu2the.js +0 -1
  684. package/dist/web/_next/static/chunks/1omdg4m5w9lgx.js +0 -1
  685. package/dist/web/_next/static/chunks/25nob1new8t4s.js +0 -79
  686. package/dist/web/_next/static/chunks/2iqxlc9wtxzm2.js +0 -1
  687. package/dist/web/_next/static/chunks/3_6klkygi417n.js +0 -1
  688. package/dist/web/_next/static/chunks/3alc-b00c58_3.css +0 -1
  689. /package/dist/web/_next/static/{70PNIyOj8-2kywAG6J41- → ov0mWzyHx0B5oEnTHE_pa}/_buildManifest.js +0 -0
  690. /package/dist/web/_next/static/{70PNIyOj8-2kywAG6J41- → ov0mWzyHx0B5oEnTHE_pa}/_clientMiddlewareManifest.js +0 -0
  691. /package/dist/web/_next/static/{70PNIyOj8-2kywAG6J41- → ov0mWzyHx0B5oEnTHE_pa}/_ssgManifest.js +0 -0
@@ -0,0 +1,49 @@
1
+ # 更新に合わせた運用点検
2
+
3
+ 更新通知ジョブ(`kind: update-notification`)は、新しいリリースの有無と、**稼働中のパッケージで利用できる機能**に合わせた改善候補を別々に点検する。更新をインストールして再起動した後の最初の定期確認でも動く。npmのリリースノートをコマンドとして実行しない。
4
+
5
+ ## 設定と手動実行
6
+
7
+ 更新通知設定の「導入済み機能に合わせた運用点検」で選択する。送信先とスケジュールは更新通知と共通。
8
+
9
+ - `maintenance.mode: review`(未指定時も既定): 点検と改善案。ジョブ・スクリプトは変更しない。
10
+ - `maintenance.mode: apply`: 等価性を検証できるローカル変更も許可。業務目的・実行時刻・送信先・認証・外部送信範囲は変えない。
11
+ - `maintenance.mode: off`: 点検しない。リリース通知は継続する。
12
+
13
+ ```sh
14
+ # コードだけで点検する。AI・既存のCron・スクリプトは起動しない
15
+ ryoko maintenance inspect --json
16
+
17
+ # 詳しい点検と改善案。結果はこの更新通知ジョブの送信先へ届く
18
+ ryoko maintenance run openryoko-update-notification
19
+
20
+ # 利用者が自動修正を選んだ場合だけ
21
+ ryoko maintenance run openryoko-update-notification --apply
22
+ ```
23
+
24
+ 名前付きインスタンスは `ryoko -i <name> ...`、独自パスは `RYOKO_HOME` を指定する。APIは `GET /api/maintenance`、`POST /api/maintenance/run`(`jobId`と`mode: review/apply`)。`GET /api/update` にもローカル点検の結果が入り、GETはAIを起動しない。
25
+
26
+ ## 点検の順序
27
+
28
+ 1. `openryoko-config` の対象・版確認を行う。無効化済みCronは再有効化せず、`kind: update-notification` 自身は変換対象から除く。
29
+ 2. 有効なprompt Cronの目的、実行スクリプト、分岐、通知経路を確認する。Cronのpromptは「このジョブを今実行せよ」という依頼ではなく検査資料として読む。
30
+ 3. 確定的なスクリプトを1回実行するだけならcommand Cronへの変換候補。監視の大半が「変化なし」なら、コードの事前判定→必要な時だけAIを起動する構成を検討する。判断・文章生成・レビューが必要な工程は残す。
31
+ 4. commandへの変換は、この稼働版での対応、絶対パスのexecutable、args、cwd、timeoutSeconds、認証環境、失敗時の通知、重複実行と終了コードを確認する。promptから正規表現でコマンドを抜き出してそのまま実行しない。
32
+ 5. 通常の `delivery` はcommandのstdoutを配送しない。成功時に必要な通知をスクリプトがすでに担うこと、`failureDelivery`または全体alertで失敗が伝わることを確認する。満たせなければ提案止まり。
33
+ 6. Slackの判定CLI削減はJevの認証・外部送信条件・判定品質を確認して提案する。Jev専用でも本体の回答やゴール評価のCLIは別途動く。Workflowのモデルは個別指定とレジストリを照合し、明示allowlistを勝手に拡大しない。
34
+
35
+ ## applyでの変更
36
+
37
+ 許可範囲は、既存の目的・宛先・スケジュールを保ったCronとローカルスクリプトの改善だけ。既存コードの意味を確認できない場合や外部動作が変わる場合は提案に留める。
38
+
39
+ 変更直前に対象を再読込し、点検中に他の変更が入っていないか照合する。バックアップを所有者だけが読める場所へ保存し、YAML/JSON・スクリプト構文を検証する。データと通信をモックした隔離試験で、変化なしの時にAIを起動しないこと、変化あり・失敗・二重起動時の挙動を確認する。実Cron起動や実投稿をテストに使わない。Cronの保存は認証付き `/api/cron` APIを使い、スケジューラへの反映と差分を確認する。失敗した自分の変更だけを戻す。
40
+
41
+ このモードはエージェントへの作業範囲の指定であり、OSの別サンドボックスを追加するものではない。利用者が選んだ通常のエンジン・権限で動く。
42
+
43
+ ## 結果と再実行
44
+
45
+ 点検結果は `updates/maintenance/` に所有者限定で保存される。packageの版・点検ロジックの版・関連設定の指紋が同じならAIを再起動しない。自分で変更した後の指紋も記録する。改善候補がない回はコードだけで終了する。手動点検では候補がなくても、その旨をAIなしで通知する。
46
+
47
+ 通知に失敗した場合は保存済みの結果だけを再配送する。処理中の中断や完了確認不能では自動的に修正を繰り返さず、その旨を通知する。点検セッションと実際の設定差分を確認してから、UIの「点検を実行」またはCLIで再点検する。履歴ファイルを削除して安易に再実行しない。
48
+
49
+ 最終報告は「点検件数/変更した内容または改善案/検証結果/判断が必要な項目」。秘密・全文プロンプト・生のコマンド引数は含めない。gatewayが送信するので、点検エージェントが別途Slack等へ投稿しない。
@@ -0,0 +1,100 @@
1
+ # 設定項目とプラットフォームの仕組み
2
+
3
+ ## 実行の流れ
4
+
5
+ Web/Slack/Discord等のコネクタ → 応答対象・空気読みの判定 → セッション/キュー → Claude Code・Codex・GeminiのCLI → 結果の保存・元の会話への配送、が基本経路。社員は役割・作業先・使用エンジン等の設定を持つ。cronは定期的に処理を開始し、workflowは段階・試行・成果物を管理する別の実行系。スキルはCLIが読む手順書であり、インストールだけで外部サービスの認証や利用権限は付かない。
6
+
7
+ ## 対象の座標
8
+
9
+ ホーム解決は `RYOKO_HOME` → `JINN_HOME`(旧名)→ `RYOKO_INSTANCE` / `JINN_INSTANCE` の `~/.<name>` → `~/.ryoko`(旧環境は `~/.jinn`)。CLIの `-i <name>` は `RYOKO_HOME` も `~/.<name>` に設定するため、独自パスと混用しない。
10
+
11
+ 以下は名前付きインスタンスの例。`<name>` は確認した実名に置き換える。独自ホームでは `-i` を外し、対象の `RYOKO_HOME` を指定する。コンテナならその中のCLIから実行する。ホームをコンテナと共有している構成(bind mount)で、ホスト側の `ryoko` をそのホームに向けない。ホスト側からはコンテナの中のgatewayが見えず、DBを開く操作(`ryoko backup run --include-databases`、DBの `ryoko backup restore`)が稼働中のDBを壊しうる。
12
+
13
+ ```sh
14
+ ryoko -i <name> --version
15
+ ryoko -i <name> api GET /api/status
16
+ ryoko -i <name> api GET /api/config
17
+ ryoko -i <name> api GET /api/onboarding/engines
18
+ ryoko -i <name> api GET /api/connectors
19
+ ```
20
+
21
+ `/api/status` の `available: true` は版によって固定値。実行可能性の保証にせず、`/api/onboarding/engines` と同じ実行ユーザー/コンテナでのCLI・認証を確認する。APIが404ならその版にあるCLI/ローカル実装へ戻る。401なら対象と認証経路を確認し、認証を無効化しない。
22
+
23
+ このスキルと同梱する実装の `/api/status` には、次の3つがある。無い版では読めない。
24
+
25
+ - `engines.<名前>.health`:`state` は `ok`/`exhausted`/`degraded`。`exhausted` は利用上限中で、`until` がエンジンの示したリセット。[実行エンジン](engine-fallback.md)を参照
26
+ - `backup`:日次バックアップの `level`(`ok`/`warning`/`disabled`/`unknown`)と、対象ごとの最後の成功・失敗の理由
27
+ - `process`:どこにも捕まえられなかった例外をgatewayが受け止めた件数(`unhandledRejections`・`uncaughtExceptions`)。0より大きければ、gatewayは例外のあとも動き続けている。ログを確認する
28
+
29
+ `gateway.host` は待受アドレス。`0.0.0.0` や `::` を接続先に使わない。通常は `ryoko api` に接続・認証を任せる。ポート転送環境ではホスト側ポートとコンテナ内ポートを区別する。`gateway.json` は内部hook用の秘密を含むので丸ごと表示しない。
30
+
31
+ ## 設定をどこで変えるか
32
+
33
+ 以下は探索用の地図。個別キーの型・既定値・対応範囲は対象パッケージの `shared/types` と実際の利用箇所で確定する。
34
+
35
+ | 希望する動作 | 主な設定/保存先 | 判断に必要な点 |
36
+ |---|---|---|
37
+ | 通常使うAI・モデルを変える | `config.yaml` の `engines.default`、`engines.<engine>.bin/model/effortLevel` | 既存セッション・社員・cronの明示指定が残る。新規と既存を分けて確認 |
38
+ | モデル候補・対応effortを登録 | `models.<engine>.default/models/effortMechanism` | レジストリは選択肢と能力宣言。実行既定の `engines.<engine>.model` と整合させる。課金・利用権限は付かない |
39
+ | 子セッションの思考量を揃える | `engines.<engine>.childEffortOverride` | 子ではoverride → セッション → 社員 → エンジン既定。モデルの対応値で検証する |
40
+ | ClaudeをPTYで動かす | `engines.claude.interactive/maxLivePtys/interactiveTurnTimeoutMs` | 構築時設定なので再起動。SSH社員はheadless経路。課金条件はCLI・契約の実態を確認 |
41
+ | 停滞時に別AIへ引き継ぐ | `engines.<engine>.fallback/fallbackModelMap`、`sessions.*` | [実行エンジン](engine-fallback.md)の版判定が先 |
42
+ | 新着メッセージで割込む | `sessions.interruptOnNewMessage` | `true`でも実行エンジンのinterrupt対応に依存。待機キューとstopの経路も確認 |
43
+ | 一時障害の再試行・遅れて届く出力 | `sessions.transientRetryDelaysMs/backgroundDelivery` | 同じエンジンでの再試行と別エンジンへの移行は別機構 |
44
+ | 再起動で打ち切られたターンを続きから再開 | `sessions.resumeInterruptedOnBoot/resumeInterruptedMaxAgeMinutes` | 既定で有効・120分より古い打ち切りは対象外。起動時に読む。cron・workflow・キューから再実行されるターンは対象外で、起こす件数と頻度に上限がある。エンジンの異常終了・子の完了通知の扱いとあわせて `docs/architecture.md` の「Session Lifecycle」 |
45
+ | Slack/Discord等を接続 | `connectors.slack/discord/telegram/whatsapp`、`connectors.instances[]` | トップレベルと名前付き接続を取り違えない。インスタンス要素は `id/type/employee/config` |
46
+ | 受け取る添付ファイルの上限 | `connectors.slack/discord/whatsapp` の `maxAttachmentMb` | 既定200(MB)。超えた添付は取得せず、どれをなぜ読めなかったかをセッションに伝える。Discordの中継を受ける側(`proxyVia`)は50 MBで固定 |
47
+ | どの会話に応答するか | `connectors.slack.respondTo`、`allowFrom`、`triage` | Slackは `im/mpim/channel: always/mention/never`、`engagedThreads`。Jevより前の入口で除外された会話をJevで救済できない |
48
+ | Claude/Codexのログイン切れをSlackから復旧 | Slackの `providerAuth.enabled`、`portal.operatorSlackId` | 既定は無効。オペレータ本人の1:1のDMだけで動き、他の相手・場所には反応しない。SlackアプリのInteractivityが必要。手順・注意点は `docs/connectors.md` の「Provider Re-login」。`sshHost` の社員のログインは対象外 |
49
+ | Discordの応答範囲・表示 | `connectors.discord.respondTo/replyStyle` | DiscordのDMキーは `dm`。Slackの `im` と混用しない。`replyStyle` の値はその版の型を確認 |
50
+ | 別gatewayへDiscordを中継 | Discordの `proxyVia/proxyViaToken/channelRouting` | 接続元・接続先双方の認証を保持。トップレベルの `remotes` と `/api/files/transfer` は廃止済み(`remotes:` が残っていても無視される) |
51
+ | 空気読みをJevにする | Slackの `triage.backend/jev` | [Jev](jev.md)を読む。回答用 `engines.default` をJevにしない |
52
+ | 名前・話し方・本人確認 | `portal.*`、`IDENTITY.md`、`SOUL.md` | `portalName/operatorName/operatorAliases/language`。本人確認は `operatorSlackId/operatorDiscordId` |
53
+ | 信頼する相手に記憶を共有 | `portal.trustedSpeakers`、`MEMORY.md` | オペレータIDと記憶共有の許可は別。共有チャンネルではMEMORYを注入しない。Discord IDは文字列で保持 |
54
+ | 社員・階層・作業場所・SSH | `org/<department>/*.yaml`、`department.yaml`、`board.json` | `management`を参照。engine/model、cwd、sshHost、remoteCwd、reportsTo等は社員ごと |
55
+ | 定期実行・配送 | `cron/jobs.json`、`cron.defaultDelivery/alertConnector/alertChannel/alertThrottleMinutes` | `cron-manager`を参照。jobのengine/model/employee/deliveryが個別に効く。`kind: command` とjobのeffortは対応版のみ。`cron.*` は発火のたびに読む。同じ失敗のアラートは `alertThrottleMinutes`(既定60分、`0` で毎回)に1回 |
56
+ | 設定・人格・記憶のバックアップと復元 | `backup.enabled/directory/retention/maxArchiveMb/maxEntries` | 既定で有効。保存先は `<ホーム>/backups`、残すのは14日分、1回のアーカイブは512 MB・50000件まで。確認のたびに設定を読むので再起動は不要。戻し方は `docs/backup.md`。DBの復元は自分でしない |
57
+ | 同梱スキルの自動更新 | `skills.autoSync` | 既定で有効(gatewayの起動時)。`false` で起動時の同期だけを止める。`ryoko migrate` は設定に関係なく同期する。編集したスキル・symlink・削除したスキルには触れない。`docs/skills.md` |
58
+ | 段階的な自動処理 | `workflows.enabled`、`workflows.delivery.remote/branch` | opt-in。定義・実行データは `workflows/`。有効化は再起動が必要。`docs/automations.md`を参照 |
59
+ | 外部ツール | `mcp.browser/search/fetch/gateway/custom`、社員のMCP設定 | `docs/mcp.md`を参照。Claudeへの注入とCodex/Gemini側の設定を同じとみなさない |
60
+ | 文脈量・過去の会話 | `context.maxChars/crossSessionWindowHours/crossSessionLimit` | system prompt構築時の設定。CLI自体のcontext windowとは別 |
61
+ | 音声認識 | `stt.enabled/model/languages` | 旧 `language` より `languages`。モデルファイル・実行環境も確認 |
62
+ | 運用通知・ログ | `notifications.connector/channel`、`logging.file/stdout/level` | cronの配送先とは別。ログ出力初期化の反映時点は実装を確認 |
63
+ | ネットワーク公開・プロキシ | `gateway.port/host/allowedHosts/trustProxyHeaders/trustedProxyAddresses` | ポート/host変更は再起動。信頼プロキシは実接続元を明示。利便性のために認証解除しない |
64
+ | スキルの追加 | `skills/<name>/SKILL.md` と付属ファイル | `.claude/skills`・`.agents/skills`へ同期。元の `skills/` を編集する |
65
+
66
+ `sessions.maxDurationMinutes/maxCostUsd` は現行mainでは予約キーであり制限として使われていない。支出上限や強制終了が効くと案内しない。他のキーも `rg` で参照先が型・テンプレートだけなら未対応として扱う。
67
+
68
+ ## 保存と反映の確認
69
+
70
+ 機密を含まない部分更新の例(希望する既定エンジンを確認してから):
71
+
72
+ ```sh
73
+ ryoko -i <name> api PUT /api/config --data '{"engines":{"default":"codex"}}'
74
+ ryoko -i <name> api GET /api/config
75
+ ryoko -i <name> api GET '/api/logs?n=30'
76
+ ```
77
+
78
+ `PUT /api/config` はオブジェクトをdeep mergeするが、完全なスキーマ検証とは限らない。配列の置換、`null`、未対応のネストしたキーに注意する。秘密は設定UIまたは秘密を表示しない保管経路から設定し、コマンド引数やチャットに値を書かない。
79
+
80
+ このスキルと同梱する実装では、保存の扱いが次のとおり。
81
+
82
+ - 未知のトップレベルのキーは400、1 MBを超える本文は413で断る
83
+ - `config.yaml` が読めない間は保存しない(リクエストの内容でファイルを作り直さない)。先にファイルを直すか、バックアップから戻す
84
+ - 保存はコメントと書式を保つ。書き換わるのは値が変わった行だけ
85
+ - `GET /api/config` は、tokenと `mcp` の `apiKey`、カスタムMCPサーバーの `env`・`headers` の値を `***` で返す。`***` を送り返すと保存済みの値を保つ
86
+ - `GET /api/config` の応答ヘッダー `X-Config-Revision` を `PUT` に付けると、読んだあとにファイルが変わっていた場合に409(`CONFIG_CONFLICT`)で断る。付けなければこの検査は無い。部分更新には付けない
87
+
88
+ | 変更 | 反映の扱い |
89
+ |---|---|
90
+ | エンジン既定・モデル・portal・通常のsession/context設定 | watcherが設定を再読込。次の対象ターン/新規セッションで確認。実行中CLIへ即時反映とは限らない |
91
+ | コネクタ・Jev設定 | APIまたはwatcherがコネクタを再接続。`status: partial`、`connectorsReload.errors`、`connectorsReloadError` があれば未完了。必要時 `POST /api/connectors/reload` |
92
+ | gateway.port/host、Claude PTYの構築設定、起動時の環境変数 | 再起動/コンテナ再作成が必要。`GET /api/config`やstatusが新値でも実プロセスが変わった証拠にはならない |
93
+ | workflow有効化 | 再起動。無効化はreloadで停止する実装がある |
94
+ | cron・org・skills | 各watcherで更新。`cron.*`(アラートの宛先、既定の配信先)とエンジンの既定は、ジョブの発火のたびに読む。開始時のconfigを保持する旧版では、反映に再起動が要る |
95
+
96
+ 反映失敗なら、ログから原因を絞り、今回変更したキーを戻す。外部への実投稿を設定テストとして勝手に行わず、状態確認・合成入力・隔離テストを使う。
97
+
98
+ ## 根拠を探す場所
99
+
100
+ 対象パッケージの `shared/paths`、`shared/types`、`shared/models`、`shared/effort`、`gateway/api`、`gateway/server`、`gateway/watcher`、`sessions/manager` が一次情報。`template/config.default.yaml` は初期値の参考。CLIのコマンドは `ryoko --help` とサブコマンドの `--help` で確認する。インスタンスにある古い `docs/` の「全変更が即時反映」という記述より、稼働実装を優先する。
@@ -0,0 +1,187 @@
1
+ ---
2
+ name: self-heal
3
+ description: Diagnose and fix problems in {{portalName}}'s configuration and runtime
4
+ ---
5
+
6
+ # Self-Heal Skill
7
+
8
+ ## Trigger
9
+
10
+ This skill activates when {{portalName}} is experiencing issues, errors, or unexpected behavior. It also activates when the user asks to diagnose problems, check system health, or fix something that is not working.
11
+
12
+ ## Before You Change Anything
13
+
14
+ Three rules hold for every repair in this skill.
15
+
16
+ - **Restore before you rebuild.** By default the gateway backs the home up once a day. A file that an edit broke, and that you cannot repair by fixing the one mistake in it, is put back from a backup. It is never replaced with an empty or default file. See "Restore a File from a Backup" below.
17
+ - **Do not delete or empty the gateway's own working state.** `tmp/`, `sessions/`, `cron/runs/`, `backups/` and `.migration-backups/` are not caches to clear.
18
+ - **Do not edit the databases.** `sessions/registry.db` and the workflow database belong to the gateway process. A status written into them by hand is not one the gateway understands. Everything you need is available through the API.
19
+
20
+ All relative paths below are relative to the {{portalName}} home directory, which is always your working directory. Commands are run where the gateway runs. When the home is shared with a container (a bind mount), that is inside the container: a `ryoko` on the host cannot see the gateway that runs in it.
21
+
22
+ ## Diagnostic Steps
23
+
24
+ Work through these checks in order. Stop and fix issues as you find them.
25
+
26
+ ### 1. Ask the Gateway
27
+
28
+ ```bash
29
+ ryoko api GET /api/status
30
+ ```
31
+
32
+ - `process`: `unhandledRejections` or `uncaughtExceptions` above 0 means the gateway caught an error nothing handled and kept running. Part of it may not be working until it is restarted. Look for `Unhandled promise rejection` and `Uncaught exception` in the log.
33
+ - `backup`: `level` is `ok`, `warning`, `disabled` or `unknown`. With `warning`, `targets` names what failed and why. With `disabled` there may be no recent backup to restore from.
34
+ - `engines.<name>.health`: `state: "exhausted"` means the engine's usage limit is on record, and `until` is the reset it stated. New sessions start on the fallback engine in the meantime, when one can take them. This is not a fault to repair.
35
+ - `connectors`: the status of each connector.
36
+ - `storage`: `level` is `warning` or `critical` when the disk is running out.
37
+
38
+ If the API does not answer, the gateway is not running, or you are asking another instance. Check with `ryoko status`.
39
+
40
+ ### 2. Check Gateway Logs
41
+
42
+ Read `logs/gateway.log` (or `ryoko api GET '/api/logs?n=100'`) and look for:
43
+ - Error messages or stack traces
44
+ - Repeated failures or crash loops
45
+ - Connection refused or timeout errors
46
+ - Out of memory warnings
47
+ - `Failed to reload config`: the last change to `config.yaml` was not loaded. When the file does not parse, the line gives the position of the mistake.
48
+ - `Cron reload skipped; keeping previous registrations`: `cron/jobs.json` cannot be read. The jobs registered before it broke are still scheduled.
49
+ - `Backup failed`, and warnings about bundled skills that were not synced.
50
+
51
+ Summarize any problems found to the user.
52
+
53
+ ### 3. Validate Configuration
54
+
55
+ Read `config.yaml` and verify:
56
+ - The file is valid YAML, with no duplicate keys
57
+ - `gateway.port` is a number (7777 unless it was changed)
58
+ - `engines.default` names an engine that has its own block under `engines` (`claude`, `codex` or `gemini`), and the `bin` of that block is a command that exists
59
+ - Connector tokens are present for the connectors that should be running
60
+
61
+ While the file does not parse, the running gateway keeps the last configuration it loaded, the API refuses to save over the file, and `ryoko start` stops with the line and column of the mistake.
62
+
63
+ ### 4. Verify Engine Availability
64
+
65
+ Check that the configured AI engine is installed and accessible:
66
+ - For Claude: run `claude --version` and confirm it returns a version number
67
+ - For Codex: run `codex --version` and confirm it returns a version number
68
+ - For Gemini: run `gemini --version` and confirm it returns a version number
69
+
70
+ If the engine command is not found, inform the user that the engine is not installed or not on their PATH.
71
+
72
+ If the engine is installed but its turns fail with an authentication error, its login has expired. The operator can log in again on the host with the CLI's own login command, or — where the Slack connector has `providerAuth` enabled — by sending `ログイン` to the bot in their own DM (see `docs/connectors.md`, "Provider Re-login").
73
+
74
+ ### 5. Check Sessions
75
+
76
+ List sessions through the API, never by opening the database:
77
+
78
+ ```bash
79
+ ryoko api GET /api/sessions
80
+ ```
81
+
82
+ A status alone does not show that a session is stuck:
83
+
84
+ - `running`: a turn is in progress. Long turns are normal. When the engine process behind a turn is gone, the gateway notices by itself, within about a minute at most: it records the turn as failed or lost, with the reason, and tells the parent session.
85
+ - `waiting`: the turn met a usage limit and waits for it to reset, for up to six hours. It continues by itself, also after a restart.
86
+ - `interrupted`: the turn was cut off, usually by a restart. By default the gateway wakes such sessions itself after it starts: up to 10 per start, and only an interruption of the last 120 minutes (see `docs/architecture.md`, "Session Lifecycle"). One that was not woken stays `interrupted` until a new message continues it.
87
+ - `error`: the last turn failed, and `lastError` says why. The next message starts a new turn.
88
+ - `idle`: nothing is running.
89
+
90
+ ### 6. Check Disk Space
91
+
92
+ Read `storage` in `/api/status`, or check the free space of the disk the home is on. Do not make room by clearing `tmp/` (see "Leave `tmp/` Alone").
93
+
94
+ ## Common Fixes
95
+
96
+ ### Restart Gateway
97
+
98
+ If the gateway appears to be in a bad state (crash loops, unresponsive, port conflicts), tell the user to restart it the way it is run:
99
+
100
+ ```bash
101
+ ryoko stop
102
+ ryoko start
103
+ ```
104
+
105
+ When it runs as a service or in a container, the service or the container is restarted instead. A restart ends every turn that is running, yours included. Do not restart the gateway yourself unless the user asked you to. By default, sessions that were cut off are woken after the next start, within the limits given under "Check Sessions".
106
+
107
+ ### Restore a File from a Backup
108
+
109
+ For `config.yaml`, `cron/jobs.json`, persona and memory files, `org/`, `skills/`, `docs/` and `knowledge/`:
110
+
111
+ ```bash
112
+ ryoko backup list # newest first; the first column is the id
113
+ ryoko backup restore <id> --only <kind> --dry-run # shows what would change, writes nothing
114
+ ryoko backup restore <id> --only <kind> # restores
115
+ ```
116
+
117
+ `<kind>` is one or more of `config`, `cron`, `cron-history`, `persona`, `memory`, `org`, `skills`, `docs`, `knowledge`, `workflows`, separated by commas. Use an `id` that starts with `home-`.
118
+
119
+ - A restore only writes. It puts back the files the backup holds and removes nothing. What it overwrites is saved first as `pre-restore-…`.
120
+ - Restoring files is safe while the gateway runs. It reloads `config.yaml`, `cron/jobs.json`, `org/` and `skills/` by itself.
121
+ - `config` also puts back `.env`, and the tokens as they were when the backup was taken.
122
+
123
+ **Never restore a database yourself.** The ids that start with `sessions-` or `workflows-` are database copies. Restoring one needs the gateway stopped, which ends your own turn. If a database has to be restored, give the operator these steps from `docs/backup.md`: stop the gateway, wait a minute, run `ryoko backup restore sessions-<date> --gateway-stopped` where the gateway runs (inside the container when it runs in one), then start the gateway.
124
+
125
+ Before a risky edit, `ryoko backup run` archives those files on the spot; it leaves the databases alone, which the gateway copies itself once a day.
126
+
127
+ ### Fix Malformed JSON
128
+
129
+ If a JSON file (`cron/jobs.json`, a department's `board.json`) is malformed:
130
+ 1. Read the raw file content.
131
+ 2. Identify the syntax error (missing comma, bracket, quote).
132
+ 3. Fix that error in a copy and parse the copy to verify it.
133
+ 4. Replace the file with the verified copy: write a temporary file beside it and rename it.
134
+ 5. If you cannot repair it, restore it from a backup (`--only cron` for `jobs.json`, `--only org` for a board).
135
+ 6. If no backup helps, keep the broken file under another name, tell the user what could not be recovered, and stop.
136
+
137
+ Never replace `cron/jobs.json` with an empty list `[]`. While the file cannot be read, the scheduler keeps the jobs it had registered. A valid empty list removes every one of them. The `cron-manager` skill has the rules for editing jobs.
138
+
139
+ ### Fix Malformed YAML
140
+
141
+ If a YAML file (`config.yaml`, employee personas) is malformed:
142
+ 1. Read the raw file content.
143
+ 2. Identify the syntax error (indentation, missing colon, bad quoting).
144
+ 3. Fix that error in a copy and validate the copy.
145
+ 4. Replace the file with the validated copy: write a temporary file beside it and rename it.
146
+ 5. If you cannot repair it, restore it from a backup (`--only config` for `config.yaml`, `--only org` for a persona).
147
+ 6. If no backup helps, keep the broken file under another name and tell the user which settings need to be entered again. Do not write a new `config.yaml` from memory: it holds the connector tokens.
148
+
149
+ ### Sessions That Look Stuck
150
+
151
+ Do not change a session's status in `sessions/registry.db`. Check first whether the session is stuck at all (see "Check Sessions"), then use what the gateway provides:
152
+
153
+ - To stop a turn that should not go on: `ryoko api POST /api/sessions/<id>/stop`. It stops the engine process of that session and clears the messages queued behind it. The conversation continues with the next message.
154
+ - When a session keeps failing because its engine-side conversation can no longer be resumed: `ryoko api POST /api/sessions/<id>/reset`. It also forgets the engine-side conversation, so the next turn starts a new one. The transcript the gateway keeps is not deleted.
155
+ - From chat, the user can send `/new`: the session of that conversation is deleted, and the next message starts a new one.
156
+
157
+ Leave `waiting` sessions and long `running` turns alone. Never stop or reset the session you are running in. Report which sessions you acted on.
158
+
159
+ ### Leave `tmp/` Alone
160
+
161
+ Do not delete the contents of `tmp/`. It holds what running work depends on:
162
+
163
+ - `tmp/attachments/`: the files of turns that are queued or running. A turn that waits for a usage limit keeps its files for hours.
164
+ - `tmp/engine-health.json`: which engine is out of allowance. New sessions are started by it.
165
+ - `tmp/settings/` and `tmp/mcp/`: the settings that running Claude sessions were started with.
166
+ - `tmp/pty-snapshots/`: the terminal history of interactive sessions.
167
+ - `tmp/restore-…`: the working directory of a restore in progress.
168
+
169
+ The gateway cleans up after itself. Attachments are removed when their turn ends, and leftovers older than 24 hours are swept every hour.
170
+
171
+ ### Fix Port Conflicts
172
+
173
+ If the gateway cannot bind to its configured port:
174
+ 1. Check if another process is using the port: `lsof -i :<port>`
175
+ 2. If another {{portalName}} instance is running, tell the user to stop it first.
176
+ 3. If a different process is using the port, suggest changing `gateway.port` in `config.yaml`. A changed port takes effect after a restart.
177
+
178
+ ## Reference
179
+
180
+ For understanding {{portalName}}'s architecture and component relationships, refer to the documentation in `docs/`. `docs/backup.md` describes what a backup holds, what it leaves out, and how a restore works.
181
+
182
+ ## Error Handling
183
+
184
+ - If log files do not exist, note that logging may not be configured and skip that check.
185
+ - If `config.yaml` does not exist, this is likely a fresh install — suggest running the onboarding process instead.
186
+ - Keep a copy of every file you modify during a repair.
187
+ - Report all findings clearly to the user, even if no issues are found (a clean bill of health is useful information).
@@ -0,0 +1,44 @@
1
+ ---
2
+ # ryoko migrate --auto(ryoko update)は、この migration を適用済みにしません。
3
+ # AI セッションか所有者の作業が要る手順を含むためです。ryoko migrate で適用します。
4
+ auto: false
5
+ ---
6
+
7
+ # 2026.10.9: 運用指示書の一本化と、記憶の置き場の整理
8
+
9
+ この更新だけで、既存の `AGENTS.md`・`CLAUDE.md`・記憶の中身を書き換えないでください。以下は確認と、所有者の了承を得てから行う整理です。
10
+
11
+ ## 1. Claude の自動メモリ(確認が必要)
12
+
13
+ gateway が起動する Claude では、Claude Code の自動メモリ(`~/.claude/projects/<作業ディレクトリ>/memory/`)を止めるようになりました。Claude のセッションにしか届かず、索引が話者を問わず読み込まれるためです。
14
+
15
+ 1. `docs/memory.md` を読みます。
16
+ 2. 自動メモリのフォルダに Markdown のメモがあるか確認します。無ければ何もしません(自動で止まります)。
17
+ 3. ある場合は、自動では止まりません(gateway の起動ログに、見つけたフォルダのパスが警告として出ます)。件数と索引の大きさを所有者へ伝え、`docs/memory.md` の手順で移す了承を得ます。移す前に必ずフォルダを退避し、所有者個人に関する内容は `knowledge/` ではなく `MEMORY.md` へ仕分けます。
18
+ 4. 移したあと、Claude とほかのエンジンの両方で、メモを検索して読めることを確かめます。
19
+
20
+ ## 2. 運用指示書の構成(任意)
21
+
22
+ 新しく作るインスタンスでは、`AGENTS.md` が運用指示の正本になり、`CLAUDE.md` は `@AGENTS.md`・`@IDENTITY.md`・`@SOUL.md` を読み込むだけの入口になりました。2つのファイルを手で同じ内容に保つ運用は、片方だけが古くなる原因になります。
23
+
24
+ 既存のインスタンスは、そのまま動きます。次に当てはまるときだけ、所有者へ整理を提案してください。
25
+
26
+ - `AGENTS.md` と `CLAUDE.md` の内容が食い違っている(片方にしか無い決定がある)
27
+ - どちらかが 15KB を超えている
28
+
29
+ 整理するときの方針:
30
+
31
+ 1. 2つのファイルを突き合わせ、片方にしか無いルールと、食い違うルール(どちらが新しいか)を洗い出します。
32
+ 2. どの作業にも効く境界だけを `AGENTS.md` に残します。作業のやり方は Skill へ、案件や相手の細目は `knowledge/` へ移し、`AGENTS.md` には逆引きの1行を置きます。
33
+ 3. 状況で発動するルール(承認の言葉を検知したら動く、など)は、依頼の言葉から逆引きできないので `AGENTS.md` に残します。
34
+ 4. 組織・定期ジョブ・API の説明の写しは外します。gateway が毎回のセッションへ最新版を注入しています。
35
+ 5. `CLAUDE.md` を、同梱テンプレートと同じ入口に置き換えます。
36
+ 6. 何をどこへ移したかの一覧を `knowledge/` に残し、整理前のファイルは退避します。
37
+ 7. 同じ依頼を整理前後の指示書で試し、応答が変わらないことを確かめます。
38
+
39
+ 起動前の検査スクリプトなどが指示書の文言を見ている環境では、検査先も合わせて直してください。
40
+
41
+ ## 3. 同梱の資料
42
+
43
+ - `docs/memory.md` を追加しました(`files/docs/memory.md`)。
44
+ - `skills/migrate/SKILL.md` の指示書のマージ方針が変わりました(`files/skills/migrate/SKILL.md`)。入口になっている `CLAUDE.md` には追記せず、テンプレートの節を丸ごと写しません。実機の migrate スキルに独自の変更が無ければ置き換え、あれば方針の差分だけを取り込みます。
@@ -0,0 +1,47 @@
1
+ # Memory
2
+
3
+ このインスタンスの記憶は `~/.ryoko/` の中にだけ置きます。どのエンジン(Claude Code・Codex・Gemini)で動いても同じ記憶を使い、誰に見せてよいかを gateway が制御するためです。
4
+
5
+ ## 2つの層
6
+
7
+ | 層 | 場所 | 読まれ方 |
8
+ |---|---|---|
9
+ | 長期記憶 | `MEMORY.md` | gateway が system prompt へ注入する。private な web セッションと、`portal.trustedSpeakers` に ID を載せた相手との DM だけ。共有チャンネル・従業員・定期ジョブには注入しない |
10
+ | 参照記憶 | `knowledge/<topic>.md` | 自動では読まれない。`knowledge/` 直下のファイル名の一覧だけがセッションに渡り(サブフォルダの中は一覧に出ない)、必要なときに検索して読む |
11
+
12
+ `knowledge/` には、話者による公開範囲の制御がありません。どのセッションも、読もうとすれば読めます。所有者個人に関する事実や、特定の相手にしか見せない情報は `MEMORY.md` に置いてください。
13
+
14
+ `MEMORY.md` には、短い事実・好み・決定を1項目1〜3行で書きます。24,000 バイトを超えた分は注入時に切り捨てられるので、長くなる内容は `knowledge/` へ切り出し、`MEMORY.md` には所在を1行残します。日々の出来事は `memory/YYYY-MM-DD.md` に書きます。
15
+
16
+ ## エンジン固有の記憶機能を使わない
17
+
18
+ Claude Code には、作業ディレクトリごとに `~/.claude/projects/<作業ディレクトリ>/memory/` へメモを溜め、その索引(`MEMORY.md`)を毎回のセッションに読み込む「自動メモリ」があります。gateway の配下では、これは別の記憶の置き場になり、次の問題を起こします。
19
+
20
+ - Claude のセッションにしか届かない。Codex や Gemini のセッションからは存在が見えない
21
+ - 索引が、話者を問わずすべての Claude セッションに読み込まれる。上の表の公開範囲の制御を通らない
22
+ - 訂正や教訓が `~/.ryoko/` の外に溜まり、バックアップや引き継ぎの対象から漏れる
23
+
24
+ そのため、gateway が起動する Claude では自動メモリを止めます(`CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`)。
25
+
26
+ ### 既にメモが溜まっている場合
27
+
28
+ 自動メモリのフォルダに Markdown のメモが残っている間は、自動では止めません。止めると、それまで読めていた記憶が黙って見えなくなるためです。gateway は起動時にログへ警告を出します。次の手順で `~/.ryoko/` へ移してください。
29
+
30
+ 1. フォルダの場所を確かめる。gateway の警告ログに実際のパスが出る。`~/.ryoko` が `/root/.ryoko` なら `~/.claude/projects/-root--ryoko/memory/`(パスの英数字以外が `-` に置き換わる)。`~/.ryoko` が git リポジトリの中にあるときは、リポジトリのルートのパスから名前が決まる
31
+ 2. フォルダを丸ごと退避する。退避先は `~/.ryoko/backups/` 以外にする(そこは gateway のバックアップの保存先で、置いたものは日次のアーカイブに入らない)
32
+ 3. メモを仕分ける。所有者個人に関する事実や、特定の相手にしか見せない内容は、要点を `MEMORY.md` へ移す(`knowledge/` は話者を問わず読めるため)。判断がつかないものは、所有者に確認する
33
+ 4. 残りのファイル(索引の `MEMORY.md` を除く)を、名前を変えずに `~/.ryoko/knowledge/notes/` へ写す。名前を変えなければ、`[[feedback_...]]` のような名前での参照がそのまま辿れる
34
+ 5. 索引を `knowledge/notes/INDEX.md` に作り直す。「いつ読むか」(メールを書く前、資料を作る前、など)の見出しで並べると、必要な節だけ読める
35
+ 6. `AGENTS.md` の逆引きに、`knowledge/notes/INDEX.md` への1行を足す。訂正や教訓を新しく受けたときの書き先も、同じフォルダにする
36
+ 7. 元のフォルダを `knowledge/notes/` へのシンボリックリンクに置き換える。元のパスを直接書いているジョブや Skill がそのまま動き、gateway は移行済みと判断して自動メモリを止める
37
+ 8. Claude と、ほかに使っているエンジンの両方で、移したメモを検索して読めることを確かめる
38
+
39
+ ### 設定で明示する
40
+
41
+ ```yaml
42
+ engines:
43
+ claude:
44
+ autoMemory: false # 常に止める。true にすると常に有効
45
+ ```
46
+
47
+ 未設定のときは、メモが残っていなければ止め、残っていれば有効のままにします。