create-relkit 0.6.0 → 0.7.1

package/dist/domain-planning.types.d.ts

@@ -0,0 +1,21 @@
+import { type NormalizedArtifactName } from "./add-name.js";
+import type { DiscoveredService } from "./project-discovery-types.js";
+/**
+ * Normalized domain identity and optional service used by artifact planning.
+ */
+export interface DomainTarget {
+    readonly domain: NormalizedArtifactName;
+    readonly servicePath: string;
+    readonly service: DiscoveredService | undefined;
+}
+/**
+ * Normalized artifact name, source path, descriptor ID, binding and export form.
+ */
+export interface DomainArtifact {
+    readonly name: NormalizedArtifactName;
+    readonly path: string;
+    readonly id: string;
+    readonly binding: string;
+    readonly exportKind: "default" | "named";
+}
+//# sourceMappingURL=domain-planning.types.d.ts.map

package/dist/domain-planning.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-planning.types.d.ts","sourceRoot":"","sources":["../src/domain-planning.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC;CAC1C"}

package/dist/domain-planning.types.js

@@ -0,0 +1,2 @@
+import {} from "./add-name.js";
+//# sourceMappingURL=domain-planning.types.js.map

package/dist/domain-planning.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-planning.types.js","sourceRoot":"","sources":["../src/domain-planning.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,MAAM,eAAe,CAAC"}

package/dist/generate-deployment.d.ts

@@ -0,0 +1,18 @@
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import type { CreateOptions } from "./options.js";
+/**
+ * Applies only explicit deployment and jobs flags, retaining concrete template dependency versions.
+ * @param root - Absolute project or owned resource root.
+ * @param options - Explicit options retaining existing defaults.
+ * @returns Completion after generated deployment/provider source and manifest fields match explicit flags.
+ */
+export declare const customizeDeploymentEffect: (root: string, options: CreateOptions) => Effect.Effect<undefined, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Adjusts the tasks fixture to the selected supported jobs adapter.
+ * @param root - Absolute project or owned resource root.
+ * @param options - Explicit options retaining existing defaults.
+ * @returns Completion after task/job examples match the selected provider's supported operations.
+ */
+export declare const customizeTaskFixtureEffect: (root: string, options: CreateOptions) => Effect.Effect<void, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem>;
+//# sourceMappingURL=generate-deployment.d.ts.map

package/dist/generate-deployment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-deployment.d.ts","sourceRoot":"","sources":["../src/generate-deployment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAKhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,kMA0ErC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,6LA8BtC,CAAC"}

package/dist/generate-deployment.js

