@ttsc/unplugin 0.30.4 → 0.31.1

package/lib/core/transform/tracker/broker/WatchBrokerTransport.d.cts

@@ -0,0 +1,63 @@
+import type { WatchBroker } from "./WatchBroker.cjs";
+/**
+ * Common lifecycle seam for the native Windows stdio broker and macOS IPC.
+ *
+ * The transport owns framing and demand references only. Ordered native
+ * notifications and per-registration readiness remain backend responsibilities;
+ * a successful send cannot certify coverage or cache reuse.
+ *
+ * @evidence contracts/common.md#principled-implementation One transport seam preserves explicit failure and reference ownership for both supported broker backends.
+ * @evidence contracts/common.md#clear-and-simple-design Callers express send, demand and retirement through this namespace instead of duplicating platform checks or modifying a ChildProcess.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported child streams and IPC APIs are used without replacing runtime methods.
+ * @evidence contracts/common.md#meaningful-documentation Native prose separates transport completion from native watch authority.
+ * @evidence contracts/portability.md#os-neutral-implementation Native selection stays at broker startup; all tracker and observer consumers share these operations.
+ * @evidenceExclude contracts/performance.md#efficient-algorithms Member operations own their delegated cost.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work The broker owner selects transport and sharing lifetime.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources This namespace itself retains no transport registry.
+ */
+export declare namespace WatchBrokerTransport {
+    /**
+     * Queue a message on the selected transport. False refuses delivery; true
+     * only means queued, with actual acknowledgment or failure still
+     * outstanding.
+     *
+     * @evidence contracts/common.md#principled-implementation Native and IPC transports preserve separate queue acceptance and observed backend replies.
+     * @evidence contracts/common.md#clear-and-simple-design One selection delegates framing to the startup-owned transport.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts No queue result is upgraded into readiness or a native drain.
+     * @evidence contracts/common.md#meaningful-documentation Native prose states the limited meaning of the returned boolean.
+     * @evidence contracts/portability.md#os-neutral-implementation Explicit stdio capability takes precedence over optional IPC.
+     * @evidence contracts/performance.md#efficient-algorithms Transport selection is fixed work; JSON framing, message bytes and pipe backpressure belong to the selected sender.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Sending an effect does not own computation reuse.
+     * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The selected sender and request owner retain queued bytes and outstanding acknowledgment state.
+     */
+    function send(broker: WatchBroker, message: unknown): boolean;
+    /**
+     * Keep the selected reply channel live exactly while caller demand exists.
+     * Counts belong to registration/drain owners; native references are flags.
+     *
+     * @evidence contracts/common.md#principled-implementation Outstanding requests retain both process and reply channel, preventing host exit before acknowledgment.
+     * @evidence contracts/common.md#clear-and-simple-design One operation applies the caller's aggregated demand to either transport.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Optional Bun IPC methods are used as capabilities without installing replacements.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies count ownership and flag semantics.
+     * @evidence contracts/portability.md#os-neutral-implementation Optional IPC methods and a selected native pipe capability express runtime differences.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Reference toggling selects no data-processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work This effect owns no shared computation.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The caller supplies aggregate demand; removing the last demand unreferences process and reply channel without asserting native termination.
+     */
+    function reference(broker: WatchBroker, active: boolean): void;
+    /**
+     * End this broker's request stream. The last-registration owner separately
+     * attempts process termination; closing a channel is not proof of child
+     * exit.
+     *
+     * @evidence contracts/common.md#principled-implementation Channel retirement is distinct from process exit and native resource closure.
+     * @evidence contracts/common.md#clear-and-simple-design Startup-owned transport closes its request stream without platform checks in consumers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported end/disconnect operations preserve native ownership without synthetic exit acknowledgment.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies the independent termination attempt and limited closure meaning.
+     * @evidence contracts/portability.md#os-neutral-implementation Selected stream closure and optional IPC disconnection keep platform details behind the transport seam.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Closing one channel selects no processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Retirement owns no computation reuse.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The selected transport ends its input; process kill and actual native cleanup remain the broker and backend's responsibilities.
+     */
+    function close(broker: WatchBroker): void;
+}

package/lib/core/transform/tracker/broker/WatchBrokerTransport.d.mts

