buildlog 0.8.0__py3-none-any.whl → 0.9.0__py3-none-any.whl

buildlog/cli.py

@@ -298,11 +298,11 @@ def new(slug: str, entry_date: str | None, quick: bool):
     # Determine date
     if entry_date:
         try:
-            # Validate date format
-            year, month, day = entry_date.split("-")
-            date_str = f"{int(year):04d}-{int(month):02d}-{int(day):02d}"
+            # Validate date format AND range (month 1-12, day 1-31)
+            parsed = datetime.strptime(entry_date, "%Y-%m-%d").date()
+            date_str = parsed.isoformat()
         except ValueError:
-            click.echo("Invalid date format. Use YYYY-MM-DD.", err=True)
+            click.echo("Invalid date. Use YYYY-MM-DD with valid values.", err=True)
             raise SystemExit(1)
     else:
         date_str = date.today().isoformat()
@@ -331,6 +331,161 @@ def new(slug: str, entry_date: str | None, quick: bool):
     click.echo(f"\nOpen it: $EDITOR {entry_path}")
 
 
+@main.command(
+    context_settings={"ignore_unknown_options": True, "allow_extra_args": True}
+)
+@click.option(
+    "--slug",
+    "-s",
+    default=None,
+    help="Entry slug (default: derived from branch name)",
+)
+@click.option(
+    "--entry",
+    "-e",
+    type=click.Path(),
+    default=None,
+    help="Explicit entry file to append to",
+)
+@click.option(
+    "--no-entry",
+    is_flag=True,
+    help="Skip buildlog entry update (just run git commit)",
+)
+@click.pass_context
+def commit(ctx, slug: str | None, entry: str | None, no_entry: bool):
+    """Commit code and update the buildlog entry in one step.
+
+    Wraps `git commit` and appends commit context to today's buildlog
+    entry. If no entry exists for today, creates one automatically.
+
+    All unknown options/arguments are passed through to git commit.
+
+    Examples:
+
+        buildlog commit -m "feat: add LLM extractor"
+        buildlog commit --slug llm-extractor -m "feat: add LLM extractor"
+        buildlog commit --no-entry -m "chore: formatting"
+    """
+    buildlog_dir = Path("buildlog")
+
+    # Build git commit command — extra args are passed through from Click context
+    git_cmd = ["git", "commit", *ctx.args]
+
+    # Run git commit first
+    result = subprocess.run(git_cmd, capture_output=True, text=True)
+    sys.stdout.write(result.stdout)
+    sys.stderr.write(result.stderr)
+
+    if result.returncode != 0:
+        raise SystemExit(result.returncode)
+
+    if no_entry or not buildlog_dir.exists():
+        return
+
+    # Get commit info from what we just committed
+    try:
+        commit_hash = subprocess.run(
+            ["git", "rev-parse", "--short", "HEAD"],
+            capture_output=True,
+            text=True,
+            check=True,
+        ).stdout.strip()
+        commit_msg = subprocess.run(
+            ["git", "log", "-1", "--format=%s"],
+            capture_output=True,
+            text=True,
+            check=True,
+        ).stdout.strip()
+        # diff-tree needs special handling for root commit
+        diff_result = subprocess.run(
+            ["git", "diff-tree", "--no-commit-id", "--name-only", "-r", "HEAD"],
+            capture_output=True,
+            text=True,
+        )
+        if diff_result.returncode == 0 and diff_result.stdout.strip():
+            files_changed = diff_result.stdout.strip()
+        else:
+            # Root commit fallback
+            files_changed = subprocess.run(
+                ["git", "diff", "--name-only", "--cached", "HEAD~1"],
+                capture_output=True,
+                text=True,
+            ).stdout.strip()
+            if not files_changed:
+                # Truly initial commit — list all tracked files
+                files_changed = subprocess.run(
+                    ["git", "ls-tree", "--name-only", "-r", "HEAD"],
+                    capture_output=True,
+                    text=True,
+                ).stdout.strip()
+    except subprocess.CalledProcessError:
+        click.echo("Warning: could not read commit info", err=True)
+        return
+
+    # Resolve entry file
+    today = date.today().isoformat()
+    entry_path = _resolve_entry_path(buildlog_dir, today, slug, entry)
+
+    # Append commit block
+    commit_block = f"\n### `{commit_hash}` — {commit_msg}\n\n"
+    if files_changed:
+        file_list = files_changed.split("\n")
+        commit_block += "Files:\n"
+        for f in file_list[:20]:  # cap at 20 to avoid noise
+            commit_block += f"- `{f}`\n"
+        if len(file_list) > 20:
+            commit_block += f"- ...and {len(file_list) - 20} more\n"
+    commit_block += "\n"
+
+    # Ensure commits section exists, append to it
+    if entry_path.exists():
+        content = entry_path.read_text()
+        if "## Commits" not in content:
+            content = content.rstrip() + "\n\n## Commits\n"
+        content += commit_block
+    else:
+        # Auto-create minimal entry
+        content = f"# {today}\n\n## Commits\n{commit_block}"
+
+    entry_path.write_text(content)
+    click.echo(f"buildlog: updated {entry_path}")
+
+
+def _resolve_entry_path(
+    buildlog_dir: Path, today: str, slug: str | None, explicit: str | None
+) -> Path:
+    """Find or create the entry path for today."""
+    if explicit:
+        return Path(explicit)
+
+    # Check for existing entry with today's date
+    existing = list(buildlog_dir.glob(f"{today}-*.md"))
+    if existing:
+        return existing[0]
+
+    # Derive slug from branch name if not provided
+    if slug is None:
+        try:
+            branch = subprocess.run(
+                ["git", "branch", "--show-current"],
+                capture_output=True,
+                text=True,
+                check=True,
+            ).stdout.strip()
+            # Clean branch name into slug
+            slug = branch.split("/")[-1]  # strip prefix like feat/
+            slug = slug.lower().replace("_", "-")
+            slug = "".join(c for c in slug if c.isalnum() or c == "-")
+        except subprocess.CalledProcessError:
+            slug = "session"
+
+    if not slug:
+        slug = "session"
+
+    return buildlog_dir / f"{today}-{slug}.md"
+
+
 @main.command("list")
 def list_entries():
     """List all buildlog entries."""
@@ -1277,6 +1432,7 @@ PERSONAS = {
     "security_karen": "OWASP Top 10 security review",
     "test_terrorist": "Comprehensive testing coverage audit",
     "ruthless_reviewer": "Code quality and functional principles",
+    "bragi": "Detect and flag LLM-ish prose patterns in markdown",
 }
 
 
