create-relkit 0.6.0 → 0.7.0

package/dist/add-resolver.d.ts

@@ -1,14 +1,38 @@
+import { Context, Effect, Layer } from "effect";
 import { type AddRequest } from "./add-types.js";
-import { type PromptDriver } from "./prompt-driver.js";
-export interface ResolveAddContext {
-    readonly cwd?: string;
-    readonly interactive?: boolean;
-    readonly promptDriver?: PromptDriver;
-}
-export interface ResolvedAddRequest {
-    readonly request: AddRequest;
-    readonly prompted: boolean;
+import { ProjectDiscoveryServiceTag } from "./project-discovery.js";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GeneratorPrompt } from "./generator-prompt.js";
+import type { AddResolutionService, ResolveAddContext, ResolvedAddRequest } from "./add-resolver.types.js";
+export type { ResolveAddContext, ResolvedAddRequest } from "./add-resolver.types.js";
+declare const AddResolution_base: Context.ServiceClass<AddResolution, "create-relkit/AddResolution", AddResolutionService>;
+/** Ordered interactive-add resolution, distinct from applying the user's final consent. */
+export declare class AddResolution extends AddResolution_base {
 }
+/**
+ * Captures declaration discovery, filesystem reads and prompt input at the owning Layer boundary.
+ * @returns An AddResolution Layer requiring discovery, filesystem and prompt services.
+ */
+export declare const addResolutionLive: Layer.Layer<AddResolution, never, GeneratorFileSystem | ProjectDiscoveryServiceTag | GeneratorPrompt>;
+/**
+ * Resolves a request through explicit add-resolution authority while retaining consent metadata.
+ * @param args - Literal flag and positional arguments.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The validated add request and whether resolution asked for interactive input.
+ */
+export declare const resolveAddRequestDetailsEffect: (args: readonly string[], context?: ResolveAddContext | undefined) => Effect.Effect<ResolvedAddRequest, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorPromptError | import("./generator-errors.js").GeneratorDomainError, AddResolution>;
+/**
+ * Preserves the existing normalized-request Promise API.
+ * @param args - Literal flag and positional arguments.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The validated add request after all required choices are resolved.
+ */
 export declare function resolveAddRequest(args: readonly string[], context?: ResolveAddContext): Promise<AddRequest>;
+/**
+ * Preserves the existing detailed Promise API and add-flow consent behavior.
+ * @param args - Literal flag and positional arguments.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The validated request and prompt-consent metadata after native input settles.
+ */
 export declare function resolveAddRequestDetails(args: readonly string[], context?: ResolveAddContext): Promise<ResolvedAddRequest>;
 //# sourceMappingURL=add-resolver.d.ts.map

package/dist/add-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-resolver.d.ts","sourceRoot":"","sources":["../src/add-resolver.ts"],"names":[],"mappings":"AAOA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAErB;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAyB7B"}
+{"version":3,"file":"add-resolver.d.ts","sourceRoot":"","sources":["../src/add-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAShD,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAwB,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAI9E,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;;AAErF,2FAA2F;AAC3F,qBAAa,aAAc,SAAQ,kBAElC;CAAG;AAEJ;;;GAGG;AACH,eAAO,MAAM,iBAAiB,uGAoD7B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,wRAK1C,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAS7B"}

package/dist/add-resolver.js

@@ -1,41 +1,80 @@
+import { Context, Effect, Layer } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
 import { normalizeAddRequest } from "./add-options.js";
 import { usage } from "./add-options-parser.js";
-import { resolveDomainOptions } from "./add-resolver-domain.js";
-import { resolvePlatformOptions } from "./add-resolver-platform.js";
-import { resolveResourceOptions } from "./add-resolver-resources.js";
-import { resolveServiceForKind } from "./add-resolution-discovery.js";
+import { resolveDomainOptionsEffect } from "./add-resolver-domain.js";
+import { resolvePlatformOptionsEffect } from "./add-resolver-platform.js";
+import { resolveResourceOptionsEffect } from "./add-resolver-resources.js";
+import { resolveServiceForKindEffect } from "./add-resolution-discovery.js";
 import { AddResolutionState, choices } from "./add-resolution-state.js";
 import { ADD_KINDS } from "./add-types.js";
-import { discoverProject } from "./project-discovery.js";
+import { ProjectDiscoveryServiceTag, projectDiscoveryLive } from "./project-discovery.js";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GeneratorPrompt, generatorPromptLayer } from "./generator-prompt.js";
+import { domainTry, scaffoldErrors } from "./generator-errors.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
 import { createClackPromptDriver } from "./prompt-driver.js";
