@atlashub/smartstack-cli 4.34.0 → 4.36.0

package/templates/skills/efcore/SKILL.md

@@ -9,92 +9,244 @@ disable-model-invocation: true
 - Preflight: !`if [ -f .git ] && grep -q '^gitdir: [A-Za-z]:' .git 2>/dev/null && grep -qi microsoft /proc/version 2>/dev/null; then p=$(sed 's/^gitdir: //' .git | tr -d '\r\n'); d=$(echo "${p:0:1}" | tr A-Z a-z); r="${p:2}"; r="${r//\\//}"; printf 'gitdir: %s\n' "$(realpath -m --relative-to="$(pwd)" "/mnt/$d$r")" > .git && echo "repaired"; else echo "ok"; fi`
 - Branch: !`git branch --show-current 2>/dev/null || echo "UNAVAILABLE"`
 
-<objective>
-Manage EF Core migrations and database operations. **ALWAYS delegate to Task agents** for fast execution.
-</objective>
+<routing>
+
+Parse `$ARGUMENTS` to determine the command:
+
+| Command | Execution | Model |
+|---------|-----------|-------|
+| `db-status` | **Inline** `<command-db-status>` | — |
+| `db-deploy` | **Inline** `<command-db-deploy>` | — |
+| `db-reset` | **Inline** `<command-db-reset>` | — |
+| `db-seed` | **Inline** `<command-db-seed>` | — |
+| `scan` | **Inline** `<command-scan>` | — |
+| `conflicts` | **Inline** `<command-conflicts>` | — |
+| `migration` | **Agent** `efcore-migration` | sonnet |
+| `squash` | **Agent** `efcore-squash` | sonnet |
+| `rebase-snapshot` | **Agent** `efcore-rebase-snapshot` | sonnet |
+
+**Inline commands:** Execute directly following the matching `<command-*>` section below.
+**Agent commands:** Delegate via Agent tool:
+```
+Agent(
+  subagent_type: "{agent_name}",
+  model: "sonnet",
+  prompt: "Execute /efcore {command} in {cwd}. Branch: {branch}. Flags: {flags}. Description: {description}"
+)
+```
+
+**Flags:** `--context <name>` (CoreDbContext/ExtensionsDbContext), `--force` (skip confirmations)
+
+</routing>
+
+<shared>
+
+### WSL Preflight (MANDATORY before any git command)
 
-<quick_start>
-**Database operations:**
 ```bash
-/efcore db-status          # Check migration status
-/efcore db-deploy          # Apply pending migrations
-/efcore db-reset           # Drop + recreate database
-/efcore db-seed            # Populate with test data
+if [ -f .git ] && grep -q '^gitdir: [A-Za-z]:' .git 2>/dev/null && grep -qi microsoft /proc/version 2>/dev/null; then
+  p=$(sed 's/^gitdir: //' .git | tr -d '\r\n'); d=$(echo "${p:0:1}" | tr A-Z a-z); r="${p:2}"; r="${r//\\//}"
+  printf 'gitdir: %s\n' "$(realpath -m --relative-to="$(pwd)" "/mnt/$d$r")" > .git
+fi
 ```
 
-**Migration operations:**
+### dotnet-ef PATH fix (MANDATORY before any dotnet ef command)
+
 ```bash
-/efcore migration          # Create migration for current branch
-/efcore squash             # Consolidate branch migrations
-/efcore rebase-snapshot    # Sync snapshot with parent branch
-/efcore scan               # Scan for cross-branch conflicts
-/efcore conflicts          # Analyze migration conflicts
+if ! dotnet ef --version &>/dev/null; then
+  for TOOLS_DIR in "$USERPROFILE/.dotnet/tools" "$HOME/.dotnet/tools" "$LOCALAPPDATA/Microsoft/dotnet/tools"; do
+    [ -n "$TOOLS_DIR" ] && [ -d "$TOOLS_DIR" ] && export PATH="$TOOLS_DIR:$PATH"
+  done
+  dotnet ef --version &>/dev/null || { echo "ERROR: dotnet-ef not found. Install: dotnet tool install --global dotnet-ef"; exit 1; }
+fi
 ```
-</quick_start>
 
-<flags>
-| Flag | Description |
-|------|-------------|
-| `--context <name>` | Specify DbContext (CoreDbContext/ExtensionsDbContext) |
-| `--force` | Skip confirmations |
-</flags>
+### Dual DbContext Architecture
 
