specsmith 0.1.4.dev24__tar.gz → 0.1.4.dev26__tar.gz

{specsmith-0.1.4.dev24/src/specsmith.egg-info → specsmith-0.1.4.dev26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.1.4.dev24
+Version: 0.1.4.dev26
 Summary: Forge governed project scaffolds from the Agentic AI Development Workflow Specification.
 Author: BitConcepts
 License: MIT

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.1.4.dev24"
+version = "0.1.4.dev26"
 description = "Forge governed project scaffolds from the Agentic AI Development Workflow Specification."
 readme = "README.md"
 license = {text = "MIT"}

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26}/src/specsmith/cli.py

@@ -478,7 +478,10 @@ def import_project(project_dir: str, force: bool, guided: bool, dry_run: bool) -
     result = detect_project(root)
 
     console.print(f"  Files: {result.file_count}")
-    console.print(f"  Language: [cyan]{result.primary_language or 'unknown'}[/cyan]")
+    lang_display = result.primary_language or "unknown"
+    if result.secondary_languages:
+        lang_display += f" + {', '.join(result.secondary_languages)}"
+    console.print(f"  Languages: [cyan]{lang_display}[/cyan]")
     console.print(f"  Build system: {result.build_system or 'not detected'}")
     console.print(f"  Test framework: {result.test_framework or 'not detected'}")
     console.print(f"  CI: {result.existing_ci or 'not detected'}")
@@ -1205,6 +1208,50 @@ def update_cmd(check_only: bool, auto_yes: bool, project_dir: str) -> None:
                 console.print(f"  [green]\u2713[/green] {a}")
 
 
+@main.command(name="self-update")
+@click.option(
+    "--channel",
+    type=click.Choice(["stable", "dev"]),
+    default=None,
+    help="Force channel (default: auto-detect from installed version).",
+)
+@click.option("--version", "target_version", default="", help="Install a specific version.")
+def self_update_cmd(channel: str | None, target_version: str) -> None:
+    """Update specsmith to the latest version.
+
+    Auto-detects channel: stable builds upgrade to latest stable,
+    dev builds upgrade to latest dev. Use --channel to override.
+    Use --version to pin a specific version.
+    """
+    from specsmith.updater import check_latest_version, get_update_channel, run_self_update
+
+    current_channel = get_update_channel()
+    effective_channel = channel or current_channel
+
+    if target_version:
+        console.print(f"[bold]Installing specsmith {target_version}...[/bold]")
+        success, msg = run_self_update(target_version=target_version)
+    else:
+        current, latest, effective_channel = check_latest_version(channel=effective_channel)
+        if not latest:
+            console.print("[yellow]Could not reach PyPI.[/yellow]")
+            return
+        if current == latest:
+            console.print(
+                f"[green]\u2713[/green] specsmith {current} is up to date ({effective_channel})."
+            )
+            return
+        console.print(f"  Current: {current} ({current_channel})")
+        console.print(f"  Latest:  {latest} ({effective_channel})")
+        success, msg = run_self_update(channel=effective_channel)
+
+    if success:
+        console.print("[green]\u2713[/green] Updated successfully.")
+        console.print("  Restart your shell to use the new version.")
+    else:
+        console.print(f"[red]\u2717[/red] Update failed: {msg}")
+
+
 @main.command(name="migrate-project")
 @click.option("--project-dir", type=click.Path(exists=True), default=".")
 @click.option("--dry-run", is_flag=True, default=False, help="Show changes without writing.")

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26}/src/specsmith/importer.py

@@ -101,6 +101,7 @@ class DetectionResult:
     root: Path
     languages: dict[str, int] = field(default_factory=dict)
     primary_language: str = ""
+    secondary_languages: list[str] = field(default_factory=list)
     build_system: str = ""
     test_framework: str = ""
     vcs_platform: str = ""
