@projitect/cli-internals 0.0.0-stage → 1.0.0

package/dist/platform/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/platform/terminal.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,EAAiB,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAsF/D,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAA0C,CAAA"}

package/dist/platform/terminal.js

@@ -0,0 +1,81 @@
+import * as keypress from "node:readline";
+import * as readline from "node:readline/promises";
+import { Effect, Layer, Option, Queue, Terminal } from "effect";
+import * as PlatformError from "effect/PlatformError";
+/**
+ * Node-backed `Terminal` Layer.
+ *
+ * - `columns` / `rows` read from `process.stdout` (fall back to sensible defaults when not a TTY)
+ * - `display(text)` writes to `process.stdout` synchronously
+ * - `readLine` uses `node:readline/promises` so `Prompt.text` and `Prompt.confirm` work
+ * - `readInput` (the low-level keypress stream used by `Prompt.select` / `Prompt.multiSelect`)
+ *   puts a TTY stdin into raw mode for the lifetime of the enclosing scope and queues one
+ *   `UserInput` per keypress. Raw mode means Ctrl-C arrives as a keypress rather than as SIGINT,
+ *   so Ctrl-C ends the queue and the prompt fails with `QuitError`.
+ */
+const readInput = Effect.gen(function* () {
+    const queue = yield* Queue.unbounded();
+    yield* Effect.acquireRelease(Effect.sync(() => {
+        const onKeypress = (input, key) => {
+            Queue.offerUnsafe(queue, {
+                input: Option.fromNullishOr(input),
+                key: {
+                    name: key?.name ?? "",
+                    ctrl: key?.ctrl ?? false,
+                    meta: key?.meta ?? false,
+                    shift: key?.shift ?? false,
+                },
+            });
+            if (key?.ctrl === true && key.name === "c") {
+                // Raw mode swallows SIGINT; ending the queue makes the prompt fail with `QuitError`.
+                Queue.endUnsafe(queue);
+            }
+        };
+        keypress.emitKeypressEvents(process.stdin);
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+        process.stdin.on("keypress", onKeypress);
+        process.stdin.resume();
+        return onKeypress;
+    }), (onKeypress) => Effect.sync(() => {
+        process.stdin.off("keypress", onKeypress);
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(false);
+        }
+        process.stdin.pause();
+    }));
+    return queue;
+});
+const make = Terminal.make({
+    // @types/node types columns/rows as non-nullable, but they're undefined on non-TTY stdout.
+    /* eslint-disable @typescript-eslint/no-unnecessary-condition */
+    columns: Effect.sync(() => process.stdout.columns ?? 80),
+    rows: Effect.sync(() => process.stdout.rows ?? 24),
+    /* eslint-enable @typescript-eslint/no-unnecessary-condition */
+    display: (text) => Effect.try({
+        try: () => {
+            process.stdout.write(text);
+        },
+        catch: (cause) => PlatformError.badArgument({
+            module: "Terminal",
+            method: "display",
+            description: cause instanceof Error ? cause.message : String(cause),
+        }),
+    }),
+    readLine: Effect.tryPromise({
+        try: async () => {
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                return await rl.question("");
+            }
+            finally {
+                rl.close();
+            }
+        },
+        catch: () => new Terminal.QuitError({}),
+    }),
+    readInput,
+});
+export const TerminalLive = Layer.succeed(Terminal.Terminal, make);
+//# sourceMappingURL=terminal.js.map

package/dist/platform/terminal.js.map

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

package/dist/pm.d.ts

@@ -0,0 +1,31 @@
+import { Effect } from "effect";
+import { Errors } from "@projitect/core";
+import type { ProjitectPackageMetadata } from "@projitect/blueprint";
+export type PackageManager = "pnpm" | "npm" | "yarn" | "bun";
+/**
+ * Detect the user's package manager by walking up from `projectRoot` looking for known
+ * lockfiles. Falls back to `npm` if nothing is found. Used by `pjt add` to decide which install
+ * command to shell out to.
+ */
+export declare const detect: (params: {
+    readonly projectRoot: string;
+}) => Effect.Effect<PackageManager, Errors.PmNotDetected>;
+/**
+ * Run `<pm> add -D <pkg>` in `projectRoot`. Wraps spawn failures (non-zero exit, PM not
+ * installed) as `pjt.pm.install-failed`.
+ */
+export declare const installDev: (params: {
+    readonly projectRoot: string;
+    readonly pm: PackageManager;
+    readonly pkg: string;
+}) => Effect.Effect<void, Errors.PmInstallFailed>;
+/**
+ * Read the installed package's `package.json` and return its `"projitect"` metadata, if any.
+ * Returns null if the package doesn't have the field; `pjt add` falls back to install-only
+ * behavior with a printed instruction snippet.
+ */
+export declare const readProjitectMetadata: (params: {
+    readonly projectRoot: string;
+    readonly pkg: string;
+}) => Effect.Effect<ProjitectPackageMetadata | null>;
+//# sourceMappingURL=pm.d.ts.map

