@parlor/scaffold 0.0.0-stage → 0.2.0

package/dist/add/run.js

@@ -0,0 +1,167 @@
+import { indentLines } from "../edit/ops.js";
+import { projectFiles, templateFiles, writeFiles } from "../files.js";
+import { uncommittedChanges } from "../git.js";
+import { commandsFor, formatCommand } from "../package-manager.js";
+import { planAddons } from "./plan.js";
+import { commitStaging, discardStaging, generateInStaging, installDependencies, pendingInstallCommands, restoreManifests, snapshotManifests, stageProject, } from "./transaction.js";
+/**
+ * The one entry point behind `parlor add`. A transaction in stages, so a failure never leaves
+ * an app that cannot boot and a crash is finished by the next run (every step it already did
+ * is `done`):
+ *   1. plan (no writes); `blocked`, `done` and `dry-run` return here
+ *   2. git: `uncommittedChanges(rootDir)` non-empty and `gitCheck` -> `dirty`
+ *   3. install: snapshot `package.json` and the lockfile; round one adds every dependency whose
+ *      version is known (`<pm> add`), round two resolves each `FromPackage` from the manifest
+ *      round one installed and adds those; any failure restores the snapshot -> `failed`
+ *   4. stage: `stageProject` copies the tree (minus node_modules, .git, .parlor) into
+ *      `.parlor/add/<run id>/` and lays the planned writes over it
+ *   5. generate: each pending generation's tool runs in the staging dir; `generationDone`
+ *      against the staging copy must then hold, else the copy is discarded -> `failed`
+ *   6. commit: every staged file whose bytes differ from the project is written through a temp
+ *      file and a rename; the staging dir is removed
+ * `install: false` skips 3 and 5; `pending` then names the install commands and a second
+ * `parlor add` to generate.
+ */
+export async function addAddons(request) {
+    const { layout, addons, packageManager, log } = request;
+    const { rootDir } = layout;
+    const plan = await planAddons(layout, addons, projectFiles(rootDir), templateFiles());
+    if (plan.kind === "done")
+        return plan;
+    if (plan.kind === "blocked")
+        return { kind: "blocked", addons, manual: plan.manual };
+    if (request.mode === "dry-run")
+        return { kind: "planned", plan };
+    if (request.gitCheck) {
+        const files = await uncommittedChanges(rootDir);
+        if (files && files.length > 0)
+            return { kind: "dirty", addons, files };
+    }
+    if (!request.install) {
+        await writeFiles(rootDir, new Map(plan.writes.map((write) => [write.path, write.content])));
+        const pm = commandsFor(packageManager);
+        const rerun = plan.generate.length > 0 ||
+            plan.dependencies.some((dependency) => typeof dependency.version !== "string");
+        return {
+            kind: "applied",
+            plan,
+            generated: [],
+            pending: [
+                ...pendingInstallCommands(plan.dependencies, packageManager).map(formatCommand),
+                ...(rerun ? [pm.exec("parlor", ["add", ...addons])] : []),
+            ],
+        };
+    }
+    let snapshot;
+    if (plan.dependencies.length > 0) {
+        snapshot = await snapshotManifests(rootDir);
+        const installed = await installDependencies(rootDir, plan.dependencies, packageManager, projectFiles(rootDir), log);
+        if (!installed.ok) {
+            await restoreManifests(rootDir, snapshot);
+            return { kind: "failed", addons, stage: "install", message: installed.message };
+        }
+    }
+    const staging = await stageProject(rootDir, plan.writes);
+    if (plan.generate.length > 0) {
+        log(`generating ${plan.generate
+            .map((generation) => generation.kind === "route-tree"
+            ? "the route tree"
+            : `the migration "${generation.name}"`)
+            .join(", then ")}`);
+        const generated = await generateInStaging(layout, staging, plan.generate, request.tools);
+        if (!generated.ok) {
+            await discardStaging(staging);
+            if (snapshot)
+                await restoreManifests(rootDir, snapshot);
+            return { kind: "failed", addons, stage: "generate", message: generated.message };
+        }
+    }
+    const written = await commitStaging(rootDir, staging);
+    const planned = new Set(plan.writes.map((write) => write.path));
+    return {
+        kind: "applied",
+        plan,
+        generated: written.filter((path) => !planned.has(path)),
+        pending: [],
+    };
+}
+function planLines(plan, generated) {
+    const width = Math.max(0, ...plan.writes
+        .filter((write) => write.change === "update")
+        .map((write) => write.path.length));
+    return [
+        ...plan.writes
+            .filter((write) => write.change === "create")
+            .map((write) => `+ ${write.path}`),
+        ...plan.writes
+            .filter((write) => write.change === "update")
+            .map((write) => write.summary.length > 0
+            ? `~ ${write.path.padEnd(width)}  ${write.summary.join(", ")}`
+            : `~ ${write.path}`),
+        ...(generated.length > 0 ? [`~ ${generated.join(", ")}`] : []),
+    ];
+}
+/** The terminal text for a result and the exit code: 1 for `blocked`, `dirty` and `failed`, else 0. */
+export function formatAddResult(result, manager) {
+    const pm = commandsFor(manager);
+    const command = (addons) => `parlor add ${addons.join(" ")}`;
+    switch (result.kind) {
+        case "done":
+            return {
+                text: `${result.addons.join(", ")} ${result.addons.length === 1 ? "is" : "are"} already added. Nothing changed.`,
+                exitCode: 0,
+            };
+        case "blocked": {
+            const files = [...new Set(result.manual.map((change) => change.file))];
+            const rerun = pm.exec("parlor", ["add", ...result.addons]);
+            return {
+                text: [
+                    `${command(result.addons)}: cannot edit ${files.join(", ")} safely, so nothing was changed.`,
+                    ...result.manual.flatMap((change) => [
+                        "",
+                        `  ${change.file}: ${change.reason}`,
+                        `  Make this change by hand, then run \`${rerun}\` again:`,
+                        "",
+                        indentLines(change.change, "    "),
+                    ]),
+                ].join("\n"),
+                exitCode: 1,
+            };
+        }
+        case "dirty":
+            return {
+                text: `${command(result.addons)}: this project has uncommitted changes (${result.files.join(", ")}).\nCommit or stash them so the change is easy to review, or pass --no-git-check.`,
+                exitCode: 1,
+            };
+        case "failed":
+            return {
+                text: `${command(result.addons)}: ${result.message}\nNothing was changed.`,
+                exitCode: 1,
+            };
+        case "planned": {
+            const installs = result.plan.dependencies.map((dependency) => typeof dependency.version === "string"
+                ? `${dependency.name}@${dependency.version}`
+                : `${dependency.name} (pinned by ${dependency.version.fromPackage})`);
+            return {
+                text: [
+                    ...planLines(result.plan, []),
+                    ...(installs.length > 0 ? [`would install ${installs.join(", ")}`] : []),
+                    "Nothing was written (--dry-run).",
+                ].join("\n"),
+                exitCode: 0,
+            };
+        }
+        case "applied":
+            return {
+                text: [
+                    ...planLines(result.plan, result.generated),
+                    ...result.plan.notes,
+                    ...(result.pending.length > 0
+                        ? ["", "Run these to finish:", ...result.pending.map((line) => `  ${line}`)]
+                        : []),
+                ].join("\n"),
+                exitCode: 0,
+            };
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/add/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/add/run.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AddonName } from \"../addons/index.js\";\nimport { indentLines } from \"../edit/ops.js\";\nimport { projectFiles, templateFiles, writeFiles } from \"../files.js\";\nimport { uncommittedChanges } from \"../git.js\";\nimport { commandsFor, formatCommand, type PackageManager } from \"../package-manager.js\";\nimport type { ProjectLayout } from \"./addon.js\";\nimport { type AddPlan, type ManualChange, planAddons } from \"./plan.js\";\nimport {\n  commitStaging,\n  discardStaging,\n  generateInStaging,\n  installDependencies,\n  type ManifestSnapshot,\n  pendingInstallCommands,\n  restoreManifests,\n  snapshotManifests,\n  stageProject,\n} from \"./transaction.js\";\n\n/**\n * The framework tools a run needs after files are staged. `parlor add` passes the same code\n * `parlor typegen` and `parlor db generate` run, so this package stays free of the toolchain.\n * Each takes the directory to run in, because the transaction runs them against the staging\n * copy, never against the project.\n */\nexport interface AddTools {\n  routeTree(rootDir: string): Promise<void>;\n  migration(rootDir: string, name: string): Promise<void>;\n}\n\nexport interface AddRequest {\n  readonly layout: ProjectLayout;\n  readonly addons: readonly AddonName[];\n  readonly packageManager: PackageManager;\n  readonly tools: AddTools;\n  /** `dry-run` plans and reports without writing or installing. */\n  readonly mode: \"apply\" | \"dry-run\";\n  /** `false` (`--no-install`) writes files only and reports the install and generate commands. */\n  readonly install: boolean;\n  /** `false` (`--no-git-check`) skips the refusal on uncommitted changes. */\n  readonly gitCheck: boolean;\n  readonly log: (line: string) => void;\n}\n\ntype ReadyPlan = Extract<AddPlan, { kind: \"ready\" }>;\n\nexport type AddResult =\n  | { readonly kind: \"done\"; readonly addons: readonly AddonName[] }\n  | {\n      readonly kind: \"blocked\";\n      readonly addons: readonly AddonName[];\n      readonly manual: readonly ManualChange[];\n    }\n  | { readonly kind: \"planned\"; readonly plan: ReadyPlan }\n  /** The project has uncommitted changes and `gitCheck` is on: nothing was touched. */\n  | {\n      readonly kind: \"dirty\";\n      readonly addons: readonly AddonName[];\n      readonly files: readonly string[];\n    }\n  /** `pending` lists commands skipped by `--no-install`, to run before the next `parlor dev`. */\n  | {\n      readonly kind: \"applied\";\n      readonly plan: ReadyPlan;\n      /** Files the generators wrote, beyond the plan's own writes. */\n      readonly generated: readonly string[];\n      readonly pending: readonly string[];\n    }\n  /**\n   * Nothing reached the project: a failed install restored `package.json` and the lockfile; a\n   * failed or unvalidated generation discarded the staging copy and restored them too. Only\n   * `node_modules` may hold more than before, which is a cache, not state.\n   */\n  | {\n      readonly kind: \"failed\";\n      readonly addons: readonly AddonName[];\n      readonly stage: \"install\" | \"generate\";\n      readonly message: string;\n    };\n\n/**\n * The one entry point behind `parlor add`. A transaction in stages, so a failure never leaves\n * an app that cannot boot and a crash is finished by the next run (every step it already did\n * is `done`):\n *   1. plan (no writes); `blocked`, `done` and `dry-run` return here\n *   2. git: `uncommittedChanges(rootDir)` non-empty and `gitCheck` -> `dirty`\n *   3. install: snapshot `package.json` and the lockfile; round one adds every dependency whose\n *      version is known (`<pm> add`), round two resolves each `FromPackage` from the manifest\n *      round one installed and adds those; any failure restores the snapshot -> `failed`\n *   4. stage: `stageProject` copies the tree (minus node_modules, .git, .parlor) into\n *      `.parlor/add/<run id>/` and lays the planned writes over it\n *   5. generate: each pending generation's tool runs in the staging dir; `generationDone`\n *      against the staging copy must then hold, else the copy is discarded -> `failed`\n *   6. commit: every staged file whose bytes differ from the project is written through a temp\n *      file and a rename; the staging dir is removed\n * `install: false` skips 3 and 5; `pending` then names the install commands and a second\n * `parlor add` to generate.\n */\nexport async function addAddons(request: AddRequest): Promise<AddResult> {\n  const { layout, addons, packageManager, log } = request;\n  const { rootDir } = layout;\n  const plan = await planAddons(layout, addons, projectFiles(rootDir), templateFiles());\n  if (plan.kind === \"done\") return plan;\n  if (plan.kind === \"blocked\") return { kind: \"blocked\", addons, manual: plan.manual };\n  if (request.mode === \"dry-run\") return { kind: \"planned\", plan };\n  if (request.gitCheck) {\n    const files = await uncommittedChanges(rootDir);\n    if (files && files.length > 0) return { kind: \"dirty\", addons, files };\n  }\n  if (!request.install) {\n    await writeFiles(\n      rootDir,\n      new Map(plan.writes.map((write) => [write.path, write.content])),\n    );\n    const pm = commandsFor(packageManager);\n    const rerun =\n      plan.generate.length > 0 ||\n      plan.dependencies.some((dependency) => typeof dependency.version !== \"string\");\n    return {\n      kind: \"applied\",\n      plan,\n      generated: [],\n      pending: [\n        ...pendingInstallCommands(plan.dependencies, packageManager).map(formatCommand),\n        ...(rerun ? [pm.exec(\"parlor\", [\"add\", ...addons])] : []),\n      ],\n    };\n  }\n  let snapshot: ManifestSnapshot | undefined;\n  if (plan.dependencies.length > 0) {\n    snapshot = await snapshotManifests(rootDir);\n    const installed = await installDependencies(\n      rootDir,\n      plan.dependencies,\n      packageManager,\n      projectFiles(rootDir),\n      log,\n    );\n    if (!installed.ok) {\n      await restoreManifests(rootDir, snapshot);\n      return { kind: \"failed\", addons, stage: \"install\", message: installed.message };\n    }\n  }\n  const staging = await stageProject(rootDir, plan.writes);\n  if (plan.generate.length > 0) {\n    log(\n      `generating ${plan.generate\n        .map((generation) =>\n          generation.kind === \"route-tree\"\n            ? \"the route tree\"\n            : `the migration \"${generation.name}\"`,\n        )\n        .join(\", then \")}`,\n    );\n    const generated = await generateInStaging(\n      layout,\n      staging,\n      plan.generate,\n      request.tools,\n    );\n    if (!generated.ok) {\n      await discardStaging(staging);\n      if (snapshot) await restoreManifests(rootDir, snapshot);\n      return { kind: \"failed\", addons, stage: \"generate\", message: generated.message };\n    }\n  }\n  const written = await commitStaging(rootDir, staging);\n  const planned = new Set(plan.writes.map((write) => write.path));\n  return {\n    kind: \"applied\",\n    plan,\n    generated: written.filter((path) => !planned.has(path)),\n    pending: [],\n  };\n}\n\nfunction planLines(plan: ReadyPlan, generated: readonly string[]): string[] {\n  const width = Math.max(\n    0,\n    ...plan.writes\n      .filter((write) => write.change === \"update\")\n      .map((write) => write.path.length),\n  );\n  return [\n    ...plan.writes\n      .filter((write) => write.change === \"create\")\n      .map((write) => `+ ${write.path}`),\n    ...plan.writes\n      .filter((write) => write.change === \"update\")\n      .map((write) =>\n        write.summary.length > 0\n          ? `~ ${write.path.padEnd(width)}  ${write.summary.join(\", \")}`\n          : `~ ${write.path}`,\n      ),\n    ...(generated.length > 0 ? [`~ ${generated.join(\", \")}`] : []),\n  ];\n}\n\n/** The terminal text for a result and the exit code: 1 for `blocked`, `dirty` and `failed`, else 0. */\nexport function formatAddResult(\n  result: AddResult,\n  manager: PackageManager,\n): { readonly text: string; readonly exitCode: 0 | 1 } {\n  const pm = commandsFor(manager);\n  const command = (addons: readonly AddonName[]) => `parlor add ${addons.join(\" \")}`;\n  switch (result.kind) {\n    case \"done\":\n      return {\n        text: `${result.addons.join(\", \")} ${result.addons.length === 1 ? \"is\" : \"are\"} already added. Nothing changed.`,\n        exitCode: 0,\n      };\n    case \"blocked\": {\n      const files = [...new Set(result.manual.map((change) => change.file))];\n      const rerun = pm.exec(\"parlor\", [\"add\", ...result.addons]);\n      return {\n        text: [\n          `${command(result.addons)}: cannot edit ${files.join(\", \")} safely, so nothing was changed.`,\n          ...result.manual.flatMap((change) => [\n            \"\",\n            `  ${change.file}: ${change.reason}`,\n            `  Make this change by hand, then run \\`${rerun}\\` again:`,\n            \"\",\n            indentLines(change.change, \"    \"),\n          ]),\n        ].join(\"\\n\"),\n        exitCode: 1,\n      };\n    }\n    case \"dirty\":\n      return {\n        text: `${command(result.addons)}: this project has uncommitted changes (${result.files.join(\", \")}).\\nCommit or stash them so the change is easy to review, or pass --no-git-check.`,\n        exitCode: 1,\n      };\n    case \"failed\":\n      return {\n        text: `${command(result.addons)}: ${result.message}\\nNothing was changed.`,\n        exitCode: 1,\n      };\n    case \"planned\": {\n      const installs = result.plan.dependencies.map((dependency) =>\n        typeof dependency.version === \"string\"\n          ? `${dependency.name}@${dependency.version}`\n          : `${dependency.name} (pinned by ${dependency.version.fromPackage})`,\n      );\n      return {\n        text: [\n          ...planLines(result.plan, []),\n          ...(installs.length > 0 ? [`would install ${installs.join(\", \")}`] : []),\n          \"Nothing was written (--dry-run).\",\n        ].join(\"\\n\"),\n        exitCode: 0,\n      };\n    }\n    case \"applied\":\n      return {\n        text: [\n          ...planLines(result.plan, result.generated),\n          ...result.plan.notes,\n          ...(result.pending.length > 0\n            ? [\"\", \"Run these to finish:\", ...result.pending.map((line) => `  ${line}`)]\n            : []),\n        ].join(\"\\n\"),\n        exitCode: 0,\n      };\n  }\n}\n"]}

