Fluid, segmented audio guide tailored for taxi passengers (and pedestrians) with mobile-first UX.

Structure minimale : apps/, services/, packages/, infra/

• pnpm (v7+)
• Node 18+
• git
• Docker Desktop

1. Installer : pnpm install

2. Développement : pnpm dev

   Démarre automatiquement Docker si nécessaire. Les URLs apparaissent dans les logs.

3. Tests : pnpm test

4. Infra Provisioning : pnpm infra:provision:aws staging

5. Infra status : pnpm infra:status

Voir les configurations de déploiement dans config.

Toutes les commandes dans package.json.

Boote le head d'une PR dans un git worktree isolé (sans toucher à ton working tree). Deux modes :

• Nom : city-guided-preview-<n> (node : titre terminal / process.title ; docker : COMPOSE_PROJECT_NAME)
• Worktree : .worktrees/pr-<n>/ — ports persistés dans .preview-ports
• Ports dynamiques par PR (base 4100 / 3180 / 3181 ; Postgres host docker dès 5434) — plusieurs previews en parallèle OK
• stop <n> ne tue que cette PR (pas les autres)

pnpm preview:pr 42                         # node (multi-instance)
pnpm preview:pr 43                         # 2e preview → autres ports + autre DB
pnpm preview:pr 42 --mode docker           # stack Compose isolée
pnpm preview:pr:stop 42                    # stop uniquement la #42
pnpm preview:pr:stop 42 --remove           # stop + worktree + drop DB (node)
pnpm preview:pr --help

Lien partageable : skill ezk-preview (tunnel) sur le port web de cette PR (voir le banner au démarrage).

Déploiement sur AWS ECS Fargate avec scale-to-zero automatique pour optimiser les coûts.

⚠️ L'infra AWS est un projet autonome, hors workspace pnpm (ses ~285 Mo de dépendances CDK faisaient échouer les builds Render en Out of memory). Elle s'installe à la demande :

pnpm infra:aws:install

Ensuite, tous les scripts pnpm infra:* fonctionnent normalement. Détails : infra/provisioning/aws/README.md.

Ce projet contient deux packages npm qui peuvent être installés dans d'autres projets:

• @bacasable/lifefindsaway - Système d'idéation et exploration de features (Phase A)
• @bacasable/iamthelaw - Système de gestion de règles LLM pour développement

📚 Documentation:

• PACKAGES.md - Guide complet d'installation et publication
• QUICKSTART-PACKAGES.md - Démarrage rapide
• ALTERNATIVE-VERDACCIO.md - Configuration registre privé

🚀 Utilisation rapide:

# Publier sur GitHub Packages
./scripts/publish-package.sh both patch

# Installer dans un autre projet
echo "@bacasable:registry=https://npm.pkg.github.com" > .npmrc
pnpm add @bacasable/lifefindsaway @bacasable/iamthelaw