Files
kandev/docs/plans/needs-you-inbox/plan.md
T
2026-09-14 09:19:55 +01:00

2.4 KiB

created, status, requirements, system_design, legacy_specs
created status requirements system_design legacy_specs
2026-09-12 complete
REQ-UI-NEEDS-YOU-INBOX-001
../../specs/ui/system-design/needs-you-inbox-01.md
../../specs/ui/system-design/needs-you-inbox-02.md

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.

PR: https://github.com/kdlbs/kandev/pull/3641