@codyswann/lisa 1.0.0

package/all/copy-overwrite/.claude/commands/pull-request/review.md

@@ -0,0 +1,12 @@
+---
+description: Checks for code review comments on a PR and implements them if required.
+argument-hint: <github-pr-link>
+allowed-tools: Read, Write, Bash(git*), Glob, Grep, Task, TodoWrite. Bash(gh*)
+---
+
+1. Use the github cli to find all the code review comments on $ARGUMENTS
+2. Create a task list for each unresolved code review comment
+3. Review the code reviews one by one and determine if they are correct and should be implemented
+4. The ones that aren't valid or you're not implementing, use the github cli to comment why you're not and resolve the code review comment
+5. For the rest, implement the changes and then use the github cli to mark the comment why it's resolved.
+6. Once all the code review comments have been resolved, run /git:commit

package/all/copy-overwrite/.claude/commands/rules/format-md.md

@@ -0,0 +1,72 @@
+---
+description: "Format any markdown file according to brief.md standard template"
+argument-hint: "[markdown-file-path]"
+---
+
+# Format Markdown File
+
+Format any markdown file according to the brief.md standard template structure. Provide the markdown file path as argument.
+
+## Usage
+
+```bash
+/format-md path/to/file.md
+```
+
+## Standard Template Format
+
+The command will reorganize markdown content into this standard structure:
+
+```markdown
+# [Document Title]
+
+## Context
+
+[Brief description of the problem or situation]
+
+## Goal
+
+[What needs to be achieved]
+
+## Changes
+
+[List of specific changes needed]
+
+## Implementation
+
+[Detailed steps or technical implementation details]
+
+## Notes
+
+[Additional information, constraints, or special considerations]
+```
+
+## Instructions
+
+1. **Read the file**: Read the markdown file provided in $ARGUMENTS
+2. **Extract title**:
+   - Use the first # heading as title
+   - If no # title found, create one that fits the content
+3. **Categorize content**:
+   - **Context**: Problem/Background/Issue/Current state descriptions
+   - **Goal**: Solution/Objective/Purpose/Target statements
+   - **Changes**: Requirements/Features/Scope/What's needed items
+   - **Implementation**: Steps/Technical details/How to do it/Code blocks
+   - **Notes**: Additional info/Warnings/Considerations/Important notes
+4. **Reformat**:
+   - Move all content into appropriate standard sections
+   - Unify language like English
+   - Keep code blocks, lists, and formatting intact
+5. **Write back**: Save the formatted content to the same file
+
+## Content Mapping Rules
+
+### Headers that map to sections:
+
+- **Context**: Context, Problem, Background, Issue, Current State, Description
+- **Goal**: Goal, Objective, Solution, Purpose, Target, What, Solution Overview
+- **Changes**: Changes, Requirements, Features, Scope, Deliverables, What's Needed
+- **Implementation**: Implementation, Steps, Technical Details, How, Approach, Process
+- **Notes**: Notes, Considerations, Constraints, Additional Information, Warnings, Important
+
+Execute this formatting process on the markdown file specified in $ARGUMENTS.

package/all/copy-overwrite/.claude/commands/sonarqube/check.md

@@ -0,0 +1,6 @@
+---
+description: Uses SonarQube / SonarCloud to get the reason that last pull request failed to pass checks
+allowed-tools: ["mcp__sonarqube__*"]
+---
+
+use the sonarqube mcp to get the reason the last PR failed checks

package/all/copy-overwrite/.claude/commands/sonarqube/fix.md

@@ -0,0 +1,3 @@
+1. run /sonarqube:check
+2. fix the SonarQube quality gate failures identified in step 1
+3. run /git:commit

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

