create-relkit 0.6.0 → 0.7.1

package/dist/generate.js

@@ -1,105 +1,63 @@
-import { mkdir, mkdtemp, rename } from "node:fs/promises";
-import { basename, dirname, join } from "node:path";
-import { validateCreateOptions } from "./validate.js";
-import { injectGenerateFailure, generationError, resolveRelkitExecutable, runProjectStep, throwIfAborted, } from "./generate-process.js";
-import { copyTemplate, cleanupStagedProject, customizeProject, listProjectFiles, requireFiles, requireTemplate, } from "./generate-files.js";
-import { createGenerateNextSteps } from "./generate-output.js";
-import { addToStagedProject } from "./create-additions.js";
-import { resolveTemplateRoot } from "./template-root.js";
-import {} from "./generate-types.js";
-const DIRECTORY_MODE = 0o755;
-/** Copies, validates, checks, and atomically publishes one generated project. */
+import { Context, Effect, Layer } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { generationError, throwIfAborted } from "./generate-process.js";
+import { GenerateProjectError, } from "./generate-types.js";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GeneratorProcess, generatorProcessLayer } from "./generator-process.js";
+import { GeneratorPaths } from "./generator-paths.js";
+import { GeneratorPrompt, generatorPromptLayer } from "./generator-prompt.js";
+import { createClackPromptDriver } from "./prompt-driver.js";
+import { transferCleanupFailures } from "./generator-cleanup.js";
+import { stageCleanupFor } from "./generate-stage-cleanup.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
+/** Owns one complete creation workflow, including consent and atomic publication. */
+export class ProjectGeneration extends Context.Service()("create-relkit/ProjectGeneration") {
+}
+/**
+ * Generation captures explicit filesystem, path, process and prompt authority at acquisition.
+ * @returns A ProjectGeneration Layer requiring filesystem, paths, process and prompt services.
+ */
+export const projectGenerationLive = Layer.effect(ProjectGeneration, Effect.gen(function* () {
+    const fs = yield* GeneratorFileSystem;
+    const process = yield* GeneratorProcess;
+    const paths = yield* GeneratorPaths;
+    const prompt = yield* GeneratorPrompt;
+    return ProjectGeneration.of({
+        generate: Effect.fn("ProjectGeneration.generate")((options, context) => observeExecution("generator", "generation.generate", generateEffect(options, context).pipe(Effect.provideService(GeneratorFileSystem, fs), Effect.provideService(GeneratorProcess, process), Effect.provideService(GeneratorPaths, paths), Effect.provideService(GeneratorPrompt, prompt)), () => ({ projects: 1 }))),
+    });
+}));
+/**
+ * Generates a project through explicitly acquired creation authority.
+ * @param options - Normalized creation flags.
+ * @param context - Existing template, progress and executable settings.
+ * @returns A lazy scoped workflow that settles owned resources before its result.
+ */
+export const generateProjectEffect = Effect.fn("ProjectGeneration.create")(function* (options, context = {}) {
+    return yield* (yield* ProjectGeneration).generate(options, context);
+}, (effect) => observeExecution("generator", "generation.create", effect));
+/**
+ * Preserves the public Promise API, flags, errors and generated result shape.
+ * @param options - Normalized creation flags.
+ * @param context - Existing runner, prompt and cancellation settings.
+ * @returns The generated result after atomic publication and scoped cleanup.
+ */
 export async function generateProject(options, context = {}) {
-    let validated;
-    try {
-        validated = validateCreateOptions(options, context.cwd === undefined ? {} : { cwd: context.cwd });
-    }
-    catch (error) {
-        throw generationError(error, "RELKIT_CREATE_VALIDATION_FAILED");
-    }
     throwIfAborted(context.signal);
-    context.onProgress?.(`Creating a new RELKIT app in ${validated.destination}.`);
-    const templateRoot = resolveTemplateRoot(context);
-    const template = join(templateRoot, options.jobs === undefined ? options.template : "tasks");
-    let stage;
-    let published = false;
+    let program = generateProjectEffect(options, context).pipe(Effect.provide(projectGenerationLive), Effect.provide(generatorPromptLayer(context.promptDriver ?? createClackPromptDriver("RELKIT_CREATE_CANCELLED"))));
+    if (context.commandRunner !== undefined)
+        program = program.pipe(Effect.provide(generatorProcessLayer(context.commandRunner)));
     try {
-        await requireTemplate(template);
-        await mkdir(dirname(validated.destination), { recursive: true, mode: DIRECTORY_MODE });
-        const staged = await mkdtemp(join(dirname(validated.destination), `.${basename(validated.destination)}-relkit-`));
-        stage = staged;
-        injectGenerateFailure(context, "copy");
-        await copyTemplate(template, staged);
-        injectGenerateFailure(context, "substitute");
-        await customizeProject(staged, options);
-        await requireFiles(staged, [
-            "package.json",
-            "relkit.config.ts",
-            "src/platform/env.ts",
-            ".env.example",
-            ".gitignore",
-        ]);
-        const stagedAdditions = await addToStagedProject(staged, context);
-        const additions = stagedAdditions.results;
-        if (options.install) {
-            context.onProgress?.("Installing dependencies...");
-            await runProjectStep(context, [context.bunExecutable ?? process.execPath, "install"], staged, "install", "install");
-        }
-        const git = context.gitExecutable ?? (context.commandRunner ? "git" : Bun.which("git"));
-        const gitInitialized = options.git && git !== null;
-        if (gitInitialized) {
-            context.onProgress?.("Initializing Git repository...");
-            await runProjectStep(context, [git, "init"], staged, "git", "git");
-        }
-        if (options.install) {
-            const relkit = await resolveRelkitExecutable(context, staged);
-            const deploymentCheck = options.cloud === "none" || options.deploy === "none";
-            context.onProgress?.("Checking generated project...");
-            await runProjectStep(context, [
-                relkit,
-                "doctor",
-                "--project-root",
-                staged,
-                "--no-ports",
-                ...(deploymentCheck ? ["--no-pulumi"] : []),
-            ], staged, "doctor", "doctor");
-            await runProjectStep(context, [relkit, "check", "--project-root", staged], staged, "check", "check");
-        }
-        throwIfAborted(context.signal);
-        injectGenerateFailure(context, "rename");
-        await rename(staged, validated.destination);
-        published = true;
-        return Object.freeze({
-            ok: true,
-            command: "create",
-            name: options.name,
-            template: options.template,
-            cloud: options.cloud,
-            deploy: options.deploy,
-            destination: validated.destination,
-            files: Object.freeze(await listProjectFiles(validated.destination)),
-            installed: options.install,
-            gitInitialized,
-            additions,
-            warnings: Object.freeze([
-                ...additions.flatMap((addition) => addition.warnings),
-                ...(!options.install
-                    ? [
-                        {
-                            code: "validation-skipped",
-                            message: "Install dependencies, then run bun run check.",
-                        },
-                    ]
-                    : []),
-            ]),
-            nextSteps: createGenerateNextSteps(options, validated.destination, context.cwd),
-        });
+        return await runGeneratorPromise(program, context.signal);
     }
     catch (error) {
-        const cleanup = published
-            ? undefined
-            : await cleanupStagedProject(stage, validated.destination);
-        throw generationError(error, "RELKIT_CREATE_FAILED", cleanup);
+        const cause = context.signal?.aborted
+            ? (context.signal.reason ??
+                new GenerateProjectError("RELKIT_INTERRUPTED", "Generation was interrupted."))
+            : error;
+        const cleanup = stageCleanupFor(context.signal?.aborted ? context.signal : error);
+        const failure = generationError(cause, "RELKIT_CREATE_FAILED", cleanup);
+        throw transferCleanupFailures(context.signal, transferCleanupFailures(error, failure));
     }
 }