@@ -183,6 +184,14 @@ def detect_project(root: Path) -> DetectionResult:
     result.languages = dict(lang_counter.most_common())
     if lang_counter:
         result.primary_language = lang_counter.most_common(1)[0][0]
+        # Secondary languages: all others above a minimum threshold (5 files or 5%)
+        total = sum(lang_counter.values())
+        threshold = max(5, int(total * 0.05))
+        result.secondary_languages = [
+            lang
+            for lang, count in lang_counter.most_common()
+            if lang != result.primary_language and count >= threshold
+        ]
 
     # Build system — check root AND first-level subdirectories
     for indicator, system in _BUILD_SYSTEMS.items():
@@ -545,11 +554,86 @@ def _extract_git_contributors(root: Path) -> list[str]:
     return []
 
 
+# Section heading keywords → governance file mapping.
+# Each list is checked with substring matching against lowercased ## headings.
+_RULES_KW: list[str] = [
+    "hard rule",
+    "stop condition",
+    "acceptance",
+    "forbidden",
+    "mandatory",
+    "pre-flight",
+    "preflight",
+    "critical rule",
+    "tool invocation",
+    "prohibition",
+    "enforcement",
+    "final rule",
+    "phase enforcement",
+    "phase 1",
+    "phase 2",
+    "repository structure",
+    ".work/",
+    ".work",
+    "path-length",
+    "directory structure",
+]
+_WORKFLOW_KW: list[str] = [
+    "session",
+    "lifecycle",
+    "quick command",
+    "ledger",
+    "new session",
+    "resume session",
+    "save session",
+    "git commit",
+    "git update",
+    "startup checklist",
+    "stop / save",
+    "stop/save",
+    "push-to-git",
+    "push to git",
+    "command handling",
+    "roadmap",
+]
+_ROLES_KW: list[str] = [
+    "agent role",
+    "drafting",
+    "agents are",
+    "drafting assistance",
+]
+_CTX_KW: list[str] = [
+    "context",
+    "window",
+    "budget",
+    "context window",
+    "token",
+]
+_VERIFY_KW: list[str] = [
+    "verification",
+    "conflict",
+    "consistency",
+    "solver",
+    "engine mode",
+    "benchmark",
+    "deployment",
+    "connectivity",
+    "target",
+]
+_DRIFT_KW: list[str] = [
+    "environment",
+    "platform",
+    "shell wrapper",
+    "bootstrap",
+    "scripts",
+]
+
+
 def _extract_governance_sections(root: Path) -> dict[str, str]:
     """Extract modular governance content from existing AGENTS.md.
 
-    If AGENTS.md exists and has relevant sections, extract them.
-    Otherwise return generic stubs.
+    If AGENTS.md exists and is large, extract sections into modular files.
+    Unmatched sections are collected into rules.md so nothing is lost.
     """
     defaults = {
         "rules": (
@@ -591,98 +675,71 @@ def _extract_governance_sections(root: Path) -> dict[str, str]:
     for line in content.splitlines():
         if line.startswith("## "):
             if current_heading and current_lines:
-                sections[current_heading.lower()] = "\n".join(current_lines).strip()
+                sections[current_heading] = "\n".join(current_lines).strip()
             current_heading = line[3:].strip()
             current_lines = []
         else:
             current_lines.append(line)
     if current_heading and current_lines:
-        sections[current_heading.lower()] = "\n".join(current_lines).strip()
-
-    # Map AGENTS.md sections to modular governance files
-    result = dict(defaults)  # Start with defaults
-
-    # Rules: look for HARD RULES, STOP CONDITIONS, ACCEPTANCE STANDARD
-    rules_parts: list[str] = ["# Rules\n"]
-    for key in sections:
-        if any(kw in key for kw in ("hard rule", "stop condition", "acceptance", "forbidden")):
-            rules_parts.append(f"## {key.title()}\n")
-            rules_parts.append(sections[key])
-            rules_parts.append("")
-    if len(rules_parts) > 1:
-        result["rules"] = "\n".join(rules_parts) + "\n"
-
-    # Workflow: SESSION LIFECYCLE, QUICK COMMANDS, LEDGER format
-    wf_parts: list[str] = ["# Workflow\n"]
-    for key in sections:
-        if any(
-            kw in key
-            for kw in (
-                "session",
-                "lifecycle",
-                "quick command",
-                "ledger",
-                "new session",
-                "resume session",
-                "save session",
-                "git commit",
-                "git update",
-            )
-        ):
-            wf_parts.append(f"## {key.title()}\n")
-            wf_parts.append(sections[key])
-            wf_parts.append("")
-    if len(wf_parts) > 1:
-        result["workflow"] = "\n".join(wf_parts) + "\n"
-
-    # Roles: AGENT ROLE, DRAFTING ASSISTANCE
-    roles_parts: list[str] = ["# Roles\n"]
-    for key in sections:
-        if any(kw in key for kw in ("agent role", "drafting", "agents are")):
-            roles_parts.append(f"## {key.title()}\n")
-            roles_parts.append(sections[key])
-            roles_parts.append("")
-    if len(roles_parts) > 1:
-        result["roles"] = "\n".join(roles_parts) + "\n"
-
-    # Context budget: CONTEXT WINDOW MANAGEMENT
-    ctx_parts: list[str] = ["# Context Budget\n"]
-    for key in sections:
-        if any(kw in key for kw in ("context", "window", "budget")):
-            ctx_parts.append(f"## {key.title()}\n")
-            ctx_parts.append(sections[key])
-            ctx_parts.append("")
-    if len(ctx_parts) > 1:
-        result["context-budget"] = "\n".join(ctx_parts) + "\n"
-
-    # Verification: VERIFICATION MINIMUM, CONFLICT AND CONSISTENCY
-    ver_parts: list[str] = ["# Verification\n"]
-    for key in sections:
-        if any(kw in key for kw in ("verification", "conflict", "consistency")):
-            ver_parts.append(f"## {key.title()}\n")
-            ver_parts.append(sections[key])
-            ver_parts.append("")
-    if len(ver_parts) > 1:
-        result["verification"] = "\n".join(ver_parts) + "\n"
-
-    # Drift metrics: ENVIRONMENT, PLATFORM EXPECTATIONS, SHELL WRAPPER
-    drift_parts: list[str] = ["# Environment & Platform\n"]
-    for key in sections:
-        if any(
-            kw in key
-            for kw in (
-                "environment",
-                "platform",
-                "shell wrapper",
-                "bootstrap",
-                "scripts",
-            )
-        ):
-            drift_parts.append(f"## {key.title()}\n")
-            drift_parts.append(sections[key])
-            drift_parts.append("")
-    if len(drift_parts) > 1:
-        result["drift-metrics"] = "\n".join(drift_parts) + "\n"
+        sections[current_heading] = "\n".join(current_lines).strip()
+
+    if not sections:
+        return defaults
+
+    # Classify each section into a governance category
+    category_map: list[tuple[str, list[str]]] = [
+        ("rules", _RULES_KW),
+        ("workflow", _WORKFLOW_KW),
+        ("roles", _ROLES_KW),
+        ("context-budget", _CTX_KW),
+        ("verification", _VERIFY_KW),
+        ("drift-metrics", _DRIFT_KW),
+    ]
+
+    buckets: dict[str, list[tuple[str, str]]] = {
+        "rules": [],
+        "workflow": [],
+        "roles": [],
+        "context-budget": [],
+        "verification": [],
+        "drift-metrics": [],
+    }
+    unmatched: list[tuple[str, str]] = []
+
+    for heading, body in sections.items():
+        key_lower = heading.lower()
+        matched = False
+        for category, keywords in category_map:
+            if any(kw in key_lower for kw in keywords):
+                buckets[category].append((heading, body))
+                matched = True
+                break  # First match wins
+        if not matched:
+            unmatched.append((heading, body))
+
+    # Unmatched sections go to rules.md as project-specific rules
+    if unmatched:
+        buckets["rules"].extend(unmatched)
+
+    # Build output
+    titles = {
+        "rules": "# Rules",
+        "workflow": "# Workflow",
+        "roles": "# Roles",
+        "context-budget": "# Context Budget",
+        "verification": "# Verification",
+        "drift-metrics": "# Environment & Platform",
+    }
+    result = dict(defaults)
+    for category, items in buckets.items():
+        if not items:
+            continue
+        parts: list[str] = [titles[category] + "\n"]
+        for heading, body in items:
+            parts.append(f"## {heading}\n")
+            parts.append(body)
+            parts.append("")
+        result[category] = "\n".join(parts) + "\n"
 
     return result
 
@@ -799,6 +856,8 @@ def generate_overlay(
 
     name = result.root.name
     lang = result.primary_language or "unknown"
+    all_langs = [lang] + (result.secondary_languages or [])
+    lang_display = ", ".join(all_langs) if len(all_langs) > 1 else lang
     today = date.today().isoformat()
     ptype = result.inferred_type.value if result.inferred_type else "unknown"
 
@@ -809,7 +868,7 @@ def generate_overlay(
         "This project was imported by specsmith. The governance files contain "
         "detected structure. Review and enrich with your agent.\n\n"
         "## Project Summary\n"
-        f"- **Language**: {lang}\n"
+        f"- **Languages**: {lang_display}\n"
         f"- **Build system**: {result.build_system or 'not detected'}\n"
         f"- **Test framework**: {result.test_framework or 'not detected'}\n"
         f"- **Files detected**: {result.file_count}\n"
@@ -867,7 +926,7 @@ def generate_overlay(
         f"# Architecture — {name}\n\n"
         "Architecture auto-generated from project detection.\n\n"
         "## Overview\n"
-        f"- **Language**: {lang}\n"
+        f"- **Languages**: {lang_display}\n"
         f"- **Build system**: {result.build_system or 'not detected'}\n"
         f"- **Test framework**: {result.test_framework or 'not detected'}\n\n"
     )
@@ -898,6 +957,52 @@ def generate_overlay(
     _write("docs/governance/verification.md", gov["verification"])
     _write("docs/governance/drift-metrics.md", gov["drift-metrics"])
 
+    # If existing AGENTS.md is oversized, back it up and replace with a hub.
+    agents_path = target / "AGENTS.md"
+    if agents_path.exists():
+        agents_lines = len(agents_path.read_text(encoding="utf-8").splitlines())
+        if agents_lines > 200:
+            backup_path = target / "AGENTS.md.bak"
+            if not backup_path.exists():
+                import shutil
+
+                shutil.copy2(agents_path, backup_path)
+
+            hub = (
+                f"# {name} \u2014 Agent Governance\n\n"
+                f"**Type:** {ptype}  \n"
+                f"**Language:** {lang}  \n\n"
+                "---\n\n"
+                "## Governance File Registry\n\n"
+                "| File | Content | Load timing |\n"
+                "| ---- | ------- | ----------- |\n"
+                "| `docs/governance/rules.md` | Hard rules, stop conditions, "
+                "project-specific rules | Every session start |\n"
+                "| `docs/governance/workflow.md` | Session lifecycle, "
+                "save/push protocol | Every session start |\n"
+                "| `docs/governance/roles.md` | Agent role boundaries | "
+                "Every session start |\n"
+                "| `docs/governance/context-budget.md` | Context management | "
+                "Every session start |\n"
+                "| `docs/governance/verification.md` | Verification, "
+                "consistency | When verifying |\n"
+                "| `docs/governance/drift-metrics.md` | Environment, "
+                "platform | On audit |\n\n"
+                "Other project documents:\n\n"
+                "| File | Content |\n"
+                "| ---- | ------- |\n"
+                "| `LEDGER.md` | Append-only work record |\n"
+                "| `docs/REQUIREMENTS.md` | Formal requirements |\n"
+                "| `docs/TEST_SPEC.md` | Test cases |\n"
+                "| `docs/architecture.md` | Architecture |\n\n"
+                "---\n\n"
+                f"*Original AGENTS.md ({agents_lines} lines) backed up "
+                "to AGENTS.md.bak. Content extracted into modular "
+                "governance files above.*\n"
+            )
+            agents_path.write_text(hub, encoding="utf-8")
+            created.append(agents_path)
+
     # --- CI config (merge: only create if no CI detected) ---
     if not result.existing_ci and result.vcs_platform:
         try:

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26}/src/specsmith/updater.py

@@ -59,17 +59,22 @@ def is_outdated() -> bool:
     return current != latest
 
 
-def run_self_update(*, channel: str = "") -> tuple[bool, str]:
+def run_self_update(
+    *, channel: str = "", target_version: str = "",
+) -> tuple[bool, str]:
     """Update specsmith via pip.
 
-    Uses --pre flag for dev channel.
+    If target_version is set, installs that exact version.
+    Otherwise uses --pre flag for dev channel, plain upgrade for stable.
     """
-    if not channel:
-        channel = get_update_channel()
-
-    cmd = ["pip", "install", "--upgrade", "specsmith"]
-    if channel == "dev":
-        cmd.insert(2, "--pre")
+    if target_version:
+        cmd = ["pip", "install", f"specsmith=={target_version}"]
+    else:
+        if not channel:
+            channel = get_update_channel()
+        cmd = ["pip", "install", "--upgrade", "specsmith"]
+        if channel == "dev":
+            cmd.insert(2, "--pre")
 
     try:
         result = subprocess.run(

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.1.4.dev24
+Version: 0.1.4.dev26
 Summary: Forge governed project scaffolds from the Agentic AI Development Workflow Specification.
 Author: BitConcepts
 License: MIT

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26}/tests/test_auditor.py

@@ -7,7 +7,6 @@ from __future__ import annotations
 from pathlib import Path
 
 import pytest
-
 from specsmith.auditor import run_audit
 
 

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26}/tests/test_cli.py

@@ -8,7 +8,6 @@ from pathlib import Path
 
 import yaml
 from click.testing import CliRunner
-
 from specsmith.cli import main
 from specsmith.config import ProjectConfig, ProjectType
 from specsmith.scaffolder import scaffold_project

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26}/tests/test_integrations.py

@@ -7,7 +7,6 @@ from __future__ import annotations
 from pathlib import Path
 
 import pytest
-
 from specsmith.config import ProjectConfig, ProjectType
 from specsmith.integrations import get_adapter, list_adapters
 from specsmith.integrations.claude_code import ClaudeCodeAdapter

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26}/tests/test_scaffolder.py

@@ -7,7 +7,6 @@ from __future__ import annotations
 from pathlib import Path
 
 import pytest
-
 from specsmith.config import Platform, ProjectConfig, ProjectType
 from specsmith.scaffolder import scaffold_project
 

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26}/tests/test_smoke.py

@@ -4,9 +4,10 @@
 
 from importlib.metadata import version as _pkg_version
 
-from specsmith import __version__
 from specsmith.config import Platform, ProjectConfig, ProjectType
 
+from specsmith import __version__
+
 
 def test_version():
     """Version string matches installed package metadata."""

{specsmith-0.1.4.dev24 → specsmith-0.1.4.dev26}/tests/test_vcs.py

@@ -7,7 +7,6 @@ from __future__ import annotations
 from pathlib import Path
 
 import pytest
-
 from specsmith.config import Platform, ProjectConfig, ProjectType
 from specsmith.vcs import get_platform, list_platforms
 from specsmith.vcs.base import CommandResult