specsmith 0.4.0.dev223__tar.gz → 0.5.0.dev224__tar.gz

{specsmith-0.4.0.dev223/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.dev223
+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.dev223 → specsmith-0.5.0.dev224}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.4.0.dev223"
+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"

{specsmith-0.4.0.dev223 → 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.dev223 → 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.dev223 → 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.dev223 → 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.dev223/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.dev223 → 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.dev223 → 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.dev223 → 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.dev223
+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.dev223 → 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.dev223 → 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