@agentmonitors/cli 0.5.0 → 0.6.1

package/dist/index.cjs

@@ -33,10 +33,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/.pnpm/tsup@8.5.1_@microsoft+api-extractor@7.57.7_@types+node@22.19.15__jiti@2.7.0_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.1_@microsoft+api-extractor@7.57.7_@types+node@22.19.15__jiti@2.7.0_postcss@8.5.8_typescript@5.9.3_yaml@2.9.0/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl, importMetaUrl;
 var init_cjs_shims = __esm({
-  "../../node_modules/.pnpm/tsup@8.5.1_@microsoft+api-extractor@7.57.7_@types+node@22.19.15__jiti@2.7.0_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js"() {
+  "../../node_modules/.pnpm/tsup@8.5.1_@microsoft+api-extractor@7.57.7_@types+node@22.19.15__jiti@2.7.0_postcss@8.5.8_typescript@5.9.3_yaml@2.9.0/node_modules/tsup/assets/cjs_shims.js"() {
     "use strict";
     getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
     importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
@@ -30757,16 +30757,60 @@ var notifySchema = external_exports.discriminatedUnion("strategy", [
   debounceNotifySchema,
   throttleNotifySchema
 ]);
+var urgencyLevels = ["low", "normal", "high"];
+var urgencyRank = {
+  low: 0,
+  normal: 1,
+  high: 2
+};
+var urgencyBandSchema = external_exports.string().transform((raw, ctx) => {
+  const text2 = raw.trim();
+  const parts = text2.includes("..") ? text2.split("..").map((part) => part.trim()) : [text2, text2];
+  if (parts.length !== 2) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      message: 'urgency must be a single level (e.g. "normal") or a range "lo..hi" (e.g. "normal..high")'
+    });
+    return external_exports.NEVER;
+  }
+  const [loRaw, hiRaw] = parts;
+  const isLevel = (value) => value !== void 0 && urgencyLevels.includes(value);
+  if (!isLevel(loRaw) || !isLevel(hiRaw)) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      message: `urgency bounds must each be one of ${urgencyLevels.map((level) => `"${level}"`).join(", ")}`
+    });
+    return external_exports.NEVER;
+  }
+  if (urgencyRank[loRaw] > urgencyRank[hiRaw]) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      message: `urgency range "${loRaw}..${hiRaw}" is inverted \u2014 the low bound must not exceed the high bound`
+    });
+    return external_exports.NEVER;
+  }
+  return { lo: loRaw, hi: hiRaw };
+});
 var watchSchema = external_exports.object({
   type: external_exports.string().min(1).regex(/^[a-z][a-z0-9-]*$/, "watch.type must be kebab-case")
 }).catchall(external_exports.unknown());
 var monitorFrontmatterSchema = external_exports.object({
   name: external_exports.string().min(1, "Monitor name must be non-empty when present").optional(),
   watch: watchSchema,
-  urgency: external_exports.enum(["low", "normal", "high"]),
+  urgency: urgencyBandSchema,
   notify: notifySchema.optional(),
   tags: external_exports.array(external_exports.string()).optional()
-});
+}).transform(({ urgency, ...rest }) => ({
+  ...rest,
+  // Flatten the parsed band: `urgency` is the band's low bound — the base /
+  // default effective urgency used when no source `salience` is present (kept
+  // under this key for backward compatibility with every existing consumer) —
+  // and `urgencyMax` is the band's high bound (equal to `urgency` for a
+  // scalar). Source salience may escalate the effective urgency between these
+  // two, clamping outside the band. See 002 §4.1 / 003 §2.3.
+  urgency: urgency.lo,
+  urgencyMax: urgency.hi
+}));
 function validateScope(scope, scopeSchema6) {
   const validator = new Validator(scopeSchema6, "7", false);
   const result = validator.validate(scope);
@@ -31298,7 +31342,18 @@ function generateMonitorSchema(sources) {
           type: { type: "string", enum: sourceNames }
         }
       },
