@mercury-fw/cli 0.31.1 → 0.32.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mercury-fw/cli
 
+## 0.32.0
+
+### Minor Changes
+
+- 1fa3a97: - Every tool plugin declared in `mercury.config.ts` loads: `MERCURY_CLIS` is no longer read. An app that used it to keep a declared plugin off now gets that plugin on; remove the plugin from the config instead.
+  - A new app's env example has no `MERCURY_CLIS`, and its config's comment says every declared plugin and channel is active.
+  - A plugin caught in a dependency cycle is always reported at startup.
+  - The plugins' READMEs no longer ask to list them in `MERCURY_CLIS`.
+
+### Patch Changes
+
+- Updated dependencies [1fa3a97]
+  - @mercury-fw/core@0.32.0
+
 ## 0.31.1
 
 ### Patch Changes

package/dist/src/catalog.d.ts

@@ -12,7 +12,7 @@ export type EnvVar = {
     value?: string;
 };
 /** A channel or tool plugin the app can include. `id` is the plugin's own
- * `name` (what MERCURY_CLIS lists for a tool plugin), `exportName` the value the
+ * `name` (what the logs and `dependsOn` call it), `exportName` the value the
  * app's config imports from `package`. */
 export type CatalogEntry = {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mercury-fw/cli",
-  "version": "0.31.1",
+  "version": "0.32.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -41,16 +41,16 @@
   "comment:shape": "The Mercury CLI (`mfw`). `mfw create <dir>` writes a new Mercury app from the template. The framework packages move in lockstep with it, so a new app gets them at the CLI's own version; plugins and channels at the registry's latest. The plugin and channel packages are devDependencies only for the catalog test. `main(argv)` is exported for create-mercury-agent.",
   "dependencies": {
     "@clack/prompts": "^1.8.1",
-    "@mercury-fw/core": "0.31.1",
+    "@mercury-fw/core": "0.32.0",
     "commander": "^15.0.0"
   },
   "devDependencies": {
     "@mercury-fw/channel-google-chat": "0.1.3",
     "@mercury-fw/channel-http": "0.1.1",
-    "@mercury-fw/formatter": "0.31.1",
-    "@mercury-fw/plugin-atlassian-admin": "0.1.0",
-    "@mercury-fw/plugin-bitbucket": "0.1.0",
-    "@mercury-fw/plugin-jira": "0.4.1",
+    "@mercury-fw/formatter": "0.32.0",
+    "@mercury-fw/plugin-atlassian-admin": "0.1.1",
+    "@mercury-fw/plugin-bitbucket": "0.1.1",
+    "@mercury-fw/plugin-jira": "0.4.2",
     "@mercury-fw/typescript-config": "*",
     "@types/bun": "^1.4.2",
     "typescript": "^6.0.3"

package/src/catalog.ts

@@ -10,7 +10,7 @@
 export type EnvVar = { name: string; comment: string; value?: string };
 
 /** A channel or tool plugin the app can include. `id` is the plugin's own
- * `name` (what MERCURY_CLIS lists for a tool plugin), `exportName` the value the
+ * `name` (what the logs and `dependsOn` call it), `exportName` the value the
  * app's config imports from `package`. */
 export type CatalogEntry = {
   id: string;

package/src/render.ts

@@ -51,8 +51,7 @@ const CONFIG_HEADER = `/**
  * its plugins hand over read, and the assistant's persona. The entrypoints
  * (\`src/index.ts\`, \`src/repl.ts\`) hand this config to \`composeMercury\`.
  *
- * A tool plugin contributes only when it's also listed in MERCURY_CLIS; a
- * channel is active as soon as it's declared here.
+ * Every tool plugin and channel declared here is active.
  */`;
 
 /** Builds every file of the new app. Throws on an invalid app name, an empty
@@ -286,22 +285,11 @@ function renderPackageJson(
   return `${JSON.stringify(manifest, null, 2)}\n`;
 }
 
-/** The env example: the core's variables, MERCURY_CLIS when a tool plugin was
- * chosen, then a section per chosen entry that reads any variable. */
+/** The env example: the core's variables, then a section per chosen entry
+ * that reads any variable. */
 function renderEnv(channels: CatalogEntry[], tools: CatalogEntry[]): string {
   const block = (vars: EnvVar[]) => vars.map((v) => `# ${v.comment}\n${v.name}=${v.value ?? ""}`).join("\n");
   const sections = [block(CORE_ENV)];
-  if (tools.length > 0) {
-    sections.push(
-      block([
-        {
-          name: "MERCURY_CLIS",
-          comment: "Tool plugins this instance enables (their ids, comma-separated)",
-          value: tools.map((t) => t.id).join(","),
-        },
-      ]),
-    );
-  }
   for (const entry of [...channels, ...tools]) {
     const vars = [...entry.env];
     if (entry.credentials !== undefined) {