@codyswann/lisa 1.9.0 → 1.9.3

package/all/copy-overwrite/.claude/commands/project/plan.md

@@ -109,24 +109,29 @@ For each task, use **TaskCreate** with:
 [Or "N/A - no user-facing changes"]
 
 ## Verification
+
+Every task MUST have empirical verification - a command that proves the work is done.
+
+**Why?** Code that "looks correct" often isn't. The only way to know something works is to run it and observe the result. Verification isn't "I wrote the code" - it's running a command and seeing expected output.
+
 **Type:** `test` | `ui-recording` | `test-coverage` | `api-test` | `manual-check` | `documentation`
 
 | Type | When to Use | Example |
 |------|-------------|---------|
-| `test` | Run specific tests | `bun run test -- src/services/user.spec.ts` |
-| `ui-recording` | UI/UX changes | `bun run playwright:test ...` |
-| `test-coverage` | Coverage threshold | `bun run test:cov -- --collectCoverageFrom='...'` |
-| `api-test` | API endpoints | `./scripts/verify/<task-name>.sh` |
-| `documentation` | Docs, README | `cat path/to/doc.md` |
-| `manual-check` | Config, setup | Command showing config exists |
+| `test` | Run specific tests | `npm test -- src/services/user.spec.ts` |
+| `ui-recording` | UI/UX changes | `npm run playwright:test ...` |
+| `test-coverage` | Coverage threshold | `npm run test:cov -- --collectCoverageFrom='...'` |
+| `api-test` | API endpoints | `curl -s http://localhost:3000/api/endpoint` |
+| `documentation` | Docs, README | `cat path/to/doc.md \| grep "expected content"` |
+| `manual-check` | Config, setup | `cat config.json \| jq '.setting'` |
 
 **Proof Command:**
 ```bash
-[Single command to verify completion]
+[Single command that outputs observable proof of completion]
 ```
 
 **Expected Output:**
-[What success looks like]
+[Exact or pattern-matched output that proves success]
 
 ## Learnings
 During implementation, collect any discoveries valuable for future developers:

package/all/copy-overwrite/.claude/commands/project/setup.md

@@ -34,7 +34,7 @@ Based on input type:
 
 2. Create `brief.md` in the project directory:
    - Jira: populate with issue number, title, and description
-   - File: move/copy the file and rename to `brief.md`
+   - File: copy contents of the file to `brief.md`
    - Text prompt: create `brief.md` with the prompt text as content
 
 3. Create empty `findings.md` in the project directory

package/all/copy-overwrite/.claude/hooks/README.md

