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.
- package/dist/bin/jimmy.js +51 -1
- package/dist/bin/jimmy.js.map +1 -1
- package/dist/package.json +2 -1
- package/dist/src/backup/archive.d.ts +65 -0
- package/dist/src/backup/archive.d.ts.map +1 -0
- package/dist/src/backup/archive.js +214 -0
- package/dist/src/backup/archive.js.map +1 -0
- package/dist/src/backup/catalog.d.ts +64 -0
- package/dist/src/backup/catalog.d.ts.map +1 -0
- package/dist/src/backup/catalog.js +252 -0
- package/dist/src/backup/catalog.js.map +1 -0
- package/dist/src/backup/database-restore.d.ts +63 -0
- package/dist/src/backup/database-restore.d.ts.map +1 -0
- package/dist/src/backup/database-restore.js +236 -0
- package/dist/src/backup/database-restore.js.map +1 -0
- package/dist/src/backup/database-source.d.ts +70 -0
- package/dist/src/backup/database-source.d.ts.map +1 -0
- package/dist/src/backup/database-source.js +70 -0
- package/dist/src/backup/database-source.js.map +1 -0
- package/dist/src/backup/format.d.ts +4 -0
- package/dist/src/backup/format.d.ts.map +1 -0
- package/dist/src/backup/format.js +15 -0
- package/dist/src/backup/format.js.map +1 -0
- package/dist/src/backup/gateway-liveness.d.ts +44 -0
- package/dist/src/backup/gateway-liveness.d.ts.map +1 -0
- package/dist/src/backup/gateway-liveness.js +120 -0
- package/dist/src/backup/gateway-liveness.js.map +1 -0
- package/dist/src/backup/inspect.d.ts +45 -0
- package/dist/src/backup/inspect.d.ts.map +1 -0
- package/dist/src/backup/inspect.js +291 -0
- package/dist/src/backup/inspect.js.map +1 -0
- package/dist/src/backup/layout.d.ts +11 -0
- package/dist/src/backup/layout.d.ts.map +1 -0
- package/dist/src/backup/layout.js +16 -0
- package/dist/src/backup/layout.js.map +1 -0
- package/dist/src/backup/limits.d.ts +54 -0
- package/dist/src/backup/limits.d.ts.map +1 -0
- package/dist/src/backup/limits.js +59 -0
- package/dist/src/backup/limits.js.map +1 -0
- package/dist/src/backup/manifest.d.ts +45 -0
- package/dist/src/backup/manifest.d.ts.map +1 -0
- package/dist/src/backup/manifest.js +77 -0
- package/dist/src/backup/manifest.js.map +1 -0
- package/dist/src/backup/restore.d.ts +73 -0
- package/dist/src/backup/restore.d.ts.map +1 -0
- package/dist/src/backup/restore.js +685 -0
- package/dist/src/backup/restore.js.map +1 -0
- package/dist/src/backup/run.d.ts +76 -0
- package/dist/src/backup/run.d.ts.map +1 -0
- package/dist/src/backup/run.js +181 -0
- package/dist/src/backup/run.js.map +1 -0
- package/dist/src/backup/scheduler.d.ts +51 -0
- package/dist/src/backup/scheduler.d.ts.map +1 -0
- package/dist/src/backup/scheduler.js +198 -0
- package/dist/src/backup/scheduler.js.map +1 -0
- package/dist/src/backup/settings.d.ts +44 -0
- package/dist/src/backup/settings.d.ts.map +1 -0
- package/dist/src/backup/settings.js +91 -0
- package/dist/src/backup/settings.js.map +1 -0
- package/dist/src/backup/space.d.ts +22 -0
- package/dist/src/backup/space.d.ts.map +1 -0
- package/dist/src/backup/space.js +47 -0
- package/dist/src/backup/space.js.map +1 -0
- package/dist/src/backup/state.d.ts +46 -0
- package/dist/src/backup/state.d.ts.map +1 -0
- package/dist/src/backup/state.js +137 -0
- package/dist/src/backup/state.js.map +1 -0
- package/dist/src/backup/tar.d.ts +64 -0
- package/dist/src/backup/tar.d.ts.map +1 -0
- package/dist/src/backup/tar.js +274 -0
- package/dist/src/backup/tar.js.map +1 -0
- package/dist/src/backup/targets.d.ts +85 -0
- package/dist/src/backup/targets.d.ts.map +1 -0
- package/dist/src/backup/targets.js +104 -0
- package/dist/src/backup/targets.js.map +1 -0
- package/dist/src/backup/walk.d.ts +42 -0
- package/dist/src/backup/walk.d.ts.map +1 -0
- package/dist/src/backup/walk.js +324 -0
- package/dist/src/backup/walk.js.map +1 -0
- package/dist/src/cli/backup.d.ts +45 -0
- package/dist/src/cli/backup.d.ts.map +1 -0
- package/dist/src/cli/backup.js +344 -0
- package/dist/src/cli/backup.js.map +1 -0
- package/dist/src/cli/bundled-skills.d.ts +7 -1
- package/dist/src/cli/bundled-skills.d.ts.map +1 -1
- package/dist/src/cli/bundled-skills.js +12 -2
- package/dist/src/cli/bundled-skills.js.map +1 -1
- package/dist/src/cli/config-failure.d.ts +18 -0
- package/dist/src/cli/config-failure.d.ts.map +1 -0
- package/dist/src/cli/config-failure.js +39 -0
- package/dist/src/cli/config-failure.js.map +1 -0
- package/dist/src/cli/gateway-audit.d.ts +3 -0
- package/dist/src/cli/gateway-audit.d.ts.map +1 -1
- package/dist/src/cli/gateway-audit.js +61 -14
- package/dist/src/cli/gateway-audit.js.map +1 -1
- package/dist/src/cli/gateway-url-backup.d.ts +21 -0
- package/dist/src/cli/gateway-url-backup.d.ts.map +1 -0
- package/dist/src/cli/gateway-url-backup.js +87 -0
- package/dist/src/cli/gateway-url-backup.js.map +1 -0
- package/dist/src/cli/home-copy.d.ts +37 -0
- package/dist/src/cli/home-copy.d.ts.map +1 -0
- package/dist/src/cli/home-copy.js +155 -0
- package/dist/src/cli/home-copy.js.map +1 -0
- package/dist/src/cli/interactive-config.d.ts +5 -0
- package/dist/src/cli/interactive-config.d.ts.map +1 -1
- package/dist/src/cli/interactive-config.js +16 -7
- package/dist/src/cli/interactive-config.js.map +1 -1
- package/dist/src/cli/migrate.d.ts +20 -0
- package/dist/src/cli/migrate.d.ts.map +1 -1
- package/dist/src/cli/migrate.js +365 -68
- package/dist/src/cli/migrate.js.map +1 -1
- package/dist/src/cli/migration-declarations.d.ts +24 -0
- package/dist/src/cli/migration-declarations.d.ts.map +1 -0
- package/dist/src/cli/migration-declarations.js +54 -0
- package/dist/src/cli/migration-declarations.js.map +1 -0
- package/dist/src/cli/start.d.ts.map +1 -1
- package/dist/src/cli/start.js +40 -1
- package/dist/src/cli/start.js.map +1 -1
- package/dist/src/connectors/chunked-send.d.ts +27 -0
- package/dist/src/connectors/chunked-send.d.ts.map +1 -0
- package/dist/src/connectors/chunked-send.js +40 -0
- package/dist/src/connectors/chunked-send.js.map +1 -0
- package/dist/src/connectors/cron/index.d.ts +10 -0
- package/dist/src/connectors/cron/index.d.ts.map +1 -1
- package/dist/src/connectors/cron/index.js +26 -3
- package/dist/src/connectors/cron/index.js.map +1 -1
- package/dist/src/connectors/discord/attachments.d.ts +25 -0
- package/dist/src/connectors/discord/attachments.d.ts.map +1 -0
- package/dist/src/connectors/discord/attachments.js +33 -0
- package/dist/src/connectors/discord/attachments.js.map +1 -0
- package/dist/src/connectors/discord/format.d.ts +17 -1
- package/dist/src/connectors/discord/format.d.ts.map +1 -1
- package/dist/src/connectors/discord/format.js +36 -6
- package/dist/src/connectors/discord/format.js.map +1 -1
- package/dist/src/connectors/discord/index.d.ts +12 -0
- package/dist/src/connectors/discord/index.d.ts.map +1 -1
- package/dist/src/connectors/discord/index.js +47 -40
- package/dist/src/connectors/discord/index.js.map +1 -1
- package/dist/src/connectors/discord/remote.d.ts +45 -1
- package/dist/src/connectors/discord/remote.d.ts.map +1 -1
- package/dist/src/connectors/discord/remote.js +147 -22
- package/dist/src/connectors/discord/remote.js.map +1 -1
- package/dist/src/connectors/slack/attachments.d.ts +25 -0
- package/dist/src/connectors/slack/attachments.d.ts.map +1 -0
- package/dist/src/connectors/slack/attachments.js +32 -0
- package/dist/src/connectors/slack/attachments.js.map +1 -0
- package/dist/src/connectors/slack/auth-test-cache.d.ts +22 -0
- package/dist/src/connectors/slack/auth-test-cache.d.ts.map +1 -0
- package/dist/src/connectors/slack/auth-test-cache.js +34 -0
- package/dist/src/connectors/slack/auth-test-cache.js.map +1 -0
- package/dist/src/connectors/slack/format.d.ts +6 -1
- package/dist/src/connectors/slack/format.d.ts.map +1 -1
- package/dist/src/connectors/slack/format.js +65 -13
- package/dist/src/connectors/slack/format.js.map +1 -1
- package/dist/src/connectors/slack/index.d.ts +4 -0
- package/dist/src/connectors/slack/index.d.ts.map +1 -1
- package/dist/src/connectors/slack/index.js +64 -52
- package/dist/src/connectors/slack/index.js.map +1 -1
- package/dist/src/connectors/slack/provider-auth-blocks.d.ts +62 -0
- package/dist/src/connectors/slack/provider-auth-blocks.d.ts.map +1 -0
- package/dist/src/connectors/slack/provider-auth-blocks.js +204 -0
- package/dist/src/connectors/slack/provider-auth-blocks.js.map +1 -0
- package/dist/src/connectors/slack/provider-auth.d.ts +126 -0
- package/dist/src/connectors/slack/provider-auth.d.ts.map +1 -0
- package/dist/src/connectors/slack/provider-auth.js +357 -0
- package/dist/src/connectors/slack/provider-auth.js.map +1 -0
- package/dist/src/connectors/telegram/index.d.ts +5 -0
- package/dist/src/connectors/telegram/index.d.ts.map +1 -1
- package/dist/src/connectors/telegram/index.js +14 -22
- package/dist/src/connectors/telegram/index.js.map +1 -1
- package/dist/src/connectors/whatsapp/index.d.ts +3 -0
- package/dist/src/connectors/whatsapp/index.d.ts.map +1 -1
- package/dist/src/connectors/whatsapp/index.js +33 -14
- package/dist/src/connectors/whatsapp/index.js.map +1 -1
- package/dist/src/cron/alert-throttle.d.ts +28 -0
- package/dist/src/cron/alert-throttle.d.ts.map +1 -0
- package/dist/src/cron/alert-throttle.js +106 -0
- package/dist/src/cron/alert-throttle.js.map +1 -0
- package/dist/src/cron/jobs.d.ts +8 -0
- package/dist/src/cron/jobs.d.ts.map +1 -1
- package/dist/src/cron/jobs.js +27 -1
- package/dist/src/cron/jobs.js.map +1 -1
- package/dist/src/cron/run-outcome.d.ts +28 -0
- package/dist/src/cron/run-outcome.d.ts.map +1 -0
- package/dist/src/cron/run-outcome.js +66 -0
- package/dist/src/cron/run-outcome.js.map +1 -0
- package/dist/src/cron/runner.d.ts.map +1 -1
- package/dist/src/cron/runner.js +68 -5
- package/dist/src/cron/runner.js.map +1 -1
- package/dist/src/cron/scheduler.d.ts +8 -1
- package/dist/src/cron/scheduler.d.ts.map +1 -1
- package/dist/src/cron/scheduler.js +11 -4
- package/dist/src/cron/scheduler.js.map +1 -1
- package/dist/src/cron/waiting-fires.d.ts +18 -0
- package/dist/src/cron/waiting-fires.d.ts.map +1 -0
- package/dist/src/cron/waiting-fires.js +49 -0
- package/dist/src/cron/waiting-fires.js.map +1 -0
- package/dist/src/engines/claude-interactive.d.ts +19 -3
- package/dist/src/engines/claude-interactive.d.ts.map +1 -1
- package/dist/src/engines/claude-interactive.js +42 -17
- package/dist/src/engines/claude-interactive.js.map +1 -1
- package/dist/src/engines/claude.d.ts.map +1 -1
- package/dist/src/engines/claude.js +38 -5
- package/dist/src/engines/claude.js.map +1 -1
- package/dist/src/engines/codex.d.ts.map +1 -1
- package/dist/src/engines/codex.js +1 -0
- package/dist/src/engines/codex.js.map +1 -1
- package/dist/src/engines/gemini.d.ts.map +1 -1
- package/dist/src/engines/gemini.js +1 -0
- package/dist/src/engines/gemini.js.map +1 -1
- package/dist/src/gateway/api.d.ts.map +1 -1
- package/dist/src/gateway/api.js +184 -160
- package/dist/src/gateway/api.js.map +1 -1
- package/dist/src/gateway/config-redaction.d.ts +32 -0
- package/dist/src/gateway/config-redaction.d.ts.map +1 -0
- package/dist/src/gateway/config-redaction.js +139 -0
- package/dist/src/gateway/config-redaction.js.map +1 -0
- package/dist/src/gateway/config-revision.d.ts +46 -0
- package/dist/src/gateway/config-revision.d.ts.map +1 -0
- package/dist/src/gateway/config-revision.js +63 -0
- package/dist/src/gateway/config-revision.js.map +1 -0
- package/dist/src/gateway/connector-config.d.ts +21 -0
- package/dist/src/gateway/connector-config.d.ts.map +1 -0
- package/dist/src/gateway/connector-config.js +24 -0
- package/dist/src/gateway/connector-config.js.map +1 -0
- package/dist/src/gateway/daemon-entry.js +5 -0
- package/dist/src/gateway/daemon-entry.js.map +1 -1
- package/dist/src/gateway/engine-health-monitor.d.ts +67 -0
- package/dist/src/gateway/engine-health-monitor.d.ts.map +1 -0
- package/dist/src/gateway/engine-health-monitor.js +221 -0
- package/dist/src/gateway/engine-health-monitor.js.map +1 -0
- package/dist/src/gateway/files.d.ts +7 -1
- package/dist/src/gateway/files.d.ts.map +1 -1
- package/dist/src/gateway/files.js +110 -217
- package/dist/src/gateway/files.js.map +1 -1
- package/dist/src/gateway/onboarding-personalize.d.ts +2 -0
- package/dist/src/gateway/onboarding-personalize.d.ts.map +1 -1
- package/dist/src/gateway/onboarding-personalize.js +17 -1
- package/dist/src/gateway/onboarding-personalize.js.map +1 -1
- package/dist/src/gateway/portal-config.d.ts +17 -3
- package/dist/src/gateway/portal-config.d.ts.map +1 -1
- package/dist/src/gateway/portal-config.js +52 -3
- package/dist/src/gateway/portal-config.js.map +1 -1
- package/dist/src/gateway/request-origin.d.ts +9 -0
- package/dist/src/gateway/request-origin.d.ts.map +1 -1
- package/dist/src/gateway/request-origin.js +10 -0
- package/dist/src/gateway/request-origin.js.map +1 -1
- package/dist/src/gateway/server.d.ts.map +1 -1
- package/dist/src/gateway/server.js +82 -59
- package/dist/src/gateway/server.js.map +1 -1
- package/dist/src/gateway/slack-connect-rollback.d.ts +23 -0
- package/dist/src/gateway/slack-connect-rollback.d.ts.map +1 -0
- package/dist/src/gateway/slack-connect-rollback.js +53 -0
- package/dist/src/gateway/slack-connect-rollback.js.map +1 -0
- package/dist/src/gateway/status-reconciler.d.ts +25 -7
- package/dist/src/gateway/status-reconciler.d.ts.map +1 -1
- package/dist/src/gateway/status-reconciler.js +86 -43
- package/dist/src/gateway/status-reconciler.js.map +1 -1
- package/dist/src/gateway/watcher.d.ts.map +1 -1
- package/dist/src/gateway/watcher.js +44 -3
- package/dist/src/gateway/watcher.js.map +1 -1
- package/dist/src/mcp/gateway-server.js +21 -3
- package/dist/src/mcp/gateway-server.js.map +1 -1
- package/dist/src/mcp/resolver.d.ts.map +1 -1
- package/dist/src/mcp/resolver.js +51 -1
- package/dist/src/mcp/resolver.js.map +1 -1
- package/dist/src/models/service.d.ts.map +1 -1
- package/dist/src/models/service.js +14 -8
- package/dist/src/models/service.js.map +1 -1
- package/dist/src/provider-auth/discovery.d.ts +16 -0
- package/dist/src/provider-auth/discovery.d.ts.map +1 -0
- package/dist/src/provider-auth/discovery.js +66 -0
- package/dist/src/provider-auth/discovery.js.map +1 -0
- package/dist/src/provider-auth/failure-notices.d.ts +29 -0
- package/dist/src/provider-auth/failure-notices.d.ts.map +1 -0
- package/dist/src/provider-auth/failure-notices.js +48 -0
- package/dist/src/provider-auth/failure-notices.js.map +1 -0
- package/dist/src/provider-auth/failure-signal.d.ts +22 -0
- package/dist/src/provider-auth/failure-signal.d.ts.map +1 -0
- package/dist/src/provider-auth/failure-signal.js +79 -0
- package/dist/src/provider-auth/failure-signal.js.map +1 -0
- package/dist/src/provider-auth/index.d.ts +26 -0
- package/dist/src/provider-auth/index.d.ts.map +1 -0
- package/dist/src/provider-auth/index.js +51 -0
- package/dist/src/provider-auth/index.js.map +1 -0
- package/dist/src/provider-auth/input.d.ts +44 -0
- package/dist/src/provider-auth/input.d.ts.map +1 -0
- package/dist/src/provider-auth/input.js +86 -0
- package/dist/src/provider-auth/input.js.map +1 -0
- package/dist/src/provider-auth/providers.d.ts +26 -0
- package/dist/src/provider-auth/providers.d.ts.map +1 -0
- package/dist/src/provider-auth/providers.js +86 -0
- package/dist/src/provider-auth/providers.js.map +1 -0
- package/dist/src/provider-auth/runtime.d.ts +21 -0
- package/dist/src/provider-auth/runtime.d.ts.map +1 -0
- package/dist/src/provider-auth/runtime.js +104 -0
- package/dist/src/provider-auth/runtime.js.map +1 -0
- package/dist/src/provider-auth/service.d.ts +70 -0
- package/dist/src/provider-auth/service.d.ts.map +1 -0
- package/dist/src/provider-auth/service.js +349 -0
- package/dist/src/provider-auth/service.js.map +1 -0
- package/dist/src/provider-auth/terminal.d.ts +21 -0
- package/dist/src/provider-auth/terminal.d.ts.map +1 -0
- package/dist/src/provider-auth/terminal.js +46 -0
- package/dist/src/provider-auth/terminal.js.map +1 -0
- package/dist/src/provider-auth/types.d.ts +123 -0
- package/dist/src/provider-auth/types.d.ts.map +1 -0
- package/dist/src/provider-auth/types.js +10 -0
- package/dist/src/provider-auth/types.js.map +1 -0
- package/dist/src/sessions/accounting.d.ts +3 -0
- package/dist/src/sessions/accounting.d.ts.map +1 -1
- package/dist/src/sessions/accounting.js +5 -0
- package/dist/src/sessions/accounting.js.map +1 -1
- package/dist/src/sessions/backup-integrity.d.ts +45 -0
- package/dist/src/sessions/backup-integrity.d.ts.map +1 -0
- package/dist/src/sessions/backup-integrity.js +122 -0
- package/dist/src/sessions/backup-integrity.js.map +1 -0
- package/dist/src/sessions/backup.d.ts +40 -2
- package/dist/src/sessions/backup.d.ts.map +1 -1
- package/dist/src/sessions/backup.js +88 -12
- package/dist/src/sessions/backup.js.map +1 -1
- package/dist/src/sessions/callbacks.d.ts +9 -0
- package/dist/src/sessions/callbacks.d.ts.map +1 -1
- package/dist/src/sessions/callbacks.js +55 -10
- package/dist/src/sessions/callbacks.js.map +1 -1
- package/dist/src/sessions/completion-batching.d.ts +82 -0
- package/dist/src/sessions/completion-batching.d.ts.map +1 -0
- package/dist/src/sessions/completion-batching.js +126 -0
- package/dist/src/sessions/completion-batching.js.map +1 -0
- package/dist/src/sessions/connector-command-guard.d.ts +66 -0
- package/dist/src/sessions/connector-command-guard.d.ts.map +1 -0
- package/dist/src/sessions/connector-command-guard.js +145 -0
- package/dist/src/sessions/connector-command-guard.js.map +1 -0
- package/dist/src/sessions/context.d.ts.map +1 -1
- package/dist/src/sessions/context.js +3 -4
- package/dist/src/sessions/context.js.map +1 -1
- package/dist/src/sessions/engine-fallback.d.ts +43 -1
- package/dist/src/sessions/engine-fallback.d.ts.map +1 -1
- package/dist/src/sessions/engine-fallback.js +266 -15
- package/dist/src/sessions/engine-fallback.js.map +1 -1
- package/dist/src/sessions/engine-health-gate.d.ts +83 -0
- package/dist/src/sessions/engine-health-gate.d.ts.map +1 -0
- package/dist/src/sessions/engine-health-gate.js +186 -0
- package/dist/src/sessions/engine-health-gate.js.map +1 -0
- package/dist/src/sessions/engine-login.d.ts +58 -0
- package/dist/src/sessions/engine-login.d.ts.map +1 -0
- package/dist/src/sessions/engine-login.js +107 -0
- package/dist/src/sessions/engine-login.js.map +1 -0
- package/dist/src/sessions/fork.d.ts.map +1 -1
- package/dist/src/sessions/fork.js +3 -1
- package/dist/src/sessions/fork.js.map +1 -1
- package/dist/src/sessions/goal-execution.d.ts.map +1 -1
- package/dist/src/sessions/goal-execution.js +8 -1
- package/dist/src/sessions/goal-execution.js.map +1 -1
- package/dist/src/sessions/limit-failure-notice.d.ts +41 -0
- package/dist/src/sessions/limit-failure-notice.d.ts.map +1 -0
- package/dist/src/sessions/limit-failure-notice.js +87 -0
- package/dist/src/sessions/limit-failure-notice.js.map +1 -0
- package/dist/src/sessions/lost-turn.d.ts +39 -0
- package/dist/src/sessions/lost-turn.d.ts.map +1 -0
- package/dist/src/sessions/lost-turn.js +32 -0
- package/dist/src/sessions/lost-turn.js.map +1 -0
- package/dist/src/sessions/manager.d.ts.map +1 -1
- package/dist/src/sessions/manager.js +104 -47
- package/dist/src/sessions/manager.js.map +1 -1
- package/dist/src/sessions/new-session-engine.d.ts +42 -0
- package/dist/src/sessions/new-session-engine.d.ts.map +1 -0
- package/dist/src/sessions/new-session-engine.js +100 -0
- package/dist/src/sessions/new-session-engine.js.map +1 -0
- package/dist/src/sessions/origin-delivery.d.ts +50 -4
- package/dist/src/sessions/origin-delivery.d.ts.map +1 -1
- package/dist/src/sessions/origin-delivery.js +108 -9
- package/dist/src/sessions/origin-delivery.js.map +1 -1
- package/dist/src/sessions/queue.d.ts +14 -0
- package/dist/src/sessions/queue.d.ts.map +1 -1
- package/dist/src/sessions/queue.js +38 -2
- package/dist/src/sessions/queue.js.map +1 -1
- package/dist/src/sessions/registry.d.ts +4 -2
- package/dist/src/sessions/registry.d.ts.map +1 -1
- package/dist/src/sessions/registry.js +21 -4
- package/dist/src/sessions/registry.js.map +1 -1
- package/dist/src/sessions/reply-disposition.d.ts +8 -0
- package/dist/src/sessions/reply-disposition.d.ts.map +1 -1
- package/dist/src/sessions/reply-disposition.js +8 -0
- package/dist/src/sessions/reply-disposition.js.map +1 -1
- package/dist/src/sessions/restart-resume.d.ts +234 -0
- package/dist/src/sessions/restart-resume.d.ts.map +1 -0
- package/dist/src/sessions/restart-resume.js +596 -0
- package/dist/src/sessions/restart-resume.js.map +1 -0
- package/dist/src/sessions/speaker-prefix.d.ts.map +1 -1
- package/dist/src/sessions/speaker-prefix.js +3 -1
- package/dist/src/sessions/speaker-prefix.js.map +1 -1
- package/dist/src/sessions/turn-delivery.d.ts +26 -0
- package/dist/src/sessions/turn-delivery.d.ts.map +1 -0
- package/dist/src/sessions/turn-delivery.js +34 -0
- package/dist/src/sessions/turn-delivery.js.map +1 -0
- package/dist/src/sessions/unrequested-stop.d.ts +26 -0
- package/dist/src/sessions/unrequested-stop.d.ts.map +1 -0
- package/dist/src/sessions/unrequested-stop.js +19 -0
- package/dist/src/sessions/unrequested-stop.js.map +1 -0
- package/dist/src/sessions/usage-limit-wait.d.ts +14 -0
- package/dist/src/sessions/usage-limit-wait.d.ts.map +1 -0
- package/dist/src/sessions/usage-limit-wait.js +9 -0
- package/dist/src/sessions/usage-limit-wait.js.map +1 -0
- package/dist/src/shared/attachment-download.d.ts +41 -0
- package/dist/src/shared/attachment-download.d.ts.map +1 -0
- package/dist/src/shared/attachment-download.js +110 -0
- package/dist/src/shared/attachment-download.js.map +1 -0
- package/dist/src/shared/attachment-notice.d.ts +24 -0
- package/dist/src/shared/attachment-notice.d.ts.map +1 -0
- package/dist/src/shared/attachment-notice.js +37 -0
- package/dist/src/shared/attachment-notice.js.map +1 -0
- package/dist/src/shared/attachments.d.ts +65 -0
- package/dist/src/shared/attachments.d.ts.map +1 -0
- package/dist/src/shared/attachments.js +153 -0
- package/dist/src/shared/attachments.js.map +1 -0
- package/dist/src/shared/childEnv.d.ts +15 -0
- package/dist/src/shared/childEnv.d.ts.map +1 -1
- package/dist/src/shared/childEnv.js +15 -0
- package/dist/src/shared/childEnv.js.map +1 -1
- package/dist/src/shared/claude-auto-memory.d.ts +33 -0
- package/dist/src/shared/claude-auto-memory.d.ts.map +1 -0
- package/dist/src/shared/claude-auto-memory.js +156 -0
- package/dist/src/shared/claude-auto-memory.js.map +1 -0
- package/dist/src/shared/claude-limit-reset.d.ts +54 -0
- package/dist/src/shared/claude-limit-reset.d.ts.map +1 -0
- package/dist/src/shared/claude-limit-reset.js +99 -0
- package/dist/src/shared/claude-limit-reset.js.map +1 -0
- package/dist/src/shared/config-error.d.ts +21 -0
- package/dist/src/shared/config-error.d.ts.map +1 -0
- package/dist/src/shared/config-error.js +37 -0
- package/dist/src/shared/config-error.js.map +1 -0
- package/dist/src/shared/config-file.d.ts +57 -0
- package/dist/src/shared/config-file.d.ts.map +1 -0
- package/dist/src/shared/config-file.js +217 -0
- package/dist/src/shared/config-file.js.map +1 -0
- package/dist/src/shared/config-yaml-edit.d.ts +20 -0
- package/dist/src/shared/config-yaml-edit.d.ts.map +1 -0
- package/dist/src/shared/config-yaml-edit.js +468 -0
- package/dist/src/shared/config-yaml-edit.js.map +1 -0
- package/dist/src/shared/config.d.ts.map +1 -1
- package/dist/src/shared/config.js +12 -4
- package/dist/src/shared/config.js.map +1 -1
- package/dist/src/shared/engine-fallback.d.ts +22 -0
- package/dist/src/shared/engine-fallback.d.ts.map +1 -1
- package/dist/src/shared/engine-fallback.js +55 -4
- package/dist/src/shared/engine-fallback.js.map +1 -1
- package/dist/src/shared/engine-health.d.ts +16 -0
- package/dist/src/shared/engine-health.d.ts.map +1 -1
- package/dist/src/shared/engine-health.js +42 -0
- package/dist/src/shared/engine-health.js.map +1 -1
- package/dist/src/shared/list-alignment.d.ts +23 -0
- package/dist/src/shared/list-alignment.d.ts.map +1 -0
- package/dist/src/shared/list-alignment.js +61 -0
- package/dist/src/shared/list-alignment.js.map +1 -0
- package/dist/src/shared/logger.d.ts.map +1 -1
- package/dist/src/shared/logger.js +104 -33
- package/dist/src/shared/logger.js.map +1 -1
- package/dist/src/shared/map-limited.d.ts +11 -0
- package/dist/src/shared/map-limited.d.ts.map +1 -0
- package/dist/src/shared/map-limited.js +30 -0
- package/dist/src/shared/map-limited.js.map +1 -0
- package/dist/src/shared/oneShotCli.d.ts.map +1 -1
- package/dist/src/shared/oneShotCli.js +4 -2
- package/dist/src/shared/oneShotCli.js.map +1 -1
- package/dist/src/shared/partial-delivery.d.ts +24 -0
- package/dist/src/shared/partial-delivery.d.ts.map +1 -0
- package/dist/src/shared/partial-delivery.js +46 -0
- package/dist/src/shared/partial-delivery.js.map +1 -0
- package/dist/src/shared/process-safety-net.d.ts +44 -0
- package/dist/src/shared/process-safety-net.d.ts.map +1 -0
- package/dist/src/shared/process-safety-net.js +88 -0
- package/dist/src/shared/process-safety-net.js.map +1 -0
- package/dist/src/shared/rateLimit.d.ts +45 -2
- package/dist/src/shared/rateLimit.d.ts.map +1 -1
- package/dist/src/shared/rateLimit.js +64 -2
- package/dist/src/shared/rateLimit.js.map +1 -1
- package/dist/src/shared/redact.d.ts.map +1 -1
- package/dist/src/shared/redact.js +11 -1
- package/dist/src/shared/redact.js.map +1 -1
- package/dist/src/shared/safe-file-name.d.ts +9 -0
- package/dist/src/shared/safe-file-name.d.ts.map +1 -0
- package/dist/src/shared/safe-file-name.js +16 -0
- package/dist/src/shared/safe-file-name.js.map +1 -0
- package/dist/src/shared/terminal-safe-text.d.ts +2 -0
- package/dist/src/shared/terminal-safe-text.d.ts.map +1 -0
- package/dist/src/shared/terminal-safe-text.js +21 -0
- package/dist/src/shared/terminal-safe-text.js.map +1 -0
- package/dist/src/shared/types.d.ts +75 -4
- package/dist/src/shared/types.d.ts.map +1 -1
- package/dist/src/skills-sync/apply.d.ts +21 -0
- package/dist/src/skills-sync/apply.d.ts.map +1 -0
- package/dist/src/skills-sync/apply.js +209 -0
- package/dist/src/skills-sync/apply.js.map +1 -0
- package/dist/src/skills-sync/backup-run.d.ts +47 -0
- package/dist/src/skills-sync/backup-run.d.ts.map +1 -0
- package/dist/src/skills-sync/backup-run.js +150 -0
- package/dist/src/skills-sync/backup-run.js.map +1 -0
- package/dist/src/skills-sync/bounded-read.d.ts +32 -0
- package/dist/src/skills-sync/bounded-read.d.ts.map +1 -0
- package/dist/src/skills-sync/bounded-read.js +104 -0
- package/dist/src/skills-sync/bounded-read.js.map +1 -0
- package/dist/src/skills-sync/bundled.d.ts +28 -0
- package/dist/src/skills-sync/bundled.d.ts.map +1 -0
- package/dist/src/skills-sync/bundled.js +84 -0
- package/dist/src/skills-sync/bundled.js.map +1 -0
- package/dist/src/skills-sync/fingerprint.d.ts +32 -0
- package/dist/src/skills-sync/fingerprint.d.ts.map +1 -0
- package/dist/src/skills-sync/fingerprint.js +58 -0
- package/dist/src/skills-sync/fingerprint.js.map +1 -0
- package/dist/src/skills-sync/history.d.ts +44 -0
- package/dist/src/skills-sync/history.d.ts.map +1 -0
- package/dist/src/skills-sync/history.js +115 -0
- package/dist/src/skills-sync/history.js.map +1 -0
- package/dist/src/skills-sync/home-skill.d.ts +28 -0
- package/dist/src/skills-sync/home-skill.d.ts.map +1 -0
- package/dist/src/skills-sync/home-skill.js +67 -0
- package/dist/src/skills-sync/home-skill.js.map +1 -0
- package/dist/src/skills-sync/instance.d.ts +26 -0
- package/dist/src/skills-sync/instance.d.ts.map +1 -0
- package/dist/src/skills-sync/instance.js +128 -0
- package/dist/src/skills-sync/instance.js.map +1 -0
- package/dist/src/skills-sync/names.d.ts +25 -0
- package/dist/src/skills-sync/names.d.ts.map +1 -0
- package/dist/src/skills-sync/names.js +56 -0
- package/dist/src/skills-sync/names.js.map +1 -0
- package/dist/src/skills-sync/plan.d.ts +58 -0
- package/dist/src/skills-sync/plan.d.ts.map +1 -0
- package/dist/src/skills-sync/plan.js +132 -0
- package/dist/src/skills-sync/plan.js.map +1 -0
- package/dist/src/skills-sync/receipt.d.ts +61 -0
- package/dist/src/skills-sync/receipt.d.ts.map +1 -0
- package/dist/src/skills-sync/receipt.js +149 -0
- package/dist/src/skills-sync/receipt.js.map +1 -0
- package/dist/src/skills-sync/staging.d.ts +21 -0
- package/dist/src/skills-sync/staging.d.ts.map +1 -0
- package/dist/src/skills-sync/staging.js +81 -0
- package/dist/src/skills-sync/staging.js.map +1 -0
- package/dist/src/skills-sync/sync.d.ts +37 -0
- package/dist/src/skills-sync/sync.d.ts.map +1 -0
- package/dist/src/skills-sync/sync.js +201 -0
- package/dist/src/skills-sync/sync.js.map +1 -0
- package/dist/src/skills-sync/types.d.ts +66 -0
- package/dist/src/skills-sync/types.d.ts.map +1 -0
- package/dist/src/skills-sync/types.js +2 -0
- package/dist/src/skills-sync/types.js.map +1 -0
- package/dist/src/stt/config.d.ts +5 -0
- package/dist/src/stt/config.d.ts.map +1 -0
- package/dist/src/stt/config.js +18 -0
- package/dist/src/stt/config.js.map +1 -0
- package/dist/src/updates/maintenance.d.ts.map +1 -1
- package/dist/src/updates/maintenance.js +24 -4
- package/dist/src/updates/maintenance.js.map +1 -1
- package/dist/src/workflows/repository-mutex.d.ts +1 -1
- package/dist/web/404.html +1 -1
- package/dist/web/__next.__PAGE__.txt +11 -11
- package/dist/web/__next._full.txt +12 -12
- package/dist/web/__next._tree.txt +2 -2
- package/dist/web/_next/static/chunks/{0g5c5ppr8zmup.js → 20v6mri7epga5.js} +1 -1
- package/dist/web/_next/static/chunks/2u0328ngpt-ek.js +1 -0
- package/dist/web/_next/static/chunks/3f9i3f9q6v6_j.css +1 -0
- package/dist/web/_next/static/chunks/{08i7uo3uz6_fn.js → 3yy053rafgrzy.js} +1 -1
- package/dist/web/_not-found/__next._full.txt +10 -10
- package/dist/web/_not-found/__next._not-found.__PAGE__.txt +9 -9
- package/dist/web/_not-found/__next._tree.txt +2 -2
- package/dist/web/_not-found.html +1 -1
- package/dist/web/_not-found.txt +10 -10
- package/dist/web/chat/__next._full.txt +12 -12
- package/dist/web/chat/__next._tree.txt +2 -2
- package/dist/web/chat/__next.chat.__PAGE__.txt +11 -11
- package/dist/web/chat.html +1 -1
- package/dist/web/chat.txt +12 -12
- package/dist/web/cron/__next._full.txt +12 -12
- package/dist/web/cron/__next._tree.txt +2 -2
- package/dist/web/cron/__next.cron.__PAGE__.txt +11 -11
- package/dist/web/cron.html +1 -1
- package/dist/web/cron.txt +12 -12
- package/dist/web/index.html +1 -1
- package/dist/web/index.txt +12 -12
- package/dist/web/kanban/__next._full.txt +12 -12
- package/dist/web/kanban/__next._tree.txt +2 -2
- package/dist/web/kanban/__next.kanban.__PAGE__.txt +11 -11
- package/dist/web/kanban.html +1 -1
- package/dist/web/kanban.txt +12 -12
- package/dist/web/logs/__next._full.txt +12 -12
- package/dist/web/logs/__next._tree.txt +2 -2
- package/dist/web/logs/__next.logs.__PAGE__.txt +11 -11
- package/dist/web/logs.html +1 -1
- package/dist/web/logs.txt +12 -12
- package/dist/web/models/__next._full.txt +12 -12
- package/dist/web/models/__next._tree.txt +2 -2
- package/dist/web/models/__next.models.__PAGE__.txt +11 -11
- package/dist/web/models.html +1 -1
- package/dist/web/models.txt +12 -12
- package/dist/web/org/__next._full.txt +12 -12
- package/dist/web/org/__next._tree.txt +2 -2
- package/dist/web/org/__next.org.__PAGE__.txt +11 -11
- package/dist/web/org.html +1 -1
- package/dist/web/org.txt +12 -12
- package/dist/web/sessions/__next._full.txt +10 -10
- package/dist/web/sessions/__next._tree.txt +2 -2
- package/dist/web/sessions/__next.sessions.__PAGE__.txt +9 -9
- package/dist/web/sessions.html +1 -1
- package/dist/web/sessions.txt +10 -10
- package/dist/web/settings/__next._full.txt +12 -12
- package/dist/web/settings/__next._tree.txt +2 -2
- package/dist/web/settings/__next.settings.__PAGE__.txt +11 -11
- package/dist/web/settings.html +1 -1
- package/dist/web/settings.txt +12 -12
- package/dist/web/skills/__next._full.txt +12 -12
- package/dist/web/skills/__next._tree.txt +2 -2
- package/dist/web/skills/__next.skills.__PAGE__.txt +11 -11
- package/dist/web/skills.html +1 -1
- package/dist/web/skills.txt +12 -12
- package/package.json +2 -1
- package/template/AGENTS.md +48 -308
- package/template/CLAUDE.md +4 -349
- package/template/bundled-skill-history.json +377 -0
- package/template/config.default.yaml +52 -3
- package/template/docs/architecture.md +41 -3
- package/template/docs/backup.md +142 -0
- package/template/docs/connectors.md +192 -16
- package/template/docs/cron.md +30 -11
- package/template/docs/memory.md +47 -0
- package/template/docs/overview.md +6 -2
- package/template/docs/self-modification.md +11 -10
- package/template/docs/skills.md +77 -4
- package/template/migrations/0.3.0/MIGRATION.md +6 -0
- package/template/migrations/0.7.3/MIGRATION.md +6 -0
- package/template/migrations/0.7.5/MIGRATION.md +1 -1
- package/template/migrations/0.9.0/MIGRATION.md +6 -0
- package/template/migrations/2026.10.13/MIGRATION.md +76 -0
- package/template/migrations/2026.10.13/files/docs/architecture.md +112 -0
- package/template/migrations/2026.10.13/files/docs/automations.md +110 -0
- package/template/migrations/2026.10.13/files/docs/backup.md +142 -0
- package/template/migrations/2026.10.13/files/docs/connectors.md +370 -0
- package/template/migrations/2026.10.13/files/docs/cron-commands.md +52 -0
- package/template/migrations/2026.10.13/files/docs/cron.md +178 -0
- package/template/migrations/2026.10.13/files/docs/mcp.md +108 -0
- package/template/migrations/2026.10.13/files/docs/memory.md +47 -0
- package/template/migrations/2026.10.13/files/docs/org.md +111 -0
- package/template/migrations/2026.10.13/files/docs/overview.md +44 -0
- package/template/migrations/2026.10.13/files/docs/self-modification.md +71 -0
- package/template/migrations/2026.10.13/files/docs/skills.md +140 -0
- package/template/migrations/2026.10.13/files/skills/cron-manager/SKILL.md +107 -0
- package/template/migrations/2026.10.13/files/skills/management/SKILL.md +227 -0
- package/template/migrations/2026.10.13/files/skills/migrate/SKILL.md +194 -0
- package/template/migrations/2026.10.13/files/skills/onboarding/SKILL.md +153 -0
- package/template/migrations/2026.10.13/files/skills/openryoko-config/SKILL.md +35 -0
- package/template/migrations/2026.10.13/files/skills/openryoko-config/references/engine-fallback.md +98 -0
- package/template/migrations/2026.10.13/files/skills/openryoko-config/references/jev.md +89 -0
- package/template/migrations/2026.10.13/files/skills/openryoko-config/references/maintenance.md +49 -0
- package/template/migrations/2026.10.13/files/skills/openryoko-config/references/platform.md +100 -0
- package/template/migrations/2026.10.13/files/skills/self-heal/SKILL.md +187 -0
- package/template/migrations/2026.10.9/MIGRATION.md +44 -0
- package/template/migrations/2026.10.9/files/docs/memory.md +47 -0
- package/template/migrations/2026.10.9/files/skills/migrate/SKILL.md +194 -0
- package/template/migrations/2026.5.7/MIGRATION.md +6 -0
- package/template/migrations/2026.8.28/MIGRATION.md +6 -0
- package/template/migrations/2026.9.11/MIGRATION.md +6 -0
- package/template/skills/cron-manager/SKILL.md +10 -0
- package/template/skills/management/SKILL.md +5 -4
- package/template/skills/migrate/SKILL.md +47 -14
- package/template/skills/onboarding/SKILL.md +3 -3
- package/template/skills/openryoko-config/SKILL.md +1 -1
- package/template/skills/openryoko-config/references/engine-fallback.md +16 -5
- package/template/skills/openryoko-config/references/platform.md +23 -4
- package/template/skills/self-heal/SKILL.md +117 -44
- package/dist/src/engines/mock.d.ts +0 -16
- package/dist/src/engines/mock.d.ts.map +0 -1
- package/dist/src/engines/mock.js +0 -47
- package/dist/src/engines/mock.js.map +0 -1
- package/dist/src/shared/test-support/posix-mode.d.ts +0 -17
- package/dist/src/shared/test-support/posix-mode.d.ts.map +0 -1
- package/dist/src/shared/test-support/posix-mode.js +0 -23
- package/dist/src/shared/test-support/posix-mode.js.map +0 -1
- package/dist/web/_next/static/Oux0UBcCkbX5eOp9-vC4k/_buildManifest.js +0 -11
- package/dist/web/_next/static/Oux0UBcCkbX5eOp9-vC4k/_clientMiddlewareManifest.js +0 -1
- package/dist/web/_next/static/Oux0UBcCkbX5eOp9-vC4k/_ssgManifest.js +0 -1
- package/dist/web/_next/static/chunks/02h65sho8c14h.js +0 -1
- package/dist/web/_next/static/chunks/0ic18n-m7ixyw.css +0 -1
- package/dist/web/_next/static/chunks/19s8vn2kgy7q1.js +0 -1
- package/dist/web/_next/static/chunks/1_jm0szyu2the.js +0 -1
- package/dist/web/_next/static/chunks/1omdg4m5w9lgx.js +0 -1
- package/dist/web/_next/static/chunks/25nob1new8t4s.js +0 -79
- package/dist/web/_next/static/chunks/2iqxlc9wtxzm2.js +0 -1
- package/dist/web/_next/static/chunks/3_6klkygi417n.js +0 -1
- package/dist/web/_next/static/chunks/3alc-b00c58_3.css +0 -1
- /package/dist/web/_next/static/{70PNIyOj8-2kywAG6J41- → ov0mWzyHx0B5oEnTHE_pa}/_buildManifest.js +0 -0
- /package/dist/web/_next/static/{70PNIyOj8-2kywAG6J41- → ov0mWzyHx0B5oEnTHE_pa}/_clientMiddlewareManifest.js +0 -0
- /package/dist/web/_next/static/{70PNIyOj8-2kywAG6J41- → ov0mWzyHx0B5oEnTHE_pa}/_ssgManifest.js +0 -0
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
# Skills
|
|
2
|
+
|
|
3
|
+
Skills are markdown instruction sets that engines read and follow. There is no runtime, no loading system, no plugin API. Engines handle skills natively by reading the SKILL.md file.
|
|
4
|
+
|
|
5
|
+
## How Skills Work
|
|
6
|
+
|
|
7
|
+
Each skill is a directory in `~/.ryoko/skills/` containing at minimum a `SKILL.md` file. When an engine starts a session, it has access to the skills directory and can read any skill's instructions.
|
|
8
|
+
|
|
9
|
+
The `SKILL.md` file contains:
|
|
10
|
+
- **Trigger description**: When this skill should be activated
|
|
11
|
+
- **Instructions**: Step-by-step directions for the engine
|
|
12
|
+
- **Data file references**: Paths to any supporting files in the skill directory
|
|
13
|
+
|
|
14
|
+
## Creating a Skill
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
~/.ryoko/skills/
|
|
18
|
+
my-skill/
|
|
19
|
+
SKILL.md # Required: instructions
|
|
20
|
+
data.json # Optional: supporting data
|
|
21
|
+
template.txt # Optional: templates, examples, etc.
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### Example SKILL.md
|
|
25
|
+
|
|
26
|
+
```markdown
|
|
27
|
+
# Deploy Notification Skill
|
|
28
|
+
|
|
29
|
+
## Trigger
|
|
30
|
+
When the user says "deploy" or asks about deployment status.
|
|
31
|
+
|
|
32
|
+
## Instructions
|
|
33
|
+
1. Read the deployment config from `data/deploy-targets.json` in this skill directory
|
|
34
|
+
2. Check the current git branch and latest commit
|
|
35
|
+
3. Format a deployment summary with target environment, branch, and commit hash
|
|
36
|
+
4. Ask for confirmation before proceeding
|
|
37
|
+
|
|
38
|
+
## Data Files
|
|
39
|
+
- `deploy-targets.json`: List of deployment targets with URLs and environment names
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Pre-packaged Skills
|
|
43
|
+
|
|
44
|
+
{{portalName}} ships with these default skills (see `~/.ryoko/skills/`):
|
|
45
|
+
|
|
46
|
+
- **onboarding**: First-run setup — fills IDENTITY.md / SOUL.md / MEMORY.md interactively
|
|
47
|
+
- **openryoko-config**: Explain and configure the platform, including version-aware Claude Code/Codex fallback and Jev triage; verify runtime application
|
|
48
|
+
- **management**: Hiring, firing, promotions, delegation, and board reviews for the org
|
|
49
|
+
- **cron-manager**: Create, edit, enable/disable, and troubleshoot cron jobs
|
|
50
|
+
- **skill-creator**: Write a SKILL.md playbook to create a new skill
|
|
51
|
+
- **find-and-install**: Discover skills via `npx skills find` and install them
|
|
52
|
+
- **self-heal**: Diagnose and repair {{portalName}}'s own configuration and runtime
|
|
53
|
+
- **migrate**: Apply pending version migrations
|
|
54
|
+
- **sync** / **new** / **status**: Slash-command playbooks (`/sync`, `/new`, `/status`)
|
|
55
|
+
|
|
56
|
+
### Keeping bundled skills up to date
|
|
57
|
+
|
|
58
|
+
`ryoko setup` copies bundled skills on a new installation. After that they are synced
|
|
59
|
+
each time the gateway starts and each time `ryoko migrate` runs (including `--auto`, as
|
|
60
|
+
used by `ryoko update`), with or without pending version migrations. `--check` changes
|
|
61
|
+
nothing.
|
|
62
|
+
|
|
63
|
+
The sync replaces a skill only when it can prove the copy is unmodified. It keeps a
|
|
64
|
+
receipt, `~/.ryoko/skills/.shipped-skills.json`, with a sha256 for every file of every
|
|
65
|
+
bundled skill it placed.
|
|
66
|
+
|
|
67
|
+
| The skill in `~/.ryoko/skills/` | What the sync does |
|
|
68
|
+
|---|---|
|
|
69
|
+
| Missing, and the sync has no record of placing it | Installs it |
|
|
70
|
+
| Missing, but the sync placed it earlier (you deleted it) | Leaves it out and says so once per release. Only `ryoko migrate --restore-deleted-skills [name...]` puts it back |
|
|
71
|
+
| Unedited since the sync placed it, and a newer version ships | Replaces it and keeps the previous copy |
|
|
72
|
+
| Unedited, beside files that are exactly the shipped version's (what restoring `skills` from an older backup leaves when the shipped version has gained files) | Replaces it and keeps the previous copy |
|
|
73
|
+
| Edited, or holding files you added | Leaves it alone; tells you once per release when a newer version ships |
|
|
74
|
+
| A symlink, or holding a symlink | Leaves it alone |
|
|
75
|
+
| Unreadable, or larger than any bundled skill is (a file over 1 MiB, over 2 MiB in all, or over 500 files and directories) | Leaves it alone, unread, and tells you once per release |
|
|
76
|
+
| Identical to the shipped version, not yet in the receipt | Leaves it alone and starts tracking it |
|
|
77
|
+
| An untouched copy of a version an earlier release shipped, not in the receipt | Replaces it and keeps the previous copy |
|
|
78
|
+
| Different from every version ever shipped, not in the receipt | Leaves it alone and tells you once per release |
|
|
79
|
+
| No longer shipped, unedited | Moves it to the backup directory |
|
|
80
|
+
| No longer shipped, edited | Leaves it alone |
|
|
81
|
+
|
|
82
|
+
- **Your changes are never overwritten.** To customize a bundled skill, edit it in place;
|
|
83
|
+
it stops following releases. To return to the shipped version, move the skill's
|
|
84
|
+
directory aside and run `ryoko migrate --restore-deleted-skills <name>`. (A skill the
|
|
85
|
+
notice describes as having no record of how it was installed is not in the receipt:
|
|
86
|
+
for that one, moving it aside and restarting is enough.)
|
|
87
|
+
- **A bundled skill you delete stays deleted.** Neither restarting the gateway, nor
|
|
88
|
+
`ryoko migrate`, nor `ryoko update` brings it back; the receipt keeps a
|
|
89
|
+
`"deleted": true` mark for it. `ryoko migrate --restore-deleted-skills <name>...`
|
|
90
|
+
reinstalls the skills you name and leaves the other deleted ones deleted. Without a
|
|
91
|
+
name it reinstalls every bundled skill you deleted.
|
|
92
|
+
- **Restoring `skills` from a backup does not turn a bundled skill into an edited one.**
|
|
93
|
+
`ryoko backup restore` writes back the files its archive holds and removes none, so a
|
|
94
|
+
skill that was replaced since the backup can come out as its old files plus the newer
|
|
95
|
+
version's extra ones. As long as every one of those extra files is exactly the file
|
|
96
|
+
the package ships, the skill still counts as unedited and is brought up to date at
|
|
97
|
+
the next start. A file of your own among them makes it an edited skill, as always.
|
|
98
|
+
- **Nothing is deleted.** A replaced or retired skill is moved to
|
|
99
|
+
`~/.ryoko/.migration-backups/<version>-<time>/skills/<name>/`. Remove old backups by
|
|
100
|
+
hand when you no longer need them.
|
|
101
|
+
- A sync that is cut short (the machine goes down, the process is killed) can leave a
|
|
102
|
+
`.bundled-skill-XXXXXX` directory in `~/.ryoko`. A later sync moves it to
|
|
103
|
+
`~/.ryoko/.migration-backups/<version>-<time>/staging/` once it is an hour old,
|
|
104
|
+
provided it holds nothing but bundled skills, and says that it did. The copy of a
|
|
105
|
+
skill that could not be installed goes to the same place. The sync deletes neither.
|
|
106
|
+
- On the first start after upgrading to a release with this sync there is no receipt
|
|
107
|
+
yet. Missing skills are added (including any you had deleted before, once). For the
|
|
108
|
+
rest, the package carries fingerprints of every version of every bundled skill that
|
|
109
|
+
earlier releases shipped: a skill that is exactly one of those, file for file, is
|
|
110
|
+
untouched and is brought up to date. Anything else is left alone — a skill you
|
|
111
|
+
edited, or one installed under an assistant name other than the current one or the
|
|
112
|
+
installer's default.
|
|
113
|
+
- If `~/.ryoko/skills` is itself a symlink, it is your own skill store and nothing is
|
|
114
|
+
synced into it: no receipt, no updates, no retirements. The gateway says so in its
|
|
115
|
+
log at every start. `ryoko migrate` says so too, and
|
|
116
|
+
handles skills there as it did before the sync existed: it adds bundled skills that
|
|
117
|
+
are missing, copies a migration's new skill files, and leaves the ones that exist to
|
|
118
|
+
the AI merge.
|
|
119
|
+
- Do not edit `.shipped-skills.json`. Deleting it is safe, though it also forgets which
|
|
120
|
+
skills you deleted: missing bundled skills are installed again, skills identical to the
|
|
121
|
+
shipped version are tracked again, and everything else is left alone.
|
|
122
|
+
- When the receipt was written by a newer OpenRyoko than the one running (an older CLI
|
|
123
|
+
pointed at the same home, say), the older one changes no skill and says so at every
|
|
124
|
+
start. If no newer version uses the home, the receipt is wrong and can be fixed or
|
|
125
|
+
deleted.
|
|
126
|
+
- When the sync cannot run at all — the receipt is unreadable, say, or was written by a
|
|
127
|
+
newer OpenRyoko — `ryoko migrate` does not start a migration: it would end up recorded
|
|
128
|
+
as applied with its skill changes left out. It names the cause; fix that and run it
|
|
129
|
+
again. `ryoko migrate --auto` still applies what has nothing to do with skills, and
|
|
130
|
+
records the version only when that was everything.
|
|
131
|
+
- `skills.autoSync: false` in `config.yaml` stops the sync at gateway start.
|
|
132
|
+
`ryoko migrate` syncs either way.
|
|
133
|
+
|
|
134
|
+
## Key Points
|
|
135
|
+
|
|
136
|
+
- Skills are just files. Engines read them as context.
|
|
137
|
+
- No compilation, no imports, no runtime hooks.
|
|
138
|
+
- Any file format works as supporting data (JSON, YAML, CSV, plain text).
|
|
139
|
+
- Skills can reference other skills by path.
|
|
140
|
+
- Engines decide when and how to apply skill instructions based on the trigger description.
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cron-manager
|
|
3
|
+
description: "OpenRyoko の定期ジョブの作成・更新・停止・一覧確認。AIなしのコマンド実行とジョブ別モデル・思考量の設定にも使う。"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Cron Manager
|
|
7
|
+
|
|
8
|
+
Use this skill to create, edit, enable, disable, delete, or inspect scheduled jobs.
|
|
9
|
+
Direct command cron and per-job effort are available from OpenRyoko 2026.9.11. Read `docs/cron-commands.md` and any operator-specific cost policy before choosing execution settings.
|
|
10
|
+
|
|
11
|
+
## Inspect and choose the execution kind
|
|
12
|
+
|
|
13
|
+
Use authenticated `GET /api/cron` for current definitions. The backing file is `~/.ryoko/cron/jobs.json`; read it for diagnostics or backup. Use the API for normal mutations so the running scheduler is reloaded immediately.
|
|
14
|
+
|
|
15
|
+
- `kind: "command"`: an existing program performs the work. OpenRyoko creates no AI session. A program that itself calls AI can still consume AI usage.
|
|
16
|
+
- `kind: "prompt"` or omitted kind: the job starts an AI session. Select the model and effort for the actual work.
|
|
17
|
+
- For a deterministic detector followed by AI judgment, use command cron to emit an existing Workflow event only when new work exists. Keep stable event IDs and durable receipts.
|
|
18
|
+
- Preserve internal kinds such as `update-notification`; do not convert them while editing unrelated fields.
|
|
19
|
+
|
|
20
|
+
Use existing authorization, schedule, timezone, and delivery requirements. Ask only for information or external-action authorization that is still missing. The command migration does not authorize new recipients or publication actions.
|
|
21
|
+
|
|
22
|
+
## API and authentication
|
|
23
|
+
|
|
24
|
+
On this instance, connect to `http://127.0.0.1:7777`. All `/api/*` requests require `Authorization: Bearer <token>` using the token read from `~/.ryoko/gateway-auth.json`. Never print or embed the token in examples, prompts, or logs. For another installation, verify its loopback URL first.
|
|
25
|
+
|
|
26
|
+
| Action | Endpoint |
|
|
27
|
+
|---|---|
|
|
28
|
+
| List definitions | `GET /api/cron` |
|
|
29
|
+
| Create | `POST /api/cron` |
|
|
30
|
+
| Update or enable/disable | `PUT /api/cron/<id>` |
|
|
31
|
+
| Delete | `DELETE /api/cron/<id>` |
|
|
32
|
+
| Inspect history | `GET /api/cron/<id>/runs` |
|
|
33
|
+
| Run now | `POST /api/cron/<id>/trigger` |
|
|
34
|
+
|
|
35
|
+
Before mutation, retain the affected definitions in a private backup. Identify a job by ID after matching its name; IDs may be UUIDs or descriptive strings. Send only the intended fields on update. Preserve unrelated command, model, effort, schedule, delivery, and state settings. Read the saved definition back through the API, then inspect the next authorized run and its actual result.
|
|
36
|
+
|
|
37
|
+
Manual trigger can execute even a disabled job. Do not use it merely to test a job that publishes, sends, invites, charges, or deletes. Use an existing read-only dry-run option in a separate probe when appropriate, or inspect its next authorized scheduled run.
|
|
38
|
+
|
|
39
|
+
## Command job schema
|
|
40
|
+
|
|
41
|
+
This harmless example is disabled until intentionally registered and tested:
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
{
|
|
45
|
+
"id": "native-command-probe",
|
|
46
|
+
"name": "native-command-probe",
|
|
47
|
+
"enabled": false,
|
|
48
|
+
"kind": "command",
|
|
49
|
+
"schedule": "0 0 1 1 *",
|
|
50
|
+
"timezone": "Asia/Tokyo",
|
|
51
|
+
"command": {
|
|
52
|
+
"executable": "/usr/bin/true",
|
|
53
|
+
"args": [],
|
|
54
|
+
"cwd": "/tmp",
|
|
55
|
+
"timeoutSeconds": 30
|
|
56
|
+
},
|
|
57
|
+
"failureDelivery": null
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
- `command.executable`: absolute executable path.
|
|
62
|
+
- `command.args`: optional array of literal strings; no shell expansion, pipes, `$HOME`, or `~` expansion. Put multi-step behavior in a maintained script.
|
|
63
|
+
- `command.cwd`: optional absolute working directory. Preserve the directory needed by the script's relative paths.
|
|
64
|
+
- `command.timeoutSeconds`: optional integer from 1 to 86400; default 300.
|
|
65
|
+
- `failureDelivery`: optional `{ "connector": "slack", "channel": "approved-destination" }`. Omitted uses the configured cron alert destination; `null` disables cron failure alerts.
|
|
66
|
+
|
|
67
|
+
Command cron does not use `prompt`, `engine`, `model`, or `employee` to start AI, even if legacy values remain in the saved job. Edit `command` to change execution. Success output stays in the private log and is not delivered by cron. The script may itself send authorized notifications. Cron failure alerts contain the exit reason, not raw command output.
|
|
68
|
+
|
|
69
|
+
## Prompt job fields
|
|
70
|
+
|
|
71
|
+
Common fields are `id`, `name`, `enabled`, five-field `schedule`, and IANA `timezone`. For an AI job, add:
|
|
72
|
+
|
|
73
|
+
```json
|
|
74
|
+
{
|
|
75
|
+
"kind": "prompt",
|
|
76
|
+
"engine": "codex",
|
|
77
|
+
"model": "gpt-5.6-terra",
|
|
78
|
+
"effortLevel": "medium",
|
|
79
|
+
"prompt": "Read the approved input and prepare the requested summary."
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
`engine` and `model` are optional. A job that names neither runs on its employee's engine or on the default one, and while that engine's usage limit is on record it starts on the fallback engine without a failed turn. A job that names either is not moved: during the limit every fire fails a turn on the named engine first. Keep an explicit engine or model only where the job needs it.
|
|
84
|
+
|
|
85
|
+
The example model must be available to the configured account. Use the installed model registry for supported effort levels. Terra/medium is an example starting point for routine work; preserve the operator's selected model and use a stronger model only where the job needs it. Adjust the affected job when quality requires it; do not reset the global model to a costly default as routine maintenance.
|
|
86
|
+
|
|
87
|
+
`employee` is optional and must match an existing persona. `delivery` is an optional approved destination for prompt output. Reporting and analytical output should follow the established review route. Preserve existing delivery requirements; lack of a destination does not require adding one.
|
|
88
|
+
|
|
89
|
+
The AI instruction is `prompt`. Legacy `payload.message` is ignored. A cron's explicit `effortLevel` now takes precedence over the engine default for that cron session; confirm the resulting session's model and effort when verifying a change.
|
|
90
|
+
|
|
91
|
+
## Verify results and recover safely
|
|
92
|
+
|
|
93
|
+
For command success, history should show `kind: "command"`, `status: "success"`, `exitCode: 0`, and no AI `sessionId`. Nonzero exit, spawn failure, or timeout is failure. `logFile`, `signal`, `timedOut`, and `durationMs` provide diagnostic evidence. An exit code is not proof of an external delivery; inspect the actual result as required by the workflow.
|
|
94
|
+
|
|
95
|
+
For a prompt job, `status: "error"` covers more than a routing failure. The run is an error, with the reason in `error`, when its session ended in error, when its result was not delivered (the delivery connector was not running, or refused the message), or when the job names an engine the gateway does not have. `sessionId`, when present, names the session to inspect; it is absent when the run failed before a session was reported, which is always so for a job naming an engine the gateway does not have. Use `GET /api/cron/<id>/runs?limit=N` to read only the newest N runs.
|
|
96
|
+
|
|
97
|
+
`status: "skipped"` with `reason: "previous-run-waiting-for-usage-limit"` means an earlier fire of the same job is waiting for an engine's usage limit to reset, and will run the job once when it does. `waitingSessionId` names that session and `resetsAt`, when present, the reset. Do not run the skipped fires by hand while it waits; they are not made up afterwards either.
|
|
98
|
+
|
|
99
|
+
Failure alerts for prompt jobs go to `cron.alertConnector` / `cron.alertChannel`. A job that keeps failing for the same reason alerts once per `cron.alertThrottleMinutes` (default 60; `0` alerts every time), so the absence of a new alert is not recovery. Confirm with the run history.
|
|
100
|
+
|
|
101
|
+
When an engine's usage limit will not reset within six hours and no fallback engine can take the job, every fire fails at once and is logged as an `error` that names the reset. That failure is alerted once per limit period (an engine and the reset it stated), not once per `cron.alertThrottleMinutes`, and the job's delivery channel is told once per limit period too. Silence in either place is not recovery.
|
|
102
|
+
|
|
103
|
+
Logs live under `~/.ryoko/cron/commands/<job-hash>/`, with up to 100 logs per job and a 1 MiB limit per file. A durable `running.lock` prevents overlap. After abnormal termination, inspect its recorded PIDs, process state, logs, and completed external effects before removing only that lock or retrying. Do not clear all locks or state files.
|
|
104
|
+
|
|
105
|
+
Malformed `jobs.json` must be backed up and repaired in a separate candidate. Never replace an unreadable existing store with `[]`. Compare all IDs before any recovery and retain execution history. API failure should not cause a silent fallback to writing the live file.
|
|
106
|
+
|
|
107
|
+
When reporting, distinguish saved configuration, actual scheduler execution, verified output, and runs still waiting for their next scheduled time.
|
|
@@ -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.
|