deepline 0.3.97 → 0.3.98

package/dist/install-integrity.json

@@ -12,6 +12,7 @@
     "dist/bundling-sources/sdk/src/index.ts",
     "dist/bundling-sources/sdk/src/monitor-fleet-contract.ts",
     "dist/bundling-sources/sdk/src/monitor-fleets.ts",
+    "dist/bundling-sources/sdk/src/monitor-input-contract.ts",
     "dist/bundling-sources/sdk/src/monitors.ts",
     "dist/bundling-sources/sdk/src/pagination.ts",
     "dist/bundling-sources/sdk/src/play.ts",
@@ -28,6 +29,7 @@
     "dist/bundling-sources/shared_libs/integration-contracts/bettercontact/execution-policy.ts",
     "dist/bundling-sources/shared_libs/integration-contracts/index.ts",
     "dist/bundling-sources/shared_libs/integration-contracts/monitor-fleet-contract.ts",
+    "dist/bundling-sources/shared_libs/integration-contracts/monitor-input-contract.ts",
     "dist/bundling-sources/shared_libs/integration-contracts/README.md",
     "dist/bundling-sources/shared_libs/integration-contracts/theirstack/execution-policy.ts",
     "dist/bundling-sources/shared_libs/monitors/analytics-install-guides.ts",
@@ -517,6 +519,10 @@
     "dist/monitor-fleet-contract.d.ts",
     "dist/monitor-fleet-contract.js",
     "dist/monitor-fleet-contract.mjs",
+    "dist/monitor-input-contract.d.mts",
+    "dist/monitor-input-contract.d.ts",
+    "dist/monitor-input-contract.js",
+    "dist/monitor-input-contract.mjs",
     "dist/plays/bundle-play-file.d.mts",
     "dist/plays/bundle-play-file.d.ts",
     "dist/plays/bundle-play-file.mjs",

package/dist/monitor-fleet-contract.d.mts

@@ -12,12 +12,18 @@ declare const MONITOR_FLEET_FRONTIER_MAX_ROWS = 10000;
  * edition: a future syntax change can add a reader without reinterpreting a
  * stored Fleet under new rules.
  */
