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
|
directory; a systemd user path unit runs `pkgmgr branch cleanup --apply
|
||||||
--local` for exactly those items and writes the result back. Rejected: an
|
--local` for exactly those items and writes the result back. Rejected: an
|
||||||
`operator.py` row (not direct).
|
`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
|
22. **Organisation update**: a new skill `kvb-org-update` tells every agent
|
||||||
and client which skills changed and how to use them, as one
|
and client which skills changed and how to use them, as one
|
||||||
`newsletter` per update; phase 1 announces the radio change through it.
|
`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:
|
old `#stream/radio` link opens the Stream with the spot open. Rejected:
|
||||||
keeping the Radio tab, the speaker chips (every Agents view already marks
|
keeping the Radio tab, the speaker chips (every Agents view already marks
|
||||||
the speaker).
|
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
|
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
|
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,
|
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
|
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
|
`SKILL.md` before the next use, then records `HEAD` as announced; a
|
||||||
second run without new commits sends nothing.
|
second run without new commits sends nothing.
|
||||||
- [ ] The radio change of phase 1 is announced through it.
|
- ~~The radio change of phase 1 is announced through it.~~ Superseded by the
|
||||||
Obsolete (operator 2026-11-12): a past event no record proves any more.
|
operator note of 2026-11-12 (struck 2026-11-13): a past event no record
|
||||||
|
proves any more.
|
||||||
|
|
||||||
### Orchestrator surface and rename
|
### Orchestrator surface and rename
|
||||||
|
|
||||||
@@ -522,9 +532,10 @@ flowchart TD
|
|||||||
settings hook entries, the systemd unit and the container to the
|
settings hook entries, the systemd unit and the container to the
|
||||||
`kvb-orchestrator` names. A second run changes nothing (scratch-HOME
|
`kvb-orchestrator` names. A second run changes nothing (scratch-HOME
|
||||||
test).
|
test).
|
||||||
- [ ] The navigation has exactly three top-level entries Stream, Agents and
|
- ~~The navigation has exactly three top-level entries Stream, Agents and
|
||||||
Artifacts; Stream has the sub-items Inbox and Firewall.
|
Artifacts; Stream has the sub-items Inbox and Firewall.~~ Superseded by
|
||||||
Obsolete: decision 23 adds Tasks, 003 decision 2 removes Inbox.
|
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
|
- [x] Every agent appears once under its current name: a register worker
|
||||||
such as "Stage (this session)" or "infinito-nexus-core-c8 (Production)"
|
such as "Stage (this session)" or "infinito-nexus-core-c8 (Production)"
|
||||||
maps to the agent named before the bracket.
|
maps to the agent named before the bracket.
|
||||||
@@ -534,8 +545,9 @@ flowchart TD
|
|||||||
redirect to their successors.
|
redirect to their successors.
|
||||||
- [x] Agents and Artifacts show a switch with Orbit, Chord, Swimlane, Tree and
|
- [x] Agents and Artifacts show a switch with Orbit, Chord, Swimlane, Tree and
|
||||||
3D in this order, and each view has its own hash.
|
3D in this order, and each view has its own hash.
|
||||||
- [ ] The header holds exactly the title, the ⌘K button and the ⚙ button.
|
- ~~The header holds exactly the title, the ⌘K button and the ⚙ button.~~
|
||||||
Obsolete: decision 59 adds Radio, 003 decision 17 the bubbles switch.
|
Superseded by decision 59, which adds Radio, and 003 decision 17, which
|
||||||
|
adds the bubbles switch (struck 2026-11-13).
|
||||||
- [x] Badges:
|
- [x] Badges:
|
||||||
- [x] Inbox shows the waiting items that are not snoozed.
|
- [x] Inbox shows the waiting items that are not snoozed.
|
||||||
- [x] Agents shows the agents with a heartbeat in the last 900 s.
|
- [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 badge at 0 is hidden.
|
||||||
- [x] A red Mayday banner with "cancel" exists if and only if a mayday is
|
- [x] A red Mayday banner with "cancel" exists if and only if a mayday is
|
||||||
active; "cancel" runs `radio.py clear`.
|
active; "cancel" runs `radio.py clear`.
|
||||||
- [ ] The Agents toolbar holds:
|
- ~~The Agents toolbar holds:~~ Superseded by decisions 52 and 59, which move
|
||||||
- [ ] Radio to all, with the class choice Newsletter, Broadcast, Pan-Pan,
|
the composer and Cancel mayday into the header radio spot; Priority and
|
||||||
Security, Mayday and Newsletter preselected.
|
Day/Night ship (struck 2026-11-13).
|
||||||
- [ ] Cancel mayday, Priority and Day/Night.
|
- ~~Radio to all, with the class choice Newsletter, Broadcast, Pan-Pan,
|
||||||
Obsolete: decisions 52 and 59 move the composer and Cancel mayday into
|
Security, Mayday and Newsletter preselected.~~
|
||||||
the header radio spot; Priority and Day/Night ship.
|
- ~~Cancel mayday, Priority and Day/Night.~~
|
||||||
- [x] The agent panel sends with the choice Post (preselected) or Call.
|
- [x] The agent panel sends with the choice Post (preselected) or Call.
|
||||||
- [x] ⚙ "Ambience" holds Sky, Music, Control room and Notifications;
|
- [x] ⚙ "Ambience" holds Sky, Music, Control room and Notifications;
|
||||||
⌘K lists every former header tool.
|
⌘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
|
and tip sha per item, no command) into a host-mounted job directory and
|
||||||
holds no git, token or key.
|
holds no git, token or key.
|
||||||
- [ ] A systemd user path unit verifies the signature on the host and runs
|
- [ ] A systemd user path unit verifies the signature on the host and runs
|
||||||
`pkgmgr branch cleanup --apply --local` for exactly the signed items,
|
`pkgmgr branch cleanup --apply --local` (the `--local` release is
|
||||||
matched exactly, never as a pattern; `--local` removes the worktree, the local
|
pending in pkgmgr) for exactly the signed items, matched exactly, never
|
||||||
branch, the compose stack without `-v` and its images, never a remote
|
as a pattern; it removes the local branch, never a remote branch, a
|
||||||
branch, and needs no SSH key.
|
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
|
- [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`
|
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.
|
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).
|
Replaced by [003 W4 Resources](003-operator-workbench.md#w4-resources).
|
||||||
|
|
||||||
- [ ] The tab shows tokens per agent and accumulated, and CPU, RAM, disk and
|
- ~~The tab shows tokens per agent and accumulated, and CPU, RAM, disk and
|
||||||
load, on the shared time axis, several values per chart.
|
load, on the shared time axis, several values per chart.~~ Superseded by
|
||||||
- [ ] Token counts equal the sum of the transcript usage fields of a fixture
|
003 decision 14, which replaces 001 S7 (struck 2026-11-13).
|
||||||
(unit test); host samples come from the host unit's file, not from the
|
- ~~Token counts equal the sum of the transcript usage fields of a fixture
|
||||||
container.
|
(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)
|
### 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.
|
and the message field focused.
|
||||||
- [x] Cancel mayday shows only its icon, keeps its tooltip, its confirmation
|
- [x] Cancel mayday shows only its icon, keeps its tooltip, its confirmation
|
||||||
and its passkey signature.
|
and its passkey signature.
|
||||||
- [ ] The spot shows the speaking caption, the last five sent messages and
|
- [ ] The spot shows the speaking caption, the 004 radio log with its Sent
|
||||||
the stations with play and stop.
|
tab (004 decision 7) and the stations with play and stop.
|
||||||
|
|
||||||
### Phase 6: agent states and 3D faces (S5.3)
|
### 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.
|
Stop and the call at its next tool step with a receipt to the caller.
|
||||||
- [x] A mayday blocks an Edit until `clear`.
|
- [x] A mayday blocks an Edit until `clear`.
|
||||||
- [x] The orchestrator's `/api/tree` serves a pkgmgr-written file.
|
- [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
|
- ~~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
|
signed job through the path unit removes the merged worktree, the local
|
||||||
local and the remote branch, and the rewritten tree no longer lists
|
and the remote branch, and the rewritten tree no longer lists them.~~
|
||||||
them. Obsolete: contradicts decision 21; 003 decision 10 replaces it.
|
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
|
- [ ] `make test` green on the HEAD that carries every phase (operator
|
||||||
2026-11-12).
|
2026-11-12).
|
||||||
- **E2E**
|
- **E2E**
|
||||||
|
|||||||
@@ -381,7 +381,9 @@ The work packages meet only through these interfaces:
|
|||||||
### Simplicity
|
### Simplicity
|
||||||
|
|
||||||
- [ ] Every new control is a Bootstrap Icon with `title` and `aria-label`; no new
|
- [ ] 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
|
### Tests
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user