fleetbo-svro 1.0.61 → 1.0.63
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 +116 -57
- package/dist/fleetbo-mcp.js +70 -13
- 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 Q=(e,n)=>()=>{try{return n||e((n={exports:{}}).exports,n),n.exports}catch(s){throw n=0,s}};var $=Q((Le,V)=>{var a=require("fs"),b=require("path"),Z=require("https"),{execSync:ee}=require("child_process"),te="\x1B[38;2;231;233;237m",oe="\x1B[31m",k="\x1B[0m";function y(e){console.log(` ${te}${e}${k}`)}function O(e){console.error(` ${oe}${e}${k}`)}function ne(e){let n={};return e.forEach(s=>{if(s.startsWith("--")){let[o,r]=s.slice(2).split("=");o&&r&&(n[o]=r)}}),n}function R(e,n){try{let s=JSON.parse(a.readFileSync(e,"utf8"));return!!(s.dependencies&&s.dependencies[n]||s.devDependencies&&s.devDependencies[n])}catch{return!1}}function se(e,n){try{return a.existsSync(b.join(e,"node_modules",n,"package.json"))}catch{return!1}}function re(e,n){if(a.existsSync(b.join(e,"pnpm-lock.yaml")))return"pnpm";if(a.existsSync(b.join(e,"yarn.lock")))return"yarn";if(a.existsSync(b.join(e,"bun.lockb")))return"bun";try{let s=JSON.parse(a.readFileSync(n,"utf8"));if(typeof s.packageManager=="string"){if(s.packageManager.startsWith("pnpm"))return"pnpm";if(s.packageManager.startsWith("yarn"))return"yarn";if(s.packageManager.startsWith("bun"))return"bun"}}catch{}return"npm"}function ie(e,n){if(!R(n,"fleetbo-svro")||!se(e,"fleetbo-svro")){let s=re(e,n),o={pnpm:"pnpm add fleetbo-svro",yarn:"yarn add fleetbo-svro",bun:"bun add fleetbo-svro",npm:"npm install fleetbo-svro"}[s];y(`\u2192 Installing fleetbo-svro into the project (detected: ${s})...`);try{ee(o,{cwd:e,stdio:"inherit"}),y("fleetbo-svro installed successfully!")}catch(r){O(`\u26A0\uFE0F Automatic installation failed: ${r.message}`),O(`\u{1F449} Please run '${o}' manually.`)}}}function le(e){let n=b.join(e,"svro.schema.json");if(a.existsSync(n))return;let s=new Date().toISOString(),o={createdAt:s,patchedAt:s,schemaVersion:1,collections:{}};a.writeFileSync(n,JSON.stringify(o,null,2)+`
|
|
3
|
+
`),y("\u2192 Created svro.schema.json at project root.")}function ae(e){let n=b.join(e,".env"),s=`
|
|
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(!a.existsSync(n))a.writeFileSync(n,s.trimStart()),
|
|
8
|
+
`;if(!a.existsSync(n))a.writeFileSync(n,s.trimStart()),y("\u2192 Created .env with VITE_FLEETBO_PROTOTYPE=true");else{let o=a.readFileSync(n,"utf8");!o.includes("VITE_FLEETBO_PROTOTYPE")&&!o.includes("FLEETBO_PROTOTYPE")&&(a.appendFileSync(n,s),y("\u2192 Injected VITE_FLEETBO_PROTOTYPE=true into existing .env"))}}function ce(e){let n=b.join(e,"src");if(!a.existsSync(n))return;let s=b.join(n,"fleetbo.d.ts");if(a.existsSync(s))return;let o=`/* 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{a.writeFileSync(s,o),
|
|
73
|
+
`;try{a.writeFileSync(s,o),y("\u2192 Created src/fleetbo.d.ts stub for instant IDE auto-completion.")}catch(r){O(`\u26A0\uFE0F Unable to create src/fleetbo.d.ts: ${r.message}`)}}function ue(e){let n=b.join(e,"index.d.ts");a.existsSync(n)||y("\u2192 Verified index.d.ts presence.")}function de(e){let n=["tsconfig.json","jsconfig.json"];for(let s of n){let o=b.join(e,s);if(a.existsSync(o)){let r=new Date;a.utimesSync(o,r,r);break}}}function pe(e){return new Promise((n,s)=>{let o=JSON.stringify({token:e}),r={hostname:"bootstrapproject-jqycakhlxa-uc.a.run.app",path:"/",method:"POST",headers:{"Content-Type":"application/json","Content-Length":Buffer.byteLength(o)}},l=Z.request(r,t=>{let i="";t.on("data",c=>{i+=c}),t.on("end",()=>{if(t.statusCode>=200&&t.statusCode<300)try{n(JSON.parse(i))}catch{s(new Error("Invalid response received from Fleetbo server."))}else try{let c=JSON.parse(i);s(new Error(c.error||`Server error ${t.statusCode}`))}catch{s(new Error(`Server error ${t.statusCode}`))}})});l.on("error",t=>s(t)),l.write(o),l.end()})}async function fe(e,n=[]){let s=b.join(e,".env");if(a.existsSync(s)&&a.readFileSync(s,"utf8").includes("VITE_FLEETBO_DB_KEY")){y("\u2192 Fleetbo environment variables already present in .env \u2014 skipping step.");return}let o=ne(n),r=o.keyApp,l=o.token||o.bootstrapToken,t=o.email||"";(!r||!l)&&(O("\u26A0\uFE0F Missing required parameters."),O("\u{1F449} Usage: npx fleetbo-svro init --keyApp=YOUR_KEY --token=YOUR_TOKEN"),process.exit(1)),y("\u2192 Exchanging bootstrap token for project keys...");let i;try{i=await pe(l)}catch(m){O(`\u26A0\uFE0F Token exchange failed: ${m.message}`),O("\u{1F449} The token may have expired (15 min limit) or was already used. Please regenerate one from the Fleetbo dashboard."),process.exit(1)}(!i.enterpriseId||!i.fleetboDBKey)&&(O("\u26A0\uFE0F Incomplete response from Fleetbo server."),process.exit(1));let c=i.facebookAppId||o.fbAppId||o.facebookAppId||"11967268204758",d=`
|
|
74
74
|
VITE_FLEETBO_DB_KEY=${i.fleetboDBKey}
|
|
75
75
|
VITE_FLEETBO_ENTERPRISE_ID=${i.enterpriseId}
|
|
76
76
|
VITE_FLEETBO_KEY_APP=${r}
|
|
77
77
|
${t?`VITE_FLEETBO_TESTER_EMAIL=${t}
|
|
78
78
|
`:""}VITE_FLEETBO_FACEBOOK_APP_ID=${c}
|
|
79
|
-
`;a.appendFileSync(s,
|
|
80
|
-
`),
|
|
79
|
+
`;a.appendFileSync(s,d),y(".env file updated successfully with Fleetbo keys!")}function U(e){let n=b.join(e,"svro.d.ts");if(a.existsSync(n))try{a.unlinkSync(n),y("\u2192 Removed legacy svro.d.ts from project root.")}catch{}}function B(e,n){if(process.env.FLEETBO_SKIP_TYPECHECK_SETUP)return;let s=b.join(e,"tsconfig.json"),o=b.join(e,"jsconfig.json"),r=a.existsSync(s)?s:o,l=!a.existsSync(r),t={};if(!l)try{t=JSON.parse(a.readFileSync(r,"utf8"))}catch{O(`\u26A0\uFE0F Unable to read ${b.basename(r)} (Invalid JSON).`);return}t.compilerOptions=t.compilerOptions||{};let i=!1,c=R(n,"react");l?(t.compilerOptions.checkJs=!0,t.compilerOptions.allowJs=!0,t.compilerOptions.target=t.compilerOptions.target||"ES2020",t.compilerOptions.module=t.compilerOptions.module||"ESNext",t.compilerOptions.moduleResolution=t.compilerOptions.moduleResolution||"bundler",t.include=["src/**/*"],i=!0):(t.compilerOptions.checkJs===void 0&&(t.compilerOptions.checkJs=!0,i=!0),t.compilerOptions.allowJs===void 0&&(t.compilerOptions.allowJs=!0,i=!0)),c&&t.compilerOptions.jsx===void 0&&(t.compilerOptions.jsx="react-jsx",i=!0),Array.isArray(t.compilerOptions.types)&&t.compilerOptions.types.includes("vite/client")&&(t.compilerOptions.types=t.compilerOptions.types.filter(d=>d!=="vite/client"),t.compilerOptions.types.length===0&&delete t.compilerOptions.types,i=!0,y(`\u2192 Removed legacy "vite/client" entry from ${b.basename(r)}.`)),i&&(a.writeFileSync(r,JSON.stringify(t,null,2)+`
|
|
80
|
+
`),y(`\u2192 Updated ${b.basename(r)}.`))}function q(e){let n=["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 s of n){let o=b.join(e,s);if(a.existsSync(o)){let r=a.readFileSync(o,"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,a.writeFileSync(o,r));return}}}function
|
|
82
|
+
`+r,a.writeFileSync(o,r));return}}}function M(e,n){if(process.env.FLEETBO_SKIP_AUTOIMPORT_SETUP)return;let o=["vite.config.ts","vite.config.js","vite.config.mjs"].map(c=>b.join(e,c)).find(c=>a.existsSync(c));if(!o)return;let r;try{r=a.readFileSync(o,"utf8")}catch{return}let l="fleetbo-svro",t=r,i=`{
|
|
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)) {
|
|
@@ -131,17 +131,17 @@ ${t?`VITE_FLEETBO_TESTER_EMAIL=${t}
|
|
|
131
131
|
watch: {
|
|
132
132
|
ignored: ['**/svro.schema.json', '**/src/auto-imports.d.ts']
|
|
133
133
|
}
|
|
134
|
-
},`))),!t.includes("unplugin-auto-import")){let c=t.match(/plugins\s*:\s*\[/);if(c){let
|
|
134
|
+
},`))),!t.includes("unplugin-auto-import")){let c=t.match(/plugins\s*:\s*\[/);if(c){let d=c.index+c[0].length,m=`
|
|
135
135
|
AutoImport({
|
|
136
136
|
imports: [{ '${l}': ['Fleetbo', 'FleetboUI'] }],
|
|
137
137
|
dts: 'src/auto-imports.d.ts'
|
|
138
|
-
}),`;if(t=t.slice(0,
|
|
139
|
-
`;if(f){let
|
|
140
|
-
`+g+t.slice(
|
|
141
|
-
`+i+t.slice(
|
|
142
|
-
`),
|
|
138
|
+
}),`;if(t=t.slice(0,d)+m+t.slice(d),!t.includes("import AutoImport")){let f=[...t.matchAll(/^import .+;?$/gm)].pop(),g=`import AutoImport from 'unplugin-auto-import/vite';
|
|
139
|
+
`;if(f){let F=f.index+f[0].length;t=t.slice(0,F)+`
|
|
140
|
+
`+g+t.slice(F)}else t=g+t}}}if(!t.includes("fleetbo-auto-runtime")){let c=t.match(/plugins\s*:\s*\[/);if(c){let d=c.index+c[0].length;t=t.slice(0,d)+`
|
|
141
|
+
`+i+t.slice(d)}}t!==r&&a.writeFileSync(o,t)}function me(e){let n=b.join(e,".vscode"),s=b.join(n,"settings.json");try{a.existsSync(n)||a.mkdirSync(n,{recursive:!0});let o={};if(a.existsSync(s))try{o=JSON.parse(a.readFileSync(s,"utf8"))}catch{o={}}o["workbench.colorCustomizations"]=o["workbench.colorCustomizations"]||{},o["workbench.colorCustomizations"]["editorInfo.foreground"]="#00feae",o["workbench.colorCustomizations"]["editorHint.foreground"]="#00feae",a.writeFileSync(s,JSON.stringify(o,null,2)+`
|
|
142
|
+
`),y("\u2192 Configured Fleetbo Cyan visual hints in .vscode/settings.json.")}catch{}}function be(e,n,s={}){let{skipSelfInstall:o=!1}=s,r=b.join(__dirname,"..");o||ie(e,n),le(e),ae(e),ue(r),ce(e),me(e),U(e),B(e,n),M(e,n),q(e)}V.exports={touchTsConfig:de,log:y,logError:O,handleAuthAndEnv:fe,detectDependency:R,cleanupLegacyRootDts:U,patchJsOrTsConfig:B,attemptViteAutoImportPatch:M,injectUniversalRuntime:q,runFullSetup:be}});var u=require("fs"),T=require("path"),K=require("https"),ge=require("http"),j=require("os"),{exec:Ee}=require("child_process"),{runFullSetup:Te,handleAuthAndEnv:Fe,touchTsConfig:he,attemptViteAutoImportPatch:ye,injectUniversalRuntime:ve}=$(),Oe="\x1B[34m",Pe="\x1B[31m",H="\x1B[0m";function p(e){console.log(`${Oe}${e}${H}`)}function P(e){console.error(`${Pe}${e}${H}`)}function Se(e){let n=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";Ee(`${n} "${e}"`)}function xe(e){return new Promise((n,s)=>{let o=ge.createServer((r,l)=>{if(l.setHeader("Access-Control-Allow-Origin","*"),l.setHeader("Access-Control-Allow-Methods","GET, OPTIONS"),l.setHeader("Access-Control-Allow-Headers","Content-Type, Authorization"),l.setHeader("Access-Control-Allow-Private-Network","true"),r.method==="OPTIONS"){l.writeHead(204),l.end();return}let t=new URL(r.url,"http://127.0.0.1");if(t.pathname==="/callback"){let i=t.searchParams.get("token");if(!i){l.writeHead(400,{"Content-Type":"text/html; charset=utf-8"}),l.end("<h3>Error: Missing token.</h3>");return}let c=T.join(j.homedir(),".fleetbo");u.existsSync(c)||u.mkdirSync(c,{recursive:!0}),u.writeFileSync(T.join(c,"credentials.json"),JSON.stringify({devToken:i,updatedAt:new Date().toISOString()},null,2));let d=T.join(e,".env");if(u.existsSync(d)){let m=u.readFileSync(d,"utf8");m.includes("FLEETBO_DEV_TOKEN=")?m=m.replace(/FLEETBO_DEV_TOKEN=.*/g,`FLEETBO_DEV_TOKEN=${i}`):m+=`
|
|
143
143
|
FLEETBO_DEV_TOKEN=${i}
|
|
144
|
-
`,
|
|
144
|
+
`,u.writeFileSync(d,m,"utf8")}l.writeHead(200,{"Content-Type":"text/html; charset=utf-8",Connection:"close"}),l.end(`
|
|
145
145
|
<!DOCTYPE html>
|
|
146
146
|
<html>
|
|
147
147
|
<head>
|
|
@@ -159,20 +159,20 @@ FLEETBO_DEV_TOKEN=${i}
|
|
|
159
159
|
</div>
|
|
160
160
|
</body>
|
|
161
161
|
</html>
|
|
162
|
-
`),
|
|
163
|
-
[Fleetbo] Developer token received and stored successfully!`),
|
|
164
|
-
Next step to connect your AI agents:`),
|
|
165
|
-
`),typeof o.closeAllConnections=="function"&&o.closeAllConnections(),o.close(()=>n()),setTimeout(()=>n(),300)}});o.listen(0,"127.0.0.1",()=>{let l=`https://fleetbo.io/cli-auth?port=${o.address().port}`;
|
|
166
|
-
[Fleetbo] Waiting for authentication...`),
|
|
167
|
-
`).forEach(r=>{let[l,...t]=r.split("=");l&&t.length>0&&(o[l.trim()]=t.join("=").trim())}),o}function
|
|
162
|
+
`),p(`
|
|
163
|
+
[Fleetbo] Developer token received and stored successfully!`),p(`
|
|
164
|
+
Next step to connect your AI agents:`),p(` npx fleetbo-svro mcp (Configure Cursor, Windsurf, Claude Code, etc.)
|
|
165
|
+
`),typeof o.closeAllConnections=="function"&&o.closeAllConnections(),o.close(()=>n()),setTimeout(()=>n(),300)}});o.listen(0,"127.0.0.1",()=>{let l=`https://fleetbo.io/cli-auth?port=${o.address().port}`;p(`
|
|
166
|
+
[Fleetbo] Waiting for authentication...`),p(`If your browser does not open automatically, visit: ${l}`),Se(l);let t=Number(process.env.FLEETBO_LOGIN_TIMEOUT_MS)||12e4;setTimeout(()=>{try{typeof o.closeAllConnections=="function"&&o.closeAllConnections()}catch{}o.close(),s(new Error(`Login timed out after ${Math.round(t/1e3)}s: browser approval not received. Run "npx fleetbo-svro login" once more and approve in the browser.`))},t).unref()}),o.on("error",r=>s(r))})}function Ie(e,n){return new Promise((s,o)=>{let r=JSON.stringify({enterpriseID:e,schema:n}),l={hostname:"fleetbo-gatekeeper.fleetbo.workers.dev",path:"/sync-schema",method:"POST",headers:{"Content-Type":"application/json","Content-Length":Buffer.byteLength(r)}},t=K.request(l,i=>{let c="";i.on("data",d=>{c+=d}),i.on("end",()=>{i.statusCode>=200&&i.statusCode<300?s(JSON.parse(c)):o(new Error(`Edge sync failed with HTTP ${i.statusCode}`))})});t.on("error",i=>o(i)),t.write(r),t.end()})}function J(e){let n=T.join(e,".env");if(!u.existsSync(n))return{};let s=u.readFileSync(n,"utf8"),o={};return s.split(`
|
|
167
|
+
`).forEach(r=>{let[l,...t]=r.split("=");l&&t.length>0&&(o[l.trim()]=t.join("=").trim())}),o}function Y(e,n){return new Promise((s,o)=>{let r=JSON.stringify({projectId:e,moduleName:n}),l={hostname:"getmodulecache-jqycakhlxa-uc.a.run.app",path:"/",method:"POST",headers:{"Content-Type":"application/json","Content-Length":Buffer.byteLength(r)}},t=K.request(l,i=>{let c="";i.on("data",d=>{c+=d}),i.on("end",()=>{if(i.statusCode>=200&&i.statusCode<300)try{let d=JSON.parse(c);if(d.success&&d.found&&d.module){let m=d.module.code||d.module.mockCode;s(typeof m=="string"?JSON.parse(m):m)}else s(null)}catch{o(new Error(`Invalid JSON response for ${n}.`))}else o(new Error(`Server error ${i.statusCode} while fetching ${n}`))})});t.on("error",i=>o(i)),t.write(r),t.end()})}var C=process.argv.slice(2),I=C[0];function Ae(e,n){return`# LE CONTRAT DE DONN\xC9ES FLEETBO (FLEETBO DATA CONTRACT)
|
|
168
168
|
|
|
169
169
|
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
170
|
|
|
171
171
|
### Pourquoi parlons-nous de \xAB Contrat \xBB ?
|
|
172
|
-
* **Une v\xE9rit\xE9 unique et scell\xE9e** : Ce contrat d\xE9finit l'int\xE9gralit\xE9 des r\xE8gles m\xE9tier, des types stricts, des permissions ReBAC et des machines \xE0 \xE9tats de l'application.
|
|
172
|
+
* **Une v\xE9rit\xE9 unique et scell\xE9e (en production)** : Ce contrat d\xE9finit l'int\xE9gralit\xE9 des r\xE8gles m\xE9tier, des types stricts, des permissions ReBAC et des machines \xE0 \xE9tats de l'application. Il fait foi de mani\xE8re absolue pour la consommation de donn\xE9es r\xE9elle (\`VITE_FLEETBO_PROTOTYPE=false\`) ; en mode prototype (\`true\`) il n'est pas contraignant sur les donn\xE9es et peut \xEAtre vierge (voir \xAB Mode d'ex\xE9cution \xBB).
|
|
173
173
|
* **Un bouclier d'int\xE9grit\xE9 d\xE9terministe** : Tout appel front-end (\xE9criture, mutation, transition) non conforme \xE0 ce contrat est rejet\xE9 imm\xE9diatement \xE0 l'Edge (HTTP 422) avant d'atteindre la base **en mode production** (\`VITE_FLEETBO_PROTOTYPE=false\`) ; en mode prototype, l'Edge est tol\xE9rant et simule (voir \xAB Mode d'ex\xE9cution \xBB).
|
|
174
174
|
* **Un accord d'ex\xE9cution bilat\xE9ral** :
|
|
175
|
-
1. **L'Agent / Le D\xE9veloppeur** s'engage \xE0 n'envoyer que des structures pr\xE9vues, sans inventer de routes interm\xE9diaires ni contourner le sch\xE9ma.
|
|
175
|
+
1. **L'Agent / Le D\xE9veloppeur** s'engage, en mode production (\`VITE_FLEETBO_PROTOTYPE=false\`), \xE0 n'envoyer que des structures pr\xE9vues, sans inventer de routes interm\xE9diaires ni contourner le sch\xE9ma. En prototype, il reste libre sur les champs mais respecte toujours la syntaxe du SDK (objet global, balises \`<fleetbo-*>\`) et n'invente aucun backend.
|
|
176
176
|
2. **Fleetbo Engine** s'engage \xE0 assurer la persistance, le stockage m\xE9dia, la synchronisation d\xE9terministe et le typage TypeScript natif sans n\xE9cessiter de backend d'API.
|
|
177
177
|
|
|
178
178
|
---
|
|
@@ -182,27 +182,70 @@ Ce document constitue le **Cahier des charges officiel et le Contrat bilat\xE9ra
|
|
|
182
182
|
L'agent DOIT adapter son impl\xE9mentation selon la valeur de \`VITE_FLEETBO_PROTOTYPE\` dans le fichier \`.env\` :
|
|
183
183
|
|
|
184
184
|
#### 1. Si VITE_FLEETBO_PROTOTYPE=true (MODE PROTOTYPE & VALIDATION UX)
|
|
185
|
-
* **Mode bac \xE0 sable visuel :** Tu con\xE7ois et valides l'ergonomie de l'interface.
|
|
185
|
+
* **Mode bac \xE0 sable visuel :** Tu con\xE7ois et valides l'ergonomie de l'interface. Le SDK tient un bac \xE0 sable local : les \xE9critures y sont enregistr\xE9es et relues par \`Fleetbo.getDocsG\`, \`getDocsU\`, \`getDoc\` et \`join\`, sans aucun appel r\xE9seau ni alt\xE9ration de la base physique.
|
|
186
186
|
* **Pr\xE9-c\xE2blage direct (Zero-Rewrite) :** N'attends pas que le sch\xE9ma BDD soit forg\xE9 pour coder. Branche imm\xE9diatement les m\xE9thodes globales (\`Fleetbo.getDocsG\`, \`Fleetbo.add\`, \`Fleetbo.update\`, etc.) et les balises \`<fleetbo-*>\`.
|
|
187
|
-
* **Donn\xE9es
|
|
188
|
-
* **
|
|
187
|
+
* **Donn\xE9es de d\xE9mo (\`Fleetbo.seed\`) :** Pour afficher des donn\xE9es en prototype, appelle \`await Fleetbo.seed('collection', [ ... ])\` avant la lecture : il initialise le bac \xE0 sable une seule fois (idempotent) et reste inerte en production. Lis ensuite avec \`Fleetbo.getDocsG\` comme n'importe quelles donn\xE9es, sans substituer un jeu local au r\xE9sultat de la lecture. Utilise aussi les attributs \`fallback="..."\` des balises \`<fleetbo-*>\`.
|
|
188
|
+
* **Contrat non contraignant sur les donn\xE9es :** Le contrat peut \xEAtre vierge ; c'est l'UI qui dicte les champs. Les r\xE8gles de syntaxe du SDK restent, elles, obligatoires.
|
|
189
|
+
* **Zero-Rewrite (philosophie) :** \xC9cris le code de la m\xEAme fa\xE7on que \`VITE_FLEETBO_PROTOTYPE\` soit \xE0 \`true\` ou \xE0 \`false\`, sans chemin de code s\xE9par\xE9 par mode. C\xE2ble d\xE8s le d\xE9part avec \`Fleetbo.*\`, les noms de collections et de champs r\xE9els, les casts de types et les balises \`<fleetbo-*>\` ; seules les donn\xE9es peuvent \xEAtre virtuelles (donn\xE9es de d\xE9mo via \`Fleetbo.seed\`, attributs \`fallback\`). C'est un principe de conception, pas une interdiction : corriger, am\xE9liorer et refactorer le code reste toujours permis.
|
|
190
|
+
* **Tol\xE9rance Edge :** Aucun appel front-end n'est bloqu\xE9. D\xE8s que l'utilisateur d\xE9clare les \xE9crans valid\xE9s, transmets tes fichiers de vues \xE0 Alex AI via \`fleetbo_update_project\` pour figer le sch\xE9ma r\xE9el.
|
|
189
191
|
|
|
190
192
|
#### 2. Si VITE_FLEETBO_PROTOTYPE=false (MODE PRODUCTION VERROUILL\xC9)
|
|
193
|
+
* **Le contrat fait foi de mani\xE8re absolue :** Aucun champ, aucune table et aucune r\xE8gle hors \`Fleetbo_contract.md\`.
|
|
191
194
|
* **Verrouillage Edge actif :** Le Gatekeeper Cloudflare filtre et valide physiquement chaque payload \xE0 l'entr\xE9e.
|
|
192
195
|
* **Tol\xE9rance z\xE9ro (HTTP 422) :** Tout champ non scell\xE9 dans \`svro.schema.json\` ou non conforme \xE0 \`svro.workflow.json\` est rejet\xE9 avant MongoDB.
|
|
193
196
|
* **Z\xE9ro r\xE9\xE9criture de code :** Gr\xE2ce au pr\xE9-c\xE2blage fait en mode prototype, la base physique prend le relais de mani\xE8re transparente sans modifier une seule ligne de code front-end.
|
|
194
197
|
|
|
195
198
|
---
|
|
196
199
|
|
|
200
|
+
### \u{1F9ED} PROTOCOLE DONN\xC9ES : QUI FAIT QUOI (AGENT FRONTEND \u2194 ALEX AI)
|
|
201
|
+
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.
|
|
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-*>.
|
|
237
|
+
|
|
238
|
+
---
|
|
239
|
+
|
|
197
240
|
### \u{1F6A8} DIRECTIVE D'EX\xC9CUTION OBLIGATOIRE POUR L'AGENT IA
|
|
198
|
-
1. **Interdiction d'extrapolation** :
|
|
199
|
-
2. **Refus de contournement** : Si un composant n\xE9cessite une donn\xE9e absente du contrat, n'\xE9cris aucun code palliatif : fais \xE9voluer le contrat (voir \xAB Faire \xE9voluer le contrat \xBB ci-dessous).
|
|
200
|
-
3. **Validit\xE9 physique** :
|
|
241
|
+
1. **Interdiction d'extrapolation (en production)** : Avec \`VITE_FLEETBO_PROTOTYPE=false\`, ne cr\xE9e aucun champ, type ou endpoint non d\xE9clar\xE9 explicitement dans les contrats scell\xE9s ci-dessous. En prototype (\`true\`), l'UI peut introduire de nouveaux champs (c\xE2blage r\xE9el, noms d\xE9finitifs) : ils sont scell\xE9s ensuite via \`fleetbo_update_project\`.
|
|
242
|
+
2. **Refus de contournement** : Si un composant n\xE9cessite une donn\xE9e absente du contrat, n'\xE9cris aucun code palliatif : fais \xE9voluer le contrat (voir \xAB Faire \xE9voluer le contrat \xBB ci-dessous). En prototype, c\xE2ble d'abord le champ pour de vrai (\`Fleetbo.*\`), puis fais \xE9voluer le contrat.
|
|
243
|
+
3. **Validit\xE9 physique (en production)** : Avec \`VITE_FLEETBO_PROTOTYPE=false\`, toute g\xE9n\xE9ration de code doit s'aligner \xE0 100 % sur les signatures et sch\xE9mas fournis, sous peine de rejet imm\xE9diat \xE0 l'Edge.
|
|
201
244
|
|
|
202
245
|
### \u{1F501} FAIRE \xC9VOLUER LE CONTRAT (MOD\xC9LISATION)
|
|
203
246
|
* La mod\xE9lisation n'est **pas** une commande shell : \`npx fleetbo-svro\` n'a aucune sous-commande \`update\` ou \`model\` (inutile de lancer \`--help\` pour en chercher une).
|
|
204
247
|
* **Avec le MCP Fleetbo** : appelle l'outil \`fleetbo_update_project\` avec \`name\` et \`filePaths\` (chemins des vues cr\xE9\xE9es, ex. \`src/components/DeskList.jsx\`), plus \`rules\` pour les r\xE8gles m\xE9tier \xE0 formaliser. \`keyApp\` est facultatif : il est lu dans le \`.env\` (VITE_FLEETBO_DB_KEY). Puis ex\xE9cute UNE fois \`npx fleetbo-svro sync\` : il rapatrie les contrats et r\xE9g\xE9n\xE8re ce fichier.
|
|
205
|
-
* **Sans MCP** : interromps-toi et fournis
|
|
248
|
+
* **Sans MCP** : interromps-toi et fournis \xE0 l'utilisateur un message pr\xEAt \xE0 copier-coller pour Alex AI dans Fleetbo Studio (Mode Analyze) ; quand il te dit qu'Alex a termin\xE9, ex\xE9cute \`npx fleetbo-svro sync\`.
|
|
206
249
|
|
|
207
250
|
---
|
|
208
251
|
|
|
@@ -219,16 +262,17 @@ Ton r\xF4le est de guider le d\xE9veloppeur ou l'utilisateur et de concevoir des
|
|
|
219
262
|
================================================================================
|
|
220
263
|
\u{1F6A8} PROTOCOLE UNIVERSEL DE COLLABORATION FRONTEND \u2194 ALEX AI (DATA OS) \u{1F6A8}
|
|
221
264
|
================================================================================
|
|
222
|
-
1. CONTRATS SCELL\xC9S ET IMMUABLES C\xD4T\xC9 CLIENT :
|
|
223
|
-
-
|
|
265
|
+
1. CONTRATS SCELL\xC9S ET IMMUABLES C\xD4T\xC9 CLIENT (EN PRODUCTION) :
|
|
266
|
+
- En mode production (\`VITE_FLEETBO_PROTOTYPE=false\`), l'agent d'interface (frontend) DOIT limiter ses op\xE9rations d'\xE9criture aux seuls champs d\xE9clar\xE9s dans \`svro.schema.json\`. En mode prototype (\`true\`), l'UI reste libre d'initier de nouveaux champs qui seront ensuite scell\xE9s via \`fleetbo_update_project\`.
|
|
224
267
|
- Les formules de calcul, validations, conditions et transitions d'\xE9tat DOIVENT respecter \xE0 la lettre les expressions scell\xE9es dans \`svro.workflow.json\`.
|
|
225
|
-
-
|
|
268
|
+
- En production, tout champ non d\xE9clar\xE9 ou calcul non conforme envoy\xE9 \xE0 la base sera rejet\xE9 imm\xE9diatement par le Gatekeeper Edge (HTTP 422).
|
|
226
269
|
|
|
227
|
-
2. PROTOCOLE STRICT DE REMOD\xC9LISATION OU RESTRUCTURATION DE DONN\xC9ES :
|
|
270
|
+
2. PROTOCOLE STRICT DE REMOD\xC9LISATION OU RESTRUCTURATION DE DONN\xC9ES (CONTRAT SCELL\xC9, MODE PRODUCTION) :
|
|
271
|
+
- En prototype (\`VITE_FLEETBO_PROTOTYPE=true\`), poursuis l'UI avec un c\xE2blage r\xE9el : la mod\xE9lisation intervient au scellage (\`fleetbo_update_project\` sur les vues cr\xE9\xE9es) et ne doit pas interrompre le travail.
|
|
228
272
|
- Si l'interface utilisateur requiert une nouvelle donn\xE9e, un changement de type, une relation suppl\xE9mentaire ou une r\xE8gle de calcul modifi\xE9e :
|
|
229
273
|
\u{1F449} INTERDICTION FORMELLE d'\xE9crire ou de simuler un contournement c\xF4t\xE9 code client.
|
|
230
274
|
\u{1F449} Avec le MCP Fleetbo : appelle imm\xE9diatement l'outil \`fleetbo_update_project \`, puis \`npx fleetbo-svro sync \`. Ne demande JAMAIS \xE0 l'utilisateur de se rendre dans Fleetbo Studio quand le serveur MCP est actif.
|
|
231
|
-
\u{1F449} Sans MCP : l'agent frontend DOIT IMM\xC9DIATEMENT interrompre son travail et fournir
|
|
275
|
+
\u{1F449} Sans MCP : l'agent frontend DOIT IMM\xC9DIATEMENT interrompre son travail et fournir \xE0 l'utilisateur un message pr\xEAt \xE0 copier-coller pour Alex AI dans Fleetbo Studio (voir PROTOCOLE DONN\xC9ES, point 5), puis ex\xE9cuter npx fleetbo-svro sync quand l'utilisateur dit qu'Alex a termin\xE9.
|
|
232
276
|
|
|
233
277
|
3. S\xC9PARATION STRICTE DES RESPONSABILIT\xC9S :
|
|
234
278
|
- Agent Frontend : g\xE8re exclusivement l'ergonomie, les composants d'affichage et l'UX.
|
|
@@ -253,6 +297,7 @@ Ton r\xF4le est de guider le d\xE9veloppeur ou l'utilisateur et de concevoir des
|
|
|
253
297
|
- UPDATE : await Fleetbo.update('collection', id, { price: Number(p) });
|
|
254
298
|
- DELETE : await Fleetbo.delete('collection', id);
|
|
255
299
|
- JOIN : await Fleetbo.join('orders', { innerJoin: { collection: 'users', on: ['userId', '==', 'id'], as: 'user' } });
|
|
300
|
+
- SEED (prototype uniquement, inerte en production) : await Fleetbo.seed('collection', [{ name: 'D\xE9mo', price: 10 }]);
|
|
256
301
|
- CLOUD FUNCTION : await Fleetbo.call('$functionName', payload);
|
|
257
302
|
|
|
258
303
|
---
|
|
@@ -268,23 +313,23 @@ ${JSON.stringify(e||{},null,2)}
|
|
|
268
313
|
\`\`\`json
|
|
269
314
|
${JSON.stringify(n||{},null,2)}
|
|
270
315
|
\`\`\`
|
|
271
|
-
`}async function
|
|
272
|
-
[Fleetbo] Initializing and configuring Fleetbo...`),await
|
|
316
|
+
`}async function _e(){let e=process.cwd(),n=T.join(e,"package.json");if(I==="init"||I==="doctor")p(`
|
|
317
|
+
[Fleetbo] Initializing and configuring Fleetbo...`),await Fe(e,C),Te(e,n),p(`
|
|
273
318
|
[Fleetbo] Configuration completed successfully!
|
|
274
|
-
`),
|
|
275
|
-
Next step:`),
|
|
276
|
-
`);else if(I==="sync"){let s=
|
|
277
|
-
`),
|
|
278
|
-
`),
|
|
279
|
-
`,"utf8"),
|
|
280
|
-
`,"utf8"),
|
|
319
|
+
`),p(`
|
|
320
|
+
Next step:`),p(` npx fleetbo-svro sync (Sync cloud schema & generate IDE types)
|
|
321
|
+
`);else if(I==="sync"){let s=C.includes("--dry-run");p(`[Fleetbo] Syncing schema...${s?" (dry-run)":""}`);let o=T.join(e,"svro.schema.json"),r=T.join(e,"svro.workflow.json"),l=T.join(e,"Fleetbo_contract.md"),t=T.join(__dirname,".."),i=T.join(t,"index.d.ts"),c=T.join(e,"src","fleetbo.d.ts"),m=J(e).VITE_FLEETBO_ENTERPRISE_ID,f=null,g=null;if(m)try{p("\u2192 Fetching latest contracts from Fleetbo Cloud..."),f=await Y(m,"svro.schema.json"),f&&(u.writeFileSync(o,JSON.stringify(f,null,2)+`
|
|
322
|
+
`),p("\u2192 Local svro.schema.json updated.")),g=await Y(m,"svro.workflow.json"),g&&(u.writeFileSync(r,JSON.stringify(g,null,2)+`
|
|
323
|
+
`),p("\u2192 Local svro.workflow.json updated."))}catch(E){P(`\u26A0\uFE0F Cloud fetch bypassed: ${E.message}. Using local file fallback.`)}else P("\u26A0\uFE0F VITE_FLEETBO_ENTERPRISE_ID missing in .env. Skipping cloud fetch.");let F=f;if(!F&&u.existsSync(o))try{F=JSON.parse(u.readFileSync(o,"utf8"))}catch{}F||(F={context:"Application en cours de mod\xE9lisation initiale.",collections:{}},u.writeFileSync(o,JSON.stringify(F,null,2)+`
|
|
324
|
+
`,"utf8"),p("\u2192 Initial blank svro.schema.json created."));let h=g;if(!h&&u.existsSync(r))try{h=JSON.parse(u.readFileSync(r,"utf8"))}catch{}h||(h={actors:{},sequences:[]},u.writeFileSync(r,JSON.stringify(h,null,2)+`
|
|
325
|
+
`,"utf8"),p("\u2192 Initial blank svro.workflow.json created."));let v=Ae(F,h);u.writeFileSync(l,v,"utf8"),p("\u2192 Fleetbo_contract.md successfully generated at project root.");try{let E=Object.keys(F.collections||{});if(m)try{await Ie(m,F),p("\u2192 Schema successfully sealed at Fleetbo Global Edge (O(1)).")}catch(S){P(`\u26A0\uFE0F Fleetbo Edge Shield sync warning: ${S.message}`)}let A=F.collections||{},N=Object.entries(A).map(([S,w])=>{let G=w.fields||w.schema||{},X=Object.entries(G).map(([z,L])=>{let _="any",x=String(typeof L=="string"?L:L.type||"").toLowerCase();return x==="string"||x==="text"||x==="media"?_="string":x==="number"?_="number":x==="boolean"||x==="toggle"?_="boolean":x==="array"&&(_="any[]"),` ${z}?:${_};`}).join(`
|
|
281
326
|
`);return` ${S}: {
|
|
282
327
|
${X}
|
|
283
328
|
};`}).join(`
|
|
284
|
-
`),D=
|
|
329
|
+
`),D=E.length>0?E.map(S=>`'${S}'`).join(" | "):"string",W=`// Generated by fleetbo-svro \u2014 Updated via fleetbo sync
|
|
285
330
|
|
|
286
331
|
export interface FleetboSchemaMap {
|
|
287
|
-
${
|
|
332
|
+
${N}
|
|
288
333
|
}
|
|
289
334
|
|
|
290
335
|
export type KnownFleetboTables = ${D};
|
|
@@ -324,6 +369,13 @@ export interface FleetboWriteResult {
|
|
|
324
369
|
error?: string;
|
|
325
370
|
}
|
|
326
371
|
|
|
372
|
+
export interface FleetboSeedResult {
|
|
373
|
+
success: boolean;
|
|
374
|
+
seeded: boolean;
|
|
375
|
+
isPrototype: boolean;
|
|
376
|
+
count?: number;
|
|
377
|
+
}
|
|
378
|
+
|
|
327
379
|
export interface FleetboCallResult<T = any> {
|
|
328
380
|
success: boolean;
|
|
329
381
|
data?: T;
|
|
@@ -408,6 +460,12 @@ export declare const Fleetbo: {
|
|
|
408
460
|
|
|
409
461
|
join<T = any>(table: FleetboTables, options: FleetboJoinOptions): Promise<T[]>;
|
|
410
462
|
|
|
463
|
+
/**
|
|
464
|
+
* Donn\xE9es de d\xE9mo du mode prototype (VITE_FLEETBO_PROTOTYPE=true).
|
|
465
|
+
* Initialise la collection une seule fois (idempotent). Inerte en production.
|
|
466
|
+
*/
|
|
467
|
+
seed<T extends string = FleetboTables>(table: T, items: Array<FleetboData<T>>): Promise<FleetboSeedResult>;
|
|
468
|
+
|
|
411
469
|
sendotpsvro(options: string | FleetboOtpOptions): Promise<FleetboWriteResult>;
|
|
412
470
|
verifyotpsvro(email: string, code: string): Promise<FleetboAuthResult>;
|
|
413
471
|
|
|
@@ -544,7 +602,7 @@ declare module 'svelte/elements' {
|
|
|
544
602
|
'fleetbo-reference': FleetboProp;
|
|
545
603
|
}
|
|
546
604
|
}
|
|
547
|
-
`;if(
|
|
605
|
+
`;if(u.writeFileSync(i,W),u.existsSync(T.dirname(c))){let S=`/* eslint-disable */
|
|
548
606
|
/* prettier-ignore */
|
|
549
607
|
// @ts-nocheck
|
|
550
608
|
// Generated by fleetbo-svro \u2014 Updated via fleetbo sync
|
|
@@ -573,7 +631,7 @@ type FleetboProp = {
|
|
|
573
631
|
};
|
|
574
632
|
|
|
575
633
|
interface FleetboSchemaMap {
|
|
576
|
-
${
|
|
634
|
+
${N}
|
|
577
635
|
}
|
|
578
636
|
|
|
579
637
|
declare global {
|
|
@@ -678,21 +736,22 @@ declare module 'svelte/elements' {
|
|
|
678
736
|
'fleetbo-reference': FleetboProp;
|
|
679
737
|
}
|
|
680
738
|
}
|
|
681
|
-
`;
|
|
682
|
-
[Fleetbo] Configuring MCP server for your environment...`);let l=
|
|
683
|
-
`)},c=
|
|
684
|
-
Universal connection command for Claude Code and standalone agents:`),
|
|
739
|
+
`;u.writeFileSync(c,S)}he(e),ye(e,n),ve(e),p(`[Fleetbo] Schema synced successfully (${E.length} collection(s)).`),s&&p("\u2192 [Dry-run] Schema is valid.")}catch(E){P(`Error during synchronization: ${E.message}`),process.exit(1)}}else if(I==="mcp"){let s=C.includes("--run"),o=!1;if(!s&&!process.stdin.isTTY&&(s=await new Promise(f=>{let g=process.stdin,F=null,h=A=>{clearTimeout(F),g.removeListener("data",v),g.removeListener("end",E),g.removeListener("error",E),f(A)},v=A=>{g.pause(),g.unshift(A),o=!0,h(!0)},E=()=>h(!1);F=setTimeout(()=>{g.pause(),h(!1)},1500),g.on("data",v),g.once("end",E),g.once("error",E)})),s){try{await import(`file://${T.join(__dirname,"fleetbo-mcp.js")}`),o&&process.stdin.resume()}catch(f){P(`Failed to start MCP server: ${f.message}`),process.exit(1)}return}p(`
|
|
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
|
|
685
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
|
|
686
744
|
|
|
687
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).
|
|
688
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.
|
|
689
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'.
|
|
690
|
-
4. D\xE8s la cr\xE9ation valid\xE9e, ex\xE9cute la commande renvoy\xE9e ('commandInit') \xE0 la racine et commence le code UI avec l'objet global Fleetbo.*.
|
|
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.*.
|
|
691
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.
|
|
692
|
-
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.
|
|
693
|
-
7. Avant d'\xE9crire du code de donn\xE9es, lis VITE_FLEETBO_PROTOTYPE dans le '.env' du projet : true = prototype purement visuel (
|
|
694
|
-
|
|
695
|
-
|
|
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)
|
|
696
755
|
|
|
697
756
|
Commands:
|
|
698
757
|
login Authenticate this machine (opens the browser: approve once, the command exits by itself)
|
|
@@ -705,4 +764,4 @@ Modeling has NO shell command: to evolve the schema/workflow from your UI files,
|
|
|
705
764
|
"fleetbo_update_project" (keyApp is optional), then run "sync" once.
|
|
706
765
|
Run login / mcp at most once each and wait for them to finish. Nothing else needs to be
|
|
707
766
|
discovered: do not search the filesystem or read files outside the project.
|
|
708
|
-
`),process.exit(0)):(P('Unknown command. Run "npx fleetbo-svro --help".'),process.exit(1))}
|
|
767
|
+
`),process.exit(0)):(P('Unknown command. Run "npx fleetbo-svro --help".'),process.exit(1))}_e().catch(e=>{P(`Fleetbo CLI Error: ${e.message}`),process.exit(1)});
|
package/dist/fleetbo-mcp.js
CHANGED
|
@@ -52,15 +52,20 @@ const FLEETBO_SYSTEM_GUIDELINES = `
|
|
|
52
52
|
👉 Appelle IMMÉDIATEMENT l'outil MCP 'fleetbo_create_project'.
|
|
53
53
|
👉 INTERDICTION de lancer des commandes shell exploratoires ('env', 'grep', 'fleetbo login', 'fleetbo --help').
|
|
54
54
|
👉 Le serveur MCP dispose déjà des autorisations Cloud.
|
|
55
|
-
2. Attends le retour de 'fleetbo_create_project' et exécute la commande 'commandInit' fournie.
|
|
55
|
+
2. Attends le retour de 'fleetbo_create_project'. Si le projet frontend Vite n'existe pas encore, crée-le d'abord (avec React et Tailwind si l'utilisateur les demande), puis exécute la commande 'commandInit' fournie à la racine de ce projet.
|
|
56
56
|
|
|
57
57
|
================================================================================
|
|
58
58
|
🚨 PROTOCOLE UNIVERSEL FRONTEND ↔ ALEX AI : L'AUTORITÉ DU CONTRAT 🚨
|
|
59
59
|
================================================================================
|
|
60
|
-
1. LA SOURCE DE VÉRITÉ
|
|
60
|
+
1. LA SOURCE DE VÉRITÉ : « Fleetbo_contract.md » (PORTÉE SELON LE MODE)
|
|
61
61
|
- Dès l'entame de toute tâche, l'agent DOIT inspecter Fleetbo_contract.md.
|
|
62
|
-
-
|
|
62
|
+
- Avant d'écrire du code de données, l'agent lit VITE_FLEETBO_PROTOTYPE dans le '.env' du projet (lecture autorisée).
|
|
63
|
+
- VITE_FLEETBO_PROTOTYPE=false (consommation de données réelle) : le contrat fait foi de manière ABSOLUE.
|
|
64
|
+
L'agent n'a le droit d'utiliser AUCUN champ, AUCUNE table et AUCUNE règle
|
|
63
65
|
qui ne soit pas explicitement formalisée dans Fleetbo_contract.md.
|
|
66
|
+
- VITE_FLEETBO_PROTOTYPE=true (prototype) : le contrat n'est PAS contraignant sur les données (il peut être vierge).
|
|
67
|
+
L'UI dicte les champs. Les DONNÉES peuvent être virtuelles, mais le CÂBLAGE doit être réel (voir PHILOSOPHIE ZERO-REWRITE, étape 2).
|
|
68
|
+
- Dans les DEUX modes, les règles de syntaxe restent obligatoires : objet global Fleetbo, balises <fleetbo-*> autorisées, aucun backend inventé.
|
|
64
69
|
|
|
65
70
|
2. INTERDICTION DU MODE « SCHEMA-FIRST » / FLEETBO-FIRST :
|
|
66
71
|
- L'agent ne doit JAMAIS concevoir, imaginer ou modéliser un schéma BDD avant l'interface.
|
|
@@ -74,8 +79,52 @@ const FLEETBO_SYSTEM_GUIDELINES = `
|
|
|
74
79
|
- CONTRÔLE DE FLUX UI : Utilise impérativement la syntaxe native standard du framework du projet (conditions ternaires, boucles natives, v-for, .map, etc.).
|
|
75
80
|
- INTERDICTION FORMELLE d'inventer des balises de structure inconnues (<fleetbo-list>, <fleetbo-if>, <fleetbo-else>, <fleetbo-button>, <template>).
|
|
76
81
|
- COMPOSANTS D'AFFICHAGE SÉCURISÉS : Seuls les composants Web <fleetbo-text value="..." fallback="..." /> et <fleetbo-number value="..." currency="EUR" /> sont autorisés.
|
|
82
|
+
- LIAISON DE 'value' SELON LE FRAMEWORK : React / Preact / Svelte : value={item.name} ; Vue : :value="item.name" ;
|
|
83
|
+
HTML pur : attribut renseigné via setAttribute, avec balise fermante explicite (<fleetbo-text ...></fleetbo-text>) :
|
|
84
|
+
l'auto-fermeture n'est valide qu'en JSX, Vue SFC et Svelte.
|
|
77
85
|
- OPÉRATIONS DE DONNÉES : Passe exclusivement par l'objet global JavaScript : Fleetbo.getDocsG(), Fleetbo.add(), Fleetbo.update(), Fleetbo.delete().
|
|
78
86
|
|
|
87
|
+
================================================================================
|
|
88
|
+
🚨 PROTOCOLE DONNÉES : QUI FAIT QUOI (AGENT FRONTEND ↔ ALEX AI) 🚨
|
|
89
|
+
================================================================================
|
|
90
|
+
1. TA LIBERTÉ : tout le front-end t'appartient (rendu, état, styles, navigation, composants, logique d'interface, choix du framework). Fleetbo ne gère que les données, l'authentification et le stockage. Un changement qui ne touche pas aux données ne demande l'accord de personne.
|
|
91
|
+
|
|
92
|
+
2. TON INTERLOCUTEUR n'est pas développeur. Dans tes messages à l'utilisateur (pas dans le code), parle français simple et sans jargon : ne dis jamais prototype, true, false, .env, contrat, schéma, sync, Edge, endpoint, collection ni fleetbo_update_project. Dis plutôt :
|
|
93
|
+
- « mode essai » (données de démonstration) pour VITE_FLEETBO_PROTOTYPE=true, et « mode réel » (vraies données) pour false ;
|
|
94
|
+
- « la structure de vos données » pour le contrat ;
|
|
95
|
+
- « Alex, l'assistant de Fleetbo qui prépare la structure de vos données » pour Alex ;
|
|
96
|
+
- « j'enregistre la nouvelle structure » pour la synchronisation.
|
|
97
|
+
Fais toi-même toutes les manipulations techniques (terminal, commandes, fichiers) : ne demande jamais à l'utilisateur de les faire. Avant le premier passage de main à Alex (5a) et avant tout changement de mode, explique en une phrase ce que tu vas faire et pourquoi, puis attends un « oui » simple. Pour les évolutions suivantes (5b, 5c), la demande de l'utilisateur vaut accord : annonce simplement ce que tu fais.
|
|
98
|
+
|
|
99
|
+
3. MODE PROTOTYPE (VITE_FLEETBO_PROTOTYPE=true, « mode essai » pour l'utilisateur) : le but est de valider les écrans et le parcours visuel.
|
|
100
|
+
- Écris l'UI avec le câblage réel : Fleetbo.getDocsG / getDocsU / getDoc / add / update / delete / join, noms de collections et de champs définitifs, casts de types, balises <fleetbo-*>.
|
|
101
|
+
- Les données sont virtuelles : Fleetbo.seed('collection', [...]) puis lecture normale.
|
|
102
|
+
- Le contrat peut être vierge : ne l'attends pas et ne le conçois pas. L'UI dicte les champs.
|
|
103
|
+
- Avant le premier enregistrement de la structure (5a), n'appelle pas Alex à chaque modification : cela se fait quand l'utilisateur valide les écrans.
|
|
104
|
+
|
|
105
|
+
4. MODE PRODUCTION (VITE_FLEETBO_PROTOTYPE=false, « mode réel » pour l'utilisateur) : le contrat fait foi.
|
|
106
|
+
- Aucun champ, aucune collection, aucune règle hors Fleetbo_contract.md.
|
|
107
|
+
- Aucune donnée fictive (Fleetbo.seed est inerte). Une erreur de l'Edge (HTTP 422, permission-denied...) se lit et se corrige : elle ne se masque pas.
|
|
108
|
+
- Si un écran a besoin d'une donnée absente du contrat : aucun contournement, applique le point 5b.
|
|
109
|
+
- Au premier passage en mode réel, la base est vide (Fleetbo.seed est inerte) : préviens l'utilisateur en une phrase et vérifie que l'app permet de créer les données (formulaires d'ajout).
|
|
110
|
+
|
|
111
|
+
5. QUAND PASSER LA MAIN À ALEX (dans ces cas, et seulement dans ces cas) :
|
|
112
|
+
a) L'utilisateur confirme que les écrans lui conviennent et veut passer aux vraies données : premier enregistrement de la structure de ses données. Ne présume jamais cet accord ; si le moment te semble venu, propose-le simplement (« Les écrans vous conviennent-ils ? Si oui, je demande à Alex de préparer la structure de vos données. »).
|
|
113
|
+
b) Après ce premier enregistrement, une donnée est ajoutée, modifiée ou supprimée (collection, champ, type, relation, règle métier, permission) : passe la main dès que la vue est écrite.
|
|
114
|
+
c) L'utilisateur te le demande.
|
|
115
|
+
Comment : appelle fleetbo_update_project avec name, filePaths et rules, puis applique le point 7.
|
|
116
|
+
- filePaths : tous les fichiers qui appellent Fleetbo.* ou qui décrivent des champs (les vues ET les fichiers de données, jamais seulement les vues) ; tous en cas de doute.
|
|
117
|
+
- rules : uniquement les règles métier données par l'utilisateur, en texte. Si tu n'en as aucune, demande-lui simplement s'il y a des règles à respecter (limites, durées, droits) ; s'il n'en a pas, n'envoie pas de rules. N'invente jamais une règle.
|
|
118
|
+
Sans MCP : arrête-toi, donne à l'utilisateur un message prêt à copier-coller pour Alex et explique simplement où le coller (Fleetbo Studio, discussion avec Alex, mode Analyze) sans inventer de boutons ni de menus ; quand il te dit qu'Alex a terminé, applique le point 7.
|
|
119
|
+
Pour une évolution, propose (sans l'imposer) de revenir d'abord en mode essai pour valider les écrans avant d'enregistrer la nouvelle structure.
|
|
120
|
+
|
|
121
|
+
6. NE PASSE PAS LA MAIN À ALEX pour : style, mise en page, textes, navigation, composants, état ou logique d'interface, correction de bug front, données de démonstration (Fleetbo.seed).
|
|
122
|
+
|
|
123
|
+
7. SYNCHRONISATION : après chaque mise à jour du backend Fleetbo (contrat, svro.schema.json, svro.workflow.json...), exécute npx fleetbo-svro sync avant de continuer à coder. Cela vaut quelle que soit l'origine de la mise à jour : toi (fleetbo_update_project) ou Alex dans Fleetbo Studio (dès que l'utilisateur te dit qu'Alex a modifié ou validé quelque chose). Fais-le toi-même, puis dis à l'utilisateur en une phrase que la nouvelle structure est enregistrée.
|
|
124
|
+
|
|
125
|
+
8. NE FAIS JAMAIS : modifier VITE_FLEETBO_PROTOTYPE de ta propre initiative (uniquement avec l'accord explicite de l'utilisateur, après lui avoir expliqué en une phrase la différence entre mode essai et mode réel) ; concevoir ou éditer svro.schema.json et svro.workflow.json (autorité d'Alex) ; écrire un backend, une route d'API ou un ORM ; inventer des méthodes Fleetbo.* ou des balises <fleetbo-*>.
|
|
126
|
+
================================================================================
|
|
127
|
+
|
|
79
128
|
# WORKFLOW DE PRODUCTION UNIFIÉ FLEETBO SVRO (ZERO-BACKEND DATA OS)
|
|
80
129
|
|
|
81
130
|
## 🚀 Le Cycle de Production Unifié en 5 Étapes
|
|
@@ -87,7 +136,7 @@ const FLEETBO_SYSTEM_GUIDELINES = `
|
|
|
87
136
|
- Aucun schéma préalable n'est requis ni autorisé. Le Cloud réserve la base et retourne 'bootstrapToken'.
|
|
88
137
|
|
|
89
138
|
### Étape 1 : Amorçage Local & Contrat Initial Vierge
|
|
90
|
-
- Exécution obligatoire de la commande combinée à la racine :
|
|
139
|
+
- Exécution obligatoire de la commande combinée à la racine du projet frontend Vite (à créer d'abord s'il n'existe pas) :
|
|
91
140
|
npx fleetbo-svro init --keyApp=<KEY> --token=<TOKEN> && npx fleetbo-svro sync
|
|
92
141
|
- Effet immédiat :
|
|
93
142
|
1. Le runtime et les Web Components natifs sont injectés.
|
|
@@ -101,12 +150,16 @@ const FLEETBO_SYSTEM_GUIDELINES = `
|
|
|
101
150
|
- Seuls composants Web autorisés pour l'affichage : <fleetbo-text value="..." fallback="..." /> et <fleetbo-number value="..." currency="EUR" />.
|
|
102
151
|
- Toute interaction de données passe par les méthodes JavaScript : Fleetbo.getDocsG(), Fleetbo.add(), Fleetbo.delete().
|
|
103
152
|
- Interrupteur d'environnement VITE_FLEETBO_PROTOTYPE (à lire dans le .env du projet avant d'écrire du code de données ; le code reste identique dans les deux modes) :
|
|
104
|
-
- true : prototype purement visuel.
|
|
153
|
+
- true : prototype purement visuel. Le SDK tient un bac à sable local (aucun appel réseau, base physique jamais sollicitée) : les écritures sont relues par Fleetbo.getDocsG / getDocsU / getDoc / join. Données de démo : await Fleetbo.seed('collection', [...]) avant la lecture (idempotent, inerte en production). But : valider les interfaces et le workflow. Le contrat n'est pas contraignant sur les données.
|
|
105
154
|
- false : production. Fleetbo.* prend le relais et la sécurité Edge s'applique (rejet HTTP 422 hors contrat scellé, écritures physiques). Ne masque pas une erreur Edge derrière des données fictives.
|
|
106
|
-
- L'agent ne modifie jamais cette valeur
|
|
155
|
+
- L'agent ne modifie jamais cette valeur de sa propre initiative : la bascule se fait uniquement avec l'accord explicite de l'utilisateur (voir PROTOCOLE DONNÉES, point 8).
|
|
156
|
+
- PHILOSOPHIE ZERO-REWRITE : écris le code de la même façon que VITE_FLEETBO_PROTOTYPE soit à true ou à false, sans chemin de code séparé par mode.
|
|
157
|
+
Câble dès le départ avec Fleetbo.*, les collections et champs réels, les casts de types (String, Number, Boolean) et les balises <fleetbo-*> ;
|
|
158
|
+
seules les DONNÉES peuvent être virtuelles en prototype (données de démo via Fleetbo.seed, fallback).
|
|
159
|
+
C'est un principe de conception, pas une interdiction : corriger, améliorer et refactorer le code reste toujours permis.
|
|
107
160
|
|
|
108
161
|
### Étape 3 : Modélisation Additive & Extraction Métier (Alex AI)
|
|
109
|
-
- L'agent transmet les fichiers UI et les contraintes métier via 'fleetbo_update_project'.
|
|
162
|
+
- L'agent transmet les fichiers UI et les contraintes métier via 'fleetbo_update_project'. Moment et conditions : voir PROTOCOLE DONNÉES, point 5.
|
|
110
163
|
- Alex AI analyse les composants, extrait les entités et forge svro.schema.json et svro.workflow.json.
|
|
111
164
|
|
|
112
165
|
### Étape 4 : Scellage Edge, Typage Global & Contrat Markdown
|
|
@@ -128,6 +181,7 @@ const FLEETBO_SYSTEM_GUIDELINES = `
|
|
|
128
181
|
- UPDATE : await Fleetbo.update('collection', id, { price: Number(p) });
|
|
129
182
|
- DELETE : await Fleetbo.delete('collection', id);
|
|
130
183
|
- JOIN : await Fleetbo.join('orders', { innerJoin: { collection: 'users', on: ['userId', '==', 'id'], as: 'user' } });
|
|
184
|
+
- SEED (prototype uniquement, inerte en production) : await Fleetbo.seed('collection', [{ name: 'Démo', price: 10 }]);
|
|
131
185
|
- CLOUD FUNCTION : const res = await Fleetbo.call('$functionName', payload);
|
|
132
186
|
`;
|
|
133
187
|
|
|
@@ -226,7 +280,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
|
226
280
|
filePaths: {
|
|
227
281
|
type: "array",
|
|
228
282
|
items: { type: "string" },
|
|
229
|
-
description: "Relative paths of
|
|
283
|
+
description: "Relative paths of ALL files that call Fleetbo.* or define data fields: views AND data-layer files (e.g. ['src/views/Bookings.jsx', 'src/lib/data.js']).",
|
|
230
284
|
},
|
|
231
285
|
viewFiles: {
|
|
232
286
|
type: "array",
|
|
@@ -379,7 +433,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
|
379
433
|
directive: "Execute commandInit immediately in terminal shell to bootstrap local env, generate src/fleetbo.d.ts and seal Fleetbo_contract.md.",
|
|
380
434
|
nextSteps: [
|
|
381
435
|
"1. Run commandInit in your terminal to bootstrap local env, fetch initial contracts, and generate src/fleetbo.d.ts + Fleetbo_contract.md.",
|
|
382
|
-
"2. Inspect Fleetbo_contract.md and start writing UI views (.jsx/.tsx) using global Fleetbo.* and <fleetbo-*> tags directly.",
|
|
436
|
+
"2. Inspect Fleetbo_contract.md and start writing UI views (.jsx/.tsx/.vue/.svelte) using global Fleetbo.* and <fleetbo-*> tags directly.",
|
|
383
437
|
"3. Call 'fleetbo_update_project' with the UI view files to let Alex AI infer schemas and business rules.",
|
|
384
438
|
"4. Run 'npx fleetbo-svro sync' to seal the production Edge and update contracts.",
|
|
385
439
|
],
|
|
@@ -515,10 +569,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
|
515
569
|
status: cloudWarnings.length ? "PARTIAL" : "SUCCESS",
|
|
516
570
|
keyApp: activeKeyApp,
|
|
517
571
|
...(cloudWarnings.length ? { warnings: cloudWarnings } : {}),
|
|
518
|
-
message:
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
572
|
+
message: cloudWarnings.length
|
|
573
|
+
? `Alex AI could NOT update the data structure (${cloudWarnings.join(", ")}). The contract is unchanged: do NOT tell the user it was saved.`
|
|
574
|
+
: `Alex AI modeled ${filesPayload.length} component(s) and registered business rules successfully.`,
|
|
575
|
+
actionRequired: cloudWarnings.length ? "retry fleetbo_update_project once" : "npx fleetbo-svro sync",
|
|
576
|
+
directive: cloudWarnings.length
|
|
577
|
+
? "Retry 'fleetbo_update_project' once. If it fails again, do NOT run sync as if it had worked: tell the user in plain words that the structure could not be saved, and give them the ready-to-paste message for Alex in Fleetbo Studio."
|
|
578
|
+
: "RUN 'npx fleetbo-svro sync' in terminal now to fetch contracts, seal Edge KV, update TypeScript types and generate Fleetbo_contract.md.",
|
|
522
579
|
},
|
|
523
580
|
null,
|
|
524
581
|
2
|