@microteia/console 2.28.1 → 2.29.0

package/CONSOLE-VERSIONS.md

@@ -22,6 +22,10 @@
 - fix(command): what was broken, and what it did to whoever hit it.
 -->
 
+#### [2.29.0] — 2026-10-15
+
+- feat(export-catalog): each installed extension now carries `navGroups` — the sidebar groups it declares, by key, with the name resolved in every language the package ships and its order. The authoring tools list them in `microteia://nav-groups`, so an extension joins an existing group instead of drawing a second one with the same title. Always written, even empty; a snapshot taken by an older Console is read as "groups unknown".
+
 #### [2.28.1] — 2026-10-14
 
 - fix(console/deploy): a function whose source declares `retry: true` is no longer refused on its first deploy. Without a terminal the Firebase CLI does not ask "Would you like to proceed with deployment?" — it aborts with "Pass the --force option to deploy functions with a failure policy", so `runAggregateBackfill` and `runRecordKeyAdoption` never went up through `microteia deploy` or `provision`. That one function is now redeployed with `--force`, and only when the project is known to hold no copy of it in another region: the same flag would delete that copy without asking, which stays a `--prune` decision. When a copy stands or the project could not be listed, the refusal is terminal and the hint points to `microteia deploy --prune`.

package/README.md

@@ -1,4 +1,4 @@
-# Microteia Console 2.28.1
+# Microteia Console 2.29.0
 
 Installs and updates Microteia in a Firebase project you own. It has no npm dependencies of its own —
 what it needs are command-line tools that are already on the machine, listed at the bottom.

package/lib/console/exportCatalog.d.ts

@@ -98,6 +98,20 @@ export interface CatalogExtensionExportedArtifact {
     kind: 'workflow' | 'action' | 'script' | 'unknown';
     name: string;
 }
+/**
+ * Um grupo da barra lateral que a extensão declara (`ui.nav.group`). Viaja porque a CHAVE é contrato:
+ * é o que outra extensão escreve para entrar no grupo, e quem autora sem enxergá-la inventa outra — e
+ * o menu passa a mostrar dois grupos com o mesmo nome.
+ *
+ * O nome vai resolvido em cada idioma que o próprio pacote traz, porque é pelo nome que o autor
+ * reconhece o grupo; o rótulo literal vai como está, com `translations` vazio.
+ */
+export interface CatalogExtensionNavGroup {
+    key: string;
+    label: string;
+    translations: Record<string, string>;
+    order: number;
+}
 export interface CatalogExtensionExport {
     id: string;
     name: string;
@@ -108,6 +122,8 @@ export interface CatalogExtensionExport {
      * a chave ausente é o silêncio de um Console anterior a este campo, e o kernel distingue as duas.
      */
     exports: CatalogExtensionExportedArtifact[];
+    /** Sempre escrita, mesmo vazia, pela mesma razão de `exports`. */
+    navGroups: CatalogExtensionNavGroup[];
 }
 export interface CatalogExport {
     version: number;

package/lib/console/exportCatalog.js

@@ -78,6 +78,54 @@ const exportedArtifacts = (extension) => {
         .map((id) => named.get(id) ?? { id, kind: 'unknown', name: id })
         .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
 };
+const NAV_GROUP_POINT = 'ui.nav.group';
+const MESSAGES_POINT = 'i18n.messages';
+const DEFAULT_LOCALE = 'en';
+const MESSAGE_REFERENCE = /^@([a-z0-9.-]+)\/(.+)$/;
+/**
+ * Os grupos da barra lateral de uma cópia instalada, com o nome resolvido pelos `i18n.messages` do
+ * próprio manifesto. É a mesma leitura que `declaredNavGroupsOf` faz no kernel, repetida porque o
+ * Console não alcança `src/` — e é o teste que atravessa a fronteira que confere as duas.
+ */
+const navGroupsOf = (extension) => {
+    const contributes = Array.isArray(extension.manifest?.contributes) ? extension.manifest.contributes : [];
+    const contributions = contributes.map(asRecord).filter((one) => one !== undefined);
+    const bundles = contributions
+        .filter((one) => one.point === MESSAGES_POINT)
+        .map((one) => asRecord(one.metadata))
+        .filter((one) => one !== undefined);
+    const translationsOf = (label) => {
+        const match = MESSAGE_REFERENCE.exec(label);
+        if (!match)
+            return {};
+        const found = {};
+        for (const bundle of bundles) {
+            const locale = text(bundle.locale);
+            const message = asRecord(bundle.messages)?.[match[2]];
+            if (bundle.namespace !== match[1] || locale === undefined || typeof message !== 'string' || message.trim() === '')
+                continue;
+            if (found[locale] === undefined)
+                found[locale] = message;
+        }
+        return found;
+    };
+    return contributions
+        .filter((one) => one.point === NAV_GROUP_POINT)
+        .flatMap((one) => {
+        const metadata = asRecord(one.metadata) ?? {};
+        const key = text(metadata.key)?.trim();
+        if (key === undefined)
+            return [];
+        const raw = text(metadata.label) ?? key;
+        const translations = translationsOf(raw);
+        return [{
+                key,
+                label: translations[DEFAULT_LOCALE] ?? Object.values(translations)[0] ?? raw,
+                translations,
+                order: typeof metadata.order === 'number' ? metadata.order : 0,
+            }];
+    });
+};
 /**
  * A mesma dedução que a aplicação faz ao ler a tela (`screenDefinitionMapper.ts`): o `origin` gravado
  * quando ele existe, senão `plugin` para quem tem dono e `design` para o que o escritório criou. Ela é
@@ -174,6 +222,7 @@ export const buildCatalogExport = (input) => ({
         version: one.version,
         active: one.active,
         exports: exportedArtifacts(one),
+        navGroups: navGroupsOf(one),
     }))
         .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)),
     screens: input.screens
@@ -293,6 +342,8 @@ export const exportCatalog = async (args) => {
         + `the rest the office built itself.`);
     const exported = document.extensions.reduce((total, one) => total + one.exports.length, 0);
     info(`  ${exported} artifact(s) are declared for other extensions to reference as <extension-id>/<id>.`);
+    const groups = document.extensions.reduce((total, one) => total + one.navGroups.length, 0);
+    info(`  ${groups} sidebar group(s) are declared, by key, for other extensions to join.`);
     blank();
     await checkIgnored(directory);
     info('It is a SNAPSHOT, and it says so: the authoring tools report when it was taken and warn when it');

package/lib/shared/paths.d.ts

@@ -87,4 +87,4 @@ export declare const consoleRoot: string;
  * de código nunca chegou a quem instala. Este bloco fica sendo o que ele já era antes de crescer: a
  * política de semver da ferramenta, mais o registro do que motivou as versões até a `2.5.0`.
  */
-export declare const CLI_VERSION = "2.28.1";
+export declare const CLI_VERSION = "2.29.0";

package/lib/shared/paths.js

@@ -94,4 +94,4 @@ export const consoleRoot = resolve(here, '..', '..');
  * de código nunca chegou a quem instala. Este bloco fica sendo o que ele já era antes de crescer: a
  * política de semver da ferramenta, mais o registro do que motivou as versões até a `2.5.0`.
  */
-export const CLI_VERSION = '2.28.1';
+export const CLI_VERSION = '2.29.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microteia/console",
-  "version": "2.28.1",
+  "version": "2.29.0",
   "description": "Install and update Microteia in a Firebase project you own.",
   "license": "UNLICENSED",
   "type": "module",