+import { generateEffect } from "./generate-workflow.js";
 //# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/generate.service.types.d.ts

@@ -0,0 +1,15 @@
+import type { Effect } from "effect";
+import type { CreateOptions } from "./options.js";
+import type { GenerateProjectContext, GenerateProjectResult } from "./generate-types.js";
+import type { GeneratorDomainError, GeneratorIoError, GeneratorProcessError, GeneratorPromptError } from "./generator-errors.js";
+/** Creation owner, acquired with explicit I/O and interactive authority. */
+export interface ProjectGenerationService {
+    /**
+     * Creates and publishes one project after optional interactive consent.
+     * @param options - Explicit request options or declared prompt choices.
+     * @param context - Caller-owned settings and cancellation.
+     * @returns A scoped Effect returning the generated result after owned processes and cleanup settle.
+     */
+    readonly generate: (options: CreateOptions, context: GenerateProjectContext) => Effect.Effect<GenerateProjectResult, GeneratorDomainError | GeneratorIoError | GeneratorProcessError | GeneratorPromptError>;
+}
+//# sourceMappingURL=generate.service.types.d.ts.map

package/dist/generate.service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.service.types.d.ts","sourceRoot":"","sources":["../src/generate.service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,4EAA4E;AAC5E,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,CACjB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,sBAAsB,KAC5B,MAAM,CAAC,MAAM,CAChB,qBAAqB,EACrB,oBAAoB,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,oBAAoB,CACvF,CAAC;CACH"}

