HEAVEN BML System

Build-Measure-Learn GitHub project management for AI agents.

Installation

pip install heaven-bml

Quick Start

# Import BML functions
from heaven_bml import (
    construct_kanban_from_labels,
    get_all_prioritized_issues,
    move_issue_above,
    move_issue_below,
    create_github_issue_with_status
)

# View your kanban board
kanban = construct_kanban_from_labels('your-org/your-repo')
print(f"Backlog: {len(kanban.backlog)} items")
print(f"Plan: {len(kanban.plan)} items")
print(f"Build: {len(kanban.build)} items")

# Create a new issue with BML status
create_github_issue_with_status(
    'your-org/your-repo',
    'Implement feature X',
    'Details about the feature',
    'plan'
)

# Manage priorities with tree notation
move_issue_above('123', '456', 'your-org/your-repo')

Features

🌳 Tree Notation Priorities

Infinite hierarchy: priority-1.2.3.4.5...
Automatic sorting: Natural tree order in kanban
Dynamic reordering: Move issues above/below/between

📋 GitHub Kanban States

Backlog → Plan → Build → Measure → Learn → Archived
Label-based: Uses GitHub labels for state management
API integration: Real-time GitHub synchronization

🤖 MCP Server for Claude Code

# Configure Claude Desktop
python -m mcp_server --default-repo "your-org/your-repo"

🔄 GitHub Workflow Automation

# Install BML workflows in your repository
python -m heaven_bml.setup_scripts.install_bml_workflows --repo your-org/your-repo

Requirements

Python 3.8+
GitHub Personal Access Token with repo permissions
Set GITHUB_TOKEN environment variable

License

HEAVEN BML System License

✅ Personal and commercial use allowed
✅ Modification and distribution allowed
Required attribution: "Powered by HEAVEN BML System"

Powered by HEAVEN BML System

Metadata

Release files for heaven-bml 2.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for heaven-bml 2.6.1
File	Size	Uploaded	Provenance
heaven_bml-2.6.1.tar.gz	35.5 kB	Jul 26, 2025	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for heaven-bml 2.6.1
File	Interpreter	ABI	Platform	Reset
heaven_bml-2.6.1-py3-none-any.whl 38.8 kB Jul 26, 2025 Without provenance	Python 3	none	any	Details

Total release size: 74.3 kB

Release files / heaven_bml-2.6.1.tar.gz

Download URL	heaven_bml-2.6.1.tar.gz
Size	35.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`7f9b9f8e75f93d92920576cd9e65950ec43fe2443153bdb0f7b1fe6254cb3fe0`
BLAKE2b-256 checksum How to use checksums	`a9d6de5dcd65a7ad9bdc7f54225d7ac50fd8f4a3a3ce9352f138e057faf2b2d6`
Upload date	Jul 26, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Release files / heaven_bml-2.6.1-py3-none-any.whl

Download URL	heaven_bml-2.6.1-py3-none-any.whl
Size	38.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`87f9359216e416756da70f79dce6a3fa9728897a66ebfb11a64e6428f37fed87`
BLAKE2b-256 checksum How to use checksums	`f68218b12c056b6facfed11d4042906c963fab41b3b34f7f18cd85b2c71ae036`
Upload date	Jul 26, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Security for heaven-bml 2.6.1

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.