deepline 0.3.115 → 0.3.117

package/dist/cli/index.mjs

@@ -1271,7 +1271,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.115",
+  version: "0.3.117",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -5195,6 +5195,7 @@ var DeeplineClient = class {
       available: (toolIdOrOptions, options2) => this.getMonitorsAvailable(toolIdOrOptions, options2),
       check: (definition) => this.checkMonitor(definition),
       deploy: (definition, options2) => this.deployMonitor(definition, options2),
+      sync: (definition, options2) => options2?.dryRun ? this.deployMonitor(definition, { dryRun: true }) : this.syncScalarMonitor(definition, options2),
       list: (options2) => this.listMonitors(options2),
       get: (key) => this.getMonitor(key),
       test: (key, payload, options2) => this.testMonitorWebhook(key, payload, options2),
@@ -5203,6 +5204,18 @@ var DeeplineClient = class {
       update: (key, patch) => this.updateMonitor(key, patch),
       delete: (key, options2) => this.deleteMonitor(key, options2),
       reactivate: (key, options2) => this.reactivateMonitor(key, options2),
+      start: (key, options2) => options2?.dryRun ? this.submitMonitorBatch({
+        kind: "reactivate",
+        scope: { kind: "keys", monitorKeys: [key] },
+        dryRun: true,
+        idempotencyKey: options2.idempotencyKey ?? this.monitorJobIdempotencyKey(`start-${key}`)
+      }) : this.submitScalarMonitorLifecycle(key, "start", options2),
+      stop: (key, options2) => options2?.dryRun ? this.submitMonitorBatch({
+        kind: "deactivate",
+        scope: { kind: "keys", monitorKeys: [key] },
+        dryRun: true,
+        idempotencyKey: options2.idempotencyKey ?? this.monitorJobIdempotencyKey(`stop-${key}`)
+      }) : this.submitScalarMonitorLifecycle(key, "stop", options2),
       audit: (options2) => this.auditMonitors(options2),
       repair: (options2) => this.repairMonitors(options2),
       health: (options2) => this.readMonitorsHealth(options2),
@@ -5211,6 +5224,12 @@ var DeeplineClient = class {
         submit: (options2) => this.submitMonitorBatch(options2),
         get: (operationId, options2) => this.getMonitorBatch(operationId, options2)
       },
+      batches: {
+        sync: (batchId, definitions, options2) => this.syncNamedMonitorBatch(batchId, definitions, options2),
+        start: (batchId, options2) => this.startNamedMonitorBatch(batchId, options2),
+        stop: (batchId, options2) => this.stopNamedMonitorBatch(batchId, options2),
+        get: (batchId) => this.getNamedMonitorBatch(batchId)
+      },
       jobs: {
         get: (jobId) => this.getMonitorJob(jobId),
         logs: (jobId, options2) => this.getMonitorJobLogs(jobId, options2),
@@ -5224,6 +5243,8 @@ var DeeplineClient = class {
         list: () => this.listMonitorFleets(),
         deactivate: (fleetId, options2) => this.deactivateMonitorFleet(fleetId, options2),
         reactivate: (fleetId, options2) => this.reactivateMonitorFleet(fleetId, options2),
+        start: (fleetId, options2) => this.reactivateMonitorFleet(fleetId, options2),
+        stop: (fleetId, options2) => this.deactivateMonitorFleet(fleetId, options2),
         waitForConvergence: (fleetId, options2) => this.waitForMonitorFleetConvergence(fleetId, options2)
       }
     };
@@ -7874,7 +7895,8 @@ var DeeplineClient = class {
   /** List deployed monitors. Prefer `client.monitors.list(...)`. */
   async listMonitors(options) {
     const params = new URLSearchParams();
-    if (options?.status) params.set("status", options.status);
+    if (options?.state) params.set("state", options.state);
+    else if (options?.status) params.set("status", options.status);
     if (options?.limit !== void 0)
       params.set("limit", String(options.limit));
     if (options?.cursor) params.set("cursor", options.cursor);
@@ -8013,6 +8035,92 @@ var DeeplineClient = class {
       }
     );
   }
+  namedMonitorBatchPath(batchId) {
+    return `/api/v2/monitors/batches/${encodeURIComponent(batchId)}`;
+  }
+  async syncNamedMonitorBatch(batchId, definitions, options) {
+    return this.http.request(
+      this.namedMonitorBatchPath(batchId),
+      {
+        method: "PUT",
+        body: {
+          version: 1,
+          kind: "batch",
+          monitors: definitions,
+          ...options?.expectedGeneration === void 0 ? {} : { expected_generation: options.expectedGeneration }
+        },
+        headers: this.monitorJobHeaders(
+          `batch-sync-${batchId}`,
+          options?.idempotencyKey
+        ),
+        maxRetries: 0,
+        exactUrlOnly: true
+      }
+    );
+  }
+  async startNamedMonitorBatch(batchId, options) {
+    return this.http.request(
+      `${this.namedMonitorBatchPath(batchId)}/start`,
+      {
+        method: "POST",
+        body: {},
+        headers: this.monitorJobHeaders(
+          `batch-start-${batchId}`,
+          options?.idempotencyKey
+        ),
+        maxRetries: 0,
+        exactUrlOnly: true
+      }
+    );
+  }
+  async stopNamedMonitorBatch(batchId, options) {
+    return this.http.request(
+      this.namedMonitorBatchPath(batchId),
+      {
+        method: "DELETE",
+        body: {},
+        headers: this.monitorJobHeaders(
+          `batch-stop-${batchId}`,
+          options?.idempotencyKey
+        ),
+        maxRetries: 0,
+        exactUrlOnly: true
+      }
+    );
+  }
+  async getNamedMonitorBatch(batchId) {
+    return this.http.request(
+      this.namedMonitorBatchPath(batchId),
+      { method: "GET" }
+    );
+  }
+  async submitScalarMonitorLifecycle(monitorKey, action, options) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(monitorKey)}/${action}`,
+      {
+        method: "POST",
+        body: {},
+        headers: this.monitorJobHeaders(
+          `${action}-${monitorKey}`,
+          options?.idempotencyKey
+        ),
+        maxRetries: 0,
+        exactUrlOnly: true
+      }
+    );
+  }
+  async syncScalarMonitor(definition, options) {
+    return this.http.request("/api/v2/monitors/sync", {
+      method: "POST",
+      body: definition,
+      headers: this.monitorJobHeaders(
+        `sync-${definition.key}`,
+        options?.idempotencyKey
+      ),
+      maxRetries: 0,
+      exactUrlOnly: true
+    });
+  }
   async getMonitorJob(jobId) {
     return this.http.request(
       `/api/v2/monitors/jobs/${encodeURIComponent(jobId)}`,
@@ -33683,6 +33791,40 @@ function asRecord2(value) {
 function asString(value) {
   return typeof value === "string" && value.trim() ? value : void 0;
 }
+var MONITOR_STATES = /* @__PURE__ */ new Set([
+  "active",
+  "billing_suspended",
+  "disabled"
+]);
+function customerMonitorState(value) {
+  if (typeof value === "string" && MONITOR_STATES.has(value)) {
+    return value;
+  }
+  return void 0;
+}
+function readMonitorState(record3) {
+  const state = customerMonitorState(record3.state);
+  if (state) return state;
+  const legacyStatus = asString(record3.status);
+  if (legacyStatus === "active") return "active";
+  if (legacyStatus === "billing_suspended") return "billing_suspended";
+  if (legacyStatus === "disabled") return "disabled";
+  if (legacyStatus === "inactive") return "disabled";
+  if (typeof record3.active === "boolean") {
+    return record3.active ? "active" : "disabled";
+  }
+  return void 0;
+}
+function monitorStateFilter(value) {
+  if (value === "all") return "all";
+  return customerMonitorState(value);
+}
+function monitorStateFilterLabel(value, fallback = "active") {
+  const canonical = monitorStateFilter(value);
+  if (canonical) return canonical;
+  if (value === "inactive") return "disabled";
+  return fallback;
+}
 function asFiniteNumber(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -33773,14 +33915,14 @@ function renderMonitorDeployCompletion(payload) {
   if (!key || streams.length === 0) return void 0;
   const toolId = tool ?? (monitor ? asString(monitor.tool) : void 0) ?? "<tool>";
   const name = monitor ? asString(monitor.name) : void 0;
-  const status = monitor ? asString(monitor.status) : void 0;
+  const state = monitor ? readMonitorState(monitor) : void 0;
   const pricingLine = monitorPricingLine(monitor?.pricing ?? payload.pricing);
   const eventStreams = streams.filter((stream) => stream.isEvent);
   const matched = eventStreams.filter((stream) => stream.matchesPayload);
   const shown = matched.length ? matched : eventStreams.length ? eventStreams : streams;
   const primary = shown[0];
   const lines = [
-    `\u2713 Deployed monitor "${key}"${name ? ` (${name})` : ""} \u2014 tool ${toolId}${status ? `, status ${status}` : ""}`,
+    `\u2713 Deployed monitor "${key}"${name ? ` (${name})` : ""} \u2014 tool ${toolId}${state ? `, status ${state}` : ""}`,
     "",
     "Output \u2192 Customer DB:"
   ];
@@ -33881,10 +34023,10 @@ function renderMonitorDeployPlan(payload) {
     const key = candidate ? asString(candidate.key) : void 0;
     if (!candidate || !key) return [];
     const name = asString(candidate.name);
-    const status = asString(candidate.status);
+    const state = readMonitorState(candidate);
     const covers = asString(candidate.covers);
     return [
-      `  ${key}${name ? ` (${name})` : ""}${status ? ` \u2014 ${status}` : ""}${covers ? `; covers ${covers}` : ""}`
+      `  ${key}${name ? ` (${name})` : ""}${state ? ` \u2014 ${state}` : ""}${covers ? `; covers ${covers}` : ""}`
     ];
   });
   if (candidateLines.length > 0) {
@@ -34063,7 +34205,7 @@ async function handleMonitorsAvailable(toolId, options) {
     text: tool ? void 0 : renderAvailableToolsText(payload)
   });
 }
-function renderDeployedListText(payload, requestedStatus) {
+function renderDeployedListText(payload, requestedStatus, filterKind = "status") {
   const monitors = Array.isArray(payload.monitors) ? payload.monitors : null;
   if (!monitors) return void 0;
   const total = asFiniteNumber(payload.total);
@@ -34073,7 +34215,7 @@ function renderDeployedListText(payload, requestedStatus) {
     const entry = asRecord2(raw);
     const key = entry ? asString(entry.key) ?? asString(entry.monitor_key) : void 0;
     if (!entry || !key) continue;
-    const status = asString(entry.status);
+    const state = readMonitorState(entry);
     const tool = asString(entry.tool);
     const monitorType = asString(entry.type);
     const name = asString(entry.name);
@@ -34084,7 +34226,7 @@ function renderDeployedListText(payload, requestedStatus) {
     const lastReceivedEvent = asString(entry.last_received_event);
     const boundPlays = Array.isArray(entry.bound_plays) ? entry.bound_plays.length : void 0;
     lines.push(
-      `  ${key}${status ? `  ${status}` : ""}${tool ? `  ${tool}` : ""}${name ? `  (${name})` : ""}`
+      `  ${key}${state ? `  ${state}` : ""}${tool ? `  ${tool}` : ""}${name ? `  (${name})` : ""}`
     );
     if (outputTable || monitorType || webhookState || executionType || boundPlays !== void 0) {
       lines.push(
@@ -34106,30 +34248,38 @@ function renderDeployedListText(payload, requestedStatus) {
         const playName = asString(play?.name) ?? "unnamed Play";
         const health = asRecord2(play?.consumer_health);
         const healthRequested = Boolean(play && "consumer_health" in play);
-        const state = healthRequested ? asString(health?.last_run_status) ?? "no delivery yet" : "health not requested";
+        const state2 = healthRequested ? asString(health?.last_run_status) ?? "no delivery yet" : "health not requested";
         const lastError = asString(health?.last_error);
         lines.push(
-          `    consumer: ${playName} \u2014 ${state}${lastError ? ` (${lastError})` : ""}`
+          `    consumer: ${playName} \u2014 ${state2}${lastError ? ` (${lastError})` : ""}`
         );
       }
     }
   }
-  const applied = asString(payload.status_filter_applied) ?? requestedStatus ?? "active";
+  const applied = monitorStateFilterLabel(
+    payload.state_filter_applied ?? payload.status_filter_applied,
+    monitorStateFilterLabel(requestedStatus)
+  );
   lines.push(
-    `Status filter: ${applied}${requestedStatus === void 0 && applied === "active" ? " (default)" : ""} \u2014 use --status all to include inactive monitors.`
+    `State filter: ${applied}${requestedStatus === void 0 && applied === "active" ? " (default)" : ""} \u2014 use --state all to include all monitors.`
   );
-  const summary = Array.isArray(payload.status_summary) ? payload.status_summary.flatMap((raw) => {
+  const rawSummary = Array.isArray(payload.state_summary) ? payload.state_summary : Array.isArray(payload.status_summary) ? payload.status_summary : [];
+  const summary = rawSummary.flatMap((raw) => {
     const item = asRecord2(raw);
-    const status = item ? asString(item.status) : void 0;
+    const state = item ? readMonitorState(item) : void 0;
     const count = item ? asFiniteNumber(item.count) : void 0;
-    return status && count !== void 0 ? [`${status}: ${count}`] : [];
-  }).join("  ") : "";
-  if (summary) lines.push(`All monitor states: ${summary}`);
+    return state && count !== void 0 ? [`${state}: ${count}`] : [];
+  }).join("  ");
+  if (summary) {
+    lines.push(
+      `${payload.state_summary_scope === "filter_total" ? "Matching monitors" : "Current page states"}: ${summary}`
+    );
+  }
   if (payload.has_more === true || payload.is_truncated === true) {
     const nextCursor = asString(payload.next_cursor);
     lines.push(
       total !== void 0 ? `List truncated \u2014 showing ${monitors.length} of ${total}. Before concluding "no matching monitor exists," page the full registry:` : 'List truncated. Before concluding "no matching monitor exists," page the full registry:',
-      nextCursor ? `  deepline monitors list${requestedStatus ? ` --status ${requestedStatus}` : ""} --cursor ${nextCursor}` : "  raise --limit above the reported total."
+      nextCursor ? `  deepline monitors list${requestedStatus ? ` --${filterKind} ${filterKind === "state" ? monitorStateFilterLabel(requestedStatus) : requestedStatus}` : ""} --cursor ${nextCursor}` : "  raise --limit above the reported total."
     );
   }
   if (monitors.length > 0) {
@@ -34139,12 +34289,19 @@ function renderDeployedListText(payload, requestedStatus) {
 `;
 }
 async function handleMonitorsList(options) {
+  const state = options.state ? monitorStateFilter(options.state) : void 0;
+  if (options.state !== void 0 && !state) {
+    throw new MonitorsUsageError(
+      `--state must be active, billing_suspended, disabled, or all; received ${options.state}.`
+    );
+  }
   if (options.compact) {
     process.stderr.write(
       "`--compact` is deprecated and now does nothing; returning the complete monitor records.\n"
     );
   }
   const payload = await new DeeplineClient().monitors.list({
+    ...state ? { state } : {},
     ...options.status ? { status: options.status } : {},
     ...options.limit ? { limit: options.limit } : {},
     ...options.cursor ? { cursor: options.cursor } : {},
@@ -34152,7 +34309,11 @@ async function handleMonitorsList(options) {
   });
   printCommandEnvelope(payload, {
     json: options.json,
-    text: renderDeployedListText(payload, options.status)
+    text: renderDeployedListText(
+      payload,
+      options.state ?? options.status,
+      options.state !== void 0 ? "state" : "status"
+    )
   });
 }
 async function handleMonitorsCheck(definition, options) {
@@ -34197,6 +34358,40 @@ async function handleMonitorsDeploy(definition, options) {
     text: renderMonitorDeployCompletion(payload)
   });
 }
