@inventarch/mcp-door 1.2.0 → 3.0.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 +8 -0
- package/assets/vocabulary.json +11 -3
- package/dist/tools.d.ts.map +1 -1
- package/dist/tools.js +5 -1
- package/dist/tools.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,3 +1,11 @@
|
|
|
1
1
|
# @inventarch/mcp-door
|
|
2
2
|
|
|
3
3
|
See [the package contract](SPEC.md) and the exported TypeScript declarations.
|
|
4
|
+
|
|
5
|
+
`ia-mcp-door [--root <workspace>]` serves read-only MCP 2025-11-25 tools over one workspace root, as UTF-8 JSON-RPC lines on stdin and stdout. `tools/list` projects `MACHINE_PROTOCOL` from `@inventarch/runtime`: one tool per Door operation whose row names one, with the row's parameter schema as its `inputSchema` (`ia_context` adds the transport-only `format`), plus `ia_vocabulary`, which reads the catalogue shipped with the server and no workspace. That is twelve tools: `ia_scope`, `ia_context`, `ia_select`, `ia_get`, `ia_records`, `ia_resolve`, `ia_search` and `ia_traverse` from protocol version 1, `ia_read`, `ia_next` and `ia_position` from version 2, and `ia_vocabulary`. `report` is CLI-only. A scope token lives as long as the server process, so a token `ia_scope` issues narrows later calls.
|
|
6
|
+
|
|
7
|
+
`ia_read` returns the body behind one locator (`<identity>`, `<identity>#<phase>/<Primitive>`, `<identity>#<REQ-ID>` or `<path>:<line>`) inside the scope, with the SHA-256 of its UTF-8 bytes and `certified: false`: a fragment's text, else the document the record's source locator names, read from the workspace or, for an adopted mount, from the directory `.ia/workspace.json` binds it to, else the record's own body. A locator that no admitted record in the scope answers is refused as `IA-RUNTIME-READ-UNADMITTED`: through a token narrower than the whole workspace, one `ia_scope` issued with `identities`, a `phase` or a `root` below the workspace root, or from such a token, without naming what lies outside the scope; through the server's initial scope, the whole workspace, or a token `ia_scope` issued from it without narrowing it, naming what its sources hold there, a record admission refused with its `reason`. A document the server cannot read is named by its workspace-relative path, never by the server's root. Pass `includeRuntime: true` to read a record at runtime placement.
|
|
8
|
+
|
|
9
|
+
`ia_next` returns one plan's delivery view inside the scope, computed per call and never stored: the plan a `seat` (a `@plan`, `@milestone` or `@task` identity) belongs to, or without one the only `@plan` authored at band 100; its milestones and tasks in one prerequisites-first order, each task with a basis line per requirement, one verdict (`exit evidence recorded (…)`, `no declared blocker` or `blocked (…)`), its `work.status` as self-declared and five state lines; review items; and `next`, the command for the first task with no declared blocker. A refusal (`IA-RUNTIME-NEXT-SEAT`, `-NO-PLAN`, `-AMBIGUOUS` or `-CYCLE`) carries `next`, the one command to run, and the `plans` or the `cycle` it names.
|
|
10
|
+
|
|
11
|
+
`ia_position` returns body(K) for a scope key inside the scope, `{body, digest, hostNote}`: the key's parts `seat` (an identity, or `{path}` for a location), `shape`, `phase`, `depth` (0 to 2), `budget` (0 to 64) and `word`, all optional, no part being K0, the repository's `@workspace` at context, orient, depth 0 and budget 0. The body is a pure function of the key and the records the scope admits, so it names no root, token or time and reads no request text, and its `digest` is the SHA-256 of its canonical JSON; `hostNote` is host state beside it, the revision and how fresh the last `ia capture` is. A refusal of the key (`IA-RUNTIME-REQUEST-INVALID`) carries `next`, the one command to run.
|
package/assets/vocabulary.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"version": 1,
|
|
3
3
|
"language": "ia 1.0",
|
|
4
4
|
"status": "public IA 1.0 language contract",
|
|
5
|
-
"sourceDigest": "
|
|
5
|
+
"sourceDigest": "43a7078f421f094af2ac377e9dc76847211028cb33964e3459abc5aacc947d99",
|
|
6
6
|
"words": [
|
|
7
7
|
{
|
|
8
8
|
"word": "agent",
|
|
@@ -823,7 +823,14 @@
|
|
|
823
823
|
{
|
|
824
824
|
"path": "check.scope",
|
|
825
825
|
"type": "text",
|
|
826
|
-
"required": true
|
|
826
|
+
"required": true,
|
|
827
|
+
"description": "What the check selects: the whole-workspace token *, a scope its evaluator reports, or prose. It is text and claims no path; check.covers does."
|
|
828
|
+
},
|
|
829
|
+
{
|
|
830
|
+
"path": "check.covers",
|
|
831
|
+
"type": "list of text",
|
|
832
|
+
"required": false,
|
|
833
|
+
"description": "Path selections the check claims, matched by the location resolver. Claiming a path does not change which verdicts the check selects; check.scope does that."
|
|
827
834
|
}
|
|
828
835
|
],
|
|
829
836
|
"edges": []
|
|
@@ -3772,7 +3779,8 @@
|
|
|
3772
3779
|
{
|
|
3773
3780
|
"path": "composition.systems",
|
|
3774
3781
|
"type": "list of ref",
|
|
3775
|
-
"required": true
|
|
3782
|
+
"required": true,
|
|
3783
|
+
"target": "system"
|
|
3776
3784
|
},
|
|
3777
3785
|
{
|
|
3778
3786
|
"path": "composition.sources",
|
package/dist/tools.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AA0EA,eAAO,MAAM,KAAK;;;;;;;;;;;;;;GAKf,CAAC;AACJ,eAAO,MAAM,UAAU,qBAAuE,CAAC"}
|
package/dist/tools.js
CHANGED
|
@@ -16,7 +16,11 @@ const withFormat = (schema) => ({
|
|
|
16
16
|
...schema,
|
|
17
17
|
properties: { ...schema['properties'], format: FORMAT },
|
|
18
18
|
});
|
|
19
|
-
/**
|
|
19
|
+
/**
|
|
20
|
+
* M04: the door operations whose row names a tool, described once in @inventarch/runtime's MACHINE_PROTOCOL (spec-0012
|
|
21
|
+
* MCP-01): the eight of version 1 (report is CLI-only), and read, next and position, which version 2 adds (plan
|
|
22
|
+
* amendment A3).
|
|
23
|
+
*/
|
|
20
24
|
const served = MACHINE_PROTOCOL.operations.flatMap((operation) => operation.mcp === null
|
|
21
25
|
? []
|
|
22
26
|
: [
|
package/dist/tools.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAChC,MAAM,MAAM,GAAG,CAAC,UAAmC,EAAE,WAA8B,EAAE,EAAE,EAAE,CAAC,CAAC;IACzF,IAAI,EAAE,QAAQ;IACd,UAAU;IACV,QAAQ;IACR,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAC;AACH,wGAAwG;AACxG,MAAM,MAAM,GAAG;IACb,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;IACzB,WAAW,EACT,6LAA6L;CAChM,CAAC;AACF,MAAM,UAAU,GAAG,CAAC,MAAkB,EAAc,EAAE,CAAC,CAAC;IACtD,GAAG,MAAM;IACT,UAAU,EAAE,EAAE,GAAI,MAAM,CAAC,YAAY,CAA6B,EAAE,MAAM,EAAE,MAAM,EAAE;CACrF,CAAC,CAAC;AACH
|
|
1
|
+
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@inventarch/mcp-door",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "3.0.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"main": "./dist/main.js",
|
|
6
6
|
"types": "./dist/main.d.ts",
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
"LANGUAGE.md"
|
|
15
15
|
],
|
|
16
16
|
"dependencies": {
|
|
17
|
-
"@inventarch/runtime": "
|
|
17
|
+
"@inventarch/runtime": "3.0.0"
|
|
18
18
|
},
|
|
19
19
|
"devDependencies": {
|
|
20
20
|
"@types/node": "^22.19.0",
|