@convesoft/mara 0.1.0-alpha.3 → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -8
- package/package.json +5 -5
- package/plugin.json +1 -1
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@ designs, decisions, and other durable facts stable identities, types, relations,
|
|
|
5
5
|
validation, and deterministic retrieval. The same operations are available as
|
|
6
6
|
a CLI and a stdio MCP server.
|
|
7
7
|
|
|
8
|
-
Mara
|
|
8
|
+
Mara 0.1.0 provides the single-project CLI and MCP workflow. Supported hosts are x64 and
|
|
9
9
|
arm64 macOS, plus x64 and arm64 Linux compatible with Ubuntu 22.04's glibc
|
|
10
10
|
baseline.
|
|
11
11
|
|
|
@@ -14,9 +14,9 @@ baseline.
|
|
|
14
14
|
Pin the exact version so an MCP restart cannot silently change behavior:
|
|
15
15
|
|
|
16
16
|
```bash
|
|
17
|
-
npx -y @convesoft/mara@0.1.0
|
|
18
|
-
npx -y @convesoft/mara@0.1.0
|
|
19
|
-
npx -y @convesoft/mara@0.1.0
|
|
17
|
+
npx -y @convesoft/mara@0.1.0 --version
|
|
18
|
+
npx -y @convesoft/mara@0.1.0 project init ./example
|
|
19
|
+
npx -y @convesoft/mara@0.1.0 --project ./example project validate
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
The npm packages contain prebuilt native binaries and use no install scripts.
|
|
@@ -29,7 +29,7 @@ For a client that starts stdio servers in the project directory:
|
|
|
29
29
|
```toml
|
|
30
30
|
[mcp_servers.mara]
|
|
31
31
|
command = "npx"
|
|
32
|
-
args = ["-y", "@convesoft/mara@0.1.0
|
|
32
|
+
args = ["-y", "@convesoft/mara@0.1.0", "mcp"]
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
To bind the server to one project regardless of its execution directory, place
|
|
@@ -40,7 +40,7 @@ To bind the server to one project regardless of its execution directory, place
|
|
|
40
40
|
command = "npx"
|
|
41
41
|
args = [
|
|
42
42
|
"-y",
|
|
43
|
-
"@convesoft/mara@0.1.0
|
|
43
|
+
"@convesoft/mara@0.1.0",
|
|
44
44
|
"mcp",
|
|
45
45
|
"--project",
|
|
46
46
|
"/absolute/path/to/project",
|
|
@@ -57,7 +57,7 @@ Register the installed Mara executable as an MCP server and install the Mara
|
|
|
57
57
|
skill separately:
|
|
58
58
|
|
|
59
59
|
```bash
|
|
60
|
-
codex mcp add mara -- npx -y @convesoft/mara@0.1.0
|
|
60
|
+
codex mcp add mara -- npx -y @convesoft/mara@0.1.0 mcp
|
|
61
61
|
npx skills add convesoft/mara --skill mara -g -a codex
|
|
62
62
|
```
|
|
63
63
|
|
|
@@ -97,7 +97,7 @@ mara item get REQ-EXAMPLE
|
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
Run `mara --help` or `mara <object> <operation> --help` for the complete command
|
|
100
|
-
surface. The
|
|
100
|
+
surface. The core behavior is documented in
|
|
101
101
|
[`docs/alpha.mara.md`](docs/alpha.mara.md). Structured update, move, rename,
|
|
102
102
|
delete, and recovery follow [`docs/editing.mara.md`](docs/editing.mara.md).
|
|
103
103
|
Search/list, `item related`, and `item get` return bounded pages; repeat the same
|
|
@@ -116,6 +116,8 @@ For existing projects whose items lack machine identities, run
|
|
|
116
116
|
`mara project mid backfill`, then `mara project validate` before editing.
|
|
117
117
|
Distribution and release guarantees are in
|
|
118
118
|
[`docs/distribution.mara.md`](docs/distribution.mara.md).
|
|
119
|
+
The [stable 0.1 contract](docs/release-0.1.mara.md) records scope and limitations;
|
|
120
|
+
[planned 0.2 changes](docs/guided-authoring.mara.md) are not part of this version.
|
|
119
121
|
|
|
120
122
|
## Development
|
|
121
123
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@convesoft/mara",
|
|
3
|
-
"version": "0.1.0
|
|
3
|
+
"version": "0.1.0",
|
|
4
4
|
"description": "Structured project knowledge CLI and MCP server",
|
|
5
5
|
"author": "Aliaksei Raketski",
|
|
6
6
|
"license": "MIT OR Apache-2.0",
|
|
@@ -18,10 +18,10 @@
|
|
|
18
18
|
"node": ">=18"
|
|
19
19
|
},
|
|
20
20
|
"optionalDependencies": {
|
|
21
|
-
"@convesoft/mara-linux-x64-gnu": "0.1.0
|
|
22
|
-
"@convesoft/mara-linux-arm64-gnu": "0.1.0
|
|
23
|
-
"@convesoft/mara-darwin-x64": "0.1.0
|
|
24
|
-
"@convesoft/mara-darwin-arm64": "0.1.0
|
|
21
|
+
"@convesoft/mara-linux-x64-gnu": "0.1.0",
|
|
22
|
+
"@convesoft/mara-linux-arm64-gnu": "0.1.0",
|
|
23
|
+
"@convesoft/mara-darwin-x64": "0.1.0",
|
|
24
|
+
"@convesoft/mara-darwin-arm64": "0.1.0"
|
|
25
25
|
},
|
|
26
26
|
"files": [
|
|
27
27
|
"bin/mara.cjs",
|
package/plugin.json
CHANGED