@@ -0,0 +1,100 @@
+import { join } from "node:path";
+import { Effect, Schema } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GenerateProjectError } from "./generate-types.js";
+import { domainError, domainTry } from "./generator-errors.js";
+import { TemplateManifest, JsonObject } from "./project-manifest.schemas.js";
+import { replaceOnceEffect } from "./generate-files-utilities.js";
+/**
+ * Applies only explicit deployment and jobs flags, retaining concrete template dependency versions.
+ * @param root - Absolute project or owned resource root.
+ * @param options - Explicit options retaining existing defaults.
+ * @returns Completion after generated deployment/provider source and manifest fields match explicit flags.
+ */
+export const customizeDeploymentEffect = Effect.fn("ProjectFiles.customizeDeployment")(function* (root, options) {
+    const configPath = join(root, "relkit.config.ts");
+    const imports = [
+        ...(options.cloud === "aws" ? ['import "@relkit/aws";'] : []),
+        ...(options.deploy === "pulumi" ? ['import "@relkit/pulumi";'] : []),
+        ...(options.jobs === undefined ? [] : ['import { docker } from "@relkit/docker";']),
+        ...(options.jobs === "inngest-docker" ? ['import { inngest } from "@relkit/inngest";'] : []),
+        ...(options.jobs === "effect-mq-docker"
+            ? ['import { effectMq } from "@relkit/effect-mq";']
+            : []),
+        ...(options.jobs === "trigger-docker" ? ['import { trigger } from "@relkit/trigger";'] : []),
+    ].join("\n");
+    yield* replaceOnceEffect(configPath, "// relkit:create:deployment-imports", imports);
+    yield* replaceOnceEffect(configPath, "  // relkit:create:deployment", [
+        options.cloud === "aws" && options.deploy === "pulumi"
+            ? '  deployment: { engine: "pulumi", host: "aws" },'
+            : "",
+        options.jobs === "inngest-docker" ? "  jobs: { default: docker(inngest()) }," : "",
+        options.jobs === "effect-mq-docker" ? "  jobs: { default: docker(effectMq()) }," : "",
+        options.jobs === "trigger-docker" ? "  jobs: { default: docker(trigger()) }," : "",
+        options.jobs === undefined ? "" : '  defaults: { jobs: "default" },',
+    ]
+        .filter(Boolean)
+        .join("\n"));
+    yield* customizeTaskFixtureEffect(root, options);
+    const manifestPath = join(root, "package.json");
+    const source = yield* (yield* GeneratorFileSystem).readText(manifestPath);
+    const fs = yield* GeneratorFileSystem;
+    const parsed = yield* domainTry(() => JSON.parse(source));
+    const decoded = yield* Schema.decodeUnknownEffect(TemplateManifest)(parsed).pipe(Effect.mapError(domainError));
+    const original = yield* Schema.decodeUnknownEffect(JsonObject)(parsed).pipe(Effect.mapError(domainError));
+    const manifest = {
+        ...original,
+        ...decoded,
+        dependencies: { ...decoded.dependencies },
+        scripts: { ...decoded.scripts },
+    };
+    const version = manifest.dependencies["@relkit/app"];
+    if (version === undefined)
+        return yield* Effect.fail(domainError(new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", "Template has no @relkit/app dependency.")));
+    if (options.cloud === "aws")
+        manifest.dependencies["@relkit/aws"] = version;
+    if (options.deploy === "pulumi")
+        manifest.dependencies["@relkit/pulumi"] = version;
+    if (options.jobs !== undefined) {
+        manifest.dependencies["@relkit/docker"] = version;
+        manifest.dependencies["@relkit/local"] = version;
+        manifest.dependencies[`@relkit/${options.jobs.replace(/-docker$/u, "")}`] = version;
+    }
+    if (options.cloud === "aws" && options.deploy === "pulumi") {
+        manifest.scripts["deploy:preview"] = "relkit deploy preview";
+        manifest.scripts.deploy = "relkit deploy up";
+    }
+    manifest.scripts = sorted(manifest.scripts);
+    manifest.dependencies = sorted(manifest.dependencies);
+    yield* fs.write(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    yield* fs.chmod(manifestPath, 0o644);
+}, (effect) => observeExecution("generator", "generation.deployment", effect));
+/**
+ * Adjusts the tasks fixture to the selected supported jobs adapter.
+ * @param root - Absolute project or owned resource root.
+ * @param options - Explicit options retaining existing defaults.
+ * @returns Completion after task/job examples match the selected provider's supported operations.
+ */
+export const customizeTaskFixtureEffect = Effect.fn("ProjectFiles.customizeTasks")(function* (root, options) {
+    if (options.jobs === undefined || options.jobs === "inngest-docker")
+        return;
+    const taskPath = join(root, "src/orders/tasks/export-orders.task.ts");
+    const jobPath = join(root, "src/orders/jobs/export-orders.job.ts");
+    if (options.jobs === "effect-mq-docker")
+        yield* replaceOnceEffect(taskPath, 'execution: "durable"', 'execution: "retryable"');
+    yield* replaceOnceEffect(taskPath, "  progress: z.object({ completed: z.number().int().nonnegative() }),\n", "");
+    yield* replaceOnceEffect(taskPath, "    await context.progress.emit({ completed: 0 });\n", "");
+    yield* replaceOnceEffect(taskPath, "    await context.progress.emit({ completed: orderIds.length });\n", "");
+    yield* replaceOnceEffect(jobPath, '    operations: ["trigger", "get", "list", "watch"],', '    operations: ["trigger"],');
+    yield* replaceOnceEffect(jobPath, '    fields: ["status", "progress", "output"],', '    fields: ["status", "output"],');
+}, (effect) => observeExecution("generator", "generation.customizeTasks", effect));
+/**
+ * Sorts owned manifest fields deterministically.
+ * @param values - Ordered declarations or argument values.
+ * @returns A new manifest string record sorted by key.
+ */
+function sorted(values) {
+    return Object.fromEntries(Object.entries(values).sort(([left], [right]) => left.localeCompare(right)));
+}
+//# sourceMappingURL=generate-deployment.js.map

package/dist/generate-deployment.js.map

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

package/dist/generate-files-compat.d.ts

@@ -0,0 +1,43 @@
+import type { StageCleanupResult } from "./generate-files-utilities.types.js";
+/**
+ * Preserves staging cleanup's Promise API.
+ * @param stage - Owned sibling staging directory, or undefined before acquisition.
+ * @param destination - Absolute final project destination.
+ * @returns The verified temporary-path cleanup disposition after the native attempt settles.
+ */
+export declare function cleanupStagedProject(stage: string | undefined, destination: string): Promise<StageCleanupResult>;
+/**
+ * Preserves template preflight's Promise API.
+ * @param path - Path inside the current project or owned resource.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function requireTemplate(path: string): Promise<void>;
+/**
+ * Preserves required-file preflight's Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param paths - Relative paths checked in stable order.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function requireFiles(root: string, paths: readonly string[]): Promise<void>;
+/**
+ * Preserves exact substitution's Promise API.
+ * @param path - Path inside the current project or owned resource.
+ * @param before - Unique template marker expected in the authored source.
+ * @param after - Literal replacement for that unique marker.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function replaceOnce(path: string, before: string, after: string): Promise<void>;
+/**
+ * Preserves example removal's Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function removeExamples(root: string): Promise<void>;
+/**
+ * Preserves deterministic file listing's Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param current - Directory currently traversed beneath the project root.
+ * @returns Sorted project-relative file paths beneath the selected subtree.
+ */
+export declare function listProjectFiles(root: string, current?: string): Promise<string[]>;
+//# sourceMappingURL=generate-files-compat.d.ts.map

package/dist/generate-files-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-files-compat.d.ts","sourceRoot":"","sources":["../src/generate-files-compat.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAE7B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEhF"}

package/dist/generate-files-compat.js

@@ -0,0 +1,56 @@
+import { runGeneratorPromise } from "./generator-runtime.js";
+/**
+ * Preserves staging cleanup's Promise API.
+ * @param stage - Owned sibling staging directory, or undefined before acquisition.
+ * @param destination - Absolute final project destination.
+ * @returns The verified temporary-path cleanup disposition after the native attempt settles.
+ */
+export function cleanupStagedProject(stage, destination) {
+    return runGeneratorPromise(cleanupStagedProjectEffect(stage, destination));
+}
+/**
+ * Preserves template preflight's Promise API.
+ * @param path - Path inside the current project or owned resource.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function requireTemplate(path) {
+    return runGeneratorPromise(requireTemplateEffect(path));
+}
+/**
+ * Preserves required-file preflight's Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param paths - Relative paths checked in stable order.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function requireFiles(root, paths) {
+    return runGeneratorPromise(requireFilesEffect(root, paths));
+}
+/**
+ * Preserves exact substitution's Promise API.
+ * @param path - Path inside the current project or owned resource.
+ * @param before - Unique template marker expected in the authored source.
+ * @param after - Literal replacement for that unique marker.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function replaceOnce(path, before, after) {
+    return runGeneratorPromise(replaceOnceEffect(path, before, after));
+}
+/**
+ * Preserves example removal's Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function removeExamples(root) {
+    return runGeneratorPromise(removeExamplesEffect(root));
+}
+/**
+ * Preserves deterministic file listing's Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param current - Directory currently traversed beneath the project root.
+ * @returns Sorted project-relative file paths beneath the selected subtree.
+ */
+export function listProjectFiles(root, current = root) {
+    return runGeneratorPromise(listProjectFilesEffect(root, current));
+}
+import { cleanupStagedProjectEffect, requireTemplateEffect, requireFilesEffect, replaceOnceEffect, removeExamplesEffect, listProjectFilesEffect, } from "./generate-files-utilities.js";
+//# sourceMappingURL=generate-files-compat.js.map

package/dist/generate-files-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-files-compat.js","sourceRoot":"","sources":["../src/generate-files-compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAyB,EACzB,WAAmB;IAEnB,OAAO,mBAAmB,CAAC,0BAA0B,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,mBAAmB,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,KAAwB;IACjE,OAAO,mBAAmB,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAc,EAAE,KAAa;IACrE,OAAO,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,mBAAmB,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAO,GAAG,IAAI;IAC3D,OAAO,mBAAmB,CAAC,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC"}

package/dist/generate-files-utilities.d.ts

@@ -1,18 +1,71 @@
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import type { GeneratorDomainError, GeneratorIoError } from "./generator-errors.js";
+export type { StageCleanupResult } from "./generate-files-utilities.types.js";
+/** Canonical example-only paths removed by the existing --no-examples flag. */
 export declare const EXAMPLE_PATH_PREFIXES: readonly ["src/routes", "src/orders", "src/echo", "src/hello/tools", "src/hello/agents", "tests"];
-export interface StageCleanupResult {
-    readonly temporaryPath?: string;
-    readonly removed: boolean;
-}
-export declare function cleanupStagedProject(stage: string | undefined, destination: string): Promise<StageCleanupResult>;
-export declare function requireTemplate(path: string): Promise<void>;
-export declare function requireFiles(root: string, paths: readonly string[]): Promise<void>;
-export declare function replaceOnce(path: string, before: string, after: string): Promise<void>;
-export declare function removeExamples(root: string): Promise<void>;
-export declare function listProjectFiles(root: string, current?: string): Promise<string[]>;
+/**
+ * Cleans only a verified sibling staging directory owned by this generation invocation.
+ * @param stage - Owned sibling staging directory, or undefined before acquisition.
+ * @param destination - Absolute final project destination.
+ * @returns The verified temporary path and whether it was removed, retaining cleanup failures as evidence.
+ */
+export declare const cleanupStagedProjectEffect: (stage: string | undefined, destination: string) => Effect.Effect<{
+    temporaryPath: string;
+    removed: boolean;
+} | {
+    removed: boolean;
+}, never, GeneratorFileSystem>;
+/**
+ * Requires a nonempty source template without importing or executing it.
+ * @param path - Path inside the current project or owned resource.
+ * @returns Completion when the selected template exists and contains at least one entry.
+ */
+export declare const requireTemplateEffect: (path: string) => Effect.Effect<undefined, GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Checks required template files in stable order before running any installer.
+ * @param root - Absolute project or owned resource root.
+ * @param paths - Relative paths checked in stable order.
+ * @returns Completion when every required relative template file is accessible.
+ */
+export declare const requireFilesEffect: (root: string, paths: readonly string[]) => Effect.Effect<void, GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Substitutes exactly one template marker and preserves the established output mode.
+ * @param path - Path inside the current project or owned resource.
+ * @param before - Unique template marker expected in the authored source.
+ * @param after - Literal replacement for that unique marker.
+ * @returns Completion after exactly one template marker is replaced and its file mode is restored.
+ */
+export declare const replaceOnceEffect: (path: string, before: string, after: string) => Effect.Effect<undefined, GeneratorIoError | GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Removes only the established template examples, with ordered physical settlement.
+ * @param root - Absolute project or owned resource root.
+ * @returns Completion after the known example source directories are removed from the staged project.
+ */
+export declare const removeExamplesEffect: (root: string) => Effect.Effect<void, GeneratorIoError, GeneratorFileSystem>;
+/**
+ * Lists generated source files in deterministic order, excluding generated and installed state.
+ * @param root - Absolute project or owned resource root.
+ * @param current - Directory currently traversed beneath the project root.
+ * @returns Sorted relative file paths, excluding .git, node_modules and .relkit runtime output.
+ */
+export declare const listProjectFilesEffect: (root: string, current?: any) => Effect.Effect<string[], GeneratorIoError | GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Converts a package name to the existing stable RELKIT application identifier.
+ * @param name - Authored name or declaration key.
+ * @returns A safe unscoped project ID, with app as the empty-normalization fallback.
+ */
 export declare function projectId(name: string): string;
+/**
+ * Compares directory names without platform locale dependence.
+ * @param left - First value in deterministic comparison.
+ * @param right - Second value in deterministic comparison.
+ * @returns Negative, zero or positive ordering using a deterministic string comparison.
+ */
 export declare function compareNames(left: {
     name: string;
 }, right: {
     name: string;
 }): number;
+export { cleanupStagedProject, requireTemplate, requireFiles, replaceOnce, removeExamples, listProjectFiles, } from "./generate-files-compat.js";
 //# sourceMappingURL=generate-files-utilities.d.ts.map

package/dist/generate-files-utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-files-utilities.d.ts","sourceRoot":"","sources":["../src/generate-files-utilities.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,mGAOxB,CAAC;AAEX,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAiB7B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASjE;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxF;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc5F;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUtF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpF"}
+{"version":3,"file":"generate-files-utilities.d.ts","sourceRoot":"","sources":["../src/generate-files-utilities.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAQ,MAAM,QAAQ,CAAC;AAMtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMpF,YAAY,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,mGAOxB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;;;8BA2BtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,uFAyBjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,4GAmB9B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,yIAkB7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,8EAQhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,wHAiBlC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpF;AAED,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,gBAAgB,GACjB,MAAM,4BAA4B,CAAC"}

package/dist/generate-files-utilities.js

@@ -1,6 +1,11 @@
-import { access, chmod, lstat, readdir, readFile, rm, writeFile } from "node:fs/promises";
 import { basename, dirname, join, relative, resolve } from "node:path";
+import { Effect, Exit } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
 import { GenerateProjectError } from "./generate-types.js";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { domainError } from "./generator-errors.js";
+import { recordCleanupFailure } from "./generator-cleanup.js";
+/** Canonical example-only paths removed by the existing --no-examples flag. */
 export const EXAMPLE_PATH_PREFIXES = [
     "src/routes",
     "src/orders",
@@ -9,7 +14,13 @@ export const EXAMPLE_PATH_PREFIXES = [
     "src/hello/agents",
     "tests",
 ];
-export async function cleanupStagedProject(stage, destination) {
+/**
+ * Cleans only a verified sibling staging directory owned by this generation invocation.
+ * @param stage - Owned sibling staging directory, or undefined before acquisition.
+ * @param destination - Absolute final project destination.
+ * @returns The verified temporary path and whether it was removed, retaining cleanup failures as evidence.
+ */
+export const cleanupStagedProjectEffect = Effect.fn("ProjectFiles.cleanupStage")(function* (stage, destination) {
     if (stage === undefined)
         return { removed: false };
     const temporaryPath = resolve(stage);
@@ -17,63 +28,96 @@ export async function cleanupStagedProject(stage, destination) {
     const prefix = `.${basename(destination)}-relkit-`;
     if (dirname(temporaryPath) !== parent || !basename(temporaryPath).startsWith(prefix))
         return { removed: false };
-    try {
-        const info = await lstat(temporaryPath);
-        if (!info.isDirectory() || info.isSymbolicLink())
+    const fs = yield* GeneratorFileSystem;
+    const cleanup = yield* Effect.gen(function* () {
+        const info = yield* fs.metadata(temporaryPath);
+        if (info === undefined)
+            return { temporaryPath, removed: true };
+        if (info.kind !== "directory")
             return { temporaryPath, removed: false };
-        await rm(temporaryPath, { recursive: true, force: true });
+        yield* fs.remove(temporaryPath, { recursive: true, force: true });
         return { temporaryPath, removed: true };
-    }
-    catch (error) {
-        if (error instanceof Error && "code" in error && error.code === "ENOENT")
-            return { temporaryPath, removed: true };
-        return { temporaryPath, removed: false };
-    }
-}
-export async function requireTemplate(path) {
-    try {
-        if ((await readdir(path)).length === 0)
-            throw new Error("empty");
-    }
-    catch {
-        throw new GenerateProjectError("RELKIT_CREATE_TEMPLATE_MISSING", "Selected template is missing.");
-    }
-}
-export async function requireFiles(root, paths) {
-    for (const path of paths) {
-        try {
-            await access(join(root, path));
-        }
-        catch {
-            throw new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", `Template file is missing: ${path}`);
-        }
-    }
-}
-export async function replaceOnce(path, before, after) {
-    const content = await readFile(path, "utf8");
+    }).pipe(Effect.catch((cause) => Effect.gen(function* () {
+        const result = { temporaryPath, removed: false };
+        yield* recordCleanupFailure(Exit.succeed(result), "stage", cause);
+        return result;
+    })));
+    return cleanup;
+}, (effect) => observeExecution("generator", "generation.cleanupStage", effect));
+/**
+ * Requires a nonempty source template without importing or executing it.
+ * @param path - Path inside the current project or owned resource.
+ * @returns Completion when the selected template exists and contains at least one entry.
+ */
+export const requireTemplateEffect = Effect.fn("ProjectFiles.requireTemplate")(function* (path) {
+    const entries = yield* (yield* GeneratorFileSystem)
+        .entries(path)
+        .pipe(Effect.mapError(() => domainError(new GenerateProjectError("RELKIT_CREATE_TEMPLATE_MISSING", "Selected template is missing."))));
+    if (entries.length === 0)
+        return yield* Effect.fail(domainError(new GenerateProjectError("RELKIT_CREATE_TEMPLATE_MISSING", "Selected template is missing.")));
+}, (effect) => observeExecution("generator", "generation.requireTemplate", effect));
+/**
+ * Checks required template files in stable order before running any installer.
+ * @param root - Absolute project or owned resource root.
+ * @param paths - Relative paths checked in stable order.
+ * @returns Completion when every required relative template file is accessible.
+ */
+export const requireFilesEffect = Effect.fn("ProjectFiles.requireFiles")(function* (root, paths) {
+    const fs = yield* GeneratorFileSystem;
+    yield* Effect.forEach(paths, (path) => fs
+        .access(join(root, path))
+        .pipe(Effect.mapError(() => domainError(new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", `Template file is missing: ${path}`)))));
+}, (effect) => observeExecution("generator", "generation.requireFiles", effect));
+/**
+ * Substitutes exactly one template marker and preserves the established output mode.
+ * @param path - Path inside the current project or owned resource.
+ * @param before - Unique template marker expected in the authored source.
+ * @param after - Literal replacement for that unique marker.
+ * @returns Completion after exactly one template marker is replaced and its file mode is restored.
+ */
+export const replaceOnceEffect = Effect.fn("ProjectFiles.replaceOnce")(function* (path, before, after) {
+    const fs = yield* GeneratorFileSystem;
+    const content = yield* fs.readText(path);
     const first = content.indexOf(before);
     if (first < 0 || first !== content.lastIndexOf(before))
-        throw new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", `Template substitution is unavailable: ${path}`);
-    await writeFile(path, content.slice(0, first) + after + content.slice(first + before.length), "utf8");
-    await chmod(path, 0o644);
-}
-export async function removeExamples(root) {
-    for (const directory of EXAMPLE_PATH_PREFIXES)
-        await rm(join(root, directory), { recursive: true, force: true });
-}
-export async function listProjectFiles(root, current = root) {
+        return yield* Effect.fail(domainError(new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", `Template substitution is unavailable: ${path}`)));
+    yield* fs.write(path, content.slice(0, first) + after + content.slice(first + before.length));
+    yield* fs.chmod(path, 0o644);
+}, (effect) => observeExecution("generator", "generation.replaceOnce", effect));
+/**
+ * Removes only the established template examples, with ordered physical settlement.
+ * @param root - Absolute project or owned resource root.
+ * @returns Completion after the known example source directories are removed from the staged project.
+ */
+export const removeExamplesEffect = Effect.fn("ProjectFiles.removeExamples")(function* (root) {
+    const fs = yield* GeneratorFileSystem;
+    yield* Effect.forEach(EXAMPLE_PATH_PREFIXES, (directory) => fs.remove(join(root, directory), { recursive: true, force: true }));
+}, (effect) => observeExecution("generator", "generation.removeExamples", effect));
+/**
+ * Lists generated source files in deterministic order, excluding generated and installed state.
+ * @param root - Absolute project or owned resource root.
+ * @param current - Directory currently traversed beneath the project root.
+ * @returns Sorted relative file paths, excluding .git, node_modules and .relkit runtime output.
+ */
+export const listProjectFilesEffect = Effect.fn("ProjectFiles.list")(function* (root, current = root) {
+    const fs = yield* GeneratorFileSystem;
     const result = [];
-    for (const entry of (await readdir(current, { withFileTypes: true })).sort(compareNames)) {
+    for (const entry of [...(yield* fs.entries(current))].sort(compareNames)) {
         if (entry.name === ".git" || entry.name === "node_modules" || entry.name === ".relkit")
             continue;
         const path = join(current, entry.name);
-        if (entry.isDirectory())
-            result.push(...(await listProjectFiles(root, path)));
-        else if (entry.isFile())
+        if (entry.kind === "directory")
+            result.push(...(yield* listProjectFilesEffect(root, path)));
+        else if (entry.kind === "file")
             result.push(relative(root, path).replaceAll("\\", "/"));
     }
     return result;
-}
+}, (effect) => observeExecution("generator", "generation.list", effect));
+/**
+ * Converts a package name to the existing stable RELKIT application identifier.
+ * @param name - Authored name or declaration key.
+ * @returns A safe unscoped project ID, with app as the empty-normalization fallback.
+ */
 export function projectId(name) {
     const value = name
         .replace(/^@/, "")
@@ -81,7 +125,14 @@ export function projectId(name) {
         .replace(/[^A-Za-z0-9._-]+/g, "-");
     return value.replace(/^[._-]+/, "").replace(/(?<![._-])[._-]+$/, "") || "app";
 }
+/**
+ * Compares directory names without platform locale dependence.
+ * @param left - First value in deterministic comparison.
+ * @param right - Second value in deterministic comparison.
+ * @returns Negative, zero or positive ordering using a deterministic string comparison.
+ */
 export function compareNames(left, right) {
     return left.name < right.name ? -1 : left.name > right.name ? 1 : 0;
 }
+export { cleanupStagedProject, requireTemplate, requireFiles, replaceOnce, removeExamples, listProjectFiles, } from "./generate-files-compat.js";
 //# sourceMappingURL=generate-files-utilities.js.map

package/dist/generate-files-utilities.js.map

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

package/dist/generate-files-utilities.types.d.ts

@@ -0,0 +1,6 @@
+/** Existing staging cleanup result; secondary rejection evidence remains nonenumerable. */
+export interface StageCleanupResult {
+    readonly temporaryPath?: string;
+    readonly removed: boolean;
+}
+//# sourceMappingURL=generate-files-utilities.types.d.ts.map

package/dist/generate-files-utilities.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-files-utilities.types.d.ts","sourceRoot":"","sources":["../src/generate-files-utilities.types.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B"}

package/dist/generate-files-utilities.types.js

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

package/dist/generate-files-utilities.types.js.map

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