@debugbundle/cli 1.6.2 → 1.6.4

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`.",
@@ -16238,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",
     "",
@@ -16252,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",
@@ -16406,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.",
@@ -19352,11 +19375,19 @@ var STORAGE_BOOTSTRAP_STATEMENTS = [
       channel text NOT NULL,
       condition_type text NOT NULL,
       severity_min text,
+      severity_lifecycle_scope text,
       cooldown_seconds integer NOT NULL DEFAULT 0,
       config jsonb NOT NULL DEFAULT '{}'::jsonb,
       is_enabled boolean NOT NULL DEFAULT true,
       created_at timestamptz NOT NULL DEFAULT now(),
-      updated_at timestamptz NOT NULL DEFAULT now()
+      updated_at timestamptz NOT NULL DEFAULT now(),
+      CONSTRAINT alert_rules_severity_lifecycle_scope_check CHECK (
+        severity_lifecycle_scope IS NULL
+        OR (
+          condition_type = 'severity_threshold'
+          AND severity_lifecycle_scope IN ('new_incident', 'incident_regressed', 'both')
+        )
+      )
     )
   `,
   `
@@ -20911,6 +20942,36 @@ var STORAGE_SCHEMA_MIGRATIONS = [
         )
       `
     ]
+  }),
+  defineStorageSchemaMigration({
+    id: "202606260001_add_alert_severity_lifecycle_scope",
+    description: "Add lifecycle scope for severity-threshold alert rules so new incidents and regressions can notify independently.",
+    statements: [
+      "ALTER TABLE alert_rules ADD COLUMN IF NOT EXISTS severity_lifecycle_scope text",
+      `
+        UPDATE alert_rules
+        SET severity_lifecycle_scope = 'both'
+        WHERE condition_type = 'severity_threshold'
+          AND severity_lifecycle_scope IS NULL
+      `,
+      `
+        UPDATE alert_rules
+        SET severity_lifecycle_scope = NULL
+        WHERE condition_type <> 'severity_threshold'
+          AND severity_lifecycle_scope IS NOT NULL
+      `,
+      "ALTER TABLE alert_rules DROP CONSTRAINT IF EXISTS alert_rules_severity_lifecycle_scope_check",
+      `
+        ALTER TABLE alert_rules
+        ADD CONSTRAINT alert_rules_severity_lifecycle_scope_check CHECK (
+          severity_lifecycle_scope IS NULL
+          OR (
+            condition_type = 'severity_threshold'
+            AND severity_lifecycle_scope IN ('new_incident', 'incident_regressed', 'both')
+          )
+        )
+      `
+    ]
   })
 ];
 
@@ -22082,6 +22143,7 @@ var AlertConditionTypeSchema = external_exports.enum([
   "severity_threshold",
   "regression_after_deploy"
 ]);
