wicked-garden 12.27.0

package/skills/platform/gitlab-ci/refs/troubleshooting.md

@@ -0,0 +1,213 @@
+---
+phase_relevance: ["build", "review", "operate"]
+archetype_relevance: ["*"]
+---
+# GitLab CI Troubleshooting
+
+Common errors and fixes.
+
+## Pipeline Not Triggering
+
+### Check Rules
+
+```yaml
+# Debug: Print why job is running
+job:
+  script:
+    - echo "Source: $CI_PIPELINE_SOURCE"
+    - echo "Branch: $CI_COMMIT_BRANCH"
+    - echo "Tag: $CI_COMMIT_TAG"
+```
+
+### Common Causes
+
+| Symptom | Cause | Fix |
+|---------|-------|-----|
+| Job never runs | Rules exclude it | Check `rules:` conditions |
+| Duplicate pipelines | Both push + MR triggers | Use `workflow:rules:` |
+| Missing on tags | No tag rule | Add `- if: $CI_COMMIT_TAG` |
+
+### Prevent Duplicate Pipelines
+
+```yaml
+workflow:
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH && $CI_OPEN_MERGE_REQUESTS
+      when: never
+    - if: $CI_COMMIT_BRANCH
+```
+
+## Cache Issues
+
+### Cache Not Restoring
+
+1. Check key matches exactly
+2. Verify paths exist at job end
+3. Check runner has cache configured
+
+```yaml
+# Debug cache
+job:
+  script:
+    - ls -la node_modules/ || echo "Cache miss"
+```
+
+### Force Cache Refresh
+
+```yaml
+cache:
+  key: "v2-${CI_COMMIT_REF_SLUG}"  # Bump version
+```
+
+## Runner Issues
+
+### "No Runner Available"
+
+1. Check runner tags match job tags
+2. Verify runner is online in GitLab UI
+3. Check runner is allowed for project
+
+```yaml
+# Use shared runners
+job:
+  tags: []  # Remove specific tags
+```
+
+### Timeout
+
+```yaml
+job:
+  timeout: 2h  # Increase timeout
+```
+
+## Docker-in-Docker
+
+### "Cannot Connect to Docker Daemon"
+
+```yaml
+job:
+  image: docker:24
+  services:
+    - docker:24-dind
+  variables:
+    DOCKER_HOST: tcp://docker:2376
+    DOCKER_TLS_CERTDIR: "/certs"
+    DOCKER_CERT_PATH: "/certs/client"
+    DOCKER_TLS_VERIFY: "1"
+```
+
+### Slow Builds
+
+```yaml
+# Enable layer caching
+variables:
+  DOCKER_DRIVER: overlay2
+
+# Or use Buildkit
+variables:
+  DOCKER_BUILDKIT: "1"
+```
+
+## Artifacts
+
+### "Artifact Too Large"
+
+1. Check `artifacts:expire_in` is set
+2. Reduce artifact size with patterns
+
+```yaml
+artifacts:
+  paths:
+    - dist/
+  exclude:
+    - dist/**/*.map
+  expire_in: 1 day
+```
+
+### Artifacts Not Passing Between Jobs
+
+```yaml
+job2:
+  needs:
+    - job: job1
+      artifacts: true  # Explicit
+```
+
+## Variables
+
+### "Variable Not Found"
+
+1. Check variable exists in Settings > CI/CD
+2. Check protected/masked settings
+3. Check branch is protected (for protected variables)
+
+```yaml
+# Debug variables (careful with secrets!)
+job:
+  script:
+    - echo "VAR exists: ${MY_VAR:+yes}"
+```
+
+### Expand Variables in Variables
+
+```yaml
+variables:
+  BASE_URL: "https://example.com"
+  API_URL: "${BASE_URL}/api"  # Works
+```
+
+## Services
+
+### "Cannot Connect to Service"
+
+```yaml
+test:
+  services:
+    - name: postgres:15
+      alias: db  # Use 'db' as hostname
+  variables:
+    DATABASE_URL: "postgresql://postgres@db/test"
+```
+
+### Service Startup Race
+
+```yaml
+before_script:
+  - |
+    for i in $(seq 1 30); do
+      pg_isready -h db && break
+      sleep 1
+    done
+```
+
+## Debugging
+
+### SSH Into Runner
+
+```yaml
+debug:
+  script:
+    - sleep 3600  # Keep job running
+  when: manual
+  # Then SSH from GitLab UI
+```
+
+### Print Environment
+
+```yaml
+debug:
+  script:
+    - env | sort
+    - pwd
+    - ls -la
+```
+
+### Check YAML Syntax
+
+```bash
+# Local validation
+gitlab-ci-lint .gitlab-ci.yml
+
+# Or use GitLab's CI Lint in pipeline editor
+```

