@mostra/cli 0.0.0-stage → 0.1.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 (195) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +18 -2
  3. package/dist/bin.d.ts +1 -0
  4. package/dist/bin.js +79 -0
  5. package/dist/bin.js.map +1 -0
  6. package/dist/bootstrap-DfEe_yPr.js +113 -0
  7. package/dist/bootstrap-DfEe_yPr.js.map +1 -0
  8. package/dist/exit-CBIf8nAU.js +79 -0
  9. package/dist/exit-CBIf8nAU.js.map +1 -0
  10. package/dist/flush-BCuWs0Zh.js +718 -0
  11. package/dist/flush-BCuWs0Zh.js.map +1 -0
  12. package/dist/index.d.ts +230 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +3 -0
  15. package/dist/reference/cli.md +977 -0
  16. package/dist/reference/diagnostics.json +1255 -0
  17. package/dist/reference/errors/MOSTRA_A11Y_MINOR.md +23 -0
  18. package/dist/reference/errors/MOSTRA_A11Y_SERIOUS.md +23 -0
  19. package/dist/reference/errors/MOSTRA_ACTION_CANCELLED.md +23 -0
  20. package/dist/reference/errors/MOSTRA_ACTION_EVENT_INVALID.md +23 -0
  21. package/dist/reference/errors/MOSTRA_ACTION_EXPORT_INVALID.md +23 -0
  22. package/dist/reference/errors/MOSTRA_ACTION_INTERRUPTED.md +23 -0
  23. package/dist/reference/errors/MOSTRA_ACTION_RUN_NOT_FOUND.md +23 -0
  24. package/dist/reference/errors/MOSTRA_ACTION_THREW.md +23 -0
  25. package/dist/reference/errors/MOSTRA_ACTION_TOO_LARGE.md +23 -0
  26. package/dist/reference/errors/MOSTRA_ACTION_UNKNOWN_FUNCTION.md +23 -0
  27. package/dist/reference/errors/MOSTRA_ACTION_UNSERIALIZABLE.md +23 -0
  28. package/dist/reference/errors/MOSTRA_ARTIFACT_DIR_NOT_EMPTY.md +23 -0
  29. package/dist/reference/errors/MOSTRA_ARTIFACT_ENTRY_AMBIGUOUS.md +23 -0
  30. package/dist/reference/errors/MOSTRA_ARTIFACT_NOT_FOUND.md +23 -0
  31. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_ENTRY.md +23 -0
  32. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_PAGE.md +23 -0
  33. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_MISSING.md +23 -0
  34. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_UNREADABLE.md +23 -0
  35. package/dist/reference/errors/MOSTRA_ARTIFACT_TEMPLATE_UNKNOWN.md +23 -0
  36. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_COLLECTED.md +23 -0
  37. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_NOT_FOUND.md +23 -0
  38. package/dist/reference/errors/MOSTRA_BUILD_CRASHED.md +23 -0
  39. package/dist/reference/errors/MOSTRA_BUILD_FAILED.md +23 -0
  40. package/dist/reference/errors/MOSTRA_BUILD_TIMEOUT.md +23 -0
  41. package/dist/reference/errors/MOSTRA_BUILD_UNRESOLVED.md +23 -0
  42. package/dist/reference/errors/MOSTRA_CLI_CONFIG_UNWRITABLE.md +23 -0
  43. package/dist/reference/errors/MOSTRA_CLI_UNKNOWN_COMMAND.md +23 -0
  44. package/dist/reference/errors/MOSTRA_CLI_USAGE.md +23 -0
  45. package/dist/reference/errors/MOSTRA_CONSOLE_ERROR.md +23 -0
  46. package/dist/reference/errors/MOSTRA_CONSOLE_WARNING.md +23 -0
  47. package/dist/reference/errors/MOSTRA_DEP_INSTALL_FAILED.md +23 -0
  48. package/dist/reference/errors/MOSTRA_DEP_MISSING.md +23 -0
  49. package/dist/reference/errors/MOSTRA_DEP_NOT_FOUND.md +23 -0
  50. package/dist/reference/errors/MOSTRA_DEP_OFFLINE.md +23 -0
  51. package/dist/reference/errors/MOSTRA_DEP_SPEC_INVALID.md +23 -0
  52. package/dist/reference/errors/MOSTRA_DEP_TIMEOUT.md +23 -0
  53. package/dist/reference/errors/MOSTRA_DEP_WARM_CONFLICT.md +23 -0
  54. package/dist/reference/errors/MOSTRA_ENV_BIND_FAILED.md +23 -0
  55. package/dist/reference/errors/MOSTRA_ENV_BROWSER_MISSING.md +23 -0
  56. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED.md +23 -0
  57. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_INVALID.md +23 -0
  58. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_UNAVAILABLE.md +23 -0
  59. package/dist/reference/errors/MOSTRA_ENV_NODE_UNSUPPORTED.md +23 -0
  60. package/dist/reference/errors/MOSTRA_ENV_PORT_TAKEN.md +23 -0
  61. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_MISSING.md +23 -0
  62. package/dist/reference/errors/MOSTRA_ENV_SERVICE_FAILED.md +23 -0
  63. package/dist/reference/errors/MOSTRA_ENV_SHELL_MISSING.md +23 -0
  64. package/dist/reference/errors/MOSTRA_ENV_WARM_MISSING.md +23 -0
  65. package/dist/reference/errors/MOSTRA_FIELD_CONFLICT.md +23 -0
  66. package/dist/reference/errors/MOSTRA_FIELD_DUPLICATE_ID.md +23 -0
  67. package/dist/reference/errors/MOSTRA_FIELD_ID_INVALID.md +23 -0
  68. package/dist/reference/errors/MOSTRA_FIELD_ID_UNSTABLE.md +23 -0
  69. package/dist/reference/errors/MOSTRA_FIELD_MUTATION_ID_REUSED.md +23 -0
  70. package/dist/reference/errors/MOSTRA_FIELD_SHARED.md +23 -0
  71. package/dist/reference/errors/MOSTRA_FIELD_TOO_LARGE.md +23 -0
  72. package/dist/reference/errors/MOSTRA_FIELD_UNBOUND.md +23 -0
  73. package/dist/reference/errors/MOSTRA_HOME_DISK_FULL.md +23 -0
  74. package/dist/reference/errors/MOSTRA_HOME_GC_INCOMPLETE.md +23 -0
  75. package/dist/reference/errors/MOSTRA_HOME_GONE.md +23 -0
  76. package/dist/reference/errors/MOSTRA_HOME_INTEGRITY.md +23 -0
  77. package/dist/reference/errors/MOSTRA_HOME_LEDGER_UNREADABLE.md +23 -0
  78. package/dist/reference/errors/MOSTRA_HOME_LOCKED.md +23 -0
  79. package/dist/reference/errors/MOSTRA_HOME_MISMATCH.md +23 -0
  80. package/dist/reference/errors/MOSTRA_HOME_NOT_ALWAYS_ON.md +23 -0
  81. package/dist/reference/errors/MOSTRA_HOME_NOT_OWNED.md +23 -0
  82. package/dist/reference/errors/MOSTRA_HOME_SOCKET_TOO_LONG.md +23 -0
  83. package/dist/reference/errors/MOSTRA_HOME_TOO_NEW.md +23 -0
  84. package/dist/reference/errors/MOSTRA_HOST_CONNECTION_CLOSED.md +23 -0
  85. package/dist/reference/errors/MOSTRA_HOST_CURSOR_COMPACTED.md +23 -0
  86. package/dist/reference/errors/MOSTRA_HOST_INITIALIZE_ORDER.md +23 -0
  87. package/dist/reference/errors/MOSTRA_HOST_INTERNAL_ERROR.md +23 -0
  88. package/dist/reference/errors/MOSTRA_HOST_INVALID_PARAMS.md +23 -0
  89. package/dist/reference/errors/MOSTRA_HOST_MALFORMED.md +23 -0
  90. package/dist/reference/errors/MOSTRA_HOST_MESSAGE_TOO_LARGE.md +23 -0
  91. package/dist/reference/errors/MOSTRA_HOST_METHOD_UNKNOWN.md +23 -0
  92. package/dist/reference/errors/MOSTRA_HOST_NOTIFICATION_UNSUPPORTED.md +23 -0
  93. package/dist/reference/errors/MOSTRA_HOST_PORT_UNSUPPORTED.md +23 -0
  94. package/dist/reference/errors/MOSTRA_HOST_REQUEST_ID_REUSED.md +23 -0
  95. package/dist/reference/errors/MOSTRA_HOST_REVISION_UNSUPPORTED.md +23 -0
  96. package/dist/reference/errors/MOSTRA_HOST_SHUTDOWN_REFUSED.md +23 -0
  97. package/dist/reference/errors/MOSTRA_HOST_SUBSCRIPTION_UNKNOWN.md +23 -0
  98. package/dist/reference/errors/MOSTRA_HOST_TIMEOUT.md +23 -0
  99. package/dist/reference/errors/MOSTRA_HYGIENE_CONTENT_TYPE.md +23 -0
  100. package/dist/reference/errors/MOSTRA_HYGIENE_CSRF_MISSING.md +23 -0
  101. package/dist/reference/errors/MOSTRA_HYGIENE_HEADERS_TOO_LARGE.md +23 -0
  102. package/dist/reference/errors/MOSTRA_HYGIENE_HOST_REFUSED.md +23 -0
  103. package/dist/reference/errors/MOSTRA_HYGIENE_NOT_SERVED.md +23 -0
  104. package/dist/reference/errors/MOSTRA_HYGIENE_ORIGIN_REFUSED.md +23 -0
  105. package/dist/reference/errors/MOSTRA_HYGIENE_RATE_LIMITED.md +23 -0
  106. package/dist/reference/errors/MOSTRA_HYGIENE_REQUEST_MALFORMED.md +23 -0
  107. package/dist/reference/errors/MOSTRA_HYGIENE_SCOPE_DENIED.md +23 -0
  108. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_CONFLICT.md +23 -0
  109. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_MISSING.md +23 -0
  110. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_INVALID.md +23 -0
  111. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_REVOKED.md +23 -0
  112. package/dist/reference/errors/MOSTRA_LIVE_SOURCE_FAILED.md +23 -0
  113. package/dist/reference/errors/MOSTRA_LIVE_TOO_LARGE.md +23 -0
  114. package/dist/reference/errors/MOSTRA_MANIFEST_INVALID.md +23 -0
  115. package/dist/reference/errors/MOSTRA_MANIFEST_NOT_LITERAL.md +23 -0
  116. package/dist/reference/errors/MOSTRA_MANIFEST_UNKNOWN_KEY.md +23 -0
  117. package/dist/reference/errors/MOSTRA_NETWORK_EXTERNAL_FAILED.md +23 -0
  118. package/dist/reference/errors/MOSTRA_NETWORK_REQUEST_FAILED.md +23 -0
  119. package/dist/reference/errors/MOSTRA_PLATFORM_UNSUPPORTED.md +23 -0
  120. package/dist/reference/errors/MOSTRA_PUBLISH_ID_CONFLICT.md +23 -0
  121. package/dist/reference/errors/MOSTRA_PUBLISH_SOURCE_CHANGED.md +23 -0
  122. package/dist/reference/errors/MOSTRA_PUBLISH_VERIFY_FAILED.md +23 -0
  123. package/dist/reference/errors/MOSTRA_REGRESSION_ACTION_REMOVED.md +23 -0
  124. package/dist/reference/errors/MOSTRA_REGRESSION_ARIA.md +23 -0
  125. package/dist/reference/errors/MOSTRA_REGRESSION_FIELD_REMOVED.md +23 -0
  126. package/dist/reference/errors/MOSTRA_REGRESSION_LIVE_REMOVED.md +23 -0
  127. package/dist/reference/errors/MOSTRA_REGRESSION_PAGE_REMOVED.md +23 -0
  128. package/dist/reference/errors/MOSTRA_REGRESSION_PIXELS.md +23 -0
  129. package/dist/reference/errors/MOSTRA_RUNTIME_BLANK.md +23 -0
  130. package/dist/reference/errors/MOSTRA_RUNTIME_NOT_READY.md +23 -0
  131. package/dist/reference/errors/MOSTRA_RUNTIME_PAGE_ERROR.md +23 -0
  132. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_CRASHED.md +23 -0
  133. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_PARKED.md +23 -0
  134. package/dist/reference/errors/MOSTRA_SECRET_MISSING.md +23 -0
  135. package/dist/reference/errors/MOSTRA_SMOKE_BUDGET.md +23 -0
  136. package/dist/reference/errors/MOSTRA_SMOKE_NO_EFFECT.md +23 -0
  137. package/dist/reference/errors/MOSTRA_SUBMIT_ALREADY.md +23 -0
  138. package/dist/reference/errors/MOSTRA_SUBMIT_BLOCKED.md +23 -0
  139. package/dist/reference/errors/MOSTRA_SUBMIT_CHANNEL_DENIED.md +23 -0
  140. package/dist/reference/errors/MOSTRA_SUBMIT_NOT_FOUND.md +23 -0
  141. package/dist/reference/errors/MOSTRA_SUBMIT_POLICY_NONE.md +23 -0
  142. package/dist/reference/errors/MOSTRA_SUBMIT_REVISION_MOVED.md +23 -0
  143. package/dist/reference/errors/MOSTRA_SUBMIT_SIGNAL_INVALID.md +23 -0
  144. package/dist/reference/errors/MOSTRA_SUBMIT_VIEW_INVALID.md +23 -0
  145. package/dist/reference/errors/MOSTRA_TARGET_UNAVAILABLE.md +23 -0
  146. package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
  147. package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
  148. package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
  149. package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
  150. package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
  151. package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
  152. package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
  153. package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
  154. package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
  155. package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
  156. package/dist/reference/telemetry.md +82 -0
  157. package/dist/run-D1gRM6Bm.js +2 -0
  158. package/dist/run-Du266XjI.js +3824 -0
  159. package/dist/run-Du266XjI.js.map +1 -0
  160. package/dist/telemetry/flush-main.d.ts +1 -0
  161. package/dist/telemetry/flush-main.js +14 -0
  162. package/dist/telemetry/flush-main.js.map +1 -0
  163. package/package.json +62 -3
  164. package/src/bin.ts +70 -0
  165. package/src/bootstrap.ts +156 -0
  166. package/src/browser.ts +186 -0
  167. package/src/client.ts +313 -0
  168. package/src/command.ts +147 -0
  169. package/src/commands/admin.ts +791 -0
  170. package/src/commands/authoring.ts +244 -0
  171. package/src/commands/dev.ts +106 -0
  172. package/src/commands/index.ts +71 -0
  173. package/src/commands/interaction.ts +288 -0
  174. package/src/commands/shared.ts +71 -0
  175. package/src/commands/viewing.ts +153 -0
  176. package/src/docs.ts +111 -0
  177. package/src/exit.ts +89 -0
  178. package/src/help.ts +170 -0
  179. package/src/home.ts +111 -0
  180. package/src/index.ts +23 -0
  181. package/src/node-gate.ts +15 -0
  182. package/src/parse.ts +246 -0
  183. package/src/run.ts +387 -0
  184. package/src/telemetry/decision.ts +101 -0
  185. package/src/telemetry/events.ts +147 -0
  186. package/src/telemetry/flush-main.ts +13 -0
  187. package/src/telemetry/flush.ts +143 -0
  188. package/src/telemetry/harness.ts +39 -0
  189. package/src/telemetry/index.ts +318 -0
  190. package/src/telemetry/store.ts +379 -0
  191. package/src/telemetry/timezone.ts +72 -0
  192. package/src/telemetry/words.ts +87 -0
  193. package/src/telemetry/zone-sets.ts +182 -0
  194. package/src/telemetry/zones.generated.ts +720 -0
  195. package/src/version.ts +43 -0
