Mara 0.3.0

Breaking changes and migration

Schema format 3 is required. Review existing project vocabulary and authored
relations before editing the schema; existing projects do not acquire the new
engineering profile or its rules automatically. The Agent Plugin distribution
has been removed; configure MCP explicitly and install the matching skill
separately. Follow the 0.3 migration guide
for source edits, validation, and client interface changes.

Added

• Rebuild Mara around engineering traceability

Build

• Drop Intel macOS and speed verification

Mara 0.3.0-alpha.0

Added

• Support inverse authoring and symmetric relationships
• Support typed inline relationships
• Introduce validation diagnostic codes and severity
• Validate conditional lifecycle and coverage rules
• Support typed external targets
• Validate relationship cardinality and cycles
• Generate traceability matrices
• Make code traceability language pluggable

Documentation

• Define relationship authoring and mutation contracts
• Define SHACL rules and trace-view contracts
• Retire specification export contract
• Document manual 0.3 migration workflow

Fixed

• Locate bounded trace chain limit failures

Maintenance

• Evaluate code traceability pilot
• Release 0.3.0-alpha.0

Mara 0.2.0

Breaking changes and migration

Schema format 2 requires flavour selection guidance. Migrate existing schemas
in place, preserving custom vocabulary and item identities; do not reinitialize.
CLI and MCP discovery now use search, get, and related for items and
narrative, replacing their item-prefixed forms and changing response shapes.
Use the matching executable and skill, refresh MCP tools, and discard old cursors.
Follow the 0.2 migration guide
for schema examples, command/response mapping, and reference validation changes.

Added

• Parse Mara items as Markdown containers
• Derive document structure and direct containment
• Resolve Markdown links, anchors, and mentions
• Add discovery handles and shared node summaries
• Search items and narrative through unified discovery
• Read every discovery node through unified get
• Explore direct connections through unified related
• Protect references across item mutations

Fixed

• Align 0.2 CLI and MCP onboarding

Maintenance

• Release 0.2.0

Tests

• Verify the packaged 0.2 workflow

Mara 0.2.0-alpha.0

Added

• Require schema format 2 and flavour guidance
• Add bundled engineering templates and prepare 0.2.0-alpha.0

Mara 0.1.0

Maintenance

• Release 0.1.0

Mara 0.1.0-alpha.3

Added

• Paginate search results and add optional excerpts
• Paginate direct relation results
• Paginate item reads with consecutive fragments
• Combine exact and typo-tolerant item search
• Rank search results by relevance
• Create items with initial relations atomically
• Filter item search and list by directory
• Filter project validation diagnostics by path

Documentation

• Clarify Mara skill workflows and JSON CLI fallback
• Investigate narrative retrieval boundaries

Fixed

• Clarify CLI help and MCP input guidance

Mara 0.1.0-alpha.2

Added

• Add durable item identities
• Move items between documents
• Update items structurally
• Delete unreferenced items safely
• Rename item IDs across the corpus

Continuous integration

• Remove optional plugin release automation

Documentation

• Clarify alpha 3 retrieval scope

Fixed

• Make plugin release validation deterministic
• Make Codex compatibility dispatchable

Mara 0.1.0-alpha.1

Added

• Add project-aware MCP onboarding, including explicit project selection and project initialization through MCP.
• Add the Mara skill for separate installation alongside a manually registered Mara MCP server.
• Include optional portable Agent Plugin metadata and a Convesoft marketplace entry.

Supported Codex setup

codex mcp add mara -- npx -y @convesoft/mara@0.1.0-alpha.1 mcp
npx skills add convesoft/mara --skill mara -g -a codex

The complete marketplace plugin is an optional convenience and is not release-gated.

Mara 0.1.0-alpha.0

Added

• Initialize and discover Mara projects
• Load and inspect project schemas
• Parse Mara documents into memory
• Validate Mara projects and items
• Create items and mutate relations
• Query project knowledge
• Expose alpha operations through MCP
• Improve deterministic item search
• Prepare first distributable alpha

Continuous integration

• Expose npm OIDC exchange diagnostics

Documentation

• Establish repository and document format
• Define self-hosting taxonomy
• Define first alpha contract
• Define delivery and review workflow
• Align Linear delivery instructions
• Add pull request template
• Document pull request workflow

Fixed

• Make release changelog squash-stable
• Run protected release from main context
• Publish missing npm package versions
• Publish npm tarballs from local paths
• Enable npm OIDC authentication
• Run releases from main push identity

Maintenance

• Dogfood Mara repository