specsmith 0.6.0.dev232__tar.gz → 0.6.0.dev234__tar.gz

{specsmith-0.6.0.dev232/src/specsmith.egg-info → specsmith-0.6.0.dev234}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.6.0.dev232
+Version: 0.6.0.dev234
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT
@@ -53,6 +53,11 @@ Provides-Extra: gui
 Requires-Dist: PySide6>=6.6; extra == "gui"
 Provides-Extra: ag2
 Requires-Dist: ag2[ollama]; extra == "ag2"
+Provides-Extra: history-semantic
+Requires-Dist: sentence-transformers>=2.2; extra == "history-semantic"
+Requires-Dist: numpy>=1.24; extra == "history-semantic"
+Provides-Extra: voice
+Requires-Dist: whisper-cpp-python>=0.2; extra == "voice"
 Provides-Extra: agent
 Requires-Dist: anthropic>=0.56; extra == "agent"
 Requires-Dist: openai>=1.0; extra == "agent"

{specsmith-0.6.0.dev232 → specsmith-0.6.0.dev234}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.6.0.dev232"
+version = "0.6.0.dev234"
 description = "Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands."
 readme = "README.md"
 license = "MIT"
@@ -67,6 +67,11 @@ mistral = ["openai>=1.0"]  # Mistral uses the openai SDK pointed at api.mistral.
 gui = ["PySide6>=6.6"]
 # AG2 agent shell (Planner/Builder/Verifier over Ollama)
 ag2 = ["ag2[ollama]"]
+# Optional semantic backend for `specsmith history search --semantic` (REQ-135).
+# Falls back gracefully to keyword matching if these are not installed.
+history-semantic = ["sentence-transformers>=2.2", "numpy>=1.24"]
+# Optional whisper-cpp wrapper for the voice agent input (REQ-141).
+voice = ["whisper-cpp-python>=0.2"]
 # Install all optional LLM providers
 agent = ["anthropic>=0.56", "openai>=1.0"]
 # Convenience bundle: everything
@@ -138,6 +143,12 @@ module = [
     "yaml.*",
     "keyring",   # optional OS credential store; stubs not published
     "keyring.*",
+    "numpy",     # optional [history-semantic] extra (REQ-135)
+    "numpy.*",
+    "sentence_transformers",  # optional [history-semantic] extra (REQ-135)
+    "sentence_transformers.*",
+    "whisper_cpp_python",  # optional [voice] extra (REQ-141)
+    "whisper_cpp_python.*",
 ]
 ignore_missing_imports = true
 

specsmith-0.6.0.dev234/src/specsmith/agent/voice.py

@@ -0,0 +1,135 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 BitConcepts, LLC. All rights reserved.
+"""Voice transcription wrapper (REQ-141).
+
+Wraps the optional ``whisper_cpp_python`` library so the rest of specsmith
+can call ``transcribe(path)`` without caring whether the extra is
+installed. When the library is missing, ``transcribe`` raises
+``VoiceUnavailableError`` with a friendly install hint so the caller can
+surface it to the user.
+
+The wrapper supports three modes:
+
+* **real** -- ``whisper_cpp_python`` is installed and a model file is
+  available (auto-located under ``~/.specsmith/voice/`` or pointed to via
+  ``SPECSMITH_VOICE_MODEL``). Real audio decoding.
+* **stub** -- ``SPECSMITH_VOICE_STUB=<text>`` is set. Returns the literal
+  text without touching the audio file. Used by tests and CI so we don't
+  need to ship a 500MB model file.
+* **unavailable** -- neither of the above. ``transcribe`` raises.
+
+The CLI exposes this as ``specsmith voice transcribe <wav>``.
+"""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+
+
+class VoiceUnavailableError(RuntimeError):
+    """Raised when whisper-cpp is not installed and no stub is set."""
+
+
+@dataclass
+class TranscribeResult:
+    text: str
+    backend: str  # 'whisper-cpp', 'stub', 'unavailable'
+    model: str = ""
+    duration_s: float = 0.0
+
+    def to_dict(self) -> dict[str, object]:
+        return {
+            "text": self.text,
+            "backend": self.backend,
+            "model": self.model,
+            "duration_s": round(self.duration_s, 3),
+        }
+
+
+def default_model_dir() -> Path:
+    return Path.home() / ".specsmith" / "voice"
+
+
+def _resolve_model_path() -> Path | None:
+    """Return the on-disk model path, or None if no model is configured."""
+    env = os.environ.get("SPECSMITH_VOICE_MODEL", "").strip()
+    if env:
+        p = Path(env)
+        if p.is_file():
+            return p
+    # Auto-locate the smallest .bin under ~/.specsmith/voice/
+    voice_dir = default_model_dir()
+    if voice_dir.is_dir():
+        candidates = sorted(voice_dir.glob("*.bin"), key=lambda x: x.stat().st_size)
+        if candidates:
+            return candidates[0]
+    return None
+
+
+def is_available() -> bool:
+    """Cheap probe: True iff transcription would succeed without raising."""
+    if os.environ.get("SPECSMITH_VOICE_STUB", "").strip():
+        return True
+    try:
+        import whisper_cpp_python  # noqa: F401  (presence-only check)
+    except Exception:  # noqa: BLE001
+        return False
+    return _resolve_model_path() is not None
+
+
+def transcribe(path: Path) -> TranscribeResult:
+    """Transcribe a wav/flac/mp3 file to text.
+
+    Order of resolution:
+    1. If ``SPECSMITH_VOICE_STUB`` is set, return its value verbatim. This
+       lets tests run without a model file.
+    2. Otherwise import ``whisper_cpp_python`` and run a real transcription.
+    3. If neither is available, raise :class:`VoiceUnavailableError` with
+       an actionable message.
+    """
+    import time as _time
+
+    if not path.exists():
+        raise FileNotFoundError(f"audio file not found: {path}")
+
+    stub = os.environ.get("SPECSMITH_VOICE_STUB", "").strip()
+    if stub:
+        return TranscribeResult(text=stub, backend="stub")
+
+    try:
+        import whisper_cpp_python
+    except Exception as exc:  # noqa: BLE001
+        raise VoiceUnavailableError(
+            "whisper-cpp-python is not installed. Run "
+            "`pipx inject specsmith whisper-cpp-python` "
+            "(or `pip install specsmith[voice]`)."
+        ) from exc
+
+    model_path = _resolve_model_path()
+    if model_path is None:
+        raise VoiceUnavailableError(
+            "No whisper model found. Set SPECSMITH_VOICE_MODEL or place a "
+            f".bin model under {default_model_dir()}."
+        )
+
+    start = _time.perf_counter()
+    whisper = whisper_cpp_python.Whisper(model_path=str(model_path))
+    out = whisper.transcribe(str(path))
+    text = out.get("text") if isinstance(out, dict) else str(out)
+    return TranscribeResult(
+        text=str(text or "").strip(),
+        backend="whisper-cpp",
+        model=model_path.name,
+        duration_s=_time.perf_counter() - start,
+    )
+
+
+__all__ = [
+    "TranscribeResult",
+    "VoiceUnavailableError",
+    "default_model_dir",
+    "is_available",
+    "transcribe",
+]