package/dist/pm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.d.ts","sourceRoot":"","sources":["../src/pm.ts"],"names":[],"mappings":"AAGA,OAAO,EAAS,MAAM,EAA4B,MAAM,QAAQ,CAAA;AAEhE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAEpE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;AAS5D;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,aAAa,CAcnD,CAAA;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,eAAe,CA2B7C,CAAA;AAUD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB,KAAG,MAAM,CAAC,MAAM,CAAC,wBAAwB,GAAG,IAAI,CAqC7C,CAAA"}

package/dist/pm.js

@@ -0,0 +1,91 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { Array, Effect, Match, Option, Predicate } from "effect";
+import { PredicateX, StructX } from "@nunofyobiz/effect-extras";
+import { Errors } from "@projitect/core";
+const LOCKFILES = [
+    ["pnpm-lock.yaml", "pnpm"],
+    ["bun.lockb", "bun"],
+    ["yarn.lock", "yarn"],
+    ["package-lock.json", "npm"],
+];
+/**
+ * Detect the user's package manager by walking up from `projectRoot` looking for known
+ * lockfiles. Falls back to `npm` if nothing is found. Used by `pjt add` to decide which install
+ * command to shell out to.
+ */
+export const detect = (params) => Effect.map(Effect.findFirst(LOCKFILES, ([filename]) => Effect.promise(() => fs.access(path.join(params.projectRoot, filename)).then(() => true, () => false))), Option.match({
+    onSome: ([, pm]) => pm,
+    onNone: () => "npm",
+}));
+/**
+ * Run `<pm> add -D <pkg>` in `projectRoot`. Wraps spawn failures (non-zero exit, PM not
+ * installed) as `pjt.pm.install-failed`.
+ */
+export const installDev = (params) => {
+    const args = installArgs(params.pm, params.pkg);
+    return Effect.tryPromise({
+        try: () => new Promise((resolve, reject) => {
+            const child = spawn(params.pm, args, {
+                cwd: params.projectRoot,
+                stdio: "inherit",
+            });
+            child.on("error", reject);
+            child.on("close", (code) => {
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`${params.pm} ${args.join(" ")} exited with ${String(code)}`));
+                }
+            });
+        }),
+        catch: (e) => new Errors.PmInstallFailed({
+            id: "pjt.pm.install-failed",
+            packageManager: params.pm,
+            pkg: params.pkg,
+            cause: e instanceof Error ? e.message : String(e),
+            message: `Failed to install \`${params.pkg}\` via ${params.pm}`,
+        }),
+    });
+};
+const installArgs = (pm, pkg) => Match.value(pm).pipe(Match.whenOr("pnpm", "yarn", () => ["add", "-D", pkg]), Match.when("bun", () => ["add", "-d", pkg]), Match.when("npm", () => ["install", "-D", pkg]), Match.exhaustive);
+/**
+ * Read the installed package's `package.json` and return its `"projitect"` metadata, if any.
+ * Returns null if the package doesn't have the field; `pjt add` falls back to install-only
+ * behavior with a printed instruction snippet.
+ */
+export const readProjitectMetadata = (params) => Effect.promise(async () => {
+    const pkgJsonPath = path.join(params.projectRoot, "node_modules", params.pkg, "package.json");
+    try {
+        const parsed = JSON.parse(await fs.readFile(pkgJsonPath, "utf8"));
+        if (!PredicateX.unsafeIsRecord(parsed)) {
+            return null;
+        }
+        const meta = parsed["projitect"];
+        if (!PredicateX.unsafeIsRecord(meta)) {
+            return null;
+        }
+        const type = meta["type"];
+        const importStmt = meta["import"];
+        if (type !== "blueprint" && type !== "blueprint-set") {
+            return null;
+        }
+        if (!Predicate.isString(importStmt)) {
+            return null;
+        }
+        const sections = meta["sections"];
+        return {
+            type,
+            import: importStmt,
+            ...StructX.defined("call", Predicate.isString(meta["call"]) ? meta["call"] : undefined),
+            ...StructX.defined("callTemplate", Predicate.isString(meta["callTemplate"]) ? meta["callTemplate"] : undefined),
+            ...StructX.defined("sections", Array.isArray(sections) ? Array.filter(sections, Predicate.isString) : undefined),
+        };
+    }
+    catch {
+        return null;
+    }
+});
+//# sourceMappingURL=pm.js.map