-      urgency: { type: "string", enum: ["low", "normal", "high"] },
+      // A bare level (`normal`) or an authored band `lo..hi` (`normal..high`).
+      // This editor-hint schema enforces only the *shape* of each bound; the
+      // authoritative parser (`monitorFrontmatterSchema`) additionally rejects
+      // an inverted range (`lo > hi`). See 001 §3.2.
+      //
+      // Leading/trailing whitespace is allowed (`\s*` anchors at both ends)
+      // to mirror the Zod parser, which calls `.trim()` on the raw value
+      // before validating bounds. Whitespace around `..` was already allowed.
+      urgency: {
+        type: "string",
+        pattern: "^\\s*(low|normal|high)(\\s*\\.\\.\\s*(low|normal|high))?\\s*$"
+      },
       notify: {
         type: "object",
         required: ["strategy"],
@@ -32118,14 +32173,46 @@ function explainVerdict(stages) {
     reason: stage?.reason ?? "Monitor delivered successfully."
   };
 }
+var URGENCY_BY_RANK = ["low", "normal", "high"];
+var URGENCY_RANK = {
+  low: 0,
+  normal: 1,
+  high: 2
+};
+function effectiveObservationUrgency(monitor, observation) {
+  const lo = monitor.frontmatter.urgency;
+  const hi = monitor.frontmatter.urgencyMax ?? lo;
+  const desired = observation.salience ?? lo;
+  const rank = Math.min(
+    Math.max(URGENCY_RANK[desired], URGENCY_RANK[lo]),
+    URGENCY_RANK[hi]
+  );
+  return URGENCY_BY_RANK[rank] ?? lo;
+}
 function serializeObservation(monitor, observation, observedAt) {
-  return { monitor, observation, observedAt };
+  return {
+    monitor,
+    observation,
+    observedAt,
+    effectiveUrgency: effectiveObservationUrgency(monitor, observation)
+  };
 }
 function hydrateStoredObservationEnvelope(envelope) {
   return {
     monitor: envelope.monitor,
     observation: envelope.observation,
-    observedAt: envelope.observedAt instanceof Date ? envelope.observedAt : new Date(envelope.observedAt)
+    observedAt: envelope.observedAt instanceof Date ? envelope.observedAt : new Date(envelope.observedAt),
+    // Restart-safety / upgrade backfill (002 §3, issue #109): a debounce batch
+    // persisted BEFORE the range-urgency upgrade will have no `effectiveUrgency`
+    // field on its envelopes. Recompute it from the envelope's `monitor` +
+    // `observation` so the materialized event row is never written with
+    // `undefined` urgency. `effectiveObservationUrgency` degrades cleanly when
+    // the hydrated monitor snapshot itself lacks `urgencyMax` (old monitor).
+    // The cast to `Urgency | undefined` is intentional: at compile time
+    // `StoredObservationEnvelope.effectiveUrgency` is always `Urgency`, but
+    // pre-upgrade deserialized JSON may lack the field entirely.
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    effectiveUrgency: envelope.effectiveUrgency ?? effectiveObservationUrgency(envelope.monitor, envelope.observation)
   };
 }
 var WEEKDAY_INDEX = {
@@ -32690,6 +32777,7 @@ var AgentMonitorRuntime = class {
     const now = /* @__PURE__ */ new Date();
     const emittedEventIds = [];
     const evaluated = [];
+    const erroredObservations = [];
     for (const parsed of result.monitors) {
       const monitor = parsed.monitor;
       const sourceName = monitor.frontmatter.watch.type;
@@ -32714,13 +32802,15 @@ var AgentMonitorRuntime = class {
           }
         );
       } catch (observeError) {
+        const message = observeError instanceof Error ? observeError.message : String(observeError);
+        erroredObservations.push({ monitorId: monitor.id, message });
         try {
           this.store.recordObservationHistory({
             monitorId: monitor.id,
             sourceName,
             result: "errored",
             observationData: {
-              error: observeError instanceof Error ? observeError.message : String(observeError)
+              error: message
             }
           });
         } catch {
@@ -32736,13 +32826,15 @@ var AgentMonitorRuntime = class {
           })
         );
       } catch (ingestError) {
+        const message = ingestError instanceof Error ? ingestError.message : String(ingestError);
+        erroredObservations.push({ monitorId: monitor.id, message });
         try {
           this.store.recordObservationHistory({
             monitorId: monitor.id,
             sourceName,
             result: "errored",
             observationData: {
-              error: ingestError instanceof Error ? ingestError.message : String(ingestError)
+              error: message
             }
           });
         } catch {
@@ -32750,7 +32842,11 @@ var AgentMonitorRuntime = class {
       }
     }
     this.refreshWorkspaceSessions(workspacePath);
-    return { evaluatedMonitors: evaluated, emittedEventIds };
+    return {
+      evaluatedMonitors: evaluated,
+      emittedEventIds,
+      erroredObservations
+    };
   }
   /**
    * Funnel a batch of observations through notify dispatch, persist the updated
@@ -32802,7 +32898,8 @@ var AgentMonitorRuntime = class {
           sourceName: emitted.monitor.frontmatter.watch.type,
           observation: emitted.observation,
           observedAt: emitted.observedAt,
-          workspacePath: options2.workspacePath
+          workspacePath: options2.workspacePath,
+          effectiveUrgency: emitted.effectiveUrgency
         });
         emittedEventIds.push(event.id);
       } catch (materializeError) {
@@ -33002,11 +33099,22 @@ var AgentMonitorRuntime = class {
       }
     }
     for (const observation of observations) {
+      const envelope = serializeObservation(monitor, observation, observedAt);
       const notify = defaultNotifyConfigForUrgency(
-        monitor.frontmatter.urgency,
+        envelope.effectiveUrgency,
         monitor.frontmatter.notify
       );
-      const envelope = serializeObservation(monitor, observation, observedAt);
+      const isEscalated = URGENCY_RANK[envelope.effectiveUrgency] > URGENCY_RANK[monitor.frontmatter.urgency];
+      if (isEscalated && nextState.pendingDebounce) {
+        emitted.push(
+          ...nextState.pendingDebounce.observations.map(
+            hydrateStoredObservationEnvelope
+          ),
+          envelope
+        );
+        delete nextState.pendingDebounce;
+        continue;
+      }
       if (!notify) {
         emitted.push(envelope);
         continue;
@@ -33060,7 +33168,7 @@ var AgentMonitorRuntime = class {
       workspacePath: input.workspacePath ?? null,
       monitorId: input.monitor.id,
       sourceName: input.sourceName,
-      urgency: input.monitor.frontmatter.urgency,
+      urgency: input.effectiveUrgency,
       title: input.observation.title,
       body: input.observation.body ?? input.monitor.instructions,
       summary: input.observation.summary ?? input.observation.body ?? input.observation.title,
@@ -35525,6 +35633,11 @@ function shouldReap(s) {
 
 // src/commands/daemon.ts
 var DEFAULT_REAP_AFTER_MS = 5 * 60 * 1e3;
+function appendErroredLines(summary, errored) {
+  if (errored.length === 0) return summary;
+  const lines = errored.map((e) => `  ${e.monitorId}: ${e.message}`);
+  return [summary, ...lines].join("\n");
+}
 async function runLoop(monitorsDir, workspacePath, pollMs, socketPath, reapAfterMs) {
   const runtime = createRuntime();
   let stopping = false;
@@ -35570,10 +35683,12 @@ async function runLoop(monitorsDir, workspacePath, pollMs, socketPath, reapAfter
     while (!isStoppingRequested()) {
       try {
         const result = await runtime.tick(monitorsDir, workspacePath);
-        if (result.emittedEventIds.length > 0) {
-          console.log(
-            `Emitted ${String(result.emittedEventIds.length)} event(s) from ${String(result.evaluatedMonitors.length)} monitor(s).`
+        if (result.emittedEventIds.length > 0 || result.erroredObservations.length > 0) {
+          const summary = appendErroredLines(
+            `Emitted ${String(result.emittedEventIds.length)} event(s) from ${String(result.evaluatedMonitors.length)} monitor(s)${result.erroredObservations.length > 0 ? `, ${String(result.erroredObservations.length)} errored:` : "."}`,
+            result.erroredObservations
           );
+          console.log(summary);
         }
       } catch (error2) {
         const message = error2 instanceof Error ? error2.message : String(error2);
@@ -35639,9 +35754,9 @@ daemonCommand.command("once").description("Run one runtime observation cycle").a
         console.log(JSON.stringify(result, null, 2));
         return;
       }
-      console.log(
-        `Evaluated ${String(result.evaluatedMonitors.length)} monitor(s), emitted ${String(result.emittedEventIds.length)} event(s).`
-      );
+      const erroredCount = result.erroredObservations.length;
+      const base = `Evaluated ${String(result.evaluatedMonitors.length)} monitor(s), emitted ${String(result.emittedEventIds.length)} event(s)${erroredCount > 0 ? `, ${String(erroredCount)} errored:` : "."}`;
+      console.log(appendErroredLines(base, result.erroredObservations));
     } catch (error2) {
       const message = error2 instanceof Error ? error2.message : String(error2);
       reportError(message, options2.format === "json");