create-relkit 0.7.1 → 0.7.4

package/dist/generate-result.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Builds immutable creation output after atomic publication. The final directory
+ * is listed after rename; skipped installation reports the finite preparation
+ * workflow required before the first prepared development launch.
+ */
+import { Effect } from "effect";
+import type { CreateOptions } from "./options.js";
+import type { GenerateProjectContext } from "./generate-types.js";
+/** Produces the published project's stable output contract.
+ * @param options - Normalized creation choices.
+ * @param destination - Atomically published final directory.
+ * @param gitInitialized - Existing optional Git step result.
+ * @param context - Working directory for printed local commands.
+ * @returns Frozen output; listing failures retain their original channel.
+ */
+export declare const generationResult: (options: CreateOptions, destination: string, gitInitialized: boolean, context: GenerateProjectContext) => Effect.Effect<Readonly<{
+    ok: true;
+    command: "create";
+    name: string;
+    template: "agent" | "minimal" | "api" | "fullstack";
+    cloud: "aws" | "none";
+    deploy: "none" | "pulumi";
+    destination: string;
+    files: readonly string[];
+    installed: boolean;
+    gitInitialized: boolean;
+    additions: readonly never[];
+    warnings: readonly {
+        code: string;
+        message: string;
+    }[];
+    nextSteps: import("./generate-output.types.js").GenerateNextSteps;
+}>, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, import("./generator-filesystem.js").GeneratorFileSystem>;
+//# sourceMappingURL=generate-result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-result.d.ts","sourceRoot":"","sources":["../src/generate-result.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAIlE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;qKAkC5B,CAAC"}

package/dist/generate-result.js

@@ -0,0 +1,41 @@
+/**
+ * Builds immutable creation output after atomic publication. The final directory
+ * is listed after rename; skipped installation reports the finite preparation
+ * workflow required before the first prepared development launch.
+ */
+import { Effect } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { listProjectFilesEffect } from "./generate-files.js";
+import { createGenerateNextSteps } from "./generate-output.js";
+/** Produces the published project's stable output contract.
+ * @param options - Normalized creation choices.
+ * @param destination - Atomically published final directory.
+ * @param gitInitialized - Existing optional Git step result.
+ * @param context - Working directory for printed local commands.
+ * @returns Frozen output; listing failures retain their original channel.
+ */
+export const generationResult = Effect.fn("ProjectGeneration.result")(function* (options, destination, gitInitialized, context) {
+    return Object.freeze({
+        ok: true,
+        command: "create",
+        name: options.name,
+        template: options.template,
+        cloud: options.cloud,
+        deploy: options.deploy,
+        destination,
+        files: Object.freeze(yield* listProjectFilesEffect(destination)),
+        installed: options.install,
+        gitInitialized,
+        additions: Object.freeze([]),
+        warnings: Object.freeze(!options.install
+            ? [
+                {
+                    code: "validation-skipped",
+                    message: "Install dependencies, then run bunx --no-install relkit dev --prepare before bun dev. Preparation includes the source check.",
+                },
+            ]
+            : []),
+        nextSteps: createGenerateNextSteps(options, destination, context.cwd),
+    });
+}, (effect) => observeExecution("generator", "generation.result", effect));
+//# sourceMappingURL=generate-result.js.map

package/dist/generate-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-result.js","sourceRoot":"","sources":["../src/generate-result.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CACnE,QAAQ,CAAC,EACP,OAAsB,EACtB,WAAmB,EACnB,cAAuB,EACvB,OAA+B;IAE/B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,IAAa;QACjB,OAAO,EAAE,QAAiB;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW;QACX,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;QAChE,SAAS,EAAE,OAAO,CAAC,OAAO;QAC1B,cAAc;QACd,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,CACrB,CAAC,OAAO,CAAC,OAAO;YACd,CAAC,CAAC;gBACE;oBACE,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EACL,8HAA8H;iBACjI;aACF;YACH,CAAC,CAAC,EAAE,CACP;QACD,SAAS,EAAE,uBAAuB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC;KACtE,CAAC,CAAC;AACL,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,mBAAmB,EAAE,MAAM,CAAC,CACvE,CAAC"}