@@ -0,0 +1,301 @@
+# Claude Code Hooks
+
+This directory contains hook scripts that enhance Claude Code's behavior during development.
+
+## Available Hooks
+
+### install_pkgs.sh
+
+**Type**: SessionStart hook
+**Trigger**: At the start of each Claude Code session (remote/web only)
+**Purpose**: Installs project dependencies and development tools needed for the session
+
+#### How it works
+
+1. The hook only runs in remote/web environments (`CLAUDE_CODE_REMOTE=true`)
+2. Detects the package manager from lock files (bun, pnpm, yarn, npm)
+3. Runs package installation
+4. Installs Gitleaks for secret detection (used by pre-commit hook)
+5. Installs Playwright's bundled Chromium for Lighthouse CI
+6. Exports `CHROME_PATH` to `.claude/env.local` and `~/.bashrc`
+
+#### Tools Installed
+
+| Tool | Purpose | Used By |
+|------|---------|---------|
+| Gitleaks | Secret detection in commits | pre-commit hook |
+| Chromium | Headless browser for Lighthouse | `bun run lighthouse:check` |
+
+#### Environment Variables Set
+
+- `CHROME_PATH`: Path to Playwright's Chromium binary, required for Lighthouse CI
+
+#### Configuration
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/install_pkgs.sh",
+            "timeout": 480
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+#### Running Lighthouse Check
+
+After the session starts, you can run Lighthouse:
+
+```bash
+# Source env.local if CHROME_PATH not in current shell
+source .claude/env.local 2>/dev/null || true
+bun run lighthouse:check
+```
+
+---
+
+### lint-on-edit.sh
+
+**Type**: PostToolUse hook
+**Trigger**: After Claude uses the Edit tool
+**Purpose**: Automatically runs ESLint with --fix on TypeScript files after Claude edits them to fix linting issues
+
+#### How it works
+
+1. The hook is triggered whenever Claude successfully uses the Edit tool
+2. It extracts the file path from the Edit tool's input
+3. Checks if the file is a TypeScript file (`.ts`, `.tsx`)
+4. Checks if the file is in a lintable directory (`src/`, `apps/`, `libs/`, or `test/`)
+5. Detects the project's package manager from lock files (bun, pnpm, yarn, npm)
+6. Runs ESLint with --fix on the specific file using the detected package manager
+7. Provides feedback about linting results and auto-fixes applied
+
+#### Features
+
+- **Auto-fixing**: Automatically fixes ESLint issues that can be fixed programmatically
+- **Targeted linting**: Only lints the specific edited file, not the entire codebase
+- **Directory filtering**: Only lints files in configured directories (src, apps, libs, test)
+- **Graceful error handling**: Never interrupts Claude's workflow, even if linting fails
+- **Clear feedback**: Distinguishes between "no issues", "fixed issues", and "unfixable issues"
+
+#### Supported File Types
+
+- TypeScript (`.ts`, `.tsx`)
+
+### format-on-edit.sh
+
+**Type**: PostToolUse hook
+**Trigger**: After Claude uses the Edit tool
+**Purpose**: Automatically formats TypeScript, JavaScript, and JSON files with Prettier after Claude edits them
+
+#### How it works
+
+1. The hook is triggered whenever Claude successfully uses the Edit tool
+2. It extracts the file path from the Edit tool's input
+3. Checks if the file is a supported type (`.ts`, `.tsx`, `.js`, `.jsx`, `.json`)
+4. Detects the project's package manager from lock files (bun, pnpm, yarn, npm)
+5. Runs Prettier on the specific file using the detected package manager
+6. Provides feedback about the formatting result
+
+#### Configuration
+
+Both hooks are configured in `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/lint-on-edit.sh",
+            "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/format-on-edit.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+Note: The hooks run in order. ESLint runs first to fix linting issues, then Prettier runs to format the code.
+
+#### Features
+
+- **Graceful error handling**: Never interrupts Claude's workflow, even if formatting fails
+- **File type filtering**: Only formats supported file types
+- **Clear feedback**: Provides informative messages about what's happening
+- **Performance**: Only formats the specific edited file, not the entire codebase
+
+#### Supported File Types
+
+- TypeScript (`.ts`, `.tsx`)
+- JavaScript (`.js`, `.jsx`)
+- JSON (`.json`)
+
+#### References
+
+- [Claude Code Hooks Guide](https://docs.claude.com/en/docs/claude-code/hooks-guide)
+- [Hooks Reference](https://docs.claude.com/en/docs/claude-code/hooks)
+
+### notify-ntfy.sh
+
+**Type**: Notification and Stop hooks
+**Trigger**: When Claude needs permission, is idle 60+ seconds, or finishes a task
+**Purpose**: Sends desktop and mobile push notifications via ntfy.sh with rich context
+
+#### How it works
+
+1. The hook reads JSON input from Claude Code containing event details
+2. Extracts the hook event name, notification type, session ID, and transcript path
+3. Detects the source environment (Web vs Local) via `CLAUDE_CODE_REMOTE`
+4. For Stop events, parses the transcript to extract a task summary
+5. Determines appropriate title, message, and priority based on the event
+6. Sends a push notification to your ntfy.sh topic with full context
+7. Silently exits if NTFY_TOPIC is not configured
+
+#### Notification Content
+
+Notifications include:
+- **Source indicator** - `[Web]` or `[Local]` in the title to identify where Claude is running
+- **Session ID** - First 8 characters for correlating notifications with sessions
+- **Project name** - Which project the task was in
+- **Task summary** - For Stop events, the last assistant message (truncated to 100 chars)
+
+Example notification:
+```text
+Title: Claude [Web] - Finished
+Body:  Session: eb5b0174 | thumbwar-backend
+       Enhanced ntfy hooks to include session ID, source, and task summary
+```
+
+#### Setup Instructions
+
+1. **Install ntfy app on your mobile device:**
+   - iOS: [App Store](https://apps.apple.com/app/ntfy/id1625396347)
+   - Android: [Google Play](https://play.google.com/store/apps/details?id=io.heckel.ntfy) or [F-Droid](https://f-droid.org/packages/io.heckel.ntfy/)
+
+2. **Subscribe to a unique topic in the app:**
+   - Open the ntfy app
+   - Tap "+" to subscribe to a topic
+   - Enter a unique topic name (e.g., `my-claude-alerts-abc123`)
+   - Use something random/unique - topics are public by default
+
+3. **Set the NTFY_TOPIC environment variable** (choose one):
+
+   **Option A - Project-local config (recommended for Claude Code web):**
+   ```bash
+   cp .claude/env.local.template .claude/env.local
+   # Edit .claude/env.local and set your topic
+   ```
+
+   **Option B - User-global config (applies to all projects):**
+   ```bash
+   mkdir -p ~/.claude
+   echo 'export NTFY_TOPIC="my-claude-alerts-abc123"' >> ~/.claude/env.local
+   ```
+
+   **Option C - Shell profile (traditional):**
+   Add to `~/.bashrc` or `~/.zshrc`:
+   ```bash
+   export NTFY_TOPIC="my-claude-alerts-abc123"
+   ```
+
+4. **Test the setup:**
+   ```bash
+   curl -d "Test notification" ntfy.sh/$NTFY_TOPIC
+   ```
+
+#### Notification Types
+
+| Event | Trigger | Priority | Title Format | Body Format |
+|-------|---------|----------|--------------|-------------|
+| `permission_prompt` | Claude needs tool permission | High | `Claude [Source] - Permission Required` | Session ID + message |
+| `idle_prompt` | Claude idle 60+ seconds | Default | `Claude [Source] - Waiting` | Session ID + message |
+| `Stop` | Claude finishes responding | Default | `Claude [Source] - Finished` | Session ID + project + task summary |
+| `SubagentStop` | Background agent finishes | Low | `Claude [Source] - Subagent Done` | Session ID + project + task summary |
+
+#### Features
+
+- **Cross-platform**: Works on iOS, Android, and desktop (via ntfy web/app)
+- **Source detection**: Shows `[Web]` or `[Local]` so you know where Claude is running
+- **Session tracking**: Includes session ID for correlating notifications
+- **Task summaries**: Stop events include a summary of what Claude accomplished
+- **Priority levels**: Permission requests are high priority for immediate attention
+- **Emoji tags**: Visual indicators in notifications (warning, hourglass, checkmark)
+- **Graceful degradation**: Silently skips if NTFY_TOPIC not configured
+- **No account required**: ntfy.sh works without registration
+
+#### Configuration
+
+The hook is configured in `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "permission_prompt|idle_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/notify-ntfy.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/notify-ntfy.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+#### Privacy Note
+
+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).
+
+## Adding New Hooks
+
+To add a new hook:
+
+1. Create a new shell script in this directory
+2. Make it executable: `chmod +x your-hook.sh`
+3. Add the hook configuration to `.claude/settings.json`
+4. Test the hook by triggering the appropriate action
+5. Document the hook in this README
+
+## Troubleshooting
+
+If a hook isn't working:
+
+1. Check that the script is executable
+2. Verify the path in `settings.json` is correct
+3. Test the script manually with sample JSON input
+4. Check Claude Code logs for error messages

