Battam1111/Myco

Myco v0.4.1 — Maintenance release

First maintenance release after the v0.4.0 greenfield rewrite. Ships
the four promises from v0.4.0, plus two cross-platform integration
passes and a narrative rewrite that positions Myco as the
substrate that ingests frameworks, not another framework that
will get replaced next quarter.

Not a framework. A substrate that ingests frameworks. When a new
framework ships, Myco eats it. When your work outgrows Myco's own
shape, the agent proposes changes through craft, you approve, the
kernel bumps. Even a complete internal rewrite stays a myco
release, not a new dependency. You never migrate again.

This works now, not because the idea is new, but because agents are
finally intelligent enough to maintain the system themselves.

Added

• [mcp] optional-dependency target. pip install 'myco[mcp]'
  pulls the MCP SDK (mcp>=1.2).
• python -m myco.mcp standalone launcher with
  --transport {stdio, sse, streamable-http}.
• mcp-server-myco console script. PATH-stable entry point;
  works with pipx, uvx, and every MCP host config.
• myco-install <client> one-command installer. Writes the
  correct schema for Claude Code, Claude Desktop, Cursor, Windsurf,
  Zed, VS Code, and OpenClaw. Preserves sibling servers; idempotent;
  --dry-run / --global / --uninstall supported.
• Official Claude-Code / Cowork plugin bundle. Install via
  /plugin marketplace add Battam1111/Myco then
  /plugin install myco@myco.
• substrate_pulse sidecar + initialization instructions. Every
  MCP client (Cursor, Windsurf, Zed, Codex, Gemini, Continue, Claude
  Desktop, OpenClaw, OpenHands) receives a compact R1-R7 summary at
  initialize, and every tool response carries a substrate_pulse
  field with current contract_version, substrate_id, and an
  escalating rule hint. Zero host-side configuration.
• CONTRIBUTING.md. 1100-word dual human + agent guide.
• docs/INSTALL.md. Comprehensive per-host matrix for every
  MCP-supporting host active in 2026-04, with exact config paths,
  exact snippets, and notes on schema variants. Python agent
  framework adapters included (LangChain, CrewAI, DSPy, Smolagents,
  Agno, PraisonAI, Microsoft Agent Framework, Claude Agent SDK).
  Hosts without native MCP (Aider CLI, SWE-agent, Void) flagged
  explicitly.

Changed

• Trilingual README (en / zh / ja) re-authored. The five L0
  principles (Only for the agent, Devour everything, Self-evolving
  shape, Nothing is final, Mycelium network) each appear with a
  practical phrasing and consequence. The three-role framing (you /
  agent / Myco) names concrete verbs instead of abstract nouns.
  Devour-everything is explicitly broadened to code repositories,
  framework documentation, datasets, and papers. Self-evolving
  shape promises that even a complete internal rewrite stays a
  myco version bump, not a new dependency. Zero em-dashes in any
  of the three READMEs.
• myco --help reads __version__ dynamically.
• Hook commands prefer myco over python -m myco for
  PATH stability.

Fixed

• CHANGELOG.md header stuck at [Unreleased] — 0.4.0.dev
  since v0.4.0 release commit; now dated properly.
• Stage-A scaffold test no longer hard-codes a version literal.
• Sdist hygiene via explicit [tool.hatch.build.targets.sdist]
  include / exclude: .release_notes_*.md, upload*.log, dist/,
  build/, legacy_v0_3/, .pytest_cache/, __pycache__/ cannot
  leak into the PyPI tarball.

Installation

pip install 'myco[mcp]'

Claude Code / Cowork:

/plugin marketplace add Battam1111/Myco
/plugin install myco@myco

Any other MCP host:

myco-install cursor        # or claude-desktop, windsurf, zed,
                           #    vscode, openclaw, claude-code

Or paste this snippet into any mcpServers-family host:

{ "mcpServers": { "myco": { "command": "mcp-server-myco", "args": [] } } }

The nine hosts with divergent schemas (VS Code Copilot, Zed,
OpenClaw, OpenHands, OpenCode / Kilo Code, Codex CLI, Goose, Warp,
Continue) get their own exact snippets in
docs/INSTALL.md, along with Python-framework
adapters.

Verified at release

• pytest tests/ — 341 / 341 pass
• python -m myco immune — exit 0, all 8 dimensions green
• python -m build — clean sdist + wheel
• python -m twine check dist/* — PASSED on both
• mcp-server-myco --help — runs from PATH
• myco-install --help — lists all seven supported clients
• grep -c em-dash — zero matches in any README

Full changelog

See CHANGELOG.md and
docs/contract_changelog.md.