package/dist/generate-stage.d.ts

@@ -0,0 +1,21 @@
+import { Effect, Ref } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import type { GenerateProjectContext } from "./generate-types.js";
+import type { GenerationStage } from "./generate-stage.types.js";
+/** Acquires one private sibling stage with rollback in the calling Scope.
+ * @param destination - Already validated final project directory.
+ * @param context - Creation cancellation authority.
+ * @returns Scoped ownership requiring GeneratorFileSystem; native failures remain typed.
+ */
+export declare const acquireGenerationStage: (destination: string, context: GenerateProjectContext) => Effect.Effect<{
+    stage: string;
+    published: Ref.Ref<boolean>;
+}, import("./generator-errors.js").GeneratorIoError, GeneratorFileSystem | import("effect/Scope").Scope>;
+/** Atomically transfers a complete installed/prepared stage to the destination.
+ * @param owned - Stage acquired in this creation Scope.
+ * @param destination - Validated final directory.
+ * @param context - Failure injection and cancellation authority.
+ * @returns Completion after native rename and ownership bookkeeping settle together.
+ */
+export declare const publishGenerationStage: (owned: GenerationStage, destination: string, context: GenerateProjectContext) => Effect.Effect<void, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem>;
+//# sourceMappingURL=generate-stage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-stage.d.ts","sourceRoot":"","sources":["../src/generate-stage.ts"],"names":[],"mappings":"AAOA,OAAO,EAAS,MAAM,EAAQ,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAMhE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;wGAgClC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,qOAYlC,CAAC"}

package/dist/generate-stage.js

@@ -0,0 +1,52 @@
+/**
+ * Acquires and publishes the sibling directory used by atomic project creation.
+ * A Scope removes only its unpublished stage and attaches cleanup disposition
+ * to the authoritative failure. Native rename settles before ownership transfers,
+ * preventing cancellation from exposing an incomplete destination.
+ */
+import { basename, dirname, join } from "node:path";
+import { Cause, Effect, Exit, Ref } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { cleanupStagedProjectEffect } from "./generate-files.js";
+import { recordCleanupFailure } from "./generator-cleanup.js";
+import { recordStageCleanup } from "./generate-stage-cleanup.js";
+import { domainTry } from "./generator-errors.js";
+import { injectGenerateFailure, throwIfAborted } from "./generate-process.js";
+/** Acquires one private sibling stage with rollback in the calling Scope.
+ * @param destination - Already validated final project directory.
+ * @param context - Creation cancellation authority.
+ * @returns Scoped ownership requiring GeneratorFileSystem; native failures remain typed.
+ */
+export const acquireGenerationStage = Effect.fn("ProjectGeneration.acquireStage")(function* (destination, context) {
+    const fs = yield* GeneratorFileSystem;
+    return yield* Effect.acquireRelease(Effect.gen(function* () {
+        yield* fs.mkdir(dirname(destination), { recursive: true, mode: 0o755 });
+        const stage = yield* fs.temporaryDirectory(join(dirname(destination), `.${basename(destination)}-relkit-`));
+        return { stage, published: yield* Ref.make(false) };
+    }), (owned, exit) => Effect.gen(function* () {
+        if (yield* Ref.get(owned.published))
+            return;
+        const cleanup = yield* cleanupStagedProjectEffect(owned.stage, destination).pipe(Effect.catchCause((cause) => Effect.gen(function* () {
+            const retained = { temporaryPath: owned.stage, removed: false };
+            yield* recordCleanupFailure(Exit.succeed(retained), "stage", Cause.squash(cause));
+            return retained;
+        })));
+        yield* recordStageCleanup(exit, cleanup, context.signal?.aborted ? context.signal : undefined);
+    }));
+}, (effect) => observeExecution("generator", "generation.acquireStage", effect));
+/** Atomically transfers a complete installed/prepared stage to the destination.
+ * @param owned - Stage acquired in this creation Scope.
+ * @param destination - Validated final directory.
+ * @param context - Failure injection and cancellation authority.
+ * @returns Completion after native rename and ownership bookkeeping settle together.
+ */
+export const publishGenerationStage = Effect.fn("ProjectGeneration.publishStage")(function* (owned, destination, context) {
+    yield* domainTry(() => {
+        throwIfAborted(context.signal);
+        injectGenerateFailure(context, "rename");
+    });
+    const fs = yield* GeneratorFileSystem;
+    yield* Effect.uninterruptible(fs.rename(owned.stage, destination).pipe(Effect.tap(() => Ref.set(owned.published, true))));
+}, (effect) => observeExecution("generator", "generation.publishStage", effect));
+//# sourceMappingURL=generate-stage.js.map