specsmith-0.6.0.dev234/src/specsmith/block_export.py

@@ -0,0 +1,106 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 BitConcepts, LLC. All rights reserved.
+"""Per-block share/export for `specsmith chat` (REQ-134).
+
+Reads ``.specsmith/sessions/<session_id>/events.jsonl`` (the chat replay log
+or, fallback, ``turns.jsonl``) and slices a single block out as a
+self-contained Markdown / JSON / HTML snippet.
+"""
+
+from __future__ import annotations
+
+import html
+import json
+from pathlib import Path
+from typing import Any
+
+
+def _events_path(project_dir: Path, session_id: str) -> Path | None:
+    base = project_dir / ".specsmith" / "sessions" / session_id
+    candidates = [
+        base / "events.jsonl",
+        base / "turns.jsonl",
+    ]
+    for c in candidates:
+        if c.is_file():
+            return c
+    return None
+
+
+def _read_events(events_path: Path) -> list[dict[str, Any]]:
+    out: list[dict[str, Any]] = []
+    for line in events_path.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            obj = json.loads(line)
+        except ValueError:
+            continue
+        if isinstance(obj, dict):
+            out.append(obj)
+    return out
+
+
+def slice_block(events: list[dict[str, Any]], block_id: str) -> list[dict[str, Any]]:
+    """Return all events tagged with ``block_id``, plus the bracketing
+    block_start/block_complete events that defined it.
+    """
+    out: list[dict[str, Any]] = []
+    for evt in events:
+        if evt.get("block_id") == block_id or evt.get("id") == block_id:
+            out.append(evt)
+    return out
+
+
+def export_block(
+    project_dir: Path,
+    session_id: str,
+    block_id: str,
+    *,
+    fmt: str = "md",
+) -> str:
+    """Export the events for ``block_id`` as a string in ``fmt``.
+
+    Raises FileNotFoundError if no session log exists.
+    Raises KeyError if the block is not found.
+    """
+    events_path = _events_path(project_dir, session_id)
+    if events_path is None:
+        raise FileNotFoundError(f"No session log for {session_id} in {project_dir}")
+    events = _read_events(events_path)
+    matching = slice_block(events, block_id)
+    if not matching:
+        raise KeyError(f"block_id {block_id} not found in session {session_id}")
+    if fmt == "json":
+        return json.dumps(matching, indent=2)
+    if fmt == "html":
+        rows = "".join(
+            f"<li><pre>{html.escape(json.dumps(evt, indent=2))}</pre></li>" for evt in matching
+        )
+        return (
+            f"<!DOCTYPE html><html><head><meta charset='utf-8'>"
+            f"<title>specsmith block {html.escape(block_id)}</title></head>"
+            f"<body><h1>Block {html.escape(block_id)}</h1>"
+            f"<p>session {html.escape(session_id)}</p><ol>{rows}</ol></body></html>"
+        )
+    # default: markdown
+    lines: list[str] = [
+        f"# Block `{block_id}`",
+        f"_session_: `{session_id}`",
+        "",
+    ]
+    for evt in matching:
+        kind = str(evt.get("type", "event"))
+        lines.append(f"## {kind}")
+        if "text" in evt:
+            lines.append(str(evt["text"]))
+        else:
+            lines.append("```json")
+            lines.append(json.dumps(evt, indent=2))
+            lines.append("```")
+        lines.append("")
+    return "\n".join(lines)
+
+
+__all__ = ["export_block", "slice_block"]