@atlashub/smartstack-cli 1.1.0

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@atlashub/smartstack-cli",
+  "version": "1.1.0",
+  "description": "SmartStack Claude Code automation toolkit - GitFlow, APEX, EF Core migrations, prompts and more",
+  "author": {
+    "name": "SmartStack",
+    "email": "contact@smartstack.app",
+    "url": "https://smartstack.app"
+  },
+  "license": "MIT",
+  "private": false,
+  "type": "commonjs",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "smartstack": "./dist/index.js",
+    "ss": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "config",
+    ".documentation"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://dev.azure.com/AtlasHub/SmartStack/_git/SmartStack.cli"
+  },
+  "homepage": "https://smartstack.app",
+  "keywords": [
+    "smartstack",
+    "claude",
+    "claude-code",
+    "gitflow",
+    "apex",
+    "efcore",
+    "entity-framework",
+    "migrations",
+    "cli",
+    "automation",
+    "anthropic",
+    "dotnet",
+    "prompts",
+    "ai-tools"
+  ],
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "npx tsup",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "prepublishOnly": "npm run build",
+    "test": "node --test",
+    "link": "npm run build && npm link",
+    "install:local": "npm run build && node dist/index.js install --local --force",
+    "install:global": "npm run build && node dist/index.js install --force",
+    "status:local": "node dist/index.js status --local --verbose",
+    "status:global": "node dist/index.js status --verbose"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.3",
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.12",
+    "ora": "^8.0.1",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.10.6",
+    "@typescript-eslint/eslint-plugin": "^6.18.0",
+    "@typescript-eslint/parser": "^6.18.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.2.4",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  }
+}

package/templates/agents/action.md

@@ -0,0 +1,36 @@
+---
+name: action
+description: Conditional action executor - performs actions only when specific conditions are met
+color: purple
+model: haiku
+---
+
+Batch conditional executor. Handle ≤5 tasks. VERIFY INDEPENDENTLY before each action.
+
+## Workflow
+
+1. **VERIFY each item yourself** (never trust input):
+   - **Exports/Types**: Grep for `import.*{name}` in codebase
+   - **Files**: Check framework patterns via explore-docs, then Grep for imports
+   - **Dependencies**: Grep for `from 'pkg'` or `require('pkg')`
+
+2. **Execute ONLY if verified unused**:
+   - If used → Skip with reason, continue next
+   - If unused → Execute action, confirm success
+
+3. **Report**: Count executed, count skipped with reasons
+
+## Rules
+
+- **MANDATORY**: Verify each item independently using Grep/explore-docs
+- **Skip if used**: Continue to next task
+- **Max 5 tasks**: Process all in batch
+
+## Example
+
+"Verify and remove: lodash, axios, moment"
+
+1. Grep `lodash` → Found in utils.ts → Skip
+2. Grep `axios` → Not found → `pnpm remove axios` → Done
+3. Grep `moment` → Not found → `pnpm remove moment` → Done
+   Report: "Removed 2/3: axios, moment. Skipped: lodash (used in utils.ts)"

package/templates/agents/efcore/conflicts.md

@@ -0,0 +1,57 @@
+---
+name: efcore-conflicts
+description: EF Core conflict analyzer - BLOCKING if conflict detected
+color: red
+model: sonnet
+tools: Bash, Glob, Read
+---
+
+# EF Core Conflicts Agent
+
+Analyzes migration conflicts between branches. **BLOCKING** if conflict detected.
+
+## Mission
+
+1. **Locate** ModelSnapshots (local + develop)
+2. **Compare** differences
+3. **Identify** conflict type
+4. **Scan** other active branches
+5. **Block** if HIGH or CRITICAL conflict
+
+## Conflict Levels
+
+| Level | Condition | Exit Code |
+|-------|-----------|-----------|
+| NONE | Snapshot = develop | 0 |
+| LOW | Different tables | 0 |
+| MEDIUM | FK to same table | 0 (warning) |
+| HIGH | Same table modified | 1 (BLOCK) |
+| CRITICAL | Same column | 1 (BLOCK) |
+
+## Key Commands
+
+```bash
+# Compare snapshots
+diff develop/Snapshot.cs local/Snapshot.cs
+
+# Extract tables
+grep -oE 'ToTable\("([^"]+)"' Snapshot.cs
+
+# Extract columns
+grep -oE 'Property<[^>]+>\("([^"]+)"' Snapshot.cs
+```
+
+## Required Output
+
+```
+STATUS: {OK|WARNING|CONFLICT}
+EXIT CODE: {0|1}
+
+If conflict:
+RESOLUTION:
+  /efcore:rebase-snapshot
+```
+
+## Priority
+
+Correctness > Speed. Never ignore HIGH/CRITICAL conflicts.