-<entry_point>
+| Context | DbContext | Schema | History Table |
+|---------|-----------|--------|---------------|
+| `core` | `CoreDbContext` | `core` | `core.__EFMigrationsHistory` |
+| `extensions` | `ExtensionsDbContext` | `extensions` | `extensions.__EFMigrationsHistory` |
+
+**Deploy order:** Core FIRST, then Extensions (FK dependency).
+Both contexts share the same physical database but use different schemas.
+
+### Safety Rules
 
-**ROUTING: ALWAYS delegate to Task agent. Never execute inline.**
+1. **Production BLOCKED** — Never run on production
+2. **Backup MANDATORY** for destructive operations (db-reset, squash)
+3. **1 migration per feature** — Recreate, don't accumulate
+4. **MCP for naming** — Never hardcode migration names
+
+### Migration Naming (MCP MANDATORY)
+
+Pattern: `{context}_v{version}_{sequence}_{Description}`
+**FORBIDDEN:** Manual name calculation. Always use `mcp__smartstack__suggest_migration`.
 
-Parse the command from `$ARGUMENTS` and delegate to the matching agent:
+</shared>
 
-| Command | Task Agent (`subagent_type`) | Model | Description |
-|---------|----------------------------|-------|-------------|
-| `db-status` | `efcore-db-status` | haiku | Fast migration state check |
-| `db-deploy` | `efcore-db-deploy` | haiku | Apply pending migrations |
-| `db-reset` | `efcore-db-reset` | haiku | Drop + recreate database |
-| `db-seed` | `efcore-db-seed` | haiku | Populate with test data |
-| `migration` | `efcore-migration` | sonnet | Create/recreate migration (MCP) |
-| `squash` | `efcore-squash` | sonnet | Consolidate migrations (MCP) |
-| `rebase-snapshot` | `efcore-rebase-snapshot` | sonnet | Sync snapshot with parent (MCP) |
-| `scan` | `efcore-scan` | haiku | Cross-branch conflict scan |
-| `conflicts` | `efcore-conflicts` | haiku | Conflict analysis |
+<command-db-status>
 
-**Delegation template:**
+## db-status — Fast migration state check
+
+**READ-ONLY: Never modify database or migrations.**
+
+1. Call MCP `mcp__smartstack__check_migrations` with `branch: {current_branch}`
+2. If MCP unavailable, fallback: `dotnet ef migrations list --no-build --context {Context}` per context
+3. Display compact summary
 
 ```
-Task(
-  subagent_type: "{agent_name}",
-  prompt: "Execute /efcore {command} in {cwd}. Branch: {branch}. Flags: {flags}",
-  mode: "bypassPermissions"
-)
+EF CORE — DATABASE STATUS
+──────────────────────────
+CORE (CoreDbContext)
+  Migrations: {applied}/{total} | {pending} pending
+
+EXTENSIONS (ExtensionsDbContext)
+  Migrations: {applied}/{total} | {pending} pending
+
+BRANCH: {branch}
+  Naming: {ok|warnings}
+  1-migration rule: {ok|warning}
 ```
 
-**Pass to agent prompt:**
-- Current working directory (absolute path)
-- Current branch name
-- Any flags (--context, --force)
-- User's description (for migration command)
+</command-db-status>
 
-</entry_point>
+<command-db-deploy>
 
-<dual_dbcontext>
-SmartStack uses **two separate DbContexts**:
+## db-deploy — Apply pending migrations
 
-| Context | DbContext | Schema | History Table |
-|---------|-----------|--------|---------------|
-| `core` | `CoreDbContext` | `core` | `core.__EFMigrationsHistory` |
-| `extensions` | `ExtensionsDbContext` | `extensions` | `extensions.__EFMigrationsHistory` |
-</dual_dbcontext>
+**ONLY runs `dotnet ef database update`. Never creates/deletes migrations.**
 
-<naming_convention>
-**Migration naming (MCP MANDATORY):**
+1. Verify `appsettings.Local.json` exists in the API project
+2. Apply Core: `dotnet ef database update --context CoreDbContext --verbose`
+3. Apply Extensions: `dotnet ef database update --context ExtensionsDbContext --verbose`
 
-Pattern: `{context}_v{version}_{sequence}_{Description}`
+If connection fails: suggest verifying SQL Server, appsettings.Local.json, or `/efcore db-reset`.
 