@@ -0,0 +1,63 @@
+import type { WatchBroker } from "./WatchBroker.mjs";
+/**
+ * Common lifecycle seam for the native Windows stdio broker and macOS IPC.
+ *
+ * The transport owns framing and demand references only. Ordered native
+ * notifications and per-registration readiness remain backend responsibilities;
+ * a successful send cannot certify coverage or cache reuse.
+ *
+ * @evidence contracts/common.md#principled-implementation One transport seam preserves explicit failure and reference ownership for both supported broker backends.
+ * @evidence contracts/common.md#clear-and-simple-design Callers express send, demand and retirement through this namespace instead of duplicating platform checks or modifying a ChildProcess.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported child streams and IPC APIs are used without replacing runtime methods.
+ * @evidence contracts/common.md#meaningful-documentation Native prose separates transport completion from native watch authority.
+ * @evidence contracts/portability.md#os-neutral-implementation Native selection stays at broker startup; all tracker and observer consumers share these operations.
+ * @evidenceExclude contracts/performance.md#efficient-algorithms Member operations own their delegated cost.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work The broker owner selects transport and sharing lifetime.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources This namespace itself retains no transport registry.
+ */
+export declare namespace WatchBrokerTransport {
+    /**
+     * Queue a message on the selected transport. False refuses delivery; true
+     * only means queued, with actual acknowledgment or failure still
+     * outstanding.
+     *
+     * @evidence contracts/common.md#principled-implementation Native and IPC transports preserve separate queue acceptance and observed backend replies.
+     * @evidence contracts/common.md#clear-and-simple-design One selection delegates framing to the startup-owned transport.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts No queue result is upgraded into readiness or a native drain.
+     * @evidence contracts/common.md#meaningful-documentation Native prose states the limited meaning of the returned boolean.
+     * @evidence contracts/portability.md#os-neutral-implementation Explicit stdio capability takes precedence over optional IPC.
+     * @evidence contracts/performance.md#efficient-algorithms Transport selection is fixed work; JSON framing, message bytes and pipe backpressure belong to the selected sender.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Sending an effect does not own computation reuse.
+     * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The selected sender and request owner retain queued bytes and outstanding acknowledgment state.
+     */
+    function send(broker: WatchBroker, message: unknown): boolean;
+    /**
+     * Keep the selected reply channel live exactly while caller demand exists.
+     * Counts belong to registration/drain owners; native references are flags.
+     *
+     * @evidence contracts/common.md#principled-implementation Outstanding requests retain both process and reply channel, preventing host exit before acknowledgment.
+     * @evidence contracts/common.md#clear-and-simple-design One operation applies the caller's aggregated demand to either transport.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Optional Bun IPC methods are used as capabilities without installing replacements.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies count ownership and flag semantics.
+     * @evidence contracts/portability.md#os-neutral-implementation Optional IPC methods and a selected native pipe capability express runtime differences.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Reference toggling selects no data-processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work This effect owns no shared computation.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The caller supplies aggregate demand; removing the last demand unreferences process and reply channel without asserting native termination.
+     */
+    function reference(broker: WatchBroker, active: boolean): void;
+    /**
+     * End this broker's request stream. The last-registration owner separately
+     * attempts process termination; closing a channel is not proof of child
+     * exit.
+     *
+     * @evidence contracts/common.md#principled-implementation Channel retirement is distinct from process exit and native resource closure.
+     * @evidence contracts/common.md#clear-and-simple-design Startup-owned transport closes its request stream without platform checks in consumers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported end/disconnect operations preserve native ownership without synthetic exit acknowledgment.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies the independent termination attempt and limited closure meaning.
+     * @evidence contracts/portability.md#os-neutral-implementation Selected stream closure and optional IPC disconnection keep platform details behind the transport seam.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Closing one channel selects no processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Retirement owns no computation reuse.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The selected transport ends its input; process kill and actual native cleanup remain the broker and backend's responsibilities.
+     */
+    function close(broker: WatchBroker): void;
+}

package/lib/core/transform/tracker/broker/WatchBrokerTransport.d.ts

