sedd 0.1.0

package/commands/sedd.implement.md

@@ -0,0 +1,326 @@
+# /sedd.implement - Execute Tasks
+
+## Purpose
+Execute tasks from migrations, with optional migration ID filter.
+
+## Trigger
+- `/sedd.implement` - Execute ALL pending tasks (asks between migrations)
+- `/sedd.implement --all` or `-a` - Execute ALL without stopping (no prompts)
+- `/sedd.implement 001` - Execute only migration 001 tasks
+- `/sedd.implement 002` - Execute migrations up to 002
+
+## Pre-flight Checks
+
+1. **Read sedd.config.json** to get `specsDir` (default: `.sedd`, legacy: `specs`)
+   ```
+   Read sedd.config.json → specsDir = "specs" or ".sedd"
+   ```
+
+2. **Get current branch** from git
+   ```
+   git rev-parse --abbrev-ref HEAD → "023-agent-executor"
+   ```
+
+3. **Find feature directory**
+   ```
+   {specsDir}/{branch}/ → specs/023-agent-executor/
+   ```
+
+4. **Verify migrations exist** in feature directory (run /sedd.clarify first)
+
+5. **Load _meta.json** from feature directory to get migration list
+
+6. **Check for pending tasks** in migration tasks.md files
+
+## Workflow
+
+### Step 1: Determine Scope
+
+Based on argument:
+- No argument → All pending tasks from all migrations
+- `001` → Only tasks from migration 001
+- `002` → Tasks from migrations 001 AND 002
+
+### Step 2: Load Context
+
+Read all relevant files:
+- spec.md (reference)
+- interfaces.ts (for Zod conversion)
+- All relevant migration folders:
+  - `XXX_timestamp/clarify.md`
+  - `XXX_timestamp/tasks.md`
+  - `XXX_timestamp/decisions.md`
+
+### Step 3: Create/Update Progress File
+
+Initialize `progress.md` if not exists:
+
+```markdown
+# Implementation Progress
+
+## Current Status
+- **Active Migration:** 001
+- **Active Task:** T001-001
+- **Overall Progress:** 0/5 (0%)
+
+## Task Log
+
+| Task | Migration | Status | Started | Completed |
+|------|-----------|--------|---------|-----------|
+| T001-001 | 001 | pending | - | - |
+| T001-002 | 001 | pending | - | - |
+```
+
+### Step 4: Convert Interfaces to Zod (First Run)
+
+On first implementation, convert interfaces.ts:
+
+```typescript
+// schemas/entities.ts
+import { z } from 'zod';
+
+export const ThemeSchema = z.enum(['light', 'dark', 'system']);
+
+export const UserPreferencesSchema = z.object({
+  theme: ThemeSchema,
+  // ...
+});
+
+export type UserPreferences = z.infer<typeof UserPreferencesSchema>;
+```
+
+### Step 5: Task Execution Loop
+
+For each task in order:
+
+1. **Mark as in-progress** in progress.md
+   ```
+   | T001-001 | 001 | in-progress | 10:30 | - |
+   ```
+
+2. **Show task context**
+   ```
+   📌 Task T001-001 [Foundation]
+   Create ThemeContext in src/contexts/ThemeContext.tsx
+
+   From Decision D001-001: Theme persisted in user account
+   ```
+
+3. **Execute the task**
+
+4. **Update ALL task files** (CRITICAL - keep them in sync):
+
+   a. **Update tasks.md** in migration folder - change `[ ]` to `[x]`:
+   ```markdown
+   # Before
+   - [ ] T001-001 [Foundation] Create ThemeContext
+
+   # After
+   - [x] T001-001 [Foundation] Create ThemeContext
+   ```
+
+   b. **Update progress.md** - mark completed with timestamp:
+   ```markdown
+   - [x] T001-001 [10:30 → 10:45] Create ThemeContext
+   ```
+
+   c. **Update _meta.json** - increment tasksCompleted:
+   ```json
+   "tasksCompleted": 1
+   ```
+
+5. **Verify sync** - All three files must show same completed count
+
+### Step 6: Migration Boundaries
+
+When completing a migration's tasks:
+
+```
+✅ Migration 001 complete!
+
+All 5 tasks finished:
+- T001-001 ✓
+- T001-002 ✓
+- T001-003 ✓
+- T001-004 ✓
+- T001-005 ✓
+```
+
+### Step 7: Expectation Verification (NEW)
+
+After completing all tasks in a migration, verify against the original expectation:
+
+```markdown
+## Expectation Verification
+
+**Original expectation:**
+> User can toggle dark mode in settings and have it persist across sessions
+
+**Delivered:**
+- Implemented 5 tasks
+- Created ThemeContext for state management
+- Added database persistence
+- Created toggle component in settings
+- API endpoint for saving preference
+
+**Alignment:** ✅ Expectation met
+```
+
+#### When Not Met:
+
+If expectation was not fully met:
+
+```
+⚠️ Expectation may not be fully met
+
+**Original expectation:**
+> User can toggle dark mode in settings and have it persist across sessions
+
+**What may be missing:**
+- [potential gap]
+
+**Options:**
+1. Create new migration to address gaps
+2. Mark as complete anyway (partial delivery)
+
+What would you like to do?
+```
+
+If user chooses option 1, suggest running `/sedd.clarify` for a follow-up migration.
+
+### Step 8: Ask About Commit
+
+```
+Do you want to commit?
+Message: "feat(024): implement migration 001"
+```
+
+### Step 9: Update Changelog
+
+After completing a migration:
+
+```markdown
+## [2026-01-11] - Migration 001 Implemented
+
+- Completed 5 tasks
+- Created ThemeContext
+- Updated database schema
+- Added settings toggle
+```
+
+### Step 10: Continue or Stop
+
+**If `--all` or `-a` flag:**
+- Do NOT ask, continue automatically
+- Only ask about commit at the very end (all migrations done)
+- Show progress summary between migrations:
+  ```
+  ✅ Migration 001 complete (5/5 tasks)
+  → Continuing to migration 002...
+  ```
+
+**If NO flag (default):**
+After each migration:
+
+```
+Migration 001 complete!
+
+Next pending migration: 002 (3 tasks)
+
+Continue with migration 002? [Y/n]
+```
+
+If user specified a migration ID, stop after that migration.
+
+## Task States
+
+```
+pending     → in-progress → completed
+                         → blocked
+```
+
+Only ONE task can be `in-progress` at a time.
+
+## Progress.md Structure
+
+```markdown
+# Implementation Progress
+
+## Summary
+| Migration | Total | Done | Progress |
+|-----------|-------|------|----------|
+| 001 | 5 | 5 | 100% |
+| 002 | 3 | 1 | 33% |
+| **Total** | **8** | **6** | **75%** |
+
+## Current Task
+T002-002 [US2] Add validation
+
+## Task Log
+
+### Migration 001 (Completed)
+- [x] T001-001 [10:30 → 10:45] Create ThemeContext
+- [x] T001-002 [10:45 → 11:00] Update schema
+- [x] T001-003 [11:00 → 11:30] Create toggle
+- [x] T001-004 [11:30 → 11:45] Add to settings
+- [x] T001-005 [11:45 → 12:00] API endpoint
+
+### Migration 002 (In Progress)
+- [x] T002-001 [14:00 → 14:15] Add tests
+- [ ] T002-002 [14:15 → ...] Add validation
+- [ ] T002-003 Pending
+```
+
+## Filtering Examples
+
+```
+/sedd.implement
+```
+Executes: T001-001, T001-002... (asks between migrations)
+
+```
+/sedd.implement --all
+```
+Executes: ALL tasks from ALL migrations without stopping.
+Only asks about commit at the very end.
+
+```
+/sedd.implement -a
+```
+Same as `--all` (shorthand).
+
+```
+/sedd.implement 001
+```
+Executes: T001-001, T001-002, T001-003, T001-004, T001-005
+Stops after migration 001.
+
+```
+/sedd.implement 002
+```
+Executes: All tasks from 001 AND 002
+Stops after migration 002.
+
+## Rules
+
+- **CRITICAL: Update ALL 3 files when completing a task:**
+  1. `{migration}/tasks.md` - change `[ ]` to `[x]`
+  2. `progress.md` - mark task with `[x]` and timestamps
+  3. `_meta.json` - increment tasksCompleted count
+- ONE task in-progress at a time
+- **With `--all` flag:** NO prompts between migrations, commit only at end
+- **Without flag:** Ask about commit after each migration completes
+- Convert interfaces to Zod on first run
+- Update CHANGELOG after each migration
+- Auto-split files > 400 lines
+
+## File Sync Checklist
+
+After completing each task, verify:
+```
+✓ tasks.md      → - [x] T001-001 ...
+✓ progress.md   → - [x] T001-001 [time] ...
+✓ _meta.json    → "tasksCompleted": N
+```
+
+If files are out of sync, fix immediately before continuing.

