resolutionflow/.ai/HANDOFF.md

HANDOFF.md

Last updated: 2026-05-01 (session 9 — started issue cleanup plan sections 1 and 2)

Active task: None. Pick next from .ai/TODO.md or roadmap.

Just-updated: issue cleanup plan sections 1 and 2 were started and documented.

Where this session ended

Issue cleanup plan follow-up completed:

• Section 1: frontend lint is clean. Stale lint disables from the warning set were removed or replaced with justified comments, hook dependency warnings were resolved, e2e selectors were added for session history and the FlowPilot command-palette entry, and AssistantChatPage now logs unexpected currentChatRef stale async discards.
• Section 2: TaskLane action cards now have diagnostic help affordances for common commands (connectivity, DNS, IP config, event logs, services, and generic checks). #128 was documented as "keep existing responsive side-panel/bottom-drawer behavior unless pilot feedback proves a preference is needed."
• Updated docs/plans/2026-05-01-issue-cleanup-plan.md with section 1/2 status and validation.
• Validation passed: docker exec -w /app resolutionflow_frontend npm run lint, docker exec -w /app resolutionflow_frontend npx tsc -b, and docker exec -w /app resolutionflow_frontend npm run build (existing Vite large-chunk warning only).

Resume point — DO THIS NEXT

If tracker auth is available, close #127 and close/archive stale PR #124; rewrite #66 to template packs / one-click install only. Then continue the plan at section 3: #58 structured "step is wrong" quality signals. After that, section 4 is #60 recurring issue detection and section 5 is #129 hierarchical guide navigation.

Environment notes (carry-forward)

• This code-server LXC has bun + docker but no native python/node/npm. Use docker exec resolutionflow_{backend,frontend} … for all build/test commands. Documented in .ai/PROJECT_CONTEXT.md.
• Headless Chromium (used by /qa /browse) needs CONTAINER=1 in the env that launches the browse server, otherwise it aborts at sandbox/linux/services/credentials.cc due to the LXC namespace constraint. The browse server is currently running with that env set; restarting it manually requires CONTAINER=1 $B status again.
• Code-server's /etc/hosts has 100.64.78.44 docker-01 so the headless browser can resolve the bake-in VITE_API_URL. Persistent — no need to re-add unless the container is rebuilt.
• Multi-head alembic state on main (heads 070, c0f3a4b7e91d, 024) is pre-existing. Use alembic upgrade heads (plural) if head complains.