openuispec 0.1.29 → 0.1.30

package/cli/target-presets.json

@@ -35,10 +35,10 @@
                 "org.jetbrains.kotlin.plugin.compose"
               ],
               "libraries": [
-                "com.arkivanov.decompose:decompose:{latest}",
-                "com.arkivanov.decompose:extensions-compose-android:{latest}",
-                "com.arkivanov.essenty:lifecycle-android:{latest}",
-                "com.arkivanov.essenty:instance-keeper-android:{latest}"
+                "com.arkivanov.decompose:decompose:{latest stable}",
+                "com.arkivanov.decompose:extensions-compose-android:{latest stable}",
+                "com.arkivanov.essenty:lifecycle-android:{latest stable}",
+                "com.arkivanov.essenty:instance-keeper-android:{latest stable}"
               ],
               "docs": [
                 "https://github.com/arkivanov/Decompose",
@@ -58,8 +58,8 @@
                 "org.jetbrains.kotlin.plugin.compose"
               ],
               "libraries": [
-                "androidx.navigation:navigation-compose:{latest}",
-                "androidx.lifecycle:lifecycle-runtime-compose:{latest}"
+                "androidx.navigation:navigation-compose:{latest stable}",
+                "androidx.lifecycle:lifecycle-runtime-compose:{latest stable}"
               ],
               "docs": [
                 "https://developer.android.com/guide/navigation",
@@ -85,9 +85,9 @@
             "refs": {
               "plugins": [],
               "libraries": [
-                "com.arkivanov.mvikotlin:mvikotlin:{latest}",
-                "com.arkivanov.mvikotlin:mvikotlin-main:{latest}",
-                "com.arkivanov.mvikotlin:mvikotlin-logging:{latest}"
+                "com.arkivanov.mvikotlin:mvikotlin:{latest stable}",
+                "com.arkivanov.mvikotlin:mvikotlin-main:{latest stable}",
+                "com.arkivanov.mvikotlin:mvikotlin-logging:{latest stable}"
               ],
               "docs": [
                 "https://github.com/arkivanov/MVIKotlin"
@@ -105,9 +105,9 @@
             "refs": {
               "plugins": [],
               "libraries": [
-                "androidx.lifecycle:lifecycle-viewmodel-compose:{latest}",
-                "androidx.lifecycle:lifecycle-runtime-compose:{latest}",
-                "org.jetbrains.kotlinx:kotlinx-coroutines-core:{latest}"
+                "androidx.lifecycle:lifecycle-viewmodel-compose:{latest stable}",
+                "androidx.lifecycle:lifecycle-runtime-compose:{latest stable}",
+                "org.jetbrains.kotlinx:kotlinx-coroutines-core:{latest stable}"
               ],
               "docs": [
                 "https://developer.android.com/jetpack/androidx/releases/lifecycle",
@@ -132,8 +132,8 @@
             "refs": {
               "plugins": [],
               "libraries": [
-                "androidx.datastore:datastore-preferences:{latest}",
-                "androidx.datastore:datastore-core:{latest}"
+                "androidx.datastore:datastore-preferences:{latest stable}",
+                "androidx.datastore:datastore-core:{latest stable}"
               ],
               "docs": [
                 "https://developer.android.com/topic/libraries/architecture/datastore"
@@ -169,8 +169,8 @@
                 "app.cash.sqldelight"
               ],
               "libraries": [
-                "app.cash.sqldelight:android-driver:{latest}",
-                "app.cash.sqldelight:coroutines-extensions:{latest}"
+                "app.cash.sqldelight:android-driver:{latest stable}",
+                "app.cash.sqldelight:coroutines-extensions:{latest stable}"
               ],
               "docs": [
                 "https://github.com/sqldelight/sqldelight"
@@ -189,8 +189,8 @@
                 "androidx.room"
               ],
               "libraries": [
-                "androidx.room:room-runtime:{latest}",
-                "androidx.room:room-ktx:{latest}"
+                "androidx.room:room-runtime:{latest stable}",
+                "androidx.room:room-ktx:{latest stable}"
               ],
               "docs": [
                 "https://developer.android.com/training/data-storage/room"
@@ -224,8 +224,8 @@
             "refs": {
               "plugins": [],
               "libraries": [
-                "dev.zacsweers.metro:metro:{latest}",
-                "dev.zacsweers.metro:metro-compose:{latest}"
+                "dev.zacsweers.metro:metro:{latest stable}",
+                "dev.zacsweers.metro:metro-compose:{latest stable}"
               ],
               "docs": [
                 "https://github.com/ZacSweers/metro"
@@ -242,8 +242,8 @@
             "refs": {
               "plugins": [],
               "libraries": [
-                "io.insert-koin:koin-android:{latest}",
-                "io.insert-koin:koin-compose:{latest}"
+                "io.insert-koin:koin-android:{latest stable}",
+                "io.insert-koin:koin-compose:{latest stable}"
               ],
               "docs": [
                 "https://insert-koin.io/docs/quickstart/android/",
@@ -263,8 +263,8 @@
                 "com.google.dagger.hilt.android"
               ],
               "libraries": [
-                "com.google.dagger:hilt-android:{latest}",
-                "androidx.hilt:hilt-navigation-compose:{latest}"
+                "com.google.dagger:hilt-android:{latest stable}",
+                "androidx.hilt:hilt-navigation-compose:{latest stable}"
               ],
               "docs": [
                 "https://developer.android.com/training/dependency-injection/hilt-android",
@@ -330,7 +330,7 @@
             "dependencies": [],
             "refs": {
               "packages": [
-                "next@{latest}"
+                "next@{latest stable}"
               ],
               "docs": [
                 "https://nextjs.org/docs"
@@ -343,7 +343,7 @@
             "dependencies": [],
             "refs": {
               "packages": [
-                "hono@{latest}"
+                "hono@{latest stable}"
               ],
               "docs": [
                 "https://hono.dev/"
@@ -365,7 +365,7 @@
             ],
             "refs": {
               "packages": [
-                "tailwindcss@{latest}"
+                "tailwindcss@{latest stable}"
               ],
               "docs": [
                 "https://tailwindcss.com/docs"
@@ -406,7 +406,7 @@
             ],
             "refs": {
               "packages": [
-                "react-router@{latest}"
+                "react-router@{latest stable}"
               ],
               "docs": [
                 "https://reactrouter.com/"
@@ -422,7 +422,7 @@
             ],
             "refs": {
               "packages": [
-                "@tanstack/react-router@{latest}"
+                "@tanstack/react-router@{latest stable}"
               ],
               "docs": [
                 "https://tanstack.com/router/docs"
@@ -438,7 +438,7 @@
             ],
             "refs": {
               "packages": [
-                "vue-router@{latest}"
+                "vue-router@{latest stable}"
               ],
               "docs": [
                 "https://router.vuejs.org/"
@@ -473,7 +473,7 @@
             ],
             "refs": {
               "packages": [
-                "zustand@{latest}"
+                "zustand@{latest stable}"
               ],
               "docs": [
                 "https://zustand.docs.pmnd.rs/"
@@ -490,8 +490,8 @@
             ],
             "refs": {
               "packages": [
-                "@reduxjs/toolkit@{latest}",
-                "react-redux@{latest}"
+                "@reduxjs/toolkit@{latest stable}",
+                "react-redux@{latest stable}"
               ],
               "docs": [
                 "https://redux-toolkit.js.org/",
@@ -508,7 +508,7 @@
             ],
             "refs": {
               "packages": [
-                "@tanstack/react-query@{latest}"
+                "@tanstack/react-query@{latest stable}"
               ],
               "docs": [
                 "https://tanstack.com/query/latest"
@@ -524,7 +524,7 @@
             ],
             "refs": {
               "packages": [
-                "pinia@{latest}"
+                "pinia@{latest stable}"
               ],
               "docs": [
                 "https://pinia.vuejs.org/"
@@ -567,7 +567,7 @@
             ],
             "refs": {
               "packages": [
-                "@supabase/supabase-js@{latest}"
+                "@supabase/supabase-js@{latest stable}"
               ],
               "docs": [
                 "https://supabase.com/docs"
@@ -582,7 +582,7 @@
             ],
             "refs": {
               "packages": [
-                "firebase@{latest}"
+                "firebase@{latest stable}"
               ],
               "docs": [
                 "https://firebase.google.com/docs/web/setup"
@@ -640,7 +640,7 @@
             },
             "refs": {
               "packages": [
-                "pointfreeco/swift-composable-architecture@{latest}"
+                "pointfreeco/swift-composable-architecture@{latest stable}"
               ],
               "docs": [
                 "https://github.com/pointfreeco/swift-composable-architecture"
@@ -677,7 +677,7 @@
             ],
             "refs": {
               "packages": [
-                "stephencelis/SQLite.swift@{latest}"
+                "stephencelis/SQLite.swift@{latest stable}"
               ],
               "docs": [
                 "https://www.sqlite.org/docs.html"
@@ -717,7 +717,7 @@
             ],
             "refs": {
               "packages": [
-                "hmlongco/Factory@{latest}"
+                "hmlongco/Factory@{latest stable}"
               ],
               "docs": [
                 "https://github.com/hmlongco/Factory"

package/docs/implementation-notes.md

@@ -41,6 +41,7 @@
   - it should offer preset defaults for known stacks
   - it must still allow custom values when the project uses frameworks or libraries outside the catalog
   - `openuispec init --no-configure-targets` should remain available for users who want to defer target stack decisions until later
+  - `--defaults` is an unattended fallback only; it must not count as user confirmation for implementation
 - It should support two modes:
   1. bootstrap mode when no target snapshot exists yet
   2. update mode when a target snapshot exists
@@ -69,6 +70,9 @@
   - AI should resolve exact versions and wiring from current platform docs instead of assuming the preset list is exhaustive
 - Bootstrap mode should surface soft warnings when configured framework/stack values are custom and therefore not covered by preset dependency refs.
   - these warnings should explain that dependency guidance is incomplete, not silently omit the missing refs
+- Bootstrap mode should also surface pending stack confirmation when values were auto-applied from defaults.
+  - `generation_ready` must remain false in that state
+  - AI consumers should ask the user to confirm or change the stack before starting implementation
 - Bootstrap mode should also carry explicit generation constraints for the target:
   - localization rules
     - use target-native runtime localization resources

package/drift/index.ts

@@ -22,6 +22,8 @@ import { execFileSync } from "node:child_process";
 import YAML from "yaml";
 
 const STATE_FILE = ".openuispec-state.json";
+export const SUPPORTED_TARGETS = ["ios", "android", "web"] as const;
+export type SupportedTarget = typeof SUPPORTED_TARGETS[number];
 
 // ── types ─────────────────────────────────────────────────────────────
 
@@ -84,6 +86,10 @@ export function listFiles(dir: string, ext: string): string[] {
   }
 }
 
+export function isSupportedTarget(value: string): value is SupportedTarget {
+  return (SUPPORTED_TARGETS as readonly string[]).includes(value);
+}
+
 function hashFile(filePath: string): string {
   const content = readFileSync(filePath);
   const hash = createHash("sha256").update(content).digest("hex");
@@ -680,7 +686,7 @@ function check(
 
   const d = result.drift;
   const hasDrift = d.changed.length > 0 || d.added.length > 0 || d.removed.length > 0;
-  process.exit(hasDrift ? 1 : 0);
+  process.exit(hasDrift ? 2 : 0);
 }
 
 function checkAll(
@@ -724,7 +730,7 @@ function checkAll(
     }
   }
 
-  process.exit(anyDrift ? 1 : 0);
+  process.exit(anyDrift ? 2 : 0);
 }
 
 // ── output ────────────────────────────────────────────────────────────

package/examples/taskflow/AGENTS.md

@@ -1,5 +1,5 @@
 <!-- openuispec-rules-start -->
-<!-- openuispec-rules-version: 0.1.28 -->
+<!-- openuispec-rules-version: 0.1.29 -->
 # OpenUISpec — AI Assistant Rules
 # ================================
 # This project uses OpenUISpec to define UI as a semantic spec.
@@ -77,6 +77,7 @@ Spec-first workflow:
 5. Run `openuispec validate semantic`.
 6. Run `openuispec drift --target <target> --explain` to inspect semantic changes since that target's baseline.
 7. Run `openuispec prepare --target <target>` to build the target work bundle for that target. In `bootstrap` mode it provides first-generation constraints; in `update` mode it provides drift-based update scope.
+   If the target stack was filled from defaults, stop and ask the user to confirm or change it before implementation.
 8. Verify the affected UI targets build/run if possible.
 9. Only then run `openuispec drift --snapshot --target <target>` for affected targets, after that target output directory exists.
 10. Run `openuispec drift --target <target> --explain` again to confirm no spec changes remain for that target.
@@ -97,16 +98,16 @@ Platform-first workflow:
 - Do not treat `openuispec drift` as proof that generated UI matches the spec.
 - Do not skip `--explain` / `prepare` when another platform needs to catch up with shared spec changes.
 - Do not modify generated UI without checking whether the spec must change first.
+- Do not use `configure-target --defaults` as silent approval for implementation. Ask the user to confirm the stack first.
 
 ## CLI commands
 - `openuispec init` — scaffold a new spec project
 - `openuispec validate [group...]` — validate spec files against schemas
 - `openuispec validate semantic` — run semantic cross-reference linting
-- `openuispec configure-target <t> [--defaults]` — configure target stack defaults
 - `openuispec drift --target <t>` — check for spec drift
 - `openuispec drift --target <t> --explain` — explain semantic spec drift since the target baseline
 - `openuispec drift --snapshot --target <t>` — snapshot current state after the target output exists
-- `openuispec prepare --target <t>` — build the target work bundle
+- `openuispec prepare --target <t>` — build the target work bundle and check whether stack confirmation is still pending
 - `openuispec status` — show cross-target baseline/drift status
 - `openuispec update-rules` — update AI rules to match installed package version
 - `openuispec drift --all` — include stubs in drift check

package/examples/taskflow/CLAUDE.md

@@ -1,5 +1,5 @@
 <!-- openuispec-rules-start -->
-<!-- openuispec-rules-version: 0.1.28 -->
+<!-- openuispec-rules-version: 0.1.29 -->
 # OpenUISpec — AI Assistant Rules
 # ================================
 # This project uses OpenUISpec to define UI as a semantic spec.
@@ -77,6 +77,7 @@ Spec-first workflow:
 5. Run `openuispec validate semantic`.
 6. Run `openuispec drift --target <target> --explain` to inspect semantic changes since that target's baseline.
 7. Run `openuispec prepare --target <target>` to build the target work bundle for that target. In `bootstrap` mode it provides first-generation constraints; in `update` mode it provides drift-based update scope.
+   If the target stack was filled from defaults, stop and ask the user to confirm or change it before implementation.
 8. Verify the affected UI targets build/run if possible.
 9. Only then run `openuispec drift --snapshot --target <target>` for affected targets, after that target output directory exists.
 10. Run `openuispec drift --target <target> --explain` again to confirm no spec changes remain for that target.
@@ -97,16 +98,16 @@ Platform-first workflow:
 - Do not treat `openuispec drift` as proof that generated UI matches the spec.
 - Do not skip `--explain` / `prepare` when another platform needs to catch up with shared spec changes.
 - Do not modify generated UI without checking whether the spec must change first.
+- Do not use `configure-target --defaults` as silent approval for implementation. Ask the user to confirm the stack first.
 
 ## CLI commands
 - `openuispec init` — scaffold a new spec project
 - `openuispec validate [group...]` — validate spec files against schemas
 - `openuispec validate semantic` — run semantic cross-reference linting
-- `openuispec configure-target <t> [--defaults]` — configure target stack defaults
 - `openuispec drift --target <t>` — check for spec drift
 - `openuispec drift --target <t> --explain` — explain semantic spec drift since the target baseline
 - `openuispec drift --snapshot --target <t>` — snapshot current state after the target output exists
-- `openuispec prepare --target <t>` — build the target work bundle
+- `openuispec prepare --target <t>` — build the target work bundle and check whether stack confirmation is still pending
 - `openuispec status` — show cross-target baseline/drift status
 - `openuispec update-rules` — update AI rules to match installed package version
 - `openuispec drift --all` — include stubs in drift check

package/examples/todo-orbit/AGENTS.md

@@ -1,5 +1,5 @@
 <!-- openuispec-rules-start -->
-<!-- openuispec-rules-version: 0.1.28 -->
+<!-- openuispec-rules-version: 0.1.29 -->
 # OpenUISpec — AI Assistant Rules
 # ================================
 # This project uses OpenUISpec to define UI as a semantic spec.
@@ -77,6 +77,7 @@ Spec-first workflow:
 5. Run `openuispec validate semantic`.
 6. Run `openuispec drift --target <target> --explain` to inspect semantic changes since that target's baseline.
 7. Run `openuispec prepare --target <target>` to build the target work bundle for that target. In `bootstrap` mode it provides first-generation constraints; in `update` mode it provides drift-based update scope.
+   If the target stack was filled from defaults, stop and ask the user to confirm or change it before implementation.
 8. Verify the affected UI targets build/run if possible.
 9. Only then run `openuispec drift --snapshot --target <target>` for affected targets, after that target output directory exists.
 10. Run `openuispec drift --target <target> --explain` again to confirm no spec changes remain for that target.
@@ -97,16 +98,16 @@ Platform-first workflow:
 - Do not treat `openuispec drift` as proof that generated UI matches the spec.
 - Do not skip `--explain` / `prepare` when another platform needs to catch up with shared spec changes.
 - Do not modify generated UI without checking whether the spec must change first.
+- Do not use `configure-target --defaults` as silent approval for implementation. Ask the user to confirm the stack first.
 
 ## CLI commands
 - `openuispec init` — scaffold a new spec project
 - `openuispec validate [group...]` — validate spec files against schemas
 - `openuispec validate semantic` — run semantic cross-reference linting
-- `openuispec configure-target <t> [--defaults]` — configure target stack defaults
 - `openuispec drift --target <t>` — check for spec drift
 - `openuispec drift --target <t> --explain` — explain semantic spec drift since the target baseline
 - `openuispec drift --snapshot --target <t>` — snapshot current state after the target output exists
-- `openuispec prepare --target <t>` — build the target work bundle
+- `openuispec prepare --target <t>` — build the target work bundle and check whether stack confirmation is still pending
 - `openuispec status` — show cross-target baseline/drift status
 - `openuispec update-rules` — update AI rules to match installed package version
 - `openuispec drift --all` — include stubs in drift check

package/examples/todo-orbit/CLAUDE.md

@@ -1,5 +1,5 @@
 <!-- openuispec-rules-start -->
-<!-- openuispec-rules-version: 0.1.28 -->
+<!-- openuispec-rules-version: 0.1.29 -->
 # OpenUISpec — AI Assistant Rules
 # ================================
 # This project uses OpenUISpec to define UI as a semantic spec.
@@ -77,6 +77,7 @@ Spec-first workflow:
 5. Run `openuispec validate semantic`.
 6. Run `openuispec drift --target <target> --explain` to inspect semantic changes since that target's baseline.
 7. Run `openuispec prepare --target <target>` to build the target work bundle for that target. In `bootstrap` mode it provides first-generation constraints; in `update` mode it provides drift-based update scope.
+   If the target stack was filled from defaults, stop and ask the user to confirm or change it before implementation.
 8. Verify the affected UI targets build/run if possible.
 9. Only then run `openuispec drift --snapshot --target <target>` for affected targets, after that target output directory exists.
 10. Run `openuispec drift --target <target> --explain` again to confirm no spec changes remain for that target.
@@ -97,16 +98,16 @@ Platform-first workflow:
 - Do not treat `openuispec drift` as proof that generated UI matches the spec.
 - Do not skip `--explain` / `prepare` when another platform needs to catch up with shared spec changes.
 - Do not modify generated UI without checking whether the spec must change first.
+- Do not use `configure-target --defaults` as silent approval for implementation. Ask the user to confirm the stack first.
 
 ## CLI commands
 - `openuispec init` — scaffold a new spec project
 - `openuispec validate [group...]` — validate spec files against schemas
 - `openuispec validate semantic` — run semantic cross-reference linting
-- `openuispec configure-target <t> [--defaults]` — configure target stack defaults
 - `openuispec drift --target <t>` — check for spec drift
 - `openuispec drift --target <t> --explain` — explain semantic spec drift since the target baseline
 - `openuispec drift --snapshot --target <t>` — snapshot current state after the target output exists
-- `openuispec prepare --target <t>` — build the target work bundle
+- `openuispec prepare --target <t>` — build the target work bundle and check whether stack confirmation is still pending
 - `openuispec status` — show cross-target baseline/drift status
 - `openuispec update-rules` — update AI rules to match installed package version
 - `openuispec drift --all` — include stubs in drift check

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openuispec",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "license": "MIT",
   "type": "module",
   "description": "A semantic UI specification format for AI-native, platform-native app development",

package/prepare/index.ts

@@ -11,10 +11,12 @@ import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { basename, dirname, extname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import YAML from "yaml";
+import { listTargetWizardOptions, type TargetWizardOptionsResponse } from "../cli/configure-target.js";
 import {
   discoverSpecFiles,
   findProjectDir,
   hasStatusSemantics,
+  isSupportedTarget,
   loadTargetDrift,
   readManifest,
   readProjectName,
@@ -77,6 +79,10 @@ interface PreparePlatformConfig {
   target_sdk: number | null;
   generation: Record<string, any>;
   stack: Record<string, string>;
+  stack_confirmation: {
+    status: string | null;
+    requires_user_confirmation: boolean;
+  };
   dependency_guidance: {
     anchor_refs_only: boolean;
     notes: string[];
@@ -95,7 +101,9 @@ interface PrepareBootstrapBundle {
   output_exists: boolean;
   generation_ready: boolean;
   missing_platform_decisions: string[];
+  pending_user_confirmation: boolean;
   generation_warnings: string[];
+  target_stack_options: TargetWizardOptionsResponse | null;
   includes: Record<string, string>;
   output_format: Record<string, any>;
   i18n: {
@@ -261,6 +269,14 @@ function buildPlatformConfig(target: string, platformDef: Record<string, any>):
     target_sdk: typeof platformDef.target_sdk === "number" ? platformDef.target_sdk : null,
     generation,
     stack,
+    stack_confirmation: {
+      status:
+        typeof generation.stack_confirmation?.status === "string"
+          ? generation.stack_confirmation.status
+          : null,
+      requires_user_confirmation:
+        generation.stack_confirmation?.status === "pending_user_confirmation",
+    },
     dependency_guidance: {
       anchor_refs_only: true,
       notes: [
@@ -803,6 +819,12 @@ function referenceExamples(): string[] {
 function generationWarnings(target: string, platformConfig: PreparePlatformConfig): string[] {
   const warnings: string[] = [];
 
+  if (platformConfig.stack_confirmation.requires_user_confirmation) {
+    warnings.push(
+      `The configured ${target} stack was applied from defaults and still requires explicit user confirmation before implementation.`
+    );
+  }
+
   for (const [key, value] of Object.entries(platformConfig.stack)) {
     if (!PRESENTATION_ONLY_KEYS.has(key) && !platformConfig.selected_option_refs[key]) {
       warnings.push(
@@ -893,6 +915,9 @@ function printReport(result: PrepareResult): void {
         console.log(`    - ${key}: ${refs.value}`);
       }
     }
+    if (result.platform_config.stack_confirmation.status) {
+      console.log(`  stack confirmation: ${result.platform_config.stack_confirmation.status}`);
+    }
     if (result.platform_config.dependency_guidance.notes.length > 0) {
       console.log("  dependency guidance:");
       for (const note of result.platform_config.dependency_guidance.notes) {
@@ -911,6 +936,9 @@ function printReport(result: PrepareResult): void {
     console.log("\nBootstrap Bundle");
     console.log(`  output exists: ${result.bootstrap.output_exists ? "yes" : "no"}`);
     console.log(`  generation ready: ${result.bootstrap.generation_ready ? "yes" : "no"}`);
+    console.log(
+      `  pending user confirmation: ${result.bootstrap.pending_user_confirmation ? "yes" : "no"}`
+    );
 
     if (result.bootstrap.missing_platform_decisions.length > 0) {
       console.log("  missing platform decisions:");
@@ -919,6 +947,12 @@ function printReport(result: PrepareResult): void {
       }
     }
 
+    if (result.bootstrap.target_stack_options) {
+      console.log("  target stack options:");
+      console.log(`    - interactive: ${result.bootstrap.target_stack_options.interactive_command}`);
+      console.log(`    - non-interactive schema: openuispec configure-target ${result.target} --list-options`);
+    }
+
     if (result.bootstrap.generation_warnings.length > 0) {
       console.log("  generation warnings:");
       for (const warning of result.bootstrap.generation_warnings) {
@@ -1018,6 +1052,7 @@ function buildBootstrapPrepareResult(cwd: string, target: string): PrepareResult
   const backendRoot = resolveBackendRoot(projectDir, manifest);
   const backendContextRequired = hasApiEndpoints(manifest);
   const backendContextReady = !backendContextRequired || (backendRoot !== null && existsSync(backendRoot));
+  const pendingUserConfirmation = platformConfig.stack_confirmation.requires_user_confirmation;
 
   const nextSteps = [
     ...(!backendContextReady
@@ -1025,6 +1060,11 @@ function buildBootstrapPrepareResult(cwd: string, target: string): PrepareResult
           "Set `generation.code_roots.backend` in openuispec.yaml to the backend folder used to implement the declared API endpoints.",
         ]
       : []),
+    ...(pendingUserConfirmation
+      ? [
+          `Run \`openuispec configure-target ${target}\` without \`--defaults\` and confirm the stack choices before implementation.`,
+        ]
+      : []),
     ...(missingDecisions.length > 0
       ? [
           `Run \`openuispec configure-target ${target}\` to choose the missing ${target} stack defaults before generation.`,
@@ -1069,9 +1109,14 @@ function buildBootstrapPrepareResult(cwd: string, target: string): PrepareResult
     items: [],
     bootstrap: {
       output_exists: existsSync(outputDir),
-      generation_ready: missingDecisions.length === 0 && backendContextReady,
+      generation_ready: missingDecisions.length === 0 && backendContextReady && !pendingUserConfirmation,
       missing_platform_decisions: missingDecisions,
+      pending_user_confirmation: pendingUserConfirmation,
       includes: manifest.includes ?? {},
+      target_stack_options:
+        (missingDecisions.length > 0 || pendingUserConfirmation) && isSupportedTarget(target)
+          ? listTargetWizardOptions(target)
+          : null,
       output_format: outputFormat,
       i18n: {
         default_locale: manifest.i18n?.default_locale ?? null,

package/schema/semantic-lint.ts

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { basename, join, resolve } from "node:path";
 import YAML from "yaml";
-import { listFiles } from "../drift/index.js";
+import { listFiles, readManifest } from "../drift/index.js";
 
 type UnknownRecord = Record<string, unknown>;
 
@@ -204,9 +204,7 @@ function collectIconRefs(filePath: string): { refs: Set<string>; suffixes: strin
   return { refs, suffixes };
 }
 
-function buildContext(projectDir: string, includes: Includes): SemanticContext {
-  const manifestPath = join(projectDir, "openuispec.yaml");
-  const manifest = loadYaml(manifestPath) as UnknownRecord;
+function buildContext(projectDir: string, includes: Includes, manifest: UnknownRecord): SemanticContext {
 
   const localeDir = resolve(projectDir, includes.locales);
   const localeFiles = new Map<string, Set<string>>();
@@ -589,8 +587,36 @@ function printSemanticErrors(label: string, errors: UsageLint[]): number {
   return errors.length;
 }
 
+export function collectSemanticLint(projectDir: string, includes: Includes): UsageLint[] {
+  const manifest = readManifest(projectDir) as UnknownRecord;
+  const context = buildContext(projectDir, includes, manifest);
+  const contractsDir = resolve(projectDir, includes.contracts);
+
+  const allErrors: UsageLint[] = [
+    ...lintLocaleCoverage(context),
+    ...lintManifestGenerationContext(projectDir, context.manifest),
+  ];
+
+  const files = [
+    join(projectDir, "openuispec.yaml"),
+    ...listFiles(resolve(projectDir, includes.screens), ".yaml"),
+    ...listFiles(resolve(projectDir, includes.flows), ".yaml"),
+    ...listFiles(resolve(projectDir, includes.platform), ".yaml"),
+    ...listFiles(resolve(projectDir, includes.contracts), ".yaml"),
+  ];
+
+  for (const filePath of files) {
+    allErrors.push(
+      ...lintFile(filePath, context, { validateTokens: !filePath.startsWith(contractsDir) })
+    );
+  }
+
+  return allErrors;
+}
+
 export function runSemanticLint(projectDir: string, includes: Includes): number {
-  const context = buildContext(projectDir, includes);
+  const manifest = readManifest(projectDir) as UnknownRecord;
+  const context = buildContext(projectDir, includes, manifest);
   let total = 0;
   const contractsDir = resolve(projectDir, includes.contracts);