curo/kite

Files

T

curo1305andClaude Sonnet 4.6 123ae5b29b chore: archive v0.2 phase directories to milestones/v0.2-phases/

Moves phases 08–11 execution artifacts from .planning/phases/ to
.planning/milestones/v0.2-phases/ to keep .planning/phases/ clean
for the next milestone.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-17 14:34:52 +02:00

4.9 KiB

Raw Blame History

phase, plan, subsystem, tags, dependency_graph, tech_stack, key_files, decisions, metrics

phase

plan

subsystem

Phase 10 Plan 03: BreadcrumbBar Component Summary

One-liner: Shared breadcrumb component with showRoot/rootLabel props, ellipsis collapse for >4 segments, and static no-id segment support for admin/settings views.

Tasks Completed

Task	Name	Commit	Files
1	Create BreadcrumbBar.test.js (RED)	`b6ea858`	frontend/src/components/ui/tests/BreadcrumbBar.test.js
2	Implement BreadcrumbBar.vue (GREEN)	`7e584e0`	frontend/src/components/ui/BreadcrumbBar.vue, frontend/src/components/ui/AppIcon.vue

What Was Built

BreadcrumbBar.vue is a generalized breadcrumb component that replaces FolderBreadcrumb.vue across all views. Key capabilities over the original:

showRoot prop (Boolean, default true): When false, omits the root button entirely — needed for admin/settings views (Admin > Users, Settings > Account) that have no "Home" concept.
rootLabel prop (String, default 'Home'): Configurable root text — file manager uses 'Home', cloud view uses 'Cloud'.
Static segments (no id): Segments without an id render as non-clickable <span> elements. Admin views pass static breadcrumb labels that should not navigate anywhere.
{ id?, label } shape: Changed from FolderBreadcrumb's { id, name } to { id?, label }. Wave 1 (plan 10-06) maps existing { id, name } to { id, label: name } at call sites.
AppIcon separator: Uses <AppIcon name="chevronRight"> instead of inline SVG — enforces the new icon centralization paradigm from plan 10-01.
Ellipsis collapse: >4 segments collapses to [first, ellipsis, ...last_two] — carried from FolderBreadcrumb.

Test Coverage

10 Vitest unit tests, all green:

Renders rootLabel button when showRoot=true
No button rendered when showRoot=false
Root click emits navigate(null)
Last segment is non-clickable span
Intermediate segment click emits navigate(segment.id)
No-id segments render as plain text (no buttons)
4 segments collapse to first + ellipsis + last two
rootLabel defaults to 'Home'
Custom rootLabel 'Cloud' renders correctly
chevronRight AppIcon separator present

Deviations from Plan

Auto-fixed Issues

1. [Rule 3 - Blocking] AppIcon.vue missing in worktree

Found during: Task 2 (implementing BreadcrumbBar.vue which imports AppIcon)
Issue: frontend/src/components/ui/AppIcon.vue does not exist in this worktree. Plan 10-01 creates AppIcon in a parallel wave-0 agent. Without AppIcon, the BreadcrumbBar import would fail at test time.
Fix: Created AppIcon.vue in the worktree using the full implementation from PATTERNS.md. Identical to what plan 10-01 will produce. When the wave merges, git will show no conflict (same content).
Files modified: frontend/src/components/ui/AppIcon.vue (created)
Commit: 7e584e0

Known Stubs

None. BreadcrumbBar is complete and self-contained. It emits navigate events; the caller handles routing.

Threat Flags

None. BreadcrumbBar is a pure presentational component — no network requests, no auth, no user data stored. Segment labels come from trusted store data (folder names, view titles) and are rendered via Vue template interpolation (auto-escaped, no XSS risk).

Self-Check: PASSED

frontend/src/components/ui/__tests__/BreadcrumbBar.test.js exists
frontend/src/components/ui/BreadcrumbBar.vue exists
frontend/src/components/ui/AppIcon.vue exists
Commit b6ea858 exists (RED phase)
Commit 7e584e0 exists (GREEN phase)
All 10 tests pass (./node_modules/.bin/vitest run BreadcrumbBar — 10/10)
name: 'BreadcrumbBar' present in BreadcrumbBar.vue
rootLabel appears >= 2 times in BreadcrumbBar.vue
showRoot appears >= 3 times in BreadcrumbBar.vue
<AppIcon name="chevronRight" present in BreadcrumbBar.vue

4.9 KiB Raw Blame History