+/** Ordered interactive-add resolution, distinct from applying the user's final consent. */
+export class AddResolution extends Context.Service()("create-relkit/AddResolution") {
+}
+/**
+ * Captures declaration discovery, filesystem reads and prompt input at the owning Layer boundary.
+ * @returns An AddResolution Layer requiring discovery, filesystem and prompt services.
+ */
+export const addResolutionLive = Layer.effect(AddResolution, Effect.gen(function* () {
+    const discovery = yield* ProjectDiscoveryServiceTag;
+    const fs = yield* GeneratorFileSystem;
+    const prompt = yield* GeneratorPrompt;
+    return AddResolution.of({
+        resolve: Effect.fn("AddResolution.resolve")((args, context) => observeExecution("generator", "add.resolve", Effect.gen(function* () {
+            const interactive = context.interactive === true;
+            const input = [...args];
+            let prompted = false;
+            if (!ADD_KINDS.some((kind) => kind === input[0])) {
+                if (!interactive)
+                    usage("Usage: relkit add <kind> [name] [options]");
+                input.unshift(yield* prompt.select({
+                    message: "What would you like to add?",
+                    options: choices(ADD_KINDS),
+                }));
+                prompted = true;
+            }
+            const state = new AddResolutionState(input, context.cwd, interactive, context.promptDriver);
+            const facts = yield* discovery.discover(state.parsed.projectRoot);
+            yield* resolveServiceForKindEffect(state, facts);
+            yield* resolveDomainOptionsEffect(state, facts);
+            yield* resolveResourceOptionsEffect(state, facts);
+            yield* resolvePlatformOptionsEffect(state, facts);
+            const request = yield* domainTry(() => normalizeAddRequest(state.args, context.cwd === undefined ? {} : { cwd: context.cwd }));
+            return Object.freeze({ request, prompted: prompted || state.prompted });
+        }).pipe(scaffoldErrors, Effect.provideService(GeneratorFileSystem, fs), Effect.provideService(GeneratorPrompt, prompt)))),
+    });
+}));
+/**
+ * Resolves a request through explicit add-resolution authority while retaining consent metadata.
+ * @param args - Literal flag and positional arguments.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The validated add request and whether resolution asked for interactive input.
+ */
+export const resolveAddRequestDetailsEffect = Effect.fn("AddResolution.details")(function* (args, context = {}) {
+    return yield* (yield* AddResolution).resolve(args, context);
+}, (effect) => observeExecution("generator", "add.resolve.details", effect));
+/**
+ * Preserves the existing normalized-request Promise API.
+ * @param args - Literal flag and positional arguments.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The validated add request after all required choices are resolved.
+ */
 export async function resolveAddRequest(args, context = {}) {
     return (await resolveAddRequestDetails(args, context)).request;
 }
-export async function resolveAddRequestDetails(args, context = {}) {
-    const interactive = context.interactive === true;
-    const prompt = interactive ? (context.promptDriver ?? createClackPromptDriver()) : undefined;
-    const input = [...args];
-    let prompted = false;
-    if (!ADD_KINDS.includes(input[0])) {
-        if (!interactive || !prompt)
-            usage("Usage: relkit add <kind> [name] [options]");
-        const kind = await prompt.select({
-            message: "What would you like to add?",
-            options: choices(ADD_KINDS),
-        });
-        input.unshift(kind);
-        prompted = true;
-    }
-    const state = new AddResolutionState(input, context.cwd, interactive, prompt);
-    const discovery = await discoverProject(state.parsed.projectRoot);
-    await resolveServiceForKind(state, discovery);
-    await resolveDomainOptions(state, discovery);
-    await resolveResourceOptions(state, discovery);
-    await resolvePlatformOptions(state, discovery);
-    const normalizeContext = context.cwd === undefined ? {} : { cwd: context.cwd };
-    return Object.freeze({
-        request: normalizeAddRequest(state.args, normalizeContext),
-        prompted: prompted || state.prompted,
-    });
+/**
+ * Preserves the existing detailed Promise API and add-flow consent behavior.
+ * @param args - Literal flag and positional arguments.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The validated request and prompt-consent metadata after native input settles.
+ */
+export function resolveAddRequestDetails(args, context = {}) {
+    return runGeneratorPromise(resolveAddRequestDetailsEffect(args, context).pipe(Effect.provide(addResolutionLive), Effect.provide(projectDiscoveryLive), Effect.provide(generatorPromptLayer(context.promptDriver ?? createClackPromptDriver()))), context.signal);
 }
 //# sourceMappingURL=add-resolver.js.map

package/dist/add-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-resolver.js","sourceRoot":"","sources":["../src/add-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAqB,MAAM,oBAAoB,CAAC;AAahF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAuB,EACvB,UAA6B,EAAE;IAE/B,OAAO,CAAC,MAAM,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAAuB,EACvB,UAA6B,EAAE;IAE/B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,KAAK,IAAI,CAAC;IACjD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,uBAAuB,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAA+B,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YAC/B,OAAO,EAAE,6BAA6B;YACtC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;SAC5B,CAAC,CAAC;QACH,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAClE,MAAM,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,oBAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC;QAC1D,QAAQ,EAAE,QAAQ,IAAI,KAAK,CAAC,QAAQ;KACrC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"add-resolver.js","sourceRoot":"","sources":["../src/add-resolver.ts"],"names":[],"mappings":"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"}

