@convesoft/mara 0.1.0-alpha.3 → 0.2.0-alpha.0

package/README.md

@@ -5,7 +5,10 @@ designs, decisions, and other durable facts stable identities, types, relations,
 validation, and deterministic retrieval. The same operations are available as
 a CLI and a stdio MCP server.
 
-Mara is currently pre-release software. The supported alpha hosts are x64 and
+Released Mara 0.1.0 provides the single-project CLI and MCP workflow. Development
+version 0.2.0-alpha.0 requires [schema format 2 and flavour guidance](docs/migration-0.2.mara.md)
+and adds `mara project init --template engineering`.
+Supported hosts are x64 and
 arm64 macOS, plus x64 and arm64 Linux compatible with Ubuntu 22.04's glibc
 baseline.
 
@@ -14,9 +17,9 @@ baseline.
 Pin the exact version so an MCP restart cannot silently change behavior:
 
 ```bash
-npx -y @convesoft/mara@0.1.0-alpha.3 --version
-npx -y @convesoft/mara@0.1.0-alpha.3 project init ./example
-npx -y @convesoft/mara@0.1.0-alpha.3 --project ./example project validate
+npx -y @convesoft/mara@0.1.0 --version
+npx -y @convesoft/mara@0.1.0 project init ./example
+npx -y @convesoft/mara@0.1.0 --project ./example project validate
 ```
 
 The npm packages contain prebuilt native binaries and use no install scripts.
@@ -29,7 +32,7 @@ For a client that starts stdio servers in the project directory:
 ```toml
 [mcp_servers.mara]
 command = "npx"
-args = ["-y", "@convesoft/mara@0.1.0-alpha.3", "mcp"]
+args = ["-y", "@convesoft/mara@0.1.0", "mcp"]
 ```
 
 To bind the server to one project regardless of its execution directory, place
@@ -40,7 +43,7 @@ To bind the server to one project regardless of its execution directory, place
 command = "npx"
 args = [
   "-y",
-  "@convesoft/mara@0.1.0-alpha.3",
+  "@convesoft/mara@0.1.0",
   "mcp",
   "--project",
   "/absolute/path/to/project",
@@ -57,7 +60,7 @@ Register the installed Mara executable as an MCP server and install the Mara
 skill separately:
 
 ```bash
-codex mcp add mara -- npx -y @convesoft/mara@0.1.0-alpha.3 mcp
+codex mcp add mara -- npx -y @convesoft/mara@0.1.0 mcp
 npx skills add convesoft/mara --skill mara -g -a codex
 ```
 
@@ -97,7 +100,7 @@ mara item get REQ-EXAMPLE
 ```
 
 Run `mara --help` or `mara <object> <operation> --help` for the complete command
-surface. The canonical alpha behavior is documented in
+surface. The core behavior is documented in
 [`docs/alpha.mara.md`](docs/alpha.mara.md). Structured update, move, rename,
 delete, and recovery follow [`docs/editing.mara.md`](docs/editing.mara.md).
 Search/list, `item related`, and `item get` return bounded pages; repeat the same
@@ -116,6 +119,8 @@ For existing projects whose items lack machine identities, run
 `mara project mid backfill`, then `mara project validate` before editing.
 Distribution and release guarantees are in
 [`docs/distribution.mara.md`](docs/distribution.mara.md).
+The [stable 0.1 contract](docs/release-0.1.mara.md) records scope and limitations;
+[planned 0.2 changes](docs/guided-authoring.mara.md) are not part of this version.
 
 ## Development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@convesoft/mara",
-  "version": "0.1.0-alpha.3",
+  "version": "0.2.0-alpha.0",
   "description": "Structured project knowledge CLI and MCP server",
   "author": "Aliaksei Raketski",
   "license": "MIT OR Apache-2.0",
@@ -18,10 +18,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@convesoft/mara-linux-x64-gnu": "0.1.0-alpha.3",
-    "@convesoft/mara-linux-arm64-gnu": "0.1.0-alpha.3",
-    "@convesoft/mara-darwin-x64": "0.1.0-alpha.3",
-    "@convesoft/mara-darwin-arm64": "0.1.0-alpha.3"
+    "@convesoft/mara-linux-x64-gnu": "0.2.0-alpha.0",
+    "@convesoft/mara-linux-arm64-gnu": "0.2.0-alpha.0",
+    "@convesoft/mara-darwin-x64": "0.2.0-alpha.0",
+    "@convesoft/mara-darwin-arm64": "0.2.0-alpha.0"
   },
   "files": [
     "bin/mara.cjs",

package/plugin.json

@@ -15,5 +15,5 @@
     "mcp",
     "agent-skill"
   ],
-  "version": "0.1.0-alpha.3"
+  "version": "0.2.0-alpha.0"
 }

package/skills/mara/SKILL.md

@@ -40,8 +40,12 @@ executable or runner rather than assuming a PATH installation or changing versio
 If the intended root has no `.mara/project.toml` and the user wants to start a
 Mara project, call `project_init` with the absolute root, or omit `project` when
 the MCP server was started with that root bound by `--project`. Use the default
-`minimal` template unless the user explicitly requests `empty`. The CLI equivalent
-is `"${mara_cli[@]}" --project /absolute/project --format json project init`.
+`minimal` template unless the user explicitly requests `empty` or `engineering`.
+Pass the selected name as `template` to `project_init`.
+`engineering` includes engineering flavours, selection guidance, and traceability
+relations; all templates generate configuration and schema only. The CLI equivalent
+is `"${mara_cli[@]}" --project /absolute/project --format json project init --template <template>`,
+where `<template>` is the selected `minimal`, `empty`, or `engineering` name.
 Do not create or modify `AGENTS.md` as part of Mara onboarding.
 
 ## Choose the operation