@pqpo/pragma 0.1.0-next.15 → 0.1.0-next.17
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 +13 -10
- package/dist/cli.js +221795 -234761
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -60,22 +60,25 @@ a durable `nextCursor`; copy it into the printed continuation command.
|
|
|
60
60
|
projection. `chat` and `work` deliberately fail with `INVALID_ARGUMENT` until
|
|
61
61
|
their contracts are ready; use `--view events` or `mission watch` meanwhile.
|
|
62
62
|
The text renderers use stable Mission/queue columns, while JSON and JSONL stay
|
|
63
|
-
pure `pragma.cli-result/v2` and `pragma.cli-event/v2` protocol output.
|
|
63
|
+
pure `pragma.cli-result/v2` and `pragma.cli-event/v2` protocol output. Use the
|
|
64
|
+
views printed by `pragma mission get --help` for the installed CLI version.
|
|
64
65
|
|
|
65
|
-
Runs wait for a terminal result by default. `--detach` returns after
|
|
66
|
-
|
|
67
|
-
omitted. Text mode prints the request,
|
|
66
|
+
Runs wait for a terminal result by default. `--detach` returns after the durable
|
|
67
|
+
command is persisted (it may still be queued), and `--request-id` is optional
|
|
68
|
+
because the CLI generates one when omitted. Text mode prints the request,
|
|
69
|
+
Mission, and execution identities;
|
|
68
70
|
machine formats keep those identities inside the protocol envelope.
|
|
71
|
+
The CLI does not start a resident daemon; without a live Desktop/Host owner, a
|
|
72
|
+
queued receipt remains recoverable until a later Host or attached/resume call
|
|
73
|
+
consumes it.
|
|
69
74
|
|
|
70
75
|
Command-specific help includes usage, defaults, output format, idempotency,
|
|
71
76
|
and a copyable example, for example `pragma mission get --help` or
|
|
72
77
|
`pragma expert discover --help`.
|
|
73
78
|
|
|
74
|
-
For scripts and other AI tools, use `--format=json` or `--format=jsonl
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
priority CLI > environment > default `info`; the current release may not yet
|
|
78
|
-
include this option.
|
|
79
|
+
For scripts and other AI tools, use `--format=json` or `--format=jsonl`, inspect
|
|
80
|
+
the process exit code, and treat `pragma --help` as the command-line capability
|
|
81
|
+
contract for the installed version.
|
|
79
82
|
|
|
80
83
|
The three documents have separate jobs: this README is the npm installation
|
|
81
84
|
and entry-point guide, the human guide explains interactive CLI/Mission
|
|
@@ -104,4 +107,4 @@ before loading the main bundle. Install Node.js 22 or later instead.
|
|
|
104
107
|
|
|
105
108
|
## License
|
|
106
109
|
|
|
107
|
-
Pragma CLI is distributed under the [Pragma Source Available License 1.0](
|
|
110
|
+
Pragma CLI is distributed under the [Pragma Source Available License 1.0](../../LICENSE).
|