wogiflow 1.0.21 → 1.0.22

package/.claude/commands/wogi-map-check.md

@@ -0,0 +1,35 @@
+Check for drift between app-map and codebase.
+
+Verifies that all components listed in app-map.md still exist at their specified paths.
+
+Output:
+```
+🔍 Checking app-map for drift...
+
+Checking 12 mapped components...
+
+  ✓ Button → components/ui/Button
+  ✓ Input → components/ui/Input
+  ✓ Card → components/ui/Card
+  ✗ OldHeader → components/layout/OldHeader (NOT FOUND)
+  ✓ Avatar → components/ui/Avatar
+  ✗ DeprecatedModal → components/Modal (NOT FOUND)
+  ...
+
+Found 2 orphaned entries:
+  • OldHeader - file not found at components/layout/OldHeader
+  • DeprecatedModal - file not found at components/Modal
+
+Recommendation:
+  Remove these from app-map.md or update paths if moved.
+```
+
+If no drift:
+```
+🔍 Checking app-map for drift...
+
+Checking 12 mapped components...
+  ✓ All 12 components verified
+
+✓ No drift detected. App-map is in sync with codebase.
+```

package/.claude/commands/wogi-map-index.md

@@ -0,0 +1,98 @@
+Show or regenerate the auto-generated component index.
+
+Usage:
+- `/wogi-map-index` - Show current index summary
+- `/wogi-map-index scan` - Rescan and regenerate index
+- `/wogi-map-index full` - Show full index details
+
+## What It Does
+
+Automatically scans configured directories and builds a machine-readable index of:
+- Components (React, Vue, etc.)
+- Pages/Routes
+- Hooks
+- Services
+- Modules
+- Utilities
+
+## Scan Process
+
+1. Read `config.json` → `componentIndex.directories`
+2. Find all relevant files (`.tsx`, `.jsx`, `.ts`, `.js`, `.vue`)
+3. Extract exports and categorize
+4. Save to `.workflow/state/component-index.json`
+
+## Categorization Rules
+
+| Pattern | Category |
+|---------|----------|
+| `src/components/**` | components |
+| `src/pages/**`, `pages/**`, `app/**` | pages |
+| `use*.ts`, `src/hooks/**` | hooks |
+| `*.service.ts`, `src/services/**` | services |
+| `*.module.ts`, `src/modules/**` | modules |
+| `src/utils/**`, `src/lib/**` | utils |
+
+## Output - Summary
+
+```
+📦 Component Index
+
+Last scan: 2024-01-15 10:30:00
+
+| Category   | Count |
+|------------|-------|
+| Components | 45    |
+| Pages      | 12    |
+| Hooks      | 8     |
+| Services   | 6     |
+| Modules    | 4     |
+| Utils      | 15    |
+
+Total: 90 items
+
+Run /wogi-map-index full for details
+Run /wogi-map-index scan to refresh
+```
+
+## Output - Full
+
+```
+📦 Component Index (Full)
+
+## Components (45)
+
+| Name | Path | Exports |
+|------|------|---------|
+| Button | src/components/ui/Button.tsx | Button, ButtonProps |
+| Input | src/components/ui/Input.tsx | Input, InputProps |
+| Modal | src/components/ui/Modal.tsx | Modal |
+...
+
+## Hooks (8)
+
+| Name | Path | Exports |
+|------|------|---------|
+| useAuth | src/hooks/useAuth.ts | useAuth |
+| useDebounce | src/hooks/useDebounce.ts | useDebounce |
+...
+```
+
+## Difference from app-map.md
+
+| `app-map.md` | `component-index.json` |
+|--------------|------------------------|
+| Curated by humans | Auto-generated |
+| Rich descriptions | Just names and paths |
+| "When to use" guidance | No context |
+| Key components only | Everything found |
+| May be outdated | Always current (after scan) |
+
+Use `/wogi-map-sync` to compare them.
+
+## Auto-Scan Triggers
+
+Based on `config.json` → `componentIndex.scanOn`:
+- `sessionStart` - Scan when starting a session
+- `afterTask` - Scan after completing a task
+- `manual` - Only scan when explicitly requested

package/.claude/commands/wogi-map-scan.md

@@ -0,0 +1,38 @@
+Scan codebase for unmapped components.
+
+Usage: `/wogi-map-scan [directory]`
+
+Default directory: `src/components`
+
+Steps:
+1. Find all component files (.tsx, .jsx, .vue)
+2. Compare with entries in app-map.md
+3. Report unmapped components
+
+Output:
+```
+🔍 Scanning: src/components
+
+Found 15 component files
+Mapped in app-map: 12
+
+Unmapped (3):
+  • src/components/ui/Tooltip.tsx
+  • src/components/forms/DatePicker.tsx
+  • src/components/layout/Sidebar.tsx
+
+Add these with /wogi-map-add or:
+  /wogi-map-add Tooltip components/ui/Tooltip
+  /wogi-map-add DatePicker components/forms/DatePicker
+  /wogi-map-add Sidebar components/layout/Sidebar
+```
+
+If all components are mapped:
+```
+🔍 Scanning: src/components
+
+Found 12 component files
+Mapped in app-map: 12
+
+✓ All components are mapped!
+```

