@mercury-fw/cli 0.61.0 → 0.63.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @mercury-fw/cli
 
+## 0.63.0
+
+### Patch Changes
+
+- Updated dependencies [b26388b]
+  - @mercury-fw/core@0.63.0
+  - @mercury-fw/utils@0.63.0
+
+## 0.62.0
+
+### Minor Changes
+
+- 96eb1a8: - `mfw create` offers the Confluence plugin (`--plugins confluence`), wrapped in the formatter with a starting rule for its search results and one for a page's children, and their empty texts in `locales/en.json`.
+
+### Patch Changes
+
+- @mercury-fw/core@0.62.0
+- @mercury-fw/utils@0.62.0
+
 ## 0.61.0
 
 ### Patch Changes

package/README.md

@@ -63,7 +63,7 @@ Then it runs `bun install` in the app and creates a git repository on `main` wit
 | `--assistant-name <name>` | The assistant's name (default `Mercury`). |
 | `--role <text>` | Completes "You are <name>, …" (default `an internal assistant`). |
 | `--channels <ids>` | Comma-separated: `google-chat`, `http`. |
-| `--plugins <ids>` | Comma-separated: `jira`, `bitbucket`, `atlassian-admin`, `zitadel`, `web-search` (with a SearXNG service next to the app: set `SEARXNG_SECRET` in the env file). |
+| `--plugins <ids>` | Comma-separated: `jira`, `bitbucket`, `atlassian-admin`, `zitadel`, `web-search` (with a SearXNG service next to the app: set `SEARXNG_SECRET` in the env file), `confluence`. |
 | `--auth <id>` | The HTTP channel's auth provider, `oidc` or `static`: required with `http`, refused without it, since the channel doesn't start without one. The wizard asks for it once `http` is chosen. |
 | `--directory <id>` | The user directory, `static` or `zitadel`: who the people are and their roles. Without one, the person is whoever the channel says, with no roles. |
 | `--local-packages <folder>` | Installs the packages packed in `<folder>` (`bun pm pack`) instead of the registry's, as [`mfw local-packages`](#mfw-local-packages-folder--mfw-local-packages---off) does on an existing app: their versions come from the tarballs, so a package that isn't published yet works too, and no newer `mfw` is looked up on the registry. For trying unreleased packages in a new app; the test bed makes its apps this way. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mercury-fw/cli",
-  "version": "0.61.0",
+  "version": "0.63.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -41,8 +41,8 @@
   "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.61.0",
-    "@mercury-fw/utils": "0.61.0",
+    "@mercury-fw/core": "0.63.0",
+    "@mercury-fw/utils": "0.63.0",
     "commander": "^15.0.0"
   },
   "devDependencies": {
@@ -51,9 +51,10 @@
     "@mercury-fw/channel-google-chat": "0.11.1",
     "@mercury-fw/channel-http": "0.13.2",
     "@mercury-fw/directory-static": "0.1.2",
-    "@mercury-fw/formatter": "0.61.0",
+    "@mercury-fw/formatter": "0.63.0",
     "@mercury-fw/plugin-atlassian-admin": "0.5.1",
     "@mercury-fw/plugin-bitbucket": "0.6.1",
+    "@mercury-fw/plugin-confluence": "0.1.0",
     "@mercury-fw/plugin-jira": "0.8.1",
     "@mercury-fw/plugin-web-search": "0.4.1",
     "@mercury-fw/plugin-zitadel": "0.5.1",

package/src/catalog.ts

@@ -187,6 +187,33 @@ export const CATALOG: CatalogEntry[] = [
     },
     files: { "searxng/settings.yml": SEARXNG_SETTINGS },
   },
+  {
+    id: "confluence",
+    kind: "tool",
+    package: "@mercury-fw/plugin-confluence",
+    exportName: "confluencePlugin",
+    env: [],
+    formatter: {
+      displaysType: "ConfluenceDisplays",
+      helpers: [
+        "/** One page in a Confluence search result: its title, its space in parentheses",
+        " * when there is one, and its link on its own line. A starting point: change it",
+        " * to change how Confluence search results read (each item also has an excerpt). */",
+        'const confluencePageLine = (page: ConfluenceDisplays["page-list"]) =>',
+        '  `${page.title}${page.space ? ` (${page.space})` : ""}${page.url ? `\\n${page.url}` : ""}`;',
+        "",
+        "/** One child of a Confluence page: its title, its type in brackets when it isn't",
+        " * a page (a folder, a whiteboard), and its link on its own line when it has one. */",
+        'const confluenceChildLine = (child: ConfluenceDisplays["child-pages"]) =>',
+        '  `${child.title}${child.type && child.type !== "page" ? ` [${child.type}]` : ""}${child.url ? `\\n${child.url}` : ""}`;',
+      ].join("\n"),
+      rules: [
+        '"page-list": { item: confluencePageLine, empty: (t) => t("app.confluence.no-pages") },',
+        '"child-pages": { item: confluenceChildLine, empty: (t) => t("app.confluence.no-children") },',
+      ],
+      messages: { "app.confluence.no-pages": "No matching pages.", "app.confluence.no-children": "This page has no child pages." },
+    },
+  },
   {
     id: "static",
     kind: "directory",