create-relkit 0.6.0 → 0.7.0

package/dist/templates/default/v1/fullstack/package.json

@@ -15,18 +15,18 @@
   },
   "dependencies": {
     "@langchain/langgraph": "1.4.14",
-    "@relkit/app": "0.6.0",
-    "@relkit/client": "0.6.0",
-    "@relkit/local": "0.6.0",
+    "@relkit/app": "0.7.0",
+    "@relkit/client": "0.7.0",
+    "@relkit/local": "0.7.0",
     "@tanstack/react-query": "5.102.3",
     "langchain": "1.5.10",
-    "next": "16.3.3",
+    "next": "16.3.6",
     "react": "19.2.8",
     "react-dom": "19.2.8"
   },
   "devDependencies": {
-    "@relkit/cli": "0.6.0",
-    "@relkit/testing": "0.6.0",
+    "@relkit/cli": "0.7.0",
+    "@relkit/testing": "0.7.0",
     "@types/bun": "1.3.10",
     "@types/react": "19.2.18",
     "@types/react-dom": "19.2.7",

package/dist/templates/default/v1/minimal/package.json

@@ -15,12 +15,12 @@
     "graph": "relkit graph print"
   },
   "dependencies": {
-    "@relkit/app": "0.6.0"
+    "@relkit/app": "0.7.0"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.6.0",
-    "@relkit/testing": "0.6.0",
+    "@relkit/cli": "0.7.0",
+    "@relkit/testing": "0.7.0",
     "typescript": "5.9.3"
   }
 }

package/dist/templates/default/v1/tasks/package.json

@@ -13,12 +13,12 @@
     "jobs:trigger": "relkit jobs trigger --job exportOrders --input-file examples/export-orders.json --operation-id example-trigger"
   },
   "dependencies": {
-    "@relkit/app": "0.6.0"
+    "@relkit/app": "0.7.0"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.6.0",
-    "@relkit/testing": "0.6.0",
+    "@relkit/cli": "0.7.0",
+    "@relkit/testing": "0.7.0",
     "typescript": "5.9.3"
   }
 }

package/dist/validate-errors.d.ts

@@ -0,0 +1,12 @@
+/** Stable public creation-validation constructor, independent of native I/O adapters. */
+export declare class CreateValidationError extends Error {
+    readonly code: string;
+    /**
+     * Constructs the unchanged creation validation rejection.
+     * @param code - Existing public validation code.
+     * @param message - User-facing validation explanation.
+     * @returns The original public constructor identity.
+     */
+    constructor(code: string, message: string);
+}
+//# sourceMappingURL=validate-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-errors.d.ts","sourceRoot":"","sources":["../src/validate-errors.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,qBAAa,qBAAsB,SAAQ,KAAK;IAQ5C,QAAQ,CAAC,IAAI,EAAE,MAAM;IAPvB;;;;;OAKG;gBAEQ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB"}

package/dist/validate-errors.js

@@ -0,0 +1,16 @@
+/** Stable public creation-validation constructor, independent of native I/O adapters. */
+export class CreateValidationError extends Error {
+    code;
+    /**
+     * Constructs the unchanged creation validation rejection.
+     * @param code - Existing public validation code.
+     * @param message - User-facing validation explanation.
+     * @returns The original public constructor identity.
+     */
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "CreateValidationError";
+    }
+}
+//# sourceMappingURL=validate-errors.js.map

package/dist/validate-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-errors.js","sourceRoot":"","sources":["../src/validate-errors.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAQnC;IAPX;;;;;OAKG;IACH,YACW,IAAY,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/validate-paths.d.ts

