--- name: juicebox-debug-bundle description: 'Collect Juicebox debug evidence. Trigger: "juicebox debug", "juicebox support ticket". ' allowed-tools: Read, Bash(curl:*), Grep version: 1.16.0 license: MIT author: Jeremy Longshore tags: - saas - recruiting - juicebox compatibility: Designed for Claude Code --- # Juicebox Debug Bundle ## Overview Collect Juicebox API connectivity status, dataset health, analysis quota usage, and rate limit state into a single diagnostic archive. This bundle helps troubleshoot failed dataset uploads, stalled AI analysis runs, quota exhaustion, and API authentication problems. ## Debug Collection Script ```bash #!/bin/bash set -euo pipefail BUNDLE="debug-juicebox-$(date +%Y%m%d-%H%M%S)" mkdir -p "$BUNDLE" # Environment check echo "=== Juicebox Debug Bundle ===" | tee "$BUNDLE/summary.txt" echo "Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ)" >> "$BUNDLE/summary.txt" echo "JUICEBOX_API_KEY: ${JUICEBOX_API_KEY:+[SET]}" >> "$BUNDLE/summary.txt" # API connectivity — health endpoint HTTP=$(curl -s -o /dev/null -w "%{http_code}" \ -H "Authorization: Bearer ${JUICEBOX_API_KEY}" \ https://api.juicebox.ai/v1/health 2>/dev/null || echo "000") echo "API Status: HTTP $HTTP" >> "$BUNDLE/summary.txt" # Account quota curl -s -H "Authorization: Bearer ${JUICEBOX_API_KEY}" \ "https://api.juicebox.ai/v1/account/quota" \ > "$BUNDLE/quota.json" 2>&1 || true # Datasets and recent analyses curl -s -H "Authorization: Bearer ${JUICEBOX_API_KEY}" \ "https://api.juicebox.ai/v1/datasets?limit=10" > "$BUNDLE/datasets.json" 2>&1 || true curl -s -H "Authorization: Bearer ${JUICEBOX_API_KEY}" \ "https://api.juicebox.ai/v1/analyses?limit=5" > "$BUNDLE/recent-analyses.json" 2>&1 || true # Rate limit headers curl -s -D "$BUNDLE/rate-headers.txt" -o /dev/null \ -H "Authorization: Bearer ${JUICEBOX_API_KEY}" https://api.juicebox.ai/v1/health 2>/dev/null || true tar -czf "$BUNDLE.tar.gz" "$BUNDLE" && rm -rf "$BUNDLE" echo "Bundle: $BUNDLE.tar.gz" ``` ## Analyzing the Bundle ```bash tar -xzf debug-juicebox-*.tar.gz cat debug-juicebox-*/summary.txt # Auth + API health jq '{used, limit, remaining}' debug-juicebox-*/quota.json # Quota usage jq '.[] | {id, name, row_count}' debug-juicebox-*/datasets.json # Dataset inventory jq '.[] | {id, status, created_at}' debug-juicebox-*/recent-analyses.json ``` ## Common Issues | Symptom | Check in Bundle | Fix | |---------|----------------|-----| | API returns 401 | `summary.txt` shows HTTP 401 | Regenerate API key in Juicebox Settings > API Keys | | Dataset upload stuck | `datasets.json` shows processing status for >10 min | Check file format (CSV/JSON required); reduce file size below 100MB | | Analysis quota exhausted | `quota.json` shows remaining at 0 | Upgrade plan or wait for monthly quota reset | | Analysis run failed | `recent-analyses.json` shows error status | Check dataset has required columns; verify data types match analysis type | | Rate limited (429) | `rate-headers.txt` shows Retry-After | Implement exponential backoff; batch dataset queries | ## Automated Health Check ```typescript async function checkJuicebox(): Promise { const key = process.env.JUICEBOX_API_KEY; if (!key) { console.error("[FAIL] JUICEBOX_API_KEY not set"); return; } const res = await fetch("https://api.juicebox.ai/v1/health", { headers: { Authorization: `Bearer ${key}` }, }); console.log(`[${res.ok ? "OK" : "FAIL"}] API: HTTP ${res.status}`); if (res.ok) { const quota = await fetch("https://api.juicebox.ai/v1/account/quota", { headers: { Authorization: `Bearer ${key}` }, }); if (quota.ok) { const data = await quota.json(); console.log(`[INFO] Quota remaining: ${data.remaining ?? "unknown"}`); } } } checkJuicebox(); ``` ## Prerequisites - A sandbox workspace, synthetic fixture, approved diagnostic scope, redaction rules, secret references, source/destination allowlists, and an incident owner with a cleanup path. ## Instructions 1. Collect diagnostics from a sandbox fixture only; reject literal credentials, contact-level payloads, and unapproved sources or destinations. 2. Capture aggregate health, quota, and error signals, then verify suppression, log redaction, and `contacts_exported=0`. 3. Stop collection on policy, scope, or retention drift; revoke temporary access and restore the known-good configuration if required. 4. Store only the redacted bundle for the approved retention window, then delete staged artifacts. ## Output Produce a debug receipt with environment, fixture type, aggregate health/error/quota signals, suppression/no-export/redaction checks, incident owner, retention/deletion proof, and rollback reference. Exclude request payloads, identities, contact data, and secrets. ## Error Handling | Condition | Response | |---|---| | Sensitive material appears in the bundle | Stop collection, delete the artifact, rotate/revoke access as appropriate, and repeat with redaction enforced. | | Scope or policy drift | Halt the canary and restore the approved configuration before further diagnostics. | ## Examples `env=staging; fixture=synthetic; health=pass; quota=within-budget; suppression=pass; contacts_exported=0; bundle=redacted; cleanup=verified` is a safe debug receipt. ## Resources - Juicebox Status ## Next Steps See `juicebox-common-errors`. --- Source attribution: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/saas-packs/juicebox-pack/skills/juicebox-debug-bundle/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Dave AI. ## Upstream license notice MIT License Copyright (c) 2025 Jeremy Longshore Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Dave AI resource metadata Creator / publisher: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/saas-packs/juicebox-pack/skills/juicebox-debug-bundle/SKILL.md Attribution basis: Source repository record Fields of work: Sales, Customer Support Roles: Customer Success Manager, Support Agent, Technical Support Specialties: API, Design, Frontend Tools: Juicebox Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: db1d2718aa4047c1a9eb9da6646fa8d8c8a1fed41e81fbb6803170790a21d3fc