Contributing (details)

Contributing (details)

The README keeps the short version; this page is the dev onboarding.

Dev setup

git clone https://github.com/kannamma-labs/cie && cd cie
uv venv && uv pip install --python .venv/bin/python -e ".[mcp,http,dev]"
source .venv/bin/activate
python -m pytest -q          # 312 passed as of v0.1.4

The honesty bar (the one rule that matters)

• DoD = verified against the real environment, never written-only.
• Published claims footnoted to measured artifacts; misses published.
• Dated records (CHANGELOG, session logs) are never retro-edited.
• If code and this wiki disagree, the code wins and the wiki gets a PR.

Where things are tracked

• roadmap.md — R1–R45 with status; todo.md — the same items at execution depth (file:line-verified plans) + the session log.
• Starter issues: #17, #18, #19 (created from the repo-trust-signals work).
• Conformance harness: python tool-test-lab/surface_conformance.py /tmp/sandbox /tmp/conf.json against tool-test-lab/approved_surface.json (135 tools, zero crashes).

Good first contributions

• A how-to you wish existed (wiki PRs count).
• A TESTS-edge heuristic gap you can measure (the direct-calls heuristic came exactly from such a measurement).
• Conformance/ground-truth tests for a tool you use.