@@ -0,0 +1,43 @@
+import { Effect } from "effect";
+import { GeneratorPaths } from "./generator-paths.js";
+import type { DestinationState } from "./validate.types.js";
+/**
+ * Inspects only an absent or real directory destination without following symlinks.
+ * @param path - Path inside the current project or owned resource.
+ * @returns Destination existence and emptiness flags; symlinks and non-directories fail.
+ */
+export declare const inspectDestinationEffect: (path: string) => Effect.Effect<DestinationState, import("./generator-errors.js").GeneratorDomainError, GeneratorPaths>;
+/**
+ * Canonicalizes missing child segments only after proving the existing parent is a directory.
+ * @param path - Path inside the current project or owned resource.
+ * @returns The canonical path rebuilt from its existing ancestor and complete missing segments.
+ */
+export declare const canonicalizeMissingPathEffect: (path: string) => Effect.Effect<string, import("./generator-errors.js").GeneratorDomainError, GeneratorPaths>;
+/**
+ * Resolves an existing real directory without permitting symlink indirection.
+ * @param path - Path inside the current project or owned resource.
+ * @param label - Human-readable location included in validation diagnostics.
+ * @returns The canonical existing directory path; symlinks and non-directories fail.
+ */
+export declare const existingDirectoryEffect: (path: string, label: string) => Effect.Effect<string, import("./generator-errors.js").GeneratorDomainError, GeneratorPaths>;
+/**
+ * Checks a canonical path relationship using no I/O.
+ * @param parent - Canonical proposed ancestor path.
+ * @param child - Canonical descendant path tested against the ancestor.
+ * @returns Whether the child is equal to or nested beneath the canonical parent.
+ */
+export declare function isAncestorOrSame(parent: string, child: string): boolean;
+/**
+ * Carries existing validation failures in the internal typed channel.
+ * @param message - User-facing diagnostic or prompt text.
+ * @returns A GeneratorDomainError retaining RELKIT_CREATE_DESTINATION_INVALID.
+ */
+export declare function invalid(message: string): import("./generator-errors.js").GeneratorDomainError;
+/**
+ * Constructs a typed failure retaining the exact public validation code and message.
+ * @param code - Stable public validation code.
+ * @param message - User-facing diagnostic or prompt text.
+ * @returns An Effect failing with the original CreateValidationError code and message.
+ */
+export declare function failure(code: string, message: string): Effect.Effect<never, import("./generator-errors.js").GeneratorDomainError, never>;
+//# sourceMappingURL=validate-paths.d.ts.map

package/dist/validate-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-paths.d.ts","sourceRoot":"","sources":["../src/validate-paths.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,yHA0BpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,+GAoCzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,8HAgBnC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,wDAEtC;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,qFAEpD"}

package/dist/validate-paths.js