package/all/copy-overwrite/.claude/hooks/notify-ntfy.sh

@@ -0,0 +1,181 @@
+#!/bin/bash
+# =============================================================================
+# ntfy.sh Notification Hook for Claude Code
+# =============================================================================
+# Sends desktop and mobile notifications via ntfy.sh when Claude needs
+# attention or finishes a task.
+#
+# Setup:
+#   1. Install ntfy app on mobile (iOS App Store / Android Play Store)
+#   2. Subscribe to your unique topic in the app
+#   3. Set NTFY_TOPIC environment variable (e.g., in ~/.bashrc or ~/.zshrc):
+#      export NTFY_TOPIC="my-claude-alerts-xyz123"
+#
+# @see https://ntfy.sh
+# =============================================================================
+
+# Read JSON input from stdin
+INPUT=$(cat)
+
+# Extract hook event name
+HOOK_EVENT=$(echo "$INPUT" | grep -o '"hook_event_name"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*: *"//' | sed 's/"$//')
+
+# Extract notification type (for Notification hooks)
+NOTIFICATION_TYPE=$(echo "$INPUT" | grep -o '"notification_type"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*: *"//' | sed 's/"$//')
+
+# Extract message if available
+MESSAGE=$(echo "$INPUT" | grep -o '"message"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*: *"//' | sed 's/"$//')
+
+# Extract session ID (first 8 chars for brevity)
+FULL_SESSION_ID=$(echo "$INPUT" | grep -o '"session_id"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*: *"//' | sed 's/"$//')
+SESSION_ID="${FULL_SESSION_ID:0:8}"
+
+# Extract transcript path for task summary
+TRANSCRIPT_PATH=$(echo "$INPUT" | grep -o '"transcript_path"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*: *"//' | sed 's/"$//')
+
+# Determine source (Web vs Local)
+if [ "$CLAUDE_CODE_REMOTE" = "true" ]; then
+    SOURCE="Web"
+else
+    SOURCE="Local"
+fi
+
+# Get project name from current directory
+PROJECT_NAME=$(basename "$CLAUDE_PROJECT_DIR" 2>/dev/null || basename "$(pwd)")
+
+# Load NTFY_TOPIC from local config if not already set
+if [ -z "$NTFY_TOPIC" ]; then
+    # Check for project-local config (gitignored)
+    if [ -f "$CLAUDE_PROJECT_DIR/.claude/env.local" ]; then
+        # shellcheck source=/dev/null
+        source "$CLAUDE_PROJECT_DIR/.claude/env.local"
+    fi
+    # Check for user-global config
+    if [ -z "$NTFY_TOPIC" ] && [ -f "$HOME/.claude/env.local" ]; then
+        # shellcheck source=/dev/null
+        source "$HOME/.claude/env.local"
+    fi
+fi
+
+# Exit silently if still not configured
+if [ -z "$NTFY_TOPIC" ]; then
+    exit 0
+fi
+
+# Extract task summary from transcript (last assistant message, truncated)
+TASK_SUMMARY=""
+if [ -n "$TRANSCRIPT_PATH" ] && [ -f "$TRANSCRIPT_PATH" ]; then
+    # Get the last assistant message from the JSONL transcript
+    # The transcript contains lines with "type":"assistant" and "message" content
+    # Use awk for cross-platform compatibility (tac is not available on macOS)
+    LAST_ASSISTANT=$(awk '/"type"[[:space:]]*:[[:space:]]*"assistant"/{line=$0} END{if(line) print line}' "$TRANSCRIPT_PATH" 2>/dev/null)
+    if [ -n "$LAST_ASSISTANT" ]; then
+        # Extract the message content - look for text content in the message
+        # Format: {"message":{"content":[{"type":"text","text":"..."}]}}
+        # Use jq for robust JSON parsing when available, fallback to grep/sed
+        if command -v jq >/dev/null 2>&1; then
+            RAW_SUMMARY=$(echo "$LAST_ASSISTANT" | jq -r '.message.content[] | select(.type == "text") | .text' 2>/dev/null | head -1)
+        else
+            # Fallback: simple regex extraction (may fail on escaped quotes)
+            RAW_SUMMARY=$(echo "$LAST_ASSISTANT" | grep -o '"text"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*: *"//' | sed 's/"$//')
+        fi
+        if [ -n "$RAW_SUMMARY" ]; then
+            # Truncate to 100 chars and clean up newlines
+            TASK_SUMMARY=$(echo "$RAW_SUMMARY" | tr '\n' ' ' | cut -c1-100)
+            # Add ellipsis if truncated
+            if [ ${#RAW_SUMMARY} -gt 100 ]; then
+                TASK_SUMMARY="${TASK_SUMMARY}..."
+            fi
+        fi
+    fi
+fi
+
+# Build session info string (shown in body)
+SESSION_INFO=""
+if [ -n "$SESSION_ID" ]; then
+    SESSION_INFO="Session: $SESSION_ID"
+fi
+
+# Determine notification title and body based on hook type
+case "$HOOK_EVENT" in
+    "Notification")
+        case "$NOTIFICATION_TYPE" in
+            "permission_prompt")
+                TITLE="Claude [$SOURCE] - Permission Required"
+                BODY="${MESSAGE:-Claude needs your permission to continue}"
+                if [ -n "$SESSION_INFO" ]; then
+                    BODY="$SESSION_INFO
+$BODY"
+                fi
+                PRIORITY="high"
+                TAGS="warning"
+                ;;
+            "idle_prompt")
+                TITLE="Claude [$SOURCE] - Waiting"
+                BODY="${MESSAGE:-Claude is waiting for your input}"
+                if [ -n "$SESSION_INFO" ]; then
+                    BODY="$SESSION_INFO
+$BODY"
+                fi
+                PRIORITY="default"
+                TAGS="hourglass"
+                ;;
+            *)
+                TITLE="Claude [$SOURCE] - Attention"
+                BODY="${MESSAGE:-Claude needs your attention}"
+                if [ -n "$SESSION_INFO" ]; then
+                    BODY="$SESSION_INFO
+$BODY"
+                fi
+                PRIORITY="default"
+                TAGS="bell"
+                ;;
+        esac
+        ;;
+    "Stop")
+        TITLE="Claude [$SOURCE] - Finished"
+        BODY="$PROJECT_NAME"
+        if [ -n "$SESSION_INFO" ]; then
+            BODY="$SESSION_INFO | $BODY"
+        fi
+        if [ -n "$TASK_SUMMARY" ]; then
+            BODY="$BODY
+$TASK_SUMMARY"
+        fi
+        PRIORITY="default"
+        TAGS="white_check_mark"
+        ;;
+    "SubagentStop")
+        TITLE="Claude [$SOURCE] - Subagent Done"
+        BODY="$PROJECT_NAME"
+        if [ -n "$SESSION_INFO" ]; then
+            BODY="$SESSION_INFO | $BODY"
+        fi
+        if [ -n "$TASK_SUMMARY" ]; then
+            BODY="$BODY
+$TASK_SUMMARY"
+        fi
+        PRIORITY="low"
+        TAGS="checkered_flag"
+        ;;
+    *)
+        TITLE="Claude [$SOURCE]"
+        BODY="${MESSAGE:-Event: $HOOK_EVENT}"
+        if [ -n "$SESSION_INFO" ]; then
+            BODY="$SESSION_INFO
+$BODY"
+        fi
+        PRIORITY="default"
+        TAGS="robot"
+        ;;
+esac
+
+# Send notification via ntfy.sh
+curl -s \
+    -H "Title: $TITLE" \
+    -H "Priority: $PRIORITY" \
+    -H "Tags: $TAGS" \
+    -d "$BODY" \
+    "https://ntfy.sh/$NTFY_TOPIC" > /dev/null 2>&1
+
+exit 0

