openryoko 2026.10.9 → 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 (669) 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 +16 -0
  109. package/dist/src/cli/migrate.d.ts.map +1 -1
  110. package/dist/src/cli/migrate.js +358 -69
  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 +15 -2
  199. package/dist/src/engines/claude-interactive.d.ts.map +1 -1
  200. package/dist/src/engines/claude-interactive.js +32 -11
  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 +37 -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 +182 -150
  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/portal-config.d.ts +17 -3
  237. package/dist/src/gateway/portal-config.d.ts.map +1 -1
  238. package/dist/src/gateway/portal-config.js +52 -3
  239. package/dist/src/gateway/portal-config.js.map +1 -1
  240. package/dist/src/gateway/request-origin.d.ts +9 -0
  241. package/dist/src/gateway/request-origin.d.ts.map +1 -1
  242. package/dist/src/gateway/request-origin.js +10 -0
  243. package/dist/src/gateway/request-origin.js.map +1 -1
  244. package/dist/src/gateway/server.d.ts.map +1 -1
  245. package/dist/src/gateway/server.js +76 -59
  246. package/dist/src/gateway/server.js.map +1 -1
  247. package/dist/src/gateway/slack-connect-rollback.d.ts +23 -0
  248. package/dist/src/gateway/slack-connect-rollback.d.ts.map +1 -0
  249. package/dist/src/gateway/slack-connect-rollback.js +53 -0
  250. package/dist/src/gateway/slack-connect-rollback.js.map +1 -0
  251. package/dist/src/gateway/status-reconciler.d.ts +25 -7
  252. package/dist/src/gateway/status-reconciler.d.ts.map +1 -1
  253. package/dist/src/gateway/status-reconciler.js +86 -43
  254. package/dist/src/gateway/status-reconciler.js.map +1 -1
  255. package/dist/src/gateway/watcher.d.ts.map +1 -1
  256. package/dist/src/gateway/watcher.js +44 -3
  257. package/dist/src/gateway/watcher.js.map +1 -1
  258. package/dist/src/mcp/gateway-server.js +21 -3
  259. package/dist/src/mcp/gateway-server.js.map +1 -1
  260. package/dist/src/mcp/resolver.d.ts.map +1 -1
  261. package/dist/src/mcp/resolver.js +51 -1
  262. package/dist/src/mcp/resolver.js.map +1 -1
  263. package/dist/src/models/service.d.ts.map +1 -1
  264. package/dist/src/models/service.js +14 -8
  265. package/dist/src/models/service.js.map +1 -1
  266. package/dist/src/provider-auth/discovery.d.ts +16 -0
  267. package/dist/src/provider-auth/discovery.d.ts.map +1 -0
  268. package/dist/src/provider-auth/discovery.js +66 -0
  269. package/dist/src/provider-auth/discovery.js.map +1 -0
  270. package/dist/src/provider-auth/failure-notices.d.ts +29 -0
  271. package/dist/src/provider-auth/failure-notices.d.ts.map +1 -0
  272. package/dist/src/provider-auth/failure-notices.js +48 -0
  273. package/dist/src/provider-auth/failure-notices.js.map +1 -0
  274. package/dist/src/provider-auth/failure-signal.d.ts +22 -0
  275. package/dist/src/provider-auth/failure-signal.d.ts.map +1 -0
  276. package/dist/src/provider-auth/failure-signal.js +79 -0
  277. package/dist/src/provider-auth/failure-signal.js.map +1 -0
  278. package/dist/src/provider-auth/index.d.ts +26 -0
  279. package/dist/src/provider-auth/index.d.ts.map +1 -0
  280. package/dist/src/provider-auth/index.js +51 -0
  281. package/dist/src/provider-auth/index.js.map +1 -0
  282. package/dist/src/provider-auth/input.d.ts +44 -0
  283. package/dist/src/provider-auth/input.d.ts.map +1 -0
  284. package/dist/src/provider-auth/input.js +86 -0
  285. package/dist/src/provider-auth/input.js.map +1 -0
  286. package/dist/src/provider-auth/providers.d.ts +26 -0
  287. package/dist/src/provider-auth/providers.d.ts.map +1 -0
  288. package/dist/src/provider-auth/providers.js +86 -0
  289. package/dist/src/provider-auth/providers.js.map +1 -0
  290. package/dist/src/provider-auth/runtime.d.ts +21 -0
  291. package/dist/src/provider-auth/runtime.d.ts.map +1 -0
  292. package/dist/src/provider-auth/runtime.js +104 -0
  293. package/dist/src/provider-auth/runtime.js.map +1 -0
  294. package/dist/src/provider-auth/service.d.ts +70 -0
  295. package/dist/src/provider-auth/service.d.ts.map +1 -0
  296. package/dist/src/provider-auth/service.js +349 -0
  297. package/dist/src/provider-auth/service.js.map +1 -0
  298. package/dist/src/provider-auth/terminal.d.ts +21 -0
  299. package/dist/src/provider-auth/terminal.d.ts.map +1 -0
  300. package/dist/src/provider-auth/terminal.js +46 -0
  301. package/dist/src/provider-auth/terminal.js.map +1 -0
  302. package/dist/src/provider-auth/types.d.ts +123 -0
  303. package/dist/src/provider-auth/types.d.ts.map +1 -0
  304. package/dist/src/provider-auth/types.js +10 -0
  305. package/dist/src/provider-auth/types.js.map +1 -0
  306. package/dist/src/sessions/accounting.d.ts +3 -0
  307. package/dist/src/sessions/accounting.d.ts.map +1 -1
  308. package/dist/src/sessions/accounting.js +5 -0
  309. package/dist/src/sessions/accounting.js.map +1 -1
  310. package/dist/src/sessions/backup-integrity.d.ts +45 -0
  311. package/dist/src/sessions/backup-integrity.d.ts.map +1 -0
  312. package/dist/src/sessions/backup-integrity.js +122 -0
  313. package/dist/src/sessions/backup-integrity.js.map +1 -0
  314. package/dist/src/sessions/backup.d.ts +40 -2
  315. package/dist/src/sessions/backup.d.ts.map +1 -1
  316. package/dist/src/sessions/backup.js +88 -12
  317. package/dist/src/sessions/backup.js.map +1 -1
  318. package/dist/src/sessions/callbacks.d.ts +9 -0
  319. package/dist/src/sessions/callbacks.d.ts.map +1 -1
  320. package/dist/src/sessions/callbacks.js +55 -10
  321. package/dist/src/sessions/callbacks.js.map +1 -1
  322. package/dist/src/sessions/completion-batching.d.ts +82 -0
  323. package/dist/src/sessions/completion-batching.d.ts.map +1 -0
  324. package/dist/src/sessions/completion-batching.js +126 -0
  325. package/dist/src/sessions/completion-batching.js.map +1 -0
  326. package/dist/src/sessions/connector-command-guard.d.ts +66 -0
  327. package/dist/src/sessions/connector-command-guard.d.ts.map +1 -0
  328. package/dist/src/sessions/connector-command-guard.js +145 -0
  329. package/dist/src/sessions/connector-command-guard.js.map +1 -0
  330. package/dist/src/sessions/context.js +2 -2
  331. package/dist/src/sessions/engine-fallback.d.ts +43 -1
  332. package/dist/src/sessions/engine-fallback.d.ts.map +1 -1
  333. package/dist/src/sessions/engine-fallback.js +266 -15
  334. package/dist/src/sessions/engine-fallback.js.map +1 -1
  335. package/dist/src/sessions/engine-health-gate.d.ts +83 -0
  336. package/dist/src/sessions/engine-health-gate.d.ts.map +1 -0
  337. package/dist/src/sessions/engine-health-gate.js +186 -0
  338. package/dist/src/sessions/engine-health-gate.js.map +1 -0
  339. package/dist/src/sessions/engine-login.d.ts +58 -0
  340. package/dist/src/sessions/engine-login.d.ts.map +1 -0
  341. package/dist/src/sessions/engine-login.js +107 -0
  342. package/dist/src/sessions/engine-login.js.map +1 -0
  343. package/dist/src/sessions/fork.d.ts.map +1 -1
  344. package/dist/src/sessions/fork.js +2 -1
  345. package/dist/src/sessions/fork.js.map +1 -1
  346. package/dist/src/sessions/goal-execution.d.ts.map +1 -1
  347. package/dist/src/sessions/goal-execution.js +8 -1
  348. package/dist/src/sessions/goal-execution.js.map +1 -1
  349. package/dist/src/sessions/limit-failure-notice.d.ts +41 -0
  350. package/dist/src/sessions/limit-failure-notice.d.ts.map +1 -0
  351. package/dist/src/sessions/limit-failure-notice.js +87 -0
  352. package/dist/src/sessions/limit-failure-notice.js.map +1 -0
  353. package/dist/src/sessions/lost-turn.d.ts +39 -0
  354. package/dist/src/sessions/lost-turn.d.ts.map +1 -0
  355. package/dist/src/sessions/lost-turn.js +32 -0
  356. package/dist/src/sessions/lost-turn.js.map +1 -0
  357. package/dist/src/sessions/manager.d.ts.map +1 -1
  358. package/dist/src/sessions/manager.js +104 -47
  359. package/dist/src/sessions/manager.js.map +1 -1
  360. package/dist/src/sessions/new-session-engine.d.ts +42 -0
  361. package/dist/src/sessions/new-session-engine.d.ts.map +1 -0
  362. package/dist/src/sessions/new-session-engine.js +100 -0
  363. package/dist/src/sessions/new-session-engine.js.map +1 -0
  364. package/dist/src/sessions/origin-delivery.d.ts +50 -4
  365. package/dist/src/sessions/origin-delivery.d.ts.map +1 -1
  366. package/dist/src/sessions/origin-delivery.js +108 -9
  367. package/dist/src/sessions/origin-delivery.js.map +1 -1
  368. package/dist/src/sessions/queue.d.ts +14 -0
  369. package/dist/src/sessions/queue.d.ts.map +1 -1
  370. package/dist/src/sessions/queue.js +38 -2
  371. package/dist/src/sessions/queue.js.map +1 -1
  372. package/dist/src/sessions/registry.d.ts +4 -2
  373. package/dist/src/sessions/registry.d.ts.map +1 -1
  374. package/dist/src/sessions/registry.js +21 -4
  375. package/dist/src/sessions/registry.js.map +1 -1
  376. package/dist/src/sessions/reply-disposition.d.ts +8 -0
  377. package/dist/src/sessions/reply-disposition.d.ts.map +1 -1
  378. package/dist/src/sessions/reply-disposition.js +8 -0
  379. package/dist/src/sessions/reply-disposition.js.map +1 -1
  380. package/dist/src/sessions/restart-resume.d.ts +234 -0
  381. package/dist/src/sessions/restart-resume.d.ts.map +1 -0
  382. package/dist/src/sessions/restart-resume.js +596 -0
  383. package/dist/src/sessions/restart-resume.js.map +1 -0
  384. package/dist/src/sessions/speaker-prefix.d.ts.map +1 -1
  385. package/dist/src/sessions/speaker-prefix.js +3 -1
  386. package/dist/src/sessions/speaker-prefix.js.map +1 -1
  387. package/dist/src/sessions/turn-delivery.d.ts +26 -0
  388. package/dist/src/sessions/turn-delivery.d.ts.map +1 -0
  389. package/dist/src/sessions/turn-delivery.js +34 -0
  390. package/dist/src/sessions/turn-delivery.js.map +1 -0
  391. package/dist/src/sessions/unrequested-stop.d.ts +26 -0
  392. package/dist/src/sessions/unrequested-stop.d.ts.map +1 -0
  393. package/dist/src/sessions/unrequested-stop.js +19 -0
  394. package/dist/src/sessions/unrequested-stop.js.map +1 -0
  395. package/dist/src/sessions/usage-limit-wait.d.ts +14 -0
  396. package/dist/src/sessions/usage-limit-wait.d.ts.map +1 -0
  397. package/dist/src/sessions/usage-limit-wait.js +9 -0
  398. package/dist/src/sessions/usage-limit-wait.js.map +1 -0
  399. package/dist/src/shared/attachment-download.d.ts +41 -0
  400. package/dist/src/shared/attachment-download.d.ts.map +1 -0
  401. package/dist/src/shared/attachment-download.js +110 -0
  402. package/dist/src/shared/attachment-download.js.map +1 -0
  403. package/dist/src/shared/attachment-notice.d.ts +24 -0
  404. package/dist/src/shared/attachment-notice.d.ts.map +1 -0
  405. package/dist/src/shared/attachment-notice.js +37 -0
  406. package/dist/src/shared/attachment-notice.js.map +1 -0
  407. package/dist/src/shared/attachments.d.ts +65 -0
  408. package/dist/src/shared/attachments.d.ts.map +1 -0
  409. package/dist/src/shared/attachments.js +153 -0
  410. package/dist/src/shared/attachments.js.map +1 -0
  411. package/dist/src/shared/childEnv.d.ts +15 -0
  412. package/dist/src/shared/childEnv.d.ts.map +1 -1
  413. package/dist/src/shared/childEnv.js +15 -0
  414. package/dist/src/shared/childEnv.js.map +1 -1
  415. package/dist/src/shared/claude-limit-reset.d.ts +54 -0
  416. package/dist/src/shared/claude-limit-reset.d.ts.map +1 -0
  417. package/dist/src/shared/claude-limit-reset.js +99 -0
  418. package/dist/src/shared/claude-limit-reset.js.map +1 -0
  419. package/dist/src/shared/config-error.d.ts +21 -0
  420. package/dist/src/shared/config-error.d.ts.map +1 -0
  421. package/dist/src/shared/config-error.js +37 -0
  422. package/dist/src/shared/config-error.js.map +1 -0
  423. package/dist/src/shared/config-file.d.ts +57 -0
  424. package/dist/src/shared/config-file.d.ts.map +1 -0
  425. package/dist/src/shared/config-file.js +217 -0
  426. package/dist/src/shared/config-file.js.map +1 -0
  427. package/dist/src/shared/config-yaml-edit.d.ts +20 -0
  428. package/dist/src/shared/config-yaml-edit.d.ts.map +1 -0
  429. package/dist/src/shared/config-yaml-edit.js +468 -0
  430. package/dist/src/shared/config-yaml-edit.js.map +1 -0
  431. package/dist/src/shared/config.d.ts.map +1 -1
  432. package/dist/src/shared/config.js +12 -4
  433. package/dist/src/shared/config.js.map +1 -1
  434. package/dist/src/shared/engine-fallback.d.ts +22 -0
  435. package/dist/src/shared/engine-fallback.d.ts.map +1 -1
  436. package/dist/src/shared/engine-fallback.js +55 -4
  437. package/dist/src/shared/engine-fallback.js.map +1 -1
  438. package/dist/src/shared/engine-health.d.ts +16 -0
  439. package/dist/src/shared/engine-health.d.ts.map +1 -1
  440. package/dist/src/shared/engine-health.js +42 -0
  441. package/dist/src/shared/engine-health.js.map +1 -1
  442. package/dist/src/shared/list-alignment.d.ts +23 -0
  443. package/dist/src/shared/list-alignment.d.ts.map +1 -0
  444. package/dist/src/shared/list-alignment.js +61 -0
  445. package/dist/src/shared/list-alignment.js.map +1 -0
  446. package/dist/src/shared/logger.d.ts.map +1 -1
  447. package/dist/src/shared/logger.js +104 -33
  448. package/dist/src/shared/logger.js.map +1 -1
  449. package/dist/src/shared/map-limited.d.ts +11 -0
  450. package/dist/src/shared/map-limited.d.ts.map +1 -0
  451. package/dist/src/shared/map-limited.js +30 -0
  452. package/dist/src/shared/map-limited.js.map +1 -0
  453. package/dist/src/shared/oneShotCli.d.ts.map +1 -1
  454. package/dist/src/shared/oneShotCli.js +4 -2
  455. package/dist/src/shared/oneShotCli.js.map +1 -1
  456. package/dist/src/shared/partial-delivery.d.ts +24 -0
  457. package/dist/src/shared/partial-delivery.d.ts.map +1 -0
  458. package/dist/src/shared/partial-delivery.js +46 -0
  459. package/dist/src/shared/partial-delivery.js.map +1 -0
  460. package/dist/src/shared/process-safety-net.d.ts +44 -0
  461. package/dist/src/shared/process-safety-net.d.ts.map +1 -0
  462. package/dist/src/shared/process-safety-net.js +88 -0
  463. package/dist/src/shared/process-safety-net.js.map +1 -0
  464. package/dist/src/shared/rateLimit.d.ts +45 -2
  465. package/dist/src/shared/rateLimit.d.ts.map +1 -1
  466. package/dist/src/shared/rateLimit.js +64 -2
  467. package/dist/src/shared/rateLimit.js.map +1 -1
  468. package/dist/src/shared/redact.d.ts.map +1 -1
  469. package/dist/src/shared/redact.js +11 -1
  470. package/dist/src/shared/redact.js.map +1 -1
  471. package/dist/src/shared/safe-file-name.d.ts +9 -0
  472. package/dist/src/shared/safe-file-name.d.ts.map +1 -0
  473. package/dist/src/shared/safe-file-name.js +16 -0
  474. package/dist/src/shared/safe-file-name.js.map +1 -0
  475. package/dist/src/shared/terminal-safe-text.d.ts +2 -0
  476. package/dist/src/shared/terminal-safe-text.d.ts.map +1 -0
  477. package/dist/src/shared/terminal-safe-text.js +21 -0
  478. package/dist/src/shared/terminal-safe-text.js.map +1 -0
  479. package/dist/src/shared/types.d.ts +69 -4
  480. package/dist/src/shared/types.d.ts.map +1 -1
  481. package/dist/src/skills-sync/apply.d.ts +21 -0
  482. package/dist/src/skills-sync/apply.d.ts.map +1 -0
  483. package/dist/src/skills-sync/apply.js +209 -0
  484. package/dist/src/skills-sync/apply.js.map +1 -0
  485. package/dist/src/skills-sync/backup-run.d.ts +47 -0
  486. package/dist/src/skills-sync/backup-run.d.ts.map +1 -0
  487. package/dist/src/skills-sync/backup-run.js +150 -0
  488. package/dist/src/skills-sync/backup-run.js.map +1 -0
  489. package/dist/src/skills-sync/bounded-read.d.ts +32 -0
  490. package/dist/src/skills-sync/bounded-read.d.ts.map +1 -0
  491. package/dist/src/skills-sync/bounded-read.js +104 -0
  492. package/dist/src/skills-sync/bounded-read.js.map +1 -0
  493. package/dist/src/skills-sync/bundled.d.ts +28 -0
  494. package/dist/src/skills-sync/bundled.d.ts.map +1 -0
  495. package/dist/src/skills-sync/bundled.js +84 -0
  496. package/dist/src/skills-sync/bundled.js.map +1 -0
  497. package/dist/src/skills-sync/fingerprint.d.ts +32 -0
  498. package/dist/src/skills-sync/fingerprint.d.ts.map +1 -0
  499. package/dist/src/skills-sync/fingerprint.js +58 -0
  500. package/dist/src/skills-sync/fingerprint.js.map +1 -0
  501. package/dist/src/skills-sync/history.d.ts +44 -0
  502. package/dist/src/skills-sync/history.d.ts.map +1 -0
  503. package/dist/src/skills-sync/history.js +115 -0
  504. package/dist/src/skills-sync/history.js.map +1 -0
  505. package/dist/src/skills-sync/home-skill.d.ts +28 -0
  506. package/dist/src/skills-sync/home-skill.d.ts.map +1 -0
  507. package/dist/src/skills-sync/home-skill.js +67 -0
  508. package/dist/src/skills-sync/home-skill.js.map +1 -0
  509. package/dist/src/skills-sync/instance.d.ts +26 -0
  510. package/dist/src/skills-sync/instance.d.ts.map +1 -0
  511. package/dist/src/skills-sync/instance.js +128 -0
  512. package/dist/src/skills-sync/instance.js.map +1 -0
  513. package/dist/src/skills-sync/names.d.ts +25 -0
  514. package/dist/src/skills-sync/names.d.ts.map +1 -0
  515. package/dist/src/skills-sync/names.js +56 -0
  516. package/dist/src/skills-sync/names.js.map +1 -0
  517. package/dist/src/skills-sync/plan.d.ts +58 -0
  518. package/dist/src/skills-sync/plan.d.ts.map +1 -0
  519. package/dist/src/skills-sync/plan.js +132 -0
  520. package/dist/src/skills-sync/plan.js.map +1 -0
  521. package/dist/src/skills-sync/receipt.d.ts +61 -0
  522. package/dist/src/skills-sync/receipt.d.ts.map +1 -0
  523. package/dist/src/skills-sync/receipt.js +149 -0
  524. package/dist/src/skills-sync/receipt.js.map +1 -0
  525. package/dist/src/skills-sync/staging.d.ts +21 -0
  526. package/dist/src/skills-sync/staging.d.ts.map +1 -0
  527. package/dist/src/skills-sync/staging.js +81 -0
  528. package/dist/src/skills-sync/staging.js.map +1 -0
  529. package/dist/src/skills-sync/sync.d.ts +37 -0
  530. package/dist/src/skills-sync/sync.d.ts.map +1 -0
  531. package/dist/src/skills-sync/sync.js +201 -0
  532. package/dist/src/skills-sync/sync.js.map +1 -0
  533. package/dist/src/skills-sync/types.d.ts +66 -0
  534. package/dist/src/skills-sync/types.d.ts.map +1 -0
  535. package/dist/src/skills-sync/types.js +2 -0
  536. package/dist/src/skills-sync/types.js.map +1 -0
  537. package/dist/src/stt/config.d.ts +5 -0
  538. package/dist/src/stt/config.d.ts.map +1 -0
  539. package/dist/src/stt/config.js +18 -0
  540. package/dist/src/stt/config.js.map +1 -0
  541. package/dist/src/updates/maintenance.d.ts.map +1 -1
  542. package/dist/src/updates/maintenance.js +24 -4
  543. package/dist/src/updates/maintenance.js.map +1 -1
  544. package/dist/src/workflows/repository-mutex.d.ts +1 -1
  545. package/dist/web/404.html +1 -1
  546. package/dist/web/__next.__PAGE__.txt +11 -11
  547. package/dist/web/__next._full.txt +12 -12
  548. package/dist/web/__next._tree.txt +2 -2
  549. package/dist/web/_next/static/chunks/{0g5c5ppr8zmup.js → 20v6mri7epga5.js} +1 -1
  550. package/dist/web/_next/static/chunks/2u0328ngpt-ek.js +1 -0
  551. package/dist/web/_next/static/chunks/3f9i3f9q6v6_j.css +1 -0
  552. package/dist/web/_next/static/chunks/{2iqxlc9wtxzm2.js → 3yy053rafgrzy.js} +1 -1
  553. package/dist/web/_not-found/__next._full.txt +10 -10
  554. package/dist/web/_not-found/__next._not-found.__PAGE__.txt +9 -9
  555. package/dist/web/_not-found/__next._tree.txt +2 -2
  556. package/dist/web/_not-found.html +1 -1
  557. package/dist/web/_not-found.txt +10 -10
  558. package/dist/web/chat/__next._full.txt +12 -12
  559. package/dist/web/chat/__next._tree.txt +2 -2
  560. package/dist/web/chat/__next.chat.__PAGE__.txt +11 -11
  561. package/dist/web/chat.html +1 -1
  562. package/dist/web/chat.txt +12 -12
  563. package/dist/web/cron/__next._full.txt +12 -12
  564. package/dist/web/cron/__next._tree.txt +2 -2
  565. package/dist/web/cron/__next.cron.__PAGE__.txt +11 -11
  566. package/dist/web/cron.html +1 -1
  567. package/dist/web/cron.txt +12 -12
  568. package/dist/web/index.html +1 -1
  569. package/dist/web/index.txt +12 -12
  570. package/dist/web/kanban/__next._full.txt +12 -12
  571. package/dist/web/kanban/__next._tree.txt +2 -2
  572. package/dist/web/kanban/__next.kanban.__PAGE__.txt +11 -11
  573. package/dist/web/kanban.html +1 -1
  574. package/dist/web/kanban.txt +12 -12
  575. package/dist/web/logs/__next._full.txt +12 -12
  576. package/dist/web/logs/__next._tree.txt +2 -2
  577. package/dist/web/logs/__next.logs.__PAGE__.txt +11 -11
  578. package/dist/web/logs.html +1 -1
  579. package/dist/web/logs.txt +12 -12
  580. package/dist/web/models/__next._full.txt +12 -12
  581. package/dist/web/models/__next._tree.txt +2 -2
  582. package/dist/web/models/__next.models.__PAGE__.txt +11 -11
  583. package/dist/web/models.html +1 -1
  584. package/dist/web/models.txt +12 -12
  585. package/dist/web/org/__next._full.txt +12 -12
  586. package/dist/web/org/__next._tree.txt +2 -2
  587. package/dist/web/org/__next.org.__PAGE__.txt +11 -11
  588. package/dist/web/org.html +1 -1
  589. package/dist/web/org.txt +12 -12
  590. package/dist/web/sessions/__next._full.txt +10 -10
  591. package/dist/web/sessions/__next._tree.txt +2 -2
  592. package/dist/web/sessions/__next.sessions.__PAGE__.txt +9 -9
  593. package/dist/web/sessions.html +1 -1
  594. package/dist/web/sessions.txt +10 -10
  595. package/dist/web/settings/__next._full.txt +12 -12
  596. package/dist/web/settings/__next._tree.txt +2 -2
  597. package/dist/web/settings/__next.settings.__PAGE__.txt +11 -11
  598. package/dist/web/settings.html +1 -1
  599. package/dist/web/settings.txt +12 -12
  600. package/dist/web/skills/__next._full.txt +12 -12
  601. package/dist/web/skills/__next._tree.txt +2 -2
  602. package/dist/web/skills/__next.skills.__PAGE__.txt +11 -11
  603. package/dist/web/skills.html +1 -1
  604. package/dist/web/skills.txt +12 -12
  605. package/package.json +2 -1
  606. package/template/bundled-skill-history.json +377 -0
  607. package/template/config.default.yaml +48 -3
  608. package/template/docs/architecture.md +41 -3
  609. package/template/docs/backup.md +142 -0
  610. package/template/docs/connectors.md +192 -16
  611. package/template/docs/cron.md +30 -11
  612. package/template/docs/memory.md +1 -1
  613. package/template/docs/overview.md +6 -2
  614. package/template/docs/self-modification.md +11 -10
  615. package/template/docs/skills.md +77 -4
  616. package/template/migrations/0.3.0/MIGRATION.md +6 -0
  617. package/template/migrations/0.7.3/MIGRATION.md +6 -0
  618. package/template/migrations/0.7.5/MIGRATION.md +1 -1
  619. package/template/migrations/0.9.0/MIGRATION.md +6 -0
  620. package/template/migrations/2026.10.13/MIGRATION.md +76 -0
  621. package/template/migrations/2026.10.13/files/docs/architecture.md +112 -0
  622. package/template/migrations/2026.10.13/files/docs/automations.md +110 -0
  623. package/template/migrations/2026.10.13/files/docs/backup.md +142 -0
  624. package/template/migrations/2026.10.13/files/docs/connectors.md +370 -0
  625. package/template/migrations/2026.10.13/files/docs/cron-commands.md +52 -0
  626. package/template/migrations/2026.10.13/files/docs/cron.md +178 -0
  627. package/template/migrations/2026.10.13/files/docs/mcp.md +108 -0
  628. package/template/migrations/2026.10.13/files/docs/memory.md +47 -0
  629. package/template/migrations/2026.10.13/files/docs/org.md +111 -0
  630. package/template/migrations/2026.10.13/files/docs/overview.md +44 -0
  631. package/template/migrations/2026.10.13/files/docs/self-modification.md +71 -0
  632. package/template/migrations/2026.10.13/files/docs/skills.md +140 -0
  633. package/template/migrations/2026.10.13/files/skills/cron-manager/SKILL.md +107 -0
  634. package/template/migrations/2026.10.13/files/skills/management/SKILL.md +227 -0
  635. package/template/migrations/2026.10.13/files/skills/migrate/SKILL.md +194 -0
  636. package/template/migrations/2026.10.13/files/skills/onboarding/SKILL.md +153 -0
  637. package/template/migrations/2026.10.13/files/skills/openryoko-config/SKILL.md +35 -0
  638. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/engine-fallback.md +98 -0
  639. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/jev.md +89 -0
  640. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/maintenance.md +49 -0
  641. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/platform.md +100 -0
  642. package/template/migrations/2026.10.13/files/skills/self-heal/SKILL.md +187 -0
  643. package/template/migrations/2026.10.9/MIGRATION.md +6 -0
  644. package/template/migrations/2026.10.9/files/docs/memory.md +1 -1
  645. package/template/migrations/2026.10.9/files/skills/migrate/SKILL.md +39 -5
  646. package/template/migrations/2026.5.7/MIGRATION.md +6 -0
  647. package/template/migrations/2026.8.28/MIGRATION.md +6 -0
  648. package/template/migrations/2026.9.11/MIGRATION.md +6 -0
  649. package/template/skills/cron-manager/SKILL.md +10 -0
  650. package/template/skills/management/SKILL.md +5 -4
  651. package/template/skills/migrate/SKILL.md +39 -5
  652. package/template/skills/onboarding/SKILL.md +2 -2
  653. package/template/skills/openryoko-config/SKILL.md +1 -1
  654. package/template/skills/openryoko-config/references/engine-fallback.md +16 -5
  655. package/template/skills/openryoko-config/references/platform.md +23 -4
  656. package/template/skills/self-heal/SKILL.md +117 -44
  657. package/dist/src/engines/mock.d.ts +0 -16
  658. package/dist/src/engines/mock.d.ts.map +0 -1
  659. package/dist/src/engines/mock.js +0 -47
  660. package/dist/src/engines/mock.js.map +0 -1
  661. package/dist/src/shared/test-support/posix-mode.d.ts +0 -17
  662. package/dist/src/shared/test-support/posix-mode.d.ts.map +0 -1
  663. package/dist/src/shared/test-support/posix-mode.js +0 -23
  664. package/dist/src/shared/test-support/posix-mode.js.map +0 -1
  665. package/dist/web/_next/static/chunks/0ic18n-m7ixyw.css +0 -1
  666. package/dist/web/_next/static/chunks/1_jm0szyu2the.js +0 -1
  667. /package/dist/web/_next/static/{peH9RGESLkxB7fw3Cq1GO → ov0mWzyHx0B5oEnTHE_pa}/_buildManifest.js +0 -0
  668. /package/dist/web/_next/static/{peH9RGESLkxB7fw3Cq1GO → ov0mWzyHx0B5oEnTHE_pa}/_clientMiddlewareManifest.js +0 -0
  669. /package/dist/web/_next/static/{peH9RGESLkxB7fw3Cq1GO → ov0mWzyHx0B5oEnTHE_pa}/_ssgManifest.js +0 -0
