Skip to content

v1.0 #435

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Kaenn wants to merge 1 commit into from
Closed

v1.0 #435

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions .planning/MILESTONES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Project Milestones: GSD-UI

## v1.0 MVP (Shipped: 2026-01-25)

**Delivered:** Visual GSD panel for Claude Code terminal with tree view, command execution, three-pane layout, and WhatsApp-style conversation view.

**Phases completed:** 1-6 (18 plans total)

**Key accomplishments:**

- Zustand store with markdown parsers and auto-refresh file watcher for GSD data
- Hierarchical tree view with expand/collapse, status indicators, and progress bars
- Command execution via Next Up button and interactive tree nodes
- Three-pane layout with command panel, terminal, and status panel
- Complete rebrand from OPCode to GSD-UI with cyan color scheme
- WhatsApp-style conversation view with collapsible tool messages

**Stats:**

- ~42,750 lines of TypeScript
- 6 phases, 18 plans, 41 decisions logged
- 2 days from project start to ship (2026-01-24 → 2026-01-25)
- ~2h 37min total execution time

**Git range:** `feat(01-01)` → `feat(06-04)`

**What's next:** Plugin system architecture, multi-panel support, settings UI

---
104 changes: 104 additions & 0 deletions .planning/PROJECT.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
# GSD-UI

## What This Is

A visual GSD (Get Shit Done) panel for Claude Code, built as a Tauri desktop app with React. The terminal remains central to the experience, with collapsible side panels providing project context, command shortcuts, and tree visualization of phases and plans.

## Core Value

Terminal-centric workflow enhancement — the GSD panel augments Claude Code without disrupting the terminal-first experience.

## Requirements

### Validated

- Terminal Claude Code fonctionnel avec streaming de messages — existing
- Systeme d'onglets avec persistence — existing
- Navigation tab-based (chat, agent, projects, settings) — existing
- Persistence des sessions (localStorage) — existing
- Support Tauri desktop + mode web — existing
- Composants UI Radix + Tailwind — existing
- State management Zustand + Context — existing
- Adapter pattern environnement (Tauri vs web) — existing
- Panneau lateral GSD a gauche ou droite du terminal — v1.0
- Panneau redimensionnable (drag pour ajuster largeur) — v1.0
- Panneau collapsible (toggle hide/show) — v1.0
- Parser STATE.md pour extraire l'etat courant — v1.0
- Parser ROADMAP.md pour extraire la structure — v1.0
- Parser les fichiers PLAN.md pour le detail — v1.0
- Detecter les changements de fichiers .planning/ — v1.0
- Afficher la hierarchie phases → plans en tree view — v1.0
- Expand/collapse des noeuds de l'arbre — v1.0
- Indicateurs de statut visuels (pending/in-progress/complete) — v1.0
- Barre de progression par phase — v1.0
- Boutons "Next Up" cliquables — v1.0
- Clic sur Next Up execute /clear puis commande — v1.0
- Commandes pre-promptees avec parametres — v1.0
- Systeme de combos (UI toggle, auto-chaining deferred) — v1.0
- Command panel avec categories et filtrage — v1.0
- Three-pane layout avec panneaux independants — v1.0
- Rebrand complet OPCode → GSD-UI — v1.0
- Conversation view collapsible avec tool badges — v1.0

### Active

- [ ] Systeme de plugins avec registration et configuration
- [ ] Abstraction des sources de donnees (fichiers / SQLite / custom)
- [ ] Multi-panneaux (plusieurs plugins ouverts simultanement)
- [ ] Settings UI dynamique pour configurer plugins/combos
- [ ] Keyboard shortcuts pour actions frequentes
- [ ] Auto-chaining combo execution via Rust backend events

### Out of Scope

- Plugin marketplace — Infrastructure massive, pas necessaire pour valider l'architecture
- Hot reload plugins — Complexite excessive, restart suffisant
- Plugin sandboxing — Trust model pour v1, securite peut attendre
- Multi-language plugins — TypeScript only simplifie le developpement
- Edition des fichiers .planning/ — Lecture seule, Claude Code gere l'ecriture
- Real-time collaboration — Single user pour v1
- Mobile — Desktop/web uniquement
- Authentification — Pas de systeme auth pour v1

## Context