package/commands/sedd.migrate.md

@@ -0,0 +1,249 @@
+# /sedd.migrate - Migrate Legacy Specs
+
+## Purpose
+Convert existing speckit/legacy structure to new SEDD migrations structure.
+
+## Trigger
+- `/sedd.migrate` - Migrate current feature
+- `/sedd.migrate 023-agent-executor` - Migrate specific feature
+- `/sedd.migrate --all` - Migrate all features
+
+## Legacy Structure → New Structure
+
+```
+OLD:                                  NEW:
+specs/023-feature/                    specs/023-feature/
+├── spec.md                    →      ├── _meta.json
+├── plan.md                    →      ├── CHANGELOG.md
+├── tasks.md                   →      ├── spec.md
+├── research.md                →      ├── interfaces.ts (extracted)
+├── data-model.md              →      ├── progress.md
+├── contracts/                 →      │
+├── ui-specs/                  →      ├── 001_{{timestamp}}/
+└── quickstart.md              →      │   ├── clarify.md (from plan)
+                                      │   ├── tasks.md (moved)
+                                      │   └── decisions.md (extracted)
+                                      │
+                                      └── archive/
+                                          ├── plan.md
+                                          ├── research.md
+                                          ├── data-model.md
+                                          ├── contracts/
+                                          └── quickstart.md
+```
+
+## Workflow
+
+### Step 1: Analyze Feature
+
+Check existing files:
+- spec.md → Keep in root
+- plan.md → Extract decisions, archive
+- tasks.md → Move to migration 001
+- research.md → Archive
+- data-model.md → Archive
+- ui-specs/ → Move to ui-mockups/
+- contracts/ → Archive
+- quickstart.md → Archive
+
+### Step 2: Dry Run (Default)
+
+```
+📦 Migration Plan: 023-agent-executor
+
+Will create:
+  ✓ _meta.json
+  ✓ CHANGELOG.md
+  ✓ interfaces.ts (extracted from spec)
+  ✓ progress.md
+  ✓ 001_2026-01-11_12-00-00/
+  ✓ archive/
+
+Will move:
+  spec.md → (keep in place)
+  tasks.md → 001_.../tasks.md
+  ui-specs/ → ui-mockups/
+
+Will extract:
+  plan.md decisions → 001_.../decisions.md
+  plan.md clarifications → 001_.../clarify.md
+  spec.md entities → interfaces.ts
+
+Will archive:
+  plan.md → archive/plan.md
+  research.md → archive/research.md
+  data-model.md → archive/data-model.md
+  contracts/ → archive/contracts/
+  quickstart.md → archive/quickstart.md
+
+Proceed? [y/N]
+```
+
+### Step 3: Extract Interfaces
+
+Scan spec.md for entities and create interfaces.ts:
+
+```typescript
+/**
+ * Interfaces extracted from spec.md
+ * Migration timestamp: 2026-01-11_12-00-00
+ */
+
+export interface Agent {
+  id: string;
+  name: string;
+  // ... extracted from spec
+}
+
+export interface Tool {
+  id: string;
+  agentId: string;
+  // ... extracted from spec
+}
+```
+
+### Step 4: Create Migration 001
+
+Create first migration from existing files:
+
+```
+001_2026-01-11_12-00-00/
+├── clarify.md      ← Extracted from plan.md
+├── tasks.md        ← Moved from root
+└── decisions.md    ← Extracted from plan.md
+```
+
+### Step 5: Update Task IDs
+
+Rename tasks to new format:
+
+```
+OLD: - [ ] T001 Create component
+NEW: - [ ] T001-001 Create component
+
+OLD: - [ ] T015 Update schema
+NEW: - [ ] T001-015 Update schema
+```
+
+### Step 6: Archive Old Files
+
+Move to archive/:
+```
+archive/
+├── plan.md           # Original plan
+├── research.md       # Research notes
+├── data-model.md     # Data model
+├── contracts/        # API contracts
+└── quickstart.md     # Quickstart guide
+```
+
+### Step 7: Generate _meta.json
+
+```json
+{
+  "featureId": "023",
+  "featureName": "agent-executor",
+  "branch": "023-agent-executor",
+  "createdAt": "2026-01-11T12:00:00Z",
+  "specCreatedAt": "2026-01-11T12:00:00Z",
+  "currentMigration": "001",
+  "migrations": {
+    "001": {
+      "id": "001",
+      "timestamp": "2026-01-11_12-00-00",
+      "folder": "001_2026-01-11_12-00-00",
+      "status": "in-progress",
+      "tasksTotal": 15,
+      "tasksCompleted": 8,
+      "createdAt": "2026-01-11T12:00:00Z"
+    }
+  },
+  "splits": [],
+  "commits": []
+}
+```
+
+### Step 8: Generate CHANGELOG.md
+
+```markdown
+# Changelog - 023: agent-executor
+
+## [2026-01-11] - Migrated to SEDD
+
+- Converted from legacy speckit structure
+- Created migration 001 with 15 tasks
+- 8 tasks already completed
+- Archived legacy files
+```
+
+### Step 9: Generate progress.md
+
+Based on task checkboxes in original tasks.md:
+
+```markdown
+# Implementation Progress
+
+## Summary
+| Migration | Total | Done | Progress |
+|-----------|-------|------|----------|
+| 001 | 15 | 8 | 53% |
+
+## Task Log (Imported)
+
+### Migration 001
+- [x] T001-001 Setup project structure
+- [x] T001-002 Configure dependencies
+- [x] T001-003 Create base types
+...
+- [ ] T001-014 Add error handling
+- [ ] T001-015 Update documentation
+```
+
+### Step 10: Verification
+
+```
+✅ Migration complete: 023-agent-executor
+
+New structure:
+specs/023-agent-executor/
+├── _meta.json
+├── CHANGELOG.md
+├── spec.md
+├── interfaces.ts
+├── progress.md
+├── ui-mockups/
+├── 001_2026-01-11_12-00-00/
+│   ├── clarify.md
+│   ├── tasks.md
+│   └── decisions.md
+└── archive/
+    ├── plan.md
+    ├── research.md
+    └── ...
+
+Run `sedd status` to verify.
+```
+
+## Batch Migration
+
+```
+/sedd.migrate --all
+
+Found 5 features to migrate:
+  - 019-workflow-v2
+  - 020-chat-improvements
+  - 021-streaming-pipeline
+  - 022-google-sheets
+  - 023-agent-executor
+
+Migrate all? [y/N]
+```
+
+## Rules
+
+- NEVER delete files (archive instead)
+- ALWAYS create _meta.json
+- ALWAYS extract interfaces.ts
+- Update task IDs to new format (TXXX-XXX)
+- Preserve task completion status
+- Archive preserves full history