package/dist/generate-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-stage.js","sourceRoot":"","sources":["../src/generate-stage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAC/E,QAAQ,CAAC,EAAE,WAAmB,EAAE,OAA+B;IAC7D,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC;IACtC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CACjC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,kBAAkB,CACxC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAChE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACtD,CAAC,CAAC,EACF,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACd,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;YAAE,OAAO;QAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,0BAA0B,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,IAAI,CAC9E,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,QAAQ,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAChE,KAAK,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAClF,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CACH,CACF,CAAC;QACF,KAAK,CAAC,CAAC,kBAAkB,CACvB,IAAI,EACJ,OAAO,EACP,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CACrD,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;AACJ,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,yBAAyB,EAAE,MAAM,CAAC,CAC7E,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAC/E,QAAQ,CAAC,EAAE,KAAsB,EAAE,WAAmB,EAAE,OAA+B;IACrF,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE;QACpB,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC;IACtC,KAAK,CAAC,CAAC,MAAM,CAAC,eAAe,CAC3B,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAC3F,CAAC;AACJ,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,yBAAyB,EAAE,MAAM,CAAC,CAC7E,CAAC"}

package/dist/generate-stage.types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Describes one creation transaction's private directory ownership. Publication
+ * transfers the directory atomically; before that point the Scope owns cleanup.
+ */
+import type { Ref } from "effect";
+/** A private creation stage and its publication state. */
+export interface GenerationStage {
+    readonly stage: string;
+    readonly published: Ref.Ref<boolean>;
+}
+//# sourceMappingURL=generate-stage.types.d.ts.map

package/dist/generate-stage.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-stage.types.d.ts","sourceRoot":"","sources":["../src/generate-stage.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElC,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;CACtC"}

package/dist/generate-stage.types.js

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

package/dist/generate-stage.types.js.map

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

package/dist/generate-workflow.d.ts

@@ -1,14 +1,17 @@
+/**
+ * Owns atomic creation from normalized options through installed preparation.
+ * The creation Scope keeps its private sibling stage until a successful finite
+ * check/snapshot operation; failure cleans that stage before the public adapter
+ * returns. Published directories transfer to the user.
+ */
 import { Effect } from "effect";
 import type { CreateOptions } from "./options.js";
 import { type GenerateProjectContext } from "./generate-types.js";
-import { GeneratorFileSystem } from "./generator-filesystem.js";
-import { GeneratorProcess } from "./generator-process.js";
 import { GeneratorPrompt } from "./generator-prompt.js";
-/**
- * Validates, prepares, verifies and publishes while a Scope owns the disposable stage.
+/** Validates, prepares and publishes while a Scope owns the disposable stage.
  * @param options - Explicit options retaining existing defaults.
- * @param context - Caller-owned settings and cancellation.
- * @returns The published project's immutable result after native child settlement and staging cleanup.
+ * @param context - Caller-owned prompt, process, cancellation and progress settings.
+ * @returns Lazy scoped workflow preserving existing public failures and output.
  */
 export declare const generateEffect: (options: CreateOptions, context: GenerateProjectContext) => Effect.Effect<Readonly<{
     ok: true;
@@ -27,5 +30,5 @@ export declare const generateEffect: (options: CreateOptions, context: GenerateP
         message: string;
     }[];
     nextSteps: import("./generate-output.types.js").GenerateNextSteps;
-}>, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorProcessError | import("./generator-errors.js").GeneratorPromptError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem | GeneratorProcess | import("./generator-paths.js").GeneratorPaths | GeneratorPrompt>;
+}>, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorProcessError | import("./generator-errors.js").GeneratorPromptError | import("./generator-errors.js").GeneratorDomainError, import("./generator-filesystem.js").GeneratorFileSystem | import("./generator-process.js").GeneratorProcess | import("./generator-paths.js").GeneratorPaths | GeneratorPrompt>;
 //# sourceMappingURL=generate-workflow.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"generate-workflow.d.ts","sourceRoot":"","sources":["../src/generate-workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,MAAM,EAAa,MAAM,QAAQ,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAmBlD,OAAO,EAAwB,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMxD;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;qUA0J1B,CAAC"}
