captive-stack-detector 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f6cc07b2aebaa064c700e3efc99f2e9c08dc9cd9682206b66f6dacbcdaef476
-  data.tar.gz: eeadaa4880a5673b9b89545333cd71895be4a8f04e6ab9503ce57d6051ce7416
+  metadata.gz: 487472525c07acc23f340602eca8aae3b4ef8d98c88a80e37d25f5802a45df1e
+  data.tar.gz: c18427405c1190c106b75eb64b082943e54e703d43fa17b5b340f639668d6321
 SHA512:
-  metadata.gz: 7940bd96414ba39c325e183e898c9135e63cafca546c0189690846b5881d02fa5271358608d7d0055f240e2fa7267e0837b1b8cc51a3dc1ba3abb4172394c43c
-  data.tar.gz: a646c1aebebdc27038f703f2ac779e764d1120e00c493a75dda43b1f717de7cb80f620d91997ed2263ca92c0c39750857bfcb318e685b037383ed19980e5f72f
+  metadata.gz: 8bebc550e548d55b8f50c87eb781f9954086b574602c51d494585bc7d519d391fedc905cc74c802033b77f8940f718431b6452bf8e06d860e4f9aa775460baeb
+  data.tar.gz: e1f7a93e4bb0e747537139c047d75789b89b0c85232951b807a4ab93b918e43851c8bc0d85ba8fe84972a676775e673ae6611b2be27956abb9ed287b5bc15418

data/docs/stacks.md

@@ -0,0 +1,88 @@
+# Stacks supportées
+
+Quand vous créez une application, Captive lit votre dépôt GitHub pour savoir **comment le construire et le lancer**. Cette famille de déploiement s'appelle la **stack**. Captive en connaît trois : **Rails**, **Node** et **Expo**. Si votre dépôt n'entre dans aucune, la création est refusée avec la raison exacte.
+
+Captive ne lit que **la racine du dépôt** : un `Gemfile` ou un `package.json` placé dans un sous-dossier n'est pas vu.
+
+## Rails
+
+Condition : un `Gemfile` à la racine qui contient la gem `rails`.
+
+```ruby
+gem "rails", "8.1.0"
+```
+
+- Avec une gem d'assets (`propshaft`, `sprockets-rails`, `importmap-rails`, `jsbundling-rails`, `cssbundling-rails`, `tailwindcss-rails`…), l'application est construite avec ses assets frontend.
+- Sans gem d'assets, elle est construite comme une API.
+- `gem "pg"` provisionne une base Postgres, `gem "redis"` ou `gem "sidekiq"` un Redis.
+
+Si un `Gemfile` est présent, c'est toujours lui qui décide : un dépôt avec un `Gemfile` sans Rails est refusé, même s'il a aussi un `package.json`.
+
+## Node
+
+Condition : un `package.json` à la racine, sans dépendance `expo`, avec un script **`start`** ou **`build`**.
+
+### Application web (SPA : Vite, React, Vue…)
+
+Votre application est buildée une fois, puis servie en fichiers statiques. Aucun process Node ne tourne en production.
+
+```json
+{
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "devDependencies": {
+    "vite": "7.1.0"
+  }
+}
+```
+
+- Le script `build` doit produire le dossier **`dist/`** à la racine. C'est le comportement par défaut de Vite ; si vous avez changé `build.outDir`, remettez `dist`.
+- Toutes les routes inconnues renvoient `index.html` : le routage côté client (React Router, Vue Router…) fonctionne sans configuration.
+- Les variables d'environnement sont injectées **au moment du build** (par exemple `VITE_SUPABASE_URL`). Après en avoir modifié une, redéployez.
+
+### Serveur Node (Next.js, Nuxt, SvelteKit, Remix)
+
+Si votre `package.json` dépend de `next`, `nuxt`, `@sveltejs/kit` ou d'un paquet `@remix-run/…`, Captive lance un vrai serveur Node avec votre script `start`.
+
+```json
+{
+  "scripts": {
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "next": "15.0.0"
+  }
+}
+```
+
+### Services
+
+- `pg` ou `postgres` provisionne une base Postgres.
+- `redis` ou `ioredis` provisionne un Redis.
+- `@supabase/supabase-js` ou `@supabase/ssr` provisionne un backend Supabase.
+- Une ligne `worker: <commande>` dans un `Procfile` lance un worker.
+
+## Expo
+
+Condition : un `package.json` à la racine avec la dépendance `expo` (dans `dependencies` ou `devDependencies`). Aucun script n'est exigé.
+
+```json
+{
+  "dependencies": {
+    "expo": "54.0.0"
+  }
+}
+```
+
+## Ma création est refusée
+
+| Message | Cause | Que faire |
+| --- | --- | --- |
+| Aucun Gemfile ni package.json à la racine du dépôt. | Pas de fichier de dépendances à la racine. | Vérifiez que l'application est bien à la racine du dépôt, pas dans un sous-dossier (`app/`, `frontend/`…). Les monorepos ne sont pas pris en charge. |
+| Gemfile trouvé, mais sans la gem rails. | Application Ruby non Rails (Sinatra, Hanami…), ou `Gemfile` d'outillage dans un projet JavaScript. | Seul Rails est pris en charge côté Ruby. Si le `Gemfile` ne sert qu'à de l'outillage, retirez-le du dépôt. |
+| package.json trouvé, mais sans dépendance expo ni script start ou build. | Captive ne sait pas comment construire l'application. | Ajoutez un script `build` (application web) ou `start` (serveur), comme dans les exemples ci-dessus. |
+
+Si votre stack n'est pas listée ici, contactez l'équipe Captive.

data/lib/captive_stack_detector/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CaptiveStackDetector
-  VERSION = "0.6.0"
+  VERSION = "0.6.1"
 end

data/lib/captive_stack_detector.rb

@@ -8,6 +8,9 @@ require_relative "captive_stack_detector/rails_stack_detector"
 require_relative "captive_stack_detector/js_stack_detector"
 
 module CaptiveStackDetector
+  # Doc publique des stacks supportées, livrée dans la gem et affichée par le dashboard (ADR 0003).
+  DOC_PATH = File.expand_path("../docs/stacks.md", __dir__)
+
   def self.detect(local_path: nil, github_token: nil, repo: nil)
     reader = FileReader.build(local_path: local_path, github_token: github_token, repo: repo)
     detect_from(reader)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: captive-stack-detector
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Captive Studio
@@ -17,6 +17,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- docs/stacks.md
 - lib/captive/stack/detector.rb
 - lib/captive_stack_detector.rb
 - lib/captive_stack_detector/aptfile_parser.rb