@canaryai/cli 0.2.9 → 0.2.13

package/dist/skill-CZ7SHI3P.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/skill-templates/issue-log-xref.ts","../src/skill-templates/index.ts","../src/skill.ts"],"sourcesContent":["export type SkillTemplate = {\n  name: string;\n  description: string;\n  render: () => string;\n};\n\nexport const issueLogXrefTemplate: SkillTemplate = {\n  name: \"issue-log-xref\",\n  description:\n    \"Cross-reference Canary issues with server logs to find root causes\",\n  render: () => `---\nname: Issue Log Cross-Reference\ndescription: Cross-reference Canary QA issues with server logs to identify root causes\n---\n\n# Issue Log Cross-Reference\n\nCross-reference Canary-detected issues with server logs to identify root causes, correlate errors, and provide actionable debugging context.\n\n## Prerequisites\n\n- \\`canary\\` CLI installed and authenticated (\\`canary login\\`)\n- Access to server logs (see Log Source Configuration below)\n\n## Workflow\n\n### 1. Fetch issues from Canary\n\nList recent issues to find ones worth investigating:\n\n\\`\\`\\`bash\ncanary issues list --format markdown\n\\`\\`\\`\n\nUse filters to narrow down:\n\n\\`\\`\\`bash\ncanary issues list --severity high --status open --format markdown\n\\`\\`\\`\n\n### 2. Get issue details\n\nOnce you identify an issue, fetch its full diagnostics:\n\n\\`\\`\\`bash\ncanary issues get <issue-id> --format markdown\n\\`\\`\\`\n\nNote the following from the issue details:\n- **Timestamps** — when the issue was detected\n- **URLs / endpoints** — which pages or API routes were involved\n- **Error messages** — any visible error text captured in screenshots or DOM\n- **HTTP status codes** — failed network requests\n\n### 3. Access server logs\n\n<!-- ============================================================\n  LOG SOURCE CONFIGURATION\n\n  Replace {{LOG_SOURCE_INSTRUCTIONS}} below with instructions\n  specific to your infrastructure. The AI agent reading this\n  skill will use these instructions to fetch logs.\n\n  Examples:\n\n  **AWS CloudWatch:**\n  Query CloudWatch Logs Insights for the relevant log group:\n  \\`\\`\\`bash\n  aws logs filter-log-events \\\\\n    --log-group-name /ecs/my-api \\\\\n    --start-time <epoch-ms> \\\\\n    --end-time <epoch-ms> \\\\\n    --filter-pattern \"<error-text>\"\n  \\`\\`\\`\n\n  **Local log files:**\n  Search local log files for matching entries:\n  \\`\\`\\`bash\n  grep -i \"<error-text>\" /var/log/my-app/*.log\n  \\`\\`\\`\n\n  **Datadog:**\n  Use the Datadog CLI or API to query logs:\n  \\`\\`\\`bash\n  dog logs list --query \"service:my-api status:error\" \\\\\n    --from <ISO-timestamp> --to <ISO-timestamp>\n  \\`\\`\\`\n\n  **kubectl (Kubernetes):**\n  Fetch pod logs for the relevant service:\n  \\`\\`\\`bash\n  kubectl logs -l app=my-api --since=1h | grep \"<error-text>\"\n  \\`\\`\\`\n============================================================ -->\n\n{{LOG_SOURCE_INSTRUCTIONS}}\n\n### 4. Cross-reference and correlate\n\nMatch the Canary issue with log entries using these correlation points:\n\n- **Timestamps** — find log entries within a few seconds of the issue detection time\n- **Error messages** — search logs for the same error text shown in the issue\n- **HTTP status codes** — look for 4xx/5xx responses matching the failed requests\n- **URLs / routes** — filter logs by the endpoint or page path from the issue\n- **Stack traces** — identify the code path that produced the error\n- **Request IDs** — if your app uses correlation/request IDs, trace the full request lifecycle\n\n## Analysis Guidelines\n\nWhen presenting findings:\n\n1. **State the match confidence** — clear match, likely match, or circumstantial\n2. **Show the timeline** — lay out events in chronological order across both sources\n3. **Identify the root cause** — distinguish between the symptom (what Canary caught) and the cause (what the logs reveal)\n4. **Suggest next steps** — point to the specific code, service, or configuration that needs attention\n5. **Note gaps** — if logs are missing or incomplete, say so explicitly rather than speculating\n`,\n};\n","import type { SkillTemplate } from \"./issue-log-xref.js\";\nimport { issueLogXrefTemplate } from \"./issue-log-xref.js\";\n\nexport type { SkillTemplate };\n\nexport const SKILL_TEMPLATES: Record<string, SkillTemplate> = {\n  \"issue-log-xref\": issueLogXrefTemplate,\n};\n","import { SKILL_TEMPLATES } from \"./skill-templates/index.js\";\n\nfunction printSkillHelp() {\n  const lines = [\n    \"Usage: canary skill <name>\",\n    \"\",\n    \"Output an AI agent skill template to stdout.\",\n    \"Pipe to a file to install: canary skill <name> > .claude/skills/<name>.md\",\n    \"\",\n    \"Available templates:\",\n  ];\n\n  for (const [key, template] of Object.entries(SKILL_TEMPLATES)) {\n    lines.push(`  ${key.padEnd(24)} ${template.description}`);\n  }\n\n  console.log(lines.join(\"\\n\"));\n}\n\nexport async function runSkill(argv: string[]) {\n  const [name] = argv;\n\n  if (!name || name === \"help\" || name === \"--help\" || name === \"-h\") {\n    printSkillHelp();\n    return;\n  }\n\n  const template = SKILL_TEMPLATES[name];\n  if (!template) {\n    console.error(`Unknown skill template \"${name}\".\\n`);\n    printSkillHelp();\n    process.exit(1);\n  }\n\n  process.stdout.write(template.render());\n}\n"],"mappings":";;;;AAMO,IAAM,uBAAsC;AAAA,EACjD,MAAM;AAAA,EACN,aACE;AAAA,EACF,QAAQ,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4GhB;;;ACjHO,IAAM,kBAAiD;AAAA,EAC5D,kBAAkB;AACpB;;;ACLA,SAAS,iBAAiB;AACxB,QAAM,QAAQ;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,aAAW,CAAC,KAAK,QAAQ,KAAK,OAAO,QAAQ,eAAe,GAAG;AAC7D,UAAM,KAAK,KAAK,IAAI,OAAO,EAAE,CAAC,IAAI,SAAS,WAAW,EAAE;AAAA,EAC1D;AAEA,UAAQ,IAAI,MAAM,KAAK,IAAI,CAAC;AAC9B;AAEA,eAAsB,SAAS,MAAgB;AAC7C,QAAM,CAAC,IAAI,IAAI;AAEf,MAAI,CAAC,QAAQ,SAAS,UAAU,SAAS,YAAY,SAAS,MAAM;AAClE,mBAAe;AACf;AAAA,EACF;AAEA,QAAM,WAAW,gBAAgB,IAAI;AACrC,MAAI,CAAC,UAAU;AACb,YAAQ,MAAM,2BAA2B,IAAI;AAAA,CAAM;AACnD,mBAAe;AACf,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,UAAQ,OAAO,MAAM,SAAS,OAAO,CAAC;AACxC;","names":[]}