package/dist/add/transaction.d.ts

@@ -0,0 +1,67 @@
+import { type Command, type InstallOutcome, type PackageManager } from "../package-manager.js";
+import type { Generation, ProjectLayout } from "./addon.js";
+import { type PlannedDependency, type PlannedWrite, type ProjectFiles } from "./plan.js";
+import type { AddTools } from "./run.js";
+/** Under `.parlor/`, which every project ignores, so a crash leaves nothing a commit would pick up. */
+export declare const STAGING_DIR = ".parlor/add";
+/** Never copied into a staging dir and never committed back from one. */
+export declare const NOT_STAGED: ReadonlySet<string>;
+/** `package.json` plus whichever lockfile the project has, as they were before the install. */
+export interface ManifestSnapshot {
+    readonly files: ReadonlyMap<string, Buffer | undefined>;
+}
+export declare const LOCKFILES: readonly ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lock", "bun.lockb"];
+export declare function snapshotManifests(rootDir: string): Promise<ManifestSnapshot>;
+/** Puts every snapshotted file back, deleting the ones that did not exist. */
+export declare function restoreManifests(rootDir: string, snapshot: ManifestSnapshot): Promise<void>;
+export type InstallResult = {
+    readonly ok: true;
+    readonly outcome: InstallOutcome;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/**
+ * Two rounds of `<pm> add`, because a `FromPackage` version is readable only once that package
+ * is in `node_modules`: round one adds every dependency with a known version, round two reads
+ * each `FromPackage` through `project.manifest` and adds those. A `listed` dependency with no
+ * known version is a plain `<pm> install`. Nothing here touches files other than the ones the
+ * package manager owns.
+ */
+export declare function installDependencies(rootDir: string, dependencies: readonly PlannedDependency[], manager: PackageManager, project: ProjectFiles, log: (line: string) => void): Promise<InstallResult>;
+/** The install commands `--no-install` left for the developer, in the order to run them. */
+export declare function pendingInstallCommands(dependencies: readonly PlannedDependency[], manager: PackageManager): readonly Command[];
+export interface Staging {
+    /** Absolute: `<rootDir>/.parlor/add/<run id>`. */
+    readonly dir: string;
+    /** A `ProjectFiles` over `dir`, for `generationDone` and the commit diff. */
+    readonly files: ProjectFiles;
+}
+/**
+ * Copies the project tree except `NOT_STAGED` into a fresh staging dir and lays `writes` over
+ * it. Module resolution from the staging dir walks up to the project's `node_modules`, so the
+ * generators run there unchanged.
+ */
+export declare function stageProject(rootDir: string, writes: readonly PlannedWrite[]): Promise<Staging>;
+export type GenerateResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly generation: Generation;
+    readonly message: string;
+};
+/**
+ * Runs each generation's tool in the staging dir, then checks `generationDone` there. A tool
+ * that throws, or whose declared outputs are not in the copy afterwards, fails the whole run
+ * before anything reaches the project.
+ */
+export declare function generateInStaging(layout: ProjectLayout, staging: Staging, generations: readonly Generation[], tools: AddTools): Promise<GenerateResult>;
+/**
+ * Every file in the staging dir whose bytes differ from the project's is written through
+ * `<path>.parlor-tmp` and a rename, then the staging dir is removed. Returns the project paths
+ * written. A crash between two renames leaves whole files, and the next run's plan finds each
+ * written step `done`.
+ */
+export declare function commitStaging(rootDir: string, staging: Staging): Promise<readonly string[]>;
+export declare function discardStaging(staging: Staging): Promise<void>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/add/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/add/transaction.ts"],"names":[],"mappings":"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"}

