@absolutejs/absolute 0.20.0-beta.36 → 0.20.0-beta.37

package/README.md

@@ -254,6 +254,13 @@ edit Swift/Kotlin, or maintain native bootstrap code. Type-only imports and test
 sources do not provision plugins. `absolute mobile doctor release` rejects a
 missing or mismatched plugin before release.
 
+Run `absolute mobile inspect` from an application root for a read-only summary
+of the effective mobile config, runtime package versions, discovered
+capabilities/plugins, native-project state, embedded routes/frameworks, bundle
+validation, and release projection. Add `--json` for a redacted CI or support
+artifact; it omits credentials, device/account identifiers, absolute paths, and
+detailed doctor messages. See [mobile project inspection](docs/MOBILE_INSPECT.md).
+
 `keyboard` provides portable visibility, CSS-pixel height, dismissal, and
 cleanup-safe change events. `systemBars` controls modern edge-to-edge status and
 navigation bar foreground appearance/visibility through Capacitor 8 core. Its

package/dist/angular/components/core/streamingSlotRegistrar.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-ISzk2S/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-6Q6jJy/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");

package/dist/angular/components/core/streamingSlotRegistry.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-ISzk2S/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-6Q6jJy/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");
@@ -48,7 +48,7 @@ var warnMissingStreamingSlotCollector = (primitiveName) => {
   getWarningController()?.maybeWarn(primitiveName);
 };
 
-// .angular-partial-tmp-ISzk2S/src/core/streamingSlotRegistry.ts
+// .angular-partial-tmp-6Q6jJy/src/core/streamingSlotRegistry.ts
 var STREAMING_SLOT_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotAsyncLocalStorage");
 var isObjectRecord2 = (value) => Boolean(value) && typeof value === "object";
 var isAsyncLocalStorage = (value) => isObjectRecord2(value) && ("getStore" in value) && typeof value.getStore === "function" && ("run" in value) && typeof value.run === "function";

package/dist/cli/index.js

@@ -18996,16 +18996,270 @@ var prepareAbsoluteIosRelease = async (publisher, options) => {
 };
 var init_releasePublisher = () => {};
 
