nemonix-cli 1.0.0

package/src/config/claude-code-config/skills/workflow-ci-fixer/references/github-cli.md

@@ -0,0 +1,243 @@
+# GitHub CLI Complete Reference for CI/CD
+
+<workflow_runs>
+## List Workflow Runs
+```bash
+gh run list                                    # All recent runs
+gh run list --limit 20                        # Limit results
+gh run list --workflow ci.yml                 # Specific workflow
+gh run list --branch main                     # Specific branch
+gh run list --user username                   # By user
+gh run list --status failure                  # Failed only
+gh run list --status success                  # Successful only
+gh run list --status in_progress             # Currently running
+gh run list --event push                      # By trigger event
+gh run list --event pull_request             # PR triggered
+
+# JSON output with specific fields
+gh run list --json databaseId,status,conclusion,name,headBranch,createdAt
+gh run list --json databaseId,conclusion -q '.[] | select(.conclusion=="failure")'
+```
+
+## View Run Details
+```bash
+gh run view <run-id>                          # Summary view
+gh run view <run-id> --log                   # Full logs
+gh run view <run-id> --log-failed            # Only failed job logs
+gh run view <run-id> --exit-status           # Exit with run's status
+gh run view <run-id> --web                   # Open in browser
+
+# JSON output
+gh run view <run-id> --json jobs
+gh run view <run-id> --json jobs,status,conclusion
+gh run view <run-id> --json jobs -q '.jobs[] | {name, conclusion, steps}'
+```
+
+## Watch Running Workflow
+```bash
+gh run watch                                  # Interactive selection
+gh run watch <run-id>                        # Watch specific run
+gh run watch <run-id> --exit-status          # Exit with final status
+gh run watch <run-id> --interval 5           # Custom refresh interval
+```
+</workflow_runs>
+
+<rerun_workflows>
+## Re-run Workflows
+```bash
+gh run rerun <run-id>                         # Re-run all jobs
+gh run rerun <run-id> --failed               # Re-run only failed jobs
+gh run rerun <run-id> --debug                # Re-run with debug logging
+gh run rerun <run-id> --job <job-id>         # Re-run specific job
+
+# Get job IDs first
+gh run view <run-id> --json jobs -q '.jobs[].databaseId'
+```
+
+## Cancel Running Workflow
+```bash
+gh run cancel <run-id>
+```
+</rerun_workflows>
+
+<artifacts>
+## Download Artifacts
+```bash
+gh run download <run-id>                      # All artifacts to current dir
+gh run download <run-id> --dir ./artifacts   # Specific directory
+gh run download <run-id> -n artifact-name    # Specific artifact
+gh run download <run-id> -n "name-*"         # Pattern matching
+gh run download <run-id> -p "*.zip"          # Glob pattern
+
+# Download from multiple runs
+gh run download -n test-results              # Latest artifact with name
+
+# Download interactively
+gh run download
+```
+
+## List Artifacts via API
+```bash
+gh api repos/{owner}/{repo}/actions/artifacts
+gh api repos/{owner}/{repo}/actions/runs/{run_id}/artifacts
+gh api repos/{owner}/{repo}/actions/artifacts/{artifact_id}/zip > artifact.zip
+```
+</artifacts>
+
+<workflow_management>
+## List Workflows
+```bash
+gh workflow list                              # All workflows
+gh workflow list --all                       # Include disabled
+gh workflow list --json id,name,state
+```
+
+## View Workflow
+```bash
+gh workflow view <workflow>                   # Summary
+gh workflow view <workflow> --yaml           # Show YAML content
+gh workflow view <workflow> --web            # Open in browser
+```
+
+## Run Workflow Manually
+```bash
+gh workflow run <workflow>                    # Trigger on default branch
+gh workflow run <workflow> --ref feature     # Specific branch
+gh workflow run ci.yml -f input1=value       # With inputs
+gh workflow run ci.yml --json                # Read inputs from stdin
+
+# Example with JSON input
+echo '{"environment": "staging"}' | gh workflow run deploy.yml --json
+```
+
+## Enable/Disable Workflow
+```bash
+gh workflow enable <workflow>
+gh workflow disable <workflow>
+```
+</workflow_management>
+
+<cache_management>
+## Cache Commands
+```bash
+gh cache list                                 # List caches
+gh cache list --limit 50
+gh cache list --json id,key,sizeInBytes
+gh cache list --key "npm-"                   # Filter by key prefix
+
+gh cache delete <cache-id>                   # Delete specific cache
+gh cache delete --all                        # Delete all caches
+```
+</cache_management>
+
+<api_access>
+## Direct API Access
+```bash
+# Get workflow runs
+gh api repos/{owner}/{repo}/actions/runs
+gh api repos/{owner}/{repo}/actions/runs?status=failure
+
+# Get specific run
+gh api repos/{owner}/{repo}/actions/runs/{run_id}
+
+# Get jobs for a run
+gh api repos/{owner}/{repo}/actions/runs/{run_id}/jobs
+
+# Download logs (returns redirect URL)
+gh api repos/{owner}/{repo}/actions/runs/{run_id}/logs
+
+# Get artifacts
+gh api repos/{owner}/{repo}/actions/artifacts
+gh api repos/{owner}/{repo}/actions/runs/{run_id}/artifacts
+
+# Re-run workflow
+gh api -X POST repos/{owner}/{repo}/actions/runs/{run_id}/rerun
+
+# Re-run failed jobs
+gh api -X POST repos/{owner}/{repo}/actions/runs/{run_id}/rerun-failed-jobs
+
+# Cancel run
+gh api -X POST repos/{owner}/{repo}/actions/runs/{run_id}/cancel
+
+# Delete run
+gh api -X DELETE repos/{owner}/{repo}/actions/runs/{run_id}
+```
+
+## Using jq for Filtering
+```bash
+# Get failed runs
+gh api repos/{owner}/{repo}/actions/runs \
+  --jq '.workflow_runs[] | select(.conclusion=="failure") | {id, name, created_at}'
+
+# Get latest successful run ID
+gh api repos/{owner}/{repo}/actions/runs?status=success \
+  --jq '.workflow_runs[0].id'
+
+# Get failed job names
+gh api repos/{owner}/{repo}/actions/runs/{run_id}/jobs \
+  --jq '.jobs[] | select(.conclusion=="failure") | .name'
+```
+</api_access>
+
+<pr_checks>
+## Check PR Status
+```bash
+gh pr checks                                  # Current branch PR checks
+gh pr checks <pr-number>                     # Specific PR
+gh pr checks --required                      # Required checks only
+gh pr checks --watch                         # Watch until complete
+gh pr checks --fail-fast                     # Exit on first failure
+gh pr checks --json name,state,conclusion
+gh pr checks --web                           # Open in browser
+```
+</pr_checks>
+
+<useful_scripts>
+## Useful One-liners
+```bash
+# Get latest failed run ID
+gh run list --status failure --limit 1 --json databaseId -q '.[0].databaseId'
+
+# Re-run latest failed
+gh run rerun $(gh run list --status failure -L1 --json databaseId -q '.[0].databaseId') --failed
+
+# Watch latest run
+gh run watch $(gh run list -L1 --json databaseId -q '.[0].databaseId')
+
+# Download all failed run artifacts
+for id in $(gh run list --status failure --json databaseId -q '.[].databaseId'); do
+  gh run download $id --dir /tmp/artifacts/$id 2>/dev/null
+done
+
+# List all workflow files
+ls .github/workflows/*.yml
+
+# Get run URL
+gh run view <run-id> --json url -q '.url'
+
+# Check if workflow exists
+gh workflow view ci.yml >/dev/null 2>&1 && echo "exists" || echo "not found"
+```
+</useful_scripts>
+
+<environment_secrets>
+## Secrets and Variables (for reference)
+```bash
+# List secrets (names only, not values)
+gh secret list
+gh secret list --env production
+
+# Set secret
+gh secret set SECRET_NAME
+gh secret set SECRET_NAME --body "value"
+gh secret set SECRET_NAME < secret.txt
+
+# Delete secret
+gh secret delete SECRET_NAME
+
+# Variables
+gh variable list
+gh variable set VAR_NAME --body "value"
+gh variable delete VAR_NAME
+```
+</environment_secrets>