package/dist/generate.service.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generate.service.types.js.map

package/dist/generate.service.types.js.map

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

package/dist/generator-cleanup.d.ts

@@ -0,0 +1,27 @@
+import { Effect, Exit } from "effect";
+import type { GeneratorCleanupFailure } from "./generator-cleanup.types.js";
+export type { GeneratorCleanupFailure } from "./generator-cleanup.types.js";
+/**
+ * Reads secondary cleanup evidence without changing error identity or enumerable JSON contracts.
+ * @param value - Original public failure or completed result.
+ * @returns Immutable resource-release diagnostics, empty when cleanup succeeded.
+ */
+export declare function generatorCleanupFailures(value: unknown): readonly GeneratorCleanupFailure[];
+/**
+ * Attaches bounded release evidence to the original scoped exit's public owner.
+ * @param exit - Authoritative exit whose failure must not be replaced by release failure.
+ * @param operation - Fixed resource-release operation.
+ * @param cause - Original cleanup rejection, available for explicit diagnostic inspection.
+ * @returns Best-effort bounded warning after evidence has been retained.
+ * @param ownerOverride - Optional public owner used to retain interruption cleanup evidence.
+ */
+export declare function recordCleanupFailure(exit: Exit.Exit<unknown, unknown>, operation: GeneratorCleanupFailure["operation"], cause: unknown, ownerOverride?: unknown): Effect.Effect<void>;
+/**
+ * Retains release diagnostics when an existing compatibility contract translates a native failure.
+ * @param original - Original scoped failure.
+ * @param translated - Existing public error constructor chosen by the edge adapter.
+ * @returns The translated error with the original release evidence.
+ * @typeParam A - Public translated owner type preserved by the returned object.
+ */
+export declare function transferCleanupFailures<A extends object>(original: unknown, translated: A): A;
+//# sourceMappingURL=generator-cleanup.d.ts.map

package/dist/generator-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-cleanup.d.ts","sourceRoot":"","sources":["../src/generator-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,YAAY,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAK5E;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,uBAAuB,EAAE,CAG3F;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EACjC,SAAS,EAAE,uBAAuB,CAAC,WAAW,CAAC,EAC/C,KAAK,EAAE,OAAO,EACd,aAAa,CAAC,EAAE,OAAO,GACtB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAsBrB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAQ7F"}

package/dist/generator-cleanup.js