package/dist/add/transaction.js

@@ -0,0 +1,181 @@
+import { randomUUID } from "node:crypto";
+import { cp, mkdir, readdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { projectFiles } from "../files.js";
+import { commandsFor, formatCommand, runInstall, } from "../package-manager.js";
+import { generationDone, resolveFromPackage, } from "./plan.js";
+/** Under `.parlor/`, which every project ignores, so a crash leaves nothing a commit would pick up. */
+export const STAGING_DIR = ".parlor/add";
+/** Never copied into a staging dir and never committed back from one. */
+export const NOT_STAGED = new Set([
+    "node_modules",
+    ".git",
+    ".parlor",
+]);
+export const LOCKFILES = [
+    "pnpm-lock.yaml",
+    "package-lock.json",
+    "yarn.lock",
+    "bun.lock",
+    "bun.lockb",
+];
+export async function snapshotManifests(rootDir) {
+    const files = new Map();
+    for (const name of ["package.json", ...LOCKFILES]) {
+        files.set(name, await readFile(join(rootDir, name)).catch(() => undefined));
+    }
+    return { files };
+}
+/** Puts every snapshotted file back, deleting the ones that did not exist. */
+export async function restoreManifests(rootDir, snapshot) {
+    for (const [name, content] of snapshot.files) {
+        const path = join(rootDir, name);
+        if (content === undefined)
+            await rm(path, { force: true });
+        else
+            await writeFile(path, content);
+    }
+}
+/**
+ * Two rounds of `<pm> add`, because a `FromPackage` version is readable only once that package
+ * is in `node_modules`: round one adds every dependency with a known version, round two reads
+ * each `FromPackage` through `project.manifest` and adds those. A `listed` dependency with no
+ * known version is a plain `<pm> install`. Nothing here touches files other than the ones the
+ * package manager owns.
+ */
+export async function installDependencies(rootDir, dependencies, manager, project, log) {
+    const add = commandsFor(manager).add;
+    let outcome = { kind: "installed" };
+    const round = async (resolved) => {
+        for (const dev of [false, true]) {
+            const group = resolved.filter((dependency) => dependency.dev === dev);
+            if (group.length === 0)
+                continue;
+            const command = add(group.map((dependency) => `${dependency.name}@${dependency.version}`), { dev });
+            const result = await runInstall(rootDir, command, log);
+            if (result.kind === "failed") {
+                return {
+                    ok: false,
+                    message: `${formatCommand(command)} failed (exit ${result.exitCode}).`,
+                };
+            }
+            if (result.kind === "ignored-builds")
+                outcome = result;
+        }
+        return undefined;
+    };
+    const known = dependencies.filter((dependency) => typeof dependency.version === "string");
+    if (known.length > 0) {
+        log(`installing ${known.map((dependency) => `${dependency.name}@${dependency.version}`).join(", ")}`);
+        const failed = await round(known);
+        if (failed)
+            return failed;
+    }
+    const pinned = [];
+    for (const dependency of dependencies) {
+        if (typeof dependency.version === "string")
+            continue;
+        const version = await resolveFromPackage(dependency.version, project);
+        if (version === undefined) {
+            return {
+                ok: false,
+                message: `${dependency.version.fromPackage} does not declare ${dependency.version.dependency}`,
+            };
+        }
+        log(`installing ${dependency.name}@${version} (pinned by ${dependency.version.fromPackage})`);
+        pinned.push({ ...dependency, version });
+    }
+    const failed = await round(pinned);
+    return failed ?? { ok: true, outcome };
+}
+/** The install commands `--no-install` left for the developer, in the order to run them. */
+export function pendingInstallCommands(dependencies, manager) {
+    const add = commandsFor(manager).add;
+    return [false, true].flatMap((dev) => {
+        const group = dependencies.filter((dependency) => dependency.dev === dev && typeof dependency.version === "string");
+        return group.length === 0
+            ? []
+            : [
+                add(group.map((dependency) => `${dependency.name}@${String(dependency.version)}`), { dev }),
+            ];
+    });
+}
+/**
+ * Copies the project tree except `NOT_STAGED` into a fresh staging dir and lays `writes` over
+ * it. Module resolution from the staging dir walks up to the project's `node_modules`, so the
+ * generators run there unchanged.
+ */
+export async function stageProject(rootDir, writes) {
+    const dir = join(rootDir, STAGING_DIR, randomUUID());
+    await mkdir(dir, { recursive: true });
+    for (const entry of await readdir(rootDir)) {
+        if (NOT_STAGED.has(entry))
+            continue;
+        await cp(join(rootDir, entry), join(dir, entry), { recursive: true });
+    }
+    for (const write of writes) {
+        const target = join(dir, write.path);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, write.content);
+    }
+    return { dir, files: projectFiles(dir) };
+}
+/**
+ * Runs each generation's tool in the staging dir, then checks `generationDone` there. A tool
+ * that throws, or whose declared outputs are not in the copy afterwards, fails the whole run
+ * before anything reaches the project.
+ */
+export async function generateInStaging(layout, staging, generations, tools) {
+    for (const generation of generations) {
+        const tool = generation.kind === "route-tree" ? "parlor typegen" : "parlor db generate";
+        try {
+            if (generation.kind === "route-tree")
+                await tools.routeTree(staging.dir);
+            else
+                await tools.migration(staging.dir, generation.name);
+        }
+        catch (error) {
+            return {
+                ok: false,
+                generation,
+                message: `${tool} failed: ${error.message}`,
+            };
+        }
+        if (!(await generationDone({ ...layout, rootDir: staging.dir }, generation, staging.files))) {
+            return {
+                ok: false,
+                generation,
+                message: generation.kind === "route-tree"
+                    ? `${tool} wrote no route ${generation.routes.join(", ")}`
+                    : `${tool} wrote no migration with tables ${generation.tables.join(", ")}`,
+            };
+        }
+    }
+    return { ok: true };
+}
+/**
+ * Every file in the staging dir whose bytes differ from the project's is written through
+ * `<path>.parlor-tmp` and a rename, then the staging dir is removed. Returns the project paths
+ * written. A crash between two renames leaves whole files, and the next run's plan finds each
+ * written step `done`.
+ */
+export async function commitStaging(rootDir, staging) {
+    const written = [];
+    for (const path of await staging.files.list("")) {
+        const staged = await readFile(join(staging.dir, path));
+        const current = await readFile(join(rootDir, path)).catch(() => undefined);
+        if (current?.equals(staged))
+            continue;
+        const target = join(rootDir, path);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(`${target}.parlor-tmp`, staged);
+        await rename(`${target}.parlor-tmp`, target);
+        written.push(path);
+    }
+    await discardStaging(staging);
+    return written;
+}
+export async function discardStaging(staging) {
+    await rm(staging.dir, { recursive: true, force: true });
+}
+//# sourceMappingURL=transaction.js.map

