specsmith 0.3.0a1.dev8__tar.gz → 0.3.0.dev16__tar.gz

{specsmith-0.3.0a1.dev8/src/specsmith.egg-info → specsmith-0.3.0.dev16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.3.0a1.dev8
+Version: 0.3.0.dev16
 Summary: Applied Epistemic Engineering toolkit — forge epistemically-governed scaffolds, stress-test belief systems, and run AEE pipelines.
 Author: BitConcepts
 License: MIT
@@ -64,8 +64,7 @@ Dynamic: license-file
 
 [![CI](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml/badge.svg)](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml)
 [![Docs](https://readthedocs.org/projects/specsmith/badge/?version=stable)](https://specsmith.readthedocs.io/en/stable/)
-[![PyPI Stable](https://img.shields.io/pypi/v/specsmith?label=stable&style=flat&color=blue&cacheSeconds=60)](https://pypi.org/project/specsmith/)
-[![PyPI Dev](https://img.shields.io/pypi/v/specsmith?include_prereleases=true&label=dev&style=flat&color=orange&cacheSeconds=60)](https://pypi.org/project/specsmith/#history)
+[![PyPI](https://img.shields.io/pypi/v/specsmith?label=stable&style=flat&color=blue&cacheSeconds=60)](https://pypi.org/project/specsmith/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 

{specsmith-0.3.0a1.dev8 → specsmith-0.3.0.dev16}/README.md

@@ -2,8 +2,7 @@
 
 [![CI](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml/badge.svg)](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml)
 [![Docs](https://readthedocs.org/projects/specsmith/badge/?version=stable)](https://specsmith.readthedocs.io/en/stable/)
-[![PyPI Stable](https://img.shields.io/pypi/v/specsmith?label=stable&style=flat&color=blue&cacheSeconds=60)](https://pypi.org/project/specsmith/)
-[![PyPI Dev](https://img.shields.io/pypi/v/specsmith?include_prereleases=true&label=dev&style=flat&color=orange&cacheSeconds=60)](https://pypi.org/project/specsmith/#history)
+[![PyPI](https://img.shields.io/pypi/v/specsmith?label=stable&style=flat&color=blue&cacheSeconds=60)](https://pypi.org/project/specsmith/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 

{specsmith-0.3.0a1.dev8 → specsmith-0.3.0.dev16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.3.0a1.dev8"
+version = "0.3.0.dev16"
 description = "Applied Epistemic Engineering toolkit — forge epistemically-governed scaffolds, stress-test belief systems, and run AEE pipelines."
 readme = "README.md"
 license = {text = "MIT"}

{specsmith-0.3.0a1.dev8 → specsmith-0.3.0.dev16}/src/epistemic/__init__.py

@@ -143,7 +143,7 @@ from epistemic.recovery import RecoveryOperator, RecoveryProposal, RecoveryStrat
 from epistemic.session import AEEResult, AEESession
 from epistemic.stress_tester import StressTester, StressTestResult
 
-__version__ = "0.3.0a1"
+__version__ = "0.3.0"
 
 __all__ = [
     # Session facade (primary entry point)

{specsmith-0.3.0a1.dev8 → specsmith-0.3.0.dev16}/src/specsmith/auditor.py

@@ -182,7 +182,17 @@ def check_req_test_consistency(root: Path) -> list[AuditResult]:
     req_text = req_path.read_text(encoding="utf-8")
     test_text = test_path.read_text(encoding="utf-8")
 
-    req_ids = set(_REQ_PATTERN.findall(req_text))
+    # Only check coverage for non-Draft requirements.
+    # Draft requirements are stubs (e.g. auto-generated by import) and don't
+    # need tests yet — checking them would produce noise on freshly imported projects.
+    all_req_ids = set(_REQ_PATTERN.findall(req_text))
+    draft_req_ids: set[str] = set()
+    for block in re.split(r"(?=^## REQ-)", req_text, flags=re.MULTILINE):
+        ids_in_block = set(_REQ_PATTERN.findall(block))
+        if ids_in_block and re.search(r"\*\*Status\*\*:\s*[Dd]raft", block):
+            draft_req_ids |= ids_in_block
+    # Requirements that need coverage = all REQs minus those explicitly marked Draft
+    req_ids = all_req_ids - draft_req_ids
 
     # Find which REQs are covered by tests
     covered_reqs: set[str] = set()
@@ -201,12 +211,23 @@ def check_req_test_consistency(root: Path) -> list[AuditResult]:
                 ),
             )
         )
+    elif draft_req_ids and not req_ids:
+        # All requirements are Draft — coverage is not yet required
+        results.append(
+            AuditResult(
+                name="req-test-coverage",
+                passed=True,
+                message=(
+                    f"{len(all_req_ids)} REQ(s) are Draft (coverage not required until accepted)"
+                ),
+            )
+        )
     else:
         results.append(
             AuditResult(
                 name="req-test-coverage",
                 passed=True,
-                message=f"All {len(req_ids)} REQ(s) have test coverage",
+                message=f"All {len(req_ids)} accepted REQ(s) have test coverage",
             )
         )
 
@@ -430,23 +451,44 @@ def check_tool_configuration(root: Path) -> list[AuditResult]:
         )
         return results
 
-    missing: list[str] = []
-    # Check that at least the primary lint and test tools appear in CI
-    for cmd in tools.lint[:1]:
-        tool_name = cmd.split()[0]  # e.g. "ruff" from "ruff check"
-        if tool_name not in ci_content:
-            missing.append(f"lint:{tool_name}")
+    lint_missing: list[str] = []
+    test_missing: list[str] = []
+
+    # Check primary test tool (critical — hard fail if absent)
     for cmd in tools.test[:1]:
         tool_name = cmd.split()[0]
         if tool_name not in ci_content:
-            missing.append(f"test:{tool_name}")
+            test_missing.append(f"test:{tool_name}")
+
+    # Check primary lint tool (advisory — projects may use a different linter
+    # or none at all, especially when imported with existing CI)
+    for cmd in tools.lint[:1]:
+        tool_name = cmd.split()[0]
+        if tool_name not in ci_content:
+            lint_missing.append(f"lint:{tool_name}")
 
-    if missing:
+    all_missing = test_missing + lint_missing
+
+    if test_missing:
+        # Test tool missing — hard failure (tests are non-negotiable)
         results.append(
             AuditResult(
                 name="tool-ci-config",
                 passed=False,
-                message=f"CI config missing expected tools: {', '.join(missing)}",
+                message=f"CI config missing expected tools: {', '.join(all_missing)}",
+            )
+        )
+    elif lint_missing:
+        # Only lint missing — fixable warning (test tool is present; lint is advisory)
+        results.append(
+            AuditResult(
+                name="tool-ci-config",
+                passed=True,  # Pass — test tool is there; lint is a recommendation
+                message=(
+                    f"CI config missing lint tool ({', '.join(lint_missing)}); "
+                    f"test tool is present. Consider adding {lint_missing[0].split(':')[1]}."
+                ),
+                fixable=True,
             )
         )
     else:

{specsmith-0.3.0a1.dev8 → specsmith-0.3.0.dev16}/src/specsmith/config.py

@@ -85,7 +85,7 @@ class ProjectConfig(BaseModel):
         description="Target platforms",
     )
     language: str = Field(default="python", description="Primary language/runtime")
-    spec_version: str = Field(default="0.1.3", description="Spec version to scaffold from")
+    spec_version: str = Field(default="0.3.0", description="Spec version to scaffold from")
     description: str = Field(default="", description="Short project description")
 
     # Options

{specsmith-0.3.0a1.dev8 → specsmith-0.3.0.dev16}/src/specsmith/doctor.py

@@ -68,14 +68,15 @@ def run_doctor(root: Path) -> DoctorReport:
     ]:
         for cmd in cmds:
             tool_name = cmd.split()[0]
-            check = _check_tool(tool_name, category)
+            # Pass root so doctor can find tools in the project's .venv
+            check = _check_tool(tool_name, category, root=root)
             report.checks.append(check)
 
     return report
 
 
-def _check_tool(name: str, category: str) -> ToolCheck:
-    """Check if a tool is available on PATH."""
+def _check_tool(name: str, category: str, root: Path | None = None) -> ToolCheck:
+    """Check if a tool is available on PATH or in the project's .venv."""
     # Handle compound tool names (cargo clippy → cargo)
     exe = name.split()[0] if " " in name else name
 
@@ -85,7 +86,24 @@ def _check_tool(name: str, category: str) -> ToolCheck:
     elif exe in ("golangci-lint",):
         pass  # Already the executable name
 
+    # 1. Check system PATH
     path = shutil.which(exe)
+
+    # 2. Fall back to project's .venv (projects often don't install tools globally)
+    if not path and root is not None:
+        for venv_dir in (".venv", "venv", ".env"):
+            # POSIX layout: .venv/bin/<exe>
+            posix_path = root / venv_dir / "bin" / exe
+            # Windows layout: .venv\Scripts\<exe>.exe
+            win_path = root / venv_dir / "Scripts" / (exe + ".exe")
+            win_path_no_ext = root / venv_dir / "Scripts" / exe
+            for candidate in (posix_path, win_path, win_path_no_ext):
+                if candidate.exists():
+                    path = str(candidate)
+                    break
+            if path:
+                break
+
     if not path:
         return ToolCheck(name=name, category=category, installed=False)
 
@@ -93,7 +111,7 @@ def _check_tool(name: str, category: str) -> ToolCheck:
     version = ""
     try:
         result = subprocess.run(
-            [exe, "--version"],
+            [path, "--version"],
             capture_output=True,
             text=True,
             timeout=5,

{specsmith-0.3.0a1.dev8 → specsmith-0.3.0.dev16}/src/specsmith/importer.py

@@ -941,12 +941,18 @@ def _infer_type(result: DetectionResult) -> ProjectType:
 
 def generate_import_config(result: DetectionResult) -> ProjectConfig:
     """Generate a ProjectConfig from detection results."""
+    # Prefer README summary; fall back to generic description
+    description = (
+        result.readme_summary[:120]
+        if result.readme_summary
+        else f"Imported {result.primary_language or 'project'} library"
+    )
     return ProjectConfig(
         name=result.root.name,
         type=result.inferred_type or ProjectType.CLI_PYTHON,
         platforms=[Platform.WINDOWS, Platform.LINUX, Platform.MACOS],
         language=result.primary_language or "python",
-        description=f"Imported project ({result.file_count} files detected)",
+        description=description,
         git_init=False,  # Already has git
         vcs_platform=result.vcs_platform,
         detected_build_system=result.build_system,
@@ -1043,9 +1049,20 @@ def generate_overlay(
             tests += f"## TEST-{i:03d}\n- **File**: {test_file}\n- **Status**: Detected\n"
             for module in result.modules:
                 if module in test_file:
-                    tests += f"- **Requirement**: REQ-{module.upper()}-001\n"
+                    # Use 'Covers:' — matches the audit's _TEST_COVERS_PATTERN
+                    tests += f"  Covers: REQ-{module.upper().replace('-', '_')}-001\n"
                     break
             tests += "\n"
+        # Add an explicit build test so REQ-BUILD-001 has coverage
+        if result.build_system:
+            n = len(result.test_files[:20]) + 1
+            tests += (
+                f"## TEST-{n:03d}\n"
+                "- **Type**: integration\n"
+                f"- **Description**: Project installs and {result.test_framework or 'runs'} successfully\n"  # noqa: E501
+                "  Covers: REQ-BUILD-001\n"
+                "- **Status**: Detected\n\n"
+            )
         _write("docs/TEST_SPEC.md", tests)
 
     # docs/architecture.md — skip if project has architecture doc anywhere under docs/
@@ -1054,7 +1071,7 @@ def generate_overlay(
     )
     if not (existing_arch and not force):
         arch = (
-            f"# Architecture — {name}\n\n"
+            f"# Architecture \u2014 {name}\n\n"
             "Architecture auto-generated from project detection.\n\n"
             "## Overview\n"
             f"- **Languages**: {lang_display}\n"
@@ -1064,7 +1081,9 @@ def generate_overlay(
         if result.modules:
             arch += "## Modules\n"
             for module in result.modules:
-                arch += f"- **{module}**: [Describe module purpose]\n"
+                mu = module.upper().replace("-", "_")
+                # Reference the auto-generated requirement so validate passes
+                arch += f"- **{module}**: [Describe module purpose] (see REQ-{mu}-001)\n"
             arch += "\n"
         if result.entry_points:
             arch += "## Entry Points\n"
@@ -1075,6 +1094,9 @@ def generate_overlay(
             arch += "## Language Distribution\n"
             for lang_name, count in sorted(result.languages.items(), key=lambda x: -x[1]):
                 arch += f"- {lang_name}: {count} files\n"
+        if result.build_system:
+            arch += "\n## Build\n"
+            arch += f"- Build system: {result.build_system} (see REQ-BUILD-001)\n"
         _write("docs/ARCHITECTURE.md", arch)
 
     # --- Modular governance files ---

{specsmith-0.3.0a1.dev8 → specsmith-0.3.0.dev16}/src/specsmith/validator.py

@@ -198,10 +198,19 @@ def _check_req_ids_unique(root: Path) -> list[ValidationResult]:
 def _check_architecture_reqs(root: Path) -> list[ValidationResult]:
     """Check that architecture.md references requirements."""
     results: list[ValidationResult] = []
-    arch_path = root / "docs" / "architecture.md"
+
+    # Accept both ARCHITECTURE.md and architecture.md
+    arch_path = next(
+        (
+            root / "docs" / f
+            for f in ("ARCHITECTURE.md", "architecture.md")
+            if (root / "docs" / f).exists()
+        ),
+        None,
+    )
     req_path = root / "docs" / "REQUIREMENTS.md"
 
-    if not arch_path.exists() or not req_path.exists():
+    if arch_path is None or not req_path.exists():
         return results
 
     req_text = req_path.read_text(encoding="utf-8")
@@ -210,7 +219,16 @@ def _check_architecture_reqs(root: Path) -> list[ValidationResult]:
     req_ids = set(_REQ_PATTERN.findall(req_text))
     arch_refs = set(_REQ_PATTERN.findall(arch_text))
 
-    if req_ids and not arch_refs:
+    # If all requirements are Draft stubs (e.g. auto-generated by import),
+    # don't require architecture to reference them yet — they haven't been
+    # accepted or enriched. The check is only meaningful for accepted requirements.
+    all_draft = (
+        bool(req_ids)
+        and bool(re.search(r"\*\*Status\*\*:\s*[Dd]raft", req_text))
+        and not re.search(r"\*\*Status\*\*:\s*(?!Draft|draft)[A-Za-z]", req_text)
+    )
+
+    if req_ids and not arch_refs and not all_draft:
         results.append(
             ValidationResult(
                 name="arch-req-refs",
@@ -221,11 +239,16 @@ def _check_architecture_reqs(root: Path) -> list[ValidationResult]:
             )
         )
     else:
+        msg = (
+            f"architecture.md references {len(arch_refs)} REQ IDs"
+            if arch_refs
+            else f"REQs are all Draft \u2014 architecture linkage not yet required ({len(req_ids)} REQs)"  # noqa: E501
+        )
         results.append(
             ValidationResult(
                 name="arch-req-refs",
                 passed=True,
-                message=f"architecture.md references {len(arch_refs)} REQ IDs",
+                message=msg,
             )
         )
 

{specsmith-0.3.0a1.dev8 → specsmith-0.3.0.dev16/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.3.0a1.dev8
+Version: 0.3.0.dev16
 Summary: Applied Epistemic Engineering toolkit — forge epistemically-governed scaffolds, stress-test belief systems, and run AEE pipelines.
 Author: BitConcepts
 License: MIT
@@ -64,8 +64,7 @@ Dynamic: license-file
 
 [![CI](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml/badge.svg)](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml)
 [![Docs](https://readthedocs.org/projects/specsmith/badge/?version=stable)](https://specsmith.readthedocs.io/en/stable/)
-[![PyPI Stable](https://img.shields.io/pypi/v/specsmith?label=stable&style=flat&color=blue&cacheSeconds=60)](https://pypi.org/project/specsmith/)
-[![PyPI Dev](https://img.shields.io/pypi/v/specsmith?include_prereleases=true&label=dev&style=flat&color=orange&cacheSeconds=60)](https://pypi.org/project/specsmith/#history)
+[![PyPI](https://img.shields.io/pypi/v/specsmith?label=stable&style=flat&color=blue&cacheSeconds=60)](https://pypi.org/project/specsmith/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)