@piecemaker-legal/piecemaker 1.0.0

package/scripts/piecemaker/cli/piecemaker.mjs

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+
+import { APP, APP_URL, PORTS } from './lib/config.mjs';
+import { installComponents } from './lib/composants.mjs';
+import { gitAvailable, resolveNodeRuntime } from './lib/node-runtime.mjs';
+import { freePort } from './lib/ports.mjs';
+import { ensureDependencies, ensureRepository, rebuildNativeModules } from './lib/repos.mjs';
+import { APP_LOG, appClientReachable, appServerReachable, startApplication } from './lib/services.mjs';
+import { installApplicationEntry, openApplication, verifyPwaAssets } from './lib/pwa.mjs';
+import { banner, blank, c, detail, fail, ok, step, warn } from './lib/ui.mjs';
+
+const report = { step, ok, warn, detail };
+
+const HELP = `${c.bold('piecemaker')} — installe, met à jour et lance toute la plateforme.
+
+  piecemaker                 tout faire : ports, dépôts, dépendances, PWA, serveurs
+  piecemaker --launch-only   ne relance que les serveurs manquants
+  piecemaker --no-open       ne pas ouvrir l application à la fin
+  piecemaker --help          cette aide
+`;
+
+function parseArguments(argv) {
+  return {
+    help: argv.includes('--help') || argv.includes('-h'),
+    launchOnly: argv.includes('--launch-only'),
+    open: !argv.includes('--no-open'),
+  };
+}
+
+async function cleanPorts(launchOnly) {
+  step('Libération des ports');
+  const targets = launchOnly
+    ? [PORTS.appServer, PORTS.appClient]
+    : [PORTS.appClient, PORTS.appServer];
+
+  for (const port of targets) {
+    const result = await freePort(port);
+    if (!result.released) {
+      warn(`port ${port} toujours occupé`);
+      continue;
+    }
+    if (result.killed.length > 0) detail(`port ${port} libéré (${result.killed.join(', ')})`);
+  }
+  ok('Ports disponibles');
+}
+
+async function synchroniseRepositories(runtime) {
+  if (!gitAvailable()) {
+    throw new Error('git est requis et introuvable.');
+  }
+
+  for (const repo of [APP]) {
+    const state = await ensureRepository(repo, runtime, report);
+    if (state.cloned) ok(`${repo.label} — installé`);
+    else if (state.updated) ok(`${repo.label} — mis à jour`);
+    else if (!state.offline && !state.dirty && !state.diverged) ok(`${repo.label} — déjà à jour`);
+
+    const dependencies = await ensureDependencies(repo, runtime, report, { force: state.cloned });
+    if (dependencies.installed) ok(`${repo.label} — dépendances installées`);
+  }
+
+  rebuildNativeModules(APP, runtime, report, ['better-sqlite3', 'node-pty']);
+}
+
+async function launchServices(runtime) {
+  const applicationAlreadyRunning = await appServerReachable() && await appClientReachable();
+
+  if (applicationAlreadyRunning) {
+    ok(`Application déjà active — ${APP_URL}`);
+    detail('socle laissé en l état : le routage des clients IA appartient à l application en cours');
+    return true;
+  }
+
+  const application = await startApplication(runtime, report);
+  if (application.alreadyRunning) {
+    ok(`Application déjà active — ${APP_URL}`);
+    return true;
+  }
+
+  if (!application.serverUp) {
+    fail(`Serveur applicatif injoignable sur le port ${PORTS.appServer}`);
+    detail(`journal : ${APP_LOG}`);
+    return false;
+  }
+  if (!application.clientUp) {
+    fail(`Client applicatif injoignable sur le port ${PORTS.appClient}`);
+    detail(`journal : ${APP_LOG}`);
+    return false;
+  }
+
+  ok(`Application active — serveur :${PORTS.appServer}, client ${APP_URL}`);
+  return true;
+}
+
+async function installPwa() {
+  const assets = await verifyPwaAssets();
+  if (!assets.manifestServed || !assets.serviceWorkerServed) {
+    warn('Ressources PWA incomplètes (manifest ou service worker non servis)');
+    return;
+  }
+
+  const entry = installApplicationEntry();
+  if (!entry.installed) {
+    warn(`PWA non installée sur le bureau : ${entry.reason}`);
+    detail(`l application reste accessible sur ${APP_URL}`);
+    return;
+  }
+
+  ok(`PWA installée — ${entry.location}`);
+  for (const location of entry.locations || []) {
+    if (location !== entry.location) detail(`également posé : ${location}`);
+  }
+  if (!entry.standalone) detail('navigateur Chromium absent : ouverture en onglet classique');
+  if (!entry.verified) warn('installation incomplète : un emplacement attendu est introuvable après coup');
+}
+
+async function main() {
+  const options = parseArguments(process.argv.slice(2));
+  if (options.help) {
+    process.stdout.write(HELP);
+    return 0;
+  }
+
+  banner('PieceMaker — plateforme juridique');
+
+  const runtime = resolveNodeRuntime();
+  detail(`Node ${runtime.version}`);
+
+  await cleanPorts(options.launchOnly);
+
+  if (!options.launchOnly) {
+    await synchroniseRepositories(runtime);
+    await installComponents(runtime, report);
+  }
+
+  const running = await launchServices(runtime);
+  if (!running) return 1;
+
+  if (!options.launchOnly) {
+    await installPwa();
+  }
+
+  blank();
+  ok(`Application  ${c.bold(APP_URL)}`);
+  detail('Configuration du socle : onglet Dossier › Configuration.');
+  blank();
+
+  if (options.open) openApplication();
+  return 0;
+}
+
+main()
+  .then((code) => {
+    process.exitCode = code;
+  })
+  .catch((error) => {
+    fail(error.message);
+    process.exitCode = 1;
+  });

