specsmith 0.4.0.dev222__tar.gz → 0.5.0.dev224__tar.gz

{specsmith-0.4.0.dev222/src/specsmith.egg-info → specsmith-0.5.0.dev224}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.4.0.dev222
+Version: 0.5.0.dev224
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.4.0.dev222"
+version = "0.5.0.dev224"
 description = "Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands."
 readme = "README.md"
 license = "MIT"
@@ -107,6 +107,11 @@ select = ["E", "F", "W", "I", "UP", "B", "SIM"]
 # Long rule text and install command strings in documentation modules
 "src/specsmith/toolrules.py" = ["E501"]
 "src/specsmith/tool_installer.py" = ["E501"]
+# One-shot rebuild scripts contain literal REQ description strings that are
+# intentionally long; wrapping them would damage readability of the source
+# of truth they reconstruct.
+"scripts/rebuild_requirements_json.py" = ["E501"]
+"scripts/rebuild_requirements_md.py" = ["E501"]
 
 [tool.mypy]
 python_version = "3.10"
@@ -141,9 +146,11 @@ ignore_missing_imports = true
 module = ["epistemic", "epistemic.*"]
 ignore_errors = true
 
-# New modules that use dynamic typing patterns incompatible with strict mypy.
+# Modules that use dynamic typing patterns incompatible with strict mypy.
 # These are correct at runtime; the Any-heavy urllib, json.loads, etc. patterns
 # are the source of most errors here. Exclude from strict type checking.
