Skip to content

Commit 0fcfd34

Browse files
committed
chore(gates): add the daemon layer manifest and R81 daemon-layer rule
Partition every production file under src/daemon/ into five local layers (core < resources < execution < sessions < server) with an exhaustive machine-readable manifest, and verify it: reject upward static value and type-only edges, report dynamic cross-layer edges without rejecting them, and fail on omitted, duplicated, or untracked manifest entries. No files move; the global spine rank stays 4 for all five layers.
1 parent c2c09d4 commit 0fcfd34

5 files changed

Lines changed: 741 additions & 1 deletion

File tree

‎docs/dependency-graph-findings.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -324,6 +324,13 @@ lines in one flat directory whose _names_ carry a hierarchy the filesystem does
324324
(14 723 lines), 16 `interaction-*`, 13 `record-*`, 5 `snapshot-*`. `daemon/` itself is another 103
325325
flat files.
326326

327+
Since #3391 the zone has an enforced interior: R81 (`scripts/layering/daemon-layers.ts`) owns the
328+
manifest partitioning every production daemon file into five layers — `daemon-core` <
329+
`daemon-resources` < `daemon-execution` < `daemon-sessions` < `daemon-server` — and rejects any
330+
upward static value or type edge between them (dynamic cross-layer edges are reported, not
331+
rejected). The global spine rank stays 4 for all five, so this is the only direction claim inside
332+
the zone; the manifest is the living claim, restated here at risk of drift.
333+
327334
Things that are **not** wrong, checked and ruled out:
328335

329336
- **No copy-paste.** Zero 7-line windows repeat across three or more daemon files.

‎scripts/layering/check.ts‎

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,10 @@
5454
// brand casts inside those two modules, so a udid never runs outside the set that holds it.
5555
// - Over REQUEST-BOUND RUNTIME EXECUTION: facts remain the only admission authority and daemon
5656
// code cannot manufacture or repair a narrowed runtime proof (R66).
57+
// - Over THE DAEMON'S INTERIOR: every production file under src/daemon/ is owned by exactly one
58+
// layer of the manifest in scripts/layering/daemon-layers.ts, and no static edge reads up the
59+
// daemon-local order core < resources < execution < sessions < server (R81). The global spine
60+
// ranks all five layers at daemon-server's rank, so R5/R6/R80 are blind inside the zone.
5761
// - Over CONTRACTS PRODUCTION SOURCE: contracts owns vocabulary only — host, process, and timer
5862
// mechanics belong in capture-kit or an adapter (R18).
5963
// R6, R9, and the R10 R7 counts are ratchets with no written-down reference: each is the same
@@ -130,6 +134,7 @@ import {
130134
DAEMON_PLATFORM_RUNTIME_EDGES,
131135
} from './daemon-platform-runtime-inventory.ts';
132136
import { checkDaemonClientEntry } from './daemon-client-entry.ts';
137+
import { checkDaemonLayers, readDaemonLayerManifest } from './daemon-layers.ts';
133138
import { checkSessionAuthorityOverlay, handlerOwnedOverlay } from './session-authority-overlay.ts';
134139
import {
135140
listTrackedPlatformZoneFiles,
@@ -429,7 +434,10 @@ function report(
429434
`${DAEMON_PLATFORM_RUNTIME_EDGES.length} daemon-to-root platform-runtime edges hold ` +
430435
`their #2278 classification (R76); and the handler-owned SessionState/SessionStore ` +
431436
`authority overlay holds at or under the merge-base (R75, ` +
432-
`${handlerOwnedShapeFiles} shape / ${handlerOwnedAuthorityFiles} authority files).\n`,
437+
`${handlerOwnedShapeFiles} shape / ${handlerOwnedAuthorityFiles} authority files); and ` +
438+
`every production daemon file is owned by one layer with no upward static edges across ` +
439+
`core < resources < execution < sessions < server (R81; dynamic cross-layer edges are ` +
440+
`reported above when present).\n`,
433441
);
434442
return 0;
435443
}
@@ -509,6 +517,7 @@ export const LAYERING_RULE_IDS = [
509517
'daemon-platform-runtime-inventory',
510518
'daemon-client-entry',
511519
'session-authority-overlay',
520+
'daemon-layers',
512521
] as const;
513522

