@nextsparkjs/ai-workflow 0.1.0-beta.86

package/claude/commands/session/commit.md

@@ -0,0 +1,174 @@
+# /session:commit
+
+Create a git commit for the current session changes.
+
+**Aliases:** `/commit`
+
+---
+
+## Syntax
+
+```
+/session:commit [message]
+```
+
+---
+
+## Behavior
+
+Creates a structured commit with session context and proper co-author attribution.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:commit                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Check for uncommitted changes                               │
+│     ↓                                                           │
+│  2. Load session context                                        │
+│     - Read scope.json                                           │
+│     - Read progress.md                                          │
+│     ↓                                                           │
+│  3. Analyze changes                                             │
+│     - Categorize by type (feat/fix/refactor)                    │
+│     - Identify related ACs                                      │
+│     ↓                                                           │
+│  4. Generate commit message                                     │
+│     - Following conventional commits                            │
+│     - Reference session/task if applicable                      │
+│     ↓                                                           │
+│  5. Show preview and confirm                                    │
+│     ↓                                                           │
+│  6. Execute commit                                              │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Output
+
+```
+📦 SESSION COMMIT
+
+Session: stories/2026-01-11-new-products-entity
+
+─────────────────────────────────────────
+
+📊 CHANGES DETECTED
+
+Staged:
+├─ core/config/entities/products.ts (new)
+├─ core/db/migrations/008_products.sql (new)
+├─ core/services/ProductsService.ts (new)
+└─ core/components/products/ProductForm.tsx (new)
+
+Unstaged:
+└─ (none)
+
+─────────────────────────────────────────
+
+📝 GENERATED COMMIT MESSAGE
+
+feat(products): add products entity with CRUD operations
+
+- Create products migration with fields and relations
+- Configure entity in entities.config.ts
+- Add ProductsService for custom price logic
+- Create ProductForm component with validation
+
+Relates to: AC1, AC2, AC3
+Session: stories/2026-01-11-new-products-entity
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+─────────────────────────────────────────
+
+Commit with this message? [Yes/Edit/Cancel]
+
+> Yes
+
+✓ Changes committed: abc1234
+```
+
+---
+
+## With Custom Message
+
+```
+/session:commit "feat(products): initial entity setup"
+```
+
+Output:
+
+```
+📦 SESSION COMMIT
+
+Using provided message: "feat(products): initial entity setup"
+
+─────────────────────────────────────────
+
+📝 FINAL COMMIT MESSAGE
+
+feat(products): initial entity setup
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+─────────────────────────────────────────
+
+Commit? [Yes/Edit/Cancel]
+```
+
+---
+
+## Commit Types
+
+| Type | Description |
+|------|-------------|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `refactor` | Code refactoring |
+| `docs` | Documentation changes |
+| `test` | Test additions/changes |
+| `chore` | Maintenance tasks |
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--no-verify` | Skip pre-commit hooks |
+| `--amend` | Amend last commit |
+| `--push` | Push after commit |
+
+---
+
+## Task Manager Integration
+
+If `taskManager.enabled`:
+
+```
+📋 LINKING COMMIT
+
+ClickUp: #abc123
+
+Add commit reference to task? [Yes/No]
+
+> Yes
+
+✓ Commit linked to task
+```
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:validate` | Validate before commit |
+| `/session:close` | Close after final commit |

package/claude/commands/session/db-entity.md