+// src/mobile/mobileInspect.ts
+import { access as access11, readFile as readFile20, stat as stat4 } from "fs/promises";
+import { join as join52, relative as relative27, resolve as resolve41 } from "path";
+var ABSOLUTE_MOBILE_INSPECTION_FORMAT = 1, MOBILE_PACKAGE_NAMES, MOBILE_FRAMEWORKS, isObject2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value), portablePath = (projectRoot, path) => {
+  const value = relative27(resolve41(projectRoot), resolve41(path)).replaceAll("\\", "/");
+  return value || ".";
+}, pathExists7 = async (path) => {
+  try {
+    await access11(path);
+    return true;
+  } catch {
+    return false;
+  }
+}, readObject = async (path) => {
+  const value = JSON.parse(await readFile20(path, "utf8"));
+  if (!isObject2(value))
+    throw new TypeError("JSON root must be an object.");
+  return value;
+}, requireString = (value, field) => {
+  if (typeof value !== "string" || value.length === 0)
+    throw new TypeError(`${field} must be a non-empty string.`);
+  return value;
+}, requireStringArray = (value, field) => {
+  if (!Array.isArray(value) || !value.every((item) => typeof item === "string"))
+    throw new TypeError(`${field} must be a string array.`);
+  return value;
+}, requireBundleFile = async (root, value, field) => {
+  const portable = requireString(value, field);
+  const path = resolve41(root, portable);
+  const normalizedRoot = resolve41(root);
+  if (path === normalizedRoot || !path.startsWith(`${normalizedRoot}/`))
+    throw new TypeError(`${field} must remain inside the mobile bundle.`);
+  if (!(await stat4(path).catch(() => {
+    return;
+  }))?.isFile())
+    throw new TypeError(`${field} does not exist in the mobile bundle.`);
+  return portable;
+}, inspectBundle = async (config, projectRoot) => {
+  const manifestPath = join52(config.bundleDirectory, "absolute-mobile-manifest.json");
+  const manifest = portablePath(projectRoot, manifestPath);
+  if (!await pathExists7(manifestPath))
+    return { manifest, status: "missing" };
+  try {
+    const value = await readObject(manifestPath);
+    if (value.format !== 1)
+      throw new TypeError("format is not supported by this runtime.");
+    if (requireString(value.appId, "appId") !== config.appId)
+      throw new TypeError("appId does not match the effective mobile config.");
+    if (requireString(value.productionOrigin, "productionOrigin") !== config.productionOrigin)
+      throw new TypeError("productionOrigin does not match the effective mobile config.");
+    const appBuild = requireString(value.appBuild, "appBuild");
+    const runtime = requireString(value.runtime, "runtime");
+    const capabilities = requireStringArray(value.deviceCapabilities, "deviceCapabilities").sort();
+    if (!Array.isArray(value.pages) || !Array.isArray(value.routes))
+      throw new TypeError("pages and routes must be arrays.");
+    const pageIds = new Set;
+    const frameworks7 = new Set;
+    await Promise.all(value.pages.map(async (candidate) => {
+      if (!isObject2(candidate))
+        throw new TypeError("pages contains an invalid entry.");
+      const pageId = requireString(candidate.pageId, "page.pageId");
+      if (pageIds.has(pageId))
+        throw new TypeError("page.pageId values must be unique.");
+      pageIds.add(pageId);
+      const framework = requireString(candidate.framework, "page.framework");
+      if (!MOBILE_FRAMEWORKS.has(framework))
+        throw new TypeError("page.framework is unsupported.");
+      frameworks7.add(framework);
+      requireString(candidate.bundleHash, "page.bundleHash");
+      requireString(candidate.contract, "page.contract");
+      requireString(candidate.propsSchemaHash, "page.propsSchemaHash");
+      await requireBundleFile(config.bundleDirectory, candidate.localBundlePath, "page.localBundlePath");
+      if (candidate.localStylePath !== undefined)
+        await requireBundleFile(config.bundleDirectory, candidate.localStylePath, "page.localStylePath");
+    }));
+    const routes = value.routes.map((candidate) => {
+      if (!isObject2(candidate))
+        throw new TypeError("routes contains an invalid entry.");
+      const { method } = candidate;
+      if (method !== "GET" && method !== "HEAD")
+        throw new TypeError("route.method must be GET or HEAD.");
+      const pageId = requireString(candidate.pageId, "route.pageId");
+      if (!pageIds.has(pageId))
+        throw new TypeError("route.pageId references a missing page.");
+      return {
+        method,
+        pageId,
+        pattern: requireString(candidate.pattern, "route.pattern")
+      };
+    });
+    await Promise.all(["index.html", "absolute-mobile-bootstrap.js"].map((file) => requireBundleFile(config.bundleDirectory, file, file)));
+    const entryPath = new URL(config.entry, "https://absolute.invalid").pathname;
+    const entryResolved = resolveAbsoluteMobileRoute(routes, entryPath) !== undefined;
+    if (!entryResolved)
+      throw new TypeError("entry is not owned by an embedded route.");
+    return {
+      appBuild,
+      auth: isObject2(value.auth),
+      capabilities,
+      entryResolved,
+      frameworks: [...frameworks7].sort(),
+      manifest,
+      pageCount: value.pages.length,
+      routeCount: value.routes.length,
+      runtime,
+      status: "valid",
+      sync: isObject2(value.sync)
+    };
+  } catch (error) {
+    return {
+      issue: error instanceof Error ? error.message : "The embedded mobile manifest is invalid.",
+      manifest,
+      status: "invalid"
+    };
+  }
+}, addPackageDeclarations = (declarations, value) => {
+  if (!isObject2(value))
+    return;
+  for (const [name, declared] of Object.entries(value).filter((entry) => typeof entry[1] === "string"))
+    declarations.set(name, declared);
+}, packageInspections = async (projectRoot, additionalNames) => {
+  const project = await readObject(join52(projectRoot, "package.json"));
+  const declarations = new Map;
+  for (const field of ["dependencies", "devDependencies"])
+    addPackageDeclarations(declarations, project[field]);
+  const names = [...new Set([...declarations.keys(), ...additionalNames])].filter((name) => MOBILE_PACKAGE_NAMES.has(name) || name.startsWith("@capacitor/") || additionalNames.includes(name)).sort();
+  return Promise.all(names.map(async (name) => {
+    const installedManifest = await readObject(join52(projectRoot, "node_modules", name, "package.json")).catch(() => {
+      return;
+    });
+    const installed = installedManifest?.version;
+    return {
+      declared: declarations.get(name) ?? "transitive",
+      ...typeof installed === "string" ? { installed } : {},
+      name
+    };
+  }));
+}, inspectAbsoluteMobileProject = async (config, projectRoot, options = {}) => {
+  const bundle = await inspectBundle(config, projectRoot);
+  let currentCapabilities = [];
+  let capabilityIssue;
+  let plugins = [];
+  try {
+    const plan = resolveAbsoluteDeviceCapabilityPlan(projectRoot);
+    currentCapabilities = plan.capabilities;
+    plugins = plan.requiredPackages;
+  } catch {
+    capabilityIssue = "Native capability metadata could not be resolved.";
+  }
+  const pluginNames = plugins.map((spec) => spec.slice(0, spec.lastIndexOf("@")));
+  const releaseInspection = await (options.inspectRelease ?? inspectAbsoluteMobileRelease)(config, projectRoot).catch(() => ({ checks: [], ready: false }));
+  return {
+    bundle,
+    capabilities: {
+      current: currentCapabilities,
+      ...bundle.capabilities ? {
+        embeddedMatchesCurrent: JSON.stringify(bundle.capabilities) === JSON.stringify(currentCapabilities)
+      } : {},
+      ...capabilityIssue ? { issue: capabilityIssue } : {},
+      plugins
+    },
+    config: {
+      appId: config.appId,
+      appName: config.appName,
+      bundleDirectory: portablePath(projectRoot, config.bundleDirectory),
+      deepLinkHosts: config.deepLinkHosts,
+      deepLinkScheme: config.deepLinkScheme,
+      engine: config.engine,
+      entry: config.entry,
+      iosVersion: config.iosVersion,
+      nativeProjectDirectory: portablePath(projectRoot, config.nativeProjectDirectory),
+      platforms: config.platforms,
+      productionOrigin: config.productionOrigin
+    },
+    format: ABSOLUTE_MOBILE_INSPECTION_FORMAT,
+    nativeProjects: await Promise.all(config.platforms.map(async (platform6) => {
+      const path = join52(config.nativeProjectDirectory, platform6);
+      return {
+        initialized: await pathExists7(path),
+        path: portablePath(projectRoot, path),
+        platform: platform6
+      };
+    })),
+    packages: await packageInspections(projectRoot, pluginNames),
+    release: {
+      checks: releaseInspection.checks.map(({ id, status: status2 }) => ({
+        id,
+        status: status2
+      })),
+      ready: releaseInspection.ready
+    },
+    runtime: { absolutejs: options.absolutejsVersion ?? "unknown" }
+  };
+}, yesNo = (value) => value ? "yes" : "no", renderAbsoluteMobileProjectInspection = (report) => {
+  const lines = [
+    `AbsoluteJS mobile inspection (format ${report.format})`,
+    "",
+    `App: ${report.config.appName} (${report.config.appId})`,
+    `Engine: ${report.config.engine}`,
+    `Platforms: ${report.config.platforms.join(", ")}`,
+    `Entry: ${report.config.entry}`,
+    `Production origin: ${report.config.productionOrigin}`,
+    `AbsoluteJS: ${report.runtime.absolutejs}`,
+    "",
+    `Bundle: ${report.bundle.status} (${report.bundle.manifest})`
+  ];
+  if (report.bundle.status === "valid") {
+    lines.push(`  Build/runtime: ${report.bundle.appBuild} / ${report.bundle.runtime}`, `  Pages/routes: ${report.bundle.pageCount} / ${report.bundle.routeCount}`, `  Frameworks: ${report.bundle.frameworks?.join(", ") || "none"}`, `  Auth/Sync: ${yesNo(report.bundle.auth === true)} / ${yesNo(report.bundle.sync === true)}`);
+  } else if (report.bundle.issue)
+    lines.push(`  Issue: ${report.bundle.issue}`);
+  lines.push("", `Capabilities: ${report.capabilities.current.join(", ") || "none"}`, `Native plugins: ${report.capabilities.plugins.join(", ") || "none"}`);
+  if (report.capabilities.embeddedMatchesCurrent !== undefined)
+    lines.push(`Embedded capabilities current: ${yesNo(report.capabilities.embeddedMatchesCurrent)}`);
+  if (report.capabilities.issue)
+    lines.push(`Capability issue: ${report.capabilities.issue}`);
+  lines.push("", "Native projects:");
+  for (const project of report.nativeProjects)
+    lines.push(`  ${project.platform}: ${project.initialized ? "initialized" : "missing"} (${project.path})`);
+  lines.push("", "Runtime packages:");
+  for (const runtimePackage of report.packages)
+    lines.push(`  ${runtimePackage.name}: ${runtimePackage.installed ?? "not installed"} (declared ${runtimePackage.declared})`);
+  const failed = report.release.checks.filter((check2) => check2.status === "fail").length;
+  const warned = report.release.checks.filter((check2) => check2.status === "warn").length;
+  lines.push("", `Release projection: ${report.release.ready ? "ready" : "not ready"} (${failed} failed, ${warned} warnings)`);
+  return `${lines.join(`
+`)}
+`;
+};
+var init_mobileInspect = __esm(() => {
+  init_deviceCapabilities();
+  init_releaseDoctor();
+  init_routeMatcher();
+  MOBILE_PACKAGE_NAMES = new Set([
+    "@absolutejs/absolute",
+    "@absolutejs/auth",
+    "@absolutejs/devices",
+    "@absolutejs/devices-capacitor",
+    "@absolutejs/http",
+    "@absolutejs/pwa",
+    "@absolutejs/sync",
+    "@absolutejs/sync-capacitor",
+    "@capacitor-community/sqlite"
+  ]);
+  MOBILE_FRAMEWORKS = new Set([
+    "angular",
+    "ember",
+    "html",
+    "htmx",
+    "react",
+    "svelte",
+    "vue"
+  ]);
+});
+
 // src/cli/scripts/mobile.ts
 var exports_mobile = {};
 __export(exports_mobile, {
   runMobile: () => runMobile
 });