@@ -0,0 +1,64 @@
+import { Cause, Effect, Exit } from "effect";
+import { publicFailure } from "./generator-errors.js";
+// Weak ownership retains diagnostics without extending the lifetime of project results or errors.
+const failures = new WeakMap();
+/**
+ * Reads secondary cleanup evidence without changing error identity or enumerable JSON contracts.
+ * @param value - Original public failure or completed result.
+ * @returns Immutable resource-release diagnostics, empty when cleanup succeeded.
+ */
+export function generatorCleanupFailures(value) {
+    const owner = publicFailure(value);
+    return typeof owner === "object" && owner !== null ? (failures.get(owner) ?? []) : [];
+}
+/**
+ * Attaches bounded release evidence to the original scoped exit's public owner.
+ * @param exit - Authoritative exit whose failure must not be replaced by release failure.
+ * @param operation - Fixed resource-release operation.
+ * @param cause - Original cleanup rejection, available for explicit diagnostic inspection.
+ * @returns Best-effort bounded warning after evidence has been retained.
+ * @param ownerOverride - Optional public owner used to retain interruption cleanup evidence.
+ */
+export function recordCleanupFailure(exit, operation, cause, ownerOverride) {
+    return Effect.gen(function* () {
+        const owner = publicFailure(ownerOverride ?? (Exit.isFailure(exit) ? Cause.squash(exit.cause) : exit.value));
+        if (typeof owner === "object" && owner !== null) {
+            const original = publicFailure(cause);
+            failures.set(owner, boundedEvidence([
+                ...generatorCleanupFailures(owner),
+                Object.freeze({ operation, cause: original }),
+                ...(owner === original ? [] : generatorCleanupFailures(original)),
+            ]));
+        }
+        yield* Effect.annotateLogs(Effect.logWarning("Generator resource cleanup failed"), {
+            domain: "generator",
+            operation,
+            outcome: "cleanup-failed",
+        }).pipe(Effect.catchCause(() => Effect.void));
+    });
+}
+/**
+ * Retains release diagnostics when an existing compatibility contract translates a native failure.
+ * @param original - Original scoped failure.
+ * @param translated - Existing public error constructor chosen by the edge adapter.
+ * @returns The translated error with the original release evidence.
+ * @typeParam A - Public translated owner type preserved by the returned object.
+ */
+export function transferCleanupFailures(original, translated) {
+    const evidence = generatorCleanupFailures(original);
+    if (evidence.length > 0 && original !== translated)
+        failures.set(translated, boundedEvidence([...generatorCleanupFailures(translated), ...evidence]));
+    return translated;
+}
+/**
+ * Keeps the initial release failure and the latest diagnostics under repeated error reuse.
+ * @param evidence - Evidence collected for one public owner.
+ * @returns At most 128 immutable diagnostics, retaining the first and recent failures.
+ */
+function boundedEvidence(evidence) {
+    const first = evidence[0];
+    return Object.freeze(evidence.length <= 128 || first === undefined
+        ? [...evidence]
+        : [first, ...evidence.slice(-127)]);
+}
+//# sourceMappingURL=generator-cleanup.js.map

package/dist/generator-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-cleanup.js","sourceRoot":"","sources":["../src/generator-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAItD,kGAAkG;AAClG,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA8C,CAAC;AAE3E;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACxF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAiC,EACjC,SAA+C,EAC/C,KAAc,EACd,aAAuB;IAEvB,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,KAAK,GAAG,aAAa,CACzB,aAAa,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAChF,CAAC;QACF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACtC,QAAQ,CAAC,GAAG,CACV,KAAK,EACL,eAAe,CAAC;gBACd,GAAG,wBAAwB,CAAC,KAAK,CAAC;gBAClC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;gBAC7C,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;aAClE,CAAC,CACH,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,mCAAmC,CAAC,EAAE;YACjF,MAAM,EAAE,WAAW;YACnB,SAAS;YACT,OAAO,EAAE,gBAAgB;SAC1B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAmB,QAAiB,EAAE,UAAa;IACxF,MAAM,QAAQ,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,KAAK,UAAU;QAChD,QAAQ,CAAC,GAAG,CACV,UAAU,EACV,eAAe,CAAC,CAAC,GAAG,wBAAwB,CAAC,UAAU,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CACxE,CAAC;IACJ,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CACtB,QAA4C;IAE5C,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,MAAM,CAClB,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,KAAK,KAAK,SAAS;QAC3C,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;QACf,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CACrC,CAAC;AACJ,CAAC"}

package/dist/generator-cleanup.types.d.ts

