@remarkkpt/foundry-installer 0.1.0 → 0.1.1

package/README.md

@@ -10,13 +10,13 @@ Num terminal do macOS, executa (precisa do Node/npm):
 npx @remarkkpt/foundry-installer
 ```
 
-Se o Mac ainda não tem Node/npm, usa esta alternativa:
+Alternativa preparada para Macs sem Node/npm, só após publicar 0.1.1:
 
 ```sh
-installer="$(curl -fsSL https://unpkg.com/@remarkkpt/foundry-installer@0.1.0/install.sh)" && /bin/bash -c "$installer"
+installer="$(curl -fsSL https://unpkg.com/@remarkkpt/foundry-installer@0.1.1/install.sh)" && /bin/bash -c "$installer"
 ```
 
-A alternativa `curl` não exige Node/npm para arrancar. Mantém-se `@0.1.0`
+A alternativa `curl` não exige Node/npm para arrancar. Mantém-se `@0.1.1`
 para executar o script desta versão, sem mudar para futuras versões automaticamente.
 
 O instalador oferece preparar os
@@ -31,8 +31,14 @@ confirmação; o conteúdo existente é preservado. Uma instalação adequada é
 reutilizada. Falhas de descarga/instalação preservam a versão ativa anterior.
 O prefixo npm anteriormente documentado em `~/.local/share/foundry/node_modules`
 também é reutilizado: os seus ficheiros são conferidos contra o pacote da release
-com SHA-256 validado e o comando existente é conservado. Se divergirem, a cópia é
-preservada e a instalação pára com uma explicação, sem criar outra instalação.
+com SHA-256 validado e o comando existente é conservado. O launcher documentado anterior é reconhecido pelo conteúdo integral. Se a versão
+for diferente, o instalador explica e pede confirmação para atualizar. Só depois
+de verificar a nova CLI move o prefixo anterior para
+`~/.local/share/foundry/backups/legacy-…`, juntamente com o launcher, e indica
+o backup. Recusar preserva tudo. Se a ativação falhar antes de o novo comando ficar ativo, o instalador tenta repor o prefixo e o comando anteriores. Se o prefixo for reposto, regressa à localização original; caso contrário, permanece no backup indicado. Depois de o novo comando ficar ativo, não há restauro automático e o backup é conservado.
+Com o launcher documentado, também se oferece atualização confirmada quando
+os ficheiros diferem apesar de terem o mesmo número de versão. Sem esse launcher,
+a mesma versão divergente é preservada e recusada para conferência manual.
 
 Este pacote não contém credenciais nem publica código. O acesso à Foundry
 continua limitado aos convidados do repositório privado.

package/install.sh

@@ -52,13 +52,26 @@ version=0.1.0-alpha.1
 tag="v$version"
 base="$HOME/.local/share/foundry"
 bin="$HOME/.local/bin"
-for item in "$HOME/.local" "$HOME/.local/share" "$base" "$base/versions" "$bin"; do
+for item in "$HOME/.local" "$HOME/.local/share" "$base" "$base/versions" "$base/backups" "$bin"; do
   [[ ! -L "$item" ]] || fail "Destino simbólico inesperado: $item. Nenhuma instalação substituída."
 done
 mkdir -p "$base/versions" "$bin"
 launcher="$bin/foundry"
+legacy_launcher=false
+if [[ -f "$launcher" && ! -L "$launcher" ]]; then
+  # Recognize the complete documented 17/10 launcher, scoped to this HOME.
+  # A comment or a substring alone must never authorize replacing a command.
+  if node - "$launcher" "$HOME" <<'JS'
+const fs = require('node:fs');
+const expected = '#!/bin/sh\n# Foundry uses Node 24 without changing the default Node for other tools.\nPATH="/opt/homebrew/opt/node@24/bin:$PATH"\nexport PATH\nexec /opt/homebrew/opt/node@24/bin/node ' + process.argv[3] + '/.local/share/foundry/node_modules/@remarkkpt/foundry/dist/cli.js "$@"\n';
+process.exit(fs.readFileSync(process.argv[2], 'utf8') === expected ? 0 : 1);
+JS
+  then legacy_launcher=true; fi
+fi
 if [[ -e "$launcher" || -L "$launcher" ]]; then
-  [[ -f "$launcher" && ! -L "$launcher" ]] && grep -qx '# Foundry bootstrap launcher v1' "$launcher" || fail 'Já existe outro comando em ~/.local/bin/foundry; foi preservado.'
+  if [[ "$legacy_launcher" != true ]]; then
+    [[ -f "$launcher" && ! -L "$launcher" ]] && grep -qx '# Foundry bootstrap launcher v1' "$launcher" || fail 'Já existe outro comando em ~/.local/bin/foundry; foi preservado. Confira esse comando e guarde-o noutro local antes de repetir o instalador.'
+  fi
 fi
 work=$(mktemp -d "$base/versions/.prepare-XXXXXXXX")
 printf 'A conferir a versão privada %s…\n' "$tag"
@@ -72,7 +85,9 @@ JS
 ) || fail 'O manifesto da versão não tem identidade válida; instalação recusada.'
 read -r commit digest <<< "$metadata"
 download_package() {
-  gh release download "$tag" --repo "$repository" --pattern foundry.tgz --dir "$work" || fail 'A descarga falhou; a instalação anterior foi preservada.'
+  if [[ ! -f "$work/foundry.tgz" ]]; then
+    gh release download "$tag" --repo "$repository" --pattern foundry.tgz --dir "$work" || fail 'A descarga falhou; a instalação anterior foi preservada.'
+  fi
   local actual
   actual=$(/usr/bin/shasum -a 256 "$work/foundry.tgz"); actual=${actual%% *}
   [[ "$actual" == "$digest" ]] || fail 'SHA-256 divergente; instalação recusada. A versão anterior foi preservada.'
@@ -81,9 +96,37 @@ download_package() {
 # installed files against the identified artifact rather than trusting version.
 legacy="$base/node_modules/@remarkkpt/foundry"
 reuse_legacy=false
+update_legacy=false
+legacy_backup=
+legacy_moved=false
+restore_legacy() {
+  local status=$?
+  if [[ "$status" != 0 && "$legacy_moved" == true ]]; then
+    if mv "$legacy_backup/node_modules" "$base/node_modules"; then
+      if [[ -f "$legacy_backup/foundry" ]]; then cp -p "$legacy_backup/foundry" "$launcher"; fi
+      printf 'A instalação anterior foi reposta; backup: %s\n' "$legacy_backup" >&2
+    else printf 'A instalação anterior está no backup: %s. Reponha node_modules antes de repetir.\n' "$legacy_backup" >&2; fi
+  fi
+}
+trap restore_legacy EXIT
 if [[ -e "$legacy" || -L "$legacy" ]]; then
   download_package
   /usr/bin/tar -xzf "$work/foundry.tgz" -C "$work" || fail 'Não foi possível conferir o pacote; a instalação anterior foi preservada.'
+  legacy_version=$(node - "$legacy" <<'JS'
+const fs = require('node:fs'), path = require('node:path');
+for (let dir = process.argv[2]; dir !== path.dirname(dir); dir = path.dirname(dir)) {
+  if (fs.lstatSync(dir).isSymbolicLink()) throw Error('Symbolic package directory');
+}
+const pkg = JSON.parse(fs.readFileSync(path.join(process.argv[2], 'package.json')));
+if (pkg.name !== '@remarkkpt/foundry' || !/^[0-9]+\.[0-9]+\.[0-9]+(?:-[a-zA-Z0-9.-]+)?$/.test(pkg.version)) throw Error('Invalid previous package');
+console.log(pkg.version);
+JS
+  ) || fail 'Não foi possível identificar a instalação anterior; foi preservada. Confira o pacote antes de repetir.'
+  if [[ "$legacy_version" != "$version" ]]; then
+    printf 'A Foundry anterior é a versão %s; a versão preparada é %s. A atualização guarda a anterior num backup identificado.\n' "$legacy_version" "$version"
+    confirm "Atualizar Foundry para $version, guardando a instalação anterior?" || fail 'Atualização cancelada; instalação e comando anteriores preservados.'
+    update_legacy=true
+  else
   if ! node - "$work/package" "$legacy" "$version" "$base/node_modules/.bin/foundry" <<'JS'
 const fs = require('node:fs'), path = require('node:path');
 const [expected, installed, version, executable] = process.argv.slice(2);
@@ -106,16 +149,27 @@ compare();
 if (fs.realpathSync(executable) !== path.join(installed, 'dist/cli.js')) throw Error('Command points elsewhere');
 fs.accessSync(executable, fs.constants.X_OK);
 JS
-  then fail 'A instalação anterior não corresponde à versão preparada; foi preservada. Confira-a antes de voltar a instalar.'; fi
-  "$node_executable" "$legacy/dist/cli.js" --help >/dev/null 2>&1 || fail 'A instalação anterior não arranca; foi preservada. Confira-a antes de voltar a instalar.'
-  reuse_legacy=true
-  printf 'A instalação adequada desta versão foi preservada no prefixo npm anterior.\n'
+  then
+    if [[ "$legacy_launcher" == true ]]; then
+      printf 'A instalação anterior tem a mesma versão, mas difere da versão preparada. A atualização guarda os ficheiros anteriores num backup identificado.\n'
+      confirm "Atualizar Foundry para $version, guardando a instalação anterior?" || fail 'Atualização cancelada; instalação e comando anteriores preservados.'
+      update_legacy=true
+    else fail 'A instalação anterior não corresponde à versão preparada; foi preservada. Confira-a antes de voltar a instalar.'; fi
+  else
+    "$node_executable" "$legacy/dist/cli.js" --help >/dev/null 2>&1 || fail 'A instalação anterior não arranca; foi preservada. Confira-a antes de voltar a instalar.'
+    reuse_legacy=true
+    printf 'A instalação adequada desta versão foi preservada no prefixo npm anterior.\n'
+  fi
+  fi
 fi
+if [[ "$legacy_launcher" == true && ! -d "$legacy" ]]; then fail 'O launcher anterior foi reconhecido, mas falta o pacote. Reponha a instalação anterior ou guarde o launcher antes de repetir.'; fi
 target="$base/versions/$digest"
 adequate=false
 if [[ "$reuse_legacy" == true ]]; then
-  bin="$base/node_modules/.bin"
-  launcher="$bin/foundry"
+  if [[ "$legacy_launcher" != true ]]; then
+    bin="$base/node_modules/.bin"
+    launcher="$bin/foundry"
+  fi
 else
 if [[ -d "$target" && ! -L "$target" && -f "$target/receipt.json" ]]; then
   if node - "$target/receipt.json" "$commit" "$digest" <<'JS'
@@ -128,7 +182,9 @@ JS
 fi
 if [[ "$adequate" == false ]]; then
   [[ ! -e "$target" && ! -L "$target" ]] || fail 'A cópia desta versão não passou a verificação; foi preservada para inspeção.'
-  confirm "Instalar Foundry $version (commit $commit) uma vez neste Mac?" || fail 'Instalação cancelada.'
+  if [[ "$update_legacy" != true ]]; then
+    confirm "Instalar Foundry $version (commit $commit) uma vez neste Mac?" || fail 'Instalação cancelada.'
+  fi
   download_package
   npm install --prefix "$work" --offline --ignore-scripts --no-save --no-audit --no-fund "$work/foundry.tgz" || fail 'A instalação falhou; a versão anterior foi preservada.'
   node - "$work/node_modules/@remarkkpt/foundry/package.json" "$version" <<'JS'
@@ -143,6 +199,17 @@ JS
 else
   printf 'A instalação adequada desta versão foi preservada.\n'
 fi
+# Move the old prefix only after the new CLI passed all checks. The EXIT trap
+# restores it if activation fails. Backups are never followed through a symlink.
+if [[ "$update_legacy" == true ]]; then
+  [[ ! -L "$base/backups" ]] || fail 'Destino de backup simbólico; instalação anterior preservada.'
+  mkdir -p "$base/backups"
+  legacy_backup=$(mktemp -d "$base/backups/legacy-XXXXXXXX")
+  if [[ -f "$launcher" ]]; then cp -p "$launcher" "$legacy_backup/foundry"; fi
+  mv "$base/node_modules" "$legacy_backup/node_modules"
+  legacy_moved=true
+  printf 'Backup da instalação anterior: %s\n' "$legacy_backup"
+fi
 # Atomic pointer replacement leaves the previous version untouched on failure.
 node - "$base" "$target" <<'JS'
 const fs = require('node:fs'), path = require('node:path');
@@ -154,6 +221,7 @@ JS
 } > "$bin/.foundry-$$"
 chmod 755 "$bin/.foundry-$$"
 mv -f "$bin/.foundry-$$" "$launcher"
+legacy_moved=false
 fi
 case ":$PATH:" in
   *":$bin:"*) ;;
@@ -166,7 +234,7 @@ case ":$PATH:" in
     esac
     [[ ! -L "$profile" ]] || fail 'O perfil da shell é um link simbólico; foi preservado.'
     line='export PATH="$HOME/.local/bin:$PATH" # Foundry bootstrap'
-    if [[ "$reuse_legacy" == true ]]; then line='export PATH="$HOME/.local/share/foundry/node_modules/.bin:$PATH" # Foundry bootstrap'; fi
+    if [[ "$reuse_legacy" == true && "$legacy_launcher" != true ]]; then line='export PATH="$HOME/.local/share/foundry/node_modules/.bin:$PATH" # Foundry bootstrap'; fi
     if ! grep -Fqx "$line" "$profile" 2>/dev/null; then printf '\n%s\n' "$line" >> "$profile"; fi
     ;;
 esac

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remarkkpt/foundry-installer",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Minimal macOS bootstrap for the private Foundry distribution",
   "license": "UNLICENSED",
   "bin": { "foundry-installer": "install.sh" },