buildlog 0.9.0__py3-none-any.whl → 0.10.1__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 (23) hide show
  1. buildlog/cli.py +304 -26
  2. buildlog/constants.py +160 -0
  3. buildlog/core/__init__.py +44 -0
  4. buildlog/core/operations.py +1170 -0
  5. buildlog/data/seeds/bragi.yaml +61 -0
  6. buildlog/mcp/__init__.py +51 -3
  7. buildlog/mcp/server.py +36 -0
  8. buildlog/mcp/tools.py +526 -12
  9. {buildlog-0.9.0.data → buildlog-0.10.1.data}/data/share/buildlog/post_gen.py +10 -5
  10. buildlog-0.10.1.data/data/share/buildlog/template/buildlog/.gitkeep +0 -0
  11. buildlog-0.10.1.data/data/share/buildlog/template/buildlog/assets/.gitkeep +0 -0
  12. {buildlog-0.9.0.dist-info → buildlog-0.10.1.dist-info}/METADATA +28 -26
  13. {buildlog-0.9.0.dist-info → buildlog-0.10.1.dist-info}/RECORD +23 -19
  14. {buildlog-0.9.0.data → buildlog-0.10.1.data}/data/share/buildlog/copier.yml +0 -0
  15. {buildlog-0.9.0.data/data/share/buildlog/template/buildlog → buildlog-0.10.1.data/data/share/buildlog/template/buildlog/.buildlog}/.gitkeep +0 -0
  16. {buildlog-0.9.0.data/data/share/buildlog/template/buildlog/assets → buildlog-0.10.1.data/data/share/buildlog/template/buildlog/.buildlog/seeds}/.gitkeep +0 -0
  17. {buildlog-0.9.0.data → buildlog-0.10.1.data}/data/share/buildlog/template/buildlog/2026-01-01-example.md +0 -0
  18. {buildlog-0.9.0.data → buildlog-0.10.1.data}/data/share/buildlog/template/buildlog/BUILDLOG_SYSTEM.md +0 -0
  19. {buildlog-0.9.0.data → buildlog-0.10.1.data}/data/share/buildlog/template/buildlog/_TEMPLATE.md +0 -0
  20. {buildlog-0.9.0.data → buildlog-0.10.1.data}/data/share/buildlog/template/buildlog/_TEMPLATE_QUICK.md +0 -0
  21. {buildlog-0.9.0.dist-info → buildlog-0.10.1.dist-info}/WHEEL +0 -0
  22. {buildlog-0.9.0.dist-info → buildlog-0.10.1.dist-info}/entry_points.txt +0 -0
  23. {buildlog-0.9.0.dist-info → buildlog-0.10.1.dist-info}/licenses/LICENSE +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: buildlog
3
- Version: 0.9.0
3
+ Version: 0.10.1
4
4
  Summary: Engineering notebook for AI-assisted development
5
5
  Project-URL: Homepage, https://github.com/Peleke/buildlog-template
6
6
  Project-URL: Repository, https://github.com/Peleke/buildlog-template
@@ -22,12 +22,12 @@ Classifier: Topic :: Software Development :: Documentation
22
22
  Requires-Python: >=3.10
23
23
  Requires-Dist: click>=8.0.0
24
24
  Requires-Dist: copier>=9.0.0
25
+ Requires-Dist: mcp>=1.0.0
25
26
  Requires-Dist: numpy>=1.21.0
26
27
  Requires-Dist: pymupdf>=1.26.7
27
28
  Requires-Dist: pyyaml>=6.0.0
28
29
  Provides-Extra: all
29
30
  Requires-Dist: anthropic>=0.40.0; extra == 'all'
30
- Requires-Dist: mcp>=1.0.0; extra == 'all'
31
31
  Requires-Dist: ollama>=0.4.0; extra == 'all'
32
32
  Requires-Dist: openai>=1.0.0; extra == 'all'
33
33
  Requires-Dist: sentence-transformers>=2.2.0; extra == 'all'
@@ -51,7 +51,6 @@ Provides-Extra: llm
51
51
  Requires-Dist: anthropic>=0.40.0; extra == 'llm'
52
52
  Requires-Dist: ollama>=0.4.0; extra == 'llm'
53
53
  Provides-Extra: mcp
54
- Requires-Dist: mcp>=1.0.0; extra == 'mcp'
55
54
  Provides-Extra: ollama
56
55
  Requires-Dist: ollama>=0.4.0; extra == 'ollama'
57
56
  Provides-Extra: openai
@@ -164,21 +163,34 @@ The roadmap: contextual bandits (now) -> richer policy models -> longer-horizon
164
163
 
165
164
  ## Installation
166
165
 
