chore(gates): derive the contracts export inventory from package.json

R11's package-boundaries test pinned every packages/contracts export
subpath by hand (~115 entries, compared with deepEqual), so every merge
that touched packages/contracts/package.json also had to hand-edit the
pin. Replace it with a structural check derived from the manifest
itself: every exports target must resolve to an existing, tracked
source file, and the number of resolved targets must equal
Object.keys(manifest.exports).length. The must-not-resolve negative
list (Node resolution enforces the exports map at runtime) is
untouched.

Author: thymikee

scripts/layering/package-boundaries.test.ts

@@ -21,6 +21,7 @@ import {
   specifierSites,
   type WorkspacePackage,
 } from './package-boundaries.ts';
+import { listTrackedTypeScriptFiles } from './tracked-sources.ts';
 
 const repoRoot = path.resolve(import.meta.dirname, '../..');
 
@@ -46,130 +47,36 @@ const contracts: WorkspacePackage = {
 };
 
 const ALL = [kernel, contracts];
-const CONTRACT_EXPORTS = [
-  '@agent-device/contracts/alert-contract',
-  '@agent-device/contracts/alert-runtime',
-  '@agent-device/contracts/android-clipboard-support',
-  '@agent-device/contracts/android-helper-artifacts',
-  '@agent-device/contracts/android-input-ownership',
-  '@agent-device/contracts/android-observation',
-  '@agent-device/contracts/android-snapshot-quality',
-  '@agent-device/contracts/android-system-chrome',
-  '@agent-device/contracts/android-touch-plan',
-  '@agent-device/contracts/app-deployment-runtime',
-  '@agent-device/contracts/app-deployment-runtime-plan',
-  '@agent-device/contracts/app-event-runtime',
-  '@agent-device/contracts/app-inventory-runtime',
-  '@agent-device/contracts/app-log-runtime',
-  '@agent-device/contracts/app-state-runtime',
-  '@agent-device/contracts/app-switcher-runtime',
-  '@agent-device/contracts/apple-multitouch-support',
-  '@agent-device/contracts/apple-runner-request',
-  '@agent-device/contracts/application-lifecycle-interaction',
-  '@agent-device/contracts/application-lifecycle-runtime',
-  '@agent-device/contracts/application-lifecycle-runtime-plan',
-  '@agent-device/contracts/async-lifecycle',
-  '@agent-device/contracts/audio-probe-result',
-  '@agent-device/contracts/audio-probe-runtime',
-  '@agent-device/contracts/audio-probe-runtime-host',
-  '@agent-device/contracts/audio-probe-support',
-  '@agent-device/contracts/audio-runtime-plan',
-  '@agent-device/contracts/back-mode',
-  '@agent-device/contracts/backend-diagnostics',
-  '@agent-device/contracts/back-runtime',
-  '@agent-device/contracts/boot-failure',
-  '@agent-device/contracts/capture',
-  '@agent-device/contracts/click-button',
-  '@agent-device/contracts/client',
-  '@agent-device/contracts/clipboard',
-  '@agent-device/contracts/clipboard-runtime',
-  '@agent-device/contracts/command',
-  '@agent-device/contracts/command-platform-execution',
-  '@agent-device/contracts/device',
-  '@agent-device/contracts/device-readiness-runtime',
-  '@agent-device/contracts/device-shutdown-runtime',
-  '@agent-device/contracts/divergence',
-  '@agent-device/contracts/durable-resource',
-  '@agent-device/contracts/durable-resource-envelope',
-  '@agent-device/contracts/element-text-runtime',
-  '@agent-device/contracts/focus-runtime',
-  '@agent-device/contracts/gesture-admission',
-  '@agent-device/contracts/gesture-input',
-  '@agent-device/contracts/gesture-normalization',
-  '@agent-device/contracts/gesture-plan',
-  '@agent-device/contracts/gesture-plan-types',
-  '@agent-device/contracts/gesture-runtime',
-  '@agent-device/contracts/home-runtime',
-  '@agent-device/contracts/host-diagnostics',
-  '@agent-device/contracts/daemon-owner-cleanup',
-  '@agent-device/contracts/interaction',
-  '@agent-device/contracts/interaction-error',
-  '@agent-device/contracts/interaction-guarantees',
-  '@agent-device/contracts/interactor-operation-catalog',
-  '@agent-device/contracts/interactor-types',
-  '@agent-device/contracts/ios-snapshot',
-  '@agent-device/contracts/is-predicate',
-  '@agent-device/contracts/keyboard',
-  '@agent-device/contracts/keyboard-runtime',
-  '@agent-device/contracts/local-interactor-operation-set',
-  '@agent-device/contracts/logs-runtime-plan',
-  '@agent-device/contracts/managed-device-allocation',
-  '@agent-device/contracts/managed-web-backend',
-  '@agent-device/contracts/navigation',
-  '@agent-device/contracts/network-runtime',
-  '@agent-device/contracts/network-runtime-plan',
-  '@agent-device/contracts/network-traffic',
-  '@agent-device/contracts/observability',
-  '@agent-device/contracts/orientation-runtime',
-  '@agent-device/contracts/perf-runtime',
-  '@agent-device/contracts/perf-runtime-host',
-  '@agent-device/contracts/perf-runtime-operation-builder',
-  '@agent-device/contracts/perf-runtime-plan',
-  '@agent-device/contracts/platform-module',
-  '@agent-device/contracts/platform-plugin',
-  '@agent-device/contracts/platform-providers',
-  '@agent-device/contracts/platform-resource-cleanup',
-  '@agent-device/contracts/platform-runtime',
-  '@agent-device/contracts/platform-runtime-host',
-  '@agent-device/contracts/platform-runtime-operations',
-  '@agent-device/contracts/platform-runtime-unavailable',
-  '@agent-device/contracts/progress',
-  '@agent-device/contracts/record-runtime-execution',
-  '@agent-device/contracts/recording',
-  '@agent-device/contracts/remote',
-  '@agent-device/contracts/replay',
-  '@agent-device/contracts/react-native-overlay',
-  '@agent-device/contracts/runner-lease-context',
-  '@agent-device/contracts/screen-recording-runtime',
-  '@agent-device/contracts/screen-recording-runtime-host',
-  '@agent-device/contracts/screen-recording-runtime-plan',
-  '@agent-device/contracts/screenshot-runtime',
-  '@agent-device/contracts/scroll-command',
-  '@agent-device/contracts/scroll-gesture',
-  '@agent-device/contracts/scroll-runtime',
-  '@agent-device/contracts/selector-observation-runtime',
-  '@agent-device/contracts/session',
-  '@agent-device/contracts/settings',
-  '@agent-device/contracts/settings-runtime',
-  '@agent-device/contracts/snapshot',
-  '@agent-device/contracts/snapshot-presentation',
-  '@agent-device/contracts/snapshot-runtime',
-  '@agent-device/contracts/snapshot-scope',
-  '@agent-device/contracts/snapshot-timeout-evidence',
-  '@agent-device/contracts/startup-recovery-fence',
-  '@agent-device/contracts/touch-runtime',
-  '@agent-device/contracts/tv-remote',
-  '@agent-device/contracts/tv-remote-runtime',
-  '@agent-device/contracts/type-text-runtime',
-  '@agent-device/contracts/viewport-runtime',
-  '@agent-device/contracts/wait',
-  '@agent-device/contracts/wait-runtime-plan',
-] as const;
 
 function rules(violations: { rule: string }[]): string[] {
   return violations.map((violation) => violation.rule);
 }
 
