safeword 0.8.7 → 0.8.10

package/dist/upgrade-K2FFESUH.js

@@ -0,0 +1,76 @@
+import {
+  compareVersions
+} from "./chunk-FJYRWU2V.js";
+import {
+  SAFEWORD_SCHEMA,
+  createProjectContext,
+  error,
+  exists,
+  header,
+  info,
+  listItem,
+  readFileSafe,
+  reconcile,
+  success,
+  warn
+} from "./chunk-POPS3ZRQ.js";
+import {
+  VERSION
+} from "./chunk-ORQHKDT2.js";
+
+// src/commands/upgrade.ts
+import nodePath from "path";
+function getProjectVersion(safewordDirectory) {
+  const versionPath = nodePath.join(safewordDirectory, "version");
+  return readFileSafe(versionPath)?.trim() ?? "0.0.0";
+}
+function printUpgradeSummary(result, projectVersion) {
+  header("Upgrade Complete");
+  info(`
+Version: v${projectVersion} \u2192 v${VERSION}`);
+  if (result.created.length > 0) {
+    info("\nCreated:");
+    for (const file of result.created) listItem(file);
+  }
+  if (result.updated.length > 0) {
+    info("\nUpdated:");
+    for (const file of result.updated) listItem(file);
+  }
+  if (result.packagesToRemove.length > 0) {
+    warn(`
+${result.packagesToRemove.length} package(s) are now bundled in eslint-plugin-safeword:`);
+    for (const pkg of result.packagesToRemove) listItem(pkg);
+    info("\nIf you don't use these elsewhere, you can remove them:");
+    listItem(`npm uninstall ${result.packagesToRemove.join(" ")}`);
+  }
+  success(`
+Safeword upgraded to v${VERSION}`);
+}
+async function upgrade() {
+  const cwd = process.cwd();
+  const safewordDirectory = nodePath.join(cwd, ".safeword");
+  if (!exists(safewordDirectory)) {
+    error("Not configured. Run `safeword setup` first.");
+    process.exit(1);
+  }
+  const projectVersion = getProjectVersion(safewordDirectory);
+  if (compareVersions(VERSION, projectVersion) < 0) {
+    error(`CLI v${VERSION} is older than project v${projectVersion}.`);
+    error("Update the CLI first: npm install -g safeword");
+    process.exit(1);
+  }
+  header("Safeword Upgrade");
+  info(`Upgrading from v${projectVersion} to v${VERSION}`);
+  try {
+    const ctx = createProjectContext(cwd);
+    const result = await reconcile(SAFEWORD_SCHEMA, "upgrade", ctx);
+    printUpgradeSummary(result, projectVersion);
+  } catch (error_) {
+    error(`Upgrade failed: ${error_ instanceof Error ? error_.message : "Unknown error"}`);
+    process.exit(1);
+  }
+}
+export {
+  upgrade
+};
+//# sourceMappingURL=upgrade-K2FFESUH.js.map

