feat: add docgen init wizard for project scaffolding

New `docgen init` command interactively scaffolds a project with:
- docgen.yaml configuration tailored to the project
- Wrapper shell scripts (generate-all.sh, compose.sh, etc.)
- Directory structure (narration/, audio/, animations/, terminal/, recordings/)
- Starter narration files for each segment
- Optional pre-push validation hook via pre-commit
- narration/README.md with voice-first editing tips

The wizard auto-detects git root, scans for existing narration files
to infer segments, and preserves any files already present. Generated
config is immediately usable with all docgen commands.

12 unit tests cover detection, scanning, generation, and edge cases.

Made-with: Cursor

Author: jmjava

src/docgen/cli.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import os
+from pathlib import Path
 
 import click
 
@@ -39,6 +40,22 @@ def main(ctx: click.Context, config_path: str | None) -> None:
     _load_env(cfg)
 
 
+@main.command()
+@click.argument("target_dir", required=False, default=None, type=click.Path())
+@click.pass_context
+def init(ctx: click.Context, target_dir: str | None) -> None:
+    """Scaffold a new project: docgen.yaml, wrapper scripts, directories.
+
+    Optionally pass a target directory (defaults to current directory).
+    """
+    from docgen.init import generate_files, print_summary, run_wizard
+
+    target = Path(target_dir).resolve() if target_dir else None
+    plan = run_wizard(target_dir=target)
+    created = generate_files(plan)
+    print_summary(plan, created)
+
+
 @main.command()
 @click.option("--port", default=8501, help="Port for the wizard web server.")
 @click.pass_context