@turbobase/cli 1.45.0 → 1.45.1

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.
@@ -4273,7 +4273,7 @@ ${o.map(RA).join(`
4273
4273
  `))}async function Pw(t,e,r=So){let n=[...new Set(t.map(a=>a.trim()).filter(Boolean))];n.length===0&&k("name at least one skill slug. `turbobase skills list` shows them.");let o=await $o(e,r);if(!await Ta(`Publish ${n.length} skill(s)?`,"Yes \u2014 publish them","their text is injected into every matching turn from now on",e))return;let i;try{i=await ie("publishing",()=>o.skillsPublish(n))}catch(a){te(a,"skills:publish","publish a skill"),k(`publish failed: ${a instanceof Error?a.message:String(a)}`)}_(f.green(`published ${i.published.length} skill(s) \u2014 live now.`)),i.unknown.length>0&&(D(f.yellow(`no such skill: ${i.unknown.join(", ")}`)),process.exitCode=1),D(f.dim(`release v${i.version.version_no} \xB7 undo with: turbobase skills unpublish ${i.published.join(" ")}`))}async function Aw(t,e,r=So){let n=[...new Set(t.map(a=>a.trim()).filter(Boolean))];n.length===0&&k("name at least one skill slug. `turbobase skills list` shows them.");let o=await $o(e,r);if(!await Ta(`Move ${n.length} skill(s) back to draft?`,"Yes \u2014 unpublish them","they stop being injected immediately; the text and its history are kept",e))return;let i;try{i=await ie("unpublishing",()=>o.skillsUnpublish(n))}catch(a){te(a,"skills:publish","unpublish a skill"),k(`unpublish failed: ${a instanceof Error?a.message:String(a)}`)}_(f.green(`unpublished ${i.unpublished.length} skill(s) \u2014 retracted now.`)),D(f.dim(`release v${i.version.version_no} \xB7 re-publish with: turbobase skills publish ${i.unpublished.join(" ")}`)),i.unknown.length>0&&(D(f.yellow(`no such skill: ${i.unknown.join(", ")}`)),process.exitCode=1)}async function Cw(t,e,r=So){let n=Number(t);(!Number.isInteger(n)||n<1)&&k(`--version must be a release number (got '${t}'). \`turbobase skills releases\` lists them.`);let o=await $o(e,r);if(await Ta(`Roll the skills back to release v${n}?`,"Yes \u2014 restore that release","content only: a skill an operator has since unpublished stays off",e))try{let i=await ie("rolling back",()=>o.skillsRollback(n));_(f.green(`rolled back to v${i.version.version_no}.`))}catch(i){te(i,"skills:publish","roll back a skills release"),k(`rollback failed: ${i instanceof Error?i.message:String(i)}`)}}async function Iw(t,e=So){let r=await $o(t,e),n;try{n=await ie("reading the releases",()=>r.skillsReleases())}catch(o){te(o,"skills:publish","read the skills releases"),k(`could not read the releases: ${o instanceof Error?o.message:String(o)}`)}if(n.items.length===0){D("no releases yet.");return}for(let o of n.items){let s=o.is_current?f.green("*"):" ",i=o.release_note?` \u2014 ${o.release_note}`:"";_(`${s} v${o.version_no} ${o.skill_count} skill(s) ${f.dim(o.published_at)}${o.published_by?f.dim(` by ${o.published_by}`):""}${f.dim(i)}`)}}async function Ow(t,e,r=So){let n=[...new Set((t??[]).map(l=>l.trim()).filter(Boolean))];n.length===0&&k("name at least one skill to delete. `turbobase skills list` shows the slugs.");let o=await $o(e,r);if(!await Ta(n.length===1?`Delete the skill '${n[0]}'?`:`Delete ${n.length} skills?
4274
4274
  ${n.join(`
4275
4275
  `)}`,"Yes \u2014 delete them","permanent: the rows and their text are removed. Prior releases keep their own copy.",e))return;let i=[],a=[];for(let l of n)try{i.push(await ie(`deleting ${l}`,()=>o.skillsDelete(l)))}catch(u){if(u instanceof se&&u.status===404){a.push(l);continue}i.length>0&&D(f.dim(`deleted before the error: ${i.map(p=>p.slug).join(", ")}`)),te(u,"skills:publish","delete a skill"),k(`delete failed on '${l}': ${u instanceof Error?u.message:String(u)}`)}i.length>0&&_(f.green(`deleted ${i.length} skill(s).`));let c=i.filter(l=>l.wasPublished).map(l=>l.slug);c.length>0&&D(f.yellow(`Published until now, so no longer injected: ${c.join(", ")}`)),a.length>0&&(D(f.yellow(`no such skill: ${a.join(", ")}`)),process.exitCode=1)}import{promises as Nw}from"node:fs";import{join as mC,relative as fC,resolve as gC,sep as yC}from"node:path";var bC=new Set(["node_modules","dist","build","coverage",".git",".claude",".turbobase",".next",".svelte-kit",".vercel",".cache"]),wC=new Set([".mcp.json",".env"]);function _C(t){return wC.has(t)||t.startsWith(".env.")&&t!==".env.example"}function vC(t){return Buffer.compare(Buffer.from(t.toString("utf8"),"utf8"),t)===0}function kC(t){return t.includes(0)}async function Uu(t){let e=gC(t),r={},n=[],o=[],s=[];async function i(a){let c=await Nw.readdir(a,{withFileTypes:!0});for(let l of c){let u=mC(a,l.name);if(bC.has(l.name))continue;if(l.isDirectory()){await i(u);continue}if(!l.isFile())continue;let p=fC(e,u).split(yC).join("/");if(_C(l.name)){o.push(p);continue}let b=await Nw.readFile(u);if(!vC(b)){n.push(p);continue}kC(b)&&s.push(p),r[p]=b.toString("utf8")}}return await i(e),{files:r,skipped:n,secrets:o,unstorable:s}}import{randomBytes as xC}from"node:crypto";var SC="/_tb/app-assets",$C=16,TC=/^[0-9a-f]{32}$/;function Lw(){return xC($C).toString("hex")}function RC(t){return TC.test(t)}function jw(t){if(!RC(t))throw new Error(`not a build id: ${t}`);return`${SC}/${t}/`}var zw=7;Fu();var Bu=50*1024*1024;import Ra from"node:fs/promises";import xs from"node:path";var Zu={esbuild:"0.28.1","isolated-vm":"6.1.2"},Vu="@turbobase/isolated-vm-prebuilds";function Hu(t,e){return`${t}-${e}`}function Ku(t=process.versions){return`abi${t.modules}`}var Dw=["darwin-x64","win32-arm64"];async function Mw(t){let e=t.platform??process.platform,r=t.arch??process.arch,n=Hu(e,r),o=xs.join(t.home,"node_modules"),s=xs.join(o,...Vu.split("/"),"prebuilds",n),i=xs.join(o,"isolated-vm","prebuilds",n),a;try{a=await Ra.readdir(s)}catch{return[]}let c=[];await Ra.mkdir(i,{recursive:!0});for(let l of a){if(!l.endsWith(".node"))continue;let u=xs.join(i,l);try{await Ra.copyFile(xs.join(s,l),u,Ra.constants?.COPYFILE_EXCL??1),c.push(l)}catch{}}return c}import{homedir as EC}from"node:os";import{join as Uw}from"node:path";import{promises as Wu}from"node:fs";function Fw(){let t=process.env.TURBOBASE_HOME??Uw(EC(),".turbobase");return{dir:t,file:Uw(t,"sandboxes.json")}}var PC={s:1e3,m:6e4,h:36e5,d:864e5};function AC(t){let e=/^\s*(\d+)\s*([smhd])\s*$/.exec(t);if(!e)throw new Error(`invalid --ttl '${t}': expected <number><unit> where unit is s|m|h|d (e.g. 72h, 30m, 7d).`);let r=Number(e[1]);if(!Number.isFinite(r)||r<=0)throw new Error(`invalid --ttl '${t}': duration must be a positive integer.`);return r*PC[e[2]]}function CC(t,e=Date.now()){return new Date(e+AC(t)).toISOString()}function IC(t,e=Date.now()){let r=Date.parse(t);return Number.isNaN(r)?!0:r<=e}function OC(t){let e=/^\s*(\d+(?:\.\d+)?)\s*%?\s*$/.exec(t);if(!e)throw new Error(`invalid --sample '${t}': expected a percent like 2% (or a bare number).`);let r=Number(e[1]);if(!Number.isFinite(r)||r<0||r>100)throw new Error(`invalid --sample '${t}': percent must be between 0 and 100.`);return r/100}function NC(t,e){if(e>=1)return[...t];if(e<=0||t.length===0)return[];let r=Math.max(1,Math.round(1/e)),n=[];for(let o=0;o<t.length;o+=r)n.push(t[o]);return n}var LC="[REDACTED]",Ss=class extends Error{constructor(e){super(e),this.name="SandboxDataCopyUnavailableError"}},Gu=class extends Error{table;column;constructor(e,r,n){super(`Refusing to copy ${e}.${r} into a sandbox: ${n}. A sandbox must never hold un-redacted PII \u2014 classify the column 'safe' (non-PII) or let redaction mask it, then retry.`),this.name="UnredactedPiiError",this.table=e,this.column=r}};function jC(t,e,r){let n={};for(let[o,s]of Object.entries(e)){let i=r[o];if(i===void 0)throw new Gu(t,o,"column has no PII classification (unknown = unsafe)");i==="pii"?n[o]=s==null?s:LC:n[o]=s}return n}function zC(t,e,r){return e.map(n=>jC(t,n,r))}var qw=new Set(["localhost","127.0.0.1","::1","0.0.0.0"]),DC=["oraclecloud.com","us-ashburn-1","amazonaws.com","rds.","supabase.co","turbobase.app","turbobase.io"];function MC(t){let e=t.trim();try{let o=new URL(e);if(o.hostname)return o.hostname.toLowerCase()}catch{}let r=e.replace(/^[a-z]+:\/\//i,""),n=(r.split("/")[0]??r).split("@").pop()??r;return(n.split(":")[0]??n).toLowerCase()}function Ju(t){if(!t||!t.trim())throw new Error("local-only guard: empty database target \u2014 refusing to proceed.");let e=t.toLowerCase();for(let n of DC)if(e.includes(n))throw new Error(`local-only guard: target '${t}' looks like a cloud/prod context (matched '${n}'). \`turbobase sandbox create\` is LOCAL-ONLY and will never touch a cloud database.`);let r=MC(t);if(!qw.has(r))throw new Error(`local-only guard: target host '${r}' is not a recognised local Postgres (${[...qw].join(", ")}). \`turbobase sandbox create\` is LOCAL-ONLY.`)}function UC(t,e=qC){return`sbx-${t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,24)||"tenant"}-${e()}`}function qC(){return Math.floor(Math.random()*16777215).toString(16).padStart(6,"0")}function FC(t){return`turbobase_${t.replace(/[^a-z0-9]+/gi,"_").toLowerCase()}`}function BC(t,e){return`${(e??process.env.TURBOBASE_SANDBOX_BASE_URL??"http://localhost:5173").replace(/\/+$/,"")}/?sandbox=${encodeURIComponent(t)}`}async function Yu(){let{file:t}=Fw();try{let e=await Wu.readFile(t,"utf8"),r=JSON.parse(e);return Array.isArray(r)?r:[]}catch(e){if(e.code==="ENOENT")return[];throw e}}async function Bw(t){let{dir:e,file:r}=Fw();await Wu.mkdir(e,{recursive:!0}),await Wu.writeFile(r,`${JSON.stringify(t,null,2)}
4276
- `,{mode:384})}async function ZC(t){let e=await Yu();e.push(t),await Bw(e)}async function Zw(t){let e=await Yu(),r=e.findIndex(o=>o.name===t);if(r===-1)return null;let[n]=e.splice(r,1);return await Bw(e),n??null}async function Ea(){return Yu()}function Xu(t,e=Date.now()){let r=[],n=[];for(let o of t)IC(o.expiresAt,e)?n.push(o):r.push(o);return{active:r,expired:n}}async function Vw(t,e){Ju(t.target());let r=t.dataCopyUnavailable?.();if(r)throw new Ss(r);let n=OC(e.sample),o=e.now??Date.now(),s=(e.nameGen??(l=>UC(l)))(e.fromTenant),i=FC(s);await t.createDatabase(i),await t.replayMigrations(i);let a=await t.readSourceTables(e.fromTenant);for(let l of a){let u=NC(l.rows,n),p=zC(l.table,u,l.classification);p.length>0&&await t.copyRows(i,l.table,p)}let c={name:s,fromTenant:e.fromTenant,database:i,createdAt:new Date(o).toISOString(),expiresAt:CC(e.ttl,o),sampleFraction:n,url:BC(s,e.baseUrl)};return await ZC(c),c}async function Hw(t,e){Ju(t.target());let n=(await Ea()).find(o=>o.name===e);return n?(await t.dropDatabase(n.database),await Zw(e),n):null}async function Qu(t,e=Date.now()){Ju(t.target());let r=await Ea(),{expired:n}=Xu(r,e),o=[];for(let s of n){try{await t.dropDatabase(s.database)}catch{continue}await Zw(s.name),o.push(s)}return o}var $s={pat:{prefix:"tb_pat_",defaultScopes:["extensions:deploy"],allowedScopes:["extensions:deploy","catalog:read","mcp:authoring","analyzer:run","releases:write","solutions:write","skills:publish","docs:publish","mcp:data","mcp:write","rest:read","rest:write","ai:invoke"],defaultTtlDays:90,mintable:!0,label:"Personal access token"},catalog:{prefix:"tb_cat_",defaultScopes:["catalog:read"],allowedScopes:["catalog:read"],defaultTtlDays:null,mintable:!0,label:"AI / catalog token"}},c4=Object.keys($s).filter(t=>$s[t].mintable);var d4=$s.pat.prefix,VC=Object.entries($s).map(([t,e])=>[e.prefix,t]),HC=/^[A-Za-z0-9_-]{20,}$/;function KC(t){if(typeof t!="string")return null;for(let[e,r]of VC)if(t.startsWith(e)&&HC.test(t.slice(e.length)))return r;return null}function Kw(t){return KC(t)==="pat"}ds();var WC=8e3,GC={revoked:"the instance REVOKED this token \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",expired:"this token has EXPIRED \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",unknown:"this instance has never seen this token \u2014 it was deleted, or it belongs to a DIFFERENT instance; check the base-url before minting a new PAT",suspended:"the user this token belongs to is SUSPENDED \u2014 an instance administrator has to restore the account; a new token will not help",malformed:"the stored credential is not shaped like a Turbobase PAT (tb_pat_\u2026) \u2014 sign in again",missing:"no token reached the instance \u2014 sign in again",transient:"the instance could not verify the token right now (a storage error, not a decision about the token) \u2014 retry"};function JC(t){return GC[t]??`the instance rejected this token (${t}) \u2014 run \`turbobase auth login\` to store a fresh PAT`}async function YC(t,e,r=fetch){let n;try{n=await r(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(WC)})}catch(s){return{state:"unreachable",detail:s instanceof Error?s.message:String(s)}}if(n.status===200||n.status===403)return{state:"accepted"};if(n.status===401){let s=await n.json().catch(()=>null);return{state:"rejected",reason:typeof s?.reason=="string"&&s.reason?s.reason:"unknown"}}return(n.headers.get("content-type")??"").includes("application/json")?{state:"accepted"}:{state:"unreachable",detail:`HTTP ${n.status} \u2014 this host does not serve the /v1 API`}}function Ww(t){return t.state==="accepted"?ot()?f.green("accepted"):"accepted":t.state==="rejected"?ot()?f.red(`rejected \xB7 ${t.reason}`):`rejected \xB7 ${t.reason}`:ot()?f.yellow("unreachable"):"unreachable"}async function Gw(t={},e=fetch){let r=await Ir(),{file:n}=ea();if(r.length===0){_("not signed in. Run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),D(f.dim(`no sign-ins stored in ${n}.`));return}let o=await tr(),s=await Promise.all(r.map(async i=>({baseUrl:i.baseUrl,active:!!o&&i.baseUrl===o.baseUrl,updatedAt:i.updatedAt,check:t.probe===!1?{state:"accepted"}:await YC(i.baseUrl,i.token,e)})));if(t.probe===!1)for(let i of s)_(`${i.active?"* ":" "}${i.baseUrl} (updated ${i.updatedAt})`);else if(ot())_(Zt(s.map(i=>[i.active?f.green("*"):" ",f.bold(i.baseUrl),Ww(i.check),f.dim(i.updatedAt)]),{head:["","instance","token","updated"]}));else for(let i of s)_(`${i.active?"* ":" "}${i.baseUrl} ${Ww(i.check)} (updated ${i.updatedAt})`);D(f.dim(`tokens read from ${n}`));for(let i of s)i.check.state==="rejected"?(D(f.red(`${i.baseUrl}: ${JC(i.check.reason)}.`)),D(f.dim(" then re-run `turbobase project init` \u2014 .mcp.json holds its own copy of the token, and until it is rewritten the authoring MCP tools stay absent from your session."))):i.check.state==="unreachable"&&D(f.yellow(`${i.baseUrl}: could not reach the instance (${i.check.detail}).`));o||D("no active default \u2014 run `turbobase auth use <base-url>` or pass --base-url.")}async function Tq(t){let e=await Ir();e.length===0&&k("no stored sign-ins \u2014 run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),at()||k("this command needs an explicit <base-url> in a non-interactive shell.");try{return await ct(t,e.map(r=>({value:r.baseUrl,label:r.baseUrl,description:`updated ${r.updatedAt}`})))}catch{k("cancelled.")}}async function Rq(t,e){let r;try{r=await fetch(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(8e3)})}catch(o){return{ok:!1,kind:"unreachable",detail:o instanceof Error?o.message:String(o)}}let n=(r.headers.get("content-type")??"").includes("application/json");return r.status===200||r.status===403?{ok:!0}:r.status===401?{ok:!1,kind:"bad-token",detail:`HTTP ${r.status}`}:n?{ok:!0}:{ok:!1,kind:"wrong-host",detail:`HTTP ${r.status}`}}function Eq(t){D(""),D("Sharing is ON. Two things reach the Turbobase product team from this instance:"),D(" \xB7 anonymized pattern cards from your proposals, solutions and INSTANCE-LEARNINGS.md \u2014"),D(" a pattern label, a record class, a fix shape, an outcome. No scripts, values or ids."),D(" \xB7 redacted prose from your projects\u2019 TURBOBASE-FEEDBACK.md \u2014 the findings you write"),D(" about OUR platform, with instance name, user names and ids masked before they leave."),D(`Turn it off: ${t}/admin/settings \u2192 Telemetry \u2192 "Share learnings and platform feedback".`),D("")}async function Pq(t,e,r){let n=await Ry({baseUrl:t,token:e}),o=(await Ir()).length-1;if(_(`signed in to ${n.baseUrl} \u2014 now the active instance`+(o>0?` (${o} other${o===1?"":"s"} stored; commands default here).`:".")),Eq(n.baseUrl),!r)return;let s=await Rq(n.baseUrl,e);s.ok||(s.kind==="wrong-host"?(D(`warning: ${n.baseUrl} did not respond to the Turbobase API (/v1) \u2014 got ${s.detail}.`),D(" In local dev the Turbobase API is on :4100, not the app dev-server port (e.g. :5173)."),D(" The token is stored, but commands will fail against this base-url until it points at the API.")):s.kind==="bad-token"?D(`warning: ${n.baseUrl} rejected the token (401) \u2014 the PAT may be stale, revoked, or for a different instance.`):D(`warning: could not reach ${n.baseUrl} to verify the token (${s.detail}). Stored anyway.`))}async function Aq(t){let e=await fu(await fs(t),qr(t)),r=Pu(e);return r||k(`${t}: ${Cu(e)}`),{...r,sourceCode:e}}async function ro(t,e,r,n){try{return await be.access(t),"skipped"}catch{}return await be.mkdir(qr(t),{recursive:!0}),await be.writeFile(t,e,{mode:n??(r?493:420)}),n!==void 0&&await be.chmod(t,n),"wrote"}async function KT(t,e){if(GT(t)!==".gitignore")return ro(t,e.content,e.executable,e.mode);let r=await be.readFile(t,"utf8").catch(()=>null);if(r===null)return ro(t,e.content,e.executable,e.mode);let n=Nb(r);return n===null?"skipped":(await be.writeFile(t,n,"utf8"),"merged")}function fg(t){if(t!==void 0){if(t==="junit"||t==="json")return t;k(`unknown --reporter '${t}' (expected 'junit' or 'json').`)}}function kl(t){process.exit(t)}function Cq(t){return{name:"turbobase ext test",cases:t.map(r=>{if(r.pass)return{name:r.name,status:"passed"};let n=r.error?"error":r.rejection?.code??"mismatch",o=r.error?`error: ${r.error}`:r.observed!==r.expected?`expected ${r.expected}, observed ${r.observed}`+(r.rejection?` (rejected: ${r.rejection.code??"rejected"}${r.rejection.message?` \u2014 ${r.rejection.message}`:""})`:""):`rejected: ${r.rejection?.code??"rejected"}${r.rejection?.message?` \u2014 ${r.rejection.message}`:""}`;return{name:r.name,status:"failed",detail:o,type:n}})}}function Iq(t,e){let r=e.warnings.length===0?[{name:`${t} (${e.kind})`,status:"passed"}]:e.warnings.map(n=>({name:`${t}: ${n.rule}`,status:"failed",type:n.rule,detail:`${n.message} \u2192 fix: ${n.fix}`}));return{name:`turbobase ext lint ${t}`,cases:r}}function Oq(t){let e=[];if(t.error)return e.push({name:`replay ${t.fixtureName}`,status:"failed",type:"error",detail:t.error}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e};for(let r of t.guards)e.push(r.status==="failed"?{name:`guard: ${r.name}`,status:"failed",type:r.name,detail:r.detail}:{name:`guard: ${r.name}`,status:"passed",detail:r.status==="skipped-offline"?`skipped-offline: ${r.detail}`:void 0});return t.whenPassed&&t.applyBranch&&e.push({name:`apply-branch: ${t.applyBranch}`,status:"passed",detail:`${t.masterAction??""} (${t.wouldWriteBindings.length} binding(s) would be written)`.trim()}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e}}function WT(t){return`${(Math.ceil(t/1048576*10)/10).toFixed(1).replace(/\.0$/,"")} MiB`}function vg({includeInternal:t=!0}={}){let e=new Fg;e.name("turbobase").description("Build apps, author extensions, and drive your Turbobase instance.").version("1.45.0").option("--no-color","Disable ANSI colour + animations (also honoured via NO_COLOR / non-TTY)."),e.addHelpText("beforeAll",d=>d.command.parent?"":`${ku()}
4276
+ `,{mode:384})}async function ZC(t){let e=await Yu();e.push(t),await Bw(e)}async function Zw(t){let e=await Yu(),r=e.findIndex(o=>o.name===t);if(r===-1)return null;let[n]=e.splice(r,1);return await Bw(e),n??null}async function Ea(){return Yu()}function Xu(t,e=Date.now()){let r=[],n=[];for(let o of t)IC(o.expiresAt,e)?n.push(o):r.push(o);return{active:r,expired:n}}async function Vw(t,e){Ju(t.target());let r=t.dataCopyUnavailable?.();if(r)throw new Ss(r);let n=OC(e.sample),o=e.now??Date.now(),s=(e.nameGen??(l=>UC(l)))(e.fromTenant),i=FC(s);await t.createDatabase(i),await t.replayMigrations(i);let a=await t.readSourceTables(e.fromTenant);for(let l of a){let u=NC(l.rows,n),p=zC(l.table,u,l.classification);p.length>0&&await t.copyRows(i,l.table,p)}let c={name:s,fromTenant:e.fromTenant,database:i,createdAt:new Date(o).toISOString(),expiresAt:CC(e.ttl,o),sampleFraction:n,url:BC(s,e.baseUrl)};return await ZC(c),c}async function Hw(t,e){Ju(t.target());let n=(await Ea()).find(o=>o.name===e);return n?(await t.dropDatabase(n.database),await Zw(e),n):null}async function Qu(t,e=Date.now()){Ju(t.target());let r=await Ea(),{expired:n}=Xu(r,e),o=[];for(let s of n){try{await t.dropDatabase(s.database)}catch{continue}await Zw(s.name),o.push(s)}return o}var $s={pat:{prefix:"tb_pat_",defaultScopes:["extensions:deploy"],allowedScopes:["extensions:deploy","catalog:read","mcp:authoring","analyzer:run","releases:write","solutions:write","skills:publish","docs:publish","mcp:data","mcp:write","rest:read","rest:write","ai:invoke"],defaultTtlDays:90,mintable:!0,label:"Personal access token"},catalog:{prefix:"tb_cat_",defaultScopes:["catalog:read"],allowedScopes:["catalog:read"],defaultTtlDays:null,mintable:!0,label:"AI / catalog token"}},c4=Object.keys($s).filter(t=>$s[t].mintable);var d4=$s.pat.prefix,VC=Object.entries($s).map(([t,e])=>[e.prefix,t]),HC=/^[A-Za-z0-9_-]{20,}$/;function KC(t){if(typeof t!="string")return null;for(let[e,r]of VC)if(t.startsWith(e)&&HC.test(t.slice(e.length)))return r;return null}function Kw(t){return KC(t)==="pat"}ds();var WC=8e3,GC={revoked:"the instance REVOKED this token \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",expired:"this token has EXPIRED \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",unknown:"this instance has never seen this token \u2014 it was deleted, or it belongs to a DIFFERENT instance; check the base-url before minting a new PAT",suspended:"the user this token belongs to is SUSPENDED \u2014 an instance administrator has to restore the account; a new token will not help",malformed:"the stored credential is not shaped like a Turbobase PAT (tb_pat_\u2026) \u2014 sign in again",missing:"no token reached the instance \u2014 sign in again",transient:"the instance could not verify the token right now (a storage error, not a decision about the token) \u2014 retry"};function JC(t){return GC[t]??`the instance rejected this token (${t}) \u2014 run \`turbobase auth login\` to store a fresh PAT`}async function YC(t,e,r=fetch){let n;try{n=await r(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(WC)})}catch(s){return{state:"unreachable",detail:s instanceof Error?s.message:String(s)}}if(n.status===200||n.status===403)return{state:"accepted"};if(n.status===401){let s=await n.json().catch(()=>null);return{state:"rejected",reason:typeof s?.reason=="string"&&s.reason?s.reason:"unknown"}}return(n.headers.get("content-type")??"").includes("application/json")?{state:"accepted"}:{state:"unreachable",detail:`HTTP ${n.status} \u2014 this host does not serve the /v1 API`}}function Ww(t){return t.state==="accepted"?ot()?f.green("accepted"):"accepted":t.state==="rejected"?ot()?f.red(`rejected \xB7 ${t.reason}`):`rejected \xB7 ${t.reason}`:ot()?f.yellow("unreachable"):"unreachable"}async function Gw(t={},e=fetch){let r=await Ir(),{file:n}=ea();if(r.length===0){_("not signed in. Run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),D(f.dim(`no sign-ins stored in ${n}.`));return}let o=await tr(),s=await Promise.all(r.map(async i=>({baseUrl:i.baseUrl,active:!!o&&i.baseUrl===o.baseUrl,updatedAt:i.updatedAt,check:t.probe===!1?{state:"accepted"}:await YC(i.baseUrl,i.token,e)})));if(t.probe===!1)for(let i of s)_(`${i.active?"* ":" "}${i.baseUrl} (updated ${i.updatedAt})`);else if(ot())_(Zt(s.map(i=>[i.active?f.green("*"):" ",f.bold(i.baseUrl),Ww(i.check),f.dim(i.updatedAt)]),{head:["","instance","token","updated"]}));else for(let i of s)_(`${i.active?"* ":" "}${i.baseUrl} ${Ww(i.check)} (updated ${i.updatedAt})`);D(f.dim(`tokens read from ${n}`));for(let i of s)i.check.state==="rejected"?(D(f.red(`${i.baseUrl}: ${JC(i.check.reason)}.`)),D(f.dim(" then re-run `turbobase project init` \u2014 .mcp.json holds its own copy of the token, and until it is rewritten the authoring MCP tools stay absent from your session."))):i.check.state==="unreachable"&&D(f.yellow(`${i.baseUrl}: could not reach the instance (${i.check.detail}).`));o||D("no active default \u2014 run `turbobase auth use <base-url>` or pass --base-url.")}async function Tq(t){let e=await Ir();e.length===0&&k("no stored sign-ins \u2014 run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),at()||k("this command needs an explicit <base-url> in a non-interactive shell.");try{return await ct(t,e.map(r=>({value:r.baseUrl,label:r.baseUrl,description:`updated ${r.updatedAt}`})))}catch{k("cancelled.")}}async function Rq(t,e){let r;try{r=await fetch(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(8e3)})}catch(o){return{ok:!1,kind:"unreachable",detail:o instanceof Error?o.message:String(o)}}let n=(r.headers.get("content-type")??"").includes("application/json");return r.status===200||r.status===403?{ok:!0}:r.status===401?{ok:!1,kind:"bad-token",detail:`HTTP ${r.status}`}:n?{ok:!0}:{ok:!1,kind:"wrong-host",detail:`HTTP ${r.status}`}}function Eq(t){D(""),D("Sharing is ON. Two things reach the Turbobase product team from this instance:"),D(" \xB7 anonymized pattern cards from your proposals, solutions and INSTANCE-LEARNINGS.md \u2014"),D(" a pattern label, a record class, a fix shape, an outcome. No scripts, values or ids."),D(" \xB7 redacted prose from your projects\u2019 TURBOBASE-FEEDBACK.md \u2014 the findings you write"),D(" about OUR platform, with instance name, user names and ids masked before they leave."),D(`Turn it off: ${t}/admin/settings \u2192 Telemetry \u2192 "Share learnings and platform feedback".`),D("")}async function Pq(t,e,r){let n=await Ry({baseUrl:t,token:e}),o=(await Ir()).length-1;if(_(`signed in to ${n.baseUrl} \u2014 now the active instance`+(o>0?` (${o} other${o===1?"":"s"} stored; commands default here).`:".")),Eq(n.baseUrl),!r)return;let s=await Rq(n.baseUrl,e);s.ok||(s.kind==="wrong-host"?(D(`warning: ${n.baseUrl} did not respond to the Turbobase API (/v1) \u2014 got ${s.detail}.`),D(" In local dev the Turbobase API is on :4100, not the app dev-server port (e.g. :5173)."),D(" The token is stored, but commands will fail against this base-url until it points at the API.")):s.kind==="bad-token"?D(`warning: ${n.baseUrl} rejected the token (401) \u2014 the PAT may be stale, revoked, or for a different instance.`):D(`warning: could not reach ${n.baseUrl} to verify the token (${s.detail}). Stored anyway.`))}async function Aq(t){let e=await fu(await fs(t),qr(t)),r=Pu(e);return r||k(`${t}: ${Cu(e)}`),{...r,sourceCode:e}}async function ro(t,e,r,n){try{return await be.access(t),"skipped"}catch{}return await be.mkdir(qr(t),{recursive:!0}),await be.writeFile(t,e,{mode:n??(r?493:420)}),n!==void 0&&await be.chmod(t,n),"wrote"}async function KT(t,e){if(GT(t)!==".gitignore")return ro(t,e.content,e.executable,e.mode);let r=await be.readFile(t,"utf8").catch(()=>null);if(r===null)return ro(t,e.content,e.executable,e.mode);let n=Nb(r);return n===null?"skipped":(await be.writeFile(t,n,"utf8"),"merged")}function fg(t){if(t!==void 0){if(t==="junit"||t==="json")return t;k(`unknown --reporter '${t}' (expected 'junit' or 'json').`)}}function kl(t){process.exit(t)}function Cq(t){return{name:"turbobase ext test",cases:t.map(r=>{if(r.pass)return{name:r.name,status:"passed"};let n=r.error?"error":r.rejection?.code??"mismatch",o=r.error?`error: ${r.error}`:r.observed!==r.expected?`expected ${r.expected}, observed ${r.observed}`+(r.rejection?` (rejected: ${r.rejection.code??"rejected"}${r.rejection.message?` \u2014 ${r.rejection.message}`:""})`:""):`rejected: ${r.rejection?.code??"rejected"}${r.rejection?.message?` \u2014 ${r.rejection.message}`:""}`;return{name:r.name,status:"failed",detail:o,type:n}})}}function Iq(t,e){let r=e.warnings.length===0?[{name:`${t} (${e.kind})`,status:"passed"}]:e.warnings.map(n=>({name:`${t}: ${n.rule}`,status:"failed",type:n.rule,detail:`${n.message} \u2192 fix: ${n.fix}`}));return{name:`turbobase ext lint ${t}`,cases:r}}function Oq(t){let e=[];if(t.error)return e.push({name:`replay ${t.fixtureName}`,status:"failed",type:"error",detail:t.error}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e};for(let r of t.guards)e.push(r.status==="failed"?{name:`guard: ${r.name}`,status:"failed",type:r.name,detail:r.detail}:{name:`guard: ${r.name}`,status:"passed",detail:r.status==="skipped-offline"?`skipped-offline: ${r.detail}`:void 0});return t.whenPassed&&t.applyBranch&&e.push({name:`apply-branch: ${t.applyBranch}`,status:"passed",detail:`${t.masterAction??""} (${t.wouldWriteBindings.length} binding(s) would be written)`.trim()}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e}}function WT(t){return`${(Math.ceil(t/1048576*10)/10).toFixed(1).replace(/\.0$/,"")} MiB`}function vg({includeInternal:t=!0}={}){let e=new Fg;e.name("turbobase").description("Build apps, author extensions, and drive your Turbobase instance.").version("1.45.1").option("--no-color","Disable ANSI colour + animations (also honoured via NO_COLOR / non-TTY)."),e.addHelpText("beforeAll",d=>d.command.parent?"":`${ku()}
4277
4277
  `),e.hook("preAction",(d,h)=>{Wb(e.opts(),h.opts())});let r=e.command("auth").description("Sign in to an instance and manage stored credentials."),n=e.command("project").description("Set up the local project and the files an agent session reads."),o=e.command("ext").description("Author, test, ship, and observe extensions \u2014 hooks and conduits."),s=e.command("kb").description("Write into the instance's knowledge base."),i=e.command("skills").description("Write standing rules into the instance's agent skills.");r.command("login").description("Sign in to an instance by pasting a personal access token (PAT), stored in ~/.turbobase/credentials.").requiredOption("--base-url <url>","Instance base URL, e.g. https://acme.turbobase.app").option("--token <tb_pat_\u2026>","The PAT to store. Mint one in your app under Settings \u203A Access tokens.").option("--no-verify","Skip the post-login connectivity/token probe.").action(async d=>{let h=qt(d.baseUrl);d.token||k(`auth login needs --token. Mint a PAT in your Turbobase app (Settings \u203A Access tokens), then:
4278
4278
  ${_o} auth login --base-url ${h} --token tb_pat_\u2026`),Kw(d.token)||k("--token does not look like a Turbobase PAT (tb_pat_\u2026)."),await Pq(h,d.token,d.verify)}),r.command("status").description("Show every stored sign-in, where its token was read from, and whether the instance still accepts it.").option("--no-probe","List the stored sign-ins without asking each instance about its token.").action(async d=>Gw({probe:d.probe})),r.command("use [base-url]").description("Make an already-stored instance the active default (omit the arg to pick interactively).").action(async d=>{let h=d??await Tq("Pick the active instance:"),v=await ta(h);if(!v){let $=await Ir();k(`no stored sign-in for ${qt(h)}.`+($.length?` Stored: ${$.map(x=>x.baseUrl).join(", ")}.`:"")+` Run \`turbobase auth login --base-url ${qt(h)} --token tb_pat_\u2026\`.`)}_(`active instance \u2192 ${v.baseUrl}.`)}),r.command("logout").description("Remove a stored sign-in (defaults to the active instance).").option("--base-url <url>","Which instance to remove (defaults to the active/single one).").option("--all","Remove every stored sign-in.").action(async d=>{if(d.all){let $=await Ir();for(let x of $)await lu(x.baseUrl);_(`removed ${$.length} stored sign-in${$.length===1?"":"s"}.`);return}let h=await lu(d.baseUrl);h||k(d.baseUrl?`no stored sign-in for ${qt(d.baseUrl)}.`:"nothing to sign out of (or ambiguous \u2014 pass --base-url / --all).");let v=await tr();_(`signed out of ${h}.`+(v?` Active instance \u2192 ${v.baseUrl}.`:""))}),n.command("types").description("Generate types.ts from the signed-in instance's catalog.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("-o, --out <file>","Output file","types.ts").option("--records-only","Emit only record-shape interfaces (skip the OpenAPI half).").action(async d=>{let{baseUrl:h,token:v}=await G(d.baseUrl),$;try{$=await Ln({baseUrl:h,token:v,recordsOnly:d.recordsOnly})}catch(y){let S=y instanceof Error?y.message:String(y);if(!d.recordsOnly&&/openapi\.json failed \(401/.test(S)){D("types-gen: /v1/catalog/openapi.json needs a browser session \u2014 emitting record shapes only. The record shapes are the half apps generate against; for the OpenAPI half, run it from a signed-in browser session.");try{$=await Ln({baseUrl:h,token:v,recordsOnly:!0})}catch(E){k(`types generation failed: ${E instanceof Error?E.message:String(E)}`)}}else k(`types generation failed: ${S}`)}let x=ge(process.cwd(),d.out);await be.writeFile(x,$,"utf8"),_(`wrote ${x} (${$.split(`
4279
4279
  `).length} lines).`)}),Yb(n),n.command("grounding").description("Write the instance's grounding brief (source primer + record anatomy + KB retrieval) to a file for agent sessions.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--records <list>","Comma-separated record types to focus, e.g. purchaseOrder,itemReceipt.").option("--query <text>","Retrieval question for the knowledge base (e.g. what the app is about).").option("-o, --out <file>","Output file","INSTANCE.md").action(async d=>{let{baseUrl:h,token:v}=await G(d.baseUrl),$=new URLSearchParams;d.records&&$.set("records",d.records),d.query&&$.set("query",d.query);let x=$.toString(),y=await fetch(`${h}/v1/catalog/grounding${x?`?${x}`:""}`,{headers:{Authorization:`Bearer ${v}`,Accept:"application/json"}});y.ok||k(`grounding fetch failed: GET /v1/catalog/grounding \u2192 ${y.status}`);let E=((await y.json()).markdown??"").trim(),I=ge(process.cwd(),d.out),j=d.records?` records=${d.records}`:"",M=`<!-- GENERATED by \`turbobase project grounding\` against ${h}${j} \u2014 do not edit; re-run to refresh. -->
@@ -4303,7 +4303,7 @@ samples init: ${E} written, ${I} skipped.`)});let Tr=e.command("guardrails").des
4303
4303
  `+f.dim("create one with `turbobase guardrails create <name> --source <s> --record <r>`"));_(Zt(x.map(JT),{head:YT})),_(f.dim(" first match wins; lower PRIO is evaluated first."))}),Tr.command("create <name>").description("Create a rule gating PG\u2192source writes that match it.").option("--source <system>","Adapter id to scope to, or '*' for every source.","*").option("--record <type>","Record type to scope to, or '*' for every record.","*").option("--op <glob>","Raw op glob, when gating something other than a record write.").option("--target <glob>","Row address glob, e.g. 'salesOrder.12345'.").option("--actor <glob>","Only match this caller, e.g. 'agent:*' to gate AI writes but not human ones.").option("--decision <d>","allow | allow_with_audit | require_confirm | deny.","deny").option("--priority <n>","Lower is evaluated first (default 100).",d=>Number(d)).option("--when <expr>","Row predicate, e.g. 'total gt 10000'. Omit to match every row.").option("--reason <text>","Why this rule exists \u2014 shown to a blocked writer and in `list`.").option("--disabled","Create the rule parked, so it takes effect only when activated.").option("--confirm-freeze-all","Required for an unconditional deny across '*'/'*'.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:v,token:$}=await G(h.baseUrl),x=new K({baseUrl:v,token:$}),y;try{y=await x.guardrailCreate({name:d,source:h.source,record:h.record,decision:h.decision,...h.op?{op:h.op}:{},...h.target?{target:h.target}:{},...h.actor?{actor:h.actor}:{},...Number.isFinite(h.priority)?{priority:Number(h.priority)}:{},...h.when?{when:h.when}:{},...h.reason?{reason:h.reason}:{},...h.disabled?{enabled:!1}:{},...h.confirmFreezeAll?{confirmFreezeAll:!0}:{}})}catch(S){te(S,"extensions:deploy","create a guardrail"),k(`create guardrail failed: ${S instanceof Error?S.message:String(S)}`)}_(`${f.green("\u2713")} guardrail ${f.bold(y.name??y.id)} created${y.status==="active"?"":f.dim(` (${y.status} \u2014 activate it to take effect)`)}`),_(f.dim(` ${y.decision} ${y.source}/${y.record??y.op}${y.actor?` actor=${y.actor}`:""}${y.when?` where ${y.when}`:""} @prio ${y.priority}`)),_(f.dim(` verify with: turbobase guardrails test --source ${y.source==="*"?"<source>":y.source} --record <record>`))}),Tr.command("edit <name>").description("Change a rule \u2014 its decision, priority, predicate or reason.").option("--decision <d>","allow | allow_with_audit | require_confirm | deny.").option("--priority <n>","Lower is evaluated first.",d=>Number(d)).option("--when <expr>","New row predicate. Pass '' to match every row.").option("--reason <text>","Why this rule exists.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{h.decision===void 0&&h.priority===void 0&&h.when===void 0&&h.reason===void 0&&k("edit: nothing to change \u2014 pass --decision, --priority, --when or --reason.");let{baseUrl:v,token:$}=await G(h.baseUrl),x=new K({baseUrl:v,token:$}),y;try{y=await x.guardrailUpdate(d,{...h.decision!==void 0?{decision:h.decision}:{},...Number.isFinite(h.priority)?{priority:Number(h.priority)}:{},...h.when!==void 0?{when:h.when}:{},...h.reason!==void 0?{reason:h.reason}:{}})}catch(S){te(S,"extensions:deploy","edit a guardrail"),k(`edit guardrail failed: ${S instanceof Error?S.message:String(S)}`)}_(`${f.green("\u2713")} guardrail ${f.bold(y.name??y.id)} updated`),_(f.dim(` ${y.decision} ${y.source}/${y.record??y.op}${y.when?` where ${y.when}`:""} @prio ${y.priority}`))});for(let[d,h,v]of[["activate","active","activated"],["deactivate","inactive","deactivated"]])Tr.command(`${d} <name>`).description(h==="active"?"Arm a parked or proposed rule.":"Park a rule without deleting it \u2014 the reversible move mid-rollout.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async($,x)=>{let{baseUrl:y,token:S}=await G(x.baseUrl),E=new K({baseUrl:y,token:S});try{await E.guardrailUpdate($,{status:h})}catch(I){te(I,"extensions:deploy",`${d} a guardrail`),k(`${d} guardrail failed: ${I instanceof Error?I.message:String(I)}`)}_(`${f.green("\u2713")} guardrail ${f.bold($)} ${v}`),h==="inactive"&&_(f.dim(" writes it was gating now fall through to the other rules."))});Tr.command("delete <name>").description("Remove a rule. Prefer `deactivate` if you may want it back.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:v,token:$}=await G(h.baseUrl),x=new K({baseUrl:v,token:$});try{await x.guardrailDelete(d)}catch(y){te(y,"extensions:deploy","delete a guardrail"),k(`delete guardrail failed: ${y instanceof Error?y.message:String(y)}`)}_(`${f.green("\u2713")} guardrail ${f.bold(d)} deleted`)}),Tr.command("posture [mode]").description("Show or set the GLOBAL default. 'allow' = deny-list (unmatched writes allowed, carve with deny rules). 'deny' = allow-list (unmatched writes denied, open with allow rules).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:v,token:$}=await G(h.baseUrl),x=new K({baseUrl:v,token:$}),y=I=>I==="deny"?"deny-by-default (allow-list)":"allow-by-default (deny-list)";if(d===void 0){let I;try{I=await x.guardrailPostureGet()}catch(j){te(j,"extensions:deploy","read the guardrail posture"),k(`read posture failed: ${j instanceof Error?j.message:String(j)}`)}_(`guardrail posture: ${f.bold(y(I.mode))}`),_(f.dim(I.mode==="deny"?" Unmatched writes are DENIED. Open records with `guardrails create <name> --decision allow`.":" Unmatched writes are allowed-with-audit. Freeze records with `guardrails create <name> --decision deny`."));return}let S=d.trim().toLowerCase();S!=="allow"&&S!=="deny"&&k("posture must be 'allow' or 'deny'.");let E;try{E=await x.guardrailPostureSet(S)}catch(I){te(I,"extensions:deploy","set the guardrail posture"),k(`set posture failed: ${I instanceof Error?I.message:String(I)}`)}_(`${f.green("\u2713")} guardrail posture set to ${f.bold(y(E.mode))}`),E.mode==="deny"&&_(f.dim(" Every record with no active ALLOW rule is now frozen for write-back. Verify with `guardrails test --source <s> --record <r>`."))}),Tr.command("test").description("What happens to this write? Runs the real evaluator; writes nothing.").requiredOption("--source <system>","Adapter id the write targets.").requiredOption("--record <type>","Record type the write targets.").option("--actor <actor>","Caller to simulate, e.g. 'agent:ai' or 'user:<id>'.").option("--external-id <id>","Source-side row id, for target-scoped rules.").option("--fields <json>","A candidate row as JSON, so `when` predicates can be decided.").option("--op <op>","Write op: 'delete' tests <record>.delete; omitted tests <record>.write.").option("--phase <phase>","boundary | cdc | worker | adapter. Defaults to worker (the last gate).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--json","Emit raw JSON.").action(async d=>{let h;if(d.fields)try{h=JSON.parse(d.fields)}catch(E){k(`--fields must be valid JSON: ${E instanceof Error?E.message:String(E)}`)}let{baseUrl:v,token:$}=await G(d.baseUrl),x=new K({baseUrl:v,token:$}),y;try{y=await x.guardrailTest({source:d.source,record:d.record,...d.actor?{actor:d.actor}:{},...d.externalId?{externalId:d.externalId}:{},...h?{fields:h}:{},...d.op?{op:d.op}:{},...d.phase?{phase:d.phase}:{}})}catch(E){te(E,"extensions:deploy","test guardrails"),k(`guardrails test failed: ${E instanceof Error?E.message:String(E)}`)}if(d.json)return _(JSON.stringify(y,null,2));let S=`${d.source}/${y.op??d.record}`;y.degraded?(_(`${f.red("\u2717")} ${S} \u2014 guardrail policy is UNREADABLE; writes fail closed`),_(f.dim(` ${y.reason}`))):y.allowed?_(`${f.green("\u2713")} ${S} \u2014 ${y.decision}`+(y.blockedBy?f.dim(` (rule ${y.blockedBy})`):f.dim(" (no rule matched)"))):(_(`${f.red("\u2717")} ${S} \u2014 ${y.decision} by ${f.bold(y.blockedBy??"?")} at the ${y.phase} gate`),y.message&&_(f.dim(` ${y.message}`))),y.decision==="require_confirm"&&_(f.yellow(" this write is HELD for operator approval, not refused.")),y.allowed||(process.exitCode=1)});let ts=e.command("tables").description("Author custom tables on your instance (create, evolve, inspect)."),Ii=(d,h={})=>{let v=`${f.bold(d.table)} ${f.dim(d.displayName)}`;_(d.exists===!1?`${v} ${f.dim("(new)")}`:v);for(let $ of d.fields){let x=[$.required?"required":null].filter(Boolean).join(", "),y=h.showClaimants&&$.claimedBy?.length?` ${f.dim(`\u2190 ${$.claimedBy.join(", ")}`)}`:"";_(` ${$.column.padEnd(28)} ${$.type}${x?` (${x})`:""}${y}`)}h.showClaimants&&d.claimants.length>1&&_(f.dim(` claimed by ${d.claimants.join(", ")}`))};function Oi(d){if(d instanceof se&&d.status===409){let h=d.body;h?.error==="table_conflict"&&h.message&&(D(h.message),process.exit(1))}k(`tables: ${d instanceof Error?d.message:String(d)}`)}let kg=async d=>{let h=Nt(ge(process.cwd(),d),"public","turbobase.json"),v=await be.readFile(h,"utf8").catch(()=>null);if(v===null)return null;let $;try{$=JSON.parse(v)}catch(y){k(`${h} is not valid JSON: ${y instanceof Error?y.message:String(y)}`)}let x=$.tables;return x===void 0?{tables:[],manifestPath:h}:(Array.isArray(x)||k(`${h}: "tables" must be an array.`),{tables:x,manifestPath:h})};ts.command("list").description("List the custom tables on your instance and who claims each one.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--json","Emit raw JSON instead of a table.").action(async d=>{let{baseUrl:h,token:v}=await G(d.baseUrl),$=new K({baseUrl:h,token:v}),x;try{x=await $.tablesList()}catch(y){te(y,"extensions:deploy","list tables"),k(`list tables failed: ${y instanceof Error?y.message:String(y)}`)}if(d.json)return _(JSON.stringify(x,null,2));if(x.length===0)return _("no custom tables yet \u2014 create one with `turbobase tables create <slug>`.");_(Zt(x.map(y=>[y.table,y.displayName,String(y.fields.length),y.status,y.claimedBy.join(", ")||"\u2014"]),{head:["TABLE","NAME","FIELDS","STATUS","CLAIMED BY"]}))}),ts.command("plan").description("Preview what this project's declared tables would do. Writes nothing; exits 1 on a conflict.").argument("[dir]","Project directory holding public/turbobase.json (default ./).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--as <claimant>","Claim as `cli` or `app:<slug>` (default: the app slug in .turbobase, else cli).").action(async(d,h)=>{let v=await kg(d??".");if(v||k(`no public/turbobase.json under ${ge(process.cwd(),d??".")}.`),v.tables.length===0)return _(`${v.manifestPath} declares no tables \u2014 nothing to plan.`);let{baseUrl:$,token:x}=await G(h.baseUrl),y=new K({baseUrl:$,token:x}),S;try{S=await ie("planning tables",()=>y.tablesPlan({claimedBy:h.as,tables:v.tables}))}catch(E){te(E,"extensions:deploy","plan tables"),Oi(E)}_(`claiming as ${f.bold(S.claimedBy)}`);for(let E of S.tables)Ii(E,{showClaimants:!0});_(""),_(f.dim("nothing was applied \u2014 run `turbobase tables apply` (or deploy the app) to make it so."))}),ts.command("apply").description("Apply this project's declared tables to the instance.").argument("[dir]","Project directory holding public/turbobase.json (default ./).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--as <claimant>","Claim as `cli` or `app:<slug>` (default: cli).").action(async(d,h)=>{let v=await kg(d??".");if(v||k(`no public/turbobase.json under ${ge(process.cwd(),d??".")}.`),v.tables.length===0)return _(`${v.manifestPath} declares no tables \u2014 nothing to apply.`);let{baseUrl:$,token:x}=await G(h.baseUrl),y=new K({baseUrl:$,token:x}),S;try{S=await ie("applying tables",()=>y.tablesApply({claimedBy:h.as,tables:v.tables}))}catch(E){te(E,"extensions:deploy","apply tables"),Oi(E)}for(let E of S.tables)Ii(E,{showClaimants:!0});_(`applied ${S.tables.length} table${S.tables.length===1?"":"s"} as ${S.claimedBy}.`)}),ts.command("create").description('Create a single table without a manifest (the CLI twin of "New custom table").').argument("<slug>","Table slug; the physical table is cr_<slug>.").requiredOption("-f, --field <name:type>","Field as name:type[:required] \u2014 text|number|date|bool|select. Repeatable.",(d,h)=>[...h??[],d],[]).option("--name <displayName>","Human label for the table (defaults to the slug).").option("--restrict-to-owner","Non-admins see only rows they created.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let v=h.field.map(E=>{let[I,j,M]=E.split(":");return(!I||!j)&&k(`--field "${E}" must be name:type[:required] (e.g. title:text:required).`),M!==void 0&&M!=="required"&&k(`--field "${E}": the third part may only be "required".`),{name:I,type:j,...M==="required"?{required:!0}:{}}}),{baseUrl:$,token:x}=await G(h.baseUrl),y=new K({baseUrl:$,token:x}),S;try{S=await ie(`creating cr_${d}`,()=>y.tablesApply({tables:[{slug:d,displayName:h.name??d,fields:v,...h.restrictToOwner?{rowLevelOwner:!0}:{}}]}))}catch(E){te(E,"extensions:deploy","create a table"),Oi(E)}for(let E of S.tables)Ii(E);_(""),_(f.dim("grant access under Settings \u203A Users, or in the Records page permissions matrix."))}),ts.command("drop").description("Drop a table and everything in it. Irreversible.").argument("<slug>","Table slug (without the cr_ prefix).").requiredOption("--confirm <slug>","Type the EXACT slug to confirm (fail-closed).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{h.confirm!==d&&k(`drop refused: --confirm "${h.confirm}" does not match "${d}".`);let{baseUrl:v,token:$}=await G(h.baseUrl),x=new K({baseUrl:v,token:$}),y;try{y=await ie(`dropping cr_${d}`,()=>x.tablesDrop(d,h.confirm))}catch(S){te(S,"extensions:deploy","drop a table"),k(`drop failed: ${S instanceof Error?S.message:String(S)}`)}if(!y.removed)return _(`no table named "${d}" on this instance \u2014 nothing dropped.`);_(`dropped ${y.table} and every row in it.`)});let Sl=e.command("sandbox").description("Ephemeral local authoring sandboxes.");Sl.command("create").description("Stand up a fresh local sandbox seeded with a sampled+redacted slice of an instance.").requiredOption("--from <instance>","Source instance to clone the data slice from.").option("--ttl <duration>","Time-to-live before reaping (e.g. 72h, 30m, 7d).","72h").option("--sample <pct>","Percent of each table to copy (e.g. 2%).","2%").option("--base-url <url>","Local base URL the sandbox is reachable at.").action(async d=>{process.env.TURBOBASE_SANDBOX="1";let h=yg(),v;try{v=await Vw(h,{fromTenant:d.from,ttl:d.ttl,sample:d.sample,baseUrl:d.baseUrl})}catch($){$ instanceof Ss&&k($.message),k(`sandbox create failed: ${$ instanceof Error?$.message:String($)}`)}_(`sandbox ${v.name} ready.`),_(` source: ${v.fromTenant} (sampled ${Math.round(v.sampleFraction*100)}%, redacted)`),_(` url: ${v.url}`),_(` expires: ${v.expiresAt}`)}),Sl.command("destroy").argument("<name>","The sandbox name to tear down.").description("Drop a sandbox database and remove it from the registry.").action(async d=>{let h=yg();await Qu(h).catch(()=>[]);let v;try{v=await Hw(h,d)}catch($){k(`sandbox destroy failed: ${$ instanceof Error?$.message:String($)}`)}v||k(`no sandbox named '${d}'.`),_(`destroyed sandbox ${v.name} (dropped ${v.database}).`)}),Sl.command("list").description("List active sandboxes with TTL/expiry; reaps any past their TTL.").action(async()=>{let d=yg(),h=await Qu(d).catch(()=>[]),v=await Ea(),{active:$}=Xu(v);if($.length===0)_("no active sandboxes.");else{for(let x of $)_(` ${x.name} from=${x.fromTenant} expires=${x.expiresAt} ${x.url}`);_(`
