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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. buildlog/cli.py +491 -30
  2. buildlog/constants.py +121 -0
  3. buildlog/core/__init__.py +44 -0
  4. buildlog/core/operations.py +1189 -13
  5. buildlog/data/seeds/bragi.yaml +61 -0
  6. buildlog/llm.py +51 -4
  7. buildlog/mcp/__init__.py +51 -3
  8. buildlog/mcp/server.py +40 -0
  9. buildlog/mcp/tools.py +526 -12
  10. buildlog/seed_engine/__init__.py +2 -0
  11. buildlog/seed_engine/llm_extractor.py +121 -0
  12. buildlog/seed_engine/pipeline.py +45 -1
  13. {buildlog-0.8.0.data → buildlog-0.10.0.data}/data/share/buildlog/post_gen.py +10 -5
  14. buildlog-0.10.0.data/data/share/buildlog/template/buildlog/.gitkeep +0 -0
  15. buildlog-0.10.0.data/data/share/buildlog/template/buildlog/assets/.gitkeep +0 -0
  16. buildlog-0.10.0.dist-info/METADATA +248 -0
  17. {buildlog-0.8.0.dist-info → buildlog-0.10.0.dist-info}/RECORD +27 -22
  18. buildlog-0.8.0.dist-info/METADATA +0 -151
  19. {buildlog-0.8.0.data → buildlog-0.10.0.data}/data/share/buildlog/copier.yml +0 -0
  20. {buildlog-0.8.0.data/data/share/buildlog/template/buildlog → buildlog-0.10.0.data/data/share/buildlog/template/buildlog/.buildlog}/.gitkeep +0 -0
  21. {buildlog-0.8.0.data/data/share/buildlog/template/buildlog/assets → buildlog-0.10.0.data/data/share/buildlog/template/buildlog/.buildlog/seeds}/.gitkeep +0 -0
  22. {buildlog-0.8.0.data → buildlog-0.10.0.data}/data/share/buildlog/template/buildlog/2026-01-01-example.md +0 -0
  23. {buildlog-0.8.0.data → buildlog-0.10.0.data}/data/share/buildlog/template/buildlog/BUILDLOG_SYSTEM.md +0 -0
  24. {buildlog-0.8.0.data → buildlog-0.10.0.data}/data/share/buildlog/template/buildlog/_TEMPLATE.md +0 -0
  25. {buildlog-0.8.0.data → buildlog-0.10.0.data}/data/share/buildlog/template/buildlog/_TEMPLATE_QUICK.md +0 -0
  26. {buildlog-0.8.0.dist-info → buildlog-0.10.0.dist-info}/WHEEL +0 -0
  27. {buildlog-0.8.0.dist-info → buildlog-0.10.0.dist-info}/entry_points.txt +0 -0
  28. {buildlog-0.8.0.dist-info → buildlog-0.10.0.dist-info}/licenses/LICENSE +0 -0