+var AlertSeverityLifecycleScopeSchema = external_exports.enum(["new_incident", "incident_regressed", "both"]);
 var AlertSchema = external_exports.object({
   alert_id: external_exports.string(),
   project_id: external_exports.string(),
@@ -22090,6 +22152,7 @@ var AlertSchema = external_exports.object({
   channel: AlertChannelSchema,
   condition_type: AlertConditionTypeSchema,
   severity_min: external_exports.enum(["low", "medium", "high", "critical"]).nullable(),
+  severity_lifecycle_scope: AlertSeverityLifecycleScopeSchema.nullable().optional().default(null),
   cooldown_seconds: external_exports.number().int().min(0),
   config: external_exports.record(external_exports.string(), external_exports.unknown()),
   is_enabled: external_exports.boolean(),
@@ -22177,6 +22240,9 @@ function createAlertApi(client) {
       if (input2.severityMin !== void 0) {
         body.severity_min = input2.severityMin;
       }
+      if (input2.severityLifecycleScope !== void 0) {
+        body.severity_lifecycle_scope = input2.severityLifecycleScope;
+      }
       if (input2.cooldownSeconds !== void 0) {
         body.cooldown_seconds = input2.cooldownSeconds;
       }
@@ -22206,6 +22272,9 @@ function createAlertApi(client) {
       if (input2.severityMin !== void 0) {
         body.severity_min = input2.severityMin;
       }
+      if (input2.severityLifecycleScope !== void 0) {
+        body.severity_lifecycle_scope = input2.severityLifecycleScope;
+      }
       if (input2.cooldownSeconds !== void 0) {
         body.cooldown_seconds = input2.cooldownSeconds;
       }
@@ -28181,11 +28250,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");
 }
@@ -30705,8 +30772,8 @@ var CLI_USAGE_LINES = [
   "  debugbundle token member create --label <label> [--auth-file <path>] [--json]",
   "  debugbundle token member revoke <token-id> [--auth-file <path>] [--json]",
   "  debugbundle alert list --project-id <id> [--limit <n>] [--auth-file <path>] [--json]",
-  "  debugbundle alert create --project-id <id> --channel <channel> --condition <condition> [--service-id <id>] [--severity-min <level>] [--cooldown <seconds>] --config-json <json> [--is-enabled <true|false>] [--auth-file <path>] [--json]",
-  "  debugbundle alert update <alert-id> --project-id <id> [--service-id <id|null>] [--channel <channel>] [--condition <condition>] [--severity-min <level|null>] [--cooldown <seconds>] [--config-json <json|null>] [--is-enabled <true|false>] [--auth-file <path>] [--json]",
+  "  debugbundle alert create --project-id <id> --channel <channel> --condition <condition> [--service-id <id>] [--severity-min <level>] [--severity-lifecycle-scope <new_incident|incident_regressed|both>] [--cooldown <seconds>] --config-json <json> [--is-enabled <true|false>] [--auth-file <path>] [--json]",
+  "  debugbundle alert update <alert-id> --project-id <id> [--service-id <id|null>] [--channel <channel>] [--condition <condition>] [--severity-min <level|null>] [--severity-lifecycle-scope <new_incident|incident_regressed|both|null>] [--cooldown <seconds>] [--config-json <json|null>] [--is-enabled <true|false>] [--auth-file <path>] [--json]",
   "  debugbundle alert delete <alert-id> --project-id <id> [--auth-file <path>] [--json]",
   "  debugbundle slack list --project-id <id> [--auth-file <path>] [--json]",
   "  debugbundle slack connect-url --project-id <id> [--return-to </projects/...>] [--auth-file <path>] [--json]",
@@ -35781,6 +35848,9 @@ async function createAlertCommand(input2, api) {
     if (input2.severityMin !== void 0) {
       requestInput.severityMin = input2.severityMin;
     }
+    if (input2.severityLifecycleScope !== void 0) {
+      requestInput.severityLifecycleScope = input2.severityLifecycleScope;
+    }
     if (input2.cooldownSeconds !== void 0) {
       requestInput.cooldownSeconds = input2.cooldownSeconds;
     }
@@ -35814,6 +35884,9 @@ async function createAlertWithAuthCommand(input2, dependencies) {
       if (input2.severityMin !== void 0) {
         commandInput.severityMin = input2.severityMin;
       }
+      if (input2.severityLifecycleScope !== void 0) {
+        commandInput.severityLifecycleScope = input2.severityLifecycleScope;
+      }
       if (input2.cooldownSeconds !== void 0) {
         commandInput.cooldownSeconds = input2.cooldownSeconds;
       }
@@ -35848,6 +35921,9 @@ async function updateAlertCommand(input2, api) {
     if (input2.severityMin !== void 0) {
       requestInput.severityMin = input2.severityMin;
     }
+    if (input2.severityLifecycleScope !== void 0) {
+      requestInput.severityLifecycleScope = input2.severityLifecycleScope;
+    }
     if (input2.cooldownSeconds !== void 0) {
       requestInput.cooldownSeconds = input2.cooldownSeconds;
     }
@@ -35888,6 +35964,9 @@ async function updateAlertWithAuthCommand(input2, dependencies) {
       if (input2.severityMin !== void 0) {
         commandInput.severityMin = input2.severityMin;
       }
+      if (input2.severityLifecycleScope !== void 0) {
+        commandInput.severityLifecycleScope = input2.severityLifecycleScope;
+      }
       if (input2.cooldownSeconds !== void 0) {
         commandInput.cooldownSeconds = input2.cooldownSeconds;
       }
@@ -36813,6 +36892,7 @@ async function handleAlertCommand(parsedArgv, dependencies) {
       "channel",
       "condition",
       "severity-min",
+      "severity-lifecycle-scope",
       "cooldown",
       "config-json",
       "is-enabled"
@@ -36843,6 +36923,10 @@ async function handleAlertCommand(parsedArgv, dependencies) {
     if (severityMin !== void 0) {
       input2.severityMin = severityMin;
     }
+    const severityLifecycleScope = readStringOption(parsedArgv, "severity-lifecycle-scope");
+    if (severityLifecycleScope !== void 0) {
+      input2.severityLifecycleScope = severityLifecycleScope;
+    }
     const cooldownSeconds = readIntegerOption(parsedArgv, "cooldown");
     if (cooldownSeconds !== void 0) {
       input2.cooldownSeconds = cooldownSeconds;
@@ -36867,6 +36951,7 @@ async function handleAlertCommand(parsedArgv, dependencies) {
       "channel",
       "condition",
       "severity-min",
+      "severity-lifecycle-scope",
       "cooldown",
       "config-json",
       "is-enabled"
@@ -36896,6 +36981,10 @@ async function handleAlertCommand(parsedArgv, dependencies) {
     if (severityMin !== void 0) {
       input2.severityMin = severityMin === "null" ? null : severityMin;
     }
+    const severityLifecycleScope = readStringOption(parsedArgv, "severity-lifecycle-scope");
+    if (severityLifecycleScope !== void 0) {
+      input2.severityLifecycleScope = severityLifecycleScope === "null" ? null : severityLifecycleScope;
+    }
     const cooldownSeconds = readIntegerOption(parsedArgv, "cooldown");
     if (cooldownSeconds !== void 0) {
       input2.cooldownSeconds = cooldownSeconds;
@@ -36908,7 +36997,7 @@ async function handleAlertCommand(parsedArgv, dependencies) {
     if (isEnabled !== void 0) {
       input2.isEnabled = isEnabled;
     }
-    if (input2.serviceId === void 0 && input2.channel === void 0 && input2.conditionType === void 0 && input2.severityMin === void 0 && input2.cooldownSeconds === void 0 && input2.config === void 0 && input2.isEnabled === void 0) {
+    if (input2.serviceId === void 0 && input2.channel === void 0 && input2.conditionType === void 0 && input2.severityMin === void 0 && input2.severityLifecycleScope === void 0 && input2.cooldownSeconds === void 0 && input2.config === void 0 && input2.isEnabled === void 0) {
       throw new CliInputError("At least one alert field must be provided.");
     }
     return await (dependencies.updateAlertCommand ?? updateAlertWithAuthCommand)(input2);
@@ -37166,7 +37255,7 @@ async function handleCaptureRuleCommand2(parsedArgv, dependencies) {
 // package.json
 var package_default = {
   name: "@debugbundle/cli",
-  version: "1.6.2",
+  version: "1.6.4",
   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.2",
+  "version": "1.6.4",
   "private": false,
   "description": "Command-line interface for DebugBundle",
   "license": "AGPL-3.0-only",