package/dist/add/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/add/transaction.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { cp, mkdir, readdir, readFile, rename, rm, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\n\nimport { projectFiles } from \"../files.js\";\nimport {\n  type Command,\n  commandsFor,\n  formatCommand,\n  type InstallOutcome,\n  type PackageManager,\n  runInstall,\n} from \"../package-manager.js\";\nimport type { Generation, ProjectLayout } from \"./addon.js\";\nimport {\n  generationDone,\n  type PlannedDependency,\n  type PlannedWrite,\n  type ProjectFiles,\n  resolveFromPackage,\n} from \"./plan.js\";\nimport type { AddTools } from \"./run.js\";\n\n/** Under `.parlor/`, which every project ignores, so a crash leaves nothing a commit would pick up. */\nexport const STAGING_DIR = \".parlor/add\";\n\n/** Never copied into a staging dir and never committed back from one. */\nexport const NOT_STAGED: ReadonlySet<string> = new Set([\n  \"node_modules\",\n  \".git\",\n  \".parlor\",\n]);\n\n/** `package.json` plus whichever lockfile the project has, as they were before the install. */\nexport interface ManifestSnapshot {\n  readonly files: ReadonlyMap<string, Buffer | undefined>;\n}\n\nexport const LOCKFILES = [\n  \"pnpm-lock.yaml\",\n  \"package-lock.json\",\n  \"yarn.lock\",\n  \"bun.lock\",\n  \"bun.lockb\",\n] as const;\n\nexport async function snapshotManifests(rootDir: string): Promise<ManifestSnapshot> {\n  const files = new Map<string, Buffer | undefined>();\n  for (const name of [\"package.json\", ...LOCKFILES]) {\n    files.set(name, await readFile(join(rootDir, name)).catch(() => undefined));\n  }\n  return { files };\n}\n\n/** Puts every snapshotted file back, deleting the ones that did not exist. */\nexport async function restoreManifests(\n  rootDir: string,\n  snapshot: ManifestSnapshot,\n): Promise<void> {\n  for (const [name, content] of snapshot.files) {\n    const path = join(rootDir, name);\n    if (content === undefined) await rm(path, { force: true });\n    else await writeFile(path, content);\n  }\n}\n\nexport type InstallResult =\n  | { readonly ok: true; readonly outcome: InstallOutcome }\n  | { readonly ok: false; readonly message: string };\n\n/**\n * Two rounds of `<pm> add`, because a `FromPackage` version is readable only once that package\n * is in `node_modules`: round one adds every dependency with a known version, round two reads\n * each `FromPackage` through `project.manifest` and adds those. A `listed` dependency with no\n * known version is a plain `<pm> install`. Nothing here touches files other than the ones the\n * package manager owns.\n */\nexport async function installDependencies(\n  rootDir: string,\n  dependencies: readonly PlannedDependency[],\n  manager: PackageManager,\n  project: ProjectFiles,\n  log: (line: string) => void,\n): Promise<InstallResult> {\n  const add = commandsFor(manager).add;\n  let outcome: InstallOutcome = { kind: \"installed\" };\n  const round = async (\n    resolved: readonly (PlannedDependency & { readonly version: string })[],\n  ): Promise<InstallResult | undefined> => {\n    for (const dev of [false, true]) {\n      const group = resolved.filter((dependency) => dependency.dev === dev);\n      if (group.length === 0) continue;\n      const command = add(\n        group.map((dependency) => `${dependency.name}@${dependency.version}`),\n        { dev },\n      );\n      const result = await runInstall(rootDir, command, log);\n      if (result.kind === \"failed\") {\n        return {\n          ok: false,\n          message: `${formatCommand(command)} failed (exit ${result.exitCode}).`,\n        };\n      }\n      if (result.kind === \"ignored-builds\") outcome = result;\n    }\n    return undefined;\n  };\n  const known = dependencies.filter(\n    (dependency): dependency is PlannedDependency & { readonly version: string } =>\n      typeof dependency.version === \"string\",\n  );\n  if (known.length > 0) {\n    log(\n      `installing ${known.map((dependency) => `${dependency.name}@${dependency.version}`).join(\", \")}`,\n    );\n    const failed = await round(known);\n    if (failed) return failed;\n  }\n  const pinned: (PlannedDependency & { readonly version: string })[] = [];\n  for (const dependency of dependencies) {\n    if (typeof dependency.version === \"string\") continue;\n    const version = await resolveFromPackage(dependency.version, project);\n    if (version === undefined) {\n      return {\n        ok: false,\n        message: `${dependency.version.fromPackage} does not declare ${dependency.version.dependency}`,\n      };\n    }\n    log(\n      `installing ${dependency.name}@${version} (pinned by ${dependency.version.fromPackage})`,\n    );\n    pinned.push({ ...dependency, version });\n  }\n  const failed = await round(pinned);\n  return failed ?? { ok: true, outcome };\n}\n\n/** The install commands `--no-install` left for the developer, in the order to run them. */\nexport function pendingInstallCommands(\n  dependencies: readonly PlannedDependency[],\n  manager: PackageManager,\n): readonly Command[] {\n  const add = commandsFor(manager).add;\n  return [false, true].flatMap((dev) => {\n    const group = dependencies.filter(\n      (dependency) => dependency.dev === dev && typeof dependency.version === \"string\",\n    );\n    return group.length === 0\n      ? []\n      : [\n          add(\n            group.map((dependency) => `${dependency.name}@${String(dependency.version)}`),\n            { dev },\n          ),\n        ];\n  });\n}\n\nexport interface Staging {\n  /** Absolute: `<rootDir>/.parlor/add/<run id>`. */\n  readonly dir: string;\n  /** A `ProjectFiles` over `dir`, for `generationDone` and the commit diff. */\n  readonly files: ProjectFiles;\n}\n\n/**\n * Copies the project tree except `NOT_STAGED` into a fresh staging dir and lays `writes` over\n * it. Module resolution from the staging dir walks up to the project's `node_modules`, so the\n * generators run there unchanged.\n */\nexport async function stageProject(\n  rootDir: string,\n  writes: readonly PlannedWrite[],\n): Promise<Staging> {\n  const dir = join(rootDir, STAGING_DIR, randomUUID());\n  await mkdir(dir, { recursive: true });\n  for (const entry of await readdir(rootDir)) {\n    if (NOT_STAGED.has(entry)) continue;\n    await cp(join(rootDir, entry), join(dir, entry), { recursive: true });\n  }\n  for (const write of writes) {\n    const target = join(dir, write.path);\n    await mkdir(dirname(target), { recursive: true });\n    await writeFile(target, write.content);\n  }\n  return { dir, files: projectFiles(dir) };\n}\n\nexport type GenerateResult =\n  | { readonly ok: true }\n  | { readonly ok: false; readonly generation: Generation; readonly message: string };\n\n/**\n * Runs each generation's tool in the staging dir, then checks `generationDone` there. A tool\n * that throws, or whose declared outputs are not in the copy afterwards, fails the whole run\n * before anything reaches the project.\n */\nexport async function generateInStaging(\n  layout: ProjectLayout,\n  staging: Staging,\n  generations: readonly Generation[],\n  tools: AddTools,\n): Promise<GenerateResult> {\n  for (const generation of generations) {\n    const tool =\n      generation.kind === \"route-tree\" ? \"parlor typegen\" : \"parlor db generate\";\n    try {\n      if (generation.kind === \"route-tree\") await tools.routeTree(staging.dir);\n      else await tools.migration(staging.dir, generation.name);\n    } catch (error) {\n      return {\n        ok: false,\n        generation,\n        message: `${tool} failed: ${(error as Error).message}`,\n      };\n    }\n    if (\n      !(await generationDone(\n        { ...layout, rootDir: staging.dir },\n        generation,\n        staging.files,\n      ))\n    ) {\n      return {\n        ok: false,\n        generation,\n        message:\n          generation.kind === \"route-tree\"\n            ? `${tool} wrote no route ${generation.routes.join(\", \")}`\n            : `${tool} wrote no migration with tables ${generation.tables.join(\", \")}`,\n      };\n    }\n  }\n  return { ok: true };\n}\n\n/**\n * Every file in the staging dir whose bytes differ from the project's is written through\n * `<path>.parlor-tmp` and a rename, then the staging dir is removed. Returns the project paths\n * written. A crash between two renames leaves whole files, and the next run's plan finds each\n * written step `done`.\n */\nexport async function commitStaging(\n  rootDir: string,\n  staging: Staging,\n): Promise<readonly string[]> {\n  const written: string[] = [];\n  for (const path of await staging.files.list(\"\")) {\n    const staged = await readFile(join(staging.dir, path));\n    const current = await readFile(join(rootDir, path)).catch(() => undefined);\n    if (current?.equals(staged)) continue;\n    const target = join(rootDir, path);\n    await mkdir(dirname(target), { recursive: true });\n    await writeFile(`${target}.parlor-tmp`, staged);\n    await rename(`${target}.parlor-tmp`, target);\n    written.push(path);\n  }\n  await discardStaging(staging);\n  return written;\n}\n\nexport async function discardStaging(staging: Staging): Promise<void> {\n  await rm(staging.dir, { recursive: true, force: true });\n}\n"]}