package/.claude/commands/wogi-map-sync.md

@@ -0,0 +1,91 @@
+Compare auto-generated index with curated app-map and suggest updates.
+
+Usage: `/wogi-map-sync`
+
+## What It Does
+
+1. Reads `component-index.json` (auto-generated)
+2. Reads `app-map.md` (curated)
+3. Finds discrepancies:
+   - In codebase but NOT in app-map → suggest adding
+   - In app-map but NOT in codebase → may be stale
+4. Offers to update app-map
+
+## Output
+
+```
+🔄 App Map Sync
+
+Comparing component-index.json (scanned: 2024-01-15)
+           with app-map.md (updated: 2024-01-10)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📥 IN CODEBASE, NOT IN APP-MAP (consider adding):
+
+Components:
+  • DatePicker (src/components/ui/DatePicker.tsx)
+  • Tooltip (src/components/ui/Tooltip.tsx)
+  • Card (src/components/ui/Card.tsx)
+
+Hooks:
+  • useDebounce (src/hooks/useDebounce.ts)
+  • useLocalStorage (src/hooks/useLocalStorage.ts)
+
+Services:
+  • PaymentService (src/services/payment.service.ts)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📤 IN APP-MAP, NOT IN CODEBASE (possibly stale):
+
+Components:
+  • OldModal (listed at src/components/Modal.tsx - FILE NOT FOUND)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+✅ IN SYNC (67 items match)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Actions:
+  (a) Add all missing to app-map
+  (s) Select which to add
+  (r) Remove stale entries
+  (n) Do nothing
+```
+
+## Interactive Selection
+
+If user chooses `(s)`:
+
+```
+Select components to add (comma-separated numbers, or 'all'):
+
+  1. DatePicker (src/components/ui/DatePicker.tsx)
+  2. Tooltip (src/components/ui/Tooltip.tsx)
+  3. Card (src/components/ui/Card.tsx)
+  4. useDebounce (src/hooks/useDebounce.ts)
+  5. useLocalStorage (src/hooks/useLocalStorage.ts)
+  6. PaymentService (src/services/payment.service.ts)
+
+> 1, 4, 6
+```
+
+Then prompts for descriptions before adding.
+
+## When to Use
+
+- After pulling new code
+- Before starting a task (ensure map is current)
+- During code review
+- Periodically (weekly?)
+
+## Related Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/wogi-map` | View curated app-map |
+| `/wogi-map-index` | View auto-generated index |
+| `/wogi-map-index scan` | Refresh the index |
+| `/wogi-map-add` | Manually add to app-map |

package/.claude/commands/wogi-map.md

@@ -0,0 +1,33 @@
+Display the component registry (app-map).
+
+Read `.workflow/state/app-map.md` and show:
+
+1. **Screens** - All screens with their routes
+2. **Modals** - All modals with their triggers  
+3. **Components** - All components with variants and paths
+
+Output format:
+```
+🗺️ App Map
+
+Screens (5):
+  • Login → /login
+  • Dashboard → /dashboard
+  • Profile → /profile
+  • Settings → /settings
+  • NotFound → /404
+
+Modals (3):
+  • ConfirmDelete → Delete button click
+  • UserSettings → Settings icon click
+  • ImagePicker → Avatar click
+
+Components (12):
+  • Button (primary, secondary, ghost) → components/ui/Button
+  • Input (text, password, email) → components/ui/Input
+  • Card (default, elevated) → components/ui/Card
+  • Avatar (small, medium, large) → components/ui/Avatar
+  ...
+
+Use /wogi-map-add to add new components.
+```

package/.claude/commands/wogi-morning.md

