buildlog 0.9.0__tar.gz → 0.10.1__tar.gz

{buildlog-0.9.0 → buildlog-0.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: buildlog
-Version: 0.9.0
+Version: 0.10.1
 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
@@ -22,12 +22,12 @@ Classifier: Topic :: Software Development :: Documentation
 Requires-Python: >=3.10
 Requires-Dist: click>=8.0.0
 Requires-Dist: copier>=9.0.0
+Requires-Dist: mcp>=1.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'
@@ -51,7 +51,6 @@ 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
@@ -164,21 +163,34 @@ The roadmap: contextual bandits (now) -> richer policy models -> longer-horizon
 
 ## Installation
 
-### Global install (recommended)
+### Always-On Mode (recommended)
+
+We run buildlog as an **ambient data capture layer** across all projects. One command, works everywhere:
 
 ```bash
-uv tool install "buildlog[mcp]"   # or: pipx install "buildlog[mcp]"
+pipx install buildlog         # or: uv tool install buildlog
+buildlog init-mcp --global    # registers MCP + writes instructions to ~/.claude/CLAUDE.md
 ```
 
-This puts `buildlog` and `buildlog-mcp` on your PATH. Works from any directory. The `[mcp]` extra is required for the MCP server.
+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.
+
+The `--global` flag:
+- Registers the MCP server in `~/.claude/settings.json`
+- Creates `~/.claude/CLAUDE.md` with usage instructions so Claude proactively uses buildlog
+- Works immediately in any repo, even without a local `buildlog/` directory
+
+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.
+
+### Per-project setup
 
-### Per-project (virtual environment)
+If you prefer explicit per-project control:
 
 ```bash
-uv pip install "buildlog[mcp]"   # or: pip install "buildlog[mcp]"
+pip install buildlog          # MCP server included by default
+buildlog init --defaults      # scaffold buildlog/, register MCP, update CLAUDE.md
 ```
 
-Omit `[mcp]` if you only need the CLI.
+This creates a `buildlog/` directory with templates and configures Claude Code for that specific project.
 
 ### For JS/TS projects
 
@@ -186,30 +198,20 @@ Omit `[mcp]` if you only need the CLI.
 npx @peleke.s/buildlog init
 ```
 
-### MCP server for Claude Code
+### Verify installation
 
-Add to `~/.claude/claude_code_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "buildlog": {
-      "command": "buildlog-mcp",
-      "args": []
-    }
-  }
-}
+```bash
+buildlog mcp-test          # verify all 29 tools are registered
+buildlog overview          # check project state (works without init in global mode)
 ```
 
-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
+buildlog init --defaults      # scaffold + MCP + CLAUDE.md
+buildlog new my-feature       # start a session
 # ... work ...
-buildlog distill && buildlog skills
+buildlog commit -m "feat: add auth"
 buildlog experiment start
 # ... work across sessions ...
 buildlog experiment end

{buildlog-0.9.0 → buildlog-0.10.1}/README.md

@@ -104,21 +104,34 @@ The roadmap: contextual bandits (now) -> richer policy models -> longer-horizon
 
 ## Installation
 
-### Global install (recommended)
+### Always-On Mode (recommended)
+
+We run buildlog as an **ambient data capture layer** across all projects. One command, works everywhere:
 
 ```bash
-uv tool install "buildlog[mcp]"   # or: pipx install "buildlog[mcp]"
+pipx install buildlog         # or: uv tool install buildlog
+buildlog init-mcp --global    # registers MCP + writes instructions to ~/.claude/CLAUDE.md
 ```
 
-This puts `buildlog` and `buildlog-mcp` on your PATH. Works from any directory. The `[mcp]` extra is required for the MCP server.
+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.
+
+The `--global` flag:
+- Registers the MCP server in `~/.claude/settings.json`
+- Creates `~/.claude/CLAUDE.md` with usage instructions so Claude proactively uses buildlog
+- Works immediately in any repo, even without a local `buildlog/` directory
+
+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.
+
+### Per-project setup
 
-### Per-project (virtual environment)
+If you prefer explicit per-project control:
 
 ```bash
-uv pip install "buildlog[mcp]"   # or: pip install "buildlog[mcp]"
+pip install buildlog          # MCP server included by default
+buildlog init --defaults      # scaffold buildlog/, register MCP, update CLAUDE.md
 ```
 
-Omit `[mcp]` if you only need the CLI.
+This creates a `buildlog/` directory with templates and configures Claude Code for that specific project.
 
 ### For JS/TS projects
 
@@ -126,30 +139,20 @@ Omit `[mcp]` if you only need the CLI.
 npx @peleke.s/buildlog init
 ```
 
-### MCP server for Claude Code
+### Verify installation
 
-Add to `~/.claude/claude_code_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "buildlog": {
-      "command": "buildlog-mcp",
-      "args": []
-    }
-  }
-}
+```bash
+buildlog mcp-test          # verify all 29 tools are registered
+buildlog overview          # check project state (works without init in global mode)
 ```
 
-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
+buildlog init --defaults      # scaffold + MCP + CLAUDE.md
+buildlog new my-feature       # start a session
 # ... work ...
-buildlog distill && buildlog skills
+buildlog commit -m "feat: add auth"
 buildlog experiment start
 # ... work across sessions ...
 buildlog experiment end

{buildlog-0.9.0 → buildlog-0.10.1}/post_gen.py

@@ -3,7 +3,11 @@
 
 from pathlib import Path
 
-CLAUDE_MD_SECTION = """
+try:
+    from buildlog.constants import CLAUDE_MD_BUILDLOG_SECTION
+except ImportError:
+    # Fallback for when buildlog isn't installed (e.g., copier from GitHub)
+    CLAUDE_MD_BUILDLOG_SECTION = """
 ## Build Journal
 
 After completing significant work (features, debugging sessions, deployments,
@@ -40,15 +44,16 @@ def main():
 
     content = claude_md.read_text()
 
-    if "## Build Journal" in content:
-        print("Build Journal section already exists in CLAUDE.md")
+    # Check for either old or new section marker
+    if "## buildlog Integration" in content or "## Build Journal" in content:
+        print("buildlog section already exists in CLAUDE.md")
         return
 
     # Append to end of file
     with open(claude_md, "a") as f:
-        f.write("\n" + CLAUDE_MD_SECTION)
+        f.write("\n" + CLAUDE_MD_BUILDLOG_SECTION)
 
-    print("Added Build Journal section to CLAUDE.md")
+    print("Added buildlog Integration section to CLAUDE.md")
 
 
 if __name__ == "__main__":

{buildlog-0.9.0 → buildlog-0.10.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "buildlog"
-version = "0.9.0"
+version = "0.10.1"
 description = "Engineering notebook for AI-assisted development"
 readme = "README.md"
 license = "MIT"
@@ -32,6 +32,7 @@ dependencies = [
     "pyyaml>=6.0.0",
     "numpy>=1.21.0",
     "pymupdf>=1.26.7",
+    "mcp>=1.0.0",
 ]
 
 [project.optional-dependencies]
@@ -60,15 +61,12 @@ llm = [
     "ollama>=0.4.0",
     "anthropic>=0.40.0",
 ]
-# MCP server for Claude Code integration
-mcp = [
-    "mcp>=1.0.0",
-]
+# MCP server for Claude Code integration (now a default dependency, kept for backwards compat)
+mcp = []
 # All optional features
 all = [
     "sentence-transformers>=2.2.0",
     "openai>=1.0.0",
-    "mcp>=1.0.0",
     "ollama>=0.4.0",
     "anthropic>=0.40.0",
 ]