crumbtrail 0.1.0

package/dist/executor-DKDrkhxM.d.cts

@@ -0,0 +1,279 @@
+import { Stack } from 'crumbtrail-design-system';
+
+/** 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";
+type PackageManager = "pnpm" | "yarn" | "bun" | "npm";
+interface WorkspacePackage {
+    /** package.json `name`, falling back to the directory basename. */
+    name: string;
+    /** Absolute path to the workspace package directory. */
+    dir: string;
+}
+interface DetectResult {
+    cwd: string;
+    packageJsonPath: string | null;
+    /** Winning recipe, or null when nothing matched. */
+    recipe: Recipe | null;
+    packageManager: PackageManager | null;
+    /**
+     * Absolute path to the file the recipe would edit (vite-spa / node), when it
+     * could be resolved with confidence. null for create-a-new-file recipes and
+     * whenever resolution was ambiguous.
+     */
+    entryFile: string | null;
+    /** Raw `next` version range from package.json, when the recipe is `next`. */
+    nextVersion: string | null;
+    /**
+     * The non-JS backend Stack resolved from filesystem markers when `recipe` is
+     * `"otlp"` (django/flask/fastapi/go/rails/dotnet). null for every other recipe.
+     * This is the ONE recipe that carries a variable Stack; call sites must prefer
+     * it over the static `RECIPE_REGISTRY["otlp"].stack` placeholder.
+     */
+    otlpStack: Stack | null;
+    isMonorepo: boolean;
+    /** Workspace packages when `isMonorepo` — the caller picks which app to wire. */
+    workspaces: WorkspacePackage[];
+    /**
+     * True when the caller must resolve a choice before injecting: monorepo root,
+     * no recipe matched, or the recipe's entry file could not be resolved.
+     */
+    ambiguous: boolean;
+    /** Human-readable trail of why detection landed where it did. */
+    reasons: string[];
+    /**
+     * Non-blocking, informational messages about the project that do NOT affect
+     * `recipe`/`ambiguous`/`isMonorepo`/`entryFile` — e.g. a "Docker files found,
+     * infra evidence sources coming soon" note. Kept separate from `reasons` (the
+     * detection trail); the caller surfaces these on both success and no-recipe
+     * paths without changing any outcome.
+     */
+    notes: string[];
+}
+interface PackageJson {
+    name?: string;
+    main?: string;
+    bin?: string | Record<string, string>;
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    workspaces?: string[] | {
+        packages?: string[];
+    };
+}
+/** Walk up from `startDir` to the filesystem root looking for a known lockfile. */
+declare function detectPackageManager(startDir: string): PackageManager | null;
+/** Extract the `packages:` list from a pnpm-workspace.yaml without a YAML dep. */
+declare function parsePnpmWorkspace(text: string): string[];
+/** Resolve the Vite entry from index.html's `<script type="module" src>` tag. */
+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.
+ */
+declare function resolveReactNativeEntry(cwd: string): string | null;
+/** Pull a node script/module path out of a `start`-style command. */
+declare function parseNodeInvocation(script: string): string | null;
+/**
+ * Resolve the NestJS injection entry. Nest's bootstrap lives at `src/main.ts`
+ * (or `src/main.js`); `resolveNodeEntry` cannot find it because the `start`
+ * script is `nest start` (not a bare node invocation) and `main` points at
+ * `dist/`. First existing file wins; null when neither exists (→ ambiguous).
+ */
+declare function resolveNestEntry(cwd: string): string | null;
+/**
+ * Resolve the Remix / React Router v7 hydration entry. Prefers
+ * `app/entry.client.{tsx,jsx,js}` in that order. Returns null when none exist —
+ * the recipe then FALLS BACK rather than creating one, because a bare init-only
+ * entry.client would omit hydrateRoot/<RemixBrowser> and break the app.
+ */
+declare function resolveRemixEntry(cwd: string): string | null;
+/**
+ * Resolve the Angular bootstrap entry — deterministically `src/main.ts`. Null
+ * when absent (→ ambiguous). Prepending an import + `Crumbtrail.init` above
+ * Angular's `bootstrapApplication`/`platformBrowserDynamic` call is safe.
+ */
+declare function resolveAngularEntry(cwd: string): string | null;
+/**
+ * Resolve a non-JS backend from filesystem markers — the `otlp` recipe's Stack.
+ * Filesystem-only: no code is executed; Python/Ruby manifests are parsed purely
+ * as text. Precedence is deliberate and documented:
+ *   1. `manage.py`                         → django
+ *   2. pyproject.toml/requirements.txt dep → fastapi (wins over flask if BOTH
+ *      tokens appear) else flask
+ *   3. `go.mod`                            → go
+ *   4. `Gemfile` referencing rails         → rails
+ *   5. any `*.csproj` in the root          → dotnet
+ * Returns null when no marker matches. Works with NO package.json present.
+ */
+declare function resolveOtlpStack(root: string): {
+    stack: Stack;
+    reason: string;
+} | null;
+/**
+ * Distinct `reasons` string pushed when a Deno project is detected (deno.json /
+ * deno.jsonc with no package.json). Exported so the wizard can recognize the
+ * signal and print a Deno-specific line instead of the generic unsupported hint.
+ */
+declare const DENO_UNSUPPORTED_REASON = "Deno projects aren't supported yet";
+/**
+ * Informational, non-blocking note emitted when Docker/Compose files are present.
+ * References that infra evidence sources (e.g. the `docker` stack in
+ * install-shared's INFRA_STACKS) are coming soon. NEVER affects recipe/ambiguity.
+ */
+declare const DOCKER_COMING_SOON_NOTE = "Docker/Compose files found \u2014 infra evidence sources (e.g. docker) are coming soon.";
+/** Inputs shared by every recipe matcher — filesystem-derived facts only. */
+interface MatchContext {
+    root: string;
+    deps: Record<string, string>;
+    pkg: PackageJson | null;
+    /** Matchers push their user-facing detection reasons here (side effect). */
+    reasons: string[];
+}
+/**
+ * Evaluate the ordered matcher ladder, returning the first match. When nothing
+ * matches, recipe is null with no entry/version. Reasons are recorded as a side
+ * effect on `ctx.reasons`, exactly as the original if/else chain did.
+ */
+declare function matchRecipe(ctx: MatchContext): {
+    recipe: Recipe | null;
+    entryFile: string | null;
+    nextVersion: string | null;
+    otlpStack: Stack | null;
+};
+/**
+ * Classify a single package directory. For a monorepo root this reports the
+ * workspace list and marks the result ambiguous — the caller picks a workspace
+ * and re-runs `detect` inside it.
+ */
+declare function detect(cwd: string): DetectResult;
+
+/** The shape of a plan the executor knows how to (or refuses to) apply. */
+type PlanKind = "create" | "prepend" | "skip-already-wired" | "needs-confirm-dirty" | "fallback-ai" | "otlp-guidance";
+/** A create/append to `.env` carried alongside the Node recipe's plan. */
+interface EnvAction {
+    /** Absolute path to the `.env` file. */
+    targetPath: string;
+    /** The `CRUMBTRAIL_KEY=...` line to ensure is present. */
+    line: string;
+    /** Set when `.env` is not covered by `.gitignore` (key could get committed). */
+    gitignoreWarning?: string;
+}
+/**
+ * A fully-resolved, side-effect-free description of what injection would do.
+ * The executor turns this into filesystem writes; nothing here performs I/O.
+ */
+interface Plan {
+    recipe: Recipe;
+    kind: PlanKind;
+    /** Absolute path of the file to create/edit. null for skip/fallback plans. */
+    targetPath: string | null;
+    /**
+     * For `create`: the full file body. For `prepend`/`needs-confirm-dirty`: the
+     * block to prepend. null for skip/fallback plans.
+     */
+    content: string | null;
+    /** Non-fatal notes to surface to the user. */
+    warnings: string[];
+    /** fallback-ai: the ready-to-paste code snippet, key already filled in. */
+    snippet?: string;
+    /** fallback-ai: the `buildAgentPrompt` output for a coding agent. */
+    agentPrompt?: string;
+    /** Node recipe: the `.env` write to perform alongside the entry edit. */
+    envAction?: EnvAction;
+}
+
+interface GitTargetStatus {
+    /** false when `cwd` is not inside a git work tree. */
+    isRepo: boolean;
+    /** false for an untracked (never-committed) file. */
+    tracked: boolean;
+    /** true when the target has uncommitted changes or is untracked. */
+    dirty: boolean;
+}
+/** Read-only inspection surface consumed by the injection plan-builders. */
+interface InjectIO {
+    exists(p: string): boolean;
+    /** File contents, or null when it does not exist / cannot be read. */
+    readFile(p: string): string | null;
+    /** git porcelain status for a single target path. */
+    gitStatus(cwd: string, target: string): GitTargetStatus;
+    /** `.gitignore` contents at `cwd`, or null when absent. */
+    readGitignore(cwd: string): string | null;
+}
+/** The default real-filesystem + git implementation. */
+declare const defaultInjectIO: InjectIO;
+
+interface BuildPlanOptions {
+    /** Prepend into a dirty (uncommitted) target instead of asking to confirm. */
+    force?: boolean;
+}
+interface BuildPlanInput {
+    cwd: string;
+    recipe: Recipe;
+    endpoint: string;
+    apiKey: string;
+    /** Absolute entry path for vite-spa / node (from detection). */
+    entryFile?: string | null;
+    /** Raw `next` version range from detection (drives new-file vs legacy-prepend). */
+    nextVersion?: string | null;
+    /**
+     * The detected non-JS backend Stack for the `otlp` recipe (from
+     * `DetectResult.otlpStack`). Drives the guidance agent prompt; ignored for
+     * every other recipe.
+     */
+    stack?: Stack;
+    options?: BuildPlanOptions;
+}
+/**
+ * True when this package already depends on a Crumbtrail SDK. Load-bearing for
+ * the batch installer, which must decide whether to provision a service BEFORE
+ * it builds a plan — `buildPlan` uses this to self-cancel into
+ * `skip-already-wired`, so a re-run must not mint a second key for a service
+ * that is going to be skipped anyway.
+ */
+declare function projectAlreadyWired(cwd: string, io: InjectIO): boolean;
+/**
+ * `instrumentation-client.ts` is auto-loaded from Next 15.3+. Parse the leading
+ * numeric range; treat non-numeric ranges ("latest", "canary", workspace:) as
+ * new-enough.
+ */
+declare function supportsInstrumentationClient(version: string | null | undefined): boolean;
+/**
+ * Build the injection Plan for a detected recipe. Reads only (via `io`); the
+ * returned Plan is plain data the executor applies all-or-nothing.
+ */
+declare function buildPlan(input: BuildPlanInput, io?: InjectIO): Plan;
+
+/** Write boundary for the executor — swappable in tests. */
+interface ExecutorIO {
+    exists(p: string): boolean;
+    readFile(p: string): string | null;
+    writeFile(p: string, content: string): void;
+    mkdirp(dir: string): void;
+    remove(p: string): void;
+}
+declare const defaultExecutorIO: ExecutorIO;
+interface ExecuteOptions {
+    /** Apply a `needs-confirm-dirty` plan (the user confirmed / passed --force). */
+    confirmDirty?: boolean;
+}
+interface ExecuteResult {
+    kind: Plan["kind"];
+    /** Absolute paths actually written. */
+    written: string[];
+    /** True when nothing was written (skip / fallback / unconfirmed-dirty). */
+    skipped: boolean;
+    message: string;
+}
+/**
+ * Execute a Plan. skip/fallback plans (and unconfirmed dirty plans) perform no
+ * writes. create/prepend plans — plus any Node `.env` action — are applied
+ * all-or-nothing.
+ */
+declare function executePlan(plan: Plan, io?: ExecutorIO, options?: ExecuteOptions): ExecuteResult;
+
+export { type BuildPlanInput as B, type DetectResult as D, type EnvAction as E, type GitTargetStatus as G, type InjectIO as I, type PackageManager as P, type Recipe as R, type WorkspacePackage as W, type BuildPlanOptions as a, buildPlan as b, DENO_UNSUPPORTED_REASON as c, DOCKER_COMING_SOON_NOTE as d, executePlan as e, type ExecuteOptions as f, type ExecuteResult as g, type ExecutorIO as h, type Plan as i, type PlanKind as j, defaultExecutorIO as k, defaultInjectIO as l, detect as m, detectPackageManager as n, matchRecipe as o, parseNodeInvocation as p, parsePnpmWorkspace as q, projectAlreadyWired as r, resolveAngularEntry as s, resolveNestEntry as t, resolveOtlpStack as u, resolveReactNativeEntry as v, resolveRemixEntry as w, resolveViteEntry as x, supportsInstrumentationClient as y };