package/dist/add-resolver.types.d.ts

@@ -0,0 +1,27 @@
+import type { Effect } from "effect";
+import type { AddRequest } from "./add-types.js";
+import type { PromptDriver } from "./prompt-driver.types.js";
+import type { GeneratorDomainError, GeneratorIoError, GeneratorPromptError } from "./generator-errors.js";
+/** Existing interactive-add resolution context. */
+export interface ResolveAddContext {
+    readonly cwd?: string;
+    readonly interactive?: boolean;
+    readonly promptDriver?: PromptDriver;
+    readonly signal?: AbortSignal;
+}
+/** Existing resolved add request and consent-relevant prompted flag. */
+export interface ResolvedAddRequest {
+    readonly request: AddRequest;
+    readonly prompted: boolean;
+}
+/** Finite add-resolution owner with explicit discovery, prompt and source authority. */
+export interface AddResolutionService {
+    /**
+     * Resolves missing interactive add choices against source-discovered facts.
+     * @param args - Literal flag and positional arguments.
+     * @param context - Caller-owned settings and cancellation.
+     * @returns An Effect returning a validated request and whether resolution prompted.
+     */
+    readonly resolve: (args: readonly string[], context: ResolveAddContext) => Effect.Effect<ResolvedAddRequest, GeneratorDomainError | GeneratorIoError | GeneratorPromptError>;
+}
+//# sourceMappingURL=add-resolver.types.d.ts.map

package/dist/add-resolver.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-resolver.types.d.ts","sourceRoot":"","sources":["../src/add-resolver.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wFAAwF;AACxF,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,iBAAiB,KACvB,MAAM,CAAC,MAAM,CAChB,kBAAkB,EAClB,oBAAoB,GAAG,gBAAgB,GAAG,oBAAoB,CAC/D,CAAC;CACH"}

package/dist/add-resolver.types.js

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

package/dist/add-resolver.types.js.map

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

package/dist/add-transaction-files-compat.d.ts

