Merge branch 'documentation/requirements-001-003-cleanup' into unify/skills-20261112-night
This commit is contained in:
commit
370da99829
2 files changed
+47
-29
No files matched your search
@@ -120,6 +120,11 @@ from three views down to any agent, branch or artefact.
|
||||
directory; a systemd user path unit runs `pkgmgr branch cleanup --apply
|
||||
--local` for exactly those items and writes the result back. Rejected: an
|
||||
`operator.py` row (not direct).
|
||||
- **Amended by the operator 2026-11-13**: the signed delete removes only
|
||||
the local branch (`pkgmgr branch cleanup --apply --local`); a branch a
|
||||
worktree holds is skipped and left to `kvb-git-gc`, and no worktree,
|
||||
Compose stack or volume is touched. Rejected: per Scope, also removing
|
||||
the worktree and running `compose down` without `-v`.
|
||||
22. **Organisation update**: a new skill `kvb-org-update` tells every agent
|
||||
and client which skills changed and how to use them, as one
|
||||
`newsletter` per update; phase 1 announces the radio change through it.
|
||||
@@ -313,6 +318,10 @@ from three views down to any agent, branch or artefact.
|
||||
old `#stream/radio` link opens the Stream with the spot open. Rejected:
|
||||
keeping the Radio tab, the speaker chips (every Agents view already marks
|
||||
the speaker).
|
||||
- **Amended by the operator 2026-11-13**: the spot shows the 004 radio
|
||||
log with its Sent tab (004 decision 7) instead of the last five sent
|
||||
messages. Rejected: only a note on the spot box, leaving this decision
|
||||
unchanged.
|
||||
60. **Radio numbers and paths** (operator 2026-11-10): only the spoken line
|
||||
changes, the displayed text stays as written. Digits are spoken in ICAO
|
||||
words in Title Case, Ze-ro, One, Two, Tree, Fow-er, Fife, Six, Seven,
|
||||
@@ -509,8 +518,9 @@ flowchart TD
|
||||
that names each changed skill and tells every agent to re-read its
|
||||
`SKILL.md` before the next use, then records `HEAD` as announced; a
|
||||
second run without new commits sends nothing.
|
||||
- [ ] The radio change of phase 1 is announced through it.
|
||||
Obsolete (operator 2026-11-12): a past event no record proves any more.
|
||||
- ~~The radio change of phase 1 is announced through it.~~ Superseded by the
|
||||
operator note of 2026-11-12 (struck 2026-11-13): a past event no record
|
||||
proves any more.
|
||||
|
||||
### Orchestrator surface and rename
|
||||
|
||||
@@ -522,9 +532,10 @@ flowchart TD
|
||||
settings hook entries, the systemd unit and the container to the
|
||||
`kvb-orchestrator` names. A second run changes nothing (scratch-HOME
|
||||
test).
|
||||
- [ ] The navigation has exactly three top-level entries Stream, Agents and
|
||||
Artifacts; Stream has the sub-items Inbox and Firewall.
|
||||
Obsolete: decision 23 adds Tasks, 003 decision 2 removes Inbox.
|
||||
- ~~The navigation has exactly three top-level entries Stream, Agents and
|
||||
Artifacts; Stream has the sub-items Inbox and Firewall.~~ Superseded by
|
||||
decision 23, which adds Tasks, and 003 decision 2, which removes Inbox
|
||||
(struck 2026-11-13).
|
||||
- [x] Every agent appears once under its current name: a register worker
|
||||
such as "Stage (this session)" or "infinito-nexus-core-c8 (Production)"
|
||||
maps to the agent named before the bracket.
|
||||
@@ -534,8 +545,9 @@ flowchart TD
|
||||
redirect to their successors.
|
||||
- [x] Agents and Artifacts show a switch with Orbit, Chord, Swimlane, Tree and
|
||||
3D in this order, and each view has its own hash.
|
||||
- [ ] The header holds exactly the title, the ⌘K button and the ⚙ button.
|
||||
Obsolete: decision 59 adds Radio, 003 decision 17 the bubbles switch.
|
||||
- ~~The header holds exactly the title, the ⌘K button and the ⚙ button.~~
|
||||
Superseded by decision 59, which adds Radio, and 003 decision 17, which
|
||||
adds the bubbles switch (struck 2026-11-13).
|
||||
- [x] Badges:
|
||||
- [x] Inbox shows the waiting items that are not snoozed.
|
||||
- [x] Agents shows the agents with a heartbeat in the last 900 s.
|
||||
@@ -543,12 +555,12 @@ flowchart TD
|
||||
- [x] A badge at 0 is hidden.
|
||||
- [x] A red Mayday banner with "cancel" exists if and only if a mayday is
|
||||
active; "cancel" runs `radio.py clear`.
|
||||
- [ ] The Agents toolbar holds:
|
||||
- [ ] Radio to all, with the class choice Newsletter, Broadcast, Pan-Pan,
|
||||
Security, Mayday and Newsletter preselected.
|
||||
- [ ] Cancel mayday, Priority and Day/Night.
|
||||
Obsolete: decisions 52 and 59 move the composer and Cancel mayday into
|
||||
the header radio spot; Priority and Day/Night ship.
|
||||
- ~~The Agents toolbar holds:~~ Superseded by decisions 52 and 59, which move
|
||||
the composer and Cancel mayday into the header radio spot; Priority and
|
||||
Day/Night ship (struck 2026-11-13).
|
||||
- ~~Radio to all, with the class choice Newsletter, Broadcast, Pan-Pan,
|
||||
Security, Mayday and Newsletter preselected.~~
|
||||
- ~~Cancel mayday, Priority and Day/Night.~~
|
||||
- [x] The agent panel sends with the choice Post (preselected) or Call.
|
||||
- [x] ⚙ "Ambience" holds Sky, Music, Control room and Notifications;
|
||||
⌘K lists every former header tool.
|
||||
@@ -638,10 +650,11 @@ flowchart TD
|
||||
and tip sha per item, no command) into a host-mounted job directory and
|
||||
holds no git, token or key.
|
||||
- [ ] A systemd user path unit verifies the signature on the host and runs
|
||||
`pkgmgr branch cleanup --apply --local` for exactly the signed items,
|
||||
matched exactly, never as a pattern; `--local` removes the worktree, the local
|
||||
branch, the compose stack without `-v` and its images, never a remote
|
||||
branch, and needs no SSH key.
|
||||
`pkgmgr branch cleanup --apply --local` (the `--local` release is
|
||||
pending in pkgmgr) for exactly the signed items, matched exactly, never
|
||||
as a pattern; it removes the local branch, never a remote branch, a
|
||||
worktree, a Compose stack or a volume, and needs no SSH key; a branch a
|
||||
worktree holds is skipped and left to `kvb-git-gc`.
|
||||
- [x] The unit refuses, and changes nothing for, an item whose tip or state
|
||||
differs from the signed one, an unknown repository, a non-`merged-clean`
|
||||
item and a job with a bad or missing signature, and reports why.
|
||||
@@ -746,11 +759,13 @@ flowchart TD
|
||||
|
||||
Replaced by [003 W4 Resources](003-operator-workbench.md#w4-resources).
|
||||
|
||||
- [ ] The tab shows tokens per agent and accumulated, and CPU, RAM, disk and
|
||||
load, on the shared time axis, several values per chart.
|
||||
- [ ] Token counts equal the sum of the transcript usage fields of a fixture
|
||||
(unit test); host samples come from the host unit's file, not from the
|
||||
container.
|
||||
- ~~The tab shows tokens per agent and accumulated, and CPU, RAM, disk and
|
||||
load, on the shared time axis, several values per chart.~~ Superseded by
|
||||
003 decision 14, which replaces 001 S7 (struck 2026-11-13).
|
||||
- ~~Token counts equal the sum of the transcript usage fields of a fixture
|
||||
(unit test); host samples come from the host unit's file, not from the
|
||||
container.~~ Superseded by 003 decision 14, which replaces 001 S7 (struck
|
||||
2026-11-13).
|
||||
|
||||
### Phase 6: shared cache (S8)
|
||||
|
||||
@@ -826,8 +841,8 @@ Replaced by [003 W4 Resources](003-operator-workbench.md#w4-resources).
|
||||
and the message field focused.
|
||||
- [x] Cancel mayday shows only its icon, keeps its tooltip, its confirmation
|
||||
and its passkey signature.
|
||||
- [ ] The spot shows the speaking caption, the last five sent messages and
|
||||
the stations with play and stop.
|
||||
- [ ] The spot shows the speaking caption, the 004 radio log with its Sent
|
||||
tab (004 decision 7) and the stations with play and stop.
|
||||
|
||||
### Phase 6: agent states and 3D faces (S5.3)
|
||||
|
||||
@@ -896,10 +911,11 @@ Replaced by [003 W4 Resources](003-operator-workbench.md#w4-resources).
|
||||
Stop and the call at its next tool step with a receipt to the caller.
|
||||
- [x] A mayday blocks an Edit until `clear`.
|
||||
- [x] The orchestrator's `/api/tree` serves a pkgmgr-written file.
|
||||
- [ ] On a fixture repository with a file remote and a test token source, a
|
||||
signed job through the path unit removes the merged worktree, the
|
||||
local and the remote branch, and the rewritten tree no longer lists
|
||||
them. Obsolete: contradicts decision 21; 003 decision 10 replaces it.
|
||||
- ~~On a fixture repository with a file remote and a test token source, a
|
||||
signed job through the path unit removes the merged worktree, the local
|
||||
and the remote branch, and the rewritten tree no longer lists them.~~
|
||||
Superseded by decision 21 (local only) and 003 decision 10, which
|
||||
replaces it (struck 2026-11-13).
|
||||
- [ ] `make test` green on the HEAD that carries every phase (operator
|
||||
2026-11-12).
|
||||
- **E2E**
|
||||
|
||||
@@ -381,7 +381,9 @@ The work packages meet only through these interfaces:
|
||||
### Simplicity
|
||||
|
||||
- [ ] Every new control is a Bootstrap Icon with `title` and `aria-label`; no new
|
||||
visible text beyond counts and names.
|
||||
visible text beyond counts and names. A safety note on a destructive
|
||||
confirmation sheet (the cleanup sheet's dry-run note) is allowed visible
|
||||
text and not a control label.
|
||||
|
||||
### Tests
|
||||
|
||||
|
||||
Reference in new issue
Block a user