create-relkit 0.6.0 → 0.7.0

package/dist/add-resolution-state-base.d.ts

@@ -0,0 +1,112 @@
+import { Effect } from "effect";
+import { type ParsedAddArguments } from "./add-options-parser.js";
+import type { PromptDriver } from "./prompt-driver.types.js";
+/** Private Ref owner for finite argument resolution and prompt capabilities. */
+export declare class AddResolutionStateBase {
+    #private;
+    readonly cwd: string | undefined;
+    readonly interactive: boolean;
+    readonly prompt: PromptDriver | undefined;
+    /**
+     * Constructs one request owner; synchronous construction preserves its existing API.
+     * @param args - Literal flag and positional arguments.
+     * @param cwd - Working directory for the operation.
+     * @param interactive - Whether this request may ask for missing choices.
+     * @param prompt - Optional existing native prompt driver.
+     * @returns The request owner with one private Ref and its prompt capabilities.
+     */
+    constructor(args: readonly string[], cwd: string | undefined, interactive: boolean, prompt: PromptDriver | undefined);
+    /**
+     * Returns a copy of resolved arguments without exposing state mutation authority.
+     * @returns A copy of current argument tokens; authoritative Ref state remains private.
+     */
+    get args(): string[];
+    /**
+     * Reads the existing prompted flag from its request Ref.
+     * @returns Whether the existing contract matches.
+     */
+    get prompted(): boolean;
+    /**
+     * Preserves synchronous prompted updates through the authoritative Ref.
+     * @param value - Whether this request has asked for interactive input.
+     * @returns Completion after the request's prompt-consent flag is updated.
+     */
+    set prompted(value: boolean);
+    /**
+     * Parses only the current request snapshot; parsing remains a pure validation leaf.
+     * @returns A fresh parsed projection of the current request arguments.
+     */
+    get parsed(): ParsedAddArguments;
+    /**
+     * Checks whether an explicit option already owns this decision.
+     * @param name - Authored name or declaration key.
+     * @returns Whether the existing contract matches.
+     */
+    has(name: string): boolean;
+    /**
+     * Appends explicit argument tokens in one atomic state update.
+     * @param values - Ordered declarations or argument values.
+     * @returns Completion after argument tokens are appended in one atomic request-state update.
+     */
+    readonly appendEffect: (...args: any[]) => Effect.Effect<void, never, never>;
+    /**
+     * Records an omitted option without replacing an explicit choice.
+     * @param name - Authored name or declaration key.
+     * @param value - Resolved flag value to append only when the flag is absent.
+     * @returns Completion after the absent flag/value is recorded, leaving explicit values unchanged.
+     */
+    readonly optionEffect: (name: string, value: string) => Effect.Effect<void, never, never>;
+    /**
+     * Records repeated values as one request-state transition.
+     * @param name - Authored name or declaration key.
+     * @param values - Ordered declarations or argument values.
+     * @returns Completion after absent repeated flag values are recorded in order.
+     */
+    readonly repeatedEffect: (name: string, values: readonly string[]) => Effect.Effect<void, never, never>;
+    /**
+     * Records an omitted flag without replacing an explicit choice.
+     * @param name - Authored name or declaration key.
+     * @returns Completion after the absent boolean flag is recorded.
+     */
+    readonly flagEffect: (name: string) => Effect.Effect<void, never, never>;
+    /**
+     * Records a missing positional artifact identity.
+     * @param value - Artifact name or route path to append only when absent.
+     * @returns Completion after a missing artifact name/path is recorded.
+     */
+    readonly positionalEffect: (value: string) => Effect.Effect<void, never, never>;
+    /**
+     * Asks text through explicit prompt authority only for an interactive request.
+     * @param message - Existing user-facing diagnostic.
+     * @param initialValue - Initial native prompt answer or declared default.
+     * @param artifact - Whether entered text must pass artifact-name validation.
+     * @returns Entered text, or undefined when the request is headless; invalid answers fail.
+     */
+    get textEffect(): (message: string, initialValue?: string | undefined, artifact?: any) => Effect.Effect<string | undefined, import("./generator-errors.js").GeneratorPromptError, import("./generator-prompt.js").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.
+     */
+    get selectEffect(): <Value extends string>(message: string, options: readonly import("./prompt-driver.types.js").PromptOption<Value>[], initialValue?: Value | undefined) => Effect.Effect<Value | undefined, import("./generator-errors.js").GeneratorPromptError, import("./generator-prompt.js").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.
+     */
+    get multiselectEffect(): <Value extends string>(message: string, options: readonly import("./prompt-driver.types.js").PromptOption<Value>[], required?: boolean | undefined) => Effect.Effect<readonly Value[] | undefined, import("./generator-errors.js").GeneratorPromptError, import("./generator-prompt.js").GeneratorPrompt>;
+    /**
+     * Asks consent through explicit prompt authority.
+     * @param message - Existing user-facing diagnostic.
+     * @param initialValue - Initial native prompt answer or declared default.
+     * @returns The consent answer, or undefined when the request is headless.
+     */
+    get confirmEffect(): (message: string, initialValue?: any) => Effect.Effect<boolean | undefined, import("./generator-errors.js").GeneratorPromptError, import("./generator-prompt.js").GeneratorPrompt>;
+}
+//# sourceMappingURL=add-resolution-state-base.d.ts.map