-import { access as access11, mkdir as mkdir14, readFile as readFile20, writeFile as writeFile16 } from "fs/promises";
-import { join as join52, resolve as resolve41 } from "path";
+import { access as access12, mkdir as mkdir14, readFile as readFile21, writeFile as writeFile16 } from "fs/promises";
+import { join as join53, resolve as resolve42 } from "path";
 import { createInterface } from "readline/promises";
 var NOT_FOUND3 = -1, isRecord15 = (value) => typeof value === "object" && value !== null && !Array.isArray(value), CAPACITOR_PACKAGES, CAPACITOR_PACKAGE_SPECS, CAPACITOR_SYNC_PACKAGE_SPECS, packageNameFromSpec = (spec) => spec.slice(0, spec.lastIndexOf("@")), directProjectPackages = async (projectRoot) => {
-  const manifest = JSON.parse(await readFile20(join52(projectRoot, "package.json"), "utf8"));
+  const manifest = JSON.parse(await readFile21(join53(projectRoot, "package.json"), "utf8"));
   if (!isRecord15(manifest))
     throw new TypeError("Application package.json must contain an object.");
   const names = new Set;
@@ -19018,7 +19272,7 @@ var NOT_FOUND3 = -1, isRecord15 = (value) => typeof value === "object" && value
   return names;
 }, resolvedPackageVersion = async (projectRoot, packageName) => {
   try {
-    const manifest = JSON.parse(await readFile20(join52(projectRoot, "node_modules", packageName, "package.json"), "utf8"));
+    const manifest = JSON.parse(await readFile21(join53(projectRoot, "node_modules", packageName, "package.json"), "utf8"));
     return isRecord15(manifest) && typeof manifest.version === "string" ? manifest.version : undefined;
   } catch {
     return;
@@ -19059,9 +19313,9 @@ var NOT_FOUND3 = -1, isRecord15 = (value) => typeof value === "object" && value
   }
   return value;
 }, capacitorExecutable = async (projectRoot) => {
-  const executable = join52(projectRoot, "node_modules", ".bin", "cap");
+  const executable = join53(projectRoot, "node_modules", ".bin", "cap");
   try {
-    await access11(executable);
+    await access12(executable);
     return executable;
   } catch {
     throw new TypeError(`Capacitor is not installed in this app. Run: bun add ${CAPACITOR_PACKAGES.join(" ")}`);
@@ -19083,6 +19337,17 @@ var NOT_FOUND3 = -1, isRecord15 = (value) => typeof value === "object" && value
   const config = await loadConfig(configPath2);
   const mobile = normalizeAbsoluteMobileConfig(requireMobileConfig(config.mobile), projectRoot);
   return { mobile, projectRoot };
+}, inspectMobile = async (args) => {
+  const { mobile, projectRoot } = await loadMobile(valueAfter(args, "--config"));
+  const report = await inspectAbsoluteMobileProject(mobile, projectRoot, {
+    absolutejsVersion: await absolutejsVersionForReport()
+  });
+  if (args.includes("--json")) {
+    console.log(JSON.stringify(report, null, 2));
+    return report;
+  }
+  console.log(renderAbsoluteMobileProjectInspection(report).trimEnd());
+  return report;
 }, remoteProfilePath = () => process.env.ABSOLUTE_REMOTE_MAC_PROFILE_PATH || undefined, pairRemoteMac = async (args) => {
   if (args[0] !== "mac" || !args[1] || !args[2])
     throw new TypeError("Usage: absolute mobile pair mac <name> <user@host> [--port n] [--workspace path]");
@@ -19147,7 +19412,7 @@ var NOT_FOUND3 = -1, isRecord15 = (value) => typeof value === "object" && value
   await applyAbsoluteNativeBackgroundSync(projectRoot, mobile, platforms);
 }, associations = async (args) => {
   const { mobile, projectRoot } = await loadMobile(valueAfter(args, "--config"));
-  const outputDirectory = resolve41(projectRoot, valueAfter(args, "--outdir") ?? ".absolutejs/mobile/associations");
+  const outputDirectory = resolve42(projectRoot, valueAfter(args, "--outdir") ?? ".absolutejs/mobile/associations");
   if (args.includes("--verify")) {
     const result2 = await verifyAbsoluteMobileAssociationFiles(mobile);
     console.log(`Verified ${result2.results.length} hosted association files`);
@@ -19380,7 +19645,7 @@ Mobile release transport checks failed.`);
     const durationMs = Math.round(performance.now() - startedAt);
     console.log(`Built ${release.metadata.signed ? "signed" : "unsigned"} Android App Bundle in ${getDurationString(durationMs)}.`);
     console.log(`Artifact: ${release.artifactPath}`);
-    console.log(`Metadata: ${join52(release.releaseRoot, "release.json")}`);
+    console.log(`Metadata: ${join53(release.releaseRoot, "release.json")}`);
     return release;
   } finally {
     sendTelemetryEvent("mobile:android-release-build", {
@@ -19483,7 +19748,7 @@ Mobile release transport checks failed.`);
     const durationMs = Math.round(performance.now() - startedAt);
     console.log(`Built ${release.metadata.signed ? "signed" : "unsigned"} iOS IPA ${release.metadata.marketingVersion}${release.metadata.buildNumber ? ` (${release.metadata.buildNumber})` : ""} in ${getDurationString(durationMs)}.`);
     console.log(`Artifact: ${release.artifactPath}`);
-    console.log(`Metadata: ${join52(release.releaseRoot, "release.json")}`);
+    console.log(`Metadata: ${join53(release.releaseRoot, "release.json")}`);
     return release;
   } finally {
     sendTelemetryEvent("mobile:ios-release-build", {
@@ -19590,7 +19855,7 @@ Mobile release transport checks failed.`);
     checks.push({
       id: "sync.storage-schema",
       label: `Offline schema ${schema.components.map((component2) => `${component2.id}@${component2.version}`).join(", ")}`,
-      path: join52(projectRoot, "package.json"),
+      path: join53(projectRoot, "package.json"),
       platform: "host",
       status: "pass"
     });
@@ -19598,7 +19863,7 @@ Mobile release transport checks failed.`);
     checks.push({
       id: "sync.storage-schema",
       label: "Offline schema metadata is invalid",
-      path: join52(projectRoot, "package.json"),
+      path: join53(projectRoot, "package.json"),
       platform: "host",
       remediation: error instanceof Error ? error.message : String(error),
       status: "fail"
@@ -19683,7 +19948,7 @@ Emulator setup verification:`);
     }
     return { https: args.includes("--https"), port };
   }
-  const instances = listLiveInstances().filter((instance2) => resolve41(instance2.cwd) === resolve41(projectRoot) && instance2.source === "dev" && instance2.port !== null);
+  const instances = listLiveInstances().filter((instance2) => resolve42(instance2.cwd) === resolve42(projectRoot) && instance2.source === "dev" && instance2.port !== null);
   if (instances.length !== 1) {
     throw new TypeError(instances.length === 0 ? "No running AbsoluteJS dev server was found for this project. Start `bun dev`, wait for Android to report ready, then run `absolute mobile test android`." : "Multiple dev servers are running for this project. Select one with mobile test android --port <port>.");
   }
@@ -19726,8 +19991,8 @@ Emulator setup verification:`);
   }
   return selected;
 }, safeArtifactRoot = (projectRoot, value) => {
-  const root = resolve41(projectRoot, value ?? ".absolutejs/mobile/test-artifacts");
-  if (root !== projectRoot && !root.startsWith(`${resolve41(projectRoot)}/`)) {
+  const root = resolve42(projectRoot, value ?? ".absolutejs/mobile/test-artifacts");
+  if (root !== projectRoot && !root.startsWith(`${resolve42(projectRoot)}/`)) {
     throw new TypeError("mobile test --artifacts must remain inside the project.");
   }
   return root;
@@ -19752,10 +20017,10 @@ Emulator setup verification:`);
   });
 }, writeAndroidFailureArtifacts = async (options) => {
   await mkdir14(options.artifactRoot, { recursive: true });
-  const screenshot = options.session ? await options.session.screenshot(join52(options.artifactRoot, "android-failure.png")).catch(() => {
+  const screenshot = options.session ? await options.session.screenshot(join53(options.artifactRoot, "android-failure.png")).catch(() => {
     return;
   }) : undefined;
-  const diagnosticPath = join52(options.artifactRoot, "android-failure.json");
+  const diagnosticPath = join53(options.artifactRoot, "android-failure.json");
   await writeFile16(diagnosticPath, `${JSON.stringify({
     diagnostics: options.session?.diagnostics ?? [],
     error: options.error instanceof Error ? options.error.message : String(options.error),
@@ -19819,7 +20084,7 @@ Emulator setup verification:`);
       console.log(JSON.stringify(report, null, 2));
     else
       printAndroidTestReport(report);
-    const screenshot = reportRoot ? await session.screenshot(join52(artifactRoot, "android-emulator.png")) : undefined;
+    const screenshot = reportRoot ? await session.screenshot(join53(artifactRoot, "android-emulator.png")) : undefined;
     await writeRequestedAndroidReport({
       adb,
       args,
@@ -19887,14 +20152,14 @@ Emulator setup verification:`);
     const port = Number(explicit);
     if (!Number.isInteger(port) || port < 1 || port > 65535)
       throw new TypeError("mobile test --port must be a valid TCP port.");
-    const instance2 = listLiveInstances().find((candidate) => resolve41(candidate.cwd) === resolve41(projectRoot) && candidate.source === "dev" && candidate.port === port);
+    const instance2 = listLiveInstances().find((candidate) => resolve42(candidate.cwd) === resolve42(projectRoot) && candidate.source === "dev" && candidate.port === port);
     return {
       https: instance2?.https ?? args.includes("--https"),
       instance: instance2,
       port
     };
   }
-  const instances = listLiveInstances().filter((instance2) => resolve41(instance2.cwd) === resolve41(projectRoot) && instance2.source === "dev" && instance2.port !== null);
+  const instances = listLiveInstances().filter((instance2) => resolve42(instance2.cwd) === resolve42(projectRoot) && instance2.source === "dev" && instance2.port !== null);
   if (instances.length !== 1)
     throw new TypeError(instances.length === 0 ? "No running AbsoluteJS dev server was found for this project. Start `bun dev`, wait for iOS to report ready, then run `absolute mobile test ios`." : "Multiple dev servers are running for this project. Select one with mobile test ios --port <port>.");
   const [instance] = instances;
@@ -20009,7 +20274,7 @@ Emulator setup verification:`);
   return result;
 }, writeIosFailureArtifacts = async (options) => {
   await mkdir14(options.artifactRoot, { recursive: true });
-  const screenshot = join52(options.artifactRoot, "ios-failure.png");
+  const screenshot = join53(options.artifactRoot, "ios-failure.png");
   const screenshotResult = captureCommand4([
     options.xcrun,
     "simctl",
@@ -20018,7 +20283,7 @@ Emulator setup verification:`);
     "screenshot",
     screenshot
   ]);
-  const diagnosticPath = join52(options.artifactRoot, "ios-failure.json");
+  const diagnosticPath = join53(options.artifactRoot, "ios-failure.json");
   await writeFile16(diagnosticPath, `${JSON.stringify({
     appId: options.appId,
     error: options.error instanceof Error ? options.error.message : String(options.error),
@@ -20044,8 +20309,8 @@ Emulator setup verification:`);
 }, absolutejsVersionForReport = async () => {
   let absolutejsVersion = process.env.ABSOLUTE_VERSION ?? "unknown";
   const versions = await Promise.all([
-    resolve41(import.meta.dir, "..", "..", "package.json"),
-    resolve41(import.meta.dir, "..", "..", "..", "package.json")
+    resolve42(import.meta.dir, "..", "..", "package.json"),
+    resolve42(import.meta.dir, "..", "..", "..", "package.json")
   ].map((candidate) => readPackageVersionForIosReport(candidate).catch(() => "unknown")));
   for (const version2 of versions) {
     if (version2 === "unknown")
@@ -20264,7 +20529,7 @@ Emulator setup verification:`);
     ], "iOS app launch");
     await waitForIosHmrClient({ https, port, timeoutMs });
     await mkdir14(artifactRoot, { recursive: true });
-    const screenshot = join52(artifactRoot, "ios-simulator.png");
+    const screenshot = join53(artifactRoot, "ios-simulator.png");
     requireCapturedCommand([xcrun, "simctl", "io", simulator.udid, "screenshot", screenshot], "iOS simulator screenshot");
     const hmrApply = await waitForRequestedIosHmr(args, instance, timeoutMs);
     const report = {
@@ -20377,6 +20642,10 @@ Emulator setup verification:`);
     await doctor(args.slice(1));
     return;
   }
+  if (command === "inspect") {
+    await inspectMobile(args.slice(1));
+    return;
+  }
   if (command === "test" && args[1] === "android") {
     await testAndroid(args.slice(2));
     return;
@@ -20401,7 +20670,7 @@ Emulator setup verification:`);
     await publishIos(args.slice(2));
     return;
   }
-  throw new TypeError("Usage: absolute mobile <pair mac <name> <user@host> [--port n] [--workspace path] | remotes [--json] | unpair mac <name> | init [--no-native] [--force] | sync [ios|android] | associations [--outdir dir] [--verify] | doctor [ios|android|release] [--remote name] [--json|--fix [--yes]] | build <android|ios> [server-entry] [--outdir dir] [--web-outdir dir] [--unsigned] | publish android [server-entry] [--registry module] [--channel name] [--play-track track] [--play-status completed|draft|halted|in-progress] [--play-rollout fraction] [--play-name name] [--play-notes language=text] [--play-update-priority 0..5] [--play-hold-review] [--play-cancel-existing-review] [--outdir dir] [--web-outdir dir] [--unsigned] | publish ios [server-entry] [--registry module] [--channel name] [--testflight-group name-or-id] [--testflight-notes locale=text] [--testflight-submit-review] [--outdir dir] [--web-outdir dir] [--unsigned] | test android [--route path] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--serial id] [--artifacts dir] [--json] | test ios [--device identifier [--remote name] | --udid id] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--artifacts dir] [--json]> [--config path]");
+  throw new TypeError("Usage: absolute mobile <pair mac <name> <user@host> [--port n] [--workspace path] | remotes [--json] | unpair mac <name> | init [--no-native] [--force] | sync [ios|android] | inspect [--json] | associations [--outdir dir] [--verify] | doctor [ios|android|release] [--remote name] [--json|--fix [--yes]] | build <android|ios> [server-entry] [--outdir dir] [--web-outdir dir] [--unsigned] | publish android [server-entry] [--registry module] [--channel name] [--play-track track] [--play-status completed|draft|halted|in-progress] [--play-rollout fraction] [--play-name name] [--play-notes language=text] [--play-update-priority 0..5] [--play-hold-review] [--play-cancel-existing-review] [--outdir dir] [--web-outdir dir] [--unsigned] | publish ios [server-entry] [--registry module] [--channel name] [--testflight-group name-or-id] [--testflight-notes locale=text] [--testflight-submit-review] [--outdir dir] [--web-outdir dir] [--unsigned] | test android [--route path] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--serial id] [--artifacts dir] [--json] | test ios [--device identifier [--remote name] | --udid id] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--artifacts dir] [--json]> [--config path]");
 };
 var init_mobile = __esm(() => {
   init_dependencies();
@@ -20435,6 +20704,7 @@ var init_mobile = __esm(() => {
   init_nativeAuth();
   init_syncSchema();
   init_deviceCapabilities();
+  init_mobileInspect();
   CAPACITOR_PACKAGES = [
     "@capacitor/core",
     "@capacitor/app",
@@ -20470,10 +20740,10 @@ var exports_typecheck = {};
 __export(exports_typecheck, {
   typecheck: () => typecheck
 });
-import { resolve as resolve42, join as join53 } from "path";
+import { resolve as resolve43, join as join54 } from "path";
 import { existsSync as existsSync42, readFileSync as readFileSync40 } from "fs";
 import { mkdir as mkdir15, writeFile as writeFile17 } from "fs/promises";
-var isCommandService3 = (service) => service.kind === "command" || Array.isArray(service.command), resolveConfigPath = (configPath2) => resolve42(configPath2 ?? process.env.ABSOLUTE_CONFIG ?? "absolute.config.ts"), getTypecheckTargets = async (configPath2) => {
+var isCommandService3 = (service) => service.kind === "command" || Array.isArray(service.command), resolveConfigPath = (configPath2) => resolve43(configPath2 ?? process.env.ABSOLUTE_CONFIG ?? "absolute.config.ts"), getTypecheckTargets = async (configPath2) => {
   if (!existsSync42(resolveConfigPath(configPath2))) {
     const defaultService = {};
     return [defaultService];
@@ -20495,7 +20765,7 @@ var isCommandService3 = (service) => service.kind === "command" || Array.isArray
   const exitCode = await proc.exited;
   return { exitCode, name, output: (stdout + stderr).trim() };
 }, shellEscape = (value) => `'${value.replaceAll("'", "'\\''")}'`, runShell = async (name, command) => run(name, ["/bin/bash", "-lc", command]), findBin = (name) => {
-  const local = resolve42("node_modules", ".bin", name);
+  const local = resolve43("node_modules", ".bin", name);
   return existsSync42(local) ? local : null;
 }, ANSI_COLOR_REGEX, ANSI_PURPLE_REGEX, ANSI_CYAN_REGEX, ANSI_TOKEN_END_REGEX, stripAnsi4 = (str) => str.replace(ANSI_COLOR_REGEX, ""), formatSvelteOutput = (output) => {
   const cwd = `${process.cwd()}/`;
@@ -20543,15 +20813,15 @@ Found ${errorCount} error${suffix}.`;
   return formatted;
 }, ABSOLUTE_INTERNAL_EXCLUDES, resolveAbsoluteTypeFile = (fileName) => {
   const candidates = [
-    resolve42("node_modules/@absolutejs/absolute/dist/types", fileName),
-    resolve42(import.meta.dir, "../types", fileName),
-    resolve42(import.meta.dir, "../../types", fileName),
-    resolve42(import.meta.dir, "../../../types", fileName)
+    resolve43("node_modules/@absolutejs/absolute/dist/types", fileName),
+    resolve43(import.meta.dir, "../types", fileName),
+    resolve43(import.meta.dir, "../../types", fileName),
+    resolve43(import.meta.dir, "../../../types", fileName)
   ];
   return candidates.find((candidate) => existsSync42(candidate)) ?? candidates[0];
 }, ABSOLUTE_TYPECHECK_FILES, readProjectTsconfig = () => {
   try {
-    return JSON.parse(readFileSync40(resolve42("tsconfig.json"), "utf-8"));
+    return JSON.parse(readFileSync40(resolve43("tsconfig.json"), "utf-8"));
   } catch {
     return {};
   }
@@ -20579,27 +20849,27 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m vue-tsc is required for Vue type checking. Install it: bun add -d vue-tsc");
     process.exit(1);
   }
-  const vueTsconfigPath = join53(cacheDir, "tsconfig.vue-check.json");
+  const vueTsconfigPath = join54(cacheDir, "tsconfig.vue-check.json");
   await writeFile17(vueTsconfigPath, JSON.stringify({
     compilerOptions: {
       rootDir: ".."
     },
     exclude: getProjectTypecheckExcludes(),
-    extends: resolve42("tsconfig.json"),
+    extends: resolve43("tsconfig.json"),
     include: getProjectTypecheckIncludes()
   }, null, "\t"));
   const base = [
     vueTscBin,
     "--noEmit",
     "--project",
-    resolve42(vueTsconfigPath),
+    resolve43(vueTsconfigPath),
     "--pretty"
   ];
   const cached = await run("vue-tsc", [
     ...base,
     "--incremental",
     "--tsBuildInfoFile",
-    join53(cacheDir, "vue-tsc.tsbuildinfo")
+    join54(cacheDir, "vue-tsc.tsbuildinfo")
   ]);
   if (cached.exitCode === 0 || cached.output.length > 0)
     return cached;
@@ -20610,7 +20880,7 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m @angular/compiler-cli is required for Angular type checking. Install it: bun add -d @angular/compiler-cli");
     process.exit(1);
   }
