create-relkit 0.5.6 → 0.7.0

package/dist/add-plan.js

@@ -1,62 +1,96 @@
-import { resolveDomain } from "./domain-planning.js";
+import { Context, Effect, Layer } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { scaffoldErrors } from "./generator-errors.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
+import { resolveDomainEffect } from "./domain-planning.js";
 import { PlanBuilder } from "./plan-builder.js";
-import { discoverProject } from "./project-discovery.js";
-import { renderAgent, renderTool } from "./render-ai.js";
-import { renderAuth } from "./render-auth.js";
-import { renderDatabase } from "./render-database.js";
-import { renderConstants, renderError, renderEvent, renderEventFunction, renderFunction, renderJob, renderTask, renderPrompt, } from "./render-domain.js";
-import { renderBucket, renderCache } from "./render-resources.js";
-import { renderMiddleware, renderRoute, renderTransform } from "./render-routes.js";
-import { renderService } from "./render-service.js";
+import { ProjectDiscoveryServiceTag, projectDiscoveryLive } from "./project-discovery.js";
+import { renderAgentEffect, renderToolEffect } from "./render-ai.js";
+import { renderAuthEffect } from "./render-auth.js";
+import { renderDatabaseEffect } from "./render-database.js";
+import { renderConstantsEffect, renderErrorEffect, renderEventEffect, renderEventFunctionEffect, renderFunctionEffect, renderJobEffect, renderTaskEffect, renderPromptEffect, } from "./render-domain.js";
+import { renderBucketEffect, renderCacheEffect } from "./render-resources.js";
+import { renderMiddlewareEffect, renderRouteEffect, renderTransformEffect, } from "./render-routes.js";
+import { renderServiceEffect } from "./render-service.js";
 /** Inspects a project and produces one complete, conflict-checked add plan. */
