Umbrella Cleanup
Umbrella Cleanup
Section titled “Umbrella Cleanup”Umbrella rows are inventory or tracking rows, not executable implementation slices. Split these into smaller rows with contracts, fixtures, trust classes, and acceptance checks before assigning them to an implementation agent.
| Phase | Umbrella row | Owner | Not ready when | Split into |
|---|---|---|---|---|
| 1 / 5.X | Gormes Termux Runtime Compatibility | orchestrator | The milestone promises local Docker, GPU/local LLM, heavy browser automation, or guaranteed Android background daemon uptime., The implementation moves or duplicates install.sh away from the repository root., A public fully-compatible claim is made before real-device Termux smoke evidence exists. | Termux install and release smoke guide, Termux storage and path safety audit, Termux gateway foreground tmux lifecycle, Termux notification bridge via termux-api, Termux real-device smoke evidence |
| 2 / 2.A | Coding-agent delegation tooling (codex/claude-code/opencode) | tools | Phase 2: codex adapter implementing CodingAgent with snapshot+diff capture., Phase 3: claude-code adapter implementing CodingAgent., Phase 4: opencode adapter implementing CodingAgent., Phase 5: tool registry exposure of codex_run / claude_code_run / opencode_run with workspace-guard enforcement., Phase 6: doctor + status surfaces for backend availability and last-run summaries., Phase 7: TUI/voice-path integration honoring workspace-ID-over-raw-path safety. | - |
| 2 / 2.B.5 | Hermes live-turn prompt assembly parity (channel-neutral) | gateway | The umbrella is selected as a single slice rather than executed through child rows., Wiring is added inside any one channel adapter (internal/channels/telegram, internal/channels/slack, internal/channels/bluebubbles, etc.) instead of inside gateway.Manager., A child row mutates BuildContextFilesPrompt instead of consuming it, or modifies kernel.PlatformEvent to add new system-prompt fields when the existing SessionContext field already carries the assembled header. | - |
| 4 / 4.A | Codex | provider | The row is assigned as one large Codex provider implementation instead of the Responses conversion, auth, and stream-repair slices below. | Codex Responses pure conversion harness, Codex Responses assistant content role types, Codex Responses HTTP client binding, Codex OAuth state + stale-token relogin, Codex stream repair + tool-call leak sanitizer |
| 4 / 4.B | Long session management | provider | The row is assigned as one implementation task instead of being split through context engine, token-budget, reference, and compression slices. | ContextEngine interface + status tool contract, Compression token-budget trigger + summary sizing, Manual compression feedback + context references |
| 4 / 4.B | Context compression | docs | The row is inventory-only and must not be selected until a planner pass replaces this note with a builder-ready contract packet. | - |
| 4 / 4.B | Manual compression feedback + context references | docs | The row is inventory-only and must not be selected until a planner pass replaces this note with a builder-ready contract packet. | - |
| 4 / 4.D | Model metadata registry + context limits | provider | The row is assigned as one metadata/routing implementation instead of the resolver, pricing/capability, and selector slices below. | Provider-enforced context-length resolver, Model pricing/capability registry fixtures, Routing policy and fallback selector |
| 5 / 5.A | 61-tool registry port | tools | The row is treated as a bulk 61-handler port before descriptor parity and trust classes are frozen. | Tool registry inventory + schema parity harness, Pure core tools first, Stateful tool migration queue |
| 5 / 5.A | Pure core tools first | docs | A builder tries to implement this umbrella as a broad multi-tool port., A child row requires live browser, network, sandbox, provider, or filesystem mutation behavior before the pure registry/debug contracts are validated. | Todo, Clarify, Debug helpers, Stateful tool migration queue |
| 5 / 5.B | Modal | docs | The row is inventory-only and must not be selected until a planner pass replaces this note with a builder-ready contract packet. | - |
| 5 / 5.B | Daytona | docs | The row is inventory-only and must not be selected until a planner pass replaces this note with a builder-ready contract packet. | - |
| 5 / 5.C | Rod | docs | The row is inventory-only and must not be selected until a planner pass replaces this note with a builder-ready contract packet. | - |
| 5 / 5.C | Go browser harness binary repo + integration lane (placeholder) | tools | The slice attempts to vendor or embed Chromium / Rod / chromedp directly inside Gormes; the harness binary is the architectural decoupling point., The slice changes the JSON action contract before the future repo’s first integration test exists., The slice removes ErrBrowserHarnessUnavailable degraded behavior. | go-browser-harness Chromedp action backend, Browser provider bridge + Firecrawl fallback, Browser Use cloud + Go browser harness bridge |
| 5 / 5.D | Multimodal in/out | provider | The row is assigned directly instead of the smaller image-routing, image-shrink, and image-generation contracts below. | Image input mode router + native content parts, Image-too-large shrink retry helper, Image generation result contract |
| 5 / 5.E | Voice mode port | docs | The row is inventory-only and must not be selected until a planner pass replaces this note with a builder-ready contract packet. | - |
| 5 / 5.E | TTS synthesis + voice-mode state | docs | The row is inventory-only and must not be selected until a planner pass replaces this note with a builder-ready contract packet. | - |
| 5 / 5.G | MCP client | tools | The row is assigned as one all-MCP migration instead of the config, discovery, OAuth, and managed-gateway slices below. | MCP server config/env resolver, MCP stdio transport + tool/list discovery, MCP HTTP transport + tool/list discovery, MCP schema normalization + structured-content adapter, MCP OAuth state store + noninteractive auth errors, Managed tool gateway bridge |
| 5 / 5.I | Third-party extensions | docs | The row is inventory-only and must not be selected until a planner pass replaces this note with a builder-ready contract packet. | - |
| 5 / 5.J | Dangerous action gating | docs | The row is inventory-only and must not be selected until a planner pass replaces this note with a builder-ready contract packet. | - |
| 5 / 5.N | Cronjob tool API + schedule parser parity | tools | The row is assigned as one combined cronjob tool, schedule parser, safety, context chaining, and delivery-port slice instead of the dependency-ordered rows below. | Cron schedule parser + repeat state fixtures, Cron prompt/script safety + pre-run script contract, Cronjob tool action envelope over native store, Cron context_from output chaining, Cron multi-target delivery + media/live-adapter fallback |
| 5 / 5.N | Cron prompt/script safety + pre-run script contract (deprecated umbrella) | tools | The row is assigned directly instead of the smaller Cron prompt/script safety + pre-run script contract helper row above. | - |
| 5 / 5.O | 49-file CLI tree port | tools | The row is assigned as a whole hermes_cli tree migration instead of command-group slices. | Hermes CLI command-tree parity manifest, Hermes CLI nested parser inventory refresh, Hermes auth command-tree manifest refresh, Hermes auth credential-pool command surface, Hermes auth OAuth provider adapters, Hermes auth Spotify service-provider subcommand, Deterministic helper-file ports (banner/output/tips/webhook/dump), CLI command registry parity + active-turn busy policy, Config, profile, auth, and setup command surfaces, Gateway, platform, webhook, and cron management CLI, Diagnostics, backup, logs, and status CLI |
| 5 / 5.O | Deterministic helper-file ports (banner/output/tips/webhook/dump) | tools | The row is assigned as one combined hermes_cli helper-file migration instead of the four pure-helper slices below. | CLI banner/output formatting helpers, CLI deterministic tip selector, CLI webhook URL normalizer, CLI dump support-summary helper |
| 5 / 5.O | Config, profile, auth, and setup command surfaces | tools | The row is assigned as one combined config/profile/auth/setup migration instead of the pure profile, auth-status, setup, and uninstall slices. | CLI profile name validator, CLI profile root resolver, CLI active-profile store, Hermes auth command-tree manifest refresh, Hermes auth credential-pool command surface, Hermes auth OAuth provider adapters, Hermes auth Spotify service-provider subcommand, Provider endpoint/API-key root flags + runtime resolution, Gormes config command surface, Hermes config migration dry-run manifest, OpenClaw migration dry-run manifest, Gormes auth bare interactive credential-pool readout, Gormes auth status per-provider aggregator, Gormes auth add openai-codex strict isolation contract, Gormes auth add bedrock open-question planning note, Gormes top-level logout provider shortcut, Gormes removed top-level login guidance, Gormes model interactive provider/model picker, Gormes setup minimal sectioned wizard slice, Gormes setup top-level chooser menu, Gormes setup full-wizard shell and branded summary, Hermes setup entry-mode and reset semantics, Gormes setup tools checklist command binding, Gormes setup gateway platform checklist command binding, Gormes setup terminal TTS and agent-settings section bindings, Gormes uninstall dry-run command contract, Gormes mcp login interface seam + noninteractive default, Gormes mcp login browser callback flow, Gormes profile command binding, Model and profile selector seam (Cobra + gateway), Gormes agent template reset command |
| 5 / 5.O | CLI profile path and active-profile store (deprecated umbrella) | tools | The row is selected at all — execute the three sibling rows above (CLI profile name validator, CLI profile root resolver, CLI active-profile store) instead. | - |
| 5 / 5.O | Gateway, platform, webhook, and cron management CLI | tools | The row is assigned as one management-CLI migration instead of separate gateway read-model, cron admin, webhook helper, and platform command slices. | Gateway management CLI read-model closeout |
| 5 / 5.O | Diagnostics, backup, logs, and status CLI | tools | The row is assigned as one combined diagnostics/backup/logs/status migration instead of log snapshot, status summary, backup manifest, and optional upload slices. | CLI log snapshot reader |
| 5 / 5.O | gormes doctor section-content parity (Security Advisories / Directory Structure / Skills Hub / Auth Providers / Profiles) | tools | Anyone attempts to assign this umbrella as a single combined implementation slice., Child behaviors are implemented without first being split into their own rows with write_scope and tests. | - |
| 5 / 5.O | Profile Control Center v2 umbrella — single root config and active services | tools | This umbrella is assigned as one implementation slice., A child row writes canonical config under $GORMES_HOME/profiles/<id>/config.toml, adds a v2 active_profile/default_profile field, or silently shares credentials across profiles., The work starts live providers, channel logins, Navivox servers, or profile fleet processes instead of shaping or executing a focused child row., Source refs regress to broad directories (internal/config/, cmd/gormes/, or generated module pages) without exact symbols or anchors., The row creates a side backlog outside progress.json for profile-control-center implementation order. | Root config.toml v2 profile service schema, Legacy profile config v2 migration planner, Profile Control Center read model, Profile Control Center TUI shell and draft apply flow, Per-profile provider credential readiness, Per-profile channel credential readiness and allow-lists, Navivox multi-server profile routing config model, Canonical config.toml v2 profile schema docs, Long-term plan: profile fleet supervisor and single control-plane gateway |
| 5 / 5.Q | Deterministic helper-file ports (tool-progress/image/completion-path/personality/platform-event) | gateway | The row is assigned as one combined tui_gateway helper migration instead of the two pure-helper slices below. | TUI gateway tool-progress mode normalizer, TUI gateway completion path normalizer, TUI gateway image/personality/platform-event helpers |
| 5 / 5.Q | Native TUI slash handler-port coverage | tui | The umbrella is assigned as one combined implementation slice., The slice tracks native-TUI slash handler ports outside progress.json or creates a side queue/list of unported commands., The implementation silently proxies all slash commands through gateway slash.exec/command.dispatch without local native-TUI parity decisions., The fallback lets recognized, ambiguous, or unknown slash text reach kernel.Submit/the model as ordinary prompt text., A child row changes public slash routing, busy-time policy, gateway-vs-local classification, or visible unavailable text without a focused TUI test first. | Native TUI /skin slash command binding, Native TUI /voice slash command binding, Native TUI /config slash command binding, Native TUI /tools slash command binding, Hermes ui-tui strict-fidelity action matrix |
| 5 / 5.V | Gateway channel adapters publish to event bus | gateway | This row is selected directly instead of a child channel-adapter slice., The implementation tries to port Telegram, Discord, Slack, WhatsApp, and WeChat in one pass., A child row cites non-existent adapter files or lacks provenance fields in its event payload. | Telegram gateway event-bus adapter, Discord gateway event-bus adapter, Slack gateway event-bus adapter, WhatsApp gateway event-bus adapter, WeCom gateway event-bus adapter, Weixin gateway event-bus adapter, Gateway outbound sends publish message-sent events |
| 8 / 8.D | Single-binary cross-platform release pipeline | tools | Binary size exceeds 30 MB for any target without an explicit operator-approved exception., Termux build is missing or fails CGO-equivalent restrictions., Release artifacts are unsigned., The row is assigned as one combined release-pipeline implementation slice instead of a focused child closure., No tagged-release run has produced and attached all seven artifacts from the current workflow. | - |
| 8 / 8.F | Module-split the progress backlog (per-subsystem files, parity-aligned) | tools | Built as a big-bang rewrite; rows migrated lossily; internal/progress.Load public contract broken; a consumer left reading a now-missing monolith; docs/landing generators silently diverged; AGENTS.md/skills not updated to the split layout. | - |
| 8 / 8.F | Progress Control Plane staged deepening program | tools | The implementation attempts a big-bang rewrite across all progress modules., The implementation creates a side tracker, issue queue, TODO list, or separate backlog outside progress.json., The implementation changes public row ranking semantics before a characterization test locks current behavior. | Progress workitem row classification seam, Progress Workspace layout and path seam, Progress write generated artifact plan, Progress projections for active handoff shipped evidence and health |