buildlog 0.4.0__tar.gz → 0.8.0__tar.gz

{buildlog-0.4.0 → buildlog-0.8.0}/.gitignore

@@ -44,3 +44,13 @@ htmlcov/
 
 # Build artifacts
 *.whl
+
+# Development artifacts
+CHAT.txt
+results/
+sketches/
+
+# buildlog runtime data (in project root, not in src/)
+buildlog/.buildlog/
+buildlog/bandit_state.jsonl
+site/

buildlog-0.8.0/PKG-INFO

@@ -0,0 +1,151 @@
+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>

buildlog-0.8.0/README.md

@@ -0,0 +1,91 @@
+<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>

{buildlog-0.4.0 → buildlog-0.8.0}/copier.yml

@@ -20,10 +20,6 @@ update_claude_md:
   help: Add buildlog instructions to CLAUDE.md if it exists?
   default: true
 
-# Post-generation tasks
-_tasks:
-  - "{{ 'python3 post_gen.py' if update_claude_md else 'echo Skipping CLAUDE.md update' }}"
-
 _message_after_copy: |
   Build journal installed!
 

{buildlog-0.4.0 → buildlog-0.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "buildlog"
-version = "0.4.0"
+version = "0.8.0"
 description = "Engineering notebook for AI-assisted development"
 readme = "README.md"
 license = "MIT"
@@ -31,9 +31,14 @@ dependencies = [
     "click>=8.0.0",
     "pyyaml>=6.0.0",
     "numpy>=1.21.0",
+    "pymupdf>=1.26.7",
 ]
 
 [project.optional-dependencies]
+# Engine-only: bandit, confidence, embeddings, experiment tracking.
+# Zero extra deps — the engine is part of the base package.
+# This extra documents the clean namespace: from buildlog.engine import X
+engine = []
 # Local embeddings for semantic deduplication (offline)
 embeddings = [
     "sentence-transformers>=2.2.0",
@@ -42,6 +47,19 @@ embeddings = [
 openai = [
     "openai>=1.0.0",
 ]
+# Ollama for local LLM-backed extraction
+ollama = [
+    "ollama>=0.4.0",
+]
+# Anthropic Claude for cloud LLM-backed extraction
+anthropic = [
+    "anthropic>=0.40.0",
+]
+# Both LLM providers (convenience)
+llm = [
+    "ollama>=0.4.0",
+    "anthropic>=0.40.0",
+]
 # MCP server for Claude Code integration
 mcp = [
     "mcp>=1.0.0",
@@ -51,6 +69,8 @@ all = [
     "sentence-transformers>=2.2.0",
     "openai>=1.0.0",
     "mcp>=1.0.0",
+    "ollama>=0.4.0",
+    "anthropic>=0.40.0",
 ]
 # Development dependencies
 dev = [
@@ -63,6 +83,7 @@ dev = [
     "flake8>=7.0.0",
     "types-PyYAML>=6.0.0",
     "pre-commit>=3.6.0",
+    "mkdocs-material>=9.5.0",
 ]
 
 [project.urls]
@@ -122,3 +143,10 @@ disallow_untyped_defs = false
 testpaths = ["tests"]
 python_files = ["test_*.py"]
 addopts = "-v --tb=short"
+
+[dependency-groups]
+dev = [
+    "marimo>=0.19.5",
+    "matplotlib>=3.10.8",
+    "scipy>=1.15.3",
+]

{buildlog-0.4.0 → buildlog-0.8.0}/src/buildlog/__init__.py

@@ -1,3 +1,3 @@
 """buildlog - Engineering notebook for AI-assisted development."""
 
-__version__ = "0.1.0"
+__version__ = "0.8.0"