package/dist/pm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.js","sourceRoot":"","sources":["../src/pm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAKxC,MAAM,SAAS,GAAmD;IAChE,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAC1B,CAAC,WAAW,EAAE,KAAK,CAAC;IACpB,CAAC,WAAW,EAAE,MAAM,CAAC;IACrB,CAAC,mBAAmB,EAAE,KAAK,CAAC;CAC7B,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAEtB,EAAuD,EAAE,CACxD,MAAM,CAAC,GAAG,CACR,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CACzC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAClB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CACrD,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CACF,CACF,EACD,MAAM,CAAC,KAAK,CAAC;IACX,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE;IACtB,MAAM,EAAE,GAAmB,EAAE,CAAC,KAAK;CACpC,CAAC,CACH,CAAA;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAI1B,EAA+C,EAAE;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;IAC/C,OAAO,MAAM,CAAC,UAAU,CAAC;QACvB,GAAG,EAAE,GAAG,EAAE,CACR,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE;gBACnC,GAAG,EAAE,MAAM,CAAC,WAAW;gBACvB,KAAK,EAAE,SAAS;aACjB,CAAC,CAAA;YACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YACzB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,EAAE,CAAA;gBACX,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;gBACjF,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC;QACJ,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,IAAI,MAAM,CAAC,eAAe,CAAC;YACzB,EAAE,EAAE,uBAAuB;YAC3B,cAAc,EAAE,MAAM,CAAC,EAAE;YACzB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACjD,OAAO,EAAE,uBAAuB,MAAM,CAAC,GAAG,UAAU,MAAM,CAAC,EAAE,EAAE;SAChE,CAAC;KACL,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,EAAkB,EAAE,GAAW,EAAqB,EAAE,CACzE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAClB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,EACtD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,EAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,EAC/C,KAAK,CAAC,UAAU,CACjB,CAAA;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAGrC,EAAkD,EAAE,CACnD,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;IACxB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,CAAA;IAC7F,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;QAC1E,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;QAChC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjC,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;YACrD,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAA;QACjC,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,UAAU;YAClB,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACvF,GAAG,OAAO,CAAC,OAAO,CAChB,cAAc,EACd,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAC5E;YACD,GAAG,OAAO,CAAC,OAAO,CAChB,UAAU,EACV,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CACjF;SACF,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/post-apply.d.ts

@@ -0,0 +1,20 @@
+import { Effect } from "effect";
+import type { Errors } from "@projitect/core";
+import type { PlannedCommand } from "./plan.js";
+import type { ProcessSpawner } from "./platform/process-runner.js";
+/**
+ * The final phase of `build` and `remodel`: run the plan's `Exec` commands once every file
+ * operation has succeeded.
+ *
+ * Every declaring blueprint's permissions must cover its own command; that is checked for the whole
+ * list before any command starts, so a denial never leaves a half-run phase. Identical command
+ * strings run once, at their first position. Commands run sequentially from the project root, in
+ * blueprint tree order then op order, and the first failure stops the phase. Returns the commands
+ * that ran.
+ */
+export declare const runPostApply: (params: {
+    readonly commands: readonly PlannedCommand[];
+    readonly projectRoot: string;
+    readonly spawner?: ProcessSpawner;
+}) => Effect.Effect<readonly string[], Errors.ExecError>;
+//# sourceMappingURL=post-apply.d.ts.map

package/dist/post-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-apply.d.ts","sourceRoot":"","sources":["../src/post-apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAU,MAAM,QAAQ,CAAA;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAElE;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;CAClC,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,SAAS,CAuBjD,CAAA"}

package/dist/post-apply.js