@@ -0,0 +1,6 @@
+/** Secondary resource-release evidence, separated from the authoritative public failure. */
+export interface GeneratorCleanupFailure {
+    readonly operation: "temporary-file" | "rollback" | "marker" | "stage" | "process";
+    readonly cause: unknown;
+}
+//# sourceMappingURL=generator-cleanup.types.d.ts.map

package/dist/generator-cleanup.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-cleanup.types.d.ts","sourceRoot":"","sources":["../src/generator-cleanup.types.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACnF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB"}

package/dist/generator-cleanup.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generator-cleanup.types.js.map

package/dist/generator-cleanup.types.js.map

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

package/dist/generator-errors.d.ts

@@ -0,0 +1,74 @@
+import { Effect, Schema } from "effect";
+declare const GeneratorIoError_base: Schema.Class<GeneratorIoError, Schema.TaggedStruct<"GeneratorIoError", {
+    readonly operation: Schema.String;
+    readonly cause: Schema.Unknown;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A failed native filesystem operation, retaining its original diagnostic. */
+export declare class GeneratorIoError extends GeneratorIoError_base {
+}
+declare const GeneratorProcessError_base: Schema.Class<GeneratorProcessError, Schema.TaggedStruct<"GeneratorProcessError", {
+    readonly operation: Schema.String;
+    readonly cause: Schema.Unknown;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A failed child-process adapter operation. Command arguments are never telemetry labels. */
+export declare class GeneratorProcessError extends GeneratorProcessError_base {
+}
+declare const GeneratorPromptError_base: Schema.Class<GeneratorPromptError, Schema.TaggedStruct<"GeneratorPromptError", {
+    readonly cause: Schema.Unknown;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A failed or cancelled prompt adapter operation. */
+export declare class GeneratorPromptError extends GeneratorPromptError_base {
+}
+declare const GeneratorDomainError_base: Schema.Class<GeneratorDomainError, Schema.TaggedStruct<"GeneratorDomainError", {
+    readonly cause: Schema.Unknown;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** An expected legacy domain failure carried through a typed Effect workflow. */
+export declare class GeneratorDomainError extends GeneratorDomainError_base {
+}
+/**
+ * Executes a pure validation boundary without converting downstream defects or interruption.
+ * @typeParam A - Validated domain value.
+ * @param evaluate - Existing synchronous contract validator.
+ * @returns Its value or an identity-preserving typed domain failure.
+ */
+export declare function domainTry<A>(evaluate: () => A): Effect.Effect<A, GeneratorDomainError>;
+/**
+ * Carries an expected public error through internal domain composition.
+ * @param cause - Original public error object.
+ * @returns A schema-backed failure retaining the original object.
+ */
+export declare function domainError(cause: unknown): GeneratorDomainError;
+/**
+ * Restores the original rejection at a public Promise or synchronous adapter.
+ * @param error - Internal typed failure or already-public rejection.
+ * @returns The unchanged public error or native rejection object.
+ */
+export declare function publicFailure(error: unknown): unknown;
+/**
+ * Formats diagnostic text without assuming an Error instance.
+ * @param cause - Boundary rejection.
+ * @returns Existing message text, or the printable rejection value.
+ */
+export declare function errorMessage(cause: unknown): string;
+/**
+ * Tests an adapter rejection's native errno without an unchecked assertion.
+ * @param cause - Boundary rejection.
+ * @param code - Expected native errno.
+ * @returns Whether the original rejection declares that errno.
+ */
+export declare function hasErrno(cause: unknown, code: string): boolean;
+/**
+ * Translates only existing synchronous scaffold validators into the typed channel.
+ * @typeParam A - Planned value.
+ * @typeParam E - Existing typed failure.
+ * @typeParam R - Required services, retained unchanged.
+ * @param effect - Planning operation containing pure legacy validators.
+ * @returns The same operation; unexpected defects and interruption retain their causes.
+ */
+export declare function scaffoldErrors<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E | GeneratorDomainError, R>;
+export {};
+//# sourceMappingURL=generator-errors.d.ts.map

package/dist/generator-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-errors.d.ts","sourceRoot":"","sources":["../src/generator-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;;AAKxC,+EAA+E;AAC/E,qBAAa,gBAAiB,SAAQ,qBAIpC;CAAG;;;;;;AAEL,8FAA8F;AAC9F,qBAAa,qBAAsB,SAAQ,0BAG1C;CAAG;;;;;AAEJ,sDAAsD;AACtD,qBAAa,oBAAqB,SAAQ,yBAGzC;CAAG;;;;;AAEJ,iFAAiF;AACjF,qBAAa,oBAAqB,SAAQ,yBAGzC;CAAG;AAEJ;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAetF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOrD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACpC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,oBAAoB,EAAE,CAAC,CAAC,CAM/C"}

package/dist/generator-errors.js

@@ -0,0 +1,89 @@
+import { Effect, Schema } from "effect";
+import { AddScaffoldError } from "./add-types.js";
+import { GenerateProjectError } from "./generate-types.js";
+import { CreateValidationError } from "./validate-errors.js";
+/** A failed native filesystem operation, retaining its original diagnostic. */
+export class GeneratorIoError extends Schema.TaggedError()("GeneratorIoError", {
+    operation: Schema.String,
+    cause: Schema.Unknown,
+    message: Schema.String,
+}) {
+}
+/** A failed child-process adapter operation. Command arguments are never telemetry labels. */
+export class GeneratorProcessError extends Schema.TaggedError()("GeneratorProcessError", { operation: Schema.String, cause: Schema.Unknown, message: Schema.String }) {
+}
+/** A failed or cancelled prompt adapter operation. */
+export class GeneratorPromptError extends Schema.TaggedError()("GeneratorPromptError", { cause: Schema.Unknown, message: Schema.String }) {
+}
+/** An expected legacy domain failure carried through a typed Effect workflow. */
+export class GeneratorDomainError extends Schema.TaggedError()("GeneratorDomainError", { cause: Schema.Unknown, message: Schema.String }) {
+}
+/**
+ * Executes a pure validation boundary without converting downstream defects or interruption.
+ * @typeParam A - Validated domain value.
+ * @param evaluate - Existing synchronous contract validator.
+ * @returns Its value or an identity-preserving typed domain failure.
+ */
+export function domainTry(evaluate) {
+    return Effect.try({ try: evaluate, catch: (cause) => cause }).pipe(Effect.catch((cause) => cause instanceof AddScaffoldError ||
+        cause instanceof CreateValidationError ||
+        cause instanceof GenerateProjectError ||
+        cause instanceof SyntaxError ||
+        (cause instanceof Error &&
+            "code" in cause &&
+            typeof cause.code === "string" &&
+            cause.code.startsWith("RELKIT_"))
+        ? Effect.fail(domainError(cause))
+        : Effect.die(cause)));
+}
+/**
+ * Carries an expected public error through internal domain composition.
+ * @param cause - Original public error object.
+ * @returns A schema-backed failure retaining the original object.
+ */
+export function domainError(cause) {
+    return new GeneratorDomainError({ cause, message: errorMessage(cause) });
+}
+/**
+ * Restores the original rejection at a public Promise or synchronous adapter.
+ * @param error - Internal typed failure or already-public rejection.
+ * @returns The unchanged public error or native rejection object.
+ */
+export function publicFailure(error) {
+    return error instanceof GeneratorIoError ||
+        error instanceof GeneratorProcessError ||
+        error instanceof GeneratorPromptError ||
+        error instanceof GeneratorDomainError
+        ? publicFailure(error.cause)
+        : error;
+}
+/**
+ * Formats diagnostic text without assuming an Error instance.
+ * @param cause - Boundary rejection.
+ * @returns Existing message text, or the printable rejection value.
+ */
+export function errorMessage(cause) {
+    return cause instanceof Error ? cause.message : String(cause);
+}
+/**
+ * Tests an adapter rejection's native errno without an unchecked assertion.
+ * @param cause - Boundary rejection.
+ * @param code - Expected native errno.
+ * @returns Whether the original rejection declares that errno.
+ */
+export function hasErrno(cause, code) {
+    const original = publicFailure(cause);
+    return original instanceof Error && "code" in original && original.code === code;
+}
+/**
+ * Translates only existing synchronous scaffold validators into the typed channel.
+ * @typeParam A - Planned value.
+ * @typeParam E - Existing typed failure.
+ * @typeParam R - Required services, retained unchanged.
+ * @param effect - Planning operation containing pure legacy validators.
+ * @returns The same operation; unexpected defects and interruption retain their causes.
+ */
+export function scaffoldErrors(effect) {
+    return effect.pipe(Effect.catchDefect((error) => error instanceof AddScaffoldError ? Effect.fail(domainError(error)) : Effect.die(error)));
+}
+//# sourceMappingURL=generator-errors.js.map

package/dist/generator-errors.js.map

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

package/dist/generator-filesystem.d.ts

@@ -0,0 +1,25 @@
+import { Context, Layer } from "effect";
+import type { GeneratorFileSystemService } from "./generator-filesystem.types.js";
+declare const GeneratorFileSystem_base: Context.ServiceClass<GeneratorFileSystem, "create-relkit/GeneratorFileSystem", GeneratorFileSystemService>;
+/**
+ * Native filesystem authority supplied through live or deterministic test Layers.
+ * @remarks Mutating operations are masked until native physical settlement. This boundary
+ * prevents a pending write or mkdir from racing scope rollback after interruption.
+ * Readers remain interruptible; metadata checks never dereference symlinks.
+ * @example
+ * ```ts
+ * import { Effect } from "effect";
+ * import { GeneratorFileSystem, generatorFileSystemLive } from "create-relkit";
+ * const inspect = GeneratorFileSystem.use((fs) => fs.metadata("./package.json"));
+ * const supplied = inspect.pipe(Effect.provide(generatorFileSystemLive));
+ * ```
+ */
+export declare class GeneratorFileSystem extends GeneratorFileSystem_base {
+}
+/**
+ * Live Node/Bun adapter. Mutating calls settle before scoped transaction cleanup can run.
+ * @returns A native GeneratorFileSystem Layer with no external service requirements.
+ */
+export declare const generatorFileSystemLive: Layer.Layer<GeneratorFileSystem, never, never>;
+export {};
+//# sourceMappingURL=generator-filesystem.d.ts.map

package/dist/generator-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-filesystem.d.ts","sourceRoot":"","sources":["../src/generator-filesystem.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,iCAAiC,CAAC;;AAEzC;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,SAAQ,wBAGD;CAAG;AAE3C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gDA4EnC,CAAC"}

package/dist/generator-filesystem.js

@@ -0,0 +1,68 @@
+import * as fs from "node:fs/promises";
+import { Context, Effect, Layer } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { GeneratorIoError, errorMessage, hasErrno } from "./generator-errors.js";
+/**
+ * Native filesystem authority supplied through live or deterministic test Layers.
+ * @remarks Mutating operations are masked until native physical settlement. This boundary
+ * prevents a pending write or mkdir from racing scope rollback after interruption.
+ * Readers remain interruptible; metadata checks never dereference symlinks.
+ * @example
+ * ```ts
+ * import { Effect } from "effect";
+ * import { GeneratorFileSystem, generatorFileSystemLive } from "create-relkit";
+ * const inspect = GeneratorFileSystem.use((fs) => fs.metadata("./package.json"));
+ * const supplied = inspect.pipe(Effect.provide(generatorFileSystemLive));
+ * ```
+ */
+export class GeneratorFileSystem extends Context.Service()("create-relkit/GeneratorFileSystem") {
+}
+/**
+ * Live Node/Bun adapter. Mutating calls settle before scoped transaction cleanup can run.
+ * @returns A native GeneratorFileSystem Layer with no external service requirements.
+ */
+export const generatorFileSystemLive = Layer.effect(GeneratorFileSystem, Effect.gen(function* () {
+    return GeneratorFileSystem.of({
+        readText: Effect.fn("GeneratorFileSystem.readText")((path) => io("readText", (signal) => fs.readFile(path, { encoding: "utf8", signal })), (effect) => observeExecution("generator", "filesystem.readText", effect)),
+        readBytes: Effect.fn("GeneratorFileSystem.readBytes")((path) => io("readBytes", (signal) => fs.readFile(path, { signal })), (effect) => observeExecution("generator", "filesystem.readBytes", effect)),
+        access: Effect.fn("GeneratorFileSystem.access")((path) => io("access", () => fs.access(path)), (effect) => observeExecution("generator", "filesystem.access", effect)),
+        metadata: Effect.fn("GeneratorFileSystem.metadata")((path) => io("metadata", () => fs.lstat(path)).pipe(Effect.map((info) => ({ kind: entryKind(info), mode: info.mode & 0o777 })), Effect.catchIf((error) => hasErrno(error, "ENOENT"), () => Effect.succeed(undefined))), (effect) => observeExecution("generator", "filesystem.metadata", effect)),
+        entries: Effect.fn("GeneratorFileSystem.entries")((path) => io("entries", () => fs.readdir(path, { withFileTypes: true })).pipe(Effect.map((entries) => entries.map((entry) => ({ name: entry.name, kind: entryKind(entry) })))), (effect) => observeExecution("generator", "filesystem.entries", effect)),
+        write: Effect.fn("GeneratorFileSystem.write")((path, content, options = {}) => io("write", () => fs.writeFile(path, content, options)).pipe(Effect.uninterruptible), (effect) => observeExecution("generator", "filesystem.write", effect)),
+        mkdir: Effect.fn("GeneratorFileSystem.mkdir")((path, options = {}) => io("mkdir", () => fs.mkdir(path, options)).pipe(Effect.asVoid, Effect.uninterruptible), (effect) => observeExecution("generator", "filesystem.mkdir", effect)),
+        temporaryDirectory: Effect.fn("GeneratorFileSystem.temporaryDirectory")((prefix) => io("temporaryDirectory", () => fs.mkdtemp(prefix)).pipe(Effect.uninterruptible), (effect) => observeExecution("generator", "filesystem.temporaryDirectory", effect)),
+        rename: Effect.fn("GeneratorFileSystem.rename")((from, to) => io("rename", () => fs.rename(from, to)).pipe(Effect.uninterruptible), (effect) => observeExecution("generator", "filesystem.rename", effect)),
+        remove: Effect.fn("GeneratorFileSystem.remove")((path, options = {}) => io("remove", () => fs.rm(path, options)).pipe(Effect.uninterruptible), (effect) => observeExecution("generator", "filesystem.remove", effect)),
+        removeDirectory: Effect.fn("GeneratorFileSystem.removeDirectory")((path) => io("removeDirectory", () => fs.rmdir(path)).pipe(Effect.uninterruptible), (effect) => observeExecution("generator", "filesystem.removeDirectory", effect)),
+        chmod: Effect.fn("GeneratorFileSystem.chmod")((path, mode) => io("chmod", () => fs.chmod(path, mode)).pipe(Effect.uninterruptible), (effect) => observeExecution("generator", "filesystem.chmod", effect)),
+        glob: Effect.fn("GeneratorFileSystem.glob")((root, pattern) => io("glob", () => Array.fromAsync(new Bun.Glob(pattern).scan({ cwd: root, onlyFiles: true }))).pipe(Effect.map((paths) => paths.sort())), (effect) => observeExecution("generator", "filesystem.glob", effect)),
+    });
+}));
+/**
+ * Adapts one native operation at the authority boundary.
+ * @typeParam A - Native result.
+ * @param operation - Fixed filesystem operation label.
+ * @param execute - Native call; cancellable readers receive the fiber's AbortSignal.
+ * @returns An observed typed filesystem operation.
+ */
+function io(operation, execute) {
+    return Effect.tryPromise({
+        try: execute,
+        catch: (cause) => new GeneratorIoError({ operation, cause, message: errorMessage(cause) }),
+    });
+}
+/**
+ * Classifies native entries without dereferencing a symlink.
+ * @param entry - Native lstat or directory entry.
+ * @returns The generator's bounded entry kind.
+ */
+function entryKind(entry) {
+    return entry.isSymbolicLink()
+        ? "symlink"
+        : entry.isDirectory()
+            ? "directory"
+            : entry.isFile()
+                ? "file"
+                : "other";
+}
+//# sourceMappingURL=generator-filesystem.js.map