-**FORBIDDEN:** Manual name calculation. Always use `mcp__smartstack__suggest_migration`.
-</naming_convention>
-
-<safety_rules>
-1. **Backup MANDATORY** for destructive operations (db-reset, squash)
-2. **Production BLOCKED** - Never run on production
-3. **1 migration per feature** - Recreate, don't accumulate
-4. **MCP for naming** - Never hardcode migration names
-</safety_rules>
+```
+DB DEPLOY
+  Config: appsettings.Local.json
+  CORE: {n} migration(s) applied — {success|error}
+  EXTENSIONS: {n} migration(s) applied — {success|error|skipped}
+```
+
+</command-db-deploy>
+
+<command-db-reset>
+
+## db-reset — Drop + recreate database (DESTRUCTIVE)
+
+**ONLY operates on database. Never creates/deletes migration files.**
+
+1. **Confirm** (MANDATORY unless `--force`):
+   ```
+   AskUserQuestion({ question: "DELETE the database? All data will be lost.", options: ["Yes, delete", "No, cancel"] })
+   ```
+2. **Backup** (optional): `sqlcmd -S "$SERVER" -E -Q "BACKUP DATABASE [$DB] TO DISK='$FILE' WITH FORMAT, INIT, COMPRESSION"`
+3. **Drop**: `dotnet ef database drop --force`
+4. **Recreate Core**: `dotnet ef database update --context CoreDbContext`
+5. **Recreate Extensions**: `dotnet ef database update --context ExtensionsDbContext`
+6. **Ask** if user wants `/efcore db-seed`
+
+Block if ASPNETCORE_ENVIRONMENT=Production.
+
+```
+DB RESET
+  Backup: {path|none}
+  CORE: {n} migrations applied — {success|error}
+  EXTENSIONS: {n} migrations applied — {success|error}
+
+Next: /efcore db-status, /efcore db-seed
+```
+
+</command-db-reset>
+
+<command-db-seed>
+
+## db-seed — Populate test data
+
+**Never drop or recreate database.**
+
+1. **Detect** seeding method:
+   - `HasData()` in EF configs → apply via `dotnet ef database update --context {Context}`
+   - `IDataSeeder` / `--seed` CLI arg → `dotnet run --project {startup} -- --seed`
+   - SQL script `scripts/seed.sql` → **WARNING**: forbidden by conventions, suggest HasData migration
+2. **Execute** the detected method
+3. **Verify** insertion
+
+```
+DB SEED
+  Method: {hasdata|cli-seed|seeder-class}
+  Status: {success|error}
+  Records: {n} inserted (if available)
+```
+
+</command-db-seed>
+
+<command-scan>
+
+## scan — Cross-branch migration scanner
+
+**READ-ONLY. Uses MCP to detect conflicts across branches.**
+
+1. List active worktrees: `git worktree list`
+2. For each branch, determine base:
+   - `feature/*` → `develop`
+   - `release/*` / `hotfix/*` / `develop` → `main`
+3. Call MCP `mcp__smartstack__check_migrations` with `branch` + `compareBranch` for each
+4. Aggregate risks and recommend merge order
+
+| MCP Type | Level | Action |
+|----------|-------|--------|
+| (none) | NONE | Merge OK |
+| `naming` | LOW | Merge OK |
+| `order` | MEDIUM | Attention |
+| `dependency` | HIGH | Rebase required |
+| `snapshot` | CRITICAL | Manual intervention |
+
+Fallback (MCP unavailable): `git worktree list` + `md5sum Migrations/*ModelSnapshot.cs`
+
+```
+EF CORE CROSS-BRANCH SCAN
+──────────────────────────
+BRANCHES ({n})
+  {branch} | {count} migrations | Risk: {level}
+
+RECOMMENDED MERGE ORDER
+  1. {branch} (reason)
+```
+
+</command-scan>
+
+<command-conflicts>
+
+## conflicts — Migration conflict analyzer (BLOCKING)
+
+**READ-ONLY. Blocks on HIGH/CRITICAL conflicts.**
+
+1. Determine base branch: `feature/*` → `develop`, others → `main`
+2. Call MCP `mcp__smartstack__check_migrations` with `branch` + `compareBranch`
+3. Display results. **EXIT CODE 1** if HIGH or CRITICAL.
+
+| Type | Level | Exit |
+|------|-------|------|
+| (none) | NONE | 0 |
+| `naming` | LOW | 0 |
+| `order` | MEDIUM | 0 (warning) |
+| `dependency` | HIGH | 1 (BLOCK) |
+| `snapshot` | CRITICAL | 1 (BLOCK) |
+
+Fallback (MCP unavailable): `diff` on ModelSnapshot files.
+
+```
+EF CORE CONFLICT ANALYSIS
+─────────────────────────
+STATUS: {OK|WARNING|CONFLICT}
+EXIT CODE: {0|1}
+
+If conflict:
+  /efcore rebase-snapshot  (recommended)
+  /efcore squash           (alternative)
+```
+
+</command-conflicts>