@@ -1656,6 +1812,69 @@ def gauntlet_learn(issues_file: str, source: str | None, output_json: bool):
         click.echo(f"  Total processed: {result.total_issues_processed}")
 
 
+@gauntlet.command("generate")
+@click.argument("source_text", type=click.Path(exists=True))
+@click.option("--persona", "-p", required=True, help="Persona name for the seed file")
+@click.option(
+    "--output-dir",
+    "-o",
+    type=click.Path(),
+    default=".buildlog/seeds",
+    help="Output directory for seed YAML",
+)
+@click.option("--dry-run", is_flag=True, help="Preview without writing")
+def gauntlet_generate(source_text: str, persona: str, output_dir: str, dry_run: bool):
+    """Generate seed rules from source text using LLM extraction.
+
+    Runs the seed engine pipeline with LLMExtractor to produce
+    a YAML seed file from arbitrary source content.
+
+    Examples:
+
+        buildlog gauntlet generate docs/security.md --persona security_karen
+        buildlog gauntlet generate notes.txt -p test_terrorist --dry-run
+    """
+    import json as json_module
+
+    from buildlog.llm import get_llm_backend
+    from buildlog.seed_engine import Pipeline, Source, SourceType
+
+    backend = get_llm_backend()
+    if backend is None:
+        click.echo(
+            "No LLM backend available. Install ollama or set ANTHROPIC_API_KEY.",
+            err=True,
+        )
+        raise SystemExit(1)
+
+    content = Path(source_text).read_text()
+    source = Source(
+        name=Path(source_text).stem,
+        url=f"file://{Path(source_text).resolve()}",
+        source_type=SourceType.REFERENCE_DOC,
+        domain=persona.split("_")[0] if "_" in persona else "general",
+        description=content,
+    )
+
+    pipeline = Pipeline.with_llm(
+        persona=persona,
+        backend=backend,
+        source_content={source.url: content},
+    )
+
+    if dry_run:
+        preview = pipeline.dry_run([source])
+        click.echo(json_module.dumps(preview, indent=2))
+        return
+
+    out = Path(output_dir)
+    out.mkdir(parents=True, exist_ok=True)
+    result = pipeline.run([source], output_dir=out)
+    click.echo(f"Generated {result.rule_count} rules for {persona}")
+    if result.output_path:
+        click.echo(f"Seed file: {result.output_path}")
+
+
 @gauntlet.command("loop")
 @click.argument("target", type=click.Path(exists=True))
 @click.option(

buildlog/core/operations.py

@@ -653,7 +653,7 @@ def reject(
         rejected = {"rejected_at": {}, "skill_ids": []}
 
     # Add new rejections
-    now = datetime.now().isoformat()
+    now = datetime.now(timezone.utc).isoformat()
     newly_rejected: list[str] = []
     for skill_id in skill_ids:
         if skill_id not in rejected["skill_ids"]:
@@ -2035,6 +2035,18 @@ def gauntlet_process_issues(
     )
 
 
+def _sanitize_for_gh(text: str, max_len: int = 256) -> str:
+    """Sanitize text for GitHub issue fields.
+
+    Defense-in-depth: we use list args (not shell=True) for subprocess,
+    but sanitize anyway to prevent injection via gh's argument parsing.
+    """
+    sanitized = text.replace("\n", " ").replace("\r", " ")
+    if len(sanitized) > max_len:
+        sanitized = sanitized[: max_len - 3] + "..."
+    return sanitized.strip()
+
+
 def gauntlet_accept_risk(
     remaining_issues: list[dict],
     create_github_issues: bool = False,
@@ -2062,17 +2074,6 @@ def gauntlet_accept_risk(
             description = issue.get("description", "")
             location = issue.get("location", "")
 
-            # Sanitize inputs for GitHub issue creation
-            # Note: We use list args (not shell=True), so this is defense-in-depth
-            def _sanitize_for_gh(text: str, max_len: int = 256) -> str:
-                """Sanitize text for GitHub issue fields."""
-                # Remove/replace problematic characters
-                sanitized = text.replace("\n", " ").replace("\r", " ")
-                # Truncate to max length
-                if len(sanitized) > max_len:
-                    sanitized = sanitized[: max_len - 3] + "..."
-                return sanitized.strip()
-
             safe_severity = _sanitize_for_gh(str(severity), 20)
             safe_rule = _sanitize_for_gh(str(rule), 200)
             safe_description = _sanitize_for_gh(str(description), 1000)
@@ -2116,7 +2117,9 @@ def gauntlet_accept_risk(
                 cmd.extend(["--repo", repo])
 
             try:
-                result = subprocess.run(cmd, capture_output=True, text=True, check=True)
+                result = subprocess.run(
+                    cmd, capture_output=True, text=True, check=True, timeout=30
+                )
                 # gh issue create outputs the URL
                 url = result.stdout.strip()
                 if url:
@@ -2124,6 +2127,9 @@ def gauntlet_accept_risk(
             except subprocess.CalledProcessError as e:
                 # Don't fail entirely, just note the error
                 error = f"Failed to create some GitHub issues: {e.stderr}"
+            except subprocess.TimeoutExpired:
+                error = "GitHub issue creation timed out (30s limit)."
+                break
             except FileNotFoundError:
                 error = "gh CLI not found. Install GitHub CLI to create issues."
                 break

buildlog/llm.py

@@ -28,8 +28,10 @@ __all__ = [
 import json
 import logging
 import os
+import time
 from dataclasses import dataclass, field
 from pathlib import Path
+from types import MappingProxyType
 from typing import Protocol, runtime_checkable
 
 logger = logging.getLogger(__name__)
@@ -84,6 +86,14 @@ class LLMConfig:
     base_url: str | None = None  # Override endpoint
     api_key: str | None = None  # From config or env var
 
+    def __repr__(self) -> str:
+        """Redact api_key to prevent accidental exposure in logs/tracebacks."""
+        key_display = "***" if self.api_key else "None"
+        return (
+            f"LLMConfig(provider={self.provider!r}, model={self.model!r}, "
+            f"base_url={self.base_url!r}, api_key={key_display})"
+        )
+
     @classmethod
     def from_buildlog_config(cls, buildlog_dir: Path) -> LLMConfig | None:
         """Read from .buildlog/config.yml [llm] section."""
@@ -225,6 +235,28 @@ def _parse_json_response(text: str) -> list | dict:
     return json.loads(text)
 
 
+# --- Rate limiting ---
+
+# Minimum seconds between API calls (per-backend instance).
+_MIN_CALL_INTERVAL = 0.5
+
+
+class _RateLimiter:
+    """Simple per-instance rate limiter to prevent API abuse."""
+
+    def __init__(self, min_interval: float = _MIN_CALL_INTERVAL):
+        self._min_interval = min_interval
+        self._last_call: float = 0.0
+
+    def wait(self) -> None:
+        """Block until min_interval has elapsed since last call."""
+        now = time.monotonic()
+        elapsed = now - self._last_call
+        if elapsed < self._min_interval:
+            time.sleep(self._min_interval - elapsed)
+        self._last_call = time.monotonic()
+
+
 # --- Implementations ---
 
 
@@ -235,6 +267,7 @@ class OllamaBackend:
         self._model = model
         self._base_url = base_url
         self._resolved_model: str | None = None
+        self._rate_limiter = _RateLimiter()
 
     def _get_model(self) -> str:
         """Resolve model name, auto-detecting largest if not specified."""
@@ -269,6 +302,7 @@ class OllamaBackend:
 
     def _chat(self, prompt: str) -> str:
         """Send a prompt to Ollama and return the response text."""
+        self._rate_limiter.wait()
         import ollama as ollama_lib
 
         kwargs = {
@@ -334,6 +368,11 @@ class AnthropicBackend:
         self._model = model or "claude-haiku-4-20250514"
         self._api_key = api_key or os.environ.get("ANTHROPIC_API_KEY")
         self._client = None
+        self._rate_limiter = _RateLimiter()
+
+    def __repr__(self) -> str:
+        """Redact API key from repr to prevent exposure in logs/tracebacks."""
+        return f"AnthropicBackend(model={self._model!r}, api_key=***)"
 
     def _get_client(self):
         """Lazy-load the Anthropic client."""
@@ -351,6 +390,7 @@ class AnthropicBackend:
 
     def _chat(self, prompt: str) -> str:
         """Send a prompt to Claude and return the response text."""
+        self._rate_limiter.wait()
         client = self._get_client()
         response = client.messages.create(
             model=self._model,
@@ -402,15 +442,22 @@ class AnthropicBackend:
 
 # --- Registry ---
 
-PROVIDERS: dict[str, type] = {
+_PROVIDERS: dict[str, type] = {
     "ollama": OllamaBackend,
     "anthropic": AnthropicBackend,
 }
+# Public read-only view. Use register_provider() to add entries.
+PROVIDERS: MappingProxyType[str, type] = MappingProxyType(_PROVIDERS)
 
 
 def register_provider(name: str, cls: type) -> None:
-    """Register a new LLM provider backend."""
-    PROVIDERS[name] = cls
+    """Register a new LLM provider backend.
+
+    This is the only sanctioned way to mutate the provider registry.
+    """
+    if not isinstance(name, str) or not name.strip():
+        raise ValueError("Provider name must be a non-empty string")
+    _PROVIDERS[name] = cls
 
 
 def get_llm_backend(
@@ -439,7 +486,7 @@ def get_llm_backend(
         logger.info("No LLM provider available, using regex fallback")
         return None
 
-    provider_cls = PROVIDERS.get(config.provider)
+    provider_cls = _PROVIDERS.get(config.provider)
     if provider_cls is None:
         logger.warning("Unknown LLM provider: %s", config.provider)
         return None

buildlog/mcp/server.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from mcp.server.fastmcp import FastMCP
 
 from buildlog.mcp.tools import (
+    buildlog_bandit_status,
     buildlog_diff,
     buildlog_experiment_end,
     buildlog_experiment_metrics,
@@ -43,6 +44,9 @@ mcp.tool()(buildlog_experiment_report)
 mcp.tool()(buildlog_gauntlet_issues)
 mcp.tool()(buildlog_gauntlet_accept_risk)
 
+# Bandit tools
+mcp.tool()(buildlog_bandit_status)
+
 
 def main() -> None:
     """Run the MCP server."""

buildlog/seed_engine/__init__.py

@@ -33,6 +33,7 @@ from buildlog.seed_engine.categorizers import (
 )
 from buildlog.seed_engine.extractors import ManualExtractor, RuleExtractor
 from buildlog.seed_engine.generators import SeedGenerator
+from buildlog.seed_engine.llm_extractor import LLMExtractor
 from buildlog.seed_engine.models import (
     CandidateRule,
     CategorizedRule,
@@ -59,6 +60,7 @@ __all__ = [
     # Extractors
     "RuleExtractor",
     "ManualExtractor",
+    "LLMExtractor",
     # Categorizers
     "Categorizer",
     "TagBasedCategorizer",

buildlog/seed_engine/llm_extractor.py

@@ -0,0 +1,121 @@
+"""LLM-backed rule extraction for the seed engine pipeline.
+
+Adapts LLMBackend.extract_rules() into the RuleExtractor interface,
+bridging the LLM module with the seed engine's 4-step pipeline.
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Any
+
+from buildlog.seed_engine.extractors import RuleExtractor
+from buildlog.seed_engine.models import CandidateRule, Source
+
+if TYPE_CHECKING:
+    from buildlog.llm import LLMBackend
+
+logger = logging.getLogger(__name__)
+
+_PLACEHOLDER = "Not specified by LLM"
+
+
+class LLMExtractor(RuleExtractor):
+    """LLM-backed rule extraction from source content.
+
+    Wraps any LLMBackend to produce CandidateRules with full
+    defensibility fields. Fields the LLM doesn't populate get
+    placeholder values so downstream validation passes.
+
+    Usage:
+        from buildlog.llm import OllamaBackend
+        from buildlog.seed_engine.llm_extractor import LLMExtractor
+
+        backend = OllamaBackend(model="llama3.2")
+        extractor = LLMExtractor(backend, source_content={"https://...": "..."})
+
+        rules = extractor.extract(source)
+    """
+
+    def __init__(
+        self,
+        backend: LLMBackend,
+        source_content: dict[str, str] | None = None,
+    ) -> None:
+        """Initialize with an LLM backend.
+
+        Args:
+            backend: Any LLMBackend (Ollama, Anthropic, etc.).
+            source_content: Optional map of source.url → text content.
+                For sources that need pre-fetched content.
+        """
+        self._backend = backend
+        self._source_content = source_content or {}
+
+    def extract(self, source: Source) -> list[CandidateRule]:
+        """Extract candidate rules from a source via LLM.
+
+        Resolution for content:
+        1. source_content dict (keyed by source.url)
+        2. source.description as fallback
+
+        Returns empty list on LLM failure (logged, not raised).
+        """
+        content = self._source_content.get(source.url, "").strip()
+        if not content:
+            content = source.description.strip()
+        if not content:
+            logger.warning("No content for source %s, skipping", source.name)
+            return []
+
+        try:
+            extracted = self._backend.extract_rules(content)
+        except Exception:
+            logger.exception("LLM extraction failed for %s", source.name)
+            return []
+
+        candidates: list[CandidateRule] = []
+        for er in extracted:
+            if not er.rule.strip():
+                continue
+
+            metadata: dict[str, Any] = {
+                "extractor": "llm",
+                "severity": er.severity,
+                "scope": er.scope,
+            }
+            # Include backend class name (public info only)
+            metadata["backend_type"] = type(self._backend).__name__
+
+            candidates.append(
+                CandidateRule(
+                    rule=er.rule,
+                    context=er.context or _PLACEHOLDER,
+                    antipattern=er.antipattern or _PLACEHOLDER,
+                    rationale=er.rationale or _PLACEHOLDER,
+                    source=source,
+                    raw_tags=[er.category] + er.applicability,
+                    confidence=0.7,
+                    metadata=metadata,
+                )
+            )
+
+        logger.info("LLM extracted %d rules from %s", len(candidates), source.name)
+        return candidates
+
+    def validate(self, rule: CandidateRule) -> list[str]:
+        """Validate a candidate rule.
+
+        Warns on placeholder defensibility fields.
+        Requires non-empty rule text.
+        """
+        issues: list[str] = []
+        if not rule.rule.strip():
+            issues.append("Rule text is empty")
+        if rule.context == _PLACEHOLDER:
+            issues.append("Context is LLM placeholder — consider enriching")
+        if rule.antipattern == _PLACEHOLDER:
+            issues.append("Antipattern is LLM placeholder — consider enriching")
+        if rule.rationale == _PLACEHOLDER:
+            issues.append("Rationale is LLM placeholder — consider enriching")
+        return issues

buildlog/seed_engine/pipeline.py

@@ -12,13 +12,16 @@ from __future__ import annotations
 import logging
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
 from buildlog.seed_engine.categorizers import Categorizer, TagBasedCategorizer
 from buildlog.seed_engine.extractors import ManualExtractor, RuleExtractor
 from buildlog.seed_engine.generators import SeedGenerator
 from buildlog.seed_engine.models import CandidateRule, CategorizedRule, Source
 
+if TYPE_CHECKING:
+    from buildlog.llm import LLMBackend
+
 logger = logging.getLogger(__name__)
 
 
@@ -174,6 +177,7 @@ class Pipeline:
         Returns:
             List of validation issues (empty if valid).
         """
+        allowed_schemes = {"https", "http", "file"}
         issues = []
         for i, source in enumerate(sources):
             prefix = f"Source {i + 1} ({source.name})"
@@ -181,10 +185,50 @@ class Pipeline:
                 issues.append(f"{prefix}: Missing name")
             if not source.url.strip():
                 issues.append(f"{prefix}: Missing URL")
+            else:
+                # Validate URL scheme
+                scheme = (
+                    source.url.split("://")[0].lower() if "://" in source.url else ""
+                )
+                if scheme not in allowed_schemes:
+                    issues.append(
+                        f"{prefix}: URL scheme '{scheme}' not in allowlist {allowed_schemes}"
+                    )
             if not source.domain.strip():
                 issues.append(f"{prefix}: Missing domain")
         return issues
 
+    @classmethod
+    def with_llm(
+        cls,
+        persona: str,
+        backend: LLMBackend,
+        source_content: dict[str, str] | None = None,
+        default_category: str = "general",
+        version: int = 1,
+    ) -> Pipeline:
+        """Convenience constructor wiring LLMExtractor + TagBasedCategorizer.
+
+        Args:
+            persona: Persona name for the seed file.
+            backend: Any LLMBackend implementation.
+            source_content: Optional pre-fetched content map.
+            default_category: Fallback category for uncategorized rules.
+            version: Seed file version.
+
+        Returns:
+            Pipeline configured with LLMExtractor.
+        """
+        from buildlog.seed_engine.llm_extractor import LLMExtractor
+
+        return cls(
+            persona=persona,
+            default_category=default_category,
+            version=version,
+            extractor=LLMExtractor(backend, source_content),
+            categorizer=TagBasedCategorizer(default_category=default_category),
+        )
+
     def dry_run(self, sources: list[Source]) -> dict[str, Any]:
         """Run pipeline without writing, returning preview.
 

buildlog-0.9.0.dist-info/METADATA

@@ -0,0 +1,248 @@
+Metadata-Version: 2.4
+Name: buildlog
+Version: 0.9.0
+Summary: Engineering notebook for AI-assisted development
+Project-URL: Homepage, https://github.com/Peleke/buildlog-template
+Project-URL: Repository, https://github.com/Peleke/buildlog-template
+Author: Peleke Sengstacke
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,buildlog,development,documentation,journal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0.0
+Requires-Dist: copier>=9.0.0
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: pymupdf>=1.26.7
+Requires-Dist: pyyaml>=6.0.0
+Provides-Extra: all
+Requires-Dist: anthropic>=0.40.0; extra == 'all'
+Requires-Dist: mcp>=1.0.0; extra == 'all'
+Requires-Dist: ollama>=0.4.0; extra == 'all'
+Requires-Dist: openai>=1.0.0; extra == 'all'
+Requires-Dist: sentence-transformers>=2.2.0; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.40.0; extra == 'anthropic'
+Provides-Extra: dev
+Requires-Dist: black>=24.0.0; extra == 'dev'
+Requires-Dist: flake8>=7.0.0; extra == 'dev'
+Requires-Dist: isort>=5.13.0; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.5.0; extra == 'dev'
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.6.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
+Provides-Extra: embeddings
+Requires-Dist: sentence-transformers>=2.2.0; extra == 'embeddings'
+Provides-Extra: engine
+Provides-Extra: llm
+Requires-Dist: anthropic>=0.40.0; extra == 'llm'
+Requires-Dist: ollama>=0.4.0; extra == 'llm'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
+Provides-Extra: ollama
+Requires-Dist: ollama>=0.4.0; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# buildlog
+
+### A measurable learning loop for AI-assisted work
+
+[![PyPI](https://img.shields.io/pypi/v/buildlog?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/buildlog/)
+[![Python](https://img.shields.io/pypi/pyversions/buildlog?style=for-the-badge&logo=python&logoColor=white)](https://python.org/)
+[![CI](https://img.shields.io/github/actions/workflow/status/Peleke/buildlog-template/ci.yml?branch=main&style=for-the-badge&logo=github&label=CI)](https://github.com/Peleke/buildlog-template/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
+[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue?style=for-the-badge&logo=github)](https://peleke.github.io/buildlog-template/)
+
+**Track what works. Prove it. Drop what doesn't.**
+
+<img src="assets/hero-banner-perfectdeliberate.png" alt="buildlog - A measurable learning loop for AI-assisted work" width="800"/>
+
+> **RE: The art.** Yes, it's AI-generated. Yes, that's hypocritical for a project about rigor over vibes. Looking for an actual artist to pay for a real logo. If you know someone good, [open an issue](https://github.com/Peleke/buildlog-template/issues) or DM me. Budget exists.
+
+**[Read the full documentation](https://peleke.github.io/buildlog-template/)**
+
+</div>
+
+---
+
+## The Problem
+
+Most AI agents do not learn. They execute without retaining context. You can bolt on memory stores and tool routers, but if the system cannot demonstrably improve its decision-making over time, you have a persistent memory store, not a learning system.
+
+Every AI-assisted work session produces a trajectory: goals, decisions, tool uses, corrections, outcomes. Almost all of this is discarded. The next session starts from scratch with the same blind spots.
+
+buildlog exists to close that gap. It captures structured trajectories from real work, extracts decision patterns, and uses statistical methods to select which patterns to surface in future sessions, then measures whether that selection actually reduced mistakes.
+
+buildlog measures whether the system actually got better, and proves it.
+
+## How It Works
+
+### 1. Capture structured work trajectories
+
+Each session is a dated entry documenting what you did, what went wrong, and what you learned. Each session is a structured record of decisions and outcomes, not a chat transcript.
+
+```bash
+buildlog init          # scaffold a project
+buildlog new my-feature   # start a session
+# ... work ...
+buildlog commit -m "feat: add auth"
+```
+
+### 2. Extract decision patterns as seeds
+
+The seed engine watches your development patterns and extracts **seeds**: atomic observations about what works. A seed might be "always define interfaces before implementations" or "mock at the boundary, not the implementation." Each seed carries a category, a confidence score, and source provenance.
+
+Extraction runs through a pipeline: `sources -> extractors -> categorizers -> generators`. Extractors range from regex-based (fast, cheap, brittle) to LLM-backed (accurate, expensive). The pipeline deduplicates semantically using embeddings.
+
+### 3. Select which patterns to surface using Thompson Sampling
+
+Seeds compete for inclusion in your agent's instruction set. The system treats each seed as an arm in a contextual bandit and uses **Thompson Sampling** to balance exploration (trying under-tested rules) against exploitation (surfacing rules with strong track records).
+
+Each seed maintains a Beta posterior updated by observed outcomes. Over time, the system converges on the rules that actually reduce mistakes in your specific codebase and workflow, not rules that sound good in the abstract.
+
+### 4. Render to every agent format
+
+Selected rules are written into the instruction files your agents actually read:
+
+- `CLAUDE.md` (Claude Code)
+- `.cursorrules` (Cursor)
+- `.github/copilot-instructions.md` (GitHub Copilot)
+- Windsurf, Continue.dev, generic `settings.json`
+
+The same knowledge base renders to every agent format.
+
+```bash
+buildlog skills   # render current policy to agent files
+```
+
+### 5. Close the loop with experiments
+
+Track whether the selected rules are working. Run experiments, measure Repeated Mistake Rate (RMR) across sessions, and get statistical evidence, not feelings, about what improved.
+
+```bash
+buildlog experiment start
+# ... work across sessions ...
+buildlog experiment end
+buildlog experiment report
+```
+
+## What Else Is In the Box
+
+- **Review gauntlet:** automated quality gate with curated reviewer personas. Runs on commits (via Claude Code hooks or CI) and files GitHub issues for findings, categorized by severity.
+- **LLM-backed extraction:** when regex isn't enough, the seed engine can use OpenAI, Anthropic, or Ollama to extract patterns from code and logs. Metered backend tracks token usage and cost.
+- **MCP server:** buildlog exposes itself as an MCP server so agents can query seeds, skills, and build history programmatically during sessions.
+- **npm wrapper:** `npx @peleke.s/buildlog` for JS/TS projects. Thin shim that finds and invokes the Python CLI.
+
+## Current Limits
+
+This is v0.8, not the end state.
+
+- **Extraction quality is uneven.** Regex extractors miss nuance; LLM extractors are accurate but expensive. The middle ground is still being found.
+- **Feedback signals are coarse.** Repeated Mistake Rate works but requires manual tagging. Richer automatic signals (test outcomes, review results, revision distance) are on the roadmap.
+- **Credit assignment is limited.** When multiple rules are active, the system doesn't yet isolate which one was responsible for an outcome.
+- **Single-agent only.** Multi-agent coordination (shared learning across agents) is designed but not implemented.
+- **Long-horizon learning is not modeled.** The bandit operates per-session. Longer arcs of competence building need richer policy models.
+
+The roadmap: contextual bandits (now) -> richer policy models -> longer-horizon RL -> multi-agent coordination. Each step builds on the same foundation: measuring whether rule changes actually reduce mistakes.
+
+## Installation
+
+### Global install (recommended)
+
+```bash
+uv tool install "buildlog[mcp]"   # or: pipx install "buildlog[mcp]"
+```
+
+This puts `buildlog` and `buildlog-mcp` on your PATH. Works from any directory. The `[mcp]` extra is required for the MCP server.
+
+### Per-project (virtual environment)
+
+```bash
+uv pip install "buildlog[mcp]"   # or: pip install "buildlog[mcp]"
+```
+
+Omit `[mcp]` if you only need the CLI.
+
+### For JS/TS projects
+
+```bash
+npx @peleke.s/buildlog init
+```
+
+### MCP server for Claude Code
+
+Add to `~/.claude/claude_code_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "buildlog": {
+      "command": "buildlog-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+This exposes buildlog tools (seeds, skills, experiments, gauntlet, bandit status) to any Claude Code session.
+
+## Quick Start
+
+```bash
+buildlog init              # scaffold a project (run in any repo)
+buildlog new my-feature    # start a session
+# ... work ...
+buildlog distill && buildlog skills
+buildlog experiment start
+# ... work across sessions ...
+buildlog experiment end
+buildlog experiment report
+```
+
+## Documentation
+
+| Section | Description |
+|---------|------------|
+| [Installation](https://peleke.github.io/buildlog-template/getting-started/installation/) | Setup, extras, and initialization |
+| [Quick Start](https://peleke.github.io/buildlog-template/getting-started/quick-start/) | Full pipeline walkthrough |
+| [Core Concepts](https://peleke.github.io/buildlog-template/getting-started/concepts/) | The problem, the claim, and the metric |
+| [CLI Reference](https://peleke.github.io/buildlog-template/guides/cli-reference/) | Every command documented |
+| [MCP Integration](https://peleke.github.io/buildlog-template/guides/mcp-integration/) | Claude Code setup and available tools |
+| [Experiments](https://peleke.github.io/buildlog-template/guides/experiments/) | Running and measuring experiments |
+| [Review Gauntlet](https://peleke.github.io/buildlog-template/guides/review-gauntlet/) | Reviewer personas and the gauntlet loop |
+| [Multi-Agent Setup](https://peleke.github.io/buildlog-template/guides/multi-agent/) | Render rules to any AI coding agent |
+| [Theory](https://peleke.github.io/buildlog-template/theory/00-background/) | The math behind Thompson Sampling |
+| [Philosophy](https://peleke.github.io/buildlog-template/philosophy/) | Principles and honest limitations |
+
+## Contributing
+
+```bash
+git clone https://github.com/Peleke/buildlog-template
+cd buildlog-template
+uv venv && source .venv/bin/activate
+uv pip install -e ".[dev]"
+pytest
+```
+
+We're especially interested in better context representations, credit assignment approaches, statistical methodology improvements, and real-world experiment results (positive or negative).
+
+## License
+
+MIT License. See [LICENSE](./LICENSE)

{buildlog-0.8.0.dist-info → buildlog-0.9.0.dist-info}/RECORD

@@ -1,15 +1,15 @@
 buildlog/__init__.py,sha256=wxluyg3fDOiaKUAOJa0cav39hwtNJS5Y_0X20uL_yi4,90
-buildlog/cli.py,sha256=G2d2N2cmC3HEiYc6_mQhRyW8PLHzrHr2Kx38ooQsMlU,59456
+buildlog/cli.py,sha256=CZUG3xYBfdyP47SDyvIgvjcfYDcHfV6ijGAr0B_7t1Y,66683
 buildlog/confidence.py,sha256=jPvN0_3drGHQG1C7iUxUtYjKC62nNKsHHxu6WXMfJFg,10137
 buildlog/distill.py,sha256=PL7UBToBb27BrCOTWGBTDIXGggtrUumHHBs0_MfG6vY,14166
 buildlog/embeddings.py,sha256=vPydWjJVkYp172zFou-lJ737qsu6vRMQAMs143RGIpA,12364
-buildlog/llm.py,sha256=vXFT03BZVI8GMX-ybSK18SoeABaZbr_B2KXm8WsNews,15278
+buildlog/llm.py,sha256=t_3KnJ_eBmrtHaay4owG3EgGbJrVp_T379P0tTuyJf8,16986
 buildlog/seeds.py,sha256=L-lzO7rrDjMdVHcYKvEBm6scVDfCmFD0koiyafMZDLo,8596
 buildlog/skills.py,sha256=3CihyyAFfJh0w0VNXQauNhGm_RM8m_GIO1iiNLNPmsQ,33789
 buildlog/stats.py,sha256=2WdHdmzUNGobtWngmm9nA_UmqM7DQeAnZL8_rLQN8aw,13256
 buildlog/core/__init__.py,sha256=gPd6ava_sei0sYIS4NdeHgCVwJ2wEjyLt-Rxz_11IWU,1626
 buildlog/core/bandit.py,sha256=0z58s42jpQiBgXdjb465apenWdBVTvoc7bDOcnAcPLo,24565
-buildlog/core/operations.py,sha256=4gElPJBG9zlXoXO6CPTolwoRrd45DOIV6X1SAQbF3zE,70205
+buildlog/core/operations.py,sha256=cL2w2Lrk7SBwha1aN9_t9WmQwi0OckCpAaGHCXDQztI,70249
 buildlog/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 buildlog/data/seeds/security_karen.yaml,sha256=Hjwp4j6FB-e0vCXp6AkyhAEkwASR4H1owdhPBID740E,8775
 buildlog/data/seeds/test_terrorist.yaml,sha256=-QY2x6d0LrlM6msMYaYwR43Wny9ZybQmU7pH_E7gSB0,11113
@@ -20,7 +20,7 @@ buildlog/engine/embeddings.py,sha256=78InITcBbaPZ29tUlb4hJNNVZ1fhxstvVa2fYvOh6QA
 buildlog/engine/experiments.py,sha256=38f_UsbY4TP3LTGM9yUsZxoXqxUGOxmLCoYrfZqjVks,20041
 buildlog/engine/types.py,sha256=W7U2B4TE79xACV0cuaidKevmTEskxqXfltH5hjIxV5k,734
 buildlog/mcp/__init__.py,sha256=jCLNUkYFrDcPd5dY9xbaaVANl-ZzdPim1BykgGY7f7U,334
-buildlog/mcp/server.py,sha256=vzgT_-SUWNNx9bvABJBgT7rHNGPx_nB7pVo-04WbwjI,1249
+buildlog/mcp/server.py,sha256=IlE-xkW5gaOs5wkgusncRD9ugV70FRB6TKDanIqPaoc,1328
 buildlog/mcp/tools.py,sha256=k1f6R7Dgcx0VIKzTNezkcRc0UVkWXWkk-uGkRq1sIiw,17578
 buildlog/render/__init__.py,sha256=jj-o-vPdqpivdFKK85xskCOT8Zn_2tb3Q5Jb0gWLjAg,2567
 buildlog/render/base.py,sha256=gQfvOsH1zttAo10xtEyNsAbqZ4NRSPiDihO-aiGgTsw,533
@@ -32,23 +32,24 @@ buildlog/render/settings_json.py,sha256=4DS5OWksPrFCa7MIgWIu0t4rxYmItpMdGfTqMX3a
 buildlog/render/skill.py,sha256=_7umIS1Ms1oQ2_PopYueFjX41nMq1p28yJp6DhXFdgU,5981
 buildlog/render/tracking.py,sha256=1y_Mf1s3KblV8TC0W9x2a_ynSJHLwkVZJcW1gs1a6q4,1786
 buildlog/render/windsurf.py,sha256=jfJLb-luQLjdBM38_KKp0mZ08bUSDTBPxSLOIFWxawQ,3047
-buildlog/seed_engine/__init__.py,sha256=f2LYSAs_D1bK4CW_pt54UEmy_SB1u1MOEJlKqM7_R7E,1869
+buildlog/seed_engine/__init__.py,sha256=QHo59cq-Ar_M6UthSOu_zpfYR1OF2ePu1qWrbgQqLak,1949
 buildlog/seed_engine/categorizers.py,sha256=uzatJQPG4Vf7z7ZAeyQbL-bVJ8cUKBHG-3U93-BFIRQ,4649
 buildlog/seed_engine/extractors.py,sha256=rkztg62LzFH018ob5Tl1eFp_yfPo8syn3Ib4h6bAyK4,4824
 buildlog/seed_engine/generators.py,sha256=T3N3uHg359xSBypIGmvVWYI0Qh8WLlGIFQWX0_gs0I4,4358
+buildlog/seed_engine/llm_extractor.py,sha256=nfTmN4vuEiPQuhiL_2DX1QZ7TZlDR2vxYy0tVrkf2Vc,4124
 buildlog/seed_engine/models.py,sha256=qESSuoF3CJy8pp96E3Vmb38V-snzeaW0Xg0RfbH8v1U,3418
-buildlog/seed_engine/pipeline.py,sha256=wLdcjyA_B4wFEb2iKwRCUGkX-oaVu9OXIcmLcEsJN6s,6527
+buildlog/seed_engine/pipeline.py,sha256=cyR2Vf32Hf0PK5DxnaFcq56ygjJIiJWiIkHY4Uz7AS8,8082
 buildlog/seed_engine/sources.py,sha256=8j9oUFZCSKMr5VpIuAxTPY3wTzfTEmw6M_41_aismiE,11184
-buildlog-0.8.0.data/data/share/buildlog/copier.yml,sha256=hD_UcLGB9eDxTGkWjHAvUoiqQKhLC0w3G-kPKX_p43I,802
-buildlog-0.8.0.data/data/share/buildlog/post_gen.py,sha256=XFlo40LuPpAsBhIRRRtHqvU3_5POss4L401hp35ijhw,1744
-buildlog-0.8.0.data/data/share/buildlog/template/buildlog/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-buildlog-0.8.0.data/data/share/buildlog/template/buildlog/2026-01-01-example.md,sha256=7x9sKmydfmfKyNz9hV7MtYnQJuBwbxNanbPOcpQDDZQ,7040
-buildlog-0.8.0.data/data/share/buildlog/template/buildlog/BUILDLOG_SYSTEM.md,sha256=osclytWwl5jUiTgSpuT4cT3h3oPvCkZ5GPCnFuJZNcY,3802
-buildlog-0.8.0.data/data/share/buildlog/template/buildlog/_TEMPLATE.md,sha256=CUvxgcx1-9XT_EdQ8e_vnuPq_h-u1uhXJgForJU2Pso,2932
-buildlog-0.8.0.data/data/share/buildlog/template/buildlog/_TEMPLATE_QUICK.md,sha256=eUr5MiqLsM6drV7rAq53R1SLkK8G7LkMAUjWKXx81IA,409
-buildlog-0.8.0.data/data/share/buildlog/template/buildlog/assets/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-buildlog-0.8.0.dist-info/METADATA,sha256=JNxWkxamVUmEeEQ9vz56j4lzZwex35sJyUngqytW6c4,7032
-buildlog-0.8.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-buildlog-0.8.0.dist-info/entry_points.txt,sha256=BMFclPOomp_sgaa0OqBg6LfqCMlqzjZV88ww5TrPPoo,87
-buildlog-0.8.0.dist-info/licenses/LICENSE,sha256=fAgt-akug9nAwIj6M-SIf8u3ck-T7pJTwfmy9vWYASk,1074
-buildlog-0.8.0.dist-info/RECORD,,
+buildlog-0.9.0.data/data/share/buildlog/copier.yml,sha256=hD_UcLGB9eDxTGkWjHAvUoiqQKhLC0w3G-kPKX_p43I,802
+buildlog-0.9.0.data/data/share/buildlog/post_gen.py,sha256=XFlo40LuPpAsBhIRRRtHqvU3_5POss4L401hp35ijhw,1744
+buildlog-0.9.0.data/data/share/buildlog/template/buildlog/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+buildlog-0.9.0.data/data/share/buildlog/template/buildlog/2026-01-01-example.md,sha256=7x9sKmydfmfKyNz9hV7MtYnQJuBwbxNanbPOcpQDDZQ,7040
+buildlog-0.9.0.data/data/share/buildlog/template/buildlog/BUILDLOG_SYSTEM.md,sha256=osclytWwl5jUiTgSpuT4cT3h3oPvCkZ5GPCnFuJZNcY,3802
+buildlog-0.9.0.data/data/share/buildlog/template/buildlog/_TEMPLATE.md,sha256=CUvxgcx1-9XT_EdQ8e_vnuPq_h-u1uhXJgForJU2Pso,2932
+buildlog-0.9.0.data/data/share/buildlog/template/buildlog/_TEMPLATE_QUICK.md,sha256=eUr5MiqLsM6drV7rAq53R1SLkK8G7LkMAUjWKXx81IA,409
+buildlog-0.9.0.data/data/share/buildlog/template/buildlog/assets/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+buildlog-0.9.0.dist-info/METADATA,sha256=uFrfGNpWCgBW7CYI3w6aUJDSHucCdVFpEoojWnsImA8,11341
+buildlog-0.9.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+buildlog-0.9.0.dist-info/entry_points.txt,sha256=BMFclPOomp_sgaa0OqBg6LfqCMlqzjZV88ww5TrPPoo,87
+buildlog-0.9.0.dist-info/licenses/LICENSE,sha256=fAgt-akug9nAwIj6M-SIf8u3ck-T7pJTwfmy9vWYASk,1074
+buildlog-0.9.0.dist-info/RECORD,,

buildlog-0.8.0.dist-info/METADATA

@@ -1,151 +0,0 @@
-Metadata-Version: 2.4
-Name: buildlog
-Version: 0.8.0
-Summary: Engineering notebook for AI-assisted development
-Project-URL: Homepage, https://github.com/Peleke/buildlog-template
-Project-URL: Repository, https://github.com/Peleke/buildlog-template
-Author: Peleke Sengstacke
-License-Expression: MIT
-License-File: LICENSE
-Keywords: ai,buildlog,development,documentation,journal
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Documentation
-Classifier: Topic :: Software Development :: Documentation
-Requires-Python: >=3.10
-Requires-Dist: click>=8.0.0
-Requires-Dist: copier>=9.0.0
-Requires-Dist: numpy>=1.21.0
-Requires-Dist: pymupdf>=1.26.7
-Requires-Dist: pyyaml>=6.0.0
-Provides-Extra: all
-Requires-Dist: anthropic>=0.40.0; extra == 'all'
-Requires-Dist: mcp>=1.0.0; extra == 'all'
-Requires-Dist: ollama>=0.4.0; extra == 'all'
-Requires-Dist: openai>=1.0.0; extra == 'all'
-Requires-Dist: sentence-transformers>=2.2.0; extra == 'all'
-Provides-Extra: anthropic
-Requires-Dist: anthropic>=0.40.0; extra == 'anthropic'
-Provides-Extra: dev
-Requires-Dist: black>=24.0.0; extra == 'dev'
-Requires-Dist: flake8>=7.0.0; extra == 'dev'
-Requires-Dist: isort>=5.13.0; extra == 'dev'
-Requires-Dist: mkdocs-material>=9.5.0; extra == 'dev'
-Requires-Dist: mypy>=1.8.0; extra == 'dev'
-Requires-Dist: pre-commit>=3.6.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
-Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
-Requires-Dist: pytest>=7.0.0; extra == 'dev'
-Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
-Provides-Extra: embeddings
-Requires-Dist: sentence-transformers>=2.2.0; extra == 'embeddings'
-Provides-Extra: engine
-Provides-Extra: llm
-Requires-Dist: anthropic>=0.40.0; extra == 'llm'
-Requires-Dist: ollama>=0.4.0; extra == 'llm'
-Provides-Extra: mcp
-Requires-Dist: mcp>=1.0.0; extra == 'mcp'
-Provides-Extra: ollama
-Requires-Dist: ollama>=0.4.0; extra == 'ollama'
-Provides-Extra: openai
-Requires-Dist: openai>=1.0.0; extra == 'openai'
-Description-Content-Type: text/markdown
-
-<div align="center">
-
-# buildlog
-
-### The Only Agent Learning System You Can Prove Works
-
-[![PyPI](https://img.shields.io/pypi/v/buildlog?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/buildlog/)
-[![Python](https://img.shields.io/pypi/pyversions/buildlog?style=for-the-badge&logo=python&logoColor=white)](https://python.org/)
-[![CI](https://img.shields.io/github/actions/workflow/status/Peleke/buildlog-template/ci.yml?branch=main&style=for-the-badge&logo=github&label=CI)](https://github.com/Peleke/buildlog-template/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
-[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue?style=for-the-badge&logo=github)](https://peleke.github.io/buildlog-template/)
-
-**Falsifiable claims. Measurable outcomes. No vibes.**
-
-<img src="assets/hero-banner-perfectdeliberate.png" alt="buildlog - The Only Agent Learning System You Can Prove Works" width="800"/>
-
-> **RE: The art** — Yes, it's AI-generated. Yes, that's hypocritical for a project about rigor over vibes. Looking for an actual artist to pay for a real logo. If you know someone good, [open an issue](https://github.com/Peleke/buildlog-template/issues) or DM me. Budget exists.
-
-**[Read the full documentation](https://peleke.github.io/buildlog-template/)**
-
-</div>
-
----
-
-Everyone's building "agent memory." Blog posts announce breakthroughs. Products ship with "learning" in the tagline. Ask them one question: **How do you know it works?**
-
-buildlog gives you the infrastructure to answer with data. It captures engineering knowledge from work sessions, extracts rules, selects which rules to surface using a Thompson Sampling bandit, and measures impact via Repeated Mistake Rate (RMR) across tracked experiments.
-
-## Features
-
-- **Structured capture** — Document work sessions as entries with mistakes, decisions, and outcomes
-- **Rule extraction** — Distill and deduplicate patterns into actionable rules
-- **Thompson Sampling bandit** — Automatic rule selection that balances exploration and exploitation
-- **Experiment tracking** — Sessions, mistakes, RMR calculation with statistical rigor
-- **Review gauntlet** — Curated reviewer personas (Security Karen, Test Terrorist) with HITL checkpoints
-- **Multi-agent support** — Render rules to Claude Code, Cursor, GitHub Copilot, Windsurf, Continue.dev
-- **MCP server** — Full Claude Code integration via `buildlog-mcp`
-
-## Quick Start
-
-```bash
-uv pip install buildlog   # or: pip install buildlog (inside a venv)
-buildlog init
-buildlog new my-feature
-buildlog distill && buildlog skills
-buildlog experiment start
-# ... work ...
-buildlog experiment end
-buildlog experiment report
-```
-
-## Documentation
-
-| Section | Description |
-|---------|------------|
-| [Installation](https://peleke.github.io/buildlog-template/getting-started/installation/) | Setup, extras, and initialization |
-| [Quick Start](https://peleke.github.io/buildlog-template/getting-started/quick-start/) | Full pipeline walkthrough |
-| [Core Concepts](https://peleke.github.io/buildlog-template/getting-started/concepts/) | The problem, the claim, and the metric |
-| [CLI Reference](https://peleke.github.io/buildlog-template/guides/cli-reference/) | Every command documented |
-| [MCP Integration](https://peleke.github.io/buildlog-template/guides/mcp-integration/) | Claude Code setup and available tools |
-| [Experiments](https://peleke.github.io/buildlog-template/guides/experiments/) | Running and measuring experiments |
-| [Review Gauntlet](https://peleke.github.io/buildlog-template/guides/review-gauntlet/) | Reviewer personas and the gauntlet loop |
-| [Multi-Agent Setup](https://peleke.github.io/buildlog-template/guides/multi-agent/) | Render rules to any AI coding agent |
-| [Theory](https://peleke.github.io/buildlog-template/theory/00-background/) | The math behind Thompson Sampling |
-| [Philosophy](https://peleke.github.io/buildlog-template/philosophy/) | Principles and honest limitations |
-
-## Contributing
-
-```bash
-git clone https://github.com/Peleke/buildlog-template
-cd buildlog-template
-uv venv && source .venv/bin/activate
-uv pip install -e ".[dev]"
-pytest
-```
-
-We're especially interested in better context representations, credit assignment approaches, statistical methodology improvements, and real-world experiment results (positive or negative).
-
-## License
-
-MIT License — see [LICENSE](./LICENSE)
-
----
-
-<div align="center">
-
-**"Agent learning" without measurement is just prompt engineering with extra steps.**
-
-**buildlog is measurement.**
-
-</div>