+{"version":3,"file":"generate-workflow.d.ts","sourceRoot":"","sources":["../src/generate-workflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAwB,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAUxD;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;0YA+B1B,CAAC"}

package/dist/generate-workflow.js

@@ -1,24 +1,22 @@
-import { basename, dirname, join } from "node:path";
-import { Cause, Effect, Exit, Ref } from "effect";
+/**
+ * Owns atomic creation from normalized options through installed preparation.
+ * The creation Scope keeps its private sibling stage until a successful finite
+ * check/snapshot operation; failure cleans that stage before the public adapter
+ * returns. Published directories transfer to the user.
+ */
+import { Effect } from "effect";
 import { observeExecution } from "@relkit/contracts/operation";
 import { validateCreateOptionsEffect } from "./validate.js";
-import { injectGenerateFailure, resolveRelkitExecutableEffect, runProjectStepEffect, throwIfAborted, } from "./generate-process.js";
-import { copyTemplateEffect, cleanupStagedProjectEffect, customizeProjectEffect, listProjectFilesEffect, requireFilesEffect, requireTemplateEffect, } from "./generate-files.js";
-import { createGenerateNextSteps } from "./generate-output.js";
-import { prepareProjectDependencyPatchEffect } from "./dependency-patches.js";
-import { resolveTemplateRootEffect } from "./template-root.js";
 import { GenerateProjectError } from "./generate-types.js";
-import { GeneratorFileSystem } from "./generator-filesystem.js";
-import { GeneratorProcess } from "./generator-process.js";
 import { GeneratorPrompt } from "./generator-prompt.js";
-import { domainError, domainTry } from "./generator-errors.js";
-import { recordCleanupFailure } from "./generator-cleanup.js";
-import { recordStageCleanup } from "./generate-stage-cleanup.js";
-/**
- * Validates, prepares, verifies and publishes while a Scope owns the disposable stage.
+import { domainError } from "./generator-errors.js";
+import { acquireGenerationStage, publishGenerationStage } from "./generate-stage.js";
+import { materializeGenerationStage, installGenerationStage, verifyGenerationStage, } from "./generate-preparation.js";
+import { generationResult } from "./generate-result.js";
+/** Validates, prepares and publishes while a Scope owns the disposable stage.
  * @param options - Explicit options retaining existing defaults.
- * @param context - Caller-owned settings and cancellation.
- * @returns The published project's immutable result after native child settlement and staging cleanup.
+ * @param context - Caller-owned prompt, process, cancellation and progress settings.
+ * @returns Lazy scoped workflow preserving existing public failures and output.
  */
 export const generateEffect = Effect.fn("ProjectGeneration.execute")((options, context) => Effect.scoped(Effect.gen(function* () {
     const validated = yield* validateCreateOptionsEffect(options, context.cwd === undefined ? {} : { cwd: context.cwd });
@@ -26,92 +24,15 @@ export const generateEffect = Effect.fn("ProjectGeneration.execute")((options, c
         !(yield* (yield* GeneratorPrompt).confirm({
             message: "Create this project?",
             initialValue: true,
-        })))
+        }))) {
         return yield* Effect.fail(domainError(new GenerateProjectError("RELKIT_CREATE_CANCELLED", "Scaffolding was cancelled.")));
-    context.onProgress?.(`Creating a new RELKIT app in ${validated.destination}.`);
-    const fs = yield* GeneratorFileSystem;
-    const templateRoot = yield* resolveTemplateRootEffect(context);
-    const template = join(templateRoot, options.jobs === undefined ? options.template : "tasks");
-    yield* requireTemplateEffect(template);
-    const owned = yield* Effect.acquireRelease(Effect.gen(function* () {
-        yield* fs.mkdir(dirname(validated.destination), { recursive: true, mode: 0o755 });
-        const stage = yield* fs.temporaryDirectory(join(dirname(validated.destination), `.${basename(validated.destination)}-relkit-`));
-        return { stage, published: yield* Ref.make(false) };
-    }), (owned, exit) => Effect.gen(function* () {
-        if (yield* Ref.get(owned.published))
-            return;
-        const cleanup = yield* cleanupStagedProjectEffect(owned.stage, validated.destination).pipe(Effect.catchCause((cause) => Effect.gen(function* () {
-            const retained = { temporaryPath: owned.stage, removed: false };
-            yield* recordCleanupFailure(Exit.succeed(retained), "stage", Cause.squash(cause));
-            return retained;
-        })));
-        yield* recordStageCleanup(exit, cleanup, context.signal?.aborted ? context.signal : undefined);
-    }));
-    yield* domainTry(() => injectGenerateFailure(context, "copy"));
-    yield* copyTemplateEffect(template, owned.stage);
-    yield* domainTry(() => injectGenerateFailure(context, "substitute"));
-    yield* customizeProjectEffect(owned.stage, options);
-    yield* requireFilesEffect(owned.stage, [
-        "package.json",
-        "relkit.config.ts",
-        "src/platform/env.ts",
-        ".env.example",
-        ".gitignore",
-    ]);
-    yield* prepareProjectDependencyPatchEffect(owned.stage);
-    if (options.install) {
-        context.onProgress?.("Installing dependencies...");
-        yield* runProjectStepEffect(context, [context.bunExecutable ?? globalThis.process.execPath, "install"], owned.stage, "install", "install");
     }
-    const git = context.gitExecutable ??
-        (context.commandRunner ? "git" : yield* (yield* GeneratorProcess).which("git"));
-    const gitInitialized = options.git && git !== null;
-    if (gitInitialized) {
-        context.onProgress?.("Initializing Git repository...");
-        yield* runProjectStepEffect(context, [git, "init"], owned.stage, "git", "git");
-    }
-    if (options.install) {
-        const relkit = yield* resolveRelkitExecutableEffect(context, owned.stage);
-        context.onProgress?.("Checking generated project...");
-        yield* runProjectStepEffect(context, [
-            relkit,
-            "doctor",
-            "--project-root",
-            owned.stage,
-            "--no-ports",
-            ...(options.cloud === "none" || options.deploy === "none" ? ["--no-pulumi"] : []),
-        ], owned.stage, "doctor", "doctor");
-        yield* runProjectStepEffect(context, [relkit, "check", "--project-root", owned.stage], owned.stage, "check", "check");
-    }
-    yield* domainTry(() => {
-        throwIfAborted(context.signal);
-        injectGenerateFailure(context, "rename");
-    });
-    // Native rename and publication bookkeeping settle as one atomic ownership handoff.
-    yield* Effect.uninterruptible(fs
-        .rename(owned.stage, validated.destination)
-        .pipe(Effect.tap(() => Ref.set(owned.published, true))));
-    return Object.freeze({
-        ok: true,
-        command: "create",
-        name: options.name,
-        template: options.template,
-        cloud: options.cloud,
-        deploy: options.deploy,
-        destination: validated.destination,
-        files: Object.freeze(yield* listProjectFilesEffect(validated.destination)),
-        installed: options.install,
-        gitInitialized,
-        additions: Object.freeze([]),
-        warnings: Object.freeze(!options.install
-            ? [
-                {
-                    code: "validation-skipped",
-                    message: "Install dependencies, then run bun run check.",
-                },
-            ]
-            : []),
-        nextSteps: createGenerateNextSteps(options, validated.destination, context.cwd),
-    });
+    context.onProgress?.(`Creating a new RELKIT app in ${validated.destination}.`);
+    const owned = yield* acquireGenerationStage(validated.destination, context);
+    yield* materializeGenerationStage(owned.stage, options, context);
+    const gitInitialized = yield* installGenerationStage(owned.stage, options, context);
+    yield* verifyGenerationStage(owned.stage, options, context);
+    yield* publishGenerationStage(owned, validated.destination, context);
+    return yield* generationResult(options, validated.destination, gitInitialized, context);
 })), (effect) => observeExecution("generator", "generation.execute", effect));
 //# sourceMappingURL=generate-workflow.js.map