@@ -0,0 +1,63 @@
+import type { WatchBroker } from "./WatchBroker";
+/**
+ * Common lifecycle seam for the native Windows stdio broker and macOS IPC.
+ *
+ * The transport owns framing and demand references only. Ordered native
+ * notifications and per-registration readiness remain backend responsibilities;
+ * a successful send cannot certify coverage or cache reuse.
+ *
+ * @evidence contracts/common.md#principled-implementation One transport seam preserves explicit failure and reference ownership for both supported broker backends.
+ * @evidence contracts/common.md#clear-and-simple-design Callers express send, demand and retirement through this namespace instead of duplicating platform checks or modifying a ChildProcess.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported child streams and IPC APIs are used without replacing runtime methods.
+ * @evidence contracts/common.md#meaningful-documentation Native prose separates transport completion from native watch authority.
+ * @evidence contracts/portability.md#os-neutral-implementation Native selection stays at broker startup; all tracker and observer consumers share these operations.
+ * @evidenceExclude contracts/performance.md#efficient-algorithms Member operations own their delegated cost.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work The broker owner selects transport and sharing lifetime.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources This namespace itself retains no transport registry.
+ */
+export declare namespace WatchBrokerTransport {
+    /**
+     * Queue a message on the selected transport. False refuses delivery; true
+     * only means queued, with actual acknowledgment or failure still
+     * outstanding.
+     *
+     * @evidence contracts/common.md#principled-implementation Native and IPC transports preserve separate queue acceptance and observed backend replies.
+     * @evidence contracts/common.md#clear-and-simple-design One selection delegates framing to the startup-owned transport.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts No queue result is upgraded into readiness or a native drain.
+     * @evidence contracts/common.md#meaningful-documentation Native prose states the limited meaning of the returned boolean.
+     * @evidence contracts/portability.md#os-neutral-implementation Explicit stdio capability takes precedence over optional IPC.
+     * @evidence contracts/performance.md#efficient-algorithms Transport selection is fixed work; JSON framing, message bytes and pipe backpressure belong to the selected sender.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Sending an effect does not own computation reuse.
+     * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The selected sender and request owner retain queued bytes and outstanding acknowledgment state.
+     */
+    function send(broker: WatchBroker, message: unknown): boolean;
+    /**
+     * Keep the selected reply channel live exactly while caller demand exists.
+     * Counts belong to registration/drain owners; native references are flags.
+     *
+     * @evidence contracts/common.md#principled-implementation Outstanding requests retain both process and reply channel, preventing host exit before acknowledgment.
+     * @evidence contracts/common.md#clear-and-simple-design One operation applies the caller's aggregated demand to either transport.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Optional Bun IPC methods are used as capabilities without installing replacements.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies count ownership and flag semantics.
+     * @evidence contracts/portability.md#os-neutral-implementation Optional IPC methods and a selected native pipe capability express runtime differences.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Reference toggling selects no data-processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work This effect owns no shared computation.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The caller supplies aggregate demand; removing the last demand unreferences process and reply channel without asserting native termination.
+     */
+    function reference(broker: WatchBroker, active: boolean): void;
+    /**
+     * End this broker's request stream. The last-registration owner separately
+     * attempts process termination; closing a channel is not proof of child
+     * exit.
+     *
+     * @evidence contracts/common.md#principled-implementation Channel retirement is distinct from process exit and native resource closure.
+     * @evidence contracts/common.md#clear-and-simple-design Startup-owned transport closes its request stream without platform checks in consumers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported end/disconnect operations preserve native ownership without synthetic exit acknowledgment.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies the independent termination attempt and limited closure meaning.
+     * @evidence contracts/portability.md#os-neutral-implementation Selected stream closure and optional IPC disconnection keep platform details behind the transport seam.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Closing one channel selects no processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Retirement owns no computation reuse.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The selected transport ends its input; process kill and actual native cleanup remain the broker and backend's responsibilities.
+     */
+    function close(broker: WatchBroker): void;
+}

package/lib/core/transform/tracker/broker/WatchBrokerTransport.js

