kokorobox-native 0.16.6 → 0.16.8

package/README.md

@@ -83,3 +83,31 @@ NetworkManager/systemd-resolved and falls back to resolv.conf for inspection.
 Bootstrap repair is Desktop configuration policy: Desktop copies the observed
 system DNS addresses into `dns.default-nameserver` and restarts the core. Native
 does not expose an OS DNS mutation API for diagnostics.
+
+## macOS application routing logs
+
+`getMacosApplicationRoutingLogs(): Promise<MacosApplicationRoutingLog[]>` drains
+up to 100 activity/connection entries from the approved KokoroBox Network
+Extension via its provider-message channel. Records have `time`, `message` and
+`level`; connection messages contain protocol, application, destination, port and
+routing result. Older provider connection entries without timestamps return an
+empty `time` so the caller can use its receipt time.
+
+`clearMacosApplicationRoutingLogs(): Promise<void>` clears provider history after
+checking its acknowledgement. A stopped or absent session returns an empty batch
+and clearing it is a no-op. Other OS/provider failures reject. Calls run on N-API
+workers; the provider send runs on the main dispatch queue with a five-second
+reply timeout, following the bounded preferences load. Responses are checked for
+version, schema, count, size and invalid fields before crossing into JavaScript.
+The caller should serialize reads and clears and retain its own bounded history.
+These operations require macOS and do not activate an extension or change policy.
+
+### macOS Settings navigation regression check
+
+After building a macOS `.node`, run `sh scripts/check-macos-routing.sh path/to/binary.node`.
+The check verifies Settings destinations for macOS 13/14 and 15+, then checks the
+actual Rust-linked library for unresolved Clang availability helpers. N-API uses
+`dynamic_lookup` for Node exports, so an accidentally unresolved availability
+helper can survive linking and crash the Electron main thread. Settings routing
+uses `NSProcessInfo.operatingSystemVersion` to avoid this compiler-runtime dependency.
+The check opens no apps and requests no System Extension activation or approval.

package/index.d.ts

@@ -446,3 +446,12 @@ export interface CoreValidationResult { outcome: 'valid' | 'invalid' | 'timeout'
 export function validateCoreProfile(options: CoreValidationOptions): Promise<CoreValidationResult>;
 
 export function getServiceProcessStatus(executable: string): Promise<'running' | 'stopped' | 'paused' | 'not-installed' | 'unknown'>;
+
+export interface MacosApplicationRoutingLog {
+  time: string;
+  message: string;
+  level: string;
+}
+/** Drains at most 100 entries from the Network Extension. */
+export function getMacosApplicationRoutingLogs(): Promise<MacosApplicationRoutingLog[]>;
+export function clearMacosApplicationRoutingLogs(): Promise<void>;

package/index.js

@@ -212,3 +212,6 @@ export const reconcileMacosApplicationRouting = diagnosticBinding.reconcileMacos
 export const validateCoreProfile = diagnosticBinding.validateCoreProfile;
 
 export const getServiceProcessStatus = diagnosticBinding.getServiceProcessStatus;
+
+export const getMacosApplicationRoutingLogs = diagnosticBinding.getMacosApplicationRoutingLogs;
+export const clearMacosApplicationRoutingLogs = diagnosticBinding.clearMacosApplicationRoutingLogs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kokorobox-native",
-  "version": "0.16.6",
+  "version": "0.16.8",
   "description": "KokoroBox native bridge",
   "type": "module",
   "main": "index.js",
@@ -50,11 +50,11 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "kokorobox-native-win32-x64-msvc": "0.16.6",
-    "kokorobox-native-win32-arm64-msvc": "0.16.6",
-    "kokorobox-native-darwin-x64": "0.16.6",
-    "kokorobox-native-darwin-arm64": "0.16.6",
-    "kokorobox-native-linux-x64-gnu": "0.16.6",
-    "kokorobox-native-linux-arm64-gnu": "0.16.6"
+    "kokorobox-native-win32-x64-msvc": "0.16.8",
+    "kokorobox-native-win32-arm64-msvc": "0.16.8",
+    "kokorobox-native-darwin-x64": "0.16.8",
+    "kokorobox-native-darwin-arm64": "0.16.8",
+    "kokorobox-native-linux-x64-gnu": "0.16.8",
+    "kokorobox-native-linux-arm64-gnu": "0.16.8"
   }
 }