@@ -0,0 +1,65 @@
+Show a morning briefing with everything needed to start the day.
+
+Run `./scripts/flow morning` to generate the briefing.
+
+This command gathers context from:
+1. `.workflow/state/session-state.json` - Where you left off
+2. `.workflow/state/ready.json` - Pending tasks sorted by priority
+3. `.workflow/state/progress.md` - Key context and blockers
+4. Git log - Changes since last session
+
+Output includes:
+```
+MORNING BRIEFING
+
+Last active: Mon Jan 6, 10:30 AM (14 hours ago)
+
+WHERE YOU LEFT OFF
+  Task: wf-a1b2c3d4 - User Profile Page
+  Status: in_progress
+  Files: src/components/Profile.tsx, src/api/user.ts
+
+KEY CONTEXT
+  - API endpoint for preferences not ready yet
+  - Using shadcn/ui for modal components
+
+BLOCKERS
+  - Waiting on backend team for /preferences endpoint
+
+CHANGES SINCE LAST SESSION
+  - 2 new commits
+  - 1 new bug filed
+
+RECOMMENDED NEXT
+  1. [P0] wf-a1b2c3d4: User Profile Page (in progress)
+  2. [P1] wf-c3d4e5f6: Fix null check in API
+  3. [P2] wf-e5f6g7h8: Add dark mode toggle
+
+SUGGESTED PROMPT
+  Continue implementing wf-a1b2c3d4: User Profile Page.
+
+  Context:
+  - API endpoint not ready yet
+  - Using shadcn/ui for modal
+
+  Files to review:
+  - src/components/Profile.tsx
+```
+
+Options:
+- `--json` - Output JSON for programmatic access
+
+Configuration in `.workflow/config.json`:
+```json
+"morningBriefing": {
+  "enabled": true,
+  "showLastSession": true,
+  "showChanges": true,
+  "showRecommendedTasks": 3,
+  "generatePrompt": true,
+  "showBlockers": true,
+  "showKeyContext": true
+}
+```
+
+Set `enabled: false` to disable this command.

package/.claude/commands/wogi-onboard.md