@@ -0,0 +1,29 @@
+import { Array, Effect, Option } from "effect";
+import { isCommandPermitted } from "./permissions.js";
+import { commandNotPermitted, nodeSpawner, runCommand } from "./platform/process-runner.js";
+/**
+ * The final phase of `build` and `remodel`: run the plan's `Exec` commands once every file
+ * operation has succeeded.
+ *
+ * Every declaring blueprint's permissions must cover its own command; that is checked for the whole
+ * list before any command starts, so a denial never leaves a half-run phase. Identical command
+ * strings run once, at their first position. Commands run sequentially from the project root, in
+ * blueprint tree order then op order, and the first failure stops the phase. Returns the commands
+ * that ran.
+ */
+export const runPostApply = (params) => Effect.gen(function* () {
+    const { commands, projectRoot, spawner = nodeSpawner } = params;
+    const denied = Array.findFirst(commands, (planned) => !isCommandPermitted(planned.permissions, planned.command));
+    if (Option.isSome(denied)) {
+        return yield* commandNotPermitted(denied.value.command);
+    }
+    const unique = Array.dedupeWith(commands, (a, b) => a.command === b.command);
+    yield* Effect.forEach(unique, (planned) => runCommand({
+        permissions: planned.permissions,
+        command: planned.command,
+        cwd: projectRoot,
+        spawner,
+    }), { discard: true });
+    return Array.map(unique, (planned) => planned.command);
+});
+//# sourceMappingURL=post-apply.js.map

package/dist/post-apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-apply.js","sourceRoot":"","sources":["../src/post-apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAG3F;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAI5B,EAAsD,EAAE,CACvD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAG,WAAW,EAAE,GAAG,MAAM,CAAA;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAC5B,QAAQ,EACR,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CACvE,CAAA;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,CAAA;IAC5E,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACnB,MAAM,EACN,CAAC,OAAO,EAAE,EAAE,CACV,UAAU,CAAC;QACT,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,EAAE,WAAW;QAChB,OAAO;KACR,CAAC,EACJ,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAA;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AACxD,CAAC,CAAC,CAAA"}

package/dist/project-file.d.ts

@@ -0,0 +1,8 @@
+import { Effect } from "effect";
+import { BlueprintFileSystem } from "@projitect/core";
+/**
+ * Read a project-relative file through the `BlueprintFileSystem` service, treating any read
+ * failure as "absent" (`null`). Shared by the lockfile, differ, applier and remover.
+ */
+export declare const readIfExists: (file: string) => Effect.Effect<string | null, never, BlueprintFileSystem>;
+//# sourceMappingURL=project-file.d.ts.map

package/dist/project-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-file.d.ts","sourceRoot":"","sources":["../src/project-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;GAGG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,mBAAmB,CAKf,CAAA"}

package/dist/project-file.js

@@ -0,0 +1,12 @@
+import { Effect } from "effect";
+import { BlueprintFileSystem } from "@projitect/core";
+/**
+ * Read a project-relative file through the `BlueprintFileSystem` service, treating any read
+ * failure as "absent" (`null`). Shared by the lockfile, differ, applier and remover.
+ */
+export const readIfExists = (file) => Effect.gen(function* () {
+    const fs = yield* BlueprintFileSystem;
+    const present = yield* fs.exists(file);
+    return present ? yield* fs.readFile(file) : null;
+}).pipe(Effect.orElseSucceed(() => null));
+//# sourceMappingURL=project-file.js.map

package/dist/project-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-file.js","sourceRoot":"","sources":["../src/project-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,IAAY,EAC8C,EAAE,CAC5D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAA;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACtC,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAClD,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA"}

package/dist/region.d.ts

