specsmith 0.17.0.dev647__tar.gz → 0.17.1.dev651__tar.gz

{specsmith-0.17.0.dev647/src/specsmith.egg-info → specsmith-0.17.1.dev651}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.17.0.dev647
+Version: 0.17.1.dev651
 Summary: AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider.
 Author: Layer1Labs Silicon, Inc.
 License-Expression: MIT

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.17.0.dev647"
+version = "0.17.1.dev651"
 description = "AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider."
 readme = "README.md"
 license = "MIT"

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/__init__.py

@@ -8,4 +8,4 @@ from importlib.metadata import version as _pkg_version
 try:
     __version__: str = _pkg_version("specsmith")
 except PackageNotFoundError:  # running from source without install
-    __version__ = "0.17.0"  # fallback: keep in sync with pyproject.toml
+    __version__ = "0.17.1"  # fallback: keep in sync with pyproject.toml

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/ci_manager.py

@@ -157,11 +157,14 @@ class CiManager:
 
         import yaml
 
+        from specsmith.config import _normalize_scaffold_raw
+
         raw = yaml.safe_load(scaffold_path.read_text(encoding="utf-8")) or {}
+        raw = _normalize_scaffold_raw(raw)
         try:
             config = ProjectConfig(**raw)
         except Exception as exc:
-            raise RuntimeError(f"Invalid scaffold.yml: {exc}") from exc
+            raise RuntimeError(f"Invalid scaffold config: {exc}") from exc
 
         p_name = platform or _detect_platform(self.root)
         self._platform_name = p_name

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/cli.py

@@ -2935,16 +2935,20 @@ main.add_command(test)
 @click.option("--project-dir", type=click.Path(exists=True), default=".")
 def migrate(new_type: str, project_dir: str) -> None:
     """Change the project type and regenerate type-dependent files."""
+    from specsmith.config import _normalize_scaffold_raw
+    from specsmith.paths import find_scaffold
+
     root = Path(project_dir).resolve()
-    scaffold_path = root / "scaffold.yml"
+    scaffold_path = find_scaffold(root)
 
-    if not scaffold_path.exists():
-        console.print("[red]No scaffold.yml found.[/red]")
+    if not scaffold_path or not scaffold_path.exists():
+        console.print("[red]No scaffold config found (docs/SPECSMITH.yml or scaffold.yml).[/red]")
         raise SystemExit(1)
 
     with open(scaffold_path) as f:
         raw = yaml.safe_load(f)
 
+    raw = _normalize_scaffold_raw(raw or {})
     old_type = raw.get("type", "unknown")
     raw["type"] = new_type
 
@@ -3103,17 +3107,21 @@ def verify_release() -> None:
     help="Project root directory.",
 )
 def apply(project_dir: str) -> None:
-    """Regenerate CI and agent files from current scaffold.yml."""
+    """Regenerate CI and agent files from current scaffold config."""
+    from specsmith.config import _normalize_scaffold_raw
+    from specsmith.paths import find_scaffold
+
     root = Path(project_dir).resolve()
-    scaffold_path = root / "scaffold.yml"
+    scaffold_path = find_scaffold(root)
 
-    if not scaffold_path.exists():
-        console.print("[red]No scaffold.yml found.[/red]")
+    if not scaffold_path or not scaffold_path.exists():
+        console.print("[red]No scaffold config found (docs/SPECSMITH.yml or scaffold.yml).[/red]")
         raise SystemExit(1)
 
     with open(scaffold_path) as f:
         raw = yaml.safe_load(f)
 
+    raw = _normalize_scaffold_raw(raw or {})
     config = ProjectConfig(**raw)
     created: list[Path] = []
 
@@ -8032,19 +8040,21 @@ def tools_scan_cmd(project_dir: str, as_json: bool, fpga: bool) -> None:
 
     import yaml
 
-    from specsmith.config import ProjectConfig
+    from specsmith.config import ProjectConfig, _normalize_scaffold_raw
     from specsmith.doctor import _check_tool
+    from specsmith.paths import find_scaffold
 
     root = Path(project_dir).resolve()
-    scaffold_path = root / "scaffold.yml"
+    scaffold_path = find_scaffold(root)
 
     checks: list[dict] = []
 
     # Standard project tools via doctor
-    if scaffold_path.exists():
+    if scaffold_path and scaffold_path.exists():
         try:
             with open(scaffold_path) as f:
                 raw = yaml.safe_load(f) or {}
+            raw = _normalize_scaffold_raw(raw)
             config = ProjectConfig(**raw)
             from specsmith.tools import get_tools
 
@@ -8075,10 +8085,10 @@ def tools_scan_cmd(project_dir: str, as_json: bool, fpga: bool) -> None:
                     )
         except Exception as e:  # noqa: BLE001
             if not as_json:
