@neat.is/core 0.4.2 → 0.4.4

package/dist/cli.js

@@ -41,15 +41,15 @@ import {
   setStatus,
   startPersistLoop,
   startStalenessLoop
-} from "./chunk-NTQHMXWE.js";
+} from "./chunk-G3YGPWJL.js";
 import {
   startOtelGrpcReceiver
-} from "./chunk-D5PIJFBE.js";
+} from "./chunk-YJOA7BBF.js";
 import {
   __dirname,
   __require,
   buildOtelReceiver
-} from "./chunk-KYRIQIPG.js";
+} from "./chunk-ZVNP3ZDH.js";
 
 // src/cli.ts
 import path8 from "path";
@@ -694,45 +694,31 @@ import path4 from "path";
 // src/installers/templates.ts
 var OTEL_INIT_HEADER = "// Generated by `neat init --apply` (ADR-069). OpenTelemetry auto-instrumentation hook.";
 var OTEL_INIT_CJS = `${OTEL_INIT_HEADER}
-// Loads .env.neat (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT) before
-// the auto-instrumentation hook attaches. Configure via the env file.
-const path = require('node:path')
-try {
-  require('dotenv').config({ path: path.join(__dirname, '.env.neat') })
-} catch (err) {
-  // dotenv unavailable \u2014 fall through to process.env.
-}
+process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
+process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+
 require('@opentelemetry/auto-instrumentations-node/register')
 `;
 var OTEL_INIT_ESM = `${OTEL_INIT_HEADER}
-// Loads .env.neat (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT) before
-// the auto-instrumentation hook attaches. Configure via the env file.
-import { fileURLToPath } from 'node:url'
-import path from 'node:path'
-import dotenv from 'dotenv'
-
-const here = path.dirname(fileURLToPath(import.meta.url))
-dotenv.config({ path: path.join(here, '.env.neat') })
+process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
+process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
 
 await import('@opentelemetry/auto-instrumentations-node/register')
 `;
 var OTEL_INIT_TS = `${OTEL_INIT_HEADER}
-// Loads .env.neat (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT) before
-// the auto-instrumentation hook attaches. Configure via the env file.
-import { fileURLToPath } from 'node:url'
-import path from 'node:path'
-import dotenv from 'dotenv'
-
-const here = path.dirname(fileURLToPath(import.meta.url))
-dotenv.config({ path: path.join(here, '.env.neat') })
+process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
+process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
 
 await import('@opentelemetry/auto-instrumentations-node/register')
 `;