+/**
+ * The manifest is its own inventory: every `exports` target must resolve to an existing,
+ * TRACKED source file, and every manifest entry must have produced exactly one `exportTargets`
+ * entry (nothing dropped, nothing collapsed by a duplicate key). This replaces a ~120-line pinned
+ * subpath list that every `packages/contracts/package.json` change also had to hand-edit; the
+ * manifest is now the only place the export surface is declared.
+ */
+function assertExportTargetsMatchManifest(pkg: WorkspacePackage, manifestFile: string): void {
+  const manifest = JSON.parse(fs.readFileSync(path.join(repoRoot, manifestFile), 'utf8')) as {
+    exports?: Record<string, unknown>;
+  };
+  const trackedSources = new Set(listTrackedTypeScriptFiles(repoRoot));
+  for (const [specifier, target] of pkg.exportTargets) {
+    assert.ok(
+      trackedSources.has(target) && fs.existsSync(path.join(repoRoot, target)),
+      `${specifier} -> ${target} must resolve to an existing, tracked file`,
+    );
+  }
+  assert.equal(
+    pkg.exportTargets.size,
+    Object.keys(manifest.exports ?? {}).length,
+    `${pkg.name} exports map entries must each produce one resolved export target`,
+  );
+}
+
 test('specifier sites carry 1-based lines for static and dynamic imports', () => {
   const sites = specifierSites(
     'src/a.ts',
@@ -451,7 +358,7 @@ test('the real tree parses, declares, and passes R11', () => {
   assert.ok(kernelPackage.exportTargets.size >= 8, 'kernel exports its vocabulary subpaths');
   const contractsPackage = packages.find((pkg) => pkg.name === '@agent-device/contracts');
   assert.ok(contractsPackage, 'contracts package must exist');
-  assert.deepEqual([...contractsPackage.exportTargets.keys()].sort(), [...CONTRACT_EXPORTS].sort());
+  assertExportTargetsMatchManifest(contractsPackage, 'packages/contracts/package.json');
   assert.deepEqual([...contractsPackage.workspaceDependencies], ['@agent-device/kernel']);
   const captureKitPackage = packages.find((pkg) => pkg.name === '@agent-device/capture-kit');
   assert.ok(captureKitPackage, 'capture-kit package must exist');