@mcamdali/podexit 0.0.0-stage → 0.1.2

package/README.fr.md

@@ -0,0 +1,254 @@
+<!-- i18n-source: README.md@1c83a153cf8713f20722fb4899b14a3a0509ab39 status=reviewed -->
+<!-- brand:start -->
+
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/banner-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/banner-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/banner-light.svg" alt="podexit: Which of your pods stop getting updates when CocoaPods trunk goes read-only, and which already ship a Swift package."></picture></p>
+
+<!-- lang-selector:start -->
+<p align="center"><a href="README.md">English</a> · <a href="README.tr.md">Türkçe</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.es.md">Español</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.pt-BR.md">Português (Brasil)</a> · <a href="README.ru.md">Русский</a></p>
+<!-- lang-selector:end -->
+
+<p align="center">
+<a href="https://github.com/muhittincamdali/podexit/actions/workflows/ci.yml"><img src="https://github.com/muhittincamdali/podexit/actions/workflows/ci.yml/badge.svg" alt="État de la CI"></a>
+<a href="https://github.com/muhittincamdali/podexit/releases"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-version-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-version-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-version-light.svg" alt="Dernière version: v0.1.1"></picture></a>
+<a href="https://github.com/muhittincamdali/podexit/blob/main/package.json"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-language-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-language-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-language-light.svg" alt="Version du langage: Node.js 22.12+"></picture></a>
+<a href="https://github.com/muhittincamdali/podexit/blob/main/LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-license-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-license-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-license-light.svg" alt="Licence: MIT"></picture></a>
+</p>
+
+<p align="center">
+<a href="#démarrage-rapide"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-start-fr-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-start-fr-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-start-fr-light.svg" alt="Commencer"></picture></a>
+<a href="https://muhittincamdali.github.io/podexit/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-docs-fr-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-docs-fr-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-docs-fr-light.svg" alt="Documentation"></picture></a>
+<a href="https://github.com/muhittincamdali/podexit/tree/main/docs/guides"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-guides-fr-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-guides-fr-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-guides-fr-light.svg" alt="Guides"></picture></a>
+<a href="https://github.com/muhittincamdali/podexit/tree/main/examples"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-examples-fr-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-examples-fr-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-examples-fr-light.svg" alt="Exemples"></picture></a>
+</p>
+
+> Ceci est une traduction du README anglais. En cas de différence, la version anglaise fait foi.
+
+<!-- brand:end -->
+
+CocoaPods trunk passera en lecture seule le 2 décembre 2026. Vos builds continueront de fonctionner, mais les pods publiés sur trunk ne recevront plus jamais de mise à jour. podexit vous montre lesquelles de vos dépendances sont figées, lesquelles proposent déjà un paquet Swift, et le chemin de migration pour iOS natif, Flutter et React Native/Expo. Il lit le `Podfile.lock` que vous avez déjà ; rien n’est installé dans votre projet.
+
+<picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/demo-native-dark.svg"><source media="(prefers-color-scheme: light)" srcset="docs/media/demo-native-light.svg"><img src="docs/media/demo-native-light.svg" alt="podexit exécuté sur une application iOS native : pods Firebase plafonnés à 12.x ; Alamofire, Kingfisher, SnapKit et d’autres figés après le 2 décembre, chacun avec un paquet Swift"></picture>
+
+<sub>Enregistré avec la vraie CLI sur le <a href="fixtures/native-app/Podfile">fixture native-app</a>, avec les réponses de trunk et de GitHub sauvegardées le 14 octobre 2026 (<code>npm run demo</code>).</sub>
+
+## Points forts
+
+- **Deux réponses par pod** : s’il cesse de recevoir des mises à jour (figé sur trunk, plafonné plus tôt par son éditeur, ou non concerné) et si son dépôt amont contient un `Package.swift`.
+- **Attentif aux versions** : vérifie aussi le `Package.swift` au tag que vous avez verrouillé et signale quand le paquet Swift n’existe que dans des versions plus récentes.
+- **Plafond Firebase intégré** : les 20 pods listés par Firebase sont plafonnés à 12.x, ainsi que leurs sous-dépendances, à partir d’un fichier de données sourcé qui cite la page de Firebase.
+- **Natif, Flutter, React Native et Expo** : trouve `Podfile.lock` dans le dossier ou dans `ios/`, `macos/`, `example/ios/` ou `example/macos/`, reconnaît le type de projet et renvoie vers le guide correspondant.
+- **Terminal, Markdown ou JSON** : un tableau pour vous, du Markdown pour une pull request, du JSON pour les scripts.
+- **Fonctionne hors ligne** : les réponses sont mises en cache 24 heures dans `~/.cache/podexit` ; `--offline` n’utilise que le cache.
+
+## Démarrage rapide
+
+Il vous faut [Node.js](https://nodejs.org/) 22.12 ou plus récent (`node --version` affiche la version ; sur un Mac, `brew install node` l’installe). Rien d’autre.
+
+**1. Ouvrez un terminal dans le dossier de votre application**, celui qui contient le `Podfile`, le dossier `ios/` ou (pour un plugin Flutter) le dossier `example/` :
+
+```sh
+cd path/to/YourApp
+```
+
+**2. Lancez podexit :**
+
+```sh
+npx @mcamdali/podexit
+```
+
+Le paquet npm s’appelle `@mcamdali/podexit` (npm a refusé le nom sans portée) ; la commande qu’il installe reste `podexit`.
+
+**3. Lisez le tableau.** Les lignes marquées **capped** s’arrêtent en premier (Firebase cesse de publier sur CocoaPods en octobre 2026) ; celles marquées **frozen after Dec 2** ne reçoivent plus de nouvelles versions après le 2 décembre. Quand la colonne Swift package indique **yes**, le pod peut être migré dès maintenant. La dernière ligne renvoie vers le guide correspondant à votre type de projet.
+
+## Ce qui change le 2 décembre (et ce qui ne change pas)
+
+D’après l'[annonce de CocoaPods](https://blog.cocoapods.org/CocoaPods-Specs-Repo/) et la [page de migration de Firebase](https://firebase.google.com/docs/ios/cocoapods-deprecation) :
+
+1. **Les builds continuent de fonctionner.** Le dépôt Specs et le CDN restent en ligne ; `pod install` continue de résoudre toutes les versions déjà publiées. Un essai du mode lecture seule a lieu du 1er au 7 novembre 2026.
+2. **Les pods sur trunk ne reçoivent plus de nouvelles versions** après le 2 décembre 2026, correctifs de sécurité compris, sauf s’ils sont distribués autrement (le plus souvent sous forme de paquet Swift).
+3. **Firebase 12 est la dernière version majeure sur CocoaPods**, et Firebase cesse d’y publier en octobre 2026. Les versions 12 et antérieures restent installables.
+
+Pour en savoir plus, lisez [Ce qui change le 2 décembre](docs/guides/what-changes.md).
+
+## Installation
+
+Exécutez-le sans installation, ou ajoutez-le à un projet pour figer une version :
+
+```sh
+npm install --save-dev @mcamdali/podexit
+npx @mcamdali/podexit
+```
+
+Pour installer la commande globalement :
+
+```sh
+npm i -g @mcamdali/podexit
+podexit
+```
+
+Avec Homebrew, `brew install muhittincamdali/tap/podexit` installe l’archive de la version publiée sur GitHub.
+
+## Utilisation
+
+```text
+podexit [paths...] [options]
+```
+
+| Option                  | Effet                                                                                   |
+| ----------------------- | --------------------------------------------------------------------------------------- |
+| `paths`                 | Fichiers `Podfile.lock` ou dossiers de projet ; par défaut, le dossier courant          |
+| `-f, --format <format>` | `tty` (par défaut), `markdown` ou `json`                                                |
+| `-o, --output <file>`   | Écrit le rapport dans un fichier au lieu du terminal                                    |
+| `-a, --all`             | Liste aussi dans le tableau les pods issus de chemins locaux, de git et de specs privés |
+| `--offline`             | N’utilise que les réponses en cache ; ne touche jamais au réseau                        |
+| `--refresh`             | Ignore le cache et interroge de nouveau le réseau                                       |
+| `--cache-dir <dir>`     | Dossier de cache (par défaut `$XDG_CACHE_HOME/podexit` ou `~/.cache/podexit`)           |
+| `--no-color`            | Texte brut même dans un terminal (`NO_COLOR` et `FORCE_COLOR` sont respectés)           |
+| `--concurrency <n>`     | Requêtes de pods en parallèle, de 1 à 64 (par défaut 8)                                 |
+
+Codes de sortie : `0` rapport écrit, `2` arguments invalides, aucun `Podfile.lock` trouvé ou fichier qui n’en est pas un, `1` tout le reste. podexit rapporte ; il ne fait pas échouer un build à cause de ce qu’il trouve.
+
+Sans chemin, podexit lit chaque lockfile trouvé parmi `Podfile.lock`, `ios/Podfile.lock`, `macos/Podfile.lock`, `example/ios/Podfile.lock` et `example/macos/Podfile.lock` ; un dossier passé comme chemin est parcouru de la même façon.
+
+| Variable d’environnement   | Effet                                                                        |
+| -------------------------- | ---------------------------------------------------------------------------- |
+| `PODEXIT_CACHE_DIR`        | Dossier de cache quand `--cache-dir` n’est pas indiqué                       |
+| `GITHUB_TOKEN`, `GH_TOKEN` | Envoyé uniquement aux hôtes GitHub ; nécessaire pour les dépôts amont privés |
+| `NO_COLOR`, `FORCE_COLOR`  | Désactive ou active les couleurs du terminal                                 |
+
+### Conserver un rapport Markdown avec le code
+
+```sh
+npx @mcamdali/podexit --format markdown --output podexit.md
+```
+
+La version Markdown contient les mêmes tableaux, les dates de publication et les liens vers le dépôt de chaque paquet Swift ; les pods issus de chemins locaux et de git sont regroupés dans un bloc `<details>`.
+
+### Utiliser le rapport JSON dans des scripts
+
+```sh
+npx @mcamdali/podexit --format json > podexit.json
+```
+
+Chaque pod porte `updates.status`, `swiftPackage.status`, la dernière version sur trunk avec sa date, et une phrase qui explique chaque réponse. La structure est `schemaVersion` 0 et peut changer avant la 1.0. [examples/shell/frozen-pods.sh](examples/shell/frozen-pods.sh) la filtre avec `jq`.
+
+### L’exécuter en CI
+
+[examples/github-actions/podexit.yml](examples/github-actions/podexit.yml) ajoute le rapport au résumé du job de chaque pull request qui modifie un `Podfile.lock`.
+
+### Limites de débit et dépôts privés
+
+podexit lit `Package.swift` via raw.githubusercontent.com, qui ne consomme pas le quota de l’API GitHub. Définissez `GITHUB_TOKEN` (ou `GH_TOKEN`) pour consulter des dépôts amont privés ; le jeton n’est envoyé qu’aux hôtes GitHub.
+
+### Depuis JavaScript
+
+```js
+import {
+  analyzeLockfile,
+  buildReport,
+  CachedFetcher,
+  HttpFetcher,
+  loadPublisherPolicy,
+  render,
+} from '@mcamdali/podexit';
+
+const policy = loadPublisherPolicy();
+const fetcher = new CachedFetcher(new HttpFetcher({ userAgent: 'my-tool' }), {
+  directory: '.cache',
+});
+const lockfile = await analyzeLockfile(text, 'ios/Podfile.lock', { fetcher, policy });
+console.log(render(buildReport([lockfile], { policy, offline: false }), 'markdown'));
+```
+
+Une version exécutable se trouve dans [examples/api/summary.mjs](examples/api/summary.mjs).
+
+## Démo
+
+Les trois enregistrements proviennent des [fixtures](fixtures/README.md) : de vrais projets créés avec chaque toolchain et résolus par CocoaPods 1.16.2, rejoués avec les réponses sauvegardées le 14 octobre 2026.
+
+| Projet                                                       | Enregistrement                                                                          |
+| ------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
+| Application iOS native (Firebase, Alamofire, Google Sign-In) | en haut de cette page                                                                   |
+| Application Flutter (FlutterFire, google_sign_in, …)         | [clair](docs/media/demo-flutter-light.svg) · [sombre](docs/media/demo-flutter-dark.svg) |
+| Application Expo SDK 57 (Sentry, RevenueCat, Lottie)         | [clair](docs/media/demo-expo-light.svg) · [sombre](docs/media/demo-expo-dark.svg)       |
+
+Mesuré sur un Mac (Apple silicon, M5 Max) avec Node.js 25.9 le 14 octobre 2026 : une première exécution sur le fixture natif (28 pods) a envoyé 112 requêtes et pris de 6,6 à 7,1 secondes ; une seconde exécution a répondu depuis le cache en 0,3 seconde. La vitesse du réseau détermine l’essentiel du premier chiffre.
+
+Pour les enregistrer de nouveau : `npm run demo`.
+
+## État
+
+| Fonctionnalité                                                                          | État        |
+| --------------------------------------------------------------------------------------- | ----------- |
+| Lecture de `Podfile.lock` : pods, subspecs, graphe de dépendances, source de chaque pod | fonctionne  |
+| Dernière version et dates de publication depuis CocoaPods trunk                         | fonctionne  |
+| `Package.swift` sur la branche par défaut et au tag verrouillé                          | fonctionne  |
+| Plafonds des éditeurs (Firebase 12.x) et leurs sous-dépendances                         | fonctionne  |
+| Détection de natif, application Flutter, plugin Flutter, React Native et Expo           | fonctionne  |
+| Rapports terminal, Markdown et JSON ; rejeu du cache avec `--offline`                   | fonctionne  |
+| Nommer le paquet npm ou pub.dev qui apporte chaque pod                                  | prévu (0.3) |
+| Noms de produits et versions du paquet Swift par pod, `plan` → MIGRATION.md             | prévu (0.5) |
+| Sortie SARIF, `--fail-on`, GitHub Action                                                | prévu (0.5) |
+| Mode auteur : podspec → point de départ de `Package.swift`                              | prévu (0.8) |
+| `--fix` pour Flutter, page web statique, schéma JSON stable                             | prévu (1.0) |
+
+## Documentation
+
+Référence de l’API et guides : [muhittincamdali.github.io/podexit](https://muhittincamdali.github.io/podexit/).
+
+## Guides
+
+- [Ce qui change le 2 décembre (et ce qui ne change pas)](docs/guides/what-changes.md)
+- [iOS natif : de CocoaPods à Swift Package Manager](docs/guides/native-ios.md)
+- [Applications et plugins Flutter](docs/guides/flutter.md)
+- [React Native et Expo](docs/guides/react-native-expo.md)
+- [Firebase après la version 12](docs/guides/firebase.md)
+- [Auteurs de pods : remplacer `pod trunk push`](docs/guides/pod-authors.md)
+
+## Prérequis
+
+| Toolchain | Version minimale |
+| --------- | ---------------- |
+| Node.js   | 22.12            |
+
+La CI exécute les tests sur Node.js 22 et 24 (Linux). En local, ils passent sur Node.js 22.23, 24.22 et 25.9, sur un Mac (Apple silicon).
+
+## Architecture
+
+```text
+Podfile.lock ─► parseLockfile          pods, subspecs, dependency graph, source per pod
+             ─► classifyLockfile       frozen-on-trunk | capped | not-affected | unknown
+                  data/publisher-policy.json (sourced; Firebase 12.x)
+             ─► analyzeLockfile        per trunk pod, through a Fetcher:
+                  cdn.cocoapods.org    versions and podspec (GitHub repository and tag)
+                  trunk.cocoapods.org  release dates
+                  raw.githubusercontent.com  Package.swift at HEAD and at the locked tag
+             ─► buildReport ─► render  tty | markdown | json
+```
+
+- `src/core/` est pur : analyse, comparaison de versions, classification. Aucune E/S.
+- Tout ce qui vient du réseau passe par un `Fetcher`. `CachedFetcher` stocke un fichier JSON par requête ; ces mêmes fichiers sont les réponses enregistrées que rejouent les tests et `--offline`.
+- Une réponse manquante est signalée comme `unknown`, avec la raison, jamais comme une erreur.
+- La CLI (`src/cli/`) ne fait qu’analyser les arguments, trouver les lockfiles et écrire la sortie.
+
+## Feuille de route
+
+Voir le tableau [État](#état) : la 0.3 ajoute le paquet npm et pub.dev derrière chaque pod, la 0.5 le plan de migration, SARIF et une GitHub Action, la 0.8 le mode auteur, la 1.0 un schéma JSON stable. [CHANGELOG.md](CHANGELOG.md) liste ce que chaque version a changé.
+
+## FAQ
+
+**Mon application cessera-t-elle de compiler le 2 décembre ?** Non. CocoaPods comme Firebase indiquent que les versions existantes restent installables. podexit s’intéresse aux mises à jour que vous ne recevrez pas, pas aux builds qui s’arrêteraient.
+
+**Pourquoi un pod est-il « unknown » ?** Son podspec pointe vers un hôte autre que GitHub (par exemple un binaire sur dl.google.com), ou le réseau n’était pas disponible. Les rapports JSON et Markdown donnent la raison pour chaque pod.
+
+**Pourquoi les plugins Flutter et les modules React Native sont-ils « not affected » ?** Ce sont des pods à chemin local issus de `.symlinks/plugins` ou de `node_modules` ; ils se mettent à jour avec pub ou npm. Les SDK dont ils dépendent sont listés séparément, et ceux-là peuvent être figés.
+
+**podexit modifie-t-il mon projet ?** Non. Il lit `Podfile.lock` et n’écrit que son cache et le rapport que vous demandez.
+
+## Contribuer
+
+Les contributions sont les bienvenues. Lisez [CONTRIBUTING.md](CONTRIBUTING.md) et le [code de conduite](https://github.com/muhittincamdali/.github/blob/main/CODE_OF_CONDUCT.md) avant d’ouvrir une pull request. Signalez les problèmes de sécurité comme indiqué dans [SECURITY.md](SECURITY.md).
+
+## Licence
+
+Publié sous licence MIT. Voir [LICENSE](LICENSE).

package/README.ja.md

@@ -0,0 +1,254 @@
+<!-- i18n-source: README.md@1c83a153cf8713f20722fb4899b14a3a0509ab39 status=reviewed -->
+<!-- brand:start -->
+
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/banner-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/banner-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/banner-light.svg" alt="podexit: Which of your pods stop getting updates when CocoaPods trunk goes read-only, and which already ship a Swift package."></picture></p>
+
+<!-- lang-selector:start -->
+<p align="center"><a href="README.md">English</a> · <a href="README.tr.md">Türkçe</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.es.md">Español</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.pt-BR.md">Português (Brasil)</a> · <a href="README.ru.md">Русский</a></p>
+<!-- lang-selector:end -->
+
+<p align="center">
+<a href="https://github.com/muhittincamdali/podexit/actions/workflows/ci.yml"><img src="https://github.com/muhittincamdali/podexit/actions/workflows/ci.yml/badge.svg" alt="CI ステータス"></a>
+<a href="https://github.com/muhittincamdali/podexit/releases"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-version-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-version-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-version-light.svg" alt="最新バージョン: v0.1.1"></picture></a>
+<a href="https://github.com/muhittincamdali/podexit/blob/main/package.json"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-language-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-language-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-language-light.svg" alt="言語バージョン: Node.js 22.12+"></picture></a>
+<a href="https://github.com/muhittincamdali/podexit/blob/main/LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-license-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-license-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/badge-license-light.svg" alt="ライセンス: MIT"></picture></a>
+</p>
+
+<p align="center">
+<a href="#クイックスタート"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-start-ja-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-start-ja-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-start-ja-light.svg" alt="はじめる"></picture></a>
+<a href="https://muhittincamdali.github.io/podexit/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-docs-ja-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-docs-ja-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-docs-ja-light.svg" alt="ドキュメント"></picture></a>
+<a href="https://github.com/muhittincamdali/podexit/tree/main/docs/guides"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-guides-ja-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-guides-ja-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-guides-ja-light.svg" alt="ガイド"></picture></a>
+<a href="https://github.com/muhittincamdali/podexit/tree/main/examples"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-examples-ja-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-examples-ja-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/podexit/main/.github/brand/button-examples-ja-light.svg" alt="サンプル"></picture></a>
+</p>
+
+> このドキュメントは英語版 README の翻訳です。内容が異なる場合は英語版が最新です。
+
+<!-- brand:end -->
+
+CocoaPods trunk は 2026年12月2日に読み取り専用になります。ビルドはそのまま動作しますが、trunk に公開されている pod には今後アップデートが提供されません。podexit は、依存関係のうちどれが凍結されるか、どれがすでに Swift パッケージを提供しているかを示し、ネイティブ iOS、Flutter、React Native/Expo それぞれの移行手順を案内します。すでにある `Podfile.lock` を読み取るだけで、プロジェクトには何もインストールしません。
+
+<picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/demo-native-dark.svg"><source media="(prefers-color-scheme: light)" srcset="docs/media/demo-native-light.svg"><img src="docs/media/demo-native-light.svg" alt="ネイティブ iOS アプリで実行した podexit: Firebase の pod は 12.x に制限され、Alamofire、Kingfisher、SnapKit などは 12月2日以降に凍結され、それぞれに Swift パッケージがあることを示している"></picture>
+
+<sub>実際の CLI で <a href="fixtures/native-app/Podfile">native-app fixture</a> を実行して録画しました。trunk と GitHub の応答は 2026年10月14日に保存したものです（<code>npm run demo</code>）。</sub>
+
+## 主な特長
+
+- **pod ごとに 2 つの答え**: アップデートが止まるかどうか（trunk で凍結、公開元によって早期に上限が設定、または影響なし）と、上流リポジトリに `Package.swift` があるかどうか。
+- **バージョンを考慮**: ロックしているタグ時点の `Package.swift` も確認し、Swift パッケージが新しいバージョンにしかない場合はそのことを知らせます。
+- **Firebase の上限を内蔵**: Firebase が挙げる 20 個の pod とその下位依存関係は 12.x に制限されます。根拠は Firebase のページを出典として示すデータファイルです。
+- **ネイティブ、Flutter、React Native、Expo**: フォルダ直下と `ios/`、`macos/`、`example/ios/`、`example/macos/` から `Podfile.lock` を探し、プロジェクトの種類を判別して、対応するガイドへのリンクを表示します。
+- **ターミナル、Markdown、JSON**: 自分で読むための表、pull request 用の Markdown、スクリプト用の JSON。
+- **オフラインでも動作**: 応答は `~/.cache/podexit` に 24 時間キャッシュされ、`--offline` ではキャッシュだけを使います。
+
+## クイックスタート
+
+[Node.js](https://nodejs.org/) 22.12 以降が必要です（`node --version` で確認できます。Mac では `brew install node` でインストールできます）。ほかに必要なものはありません。
+
+**1. アプリのフォルダでターミナルを開きます。** `Podfile` がある場所、`ios/` フォルダがある場所、または（Flutter プラグインの場合）`example/` フォルダがある場所です。
+
+```sh
+cd path/to/YourApp
+```
+
+**2. podexit を実行します。**
+
+```sh
+npx @mcamdali/podexit
+```
+
+npm パッケージ名は `@mcamdali/podexit` です（npm がスコープなしの名前を拒否したため）。インストールされるコマンドは今までどおり `podexit` です。
+
+**3. 表を読みます。** **capped** と表示された行が最初に止まります（Firebase は 2026年10月に CocoaPods への公開を終了します）。**frozen after Dec 2** と表示された行は、12月2日以降は新しいバージョンが出ません。Swift package 列が **yes** の pod は、今すぐ移行できます。最後の行には、お使いのプロジェクトの種類に合ったガイドへのリンクが表示されます。
+
+## 12月2日に何が変わるか（変わらないこと）
+
+[CocoaPods の告知](https://blog.cocoapods.org/CocoaPods-Specs-Repo/)と [Firebase の移行ページ](https://firebase.google.com/docs/ios/cocoapods-deprecation)によると、次のとおりです。
+
+1. **ビルドは動作し続けます。** Specs リポジトリと CDN はオンラインのままで、`pod install` は公開済みのすべてのバージョンを引き続き解決します。読み取り専用モードの試行は 2026年11月1日から7日に実施されます。
+2. **trunk 上の pod** は、別の方法（多くは Swift パッケージ）で配布されない限り、2026年12月2日以降、セキュリティ修正を含めて新しいバージョンが出ません。
+3. **Firebase 12 は CocoaPods での最後のメジャーバージョンです。** Firebase は 2026年10月にそこでの公開を終了します。12 以前のバージョンは引き続きインストールできます。
+
+詳しくは[12月2日に何が変わるか](docs/guides/what-changes.md)をご覧ください。
+
+## インストール
+
+インストールせずに実行するか、バージョンを固定するためにプロジェクトに追加します。
+
+```sh
+npm install --save-dev @mcamdali/podexit
+npx @mcamdali/podexit
+```
+
+コマンドをグローバルにインストールするには、次のようにします。
+
+```sh
+npm i -g @mcamdali/podexit
+podexit
+```
+
+Homebrew を使う場合は `brew install muhittincamdali/tap/podexit` を実行します。GitHub のリリース tarball がインストールされます。
+
+## 使い方
+
+```text
+podexit [paths...] [options]
+```
+
+| オプション              | 動作                                                                                   |
+| ----------------------- | -------------------------------------------------------------------------------------- |
+| `paths`                 | `Podfile.lock` ファイルまたはプロジェクトのフォルダ。デフォルトはカレントフォルダ      |
+| `-f, --format <format>` | `tty`（デフォルト）、`markdown`、`json`                                                |
+| `-o, --output <file>`   | レポートをターミナルではなくファイルに書き出す                                         |
+| `-a, --all`             | ローカルパス、git、プライベート spec の pod も表に表示する                             |
+| `--offline`             | キャッシュした応答だけを使い、ネットワークには一切アクセスしない                       |
+| `--refresh`             | キャッシュを無視して、ネットワークに問い合わせ直す                                     |
+| `--cache-dir <dir>`     | キャッシュフォルダ（デフォルトは `$XDG_CACHE_HOME/podexit` または `~/.cache/podexit`） |
+| `--no-color`            | ターミナルでもプレーンテキストにする（`NO_COLOR` と `FORCE_COLOR` に従う）             |
+| `--concurrency <n>`     | pod の並列問い合わせ数。1 から 64（デフォルトは 8）                                    |
+
+終了コード: `0` はレポートを書き出した場合、`2` は引数が不正、`Podfile.lock` が見つからない、または `Podfile.lock` ではないファイルを指定した場合、`1` はそれ以外の予期しないエラーです。podexit はレポートを出すだけで、検出結果を理由にビルドを失敗させることはありません。
+
+パスを指定しない場合、podexit は `Podfile.lock`、`ios/Podfile.lock`、`macos/Podfile.lock`、`example/ios/Podfile.lock`、`example/macos/Podfile.lock` で見つかったロックファイルをすべて読み込みます。パスとして渡したフォルダも同じ方法で探します。
+
+| 環境変数                   | 動作                                                                      |
+| -------------------------- | ------------------------------------------------------------------------- |
+| `PODEXIT_CACHE_DIR`        | `--cache-dir` を指定しないときのキャッシュフォルダ                        |
+| `GITHUB_TOKEN`, `GH_TOKEN` | GitHub のホストにのみ送信されます。プライベートな上流リポジトリに必要です |
+| `NO_COLOR`, `FORCE_COLOR`  | ターミナルの色をオフまたはオンにする                                      |
+
+### Markdown レポートをコードと一緒に保存する
+
+```sh
+npx @mcamdali/podexit --format markdown --output podexit.md
+```
+
+Markdown 版にも同じ表、リリース日、各 Swift パッケージのリポジトリへのリンクが含まれます。ローカルパスや git の pod は `<details>` ブロックにまとめられます。
+
+### JSON レポートをスクリプトで使う
+
+```sh
+npx @mcamdali/podexit --format json > podexit.json
+```
+
+各 pod には、`updates.status`、`swiftPackage.status`、trunk 上の最新バージョンとその日付、そして各答えを説明する一文が含まれます。レイアウトは `schemaVersion` 0 で、1.0 より前に変更される可能性があります。[examples/shell/frozen-pods.sh](examples/shell/frozen-pods.sh) は `jq` でこれを絞り込みます。
+
+### CI で実行する
+
+[examples/github-actions/podexit.yml](examples/github-actions/podexit.yml) は、`Podfile.lock` を変更するすべての pull request のジョブサマリーにレポートを追加します。
+
+### レート制限とプライベートリポジトリ
+
+podexit は raw.githubusercontent.com 経由で `Package.swift` を読み取るため、GitHub API のクォータは消費しません。プライベートな上流リポジトリを調べるには `GITHUB_TOKEN`（または `GH_TOKEN`）を設定します。トークンは GitHub のホストにのみ送信されます。
+
+### JavaScript から使う
+
+```js
+import {
+  analyzeLockfile,
+  buildReport,
+  CachedFetcher,
+  HttpFetcher,
+  loadPublisherPolicy,
+  render,
+} from '@mcamdali/podexit';
+
+const policy = loadPublisherPolicy();
+const fetcher = new CachedFetcher(new HttpFetcher({ userAgent: 'my-tool' }), {
+  directory: '.cache',
+});
+const lockfile = await analyzeLockfile(text, 'ios/Podfile.lock', { fetcher, policy });
+console.log(render(buildReport([lockfile], { policy, offline: false }), 'markdown'));
+```
+
+実行できるサンプルは [examples/api/summary.mjs](examples/api/summary.mjs) です。
+
+## デモ
+
+3 つの録画は [fixtures](fixtures/README.md) から作成したものです。それぞれのツールチェーンで作成し、CocoaPods 1.16.2 で解決した実際のプロジェクトを、2026年10月14日に保存した応答で再生しています。
+
+| プロジェクト                                                 | 録画                                                                                     |
+| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------- |
+| ネイティブ iOS アプリ（Firebase、Alamofire、Google Sign-In） | このページの冒頭                                                                         |
+| Flutter アプリ（FlutterFire、google_sign_in など）           | [ライト](docs/media/demo-flutter-light.svg) · [ダーク](docs/media/demo-flutter-dark.svg) |
+| Expo SDK 57 アプリ（Sentry、RevenueCat、Lottie）             | [ライト](docs/media/demo-expo-light.svg) · [ダーク](docs/media/demo-expo-dark.svg)       |
+
+計測環境は Mac（Apple silicon、M5 Max）、Node.js 25.9、2026年10月14日です。ネイティブ fixture（28 個の pod）での初回実行は 112 件のリクエストを送り、6.6 から 7.1 秒かかりました。2 回目はキャッシュから 0.3 秒で応答しました。初回の時間はほとんどがネットワーク速度で決まります。
+
+録画をやり直すには `npm run demo` を実行します。
+
+## ステータス
+
+| 機能                                                                         | ステータス    |
+| ---------------------------------------------------------------------------- | ------------- |
+| `Podfile.lock` の読み取り: pod、subspec、依存グラフ、各 pod の取得元         | 動作          |
+| CocoaPods trunk からの最新バージョンとリリース日                             | 動作          |
+| デフォルトブランチおよびロックしたタグ時点の `Package.swift`                 | 動作          |
+| 公開元による上限（Firebase 12.x）とその下位依存関係                          | 動作          |
+| ネイティブ、Flutter アプリ、Flutter プラグイン、React Native、Expo の判別    | 動作          |
+| ターミナル、Markdown、JSON のレポート。`--offline` でのキャッシュ再生        | 動作          |
+| 各 pod の元になっている npm または pub.dev パッケージの特定                  | 計画中（0.3） |
+| pod ごとの Swift パッケージのプロダクト名とバージョン、`plan` → MIGRATION.md | 計画中（0.5） |
+| SARIF 出力、`--fail-on`、GitHub Action                                       | 計画中（0.5） |
+| 作者モード: podspec → `Package.swift` の出発点                               | 計画中（0.8） |
+| Flutter の `--fix`、静的 Web ページ、安定した JSON スキーマ                  | 計画中（1.0） |
+
+## ドキュメント
+
+API リファレンスとガイド: [muhittincamdali.github.io/podexit](https://muhittincamdali.github.io/podexit/)。
+
+## ガイド
+
+- [12月2日に何が変わるか（変わらないこと）](docs/guides/what-changes.md)
+- [ネイティブ iOS: CocoaPods から Swift Package Manager へ](docs/guides/native-ios.md)
+- [Flutter アプリとプラグイン](docs/guides/flutter.md)
+- [React Native と Expo](docs/guides/react-native-expo.md)
+- [Firebase 12 以降](docs/guides/firebase.md)
+- [pod の作者向け: `pod trunk push` に代わる方法](docs/guides/pod-authors.md)
+
+## 動作要件
+
+| ツールチェーン | 最小バージョン |
+| -------------- | -------------- |
+| Node.js        | 22.12          |
+
+CI では Node.js 22 と 24（Linux）でテストを実行しています。ローカルでは、Mac（Apple silicon）上の Node.js 22.23、24.22、25.9 でテストが通ります。
+
+## アーキテクチャ
+
+```text
+Podfile.lock ─► parseLockfile          pods, subspecs, dependency graph, source per pod
+             ─► classifyLockfile       frozen-on-trunk | capped | not-affected | unknown
+                  data/publisher-policy.json (sourced; Firebase 12.x)
+             ─► analyzeLockfile        per trunk pod, through a Fetcher:
+                  cdn.cocoapods.org    versions and podspec (GitHub repository and tag)
+                  trunk.cocoapods.org  release dates
+                  raw.githubusercontent.com  Package.swift at HEAD and at the locked tag
+             ─► buildReport ─► render  tty | markdown | json
+```
+
+- `src/core/` は純粋です。解析、バージョン比較、分類を行い、I/O はありません。
+- ネットワークからの取得はすべて `Fetcher` を経由します。`CachedFetcher` はリクエストごとに 1 つの JSON ファイルを保存します。同じファイルが、テストと `--offline` が再生する記録済みの応答です。
+- 応答が得られなかった場合は、エラーではなく理由付きの `unknown` として報告します。
+- CLI（`src/cli/`）は、引数の解析、lockfile の検出、出力の書き込みだけを行います。
+
+## ロードマップ
+
+[ステータス](#ステータス)の表をご覧ください。0.3 では各 pod の元になっている npm と pub.dev のパッケージ、0.5 では移行プランと SARIF と GitHub Action、0.8 では作者モード、1.0 では安定した JSON スキーマが加わります。各リリースの変更内容は [CHANGELOG.md](CHANGELOG.md) にまとめています。
+
+## FAQ
+
+**12月2日にアプリのビルドが通らなくなりますか？** いいえ。CocoaPods も Firebase も、既存のバージョンはインストールできるままだと説明しています。podexit が扱うのは、受け取れなくなるアップデートであり、止まってしまうビルドではありません。
+
+**なぜ「unknown」になる pod があるのですか？** その podspec が GitHub 以外のホスト（たとえば dl.google.com 上のバイナリ）を指しているか、ネットワークが利用できなかったためです。JSON と Markdown のレポートには、pod ごとの理由が記載されます。
+
+**なぜ Flutter プラグインや React Native モジュールは「not affected」なのですか？** これらは `.symlinks/plugins` または `node_modules` にあるローカルパスの pod で、pub や npm 経由で更新されます。それらが依存する SDK は別に一覧表示され、そちらは凍結される場合があります。
+
+**podexit はプロジェクトを変更しますか？** いいえ。`Podfile.lock` を読み取り、書き込むのは自身のキャッシュと、指定したレポートだけです。
+
+## コントリビューション
+
+コントリビューションを歓迎します。pull request を作成する前に、[CONTRIBUTING.md](CONTRIBUTING.md) と[行動規範](https://github.com/muhittincamdali/.github/blob/main/CODE_OF_CONDUCT.md)をお読みください。セキュリティ上の問題は、[SECURITY.md](SECURITY.md) の手順に従って報告してください。
+
+## ライセンス
+
+MIT ライセンスで公開しています。詳細は [LICENSE](LICENSE) を参照してください。