package/skills/platform/glab-cli/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: glab-cli
+description: |
+  Use when you need glab CLI patterns for GitLab — pipeline debugging, MR management, or release
+  automation. Provides composable glab invocations for power users.
+  NOT for GitHub (use the gh-cli skill) or simple git commands (use Bash).
+phase_relevance: ["build", "review", "operate"]
+archetype_relevance: ["*"]
+---
+
+# GitLab CLI Power Utilities
+
+Intelligent wrappers and patterns for GitLab CLI operations.
+
+## When to Use
+
+- Debugging failed GitLab CI/CD pipelines
+- Managing merge requests across projects
+- Automating releases
+- Bulk operations on issues/MRs
+- Project health checks
+
+## Prerequisites
+
+```bash
+# macOS
+brew install glab
+
+# Or download from https://gitlab.com/gitlab-org/cli
+
+# Authenticate
+glab auth login
+```
+
+## Core Capabilities
+
+### 1. Pipeline Debugging
+
+Get actionable errors from failed pipelines.
+
+```bash
+# Diagnose most recent failure
+sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/skills/platform/glab-cli/scripts/glab_ops.py" diagnose
+
+# Specific project
+sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/skills/platform/glab-cli/scripts/glab_ops.py" diagnose --project group/project
+
+# With suggested fixes
+sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/skills/platform/glab-cli/scripts/glab_ops.py" diagnose --suggest-fixes
+```
+
+**Output:** Job failures, error excerpts, timing info.
+
+### 2. MR Operations
+
+Merge request management at scale.
+
+```bash
+# List MRs needing review
+sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/skills/platform/glab-cli/scripts/glab_ops.py" mr-review-queue
+
+# MRs ready to merge (approved + passing)
+sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/skills/platform/glab-cli/scripts/glab_ops.py" mr-merge-ready --dry-run
+
+# MR health check
+sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/skills/platform/glab-cli/scripts/glab_ops.py" mr-status 123
+```
+
+### 3. Release Automation
+
+Create releases with changelogs.
+
+```bash
+# Preview release
+sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/skills/platform/glab-cli/scripts/glab_ops.py" release --dry-run
+
+# Create minor release
+sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/skills/platform/glab-cli/scripts/glab_ops.py" release --bump minor
+
+# With custom notes
+sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/skills/platform/glab-cli/scripts/glab_ops.py" release --notes "Breaking: API v2"
+```
+
+## Quick Patterns
+
+```bash
+# Watch pipeline
+glab ci view --live
+
+# Retry failed jobs
+glab ci retry
+
+# View job logs
+glab ci trace <job-id>
+
+# Create MR from current branch
+glab mr create --fill
+
+# Checkout MR locally
+glab mr checkout 123
+
+# View MR changes
+glab mr diff 123
+
+# Approve MR
+glab mr approve 123
+
+# Merge MR
+glab mr merge 123 --squash --remove-source-branch
+```
+
+## glab vs gh Quick Reference
+
+| Task | GitHub (gh) | GitLab (glab) |
+|------|-------------|---------------|
+| Create PR/MR | `gh pr create` | `glab mr create` |
+| List CI runs | `gh run list` | `glab ci list` |
+| View CI logs | `gh run view --log` | `glab ci trace` |
+| Watch CI | `gh run watch` | `glab ci view --live` |
+| Retry CI | `gh run rerun --failed` | `glab ci retry` |
+| Checkout PR/MR | `gh pr checkout 123` | `glab mr checkout 123` |
+
+## Integration
+
+Works with:
+- **wicked-garden:search**: Find code, create issues via glab
+- **Native tasks**: Track MR status alongside tasks via TaskUpdate description appends
+
+## References
+
+- `refs/glab-ops.md` - Full script documentation
+- `refs/patterns.md` - Common workflow patterns
+- `refs/ci-debugging.md` - Pipeline troubleshooting

package/skills/platform/glab-cli/refs/ci-debugging.md

@@ -0,0 +1,95 @@
+---
+phase_relevance: ["build", "review", "operate"]
+archetype_relevance: ["*"]
+---
+# GitLab CI Pipeline Debugging
+
+Quick reference for debugging GitLab CI/CD failures.
+
+## Common Issues
+
+### Pipeline Stuck Pending
+
+1. Check runner availability: Settings > CI/CD > Runners
+2. Verify runner tags match job tags
+3. Check concurrent job limits
+
+### Job Timeout
+
+```yaml
+job:
+  timeout: 2h  # Increase if needed
+```
+
+### Cache Not Restoring
+
+```yaml
+cache:
+  key: ${CI_COMMIT_REF_SLUG}  # Check key format
+  paths:
+    - node_modules/
+  policy: pull-push  # Ensure writing enabled
+```
+
+### Variables Not Available
+
+Protected variables only work on protected branches. Check:
+- Settings > CI/CD > Variables > Protected checkbox
+- Settings > Repository > Protected branches
+
+## Debug Techniques
+
+### Print Environment
+
+```yaml
+debug:
+  script:
+    - env | sort
+    - echo $CI_JOB_TOKEN | wc -c  # Check token exists
+```
+
+### Keep Job Running
+
+```yaml
+debug:
+  script:
+    - sleep 3600
+  when: manual
+```
+
+### Validate YAML
+
+```bash
+# Local
+gitlab-ci-lint .gitlab-ci.yml
+
+# Or use CI/CD > Editor > Validate
+```
+
+## Using glab CLI
+
+```bash
+# List pipelines
+glab ci list
+
+# View specific pipeline
+glab ci view <id>
+
+# Watch live
+glab ci view --live
+
+# Get job logs
+glab ci trace <job-id>
+
+# Retry failed
+glab ci retry
+```
+
+## Common Error Patterns
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| "No runner available" | Tag mismatch | Check job tags |
+| "Job failed: exit code 1" | Script error | Check logs |
+| "Artifact too large" | Size limit | Set expire_in |
+| "Variable not found" | Protected var | Check protection |