@@ -0,0 +1,89 @@
+'use strict';
+
+/**
+ * Common lifecycle seam for the native Windows stdio broker and macOS IPC.
+ *
+ * The transport owns framing and demand references only. Ordered native
+ * notifications and per-registration readiness remain backend responsibilities;
+ * a successful send cannot certify coverage or cache reuse.
+ *
+ * @evidence contracts/common.md#principled-implementation One transport seam preserves explicit failure and reference ownership for both supported broker backends.
+ * @evidence contracts/common.md#clear-and-simple-design Callers express send, demand and retirement through this namespace instead of duplicating platform checks or modifying a ChildProcess.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported child streams and IPC APIs are used without replacing runtime methods.
+ * @evidence contracts/common.md#meaningful-documentation Native prose separates transport completion from native watch authority.
+ * @evidence contracts/portability.md#os-neutral-implementation Native selection stays at broker startup; all tracker and observer consumers share these operations.
+ * @evidenceExclude contracts/performance.md#efficient-algorithms Member operations own their delegated cost.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work The broker owner selects transport and sharing lifetime.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources This namespace itself retains no transport registry.
+ */
+exports.WatchBrokerTransport = void 0;
+(function (WatchBrokerTransport) {
+    /**
+     * Queue a message on the selected transport. False refuses delivery; true
+     * only means queued, with actual acknowledgment or failure still
+     * outstanding.
+     *
+     * @evidence contracts/common.md#principled-implementation Native and IPC transports preserve separate queue acceptance and observed backend replies.
+     * @evidence contracts/common.md#clear-and-simple-design One selection delegates framing to the startup-owned transport.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts No queue result is upgraded into readiness or a native drain.
+     * @evidence contracts/common.md#meaningful-documentation Native prose states the limited meaning of the returned boolean.
+     * @evidence contracts/portability.md#os-neutral-implementation Explicit stdio capability takes precedence over optional IPC.
+     * @evidence contracts/performance.md#efficient-algorithms Transport selection is fixed work; JSON framing, message bytes and pipe backpressure belong to the selected sender.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Sending an effect does not own computation reuse.
+     * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The selected sender and request owner retain queued bytes and outstanding acknowledgment state.
+     */
+    function send(broker, message) {
+        return broker.transport === undefined
+            ? broker.child.send?.(message) === true
+            : broker.transport.send(message);
+    }
+    WatchBrokerTransport.send = send;
+    /**
+     * Keep the selected reply channel live exactly while caller demand exists.
+     * Counts belong to registration/drain owners; native references are flags.
+     *
+     * @evidence contracts/common.md#principled-implementation Outstanding requests retain both process and reply channel, preventing host exit before acknowledgment.
+     * @evidence contracts/common.md#clear-and-simple-design One operation applies the caller's aggregated demand to either transport.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Optional Bun IPC methods are used as capabilities without installing replacements.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies count ownership and flag semantics.
+     * @evidence contracts/portability.md#os-neutral-implementation Optional IPC methods and a selected native pipe capability express runtime differences.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Reference toggling selects no data-processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work This effect owns no shared computation.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The caller supplies aggregate demand; removing the last demand unreferences process and reply channel without asserting native termination.
+     */
+    function reference(broker, active) {
+        if (broker.transport !== undefined)
+            broker.transport.reference(active);
+        else if (active) {
+            broker.child.ref();
+            broker.child.channel?.ref?.();
+        }
+        else {
+            broker.child.unref();
+            broker.child.channel?.unref?.();
+        }
+    }
+    WatchBrokerTransport.reference = reference;
+    /**
+     * End this broker's request stream. The last-registration owner separately
+     * attempts process termination; closing a channel is not proof of child
+     * exit.
+     *
+     * @evidence contracts/common.md#principled-implementation Channel retirement is distinct from process exit and native resource closure.
+     * @evidence contracts/common.md#clear-and-simple-design Startup-owned transport closes its request stream without platform checks in consumers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported end/disconnect operations preserve native ownership without synthetic exit acknowledgment.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies the independent termination attempt and limited closure meaning.
+     * @evidence contracts/portability.md#os-neutral-implementation Selected stream closure and optional IPC disconnection keep platform details behind the transport seam.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Closing one channel selects no processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Retirement owns no computation reuse.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The selected transport ends its input; process kill and actual native cleanup remain the broker and backend's responsibilities.
+     */
+    function close(broker) {
+        if (broker.transport !== undefined)
+            broker.transport.close();
+        else
+            broker.child.disconnect?.();
+    }
+    WatchBrokerTransport.close = close;
+})(exports.WatchBrokerTransport || (exports.WatchBrokerTransport = {}));
+//# sourceMappingURL=WatchBrokerTransport.js.map

package/lib/core/transform/tracker/broker/WatchBrokerTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WatchBrokerTransport.js","sources":["../../../../../src/core/transform/tracker/broker/WatchBrokerTransport.ts"],"sourcesContent":[null],"names":["WatchBrokerTransport"],"mappings":";;AAEA;;;;;;;;;;;;;;;AAeG;AACcA;AAAjB,CAAA,UAAiB,oBAAoB,EAAA;AACnC;;;;;;;;;;;;;AAaG;AACH,IAAA,SAAgB,IAAI,CAAC,MAAmB,EAAE,OAAgB,EAAA;AACxD,QAAA,OAAO,MAAM,CAAC,SAAS,KAAK;cACxB,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,OAAiB,CAAC,KAAK;cAC3C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;IACpC;AAJgB,IAAA,oBAAA,CAAA,IAAI,OAInB;AAED;;;;;;;;;;;;AAYG;AACH,IAAA,SAAgB,SAAS,CAAC,MAAmB,EAAE,MAAe,EAAA;AAC5D,QAAA,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;AAAE,YAAA,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;aACjE,IAAI,MAAM,EAAE;AACf,YAAA,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;YAClB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI;QAC/B;aAAO;AACL,YAAA,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE;YACpB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,IAAI;QACjC;IACF;AATgB,IAAA,oBAAA,CAAA,SAAS,YASxB;AAED;;;;;;;;;;;;;AAaG;IACH,SAAgB,KAAK,CAAC,MAAmB,EAAA;AACvC,QAAA,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;AAAE,YAAA,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE;;AACvD,YAAA,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI;IAClC;AAHgB,IAAA,oBAAA,CAAA,KAAK,QAGpB;AACH,CAAC,EA/DgBA,4BAAoB,KAApBA,4BAAoB,GAAA,EAAA,CAAA,CAAA;;"}

