@nextsparkjs/ai-workflow 0.1.0-beta.100

package/claude/commands/session/close.md

@@ -0,0 +1,225 @@
+# /session:close
+
+Close the active session or a specific session.
+
+---
+
+## Syntax
+
+```
+/session:close [session-path] [summary]
+```
+
+---
+
+## Behavior
+
+### Without path (active session)
+
+```
+/session:close
+```
+
+Closes the current active session (if there is one).
+
+### With path
+
+```
+/session:close stories/2026-01-11-new-entity "Feature completed"
+```
+
+Closes the specified session.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:close                                                  │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Verify ACs are met                                          │
+│     - Read requirements.md                                      │
+│     - Verify checklist in progress.md                           │
+│     ↓                                                           │
+│  2. All ACs completed?                                          │
+│     │                                                           │
+│     ├─► YES: Continue                                           │
+│     │                                                           │
+│     └─► NO: Warn                                                │
+│         "There are 2 pending ACs. Close anyway?"                │
+│     ↓                                                           │
+│  3. Execute session-close.sh                                    │
+│     ↓                                                           │
+│  4. Worktree cleanup (if session used a worktree)               │
+│     - Check if worktree path exists in session metadata         │
+│     - Check PR merge status:                                    │
+│       $ gh pr list --head <branch> --state merged               │
+│     │                                                           │
+│     ├─► PR MERGED: Auto-suggest removal                         │
+│     │   "PR merged! Removing worktree and branch..."            │
+│     │   $ git worktree remove <path>                            │
+│     │   $ git branch -d <branch>                                │
+│     │   (Still ask for confirmation before deleting)             │
+│     │                                                           │
+│     ├─► PR OPEN: Ask what to do                                 │
+│     │   "PR still open. Remove worktree?"                       │
+│     │   [1] Remove worktree (keep branch)                       │
+│     │   [2] Keep worktree                                       │
+│     │                                                           │
+│     └─► NO PR: Ask with all options                             │
+│         [1] Remove worktree and delete branch                   │
+│         [2] Remove worktree but keep branch                     │
+│         [3] Keep worktree                                       │
+│     ↓                                                           │
+│  5. Archive?                                                    │
+│     [Yes, archive] [No, keep]                                   │
+│     ↓                                                           │
+│  6. Update task manager (if enabled)                            │
+│     - Post final comment                                        │
+│     - Change status to "done"                                   │
+│     ↓                                                           │
+│  7. Show summary                                                │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Output
+
+```
+📋 CLOSING SESSION
+
+Session: stories/2026-01-11-new-products-entity
+Type: Story (STORY)
+Iterations: 2
+
+─────────────────────────────────────────
+
+✅ AC VERIFICATION
+
+AC1: Create products migration           ✓
+AC2: Implement CRUD API                  ✓
+AC3: Create management UI                ✓
+AC4: Automated tests                     ✓
+
+All ACs completed: 4/4
+
+─────────────────────────────────────────
+
+📊 SUMMARY
+
+- Total duration: 5 days
+- Iterations: 2
+- Files modified: 23
+- Tests created: 12
+
+─────────────────────────────────────────
+
+✓ Session closed
+
+Archive session? [Yes/No]
+```
+
+---
+
+## With Worktree
+
+### PR Already Merged
+
+```
+🌳 WORKTREE CLEANUP
+
+This session used a worktree:
+  Path: G:/GitHub/nextspark/repo-add-phone-field
+  Branch: feature/add-phone-field
+
+✅ PR #42 was MERGED into main.
+
+Recommended: Remove worktree and clean up branch.
+
+$ git worktree remove ../repo-add-phone-field
+✓ Worktree removed
+
+$ git branch -d feature/add-phone-field
+✓ Branch deleted (was merged)
+
+$ git remote prune origin
+✓ Remote references cleaned
+```
+
+### PR Still Open
+
+```
+🌳 WORKTREE CLEANUP
+
+This session used a worktree:
+  Path: G:/GitHub/nextspark/repo-add-phone-field
+  Branch: feature/add-phone-field
+
+⏳ PR #42 is still OPEN (not merged yet).
+
+Options:
+[1] Remove worktree but keep branch (can re-create worktree later)
+[2] Keep worktree (continue working later)
+```
+
+### No PR Found
+
+```
+🌳 WORKTREE CLEANUP
+
+This session used a worktree:
+  Path: G:/GitHub/nextspark/repo-add-phone-field
+  Branch: feature/add-phone-field
+
+Options:
+[1] Remove worktree and delete branch
+[2] Remove worktree but keep branch
+[3] Keep worktree (remove later with: git worktree remove ../repo-add-phone-field)
+```
+
+---
+
+## With Pending ACs
+
+```
+⚠️ WARNING
+
+There are pending ACs:
+- [ ] AC4: Automated tests
+
+Options:
+[1] Close anyway (document pending items)
+[2] Cancel and continue working
+[3] Move pending to new iteration
+```
+
+---
+
+## Task Manager Integration
+
+If `taskManager.enabled`:
+
+```
+📋 TASK UPDATE
+
+ClickUp: #abc123
+
+Posting final comment...
+✓ Comment posted
+
+Updating status to "done"...
+✓ Status updated
+```
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:status` | View status before closing |
+| `/session:pending` | Document pending items |

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 |