LearnNewsExamplesServices
Frontmatter
id11721
titleCloud deployment topology + scheduler-task-taxonomy ADR
stateClosed
labels
enhancementaiarchitecture
assigneesneo-opus-ada
createdAtMay 21, 2026, 7:16 PM
updatedAtMay 21, 2026, 11:03 PM
githubUrlhttps://github.com/neomjs/neo/issues/11721
authorneo-opus-ada
commentsCount0
parentIssue11720
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[ ] 11734 Optional local-model runtime container profile (post-MVP, D0-gated), [x] 11729 Cloud deployment ADR set — D1/D3/D4 decision records + stale-ADR reconciliation, [x] 11727 DeploymentCookbook realignment as accurate deployment authority, [x] 11725 Deployed healthcheck + production-shaped journey proof, [x] 11724 Production reference deployment profile + compose, [x] 11723 Production container topology — multi-container + resource limits
closedAtMay 21, 2026, 11:03 PM

Cloud deployment topology + scheduler-task-taxonomy ADR

Closed v13.0.0/archive-v13-0-0-chunk-12 enhancementaiarchitecture
neo-opus-ada
neo-opus-ada commented on May 21, 2026, 7:16 PM

Context

Critical-path sub (D0) of Epic #11720 (Cloud Agent OS Deployment Readiness; graduated from Discussion #11718). D0 is the first workstream — it gates Sub B (container topology), Sub C (reference compose), and Sub D (healthcheck / journey proof). MVP-critical.

The Problem

The current Orchestrator is a mixed-responsibility local Agent OS supervisor: ai/daemons/TaskDefinitions.mjs schedules one mixed task set — cloud-relevant lanes (chroma, bridge, summary, kbSync, backup, dream, golden-path) and local-only maintainer lanes. PrimaryRepoSyncService hardcodes dev / origin/dev / local git worktrees / resources/content/.sync-metadata.json cleanup / a local ai:sync-kb cascade. A cloud deployment cannot containerize the Orchestrator as-is. And no ADR documents the target deployment topology — ai/deploy/docker-compose.yml's 3-service KB/MC/Chroma profile is a stale baseline, not a decided topology.

The Architectural Reality

  • ai/daemons/TaskDefinitions.mjs — the mixed task set.
  • ai/daemons/Orchestrator.mjs poll() — schedules all lanes from one daemon loop.
  • ai/daemons/services/PrimaryRepoSyncService.mjs — explicitly local-maintainer machinery.
  • ai/deploy/docker-compose.yml — the KB/MC/Chroma baseline (3 services).
  • ADRs 0003 (unified Chroma), 0009 (cross-daemon lease) exist; no deployment-topology ADR.
  • ADR convention 0005 (ADR-at-graduation) / 0006 (ADRs as graph-queryable): an ADR records the chosen decision + provenance + rejected options + anti-patterns — a decision record, not an open-options workspace.

The Fix

A decision workstream producing one ADR under learn/agentos/decisions/:

  1. Classify every orchestrator/scheduler lane as cloud-deployable, local-only, or shared primitive — with rationale.
  2. Decide the target production deployment topology — which services, container boundaries, the cloud-safe scheduler/orchestrator profile (local dev-sync lanes excluded), and the service-count profile variants (per Discussion #11718 §5/D1: count follows the profile, it does not lead).
  3. Author the ADR — the chosen topology + task taxonomy + rejected options + anti-patterns.

Acceptance Criteria

  • Every orchestrator/scheduler lane classified cloud-deployable / local-only / shared primitive, with rationale.
  • Target production deployment topology decided — service boundaries; the cloud-safe scheduler profile; local dev-sync lanes explicitly excluded from the cloud profile.
  • One ADR authored under learn/agentos/decisions/ recording the chosen topology + task-taxonomy decision + rejected options (per ADR 0005/0006 — a decision record, not an open A/B/C/D workspace).
  • The ADR is referenced as the input that unblocks Sub B / Sub C / Sub D.

Out of Scope

  • Implementing the container compose (Sub B / Sub C).
  • Server-side repo clone (a D3 exploration).
  • SQLite → networked-SQL graph-store migration (D5 — deferred v13 follow-up).

Related

  • Parent: Epic #11720 (Cloud Agent OS Deployment Readiness)
  • Origin: Discussion #11718 (D0 decision workstream; orchestrator-role-split anchor DC_kwDODSospM4BA4F9)
  • ADRs: 0003, 0005, 0006, 0009
  • Gates: Sub B (container topology), Sub C (reference compose), Sub D (healthcheck / journey proof)

Origin Session ID

8e1dc8ca-b5a5-4479-b3cf-31918eb4a5b2

Handoff Retrieval Hints

  • query_raw_memories({query: 'orchestrator mixed-responsibility cloud deployment topology D0'})
  • Discussion #11718 §5/D0 + the orchestrator-role-split comment DC_kwDODSospM4BA4F9.
tobiu referenced in commit ed81417 - "feat(agentos): cloud deployment topology + scheduler-task-taxonomy ADR (#11721) (#11738) on May 21, 2026, 11:03 PM
tobiu closed this issue on May 21, 2026, 11:03 PM