@@ -0,0 +1,227 @@
1
+ ---
2
+ name: management
3
+ description: Manage the AI organization — hire, fire, promote, delegate, and review boards
4
+ ---
5
+
6
+ # Management Skill
7
+
8
+ ## Trigger
9
+
10
+ This skill activates when the user wants to manage their organization: hiring or firing employees, creating departments, promoting or demoting staff, delegating tasks, reviewing task boards, or restructuring teams.
11
+
12
+ ## Organization Structure
13
+
14
+ The organization lives under `org/` in the {{portalName}} home directory — which is always your working directory, so relative paths in this skill resolve correctly on any instance. Each department is a subdirectory containing employee persona YAML files and a task board.
15
+
16
+ ```
17
+ org/
18
+ engineering/
19
+ department.yaml
20
+ board.json
21
+ lead-developer.yaml
22
+ backend-dev.yaml
23
+ marketing/
24
+ department.yaml
25
+ board.json
26
+ seo-specialist.yaml
27
+ ```
28
+
29
+ ## Rank Definitions
30
+
31
+ - **executive** — Full access. Can see all departments and boards. Can hire and fire anyone across the entire organization.
32
+ - **manager** — Can manage their own department. Can hire within their department. Can see and manage their department's board.
33
+ - **senior** — Can update their own tasks. Can mentor other employees in the department.
34
+ - **employee** — Can update their own tasks only.
35
+
36
+ ## Operations
37
+
38
+ ### Hiring an Employee
39
+
40
+ Create a persona YAML file at `org/<department>/<name>.yaml`.
41
+
42
+ Required fields:
43
+ - `name` — kebab-case identifier (must match filename without extension)
44
+ - `displayName` — human-readable name
45
+ - `department` — department this employee belongs to (must match parent directory name)
46
+ - `rank` — one of: executive, manager, senior, employee
47
+ - `engine` — AI engine to use: `claude`, `codex`, or `gemini` when it is configured
48
+ - `persona` — multiline description of who this employee is and how they behave
49
+ - `model` — (optional) model identifier (e.g., `claude-opus-5-5`, `gpt-6-sol`). Leave it out to follow the default of the employee's engine
50
+ - `reportsTo` — (optional) who this employee reports to (employee name)
51
+
52
+ **Auto-determining `reportsTo`** when the user does not specify:
53
+ 1. Find the highest-ranked employee in the target department (manager > senior > employee)
54
+ 2. If a manager exists → set `reportsTo: <manager-name>`
55
+ 3. If only seniors exist → set `reportsTo: <first-senior-alphabetically>`
56
+ 4. If the department is empty → omit `reportsTo` (smart defaults attach to root)
57
+ 5. Confirm to the user: "Assigned X to report to Y. Change this?"
58
+
59
+ When the user specifies a report-to explicitly, validate the target exists in the registry. If not, warn and ask for correction.
60
+
61
+ Example (`org/marketing/seo-specialist.yaml`):
62
+
63
+ ```yaml
64
+ name: seo-specialist
65
+ displayName: Sarah SEO
66
+ department: marketing
67
+ rank: employee
68
+ engine: claude
69
+ model: sonnet
70
+ reportsTo: marketing-lead
71
+ persona: |
72
+ You are Sarah, an SEO specialist in the marketing department.
73
+ You focus on keyword research, content optimization, and
74
+ technical SEO. You report to the marketing manager.
75
+ Your expertise includes Google Search Console, Ahrefs,
76
+ and content strategy.
77
+ ```
78
+
79
+ Steps:
80
+ 1. Confirm the target department exists under `org/`. If not, ask the user whether to create it first.
81
+ 2. Choose a kebab-case name for the employee (e.g., `lead-developer`, `seo-specialist`).
82
+ 3. Ask the user for displayName, rank, engine, and persona if not provided. Ask for a model only when they want one that differs from the engine's default.
83
+ 4. Write the YAML file to `org/<department>/<name>.yaml`.
84
+ 5. Confirm the hire to the user.
85
+
86
+ ### Firing an Employee
87
+
88
+ 1. Locate the employee's YAML file under `org/<department>/<name>.yaml`.
89
+ 2. Check if the employee has any active tasks on the department board (`board.json` with status other than `done`). Warn the user if so.
90
+ 3. **Check for direct reports**: Call `GET /api/org` and check the employee's `directReports` field.
91
+ - If they have direct reports: warn "X has N direct reports. They will be reassigned to X's manager (Y)."
92
+ - On confirmation, update each report's YAML: set `reportsTo` to the fired employee's own `parentName` (their grandparent in the tree).
93
+ - If the fired employee reported to root (parentName null), remove the `reportsTo` field from each orphaned report (smart defaults will re-resolve).
94
+ 4. Delete the YAML file.
95
+ 5. Remove the employee as assignee from any tasks in `board.json` (set assignee to `unassigned`).
96
+ 6. Confirm the removal to the user.
97
+
98
+ ### Creating a Department
99
+
100
+ 1. Create the directory `org/<dept-name>/`.
101
+ 2. Create `org/<dept-name>/department.yaml` with:
102
+ ```yaml
103
+ name: dept-name
104
+ displayName: Department Display Name
105
+ description: What this department does.
106
+ ```
107
+ 3. Create `org/<dept-name>/board.json` with an empty array: `[]`
108
+ 4. Confirm the department creation to the user.
109
+
110
+ ### Promoting or Demoting an Employee
111
+
112
+ 1. Read the employee's YAML file at `org/<department>/<name>.yaml`.
113
+ 2. Update the `rank` field to the new rank.
114
+ 3. If promoting to **manager**, add delegation capabilities to their persona (see "Promoting to Manager" below).
115
+ 4. Write the updated YAML back to the file.
116
+ 5. Confirm the change to the user, stating the old and new rank.
117
+
118
+ ### Promoting to Manager — Report Reassignment
119
+
120
+ When promoting an employee to manager rank:
121
+
122
+ 1. Check if other department members currently report elsewhere (or have no explicit `reportsTo`).
123
+ 2. Offer to reassign: "Promoting X to manager. Currently N employees have no explicit reporting chain in this department. Should they report to X?"
124
+ 3. On confirmation, update each employee's YAML with `reportsTo: <new-manager-name>`.
125
+
126
+ Their persona must also be extended with delegation capabilities so they can manage their own reports. Append the following to their existing persona:
127
+
128
+ ```yaml
129
+ persona: |
130
+ [... existing persona content ...]
131
+
132
+ ## Manager Responsibilities
133
+ You are the manager of the [department] department. In addition to your
134
+ technical expertise, you:
135
+
136
+ - Manage and delegate tasks to employees in your department
137
+ - You can spawn child sessions via the gateway API to delegate work
138
+ - Apply oversight levels to your reports' work:
139
+ - TRUST: simple lookups, status checks — relay directly
140
+ - VERIFY: code changes, routine work — spot-check key outputs
141
+ - THOROUGH: architecture, breaking changes — full review, multi-turn
142
+ - Report summaries back to the COO ({{portalName}}), not raw employee output
143
+ - Use the department board (board.json) to track task status
144
+ - When given a task by the COO, decide whether to do it yourself or
145
+ delegate to the right employee based on their skills and workload
146
+
147
+ ## Delegation API
148
+ - Create child session: POST /api/sessions with parentSessionId
149
+ - Send follow-up: POST /api/sessions/:id/message
150
+ - Read a child's latest messages: GET /api/sessions/:id?last=N (when its
151
+ completion wakes you, or when asked; never poll or wait inside a turn)
152
+ - List your reports: GET /api/org
153
+ ```
154
+
155
+ **When to suggest promoting to manager:**
156
+ - A department has 3+ employees
157
+ - You're spending excessive time on per-employee delegation in that department
158
+ - A senior employee has consistently delivered high-quality work
159
+ - The user explicitly requests it
160
+
161
+ ### Delegating Tasks
162
+
163
+ Add a task object to the department's `board.json` file.
164
+
165
+ Task object schema:
166
+
167
+ ```json
168
+ {
169
+ "id": "uuid-v4",
170
+ "title": "Short description of the task",
171
+ "assignee": "employee-name",
172
+ "status": "todo",
173
+ "priority": "high",
174
+ "description": "Detailed description of what needs to be done.",
175
+ "createdAt": "2025-01-15T10:30:00.000Z",
176
+ "updatedAt": "2025-01-15T10:30:00.000Z"
177
+ }
178
+ ```
179
+
180
+ Field details:
181
+ - `id` — generate a UUID v4
182
+ - `title` — short, descriptive title
183
+ - `assignee` — the `name` field from the employee's YAML (must match an existing employee in the department)
184
+ - `status` — one of: `todo`, `in-progress`, `review`, `done`
185
+ - `priority` — one of: `high`, `medium`, `low`
186
+ - `description` — detailed task description
187
+ - `createdAt` — ISO 8601 timestamp when the task was created
188
+ - `updatedAt` — ISO 8601 timestamp, same as createdAt initially
189
+
190
+ Steps:
191
+ 1. Read the current `board.json` for the department.
192
+ 2. Verify the assignee exists as an employee in that department.
193
+ 3. Generate a new task object with a UUID.
194
+ 4. Append the task to the array.
195
+ 5. Write the updated array back to `board.json`.
196
+ 6. Confirm the delegation to the user.
197
+
198
+ ### Reviewing Boards
199
+
200
+ 1. Read the department's `board.json`.
201
+ 2. Present tasks grouped by status: todo, in-progress, review, done.
202
+ 3. Include priority and assignee for each task.
203
+ 4. If the user wants to update a task status, modify the task's `status` and `updatedAt` fields in the JSON array and write it back.
204
+
205
+ ### Restructuring (Moving Employees Between Departments)
206
+
207
+ 1. Read the employee's YAML from the source department.
208
+ 2. Update the `department` field to the new department name.
209
+ 3. Offer to update `reportsTo`: "Should X report to <new-dept-manager>?"
210
+ 4. If the moved employee had direct reports, offer to reassign them to the next highest-ranked person in the old department.
211
+ 5. Write the YAML to the new department directory.
212
+ 6. Delete the YAML from the old department directory.
213
+ 7. Move any assigned tasks from the old board to the new board (or reassign them, based on user preference).
214
+ 8. Confirm the move to the user.
215
+
216
+ ## Communication Rules
217
+
218
+ - Messages from higher-ranked employees can reference and direct lower-ranked employees.
219
+ - @mentions in messages (e.g., `@seo-specialist`) route to the mentioned employee's engine and model as defined in their persona YAML.
220
+ - An executive can message anyone. A manager can message employees within their department. Seniors and employees can message peers and their manager.
221
+
222
+ ## Error Handling
223
+
224
+ - If a department does not exist when hiring, offer to create it.
225
+ - If an employee name conflicts with an existing file, warn the user and ask for a different name.
226
+ - If `board.json` is malformed, attempt to parse and fix it. If unrecoverable, back it up and create a fresh empty board.
227
+ - Always validate YAML before writing to ensure it is well-formed.
@@ -0,0 +1,194 @@
1
+ ---
2
+ name: migrate
3
+ description: Apply pending version migrations to update this {{portalName}} instance
4
+ ---
5
+
6
+ # Migrate Skill
7
+
8
+ ## Trigger
9
+
10
+ このスキルは、ユーザーが `/migrate` を実行したとき、`ryoko migrate` から起動されたとき、またはインスタンスのアップデート/アップグレードを依頼されたときに発動します。
11
+
12
+ ## Overview
13
+
14
+ OpenRyoko の新バージョンには、更新されたスキル、新ドキュメント、改良プロンプト、config スキーマ変更が含まれることがあります。これらは **migration folders** として `~/.ryoko/migrations/<version>/` 配下に出荷されます。各フォルダには:
15
+
16
+ - `MIGRATION.md` — 何が変わったかを AI が読める形で記述した指示書
17
+ - `files/` — 新規/更新ファイルを正しい相対ディレクトリ構造で配置
18
+ - `config-patch.json`(任意)— `config.yaml` の既定値を、ユーザーが変えた値を壊さずに更新する決定的なパッチ
19
+
20
+ `MIGRATION.md` の先頭に次の宣言がある migration は、AI セッションか所有者の作業が要るものです。`ryoko migrate --auto`(`ryoko update` が呼ぶ)はこれを適用済みにせず、`ryoko migrate` に回します。
21
+
22
+ ```yaml
23
+ ---
24
+ auto: false
25
+ ---
26
+ ```
27
+
28
+ **migration を書くとき**: AI が判断・確認・マージする手順、または所有者の了承が要る手順が1つでもあれば、この宣言を付けます。新規ファイルのコピーと `config-patch.json` だけで完結する migration には付けません。`--auto` は `MIGRATION.md` の文章を読まないので、宣言が無いと、ファイルが衝突しないかぎり、その手順を実行しないまま版数を進めます。
29
+
30
+ あなたの仕事は、**ユーザーのカスタマイズを保ちながら**改良を取り込むこと。
31
+
32
+ > **互換性メモ**: config.yaml の version key は **`jinn.version` のまま**です(後方互換のため)。これを `ryoko.version` に置き換えてはいけません。
33
+
34
+ ## Steps
35
+
36
+ ### 1. Read Current Version
37
+
38
+ `~/.ryoko/config.yaml` を読み、`jinn.version` フィールドを確認します。フィールドが無ければ `0.0.0` と仮定。
39
+
40
+ ### 2. List Pending Migrations
41
+
42
+ `~/.ryoko/migrations/` 配下のディレクトリを列挙。各ディレクトリ名は3セグメントの数値バージョン(例: `0.2.0`, `0.3.0`, `2026.5.7`)。
43
+
44
+ 数値バージョン昇順にソートし、現インスタンスバージョンより**大きいもの**だけにフィルタ。
45
+
46
+ 保留中マイグレーションが無ければ、ユーザーに「最新です」と伝えて停止。
47
+
48
+ ### 3. Apply Each Migration In Order
49
+
50
+ 保留中の各バージョンを、昇順で:
51
+
52
+ #### a. Read the Migration Instructions
53
+
54
+ `~/.ryoko/migrations/<version>/MIGRATION.md` を読む。このファイルは:
55
+ - 当バージョンで何が変わったか
56
+ - 新規ファイル(直接コピーして OK)
57
+ - 更新ファイル(インテリジェントマージが必要)
58
+ - config スキーマの変更
59
+ - 破壊的変更や手動ステップ
60
+
61
+ #### b. Follow the Instructions
62
+
63
+ MIGRATION.md は変更を分類しています:
64
+
65
+ **新規ファイル**(安全 — そのままコピー):
66
+ - `~/.ryoko/migrations/<version>/files/<path>` → `~/.ryoko/<path>`
67
+ - 既存ではない新規ファイルなので衝突なし
68
+
69
+ **更新ファイル**(マージ必要):
70
+ - migration が **新テンプレート版**を提供
71
+ - ユーザーの**現バージョン**を読む
72
+ - 比較してインテリジェントにマージ:
73
+ - **AGENTS.md / CLAUDE.md**: MIGRATION.md が求める変更だけを、境界か入口の1〜3行として `AGENTS.md` に足す。ユーザーのカスタマイズは絶対に削除しない。`CLAUDE.md` が `@AGENTS.md` を読み込む入口になっているときは、`CLAUDE.md` には何も足さない(下の「Merge Strategy Reference」)
74
+ - **config.yaml**: 新しい key をデフォルト値で追加。既存値は絶対に上書きしない
75
+ - **skills**: 同梱スキルは、ふつう gateway の起動時と `ryoko migrate` で自動同期済み。マージを検討するのは、プロンプトに挙がったスキルだけ。同期が動かないホームでは扱いが違う(どちらも下の「Skills Merging」)
76
+ - **docs**: 完全置換 — 参照ドキュメントなのでカスタマイズ対象外
77
+
78
+ **削除ファイル**(慎重に):
79
+ - MIGRATION.md に明示されたファイルだけ削除
80
+ - 削除前に `<filename>.pre-migration.bak` にバックアップ
81
+
82
+ **プレースホルダ**: `files/` の `.md`・`.yaml` には、`{{` と `}}` で囲んだ `portalName`・`portalSlug` というプレースホルダが残っていることがあります。`ryoko migrate --auto` は新しいファイルを置くときに置き換えますが、この作業では自分で置き換えます。ホームへ置く前に、`portalName` のプレースホルダを `config.yaml` の `portal.portalName`(無ければ `Ryoko`)に、`portalSlug` のプレースホルダを、その名前を小文字にして空白を `-` に替えたものにします。置いたあと、この2つのプレースホルダが残っていないことを確かめます。docs を丸ごと置き換えるときも同じです。ワークフローの `{{ trigger.… }}` のように、ほかの用途の波括弧には触れません。
83
+
84
+ #### c. Back Up Before Modifying
85
+
86
+ 既存ファイルを変更する前に必ずバックアップ:
87
+ - `file.ext` → `file.ext.pre-<version>.bak`
88
+ - 例: `CLAUDE.md` → `CLAUDE.md.pre-2026.5.7.bak`
89
+
90
+ これでユーザーはいつでも復元できます。
91
+
92
+ ### 4. Update Version
93
+
94
+ すべての migration が成功したら `config.yaml` を更新:
95
+
96
+ ```yaml
97
+ jinn:
98
+ version: "<final-migrated-version>"
99
+ ```
100
+
101
+ > 繰り返し: key 名は `jinn:` のまま(互換性のため)。
102
+
103
+ ### 5. Sync Skill Symlinks
104
+
105
+ 新スキルを追加した場合、シンボリックリンクが存在することを確認:
106
+ - `~/.ryoko/.claude/skills/<skill-name>` → `../../skills/<skill-name>`
107
+ - `~/.ryoko/.agents/skills/<skill-name>` → `../../skills/<skill-name>`
108
+
109
+ ### 6. Clean Up
110
+
111
+ 適用済みの migration ディレクトリを `~/.ryoko/migrations/` から削除。
112
+ バックアップファイルは残す — ユーザーが後で手動削除可能。
113
+
114
+ ### 7. Report
115
+
116
+ ユーザーに明確なサマリ:
117
+
118
+ ```
119
+ Migration complete: v{old} → v{new}
120
+
121
+ Added:
122
+ - IDENTITY.md SOUL.md MEMORY.md TOOLS.md (persona/memory layer)
123
+ - BOOTSTRAP.md (initial onboarding ritual)
124
+ - memory/ (daily notes directory)
125
+
126
+ Updated:
127
+ - AGENTS.md (added Read instructions for persona files)
128
+ - skills/onboarding/SKILL.md (writes IDENTITY/SOUL/MEMORY, deletes BOOTSTRAP at end)
129
+
130
+ Backups created:
131
+ - AGENTS.md.pre-2026.5.7.bak
132
+ - skills/onboarding/SKILL.md.pre-2026.5.7.bak
133
+ ```
134
+
135
+ ## Merge Strategy Reference
136
+
137
+ ### CLAUDE.md / AGENTS.md Merging
138
+
139
+ 最もデリケートなファイル — ユーザーが大きくカスタマイズしている可能性があります。また、毎回のセッションで全文が読まれるので、足した分だけほかの指示が効きにくくなります。以下の方針で扱います。
140
+
141
+ 1. **入口かどうかを先に見る**: `CLAUDE.md` に `@AGENTS.md` の行があれば、それは `AGENTS.md` を読み込むだけの入口です。`CLAUDE.md` には何も追記せず、変更は `AGENTS.md` にだけ入れます。入口でなければ、2つのファイルに同じ変更を入れます
142
+ 2. **足すのは入口の行だけ**: 同梱テンプレートの節をそのまま写しません。MIGRATION.md が求める変更を、境界または「どこを読むか」の1〜3行にして足します。手順・スキーマ・例は `docs/` と Skill にあるので、そこへの参照を書きます
143
+ 3. **既存の記述**: 両方にある場合、MIGRATION.md が明示的に「置換」と言わない限りユーザー版を残します
144
+ 4. **削除**: MIGRATION.md が明示的に言わない限り削除しません
145
+ 5. **順序**: ユーザーの既存の順序を保ち、足す行は関係する節の中か末尾に置きます
146
+ 6. **整理の提案**: 2つのファイルの内容が食い違っている、または 15KB を超えているときは、勝手に直さず、所有者へ整理を提案します
147
+
148
+ ### config.yaml Merging
149
+
150
+ 1. **新トップレベル key**: デフォルト値で追加
151
+ 2. **新ネスト key**: 既存親の下にデフォルト値で追加
152
+ 3. **既存 key**: 絶対に上書きしない — ユーザーの値が優先
153
+ 4. **削除 key**: MIGRATION.md が明示的に言う場合のみ(稀)
154
+
155
+ ### Skills Merging
156
+
157
+ パッケージに同梱されているスキルは、gateway の起動時と `ryoko migrate` の実行時に自動で同期されます。この手順を読んでいる時点で、次のことは済んでいます。
158
+
159
+ - 無い同梱スキルは追加されている
160
+ - ユーザーが手を入れていないものは新しい版に置き換わっている。配置の記録が無い古いホームでも、過去のリリースが同梱した版とファイル単位で完全に一致するコピーは、未編集と判定されて置き換わっている
161
+ - 置き換え・退役の前の中身は `~/.ryoko/.migration-backups/<版>-<時刻>/skills/<名前>/` に退避されている(削除はされない)
162
+ - ユーザーが編集したスキルと symlink は、上書きされずにそのまま残っている
163
+ - ユーザーが削除した同梱スキルは、削除されたままになっている(再起動でも `ryoko migrate` でも戻らない。戻るのは `ryoko migrate --restore-deleted-skills` を付けたときだけ)
164
+
165
+ 同期が触らなかった同梱スキルは、この作業を始めたときのプロンプトに名前と理由つきで挙がっています。**マージを検討するのは、そこに挙がったスキルだけ**です。プロンプトで「最新」「削除済み」「退役」とされたスキルには、migration の `files/skills/` から何も入れません(削除済み・退役のスキルは作り直さない)。
166
+
167
+ プロンプトに同期についての記載が無いとき(チャットの `/migrate` から始めた場合など)は、スキルの状態を推測しません。保留中の migration がスキルに触れる(`files/skills/` がある、または MIGRATION.md がスキルの変更を求めている)なら、何も適用せずに止め、ターミナルで `ryoko migrate` を実行するようユーザーに伝えます(同期の結果を載せたプロンプトで、この作業が始まり直します)。触れないなら、そのまま進めます。
168
+
169
+ 1. **同梱スキルではない新スキルディレクトリ**: まだ無ければ丸ごとコピー
170
+ 2. **「編集済み」として挙がったスキル**: ユーザーの編集を保ったまま、新しい指示をマージする
171
+ 3. **「記録が無い」として挙がったスキル**: どの同梱版とも一致しなかったコピー。編集とは限らない。`files/` の新版と比べ、ユーザーの追記が無ければ `files/` の内容をそのまま置く。追記があれば、それを保ってマージする。プレースホルダ(`{{` と `}}` で囲んだ `portalName` など)が実際の名前に置き換わっているだけの差は、追記ではない
172
+ 4. **「symlink」として挙がったスキル**: 触らない(ユーザーが別の場所で管理している)
173
+ 5. **付随ファイル**(スキル内のデータ・テンプレ等): ユーザー変更がなければ更新
174
+ 6. **同期の記録**: `~/.ryoko/skills/.shipped-skills.json` は編集も削除もしない。マージしたスキルは編集済みとして扱われ、以後も自動では置き換わらない。`files/` の内容をそのまま置いたスキルは、次の同期で同梱版と一致すると判定され、以後は自動で更新される
175
+ 7. **同梱版に戻す**: ユーザーがそう望んだときだけ、スキルのディレクトリを退避し、この migration が終わったあとで `ryoko migrate --restore-deleted-skills <スキル名>` を実行するようユーザーに伝える(再起動や素の `ryoko migrate` では戻らない。同期は、消えたスキルをユーザーが削除したものとして扱う。名前を付けないと、ユーザーが削除したほかの同梱スキルも全部戻る)。この作業の中から `ryoko migrate` を呼ばない
176
+
177
+ **同期が動かないホーム**: プロンプトに「`skills/` はユーザーが管理する symlink で、同期は動かない」とあるときは、上の前提も一覧も当てはまりません。そのホームでは何も同期されておらず、`.shipped-skills.json` もありません(作らない)。スキルは、同期の導入前と同じように、この作業の中で扱います。
178
+
179
+ 1. **無いスキルディレクトリ**: 丸ごとコピー
180
+ 2. **既にあるスキル**: ユーザーの SKILL.md が前のテンプレート版と同じなら新版で置換。違えば、ユーザーの追加を保ってマージ
181
+ 3. **付随ファイル**(スキル内のデータ・テンプレ等): ユーザー変更がなければ更新
182
+
183
+ ## Error Handling
184
+
185
+ - ユーザーに `ryoko` のコマンドの実行を頼むときは、gateway が動いている場所で実行するよう添える。ホームをコンテナと共有している構成では、コンテナの中。ホスト側の `ryoko` を、そのホームに向けない
186
+ - migration が途中で失敗したら**停止**。後続バージョンに進まない
187
+ - どのバージョンのどのステップで失敗したか記録
188
+ - config.yaml の version はまだ更新されていないので、`ryoko migrate` を再実行すればリトライ可能
189
+ - ファイル衝突を自動解決できない場合は**ユーザーに確認**
190
+ - バージョンフォルダに MIGRATION.md が無ければそのバージョンをスキップして警告
191
+
192
+ ## Dry Run
193
+
194
+ ユーザーが dry run やプレビューを依頼したら、保留中の MIGRATION.md を全て読んで、何が変わるかをサマリ — ファイル変更はしない。
@@ -0,0 +1,153 @@
1
+ ---
2
+ name: onboarding
3
+ description: Walk a new user through initial {{portalName}} setup, fill IDENTITY / SOUL / MEMORY, and finalize the workspace
4
+ ---
5
+
6
+ # Onboarding Skill
7
+
8
+ ## Trigger
9
+
10
+ このスキルは以下のいずれかで起動します:
11
+
12
+ 1. **`~/.ryoko/BOOTSTRAP.md` が存在するとき**(初回起動時に AGENTS.md から最優先で呼ばれる)
13
+ 2. ユーザーが明示的にオンボーディングのやり直しを希望したとき
14
+
15
+ ---
16
+
17
+ ## Steps
18
+
19
+ ### 0. 既存知識のチェック(アップグレード対応)
20
+
21
+ `~/.ryoko/knowledge/` を ls で確認:
22
+ - `user-profile.md` `preferences.md` `projects.md` 等が存在すれば**旧バージョンからのアップグレード**と判断し、それぞれ Read
23
+ - 何もなければ**新規セットアップ**として進める
24
+
25
+ 旧ファイルがあった場合、内容を要約してユーザーに提示し:
26
+ - 「以下の情報が既にあります。引き継ぎますか?」
27
+ - 承認されたら、短い事実は後の Step 3 で `MEMORY.md` に転記、長文は `knowledge/` にそのまま残す
28
+ - 承認された情報については Step 2 のヒアリングで再質問しない
29
+
30
+ ### 1. 挨拶
31
+
32
+ ユーザーに短く挨拶し、これからセットアップ対話に入ることを伝えます。
33
+
34
+ 例(新規): 「はじめまして。{{portalName}} としてセットアップを始めさせてください。いくつか質問させてもらいます。」
35
+ 例(アップグレード): 「{{portalName}} の persona/memory レイヤが追加されたので、いくつかだけ確認させてください。」
36
+
37
+ ### 2. ヒアリング(一度に全部聞く)
38
+
39
+ 以下を**まとめて**質問してください(1問ずつ聞かない):
40
+
41
+ 1. **あなたについて** — 名前、役割、所属/事業
42
+ 2. **{{portalName}} に手伝ってほしいこと** — コードレビュー、デプロイ、監視、リサーチ等
43
+ 3. **コミュニケーションの好み** — 簡潔/詳細、敬語/タメ口、絵文字の有無、使用言語
44
+ 4. **{{portalName}} の人格** — どんな雰囲気で振る舞ってほしいか(落ち着いた / 軽快 / 茶目っ気 など)、絵文字を使うなら何を使いたいか、ユーモアは OK か
45
+ 5. **進行中のプロジェクト** — 何に取り組んでいるか、技術スタック、リポジトリ、状況
46
+
47
+ ### 3. 自己定義ファイルを書き込む
48
+
49
+ 回答が揃ったら、以下のファイルを **Edit** で更新してください(**Write で全置換しない** — 既存セクション構造を保つ)。
50
+
51
+ #### `~/.ryoko/IDENTITY.md`
52
+
53
+ `Name` / `Vibe` / `Emoji` / `Pronouns` / `Origin` の各セクションをユーザーの回答で埋める。
54
+
55
+ #### `~/.ryoko/SOUL.md`
56
+
57
+ `Tone` / `Brevity` / `Humor` を回答で埋める。`Opinions` / `Boundaries` / `Quirks` はデフォルトのままでよい(ユーザーが言及した場合のみ調整)。
58
+
59
+ #### `~/.ryoko/MEMORY.md`
60
+
61
+ ヒアリング結果から「短い事実・好み」を抽出して `Facts` と `Preferences` に追記:
62
+
63
+ ```markdown
64
+ ## Facts
65
+ - ユーザー名: [name]
66
+ - 所属: [organization]
67
+ - 役割: [role]
68
+ - 主要言語/スタック: [stack]
69
+ - 主な依頼領域: [what they want help with]
70
+
71
+ ## Preferences
72
+ - 冗長性: [concise / detailed]
73
+ - 敬語: [keigo / casual]
74
+ - 絵文字: [yes / no / minimal]
75
+ - 言語: [language]
76
+ ```
77
+
78
+ 進行中のプロジェクト情報は**長文になりがち**なので、`MEMORY.md` ではなく `~/.ryoko/knowledge/projects.md` に書きます:
79
+
80
+ #### `~/.ryoko/knowledge/projects.md`(新規作成)
81
+
82
+ ```markdown
83
+ # Active Projects
84
+
85
+ ## [Project Name]
86
+ - **Stack**: [tech stack]
87
+ - **Repo**: [repo path or URL]
88
+ - **Status**: [status]
89
+ - **Notes**: [anything relevant]
90
+ ```
91
+
92
+ #### `~/.ryoko/TOOLS.md`(必要に応じて)
93
+
94
+ ユーザーが特定のツール(pnpm 統一、gh CLI 中心、特定の MCP サーバ等)に言及したら追記。言及がなければ触らない。
95
+
96
+ ### 4. OpenClaw からの移行確認
97
+
98
+ `~/.openclaw/` が存在するか確認。あれば移行を提案:
99
+
100
+ 1. `~/.openclaw/openclaw.json` を読んで設定を確認
101
+ 2. `~/.openclaw/cron/jobs.json` の cron ジョブを確認
102
+ 3. `~/.openclaw/skills/` のスキルプレイブックを確認
103
+ 4. `~/.openclaw/memory/` と `~/.openclaw/knowledge/` の蓄積文脈を確認
104
+
105
+ サマリを提示してユーザーに何を移すか選んでもらう。承認されたものだけ移行する。
106
+
107
+ OpenClaw が無ければスキップ。
108
+
109
+ ### 5. 組織のスキャフォールド
110
+
111
+ ユーザーのプロジェクトとニーズに基づき、初期の組織構造を提案:
112
+ - ソロ開発者 → `engineering` 部門に `dev-assistant` 一人
113
+ - コンテンツ制作者 → `content` と `research` 部門
114
+ - スタートアップ創業者 → `engineering`, `marketing`, `operations`
115
+
116
+ 作る前に必ず確認を取る。
117
+
118
+ ### 6. cron ジョブの提案
119
+
120
+ プロジェクトに合わせて有用な定期ジョブを提案:
121
+ - 日次スタンドアップ要約
122
+ - 週次レポート
123
+ - コードレビューのリマインダ
124
+
125
+ 承認されたジョブだけ作成する。
126
+
127
+ ### 7. BOOTSTRAP.md を削除(重要)
128
+
129
+ オンボーディングが完了したら、**必ず** BOOTSTRAP.md を削除してください:
130
+
131
+ ```bash
132
+ rm ~/.ryoko/BOOTSTRAP.md
133
+ ```
134
+
135
+ 削除しないと、次回セッションでも BOOTSTRAP.md が読まれてオンボーディングがループします。
136
+
137
+ ### 8. 締めくくり
138
+
139
+ 何をセットアップしたかを短くまとめ、次の一歩を提案:
140
+ - 「従業員にタスクを委譲してみてください」
141
+ - 「カスタムスキルを作りたければ言ってください」
142
+ - 「Slack コネクタを設定すれば通知を受け取れます」
143
+
144
+ 最後に「{{portalName}} として動きます」と一言宣言する。
145
+
146
+ ---
147
+
148
+ ## Error Handling
149
+
150
+ - `~/.ryoko/knowledge/` が無ければ作成する(通常は `ryoko setup` で作られているはず)
151
+ - ユーザーが圧倒されている様子なら簡素化 — 1部門・1従業員だけ提案
152
+ - ユーザーがオンボーディングをスキップしたい場合、それを尊重して BOOTSTRAP.md を削除してから終了する
153
+ - `IDENTITY.md` などのファイルが存在しない場合は、誤って削除された可能性がある。まずバックアップから戻す(`ryoko backup list`、`ryoko backup restore <id> --only persona,memory --dry-run`)。バックアップに無ければ、`ryoko setup` の実行を促す(無いファイルだけを雛形から作る)
@@ -0,0 +1,35 @@
1
+ ---
2
+ name: openryoko-config
3
+ description: OpenRyokoの機能・仕組みを説明し、対象インスタンスの設定を調査・変更・検証する。モデル、Claude Code/Codexフォールバック、Jevの空気読み、接続先や運用設定の依頼に使う。
4
+ ---
5
+
6
+ # OpenRyokoの設定
7
+
8
+ ユーザーの「こう動いてほしい」を、稼働しているOpenRyokoの設定と検証結果に落とし込む。説明の依頼なら説明まで、変更の依頼なら必要な変更と反映確認まで進める。設定を依頼されたことを、公開・配信・認証解除や別インスタンス変更の許可に拡張しない。
9
+
10
+ ## まず対象と対応機能を確認する
11
+
12
+ 1. 対象のインスタンス名、実行ホスト/コンテナ、設定ホーム、gateway接続先、起動方法を確認する。設定ホームと作業ディレクトリは別物。`~/.ryoko` やポート7777を決め打ちしない。
13
+ 2. 依頼に関係する設定とAPIの状態を読む。`ryoko api` は選択インスタンスの認証を扱う。カスタムホームなら `RYOKO_HOME`、名前付きなら `ryoko -i <name>` を全コマンドで一貫させる。ホスト側とコンテナ内の同名パス・CLI・認証は同一とは限らない。
14
+ 3. CLIの `--version`、起動中プロセスの実体/イメージ、該当パッケージの実装を照合する。`config.yaml` の `jinn.version` はマイグレーションの記録であり、稼働コードの証明ではない。
15
+ 4. 下の参照資料から今回必要なものだけ読む。稼働パッケージの `src/`、またはnpm同梱の `dist/src/`(`.js` / `.d.ts`)を根拠にする。型、サンプル、UIにキーがあるだけでは実装済みと判断しない。呼び出し元まで追う。
16
+
17
+ | 依頼 | 読む資料 |
18
+ |---|---|
19
+ | 機能を知りたい、接続・人格・モデル・運用を設定したい | [設定と反映方法](references/platform.md) |
20
+ | Claude Code/Codexの利用制限・無応答・タイムアウト・切り戻し | [実行エンジンとフォールバック](references/engine-fallback.md) |
21
+ | Slackで空気を読む、Jevを有効化、判定用CLIを減らす | [JevとSlackの応答判定](references/jev.md) |
22
+ | 更新に合わせてCronを点検・改善し、結果を知らせる | [更新後の運用点検](references/maintenance.md) |
23
+
24
+ 開発中機能には対応済みの稼働実装が必要。未対応なら有効にならないキーを書いて成功扱いしない。利用可能な代替と、必要な更新・反映作業を具体化する。設定依頼だけで開発ブランチのマージやパッケージ公開まで行わない。
25
+
26
+ ## 変更と検証
27
+
28
+ - 希望する動作、変更するキー、影響範囲、再起動の要否を短く示す。対象や選択が会話から確定していれば、同じ許可を聞き直さない。不足が結果を左右するときだけ確認する。
29
+ - 既存設定を読み、変更対象だけの差分を作る。gateway稼働中は原則 `PUT /api/config` の部分更新を使う。配列は全置換なので、`connectors.instances` やモデル一覧は既存要素を保持する。`GET /api/config` のマスク値 `***` は「保存済みの値を保つ」の印で、`PUT` に送り返してよい。`config.yaml` を直接編集するときは `***` を書かない。
30
+ - 直接編集が必要なら、対象ファイルを所有者だけが読める場所にバックアップし、最新内容との差分を確認して、YAML/JSONを検証してから同じディレクトリ内でatomic writeする。無関係な設定・秘密・コメントを不用意に置換しない。
31
+ - API成功は保存の確認にすぎない。設定の再読込、reloadログ、コネクタのhealth、対象経路の動作を確認する。CLIインストールとログイン/モデル利用権限も別々に確認する。
32
+ - 再起動が必要なら起動方法に合わせる。自分を実行中のgatewayを停止すると確認できなくなるため、外側の管理プロセスで反映・確認する手段を整える。無関係なインスタンスを止めない。
33
+ - 不具合時は今回の差分を戻し、再度反映を確認する。変更後に他者が編集した設定を古いバックアップで丸ごと上書きしない。
34
+
35
+ 報告には対象、変更した設定、反映・検証結果、残る制約を含める。秘密値や会話本文を報告・共有スキルに転記しない。故障修復は同梱 `self-heal`、社員の作成・役割変更は `management`、定期ジョブは `cron-manager`、バージョン移行は `migrate` の該当手順も参照する。