@debugbundle/cli 1.6.0 → 1.6.3

package/dist/main.cjs

@@ -15977,9 +15977,12 @@ function buildSkill() {
     "description: >-",
     "  Investigate runtime incidents, inspect debug bundles, generate reproductions,",
     "  run improvement analysis, and inspect operational controls using the DebugBundle",
-    "  CLI and local project scaffold. Use when the user reports a bug, runtime",
-    "  failure, production incident, endpoint downtime, health-check issue, missing",
-    "  notification, webhook delivery failure, probe request, or noisy incident.",
+    "  CLI and local project scaffold. Use when runtime errors/failures or captured",
+    "  operational evidence are relevant: production/customer-facing incidents,",
+    "  endpoint downtime, health-check failures, notification or webhook failures,",
+    "  probes, noisy captured incidents, or explicit DebugBundle artifact requests. Do not use for",
+    "  deterministic local source, UI, layout, copy, calculation, refactor, or",
+    "  test-only issues unless runtime evidence is needed.",
     "metadata:",
     "  author: debugbundle",
     '  version: "1.0"',
@@ -15987,11 +15990,22 @@ function buildSkill() {
     "",
     "# DebugBundle",
     "",
-    "Use DebugBundle before starting a fresh bug investigation.",
+    "Use DebugBundle when runtime evidence is relevant to the task.",
+    "",
+    "## When To Use DebugBundle",
+    "",
+    "Use the incident/artifact workflow when the user reports:",
+    "",
+    "- production or customer-facing incidents, runtime failures, regressions, broken deploys, or unknown errors likely to have generated captured events",
+    "- endpoint downtime or a failing hosted health check",
+    "- missing, duplicate, or failed alerts, webhooks, GitHub dispatches, probes, or other operational delivery",
+    "- a specific DebugBundle incident id, bundle, reproduction, report, or noisy captured incident",
+    "",
+    "For deterministic local source-code, UI, layout, copy, calculation, refactor, or test-only issues, inspect source and tests first. Do not check DebugBundle incidents unless the user asks, the issue involves live runtime behavior, or captured evidence is needed.",
     "",
     "## Investigation Quickstart",
     "",
-    "When the user reports a bug, runtime failure, production incident, regression, broken deploy, or unknown error, start here before reading arbitrary source files.",
+    "When the issue matches the runtime/incident criteria above, start here before reading arbitrary source files.",
     "",
     "1. Run `debugbundle doctor --json` to learn whether the project is local-only or connected and whether the local scaffold is healthy.",
     "2. If `debugbundle doctor --json` reports `mode=local-only`, start with `debugbundle incidents --source local --status active --json`.",
@@ -16011,7 +16025,7 @@ function buildSkill() {
     "",
     "## Core Workflow",
     "",
-    "1. Check DebugBundle incidents first to avoid re-investigating a known failure.",
+    "1. For qualifying runtime/incident work, check DebugBundle incidents first to avoid re-investigating a known failure.",
     "2. Inspect the incident bundle and reproduction artifact before proposing a fix.",
     "3. Run `debugbundle analyze --type improvement --local` after local processing when you need a deterministic change plan.",
     "4. Apply the narrowest fix, then validate it with the repository test workflow from `.debugbundle/profile.json`.",
@@ -16066,6 +16080,7 @@ function buildSkill() {
     "- Availability checks: `https://debugbundle.com/docs/availability-checks`",
     "- Probes: `https://debugbundle.com/docs/probes`",
     "- Capture policy and rules: `https://debugbundle.com/docs/capture-policy`",
+    "- Managing noise: `https://debugbundle.com/docs/managing-noise`",
     "- Alerts: `https://debugbundle.com/docs/alerts` and `https://debugbundle.com/docs/cli/alerts`",
     "- Webhooks: `https://debugbundle.com/docs/webhooks` and `https://debugbundle.com/docs/cli/webhooks`",
     "- API ingestion: `https://debugbundle.com/docs/api/ingestion`",
@@ -16194,6 +16209,7 @@ function buildCliReference() {
     "- Webhooks: `https://debugbundle.com/docs/webhooks`, `https://debugbundle.com/docs/cli/webhooks`, and `https://debugbundle.com/docs/api/webhooks`",
     "- Probes: `https://debugbundle.com/docs/probes` and `https://debugbundle.com/docs/api/probes`",
     "- Capture policy and rules: `https://debugbundle.com/docs/capture-policy`",
+    "- Managing noise: `https://debugbundle.com/docs/managing-noise`",
     "- Availability checks: `https://debugbundle.com/docs/availability-checks`",
     "- MCP tool catalog: `https://debugbundle.com/docs/mcp/tools`",
     "",
@@ -16236,7 +16252,7 @@ function buildMcpReference() {
   return [
     "# DebugBundle MCP Reference",
     "",
-    "Use the same incident-first workflow through MCP when an agent is operating in connected mode.",
+    "Use the same runtime-evidence-gated workflow through MCP when an agent is operating in connected mode.",
     "",
     "## Investigation Tools",
     "",
@@ -16250,8 +16266,9 @@ function buildMcpReference() {
     "- `analyze` \u2014 run local agent-oriented analysis from local bundles and skill schemas.",
     "",
     "- Prefer bundle retrieval tools before reading raw repository files.",
-    "- Use MCP bundle access when the current issue originated in production.",
-    "- Resolve fixed or intentionally generated incidents with `resolve_incident` or `resolve_incidents` so open incidents stay actionable.",
+    "- Use MCP bundle access when the current issue originated in production or otherwise needs captured runtime evidence.",
+    "- For deterministic local source, UI, layout, copy, calculation, refactor, or test-only issues, inspect source and tests first unless the user asks for DebugBundle evidence.",
+    "- Resolve fixed or intentionally generated incidents with `resolve_incident` or `resolve_incidents` so active incidents stay actionable.",
     "- Fall back to local CLI processing when the project is local-only.",
     "",
     "## Noise and Capture Policy Tools",
@@ -16298,6 +16315,7 @@ function buildMcpReference() {
     "- Availability checks: `https://debugbundle.com/docs/availability-checks`",
     "- Probes: `https://debugbundle.com/docs/probes`",
     "- Capture policy and rules: `https://debugbundle.com/docs/capture-policy`",
+    "- Managing noise: `https://debugbundle.com/docs/managing-noise`",
     "- Alerts: `https://debugbundle.com/docs/alerts`",
     "- Webhooks: `https://debugbundle.com/docs/webhooks`",
     "- API ingestion: `https://debugbundle.com/docs/api/ingestion`",
@@ -16403,13 +16421,21 @@ function buildSkillEvals() {
       skill: "debugbundle",
       evaluations: [
         {
-          name: "incident_first_workflow",
+          name: "runtime_incident_workflow",
           prompt: "The user reports a production checkout failure. Confirm the skill tells the agent to inspect DebugBundle artifacts first.",
           expected_behavior: [
-            "Check incidents before reading arbitrary source files.",
+            "Check incidents before reading arbitrary source files for qualifying runtime or production incidents.",
             "Read the skill workflow before proposing a fix."
           ]
         },
+        {
+          name: "local_source_issue_gate",
+          prompt: "The user reports a deterministic UI calculation glitch in local code with no runtime incident or report. Confirm the skill avoids checking DebugBundle incidents by default.",
+          expected_behavior: [
+            "Inspect source and tests first for deterministic local UI, layout, copy, calculation, refactor, or test-only issues.",
+            "Do not check DebugBundle incidents unless the user asks, live runtime behavior is involved, or captured evidence is needed."
+          ]
+        },
         {
           name: "profile_validation_task",
           prompt: "The generated profile is shallow. Confirm the skill teaches the agent how to validate and enrich it.",
@@ -28178,11 +28204,9 @@ function buildManagedAgentsSection() {
   return [
     MANAGED_AGENTS_START,
     "## DebugBundle",
-    "- Read `.agents/skills/debugbundle/SKILL.md` for the full debugging workflow.",
-    "- Use `debugbundle inspect <incident-id>` or MCP `get_bundle` when a user reports an issue.",
-    "- Run reproduction artifacts from `.debugbundle/bundles/local/reproductions/` before proposing a fix.",
-    "- After a fix is verified, or after an intentional smoke or dogfood incident has served its purpose, resolve it with `debugbundle resolve <incident-id> [incident-id ...]` or MCP `resolve_incident` / `resolve_incidents` so open incidents remain actionable.",
-    "- Use `debugbundle doctor` to validate local DebugBundle setup or connectivity issues.",
+    "- Use DebugBundle for runtime failures, production/customer-facing incidents, endpoint downtime, notification/webhook delivery failures, health-check failures, specific incident reports, or symptoms likely to have generated captured events.",
+    "- For deterministic local code, UI, layout, copy, calculation, refactor, or test-only issues, inspect source and tests first; do not check DebugBundle incidents unless runtime evidence is needed or the user asks.",
+    "- Read `.agents/skills/debugbundle/SKILL.md` for the full DebugBundle workflow.",
     MANAGED_AGENTS_END
   ].join("\n");
 }
@@ -37163,7 +37187,7 @@ async function handleCaptureRuleCommand2(parsedArgv, dependencies) {
 // package.json
 var package_default = {
   name: "@debugbundle/cli",
-  version: "1.6.0",
+  version: "1.6.3",
   private: false,
   description: "Command-line interface for DebugBundle",
   license: "AGPL-3.0-only",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@debugbundle/cli",
-  "version": "1.6.0",
+  "version": "1.6.3",
   "private": false,
   "description": "Command-line interface for DebugBundle",
   "license": "AGPL-3.0-only",