@microteia/console 2.35.0 → 2.36.0

package/CONSOLE-VERSIONS.md

@@ -22,6 +22,11 @@
 - fix(command): what was broken, and what it did to whoever hit it.
 -->
 
+#### [2.36.0] — 2026-11-05
+
+- fix(environment): every command that acts on an installation (`readEnvironment`) refuses when the installation's `CONSOLE-VERSIONS.md` names a Console newer than the one running. An older Console rewrites `microteia.yaml` with only the sections it knows and replaces `CONSOLE-VERSIONS.md` and `MICROTEIA.md` with its own texts — nothing failed: a forgotten copy of Console 2.6.0, left in a folder of the installation, ran `unpack` there, the `login:` block disappeared and the Console history lost thirty versions without a word. No new field marks it, on purpose: an older Console would drop the field it does not know.
+- feat(version): `microteia --version` still answers in that case, and says which Console last updated the installation.
+
 #### [2.35.0] — 2026-11-02
 
 - feat(publish): the releases repository README links to the official documentation (https://doc.microteia.com), and `publish` rewrites it whenever it differs from the current text — after the catalog, warning instead of failing. It was written only when seeding an empty repository, so the README of an existing one stayed frozen at the text of its first `publish` and no change to it ever arrived. `publish --dry-run` says when it would be rewritten.

package/README.md

@@ -1,4 +1,4 @@
-# Microteia Console 2.35.0
+# Microteia Console 2.36.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/environment.d.ts

@@ -73,6 +73,28 @@ export interface Environment {
 export declare const ENVIRONMENT_FILE = "microteia.yaml";
 export declare const parseEnvironment: (source: string) => Environment;
 export declare const serializeEnvironment: (environment: Environment) => string;
+/**
+ * O Console que deixou esta instalação como ela está, quando ele é MAIS NOVO que o que está rodando.
+ *
+ * O sinal é o topo do `CONSOLE-VERSIONS.md` da raiz, que o `unpack` sobrepõe com o histórico do próprio
+ * binário — é, portanto, o último Console que trocou o kernel ali. Nenhum campo novo foi inventado para
+ * isso, e é deliberado: um Console antigo apagaria o campo que ele não conhece, que é o defeito inteiro.
+ *
+ * Sem o arquivo (instalação anterior a ele, ou apagado) não há o que comparar, e nada é recusado.
+ */
+export declare const newerConsoleThanThis: (root: string) => Promise<string | null>;
+/**
+ * Lê o `microteia.yaml` — e RECUSA quando um Console mais novo já passou por aqui.
+ *
+ * Um Console antigo reescreve este arquivo só com as seções que conhece, e sobrepõe o
+ * `CONSOLE-VERSIONS.md` e o `MICROTEIA.md` com os textos dele. Nada disso falha: a configuração que ele
+ * não conhece some, e o histórico volta meses, em silêncio. Foi o que aconteceu quando uma cópia
+ * esquecida do Console, numa pasta da instalação, rodou o `unpack` — o bloco `login:` desapareceu, e o
+ * histórico do Console perdeu trinta versões.
+ *
+ * A recusa fica aqui porque este é o primeiro passo de todo comando que AGE sobre a instalação, antes de
+ * qualquer escrita. O `--version` lê o arquivo por outro caminho, e continua respondendo.
+ */
 export declare const readEnvironment: (path: string) => Promise<Environment>;
 export declare const writeEnvironment: (path: string, environment: Environment) => Promise<void>;
 export declare const slug: (value: string) => string;

package/lib/console/environment.js

@@ -1,4 +1,8 @@
 import { readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { compareVersions } from '../kernel/manifest.js';
+import { CLI_VERSION } from '../shared/paths.js';
+import { CONSOLE_CHANGELOG, changelogVersions } from '../vendor/changelogs.js';
 export const ENVIRONMENT_FILE = 'microteia.yaml';
 /**
  * O YAML aqui é um SUBCONJUNTO deliberado: mapas de dois níveis com valores escalares, que é a forma
@@ -140,9 +144,36 @@ login:
   # To USE an extension inside the organization, install it from the Extensions screen instead.
   extensions: ${quote(environment.login.extensions)}
 `;
+/**
+ * O Console que deixou esta instalação como ela está, quando ele é MAIS NOVO que o que está rodando.
+ *
+ * O sinal é o topo do `CONSOLE-VERSIONS.md` da raiz, que o `unpack` sobrepõe com o histórico do próprio
+ * binário — é, portanto, o último Console que trocou o kernel ali. Nenhum campo novo foi inventado para
+ * isso, e é deliberado: um Console antigo apagaria o campo que ele não conhece, que é o defeito inteiro.
+ *
+ * Sem o arquivo (instalação anterior a ele, ou apagado) não há o que comparar, e nada é recusado.
+ */
+export const newerConsoleThanThis = async (root) => {
+    const contents = await readFile(join(root, CONSOLE_CHANGELOG), 'utf8').catch(() => null);
+    const latest = contents === null ? undefined : changelogVersions(contents)[0];
+    return latest !== undefined && compareVersions(latest, CLI_VERSION) > 0 ? latest : null;
+};
+/**
+ * Lê o `microteia.yaml` — e RECUSA quando um Console mais novo já passou por aqui.
+ *
+ * Um Console antigo reescreve este arquivo só com as seções que conhece, e sobrepõe o
+ * `CONSOLE-VERSIONS.md` e o `MICROTEIA.md` com os textos dele. Nada disso falha: a configuração que ele
+ * não conhece some, e o histórico volta meses, em silêncio. Foi o que aconteceu quando uma cópia
+ * esquecida do Console, numa pasta da instalação, rodou o `unpack` — o bloco `login:` desapareceu, e o
+ * histórico do Console perdeu trinta versões.
+ *
+ * A recusa fica aqui porque este é o primeiro passo de todo comando que AGE sobre a instalação, antes de
+ * qualquer escrita. O `--version` lê o arquivo por outro caminho, e continua respondendo.
+ */
 export const readEnvironment = async (path) => {
+    let environment;
     try {
-        return parseEnvironment(await readFile(path, 'utf8'));
+        environment = parseEnvironment(await readFile(path, 'utf8'));
     }
     catch (error) {
         if (error.code === 'ENOENT') {
@@ -150,6 +181,14 @@ export const readEnvironment = async (path) => {
         }
         throw error;
     }
+    const newer = await newerConsoleThanThis(dirname(path));
+    if (newer !== null) {
+        throw new Error(`This installation was last updated by Microteia Console ${newer}, and this is ${CLI_VERSION}.\n`
+            + `An older Console rewrites ${ENVIRONMENT_FILE} without the settings it does not know, and replaces\n`
+            + `${CONSOLE_CHANGELOG} with an older history, so it stops here. Update it with "npm i -g @microteia/console",\n`
+            + 'and check that the "microteia" you ran is that one, not a copy left in a folder.');
+    }
+    return environment;
 };
 export const writeEnvironment = async (path, environment) => {
     await writeFile(path, serializeEnvironment(environment));

package/lib/console/versions.js

@@ -1,7 +1,7 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { CLI_VERSION } from '../shared/paths.js';
-import { ENVIRONMENT_FILE, parseEnvironment } from './environment.js';
+import { ENVIRONMENT_FILE, newerConsoleThanThis, parseEnvironment } from './environment.js';
 import { installPath } from './unpack.js';
 /**
  * O que `microteia --version` responde.
@@ -59,6 +59,15 @@ export const versionReport = async (directory, newer) => {
         lines.push('');
         lines.push(`${inPlace} is in place and ${deployed} is what the project runs. "microteia deploy" publishes it.`);
     }
+    /**
+     * É a pergunta que se faz quando um comando recusa por isto — e a resposta tem de estar aqui, porque
+     * o `--version` é o único que continua rodando com o Console velho.
+     */
+    const newerConsole = await newerConsoleThanThis(directory);
+    if (newerConsole !== null) {
+        lines.push('');
+        lines.push(`Console ${newerConsole} last updated this installation. This one is older and will not act on it.`);
+    }
     /**
      * E o que o canal oferece, quando há canal alcançável. Vem por último porque é a única linha que
      * depende de rede: se ela faltar, tudo acima continua sendo a resposta inteira.

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.35.0";
+export declare const CLI_VERSION = "2.36.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.35.0';
+export const CLI_VERSION = '2.36.0';

package/package.json

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