@@ -356,6 +356,63 @@ The hook is configured in `.claude/settings.json`:
 
 ntfy.sh topics are public by default. Use a unique, hard-to-guess topic name. For private notifications, you can [self-host ntfy](https://docs.ntfy.sh/install/) or use [ntfy.sh access control](https://docs.ntfy.sh/publish/#access-control).
 
+---
+
+### pre-push.sh
+
+**Type**: Pre-push git hook (blocking)
+**Trigger**: Before `git push` executes
+**Purpose**: Runs slow ESLint rules to catch linting issues before pushing to remote
+
+#### How it works
+
+1. Checks if the project has a `lint:slow` script defined in `package.json`
+2. Detects the project's package manager from lock files (bun, pnpm, yarn, npm)
+3. Runs the slow lint rules using the detected package manager
+4. If lint:slow passes, allows the push to proceed
+5. If lint:slow fails, blocks the push with an error message
+
+#### Features
+
+- **Blocking enforcement**: Prevents pushes with linting issues
+- **Package manager detection**: Uses the project's configured package manager
+- **Graceful skip**: If lint:slow script doesn't exist, skips silently without blocking
+- **Clear feedback**: Shows which rules failed for easy fixing
+- **Works with all package managers**: npm, yarn, pnpm, bun
+
+#### Configuration
+
+The hook is automatically registered via git when Lisa is applied. To manually configure or troubleshoot:
+
+```bash
+# Verify the hook is installed
+ls -la .git/hooks/pre-push
+
+# Run the hook manually to test
+./.claude/hooks/pre-push.sh
+
+# Bypass the hook (not recommended, only for emergencies)
+git push --no-verify
+```
+
+#### Typical Workflow
+
+1. Make code changes
+2. Run `git push`
+3. Pre-push hook runs slow lint rules
+4. If issues found: hook blocks push, shows errors, exit with code 1
+5. Fix the issues
+6. Run `git push` again
+7. If all clear: push proceeds normally
+
+#### Notes
+
+- This hook enforces blocking behavior (exits with code 1 on failure) to prevent pushing code with issues
+- The hook respects the project's package manager configuration
+- Only runs if a `lint:slow` script is defined in package.json (gracefully skips otherwise)
+
+---
+
 ## Adding New Hooks
 
 To add a new hook:

package/all/copy-overwrite/.claude/hooks/pre-push.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# This file is managed by Lisa.
+# Do not edit directly — changes will be overwritten on the next `lisa` run.
+
+# Hook script to run slow lint rules before pushing
+# Blocks push if lint:slow fails, preventing pushes with linting issues
+# Reference: https://docs.claude.com/en/docs/claude-code/hooks
+
+# Check if package.json has lint:slow script
+if ! grep -q '"lint:slow"' package.json 2>/dev/null; then
+    echo "ℹ Skipping lint:slow: lint:slow script not found in package.json"
+    exit 0
+fi
+
+# Detect package manager based on lock file presence
+detect_package_manager() {
+    if [ -f "bun.lockb" ] || [ -f "bun.lock" ]; then
+        echo "bun"
+    elif [ -f "pnpm-lock.yaml" ]; then
+        echo "pnpm"
+    elif [ -f "yarn.lock" ]; then
+        echo "yarn"
+    elif [ -f "package-lock.json" ]; then
+        echo "npm"
+    else
+        echo "npm"  # Default fallback
+    fi
+}
+
+PKG_MANAGER=$(detect_package_manager)
+
+echo "🐢 Running slow lint rules before push..."
+
+# Run lint:slow - exit code matters here, we want to block the push if it fails
+if $PKG_MANAGER run lint:slow; then
+    echo "✓ Slow lint rules passed"
+    exit 0
+else
+    echo "✗ Slow lint rules failed. Fix issues and try again." >&2
+    exit 1  # Block the push
+fi

package/all/copy-overwrite/.claude/rules/verfication.md

@@ -0,0 +1,37 @@
+# Empirical Verification
+
+Every task requires a **proof command** - a single command that empirically demonstrates the work is done.
+
+## Core Principle
+
+Never assume something works because the code "looks correct." Run a command, observe the output, compare to expected result.
+
+## Verification Types
+
+| Type | Use Case | Example |
+|------|----------|---------|
+| `test` | Unit/integration tests | `npm test -- path/to/file.spec.ts` |
+| `api-test` | API endpoints | `curl -s localhost:3000/api/endpoint` |
+| `test-coverage` | Coverage thresholds | `npm run test:cov -- --collectCoverageFrom=...` |
+| `ui-recording` | UI changes | Playwright/Cypress test |
+| `documentation` | Doc changes | `grep "expected" path/to/doc.md` |
+| `manual-check` | Config/setup | `cat config.json \| jq '.setting'` |
+
+## Task Completion Rules
+
+1. **Run the proof command** before marking any task complete
+2. **Compare output** to expected result
+3. **If verification fails**: Fix and re-run, don't mark complete
+4. **If verification blocked** (missing Docker, services, etc.): Mark as blocked, not complete
+
+## Example
+
+**Task**: Add health check endpoint
+
+**Wrong verification**: "I added the route handler"
+
+**Correct verification**:
+```bash
+curl -s http://localhost:3000/health | jq '.status'
+```
+**Expected**: `"ok"`

package/package.json

@@ -26,7 +26,7 @@
     "knip": "knip",
     "knip:fix": "knip --fix",
     "sg:scan": "ast-grep scan",
-    "lisa:update": "npx @codyswann/lisa ."
+    "lisa:update": "npx @codyswann/lisa@latest ."
   },
   "devDependencies": {
     "@ast-grep/cli": "^0.40.4",
@@ -80,7 +80,7 @@
     "@ast-grep/cli"
   ],
   "name": "@codyswann/lisa",
