Files
GitManager/components/repo-list/repo-list.md
T
TBNilles 69d38484e8 Slice 13: repo search + filtering (+ no-cache dev assets)
<repo-list> gains a search box (name/path) and Dirty/Ahead-behind filter chips with an N-of-M count; filtering is client-side and the state persists in localStorage (gitmanager.repolist.filters, §4). Refresh/selection re-apply filters. cmd/server sends Cache-Control: no-cache for /components and /static so hot-reloaded asset edits show on reload. Server-verified (curl); live click-through pending an unresponsive browser pane.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-20 18:02:30 -04:00

2.3 KiB

repo-list

Intent

The dashboard's list of every discovered repository. It is the first ActiveX-spirit control in the app (AGENT.md §1.1): a self-contained custom element that fetches its own data, renders inside its shadow root, and communicates outward only through events. It exists to prove and anchor the component pattern the rest of the UI follows.

Public surface

  • Tag: <repo-list>
  • Attributes/properties: none.
  • Search + filter: a search box (matches name/path, case-insensitive) plus "Dirty" and "Ahead/behind" toggle chips, with a "N of M" count. Filtering is client-side over the fetched list; the state persists per-viewer in localStorage["gitmanager.repolist.filters"] (§4).
  • Fetches: GET /api/repos on connect and every 15s (in-flight request is aborted on refresh and on disconnect).
  • Emits: repo:select — a CustomEvent (bubbles + composed) whose detail is the clicked repo's state object. The detail panel (future) listens for this.

History

  • 2026-09-19: created — first component; renders name, branch, ahead/behind, and a clean/dirty badge; establishes the shadow-DOM + self-fetch + event pattern.
  • 2026-09-19: added a selected-item highlight — the clicked repo keeps an accent border/background (the item that <repo-detail> is showing). Caches the last /api/repos payload so re-selecting re-renders without a refetch.
  • 2026-09-20: selecting a repo now also POSTs /api/active-project to make it the active project (a user action, §8.2) — surfaced in <activity-feed> and readable by Claude via get_active_project. Fire-and-forget.
  • 2026-09-20: right-clicking a repo emits repo:contextmenu {repo, x, y} for <repo-menu> (§6). Right-click does not change the selection/active project.
  • 2026-09-20: added search + "Dirty"/"Ahead-behind" filter chips with a count, persisted in localStorage; filtering is client-side (slice 13).

Notes / gotchas

  • Uses shared design tokens (--git-*, --surface-*, --radius*) for all colors and radii — no hardcoded hex (AGENT.md §1.1).
  • Server output is escaped before insertion (#esc); repo names come from the filesystem, so treat them as untrusted.
  • Polling is a placeholder cadence; a push/SSE update channel can replace it later without changing the public surface.