Battam1111/Myco

v0.4.0 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 1mo AI Agents & Assistants

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agent-memory ai-agents ai-infrastructure autonomous-agents biomimetics claude

+14 more

claude-code codex cognitive-substrate cursor knowledge-management llm-memory llm-tools long-term-memory mcp mycelium python self-evolving substrate vscode

Affected surfaces

breaking_upgrade

Summary

AI summary

The v0.4.0 contract is intentionally non‑backward‑compatible; migrate using the provided script.

Full changelog

Myco v0.4.0 — Greenfield Rewrite

Every verb, every dimension, every contract surface re-authored from L0. The pre-rewrite v0.3.x codebase is retired; the new contract is not backward-compatible.

What's new

12 verbs across 5 biological subsystems — Genesis (genesis) · Ingestion (hunger/sense/forage/eat) · Digestion (reflect/digest/distill) · Circulation (perfuse/propagate) · Homeostasis (immune) · meta (session-end).
Manifest-driven dual surface. src/myco/surface/manifest.yaml is the single source of truth for both the CLI and the MCP server — one tool per verb, derived mechanically.
MCP server. myco.surface.mcp.build_server() ships as a library entry point. Standalone python -m myco.mcp launcher, [mcp] extras, and an official .plugin bundle arrive in v0.4.1.
Claude Code / Cowork hooks. Drop .claude/ into any project; SessionStart fires myco hunger, PreCompact fires myco session-end. Zero manual ceremony.
Eight-dimension homeostasis. immune lints across 4 categories / 8 dimensions (M1/M2/M3, SH1, MB1/MB2, SE1/SE2) with --fix support.
Seven hard contract rules (R1–R7) enforced jointly by hooks, immune system, and agent discipline. Full text: L1_CONTRACT/protocol.md.

Upgrading from v0.3.x

The v0.4.0 contract is intentionally non-backward-compatible. Existing substrates upgrade via:

python scripts/migrate_ascc_substrate.py <path-to-old-substrate>          # dry-run
python scripts/migrate_ascc_substrate.py <path-to-old-substrate> --execute

The migration script writes a _canon.yaml.v0_4_0_proposal.yaml next to the source canon; it refuses to mutate source files or overwrite an existing proposal.

Install

pip install myco
cd /path/to/your/project
myco genesis . --substrate-id my-project

Documentation

L0_VISION.md — five root principles
L1_CONTRACT/ — seven hard rules
L2_DOCTRINE/ — operating principles
CHANGELOG.md — full change record

v0.4.1 will add: standalone python -m myco.mcp launcher, [mcp] extras, official .plugin bundle, CONTRIBUTING.md.

Breaking Changes

v0.4.0 contract is not backward‑compatible with v0.3.x
All existing substrates must run the migration script `scripts/migrate_ascc_substrate.py` before using v0.4.0

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track Battam1111/Myco

Get notified when new releases ship.

About Battam1111/Myco

Agent-first cognitive substrate with 18 manifest-driven verbs (germinate / eat / assimilate / sporulate / traverse / immune / molt / …) and 25 lint dimensions enforcing contract invariants mechanically (R1–R7). Cross-session / cross-project memory via a self-validating filesystem graph — AST + markdown-link derived, not embedding-based. Provider-agnostic by design: MP1/MP2 dims forbid LLM-SDK imports in the kernel and plugin tree. Editable-default install. Works with Claude Code, Cursor, Windsurf, Zed, VS Code, and any MCP client.

All releases →