crumbtrail 0.1.0 → 0.2.0

package/dist/cli.d.cts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { R as Recipe, D as DetectResult, P as PackageManager, b as buildPlan, e as executePlan } from './executor-DKDrkhxM.cjs';
-import { Stack } from 'crumbtrail-design-system';
+import { R as Recipe, D as DetectResult, P as PackageManager, b as buildPlan, e as executePlan } from './executor-CW6Q5mhH.cjs';
+import { Stack } from 'crumbtrail-core';
 
 /** Output sink — swappable in tests to capture lines instead of writing stdout. */
 interface Ui {
@@ -56,6 +56,14 @@ interface LoginOptions {
     pollIntervalMs?: number;
     /** Browser hand-off deadline in ms (default 5 min); overridable in tests. */
     browserDeadlineMs?: number;
+    /**
+     * False in a non-TTY shell: refuse to START an interactive login (browser
+     * hand-off / device code) that would block on input nobody can give, and throw
+     * an actionable error instead of hanging. Undefined/true keeps the interactive
+     * flow (default) so a normal terminal is unaffected. A valid CRUMBTRAIL_TOKEN or
+     * a cached token is honored regardless of this flag.
+     */
+    allowInteractiveLogin?: boolean;
 }
 /**
  * Resolve a usable CLI token for `base`: reuse a stored token (validated by a
@@ -260,6 +268,12 @@ interface ParsedArgs {
     only?: string[];
     /** Monorepo root only: select every wireable service, no prompt. */
     all: boolean;
+    /**
+     * Target a specific package directory instead of the detected repo root. In a
+     * monorepo this bypasses the batch scan and wires exactly this one package
+     * (resolved relative to cwd; must exist and hold a package.json).
+     */
+    workspace?: string;
     /** Non-flag/subcommand leftover — an unknown token triggers usage help. */
     unknown?: string;
 }
@@ -315,6 +329,24 @@ interface WizardDeps {
     fetchImpl?: typeof fetch;
 }
 declare function defaultDeps(): WizardDeps;
