dino-spec 0.3.1 → 0.3.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 keenu
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 keenu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,275 +1,298 @@
-# dino-spec
-
-> Spec-driven development workflow for Claude Code with dinosaur-themed phases
-
-```
-       __
-      (_ \
-  .-^^^  /
- /       /
-<__|-|__|
-```
-
-**dino-spec** is a CLI tool that brings structured, specification-driven development to [Claude Code](https://claude.ai/code). It guides you through a dinosaur-themed workflow: from discovering requirements to hunting down implementation tasks.
-
-## Why dino-spec?
-
-When working with AI coding assistants, projects often suffer from:
-
-- **Context loss** - AI forgets what you're building mid-conversation
-- **Scope creep** - Features expand without clear boundaries
-- **Unstructured iteration** - No clear progression from idea to implementation
-- **Lost specifications** - Requirements scattered across conversations
-
-**dino-spec** solves these problems by:
-
-- Persisting specifications in `.dino/` files that survive context resets
-- Enforcing a structured workflow with clear phase transitions
-- Breaking work into small, trackable tasks (max 8-10 per phase)
-- Integrating directly with Claude Code via slash commands
-
-## Who is this for?
-
-- **Developers using Claude Code** who want structured AI-assisted development
-- **Teams** who need reproducible specification workflows
-- **Solo developers** building complex features incrementally
-- **Anyone** tired of re-explaining context to AI assistants
-
-## Installation
-
-### From npm (recommended)
-
-```bash
-npm install -g dino-spec
-```
-
-### From GitHub
-
-```bash
-git clone https://github.com/xullul/dino-spec.git
-cd dino-spec
-pnpm install
-pnpm build
-npm link
-```
-
-## Quick Start
-
-```bash
-# Initialize in your project
-cd your-project
-dino init
-
-# Open Claude Code and run:
-# /dino.discover add user authentication
-```
-
-## The Dinosaur Workflow
-
-Each phase builds on the previous, ensuring nothing is lost:
-
-```
-discover → scout → clarify → nest → hatch → hunt → fossil
-```
-
-| Phase | Command | Purpose |
-|-------|---------|---------|
-| **Discover** | `/dino.discover` | Capture requirements and create specification |
-| **Scout** | `/dino.scout` | Research codebase and technical options |
-| **Clarify** | `/dino.clarify` | Resolve ambiguities with targeted questions |
-| **Nest** | `/dino.nest` | Create implementation plan (Plan Mode) |
-| **Hatch** | `/dino.hatch` | Break plan into phased tasks |
-| **Hunt** | `/dino.hunt` | Implement tasks with progress tracking |
-| **Fossil** | `/dino.fossil` | Archive completed specification |
-
-Optional: `/dino.next` suggests follow-up features based on completed work.
-
-## CLI Commands
-
-These commands work **without AI** - saving tokens and providing instant feedback:
-
-```bash
-dino init              # Initialize dino-spec in your project
-dino status [spec]     # Show current spec progress
-dino list              # List all specifications
-dino view              # Interactive dashboard
-dino active [spec]     # Show or set active specification
-dino archive <spec>    # Archive completed specification
-dino update            # Update configuration files
-
-# Skill management
-dino skill list        # List installed skills
-dino skill create      # Create custom skill
-dino skill install     # Install from registry
-dino skill remove      # Remove a skill
-
-# API Provider management
-dino provider list     # List configured providers
-dino provider add      # Add a new provider (Z.AI, etc.)
-dino provider remove   # Remove a provider
-dino provider show     # Show provider details
-dino provider setup    # Install shell functions
-dino provider -h       # Show provider help
-```
-
-## Project Structure
-
-After `dino init`, your project will have:
-
-```
-your-project/
-├── .claude/
-│   ├── commands/              # Slash commands for Claude Code
-│   │   ├── dino.discover.md
-│   │   ├── dino.scout.md
-│   │   ├── dino.clarify.md
-│   │   ├── dino.nest.md
-│   │   ├── dino.hatch.md
-│   │   ├── dino.hunt.md
-│   │   ├── dino.fossil.md
-│   │   └── ...
-│   ├── skills/dino-workflow/
-│   │   └── SKILL.md           # Workflow skill definition
-│   └── rules/dino/
-│       └── workflow.md        # Workflow rules
-└── .dino/
-    ├── active.json            # Current active specification
-    ├── dna.md                 # Project conventions
-    ├── specs/                 # Active specifications
-    └── archive/               # Completed specifications
-```
-
-## Specification Files
-
-Each specification contains:
-
-```
-.dino/specs/{spec-id}/
-├── spec.md      # Requirements and success criteria
-├── research.md  # Technical research from scout phase
-├── plan.md      # Implementation plan from nest phase
-└── tasks.md     # Phased task checklist from hatch phase
-```
-
-## Key Features
-
-### Context Preservation
-All state is stored in files. When context resets, Claude Code reads `.dino/active.json` and resumes from where you left off.
-
-### Plan Mode Integration
-Complex phases (`/dino.nest`, `/dino.hatch`) automatically trigger Claude Code's Plan Mode for careful deliberation.
-
-### Task Tracking
-Tasks use a simple checkbox format with progress bars:
-
-```markdown
-- [ ] T001 Implement user model
-- [ ] T002 [P] Add validation (parallelizable)
-- [x] T003 Create database schema (completed)
-```
-
-### Skill System
-Extend functionality with custom skills:
-
-```bash
-dino skill create my-linter
-# Edit .claude/skills/my-linter/SKILL.md
-```
-
-### API Provider Management
-
-Use alternative API providers (like Z.AI) with Claude Code without affecting your default Anthropic subscription:
-
-```bash
-# Add Z.AI provider
-dino provider add zai --url https://api.z.ai/api/anthropic --key YOUR_API_KEY
-
-# Install shell functions for quick switching
-dino provider setup
-
-# Reload PowerShell profile
-. $PROFILE
-```
-
-After setup, use these commands in any terminal:
-
-| Command | Description |
-|---------|-------------|
-| `claude-zai` | Launch Claude Code with Z.AI |
-| `claude-anthropic` | Reset to default Anthropic |
-
-Provider configurations are stored in `~/.dino/providers.json` for cross-computer portability.
-
-## Example Workflow
-
-```bash
-# 1. Initialize
-dino init
-
-# 2. In Claude Code, start a specification
-/dino.discover add dark mode toggle to settings
-
-# 3. Claude creates spec.md with requirements
-
-# 4. Research the codebase
-/dino.scout
-
-# 5. Clarify any ambiguities
-/dino.clarify
-
-# 6. Create implementation plan (enters Plan Mode)
-/dino.nest
-
-# 7. Break into tasks
-/dino.hatch
-
-# 8. Implement with progress tracking
-/dino.hunt
-
-# 9. Archive when complete
-/dino.fossil
-
-# Check progress anytime
-dino status
-dino view
-```
-
-## Configuration
-
-### Project DNA
-
-Edit `.dino/dna.md` to define project conventions:
-
-```markdown
-# Project DNA
-
-## Tech Stack
-- Framework: React
-- Language: TypeScript
-- Testing: Vitest
-
-## Conventions
-- Use functional components
-- Prefer composition over inheritance
-```
-
-## Requirements
-
-- Node.js >= 20.0.0
-- Claude Code CLI
-
-## Contributing
-
-Contributions welcome! Please read the contribution guidelines before submitting PRs.
-
-## License
-
-MIT
-
-## Acknowledgments
-
-Inspired by [spec-kit](https://github.com/spec-kit/spec-kit) and [OpenSpec](https://github.com/openspec/openspec) - combining structured workflows with token-efficient CLI tools.
-
----
-
-Built for developers who believe AI coding should be structured, reproducible, and context-aware.
+# dino-spec
+
+> Spec-driven development workflow for Claude Code with dinosaur-themed phases
+
+```
+       __
+      (_ \
+  .-^^^  /
+ /       /
+<__|-|__|
+```
+
+**dino-spec** is a CLI tool that brings structured, specification-driven development to [Claude Code](https://claude.ai/code). It guides you through a dinosaur-themed workflow: from discovering requirements to hunting down implementation tasks.
+
+## Why dino-spec?
+
+When working with AI coding assistants, projects often suffer from:
+
+- **Context loss** - AI forgets what you're building mid-conversation
+- **Scope creep** - Features expand without clear boundaries
+- **Unstructured iteration** - No clear progression from idea to implementation
+- **Lost specifications** - Requirements scattered across conversations
+
+**dino-spec** solves these problems by:
+
+- Persisting specifications in `.dino/` files that survive context resets
+- Enforcing a structured workflow with clear phase transitions
+- Breaking work into small, trackable tasks (max 8-10 per phase)
+- Integrating directly with Claude Code via slash commands
+
+## Who is this for?
+
+- **Developers using Claude Code** who want structured AI-assisted development
+- **Teams** who need reproducible specification workflows
+- **Solo developers** building complex features incrementally
+- **Anyone** tired of re-explaining context to AI assistants
+
+## Installation
+
+### From npm (recommended)
+
+```bash
+npm install -g dino-spec
+```
+
+### From GitHub
+
+```bash
+git clone https://github.com/xullul/dino-spec.git
+cd dino-spec
+pnpm install
+pnpm build
+npm link
+```
+
+## Quick Start
+
+```bash
+# Initialize in your project
+cd your-project
+dino init
+
+# Open Claude Code and run:
+# /dino.discover add user authentication
+```
+
+## The Dinosaur Workflow
+
+Each phase builds on the previous, ensuring nothing is lost:
+
+```
+discover → scout → sniff → nest → hatch → hunt → aging → fossil → [extinct]
+```
+
+| Phase        | Command          | Purpose                                        |
+| ------------ | ---------------- | ---------------------------------------------- |
+| **Discover** | `/dino.discover` | Capture requirements and create specification  |
+| **Scout**    | `/dino.scout`    | Research codebase and technical options        |
+| **Sniff**    | `/dino.sniff`    | Sniff out ambiguities with targeted questions  | (optional) |
+| **Nest**     | `/dino.nest`     | Create implementation plan (Plan Mode)         |
+| **Hatch**    | `/dino.hatch`    | Break plan into tasks with requirement mapping |
+| **Hunt**     | `/dino.hunt`     | Implement tasks with progress tracking         |
+| **Aging**    | `/dino.aging`    | Create and run tests to verify business logic  | (optional) |
+| **Fossil**   | `/dino.fossil`   | Archive completed specification                |
+| **Extinct**  | `/dino.extinct`  | Permanently remove archive, keep museum record | (optional) |
+
+Optional: `/dino.next` suggests follow-up features based on completed work.
+
+## CLI Commands
+
+These commands work **without AI** - saving tokens and providing instant feedback:
+
+```bash
+dino init              # Initialize dino-spec in your project
+dino status [spec]     # Show current spec progress
+dino list              # List all specifications
+dino view              # Interactive dashboard
+dino active [spec]     # Show or set active specification
+dino archive <spec>    # Archive completed specification
+dino museum [spec]     # View museum records (extinct specs summary)
+dino update            # Update configuration files
+
+# Skill management
+dino skill list        # List installed skills
+dino skill create      # Create custom skill
+dino skill install     # Install from registry
+dino skill remove      # Remove a skill
+
+# API Provider management
+dino provider list     # List configured providers
+dino provider add      # Add a new provider (Z.AI, etc.)
+dino provider remove   # Remove a provider
+dino provider show     # Show provider details
+dino provider setup    # Install shell functions
+dino provider -h       # Show provider help
+```
+
+## Project Structure
+
+After `dino init`, your project will have:
+
+```
+your-project/
+├── .claude/
+│   ├── commands/              # Slash commands for Claude Code (12 total)
+│   │   ├── dino.discover.md
+│   │   ├── dino.scout.md
+│   │   ├── dino.sniff.md
+│   │   ├── dino.nest.md
+│   │   ├── dino.hatch.md
+│   │   ├── dino.hunt.md
+│   │   ├── dino.aging.md
+│   │   ├── dino.fossil.md
+│   │   ├── dino.extinct.md
+│   │   └── ...
+│   ├── skills/dino-workflow/
+│   │   └── SKILL.md           # Workflow skill definition
+│   └── rules/dino/
+│       └── workflow.md        # Workflow rules
+└── .dino/
+    ├── active.json            # Current active specification
+    ├── dna.md                 # Project conventions
+    ├── specs/                 # Active specifications
+    ├── archive/               # Completed specifications
+    └── museum/                # Minimal records of extinct specs
+```
+
+## Specification Files
+
+Each specification contains:
+
+```
+.dino/specs/{spec-id}/
+├── spec.md      # Requirements and success criteria
+├── research.md  # Technical research from scout phase
+├── plan.md      # Implementation plan from nest phase
+├── tasks.md     # Phased task checklist with requirement mapping
+└── tests.md     # Test cases with business logic verification (aging phase)
+```
+
+## Key Features
+
+### Context Preservation
+All state is stored in files. When context resets, Claude Code reads `.dino/active.json` and resumes from where you left off.
+
+### Plan Mode Integration
+Complex phases (`/dino.nest`, `/dino.hatch`) automatically trigger Claude Code's Plan Mode for careful deliberation.
+
+### Task Tracking
+Tasks use a simple checkbox format with requirement mapping and progress bars:
+
+```markdown
+- [ ] T001 Implement user model | REQ-1
+- [ ] T002 [P] Add validation (parallelizable) | REQ-1, REQ-2
+- [x] T003 Create database schema (completed) | REQ-3
+```
+
+The `| REQ-N` suffix maps tasks to requirements, ensuring every requirement is covered.
+
+### Skill System
+Extend functionality with custom skills:
+
+```bash
+dino skill create my-linter
+# Edit .claude/skills/my-linter/SKILL.md
+```
+
+### API Provider Management
+
+Use alternative API providers (like Z.AI) with Claude Code without affecting your default Anthropic subscription:
+
+```bash
+# Add Z.AI provider (with optional model mapping for GLM models)
+dino provider add zai \
+  --url https://api.z.ai/api/anthropic \
+  --key YOUR_API_KEY \
+  --sonnet GLM-4.7 \
+  --haiku GLM-4.5-Air \
+  --opus GLM-4.7
+
+# Install shell functions for quick switching
+dino provider setup
+
+# Reload PowerShell profile
+. $PROFILE
+```
+
+> **Important:** Use `https://api.z.ai/api/anthropic` (Anthropic-compatible endpoint), NOT `https://api.z.ai/api/coding/paas/v4/` (direct GLM endpoint). Claude Code requires the Anthropic-compatible API format.
+
+After setup, use these commands in any terminal:
+
+| Command | Description |
+|---------|-------------|
+| `claude-zai` | Launch Claude Code with Z.AI |
+| `claude-anthropic` | Reset to default Anthropic |
+
+Provider configurations are stored in `~/.dino/providers.json` for cross-computer portability.
+
+## Example Workflow
+
+```bash
+# 1. Initialize
+dino init
+
+# 2. In Claude Code, start a specification
+/dino.discover add dark mode toggle to settings
+
+# 3. Claude creates spec.md with requirements
+
+# 4. Research the codebase
+/dino.scout
+
+# 5. Sniff out any ambiguities
+/dino.sniff
+
+# 6. Create implementation plan (enters Plan Mode)
+/dino.nest
+
+# 7. Break into tasks with requirement mapping
+/dino.hatch
+
+# 8. Implement with progress tracking
+/dino.hunt
+
+# 9. Verify with tests
+/dino.aging
+
+# 10. Archive when complete
+/dino.fossil
+
+# 11. (Optional) Clean up archive, keep museum record
+/dino.extinct
+
+# Check progress anytime
+dino status
+dino view
+dino museum   # View extinct specs history
+```
+
+## Configuration
+
+### Project DNA
+
+Edit `.dino/dna.md` to define project conventions:
+
+```markdown
+# Project DNA
+
+## Tech Stack
+- Framework: React
+- Language: TypeScript
+- Testing: Vitest
+
+## Conventions
+- Use functional components
+- Prefer composition over inheritance
+```
+
+## Requirements
+
+- Node.js >= 20.0.0
+- Claude Code CLI
+
+## Contributing
+
+Contributions welcome! Please read the contribution guidelines before submitting PRs.
+
+## License
+
+MIT
+
+## Acknowledgments
+
+Inspired by [spec-kit](https://github.com/spec-kit/spec-kit) and [OpenSpec](https://github.com/openspec/openspec) - combining structured workflows with token-efficient CLI tools.
+
+---
+
+Built for developers who believe AI coding should be structured, reproducible, and context-aware.

package/bin/dino.js

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
-
-import '../dist/cli/index.js';
+#!/usr/bin/env node
+
+import '../dist/cli/index.js';

package/dist/cli/index.js

@@ -11,6 +11,7 @@ import { archiveCommand } from '../commands/archive.js';
 import { updateCommand } from '../commands/update.js';
 import { activeCommand } from '../commands/active.js';
 import { skillListCommand, skillInstallCommand, skillRemoveCommand, skillCreateCommand } from '../commands/skill.js';
+import { museumCommand } from '../commands/museum.js';
 import { providerListCommand, providerAddCommand, providerRemoveCommand, providerShowCommand, providerDefaultCommand, providerSetupCommand, providerEnvCommand, } from '../commands/provider.js';
 const program = new Command();
 program
@@ -111,6 +112,14 @@ program
     .action(async (specName) => {
     await activeCommand(specName);
 });
+// Museum command
+program
+    .command('museum [spec]')
+    .description('View museum records (compact summaries of extinct specs)')
+    .option('--json', 'Output as JSON')
+    .action(async (specName, options) => {
+    await museumCommand(specName, options);
+});
 // Provider subcommand
 const providerCmd = program
     .command('provider')