package/dist/upgrade-K2FFESUH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/upgrade.ts"],"sourcesContent":["/**\n * Upgrade command - Update safeword configuration to latest version\n *\n * Uses reconcile() with mode='upgrade' to update all managed files.\n */\n\nimport nodePath from 'node:path';\n\nimport { reconcile, type ReconcileResult } from '../reconcile.js';\nimport { SAFEWORD_SCHEMA } from '../schema.js';\nimport { createProjectContext } from '../utils/context.js';\nimport { exists, readFileSafe } from '../utils/fs.js';\nimport { error, header, info, listItem, success, warn } from '../utils/output.js';\nimport { compareVersions } from '../utils/version.js';\nimport { VERSION } from '../version.js';\n\nfunction getProjectVersion(safewordDirectory: string): string {\n  const versionPath = nodePath.join(safewordDirectory, 'version');\n  return readFileSafe(versionPath)?.trim() ?? '0.0.0';\n}\n\nfunction printUpgradeSummary(result: ReconcileResult, projectVersion: string): void {\n  header('Upgrade Complete');\n  info(`\\nVersion: v${projectVersion} → v${VERSION}`);\n\n  if (result.created.length > 0) {\n    info('\\nCreated:');\n    for (const file of result.created) listItem(file);\n  }\n\n  if (result.updated.length > 0) {\n    info('\\nUpdated:');\n    for (const file of result.updated) listItem(file);\n  }\n\n  if (result.packagesToRemove.length > 0) {\n    warn(`\\n${result.packagesToRemove.length} package(s) are now bundled in eslint-plugin-safeword:`);\n    for (const pkg of result.packagesToRemove) listItem(pkg);\n    info(\"\\nIf you don't use these elsewhere, you can remove them:\");\n    listItem(`npm uninstall ${result.packagesToRemove.join(' ')}`);\n  }\n\n  success(`\\nSafeword upgraded to v${VERSION}`);\n}\n\nexport async function upgrade(): Promise<void> {\n  const cwd = process.cwd();\n  const safewordDirectory = nodePath.join(cwd, '.safeword');\n\n  if (!exists(safewordDirectory)) {\n    error('Not configured. Run `safeword setup` first.');\n    process.exit(1);\n  }\n\n  const projectVersion = getProjectVersion(safewordDirectory);\n\n  if (compareVersions(VERSION, projectVersion) < 0) {\n    error(`CLI v${VERSION} is older than project v${projectVersion}.`);\n    error('Update the CLI first: npm install -g safeword');\n    process.exit(1);\n  }\n\n  header('Safeword Upgrade');\n  info(`Upgrading from v${projectVersion} to v${VERSION}`);\n\n  try {\n    const ctx = createProjectContext(cwd);\n    const result = await reconcile(SAFEWORD_SCHEMA, 'upgrade', ctx);\n    printUpgradeSummary(result, projectVersion);\n  } catch (error_) {\n    error(`Upgrade failed: ${error_ instanceof Error ? error_.message : 'Unknown error'}`);\n    process.exit(1);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAMA,OAAO,cAAc;AAUrB,SAAS,kBAAkB,mBAAmC;AAC5D,QAAM,cAAc,SAAS,KAAK,mBAAmB,SAAS;AAC9D,SAAO,aAAa,WAAW,GAAG,KAAK,KAAK;AAC9C;AAEA,SAAS,oBAAoB,QAAyB,gBAA8B;AAClF,SAAO,kBAAkB;AACzB,OAAK;AAAA,YAAe,cAAc,YAAO,OAAO,EAAE;AAElD,MAAI,OAAO,QAAQ,SAAS,GAAG;AAC7B,SAAK,YAAY;AACjB,eAAW,QAAQ,OAAO,QAAS,UAAS,IAAI;AAAA,EAClD;AAEA,MAAI,OAAO,QAAQ,SAAS,GAAG;AAC7B,SAAK,YAAY;AACjB,eAAW,QAAQ,OAAO,QAAS,UAAS,IAAI;AAAA,EAClD;AAEA,MAAI,OAAO,iBAAiB,SAAS,GAAG;AACtC,SAAK;AAAA,EAAK,OAAO,iBAAiB,MAAM,wDAAwD;AAChG,eAAW,OAAO,OAAO,iBAAkB,UAAS,GAAG;AACvD,SAAK,0DAA0D;AAC/D,aAAS,iBAAiB,OAAO,iBAAiB,KAAK,GAAG,CAAC,EAAE;AAAA,EAC/D;AAEA,UAAQ;AAAA,wBAA2B,OAAO,EAAE;AAC9C;AAEA,eAAsB,UAAyB;AAC7C,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,oBAAoB,SAAS,KAAK,KAAK,WAAW;AAExD,MAAI,CAAC,OAAO,iBAAiB,GAAG;AAC9B,UAAM,6CAA6C;AACnD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,iBAAiB,kBAAkB,iBAAiB;AAE1D,MAAI,gBAAgB,SAAS,cAAc,IAAI,GAAG;AAChD,UAAM,QAAQ,OAAO,2BAA2B,cAAc,GAAG;AACjE,UAAM,+CAA+C;AACrD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,SAAO,kBAAkB;AACzB,OAAK,mBAAmB,cAAc,QAAQ,OAAO,EAAE;AAEvD,MAAI;AACF,UAAM,MAAM,qBAAqB,GAAG;AACpC,UAAM,SAAS,MAAM,UAAU,iBAAiB,WAAW,GAAG;AAC9D,wBAAoB,QAAQ,cAAc;AAAA,EAC5C,SAAS,QAAQ;AACf,UAAM,mBAAmB,kBAAkB,QAAQ,OAAO,UAAU,eAAe,EAAE;AACrF,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "safeword",
-  "version": "0.8.7",
+  "version": "0.8.10",
   "description": "CLI for setting up and managing safeword development environments",
   "type": "module",
   "bin": {
@@ -23,7 +23,7 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
-    "test:e2e": "vitest run tests/e2e/",
+    "test:integration": "vitest run tests/integration/",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",

package/templates/SAFEWORD.md

@@ -86,6 +86,7 @@ Training data is stale. Follow this sequence:
 | Test definitions | `.safeword/planning/test-definitions/` | `feature-*.md` (L2 features only) |
 | Design docs      | `.safeword/planning/design/`           | Complex features (3+ components)  |
 | Issues           | `.safeword/planning/issues/`           | Issue tracking                    |
+| Execution plans  | `.safeword/planning/plans/`            | LLM-ready task breakdowns         |
 
 **Artifact Levels:**
 
@@ -311,7 +312,9 @@ When markdown lint reports MD040 (missing language), choose:
 
 1. **Clarity → Simplicity → Correctness** (in that order)
 2. **Test what you can test**—never ask user to verify
-3. **RED → GREEN → REFACTOR**—never skip steps
+3. **ALWAYS USE STRICT TDD: RED → GREEN → REFACTOR**—never skip steps
 4. **Commit after each GREEN phase**
 5. **Read the matching guide** when a trigger fires
-6. **End every response** with: `{"proposedChanges": bool, "madeChanges": bool, "askedQuestion": bool}`
+6. **Always read the latest documentation for the relevant tool**
+7. **AVOID BLOAT**
+8. **End every response** with: `{"proposedChanges": bool, "madeChanges": bool, "askedQuestion": bool}`

package/templates/commands/cleanup-zombies.md

@@ -0,0 +1,48 @@
+---
+description: Kill zombie dev servers and test processes for this project
+---
+
+# Cleanup Zombies
+
+Kill zombie processes (dev servers, Playwright browsers, test runners) for the current project only. Safe to use in multi-project environments.
+
+## Instructions
+
+Run the cleanup script with `--dry-run` first to preview what will be killed:
+
+```bash
+./.safeword/scripts/cleanup-zombies.sh --dry-run
+```
+
+If the output looks correct, run without `--dry-run`:
+
+```bash
+./.safeword/scripts/cleanup-zombies.sh
+```
+
+## What It Does
+
+1. **Auto-detects framework** - Finds port from vite.config.ts, next.config.js, etc. (checks root, `packages/*/`, `apps/*/` for monorepos)
+2. **Kills by port** - Dev server port AND test port (port + 1000)
+3. **Kills test processes** - Playwright, Chromium, Electron (scoped to this project)
+4. **Multi-project safe** - Only kills processes matching this project's directory
+
+## Manual Override
+
+If auto-detection fails or you need a specific port:
+
+```bash
+# Explicit port
+./.safeword/scripts/cleanup-zombies.sh 5173
+
+# Port + additional pattern
+./.safeword/scripts/cleanup-zombies.sh 5173 "electron"
+```
+
+## When to Use
+
+- Port already in use when starting dev server
+- Tests hanging or failing due to zombie processes
+- Switching between projects
+- Before running E2E tests
+- After interrupted test runs

package/templates/guides/cli-reference.md

@@ -4,14 +4,13 @@ Commands for managing safeword in projects.
 
 ## Commands
 
-| Command                       | Purpose                                        |
-| ----------------------------- | ---------------------------------------------- |
-| `npx safeword@latest setup`   | Install safeword in current project            |
-| `npx safeword@latest check`   | Check project health and versions              |
-| `npx safeword@latest upgrade` | Upgrade to latest version                      |
-| `npx safeword@latest diff`    | Preview changes before upgrading               |
-| `npx safeword sync`           | Sync linting plugins with project dependencies |
-| `npx safeword reset`          | Remove safeword from project                   |
+| Command                       | Purpose                           |
+| ----------------------------- | --------------------------------- |
+| `npx safeword@latest setup`   | Install safeword in current project |
+| `npx safeword@latest check`   | Check project health and versions |
+| `npx safeword@latest upgrade` | Upgrade to latest version         |
+| `npx safeword@latest diff`    | Preview changes before upgrading  |
+| `npx safeword reset`          | Remove safeword from project      |
 
 ## When to Use
 
@@ -21,7 +20,6 @@ Commands for managing safeword in projects.
 | Check if update available  | `npx safeword@latest check`   |
 | Update after CLI release   | `npx safeword@latest upgrade` |
 | See what upgrade changes   | `npx safeword@latest diff`    |
-| Added/removed framework    | `npx safeword sync`           |
 | Remove safeword completely | `npx safeword reset --full`   |
 
 ## Options
@@ -32,12 +30,12 @@ Common flags:
 
 - `-y, --yes` - Skip confirmations (setup, reset)
 - `-v, --verbose` - Show detailed output (diff)
-- `-q, --quiet` - Suppress output (sync)
+- `--offline` - Skip remote version check (check)
+- `--full` - Also remove linting config + packages (reset)
 
 ---
 
 ## Key Takeaways
 
 - Always use `@latest` for setup/check/upgrade/diff to get current CLI
-- Run `sync` after adding/removing frameworks to update linting plugins
 - Use `diff` before `upgrade` to preview changes

package/templates/guides/zombie-process-cleanup.md

@@ -4,6 +4,24 @@
 
 ---
 
+## Quick Start
+
+Use the built-in cleanup script:
+
+```bash
+# Preview what would be killed (safe)
+./.safeword/scripts/cleanup-zombies.sh --dry-run
+
+# Kill zombie processes
+./.safeword/scripts/cleanup-zombies.sh
+```
+
+The script auto-detects your framework (Vite, Next.js, etc.) and kills only processes belonging to this project.
+
+For manual control or debugging, see the detailed sections below.
+
+---
+
 ## The Problem
 
 When running dev servers and E2E tests across multiple projects, zombie processes accumulate:
@@ -52,35 +70,32 @@ sleep 2
 
 ---
 
-## Project-Specific Cleanup Script
+## Built-in Cleanup Script
 
-For frequent cleanup needs, create `scripts/cleanup.sh` in each project:
+Safeword includes a cleanup script at `.safeword/scripts/cleanup-zombies.sh`:
 
 ```bash
-#!/bin/bash
-# scripts/cleanup.sh - Kill only THIS project's processes
-
-DEV_PORT=3000                    # Dev server port (change per project)
-TEST_PORT=$((DEV_PORT + 1000))   # Test server port (Playwright managed)
-PROJECT_DIR="$(pwd)"
+# Auto-detect framework and clean up
+./.safeword/scripts/cleanup-zombies.sh
 
-echo "Cleaning up $PROJECT_DIR (dev: $DEV_PORT, test: $TEST_PORT)..."
+# Preview first (recommended)
+./.safeword/scripts/cleanup-zombies.sh --dry-run
 
-# Kill both dev and test servers by port
-lsof -ti:$DEV_PORT -ti:$TEST_PORT | xargs kill -9 2>/dev/null
+# Explicit port override
+./.safeword/scripts/cleanup-zombies.sh 5173
 
-# Kill Playwright browsers for this project
-ps aux | grep -E "(playwright|chromium)" | grep "$PROJECT_DIR" | grep -v grep | awk '{print $2}' | xargs kill -9 2>/dev/null
-
-# Kill test runners
-pgrep -f "playwright test.*$(basename $PROJECT_DIR)" | xargs kill -9 2>/dev/null
-
-echo "Cleanup complete!"
+# Port + additional pattern
+./.safeword/scripts/cleanup-zombies.sh 5173 "electron"
 ```
 
-**Make executable:** `chmod +x scripts/cleanup.sh`
+**Features:**
+
+- Auto-detects port from config files (vite.config.ts, next.config.js, etc.)
+- Kills dev port AND test port (port + 1000)
+- Scopes all pattern matching to current project directory
+- `--dry-run` shows what would be killed without killing
 
-**Usage:** `./scripts/cleanup.sh`
+**Supported frameworks:** Vite, Next.js, Nuxt, SvelteKit, Astro, Angular
 
 ---
 
@@ -197,9 +212,10 @@ ps aux | grep "/Users/alex/projects/my-project"
 
 | Situation                                | Command                                                          |
 | ---------------------------------------- | ---------------------------------------------------------------- |
+| Quick cleanup (recommended)              | `./.safeword/scripts/cleanup-zombies.sh`                         |
+| Preview before killing                   | `./.safeword/scripts/cleanup-zombies.sh --dry-run`               |
 | Kill dev + test servers (use your ports) | `lsof -ti:$DEV_PORT -ti:$TEST_PORT \| xargs kill -9 2>/dev/null` |
 | Kill Playwright (this project)           | `pkill -f "playwright.*$(pwd)"`                                  |
-| Kill all for this project                | `./scripts/cleanup.sh`                                           |
 | Check what's on port                     | `lsof -i:3000`                                                   |
 | Find zombie processes                    | `ps aux \| grep -E "(node\|playwright\|chromium)"`               |
 | Preview what `pkill -f` would kill       | `pgrep -f "pattern"` (verify before running pkill)               |
@@ -224,7 +240,7 @@ ps aux | grep "/Users/alex/projects/my-project"
 
 ## Key Takeaways
 
-- Use port-based cleanup, not `killall node` (affects all projects)
-- Filter by project directory: `pkill -f "playwright.*$(pwd)"`
+- Use `./.safeword/scripts/cleanup-zombies.sh` for quick, safe cleanup
+- Always preview with `--dry-run` first when unsure
+- Never use `killall node` (affects all projects)
 - Clean up before AND after development sessions
-- Create project-specific `scripts/cleanup.sh` for consistent cleanup

package/templates/scripts/cleanup-zombies.sh

@@ -0,0 +1,222 @@
+#!/bin/bash
+# Cleanup zombie processes: Kill dev servers and test processes for THIS project
+#
+# Use when: Port in use after tests, dev server won't start, zombie node/playwright
+# processes, need to clean up before running tests, switching between projects
+#
+# Auto-detection: Checks root, packages/*/, apps/*/ for framework configs (monorepo support)
+#
+# Usage: ./cleanup-zombies.sh [port] [pattern]
+# Example: ./cleanup-zombies.sh                    # auto-detect from config files
+# Example: ./cleanup-zombies.sh 5173               # explicit port
+# Example: ./cleanup-zombies.sh 5173 "vite"        # port + pattern
+# Example: ./cleanup-zombies.sh --dry-run          # preview what would be killed
+# Example: ./cleanup-zombies.sh --dry-run 5173     # preview with explicit port
+
+set -e
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+NC='\033[0m' # No Color
+
+# Parse arguments
+DRY_RUN=false
+PORT=""
+PATTERN=""
+
+for arg in "$@"; do
+  case "$arg" in
+    --dry-run)
+      DRY_RUN=true
+      ;;
+    --help|-h)
+      echo "Usage: $0 [--dry-run] [port] [pattern]"
+      echo ""
+      echo "Cleanup zombie processes for the current project."
+      echo ""
+      echo "Options:"
+      echo "  --dry-run    Show what would be killed without killing"
+      echo "  --help       Show this help message"
+      echo ""
+      echo "Arguments:"
+      echo "  port         Port number (auto-detected if not provided)"
+      echo "  pattern      Additional process pattern to match"
+      echo ""
+      echo "Examples:"
+      echo "  $0                     # Auto-detect port from config files"
+      echo "  $0 5173                # Kill processes on port 5173"
+      echo "  $0 5173 electron       # Port 5173 + electron processes"
+      echo "  $0 --dry-run           # Preview without killing"
+      exit 0
+      ;;
+    *)
+      if [ -z "$PORT" ] && [[ "$arg" =~ ^[0-9]+$ ]]; then
+        PORT="$arg"
+      elif [ -z "$PATTERN" ]; then
+        PATTERN="$arg"
+      fi
+      ;;
+  esac
+done
+
+# Check if any file matching pattern exists (supports globs)
+has_config() {
+  local pattern=$1
+  # Check root first, then common monorepo locations
+  compgen -G "$pattern" >/dev/null 2>&1 && return 0
+  compgen -G "packages/*/$pattern" >/dev/null 2>&1 && return 0
+  compgen -G "apps/*/$pattern" >/dev/null 2>&1 && return 0
+  return 1
+}
+
+# Auto-detect port from framework config files
+detect_port() {
+  if has_config "vite.config.*"; then
+    echo "5173"
+  elif has_config "next.config.*"; then
+    echo "3000"
+  elif has_config "nuxt.config.*"; then
+    echo "3000"
+  elif has_config "svelte.config.js"; then
+    echo "5173"
+  elif has_config "astro.config.*"; then
+    echo "4321"
+  elif has_config "angular.json"; then
+    echo "4200"
+  else
+    echo ""
+  fi
+}
+
+# Auto-detect framework pattern
+detect_pattern() {
+  if has_config "vite.config.*"; then
+    echo "vite"
+  elif has_config "next.config.*"; then
+    echo "next"
+  elif has_config "nuxt.config.*"; then
+    echo "nuxt"
+  else
+    echo ""
+  fi
+}
+
+# Use auto-detection if not provided
+if [ -z "$PORT" ]; then
+  PORT=$(detect_port)
+fi
+
+if [ -z "$PATTERN" ]; then
+  PATTERN=$(detect_pattern)
+fi
+
+PROJECT_DIR="$(pwd)"
+PROJECT_NAME="$(basename "$PROJECT_DIR")"
+
+echo "Cleanup zombies for: $PROJECT_NAME"
+echo "   Directory: $PROJECT_DIR"
+[ -n "$PORT" ] && echo "   Port: $PORT (+ test port $((PORT + 1000)))"
+[ -n "$PATTERN" ] && echo "   Pattern: $PATTERN"
+$DRY_RUN && echo -e "   ${YELLOW}DRY RUN - no processes will be killed${NC}"
+echo ""
+
+# Track what we find/kill
+FOUND_COUNT=0
+KILLED_COUNT=0
+
+# Function to find and optionally kill processes by port
+cleanup_port() {
+  local port=$1
+  local pids
+  pids=$(lsof -ti:"$port" 2>/dev/null || true)
+
+  if [ -n "$pids" ]; then
+    local count
+    count=$(echo "$pids" | wc -l | tr -d ' ')
+    FOUND_COUNT=$((FOUND_COUNT + count))
+
+    echo "Port $port: $count process(es)"
+    for pid in $pids; do
+      local cmd
+      cmd=$(ps -p "$pid" -o command= 2>/dev/null | head -c 80 || echo "unknown")
+      echo "  PID $pid: $cmd"
+    done
+
+    if [ "$DRY_RUN" = false ]; then
+      echo "$pids" | xargs kill -9 2>/dev/null || true
+      KILLED_COUNT=$((KILLED_COUNT + count))
+    fi
+  fi
+}
+
+# Function to find and optionally kill processes by pattern (scoped to project)
+cleanup_pattern() {
+  local pattern=$1
+  local pids
+  # Match pattern AND project directory for safety
+  pids=$(pgrep -f "$pattern.*$PROJECT_DIR" 2>/dev/null || pgrep -f "$PROJECT_DIR.*$pattern" 2>/dev/null || true)
+
+  if [ -n "$pids" ]; then
+    local count
+    count=$(echo "$pids" | wc -l | tr -d ' ')
+    FOUND_COUNT=$((FOUND_COUNT + count))
+
+    echo "Pattern '$pattern' (project-scoped): $count process(es)"
+    for pid in $pids; do
+      local cmd
+      cmd=$(ps -p "$pid" -o command= 2>/dev/null | head -c 80 || echo "unknown")
+      echo "  PID $pid: $cmd"
+    done
+
+    if [ "$DRY_RUN" = false ]; then
+      echo "$pids" | xargs kill -9 2>/dev/null || true
+      KILLED_COUNT=$((KILLED_COUNT + count))
+    fi
+  fi
+}
+
+# 1. Kill by port (dev server)
+if [ -n "$PORT" ]; then
+  cleanup_port "$PORT"
+
+  # Also kill test port (dev port + 1000, common convention)
+  TEST_PORT=$((PORT + 1000))
+  cleanup_port "$TEST_PORT"
+fi
+
+# 2. Kill Playwright/test processes scoped to this project
+cleanup_pattern "playwright"
+cleanup_pattern "chromium"
+cleanup_pattern "electron"
+
+# 3. Kill framework-specific processes scoped to this project
+if [ -n "$PATTERN" ]; then
+  cleanup_pattern "$PATTERN"
+fi
+
+# 4. Wait for cleanup
+if [ "$DRY_RUN" = false ] && [ "$KILLED_COUNT" -gt 0 ]; then
+  sleep 2
+fi
+
+# 5. Summary
+echo ""
+if [ "$FOUND_COUNT" -eq 0 ]; then
+  echo -e "${GREEN}No zombie processes found - already clean!${NC}"
+elif [ "$DRY_RUN" = true ]; then
+  echo -e "${YELLOW}Found $FOUND_COUNT process(es) that would be killed${NC}"
+  echo "   Run without --dry-run to kill them"
+else
+  echo -e "${GREEN}Killed $KILLED_COUNT process(es)${NC}"
+
+  # Verify port is free
+  if [ -n "$PORT" ]; then
+    if lsof -i:"$PORT" >/dev/null 2>&1; then
+      echo -e "${YELLOW}Warning: Port $PORT still in use${NC}"
+      lsof -i:"$PORT"
+    else
+      echo "   Port $PORT is now free"
+    fi
+  fi
+fi

package/dist/check-PPVIEF3Q.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/check.ts"],"sourcesContent":["/**\n * Check command - Verify project health and configuration\n *\n * Uses reconcile() with dryRun to detect missing files and configuration issues.\n */\n\nimport { join } from 'node:path';\nimport { VERSION } from '../version.js';\nimport { exists, readFileSafe } from '../utils/fs.js';\nimport { info, success, warn, header, keyValue } from '../utils/output.js';\nimport { isNewerVersion } from '../utils/version.js';\nimport { createProjectContext } from '../utils/context.js';\nimport { reconcile } from '../reconcile.js';\nimport { SAFEWORD_SCHEMA } from '../schema.js';\n\nexport interface CheckOptions {\n  offline?: boolean;\n}\n\n/** Check for missing files from write actions */\nfunction findMissingFiles(cwd: string, actions: { type: string; path: string }[]): string[] {\n  const issues: string[] = [];\n  for (const action of actions) {\n    if (action.type === 'write' && !exists(join(cwd, action.path))) {\n      issues.push(`Missing: ${action.path}`);\n    }\n  }\n  return issues;\n}\n\n/** Check for missing text patch markers */\nfunction findMissingPatches(\n  cwd: string,\n  actions: { type: string; path: string; definition?: { marker: string } }[],\n): string[] {\n  const issues: string[] = [];\n  for (const action of actions) {\n    if (action.type !== 'text-patch') continue;\n\n    const fullPath = join(cwd, action.path);\n    if (!exists(fullPath)) {\n      issues.push(`${action.path} file missing`);\n    } else {\n      const content = readFileSafe(fullPath) ?? '';\n      if (action.definition && !content.includes(action.definition.marker)) {\n        issues.push(`${action.path} missing safeword link`);\n      }\n    }\n  }\n  return issues;\n}\n\ninterface HealthStatus {\n  configured: boolean;\n  projectVersion: string | null;\n  cliVersion: string;\n  updateAvailable: boolean;\n  latestVersion: string | null;\n  issues: string[];\n  missingPackages: string[];\n}\n\n/**\n * Check for latest version from npm (with timeout)\n */\nasync function checkLatestVersion(timeout = 3000): Promise<string | null> {\n  try {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n    const response = await fetch('https://registry.npmjs.org/safeword/latest', {\n      signal: controller.signal,\n    });\n\n    clearTimeout(timeoutId);\n\n    if (!response.ok) return null;\n\n    const data = (await response.json()) as { version?: string };\n    return data.version ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Check project configuration health using reconcile dryRun\n */\nasync function checkHealth(cwd: string): Promise<HealthStatus> {\n  const safewordDir = join(cwd, '.safeword');\n\n  // Check if configured\n  if (!exists(safewordDir)) {\n    return {\n      configured: false,\n      projectVersion: null,\n      cliVersion: VERSION,\n      updateAvailable: false,\n      latestVersion: null,\n      issues: [],\n      missingPackages: [],\n    };\n  }\n\n  // Read project version\n  const versionPath = join(safewordDir, 'version');\n  const projectVersion = readFileSafe(versionPath)?.trim() ?? null;\n\n  // Use reconcile with dryRun to detect issues\n  const ctx = createProjectContext(cwd);\n  const result = await reconcile(SAFEWORD_SCHEMA, 'upgrade', ctx, { dryRun: true });\n\n  // Collect issues from write actions and text patches\n  const issues: string[] = [\n    ...findMissingFiles(cwd, result.actions),\n    ...findMissingPatches(cwd, result.actions),\n  ];\n\n  // Check for missing .claude/settings.json\n  if (!exists(join(cwd, '.claude', 'settings.json'))) {\n    issues.push('Missing: .claude/settings.json');\n  }\n\n  return {\n    configured: true,\n    projectVersion,\n    cliVersion: VERSION,\n    updateAvailable: false,\n    latestVersion: null,\n    issues,\n    missingPackages: result.packagesToInstall,\n  };\n}\n\n/** Check for CLI updates and report status */\nasync function reportUpdateStatus(health: HealthStatus): Promise<void> {\n  info('\\nChecking for updates...');\n  const latestVersion = await checkLatestVersion();\n\n  if (!latestVersion) {\n    warn(\"Couldn't check for updates (offline?)\");\n    return;\n  }\n\n  health.latestVersion = latestVersion;\n  health.updateAvailable = isNewerVersion(health.cliVersion, latestVersion);\n\n  if (health.updateAvailable) {\n    warn(`Update available: v${latestVersion}`);\n    info('Run `npm install -g safeword` to upgrade');\n  } else {\n    success('CLI is up to date');\n  }\n}\n\n/** Compare project version vs CLI version and report */\nfunction reportVersionMismatch(health: HealthStatus): void {\n  if (!health.projectVersion) return;\n\n  if (isNewerVersion(health.cliVersion, health.projectVersion)) {\n    warn(`Project config (v${health.projectVersion}) is newer than CLI (v${health.cliVersion})`);\n    info('Consider upgrading the CLI');\n  } else if (isNewerVersion(health.projectVersion, health.cliVersion)) {\n    info(`\\nUpgrade available for project config`);\n    info(\n      `Run \\`safeword upgrade\\` to update from v${health.projectVersion} to v${health.cliVersion}`,\n    );\n  }\n}\n\n/** Report issues or success */\nfunction reportHealthSummary(health: HealthStatus): void {\n  if (health.issues.length > 0) {\n    header('Issues Found');\n    for (const issue of health.issues) {\n      warn(issue);\n    }\n    info('\\nRun `safeword upgrade` to repair configuration');\n    return;\n  }\n\n  if (health.missingPackages.length > 0) {\n    header('Missing Packages');\n    info(`${health.missingPackages.length} linting packages not installed`);\n    info('Run `safeword sync` to install missing packages');\n    return;\n  }\n\n  success('\\nConfiguration is healthy');\n}\n\nexport async function check(options: CheckOptions): Promise<void> {\n  const cwd = process.cwd();\n\n  header('Safeword Health Check');\n\n  const health = await checkHealth(cwd);\n\n  // Not configured\n  if (!health.configured) {\n    info('Not configured. Run `safeword setup` to initialize.');\n    return;\n  }\n\n  // Show versions\n  keyValue('Safeword CLI', `v${health.cliVersion}`);\n  keyValue('Project config', health.projectVersion ? `v${health.projectVersion}` : 'unknown');\n\n  // Check for updates (unless offline)\n  if (options.offline) {\n    info('\\nSkipped update check (offline mode)');\n  } else {\n    await reportUpdateStatus(health);\n  }\n\n  reportVersionMismatch(health);\n  reportHealthSummary(health);\n}\n"],"mappings":"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","names":[]}