package/dist/add-resolution-state-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-resolution-state-base.d.ts","sourceRoot":"","sources":["../src/add-resolution-state-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAO,MAAM,QAAQ,CAAC;AAGrC,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,gFAAgF;AAChF,qBAAa,sBAAsB;;IAc/B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO;IAC7B,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS;IAZ3C;;;;;;;OAOG;gBAED,IAAI,EAAE,SAAS,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,YAAY,GAAG,SAAS;IAM3C;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,EAAE,CAEnB;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;OAIG;IACH,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,EAE1B;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,kBAAkB,CAE/B;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,wDAMnB;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,qEAInB;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,iFAQrB;IAEF;;;;OAIG;IACH,QAAQ,CAAC,UAAU,sDAIjB;IAEF;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,uDAIvB;IACF;;;;;;OAMG;IACH,IAAI,UAAU,qNAEb;IAED;;;;;;;OAOG;IACH,IAAI,YAAY,qSAEf;IAED;;;;;;;OAOG;IACH,IAAI,iBAAiB,8SAEpB;IAED;;;;;OAKG;IACH,IAAI,aAAa,uLAEhB;CACF"}

package/dist/add-resolution-state-base.js

@@ -0,0 +1,141 @@
+import { Effect, Ref } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { parseAddArguments } from "./add-options-parser.js";
+import { runGeneratorSync } from "./generator-runtime.js";
+import { addResolutionPrompt } from "./add-resolution-prompt.js";
+/** Private Ref owner for finite argument resolution and prompt capabilities. */
+export class AddResolutionStateBase {
+    cwd;
+    interactive;
+    prompt;
+    #prompts;
+    #state;
+    /**
+     * Constructs one request owner; synchronous construction preserves its existing API.
+     * @param args - Literal flag and positional arguments.
+     * @param cwd - Working directory for the operation.
+     * @param interactive - Whether this request may ask for missing choices.
+     * @param prompt - Optional existing native prompt driver.
+     * @returns The request owner with one private Ref and its prompt capabilities.
+     */
+    constructor(args, cwd, interactive, prompt) {
+        this.cwd = cwd;
+        this.interactive = interactive;
+        this.prompt = prompt;
+        this.#state = Ref.makeUnsafe({ args: [...args], prompted: false });
+        this.#prompts = addResolutionPrompt(this.#state, interactive);
+    }
+    /**
+     * Returns a copy of resolved arguments without exposing state mutation authority.
+     * @returns A copy of current argument tokens; authoritative Ref state remains private.
+     */
+    get args() {
+        return [...Ref.getUnsafe(this.#state).args];
+    }
+    /**
+     * Reads the existing prompted flag from its request Ref.
+     * @returns Whether the existing contract matches.
+     */
+    get prompted() {
+        return Ref.getUnsafe(this.#state).prompted;
+    }
+    /**
+     * Preserves synchronous prompted updates through the authoritative Ref.
+     * @param value - Whether this request has asked for interactive input.
+     * @returns Completion after the request's prompt-consent flag is updated.
+     */
+    set prompted(value) {
+        runGeneratorSync(Ref.update(this.#state, (state) => ({ ...state, prompted: value })));
+    }
+    /**
+     * Parses only the current request snapshot; parsing remains a pure validation leaf.
+     * @returns A fresh parsed projection of the current request arguments.
+     */
+    get parsed() {
+        return parseAddArguments(this.args, this.cwd);
+    }
+    /**
+     * Checks whether an explicit option already owns this decision.
+     * @param name - Authored name or declaration key.
+     * @returns Whether the existing contract matches.
+     */
+    has(name) {
+        return this.parsed.values.has(name) || this.parsed.flags.has(name);
+    }
+    /**
+     * Appends explicit argument tokens in one atomic state update.
+     * @param values - Ordered declarations or argument values.
+     * @returns Completion after argument tokens are appended in one atomic request-state update.
+     */
+    appendEffect = Effect.fn("AddResolution.append")((...values) => observeExecution("generator", "add.resolve.append", Ref.update(this.#state, (state) => ({ ...state, args: [...state.args, ...values] }))));
+    /**
+     * Records an omitted option without replacing an explicit choice.
+     * @param name - Authored name or declaration key.
+     * @param value - Resolved flag value to append only when the flag is absent.
+     * @returns Completion after the absent flag/value is recorded, leaving explicit values unchanged.
+     */
+    optionEffect = Effect.fn("AddResolution.option")((name, value) => Effect.suspend(() => (this.has(name) ? Effect.void : this.appendEffect(`--${name}`, value))), (effect) => observeExecution("generator", "add.resolve.option", effect));
+    /**
+     * Records repeated values as one request-state transition.
+     * @param name - Authored name or declaration key.
+     * @param values - Ordered declarations or argument values.
+     * @returns Completion after absent repeated flag values are recorded in order.
+     */
+    repeatedEffect = Effect.fn("AddResolution.repeated")((name, values) => Effect.suspend(() => this.has(name)
+        ? Effect.void
+        : this.appendEffect(...values.flatMap((value) => [`--${name}`, value]))), (effect) => observeExecution("generator", "add.resolve.repeated", effect));
+    /**
+     * Records an omitted flag without replacing an explicit choice.
+     * @param name - Authored name or declaration key.
+     * @returns Completion after the absent boolean flag is recorded.
+     */
+    flagEffect = Effect.fn("AddResolution.flag")((name) => Effect.suspend(() => (this.has(name) ? Effect.void : this.appendEffect(`--${name}`))), (effect) => observeExecution("generator", "add.resolve.flag", effect));
+    /**
+     * Records a missing positional artifact identity.
+     * @param value - Artifact name or route path to append only when absent.
+     * @returns Completion after a missing artifact name/path is recorded.
+     */
+    positionalEffect = Effect.fn("AddResolution.positional")((value) => Effect.suspend(() => (this.parsed.positional ? Effect.void : this.appendEffect(value))), (effect) => observeExecution("generator", "add.resolve.positional", effect));
+    /**
+     * Asks text through explicit prompt authority only for an interactive request.
+     * @param message - Existing user-facing diagnostic.
+     * @param initialValue - Initial native prompt answer or declared default.
+     * @param artifact - Whether entered text must pass artifact-name validation.
+     * @returns Entered text, or undefined when the request is headless; invalid answers fail.
+     */
+    get textEffect() {
+        return this.#prompts.textEffect;
+    }
+    /**
+     * 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.
+     */
+    get selectEffect() {
+        return this.#prompts.selectEffect;
+    }
+    /**
+     * 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.
+     */
+    get multiselectEffect() {
+        return this.#prompts.multiselectEffect;
+    }
+    /**
+     * Asks consent through explicit prompt authority.
+     * @param message - Existing user-facing diagnostic.
+     * @param initialValue - Initial native prompt answer or declared default.
+     * @returns The consent answer, or undefined when the request is headless.
+     */
+    get confirmEffect() {
+        return this.#prompts.confirmEffect;
+    }
+}
+//# sourceMappingURL=add-resolution-state-base.js.map

package/dist/add-resolution-state-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-resolution-state-base.js","sourceRoot":"","sources":["../src/add-resolution-state-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAA2B,MAAM,yBAAyB,CAAC;AAErF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,gFAAgF;AAChF,MAAM,OAAO,sBAAsB;IActB;IACA;IACA;IAfF,QAAQ,CAAyC;IACjD,MAAM,CAAiC;IAEhD;;;;;;;OAOG;IACH,YACE,IAAuB,EACd,GAAuB,EACvB,WAAoB,EACpB,MAAgC;QAFhC,QAAG,GAAH,GAAG,CAAoB;QACvB,gBAAW,GAAX,WAAW,CAAS;QACpB,WAAM,GAAN,MAAM,CAA0B;QAEzC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,UAAU,CAAwB,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,IAAI,IAAI;QACN,OAAO,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACV,OAAO,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,IAAI,QAAQ,CAAC,KAAc;QACzB,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAED;;;OAGG;IACH,IAAI,MAAM;QACR,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,GAAG,MAAyB,EAAE,EAAE,CACzF,gBAAgB,CACd,WAAW,EACX,oBAAoB,EACpB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CACrF,CACF,CAAC;IAEF;;;;;OAKG;IACM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,sBAAsB,CAAC,CACvD,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE,CAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAC9F,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,oBAAoB,EAAE,MAAM,CAAC,CACxE,CAAC;IAEF;;;;;OAKG;IACM,cAAc,GAAG,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAC3D,CAAC,IAAY,EAAE,MAAyB,EAAE,EAAE,CAC1C,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QACZ,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAC1E,EACH,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAC1E,CAAC;IAEF;;;;OAIG;IACM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,oBAAoB,CAAC,CACnD,CAAC,IAAY,EAAE,EAAE,CACf,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EACvF,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,EAAE,MAAM,CAAC,CACtE,CAAC;IAEF;;;;OAIG;IACM,gBAAgB,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAC/D,CAAC,KAAa,EAAE,EAAE,CAChB,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EACzF,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,wBAAwB,EAAE,MAAM,CAAC,CAC5E,CAAC;IACF;;;;;;OAMG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;IAClC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;IACrC,CAAC;CACF"}

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

@@ -1,23 +1,78 @@
-import { type ParsedAddArguments } from "./add-options-parser.js";
-import type { PromptDriver, PromptOption } from "./prompt-driver.js";
-export declare class AddResolutionState {
-    readonly cwd: string | undefined;
-    readonly interactive: boolean;
-    readonly prompt: PromptDriver | undefined;
-    readonly args: string[];
-    prompted: boolean;
-    constructor(args: readonly string[], cwd: string | undefined, interactive: boolean, prompt: PromptDriver | undefined);
-    get parsed(): ParsedAddArguments;
-    has(name: string): boolean;
+import type { PromptOption } from "./prompt-driver.types.js";
+import { AddResolutionStateBase } from "./add-resolution-state-base.js";
+/** Finite request owner with existing synchronous and Promise compatibility methods. */
+export declare class AddResolutionState extends AddResolutionStateBase {
+    /**
+     * Preserves the existing synchronous option API.
+     * @param name - Authored name or declaration key.
+     * @param value - Resolved flag value to append only when the flag is absent.
+     * @returns Completion after the existing contract has been applied.
+     */
     option(name: string, value: string): void;
+    /**
+     * Preserves the existing synchronous repeated-option API.
+     * @param name - Authored name or declaration key.
+     * @param values - Ordered declarations or argument values.
+     * @returns Completion after the existing contract has been applied.
+     */
     repeated(name: string, values: readonly string[]): void;
+    /**
+     * Preserves the existing synchronous flag API.
+     * @param name - Authored name or declaration key.
+     * @returns Completion after the existing contract has been applied.
+     */
     flag(name: string): void;
+    /**
+     * Preserves the existing synchronous positional API.
+     * @param value - Artifact name or route path to append only when absent.
+     * @returns Completion after the existing contract has been applied.
+     */
     positional(value: string): void;
+    /**
+     * Preserves the text Prompt API.
+     * @param message - Existing user-facing diagnostic.
+     * @param initialValue - Initial native prompt answer or declared default.
+     * @param artifact - Whether entered text must pass artifact-name validation.
+     * @returns Decoded text; prompt interruption propagates to the native driver.
+     */
     text(message: string, initialValue?: string, artifact?: boolean): Promise<string | undefined>;
+    /**
+     * Preserves the select Prompt API.
+     * @typeParam Value - Union of declared prompt option values.
+     * @param message - User-facing diagnostic or prompt text.
+     * @param options - Declared choices offered by the prompt.
+     * @param initialValue - Initial native prompt answer or declared default.
+     * @returns One decoded declared option; invalid native answers fail.
+     */
     select<Value extends string>(message: string, options: readonly PromptOption<Value>[], initialValue?: Value): Promise<Value | undefined>;
+    /**
+     * Preserves the multiselect Prompt API.
+     * @typeParam Value - Union of declared prompt option values.
+     * @param message - User-facing diagnostic or prompt text.
+     * @param options - Declared choices offered by the prompt.
+     * @param required - Whether at least one declared answer is required.
+     * @returns Decoded declared options in driver order.
+     */
     multiselect<Value extends string>(message: string, options: readonly PromptOption<Value>[], required?: boolean): Promise<readonly Value[] | undefined>;
+    /**
+     * Preserves the consent Prompt API.
+     * @param message - Existing user-facing diagnostic.
+     * @param initialValue - Initial native prompt answer or declared default.
+     * @returns Decoded consent; cancellation retains its original rejection.
+     */
     confirm(message: string, initialValue?: boolean): Promise<boolean | undefined>;
 }
+/**
+ * Creates finite prompt choices without introducing effectful traversal.
+ * @typeParam Value - Union of literal option values.
+ * @param values - Ordered literal values offered by the prompt.
+ * @returns Prompt choices with their literal values and human-readable labels.
+ */
 export declare function choices<const Value extends string>(values: readonly Value[]): PromptOption<Value>[];
+/**
+ * Creates a human-readable label from a hyphenated identifier.
+ * @param value - Hyphenated identifier to display.
+ * @returns The identifier with spaces and an uppercase initial character.
+ */
 export declare function label(value: string): string;
 //# sourceMappingURL=add-resolution-state.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"add-resolution-state.d.ts","sourceRoot":"","sources":["../src/add-resolution-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,qBAAa,kBAAkB;IAM3B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO;IAC7B,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS;IAP3C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,UAAS;gBAGf,IAAI,EAAE,SAAS,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,YAAY,GAAG,SAAS;IAK3C,IAAI,MAAM,IAAI,kBAAkB,CAE/B;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIvD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzB,IAAI,CACR,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,UAAQ,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAmBxB,MAAM,CAAC,KAAK,SAAS,MAAM,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,EACvC,YAAY,CAAC,EAAE,KAAK,GACnB,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAUvB,WAAW,CAAC,KAAK,SAAS,MAAM,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,EACvC,QAAQ,UAAQ,GACf,OAAO,CAAC,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAMlC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;CAKlF;AAED,wBAAgB,OAAO,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,EAChD,MAAM,EAAE,SAAS,KAAK,EAAE,GACvB,YAAY,CAAC,KAAK,CAAC,EAAE,CAEvB;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C"}
+{"version":3,"file":"add-resolution-state.d.ts","sourceRoot":"","sources":["../src/add-resolution-state.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,wFAAwF;AACxF,qBAAa,kBAAmB,SAAQ,sBAAsB;IAC5D;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIvD;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQ3F;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,SAAS,MAAM,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,EACvC,YAAY,CAAC,EAAE,KAAK,GACnB,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAQ7B;;;;;;;OAOG;IACH,WAAW,CAAC,KAAK,SAAS,MAAM,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,EACvC,QAAQ,UAAQ,GACf,OAAO,CAAC,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAQxC;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;CAO5E;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,EAChD,MAAM,EAAE,SAAS,KAAK,EAAE,GACvB,YAAY,CAAC,KAAK,CAAC,EAAE,CAEvB;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C"}

package/dist/add-resolution-state.js

@@ -1,88 +1,100 @@
-import { normalizeArtifactName } from "./add-name.js";
-import { parseAddArguments } from "./add-options-parser.js";
-export class AddResolutionState {
-    cwd;
-    interactive;
-    prompt;
-    args;
-    prompted = false;
-    constructor(args, cwd, interactive, prompt) {
-        this.cwd = cwd;
-        this.interactive = interactive;
-        this.prompt = prompt;
-        this.args = [...args];
-    }
-    get parsed() {
-        return parseAddArguments(this.args, this.cwd);
-    }
-    has(name) {
-        return this.parsed.values.has(name) || this.parsed.flags.has(name);
-    }
+import { Effect } from "effect";
+import { generatorPromptLayer } from "./generator-prompt.js";
+import { createClackPromptDriver } from "./prompt-driver.js";
+import { runGeneratorPromise, runGeneratorSync } from "./generator-runtime.js";
+import { AddResolutionStateBase } from "./add-resolution-state-base.js";
+/** Finite request owner with existing synchronous and Promise compatibility methods. */
+export class AddResolutionState extends AddResolutionStateBase {
+    /**
+     * Preserves the existing synchronous option API.
+     * @param name - Authored name or declaration key.
+     * @param value - Resolved flag value to append only when the flag is absent.
+     * @returns Completion after the existing contract has been applied.
+     */
     option(name, value) {
-        if (!this.has(name))
-            this.args.push(`--${name}`, value);
+        runGeneratorSync(this.optionEffect(name, value));
     }
+    /**
+     * Preserves the existing synchronous repeated-option API.
+     * @param name - Authored name or declaration key.
+     * @param values - Ordered declarations or argument values.
+     * @returns Completion after the existing contract has been applied.
+     */
     repeated(name, values) {
-        if (!this.has(name))
-            for (const value of values)
-                this.args.push(`--${name}`, value);
+        runGeneratorSync(this.repeatedEffect(name, values));
     }
+    /**
+     * Preserves the existing synchronous flag API.
+     * @param name - Authored name or declaration key.
+     * @returns Completion after the existing contract has been applied.
+     */
     flag(name) {
-        if (!this.has(name))
-            this.args.push(`--${name}`);
+        runGeneratorSync(this.flagEffect(name));
     }
+    /**
+     * Preserves the existing synchronous positional API.
+     * @param value - Artifact name or route path to append only when absent.
+     * @returns Completion after the existing contract has been applied.
+     */
     positional(value) {
-        if (!this.parsed.positional)
-            this.args.push(value);
+        runGeneratorSync(this.positionalEffect(value));
     }
-    async text(message, initialValue, artifact = false) {
-        if (!this.interactive || !this.prompt)
-            return undefined;
-        this.prompted = true;
-        return this.prompt.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);
-                }
-            },
-        });
+    /**
+     * Preserves the text Prompt API.
+     * @param message - Existing user-facing diagnostic.
+     * @param initialValue - Initial native prompt answer or declared default.
+     * @param artifact - Whether entered text must pass artifact-name validation.
+     * @returns Decoded text; prompt interruption propagates to the native driver.
+     */
+    text(message, initialValue, artifact = false) {
+        return runGeneratorPromise(this.textEffect(message, initialValue, artifact).pipe(Effect.provide(generatorPromptLayer(this.prompt ?? createClackPromptDriver()))));
     }
-    async select(message, options, initialValue) {
-        if (!this.interactive || !this.prompt)
-            return undefined;
-        this.prompted = true;
-        return this.prompt.select({
-            message,
-            options,
-            ...(initialValue === undefined ? {} : { initialValue }),
-        });
+    /**
+     * Preserves the select Prompt API.
+     * @typeParam Value - Union of declared prompt option values.
+     * @param message - User-facing diagnostic or prompt text.
+     * @param options - Declared choices offered by the prompt.
+     * @param initialValue - Initial native prompt answer or declared default.
+     * @returns One decoded declared option; invalid native answers fail.
+     */
+    select(message, options, initialValue) {
+        return runGeneratorPromise(this.selectEffect(message, options, initialValue).pipe(Effect.provide(generatorPromptLayer(this.prompt ?? createClackPromptDriver()))));
     }
-    async multiselect(message, options, required = false) {
-        if (!this.interactive || !this.prompt)
-            return undefined;
-        this.prompted = true;
-        return this.prompt.multiselect({ message, options, required });
+    /**
+     * Preserves the multiselect Prompt API.
+     * @typeParam Value - Union of declared prompt option values.
+     * @param message - User-facing diagnostic or prompt text.
+     * @param options - Declared choices offered by the prompt.
+     * @param required - Whether at least one declared answer is required.
+     * @returns Decoded declared options in driver order.
+     */
+    multiselect(message, options, required = false) {
+        return runGeneratorPromise(this.multiselectEffect(message, options, required).pipe(Effect.provide(generatorPromptLayer(this.prompt ?? createClackPromptDriver()))));
     }
-    async confirm(message, initialValue = true) {
-        if (!this.interactive || !this.prompt)
-            return undefined;
-        this.prompted = true;
-        return this.prompt.confirm({ message, initialValue });
+    /**
+     * Preserves the consent Prompt API.
+     * @param message - Existing user-facing diagnostic.
+     * @param initialValue - Initial native prompt answer or declared default.
+     * @returns Decoded consent; cancellation retains its original rejection.
+     */
+    confirm(message, initialValue = true) {
+        return runGeneratorPromise(this.confirmEffect(message, initialValue).pipe(Effect.provide(generatorPromptLayer(this.prompt ?? createClackPromptDriver()))));
     }
 }
+/**
+ * Creates finite prompt choices without introducing effectful traversal.
+ * @typeParam Value - Union of literal option values.
+ * @param values - Ordered literal values offered by the prompt.
+ * @returns Prompt choices with their literal values and human-readable labels.
+ */
 export function choices(values) {
     return values.map((value) => ({ value, label: label(value) }));
 }
+/**
+ * Creates a human-readable label from a hyphenated identifier.
+ * @param value - Hyphenated identifier to display.
+ * @returns The identifier with spaces and an uppercase initial character.
+ */
 export function label(value) {
     return value.replaceAll("-", " ").replace(/^./, (character) => character.toUpperCase());
 }

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

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

package/dist/add-resolution-state.types.d.ts

@@ -0,0 +1,6 @@
+/** Finite request arguments and whether resolution needed interactive input. */
+export interface AddResolutionSnapshot {
+    readonly args: readonly string[];
+    readonly prompted: boolean;
+}
+//# sourceMappingURL=add-resolution-state.types.d.ts.map

package/dist/add-resolution-state.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-resolution-state.types.d.ts","sourceRoot":"","sources":["../src/add-resolution-state.types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B"}

package/dist/add-resolution-state.types.js

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

package/dist/add-resolution-state.types.js.map

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

package/dist/add-resolver-domain-execution.d.ts

@@ -0,0 +1,35 @@
+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 { ProjectDiscovery } from "./project-discovery-types.js";
+/**
+ * Resolves event function options 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 event target, delivery and provider choices are recorded.
+ */
+export declare const eventFunctionOptionsEffect: (state: AddResolutionState, discovery: ProjectDiscovery) => Effect.Effect<void, GeneratorIoError | GeneratorPromptError | GeneratorDomainError, GeneratorFileSystem | GeneratorPrompt>;
+/**
+ * Resolves task options through explicit prompt and filesystem authority.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @returns Completion after task version and execution choices are recorded.
+ */
+export declare const taskOptionsEffect: (state: AddResolutionState) => Effect.Effect<void, GeneratorIoError | GeneratorPromptError | GeneratorDomainError, GeneratorFileSystem | GeneratorPrompt>;
+/**
+ * Resolves job options 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 the target function/task and job provider are recorded.
+ */
+export declare const jobOptionsEffect: (state: AddResolutionState, discovery: ProjectDiscovery) => Effect.Effect<void, GeneratorIoError | GeneratorPromptError | GeneratorDomainError, GeneratorFileSystem | GeneratorPrompt>;
+/**
+ * Resolves provider profile through explicit prompt and filesystem authority.
+ * @param state - Invocation-owned state or a read-only planning snapshot.
+ * @param discovery - Declaration-only project facts.
+ * @param capability - Requested provider capability.
+ * @returns Completion after the requested event/job provider profile is resolved.
+ */
+export declare const providerProfileEffect: (state: AddResolutionState, discovery: ProjectDiscovery, capability: "event" | "job") => Effect.Effect<void, GeneratorIoError | GeneratorPromptError | GeneratorDomainError, GeneratorFileSystem | GeneratorPrompt>;
+//# sourceMappingURL=add-resolver-domain-execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add-resolver-domain-execution.d.ts","sourceRoot":"","sources":["../src/add-resolver-domain-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAW,MAAM,2BAA2B,CAAC;AAOxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,wLAiCtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,2JAmB7B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,wLA+B5B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,qNAwBjC,CAAC"}