@@ -0,0 +1,105 @@
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { Effect } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { GeneratorPaths } from "./generator-paths.js";
+import { domainError } from "./generator-errors.js";
+import { CreateValidationError } from "./validate-errors.js";
+/**
+ * Inspects only an absent or real directory destination without following symlinks.
+ * @param path - Path inside the current project or owned resource.
+ * @returns Destination existence and emptiness flags; symlinks and non-directories fail.
+ */
+export const inspectDestinationEffect = Effect.fn("CreateValidation.inspect")(function* (path) {
+    const paths = yield* GeneratorPaths;
+    const info = yield* paths
+        .metadata(path)
+        .pipe(Effect.mapError(() => invalid("Destination could not be inspected.")));
+    if (info === undefined)
+        return { exists: false, empty: false };
+    if (info.kind === "symlink")
+        return yield* failure("RELKIT_CREATE_DESTINATION_UNSAFE", "Destination must not be a symbolic link.");
+    if (info.kind !== "directory")
+        return yield* failure("RELKIT_CREATE_DESTINATION_INVALID", "Destination is not a directory.");
+    const entries = yield* paths
+        .entries(path)
+        .pipe(Effect.mapError(() => invalid("Destination directory could not be read.")));
+    return { exists: true, empty: entries.length === 0 };
+}, (effect) => observeExecution("generator", "validation.inspect", effect));
+/**
+ * Canonicalizes missing child segments only after proving the existing parent is a directory.
+ * @param path - Path inside the current project or owned resource.
+ * @returns The canonical path rebuilt from its existing ancestor and complete missing segments.
+ */
+export const canonicalizeMissingPathEffect = Effect.fn("CreateValidation.canonicalize")(function* (path) {
+    const paths = yield* GeneratorPaths;
+    let current = path;
+    const missing = [];
+    for (;;) {
+        const info = yield* paths
+            .metadata(current)
+            .pipe(Effect.mapError(() => invalid("Destination path could not be resolved.")));
+        if (info !== undefined) {
+            if (missing.length > 0 && info.kind !== "directory")
+                return yield* failure("RELKIT_CREATE_DESTINATION_INVALID", "A destination parent is not a directory.");
+            if (missing.length === 0 && info.kind === "symlink")
+                return yield* failure("RELKIT_CREATE_DESTINATION_UNSAFE", "Destination must not be a symbolic link.");
+            const base = yield* paths
+                .realpath(current)
+                .pipe(Effect.mapError(() => invalid("Destination path could not be resolved.")));
+            return missing.reverse().reduce((parent, part) => join(parent, part), base);
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return yield* failure("RELKIT_CREATE_DESTINATION_INVALID", "Destination path could not be resolved.");
+        missing.push(basename(current));
+        current = parent;
+    }
+}, (effect) => observeExecution("generator", "validation.canonicalize", effect));
+/**
+ * Resolves an existing real directory without permitting symlink indirection.
+ * @param path - Path inside the current project or owned resource.
+ * @param label - Human-readable location included in validation diagnostics.
+ * @returns The canonical existing directory path; symlinks and non-directories fail.
+ */
+export const existingDirectoryEffect = Effect.fn("CreateValidation.existingDirectory")(function* (path, label) {
+    const paths = yield* GeneratorPaths;
+    const resolved = resolve(path);
+    const info = yield* paths
+        .metadata(resolved)
+        .pipe(Effect.mapError(() => invalid(`${label} could not be resolved.`)));
+    if (info === undefined)
+        return yield* failure("RELKIT_CREATE_DESTINATION_INVALID", `${label} could not be resolved.`);
+    if (info.kind !== "directory")
+        return yield* failure("RELKIT_CREATE_DESTINATION_INVALID", `${label} is not a directory.`);
+    return yield* paths
+        .realpath(resolved)
+        .pipe(Effect.mapError(() => invalid(`${label} could not be resolved.`)));
+}, (effect) => observeExecution("generator", "validation.existingDirectory", effect));
+/**
+ * Checks a canonical path relationship using no I/O.
+ * @param parent - Canonical proposed ancestor path.
+ * @param child - Canonical descendant path tested against the ancestor.
+ * @returns Whether the child is equal to or nested beneath the canonical parent.
+ */
+export function isAncestorOrSame(parent, child) {
+    const relation = relative(parent, child);
+    return relation === "" || (!relation.startsWith("..") && !isAbsolute(relation));
+}
+/**
+ * Carries existing validation failures in the internal typed channel.
+ * @param message - User-facing diagnostic or prompt text.
+ * @returns A GeneratorDomainError retaining RELKIT_CREATE_DESTINATION_INVALID.
+ */
+export function invalid(message) {
+    return domainError(new CreateValidationError("RELKIT_CREATE_DESTINATION_INVALID", message));
+}
+/**
+ * Constructs a typed failure retaining the exact public validation code and message.
+ * @param code - Stable public validation code.
+ * @param message - User-facing diagnostic or prompt text.
+ * @returns An Effect failing with the original CreateValidationError code and message.
+ */
+export function failure(code, message) {
+    return Effect.fail(domainError(new CreateValidationError(code, message)));
+}
+//# sourceMappingURL=validate-paths.js.map

package/dist/validate-paths.js.map

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

package/dist/validate.d.ts

@@ -1,23 +1,62 @@
+import { Effect } from "effect";
+import { GeneratorPaths } from "./generator-paths.js";
 import type { CreateOptions } from "./options.js";
-export declare class CreateValidationError extends Error {
-    readonly code: string;
-    constructor(code: string, message: string);
-}
-export interface CreateValidationContext {
-    readonly cwd?: string;
-    readonly homeDirectory?: string;
-    readonly temporaryDirectory?: string;
-}
-export interface ValidatedCreateOptions extends CreateOptions {
-    readonly destination: string;
-    readonly destinationExists: boolean;
-    readonly destinationEmpty: boolean;
-}
-/** Returns whether a value is a valid unscoped or scoped npm package name. */
+import type { CreateValidationContext, ValidatedCreateOptions } from "./validate.types.js";
+export type { CreateValidationContext, ValidatedCreateOptions } from "./validate.types.js";
+export { CreateValidationError } from "./validate-errors.js";
+/**
+ * Checks unscoped or scoped npm names without filesystem or Effect authority.
+ * @param value - Unknown candidate project package name.
+ * @returns Whether the value is a supported lowercase scoped or unscoped npm package name.
+ */
 export declare function isValidPackageName(value: unknown): value is string;
-/** Throws a stable validation error instead of normalizing an invalid name. */
+/**
+ * Asserts the existing package-name contract using its unchanged public constructor.
+ * @param value - Unknown candidate project package name.
+ * @returns Completion for a valid string; invalid input throws RELKIT_CREATE_NAME_INVALID.
+ */
 export declare function validatePackageName(value: unknown): asserts value is string;
+/**
+ * Resolves a safe creation destination through explicit read-only path authority.
+ * @param options - Explicit options retaining existing defaults.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The canonical safe destination path after name, ancestry and broad-path validation.
+ */
+export declare const resolveCreateDestinationEffect: (options: Pick<CreateOptions, "name" | "directory">, context?: CreateValidationContext | undefined) => Effect.Effect<string, import("./generator-errors.js").GeneratorDomainError, GeneratorPaths>;
+/**
+ * Validates destination state using the same path service as the existing synchronous API.
+ * @param options - Explicit options retaining existing defaults.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns Validated options, canonical destination and its initial existence/emptiness state.
+ */
+export declare const validateCreateOptionsEffect: (options: CreateOptions, context?: CreateValidationContext | undefined) => Effect.Effect<Readonly<{
+    destination: string;
+    destinationExists: boolean;
+    destinationEmpty: boolean;
+    name: string;
+    template: import("./options.js").CreateTemplate;
+    cloud: import("./options.js").CreateCloud;
+    deploy: import("./options.js").CreateDeployment;
+    jobs?: import("./options.js").CreateJobs;
+    install: boolean;
+    git: boolean;
+    examples: boolean;
+    directory?: string;
+    forceEmptyDirectory: boolean;
+    json: boolean;
+}>, import("./generator-errors.js").GeneratorDomainError, GeneratorPaths>;
+/**
+ * Preserves synchronous safe-destination resolution and its stable public errors.
+ * @param options - Explicit options retaining existing defaults.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns A canonical safe destination path, retaining the existing validation errors.
+ */
 export declare function resolveCreateDestination(options: Pick<CreateOptions, "name" | "directory">, context?: CreateValidationContext): string;
-/** Validates name, path, and destination state using read-only filesystem calls. */
+/**
+ * Preserves synchronous destination validation and its existing immutable result.
+ * @param options - Explicit request options or declared prompt choices.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns Validated options with a safe canonical destination and initial destination state.
+ */
 export declare function validateCreateOptions(options: CreateOptions, context?: CreateValidationContext): ValidatedCreateOptions;
 //# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlD,qBAAa,qBAAsB,SAAQ,KAAK;IAE5C,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOlE;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAO3E;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC,EAClD,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAmBR;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CAkCxB"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE3F,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAI3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAiB7D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOlE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAM3E;AAED;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,oMAsC1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;yEA8BvC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC,EAClD,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CAExB"}

package/dist/validate.js

@@ -1,156 +1,115 @@
-import { lstatSync, readdirSync, realpathSync } from "node:fs";
-import { homedir, tmpdir } from "node:os";
-import { dirname, isAbsolute, join, parse, relative, resolve } from "node:path";
+import { parse, resolve } from "node:path";
+import { Effect } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { GeneratorPaths } from "./generator-paths.js";
+import { domainTry } from "./generator-errors.js";
+import { runGeneratorSync } from "./generator-runtime.js";
+import { CreateValidationError } from "./validate-errors.js";
+export { CreateValidationError } from "./validate-errors.js";
+/**
+ * Allowed lowercase npm package-name segment syntax.
+ */
 const PACKAGE_PART = /^(?![._])[a-z0-9._~-]+$/;
+/**
+ * Windows drive-root or UNC paths that must not bypass relative destination rules.
+ */
 const WINDOWS_ABSOLUTE = /^(?:[A-Za-z]:[\\/]|\\\\)/;
+/**
+ * Names reserved by npm/project layout and rejected for new projects.
+ */
 const RESERVED_NAMES = new Set(["favicon.ico", "node_modules"]);
-export class CreateValidationError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.code = code;
-        this.name = "CreateValidationError";
-    }
-}
-/** Returns whether a value is a valid unscoped or scoped npm package name. */
+/**
+ * Checks unscoped or scoped npm names without filesystem or Effect authority.
+ * @param value - Unknown candidate project package name.
+ * @returns Whether the value is a supported lowercase scoped or unscoped npm package name.
+ */
 export function isValidPackageName(value) {
     if (typeof value !== "string" || value.length === 0 || value.length > 214)
         return false;
     const parts = value.startsWith("@") ? value.slice(1).split("/") : [value];
-    if (parts.length !== (value.startsWith("@") ? 2 : 1))
-        return false;
-    return parts.every((part) => part.length > 0 && PACKAGE_PART.test(part) && !RESERVED_NAMES.has(part));
+    return (parts.length === (value.startsWith("@") ? 2 : 1) &&
+        parts.every((part) => part.length > 0 && PACKAGE_PART.test(part) && !RESERVED_NAMES.has(part)));
 }