167
- ### Global install (recommended)
166
+ ### Always-On Mode (recommended)
167
+
168
+ We run buildlog as an **ambient data capture layer** across all projects. One command, works everywhere:
168
169
 
169
170
  ```bash
170
- uv tool install "buildlog[mcp]" # or: pipx install "buildlog[mcp]"
171
+ pipx install buildlog # or: uv tool install buildlog
172
+ buildlog init-mcp --global # registers MCP + writes instructions to ~/.claude/CLAUDE.md
171
173
  ```
172
174
 
173
- This puts `buildlog` and `buildlog-mcp` on your PATH. Works from any directory. The `[mcp]` extra is required for the MCP server.
175
+ That's it. Claude Code now has all 29 buildlog tools **and knows how to use them** in every project you open. No per-project setup needed.
176
+
177
+ The `--global` flag:
178
+ - Registers the MCP server in `~/.claude/settings.json`
179
+ - Creates `~/.claude/CLAUDE.md` with usage instructions so Claude proactively uses buildlog
180
+ - Works immediately in any repo, even without a local `buildlog/` directory
181
+
182
+ This is how we use buildlog ourselves: always on, capturing structured trajectories from every session, feeding downstream systems that generate engineering logs, courses, and content.
183
+
184
+ ### Per-project setup
174
185
 
175
- ### Per-project (virtual environment)
186
+ If you prefer explicit per-project control:
176
187
 
177
188
  ```bash
178
- uv pip install "buildlog[mcp]" # or: pip install "buildlog[mcp]"
189
+ pip install buildlog # MCP server included by default
190
+ buildlog init --defaults # scaffold buildlog/, register MCP, update CLAUDE.md
179
191
  ```
180
192
 
181
- Omit `[mcp]` if you only need the CLI.
193
+ This creates a `buildlog/` directory with templates and configures Claude Code for that specific project.
182
194
 
183
195
  ### For JS/TS projects
184
196
 
@@ -186,30 +198,20 @@ Omit `[mcp]` if you only need the CLI.
186
198
  npx @peleke.s/buildlog init
187
199
  ```
188
200
 
189
- ### MCP server for Claude Code
201
+ ### Verify installation
190
202
 
191
- Add to `~/.claude/claude_code_config.json`:
192
-
193
- ```json
194
- {
195
- "mcpServers": {
196
- "buildlog": {
197
- "command": "buildlog-mcp",
198
- "args": []
199
- }
200
- }
201
- }
203
+ ```bash
204
+ buildlog mcp-test # verify all 29 tools are registered
205
+ buildlog overview # check project state (works without init in global mode)
202
206
  ```
203
207
 
204
- This exposes buildlog tools (seeds, skills, experiments, gauntlet, bandit status) to any Claude Code session.
205
-
206
208
  ## Quick Start
207
209
 
