@inventarch/cli 3.8.0 → 3.8.1
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/SPEC.md +1 -1
- package/assets/base/969a1cf9091534f9194c8584c0e45c92449f2e24849db1431841ef73df52b888.ia.tgz +0 -0
- package/assets/base.json +3 -3
- package/assets/bases.json +6 -0
- package/assets/host/7d452748b9a79528d227b1c3374977cc713d5d9b5d3b81069cd9f01c47e825f1.tgz +0 -0
- package/assets/host.json +4 -4
- package/assets/language-compat.json +1 -1
- package/assets/vocabulary.json +1 -1
- package/dist/console/run.d.ts.map +1 -1
- package/dist/console/run.js +5 -2
- package/dist/console/run.js.map +1 -1
- package/dist/handoff.d.ts +3 -2
- package/dist/handoff.d.ts.map +1 -1
- package/dist/handoff.js +5 -2
- package/dist/handoff.js.map +1 -1
- package/package.json +7 -7
- package/assets/host/a6774998d18a78fc4d0d2d261db93aa76b25cc97e324823a7883597a94ccb91c.tgz +0 -0
package/SPEC.md
CHANGED
|
@@ -88,7 +88,7 @@ The generated set (2026-10-11): `renderProjectionFor` holds the packet and works
|
|
|
88
88
|
|
|
89
89
|
`--help` and per-command help describe the accepted argument grammar. Consumer `--json` output is a single structured value without interactive prompts; applying without a terminal or with `--json` requires `--yes`. `--no-color` (or `NO_COLOR`), `--color`, `--ascii` and `--quiet` adjust human-readable output. Validation errors exit 1 (warnings alone exit 0), usage failures exit 2, unavailable inputs and local operational refusals exit 3, a remote registry or archive that `install`, `update` or `restore` cannot reach or read exits 4 (`IA-DIST-ARTIFACT-UNAVAILABLE`, or a remote `IA-DIST-LIMIT-EXCEEDED`), and interruption exits 130. Automation should inspect the structured diagnostic code and exit value together.
|
|
90
90
|
|
|
91
|
-
A command typed into an `ia` is handed to the workspace's own installed `@inventarch/cli` before it is parsed (consumer-cli-contract §1.2). `IA_NO_HANDOFF=1` turns hand-off off, so the `ia` that was typed answers, and the session hook sets it for every child it starts. `IA_HANDOFF_FROM` is set only by a copy that hands off, to its package root's real path, and any non-empty value stops the receiving copy from handing off again.
|
|
91
|
+
A command typed into an `ia` is handed to the workspace's own installed `@inventarch/cli` before it is parsed (consumer-cli-contract §1.2); bare `ia`, `--user`, `doctor --host`, `workspaces` (user state, no workspace opened) and an extension's command token are answered by the running copy. `IA_NO_HANDOFF=1` turns hand-off off, so the `ia` that was typed answers, and the session hook sets it for every child it starts. `IA_HANDOFF_FROM` is set only by a copy that hands off, to its package root's real path, and any non-empty value stops the receiving copy from handing off again.
|
|
92
92
|
|
|
93
93
|
Every consumer refusal names one next command. With `--json` a refusal is `{version: 1, ok: false, code, message, exit, where, next}` and `next` is always a non-empty string; human output prints the same text on the `→` line, where the command it quotes is never broken across lines and runs past the line width when it must. The text quotes exactly one command and spells no other command or option outside it. That command is `ia …`, except that a recovery or a directory registry repair names `ia-distribution …`, the binary of `@inventarch/distribution`; a global install of `@inventarch/cli` does not put that binary on `PATH`, so such a command runs only where `@inventarch/distribution` is installed as well. The command carries the values this invocation supplied that it needs, such as the root (`ia init`'s `<directory>` included), the host, the package ids, the registry or catalog source, the descriptor or `--force`, so it runs from the directory the refused command ran in. Except where an unknown or interrupted command keeps the invocation as typed (below), a command that reruns the refused one repeats no output flag such as `--json` or `--quiet`, and one that runs the refused `ia install` or `ia update` again names its plan, without `--apply`: the plan applies nothing, although acquiring may fill the archive cache and `--plan-out` writes the plan file. A rerun of `ia restore`, which has no preview, carries `--apply --yes`; the rerun after deleting a cached archive drops `--offline`, so the archive is fetched again. A placeholder such as `<directory>`, `<path>`, `<file>` or `<url|dir>` stands only for the value the user has to correct or supply. A manual step the CLI cannot take, such as deleting or moving a named file, replacing a link under `.ia/src`, mapping a provider in `.ia/registries.json` or setting `IA_HOME`, may come first, and an explanation may follow. An unknown command names the nearest one with the rest of the invocation as typed, keeping only `--root` and `--params` for a machine operation. A workspace whose sources cannot be read (a link or alias under `.ia/src`, a source that changed during the read) names that repair and then `ia validate` with that root, which confirms the workspace opens. A service refusal that carries no next action of its own names the refused command's `--help` for a usage error, `ia validate` for a record finding (`IA-COMP-*`, `IA-GRAPH-*`, `IA-LANG-*`) and `ia doctor` for any other code, each with the root the invocation gave: its `--root`, or `ia init`'s `<directory>`. An interrupted command (`IA-CLI-INTERRUPTED`, exit 130) carries `next` in its JSON object and on its one stderr line: the rerun that finishes work already written, or otherwise the same invocation as typed, with any `--apply`, `--yes` and `--json` it was given. A file the invocation named that is not there (a `--descriptor`, `--catalog` or `--requests` file) names the same command with that one value as `<file>`. The machine protocol below is unchanged; its failures are the door's own one-line JSON and carry no `next`, so "every refusal names one next command" holds for the consumer commands. `@inventarch/cli/internal/consumer` keeps its 1.x forms: the `Refusal` constructor's `where` and `next` default to null, `refusalOf(error)` without the refused invocation returns a null `next` as before, and `renderRefusal` gives a refusal without a next action the fallback above, so `--json` `next` is always a string; every construction site in this CLI names its next action, which its tests enforce. `PlanRequest.reruns` in `@inventarch/cli/internal/distribute` is optional, and without it a plan's remedies are spelled from the request.
|
|
94
94
|
|
|
Binary file
|
package/assets/base.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "inventarch/language",
|
|
3
|
-
"version": "3.3.
|
|
4
|
-
"archive": "
|
|
5
|
-
"manifest": "
|
|
3
|
+
"version": "3.3.1",
|
|
4
|
+
"archive": "969a1cf9091534f9194c8584c0e45c92449f2e24849db1431841ef73df52b888",
|
|
5
|
+
"manifest": "396de8862c6620d1e93f090917ea60bf3a8f0dfcb0dd3f943fe7df619c1eec6f"
|
|
6
6
|
}
|
package/assets/bases.json
CHANGED
|
@@ -40,5 +40,11 @@
|
|
|
40
40
|
"version": "3.3.0",
|
|
41
41
|
"archive": "3ada760ec07848770957538a8562ec94c6f3a9ceb6f1e29d2739b217f9234728",
|
|
42
42
|
"manifest": "133e0ec85c27c457ba088623c2f753cb7618d531d1412fa957ad6c6ee7b700ee"
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"id": "inventarch/language",
|
|
46
|
+
"version": "3.3.1",
|
|
47
|
+
"archive": "969a1cf9091534f9194c8584c0e45c92449f2e24849db1431841ef73df52b888",
|
|
48
|
+
"manifest": "396de8862c6620d1e93f090917ea60bf3a8f0dfcb0dd3f943fe7df619c1eec6f"
|
|
43
49
|
}
|
|
44
50
|
]
|
|
Binary file
|
package/assets/host.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"release": "
|
|
3
|
-
"archive": "
|
|
4
|
-
"files":
|
|
5
|
-
"bytes":
|
|
2
|
+
"release": "c18a1953ed3ab21016e869a75c3be82bf2478583305dc3c0e58e17f937d6c4cd",
|
|
3
|
+
"archive": "7d452748b9a79528d227b1c3374977cc713d5d9b5d3b81069cd9f01c47e825f1",
|
|
4
|
+
"files": 1841,
|
|
5
|
+
"bytes": 12328176
|
|
6
6
|
}
|