package/skills/platform/glab-cli/refs/glab-ops.md

@@ -0,0 +1,78 @@
+---
+phase_relevance: ["build", "review", "operate"]
+archetype_relevance: ["*"]
+---
+# glab_ops.py Reference
+
+GitLab operations CLI with intelligent features.
+
+## Commands
+
+### diagnose
+
+Analyze failed pipelines with categorized errors.
+
+```bash
+python3 glab_ops.py diagnose
+python3 glab_ops.py diagnose --project group/project
+python3 glab_ops.py diagnose --suggest-fixes
+```
+
+**Error categories:**
+- npm/node dependency issues
+- Python import errors
+- Rust compilation errors
+- Resource limits
+- Network issues
+
+### mr-review-queue
+
+List MRs requesting your review.
+
+```bash
+python3 glab_ops.py mr-review-queue
+```
+
+### mr-merge-ready
+
+Find MRs approved and passing CI.
+
+```bash
+python3 glab_ops.py mr-merge-ready --dry-run
+```
+
+### mr-status
+
+Get MR details.
+
+```bash
+python3 glab_ops.py mr-status 123
+python3 glab_ops.py mr-status 123 --project group/name
+```
+
+### release
+
+Create release with changelog.
+
+```bash
+# Preview
+python3 glab_ops.py release --dry-run
+
+# Create
+python3 glab_ops.py release --bump minor
+
+# With notes
+python3 glab_ops.py release --notes "Breaking change"
+```
+
+## Output Format
+
+All commands output JSON:
+
+```bash
+# Pretty print
+python3 glab_ops.py diagnose | jq '.'
+
+# Extract errors
+python3 glab_ops.py diagnose | jq '.errors[].message'
+```

package/skills/platform/glab-cli/refs/patterns.md

@@ -0,0 +1,131 @@
+---
+phase_relevance: ["build", "review", "operate"]
+archetype_relevance: ["*"]
+---
+# Common glab CLI Patterns
+
+Quick reference for GitLab CLI operations.
+
+## Pipeline Operations
+
+```bash
+# List recent pipelines
+glab ci list
+
+# View pipeline details
+glab ci view <pipeline-id>
+
+# Watch pipeline live
+glab ci view --live
+
+# View job logs
+glab ci trace <job-id>
+
+# Retry failed jobs
+glab ci retry
+
+# Cancel pipeline
+glab ci delete <pipeline-id>
+
+# Trigger manual job
+glab ci run
+```
+
+## Merge Requests
+
+```bash
+# Create MR with auto-fill
+glab mr create --fill
+
+# Create draft MR
+glab mr create --draft
+
+# Checkout MR locally
+glab mr checkout 123
+
+# View MR changes
+glab mr diff 123
+
+# Approve MR
+glab mr approve 123
+
+# Merge MR
+glab mr merge 123 --squash --remove-source-branch
+
+# List open MRs
+glab mr list --state=opened
+
+# MRs assigned to me
+glab mr list --assignee=@me
+
+# MRs I need to review
+glab mr list --reviewer=@me
+```
+
+## Issues
+
+```bash
+# Create issue
+glab issue create --title "Bug" --description "Details"
+
+# Close issue
+glab issue close 123
+
+# List open issues
+glab issue list --state=opened
+
+# Issues assigned to me
+glab issue list --assignee=@me
+```
+
+## Releases
+
+```bash
+# List releases
+glab release list
+
+# Create release
+glab release create v1.0.0 --notes "Release notes"
+
+# Upload assets
+glab release upload v1.0.0 ./dist/*
+```
+
+## Project
+
+```bash
+# Clone project
+glab repo clone group/project
+
+# Fork project
+glab repo fork group/project
+
+# View project info
+glab repo view
+```
+
+## Authentication
+
+```bash
+# Login
+glab auth login
+
+# Check status
+glab auth status
+
+# List configured hosts
+glab config get host
+```
+
+## API Access
+
+```bash
+# GET request
+glab api projects/:id
+
+# POST request
+glab api projects/:id/issues -X POST -f title="Bug"
+
+# With JQ filter
+glab api projects/:id --jq '.name'
+```