@@ -0,0 +1,105 @@
+import { Data, Effect } from "effect";
+import { Errors } from "@projitect/core";
+export type RegionLookup = Data.TaggedEnum<{
+    readonly Found: {
+        readonly startLine: number;
+        readonly endLine: number;
+        readonly content: string;
+    };
+    readonly Absent: {};
+}>;
+export declare const RegionLookup: {
+    readonly Found: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Found";
+        readonly startLine: number;
+        readonly endLine: number;
+        readonly content: string;
+    }, "_tag">;
+    readonly Absent: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Absent";
+    }, "_tag">;
+    readonly $is: <Tag extends "Found" | "Absent">(tag: Tag) => (u: unknown) => u is Extract<{
+        readonly _tag: "Found";
+        readonly startLine: number;
+        readonly endLine: number;
+        readonly content: string;
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Absent";
+    }, {
+        readonly _tag: Tag;
+    }>;
+    readonly $match: {
+        <Cases extends {
+            readonly Found: (args: {
+                readonly _tag: "Found";
+                readonly startLine: number;
+                readonly endLine: number;
+                readonly content: string;
+            }) => any;
+            readonly Absent: (args: {
+                readonly _tag: "Absent";
+            }) => any;
+        }>(cases: Cases): (value: {
+            readonly _tag: "Found";
+            readonly startLine: number;
+            readonly endLine: number;
+            readonly content: string;
+        } | {
+            readonly _tag: "Absent";
+        }) => import("effect/Unify").Unify<ReturnType<Cases["Found" | "Absent"]>>;
+        <Cases extends {
+            readonly Found: (args: {
+                readonly _tag: "Found";
+                readonly startLine: number;
+                readonly endLine: number;
+                readonly content: string;
+            }) => any;
+            readonly Absent: (args: {
+                readonly _tag: "Absent";
+            }) => any;
+        }>(value: {
+            readonly _tag: "Found";
+            readonly startLine: number;
+            readonly endLine: number;
+            readonly content: string;
+        } | {
+            readonly _tag: "Absent";
+        }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Found" | "Absent"]>>;
+    };
+};
+/**
+ * Find the existing region for `ownerId` inside `fileContent`. Returns its line range and
+ * content, or `{ kind: "absent" }`. A start marker without an end is a
+ * `pjt.region.missing-end` error; duplicate start markers are `pjt.region.duplicate`.
+ */
+export declare const findRegion: (params: {
+    readonly fileContent: string;
+    readonly ownerId: string;
+    readonly commentPrefix: string;
+    /**
+     * Optional closing delimiter for the comment style (e.g. `" -->"` for HTML/MDX). Defaults
+     * to the empty string so single-prefix styles (`#`, `//`) stay unchanged.
+     */
+    readonly commentSuffix?: string;
+    readonly path: string;
+}) => Effect.Effect<RegionLookup, Errors.RegionMissingEnd | Errors.RegionDuplicate>;
+/**
+ * Render a region block (markers + content) ready to splice into a file.
+ */
+export declare const renderRegion: (params: {
+    readonly ownerId: string;
+    readonly commentPrefix: string;
+    readonly commentSuffix?: string;
+    readonly content: string;
+}) => string;
+/**
+ * Splice or append a region into a file's existing content. Returns the updated text.
+ */
+export declare const upsertRegion: (params: {
+    readonly fileContent: string;
+    readonly existing: RegionLookup;
+    readonly rendered: string;
+}) => string;
+//# sourceMappingURL=region.d.ts.map

package/dist/region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region.d.ts","sourceRoot":"","sources":["../src/region.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAYxC,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KACzB,CAAA;IAED,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAA;CACpB,CAAC,CAAA;AACF,eAAO,MAAM,YAAY;;;4BAPD,MAAM;0BACR,MAAM;0BACN,MAAM;;;;;;;4BAFJ,MAAM;0BACR,MAAM;0BACN,MAAM;;;;;;;;;;;;oCAFJ,MAAM;kCACR,MAAM;kCACN,MAAM;;;;;;;gCAFJ,MAAM;8BACR,MAAM;8BACN,MAAM;;;;;;;oCAFJ,MAAM;kCACR,MAAM;kCACN,MAAM;;;;;;;gCAFJ,MAAM;8BACR,MAAM;8BACN,MAAM;;;;;CAK+B,CAAA;AAE3D;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,KAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,eAAe,CA4D/E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,KAAG,MAQH,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,KAAG,MAWH,CAAA"}

package/dist/region.js