@@ -0,0 +1,33 @@
+import { type ScaffoldFileOperation } from "./add-types.js";
+import type { FileSnapshot } from "./add-transaction-files.types.js";
+/**
+ * Preserves the existing snapshot Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @param includeLock - Whether install may mutate either Bun lock format.
+ * @returns Snapshots of original bytes/modes for touched files and required Bun lockfiles.
+ */
+export declare function snapshotFiles(root: string, operations: readonly ScaffoldFileOperation[], includeLock: boolean): Promise<readonly FileSnapshot[]>;
+/**
+ * Preserves the existing preflight Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function validateOperationActions(root: string, operations: readonly ScaffoldFileOperation[]): Promise<void>;
+/**
+ * Preserves the existing ordered file-write Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @param createdDirectories - Directories owned by this transaction.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function applyFileOperations(root: string, operations: readonly ScaffoldFileOperation[], createdDirectories: Set<string>): Promise<void>;
+/**
+ * Preserves the existing byte-and-mode restoration Promise API.
+ * @param snapshots - Pre-mutation bytes and permission snapshots.
+ * @param createdDirectories - Directories owned by this transaction.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function restoreFiles(snapshots: readonly FileSnapshot[], createdDirectories: ReadonlySet<string>): Promise<void>;
+//# sourceMappingURL=add-transaction-files-compat.d.ts.map

package/dist/add-transaction-files-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-transaction-files-compat.d.ts","sourceRoot":"","sources":["../src/add-transaction-files-compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAI5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,SAAS,qBAAqB,EAAE,EAC5C,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAC3C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,SAAS,qBAAqB,EAAE,EAC5C,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,YAAY,EAAE,EAClC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/add-transaction-files-compat.js

@@ -0,0 +1,42 @@
+import {} from "./add-types.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
+/**
+ * Preserves the existing snapshot Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @param includeLock - Whether install may mutate either Bun lock format.
+ * @returns Snapshots of original bytes/modes for touched files and required Bun lockfiles.
+ */
+export function snapshotFiles(root, operations, includeLock) {
+    return runGeneratorPromise(snapshotFilesEffect(root, operations, includeLock));
+}
+/**
+ * Preserves the existing preflight Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function validateOperationActions(root, operations) {
+    return runGeneratorPromise(validateOperationActionsEffect(root, operations));
+}
+/**
+ * Preserves the existing ordered file-write Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @param createdDirectories - Directories owned by this transaction.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function applyFileOperations(root, operations, createdDirectories) {
+    return runGeneratorPromise(applyFileOperationsEffect(root, operations, createdDirectories));
+}
+/**
+ * Preserves the existing byte-and-mode restoration Promise API.
+ * @param snapshots - Pre-mutation bytes and permission snapshots.
+ * @param createdDirectories - Directories owned by this transaction.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function restoreFiles(snapshots, createdDirectories) {
+    return runGeneratorPromise(restoreFilesEffect(snapshots, createdDirectories));
+}
+import { snapshotFilesEffect, validateOperationActionsEffect, applyFileOperationsEffect, restoreFilesEffect, } from "./add-transaction-files.js";
+//# sourceMappingURL=add-transaction-files-compat.js.map

package/dist/add-transaction-files-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-transaction-files-compat.js","sourceRoot":"","sources":["../src/add-transaction-files-compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAI7D;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,UAA4C,EAC5C,WAAoB;IAEpB,OAAO,mBAAmB,CAAC,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,UAA4C;IAE5C,OAAO,mBAAmB,CAAC,8BAA8B,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,UAA4C,EAC5C,kBAA+B;IAE/B,OAAO,mBAAmB,CAAC,yBAAyB,CAAC,IAAI,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAkC,EAClC,kBAAuC;IAEvC,OAAO,mBAAmB,CAAC,kBAAkB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC"}

package/dist/add-transaction-files.d.ts

@@ -1,12 +1,52 @@
+import { Effect } from "effect";
 import { type ScaffoldFileOperation } from "./add-types.js";
-export interface FileSnapshot {
-    readonly path: string;
-    readonly content?: Uint8Array;
-    readonly mode?: number;
-}
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import type { FileSnapshot } from "./add-transaction-files.types.js";
+export type { FileSnapshot } from "./add-transaction-files.types.js";
+/**
+ * Resolves one relative operation while rejecting broad and escaping paths.
+ * @param root - Absolute project root.
+ * @param path - Planned source-relative path.
+ * @returns Safe absolute destination.
+ */
 export declare function operationPath(root: string, path: string): string;