package/lib/core/transform/tracker/broker/WatchBrokerTransport.mjs

@@ -0,0 +1,89 @@
+/**
+ * Common lifecycle seam for the native Windows stdio broker and macOS IPC.
+ *
+ * The transport owns framing and demand references only. Ordered native
+ * notifications and per-registration readiness remain backend responsibilities;
+ * a successful send cannot certify coverage or cache reuse.
+ *
+ * @evidence contracts/common.md#principled-implementation One transport seam preserves explicit failure and reference ownership for both supported broker backends.
+ * @evidence contracts/common.md#clear-and-simple-design Callers express send, demand and retirement through this namespace instead of duplicating platform checks or modifying a ChildProcess.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported child streams and IPC APIs are used without replacing runtime methods.
+ * @evidence contracts/common.md#meaningful-documentation Native prose separates transport completion from native watch authority.
+ * @evidence contracts/portability.md#os-neutral-implementation Native selection stays at broker startup; all tracker and observer consumers share these operations.
+ * @evidenceExclude contracts/performance.md#efficient-algorithms Member operations own their delegated cost.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work The broker owner selects transport and sharing lifetime.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources This namespace itself retains no transport registry.
+ */
+var WatchBrokerTransport;
+(function (WatchBrokerTransport) {
+    /**
+     * Queue a message on the selected transport. False refuses delivery; true
+     * only means queued, with actual acknowledgment or failure still
+     * outstanding.
+     *
+     * @evidence contracts/common.md#principled-implementation Native and IPC transports preserve separate queue acceptance and observed backend replies.
+     * @evidence contracts/common.md#clear-and-simple-design One selection delegates framing to the startup-owned transport.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts No queue result is upgraded into readiness or a native drain.
+     * @evidence contracts/common.md#meaningful-documentation Native prose states the limited meaning of the returned boolean.
+     * @evidence contracts/portability.md#os-neutral-implementation Explicit stdio capability takes precedence over optional IPC.
+     * @evidence contracts/performance.md#efficient-algorithms Transport selection is fixed work; JSON framing, message bytes and pipe backpressure belong to the selected sender.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Sending an effect does not own computation reuse.
+     * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The selected sender and request owner retain queued bytes and outstanding acknowledgment state.
+     */
+    function send(broker, message) {
+        return broker.transport === undefined
+            ? broker.child.send?.(message) === true
+            : broker.transport.send(message);
+    }
+    WatchBrokerTransport.send = send;
+    /**
+     * Keep the selected reply channel live exactly while caller demand exists.
+     * Counts belong to registration/drain owners; native references are flags.
+     *
+     * @evidence contracts/common.md#principled-implementation Outstanding requests retain both process and reply channel, preventing host exit before acknowledgment.
+     * @evidence contracts/common.md#clear-and-simple-design One operation applies the caller's aggregated demand to either transport.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Optional Bun IPC methods are used as capabilities without installing replacements.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies count ownership and flag semantics.
+     * @evidence contracts/portability.md#os-neutral-implementation Optional IPC methods and a selected native pipe capability express runtime differences.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Reference toggling selects no data-processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work This effect owns no shared computation.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The caller supplies aggregate demand; removing the last demand unreferences process and reply channel without asserting native termination.
+     */
+    function reference(broker, active) {
+        if (broker.transport !== undefined)
+            broker.transport.reference(active);
+        else if (active) {
+            broker.child.ref();
+            broker.child.channel?.ref?.();
+        }
+        else {
+            broker.child.unref();
+            broker.child.channel?.unref?.();
+        }
+    }
+    WatchBrokerTransport.reference = reference;
+    /**
+     * End this broker's request stream. The last-registration owner separately
+     * attempts process termination; closing a channel is not proof of child
+     * exit.
+     *
+     * @evidence contracts/common.md#principled-implementation Channel retirement is distinct from process exit and native resource closure.
+     * @evidence contracts/common.md#clear-and-simple-design Startup-owned transport closes its request stream without platform checks in consumers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Supported end/disconnect operations preserve native ownership without synthetic exit acknowledgment.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies the independent termination attempt and limited closure meaning.
+     * @evidence contracts/portability.md#os-neutral-implementation Selected stream closure and optional IPC disconnection keep platform details behind the transport seam.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Closing one channel selects no processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Retirement owns no computation reuse.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The selected transport ends its input; process kill and actual native cleanup remain the broker and backend's responsibilities.
+     */
+    function close(broker) {
+        if (broker.transport !== undefined)
+            broker.transport.close();
+        else
+            broker.child.disconnect?.();
+    }
+    WatchBrokerTransport.close = close;
+})(WatchBrokerTransport || (WatchBrokerTransport = {}));
+
+export { WatchBrokerTransport };
+//# sourceMappingURL=WatchBrokerTransport.mjs.map

