Skip to content

contributing-code.md

Latest commit

 

History

History
83 lines (62 loc) · 2.28 KB

contributing-code.md

File metadata and controls

83 lines (62 loc) · 2.28 KB
Raw

Contributing code to Morphis

Audience: core contributors. Status: stub. Companion: ../../CONTRIBUTING.md.

Build setup

git clone https://github.com/morphis-foundation/morphis
cd morphis
make setup           # toolchain check + submodules + default LLMs
make dev             # run from source with hot reload
make test            # run the test pyramid
make lint            # rustfmt + clippy + ESLint for the Tauri frontend

Required:

  • Rust stable (>=1.78)
  • Node 22
  • Python 3.12
  • Wasmtime
  • Firecracker (Linux); Apple Virtualization.framework (Mac); Hyper-V (Windows)
  • cosign for signature verification in tests

Coding standards

Rust

  • cargo fmt (no exceptions).
  • clippy::all clean.
  • Public APIs documented with rustdoc.
  • No unwrap() outside tests; use ? or explicit error handling.
  • No new dependencies without RFC discussion if they're load-bearing (LLM, sandbox, signing).

TypeScript (Tauri frontend)

  • Prettier defaults.
  • ESLint clean.
  • No any in new code.

Python (skill SDK + tooling)

  • Ruff formatting and linting.
  • Type hints required for public API.

Commits

Conventional Commits. Example:

feat(memory): add Hebbian edge weight decay
fix(voice): correct ack-cache miss on cold start
docs(builders): clarify capability manifest signing flow

DCO sign-off on every commit:

git commit -s -m "..."

PR process

  1. Fork → branch → PR.
  2. CI must be green.
  3. At least one maintainer review for code; two for security-critical paths (Permission Broker, Critic, self-mod, LLM router).
  4. Squash-and-merge with a clean conventional-commit message.

Detail: ../../CONTRIBUTING.md.

RFC required for

  • Agent kernel changes
  • Security model changes
  • SKILL.md spec changes
  • morphis.policy schema changes
  • LLM router policy changes
  • Living Vault format changes
  • Governance changes

Process: ../governance/rfc-process.md.

Vibe-coded PRs

Allowed, with rules. See ../../CONTRIBUTING.md. Short version: tell us, run tests, don't touch security paths without coordinating, take responsibility for what you ship.

Stub. V0 release adds the make targets and CI workflows.