package/dist/generate-workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-workflow.js","sourceRoot":"","sources":["../src/generate-workflow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generate-workflow.js","sourceRoot":"","sources":["../src/generate-workflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAA+B,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAClE,CAAC,OAAsB,EAAE,OAA+B,EAAE,EAAE,CAC1D,MAAM,CAAC,MAAM,CACX,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,2BAA2B,CAClD,OAAO,EACP,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CACtD,CAAC;IACF,IACE,OAAO,CAAC,WAAW,KAAK,IAAI;QAC5B,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC;YACxC,OAAO,EAAE,sBAAsB;YAC/B,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC,EACH,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,WAAW,CACT,IAAI,oBAAoB,CAAC,yBAAyB,EAAE,4BAA4B,CAAC,CAClF,CACF,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,UAAU,EAAE,CAAC,gCAAgC,SAAS,CAAC,WAAW,GAAG,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,sBAAsB,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5E,KAAK,CAAC,CAAC,0BAA0B,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjE,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpF,KAAK,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5D,KAAK,CAAC,CAAC,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACrE,OAAO,KAAK,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;AAC1F,CAAC,CAAC,CACH,EACH,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,oBAAoB,EAAE,MAAM,CAAC,CACxE,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./options.js";
+export * from "./create-capabilities.js";
 export * from "./add-types.js";
 export * from "./add-name.js";
 export * from "./add-options.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAErC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAErC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./options.js";