-                console.print(f"[yellow]Could not read scaffold.yml: {e}[/yellow]")
+                console.print(f"[yellow]Could not read scaffold config: {e}[/yellow]")
 
     # FPGA/HDL tools from scaffold.yml fpga_tools list
-    if fpga and scaffold_path.exists():
+    if fpga and scaffold_path and scaffold_path.exists():
         try:
             with open(scaffold_path) as f:
                 raw = yaml.safe_load(f) or {}
@@ -8143,7 +8153,9 @@ def tools_scan_cmd(project_dir: str, as_json: bool, fpga: bool) -> None:
         return
 
     if not checks:
-        console.print("[yellow]No tools found. Does scaffold.yml exist?[/yellow]")
+        console.print(
+            "[yellow]No tools found. Does docs/SPECSMITH.yml (or scaffold.yml) exist?[/yellow]"
+        )
         return
 
     installed_count = sum(1 for c in checks if c["installed"])

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/config.py

@@ -141,7 +141,7 @@ class ProjectConfig(BaseModel):
         ),
     )
     language: str = Field(default="python", description="Primary language/runtime")
-    spec_version: str = Field(default="0.16.5", description="Spec version to scaffold from")
+    spec_version: str = Field(default="0.17.1", description="Spec version to scaffold from")
     description: str = Field(default="", description="Short project description")
 
     # Options
@@ -529,6 +529,27 @@ class ProjectConfig(BaseModel):
             return None
 
 