-export declare function snapshotFiles(root: string, operations: readonly ScaffoldFileOperation[], includeLock: boolean): Promise<readonly FileSnapshot[]>;
-export declare function validateOperationActions(root: string, operations: readonly ScaffoldFileOperation[]): Promise<void>;
-export declare function applyFileOperations(root: string, operations: readonly ScaffoldFileOperation[], createdDirectories: Set<string>): Promise<void>;
-export declare function restoreFiles(snapshots: readonly FileSnapshot[], createdDirectories: ReadonlySet<string>): Promise<void>;
+/**
+ * Snapshots bytes and modes, including both Bun lock formats when installation is required.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @param includeLock - Whether install may mutate either Bun lock format.
+ * @returns Original bytes/modes for touched files and required Bun lockfiles, read with bounded concurrency.
+ */
+export declare const snapshotFilesEffect: (root: string, operations: readonly ScaffoldFileOperation[], includeLock: boolean) => Effect.Effect<({
+    path: string;
+    content?: never;
+    mode?: never;
+} | {
+    path: string;
+    content: Uint8Array<ArrayBufferLike>;
+    mode: number;
+})[], import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Validates every destination before any transaction write, retaining deterministic error order.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @returns Completion when every ordered operation passes path/action/collision preflight.
+ */
+export declare const validateOperationActionsEffect: (root: string, operations: readonly ScaffoldFileOperation[]) => Effect.Effect<void, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Applies planned files in order; each temporary atomic-write asset has its own scope.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @param createdDirectories - Directories owned by this transaction.
+ * @returns Completion after all ordered atomic writes and owned temporary-file cleanup settle.
+ */
+export declare const applyFileOperationsEffect: (root: string, operations: readonly ScaffoldFileOperation[], createdDirectories: Set<string>) => Effect.Effect<void, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Restores all touched files even when one restoration fails, then removes only owned empty directories.
+ * @param snapshots - Pre-mutation bytes and permission snapshots.
+ * @param createdDirectories - Directories owned by this transaction.
+ * @returns Completion after every restoration and owned directory cleanup attempt; failures retain secondary evidence.
+ */
+export declare const restoreFilesEffect: (snapshots: readonly FileSnapshot[], createdDirectories: ReadonlySet<string>) => Effect.Effect<undefined, import("./generator-errors.js").GeneratorIoError, GeneratorFileSystem>;
+export { snapshotFiles, validateOperationActions, applyFileOperations, restoreFiles, } from "./add-transaction-files-compat.js";
 //# sourceMappingURL=add-transaction-files.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"add-transaction-files.d.ts","sourceRoot":"","sources":["../src/add-transaction-files.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuC,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEjG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUhE;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,SAAS,qBAAqB,EAAE,EAC5C,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAalC;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAC3C,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,SAAS,qBAAqB,EAAE,EAC5C,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,SAAS,YAAY,EAAE,EAClC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAQf"}
+{"version":3,"file":"add-transaction-files.d.ts","sourceRoot":"","sources":["../src/add-transaction-files.ts"],"names":[],"mappings":"AAMA,OAAO,EAAS,MAAM,EAAQ,MAAM,QAAQ,CAAC;AAE7C,OAAO,EAAuC,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEjG,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAIrE,YAAY,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAShE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;mIAqB/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,mNAmB1C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,oPAerC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,kLA+B9B,CAAC;AAwEF,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,GACb,MAAM,mCAAmC,CAAC"}

package/dist/add-transaction-files.js

@@ -1,103 +1,151 @@
+import { observeExecution } from "@relkit/contracts/operation";
 import { randomUUID } from "node:crypto";
-import { lstat, mkdir, readFile, rename, rm, rmdir, writeFile, chmod } from "node:fs/promises";
 import { dirname, relative, resolve, sep } from "node:path";
+import { Cause, Effect, Exit } from "effect";
 import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { domainError, hasErrno } from "./generator-errors.js";
+import { recordCleanupFailure } from "./generator-cleanup.js";
+/**
+ * Resolves one relative operation while rejecting broad and escaping paths.
+ * @param root - Absolute project root.
+ * @param path - Planned source-relative path.
+ * @returns Safe absolute destination.
+ */
 export function operationPath(root, path) {
     const absolute = resolve(root, path);
     const local = relative(root, absolute);
-    if (local === "" || local === ".." || local.startsWith(`..${sep}`)) {
+    if (local === "" || local === ".." || local.startsWith(`..${sep}`))
         throw new AddScaffoldError(ADD_FAILURE_CODES.collision, `Scaffold path escapes the project: ${path}`);
-    }
     return absolute;
 }