4304
4304
  ${$.length} active sandbox(es).`)}h.length>0&&_(`(reaped ${h.length} expired sandbox(es).)`)}),o.command("export").description("Pull the live instance into turbobase/bundle.json (adopt an instance into a repo).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--out <dir>","Directory to write the bundle into.",ya).action(async d=>{let{baseUrl:h,token:v}=await G(d.baseUrl),$=new K({baseUrl:h,token:v}),x;try{x=await ie("exporting instance config",()=>$.configExport())}catch(E){E instanceof se&&(E.status===401||E.status===403)&&k("ext export forbidden \u2014 the stored PAT lacks extensions:deploy. Re-run `turbobase auth login`."),k(`ext export failed: ${E instanceof Error?E.message:String(E)}`)}let y=typeof x.serialized=="string"?x.serialized:`${JSON.stringify(x.manifest??x,null,2)}
4305
4305
  `,S=ge(process.cwd(),d.out,ws);await be.mkdir(qr(S),{recursive:!0}),await be.writeFile(S,y,"utf8"),_(`wrote ${d.out}/${ws} (${y.split(`
4306
- `).length} lines).`)});let xg=o.command("extras").description("Manage the optional native packages `ext test` and `ext replay` need."),XT=[{name:"esbuild",needs:"compiling an extension (`test`, `replay`)"},{name:"isolated-vm",needs:"executing an extension in the sandbox (`test`, `replay`)"}],Sg=()=>process.env.TURBOBASE_HOME?.trim()||Nt($q(),".turbobase"),QT=()=>"1.45.0",Ni=async()=>Promise.all(XT.map(async d=>{try{return await import(d.name),{...d,present:!0}}catch{return{...d,present:!1}}}));xg.command("status").description("Report which optional native packages are installed.").action(async()=>{let d=await Ni();for(let h of d)_(`${h.present?Ne.success("installed"):Ne.warn("missing")} ${f.bold(h.name)} \u2014 ${h.needs}`);d.some(h=>!h.present)&&_(`
4306
+ `).length} lines).`)});let xg=o.command("extras").description("Manage the optional native packages `ext test` and `ext replay` need."),XT=[{name:"esbuild",needs:"compiling an extension (`test`, `replay`)"},{name:"isolated-vm",needs:"executing an extension in the sandbox (`test`, `replay`)"}],Sg=()=>process.env.TURBOBASE_HOME?.trim()||Nt($q(),".turbobase"),QT=()=>"1.45.1",Ni=async()=>Promise.all(XT.map(async d=>{try{return await import(d.name),{...d,present:!0}}catch{return{...d,present:!1}}}));xg.command("status").description("Report which optional native packages are installed.").action(async()=>{let d=await Ni();for(let h of d)_(`${h.present?Ne.success("installed"):Ne.warn("missing")} ${f.bold(h.name)} \u2014 ${h.needs}`);d.some(h=>!h.present)&&_(`
4307
4307
  run \`${_o} ext extras install\` to fetch them into ${Sg()}.`)}),xg.command("install").description("Install the optional native packages into $TURBOBASE_HOME (needs npm).").action(async()=>{let d=await Ni();if(d.every(I=>I.present)){_(Ne.success("extras already installed \u2014 nothing to do."));return}let h=Sg();await be.mkdir(h,{recursive:!0});let v=d.filter(I=>!I.present).map(I=>I.name),$=Hu(process.platform,process.arch),x=async(I,j)=>{let{code:M,stderr:V}=await Ai("npm",["install","--prefix",h,"--no-audit","--no-fund",...I]);M!==0&&k(`extras install failed while installing ${j} (npm exited ${M}).
4308
4308
  ${V.trim()}
4309
4309
  These are native packages \u2014 they need npm and a working toolchain. Everything except \`test\` and \`replay\` works without them.`)},y=v.filter(I=>I!=="isolated-vm");if(y.length>0){let I=y.map(j=>`${j}@${Zu[j]??"latest"}`);_(`installing ${I.join(", ")} \u2192 ${h}/node_modules \u2026`),await x(I,y.join(", "))}if(v.includes("isolated-vm")){let I=`isolated-vm@${Zu["isolated-vm"]}`;if(_(`installing ${I} \u2192 ${h}/node_modules \u2026`),await x(["--ignore-scripts",I],"isolated-vm"),Dw.includes($)){let M=`${Vu}@${QT()}`;_(`fetching ${M} (no upstream binary for ${$}) \u2026`);let{code:V}=await Ai("npm",["install","--prefix",h,"--no-audit","--no-fund","--ignore-scripts",M]);V!==0&&_(Ne.warn(`could not fetch ${M} \u2014 falling back to a source build.`))}let j=await Mw({home:h});j.length>0&&_(` ${Ne.success("prebuilt")} ${j.join(", ")} \u2192 isolated-vm/prebuilds/${$}`)}let S=await Ni(),E=S.filter(I=>!I.present).map(I=>I.name);if(E.includes("isolated-vm")){_(Ne.warn(`no prebuilt isolated-vm for ${$} / Node ${process.versions.node} (${Ku()}) \u2014 building from source. This needs Python and a C++ toolchain, and takes a few minutes.`));let{code:I}=await Ai("npm",["rebuild","--prefix",h,"isolated-vm"]);I===0&&(S=await Ni(),E=S.filter(j=>!j.present).map(j=>j.name))}E.length>0&&k(`npm succeeded but ${E.join(", ")} still will not load \u2014 no prebuilt binary for ${$} / Node ${process.versions.node} (${Ku()}), and the source build did not produce one either. Everything except \`test\` and \`replay\` works without them.`),_(Ne.success("extras installed \u2014 `turbobase ext test` and `turbobase ext replay` are ready."))});let no=e.command("release").description("Ship a release to your instance: deploy | status | rollback | list.");no.command("deploy").description("Enqueue a server-side release deploy. UPLOADS the SDF project src/ from the checkout (the producer swap) when present; else a solution-only live-fetch deploy. An approved target requires --approved-by.").requiredOption("--target <mode>","Deploy posture: auto (apply now) | approved (needs a recorded approval).").option("--solution <id>","The solution id the release delivers (omit for an upload-only deploy).").option("--project <dir>","SDF project dir whose src/ is uploaded (default: cwd).").option("--git-repo <repo>","Git provenance LINK: source repo (default $GITHUB_REPOSITORY or `git remote get-url origin`).").option("--git-ref <ref>","Git provenance LINK: ref/branch/tag (default $GITHUB_REF).").option("--ref <committish>","Git provenance: the ref/branch/tag/sha the upload was built from; resolved to a commit sha via `git rev-parse` (default $GITHUB_SHA or HEAD).").option("--pr-url <url>","Git provenance LINK: the PR this deploy came from (default $PR_URL).").option("--approved-by <email>","Record the approval (REQUIRED for --target approved).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--follow","Poll the release deploy to completion (exit non-zero on failure).").option("--interval-ms <ms>","Poll interval for --follow (default 2000).").action(async d=>{let h=d.target==="approved"?"approved":d.target==="auto"?"auto":null;h||k(`--target must be 'auto' or 'approved' (got '${d.target}').`);let v=await Mq(ge(process.cwd(),d.project??".")),$=Object.keys(v).length;!d.solution&&$===0&&k("release deploy needs --solution <id> (live-fetch) or an SDF project (a src/ dir under --project, default cwd) to upload.");let y=(d.ref?await bg(["rev-parse",d.ref])??d.ref:null)??process.env.GITHUB_SHA??await bg(["rev-parse","HEAD"]),S=d.gitRepo??process.env.GITHUB_REPOSITORY??await bg(["remote","get-url","origin"]),E=d.gitRef??process.env.GITHUB_REF??null,I=d.prUrl??process.env.PR_URL??null,{baseUrl:j,token:M}=await G(d.baseUrl),V=new K({baseUrl:j,token:M}),q;try{q=await V.releaseDeploy({solutionId:d.solution??null,target:h,approvedBy:d.approvedBy??null,files:$>0?v:null,gitRepo:S,gitRef:E,gitSha:y,prUrl:I})}catch(ne){te(ne,"releases:write","release deploy"),ne instanceof se&&ne.status===404&&k("solution_not_found \u2014 no solution with that id."),k(`release deploy failed: ${ne instanceof Error?ne.message:String(ne)}`)}_(`release ${q.releaseId} enqueued \u2192 taskId=${q.taskId} (target=${h}`+($>0?`, uploaded ${$} bundle file(s)`:", live-fetch")+")."),d.follow&&await Ou(()=>V.releaseStatus(q.releaseId),`release ${q.releaseId}`,d.intervalMs)}),no.command("pull").argument("<id>","The release id").description("Write the SDF project a FAILED release built into <dir>: owned/ (yours, editable) and context/ (the rest of the bundle, read-only). Edit owned/, then `release push`.").requiredOption("--dir <path>","Directory to write the project into (created if absent).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:v,token:$}=await G(h.baseUrl),x=new K({baseUrl:v,token:$}),y;try{y=await x.releaseFiles(d)}catch(I){I instanceof se&&I.status===404&&k(`release ${d} not found.`),I instanceof se&&I.status===409&&k(`no built project was retained for release ${d}. Files are kept for a FAILED attempt only \u2014 a shipped bundle is recoverable from the account.`),te(I,"releases:write","pull a release"),k(`release pull failed: ${I instanceof Error?I.message:String(I)}`)}let S=ge(process.cwd(),h.dir),E=0;for(let[I,j]of[["owned",y.owned],["context",y.context]])for(let[M,V]of Object.entries(j)){let q=Nt(S,I,M);await be.mkdir(qr(q),{recursive:!0}),await be.writeFile(q,V,"utf8"),E++}await be.writeFile(Nt(S,".turbobase-release.json"),JSON.stringify({releaseId:y.releaseId,version:y.version,contentDigest:y.contentDigest},null,2),"utf8"),_(`pulled release ${y.releaseId} (${y.status}) \u2192 ${S}
package/dist/turbobase.js CHANGED
@@ -4226,7 +4226,7 @@ ${o.map(aS).join(`
4226
4226
  `))}async function Oh(t,e,r=Hr){let n=[...new Set(t.map(a=>a.trim()).filter(Boolean))];n.length===0&&v("name at least one skill slug. `turbobase skills list` shows them.");let o=await Kr(e,r);if(!await ps(`Publish ${n.length} skill(s)?`,"Yes \u2014 publish them","their text is injected into every matching turn from now on",e))return;let i;try{i=await X("publishing",()=>o.skillsPublish(n))}catch(a){V(a,"skills:publish","publish a skill"),v(`publish failed: ${a instanceof Error?a.message:String(a)}`)}y(m.green(`published ${i.published.length} skill(s) \u2014 live now.`)),i.unknown.length>0&&(O(m.yellow(`no such skill: ${i.unknown.join(", ")}`)),process.exitCode=1),O(m.dim(`release v${i.version.version_no} \xB7 undo with: turbobase skills unpublish ${i.published.join(" ")}`))}async function Nh(t,e,r=Hr){let n=[...new Set(t.map(a=>a.trim()).filter(Boolean))];n.length===0&&v("name at least one skill slug. `turbobase skills list` shows them.");let o=await Kr(e,r);if(!await ps(`Move ${n.length} skill(s) back to draft?`,"Yes \u2014 unpublish them","they stop being injected immediately; the text and its history are kept",e))return;let i;try{i=await X("unpublishing",()=>o.skillsUnpublish(n))}catch(a){V(a,"skills:publish","unpublish a skill"),v(`unpublish failed: ${a instanceof Error?a.message:String(a)}`)}y(m.green(`unpublished ${i.unpublished.length} skill(s) \u2014 retracted now.`)),O(m.dim(`release v${i.version.version_no} \xB7 re-publish with: turbobase skills publish ${i.unpublished.join(" ")}`)),i.unknown.length>0&&(O(m.yellow(`no such skill: ${i.unknown.join(", ")}`)),process.exitCode=1)}async function Lh(t,e,r=Hr){let n=Number(t);(!Number.isInteger(n)||n<1)&&v(`--version must be a release number (got '${t}'). \`turbobase skills releases\` lists them.`);let o=await Kr(e,r);if(await ps(`Roll the skills back to release v${n}?`,"Yes \u2014 restore that release","content only: a skill an operator has since unpublished stays off",e))try{let i=await X("rolling back",()=>o.skillsRollback(n));y(m.green(`rolled back to v${i.version.version_no}.`))}catch(i){V(i,"skills:publish","roll back a skills release"),v(`rollback failed: ${i instanceof Error?i.message:String(i)}`)}}async function jh(t,e=Hr){let r=await Kr(t,e),n;try{n=await X("reading the releases",()=>r.skillsReleases())}catch(o){V(o,"skills:publish","read the skills releases"),v(`could not read the releases: ${o instanceof Error?o.message:String(o)}`)}if(n.items.length===0){O("no releases yet.");return}for(let o of n.items){let s=o.is_current?m.green("*"):" ",i=o.release_note?` \u2014 ${o.release_note}`:"";y(`${s} v${o.version_no} ${o.skill_count} skill(s) ${m.dim(o.published_at)}${o.published_by?m.dim(` by ${o.published_by}`):""}${m.dim(i)}`)}}async function Dh(t,e,r=Hr){let n=[...new Set((t??[]).map(u=>u.trim()).filter(Boolean))];n.length===0&&v("name at least one skill to delete. `turbobase skills list` shows the slugs.");let o=await Kr(e,r);if(!await ps(n.length===1?`Delete the skill '${n[0]}'?`:`Delete ${n.length} skills?
4227
4227
  ${n.join(`
4228
4228
  `)}`,"Yes \u2014 delete them","permanent: the rows and their text are removed. Prior releases keep their own copy.",e))return;let i=[],a=[];for(let u of n)try{i.push(await X(`deleting ${u}`,()=>o.skillsDelete(u)))}catch(p){if(p instanceof Y&&p.status===404){a.push(u);continue}i.length>0&&O(m.dim(`deleted before the error: ${i.map(g=>g.slug).join(", ")}`)),V(p,"skills:publish","delete a skill"),v(`delete failed on '${u}': ${p instanceof Error?p.message:String(p)}`)}i.length>0&&y(m.green(`deleted ${i.length} skill(s).`));let l=i.filter(u=>u.wasPublished).map(u=>u.slug);l.length>0&&O(m.yellow(`Published until now, so no longer injected: ${l.join(", ")}`)),a.length>0&&(O(m.yellow(`no such skill: ${a.join(", ")}`)),process.exitCode=1)}import{promises as Uh}from"node:fs";import{join as WS,relative as JS,resolve as YS,sep as XS}from"node:path";var ZS=new Set(["node_modules","dist","build","coverage",".git",".claude",".turbobase",".next",".svelte-kit",".vercel",".cache"]),QS=new Set([".mcp.json",".env"]);function ek(t){return QS.has(t)||t.startsWith(".env.")&&t!==".env.example"}function tk(t){return Buffer.compare(Buffer.from(t.toString("utf8"),"utf8"),t)===0}function rk(t){return t.includes(0)}async function Da(t){let e=YS(t),r={},n=[],o=[],s=[];async function i(a){let l=await Uh.readdir(a,{withFileTypes:!0});for(let u of l){let p=WS(a,u.name);if(ZS.has(u.name))continue;if(u.isDirectory()){await i(p);continue}if(!u.isFile())continue;let g=JS(e,p).split(XS).join("/");if(ek(u.name)){o.push(g);continue}let k=await Uh.readFile(p);if(!tk(k)){n.push(g);continue}rk(k)&&s.push(g),r[g]=k.toString("utf8")}}return await i(e),{files:r,skipped:n,secrets:o,unstorable:s}}import{randomBytes as nk}from"node:crypto";var ok="/_tb/app-assets",sk=16,ik=/^[0-9a-f]{32}$/;function Mh(){return nk(sk).toString("hex")}function ak(t){return ik.test(t)}function qh(t){if(!ak(t))throw new Error(`not a build id: ${t}`);return`${ok}/${t}/`}var zh=7;Ma();var qa=50*1024*1024;import hs from"node:fs/promises";import On from"node:path";var za={esbuild:"0.28.1","isolated-vm":"6.1.2"},Ba="@turbobase/isolated-vm-prebuilds";function Fa(t,e){return`${t}-${e}`}function Ha(t=process.versions){return`abi${t.modules}`}var Bh=["darwin-x64","win32-arm64"];async function Fh(t){let e=t.platform??process.platform,r=t.arch??process.arch,n=Fa(e,r),o=On.join(t.home,"node_modules"),s=On.join(o,...Ba.split("/"),"prebuilds",n),i=On.join(o,"isolated-vm","prebuilds",n),a;try{a=await hs.readdir(s)}catch{return[]}let l=[];await hs.mkdir(i,{recursive:!0});for(let u of a){if(!u.endsWith(".node"))continue;let p=On.join(i,u);try{await hs.copyFile(On.join(s,u),p,hs.constants?.COPYFILE_EXCL??1),l.push(u)}catch{}}return l}import{homedir as lk}from"node:os";import{join as Hh}from"node:path";import{promises as Ka}from"node:fs";function Vh(){let t=process.env.TURBOBASE_HOME??Hh(lk(),".turbobase");return{dir:t,file:Hh(t,"sandboxes.json")}}var ck={s:1e3,m:6e4,h:36e5,d:864e5};function dk(t){let e=/^\s*(\d+)\s*([smhd])\s*$/.exec(t);if(!e)throw new Error(`invalid --ttl '${t}': expected <number><unit> where unit is s|m|h|d (e.g. 72h, 30m, 7d).`);let r=Number(e[1]);if(!Number.isFinite(r)||r<=0)throw new Error(`invalid --ttl '${t}': duration must be a positive integer.`);return r*ck[e[2]]}function uk(t,e=Date.now()){return new Date(e+dk(t)).toISOString()}function pk(t,e=Date.now()){let r=Date.parse(t);return Number.isNaN(r)?!0:r<=e}function hk(t){let e=/^\s*(\d+(?:\.\d+)?)\s*%?\s*$/.exec(t);if(!e)throw new Error(`invalid --sample '${t}': expected a percent like 2% (or a bare number).`);let r=Number(e[1]);if(!Number.isFinite(r)||r<0||r>100)throw new Error(`invalid --sample '${t}': percent must be between 0 and 100.`);return r/100}function mk(t,e){if(e>=1)return[...t];if(e<=0||t.length===0)return[];let r=Math.max(1,Math.round(1/e)),n=[];for(let o=0;o<t.length;o+=r)n.push(t[o]);return n}var fk="[REDACTED]",Nn=class extends Error{constructor(e){super(e),this.name="SandboxDataCopyUnavailableError"}},Va=class extends Error{table;column;constructor(e,r,n){super(`Refusing to copy ${e}.${r} into a sandbox: ${n}. A sandbox must never hold un-redacted PII \u2014 classify the column 'safe' (non-PII) or let redaction mask it, then retry.`),this.name="UnredactedPiiError",this.table=e,this.column=r}};function gk(t,e,r){let n={};for(let[o,s]of Object.entries(e)){let i=r[o];if(i===void 0)throw new Va(t,o,"column has no PII classification (unknown = unsafe)");i==="pii"?n[o]=s==null?s:fk:n[o]=s}return n}function yk(t,e,r){return e.map(n=>gk(t,n,r))}var Kh=new Set(["localhost","127.0.0.1","::1","0.0.0.0"]),bk=["oraclecloud.com","us-ashburn-1","amazonaws.com","rds.","supabase.co","turbobase.app","turbobase.io"];function wk(t){let e=t.trim();try{let o=new URL(e);if(o.hostname)return o.hostname.toLowerCase()}catch{}let r=e.replace(/^[a-z]+:\/\//i,""),n=(r.split("/")[0]??r).split("@").pop()??r;return(n.split(":")[0]??n).toLowerCase()}function Ga(t){if(!t||!t.trim())throw new Error("local-only guard: empty database target \u2014 refusing to proceed.");let e=t.toLowerCase();for(let n of bk)if(e.includes(n))throw new Error(`local-only guard: target '${t}' looks like a cloud/prod context (matched '${n}'). \`turbobase sandbox create\` is LOCAL-ONLY and will never touch a cloud database.`);let r=wk(t);if(!Kh.has(r))throw new Error(`local-only guard: target host '${r}' is not a recognised local Postgres (${[...Kh].join(", ")}). \`turbobase sandbox create\` is LOCAL-ONLY.`)}function vk(t,e=_k){return`sbx-${t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,24)||"tenant"}-${e()}`}function _k(){return Math.floor(Math.random()*16777215).toString(16).padStart(6,"0")}function Sk(t){return`turbobase_${t.replace(/[^a-z0-9]+/gi,"_").toLowerCase()}`}function kk(t,e){return`${(e??process.env.TURBOBASE_SANDBOX_BASE_URL??"http://localhost:5173").replace(/\/+$/,"")}/?sandbox=${encodeURIComponent(t)}`}async function Wa(){let{file:t}=Vh();try{let e=await Ka.readFile(t,"utf8"),r=JSON.parse(e);return Array.isArray(r)?r:[]}catch(e){if(e.code==="ENOENT")return[];throw e}}async function Gh(t){let{dir:e,file:r}=Vh();await Ka.mkdir(e,{recursive:!0}),await Ka.writeFile(r,`${JSON.stringify(t,null,2)}
4229
- `,{mode:384})}async function Tk(t){let e=await Wa();e.push(t),await Gh(e)}async function Wh(t){let e=await Wa(),r=e.findIndex(o=>o.name===t);if(r===-1)return null;let[n]=e.splice(r,1);return await Gh(e),n??null}async function ms(){return Wa()}function Ja(t,e=Date.now()){let r=[],n=[];for(let o of t)pk(o.expiresAt,e)?n.push(o):r.push(o);return{active:r,expired:n}}async function Jh(t,e){Ga(t.target());let r=t.dataCopyUnavailable?.();if(r)throw new Nn(r);let n=hk(e.sample),o=e.now??Date.now(),s=(e.nameGen??(u=>vk(u)))(e.fromTenant),i=Sk(s);await t.createDatabase(i),await t.replayMigrations(i);let a=await t.readSourceTables(e.fromTenant);for(let u of a){let p=mk(u.rows,n),g=yk(u.table,p,u.classification);g.length>0&&await t.copyRows(i,u.table,g)}let l={name:s,fromTenant:e.fromTenant,database:i,createdAt:new Date(o).toISOString(),expiresAt:uk(e.ttl,o),sampleFraction:n,url:kk(s,e.baseUrl)};return await Tk(l),l}async function Yh(t,e){Ga(t.target());let n=(await ms()).find(o=>o.name===e);return n?(await t.dropDatabase(n.database),await Wh(e),n):null}async function Ya(t,e=Date.now()){Ga(t.target());let r=await ms(),{expired:n}=Ja(r,e),o=[];for(let s of n){try{await t.dropDatabase(s.database)}catch{continue}await Wh(s.name),o.push(s)}return o}var Ln={pat:{prefix:"tb_pat_",defaultScopes:["extensions:deploy"],allowedScopes:["extensions:deploy","catalog:read","mcp:authoring","analyzer:run","releases:write","solutions:write","skills:publish","docs:publish","mcp:data","mcp:write","rest:read","rest:write","ai:invoke"],defaultTtlDays:90,mintable:!0,label:"Personal access token"},catalog:{prefix:"tb_cat_",defaultScopes:["catalog:read"],allowedScopes:["catalog:read"],defaultTtlDays:null,mintable:!0,label:"AI / catalog token"}},GN=Object.keys(Ln).filter(t=>Ln[t].mintable);var YN=Ln.pat.prefix,Rk=Object.entries(Ln).map(([t,e])=>[e.prefix,t]),xk=/^[A-Za-z0-9_-]{20,}$/;function $k(t){if(typeof t!="string")return null;for(let[e,r]of Rk)if(t.startsWith(e)&&xk.test(t.slice(e.length)))return r;return null}function Xh(t){return $k(t)==="pat"}_n();var Ek=8e3,Pk={revoked:"the instance REVOKED this token \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",expired:"this token has EXPIRED \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",unknown:"this instance has never seen this token \u2014 it was deleted, or it belongs to a DIFFERENT instance; check the base-url before minting a new PAT",suspended:"the user this token belongs to is SUSPENDED \u2014 an instance administrator has to restore the account; a new token will not help",malformed:"the stored credential is not shaped like a Turbobase PAT (tb_pat_\u2026) \u2014 sign in again",missing:"no token reached the instance \u2014 sign in again",transient:"the instance could not verify the token right now (a storage error, not a decision about the token) \u2014 retry"};function Ak(t){return Pk[t]??`the instance rejected this token (${t}) \u2014 run \`turbobase auth login\` to store a fresh PAT`}async function Ck(t,e,r=fetch){let n;try{n=await r(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(Ek)})}catch(s){return{state:"unreachable",detail:s instanceof Error?s.message:String(s)}}if(n.status===200||n.status===403)return{state:"accepted"};if(n.status===401){let s=await n.json().catch(()=>null);return{state:"rejected",reason:typeof s?.reason=="string"&&s.reason?s.reason:"unknown"}}return(n.headers.get("content-type")??"").includes("application/json")?{state:"accepted"}:{state:"unreachable",detail:`HTTP ${n.status} \u2014 this host does not serve the /v1 API`}}function Zh(t){return t.state==="accepted"?Oe()?m.green("accepted"):"accepted":t.state==="rejected"?Oe()?m.red(`rejected \xB7 ${t.reason}`):`rejected \xB7 ${t.reason}`:Oe()?m.yellow("unreachable"):"unreachable"}async function Qh(t={},e=fetch){let r=await jt(),{file:n}=qo();if(r.length===0){y("not signed in. Run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),O(m.dim(`no sign-ins stored in ${n}.`));return}let o=await ft(),s=await Promise.all(r.map(async i=>({baseUrl:i.baseUrl,active:!!o&&i.baseUrl===o.baseUrl,updatedAt:i.updatedAt,check:t.probe===!1?{state:"accepted"}:await Ck(i.baseUrl,i.token,e)})));if(t.probe===!1)for(let i of s)y(`${i.active?"* ":" "}${i.baseUrl} (updated ${i.updatedAt})`);else if(Oe())y(it(s.map(i=>[i.active?m.green("*"):" ",m.bold(i.baseUrl),Zh(i.check),m.dim(i.updatedAt)]),{head:["","instance","token","updated"]}));else for(let i of s)y(`${i.active?"* ":" "}${i.baseUrl} ${Zh(i.check)} (updated ${i.updatedAt})`);O(m.dim(`tokens read from ${n}`));for(let i of s)i.check.state==="rejected"?(O(m.red(`${i.baseUrl}: ${Ak(i.check.reason)}.`)),O(m.dim(" then re-run `turbobase project init` \u2014 .mcp.json holds its own copy of the token, and until it is rewritten the authoring MCP tools stay absent from your session."))):i.check.state==="unreachable"&&O(m.yellow(`${i.baseUrl}: could not reach the instance (${i.check.detail}).`));o||O("no active default \u2014 run `turbobase auth use <base-url>` or pass --base-url.")}async function eC(t){let e=await jt();e.length===0&&v("no stored sign-ins \u2014 run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),Ne()||v("this command needs an explicit <base-url> in a non-interactive shell.");try{return await Le(t,e.map(r=>({value:r.baseUrl,label:r.baseUrl,description:`updated ${r.updatedAt}`})))}catch{v("cancelled.")}}async function tC(t,e){let r;try{r=await fetch(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(8e3)})}catch(o){return{ok:!1,kind:"unreachable",detail:o instanceof Error?o.message:String(o)}}let n=(r.headers.get("content-type")??"").includes("application/json");return r.status===200||r.status===403?{ok:!0}:r.status===401?{ok:!1,kind:"bad-token",detail:`HTTP ${r.status}`}:n?{ok:!0}:{ok:!1,kind:"wrong-host",detail:`HTTP ${r.status}`}}function rC(t){O(""),O("Sharing is ON. Two things reach the Turbobase product team from this instance:"),O(" \xB7 anonymized pattern cards from your proposals, solutions and INSTANCE-LEARNINGS.md \u2014"),O(" a pattern label, a record class, a fix shape, an outcome. No scripts, values or ids."),O(" \xB7 redacted prose from your projects\u2019 TURBOBASE-FEEDBACK.md \u2014 the findings you write"),O(" about OUR platform, with instance name, user names and ids masked before they leave."),O(`Turn it off: ${t}/admin/settings \u2192 Telemetry \u2192 "Share learnings and platform feedback".`),O("")}async function nC(t,e,r){let n=await Cu({baseUrl:t,token:e}),o=(await jt()).length-1;if(y(`signed in to ${n.baseUrl} \u2014 now the active instance`+(o>0?` (${o} other${o===1?"":"s"} stored; commands default here).`:".")),rC(n.baseUrl),!r)return;let s=await tC(n.baseUrl,e);s.ok||(s.kind==="wrong-host"?(O(`warning: ${n.baseUrl} did not respond to the Turbobase API (/v1) \u2014 got ${s.detail}.`),O(" In local dev the Turbobase API is on :4100, not the app dev-server port (e.g. :5173)."),O(" The token is stored, but commands will fail against this base-url until it points at the API.")):s.kind==="bad-token"?O(`warning: ${n.baseUrl} rejected the token (401) \u2014 the PAT may be stale, revoked, or for a different instance.`):O(`warning: could not reach ${n.baseUrl} to verify the token (${s.detail}). Stored anyway.`))}async function oC(t){let e=await pa(await Rn(t),Ht(t)),r=xa(e);return r||v(`${t}: ${Ea(e)}`),{...r,sourceCode:e}}async function Cr(t,e,r,n){try{return await ie.access(t),"skipped"}catch{}return await ie.mkdir(Ht(t),{recursive:!0}),await ie.writeFile(t,e,{mode:n??(r?493:420)}),n!==void 0&&await ie.chmod(t,n),"wrote"}async function Qb(t,e){if(tw(t)!==".gitignore")return Cr(t,e.content,e.executable,e.mode);let r=await ie.readFile(t,"utf8").catch(()=>null);if(r===null)return Cr(t,e.content,e.executable,e.mode);let n=Up(r);return n===null?"skipped":(await ie.writeFile(t,n,"utf8"),"merged")}function Gd(t){if(t!==void 0){if(t==="junit"||t==="json")return t;v(`unknown --reporter '${t}' (expected 'junit' or 'json').`)}}function Mi(t){process.exit(t)}function sC(t){return{name:"turbobase ext test",cases:t.map(r=>{if(r.pass)return{name:r.name,status:"passed"};let n=r.error?"error":r.rejection?.code??"mismatch",o=r.error?`error: ${r.error}`:r.observed!==r.expected?`expected ${r.expected}, observed ${r.observed}`+(r.rejection?` (rejected: ${r.rejection.code??"rejected"}${r.rejection.message?` \u2014 ${r.rejection.message}`:""})`:""):`rejected: ${r.rejection?.code??"rejected"}${r.rejection?.message?` \u2014 ${r.rejection.message}`:""}`;return{name:r.name,status:"failed",detail:o,type:n}})}}function iC(t,e){let r=e.warnings.length===0?[{name:`${t} (${e.kind})`,status:"passed"}]:e.warnings.map(n=>({name:`${t}: ${n.rule}`,status:"failed",type:n.rule,detail:`${n.message} \u2192 fix: ${n.fix}`}));return{name:`turbobase ext lint ${t}`,cases:r}}function aC(t){let e=[];if(t.error)return e.push({name:`replay ${t.fixtureName}`,status:"failed",type:"error",detail:t.error}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e};for(let r of t.guards)e.push(r.status==="failed"?{name:`guard: ${r.name}`,status:"failed",type:r.name,detail:r.detail}:{name:`guard: ${r.name}`,status:"passed",detail:r.status==="skipped-offline"?`skipped-offline: ${r.detail}`:void 0});return t.whenPassed&&t.applyBranch&&e.push({name:`apply-branch: ${t.applyBranch}`,status:"passed",detail:`${t.masterAction??""} (${t.wouldWriteBindings.length} binding(s) would be written)`.trim()}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e}}function ew(t){return`${(Math.ceil(t/1048576*10)/10).toFixed(1).replace(/\.0$/,"")} MiB`}function Qd({includeInternal:t=!0}={}){let e=new QA;e.name("turbobase").description("Build apps, author extensions, and drive your Turbobase instance.").version("1.45.0").option("--no-color","Disable ANSI colour + animations (also honoured via NO_COLOR / non-TTY)."),e.addHelpText("beforeAll",d=>d.command.parent?"":`${wa()}
4229
+ `,{mode:384})}async function Tk(t){let e=await Wa();e.push(t),await Gh(e)}async function Wh(t){let e=await Wa(),r=e.findIndex(o=>o.name===t);if(r===-1)return null;let[n]=e.splice(r,1);return await Gh(e),n??null}async function ms(){return Wa()}function Ja(t,e=Date.now()){let r=[],n=[];for(let o of t)pk(o.expiresAt,e)?n.push(o):r.push(o);return{active:r,expired:n}}async function Jh(t,e){Ga(t.target());let r=t.dataCopyUnavailable?.();if(r)throw new Nn(r);let n=hk(e.sample),o=e.now??Date.now(),s=(e.nameGen??(u=>vk(u)))(e.fromTenant),i=Sk(s);await t.createDatabase(i),await t.replayMigrations(i);let a=await t.readSourceTables(e.fromTenant);for(let u of a){let p=mk(u.rows,n),g=yk(u.table,p,u.classification);g.length>0&&await t.copyRows(i,u.table,g)}let l={name:s,fromTenant:e.fromTenant,database:i,createdAt:new Date(o).toISOString(),expiresAt:uk(e.ttl,o),sampleFraction:n,url:kk(s,e.baseUrl)};return await Tk(l),l}async function Yh(t,e){Ga(t.target());let n=(await ms()).find(o=>o.name===e);return n?(await t.dropDatabase(n.database),await Wh(e),n):null}async function Ya(t,e=Date.now()){Ga(t.target());let r=await ms(),{expired:n}=Ja(r,e),o=[];for(let s of n){try{await t.dropDatabase(s.database)}catch{continue}await Wh(s.name),o.push(s)}return o}var Ln={pat:{prefix:"tb_pat_",defaultScopes:["extensions:deploy"],allowedScopes:["extensions:deploy","catalog:read","mcp:authoring","analyzer:run","releases:write","solutions:write","skills:publish","docs:publish","mcp:data","mcp:write","rest:read","rest:write","ai:invoke"],defaultTtlDays:90,mintable:!0,label:"Personal access token"},catalog:{prefix:"tb_cat_",defaultScopes:["catalog:read"],allowedScopes:["catalog:read"],defaultTtlDays:null,mintable:!0,label:"AI / catalog token"}},GN=Object.keys(Ln).filter(t=>Ln[t].mintable);var YN=Ln.pat.prefix,Rk=Object.entries(Ln).map(([t,e])=>[e.prefix,t]),xk=/^[A-Za-z0-9_-]{20,}$/;function $k(t){if(typeof t!="string")return null;for(let[e,r]of Rk)if(t.startsWith(e)&&xk.test(t.slice(e.length)))return r;return null}function Xh(t){return $k(t)==="pat"}_n();var Ek=8e3,Pk={revoked:"the instance REVOKED this token \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",expired:"this token has EXPIRED \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",unknown:"this instance has never seen this token \u2014 it was deleted, or it belongs to a DIFFERENT instance; check the base-url before minting a new PAT",suspended:"the user this token belongs to is SUSPENDED \u2014 an instance administrator has to restore the account; a new token will not help",malformed:"the stored credential is not shaped like a Turbobase PAT (tb_pat_\u2026) \u2014 sign in again",missing:"no token reached the instance \u2014 sign in again",transient:"the instance could not verify the token right now (a storage error, not a decision about the token) \u2014 retry"};function Ak(t){return Pk[t]??`the instance rejected this token (${t}) \u2014 run \`turbobase auth login\` to store a fresh PAT`}async function Ck(t,e,r=fetch){let n;try{n=await r(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(Ek)})}catch(s){return{state:"unreachable",detail:s instanceof Error?s.message:String(s)}}if(n.status===200||n.status===403)return{state:"accepted"};if(n.status===401){let s=await n.json().catch(()=>null);return{state:"rejected",reason:typeof s?.reason=="string"&&s.reason?s.reason:"unknown"}}return(n.headers.get("content-type")??"").includes("application/json")?{state:"accepted"}:{state:"unreachable",detail:`HTTP ${n.status} \u2014 this host does not serve the /v1 API`}}function Zh(t){return t.state==="accepted"?Oe()?m.green("accepted"):"accepted":t.state==="rejected"?Oe()?m.red(`rejected \xB7 ${t.reason}`):`rejected \xB7 ${t.reason}`:Oe()?m.yellow("unreachable"):"unreachable"}async function Qh(t={},e=fetch){let r=await jt(),{file:n}=qo();if(r.length===0){y("not signed in. Run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),O(m.dim(`no sign-ins stored in ${n}.`));return}let o=await ft(),s=await Promise.all(r.map(async i=>({baseUrl:i.baseUrl,active:!!o&&i.baseUrl===o.baseUrl,updatedAt:i.updatedAt,check:t.probe===!1?{state:"accepted"}:await Ck(i.baseUrl,i.token,e)})));if(t.probe===!1)for(let i of s)y(`${i.active?"* ":" "}${i.baseUrl} (updated ${i.updatedAt})`);else if(Oe())y(it(s.map(i=>[i.active?m.green("*"):" ",m.bold(i.baseUrl),Zh(i.check),m.dim(i.updatedAt)]),{head:["","instance","token","updated"]}));else for(let i of s)y(`${i.active?"* ":" "}${i.baseUrl} ${Zh(i.check)} (updated ${i.updatedAt})`);O(m.dim(`tokens read from ${n}`));for(let i of s)i.check.state==="rejected"?(O(m.red(`${i.baseUrl}: ${Ak(i.check.reason)}.`)),O(m.dim(" then re-run `turbobase project init` \u2014 .mcp.json holds its own copy of the token, and until it is rewritten the authoring MCP tools stay absent from your session."))):i.check.state==="unreachable"&&O(m.yellow(`${i.baseUrl}: could not reach the instance (${i.check.detail}).`));o||O("no active default \u2014 run `turbobase auth use <base-url>` or pass --base-url.")}async function eC(t){let e=await jt();e.length===0&&v("no stored sign-ins \u2014 run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),Ne()||v("this command needs an explicit <base-url> in a non-interactive shell.");try{return await Le(t,e.map(r=>({value:r.baseUrl,label:r.baseUrl,description:`updated ${r.updatedAt}`})))}catch{v("cancelled.")}}async function tC(t,e){let r;try{r=await fetch(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(8e3)})}catch(o){return{ok:!1,kind:"unreachable",detail:o instanceof Error?o.message:String(o)}}let n=(r.headers.get("content-type")??"").includes("application/json");return r.status===200||r.status===403?{ok:!0}:r.status===401?{ok:!1,kind:"bad-token",detail:`HTTP ${r.status}`}:n?{ok:!0}:{ok:!1,kind:"wrong-host",detail:`HTTP ${r.status}`}}function rC(t){O(""),O("Sharing is ON. Two things reach the Turbobase product team from this instance:"),O(" \xB7 anonymized pattern cards from your proposals, solutions and INSTANCE-LEARNINGS.md \u2014"),O(" a pattern label, a record class, a fix shape, an outcome. No scripts, values or ids."),O(" \xB7 redacted prose from your projects\u2019 TURBOBASE-FEEDBACK.md \u2014 the findings you write"),O(" about OUR platform, with instance name, user names and ids masked before they leave."),O(`Turn it off: ${t}/admin/settings \u2192 Telemetry \u2192 "Share learnings and platform feedback".`),O("")}async function nC(t,e,r){let n=await Cu({baseUrl:t,token:e}),o=(await jt()).length-1;if(y(`signed in to ${n.baseUrl} \u2014 now the active instance`+(o>0?` (${o} other${o===1?"":"s"} stored; commands default here).`:".")),rC(n.baseUrl),!r)return;let s=await tC(n.baseUrl,e);s.ok||(s.kind==="wrong-host"?(O(`warning: ${n.baseUrl} did not respond to the Turbobase API (/v1) \u2014 got ${s.detail}.`),O(" In local dev the Turbobase API is on :4100, not the app dev-server port (e.g. :5173)."),O(" The token is stored, but commands will fail against this base-url until it points at the API.")):s.kind==="bad-token"?O(`warning: ${n.baseUrl} rejected the token (401) \u2014 the PAT may be stale, revoked, or for a different instance.`):O(`warning: could not reach ${n.baseUrl} to verify the token (${s.detail}). Stored anyway.`))}async function oC(t){let e=await pa(await Rn(t),Ht(t)),r=xa(e);return r||v(`${t}: ${Ea(e)}`),{...r,sourceCode:e}}async function Cr(t,e,r,n){try{return await ie.access(t),"skipped"}catch{}return await ie.mkdir(Ht(t),{recursive:!0}),await ie.writeFile(t,e,{mode:n??(r?493:420)}),n!==void 0&&await ie.chmod(t,n),"wrote"}async function Qb(t,e){if(tw(t)!==".gitignore")return Cr(t,e.content,e.executable,e.mode);let r=await ie.readFile(t,"utf8").catch(()=>null);if(r===null)return Cr(t,e.content,e.executable,e.mode);let n=Up(r);return n===null?"skipped":(await ie.writeFile(t,n,"utf8"),"merged")}function Gd(t){if(t!==void 0){if(t==="junit"||t==="json")return t;v(`unknown --reporter '${t}' (expected 'junit' or 'json').`)}}function Mi(t){process.exit(t)}function sC(t){return{name:"turbobase ext test",cases:t.map(r=>{if(r.pass)return{name:r.name,status:"passed"};let n=r.error?"error":r.rejection?.code??"mismatch",o=r.error?`error: ${r.error}`:r.observed!==r.expected?`expected ${r.expected}, observed ${r.observed}`+(r.rejection?` (rejected: ${r.rejection.code??"rejected"}${r.rejection.message?` \u2014 ${r.rejection.message}`:""})`:""):`rejected: ${r.rejection?.code??"rejected"}${r.rejection?.message?` \u2014 ${r.rejection.message}`:""}`;return{name:r.name,status:"failed",detail:o,type:n}})}}function iC(t,e){let r=e.warnings.length===0?[{name:`${t} (${e.kind})`,status:"passed"}]:e.warnings.map(n=>({name:`${t}: ${n.rule}`,status:"failed",type:n.rule,detail:`${n.message} \u2192 fix: ${n.fix}`}));return{name:`turbobase ext lint ${t}`,cases:r}}function aC(t){let e=[];if(t.error)return e.push({name:`replay ${t.fixtureName}`,status:"failed",type:"error",detail:t.error}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e};for(let r of t.guards)e.push(r.status==="failed"?{name:`guard: ${r.name}`,status:"failed",type:r.name,detail:r.detail}:{name:`guard: ${r.name}`,status:"passed",detail:r.status==="skipped-offline"?`skipped-offline: ${r.detail}`:void 0});return t.whenPassed&&t.applyBranch&&e.push({name:`apply-branch: ${t.applyBranch}`,status:"passed",detail:`${t.masterAction??""} (${t.wouldWriteBindings.length} binding(s) would be written)`.trim()}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e}}function ew(t){return`${(Math.ceil(t/1048576*10)/10).toFixed(1).replace(/\.0$/,"")} MiB`}function Qd({includeInternal:t=!0}={}){let e=new QA;e.name("turbobase").description("Build apps, author extensions, and drive your Turbobase instance.").version("1.45.1").option("--no-color","Disable ANSI colour + animations (also honoured via NO_COLOR / non-TTY)."),e.addHelpText("beforeAll",d=>d.command.parent?"":`${wa()}
4230
4230
  `),e.hook("preAction",(d,h)=>{Zp(e.opts(),h.opts())});let r=e.command("auth").description("Sign in to an instance and manage stored credentials."),n=e.command("project").description("Set up the local project and the files an agent session reads."),o=e.command("ext").description("Author, test, ship, and observe extensions \u2014 hooks and conduits."),s=e.command("kb").description("Write into the instance's knowledge base."),i=e.command("skills").description("Write standing rules into the instance's agent skills.");r.command("login").description("Sign in to an instance by pasting a personal access token (PAT), stored in ~/.turbobase/credentials.").requiredOption("--base-url <url>","Instance base URL, e.g. https://acme.turbobase.app").option("--token <tb_pat_\u2026>","The PAT to store. Mint one in your app under Settings \u203A Access tokens.").option("--no-verify","Skip the post-login connectivity/token probe.").action(async d=>{let h=nt(d.baseUrl);d.token||v(`auth login needs --token. Mint a PAT in your Turbobase app (Settings \u203A Access tokens), then:
4231
4231
  ${qr} auth login --base-url ${h} --token tb_pat_\u2026`),Xh(d.token)||v("--token does not look like a Turbobase PAT (tb_pat_\u2026)."),await nC(h,d.token,d.verify)}),r.command("status").description("Show every stored sign-in, where its token was read from, and whether the instance still accepts it.").option("--no-probe","List the stored sign-ins without asking each instance about its token.").action(async d=>Qh({probe:d.probe})),r.command("use [base-url]").description("Make an already-stored instance the active default (omit the arg to pick interactively).").action(async d=>{let h=d??await eC("Pick the active instance:"),w=await zo(h);if(!w){let T=await jt();v(`no stored sign-in for ${nt(h)}.`+(T.length?` Stored: ${T.map(_=>_.baseUrl).join(", ")}.`:"")+` Run \`turbobase auth login --base-url ${nt(h)} --token tb_pat_\u2026\`.`)}y(`active instance \u2192 ${w.baseUrl}.`)}),r.command("logout").description("Remove a stored sign-in (defaults to the active instance).").option("--base-url <url>","Which instance to remove (defaults to the active/single one).").option("--all","Remove every stored sign-in.").action(async d=>{if(d.all){let T=await jt();for(let _ of T)await ia(_.baseUrl);y(`removed ${T.length} stored sign-in${T.length===1?"":"s"}.`);return}let h=await ia(d.baseUrl);h||v(d.baseUrl?`no stored sign-in for ${nt(d.baseUrl)}.`:"nothing to sign out of (or ambiguous \u2014 pass --base-url / --all).");let w=await ft();y(`signed out of ${h}.`+(w?` Active instance \u2192 ${w.baseUrl}.`:""))}),n.command("types").description("Generate types.ts from the signed-in instance's catalog.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("-o, --out <file>","Output file","types.ts").option("--records-only","Emit only record-shape interfaces (skip the OpenAPI half).").action(async d=>{let{baseUrl:h,token:w}=await B(d.baseUrl),T;try{T=await fr({baseUrl:h,token:w,recordsOnly:d.recordsOnly})}catch(f){let S=f instanceof Error?f.message:String(f);if(!d.recordsOnly&&/openapi\.json failed \(401/.test(S)){O("types-gen: /v1/catalog/openapi.json needs a browser session \u2014 emitting record shapes only. The record shapes are the half apps generate against; for the OpenAPI half, run it from a signed-in browser session.");try{T=await fr({baseUrl:h,token:w,recordsOnly:!0})}catch($){v(`types generation failed: ${$ instanceof Error?$.message:String($)}`)}}else v(`types generation failed: ${S}`)}let _=oe(process.cwd(),d.out);await ie.writeFile(_,T,"utf8"),y(`wrote ${_} (${T.split(`
4232
4232
  `).length} lines).`)}),th(n),n.command("grounding").description("Write the instance's grounding brief (source primer + record anatomy + KB retrieval) to a file for agent sessions.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--records <list>","Comma-separated record types to focus, e.g. purchaseOrder,itemReceipt.").option("--query <text>","Retrieval question for the knowledge base (e.g. what the app is about).").option("-o, --out <file>","Output file","INSTANCE.md").action(async d=>{let{baseUrl:h,token:w}=await B(d.baseUrl),T=new URLSearchParams;d.records&&T.set("records",d.records),d.query&&T.set("query",d.query);let _=T.toString(),f=await fetch(`${h}/v1/catalog/grounding${_?`?${_}`:""}`,{headers:{Authorization:`Bearer ${w}`,Accept:"application/json"}});f.ok||v(`grounding fetch failed: GET /v1/catalog/grounding \u2192 ${f.status}`);let $=((await f.json()).markdown??"").trim(),A=oe(process.cwd(),d.out),C=d.records?` records=${d.records}`:"",N=`<!-- GENERATED by \`turbobase project grounding\` against ${h}${C} \u2014 do not edit; re-run to refresh. -->
@@ -4256,7 +4256,7 @@ samples init: ${$} written, ${A} skipped.`)});let Lt=e.command("guardrails").des
4256
4256
  `+m.dim("create one with `turbobase guardrails create <name> --source <s> --record <r>`"));y(it(_.map(rw),{head:nw})),y(m.dim(" first match wins; lower PRIO is evaluated first."))}),Lt.command("create <name>").description("Create a rule gating PG\u2192source writes that match it.").option("--source <system>","Adapter id to scope to, or '*' for every source.","*").option("--record <type>","Record type to scope to, or '*' for every record.","*").option("--op <glob>","Raw op glob, when gating something other than a record write.").option("--target <glob>","Row address glob, e.g. 'salesOrder.12345'.").option("--actor <glob>","Only match this caller, e.g. 'agent:*' to gate AI writes but not human ones.").option("--decision <d>","allow | allow_with_audit | require_confirm | deny.","deny").option("--priority <n>","Lower is evaluated first (default 100).",d=>Number(d)).option("--when <expr>","Row predicate, e.g. 'total gt 10000'. Omit to match every row.").option("--reason <text>","Why this rule exists \u2014 shown to a blocked writer and in `list`.").option("--disabled","Create the rule parked, so it takes effect only when activated.").option("--confirm-freeze-all","Required for an unconditional deny across '*'/'*'.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:w,token:T}=await B(h.baseUrl),_=new z({baseUrl:w,token:T}),f;try{f=await _.guardrailCreate({name:d,source:h.source,record:h.record,decision:h.decision,...h.op?{op:h.op}:{},...h.target?{target:h.target}:{},...h.actor?{actor:h.actor}:{},...Number.isFinite(h.priority)?{priority:Number(h.priority)}:{},...h.when?{when:h.when}:{},...h.reason?{reason:h.reason}:{},...h.disabled?{enabled:!1}:{},...h.confirmFreezeAll?{confirmFreezeAll:!0}:{}})}catch(S){V(S,"extensions:deploy","create a guardrail"),v(`create guardrail failed: ${S instanceof Error?S.message:String(S)}`)}y(`${m.green("\u2713")} guardrail ${m.bold(f.name??f.id)} created${f.status==="active"?"":m.dim(` (${f.status} \u2014 activate it to take effect)`)}`),y(m.dim(` ${f.decision} ${f.source}/${f.record??f.op}${f.actor?` actor=${f.actor}`:""}${f.when?` where ${f.when}`:""} @prio ${f.priority}`)),y(m.dim(` verify with: turbobase guardrails test --source ${f.source==="*"?"<source>":f.source} --record <record>`))}),Lt.command("edit <name>").description("Change a rule \u2014 its decision, priority, predicate or reason.").option("--decision <d>","allow | allow_with_audit | require_confirm | deny.").option("--priority <n>","Lower is evaluated first.",d=>Number(d)).option("--when <expr>","New row predicate. Pass '' to match every row.").option("--reason <text>","Why this rule exists.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{h.decision===void 0&&h.priority===void 0&&h.when===void 0&&h.reason===void 0&&v("edit: nothing to change \u2014 pass --decision, --priority, --when or --reason.");let{baseUrl:w,token:T}=await B(h.baseUrl),_=new z({baseUrl:w,token:T}),f;try{f=await _.guardrailUpdate(d,{...h.decision!==void 0?{decision:h.decision}:{},...Number.isFinite(h.priority)?{priority:Number(h.priority)}:{},...h.when!==void 0?{when:h.when}:{},...h.reason!==void 0?{reason:h.reason}:{}})}catch(S){V(S,"extensions:deploy","edit a guardrail"),v(`edit guardrail failed: ${S instanceof Error?S.message:String(S)}`)}y(`${m.green("\u2713")} guardrail ${m.bold(f.name??f.id)} updated`),y(m.dim(` ${f.decision} ${f.source}/${f.record??f.op}${f.when?` where ${f.when}`:""} @prio ${f.priority}`))});for(let[d,h,w]of[["activate","active","activated"],["deactivate","inactive","deactivated"]])Lt.command(`${d} <name>`).description(h==="active"?"Arm a parked or proposed rule.":"Park a rule without deleting it \u2014 the reversible move mid-rollout.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(T,_)=>{let{baseUrl:f,token:S}=await B(_.baseUrl),$=new z({baseUrl:f,token:S});try{await $.guardrailUpdate(T,{status:h})}catch(A){V(A,"extensions:deploy",`${d} a guardrail`),v(`${d} guardrail failed: ${A instanceof Error?A.message:String(A)}`)}y(`${m.green("\u2713")} guardrail ${m.bold(T)} ${w}`),h==="inactive"&&y(m.dim(" writes it was gating now fall through to the other rules."))});Lt.command("delete <name>").description("Remove a rule. Prefer `deactivate` if you may want it back.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:w,token:T}=await B(h.baseUrl),_=new z({baseUrl:w,token:T});try{await _.guardrailDelete(d)}catch(f){V(f,"extensions:deploy","delete a guardrail"),v(`delete guardrail failed: ${f instanceof Error?f.message:String(f)}`)}y(`${m.green("\u2713")} guardrail ${m.bold(d)} deleted`)}),Lt.command("posture [mode]").description("Show or set the GLOBAL default. 'allow' = deny-list (unmatched writes allowed, carve with deny rules). 'deny' = allow-list (unmatched writes denied, open with allow rules).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:w,token:T}=await B(h.baseUrl),_=new z({baseUrl:w,token:T}),f=A=>A==="deny"?"deny-by-default (allow-list)":"allow-by-default (deny-list)";if(d===void 0){let A;try{A=await _.guardrailPostureGet()}catch(C){V(C,"extensions:deploy","read the guardrail posture"),v(`read posture failed: ${C instanceof Error?C.message:String(C)}`)}y(`guardrail posture: ${m.bold(f(A.mode))}`),y(m.dim(A.mode==="deny"?" Unmatched writes are DENIED. Open records with `guardrails create <name> --decision allow`.":" Unmatched writes are allowed-with-audit. Freeze records with `guardrails create <name> --decision deny`."));return}let S=d.trim().toLowerCase();S!=="allow"&&S!=="deny"&&v("posture must be 'allow' or 'deny'.");let $;try{$=await _.guardrailPostureSet(S)}catch(A){V(A,"extensions:deploy","set the guardrail posture"),v(`set posture failed: ${A instanceof Error?A.message:String(A)}`)}y(`${m.green("\u2713")} guardrail posture set to ${m.bold(f($.mode))}`),$.mode==="deny"&&y(m.dim(" Every record with no active ALLOW rule is now frozen for write-back. Verify with `guardrails test --source <s> --record <r>`."))}),Lt.command("test").description("What happens to this write? Runs the real evaluator; writes nothing.").requiredOption("--source <system>","Adapter id the write targets.").requiredOption("--record <type>","Record type the write targets.").option("--actor <actor>","Caller to simulate, e.g. 'agent:ai' or 'user:<id>'.").option("--external-id <id>","Source-side row id, for target-scoped rules.").option("--fields <json>","A candidate row as JSON, so `when` predicates can be decided.").option("--op <op>","Write op: 'delete' tests <record>.delete; omitted tests <record>.write.").option("--phase <phase>","boundary | cdc | worker | adapter. Defaults to worker (the last gate).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--json","Emit raw JSON.").action(async d=>{let h;if(d.fields)try{h=JSON.parse(d.fields)}catch($){v(`--fields must be valid JSON: ${$ instanceof Error?$.message:String($)}`)}let{baseUrl:w,token:T}=await B(d.baseUrl),_=new z({baseUrl:w,token:T}),f;try{f=await _.guardrailTest({source:d.source,record:d.record,...d.actor?{actor:d.actor}:{},...d.externalId?{externalId:d.externalId}:{},...h?{fields:h}:{},...d.op?{op:d.op}:{},...d.phase?{phase:d.phase}:{}})}catch($){V($,"extensions:deploy","test guardrails"),v(`guardrails test failed: ${$ instanceof Error?$.message:String($)}`)}if(d.json)return y(JSON.stringify(f,null,2));let S=`${d.source}/${f.op??d.record}`;f.degraded?(y(`${m.red("\u2717")} ${S} \u2014 guardrail policy is UNREADABLE; writes fail closed`),y(m.dim(` ${f.reason}`))):f.allowed?y(`${m.green("\u2713")} ${S} \u2014 ${f.decision}`+(f.blockedBy?m.dim(` (rule ${f.blockedBy})`):m.dim(" (no rule matched)"))):(y(`${m.red("\u2717")} ${S} \u2014 ${f.decision} by ${m.bold(f.blockedBy??"?")} at the ${f.phase} gate`),f.message&&y(m.dim(` ${f.message}`))),f.decision==="require_confirm"&&y(m.yellow(" this write is HELD for operator approval, not refused.")),f.allowed||(process.exitCode=1)});let bn=e.command("tables").description("Author custom tables on your instance (create, evolve, inspect)."),Po=(d,h={})=>{let w=`${m.bold(d.table)} ${m.dim(d.displayName)}`;y(d.exists===!1?`${w} ${m.dim("(new)")}`:w);for(let T of d.fields){let _=[T.required?"required":null].filter(Boolean).join(", "),f=h.showClaimants&&T.claimedBy?.length?` ${m.dim(`\u2190 ${T.claimedBy.join(", ")}`)}`:"";y(` ${T.column.padEnd(28)} ${T.type}${_?` (${_})`:""}${f}`)}h.showClaimants&&d.claimants.length>1&&y(m.dim(` claimed by ${d.claimants.join(", ")}`))};function Ao(d){if(d instanceof Y&&d.status===409){let h=d.body;h?.error==="table_conflict"&&h.message&&(O(h.message),process.exit(1))}v(`tables: ${d instanceof Error?d.message:String(d)}`)}let eu=async d=>{let h=tt(oe(process.cwd(),d),"public","turbobase.json"),w=await ie.readFile(h,"utf8").catch(()=>null);if(w===null)return null;let T;try{T=JSON.parse(w)}catch(f){v(`${h} is not valid JSON: ${f instanceof Error?f.message:String(f)}`)}let _=T.tables;return _===void 0?{tables:[],manifestPath:h}:(Array.isArray(_)||v(`${h}: "tables" must be an array.`),{tables:_,manifestPath:h})};bn.command("list").description("List the custom tables on your instance and who claims each one.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--json","Emit raw JSON instead of a table.").action(async d=>{let{baseUrl:h,token:w}=await B(d.baseUrl),T=new z({baseUrl:h,token:w}),_;try{_=await T.tablesList()}catch(f){V(f,"extensions:deploy","list tables"),v(`list tables failed: ${f instanceof Error?f.message:String(f)}`)}if(d.json)return y(JSON.stringify(_,null,2));if(_.length===0)return y("no custom tables yet \u2014 create one with `turbobase tables create <slug>`.");y(it(_.map(f=>[f.table,f.displayName,String(f.fields.length),f.status,f.claimedBy.join(", ")||"\u2014"]),{head:["TABLE","NAME","FIELDS","STATUS","CLAIMED BY"]}))}),bn.command("plan").description("Preview what this project's declared tables would do. Writes nothing; exits 1 on a conflict.").argument("[dir]","Project directory holding public/turbobase.json (default ./).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--as <claimant>","Claim as `cli` or `app:<slug>` (default: the app slug in .turbobase, else cli).").action(async(d,h)=>{let w=await eu(d??".");if(w||v(`no public/turbobase.json under ${oe(process.cwd(),d??".")}.`),w.tables.length===0)return y(`${w.manifestPath} declares no tables \u2014 nothing to plan.`);let{baseUrl:T,token:_}=await B(h.baseUrl),f=new z({baseUrl:T,token:_}),S;try{S=await X("planning tables",()=>f.tablesPlan({claimedBy:h.as,tables:w.tables}))}catch($){V($,"extensions:deploy","plan tables"),Ao($)}y(`claiming as ${m.bold(S.claimedBy)}`);for(let $ of S.tables)Po($,{showClaimants:!0});y(""),y(m.dim("nothing was applied \u2014 run `turbobase tables apply` (or deploy the app) to make it so."))}),bn.command("apply").description("Apply this project's declared tables to the instance.").argument("[dir]","Project directory holding public/turbobase.json (default ./).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--as <claimant>","Claim as `cli` or `app:<slug>` (default: cli).").action(async(d,h)=>{let w=await eu(d??".");if(w||v(`no public/turbobase.json under ${oe(process.cwd(),d??".")}.`),w.tables.length===0)return y(`${w.manifestPath} declares no tables \u2014 nothing to apply.`);let{baseUrl:T,token:_}=await B(h.baseUrl),f=new z({baseUrl:T,token:_}),S;try{S=await X("applying tables",()=>f.tablesApply({claimedBy:h.as,tables:w.tables}))}catch($){V($,"extensions:deploy","apply tables"),Ao($)}for(let $ of S.tables)Po($,{showClaimants:!0});y(`applied ${S.tables.length} table${S.tables.length===1?"":"s"} as ${S.claimedBy}.`)}),bn.command("create").description('Create a single table without a manifest (the CLI twin of "New custom table").').argument("<slug>","Table slug; the physical table is cr_<slug>.").requiredOption("-f, --field <name:type>","Field as name:type[:required] \u2014 text|number|date|bool|select. Repeatable.",(d,h)=>[...h??[],d],[]).option("--name <displayName>","Human label for the table (defaults to the slug).").option("--restrict-to-owner","Non-admins see only rows they created.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let w=h.field.map($=>{let[A,C,N]=$.split(":");return(!A||!C)&&v(`--field "${$}" must be name:type[:required] (e.g. title:text:required).`),N!==void 0&&N!=="required"&&v(`--field "${$}": the third part may only be "required".`),{name:A,type:C,...N==="required"?{required:!0}:{}}}),{baseUrl:T,token:_}=await B(h.baseUrl),f=new z({baseUrl:T,token:_}),S;try{S=await X(`creating cr_${d}`,()=>f.tablesApply({tables:[{slug:d,displayName:h.name??d,fields:w,...h.restrictToOwner?{rowLevelOwner:!0}:{}}]}))}catch($){V($,"extensions:deploy","create a table"),Ao($)}for(let $ of S.tables)Po($);y(""),y(m.dim("grant access under Settings \u203A Users, or in the Records page permissions matrix."))}),bn.command("drop").description("Drop a table and everything in it. Irreversible.").argument("<slug>","Table slug (without the cr_ prefix).").requiredOption("--confirm <slug>","Type the EXACT slug to confirm (fail-closed).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{h.confirm!==d&&v(`drop refused: --confirm "${h.confirm}" does not match "${d}".`);let{baseUrl:w,token:T}=await B(h.baseUrl),_=new z({baseUrl:w,token:T}),f;try{f=await X(`dropping cr_${d}`,()=>_.tablesDrop(d,h.confirm))}catch(S){V(S,"extensions:deploy","drop a table"),v(`drop failed: ${S instanceof Error?S.message:String(S)}`)}if(!f.removed)return y(`no table named "${d}" on this instance \u2014 nothing dropped.`);y(`dropped ${f.table} and every row in it.`)});let zi=e.command("sandbox").description("Ephemeral local authoring sandboxes.");zi.command("create").description("Stand up a fresh local sandbox seeded with a sampled+redacted slice of an instance.").requiredOption("--from <instance>","Source instance to clone the data slice from.").option("--ttl <duration>","Time-to-live before reaping (e.g. 72h, 30m, 7d).","72h").option("--sample <pct>","Percent of each table to copy (e.g. 2%).","2%").option("--base-url <url>","Local base URL the sandbox is reachable at.").action(async d=>{process.env.TURBOBASE_SANDBOX="1";let h=Jd(),w;try{w=await Jh(h,{fromTenant:d.from,ttl:d.ttl,sample:d.sample,baseUrl:d.baseUrl})}catch(T){T instanceof Nn&&v(T.message),v(`sandbox create failed: ${T instanceof Error?T.message:String(T)}`)}y(`sandbox ${w.name} ready.`),y(` source: ${w.fromTenant} (sampled ${Math.round(w.sampleFraction*100)}%, redacted)`),y(` url: ${w.url}`),y(` expires: ${w.expiresAt}`)}),zi.command("destroy").argument("<name>","The sandbox name to tear down.").description("Drop a sandbox database and remove it from the registry.").action(async d=>{let h=Jd();await Ya(h).catch(()=>[]);let w;try{w=await Yh(h,d)}catch(T){v(`sandbox destroy failed: ${T instanceof Error?T.message:String(T)}`)}w||v(`no sandbox named '${d}'.`),y(`destroyed sandbox ${w.name} (dropped ${w.database}).`)}),zi.command("list").description("List active sandboxes with TTL/expiry; reaps any past their TTL.").action(async()=>{let d=Jd(),h=await Ya(d).catch(()=>[]),w=await ms(),{active:T}=Ja(w);if(T.length===0)y("no active sandboxes.");else{for(let _ of T)y(` ${_.name} from=${_.fromTenant} expires=${_.expiresAt} ${_.url}`);y(`