-export async function planAdd(request) {
-    const builder = new PlanBuilder(request, await discoverProject(request.projectRoot));
-    if (request.kind === "service")
-        await renderService(builder, request);
-    else if (request.kind === "route") {
-        const target = request.mode === "service-route" ? await resolveDomain(builder) : undefined;
-        if (target && !target.service) {
-            for (const member of new Set(Object.values(request.maps))) {
-                await renderFunction(builder, target, member);
+/** Cohesive discovery and planning authority, with isolated Ref state per request. */
+export class ScaffoldPlanning extends Context.Service()("create-relkit/ScaffoldPlanning") {
+}
+/**
+ * Planning Layer captures only declaration discovery and filesystem authority.
+ * @returns A ScaffoldPlanning Layer requiring declaration discovery and filesystem services.
+ */
+export const scaffoldPlanningLive = Layer.effect(ScaffoldPlanning, Effect.gen(function* () {
+    const discovery = yield* ProjectDiscoveryServiceTag;
+    const fs = yield* GeneratorFileSystem;
+    return ScaffoldPlanning.of({
+        plan: Effect.fn("ScaffoldPlanning.plan")((request) => observeExecution("generator", "planning.plan", Effect.gen(function* () {
+            const builder = new PlanBuilder(request, yield* discovery.discover(request.projectRoot));
+            if (request.kind === "service")
+                yield* renderServiceEffect(builder, request);
+            else if (request.kind === "route") {
+                const target = request.mode === "service-route" ? yield* resolveDomainEffect(builder) : undefined;
+                if (target && !target.service) {
+                    for (const member of new Set(Object.values(request.maps))) {
+                        yield* renderFunctionEffect(builder, target, member);
+                    }
+                }
+                yield* renderRouteEffect(builder, request, target);
+            }
+            else if (request.kind === "middleware")
+                yield* renderMiddlewareEffect(builder, request);
+            else if (request.kind === "transform")
+                yield* renderTransformEffect(builder, request);
+            else if (request.kind === "database")
+                yield* renderDatabaseEffect(builder, request);
+            else if (request.kind === "auth")
+                yield* renderAuthEffect(builder, request);
+            else {
+                const target = yield* resolveDomainEffect(builder);
+                if (request.kind === "function")
+                    yield* renderFunctionEffect(builder, target, request.name, request);
+                else if (request.kind === "error")
+                    yield* renderErrorEffect(builder, target, request.name);
+                else if (request.kind === "event")
+                    yield* renderEventEffect(builder, target, request.name, request);
+                else if (request.kind === "event-function")
+                    yield* renderEventFunctionEffect(builder, target, request);
+                else if (request.kind === "task")
+                    yield* renderTaskEffect(builder, target, request);
+                else if (request.kind === "job")
+                    yield* renderJobEffect(builder, target, request);
+                else if (request.kind === "cache")
+                    yield* renderCacheEffect(builder, target, request);
+                else if (request.kind === "bucket")
+                    yield* renderBucketEffect(builder, target, request);
+                else if (request.kind === "tool")
+                    yield* renderToolEffect(builder, target, request);
+                else if (request.kind === "prompt")
+                    yield* renderPromptEffect(builder, target, request.name, request.text);
+                else if (request.kind === "agent")
+                    yield* renderAgentEffect(builder, target, request);
+                else if (request.kind === "constants")
+                    yield* renderConstantsEffect(builder, target, request.name);
             }
-        }
-        await renderRoute(builder, request, target);
-    }
-    else if (request.kind === "middleware")
-        await renderMiddleware(builder, request);
-    else if (request.kind === "transform")
-        await renderTransform(builder, request);
-    else if (request.kind === "database")
-        await renderDatabase(builder, request);
-    else if (request.kind === "auth")
-        await renderAuth(builder, request);
-    else {
-        const target = await resolveDomain(builder);
-        if (request.kind === "function")
-            await renderFunction(builder, target, request.name, request);
-        else if (request.kind === "error")
-            await renderError(builder, target, request.name);
-        else if (request.kind === "event")
-            await renderEvent(builder, target, request.name, request);
-        else if (request.kind === "event-function")
-            await renderEventFunction(builder, target, request);
-        else if (request.kind === "task")
-            await renderTask(builder, target, request);
-        else if (request.kind === "job")
-            await renderJob(builder, target, request);
-        else if (request.kind === "cache")
-            await renderCache(builder, target, request);
-        else if (request.kind === "bucket")
-            await renderBucket(builder, target, request);
-        else if (request.kind === "tool")
-            await renderTool(builder, target, request);
-        else if (request.kind === "prompt")
-            await renderPrompt(builder, target, request.name, request.text);
-        else if (request.kind === "agent")
-            await renderAgent(builder, target, request);
-        else if (request.kind === "constants")
-            await renderConstants(builder, target, request.name);
-    }
-    return builder.finish();
+            return yield* builder.finishEffect();
+        }).pipe(scaffoldErrors, Effect.provideService(GeneratorFileSystem, fs)), () => ({ requests: 1 }))),
+    });
+}));
+/**
+ * Plans an artifact through an explicitly supplied planning service.
+ * @param request - Normalized scaffold request.
+ * @returns A lazy immutable plan; planning never writes project files.
+ */
+export const planAddEffect = Effect.fn("ScaffoldPlanning.add")(function* (request) {
+    return yield* (yield* ScaffoldPlanning).plan(request);
+}, (effect) => observeExecution("generator", "ScaffoldPlanning.add", effect));
+/**
+ * Preserves the existing public Promise API and stable rejection constructors.
+ * @param request - Normalized scaffold request.
+ * @returns All ordered file operations and dependency ownership decisions.
+ */
+export function planAdd(request) {
+    return runGeneratorPromise(planAddEffect(request).pipe(Effect.provide(scaffoldPlanningLive), Effect.provide(projectDiscoveryLive)));
 }
 //# sourceMappingURL=add-plan.js.map

package/dist/add-plan.js.map

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

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

@@ -0,0 +1,13 @@
+import type { Effect } from "effect";
+import type { AddRequest, ScaffoldPlan } from "./add-types.js";
+import type { GeneratorDomainError, GeneratorIoError } from "./generator-errors.js";
+/** Discovery and rendering owner; its acquired capabilities remain explicit Layer dependencies. */
+export interface ScaffoldPlanningService {
+    /**
+     * Discovers declarations and constructs a complete conflict-checked add plan.
+     * @param request - Normalized scaffold request.
+     * @returns An Effect returning ordered operations and concrete dependencies without writing files.
+     */
+    readonly plan: (request: AddRequest) => Effect.Effect<ScaffoldPlan, GeneratorDomainError | GeneratorIoError>;
+}
+//# sourceMappingURL=add-plan.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add-plan.types.d.ts","sourceRoot":"","sources":["../src/add-plan.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,mGAAmG;AACnG,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,CACb,OAAO,EAAE,UAAU,KAChB,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,oBAAoB,GAAG,gBAAgB,CAAC,CAAC;CAC3E"}

package/dist/add-plan.types.js

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

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

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

package/dist/add-resolution-discovery.d.ts

@@ -1,13 +1,67 @@
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GeneratorPrompt } from "./generator-prompt.js";
+import { type GeneratorDomainError, type GeneratorIoError, type GeneratorPromptError } from "./generator-errors.js";
 import { AddResolutionState } from "./add-resolution-state.js";
 import type { DiscoveredArtifact, DiscoveredProfile, ProjectDiscovery } from "./project-discovery-types.js";
-export declare function resolveService(state: AddResolutionState, discovery: ProjectDiscovery): Promise<void>;
-export declare function resolveServiceForKind(state: AddResolutionState, discovery: ProjectDiscovery): Promise<void>;
+/**
+ * Resolves resolve service through explicit prompt and filesystem authority.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @returns Completion after a missing service choice is recorded in request state.
+ */
+export declare const resolveServiceEffect: (state: AddResolutionState, discovery: ProjectDiscovery) => Effect.Effect<void, GeneratorIoError | GeneratorPromptError | GeneratorDomainError, GeneratorFileSystem | GeneratorPrompt>;
+/**
+ * Resolves resolve service for kind through explicit prompt and filesystem authority.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @returns Completion after service selection is resolved for the requested artifact kind.
+ */
+export declare const resolveServiceForKindEffect: (state: AddResolutionState, discovery: ProjectDiscovery) => Effect.Effect<void, GeneratorIoError | GeneratorPromptError | GeneratorDomainError, GeneratorFileSystem | GeneratorPrompt>;
+/**
+ * Resolves the selected service to its normalized domain identity.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @returns The requested/new service domain, or undefined when no service was selected.
+ */
 export declare function selectedDomain(state: AddResolutionState, discovery: ProjectDiscovery): string | undefined;
+/**
+ * Selects exported artifacts of one kind within a domain.
+ * @param discovery - Declaration-only project facts.
+ * @param domain - Normalized owning domain, or undefined for root artifacts.
+ * @param kind - Artifact kind to select.
+ * @returns Matching source-discovered artifacts in discovery order.
+ */
 export declare function artifacts(discovery: ProjectDiscovery, domain: string | undefined, kind: DiscoveredArtifact["kind"]): readonly DiscoveredArtifact[];
+/**
+ * Builds prompt choices from exported artifact identities.
+ * @param values - Matching discovered artifacts.
+ * @returns Choice values using descriptor IDs when available, with source-path hints.
+ */
 export declare function artifactOptions(values: readonly DiscoveredArtifact[]): {
     value: string;
     label: string;
     hint: string;
 }[];
+/**
+ * Selects provider profiles for one capability.
+ * @param discovery - Declaration-only project facts.
+ * @param capability - Requested provider capability.
+ * @returns Profiles of the requested capability in discovery order.
+ */
 export declare function profiles(discovery: ProjectDiscovery, capability: DiscoveredProfile["capability"]): readonly DiscoveredProfile[];
+/**
+ * Preserves the existing resolveService Promise API.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function resolveService(state: AddResolutionState, discovery: ProjectDiscovery): Promise<void>;
+/**
+ * Preserves the existing resolveServiceForKind Promise API.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function resolveServiceForKind(state: AddResolutionState, discovery: ProjectDiscovery): Promise<void>;
 //# sourceMappingURL=add-resolution-discovery.d.ts.map

package/dist/add-resolution-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-resolution-discovery.d.ts","sourceRoot":"","sources":["../src/add-resolution-discovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAS,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAiBtC,wBAAsB,cAAc,CAClC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,gBAAgB,GAC1B,MAAM,GAAG,SAAS,CAYpB;AAED,wBAAgB,SAAS,CACvB,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAC/B,SAAS,kBAAkB,EAAE,CAI/B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE;;;;IAMpE;AAED,wBAAgB,QAAQ,CACtB,SAAS,EAAE,gBAAgB,EAC3B,UAAU,EAAE,iBAAiB,CAAC,YAAY,CAAC,GAC1C,SAAS,iBAAiB,EAAE,CAE9B"}
+{"version":3,"file":"add-resolution-discovery.d.ts","sourceRoot":"","sources":["../src/add-resolution-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAE9E,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,kBAAkB,EAAS,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAoBtC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,wLA8BhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,wLAavC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,gBAAgB,GAC1B,MAAM,GAAG,SAAS,CAYpB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAC/B,SAAS,kBAAkB,EAAE,CAI/B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE;;;;IAMpE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,gBAAgB,EAC3B,UAAU,EAAE,iBAAiB,CAAC,YAAY,CAAC,GAC1C,SAAS,iBAAiB,EAAE,CAE9B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/add-resolution-discovery.js

@@ -1,5 +1,15 @@
+import { Effect } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GeneratorPrompt, generatorPromptLayer } from "./generator-prompt.js";
+import { createClackPromptDriver } from "./prompt-driver.js";
+import { scaffoldErrors, } from "./generator-errors.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
 import { normalizeArtifactName } from "./add-name.js";
 import { AddResolutionState, label } from "./add-resolution-state.js";
+/**
+ * Artifact kinds that can be placed inside a generic service.
+ */
 const SERVICE_KINDS = new Set([
     "function",
     "error",
@@ -14,17 +24,23 @@ const SERVICE_KINDS = new Set([
     "agent",
     "constants",
 ]);
-export async function resolveService(state, discovery) {
+/**
+ * Resolves resolve service through explicit prompt and filesystem authority.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @returns Completion after a missing service choice is recorded in request state.
+ */
+export const resolveServiceEffect = Effect.fn("AddResolution.resolveService")(function* (state, discovery) {
     if (state.parsed.service || state.parsed.createService)
         return;
     const services = discovery.services.filter((service) => service.capability === "generic");
     if (!state.interactive) {
         if (services.length === 1)
-            state.option("service", services[0].domain);
+            yield* state.optionEffect("service", services[0].domain);
         return;
     }
     const create = "__create_service__";
-    const selected = await state.select("Choose a service", [
+    const selected = yield* state.selectEffect("Choose a service", [
         ...services.map((service) => ({
             value: service.domain,
             label: label(service.domain),
@@ -33,17 +49,29 @@ export async function resolveService(state, discovery) {
         { value: create, label: "Create a new service" },
     ]);
     if (selected === create) {
-        const name = await state.text("New service name", undefined, true);
+        const name = yield* state.textEffect("New service name", undefined, true);
         if (name)
-            state.option("create-service", name);
+            yield* state.optionEffect("create-service", name);
     }
     else if (selected)
-        state.option("service", selected);
-}
-export async function resolveServiceForKind(state, discovery) {
+        yield* state.optionEffect("service", selected);
+}, (effect) => observeExecution("generator", "add.resolve.resolveService", scaffoldErrors(effect)));
+/**
+ * Resolves resolve service for kind through explicit prompt and filesystem authority.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @returns Completion after service selection is resolved for the requested artifact kind.
+ */
+export const resolveServiceForKindEffect = Effect.fn("AddResolution.resolveServiceForKind")(function* (state, discovery) {
     if (SERVICE_KINDS.has(state.parsed.kind))
-        await resolveService(state, discovery);
-}
+        yield* resolveServiceEffect(state, discovery);
+}, (effect) => observeExecution("generator", "add.resolve.resolveServiceForKind", scaffoldErrors(effect)));
+/**
+ * Resolves the selected service to its normalized domain identity.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @returns The requested/new service domain, or undefined when no service was selected.
+ */
 export function selectedDomain(state, discovery) {
     const parsed = state.parsed;
     if (parsed.createService)
@@ -54,9 +82,21 @@ export function selectedDomain(state, discovery) {
     return (discovery.services.find((service) => service.capability === "generic" &&
         [service.domain, normalizeArtifactName(service.binding).fileStem].includes(normalized))?.domain ?? normalized);
 }
+/**
+ * Selects exported artifacts of one kind within a domain.
+ * @param discovery - Declaration-only project facts.
+ * @param domain - Normalized owning domain, or undefined for root artifacts.
+ * @param kind - Artifact kind to select.
+ * @returns Matching source-discovered artifacts in discovery order.
+ */
 export function artifacts(discovery, domain, kind) {
     return discovery.artifacts.filter((artifact) => artifact.domain === domain && artifact.kind === kind && artifact.exported);
 }
+/**
+ * Builds prompt choices from exported artifact identities.
+ * @param values - Matching discovered artifacts.
+ * @returns Choice values using descriptor IDs when available, with source-path hints.
+ */
 export function artifactOptions(values) {
     return values.map((artifact) => ({
         value: artifact.id ?? artifact.binding,
@@ -64,7 +104,31 @@ export function artifactOptions(values) {
         hint: artifact.path,
     }));
 }
+/**
+ * Selects provider profiles for one capability.
+ * @param discovery - Declaration-only project facts.
+ * @param capability - Requested provider capability.
+ * @returns Profiles of the requested capability in discovery order.
+ */
 export function profiles(discovery, capability) {
     return discovery.profiles.filter((profile) => profile.capability === capability);
 }
+/**
+ * Preserves the existing resolveService Promise API.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function resolveService(state, discovery) {
+    return runGeneratorPromise(resolveServiceEffect(state, discovery).pipe(Effect.provide(generatorPromptLayer(state.prompt ?? createClackPromptDriver()))));
+}
+/**
+ * Preserves the existing resolveServiceForKind Promise API.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function resolveServiceForKind(state, discovery) {
+    return runGeneratorPromise(resolveServiceForKindEffect(state, discovery).pipe(Effect.provide(generatorPromptLayer(state.prompt ?? createClackPromptDriver()))));
+}
 //# sourceMappingURL=add-resolution-discovery.js.map

package/dist/add-resolution-discovery.js.map

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

package/dist/add-resolution-prompt.d.ts

@@ -0,0 +1,46 @@
+import { Effect, Ref } from "effect";
+import { GeneratorPrompt } from "./generator-prompt.js";
+import type { PromptOption } from "./prompt-driver.types.js";
+import type { AddResolutionSnapshot } from "./add-resolution-state.types.js";
+/**
+ * Builds finite prompt capabilities against the private request Ref.
+ * @param state - The invocation owner's private authoritative resolution Ref.
+ * @param interactive - Whether omitted choices may request native input.
+ * @returns Typed prompt Effects; headless calls resolve without asking questions.
+ */
+export declare function addResolutionPrompt(state: Ref.Ref<AddResolutionSnapshot>, interactive: boolean): {
+    /**
+     * Asks text through explicit prompt authority only for an interactive request.
+     * @param message - Existing user-facing diagnostic.
+     * @param initialValue - Initial driver answer used when the question first appears.
+     * @param artifact - Whether entered text must pass artifact-name validation.
+     * @returns Entered text, or undefined when the request is headless; invalid answers fail.
+     */
+    textEffect: (message: string, initialValue?: string | undefined, artifact?: any) => Effect.Effect<string | undefined, import("./generator-errors.js").GeneratorPromptError, GeneratorPrompt>;
+    /**
+     * Asks a finite choice through explicit prompt authority.
+     * @typeParam Value - Union of declared prompt option values.
+     * @param message - Question displayed by the prompt driver.
+     * @param options - Finite choices offered to the user.
+     * @param initialValue - Declared choice initially selected by the driver.
+     * @returns An observed prompt Effect returning a declared value, or undefined when headless.
+     */
+    selectEffect: <Value extends string>(message: string, options: readonly PromptOption<Value>[], initialValue?: Value | undefined) => Effect.Effect<Value | undefined, import("./generator-errors.js").GeneratorPromptError, GeneratorPrompt>;
+    /**
+     * Asks multiple finite choices through explicit prompt authority.
+     * @typeParam Value - Union of declared prompt option values.
+     * @param message - Question displayed by the prompt driver.
+     * @param options - Finite choices offered to the user.
+     * @param required - Whether the selection must contain at least one value.
+     * @returns An observed prompt Effect returning selected declared values, or undefined when headless.
+     */
+    multiselectEffect: <Value extends string>(message: string, options: readonly PromptOption<Value>[], required?: boolean | undefined) => Effect.Effect<readonly Value[] | undefined, import("./generator-errors.js").GeneratorPromptError, GeneratorPrompt>;
+    /**
+     * Asks consent through explicit prompt authority.
+     * @param message - Existing user-facing diagnostic.
+     * @param initialValue - Initial driver answer used when the question first appears.
+     * @returns The consent answer, or undefined when the request is headless.
+     */
+    confirmEffect: (message: string, initialValue?: any) => Effect.Effect<boolean | undefined, import("./generator-errors.js").GeneratorPromptError, GeneratorPrompt>;
+};
+//# sourceMappingURL=add-resolution-prompt.d.ts.map

package/dist/add-resolution-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-resolution-prompt.d.ts","sourceRoot":"","sources":["../src/add-resolution-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAIrC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,WAAW,EAAE,OAAO;IAE3F;;;;;;OAMG;;IAwBH;;;;;;;OAOG;mBAEA,KAAK,SAAS,MAAM;IAiBvB;;;;;;;OAOG;wBAEA,KAAK,SAAS,MAAM;IAavB;;;;;OAKG;;EAWN"}

package/dist/add-resolution-prompt.js

@@ -0,0 +1,88 @@
+import { Effect, Ref } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { normalizeArtifactName } from "./add-name.js";
+import { GeneratorPrompt } from "./generator-prompt.js";
+/**
+ * Builds finite prompt capabilities against the private request Ref.
+ * @param state - The invocation owner's private authoritative resolution Ref.
+ * @param interactive - Whether omitted choices may request native input.
+ * @returns Typed prompt Effects; headless calls resolve without asking questions.
+ */
+export function addResolutionPrompt(state, interactive) {
+    return {
+        /**
+         * Asks text through explicit prompt authority only for an interactive request.
+         * @param message - Existing user-facing diagnostic.
+         * @param initialValue - Initial driver answer used when the question first appears.
+         * @param artifact - Whether entered text must pass artifact-name validation.
+         * @returns Entered text, or undefined when the request is headless; invalid answers fail.
+         */
+        textEffect: Effect.fn("AddResolution.text")((message, initialValue, artifact = false) => Effect.gen(function* () {
+            if (!interactive)
+                return undefined;
+            yield* Ref.update(state, (state) => ({ ...state, prompted: true }));
+            return yield* (yield* GeneratorPrompt).text({
+                message,
+                ...(initialValue === undefined ? {} : { initialValue }),
+                validate: (value) => {
+                    if (!value?.trim())
+                        return "A value is required.";
+                    if (!artifact)
+                        return undefined;
+                    try {
+                        normalizeArtifactName(value);
+                        return undefined;
+                    }
+                    catch (error) {
+                        return error instanceof Error ? error.message : String(error);
+                    }
+                },
+            });
+        }), (effect) => observeExecution("generator", "add.resolve.text", effect)),
+        /**
+         * Asks a finite choice through explicit prompt authority.
+         * @typeParam Value - Union of declared prompt option values.
+         * @param message - Question displayed by the prompt driver.
+         * @param options - Finite choices offered to the user.
+         * @param initialValue - Declared choice initially selected by the driver.
+         * @returns An observed prompt Effect returning a declared value, or undefined when headless.
+         */
+        selectEffect: Effect.fn("AddResolution.select")((message, options, initialValue) => Effect.gen(function* () {
+            if (!interactive)
+                return undefined;
+            yield* Ref.update(state, (state) => ({ ...state, prompted: true }));
+            return yield* (yield* GeneratorPrompt).select({
+                message,
+                options,
+                ...(initialValue === undefined ? {} : { initialValue }),
+            });
+        }), (effect) => observeExecution("generator", "add.resolve.select", effect)),
+        /**
+         * Asks multiple finite choices through explicit prompt authority.
+         * @typeParam Value - Union of declared prompt option values.
+         * @param message - Question displayed by the prompt driver.
+         * @param options - Finite choices offered to the user.
+         * @param required - Whether the selection must contain at least one value.
+         * @returns An observed prompt Effect returning selected declared values, or undefined when headless.
+         */
+        multiselectEffect: Effect.fn("AddResolution.multiselect")((message, options, required = false) => Effect.gen(function* () {
+            if (!interactive)
+                return undefined;
+            yield* Ref.update(state, (state) => ({ ...state, prompted: true }));
+            return yield* (yield* GeneratorPrompt).multiselect({ message, options, required });
+        }), (effect) => observeExecution("generator", "add.resolve.multiselect", effect)),
+        /**
+         * Asks consent through explicit prompt authority.
+         * @param message - Existing user-facing diagnostic.
+         * @param initialValue - Initial driver answer used when the question first appears.
+         * @returns The consent answer, or undefined when the request is headless.
+         */
+        confirmEffect: Effect.fn("AddResolution.confirm")((message, initialValue = true) => Effect.gen(function* () {
+            if (!interactive)
+                return undefined;
+            yield* Ref.update(state, (state) => ({ ...state, prompted: true }));
+            return yield* (yield* GeneratorPrompt).confirm({ message, initialValue });
+        }), (effect) => observeExecution("generator", "add.resolve.confirm", effect)),
+    };
+}
+//# sourceMappingURL=add-resolution-prompt.js.map

package/dist/add-resolution-prompt.js.map

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