@agentmonitors/cli 0.6.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 = {
@@ -32811,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) {
@@ -33011,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;
@@ -33069,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,