+export * from "./create-capabilities.js";
 export * from "./add-types.js";
 export * from "./add-name.js";
 export * from "./add-options.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAErC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAErC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/templates/default/README.md

@@ -8,6 +8,6 @@ scaffolder:
 - `agent` — the minimal example plus a read-only tool and agent descriptor.
 
 Each variant is self-contained and can be copied as a project root. It uses
-the current checked-in RelKit package version (`0.7.1`), Bun `1.3.10`, and
+the current checked-in RelKit package version (`0.7.4`), Bun `1.3.10`, and
 TypeScript `5.9.3`. The generator owns project-name substitution and later
 installation/Git behavior.

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

@@ -16,14 +16,15 @@
   },
   "dependencies": {
     "@langchain/langgraph": "1.4.14",
-    "@relkit/app": "0.7.1",
-    "@relkit/local": "0.7.1",
+    "@relkit/app": "0.7.4",
+    "@relkit/local": "0.7.4",
+    "effect": "4.0.1",
     "langchain": "1.5.10"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.7.1",
-    "@relkit/testing": "0.7.1",
+    "@relkit/cli": "0.7.4",
+    "@relkit/testing": "0.7.4",
     "typescript": "5.9.3"
   }
 }

package/dist/templates/default/v1/agent/src/hello/agents/assistant.agent.ts

@@ -3,7 +3,7 @@ import { z } from "@relkit/app/schema";
 import { FakeToolCallingModel, todoListMiddleware, tool } from "langchain";
 import lookup from "@app/hello/tools/lookup.tool.js";
 
