crumbtrail 0.1.0 → 0.1.1

package/dist/{chunk-UFJ2BODB.js → chunk-HAP4DPWC.js}

@@ -2333,6 +2333,9 @@ function resolveReactNativeEntry(cwd) {
     path.join("app", "_layout.tsx"),
     path.join("app", "_layout.jsx"),
     path.join("app", "_layout.js"),
+    path.join("src", "app", "_layout.tsx"),
+    path.join("src", "app", "_layout.jsx"),
+    path.join("src", "app", "_layout.js"),
     "App.tsx",
     "App.jsx",
     "App.ts",
@@ -2812,6 +2815,20 @@ function nodeInitSnippet(endpoint) {
     "  .catch(() => {});"
   ].join("\n");
 }
+function singleQuoted(value) {
+  return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+}
+function nestInitSnippet(endpoint) {
+  return [
+    "// Crumbtrail \u2014 auto-captures uncaught exceptions, unhandled rejections, and",
+    "// console.error. Key is read from process.env.CRUMBTRAIL_KEY, which autoCapture",
+    "// loads from your .env (written by the CLI). Express apps can also add",
+    "// createCrumbtrailExpressMiddleware for per-request capture.",
+    "import('crumbtrail-node')",
+    `  .then(({ autoCapture }) => autoCapture({ endpoint: ${singleQuoted(endpoint)} }))`,
+    "  .catch(() => {});"
+  ].join("\n");
+}
 function reactNativeInitSnippet(endpoint, apiKey) {
   return [
     'import { createReactNativeCrumbtrail } from "crumbtrail-react-native";',
@@ -2843,10 +2860,14 @@ import path2 from "path";
 function realGitStatus(cwd, target) {
   let out;
   try {
+    const env = Object.fromEntries(
+      Object.entries(process.env).filter(([key]) => !key.startsWith("GIT_"))
+    );
     out = execFileSync("git", ["status", "--porcelain", "--", target], {
       cwd,
       encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"]
+      stdio: ["ignore", "pipe", "ignore"],
+      env
     });
   } catch {
     return { isRepo: false, tracked: false, dirty: false };
@@ -7027,7 +7048,7 @@ function planVite(input, io) {
   return prependWithPreflight(input, io, input.entryFile, block);
 }
 function planNode(input, io) {
-  const block = nodeInitSnippet(input.endpoint);
+  const block = input.recipe === "nestjs" ? nestInitSnippet(input.endpoint) : nodeInitSnippet(input.endpoint);
   const { action, warning } = buildEnvAction(input.cwd, input.apiKey, io);
   const envWarnings = warning ? [warning] : [];
   if (!input.entryFile) {
@@ -7320,6 +7341,7 @@ export {
   clientInitSnippet,
   nuxtPluginSnippet,
   nodeInitSnippet,
+  nestInitSnippet,
   reactNativeInitSnippet,
   tauriInitSnippet,
   envKeyLine,

package/dist/cli.cjs

@@ -2182,6 +2182,7 @@ __export(cli_exports, {
   isCliEntrypoint: () => isCliEntrypoint,
   parseArgs: () => parseArgs,
   resolveSelection: () => resolveSelection,
+  resolveWorkspaceDir: () => resolveWorkspaceDir,
   runBatchWizard: () => runBatchWizard,
   runCli: () => runCli,
   runWizard: () => runWizard
@@ -2357,6 +2358,9 @@ function resolveReactNativeEntry(cwd) {
     import_node_path.default.join("app", "_layout.tsx"),
     import_node_path.default.join("app", "_layout.jsx"),
     import_node_path.default.join("app", "_layout.js"),
+    import_node_path.default.join("src", "app", "_layout.tsx"),
+    import_node_path.default.join("src", "app", "_layout.jsx"),
+    import_node_path.default.join("src", "app", "_layout.js"),
     "App.tsx",
     "App.jsx",
     "App.ts",
@@ -2836,6 +2840,20 @@ function nodeInitSnippet(endpoint) {
     "  .catch(() => {});"
   ].join("\n");
 }
+function singleQuoted(value) {
+  return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+}
+function nestInitSnippet(endpoint) {
+  return [
+    "// Crumbtrail \u2014 auto-captures uncaught exceptions, unhandled rejections, and",
+    "// console.error. Key is read from process.env.CRUMBTRAIL_KEY, which autoCapture",
+    "// loads from your .env (written by the CLI). Express apps can also add",
+    "// createCrumbtrailExpressMiddleware for per-request capture.",
+    "import('crumbtrail-node')",
+    `  .then(({ autoCapture }) => autoCapture({ endpoint: ${singleQuoted(endpoint)} }))`,
+    "  .catch(() => {});"
+  ].join("\n");
+}
 function reactNativeInitSnippet(endpoint, apiKey) {
   return [
     'import { createReactNativeCrumbtrail } from "crumbtrail-react-native";',
@@ -2867,10 +2885,14 @@ var import_node_path2 = __toESM(require("path"), 1);
 function realGitStatus(cwd, target) {
   let out;
   try {
+    const env = Object.fromEntries(
+      Object.entries(process.env).filter(([key]) => !key.startsWith("GIT_"))
+    );
     out = (0, import_node_child_process.execFileSync)("git", ["status", "--porcelain", "--", target], {
       cwd,
       encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"]
+      stdio: ["ignore", "pipe", "ignore"],
+      env
     });
   } catch {
     return { isRepo: false, tracked: false, dirty: false };
@@ -7051,7 +7073,7 @@ function planVite(input, io) {
   return prependWithPreflight(input, io, input.entryFile, block);
 }
 function planNode(input, io) {
-  const block = nodeInitSnippet(input.endpoint);
+  const block = input.recipe === "nestjs" ? nestInitSnippet(input.endpoint) : nodeInitSnippet(input.endpoint);
   const { action, warning } = buildEnvAction(input.cwd, input.apiKey, io);
   const envWarnings = warning ? [warning] : [];
   if (!input.entryFile) {
@@ -7325,7 +7347,7 @@ var import_node_os = __toESM(require("os"), 1);
 var import_node_path5 = __toESM(require("path"), 1);
 
 // src/net.ts
-var DEFAULT_ENDPOINT = "https://crumbtrail-cloud-production.up.railway.app";
+var DEFAULT_ENDPOINT = "https://app.crumbtrail.dev";
 function normalizeBase(base2) {
   return base2.replace(/\/+$/, "");
 }
@@ -7780,6 +7802,7 @@ async function validateToken(base2, token, fetchImpl) {
     throw err;
   }
 }
+var TOKEN_ENV_VAR = "CRUMBTRAIL_TOKEN";
 var sleep = (ms) => new Promise((r2) => setTimeout(r2, ms));
 async function loginBrowser(opts) {
   const { verifier, challenge } = pkcePair();
@@ -7876,6 +7899,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);
@@ -7886,6 +7920,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 },
@@ -8097,13 +8136,17 @@ var CLI_CHECK_PREFIX = "cli-check-";
 function syntheticSessionId() {
   return `${CLI_CHECK_PREFIX}${(0, import_node_crypto2.randomBytes)(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(base2, apiKey, fetchImpl) {
   const sessionId = syntheticSessionId();
@@ -8165,6 +8208,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") {
@@ -8187,7 +8250,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 {
@@ -8198,15 +8261,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;
@@ -8482,6 +8541,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);
@@ -8489,6 +8551,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;
@@ -8516,6 +8580,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)
@@ -8639,6 +8705,34 @@ function readPkgName(dir) {
     return null;
   }
 }
+var defaultWorkspaceIO = {
+  isDir: (p) => {
+    try {
+      return (0, import_node_fs6.statSync)(p).isDirectory();
+    } catch {
+      return false;
+    }
+  },
+  isFile: (p) => {
+    try {
+      return (0, import_node_fs6.statSync)(p).isFile();
+    } catch {
+      return false;
+    }
+  }
+};
+function resolveWorkspaceDir(baseCwd, workspace, io = defaultWorkspaceIO) {
+  const dir = import_node_path8.default.resolve(baseCwd, workspace);
+  if (!io.isDir(dir)) {
+    return { error: `--workspace ${workspace}: no such directory (${dir}).` };
+  }
+  if (!io.isFile(import_node_path8.default.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 base2 = resolveEndpoint(parsed.endpoint, deps.env);
@@ -8646,7 +8740,18 @@ async function runWizard(parsed, deps) {
   ui.out(color.bold("\nCrumbtrail setup"));
   ui.out(color.dim(`Endpoint: ${base2}
 `));
-  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: ${import_node_path8.default.relative(deps.cwd, cwd) || cwd}`)
+    );
+  }
   const result = deps.detect(cwd);
   if (result.isMonorepo) {
     return runBatchWizard(parsed, deps, { base: base2, wizardStart, root: result });
@@ -8680,7 +8785,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)}`));
@@ -8737,7 +8843,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);
@@ -8780,10 +8889,27 @@ async function runWizard(parsed, deps) {
     } else {
       notes.push("No event yet \u2014 start your app and check the dashboard.");
     }
+    printEvidenceSourcesPointer(ui, base2);
   }
   printSummary(ui, base2, provisioned, inject.filesTouched, notes, sessionUrl);
   return 0;
 }
+function printEvidenceSourcesPointer(ui, base2) {
+  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(`${base2}/settings`)}`);
+}
 function stackLabel2(c) {
   if (c.recipe == null) return "\u2014";
   if (c.recipe === "otlp") return c.detected.otlpStack ?? "otlp";
@@ -8895,7 +9021,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)}`));
@@ -8990,7 +9117,11 @@ async function runBatchWizard(parsed, deps, ctx) {
       const applied = await applyBatchInjection(plan, c, svc.serviceName, {
         parsed,
         deps,
-        base: base2
+        base: base2,
+        sdkInstall: {
+          installed: install.installed,
+          packages: install.packages
+        }
       });
       outcomes.push({
         name: svc.serviceName,
@@ -9065,6 +9196,9 @@ async function runBatchWizard(parsed, deps, ctx) {
       }
     }
   }
+  if (!parsed.skipVerify && reporting.length > 0) {
+    printEvidenceSourcesPointer(ui, base2);
+  }
   printBatchSummary(ui, base2, root, project.name, outcomes, batchNotes);
   const attempted = outcomes.filter(
     (o) => o.status !== "skipped-already-wired"
@@ -9095,7 +9229,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 };
 }
@@ -9139,7 +9273,7 @@ function printBatchSummary(ui, base2, 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 = [];
@@ -9186,7 +9320,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 });
@@ -9275,7 +9418,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) {
@@ -9338,6 +9482,7 @@ if (isCliEntrypoint(process.argv[1])) {
   isCliEntrypoint,
   parseArgs,
   resolveSelection,
+  resolveWorkspaceDir,
   runBatchWizard,
   runCli,
   runWizard

package/dist/cli.d.cts

@@ -1,5 +1,5 @@
 #!/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 { R as Recipe, D as DetectResult, P as PackageManager, b as buildPlan, e as executePlan } from './executor-BKiOvIvD.cjs';
 import { Stack } from 'crumbtrail-design-system';
 
 /** Output sink — swappable in tests to capture lines instead of writing stdout. */
@@ -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,5 +1,5 @@
 #!/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 { R as Recipe, D as DetectResult, P as PackageManager, b as buildPlan, e as executePlan } from './executor-BKiOvIvD.js';
 import { Stack } from 'crumbtrail-design-system';
 
 /** Output sink — swappable in tests to capture lines instead of writing stdout. */
@@ -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-HAP4DPWC.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-BKiOvIvD.d.cts}

@@ -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-BKiOvIvD.d.ts}

@@ -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/index.cjs

@@ -2188,6 +2188,7 @@ __export(index_exports, {
   envKeyLine: () => envKeyLine,
   executePlan: () => executePlan,
   matchRecipe: () => matchRecipe,
+  nestInitSnippet: () => nestInitSnippet,
   nodeInitSnippet: () => nodeInitSnippet,
   nuxtPluginSnippet: () => nuxtPluginSnippet,
   parseNodeInvocation: () => parseNodeInvocation,
@@ -2375,6 +2376,9 @@ function resolveReactNativeEntry(cwd) {
     import_node_path.default.join("app", "_layout.tsx"),
     import_node_path.default.join("app", "_layout.jsx"),
     import_node_path.default.join("app", "_layout.js"),
+    import_node_path.default.join("src", "app", "_layout.tsx"),
+    import_node_path.default.join("src", "app", "_layout.jsx"),
+    import_node_path.default.join("src", "app", "_layout.js"),
     "App.tsx",
     "App.jsx",
     "App.ts",
@@ -2854,6 +2858,20 @@ function nodeInitSnippet(endpoint) {
     "  .catch(() => {});"
   ].join("\n");
 }
+function singleQuoted(value) {
+  return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+}
+function nestInitSnippet(endpoint) {
+  return [
+    "// Crumbtrail \u2014 auto-captures uncaught exceptions, unhandled rejections, and",
+    "// console.error. Key is read from process.env.CRUMBTRAIL_KEY, which autoCapture",
+    "// loads from your .env (written by the CLI). Express apps can also add",
+    "// createCrumbtrailExpressMiddleware for per-request capture.",
+    "import('crumbtrail-node')",
+    `  .then(({ autoCapture }) => autoCapture({ endpoint: ${singleQuoted(endpoint)} }))`,
+    "  .catch(() => {});"
+  ].join("\n");
+}
 function reactNativeInitSnippet(endpoint, apiKey) {
   return [
     'import { createReactNativeCrumbtrail } from "crumbtrail-react-native";',
@@ -2885,10 +2903,14 @@ var import_node_path2 = __toESM(require("path"), 1);
 function realGitStatus(cwd, target) {
   let out;
   try {
+    const env = Object.fromEntries(
+      Object.entries(process.env).filter(([key]) => !key.startsWith("GIT_"))
+    );
     out = (0, import_node_child_process.execFileSync)("git", ["status", "--porcelain", "--", target], {
       cwd,
       encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"]
+      stdio: ["ignore", "pipe", "ignore"],
+      env
     });
   } catch {
     return { isRepo: false, tracked: false, dirty: false };
@@ -7069,7 +7091,7 @@ function planVite(input, io) {
   return prependWithPreflight(input, io, input.entryFile, block);
 }
 function planNode(input, io) {
-  const block = nodeInitSnippet(input.endpoint);
+  const block = input.recipe === "nestjs" ? nestInitSnippet(input.endpoint) : nodeInitSnippet(input.endpoint);
   const { action, warning } = buildEnvAction(input.cwd, input.apiKey, io);
   const envWarnings = warning ? [warning] : [];
   if (!input.entryFile) {
@@ -7347,6 +7369,7 @@ function executePlan(plan, io = defaultExecutorIO, options = {}) {
   envKeyLine,
   executePlan,
   matchRecipe,
+  nestInitSnippet,
   nodeInitSnippet,
   nuxtPluginSnippet,
   parseNodeInvocation,

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { B as BuildPlanInput, a as BuildPlanOptions, c as DENO_UNSUPPORTED_REASON, d as DOCKER_COMING_SOON_NOTE, D as DetectResult, E as EnvAction, f as ExecuteOptions, g as ExecuteResult, h as ExecutorIO, G as GitTargetStatus, I as InjectIO, P as PackageManager, i as Plan, j as PlanKind, R as Recipe, W as WorkspacePackage, b as buildPlan, k as defaultExecutorIO, l as defaultInjectIO, m as detect, n as detectPackageManager, e as executePlan, o as matchRecipe, p as parseNodeInvocation, q as parsePnpmWorkspace, r as projectAlreadyWired, s as resolveAngularEntry, t as resolveNestEntry, u as resolveOtlpStack, v as resolveReactNativeEntry, w as resolveRemixEntry, x as resolveViteEntry, y as supportsInstrumentationClient } from './executor-DKDrkhxM.cjs';
+export { B as BuildPlanInput, a as BuildPlanOptions, c as DENO_UNSUPPORTED_REASON, d as DOCKER_COMING_SOON_NOTE, D as DetectResult, E as EnvAction, f as ExecuteOptions, g as ExecuteResult, h as ExecutorIO, G as GitTargetStatus, I as InjectIO, P as PackageManager, i as Plan, j as PlanKind, R as Recipe, W as WorkspacePackage, b as buildPlan, k as defaultExecutorIO, l as defaultInjectIO, m as detect, n as detectPackageManager, e as executePlan, o as matchRecipe, p as parseNodeInvocation, q as parsePnpmWorkspace, r as projectAlreadyWired, s as resolveAngularEntry, t as resolveNestEntry, u as resolveOtlpStack, v as resolveReactNativeEntry, w as resolveRemixEntry, x as resolveViteEntry, y as supportsInstrumentationClient } from './executor-BKiOvIvD.cjs';
 import 'crumbtrail-design-system';
 
 interface SourceShape {
@@ -55,6 +55,17 @@ declare function nuxtPluginSnippet(endpoint: string, apiKey: string): string;
  * crumbtrail-node's README).
  */
 declare function nodeInitSnippet(endpoint: string): string;
+/**
+ * NestJS server init. Byte-for-byte the same wiring as `nodeInitSnippet` — a
+ * dynamically-imported `autoCapture` prepended into `src/main.ts` — but emitted
+ * with SINGLE quotes to match Nest scaffolds' Prettier default
+ * (`singleQuote: true`). Nest is the only backend-JS recipe that gets its own
+ * snippet: its generator ships a `.prettierrc` with single quotes, so the
+ * double-quoted `nodeInitSnippet` produces cosmetic diff/lint noise on the very
+ * first commit. Every other backend-JS recipe (express/hono/fastify/node) keeps
+ * the double-quoted snippet, which matches Prettier's own default.
+ */
+declare function nestInitSnippet(endpoint: string): string;
 /**
  * React Native / Expo init block. Imperative + prepend-safe: it calls
  * `createReactNativeCrumbtrail` (which runs `Crumbtrail.init` and installs the
@@ -75,4 +86,4 @@ declare function tauriInitSnippet(): string;
 /** The single line the CLI writes into `.env` for the Node recipe. */
 declare function envKeyLine(apiKey: string): string;
 
-export { type SourceShape, analyzeSource, clientInitSnippet, envKeyLine, nodeInitSnippet, nuxtPluginSnippet, prependIntoSource, prologueEnd, reactNativeInitSnippet, referencesCrumbtrail, tauriInitSnippet, withTrailingNewline };
+export { type SourceShape, analyzeSource, clientInitSnippet, envKeyLine, nestInitSnippet, nodeInitSnippet, nuxtPluginSnippet, prependIntoSource, prologueEnd, reactNativeInitSnippet, referencesCrumbtrail, tauriInitSnippet, withTrailingNewline };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { B as BuildPlanInput, a as BuildPlanOptions, c as DENO_UNSUPPORTED_REASON, d as DOCKER_COMING_SOON_NOTE, D as DetectResult, E as EnvAction, f as ExecuteOptions, g as ExecuteResult, h as ExecutorIO, G as GitTargetStatus, I as InjectIO, P as PackageManager, i as Plan, j as PlanKind, R as Recipe, W as WorkspacePackage, b as buildPlan, k as defaultExecutorIO, l as defaultInjectIO, m as detect, n as detectPackageManager, e as executePlan, o as matchRecipe, p as parseNodeInvocation, q as parsePnpmWorkspace, r as projectAlreadyWired, s as resolveAngularEntry, t as resolveNestEntry, u as resolveOtlpStack, v as resolveReactNativeEntry, w as resolveRemixEntry, x as resolveViteEntry, y as supportsInstrumentationClient } from './executor-DKDrkhxM.js';
+export { B as BuildPlanInput, a as BuildPlanOptions, c as DENO_UNSUPPORTED_REASON, d as DOCKER_COMING_SOON_NOTE, D as DetectResult, E as EnvAction, f as ExecuteOptions, g as ExecuteResult, h as ExecutorIO, G as GitTargetStatus, I as InjectIO, P as PackageManager, i as Plan, j as PlanKind, R as Recipe, W as WorkspacePackage, b as buildPlan, k as defaultExecutorIO, l as defaultInjectIO, m as detect, n as detectPackageManager, e as executePlan, o as matchRecipe, p as parseNodeInvocation, q as parsePnpmWorkspace, r as projectAlreadyWired, s as resolveAngularEntry, t as resolveNestEntry, u as resolveOtlpStack, v as resolveReactNativeEntry, w as resolveRemixEntry, x as resolveViteEntry, y as supportsInstrumentationClient } from './executor-BKiOvIvD.js';
 import 'crumbtrail-design-system';
 
 interface SourceShape {
@@ -55,6 +55,17 @@ declare function nuxtPluginSnippet(endpoint: string, apiKey: string): string;
  * crumbtrail-node's README).
  */
 declare function nodeInitSnippet(endpoint: string): string;
+/**
+ * NestJS server init. Byte-for-byte the same wiring as `nodeInitSnippet` — a
+ * dynamically-imported `autoCapture` prepended into `src/main.ts` — but emitted
+ * with SINGLE quotes to match Nest scaffolds' Prettier default
+ * (`singleQuote: true`). Nest is the only backend-JS recipe that gets its own
+ * snippet: its generator ships a `.prettierrc` with single quotes, so the
+ * double-quoted `nodeInitSnippet` produces cosmetic diff/lint noise on the very
+ * first commit. Every other backend-JS recipe (express/hono/fastify/node) keeps
+ * the double-quoted snippet, which matches Prettier's own default.
+ */
+declare function nestInitSnippet(endpoint: string): string;
 /**
  * React Native / Expo init block. Imperative + prepend-safe: it calls
  * `createReactNativeCrumbtrail` (which runs `Crumbtrail.init` and installs the
@@ -75,4 +86,4 @@ declare function tauriInitSnippet(): string;
 /** The single line the CLI writes into `.env` for the Node recipe. */
 declare function envKeyLine(apiKey: string): string;
 
-export { type SourceShape, analyzeSource, clientInitSnippet, envKeyLine, nodeInitSnippet, nuxtPluginSnippet, prependIntoSource, prologueEnd, reactNativeInitSnippet, referencesCrumbtrail, tauriInitSnippet, withTrailingNewline };
+export { type SourceShape, analyzeSource, clientInitSnippet, envKeyLine, nestInitSnippet, nodeInitSnippet, nuxtPluginSnippet, prependIntoSource, prologueEnd, reactNativeInitSnippet, referencesCrumbtrail, tauriInitSnippet, withTrailingNewline };

package/dist/index.js

@@ -11,6 +11,7 @@ import {
   envKeyLine,
   executePlan,
   matchRecipe,
+  nestInitSnippet,
   nodeInitSnippet,
   nuxtPluginSnippet,
   parseNodeInvocation,
@@ -29,7 +30,7 @@ import {
   supportsInstrumentationClient,
   tauriInitSnippet,
   withTrailingNewline
-} from "./chunk-UFJ2BODB.js";
+} from "./chunk-HAP4DPWC.js";
 export {
   DENO_UNSUPPORTED_REASON,
   DOCKER_COMING_SOON_NOTE,
@@ -43,6 +44,7 @@ export {
   envKeyLine,
   executePlan,
   matchRecipe,
+  nestInitSnippet,
   nodeInitSnippet,
   nuxtPluginSnippet,
   parseNodeInvocation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crumbtrail",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Crumbtrail setup CLI — detect your framework and wire the SDK into your app in one step.",
   "license": "MIT",
   "repository": {
@@ -39,6 +39,11 @@
   "publishConfig": {
     "access": "public"
   },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "crumbtrail-design-system": "0.0.0",
+    "crumbtrail-install-shared": "0.1.0"
+  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
@@ -46,10 +51,5 @@
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "clean": "rm -rf dist"
-  },
-  "devDependencies": {
-    "@types/node": "^25.5.0",
-    "crumbtrail-design-system": "workspace:*",
-    "crumbtrail-install-shared": "workspace:*"
   }
-}
+}