create-cogenta 0.1.6 → 0.2.0

package/dist/skin-flow.js

@@ -1,55 +1,83 @@
 import { mkdir, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { generateSkin } from '@cogenta/agents';
+import { generateSkinCandidates } from '@cogenta/agents';
 import { renderSkinPreview } from './skin-preview.js';
 const DEFAULT_MAX_REGENERATIONS = 3;
-async function writePreview(tokens, siteName, targetDir) {
-    const previewDir = join(targetDir, '.cogenta', 'skin-preview');
-    await mkdir(previewDir, { recursive: true });
-    const pages = renderSkinPreview(tokens, siteName);
-    await Promise.all(pages.map((page) => writeFile(join(previewDir, page.filename), page.html, 'utf8')));
-    return previewDir;
+async function writePreviews(candidates, siteName, targetDir) {
+    const root = join(targetDir, '.cogenta', 'skin-preview');
+    await mkdir(root, { recursive: true });
+    await Promise.all(candidates.map(async (candidate) => {
+        const directory = join(root, candidate.id);
+        await mkdir(directory, { recursive: true });
+        const pages = renderSkinPreview(candidate.tokens, siteName);
+        await Promise.all(pages.map((page) => writeFile(join(directory, page.filename), page.html, 'utf8')));
+    }));
+    return root;
 }
 /**
- * Step 5 of L9 task 7's pipeline: "Aperçu proposé sur trois pages types, avec
- * possibilité de régénérer ou d'ajuster." Each round runs `generateSkin`'s own
- * three-attempt auto-correction loop; on success, three real preview pages are
- * written to disk (`.cogenta/skin-preview/`) and the human is offered accept,
- * regenerate, or fall back to the default — bounded so a non-interactive
- * `--yes`/`--config` run (whose `Prompter.choice` always returns its default,
- * "accept") never loops.
+ * L19 task 3, in the installer: "l'utilisateur voit et choisit explicitement
+ * entre deux et cinq gabarits proposés, jamais un seul choix imposé."
+ *
+ * The shape of the round is what it was in L9 task 7 — generate, preview on
+ * three real pages, then accept / regenerate / fall back to the default,
+ * bounded so a non-interactive `--yes` run (whose `Prompter.choice` always
+ * answers with its default) never loops. What changed is that a round now
+ * produces several designs rather than one, each validated against contract
+ * D by `generateSkin`'s own loop, and the accept step is a pick among them.
+ *
+ * A round that cannot produce at least two distinct valid designs is not
+ * offered as a choice: it falls through to the next round, and eventually to
+ * the default skin, saying why. Presenting one option as if it were a
+ * decision is the failure mode this task exists to remove.
  */
 export async function chooseSkin(options) {
     const maxRegenerations = options.maxRegenerations ?? DEFAULT_MAX_REGENERATIONS;
     let lastReason = 'no attempt was made';
     for (let round = 1; round <= maxRegenerations; round++) {
-        options.out.detail(`Generating a skin from your description (round ${round}/${maxRegenerations})…`);
-        const result = await generateSkin({
+        options.out.detail(`Generating design proposals from your description (round ${round}/${maxRegenerations})…`);
+        const result = await generateSkinCandidates({
             client: options.client,
             model: options.model,
             description: options.description,
             blueprintLabel: options.blueprintLabel,
+            ...(options.candidateCount === undefined ? {} : { count: options.candidateCount }),
         });
+        for (const failure of result.failures) {
+            options.out.warn(`The "${failure.label}" design was not offered: ${failure.reason}.`);
+        }
         if (!result.ok) {
-            lastReason = `${result.attempts} attempt${result.attempts === 1 ? '' : 's'} all failed validation: ${result.reason}`;
+            lastReason = `no usable choice of designs was produced: ${result.reason}`;
             options.out.warn(lastReason);
             break;
         }
-        const previewDir = await writePreview(result.tokens, options.siteName, options.targetDir);
-        options.out.ok(`Skin generated and validated in ${result.attempts} attempt${result.attempts === 1 ? '' : 's'}. Preview: ${previewDir}`);
-        const choice = await options.prompter.choice('Use this generated skin?', [
-            { label: 'Accept it', value: 'accept' },
-            { label: 'Regenerate (try again)', value: 'regenerate' },
-            { label: 'Use the default skin instead', value: 'default' },
-        ], 0);
-        if (choice === 'accept') {
-            return { kind: 'generated', tokens: result.tokens, attempts: result.attempts };
+        const previewRoot = await writePreviews(result.candidates, options.siteName, options.targetDir);
+        options.out.ok(`${result.candidates.length} designs generated and validated. Previews: ${previewRoot}`);
+        for (const candidate of result.candidates) {
+            options.out.detail(`  ${candidate.label} — ${previewRoot}${join('', candidate.id)}`);
         }
+        const choice = await options.prompter.choice('Which design do you want? (open the previews above to compare)', [
+            ...result.candidates.map((candidate) => ({
+                label: candidate.label,
+                value: { kind: 'candidate', candidate },
+                hint: candidate.rationale,
+            })),
+            { label: 'None of these — propose new ones', value: 'regenerate' },
+            { label: 'None of these — use the default skin', value: 'default' },
+        ], 0);
         if (choice === 'default') {
-            return { kind: 'default', reason: 'the default skin was chosen over the generated one' };
+            return { kind: 'default', reason: 'the default skin was chosen over the generated ones' };
+        }
+        if (choice !== 'regenerate') {
+            return {
+                kind: 'generated',
+                tokens: choice.candidate.tokens,
+                attempts: choice.candidate.attempts,
+                candidateId: choice.candidate.id,
+                candidateLabel: choice.candidate.label,
+                offered: result.candidates.length,
+            };
         }
-        // 'regenerate' — loop again.
-        lastReason = `${maxRegenerations} regeneration round${maxRegenerations === 1 ? '' : 's'} were used without accepting a result`;
+        lastReason = `${maxRegenerations} regeneration round${maxRegenerations === 1 ? '' : 's'} were used without picking a design`;
     }
     return { kind: 'default', reason: lastReason };
 }

package/dist/skin-flow.js.map

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

package/dist/types.d.ts

@@ -14,6 +14,14 @@ export interface WizardAnswers {
     /** Free text (sector, mood, audience, brand colours) driving AI skin generation (L9 task 7). Empty or absent: generation is skipped, the default skin is used. */
     readonly siteDescription?: string;
     readonly adminEmail: string;
+    /**
+     * Specification documents to read before anything else (L19 task 6).
+     * Absent — which is the default everywhere, including `--yes` — and the
+     * installer behaves exactly as it did before L19 existed (R2).
+     */
+    readonly documentPaths?: readonly string[];
+    /** Answers to L19 task 8's per-site-type recommendations, by setting id. Unanswered ids fall back to the recommendation. */
+    readonly blueprintSettings?: Readonly<Record<string, boolean>>;
 }
 export declare function defaultAnswers(targetDir: string, siteName: string): WizardAnswers;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,yGAAyG;AACzG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAA;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,kKAAkK;IAClK,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAWjF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,yGAAyG;AACzG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAA;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,kKAAkK;IAClK,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C,4HAA4H;IAC5H,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAC/D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAWjF"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,QAAgB;IAChE,OAAO;QACL,SAAS;QACT,QAAQ;QACR,OAAO,EAAE,uBAAuB;QAChC,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,OAAO;QACpB,cAAc,EAAE,QAAQ;QACxB,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,mBAAmB;KAChC,CAAA;AACH,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,QAAgB;IAChE,OAAO;QACL,SAAS;QACT,QAAQ;QACR,OAAO,EAAE,uBAAuB;QAChC,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,OAAO;QACpB,cAAc,EAAE,QAAQ;QACxB,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,mBAAmB;KAChC,CAAA;AACH,CAAC"}

package/dist/wizard.d.ts

@@ -1,3 +1,4 @@
+import type { SitePlanDraft } from '@cogenta/agents';
 import type { Output } from '@cogenta/cli';
 import type { Prompter } from './prompts.js';
 export interface RunWizardOptions {
@@ -7,11 +8,26 @@ export interface RunWizardOptions {
     readonly out: Output;
     readonly configPath?: string;
     readonly env?: Record<string, string | undefined>;
+    /** Where a relative document path typed by the user is resolved from. Defaults to `process.cwd()`. */
+    readonly cwd?: string;
+    /**
+     * Test seam only — the same one `llm-setup.ts` already carries. It lets a
+     * test drive the whole installer, document step included, without a key
+     * and without the network, rather than mocking a shared module.
+     */
+    readonly fetchImpl?: typeof fetch;
 }
 /**
- * The whole ten-step wizard, orchestrated. Returns a process exit code: `0`
- * a working site, `1` the environment or the install failed, `2` a `--config`
- * file was invalid.
+ * The whole wizard, orchestrated. Returns a process exit code: `0` a working
+ * site, `1` the environment or the install failed, `2` a `--config` file was
+ * invalid.
+ *
+ * L19 inserts one optional step ahead of everything else — read a
+ * specification document, propose a plan, let a human approve it item by
+ * item — and changes nothing about the run that declines it. With no
+ * provider configured, or with `--yes`, that step is never entered and the
+ * site produced is the one this installer produced before L19 existed.
  */
 export declare function runWizard(options: RunWizardOptions): Promise<number>;
+export type { SitePlanDraft };
 //# sourceMappingURL=wizard.d.ts.map

package/dist/wizard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../src/wizard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAW1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAM5C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CAClD;AAsED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkH1E"}
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../src/wizard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAkB1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAM5C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACjD,sGAAsG;IACtG,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAClC;AAkLD;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+K1E;AAsGD,YAAY,EAAE,aAAa,EAAE,CAAA"}

package/dist/wizard.js

@@ -1,35 +1,91 @@
+import { blueprintSettings, inferBlueprint, resolveBlueprintSettings, } from './blueprint-defaults.js';
 import { BLUEPRINT_CONTENT_PACKS } from './blueprints/content-packs.js';
 import { BLUEPRINTS, resolveBlueprint } from './blueprints/registry.js';
 import { loadConfigFile } from './config-file.js';
+import { collectDocuments, readDocuments } from './document-step.js';
 import { checkEnvironment } from './environment.js';
 import { createProviderClient, LLM_PROVIDERS, validateApiKey, } from './llm-setup.js';
+import { runPlanFlow } from './plan-flow.js';
 import { printRecap } from './recap.js';
 import { scaffoldSite } from './scaffold.js';
 import { chooseSkin } from './skin-flow.js';
 import { defaultAnswers } from './types.js';
-async function collectAnswers(prompter, targetDir, siteName, detectedDatabases) {
+/**
+ * The provider question, asked before everything else now.
+ *
+ * It moved for one reason: L19's document step needs a model, and the lot
+ * puts that step "avant même de poser les questions actuelles". Nothing else
+ * changed about it — `none` is still the default, still the first option,
+ * and answering it still leaves an installer that asks nothing further about
+ * AI and produces the same site it always did (R2).
+ */
+async function collectLlmSetup(prompter, fetchImpl) {
+    const provider = await prompter.choice('LLM provider (optional — Cogenta works fully without one)', LLM_PROVIDERS.map((entry) => ({ label: entry.label, value: entry.id })), 0);
+    if (provider === 'none')
+        return { provider };
+    const option = LLM_PROVIDERS.find((entry) => entry.id === provider);
+    const model = await prompter.text('Model', option?.defaultModel ?? '');
+    const apiKey = await prompter.text('API key', '');
+    if (apiKey === '')
+        return { provider, model };
+    const validation = await validateApiKey({
+        provider,
+        apiKey,
+        model,
+        ...(fetchImpl === undefined ? {} : { fetchImpl }),
+    });
+    return { provider, model, apiKey, validation };
+}
+async function collectAnswers(prompter, out, targetDir, siteName, detectedDatabases, llm, prefill) {
     const defaults = defaultAnswers(targetDir, siteName);
+    if (prefill.because.length > 0) {
+        out.heading('Pre-filled from your document');
+        out.line('Every answer below is only a suggestion. Change any of them.');
+        for (const line of prefill.because)
+            out.detail(line);
+    }
     const name = await prompter.text('Site name', defaults.siteName);
     const url = await prompter.text('Site URL', defaults.siteUrl);
-    const locale = await prompter.text('Primary language (locale code)', defaults.defaultLocale);
-    const blueprintId = await prompter.choice('Site type', BLUEPRINTS.map((entry) => ({ label: entry.label, value: entry.id })), 0);
+    const locale = await prompter.text('Primary language (locale code)', prefill.defaultLocale ?? defaults.defaultLocale);
+    const blueprintIndex = Math.max(0, BLUEPRINTS.findIndex((entry) => entry.id === (prefill.blueprintId ?? defaults.blueprintId)));
+    const blueprintId = await prompter.choice('Site type', BLUEPRINTS.map((entry) => ({ label: entry.label, value: entry.id })), blueprintIndex);
+    // Postgres and MySQL are always offered, not only when a local server is
+    // detected — a real site is as likely to point at a managed remote
+    // database (Neon, PlanetScale, a hosting provider's MySQL) as at one
+    // running on this machine, and hiding the option entirely made those two
+    // of the three supported drivers unreachable from the wizard.
     const databaseChoices = [
-        { label: 'SQLite (default — you can change this later)', value: 'sqlite' },
-        ...(detectedDatabases.postgres
-            ? [{ label: 'Postgres (detected)', value: 'postgres' }]
-            : []),
-        ...(detectedDatabases.mysql ? [{ label: 'MySQL (detected)', value: 'mysql' }] : []),
+        { label: 'SQLite (default — no separate database server needed)', value: 'sqlite' },
+        {
+            label: detectedDatabases.postgres ? 'Postgres (detected locally)' : 'Postgres',
+            value: 'postgres',
+        },
+        { label: detectedDatabases.mysql ? 'MySQL (detected locally)' : 'MySQL', value: 'mysql' },
     ];
     const databaseDriver = await prompter.choice('Database', databaseChoices, 0);
-    const llmChoice = await prompter.choice('LLM provider', LLM_PROVIDERS.map((entry) => ({ label: entry.label, value: entry.id })), 0);
-    let llmModel;
-    let llmApiKey;
-    let siteDescription;
-    if (llmChoice !== 'none') {
-        const option = LLM_PROVIDERS.find((entry) => entry.id === llmChoice);
-        llmModel = await prompter.text('Model', option?.defaultModel ?? '');
-        llmApiKey = await prompter.text('API key', '');
-        siteDescription = await prompter.text('Site description for AI skin generation (sector, mood, audience, brand colours — leave blank to skip and keep the default skin)', '');
+    let databaseUrl;
+    if (databaseDriver === 'postgres' && !detectedDatabases.postgres) {
+        databaseUrl = await prompter.text('Postgres connection URL', '');
+    }
+    else if (databaseDriver === 'mysql' && !detectedDatabases.mysql) {
+        databaseUrl = await prompter.text('MySQL connection URL', '');
+    }
+    // Only asked when no document already answered it: a plan carries its own
+    // designs, generated from the brief, and asking for the same information
+    // twice is how an installer earns its reputation.
+    let siteDescription = prefill.siteDescription;
+    if (llm.provider !== 'none' && prefill.siteDescription === undefined) {
+        siteDescription = await prompter.text('Site description for AI design generation (sector, mood, audience, brand colours — leave blank to skip and keep the default skin)', '');
+    }
+    // L19 task 8 — the per-site-type recommendations, confirmed one at a time.
+    const recommendations = blueprintSettings(blueprintId);
+    const settingAnswers = {};
+    if (recommendations.settings.length > 0) {
+        out.heading('Defaults for this kind of site');
+        for (const setting of recommendations.settings) {
+            out.detail(setting.why);
+            settingAnswers[setting.id] = await prompter.confirm(setting.question, setting.recommended);
+        }
     }
     const adminEmail = await prompter.text('Admin email', defaults.adminEmail);
     return {
@@ -39,21 +95,50 @@ async function collectAnswers(prompter, targetDir, siteName, detectedDatabases)
         defaultLocale: locale,
         blueprintId,
         databaseDriver,
-        llmProvider: llmChoice,
-        ...(llmModel === undefined || llmModel === '' ? {} : { llmModel }),
-        ...(llmApiKey === undefined || llmApiKey === '' ? {} : { llmApiKey }),
+        ...(databaseUrl === undefined || databaseUrl === '' ? {} : { databaseUrl }),
+        llmProvider: llm.provider,
+        ...(llm.model === undefined || llm.model === '' ? {} : { llmModel: llm.model }),
+        ...(llm.apiKey === undefined || llm.apiKey === '' ? {} : { llmApiKey: llm.apiKey }),
         ...(siteDescription === undefined || siteDescription === '' ? {} : { siteDescription }),
         adminEmail,
+        blueprintSettings: settingAnswers,
+    };
+}
+function prefillFrom(plan) {
+    if (plan === undefined || plan.kind === 'failed')
+        return { because: [] };
+    const brief = plan.draft.brief;
+    const locale = (plan.kind === 'reviewed' ? plan.approved.locales[0] : undefined) ?? brief.languages[0];
+    const blueprintId = inferBlueprint(brief);
+    const because = [];
+    if (locale !== undefined)
+        because.push(`Language “${locale}” — from the brief.`);
+    if (blueprintId !== undefined) {
+        because.push(`Site type “${blueprintId}” — matched from what the brief describes.`);
+    }
+    because.push(`Design description — the brief's own summary.`);
+    return {
+        ...(locale === undefined ? {} : { defaultLocale: locale }),
+        ...(blueprintId === undefined ? {} : { blueprintId }),
+        siteDescription: brief.summary,
+        because,
     };
 }
 /**
- * The whole ten-step wizard, orchestrated. Returns a process exit code: `0`
- * a working site, `1` the environment or the install failed, `2` a `--config`
- * file was invalid.
+ * The whole wizard, orchestrated. Returns a process exit code: `0` a working
+ * site, `1` the environment or the install failed, `2` a `--config` file was
+ * invalid.
+ *
+ * L19 inserts one optional step ahead of everything else — read a
+ * specification document, propose a plan, let a human approve it item by
+ * item — and changes nothing about the run that declines it. With no
+ * provider configured, or with `--yes`, that step is never entered and the
+ * site produced is the one this installer produced before L19 existed.
  */
 export async function runWizard(options) {
     const { out, prompter } = options;
     const env = options.env ?? process.env;
+    const cwd = options.cwd ?? process.cwd();
     const environment = await checkEnvironment({ targetDir: options.targetDir, env });
     out.heading('Environment');
     for (const check of environment.checks) {
@@ -71,6 +156,8 @@ export async function runWizard(options) {
         return 1;
     }
     let answers;
+    let llm;
+    let plan;
     if (options.configPath !== undefined) {
         try {
             answers = await loadConfigFile(options.configPath, options.targetDir);
@@ -80,40 +167,61 @@ export async function runWizard(options) {
             prompter.close();
             return 2;
         }
+        llm = {
+            provider: answers.llmProvider,
+            ...(answers.llmModel === undefined ? {} : { model: answers.llmModel }),
+            ...(answers.llmApiKey === undefined ? {} : { apiKey: answers.llmApiKey }),
+        };
+        if (llm.provider !== 'none' && llm.apiKey !== undefined && llm.apiKey !== '') {
+            llm = {
+                ...llm,
+                validation: await validateApiKey({
+                    provider: llm.provider,
+                    apiKey: llm.apiKey,
+                    model: llm.model ?? '',
+                    ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+                }),
+            };
+        }
+        plan = await runDocumentStepFromConfig({
+            answers,
+            llm,
+            out,
+            cwd,
+            ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+        });
     }
     else {
-        answers = await collectAnswers(prompter, options.targetDir, options.siteName, {
+        llm = await collectLlmSetup(prompter, options.fetchImpl);
+        plan = await runDocumentStepInteractively({
+            llm,
+            prompter,
+            out,
+            cwd,
+            ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+        });
+        answers = await collectAnswers(prompter, out, options.targetDir, options.siteName, {
             postgres: environment.detectedDatabases.includes('postgres'),
             mysql: environment.detectedDatabases.includes('mysql'),
-        });
+        }, llm, prefillFrom(plan));
     }
     const resolvedBlueprint = resolveBlueprint(answers.blueprintId);
-    let keyValidation;
-    let llmModel = '';
-    if (answers.llmProvider !== 'none' &&
-        answers.llmApiKey !== undefined &&
-        answers.llmApiKey !== '') {
-        const option = LLM_PROVIDERS.find((entry) => entry.id === answers.llmProvider);
-        llmModel = answers.llmModel ?? option?.defaultModel ?? '';
-        keyValidation = await validateApiKey({
-            provider: answers.llmProvider,
-            apiKey: answers.llmApiKey,
-            model: llmModel,
-        });
-    }
-    // "Aperçu proposé sur trois pages types, avec possibilité de régénérer ou
-    // d'ajuster" (L9 task 7) needs the prompter, so it stays open until here —
-    // only a blueprint with a real content pack writes a `theme.tokens.json` a
-    // generated skin could replace.
+    const keyValidation = llm.validation;
+    const llmModel = llm.model ?? '';
+    // A reviewed plan already carries the design its owner picked, so the
+    // separate skin round is skipped rather than asking the same question a
+    // second time. Everything else about it is unchanged from L9 task 7.
+    const approvedSkin = plan?.kind === 'reviewed' ? plan.approved.skin : undefined;
     let skinOutcome;
-    if (BLUEPRINT_CONTENT_PACKS[resolvedBlueprint.blueprint.id] !== undefined &&
+    if (approvedSkin === undefined &&
+        BLUEPRINT_CONTENT_PACKS[resolvedBlueprint.blueprint.id] !== undefined &&
         answers.llmProvider !== 'none' &&
         answers.llmApiKey !== undefined &&
         answers.llmApiKey !== '' &&
         keyValidation?.valid === true &&
         answers.siteDescription !== undefined &&
         answers.siteDescription !== '') {
-        out.heading('Skin generation');
+        out.heading('Design proposals');
         skinOutcome = await chooseSkin({
             prompter,
             out,
@@ -121,6 +229,7 @@ export async function runWizard(options) {
                 provider: answers.llmProvider,
                 apiKey: answers.llmApiKey,
                 model: llmModel,
+                ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
             }),
             model: llmModel,
             description: answers.siteDescription,
@@ -130,11 +239,17 @@ export async function runWizard(options) {
         });
     }
     prompter.close();
+    const confirmed = resolveBlueprintSettings(resolvedBlueprint.blueprint.id, answers.blueprintSettings ?? {});
+    const approved = plan?.kind === 'reviewed' ? plan.approved : undefined;
+    const locales = approved !== undefined && approved.locales.length > 0
+        ? [...new Set([answers.defaultLocale, ...approved.locales])]
+        : [answers.defaultLocale];
     const scaffold = await scaffoldSite({
         targetDir: answers.targetDir,
         siteName: answers.siteName,
         siteUrl: answers.siteUrl,
         defaultLocale: answers.defaultLocale,
+        locales,
         databaseDriver: answers.databaseDriver,
         ...(answers.databaseUrl === undefined ? {} : { databaseUrl: answers.databaseUrl }),
         ...(answers.llmProvider === 'none'
@@ -142,7 +257,24 @@ export async function runWizard(options) {
             : { llm: { provider: answers.llmProvider, model: answers.llmModel ?? '' } }),
         adminEmail: answers.adminEmail,
         blueprintId: resolvedBlueprint.blueprint.id,
-        ...(skinOutcome?.kind === 'generated' ? { skinTokens: skinOutcome.tokens } : {}),
+        security: { pageMaxAge: confirmed.pageMaxAge, hstsMaxAge: confirmed.hstsMaxAge },
+        seedDemoContent: confirmed.seedDemoContent,
+        ...(approvedSkin === undefined
+            ? skinOutcome?.kind === 'generated'
+                ? { skinTokens: skinOutcome.tokens }
+                : {}
+            : { skinTokens: approvedSkin }),
+        ...(approved === undefined
+            ? {}
+            : {
+                approvedCollections: approved.collections,
+                approvedDemoContent: approved.demoContent,
+            }),
+        // A proposal nobody reviewed is stored, never applied.
+        ...(plan?.kind === 'deferred' ? { sitePlan: { draft: plan.draft } } : {}),
+        ...(plan?.kind === 'reviewed'
+            ? { sitePlan: { draft: plan.draft, decisions: plan.decisions } }
+            : {}),
     }, env);
     printRecap({
         answers,
@@ -151,7 +283,84 @@ export async function runWizard(options) {
         scaffold,
         ...(keyValidation === undefined ? {} : { keyValidation }),
         ...(skinOutcome === undefined ? {} : { skinOutcome }),
+        ...(plan === undefined ? {} : { plan }),
     }, out);
     return scaffold.migrateExitCode === 0 && scaffold.usersExitCode === 0 ? 0 : 1;
 }
+function canPlan(llm) {
+    return (llm.provider !== 'none' &&
+        llm.apiKey !== undefined &&
+        llm.apiKey !== '' &&
+        llm.validation?.valid === true);
+}
+async function planFrom(input) {
+    if (input.documents.length === 0 || input.llm.provider === 'none')
+        return undefined;
+    const provider = input.llm.provider;
+    return runPlanFlow({
+        prompter: input.prompter,
+        out: input.out,
+        client: createProviderClient({
+            provider,
+            apiKey: input.llm.apiKey ?? '',
+            model: input.llm.model ?? '',
+            ...(input.fetchImpl === undefined ? {} : { fetchImpl: input.fetchImpl }),
+        }),
+        model: input.llm.model ?? '',
+        documents: input.documents,
+    });
+}
+async function runDocumentStepInteractively(input) {
+    // Never even asked without a working provider: a question whose only
+    // possible answer is "no" is noise, and R2 means that answer must remain
+    // a complete, unremarkable path through this installer.
+    if (!canPlan(input.llm))
+        return undefined;
+    const collected = await collectDocuments({
+        prompter: input.prompter,
+        out: input.out,
+        cwd: input.cwd,
+    });
+    return planFrom({ ...input, documents: collected.documents });
+}
+/**
+ * `--config` with a `documents` list. The same analysis runs, but the review
+ * cannot: `Prompter.confirm` answers its own default in a non-interactive
+ * run, and `runPlanFlow`'s default is "do not review". The plan is therefore
+ * saved as a draft, and the site is scaffolded exactly as the rest of the
+ * config file describes.
+ */
+async function runDocumentStepFromConfig(input) {
+    const paths = input.answers.documentPaths ?? [];
+    if (paths.length === 0)
+        return undefined;
+    if (!canPlan(input.llm)) {
+        input.out.warn('Documents were listed but no working LLM provider is configured, so they were not read. The site was created from the rest of the config file.');
+        return undefined;
+    }
+    const read = await readDocuments(paths, input.cwd);
+    for (const failure of read.failures)
+        input.out.bad(failure);
+    if (read.documents.length === 0)
+        return undefined;
+    return planFrom({
+        documents: read.documents,
+        llm: input.llm,
+        out: input.out,
+        ...(input.fetchImpl === undefined ? {} : { fetchImpl: input.fetchImpl }),
+        // A prompter that always declines: this path must never claim consent.
+        prompter: {
+            async text(_question, defaultValue) {
+                return defaultValue;
+            },
+            async choice(_question, choices, defaultIndex) {
+                return (choices[defaultIndex] ?? choices[0])?.value;
+            },
+            async confirm(_question, defaultValue) {
+                return defaultValue;
+            },
+            close() { },
+        },
+    });
+}
 //# sourceMappingURL=wizard.js.map