-  const angularTsconfigPath = join53(cacheDir, "tsconfig.angular-check.json");
+  const angularTsconfigPath = join54(cacheDir, "tsconfig.angular-check.json");
   await writeFile17(angularTsconfigPath, JSON.stringify({
     angularCompilerOptions: {
       strictTemplates: true
@@ -20620,32 +20890,32 @@ Found ${errorCount} error${suffix}.`;
       rootDir: ".."
     },
     exclude: ABSOLUTE_INTERNAL_EXCLUDES.map(toGeneratedConfigPath),
-    extends: resolve42("tsconfig.json"),
+    extends: resolve43("tsconfig.json"),
     include: [`../${angularDir}/**/*`]
   }, null, "\t"));
-  return runShell("ngc", `${shellEscape(ngcBin)} -p ${shellEscape(resolve42(angularTsconfigPath))}`);
+  return runShell("ngc", `${shellEscape(ngcBin)} -p ${shellEscape(resolve43(angularTsconfigPath))}`);
 }, buildTscCheck = (cacheDir) => {
   const tscBin = findBin("tsc");
   if (!tscBin) {
     console.error("\x1B[31m\u2717\x1B[0m typescript is required for type checking. Install it: bun add -d typescript");
     process.exit(1);
   }
-  const tscConfigPath = join53(cacheDir, "tsconfig.typecheck.json");
+  const tscConfigPath = join54(cacheDir, "tsconfig.typecheck.json");
   return writeFile17(tscConfigPath, JSON.stringify({
     compilerOptions: {
       rootDir: ".."
     },
     exclude: getProjectTypecheckExcludes(),
-    extends: resolve42("tsconfig.json"),
+    extends: resolve43("tsconfig.json"),
     include: getProjectTypecheckIncludes()
   }, null, "\t")).then(() => run("tsc", [
     tscBin,
     "--noEmit",
     "--project",
-    resolve42(tscConfigPath),
+    resolve43(tscConfigPath),
     "--incremental",
     "--tsBuildInfoFile",
-    join53(cacheDir, "tsc.tsbuildinfo"),
+    join54(cacheDir, "tsc.tsbuildinfo"),
     "--pretty"
   ]));
 }, buildSvelteCheck = async (cacheDir, svelteDir) => {
@@ -20654,16 +20924,16 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m svelte-check is required for Svelte type checking. Install it: bun add -d svelte-check");
     process.exit(1);
   }
-  const svelteTsconfigPath = join53(cacheDir, "tsconfig.svelte-check.json");
+  const svelteTsconfigPath = join54(cacheDir, "tsconfig.svelte-check.json");
   await writeFile17(svelteTsconfigPath, JSON.stringify({
-    extends: resolve42("tsconfig.json"),
+    extends: resolve43("tsconfig.json"),
     files: ABSOLUTE_TYPECHECK_FILES,
     include: [`../${svelteDir}/**/*`]
   }, null, "\t"));
   return run("svelte-check", [
     svelteBin,
     "--tsconfig",
-    resolve42(svelteTsconfigPath),
+    resolve43(svelteTsconfigPath),
     "--threshold",
     "error",
     "--compiler-warnings",
@@ -20857,11 +21127,11 @@ var DEFAULT_RELAY_PORT = 8787, DEFAULT_REQUEST_TIMEOUT_MS = 30000, headersToObje
         url: url.pathname + url.search,
         ...bodyBytes && bodyBytes.length > 0 ? { bodyBase64: Buffer.from(bodyBytes).toString("base64") } : {}
       };
-      const responsePromise = new Promise((resolve43) => {
-        pending.set(id, resolve43);
+      const responsePromise = new Promise((resolve44) => {
+        pending.set(id, resolve44);
       });
       client.send(encodeTunnelMessage(message));
-      const timeout = new Promise((resolve43) => setTimeout(() => resolve43({ id, message: "timeout", type: "error" }), requestTimeoutMs));
+      const timeout = new Promise((resolve44) => setTimeout(() => resolve44({ id, message: "timeout", type: "error" }), requestTimeoutMs));
       const result = await Promise.race([responsePromise, timeout]);
       pending.delete(id);
       if (result.type === "error") {
@@ -22472,6 +22742,7 @@ var dev = async (serverEntry, configPath2, options = {}) => {
     const serverEntryBasename = absServerEntry.slice(absServerEntry.lastIndexOf("/") + 1);
     const configBasename = configPath2 ? configPath2.slice(configPath2.lastIndexOf("/") + 1) : "absolute.config.ts";
     const ATOMIC_RECOVERY_WINDOW_MS = 1000;
+    const ATOMIC_RECOVERY_DELAY_MS = 25;
     const recentlyHandled = new Map;
     const handleCandidate = (filename) => {
       if (filename.includes("/") || filename.includes("\\"))
@@ -22515,18 +22786,28 @@ var dev = async (serverEntry, configPath2, options = {}) => {
         handleCandidate(entry.name);
       }
     };
+    let atomicRecoveryTimer;
+    const scheduleAtomicRecovery = () => {
+      if (atomicRecoveryTimer)
+        clearTimeout(atomicRecoveryTimer);
+      atomicRecoveryTimer = setTimeout(() => {
+        atomicRecoveryTimer = undefined;
+        recoveryScan();
+      }, ATOMIC_RECOVERY_DELAY_MS);
+    };
     const watcher = watch3(serverEntryDir, { recursive: false }, (event, filename) => {
       if (!filename)
         return;
       if (isAtomicWriteTemp(filename)) {
-        if (event === "rename") {
-          recoveryScan();
-        }
+        if (event === "rename")
+          scheduleAtomicRecovery();
         return;
       }
       handleCandidate(filename);
     });
     const closeWatcher = () => {
+      if (atomicRecoveryTimer)
+        clearTimeout(atomicRecoveryTimer);
       try {
         watcher.close();
       } catch {}
@@ -24763,7 +25044,7 @@ if (command === "dev") {
   console.error("  prepare [entry] [--outdir dir] Build production assets and server without launching");
   console.error("  start [entry] [--outdir dir] [--prebuilt] Start production server");
   console.error("  compile [entry] [--outdir dir] [--outfile path] Compile standalone executable");
-  console.error("  mobile <init|sync|pair|remotes|doctor|test> Manage Capacitor projects, simulators, physical devices, Remote Macs, guided setup, and deep links");
+  console.error("  mobile <init|sync|inspect|pair|remotes|doctor|test> Manage Capacitor projects, simulators, physical devices, Remote Macs, guided setup, and deep links");
   console.error("  config [--port n] Open the unified config UI (ESLint, tsconfig, Prettier)");
   console.error("  db <backup|restore|seed> Backup/restore any Postgres DB (ORM-agnostic, upsert by PK) or run the seed script");
   console.error("  doctor [--fix] [--json] Diagnose the project (bun, type graph, config, framework dirs, env, port)");

package/dist/dev/serverBootstrap.js

@@ -2,6 +2,32 @@
 // src/dev/serverBootstrap.ts
 import { copyFileSync, existsSync, readdirSync, unlinkSync } from "fs";
 import { dirname, extname, join, resolve } from "path";
+
+// src/dev/serverEntryCopies.ts
+var ENTRY_COPY_OWNER_PATTERN = /^\.absolutejs-hmr-(\d+)-(?:bootstrap-)?\d+\.[^.]+$/;
+var absoluteServerEntryCopyOwnerPid = (name) => {
+  const match = ENTRY_COPY_OWNER_PATTERN.exec(name);
+  if (!match)
+    return null;
+  const pid = Number(match[1]);
+  return Number.isSafeInteger(pid) && pid > 0 ? pid : null;
+};
+var isProcessAlive = (pid) => {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return !(error instanceof Error && ("code" in error) && error.code === "ESRCH");
+  }
+};
+var isStaleAbsoluteServerEntryCopy = (name, currentPid = process.pid, ownerIsAlive = isProcessAlive) => {
+  const ownerPid = absoluteServerEntryCopyOwnerPid(name);
+  if (ownerPid === null)
+    return false;
+  return ownerPid === currentPid || !ownerIsAlive(ownerPid);
+};
+
+// src/dev/serverBootstrap.ts
 var originalEntry = process.env.ABSOLUTE_SERVER_ENTRY;
 if (!originalEntry) {
   throw new Error("ABSOLUTE_SERVER_ENTRY is required by the AbsoluteJS dev bootstrap");
@@ -24,6 +50,8 @@ if (!isHotReevaluation) {
     if (!name.startsWith(copyPrefix) || !name.endsWith(entryExtension)) {
       continue;
     }
+    if (!isStaleAbsoluteServerEntryCopy(name))
+      continue;
     removeEntryCopy(join(entryDir, name));
   }
 }

package/dist/src/dev/serverEntryCopies.d.ts

@@ -0,0 +1,3 @@
+export declare const absoluteServerEntryCopyOwnerPid: (name: string) => number | null;
+export declare const isProcessAlive: (pid: number) => boolean;
+export declare const isStaleAbsoluteServerEntryCopy: (name: string, currentPid?: number, ownerIsAlive?: (pid: number) => boolean) => boolean;

package/dist/src/mobile/mobileInspect.d.ts

@@ -0,0 +1,110 @@
+import type { NormalizedAbsoluteMobileConfig } from './config';
+import { inspectAbsoluteMobileRelease } from './releaseDoctor';
+export declare const ABSOLUTE_MOBILE_INSPECTION_FORMAT: 1;
+type MobilePackageInspection = {
+    declared: string;
+    installed?: string;
+    name: string;
+};
+type MobileBundleInspection = {
+    appBuild?: string;
+    auth?: boolean;
+    capabilities?: string[];
+    entryResolved?: boolean;
+    frameworks?: string[];
+    issue?: string;
+    manifest: string;
+    pageCount?: number;
+    routeCount?: number;
+    runtime?: string;
+    status: 'invalid' | 'missing' | 'valid';
+    sync?: boolean;
+};
+export type AbsoluteMobileProjectInspection = {
+    bundle: MobileBundleInspection;
+    capabilities: {
+        current: string[];
+        embeddedMatchesCurrent?: boolean;
+        issue?: string;
+        plugins: string[];
+    };
+    config: {
+        appId: string;
+        appName: string;
+        bundleDirectory: string;
+        deepLinkHosts: string[];
+        deepLinkScheme?: string;
+        engine: 'capacitor';
+        entry: string;
+        iosVersion?: string;
+        nativeProjectDirectory: string;
+        platforms: string[];
+        productionOrigin: string;
+    };
+    format: typeof ABSOLUTE_MOBILE_INSPECTION_FORMAT;
+    nativeProjects: Array<{
+        initialized: boolean;
+        path: string;
+        platform: string;
+    }>;
+    packages: MobilePackageInspection[];
+    release: {
+        checks: Array<{
+            id: string;
+            status: 'fail' | 'pass' | 'warn';
+        }>;
+        ready: boolean;
+    };
+    runtime: {
+        absolutejs: string;
+    };
+};
+export type InspectAbsoluteMobileProjectOptions = {
+    absolutejsVersion?: string;
+    inspectRelease?: typeof inspectAbsoluteMobileRelease;
+};
+export declare const inspectAbsoluteMobileProject: (config: NormalizedAbsoluteMobileConfig, projectRoot: string, options?: InspectAbsoluteMobileProjectOptions) => Promise<{
+    bundle: MobileBundleInspection;
+    capabilities: {
+        plugins: string[];
+        issue?: string | undefined;
+        embeddedMatchesCurrent?: boolean | undefined;
+        current: string[];
+    };
+    config: {
+        appId: string;
+        appName: string;
+        bundleDirectory: string;
+        deepLinkHosts: string[];
+        deepLinkScheme: string | undefined;
+        engine: "capacitor";
+        entry: string;
+        iosVersion: string | undefined;
+        nativeProjectDirectory: string;
+        platforms: import("..").MobilePlatform[];
+        productionOrigin: string;
+    };
+    format: 1;
+    nativeProjects: {
+        initialized: boolean;
+        path: string;
+        platform: import("..").MobilePlatform;
+    }[];
+    packages: {
+        name: string;
+        installed?: string | undefined;
+        declared: string;
+    }[];
+    release: {
+        checks: {
+            id: string;
+            status: "pass" | "fail";
+        }[];
+        ready: boolean;
+    };
+    runtime: {
+        absolutejs: string;
+    };
+}>;
+export declare const renderAbsoluteMobileProjectInspection: (report: AbsoluteMobileProjectInspection) => string;
+export {};

package/package.json

@@ -506,7 +506,7 @@
 			]
 		}
 	},
-	"version": "0.20.0-beta.36",
+	"version": "0.20.0-beta.37",
 	"workspaces": [
 		"tests/fixtures/*",
 		"tests/fixtures/_packages/*"