@@ -0,0 +1,206 @@
+# /session:db:entity
+
+Generate migration for an entity with relations and metadata support.
+
+---
+
+## Required Skills
+
+**[MANDATORY]** Read these skills before executing:
+- `.claude/skills/database-migrations/SKILL.md` - PostgreSQL patterns with RLS
+- `.claude/skills/entity-system/SKILL.md` - Entity configuration patterns
+
+---
+
+## Syntax
+
+```
+/session:db:entity <entity-name> [--fields <fields>]
+```
+
+---
+
+## Behavior
+
+Creates a complete database migration following project conventions including RLS policies.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:db:entity                                              │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Analyze entity requirements                                 │
+│     - Read session context                                      │
+│     - Parse field definitions                                   │
+│     ↓                                                           │
+│  2. Determine relations                                         │
+│     - Foreign keys                                              │
+│     - Many-to-many tables                                       │
+│     ↓                                                           │
+│  3. Generate migration SQL                                      │
+│     - Main table with camelCase fields                          │
+│     - Meta table (if needed)                                    │
+│     - RLS policies                                              │
+│     ↓                                                           │
+│  4. Validate SQL syntax                                         │
+│     ↓                                                           │
+│  5. Create migration file                                       │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Output
+
+```
+🗃️ CREATE ENTITY MIGRATION
+
+Entity: products
+
+─────────────────────────────────────────
+
+📋 ENTITY ANALYSIS
+
+From session requirements:
+- name: string (required)
+- description: text (optional)
+- price: decimal (required)
+- categoryId: UUID FK (optional)
+- isActive: boolean (default: true)
+
+Relations detected:
+- products → categories (many-to-one)
+
+─────────────────────────────────────────
+
+📝 GENERATED MIGRATION
+
+File: core/db/migrations/008_products.sql
+
+```sql
+-- ============================================
+-- Migration: 008_products.sql
+-- Entity: products
+-- Generated: 2026-01-11
+-- ============================================
+
+-- Main table
+CREATE TABLE products (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+
+    -- Fields (camelCase)
+    name VARCHAR(255) NOT NULL,
+    description TEXT,
+    price DECIMAL(10, 2) NOT NULL,
+    categoryId UUID REFERENCES categories(id),
+    isActive BOOLEAN NOT NULL DEFAULT true,
+
+    -- System fields
+    teamId UUID NOT NULL REFERENCES teams(id),
+    createdById UUID REFERENCES "user"(id),
+    createdAt TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updatedAt TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Indexes
+CREATE INDEX idx_products_teamId ON products(teamId);
+CREATE INDEX idx_products_categoryId ON products(categoryId);
+CREATE INDEX idx_products_isActive ON products(isActive);
+
+-- RLS Policies
+ALTER TABLE products ENABLE ROW LEVEL SECURITY;
+
+CREATE POLICY products_team_isolation ON products
+    USING (teamId = current_setting('app.current_team_id')::UUID);
+
+CREATE POLICY products_select ON products
+    FOR SELECT USING (true);
+
+CREATE POLICY products_insert ON products
+    FOR INSERT WITH CHECK (
+        teamId = current_setting('app.current_team_id')::UUID
+    );
+
+CREATE POLICY products_update ON products
+    FOR UPDATE USING (
+        teamId = current_setting('app.current_team_id')::UUID
+    );
+
+CREATE POLICY products_delete ON products
+    FOR DELETE USING (
+        teamId = current_setting('app.current_team_id')::UUID
+    );
+
+-- Trigger for updatedAt
+CREATE TRIGGER update_products_updated_at
+    BEFORE UPDATE ON products
+    FOR EACH ROW
+    EXECUTE FUNCTION update_updated_at_column();
+```
+
+─────────────────────────────────────────
+
+✅ VALIDATION
+
+- [x] camelCase field names
+- [x] UUID primary key
+- [x] TIMESTAMPTZ for dates
+- [x] RLS policies configured
+- [x] teamId for multi-tenant
+
+─────────────────────────────────────────
+
+✓ Migration created: 008_products.sql
+
+Next: /session:db:sample to generate sample data
+```
+
+---
+
+## With Meta Table
+
+```
+/session:db:entity products --with-meta
+```
+
+Generates additional meta table:
+
+```sql
+-- Meta table for extensible fields
+CREATE TABLE products_meta (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    productId UUID NOT NULL REFERENCES products(id) ON DELETE CASCADE,
+    key VARCHAR(255) NOT NULL,
+    value JSONB,
+    createdAt TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    UNIQUE(productId, key)
+);
+
+CREATE INDEX idx_products_meta_productId ON products_meta(productId);
+CREATE INDEX idx_products_meta_key ON products_meta(key);
+```
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--fields <fields>` | Field definitions (name:type) |
+| `--with-meta` | Include meta table |
+| `--no-rls` | Skip RLS policies |
+| `--dry-run` | Show SQL without creating |
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:db:sample` | Generate sample data |
+| `/session:db:fix` | Fix migration issues |

package/claude/commands/session/db-fix.md

@@ -0,0 +1,212 @@
+# /session:db:fix
+
+Test and fix database migrations iteratively until success.
+
+---
+
+## Syntax
+
+```
+/session:db:fix [--migration <name>]
+```
+
+---
+
+## Behavior
+
+Runs migrations, detects errors, fixes them, and retries until successful.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:db:fix                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Run pending migrations                                      │
+│     ↓                                                           │
+│  2. Check for errors                                            │
+│     │                                                           │
+│     ├─► No errors: Done                                         │
+│     │                                                           │
+│     └─► Errors found:                                           │
+│         ↓                                                       │
+│  3. Analyze error                                               │
+│     - Syntax error?                                             │
+│     - Missing reference?                                        │
+│     - Type mismatch?                                            │
+│     ↓                                                           │
+│  4. Apply fix                                                   │
+│     ↓                                                           │
+│  5. Go to step 1                                                │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Output
+
+```
+🗃️ FIX DATABASE MIGRATIONS
+
+─────────────────────────────────────────
+
+📋 ITERATION 1
+
+Running migrations...
+
+❌ Migration failed: 008_products.sql
+
+Error:
+ERROR: relation "categories" does not exist
+LINE 10: categoryId UUID REFERENCES categories(id),
+
+─────────────────────────────────────────
+
+🔍 ANALYZING ERROR
+
+Type: Missing foreign key reference
+Table: categories
+Required by: products.categoryId
+
+Analysis:
+- categories table not created yet
+- Need to create categories before products
+- Or make categoryId nullable without FK constraint
+
+Options:
+[1] Create categories migration first
+[2] Make categoryId nullable (no FK)
+[3] Remove categoryId field
+
+> 1
+
+─────────────────────────────────────────
+
+🔧 APPLYING FIX
+
+Creating: 007_categories.sql
+
+```sql
+CREATE TABLE categories (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name VARCHAR(255) NOT NULL,
+    teamId UUID NOT NULL REFERENCES teams(id),
+    createdAt TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+ALTER TABLE categories ENABLE ROW LEVEL SECURITY;
+
+CREATE POLICY categories_team_isolation ON categories
+    USING (teamId = current_setting('app.current_team_id')::UUID);
+```
+
+✓ Migration created
+
+Renumbering: 008_products.sql → 008_products.sql (unchanged)
+
+─────────────────────────────────────────
+
+📋 ITERATION 2
+
+Running migrations...
+
+✓ 007_categories.sql executed
+✓ 008_products.sql executed
+
+─────────────────────────────────────────
+
+📊 SUMMARY
+
+Iterations: 2
+Migrations fixed: 1
+Migrations created: 1
+
+Database is now up to date.
+```
+
+---
+
+## Common Error Fixes
+
+| Error | Auto-Fix |
+|-------|----------|
+| Missing table reference | Create migration or reorder |
+| Syntax error | Fix SQL syntax |
+| Type mismatch | Cast or change type |
+| Duplicate key | Update or skip |
+| RLS policy error | Fix policy syntax |
+
+---
+
+## With Specific Migration
+
+```
+/session:db:fix --migration 008_products
+```
+
+Output:
+
+```
+🗃️ FIX MIGRATION: 008_products.sql
+
+─────────────────────────────────────────
+
+Running 008_products.sql...
+
+⚠️ Warning: Migration partially applied
+
+Issues:
+1. Table created
+2. Indexes created
+3. ❌ RLS policy failed
+
+Error:
+ERROR: policy "products_team_isolation" already exists
+
+─────────────────────────────────────────
+
+🔧 FIX OPTIONS
+
+[1] Drop and recreate policy
+[2] Skip policy (already exists)
+[3] Rename new policy
+
+> 2
+
+Skipping existing policy...
+✓ Migration completed with skip
+
+─────────────────────────────────────────
+
+Verifying database state...
+✓ Table: products exists
+✓ Columns: 9 columns correct
+✓ Indexes: 3 indexes present
+✓ RLS: Enabled with policies
+
+Database is consistent.
+```
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--migration <name>` | Fix specific migration |
+| `--max-iterations <n>` | Max fix attempts (default: 5) |
+| `--dry-run` | Show fixes without applying |
+| `--reset` | Drop and recreate tables |
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:db:entity` | Create entity migration |
+| `/session:db:sample` | Generate sample data |