package/all/copy-overwrite/.claude/settings.json

@@ -0,0 +1,41 @@
+{
+  "env": {
+    "BASH_DEFAULT_TIMEOUT_MS": "1800000",
+    "BASH_MAX_TIMEOUT_MS": "7200000"
+  },
+  "includeCoAuthoredBy": true,
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "permission_prompt|idle_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/notify-ntfy.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/notify-ntfy.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  },
+  "enabledPlugins": {
+    "typescript-lsp@claude-plugins-official": true,
+    "safety-net@cc-marketplace": true,
+    "code-simplifier@claude-plugins-official": true,
+    "code-review@claude-plugins-official": true,
+    "beads@beads-marketplace": true,
+    "playwright@claude-plugins-official": true
+  }
+}

package/all/copy-overwrite/.claude/settings.local.json.example

@@ -0,0 +1,14 @@
+{
+  "env": {
+    "BRAVE_API_KEY": "xxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+    "FIRECRAWL_API_KEY": "xxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+    "GITHUB_PERSONAL_ACCESS_TOKEN": "xxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+    "CONTEXT7_API_KEY": "xxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+    "MEMORY_PATH": ".ai/memory.jsonl"
+  },
+  "permissions": {
+    "allow": ["Bash(git add:*)"],
+    "deny": []
+  },
+  "enableAllProjectMcpServers": true
+}