create-relkit 0.6.0 → 0.7.0

package/dist/plan-builder.d.ts

@@ -1,33 +1,93 @@
-import { type AddRequest, type ScaffoldPlan } from "./add-types.js";
-import type { DiscoveredArtifact, DiscoveredProfile, ProjectDiscovery } from "./project-discovery-types.js";
+import { type ScaffoldPlan } from "./add-types.js";
+import type { DiscoveredArtifact, DiscoveredProfile } from "./project-discovery-types.js";
 import type { ScaffoldDependencyName } from "./scaffold-catalog.js";
-export declare class PlanBuilder {
-    #private;
-    readonly request: AddRequest;
-    readonly discovery: ProjectDiscovery;
-    constructor(request: AddRequest, discovery: ProjectDiscovery);
+import type { PlannedArtifactInput } from "./plan-builder.types.js";
+import { PlanBuilderEffects } from "./plan-builder-effects.js";
+/** Per-request Effect owner with synchronous and Promise compatibility edges. */
+export declare class PlanBuilder extends PlanBuilderEffects {
+    /**
+     * Reads source through the Promise compatibility edge.
+     * @param path - Path inside the current project or owned resource.
+     * @returns Planned text when present, otherwise the current project file text.
+     */
     read(path: string): Promise<string>;
+    /**
+     * Plans file creation through the Promise compatibility edge.
+     * @param path - Path inside the current project or owned resource.
+     * @param content - Complete bytes or text planned for the destination.
+     * @param mode - Optional restored or generated permission mode.
+     * @returns Completion after the existing contract has been applied.
+     */
     create(path: string, content: string, mode?: number): Promise<void>;
+    /**
+     * Plans a source update through the Promise compatibility edge.
+     * @param path - Path inside the current project or owned resource.
+     * @param transform - Pure transformation applied atomically to the latest planned source.
+     * @returns Completion after the existing contract has been applied.
+     */
     update(path: string, transform: (source: string) => string): Promise<void>;
+    /**
+     * Preserves the existing synchronous dependency API.
+     * @param name - Authored name or declaration key.
+     * @returns Completion after the existing contract has been applied.
+     */
     dependency(name: ScaffoldDependencyName): void;
-    get artifacts(): readonly DiscoveredArtifact[];
-    registerArtifact(kind: DiscoveredArtifact["kind"], value: {
-        readonly domain: string;
-        readonly path: string;
-        readonly binding: string;
-        readonly id: string;
-        readonly exportKind?: "default" | "named";
-    }): void;
-    get profiles(): readonly DiscoveredProfile[];
+    /**
+     * Preserves the existing synchronous artifact registration API.
+     * @param kind - Authoritative artifact kind.
+     * @param value - Artifact domain, source path, binding and optional identity/export form.
+     * @returns Completion after the artifact is registered in this request.
+     */
+    registerArtifact(kind: DiscoveredArtifact["kind"], value: PlannedArtifactInput): void;
+    /**
+     * Preserves the existing synchronous profile registration API.
+     * @param profile - Selected provider profile.
+     * @returns Completion after the existing contract has been applied.
+     */
     registerProfile(profile: DiscoveredProfile): void;
+    /**
+     * Preserves the existing synchronous script API.
+     * @param name - Authored name or declaration key.
+     * @param command - Shell command stored under the package script name.
+     * @returns Completion after the existing contract has been applied.
+     */
     script(name: string, command: string): void;
+    /**
+     * Preserves the existing synchronous warning API.
+     * @param code - Stable category code included in the resulting diagnostic.
+     * @param message - Existing user-facing diagnostic.
+     * @returns Completion after the existing contract has been applied.
+     */
     warning(code: string, message: string): void;
+    /**
+     * Preserves the existing synchronous next-step API.
+     * @param command - Shell command shown as a follow-up instruction.
+     * @returns Completion after the existing contract has been applied.
+     */
     nextStep(command: string): void;
+    /**
+     * Preserves the environment-example Promise API.
+     * @param name - Environment variable name.
+     * @param value - Example value used only for a new declaration.
+     * @returns Completion after the example declaration is planned.
+     */
     envExample(name: string, value?: string): Promise<void>;
+    /**
+     * Preserves the gitignore Promise API.
+     * @param pattern - Declaration-owned glob or ignore pattern.
+     * @returns Completion after the existing contract has been applied.
+     */
     gitignore(pattern: string): Promise<void>;
+    /**
+     * Preserves the immutable plan Promise API.
+     * @returns The frozen plan containing ordered operations, concrete dependencies and follow-up metadata.
+     */
     finish(): Promise<ScaffoldPlan>;
+    /**
+     * Converts a source path into its existing project-relative representation.
+     * @param absolutePath - Absolute path converted relative to the discovered project root.
+     * @returns The path relative to the discovered project root using forward slashes.
+     */
     relative(absolutePath: string): string;
-    private appendLine;
-    private updateManifest;
 }
 //# sourceMappingURL=plan-builder.d.ts.map

package/dist/plan-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-builder.d.ts","sourceRoot":"","sources":["../src/plan-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,UAAU,EAEf,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,qBAAa,WAAW;;IAUpB,QAAQ,CAAC,OAAO,EAAE,UAAU;IAC5B,QAAQ,CAAC,SAAS,EAAE,gBAAgB;gBAD3B,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,gBAAgB;IAEhC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAenE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBhF,UAAU,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI;IAI9C,IAAI,SAAS,IAAI,SAAS,kBAAkB,EAAE,CAE7C;IAED,gBAAgB,CACd,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,KAAK,EAAE;QACL,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;KAC3C,GACA,IAAI;IAcP,IAAI,QAAQ,IAAI,SAAS,iBAAiB,EAAE,CAE3C;IAED,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIjD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAyBrC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;YAIxB,UAAU;YAiBV,cAAc;CAO7B"}
+{"version":3,"file":"plan-builder.d.ts","sourceRoot":"","sources":["../src/plan-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,iFAAiF;AACjF,qBAAa,WAAY,SAAQ,kBAAkB;IACjD;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInC;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI;IAI9C;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAIrF;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIjD;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3C;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI/B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAI/B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAGvC"}

package/dist/plan-builder.js

@@ -1,139 +1,118 @@
-import { readFile } from "node:fs/promises";
-import { relative, resolve } from "node:path";
-import { ADD_FAILURE_CODES, AddScaffoldError, } from "./add-types.js";
-import { mergeScaffoldManifest } from "./plan-manifest.js";
-export class PlanBuilder {
-    request;
-    discovery;
-    #files = new Map();
-    #dependencies = new Set();
-    #scripts = new Map();
-    #warnings = new Map();
-    #nextSteps = new Set();
-    #plannedArtifacts = [];
-    #plannedProfiles = [];
-    constructor(request, discovery) {
-        this.request = request;
-        this.discovery = discovery;
-    }
-    async read(path) {
-        const planned = this.#files.get(path);
-        return planned?.content ?? readFile(resolve(this.discovery.projectRoot, path), "utf8");
-    }
-    async create(path, content, mode) {
-        if (this.#files.has(path) ||
-            (await Bun.file(resolve(this.discovery.projectRoot, path)).exists())) {
-            collision(`${path} already exists.`);
-        }
-        this.#files.set(path, {
-            path,
-            action: "create",
-            content,
-            ...(mode === undefined ? {} : { mode }),
-        });
-    }
-    async update(path, transform) {
-        const existing = this.#files.get(path);
-        let source;
-        try {
-            source =
-                existing?.content ?? (await readFile(resolve(this.discovery.projectRoot, path), "utf8"));
-        }
-        catch {
-            throw new AddScaffoldError(ADD_FAILURE_CODES.invalidProject, `${path} does not exist.`);
-        }
-        const content = transform(source);
-        if (content === source)
-            return;
-        this.#files.set(path, {
-            path,
-            action: existing?.action ?? "update",
-            content,
-            ...(existing?.mode === undefined ? {} : { mode: existing.mode }),
-        });
-    }
+import { relative } from "node:path";
+import {} from "./add-types.js";
+import { runGeneratorPromise, runGeneratorSync } from "./generator-runtime.js";
+import { PlanBuilderEffects } from "./plan-builder-effects.js";
+/** Per-request Effect owner with synchronous and Promise compatibility edges. */
+export class PlanBuilder extends PlanBuilderEffects {
+    /**
+     * Reads source through the Promise compatibility edge.
+     * @param path - Path inside the current project or owned resource.
+     * @returns Planned text when present, otherwise the current project file text.
+     */
+    read(path) {
+        return runGeneratorPromise(this.readEffect(path));
+    }
+    /**
+     * Plans file creation through the Promise compatibility edge.
+     * @param path - Path inside the current project or owned resource.
+     * @param content - Complete bytes or text planned for the destination.
+     * @param mode - Optional restored or generated permission mode.
+     * @returns Completion after the existing contract has been applied.
+     */
+    create(path, content, mode) {
+        return runGeneratorPromise(this.createEffect(path, content, mode));
+    }
+    /**
+     * Plans a source update through the Promise compatibility edge.
+     * @param path - Path inside the current project or owned resource.
+     * @param transform - Pure transformation applied atomically to the latest planned source.
+     * @returns Completion after the existing contract has been applied.
+     */
+    update(path, transform) {
+        return runGeneratorPromise(this.updateEffect(path, transform));
+    }
+    /**
+     * Preserves the existing synchronous dependency API.
+     * @param name - Authored name or declaration key.
+     * @returns Completion after the existing contract has been applied.
+     */
     dependency(name) {
-        this.#dependencies.add(name);
-    }
-    get artifacts() {
-        return [...this.discovery.artifacts, ...this.#plannedArtifacts];
-    }
+        runGeneratorSync(this.dependencyEffect(name));
+    }
+    /**
+     * Preserves the existing synchronous artifact registration API.
+     * @param kind - Authoritative artifact kind.
+     * @param value - Artifact domain, source path, binding and optional identity/export form.
+     * @returns Completion after the artifact is registered in this request.
+     */
     registerArtifact(kind, value) {
-        this.#plannedArtifacts.push({
-            kind,
-            path: value.path,
-            domain: value.domain,
-            binding: value.binding,
-            id: value.id,
-            factory: "scaffold",
-            exported: true,
-            exportKind: value.exportKind ?? "default",
-            options: [],
-        });
-    }
-    get profiles() {
-        return [...this.discovery.profiles, ...this.#plannedProfiles];
+        runGeneratorSync(this.registerArtifactEffect(kind, value));
     }
+    /**
+     * Preserves the existing synchronous profile registration API.
+     * @param profile - Selected provider profile.
+     * @returns Completion after the existing contract has been applied.
+     */
     registerProfile(profile) {
-        this.#plannedProfiles.push(profile);
-    }
+        runGeneratorSync(this.registerProfileEffect(profile));
+    }
+    /**
+     * Preserves the existing synchronous script API.
+     * @param name - Authored name or declaration key.
+     * @param command - Shell command stored under the package script name.
+     * @returns Completion after the existing contract has been applied.
+     */
     script(name, command) {
-        this.#scripts.set(name, command);
-    }
+        runGeneratorSync(this.scriptEffect(name, command));
+    }
+    /**
+     * Preserves the existing synchronous warning API.
+     * @param code - Stable category code included in the resulting diagnostic.
+     * @param message - Existing user-facing diagnostic.
+     * @returns Completion after the existing contract has been applied.
+     */
     warning(code, message) {
-        this.#warnings.set(code, Object.freeze({ code, message }));
+        runGeneratorSync(this.warningEffect(code, message));
     }