208
210
  ```bash
209
- buildlog init # scaffold a project (run in any repo)
210
- buildlog new my-feature # start a session
211
+ buildlog init --defaults # scaffold + MCP + CLAUDE.md
212
+ buildlog new my-feature # start a session
211
213
  # ... work ...
212
- buildlog distill && buildlog skills
214
+ buildlog commit -m "feat: add auth"
213
215
  buildlog experiment start
214
216
  # ... work across sessions ...
215
217
  buildlog experiment end
@@ -1,16 +1,18 @@
1
1
  buildlog/__init__.py,sha256=wxluyg3fDOiaKUAOJa0cav39hwtNJS5Y_0X20uL_yi4,90
2
- buildlog/cli.py,sha256=CZUG3xYBfdyP47SDyvIgvjcfYDcHfV6ijGAr0B_7t1Y,66683
2
+ buildlog/cli.py,sha256=YlAo1h43dZuBL7AkEZpd1uJsKnakHNekw8ywBF5PJW4,76508
3
3
  buildlog/confidence.py,sha256=jPvN0_3drGHQG1C7iUxUtYjKC62nNKsHHxu6WXMfJFg,10137
4
+ buildlog/constants.py,sha256=9byHhexkEaHcM8jjK0F2C_CssPSO9ujvVbbBIi04ZJ4,7419
4
5
  buildlog/distill.py,sha256=PL7UBToBb27BrCOTWGBTDIXGggtrUumHHBs0_MfG6vY,14166
5
6
  buildlog/embeddings.py,sha256=vPydWjJVkYp172zFou-lJ737qsu6vRMQAMs143RGIpA,12364
6
7
  buildlog/llm.py,sha256=t_3KnJ_eBmrtHaay4owG3EgGbJrVp_T379P0tTuyJf8,16986
7
8
  buildlog/seeds.py,sha256=L-lzO7rrDjMdVHcYKvEBm6scVDfCmFD0koiyafMZDLo,8596
8
9
  buildlog/skills.py,sha256=3CihyyAFfJh0w0VNXQauNhGm_RM8m_GIO1iiNLNPmsQ,33789
9
10
  buildlog/stats.py,sha256=2WdHdmzUNGobtWngmm9nA_UmqM7DQeAnZL8_rLQN8aw,13256
10
- buildlog/core/__init__.py,sha256=gPd6ava_sei0sYIS4NdeHgCVwJ2wEjyLt-Rxz_11IWU,1626
11
+ buildlog/core/__init__.py,sha256=yjmo_pWE7ijCvMSgBXDPVl5lgsUlTXjc1Nv7eIRjlVI,2642
11
12
  buildlog/core/bandit.py,sha256=0z58s42jpQiBgXdjb465apenWdBVTvoc7bDOcnAcPLo,24565
12
- buildlog/core/operations.py,sha256=cL2w2Lrk7SBwha1aN9_t9WmQwi0OckCpAaGHCXDQztI,70249
13
+ buildlog/core/operations.py,sha256=fVpUcxt2AzktGy1iwSpazj3sLob6l4Rio9QtxDWHOec,104634
13
14
  buildlog/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
15
+ buildlog/data/seeds/bragi.yaml,sha256=2bheCsPHp6gHvgi8jCFTebs_q5X8WLVUduJe-Q-kQ0Y,3702
14
16
  buildlog/data/seeds/security_karen.yaml,sha256=Hjwp4j6FB-e0vCXp6AkyhAEkwASR4H1owdhPBID740E,8775
15
17
  buildlog/data/seeds/test_terrorist.yaml,sha256=-QY2x6d0LrlM6msMYaYwR43Wny9ZybQmU7pH_E7gSB0,11113
16
18
  buildlog/engine/__init__.py,sha256=KNTSUZTUHK6r2abAA-2PIb0wUcRgbE4juvBmoywaXHI,1750
@@ -19,9 +21,9 @@ buildlog/engine/confidence.py,sha256=7Zhw8bwT_S-qeVaGXT6dHOyjDTvwyhetLKCWhJH9jMc
19
21
  buildlog/engine/embeddings.py,sha256=78InITcBbaPZ29tUlb4hJNNVZ1fhxstvVa2fYvOh6QA,597
20
22
  buildlog/engine/experiments.py,sha256=38f_UsbY4TP3LTGM9yUsZxoXqxUGOxmLCoYrfZqjVks,20041
21
23
  buildlog/engine/types.py,sha256=W7U2B4TE79xACV0cuaidKevmTEskxqXfltH5hjIxV5k,734
22
- buildlog/mcp/__init__.py,sha256=jCLNUkYFrDcPd5dY9xbaaVANl-ZzdPim1BykgGY7f7U,334
23
- buildlog/mcp/server.py,sha256=IlE-xkW5gaOs5wkgusncRD9ugV70FRB6TKDanIqPaoc,1328
24
- buildlog/mcp/tools.py,sha256=k1f6R7Dgcx0VIKzTNezkcRc0UVkWXWkk-uGkRq1sIiw,17578
24
+ buildlog/mcp/__init__.py,sha256=dSjiS__oyYuGipAQDfNlM37NYZ60TMCCA9WXtQk81x0,1668
25
+ buildlog/mcp/server.py,sha256=Ua0Jk5jRuHGDSSLS0QEJhsXW2fKtrQlUdow-aeumI9M,2233
26
+ buildlog/mcp/tools.py,sha256=MRM9UMwoDmX0WaRq3JD1DlNnOOJdjNOzq7CQs2f0IC4,32764
25
27
  buildlog/render/__init__.py,sha256=jj-o-vPdqpivdFKK85xskCOT8Zn_2tb3Q5Jb0gWLjAg,2567
26
28
  buildlog/render/base.py,sha256=gQfvOsH1zttAo10xtEyNsAbqZ4NRSPiDihO-aiGgTsw,533
27
29
  buildlog/render/claude_md.py,sha256=R5z4dHh-3YwclbW3MAzHxgYQHtd5lXS3McJJ1isLGqE,4901
@@ -40,16 +42,18 @@ buildlog/seed_engine/llm_extractor.py,sha256=nfTmN4vuEiPQuhiL_2DX1QZ7TZlDR2vxYy0
40
42
  buildlog/seed_engine/models.py,sha256=qESSuoF3CJy8pp96E3Vmb38V-snzeaW0Xg0RfbH8v1U,3418
41
43
  buildlog/seed_engine/pipeline.py,sha256=cyR2Vf32Hf0PK5DxnaFcq56ygjJIiJWiIkHY4Uz7AS8,8082
42
44
  buildlog/seed_engine/sources.py,sha256=8j9oUFZCSKMr5VpIuAxTPY3wTzfTEmw6M_41_aismiE,11184
43
- buildlog-0.9.0.data/data/share/buildlog/copier.yml,sha256=hD_UcLGB9eDxTGkWjHAvUoiqQKhLC0w3G-kPKX_p43I,802
44
- buildlog-0.9.0.data/data/share/buildlog/post_gen.py,sha256=XFlo40LuPpAsBhIRRRtHqvU3_5POss4L401hp35ijhw,1744
45
- buildlog-0.9.0.data/data/share/buildlog/template/buildlog/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
46
- buildlog-0.9.0.data/data/share/buildlog/template/buildlog/2026-01-01-example.md,sha256=7x9sKmydfmfKyNz9hV7MtYnQJuBwbxNanbPOcpQDDZQ,7040
47
- buildlog-0.9.0.data/data/share/buildlog/template/buildlog/BUILDLOG_SYSTEM.md,sha256=osclytWwl5jUiTgSpuT4cT3h3oPvCkZ5GPCnFuJZNcY,3802
48
- buildlog-0.9.0.data/data/share/buildlog/template/buildlog/_TEMPLATE.md,sha256=CUvxgcx1-9XT_EdQ8e_vnuPq_h-u1uhXJgForJU2Pso,2932
49
- buildlog-0.9.0.data/data/share/buildlog/template/buildlog/_TEMPLATE_QUICK.md,sha256=eUr5MiqLsM6drV7rAq53R1SLkK8G7LkMAUjWKXx81IA,409
50
- buildlog-0.9.0.data/data/share/buildlog/template/buildlog/assets/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
51
- buildlog-0.9.0.dist-info/METADATA,sha256=uFrfGNpWCgBW7CYI3w6aUJDSHucCdVFpEoojWnsImA8,11341
52
- buildlog-0.9.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
53
- buildlog-0.9.0.dist-info/entry_points.txt,sha256=BMFclPOomp_sgaa0OqBg6LfqCMlqzjZV88ww5TrPPoo,87
54
- buildlog-0.9.0.dist-info/licenses/LICENSE,sha256=fAgt-akug9nAwIj6M-SIf8u3ck-T7pJTwfmy9vWYASk,1074
55
- buildlog-0.9.0.dist-info/RECORD,,
45
+ buildlog-0.10.1.data/data/share/buildlog/copier.yml,sha256=hD_UcLGB9eDxTGkWjHAvUoiqQKhLC0w3G-kPKX_p43I,802
46
+ buildlog-0.10.1.data/data/share/buildlog/post_gen.py,sha256=YQJYQjbRqfmyKrRRkdqk8qTkXwqompg-AgroKUR8W9M,2020
47
+ buildlog-0.10.1.data/data/share/buildlog/template/buildlog/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
48
+ buildlog-0.10.1.data/data/share/buildlog/template/buildlog/2026-01-01-example.md,sha256=7x9sKmydfmfKyNz9hV7MtYnQJuBwbxNanbPOcpQDDZQ,7040
49
+ buildlog-0.10.1.data/data/share/buildlog/template/buildlog/BUILDLOG_SYSTEM.md,sha256=osclytWwl5jUiTgSpuT4cT3h3oPvCkZ5GPCnFuJZNcY,3802
50
+ buildlog-0.10.1.data/data/share/buildlog/template/buildlog/_TEMPLATE.md,sha256=CUvxgcx1-9XT_EdQ8e_vnuPq_h-u1uhXJgForJU2Pso,2932
51
+ buildlog-0.10.1.data/data/share/buildlog/template/buildlog/_TEMPLATE_QUICK.md,sha256=eUr5MiqLsM6drV7rAq53R1SLkK8G7LkMAUjWKXx81IA,409
52
+ buildlog-0.10.1.data/data/share/buildlog/template/buildlog/.buildlog/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
53
+ buildlog-0.10.1.data/data/share/buildlog/template/buildlog/.buildlog/seeds/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
54
+ buildlog-0.10.1.data/data/share/buildlog/template/buildlog/assets/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
55
+ buildlog-0.10.1.dist-info/METADATA,sha256=BvQtReyHfyKdwVZF2JpZioaFrzzPrWF4J3_w_xsxosY,11971
56
+ buildlog-0.10.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
57
+ buildlog-0.10.1.dist-info/entry_points.txt,sha256=BMFclPOomp_sgaa0OqBg6LfqCMlqzjZV88ww5TrPPoo,87
58
+ buildlog-0.10.1.dist-info/licenses/LICENSE,sha256=fAgt-akug9nAwIj6M-SIf8u3ck-T7pJTwfmy9vWYASk,1074
59
+ buildlog-0.10.1.dist-info/RECORD,,