package/lib/core/transform/tracker/broker/WatchBrokerTransport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WatchBrokerTransport.mjs","sources":["../../../../../src/core/transform/tracker/broker/WatchBrokerTransport.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;AAeG;AACG,IAAW;AAAjB,CAAA,UAAiB,oBAAoB,EAAA;AACnC;;;;;;;;;;;;;AAaG;AACH,IAAA,SAAgB,IAAI,CAAC,MAAmB,EAAE,OAAgB,EAAA;AACxD,QAAA,OAAO,MAAM,CAAC,SAAS,KAAK;cACxB,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,OAAiB,CAAC,KAAK;cAC3C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;IACpC;AAJgB,IAAA,oBAAA,CAAA,IAAI,OAInB;AAED;;;;;;;;;;;;AAYG;AACH,IAAA,SAAgB,SAAS,CAAC,MAAmB,EAAE,MAAe,EAAA;AAC5D,QAAA,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;AAAE,YAAA,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;aACjE,IAAI,MAAM,EAAE;AACf,YAAA,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;YAClB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI;QAC/B;aAAO;AACL,YAAA,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE;YACpB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,IAAI;QACjC;IACF;AATgB,IAAA,oBAAA,CAAA,SAAS,YASxB;AAED;;;;;;;;;;;;;AAaG;IACH,SAAgB,KAAK,CAAC,MAAmB,EAAA;AACvC,QAAA,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;AAAE,YAAA,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE;;AACvD,YAAA,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI;IAClC;AAHgB,IAAA,oBAAA,CAAA,KAAK,QAGpB;AACH,CAAC,EA/DgB,oBAAoB,KAApB,oBAAoB,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/core/transform/tracker/broker/brokeredTrackerSink.d.cts

@@ -0,0 +1,64 @@
+import type { TtscProjectMutationTracker } from "../TtscProjectMutationTracker.cjs";
+import type { WatchBrokerSink } from "./WatchBrokerSink.cjs";
+/**
+ * The sink a tracker's brokered watches report to: what each message of the
+ * isolated watch process means to a generation's tracker.
+ *
+ * - An event is classified by the tracker's own filters. With the exact-input
+ *   trackers' shared classifier, it alone decides between a mutation, a content
+ *   change, and no recorded change; uncertain native aliases can independently
+ *   withdraw the tracker's verification authority. With the project-directory
+ *   tracker's filters, a named event records membership when admitted and
+ *   structural, or content for an admitted non-rename event. Rejected
+ *   membership can still withdraw authority through the owner filter. Events
+ *   without that filter are mutations.
+ * - An event the child could not place is a membership change of unknown kind.
+ * - A failed watch fails the tracker, so its silence is never read as proof.
+ * - A gap leaves the tracker hearing everything after it, so it is marked
+ *   unverified, and its silence proves nothing until a delivery proves the
+ *   recorded state again (samchon/ttsc#1425).
+ * - A drain's verdict replaces the tracker's unproven set (samchon/ttsc#1453).
+ *
+ * @param tracker The tracker the watches are registered for.
+ * @param filters The tracker's event decision: the exact-input trackers'
+ *   classifier, or the project-directory tracker's membership, content, and
+ *   new-membership filters.
+ * @evidence contracts/common.md#principled-implementation
+ *   Owner filters classify events; failed, gap and partial drain messages update
+ *   different authority fields rather than pretending they are mutations.
+ * @evidence contracts/common.md#clear-and-simple-design
+ *   One sink adapts the broker protocol to tracker state and delegates exact
+ *   input classification wholesale, keeping backend policies equivalent.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts
+ *   Unattributed events remain structural witnesses and failed coverage remains failed;
+ *   the adapter neither suppresses events nor patches a foreign watcher.
+ * @evidence contracts/common.md#meaningful-documentation
+ *   Native message list and parameter comments distinguish each verdict and
+ *   classifier precedence under the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation
+ *   OS-neutral event construction uses node:path and owner-translated directory
+ *   spellings; native drop and probe semantics are explicit protocol inputs.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources
+ *   The sink retains its tracker and owner filters until registration retirement.
+ *   A supplied unproven-directory Set transfers to the tracker and is replaced
+ *   by subsequent drain verdicts; the tracker close retires its registration.
+ * @evidence contracts/performance.md#efficient-algorithms Each message follows one handler; named events include native path construction, delegated owner classification and bounded witness recording. Those costs follow path text and the owner's scope indexes, not the adapter's statement count.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each tracker has its own sink, and events are effects rather than computations to share.
+ */
+export declare function brokeredTrackerSink(tracker: TtscProjectMutationTracker, filters?: {
+    /** Whether a named `change` can add one unknown program path. */
+    changeAddsMembership?: (location: string, filename: string) => boolean;
+    /**
+     * The exact-input trackers' event decision. When present it is the only
+     * filter applied.
+     */
+    classify?: (location: string, filename: string | null, eventType: string) => "change" | "mutation" | undefined;
+    /** Whether a named event can change compiler-consumed content. */
+    content?: (location: string, filename: string) => boolean;
+    /**
+     * Whether a named event can be a program membership change, for the
+     * project-directory tracker, which watches whole directories and so has to
+     * narrow what it hears.
+     */
+    membership?: (location: string, filename: string) => boolean;
+}): WatchBrokerSink;

