fleetbo-svro 1.0.63 → 1.0.64
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.cjs +121 -102
- package/dist/index.js +1 -1
- package/package.json +1 -1
package/dist/cli.cjs
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
var
|
|
3
|
-
`),
|
|
2
|
+
var ue=(e,o)=>()=>{try{return o||e((o={exports:{}}).exports,o),o.exports}catch(n){throw o=0,n}};var X=ue((ze,W)=>{var u=require("fs"),g=require("path"),de=require("https"),{execSync:pe}=require("child_process"),fe="\x1B[38;2;231;233;237m",me="\x1B[31m",$="\x1B[0m";function F(e){console.log(` ${fe}${e}${$}`)}function v(e){console.error(` ${me}${e}${$}`)}function be(e){let o={};return e.forEach(n=>{if(n.startsWith("--")){let[t,r]=n.slice(2).split("=");t&&r&&(o[t]=r)}}),o}function k(e,o){try{let n=JSON.parse(u.readFileSync(e,"utf8"));return!!(n.dependencies&&n.dependencies[o]||n.devDependencies&&n.devDependencies[o])}catch{return!1}}function ge(e,o){try{return u.existsSync(g.join(e,"node_modules",o,"package.json"))}catch{return!1}}function Ee(e,o){if(u.existsSync(g.join(e,"pnpm-lock.yaml")))return"pnpm";if(u.existsSync(g.join(e,"yarn.lock")))return"yarn";if(u.existsSync(g.join(e,"bun.lockb")))return"bun";try{let n=JSON.parse(u.readFileSync(o,"utf8"));if(typeof n.packageManager=="string"){if(n.packageManager.startsWith("pnpm"))return"pnpm";if(n.packageManager.startsWith("yarn"))return"yarn";if(n.packageManager.startsWith("bun"))return"bun"}}catch{}return"npm"}function Te(e,o){if(!k(o,"fleetbo-svro")||!ge(e,"fleetbo-svro")){let n=Ee(e,o),t={pnpm:"pnpm add fleetbo-svro",yarn:"yarn add fleetbo-svro",bun:"bun add fleetbo-svro",npm:"npm install fleetbo-svro"}[n];F(`\u2192 Installing fleetbo-svro into the project (detected: ${n})...`);try{pe(t,{cwd:e,stdio:"inherit"}),F("fleetbo-svro installed successfully!")}catch(r){v(`\u26A0\uFE0F Automatic installation failed: ${r.message}`),v(`\u{1F449} Please run '${t}' manually.`)}}}function he(e){let o=g.join(e,"svro.schema.json");if(u.existsSync(o))return;let n=new Date().toISOString(),t={createdAt:n,patchedAt:n,schemaVersion:1,collections:{}};u.writeFileSync(o,JSON.stringify(t,null,2)+`
|
|
3
|
+
`),F("\u2192 Created svro.schema.json at project root.")}function Fe(e){let o=g.join(e,".env"),n=`
|
|
4
4
|
# Fleetbo UI Sandbox Mode
|
|
5
5
|
# true = Sandbox mode: simulates writes locally for fluid UI testing; no DB access and IDE alert.
|
|
6
6
|
# false = Strict production mode: enforces schema contracts and persists to DB
|
|
7
7
|
VITE_FLEETBO_PROTOTYPE=true
|
|
8
|
-
`;if(!
|
|
8
|
+
`;if(!u.existsSync(o))u.writeFileSync(o,n.trimStart()),F("\u2192 Created .env with VITE_FLEETBO_PROTOTYPE=true");else{let t=u.readFileSync(o,"utf8");!t.includes("VITE_FLEETBO_PROTOTYPE")&&!t.includes("FLEETBO_PROTOTYPE")&&(u.appendFileSync(o,n),F("\u2192 Injected VITE_FLEETBO_PROTOTYPE=true into existing .env"))}}function ye(e){let o=g.join(e,"src");if(!u.existsSync(o))return;let n=g.join(o,"fleetbo.d.ts");if(u.existsSync(n))return;let t=`/* eslint-disable */
|
|
9
9
|
/* prettier-ignore */
|
|
10
10
|
// @ts-nocheck
|
|
11
11
|
export {}
|
|
@@ -70,16 +70,16 @@ declare global {
|
|
|
70
70
|
'fleetbo-reference': FleetboProp;
|
|
71
71
|
}
|
|
72
72
|
}
|
|
73
|
-
`;try{
|
|
74
|
-
VITE_FLEETBO_DB_KEY=${
|
|
75
|
-
VITE_FLEETBO_ENTERPRISE_ID=${
|
|
73
|
+
`;try{u.writeFileSync(n,t),F("\u2192 Created src/fleetbo.d.ts stub for instant IDE auto-completion.")}catch(r){v(`\u26A0\uFE0F Unable to create src/fleetbo.d.ts: ${r.message}`)}}function ve(e){let o=g.join(e,"index.d.ts");u.existsSync(o)||F("\u2192 Verified index.d.ts presence.")}function Oe(e){let o=["tsconfig.json","jsconfig.json"];for(let n of o){let t=g.join(e,n);if(u.existsSync(t)){let r=new Date;u.utimesSync(t,r,r);break}}}function Pe(e){return new Promise((o,n)=>{let t=JSON.stringify({token:e}),r={hostname:"bootstrapproject-jqycakhlxa-uc.a.run.app",path:"/",method:"POST",headers:{"Content-Type":"application/json","Content-Length":Buffer.byteLength(t)}},i=de.request(r,s=>{let l="";s.on("data",a=>{l+=a}),s.on("end",()=>{if(s.statusCode>=200&&s.statusCode<300)try{o(JSON.parse(l))}catch{n(new Error("Invalid response received from Fleetbo server."))}else try{let a=JSON.parse(l);n(new Error(a.error||`Server error ${s.statusCode}`))}catch{n(new Error(`Server error ${s.statusCode}`))}})});i.on("error",s=>n(s)),i.write(t),i.end()})}async function Se(e,o=[]){let n=g.join(e,".env");if(u.existsSync(n)&&u.readFileSync(n,"utf8").includes("VITE_FLEETBO_DB_KEY")){F("\u2192 Fleetbo environment variables already present in .env \u2014 skipping step.");return}let t=be(o),r=t.keyApp,i=t.token||t.bootstrapToken,s=t.email||"";(!r||!i)&&(v("\u26A0\uFE0F Missing required parameters."),v("\u{1F449} Usage: npx fleetbo-svro init --keyApp=YOUR_KEY --token=YOUR_TOKEN"),process.exit(1)),F("\u2192 Exchanging bootstrap token for project keys...");let l;try{l=await Pe(i)}catch(p){v(`\u26A0\uFE0F Token exchange failed: ${p.message}`),v("\u{1F449} The token may have expired (15 min limit) or was already used. Please regenerate one from the Fleetbo dashboard."),process.exit(1)}(!l.enterpriseId||!l.fleetboDBKey)&&(v("\u26A0\uFE0F Incomplete response from Fleetbo server."),process.exit(1));let a=l.facebookAppId||t.fbAppId||t.facebookAppId||"11967268204758",c=`
|
|
74
|
+
VITE_FLEETBO_DB_KEY=${l.fleetboDBKey}
|
|
75
|
+
VITE_FLEETBO_ENTERPRISE_ID=${l.enterpriseId}
|
|
76
76
|
VITE_FLEETBO_KEY_APP=${r}
|
|
77
|
-
${
|
|
78
|
-
`:""}VITE_FLEETBO_FACEBOOK_APP_ID=${
|
|
79
|
-
`;
|
|
80
|
-
`),
|
|
77
|
+
${s?`VITE_FLEETBO_TESTER_EMAIL=${s}
|
|
78
|
+
`:""}VITE_FLEETBO_FACEBOOK_APP_ID=${a}
|
|
79
|
+
`;u.appendFileSync(n,c),F(".env file updated successfully with Fleetbo keys!")}function Y(e){let o=g.join(e,"svro.d.ts");if(u.existsSync(o))try{u.unlinkSync(o),F("\u2192 Removed legacy svro.d.ts from project root.")}catch{}}function K(e,o){if(process.env.FLEETBO_SKIP_TYPECHECK_SETUP)return;let n=g.join(e,"tsconfig.json"),t=g.join(e,"jsconfig.json"),r=u.existsSync(n)?n:t,i=!u.existsSync(r),s={};if(!i)try{s=JSON.parse(u.readFileSync(r,"utf8"))}catch{v(`\u26A0\uFE0F Unable to read ${g.basename(r)} (Invalid JSON).`);return}s.compilerOptions=s.compilerOptions||{};let l=!1,a=k(o,"react");i?(s.compilerOptions.checkJs=!0,s.compilerOptions.allowJs=!0,s.compilerOptions.target=s.compilerOptions.target||"ES2020",s.compilerOptions.module=s.compilerOptions.module||"ESNext",s.compilerOptions.moduleResolution=s.compilerOptions.moduleResolution||"bundler",s.include=["src/**/*"],l=!0):(s.compilerOptions.checkJs===void 0&&(s.compilerOptions.checkJs=!0,l=!0),s.compilerOptions.allowJs===void 0&&(s.compilerOptions.allowJs=!0,l=!0)),a&&s.compilerOptions.jsx===void 0&&(s.compilerOptions.jsx="react-jsx",l=!0),Array.isArray(s.compilerOptions.types)&&s.compilerOptions.types.includes("vite/client")&&(s.compilerOptions.types=s.compilerOptions.types.filter(c=>c!=="vite/client"),s.compilerOptions.types.length===0&&delete s.compilerOptions.types,l=!0,F(`\u2192 Removed legacy "vite/client" entry from ${g.basename(r)}.`)),l&&(u.writeFileSync(r,JSON.stringify(s,null,2)+`
|
|
80
|
+
`),F(`\u2192 Updated ${g.basename(r)}.`))}function G(e){let o=["src/app/layout.tsx","src/app/layout.jsx","app/layout.tsx","app/layout.jsx","src/pages/_app.tsx","src/pages/_app.jsx","pages/_app.tsx","pages/_app.jsx","src/main.tsx","src/main.jsx","src/main.ts","src/main.js","src/index.tsx","src/index.jsx","src/index.ts","src/index.js","src/App.tsx","src/App.jsx","src/App.vue","app.vue","src/routes/+layout.svelte","src/routes/+layout.ts","src/main.singletons.ts"];for(let n of o){let t=g.join(e,n);if(u.existsSync(t)){let r=u.readFileSync(t,"utf8");r.includes("fleetbo-svro")||(r.startsWith('"use client"')||r.startsWith("'use client'")?r=r.replace(/(['"]use client['"];?\r?\n)/,`$1import 'fleetbo-svro';
|
|
81
81
|
`):r=`import 'fleetbo-svro';
|
|
82
|
-
`+r,
|
|
82
|
+
`+r,u.writeFileSync(t,r));return}}}function H(e,o){if(process.env.FLEETBO_SKIP_AUTOIMPORT_SETUP)return;let t=["vite.config.ts","vite.config.js","vite.config.mjs"].map(a=>g.join(e,a)).find(a=>u.existsSync(a));if(!t)return;let r;try{r=u.readFileSync(t,"utf8")}catch{return}let i="fleetbo-svro",s=r,l=`{
|
|
83
83
|
name: 'fleetbo-auto-runtime',
|
|
84
84
|
transform(code, id) {
|
|
85
85
|
if (!id.includes('node_modules') && !code.includes('fleetbo-svro') && /(src[\\\\/](main|index|App|root))\\.(jsx?|tsx?|vue|svelte)/i.test(id)) {
|
|
@@ -122,26 +122,93 @@ ${t?`VITE_FLEETBO_TESTER_EMAIL=${t}
|
|
|
122
122
|
}
|
|
123
123
|
});
|
|
124
124
|
}
|
|
125
|
-
},`;if(
|
|
126
|
-
ignored: ['**/svro.schema.json', '**/src/auto-imports.d.ts'],`):
|
|
125
|
+
},`;if(s.includes("svro.schema.json")||(s.includes("server:")?s.includes("watch:")?s=s.replace(/watch\s*:\s*\{/,`watch: {
|
|
126
|
+
ignored: ['**/svro.schema.json', '**/src/auto-imports.d.ts'],`):s=s.replace(/server\s*:\s*\{/,`server: {
|
|
127
127
|
watch: {
|
|
128
128
|
ignored: ['**/svro.schema.json', '**/src/auto-imports.d.ts']
|
|
129
|
-
},`):
|
|
129
|
+
},`):s.includes("defineConfig({")&&(s=s.replace("defineConfig({",`defineConfig({
|
|
130
130
|
server: {
|
|
131
131
|
watch: {
|
|
132
132
|
ignored: ['**/svro.schema.json', '**/src/auto-imports.d.ts']
|
|
133
133
|
}
|
|
134
|
-
},`))),!
|
|
134
|
+
},`))),!s.includes("unplugin-auto-import")){let a=s.match(/plugins\s*:\s*\[/);if(a){let c=a.index+a[0].length,p=`
|
|
135
135
|
AutoImport({
|
|
136
|
-
imports: [{ '${
|
|
136
|
+
imports: [{ '${i}': ['Fleetbo', 'FleetboUI'] }],
|
|
137
137
|
dts: 'src/auto-imports.d.ts'
|
|
138
|
-
}),`;if(
|
|
139
|
-
`;if(
|
|
140
|
-
`+
|
|
141
|
-
`+
|
|
142
|
-
`),
|
|
143
|
-
|
|
144
|
-
|
|
138
|
+
}),`;if(s=s.slice(0,c)+p+s.slice(c),!s.includes("import AutoImport")){let T=[...s.matchAll(/^import .+;?$/gm)].pop(),S=`import AutoImport from 'unplugin-auto-import/vite';
|
|
139
|
+
`;if(T){let h=T.index+T[0].length;s=s.slice(0,h)+`
|
|
140
|
+
`+S+s.slice(h)}else s=S+s}}}if(!s.includes("fleetbo-auto-runtime")){let a=s.match(/plugins\s*:\s*\[/);if(a){let c=a.index+a[0].length;s=s.slice(0,c)+`
|
|
141
|
+
`+l+s.slice(c)}}s!==r&&u.writeFileSync(t,s)}function xe(e){let o=g.join(e,".vscode"),n=g.join(o,"settings.json");try{u.existsSync(o)||u.mkdirSync(o,{recursive:!0});let t={};if(u.existsSync(n))try{t=JSON.parse(u.readFileSync(n,"utf8"))}catch{t={}}t["workbench.colorCustomizations"]=t["workbench.colorCustomizations"]||{},t["workbench.colorCustomizations"]["editorInfo.foreground"]="#00feae",t["workbench.colorCustomizations"]["editorHint.foreground"]="#00feae",u.writeFileSync(n,JSON.stringify(t,null,2)+`
|
|
142
|
+
`),F("\u2192 Configured Fleetbo Cyan visual hints in .vscode/settings.json.")}catch{}}function Ie(e,o,n={}){let{skipSelfInstall:t=!1}=n,r=g.join(__dirname,"..");t||Te(e,o),he(e),Fe(e),ve(r),ye(e),xe(e),Y(e),K(e,o),H(e,o),G(e)}W.exports={touchTsConfig:Oe,log:F,logError:v,handleAuthAndEnv:Se,detectDependency:k,cleanupLegacyRootDts:Y,patchJsOrTsConfig:K,attemptViteAutoImportPatch:H,injectUniversalRuntime:G,runFullSetup:Ie}});var d=require("fs"),b=require("path"),Z=require("https"),Ae=require("http"),D=require("os"),{exec:_e,spawnSync:ee}=require("child_process"),{runFullSetup:Ce,handleAuthAndEnv:we,touchTsConfig:Le,attemptViteAutoImportPatch:Ne,injectUniversalRuntime:De}=X(),je="\x1B[34m",Re="\x1B[31m",te="\x1B[0m";function f(e){console.log(`${je}${e}${te}`)}function O(e){console.error(`${Re}${e}${te}`)}var ne=`1. TA LIBERT\xC9 : tout le front-end t'appartient (rendu, \xE9tat, styles, navigation, composants, logique d'interface, choix du framework). Fleetbo ne g\xE8re que les donn\xE9es, l'authentification et le stockage. Un changement qui ne touche pas aux donn\xE9es ne demande l'accord de personne.
|
|
143
|
+
|
|
144
|
+
2. TON INTERLOCUTEUR n'est pas d\xE9veloppeur. Dans tes messages \xE0 l'utilisateur (pas dans le code), parle fran\xE7ais simple et sans jargon : ne dis jamais prototype, true, false, .env, contrat, sch\xE9ma, sync, Edge, endpoint, collection ni fleetbo_update_project. Dis plut\xF4t :
|
|
145
|
+
- \xAB mode essai \xBB (donn\xE9es de d\xE9monstration) pour VITE_FLEETBO_PROTOTYPE=true, et \xAB mode r\xE9el \xBB (vraies donn\xE9es) pour false ;
|
|
146
|
+
- \xAB la structure de vos donn\xE9es \xBB pour le contrat ;
|
|
147
|
+
- \xAB Alex, l'assistant de Fleetbo qui pr\xE9pare la structure de vos donn\xE9es \xBB pour Alex ;
|
|
148
|
+
- \xAB j'enregistre la nouvelle structure \xBB pour la synchronisation.
|
|
149
|
+
Fais toi-m\xEAme toutes les manipulations techniques (terminal, commandes, fichiers) : ne demande jamais \xE0 l'utilisateur de les faire. Avant le premier passage de main \xE0 Alex (5a) et avant tout changement de mode, explique en une phrase ce que tu vas faire et pourquoi, puis attends un \xAB oui \xBB simple. Pour les \xE9volutions suivantes (5b, 5c), la demande de l'utilisateur vaut accord : annonce simplement ce que tu fais.
|
|
150
|
+
|
|
151
|
+
3. MODE PROTOTYPE (VITE_FLEETBO_PROTOTYPE=true, \xAB mode essai \xBB pour l'utilisateur) : le but est de valider les \xE9crans et le parcours visuel.
|
|
152
|
+
- \xC9cris l'UI avec le c\xE2blage r\xE9el : Fleetbo.getDocsG / getDocsU / getDoc / add / update / delete / join, noms de collections et de champs d\xE9finitifs, casts de types, balises <fleetbo-*>.
|
|
153
|
+
- Les donn\xE9es sont virtuelles : Fleetbo.seed('collection', [...]) puis lecture normale.
|
|
154
|
+
- Le contrat peut \xEAtre vierge : ne l'attends pas et ne le con\xE7ois pas. L'UI dicte les champs.
|
|
155
|
+
- Avant le premier enregistrement de la structure (5a), n'appelle pas Alex \xE0 chaque modification : cela se fait quand l'utilisateur valide les \xE9crans.
|
|
156
|
+
|
|
157
|
+
4. MODE PRODUCTION (VITE_FLEETBO_PROTOTYPE=false, \xAB mode r\xE9el \xBB pour l'utilisateur) : le contrat fait foi.
|
|
158
|
+
- Aucun champ, aucune collection, aucune r\xE8gle hors Fleetbo_contract.md.
|
|
159
|
+
- Aucune donn\xE9e fictive (Fleetbo.seed est inerte). Une erreur de l'Edge (HTTP 422, permission-denied...) se lit et se corrige : elle ne se masque pas.
|
|
160
|
+
- Si un \xE9cran a besoin d'une donn\xE9e absente du contrat : aucun contournement, applique le point 5b.
|
|
161
|
+
- Au premier passage en mode r\xE9el, la base est vide (Fleetbo.seed est inerte) : pr\xE9viens l'utilisateur en une phrase et v\xE9rifie que l'app permet de cr\xE9er les donn\xE9es (formulaires d'ajout).
|
|
162
|
+
|
|
163
|
+
5. QUAND PASSER LA MAIN \xC0 ALEX (dans ces cas, et seulement dans ces cas) :
|
|
164
|
+
a) L'utilisateur confirme que les \xE9crans lui conviennent et veut passer aux vraies donn\xE9es : premier enregistrement de la structure de ses donn\xE9es. Ne pr\xE9sume jamais cet accord ; si le moment te semble venu, propose-le simplement (\xAB Les \xE9crans vous conviennent-ils ? Si oui, je demande \xE0 Alex de pr\xE9parer la structure de vos donn\xE9es. \xBB).
|
|
165
|
+
b) Apr\xE8s ce premier enregistrement, une donn\xE9e est ajout\xE9e, modifi\xE9e ou supprim\xE9e (collection, champ, type, relation, r\xE8gle m\xE9tier, permission) : passe la main d\xE8s que la vue est \xE9crite.
|
|
166
|
+
c) L'utilisateur te le demande.
|
|
167
|
+
Comment : appelle fleetbo_update_project avec name, filePaths et rules, puis applique le point 7.
|
|
168
|
+
- filePaths : tous les fichiers qui appellent Fleetbo.* ou qui d\xE9crivent des champs (les vues ET les fichiers de donn\xE9es, jamais seulement les vues) ; tous en cas de doute.
|
|
169
|
+
- rules : uniquement les r\xE8gles m\xE9tier donn\xE9es par l'utilisateur, en texte. Si tu n'en as aucune, demande-lui simplement s'il y a des r\xE8gles \xE0 respecter (limites, dur\xE9es, droits) ; s'il n'en a pas, n'envoie pas de rules. N'invente jamais une r\xE8gle.
|
|
170
|
+
Sans MCP : arr\xEAte-toi, donne \xE0 l'utilisateur un message pr\xEAt \xE0 copier-coller pour Alex et explique simplement o\xF9 le coller (Fleetbo Studio, discussion avec Alex, mode Analyze) sans inventer de boutons ni de menus ; quand il te dit qu'Alex a termin\xE9, applique le point 7.
|
|
171
|
+
Pour une \xE9volution, propose (sans l'imposer) de revenir d'abord en mode essai pour valider les \xE9crans avant d'enregistrer la nouvelle structure.
|
|
172
|
+
|
|
173
|
+
6. NE PASSE PAS LA MAIN \xC0 ALEX pour : style, mise en page, textes, navigation, composants, \xE9tat ou logique d'interface, correction de bug front, donn\xE9es de d\xE9monstration (Fleetbo.seed).
|
|
174
|
+
|
|
175
|
+
7. SYNCHRONISATION : apr\xE8s chaque mise \xE0 jour du backend Fleetbo (contrat, svro.schema.json, svro.workflow.json...), ex\xE9cute npx fleetbo-svro sync avant de continuer \xE0 coder. Cela vaut quelle que soit l'origine de la mise \xE0 jour : toi (fleetbo_update_project) ou Alex dans Fleetbo Studio (d\xE8s que l'utilisateur te dit qu'Alex a modifi\xE9 ou valid\xE9 quelque chose). Fais-le toi-m\xEAme, puis dis \xE0 l'utilisateur en une phrase que la nouvelle structure est enregistr\xE9e.
|
|
176
|
+
|
|
177
|
+
8. NE FAIS JAMAIS : modifier VITE_FLEETBO_PROTOTYPE de ta propre initiative (uniquement avec l'accord explicite de l'utilisateur, apr\xE8s lui avoir expliqu\xE9 en une phrase la diff\xE9rence entre mode essai et mode r\xE9el) ; concevoir ou \xE9diter svro.schema.json et svro.workflow.json (autorit\xE9 d'Alex) ; \xE9crire un backend, une route d'API ou un ORM ; inventer des m\xE9thodes Fleetbo.* ou des balises <fleetbo-*>.`,j="fleetbo-svro",oe=["-y","fleetbo-svro@latest","mcp","--run"],M=/<!-- fleetbo:start[^>]*-->[\s\S]*?<!-- fleetbo:end -->/,ke="<!-- fleetbo:end -->",se="# FLEETBO DATA OS \u2014 DIRECTIVES SYST\xC8ME",C={claude:"Claude Code",cursor:"Cursor",windsurf:"Windsurf",devin:"Devin",codex:"Codex CLI",gemini:"Gemini CLI"},Be=`D1. TOUTE demande de cr\xE9ation d'une NOUVELLE application DOIT d\xE9clencher l'outil MCP 'fleetbo_create_project'. Mais si le '.env' du projet contient d\xE9j\xE0 VITE_FLEETBO_DB_KEY (ou si 'svro.schema.json' existe), le projet EXISTE : n'appelle JAMAIS 'fleetbo_create_project' ; utilise 'fleetbo_update_project' (le 'keyApp' est la valeur de VITE_FLEETBO_DB_KEY ; passe-le explicitement si la session n'a pas \xE9t\xE9 lanc\xE9e dans le dossier du projet).
|
|
178
|
+
|
|
179
|
+
D2. Le serveur MCP est d\xE9j\xE0 pr\xE9-authentifi\xE9 : n'inspecte pas le shell ('env', 'grep'), ne parcours pas le syst\xE8me de fichiers hors de la racine du projet et ne lance pas de connexion (lire le '.env' du projet est autoris\xE9). Seule exception : si un outil renvoie \xAB FLEETBO_DEV_TOKEN missing \xBB, ex\xE9cute UNE fois 'npx fleetbo-svro login', attends qu'elle se termine (l'utilisateur valide dans le navigateur : pr\xE9viens-le simplement), puis relance l'outil.
|
|
180
|
+
|
|
181
|
+
D3. CR\xC9ATION UNIQUEMENT : si 'keyApp' n'est pas fourni, d\xE9duis-le du nom du projet en snake_case (ex: "Coworking Space" -> "coworking_space"). Pour un projet existant, ne d\xE9duis JAMAIS le keyApp : lis-le dans le '.env'.
|
|
182
|
+
|
|
183
|
+
D4. D\xE8s la cr\xE9ation valid\xE9e, ex\xE9cute la commande renvoy\xE9e ('commandInit') \xE0 la racine du projet frontend Vite (cr\xE9e d'abord ce projet, avec React et Tailwind si l'utilisateur les demande, s'il n'existe pas encore) et commence le code UI avec l'objet global Fleetbo.*.
|
|
184
|
+
|
|
185
|
+
D5. Si l'outil 'fleetbo_create_project' n'appara\xEEt pas dans tes outils : n'improvise pas et n'explore rien. Ex\xE9cute UNE fois 'npx fleetbo-svro mcp', puis demande \xE0 l'utilisateur, en mots simples, de red\xE9marrer son \xE9diteur ou son agent.
|
|
186
|
+
|
|
187
|
+
D6. Sources des r\xE8gles Fleetbo : ce fichier (protocole ci-dessous), 'Fleetbo_contract.md' (racine, g\xE9n\xE9r\xE9 par 'npx fleetbo-svro sync') et l'outil MCP 'fleetbo_get_contract'. Ne charge pas les autres fichiers .md du projet. Port\xE9e : les r\xE8gles de syntaxe du SDK valent dans les deux modes ; la conformit\xE9 des donn\xE9es au contrat (champs, tables, r\xE8gles) n'est absolue que si VITE_FLEETBO_PROTOTYPE=false.
|
|
188
|
+
|
|
189
|
+
D7. Avant d'\xE9crire du code de donn\xE9es, lis VITE_FLEETBO_PROTOTYPE dans le '.env' du projet : true = prototype purement visuel (bac \xE0 sable local du SDK : les \xE9critures sont relues par les lectures ; donn\xE9es de d\xE9mo via Fleetbo.seed) ; false = production ('Fleetbo.*' et la s\xE9curit\xE9 Edge prennent le relais). Zero-Rewrite (philosophie) : \xE9cris le code de la m\xEAme fa\xE7on en prototype et en production, sans chemin s\xE9par\xE9 par mode ; seules les donn\xE9es peuvent \xEAtre virtuelles. C'est un principe de conception, pas une interdiction de corriger le code. Ne modifie jamais cette valeur de ta propre initiative : uniquement avec l'accord explicite de l'utilisateur.
|
|
190
|
+
|
|
191
|
+
D8. Pour toute d\xE9cision touchant aux donn\xE9es (ce que tu fais selon le mode, quand passer la main \xE0 Alex, quand ne pas le faire, quand lancer la synchronisation), applique \xE0 la lettre le PROTOCOLE DONN\xC9ES ci-dessous (identique \xE0 celui de 'Fleetbo_contract.md'). L'utilisateur n'est pas d\xE9veloppeur : parle-lui en fran\xE7ais simple, sans jargon, et fais toi-m\xEAme toutes les manipulations techniques. En dehors des donn\xE9es, le front-end est enti\xE8rement libre.`,w={created:"created",updated:"updated",unchanged:"already up to date",appended:"Fleetbo block appended (your own content was kept)",migrated:"old Fleetbo file replaced (backup: <file>.fleetbo-legacy.bak)",invalid:"skipped: the file is not valid JSON, fix or delete it first"};function Ue(){try{return JSON.parse(d.readFileSync(b.join(__dirname,"..","package.json"),"utf8")).version||"dev"}catch{return"dev"}}function Me(){return`# FLEETBO DATA OS \u2014 DIRECTIVES AGENT
|
|
192
|
+
|
|
193
|
+
`+Be+`
|
|
194
|
+
|
|
195
|
+
## PROTOCOLE DONN\xC9ES : QUI FAIT QUOI (AGENT FRONTEND \u2194 ALEX AI)
|
|
196
|
+
|
|
197
|
+
`+ne}function z(e,o){return"<!-- fleetbo:start v"+e+` -->
|
|
198
|
+
`+o.trim()+`
|
|
199
|
+
`+ke+`
|
|
200
|
+
`}function qe(e,o,n){let t=d.existsSync(e)?d.readFileSync(e,"utf8"):null,r,i;return t===null?(r="created",i=o):M.test(t)?(i=t.replace(M,()=>o.trimEnd()),r=i===t?"unchanged":"updated"):t.includes(se)?(r="migrated",i=o):(r="appended",i=t.replace(/\s*$/,`
|
|
201
|
+
|
|
202
|
+
`)+o),!n&&r!=="unchanged"&&(r==="migrated"&&d.writeFileSync(e+".fleetbo-legacy.bak",t,"utf8"),d.mkdirSync(b.dirname(e),{recursive:!0}),d.writeFileSync(e,i,"utf8")),r}function B(e,o){let n={command:"npx",args:oe},t={};if(d.existsSync(e))try{let i=JSON.parse(d.readFileSync(e,"utf8"));if(!i||typeof i!="object"||Array.isArray(i))return"invalid";t=i}catch{return"invalid"}let r=t.mcpServers&&t.mcpServers[j];return r&&JSON.stringify(r)===JSON.stringify(n)?"unchanged":(t.mcpServers=t.mcpServers||{},t.mcpServers[j]=n,o||(d.mkdirSync(b.dirname(e),{recursive:!0}),d.writeFileSync(e,JSON.stringify(t,null,2)+`
|
|
203
|
+
`,"utf8")),r?"updated":"created")}function L(e){let o=process.platform==="win32"?"where":"which";return ee(o,[e],{stdio:"ignore"}).status===0}function U(e,o,n){let t=ee(e,o,{encoding:"utf8",timeout:n||3e4,shell:process.platform==="win32"});return{ok:t.status===0,out:(t.stdout||"")+(t.stderr||"")}}function Ve(e,o){let n=e==="claude"?["--scope","user"]:[],t=["mcp","add"].concat(n,[j,"--","npx"],oe),r=["mcp","remove",j].concat(n),i=e+" "+t.join(" ");if(!L(e))return{status:"manual",detail:i};if(o)return{status:"planned",detail:i};let s=U(e,["mcp","list"],6e4),l=s.ok?s.out.split(`
|
|
204
|
+
`):[],a=l.find(T=>/^[\s|│┃]*fleetbo-svro(?![\w@-])/.test(T)),c=l.some(T=>/^\s*fleetbo:\s.*fleetbo-svro/.test(T));if(a&&a.includes("fleetbo-svro@latest"))return{status:"unchanged",legacy:c};if(a&&!U(e,r).ok)return{status:"manual",detail:e+" "+r.join(" ")+" && "+i,legacy:c};let p=U(e,t);return p.ok?{status:a?"updated":"created",legacy:c}:{status:"failed",detail:i,message:p.out.trim().split(`
|
|
205
|
+
`).slice(-2).join(" "),legacy:c}}function Je(e){let o=D.homedir(),n=t=>d.existsSync(t);return{claude:L("claude")||n(b.join(o,".claude")),cursor:n(b.join(e,".cursor"))||n(b.join(o,".cursor"))||L("cursor"),windsurf:n(b.join(o,".codeium","windsurf"))||n(b.join(e,".windsurf")),devin:n(b.join(e,".devin")),codex:L("codex")||n(b.join(o,".codex")),gemini:L("gemini")||n(b.join(o,".gemini"))}}async function $e(e,o){let n=o.includes("--dry-run"),t=o.find(m=>m.startsWith("--agent=")),r=t&&t.slice(8).trim()?t.slice(8).split(",").map(m=>m.trim().toLowerCase()).filter(Boolean):null,i=null;if(r){i=r.includes("all")?Object.keys(C):r;let m=i.filter(E=>!C[E]);m.length&&(O("Unknown agent(s): "+m.join(", ")+". Valid values: "+Object.keys(C).join(", ")+", all."),process.exit(1))}let s=Je(e),l=i||Object.keys(C).filter(m=>s[m]),a=Ue();f(`
|
|
206
|
+
[Fleetbo] Configuring your AI agents`+(n?" (dry run: nothing is written)":"")+"...");let c=z(a,Me()),p=[];(!i||i.some(m=>m!=="gemini"))&&p.push(["AGENTS.md",c]),(!i||i.includes("claude"))&&p.push(["CLAUDE.md",z(a,`# FLEETBO DATA OS \u2014 DIRECTIVES AGENT
|
|
207
|
+
@AGENTS.md`)]),(!i||i.includes("gemini"))&&p.push(["GEMINI.md",c]);let T=b.join(e,".cursorrules");if(d.existsSync(T)){let m=d.readFileSync(T,"utf8");(M.test(m)||m.includes(se))&&p.push([".cursorrules",c])}for(let m of p)f("\u2192 "+m[0]+": "+w[qe(b.join(e,m[0]),m[1],n)]);for(let m of l){let E=C[m];if(m==="cursor")f("\u2192 "+E+" MCP (.cursor/mcp.json): "+w[B(b.join(e,".cursor","mcp.json"),n)]);else if(m==="windsurf")f("\u2192 "+E+" MCP (~/.codeium/windsurf/mcp_config.json): "+w[B(b.join(D.homedir(),".codeium","windsurf","mcp_config.json"),n)]);else if(m==="gemini")f("\u2192 "+E+" MCP (.gemini/settings.json): "+w[B(b.join(e,".gemini","settings.json"),n)]);else if(m==="claude"||m==="codex"){let y=Ve(m,n);y.status==="manual"?f("\u2192 "+E+": '"+m+"' not found or not scriptable. Run manually: "+y.detail):y.status==="planned"?f("\u2192 "+E+" MCP: would run: "+y.detail):y.status==="failed"?O("\u2192 "+E+" MCP: registration failed ("+y.message+"). Run manually: "+y.detail):f("\u2192 "+E+" MCP: "+w[y.status]),y.legacy&&f(" \u26A0\uFE0F An old MCP entry named 'fleetbo' exists. Remove it: "+m+" mcp remove fleetbo")}else m==="devin"&&f("\u2192 "+E+": reads AGENTS.md. Devin runs in its own environment: add the Fleetbo MCP server from Devin's settings (not automated).")}!i&&l.length===0&&f("\u2192 No agent detected: instruction files were written; re-run with --agent=<name> to register the MCP server.");let h=!!(re(e).FLEETBO_DEV_TOKEN||process.env.FLEETBO_DEV_TOKEN),P=b.join(D.homedir(),".fleetbo","credentials.json");if(d.existsSync(P))try{h=h||!!JSON.parse(d.readFileSync(P,"utf8")).devToken}catch{}h||O('\u26A0\uFE0F No developer token found. Run "npx fleetbo-svro login" once.'),f(`
|
|
208
|
+
[Fleetbo] Done. Restart your agent so it reloads the Fleetbo tools and the instruction files.
|
|
209
|
+
`)}function Ye(e){let o=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";_e(`${o} "${e}"`)}function Ke(e){return new Promise((o,n)=>{let t=Ae.createServer((r,i)=>{if(i.setHeader("Access-Control-Allow-Origin","*"),i.setHeader("Access-Control-Allow-Methods","GET, OPTIONS"),i.setHeader("Access-Control-Allow-Headers","Content-Type, Authorization"),i.setHeader("Access-Control-Allow-Private-Network","true"),r.method==="OPTIONS"){i.writeHead(204),i.end();return}let s=new URL(r.url,"http://127.0.0.1");if(s.pathname==="/callback"){let l=s.searchParams.get("token");if(!l){i.writeHead(400,{"Content-Type":"text/html; charset=utf-8"}),i.end("<h3>Error: Missing token.</h3>");return}let a=b.join(D.homedir(),".fleetbo");d.existsSync(a)||d.mkdirSync(a,{recursive:!0}),d.writeFileSync(b.join(a,"credentials.json"),JSON.stringify({devToken:l,updatedAt:new Date().toISOString()},null,2));let c=b.join(e,".env");if(d.existsSync(c)){let p=d.readFileSync(c,"utf8");p.includes("FLEETBO_DEV_TOKEN=")?p=p.replace(/FLEETBO_DEV_TOKEN=.*/g,`FLEETBO_DEV_TOKEN=${l}`):p+=`
|
|
210
|
+
FLEETBO_DEV_TOKEN=${l}
|
|
211
|
+
`,d.writeFileSync(c,p,"utf8")}i.writeHead(200,{"Content-Type":"text/html; charset=utf-8",Connection:"close"}),i.end(`
|
|
145
212
|
<!DOCTYPE html>
|
|
146
213
|
<html>
|
|
147
214
|
<head>
|
|
@@ -159,12 +226,12 @@ FLEETBO_DEV_TOKEN=${i}
|
|
|
159
226
|
</div>
|
|
160
227
|
</body>
|
|
161
228
|
</html>
|
|
162
|
-
`),
|
|
163
|
-
[Fleetbo] Developer token received and stored successfully!`),
|
|
164
|
-
Next step to connect your AI agents:`),
|
|
165
|
-
`),typeof
|
|
166
|
-
[Fleetbo] Waiting for authentication...`),
|
|
167
|
-
`).forEach(r=>{let[
|
|
229
|
+
`),f(`
|
|
230
|
+
[Fleetbo] Developer token received and stored successfully!`),f(`
|
|
231
|
+
Next step to connect your AI agents:`),f(` npx fleetbo-svro mcp (Configure Claude Code, Cursor, Windsurf, Devin, Codex CLI, Gemini CLI)
|
|
232
|
+
`),typeof t.closeAllConnections=="function"&&t.closeAllConnections(),t.close(()=>o()),setTimeout(()=>o(),300)}});t.listen(0,"127.0.0.1",()=>{let i=`https://fleetbo.io/cli-auth?port=${t.address().port}`;f(`
|
|
233
|
+
[Fleetbo] Waiting for authentication...`),f(`If your browser does not open automatically, visit: ${i}`),Ye(i);let s=Number(process.env.FLEETBO_LOGIN_TIMEOUT_MS)||12e4;setTimeout(()=>{try{typeof t.closeAllConnections=="function"&&t.closeAllConnections()}catch{}t.close(),n(new Error(`Login timed out after ${Math.round(s/1e3)}s: browser approval not received. Run "npx fleetbo-svro login" once more and approve in the browser.`))},s).unref()}),t.on("error",r=>n(r))})}function Ge(e,o){return new Promise((n,t)=>{let r=JSON.stringify({enterpriseID:e,schema:o}),i={hostname:"fleetbo-gatekeeper.fleetbo.workers.dev",path:"/sync-schema",method:"POST",headers:{"Content-Type":"application/json","Content-Length":Buffer.byteLength(r)}},s=Z.request(i,l=>{let a="";l.on("data",c=>{a+=c}),l.on("end",()=>{l.statusCode>=200&&l.statusCode<300?n(JSON.parse(a)):t(new Error(`Edge sync failed with HTTP ${l.statusCode}`))})});s.on("error",l=>t(l)),s.write(r),s.end()})}function re(e){let o=b.join(e,".env");if(!d.existsSync(o))return{};let n=d.readFileSync(o,"utf8"),t={};return n.split(`
|
|
234
|
+
`).forEach(r=>{let[i,...s]=r.split("=");i&&s.length>0&&(t[i.trim()]=s.join("=").trim())}),t}function Q(e,o){return new Promise((n,t)=>{let r=JSON.stringify({projectId:e,moduleName:o}),i={hostname:"getmodulecache-jqycakhlxa-uc.a.run.app",path:"/",method:"POST",headers:{"Content-Type":"application/json","Content-Length":Buffer.byteLength(r)}},s=Z.request(i,l=>{let a="";l.on("data",c=>{a+=c}),l.on("end",()=>{if(l.statusCode>=200&&l.statusCode<300)try{let c=JSON.parse(a);if(c.success&&c.found&&c.module){let p=c.module.code||c.module.mockCode;n(typeof p=="string"?JSON.parse(p):p)}else n(null)}catch{t(new Error(`Invalid JSON response for ${o}.`))}else t(new Error(`Server error ${l.statusCode} while fetching ${o}`))})});s.on("error",l=>t(l)),s.write(r),s.end()})}var N=process.argv.slice(2),A=N[0];function He(e,o){let n=e?.context||o?.context||"Aucun cahier des charges textuel renseign\xE9.";return`# LE CONTRAT DE DONN\xC9ES FLEETBO (FLEETBO DATA CONTRACT)
|
|
168
235
|
|
|
169
236
|
Ce document constitue le **Cahier des charges officiel et le Contrat bilat\xE9ral d'int\xE9grit\xE9** liant le code client (d\xE9veloppeur ou agent IA) et le moteur Data OS Fleetbo SVRO.
|
|
170
237
|
|
|
@@ -198,42 +265,7 @@ L'agent DOIT adapter son impl\xE9mentation selon la valeur de \`VITE_FLEETBO_PRO
|
|
|
198
265
|
---
|
|
199
266
|
|
|
200
267
|
### \u{1F9ED} PROTOCOLE DONN\xC9ES : QUI FAIT QUOI (AGENT FRONTEND \u2194 ALEX AI)
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
2. TON INTERLOCUTEUR n'est pas d\xE9veloppeur. Dans tes messages \xE0 l'utilisateur (pas dans le code), parle fran\xE7ais simple et sans jargon : ne dis jamais prototype, true, false, .env, contrat, sch\xE9ma, sync, Edge, endpoint, collection ni fleetbo_update_project. Dis plut\xF4t :
|
|
204
|
-
- \xAB mode essai \xBB (donn\xE9es de d\xE9monstration) pour VITE_FLEETBO_PROTOTYPE=true, et \xAB mode r\xE9el \xBB (vraies donn\xE9es) pour false ;
|
|
205
|
-
- \xAB la structure de vos donn\xE9es \xBB pour le contrat ;
|
|
206
|
-
- \xAB Alex, l'assistant de Fleetbo qui pr\xE9pare la structure de vos donn\xE9es \xBB pour Alex ;
|
|
207
|
-
- \xAB j'enregistre la nouvelle structure \xBB pour la synchronisation.
|
|
208
|
-
Fais toi-m\xEAme toutes les manipulations techniques (terminal, commandes, fichiers) : ne demande jamais \xE0 l'utilisateur de les faire. Avant le premier passage de main \xE0 Alex (5a) et avant tout changement de mode, explique en une phrase ce que tu vas faire et pourquoi, puis attends un \xAB oui \xBB simple. Pour les \xE9volutions suivantes (5b, 5c), la demande de l'utilisateur vaut accord : annonce simplement ce que tu fais.
|
|
209
|
-
|
|
210
|
-
3. MODE PROTOTYPE (VITE_FLEETBO_PROTOTYPE=true, \xAB mode essai \xBB pour l'utilisateur) : le but est de valider les \xE9crans et le parcours visuel.
|
|
211
|
-
- \xC9cris l'UI avec le c\xE2blage r\xE9el : Fleetbo.getDocsG / getDocsU / getDoc / add / update / delete / join, noms de collections et de champs d\xE9finitifs, casts de types, balises <fleetbo-*>.
|
|
212
|
-
- Les donn\xE9es sont virtuelles : Fleetbo.seed('collection', [...]) puis lecture normale.
|
|
213
|
-
- Le contrat peut \xEAtre vierge : ne l'attends pas et ne le con\xE7ois pas. L'UI dicte les champs.
|
|
214
|
-
- Avant le premier enregistrement de la structure (5a), n'appelle pas Alex \xE0 chaque modification : cela se fait quand l'utilisateur valide les \xE9crans.
|
|
215
|
-
|
|
216
|
-
4. MODE PRODUCTION (VITE_FLEETBO_PROTOTYPE=false, \xAB mode r\xE9el \xBB pour l'utilisateur) : le contrat fait foi.
|
|
217
|
-
- Aucun champ, aucune collection, aucune r\xE8gle hors Fleetbo_contract.md.
|
|
218
|
-
- Aucune donn\xE9e fictive (Fleetbo.seed est inerte). Une erreur de l'Edge (HTTP 422, permission-denied...) se lit et se corrige : elle ne se masque pas.
|
|
219
|
-
- Si un \xE9cran a besoin d'une donn\xE9e absente du contrat : aucun contournement, applique le point 5b.
|
|
220
|
-
- Au premier passage en mode r\xE9el, la base est vide (Fleetbo.seed est inerte) : pr\xE9viens l'utilisateur en une phrase et v\xE9rifie que l'app permet de cr\xE9er les donn\xE9es (formulaires d'ajout).
|
|
221
|
-
|
|
222
|
-
5. QUAND PASSER LA MAIN \xC0 ALEX (dans ces cas, et seulement dans ces cas) :
|
|
223
|
-
a) L'utilisateur confirme que les \xE9crans lui conviennent et veut passer aux vraies donn\xE9es : premier enregistrement de la structure de ses donn\xE9es. Ne pr\xE9sume jamais cet accord ; si le moment te semble venu, propose-le simplement (\xAB Les \xE9crans vous conviennent-ils ? Si oui, je demande \xE0 Alex de pr\xE9parer la structure de vos donn\xE9es. \xBB).
|
|
224
|
-
b) Apr\xE8s ce premier enregistrement, une donn\xE9e est ajout\xE9e, modifi\xE9e ou supprim\xE9e (collection, champ, type, relation, r\xE8gle m\xE9tier, permission) : passe la main d\xE8s que la vue est \xE9crite.
|
|
225
|
-
c) L'utilisateur te le demande.
|
|
226
|
-
Comment : appelle fleetbo_update_project avec name, filePaths et rules, puis applique le point 7.
|
|
227
|
-
- filePaths : tous les fichiers qui appellent Fleetbo.* ou qui d\xE9crivent des champs (les vues ET les fichiers de donn\xE9es, jamais seulement les vues) ; tous en cas de doute.
|
|
228
|
-
- rules : uniquement les r\xE8gles m\xE9tier donn\xE9es par l'utilisateur, en texte. Si tu n'en as aucune, demande-lui simplement s'il y a des r\xE8gles \xE0 respecter (limites, dur\xE9es, droits) ; s'il n'en a pas, n'envoie pas de rules. N'invente jamais une r\xE8gle.
|
|
229
|
-
Sans MCP : arr\xEAte-toi, donne \xE0 l'utilisateur un message pr\xEAt \xE0 copier-coller pour Alex et explique simplement o\xF9 le coller (Fleetbo Studio, discussion avec Alex, mode Analyze) sans inventer de boutons ni de menus ; quand il te dit qu'Alex a termin\xE9, applique le point 7.
|
|
230
|
-
Pour une \xE9volution, propose (sans l'imposer) de revenir d'abord en mode essai pour valider les \xE9crans avant d'enregistrer la nouvelle structure.
|
|
231
|
-
|
|
232
|
-
6. NE PASSE PAS LA MAIN \xC0 ALEX pour : style, mise en page, textes, navigation, composants, \xE9tat ou logique d'interface, correction de bug front, donn\xE9es de d\xE9monstration (Fleetbo.seed).
|
|
233
|
-
|
|
234
|
-
7. SYNCHRONISATION : apr\xE8s chaque mise \xE0 jour du backend Fleetbo (contrat, svro.schema.json, svro.workflow.json...), ex\xE9cute npx fleetbo-svro sync avant de continuer \xE0 coder. Cela vaut quelle que soit l'origine de la mise \xE0 jour : toi (fleetbo_update_project) ou Alex dans Fleetbo Studio (d\xE8s que l'utilisateur te dit qu'Alex a modifi\xE9 ou valid\xE9 quelque chose). Fais-le toi-m\xEAme, puis dis \xE0 l'utilisateur en une phrase que la nouvelle structure est enregistr\xE9e.
|
|
235
|
-
|
|
236
|
-
8. NE FAIS JAMAIS : modifier VITE_FLEETBO_PROTOTYPE de ta propre initiative (uniquement avec l'accord explicite de l'utilisateur, apr\xE8s lui avoir expliqu\xE9 en une phrase la diff\xE9rence entre mode essai et mode r\xE9el) ; concevoir ou \xE9diter svro.schema.json et svro.workflow.json (autorit\xE9 d'Alex) ; \xE9crire un backend, une route d'API ou un ORM ; inventer des m\xE9thodes Fleetbo.* ou des balises <fleetbo-*>.
|
|
268
|
+
${ne}
|
|
237
269
|
|
|
238
270
|
---
|
|
239
271
|
|
|
@@ -250,7 +282,7 @@ L'agent DOIT adapter son impl\xE9mentation selon la valeur de \`VITE_FLEETBO_PRO
|
|
|
250
282
|
---
|
|
251
283
|
|
|
252
284
|
## \u{1F4CB} CAHIER DES CHARGES M\xC9TIER (CONTEXTE DU PROJET)
|
|
253
|
-
${
|
|
285
|
+
${n}
|
|
254
286
|
|
|
255
287
|
---
|
|
256
288
|
|
|
@@ -311,28 +343,28 @@ ${JSON.stringify(e||{},null,2)}
|
|
|
311
343
|
|
|
312
344
|
## \u2699\uFE0F CONTRAT DE GOUVERNANCE ET WORKFLOW (svro.workflow.json)
|
|
313
345
|
\`\`\`json
|
|
314
|
-
${JSON.stringify(
|
|
346
|
+
${JSON.stringify(o||{},null,2)}
|
|
315
347
|
\`\`\`
|
|
316
|
-
`}async function
|
|
317
|
-
[Fleetbo] Initializing and configuring Fleetbo...`),await
|
|
348
|
+
`}async function We(){let e=process.cwd(),o=b.join(e,"package.json");if(A==="init"||A==="doctor")f(`
|
|
349
|
+
[Fleetbo] Initializing and configuring Fleetbo...`),await we(e,N),Ce(e,o),f(`
|
|
318
350
|
[Fleetbo] Configuration completed successfully!
|
|
319
|
-
`),
|
|
320
|
-
Next step:`),
|
|
321
|
-
`);else if(
|
|
322
|
-
`),
|
|
323
|
-
`),
|
|
324
|
-
`,"utf8"),
|
|
325
|
-
`,"utf8"),
|
|
326
|
-
`);return` ${
|
|
327
|
-
${
|
|
351
|
+
`),f(`
|
|
352
|
+
Next step:`),f(` npx fleetbo-svro sync (Sync cloud schema & generate IDE types)
|
|
353
|
+
`);else if(A==="sync"){let n=N.includes("--dry-run");f(`[Fleetbo] Syncing schema...${n?" (dry-run)":""}`);let t=b.join(e,"svro.schema.json"),r=b.join(e,"svro.workflow.json"),i=b.join(e,"Fleetbo_contract.md"),s=b.join(__dirname,".."),l=b.join(s,"index.d.ts"),a=b.join(e,"src","fleetbo.d.ts"),p=re(e).VITE_FLEETBO_ENTERPRISE_ID,T=null,S=null;if(p)try{f("\u2192 Fetching latest contracts from Fleetbo Cloud..."),T=await Q(p,"svro.schema.json"),T&&(d.writeFileSync(t,JSON.stringify(T,null,2)+`
|
|
354
|
+
`),f("\u2192 Local svro.schema.json updated.")),S=await Q(p,"svro.workflow.json"),S&&(d.writeFileSync(r,JSON.stringify(S,null,2)+`
|
|
355
|
+
`),f("\u2192 Local svro.workflow.json updated."))}catch(E){O(`\u26A0\uFE0F Cloud fetch bypassed: ${E.message}. Using local file fallback.`)}else O("\u26A0\uFE0F VITE_FLEETBO_ENTERPRISE_ID missing in .env. Skipping cloud fetch.");let h=T;if(!h&&d.existsSync(t))try{h=JSON.parse(d.readFileSync(t,"utf8"))}catch{}h||(h={context:"Application en cours de mod\xE9lisation initiale.",collections:{}},d.writeFileSync(t,JSON.stringify(h,null,2)+`
|
|
356
|
+
`,"utf8"),f("\u2192 Initial blank svro.schema.json created."));let P=S;if(!P&&d.existsSync(r))try{P=JSON.parse(d.readFileSync(r,"utf8"))}catch{}P||(P={actors:{},sequences:[]},d.writeFileSync(r,JSON.stringify(P,null,2)+`
|
|
357
|
+
`,"utf8"),f("\u2192 Initial blank svro.workflow.json created."));let m=He(h,P);d.writeFileSync(i,m,"utf8"),f("\u2192 Fleetbo_contract.md successfully generated at project root.");try{let E=Object.keys(h.collections||{});if(p)try{await Ge(p,h),f("\u2192 Schema successfully sealed at Fleetbo Global Edge (O(1)).")}catch(x){O(`\u26A0\uFE0F Fleetbo Edge Shield sync warning: ${x.message}`)}let y=h.collections||{},q=Object.entries(y).map(([x,J])=>{let le=J.fields||J.schema||{},ae=Object.entries(le).map(([ce,R])=>{let _="any",I=String(typeof R=="string"?R:R.type||"").toLowerCase();return I==="string"||I==="text"||I==="media"?_="string":I==="number"?_="number":I==="boolean"||I==="toggle"?_="boolean":I==="array"&&(_="any[]"),` ${ce}?:${_};`}).join(`
|
|
358
|
+
`);return` ${x}: {
|
|
359
|
+
${ae}
|
|
328
360
|
};`}).join(`
|
|
329
|
-
`),
|
|
361
|
+
`),V=E.length>0?E.map(x=>`'${x}'`).join(" | "):"string",ie=`// Generated by fleetbo-svro \u2014 Updated via fleetbo sync
|
|
330
362
|
|
|
331
363
|
export interface FleetboSchemaMap {
|
|
332
|
-
${
|
|
364
|
+
${q}
|
|
333
365
|
}
|
|
334
366
|
|
|
335
|
-
export type KnownFleetboTables = ${
|
|
367
|
+
export type KnownFleetboTables = ${V};
|
|
336
368
|
|
|
337
369
|
export type FleetboTables =
|
|
338
370
|
| KnownFleetboTables
|
|
@@ -602,7 +634,7 @@ declare module 'svelte/elements' {
|
|
|
602
634
|
'fleetbo-reference': FleetboProp;
|
|
603
635
|
}
|
|
604
636
|
}
|
|
605
|
-
`;if(
|
|
637
|
+
`;if(d.writeFileSync(l,ie),d.existsSync(b.dirname(a))){let x=`/* eslint-disable */
|
|
606
638
|
/* prettier-ignore */
|
|
607
639
|
// @ts-nocheck
|
|
608
640
|
// Generated by fleetbo-svro \u2014 Updated via fleetbo sync
|
|
@@ -631,11 +663,11 @@ type FleetboProp = {
|
|
|
631
663
|
};
|
|
632
664
|
|
|
633
665
|
interface FleetboSchemaMap {
|
|
634
|
-
${
|
|
666
|
+
${q}
|
|
635
667
|
}
|
|
636
668
|
|
|
637
669
|
declare global {
|
|
638
|
-
type KnownFleetboTables = ${
|
|
670
|
+
type KnownFleetboTables = ${V};
|
|
639
671
|
type FleetboTables = KnownFleetboTables | (string & { _fleetboPending?: never });
|
|
640
672
|
type FleetboData<T extends string> = T extends KnownFleetboTables
|
|
641
673
|
? Partial<FleetboSchemaMap[T]>
|
|
@@ -736,26 +768,13 @@ declare module 'svelte/elements' {
|
|
|
736
768
|
'fleetbo-reference': FleetboProp;
|
|
737
769
|
}
|
|
738
770
|
}
|
|
739
|
-
`;
|
|
740
|
-
[Fleetbo] Configuring MCP server for your environment...`);let l=J(e).FLEETBO_DEV_TOKEN||process.env.FLEETBO_DEV_TOKEN||"";if(!l){let f=T.join(j.homedir(),".fleetbo","credentials.json");if(u.existsSync(f))try{l=JSON.parse(u.readFileSync(f,"utf8")).devToken||""}catch{}}let t={command:"npx",args:["-y","fleetbo-svro","mcp","--run"],env:{FLEETBO_DEV_TOKEN:l}},i=(f,g,F)=>{let h=T.dirname(f);u.existsSync(h)||u.mkdirSync(h,{recursive:!0});let v={mcpServers:{}};if(u.existsSync(f))try{let E=JSON.parse(u.readFileSync(f,"utf8"));E&&typeof E=="object"&&!Array.isArray(E)&&(v=E)}catch{}v.mcpServers=v.mcpServers||{},v.mcpServers[g]=F,u.writeFileSync(f,JSON.stringify(v,null,2)+`
|
|
741
|
-
`)},c=T.join(e,".cursor"),d=T.join(c,"mcp.json");i(d,"fleetbo-svro",t),p("\u2192 Configured for Cursor (.cursor/mcp.json)");let m=T.join(j.homedir(),".codeium","windsurf","mcp_config.json");if(u.existsSync(T.dirname(m))&&(i(m,"fleetbo-svro",t),p("\u2192 Configured for Windsurf (~/.codeium/windsurf/mcp_config.json)")),p(`
|
|
742
|
-
Universal connection command for Claude Code and standalone agents:`),p(` claude mcp add fleetbo-svro -- npx -y fleetbo-svro mcp --run
|
|
743
|
-
`),!l)P('\u26A0\uFE0F No developer token found. Run "npx fleetbo-svro login" or set FLEETBO_DEV_TOKEN in your .env file.');else{let f=`# FLEETBO DATA OS \u2014 DIRECTIVES SYST\xC8ME
|
|
744
|
-
|
|
745
|
-
1. TOUTE demande de cr\xE9ation d'une NOUVELLE application DOIT d\xE9clencher l'outil MCP 'fleetbo_create_project'. Mais si le '.env' du projet contient d\xE9j\xE0 VITE_FLEETBO_DB_KEY (ou si 'svro.schema.json' existe), le projet EXISTE : n'appelle JAMAIS 'fleetbo_create_project' ; utilise 'fleetbo_update_project' (le 'keyApp' est la valeur de VITE_FLEETBO_DB_KEY, et il est facultatif : l'outil le lit tout seul).
|
|
746
|
-
2. Le serveur MCP est d\xE9j\xE0 pr\xE9-authentifi\xE9 : n'inspecte pas le shell ('env', 'grep'), ne parcours pas le syst\xE8me de fichiers hors de la racine du projet et ne lance pas de connexion (lire le '.env' du projet est autoris\xE9). Seule exception : si un outil renvoie \xAB FLEETBO_DEV_TOKEN missing \xBB, ex\xE9cute UNE fois 'npx fleetbo-svro login', attends qu'elle se termine (le d\xE9veloppeur valide dans le navigateur), puis relance l'outil.
|
|
747
|
-
3. CR\xC9ATION UNIQUEMENT : si 'keyApp' n'est pas fourni, d\xE9duis-le du nom du projet en snake_case (ex: "Coworking Space" -> "coworking_space"). Pour un projet existant, ne d\xE9duis JAMAIS le keyApp : laisse l'outil le lire dans le '.env'.
|
|
748
|
-
4. D\xE8s la cr\xE9ation valid\xE9e, ex\xE9cute la commande renvoy\xE9e ('commandInit') \xE0 la racine du projet frontend Vite (cr\xE9e d'abord ce projet, avec React et Tailwind si l'utilisateur les demande, s'il n'existe pas encore) et commence le code UI avec l'objet global Fleetbo.*.
|
|
749
|
-
5. Si l'outil 'fleetbo_create_project' n'appara\xEEt pas dans tes outils : n'improvise pas et n'explore rien. Ex\xE9cute UNE fois 'npx fleetbo-svro mcp', puis demande au d\xE9veloppeur de recharger son \xE9diteur.
|
|
750
|
-
6. Pour les r\xE8gles Fleetbo, la seule source est 'Fleetbo_contract.md' (racine, g\xE9n\xE9r\xE9 par 'npx fleetbo-svro sync') ou l'outil MCP 'fleetbo_get_contract' : ne charge pas les autres fichiers .md du projet. Port\xE9e : les r\xE8gles de syntaxe du SDK valent dans les deux modes ; la conformit\xE9 des donn\xE9es au contrat (champs, tables, r\xE8gles) n'est absolue que si VITE_FLEETBO_PROTOTYPE=false.
|
|
751
|
-
7. Avant d'\xE9crire du code de donn\xE9es, lis VITE_FLEETBO_PROTOTYPE dans le '.env' du projet : true = prototype purement visuel (bac \xE0 sable local du SDK : les \xE9critures sont relues par les lectures ; donn\xE9es de d\xE9mo via Fleetbo.seed) ; false = production ('Fleetbo.*' et la s\xE9curit\xE9 Edge prennent le relais). Le code reste identique dans les deux cas. Zero-Rewrite (philosophie) : \xE9cris le code de la m\xEAme fa\xE7on en prototype et en production, sans chemin s\xE9par\xE9 par mode ; seules les donn\xE9es peuvent \xEAtre virtuelles. C'est un principe de conception, pas une interdiction de corriger le code. Ne modifie jamais cette valeur de ta propre initiative : uniquement avec l'accord explicite de l'utilisateur.
|
|
752
|
-
8. Pour toute d\xE9cision touchant aux donn\xE9es (ce que tu fais selon le mode, quand passer la main \xE0 Alex, quand ne pas le faire, quand lancer la synchronisation), applique \xE0 la lettre la section PROTOCOLE DONN\xC9ES de 'Fleetbo_contract.md'. L'utilisateur n'est pas d\xE9veloppeur : parle-lui en fran\xE7ais simple, sans jargon, et fais toi-m\xEAme toutes les manipulations techniques. En dehors des donn\xE9es, le front-end est enti\xE8rement libre.
|
|
753
|
-
`;["AGENTS.md","GEMINI.md","CLAUDE.md",".cursorrules"].forEach(F=>{let h=T.join(e,F);u.existsSync(h)||u.writeFileSync(h,f,"utf8")}),p("\u2192 Autonomous agent directives initialized."),p(`[Fleetbo] Agent ready! Your development environment now has access to Fleetbo MCP tools.
|
|
754
|
-
`)}process.exit(0)}else I==="login"?(await xe(e),process.exit(0)):["--help","-h","help"].includes(I)?(p(`Fleetbo CLI (fleetbo-svro)
|
|
771
|
+
`;d.writeFileSync(a,x)}Le(e),Ne(e,o),De(e),f(`[Fleetbo] Schema synced successfully (${E.length} collection(s)).`),n&&f("\u2192 [Dry-run] Schema is valid.")}catch(E){O(`Error during synchronization: ${E.message}`),process.exit(1)}}else if(A==="mcp"){let n=N.includes("--run"),t=!1;if(!n&&!process.stdin.isTTY&&(n=await new Promise(r=>{let i=process.stdin,s=null,l=p=>{clearTimeout(s),i.removeListener("data",a),i.removeListener("end",c),i.removeListener("error",c),r(p)},a=p=>{i.pause(),i.unshift(p),t=!0,l(!0)},c=()=>l(!1);s=setTimeout(()=>{i.pause(),l(!1)},1500),i.on("data",a),i.once("end",c),i.once("error",c)})),n){try{await import(`file://${b.join(__dirname,"fleetbo-mcp.js")}`),t&&process.stdin.resume()}catch(r){O(`Failed to start MCP server: ${r.message}`),process.exit(1)}return}await $e(e,N),process.exit(0)}else A==="login"?(await Ke(e),process.exit(0)):["--help","-h","help"].includes(A)?(f(`Fleetbo CLI (fleetbo-svro)
|
|
755
772
|
|
|
756
773
|
Commands:
|
|
757
774
|
login Authenticate this machine (opens the browser: approve once, the command exits by itself)
|
|
758
|
-
mcp Connect your
|
|
775
|
+
mcp Connect your AI agent to Fleetbo and write its instruction files (AGENTS.md, CLAUDE.md, GEMINI.md).
|
|
776
|
+
--agent=claude,cursor,windsurf,devin,codex,gemini|all (default: files for all, MCP for detected agents)
|
|
777
|
+
--dry-run show what would change, write nothing
|
|
759
778
|
init Initialize the project: init --keyApp=<KEY> --token=<TOKEN>
|
|
760
779
|
sync Seal the schema/workflow on the Edge and generate Fleetbo_contract.md + IDE types
|
|
761
780
|
|
|
@@ -764,4 +783,4 @@ Modeling has NO shell command: to evolve the schema/workflow from your UI files,
|
|
|
764
783
|
"fleetbo_update_project" (keyApp is optional), then run "sync" once.
|
|
765
784
|
Run login / mcp at most once each and wait for them to finish. Nothing else needs to be
|
|
766
785
|
discovered: do not search the filesystem or read files outside the project.
|
|
767
|
-
`),process.exit(0)):(
|
|
786
|
+
`),process.exit(0)):(O('Unknown command. Run "npx fleetbo-svro --help".'),process.exit(1))}We().catch(e=>{O(`Fleetbo CLI Error: ${e.message}`),process.exit(1)});
|