package/templates/agents/efcore/conflicts.md

@@ -1,114 +0,0 @@
----
-name: efcore-conflicts
-description: EF Core conflict analyzer - BLOCKING if conflict detected
-color: red
-model: haiku
-tools: Bash, Glob, Read
----
-
-# EF Core Conflicts Agent
-
-Analyzes migration conflicts between branches using **SmartStack MCP**. **BLOCKING** if conflict detected.
-
-## WSL Preflight (MANDATORY - run BEFORE any git command)
-
-```bash
-# Repair worktree .git file if Windows path detected under WSL
-if [ -f .git ] && grep -q '^gitdir: [A-Za-z]:' .git 2>/dev/null && grep -qi microsoft /proc/version 2>/dev/null; then
-  p=$(sed 's/^gitdir: //' .git | tr -d '\r\n'); d=$(echo "${p:0:1}" | tr A-Z a-z); r="${p:2}"; r="${r//\\//}"
-  printf 'gitdir: %s\n' "$(realpath -m --relative-to="$(pwd)" "/mnt/$d$r")" > .git
-  echo "Worktree .git path repaired for WSL"
-fi
-```
-
-## 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
-
-## Base Branch Determination
-
-**BEFORE calling MCP, determine the correct base branch:**
-
-```bash
-# Determine base branch based on current branch type:
-#   feature/*  → compareBranch: "develop"
-#   release/*  → compareBranch: "main"
-#   hotfix/*   → compareBranch: "main"
-#   develop    → compareBranch: "main"
-CURRENT_BRANCH=$(git branch --show-current)
-case "$CURRENT_BRANCH" in
-  feature/*)  COMPARE_BRANCH="develop" ;;
-  release/*)  COMPARE_BRANCH="main" ;;
-  hotfix/*)   COMPARE_BRANCH="main" ;;
-  develop)    COMPARE_BRANCH="main" ;;
-  *)          COMPARE_BRANCH="develop" ;;
-esac
-```
-
-## MCP Integration
-
-**Primary method:** Use MCP tool for analysis with the **correct base branch**
-
-```
-CALL mcp__smartstack__check_migrations WITH:
-  - branch: {current_branch}
-  - compareBranch: {COMPARE_BRANCH}
-```
-
-**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,86 +0,0 @@
----
-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.
-
-## FORBIDDEN
-
-- **NEVER** create, delete, modify, or recreate migrations (`dotnet ef migrations add/remove` is FORBIDDEN)
-- **NEVER** modify `.cs` files in the Migrations directory
-- This agent ONLY runs `dotnet ef database update` to apply existing migrations
-
-## WSL Preflight (MANDATORY - run BEFORE any git command)
-
-```bash
-# Repair worktree .git file if Windows path detected under WSL
-if [ -f .git ] && grep -q '^gitdir: [A-Za-z]:' .git 2>/dev/null && grep -qi microsoft /proc/version 2>/dev/null; then
-  p=$(sed 's/^gitdir: //' .git | tr -d '\r\n'); d=$(echo "${p:0:1}" | tr A-Z a-z); r="${p:2}"; r="${r//\\//}"
-  printf 'gitdir: %s\n' "$(realpath -m --relative-to="$(pwd)" "/mnt/$d$r")" > .git
-  echo "Worktree .git path repaired for WSL"
-fi
-```
-
-## Workflow
-
-1. **Verify** appsettings.Local.json exists
-2. **Detect** available DbContexts (CoreDbContext, ExtensionsDbContext)
-3. **Count** pending migrations per context
-4. **Apply** migrations in order: Core first, then Extensions
-5. **Confirm** success
-
-## Dual DbContext Order
-
-**IMPORTANT:** Migrations must be applied in order:
-1. **CoreDbContext** first (SmartStack platform tables)
-2. **ExtensionsDbContext** second (client tables that may reference Core)
-
-This ensures FK references from Extensions to Core work correctly.
-
-## Commands
-
-```bash
-# Verify config
-test -f appsettings.Local.json && echo "OK" || echo "MISSING"
-
-# Apply Core migrations first
-dotnet ef database update --context CoreDbContext --verbose
-
-# Then apply Extensions migrations
-dotnet ef database update --context ExtensionsDbContext --verbose
-```
-
-## Output Format
-
-```
-DB DEPLOY
-  Config: appsettings.Local.json
-
-  CORE CONTEXT
-    Applied: {n} migration(s)
-    Status: {success|error}
-
-  EXTENSIONS CONTEXT
-    Applied: {n} migration(s)
-    Status: {success|error|skipped}
-```
-
-## 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,98 +0,0 @@
----
-name: efcore-db-reset
-description: EF Core database reset - drop and recreate (DESTRUCTIVE)
-color: red
-model: haiku
-tools: Bash, Glob, Read
----
-
-# EF Core Database Reset Agent
-
-**WARNING: Destructive operation - deletes all data!**
-
-## FORBIDDEN
-
-- **NEVER** create, delete, modify, or recreate migrations (`dotnet ef migrations add/remove` is FORBIDDEN)
-- **NEVER** modify `.cs` files in the Migrations directory
-- **NEVER** run `dotnet ef migrations` commands of any kind
-- This agent ONLY operates on the **database**, not on migration files
-
-## WSL Preflight (MANDATORY - run BEFORE any git command)
-
-```bash
-# Repair worktree .git file if Windows path detected under WSL
-if [ -f .git ] && grep -q '^gitdir: [A-Za-z]:' .git 2>/dev/null && grep -qi microsoft /proc/version 2>/dev/null; then
-  p=$(sed 's/^gitdir: //' .git | tr -d '\r\n'); d=$(echo "${p:0:1}" | tr A-Z a-z); r="${p:2}"; r="${r//\\//}"
-  printf 'gitdir: %s\n' "$(realpath -m --relative-to="$(pwd)" "/mnt/$d$r")" > .git
-  echo "Worktree .git path repaired for WSL"
-fi
-```
-
-> **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** automatic via sqlcmd (ask user)
-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
-# Backup (before drop - recommended)
-BACKUP_DIR=".claude/gitflow/backup/database"
-mkdir -p "$BACKUP_DIR"
-BACKUP_FILE="${BACKUP_DIR}/${DATABASE_NAME}_$(date +%Y%m%d_%H%M%S).bak"
-sqlcmd -S "$SERVER_NAME" -E -Q "BACKUP DATABASE [$DATABASE_NAME] TO DISK='$BACKUP_FILE' WITH FORMAT, INIT, COMPRESSION"
-
-# Drop (single database, both schemas)
-dotnet ef database drop --force
-
-# Recreate - apply Core first, then Extensions
-dotnet ef database update --context CoreDbContext
-dotnet ef database update --context ExtensionsDbContext
-```
-
-## Dual DbContext Notes
-
-When resetting the database:
-1. **Drop** removes both schemas (core and extensions)
-2. **Recreate Core first** - platform tables
-3. **Then Extensions** - client tables that may reference Core
-
-Both contexts share the same physical database but use different schemas.
-
-## Output Format
-
-```
-DB RESET
-  Action: Drop + Recreate
-  Backup: {.claude/gitflow/backup/database/DB_YYYYMMDD_HHMMSS.bak|none}
-
-  CORE CONTEXT
-    Migrations: {n} applied
-    Schema: core
-    Status: {success|error}
-
-  EXTENSIONS CONTEXT
-    Migrations: {n} applied
-    Schema: extensions
-    Status: {success|error}
-```
-
-## Safety
-
-- ALWAYS ask for confirmation
-- Propose backup
-- Block if ASPNETCORE_ENVIRONMENT=Production

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

@@ -1,73 +0,0 @@
----
-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.
-
-## FORBIDDEN
-
-- **NEVER** create, delete, modify, or recreate migrations (`dotnet ef migrations add/remove` is FORBIDDEN)
-- **NEVER** drop or recreate the database (`dotnet ef database drop` is FORBIDDEN)
-- This agent ONLY seeds data into an existing database
-
-## WSL Preflight (MANDATORY - run BEFORE any git command)
-
-```bash
-# Repair worktree .git file if Windows path detected under WSL
-if [ -f .git ] && grep -q '^gitdir: [A-Za-z]:' .git 2>/dev/null && grep -qi microsoft /proc/version 2>/dev/null; then
-  p=$(sed 's/^gitdir: //' .git | tr -d '\r\n'); d=$(echo "${p:0:1}" | tr A-Z a-z); r="${p:2}"; r="${r//\\//}"
-  printf 'gitdir: %s\n' "$(realpath -m --relative-to="$(pwd)" "/mnt/$d$r")" > .git
-  echo "Worktree .git path repaired for WSL"
-fi
-```
-
-## 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.