@forgecart/cli 2.202610040408.0 → 2.202610041107.0

package/dist/src/commands/__test__/cli-harness.d.ts

@@ -9,7 +9,28 @@
  * `dist/bin/forgecart.js` exists when these run.
  */
 export declare const CLI: string;
-/** The bundled storefront template the built CLI scaffolds from. */
+/** The CLI's bundled template set: `template-set.json` and every row's tree, beside `dist/`. */
+export declare const TEMPLATES_DIR: string;
+/** A template identity: the UI framework and the example a template renders. */
+export interface TemplateIdentity {
+    uiFramework: string;
+    example: string;
+}
+/** A row of the template set (#2775): an identity and the directory its tree lives in. */
+export interface TemplateRow extends TemplateIdentity {
+    directory: string;
+}
+/** Every row the template set ships, in its order — the trees a per-row spec iterates. */
+export declare const TEMPLATE_ROWS: readonly TemplateRow[];
+/**
+ * The bundled template the built CLI scaffolds `identity` from: its row's
+ * `directory`, resolved from `template-set.json` as the CLI resolves it. An
+ * identity the set has no row for fails here, named.
+ */
+export declare function templateDir(identity: TemplateIdentity): string;
+/** The identity every `init --yes` run answers: the set's first UI framework and first example. */
+export declare const ANSWERED_IDENTITY: TemplateIdentity;
+/** The bundled template every `init --yes` run scaffolds: {@link ANSWERED_IDENTITY}'s row. */
 export declare const TEMPLATE_SRC: string;
 export interface CliRun {
     status: number | null;

package/dist/src/commands/__test__/cli-harness.js

@@ -1,5 +1,6 @@
 import { spawnSync } from 'node:child_process';
-import { resolve } from 'node:path';
+import { readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
 /**
  * Shared black-box harness for the CLI command specs.
  *
@@ -11,8 +12,30 @@ import { resolve } from 'node:path';
  * `dist/bin/forgecart.js` exists when these run.
  */
 export const CLI = resolve(__dirname, '..', '..', '..', 'dist', 'bin', 'forgecart.js');
-/** The bundled storefront template the built CLI scaffolds from. */
-export const TEMPLATE_SRC = resolve(__dirname, '..', '..', '..', 'templates', 'storefront');
+/** The CLI's bundled template set: `template-set.json` and every row's tree, beside `dist/`. */
+export const TEMPLATES_DIR = resolve(__dirname, '..', '..', '..', 'templates');
+const TEMPLATE_SET = JSON.parse(readFileSync(join(TEMPLATES_DIR, 'template-set.json'), 'utf8'));
+/** Every row the template set ships, in its order — the trees a per-row spec iterates. */
+export const TEMPLATE_ROWS = TEMPLATE_SET.templates;
+/**
+ * The bundled template the built CLI scaffolds `identity` from: its row's
+ * `directory`, resolved from `template-set.json` as the CLI resolves it. An
+ * identity the set has no row for fails here, named.
+ */
+export function templateDir(identity) {
+    const row = TEMPLATE_ROWS.find(({ uiFramework, example }) => uiFramework === identity.uiFramework && example === identity.example);
+    if (row === undefined) {
+        throw new Error(`template-set.json has no row for ${identity.uiFramework}/${identity.example}`);
+    }
+    return join(TEMPLATES_DIR, row.directory);
+}
+/** The identity every `init --yes` run answers: the set's first UI framework and first example. */
+export const ANSWERED_IDENTITY = {
+    uiFramework: TEMPLATE_SET.uiFrameworks.at(0)?.id ?? '',
+    example: TEMPLATE_SET.examples.at(0)?.id ?? '',
+};
+/** The bundled template every `init --yes` run scaffolds: {@link ANSWERED_IDENTITY}'s row. */
+export const TEMPLATE_SRC = templateDir(ANSWERED_IDENTITY);
 /**
  * Run the built CLI with `args` exactly as typed: the run a spec makes when
  * the questions a command asks are its subject.

package/dist/src/commands/__test__/cli-harness.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-harness.js","sourceRoot":"","sources":["../../../../src/commands/__test__/cli-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;AAEvF,oEAAoE;AACpE,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AAU5F;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAuB,EACvB,GAAW,EACX,eAAuC,EAAE;IAEzC,4EAA4E;IAC5E,gEAAgE;IAChE,MAAM,GAAG,GAAuC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACnE,OAAO,GAAG,CAAC,sBAAsB,CAAC;IAClC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAEjC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3F,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE;QACnD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CACpB,IAAuB,EACvB,GAAW,EACX,eAAuC,EAAE;IAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,OAAO,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"cli-harness.js","sourceRoot":"","sources":["../../../../src/commands/__test__/cli-harness.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/design-system-seat.d.ts

@@ -38,9 +38,9 @@ export interface DesignSystemView {
 }
 /**
  * The design-system member a refresh reports beside its per-file verdicts: the
- * choice the workspace recorded (null while unset) against the one the bundled
- * template renders. The two differ when the merchant chose a design system the
- * template does not render.
+ * choice the workspace recorded (null while unset) against the one the
+ * workspace's template renders. The two differ when the merchant chose a design
+ * system the template does not render.
  */
 export interface DesignSystemPartition {
     recorded: DesignSystemChoice | null;
@@ -73,8 +73,11 @@ export declare function templateDesignSystem({ uiFramework, example, }: Template
 export declare function stampDesignSystem(choice: DesignSystemChoice): DesignSystemSeat;
 /** The seat as the command reports it: its three fields, each null while unset. */
 export declare function viewDesignSystem(seat: DesignSystemSeat | undefined): DesignSystemView;
-/** The design-system member of a refresh report for a workspace recording `seat`. */
-export declare function designSystemPartition(seat: DesignSystemSeat | undefined): DesignSystemPartition;
+/**
+ * The design-system member of a refresh report for a workspace recording
+ * `seat`, rendered from `template` — the identity its manifest records (#2775).
+ */
+export declare function designSystemPartition(seat: DesignSystemSeat | undefined, template: TemplateIdentity): DesignSystemPartition;
 /** Whether two choices name the same UI framework and content mode. */
 export declare function sameDesignSystem(a: DesignSystemChoice, b: DesignSystemChoice): boolean;
 /** A choice in words, as the human output prints it: `shadcn (example content)`. */

package/dist/src/commands/design-system-seat.js

@@ -23,11 +23,6 @@ export var ContentMode;
     ContentMode["EXAMPLE"] = "example";
     ContentMode["BLANK"] = "blank";
 })(ContentMode || (ContentMode = {}));
-/** The design system the bundled storefront template renders: daisyUI with example content. */
-const BUNDLED_TEMPLATE_DESIGN_SYSTEM = {
-    uiFramework: 'daisyui',
-    contentMode: ContentMode.EXAMPLE,
-};
 /** One segment of a UI framework id: lowercase letters and digits. */
 const UI_FRAMEWORK_ID_SEGMENT = /^[a-z0-9]+$/;
 /** The longest UI framework id the seat records. */
@@ -85,11 +80,14 @@ export function viewDesignSystem(seat) {
         recordedAt: seat?.recordedAt ?? null,
     };
 }
-/** The design-system member of a refresh report for a workspace recording `seat`. */
-export function designSystemPartition(seat) {
+/**
+ * The design-system member of a refresh report for a workspace recording
+ * `seat`, rendered from `template` — the identity its manifest records (#2775).
+ */
+export function designSystemPartition(seat, template) {
     return {
         recorded: recordedChoice(seat),
-        rendered: { ...BUNDLED_TEMPLATE_DESIGN_SYSTEM },
+        rendered: templateDesignSystem(template),
     };
 }
 /** Whether two choices name the same UI framework and content mode. */

package/dist/src/commands/design-system-seat.js.map

@@ -1 +1 @@
-{"version":3,"file":"design-system-seat.js","sourceRoot":"","sources":["../../../src/commands/design-system-seat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"design-system-seat.js","sourceRoot":"","sources":["../../../src/commands/design-system-seat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAyB,MAAM,wCAAwC,CAAC;AAE9F;;;;;;;;;;;;;;;;GAgBG;AAEH,uFAAuF;AACvF,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;AACjB,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB;AA+BD,sEAAsE;AACtE,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAE9C,oDAAoD;AACpD,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;AAE/E;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,CACL,KAAK,CAAC,MAAM,IAAI,0BAA0B;QAC1C,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IACvD,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAClF,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAChF,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACxF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACnC,WAAW,EACX,OAAO,GACU;IACjB,MAAM,WAAW,GAAG,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC;IACxF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AACtC,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC1D,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,IAAkC;IACjE,OAAO;QACL,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,IAAI;QACtC,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,IAAI;QACtC,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,IAAI;KACrC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAkC,EAClC,QAA0B;IAE1B,OAAO;QACL,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC;QAC9B,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,CAAqB,EAAE,CAAqB;IAC3E,OAAO,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,CAAC;AAC5E,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,EAAE,WAAW,EAAE,WAAW,EAAsB;IACnF,OAAO,GAAG,WAAW,KAAK,WAAW,WAAW,CAAC;AACnD,CAAC;AAED,sEAAsE;AACtE,SAAS,cAAc,CAAC,IAAkC;IACxD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;AAC1E,CAAC"}

package/dist/src/commands/init-questions.d.ts

@@ -23,9 +23,10 @@ export declare class InitQuestions {
      */
     constructor(templateSet: TemplateSet, flags: InitQuestionsInput, prompt: QuestionPrompt);
     /**
-     * Ask, in order, and settle the template the answers pick: an identity the
+     * Ask, in order, and settle where the answers render from: an identity the
      * release renders no template for is refused before the catalog question,
-     * and the catalog question is asked for an example only.
+     * and the catalog question is asked for an example only — a blank storefront
+     * renders no template and takes no catalog (#2775).
      */
     ask(): Promise<SettledScaffold>;
     /** The UI framework and the example: what the flags leave open is asked in one go. */

package/dist/src/commands/init-questions.js

@@ -50,15 +50,16 @@ export class InitQuestions {
         this.prompt = prompt;
     }
     /**
-     * Ask, in order, and settle the template the answers pick: an identity the
+     * Ask, in order, and settle where the answers render from: an identity the
      * release renders no template for is refused before the catalog question,
-     * and the catalog question is asked for an example only.
+     * and the catalog question is asked for an example only — a blank storefront
+     * renders no template and takes no catalog (#2775).
      */
     async ask() {
         const identity = await this.askIdentity();
-        const templateDir = this.templateSet.templateDir(identity);
+        const source = this.templateSet.templateSource(identity);
         const catalog = await this.askCatalog(identity);
-        return { answers: { ...identity, catalog }, templateDir };
+        return { answers: { ...identity, catalog }, source };
     }
     /** The UI framework and the example: what the flags leave open is asked in one go. */
     async askIdentity() {

package/dist/src/commands/init-questions.js.map

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

package/dist/src/commands/init.d.ts

@@ -14,12 +14,24 @@ import type { InitQuestionsInput } from './type/init.input.js';
 export declare const DEFAULT_SHOP_API_URL = "https://api.forgecart.com/shop-api";
 /**
  * Environment variable naming a dependency-warmed storefront template — a copy
- * of the bundled template with `node_modules` (and the generated
- * `package-lock.json`) already installed. The workspace-pod image bakes one at
- * build time (`docker/workspace-pod/Dockerfile`) and exports this variable so a
- * pod scaffold copies warm dependencies instead of paying a cold `npm install`.
+ * of one bundled template with `node_modules` (and the generated
+ * `package-lock.json`) already installed, and the identity it was warmed from
+ * recorded at {@link WARMED_TEMPLATE_IDENTITY_PATH}. The workspace-pod image
+ * bakes one at build time (`docker/workspace-pod/Dockerfile`) and exports this
+ * variable so a pod scaffold of THAT identity copies warm dependencies instead
+ * of paying a cold `npm install`.
  */
 export declare const WORKSPACE_TEMPLATE_DIR_ENV = "WORKSPACE_TEMPLATE_DIR";
+/**
+ * Where a warmed template records the template identity it was warmed from,
+ * relative to its root, as `{ "uiFramework": …, "example": … }` (#2775) — baked
+ * beside the image's stamp carrier (`.forgecart/template-stamp`). Init uses a
+ * warmed template only for a scaffold of that identity: another identity's
+ * dependencies are not this template's, whatever its `package.json` says. A
+ * warmed template without the file was baked before the image recorded one,
+ * from {@link PRE_IDENTITY_TEMPLATE}.
+ */
+export declare const WARMED_TEMPLATE_IDENTITY_PATH = ".forgecart/template-identity.json";
 /**
  * Marker file, relative to the scaffolded storefront root, recording that
  * `node_modules` was copied fully installed from a warmed template whose
@@ -84,14 +96,15 @@ export interface InitOptions extends QuestionPromptInput, InitQuestionsInput {
  * Resolves the channel token and the target directory, asks init's questions
  * ({@link InitQuestions}) — refusing, before any file is written, a template
  * the release does not render — scaffolds the storefront from the warmed
- * template when one is available (see {@link resolveScaffoldPlan}) or the
- * template the answers picked otherwise, writes the ForgeCart config with the
- * answers and `.env`, inventories the render under its template identity with
- * the workspace's design-system seat — the one it records, else the one the
- * answers determine (#2808) — mirrored into the config, and prints next steps.
- * Throws a clear Error on any failure (missing token, unrendered template,
- * missing template, copy failure); an unanswered question exits 2 through the
- * question adapter's refusal.
+ * template of the answers' identity when one is available (see {@link
+ * resolveScaffoldPlan}) or the template the answers picked otherwise — or, for
+ * a blank storefront, nothing at all (#2775) — writes the ForgeCart config with
+ * the answers and `.env`, inventories the render under its template identity
+ * with the workspace's design-system seat — the one it records, else the one
+ * the answers determine (#2808) — mirrored into the config, and prints next
+ * steps. Throws a clear Error on any failure (missing token, unrendered
+ * template, missing template, copy failure); an unanswered question exits 2
+ * through the question adapter's refusal.
  */
 export declare function runInit(name: string | undefined, options: InitOptions, templateSet: TemplateSet): Promise<void>;
 /**

package/dist/src/commands/init.js

@@ -4,10 +4,11 @@ import { Command, Option } from 'commander';
 import { print } from '../output.js';
 import { QuestionPromptAdapter } from '../question/question-prompt.adapter.js';
 import { TemplateSet } from '../template/template-set.js';
+import { describeTemplateIdentity, isBlankTemplate, parseTemplateIdentity, PRE_IDENTITY_TEMPLATE, sameTemplateIdentity, } from '../template/util/template-identity.util.js';
 import { readPackageVersion } from '../version.js';
 import { stampDesignSystem, templateDesignSystem, } from './design-system-seat.js';
 import { InitQuestions } from './init-questions.js';
-import { readTemplateManifest, serializeTemplateManifest, templateManifestPath, writeTemplateManifest, } from './template-manifest.js';
+import { inventoryTemplate, manifestTemplate, readTemplateManifest, serializeTemplateManifest, templateManifestPath, writeTemplateManifest, } from './template-manifest.js';
 /**
  * Default shop API base, INCLUDING the mounted path. The API serves the shop
  * GraphQL endpoint at `/shop-api` (`app/forgecart/src/main.ts`), and the SDK
@@ -20,12 +21,24 @@ import { readTemplateManifest, serializeTemplateManifest, templateManifestPath,
 export const DEFAULT_SHOP_API_URL = 'https://api.forgecart.com/shop-api';
 /**
  * Environment variable naming a dependency-warmed storefront template — a copy
- * of the bundled template with `node_modules` (and the generated
- * `package-lock.json`) already installed. The workspace-pod image bakes one at
- * build time (`docker/workspace-pod/Dockerfile`) and exports this variable so a
- * pod scaffold copies warm dependencies instead of paying a cold `npm install`.
+ * of one bundled template with `node_modules` (and the generated
+ * `package-lock.json`) already installed, and the identity it was warmed from
+ * recorded at {@link WARMED_TEMPLATE_IDENTITY_PATH}. The workspace-pod image
+ * bakes one at build time (`docker/workspace-pod/Dockerfile`) and exports this
+ * variable so a pod scaffold of THAT identity copies warm dependencies instead
+ * of paying a cold `npm install`.
  */
 export const WORKSPACE_TEMPLATE_DIR_ENV = 'WORKSPACE_TEMPLATE_DIR';
+/**
+ * Where a warmed template records the template identity it was warmed from,
+ * relative to its root, as `{ "uiFramework": …, "example": … }` (#2775) — baked
+ * beside the image's stamp carrier (`.forgecart/template-stamp`). Init uses a
+ * warmed template only for a scaffold of that identity: another identity's
+ * dependencies are not this template's, whatever its `package.json` says. A
+ * warmed template without the file was baked before the image recorded one,
+ * from {@link PRE_IDENTITY_TEMPLATE}.
+ */
+export const WARMED_TEMPLATE_IDENTITY_PATH = '.forgecart/template-identity.json';
 /**
  * Marker file, relative to the scaffolded storefront root, recording that
  * `node_modules` was copied fully installed from a warmed template whose
@@ -71,15 +84,60 @@ async function readNormalizedManifest(manifestPath) {
     }
 }
 /**
- * Decide how to source the scaffold. The warmed template is used only when
- * {@link WORKSPACE_TEMPLATE_DIR_ENV} points at a directory that actually
- * contains an installed `node_modules`; full reuse (skipping the install)
- * additionally requires its manifest to match the bundled template's, byte for
- * semantic byte. Every failure mode degrades to the cold bundled path, so
- * images without a warmed template — and machines where the variable is unset —
- * behave exactly as before.
+ * The template identity a warmed template was warmed from: the one its file
+ * records ({@link WARMED_TEMPLATE_IDENTITY_PATH}), else — no file — {@link
+ * PRE_IDENTITY_TEMPLATE}, the one tree every image warmed before it recorded an
+ * identity. Null when the file is there but names no identity it can read.
+ */
+async function readWarmedIdentity(warmedDir) {
+    const identityPath = join(warmedDir, WARMED_TEMPLATE_IDENTITY_PATH);
+    if (!(await isFile(identityPath)))
+        return { ...PRE_IDENTITY_TEMPLATE };
+    try {
+        return parseTemplateIdentity(JSON.parse(await readFile(identityPath, 'utf8')));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The one line naming both identities when the warmed template is passed over:
+ * the identity it was warmed from (or an unreadable record of one) and the one
+ * this scaffold renders.
+ */
+function passOverLine(warmedDir, warmed, scaffold) {
+    const warmedFrom = warmed === null
+        ? 'records no readable template identity'
+        : `was warmed from ${describeTemplateIdentity(warmed)}`;
+    return (`The warmed template at ${warmedDir} ${warmedFrom}, not ${describeTemplateIdentity(scaffold)}: ` +
+        'scaffolding from the bundled template.');
+}
+/**
+ * Decide how to source the scaffold of `identity`. A blank storefront has no
+ * template, so nothing to source (#2775); any other identity renders from its
+ * bundled template directory, warmed or not ({@link resolveTemplatePlan}).
+ */
+async function resolveScaffoldPlan(source, identity) {
+    if (source.kind === 'blank')
+        return { source: 'blank' };
+    if (!(await isDirectory(source.templateDir))) {
+        throw new Error(`Storefront template not found at ${source.templateDir}.`);
+    }
+    return resolveTemplatePlan(source.templateDir, identity);
+}
+/**
+ * Decide how to source a template scaffold. The warmed template is used only
+ * when {@link WORKSPACE_TEMPLATE_DIR_ENV} points at a directory that actually
+ * contains an installed `node_modules` and was warmed from the identity the
+ * scaffold renders (#2775, {@link readWarmedIdentity}) — a warmed template of
+ * another identity, or with an unreadable record of one, is passed over with
+ * one printed line naming both; full reuse (skipping the install) additionally
+ * requires its manifest to match the bundled template's, byte for semantic
+ * byte. Every failure mode degrades to the cold bundled path, so images without
+ * a warmed template — and machines where the variable is unset — behave exactly
+ * as before.
  */
-async function resolveScaffoldPlan(bundledTemplateDir) {
+async function resolveTemplatePlan(bundledTemplateDir, identity) {
     const bundled = { source: 'bundled', templateDir: bundledTemplateDir };
     const warmedDir = process.env[WORKSPACE_TEMPLATE_DIR_ENV];
     if (!warmedDir)
@@ -89,6 +147,11 @@ async function resolveScaffoldPlan(bundledTemplateDir) {
     const warmedNodeModulesDir = join(warmedDir, 'node_modules');
     if (!(await isDirectory(warmedNodeModulesDir)))
         return bundled;
+    const warmedIdentity = await readWarmedIdentity(warmedDir);
+    if (warmedIdentity === null || !sameTemplateIdentity(warmedIdentity, identity)) {
+        print(passOverLine(warmedDir, warmedIdentity, identity));
+        return bundled;
+    }
     const warmedManifest = await readNormalizedManifest(join(warmedDir, 'package.json'));
     const bundledManifest = await readNormalizedManifest(join(bundledTemplateDir, 'package.json'));
     if (!warmedManifest || !bundledManifest || warmedManifest !== bundledManifest) {
@@ -268,19 +331,18 @@ async function writeChannelConfig(targetDir, channelToken, options, scaffold, de
     await writeFile(envPath, mergeEnv(existingEnv, channelToken, options), 'utf8');
 }
 /**
- * The design-system seat a full scaffold records (#2773), settled before the
- * template copy lands over the workspace at `targetDir`. The seat belongs to
- * the workspace, not to an init run: the one it already records stands — a
- * re-scaffold never overwrites a recorded choice — else the seat the
+ * The design-system seat a full scaffold records (#2773), settled from the
+ * workspace's `manifest` before the template copy lands over it. The seat
+ * belongs to the workspace, not to an init run: the one it already records
+ * stands — a re-scaffold never overwrites a recorded choice — else the seat the
  * scaffold's answers determine (#2808).
  */
-async function scaffoldDesignSystem(targetDir, answers) {
-    const manifest = await readTemplateManifest(targetDir);
+function scaffoldDesignSystem(manifest, answers) {
     return manifest?.designSystem ?? stampDesignSystem(templateDesignSystem(answers));
 }
 /**
  * Settle the design-system seat of a tree configured in place (#2773): the
- * seat its template manifest records stands — `--config-only` never
+ * seat its template `manifest` records stands — `--config-only` never
  * overwrites a recorded choice. A manifest that records none is given the
  * seat determined by the answers the tree was scaffolded with (its scaffold
  * record, #2808), written before the config mirrors it, so the copy every
@@ -288,8 +350,7 @@ async function scaffoldDesignSystem(targetDir, answers) {
  * scaffold record — a pre-warmed tree — records none: init never mints the
  * manifest (refresh does), and derives no seat from answers no scaffold took.
  */
-async function settleInPlaceDesignSystem(targetDir, scaffold) {
-    const manifest = await readTemplateManifest(targetDir);
+async function settleInPlaceDesignSystem(targetDir, manifest, scaffold) {
     if (manifest === null)
         return undefined;
     if (manifest.designSystem !== undefined)
@@ -300,6 +361,47 @@ async function settleInPlaceDesignSystem(targetDir, scaffold) {
     await writeFile(templateManifestPath(targetDir), serializeTemplateManifest({ ...manifest, designSystem }), 'utf8');
     return designSystem;
 }
+/**
+ * Land the plan's files in the target: the template tree — plus, when the
+ * manifests diverged, the warmed `node_modules` as a seed — or, for a blank
+ * storefront, nothing at all.
+ */
+async function landScaffold(targetDir, plan) {
+    if (plan.source === 'blank')
+        return;
+    await cp(plan.templateDir, targetDir, { recursive: true });
+    if (plan.source !== 'bundled-with-warmed-modules')
+        return;
+    await cp(plan.warmedNodeModulesDir, join(targetDir, 'node_modules'), { recursive: true });
+}
+/**
+ * The render's inventory for the template manifest: every file the plan's
+ * template landed, hashed from the plan's template dir — the exact bytes the
+ * copy landed — and none for a blank storefront, which renders no file.
+ */
+async function inventoryOf(plan) {
+    if (plan.source === 'blank')
+        return {};
+    return inventoryTemplate(plan.templateDir);
+}
+/**
+ * Whether the tree at `targetDir` is a workspace a scaffold left: a storefront,
+ * by its `package.json`, or a blank workspace (#2775), by the manifest naming
+ * blank — a blank workspace has no `package.json`.
+ */
+async function isScaffolded(targetDir, manifest) {
+    if (manifest !== null && isBlankTemplate(manifestTemplate(manifest)))
+        return true;
+    return isFile(join(targetDir, 'package.json'));
+}
+/** The `--application` note: the NestJS application scaffold is not here yet. */
+function printApplicationNote(application) {
+    if (!application)
+        return;
+    print('Note: --application was requested. A NestJS application scaffold arrives ' +
+        'in a later phase (TODO).');
+    print('');
+}
 /** Print the post-scaffold next steps. */
 function printNextSteps(targetDir, application, depsInstalled) {
     print('');
@@ -314,15 +416,35 @@ function printNextSteps(targetDir, application, depsInstalled) {
     }
     print('  npm run dev');
     print('');
-    if (application) {
-        print('Note: --application was requested. A NestJS application scaffold arrives ' +
-            'in a later phase (TODO).');
-        print('');
+    printApplicationNote(application);
+}
+/**
+ * Print what a blank scaffold left (#2775): the workspace's `.forgecart/` record
+ * and nothing to install or serve.
+ */
+function printBlankScaffold(targetDir, application) {
+    print('');
+    print(`Blank workspace created at ${targetDir}: .forgecart/ records the answers, ` +
+        'and no storefront template was rendered — there is nothing to install or serve.');
+    print('');
+    printApplicationNote(application);
+}
+/** Print what the scaffold the plan sourced left, and the next steps. */
+function printScaffolded(targetDir, application, plan) {
+    if (plan.source === 'blank') {
+        printBlankScaffold(targetDir, application);
+        return;
     }
+    printNextSteps(targetDir, application, plan.source === 'warmed');
 }
 /** Print the post-scaffold summary for the `--config-only` serve-in-place path. */
-function printConfigOnly(targetDir) {
+function printConfigOnly(targetDir, blank) {
     print('');
+    if (blank) {
+        print('Blank workspace configured: there is no storefront to install or serve.');
+        print('');
+        return;
+    }
     print('Storefront configured (pre-warmed: dependencies and dev cache already in place).');
     print('');
     print('Next steps:');
@@ -331,22 +453,24 @@ function printConfigOnly(targetDir) {
     print('');
 }
 /**
- * Serve-in-place: the target is already a warm storefront materialized from the
- * image's pre-warmed tree (node_modules + a warm `.next`). Write only the
- * per-channel config + env — copying the template would clobber the pre-warmed
- * `.next` and bust the Turbopack dev cache the bake exists to provide — and ask
- * nothing: the tree already has its template identity, and its config keeps the
- * scaffold record it carries and mirrors the design-system seat the workspace
- * records (#2773), settled first ({@link settleInPlaceDesignSystem}, #2808).
+ * Serve-in-place: the target is already a scaffolded workspace — a warm
+ * storefront materialized from the image's pre-warmed tree (node_modules + a
+ * warm `.next`), or a blank workspace (#2775). Write only the per-channel
+ * config + env — copying the template would clobber the pre-warmed `.next` and
+ * bust the Turbopack dev cache the bake exists to provide — and ask nothing: the
+ * tree already has its template identity, and its config keeps the scaffold
+ * record it carries and mirrors the design-system seat the workspace records
+ * (#2773), settled first ({@link settleInPlaceDesignSystem}, #2808).
  */
-async function configureInPlace(targetDir, channelToken, options) {
-    if (!(await isFile(join(targetDir, 'package.json')))) {
-        throw new Error(`--config-only requires an existing storefront at ${targetDir} (no package.json found).`);
+async function configureInPlace(targetDir, channelToken, options, manifest) {
+    if (!(await isScaffolded(targetDir, manifest))) {
+        throw new Error(`--config-only requires an existing workspace at ${targetDir} ` +
+            '(no package.json found, and no template manifest naming a blank workspace).');
     }
     const scaffold = await readScaffoldRecord(targetDir);
-    const designSystem = await settleInPlaceDesignSystem(targetDir, scaffold);
+    const designSystem = await settleInPlaceDesignSystem(targetDir, manifest, scaffold);
     await writeChannelConfig(targetDir, channelToken, options, scaffold, designSystem);
-    printConfigOnly(targetDir);
+    printConfigOnly(targetDir, isBlankTemplate(manifestTemplate(manifest)));
 }
 /**
  * Run `forgecart init`: the credentials, then the questions, then the scaffold
@@ -355,14 +479,15 @@ async function configureInPlace(targetDir, channelToken, options) {
  * Resolves the channel token and the target directory, asks init's questions
  * ({@link InitQuestions}) — refusing, before any file is written, a template
  * the release does not render — scaffolds the storefront from the warmed
- * template when one is available (see {@link resolveScaffoldPlan}) or the
- * template the answers picked otherwise, writes the ForgeCart config with the
- * answers and `.env`, inventories the render under its template identity with
- * the workspace's design-system seat — the one it records, else the one the
- * answers determine (#2808) — mirrored into the config, and prints next steps.
- * Throws a clear Error on any failure (missing token, unrendered template,
- * missing template, copy failure); an unanswered question exits 2 through the
- * question adapter's refusal.
+ * template of the answers' identity when one is available (see {@link
+ * resolveScaffoldPlan}) or the template the answers picked otherwise — or, for
+ * a blank storefront, nothing at all (#2775) — writes the ForgeCart config with
+ * the answers and `.env`, inventories the render under its template identity
+ * with the workspace's design-system seat — the one it records, else the one
+ * the answers determine (#2808) — mirrored into the config, and prints next
+ * steps. Throws a clear Error on any failure (missing token, unrendered
+ * template, missing template, copy failure); an unanswered question exits 2
+ * through the question adapter's refusal.
  */
 export async function runInit(name, options, templateSet) {
     const channelToken = options.token?.trim();
@@ -370,32 +495,29 @@ export async function runInit(name, options, templateSet) {
         throw new Error('A channel token is required. Pass it with --token <token> (or -t <token>).');
     }
     const targetDir = name ? resolve(process.cwd(), name) : process.cwd();
+    // The workspace's own record: its identity and its design-system seat, which
+    // belongs to the workspace, not to an init run — both init paths carry a seat
+    // it records into the files they rewrite (#2773), and settle the one the
+    // scaffold's answers determine where it records none (#2808).
+    const manifest = await readTemplateManifest(targetDir);
     if (options.configOnly) {
-        await configureInPlace(targetDir, channelToken, options);
+        await configureInPlace(targetDir, channelToken, options, manifest);
         return;
     }
     const questions = new InitQuestions(templateSet, options, new QuestionPromptAdapter(options));
-    const { answers, templateDir } = await questions.ask();
-    if (!(await isDirectory(templateDir))) {
-        throw new Error(`Storefront template not found at ${templateDir}.`);
-    }
-    const designSystem = await scaffoldDesignSystem(targetDir, answers);
-    const plan = await resolveScaffoldPlan(templateDir);
+    const { answers, source } = await questions.ask();
+    const identity = { uiFramework: answers.uiFramework, example: answers.example };
+    const plan = await resolveScaffoldPlan(source, identity);
+    const designSystem = scaffoldDesignSystem(manifest, answers);
     await mkdir(targetDir, { recursive: true });
-    await cp(plan.templateDir, targetDir, { recursive: true });
-    if (plan.source === 'bundled-with-warmed-modules') {
-        await cp(plan.warmedNodeModulesDir, join(targetDir, 'node_modules'), {
-            recursive: true,
-        });
-    }
+    await landScaffold(targetDir, plan);
     await writeChannelConfig(targetDir, channelToken, options, answers, designSystem);
     await writeDepsReadyMarker(targetDir, plan);
     // Inventory the render for `forgecart refresh` (#1116) under the template
-    // identity it re-renders from (#2774) — hashed from the plan's template dir,
-    // the exact bytes the copy above landed — recording the workspace's
+    // identity it re-renders from (#2774), recording the workspace's
     // design-system seat (#2773) under the stamp its config mirrors.
-    await writeTemplateManifest(targetDir, plan.templateDir, readPackageVersion(), { uiFramework: answers.uiFramework, example: answers.example }, designSystem);
-    printNextSteps(name ?? '.', options.application ?? false, plan.source === 'warmed');
+    await writeTemplateManifest(targetDir, await inventoryOf(plan), readPackageVersion(), identity, designSystem);
+    printScaffolded(name ?? '.', options.application ?? false, plan);
 }
 /**
  * Build the `init [name]` command: its own flags, its answers to its questions