sedd 0.1.0

package/commands/sedd.specify.md

@@ -0,0 +1,198 @@
+# /sedd.specify - Create Feature Specification
+
+## Purpose
+Create a new feature with base specification (spec.md + interfaces.ts).
+
+## Trigger
+User runs `/sedd.specify "feature description"` or `/sedd.specify` (interactive)
+
+## Pre-flight Checks
+
+1. **Load Configuration**
+   ```
+   Read sedd.config.json (or use defaults)
+   Default specsDir: .sedd
+   ```
+
+2. **Verify SEDD is initialized**
+   - Check if specsDir exists
+   - If not: suggest `npx sedd init`
+
+3. **Check for existing feature branch**
+   - If on feature branch (###-name): use existing feature
+   - If not: create new feature
+
+## Configuration
+
+Default `sedd.config.json`:
+```json
+{
+  "specsDir": ".sedd",
+  "branchPattern": "{{id}}-{{name}}",
+  "autoSplit": { "enabled": true, "maxLines": 400 },
+  "commit": { "askBeforeCommit": true }
+}
+```
+
+## Workflow
+
+### Step 1: Parse Input
+
+Extract feature description from user input or ask interactively.
+
+### Step 2: Architecture Analysis (MANDATORY)
+
+Before creating spec, MUST search for related implementations:
+
+```
+Find similar:
+- Existing specs in {{specsDir}}/
+- Related code patterns
+- Reusable components
+```
+
+Document findings in spec.md.
+
+### Step 3: Capture Expectation (NEW)
+
+Ask user for their expectation:
+```
+What do you expect as the final outcome of this feature?
+(This will be used to verify alignment when implementation is complete)
+```
+
+Save expectation in:
+- `spec.md` under `## Expectation` section
+- `_meta.json` in `expectation` field
+
+### Step 4: Create Feature Structure
+
+```
+{{specsDir}}/{{FEATURE_ID}}-{{SHORT_NAME}}/
+├── _meta.json              # Metadata (with expectation)
+├── CHANGELOG.md            # Changelog
+├── spec.md                 # Base specification (with Expectation section)
+├── interfaces.ts           # TypeScript interfaces
+└── ui-mockups/             # If UI feature
+    └── component-name.md
+```
+
+### Step 5: Generate spec.md
+
+Use template with:
+- Feature name, ID, timestamp
+- User stories based on description
+- Mark requirements as NEEDS_CLARIFICATION where unclear
+- Include Expectation section
+
+### Step 6: Generate interfaces.ts (MANDATORY)
+
+Extract entities from description and create TypeScript interfaces:
+- Identify nouns → Entities
+- Identify verbs → Actions/Events
+- Define DTOs for API
+
+### Step 7: UI Mockups (MANDATORY if UI feature)
+
+If feature involves UI components, CREATE ASCII mockups:
+
+```
+┌────────────────────────────────────────┐
+│  Header                          [X]   │
+├────────────────────────────────────────┤
+│                                        │
+│  ┌──────────┐  ┌──────────┐           │
+│  │  Card 1  │  │  Card 2  │           │
+│  └──────────┘  └──────────┘           │
+│                                        │
+│  [Button Primary]  [Button Secondary]  │
+│                                        │
+└────────────────────────────────────────┘
+```
+
+Save to `ui-mockups/{{component}}.md`
+
+### Step 8: Initialize _meta.json
+
+```json
+{
+  "featureId": "024",
+  "featureName": "dark-mode-toggle",
+  "branch": "024-dark-mode-toggle",
+  "createdAt": "2026-01-11T10:00:00Z",
+  "specCreatedAt": "2026-01-11T10:00:00Z",
+  "currentMigration": null,
+  "migrations": {},
+  "splits": [],
+  "commits": [],
+  "expectation": "User can toggle dark mode in settings and have it persist across sessions"
+}
+```
+
+### Step 9: Update Changelog
+
+```markdown
+## [2026-01-11] - Feature Created
+
+- Created initial specification
+- Defined {{N}} user stories
+- Identified {{M}} key entities
+- Generated TypeScript interfaces
+```
+
+### Step 10: Ask About Commit
+
+```
+Do you want to commit?
+Message: "feat(024): create spec for dark-mode-toggle"
+```
+
+### Step 11: Offer Next Step
+
+```
+Specification created! Next step:
+/sedd.clarify - Refine requirements and generate tasks
+
+Would you like to proceed with clarification?
+```
+
+## Output
+
+1. **spec.md** - Complete specification
+2. **interfaces.ts** - TypeScript interfaces
+3. **ui-mockups/** - ASCII mockups (if UI)
+4. **_meta.json** - Feature metadata
+5. **CHANGELOG.md** - Initial entry
+
+## Rules
+
+- NEVER create spec without architecture analysis
+- ALWAYS create interfaces.ts
+- ALWAYS create ASCII mockups for UI features
+- Mark unclear items as NEEDS_CLARIFICATION
+- Auto-split files > 400 lines
+- No migrations created yet (happens in /sedd.clarify)
+
+## CLI Alternative
+
+For automated workflows, use the SEDD CLI:
+
+```bash
+# Create new feature structure
+sedd specify 024 dark-mode-toggle -d "Add dark mode support"
+
+# Create with expectation (recommended)
+sedd specify 024 dark-mode-toggle -d "Add dark mode support" -e "User can toggle dark mode"
+
+# Check structure
+sedd check
+
+# View status
+sedd status
+```
+
+**Options:**
+- `-d, --description` - Feature description
+- `-e, --expectation` - Expected outcome (used for alignment verification)
+
+Scripts also available in `.sedd/scripts/powershell/sedd-specify.ps1` and `.sedd/scripts/bash/sedd-specify.sh`.

package/commands/sedd.tasks.md

@@ -0,0 +1,176 @@
+# /sedd.tasks - Generate Tasks
+
+## Purpose
+Add tasks to the current migration. Usually called after /sedd.clarify to populate tasks.md.
+
+## Trigger
+User runs `/sedd.tasks`
+
+## 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. **Load _meta.json** to get current migration
+
+5. **Verify current migration exists** (run /sedd.clarify first)
+
+## CRITICAL RULE
+
+⚠️ **NOTHING HAPPENS WITHOUT A TASK**
+- Every action must be a task in tasks.md
+- NEVER skip task registration
+- ALWAYS update task status before/after work
+
+## Workflow
+
+### Step 1: Load Context
+
+Read from feature directory:
+- `spec.md` (requirements)
+- `interfaces.ts` (entities)
+- `{currentMigration}/clarify.md` (clarifications)
+- `{currentMigration}/decisions.md` (decisions)
+
+### Step 2: Extract Work Items
+
+From spec.md:
+- Each User Story → Task group
+- Each Functional Requirement → Task
+- Each Entity in interfaces.ts → CRUD tasks
+
+From decisions.md:
+- Each decision with implementation impact → Task
+
+### Step 3: Generate Task IDs
+
+Tasks are prefixed with migration ID:
+
+```
+T{migration}-{sequence}
+
+T001-001 = Migration 001, Task 1
+T001-002 = Migration 001, Task 2
+T002-001 = Migration 002, Task 1
+```
+
+### Step 4: Create Task Categories
+
+| Category | Description |
+|----------|-------------|
+| Foundation | Infrastructure, base setup |
+| US{N} | User Story implementation |
+| Integration | External services |
+| Tests | Unit, integration tests |
+
+### Step 5: Write tasks.md
+
+Append to `{currentMigration}/tasks.md`:
+
+```markdown
+# Tasks - Migration 001
+
+Migration: 001
+Timestamp: 2026-01-11_10-30-45
+Parent: (none)
+
+## Summary
+Total: 8 | Completed: 0 | Pending: 8
+
+## Tasks
+
+### Foundation
+- [ ] T001-001 [Foundation] Create database migration for new tables
+- [ ] T001-002 [Foundation] Set up API route structure
+
+### US1: Dark Mode Toggle
+- [ ] T001-003 [US1] Create ThemeContext with localStorage persistence
+- [ ] T001-004 [US1] Build ThemeToggle component
+- [ ] T001-005 [US1] Add toggle to settings page
+
+### US2: Theme Sync
+- [ ] T001-006 [US2] Create user preference API endpoint
+- [ ] T001-007 [US2] Implement cross-device sync
+
+### Tests
+- [ ] T001-008 [Tests] Write unit tests for ThemeContext
+
+## Dependencies
+
+T001-001, T001-002 → T001-003 → T001-004 → T001-005
+                    → T001-006 → T001-007
+T001-003 → T001-008
+```
+
+### Step 6: Update _meta.json
+
+```json
+{
+  "migrations": {
+    "001": {
+      "tasksTotal": 8,
+      "tasksCompleted": 0,
+      "status": "in-progress"
+    }
+  }
+}
+```
+
+### Step 7: Ask About Commit
+
+```
+Tasks generated! 8 tasks in migration 001.
+
+Do you want to commit?
+Message: "docs(024): add tasks for migration 001"
+```
+
+## Task Format
+
+```
+- [ ] T{MIG}-{SEQ} [{CATEGORY}] {Description} `{file_path}` (optional)
+```
+
+Examples:
+```
+- [ ] T001-001 [Foundation] Create ThemeContext `src/contexts/ThemeContext.tsx`
+- [ ] T001-002 [US1] Add dark mode toggle to header
+- [x] T001-003 [Tests] Write unit tests for ThemeContext
+```
+
+## Rules
+
+- Tasks MUST have migration prefix (T001-XXX)
+- Tasks MUST have category in brackets
+- File paths are optional but recommended
+- Update task count in _meta.json
+- Tasks can span multiple migrations
+
+## CLI Alternative
+
+For automated workflows, use the SEDD CLI:
+
+```bash
+# Add tasks to current migration
+sedd tasks '[{"story":"US1","description":"Create component"},{"story":"US2","description":"Add API"}]'
+
+# Mark task complete
+sedd complete T001-001
+
+# View status
+sedd status
+```
+
+Scripts also available in `.sedd/scripts/powershell/sedd-tasks.ps1`.

package/dist/cli/check.d.ts

@@ -0,0 +1,6 @@
+interface CheckOptions {
+    fix?: boolean;
+}
+export declare function check(options?: CheckOptions): Promise<void>;
+export {};
+//# sourceMappingURL=check.d.ts.map

package/dist/cli/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/cli/check.ts"],"names":[],"mappings":"AAOA,UAAU,YAAY;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAQD,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6IrE"}

package/dist/cli/check.js

@@ -0,0 +1,134 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import chalk from 'chalk';
+import { GitOperations } from '../utils/git.js';
+import { MigrationManager } from '../core/migration-manager.js';
+import { loadConfig } from '../types/index.js';
+export async function check(options = {}) {
+    const cwd = process.cwd();
+    const git = new GitOperations(cwd);
+    const config = loadConfig(cwd);
+    console.log(chalk.blue('\n🔍 Checking SEDD structure...\n'));
+    const result = {
+        valid: true,
+        errors: [],
+        warnings: [],
+    };
+    // Check config file
+    const configPath = join(cwd, 'sedd.config.json');
+    if (existsSync(configPath)) {
+        console.log(chalk.green('✓'), 'sedd.config.json exists');
+    }
+    else {
+        result.warnings.push('sedd.config.json not found. Using defaults.');
+        console.log(chalk.yellow('⚠'), 'sedd.config.json not found (using defaults)');
+    }
+    // Check specs directory
+    const specsDir = join(cwd, config.specsDir);
+    if (!existsSync(specsDir)) {
+        result.warnings.push(`${config.specsDir}/ directory not found. No features created yet.`);
+        console.log(chalk.yellow('⚠'), `${config.specsDir}/ not found`);
+    }
+    else {
+        console.log(chalk.green('✓'), `${config.specsDir}/ directory exists`);
+        const features = readdirSync(specsDir, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+        for (const feature of features) {
+            const featureDir = join(specsDir, feature);
+            const metaPath = join(featureDir, '_meta.json');
+            if (existsSync(metaPath)) {
+                console.log(chalk.green('✓'), `${feature}/ has valid _meta.json`);
+                const mm = new MigrationManager(featureDir);
+                const meta = mm.loadMeta();
+                if (meta) {
+                    const migrations = Object.keys(meta.migrations).length;
+                    const current = meta.currentMigration || 'none';
+                    console.log(chalk.gray('  └'), `Migrations: ${migrations}, Current: ${current}`);
+                }
+            }
+            else {
+                const hasOldStructure = existsSync(join(featureDir, 'spec.md')) || existsSync(join(featureDir, 'tasks.md'));
+                if (hasOldStructure) {
+                    result.warnings.push(`${feature}/ uses old structure. Run "sedd migrate ${feature}" to upgrade.`);
+                    console.log(chalk.yellow('⚠'), `${feature}/ needs migration`);
+                }
+                else {
+                    result.warnings.push(`${feature}/ has no _meta.json`);
+                    console.log(chalk.yellow('⚠'), `${feature}/ missing _meta.json`);
+                }
+            }
+        }
+    }
+    // Check .claude directory
+    const claudeDir = join(cwd, '.claude');
+    const commandsDir = join(claudeDir, 'commands');
+    const hooksDir = join(claudeDir, 'hooks');
+    if (!existsSync(commandsDir)) {
+        result.warnings.push('.claude/commands/ not found. Run "sedd init" to install commands.');
+    }
+    else {
+        const requiredCommands = [
+            'sedd.specify.md',
+            'sedd.clarify.md',
+            'sedd.implement.md',
+        ];
+        for (const cmd of requiredCommands) {
+            const cmdPath = join(commandsDir, cmd);
+            if (existsSync(cmdPath)) {
+                console.log(chalk.green('✓'), `Command: ${cmd}`);
+            }
+            else {
+                result.warnings.push(`Missing command: ${cmd}`);
+                console.log(chalk.yellow('⚠'), `Missing: ${cmd}`);
+            }
+        }
+    }
+    if (!existsSync(hooksDir)) {
+        result.warnings.push('.claude/hooks/ not found. Run "sedd init" to install hooks.');
+    }
+    else {
+        const hookFiles = ['check-roadmap.js', 'check-roadmap.ps1'];
+        for (const hook of hookFiles) {
+            const hookPath = join(hooksDir, hook);
+            if (existsSync(hookPath)) {
+                console.log(chalk.green('✓'), `Hook: ${hook}`);
+            }
+        }
+    }
+    // Check git branch
+    if (git.hasGit()) {
+        const branch = git.getCurrentBranch();
+        if (git.isFeatureBranch(branch)) {
+            console.log(chalk.green('✓'), `On feature branch: ${branch}`);
+        }
+        else {
+            result.warnings.push(`Not on a feature branch (current: ${branch})`);
+            console.log(chalk.yellow('⚠'), `Not on feature branch: ${branch}`);
+        }
+    }
+    console.log();
+    if (result.errors.length > 0) {
+        console.log(chalk.red('Errors:'));
+        for (const error of result.errors) {
+            console.log(chalk.red('  ✗'), error);
+        }
+    }
+    if (result.warnings.length > 0) {
+        console.log(chalk.yellow('Warnings:'));
+        for (const warning of result.warnings) {
+            console.log(chalk.yellow('  ⚠'), warning);
+        }
+    }
+    if (result.valid && result.warnings.length === 0) {
+        console.log(chalk.green('✨ All checks passed!\n'));
+    }
+    else if (result.valid) {
+        console.log(chalk.yellow('\n⚠ Some warnings found, but structure is valid.\n'));
+    }
+    else {
+        console.log(chalk.red('\n✗ Structure is invalid. Please fix errors.\n'));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/cli/check.ts"],"names":[],"mappings":"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"}

package/dist/cli/clarify.d.ts

@@ -0,0 +1,2 @@
+export declare function clarify(branch?: string): Promise<void>;
+//# sourceMappingURL=clarify.d.ts.map

package/dist/cli/clarify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarify.d.ts","sourceRoot":"","sources":["../../src/cli/clarify.ts"],"names":[],"mappings":"AAOA,wBAAsB,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiI5D"}

package/dist/cli/clarify.js

@@ -0,0 +1,116 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import chalk from 'chalk';
+import { loadConfig, getNextMigrationId, getMigrationFolder } from '../types/index.js';
+import { GitOperations } from '../utils/git.js';
+import { getSessionTimestamp, formatTimestamp } from '../core/timestamps.js';
+export async function clarify(branch) {
+    const cwd = process.cwd();
+    const config = loadConfig(cwd);
+    const git = new GitOperations(cwd);
+    const currentBranch = branch || git.getCurrentBranch();
+    if (!git.isFeatureBranch(currentBranch)) {
+        console.log(chalk.red(`Error: Not on a feature branch (current: ${currentBranch})`));
+        process.exit(1);
+    }
+    let featureDir = join(cwd, config.specsDir, currentBranch);
+    if (!existsSync(featureDir)) {
+        featureDir = join(cwd, 'specs', currentBranch);
+    }
+    if (!existsSync(featureDir)) {
+        console.log(chalk.red(`Error: Feature directory not found for branch: ${currentBranch}`));
+        process.exit(1);
+    }
+    const metaPath = join(featureDir, '_meta.json');
+    if (!existsSync(metaPath)) {
+        console.log(chalk.red('Error: _meta.json not found. Run /sedd.specify first.'));
+        process.exit(1);
+    }
+    const meta = JSON.parse(readFileSync(metaPath, 'utf-8'));
+    const migrationId = getNextMigrationId(meta);
+    const timestamp = getSessionTimestamp();
+    const migrationFolder = getMigrationFolder(migrationId, timestamp);
+    const migrationDir = join(featureDir, migrationFolder);
+    mkdirSync(migrationDir, { recursive: true });
+    console.log(chalk.green('✓'), `Created migration: ${migrationFolder}`);
+    const dateStr = formatTimestamp();
+    const previousMigration = meta.currentMigration;
+    const clarifyContent = `# Clarification Session - Migration ${migrationId}
+
+**Timestamp:** ${dateStr}
+**Branch:** ${currentBranch}
+
+## Expected Outcome
+
+> What do you expect to achieve with this migration?
+
+[Define your expected outcome here]
+
+---
+
+## Questions & Answers
+
+<!-- Questions discussed during this clarification session -->
+
+### Q1: [Question]
+
+**Answer:** [Answer]
+
+`;
+    writeFileSync(join(migrationDir, 'clarify.md'), clarifyContent, 'utf-8');
+    console.log(chalk.green('✓'), 'Created: clarify.md');
+    const decisionsContent = `# Decisions - Migration ${migrationId}
+
+**Timestamp:** ${dateStr}
+
+## Decisions Made
+
+| # | Decision | Rationale |
+|---|----------|-----------|
+| 1 | [Decision] | [Why] |
+
+`;
+    writeFileSync(join(migrationDir, 'decisions.md'), decisionsContent, 'utf-8');
+    console.log(chalk.green('✓'), 'Created: decisions.md');
+    const tasksContent = `# Tasks - Migration ${migrationId}
+
+**Migration:** ${migrationId}
+**Timestamp:** ${timestamp}
+**Parent:** ${previousMigration || 'none'}
+
+## Tasks
+
+<!-- Tasks will be added here by /sedd.tasks -->
+<!-- Format: - [ ] T${migrationId}-001 [US1] Task description -->
+
+`;
+    writeFileSync(join(migrationDir, 'tasks.md'), tasksContent, 'utf-8');
+    console.log(chalk.green('✓'), 'Created: tasks.md');
+    meta.currentMigration = migrationId;
+    meta.migrations[migrationId] = {
+        id: migrationId,
+        timestamp,
+        folder: migrationFolder,
+        parent: previousMigration || undefined,
+        status: 'pending',
+        tasksTotal: 0,
+        tasksCompleted: 0,
+        createdAt: new Date().toISOString(),
+    };
+    writeFileSync(metaPath, JSON.stringify(meta, null, 2), 'utf-8');
+    console.log(chalk.green('✓'), 'Updated: _meta.json');
+    console.log(chalk.cyan(`\n✨ Migration ${migrationId} created successfully!`));
+    console.log(chalk.cyan('Next steps:'));
+    console.log('  1. Add questions/answers to clarify.md');
+    console.log('  2. Document decisions in decisions.md');
+    console.log('  3. Run /sedd.tasks to generate tasks');
+    console.log(chalk.gray('\n---SEDD-OUTPUT---'));
+    console.log(JSON.stringify({
+        success: true,
+        migrationId,
+        migrationFolder,
+        migrationDir,
+        files: ['clarify.md', 'decisions.md', 'tasks.md'],
+    }));
+}
+//# sourceMappingURL=clarify.js.map

package/dist/cli/clarify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarify.js","sourceRoot":"","sources":["../../src/cli/clarify.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * SEDD CLI - Spec & Expectation Driven Development
+ *
+ * Main entry point for the CLI.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}