@mostra/runtime 0.14.0 → 0.15.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bin.js +1 -1
- package/dist/child-protocol-CPXR6pMu.js +13 -0
- package/dist/child-protocol-CPXR6pMu.js.map +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/{instance-CFTw3g-c.js → instance-Bw1BxctF.js} +2581 -189
- package/dist/instance-Bw1BxctF.js.map +1 -0
- package/dist/plugins/child/host.d.ts +1 -0
- package/dist/plugins/child/host.js +165 -0
- package/dist/plugins/child/host.js.map +1 -0
- package/dist/reference/cli.md +147 -5
- package/dist/reference/diagnostics.json +234 -0
- package/dist/reference/errors/MOSTRA_LICENSE_ACCEPT_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_LICENSE_MISMATCH.md +23 -0
- package/dist/reference/errors/MOSTRA_LICENSE_UNACCEPTED.md +23 -0
- package/dist/reference/errors/MOSTRA_LICENSE_UNDECLARED.md +23 -0
- package/dist/reference/errors/MOSTRA_PACK_ADDRESS_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_PACK_CSS_UNIMPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_PACK_FETCH_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_PACK_FILE_EXISTS.md +23 -0
- package/dist/reference/errors/MOSTRA_PACK_ITEM_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_PACK_ITEM_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_PACK_NOT_APPLIED.md +23 -0
- package/dist/reference/errors/MOSTRA_PACK_OFFLINE.md +23 -0
- package/dist/reference/errors/MOSTRA_PACK_TARGET_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_CONTRACT_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_ENTRY_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_EXPORTER_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_MANIFEST_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_MANIFEST_WARNING.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_NOT_A_PLUGIN.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_NOT_INSTALLED.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_OPTIONS_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_PLATFORM_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_SCOPE_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_PLUGIN_SHADOWED.md +23 -0
- package/dist/skill/SKILL.md +4 -2
- package/dist/skill/references/mcp.md +2 -2
- package/dist/skill/references/plugins.md +51 -0
- package/package.json +10 -7
- package/src/deps/index.ts +407 -90
- package/src/deps/installer.ts +53 -10
- package/src/deps/lock.ts +74 -2
- package/src/home/settings.ts +3 -0
- package/src/instance/index.ts +57 -0
- package/src/packs/index.ts +7 -0
- package/src/packs/methods.ts +49 -0
- package/src/packs/packs.ts +706 -0
- package/src/packs/read.ts +759 -0
- package/src/platform/index.ts +1 -0
- package/src/platform/shell.ts +14 -0
- package/src/plugins/child/host.ts +231 -0
- package/src/plugins/child-protocol.ts +68 -0
- package/src/plugins/index.ts +7 -0
- package/src/plugins/location.ts +109 -0
- package/src/plugins/methods.ts +269 -0
- package/src/plugins/plugins.ts +1396 -0
- package/src/publish/publisher.ts +71 -3
- package/dist/instance-CFTw3g-c.js.map +0 -1
|
@@ -945,6 +945,42 @@
|
|
|
945
945
|
"explanation": "The capability link was revoked (`view/revoke`), replaced (`view/rotate`), or reached the end of its `ttl`. Every session started from it ends too. The gateway answers 410. Local links have no expiry unless one was asked for.",
|
|
946
946
|
"fix": "Get a new link from whoever shared this one. An agent mints it with `view/url`, or rotates the old one with `view/rotate`, and shares the new URL."
|
|
947
947
|
},
|
|
948
|
+
{
|
|
949
|
+
"code": "MOSTRA_LICENSE_ACCEPT_INVALID",
|
|
950
|
+
"severity": "error",
|
|
951
|
+
"phase": "host",
|
|
952
|
+
"title": "Accepted license not understood",
|
|
953
|
+
"hint": "Pass a license ID such as LicenseRef-Remotion, or * for every license.",
|
|
954
|
+
"explanation": "A value of `--accept-license` (or of the host's `licenses.accept`) is neither an SPDX license ID, nor a `LicenseRef-` reference, nor `*`.",
|
|
955
|
+
"fix": "Copy the ID from the `MOSTRA_LICENSE_UNACCEPTED` diagnostic that asked for it."
|
|
956
|
+
},
|
|
957
|
+
{
|
|
958
|
+
"code": "MOSTRA_LICENSE_MISMATCH",
|
|
959
|
+
"severity": "warning",
|
|
960
|
+
"phase": "manifest",
|
|
961
|
+
"title": "Declared license differs",
|
|
962
|
+
"hint": "Make the manifest's declaration match the package's own license field.",
|
|
963
|
+
"explanation": "The manifest declares a license for a package (in `bundledLicenses`, or its own `license`) that differs from the license field the package itself carries. Mostra discloses the package's own field, which it can read, and uses a declaration only where the field can't be read.",
|
|
964
|
+
"fix": "Correct the declaration, or the package's license field if the declaration is right."
|
|
965
|
+
},
|
|
966
|
+
{
|
|
967
|
+
"code": "MOSTRA_LICENSE_UNACCEPTED",
|
|
968
|
+
"severity": "error",
|
|
969
|
+
"phase": "contract",
|
|
970
|
+
"title": "License needs acknowledgment",
|
|
971
|
+
"hint": "Read the license the message names, then run the command in this diagnostic's fix to accept it.",
|
|
972
|
+
"explanation": "The install brings a license that isn't OSI-approved and isn't a public-domain dedication or another free license: a source-available or proprietary license, or one Mostra can't read. Such a license is accepted once per artifact (or for the home), by `--accept-license <id>` or by the host's policy, and the lockfile records it (D31). This is disclosure, not a limit: anyone may accept, and nothing was installed or recorded before they do. The message names each license, its class and the packages under it.",
|
|
973
|
+
"fix": "Read the license's terms (the message gives its summary and URL when the plugin declares them), then add the plugin again with `--accept-license <id>` for each ID, as the fix shows."
|
|
974
|
+
},
|
|
975
|
+
{
|
|
976
|
+
"code": "MOSTRA_LICENSE_UNDECLARED",
|
|
977
|
+
"severity": "warning",
|
|
978
|
+
"phase": "manifest",
|
|
979
|
+
"title": "Dependency license not declared",
|
|
980
|
+
"hint": "Declare the license in the plugin manifest's bundledLicenses, with a summary and a URL.",
|
|
981
|
+
"explanation": "A package the plugin brings has a license that needs an acknowledgment, and the manifest's `bundledLicenses` doesn't declare it, so the person installing sees only the package's own license field. Mostra still finds and discloses it from the installed packages.",
|
|
982
|
+
"fix": "Add `{ \"package\": \"<name>\", \"license\": \"<expression>\", \"summary\": \"…\", \"url\": \"…\" }` to `bundledLicenses`."
|
|
983
|
+
},
|
|
948
984
|
{
|
|
949
985
|
"code": "MOSTRA_LIVE_SOURCE_FAILED",
|
|
950
986
|
"severity": "error",
|
|
@@ -1008,6 +1044,87 @@
|
|
|
1008
1044
|
"explanation": "A resource the page loaded from the artifact's own origin (the document, a script, a style, an image, a font, or a fetch by artifact code) failed or answered 4xx or 5xx. Requests the browser makes on its own, such as `/favicon.ico`, and Mostra's own protocol aren't counted.",
|
|
1009
1045
|
"fix": "Put the file in `public/` (served at the root) or import it from the code so the build includes it, and check the path's spelling."
|
|
1010
1046
|
},
|
|
1047
|
+
{
|
|
1048
|
+
"code": "MOSTRA_PACK_ADDRESS_INVALID",
|
|
1049
|
+
"severity": "error",
|
|
1050
|
+
"phase": "host",
|
|
1051
|
+
"title": "Item address not understood",
|
|
1052
|
+
"hint": "Use an item URL, a local .json item, owner/repo/item for GitHub, or an @namespace/item your components.json registers.",
|
|
1053
|
+
"explanation": "`mostra add` reads an item address in shadcn's forms: an `https:` URL of an item's JSON, a path to a local `.json` item, a GitHub item (`owner/repo/item[#ref]`), or `@namespace/item` resolved through the `registries` of the artifact's `components.json`. A bare name in an item's `registryDependencies` means shadcn's own registry. This address is none of those, or names a namespace the artifact doesn't register, or a plain `http:` URL to another machine.",
|
|
1054
|
+
"fix": "Correct the address, or add the namespace to `registries` in the artifact's `components.json` (`\"@acme\": \"https://registry.acme.com/r/{name}.json\"`)."
|
|
1055
|
+
},
|
|
1056
|
+
{
|
|
1057
|
+
"code": "MOSTRA_PACK_CSS_UNIMPORTED",
|
|
1058
|
+
"severity": "warning",
|
|
1059
|
+
"phase": "compile",
|
|
1060
|
+
"title": "Item CSS not imported",
|
|
1061
|
+
"hint": "Import the stylesheet this diagnostic names from the artifact's entry.",
|
|
1062
|
+
"explanation": "The item brings CSS variables or rules, which Mostra wrote into a stylesheet of the artifact, but the artifact's entry doesn't import that stylesheet, so the page doesn't load them yet. Mostra writes into the stylesheet the entry imports when there is one (or the one `components.json` names), and creates `styles.css` otherwise.",
|
|
1063
|
+
"fix": "Add `import \"./styles.css\";` (the path the message names) to the artifact's entry, after any other stylesheet."
|
|
1064
|
+
},
|
|
1065
|
+
{
|
|
1066
|
+
"code": "MOSTRA_PACK_FETCH_FAILED",
|
|
1067
|
+
"severity": "error",
|
|
1068
|
+
"phase": "network",
|
|
1069
|
+
"title": "Registry item couldn't be read",
|
|
1070
|
+
"hint": "Check the network and the registry, then run the command again.",
|
|
1071
|
+
"explanation": "Reading the item failed: the registry couldn't be reached, answered an error other than 404, sent more than 8 MiB, took longer than 30 s, or redirected to an address Mostra doesn't follow. Nothing was written.",
|
|
1072
|
+
"fix": "Run the command again once the registry answers. Behind a proxy, set `HTTPS_PROXY` for the Mostra daemon."
|
|
1073
|
+
},
|
|
1074
|
+
{
|
|
1075
|
+
"code": "MOSTRA_PACK_FILE_EXISTS",
|
|
1076
|
+
"severity": "error",
|
|
1077
|
+
"phase": "host",
|
|
1078
|
+
"title": "File already exists",
|
|
1079
|
+
"hint": "Run the command again with `--overwrite` to replace the files the message lists, or move them first.",
|
|
1080
|
+
"explanation": "The artifact already has files where the item writes, with other content. Mostra never replaces an artifact's file without being asked, as shadcn asks before it overwrites; nothing was written.",
|
|
1081
|
+
"fix": "Add `--overwrite` to replace them (`mostra add <item> --artifact <path> --overwrite`), or rename your files and add the item again."
|
|
1082
|
+
},
|
|
1083
|
+
{
|
|
1084
|
+
"code": "MOSTRA_PACK_ITEM_INVALID",
|
|
1085
|
+
"severity": "error",
|
|
1086
|
+
"phase": "manifest",
|
|
1087
|
+
"title": "Registry item invalid",
|
|
1088
|
+
"hint": "Fix the field this diagnostic names in the item's JSON.",
|
|
1089
|
+
"explanation": "The item isn't a shadcn registry item Mostra can install: it isn't JSON, misses `name` or `type`, a file has no `path`, a `registry:file` or `registry:page` has no `target`, a file has neither `content` nor a path its registry holds, or the `mostra` block has a wrong value. Every field shadcn's schema allows is accepted, and unknown keys are kept.",
|
|
1090
|
+
"fix": "Correct the item (its JSON Schema is `https://ui.shadcn.com/schema/registry-item.json`, plus the `mostra` block in `@mostra/protocol/schemas/plugin-manifest.schema.json`)."
|
|
1091
|
+
},
|
|
1092
|
+
{
|
|
1093
|
+
"code": "MOSTRA_PACK_ITEM_NOT_FOUND",
|
|
1094
|
+
"severity": "error",
|
|
1095
|
+
"phase": "network",
|
|
1096
|
+
"title": "Registry item not found",
|
|
1097
|
+
"hint": "Check the address; for a GitHub item, check the repository's registry.json and the ref.",
|
|
1098
|
+
"explanation": "The registry answered that the item doesn't exist (HTTP 404), the local file isn't there, or a GitHub repository's root `registry.json` has no item by that name. The message names the address and where Mostra looked.",
|
|
1099
|
+
"fix": "Correct the address. For a GitHub item, `owner/repo/item` names an item of the repository's root `registry.json`, at its default branch unless `#ref` says otherwise."
|
|
1100
|
+
},
|
|
1101
|
+
{
|
|
1102
|
+
"code": "MOSTRA_PACK_NOT_APPLIED",
|
|
1103
|
+
"severity": "hint",
|
|
1104
|
+
"phase": "host",
|
|
1105
|
+
"title": "Item part not applied",
|
|
1106
|
+
"hint": "Read what the item asked for and apply it yourself if the artifact needs it.",
|
|
1107
|
+
"explanation": "The item asks for something an artifact doesn't have: environment variables (`envVars`; server code reads secrets with `secret()`, set by `mostra secret set`), a Tailwind 3 configuration (`tailwind.config`; Tailwind 4 reads `cssVars.theme`), a font through `next/font`, or a design-system configuration (`registry:base`, `registry:style`). Mostra installs the rest and lists these.",
|
|
1108
|
+
"fix": "Set the secrets the item's server code needs with `mostra secret set NAME`, and move any Tailwind 3 theme into the item's `cssVars.theme` or your stylesheet's `@theme`."
|
|
1109
|
+
},
|
|
1110
|
+
{
|
|
1111
|
+
"code": "MOSTRA_PACK_OFFLINE",
|
|
1112
|
+
"severity": "error",
|
|
1113
|
+
"phase": "network",
|
|
1114
|
+
"title": "Registry item unavailable offline",
|
|
1115
|
+
"hint": "Connect to the network, or add the item from a local .json file.",
|
|
1116
|
+
"explanation": "Mostra is offline (`MOSTRA_OFFLINE` is set, or no network interface is up), and the item, or one of its registry dependencies, is on a remote registry. Nothing was written.",
|
|
1117
|
+
"fix": "Run the command again with the network up, or download the item and add it from its file: `mostra add ./item.json --artifact <path>`."
|
|
1118
|
+
},
|
|
1119
|
+
{
|
|
1120
|
+
"code": "MOSTRA_PACK_TARGET_INVALID",
|
|
1121
|
+
"severity": "error",
|
|
1122
|
+
"phase": "host",
|
|
1123
|
+
"title": "Item file outside the artifact",
|
|
1124
|
+
"hint": "Ask the item's author to fix its target; Mostra writes an item's files only inside the artifact.",
|
|
1125
|
+
"explanation": "A file of the item would land outside the artifact's directory (`../`, an absolute path), on a name not every system can hold (`<>:\"|?*`, a Windows device name, a trailing dot or space), on Mostra's own files, or on two names that differ only in case. Nothing was written.",
|
|
1126
|
+
"fix": "Use a corrected item, or copy the files you need into the artifact yourself."
|
|
1127
|
+
},
|
|
1011
1128
|
{
|
|
1012
1129
|
"code": "MOSTRA_PLATFORM_UNSUPPORTED",
|
|
1013
1130
|
"severity": "error",
|
|
@@ -1017,6 +1134,123 @@
|
|
|
1017
1134
|
"explanation": "Mostra runs on macOS, Linux with glibc and Windows, each on x64 and arm64. On any other operating system or architecture (32-bit Windows, musl-based Linux such as Alpine, BSDs) every entry point stops with this code before it creates or changes anything, because the process model, the control endpoint, storage and the runtime bundle are built and tested only on those platforms. The message names the platform that was detected.",
|
|
1018
1135
|
"fix": "Run Mostra on macOS, a glibc-based Linux or Windows, with an x64 or arm64 processor. On Alpine Linux, use a glibc-based image instead."
|
|
1019
1136
|
},
|
|
1137
|
+
{
|
|
1138
|
+
"code": "MOSTRA_PLUGIN_CONFLICT",
|
|
1139
|
+
"severity": "error",
|
|
1140
|
+
"phase": "contract",
|
|
1141
|
+
"title": "Plugins contribute the same ID",
|
|
1142
|
+
"hint": "Remove one of the two plugins the message names, or use releases whose IDs differ.",
|
|
1143
|
+
"explanation": "Two plugins of one artifact, or one of the artifact's and one of the home's, contribute the same ID to the same contract (two exporters `pdf`, two commands `term record`), or a plugin takes an ID Mostra builds in (the exporters `static`, `html`, `bundle` and `snapshot`). Nothing is overridden silently (ROUND-3 §6.4): the message names both sides.",
|
|
1144
|
+
"fix": "Remove one plugin with `mostra plugin remove <package> --artifact <path>` (or `--global`), then add the other again if needed."
|
|
1145
|
+
},
|
|
1146
|
+
{
|
|
1147
|
+
"code": "MOSTRA_PLUGIN_CONTRACT_UNSUPPORTED",
|
|
1148
|
+
"severity": "error",
|
|
1149
|
+
"phase": "contract",
|
|
1150
|
+
"title": "Contract version not implemented",
|
|
1151
|
+
"hint": "Install a version of the plugin built for this Mostra's contracts, or update Mostra.",
|
|
1152
|
+
"explanation": "The plugin declares a contract range, or carries a definition stamped with a contract version, that this Mostra release doesn't serve. Each extension contract is its own package with its own version (D30): within a line changes are additive, so Mostra serves stamps of its line up to the version it implements, and a range must admit that version. The message names the contract, the plugin's range or stamp, and the version this release implements. Mostra reports it when the plugin is added, and when `verify` or `publish` loads it, so an artifact whose plugin a newer runtime no longer serves is told before it is published.",
|
|
1153
|
+
"fix": "Add a release of the plugin whose range admits the version the message names (`mostra plugin add <package>@<version> --artifact <path>`), or run a Mostra release that implements the plugin's contract version, or remove the plugin with `mostra plugin remove`."
|
|
1154
|
+
},
|
|
1155
|
+
{
|
|
1156
|
+
"code": "MOSTRA_PLUGIN_ENTRY_INVALID",
|
|
1157
|
+
"severity": "error",
|
|
1158
|
+
"phase": "contract",
|
|
1159
|
+
"title": "Plugin entry doesn't load",
|
|
1160
|
+
"hint": "Fix the module the message names so it exports the definition its contract's define function returns.",
|
|
1161
|
+
"explanation": "A contribution's `entry` module is missing from the package, leaves it, failed to load, or doesn't export (at `export`, `default` when absent) a definition stamped by the contract's blueprint (`defineExporter`, `defineCliCommand` …) with the ID the manifest gives. Mostra reads the stamp from the loaded object itself, in a child process of the instance, so a manifest alone can't claim a contract. Contributions that run in the page (embed engines, anchor providers) are checked when the page uses them.",
|
|
1162
|
+
"fix": "Build the plugin so the module exists, export the value its `define*` function returns, and keep the manifest's ID equal to the definition's. Then run `mostra plugin validate <dir>`."
|
|
1163
|
+
},
|
|
1164
|
+
{
|
|
1165
|
+
"code": "MOSTRA_PLUGIN_EXPORTER_UNKNOWN",
|
|
1166
|
+
"severity": "error",
|
|
1167
|
+
"phase": "host",
|
|
1168
|
+
"title": "No such exporter",
|
|
1169
|
+
"hint": "Use one of the exporters the message lists, or add a plugin that contributes this one.",
|
|
1170
|
+
"explanation": "`mostra export <artifact> --as <id> --out <path>` names an exporter that neither Mostra builds in nor any plugin of the artifact or the home contributes. The message lists every exporter available for the artifact.",
|
|
1171
|
+
"fix": "Pick an exporter from the list, or install a plugin that contributes it: `mostra plugin add <package> --artifact <path>`."
|
|
1172
|
+
},
|
|
1173
|
+
{
|
|
1174
|
+
"code": "MOSTRA_PLUGIN_FAILED",
|
|
1175
|
+
"severity": "error",
|
|
1176
|
+
"phase": "runtime",
|
|
1177
|
+
"title": "Plugin failed",
|
|
1178
|
+
"hint": "Read the plugin's error in the message and report it to the plugin's author if it isn't yours to fix.",
|
|
1179
|
+
"explanation": "A plugin's contribution threw, returned something its contract doesn't allow (a file outside the export, a result that isn't JSON), or ran past its time limit while Mostra ran it. It runs in a child process of the instance, so the instance and other artifacts are unaffected; nothing it returned was kept.",
|
|
1180
|
+
"fix": "Fix the contribution if it is your plugin; otherwise update or remove it (`mostra plugin remove`)."
|
|
1181
|
+
},
|
|
1182
|
+
{
|
|
1183
|
+
"code": "MOSTRA_PLUGIN_MANIFEST_INVALID",
|
|
1184
|
+
"severity": "error",
|
|
1185
|
+
"phase": "manifest",
|
|
1186
|
+
"title": "Plugin manifest invalid",
|
|
1187
|
+
"hint": "Fix the field this diagnostic names in the plugin's package.json, then run `mostra plugin validate` again.",
|
|
1188
|
+
"explanation": "A field of the plugin's manifest, the `\"mostra\"` key of its `package.json`, isn't one Mostra can load: a required field is missing, a value has the wrong form, a contribution kind has no contract range, an ID is contributed twice, a command would take one of `mostra`'s own words, or a license isn't an SPDX expression. The location points at the field, and `mostra plugin validate` reports every one at once.",
|
|
1189
|
+
"fix": "Correct the field (the message says what it expects) and validate again. The manifest's shape is published as JSON Schema in `@mostra/protocol/schemas/plugin-manifest.schema.json`."
|
|
1190
|
+
},
|
|
1191
|
+
{
|
|
1192
|
+
"code": "MOSTRA_PLUGIN_MANIFEST_WARNING",
|
|
1193
|
+
"severity": "warning",
|
|
1194
|
+
"phase": "manifest",
|
|
1195
|
+
"title": "Plugin manifest questionable",
|
|
1196
|
+
"hint": "Check the field this diagnostic names; Mostra loads the plugin and ignores what it doesn't know.",
|
|
1197
|
+
"explanation": "The plugin's manifest has something this Mostra release loads around: a key it doesn't know, an effect or a system it doesn't know, or a contract declared with nothing contributed to it. Manifests grow additively, so a newer plugin may carry keys an older Mostra skips; a misspelled key is skipped the same way, which can leave a contribution or a license undeclared.",
|
|
1198
|
+
"fix": "Correct the field if it is a mistake. If it is something a newer Mostra reads, nothing is needed."
|
|
1199
|
+
},
|
|
1200
|
+
{
|
|
1201
|
+
"code": "MOSTRA_PLUGIN_NOT_A_PLUGIN",
|
|
1202
|
+
"severity": "error",
|
|
1203
|
+
"phase": "manifest",
|
|
1204
|
+
"title": "Not a Mostra plugin",
|
|
1205
|
+
"hint": "Add the package with `mostra add` if it is an ordinary package, or give it a \"mostra\" manifest if it is a plugin.",
|
|
1206
|
+
"explanation": "The package has no `\"mostra\"` key in its `package.json`, so it contributes nothing Mostra could load. `mostra plugin add` installs only plugins; ordinary npm packages go through `mostra add`.",
|
|
1207
|
+
"fix": "Run `mostra add <package> --artifact <path>` for an ordinary package. For a plugin you write, add the manifest (`mostra docs guide/plugins`) and run `mostra plugin validate`."
|
|
1208
|
+
},
|
|
1209
|
+
{
|
|
1210
|
+
"code": "MOSTRA_PLUGIN_NOT_INSTALLED",
|
|
1211
|
+
"severity": "error",
|
|
1212
|
+
"phase": "host",
|
|
1213
|
+
"title": "Plugin not installed",
|
|
1214
|
+
"hint": "Check the package name against `mostra plugin list`.",
|
|
1215
|
+
"explanation": "The package isn't one of the plugins of the artifact (or of the home) the call names, so there is nothing to remove.",
|
|
1216
|
+
"fix": "List the scope's plugins with `mostra plugin list --artifact <path>` (or `--global`) and use a name from it."
|
|
1217
|
+
},
|
|
1218
|
+
{
|
|
1219
|
+
"code": "MOSTRA_PLUGIN_OPTIONS_INVALID",
|
|
1220
|
+
"severity": "error",
|
|
1221
|
+
"phase": "contract",
|
|
1222
|
+
"title": "Exporter options invalid",
|
|
1223
|
+
"hint": "Give the options the exporter's schema asks for, each as `--option name=value`.",
|
|
1224
|
+
"explanation": "The options given to a plugin's exporter don't fit the JSON Schema its definition declares (`options`), or it declares none and was given some. Mostra checks them in the plugin's child before the exporter runs, so nothing was exported.",
|
|
1225
|
+
"fix": "Read the exporter's options in its plugin's documentation (`mostra plugin list` names the plugin), and run `mostra export <artifact> --as <exporter> --out <path> --option name=value` with them. A value that reads as JSON (`3`, `true`, `[\"a\"]`) is passed as that value, anything else as text."
|
|
1226
|
+
},
|
|
1227
|
+
{
|
|
1228
|
+
"code": "MOSTRA_PLUGIN_PLATFORM_UNSUPPORTED",
|
|
1229
|
+
"severity": "warning",
|
|
1230
|
+
"phase": "platform",
|
|
1231
|
+
"title": "Plugin doesn't name this system",
|
|
1232
|
+
"hint": "Expect the plugin's Node.js parts to fail here, or use a plugin that supports this system.",
|
|
1233
|
+
"explanation": "The plugin's manifest lists the systems it runs on (`platforms`), and this one isn't among them. Mostra installs it anyway (it adds no capability limits), and says so, since its exporters, checks, connectors or commands may fail here.",
|
|
1234
|
+
"fix": "Use the plugin on a system it lists, or ask its author to support this one."
|
|
1235
|
+
},
|
|
1236
|
+
{
|
|
1237
|
+
"code": "MOSTRA_PLUGIN_SCOPE_INVALID",
|
|
1238
|
+
"severity": "error",
|
|
1239
|
+
"phase": "contract",
|
|
1240
|
+
"title": "Plugin can't be installed there",
|
|
1241
|
+
"hint": "Install the plugin for an artifact with `--artifact`, or pass exactly one of `--artifact` and `--global`.",
|
|
1242
|
+
"explanation": "Plugins are installed for one artifact (recorded in its lockfile, part of its versions) or, when they contribute only exporters and CLI commands, for the whole home (ROUND-3 §6.4). This plugin contributes something that changes what an artifact's version is (an embed engine, a verify check, an anchor provider, a connector or a pack), so it can't be installed for the home; or the call named both scopes or neither.",
|
|
1243
|
+
"fix": "Run `mostra plugin add <package> --artifact <path>` for each artifact that uses it."
|
|
1244
|
+
},
|
|
1245
|
+
{
|
|
1246
|
+
"code": "MOSTRA_PLUGIN_SHADOWED",
|
|
1247
|
+
"severity": "warning",
|
|
1248
|
+
"phase": "contract",
|
|
1249
|
+
"title": "Plugin contribution shadowed",
|
|
1250
|
+
"hint": "Remove one of the two plugins if the artifact should use the other's contribution.",
|
|
1251
|
+
"explanation": "An artifact's plugin and one of the home's (`--global`) contribute the same exporter or CLI command. Nothing is refused: in this artifact its own plugin's contribution is used, and the home's everywhere else. A home install never breaks an artifact that worked.",
|
|
1252
|
+
"fix": "Nothing is needed when the artifact's own contribution is the one it should use. Otherwise remove it from the artifact (`mostra plugin remove <package> --artifact <path>`), and the home's is used."
|
|
1253
|
+
},
|
|
1020
1254
|
{
|
|
1021
1255
|
"code": "MOSTRA_PUBLISH_ID_CONFLICT",
|
|
1022
1256
|
"severity": "error",
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_LICENSE_ACCEPT_INVALID
|
|
3
|
+
severity: error
|
|
4
|
+
phase: host
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_LICENSE_ACCEPT_INVALID
|
|
10
|
+
|
|
11
|
+
Accepted license not understood. Severity: error. Phase: host.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
A value of `--accept-license` (or of the host's `licenses.accept`) is neither an SPDX license ID, nor a `LicenseRef-` reference, nor `*`.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Copy the ID from the `MOSTRA_LICENSE_UNACCEPTED` diagnostic that asked for it.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Pass a license ID such as LicenseRef-Remotion, or * for every license.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_LICENSE_MISMATCH
|
|
3
|
+
severity: warning
|
|
4
|
+
phase: manifest
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_LICENSE_MISMATCH
|
|
10
|
+
|
|
11
|
+
Declared license differs. Severity: warning. Phase: manifest.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
The manifest declares a license for a package (in `bundledLicenses`, or its own `license`) that differs from the license field the package itself carries. Mostra discloses the package's own field, which it can read, and uses a declaration only where the field can't be read.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Correct the declaration, or the package's license field if the declaration is right.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Make the manifest's declaration match the package's own license field.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_LICENSE_UNACCEPTED
|
|
3
|
+
severity: error
|
|
4
|
+
phase: contract
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_LICENSE_UNACCEPTED
|
|
10
|
+
|
|
11
|
+
License needs acknowledgment. Severity: error. Phase: contract.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
The install brings a license that isn't OSI-approved and isn't a public-domain dedication or another free license: a source-available or proprietary license, or one Mostra can't read. Such a license is accepted once per artifact (or for the home), by `--accept-license <id>` or by the host's policy, and the lockfile records it (D31). This is disclosure, not a limit: anyone may accept, and nothing was installed or recorded before they do. The message names each license, its class and the packages under it.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Read the license's terms (the message gives its summary and URL when the plugin declares them), then add the plugin again with `--accept-license <id>` for each ID, as the fix shows.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Read the license the message names, then run the command in this diagnostic's fix to accept it.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_LICENSE_UNDECLARED
|
|
3
|
+
severity: warning
|
|
4
|
+
phase: manifest
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_LICENSE_UNDECLARED
|
|
10
|
+
|
|
11
|
+
Dependency license not declared. Severity: warning. Phase: manifest.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
A package the plugin brings has a license that needs an acknowledgment, and the manifest's `bundledLicenses` doesn't declare it, so the person installing sees only the package's own license field. Mostra still finds and discloses it from the installed packages.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Add `{ "package": "<name>", "license": "<expression>", "summary": "…", "url": "…" }` to `bundledLicenses`.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Declare the license in the plugin manifest's bundledLicenses, with a summary and a URL.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PACK_ADDRESS_INVALID
|
|
3
|
+
severity: error
|
|
4
|
+
phase: host
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PACK_ADDRESS_INVALID
|
|
10
|
+
|
|
11
|
+
Item address not understood. Severity: error. Phase: host.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
`mostra add` reads an item address in shadcn's forms: an `https:` URL of an item's JSON, a path to a local `.json` item, a GitHub item (`owner/repo/item[#ref]`), or `@namespace/item` resolved through the `registries` of the artifact's `components.json`. A bare name in an item's `registryDependencies` means shadcn's own registry. This address is none of those, or names a namespace the artifact doesn't register, or a plain `http:` URL to another machine.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Correct the address, or add the namespace to `registries` in the artifact's `components.json` (`"@acme": "https://registry.acme.com/r/{name}.json"`).
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Use an item URL, a local .json item, owner/repo/item for GitHub, or an @namespace/item your components.json registers.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PACK_CSS_UNIMPORTED
|
|
3
|
+
severity: warning
|
|
4
|
+
phase: compile
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PACK_CSS_UNIMPORTED
|
|
10
|
+
|
|
11
|
+
Item CSS not imported. Severity: warning. Phase: compile.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
The item brings CSS variables or rules, which Mostra wrote into a stylesheet of the artifact, but the artifact's entry doesn't import that stylesheet, so the page doesn't load them yet. Mostra writes into the stylesheet the entry imports when there is one (or the one `components.json` names), and creates `styles.css` otherwise.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Add `import "./styles.css";` (the path the message names) to the artifact's entry, after any other stylesheet.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Import the stylesheet this diagnostic names from the artifact's entry.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PACK_FETCH_FAILED
|
|
3
|
+
severity: error
|
|
4
|
+
phase: network
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PACK_FETCH_FAILED
|
|
10
|
+
|
|
11
|
+
Registry item couldn't be read. Severity: error. Phase: network.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
Reading the item failed: the registry couldn't be reached, answered an error other than 404, sent more than 8 MiB, took longer than 30 s, or redirected to an address Mostra doesn't follow. Nothing was written.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Run the command again once the registry answers. Behind a proxy, set `HTTPS_PROXY` for the Mostra daemon.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Check the network and the registry, then run the command again.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PACK_FILE_EXISTS
|
|
3
|
+
severity: error
|
|
4
|
+
phase: host
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PACK_FILE_EXISTS
|
|
10
|
+
|
|
11
|
+
File already exists. Severity: error. Phase: host.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
The artifact already has files where the item writes, with other content. Mostra never replaces an artifact's file without being asked, as shadcn asks before it overwrites; nothing was written.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Add `--overwrite` to replace them (`mostra add <item> --artifact <path> --overwrite`), or rename your files and add the item again.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Run the command again with `--overwrite` to replace the files the message lists, or move them first.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PACK_ITEM_INVALID
|
|
3
|
+
severity: error
|
|
4
|
+
phase: manifest
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PACK_ITEM_INVALID
|
|
10
|
+
|
|
11
|
+
Registry item invalid. Severity: error. Phase: manifest.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
The item isn't a shadcn registry item Mostra can install: it isn't JSON, misses `name` or `type`, a file has no `path`, a `registry:file` or `registry:page` has no `target`, a file has neither `content` nor a path its registry holds, or the `mostra` block has a wrong value. Every field shadcn's schema allows is accepted, and unknown keys are kept.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Correct the item (its JSON Schema is `https://ui.shadcn.com/schema/registry-item.json`, plus the `mostra` block in `@mostra/protocol/schemas/plugin-manifest.schema.json`).
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Fix the field this diagnostic names in the item's JSON.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PACK_ITEM_NOT_FOUND
|
|
3
|
+
severity: error
|
|
4
|
+
phase: network
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PACK_ITEM_NOT_FOUND
|
|
10
|
+
|
|
11
|
+
Registry item not found. Severity: error. Phase: network.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
The registry answered that the item doesn't exist (HTTP 404), the local file isn't there, or a GitHub repository's root `registry.json` has no item by that name. The message names the address and where Mostra looked.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Correct the address. For a GitHub item, `owner/repo/item` names an item of the repository's root `registry.json`, at its default branch unless `#ref` says otherwise.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Check the address; for a GitHub item, check the repository's registry.json and the ref.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PACK_NOT_APPLIED
|
|
3
|
+
severity: hint
|
|
4
|
+
phase: host
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PACK_NOT_APPLIED
|
|
10
|
+
|
|
11
|
+
Item part not applied. Severity: hint. Phase: host.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
The item asks for something an artifact doesn't have: environment variables (`envVars`; server code reads secrets with `secret()`, set by `mostra secret set`), a Tailwind 3 configuration (`tailwind.config`; Tailwind 4 reads `cssVars.theme`), a font through `next/font`, or a design-system configuration (`registry:base`, `registry:style`). Mostra installs the rest and lists these.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Set the secrets the item's server code needs with `mostra secret set NAME`, and move any Tailwind 3 theme into the item's `cssVars.theme` or your stylesheet's `@theme`.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Read what the item asked for and apply it yourself if the artifact needs it.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PACK_OFFLINE
|
|
3
|
+
severity: error
|
|
4
|
+
phase: network
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PACK_OFFLINE
|
|
10
|
+
|
|
11
|
+
Registry item unavailable offline. Severity: error. Phase: network.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
Mostra is offline (`MOSTRA_OFFLINE` is set, or no network interface is up), and the item, or one of its registry dependencies, is on a remote registry. Nothing was written.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Run the command again with the network up, or download the item and add it from its file: `mostra add ./item.json --artifact <path>`.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Connect to the network, or add the item from a local .json file.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PACK_TARGET_INVALID
|
|
3
|
+
severity: error
|
|
4
|
+
phase: host
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PACK_TARGET_INVALID
|
|
10
|
+
|
|
11
|
+
Item file outside the artifact. Severity: error. Phase: host.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
A file of the item would land outside the artifact's directory (`../`, an absolute path), on a name not every system can hold (`<>:"|?*`, a Windows device name, a trailing dot or space), on Mostra's own files, or on two names that differ only in case. Nothing was written.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Use a corrected item, or copy the files you need into the artifact yourself.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Ask the item's author to fix its target; Mostra writes an item's files only inside the artifact.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PLUGIN_CONFLICT
|
|
3
|
+
severity: error
|
|
4
|
+
phase: contract
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PLUGIN_CONFLICT
|
|
10
|
+
|
|
11
|
+
Plugins contribute the same ID. Severity: error. Phase: contract.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
Two plugins of one artifact, or one of the artifact's and one of the home's, contribute the same ID to the same contract (two exporters `pdf`, two commands `term record`), or a plugin takes an ID Mostra builds in (the exporters `static`, `html`, `bundle` and `snapshot`). Nothing is overridden silently (ROUND-3 §6.4): the message names both sides.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Remove one plugin with `mostra plugin remove <package> --artifact <path>` (or `--global`), then add the other again if needed.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Remove one of the two plugins the message names, or use releases whose IDs differ.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
code: MOSTRA_PLUGIN_CONTRACT_UNSUPPORTED
|
|
3
|
+
severity: error
|
|
4
|
+
phase: contract
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from packages/protocol/src/diagnostics/codes by `node tools/docs/diagnostics.ts write`. Edit the area file, not this page. -->
|
|
8
|
+
|
|
9
|
+
# MOSTRA_PLUGIN_CONTRACT_UNSUPPORTED
|
|
10
|
+
|
|
11
|
+
Contract version not implemented. Severity: error. Phase: contract.
|
|
12
|
+
|
|
13
|
+
## What it means
|
|
14
|
+
|
|
15
|
+
The plugin declares a contract range, or carries a definition stamped with a contract version, that this Mostra release doesn't serve. Each extension contract is its own package with its own version (D30): within a line changes are additive, so Mostra serves stamps of its line up to the version it implements, and a range must admit that version. The message names the contract, the plugin's range or stamp, and the version this release implements. Mostra reports it when the plugin is added, and when `verify` or `publish` loads it, so an artifact whose plugin a newer runtime no longer serves is told before it is published.
|
|
16
|
+
|
|
17
|
+
## How to fix it
|
|
18
|
+
|
|
19
|
+
Add a release of the plugin whose range admits the version the message names (`mostra plugin add <package>@<version> --artifact <path>`), or run a Mostra release that implements the plugin's contract version, or remove the plugin with `mostra plugin remove`.
|
|
20
|
+
|
|
21
|
+
## Hint
|
|
22
|
+
|
|
23
|
+
Install a version of the plugin built for this Mostra's contracts, or update Mostra.
|