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, Krineia append-only audit ledger, MCP server (JSON-RPC 2.0), and CLI.

Last updated: June 18, 2026 · Terminology is coordinated with the HUMMBL Doctrine Glossary and HUMMBL Method.

Doctrine terms

This report references these HUMMBL doctrine terms:

  • Base120 — core operator set.
  • BaseN — governed extension model.
  • HUAOMP — doctrinal orientation for governance.
  • MTSMU — truthfulness and utility orientation.
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 Krineia 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 list, get, prompt, and families commands Pass

Findings

Info Perfect score

No lint, security, complexity, dead code, or duplication findings. All 157 tests pass in the current package verification. Clean ruff output.

Info Zero runtime dependencies

All 5 modules use only Python stdlib. Use the source checkout until PyPI publication is verified; the SDK has no runtime third-party dependencies.

Info Krineia audit ledger

Append-only JSONL ledger with exactly 3 public methods: append() and 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