@atlashub/smartstack-cli 1.5.0 → 1.5.2

package/package.json

@@ -1,88 +1,88 @@
-{
-  "name": "@atlashub/smartstack-cli",
-  "version": "1.5.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",
-    "jsonwebtoken": "^9.0.3",
-    "ora": "^8.0.1",
-    "zod": "^3.22.4"
-  },
-  "devDependencies": {
-    "@types/fs-extra": "^11.0.4",
-    "@types/inquirer": "^9.0.7",
-    "@types/jsonwebtoken": "^9.0.10",
-    "@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"
-  }
-}
+{
+  "name": "@atlashub/smartstack-cli",
+  "version": "1.5.2",
+  "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",
+    "jsonwebtoken": "^9.0.3",
+    "ora": "^8.0.1",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@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

@@ -1,36 +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)"
+---
+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

@@ -1,84 +1,84 @@
----
-name: efcore-conflicts
-description: EF Core conflict analyzer - BLOCKING if conflict detected
-color: red
-model: sonnet
-tools: Bash, Glob, Read
-mcp: mcp__smartstack__check_migrations
----
-
-# EF Core Conflicts Agent
-
-Analyzes migration conflicts between branches using **SmartStack MCP**. **BLOCKING** if conflict detected.
-
-## Mission
-
-1. **Invoke MCP** `check_migrations` for structured analysis
-2. **Parse** conflict types from response
-3. **Display** results in standard format
-4. **Block** if HIGH or CRITICAL conflict
-
-## MCP Integration
-
-**Primary method:** Use MCP tool for analysis
-
-```
-CALL mcp__smartstack__check_migrations WITH:
-  - branch: {current_branch}
-  - compareBranch: "develop"
-```
-
-**Response structure:**
-
-```typescript
-{
-  hasConflicts: boolean;
-  migrations: MigrationInfo[];
-  conflicts: MigrationConflict[];
-  suggestions: string[];
-}
-```
-
-## Conflict Levels (from MCP)
-
-| MCP Type | Level | Exit Code |
-|----------|-------|-----------|
-| - | NONE | 0 |
-| `naming` | LOW | 0 |
-| `order` | MEDIUM | 0 (warning) |
-| `dependency` | HIGH | 1 (BLOCK) |
-| `snapshot` | CRITICAL | 1 (BLOCK) |
-
-## Fallback (if MCP unavailable)
-
-```bash
-# Compare snapshots directly
-diff develop/Snapshot.cs local/Snapshot.cs
-
-# Extract tables
-grep -oE 'ToTable\("([^"]+)"' Snapshot.cs
-
-# Extract columns
-grep -oE 'Property<[^>]+>\("([^"]+)"' Snapshot.cs
-```
-
-## Required Output
-
-```
-================================================================================
-                    EF CORE CONFLICT ANALYSIS (via MCP)
-================================================================================
-
-STATUS: {OK|WARNING|CONFLICT}
-EXIT CODE: {0|1}
-
-If conflict:
-RESOLUTION:
-  /efcore:rebase-snapshot    (recommended)
-  /efcore:conflicts --force  (not recommended)
-================================================================================
-```
-
-## Priority
-
-Correctness > Speed. Never ignore HIGH/CRITICAL conflicts.
+---
+name: efcore-conflicts
+description: EF Core conflict analyzer - BLOCKING if conflict detected
+color: red
+model: sonnet
+tools: Bash, Glob, Read
+mcp: mcp__smartstack__check_migrations
+---
+
+# EF Core Conflicts Agent
+
+Analyzes migration conflicts between branches using **SmartStack MCP**. **BLOCKING** if conflict detected.
+
+## Mission
+
+1. **Invoke MCP** `check_migrations` for structured analysis
+2. **Parse** conflict types from response
+3. **Display** results in standard format
+4. **Block** if HIGH or CRITICAL conflict
+
+## MCP Integration
+
+**Primary method:** Use MCP tool for analysis
+
+```
+CALL mcp__smartstack__check_migrations WITH:
+  - branch: {current_branch}
+  - compareBranch: "develop"
+```
+
+**Response structure:**
+
+```typescript
+{
+  hasConflicts: boolean;
+  migrations: MigrationInfo[];
+  conflicts: MigrationConflict[];
+  suggestions: string[];
+}
+```
+
+## Conflict Levels (from MCP)
+
+| MCP Type | Level | Exit Code |
+|----------|-------|-----------|
+| - | NONE | 0 |
+| `naming` | LOW | 0 |
+| `order` | MEDIUM | 0 (warning) |
+| `dependency` | HIGH | 1 (BLOCK) |
+| `snapshot` | CRITICAL | 1 (BLOCK) |
+
+## Fallback (if MCP unavailable)
+
+```bash
+# Compare snapshots directly
+diff develop/Snapshot.cs local/Snapshot.cs
+
+# Extract tables
+grep -oE 'ToTable\("([^"]+)"' Snapshot.cs
+
+# Extract columns
+grep -oE 'Property<[^>]+>\("([^"]+)"' Snapshot.cs
+```
+
+## Required Output
+
+```
+================================================================================
+                    EF CORE CONFLICT ANALYSIS (via MCP)
+================================================================================
+
+STATUS: {OK|WARNING|CONFLICT}
+EXIT CODE: {0|1}
+
+If conflict:
+RESOLUTION:
+  /efcore:rebase-snapshot    (recommended)
+  /efcore:conflicts --force  (not recommended)
+================================================================================
+```
+
+## Priority
+
+Correctness > Speed. Never ignore HIGH/CRITICAL conflicts.

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

@@ -1,51 +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.
+---
+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

@@ -1,59 +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
+---
+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