create-relkit 0.6.0 → 0.7.1

package/dist/plan-builder-effects.d.ts

@@ -0,0 +1,124 @@
+import { Effect } from "effect";
+import { type AddRequest } from "./add-types.js";
+import type { DiscoveredArtifact, DiscoveredProfile, ProjectDiscovery } from "./project-discovery-types.js";
+import type { PlannedArtifactInput } from "./plan-builder.types.js";
+/** Private Ref-backed Effect implementation inherited by the public compatibility owner. */
+export declare class PlanBuilderEffects {
+    #private;
+    readonly request: AddRequest;
+    readonly discovery: ProjectDiscovery;
+    /**
+     * Creates isolated planning state without sharing mutations with another request.
+     * @param request - Normalized scaffold request.
+     * @param discovery - Read-only discovery snapshot.
+     * @remarks Ref.makeUnsafe is required only by this existing synchronous constructor.
+     * @returns The invocation-owned instance.
+     */
+    constructor(request: AddRequest, discovery: ProjectDiscovery);
+    /**
+     * Reads the planned source first, then the explicit filesystem service.
+     * @param path - Path inside the current project or owned resource.
+     * @returns Planned file text when present, otherwise text read through explicit filesystem authority.
+     */
+    readonly readEffect: (path: string) => Effect.Effect<string, import("./generator-errors.js").GeneratorIoError, import("./generator-filesystem.js").GeneratorFileSystem>;
+    /**
+     * Atomically reserves one create operation after checking the native destination.
+     * @param path - Path inside the current project or owned resource.
+     * @param content - Complete bytes or text planned for the destination.
+     * @param mode - Optional restored or generated permission mode.
+     * @returns Completion after collision preflight and atomic reservation of the new planned file.
+     */
+    readonly createEffect: (path: string, content: string, mode?: number) => Effect.Effect<void, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, import("./generator-filesystem.js").GeneratorFileSystem>;
+    /**
+     * Adds a source transformation to this request; transformations preserve expected validator errors.
+     * @param path - Path inside the current project or owned resource.
+     * @param transform - Pure transformation applied atomically to the latest planned source.
+     * @returns Completion after the transform is applied atomically to the latest planned source.
+     */
+    readonly updateEffect: (path: string, transform: (source: string) => string) => Effect.Effect<void, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, import("./generator-filesystem.js").GeneratorFileSystem>;
+    /**
+     * Plans an environment example only when the declaration is absent.
+     * @param name - Environment variable name.
+     * @param value - Example value used only for a new declaration.
+     * @returns An Effect planning the env example through explicit filesystem authority.
+     */
+    readonly envExampleEffect: (name: string, value?: string) => Effect.Effect<void, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, import("./generator-filesystem.js").GeneratorFileSystem>;
+    /**
+     * Plans a gitignore entry without duplicating an authored line.
+     * @param pattern - Declaration-owned glob or ignore pattern.
+     * @returns Completion after the missing ignore pattern is added to planned .gitignore source.
+     */
+    readonly gitignoreEffect: (pattern: string) => Effect.Effect<void, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, import("./generator-filesystem.js").GeneratorFileSystem>;
+    /**
+     * Records a required dependency through the authoritative request Ref.
+     * @param name - Authored name or declaration key.
+     * @returns Completion after the supported dependency is recorded in this request's Ref.
+     */
+    readonly dependencyEffect: (name: "better-auth" | "@relkit/aws" | "@relkit/better-auth" | "@relkit/cloudflare" | "@relkit/docker" | "@relkit/effect-mq" | "@relkit/inngest" | "@relkit/drizzle" | "@relkit/local" | "@relkit/pulumi" | "@relkit/redis" | "@relkit/s3" | "@relkit/trigger" | "drizzle-kit" | "drizzle-orm" | "langchain") => Effect.Effect<void, never, never>;
+    /**
+     * Adds one artifact identity to the current request's discovery view.
+     * @param kind - Authoritative artifact kind.
+     * @param value - Artifact domain, source path, binding and optional identity/export form.
+     * @returns An observed Ref update registering the authoritative kind and projected artifact fields.
+     */
+    readonly registerArtifactEffect: (kind: "function" | "service" | "error" | "event" | "task" | "job" | "cache" | "bucket" | "tool" | "prompt" | "agent" | "constants" | "route" | "middleware" | "transform" | "app" | "event-trigger" | "channel", value: PlannedArtifactInput) => Effect.Effect<void, never, never>;
+    /**
+     * Adds one provider profile to the current request's discovery view.
+     * @param profile - Selected provider profile.
+     * @returns Completion after the discovered/planned profile projection is updated for this request.
+     */
+    readonly registerProfileEffect: (profile: DiscoveredProfile) => Effect.Effect<void, never, never>;
+    /**
+     * Records one owned package script.
+     * @param name - Authored name or declaration key.
+     * @param command - Shell command stored under the package script name.
+     * @returns Completion after the script name and command are recorded for manifest planning.
+     */
+    readonly scriptEffect: (name: string, command: string) => Effect.Effect<void, never, never>;
+    /**
+     * Records a bounded warning by its stable code.
+     * @param code - Stable category code included in the resulting diagnostic.
+     * @param message - Existing user-facing diagnostic.
+     * @returns Completion after the warning is recorded under its stable category code.
+     */
+    readonly warningEffect: (code: string, message: string) => Effect.Effect<void, never, never>;
+    /**
+     * Records one next command without duplicating it.
+     * @param command - Shell command shown as a follow-up instruction.
+     * @returns Completion after the follow-up command is deduplicated in request state.
+     */
+    readonly nextStepEffect: (command: string) => Effect.Effect<void, never, never>;
+    /**
+     * Finishes manifest ownership and returns a deterministic immutable plan.
+     * @returns The frozen plan containing ordered operations, concrete dependencies and public follow-up metadata.
+     */
+    readonly finishEffect: () => Effect.Effect<Readonly<{
+        request: AddRequest;
+        projectRoot: string;
+        operations: readonly import("./add-types.js").ScaffoldFileOperation[];
+        dependencies: Readonly<Record<string, string>>;
+        artifacts: readonly {
+            kind: "function" | "service" | "error" | "event" | "task" | "job" | "cache" | "bucket" | "tool" | "prompt" | "agent" | "constants" | "route" | "middleware" | "transform" | "app" | "event-trigger" | "channel";
+            path: string;
+            id: string;
+            binding: string;
+        }[];
+        profiles: readonly {
+            capability: "event" | "job" | "cache" | "bucket" | "model";
+            name: string;
+        }[];
+        warnings: readonly import("./add-types.js").ScaffoldWarning[];
+        nextSteps: readonly string[];
+    }>, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, import("./generator-filesystem.js").GeneratorFileSystem>;
+    /**
+     * Returns a synchronous immutable projection of this request's authoritative Ref.
+     * @returns A new array combining discovered artifacts and this request's planned artifacts.
+     */
+    get artifacts(): readonly DiscoveredArtifact[];
+    /**
+     * Returns a synchronous immutable profile projection of the request Ref.
+     * @returns A new array combining discovered profiles and this request's planned profiles.
+     */
+    get profiles(): readonly DiscoveredProfile[];
+}
+//# sourceMappingURL=plan-builder-effects.d.ts.map

