mirror of
https://github.com/boshu2/agentops.git
synced 2026-09-14 15:08:13 +08:00
docs(3.0): sweep remaining daemon/schedule/hook prose + MIGRATION-3.0 (ag-qbw) (#520)
## What
Wave 2 of the AgentOps 3.0 honest-docs sweep (post-#518 audit, bead
ag-qbw). Makes the `docs/` prose match the shipped code: the daemon,
scheduler, factory, and all hooks were **DELETED** (not deprecated).
AgentOps is the in-session loop + context compiler; out-of-session
orchestration is delegated to a substrate (Gas City reference City /
Olympus). Mirrors the already-correct `docs/3.0.md`.
This makes `docs/3.0.md:150` ("the standalone
daemon/scheduler/overnight-runner surfaces are gone from ... live doc
prose") true for the enumerated wave-2 surfaces.
## Deleted (whole docs about deleted commands)
- `docs/scheduling.md` — entire `ao schedule` + `ao daemon` guide
-
`docs/contracts/{agentopsd-control-plane,agentopsd-schedule,routing-policy}.md`
- `docs/contracts/jobspec-openapi-v0.yaml`
- `docs/templates/dark-factory-schedule.yaml.example`
- `docs/design/olympus-v4-specs/*.md` — v4-port reference for the dead
Olympus → agentopsd extraction
## Reframed (prose → in-session + Gas City)
- Daemon/schedule/overnight: `agentops-3-youtube-starter-series.md`,
`agentops-3-pmf-evidence-loop.md`, `wiki-for-agents.md`,
`activation-profiles.md` (+ `profiles/README.md` profile rename),
`CI-CD.md` (overnight lane)
- Hooks → hookless + CI-as-authoritative-gate (hooks removed #511):
`knowledge-flywheel.md`, `troubleshooting.md`, `reference.md`,
`CI-CD.md`, `release-e2e-checklist.md`, `seed-definition.md`
## Catalog + cross-link cleanup (no broken links)
- `documentation-index.md` — removed deleted-doc rows + the v4 section
- `contracts/index.md` — removed deleted-contract cards
- `rfcs/0002-jobspec-openapi-v0.md` marked superseded; `SCHEMAS.md`,
`templates/README.md` cross-links fixed
## Created
- `docs/MIGRATION-3.0.md` (from the approved draft) + catalog row +
mkdocs nav entry
## Gates (green for this PR's surfaces)
- Link check: **2723 links, 0 broken**
- Contracts structural floor: **PASS (45 contracts)**
- Contract compatibility (orphans): **PASS**
- markdownlint (all changed/new files): **clean**
- `heal.sh --strict`: **All clean**
- mkdocs-strict: my new doc + nav entry build cleanly. The strict build
is **red on main for pre-existing reasons outside this scope** —
`docs/_hooks/gen_cli_reference.py` FATALs on missing `cli/docs/HOOKS.md`
(hooks removed #511, generator not updated; release-mechanics domain)
and `docs/3.0.md:172` links `../PRODUCT.md`/`../GOALS.md` (root files
outside the docs tree). Both confirmed present on `origin/main`; filed
for wave 3.
## Scope notes
- Did **not** touch `CHANGELOG.md`, `cli/`, or version files (parallel
worker owns release mechanics).
- The audit grep still matches ~40 more out-of-scope `docs/` files
(contracts/*, code-map, comparisons, narrative pages, runbooks). Filed
as **wave 3 (ag-p7j)**.
Closes-scenario: ag-qbw#doc-sweep-2
Bounded-context: BC1-Corpus
Evidence: docs/3.0.md
This commit is contained in:
@@ -32,20 +32,6 @@ skills, the runtime, and external integrations.
|
||||
Architecture boundary for `agentopsd`, the daemon ledger, job queue, local
|
||||
trust, projections, and migration from foreground command flows.
|
||||
|
||||
- :material-factory: **[AgentOpsd Control Plane](agentopsd-control-plane.md)**
|
||||
|
||||
---
|
||||
|
||||
Production control-plane contract for worker slots, worktree ownership,
|
||||
lifecycle telemetry, validation gates, yield, and operator status.
|
||||
|
||||
- :material-routes: **[Routing Policy](routing-policy.md)**
|
||||
|
||||
---
|
||||
|
||||
Schema-backed model/provider/runtime lane policy, authority levels, and
|
||||
milestone-1 GasCity / Mt. Olympus production-routing guardrails.
|
||||
|
||||
- :material-lock-check: **[Daemon Idempotency](daemon-idempotency.md)**
|
||||
|
||||
---
|
||||
@@ -53,13 +39,6 @@ skills, the runtime, and external integrations.
|
||||
Submit retry contract for `request_id`, `idempotency_key`, and
|
||||
daemon-submitting CLI helpers.
|
||||
|
||||
- :material-file-code: **[JobSpec OpenAPI v0](jobspec-openapi-v0.yaml)**
|
||||
|
||||
---
|
||||
|
||||
Machine-readable OpenAPI contract for the current `agentopsd` job,
|
||||
readiness, ledger replay, projection, and OpenClaw consumer HTTP surface.
|
||||
|
||||
- :material-api: **[GasCity Integration](gascity-integration.md)**
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user