-export async function snapshotFiles(root, operations, includeLock) {
+/**
+ * Snapshots bytes and modes, including both Bun lock formats when installation is required.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @param includeLock - Whether install may mutate either Bun lock format.
+ * @returns Original bytes/modes for touched files and required Bun lockfiles, read with bounded concurrency.
+ */
+export const snapshotFilesEffect = Effect.fn("ScaffoldFiles.snapshot")(function* (root, operations, includeLock) {
+    const fs = yield* GeneratorFileSystem;
     const paths = new Set(operations.map((operation) => operationPath(root, operation.path)));
-    if (includeLock)
+    if (includeLock) {
         paths.add(resolve(root, "bun.lock"));
-    const snapshots = [];
-    for (const path of paths) {
-        const metadata = await metadataFor(path);
-        if (metadata === undefined)
-            snapshots.push({ path });
-        else {
-            if (!metadata.isFile())
-                collision(`${path} is not a regular file.`);
-            snapshots.push({ path, content: await readFile(path), mode: metadata.mode & 0o777 });
-        }
+        paths.add(resolve(root, "bun.lockb"));
     }
-    return snapshots;
-}
-export async function validateOperationActions(root, operations) {
+    return yield* Effect.forEach([...paths], (path) => Effect.gen(function* () {
+        const metadata = yield* fs.metadata(path);
+        if (metadata === undefined)
+            return { path };
+        if (metadata.kind !== "file")
+            return yield* collision(`${path} is not a regular file.`);
+        return { path, content: yield* fs.readBytes(path), mode: metadata.mode };
+    }), { concurrency: 4 });
+}, (effect) => observeExecution("generator", "transaction.files.snapshot", effect));
+/**
+ * Validates every destination before any transaction write, retaining deterministic error order.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @returns Completion when every ordered operation passes path/action/collision preflight.
+ */
+export const validateOperationActionsEffect = Effect.fn("ScaffoldFiles.validate")(function* (root, operations) {
+    const fs = yield* GeneratorFileSystem;
     const seen = new Set();
-    for (const operation of operations) {
+    yield* Effect.forEach(operations, (operation) => Effect.gen(function* () {
         const path = operationPath(root, operation.path);
         if (seen.has(path))
-            collision(`Scaffold plan contains duplicate path ${operation.path}.`);
+            return yield* collision(`Scaffold plan contains duplicate path ${operation.path}.`);
         seen.add(path);
-        const exists = (await metadataFor(path)) !== undefined;
+        const exists = (yield* fs.metadata(path)) !== undefined;
         if (operation.action === "create" && exists)
-            collision(`${operation.path} already exists.`);
+            return yield* collision(`${operation.path} already exists.`);
         if (operation.action === "update" && !exists)
-            collision(`${operation.path} does not exist.`);
-    }
-}
-export async function applyFileOperations(root, operations, createdDirectories) {
-    for (const operation of operations) {
+            return yield* collision(`${operation.path} does not exist.`);
+    }));
+}, (effect) => observeExecution("generator", "transaction.files.validate", effect));
+/**
+ * Applies planned files in order; each temporary atomic-write asset has its own scope.
+ * @param root - Absolute project or owned resource root.
+ * @param operations - Ordered planned create/update file operations.
+ * @param createdDirectories - Directories owned by this transaction.
+ * @returns Completion after all ordered atomic writes and owned temporary-file cleanup settle.
+ */
+export const applyFileOperationsEffect = Effect.fn("ScaffoldFiles.apply")(function* (root, operations, createdDirectories) {
+    yield* Effect.forEach(operations, (operation) => Effect.gen(function* () {
         const path = operationPath(root, operation.path);
-        await ensureParent(root, dirname(path), createdDirectories);
-        await atomicWrite(path, operation.content, operation.mode);
-    }
-}
-export async function restoreFiles(snapshots, createdDirectories) {
-    for (const snapshot of [...snapshots].reverse()) {
-        if (snapshot.content === undefined)
-            await rm(snapshot.path, { force: true });
-        else
-            await atomicWrite(snapshot.path, snapshot.content, snapshot.mode);
+        yield* ensureParentEffect(root, dirname(path), createdDirectories);
+        yield* atomicWriteEffect(path, operation.content, operation.mode);
+    }));
+}, (effect) => observeExecution("generator", "transaction.files.apply", effect));
+/**
+ * Restores all touched files even when one restoration fails, then removes only owned empty directories.
+ * @param snapshots - Pre-mutation bytes and permission snapshots.
+ * @param createdDirectories - Directories owned by this transaction.
+ * @returns Completion after every restoration and owned directory cleanup attempt; failures retain secondary evidence.
+ */
+export const restoreFilesEffect = Effect.fn("ScaffoldFiles.restore")(function* (snapshots, createdDirectories) {
+    const fs = yield* GeneratorFileSystem;
+    const exits = yield* Effect.forEach([...snapshots].reverse(), (snapshot) => Effect.exit(snapshot.content === undefined
+        ? fs.remove(snapshot.path, { force: true })
+        : atomicWriteEffect(snapshot.path, snapshot.content, snapshot.mode)));
+    const directoryExits = yield* Effect.forEach([...createdDirectories].sort((a, b) => b.length - a.length), (path) => Effect.exit(fs.removeDirectory(path).pipe(Effect.catchIf((cause) => hasErrno(cause, "ENOENT") || hasErrno(cause, "ENOTEMPTY"), () => Effect.void))));
+    const failures = [...exits, ...directoryExits].filter(Exit.isFailure);
+    const first = failures[0];
+    if (first !== undefined) {
+        for (const failure of failures.slice(1))
+            yield* recordCleanupFailure(first, "rollback", Cause.squash(failure.cause));
+        return yield* Effect.failCause(first.cause);
     }
-    for (const path of [...createdDirectories].sort((left, right) => right.length - left.length)) {
-        await rmdir(path).catch(() => undefined);
-    }
-}
-async function atomicWrite(path, content, mode) {
-    const temporary = `${path}.relkit-${randomUUID()}.tmp`;
-    try {
-        await writeFile(temporary, content, mode === undefined ? {} : { mode });
-        if (mode !== undefined)
-            await chmod(temporary, mode);
-        await rename(temporary, path);
-    }
-    finally {
-        await rm(temporary, { force: true }).catch(() => undefined);
-    }
-}
-async function ensureParent(root, path, created) {
+}, (effect) => observeExecution("generator", "transaction.files.restore", effect));
+/**
+ * Writes a sibling temporary file, atomically renames it and cleans only its owned temporary path.
+ * @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 bytes/mode are published by atomic rename and owned temporary cleanup settles.
+ */
+const atomicWriteEffect = Effect.fn("ScaffoldFiles.atomicWrite")((path, content, mode) => Effect.scoped(Effect.gen(function* () {
+    const fs = yield* GeneratorFileSystem;
+    const temporary = yield* Effect.acquireRelease(Effect.succeed(`${path}.relkit-${randomUUID()}.tmp`), (temporary, exit) => fs
+        .remove(temporary, { force: true })
+        .pipe(Effect.catchCause((cause) => recordCleanupFailure(exit, "temporary-file", Cause.squash(cause)))));
+    yield* fs.write(temporary, content, mode === undefined ? {} : { mode });
+    if (mode !== undefined)
+        yield* fs.chmod(temporary, mode);
+    yield* fs.rename(temporary, path);
+})), (effect) => observeExecution("generator", "transaction.files.atomicWrite", effect));
+/**
+ * Records missing parents before ordered writes so rollback removes only directories it created.
+ * @param root - Absolute project or owned resource root.
+ * @param path - Path inside the current project or owned resource.
+ * @param created - Directories created and owned by this transaction.
+ * @returns Completion after missing parents are created and atomically registered as transaction-owned.
+ */
+const ensureParentEffect = Effect.fn("ScaffoldFiles.ensureParent")(function* (root, path, created) {
+    const fs = yield* GeneratorFileSystem;
     const missing = [];
     for (let current = path; current !== root; current = dirname(current)) {
-        const metadata = await metadataFor(current);
-        if (metadata) {
-            if (!metadata.isDirectory()) {
-                collision(`${relative(root, current)} is not a project directory.`);
-            }
+        const metadata = yield* fs.metadata(current);
+        if (metadata !== undefined) {
+            if (metadata.kind !== "directory")
+                return yield* collision(`${relative(root, current)} is not a project directory.`);
             break;
         }
         missing.push(current);
     }
-    await mkdir(path, { recursive: true });
-    for (const directory of missing)
-        created.add(directory);
-}
-async function metadataFor(path) {
-    try {
-        return await lstat(path);
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return undefined;
-        throw error;
-    }
-}
+    yield* Effect.uninterruptible(Effect.gen(function* () {
+        yield* fs.mkdir(path, { recursive: true });
+        for (const directory of missing)
+            created.add(directory);
+    }));
+}, (effect) => observeExecution("generator", "transaction.files.ensureParent", effect));
+/**
+ * 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) {
-    throw new AddScaffoldError(ADD_FAILURE_CODES.collision, message);
+    return Effect.fail(domainError(new AddScaffoldError(ADD_FAILURE_CODES.collision, message)));
 }
+export { snapshotFiles, validateOperationActions, applyFileOperations, restoreFiles, } from "./add-transaction-files-compat.js";
 //# sourceMappingURL=add-transaction-files.js.map