4257
4257
  ${T.length} active sandbox(es).`)}h.length>0&&y(`(reaped ${h.length} expired sandbox(es).)`)}),o.command("export").description("Pull the live instance into turbobase/bundle.json (adopt an instance into a repo).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--out <dir>","Directory to write the bundle into.",ns).action(async d=>{let{baseUrl:h,token:w}=await B(d.baseUrl),T=new z({baseUrl:h,token:w}),_;try{_=await X("exporting instance config",()=>T.configExport())}catch($){$ instanceof Y&&($.status===401||$.status===403)&&v("ext export forbidden \u2014 the stored PAT lacks extensions:deploy. Re-run `turbobase auth login`."),v(`ext export failed: ${$ instanceof Error?$.message:String($)}`)}let f=typeof _.serialized=="string"?_.serialized:`${JSON.stringify(_.manifest??_,null,2)}
4258
4258
  `,S=oe(process.cwd(),d.out,Pn);await ie.mkdir(Ht(S),{recursive:!0}),await ie.writeFile(S,f,"utf8"),y(`wrote ${d.out}/${Pn} (${f.split(`
4259
- `).length} lines).`)});let tu=o.command("extras").description("Manage the optional native packages `ext test` and `ext replay` need."),ow=[{name:"esbuild",needs:"compiling an extension (`test`, `replay`)"},{name:"isolated-vm",needs:"executing an extension in the sandbox (`test`, `replay`)"}],ru=()=>process.env.TURBOBASE_HOME?.trim()||tt(ZA(),".turbobase"),sw=()=>"1.45.0",Co=async()=>Promise.all(ow.map(async d=>{try{return await import(d.name),{...d,present:!0}}catch{return{...d,present:!1}}}));tu.command("status").description("Report which optional native packages are installed.").action(async()=>{let d=await Co();for(let h of d)y(`${h.present?ve.success("installed"):ve.warn("missing")} ${m.bold(h.name)} \u2014 ${h.needs}`);d.some(h=>!h.present)&&y(`
4259
+ `).length} lines).`)});let tu=o.command("extras").description("Manage the optional native packages `ext test` and `ext replay` need."),ow=[{name:"esbuild",needs:"compiling an extension (`test`, `replay`)"},{name:"isolated-vm",needs:"executing an extension in the sandbox (`test`, `replay`)"}],ru=()=>process.env.TURBOBASE_HOME?.trim()||tt(ZA(),".turbobase"),sw=()=>"1.45.1",Co=async()=>Promise.all(ow.map(async d=>{try{return await import(d.name),{...d,present:!0}}catch{return{...d,present:!1}}}));tu.command("status").description("Report which optional native packages are installed.").action(async()=>{let d=await Co();for(let h of d)y(`${h.present?ve.success("installed"):ve.warn("missing")} ${m.bold(h.name)} \u2014 ${h.needs}`);d.some(h=>!h.present)&&y(`
4260
4260
  run \`${qr} ext extras install\` to fetch them into ${ru()}.`)}),tu.command("install").description("Install the optional native packages into $TURBOBASE_HOME (needs npm).").action(async()=>{let d=await Co();if(d.every(A=>A.present)){y(ve.success("extras already installed \u2014 nothing to do."));return}let h=ru();await ie.mkdir(h,{recursive:!0});let w=d.filter(A=>!A.present).map(A=>A.name),T=Fa(process.platform,process.arch),_=async(A,C)=>{let{code:N,stderr:M}=await $o("npm",["install","--prefix",h,"--no-audit","--no-fund",...A]);N!==0&&v(`extras install failed while installing ${C} (npm exited ${N}).
4261
4261
  ${M.trim()}
4262
4262
  These are native packages \u2014 they need npm and a working toolchain. Everything except \`test\` and \`replay\` works without them.`)},f=w.filter(A=>A!=="isolated-vm");if(f.length>0){let A=f.map(C=>`${C}@${za[C]??"latest"}`);y(`installing ${A.join(", ")} \u2192 ${h}/node_modules \u2026`),await _(A,f.join(", "))}if(w.includes("isolated-vm")){let A=`isolated-vm@${za["isolated-vm"]}`;if(y(`installing ${A} \u2192 ${h}/node_modules \u2026`),await _(["--ignore-scripts",A],"isolated-vm"),Bh.includes(T)){let N=`${Ba}@${sw()}`;y(`fetching ${N} (no upstream binary for ${T}) \u2026`);let{code:M}=await $o("npm",["install","--prefix",h,"--no-audit","--no-fund","--ignore-scripts",N]);M!==0&&y(ve.warn(`could not fetch ${N} \u2014 falling back to a source build.`))}let C=await Fh({home:h});C.length>0&&y(` ${ve.success("prebuilt")} ${C.join(", ")} \u2192 isolated-vm/prebuilds/${T}`)}let S=await Co(),$=S.filter(A=>!A.present).map(A=>A.name);if($.includes("isolated-vm")){y(ve.warn(`no prebuilt isolated-vm for ${T} / Node ${process.versions.node} (${Ha()}) \u2014 building from source. This needs Python and a C++ toolchain, and takes a few minutes.`));let{code:A}=await $o("npm",["rebuild","--prefix",h,"isolated-vm"]);A===0&&(S=await Co(),$=S.filter(C=>!C.present).map(C=>C.name))}$.length>0&&v(`npm succeeded but ${$.join(", ")} still will not load \u2014 no prebuilt binary for ${T} / Node ${process.versions.node} (${Ha()}), and the source build did not produce one either. Everything except \`test\` and \`replay\` works without them.`),y(ve.success("extras installed \u2014 `turbobase ext test` and `turbobase ext replay` are ready."))});let Ir=e.command("release").description("Ship a release to your instance: deploy | status | rollback | list.");Ir.command("deploy").description("Enqueue a server-side release deploy. UPLOADS the SDF project src/ from the checkout (the producer swap) when present; else a solution-only live-fetch deploy. An approved target requires --approved-by.").requiredOption("--target <mode>","Deploy posture: auto (apply now) | approved (needs a recorded approval).").option("--solution <id>","The solution id the release delivers (omit for an upload-only deploy).").option("--project <dir>","SDF project dir whose src/ is uploaded (default: cwd).").option("--git-repo <repo>","Git provenance LINK: source repo (default $GITHUB_REPOSITORY or `git remote get-url origin`).").option("--git-ref <ref>","Git provenance LINK: ref/branch/tag (default $GITHUB_REF).").option("--ref <committish>","Git provenance: the ref/branch/tag/sha the upload was built from; resolved to a commit sha via `git rev-parse` (default $GITHUB_SHA or HEAD).").option("--pr-url <url>","Git provenance LINK: the PR this deploy came from (default $PR_URL).").option("--approved-by <email>","Record the approval (REQUIRED for --target approved).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--follow","Poll the release deploy to completion (exit non-zero on failure).").option("--interval-ms <ms>","Poll interval for --follow (default 2000).").action(async d=>{let h=d.target==="approved"?"approved":d.target==="auto"?"auto":null;h||v(`--target must be 'auto' or 'approved' (got '${d.target}').`);let w=await hC(oe(process.cwd(),d.project??".")),T=Object.keys(w).length;!d.solution&&T===0&&v("release deploy needs --solution <id> (live-fetch) or an SDF project (a src/ dir under --project, default cwd) to upload.");let f=(d.ref?await Yd(["rev-parse",d.ref])??d.ref:null)??process.env.GITHUB_SHA??await Yd(["rev-parse","HEAD"]),S=d.gitRepo??process.env.GITHUB_REPOSITORY??await Yd(["remote","get-url","origin"]),$=d.gitRef??process.env.GITHUB_REF??null,A=d.prUrl??process.env.PR_URL??null,{baseUrl:C,token:N}=await B(d.baseUrl),M=new z({baseUrl:C,token:N}),L;try{L=await M.releaseDeploy({solutionId:d.solution??null,target:h,approvedBy:d.approvedBy??null,files:T>0?w:null,gitRepo:S,gitRef:$,gitSha:f,prUrl:A})}catch(J){V(J,"releases:write","release deploy"),J instanceof Y&&J.status===404&&v("solution_not_found \u2014 no solution with that id."),v(`release deploy failed: ${J instanceof Error?J.message:String(J)}`)}y(`release ${L.releaseId} enqueued \u2192 taskId=${L.taskId} (target=${h}`+(T>0?`, uploaded ${T} bundle file(s)`:", live-fetch")+")."),d.follow&&await Aa(()=>M.releaseStatus(L.releaseId),`release ${L.releaseId}`,d.intervalMs)}),Ir.command("pull").argument("<id>","The release id").description("Write the SDF project a FAILED release built into <dir>: owned/ (yours, editable) and context/ (the rest of the bundle, read-only). Edit owned/, then `release push`.").requiredOption("--dir <path>","Directory to write the project into (created if absent).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:w,token:T}=await B(h.baseUrl),_=new z({baseUrl:w,token:T}),f;try{f=await _.releaseFiles(d)}catch(A){A instanceof Y&&A.status===404&&v(`release ${d} not found.`),A instanceof Y&&A.status===409&&v(`no built project was retained for release ${d}. Files are kept for a FAILED attempt only \u2014 a shipped bundle is recoverable from the account.`),V(A,"releases:write","pull a release"),v(`release pull failed: ${A instanceof Error?A.message:String(A)}`)}let S=oe(process.cwd(),h.dir),$=0;for(let[A,C]of[["owned",f.owned],["context",f.context]])for(let[N,M]of Object.entries(C)){let L=tt(S,A,N);await ie.mkdir(Ht(L),{recursive:!0}),await ie.writeFile(L,M,"utf8"),$++}await ie.writeFile(tt(S,".turbobase-release.json"),JSON.stringify({releaseId:f.releaseId,version:f.version,contentDigest:f.contentDigest},null,2),"utf8"),y(`pulled release ${f.releaseId} (${f.status}) \u2192 ${S}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@turbobase/cli",
3
- "version": "1.45.0",
3
+ "version": "1.45.1",
4
4
  "description": "Author, test, and deploy Turbobase extensions (hooks + conduits) against a tenant over HTTP + a personal access token.",
5
5
  "type": "module",
6
6
  "license": "SEE LICENSE IN LICENSE",