514523
export type LayeringRuleId = (typeof LAYERING_RULE_IDS)[number];
@@ -576,6 +585,12 @@ export const LAYERING_RULES: Readonly<Record<LayeringRuleId, LayeringRule>> = {
576585
context.ratchets.sessionAuthority,
577586
context.reference.sessionAuthority,
578587
),
588+
'daemon-layers': (context) =>
589+
checkDaemonLayers(
590+
context.sourceFiles.filter((file) => file.startsWith('src/daemon/')),
591+
context.edges,
592+
readDaemonLayerManifest(repoRoot),
593+
),
579594
};
580595

581596
export function main(): number {
Lines changed: 293 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,293 @@
1+
{
2+
"daemon-core": [
3+
"src/daemon/apple-runner-options.ts",
4+
"src/daemon/capture-disclosure.ts",
5+
"src/daemon/config.ts",
6+
"src/daemon/context.ts",
7+
"src/daemon/daemon-command-registry.ts",
8+
"src/daemon/daemon-policy.ts",
9+
"src/daemon/daemon-request.ts",
10+
"src/daemon/deferred-interaction-outcome.ts",
11+
"src/daemon/device/device-ready.ts",
12+
"src/daemon/device/device-selector-intent.ts",
13+
"src/daemon/direct-ios-selector.ts",
14+
"src/daemon/execution-plan.ts",
15+
"src/daemon/fill-backend-result.ts",
16+
"src/daemon/generic-leaf-execution.ts",
17+
"src/daemon/gesture-runtime.ts",
18+
"src/daemon/interaction-surface-signature.ts",
19+
"src/daemon/interaction/internal/interaction-touch-direct-ios-eligibility.ts",
20+
"src/daemon/interaction/internal/types.ts",
21+
"src/daemon/interactor-resolution.ts",
22+
"src/daemon/ios-app-session-hint.ts",
23+
"src/daemon/lease-context.ts",
24+
"src/daemon/managed-session-artifact-path.ts",
25+
"src/daemon/platform-owner-lifecycle.ts",
26+
"src/daemon/platform-resource-cleanup.ts",
27+
"src/daemon/provider-device-admission.ts",
28+
"src/daemon/recording-gesture-events.ts",
29+
"src/daemon/recording-gestures.ts",
30+
"src/daemon/recording-timing.ts",
31+
"src/daemon/recording-values.ts",
32+
"src/daemon/ref-frame-slot.ts",
33+
"src/daemon/ref-frame.ts",
34+
"src/daemon/request-dispatch-ledger.ts",
35+
"src/daemon/request-runtime-binding.ts",
36+
"src/daemon/runtime-admission.ts",
37+
"src/daemon/runtime-operation-effects.ts",
38+
"src/daemon/runtime-session.ts",
39+
"src/daemon/selector-operation-binding.ts",
40+
"src/daemon/selector-recording.ts",
41+
"src/daemon/session-action-recorder.ts",
42+
"src/daemon/session-artifact-paths.ts",
43+
"src/daemon/session-capture-binding.ts",
44+
"src/daemon/session-idle-tombstone.ts",
45+
"src/daemon/session-recovery-hints.ts",
46+
"src/daemon/session-replay-transaction.ts",
47+
"src/daemon/session-runtime-admission.ts",
48+
"src/daemon/session-script-active-publication.ts",
49+
"src/daemon/session-script-publication-capability.ts",
50+
"src/daemon/session-script-publication-state.ts",
51+
"src/daemon/session-script-writer.ts",
52+
"src/daemon/session-selector.ts",
53+
"src/daemon/session-snapshot-freshness.ts",
54+
"src/daemon/session-state.ts",
55+
"src/daemon/session-store.ts",
56+
"src/daemon/session-tenant-scope.ts",
57+
"src/daemon/snapshot-capture.ts",
58+
"src/daemon/snapshot-interactor-capture.ts",
59+
"src/daemon/snapshot-runtime-binding.ts",
60+
"src/daemon/snapshot-runtime-capture-input.ts",
61+
"src/daemon/snapshot-session.ts",
62+
"src/daemon/tenant-owned-entry.ts",
63+
"src/daemon/touch-runtime.ts"
64+
],
65+
"daemon-resources": [
66+
"src/daemon/app-log-admission-ledger.ts",
67+
"src/daemon/app-log-files.ts",
68+
"src/daemon/app-log-resource-recovery.ts",
69+
"src/daemon/app-log-resource-store.ts",
70+
"src/daemon/app-log-session-resource.ts",
71+
"src/daemon/app-log-start-preflight.ts",
72+
"src/daemon/app-log.ts",
73+
"src/daemon/artifact-tracking.ts",
74+
"src/daemon/device/device-claim-admission.ts",
75+
"src/daemon/device/device-claim-conflict.ts",
76+
"src/daemon/device/device-claim-inspection.ts",
77+
"src/daemon/device/device-claim-paths.ts",
78+
"src/daemon/device/device-claim-reboot.ts",
79+
"src/daemon/device/device-claim-record.ts",
80+
"src/daemon/device/device-claim-rule.ts",
81+
"src/daemon/device/device-claim-settlement.ts",
82+
"src/daemon/device/device-claim-store.ts",
83+
"src/daemon/device/device-claims.ts",
84+
"src/daemon/device/device-mutation-drain.ts",
85+
"src/daemon/human-control-contract.ts",
86+
"src/daemon/lease-in-flight-work.ts",
87+
"src/daemon/lease-registry-scope.ts",
88+
"src/daemon/lease-registry.ts",
89+
"src/daemon/macos-app-lease.ts",
90+
"src/daemon/provider-session-ownership.ts",
91+
"src/daemon/session-device-resolution.ts"
92+
],
93+
"daemon-execution": [
94+
"src/daemon/android-foreground-surface.ts",
95+
"src/daemon/android-snapshot-timeout-evidence.ts",
96+
"src/daemon/android-system-dialog.ts",
97+
"src/daemon/app-event-runtime.ts",
98+
"src/daemon/app-events.ts",
99+
"src/daemon/apps-runtime.ts",
100+
"src/daemon/back-runtime.ts",
101+
"src/daemon/focus-runtime.ts",
102+
"src/daemon/fold-runtime.ts",
103+
"src/daemon/generic-runtime-execution.ts",
104+
"src/daemon/generic-settle.ts",
105+
"src/daemon/handlers/react-native.ts",
106+
"src/daemon/handlers/session-clipboard.ts",
107+
"src/daemon/handlers/session-selector-dispatch.ts",
108+
"src/daemon/handlers/snapshot-alert.ts",
109+
"src/daemon/handlers/snapshot-settings.ts",
110+
"src/daemon/interaction/index.ts",
111+
"src/daemon/interaction/internal/find-match-ranking.ts",
112+
"src/daemon/interaction/internal/find-match-resolution.ts",
113+
"src/daemon/interaction/internal/find-target-capture.ts",
114+
"src/daemon/interaction/internal/find.ts",
115+
"src/daemon/interaction/internal/interaction-android-escape.ts",
116+
"src/daemon/interaction/internal/interaction-common.ts",
117+
"src/daemon/interaction/internal/interaction-flags.ts",
118+
"src/daemon/interaction/internal/interaction-gesture-response.ts",
119+
"src/daemon/interaction/internal/interaction-gesture.ts",
120+
"src/daemon/interaction/internal/interaction-ios-tap-outcome.ts",
121+
"src/daemon/interaction/internal/interaction-recorded-input.ts",
122+
"src/daemon/interaction/internal/interaction-ref-policy.ts",
123+
"src/daemon/interaction/internal/interaction-response.ts",
124+
"src/daemon/interaction/internal/interaction-runtime.ts",
125+
"src/daemon/interaction/internal/interaction-session.ts",
126+
"src/daemon/interaction/internal/interaction-snapshot.ts",
127+
"src/daemon/interaction/internal/interaction-targeting.ts",
128+
"src/daemon/interaction/internal/interaction-touch-android-freshness.ts",
129+
"src/daemon/interaction/internal/interaction-touch-android-readiness.ts",
130+
"src/daemon/interaction/internal/interaction-touch-direct-ios.ts",
131+
"src/daemon/interaction/internal/interaction-touch-fill.ts",
132+
"src/daemon/interaction/internal/interaction-touch-payload.ts",
133+
"src/daemon/interaction/internal/interaction-touch-policy.ts",
134+
"src/daemon/interaction/internal/interaction-touch-prepare.ts",
135+
"src/daemon/interaction/internal/interaction-touch-press-admission.ts",
136+
"src/daemon/interaction/internal/interaction-touch-press.ts",
137+
"src/daemon/interaction/internal/interaction-touch-reference-frame.ts",
138+
"src/daemon/interaction/internal/interaction-touch-response.ts",
139+
"src/daemon/interaction/internal/interaction-touch-runtime.ts",
140+
"src/daemon/interaction/internal/interaction-touch-targets.ts",
141+
"src/daemon/interaction/internal/interaction.ts",
142+
"src/daemon/internal-observation.ts",
143+
"src/daemon/keyboard-runtime.ts",
144+
"src/daemon/offscreen-target-probe.ts",
145+
"src/daemon/orientation-runtime.ts",
146+
"src/daemon/ref-positionals.ts",
147+
"src/daemon/ref-snapshot-flag-policy.ts",
148+
"src/daemon/request-dispatch-disclosure.ts",
149+
"src/daemon/request-generic-dispatch.ts",
150+
"src/daemon/runtime-artifacts.ts",
151+
"src/daemon/runtime-policy.ts",
152+
"src/daemon/screenshot-crop-target.ts",
153+
"src/daemon/screenshot-crop.ts",
154+
"src/daemon/screenshot-runtime-binding.ts",
155+
"src/daemon/screenshot-runtime.ts",
156+
"src/daemon/scroll-movement.ts",
157+
"src/daemon/scroll-runtime.ts",
158+
"src/daemon/scroll-until.ts",
159+
"src/daemon/selector-capture-binding.ts",
160+
"src/daemon/selector-capture-runtime.ts",
161+
"src/daemon/selector-match-errors.ts",
162+
"src/daemon/selector-runtime-backend.ts",
163+
"src/daemon/selector-runtime.ts",
164+
"src/daemon/selector-text-runtime.ts",
165+
"src/daemon/session-snapshot.ts",
166+
"src/daemon/snapshot-timeout-evidence.ts",
167+
"src/daemon/sparse-fallback-screenshot.ts",
168+
"src/daemon/system-button-runtime.ts",
169+
"src/daemon/tv-remote-runtime.ts",
170+
"src/daemon/type-target-warning.ts",
171+
"src/daemon/type-text-runtime.ts",
172+
"src/daemon/viewport-runtime.ts",
173+
"src/daemon/wait-current-surface.ts",
174+
"src/daemon/wait-runtime.ts"
175+
],
176+
"daemon-sessions": [
177+
"src/daemon/application-lifecycle-execution.ts",
178+
"src/daemon/device/device-claim-reconciliation.ts",
179+
"src/daemon/device/device-targets.ts",
180+
"src/daemon/dispatch-payload.ts",
181+
"src/daemon/handlers/human-control.ts",
182+
"src/daemon/handlers/lease.ts",
183+
"src/daemon/handlers/record-runtime-request.ts",
184+
"src/daemon/handlers/record-runtime-response.ts",
185+
"src/daemon/handlers/record-runtime.ts",
186+
"src/daemon/handlers/record-trace.ts",
187+
"src/daemon/handlers/session-app-deployment-route.ts",
188+
"src/daemon/handlers/session-app-deployment.ts",
189+
"src/daemon/handlers/session-app-source-deployment.ts",
190+
"src/daemon/handlers/session-batch.ts",
191+
"src/daemon/handlers/session-command-input.ts",
192+
"src/daemon/handlers/session-doctor-app.ts",
193+
"src/daemon/handlers/session-doctor-device.ts",
194+
"src/daemon/handlers/session-doctor-metro.ts",
195+
"src/daemon/handlers/session-doctor-options.ts",
196+
"src/daemon/handlers/session-doctor-output.ts",
197+
"src/daemon/handlers/session-doctor-types.ts",
198+
"src/daemon/handlers/session-doctor.ts",
199+
"src/daemon/handlers/session-prepare.ts",
200+
"src/daemon/handlers/session-replay-command.ts",
201+
"src/daemon/handlers/session-replay-video-owner.ts",
202+
"src/daemon/handlers/session-runtime-command.ts",
203+
"src/daemon/handlers/session-runtime-port-reverse.ts",
204+
"src/daemon/handlers/session-script-publication.ts",
205+
"src/daemon/handlers/session-state.ts",
206+
"src/daemon/handlers/session.ts",
207+
"src/daemon/handlers/snapshot.ts",
208+
"src/daemon/handlers/trace-runtime.ts",
209+
"src/daemon/install-source-resolution.ts",
210+
"src/daemon/lease-lifecycle.ts",
211+
"src/daemon/materialized-path-registry.ts",
212+
"src/daemon/open-device-contention-wait.ts",
213+
"src/daemon/payload-input.ts",
214+
"src/daemon/request-admission.ts",
215+
"src/daemon/request-handler-chain.ts",
216+
"src/daemon/request-recording-health.ts",
217+
"src/daemon/route-owner-files.ts",
218+
"src/daemon/server/daemon-idle-reap.ts",
219+
"src/daemon/session-lifecycle/index.ts",
220+
"src/daemon/session-lifecycle/internal/inventory.ts",
221+
"src/daemon/session-lifecycle/internal/session-close-lifecycle-teardown.ts",
222+
"src/daemon/session-lifecycle/internal/session-close-runtime-admission.ts",
223+
"src/daemon/session-lifecycle/internal/session-close-script.ts",
224+
"src/daemon/session-lifecycle/internal/session-close.ts",
225+
"src/daemon/session-lifecycle/internal/session-open-execution.ts",
226+
"src/daemon/session-lifecycle/internal/session-open-foreground.ts",
227+
"src/daemon/session-lifecycle/internal/session-open-prepare.ts",
228+
"src/daemon/session-lifecycle/internal/session-open-state.ts",
229+
"src/daemon/session-lifecycle/internal/session-open-surface.ts",
230+
"src/daemon/session-lifecycle/internal/session-open-warnings.ts",
231+
"src/daemon/session-lifecycle/internal/session-open.ts",
232+
"src/daemon/session-lifecycle/internal/session-startup-metrics.ts",
233+
"src/daemon/session-observability/index.ts",
234+
"src/daemon/session-observability/internal/session-audio.ts",
235+
"src/daemon/session-observability/internal/session-network.ts",
236+
"src/daemon/session-observability/internal/session-observability.ts",
237+
"src/daemon/session-observability/internal/session-perf-runtime.ts",
238+
"src/daemon/session-replay-coordinator.ts",
239+
"src/daemon/session-routing.ts",
240+
"src/daemon/session-runtime.ts",
241+
"src/daemon/session-teardown-budget.ts",
242+
"src/daemon/session-teardown.ts",
243+
"src/daemon/snapshot-command-runtime.ts",
244+
"src/daemon/snapshot-diff-runtime.ts",
245+
"src/daemon/snapshot-quality-latch.ts",
246+
"src/daemon/snapshot-runtime.ts",
247+
"src/daemon/startup-deadline.ts",
248+
"src/daemon/web-session-names.ts"
249+
],
250+
"daemon-server": [
251+
"src/daemon/application-lifecycle-recovery.ts",
252+
"src/daemon/artifact-archive.ts",
253+
"src/daemon/artifact-download.ts",
254+
"src/daemon/daemon-stop.ts",
255+
"src/daemon/device/device-claim-owner-recovery.ts",
256+
"src/daemon/downloadable-artifact-http.ts",
257+
"src/daemon/host-lease-http.ts",
258+
"src/daemon/http-errors.ts",
259+
"src/daemon/http-request-target.ts",
260+
"src/daemon/human-control-http.ts",
261+
"src/daemon/platform-request-scope.ts",
262+
"src/daemon/provider-lease-expiry.ts",
263+
"src/daemon/replay-device-selection.ts",
264+
"src/daemon/request-binding.ts",
265+
"src/daemon/request-diagnostics-http.ts",
266+
"src/daemon/request-execution-locks.ts",
267+
"src/daemon/request-execution-scope.ts",
268+
"src/daemon/request-finalization.ts",
269+
"src/daemon/request-lease-work.ts",
270+
"src/daemon/request-lock-policy.ts",
271+
"src/daemon/request-platform-provider-context.ts",
272+
"src/daemon/request-router.ts",
273+
"src/daemon/request-save-script-policy.ts",
274+
"src/daemon/response-views.ts",
275+
"src/daemon/resumable-upload-range.ts",
276+
"src/daemon/resumable-upload-transfer.ts",
277+
"src/daemon/resumable-upload.ts",
278+
"src/daemon/server/daemon-lease-finalizer.ts",
279+
"src/daemon/server/daemon-metadata-loss.ts",
280+
"src/daemon/server/daemon-runtime.ts",
281+
"src/daemon/server/daemon-session-idle-expiry.ts",
282+
"src/daemon/server/daemon-shutdown-claims.ts",
283+
"src/daemon/server/http-instance-precondition.ts",
284+
"src/daemon/server/http-server.ts",
285+
"src/daemon/server/server-lifecycle.ts",
286+
"src/daemon/server/server-shutdown.ts",
287+
"src/daemon/server/tenant-trust.ts",
288+
"src/daemon/server/transport.ts",
289+
"src/daemon/session-idle-expiry.ts",
290+
"src/daemon/upload-http.ts",
291+
"src/daemon/upload.ts"
292+
]
293+
}

0 commit comments

Comments
 (0)