-export const uppercase = tool(async ({ text }) => text.toUpperCase(), {
+export const uppercase = tool(async ({ text }: { readonly text: string }) => text.toUpperCase(), {
   name: "uppercase",
   description: "Uppercase text without leaving the process",
   schema: z.object({ text: z.string() }),

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

@@ -15,12 +15,13 @@
     "graph": "relkit graph print"
   },
   "dependencies": {
-    "@relkit/app": "0.7.1"
+    "@relkit/app": "0.7.4",
+    "effect": "4.0.1"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.7.1",
-    "@relkit/testing": "0.7.1",
+    "@relkit/cli": "0.7.4",
+    "@relkit/testing": "0.7.4",
     "typescript": "5.9.3"
   }
 }

package/dist/templates/default/v1/fullstack/README.md

@@ -8,8 +8,15 @@ port 3001, and the Inspector on port 3210.
 
 ```sh
 bun install
+bunx --no-install relkit dev --prepare
 bun run dev
 bun run test
 bun run typecheck
 bun run build
 ```
+
+Creation with installation prepares the backend automatically. If installation
+was skipped, the finite preparation command above validates and prepares it after
+`bun install`. The API and Next.js commands start independently; `bun run dev:api`
+and `bun run dev:web` can also be used separately. Backend readiness does not
+mean the Next.js page or Inspector has finished starting.

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

@@ -4,7 +4,7 @@
   "type": "module",
   "packageManager": "bun@1.3.10",
   "scripts": {
-    "dev": "bun run check && bun run --parallel dev:api dev:web",
+    "dev": "bun run --parallel dev:api dev:web",
     "dev:api": "RELKIT_ALLOWED_ORIGINS=http://127.0.0.1:3001 relkit dev",
     "dev:web": "next dev web --hostname 127.0.0.1 --port 3001",
     "check": "relkit check",
@@ -15,18 +15,19 @@
   },
   "dependencies": {
     "@langchain/langgraph": "1.4.14",
-    "@relkit/app": "0.7.1",
-    "@relkit/client": "0.7.1",
-    "@relkit/local": "0.7.1",
+    "@relkit/app": "0.7.4",
+    "@relkit/client": "0.7.4",
+    "@relkit/local": "0.7.4",
     "@tanstack/react-query": "5.102.3",
+    "effect": "4.0.1",
     "langchain": "1.5.10",
     "next": "16.3.8",
     "react": "19.2.8",
     "react-dom": "19.2.8"
   },
   "devDependencies": {
-    "@relkit/cli": "0.7.1",
-    "@relkit/testing": "0.7.1",
+    "@relkit/cli": "0.7.4",
+    "@relkit/testing": "0.7.4",
     "@types/bun": "1.3.10",
     "@types/react": "19.2.18",
     "@types/react-dom": "19.2.7",

package/dist/templates/default/v1/fullstack/src/hello/agents/assistant.agent.ts

@@ -3,7 +3,7 @@ import { z } from "@relkit/app/schema";
 import { FakeToolCallingModel, todoListMiddleware, tool } from "langchain";
 import lookup from "@app/hello/tools/lookup.tool.js";
 
-const uppercase = tool(async ({ text }) => text.toUpperCase(), {
+const uppercase = tool(async ({ text }: { readonly text: string }) => text.toUpperCase(), {
   name: "uppercase",
   description: "Uppercase text without leaving the process",
   schema: z.object({ text: z.string() }),

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

@@ -15,12 +15,13 @@
     "graph": "relkit graph print"
   },
   "dependencies": {
-    "@relkit/app": "0.7.1"
+    "@relkit/app": "0.7.4",
+    "effect": "4.0.1"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.7.1",
-    "@relkit/testing": "0.7.1",
+    "@relkit/cli": "0.7.4",
+    "@relkit/testing": "0.7.4",
     "typescript": "5.9.3"
   }
 }

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-relkit",
-  "version": "0.7.1",
+  "version": "0.7.4",
   "description": "Create a RELKIT application from a supported project template.",
   "license": "MIT",
   "repository": {
@@ -44,10 +44,10 @@
   },
   "dependencies": {
     "@clack/prompts": "1.7.0",
-    "@relkit/compiler": "0.7.1",
+    "@relkit/compiler": "0.7.4",
     "typescript": "5.9.3",
     "effect": "4.0.1",
-    "@relkit/contracts": "0.7.1"
+    "@relkit/contracts": "0.7.4"
   },
   "devDependencies": {
     "@effect/vitest": "4.0.1",