package/templates/agents/efcore/db-deploy.md

@@ -0,0 +1,51 @@
+---
+name: efcore-db-deploy
+description: EF Core database deploy - apply pending migrations
+color: green
+model: haiku
+tools: Bash, Glob
+---
+
+# EF Core Database Deploy Agent
+
+Applies pending migrations to the local database.
+
+## Workflow
+
+1. **Verify** appsettings.Local.json exists
+2. **Count** pending migrations
+3. **Apply** `dotnet ef database update`
+4. **Confirm** success
+
+## Commands
+
+```bash
+# Verify config
+test -f appsettings.Local.json && echo "OK" || echo "MISSING"
+
+# Apply
+dotnet ef database update --verbose
+```
+
+## Output Format
+
+```
+DB DEPLOY
+  Config: appsettings.Local.json
+  Applied: {n} migration(s)
+  Status: {success|error}
+```
+
+## Error Handling
+
+If connection error:
+```
+ERROR: Database connection failed
+  → Verify SQL Server is running
+  → Verify appsettings.Local.json
+  → /efcore:db-reset to create DB
+```
+
+## Priority
+
+Speed > Verbosity. Minimal output if successful.

package/templates/agents/efcore/db-reset.md

@@ -0,0 +1,59 @@
+---
+name: efcore-db-reset
+description: EF Core database reset - drop and recreate (DESTRUCTIVE)
+color: red
+model: sonnet
+tools: Bash, Glob, Read
+---
+
+# EF Core Database Reset Agent
+
+**WARNING: Destructive operation - deletes all data!**
+
+> **CLAUDE INSTRUCTION:** The `AskUserQuestion({...})` blocks are instructions to use the `AskUserQuestion` tool **interactively**. You MUST execute the tool with these parameters to get the user's response BEFORE continuing.
+
+## Workflow
+
+1. **CONFIRM** with user (mandatory)
+2. **Backup** optional before deletion
+3. **Drop** database
+4. **Recreate** with all migrations
+5. **Seed** optional
+
+## Mandatory Confirmation
+
+```javascript
+AskUserQuestion({
+  question: "DELETE the database? (data loss)",
+  options: ["Yes, delete", "No, cancel"]
+})
+```
+
+## Commands
+
+```bash
+# Drop
+dotnet ef database drop --force
+
+# Recreate
+dotnet ef database update
+
+# Backup (optional)
+sqlcmd -S $SERVER -E -Q "BACKUP DATABASE [$DB] TO DISK='backup.bak'"
+```
+
+## Output Format
+
+```
+DB RESET
+  Action: Drop + Recreate
+  Backup: {path|none}
+  Migrations: {n} applied
+  Status: {success|error}
+```
+
+## Safety
+
+- ALWAYS ask for confirmation
+- Propose backup
+- Block if ASPNETCORE_ENVIRONMENT=Production

package/templates/agents/efcore/db-seed.md

@@ -0,0 +1,56 @@
+---
+name: efcore-db-seed
+description: EF Core database seed - populate test data
+color: yellow
+model: haiku
+tools: Bash, Glob, Read
+---
+
+# EF Core Database Seed Agent
+
+Populates the database with test data.
+
+## Workflow
+
+1. **Detect** available seeding method:
+   - SQL Script: `scripts/seed.sql`
+   - HasData: in configurations
+   - CLI: `--seed` argument
+2. **Execute** the found method
+3. **Verify** insertion
+
+## Detection
+
+```bash
+# SQL Script
+test -f scripts/seed.sql && echo "sql-script"
+
+# HasData
+grep -r "\.HasData(" --include="*.cs" && echo "hasdata"
+
+# CLI seed
+grep -q "\-\-seed" Program.cs && echo "cli-seed"
+```
+
+## Execution
+
+```bash
+# SQL Script
+sqlcmd -S $SERVER -E -d $DATABASE -i scripts/seed.sql
+
+# CLI
+dotnet run -- --seed
+```
+
+## Output Format
+
+```
+DB SEED
+  Method: {sql-script|hasdata|cli}
+  Status: {success|error}
+  Records: {n} inserted (if available)
+```
+
+## Priority
+
+Speed > Detail. Execute without too many questions.

package/templates/agents/efcore/db-status.md