+async function handleMonitorsSync(definition, options) {
+  const body = resolveMonitorJsonBody({
+    positional: definition,
+    file: options.file,
+    argLabel: "<definition>",
+    command: "deepline monitors sync"
+  });
+  const payload = await new DeeplineClient().monitors.sync(body, {
+    ...options.dryRun ? { dryRun: true } : {},
+    idempotencyKey: options.idempotencyKey ?? monitorJobIdempotencyKey("scalar-sync", void 0)
+  });
+  if (options.dryRun) {
+    const plan = payload;
+    printCommandEnvelope(
+      { dry_run: true, ...plan },
+      { json: options.json, text: renderMonitorDeployPlan(plan) }
+    );
+    return;
+  }
+  printCommandEnvelope(payload, {
+    json: options.json,
+    text: renderMonitorJob(payload)
+  });
+}
+async function handleScalarMonitorLifecycle(action, key, options) {
+  const payload = await new DeeplineClient().monitors[action](key, {
+    ...options.dryRun ? { dryRun: true } : {},
+    idempotencyKey: options.idempotencyKey ?? monitorJobIdempotencyKey(`${action}-${key}`, void 0)
+  });
+  printCommandEnvelope(payload, {
+    json: options.json,
+    text: options.dryRun ? void 0 : renderMonitorJob(payload)
+  });
+}
 function fleetIntegerOption(raw, flag) {
   if (raw === void 0) return void 0;
   const value = Number(raw);
@@ -34250,7 +34445,7 @@ function renderMonitorJob(payload) {
   ];
   if (counts) {
     lines.push(
-      `Counts: requested ${asFiniteNumber(counts.requested) ?? 0}, created ${asFiniteNumber(counts.created) ?? 0}, unchanged ${asFiniteNumber(counts.unchanged) ?? 0}, verified ${asFiniteNumber(counts.verified) ?? 0}, failed ${asFiniteNumber(counts.failed) ?? 0}`
+      `Counts: requested ${asFiniteNumber(counts.requested) ?? 0}, created ${asFiniteNumber(counts.created) ?? 0}, updated ${asFiniteNumber(counts.updated) ?? 0}, removed ${asFiniteNumber(counts.removed) ?? 0}, unchanged ${asFiniteNumber(counts.unchanged) ?? 0}, verified ${asFiniteNumber(counts.verified) ?? 0}, failed ${asFiniteNumber(counts.failed) ?? 0}`
     );
   }
   if (reconciliation) {
@@ -34290,6 +34485,93 @@ async function handleMonitorJobBatchDeploy(options, idempotencyKey) {
     { json: options.json, text: renderMonitorJob(payload) }
   );
 }
+function namedBatchIdempotencyKey(batchId, intent, supplied) {
+  return supplied?.trim() || `monitor-batch-${intent}-${batchId}-${randomUUID5()}`;
+}
+async function handleNamedMonitorBatchSync(batchId, options) {
+  if (!options.file) {
+    throw new MonitorsUsageError(
+      "monitors batches sync requires --file <batch.json>."
+    );
+  }
+  const lint = lintMonitorBatchInput(
+    readMonitorDefinitionsJsonFile(options.file)
+  );
+  if (!lint.normalized) {
+    throw new MonitorsUsageError(
+      lint.issues.filter((issue) => issue.severity === "error").map((issue) => `${issue.path || "batch"}: ${issue.message}`).join("; ")
+    );
+  }
+  const parsedGeneration = options.expectedGeneration === void 0 ? void 0 : Number(options.expectedGeneration);
+  if (parsedGeneration !== void 0 && (!Number.isSafeInteger(parsedGeneration) || parsedGeneration < 0)) {
+    throw new MonitorsUsageError(
+      "--expected-generation must be a non-negative integer."
+    );
+  }
+  if (options.dryRun) {
+    printCommandEnvelope(
+      {
+        ok: true,
+        dry_run: true,
+        batch: { id: batchId, desired_count: lint.normalized.monitors.length },
+        issues: lint.issues,
+        next: `deepline monitors batches sync ${batchId} --file ${options.file} --idempotency-key <stable-key> --json`
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const idempotencyKey = namedBatchIdempotencyKey(
+    batchId,
+    "sync",
+    options.idempotencyKey
+  );
+  const payload = await new DeeplineClient().monitors.batches.sync(
+    batchId,
+    lint.normalized.monitors,
+    {
+      idempotencyKey,
+      ...parsedGeneration === void 0 ? {} : { expectedGeneration: parsedGeneration }
+    }
+  );
+  printCommandEnvelope(
+    { ...payload, idempotency_key: idempotencyKey },
+    { json: options.json, text: renderMonitorJob(payload) }
+  );
+}
+async function handleNamedMonitorBatchLifecycle(batchId, intent, options) {
+  if (options.dryRun) {
+    printCommandEnvelope(
+      {
+        ok: true,
+        dry_run: true,
+        batch: { id: batchId, intent },
+        next: `deepline monitors batches ${intent} ${batchId} --idempotency-key <stable-key> --json`
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const idempotencyKey = namedBatchIdempotencyKey(
+    batchId,
+    intent,
+    options.idempotencyKey
+  );
+  const payload = await new DeeplineClient().monitors.batches[intent](batchId, {
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ...payload, idempotency_key: idempotencyKey },
+    { json: options.json, text: renderMonitorJob(payload) }
+  );
+}
+async function handleNamedMonitorBatchGet(batchId, options) {
+  const payload = await new DeeplineClient().monitors.batches.get(batchId);
+  printCommandEnvelope(payload, {
+    json: options.json,
+    text: renderMonitorJob(payload)
+  });
+}
 async function handleMonitorBatchLint(options) {
   if (!options.file) {
     throw new MonitorsUsageError(
@@ -34539,9 +34821,10 @@ function renderFleetSync(payload, input2) {
 }
 function renderFleetGet(payload) {
   const id = asString(payload.id) ?? "unknown";
-  const status = fleetStatus(payload) ?? "unknown";
+  const state = readMonitorState(payload) ?? "unknown";
+  const status = fleetStatus(payload);
   const lines = [
-    `Fleet ${id} \u2014 ${status}`,
+    `Fleet ${id} \u2014 state ${state}`,
     `  monitors  ${asFiniteNumber(payload.live) ?? 0} live / ${asFiniteNumber(payload.expected) ?? 0} expected`,
     `  counts  ${fleetCountsLine(payload)}`,
     `  generation ${asFiniteNumber(payload.generation) ?? "unknown"} \xB7 converged generation ${asFiniteNumber(payload.converged_generation) ?? "none"}`
@@ -34620,8 +34903,8 @@ function renderFleetList(payload) {
     (max, fleet) => Math.max(max, (asString(fleet.id) ?? "").length),
     0
   );
-  const statusWidth = fleets.reduce(
-    (max, fleet) => Math.max(max, (fleetStatus(fleet) ?? "unknown").length),
+  const stateWidth = fleets.reduce(
+    (max, fleet) => Math.max(max, (readMonitorState(fleet) ?? "unknown").length),
     0
   );
   const lines = [`Fleets (${fleets.length})`];
@@ -34632,7 +34915,7 @@ function renderFleetList(payload) {
       counts.failed ? `failed ${counts.failed}` : ""
     ].filter(Boolean);
     lines.push(
-      `  ${(asString(fleet.id) ?? "-").padEnd(idWidth)}  ${(fleetStatus(fleet) ?? "unknown").padEnd(statusWidth)}  ${asFiniteNumber(fleet.live) ?? 0}/${asFiniteNumber(fleet.expected) ?? 0}${trouble.length ? `  ${trouble.join(" \xB7 ")}` : ""}`
+      `  ${(asString(fleet.id) ?? "-").padEnd(idWidth)}  ${(readMonitorState(fleet) ?? "unknown").padEnd(stateWidth)}  ${asFiniteNumber(fleet.live) ?? 0}/${asFiniteNumber(fleet.expected) ?? 0}${trouble.length ? `  ${trouble.join(" \xB7 ")}` : ""}`
     );
   }
   return `${lines.join("\n")}
@@ -34973,7 +35256,7 @@ async function handleMonitorFleetsReactivate(fleetId, options, idempotencyKey) {
   if (!options.wait) {
     printCommandEnvelope(accepted, {
       json: options.json,
-      text: `Fleet ${fleetId} \u2014 ${asString(payload.status) ?? "billing_reactivating"}
+      text: `Fleet ${fleetId} \u2014 ${readMonitorState(payload) ? `state ${readMonitorState(payload)}` : "reactivation accepted"}
   idempotency key ${idempotencyKey}
 `
     });
@@ -35091,7 +35374,7 @@ Preview the blast radius first:
     });
     return;
   }
-  const acceptedText = `Fleet ${fleetId} \u2014 ${asString(payload.status) ?? "deactivating"}
+  const acceptedText = `Fleet ${fleetId} \u2014 ${readMonitorState(payload) ? `state ${readMonitorState(payload)}` : "deactivation accepted"}
   idempotency key ${idempotencyKey}
 ` + (fleetServerNext(payload) ? `Next: ${fleetServerNext(payload)}
 ` : "");
@@ -35165,7 +35448,7 @@ function renderMonitorGet(payload) {
   const key = asString(payload.key);
   const tool = asString(payload.tool);
   if (!key || !tool) return void 0;
-  const status = asString(payload.status);
+  const state = readMonitorState(payload);
   const monitorType = asString(payload.type);
   const hasLastReceivedEvent = "last_received_event" in payload;
   const lastReceivedEvent = asString(payload.last_received_event);
@@ -35185,7 +35468,7 @@ function renderMonitorGet(payload) {
     `Monitor: ${key}`,
     `Tool: ${tool}`,
     ...monitorType ? [`Type: ${monitorType}`] : [],
-    ...status ? [`Status: ${status}`] : [],
+    ...state ? [`Status: ${state}`] : [],
     ...hasLastReceivedEvent ? [`Latest inbound event: ${lastReceivedEvent ?? "never"}`] : [],
     ...pricingLine ? [`Pricing: ${pricingLine}`] : [],
     ...nextRenewalAt ? [`Next renewal: ${nextRenewalAt}`] : []
@@ -35622,27 +35905,15 @@ function monitorBatchScope(options, kind) {
 function monitorBatchIdempotencyKey(kind, value) {
   return value?.trim() || `monitor-batch-${kind}-${randomUUID5()}`;
 }
-function legacyDryRunManifest(raw) {
-  let parsed;
+function isCanonicalBatchJsonDocument(raw) {
   try {
-    parsed = JSON.parse(raw);
+    const parsed = JSON.parse(raw);
+    if (Array.isArray(parsed)) return true;
+    const input2 = asRecord2(parsed);
+    return input2 !== null && (input2.kind === "batch" || Object.prototype.hasOwnProperty.call(input2, "monitors") || Object.prototype.hasOwnProperty.call(input2, "version"));
   } catch {
-    return raw;
-  }
-  const object = asRecord2(parsed);
-  if (object && asString(object.key) && asString(object.tool)) {
-    return raw;
-  }
-  const isBatchDocument = Array.isArray(parsed) || object !== null && (Object.prototype.hasOwnProperty.call(object, "monitors") || object.kind === "batch");
-  if (!isBatchDocument) return raw;
-  const lint = lintMonitorBatchInput(parsed);
-  if (!lint.normalized) {
-    throw new MonitorsUsageError(
-      lint.issues.filter((issue) => issue.severity === "error").map((issue) => `${issue.path || "batch"}: ${issue.message}`).join("; ")
-    );
+    return false;
   }
-  return `${lint.normalized.monitors.map((monitor) => JSON.stringify(monitor)).join("\n")}
-`;
 }
 async function handleMonitorBatchDeploy(options) {
   if (!options.file?.trim()) {
@@ -35666,8 +35937,10 @@ async function handleMonitorBatchDeploy(options) {
   if (!manifestNdjson.trim()) {
     throw new MonitorsUsageError("Monitor batch manifest is empty.");
   }
-  if (options.dryRun === true) {
-    manifestNdjson = legacyDryRunManifest(manifestNdjson);
+  if (isCanonicalBatchJsonDocument(manifestNdjson)) {
+    throw new MonitorsUsageError(
+      "Canonical Batch JSON cannot use --dry-run or --yes; those flags select the retained legacy NDJSON operation. Run `deepline monitors batch lint --file <batch.json> --json`, then submit the Monitor Job with `deepline monitors batch deploy --file <batch.json> --idempotency-key <key> --json`."
+    );
   }
   const idempotencyKey = monitorBatchIdempotencyKey(
     "deploy",
@@ -35869,7 +36142,7 @@ Examples:
     ).requiredOption(
       "--file <path>",
       'Batch JSON ({"version":1,"kind":"batch","monitors":[...]}), or legacy NDJSON with --yes/--dry-run'
-    ).option("--dry-run", "Use the retained legacy batch-operation plan").option("--yes", "Use the retained legacy NDJSON batch operation").option(
+    ).option("--dry-run", "Preview a retained legacy NDJSON batch operation").option("--yes", "Confirm a retained legacy NDJSON batch operation").option(
       "--idempotency-key <key>",
       "Stable retry key (generated when omitted)"
     )
@@ -35936,6 +36209,46 @@ Examples:
   withJsonOption(
     batch.command("get <operation-id>").description("Read batch progress and one bounded evidence page.").option("--cursor <cursor>", "Read the next retained evidence page")
   ).action(monitorsAction(handleMonitorBatchGet));
+  const namedBatches = monitors.command("batches").description(
+    "Manage stable named Batches whose omitted members are stopped."
+  );
+  withJsonOption(namedBatches);
+  withJsonOption(
+    namedBatches.command("sync <batch-id>").description(
+      "Publish the complete desired member set and return one Monitor Job."
+    ).requiredOption(
+      "--file <path>",
+      "Canonical Batch JSON file, or - for stdin"
+    ).option(
+      "--dry-run",
+      "Validate and show the desired count without publishing"
+    ).option("--expected-generation <n>", "Reject a stale concurrent update").option("--idempotency-key <key>", "Stable retry key")
+  ).action(monitorsAction(handleNamedMonitorBatchSync));
+  withJsonOption(
+    namedBatches.command("start <batch-id>").description("Reapply the retained member set through one Monitor Job.").option(
+      "--dry-run",
+      "Show the retained-intent operation without publishing"
+    ).option("--idempotency-key <key>", "Stable retry key")
+  ).action(
+    monitorsAction(
+      (batchId, options) => handleNamedMonitorBatchLifecycle(batchId, "start", options)
+    )
+  );
+  withJsonOption(
+    namedBatches.command("stop <batch-id>").description(
+      "Publish an empty desired set while retaining members for start."
+    ).option(
+      "--dry-run",
+      "Show the retained-intent operation without publishing"
+    ).option("--idempotency-key <key>", "Stable retry key")
+  ).action(
+    monitorsAction(
+      (batchId, options) => handleNamedMonitorBatchLifecycle(batchId, "stop", options)
+    )
+  );
+  withJsonOption(
+    namedBatches.command("get <batch-id>").description("Read named Batch intent and its latest Monitor Job.")
+  ).action(monitorsAction(handleNamedMonitorBatchGet));
   withJsonOption(
     monitors.command("status").description("Check whether you have access to Deepline monitors.").addHelpText(
       "after",
@@ -35987,9 +36300,11 @@ Examples:
       "after",
       `
 Notes:
-  Read-only. A monitor state is active or inactive; provider disagreement is
-  reported separately by audit/health. The output echoes the state filter that
-  was applied. The response reports
+  Read-only. A monitor has one of three customer states: active,
+  billing_suspended, or disabled. Provisioning, cleanup, retries, and failures
+  are reported by Monitor Jobs; provider disagreement is reported separately by
+  audit/health. The output echoes the canonical state filter that was applied.
+  The legacy --status flag remains accepted for installed clients. The response reports
   total (the true registry count, not the page size), returned, has_more, and
   next_cursor. When has_more is true, page with --cursor <next_cursor> until it
   is false \u2014 a "no matching
@@ -36001,13 +36316,18 @@ Notes:
 
 Examples:
   deepline monitors list
+  deepline monitors list --state billing_suspended --json
+  deepline monitors list --state all --json
   deepline monitors list --status all --json
   deepline monitors list --status all --cursor <next_cursor> --json
   deepline monitors list --include-consumers --limit 20 --json
 `
+    ).option(
+      "--state <state>",
+      "Filter by customer state: active (default), billing_suspended, disabled, or all"
     ).option(
       "--status <status>",
-      "Filter by monitor state: active (default), inactive, or all"
+      "Deprecated compatibility filter; use --state (active, billing_suspended, disabled, or all)"
     ).option("--limit <n>", "Limit the number of deployed monitors returned").option(
       "--cursor <cursor>",
       "Page past a truncated result using the next_cursor from a prior list response"
@@ -36105,13 +36425,10 @@ Notes:
   no separate repair command or retry queue: rerun the same deploy/update.
   Scheduled reconciliation can also finish that exact saved cleanup; it never
   creates another monitor.
-  For TamRadar, deliberately changing payload.updates_since on an initial or
-  active definition is an explicit historical replay request. A disabled
-  monitor cannot stage this change; Deepline rejects that update. Filter-only
-  deploys and ordinary reactivation omit the field and start the provider
-  resource at creation instead.
-  New Hire and Promotion source dates use calendar-month precision upstream,
-  so Deepline rejects current-month updates_since values for those radar types.
+  For TamRadar, deliberately changing payload.updates_since is an explicit
+  historical replay request, including when redeploying a disabled monitor.
+  Deepline preserves that selected boundary; filter-only deploys and ordinary
+  reactivation start from a fresh future-only source boundary instead.
   Operational controls are Deepline-managed. A monitor writes rows; downstream
   automation belongs in a Play with sqlListeners.
 
@@ -36128,6 +36445,17 @@ Examples:
       "Validate and show the deploy plan (cost, reuse candidates) without deploying"
     )
   ).action(monitorsAction(handleMonitorsDeploy));
+  withJsonOption(
+    monitors.command("sync [definition]").description(
+      "Publish one complete desired monitor definition and return a Monitor Job."
+    ).option(
+      "-f, --file <path>",
+      "Read definition JSON from a file, or - for stdin"
+    ).option(
+      "--dry-run",
+      "Validate and show the deploy plan without publishing"
+    ).option("--idempotency-key <key>", "Stable retry key")
+  ).action(monitorsAction(handleMonitorsSync));
   withJsonOption(
     monitors.command("update <key> [patch]").description("Update a deployed monitor by its public key.").addHelpText(
       "after",
@@ -36143,9 +36471,7 @@ For TamRadar, changing payload.updates_since on an initial or active definition
 is an explicit historical replay request. Deepline passes that requested boundary upstream, but previously
 delivered canonical findings are deduplicated before dispatch and billing; only
 previously unseen historical findings are chargeable. Filter-only updates,
-repair, and reactivation instead omit the field and start the provider resource
-at creation. New Hire and Promotion source dates use calendar-month precision,
-so current-month updates_since values are rejected for those radar types.
+repair, and reactivation instead use a fresh future-only source boundary.
 
 Examples:
   deepline monitors update my-monitor '{"name":"Interested replies"}' --json
@@ -36198,6 +36524,22 @@ Examples:
 `
     ).option("--dry-run", "Show the reactivation cost without reactivating")
   ).action(monitorsAction(handleMonitorsReactivate));
+  withJsonOption(
+    monitors.command("start <key>").description("Apply the retained definition for a stopped monitor.").option("--dry-run", "Show the start plan without changing anything").option("--idempotency-key <key>", "Stable retry key")
+  ).action(
+    monitorsAction(
+      (key, options) => handleScalarMonitorLifecycle("start", key, options)
+    )
+  );
+  withJsonOption(
+    monitors.command("stop <key>").description(
+      "Stop a monitor upstream while retaining its definition for `start`."
+    ).option("--dry-run", "Show the stop plan without changing anything").option("--idempotency-key <key>", "Stable retry key")
+  ).action(
+    monitorsAction(
+      (key, options) => handleScalarMonitorLifecycle("stop", key, options)
+    )
+  );
   const jobs = monitors.command("jobs").description("Read, wait for, inspect, or cancel Monitor Jobs.");
   withJsonOption(jobs);
   withJsonOption(
@@ -36377,7 +36719,7 @@ Examples:
     )
   ).action(monitorsAction(handleMonitorFleetsGet));
   withJsonOption(
-    fleets.command("deactivate <fleet-id>").description("Deactivate a fleet and the monitors it owns.").addHelpText(
+    fleets.command("deactivate <fleet-id>").alias("stop").description("Deactivate a fleet and the monitors it owns.").addHelpText(
       "after",
       `
 Notes:
@@ -36416,7 +36758,7 @@ Examples:
     }
   });
   withJsonOption(
-    fleets.command("reactivate <fleet-id>").description(
+    fleets.command("reactivate <fleet-id>").alias("start").description(
       "Explicitly recreate a fleet after a credit-triggered suspension."
     ).addHelpText(
       "after",
@@ -36451,8 +36793,11 @@ Example:
   });
   const deployed = withJsonOption(
     monitors.command("deployed", { hidden: true }).description("Alias of `monitors list` (plus get/update/delete aliases).").option(
+      "--state <state>",
+      "Filter by customer state: active (default), billing_suspended, disabled, or all"
+    ).option(
       "--status <status>",
-      "Filter by monitor state: active (default), inactive, or all"
+      "Deprecated compatibility filter; use --state (active, billing_suspended, disabled, or all)"
     ).option("--limit <n>", "Limit the number of deployed monitors returned").option(
       "--cursor <cursor>",
       "Page past a truncated result using the next_cursor from a prior list response"