Fork du projet OPCode (https://github.com/anthropics/claude-code). L'architecture existante est propre : terminal-centric, tab-based, avec separation claire des layers (presentation, business logic, services, API adapter).

**Current State (v1.0 shipped):**
- ~42,750 LOC TypeScript/TSX
- Tech stack: Tauri + React + TypeScript + Tailwind + Zustand + Radix UI
- 6 phases completed, 18 plans executed
- Cyan color scheme with GSD-UI branding
- OPCode attribution preserved

**User feedback themes:** None yet (first release)

**Known issues:**
- Combo toggle is UI-only; auto-chaining needs Rust backend events
- Some hardcoded paths in file reading commands

## Constraints

- **Tech stack**: Conserver Tauri + React + TypeScript + Tailwind + Zustand (stack existante)
- **Architecture**: Le terminal reste au centre, panneaux lateraux en complement
- **Plugin isolation**: Un plugin ne peut pas affecter le comportement d'un autre (future)
- **Data sources**: Abstraction obligatoire (pas de code specifique au filesystem dans le core) (future)

## Key Decisions

| Decision | Rationale | Outcome |
|----------|-----------|---------|
| Terminal-centric | OPCode fonctionne bien, garder l'UX existante | Good |
| GSD comme premier plugin | Cas d'usage concret pour valider l'architecture | Good |
| Polling for file watching | Simpler than native fs-watch, no Rust changes | Good |
| Rust backend commands for file access | Avoids Tauri fs plugin sandbox restrictions | Good |
| 2-level hierarchy (phases → plans) | Matches ROADMAP.md structure | Good |
| Set<string> for expand state | O(1) lookup for tree nodes | Good |
| Three-pane layout | Flexible panel arrangement | Good |
| oklch(0.70 0.15 200) cyan | Modern color space, distinct from OPCode violet | Good |
| WhatsApp-style messages | Familiar UX, clear sender distinction | Good |
| Plugin config externe | Separation core/plugins, maintenabilite | Pending |
| Combos defined by plugin | Flexibilite, chaque plugin connait ses workflows | Pending |

---
*Last updated: 2026-01-25 after v1.0 milestone*
37 changes: 37 additions & 0 deletions .planning/ROADMAP.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Roadmap: GSD-UI

## Milestones

- **v1.0 MVP** — Phases 1-6 (shipped 2026-01-25) — [Archive](.planning/milestones/v1.0-ROADMAP.md)
- **v1.1** — Planned

## Phases

<details>
<summary> v1.0 MVP (Phases 1-6) — SHIPPED 2026-01-25</summary>

- [x] Phase 1: Foundation (2/2 plans) — completed 2026-01-24
- [x] Phase 2: Visualization (2/2 plans) — completed 2026-01-25
- [x] Phase 3: Interactivity (4/4 plans) — completed 2026-01-25
- [x] Phase 4: Command Panel (3/3 plans) — completed 2026-01-25
- [x] Phase 5: Rebranding (3/3 plans) — completed 2026-01-25
- [x] Phase 6: Conversation View (4/4 plans) — completed 2026-01-25

See [v1.0-ROADMAP.md](milestones/v1.0-ROADMAP.md) for full details.

</details>

### v1.1 (Planned)

*No phases defined yet. Run `/gsd:new-milestone` to start planning.*

## Progress

| Phase | Milestone | Plans Complete | Status | Completed |
|-------|-----------|----------------|--------|-----------|
| 1. Foundation | v1.0 | 2/2 | Complete | 2026-01-24 |
| 2. Visualization | v1.0 | 2/2 | Complete | 2026-01-25 |
| 3. Interactivity | v1.0 | 4/4 | Complete | 2026-01-25 |
| 4. Command Panel | v1.0 | 3/3 | Complete | 2026-01-25 |
| 5. Rebranding | v1.0 | 3/3 | Complete | 2026-01-25 |
| 6. Conversation View | v1.0 | 4/4 | Complete | 2026-01-25 |
58 changes: 58 additions & 0 deletions .planning/STATE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# Project State

## Project Reference

See: .planning/PROJECT.md (updated 2026-01-25)

**Core value:** Terminal-centric workflow enhancement — GSD panel augments Claude Code without disrupting terminal-first experience
**Current focus:** Planning next milestone

## Current Position

Phase: Complete (6 of 6)
Plan: Complete (18 of 18)
Status: v1.0 MVP SHIPPED
Last activity: 2026-01-25 — Milestone v1.0 archived

Progress: [===============] 100% (v1.0)

## Performance Metrics

**v1.0 Summary:**
- Total plans completed: 18
- Total execution time: ~2h 37min
- Average duration: ~8 minutes per plan
- Timeline: 2 days (2026-01-24 → 2026-01-25)

## Accumulated Context

### Decisions

Key decisions are logged in PROJECT.md Key Decisions table.
All v1.0 decisions marked with outcomes.

### Pending Todos

None.

### Blockers/Concerns

None.

### Roadmap Evolution

v1.0 shipped with 6 phases:
- Phase 1: Foundation
- Phase 2: Visualization
- Phase 3: Interactivity
- Phase 4: Command Panel
- Phase 5: Rebranding
- Phase 6: Conversation View

## Session Continuity

Last session: 2026-01-25
Stopped at: v1.0 milestone completion
Resume file: None
Status: Ready for next milestone
Next step: `/gsd:new-milestone` to start v1.1 planning
Loading