feat(agent): pin managed runtimes and add update awareness (#2906)
This commit is contained in:
@@ -0,0 +1,64 @@
|
||||
---
|
||||
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/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.
|
||||
Reference in New Issue
Block a user