package/dist/plan-builder-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-builder-effects.d.ts","sourceRoot":"","sources":["../src/plan-builder-effects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAO,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAoB,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAMtF,4FAA4F;AAC5F,qBAAa,kBAAkB;;IAW3B,QAAQ,CAAC,OAAO,EAAE,UAAU;IAC5B,QAAQ,CAAC,SAAS,EAAE,gBAAgB;IATtC;;;;;;OAMG;gBAEQ,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,gBAAgB;IAatC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,GAAI,MAAM,MAAM,sIAAkC;IAErE;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,EAAE,OAAO,MAAM,2LACrB;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,GAAI,MAAM,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,2LAChC;IAE5C;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,GAAI,MAAM,MAAM,EAAE,cAAU,2LACT;IAE5C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,GAAI,SAAS,MAAM,2LAA0C;IACrF;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,qVAOvB;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,sBAAsB,sRAoB7B;IAEF;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,oEAI5B;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,uEAOnB;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,uEAOpB;IAEF;;;;OAIG;IACH,QAAQ,CAAC,cAAc,yDAOrB;IAEF;;;OAGG;IACH,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;0KA8BnB;IACF;;;OAGG;IACH,IAAI,SAAS,IAAI,SAAS,kBAAkB,EAAE,CAE7C;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,SAAS,iBAAiB,EAAE,CAE3C;CACF"}