+/** Filesystem probes for --workspace validation; injectable so the resolver is
+ *  unit-testable without touching real directories. */
+interface WorkspaceIO {
+    isDir: (p: string) => boolean;
+    isFile: (p: string) => boolean;
+}
+/**
+ * Resolve `--workspace <dir>` to an absolute package directory. The dir is taken
+ * relative to the wizard's cwd, must exist, and must hold a package.json (the
+ * workspace-package manifest) — otherwise detect() would run against nothing
+ * useful, so we refuse with a concrete message rather than proceed. Pure aside
+ * from the injected probes.
+ */
+declare function resolveWorkspaceDir(baseCwd: string, workspace: string, io?: WorkspaceIO): {
+    dir: string;
+} | {
+    error: string;
+};
 declare function runWizard(parsed: ParsedArgs, deps: WizardDeps): Promise<number>;
 type ServiceStatus = "wired" | "guidance" | "skipped-already-wired" | "failed";
 interface ServiceOutcome {
@@ -355,4 +387,4 @@ declare function runBatchWizard(parsed: ParsedArgs, deps: WizardDeps, ctx: Batch
 declare function runCli(argv: string[], deps?: WizardDeps): Promise<number>;
 declare function isCliEntrypoint(argv1: string | undefined): boolean;
 
-export { type Command, type InstallSdkInput, type InstallSdkResult, type ParsedArgs, type ServiceOutcome, type ServiceStatus, type WizardDeps, defaultDeps, installSdk, isCliEntrypoint, parseArgs, resolveSelection, runBatchWizard, runCli, runWizard };
+export { type Command, type InstallSdkInput, type InstallSdkResult, type ParsedArgs, type ServiceOutcome, type ServiceStatus, type WizardDeps, type WorkspaceIO, defaultDeps, installSdk, isCliEntrypoint, parseArgs, resolveSelection, resolveWorkspaceDir, runBatchWizard, runCli, runWizard };

package/dist/cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { R as Recipe, D as DetectResult, P as PackageManager, b as buildPlan, e as executePlan } from './executor-DKDrkhxM.js';
-import { Stack } from 'crumbtrail-design-system';
+import { R as Recipe, D as DetectResult, P as PackageManager, b as buildPlan, e as executePlan } from './executor-CW6Q5mhH.js';
+import { Stack } from 'crumbtrail-core';
 
 /** Output sink — swappable in tests to capture lines instead of writing stdout. */
 interface Ui {
@@ -56,6 +56,14 @@ interface LoginOptions {
     pollIntervalMs?: number;
     /** Browser hand-off deadline in ms (default 5 min); overridable in tests. */
     browserDeadlineMs?: number;
+    /**
+     * False in a non-TTY shell: refuse to START an interactive login (browser
+     * hand-off / device code) that would block on input nobody can give, and throw
+     * an actionable error instead of hanging. Undefined/true keeps the interactive
+     * flow (default) so a normal terminal is unaffected. A valid CRUMBTRAIL_TOKEN or
+     * a cached token is honored regardless of this flag.
+     */
+    allowInteractiveLogin?: boolean;
 }
 /**
  * Resolve a usable CLI token for `base`: reuse a stored token (validated by a
@@ -260,6 +268,12 @@ interface ParsedArgs {
     only?: string[];
     /** Monorepo root only: select every wireable service, no prompt. */
     all: boolean;
+    /**
+     * Target a specific package directory instead of the detected repo root. In a
+     * monorepo this bypasses the batch scan and wires exactly this one package
+     * (resolved relative to cwd; must exist and hold a package.json).
+     */
+    workspace?: string;
     /** Non-flag/subcommand leftover — an unknown token triggers usage help. */
     unknown?: string;
 }
@@ -315,6 +329,24 @@ interface WizardDeps {
     fetchImpl?: typeof fetch;
 }
 declare function defaultDeps(): WizardDeps;
+/** Filesystem probes for --workspace validation; injectable so the resolver is
+ *  unit-testable without touching real directories. */
+interface WorkspaceIO {
+    isDir: (p: string) => boolean;
+    isFile: (p: string) => boolean;
+}
+/**
+ * Resolve `--workspace <dir>` to an absolute package directory. The dir is taken
+ * relative to the wizard's cwd, must exist, and must hold a package.json (the
+ * workspace-package manifest) — otherwise detect() would run against nothing
+ * useful, so we refuse with a concrete message rather than proceed. Pure aside
+ * from the injected probes.
+ */
+declare function resolveWorkspaceDir(baseCwd: string, workspace: string, io?: WorkspaceIO): {
+    dir: string;
+} | {
+    error: string;
+};
 declare function runWizard(parsed: ParsedArgs, deps: WizardDeps): Promise<number>;
 type ServiceStatus = "wired" | "guidance" | "skipped-already-wired" | "failed";
 interface ServiceOutcome {
@@ -355,4 +387,4 @@ declare function runBatchWizard(parsed: ParsedArgs, deps: WizardDeps, ctx: Batch
 declare function runCli(argv: string[], deps?: WizardDeps): Promise<number>;
 declare function isCliEntrypoint(argv1: string | undefined): boolean;
 
-export { type Command, type InstallSdkInput, type InstallSdkResult, type ParsedArgs, type ServiceOutcome, type ServiceStatus, type WizardDeps, defaultDeps, installSdk, isCliEntrypoint, parseArgs, resolveSelection, runBatchWizard, runCli, runWizard };
+export { type Command, type InstallSdkInput, type InstallSdkResult, type ParsedArgs, type ServiceOutcome, type ServiceStatus, type WizardDeps, type WorkspaceIO, defaultDeps, installSdk, isCliEntrypoint, parseArgs, resolveSelection, resolveWorkspaceDir, runBatchWizard, runCli, runWizard };

package/dist/cli.js

@@ -7,10 +7,10 @@ import {
   detect,
   executePlan,
   projectAlreadyWired
-} from "./chunk-UFJ2BODB.js";
+} from "./chunk-MZDASWQ7.js";
 
 // src/cli.ts
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync2, statSync } from "fs";
 import path4 from "path";
 import { spawnSync } from "child_process";
 
@@ -30,7 +30,7 @@ import os from "os";
 import path from "path";
 
 // src/net.ts
-var DEFAULT_ENDPOINT = "https://crumbtrail-cloud-production.up.railway.app";
+var DEFAULT_ENDPOINT = "https://app.crumbtrail.dev";
 function normalizeBase(base) {
   return base.replace(/\/+$/, "");
 }
@@ -485,6 +485,7 @@ async function validateToken(base, token, fetchImpl) {
     throw err;
   }
 }
+var TOKEN_ENV_VAR = "CRUMBTRAIL_TOKEN";
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 async function loginBrowser(opts) {
   const { verifier, challenge } = pkcePair();
@@ -581,6 +582,17 @@ async function login(opts) {
 }
 async function ensureToken(opts) {
   const env = opts.env ?? process.env;
+  const envToken = env[TOKEN_ENV_VAR]?.trim();
+  if (envToken) {
+    const state = await validateToken(opts.base, envToken, opts.fetchImpl);
+    if (state === "valid") {
+      opts.ui.out(color.dim(`Using ${TOKEN_ENV_VAR} from the environment.`));
+      return envToken;
+    }
+    throw new Error(
+      `${TOKEN_ENV_VAR} was set but ${opts.base} rejected it (401). Check the token value (create one in the dashboard), or point at the right deployment with --endpoint <url>.`
+    );
+  }
   const stored = loadAuth(env);
   if (stored && stored.token && stored.endpoint === opts.base) {
     const state = await validateToken(opts.base, stored.token, opts.fetchImpl);
@@ -591,6 +603,11 @@ async function ensureToken(opts) {
     clearAuth(env);
     opts.ui.out(color.dim("Saved login expired \u2014 signing in again."));
   }
+  if (opts.allowInteractiveLogin === false) {
+    throw new Error(
+      `No Crumbtrail login available and this shell isn't interactive. Set ${TOKEN_ENV_VAR}=<your CLI token> (create one in the dashboard) to run in CI, or run the wizard in an interactive terminal. Add --endpoint <url> if you point at a self-hosted Crumbtrail.`
+    );
+  }
   const minted = await login(opts);
   saveAuth(
     { token: minted.token, expiresAt: minted.expiresAt, endpoint: opts.base },
@@ -802,13 +819,17 @@ var CLI_CHECK_PREFIX = "cli-check-";
 function syntheticSessionId() {
   return `${CLI_CHECK_PREFIX}${randomBytes2(8).toString("hex")}`;
 }
-function firstRealSession(sessions, wizardStart) {
-  return sessions.find((s) => {
-    if (s.id.startsWith(CLI_CHECK_PREFIX)) return false;
-    if (wizardStart == null) return true;
-    const started = s.startedAt ? Date.parse(s.startedAt) : NaN;
-    return Number.isFinite(started) && started >= wizardStart;
-  });
+var POLL_SKEW_TOLERANCE_MS = 2 * 60 * 1e3;
+function isRealNewSession(s, wizardStart, guard) {
+  if (s.id.startsWith(CLI_CHECK_PREFIX)) return false;
+  if (guard?.baselineIds) return !guard.baselineIds.has(s.id);
+  if (wizardStart == null) return true;
+  const started = s.startedAt ? Date.parse(s.startedAt) : NaN;
+  const tolerance = Math.max(0, guard?.skewToleranceMs ?? 0);
+  return Number.isFinite(started) && started >= wizardStart - tolerance;
+}
+function firstRealSession(sessions, wizardStart, guard) {
+  return sessions.find((s) => isRealNewSession(s, wizardStart, guard));
 }
 async function syntheticCheck(base, apiKey, fetchImpl) {
   const sessionId = syntheticSessionId();
@@ -870,6 +891,26 @@ async function pollForRealEvent(opts) {
       color.dim("Waiting for the first real event\u2026 (Ctrl-C to skip)")
     );
   }
+  if (opts.signal?.aborted) {
+    opts.ui.status?.();
+    return { outcome: "cancelled" };
+  }
+  let baselineIds;
+  try {
+    const existing = await fetchSessions(
+      opts.base,
+      opts.token,
+      opts.projectId,
+      opts.fetchImpl
+    );
+    baselineIds = new Set(existing.map((s) => s.id));
+  } catch {
+    baselineIds = void 0;
+  }
+  const guard = {
+    baselineIds,
+    skewToleranceMs: POLL_SKEW_TOLERANCE_MS
+  };
   let state = initialIngestPollState();
   let sessionId;
   while (state.status === "waiting") {
@@ -892,7 +933,7 @@ async function pollForRealEvent(opts) {
         opts.projectId,
         opts.fetchImpl
       );
-      const real = firstRealSession(sessions, opts.wizardStart);
+      const real = firstRealSession(sessions, opts.wizardStart, guard);
       found = real !== void 0;
       if (real) sessionId = real.id;
     } catch {
@@ -903,15 +944,11 @@ async function pollForRealEvent(opts) {
   opts.ui.status?.();
   return state.status === "found" ? { outcome: "found", sessionId } : { outcome: "timedout" };
 }
-function realSessionsByService(sessions, wizardStart) {
+function realSessionsByService(sessions, wizardStart, guard) {
   const found = /* @__PURE__ */ new Map();
   for (const s of [...sessions].reverse()) {
     if (!s.serviceId || found.has(s.serviceId)) continue;
-    if (s.id.startsWith(CLI_CHECK_PREFIX)) continue;
-    if (wizardStart != null) {
-      const started = s.startedAt ? Date.parse(s.startedAt) : NaN;
-      if (!Number.isFinite(started) || started < wizardStart) continue;
-    }
+    if (!isRealNewSession(s, wizardStart, guard)) continue;
     found.set(s.serviceId, s.id);
   }
   return found;
@@ -1187,6 +1224,9 @@ function parseArgs(argv) {
       case "--only":
         (parsed.only ??= []).push(args[++i]);
         break;
+      case "--workspace":
+        parsed.workspace = args[++i];
+        break;
       default:
         if (a.startsWith("--project=")) {
           parsed.project = a.slice("--project=".length);
@@ -1194,6 +1234,8 @@ function parseArgs(argv) {
           parsed.endpoint = a.slice("--endpoint=".length);
         } else if (a.startsWith("--only=")) {
           (parsed.only ??= []).push(a.slice("--only=".length));
+        } else if (a.startsWith("--workspace=")) {
+          parsed.workspace = a.slice("--workspace=".length);
         } else if (!commandSet && (a === "login" || a === "logout")) {
           parsed.command = a;
           commandSet = true;
@@ -1221,6 +1263,8 @@ Options:
   --project <id>             Attach to an existing project (skip creation)
   --only <name>              Monorepo: wire only this service (repeatable)
   --all                      Monorepo: wire every service it can, no prompt
+  --workspace <dir>          Target one package dir (relative to cwd) instead of
+                             the repo root \u2014 wires just that package
   --no-browser               Use the device-code login flow
   --skip-verify              Don't wait for the first event
   --endpoint <url>           Cloud endpoint (else $CRUMBTRAIL_BASE_URL, else default)
@@ -1344,6 +1388,34 @@ function readPkgName(dir) {
     return null;
   }
 }
+var defaultWorkspaceIO = {
+  isDir: (p) => {
+    try {
+      return statSync(p).isDirectory();
+    } catch {
+      return false;
+    }
+  },
+  isFile: (p) => {
+    try {
+      return statSync(p).isFile();
+    } catch {
+      return false;
+    }
+  }
+};
+function resolveWorkspaceDir(baseCwd, workspace, io = defaultWorkspaceIO) {
+  const dir = path4.resolve(baseCwd, workspace);
+  if (!io.isDir(dir)) {
+    return { error: `--workspace ${workspace}: no such directory (${dir}).` };
+  }
+  if (!io.isFile(path4.join(dir, "package.json"))) {
+    return {
+      error: `--workspace ${workspace}: ${dir} has no package.json \u2014 point it at a package directory.`
+    };
+  }
+  return { dir };
+}
 async function runWizard(parsed, deps) {
   const { ui } = deps;
   const base = resolveEndpoint(parsed.endpoint, deps.env);
@@ -1351,7 +1423,18 @@ async function runWizard(parsed, deps) {
   ui.out(color.bold("\nCrumbtrail setup"));
   ui.out(color.dim(`Endpoint: ${base}
 `));
-  const cwd = deps.cwd;
+  let cwd = deps.cwd;
+  if (parsed.workspace) {
+    const resolved = resolveWorkspaceDir(deps.cwd, parsed.workspace);
+    if ("error" in resolved) {
+      ui.err(color.red(resolved.error));
+      return 1;
+    }
+    cwd = resolved.dir;
+    ui.out(
+      color.dim(`Targeting workspace: ${path4.relative(deps.cwd, cwd) || cwd}`)
+    );
+  }
   const result = deps.detect(cwd);
   if (result.isMonorepo) {
     return runBatchWizard(parsed, deps, { base, wizardStart, root: result });
@@ -1385,7 +1468,8 @@ async function runWizard(parsed, deps) {
       ui,
       noBrowser: parsed.noBrowser,
       fetchImpl: deps.fetchImpl,
-      env: deps.env
+      env: deps.env,
+      allowInteractiveLogin: deps.isTTY
     });
   } catch (err) {
     ui.err(color.red(`Login failed: ${errMessage(err)}`));
@@ -1442,7 +1526,10 @@ async function runWizard(parsed, deps) {
   } else if (install.note) {
     ui.out(color.yellow(`! ${install.note}`));
   }
-  const inject = await applyInjection(plan, parsed, deps);
+  const inject = await applyInjection(plan, parsed, deps, {
+    installed: install.installed,
+    packages: install.packages
+  });
   const notes = [];
   if (!install.installed && install.note) notes.push(install.note);
   notes.push(...inject.notes);
@@ -1485,10 +1572,27 @@ async function runWizard(parsed, deps) {
     } else {
       notes.push("No event yet \u2014 start your app and check the dashboard.");
     }
+    printEvidenceSourcesPointer(ui, base);
   }
   printSummary(ui, base, provisioned, inject.filesTouched, notes, sessionUrl);
   return 0;
 }
+function printEvidenceSourcesPointer(ui, base) {
+  ui.out("");
+  ui.out(color.bold("Next: make each ticket's evidence more complete."));
+  ui.out(
+    color.dim(
+      "Crumbtrail's SDK stands alone, but it can also fold in evidence from tools"
+    )
+  );
+  ui.out(
+    color.dim(
+      "you already run \u2014 Sentry, CloudWatch, Splunk, Datadog, PostHog, Cloudflare \u2014"
+    )
+  );
+  ui.out(color.dim("queried at incident time and added to each bug's bundle."));
+  ui.out(`  Evidence sources: ${color.cyan(`${base}/settings`)}`);
+}
 function stackLabel(c) {
   if (c.recipe == null) return "\u2014";
   if (c.recipe === "otlp") return c.detected.otlpStack ?? "otlp";
@@ -1600,7 +1704,8 @@ async function runBatchWizard(parsed, deps, ctx) {
       ui,
       noBrowser: parsed.noBrowser,
       fetchImpl: deps.fetchImpl,
-      env: deps.env
+      env: deps.env,
+      allowInteractiveLogin: deps.isTTY
     });
   } catch (err) {
     ui.err(color.red(`Login failed: ${errMessage(err)}`));
@@ -1695,7 +1800,11 @@ async function runBatchWizard(parsed, deps, ctx) {
       const applied = await applyBatchInjection(plan, c, svc.serviceName, {
         parsed,
         deps,
-        base
+        base,
+        sdkInstall: {
+          installed: install.installed,
+          packages: install.packages
+        }
       });
       outcomes.push({
         name: svc.serviceName,
@@ -1770,6 +1879,9 @@ async function runBatchWizard(parsed, deps, ctx) {
       }
     }
   }
+  if (!parsed.skipVerify && reporting.length > 0) {
+    printEvidenceSourcesPointer(ui, base);
+  }
   printBatchSummary(ui, base, root, project.name, outcomes, batchNotes);
   const attempted = outcomes.filter(
     (o) => o.status !== "skipped-already-wired"
@@ -1800,7 +1912,7 @@ async function applyBatchInjection(plan, candidate, serviceName, ctx) {
       notes: ["add the OTLP exporter from the guide file to start reporting."]
     };
   }
-  const applied = await applyInjection(plan, parsed, deps);
+  const applied = await applyInjection(plan, parsed, deps, ctx.sdkInstall);
   const status = plan.kind === "fallback-ai" ? "guidance" : applied.filesTouched.length > 0 ? "wired" : "skipped-already-wired";
   return { status, filesTouched: applied.filesTouched, notes: applied.notes };
 }
@@ -1844,7 +1956,7 @@ function printBatchSummary(ui, base, root, projectName, outcomes, batchNotes = [
     for (const n of notes) ui.out(color.dim(`  note: ${n}`));
   }
 }
-async function applyInjection(plan, parsed, deps) {
+async function applyInjection(plan, parsed, deps, sdkInstall) {
   const { ui } = deps;
   const filesTouched = [];
   const notes = [];
@@ -1891,7 +2003,16 @@ async function applyInjection(plan, parsed, deps) {
         color.yellow("Left your file untouched. Add this to the top yourself:")
       );
       if (plan.content) ui.out(plan.content);
-      notes.push(`Skipped editing ${plan.targetPath} (dirty). Apply manually.`);
+      notes.push(
+        `Skipped editing ${plan.targetPath} (uncommitted changes) \u2014 paste the snippet above into it manually.`
+      );
+      if (sdkInstall?.installed && sdkInstall.packages.length > 0) {
+        const pkgs = sdkInstall.packages.join(", ");
+        const were = sdkInstall.packages.length > 1 ? "were" : "was";
+        notes.push(
+          `${pkgs} ${were} already installed, so your package.json is already updated \u2014 only the code import above is still manual.`
+        );
+      }
       return { filesTouched, notes };
     }
     const res2 = deps.executePlan(plan, void 0, { confirmDirty: true });
@@ -1980,7 +2101,8 @@ async function runLogin(parsed, deps) {
       ui: deps.ui,
       noBrowser: parsed.noBrowser,
       fetchImpl: deps.fetchImpl,
-      env: deps.env
+      env: deps.env,
+      allowInteractiveLogin: deps.isTTY
     });
     return 0;
   } catch (err) {
@@ -2042,6 +2164,7 @@ export {
   isCliEntrypoint,
   parseArgs,
   resolveSelection,
+  resolveWorkspaceDir,
   runBatchWizard,
   runCli,
   runWizard

package/dist/{executor-DKDrkhxM.d.cts → executor-CW6Q5mhH.d.cts}

@@ -1,4 +1,4 @@
-import { Stack } from 'crumbtrail-design-system';
+import { Stack } from 'crumbtrail-core';
 
 /** Injection recipes, ordered most-specific-first during detection. */
 type Recipe = "tauri" | "next" | "sveltekit" | "nuxt" | "remix" | "astro" | "angular" | "vite-spa" | "nestjs" | "express" | "hono" | "fastify" | "react-native" | "node" | "otlp";
@@ -69,10 +69,15 @@ declare function resolveViteEntry(cwd: string): string | null;
 /**
  * Resolve the React Native / Expo injection entry. Prefers, in order:
  *   1. `app/_layout.{tsx,jsx,js}` — the expo-router root layout,
- *   2. `App.{tsx,jsx,ts,js}` — the classic Expo / bare-RN root component,
- *   3. `index.{js,ts}` — the bare-RN `AppRegistry` entry.
- * First existing file wins. Returns null when none exist (→ ambiguous), so the
- * resolver never points at an `expo/AppEntry` path inside node_modules.
+ *   2. `src/app/_layout.{tsx,jsx,js}` — the same root layout under a `src/` dir,
+ *      which is where create-expo-app's current DEFAULT template puts it,
+ *   3. `App.{tsx,jsx,ts,js}` — the classic Expo / bare-RN root component,
+ *   4. `index.{js,ts}` — the bare-RN `AppRegistry` entry.
+ * First existing file wins. The root `app/` layout keeps precedence over the
+ * `src/app/` one so existing projects resolve exactly as before; `src/app/` is a
+ * new fallback checked ahead of `App.*`. Returns null when none exist
+ * (→ ambiguous), so the resolver never points at an `expo/AppEntry` path inside
+ * node_modules.
  */
 declare function resolveReactNativeEntry(cwd: string): string | null;
 /** Pull a node script/module path out of a `start`-style command. */

package/dist/{executor-DKDrkhxM.d.ts → executor-CW6Q5mhH.d.ts}

@@ -1,4 +1,4 @@
-import { Stack } from 'crumbtrail-design-system';
+import { Stack } from 'crumbtrail-core';
 
 /** Injection recipes, ordered most-specific-first during detection. */
 type Recipe = "tauri" | "next" | "sveltekit" | "nuxt" | "remix" | "astro" | "angular" | "vite-spa" | "nestjs" | "express" | "hono" | "fastify" | "react-native" | "node" | "otlp";
@@ -69,10 +69,15 @@ declare function resolveViteEntry(cwd: string): string | null;
 /**
  * Resolve the React Native / Expo injection entry. Prefers, in order:
  *   1. `app/_layout.{tsx,jsx,js}` — the expo-router root layout,
- *   2. `App.{tsx,jsx,ts,js}` — the classic Expo / bare-RN root component,
- *   3. `index.{js,ts}` — the bare-RN `AppRegistry` entry.
- * First existing file wins. Returns null when none exist (→ ambiguous), so the
- * resolver never points at an `expo/AppEntry` path inside node_modules.
+ *   2. `src/app/_layout.{tsx,jsx,js}` — the same root layout under a `src/` dir,
+ *      which is where create-expo-app's current DEFAULT template puts it,
+ *   3. `App.{tsx,jsx,ts,js}` — the classic Expo / bare-RN root component,
+ *   4. `index.{js,ts}` — the bare-RN `AppRegistry` entry.
+ * First existing file wins. The root `app/` layout keeps precedence over the
+ * `src/app/` one so existing projects resolve exactly as before; `src/app/` is a
+ * new fallback checked ahead of `App.*`. Returns null when none exist
+ * (→ ambiguous), so the resolver never points at an `expo/AppEntry` path inside
+ * node_modules.
  */
 declare function resolveReactNativeEntry(cwd: string): string | null;
 /** Pull a node script/module path out of a `start`-style command. */