-/** Throws a stable validation error instead of normalizing an invalid name. */
+/**
+ * Asserts the existing package-name contract using its unchanged public constructor.
+ * @param value - Unknown candidate project package name.
+ * @returns Completion for a valid string; invalid input throws RELKIT_CREATE_NAME_INVALID.
+ */
 export function validatePackageName(value) {
-    if (!isValidPackageName(value)) {
+    if (!isValidPackageName(value))
         throw new CreateValidationError("RELKIT_CREATE_NAME_INVALID", "Project name must be a valid npm package name.");
-    }
 }
-export function resolveCreateDestination(options, context = {}) {
-    validatePackageName(options.name);
-    const workingDirectory = resolve(context.cwd ?? process.cwd());
-    const cwd = existingDirectory(workingDirectory, "current directory");
+/**
+ * Resolves a safe creation destination through explicit read-only path authority.
+ * @param options - Explicit options retaining existing defaults.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The canonical safe destination path after name, ancestry and broad-path validation.
+ */
+export const resolveCreateDestinationEffect = Effect.fn("CreateValidation.destination")(function* (options, context = {}) {
+    yield* domainTry(() => validatePackageName(options.name));
+    const paths = yield* GeneratorPaths;
+    const workingDirectory = resolve(context.cwd ?? (yield* paths.cwd()));
+    const cwd = yield* existingDirectoryEffect(workingDirectory, "current directory");
     const input = options.directory ?? options.name;
     if (typeof input !== "string" ||
         input.length === 0 ||
         input.includes("\0") ||
-        WINDOWS_ABSOLUTE.test(input)) {
-        throw new CreateValidationError("RELKIT_CREATE_DESTINATION_INVALID", "Destination must be a valid local path.");
-    }
+        WINDOWS_ABSOLUTE.test(input))
+        return yield* failure("RELKIT_CREATE_DESTINATION_INVALID", "Destination must be a valid local path.");
     const candidate = resolve(workingDirectory, input);
-    rejectBroadPath(canonicalizeMissingPath(candidate), cwd, context);
+    const canonical = yield* canonicalizeMissingPathEffect(candidate);
+    const roots = [
+        cwd,
+        context.homeDirectory ?? (yield* paths.home()),
+        context.temporaryDirectory ?? (yield* paths.temporaryRoot()),
+    ].map((root) => resolve(root));
+    if (canonical === parse(canonical).root ||
+        roots.some((root) => isAncestorOrSame(canonical, root)))
+        return yield* failure("RELKIT_CREATE_DESTINATION_UNSAFE", "Destination is a current, root, or broad directory.");
     return candidate;
-}
-/** Validates name, path, and destination state using read-only filesystem calls. */
-export function validateCreateOptions(options, context = {}) {
-    if (options === null || typeof options !== "object") {
-        throw new CreateValidationError("RELKIT_CREATE_DESTINATION_INVALID", "Create options are invalid.");
-    }
-    validatePackageName(options.name);
-    if (typeof options.forceEmptyDirectory !== "boolean") {
-        throw new CreateValidationError("RELKIT_CREATE_DESTINATION_INVALID", "The empty-directory override must be boolean.");
-    }
-    const destination = resolveCreateDestination(options, context);
-    const state = inspectDestination(destination);
-    if (state.exists && !state.empty) {
-        throw new CreateValidationError("RELKIT_CREATE_DESTINATION_NOT_EMPTY", "Destination must be absent or an empty directory.");
-    }
-    if (state.exists && !options.forceEmptyDirectory) {
-        throw new CreateValidationError("RELKIT_CREATE_DESTINATION_EXISTS", "Destination already exists; use --force-empty-directory only for an empty directory.");
-    }
+}, (effect) => observeExecution("generator", "validation.destination", effect));
+/**
+ * Validates destination state using the same path service as the existing synchronous API.
+ * @param options - Explicit options retaining existing defaults.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns Validated options, canonical destination and its initial existence/emptiness state.
+ */
+export const validateCreateOptionsEffect = Effect.fn("CreateValidation.options")(function* (options, context = {}) {
+    if (options === null || typeof options !== "object")
+        return yield* failure("RELKIT_CREATE_DESTINATION_INVALID", "Create options are invalid.");
+    yield* domainTry(() => validatePackageName(options.name));
+    if (typeof options.forceEmptyDirectory !== "boolean")
+        return yield* failure("RELKIT_CREATE_DESTINATION_INVALID", "The empty-directory override must be boolean.");
+    const destination = yield* resolveCreateDestinationEffect(options, context);
+    const state = yield* inspectDestinationEffect(destination);
+    if (state.exists && !state.empty)
+        return yield* failure("RELKIT_CREATE_DESTINATION_NOT_EMPTY", "Destination must be absent or an empty directory.");
+    if (state.exists && !options.forceEmptyDirectory)
+        return yield* failure("RELKIT_CREATE_DESTINATION_EXISTS", "Destination already exists; use --force-empty-directory only for an empty directory.");
     return Object.freeze({
         ...options,
         destination,
         destinationExists: state.exists,
         destinationEmpty: state.empty,
     });
+}, (effect) => observeExecution("generator", "validation.options", effect));
+/**
+ * Preserves synchronous safe-destination resolution and its stable public errors.
+ * @param options - Explicit options retaining existing defaults.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns A canonical safe destination path, retaining the existing validation errors.
+ */
+export function resolveCreateDestination(options, context = {}) {
+    return runGeneratorSync(resolveCreateDestinationEffect(options, context));
 }