+# ---------------------------------------------------------------------------
+# Legacy key normalisation helper
+# ---------------------------------------------------------------------------
+
+
+def _normalize_scaffold_raw(raw: dict[str, Any]) -> dict[str, Any]:
+    """Normalise legacy scaffold YAML keys to the current schema.
+
+    Call this before ``ProjectConfig(**raw)`` whenever raw YAML is loaded from
+    disk so that projects created by older specsmith versions continue to parse
+    correctly after a key rename.
+
+    Migrations handled:
+    - ``project`` → ``name``  (renamed in specsmith ≤ 0.9)
+    """
+    if raw and "project" in raw and "name" not in raw:
+        raw = dict(raw)
+        raw["name"] = raw.pop("project")
+    return raw
+
+
 # Keys are str (ProjectType enum values) for compatibility now that config.type is str
 _TYPE_LABELS: dict[str, str] = {
     ProjectType.BACKEND_FRONTEND: "Python backend + web frontend",

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/differ.py

@@ -10,7 +10,8 @@ from pathlib import Path
 import yaml
 from jinja2 import Environment, PackageLoader, select_autoescape
 
-from specsmith.config import ProjectConfig
+from specsmith.config import ProjectConfig, _normalize_scaffold_raw
+from specsmith.paths import find_scaffold
 
 _GOVERNANCE_FILES: list[tuple[str, str]] = [
     ("governance/rules.md.j2", "docs/governance/RULES.md"),
@@ -28,17 +29,18 @@ def run_diff(root: Path) -> list[tuple[str, str]]:
 
     Returns list of (relative_path, status) where status is 'match', 'differs', or 'missing'.
     """
-    scaffold_path = root / "scaffold.yml"
-    if not scaffold_path.exists():
-        return [("scaffold.yml", "missing")]
+    scaffold_path = find_scaffold(root)
+    if not scaffold_path or not scaffold_path.exists():
+        return [("docs/SPECSMITH.yml", "missing")]
 
     with open(scaffold_path) as f:
         raw = yaml.safe_load(f)
 
+    raw = _normalize_scaffold_raw(raw or {})
     try:
         config = ProjectConfig(**raw)
     except Exception:
-        return [("scaffold.yml", "invalid")]
+        return [(scaffold_path.name, "invalid")]
 
     env = Environment(
         loader=PackageLoader("specsmith", "templates"),
@@ -116,17 +118,21 @@ def run_diff_html(root: Path) -> str:
     """Generate an HTML diff report with side-by-side views."""
     import difflib
 
-    scaffold_path = root / "scaffold.yml"
-    if not scaffold_path.exists():
-        return "<html><body><p>No scaffold.yml found.</p></body></html>"
+    scaffold_path = find_scaffold(root)
+    if not scaffold_path or not scaffold_path.exists():
+        return (
+            "<html><body><p>No scaffold config found"
+            " (docs/SPECSMITH.yml or scaffold.yml).</p></body></html>"
+        )
 
     with open(scaffold_path) as f:
         raw = yaml.safe_load(f)
 
+    raw = _normalize_scaffold_raw(raw or {})
     try:
         config = ProjectConfig(**raw)
     except Exception:
-        return "<html><body><p>Invalid scaffold.yml.</p></body></html>"
+        return "<html><body><p>Invalid scaffold config.</p></body></html>"
 
     from specsmith.tools import get_tools
 

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/doctor.py

@@ -118,7 +118,10 @@ def run_doctor(root: Path) -> DoctorReport:
     2. File-based heuristics for embedded/hardware/mobile/cloud projects.
     3. Always-available base tools (git, python3) surfaced for every project.
     """
-    scaffold_path = root / "scaffold.yml"
+    from specsmith.config import ProjectConfig, _normalize_scaffold_raw
+    from specsmith.paths import find_scaffold
+
+    scaffold_path = find_scaffold(root)
     report = DoctorReport()
 
     # Always check the absolute basics
@@ -126,15 +129,15 @@ def run_doctor(root: Path) -> DoctorReport:
         report.checks.append(_check_tool(exe, category, root=root))
 
     # Scaffold-driven checks
-    if scaffold_path.exists():
+    if scaffold_path and scaffold_path.exists():
         import yaml
 
-        from specsmith.config import ProjectConfig
         from specsmith.tools import get_tools
 
         try:
             with open(scaffold_path) as f:
                 raw = yaml.safe_load(f)
+            raw = _normalize_scaffold_raw(raw or {})
             config = ProjectConfig(**raw)
         except Exception:  # noqa: BLE001
             config = None

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/exporter.py

@@ -30,6 +30,9 @@ def run_export(root: Path) -> str:
 
         with open(scaffold_path) as f:
             raw = yaml.safe_load(f)
+        from specsmith.config import _normalize_scaffold_raw
+
+        raw = _normalize_scaffold_raw(raw or {})
         try:
             config = ProjectConfig(**raw)
             tools = get_tools(config)

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/profiles.py

@@ -306,8 +306,10 @@ def load_from_scaffold(project_dir: str) -> ExecutionProfile:
     except ImportError:
         return PROFILES[DEFAULT_PROFILE_NAME]
 
-    scaffold = Path(project_dir) / "scaffold.yml"
-    if not scaffold.exists():
+    from specsmith.paths import find_scaffold
+
+    scaffold = find_scaffold(Path(project_dir))
+    if not scaffold or not scaffold.exists():
         return PROFILES[DEFAULT_PROFILE_NAME]
 
     try:

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/updater.py

@@ -214,14 +214,14 @@ def run_migration(root: Path, *, dry_run: bool = False) -> list[str]:
         raw["spec_version"] = __version__
         with open(scaffold_path, "w") as f:
             yaml.dump(raw, f, default_flow_style=False, sort_keys=False)
-    actions.append("Updated scaffold.yml")
+    actions.append(f"Updated {scaffold_path.name}")
 
     # Regenerate governance templates
-    from specsmith.config import ProjectConfig
+    from specsmith.config import ProjectConfig, _normalize_scaffold_raw
     from specsmith.upgrader import run_upgrade
 
     try:
-        ProjectConfig(**raw)  # Validate config
+        ProjectConfig(**_normalize_scaffold_raw(raw))  # Validate config
         if not dry_run:
             result = run_upgrade(root, target_version=__version__)
             for updated_file in result.updated_files:

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/upgrader.py

@@ -125,10 +125,13 @@ def run_upgrade(
     with open(scaffold_path) as f:
         raw = yaml.safe_load(f)
 
+    from specsmith.config import _normalize_scaffold_raw
+
+    raw = _normalize_scaffold_raw(raw or {})
     try:
         config = ProjectConfig(**raw)
     except Exception as e:
-        return UpgradeResult(message=f"Invalid scaffold.yml: {e}")
+        return UpgradeResult(message=f"Invalid scaffold config: {e}")
 
     new_version = target_version or __version__
     old_version = config.spec_version

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/validator.py

@@ -84,20 +84,24 @@ _SLEEP_LOOP_CONTEXT = (
 
 
 def _check_scaffold_yml(root: Path) -> list[ValidationResult]:
-    """Check that scaffold.yml exists and is valid YAML."""
+    """Check that the scaffold config exists and is valid YAML."""
+    from specsmith.config import _normalize_scaffold_raw
+    from specsmith.paths import find_scaffold
+
     results: list[ValidationResult] = []
-    scaffold_path = root / "scaffold.yml"
+    scaffold_path = find_scaffold(root)
 
-    if not scaffold_path.exists():
+    if not scaffold_path or not scaffold_path.exists():
         results.append(
             ValidationResult(
                 name="scaffold-yml",
                 passed=True,
-                message="No scaffold.yml found (project may not have been created by specsmith)",
+                message="No scaffold config found (project may not have been created by specsmith)",
             )
         )
         return results
 
+    cfg_name = scaffold_path.name
     try:
         import yaml
 
@@ -108,31 +112,33 @@ def _check_scaffold_yml(root: Path) -> list[ValidationResult]:
                 ValidationResult(
                     name="scaffold-yml",
                     passed=False,
-                    message="scaffold.yml is not a valid YAML mapping",
-                )
-            )
-        elif "name" not in data or "type" not in data:
-            results.append(
-                ValidationResult(
-                    name="scaffold-yml",
-                    passed=False,
-                    message="scaffold.yml missing required fields: name, type",
+                    message=f"{cfg_name} is not a valid YAML mapping",
                 )
             )
         else:
-            results.append(
-                ValidationResult(
-                    name="scaffold-yml",
-                    passed=True,
-                    message=f"scaffold.yml valid: project={data['name']}, type={data['type']}",
+            data = _normalize_scaffold_raw(data)
+            if "name" not in data or "type" not in data:
+                results.append(
+                    ValidationResult(
+                        name="scaffold-yml",
+                        passed=False,
+                        message=f"{cfg_name} missing required fields: name, type",
+                    )
+                )
+            else:
+                results.append(
+                    ValidationResult(
+                        name="scaffold-yml",
+                        passed=True,
+                        message=f"{cfg_name} valid: project={data['name']}, type={data['type']}",
+                    )
                 )
-            )
     except Exception as e:
         results.append(
             ValidationResult(
                 name="scaffold-yml",
                 passed=False,
-                message=f"scaffold.yml parse error: {e}",
+                message=f"{cfg_name} parse error: {e}",
             )
         )
 

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/src/specsmith/vcs_commands.py

@@ -145,8 +145,10 @@ def run_push(root: Path, *, force: bool = False) -> GitResult:
         return GitResult(success=False, message="Not on any branch")
 
     # Safety: check branching strategy
-    scaffold_path = root / "scaffold.yml"
-    if scaffold_path.exists() and not force:
+    from specsmith.paths import find_scaffold
+
+    scaffold_path = find_scaffold(root)
+    if scaffold_path and scaffold_path.exists() and not force:
         with open(scaffold_path) as f:
             raw = yaml.safe_load(f) or {}
         strategy = raw.get("branching_strategy", "gitflow")
@@ -215,7 +217,7 @@ def run_sync(root: Path) -> GitResult:
 
     # Check if governance files were in the pull.
     # Use ORIG_HEAD (set by git pull) rather than HEAD~1 — works even on first pull.
-    gov_files = ["AGENTS.md", "LEDGER.md", "scaffold.yml", "docs/governance/"]
+    gov_files = ["AGENTS.md", "LEDGER.md", "scaffold.yml", "docs/SPECSMITH.yml", "docs/governance/"]
     warnings: list[str] = []
     diff_result = _run_git(root, ["diff", "--name-only", "ORIG_HEAD..HEAD"])
     if diff_result.success:
@@ -310,11 +312,13 @@ def create_pr(
     """Create a PR via platform CLI with governance context."""
     import yaml
 
-    scaffold_path = root / "scaffold.yml"
+    from specsmith.paths import find_scaffold
+
+    scaffold_path = find_scaffold(root)
     platform = "github"
     base_branch = "develop"
 
-    if scaffold_path.exists():
+    if scaffold_path and scaffold_path.exists():
         with open(scaffold_path) as f:
             raw = yaml.safe_load(f) or {}
         platform = raw.get("vcs_platform", "github")

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.17.0.dev647
+Version: 0.17.1.dev651
 Summary: AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider.
 Author: Layer1Labs Silicon, Inc.
 License-Expression: MIT

{specsmith-0.17.0.dev647 → specsmith-0.17.1.dev651}/tests/test_cli.py

@@ -112,6 +112,8 @@ class TestCLIUpgrade:
         assert "Already at spec version" in result.output
 
     def test_upgrade_to_new_version(self, tmp_path: Path) -> None:
+        from specsmith import __version__
+
         target = _scaffold_governed(tmp_path)
         # Backdate spec_version so there is an actual upgrade to perform.
         # Without this the scaffold is already at __version__ and the
@@ -124,14 +126,14 @@ class TestCLIUpgrade:
             yaml.dump(data, fh, default_flow_style=False)
         runner = CliRunner()
         result = runner.invoke(
-            main, ["upgrade", "--project-dir", str(target), "--spec-version", "0.16.5"]
+            main, ["upgrade", "--project-dir", str(target), "--spec-version", __version__]
         )
         assert result.exit_code == 0
         assert "Upgraded" in result.output
         # Verify scaffold.yml spec_version was updated to the target version
         with open(target / "scaffold.yml") as fh:
             data = yaml.safe_load(fh)
-        assert data["spec_version"] == "0.16.5"
+        assert data["spec_version"] == __version__
 
 
 class TestCLICreditsLimits: