@mostra/runtime 0.9.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.
Files changed (279) hide show
  1. package/dist/bin.js +6628 -9
  2. package/dist/bin.js.map +1 -1
  3. package/dist/builder/child/main.js +2 -2
  4. package/dist/{child-Chiavhdx.js → child-BmNZ4a70.js} +2 -2
  5. package/dist/{child-Chiavhdx.js.map → child-BmNZ4a70.js.map} +1 -1
  6. package/dist/deps/child/install.js +1 -1
  7. package/dist/{directories-mJ1qlVht.js → directories-BLJjeSPD.js} +5 -5
  8. package/dist/directories-BLJjeSPD.js.map +1 -0
  9. package/dist/{files-FygSJIzK.js → files-DGeWuE4I.js} +2 -2
  10. package/dist/{files-FygSJIzK.js.map → files-DGeWuE4I.js.map} +1 -1
  11. package/dist/index.d.ts +2 -0
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.js +2 -2
  14. package/dist/{instance-EnaZPs14.js → instance-DCiUHvgZ.js} +3835 -255
  15. package/dist/instance-DCiUHvgZ.js.map +1 -0
  16. package/dist/reference/cli.md +1322 -0
  17. package/dist/reference/diagnostics.json +1552 -0
  18. package/dist/reference/errors/MOSTRA_A11Y_MINOR.md +23 -0
  19. package/dist/reference/errors/MOSTRA_A11Y_SERIOUS.md +23 -0
  20. package/dist/reference/errors/MOSTRA_ACTION_CANCELLED.md +23 -0
  21. package/dist/reference/errors/MOSTRA_ACTION_EVENT_INVALID.md +23 -0
  22. package/dist/reference/errors/MOSTRA_ACTION_EXPORT_INVALID.md +23 -0
  23. package/dist/reference/errors/MOSTRA_ACTION_INTERRUPTED.md +23 -0
  24. package/dist/reference/errors/MOSTRA_ACTION_PAUSED.md +23 -0
  25. package/dist/reference/errors/MOSTRA_ACTION_RUN_NOT_FOUND.md +23 -0
  26. package/dist/reference/errors/MOSTRA_ACTION_THREW.md +23 -0
  27. package/dist/reference/errors/MOSTRA_ACTION_TOO_LARGE.md +23 -0
  28. package/dist/reference/errors/MOSTRA_ACTION_UNKNOWN_FUNCTION.md +23 -0
  29. package/dist/reference/errors/MOSTRA_ACTION_UNSERIALIZABLE.md +23 -0
  30. package/dist/reference/errors/MOSTRA_ARTIFACT_BUNDLE_INVALID.md +23 -0
  31. package/dist/reference/errors/MOSTRA_ARTIFACT_DIR_NOT_EMPTY.md +23 -0
  32. package/dist/reference/errors/MOSTRA_ARTIFACT_ENTRY_AMBIGUOUS.md +23 -0
  33. package/dist/reference/errors/MOSTRA_ARTIFACT_ID_DROPPED.md +23 -0
  34. package/dist/reference/errors/MOSTRA_ARTIFACT_NOT_FOUND.md +23 -0
  35. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_ENTRY.md +23 -0
  36. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_PAGE.md +23 -0
  37. package/dist/reference/errors/MOSTRA_ARTIFACT_PATCH_REJECTED.md +23 -0
  38. package/dist/reference/errors/MOSTRA_ARTIFACT_PATH_INVALID.md +23 -0
  39. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_MISSING.md +23 -0
  40. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_UNREADABLE.md +23 -0
  41. package/dist/reference/errors/MOSTRA_ARTIFACT_TEMPLATE_UNKNOWN.md +23 -0
  42. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_COLLECTED.md +23 -0
  43. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_NOT_FOUND.md +23 -0
  44. package/dist/reference/errors/MOSTRA_BUILD_CRASHED.md +23 -0
  45. package/dist/reference/errors/MOSTRA_BUILD_FAILED.md +23 -0
  46. package/dist/reference/errors/MOSTRA_BUILD_TIMEOUT.md +23 -0
  47. package/dist/reference/errors/MOSTRA_BUILD_UNRESOLVED.md +23 -0
  48. package/dist/reference/errors/MOSTRA_CLI_CONFIG_UNWRITABLE.md +23 -0
  49. package/dist/reference/errors/MOSTRA_CLI_UNKNOWN_COMMAND.md +23 -0
  50. package/dist/reference/errors/MOSTRA_CLI_USAGE.md +23 -0
  51. package/dist/reference/errors/MOSTRA_CONSOLE_ERROR.md +23 -0
  52. package/dist/reference/errors/MOSTRA_CONSOLE_WARNING.md +23 -0
  53. package/dist/reference/errors/MOSTRA_DEP_INSTALL_FAILED.md +23 -0
  54. package/dist/reference/errors/MOSTRA_DEP_MISSING.md +23 -0
  55. package/dist/reference/errors/MOSTRA_DEP_NOT_FOUND.md +23 -0
  56. package/dist/reference/errors/MOSTRA_DEP_OFFLINE.md +23 -0
  57. package/dist/reference/errors/MOSTRA_DEP_SPEC_INVALID.md +23 -0
  58. package/dist/reference/errors/MOSTRA_DEP_TIMEOUT.md +23 -0
  59. package/dist/reference/errors/MOSTRA_DEP_WARM_CONFLICT.md +23 -0
  60. package/dist/reference/errors/MOSTRA_ENV_BIND_FAILED.md +23 -0
  61. package/dist/reference/errors/MOSTRA_ENV_BROWSER_MISSING.md +23 -0
  62. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED.md +23 -0
  63. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_INVALID.md +23 -0
  64. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_UNAVAILABLE.md +23 -0
  65. package/dist/reference/errors/MOSTRA_ENV_HELPER_MISSING.md +23 -0
  66. package/dist/reference/errors/MOSTRA_ENV_NODE_UNSUPPORTED.md +23 -0
  67. package/dist/reference/errors/MOSTRA_ENV_PORT_TAKEN.md +23 -0
  68. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_INSTALLING.md +23 -0
  69. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_MISSING.md +23 -0
  70. package/dist/reference/errors/MOSTRA_ENV_SERVICE_FAILED.md +23 -0
  71. package/dist/reference/errors/MOSTRA_ENV_SHELL_MISSING.md +23 -0
  72. package/dist/reference/errors/MOSTRA_ENV_WARM_MISSING.md +23 -0
  73. package/dist/reference/errors/MOSTRA_FIELD_CONFLICT.md +23 -0
  74. package/dist/reference/errors/MOSTRA_FIELD_DUPLICATE_ID.md +23 -0
  75. package/dist/reference/errors/MOSTRA_FIELD_ID_INVALID.md +23 -0
  76. package/dist/reference/errors/MOSTRA_FIELD_ID_UNSTABLE.md +23 -0
  77. package/dist/reference/errors/MOSTRA_FIELD_MUTATION_ID_REUSED.md +23 -0
  78. package/dist/reference/errors/MOSTRA_FIELD_SHARED.md +23 -0
  79. package/dist/reference/errors/MOSTRA_FIELD_TOO_LARGE.md +23 -0
  80. package/dist/reference/errors/MOSTRA_FIELD_UNBOUND.md +23 -0
  81. package/dist/reference/errors/MOSTRA_HOME_DISK_FULL.md +23 -0
  82. package/dist/reference/errors/MOSTRA_HOME_GC_INCOMPLETE.md +23 -0
  83. package/dist/reference/errors/MOSTRA_HOME_GONE.md +23 -0
  84. package/dist/reference/errors/MOSTRA_HOME_INTEGRITY.md +23 -0
  85. package/dist/reference/errors/MOSTRA_HOME_LEDGER_UNREADABLE.md +23 -0
  86. package/dist/reference/errors/MOSTRA_HOME_LOCKED.md +23 -0
  87. package/dist/reference/errors/MOSTRA_HOME_MISMATCH.md +23 -0
  88. package/dist/reference/errors/MOSTRA_HOME_NETWORK_FILESYSTEM.md +23 -0
  89. package/dist/reference/errors/MOSTRA_HOME_NOT_ALWAYS_ON.md +23 -0
  90. package/dist/reference/errors/MOSTRA_HOME_NOT_OWNED.md +23 -0
  91. package/dist/reference/errors/MOSTRA_HOME_SOCKET_TOO_LONG.md +23 -0
  92. package/dist/reference/errors/MOSTRA_HOME_TOO_NEW.md +23 -0
  93. package/dist/reference/errors/MOSTRA_HOST_CONNECTION_CLOSED.md +23 -0
  94. package/dist/reference/errors/MOSTRA_HOST_CURSOR_COMPACTED.md +23 -0
  95. package/dist/reference/errors/MOSTRA_HOST_IDENTITY_UNAVAILABLE.md +23 -0
  96. package/dist/reference/errors/MOSTRA_HOST_INITIALIZE_ORDER.md +23 -0
  97. package/dist/reference/errors/MOSTRA_HOST_INTERNAL_ERROR.md +23 -0
  98. package/dist/reference/errors/MOSTRA_HOST_INVALID_PARAMS.md +23 -0
  99. package/dist/reference/errors/MOSTRA_HOST_MALFORMED.md +23 -0
  100. package/dist/reference/errors/MOSTRA_HOST_MESSAGE_TOO_LARGE.md +23 -0
  101. package/dist/reference/errors/MOSTRA_HOST_METHOD_UNKNOWN.md +23 -0
  102. package/dist/reference/errors/MOSTRA_HOST_NOTIFICATION_UNSUPPORTED.md +23 -0
  103. package/dist/reference/errors/MOSTRA_HOST_PORT_UNSUPPORTED.md +23 -0
  104. package/dist/reference/errors/MOSTRA_HOST_REQUEST_ID_REUSED.md +23 -0
  105. package/dist/reference/errors/MOSTRA_HOST_REVISION_UNSUPPORTED.md +23 -0
  106. package/dist/reference/errors/MOSTRA_HOST_SHUTDOWN_REFUSED.md +23 -0
  107. package/dist/reference/errors/MOSTRA_HOST_SUBSCRIPTION_UNKNOWN.md +23 -0
  108. package/dist/reference/errors/MOSTRA_HOST_TIMEOUT.md +23 -0
  109. package/dist/reference/errors/MOSTRA_HYGIENE_CONTENT_TYPE.md +23 -0
  110. package/dist/reference/errors/MOSTRA_HYGIENE_CSRF_MISSING.md +23 -0
  111. package/dist/reference/errors/MOSTRA_HYGIENE_FRAME_SESSION.md +23 -0
  112. package/dist/reference/errors/MOSTRA_HYGIENE_HEADERS_TOO_LARGE.md +23 -0
  113. package/dist/reference/errors/MOSTRA_HYGIENE_HOST_REFUSED.md +23 -0
  114. package/dist/reference/errors/MOSTRA_HYGIENE_NOT_SERVED.md +23 -0
  115. package/dist/reference/errors/MOSTRA_HYGIENE_ORIGIN_REFUSED.md +23 -0
  116. package/dist/reference/errors/MOSTRA_HYGIENE_RATE_LIMITED.md +23 -0
  117. package/dist/reference/errors/MOSTRA_HYGIENE_REQUEST_MALFORMED.md +23 -0
  118. package/dist/reference/errors/MOSTRA_HYGIENE_SCOPE_DENIED.md +23 -0
  119. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_CONFLICT.md +23 -0
  120. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_MISSING.md +23 -0
  121. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_INVALID.md +23 -0
  122. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_REVOKED.md +23 -0
  123. package/dist/reference/errors/MOSTRA_LIVE_SOURCE_FAILED.md +23 -0
  124. package/dist/reference/errors/MOSTRA_LIVE_TOO_LARGE.md +23 -0
  125. package/dist/reference/errors/MOSTRA_MANIFEST_INVALID.md +23 -0
  126. package/dist/reference/errors/MOSTRA_MANIFEST_NOT_LITERAL.md +23 -0
  127. package/dist/reference/errors/MOSTRA_MANIFEST_UNKNOWN_KEY.md +23 -0
  128. package/dist/reference/errors/MOSTRA_NETWORK_EXTERNAL_FAILED.md +23 -0
  129. package/dist/reference/errors/MOSTRA_NETWORK_REQUEST_FAILED.md +23 -0
  130. package/dist/reference/errors/MOSTRA_PLATFORM_UNSUPPORTED.md +23 -0
  131. package/dist/reference/errors/MOSTRA_PUBLISH_ID_CONFLICT.md +23 -0
  132. package/dist/reference/errors/MOSTRA_PUBLISH_SOURCE_CHANGED.md +23 -0
  133. package/dist/reference/errors/MOSTRA_PUBLISH_VERIFY_FAILED.md +23 -0
  134. package/dist/reference/errors/MOSTRA_REGRESSION_ACTION_REMOVED.md +23 -0
  135. package/dist/reference/errors/MOSTRA_REGRESSION_ARIA.md +23 -0
  136. package/dist/reference/errors/MOSTRA_REGRESSION_FIELD_REMOVED.md +23 -0
  137. package/dist/reference/errors/MOSTRA_REGRESSION_LIVE_REMOVED.md +23 -0
  138. package/dist/reference/errors/MOSTRA_REGRESSION_PAGE_REMOVED.md +23 -0
  139. package/dist/reference/errors/MOSTRA_REGRESSION_PIXELS.md +23 -0
  140. package/dist/reference/errors/MOSTRA_REMOTE_CONFIG_INVALID.md +23 -0
  141. package/dist/reference/errors/MOSTRA_REMOTE_HOME_MOVING.md +23 -0
  142. package/dist/reference/errors/MOSTRA_REMOTE_HOME_SUSPENDED.md +23 -0
  143. package/dist/reference/errors/MOSTRA_REMOTE_LIMIT_REACHED.md +23 -0
  144. package/dist/reference/errors/MOSTRA_REMOTE_LOGIN_FAILED.md +23 -0
  145. package/dist/reference/errors/MOSTRA_REMOTE_NOT_OWNER_INSTANCE.md +23 -0
  146. package/dist/reference/errors/MOSTRA_REMOTE_NO_INSTANCE.md +23 -0
  147. package/dist/reference/errors/MOSTRA_REMOTE_OPERATOR_UNAVAILABLE.md +23 -0
  148. package/dist/reference/errors/MOSTRA_REMOTE_OWNER_OFFLINE.md +23 -0
  149. package/dist/reference/errors/MOSTRA_REMOTE_PAUSED_BY_OPERATOR.md +23 -0
  150. package/dist/reference/errors/MOSTRA_REMOTE_QUEUE_FULL.md +23 -0
  151. package/dist/reference/errors/MOSTRA_REMOTE_RATE_LIMITED.md +23 -0
  152. package/dist/reference/errors/MOSTRA_REMOTE_SIGN_IN_REQUIRED.md +23 -0
  153. package/dist/reference/errors/MOSTRA_REMOTE_UNDER_REVIEW.md +23 -0
  154. package/dist/reference/errors/MOSTRA_REMOTE_UNREACHABLE.md +23 -0
  155. package/dist/reference/errors/MOSTRA_RUNTIME_BLANK.md +23 -0
  156. package/dist/reference/errors/MOSTRA_RUNTIME_NOT_READY.md +23 -0
  157. package/dist/reference/errors/MOSTRA_RUNTIME_PAGE_ERROR.md +23 -0
  158. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_CRASHED.md +23 -0
  159. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_PARKED.md +23 -0
  160. package/dist/reference/errors/MOSTRA_SECRET_MISSING.md +23 -0
  161. package/dist/reference/errors/MOSTRA_SHARE_NOT_ENABLED.md +23 -0
  162. package/dist/reference/errors/MOSTRA_SHARE_NOT_FOUND.md +23 -0
  163. package/dist/reference/errors/MOSTRA_SHARE_PORTS_EXHAUSTED.md +23 -0
  164. package/dist/reference/errors/MOSTRA_SHARE_TOOL_MISSING.md +23 -0
  165. package/dist/reference/errors/MOSTRA_SHARE_TOOL_NOT_READY.md +23 -0
  166. package/dist/reference/errors/MOSTRA_SHARE_TTL_INVALID.md +23 -0
  167. package/dist/reference/errors/MOSTRA_SHARE_TUNNEL_FAILED.md +23 -0
  168. package/dist/reference/errors/MOSTRA_SMOKE_BUDGET.md +23 -0
  169. package/dist/reference/errors/MOSTRA_SMOKE_NO_EFFECT.md +23 -0
  170. package/dist/reference/errors/MOSTRA_SUBMIT_ALREADY.md +23 -0
  171. package/dist/reference/errors/MOSTRA_SUBMIT_BLOCKED.md +23 -0
  172. package/dist/reference/errors/MOSTRA_SUBMIT_CHANNEL_DENIED.md +23 -0
  173. package/dist/reference/errors/MOSTRA_SUBMIT_NOT_FOUND.md +23 -0
  174. package/dist/reference/errors/MOSTRA_SUBMIT_PAUSED.md +23 -0
  175. package/dist/reference/errors/MOSTRA_SUBMIT_POLICY_NONE.md +23 -0
  176. package/dist/reference/errors/MOSTRA_SUBMIT_REVISION_MOVED.md +23 -0
  177. package/dist/reference/errors/MOSTRA_SUBMIT_SIGNAL_INVALID.md +23 -0
  178. package/dist/reference/errors/MOSTRA_SUBMIT_VIEW_INVALID.md +23 -0
  179. package/dist/reference/errors/MOSTRA_TARGET_UNAVAILABLE.md +23 -0
  180. package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
  181. package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
  182. package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
  183. package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
  184. package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
  185. package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
  186. package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
  187. package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
  188. package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
  189. package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
  190. package/dist/reference/self-hosting.md +130 -0
  191. package/dist/reference/telemetry.md +84 -0
  192. package/dist/skill/SKILL.md +122 -0
  193. package/dist/skill/assets/examples/dashboard/index.tsx +161 -0
  194. package/dist/skill/assets/examples/dashboard/live.ts +25 -0
  195. package/dist/skill/assets/examples/dashboard/styles.css +125 -0
  196. package/dist/skill/assets/examples/decision/index.tsx +95 -0
  197. package/dist/skill/assets/examples/decision/styles.css +125 -0
  198. package/dist/skill/assets/examples/inbox/actions.ts +23 -0
  199. package/dist/skill/assets/examples/inbox/index.tsx +109 -0
  200. package/dist/skill/assets/examples/inbox/styles.css +125 -0
  201. package/dist/skill/assets/studio.css +125 -0
  202. package/dist/skill/references/answers.md +217 -0
  203. package/dist/skill/references/design.md +154 -0
  204. package/dist/skill/references/libraries.md +167 -0
  205. package/dist/skill/references/long-lived.md +148 -0
  206. package/dist/skill/references/mcp.md +68 -0
  207. package/dist/skill/references/page.md +131 -0
  208. package/dist/skill/references/server.md +146 -0
  209. package/dist/skill/references/sharing.md +123 -0
  210. package/dist/skill/references/verify.md +71 -0
  211. package/package.json +12 -5
  212. package/src/actions/index.ts +163 -10
  213. package/src/bin.ts +78 -1
  214. package/src/gateway/actions.ts +40 -4
  215. package/src/gateway/browser.ts +162 -95
  216. package/src/gateway/capabilities.ts +23 -6
  217. package/src/gateway/http.ts +12 -1
  218. package/src/gateway/index.ts +282 -20
  219. package/src/gateway/listener.ts +31 -6
  220. package/src/gateway/routes.ts +23 -7
  221. package/src/gc/index.ts +19 -0
  222. package/src/instance/index.ts +60 -2
  223. package/src/interaction/ephemeral.ts +32 -23
  224. package/src/interaction/events.ts +21 -1
  225. package/src/interaction/imports.ts +317 -0
  226. package/src/interaction/index.ts +228 -15
  227. package/src/interaction/outbox.ts +9 -0
  228. package/src/interaction/pause.ts +106 -0
  229. package/src/interaction/results.ts +8 -1
  230. package/src/interaction/runs.ts +52 -2
  231. package/src/interaction/submissions.ts +59 -2
  232. package/src/interaction/tally.ts +129 -0
  233. package/src/interaction/viewers.ts +34 -1
  234. package/src/ledger/index.ts +124 -10
  235. package/src/ledger/migrations.ts +234 -0
  236. package/src/ledger/types.ts +8 -0
  237. package/src/link/author.ts +215 -0
  238. package/src/link/binding.ts +289 -0
  239. package/src/link/hosted.ts +101 -0
  240. package/src/link/http.ts +141 -0
  241. package/src/link/index.ts +10 -0
  242. package/src/link/manager.ts +1489 -0
  243. package/src/link/relay.ts +512 -0
  244. package/src/live/index.ts +112 -2
  245. package/src/platform/filesystems.ts +78 -0
  246. package/src/platform/index.ts +1 -0
  247. package/src/protocol-server/client.ts +53 -0
  248. package/src/protocol-server/index.ts +19 -2
  249. package/src/protocol-server/server.ts +38 -7
  250. package/src/protocol-server/websocket.ts +161 -0
  251. package/src/publish/bundle.ts +398 -0
  252. package/src/publish/manifest.ts +9 -0
  253. package/src/publish/methods.ts +12 -1
  254. package/src/publish/publisher.ts +127 -0
  255. package/src/registry/index.ts +35 -14
  256. package/src/server/api.ts +881 -0
  257. package/src/server/auth.ts +1139 -0
  258. package/src/server/authorize.ts +816 -0
  259. package/src/server/clients.ts +235 -0
  260. package/src/server/config.ts +228 -0
  261. package/src/server/data.ts +427 -0
  262. package/src/server/directory.ts +210 -0
  263. package/src/server/feed.ts +191 -0
  264. package/src/server/handle.ts +172 -0
  265. package/src/server/hosted-pages.ts +532 -0
  266. package/src/server/hosted.ts +1323 -0
  267. package/src/server/index.ts +650 -0
  268. package/src/server/mcp.ts +330 -0
  269. package/src/server/metering.ts +156 -0
  270. package/src/server/oauth-clients.ts +510 -0
  271. package/src/server/operator.ts +498 -0
  272. package/src/server/providers.ts +284 -0
  273. package/src/server/relay.ts +1163 -0
  274. package/src/server/remove.ts +148 -0
  275. package/src/server/routing.ts +275 -0
  276. package/src/share/index.ts +110 -6
  277. package/src/verify/runner.ts +23 -2
  278. package/dist/directories-mJ1qlVht.js.map +0 -1
  279. package/dist/instance-EnaZPs14.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
+ ```