@@ -0,0 +1,94 @@
+import { Data, Effect, String } from "effect";
+import { StringX } from "@nunofyobiz/effect-extras";
+import { Errors } from "@projitect/core";
+/**
+ * Render a region marker. The optional `suffix` covers comment styles that need a closing
+ * delimiter — HTML/MDX/XML need `-->`, everything else passes the empty string. Without a
+ * suffix the marker just runs to end-of-line (the `#` and `//` cases).
+ */
+const START = (prefix, owner, suffix = "") => `${prefix} ${owner} start${suffix}`;
+const END = (prefix, owner, suffix = "") => `${prefix} ${owner} end${suffix}`;
+export const RegionLookup = Data.taggedEnum();
+/**
+ * Find the existing region for `ownerId` inside `fileContent`. Returns its line range and
+ * content, or `{ kind: "absent" }`. A start marker without an end is a
+ * `pjt.region.missing-end` error; duplicate start markers are `pjt.region.duplicate`.
+ */
+export const findRegion = (params) => {
+    const { fileContent, ownerId, commentPrefix, commentSuffix = "", path } = params;
+    return Effect.suspend(() => {
+        const lines = fileContent.split("\n");
+        const startMarker = START(commentPrefix, ownerId, commentSuffix);
+        const endMarker = END(commentPrefix, ownerId, commentSuffix);
+        let startLine = -1;
+        let endLine = -1;
+        let duplicateStart = false;
+        for (const [index, line_] of lines.entries()) {
+            const line = line_.trimEnd();
+            if (line === startMarker) {
+                if (startLine === -1) {
+                    startLine = index;
+                }
+                else {
+                    duplicateStart = true;
+                }
+            }
+            else if (line === endMarker) {
+                endLine = index;
+            }
+        }
+        if (duplicateStart) {
+            return Effect.fail(new Errors.RegionDuplicate({
+                id: "pjt.region.duplicate",
+                path,
+                ownerId,
+                message: `Multiple start markers for region ${ownerId} in ${path}`,
+            }));
+        }
+        if (startLine === -1) {
+            return Effect.succeed(RegionLookup.Absent());
+        }
+        if (endLine === -1 || endLine < startLine) {
+            return Effect.fail(new Errors.RegionMissingEnd({
+                id: "pjt.region.missing-end",
+                path,
+                ownerId,
+                startLine,
+                message: `Region ${ownerId} started at line ${startLine + 1} of ${path} but never closed`,
+            }));
+        }
+        return Effect.succeed(RegionLookup.Found({
+            startLine,
+            endLine,
+            content: lines.slice(startLine + 1, endLine).join("\n"),
+        }));
+    });
+};
+/**
+ * Render a region block (markers + content) ready to splice into a file.
+ */
+export const renderRegion = (params) => {
+    const suffix = params.commentSuffix ?? "";
+    const body = params.content.endsWith("\n") ? params.content.slice(0, -1) : params.content;
+    return [
+        START(params.commentPrefix, params.ownerId, suffix),
+        body,
+        END(params.commentPrefix, params.ownerId, suffix),
+    ].join("\n");
+};
+/**
+ * Splice or append a region into a file's existing content. Returns the updated text.
+ */
+export const upsertRegion = (params) => {
+    const { fileContent, existing, rendered } = params;
+    if (existing._tag === "Absent") {
+        if (String.isEmpty(fileContent)) {
+            return `${rendered}\n`;
+        }
+        return fileContent.endsWith("\n")
+            ? `${fileContent}${rendered}\n`
+            : `${fileContent}\n${rendered}\n`;
+    }
+    return StringX.replaceLineRange(fileContent, existing.startLine, existing.endLine, [rendered]);
+};
+//# sourceMappingURL=region.js.map

package/dist/region.js.map

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

package/dist/remover.d.ts

@@ -0,0 +1,16 @@
+import { Effect } from "effect";
+import { BlueprintFileSystem } from "@projitect/core";
+import type { Errors, PjtLock } from "@projitect/core";
+/**
+ * Apply removal operations through the project `BlueprintFileSystem`. Used by `pjt remodel` / `pjt build` after a blueprint
+ * leaves `.pjt.ts` — the operations come from the diff between the previous lockfile and the
+ * current blueprint set.
+ *
+ * Returns the list of paths actually mutated.
+ */
+export declare const applyRemovals: (params: {
+    readonly removals: readonly PjtLock.LockOperation[];
+}) => Effect.Effect<readonly string[], RemoveError, BlueprintFileSystem>;
+type RemoveError = Errors.RegionMissingEnd | Errors.RegionDuplicate | Errors.FsWriteFailed | Errors.FsPermissionDenied;
+export {};
+//# sourceMappingURL=remover.d.ts.map

package/dist/remover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remover.d.ts","sourceRoot":"","sources":["../src/remover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAA4B,MAAM,QAAQ,CAAA;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAItD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,CAAC,aAAa,EAAE,CAAA;CACpD,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,mBAAmB,CAGjC,CAAA;AAEpC,KAAK,WAAW,GACZ,MAAM,CAAC,gBAAgB,GACvB,MAAM,CAAC,eAAe,GACtB,MAAM,CAAC,aAAa,GACpB,MAAM,CAAC,kBAAkB,CAAA"}