package/dist/addons/agent.d.ts

@@ -0,0 +1,58 @@
+import { SERVER_ENTRY } from "../add/addon.js";
+/**
+ * The default template already contains all of this; a test runs this add-on on it and expects
+ * no change, which is what keeps the two from drifting.
+ */
+export declare const agent: {
+    readonly summary: "The agent sidebar: chat with your own coding agent inside the app.";
+    readonly requires: {
+        readonly routesDir: "src/routes";
+    };
+    readonly dependencies: {
+        readonly "@parlor/chat": "framework";
+    };
+    readonly files: readonly [{
+        readonly template: "default";
+        readonly dir: "src/agent";
+    }];
+    readonly edits: readonly [{
+        readonly file: typeof SERVER_ENTRY;
+        readonly ops: readonly [{
+            readonly kind: "import";
+            readonly names: readonly ["chat"];
+            readonly from: "@parlor/chat/server";
+        }, {
+            readonly kind: "append-element";
+            readonly call: {
+                readonly callee: "createServer";
+                readonly from: "@parlor/server";
+            };
+            readonly path: readonly ["plugins"];
+            readonly element: "chat()";
+        }];
+    }, {
+        readonly file: "src/routes/__root.tsx";
+        readonly ops: readonly [{
+            readonly kind: "import";
+            readonly names: readonly ["agentPanel"];
+            readonly from: "../agent/views.js";
+        }, {
+            readonly kind: "append-element";
+            readonly call: import("../edit/syntax.js").CallSite;
+            readonly path: readonly ["staticData", "views"];
+            readonly element: "agentPanel";
+        }];
+    }];
+    readonly mounts: readonly [{
+        readonly component: "AgentButton";
+        readonly module: "src/agent/agent-button.tsx";
+        readonly into: {
+            readonly file: "src/header-actions.tsx";
+            readonly parent: "HeaderActions";
+        };
+    }];
+    readonly env: readonly [];
+    readonly generate: readonly [];
+    readonly notes: readonly ["Restart the dev server. Open the Agent button to chat with the coding agents on this computer."];
+};
+//# sourceMappingURL=agent.d.ts.map

