MAC Roadmap¶
MAC's primary mission is to make ~/Src/mac capable of completing useful
software work autonomously: select and route work, execute it in least-privilege
sandboxes, review and repair its own changes, publish approved results, and
upgrade the fleet without requiring an operator to perform the mechanics.
Completion rule¶
A checkbox may be checked only when the item is:
- code-complete on
main; - covered by the repository's required gates;
- deployed to the entire configured fleet; and
- verified against the live fleet with durable evidence.
Merged, tested, staged, canaried, or partially deployed work remains unchecked. Each checked item must include the verifying source commit and deployment transaction or equivalent durable evidence.
Autonomous work loop¶
- [ ] The hub can produce an honest live status report of autonomous throughput, blocked work, ineffective attempts, review backlog, and worker health.
- [ ] Project work is selected and routed from durable project metadata without requiring a human to choose a worker or low-level execution capability.
- [ ] Every coding task executes in an isolated least-privilege sandbox with an inspectable ACL path and no authority beyond its parent ACL scope.
- [ ] Sandbox profiles compose deterministically as a nested Windows/POSIX-style ACL hierarchy with explicit deny, transitive group/role inheritance, and a documented path-resolution rule.
- [ ] ACL-denial feedback can choose a better parent profile or add a narrower child layer without flattening or widening the parent scope.
- [ ] ACL-denial evidence identifies the denied property and exact profile layer, recommends either a bounded additive child ACL or placement at an existing parent, and proves that the recommendation cannot exceed parent authority.
- [ ] Speculative work starts at the zero-privilege leaf and is dynamically placed at the narrowest profile that satisfies observed requirements.
- [ ] Successful work produces signed evidence, a reviewable branch, and a pull request or merge request.
- [ ] Review findings are structured, fed into the next coding attempt, and iterated autonomously until approval or a bounded terminal failure.
- [ ] Approved work is published and the durable task is completed without a human copying state between systems.
- [ ] AgentBus is the authoritative transport control plane for all autonomous work, including directives, worker traffic, status, and recovery.
- [ ] Every managed OpenShell policy allows egress to exactly its configured AgentBus hub endpoint and port, with no broad network exception.
- [ ] PostgreSQL is the authoritative MAC control-plane store; control-plane validation, recovery, and rollout gates do not silently fall back to SQLite.
- [ ] A live end-to-end proof shows MAC selecting, implementing, reviewing,
repairing, publishing, and completing nontrivial work in
~/Src/mac.
Fleet and self-upgrade¶
- [ ] OpenClaw can submit authenticated human upgrade intent without receiving deployment authority.
- [ ] An admin can issue an
upgrade yourselfor critical roll-forward request through OpenClaw, and OpenClaw can report durable progress and outcome. - [ ] Upgrade credentials are independently revocable, human-bound, least-privilege, and projected through the fenced secret channel; neither OpenClaw nor the supervisor receives general deploy or keystore authority.
- [ ] Keystore operations are scope-aware and auditable so each service can read only the named credentials required for its finite role.
- [ ] The hub accepts only approved immutable releases with remote CI and local contract-test evidence.
- [ ] A host-native supervisor can swap the hub generation, prove health, and roll back through a finite transaction without an LLM, arbitrary coding, or arbitrary command execution.
- [ ] Critical hub recovery has a break-glass path that remains usable when the current hub or OpenClaw generation is stale, while preserving authorization, audit, health proof, and rollback.
- [ ] The restarted hub resumes the durable release epoch and rolls workers forward or back by bounded cohorts.
- [ ] Crash recovery, authorization failures, failed health proofs, and cohort rollback are covered and proven in the live fleet.
- [x] The current
mainsource commit is deployed and attested on the hub, every configured worker, and every subsequently registered fleet member. Verified060acc500ab99e30bc01cfccf7eef2232108b4e4on the hub, worker-1, and gpu-worker after typed cohort20260827T060057Z(make deploy HUB=<hub>with hold-adoptions after a retained roll-forward). Hub/healthok; workers idle and unheld;HERMES_HOME=$MAC_HOME/openclaw. - [x] A failed or interrupted fleet deployment can safely resume without
dispatch-hold drift, credential loss, partial promotion, or manual mutation
of generated authority files.
Verified by adopting hold
mac admin fleet roll-forward repair retained after 20260827T054339Zand completing20260827T060057Zwithout rewriting generated authority. - [ ] Darwin and parallel test harnesses are deterministic enough that required gates provide reliable release evidence on the supported development hosts.
- [ ] Database and agent-owned state upgrades are versioned, ordered, recorded, and fail closed as specified by ADR 0027.
CLI and plugin distribution¶
- [ ] The MAC CLI's known installation, authentication, command-routing, and upgrade defects are fixed and covered by supported-host contract tests plus a live fleet smoke test.
- [ ] Plugin generation produces a deterministic, versioned, integrity-checked artifact whose commands, bundled dependencies, configuration migration, and rollback behavior pass installation and upgrade contracts.
- [ ] The generated plugin is verified on every supported host and becomes the canonical MAC CLI installation method, with a bounded migration from the legacy installer and a tested rollback path.
Operational autonomy¶
- [x] Nightly local-news collection reliably publishes one deduplicated report
to
#localnews, with delivery and freshness evidence. Live receiptkslug-nightly-news.last-success.jsondelivered2026-08-26T22:23:31Ztoslack:C0AH1QJCT7F; later runs skippedalready_delivered_today. Launchd jobkslug-nightly-news(0 6 * * *) reinstalled on the hub in deploy20260827T060057Zat060acc50. - [ ] Scheduled automation fails closed: failed collectors cannot become agent prose, repeated unchanged results are suppressed, DMs are allowed, and channel broadcasts are limited to the configured destination.
- [ ] The hub agent's proactive channel output is restricted to its configured home channel; direct messages to the fleet owner remain allowed.
- [ ] OpenClaw gateway shutdown and deployment checkpoints handle WAL-backed state, bounded subprocess shutdown, and the configured OpenShell endpoint without corrupting or abandoning a rollout.
- [ ] Fleet configuration and credential environment files are written atomically and preserve real line boundaries, permissions, and scoped token names across retries.
- [ ] Dream-cycle analysis uses a current authoritative data source and produces useful, deduplicated output. This is a nice-to-have and must not block core autonomous-work or fleet-upgrade milestones.
Near-term order¶
- Complete and verify the top-of-tree hub rollout. Done:
060acc50, deploy20260827T060057Z. - Restore the nightly
#localnewsreport. Done: Slack delivery2026-08-26T22:23:31Zplus launchd reinstall on060acc50. - Prove the hub-mediated upgrade transaction across the full fleet.
- Close the autonomous review/repair/publication loop with a live
~/Src/mactask. - Repair the MAC CLI, verify deterministic plugin generation, and migrate the fleet to plugin-based CLI installation.
- Implement hierarchical sandbox ACL feedback and profile placement.
- Revisit dream-cycle analysis only after the higher-priority proofs are durable.
Known defects from the v1.3.0 capabilities deck (slide 12)¶
Source: MAC capabilities at d8d491d6,
captured 2026-08-28. Items stay unchecked until they meet the completion rule
above. Large ADRs are held --no-dispatch until hub-verify can land
repository work (task_321b8e8d).
- [ ] Default
mac --helpreports the realmac adminsubcommand count, not zero. Ledgertask_2d33cc69. - [ ] Current docs no longer describe the deleted Hermes snapshot as present.
Ledger
task_a0fc238b. Fate record:docs/hermes-vendor-fate.md. - [ ] Token spend is metered at the router and persisted (ADR 0017). 29.5% of
llm.routeevents over the seven days to 2026-08-19 recorded no input tokens; cost is priced at read time. Ledgertask_b0750aee(successor to failedtask_45927341). - [ ] The task view is a graph under progressive disclosure (ADR 0018): the hub
sends dependency edges so the console can show what blocks a task.
Ledger
task_bdf11b3f. - [ ] The coding-route search path is a fleet contract, not per-worker
environment (ADR 0029). Ledger
task_198bf6ab. - [ ] CLI sessions use each harness's hooks for AgentBus inject/record, not
tmux and not a prompt-level
agentbus wait(ADR 0032). Ledgertask_13a1f7fe. - [ ] ADR 0012 (native steward + containerized execution) stays deferred until
a fleet measurement exists. ADR 0015 already narrowed the containerized
half to Linux. Ledger
task_3a48fd75. - [ ] Hub-verify OpenShell sandboxes receive a dedicated test Postgres DSN
(not the live hub database) so a repository canary can complete.
Ledger
task_321b8e8d. Blocked the v1.3.1 canarytask_d894080c/ PR #681.