package/lib/core/transform/tracker/broker/brokeredTrackerSink.d.mts

@@ -0,0 +1,64 @@
+import type { TtscProjectMutationTracker } from "../TtscProjectMutationTracker.mjs";
+import type { WatchBrokerSink } from "./WatchBrokerSink.mjs";
+/**
+ * The sink a tracker's brokered watches report to: what each message of the
+ * isolated watch process means to a generation's tracker.
+ *
+ * - An event is classified by the tracker's own filters. With the exact-input
+ *   trackers' shared classifier, it alone decides between a mutation, a content
+ *   change, and no recorded change; uncertain native aliases can independently
+ *   withdraw the tracker's verification authority. With the project-directory
+ *   tracker's filters, a named event records membership when admitted and
+ *   structural, or content for an admitted non-rename event. Rejected
+ *   membership can still withdraw authority through the owner filter. Events
+ *   without that filter are mutations.
+ * - An event the child could not place is a membership change of unknown kind.
+ * - A failed watch fails the tracker, so its silence is never read as proof.
+ * - A gap leaves the tracker hearing everything after it, so it is marked
+ *   unverified, and its silence proves nothing until a delivery proves the
+ *   recorded state again (samchon/ttsc#1425).
+ * - A drain's verdict replaces the tracker's unproven set (samchon/ttsc#1453).
+ *
+ * @param tracker The tracker the watches are registered for.
+ * @param filters The tracker's event decision: the exact-input trackers'
+ *   classifier, or the project-directory tracker's membership, content, and
+ *   new-membership filters.
+ * @evidence contracts/common.md#principled-implementation
+ *   Owner filters classify events; failed, gap and partial drain messages update
+ *   different authority fields rather than pretending they are mutations.
+ * @evidence contracts/common.md#clear-and-simple-design
+ *   One sink adapts the broker protocol to tracker state and delegates exact
+ *   input classification wholesale, keeping backend policies equivalent.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts
+ *   Unattributed events remain structural witnesses and failed coverage remains failed;
+ *   the adapter neither suppresses events nor patches a foreign watcher.
+ * @evidence contracts/common.md#meaningful-documentation
+ *   Native message list and parameter comments distinguish each verdict and
+ *   classifier precedence under the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation
+ *   OS-neutral event construction uses node:path and owner-translated directory
+ *   spellings; native drop and probe semantics are explicit protocol inputs.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources
+ *   The sink retains its tracker and owner filters until registration retirement.
+ *   A supplied unproven-directory Set transfers to the tracker and is replaced
+ *   by subsequent drain verdicts; the tracker close retires its registration.
+ * @evidence contracts/performance.md#efficient-algorithms Each message follows one handler; named events include native path construction, delegated owner classification and bounded witness recording. Those costs follow path text and the owner's scope indexes, not the adapter's statement count.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each tracker has its own sink, and events are effects rather than computations to share.
+ */
+export declare function brokeredTrackerSink(tracker: TtscProjectMutationTracker, filters?: {
+    /** Whether a named `change` can add one unknown program path. */
+    changeAddsMembership?: (location: string, filename: string) => boolean;
+    /**
+     * The exact-input trackers' event decision. When present it is the only
+     * filter applied.
+     */
+    classify?: (location: string, filename: string | null, eventType: string) => "change" | "mutation" | undefined;
+    /** Whether a named event can change compiler-consumed content. */
+    content?: (location: string, filename: string) => boolean;
+    /**
+     * Whether a named event can be a program membership change, for the
+     * project-directory tracker, which watches whole directories and so has to
+     * narrow what it hears.
+     */
+    membership?: (location: string, filename: string) => boolean;
+}): WatchBrokerSink;

