hummbl-dev/base120

base120 SDK

Python SDK for HUMMBL Base120 mental models. Stdlib-only — no third-party runtime dependencies. Includes Engine.select() for model recommendation, VERUM append-only audit ledger, MCP server (JSON-RPC 2.0), and CLI.

A

100.0

Overall Quality Score
Audited: 2026-04-14 Version: v2.0.0 Python 3.11+
148 Tests
5 Modules
0 Dependencies (stdlib)
0 High Findings
Apache-2.0 License

Category Breakdown

100
Lint
A
100
Security
A
100
Complexity
A
100
Dead Code
A
100
Duplication
A

Key Modules

Module Purpose Status
engine.py Keyword-overlap Engine.select() for model recommendation Pass
models.py 120 operator registry with metadata (6 families, P/IN/CO/DE/RE/SY) Pass
ledger.py VERUM append-only audit log — OperatorTuple (id/time/state/drift) Pass
mcp_server.py JSON-RPC 2.0 MCP server — 6 tools (get, list, families, prompt, select, record) Pass
cli.py CLI for query, list, record, and select commands Pass

Findings

Info Perfect score

No lint, security, complexity, dead code, or duplication findings. All 148 tests pass. Clean ruff output.

Info Zero runtime dependencies

All 5 modules use only Python stdlib. No pip install required beyond the package itself — pip install hummbl-base120 pulls zero transitive dependencies.

Info VERUM audit ledger

Append-only JSONL ledger with exactly 3 public methods: append(), project(), cut(). Operator tuples are immutable after writing — no delete, no mutation.

Want an audit like this for your codebase? Free for open-source repos.

Request Free Audit