package/dist/plan-builder-effects.js

@@ -0,0 +1,172 @@
+import { Effect, Ref } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import {} from "./add-types.js";
+import { finalizeManifestEffect } from "./plan-builder-manifest.js";
+import { planBuilderFiles } from "./plan-builder-files.js";
+/** Private Ref-backed Effect implementation inherited by the public compatibility owner. */
+export class PlanBuilderEffects {
+    request;
+    discovery;
+    #state;
+    #files;
+    /**
+     * Creates isolated planning state without sharing mutations with another request.
+     * @param request - Normalized scaffold request.
+     * @param discovery - Read-only discovery snapshot.
+     * @remarks Ref.makeUnsafe is required only by this existing synchronous constructor.
+     * @returns The invocation-owned instance.
+     */
+    constructor(request, discovery) {
+        this.request = request;
+        this.discovery = discovery;
+        this.#state = Ref.makeUnsafe({
+            files: new Map(),
+            dependencies: new Set(),
+            scripts: new Map(),
+            warnings: new Map(),
+            nextSteps: new Set(),
+            artifacts: [],
+            profiles: [],
+        });
+        this.#files = planBuilderFiles(this.#state, discovery);
+    }
+    /**
+     * Reads the planned source first, then the explicit filesystem service.
+     * @param path - Path inside the current project or owned resource.
+     * @returns Planned file text when present, otherwise text read through explicit filesystem authority.
+     */
+    readEffect = (path) => this.#files.readEffect(path);
+    /**
+     * Atomically reserves one create operation after checking the native destination.
+     * @param path - Path inside the current project or owned resource.
+     * @param content - Complete bytes or text planned for the destination.
+     * @param mode - Optional restored or generated permission mode.
+     * @returns Completion after collision preflight and atomic reservation of the new planned file.
+     */
+    createEffect = (path, content, mode) => this.#files.createEffect(path, content, mode);
+    /**
+     * Adds a source transformation to this request; transformations preserve expected validator errors.
+     * @param path - Path inside the current project or owned resource.
+     * @param transform - Pure transformation applied atomically to the latest planned source.
+     * @returns Completion after the transform is applied atomically to the latest planned source.
+     */
+    updateEffect = (path, transform) => this.#files.updateEffect(path, transform);
+    /**
+     * Plans an environment example only when the declaration is absent.
+     * @param name - Environment variable name.
+     * @param value - Example value used only for a new declaration.
+     * @returns An Effect planning the env example through explicit filesystem authority.
+     */
+    envExampleEffect = (name, value = "") => this.#files.envExampleEffect(name, value);
+    /**
+     * Plans a gitignore entry without duplicating an authored line.
+     * @param pattern - Declaration-owned glob or ignore pattern.
+     * @returns Completion after the missing ignore pattern is added to planned .gitignore source.
+     */
+    gitignoreEffect = (pattern) => this.#files.gitignoreEffect(pattern);
+    /**
+     * Records a required dependency through the authoritative request Ref.
+     * @param name - Authored name or declaration key.
+     * @returns Completion after the supported dependency is recorded in this request's Ref.
+     */
+    dependencyEffect = Effect.fn("PlanBuilder.dependency")((name) => Ref.update(this.#state, (state) => ({
+        ...state,
+        dependencies: new Set(state.dependencies).add(name),
+    })), (effect) => observeExecution("generator", "planning.dependency", effect));
+    /**
+     * Adds one artifact identity to the current request's discovery view.
+     * @param kind - Authoritative artifact kind.
+     * @param value - Artifact domain, source path, binding and optional identity/export form.
+     * @returns An observed Ref update registering the authoritative kind and projected artifact fields.
+     */
+    registerArtifactEffect = Effect.fn("PlanBuilder.registerArtifact")((kind, value) => Ref.update(this.#state, (state) => ({
+        ...state,
+        artifacts: [
+            ...state.artifacts,
+            {
+                kind,
+                domain: value.domain,
+                path: value.path,
+                binding: value.binding,
+                id: value.id,
+                factory: "scaffold",
+                exported: true,
+                exportKind: value.exportKind ?? "default",
+                options: [],
+            },
+        ],
+    })), (effect) => observeExecution("generator", "planning.registerArtifact", effect));
+    /**
+     * Adds one provider profile to the current request's discovery view.
+     * @param profile - Selected provider profile.
+     * @returns Completion after the discovered/planned profile projection is updated for this request.
+     */
+    registerProfileEffect = Effect.fn("PlanBuilder.registerProfile")((profile) => Ref.update(this.#state, (state) => ({ ...state, profiles: [...state.profiles, profile] })), (effect) => observeExecution("generator", "planning.registerProfile", effect));
+    /**
+     * Records one owned package script.
+     * @param name - Authored name or declaration key.
+     * @param command - Shell command stored under the package script name.
+     * @returns Completion after the script name and command are recorded for manifest planning.
+     */
+    scriptEffect = Effect.fn("PlanBuilder.script")((name, command) => Ref.update(this.#state, (state) => ({
+        ...state,
+        scripts: new Map(state.scripts).set(name, command),
+    })), (effect) => observeExecution("generator", "planning.script", effect));
+    /**
+     * Records a bounded warning by its stable code.
+     * @param code - Stable category code included in the resulting diagnostic.
+     * @param message - Existing user-facing diagnostic.
+     * @returns Completion after the warning is recorded under its stable category code.
+     */
+    warningEffect = Effect.fn("PlanBuilder.warning")((code, message) => Ref.update(this.#state, (state) => ({
+        ...state,
+        warnings: new Map(state.warnings).set(code, Object.freeze({ code, message })),
+    })), (effect) => observeExecution("generator", "planning.warning", effect));
+    /**
+     * Records one next command without duplicating it.
+     * @param command - Shell command shown as a follow-up instruction.
+     * @returns Completion after the follow-up command is deduplicated in request state.
+     */
+    nextStepEffect = Effect.fn("PlanBuilder.nextStep")((command) => Ref.update(this.#state, (state) => ({
+        ...state,
+        nextSteps: new Set(state.nextSteps).add(command),
+    })), (effect) => observeExecution("generator", "planning.nextStep", effect));
+    /**
+     * Finishes manifest ownership and returns a deterministic immutable plan.
+     * @returns The frozen plan containing ordered operations, concrete dependencies and public follow-up metadata.
+     */
+    finishEffect = Effect.fn("PlanBuilder.finish")(() => observeExecution("generator", "planning.finish", Effect.gen({ self: this }, function* () {
+        const dependencies = yield* finalizeManifestEffect(this, yield* Ref.get(this.#state));
+        const state = yield* Ref.get(this.#state);
+        return Object.freeze({
+            request: this.request,
+            projectRoot: this.discovery.projectRoot,
+            operations: Object.freeze([...state.files.values()].sort((a, b) => a.path.localeCompare(b.path))),
+            dependencies: Object.freeze(dependencies),
+            artifacts: Object.freeze(state.artifacts.map(({ kind, path, id, binding }) => ({
+                kind,
+                path,
+                id: id ?? binding,
+                binding,
+            }))),
+            profiles: Object.freeze(state.profiles.map(({ capability, name }) => ({ capability, name }))),
+            warnings: Object.freeze([...state.warnings.values()]),
+            nextSteps: Object.freeze([...state.nextSteps]),
+        });
+    })));
+    /**
+     * Returns a synchronous immutable projection of this request's authoritative Ref.
+     * @returns A new array combining discovered artifacts and this request's planned artifacts.
+     */
+    get artifacts() {
+        return [...this.discovery.artifacts, ...Ref.getUnsafe(this.#state).artifacts];
+    }
+    /**
+     * Returns a synchronous immutable profile projection of the request Ref.
+     * @returns A new array combining discovered profiles and this request's planned profiles.
+     */
+    get profiles() {
+        return [...this.discovery.profiles, ...Ref.getUnsafe(this.#state).profiles];
+    }
+}
+//# sourceMappingURL=plan-builder-effects.js.map

package/dist/plan-builder-effects.js.map

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

package/dist/plan-builder-files.d.ts

@@ -0,0 +1,12 @@
+import { Ref } from "effect";
+import type { ProjectDiscovery } from "./project-discovery-types.js";
+import type { PlanBuilderState } from "./plan-builder.types.js";
+import type { PlanBuilderFileOperations } from "./plan-builder-files.types.js";
+/**
+ * Creates private file-planning capabilities for one request Ref.
+ * @param state - The request owner's private authoritative Ref.
+ * @param discovery - Immutable declaration facts establishing the project root.
+ * @returns File Effects retaining explicit filesystem authority and atomic Ref updates.
+ */
+export declare function planBuilderFiles(state: Ref.Ref<PlanBuilderState>, discovery: ProjectDiscovery): PlanBuilderFileOperations;
+//# sourceMappingURL=plan-builder-files.d.ts.map

package/dist/plan-builder-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-builder-files.d.ts","sourceRoot":"","sources":["../src/plan-builder-files.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,GAAG,EAAE,MAAM,QAAQ,CAAC;AAGrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,gBAAgB,6BA+G7F"}

package/dist/plan-builder-files.js

@@ -0,0 +1,99 @@
+import { resolve } from "node:path";
+import { Effect, Ref } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { domainError, scaffoldErrors } from "./generator-errors.js";
+/**
+ * Creates private file-planning capabilities for one request Ref.
+ * @param state - The request owner's private authoritative Ref.
+ * @param discovery - Immutable declaration facts establishing the project root.
+ * @returns File Effects retaining explicit filesystem authority and atomic Ref updates.
+ */
+export function planBuilderFiles(state, discovery) {
+    const operations = {
+        /** Reads the planned source first, then the explicit filesystem service. */
+        readEffect: Effect.fn("PlanBuilder.read")((path) => Effect.gen(function* () {
+            const planned = (yield* Ref.get(state)).files.get(path);
+            if (planned !== undefined)
+                return planned.content;
+            return yield* (yield* GeneratorFileSystem).readText(resolve(discovery.projectRoot, path));
+        }), (effect) => observeExecution("generator", "planning.read", effect)),
+        /** Atomically reserves one create operation after checking the native destination. */
+        createEffect: Effect.fn("PlanBuilder.create")((path, content, mode) => Effect.gen(function* () {
+            const fs = yield* GeneratorFileSystem;
+            if ((yield* fs.metadata(resolve(discovery.projectRoot, path))) !== undefined)
+                return yield* collision(`${path} already exists.`);
+            const duplicate = yield* Ref.modify(state, (state) => state.files.has(path)
+                ? [true, state]
+                : [
+                    false,
+                    {
+                        ...state,
+                        files: new Map(state.files).set(path, {
+                            path,
+                            action: "create",
+                            content,
+                            ...(mode === undefined ? {} : { mode }),
+                        }),
+                    },
+                ]);
+            if (duplicate)
+                return yield* collision(`${path} already exists.`);
+        }), (effect) => observeExecution("generator", "planning.create", effect)),
+        /** Adds a source transformation to this request; transformations preserve expected validator errors. */
+        updateEffect: Effect.fn("PlanBuilder.update")((path, transform) => Effect.gen(function* () {
+            const source = yield* operations
+                .readEffect(path)
+                .pipe(Effect.mapError(() => domainError(new AddScaffoldError(ADD_FAILURE_CODES.invalidProject, `${path} does not exist.`))));
+            yield* Ref.update(state, (state) => {
+                const existing = state.files.get(path);
+                const current = existing?.content ?? source;
+                const content = transform(current);
+                return content === current
+                    ? state
+                    : {
+                        ...state,
+                        files: new Map(state.files).set(path, {
+                            path,
+                            action: existing?.action ?? "update",
+                            content,
+                            ...(existing?.mode === undefined ? {} : { mode: existing.mode }),
+                        }),
+                    };
+            }).pipe(scaffoldErrors);
+        }), (effect) => observeExecution("generator", "planning.update", effect)),
+        /** Plans an environment example without replacing an existing declaration. */
+        envExampleEffect: Effect.fn("PlanBuilder.envExample")((name, value = "") => operations.appendLineEffect(".env.example", `${name}=${value}`, (source) => new RegExp(`^${escape(name)}=`, "m").test(source)), (effect) => observeExecution("generator", "planning.envExample", effect)),
+        /** Plans a gitignore entry without duplicating an authored line. */
+        gitignoreEffect: Effect.fn("PlanBuilder.gitignore")((pattern) => operations.appendLineEffect(".gitignore", pattern, (source) => source.split(/\r?\n/).includes(pattern)), (effect) => observeExecution("generator", "planning.gitignore", effect)),
+        /** Adds an owned line only when absent from planned and native source. */
+        appendLineEffect: Effect.fn("PlanBuilder.appendLine")((path, line, present) => Effect.gen(function* () {
+            if (!(yield* Ref.get(state)).files.has(path) &&
+                (yield* (yield* GeneratorFileSystem).metadata(resolve(discovery.projectRoot, path))) ===
+                    undefined) {
+                yield* operations.createEffect(path, `${line}\n`);
+            }
+            else
+                yield* operations.updateEffect(path, (source) => present(source) ? source : `${source.trimEnd()}\n${line}\n`);
+        }), (effect) => observeExecution("generator", "planning.appendLine", effect)),
+    };
+    return operations;
+}
+/**
+ * Constructs a typed collision failure preserving its public constructor.
+ * @param message - Diagnostic explaining the conflicting declaration.
+ * @returns An Effect failing with the original RELKIT_ADD_COLLISION AddScaffoldError.
+ */
+function collision(message) {
+    return Effect.fail(domainError(new AddScaffoldError(ADD_FAILURE_CODES.collision, message)));
+}
+/**
+ * Escapes a generated environment name for a pure declaration-presence check.
+ * @param value - Environment name embedded in a declaration-presence expression.
+ * @returns The value with regular-expression metacharacters escaped.
+ */
+function escape(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=plan-builder-files.js.map

package/dist/plan-builder-files.js.map

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

package/dist/plan-builder-files.types.d.ts

@@ -0,0 +1,49 @@
+import type { Effect } from "effect";
+import type { GeneratorFileSystem } from "./generator-filesystem.js";
+import type { GeneratorDomainError, GeneratorIoError } from "./generator-errors.js";
+/** File-planning capabilities retaining their exact native read requirement. */
+export interface PlanBuilderFileOperations {
+    /**
+     * Composes read with explicit services, typed failures and owned resource lifetime.
+     * @param path - Path inside the current project or owned resource.
+     * @returns Planned file text when present, otherwise text read through explicit filesystem authority.
+     */
+    readonly readEffect: (path: string) => Effect.Effect<string, GeneratorIoError, GeneratorFileSystem>;
+    /**
+     * Composes create with explicit services, typed failures and owned resource lifetime.
+     * @param path - Path inside the current project or owned resource.
+     * @param content - Complete bytes or text planned for the destination.
+     * @param mode - Optional restored or generated permission mode.
+     * @returns Completion after collision preflight and atomic reservation of the new planned file.
+     */
+    readonly createEffect: (path: string, content: string, mode?: number) => Effect.Effect<void, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
+    /**
+     * Composes update with explicit services, typed failures and owned resource lifetime.
+     * @param path - Path inside the current project or owned resource.
+     * @param transform - Pure transformation applied atomically to the latest planned source.
+     * @returns Completion after the transform is applied atomically to the latest planned source.
+     */
+    readonly updateEffect: (path: string, transform: (source: string) => string) => Effect.Effect<void, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
+    /**
+     * Composes append Line with explicit services, typed failures and owned resource lifetime.
+     * @param path - Path inside the current project or owned resource.
+     * @param line - Complete owned line to append.
+     * @param present - Pure predicate detecting an already authored line.
+     * @returns Completion after a missing line is added without replacing an existing matching declaration.
+     */
+    readonly appendLineEffect: (path: string, line: string, present: (source: string) => boolean) => Effect.Effect<void, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
+    /**
+     * Plans an environment example only when the declaration is absent.
+     * @param name - Environment variable name.
+     * @param value - Example value used only for a new declaration.
+     * @returns An Effect planning the env example through explicit filesystem authority.
+     */
+    readonly envExampleEffect: (name: string, value?: string) => Effect.Effect<void, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
+    /**
+     * Composes gitignore with explicit services, typed failures and owned resource lifetime.
+     * @param pattern - Declaration-owned glob or ignore pattern.
+     * @returns Completion after the missing ignore pattern is added to planned .gitignore source.
+     */
+    readonly gitignoreEffect: (pattern: string) => Effect.Effect<void, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
+}
+//# sourceMappingURL=plan-builder-files.types.d.ts.map

package/dist/plan-builder-files.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-builder-files.types.d.ts","sourceRoot":"","sources":["../src/plan-builder-files.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,CACnB,IAAI,EAAE,MAAM,KACT,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IAClE;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IACvF;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,KAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IACvF;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,KACjC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IACvF;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CACzB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IACvF;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,CACxB,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;CACxF"}

package/dist/plan-builder-files.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plan-builder-files.types.js.map

package/dist/plan-builder-files.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-builder-files.types.js","sourceRoot":"","sources":["../src/plan-builder-files.types.ts"],"names":[],"mappings":""}

package/dist/plan-builder-manifest.d.ts

@@ -0,0 +1,11 @@
+import { Effect } from "effect";
+import type { PlanBuilderEffects } from "./plan-builder-effects.js";
+import type { PlanBuilderState } from "./plan-builder.types.js";
+/**
+ * Finishes dependencies, scripts and portable patches before transaction mutation begins.
+ * @param builder - Request owner whose state remains authoritative in its Ref.
+ * @param state - Read-only snapshot passed by the private request-state owner.
+ * @returns Newly introduced concrete dependencies; patch-only repair remains file operations.
+ */
+export declare const finalizeManifestEffect: (builder: PlanBuilderEffects, state: PlanBuilderState) => Effect.Effect<Record<string, string>, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, import("./generator-filesystem.js").GeneratorFileSystem>;
+//# sourceMappingURL=plan-builder-manifest.d.ts.map

package/dist/plan-builder-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-builder-manifest.d.ts","sourceRoot":"","sources":["../src/plan-builder-manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMhC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,mQAiDlC,CAAC"}

package/dist/plan-builder-manifest.js

@@ -0,0 +1,37 @@
+import { observeExecution } from "@relkit/contracts/operation";
+import { Effect } from "effect";
+import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+import { domainError, domainTry } from "./generator-errors.js";
+import { mergeScaffoldManifest, scaffoldManifestDependencies } from "./plan-manifest.js";
+import { planDependencyPatchEffect, readDrizzlePatchEffect } from "./dependency-patches.js";
+import { resolveProjectDependenciesEffect } from "./project-catalog.js";
+/**
+ * Finishes dependencies, scripts and portable patches before transaction mutation begins.
+ * @param builder - Request owner whose state remains authoritative in its Ref.
+ * @param state - Read-only snapshot passed by the private request-state owner.
+ * @returns Newly introduced concrete dependencies; patch-only repair remains file operations.
+ */
+export const finalizeManifestEffect = Effect.fn("PlanBuilder.finalizeManifest")(function* (builder, state) {
+    const source = yield* builder.readEffect("package.json");
+    const declared = yield* domainTry(() => scaffoldManifestDependencies(source));
+    const requested = Object.fromEntries([...state.dependencies].flatMap((name) => declared[name] === undefined ? [] : [[name, declared[name]]]));
+    const resolved = yield* resolveProjectDependenciesEffect(builder.discovery.projectRoot, requested);
+    const result = yield* domainTry(() => state.dependencies.size === 0 && state.scripts.size === 0
+        ? { content: source, added: {} }
+        : mergeScaffoldManifest(source, state.dependencies, state.scripts, resolved));
+    let content = result.content;
+    const dependencies = new Set([...state.dependencies, ...Object.keys(declared)]);
+    if (["drizzle-orm", "@relkit/drizzle", "@relkit/testing", "@relkit/effect-mq"].some((name) => dependencies.has(name))) {
+        const patch = yield* readDrizzlePatchEffect();
+        const planned = state.files.get(patch.path);
+        if (planned !== undefined && planned.content !== patch.content)
+            return yield* Effect.fail(domainError(new AddScaffoldError(ADD_FAILURE_CODES.collision, `${patch.path} already contains a different planned dependency patch.`)));
+        const patched = yield* planDependencyPatchEffect(builder.discovery.projectRoot, content, patch);
+        content = patched.content;
+        if (patched.operation !== undefined && planned === undefined)
+            yield* builder.createEffect(patched.operation.path, patched.operation.content);
+    }
+    yield* builder.updateEffect("package.json", () => content);
+    return result.added;
+}, (effect) => observeExecution("generator", "planning.finalizeManifest", effect));
+//# sourceMappingURL=plan-builder-manifest.js.map

package/dist/plan-builder-manifest.js.map

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