-function inspectDestination(path) {
-    let info;
-    try {
-        info = lstatSync(path);
-    }
-    catch (error) {
-        if (isNotFound(error))
-            return { exists: false, empty: false };
-        throw invalidDestination("Destination could not be inspected.");
-    }
-    if (info.isSymbolicLink())
-        throw unsafeDestination("Destination must not be a symbolic link.");
-    if (!info.isDirectory())
-        throw invalidDestination("Destination is not a directory.");
-    try {
-        return { exists: true, empty: readdirSync(path).length === 0 };
-    }
-    catch {
-        throw invalidDestination("Destination directory could not be read.");
-    }
-}
-function canonicalizeMissingPath(path) {
-    let current = path;
-    const missing = [];
-    while (true) {
-        try {
-            const info = lstatSync(current);
-            if (missing.length > 0 && !info.isDirectory()) {
-                throw invalidDestination("A destination parent is not a directory.");
-            }
-            if (missing.length === 0 && info.isSymbolicLink()) {
-                throw unsafeDestination("Destination must not be a symbolic link.");
-            }
-            const base = realpathSync.native(current);
-            return missing.reverse().reduce((parent, part) => join(parent, part), base);
-        }
-        catch (error) {
-            if (!isNotFound(error)) {
-                if (error instanceof CreateValidationError)
-                    throw error;
-                throw invalidDestination("Destination path could not be resolved.");
-            }
-            const parent = dirname(current);
-            if (parent === current)
-                throw invalidDestination("Destination path could not be resolved.");
-            missing.push(current.slice(parent.length + 1));
-            current = parent;
-        }
-    }
-}
-function rejectBroadPath(path, cwd, context) {
-    const broadRoots = [
-        cwd,
-        context.homeDirectory ?? homedir(),
-        context.temporaryDirectory ?? tmpdir(),
-    ].map((root) => resolve(root));
-    if (path === parse(path).root || broadRoots.some((root) => isAncestorOrSame(path, root))) {
-        throw unsafeDestination("Destination is a current, root, or broad directory.");
-    }
-}
-function existingDirectory(path, label) {
-    const resolved = resolve(path);
-    try {
-        const info = lstatSync(resolved);
-        if (!info.isDirectory())
-            throw invalidDestination(`${label} is not a directory.`);
-        return realpathSync.native(resolved);
-    }
-    catch (error) {
-        if (error instanceof CreateValidationError)
-            throw error;
-        throw invalidDestination(`${label} could not be resolved.`);
-    }
-}
-function isAncestorOrSame(parent, child) {
-    const relation = relative(parent, child);
-    return relation === "" || (!relation.startsWith("..") && !isAbsolute(relation));
-}
-function invalidDestination(message) {
-    return new CreateValidationError("RELKIT_CREATE_DESTINATION_INVALID", message);
-}
-function unsafeDestination(message) {
-    return new CreateValidationError("RELKIT_CREATE_DESTINATION_UNSAFE", message);
-}
-function isNotFound(error) {
-    return error instanceof Error && "code" in error && error.code === "ENOENT";
+/**
+ * Preserves synchronous destination validation and its existing immutable result.
+ * @param options - Explicit request options or declared prompt choices.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns Validated options with a safe canonical destination and initial destination state.
+ */
+export function validateCreateOptions(options, context = {}) {
+    return runGeneratorSync(validateCreateOptionsEffect(options, context));
 }
+import { inspectDestinationEffect, canonicalizeMissingPathEffect, existingDirectoryEffect, isAncestorOrSame, failure, } from "./validate-paths.js";
 //# sourceMappingURL=validate.js.map