@slicedearth/whoisleuth-cli 2.3.0 → 2.5.1

package/packages/contracts/domain-control-monitor.mjs

@@ -1,7 +1,14 @@
 import { defineSchemaCompatibility } from "./schema-compatibility.mjs";
 import { defineSchemaLifecycleFamily } from "./schema-lifecycle.mjs";
 export const CLI_DOMAIN_CONTROL_MONITOR_SCHEMA = 'whoisleuth.cli.domain-control-monitor';
-export const CLI_DOMAIN_CONTROL_MONITOR_VERSION = 1;
+export const PUBLIC_CLI_DOMAIN_CONTROL_MONITOR_VERSION = 1;
+export const CLI_DOMAIN_CONTROL_MONITOR_VERSION = 3;
+export const SUPPORTED_CLI_DOMAIN_CONTROL_MONITOR_VERSIONS = [PUBLIC_CLI_DOMAIN_CONTROL_MONITOR_VERSION, 2, CLI_DOMAIN_CONTROL_MONITOR_VERSION];
+export const DOMAIN_CONTROL_MONITOR_EMBEDDED_VERSIONS = Object.freeze({
+    1: Object.freeze({ review: 1, flightRecorder: 1 }),
+    2: Object.freeze({ review: 2, flightRecorder: 2 }),
+    3: Object.freeze({ review: 3, flightRecorder: 3 }),
+});
 export const MAX_DOMAIN_CONTROL_MONITOR_INPUT_BYTES = 16 * 1024 * 1024;
 export const MAX_DOMAIN_CONTROL_MONITOR_JSON_DEPTH = 48;
 export const MAX_DOMAIN_CONTROL_MONITOR_JSON_KEYS = 50_000;
