create-relkit 0.6.0 → 0.7.1

package/dist/project-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-discovery.d.ts","sourceRoot":"","sources":["../src/project-discovery.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAItC,kFAAkF;AAClF,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqGpF"}
+{"version":3,"file":"project-discovery.d.ts","sourceRoot":"","sources":["../src/project-discovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIhE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;;AAErE,4FAA4F;AAC5F,qBAAa,0BAA2B,SAAQ,+BAGX;CAAG;AAExC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,qEAuChC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,+LAKjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAI9E"}

package/dist/project-discovery.js

@@ -1,152 +1,56 @@
-import { readFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
-import { prefilterSources } from "@relkit/compiler";
-import * as ts from "typescript";
+import { Context, Effect, Layer } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
 import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
-import { readAppDiscovery } from "./project-discovery-app.js";
-import { discoverDatabaseDetails } from "./project-discovery-database.js";
-import { readFactoryObject, readFactoryStringProperty, staticPropertyName } from "./source-edit.js";
-/** Discovers canonical RELKIT source facts without importing application code. */
-export async function discoverProject(projectRoot) {
-    const root = resolve(projectRoot);
-    const packagePath = join(root, "package.json");
-    const appPath = join(root, "relkit.config.ts");
-    let appSource;
-    try {
-        await readFile(packagePath, "utf8");
-        appSource = await readFile(appPath, "utf8");
-    }
-    catch {
-        throw new AddScaffoldError(ADD_FAILURE_CODES.invalidProject, `${root} is not a RELKIT project (package.json and relkit.config.ts are required).`);
-    }
-    const paths = await Array.fromAsync(new Bun.Glob("src/**/*.ts").scan({ cwd: root }));
-    const modules = await Promise.all(paths
-        .sort()
-        .map(async (path) => ({ fileName: path, text: await readFile(join(root, path), "utf8") })));
-    const candidates = prefilterSources(modules, { projectRoot: root }).candidates;
-    const sourceByPath = new Map(modules.map((module) => [module.fileName, module.text]));
-    const services = [];
-    const artifacts = [];
-    for (const candidate of candidates) {
-        const domain = sourceDomain(candidate.fileName);
-        for (const factory of candidate.facts.factoryBindings) {
-            const binding = factory.binding ?? fileBinding(candidate.fileName);
-            const exportedEntry = [...candidate.facts.exports.entries()].find(([, entry]) => entry.binding === factory.binding || entry.factory === factory);
-            artifacts.push({
-                kind: factory.kind,
-                path: candidate.fileName,
-                ...(domain === undefined ? {} : { domain }),
-                binding,
-                ...optional("id", factory.id === "explicit"
-                    ? readFactoryStringProperty(sourceByPath.get(candidate.fileName), candidate.fileName, factory.factory, "id", factory.factory === "definePrompt" || factory.factory === "defineConstants" ? 1 : 0)
-                    : undefined),
-                factory: factory.factory,
-                exported: exportedEntry !== undefined,
-                ...(exportedEntry === undefined
-                    ? {}
-                    : {
-                        exportKind: exportedEntry[0] === "default" ? "default" : "named",
-                    }),
-                options: factory.options,
-            });
-            if (factory.kind !== "service" || domain === undefined)
-                continue;
-            const database = factory.factory === "defineDrizzleService"
-                ? discoverDatabaseDetails(modules, candidate.fileName, sourceByPath.get(candidate.fileName))
-                : undefined;
-            services.push({
-                domain,
-                path: candidate.fileName,
-                binding,
-                capability: factory.factory === "defineDrizzleService"
-                    ? "database"
-                    : factory.factory === "defineBetterAuthService"
-                        ? "auth"
-                        : "generic",
-                ...(database ?? {}),
-                members: serviceMembers(candidate.facts.serviceMembers.filter((member) => member.service === factory.binding), sourceByPath.get(candidate.fileName), candidate.fileName, factory.factory),
-            });
-        }
-    }
-    const app = readAppDiscovery(appSource, appPath, root);
-    return Object.freeze({
-        projectRoot: root,
-        packagePath,
-        appPath,
-        appFactory: app.factory,
-        ...optional("envPath", app.envPath),
-        services: Object.freeze(uniqueServices(services)),
-        artifacts: Object.freeze(artifacts.sort(byPath)),
-        profiles: Object.freeze(app.profiles),
-        awsPulumiDeployment: importsPackage(appSource, appPath, "@relkit/aws") &&
-            importsPackage(appSource, appPath, "@relkit/pulumi"),
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { domainError, domainTry } from "./generator-errors.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
+import { discoveryFacts } from "./project-discovery-facts.js";
+/** Declaration-only project discovery authority; never imports user application modules. */
+export class ProjectDiscoveryServiceTag extends Context.Service()("create-relkit/ProjectDiscovery") {
+}
+/**
+ * Discovery implementation with bounded independent reads and deterministic source order.
+ * @returns A ProjectDiscovery Layer requiring only GeneratorFileSystem authority.
+ */
+export const projectDiscoveryLive = Layer.effect(ProjectDiscoveryServiceTag, Effect.gen(function* () {
+    const fs = yield* GeneratorFileSystem;
+    return ProjectDiscoveryServiceTag.of({
+        discover: Effect.fn("ProjectDiscovery.discover")((projectRoot) => observeExecution("generator", "discovery.discover", Effect.gen(function* () {
+            const root = resolve(projectRoot);
+            const appSource = yield* Effect.gen(function* () {
+                yield* fs.readText(join(root, "package.json"));
+                return yield* fs.readText(join(root, "relkit.config.ts"));
+            }).pipe(Effect.mapError(() => domainError(new AddScaffoldError(ADD_FAILURE_CODES.invalidProject, `${root} is not a RELKIT project (package.json and relkit.config.ts are required).`))));
+            const paths = yield* fs.glob(root, "src/**/*.ts");
+            const modules = yield* Effect.forEach(paths, (path) => fs
+                .readText(join(root, path))
+                .pipe(Effect.map((text) => ({ fileName: path, text }))), { concurrency: 4 });
+            return yield* domainTry(() => discoveryFacts(root, appSource, modules));
+        }))),
     });
-}
-function serviceMembers(facts, source, path, factory) {
-    if (facts.length > 0) {
-        return facts.map((member) => ({
-            name: member.member,
-            ...optional("targetBinding", member.targetBinding),
-        }));
-    }
-    const root = readFactoryObject(source, path, [factory]);
-    return ["functions", "events", "tasks", "jobs"].flatMap((category) => {
-        const item = objectProperty(root, category);
-        if (!item || !ts.isPropertyAssignment(item))
-            return [];
-        const value = unwrap(item.initializer);
-        if (!value || !ts.isObjectLiteralExpression(value))
-            return [];
-        return value.properties.flatMap((member) => {
-            const name = staticPropertyName(member.name);
-            if (name === undefined)
-                return [];
-            const targetBinding = ts.isShorthandPropertyAssignment(member)
-                ? member.name.text
-                : ts.isPropertyAssignment(member) && ts.isIdentifier(member.initializer)
-                    ? member.initializer.text
-                    : undefined;
-            return [{ name, ...optional("targetBinding", targetBinding) }];
-        });
-    });
-}
-function objectProperty(object, name) {
-    return object.properties.find((item) => staticPropertyName(item.name) === name);
-}
-function unwrap(value) {
-    return value &&
-        (ts.isAsExpression(value) ||
-            ts.isSatisfiesExpression(value) ||
-            ts.isParenthesizedExpression(value))
-        ? unwrap(value.expression)
-        : value;
-}
-function sourceDomain(path) {
-    const [src, domain] = path.replaceAll("\\", "/").split("/");
-    return src === "src" && domain && domain !== "routes" && domain !== "platform"
-        ? domain
-        : undefined;
-}
-function importsPackage(source, path, packageName) {
-    const file = ts.createSourceFile(path, source, ts.ScriptTarget.Latest, false, ts.ScriptKind.TS);
-    return file.statements.some((statement) => ts.isImportDeclaration(statement) &&
-        ts.isStringLiteral(statement.moduleSpecifier) &&
-        statement.moduleSpecifier.text === packageName);
-}
-function fileBinding(path) {
-    return path
-        .split("/")
-        .at(-1)
-        .split(".")[0]
-        .replace(/-([a-z0-9])/g, (_, value) => value.toUpperCase());
-}
-function uniqueServices(values) {
-    return [...new Map(values.map((value) => [value.path, value])).values()].sort(byPath);
-}
-function byPath(left, right) {
-    return left.path.localeCompare(right.path);
-}
-function optional(name, value) {
-    return value === undefined ? {} : { [name]: value };
+}));
+/**
+ * Discovers canonical RELKIT source facts using caller-provided filesystem authority.
+ * @param projectRoot - Project directory.
+ * @returns Lazy declaration-only discovery with its service visible in the type.
+ * @example
+ * ```ts
+ * import { Effect } from "effect";
+ * import { discoverProjectEffect, projectDiscoveryLive } from "create-relkit";
+ * const inspect = discoverProjectEffect("./my-app").pipe(Effect.provide(projectDiscoveryLive));
+ * // Supply GeneratorFileSystem at the application or test composition boundary.
+ * ```
+ */
+export const discoverProjectEffect = Effect.fn("ProjectDiscovery.inspect")(function* (projectRoot) {
+    return yield* (yield* ProjectDiscoveryServiceTag).discover(projectRoot);
+}, (effect) => observeExecution("generator", "ProjectDiscovery.inspect", effect));
+/**
+ * Preserves the existing Promise discovery API and original rejection constructors.
+ * @param projectRoot - Project directory.
+ * @returns Canonical services, artifacts and profiles.
+ */
+export function discoverProject(projectRoot) {
+    return runGeneratorPromise(discoverProjectEffect(projectRoot).pipe(Effect.provide(projectDiscoveryLive)));
 }
 //# sourceMappingURL=project-discovery.js.map

package/dist/project-discovery.js.map

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

package/dist/project-discovery.service.types.d.ts

@@ -0,0 +1,13 @@
+import type { Effect } from "effect";
+import type { GeneratorDomainError, GeneratorIoError } from "./generator-errors.js";
+import type { ProjectDiscovery } from "./project-discovery-types.js";
+/** Declaration-only discovery service consumed by planning and interactive add resolution. */
+export interface ProjectDiscoveryService {
+    /**
+     * Inspects project source declarations without executing user modules.
+     * @param projectRoot - Absolute project root.
+     * @returns An Effect returning deterministic app, provider, database and artifact facts.
+     */
+    readonly discover: (projectRoot: string) => Effect.Effect<ProjectDiscovery, GeneratorDomainError | GeneratorIoError>;
+}
+//# sourceMappingURL=project-discovery.service.types.d.ts.map

package/dist/project-discovery.service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-discovery.service.types.d.ts","sourceRoot":"","sources":["../src/project-discovery.service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,8FAA8F;AAC9F,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,CACjB,WAAW,EAAE,MAAM,KAChB,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,oBAAoB,GAAG,gBAAgB,CAAC,CAAC;CAC/E"}

package/dist/project-discovery.service.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=project-discovery.service.types.js.map

package/dist/project-discovery.service.types.js.map

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

package/dist/project-manifest.schemas.d.ts

@@ -0,0 +1,22 @@
+import { Schema } from "effect";
+/** JSON object boundary, retaining unrelated package and workspace fields. */
+export declare const JsonObject: Schema.$Record<Schema.String, Schema.Unknown>;
+/** Owned manifest fields; unrelated metadata keeps its authored order and shape. */
+export declare const ScaffoldManifestSchema: Schema.StructWithRest<Schema.Struct<{
+    readonly dependencies: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+    readonly devDependencies: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+    readonly scripts: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+/** Validated string-valued package fields owned by scaffold planning. */
+export declare const ProjectManifest: Schema.StructWithRest<Schema.Struct<{
+    readonly dependencies: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+    readonly devDependencies: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+    readonly scripts: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+    readonly patchedDependencies: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+/** Required starter fields used by deployment customization. */
+export declare const TemplateManifest: Schema.StructWithRest<Schema.Struct<{
+    readonly dependencies: Schema.$Record<Schema.String, Schema.String>;
+    readonly scripts: Schema.$Record<Schema.String, Schema.String>;
+}>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
+//# sourceMappingURL=project-manifest.schemas.d.ts.map

package/dist/project-manifest.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-manifest.schemas.d.ts","sourceRoot":"","sources":["../src/project-manifest.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,8EAA8E;AAC9E,eAAO,MAAM,UAAU,+CAA+C,CAAC;AAEvE,oFAAoF;AACpF,eAAO,MAAM,sBAAsB;;;;6DAOlC,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,eAAe;;;;;6DAQ3B,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,gBAAgB;;;6DAM5B,CAAC"}

package/dist/project-manifest.schemas.js

@@ -0,0 +1,22 @@
+import { Schema } from "effect";
+/** JSON object boundary, retaining unrelated package and workspace fields. */
+export const JsonObject = Schema.Record(Schema.String, Schema.Unknown);
+/** Owned manifest fields; unrelated metadata keeps its authored order and shape. */
+export const ScaffoldManifestSchema = Schema.StructWithRest(Schema.Struct({
+    dependencies: Schema.optionalKey(Schema.Record(Schema.String, Schema.String)),
+    devDependencies: Schema.optionalKey(Schema.Record(Schema.String, Schema.String)),
+    scripts: Schema.optionalKey(Schema.Record(Schema.String, Schema.String)),
+}), [JsonObject]);
+/** Validated string-valued package fields owned by scaffold planning. */
+export const ProjectManifest = Schema.StructWithRest(Schema.Struct({
+    dependencies: Schema.optionalKey(Schema.Record(Schema.String, Schema.String)),
+    devDependencies: Schema.optionalKey(Schema.Record(Schema.String, Schema.String)),
+    scripts: Schema.optionalKey(Schema.Record(Schema.String, Schema.String)),
+    patchedDependencies: Schema.optionalKey(Schema.Record(Schema.String, Schema.String)),
+}), [JsonObject]);
+/** Required starter fields used by deployment customization. */
+export const TemplateManifest = Schema.StructWithRest(Schema.Struct({
+    dependencies: Schema.Record(Schema.String, Schema.String),
+    scripts: Schema.Record(Schema.String, Schema.String),
+}), [JsonObject]);
+//# sourceMappingURL=project-manifest.schemas.js.map

package/dist/project-manifest.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-manifest.schemas.js","sourceRoot":"","sources":["../src/project-manifest.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AAEvE,oFAAoF;AACpF,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,cAAc,CACzD,MAAM,CAAC,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7E,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAChF,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;CACzE,CAAC,EACF,CAAC,UAAU,CAAC,CACb,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,cAAc,CAClD,MAAM,CAAC,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7E,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAChF,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACxE,mBAAmB,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;CACrF,CAAC,EACF,CAAC,UAAU,CAAC,CACb,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,cAAc,CACnD,MAAM,CAAC,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;CACrD,CAAC,EACF,CAAC,UAAU,CAAC,CACb,CAAC"}

package/dist/prompt-driver.d.ts

@@ -1,32 +1,9 @@
-export interface PromptOption<Value extends string = string> {
-    readonly value: Value;
-    readonly label: string;
-    readonly hint?: string;
-}
-export interface TextPromptOptions {
-    readonly message: string;
-    readonly placeholder?: string;
-    readonly initialValue?: string;
-    readonly validate?: (value: string | undefined) => string | Error | undefined;
-}
-export interface ChoicePromptOptions<Value extends string> {
-    readonly message: string;
-    readonly options: readonly PromptOption<Value>[];
-    readonly initialValue?: Value;
-}
-export interface PromptDriver {
-    readonly text: (options: TextPromptOptions) => Promise<string>;
-    readonly select: <Value extends string>(options: ChoicePromptOptions<Value>) => Promise<Value>;
-    readonly multiselect: <Value extends string>(options: ChoicePromptOptions<Value> & {
-        readonly required?: boolean;
-    }) => Promise<readonly Value[]>;
-    readonly confirm: (options: {
-        readonly message: string;
-        readonly initialValue?: boolean;
-    }) => Promise<boolean>;
-    readonly note: (message: string, title?: string) => void;
-    readonly intro: (title: string) => void;
-    readonly outro: (message: string) => void;
-}
+import type { PromptDriver } from "./prompt-driver.types.js";
+export type { ChoicePromptOptions, PromptDriver, PromptOption, TextPromptOptions, } from "./prompt-driver.types.js";
+/**
+ * Creates the public Clack adapter, forwarding fiber-owned cancellation to native prompts.
+ * @param cancellationCode - Existing create/add cancellation code.
+ * @returns The unchanged public prompt driver with optional cancellation forwarding.
+ */
 export declare function createClackPromptDriver(cancellationCode?: string): PromptDriver;
 //# sourceMappingURL=prompt-driver.d.ts.map

package/dist/prompt-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-driver.d.ts","sourceRoot":"","sources":["../src/prompt-driver.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACzD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;CAC/E;AAED,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,MAAM;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,MAAM,EAAE,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/F,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,SAAS,MAAM,EACzC,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAClE,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;KACjC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,wBAAgB,uBAAuB,CAAC,gBAAgB,SAAyB,GAAG,YAAY,CA8C/F"}
+{"version":3,"file":"prompt-driver.d.ts","sourceRoot":"","sources":["../src/prompt-driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuB,YAAY,EAAgB,MAAM,0BAA0B,CAAC;AAChG,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,SAAyB,GAAG,YAAY,CAuD/F"}

package/dist/prompt-driver.js

@@ -1,31 +1,45 @@
 import * as prompts from "@clack/prompts";
+/**
+ * Creates the public Clack adapter, forwarding fiber-owned cancellation to native prompts.
+ * @param cancellationCode - Existing create/add cancellation code.
+ * @returns The unchanged public prompt driver with optional cancellation forwarding.
+ */
 export function createClackPromptDriver(cancellationCode = "RELKIT_ADD_CANCELLED") {
-    const select = async (options) => answer(await prompts.select({
+    const select = async (options, signal) => answer(await prompts.select({
         message: options.message,
+        ...(signal === undefined ? {} : { signal }),
         options: options.options.map(promptOption),
         ...(options.initialValue === undefined ? {} : { initialValue: options.initialValue }),
     }), cancellationCode);
-    const multiselect = async (options) => answer(await prompts.multiselect({
+    const multiselect = async (options, signal) => answer(await prompts.multiselect({
         message: options.message,
+        ...(signal === undefined ? {} : { signal }),
         options: options.options.map(promptOption),
         ...(options.initialValue === undefined ? {} : { initialValue: options.initialValue }),
         ...(options.required === undefined ? {} : { required: options.required }),
     }), cancellationCode);
     return {
-        text: async (options) => answer(await prompts.text({
+        text: async (options, signal) => answer(await prompts.text({
             message: options.message,
+            ...(signal === undefined ? {} : { signal }),
             ...(options.placeholder === undefined ? {} : { placeholder: options.placeholder }),
             ...(options.initialValue === undefined ? {} : { initialValue: options.initialValue }),
             ...(options.validate === undefined ? {} : { validate: options.validate }),
         }), cancellationCode),
         select,
         multiselect,
-        confirm: async (options) => answer(await prompts.confirm(options), cancellationCode),
+        confirm: async (options, signal) => answer(await prompts.confirm({ ...options, ...(signal === undefined ? {} : { signal }) }), cancellationCode),
         note: (message, title) => prompts.note(message, title),
         intro: (title) => prompts.intro(title),
         outro: (message) => prompts.outro(message),
     };
 }
+/**
+ * Projects a declared choice into Clack's native option shape.
+ * @typeParam Value - Literal choice value type.
+ * @param option - Public declared choice.
+ * @returns The choice's value, label and optional hint.
+ */
 function promptOption(option) {
     return {
         value: option.value,
@@ -33,6 +47,13 @@ function promptOption(option) {
         ...(option.hint === undefined ? {} : { hint: option.hint }),
     };
 }
+/**
+ * Rejects Clack's cancellation sentinel while retaining ordinary answers.
+ * @typeParam Value - Native non-cancelled answer type.
+ * @param value - Native answer or Clack cancellation sentinel.
+ * @param code - Public cancellation code selected by the adapter.
+ * @returns The native answer; cancellation throws the configured public code with exit status 130.
+ */
 function answer(value, code) {
     if (!prompts.isCancel(value))
         return value;

package/dist/prompt-driver.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-driver.js","sourceRoot":"","sources":["../src/prompt-driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompt-driver.js","sourceRoot":"","sources":["../src/prompt-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAS1C;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,gBAAgB,GAAG,sBAAsB;IAC/E,MAAM,MAAM,GAAG,KAAK,EAClB,OAAmC,EACnC,MAAoB,EACJ,EAAE,CAClB,MAAM,CACJ,MAAM,OAAO,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3C,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAE1B;QACf,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;KACtF,CAAC,EACF,gBAAgB,CACjB,CAAC;IACJ,MAAM,WAAW,GAAG,KAAK,EACvB,OAAqE,EACrE,MAAoB,EACO,EAAE,CAC7B,MAAM,CACJ,MAAM,OAAO,CAAC,WAAW,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3C,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAE1B;QACf,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;QACrF,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;KAC1E,CAAC,EACF,gBAAgB,CACjB,CAAC;IACJ,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAC9B,MAAM,CACJ,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;YAC3C,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;YAClF,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;YACrF,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;SAC1E,CAAC,EACF,gBAAgB,CACjB;QACH,MAAM;QACN,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CACjC,MAAM,CACJ,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAClF,gBAAgB,CACjB;QACH,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;QACtD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QACtC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAuB,MAA2B;IACrE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,MAAM,CAAQ,KAAqB,EAAE,IAAY;IACxD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7B,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;AACxF,CAAC"}

package/dist/prompt-driver.types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * One declared prompt choice with a label and optional explanatory hint.
+ * @typeParam Value - Union of declared choice values.
+ */
+export interface PromptOption<Value extends string = string> {
+    readonly value: Value;
+    readonly label: string;
+    readonly hint?: string;
+}
+/**
+ * Text question with optional initial input and native validation callback.
+ */
+export interface TextPromptOptions {
+    readonly message: string;
+    readonly placeholder?: string;
+    readonly initialValue?: string;
+    /**
+     * Returns a user-facing validation message for unacceptable native text input.
+     * @param value - Current native text input, possibly undefined.
+     * @returns A rejection message/Error, or undefined when the text is acceptable.
+     */
+    readonly validate?: (value: string | undefined) => string | Error | undefined;
+}
+/**
+ * Question and finite choices accepted by a prompt adapter.
+ * @typeParam Value - Union of declared choice values.
+ */
+export interface ChoicePromptOptions<Value extends string> {
+    readonly message: string;
+    readonly options: readonly PromptOption<Value>[];
+    readonly initialValue?: Value;
+}
+/**
+ * Clack-compatible native questions and progress output, with optional caller cancellation.
+ */
+export interface PromptDriver {
+    /**
+     * Asks for text through the explicit, cancellation-aware native driver.
+     * @param options - Explicit options retaining existing defaults.
+     * @param signal - Optional caller cancellation signal.
+     * @returns Decoded text; prompt interruption propagates to the native driver.
+     */
+    readonly text: (options: TextPromptOptions, signal?: AbortSignal) => Promise<string>;
+    /**
+     * Asks the native driver for one declared choice.
+     * @typeParam Value - Union of declared native choice values.
+     * @param options - Question, declared choices and optional initial selection.
+     * @param signal - Optional caller cancellation signal.
+     * @returns A Promise for the native choice; cancellation rejects with the configured public code.
+     */
+    readonly select: <Value extends string>(options: ChoicePromptOptions<Value>, signal?: AbortSignal) => Promise<Value>;
+    /**
+     * Asks the native driver for declared choices in selection order.
+     * @typeParam Value - Union of declared native choice values.
+     * @param options - Question, declared choices and optional required-selection policy.
+     * @param signal - Optional caller cancellation signal.
+     * @returns A Promise for selected native choices; cancellation rejects with the configured public code.
+     */
+    readonly multiselect: <Value extends string>(options: ChoicePromptOptions<Value> & {
+        readonly required?: boolean;
+    }, signal?: AbortSignal) => Promise<readonly Value[]>;
+    /**
+     * Asks for boolean consent and decodes the native answer.
+     * @param options - Explicit options retaining existing defaults.
+     * @param signal - Optional caller cancellation signal.
+     * @returns Decoded consent; cancellation retains its original rejection.
+     */
+    readonly confirm: (options: {
+        readonly message: string;
+        readonly initialValue?: boolean;
+    }, signal?: AbortSignal) => Promise<boolean>;
+    /**
+     * Presents an existing explanatory note through the terminal adapter.
+     * @param message - Existing user-facing diagnostic.
+     * @param title - Title displayed by the native progress/prompt sink.
+     * @returns Completion after the existing contract has been applied.
+     */
+    readonly note: (message: string, title?: string) => void;
+    /**
+     * Presents the existing flow introduction through the terminal adapter.
+     * @param title - Title displayed by the native progress/prompt sink.
+     * @returns Completion after the existing contract has been applied.
+     */
+    readonly intro: (title: string) => void;
+    /**
+     * Presents the existing flow completion through the terminal adapter.
+     * @param message - Existing user-facing diagnostic.
+     * @returns Completion after the existing contract has been applied.
+     */
+    readonly outro: (message: string) => void;
+}
+//# sourceMappingURL=prompt-driver.types.d.ts.map

package/dist/prompt-driver.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-driver.types.d.ts","sourceRoot":"","sources":["../src/prompt-driver.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACzD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;CAC/E;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,MAAM;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrF;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,MAAM,EACpC,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,EACnC,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,SAAS,MAAM,EACzC,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EACrE,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,OAAO,EAAE;QACP,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;KACjC,EACD,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C"}

package/dist/prompt-driver.types.js

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

package/dist/prompt-driver.types.js.map

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