package/dist/addons/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/addons/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ChB,CAAC"}

package/dist/addons/agent.js

@@ -0,0 +1,50 @@
+import { defineAddon, ROOT_ROUTE, SERVER_ENTRY } from "../add/addon.js";
+/**
+ * The default template already contains all of this; a test runs this add-on on it and expects
+ * no change, which is what keeps the two from drifting.
+ */
+export const agent = defineAddon({
+    summary: "The agent sidebar: chat with your own coding agent inside the app.",
+    requires: { routesDir: "src/routes" },
+    dependencies: { "@parlor/chat": "framework" },
+    files: [{ template: "default", dir: "src/agent" }],
+    edits: [
+        {
+            file: SERVER_ENTRY,
+            ops: [
+                { kind: "import", names: ["chat"], from: "@parlor/chat/server" },
+                {
+                    kind: "append-element",
+                    call: { callee: "createServer", from: "@parlor/server" },
+                    path: ["plugins"],
+                    element: "chat()",
+                },
+            ],
+        },
+        {
+            file: "src/routes/__root.tsx",
+            ops: [
+                { kind: "import", names: ["agentPanel"], from: "../agent/views.js" },
+                {
+                    kind: "append-element",
+                    call: ROOT_ROUTE,
+                    path: ["staticData", "views"],
+                    element: "agentPanel",
+                },
+            ],
+        },
+    ],
+    mounts: [
+        {
+            component: "AgentButton",
+            module: "src/agent/agent-button.tsx",
+            into: { file: "src/header-actions.tsx", parent: "HeaderActions" },
+        },
+    ],
+    env: [],
+    generate: [],
+    notes: [
+        "Restart the dev server. Open the Agent button to chat with the coding agents on this computer.",
+    ],
+});
+//# sourceMappingURL=agent.js.map