package/src/version.ts ADDED
@@ -0,0 +1,43 @@
1
+ /** The CLI's own package: its root directory and its release. */
2
+ import { readFileSync } from "node:fs";
3
+ import { dirname, join } from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+
6
+ let found: { readonly root: string; readonly version: string } | undefined;
7
+
8
+ function own(): { readonly root: string; readonly version: string } {
9
+ if (found) return found;
10
+ let dir = dirname(fileURLToPath(import.meta.url));
11
+ for (;;) {
12
+ try {
13
+ const manifest = JSON.parse(readFileSync(join(dir, "package.json"), "utf8")) as {
14
+ name?: string;
15
+ version?: string;
16
+ };
17
+ if (manifest.name === "@mostra/cli" && manifest.version) {
18
+ found = { root: dir, version: manifest.version };
19
+ return found;
20
+ }
21
+ } catch {
22
+ // Keep looking upwards.
23
+ }
24
+ const parent = dirname(dir);
25
+ if (parent === dir) throw new Error("Couldn't find @mostra/cli's package.json.");
26
+ dir = parent;
27
+ }
28
+ }
29
+
30
+ /** This CLI's version (`mostra --version`, the client version it reports, telemetry's `version`). */
31
+ export function cliVersion(): string {
32
+ return own().version;
33
+ }
34
+
35
+ /** The CLI package's directory: its `dist/`, `src/` and bundled reference live under it. */
36
+ export function packageRoot(): string {
37
+ return own().root;
38
+ }
39
+
40
+ /** Whether this CLI runs from its TypeScript sources (tests), not its build. */
41
+ export function fromSource(): boolean {
42
+ return import.meta.url.endsWith(".ts");
43
+ }