buildlog-0.8.0.dist-info/METADATA DELETED
@@ -1,151 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: buildlog
3
- Version: 0.8.0
4
- Summary: Engineering notebook for AI-assisted development
5
- Project-URL: Homepage, https://github.com/Peleke/buildlog-template
6
- Project-URL: Repository, https://github.com/Peleke/buildlog-template
7
- Author: Peleke Sengstacke
8
- License-Expression: MIT
9
- License-File: LICENSE
10
- Keywords: ai,buildlog,development,documentation,journal
11
- Classifier: Development Status :: 4 - Beta
12
- Classifier: Environment :: Console
13
- Classifier: Intended Audience :: Developers
14
- Classifier: License :: OSI Approved :: MIT License
15
- Classifier: Programming Language :: Python :: 3
16
- Classifier: Programming Language :: Python :: 3.10
17
- Classifier: Programming Language :: Python :: 3.11
18
- Classifier: Programming Language :: Python :: 3.12
19
- Classifier: Programming Language :: Python :: 3.13
20
- Classifier: Topic :: Documentation
21
- Classifier: Topic :: Software Development :: Documentation
22
- Requires-Python: >=3.10
23
- Requires-Dist: click>=8.0.0
24
- Requires-Dist: copier>=9.0.0
25
- Requires-Dist: numpy>=1.21.0
26
- Requires-Dist: pymupdf>=1.26.7
27
- Requires-Dist: pyyaml>=6.0.0
28
- Provides-Extra: all
29
- Requires-Dist: anthropic>=0.40.0; extra == 'all'
30
- Requires-Dist: mcp>=1.0.0; extra == 'all'
31
- Requires-Dist: ollama>=0.4.0; extra == 'all'
32
- Requires-Dist: openai>=1.0.0; extra == 'all'
33
- Requires-Dist: sentence-transformers>=2.2.0; extra == 'all'
34
- Provides-Extra: anthropic
35
- Requires-Dist: anthropic>=0.40.0; extra == 'anthropic'
36
- Provides-Extra: dev
37
- Requires-Dist: black>=24.0.0; extra == 'dev'
38
- Requires-Dist: flake8>=7.0.0; extra == 'dev'
39
- Requires-Dist: isort>=5.13.0; extra == 'dev'
40
- Requires-Dist: mkdocs-material>=9.5.0; extra == 'dev'
41
- Requires-Dist: mypy>=1.8.0; extra == 'dev'
42
- Requires-Dist: pre-commit>=3.6.0; extra == 'dev'
43
- Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
44
- Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
45
- Requires-Dist: pytest>=7.0.0; extra == 'dev'
46
- Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
47
- Provides-Extra: embeddings
48
- Requires-Dist: sentence-transformers>=2.2.0; extra == 'embeddings'
49
- Provides-Extra: engine
50
- Provides-Extra: llm
51
- Requires-Dist: anthropic>=0.40.0; extra == 'llm'
52
- Requires-Dist: ollama>=0.4.0; extra == 'llm'
53
- Provides-Extra: mcp
54
- Requires-Dist: mcp>=1.0.0; extra == 'mcp'
55
- Provides-Extra: ollama
56
- Requires-Dist: ollama>=0.4.0; extra == 'ollama'
57
- Provides-Extra: openai
58
- Requires-Dist: openai>=1.0.0; extra == 'openai'
59
- Description-Content-Type: text/markdown
60
-
61
- <div align="center">
62
-
63
- # buildlog
64
-
65
- ### The Only Agent Learning System You Can Prove Works
66
-
67
- [![PyPI](https://img.shields.io/pypi/v/buildlog?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/buildlog/)
68
- [![Python](https://img.shields.io/pypi/pyversions/buildlog?style=for-the-badge&logo=python&logoColor=white)](https://python.org/)
69
- [![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)
70
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
71
- [![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue?style=for-the-badge&logo=github)](https://peleke.github.io/buildlog-template/)
72
-
73
- **Falsifiable claims. Measurable outcomes. No vibes.**
74
-
75
- <img src="assets/hero-banner-perfectdeliberate.png" alt="buildlog - The Only Agent Learning System You Can Prove Works" width="800"/>
76
-
77
- > **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.
78
-
79
- **[Read the full documentation](https://peleke.github.io/buildlog-template/)**
80
-
81
- </div>
82
-
83
- ---
84
-
85
- 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?**
86
-
87
- 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.
88
-
89
- ## Features
90
-
91
- - **Structured capture** — Document work sessions as entries with mistakes, decisions, and outcomes
92
- - **Rule extraction** — Distill and deduplicate patterns into actionable rules
93
- - **Thompson Sampling bandit** — Automatic rule selection that balances exploration and exploitation
94
- - **Experiment tracking** — Sessions, mistakes, RMR calculation with statistical rigor
95
- - **Review gauntlet** — Curated reviewer personas (Security Karen, Test Terrorist) with HITL checkpoints
96
- - **Multi-agent support** — Render rules to Claude Code, Cursor, GitHub Copilot, Windsurf, Continue.dev
97
- - **MCP server** — Full Claude Code integration via `buildlog-mcp`
98
-
99
- ## Quick Start
100
-
101
- ```bash
102
- uv pip install buildlog # or: pip install buildlog (inside a venv)
103
- buildlog init
104
- buildlog new my-feature
105
- buildlog distill && buildlog skills
106
- buildlog experiment start
107
- # ... work ...
108
- buildlog experiment end
109
- buildlog experiment report
110
- ```
111
-
112
- ## Documentation
113
-
114
- | Section | Description |
115
- |---------|------------|
116
- | [Installation](https://peleke.github.io/buildlog-template/getting-started/installation/) | Setup, extras, and initialization |
117
- | [Quick Start](https://peleke.github.io/buildlog-template/getting-started/quick-start/) | Full pipeline walkthrough |
118
- | [Core Concepts](https://peleke.github.io/buildlog-template/getting-started/concepts/) | The problem, the claim, and the metric |
119
- | [CLI Reference](https://peleke.github.io/buildlog-template/guides/cli-reference/) | Every command documented |
120
- | [MCP Integration](https://peleke.github.io/buildlog-template/guides/mcp-integration/) | Claude Code setup and available tools |
121
- | [Experiments](https://peleke.github.io/buildlog-template/guides/experiments/) | Running and measuring experiments |
122
- | [Review Gauntlet](https://peleke.github.io/buildlog-template/guides/review-gauntlet/) | Reviewer personas and the gauntlet loop |
123
- | [Multi-Agent Setup](https://peleke.github.io/buildlog-template/guides/multi-agent/) | Render rules to any AI coding agent |
124
- | [Theory](https://peleke.github.io/buildlog-template/theory/00-background/) | The math behind Thompson Sampling |
125
- | [Philosophy](https://peleke.github.io/buildlog-template/philosophy/) | Principles and honest limitations |
126
-
127
- ## Contributing
128
-
129
- ```bash
130
- git clone https://github.com/Peleke/buildlog-template
131
- cd buildlog-template
132
- uv venv && source .venv/bin/activate
133
- uv pip install -e ".[dev]"
134
- pytest
135
- ```
136
-
137
- We're especially interested in better context representations, credit assignment approaches, statistical methodology improvements, and real-world experiment results (positive or negative).
138
-
139
- ## License
140
-
141
- MIT License — see [LICENSE](./LICENSE)
142
-
143
- ---
144
-
145
- <div align="center">
146
-
147
- **"Agent learning" without measurement is just prompt engineering with extra steps.**
148
-
149
- **buildlog is measurement.**
150
-
151
- </div>