+# REQ-111: shrunk this list as part of the pre-1.0 cleanup; broker, safety,
+# console_utils, and indexer have been graduated to strict mypy.
 [[tool.mypy.overrides]]
 module = [
     "specsmith.ollama_cmds",
@@ -153,14 +160,10 @@ module = [
     "specsmith.importer",
     "specsmith.agent.providers.gemini",
     "specsmith.agent.runner",
-    "specsmith.agent.broker",
     "specsmith.agent.cleanup",
-    "specsmith.agent.indexer",
     "specsmith.agent.orchestrator",
     "specsmith.agent.repl",
-    "specsmith.agent.safety",
     "specsmith.agent.tools",
-    "specsmith.console_utils",
     "specsmith.profiles",
     "specsmith.serve",
     "specsmith.toolrules",

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith/agent/broker.py

@@ -40,6 +40,7 @@ from collections.abc import Callable
 from dataclasses import dataclass, field
 from enum import Enum
 from pathlib import Path
+from typing import Any
 
 # ---------------------------------------------------------------------------
 # Intent classification
@@ -285,7 +286,7 @@ def infer_scope(
 class PreflightDecision:
     """Wrapped Specsmith preflight outcome."""
 
-    raw: dict
+    raw: dict[str, Any]
     decision: str = "unknown"
     work_item_id: str = ""
     requirement_ids: list[str] = field(default_factory=list)
@@ -294,7 +295,7 @@ class PreflightDecision:
     instruction: str = ""
 
     @classmethod
-    def from_json(cls, payload: dict) -> PreflightDecision:
+    def from_json(cls, payload: dict[str, Any]) -> PreflightDecision:
         return cls(
             raw=payload,
             decision=str(payload.get("decision", "unknown")),
@@ -476,7 +477,7 @@ RETRY_STRATEGIES = (
 )
 
 
-def classify_retry_strategy(report: dict, decision: PreflightDecision) -> str:
+def classify_retry_strategy(report: dict[str, Any], decision: PreflightDecision) -> str:
     """Map an executor failure report to one of the canonical retry strategies.
 
     The classification is deterministic and inspects:
@@ -529,7 +530,7 @@ def classify_retry_strategy(report: dict, decision: PreflightDecision) -> str:
 def execute_with_governance(
     decision: PreflightDecision,
     *,
-    executor: Callable[[PreflightDecision, int], dict],
+    executor: Callable[[PreflightDecision, int], dict[str, Any]],
     retry_budget: int = DEFAULT_RETRY_BUDGET,
 ) -> RunResult:
     """Run the work with Specsmith governance and a hard retry budget.
@@ -546,7 +547,7 @@ def execute_with_governance(
 
     last_summary = ""
     last_confidence = 0.0
-    last_report: dict = {}
+    last_report: dict[str, Any] = {}
     for attempt in range(1, retry_budget + 1):
         report = executor(decision, attempt) or {}
         last_report = report

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith/agent/cleanup.py

@@ -68,6 +68,7 @@ PROTECTED_PATHS = frozenset(
         ".repo-index",
         ".github",
         ".vscode",
+        ".agents",
         ".warp",
         ".editorconfig",
         ".gitignore",

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith/agent/indexer.py

@@ -5,7 +5,7 @@ import subprocess
 from pathlib import Path
 
 
-def generate_index(cwd: str = None):
+def generate_index(cwd: str | None = None) -> None:
     """Generate repository index into .repo-index/"""
     if cwd is None:
         cwd = os.getcwd()

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith/agent/orchestrator.py

@@ -207,13 +207,15 @@ Next action:
 
         AG2's ``initiate_chat`` returns a ``ChatResult`` whose ``summary`` is
         the last assistant message and whose ``chat_history`` lists every
-        turn. We treat reaching a non-empty summary that includes the
-        ``Next action:`` section as equilibrium per REQ-073, and parse
-        ``Files changed:`` and ``Test results:`` if present. The confidence
-        is conservative (0.85 for a complete contract response, 0.4 for a
-        partial one) and is meant to be replaced by a real verifier signal
-        once one is wired in.
+        turn. We parse the Nexus output contract out of the summary and feed
+        the structured signal through :func:`specsmith.agent.verifier.score`
+        (REQ-108) so ``equilibrium`` and ``confidence`` reflect real test /
+        ruff / mypy state instead of a hardcoded heuristic. When the LLM
+        returns no contract sections at all we fall back to the previous
+        conservative defaults so behaviour stays the same on degraded runs.
         """
+        from specsmith.agent.verifier import report_from_chat_sections, score
+
         summary = ""
         if chat_result is not None:
             summary = getattr(chat_result, "summary", "") or ""
@@ -221,8 +223,6 @@ Next action:
                 summary = str(summary)
 
         sections = self._parse_output_contract(summary)
-        equilibrium = bool(sections) and "next_action" in sections
-        confidence = 0.85 if equilibrium else (0.4 if summary else 0.0)
 
         files_changed: list[str] = []
         files_section = sections.get("files_changed", "")
@@ -236,6 +236,22 @@ Next action:
         if tests_section:
             test_results["raw"] = tests_section
 
+        # REQ-108: derive confidence and equilibrium from the real verifier
+        # signal rather than guessing from the presence of contract sections.
+        if sections:
+            report = report_from_chat_sections(sections, files_changed=files_changed)
+            verdict = score(report, confidence_target=0.7)
+            confidence = verdict.confidence
+            # Treat "reached the next_action section" as a soft floor for
+            # equilibrium so the harness still distinguishes a structurally
+            # complete contract from a totally empty one.
+            equilibrium = verdict.equilibrium or (
+                "next_action" in sections and report.has_changes and report.test_failed == 0
+            )
+        else:
+            equilibrium = False
+            confidence = 0.4 if summary else 0.0
+
         return TaskResult(
             equilibrium=equilibrium,
             confidence=confidence,

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith/config.py

@@ -198,7 +198,10 @@ class ProjectConfig(BaseModel):
     # Agent integrations
     integrations: list[str] = Field(
         default=["agents-md"],
-        description="Agent integrations to generate (agents-md, warp, claude-code, cursor, etc.)",
+        description=(
+            "Agent integrations to generate (agents-md, agent-skill, claude-code, "
+            "cursor, copilot, gemini, windsurf, aider)."
+        ),
     )
 
     # Agent execution profile

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith/console_utils.py

@@ -23,11 +23,12 @@ from __future__ import annotations
 
 import os
 import sys
+from typing import IO, Any
 
 from rich.console import Console
 
 
-def _ensure_utf8_stream(stream) -> None:
+def _ensure_utf8_stream(stream: IO[str]) -> None:
     """Best-effort upgrade of ``stream`` to UTF-8 with safe error handling."""
     reconfigure = getattr(stream, "reconfigure", None)
     if reconfigure is None:
@@ -40,7 +41,7 @@ def _ensure_utf8_stream(stream) -> None:
         return
 
 
-def make_console(**kwargs) -> Console:
+def make_console(**kwargs: Any) -> Console:
     """Return a UTF-8 safe ``rich.console.Console``.
 
     Any keyword arguments are forwarded to ``Console`` and override the
@@ -53,7 +54,7 @@ def make_console(**kwargs) -> Console:
     # we may spawn (e.g. tests, CI runners).
     os.environ.setdefault("PYTHONIOENCODING", "utf-8")
 
-    defaults = {
+    defaults: dict[str, Any] = {
         "legacy_windows": False,
         "soft_wrap": False,
         "force_terminal": None,

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith/credits.py

@@ -17,7 +17,7 @@ class CreditEntry:
     timestamp: str = ""
     session_id: str = ""
     model: str = ""
-    provider: str = ""  # openai, anthropic, google, warp, local
+    provider: str = ""  # openai, anthropic, google, local, ollama, etc.
     tokens_in: int = 0
     tokens_out: int = 0
     estimated_cost_usd: float = 0.0

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith/integrations/__init__.py

@@ -11,19 +11,30 @@ if TYPE_CHECKING:
 
 ADAPTER_REGISTRY: dict[str, type[AgentAdapter]] = {}
 
+# Legacy adapter names that have been superseded. Mapped to the current
+# canonical name. Lookups for legacy keys still succeed (backward compat for
+# existing scaffold.yml files) but only the canonical names are returned by
+# ``list_adapters()``.
+LEGACY_ALIASES: dict[str, str] = {
+    # Pre-0.5.0 the agent-skill adapter shipped under the name ``warp`` and
+    # wrote to ``.warp/skills/SKILL.md``. New scaffolds use ``agent-skill``
+    # and ``.agents/skills/SKILL.md``.
+    "warp": "agent-skill",
+}
+
 
 def _load_adapters() -> None:
     """Populate the adapter registry."""
+    from specsmith.integrations.agent_skill import AgentSkillAdapter
     from specsmith.integrations.aider import AiderAdapter
     from specsmith.integrations.claude_code import ClaudeCodeAdapter
     from specsmith.integrations.copilot import CopilotAdapter
     from specsmith.integrations.cursor import CursorAdapter
     from specsmith.integrations.gemini import GeminiAdapter
-    from specsmith.integrations.warp import WarpAdapter
     from specsmith.integrations.windsurf import WindsurfAdapter
 
     for cls in (
-        WarpAdapter,
+        AgentSkillAdapter,
         ClaudeCodeAdapter,
         CursorAdapter,
         CopilotAdapter,
@@ -35,10 +46,16 @@ def _load_adapters() -> None:
 
 
 def get_adapter(name: str) -> AgentAdapter:
-    """Get an adapter instance by name."""
+    """Get an adapter instance by name.
+
+    Legacy names listed in :data:`LEGACY_ALIASES` are silently rewritten to
+    their canonical equivalent, so older ``scaffold.yml`` integration lists
+    keep working without manual migration.
+    """
     if not ADAPTER_REGISTRY:
         _load_adapters()
-    cls = ADAPTER_REGISTRY.get(name)
+    resolved = LEGACY_ALIASES.get(name, name)
+    cls = ADAPTER_REGISTRY.get(resolved)
     if cls is None:
         available = ", ".join(sorted(ADAPTER_REGISTRY.keys()))
         msg = f"Unknown integration '{name}'. Available: {available}"
@@ -47,7 +64,7 @@ def get_adapter(name: str) -> AgentAdapter:
 
 
 def list_adapters() -> list[str]:
-    """List available adapter names."""
+    """List available adapter names (canonical only; legacy aliases hidden)."""
     if not ADAPTER_REGISTRY:
         _load_adapters()
     return sorted(ADAPTER_REGISTRY.keys())

specsmith-0.4.0.dev222/src/specsmith/integrations/warp.py → specsmith-0.5.0.dev224/src/specsmith/integrations/agent_skill.py

@@ -1,6 +1,16 @@
 # SPDX-License-Identifier: MIT
 # Copyright (c) 2026 BitConcepts, LLC. All rights reserved.
-"""Warp / Oz skill integration adapter."""
+"""Agent skill integration adapter.
+
+Generates a generic ``SKILL.md`` file under ``.agents/skills/`` for any
+terminal-native AI agent that supports the SKILL.md convention.
+
+This adapter previously shipped under the name ``warp`` and wrote to
+``.warp/skills/SKILL.md``. The legacy name is still resolved as an alias
+in :mod:`specsmith.integrations` so existing ``scaffold.yml`` configs
+continue to work, but the canonical adapter name is ``agent-skill`` and
+the canonical output path is ``.agents/skills/SKILL.md``.
+"""
 
 from __future__ import annotations
 
@@ -10,19 +20,19 @@ from specsmith.config import ProjectConfig
 from specsmith.integrations.base import AgentAdapter
 
 
-class WarpAdapter(AgentAdapter):
-    """Generate a Warp skill file for the project."""
+class AgentSkillAdapter(AgentAdapter):
+    """Generate a generic agent skill file (.agents/skills/SKILL.md)."""
 
     @property
     def name(self) -> str:
-        return "warp"
+        return "agent-skill"
 
     @property
     def description(self) -> str:
-        return "Warp / Oz skill file (.warp/skills/)"
+        return "Agent skill file (.agents/skills/SKILL.md)"
 
     def generate(self, config: ProjectConfig, target: Path) -> list[Path]:
-        skill_dir = target / ".warp" / "skills"
+        skill_dir = target / ".agents" / "skills"
         skill_dir.mkdir(parents=True, exist_ok=True)
 
         skill_path = skill_dir / "SKILL.md"
@@ -87,7 +97,7 @@ Before marking any task complete, run: {verify_line}
 ## Credit Tracking
 After completing tasks, record token usage:
 ```
-specsmith credits record --model <model> --provider <provider> \
+specsmith credits record --model <model> --provider <provider> \\
   --tokens-in <N> --tokens-out <N> --task "<desc>"
 ```
 Check budget: `specsmith credits summary`

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith/integrations/base.py

@@ -16,7 +16,7 @@ class AgentAdapter(ABC):
     @property
     @abstractmethod
     def name(self) -> str:
-        """Short identifier for this integration (e.g. 'warp', 'claude-code')."""
+        """Short identifier for this integration (e.g. 'agent-skill', 'claude-code')."""
 
     @property
     @abstractmethod

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith/upgrader.py

@@ -368,6 +368,10 @@ def _update_references(
         "AGENTS.md",
         "CLAUDE.md",
         "GEMINI.md",
+        # Canonical post-0.5.0 path for the agent-skill adapter.
+        ".agents/skills/SKILL.md",
+        # Legacy path for projects scaffolded before 0.5.0 (still patched
+        # so reference rewrites continue to work after rename).
         ".warp/skills/SKILL.md",
         ".cursor/rules/governance.mdc",
         ".windsurfrules",

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.4.0.dev222
+Version: 0.5.0.dev224
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/src/specsmith.egg-info/SOURCES.txt

@@ -91,13 +91,13 @@ src/specsmith/gui/widgets/token_meter.py
 src/specsmith/gui/widgets/tool_panel.py
 src/specsmith/gui/widgets/update_checker.py
 src/specsmith/integrations/__init__.py
+src/specsmith/integrations/agent_skill.py
 src/specsmith/integrations/aider.py
 src/specsmith/integrations/base.py
 src/specsmith/integrations/claude_code.py
 src/specsmith/integrations/copilot.py
 src/specsmith/integrations/cursor.py
 src/specsmith/integrations/gemini.py
-src/specsmith/integrations/warp.py
 src/specsmith/integrations/windsurf.py
 src/specsmith/templates/agents.md.j2
 src/specsmith/templates/editorconfig.j2

{specsmith-0.4.0.dev222 → specsmith-0.5.0.dev224}/tests/test_integrations.py

@@ -10,10 +10,10 @@ import pytest
 
 from specsmith.config import ProjectConfig, ProjectType
 from specsmith.integrations import get_adapter, list_adapters
+from specsmith.integrations.agent_skill import AgentSkillAdapter
 from specsmith.integrations.claude_code import ClaudeCodeAdapter
 from specsmith.integrations.copilot import CopilotAdapter
 from specsmith.integrations.cursor import CursorAdapter
-from specsmith.integrations.warp import WarpAdapter
 
 
 @pytest.fixture
@@ -30,26 +30,36 @@ def config() -> ProjectConfig:
 class TestAdapterRegistry:
     def test_list_adapters(self) -> None:
         adapters = list_adapters()
-        assert "warp" in adapters
+        assert "agent-skill" in adapters
         assert "claude-code" in adapters
         assert "cursor" in adapters
         assert "copilot" in adapters
+        # Legacy aliases are not surfaced as canonical names.
+        assert "warp" not in adapters
 
     def test_get_adapter(self) -> None:
+        adapter = get_adapter("agent-skill")
+        assert isinstance(adapter, AgentSkillAdapter)
+
+    def test_get_adapter_legacy_alias(self) -> None:
+        # Existing scaffold.yml configs that still say `warp` keep working.
         adapter = get_adapter("warp")
-        assert isinstance(adapter, WarpAdapter)
+        assert isinstance(adapter, AgentSkillAdapter)
 
     def test_get_unknown_adapter(self) -> None:
         with pytest.raises(ValueError, match="Unknown integration"):
             get_adapter("nonexistent")
 
 
-class TestWarpAdapter:
+class TestAgentSkillAdapter:
     def test_generates_skill(self, config: ProjectConfig, tmp_path: Path) -> None:
-        adapter = WarpAdapter()
+        adapter = AgentSkillAdapter()
         files = adapter.generate(config, tmp_path)
         assert len(files) == 1
         assert files[0].name == "SKILL.md"
+        # Canonical generated path is .agents/skills/SKILL.md (rebrand from .warp/).
+        assert files[0].parent.name == "skills"
+        assert files[0].parent.parent.name == ".agents"
         content = files[0].read_text(encoding="utf-8")
         assert "test-project" in content
         assert "AGENTS.md" in content