package/src/config/claude-code-config/skills/workflow-ci-fixer/references/troubleshooting.md

@@ -0,0 +1,362 @@
+# CI/CD Troubleshooting Guide
+
+<vercel_issues>
+## Vercel Build Failures
+
+<memory_issues>
+### Out of Memory (OOM)
+**Symptoms:**
+- Build cancelled with memory error
+- Process killed unexpectedly
+- "JavaScript heap out of memory"
+
+**Solutions:**
+```bash
+# Enable memory report
+VERCEL_DEBUG_MEMORY_REPORT=1 vercel build
+
+# Increase Node memory (in build command)
+NODE_OPTIONS='--max-old-space-size=4096' npm run build
+
+# For Next.js, in next.config.js:
+module.exports = {
+  experimental: {
+    workerThreads: false,
+    cpus: 1
+  }
+}
+```
+
+**Prevention:**
+- Analyze bundle size: `npx @next/bundle-analyzer`
+- Use dynamic imports for large modules
+- Upgrade to Pro/Enterprise for more memory
+</memory_issues>
+
+<module_not_found>
+### Module Not Found
+**Symptoms:**
+- "Cannot find module 'xxx'"
+- "Module not found: Can't resolve 'xxx'"
+
+**Solutions:**
+```bash
+# Check if package is in dependencies (not devDependencies for production)
+cat package.json | jq '.dependencies'
+
+# Clear node_modules and reinstall
+rm -rf node_modules package-lock.json
+npm install
+
+# For monorepos, check workspace configuration
+npm ls <package-name>
+```
+
+**Common causes:**
+- Package in devDependencies but needed at build time
+- Missing peer dependencies
+- Incorrect import path (case sensitivity)
+- Missing `@types/*` packages for TypeScript
+</module_not_found>
+
+<build_timeout>
+### Build Timeout (45 min limit)
+**Symptoms:**
+- Build cancelled after 45 minutes
+- "Build exceeded maximum duration"
+
+**Solutions:**
+```bash
+# Use build cache effectively
+vercel deploy  # Don't use --force unless necessary
+
+# Skip unnecessary steps
+SKIP_ENV_VALIDATION=1 npm run build
+
+# For Next.js ISR, reduce pages built at build time
+# In getStaticPaths:
+export async function getStaticPaths() {
+  return { paths: [], fallback: 'blocking' }
+}
+```
+
+**Optimization tips:**
+- Enable Turborepo/Nx caching
+- Use `next build` with `output: 'standalone'`
+- Reduce number of pages generated at build time
+</build_timeout>
+
+<env_var_issues>
+### Environment Variable Issues
+**Symptoms:**
+- "undefined" values in app
+- Different behavior in preview vs production
+
+**Debug:**
+```bash
+# List all env vars
+vercel env ls
+
+# Pull to local
+vercel pull
+cat .vercel/.env.*.local
+
+# Check in build logs what's available
+echo "Available env vars:"
+vercel build --debug 2>&1 | grep -i "environment"
+```
+
+**Common issues:**
+- Var only set for Production, not Preview
+- Missing `NEXT_PUBLIC_` prefix for client-side vars
+- Var set after deployment (need redeploy)
+</env_var_issues>
+
+<cache_issues>
+### Build Cache Issues
+**Symptoms:**
+- Old code still appearing
+- Dependencies not updating
+- Inconsistent builds
+
+**Solutions:**
+```bash
+# Force fresh build
+vercel deploy --force
+
+# Or via env var
+VERCEL_FORCE_NO_BUILD_CACHE=1 vercel deploy
+
+# Clear Turborepo cache
+TURBO_FORCE=1 npm run build
+
+# Via dashboard: Deployments > Redeploy > Uncheck "Use existing Build Cache"
+```
+</cache_issues>
+</vercel_issues>
+
+<github_actions_issues>
+## GitHub Actions Failures
+
+<artifact_issues>
+### Artifact Issues
+**Symptoms:**
+- "no valid artifacts found to download"
+- Artifact expired
+- Wrong artifact downloaded
+
+**Solutions:**
+```bash
+# List artifacts for a run
+gh api repos/{owner}/{repo}/actions/runs/{run_id}/artifacts
+
+# Check artifact name exactly
+gh run view <run-id> --json artifacts -q '.artifacts[].name'
+
+# Download from specific run (not latest)
+gh run download <run-id> -n "exact-artifact-name"
+```
+
+**Common causes:**
+- Artifact name mismatch (case sensitive)
+- Artifact expired (default 90 days)
+- Downloading from wrong workflow run
+- Matrix jobs uploading to same artifact name
+</artifact_issues>
+
+<permission_issues>
+### Permission Denied
+**Symptoms:**
+- "Resource not accessible by integration"
+- "Permission denied"
+- 403 errors
+
+**Solutions:**
+```yaml
+# Add permissions to workflow
+jobs:
+  build:
+    permissions:
+      contents: read
+      packages: write
+      actions: read
+
+# For GITHUB_TOKEN in workflow_run events
+permissions:
+  actions: read
+  checks: write
+```
+
+**Check token permissions:**
+```bash
+gh auth status
+gh api user
+```
+</permission_issues>
+
+<timeout_issues>
+### Job Timeout
+**Symptoms:**
+- Job cancelled after timeout
+- "The job running on runner xxx has exceeded the maximum execution time"
+
+**Solutions:**
+```yaml
+jobs:
+  build:
+    timeout-minutes: 60  # Increase timeout (max 360 for private repos)
+    steps:
+      - name: Long step
+        timeout-minutes: 30  # Per-step timeout
+```
+
+**Prevention:**
+- Add step timeouts for flaky operations
+- Use matrix to parallelize
+- Cache dependencies
+</timeout_issues>
+
+<cache_gh_issues>
+### Cache Issues
+**Symptoms:**
+- Cache miss every time
+- "Cache not found for key"
+- Stale cache
+
+**Debug:**
+```bash
+# List caches
+gh cache list
+gh cache list --json id,key,createdAt,sizeInBytes
+
+# Delete specific cache
+gh cache delete <cache-id>
+
+# Delete all caches
+gh cache delete --all
+```
+
+**Common causes:**
+- Cache key changes (dependency lockfile hash)
+- Cache evicted (7 day limit, 10GB total)
+- Different runner OS than cached
+</cache_gh_issues>
+
+<checkout_issues>
+### Checkout Issues
+**Symptoms:**
+- "fatal: reference is not a tree"
+- Wrong commit checked out
+- Missing files
+
+**Solutions:**
+```yaml
+- uses: actions/checkout@v4
+  with:
+    fetch-depth: 0  # Full history
+    ref: ${{ github.event.pull_request.head.sha }}  # Exact commit
+    submodules: recursive  # Include submodules
+```
+</checkout_issues>
+
+<workflow_run_issues>
+### Workflow Run Event Issues
+**Symptoms:**
+- workflow_run not triggering
+- Can't download artifacts from triggering workflow
+
+**Solutions:**
+```yaml
+# Correct workflow_run setup
+on:
+  workflow_run:
+    workflows: ["CI"]  # Exact name from triggering workflow
+    types: [completed]
+
+# Download artifacts from triggering workflow
+- uses: dawidd6/action-download-artifact@v2
+  with:
+    workflow: ci.yml
+    run_id: ${{ github.event.workflow_run.id }}
+```
+</workflow_run_issues>
+</github_actions_issues>
+
+<debugging_scripts>
+## Debugging Scripts
+
+### Save All CI State
+```bash
+#!/bin/bash
+PROJECT="${1:-$(basename $(pwd))}"
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+OUTPUT="/tmp/$PROJECT/ci-debug-$TIMESTAMP"
+mkdir -p $OUTPUT
+
+echo "Collecting CI state..."
+
+# Vercel state
+mkdir -p $OUTPUT/vercel
+vercel ls --output json > $OUTPUT/vercel/deployments.json 2>/dev/null
+vercel env ls > $OUTPUT/vercel/env-vars.txt 2>/dev/null
+
+# GitHub state
+mkdir -p $OUTPUT/github
+gh run list --limit 20 --json databaseId,status,conclusion,name,headBranch,createdAt > $OUTPUT/github/runs.json
+
+# Get latest failure
+FAILED=$(jq -r '[.[] | select(.conclusion=="failure")][0].databaseId // empty' $OUTPUT/github/runs.json)
+if [ -n "$FAILED" ]; then
+    echo "Getting logs for failed run: $FAILED"
+    gh run view $FAILED --log-failed > $OUTPUT/github/failed-logs.txt 2>&1
+    gh run download $FAILED --dir $OUTPUT/github/artifacts 2>/dev/null
+fi
+
+# Git state
+git log --oneline -10 > $OUTPUT/git-log.txt
+git status > $OUTPUT/git-status.txt
+git branch -a > $OUTPUT/git-branches.txt
+
+echo "CI state saved to: $OUTPUT"
+ls -la $OUTPUT
+```
+
+### Compare Two Deployments
+```bash
+#!/bin/bash
+DEPLOY1="$1"
+DEPLOY2="$2"
+OUTPUT="/tmp/compare-deployments"
+mkdir -p $OUTPUT
+
+vercel inspect $DEPLOY1 > $OUTPUT/deploy1.txt
+vercel inspect $DEPLOY2 > $OUTPUT/deploy2.txt
+
+diff $OUTPUT/deploy1.txt $OUTPUT/deploy2.txt > $OUTPUT/diff.txt
+
+echo "Differences:"
+cat $OUTPUT/diff.txt
+```
+</debugging_scripts>
+
+<quick_fixes>
+## Quick Fix Checklist
+
+### Vercel Build Failed
+- [ ] Pull latest env: `vercel pull`
+- [ ] Build locally: `vercel build --debug`
+- [ ] Check error in logs (look for red text)
+- [ ] Try force deploy: `vercel deploy --force`
+
+### GitHub Action Failed
+- [ ] View failed logs: `gh run view <id> --log-failed`
+- [ ] Re-run with debug: `gh run rerun <id> --debug`
+- [ ] Check permissions in workflow file
+- [ ] Verify secrets are set: `gh secret list`
+
+### Both Failing
+- [ ] Check if recent code change broke build
+- [ ] Verify dependencies: `npm ci` locally
+- [ ] Check for env var differences
+- [ ] Review recent changes: `git diff HEAD~5`
+</quick_fixes>