Carlos Florêncio
65 lines
2.2 KiB
Markdown
65 lines
2.2 KiB
Markdown
---
|
|
id: "07-runtime-version-docs"
|
|
title: "Update runtime version documentation"
|
|
status: complete
|
|
wave: 5
|
|
depends_on: ["01-default-pins", "02-effective-version-selection", "03-update-status-api", "05-settings-update-indicator"]
|
|
plan: "plan.md"
|
|
spec: "../../specs/agents/requirements/runtime-updates.md"
|
|
---
|
|
|
|
# Task 07: Update runtime version documentation
|
|
|
|
## Acceptance
|
|
|
|
- Public agent documentation explains Kandev defaults, operator selections,
|
|
the blue update hint, return-to-default behavior, and active-session effects.
|
|
- Internal bridge documentation shows exact effective-version commands and
|
|
distinguishes offline-preferred launch from online-preferred update behavior.
|
|
- A focused search finds no live documentation claiming managed packages are
|
|
unversioned or that selections are host-only.
|
|
|
|
## Verification
|
|
|
|
```bash
|
|
node --test scripts/validate-public-docs.test.mjs && node scripts/validate-public-docs.mjs && git diff --check
|
|
```
|
|
|
|
## Files likely touched
|
|
|
|
- `docs/public/agents-and-profiles.md`
|
|
- `apps/backend/internal/agent/agents/ACP_BRIDGE_VERSIONS.md`
|
|
- Other directly affected public/spec/decision references found by focused `rg`
|
|
|
|
## Dependencies
|
|
|
|
Tasks 01, 02, 03, and 05.
|
|
|
|
## Parallelism
|
|
|
|
Parallel-safe with Task 06 after Tasks 01-05. This task owns documentation only.
|
|
|
|
## Inputs
|
|
|
|
- Updated runtime-updates spec and ADR
|
|
- Final API labels and command behavior from Tasks 01-05
|
|
- `/docs-maintainer` public documentation boundary
|
|
|
|
## Output contract
|
|
|
|
Report public/internal docs changed, content type, focused stale-claim search,
|
|
exact validation results, risks, and synchronized task/plan status.
|
|
|
|
## Results
|
|
|
|
Complete. Public and internal runtime documentation now explains reviewed
|
|
defaults, install-wide selections, return-to-default, blue update hints,
|
|
unknown checks, active-session behavior, exact effective-version commands, and
|
|
offline-preferred launches versus online-preferred updates. The current Codex
|
|
decision was reconciled, and the superseded unversioned/host-only claims remain
|
|
only as historical context in superseded records.
|
|
|
|
Verification: public-doc tests passed 61/61 and the validator accepted 41
|
|
published pages; `git diff --check` passed; focused stale-claim search found no
|
|
current public or bridge documentation making the old claim.
|