mirror of
https://github.com/PR0M3TH3AN/TORCH.git
synced 2026-11-03 19:34:24 +00:00
Document observed live Console usability and attention findings
This commit is contained in:
1 parent
0224abf2e0
commit
7b7c6584b9
3 files changed
+181
-1
No files matched your search
+10
-1
@@ -88,13 +88,22 @@ candidate `ae18a98e2911aa515d0484518013061b05ff6adf` and the Manager has a bound
|
||||
next-slice planning request. The candidate's test/check/lint receipts pass; its
|
||||
dashboard receipt remains incomplete because the test writes tracked reports.
|
||||
Neither review launch nor controller exit is acceptance or landing evidence.
|
||||
There are now 41 owner-intake items, including agent chat and the UI audit.
|
||||
There are now 43 owner-intake items, including agent chat, the UI audit and two
|
||||
observed attention/startup follow-ups.
|
||||
|
||||
- [ ] `TASK-console-ux-audit`: Session Manager assigns Owner Console to audit
|
||||
every live dashboard area through actual computer use and inspected screenshots,
|
||||
including desktop/mobile and keyboard/refresh behavior. Owner rejects the long
|
||||
single-page/anchor-navigation layout. Propose focused separate screens, concise
|
||||
overview and contextual drilldowns. Audit/proposal only; no UI rewrite yet.
|
||||
- [ ] `TASK-console-attention-actions`: meaningful condition/agent/branch labels,
|
||||
deduplicated findings and contextual quick actions. Owner approve/reject uses
|
||||
existing evidence/revision/preview confirmation; never clear peer messages,
|
||||
merge branches or publish to a remote through a generic warning button.
|
||||
- [ ] `TASK-pilot-brief-sandbox`: the first UI audit stopped at a read-only SQLite
|
||||
error while the exact installed brief succeeds on the host. Qualify scoped
|
||||
sandbox access and actionable failure; do not disable sandboxing, change DB
|
||||
permissions, copy state or bypass the authoritative startup brief.
|
||||
|
||||
## First real self-host run (2026-09-30)
|
||||
|
||||
|
||||
@@ -132,3 +132,29 @@ Canonical COMMON now permits this audit in parallel with diagnostics QA, without
|
||||
authorizing UI implementation, unrelated dispatch, automatic wakes or release.
|
||||
The arbiter launches Owner Console only after actual manager assignment; a
|
||||
request in an inbox is not itself assignment evidence.
|
||||
|
||||
## Attention-panel triage and audit recovery
|
||||
|
||||
Session Manager assigned `TASK-console-ux-audit` to Owner Console at revision 3.
|
||||
The first audit turn **did not perform browser coverage**: installed `torch brief`
|
||||
failed with `ERR_SQLITE_ERROR` / read-only database. The identical installed brief
|
||||
passes from the host. The arbiter resumed the same session with directions to
|
||||
request narrowly scoped escalation for that exact command, not change permissions
|
||||
or skip the guard. `TASK-pilot-brief-sandbox` captures durable qualification.
|
||||
|
||||
Owner additionally requests contextual quick actions in Needs your attention.
|
||||
`TASK-console-attention-actions` requires meaningful per-agent/branch findings,
|
||||
deduplicated messages and owner-only reviewed approve/reject actions. Total
|
||||
owner intake is now 43. It does not authorize warning dismissal, blanket message
|
||||
acknowledgement, automatic merging or remote publication.
|
||||
|
||||
Observed worktree warnings: manager backlog updates are dirty, and manager and
|
||||
Provider Runtime retain unique commits. These are preserved task state and
|
||||
unlanded work, not permission to remove worktrees or discard commits. The manager
|
||||
has a narrowly authorized local backlog checkpoint/convergence request and must
|
||||
review its own inbox. Provider code still requires integration gates.
|
||||
|
||||
Recovery is `ONE-DISK` for current rewrite HEAD: origin exists, but local
|
||||
remote-tracking references do not contain that commit. This is not proof of a
|
||||
live remote query. Off-machine synchronization requires an explicit owner
|
||||
publication/backup decision; no remote push or default-main promotion occurred.
|
||||
@@ -0,0 +1,145 @@
|
||||
# Live Console arbiter usability audit
|
||||
|
||||
## Evidence and scope
|
||||
|
||||
Owner requested direct inspection of `http://127.0.0.1:4174/console` and a report
|
||||
to Session Manager. Inspected the real installed workspace in the connected Brave
|
||||
browser using interactive navigation, DOM observations and actually viewed
|
||||
viewport screenshots. No live task, approval, profile, release or message was
|
||||
mutated through the browser. Expanded the request composer and one incomplete
|
||||
check receipt only. Screenshots were viewed in this audit conversation; no new
|
||||
artifact catalog or saved screenshot files are claimed.
|
||||
|
||||
Visited all ten navigation entries: Overview, Briefing, Flow watch, Work,
|
||||
Progress, Fleet, Conversations, Organization, Evidence and Release gates.
|
||||
Temporary narrow viewport was reset afterward. Desktop DOM viewport was
|
||||
1253×685. Requested mobile override 390×844 produced reported CSS viewport
|
||||
433×938 in this browser; responsive measurements below use the reported values.
|
||||
No full keyboard audit, draft/refresh experiment, approval submission, empty/error
|
||||
simulation or hidden Operations panel coverage is claimed. Those remain the
|
||||
assigned UI agent's coverage requirements.
|
||||
|
||||
## Prioritized findings
|
||||
|
||||
### P1: one document makes monitoring impractical
|
||||
|
||||
Desktop document height measured 50,288 pixels. Work occupied 36,662 pixels,
|
||||
Conversations 5,723 and Organization 2,931 at the observation point. Navigation
|
||||
changes URL fragments and scroll position rather than opening focused views.
|
||||
The masthead/project/freshness controls scroll away on lower sections. Current
|
||||
nav styling exists, but every navigation link lacked `aria-current`.
|
||||
|
||||
Use addressable separate screens with persistent project context. Keep Overview
|
||||
to a concise pulse, real decisions, blockers and recent outcomes. Route detail
|
||||
links to exact task, agent, check or decision rather than a broad section.
|
||||
|
||||
### P1: work-card density dominates the page
|
||||
|
||||
There were 43 active tasks, including 41 Queue cards. Narrow desktop kanban
|
||||
columns wrap IDs and titles heavily and show full long descriptions. Filtering,
|
||||
saved-view editing and task creation sit above the actual work. At narrow size,
|
||||
the filter block alone measured approximately 572 CSS pixels, followed by a
|
||||
horizontally navigated kanban.
|
||||
|
||||
Use compact task summaries with a detail drawer/page. Separate proposed backlog
|
||||
from active work by default; retain one authoritative task system. Put secondary
|
||||
filters/saved-view editing behind an intentional control. Mobile should offer a
|
||||
usable list or selected-column view, not require navigating every column.
|
||||
|
||||
### P1: attention is opaque and duplicates the same condition
|
||||
|
||||
Actual Overview repeated MESSAGE_BACKLOG plus the unacknowledged message count,
|
||||
and three WORKTREE_PROBLEM entries all said only “Doctor reported a project
|
||||
condition to review.” Unique commits and manager backlog edits are not equivalent
|
||||
to a failed merge or missing tree. The Healthy badge can imply more operational
|
||||
readiness than these conditions justify; the existing doctor threshold may be
|
||||
valid, but the UI label should describe its narrower meaning.
|
||||
|
||||
Implement `TASK-console-attention-actions`: group and deduplicate actual entities,
|
||||
name identity/branch/reason, distinguish safety gates from routine agent progress.
|
||||
Offer owner Approve/Reject only for an actual pending owner-addressed approval,
|
||||
using current revision/evidence preview-confirm checks. Offer exact inspect,
|
||||
message/review or supported recovery actions otherwise. No blanket dismiss,
|
||||
peer-message acknowledgement, merge, deletion or publication shortcut.
|
||||
|
||||
### P1: conversations is an internal transcript, not owner chat
|
||||
|
||||
Two-column entries expose entire long coordination instructions. There is no
|
||||
agent-thread picker, compact subject/task grouping or focused reply experience.
|
||||
The expanded installed request composer displayed “Install a reviewed Fleet
|
||||
before sending owner requests” while identity options were populated and Preview
|
||||
request was present. This contradicts the installed workspace state. Existing
|
||||
request composition is not a native owner reply channel or automatic wake.
|
||||
|
||||
Implement `TASK-owner-agent-chat` with truthful per-agent threading, delivery and
|
||||
reply states. Keep engineering message detail expandable; show concise relevant
|
||||
summaries first. Fix stale placeholder status from actual capability state.
|
||||
|
||||
### P2: fleet, ownership and organization repeat technical metadata
|
||||
|
||||
Fleet repeats runtime/model/profile text and mixes implementation paths with
|
||||
session monitoring. Organization cards repeat peer links and large owned-path
|
||||
lists; the QA role shows an extensive historical report-file inventory. These
|
||||
are useful audit details but poor default monitoring content.
|
||||
|
||||
Use a compact agent table/list showing work, state, last evidence, blocker and
|
||||
chat/open actions. Put ownership paths and authority into agent detail. Use an
|
||||
actual hierarchy/relationships view for Organization with a details inspector.
|
||||
Do not replace observed presence with inferred process liveness.
|
||||
|
||||
### P2: briefing and progress do not provide a quick owner outcome
|
||||
|
||||
Briefing was unpublished and instructed the owner to run digest build/publish CLI
|
||||
commands. Progress showed feature/milestone group totals but did not provide an
|
||||
obvious exact-task drilldown. Preserve its good distinction between task progress
|
||||
and verification/release readiness.
|
||||
|
||||
Provide permission-aware local generate/review/publish flow when supported and
|
||||
link progress groups to filtered work. Do not send notifications or publish a
|
||||
release as a side effect of preparing a local briefing.
|
||||
|
||||
### P2: evidence is honest but recovery navigation is weak
|
||||
|
||||
Expanded test-dashboard receipt correctly showed incomplete,
|
||||
worktree-changed-during-check, exact SHA and missing frozen/condition evidence.
|
||||
This is valuable and must remain strict. Artifacts are not connected yet;
|
||||
integration/delivery records are empty and correctly avoid implying deployment.
|
||||
Flow watch still said timer installation not verified despite the earlier
|
||||
host-qualified timer; review how operational evidence reaches this snapshot,
|
||||
rather than merely removing the warning.
|
||||
|
||||
Add links from an incomplete check to its task, author, candidate and blocking
|
||||
condition. Show the reviewed next step without turning “retry” into an automatic
|
||||
repeat of uncertain effects. Place receipts and advanced operational detail on
|
||||
the relevant screen, not below every unrelated workflow.
|
||||
|
||||
## Proposed information architecture
|
||||
|
||||
- Overview: concise project outcome, decisions, blockers, recent events.
|
||||
- Work: active work; compact proposed backlog; filters and exact task detail.
|
||||
- Agents: state/work/waits, per-agent chat and profile/ownership detail.
|
||||
- Pipelines: conditional project-defined flows, deliverables and stage history.
|
||||
- Evidence: checks/artifacts with exact task/commit links and review actions.
|
||||
- Releases: integration, delivery and separately authorized recovery.
|
||||
- Organization / Settings: hierarchy, ownership, operations and configuration.
|
||||
|
||||
Briefing may be accessible from Overview; advanced operational panels should have
|
||||
their own destination. Retain dark mode and original TORCH mark. Avoid filling
|
||||
every view with duplicate cards or decorative labels.
|
||||
|
||||
## Implementation acceptance recommendations
|
||||
|
||||
1. A navigation action displays only its focused workspace, preserves project
|
||||
identity/freshness, and supports addressable reload/back/forward behavior.
|
||||
2. Forty-plus proposed tasks do not make Overview or agent conversations taller;
|
||||
compact cards and bounded/paginated detail preserve all underlying records.
|
||||
3. Attention is entity-specific and deduplicated, with authority-aware actions
|
||||
and unchanged stale-preview/revision/evidence safety checks.
|
||||
4. Installed request status derives from current capability, not leftover loading
|
||||
copy. Per-agent threads remain readable after reload and provider changes.
|
||||
5. Narrow/mobile monitoring reaches work and actions without a full-screen wall
|
||||
of filters; current navigation is accessible via focus and `aria-current`.
|
||||
6. Independent browser scenarios verify navigation, refresh/drafts, mobile,
|
||||
pending approvals, wrong approver, incomplete checks and failed launches.
|
||||
|
||||
This report is audit evidence and a proposal, not implementation qualification.
|
||||
Reference in new issue
Block a user