-declare const MONITOR_FLEET_AUTHORING_CONTRACT_EDITION: 1;
-declare const SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS: readonly [1];
+declare const MONITOR_FLEET_AUTHORING_CONTRACT_EDITION: 2;
+declare const SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2];
 type MonitorFleetAuthoringContractEdition = (typeof SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS)[number];
 declare const MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG: readonly [{
     readonly edition: 1;
-    readonly changed: "Initial Fleet JSON contract: bounded sticky table membership, one daily sync, and a seven-day removal grace.";
+    readonly changed: "Initial Fleet JSON contract: bounded sticky table membership, source refresh, and a seven-day removal grace.";
+    readonly compatibilityOwner: "Monitors Runtime";
+    readonly newWritesEnd: null;
+    readonly readerRemoval: null;
+}, {
+    readonly edition: 2;
+    readonly changed: "Canonical table-backed Fleet envelope with one Handlebars MonitorSpec template.";
     readonly compatibilityOwner: "Monitors Runtime";
     readonly newWritesEnd: null;
     readonly readerRemoval: null;
@@ -39,11 +45,11 @@ declare const MONITOR_FLEET_DOCUMENTATION: {
     readonly authoredFields: {
         readonly id: "Stable lowercase fleet id used by sync, get, and deactivate.";
         readonly source: "Customer DB table, unique row key, and optional equality filters that select candidate rows.";
-        readonly member: "Ordinary monitor tool, stable key template, and payload evaluated for each selected source row.";
+        readonly monitor: "One Batch-compatible MonitorSpec. Direct Handlebars source-row fields such as {{domain}} are rendered for each selected row.";
         readonly selection: "Deterministic ranking and an active-member limit between 1 and 1,000.";
     };
     readonly fixedPolicy: {
-        readonly cadence: "daily";
+        readonly cadence: "60s fair bounded source refresh";
         readonly membership: "sticky";
         readonly removalGrace: "7d";
         readonly onRemoved: "deactivate";
@@ -51,7 +57,8 @@ declare const MONITOR_FLEET_DOCUMENTATION: {
         readonly billing: "No Fleet fee, permit, or renewal. Dry-run reports ordinary monitor lifecycle charges due now.";
     };
     readonly stickyMembership: "Ranking fills vacancies but never replaces a current member merely because another row ranks higher.";
-    readonly columnExpression: "Use { \"$fleet\": \"column\", \"name\": \"column_name\" } in a member key or payload to read a value from each source row.";
+    readonly templating: "Use direct Handlebars fields such as {{domain}} in monitor key, name, or payload. Helpers, blocks, partials, paths, and prototype access are disabled.";
+    readonly legacyCompatibility: "Edition 1 member/$fleet files remain readable with a lint warning; new files should use version: 2, kind: \"fleet\", and monitor.";
 };
 type MonitorFleetColumn = {
     $fleet: 'column';
@@ -62,7 +69,7 @@ type MonitorFleetTemplate = {
     parts: Array<string | MonitorFleetColumn>;
 };
 type MonitorFleetExpression = MonitorFleetColumn | MonitorFleetTemplate;
-type MonitorFleetDefinition = {
+type MonitorFleetDefinitionV1 = {
     /** Stable lowercase fleet id, used by CLI and API lifecycle commands. */
     id: string;
     /** Customer DB rows that may become members. */
@@ -96,6 +103,24 @@ type MonitorFleetDefinition = {
         membership: 'sticky';
     };
 };
+/**
+ * Edition 2 keeps the public file self-describing and aligns the rendered
+ * member with Batch exactly. Only source-row values may be interpolated.
+ */
+type MonitorFleetDefinitionV2 = {
+    version: 2;
+    kind: 'fleet';
+    id: string;
+    source: MonitorFleetDefinitionV1['source'];
+    monitor: {
+        key: string;
+        tool: string;
+        name?: string;
+        payload: Record<string, unknown>;
+    };
+    selection: MonitorFleetDefinitionV1['selection'];
+};
+type MonitorFleetDefinition = MonitorFleetDefinitionV1 | MonitorFleetDefinitionV2;
 type MonitorFleetContractIssue = {
     path: string;
     code: string;
@@ -114,6 +139,7 @@ type MonitorFleetAuthoringContractResult = {
 declare function fleetColumn(name: string): MonitorFleetColumn;
 declare function fleetKey(...parts: Array<string | MonitorFleetColumn>): MonitorFleetTemplate;
 declare function defineMonitorFleet<const T extends MonitorFleetDefinition>(definition: T): T;
+/** Validate the declared edition, or detect canonical v2 versus legacy v1. */
 declare function validateMonitorFleetDefinition(value: unknown): {
     valid: boolean;
     definition?: MonitorFleetDefinition;
@@ -126,6 +152,16 @@ declare function validateMonitorFleetDefinition(value: unknown): {
  * preflight, which returns the real plan and the credits due.
  */
 declare function admitMonitorFleetAuthoringContract(value: unknown, edition?: number): MonitorFleetAuthoringContractResult;
+/**
+ * Fast provider-free admission shared by the Fleet CLI, SDK, and API. Legacy
+ * documents remain executable but receive an actionable migration warning.
+ */
+declare function lintMonitorFleetInput(value: unknown): {
+    normalized?: MonitorFleetDefinition;
+    issues: Array<MonitorFleetContractIssue & {
+        severity: 'error' | 'warning';
+    }>;
+};
 declare function evaluateMonitorFleetValue(value: unknown, row: Record<string, unknown>): unknown;
 
-export { type AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MONITOR_FLEET_REMOVAL_GRACE_MS, type MonitorFleetAuthoringContractEdition, type MonitorFleetAuthoringContractResult, type MonitorFleetColumn, type MonitorFleetContractIssue, type MonitorFleetDefinition, type MonitorFleetExpression, type MonitorFleetTemplate, SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS, admitMonitorFleetAuthoringContract, defineMonitorFleet, evaluateMonitorFleetValue, fleetColumn, fleetKey, validateMonitorFleetDefinition };
+export { type AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MONITOR_FLEET_REMOVAL_GRACE_MS, type MonitorFleetAuthoringContractEdition, type MonitorFleetAuthoringContractResult, type MonitorFleetColumn, type MonitorFleetContractIssue, type MonitorFleetDefinition, type MonitorFleetDefinitionV1, type MonitorFleetDefinitionV2, type MonitorFleetExpression, type MonitorFleetTemplate, SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS, admitMonitorFleetAuthoringContract, defineMonitorFleet, evaluateMonitorFleetValue, fleetColumn, fleetKey, lintMonitorFleetInput, validateMonitorFleetDefinition };

package/dist/monitor-fleet-contract.d.ts

@@ -12,12 +12,18 @@ declare const MONITOR_FLEET_FRONTIER_MAX_ROWS = 10000;
  * edition: a future syntax change can add a reader without reinterpreting a
  * stored Fleet under new rules.
  */
-declare const MONITOR_FLEET_AUTHORING_CONTRACT_EDITION: 1;
-declare const SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS: readonly [1];
+declare const MONITOR_FLEET_AUTHORING_CONTRACT_EDITION: 2;
+declare const SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2];
 type MonitorFleetAuthoringContractEdition = (typeof SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS)[number];
 declare const MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG: readonly [{
     readonly edition: 1;
-    readonly changed: "Initial Fleet JSON contract: bounded sticky table membership, one daily sync, and a seven-day removal grace.";
+    readonly changed: "Initial Fleet JSON contract: bounded sticky table membership, source refresh, and a seven-day removal grace.";
+    readonly compatibilityOwner: "Monitors Runtime";
+    readonly newWritesEnd: null;
+    readonly readerRemoval: null;
+}, {
+    readonly edition: 2;
+    readonly changed: "Canonical table-backed Fleet envelope with one Handlebars MonitorSpec template.";
     readonly compatibilityOwner: "Monitors Runtime";
     readonly newWritesEnd: null;
     readonly readerRemoval: null;
@@ -39,11 +45,11 @@ declare const MONITOR_FLEET_DOCUMENTATION: {
     readonly authoredFields: {
         readonly id: "Stable lowercase fleet id used by sync, get, and deactivate.";
         readonly source: "Customer DB table, unique row key, and optional equality filters that select candidate rows.";
-        readonly member: "Ordinary monitor tool, stable key template, and payload evaluated for each selected source row.";
+        readonly monitor: "One Batch-compatible MonitorSpec. Direct Handlebars source-row fields such as {{domain}} are rendered for each selected row.";
         readonly selection: "Deterministic ranking and an active-member limit between 1 and 1,000.";
     };
     readonly fixedPolicy: {
-        readonly cadence: "daily";
+        readonly cadence: "60s fair bounded source refresh";
         readonly membership: "sticky";
         readonly removalGrace: "7d";
         readonly onRemoved: "deactivate";
@@ -51,7 +57,8 @@ declare const MONITOR_FLEET_DOCUMENTATION: {
         readonly billing: "No Fleet fee, permit, or renewal. Dry-run reports ordinary monitor lifecycle charges due now.";
     };
     readonly stickyMembership: "Ranking fills vacancies but never replaces a current member merely because another row ranks higher.";
-    readonly columnExpression: "Use { \"$fleet\": \"column\", \"name\": \"column_name\" } in a member key or payload to read a value from each source row.";
+    readonly templating: "Use direct Handlebars fields such as {{domain}} in monitor key, name, or payload. Helpers, blocks, partials, paths, and prototype access are disabled.";
+    readonly legacyCompatibility: "Edition 1 member/$fleet files remain readable with a lint warning; new files should use version: 2, kind: \"fleet\", and monitor.";
 };
 type MonitorFleetColumn = {
     $fleet: 'column';
@@ -62,7 +69,7 @@ type MonitorFleetTemplate = {
     parts: Array<string | MonitorFleetColumn>;
 };
 type MonitorFleetExpression = MonitorFleetColumn | MonitorFleetTemplate;
-type MonitorFleetDefinition = {
+type MonitorFleetDefinitionV1 = {
     /** Stable lowercase fleet id, used by CLI and API lifecycle commands. */
     id: string;
     /** Customer DB rows that may become members. */
@@ -96,6 +103,24 @@ type MonitorFleetDefinition = {
         membership: 'sticky';
     };
 };
+/**
+ * Edition 2 keeps the public file self-describing and aligns the rendered
+ * member with Batch exactly. Only source-row values may be interpolated.
+ */
+type MonitorFleetDefinitionV2 = {
+    version: 2;
+    kind: 'fleet';
+    id: string;
+    source: MonitorFleetDefinitionV1['source'];
+    monitor: {
+        key: string;
+        tool: string;
+        name?: string;
+        payload: Record<string, unknown>;
+    };
+    selection: MonitorFleetDefinitionV1['selection'];
+};
+type MonitorFleetDefinition = MonitorFleetDefinitionV1 | MonitorFleetDefinitionV2;
 type MonitorFleetContractIssue = {
     path: string;
     code: string;
@@ -114,6 +139,7 @@ type MonitorFleetAuthoringContractResult = {
 declare function fleetColumn(name: string): MonitorFleetColumn;
 declare function fleetKey(...parts: Array<string | MonitorFleetColumn>): MonitorFleetTemplate;
 declare function defineMonitorFleet<const T extends MonitorFleetDefinition>(definition: T): T;
+/** Validate the declared edition, or detect canonical v2 versus legacy v1. */
 declare function validateMonitorFleetDefinition(value: unknown): {
     valid: boolean;
     definition?: MonitorFleetDefinition;
@@ -126,6 +152,16 @@ declare function validateMonitorFleetDefinition(value: unknown): {
  * preflight, which returns the real plan and the credits due.
  */
 declare function admitMonitorFleetAuthoringContract(value: unknown, edition?: number): MonitorFleetAuthoringContractResult;
+/**
+ * Fast provider-free admission shared by the Fleet CLI, SDK, and API. Legacy
+ * documents remain executable but receive an actionable migration warning.
+ */
+declare function lintMonitorFleetInput(value: unknown): {
+    normalized?: MonitorFleetDefinition;
+    issues: Array<MonitorFleetContractIssue & {
+        severity: 'error' | 'warning';
+    }>;
+};
 declare function evaluateMonitorFleetValue(value: unknown, row: Record<string, unknown>): unknown;
 
-export { type AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MONITOR_FLEET_REMOVAL_GRACE_MS, type MonitorFleetAuthoringContractEdition, type MonitorFleetAuthoringContractResult, type MonitorFleetColumn, type MonitorFleetContractIssue, type MonitorFleetDefinition, type MonitorFleetExpression, type MonitorFleetTemplate, SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS, admitMonitorFleetAuthoringContract, defineMonitorFleet, evaluateMonitorFleetValue, fleetColumn, fleetKey, validateMonitorFleetDefinition };
+export { type AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MONITOR_FLEET_REMOVAL_GRACE_MS, type MonitorFleetAuthoringContractEdition, type MonitorFleetAuthoringContractResult, type MonitorFleetColumn, type MonitorFleetContractIssue, type MonitorFleetDefinition, type MonitorFleetDefinitionV1, type MonitorFleetDefinitionV2, type MonitorFleetExpression, type MonitorFleetTemplate, SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS, admitMonitorFleetAuthoringContract, defineMonitorFleet, evaluateMonitorFleetValue, fleetColumn, fleetKey, lintMonitorFleetInput, validateMonitorFleetDefinition };