+    /**
+     * Preserves the existing synchronous next-step API.
+     * @param command - Shell command shown as a follow-up instruction.
+     * @returns Completion after the existing contract has been applied.
+     */
     nextStep(command) {
-        this.#nextSteps.add(command);
-    }
-    async envExample(name, value = "") {
-        await this.appendLine(".env.example", `${name}=${value}`, (source) => new RegExp(`^${escape(name)}=`, "m").test(source));
-    }
-    async gitignore(pattern) {
-        await this.appendLine(".gitignore", pattern, (source) => source.split(/\r?\n/).includes(pattern));
-    }
-    async finish() {
-        const dependencies = await this.updateManifest();
-        return Object.freeze({
-            request: this.request,
-            projectRoot: this.discovery.projectRoot,
-            operations: Object.freeze([...this.#files.values()].sort((a, b) => a.path.localeCompare(b.path))),
-            dependencies: Object.freeze(dependencies),
-            artifacts: Object.freeze(this.#plannedArtifacts.map(({ kind, path, id, binding }) => ({
-                kind,
-                path,
-                id: id,
-                binding,
-            }))),
-            profiles: Object.freeze(this.#plannedProfiles.map(({ capability, name }) => ({ capability, name }))),
-            warnings: Object.freeze([...this.#warnings.values()]),
-            nextSteps: Object.freeze([...this.#nextSteps]),
-        });
-    }
+        runGeneratorSync(this.nextStepEffect(command));
+    }
+    /**
+     * Preserves the environment-example Promise API.
+     * @param name - Environment variable name.
+     * @param value - Example value used only for a new declaration.
+     * @returns Completion after the example declaration is planned.
+     */
+    envExample(name, value = "") {
+        return runGeneratorPromise(this.envExampleEffect(name, value));
+    }
+    /**
+     * Preserves the gitignore Promise API.
+     * @param pattern - Declaration-owned glob or ignore pattern.
+     * @returns Completion after the existing contract has been applied.
+     */
+    gitignore(pattern) {
+        return runGeneratorPromise(this.gitignoreEffect(pattern));
+    }
+    /**
+     * Preserves the immutable plan Promise API.
+     * @returns The frozen plan containing ordered operations, concrete dependencies and follow-up metadata.
+     */
+    finish() {
+        return runGeneratorPromise(this.finishEffect());
+    }
+    /**
+     * Converts a source path into its existing project-relative representation.
+     * @param absolutePath - Absolute path converted relative to the discovered project root.
+     * @returns The path relative to the discovered project root using forward slashes.
+     */
     relative(absolutePath) {
         return relative(this.discovery.projectRoot, absolutePath).replaceAll("\\", "/");
     }
-    async appendLine(path, line, present) {
-        if (!(await Bun.file(resolve(this.discovery.projectRoot, path)).exists()) &&
-            !this.#files.has(path)) {
-            await this.create(path, `${line}\n`);
-            return;
-        }
-        await this.update(path, (source) => present(source) ? source : `${source.trimEnd()}\n${line}\n`);
-    }
-    async updateManifest() {
-        if (this.#dependencies.size === 0 && this.#scripts.size === 0)
-            return {};
-        const path = "package.json";
-        const result = mergeScaffoldManifest(await this.read(path), this.#dependencies, this.#scripts);
-        await this.update(path, () => result.content);
-        return result.added;
-    }
-}
-function collision(message) {
-    throw new AddScaffoldError(ADD_FAILURE_CODES.collision, message);
-}
-function escape(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 //# sourceMappingURL=plan-builder.js.map

package/dist/plan-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-builder.js","sourceRoot":"","sources":["../src/plan-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plan-builder.js","sourceRoot":"","sources":["../src/plan-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAqB,MAAM,gBAAgB,CAAC;AAKnD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,iFAAiF;AACjF,MAAM,OAAO,WAAY,SAAQ,kBAAkB;IACjD;;;;OAIG;IACH,IAAI,CAAC,IAAY;QACf,OAAO,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAY,EAAE,OAAe,EAAE,IAAa;QACjD,OAAO,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAY,EAAE,SAAqC;QACxD,OAAO,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,IAA4B;QACrC,gBAAgB,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,IAAgC,EAAE,KAA2B;QAC5E,gBAAgB,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,OAA0B;QACxC,gBAAgB,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAY,EAAE,OAAe;QAClC,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAY,EAAE,OAAe;QACnC,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,OAAe;QACtB,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAY,EAAE,KAAK,GAAG,EAAE;QACjC,OAAO,mBAAmB,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,OAAe;QACvB,OAAO,mBAAmB,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,OAAO,mBAAmB,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,YAAoB;QAC3B,OAAO,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClF,CAAC;CACF"}

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

@@ -0,0 +1,22 @@
+import type { ScaffoldFileOperation, ScaffoldWarning } from "./add-types.js";
+import type { DiscoveredArtifact, DiscoveredProfile } from "./project-discovery-types.js";
+import type { ScaffoldDependencyName } from "./scaffold-catalog.js";
+/** One request's authoritative immutable planning state, held only in its owning Ref. */
+export interface PlanBuilderState {
+    readonly files: ReadonlyMap<string, ScaffoldFileOperation>;
+    readonly dependencies: ReadonlySet<ScaffoldDependencyName>;
+    readonly scripts: ReadonlyMap<string, string>;
+    readonly warnings: ReadonlyMap<string, ScaffoldWarning>;
+    readonly nextSteps: ReadonlySet<string>;
+    readonly artifacts: readonly DiscoveredArtifact[];
+    readonly profiles: readonly DiscoveredProfile[];
+}
+/** Artifact identity added to the current request's discovery view. */
+export interface PlannedArtifactInput {
+    readonly domain: string;
+    readonly path: string;
+    readonly binding: string;
+    readonly id: string;
+    readonly exportKind?: "default" | "named";
+}
+//# sourceMappingURL=plan-builder.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-builder.types.d.ts","sourceRoot":"","sources":["../src/plan-builder.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC3D,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CAC3C"}

package/dist/plan-builder.types.js

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

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

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

package/dist/plan-manifest.d.ts

@@ -1,6 +1,18 @@
 import { type ScaffoldDependencyName } from "./scaffold-catalog.js";
-export declare function mergeScaffoldManifest(source: string, dependencies: ReadonlySet<ScaffoldDependencyName>, plannedScripts: ReadonlyMap<string, string>): {
-    readonly content: string;
-    readonly added: Record<string, string>;
-};
+import type { ScaffoldManifestMerge } from "./plan-manifest.types.js";
+/**
+ * Merges supported dependencies and scripts while retaining compatible authored specifications.
+ * @param source - Existing project manifest bytes.
+ * @param dependencies - Supported dependency names needed by the scaffold.
+ * @param plannedScripts - Script commands owned by the requested scaffold.
+ * @param resolvedDependencies - Project-owned catalog values used only for compatibility checks.
+ * @returns Sorted manifest bytes and concrete versions of newly introduced dependencies.
+ */
+export declare function mergeScaffoldManifest(source: string, dependencies: ReadonlySet<ScaffoldDependencyName>, plannedScripts: ReadonlyMap<string, string>, resolvedDependencies?: Readonly<Record<string, string>>): ScaffoldManifestMerge;
+/**
+ * Selects declarations using the same dependency-section precedence as scaffold merging.
+ * @param source - Existing or already-planned project manifest bytes.
+ * @returns Runtime declarations overriding duplicate development declarations.
+ */
+export declare function scaffoldManifestDependencies(source: string): Readonly<Record<string, string>>;
 //# sourceMappingURL=plan-manifest.d.ts.map

package/dist/plan-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-manifest.d.ts","sourceRoot":"","sources":["../src/plan-manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAS3F,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,WAAW,CAAC,sBAAsB,CAAC,EACjD,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1C;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAiCtE"}
+{"version":3,"file":"plan-manifest.d.ts","sourceRoot":"","sources":["../src/plan-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,EAAoB,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAExF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,WAAW,CAAC,sBAAsB,CAAC,EACjD,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3C,oBAAoB,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC1D,qBAAqB,CAkCvB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAG7F"}

package/dist/plan-manifest.js

@@ -1,13 +1,24 @@
+import { Schema } from "effect";
+import { JsonObject, ScaffoldManifestSchema } from "./project-manifest.schemas.js";
 import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
 import { SCAFFOLD_DEPENDENCIES } from "./scaffold-catalog.js";
-export function mergeScaffoldManifest(source, dependencies, plannedScripts) {
-    const manifest = JSON.parse(source);
+/**
+ * Merges supported dependencies and scripts while retaining compatible authored specifications.
+ * @param source - Existing project manifest bytes.
+ * @param dependencies - Supported dependency names needed by the scaffold.
+ * @param plannedScripts - Script commands owned by the requested scaffold.
+ * @param resolvedDependencies - Project-owned catalog values used only for compatibility checks.
+ * @returns Sorted manifest bytes and concrete versions of newly introduced dependencies.
+ */
+export function mergeScaffoldManifest(source, dependencies, plannedScripts, resolvedDependencies = {}) {
+    const manifest = parseManifest(source);
     const added = {};
     for (const name of [...dependencies].sort()) {
         const wanted = SCAFFOLD_DEPENDENCIES[name];
         const current = manifest.dependencies?.[name] ?? manifest.devDependencies?.[name];
+        const compared = resolvedDependencies[name] ?? current;
         if (current !== undefined &&
-            current !== wanted.version &&
+            compared !== wanted.version &&
             current !== "workspace:*" &&
             current !== `link:${name}`) {
             collision(`package.json already declares ${name}@${current}.`);
@@ -34,9 +45,55 @@ export function mergeScaffoldManifest(source, dependencies, plannedScripts) {
     manifest.scripts = sort(scripts);
     return { content: `${JSON.stringify(manifest, null, 2)}\n`, added };
 }
+/**
+ * Selects declarations using the same dependency-section precedence as scaffold merging.
+ * @param source - Existing or already-planned project manifest bytes.
+ * @returns Runtime declarations overriding duplicate development declarations.
+ */
+export function scaffoldManifestDependencies(source) {
+    const manifest = parseManifest(source);
+    return { ...manifest.devDependencies, ...manifest.dependencies };
+}
+/**
+ * Validates mutable manifest sections before any scaffold plan is committed.
+ * @param source - JSON manifest bytes supplied by project discovery or planning.
+ * @returns A manifest preserving unrelated fields while exposing validated owned sections.
+ */
+function parseManifest(source) {
+    const value = JSON.parse(source);
+    try {
+        const original = Schema.decodeUnknownSync(JsonObject)(value);
+        const manifest = Schema.decodeUnknownSync(ScaffoldManifestSchema)(original);
+        return {
+            ...original,
+            ...(manifest.dependencies === undefined
+                ? {}
+                : { dependencies: { ...manifest.dependencies } }),
+            ...(manifest.devDependencies === undefined
+                ? {}
+                : { devDependencies: { ...manifest.devDependencies } }),
+            ...(manifest.scripts === undefined ? {} : { scripts: { ...manifest.scripts } }),
+        };
+    }
+    catch (error) {
+        if (!Schema.isSchemaError(error))
+            throw error;
+        throw new AddScaffoldError(ADD_FAILURE_CODES.invalidProject, "package.json dependencies and scripts must contain string values.");
+    }
+}
+/**
+ * Orders owned manifest string records by key.
+ * @param value - Owned dependency or script record.
+ * @returns A new record whose entries use deterministic sorted keys.
+ */
 function sort(value) {
     return Object.fromEntries(Object.entries(value).sort());
 }
+/**
+ * Rejects an existing declaration that conflicts with planned output.
+ * @param message - Diagnostic explaining the conflicting declaration.
+ * @returns No value; throws AddScaffoldError with RELKIT_ADD_COLLISION.
+ */
 function collision(message) {
     throw new AddScaffoldError(ADD_FAILURE_CODES.collision, message);
 }

package/dist/plan-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-manifest.js","sourceRoot":"","sources":["../src/plan-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAA+B,MAAM,uBAAuB,CAAC;AAS3F,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,YAAiD,EACjD,cAA2C;IAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAa,CAAC;IAChD,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC;QAClF,IACE,OAAO,KAAK,SAAS;YACrB,OAAO,KAAK,MAAM,CAAC,OAAO;YAC1B,OAAO,KAAK,aAAa;YACzB,OAAO,KAAK,QAAQ,IAAI,EAAE,EAC1B,CAAC;YACD,SAAS,CAAC,iCAAiC,IAAI,IAAI,OAAO,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,OAAO,KAAK,SAAS;YAAE,SAAS;QACpC,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,KAAK,cAAc;YAC/B,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,KAAK,EAAE,CAAC;YAChC,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,cAAc,EAAE,CAAC;QAC7C,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YAC7D,SAAS,CAAC,uBAAuB,IAAI,kBAAkB,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY;QAAE,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC/E,IAAI,QAAQ,CAAC,eAAe;QAAE,QAAQ,CAAC,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxF,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,IAAI,CAAC,KAA6B;IACzC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"plan-manifest.js","sourceRoot":"","sources":["../src/plan-manifest.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,13 @@
+/** Project manifest sections owned by scaffold dependency and script planning. */
+export interface ScaffoldManifest {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    scripts?: Record<string, string>;
+    readonly [key: string]: unknown;
+}
+/** Deterministic manifest bytes and newly introduced dependency identities. */
+export interface ScaffoldManifestMerge {
+    readonly content: string;
+    readonly added: Record<string, string>;
+}
+//# sourceMappingURL=plan-manifest.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-manifest.types.d.ts","sourceRoot":"","sources":["../src/plan-manifest.types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC"}

package/dist/plan-manifest.types.js

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

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

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

package/dist/project-catalog.d.ts

@@ -0,0 +1,17 @@
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+/**
+ * Resolves authored Bun aliases without replacing declarations or hiding filesystem authority.
+ * @param projectRoot - Directory whose nearest catalog owns the aliases.
+ * @param dependencies - Specifications to compare with supported concrete versions.
+ * @returns Concrete values or a typed invalid-project failure.
+ */
+export declare const resolveProjectDependenciesEffect: (projectRoot: string, dependencies: Readonly<Record<string, string>>) => Effect.Effect<Readonly<Record<string, string>>, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Preserves the project catalog Promise API and authored alias ownership.
+ * @param projectRoot - Project directory.
+ * @param dependencies - Specifications to resolve.
+ * @returns Concrete comparisons; specifications that do not use catalogs remain unchanged.
+ */
+export declare function resolveProjectDependencies(projectRoot: string, dependencies: Readonly<Record<string, string>>): Promise<Readonly<Record<string, string>>>;
+//# sourceMappingURL=project-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-catalog.d.ts","sourceRoot":"","sources":["../src/project-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAGxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAKhE;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,wPAiB5C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAE3C"}