@mostra/runtime 0.10.0 → 0.11.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/dist/bin.js +4058 -310
- package/dist/bin.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/{instance-FExcyENK.js → instance-DCiUHvgZ.js} +682 -47
- package/dist/instance-DCiUHvgZ.js.map +1 -0
- package/dist/reference/cli.md +1322 -0
- package/dist/reference/diagnostics.json +1552 -0
- package/dist/reference/errors/MOSTRA_A11Y_MINOR.md +23 -0
- package/dist/reference/errors/MOSTRA_A11Y_SERIOUS.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_CANCELLED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_EVENT_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_EXPORT_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_INTERRUPTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_PAUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_RUN_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_THREW.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_UNKNOWN_FUNCTION.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_UNSERIALIZABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_BUNDLE_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_DIR_NOT_EMPTY.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_ENTRY_AMBIGUOUS.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_ID_DROPPED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NO_ENTRY.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NO_PAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_PATCH_REJECTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_PATH_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_UNREADABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_TEMPLATE_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_COLLECTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_UNRESOLVED.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_CONFIG_UNWRITABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_UNKNOWN_COMMAND.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_USAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_CONSOLE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_CONSOLE_WARNING.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_INSTALL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_OFFLINE.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_SPEC_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_WARM_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BIND_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BROWSER_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_HELPER_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_NODE_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_PORT_TAKEN.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_RUNTIME_INSTALLING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_RUNTIME_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_SERVICE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_SHELL_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_WARM_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_DUPLICATE_ID.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_ID_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_ID_UNSTABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_MUTATION_ID_REUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_SHARED.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_UNBOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_DISK_FULL.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_GC_INCOMPLETE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_GONE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_INTEGRITY.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_LEDGER_UNREADABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_LOCKED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_MISMATCH.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NETWORK_FILESYSTEM.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NOT_ALWAYS_ON.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NOT_OWNED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_SOCKET_TOO_LONG.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_TOO_NEW.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_CONNECTION_CLOSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_CURSOR_COMPACTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_IDENTITY_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INITIALIZE_ORDER.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INTERNAL_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INVALID_PARAMS.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_MALFORMED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_MESSAGE_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_METHOD_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_NOTIFICATION_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_PORT_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_REQUEST_ID_REUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_REVISION_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_SHUTDOWN_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_SUBSCRIPTION_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_CONTENT_TYPE.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_CSRF_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_FRAME_SESSION.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_HEADERS_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_HOST_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_NOT_SERVED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_ORIGIN_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_RATE_LIMITED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_REQUEST_MALFORMED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SCOPE_DENIED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_REVOKED.md +23 -0
- package/dist/reference/errors/MOSTRA_LIVE_SOURCE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_LIVE_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_NOT_LITERAL.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_UNKNOWN_KEY.md +23 -0
- package/dist/reference/errors/MOSTRA_NETWORK_EXTERNAL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_NETWORK_REQUEST_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_PLATFORM_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_ID_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_SOURCE_CHANGED.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_VERIFY_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_ACTION_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_ARIA.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_FIELD_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_LIVE_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_PAGE_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_PIXELS.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_CONFIG_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_HOME_MOVING.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_HOME_SUSPENDED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_LIMIT_REACHED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_LOGIN_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_NOT_OWNER_INSTANCE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_NO_INSTANCE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_OPERATOR_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_OWNER_OFFLINE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_PAUSED_BY_OPERATOR.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_QUEUE_FULL.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_RATE_LIMITED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_SIGN_IN_REQUIRED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_UNDER_REVIEW.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_UNREACHABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_BLANK.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_NOT_READY.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_PAGE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_PARKED.md +23 -0
- package/dist/reference/errors/MOSTRA_SECRET_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_NOT_ENABLED.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_PORTS_EXHAUSTED.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TOOL_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TOOL_NOT_READY.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TTL_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TUNNEL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_SMOKE_BUDGET.md +23 -0
- package/dist/reference/errors/MOSTRA_SMOKE_NO_EFFECT.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_ALREADY.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_BLOCKED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_CHANNEL_DENIED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_PAUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_POLICY_NONE.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_REVISION_MOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_SIGNAL_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_VIEW_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_TARGET_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
- package/dist/reference/self-hosting.md +130 -0
- package/dist/reference/telemetry.md +84 -0
- package/dist/skill/SKILL.md +122 -0
- package/dist/skill/assets/examples/dashboard/index.tsx +161 -0
- package/dist/skill/assets/examples/dashboard/live.ts +25 -0
- package/dist/skill/assets/examples/dashboard/styles.css +125 -0
- package/dist/skill/assets/examples/decision/index.tsx +95 -0
- package/dist/skill/assets/examples/decision/styles.css +125 -0
- package/dist/skill/assets/examples/inbox/actions.ts +23 -0
- package/dist/skill/assets/examples/inbox/index.tsx +109 -0
- package/dist/skill/assets/examples/inbox/styles.css +125 -0
- package/dist/skill/assets/studio.css +125 -0
- package/dist/skill/references/answers.md +217 -0
- package/dist/skill/references/design.md +154 -0
- package/dist/skill/references/libraries.md +167 -0
- package/dist/skill/references/long-lived.md +148 -0
- package/dist/skill/references/mcp.md +68 -0
- package/dist/skill/references/page.md +131 -0
- package/dist/skill/references/server.md +146 -0
- package/dist/skill/references/sharing.md +123 -0
- package/dist/skill/references/verify.md +71 -0
- package/package.json +10 -5
- package/src/gateway/actions.ts +20 -0
- package/src/gateway/browser.ts +44 -0
- package/src/gateway/capabilities.ts +8 -0
- package/src/gateway/http.ts +12 -1
- package/src/gateway/index.ts +170 -5
- package/src/gateway/listener.ts +31 -6
- package/src/gateway/routes.ts +8 -0
- package/src/gc/index.ts +5 -0
- package/src/instance/index.ts +20 -1
- package/src/interaction/index.ts +60 -0
- package/src/interaction/pause.ts +106 -0
- package/src/interaction/submissions.ts +42 -1
- package/src/interaction/viewers.ts +34 -1
- package/src/ledger/index.ts +20 -1
- package/src/ledger/migrations.ts +51 -0
- package/src/link/author.ts +215 -0
- package/src/link/hosted.ts +37 -1
- package/src/link/http.ts +6 -1
- package/src/link/index.ts +3 -1
- package/src/link/manager.ts +138 -34
- package/src/protocol-server/client.ts +53 -0
- package/src/protocol-server/index.ts +1 -1
- package/src/server/api.ts +514 -72
- package/src/server/auth.ts +600 -74
- package/src/server/authorize.ts +816 -0
- package/src/server/clients.ts +235 -0
- package/src/server/config.ts +7 -0
- package/src/server/data.ts +59 -1
- package/src/server/directory.ts +69 -0
- package/src/server/feed.ts +191 -0
- package/src/server/handle.ts +172 -0
- package/src/server/hosted-pages.ts +532 -0
- package/src/server/hosted.ts +519 -18
- package/src/server/index.ts +343 -61
- package/src/server/mcp.ts +330 -0
- package/src/server/metering.ts +156 -0
- package/src/server/oauth-clients.ts +510 -0
- package/src/server/operator.ts +498 -0
- package/src/server/providers.ts +284 -0
- package/src/server/remove.ts +148 -0
- package/src/server/routing.ts +275 -0
- package/src/verify/runner.ts +23 -2
- package/dist/instance-FExcyENK.js.map +0 -1
|
@@ -0,0 +1,1322 @@
|
|
|
1
|
+
# The mostra CLI
|
|
2
|
+
|
|
3
|
+
<!-- Generated from the command definitions in packages/cli/src/commands/. Don't edit; run `pnpm fix`. -->
|
|
4
|
+
|
|
5
|
+
Every command takes `--json`, which prints one envelope on stdout: `{ "ok": true, "result", "instance", "warnings" }` or `{ "ok": false, "error", "warnings" }`. Streaming commands print one envelope per line, the last one carrying `result` or `error`. Logs and progress go to stderr. Without a terminal, or with `--json`, no command asks a question.
|
|
6
|
+
|
|
7
|
+
Commands: `add`, `daemon`, `dev`, `docs`, `doctor`, `export`, `gc`, `host`, `list`, `login`, `logout`, `mcp`, `new`, `open`, `pause`, `publish`, `push`, `results`, `resume`, `run`, `secret`, `share`, `state`, `status`, `telemetry`, `verify`, `wait`.
|
|
8
|
+
|
|
9
|
+
## mostra new
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
Create an artifact in an empty directory, with a generated ID.
|
|
13
|
+
|
|
14
|
+
Usage:
|
|
15
|
+
mostra new <dir> [flags]
|
|
16
|
+
|
|
17
|
+
Arguments:
|
|
18
|
+
<dir> The directory to create it in; it must be empty or not exist.
|
|
19
|
+
|
|
20
|
+
Flags:
|
|
21
|
+
--title <text> The artifact's title. Default: the directory's name.
|
|
22
|
+
--template <family> Start from a template (templates arrive in a later release).
|
|
23
|
+
--request-id <id> Make a retry return the first attempt's result.
|
|
24
|
+
|
|
25
|
+
Global flags:
|
|
26
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
27
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
28
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
29
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
30
|
+
--help Show this command's help; with --json, its definition.
|
|
31
|
+
|
|
32
|
+
Output: ArtifactCreateResult (mostra docs cli)
|
|
33
|
+
|
|
34
|
+
Exit codes:
|
|
35
|
+
0 success
|
|
36
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
37
|
+
2 usage error
|
|
38
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
39
|
+
4 timeout (--timeout passed)
|
|
40
|
+
|
|
41
|
+
Example:
|
|
42
|
+
mostra new ./sidebar-review --title 'Sidebar review'
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## mostra dev
|
|
46
|
+
|
|
47
|
+
```text
|
|
48
|
+
Preview an artifact's unpublished source with hot reload, until Ctrl-C; viewers never see it.
|
|
49
|
+
|
|
50
|
+
Usage:
|
|
51
|
+
mostra dev <path> [flags]
|
|
52
|
+
|
|
53
|
+
Arguments:
|
|
54
|
+
<path> The artifact's source: a file, a directory, or its ID.
|
|
55
|
+
|
|
56
|
+
Flags:
|
|
57
|
+
--port <port> The preview's port on 127.0.0.1; default one the system picks.
|
|
58
|
+
|
|
59
|
+
Global flags:
|
|
60
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
61
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
62
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
63
|
+
--help Show this command's help; with --json, its definition.
|
|
64
|
+
|
|
65
|
+
Output: DevStartResult (mostra docs cli)
|
|
66
|
+
|
|
67
|
+
Exit codes:
|
|
68
|
+
0 success
|
|
69
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
70
|
+
2 usage error
|
|
71
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
72
|
+
|
|
73
|
+
Example:
|
|
74
|
+
mostra dev ./sidebar-review
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## mostra verify
|
|
78
|
+
|
|
79
|
+
```text
|
|
80
|
+
Build, render and check an artifact's source; one verdict, nothing published.
|
|
81
|
+
|
|
82
|
+
Usage:
|
|
83
|
+
mostra verify <path> [flags]
|
|
84
|
+
|
|
85
|
+
Arguments:
|
|
86
|
+
<path> The artifact's source: a file, a directory, or its ID.
|
|
87
|
+
|
|
88
|
+
Flags:
|
|
89
|
+
--screenshots <when> Which screenshots the verdict marks as worth looking at. (on-failure, always, never) Default: on-failure.
|
|
90
|
+
|
|
91
|
+
Global flags:
|
|
92
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
93
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
94
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
95
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
96
|
+
--help Show this command's help; with --json, its definition.
|
|
97
|
+
|
|
98
|
+
Output: VerifyVerdict (mostra docs cli)
|
|
99
|
+
|
|
100
|
+
Exit codes:
|
|
101
|
+
0 success
|
|
102
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
103
|
+
2 usage error
|
|
104
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
105
|
+
4 timeout (--timeout passed)
|
|
106
|
+
|
|
107
|
+
Example:
|
|
108
|
+
mostra verify ./sidebar-review
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## mostra publish
|
|
112
|
+
|
|
113
|
+
```text
|
|
114
|
+
Publish an artifact's source as a new immutable version, gated by verify, and print its link.
|
|
115
|
+
|
|
116
|
+
Usage:
|
|
117
|
+
mostra publish <path> [flags]
|
|
118
|
+
|
|
119
|
+
Arguments:
|
|
120
|
+
<path> The artifact's source: a file, a directory, or its ID.
|
|
121
|
+
|
|
122
|
+
Flags:
|
|
123
|
+
--force Publish despite verify's errors and record their codes; never what didn't build.
|
|
124
|
+
--policy <policy> The submission policy to use, instead of the manifest's. (once, once-per-viewer, epochs, none)
|
|
125
|
+
--request-id <id> Make a retry return the first attempt's receipt.
|
|
126
|
+
|
|
127
|
+
Global flags:
|
|
128
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
129
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
130
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
131
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
132
|
+
--help Show this command's help; with --json, its definition.
|
|
133
|
+
|
|
134
|
+
Output: PublishReceipt (mostra docs cli)
|
|
135
|
+
|
|
136
|
+
Exit codes:
|
|
137
|
+
0 success
|
|
138
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
139
|
+
2 usage error
|
|
140
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
141
|
+
4 timeout (--timeout passed)
|
|
142
|
+
6 conflict (already submitted, a compare-and-set mismatch, a reused request ID)
|
|
143
|
+
|
|
144
|
+
Example:
|
|
145
|
+
mostra publish ./sidebar-review
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
## mostra open
|
|
149
|
+
|
|
150
|
+
```text
|
|
151
|
+
Print an artifact's capability link and open it in a browser; or mint, rotate or revoke a link.
|
|
152
|
+
|
|
153
|
+
Usage:
|
|
154
|
+
mostra open <artifact> [flags]
|
|
155
|
+
|
|
156
|
+
Arguments:
|
|
157
|
+
<artifact> The artifact: its source path or its ID.
|
|
158
|
+
|
|
159
|
+
Flags:
|
|
160
|
+
--new Mint a separate link instead of the artifact's default one.
|
|
161
|
+
--version <n|id> A new link that opens only this version.
|
|
162
|
+
--scope <a,b> A new link's scopes: view, draft, submit, review, signal, action:*. Default: all.
|
|
163
|
+
--ttl <d> A new link that expires after this long, such as 24h.
|
|
164
|
+
--viewer <ref> A new link that acts for this person, by your own stable key for them.
|
|
165
|
+
--viewer-name <name> The display name of --viewer.
|
|
166
|
+
--rotate <tokenId> Replace this link with a new one; the old one stops working.
|
|
167
|
+
--revoke <tokenId> Stop this link from working.
|
|
168
|
+
--browser Open a browser even without a terminal.
|
|
169
|
+
--no-browser Only print the link.
|
|
170
|
+
--request-id <id> Make a retried --new return the same link.
|
|
171
|
+
|
|
172
|
+
Global flags:
|
|
173
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
174
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
175
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
176
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
177
|
+
--help Show this command's help; with --json, its definition.
|
|
178
|
+
|
|
179
|
+
Output: CapabilityLink (mostra docs cli)
|
|
180
|
+
|
|
181
|
+
Exit codes:
|
|
182
|
+
0 success
|
|
183
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
184
|
+
2 usage error
|
|
185
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
186
|
+
4 timeout (--timeout passed)
|
|
187
|
+
|
|
188
|
+
Example:
|
|
189
|
+
mostra open ./sidebar-review
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
## mostra share
|
|
193
|
+
|
|
194
|
+
```text
|
|
195
|
+
Open an artifact to people beyond this machine: inside your tailnet, publicly with a link that expires, or hosted on a server.
|
|
196
|
+
|
|
197
|
+
Usage:
|
|
198
|
+
mostra share <artifact> [<server>] [flags]
|
|
199
|
+
|
|
200
|
+
Arguments:
|
|
201
|
+
<artifact> The artifact: its source path or its ID.
|
|
202
|
+
<server> With --cloud: the server's address. Default: the server signed in to last.
|
|
203
|
+
|
|
204
|
+
Flags:
|
|
205
|
+
--cloud Host it on a remote server you signed in to with mostra login: the link keeps working while this machine sleeps.
|
|
206
|
+
--tailnet Share inside your tailnet through Tailscale Serve; each viewer is their tailnet identity.
|
|
207
|
+
--public Share publicly: anyone with the link can open it until it expires.
|
|
208
|
+
--via <tunnel> The public tunnel: a Cloudflare quick tunnel (no account), or Tailscale Funnel (shows your device's tailnet name). (cloudflare, funnel) Default: cloudflare.
|
|
209
|
+
--ttl <d> How long the link works, such as 30m or 24h. Public: 1h by default, 7d at most.
|
|
210
|
+
--scope <a,b> The link's scopes: view, draft, submit, review, signal, action:*. Default: all.
|
|
211
|
+
--viewer <ref> The person the link is for, by your own stable key for them; without it, each link is a viewer of its own.
|
|
212
|
+
--viewer-name <name> The display name of --viewer.
|
|
213
|
+
--request-id <id> Make a retried share return the same share instead of opening another.
|
|
214
|
+
|
|
215
|
+
Global flags:
|
|
216
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
217
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
218
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
219
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
220
|
+
--help Show this command's help; with --json, its definition.
|
|
221
|
+
|
|
222
|
+
Output: ShareStartResult (mostra docs cli)
|
|
223
|
+
|
|
224
|
+
Exit codes:
|
|
225
|
+
0 success
|
|
226
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
227
|
+
2 usage error
|
|
228
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
229
|
+
4 timeout (--timeout passed)
|
|
230
|
+
|
|
231
|
+
Example:
|
|
232
|
+
mostra share ./sidebar-review --cloud
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
## mostra share stop
|
|
236
|
+
|
|
237
|
+
```text
|
|
238
|
+
Stop a share, or every share of an artifact: its link stops working and its tunnel closes.
|
|
239
|
+
|
|
240
|
+
Usage:
|
|
241
|
+
mostra share stop <target>
|
|
242
|
+
|
|
243
|
+
Arguments:
|
|
244
|
+
<target> A share's ID (shr_…), or an artifact's source path or ID.
|
|
245
|
+
|
|
246
|
+
Global flags:
|
|
247
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
248
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
249
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
250
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
251
|
+
--help Show this command's help; with --json, its definition.
|
|
252
|
+
|
|
253
|
+
Output: ShareStopResult (mostra docs cli)
|
|
254
|
+
|
|
255
|
+
Exit codes:
|
|
256
|
+
0 success
|
|
257
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
258
|
+
2 usage error
|
|
259
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
260
|
+
4 timeout (--timeout passed)
|
|
261
|
+
|
|
262
|
+
Example:
|
|
263
|
+
mostra share stop ./sidebar-review
|
|
264
|
+
```
|
|
265
|
+
|
|
266
|
+
## mostra share list
|
|
267
|
+
|
|
268
|
+
```text
|
|
269
|
+
List the active shares, of every artifact or of one; --all adds the ones that ended.
|
|
270
|
+
|
|
271
|
+
Usage:
|
|
272
|
+
mostra share list [<artifact>] [flags]
|
|
273
|
+
|
|
274
|
+
Arguments:
|
|
275
|
+
<artifact> Only this artifact's shares: its source path or ID.
|
|
276
|
+
|
|
277
|
+
Flags:
|
|
278
|
+
--all Also list shares that ended, and why.
|
|
279
|
+
|
|
280
|
+
Global flags:
|
|
281
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
282
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
283
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
284
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
285
|
+
--help Show this command's help; with --json, its definition.
|
|
286
|
+
|
|
287
|
+
Output: ShareListResult (mostra docs cli)
|
|
288
|
+
|
|
289
|
+
Exit codes:
|
|
290
|
+
0 success
|
|
291
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
292
|
+
2 usage error
|
|
293
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
294
|
+
4 timeout (--timeout passed)
|
|
295
|
+
|
|
296
|
+
Example:
|
|
297
|
+
mostra share list --all
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
## mostra login
|
|
301
|
+
|
|
302
|
+
```text
|
|
303
|
+
Sign this machine's Mostra in to a remote server, so mostra share --cloud can host pages there.
|
|
304
|
+
|
|
305
|
+
Usage:
|
|
306
|
+
mostra login [<server>] [flags]
|
|
307
|
+
|
|
308
|
+
Arguments:
|
|
309
|
+
<server> The server's address, such as https://api.example.com. Default: the server signed in to last.
|
|
310
|
+
|
|
311
|
+
Flags:
|
|
312
|
+
--default Make this machine the account's default, the one chat apps create pages on. Default: the first machine linked.
|
|
313
|
+
--key-file <string> Link with a key the server's operator issued for an account, read from this file, instead of a person's sign-in (for an always-on machine).
|
|
314
|
+
|
|
315
|
+
Global flags:
|
|
316
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
317
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
318
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
319
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
320
|
+
--help Show this command's help; with --json, its definition.
|
|
321
|
+
|
|
322
|
+
Output: RemoteLoginWaitResult (mostra docs cli)
|
|
323
|
+
|
|
324
|
+
Exit codes:
|
|
325
|
+
0 success
|
|
326
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
327
|
+
2 usage error
|
|
328
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
329
|
+
4 timeout (--timeout passed)
|
|
330
|
+
|
|
331
|
+
Example:
|
|
332
|
+
mostra login https://api.example.com
|
|
333
|
+
```
|
|
334
|
+
|
|
335
|
+
## mostra logout
|
|
336
|
+
|
|
337
|
+
```text
|
|
338
|
+
Sign this machine's Mostra out of a remote server; its hosted pages keep working, and their answers wait for the next sign-in.
|
|
339
|
+
|
|
340
|
+
Usage:
|
|
341
|
+
mostra logout [<server>] [flags]
|
|
342
|
+
|
|
343
|
+
Arguments:
|
|
344
|
+
<server> The server's address. Default: the server signed in to last.
|
|
345
|
+
|
|
346
|
+
Flags:
|
|
347
|
+
--forget Also forget this machine's link to the server: the pages it shared there are no longer its own.
|
|
348
|
+
|
|
349
|
+
Global flags:
|
|
350
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
351
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
352
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
353
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
354
|
+
--help Show this command's help; with --json, its definition.
|
|
355
|
+
|
|
356
|
+
Output: RemoteLogoutResult (mostra docs cli)
|
|
357
|
+
|
|
358
|
+
Exit codes:
|
|
359
|
+
0 success
|
|
360
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
361
|
+
2 usage error
|
|
362
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
363
|
+
4 timeout (--timeout passed)
|
|
364
|
+
|
|
365
|
+
Example:
|
|
366
|
+
mostra logout
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
## mostra pause
|
|
370
|
+
|
|
371
|
+
```text
|
|
372
|
+
Pause an artifact: its pages stay viewable and its links valid, but it takes no answers and runs no actions until resumed.
|
|
373
|
+
|
|
374
|
+
Usage:
|
|
375
|
+
mostra pause <artifact> [flags]
|
|
376
|
+
|
|
377
|
+
Arguments:
|
|
378
|
+
<artifact> The artifact: its source path or its ID.
|
|
379
|
+
|
|
380
|
+
Flags:
|
|
381
|
+
--reason <string> Why, shown to the page's viewers beside the paused notice.
|
|
382
|
+
|
|
383
|
+
Global flags:
|
|
384
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
385
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
386
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
387
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
388
|
+
--help Show this command's help; with --json, its definition.
|
|
389
|
+
|
|
390
|
+
Output: ArtifactPauseResult (mostra docs cli)
|
|
391
|
+
|
|
392
|
+
Exit codes:
|
|
393
|
+
0 success
|
|
394
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
395
|
+
2 usage error
|
|
396
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
397
|
+
4 timeout (--timeout passed)
|
|
398
|
+
|
|
399
|
+
Example:
|
|
400
|
+
mostra pause ./survey --reason "Closed for review until Monday"
|
|
401
|
+
```
|
|
402
|
+
|
|
403
|
+
## mostra resume
|
|
404
|
+
|
|
405
|
+
```text
|
|
406
|
+
Resume a paused artifact: it takes answers and runs actions again.
|
|
407
|
+
|
|
408
|
+
Usage:
|
|
409
|
+
mostra resume <artifact>
|
|
410
|
+
|
|
411
|
+
Arguments:
|
|
412
|
+
<artifact> The artifact: its source path or its ID.
|
|
413
|
+
|
|
414
|
+
Global flags:
|
|
415
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
416
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
417
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
418
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
419
|
+
--help Show this command's help; with --json, its definition.
|
|
420
|
+
|
|
421
|
+
Output: ArtifactPauseResult (mostra docs cli)
|
|
422
|
+
|
|
423
|
+
Exit codes:
|
|
424
|
+
0 success
|
|
425
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
426
|
+
2 usage error
|
|
427
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
428
|
+
4 timeout (--timeout passed)
|
|
429
|
+
|
|
430
|
+
Example:
|
|
431
|
+
mostra resume ./survey
|
|
432
|
+
```
|
|
433
|
+
|
|
434
|
+
## mostra wait
|
|
435
|
+
|
|
436
|
+
```text
|
|
437
|
+
Block until an artifact's submission, signal, state change or event; still_waiting on timeout.
|
|
438
|
+
|
|
439
|
+
Usage:
|
|
440
|
+
mostra wait <artifact> [flags]
|
|
441
|
+
|
|
442
|
+
Arguments:
|
|
443
|
+
<artifact> The artifact: its source path or its ID.
|
|
444
|
+
|
|
445
|
+
Flags:
|
|
446
|
+
--until <condition> submitted, signal:<name>, state:<fieldId> or event:<type>.
|
|
447
|
+
--after <cursor> Wait for what comes after this cursor. Default: the latest publish.
|
|
448
|
+
--timeout <d> Stop waiting after this long, with still_waiting and exit 5. Default: no limit.
|
|
449
|
+
|
|
450
|
+
Global flags:
|
|
451
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
452
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
453
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
454
|
+
--help Show this command's help; with --json, its definition.
|
|
455
|
+
|
|
456
|
+
Output: WaitResult (mostra docs cli)
|
|
457
|
+
|
|
458
|
+
Exit codes:
|
|
459
|
+
0 success
|
|
460
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
461
|
+
2 usage error
|
|
462
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
463
|
+
5 still waiting (the wait timed out; the result says where to resume)
|
|
464
|
+
|
|
465
|
+
Example:
|
|
466
|
+
mostra wait ./sidebar-review --until submitted --timeout 30m
|
|
467
|
+
```
|
|
468
|
+
|
|
469
|
+
## mostra results
|
|
470
|
+
|
|
471
|
+
```text
|
|
472
|
+
Print an artifact's submission in full: answers, state, choices, comments, actions and signals.
|
|
473
|
+
|
|
474
|
+
Usage:
|
|
475
|
+
mostra results <artifact> [flags]
|
|
476
|
+
|
|
477
|
+
Arguments:
|
|
478
|
+
<artifact> The artifact: its source path or its ID.
|
|
479
|
+
|
|
480
|
+
Flags:
|
|
481
|
+
--submission <id> This submission instead of the latest.
|
|
482
|
+
--format <format> Markdown or JSON. Default: Markdown, or JSON with --json. (md, json)
|
|
483
|
+
|
|
484
|
+
Global flags:
|
|
485
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
486
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
487
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
488
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
489
|
+
--help Show this command's help; with --json, its definition.
|
|
490
|
+
|
|
491
|
+
Output: Results (mostra docs cli)
|
|
492
|
+
|
|
493
|
+
Exit codes:
|
|
494
|
+
0 success
|
|
495
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
496
|
+
2 usage error
|
|
497
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
498
|
+
4 timeout (--timeout passed)
|
|
499
|
+
|
|
500
|
+
Example:
|
|
501
|
+
mostra results ./sidebar-review
|
|
502
|
+
```
|
|
503
|
+
|
|
504
|
+
## mostra state get
|
|
505
|
+
|
|
506
|
+
```text
|
|
507
|
+
Read an artifact's state: the fields every viewer shares, with their revisions.
|
|
508
|
+
|
|
509
|
+
Usage:
|
|
510
|
+
mostra state get <artifact> [<id…>]
|
|
511
|
+
|
|
512
|
+
Arguments:
|
|
513
|
+
<artifact> The artifact: its source path or its ID.
|
|
514
|
+
<id> Only these field IDs.
|
|
515
|
+
|
|
516
|
+
Global flags:
|
|
517
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
518
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
519
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
520
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
521
|
+
--help Show this command's help; with --json, its definition.
|
|
522
|
+
|
|
523
|
+
Output: StateGetResult (mostra docs cli)
|
|
524
|
+
|
|
525
|
+
Exit codes:
|
|
526
|
+
0 success
|
|
527
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
528
|
+
2 usage error
|
|
529
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
530
|
+
4 timeout (--timeout passed)
|
|
531
|
+
|
|
532
|
+
Example:
|
|
533
|
+
mostra state get ./tasks priorities
|
|
534
|
+
```
|
|
535
|
+
|
|
536
|
+
## mostra state set
|
|
537
|
+
|
|
538
|
+
```text
|
|
539
|
+
Set one field of an artifact's state; viewers see it at once.
|
|
540
|
+
|
|
541
|
+
Usage:
|
|
542
|
+
mostra state set <artifact> <id> <value> [flags]
|
|
543
|
+
|
|
544
|
+
Arguments:
|
|
545
|
+
<artifact> The artifact: its source path or its ID.
|
|
546
|
+
<id> The field ID.
|
|
547
|
+
<value> The value, as JSON.
|
|
548
|
+
|
|
549
|
+
Flags:
|
|
550
|
+
--base <revision> Write only if the fields are unchanged since this revision; else a conflict (exit 6).
|
|
551
|
+
--as <actor> Who the change is attributed to. (agent, host) Default: agent.
|
|
552
|
+
--mutation-id <mut_…> Make a retry return the first attempt's result.
|
|
553
|
+
|
|
554
|
+
Global flags:
|
|
555
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
556
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
557
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
558
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
559
|
+
--help Show this command's help; with --json, its definition.
|
|
560
|
+
|
|
561
|
+
Output: StatePatchResult (mostra docs cli)
|
|
562
|
+
|
|
563
|
+
Exit codes:
|
|
564
|
+
0 success
|
|
565
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
566
|
+
2 usage error
|
|
567
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
568
|
+
4 timeout (--timeout passed)
|
|
569
|
+
6 conflict (already submitted, a compare-and-set mismatch, a reused request ID)
|
|
570
|
+
|
|
571
|
+
Example:
|
|
572
|
+
mostra state set ./tasks priorities '["Ship the CLI"]'
|
|
573
|
+
```
|
|
574
|
+
|
|
575
|
+
## mostra state patch
|
|
576
|
+
|
|
577
|
+
```text
|
|
578
|
+
Change several fields of an artifact's state in one revision: [{ id, value } | { id, delete: true }].
|
|
579
|
+
|
|
580
|
+
Usage:
|
|
581
|
+
mostra state patch <artifact> [flags]
|
|
582
|
+
|
|
583
|
+
Arguments:
|
|
584
|
+
<artifact> The artifact: its source path or its ID.
|
|
585
|
+
|
|
586
|
+
Flags:
|
|
587
|
+
--ops <json> The operations, as JSON.
|
|
588
|
+
--file <path> Read the operations from a JSON file.
|
|
589
|
+
--stdin Read the operations from stdin.
|
|
590
|
+
--base <revision> Write only if the fields are unchanged since this revision; else a conflict (exit 6).
|
|
591
|
+
--as <actor> Who the change is attributed to. (agent, host) Default: agent.
|
|
592
|
+
--mutation-id <mut_…> Make a retry return the first attempt's result.
|
|
593
|
+
|
|
594
|
+
Global flags:
|
|
595
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
596
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
597
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
598
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
599
|
+
--help Show this command's help; with --json, its definition.
|
|
600
|
+
|
|
601
|
+
Output: StatePatchResult (mostra docs cli)
|
|
602
|
+
|
|
603
|
+
Exit codes:
|
|
604
|
+
0 success
|
|
605
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
606
|
+
2 usage error
|
|
607
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
608
|
+
4 timeout (--timeout passed)
|
|
609
|
+
6 conflict (already submitted, a compare-and-set mismatch, a reused request ID)
|
|
610
|
+
|
|
611
|
+
Example:
|
|
612
|
+
mostra state patch ./tasks --file ops.json
|
|
613
|
+
```
|
|
614
|
+
|
|
615
|
+
## mostra push
|
|
616
|
+
|
|
617
|
+
```text
|
|
618
|
+
Push a value into an artifact's live source; pages showing it update at once.
|
|
619
|
+
|
|
620
|
+
Usage:
|
|
621
|
+
mostra push <artifact> <key> [flags]
|
|
622
|
+
|
|
623
|
+
Arguments:
|
|
624
|
+
<artifact> The artifact: its source path or its ID.
|
|
625
|
+
<key> The live source's key: its export name in live.ts, or a new one.
|
|
626
|
+
|
|
627
|
+
Flags:
|
|
628
|
+
--value <json> The value, as JSON.
|
|
629
|
+
--file <path> Read the value from a JSON file.
|
|
630
|
+
--stdin Read the value from stdin.
|
|
631
|
+
--append Add the value to the source's ring instead of replacing it.
|
|
632
|
+
--request-id <id> Make a retry return the first attempt's revision.
|
|
633
|
+
|
|
634
|
+
Global flags:
|
|
635
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
636
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
637
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
638
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
639
|
+
--help Show this command's help; with --json, its definition.
|
|
640
|
+
|
|
641
|
+
Output: LivePushResult (mostra docs cli)
|
|
642
|
+
|
|
643
|
+
Exit codes:
|
|
644
|
+
0 success
|
|
645
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
646
|
+
2 usage error
|
|
647
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
648
|
+
4 timeout (--timeout passed)
|
|
649
|
+
|
|
650
|
+
Example:
|
|
651
|
+
mostra push ./dashboard prices --value '{"btc": 64000}'
|
|
652
|
+
```
|
|
653
|
+
|
|
654
|
+
## mostra add
|
|
655
|
+
|
|
656
|
+
```text
|
|
657
|
+
Add npm packages to an artifact's lockfile at exact versions, installing them into the home's store.
|
|
658
|
+
|
|
659
|
+
Usage:
|
|
660
|
+
mostra add <package…> [flags]
|
|
661
|
+
|
|
662
|
+
Arguments:
|
|
663
|
+
<package> npm specs: name, name@version, name@range or name@tag.
|
|
664
|
+
|
|
665
|
+
Flags:
|
|
666
|
+
--artifact <path|id> The artifact. Default: the one in the current directory.
|
|
667
|
+
--request-id <id> Make a retry return the first attempt's result.
|
|
668
|
+
|
|
669
|
+
Global flags:
|
|
670
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
671
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
672
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
673
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
674
|
+
--help Show this command's help; with --json, its definition.
|
|
675
|
+
|
|
676
|
+
Output: DepsAddResult (mostra docs cli)
|
|
677
|
+
|
|
678
|
+
Exit codes:
|
|
679
|
+
0 success
|
|
680
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
681
|
+
2 usage error
|
|
682
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
683
|
+
4 timeout (--timeout passed)
|
|
684
|
+
|
|
685
|
+
Example:
|
|
686
|
+
mostra add recharts@3 --artifact ./dashboard
|
|
687
|
+
```
|
|
688
|
+
|
|
689
|
+
## mostra export
|
|
690
|
+
|
|
691
|
+
```text
|
|
692
|
+
Write a published version out of the home, as a portable bundle another home can run.
|
|
693
|
+
|
|
694
|
+
Usage:
|
|
695
|
+
mostra export <artifact> [flags]
|
|
696
|
+
|
|
697
|
+
Arguments:
|
|
698
|
+
<artifact> The artifact: its source path or its ID.
|
|
699
|
+
|
|
700
|
+
Flags:
|
|
701
|
+
--as <class> What to write: `bundle`, the version's builds, manifest, lockfile and source. (bundle) Default: bundle.
|
|
702
|
+
--out <path> Where: a new directory, or one archive when it ends in .tar.zst.
|
|
703
|
+
--version <number|id> The version. Default: the latest.
|
|
704
|
+
|
|
705
|
+
Global flags:
|
|
706
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
707
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
708
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
709
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
710
|
+
--help Show this command's help; with --json, its definition.
|
|
711
|
+
|
|
712
|
+
Output: ArtifactExportResult (mostra docs cli)
|
|
713
|
+
|
|
714
|
+
Exit codes:
|
|
715
|
+
0 success
|
|
716
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
717
|
+
2 usage error
|
|
718
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
719
|
+
4 timeout (--timeout passed)
|
|
720
|
+
|
|
721
|
+
Example:
|
|
722
|
+
mostra export ./sidebar-review --out ./sidebar-review.tar.zst
|
|
723
|
+
```
|
|
724
|
+
|
|
725
|
+
## mostra run
|
|
726
|
+
|
|
727
|
+
```text
|
|
728
|
+
Make a bundle `mostra export` wrote a version of this home, with the same IDs, and print its link.
|
|
729
|
+
|
|
730
|
+
Usage:
|
|
731
|
+
mostra run <bundle> [flags]
|
|
732
|
+
|
|
733
|
+
Arguments:
|
|
734
|
+
<bundle> The bundle: its directory or its .tar.zst archive.
|
|
735
|
+
|
|
736
|
+
Flags:
|
|
737
|
+
--request-id <id> Make a retry return the first attempt's receipt.
|
|
738
|
+
|
|
739
|
+
Global flags:
|
|
740
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
741
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
742
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
743
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
744
|
+
--help Show this command's help; with --json, its definition.
|
|
745
|
+
|
|
746
|
+
Output: PublishReceipt (mostra docs cli)
|
|
747
|
+
|
|
748
|
+
Exit codes:
|
|
749
|
+
0 success
|
|
750
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
751
|
+
2 usage error
|
|
752
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
753
|
+
4 timeout (--timeout passed)
|
|
754
|
+
|
|
755
|
+
Example:
|
|
756
|
+
mostra run ./sidebar-review.tar.zst
|
|
757
|
+
```
|
|
758
|
+
|
|
759
|
+
## mostra secret set
|
|
760
|
+
|
|
761
|
+
```text
|
|
762
|
+
Store a secret that server code reads with secret(name); the value comes from stdin and is never shown.
|
|
763
|
+
|
|
764
|
+
Usage:
|
|
765
|
+
mostra secret set <name> [flags]
|
|
766
|
+
|
|
767
|
+
Arguments:
|
|
768
|
+
<name> Letters, digits, _, . and -, starting with a letter or _.
|
|
769
|
+
|
|
770
|
+
Flags:
|
|
771
|
+
--artifact <path|id> The artifact's own secret, instead of one the whole home shares.
|
|
772
|
+
|
|
773
|
+
Global flags:
|
|
774
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
775
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
776
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
777
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
778
|
+
--help Show this command's help; with --json, its definition.
|
|
779
|
+
|
|
780
|
+
Output: SecretEntry (mostra docs cli)
|
|
781
|
+
|
|
782
|
+
Exit codes:
|
|
783
|
+
0 success
|
|
784
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
785
|
+
2 usage error
|
|
786
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
787
|
+
4 timeout (--timeout passed)
|
|
788
|
+
|
|
789
|
+
Example:
|
|
790
|
+
mostra secret set MAIL_TOKEN --artifact ./inbox < token.txt
|
|
791
|
+
```
|
|
792
|
+
|
|
793
|
+
## mostra secret list
|
|
794
|
+
|
|
795
|
+
```text
|
|
796
|
+
List the secrets' names and scopes; values are never shown.
|
|
797
|
+
|
|
798
|
+
Usage:
|
|
799
|
+
mostra secret list [flags]
|
|
800
|
+
|
|
801
|
+
Flags:
|
|
802
|
+
--artifact <path|id> The artifact's own secret, instead of one the whole home shares.
|
|
803
|
+
|
|
804
|
+
Global flags:
|
|
805
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
806
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
807
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
808
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
809
|
+
--help Show this command's help; with --json, its definition.
|
|
810
|
+
|
|
811
|
+
Output: SecretListResult (mostra docs cli)
|
|
812
|
+
|
|
813
|
+
Exit codes:
|
|
814
|
+
0 success
|
|
815
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
816
|
+
2 usage error
|
|
817
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
818
|
+
4 timeout (--timeout passed)
|
|
819
|
+
|
|
820
|
+
Example:
|
|
821
|
+
mostra secret list --artifact ./inbox
|
|
822
|
+
```
|
|
823
|
+
|
|
824
|
+
## mostra secret rm
|
|
825
|
+
|
|
826
|
+
```text
|
|
827
|
+
Delete a secret.
|
|
828
|
+
|
|
829
|
+
Usage:
|
|
830
|
+
mostra secret rm <name> [flags]
|
|
831
|
+
|
|
832
|
+
Arguments:
|
|
833
|
+
<name> The secret's name.
|
|
834
|
+
|
|
835
|
+
Flags:
|
|
836
|
+
--artifact <path|id> The artifact's own secret, instead of one the whole home shares.
|
|
837
|
+
|
|
838
|
+
Global flags:
|
|
839
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
840
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
841
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
842
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
843
|
+
--help Show this command's help; with --json, its definition.
|
|
844
|
+
|
|
845
|
+
Output: SecretDeleteResult (mostra docs cli)
|
|
846
|
+
|
|
847
|
+
Exit codes:
|
|
848
|
+
0 success
|
|
849
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
850
|
+
2 usage error
|
|
851
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
852
|
+
4 timeout (--timeout passed)
|
|
853
|
+
|
|
854
|
+
Example:
|
|
855
|
+
mostra secret rm MAIL_TOKEN --artifact ./inbox
|
|
856
|
+
```
|
|
857
|
+
|
|
858
|
+
## mostra list
|
|
859
|
+
|
|
860
|
+
```text
|
|
861
|
+
List the home's published artifacts.
|
|
862
|
+
|
|
863
|
+
Usage:
|
|
864
|
+
mostra list [flags]
|
|
865
|
+
|
|
866
|
+
Flags:
|
|
867
|
+
--family <family> Only artifacts of this family.
|
|
868
|
+
|
|
869
|
+
Global flags:
|
|
870
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
871
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
872
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
873
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
874
|
+
--help Show this command's help; with --json, its definition.
|
|
875
|
+
|
|
876
|
+
Output: ArtifactListResult (mostra docs cli)
|
|
877
|
+
|
|
878
|
+
Exit codes:
|
|
879
|
+
0 success
|
|
880
|
+
2 usage error
|
|
881
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
882
|
+
4 timeout (--timeout passed)
|
|
883
|
+
|
|
884
|
+
Example:
|
|
885
|
+
mostra list --family dashboard
|
|
886
|
+
```
|
|
887
|
+
|
|
888
|
+
## mostra status
|
|
889
|
+
|
|
890
|
+
```text
|
|
891
|
+
Show the instance (processes, workers, deliveries) or one artifact (versions, policy, links).
|
|
892
|
+
|
|
893
|
+
Usage:
|
|
894
|
+
mostra status [<artifact>]
|
|
895
|
+
|
|
896
|
+
Arguments:
|
|
897
|
+
<artifact> An artifact: its source path or its ID.
|
|
898
|
+
|
|
899
|
+
Global flags:
|
|
900
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
901
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
902
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
903
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
904
|
+
--help Show this command's help; with --json, its definition.
|
|
905
|
+
|
|
906
|
+
Output: InstanceStatusResult or ArtifactDetail (mostra docs cli)
|
|
907
|
+
|
|
908
|
+
Exit codes:
|
|
909
|
+
0 success
|
|
910
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
911
|
+
2 usage error
|
|
912
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
913
|
+
4 timeout (--timeout passed)
|
|
914
|
+
|
|
915
|
+
Example:
|
|
916
|
+
mostra status ./sidebar-review
|
|
917
|
+
```
|
|
918
|
+
|
|
919
|
+
## mostra daemon start
|
|
920
|
+
|
|
921
|
+
```text
|
|
922
|
+
Start the home's daemon, or find the one already running.
|
|
923
|
+
|
|
924
|
+
Usage:
|
|
925
|
+
mostra daemon start
|
|
926
|
+
|
|
927
|
+
Global flags:
|
|
928
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
929
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
930
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
931
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
932
|
+
--help Show this command's help; with --json, its definition.
|
|
933
|
+
|
|
934
|
+
Output: DaemonStatus (mostra docs cli)
|
|
935
|
+
|
|
936
|
+
Exit codes:
|
|
937
|
+
0 success
|
|
938
|
+
2 usage error
|
|
939
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
940
|
+
4 timeout (--timeout passed)
|
|
941
|
+
|
|
942
|
+
Example:
|
|
943
|
+
mostra daemon start
|
|
944
|
+
```
|
|
945
|
+
|
|
946
|
+
## mostra daemon stop
|
|
947
|
+
|
|
948
|
+
```text
|
|
949
|
+
Stop the home's daemon; open pages reconnect when it starts again.
|
|
950
|
+
|
|
951
|
+
Usage:
|
|
952
|
+
mostra daemon stop
|
|
953
|
+
|
|
954
|
+
Global flags:
|
|
955
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
956
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
957
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
958
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
959
|
+
--help Show this command's help; with --json, its definition.
|
|
960
|
+
|
|
961
|
+
Output: DaemonStop (mostra docs cli)
|
|
962
|
+
|
|
963
|
+
Exit codes:
|
|
964
|
+
0 success
|
|
965
|
+
2 usage error
|
|
966
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
967
|
+
4 timeout (--timeout passed)
|
|
968
|
+
|
|
969
|
+
Example:
|
|
970
|
+
mostra daemon stop
|
|
971
|
+
```
|
|
972
|
+
|
|
973
|
+
## mostra daemon restart
|
|
974
|
+
|
|
975
|
+
```text
|
|
976
|
+
Stop the home's daemon and start it again, for instance after an update.
|
|
977
|
+
|
|
978
|
+
Usage:
|
|
979
|
+
mostra daemon restart
|
|
980
|
+
|
|
981
|
+
Global flags:
|
|
982
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
983
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
984
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
985
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
986
|
+
--help Show this command's help; with --json, its definition.
|
|
987
|
+
|
|
988
|
+
Output: DaemonStatus (mostra docs cli)
|
|
989
|
+
|
|
990
|
+
Exit codes:
|
|
991
|
+
0 success
|
|
992
|
+
2 usage error
|
|
993
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
994
|
+
4 timeout (--timeout passed)
|
|
995
|
+
|
|
996
|
+
Example:
|
|
997
|
+
mostra daemon restart
|
|
998
|
+
```
|
|
999
|
+
|
|
1000
|
+
## mostra daemon status
|
|
1001
|
+
|
|
1002
|
+
```text
|
|
1003
|
+
Whether the home's daemon runs, when it would exit for lack of work, and its login service.
|
|
1004
|
+
|
|
1005
|
+
Usage:
|
|
1006
|
+
mostra daemon status
|
|
1007
|
+
|
|
1008
|
+
Global flags:
|
|
1009
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1010
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1011
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1012
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
1013
|
+
--help Show this command's help; with --json, its definition.
|
|
1014
|
+
|
|
1015
|
+
Output: DaemonStatus (mostra docs cli)
|
|
1016
|
+
|
|
1017
|
+
Exit codes:
|
|
1018
|
+
0 success
|
|
1019
|
+
2 usage error
|
|
1020
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1021
|
+
4 timeout (--timeout passed)
|
|
1022
|
+
|
|
1023
|
+
Example:
|
|
1024
|
+
mostra daemon status
|
|
1025
|
+
```
|
|
1026
|
+
|
|
1027
|
+
## mostra daemon install
|
|
1028
|
+
|
|
1029
|
+
```text
|
|
1030
|
+
Run the home's daemon as a login service (launchd, systemd or Task Scheduler), so links answer at any hour.
|
|
1031
|
+
|
|
1032
|
+
Usage:
|
|
1033
|
+
mostra daemon install [flags]
|
|
1034
|
+
|
|
1035
|
+
Flags:
|
|
1036
|
+
--no-start Write or remove the service's definition without asking launchd, systemd or Task Scheduler to load it.
|
|
1037
|
+
|
|
1038
|
+
Global flags:
|
|
1039
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1040
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1041
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1042
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
1043
|
+
--help Show this command's help; with --json, its definition.
|
|
1044
|
+
|
|
1045
|
+
Output: ServiceStatus (mostra docs cli)
|
|
1046
|
+
|
|
1047
|
+
Exit codes:
|
|
1048
|
+
0 success
|
|
1049
|
+
2 usage error
|
|
1050
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1051
|
+
4 timeout (--timeout passed)
|
|
1052
|
+
|
|
1053
|
+
Example:
|
|
1054
|
+
mostra daemon install
|
|
1055
|
+
```
|
|
1056
|
+
|
|
1057
|
+
## mostra daemon uninstall
|
|
1058
|
+
|
|
1059
|
+
```text
|
|
1060
|
+
Remove the home's login service; the daemon then exits after 30 idle minutes.
|
|
1061
|
+
|
|
1062
|
+
Usage:
|
|
1063
|
+
mostra daemon uninstall [flags]
|
|
1064
|
+
|
|
1065
|
+
Flags:
|
|
1066
|
+
--no-start Write or remove the service's definition without asking launchd, systemd or Task Scheduler to load it.
|
|
1067
|
+
|
|
1068
|
+
Global flags:
|
|
1069
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1070
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1071
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1072
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
1073
|
+
--help Show this command's help; with --json, its definition.
|
|
1074
|
+
|
|
1075
|
+
Output: ServiceStatus (mostra docs cli)
|
|
1076
|
+
|
|
1077
|
+
Exit codes:
|
|
1078
|
+
0 success
|
|
1079
|
+
2 usage error
|
|
1080
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1081
|
+
4 timeout (--timeout passed)
|
|
1082
|
+
|
|
1083
|
+
Example:
|
|
1084
|
+
mostra daemon uninstall
|
|
1085
|
+
```
|
|
1086
|
+
|
|
1087
|
+
## mostra host
|
|
1088
|
+
|
|
1089
|
+
```text
|
|
1090
|
+
Speak the host protocol on stdin and stdout, for a host that spawns Mostra; it sends no telemetry.
|
|
1091
|
+
|
|
1092
|
+
Usage:
|
|
1093
|
+
mostra host [flags]
|
|
1094
|
+
|
|
1095
|
+
Flags:
|
|
1096
|
+
--bind <address> Serve viewers on this address instead of 127.0.0.1.
|
|
1097
|
+
--url-host <name> The host name links use; a wildcard --bind needs it.
|
|
1098
|
+
|
|
1099
|
+
Global flags:
|
|
1100
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1101
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1102
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1103
|
+
--help Show this command's help; with --json, its definition.
|
|
1104
|
+
|
|
1105
|
+
Output: the host protocol (INTERFACES §6) (mostra docs cli)
|
|
1106
|
+
|
|
1107
|
+
Exit codes:
|
|
1108
|
+
0 success
|
|
1109
|
+
2 usage error
|
|
1110
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1111
|
+
|
|
1112
|
+
Example:
|
|
1113
|
+
mostra host --home ~/.my-host/mostra
|
|
1114
|
+
```
|
|
1115
|
+
|
|
1116
|
+
## mostra mcp
|
|
1117
|
+
|
|
1118
|
+
```text
|
|
1119
|
+
Run Mostra's MCP server, so an MCP client can create, verify and publish artifacts, wait for answers and read results.
|
|
1120
|
+
|
|
1121
|
+
Usage:
|
|
1122
|
+
mostra mcp [flags]
|
|
1123
|
+
|
|
1124
|
+
Flags:
|
|
1125
|
+
--http Serve Streamable HTTP at /mcp instead of stdio; every request needs Authorization: Bearer <token>.
|
|
1126
|
+
--port <port> With --http, the port; default one the system picks.
|
|
1127
|
+
--bind <address> With --http, listen on this address instead of 127.0.0.1.
|
|
1128
|
+
--url-host <name> With --http, the host name clients use; a wildcard --bind needs it.
|
|
1129
|
+
--workspace <dir> Where relative artifact directories and new artifacts go. Default: MOSTRA_MCP_WORKSPACE, else ~/mostra-artifacts.
|
|
1130
|
+
--embedded This server runs on someone's behalf (a harness plugin or another host started it), so it sends no telemetry.
|
|
1131
|
+
|
|
1132
|
+
Global flags:
|
|
1133
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1134
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1135
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1136
|
+
--help Show this command's help; with --json, its definition.
|
|
1137
|
+
|
|
1138
|
+
Output: the MCP protocol on stdin and stdout, or over HTTP (mostra docs cli)
|
|
1139
|
+
|
|
1140
|
+
Exit codes:
|
|
1141
|
+
0 success
|
|
1142
|
+
2 usage error
|
|
1143
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1144
|
+
|
|
1145
|
+
Example:
|
|
1146
|
+
mostra mcp
|
|
1147
|
+
```
|
|
1148
|
+
|
|
1149
|
+
## mostra docs
|
|
1150
|
+
|
|
1151
|
+
```text
|
|
1152
|
+
Print Mostra's reference: the guide to writing artifacts, the CLI, telemetry, and every diagnostic code's page.
|
|
1153
|
+
|
|
1154
|
+
Usage:
|
|
1155
|
+
mostra docs [<topic>]
|
|
1156
|
+
|
|
1157
|
+
Arguments:
|
|
1158
|
+
<topic> A topic or a diagnostic code. Default: the index.
|
|
1159
|
+
|
|
1160
|
+
Global flags:
|
|
1161
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1162
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1163
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1164
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
1165
|
+
--help Show this command's help; with --json, its definition.
|
|
1166
|
+
|
|
1167
|
+
Output: DocsPage (mostra docs cli)
|
|
1168
|
+
|
|
1169
|
+
Exit codes:
|
|
1170
|
+
0 success
|
|
1171
|
+
2 usage error
|
|
1172
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1173
|
+
4 timeout (--timeout passed)
|
|
1174
|
+
|
|
1175
|
+
Example:
|
|
1176
|
+
mostra docs MOSTRA_DEP_MISSING
|
|
1177
|
+
```
|
|
1178
|
+
|
|
1179
|
+
## mostra doctor
|
|
1180
|
+
|
|
1181
|
+
```text
|
|
1182
|
+
Check the platform, the runtime, the home, its daemon and ledger, and the login service.
|
|
1183
|
+
|
|
1184
|
+
Usage:
|
|
1185
|
+
mostra doctor [flags]
|
|
1186
|
+
|
|
1187
|
+
Flags:
|
|
1188
|
+
--deep Also hash every version against its recorded output digest.
|
|
1189
|
+
|
|
1190
|
+
Global flags:
|
|
1191
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1192
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1193
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1194
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
1195
|
+
--help Show this command's help; with --json, its definition.
|
|
1196
|
+
|
|
1197
|
+
Output: DoctorResult (mostra docs cli)
|
|
1198
|
+
|
|
1199
|
+
Exit codes:
|
|
1200
|
+
0 success
|
|
1201
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
1202
|
+
2 usage error
|
|
1203
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1204
|
+
4 timeout (--timeout passed)
|
|
1205
|
+
|
|
1206
|
+
Example:
|
|
1207
|
+
mostra doctor
|
|
1208
|
+
```
|
|
1209
|
+
|
|
1210
|
+
## mostra gc
|
|
1211
|
+
|
|
1212
|
+
```text
|
|
1213
|
+
Remove what nothing references: unreferenced versions' files, unused packages and caches.
|
|
1214
|
+
|
|
1215
|
+
Usage:
|
|
1216
|
+
mostra gc [flags]
|
|
1217
|
+
|
|
1218
|
+
Flags:
|
|
1219
|
+
--dry-run List what a run would remove, and remove nothing.
|
|
1220
|
+
--compact-events Also replace events before --before with one summary per artifact.
|
|
1221
|
+
--before <cursor> The cursor --compact-events compacts before.
|
|
1222
|
+
|
|
1223
|
+
Global flags:
|
|
1224
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1225
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1226
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1227
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
1228
|
+
--help Show this command's help; with --json, its definition.
|
|
1229
|
+
|
|
1230
|
+
Output: GcRunResult (mostra docs cli)
|
|
1231
|
+
|
|
1232
|
+
Exit codes:
|
|
1233
|
+
0 success
|
|
1234
|
+
1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
|
|
1235
|
+
2 usage error
|
|
1236
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1237
|
+
4 timeout (--timeout passed)
|
|
1238
|
+
|
|
1239
|
+
Example:
|
|
1240
|
+
mostra gc --dry-run
|
|
1241
|
+
```
|
|
1242
|
+
|
|
1243
|
+
## mostra telemetry status
|
|
1244
|
+
|
|
1245
|
+
```text
|
|
1246
|
+
Whether the CLI sends anonymous usage data, and why.
|
|
1247
|
+
|
|
1248
|
+
Usage:
|
|
1249
|
+
mostra telemetry status
|
|
1250
|
+
|
|
1251
|
+
Global flags:
|
|
1252
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1253
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1254
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1255
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
1256
|
+
--help Show this command's help; with --json, its definition.
|
|
1257
|
+
|
|
1258
|
+
Output: TelemetryStatus (mostra docs telemetry)
|
|
1259
|
+
|
|
1260
|
+
Exit codes:
|
|
1261
|
+
0 success
|
|
1262
|
+
2 usage error
|
|
1263
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1264
|
+
4 timeout (--timeout passed)
|
|
1265
|
+
|
|
1266
|
+
Example:
|
|
1267
|
+
mostra telemetry status
|
|
1268
|
+
```
|
|
1269
|
+
|
|
1270
|
+
## mostra telemetry on
|
|
1271
|
+
|
|
1272
|
+
```text
|
|
1273
|
+
Send anonymous usage data from this CLI; the notice says what it contains.
|
|
1274
|
+
|
|
1275
|
+
Usage:
|
|
1276
|
+
mostra telemetry on
|
|
1277
|
+
|
|
1278
|
+
Global flags:
|
|
1279
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1280
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1281
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1282
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
1283
|
+
--help Show this command's help; with --json, its definition.
|
|
1284
|
+
|
|
1285
|
+
Output: TelemetryStatus (mostra docs telemetry)
|
|
1286
|
+
|
|
1287
|
+
Exit codes:
|
|
1288
|
+
0 success
|
|
1289
|
+
2 usage error
|
|
1290
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1291
|
+
4 timeout (--timeout passed)
|
|
1292
|
+
|
|
1293
|
+
Example:
|
|
1294
|
+
mostra telemetry on
|
|
1295
|
+
```
|
|
1296
|
+
|
|
1297
|
+
## mostra telemetry off
|
|
1298
|
+
|
|
1299
|
+
```text
|
|
1300
|
+
Stop sending usage data, and delete the install ID and any unsent events.
|
|
1301
|
+
|
|
1302
|
+
Usage:
|
|
1303
|
+
mostra telemetry off
|
|
1304
|
+
|
|
1305
|
+
Global flags:
|
|
1306
|
+
--json Print one JSON envelope on stdout (NDJSON for streams).
|
|
1307
|
+
--home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
|
|
1308
|
+
--cwd <dir> Resolve relative paths from this directory.
|
|
1309
|
+
--timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
|
|
1310
|
+
--help Show this command's help; with --json, its definition.
|
|
1311
|
+
|
|
1312
|
+
Output: TelemetryStatus (mostra docs telemetry)
|
|
1313
|
+
|
|
1314
|
+
Exit codes:
|
|
1315
|
+
0 success
|
|
1316
|
+
2 usage error
|
|
1317
|
+
3 environment error (no runtime, browser or socket; the home; an unsupported platform)
|
|
1318
|
+
4 timeout (--timeout passed)
|
|
1319
|
+
|
|
1320
|
+
Example:
|
|
1321
|
+
mostra telemetry off
|
|
1322
|
+
```
|