GitManager/CHANGELOG.md

Changelog

Append-only running history of all changes (AGENT.md §9.1). Newest last.

2026-09-19 — Project scaffold

• What: Initial runnable skeleton for the GitManager multi-repo dashboard. Added the Go backend (cmd/server/main.go + internal/{config,logging,git,repos,render}), the Echo HTTP server with /, /help, /healthz, and /api/repos, a read-only repo scanner that discovers repositories under GIT_REPO_ROOTS and keeps an in-memory index, the <repo-list> web component, shared design tokens (web/static/app.css), page shells (web/templates/{index,help}.html), and the dev tooling: Dockerfile (build/dev/runtime stages), docker-compose.yml, .air.toml, .env.example, .gitignore, go.mod.
• Why: Stand up the architecture defined in AGENT.md so feature work can begin.
• Affects: whole repo (foundation); components/repo-list.

2026-09-19 — Repo detail panel

• What: Added the <repo-detail> component (right dock) that listens for repo:select and shows a repo's remotes, local branches (current + upstream), and 20 most recent commits. Backed by a new GET /api/repo?path= endpoint (restricted to indexed repos) and new read-only git readers (LocalBranches, RecentCommits, RemoteDetails) plus repos.BuildDetail and Index.Get. <repo-list> now highlights the selected repo; index.html lays the two panels out left/right; help page documents the detail view.
• Why: Make the dashboard drill into a single repository (the detail half of the list+detail default in AGENT.md §4).
• Affects: components/repo-detail, components/repo-list, internal/git, internal/repos, cmd/server, web/templates.

Notes to confirm (from AGENT.md §11)

• Go module path is the placeholder gitmanager; change it if this gets a canonical import path (e.g. a GitHub URL).
• All items in AGENT.md §11 (discovery strategy, background fetch, forge providers, listen address, container credentials) remain open.

2026-09-19 — Redefine the app as a two-way Claude companion (contract only)

• What: Updated AGENT.md to make the Claude integration the defining pillar, no code yet. §0 now states the two-way purpose (Claude↔app) and the non-expert, GUI-first goal; added law §1.7 (one service layer behind both the GUI and the MCP server); stack table gained MCP server (Go SDK over Streamable HTTP at /mcp), SSE (app→browser), and flipped forge to Gitea-first read+write; layout added internal/{service,mcp,activity}; §6 added the right-click plain-language command vocabulary; §8 rewritten into "Claude integration" (8.1 MCP server, 8.2 activity feed + active project, 8.3 graceful project handoff, 8.4 forge read+write with "Merge & clean up"); §10 step 4 and §11 updated (three decisions resolved, new open items). .env.example now documents GITEA_TOKEN (read+write scope).
• Why: Thomas described the real vision — the app should act as an extension of Claude: usable like an MCP by Claude, notifying Claude of in-app actions to stay in sync, cooperative project handoff when he's interrupted, plain-language right-click commands for non-experts, and one-click "merge & clean up" so PRs stop cluttering repos. Decisions locked: cooperative pull-first handoff; Gitea writes enabled (confirmed per §1.4); MCP over HTTP /mcp.
• Affects: AGENT.md, .env.example (architecture/contract only — no code).

2026-09-19 — Service layer + MCP server (Claude integration, read tools)

• What: Slice 1 — extracted internal/service, the one capability layer both the HTTP API and the MCP server call (§1.7); the /api/repos and /api/repo handlers now route through it. Slice 2 — added internal/mcp: an MCP server (github.com/modelcontextprotocol/go-sdk v1.8.0) served over Streamable HTTP at /mcp, with read tools list_repos and get_repo as thin adapters over the service. Added a round-trip test (internal/mcp/mcp_test.go) using a real temp git repo + the in-memory MCP transport. Verified the HTTP /mcp handshake locally and in Docker.
• Why: First step of the two-way Claude integration (AGENT.md §8.1) — prove Claude can connect to the app over MCP before building deeper features on it.
• Affects: internal/service (new), internal/mcp (new), cmd/server/main.go, go.mod/go.sum, .air.toml.
• Gotcha: Docker-on-Windows bind mounts do NOT deliver filesystem events, so air's watch-based reload silently never fired. Fixed by enabling air polling (poll = true, poll_interval = 500 in .air.toml).

2026-09-20 — HTTPS for the MCP connector (local TLS via mkcert)

• What: Added an optional HTTPS listener alongside HTTP. New config HTTPS_ADDR, TLS_CERT_FILE, TLS_KEY_FILE; when set, cmd/server starts e.StartTLS on the same Echo app (best-effort — a missing cert logs a warning and stays HTTP-only). docker-compose publishes 127.0.0.1:8443 and points the TLS vars at certs/localhost.pem (mounted via the existing source mount). .gitignore ignores /certs/; .env.example documents the mkcert steps.
• Why: Claude Desktop's custom MCP connector only accepts https:// URLs. Local TLS with an mkcert-trusted cert lets https://localhost:8443/mcp work without exposing the unauthenticated app via a public tunnel (AGENT.md §8.1).
• Affects: internal/config, cmd/server/main.go, docker-compose.yml, .gitignore, .env.example, AGENT.md (§8.1, §11).
• Host setup (user-run): the local CA install (mkcert -install) is a security-settings change performed by the user, not the app.

2026-09-20 — Connect Claude Desktop via local stdio bridge (mcp-remote)

• What: Corrected the Claude Desktop connection method in AGENT.md (§8.1, §11). The GUI "Add custom connector" flow can NOT reach a localhost server — it probes and calls tools from Anthropic's cloud, so https://127.0.0.1:8443/mcp fails "couldn't reach the server" even though a local browser reaches it. The working path is a local stdio bridge in claude_desktop_config.json: mcpServers.gitmanager = cmd /c npx -y mcp-remote http://127.0.0.1:8080/mcp. Added that entry to the user's Claude Desktop config (backup saved alongside).
• Why: Keep the app localhost-only + unauthenticated (§0) while still letting Claude Desktop drive it. mcp-remote runs locally, so it reaches the local endpoint directly — no public exposure, no HTTPS needed for this path.
• Affects: AGENT.md (§8.1, §11); user's claude_desktop_config.json (outside the repo). HTTPS/:8443 from the prior entry stays available but is now optional.