Co-authored-by: nova28 <17953305+nova28@users.noreply.github.com> Co-authored-by: Carlos Florencio <carlosmflorencio@gmail.com>
2.4 KiB
created, status, requirements, system_design, legacy_specs
| created | status | requirements | system_design | legacy_specs | |||
|---|---|---|---|---|---|---|---|
| 2026-09-12 | complete |
|
|
Implementation Plan: Needs-you Inbox
Overview
Deliver a workspace-scoped sidebar destination that lists every clarification bundle genuinely waiting on a human and lets the operator answer it without leaving the page, per requirements and system design (part 2: control flow, failure, persistence, security).
This feature was built through Kandev's own spec-driven-development workflow
(5 spec-review rounds, 4 build rounds, security/test/code review, an
operator-authorized direct fix round, then PR integration) with its running
record kept in the task's own plan store rather than as narrative here. This
document exists to satisfy the repository's PR documentation coverage gate
(ci: enforce pull request documentation coverage), which was not wired into
that workflow when this feature's spec canon was authored.
Scope
In scope
- Sidebar nav entry and route for the Needs-you Inbox, gated on
features.needsYouInbox. - A bounded, workspace-scoped list-and-count read path built on
clarificationBundleQuery/currentTurnAuthority. - In-place answer via the shipped
ClarificationPanelSection. - Per-user dismiss/snooze/restore sidecar that never mutates the underlying clarification record.
- i18n in all five shipped locales.
Out of scope
Re-ask, the history bucket, the failed-task bucket, cross-workspace rows, and any change to the current-turn predicate's meaning. See the requirements document's own "Out of scope" section for the full list.
Work orders
Single work order; no dependents.
Verification results
See the work order for the full verification record. Summary: backend and
frontend build/lint/typecheck clean; targeted and full package test suites
pass (pre-existing, unrelated failures proven against merge-base in a scratch
worktree); desktop and mobile E2E specs for the answer-in-place flow pass;
pnpm run i18n:check and pnpm run i18n:ratchet clean; python3 scripts/lint-spec-files.py --all passes.