devconfig-gen-singbox 2.1.0__tar.gz → 2.1.2__tar.gz

{devconfig_gen_singbox-2.1.0 → devconfig_gen_singbox-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devconfig_gen_singbox
-Version: 2.1.0
+Version: 2.1.2
 Summary: Provider-based developer configuration generation engine and CLI
 Author-email: henryliu443 <henryliu443@gmail.com>
 License-Expression: Apache-2.0
@@ -28,7 +28,7 @@ Dynamic: license-file
 > **A sing-box domain implementation built on top of DevConfig-Gen.**
 > **构建在 `DevConfig-Gen` 之上的 sing-box 领域实现（child / fork）。**
 
-[![Version](https://img.shields.io/badge/version-2.1.0-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.1.2-blue.svg)](CHANGELOG.md)
 [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 ![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue.svg)
 ![Tests](https://img.shields.io/badge/tests-136%20passing-brightgreen.svg)
@@ -62,7 +62,7 @@ devconfig_gen_singbox
 git clone https://github.com/henryliu443/devconfig_gen_singbox.git
 cd devconfig_gen_singbox
 pip install -e ".[yaml]"
-devconfig-gen generate --provider singbox --input examples/singbox.yaml --output-dir dist
+devconfig_gen_singbox generate --provider singbox --input examples/singbox.yaml --output-dir dist
 ```
 
 未安装时亦可直接通过源码运行：
@@ -226,9 +226,9 @@ options:
 ## 输入示例 / Input Example
 
 ```bash
-devconfig-gen generate --provider singbox --input examples/singbox.yaml --output-dir dist
-devconfig-gen validate --provider singbox --input examples/singbox.yaml
-devconfig-gen schema   --provider singbox
+devconfig_gen_singbox generate --provider singbox --input examples/singbox.yaml --output-dir dist
+devconfig_gen_singbox validate --provider singbox --input examples/singbox.yaml
+devconfig_gen_singbox schema   --provider singbox
 ```
 
 完整 context 见 [`examples/singbox.yaml`](examples/singbox.yaml)。
@@ -281,13 +281,14 @@ singbox-ops destroy --plan examples/singbox-deploy.yaml
 - 结构化校验与诊断（`Diagnostic` / `ValidationError`）
 - JSON/YAML 序列化（标准库 + 可选 PyYAML，内置子集解析器兜底）
 - 多源合并与 dotted-path 覆盖（`deep_merge`、`--set`）
-- CLI 与 Python API
+- CLI、**终端向导**（`devconfig_gen_singbox init`）、**本地 Web 工作台**
+  （`devconfig_gen_singbox ui`）与 Python API
 
 同时也继承中立的 Provider `custom` / `json` / `env`。本仓库在其之上新增领域
 Provider `singbox`：
 
 ```bash
-devconfig-gen providers
+devconfig_gen_singbox providers
 # custom / env / json / singbox
 ```
 
@@ -298,9 +299,15 @@ devconfig-gen providers
 
 ```bash
 # 生成 / 校验 / 查看 schema
-devconfig-gen generate --provider singbox --input examples/singbox.yaml --output-dir dist --format yaml
-devconfig-gen validate --provider singbox --input examples/singbox.yaml --json
-devconfig-gen schema   --provider singbox
+devconfig_gen_singbox generate --provider singbox --input examples/singbox.yaml --output-dir dist --format yaml
+devconfig_gen_singbox validate --provider singbox --input examples/singbox.yaml --json
+devconfig_gen_singbox schema   --provider singbox
+
+# 交互式终端向导（所有 provider 通用，含 singbox）
+devconfig_gen_singbox init --provider singbox --output-dir dist
+
+# 本地 Web 工作台（零构建，标准库 http.server）
+devconfig_gen_singbox ui --port 8848
 ```
 
 ```python
@@ -348,6 +355,8 @@ generate_pipeline(
 | 校验与诊断 | [`docs/validation.md`](docs/validation.md) | [validation](https://henryliu443.github.io/DevConfig-Gen/docs/validation/) |
 | Provider 开发 | [`docs/providers.md`](docs/providers.md) | [providers](https://henryliu443.github.io/DevConfig-Gen/docs/providers/) |
 | Python API | [`docs/python-api.md`](docs/python-api.md) | [python-api](https://henryliu443.github.io/DevConfig-Gen/docs/python-api/) |
+| 终端向导 | [`docs/wizard.md`](docs/wizard.md) | [wizard](https://henryliu443.github.io/DevConfig-Gen/docs/wizard/) |
+| Web 工作台 | [`docs/web-ui.md`](docs/web-ui.md) | [web-ui](https://henryliu443.github.io/DevConfig-Gen/docs/web-ui/) |
 | 架构总览 | [`ARCHITECTURE.md`](ARCHITECTURE.md) | — |
 | Provider 铁标准 | [`PROVIDER_STANDARD.md`](PROVIDER_STANDARD.md) | — |
 

{devconfig_gen_singbox-2.1.0 → devconfig_gen_singbox-2.1.2}/README.md

@@ -3,7 +3,7 @@
 > **A sing-box domain implementation built on top of DevConfig-Gen.**
 > **构建在 `DevConfig-Gen` 之上的 sing-box 领域实现（child / fork）。**
 
-[![Version](https://img.shields.io/badge/version-2.1.0-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.1.2-blue.svg)](CHANGELOG.md)
 [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 ![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue.svg)
 ![Tests](https://img.shields.io/badge/tests-136%20passing-brightgreen.svg)
@@ -37,7 +37,7 @@ devconfig_gen_singbox
 git clone https://github.com/henryliu443/devconfig_gen_singbox.git
 cd devconfig_gen_singbox
 pip install -e ".[yaml]"
-devconfig-gen generate --provider singbox --input examples/singbox.yaml --output-dir dist
+devconfig_gen_singbox generate --provider singbox --input examples/singbox.yaml --output-dir dist
 ```
 
 未安装时亦可直接通过源码运行：
@@ -201,9 +201,9 @@ options:
 ## 输入示例 / Input Example
 
 ```bash
-devconfig-gen generate --provider singbox --input examples/singbox.yaml --output-dir dist
-devconfig-gen validate --provider singbox --input examples/singbox.yaml
-devconfig-gen schema   --provider singbox
+devconfig_gen_singbox generate --provider singbox --input examples/singbox.yaml --output-dir dist
+devconfig_gen_singbox validate --provider singbox --input examples/singbox.yaml
+devconfig_gen_singbox schema   --provider singbox
 ```
 
 完整 context 见 [`examples/singbox.yaml`](examples/singbox.yaml)。
@@ -256,13 +256,14 @@ singbox-ops destroy --plan examples/singbox-deploy.yaml
 - 结构化校验与诊断（`Diagnostic` / `ValidationError`）
 - JSON/YAML 序列化（标准库 + 可选 PyYAML，内置子集解析器兜底）
 - 多源合并与 dotted-path 覆盖（`deep_merge`、`--set`）
-- CLI 与 Python API
+- CLI、**终端向导**（`devconfig_gen_singbox init`）、**本地 Web 工作台**
+  （`devconfig_gen_singbox ui`）与 Python API
 
 同时也继承中立的 Provider `custom` / `json` / `env`。本仓库在其之上新增领域
 Provider `singbox`：
 
 ```bash
-devconfig-gen providers
+devconfig_gen_singbox providers
 # custom / env / json / singbox
 ```
 
@@ -273,9 +274,15 @@ devconfig-gen providers
 
 ```bash
 # 生成 / 校验 / 查看 schema
-devconfig-gen generate --provider singbox --input examples/singbox.yaml --output-dir dist --format yaml
-devconfig-gen validate --provider singbox --input examples/singbox.yaml --json
-devconfig-gen schema   --provider singbox
+devconfig_gen_singbox generate --provider singbox --input examples/singbox.yaml --output-dir dist --format yaml
+devconfig_gen_singbox validate --provider singbox --input examples/singbox.yaml --json
+devconfig_gen_singbox schema   --provider singbox
+
+# 交互式终端向导（所有 provider 通用，含 singbox）
+devconfig_gen_singbox init --provider singbox --output-dir dist
+
+# 本地 Web 工作台（零构建，标准库 http.server）
+devconfig_gen_singbox ui --port 8848
 ```
 
 ```python
@@ -323,6 +330,8 @@ generate_pipeline(
 | 校验与诊断 | [`docs/validation.md`](docs/validation.md) | [validation](https://henryliu443.github.io/DevConfig-Gen/docs/validation/) |
 | Provider 开发 | [`docs/providers.md`](docs/providers.md) | [providers](https://henryliu443.github.io/DevConfig-Gen/docs/providers/) |
 | Python API | [`docs/python-api.md`](docs/python-api.md) | [python-api](https://henryliu443.github.io/DevConfig-Gen/docs/python-api/) |
+| 终端向导 | [`docs/wizard.md`](docs/wizard.md) | [wizard](https://henryliu443.github.io/DevConfig-Gen/docs/wizard/) |
+| Web 工作台 | [`docs/web-ui.md`](docs/web-ui.md) | [web-ui](https://henryliu443.github.io/DevConfig-Gen/docs/web-ui/) |
 | 架构总览 | [`ARCHITECTURE.md`](ARCHITECTURE.md) | — |
 | Provider 铁标准 | [`PROVIDER_STANDARD.md`](PROVIDER_STANDARD.md) | — |
 

{devconfig_gen_singbox-2.1.0 → devconfig_gen_singbox-2.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devconfig_gen_singbox"
-version = "2.1.0"
+version = "2.1.2"
 authors = [
   { name = "henryliu443", email = "henryliu443@gmail.com" },
 ]
@@ -26,9 +26,8 @@ dev = ["build", "wheel", "PyYAML>=5.1", "cryptography>=3.4"]
 docs = ["mkdocs-material>=9.5,<10"]
 
 [project.scripts]
-devconfig-gen = "devconfig_gen.cli:main"
+# One command, named exactly after the PyPI distribution.
 devconfig_gen_singbox = "devconfig_gen.cli:main"
-singbox-ops = "singbox_ops.cli:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]

{devconfig_gen_singbox-2.1.0 → devconfig_gen_singbox-2.1.2}/src/devconfig_gen/__init__.py

@@ -32,6 +32,7 @@ from .models import (
     GenerationResult,
     ProviderField,
     ProviderStep,
+    WebUIWidgets,
 )
 from .registry import ProviderRegistry, default_registry
 from .validation import ValidationError
@@ -47,6 +48,7 @@ __all__ = [
     "ProviderRegistry",
     "ProviderStep",
     "ValidationError",
+    "WebUIWidgets",
     "build_request",
     "coerce_scalar",
     "deep_merge",
@@ -64,4 +66,4 @@ __all__ = [
     "loads",
     "validate_request",
 ]
-__version__ = "2.1.0"
+__version__ = "2.1.2"

{devconfig_gen_singbox-2.1.0 → devconfig_gen_singbox-2.1.2}/src/devconfig_gen/cli.py

@@ -14,7 +14,7 @@ from .registry import default_registry
 
 def build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
-        prog="devconfig-gen",
+        prog="devconfig_gen_singbox",
         description="Generate and validate structured JSON/YAML configuration.",
     )
     parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
@@ -74,9 +74,51 @@ def build_parser() -> argparse.ArgumentParser:
     schema_cmd.add_argument("--provider", default="json", help="Provider name (default: json)")
     schema_cmd.set_defaults(handler=_schema)
 
+    init_cmd = sub.add_parser(
+        "init",
+        help="Run interactive terminal wizard to create configuration",
+        description="Run interactive terminal wizard to create configuration.",
+    )
+    init_cmd.add_argument("--provider", default="custom", help="Provider name (default: custom)")
+    init_cmd.add_argument("--input", type=Path, help="Optional existing config file to pre-fill wizard")
+    init_cmd.add_argument("--output-dir", default=".", type=Path, help="Directory for generated artifact")
+    init_cmd.add_argument("--format", choices=("json", "yaml"), help="Output format override")
+    init_cmd.set_defaults(handler=_init)
+
+    ui_cmd = sub.add_parser(
+        "ui",
+        help="Launch local configuration studio WebUI",
+        description="Launch local configuration studio WebUI.",
+    )
+    ui_cmd.add_argument("--host", default="127.0.0.1", help="Host address (default: 127.0.0.1)")
+    ui_cmd.add_argument("--port", default=8848, type=int, help="Port to bind (default: 8848)")
+    ui_cmd.add_argument("--no-browser", action="store_true", help="Do not automatically open browser")
+    ui_cmd.add_argument(
+        "--workspace",
+        default=None,
+        help="Directory the studio may export into (default: current directory)",
+    )
+    ui_cmd.set_defaults(handler=_ui)
+
+    _register_ops_subparsers(sub)
+
     return parser
 
 
+def _register_ops_subparsers(sub) -> None:
+    """Graft the optional ``singbox_ops`` subcommands onto this single CLI.
+
+    ``singbox_ops`` is imported lazily, so importing ``devconfig_gen`` stays
+    side-effect free and the pure engine works even without the ops package.
+    """
+
+    try:
+        from singbox_ops.cli import add_subparsers
+    except Exception:  # pragma: no cover - ops layer is optional
+        return
+    add_subparsers(sub)
+
+
 def _list_providers(args) -> int:
     for name in default_registry.names():
         print(name)
@@ -154,6 +196,30 @@ def _schema(args) -> int:
     return 0
 
 
+def _init(args) -> int:
+    from .interactive import run_interactive_wizard
+
+    input_path = str(args.input) if args.input else None
+    return run_interactive_wizard(
+        args.provider,
+        input_path=input_path,
+        output_dir=str(args.output_dir),
+        output_format=args.format,
+    )
+
+
+def _ui(args) -> int:
+    from .web_ui import run_web_ui
+
+    run_web_ui(
+        host=args.host,
+        port=args.port,
+        open_browser=not args.no_browser,
+        workspace_root=args.workspace,
+    )
+    return 0
+
+
 def main(argv=None) -> int:
     args = build_parser().parse_args(argv)
     return args.handler(args)

devconfig_gen_singbox-2.1.2/src/devconfig_gen/interactive.py

@@ -0,0 +1,377 @@
+"""Interactive terminal wizard for generating configuration.
+
+Designed for headless environments (e.g. Linux SSH servers or terminal-first
+workflows on macOS). Driven entirely by the provider's declarative steps and
+schema metadata, so there is no duplication with the core engine or the WebUI.
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+from typing import Any, Dict, Optional, Sequence, TextIO
+
+from . import formats
+from .engine import describe_provider, diagnose_request, generate
+from .models import GenerationRequest, ProviderField, ProviderStep
+from .registry import ProviderRegistry, default_registry
+
+
+class _EndOfInput(Exception):
+    """Raised when the input stream ends before a required answer is given."""
+
+    def __init__(self, field_name: str):
+        super().__init__(field_name)
+        self.field_name = field_name
+
+
+def _set_dotted_path(target: Dict[str, Any], path: str, value: Any) -> None:
+    """Set a value in a nested dict using a dotted path like 'app.port'."""
+
+    parts = path.split(".")
+    current = target
+    for part in parts[:-1]:
+        if part not in current or not isinstance(current[part], dict):
+            current[part] = {}
+        current = current[part]
+    current[parts[-1]] = value
+
+
+def _get_dotted_path(source: Any, path: str, default: Any = None) -> Any:
+    """Retrieve a value from a nested dict using a dotted path."""
+
+    if not isinstance(source, dict):
+        return default
+    current: Any = source
+    for part in path.split("."):
+        if not isinstance(current, dict) or part not in current:
+            return default
+        current = current[part]
+    return current
+
+
+def _read_line(reader: TextIO, writer: TextIO, prompt: str) -> Optional[str]:
+    """Write ``prompt`` and read one line.
+
+    Returns the stripped line, or ``None`` when the stream is exhausted. A blank
+    line (``"\\n"``) is distinct from end-of-input (``""``).
+    """
+
+    writer.write(prompt)
+    writer.flush()
+    line = reader.readline()
+    if line == "":
+        return None
+    return line.strip()
+
+
+def _prompt_string(
+    field: ProviderField,
+    current_value: Any,
+    reader: TextIO,
+    writer: TextIO,
+) -> Any:
+    effective_default = current_value if current_value is not None else field.default
+    default_str = f" [{effective_default}]" if effective_default is not None else ""
+    req_str = " (required)" if field.required and effective_default is None else ""
+
+    if field.choices:
+        writer.write(f"? {field.name} - Select option:{req_str}\n")
+        for i, choice in enumerate(field.choices, 1):
+            writer.write(f"    {i}) {choice}\n")
+        lower_choices = {str(c).lower(): c for c in field.choices}
+        while True:
+            answer = _read_line(reader, writer, f"  Enter choice number or name{default_str}: ")
+            if answer is None:
+                if effective_default is not None:
+                    return effective_default
+                raise _EndOfInput(field.name)
+            if answer == "":
+                if effective_default is not None:
+                    return effective_default
+                if field.required:
+                    writer.write("  [!] Selection is required. Please choose an option.\n")
+                    continue
+                return None
+            if answer.isdigit():
+                idx = int(answer) - 1
+                if 0 <= idx < len(field.choices):
+                    return field.choices[idx]
+            if answer.lower() in lower_choices:
+                return lower_choices[answer.lower()]
+            writer.write(
+                f"  [!] Invalid choice: {answer!r}. Please select 1-{len(field.choices)}.\n"
+            )
+
+    while True:
+        answer = _read_line(reader, writer, f"? {field.name}{req_str}{default_str}: ")
+        if answer is None:
+            if effective_default is not None:
+                return effective_default
+            raise _EndOfInput(field.name)
+        if answer == "":
+            if effective_default is not None:
+                return effective_default
+            if field.required:
+                writer.write("  [!] This field is required.\n")
+                continue
+            return None
+        return answer
+
+
+def _prompt_integer(
+    field: ProviderField,
+    current_value: Any,
+    reader: TextIO,
+    writer: TextIO,
+) -> Any:
+    effective_default = current_value if current_value is not None else field.default
+    default_str = f" [{effective_default}]" if effective_default is not None else ""
+    bounds = []
+    if field.minimum is not None:
+        bounds.append(f"min {int(field.minimum)}")
+    if field.maximum is not None:
+        bounds.append(f"max {int(field.maximum)}")
+    bound_str = f" ({', '.join(bounds)})" if bounds else ""
+    req_str = " (required)" if field.required and effective_default is None else ""
+
+    while True:
+        answer = _read_line(reader, writer, f"? {field.name}{bound_str}{req_str}{default_str}: ")
+        if answer is None:
+            if effective_default is not None:
+                return effective_default
+            raise _EndOfInput(field.name)
+        if answer == "":
+            if effective_default is not None:
+                return effective_default
+            if field.required:
+                writer.write("  [!] An integer value is required.\n")
+                continue
+            return None
+        try:
+            number = int(answer)
+        except ValueError:
+            writer.write(f"  [!] Expected integer, got {answer!r}.\n")
+            continue
+        if field.minimum is not None and number < field.minimum:
+            writer.write(f"  [!] Value must be >= {int(field.minimum)}.\n")
+            continue
+        if field.maximum is not None and number > field.maximum:
+            writer.write(f"  [!] Value must be <= {int(field.maximum)}.\n")
+            continue
+        return number
+
+
+def _prompt_boolean(
+    field: ProviderField,
+    current_value: Any,
+    reader: TextIO,
+    writer: TextIO,
+) -> bool:
+    effective_default = bool(current_value if current_value is not None else field.default)
+    prompt_hint = "[Y/n]" if effective_default else "[y/N]"
+    while True:
+        answer = _read_line(reader, writer, f"? {field.name} {prompt_hint}: ")
+        if answer is None or answer == "":
+            return effective_default
+        lowered = answer.lower()
+        if lowered in ("y", "yes", "true", "1"):
+            return True
+        if lowered in ("n", "no", "false", "0"):
+            return False
+        writer.write("  [!] Please enter 'y' for yes or 'n' for no.\n")
+
+
+def _prompt_mapping(
+    field: ProviderField,
+    current_value: Any,
+    reader: TextIO,
+    writer: TextIO,
+) -> Dict[str, str]:
+    mapping: Dict[str, str] = dict(current_value) if isinstance(current_value, dict) else {}
+    writer.write(
+        f"? {field.name} (enter key=value pairs, press enter on empty line to finish):\n"
+    )
+    if mapping:
+        writer.write(
+            "    Current entries: " + ", ".join(f"{k}={v}" for k, v in mapping.items()) + "\n"
+        )
+    while True:
+        answer = _read_line(reader, writer, "    key=val (or empty to finish): ")
+        if answer is None or answer == "":
+            break
+        if "=" not in answer:
+            writer.write("    [!] Invalid format. Must be key=value.\n")
+            continue
+        key, value = answer.split("=", 1)
+        mapping[key.strip()] = value.strip()
+    return mapping
+
+
+def _prompt_document(
+    field: ProviderField,
+    current_value: Any,
+    reader: TextIO,
+    writer: TextIO,
+) -> Any:
+    writer.write(f"? {field.name} (load document file or enter entries):\n")
+    path_str = _read_line(
+        reader, writer, "    Path to JSON/YAML file (or press enter for key=value input): "
+    )
+    if path_str:
+        file_path = Path(path_str).expanduser()
+        if file_path.is_file():
+            try:
+                loaded = formats.load_file(file_path)
+                writer.write(f"    [✓] Loaded document from {file_path}\n")
+                return loaded
+            except Exception as exc:
+                writer.write(f"    [!] Error reading {file_path}: {exc}\n")
+        else:
+            writer.write(f"    [!] File not found: {path_str}\n")
+    return _prompt_mapping(field, current_value, reader, writer)
+
+
+def prompt_field(
+    field: ProviderField,
+    current_value: Any,
+    reader: TextIO,
+    writer: TextIO,
+) -> Any:
+    """Prompt the user for a single field's value based on its type."""
+
+    if field.type == "integer":
+        return _prompt_integer(field, current_value, reader, writer)
+    if field.type == "boolean":
+        return _prompt_boolean(field, current_value, reader, writer)
+    if field.type in ("mapping", "dict"):
+        return _prompt_mapping(field, current_value, reader, writer)
+    if field.type in ("document", "tree"):
+        return _prompt_document(field, current_value, reader, writer)
+    return _prompt_string(field, current_value, reader, writer)
+
+
+def run_interactive_wizard(
+    provider_name: str,
+    *,
+    input_path: Optional[str] = None,
+    context: Optional[Dict[str, Any]] = None,
+    output_dir: Optional[str] = None,
+    output_format: Optional[str] = None,
+    registry: Optional[ProviderRegistry] = None,
+    reader: Optional[TextIO] = None,
+    writer: Optional[TextIO] = None,
+) -> int:
+    """Execute the interactive wizard loop in the terminal.
+
+    ``context`` seeds the wizard with existing answers. ``input_path`` loads a
+    document from disk and merges it on top of ``context``. On validation
+    failure the wizard offers to re-run while keeping every answer pre-filled.
+
+    Returns ``0`` on successful generation and ``1`` on cancellation or error.
+    """
+
+    in_stream = reader or sys.stdin
+    out_stream = writer or sys.stdout
+
+    reg = registry or default_registry
+    try:
+        reg.get(provider_name)
+    except ValueError as exc:
+        out_stream.write(f"Error: {exc}\n")
+        return 1
+
+    steps: Sequence[ProviderStep] = describe_provider(provider_name, registry=reg)
+    if not steps:
+        out_stream.write(
+            f"Provider '{provider_name}' does not define declarative wizard steps.\n"
+        )
+        return 1
+
+    working: Dict[str, Any] = dict(context) if context else {}
+    if input_path:
+        try:
+            loaded = formats.load_file(input_path)
+        except Exception as exc:
+            out_stream.write(f"[warn] Could not load initial context: {exc}\n")
+        else:
+            if isinstance(loaded, dict):
+                working.update(loaded)
+                out_stream.write(f"[info] Pre-populated wizard with values from {input_path}\n")
+            else:
+                out_stream.write(
+                    f"[warn] {input_path} does not contain a mapping; ignoring it.\n"
+                )
+
+    out_stream.write("========================================================\n")
+    out_stream.write(f"  DevConfig-Gen Interactive Wizard: '{provider_name}'\n")
+    out_stream.write("  Answer the prompts below. Press Enter to use defaults.\n")
+    out_stream.write("========================================================\n")
+
+    total_steps = len(steps)
+    while True:
+        try:
+            for step_idx, step in enumerate(steps, 1):
+                out_stream.write(f"\n--- [{step_idx}/{total_steps}] {step.title} ---\n")
+                if step.description:
+                    out_stream.write(f"  {step.description}\n")
+                for field in step.fields:
+                    existing = _get_dotted_path(working, field.name)
+                    value = prompt_field(field, existing, in_stream, out_stream)
+                    if value is not None:
+                        _set_dotted_path(working, field.name, value)
+        except _EndOfInput as exc:
+            out_stream.write(
+                f"\n[!] Input ended before '{exc.field_name}' was provided. Aborting.\n"
+            )
+            return 1
+
+        out_stream.write("\nValidating configuration...\n")
+        diagnostics = diagnose_request(provider_name, context=working, registry=reg)
+        errors = [item for item in diagnostics if item.severity == "error"]
+        if not errors:
+            break
+
+        out_stream.write("\n[!] Validation found errors:\n")
+        for err in errors:
+            out_stream.write(f"  - {err.field}: {err.message}\n")
+
+        answer = _read_line(
+            in_stream,
+            out_stream,
+            "Re-run the wizard to correct these? [Y/n]: ",
+        )
+        if answer is None or answer.lower() in ("n", "no"):
+            out_stream.write("Aborted.\n")
+            return 1
+        out_stream.write("\nRe-running wizard with your previous answers pre-filled...\n")
+
+    out_stream.write("[✓] All validations passed!\n\n")
+
+    selected_format = output_format
+    if not selected_format:
+        answer = _read_line(
+            in_stream,
+            out_stream,
+            "Select output format (1: YAML [default], 2: JSON): ",
+        )
+        selected_format = "json" if answer == "2" else "yaml"
+
+    target_dir = output_dir or "."
+    out_stream.write(f"Writing configuration to '{target_dir}'...\n")
+
+    try:
+        result = generate(
+            provider_name,
+            GenerationRequest(context=working, options={"format": selected_format}),
+            registry=reg,
+            output_dir=target_dir,
+        )
+    except Exception as exc:
+        out_stream.write(f"[!] Generation failed: {exc}\n")
+        return 1
+
+    for artifact in result.artifacts:
+        out_path = Path(target_dir) / artifact.name
+        out_stream.write(f"[✓] Generated artifact: {out_path.resolve()}\n")
+    return 0