package/dist/remover.js

@@ -0,0 +1,88 @@
+import { Array, Effect, Match, Option, Predicate } from "effect";
+import { PredicateX, RecordX, StringX } from "@nunofyobiz/effect-extras";
+import { BlueprintFileSystem } from "@projitect/core";
+import { readIfExists } from "./project-file.js";
+import { findRegion } from "./region.js";
+/**
+ * Apply removal operations through the project `BlueprintFileSystem`. Used by `pjt remodel` / `pjt build` after a blueprint
+ * leaves `.pjt.ts` — the operations come from the diff between the previous lockfile and the
+ * current blueprint set.
+ *
+ * Returns the list of paths actually mutated.
+ */
+export const applyRemovals = (params) => Effect.forEach(params.removals, (op) => Effect.map(applyOne(op), (mutated) => (mutated ? Option.some(op.path) : Option.none()))).pipe(Effect.map(Array.getSomes));
+const applyOne = (op) => Match.valueTags(op, {
+    Region: (region) => removeRegion(region),
+    Merge: (merge) => removeMergeKeys(merge.path, merge.ownedKeys),
+    Owned: (owned) => removeFile(owned.path, owned.ownedDir),
+    // Seed is write-once; we never delete the file when a seed blueprint leaves.
+    Seed: () => Effect.succeed(false),
+});
+const removeRegion = (op) => Effect.gen(function* () {
+    const fs = yield* BlueprintFileSystem;
+    const current = yield* readIfExists(op.path);
+    if (current === null) {
+        return false;
+    }
+    const found = yield* findRegion({
+        fileContent: current,
+        ownerId: op.ownerId,
+        commentPrefix: op.commentPrefix,
+        commentSuffix: op.commentSuffix ?? "",
+        path: op.path,
+    });
+    if (found._tag === "Absent") {
+        return false;
+    }
+    const next = StringX.replaceLineRange(current, found.startLine, found.endLine, []);
+    yield* fs.writeFile(op.path, next);
+    return true;
+});
+const removeMergeKeys = (file, keys) => Effect.gen(function* () {
+    const fs = yield* BlueprintFileSystem;
+    const raw = yield* readIfExists(file);
+    if (raw === null) {
+        return false;
+    }
+    const parsed = yield* Effect.try(() => JSON.parse(raw)).pipe(Effect.option);
+    if (Option.isNone(parsed) || !PredicateX.unsafeIsRecord(parsed.value)) {
+        return false;
+    }
+    // Fold each dotted key out of the tree, tracking whether anything actually changed.
+    const seed = {
+        tree: parsed.value,
+        mutated: false,
+    };
+    const result = Array.reduce(keys, seed, (state, key) => Option.match(RecordX.deleteByPath(state.tree, key.split(".")), {
+        onSome: (tree) => ({ tree, mutated: true }),
+        onNone: () => state,
+    }));
+    if (!result.mutated) {
+        return false;
+    }
+    yield* fs.writeFile(file, `${JSON.stringify(result.tree, null, 2)}\n`);
+    return true;
+});
+const removeFile = (file, ownedDir) => Effect.gen(function* () {
+    const fs = yield* BlueprintFileSystem;
+    yield* fs.remove(file);
+    if (Predicate.isNotUndefined(ownedDir)) {
+        yield* pruneEmptyDirs(parentDir(file), ownedDir);
+    }
+    return true;
+}).pipe(Effect.orElseSucceed(() => false));
+// Project-relative paths use `/`; the parent of a top-level name is the project root (`""`).
+const parentDir = (file) => file.slice(0, Math.max(0, file.lastIndexOf("/")));
+/** Remove empty directories upward from `dir` to `ownedDir` inclusive, never above it. */
+const pruneEmptyDirs = (dir, ownedDir) => Effect.gen(function* () {
+    if (dir !== ownedDir && !dir.startsWith(`${ownedDir}/`)) {
+        return;
+    }
+    const fs = yield* BlueprintFileSystem;
+    // Atomic: fails (and stops the climb) if `dir` holds any entry, however recently it appeared.
+    yield* fs.removeEmptyDir(dir);
+    if (dir !== ownedDir) {
+        yield* pruneEmptyDirs(parentDir(dir), ownedDir);
+    }
+}).pipe(Effect.orElseSucceed(() => undefined));
+//# sourceMappingURL=remover.js.map