-  "version": "1.9.0",
+  "version": "1.9.3",
   "description": "Claude Code governance framework that applies guardrails, guidance, and automated enforcement to projects",
   "main": "dist/index.js",
   "bin": {

package/typescript/copy-overwrite/.github/workflows/quality.yml

@@ -93,8 +93,13 @@ on:
         required: false
         default: false
         type: boolean
+      skip_lint_slow:
+        description: 'Skip the slow lint rules job'
+        required: false
+        default: false
+        type: boolean
       skip_jobs:
-        description: 'Jobs to skip (comma-separated: lint,typecheck,test,test:unit,test:integration,test:e2e,maestro_e2e,playwright_e2e,format,build,dead_code,sg_scan,npm_security_scan,github_issue)'
+        description: 'Jobs to skip (comma-separated: lint,lint_slow,typecheck,test,test:unit,test:integration,test:e2e,maestro_e2e,playwright_e2e,format,build,dead_code,sg_scan,npm_security_scan,github_issue)'
         required: false
         default: ''
         type: string
@@ -290,6 +295,45 @@ jobs:
           NODE_OPTIONS: --max-old-space-size=6144
         working-directory: ${{ inputs.working_directory || '.' }}
 
+  lint_slow:
+    name: 🐢 Slow Lint Rules
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    if: ${{ !inputs.skip_lint_slow && !contains(inputs.skip_jobs, 'lint_slow') }}
+
+    steps:
+      - name: 📥 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 🔧 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ inputs.node_version }}
+          cache: ${{ inputs.package_manager != 'bun' && inputs.package_manager || '' }}
+
+      - name: 🍞 Setup Bun
+        if: inputs.package_manager == 'bun'
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: 📥 Install dependencies
+        run: |
+          if [ "${{ inputs.package_manager }}" = "npm" ]; then
+            npm ci
+          elif [ "${{ inputs.package_manager }}" = "yarn" ]; then
+            yarn install --frozen-lockfile
+          elif [ "${{ inputs.package_manager }}" = "bun" ]; then
+            bun install --frozen-lockfile
+          fi
+        working-directory: ${{ inputs.working_directory || '.' }}
+
+      - name: 🐢 Run slow lint rules
+        run: ${{ inputs.package_manager }} run lint:slow
+        env:
+          NODE_OPTIONS: --max-old-space-size=6144
+        working-directory: ${{ inputs.working_directory || '.' }}
+
   typecheck:
     name: 🔍 Type Check
     runs-on: ubuntu-latest

package/typescript/merge/package.json

@@ -17,7 +17,7 @@
     "knip": "knip",
     "knip:fix": "knip --fix",
     "sg:scan": "ast-grep scan",
-    "lisa:update": "npx @codyswann/lisa ."
+    "lisa:update": "npx @codyswann/lisa@latest ."
   },
   "devDependencies": {
     "@commitlint/cli": "^20.3.1",

package/typescript/copy-overwrite/.github/workflows/lint-slow.yml

@@ -1,40 +0,0 @@
-# This file is managed by Lisa.
-# Do not edit directly — changes will be overwritten on the next `lisa` run.
-
-name: 🐢 Slow Lint Rules
-
-on:
-  schedule:
-    # Run nightly at 2 AM UTC
-    - cron: '0 2 * * *'
-  workflow_dispatch:
-    # Allow manual triggering
-
-jobs:
-  lint-slow:
-    name: 🐢 Slow Lint Rules
-    runs-on: ubuntu-latest
-    steps:
-      - name: 📥 Checkout
-        uses: actions/checkout@v4
-
-      - name: 📦 Setup Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: 📦 Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: 🐢 Run slow lint rules
-        run: bun run lint:slow
-
-  create_issue_on_failure:
-    name: 📌 Create Issue on Failure
-    needs: [lint-slow]
-    if: ${{ failure() }}
-    uses: ./.github/workflows/create-issue-on-failure.yml
-    with:
-      workflow_name: 'Slow Lint Rules'
-      failed_job: 'lint-slow'
-    secrets: inherit