@microteia/console 2.19.0 → 2.20.0

package/CONSOLE-VERSIONS.md

@@ -22,6 +22,12 @@
 - fix(command): what was broken, and what it did to whoever hit it.
 -->
 
+#### [2.20.0] — 2026-09-01
+
+- feat(cli/export-catalog): the snapshot carries what each installed extension declares in `manifest.exports` — the artifacts another extension may reference as `<extension-id>/<source-id>`. Whoever authors outside the office knew an extension was installed and had no way to learn the name of anything inside it, so the reference could be written by hand and never discovered. Each entry carries the id, the artifact's name, and its `kind`, which is the part that decides where the reference fits: a script goes in `scriptId`, an automation in `targetWorkflowId`. What the artifact DOES still never travels — the steps and the code are behaviour, and the snapshot is shape.
+- feat(cli/export-catalog): a declared export that matches no artifact in the package travels as `unknown` rather than being dropped. The install gate checks the LIST, so a reference to it would be accepted there and fail only on the step's first run; saying it is better than hiding it.
+- feat(cli/export-catalog): `exports` is written for every extension, empty list included. A present-and-empty list is the answer "this extension exports nothing"; an absent key is the silence of a Console older than the field, and the kernel tells the two apart instead of reading absence as a claim.
+
 #### [2.19.0] — 2026-08-28
 
 - fix(cli/deploy): the installation gate is charged against the functions that are GOING UP, not against every source found on disk. It lived in `functionProblems` — the door that answers "can this set be assembled?" — and that door reads every `extensions/<x>/functions/` directory that exists, including one left behind by an extension that was uninstalled and removed. The result was `microteia deploy` refusing in full — hosting, rules and indexes with it — over a callable no command would have deployed. `gateProblems` now carries the function's name, and `gateProblemsFor` filters by what is being deployed.

package/README.md

@@ -1,4 +1,4 @@
-# Microteia Console 2.19.0
+# Microteia Console 2.20.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

@@ -76,11 +76,33 @@ export interface CatalogListExport {
     label: string;
     ownerPluginId?: string;
 }
+/**
+ * Um artefato que a extensão declara em `manifest.exports` — a superfície que outra extensão pode
+ * referenciar como `<pluginId>/<sourceId>`.
+ *
+ * O `kind` viaja porque é ele que decide ONDE a referência cabe: script em `scriptId`, automação em
+ * `targetWorkflowId`. `unknown` é o export declarado que não casa com artefato nenhum do pacote —
+ * dizê-lo é melhor que omiti-lo, porque uma referência a ele passaria no portão da instalação, que
+ * confere a LISTA, e falharia só na primeira execução.
+ *
+ * O que NÃO viaja é o que o artefato faz: os passos e o código são comportamento, e o retrato é
+ * esquema. O nome e o tipo são contrato.
+ */
+export interface CatalogExtensionExportedArtifact {
+    id: string;
+    kind: 'workflow' | 'action' | 'script' | 'unknown';
+    name: string;
+}
 export interface CatalogExtensionExport {
     id: string;
     name: string;
     version: string;
     active: boolean;
+    /**
+     * Sempre escrita, mesmo vazia. É a lista PRESENTE e vazia que diz "esta extensão não exporta nada";
+     * a chave ausente é o silêncio de um Console anterior a este campo, e o kernel distingue as duas.
+     */
+    exports: CatalogExtensionExportedArtifact[];
 }
 export interface CatalogExport {
     version: number;

package/lib/console/exportCatalog.js

@@ -46,6 +46,38 @@ const asRecord = (value) => (typeof value === 'object' && value !== null && !Arr
     ? value
     : undefined);
 const FIELD_ORIGINS = ['builtin', 'plugin', 'design'];
+/**
+ * A superfície exportada de uma cópia instalada: os ids de `manifest.exports`, cada um casado com o
+ * artefato do pacote que o atende, para ganhar tipo e nome.
+ *
+ * O Console não alcança `src/` — logo não há `MarketplacePlugin` tipado aqui, e a leitura é do
+ * documento cru, como todo o resto deste arquivo. Um export que não casa com nada continua na lista
+ * como `unknown`: a extensão está declarando algo que não entrega, e esconder isso do autor apenas
+ * adia a descoberta para a primeira execução.
+ */
+const exportedArtifacts = (extension) => {
+    const declared = extension.manifest?.exports;
+    if (!Array.isArray(declared))
+        return [];
+    const pkg = asRecord(extension.data.package) ?? {};
+    const named = new Map();
+    const collect = (raw, kind) => {
+        for (const one of Array.isArray(raw) ? raw : []) {
+            const record = asRecord(one);
+            const id = text(record?.templateId);
+            if (id === undefined || named.has(id))
+                continue;
+            named.set(id, { id, kind, name: text(record?.name) ?? text(record?.title) ?? id });
+        }
+    };
+    collect(pkg.workflows, 'workflow');
+    collect(pkg.actions, 'action');
+    collect(pkg.scripts, 'script');
+    return declared
+        .filter((id) => typeof id === 'string' && id !== '')
+        .map((id) => named.get(id) ?? { id, kind: 'unknown', name: id })
+        .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 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 é
@@ -135,7 +167,13 @@ export const buildCatalogExport = (input) => ({
     kernelVersion: input.kernelVersion,
     consoleVersion: CLI_VERSION,
     extensions: input.extensions
-        .map((one) => ({ id: one.id, name: one.name, version: one.version, active: one.active }))
+        .map((one) => ({
+        id: one.id,
+        name: one.name,
+        version: one.version,
+        active: one.active,
+        exports: exportedArtifacts(one),
+    }))
         .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)),
     screens: input.screens
         .filter((document) => document.data.enabled !== false)
@@ -252,13 +290,16 @@ export const exportCatalog = async (args) => {
         + `${document.lookups.length} list(s), ${document.tagLists.length} tag list(s)`);
     info(`  ${fromExtensions} screen(s) come from the ${document.extensions.length} installed extension(s); `
         + `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>.`);
     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');
     info('is old. Nothing keeps it in step with the office — run this again after screens change there.');
     blank();
     info('What it deliberately leaves out: records, the values inside a list of options or a tag list,');
-    info('members and permissions, workflows, scripts, actions, secrets and settings. It describes what');
-    info('the entities ARE, and nothing an office typed into them.');
+    info('members and permissions, what a workflow, script or action DOES, secrets and settings. It');
+    info('describes what the entities ARE, and nothing an office typed into them. What each extension');
+    info('declares in "exports" travels: that is the surface another extension may reference.');
     blank();
 };

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.19.0";
+export declare const CLI_VERSION = "2.20.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.19.0';
+export const CLI_VERSION = '2.20.0';

package/package.json

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