package/dist/addons/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/addons/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,WAAW,CAAC;IAC/B,OAAO,EAAE,oEAAoE;IAC7E,QAAQ,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE;IACrC,YAAY,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE;IAC7C,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;IAClD,KAAK,EAAE;QACL;YACE,IAAI,EAAE,YAAY;YAClB,GAAG,EAAE;gBACH,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE;gBAChE;oBACE,IAAI,EAAE,gBAAgB;oBACtB,IAAI,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,EAAE;oBACxD,IAAI,EAAE,CAAC,SAAS,CAAC;oBACjB,OAAO,EAAE,QAAQ;iBAClB;aACF;SACF;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,GAAG,EAAE;gBACH,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE;gBACpE;oBACE,IAAI,EAAE,gBAAgB;oBACtB,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;oBAC7B,OAAO,EAAE,YAAY;iBACtB;aACF;SACF;KACF;IACD,MAAM,EAAE;QACN;YACE,SAAS,EAAE,aAAa;YACxB,MAAM,EAAE,4BAA4B;YACpC,IAAI,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,EAAE,eAAe,EAAE;SAClE;KACF;IACD,GAAG,EAAE,EAAE;IACP,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE;QACL,gGAAgG;KACjG;CACF,CAAC,CAAC","sourcesContent":["import { defineAddon, ROOT_ROUTE, SERVER_ENTRY } from \"../add/addon.js\";\n\n/**\n * The default template already contains all of this; a test runs this add-on on it and expects\n * no change, which is what keeps the two from drifting.\n */\nexport const agent = defineAddon({\n  summary: \"The agent sidebar: chat with your own coding agent inside the app.\",\n  requires: { routesDir: \"src/routes\" },\n  dependencies: { \"@parlor/chat\": \"framework\" },\n  files: [{ template: \"default\", dir: \"src/agent\" }],\n  edits: [\n    {\n      file: SERVER_ENTRY,\n      ops: [\n        { kind: \"import\", names: [\"chat\"], from: \"@parlor/chat/server\" },\n        {\n          kind: \"append-element\",\n          call: { callee: \"createServer\", from: \"@parlor/server\" },\n          path: [\"plugins\"],\n          element: \"chat()\",\n        },\n      ],\n    },\n    {\n      file: \"src/routes/__root.tsx\",\n      ops: [\n        { kind: \"import\", names: [\"agentPanel\"], from: \"../agent/views.js\" },\n        {\n          kind: \"append-element\",\n          call: ROOT_ROUTE,\n          path: [\"staticData\", \"views\"],\n          element: \"agentPanel\",\n        },\n      ],\n    },\n  ],\n  mounts: [\n    {\n      component: \"AgentButton\",\n      module: \"src/agent/agent-button.tsx\",\n      into: { file: \"src/header-actions.tsx\", parent: \"HeaderActions\" },\n    },\n  ],\n  env: [],\n  generate: [],\n  notes: [\n    \"Restart the dev server. Open the Agent button to chat with the coding agents on this computer.\",\n  ],\n});\n"]}