package/scripts/piecemaker/cli/piecemaker.ps1

@@ -0,0 +1,63 @@
+#Requires -Version 5.1
+$ErrorActionPreference = 'Stop'
+
+$AppDir = if ($env:PIECEMAKER_APP_DIR) { $env:PIECEMAKER_APP_DIR } else { Join-Path $HOME 'Documents\GitHub\piecemaker-droit-francais' }
+$AppRemote = 'https://github.com/PieceMaker-Legal/piecemaker-droit-francais.git'
+$Entry = 'scripts/piecemaker/cli/piecemaker.mjs'
+$MinimumMajor = 20
+
+function Get-NodeMajor([string]$NodePath) {
+  try {
+    $version = & $NodePath -e 'process.stdout.write(String(process.versions.node.split(".")[0]))' 2>$null
+    return [int]$version
+  } catch {
+    return 0
+  }
+}
+
+function Resolve-NodeBinary {
+  $onPath = Get-Command node -ErrorAction SilentlyContinue
+  if ($onPath -and (Get-NodeMajor $onPath.Source) -ge $MinimumMajor) {
+    return $onPath.Source
+  }
+
+  $nvmRoot = if ($env:NVM_HOME) { $env:NVM_HOME } else { Join-Path $env:APPDATA 'nvm' }
+  if (Test-Path $nvmRoot) {
+    $candidates = Get-ChildItem $nvmRoot -Directory -Filter 'v*' -ErrorAction SilentlyContinue |
+      Sort-Object { [version]($_.Name.TrimStart('v')) } -Descending
+    foreach ($candidate in $candidates) {
+      $nodeExe = Join-Path $candidate.FullName 'node.exe'
+      if ((Test-Path $nodeExe) -and (Get-NodeMajor $nodeExe) -ge $MinimumMajor) {
+        return $nodeExe
+      }
+    }
+  }
+
+  return $null
+}
+
+$NodeBin = Resolve-NodeBinary
+if (-not $NodeBin) {
+  Write-Error "PieceMaker : Node $MinimumMajor ou plus recent est requis et introuvable."
+  exit 1
+}
+
+if (-not (Test-Path (Join-Path $AppDir '.git'))) {
+  if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+    Write-Error 'PieceMaker : git est requis pour installer le depot.'
+    exit 1
+  }
+  Write-Host "PieceMaker : installation du depot dans $AppDir"
+  New-Item -ItemType Directory -Force -Path (Split-Path $AppDir -Parent) | Out-Null
+  git clone --branch main $AppRemote $AppDir
+  if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+}
+
+$EntryPath = Join-Path $AppDir $Entry
+if (-not (Test-Path $EntryPath)) {
+  Write-Error "PieceMaker : $Entry est introuvable dans $AppDir.`nMettez le depot a jour (git -C `"$AppDir`" pull) puis relancez piecemaker."
+  exit 1
+}
+
+& $NodeBin $EntryPath @args
+exit $LASTEXITCODE

package/scripts/piecemaker/cli/piecemaker.sh

@@ -0,0 +1,60 @@
+#!/bin/sh
+set -eu
+
+APP_DIR="${PIECEMAKER_APP_DIR:-$HOME/Documents/GitHub/piecemaker-droit-francais}"
+APP_REMOTE="https://github.com/PieceMaker-Legal/piecemaker-droit-francais.git"
+ENTRY="scripts/piecemaker/cli/piecemaker.mjs"
+MINIMUM_MAJOR=20
+
+node_major() {
+  "$1" -e 'process.stdout.write(String(process.versions.node.split(".")[0]))' 2>/dev/null || echo 0
+}
+
+resolve_node() {
+  if command -v node >/dev/null 2>&1; then
+    candidate="$(command -v node)"
+    if [ "$(node_major "$candidate")" -ge "$MINIMUM_MAJOR" ]; then
+      printf '%s' "$candidate"
+      return 0
+    fi
+  fi
+
+  nvm_root="${NVM_DIR:-$HOME/.nvm}/versions/node"
+  if [ -d "$nvm_root" ]; then
+    for directory in $(ls -1 "$nvm_root" 2>/dev/null | sort -Vr); do
+      candidate="$nvm_root/$directory/bin/node"
+      if [ -x "$candidate" ] && [ "$(node_major "$candidate")" -ge "$MINIMUM_MAJOR" ]; then
+        printf '%s' "$candidate"
+        return 0
+      fi
+    done
+  fi
+
+  return 1
+}
+
+if ! NODE_BIN="$(resolve_node)"; then
+  printf 'PieceMaker : Node %s ou plus recent est requis et introuvable.\n' "$MINIMUM_MAJOR" >&2
+  exit 1
+fi
+
+if [ ! -d "$APP_DIR/.git" ]; then
+  if ! command -v git >/dev/null 2>&1; then
+    printf 'PieceMaker : git est requis pour installer le depot.\n' >&2
+    exit 1
+  fi
+  printf 'PieceMaker : installation du depot dans %s\n' "$APP_DIR"
+  mkdir -p "$(dirname "$APP_DIR")"
+  git clone --branch main "$APP_REMOTE" "$APP_DIR"
+fi
+
+if [ ! -f "$APP_DIR/$ENTRY" ]; then
+  printf 'PieceMaker : %s est introuvable dans %s.\n' "$ENTRY" "$APP_DIR" >&2
+  printf 'Mettez le depot a jour (git -C "%s" pull) puis relancez piecemaker.\n' "$APP_DIR" >&2
+  exit 1
+fi
+
+PATH="$(dirname "$NODE_BIN"):$PATH"
+export PATH
+
+exec "$NODE_BIN" "$APP_DIR/$ENTRY" "$@"

package/scripts/piecemaker/generate-i18n-overrides.mjs

@@ -0,0 +1,219 @@
+/**
+ * Generates the PieceMaker i18n override bundles.
+ *
+ * Upstream CloudCLI locale files under `src/modules/i18n/locales` are never edited.
+ * This script reads them, rewrites the wording PieceMaker needs (the workspace entity
+ * is a legal case file, and the product is PieceMaker, not CloudCLI) and writes only
+ * the leaf keys whose value actually changed into `src/piecemaker/i18n/overrides`.
+ *
+ * Re-run after pulling upstream translations:
+ *   node scripts/piecemaker/generate-i18n-overrides.mjs
+ */
+
+import { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '../..');
+const LOCALES_DIR = join(ROOT, 'src/modules/i18n/locales');
+const OUTPUT_DIR = join(ROOT, 'src/piecemaker/i18n/overrides');
+
+/** Brand rename applied to every locale before the per-locale rules run. */
+const BRAND_RULES = [
+  ['CloudCLI', 'PieceMaker'],
+  ['cloudcli', 'piecemaker'],
+];
+
+/** Leaf keys left untouched entirely: third-party names and literal commands. */
+const FROZEN_KEYS = new Set([
+  'settings:pluginSettings.prismCloudCLI.name',
+  'settings:pluginSettings.prismCloudCLI.description',
+  'common:versionUpdate.npmUpgradeCommand',
+]);
+
+/**
+ * Namespaces that keep the upstream wording: in TaskMaster's copy "project" means a
+ * software project (PRD, breaking work down, contributing upstream), not a case file.
+ * The brand rename still applies to them.
+ */
+const WORDING_EXCLUDED_NAMESPACES = new Set(['tasks']);
+
+/**
+ * Per-locale replacements, applied in order, so longer inflected forms win over the
+ * bare noun. Each entry is [search, replacement]; plain strings, replaced globally.
+ */
+const RULES = {
+  en: [
+    ['Projects', 'Cases'],
+    ['projects', 'cases'],
+    ['Project', 'Case'],
+    ['project', 'case'],
+  ],
+  fr: [
+    ['Projets', 'Dossiers'],
+    ['projets', 'dossiers'],
+    ['Projet', 'Dossier'],
+    ['projet', 'dossier'],
+  ],
+  es: [
+    ['Proyectos', 'Expedientes'],
+    ['proyectos', 'expedientes'],
+    ['Proyecto', 'Expediente'],
+    ['proyecto', 'expediente'],
+  ],
+  it: [
+    ['Progetti', 'Fascicoli'],
+    ['progetti', 'fascicoli'],
+    ['Progetto', 'Fascicolo'],
+    ['progetto', 'fascicolo'],
+  ],
+  de: [
+    // "das Dossier" is neuter like "das Projekt", so articles and adjectives stay correct.
+    ['Auf allen Projekten', 'In allen Dossiers'],
+    ['Projekten', 'Dossiers'],
+    ['Projektes', 'Dossiers'],
+    ['Projekts', 'Dossiers'],
+    ['Projekte', 'Dossiers'],
+    ['Projekt', 'Dossier'],
+    ['projekten', 'dossiers'],
+    ['projekte', 'dossiers'],
+    ['projekts', 'dossiers'],
+    ['projekt', 'dossier'],
+  ],
+  tr: [
+    ['Projelerde', 'Davalarda'],
+    ['Projelerin', 'Davaların'],
+    ['Projelere', 'Davalara'],
+    ['Projeleri', 'Davaları'],
+    ['Projeler', 'Davalar'],
+    ['Projeyi', 'Davayı'],
+    ['Projeye', 'Davaya'],
+    ['Projeni', 'Davanı'],
+    ['Projede', 'Davada'],
+    ['Projen', 'Davan'],
+    ['Proje', 'Dava'],
+    ['projelerde', 'davalarda'],
+    ['projelerin', 'davaların'],
+    ['projelere', 'davalara'],
+    ['projeleri', 'davaları'],
+    ['projeler', 'davalar'],
+    ['projeyi', 'davayı'],
+    ['projeye', 'davaya'],
+    ['projeni', 'davanı'],
+    ['projede', 'davada'],
+    ['projen', 'davan'],
+    ['proje', 'dava'],
+  ],
+  ru: [
+    // "досье" is an indeclinable neuter noun, so agreeing words are fixed explicitly.
+    ['проект просканирован', 'досье просканировано'],
+    ['проекта просканировано', 'досье просканировано'],
+    ['проектов просканировано', 'досье просканировано'],
+    ['Проект будет убран', 'Досье будет убрано'],
+    ['Новый проект', 'Новое досье'],
+    ['новый проект', 'новое досье'],
+    ['Этот проект', 'Это досье'],
+    ['этот проект', 'это досье'],
+    ['Каждый проект', 'Каждое досье'],
+    ['каждый проект', 'каждое досье'],
+    ['Проекты не найдены', 'Досье не найдены'],
+    ['Проектами', 'Досье'],
+    ['Проектах', 'Досье'],
+    ['Проектам', 'Досье'],
+    ['Проектов', 'Досье'],
+    ['Проектом', 'Досье'],
+    ['Проекты', 'Досье'],
+    ['Проекта', 'Досье'],
+    ['Проекте', 'Досье'],
+    ['Проекту', 'Досье'],
+    ['Проект', 'Досье'],
+    ['проектами', 'досье'],
+    ['проектах', 'досье'],
+    ['проектам', 'досье'],
+    ['проектов', 'досье'],
+    ['проектом', 'досье'],
+    ['проекты', 'досье'],
+    ['проекта', 'досье'],
+    ['проекте', 'досье'],
+    ['проекту', 'досье'],
+    ['проект', 'досье'],
+  ],
+  ja: [['プロジェクト', '案件']],
+  ko: [
+    // 사건 ends in a consonant, so the object/subject/topic particles change with it.
+    ['프로젝트를', '사건을'],
+    ['프로젝트가', '사건이'],
+    ['프로젝트는', '사건은'],
+    ['프로젝트와', '사건과'],
+    ['프로젝트', '사건'],
+  ],
+  'zh-CN': [['项目', '案件']],
+  // zh-TW uses 專案 for the workspace; 項目 there means "item" and is left alone.
+  'zh-TW': [['專案', '案件']],
+};
+
+/** Phrases repaired after the noun swap, where the substituted word needs a different frame. */
+const POST_RULES = {
+  fr: [
+    ['dans un répertoire de dossier', "dans le répertoire d'un dossier"],
+    ['dans votre répertoire de dossier', 'dans le répertoire de votre dossier'],
+    ['répertoire de dossier', 'répertoire du dossier'],
+  ],
+  ru: [['Досье не найдены', 'Досье не найдено']],
+};
+
+/** Longest search string first, so inflected forms are consumed before the bare noun. */
+const orderRules = rules => [...rules].sort((a, b) => b[0].length - a[0].length);
+
+/**
+ * i18next interpolation placeholders are identifiers, not prose: `{{projectName}}` must
+ * survive untouched, so replacement only runs on the text between them.
+ */
+const applyRules = (value, rules) =>
+  value
+    .split(/(\{\{[^}]*\}\})/)
+    .map((part, index) =>
+      index % 2 === 1 ? part : rules.reduce((text, [from, to]) => text.split(from).join(to), part),
+    )
+    .join('');
+
+/** Walks the upstream bundle and collects the leaf keys whose rewritten value differs. */
+const collectOverrides = (source, locale, namespace, path = []) => {
+  const result = {};
+  for (const [key, value] of Object.entries(source)) {
+    const keyPath = [...path, key];
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+      const nested = collectOverrides(value, locale, namespace, keyPath);
+      if (Object.keys(nested).length > 0) result[key] = nested;
+      continue;
+    }
+    if (typeof value !== 'string') continue;
+    if (FROZEN_KEYS.has(`${namespace}:${keyPath.join('.')}`)) continue;
+    let rewritten = applyRules(value, BRAND_RULES);
+    if (!WORDING_EXCLUDED_NAMESPACES.has(namespace)) {
+      rewritten = applyRules(rewritten, orderRules(RULES[locale]));
+      rewritten = applyRules(rewritten, POST_RULES[locale] ?? []);
+    }
+    if (rewritten !== value) result[key] = rewritten;
+  }
+  return result;
+};
+
+rmSync(OUTPUT_DIR, { recursive: true, force: true });
+
+let total = 0;
+for (const locale of readdirSync(LOCALES_DIR)) {
+  if (!RULES[locale]) throw new Error(`No PieceMaker wording rules for locale "${locale}"`);
+  mkdirSync(join(OUTPUT_DIR, locale), { recursive: true });
+  for (const file of readdirSync(join(LOCALES_DIR, locale))) {
+    if (!file.endsWith('.json')) continue;
+    const namespace = file.replace(/\.json$/, '');
+    const source = JSON.parse(readFileSync(join(LOCALES_DIR, locale, file), 'utf8'));
+    const overrides = collectOverrides(source, locale, namespace);
+    const count = JSON.stringify(overrides).match(/"[^"]*":\s*"/g)?.length ?? 0;
+    total += count;
+    writeFileSync(join(OUTPUT_DIR, locale, file), `${JSON.stringify(overrides, null, 2)}\n`);
+    console.log(`${locale}/${file}: ${count} overridden strings`);
+  }
+}
+console.log(`\n${total} overridden strings written to src/piecemaker/i18n/overrides`);