@@ -51,10 +58,10 @@ export const DOMAIN_CONTROL_MONITOR_COMPATIBILITY = defineSchemaCompatibility({
     kind: 'cli_document',
     schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA,
     currentVersion: CLI_DOMAIN_CONTROL_MONITOR_VERSION,
-    supportedVersions: [CLI_DOMAIN_CONTROL_MONITOR_VERSION],
+    supportedVersions: SUPPORTED_CLI_DOMAIN_CONTROL_MONITOR_VERSIONS,
     acceptsUnversionedLegacy: false,
     futureVersionBehavior: 'reject',
-    migration: 'exact_current_only',
+    migration: 'read_only',
     writeSemantics: 'normalized_rewrite',
     byteBudget: null,
     owner: 'packages/contracts/domain-control-monitor.mts',
@@ -65,24 +72,22 @@ export const DOMAIN_CONTROL_MONITOR_SCHEMA_LIFECYCLE = defineSchemaLifecycleFami
     owner: 'packages/contracts/domain-control-monitor.mts',
     privacy: 'analyst_authored_sensitive',
     compatibility: [DOMAIN_CONTROL_MONITOR_COMPATIBILITY],
-    contracts: [
-        {
-            compatibilityId: DOMAIN_CONTROL_MONITOR_COMPATIBILITY.id,
-            schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA,
-            version: CLI_DOMAIN_CONTROL_MONITOR_VERSION,
-            role: 'document',
-            lifecycle: 'current',
-            readable: true,
-            emitted: true,
-            exactKeys: true,
-            extensionPolicy: 'reject',
-            futureVersionBehaviour: 'reject',
-            migrationTarget: null,
-            canonicalisation: null,
-            byteBudget: null,
-            fixtureIds: ['domain-control-monitor-v1'],
-        },
-    ],
+    contracts: SUPPORTED_CLI_DOMAIN_CONTROL_MONITOR_VERSIONS.map((version) => ({
+        compatibilityId: DOMAIN_CONTROL_MONITOR_COMPATIBILITY.id,
+        schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA,
+        version,
+        role: 'document',
+        lifecycle: version === CLI_DOMAIN_CONTROL_MONITOR_VERSION ? 'current' : 'legacy',
+        readable: true,
+        emitted: version === CLI_DOMAIN_CONTROL_MONITOR_VERSION,
+        exactKeys: true,
+        extensionPolicy: 'reject',
+        futureVersionBehaviour: 'reject',
+        migrationTarget: null,
+        canonicalisation: null,
+        byteBudget: null,
+        fixtureIds: [`domain-control-monitor-v${version}`],
+    })),
     fixtures: [
         {
             id: 'domain-control-monitor-v1',
@@ -91,32 +96,41 @@ export const DOMAIN_CONTROL_MONITOR_SCHEMA_LIFECYCLE = defineSchemaLifecycleFami
             sha256: '1b505015fbc4cb6fc10b8d1c4552762fc78a21bea2f6614761e34d03f290ffb4',
             contentDigestSha256: null,
             schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA,
-            version: CLI_DOMAIN_CONTROL_MONITOR_VERSION,
-            role: 'current',
+            version: PUBLIC_CLI_DOMAIN_CONTROL_MONITOR_VERSION,
+            role: 'historical',
             expectation: 'accepted_exact',
             expectedOutputFixtureId: null,
             scope: 'repository',
         },
+        {
+            id: 'domain-control-monitor-v2', path: 'test/fixtures/domain-control-monitor-v2.json',
+            bytes: 18_023, sha256: 'f4017f3dc84b3adb6b6114ea49c37ff05939779daabbbb56c868010145cac55c',
+            contentDigestSha256: null, schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA, version: 2,
+            role: 'historical', expectation: 'accepted_exact', expectedOutputFixtureId: null, scope: 'repository',
+        },
+        {
+            id: 'domain-control-monitor-v3', path: 'test/fixtures/domain-control-monitor-v3.json',
+            bytes: 19_215, sha256: 'a7233a0b52b282e3ad8097b9bd71bf15125b743e60a421cfec765cb8b9456563',
+            contentDigestSha256: null, schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA, version: CLI_DOMAIN_CONTROL_MONITOR_VERSION,
+            role: 'current', expectation: 'accepted_exact', expectedOutputFixtureId: null, scope: 'repository',
+        },
     ],
     metadata: {
-        metadataVersion: 2,
         enforcement: 'declarative_only',
-        shapes: [
-            {
-                id: 'domain-control-monitor.document.v1',
-                schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA,
-                versions: [CLI_DOMAIN_CONTROL_MONITOR_VERSION],
-                objects: [
-                    { path: '$', requiredKeys: DOMAIN_CONTROL_MONITOR_ROOT_KEYS, optionalKeys: [], unknownKeys: 'reject' },
-                    { path: '$.manifest', requiredKeys: DOMAIN_CONTROL_MONITOR_MANIFEST_KEYS, optionalKeys: [], unknownKeys: 'reject' },
-                    { path: '$.collection', requiredKeys: DOMAIN_CONTROL_MONITOR_COLLECTION_KEYS, optionalKeys: [], unknownKeys: 'reject' },
-                    { path: '$.collection.failures[]', requiredKeys: DOMAIN_CONTROL_MONITOR_FAILURE_KEYS, optionalKeys: [], unknownKeys: 'reject' },
-                ],
-                fixedArrays: [{ path: '$.limitations', values: DOMAIN_CONTROL_MONITOR_LIMITATIONS }],
-                normalisation: 'preserve_document',
-                target: null,
-            },
-        ],
+        shapes: SUPPORTED_CLI_DOMAIN_CONTROL_MONITOR_VERSIONS.map((version) => ({
+            id: `domain-control-monitor.document.v${version}`,
+            schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA,
+            versions: [version],
+            objects: [
+                { path: '$', requiredKeys: DOMAIN_CONTROL_MONITOR_ROOT_KEYS, optionalKeys: [], unknownKeys: 'reject' },
+                { path: '$.manifest', requiredKeys: DOMAIN_CONTROL_MONITOR_MANIFEST_KEYS, optionalKeys: [], unknownKeys: 'reject' },
+                { path: '$.collection', requiredKeys: DOMAIN_CONTROL_MONITOR_COLLECTION_KEYS, optionalKeys: [], unknownKeys: 'reject' },
+                { path: '$.collection.failures[]', requiredKeys: DOMAIN_CONTROL_MONITOR_FAILURE_KEYS, optionalKeys: [], unknownKeys: 'reject' },
+            ],
+            fixedArrays: [{ path: '$.limitations', values: DOMAIN_CONTROL_MONITOR_LIMITATIONS }],
+            normalisation: 'preserve_document',
+            target: null,
+        })),
         boundProfiles: [
             {
                 id: 'domain-control-monitor.document-bounds.v1',
@@ -221,9 +235,9 @@ export const DOMAIN_CONTROL_MONITOR_SCHEMA_LIFECYCLE = defineSchemaLifecycleFami
                 id: 'domain-control-monitor.cli-run',
                 plane: 'cli',
                 operation: 'bounded-passive-deep-monitor',
-                acceptedContracts: [{ schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA, versions: [CLI_DOMAIN_CONTROL_MONITOR_VERSION], mode: 'direct' }],
+                acceptedContracts: [{ schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA, versions: SUPPORTED_CLI_DOMAIN_CONTROL_MONITOR_VERSIONS, mode: 'direct' }],
                 emittedContract: { schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA, version: CLI_DOMAIN_CONTROL_MONITOR_VERSION },
-                shapeIds: ['domain-control-monitor.document.v1'],
+                shapeIds: SUPPORTED_CLI_DOMAIN_CONTROL_MONITOR_VERSIONS.map((version) => `domain-control-monitor.document.v${version}`),
                 boundProfileIds: ['domain-control-monitor.document-bounds.v1', 'domain-control-monitor.cli-intake.v1', 'domain-control-monitor.action.v1'],
                 hookIds: ['domain-control-monitor.cli.run'],
                 serialisationProfileId: null,
@@ -240,7 +254,7 @@ export const DOMAIN_CONTROL_MONITOR_SCHEMA_LIFECYCLE = defineSchemaLifecycleFami
                 operation: 'serialise-json',
                 acceptedContracts: [{ schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA, versions: [CLI_DOMAIN_CONTROL_MONITOR_VERSION], mode: 'direct' }],
                 emittedContract: null,
-                shapeIds: ['domain-control-monitor.document.v1'],
+                shapeIds: [`domain-control-monitor.document.v${CLI_DOMAIN_CONTROL_MONITOR_VERSION}`],
                 boundProfileIds: ['domain-control-monitor.document-bounds.v1'],
                 hookIds: ['domain-control-monitor.cli.serialise-json'],
                 serialisationProfileId: 'domain-control-monitor.json.v1',
@@ -257,7 +271,7 @@ export const DOMAIN_CONTROL_MONITOR_SCHEMA_LIFECYCLE = defineSchemaLifecycleFami
                 operation: 'format-terminal',
                 acceptedContracts: [{ schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA, versions: [CLI_DOMAIN_CONTROL_MONITOR_VERSION], mode: 'direct' }],
                 emittedContract: null,
-                shapeIds: ['domain-control-monitor.document.v1'],
+                shapeIds: [`domain-control-monitor.document.v${CLI_DOMAIN_CONTROL_MONITOR_VERSION}`],
                 boundProfileIds: ['domain-control-monitor.document-bounds.v1'],
                 hookIds: ['domain-control-monitor.cli.format-terminal'],
                 serialisationProfileId: null,
@@ -274,7 +288,7 @@ export const DOMAIN_CONTROL_MONITOR_SCHEMA_LIFECYCLE = defineSchemaLifecycleFami
                 operation: 'format-junit',
                 acceptedContracts: [{ schema: CLI_DOMAIN_CONTROL_MONITOR_SCHEMA, versions: [CLI_DOMAIN_CONTROL_MONITOR_VERSION], mode: 'direct' }],
                 emittedContract: null,
-                shapeIds: ['domain-control-monitor.document.v1'],
+                shapeIds: [`domain-control-monitor.document.v${CLI_DOMAIN_CONTROL_MONITOR_VERSION}`],
                 boundProfileIds: ['domain-control-monitor.document-bounds.v1'],
                 hookIds: ['domain-control-monitor.cli.format-junit'],
                 serialisationProfileId: null,