mirror of
https://github.com/Fission-AI/OpenSpec.git
synced 2026-09-14 20:16:53 +08:00
Tabish Bidiwale
38 lines
1.4 KiB
Markdown
38 lines
1.4 KiB
Markdown
# Change: Add View Dashboard Command
|
|
|
|
## Why
|
|
|
|
Users need a quick, at-a-glance overview of their OpenSpec project status without running multiple commands. Currently, users must run `openspec list --changes` and `openspec list --specs` separately to understand the project state. A unified dashboard view would improve developer experience and provide immediate insight into project progress.
|
|
|
|
## What Changes
|
|
|
|
### Added `openspec view` Command
|
|
|
|
The new command provides an interactive dashboard displaying:
|
|
- Summary metrics (total specs, requirements, changes, task progress)
|
|
- Active changes with visual progress bars
|
|
- Completed changes
|
|
- Specifications with requirement counts
|
|
|
|
### Specifications Affected
|
|
|
|
- **cli-view** (NEW): Complete specification for the view dashboard command
|
|
|
|
## Implementation Details
|
|
|
|
### File Structure
|
|
- Created `/src/core/view.ts` implementing the `ViewCommand` class
|
|
- Registered command in `/src/cli/index.ts`
|
|
- Reuses existing utilities from `task-progress.ts` and `MarkdownParser`
|
|
|
|
### Visual Design
|
|
- Uses Unicode box drawing characters for borders
|
|
- Color coding: cyan for specs, yellow for active, green for completed
|
|
- Progress bars using filled (█) and empty (░) blocks
|
|
- Clean alignment with proper padding
|
|
|
|
### Technical Approach
|
|
- Async data fetching from changes and specs directories
|
|
- Parallel processing of specs and changes
|
|
- Error handling for missing or invalid data
|
|
- Maintains consistency with existing list command output |