-function renderEnvNeat(projectName) {
+function renderNodeOtelInit(template, serviceName, projectName) {
+  return template.replace(/__SERVICE_NAME__/g, serviceName).replace(/__PROJECT__/g, projectName);
+}
+function renderEnvNeat(serviceName, projectName) {
   return [
     "# Generated by `neat init --apply` (ADR-069).",
-    `OTEL_SERVICE_NAME=${projectName}`,
-    "OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318",
+    `OTEL_SERVICE_NAME=${serviceName}`,
+    `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://localhost:4318/projects/${projectName}/v1/traces`,
     ""
   ].join("\n");
 }
@@ -752,54 +738,34 @@ export async function register() {
 }
 `;
 var NEXT_INSTRUMENTATION_NODE_TS = `${NEXT_INSTRUMENTATION_HEADER}
-// Loads .env.neat (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT) before
-// the OTel SDK starts so the exporter target and service name are in scope.
-import { fileURLToPath } from 'node:url'
-import path from 'node:path'
-import dotenv from 'dotenv'
+process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
+process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+
 import { NodeSDK } from '@opentelemetry/sdk-node'
 import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node'
 
-const here = path.dirname(fileURLToPath(import.meta.url))
-dotenv.config({ path: path.join(here, '.env.neat') })
-
-const sdk = new NodeSDK({
-  serviceName: process.env.OTEL_SERVICE_NAME,
-  instrumentations: [getNodeAutoInstrumentations()],
-})
-sdk.start()
+new NodeSDK({ instrumentations: [getNodeAutoInstrumentations()] }).start()
 `;
 var NEXT_INSTRUMENTATION_NODE_JS = `${NEXT_INSTRUMENTATION_HEADER}
-// Loads .env.neat (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT) before
-// the OTel SDK starts so the exporter target and service name are in scope.
-import { fileURLToPath } from 'node:url'
-import path from 'node:path'
-import dotenv from 'dotenv'
-import { NodeSDK } from '@opentelemetry/sdk-node'
-import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node'
+process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
+process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
 
-const here = path.dirname(fileURLToPath(import.meta.url))
-dotenv.config({ path: path.join(here, '.env.neat') })
+const { NodeSDK } = require('@opentelemetry/sdk-node')
+const { getNodeAutoInstrumentations } = require('@opentelemetry/auto-instrumentations-node')
 
-const sdk = new NodeSDK({
-  serviceName: process.env.OTEL_SERVICE_NAME,
-  instrumentations: [getNodeAutoInstrumentations()],
-})
-sdk.start()
+new NodeSDK({ instrumentations: [getNodeAutoInstrumentations()] }).start()
 `;
+function renderNextInstrumentationNode(template, serviceName, projectName) {
+  return template.replace(/__SERVICE_NAME__/g, serviceName).replace(/__PROJECT__/g, projectName);
+}
 var FRAMEWORK_OTEL_INIT_HEADER = "// Generated by `neat init --apply` (ADR-074). OpenTelemetry SDK hook.";
 var FRAMEWORK_OTEL_INIT_TS_BODY = `${FRAMEWORK_OTEL_INIT_HEADER}
-// Loads .env.neat (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT) before
-// the OTel SDK starts so the exporter target and service name are in scope.
-import { fileURLToPath } from 'node:url'
-import path from 'node:path'
-import dotenv from 'dotenv'
+process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
+process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+
 import { NodeSDK } from '@opentelemetry/sdk-node'
 import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node'
 
-const here = path.dirname(fileURLToPath(import.meta.url))
-dotenv.config({ path: path.join(here, '.env.neat') })
-
 const sdk = new NodeSDK({
   serviceName: process.env.OTEL_SERVICE_NAME,
   instrumentations: [getNodeAutoInstrumentations()],
@@ -807,14 +773,9 @@ const sdk = new NodeSDK({
 sdk.start()
 `;
 var FRAMEWORK_OTEL_INIT_JS_BODY = `${FRAMEWORK_OTEL_INIT_HEADER}
-// Loads .env.neat (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT) before
-// the OTel SDK starts so the exporter target and service name are in scope.
-const path = require('node:path')
-try {
-  require('dotenv').config({ path: path.join(__dirname, '.env.neat') })
-} catch (err) {
-  // dotenv unavailable \u2014 fall through to process.env.
-}
+process.env.OTEL_SERVICE_NAME ||= '__SERVICE_NAME__'
+process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||= 'http://localhost:4318/projects/__PROJECT__/v1/traces'
+
 const { NodeSDK } = require('@opentelemetry/sdk-node')
 const { getNodeAutoInstrumentations } = require('@opentelemetry/auto-instrumentations-node')
 
@@ -824,6 +785,9 @@ const sdk = new NodeSDK({
 })
 sdk.start()
 `;
+function renderFrameworkOtelInit(template, serviceName, projectName) {
+  return template.replace(/__SERVICE_NAME__/g, serviceName).replace(/__PROJECT__/g, projectName);
+}
 var REMIX_OTEL_SERVER_TS = FRAMEWORK_OTEL_INIT_TS_BODY;
 var REMIX_OTEL_SERVER_JS = FRAMEWORK_OTEL_INIT_JS_BODY;
 var SVELTEKIT_OTEL_INIT_TS = FRAMEWORK_OTEL_INIT_TS_BODY;
@@ -886,11 +850,7 @@ export const onRequest = defineMiddleware(async (context, next) => {
 var SDK_PACKAGES = [
   { name: "@opentelemetry/api", version: "^1.9.0" },
   { name: "@opentelemetry/sdk-node", version: "^0.57.0" },
-  { name: "@opentelemetry/auto-instrumentations-node", version: "^0.55.0" },
-  // ADR-069 §5 — dotenv is the fourth dep. The generated otel-init loads
-  // .env.neat through it so OTEL_SERVICE_NAME and the endpoint are in scope
-  // before the auto-instrumentation hook attaches.
-  { name: "dotenv", version: "^16.4.5" }
+  { name: "@opentelemetry/auto-instrumentations-node", version: "^0.55.0" }
 ];
 var OTEL_ENV = {
   // ADR-069 §4 — endpoint moves into the per-package .env.neat (written
@@ -898,13 +858,36 @@ var OTEL_ENV = {
   // patch render: it documents the key/value the user can inspect in the
   // generated .env.neat.
   file: null,
-  key: "OTEL_EXPORTER_OTLP_ENDPOINT",
-  value: "http://localhost:4318"
+  key: "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
+  value: "http://localhost:4318/projects/<project>/v1/traces"
 };
-function envServiceName(pkg, serviceDir, project) {
+function serviceNodeName(pkg, serviceDir) {
+  return pkg.name ?? path4.basename(serviceDir);
+}
+function projectToken(pkg, serviceDir, project) {
   if (project && project.length > 0) return project;
   return pkg.name ?? path4.basename(serviceDir);
 }
+async function readJsonFile(p) {
+  try {
+    const raw = await fs4.readFile(p, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+async function detectRuntimeKind(pkgRoot, pkg) {
+  const deps = allDeps(pkg);
+  if ("react-native" in deps || "expo" in deps) return "react-native";
+  const appJson = await readJsonFile(path4.join(pkgRoot, "app.json"));
+  if (appJson && typeof appJson === "object" && "expo" in appJson) {
+    return "react-native";
+  }
+  if (await exists(path4.join(pkgRoot, "vite.config.js")) || await exists(path4.join(pkgRoot, "vite.config.ts")) || await exists(path4.join(pkgRoot, "vite.config.mjs")) || "vite" in deps) {
+    return "browser-bundle";
+  }
+  return "node";
+}
 async function readPackageJson(serviceDir) {
   try {
     const raw = await fs4.readFile(path4.join(serviceDir, "package.json"), "utf8");
@@ -1129,14 +1112,25 @@ function lineIsOtelInjection(line) {
   if (trimmed.length === 0) return false;
   return /(?:require\(|import\s+)['"]\.\/otel-init[^'"]*['"]/.test(trimmed);
 }
+async function detectsSrcLayout(serviceDir) {
+  const [hasSrcApp, hasSrcPages, hasRootApp, hasRootPages] = await Promise.all([
+    exists(path4.join(serviceDir, "src", "app")),
+    exists(path4.join(serviceDir, "src", "pages")),
+    exists(path4.join(serviceDir, "app")),
+    exists(path4.join(serviceDir, "pages"))
+  ]);
+  return (hasSrcApp || hasSrcPages) && !hasRootApp && !hasRootPages;
+}
 async function planNext(serviceDir, pkg, manifestPath, nextConfigPath, project) {
   const useTs = await isTypeScriptProject(serviceDir);
-  const instrumentationFile = path4.join(serviceDir, useTs ? "instrumentation.ts" : "instrumentation.js");
+  const srcLayout = await detectsSrcLayout(serviceDir);
+  const baseDir = srcLayout ? path4.join(serviceDir, "src") : serviceDir;
+  const instrumentationFile = path4.join(baseDir, useTs ? "instrumentation.ts" : "instrumentation.js");
   const instrumentationNodeFile = path4.join(
-    serviceDir,
+    baseDir,
     useTs ? "instrumentation.node.ts" : "instrumentation.node.js"
   );
-  const envNeatFile = path4.join(serviceDir, ".env.neat");
+  const envNeatFile = path4.join(baseDir, ".env.neat");
   const existingDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
   const dependencyEdits = [];
   for (const sdk of SDK_PACKAGES) {
@@ -1148,6 +1142,8 @@ async function planNext(serviceDir, pkg, manifestPath, nextConfigPath, project)
       version: sdk.version
     });
   }
+  const svcName = serviceNodeName(pkg, serviceDir);
+  const projectName = projectToken(pkg, serviceDir, project);
   const generatedFiles = [];
   if (!await exists(instrumentationFile)) {
     generatedFiles.push({
@@ -1159,14 +1155,18 @@ async function planNext(serviceDir, pkg, manifestPath, nextConfigPath, project)
   if (!await exists(instrumentationNodeFile)) {
     generatedFiles.push({
       file: instrumentationNodeFile,
-      contents: useTs ? NEXT_INSTRUMENTATION_NODE_TS : NEXT_INSTRUMENTATION_NODE_JS,
+      contents: renderNextInstrumentationNode(
+        useTs ? NEXT_INSTRUMENTATION_NODE_TS : NEXT_INSTRUMENTATION_NODE_JS,
+        svcName,
+        projectName
+      ),
       skipIfExists: true
     });
   }
   if (!await exists(envNeatFile)) {
     generatedFiles.push({
       file: envNeatFile,
-      contents: renderEnvNeat(envServiceName(pkg, serviceDir, project)),
+      contents: renderEnvNeat(svcName, projectName),
       skipIfExists: true
     });
   }
@@ -1227,11 +1227,21 @@ async function queueEnvNeat(serviceDir, pkg, project, generatedFiles) {
   if (!await exists(envNeatFile)) {
     generatedFiles.push({
       file: envNeatFile,
-      contents: renderEnvNeat(envServiceName(pkg, serviceDir, project)),
+      contents: renderEnvNeat(
+        serviceNodeName(pkg, serviceDir),
+        projectToken(pkg, serviceDir, project)
+      ),
       skipIfExists: true
     });
   }
 }
+function renderFrameworkOtelInitForPkg(template, pkg, serviceDir, project) {
+  return renderFrameworkOtelInit(
+    template,
+    serviceNodeName(pkg, serviceDir),
+    projectToken(pkg, serviceDir, project)
+  );
+}
 function fileImportsOtelHook(raw, specifiers) {
   const lines = raw.split(/\r?\n/);
   for (const line of lines) {
@@ -1257,7 +1267,12 @@ async function planRemix(serviceDir, pkg, manifestPath, entryFile, project) {
   if (!await exists(otelServerFile)) {
     generatedFiles.push({
       file: otelServerFile,
-      contents: useTs ? REMIX_OTEL_SERVER_TS : REMIX_OTEL_SERVER_JS,
+      contents: renderFrameworkOtelInitForPkg(
+        useTs ? REMIX_OTEL_SERVER_TS : REMIX_OTEL_SERVER_JS,
+        pkg,
+        serviceDir,
+        project
+      ),
       skipIfExists: true
     });
   }
@@ -1311,7 +1326,12 @@ async function planSvelteKit(serviceDir, pkg, manifestPath, hooksFile, project)
   if (!await exists(otelInitFile)) {
     generatedFiles.push({
       file: otelInitFile,
-      contents: useTs ? SVELTEKIT_OTEL_INIT_TS : SVELTEKIT_OTEL_INIT_JS,
+      contents: renderFrameworkOtelInitForPkg(
+        useTs ? SVELTEKIT_OTEL_INIT_TS : SVELTEKIT_OTEL_INIT_JS,
+        pkg,
+        serviceDir,
+        project
+      ),
       skipIfExists: true
     });
   }
@@ -1374,7 +1394,12 @@ async function planNuxt(serviceDir, pkg, manifestPath, project) {
   if (!await exists(otelInitFile)) {
     generatedFiles.push({
       file: otelInitFile,
-      contents: useTs ? NUXT_OTEL_INIT_TS : NUXT_OTEL_INIT_JS,
+      contents: renderFrameworkOtelInitForPkg(
+        useTs ? NUXT_OTEL_INIT_TS : NUXT_OTEL_INIT_JS,
+        pkg,
+        serviceDir,
+        project
+      ),
       skipIfExists: true
     });
   }
@@ -1430,7 +1455,12 @@ async function planAstro(serviceDir, pkg, manifestPath, project) {
   if (!await exists(otelInitFile)) {
     generatedFiles.push({
       file: otelInitFile,
-      contents: useTs ? ASTRO_OTEL_INIT_TS : ASTRO_OTEL_INIT_JS,
+      contents: renderFrameworkOtelInitForPkg(
+        useTs ? ASTRO_OTEL_INIT_TS : ASTRO_OTEL_INIT_JS,
+        pkg,
+        serviceDir,
+        project
+      ),
       skipIfExists: true
     });
   }
@@ -1522,6 +1552,10 @@ async function plan(serviceDir, opts) {
       return planAstro(serviceDir, pkg, manifestPath, project);
     }
   }
+  const runtimeKind = await detectRuntimeKind(serviceDir, pkg);
+  if (runtimeKind !== "node") {
+    return { ...empty, runtimeKind };
+  }
   const entryFile = await resolveEntry(serviceDir, pkg);
   if (!entryFile) {
     return { ...empty, libOnly: true };
@@ -1556,18 +1590,20 @@ async function plan(serviceDir, opts) {
   } catch {
     return { ...empty, libOnly: true };
   }
+  const svcName = serviceNodeName(pkg, serviceDir);
+  const projectName = projectToken(pkg, serviceDir, project);
   const generatedFiles = [];
   if (!await exists(otelInitFile)) {
     generatedFiles.push({
       file: otelInitFile,
-      contents: otelInitContents(flavor),
+      contents: renderNodeOtelInit(otelInitContents(flavor), svcName, projectName),
       skipIfExists: true
     });
   }
   if (!await exists(envNeatFile)) {
     generatedFiles.push({
       file: envNeatFile,
-      contents: renderEnvNeat(envServiceName(pkg, serviceDir, project)),
+      contents: renderEnvNeat(svcName, projectName),
       skipIfExists: true
     });
   }
@@ -1592,9 +1628,13 @@ function isAllowedWritePath(serviceDir, target) {
   if (base === "package.json") return true;
   if (base === ".env.neat") return true;
   if (/^otel-init\.(?:js|cjs|mjs|ts)$/.test(base)) return true;
-  if (/^instrumentation(?:\.node)?\.(?:js|cjs|mjs|ts)$/.test(base)) return true;
-  if (/^next\.config\.(?:js|mjs|ts)$/.test(base)) return true;
   const relPosix = rel.split(path4.sep).join("/");
+  if (/^instrumentation(?:\.node)?\.(?:js|cjs|mjs|ts)$/.test(base)) {
+    if (relPosix === base) return true;
+    if (relPosix === `src/${base}`) return true;
+    return false;
+  }
+  if (/^next\.config\.(?:js|mjs|ts)$/.test(base)) return true;
   if (relPosix === "app/otel.server.ts" || relPosix === "app/otel.server.js") return true;
   if (/^app\/entry\.server\.(?:tsx?|jsx?)$/.test(relPosix)) return true;
   if (relPosix === "src/otel-init.ts" || relPosix === "src/otel-init.js") return true;
@@ -1620,6 +1660,22 @@ async function apply(installPlan) {
       writtenFiles: []
     };
   }
+  if (installPlan.runtimeKind === "browser-bundle") {
+    return {
+      serviceDir,
+      outcome: "browser-bundle",
+      reason: "browser bundle; Node OTel SDK cannot run here",
+      writtenFiles: []
+    };
+  }
+  if (installPlan.runtimeKind === "react-native") {
+    return {
+      serviceDir,
+      outcome: "react-native",
+      reason: "React Native / Expo target; Node OTel SDK cannot run here",
+      writtenFiles: []
+    };
+  }
   if (installPlan.dependencyEdits.length === 0 && installPlan.entrypointEdits.length === 0 && (installPlan.generatedFiles?.length ?? 0) === 0 && installPlan.nextConfigEdit === void 0) {
     return {
       serviceDir,
@@ -2103,11 +2159,13 @@ async function applyInstallersOver(services, project) {
   let instrumented = 0;
   let already = 0;
   let libOnly = 0;
+  let browserBundle = 0;
+  let reactNative = 0;
   for (const svc of services) {
     const installer = await pickInstaller(svc.dir);
     if (!installer) continue;
     const plan3 = await installer.plan(svc.dir, { project });
-    if (isEmptyPlan(plan3) && !plan3.libOnly) {
+    if (isEmptyPlan(plan3) && !plan3.libOnly && plan3.runtimeKind === void 0) {
       already++;
       continue;
     }
@@ -2115,8 +2173,15 @@ async function applyInstallersOver(services, project) {
     if (outcome.outcome === "instrumented") instrumented++;
     else if (outcome.outcome === "already-instrumented") already++;
     else if (outcome.outcome === "lib-only") libOnly++;
+    else if (outcome.outcome === "browser-bundle") {
+      browserBundle++;
+      console.log(`skipping ${svc.dir}: browser bundle; browser-OTel support lands in a future release.`);
+    } else if (outcome.outcome === "react-native") {
+      reactNative++;
+      console.log(`skipping ${svc.dir}: React Native target; browser-OTel support lands in a future release.`);
+    }
   }
-  return { instrumented, alreadyInstrumented: already, libOnly };
+  return { instrumented, alreadyInstrumented: already, libOnly, browserBundle, reactNative };
 }
 async function promptYesNo(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
@@ -2320,13 +2385,15 @@ async function runOrchestrator(opts) {
   if (gi.action !== "unchanged") {
     console.log(`${gi.action} .gitignore (neat-out/)`);
   }
+  let currentProjectName = opts.project;
   try {
-    await addProject({
+    const entry2 = await addProject({
       name: opts.project,
       path: opts.scanPath,
       languages,
       status: "active"
     });
+    currentProjectName = entry2.name;
   } catch (err) {
     if (!(err instanceof ProjectNameCollisionError)) throw err;
     console.error(`neat: ${err.message}`);
@@ -2334,6 +2401,20 @@ async function runOrchestrator(opts) {
     result.exitCode = 1;
     return result;
   }
+  const siblings = await listProjects();
+  const paused = [];
+  for (const p of siblings) {
+    if (p.name !== currentProjectName && p.status === "active") {
+      await setStatus(p.name, "paused");
+      paused.push(p.name);
+    }
+  }
+  if (paused.length > 0) {
+    const plural = paused.length === 1 ? "" : "s";
+    console.log(
+      `neat: paused ${paused.length} sibling project${plural}; run \`neat resume <name>\` to bring one back active.`
+    );
+  }
   if (!runApply) {
     result.steps.apply.skipped = true;
     console.log("skipped instrumentation (--no-instrument)");
@@ -3004,7 +3085,7 @@ async function runSync(opts) {
     snapshotPath = target;
   }
   const skipApply = opts.dryRun || opts.noInstrument;
-  const applyTally = skipApply ? { instrumented: 0, alreadyInstrumented: 0, libOnly: 0 } : await applyInstallersOver(persisted.services, entry2.name);
+  const applyTally = skipApply ? { instrumented: 0, alreadyInstrumented: 0, libOnly: 0, browserBundle: 0, reactNative: 0 } : await applyInstallersOver(persisted.services, entry2.name);
   const warnings = [];
   let daemonState = "skipped";
   let exitCode = 0;
@@ -3352,7 +3433,7 @@ async function buildPatchSections(services, project) {
     const installer = await pickInstaller(svc.dir);
     if (!installer) continue;
     const plan3 = await installer.plan(svc.dir, { project });
-    if (isEmptyPlan(plan3) && !plan3.libOnly) continue;
+    if (isEmptyPlan(plan3) && !plan3.libOnly && plan3.runtimeKind === void 0) continue;
     sections.push({ installer: installer.name, plan: plan3 });
   }
   return sections;
@@ -3396,13 +3477,15 @@ async function runInit(opts) {
     written.push(gitignoreResult.file);
   }
   const languages = [...new Set(services.map((s) => s.node.language))].sort();
+  let currentProjectName = opts.project;
   try {
-    await addProject({
+    const entry2 = await addProject({
       name: opts.project,
       path: opts.scanPath,
       languages,
       status: "active"
     });
+    currentProjectName = entry2.name;
   } catch (err) {
     if (err instanceof ProjectNameCollisionError) {
       console.error(`neat init: ${err.message}`);
@@ -3411,11 +3494,27 @@ async function runInit(opts) {
     }
     throw err;
   }
+  const siblings = await listProjects();
+  const paused = [];
+  for (const p of siblings) {
+    if (p.name !== currentProjectName && p.status === "active") {
+      await setStatus(p.name, "paused");
+      paused.push(p.name);
+    }
+  }
+  if (paused.length > 0) {
+    const plural = paused.length === 1 ? "" : "s";
+    console.log(
+      `neat: paused ${paused.length} sibling project${plural}; run \`neat resume <name>\` to bring one back active.`
+    );
+  }
   if (!opts.noInstall) {
     if (opts.apply) {
       let instrumented = 0;
       let alreadyInstrumented = 0;
       let libOnly = 0;
+      let browserBundle = 0;
+      let reactNative = 0;
       for (const section of sections) {
         const installer = INSTALLERS.find((i) => i.name === section.installer);
         if (!installer) continue;
@@ -3427,13 +3526,24 @@ async function runInit(opts) {
           alreadyInstrumented++;
         } else if (outcome.outcome === "lib-only") {
           libOnly++;
+        } else if (outcome.outcome === "browser-bundle") {
+          browserBundle++;
+          console.log(`skipping ${section.plan.serviceDir}: browser bundle; browser-OTel support lands in a future release.`);
+        } else if (outcome.outcome === "react-native") {
+          reactNative++;
+          console.log(`skipping ${section.plan.serviceDir}: React Native target; browser-OTel support lands in a future release.`);
         }
       }
       if (sections.length > 0) {
         console.log("");
-        console.log(
-          `apply: instrumented ${instrumented}, already-instrumented ${alreadyInstrumented}, lib-only ${libOnly}`
-        );
+        const parts = [
+          `instrumented ${instrumented}`,
+          `already-instrumented ${alreadyInstrumented}`,
+          `lib-only ${libOnly}`
+        ];
+        if (browserBundle > 0) parts.push(`browser-bundle ${browserBundle}`);
+        if (reactNative > 0) parts.push(`react-native ${reactNative}`);
+        console.log(`apply: ${parts.join(", ")}`);
         console.log("Run `npm install` (or your language equivalent) to refresh lockfiles.");
       }
     } else {
@@ -3923,7 +4033,7 @@ async function runQueryVerb(cmd, parsed) {
   }
 }
 var entry = process.argv[1] ?? "";
-if (/[\\/]cli\.(?:cjs|js)$/.test(entry) || entry.endsWith("/cli") || entry.endsWith("/neat")) {
+if (/[\\/]cli\.(?:cjs|js)$/.test(entry) || entry.endsWith("/cli") || entry.endsWith("/neat") || entry.endsWith("/neat.is")) {
   main().catch((err) => {
     console.error(err);
     process.exit(1);