V1.2 fix build #438
Closed
V1.2 fix build #438
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
* docs: complete v1.1 project research
Files:
- STACK.md: gray-matter + @radix-ui/react-toggle-group additions
- FEATURES.md: icon sidebar, command forms, state tree, file viewer
- ARCHITECTURE.md: component integration, build order, data flow
- PITFALLS.md: z-index collisions, XSS, memory leaks, stale closures
- SUMMARY.md: synthesized findings with 5-phase roadmap
Key findings:
- Stack: Only 2 new deps needed, existing libs cover 90%
- Architecture: Extend gsdStore, reuse ui/tabs patterns
- Critical pitfall: Radix portal z-index collision with fixed sidebar
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: define milestone v1.1 requirements
27 requirements across 4 categories:
- Icon Sidebar (5): activity bar with view switching
- Commands Panel (7): 27 commands in 7 groups with smart forms
- State Tree (9): milestone hierarchy with actions and context menu
- Markdown Viewer (6): tabbed file viewer with frontmatter
Research completed for stack, features, architecture, pitfalls.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: create milestone v1.1 roadmap (4 phases)
Phases:
7. Icon Sidebar: VSCode-style activity bar (5 requirements)
8. Markdown Viewer: Tabbed file viewer with frontmatter (6 requirements)
9. State Tree: Milestone/phase/plan hierarchy with actions (9 requirements)
10. Command Forms: Smart forms with parameters and flags (7 requirements)
All 27 v1.1 requirements mapped to phases.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(07): capture phase context
Phase 07: Icon Sidebar
- Implementation decisions documented
- Phase boundary established
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(07): research phase domain
Phase 7: Icon Sidebar
- Standard stack identified: Radix Toggle Group + Tooltip
- Architecture patterns documented: vertical toggle group, tooltip integration
- Pitfalls catalogued: z-index collision, tooltip provider, deselection prevention
- Code examples provided for sidebar component, store extension, panel integration
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(07): create phase plan
Phase 07: Icon Sidebar
- 2 plan(s) in 2 wave(s)
- Wave 1: 07-01 (infrastructure) - parallel
- Wave 2: 07-02 (integration) - sequential
- Ready for execution
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(07-01): add toggle-group dependency and extend gsdStore
- Install @radix-ui/react-toggle-group package
- Add sidebarActiveView state ('commands' | 'state') to GSDState
- Add setSidebarActiveView action to update sidebar view
- Configure sidebarActiveView persistence in Zustand store
- Default sidebarActiveView to 'commands'
* feat(07-01): create GSDIconSidebar component
- Create GSDIconSidebar with Radix Toggle Group
- Add Terminal (Commands) and FolderTree (State) icons
- Implement single-selection toggle behavior with deselection prevention
- Add tooltips with 400ms delay on hover
- Style active state with 2px left primary border
- Style inactive state with 60% opacity
- Add hover background effect
- Integrate with gsdStore for sidebarActiveView state
* docs(08): capture phase context
Phase 08: Markdown Viewer
- Implementation decisions documented
- Phase boundary established
* docs(07-01): complete icon sidebar infrastructure plan
Tasks completed: 2/2
- Task 1: Add toggle-group dependency and extend gsdStore
- Task 2: Create GSDIconSidebar component
SUMMARY: .planning/phases/07-icon-sidebar/07-01-SUMMARY.md
* feat(07-02): create GSDStatePanel placeholder component
- Create GSDStatePanel.tsx with FolderTree icon and placeholder message
- Shows 'State tree coming in Phase 9' message
- Minimal placeholder ready for Phase 9 State Tree implementation
* feat(07-02): integrate sidebar into GSDPanel with view switching
- Import GSDIconSidebar and GSDStatePanel into GSDPanel
- Add sidebarActiveView to useGSDStore destructuring
- Wrap left pane in flex container with sidebar first (left edge per SIDE-01)
- Conditional rendering: commands view shows GSDCommandPanel, state view shows GSDStatePanel
- Sidebar is 48px fixed width, content area is flex-1 with overflow-hidden
* chore(07-02): verify integration and dev server startup
- No barrel export file exists (components import directly)
- npm run check passes (TypeScript valid)
- npm run dev starts successfully at localhost:1420
- Visual verification checklist ready for manual testing:
- 48px icon bar on left edge of left pane
- Terminal and FolderTree icons visible
- Commands icon has 2px cyan left border (default active)
- State icon dimmed at 60% opacity
- Hover shows subtle background and tooltip
- Click switches between Commands and State views
- View selection persists across refresh
* docs(07-02): complete icon sidebar integration plan
Tasks completed: 3/3
- Create GSDStatePanel placeholder component
- Integrate sidebar into GSDPanel with view switching
- Verify integration and dev server startup
SUMMARY: .planning/phases/07-icon-sidebar/07-02-SUMMARY.md
* docs(09): capture phase context
Phase 09: State Tree
- Implementation decisions documented
- Phase boundary established
* docs(07): complete Icon Sidebar phase
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(08): research markdown viewer implementation
Phase 8: Markdown Viewer
- Standard stack identified (react-markdown, gray-matter, existing libs)
- Architecture patterns documented (secure rendering, tab management)
- Pitfalls catalogued (XSS prevention, memory leaks, theme sync)
* docs(08): create phase plan for markdown viewer
Phase 08: Markdown Viewer
- 4 plans in 3 waves
- 2 parallel (08-02, 08-03), 2 sequential
- Ready for execution
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore(08-01): install gray-matter for frontmatter parsing
- Add gray-matter@^4.0.3 dependency
- Required for parsing YAML frontmatter in markdown files
* feat(08-01): extend gsdStore with tab management state and actions
- Add FileTab interface (id, filepath, title, content)
- Add openTabs and activeTabId state (runtime only, not persisted)
- Add openFile action with duplicate filepath detection
- Add closeTab action with adjacent tab selection
- Add setActiveTab and updateTabContent actions
- Duplicate tabs prevented by checking existing filepath
- Closing active tab auto-selects adjacent (prefer right, fallback left)
* docs(08-01): complete tab management foundation plan
Tasks completed: 2/2
- Install gray-matter dependency
- Extend gsdStore with tab management state and actions
SUMMARY: .planning/phases/08-markdown-viewer/08-01-SUMMARY.md
* feat(08-03): create parseMarkdown utility for frontmatter extraction
- Implement parseMarkdownFile to extract YAML frontmatter using gray-matter
- Add frontmatterToYaml for visual display of frontmatter data
- Handle malformed YAML gracefully with error recovery
- Support arrays, objects, multiline strings in frontmatter
* feat(08-02): create scrollable tab bar component
- Add GSDViewerTabs with horizontal scroll support
- Arrow buttons appear when tabs overflow
- Close button on each tab with hover state
- Active tab highlighting
- Max width truncation for long filenames
* feat(08-03): create GSDCodeBlock component with copy functionality
- Implement syntax highlighting using react-syntax-highlighter
- Add theme-aware syntax theme integration via getClaudeSyntaxTheme
- Provide copy button that appears on hover with visual feedback
- Display line numbers by default for better code reference
- Show language badge for fenced code blocks
* feat(08-03): create GSDFrontmatter collapsible component
- Implement collapsible frontmatter section using Radix UI
- Default to collapsed state for cleaner initial view
- Show field count in header for quick reference
- Use YAML syntax highlighting for frontmatter display
- Return null when no frontmatter exists (no empty render)
* feat(08-02): create main file viewer container
- Add GSDFileViewer component with header and content area
- Empty state for when no files are open
- Placeholder FileContent component (to be enhanced in 08-03)
- Integrates GSDViewerTabs for tab management
- Close button to hide viewer panel
* feat(08-03): create GSDMarkdownContent component with GFM support
- Implement full GFM rendering (tables, blockquotes, strikethrough, task lists)
- Use custom GSDCodeBlock component for syntax-highlighted code blocks
- Handle internal .md links via openFile store action
- Open external links in new tab with security attributes
- Support relative path resolution for internal links
- Style tables, blockquotes, and task lists for visual clarity
* feat(08-02): integrate file viewer into GSD panel
- Replace GSDPanelContent with GSDFileViewer in right pane
- Remove unused GSDPanelContent import
- Right pane now shows file viewer with tab support
* docs(08-03): complete markdown rendering components plan
Tasks completed: 4/4
- Create parseMarkdown utility for frontmatter extraction
- Create GSDCodeBlock component with copy button
- Create GSDFrontmatter collapsible component
- Create GSDMarkdownContent component
SUMMARY: .planning/phases/08-markdown-viewer/08-03-SUMMARY.md
* docs(08-02): complete file viewer shell plan
Tasks completed: 3/3
- Create GSDViewerTabs with scrollable tab bar
- Create GSDFileViewer main container
- Integrate into GSDPanel right pane
SUMMARY: .planning/phases/08-markdown-viewer/08-02-SUMMARY.md
* feat(08-04): create GSDFileContent component with file loading
- Load file content via Tauri fs API (readTextFile)
- Parse frontmatter using parseMarkdownFile utility
- Render frontmatter with GSDFrontmatter component
- Render markdown with GSDMarkdownContent component
- Cache content in store via updateTabContent
- Show loading state with spinner during fetch
- Show error state if file read fails
- Use cached content if available in tab
* feat(08-04): integrate GSDFileContent into GSDFileViewer
- Import GSDFileContent component
- Replace placeholder FileContent with GSDFileContent
- Remove FileContentProps interface (now in GSDFileContent)
- Remove placeholder FileContent function
- Active tab now renders with full file loading and parsing
* docs(08-04): complete file loading integration plan
Tasks completed: 3/3
- Task 1: Create GSDFileContent component with file loading
- Task 2: Update GSDFileViewer to use GSDFileContent
- Task 3: Verify full integration and test with dev server
SUMMARY: .planning/phases/08-markdown-viewer/08-04-SUMMARY.md
* docs(08): complete Markdown Viewer phase
- 4/4 plans executed across 3 waves
- Verified 5/5 success criteria
- Phase goal achieved: tabbed file viewer with frontmatter and syntax highlighting
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(09): research phase domain
Phase 09: State Tree
- Standard stack identified (React, Zustand, Tailwind, Framer Motion - all in deps)
- Architecture patterns documented (recursive tree, Set-based expansion, connector lines)
- Pitfalls catalogued (re-renders, connector alignment, animation performance)
- Verified existing implementation as solid foundation for milestone extension
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(09): create phase plan
Phase 09: State Tree
- 3 plans in 3 waves
- Wave 1: Data layer (milestone types, parser, transforms)
- Wave 2: Visual refinement (status dots, file opening)
- Wave 3: Archived section and integration
- Ready for execution
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(09-01): add MilestoneInfo type and parseMilestones function
- Add MilestoneInfo interface with number, name, goal, status, archived, phaseRange
- Add parseMilestones function to parse ROADMAP.md milestone section
- Parse milestone lines like "**v1.0 MVP** - Phases 1-6 (shipped)"
- Extract milestone goals from ### sections
- Handle edge case: create implicit milestone when no milestones section
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(09-01): add buildMilestoneTree transform with filepath support
- Update TreeNode interface: add 'milestone' type, filepath, archived properties
- Add projectPath parameter to buildTreeData for filepath generation
- Add getPhaseDirectoryName helper for consistent directory path construction
- Add calculateMilestoneProgress helper for aggregate milestone progress
- Add buildMilestoneTree function returning separate active/archived trees
- Phase filepath points to phase directory
- Plan filepath points to XX-YY-PLAN.md file
- Archived milestones point to milestones/vX.Y-ROADMAP.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(09-01): update store and hook for milestone data
Store changes:
- Add milestoneData state (MilestoneInfo[])
- Add archivedTreeData state (TreeNode[])
- Add setMilestoneData and setArchivedTreeData actions
- Import MilestoneInfo type from parsers
Hook changes:
- Import parseMilestones and buildMilestoneTree
- Parse milestones from ROADMAP.md content
- Build 3-level tree with buildMilestoneTree
- Set active tree to treeData, archived to archivedTreeData
- Clear all data properly on error/no project
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(09-01): complete milestone data layer plan
Tasks completed: 3/3
- Add MilestoneInfo type and parseMilestones function
- Add buildMilestoneTree transform with filepath
- Update store and hook for milestone data
SUMMARY: .planning/phases/09-state-tree/09-01-SUMMARY.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(09-02): replace status icons with color dots
- Remove CircleCheck, Loader2, Circle icon imports from lucide-react
- Add StatusDot component with colored dot indicators
- Gray (pending), blue with pulse (in-progress), green (complete)
- Per CONTEXT.md: "Color-only status, no icons"
* feat(09-02): separate chevron click from text click
- Chevron click now toggles expand/collapse (via button wrapper)
- Node text click opens file in viewer (via openFile action)
- Add cursor-pointer and hover:underline for clickable labels
- Update keyboard: Enter opens file, Space toggles expand
- Import openFile from gsdStore
* feat(09-02): support milestone nodes in tree
- Add isArchived prop to GSDTreeNode for inherited styling
- Apply archived styling (opacity-60, cursor-default)
- Pass isArchived to children for cascade effect
- Update GSDTreeView to render archived section
- Archived section collapsed by default with chevron toggle
- Shows "Archived (N)" header with dimmed styling
- 3-level hierarchy: milestone -> phase -> plan
* docs(09-02): complete tree node visuals plan
Tasks completed: 3/3
- Replace status icons with color dots
- Separate chevron click from text click
- Support milestone nodes in tree
SUMMARY: .planning/phases/09-state-tree/09-02-SUMMARY.md
* feat(09-03): integrate tree view into state panel
- Replace placeholder with actual GSDTreeView component
- Add loading, error, and empty state handling
- Get projectPath from store instead of props
- Header with border, scrollable content area
- GSDTreeView includes built-in archived section
Note: GSDArchivedSection component skipped (already in GSDTreeView)
* fix(09-03): make sidebar icons smaller and add right border
- Reduce icon size from w-6 h-6 to w-5 h-5
- Add border-r border-border for full height right border
* fix(09-03): remove panel titles from state and command panels
- Remove State Tree header from GSDStatePanel
- Remove Commands header from GSDCommandPanel (keep only toggle button)
- Reduce padding in panels for more compact view
* fix(09-03): remove percent from progress display
- Show only x/total format in tree nodes
- Remove percent calculation and display
* fix(09-03): auto-expand current milestone and phase on load
- Update initializeExpanded to accept milestoneData
- Find and expand current milestone containing current phase
- Always expand current phase
* fix(09-03): reduce horizontal padding in tree nodes
- Reduce gap from gap-2 to gap-1.5
- Reduce padding from px-2 py-1.5 to px-1 py-1
- Reduce indent from ml-6 to ml-4
* fix(09-03): fix file loading by removing invalid directory paths
- Remove filepath for phase nodes (directories can't be read as files)
- Remove filepath for archived milestones (archived roadmaps may not exist)
- Keep filepath only for plans and active milestones
* fix(09-03): hide status dot and progress from archived milestones
- Remove status dot from archived nodes (always complete, redundant)
- Remove x/total progress display from archived nodes (always 0/0)
- Both elements remain visible for active milestones and all phases/plans
* fix(09-03): fix file loading error by using Tauri backend command
- Add read_text_file Rust command for generic file reading
- Replace @tauri-apps/plugin-fs with invoke() call to backend
- Fixes 'Failed to read file' error when clicking tree nodes
- Uses same pattern as useGSDData hook for consistent file access
* docs(09-03): complete archived section integration plan
Tasks completed: 2/2 + checkpoint with feedback iterations
- Integrated tree view into GSDStatePanel
- Multiple UI refinements from checkpoint feedback
- File loading via Tauri backend
SUMMARY: .planning/phases/09-state-tree/09-03-SUMMARY.md
* docs(09): complete State Tree phase
- Phase 9 verified: 7/7 must-haves checked
- TREE-01 through TREE-09 requirements marked complete
- VIEW-01 through VIEW-06 requirements marked complete
- Ready for Phase 10: Command Forms
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(state-tree): replace inline play buttons with action links
Remove inline command launch (play button) from tree nodes and add
clickable action links as children of milestones and phases:
Milestone actions (non-archived):
- "+ add phase..." (always shown)
- "audit milestone..." (if all phases complete)
- "complete milestone..." (if all phases complete)
Phase actions (current phase, not finished):
- "discuss phase..." (if not yet planned)
- "plan phase..." (if no plans or pending plans)
- "execute phase..." (if has incomplete plans)
Action links open command dialog with pre-filled parameters.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix viewer markdown
* feat(tree): add multi-file opening for milestone/phase/plan clicks
- Add openFiles() action to gsdStore for batch tab opening
- Add contextFiles property to TreeNode for multi-file click behavior
- Milestone click: ROADMAP.md + STATE.md + REQUIREMENTS.md
- Phase click: CONTEXT.md + RESEARCH.md + VERIFICATION.md (if exist)
- Plan click: PLAN.md + SUMMARY.md (if complete)
- All node types now clickable with hover underline styling
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(tree): filter non-existent files and reset tabs on node click
- Add filter_existing_files Tauri command to check file existence
- Update openFiles to accept clearExisting param for tab reset
- Add closeAllTabs action to store
- Tree node clicks now filter to existing files before opening
- Clicking any node clears existing tabs and opens relevant context
Fixes error when clicking phases without CONTEXT.md files
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(tree): show empty state when no context files exist
Clear all tabs when clicking a node with no existing files,
showing the "No files open" empty state in the viewer.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(viewer): show context in viewer title
- Add viewerContext state to track what's being viewed
- Set context from node label when clicking tree nodes
- Display "Viewer: Phase 9" instead of just "Viewer"
- Clear context when closing all tabs
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(10): capture phase context
Phase 10: Command Forms
- Implementation decisions documented
- Phase boundary established
* docs(10): research phase domain
Phase 10: Command Forms
- Standard stack identified (React Hook Form + Zod + Radix)
- Architecture patterns documented
- Pitfalls catalogued
- All dependencies already installed
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(10): create phase 10 command forms plans
Phase 10: Command Forms
- 5 plans in 3 waves
- Wave 1: command registry expansion (27 commands, 7 categories)
- Wave 2: smart forms with validation, flag toggles
- Wave 3: state prepopulation, command execution
- All dependencies already installed (RHF, Zod, Radix)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(10): revise plans based on checker feedback
- 10-01: Add src/stores/gsdStore.ts to files_modified (task_completeness)
- 10-03: Move to Wave 3 with depends_on: ["10-01", "10-02"] to avoid
parallel execution conflict on GSDCommandDialog.tsx (dependency_correctness)
- 10-03: Add explicit schema verification for boolean flag fields and
key_link to validate schema connection (key_links_planned)
- 10-04, 10-05: Move to Wave 4 (depend on 10-03 which is now Wave 3)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(10-01): expand command registry to 27 commands in 7 categories
- Add CommandFlag interface for boolean command options
- Add CommandCategory type with 7 categories
- Update GSDCommandDefinition to include flags field
- Add 16 new commands to reach 27 total:
- project-setup: new-project, map-codebase, resume-project
- phase-lifecycle: discuss-phase, research-phase, plan-phase, execute-phase, verify-phase
- roadmap-ops: add-phase, insert-phase, reorder-phases
- milestone-ops: new-milestone, audit-milestone, complete-milestone
- quick-work: quick-task, quick-fix, pause-work, resume-work
- navigation: progress, help, check-todos, status, watch
- configuration: settings, set-profile, configure
- Update getCommandsByCategory to return all 7 category keys
* feat(10-01): update panel to render all 7 command categories
- Update GSDCommandPanel to render 7 categories in workflow order
- Add category icons for all 7 categories in GSDCommandCategory
- Update gsdStore initializeCategories to expand all 7 by default
- Update toggleCommandPanel to initialize all categories expanded
* docs(10-01): complete command registry expansion plan
Tasks completed: 2/2
- Task 1: Expand command-registry.ts with all 27 commands in 7 categories
- Task 2: Update GSDCommandPanel to render all 7 categories
SUMMARY: .planning/phases/10-command-forms/10-01-SUMMARY.md
* docs(11): capture phase context
Phase 11: npx Installation
- Implementation decisions documented
- Phase boundary established
* feat(10-02): add Zod schemas for command validation
- Create commandSchemas map for all parameterized commands
- Export getSchemaForCommand function for dynamic schema lookup
- Define schemas: planPhase, executePhase, addPhase, insertPhase, etc.
- Export TypeScript types for form data inference
* feat(10-02): refactor dialog to use React Hook Form + Zod
- Replace useState-based form with useForm + zodResolver
- Dynamic schema selection based on selectedCommand.id
- Validate on blur for better UX (mode: 'onBlur')
- Required fields marked with red asterisk
- Validation errors show red border and message below input
- Remove advancedFlags text input (flags via Plan 03)
- Add disabled state during form submission
* docs(10-02): complete smart forms plan
Tasks completed: 2/2
- Create Zod schemas for command validation
- Refactor GSDCommandDialog to use React Hook Form + Zod
SUMMARY: .planning/phases/10-command-forms/10-02-SUMMARY.md
* feat(10-03): add flag toggle switches to command dialog
- Import Controller from react-hook-form and Switch component
- Add control to useForm destructuring
- Add flag toggle switches section with Options label
- Each flag shows label and description with Switch control
- Flags integrated with form state via Controller pattern
* style(10-03): add focus-visible styles to Switch component
- Add focus-visible ring styles for keyboard accessibility
- Ring uses ring color with background offset
- Ensures visible focus indicator when tabbing to switch
* docs(10-03): complete flag toggle switches plan
Tasks completed: 2/2
- Add flag toggle switches to command dialog
- Ensure Switch component works with Controller
SUMMARY: .planning/phases/10-command-forms/10-03-SUMMARY.md
* feat(10-04): add state reader for form prepopulation
- Create src/lib/gsd/state-reader.ts utility
- Export readCurrentPhase function to parse STATE.md
- Returns null gracefully if STATE.md missing
- Uses fresh read (not cached) per CONTEXT.md decision
* feat(10-05): create command executor utility
- Add buildCommandString to compose command from form values
- Add executeGSDCommand to execute via existing API
- Returns CommandExecutionResult with success/error state
- Uses /clear prefix for clean terminal state
* feat(10-04): prepopulate phase field from STATE.md
- Import readCurrentPhase from state-reader utility
- Make useEffect async for STATE.md read on dialog open
- Phase field auto-fills with current phase number
- Prepopulated value is editable by user
- Graceful fallback if STATE.md missing (field empty)
- Fresh read on each dialog open (not cached)
* docs(10-04): complete state prepopulation plan
Tasks completed: 2/2
- Create state reader utility for fresh STATE.md reads
- Prepopulate phase field in GSDCommandDialog
SUMMARY: .planning/phases/10-command-forms/10-04-SUMMARY.md
* docs(10-05): complete command execution plan
Tasks completed: 2/2
- Task 1: Create command executor utility
- Task 2: Wire form submission with toast feedback
SUMMARY: .planning/phases/10-command-forms/10-05-SUMMARY.md
* docs(10): complete Command Forms phase
- All 5 plans executed (registry, forms, flags, prepopulation, execution)
- Phase goal verified: 6/6 success criteria met
- All CMD-01 through CMD-07 requirements marked complete
- 26 commands in 7 categories with smart forms
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(11): research phase domain
Phase 11: npx Installation
- Standard stack identified (optionalDependencies + postinstall fallback)
- Architecture patterns documented (hybrid approach, platform detection, checksum verification)
- Pitfalls catalogued (npm v10.3.0+ lockfile pruning, supply chain security, WSL detection)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(11): create phase plan
Phase 11: npx Installation
- 5 plan(s) in 4 wave(s)
- 2 parallel (Wave 1), 3 sequential
- Ready for execution
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(11): revise plans based on checker feedback
- 11-01: Clarify build script is for local validation only (CI uses cargo directly)
- 11-02: Change from postinstall to lazy download per CONTEXT.md decision
- 11-02: Add dependency versions (ora ^8.1.1, supports-color ^9.4.0)
- 11-02: Move download logic to lib/download.js, wrapper scripts trigger on first run
- ROADMAP: Update package name from 'opcode' to 'get-shit-done-cc-ui'
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(11-02): create npm package structure and manifest
- npm/package.json with bin entry pointing to wrapper script
- Dependencies: ora for spinner, supports-color for output
- NO postinstall script (lazy download per CONTEXT.md)
- npm/README.md with first-run download note and usage instructions
- Package name: get-shit-done-cc-ui matching GitHub repo
* feat(11-02): create download library with checksum verification
- Platform detection with WSL support (checks /proc/version for Microsoft/WSL)
- GSD_UI_PLATFORM environment variable for manual override
- Download with progress spinner using ora package
- SHA256 checksum verification with crypto.timingSafeEqual
- Helpful error messages for unsupported platforms
- NO_COLOR environment variable support
- Binary written to npm/bin/gsd-ui-web (or .exe on Windows)
- chmod 755 on Unix platforms for executable permissions
- Install dependencies: ora and supports-color
* feat(11-02): create wrapper scripts with lazy download
- Unix wrapper (npm/bin/get-shit-done-cc-ui) with executable permissions
- Windows wrapper (npm/bin/get-shit-done-cc-ui.cmd)
- First run: checks for binary, downloads if missing, exits with success message
- Second run: binary exists, exec it with all arguments
- Download exit code propagation for error handling
- Lazy download per CONTEXT.md (not postinstall hook)
* docs(11-02): complete npm package structure plan
Tasks completed: 3/3
- Task 1: Create npm package structure and manifest
- Task 2: Create download library
- Task 3: Create wrapper scripts with lazy download
SUMMARY: .planning/phases/11-npx-installation/11-02-SUMMARY.md
* feat(11-01): add local build script for gsd-ui-web binary
- Create build-web-binary.sh for local validation
- Support current platform and cross-platform targets
- Display binary size and location after build
- Include header comment clarifying local-only use (CI uses actions-rust-cross)
- Release profile uses opt-level=z, lto=true, strip=symbols
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(11-01): complete web binary build validation plan
Tasks completed: 2/2
- Task 1: Create build script for web binary
- Task 2: Verify binary runs standalone
SUMMARY: .planning/phases/11-npx-installation/11-01-SUMMARY.md
* wip: npx-installation paused at plan 03/05 (disk space)
* feat(11-03): create web binary build workflow
- GitHub Actions matrix builds gsd-ui-web for all P0 platforms
- Uses houseabsolute/actions-rust-cross@v1 for cross-compilation
- Generates SHA256 checksum files for each binary
- Supports workflow_call for release integration
* feat(11-03): integrate web binaries into release workflow
- Add build-web-binaries job call to release workflow
- Include build-web-binaries in create-release needs array
- Copy web binary artifacts to release assets for all P0 platforms
* docs(11-03): complete GitHub Actions cross-platform build workflow plan
Tasks completed: 2/2
- Create web binary build workflow
- Update release workflow to include web binaries
SUMMARY: .planning/phases/11-npx-installation/11-03-SUMMARY.md
* feat(11-04): add npm publish workflow
- Uses Node 20 LTS with registry-url for npm authentication
- NPM_TOKEN secret provides publishing credentials
- Supports workflow_call (from release.yml) and workflow_dispatch
- Runs from npm/ subdirectory where package.json lives
* feat(11-04): wire npm publishing into release pipeline
- Add publish-npm job with needs: [create-release]
- Ensures binaries are on GitHub Releases before npm publish
- Sequence: builds -> create-release -> publish-npm
- postinstall can download binaries immediately after npm install
* docs(11-04): document NPM_TOKEN setup and release process
- Add Release Process section for maintainers
- Document NPM_TOKEN creation on npmjs.com
- Document GitHub secret configuration
- Document release workflow: bump-version -> commit -> tag -> push
* docs(11-04): complete npm publish workflow plan
Tasks completed: 3/3
- Create npm publish workflow
- Wire npm publishing into release pipeline
- Document NPM_TOKEN secret requirement
SUMMARY: .planning/phases/11-npx-installation/11-04-SUMMARY.md
* feat(11-05): add npm/package.json to version sync script
- Include npm/package.json in bump-version.sh
- Add conditional check for npm/package.json existence
- Update output message to list all 5 synchronized files
- Verified: updates npm/package.json alongside other manifests
* docs(11-05): add npx installation instructions to README
- Add "Quick Start with npx" section as primary install method
- Document supported platforms (linux-x64, darwin-x64, darwin-arm64, win32-x64)
- Mention first-run binary download (~15MB)
- Add Node.js 16+ prerequisite for npx
- Keep existing "Build from Source" as alternative
* docs(11-05): complete version sync and documentation plan
Tasks completed: 3/3
- Update version sync script (npm/package.json)
- Update main README with npx instructions
- Final verification checklist
SUMMARY: .planning/phases/11-npx-installation/11-05-SUMMARY.md
* fix(11): correct Windows binary naming in download.js
* docs(11): complete npx-installation phase
- All 5 plans executed: build validation, npm structure, CI/CD, publishing, docs
- Windows binary naming fixed (8f8304e)
- NPM_TOKEN configured in GitHub secrets
- v1.1 milestone complete
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: bump version to v0.2.2
* fix(11): add working-directory for Cargo.toml in src-tauri
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.