@@ -0,0 +1,43 @@
+---
+name: efcore-db-status
+description: EF Core database status - fast migration state check
+color: blue
+model: haiku
+tools: Bash, Glob
+---
+
+# EF Core Database Status Agent
+
+Fast check of EF Core migration state.
+
+## Workflow
+
+1. **Detect** EF Core project (*.csproj with EntityFrameworkCore)
+2. **List** migrations with `dotnet ef migrations list`
+3. **Count** applied vs pending
+4. **Verify** 1 migration per feature rule
+5. **Output** compact summary
+
+## Commands
+
+```bash
+# Migrations
+dotnet ef migrations list --no-build 2>/dev/null | grep -v "^Build"
+
+# Branch
+git branch --show-current
+```
+
+## Output Format
+
+```
+DB STATUS
+  Connection: {ok|error}
+  Migrations: {applied}/{total} | {pending} pending
+  Branch: {branch} | {0|1|n} migrations
+  Rule: {ok|warning}
+```
+
+## Priority
+
+Speed > Detail. No DB connection if possible.

package/templates/agents/efcore/migration.md

@@ -0,0 +1,85 @@
+---
+name: efcore-migration
+description: EF Core migration manager - create with smart naming (1 per feature)
+color: magenta
+model: sonnet
+tools: Bash, Glob, Read, Edit
+---
+
+# EF Core Migration Agent
+
+Manages migration creation with the "1 migration per feature" rule.
+
+> **CLAUDE INSTRUCTION:** The `AskUserQuestion({...})` blocks are instructions to use the `AskUserQuestion` tool **interactively**. You MUST execute the tool with these parameters to get the user's response BEFORE continuing.
+
+## Workflow
+
+1. **Analyze** current branch (feature/hotfix/release)
+2. **Extract** version from package.json or *.csproj
+3. **Search** for existing migration for this branch
+4. **If exists**: propose to recreate (delete + create)
+5. **Generate** name: `{Type}_{Version}_{Branch}_{Description}`
+6. **Create** migration with `dotnet ef migrations add`
+7. **Validate** generated content
+
+## Naming Pattern
+
+```
+{BranchType}_{Version}_{BranchName}_{Description}
+```
+
+Examples:
+- `Feature_1_2_0_UserAuth_AddRolesTable`
+- `Hotfix_1_2_1_LoginFix_FixNullEmail`
+- `Release_1_3_0_Initial`
+
+## Commands
+
+```bash
+# Branch
+git branch --show-current
+
+# Version
+grep -oP '"version":\s*"\K[^"]+' package.json
+
+# Existing migrations
+find Migrations -name "*.cs" | grep -v Designer | grep -v Snapshot
+
+# Create
+dotnet ef migrations add $MIGRATION_NAME
+
+# Delete
+rm Migrations/*${OLD_NAME}*.cs
+```
+
+## 1 Migration per Feature Rule
+
+If existing migration detected:
+```javascript
+AskUserQuestion({
+  question: "Existing migration found. Recreate?",
+  options: [
+    "Recreate (recommended)",
+    "Keep and add new",
+    "Cancel"
+  ]
+})
+```
+
+## Output Format
+
+```
+MIGRATION
+  Branch: {branch}
+  Version: {version}
+  Name: {migration_name}
+  Action: {created|recreated}
+  Files: 3 (Migration + Designer + Snapshot)
+```
+
+## Conflict Management
+
+After rebase on develop:
+1. Accept ModelSnapshot from develop
+2. Delete local migration
+3. Recreate with this command

package/templates/agents/efcore/rebase-snapshot.md

@@ -0,0 +1,62 @@
+---
+name: efcore-rebase-snapshot
+description: EF Core snapshot rebaser - resync ModelSnapshot with develop
+color: yellow
+model: sonnet
+tools: Bash, Glob, Read, Edit
+---
+
+# EF Core Rebase-Snapshot Agent
+
+Rebases ModelSnapshot on develop to resolve conflicts.
+
+## Workflow
+
+1. **Backup** all migrations
+2. **Reset** ModelSnapshot to develop
+3. **Delete** branch migrations
+4. **Regenerate** consolidated migration
+5. **Validate** build OK
+
+## Key Commands
+
+```bash
+# Backup
+BACKUP_DIR=".claude/gitflow/backup/migrations/rebase_$(date +%Y%m%d_%H%M%S)"
+mkdir -p "$BACKUP_DIR"
+cp Migrations/*.cs "$BACKUP_DIR/"
+
+# Reset snapshot to develop
+git checkout origin/develop -- Migrations/*ModelSnapshot.cs
+
+# Delete branch migrations
+rm -f Migrations/*Feature_*.cs
+rm -f Migrations/*Feature_*.Designer.cs
+
+# Regenerate
+dotnet ef migrations add Feature_1_7_0_Consolidated
+
+# Validate
+dotnet build
+```
+
+## Migration Naming
+
+```
+{Type}_{Version}_{BranchName}_{Description}
+
+Feature_1_7_0_UserAuth_Consolidated
+Hotfix_1_6_2_LoginFix_Fix
+Release_1_7_0_Initial
+```
+
+## Safety Checks
+
+- [ ] Clean working directory
+- [ ] Backup created
+- [ ] Build OK after rebase
+- [ ] SQL script can be generated
+
+## Priority
+
+Safety > Correctness > Speed. Backup mandatory.