package/lib/core/transform/tracker/broker/brokeredTrackerSink.d.ts

@@ -0,0 +1,64 @@
+import type { TtscProjectMutationTracker } from "../TtscProjectMutationTracker";
+import type { WatchBrokerSink } from "./WatchBrokerSink";
+/**
+ * The sink a tracker's brokered watches report to: what each message of the
+ * isolated watch process means to a generation's tracker.
+ *
+ * - An event is classified by the tracker's own filters. With the exact-input
+ *   trackers' shared classifier, it alone decides between a mutation, a content
+ *   change, and no recorded change; uncertain native aliases can independently
+ *   withdraw the tracker's verification authority. With the project-directory
+ *   tracker's filters, a named event records membership when admitted and
+ *   structural, or content for an admitted non-rename event. Rejected
+ *   membership can still withdraw authority through the owner filter. Events
+ *   without that filter are mutations.
+ * - An event the child could not place is a membership change of unknown kind.
+ * - A failed watch fails the tracker, so its silence is never read as proof.
+ * - A gap leaves the tracker hearing everything after it, so it is marked
+ *   unverified, and its silence proves nothing until a delivery proves the
+ *   recorded state again (samchon/ttsc#1425).
+ * - A drain's verdict replaces the tracker's unproven set (samchon/ttsc#1453).
+ *
+ * @param tracker The tracker the watches are registered for.
+ * @param filters The tracker's event decision: the exact-input trackers'
+ *   classifier, or the project-directory tracker's membership, content, and
+ *   new-membership filters.
+ * @evidence contracts/common.md#principled-implementation
+ *   Owner filters classify events; failed, gap and partial drain messages update
+ *   different authority fields rather than pretending they are mutations.
+ * @evidence contracts/common.md#clear-and-simple-design
+ *   One sink adapts the broker protocol to tracker state and delegates exact
+ *   input classification wholesale, keeping backend policies equivalent.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts
+ *   Unattributed events remain structural witnesses and failed coverage remains failed;
+ *   the adapter neither suppresses events nor patches a foreign watcher.
+ * @evidence contracts/common.md#meaningful-documentation
+ *   Native message list and parameter comments distinguish each verdict and
+ *   classifier precedence under the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation
+ *   OS-neutral event construction uses node:path and owner-translated directory
+ *   spellings; native drop and probe semantics are explicit protocol inputs.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources
+ *   The sink retains its tracker and owner filters until registration retirement.
+ *   A supplied unproven-directory Set transfers to the tracker and is replaced
+ *   by subsequent drain verdicts; the tracker close retires its registration.
+ * @evidence contracts/performance.md#efficient-algorithms Each message follows one handler; named events include native path construction, delegated owner classification and bounded witness recording. Those costs follow path text and the owner's scope indexes, not the adapter's statement count.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each tracker has its own sink, and events are effects rather than computations to share.
+ */
+export declare function brokeredTrackerSink(tracker: TtscProjectMutationTracker, filters?: {
+    /** Whether a named `change` can add one unknown program path. */
+    changeAddsMembership?: (location: string, filename: string) => boolean;
+    /**
+     * The exact-input trackers' event decision. When present it is the only
+     * filter applied.
+     */
+    classify?: (location: string, filename: string | null, eventType: string) => "change" | "mutation" | undefined;
+    /** Whether a named event can change compiler-consumed content. */
+    content?: (location: string, filename: string) => boolean;
+    /**
+     * Whether a named event can be a program membership change, for the
+     * project-directory tracker, which watches whole directories and so has to
+     * narrow what it hears.
+     */
+    membership?: (location: string, filename: string) => boolean;
+}): WatchBrokerSink;