@@ -0,0 +1,99 @@
+Analyze an existing project and set up workflow with full context.
+
+Usage: `/wogi-onboard`
+
+## When to Use
+
+- Starting to use Wogi Flow on an existing codebase
+- After cloning a project you haven't worked on before
+- When joining a new team/project
+
+## What It Does
+
+### 1. Analyzes Your Project
+- Detects language (TypeScript, Python, Go, etc.)
+- Detects framework (Next.js, NestJS, React, FastAPI, etc.)
+- Detects database (PostgreSQL, MongoDB, etc.)
+- Scans for components, pages, modules, API routes
+- Counts lines of code
+
+### 2. Asks About Your Project
+- Project name and description
+- PRD or documentation (can read files or paste content)
+- Current state (early dev, MVP, production, maintenance)
+- Goals (add features, fix bugs, refactor, etc.)
+- Known issues and tech debt
+- Coding conventions
+
+### 3. Generates Workflow Files
+- `project.md` - Full project specification with tech stack, goals, docs
+- `app-map.md` - Auto-populated component registry
+- `decisions.md` - Coding patterns and conventions
+- Initial tasks from known issues
+
+### 4. Suggests Skills
+Based on detected framework, suggests relevant skills:
+- NestJS → nestjs skill
+- React/Next.js → react skill
+- FastAPI/Django → python skill
+
+## Output
+
+```
+🔍 Wogi Flow - Project Onboarding
+
+━━━ Analyzing Project ━━━
+
+  Language:  TypeScript
+  Framework: NestJS
+  Database:  PostgreSQL (TypeORM)
+
+Scanning for components... ✓ Found 24 components/modules
+Scanning for API routes... ✓ Found 15 API routes/controllers
+
+━━━ Project Interview ━━━
+
+[Interactive questions...]
+
+━━━ Generating Workflow Files ━━━
+
+✓ Created project.md
+✓ Created app-map.md with 24 entries
+✓ Created decisions.md
+✓ Created 5 initial tasks from known issues
+✓ Recommended skill: nestjs
+
+╔═══════════════════════════════════════════════════════════════╗
+║           ✅ Project Onboarding Complete!                     ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+## After Onboarding
+
+The AI now has full context about your project:
+- Tech stack and architecture
+- Existing components and their locations
+- Coding patterns to follow
+- Known issues to fix
+- Project goals
+
+You can:
+- Ask it to analyze specific code
+- Ask for improvement suggestions
+- Create new features that fit the architecture
+- Fix bugs with proper context
+
+## Files Created
+
+| File | Purpose |
+|------|---------|
+| `.workflow/specs/project.md` | Full project specification |
+| `.workflow/state/app-map.md` | Component registry (auto-populated) |
+| `.workflow/state/decisions.md` | Coding patterns |
+| `.workflow/changes/onboarding/tasks.json` | Initial tasks |
+
+## CLI Equivalent
+
+```bash
+./scripts/flow onboard
+```

package/.claude/commands/wogi-plan.md

@@ -0,0 +1,173 @@
+Manage plans - strategic initiatives that coordinate epics and features.
+
+## Overview
+
+Plans (pl-XXXXXXXX) are the highest level in the work hierarchy. They represent strategic initiatives like roadmap items, quarterly goals, or major product launches.
+
+```
+Plan (pl-XXXXXXXX) - Strategic initiative
+├── Epic (ep-XXXXXXXX) - Large initiative
+│   └── Feature (ft-XXXXXXXX) - Coherent capability
+│       └── Story (wf-XXXXXXXX) - Implementation spec
+└── Feature (ft-XXXXXXXX) - Standalone capability (no epic)
+    └── Story (wf-XXXXXXXX) - Implementation spec
+```
+
+## Commands
+
+### Create Plan
+```bash
+node scripts/flow-plan.js create "<title>"
+
+# With goal
+node scripts/flow-plan.js create "<title>" --goal "Ship by Q2"
+```
+
+Example:
+```bash
+node scripts/flow-plan.js create "Q1 2026 Product Roadmap"
+```
+
+### List Plans
+```bash
+node scripts/flow-plan.js list
+
+# JSON output
+node scripts/flow-plan.js list --json
+```
+
+### Show Plan Details
+```bash
+node scripts/flow-plan.js show <planId>
+```
+
+### Add Epic or Feature to Plan
+```bash
+# Add epic
+node scripts/flow-plan.js add <planId> <epicId>
+
+# Add standalone feature
+node scripts/flow-plan.js add <planId> <featureId>
+```
+
+Example:
+```bash
+node scripts/flow-plan.js add pl-a1b2c3d4 ep-e5f6g7h8
+node scripts/flow-plan.js add pl-a1b2c3d4 ft-i9j0k1l2
+```
+
+### Remove Item from Plan
+```bash
+node scripts/flow-plan.js remove <planId> <itemId>
+```
+
+### Check Progress
+```bash
+node scripts/flow-plan.js progress <planId>
+```
+
+### Delete Plan
+```bash
+node scripts/flow-plan.js delete <planId>
+```
+
+## File Structure
+
+Plans are stored as markdown files in `.workflow/plans/`:
+
+```markdown
+# Plan: Q1 2026 Product Roadmap
+
+## Goal
+Ship user authentication and payment features by end of Q1.
+
+## Description
+Strategic initiative to complete core product features.
+
+## Success Criteria
+- [ ] User authentication live in production
+- [ ] Payment integration complete
+- [ ] 95% test coverage
+
+## Items
+
+### Epics
+- ep-auth1234  # Authentication System
+
+### Features
+- ft-payment5  # Payment Processing (standalone)
+
+## Timeline
+| Phase | Description | Target |
+|-------|-------------|--------|
+| Phase 1 | Authentication | Feb 2026 |
+| Phase 2 | Payments | Mar 2026 |
+
+## Status: inProgress
+## Progress: 35%
+```
+
+## Auto-Completion
+
+When all epics and features in a plan are completed:
+1. Plan status automatically changes to `completed`
+2. Progress updates to 100%
+3. Plan file is archived to `.workflow/archive/plans/YYYY-MM/`
+
+## Cascade Completion
+
+Progress flows up through the hierarchy:
+```
+Story completes → Feature completes → Epic completes → Plan completes
+```
+
+Each level auto-completes when all children are done.
+
+## Workflow Example
+
+```bash
+# 1. Create a plan for a strategic initiative
+node scripts/flow-plan.js create "Q1 2026 Product Roadmap"
+# Creates: pl-a1b2c3d4
+
+# 2. Create epics for major workstreams
+node scripts/flow-epics.js create ep-auth --title "Authentication"
+
+# 3. Add epics to plan
+node scripts/flow-plan.js add pl-a1b2c3d4 ep-auth
+
+# 4. Or add standalone features
+node scripts/flow-feature.js create "Quick Win Feature"
+node scripts/flow-plan.js add pl-a1b2c3d4 ft-quick123
+
+# 5. Work proceeds normally via stories
+/wogi-start wf-story-xyz
+
+# 6. Check overall progress
+node scripts/flow-plan.js progress pl-a1b2c3d4
+```
+
+## Use Cases
+
+| Use Case | Plan Contains |
+|----------|---------------|
+| Quarterly Roadmap | Multiple epics across teams |
+| Product Launch | Epics + standalone features |
+| Technical Debt Sprint | Features only |
+| Single Epic Focus | One epic reference |
+
+## Status Icons
+
+| Icon | Status |
+|------|--------|
+| · | Ready (0%) |
+| → | In Progress (1-99%) |
+| ✓ | Completed (100%) |
+
+## Tips
+
+- **Plans are for strategic visibility** - Track high-level progress
+- **Mix epics and features** - Plans can contain both
+- **Keep plans time-bound** - Quarterly or milestone-based
+- **Review progress regularly** - Good for stakeholder updates
+- **Archive completed plans** - They move to archive automatically