package/dist/executor-DKDrkhxM.d.ts

@@ -0,0 +1,279 @@
+import { Stack } from 'crumbtrail-design-system';
+
+/** 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";
+type PackageManager = "pnpm" | "yarn" | "bun" | "npm";
+interface WorkspacePackage {
+    /** package.json `name`, falling back to the directory basename. */
+    name: string;
+    /** Absolute path to the workspace package directory. */
+    dir: string;
+}
+interface DetectResult {
+    cwd: string;
+    packageJsonPath: string | null;
+    /** Winning recipe, or null when nothing matched. */
+    recipe: Recipe | null;
+    packageManager: PackageManager | null;
+    /**
+     * Absolute path to the file the recipe would edit (vite-spa / node), when it
+     * could be resolved with confidence. null for create-a-new-file recipes and
+     * whenever resolution was ambiguous.
+     */
+    entryFile: string | null;
+    /** Raw `next` version range from package.json, when the recipe is `next`. */
+    nextVersion: string | null;
+    /**
+     * The non-JS backend Stack resolved from filesystem markers when `recipe` is
+     * `"otlp"` (django/flask/fastapi/go/rails/dotnet). null for every other recipe.
+     * This is the ONE recipe that carries a variable Stack; call sites must prefer
+     * it over the static `RECIPE_REGISTRY["otlp"].stack` placeholder.
+     */
+    otlpStack: Stack | null;
+    isMonorepo: boolean;
+    /** Workspace packages when `isMonorepo` — the caller picks which app to wire. */
+    workspaces: WorkspacePackage[];
+    /**
+     * True when the caller must resolve a choice before injecting: monorepo root,
+     * no recipe matched, or the recipe's entry file could not be resolved.
+     */
+    ambiguous: boolean;
+    /** Human-readable trail of why detection landed where it did. */
+    reasons: string[];
+    /**
+     * Non-blocking, informational messages about the project that do NOT affect
+     * `recipe`/`ambiguous`/`isMonorepo`/`entryFile` — e.g. a "Docker files found,
+     * infra evidence sources coming soon" note. Kept separate from `reasons` (the
+     * detection trail); the caller surfaces these on both success and no-recipe
+     * paths without changing any outcome.
+     */
+    notes: string[];
+}
+interface PackageJson {
+    name?: string;
+    main?: string;
+    bin?: string | Record<string, string>;
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    workspaces?: string[] | {
+        packages?: string[];
+    };
+}
+/** Walk up from `startDir` to the filesystem root looking for a known lockfile. */
+declare function detectPackageManager(startDir: string): PackageManager | null;
+/** Extract the `packages:` list from a pnpm-workspace.yaml without a YAML dep. */
+declare function parsePnpmWorkspace(text: string): string[];
+/** Resolve the Vite entry from index.html's `<script type="module" src>` tag. */
+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.
+ */
+declare function resolveReactNativeEntry(cwd: string): string | null;
+/** Pull a node script/module path out of a `start`-style command. */
+declare function parseNodeInvocation(script: string): string | null;
+/**
+ * Resolve the NestJS injection entry. Nest's bootstrap lives at `src/main.ts`
+ * (or `src/main.js`); `resolveNodeEntry` cannot find it because the `start`
+ * script is `nest start` (not a bare node invocation) and `main` points at
+ * `dist/`. First existing file wins; null when neither exists (→ ambiguous).
+ */
+declare function resolveNestEntry(cwd: string): string | null;
+/**
+ * Resolve the Remix / React Router v7 hydration entry. Prefers
+ * `app/entry.client.{tsx,jsx,js}` in that order. Returns null when none exist —
+ * the recipe then FALLS BACK rather than creating one, because a bare init-only
+ * entry.client would omit hydrateRoot/<RemixBrowser> and break the app.
+ */
+declare function resolveRemixEntry(cwd: string): string | null;
+/**
+ * Resolve the Angular bootstrap entry — deterministically `src/main.ts`. Null
+ * when absent (→ ambiguous). Prepending an import + `Crumbtrail.init` above
+ * Angular's `bootstrapApplication`/`platformBrowserDynamic` call is safe.
+ */
+declare function resolveAngularEntry(cwd: string): string | null;
+/**
+ * Resolve a non-JS backend from filesystem markers — the `otlp` recipe's Stack.
+ * Filesystem-only: no code is executed; Python/Ruby manifests are parsed purely
+ * as text. Precedence is deliberate and documented:
+ *   1. `manage.py`                         → django
+ *   2. pyproject.toml/requirements.txt dep → fastapi (wins over flask if BOTH
+ *      tokens appear) else flask
+ *   3. `go.mod`                            → go
+ *   4. `Gemfile` referencing rails         → rails
+ *   5. any `*.csproj` in the root          → dotnet
+ * Returns null when no marker matches. Works with NO package.json present.
+ */
+declare function resolveOtlpStack(root: string): {
+    stack: Stack;
+    reason: string;
+} | null;
+/**
+ * Distinct `reasons` string pushed when a Deno project is detected (deno.json /
+ * deno.jsonc with no package.json). Exported so the wizard can recognize the
+ * signal and print a Deno-specific line instead of the generic unsupported hint.
+ */
+declare const DENO_UNSUPPORTED_REASON = "Deno projects aren't supported yet";
+/**
+ * Informational, non-blocking note emitted when Docker/Compose files are present.
+ * References that infra evidence sources (e.g. the `docker` stack in
+ * install-shared's INFRA_STACKS) are coming soon. NEVER affects recipe/ambiguity.
+ */
+declare const DOCKER_COMING_SOON_NOTE = "Docker/Compose files found \u2014 infra evidence sources (e.g. docker) are coming soon.";
+/** Inputs shared by every recipe matcher — filesystem-derived facts only. */
+interface MatchContext {
+    root: string;
+    deps: Record<string, string>;
+    pkg: PackageJson | null;
+    /** Matchers push their user-facing detection reasons here (side effect). */
+    reasons: string[];
+}
+/**
+ * Evaluate the ordered matcher ladder, returning the first match. When nothing
+ * matches, recipe is null with no entry/version. Reasons are recorded as a side
+ * effect on `ctx.reasons`, exactly as the original if/else chain did.
+ */
+declare function matchRecipe(ctx: MatchContext): {
+    recipe: Recipe | null;
+    entryFile: string | null;
+    nextVersion: string | null;
+    otlpStack: Stack | null;
+};
+/**
+ * Classify a single package directory. For a monorepo root this reports the
+ * workspace list and marks the result ambiguous — the caller picks a workspace
+ * and re-runs `detect` inside it.
+ */
+declare function detect(cwd: string): DetectResult;
+
+/** The shape of a plan the executor knows how to (or refuses to) apply. */
+type PlanKind = "create" | "prepend" | "skip-already-wired" | "needs-confirm-dirty" | "fallback-ai" | "otlp-guidance";
+/** A create/append to `.env` carried alongside the Node recipe's plan. */
+interface EnvAction {
+    /** Absolute path to the `.env` file. */
+    targetPath: string;
+    /** The `CRUMBTRAIL_KEY=...` line to ensure is present. */
+    line: string;
+    /** Set when `.env` is not covered by `.gitignore` (key could get committed). */
+    gitignoreWarning?: string;
+}
+/**
+ * A fully-resolved, side-effect-free description of what injection would do.
+ * The executor turns this into filesystem writes; nothing here performs I/O.
+ */
+interface Plan {
+    recipe: Recipe;
+    kind: PlanKind;
+    /** Absolute path of the file to create/edit. null for skip/fallback plans. */
+    targetPath: string | null;
+    /**
+     * For `create`: the full file body. For `prepend`/`needs-confirm-dirty`: the
+     * block to prepend. null for skip/fallback plans.
+     */
+    content: string | null;
+    /** Non-fatal notes to surface to the user. */
+    warnings: string[];
+    /** fallback-ai: the ready-to-paste code snippet, key already filled in. */
+    snippet?: string;
+    /** fallback-ai: the `buildAgentPrompt` output for a coding agent. */
+    agentPrompt?: string;
+    /** Node recipe: the `.env` write to perform alongside the entry edit. */
+    envAction?: EnvAction;
+}
+
+interface GitTargetStatus {
+    /** false when `cwd` is not inside a git work tree. */
+    isRepo: boolean;
+    /** false for an untracked (never-committed) file. */
+    tracked: boolean;
+    /** true when the target has uncommitted changes or is untracked. */
+    dirty: boolean;
+}
+/** Read-only inspection surface consumed by the injection plan-builders. */
+interface InjectIO {
+    exists(p: string): boolean;
+    /** File contents, or null when it does not exist / cannot be read. */
+    readFile(p: string): string | null;
+    /** git porcelain status for a single target path. */
+    gitStatus(cwd: string, target: string): GitTargetStatus;
+    /** `.gitignore` contents at `cwd`, or null when absent. */
+    readGitignore(cwd: string): string | null;
+}
+/** The default real-filesystem + git implementation. */
+declare const defaultInjectIO: InjectIO;
+
+interface BuildPlanOptions {
+    /** Prepend into a dirty (uncommitted) target instead of asking to confirm. */
+    force?: boolean;
+}
+interface BuildPlanInput {
+    cwd: string;
+    recipe: Recipe;
+    endpoint: string;
+    apiKey: string;
+    /** Absolute entry path for vite-spa / node (from detection). */
+    entryFile?: string | null;
+    /** Raw `next` version range from detection (drives new-file vs legacy-prepend). */
+    nextVersion?: string | null;
+    /**
+     * The detected non-JS backend Stack for the `otlp` recipe (from
+     * `DetectResult.otlpStack`). Drives the guidance agent prompt; ignored for
+     * every other recipe.
+     */
+    stack?: Stack;
+    options?: BuildPlanOptions;
+}
+/**
+ * True when this package already depends on a Crumbtrail SDK. Load-bearing for
+ * the batch installer, which must decide whether to provision a service BEFORE
+ * it builds a plan — `buildPlan` uses this to self-cancel into
+ * `skip-already-wired`, so a re-run must not mint a second key for a service
+ * that is going to be skipped anyway.
+ */
+declare function projectAlreadyWired(cwd: string, io: InjectIO): boolean;
+/**
+ * `instrumentation-client.ts` is auto-loaded from Next 15.3+. Parse the leading
+ * numeric range; treat non-numeric ranges ("latest", "canary", workspace:) as
+ * new-enough.
+ */
+declare function supportsInstrumentationClient(version: string | null | undefined): boolean;
+/**
+ * Build the injection Plan for a detected recipe. Reads only (via `io`); the
+ * returned Plan is plain data the executor applies all-or-nothing.
+ */
+declare function buildPlan(input: BuildPlanInput, io?: InjectIO): Plan;
+
+/** Write boundary for the executor — swappable in tests. */
+interface ExecutorIO {
+    exists(p: string): boolean;
+    readFile(p: string): string | null;
+    writeFile(p: string, content: string): void;
+    mkdirp(dir: string): void;
+    remove(p: string): void;
+}
+declare const defaultExecutorIO: ExecutorIO;
+interface ExecuteOptions {
+    /** Apply a `needs-confirm-dirty` plan (the user confirmed / passed --force). */
+    confirmDirty?: boolean;
+}
+interface ExecuteResult {
+    kind: Plan["kind"];
+    /** Absolute paths actually written. */
+    written: string[];
+    /** True when nothing was written (skip / fallback / unconfirmed-dirty). */
+    skipped: boolean;
+    message: string;
+}
+/**
+ * Execute a Plan. skip/fallback plans (and unconfirmed dirty plans) perform no
+ * writes. create/prepend plans — plus any Node `.env` action — are applied
+ * all-or-nothing.
+ */
+declare function executePlan(plan: Plan, io?: ExecutorIO, options?: ExecuteOptions): ExecuteResult;
+
+export { type BuildPlanInput as B, type DetectResult as D, type EnvAction as E, type GitTargetStatus as G, type InjectIO as I, type PackageManager as P, type Recipe as R, type WorkspacePackage as W, type BuildPlanOptions as a, buildPlan as b, DENO_UNSUPPORTED_REASON as c, DOCKER_COMING_SOON_NOTE as d, executePlan as e, type ExecuteOptions as f, type ExecuteResult as g, type ExecutorIO as h, type Plan as i, type PlanKind as j, defaultExecutorIO as k, defaultInjectIO as l, detect as m, detectPackageManager as n, matchRecipe as o, parseNodeInvocation as p, parsePnpmWorkspace as q, projectAlreadyWired as r, resolveAngularEntry as s, resolveNestEntry as t, resolveOtlpStack as u, resolveReactNativeEntry as v, resolveRemixEntry as w, resolveViteEntry as x, supportsInstrumentationClient as y };