package/templates/agents/efcore/scan.md

@@ -0,0 +1,60 @@
+---
+name: efcore-scan
+description: EF Core cross-branch migration scanner - detect conflicts before they happen
+color: cyan
+model: sonnet
+tools: Bash, Glob, Read
+---
+
+# EF Core Scan Agent
+
+Cross-branch scanner to detect migrations across all active branches.
+
+## Mission
+
+1. **List** all active worktrees
+2. **Scan** migrations in each branch
+3. **Compare** ModelSnapshots with develop
+4. **Analyze** conflict risks
+5. **Recommend** optimal merge order
+
+## Key Commands
+
+```bash
+# List worktrees
+git worktree list
+
+# ModelSnapshot hash
+md5sum Migrations/*ModelSnapshot.cs | cut -d' ' -f1
+
+# Compare with develop
+diff -q local/Snapshot.cs develop/Snapshot.cs
+
+# Count migrations
+find Migrations -name "*.cs" | grep -v Designer | grep -v Snapshot | wc -l
+```
+
+## Risk Levels
+
+| Level | Condition | Action |
+|-------|-----------|--------|
+| NONE | Snapshot = develop | Direct merge OK |
+| LOW | Different tables modified | Merge OK |
+| MEDIUM | FK to same table | Attention to order |
+| HIGH | Same table modified | Rebase required |
+| CRITICAL | Same column modified | Manual intervention |
+
+## Output Format
+
+```
+BRANCHES (n)
+  {branch} | {migrations} | Snapshot: {hash} | Risk: {level}
+
+RECOMMENDATION
+  1. {branch} (reason)
+  2. {branch} (reason)
+```
+
+## Priority
+
+Speed > Accuracy. Read-only, no modifications.

package/templates/agents/efcore/squash.md

@@ -0,0 +1,67 @@
+---
+name: efcore-squash
+description: EF Core migration squasher - combine multiple migrations into one
+color: magenta
+model: sonnet
+tools: Bash, Glob, Read
+---
+
+# EF Core Squash Agent
+
+Merges multiple migrations into one. For releases.
+
+## Workflow
+
+1. **List**: All migrations
+2. **Confirm**: Request user validation
+3. **Backup**: Save all files
+4. **Delete**: Old migrations
+5. **Create**: Consolidated migration
+6. **Script**: Generate idempotent SQL
+7. **Validate**: Build OK
+
+## Key Commands
+
+```bash
+# Backup
+BACKUP_DIR=".claude/gitflow/backup/migrations/squash_$(date +%Y%m%d_%H%M%S)"
+mkdir -p "$BACKUP_DIR"
+cp Migrations/*.cs "$BACKUP_DIR/"
+
+# Delete (except snapshot)
+find Migrations -name "*.cs" -not -name "*Snapshot*" -delete
+
+# Create consolidated
+dotnet ef migrations add Release_${VERSION}_Initial
+
+# SQL Script
+dotnet ef migrations script --idempotent -o scripts/migrations/release.sql
+```
+
+## Safety Checks
+
+- [ ] User confirmation
+- [ ] Backup created
+- [ ] Build OK after squash
+- [ ] SQL script generated
+
+## Output Format
+
+```
+SQUASH
+  Before:  12 migrations
+  After:   1 migration
+  Backup:  .claude/gitflow/backup/migrations/squash_20250102/
+  Script:  scripts/migrations/Release_1_7_0_Initial.sql
+
+WARNING: Production DB - use SQL script
+```
+
+## Production Warning
+
+Never apply directly to a DB that already has migrations.
+Use idempotent SQL script or `--skip-apply`.
+
+## Priority
+
+Safety > Correctness > Speed. Backup mandatory.