dockito 0.0.1-beta.3 → 0.0.1-beta.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -1
- package/dockito.js +85 -48
- package/package.json +13 -3
package/README.md
CHANGED
|
@@ -13,11 +13,12 @@ npx dockito@beta publish plan.md -m "Sent to the client"
|
|
|
13
13
|
| `login` | Sign in through the browser and choose what this login may do in each workspace |
|
|
14
14
|
| `sync <folder> --to <project>` | Mirror a folder into a project: subfolders become folders, only changed files are sent, a plan first |
|
|
15
15
|
| `publish <file...>` | Publish a file; one with the same name in that place updates its doc |
|
|
16
|
+
| `share <doc>` | Who can open it. Docs are private; `publish --public` makes a new doc public, `share --private` takes it back |
|
|
16
17
|
| `tree`, `mkdir` | Every workspace, project and folder you can use; make new ones |
|
|
17
18
|
| `ls`, `open`, `get` | List, open and download docs |
|
|
18
19
|
| `history`, `restore`, `save` | A doc's History |
|
|
19
20
|
| `whoami`, `logout` | Your login and workspaces |
|
|
20
21
|
|
|
21
|
-
The CLI keeps nothing but your login: where docs go is passed with `--to` each time. Run `dockito --help` for everything, and `dockito agent` for what an AI agent needs to know. `--json` gives machine-readable output for agents, and `DOCKITO_TOKEN` uses a token from Account → Tokens instead of a login.
|
|
22
|
+
The CLI keeps nothing but your login: where docs go is passed with `--to` each time. Run `dockito --help` for everything, `dockito <command> --help` for one command, and `dockito agent` for what an AI agent needs to know. `--json` gives machine-readable output for agents, and `DOCKITO_TOKEN` uses a token from Account → Tokens instead of a login.
|
|
22
23
|
|
|
23
24
|
This is a beta: commands may still change.
|
package/dockito.js
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{spawn as
|
|
3
|
-
`)
|
|
4
|
-
`),
|
|
5
|
-
`)};
|
|
6
|
-
\x1B[?25l`),
|
|
7
|
-
`),s(new
|
|
8
|
-
`),o(r)):void 0;
|
|
9
|
-
`);return!!t&&t.status===0&&!/error/i.test(t.stderr??"")}if(process.platform==="linux"){let t=
|
|
10
|
-
`),{choices:o})}async function
|
|
11
|
-
To make it, run again with --create.`,{workspace:
|
|
12
|
-
Ask the user, then run again with --fold.`,{files:
|
|
13
|
-
${
|
|
14
|
-
`)}`);let
|
|
15
|
-
${
|
|
16
|
-
`)}`);let
|
|
17
|
-
Nothing changed yet. Show the user this plan, then run: ${i}`,{next:i})}if(!await
|
|
18
|
-
${
|
|
2
|
+
import{spawn as qt,spawnSync as lt}from"node:child_process";import{createHash as zt}from"node:crypto";import{existsSync as Vt,readFileSync as dt,statSync as Yt,writeFileSync as Xt}from"node:fs";import{hostname as Qt}from"node:os";import{basename as Le,dirname as Zt,resolve as en}from"node:path";import{parseArgs as tn}from"node:util";var x=class extends Error{constructor(t,o,s={}){super(t);this.code=t;this.status=o;this.detail=s}code;status;detail};function pe(e){let n=e.url.replace(/\/+$/,"");async function t(r,a,c={}){let f=new URL(`${n}/api${a}`);for(let[j,b]of Object.entries(c.query??{}))b!=null&&b!==""&&f.searchParams.set(j,String(b));let w={},g=c.token===void 0?e.token:c.token;g&&(w.authorization=`Bearer ${g}`),e.userAgent&&(w["user-agent"]=e.userAgent);let u;c.json!==void 0?(w["content-type"]="application/json",u=JSON.stringify(c.json)):c.body&&(w["content-type"]="application/octet-stream",u=c.body);let k;try{k=await fetch(f,{method:r,headers:w,body:u})}catch{throw new x("offline",0)}return k}async function o(r){let a=await r.json().catch(()=>({}));if(!r.ok){let{error:c,...f}=a;throw new x(typeof c=="string"?c:`http_${r.status}`,r.status,f)}return a}let s=encodeURIComponent;return{url:n,linkOf:r=>`${n}/${r}`,startLogin:async(r,a)=>o(await t("POST","/device/code",{json:{client:r,device:a}})),pollLogin:async r=>{let a=await t("POST","/device/token",{json:{device_code:r},token:null}),c=await a.json().catch(()=>({}));if(a.ok)return c;if(c.error==="authorization_pending"||c.error==="slow_down")return null;throw new x(c.error??`http_${a.status}`,a.status)},logout:async()=>o(await t("DELETE","/tokens/current")),whoami:async()=>o(await t("GET","/whoami")),tree:async()=>o(await t("GET","/tree")),projects:async r=>(await o(await t("GET",`/workspaces/${s(r)}/projects`))).projects,docs:async(r,a={})=>(await o(await t("GET",`/workspaces/${s(r)}/docs`,{query:a}))).docs,files:async(r,a)=>(await o(await t("GET",`/workspaces/${s(r)}/files`,{query:{project:a}}))).docs,createProject:async(r,a)=>o(await t("POST",`/workspaces/${s(r)}/projects`,{json:{name:a}})),createFolder:async(r,a,c)=>o(await t("POST",`/projects/${s(r)}/folders`,{json:{name:a,parentId:c}})),recent:async r=>(await o(await t("GET",`/workspaces/${s(r)}/docs/recent`))).docs,doc:async r=>o(await t("GET",`/docs/by-code/${s(r)}`)),content:async(r,a)=>{let c=await t("GET",`/docs/${s(r)}/content`,{query:{v:a}});return c.ok||await o(c),{bytes:new Uint8Array(await c.arrayBuffer()),entry:Number(c.headers.get("x-doc-version"))}},create:async(r,a,c,f={})=>o(await t("POST",`/workspaces/${s(r)}/docs`,{query:{name:a,project:f.project,folder:f.folder,public:f.public?1:null,source:e.source},body:c})),update:async(r,a,c,f={})=>o(await t("POST",`/docs/${s(r)}/versions`,{query:{name:a,note:f.note,commit:f.commit,base:f.base,source:e.source},body:c})),restore:async(r,a,c)=>o(await t("POST",`/docs/${s(r)}/history/${a}/restore`,{query:{base:c}})),save:async(r,a,c)=>o(await t("PUT",`/docs/${s(r)}/history/${a}/saved`,{json:{note:c}})),makePrivate:async r=>o(await t("PATCH",`/docs/${s(r)}`,{json:{public:!1}})),rename:async(r,a)=>o(await t("PATCH",`/docs/${s(r)}`,{json:{title:a}}))}}import{emitKeypressEvents as $t}from"node:readline";import{createInterface as jt}from"node:readline/promises";var bt=!process.env.NO_COLOR&&process.stdout.isTTY,B=e=>n=>bt?`\x1B[${e}m${n}\x1B[0m`:n,p=B("2"),T=B("1"),y=B("32"),_=B("31"),I=B("33"),Se=B("36"),d=(e="")=>process.stdout.write(e+`
|
|
3
|
+
`),$=(e="")=>process.stderr.write(e+`
|
|
4
|
+
`),W=class extends Error{},m=e=>{throw new W(e)},H={view:"View",publish:"Publish",everything:"Everything"};function fe(e){let n=Math.round((Date.now()-new Date(e).getTime())/1e3);if(n<60)return"just now";let t=Math.round(n/60);if(t<60)return`${t} min ago`;let o=Math.round(t/60);if(o<24)return`${o} h ago`;let s=Math.round(o/24);return s<30?s===1?"yesterday":`${s} days ago`:new Date(e).toLocaleDateString(void 0,{day:"numeric",month:"short",year:"numeric"})}function Z(e){let n=o=>o.replace(/\x1b\[[0-9;]*m/g,""),t=e[0]?.map((o,s)=>Math.max(...e.map(r=>n(r[s]??"").length)))??[];for(let o of e)d(o.map((s,r)=>r===o.length-1?s:s+" ".repeat(t[r]-n(s).length)).join(" ").trimEnd())}function ee(e,n){switch(e.code){case"offline":return`Couldn't reach Dockito at ${n}.`;case"invalid_token":return"Your login has ended or was signed out. Run `dockito login`.";case"token_level":return`This needs ${H[e.detail.needs]??e.detail.needs} access; this login has ${H[e.detail.has]??e.detail.has}. Run \`dockito login --update\`.`;case"not_for_tokens":return"That can only be done in the browser.";case"not_found":return"Not found, or this login has no access to it. `dockito whoami` lists what it can reach.";case"deleted":return"That doc was deleted.";case"conflict":return"Someone published a newer version since yours. Get it with `dockito get`, or publish anyway with --force.";case"rate_limited":return"Too many requests. Try again in a minute.";case"too_large":return`The file is too large (limit ${Math.round(Number(e.detail.limit??0)/1048576)} MB).`;case"out_of_space":return"The workspace is out of storage.";case"unsupported":return"Dockito takes .md and .html files.";case"other_kind":return"That doc is a different kind of file (Markdown and HTML can't replace each other).";case"empty":return"The file is empty.";case"not_text":return"The file isn't text.";case"too_deep":return"Folders go at most 2 deep inside a project.";case"invalid_name":return"Names need 1 to 80 characters.";case"folder_gone":return"That project or folder no longer exists.";default:return`Dockito said: ${e.code}`}}var Pe=()=>!!process.stdin.isTTY&&!!process.stdout.isTTY&&!process.env.CI,J=e=>process.stdout.write(e);function Xe(e,n,t=0){return new Promise((o,s)=>{let r=t,a=w=>{w||J(`\x1B[${n.length}A`);for(let[g,u]of n.entries())J(`\x1B[2K${g===r?Se("\u276F "+u.label):" "+u.label}${u.hint?p(" "+u.hint):""}
|
|
5
|
+
`)};J(`${y("?")} ${T(e)} ${p("(\u2191\u2193, Enter)")}
|
|
6
|
+
\x1B[?25l`),a(!0),$t(process.stdin),process.stdin.setRawMode(!0),process.stdin.resume();let c=()=>{process.stdin.off("keypress",f),process.stdin.setRawMode(!1),process.stdin.pause(),J("\x1B[?25h")},f=(w,g)=>{if(g.ctrl&&g.name==="c")return c(),J(`
|
|
7
|
+
`),s(new te);if(g.name==="up"||g.name==="k")r=(r-1+n.length)%n.length;else if(g.name==="down"||g.name==="j")r=(r+1)%n.length;else return g.name==="return"?(c(),J(`\x1B[${n.length+1}A\x1B[0J${y("?")} ${T(e)} ${Se(n[r].label)}
|
|
8
|
+
`),o(r)):void 0;a(!1)};process.stdin.on("keypress",f)})}async function ge(e,n=""){let t=jt({input:process.stdin,output:process.stdout});try{return(await t.question(`${y("?")} ${T(e)}${n?p(` (${n})`):""} `)).trim()||n}finally{t.close()}}async function Ae(e,n=!0){let t=(await ge(`${e} ${p(n?"[Y/n]":"[y/N]")}`)).toLowerCase();return t?t.startsWith("y"):n}var te=class extends Error{};import{homedir as vt}from"node:os";import{join as Ne}from"node:path";var xt="https://dockito-app.dockito.workers.dev";function Qe(){return process.env.DOCKITO_CONFIG_DIR?process.env.DOCKITO_CONFIG_DIR:process.platform==="win32"&&process.env.APPDATA?Ne(process.env.APPDATA,"dockito"):Ne(process.env.XDG_CONFIG_HOME||Ne(vt(),".config"),"dockito")}var Ze=()=>(process.env.DOCKITO_URL||xt).replace(/\/+$/,""),et=e=>new URL(e).host;import{spawnSync as Tt}from"node:child_process";import{chmodSync as Ot,existsSync as _e,mkdirSync as Dt,readFileSync as St,rmSync as tt,writeFileSync as Pt}from"node:fs";import{dirname as At,join as Nt}from"node:path";var G="dockito";function q(e,n,t){try{let o=Tt(e,n,{input:t,encoding:"utf8",stdio:["pipe","pipe","pipe"]});return o.error?null:o}catch{return null}}var ne=e=>Nt(Qe(),"tokens",`${e.replace(/[^a-z0-9.-]/gi,"_")}`);function _t(e,n){if(process.platform==="darwin"){let t=q("security",["-i"],`add-generic-password -U -s ${G} -a ${e} -l Dockito -w ${n}
|
|
9
|
+
`);return!!t&&t.status===0&&!/error/i.test(t.stderr??"")}if(process.platform==="linux"){let t=q("secret-tool",["store","--label=Dockito","service",G,"account",e],n);return!!t&&t.status===0}return!1}function It(e){let n=process.platform==="darwin"?q("security",["find-generic-password","-s",G,"-a",e,"-w"]):process.platform==="linux"?q("secret-tool",["lookup","service",G,"account",e]):null;return(n?.status===0?n.stdout.trim():"")||null}function Et(e){process.platform==="darwin"?q("security",["delete-generic-password","-s",G,"-a",e]):process.platform==="linux"&&q("secret-tool",["clear","service",G,"account",e])}function nt(e,n){if(_t(e,n))return _e(ne(e))&&tt(ne(e)),"keychain";let t=ne(e);return Dt(At(t),{recursive:!0,mode:448}),Pt(t,n,{mode:384}),Ot(t,384),"file"}function he(e){if(process.env.DOCKITO_TOKEN)return process.env.DOCKITO_TOKEN.trim();let n=It(e);if(n)return n;let t=ne(e);return _e(t)&&St(t,"utf8").trim()||null}function ot(e){Et(e);let n=ne(e);_e(n)&&tt(n)}var D=class extends Error{constructor(t,o,s={}){super(o);this.code=t;this.data=s}code;data},L=e=>e.level===null||e.level==="publish"||e.level==="everything";function me(e,n){let t=e.workspaces;if(n)return t.find(s=>s.slug===n)??m(`This login can't reach workspace "${n}". \`dockito tree\` lists the ones it can.`);let o=t.length===1?t[0]:t.find(s=>s.kind==="personal"&&s.role==="owner");if(o)return o;throw new D("needs_workspace",`Pick a workspace with -w: ${t.map(s=>s.slug).join(", ")}`,{workspaces:t.map(s=>s.slug)})}var z=(e,n)=>e.projects.find(t=>t.slug===n)??e.projects.find(t=>t.name.toLowerCase()===n.toLowerCase())??null;function oe(e){let n=new Map((e?.folders??[]).map(s=>[s.id,s])),t=s=>{let r=n.get(s);return[...r.parentId?t(r.parentId):[],r.name]},o=new Map((e?.folders??[]).map(s=>[t(s.id).join("/").toLowerCase(),s.id]));return{idOf:s=>s.length?o.get(s.join("/").toLowerCase()):null,pathOf:s=>s&&n.has(s)?t(s):[],add:(s,r)=>{o.set(s.join("/").toLowerCase(),r)}}}function Ie(e,n){if(!n)return{project:null,folder:null,label:`${e.slug} Docs`};let[t,...o]=n.split("/").filter(Boolean),s=z(e,t);if(!s)return m(`No project "${t}" in ${e.slug}. \`dockito tree\` lists them; \`dockito mkdir ${n}\` makes it.`);let r=oe(s).idOf(o);return r===void 0?m(`No folder "${o.join("/")}" in ${s.slug}. \`dockito mkdir ${s.slug}/${o.join("/")}\` makes it.`):{project:s.id,folder:r,label:[e.slug,s.slug,...o].join("/")}}var Ct=e=>e.fileName??`${e.title}.${e.kind}`,we=(e,n,t)=>e.filter(o=>(o.folderId??null)===n&&Ct(o).toLowerCase()===t.toLowerCase());import{createHash as Lt}from"node:crypto";import{spawnSync as Mt}from"node:child_process";import{existsSync as re,readFileSync as Ft,readdirSync as Rt,statSync as it}from"node:fs";import{basename as st,join as E,relative as Kt,resolve as Ee,sep as Ut}from"node:path";var ke=2,Wt=4,se=e=>e<1024*1024?`${e?Math.max(1,Math.round(e/1024)):0} KB`:`${(e/1048576).toFixed(1)} MB`,Ht=e=>Lt("sha256").update(e).digest("hex"),at=e=>e.split(Ut).join("/"),V=(e,n)=>`${e} ${n}${e===1?"":"s"}`,Bt=(e,n)=>{let t=/\.[^./]+$/.exec(n.toLowerCase())?.[0]??"";return e.find(o=>o.extensions.includes(t))?.id??null};function ye(e,n){let t=Mt("git",e,{cwd:n,encoding:"utf8",maxBuffer:67108864});return t.error||t.status!==0?null:t.stdout}function Jt(e,n){let t=ye(["ls-files","-z","--cached","--others","--exclude-standard","--","."],e);return(t!==null?t.split("\0").filter(Boolean):(function s(r){return Rt(E(e,r),{withFileTypes:!0}).flatMap(a=>a.name.startsWith(".")||a.name==="node_modules"?[]:a.isDirectory()?s(E(r,a.name)):[at(E(r,a.name))])})("")).filter(s=>n(s)&&re(E(e,s))&&it(E(e,s)).isFile()).sort()}function Gt(e,n,t){let o=[...e.matchAll(/\b(?:src|href)=["']([^"'#?]+)/gi)].map(s=>s[1]);return[...new Set(o.filter(s=>!/^([a-z]+:|\/\/|\/)/i.test(s)&&!t(s)&&re(E(n,s))))]}function rt(e,n){let t=(r,a,c="")=>`dockito sync ${n} -w ${r} --to ${a}${c}`,o=e.workspaces.filter(L).flatMap(r=>[...r.projects.map(a=>({workspace:r.slug,project:a.slug,name:a.name,docs:a.docs,command:t(r.slug,a.slug)})),{workspace:r.slug,project:null,name:"a new project",docs:0,command:t(r.slug,"<name>"," --create")}]),s=Math.max(...o.map(r=>r.command.length));throw new D("needs_place",[`Which project should ${n==="."?"this folder":n+"/"} go to? Ask the user, then run one of:`,...o.map(r=>` ${r.command.padEnd(s)} ${p(r.project?`${r.name} \xB7 ${V(r.docs,"doc")}`:r.name)}`),p("Subfolders become folders. `dockito tree` shows every place.")].join(`
|
|
10
|
+
`),{choices:o})}async function ct(e,n,t){let o=Pe()&&!t.json,s=await e.tree(),r=i=>!!Bt(s.kinds,i);s.workspaces.some(L)||m("This login can't publish anywhere. Run `dockito login --update`.");let a=n;a||(o||rt(s,re("docs")?"docs":"."),a=await ge("Folder to sync",re("docs")?"docs":"."));let c=Ee(a);(!re(c)||!it(c).isDirectory())&&m(`${a} isn't a folder.`);let f=at(Kt(process.cwd(),c))||".",w;t.workspace&&(w=s.workspaces.find(i=>i.slug===t.workspace)??m(`This login can't reach workspace "${t.workspace}".`));let g=t.to;if(!g){o||rt(s,f);let i=(w?[w]:s.workspaces.filter(L)).flatMap(h=>[...h.projects.map(v=>({w:h,p:v.slug,label:v.name,hint:`${h.slug} \xB7 ${V(v.docs,"doc")}`})),{w:h,p:null,label:"New project",hint:h.slug}]),l=i[await Xe("Project",i)];w=l.w,g=l.p??await ge("Project name",st(c===process.cwd()?c:Ee(c,".."))),t.create||=!l.p}if(!w){let i=s.workspaces.filter(h=>L(h)&&z(h,g.split("/")[0])),l=s.workspaces.find(h=>h.kind==="personal"&&h.role==="owner");if(w=i.length===1?i[0]:s.workspaces.length===1?s.workspaces[0]:!i.length&&l?l:void 0,!w)throw new D("needs_workspace",`Which workspace? Run again with -w: ${(i.length?i:s.workspaces).map(h=>h.slug).join(", ")}`)}let u=w;L(u)||m(`This login has View access in ${u.slug}; syncing needs Publish. Run \`dockito login --update\`.`);let[k,...j]=g.split("/").filter(Boolean);k||m("--to takes a project, or project/folder."),j.length>ke&&m(`Folders go at most ${ke} deep inside a project.`);let b=z(u,k);if(!b&&!t.create)throw new D("no_project",`No project "${k}" in ${u.slug}. Projects: ${u.projects.map(i=>i.slug).join(", ")||"none"}.
|
|
11
|
+
To make it, run again with --create.`,{workspace:u.slug,projects:u.projects.map(i=>i.slug)});let R=Jt(c,r);R.length||m(`No ${s.kinds.flatMap(i=>i.extensions).join(", ")} files in ${f}.`);let ae=ke-j.length,Y=R.filter(i=>i.split("/").length-1>ae);if(Y.length&&!t.fold){let i=h=>h.split("/").slice(0,ae).join("/")||"the project's top",l=`${V(Y.length,"file")} ${Y.length===1?"is":"are"} more than ${ke} folders deep inside the project. With --fold they go in ${[...new Set(Y.map(i))].join(", ")}; where two would share a name, the folders left out go in front (plans/archive/grok/README.md \u2192 grok-README.md).`;if(!o)throw new D("too_deep",`${l}
|
|
12
|
+
Ask the user, then run again with --fold.`,{files:Y});if($(l),!await Ae("Fold them like that?"))return $(p("Nothing changed."));t.fold=!0}let Re=i=>{let l=i.split("/");return{folder:[...j,...l.slice(0,-1).slice(0,ae)],dropped:l.slice(0,-1).slice(ae),file:l[l.length-1]}},$e=new Map;for(let i of R){let l=Re(i),h=[...l.folder,l.file].join("/").toLowerCase();$e.set(h,($e.get(h)??0)+1)}let Ke=b?await e.files(u.id,b.id):[],X=oe(b),M=R.map(i=>{let{folder:l,dropped:h,file:v}=Re(i),C=h.length&&$e.get([...l,v].join("/").toLowerCase())>1?[...h,v].join("-"):v,P=new Uint8Array(Ft(E(c,i))),U={rel:i,name:C,folder:l,bytes:P,hash:Ht(P),action:"new",doc:null,others:[],assets:[]};/\.html?$/i.test(i)&&(U.assets=Gt(new TextDecoder().decode(P),E(c,i,".."),r));let Ye=X.idOf(l);if(Ye===void 0)return U;let Q=we(Ke,Ye,C);return Q.length>1?{...U,action:"ambiguous",others:Q}:Q.length?{...U,doc:Q[0],action:Q[0].sha256===U.hash?"same":"update"}:U}),Ue=M.filter(i=>i.bytes.length>u.maxFile);Ue.length&&m(`Over the ${se(u.maxFile)} limit per file in ${u.slug}:
|
|
13
|
+
${Ue.map(i=>` ${i.rel} ${se(i.bytes.length)}`).join(`
|
|
14
|
+
`)}`);let je=new Map;for(let i of M){let l=[...i.folder,i.name].join("/").toLowerCase();je.set(l,[...je.get(l)??[],i.rel])}let We=[...je.values()].filter(i=>i.length>1);We.length&&m(`These files would be the same doc; rename one of each:
|
|
15
|
+
${We.map(i=>" "+i.join(" and ")).join(`
|
|
16
|
+
`)}`);let N=[],He=new Set;for(let i of M)for(let l=1;l<=i.folder.length;l++){let h=i.folder.slice(0,l),v=h.join("/").toLowerCase();X.idOf(h)===void 0&&!He.has(v)&&(He.add(v),N.push(h))}N.sort((i,l)=>i.length-l.length);let O=M.filter(i=>i.action==="new"||i.action==="update"),Be=M.filter(i=>i.action==="ambiguous"),ve=M.filter(i=>i.action==="same").length,mt=new Set(M.flatMap(i=>i.doc?[i.doc.id]:i.others.map(l=>l.id))),xe=Ke.filter(i=>!mt.has(i.id)).length,Je=`${u.slug}/${b?.slug??k}${j.length?"/"+j.join("/"):""}`,ce={workspace:u.slug,to:Je,create:{project:b?null:k,folders:N.map(i=>i.join("/"))},docs:O.map(i=>({file:i.rel,action:i.action,folder:i.folder.join("/")||null,name:i.name,link:i.doc?e.linkOf(i.doc.slug):null})),unchanged:ve,ambiguous:Be.map(i=>({file:i.rel,docs:i.others.map(l=>e.linkOf(l.slug))})),notHere:xe};if(!t.json){d(`${T(f==="."?"./":f+"/")} \u2192 ${T(Je)}`),b||d(` ${y("+ project")} ${k}`);for(let l of N)d(` ${y("+ folder ")} ${l.join("/")}`);if(O.length>15)for(let[l,h]of[["new",y("+ new ")],["update",I("~ update ")]]){let v=new Map;for(let C of O.filter(P=>P.action===l))v.set(C.folder.join("/"),[...v.get(C.folder.join("/"))??[],C.name]);for(let[C,P]of v)d(` ${h} ${P.length} in ${C||"the project's top"}: ${p(P.slice(0,4).join(", ")+(P.length>4?`, ${P.length-4} more`:""))}`)}else for(let l of O){let h=l.name!==st(l.rel)?p(` \u2192 ${[...l.folder,l.name].join("/")}`):"";d(` ${l.action==="new"?y("+ new "):I("~ update ")} ${l.rel}${h}`)}ve&&d(p(` ${ve} unchanged`));for(let l of Be)d(` ${_("? skip ")} ${l.rel} ${p(`${l.others.length} docs there have this name: ${l.others.map(h=>e.linkOf(h.slug)).join(", ")}`)}`);xe&&d(p(` ${V(xe,"doc")} in the project with no file here, left as they are`)),O.length&&d(p(` ${V(O.length,"file")} to send, ${se(O.reduce((l,h)=>l+h.bytes.length,0))}`));let i=O.filter(l=>l.assets.length);i.length&&d(I(` ! ${i.length===1?i[0].rel:`${i.length} HTML files`} load ${[...new Set(i.flatMap(l=>l.assets))].join(", ")} from next to ${i.length===1?"it":"them"}; only HTML files are published`))}if(!O.length&&b&&!N.length){t.json?d(JSON.stringify({...ce,applied:!0},null,2)):d(`${y("\u2713")} Up to date`);return}if(t["dry-run"]){t.json&&d(JSON.stringify({...ce,applied:!1},null,2));return}if((!b||N.length)&&!t.yes){let i=["dockito sync",f,`-w ${u.slug}`,`--to ${g}`,t.create&&!b?"--create":"",t.fold?"--fold":"","--yes"].filter(Boolean).join(" ");if(!o){if(t.json)return d(JSON.stringify({...ce,applied:!1,next:i},null,2));throw new D("confirm",`
|
|
17
|
+
Nothing changed yet. Show the user this plan, then run: ${i}`,{next:i})}if(!await Ae("Apply?"))return $(p("Nothing changed."))}if(!b){let i=await e.createProject(u.id,k);b={id:i.id,slug:i.slug,name:k,docs:0,folders:[]},t.json||d(`${y("\u2713")} Project ${k}`)}let Te=b;for(let i of N){let l=await e.createFolder(Te.id,i[i.length-1],i.length>1?X.idOf(i.slice(0,-1)):null);X.add(i,l.id)}N.length&&!t.json&&d(`${y("\u2713")} ${V(N.length,"folder")}`);let le=ye(["rev-parse","--show-toplevel"],c)?.trim()??null,Ge=le?ye(["rev-parse","HEAD"],le)?.trim()??null:null,wt=new Set(le?(ye(["status","--porcelain","-z","--","."],c)??"").split("\0").filter(Boolean).map(i=>Ee(le,i.slice(3))):[]),K=[],de=null,Oe=[...O],ue=!t.json&&Pe(),kt=O.reduce((i,l)=>i+l.bytes.length,0),qe=0,ze=()=>ue&&process.stdout.write(`\r\x1B[2K${p(`Sending ${K.length} of ${O.length} \xB7 ${se(qe)} of ${se(kt)}`)}`);async function yt(i){let l=Ge&&!wt.has(E(c,i.rel))?Ge:null;for(;;)try{let h=i.doc?await e.update(i.doc.id,i.name,i.bytes,{commit:l}):await e.create(u.id,i.name,i.bytes,{project:Te.id,folder:X.idOf(i.folder)??null});return{file:i.rel,action:i.action,link:e.linkOf(h.slug)}}catch(h){if(h instanceof x&&h.code==="rate_limited"){de||(t.json||$(p("\rUpload limit reached; carrying on in a minute\u2026")),de=new Promise(v=>setTimeout(v,3e4)).then(()=>{de=null})),await de;continue}return{file:i.rel,action:i.action,error:h instanceof x?ee(h,e.url):String(h)}}}ze(),await Promise.all(Array.from({length:Math.min(Wt,Oe.length)},async()=>{for(let i=Oe.shift();i;i=Oe.shift()){let l=await yt(i);K.push(l),qe+=i.bytes.length,ue&&process.stdout.write("\r\x1B[2K"),l.error&&!t.json?d(`${_("\u2717")} ${l.file} ${_(l.error)}`):!t.json&&!ue&&d(`${y("\u2713")} ${l.file} ${p(l.link)}`),ze()}})),ue&&process.stdout.write("\r\x1B[2K");let De=K.filter(i=>i.error),Ve=`${e.url}/${u.slug}/project/${Te.slug}`;t.json?d(JSON.stringify({...ce,applied:!0,link:Ve,results:K},null,2)):d(`${De.length?I(`${K.length-De.length} of ${K.length} sent`):y("\u2713 Synced")} ${p(Ve)}`),De.length&&(process.exitCode=1)}var Me="0.0.1-beta.4",A=Ze(),ie=et(A),Fe=`dockito-cli/${Me} (${process.platform})`;function S(){let e=he(ie);return e||m("Not logged in. Run `dockito login`."),pe({url:A,token:e,source:"cli",userAgent:Fe})}function ft(e){let[n,t]=process.platform==="darwin"?["open",[e]]:process.platform==="win32"?["cmd",["/c","start","",e]]:["xdg-open",[e]];try{let o=qt(n,t,{stdio:"ignore",detached:!0});return o.on("error",()=>{}),o.unref(),!0}catch{return!1}}var nn=()=>!process.env.SSH_CONNECTION&&!process.env.CI&&(process.platform!=="linux"||!!process.env.DISPLAY||!!process.env.WAYLAND_DISPLAY),on=e=>new Promise(n=>setTimeout(n,e)),sn=()=>Qt().replace(/\.local$/,"").slice(0,60)||"Unknown device",rn=/^[a-z0-9]{12}$/;function F(e){let t=(/^https?:\/\//.test(e)?new URL(e).pathname.split("/").filter(Boolean).pop()??"":e).replace(/\.[a-z]+$/,"");return rn.test(t)&&/\d/.test(t)?t:m(`"${e}" isn't a doc link or code. \`dockito ls\` lists docs with their codes.`)}function ut(e){let n=Zt(en(e)),t=lt("git",["rev-parse","HEAD"],{cwd:n,encoding:"utf8"});if(t.error||t.status!==0)return null;let o=lt("git",["status","--porcelain","--",Le(e)],{cwd:n,encoding:"utf8"});return o.status!==0||o.stdout.trim()?null:t.stdout.trim()}var an=e=>zt("sha256").update(e).digest("hex");async function cn(e){let n=he(ie);e.update&&!n&&m("Not logged in. Run `dockito login` first."),process.env.DOCKITO_TOKEN&&$(I("DOCKITO_TOKEN is set, so commands will keep using it instead of this login."));let t=pe({url:A,token:e.update?n:null,userAgent:Fe}),o=await t.startLogin("Dockito CLI",sn()),s=!e["no-browser"]&&nn()&&ft(o.verification_uri_complete);d(s?`Opening ${o.verification_uri_complete}`:`Open ${T(o.verification_uri)}`),d(`Code: ${T(o.user_code)}`),$(p("Waiting for approval\u2026"));let r=o.interval*1e3,a=Date.now()+o.expires_in*1e3;for(;Date.now()<a;){await on(r);try{let c=await t.pollLogin(o.device_code);if(!c)continue;let f=nt(ie,c.token);d(`${y("\u2713")} Logged in as ${c.user.name}${c.user.username?p(` (${c.user.username})`):""}`);for(let w of c.workspaces)d(` ${w.name} ${p(`${w.slug} \xB7 ${H[w.level]}`)}`);f==="file"&&$(I("No keychain found, so the token is in a file only you can read, in ~/.config/dockito."));return}catch(c){if(c instanceof x&&c.code==="access_denied"&&m("Denied in the browser."),c instanceof x&&c.code==="expired_token"&&m("The code expired. Run `dockito login` again."),c instanceof x&&c.code==="offline"){r=Math.min(r*2,3e4);continue}throw c}}m("The code expired. Run `dockito login` again.")}async function ln(){let e=he(ie);if(!e)return d("Not logged in.");process.env.DOCKITO_TOKEN&&m("DOCKITO_TOKEN is set; unset it or revoke that token in Account \u2192 Tokens.");try{await pe({url:A,token:e,userAgent:Fe}).logout()}catch(n){if(!(n instanceof x)||n.code!=="invalid_token"&&n.code!=="not_found")throw n}ot(ie),d(`${y("\u2713")} Logged out`)}async function dn(e){let n=await S().whoami();if(e.json)return d(JSON.stringify(n,null,2));d(`${n.user.name} ${p(`${n.user.username} \xB7 ${n.user.email}`)}`),n.token&&d(p(`${n.token.name} \xB7 ${n.token.source==="cli"?"ends after 90 days without use":`expires ${new Date(n.token.expiresAt).toLocaleDateString()}`}`)),d(),Z(n.workspaces.map(t=>[t.slug,t.name,p(t.level?H[t.level]:t.role)])),A!=="https://dockito-app.dockito.workers.dev"&&$(p(`
|
|
18
|
+
${A}`))}async function un(e,n){e.length||m("Name a file: `dockito publish notes.md --to <project/folder>`"),n.doc&&e.length>1&&m("--doc takes one file."),n.public&&n.doc&&m("--public is only for a new doc; an existing one can be made public from Share in the app.");for(let f of e)(!Vt(f)||!Yt(f).isFile())&&m(`${f} isn't a file.`);let t=S(),o=[];if(n.doc){let f=await t.doc(F(n.doc)),w=new Uint8Array(dt(e[0])),g=await t.update(f.doc.id,Le(e[0]),w,{note:n.message,commit:ut(e[0])});return n.json?d(JSON.stringify([{file:e[0],...g,link:t.linkOf(g.slug)}],null,2)):d(g.unchanged?`${p("=")} ${e[0]} ${p("unchanged")} ${t.linkOf(g.slug)}`:`${y("\u2713")} ${e[0]} \u2192 ${t.linkOf(g.slug)}`)}let s=await t.tree(),r=me(s,n.workspace);L(r)||m(`This login has View access in ${r.slug}. Run \`dockito login --update\`.`);let a=Ie(r,n.to),c=await t.files(r.id,a.project);for(let f of e){let w=new Uint8Array(dt(f)),g=Le(f),u=n.new?[]:we(c,a.folder,g);u.length>1&&m(`${u.length} docs in ${a.label} are named ${g}: ${u.map(R=>t.linkOf(R.slug)).join(", ")}. Pick one with --doc, or publish a new one with --new.`);let k=u[0];if(k&&n.public&&!(await t.doc(k.slug)).doc.public&&m(`${g} is already a private doc in ${a.label} (${t.linkOf(k.slug)}). Only Share in the app can make it public; \`--new --public\` publishes a new public doc.`),k&&k.sha256===an(w)&&!n.message){o.push({file:f,id:k.id,slug:k.slug,version:k.version,unchanged:!0,link:t.linkOf(k.slug)}),n.json||d(`${p("=")} ${f} ${p("unchanged")} ${t.linkOf(k.slug)}`);continue}let j=k?await t.update(k.id,g,w,{note:n.message,commit:ut(f)}):await t.create(r.id,g,w,{project:a.project,folder:a.folder,public:n.public});!k&&n.message&&await t.save(j.id,j.version,n.message);let b="public"in j&&j.public===!0;o.push({file:f,...j,link:t.linkOf(j.slug),new:!k}),n.json||d(`${y("\u2713")} ${f} \u2192 ${t.linkOf(j.slug)} ${p(k?j.unchanged?"unchanged":"updated":`new in ${a.label}`)}${b?` ${y("\xB7 public")}`:""}${n.message?p(` \xB7 saved: ${n.message}`):""}`)}n.json?d(JSON.stringify(o,null,2)):!n.to&&o.some(f=>f.new)&&$(p("In the workspace's Docs. To put docs in a project: --to <project/folder>; `dockito tree` lists them."))}async function pn(e){let n=await S().tree();if(e.json)return d(JSON.stringify(n,null,2));let t=o=>p(`${o} doc${o===1?"":"s"}`);for(let o of n.workspaces){d(`${T(o.slug)} ${o.name} ${p(`\xB7 ${o.level?H[o.level]:o.role}`)}`);let s=[[p("Docs"),"",t(o.docs)]];for(let r of o.projects){s.push([r.slug,r.name,t(r.docs)]);let a=(c,f)=>{for(let w of r.folders.filter(g=>g.parentId===c))s.push([`${f}/${w.name}`,"",t(w.docs)]),a(w.id,`${f}/${w.name}`)};a(null,r.slug)}Z(s.map(r=>[" ",...r])),d()}$(p("Publish into a place: dockito publish <file> -w <workspace> --to <project/folder>"))}async function fn(e,n){let t=S(),o=await t.tree(),s=me(o,n.workspace),r=Ie(s,e),a=await t.docs(s.id,{project:r.project,folder:r.folder}),c=r.project?s.projects.find(u=>u.id===r.project):null,f=e?[]:s.projects,w=c?c.folders.filter(u=>u.parentId===r.folder):[];if(n.json)return d(JSON.stringify({workspace:s.slug,place:e??null,projects:f,folders:w,docs:a},null,2));let g=[];for(let u of f)g.push([T(`${u.slug}/`),u.name,p(`${u.docs} doc${u.docs===1?"":"s"}`),""]);for(let u of w)g.push([T(`${u.name}/`),"",p(`${u.docs} doc${u.docs===1?"":"s"}`),""]);for(let u of a)g.push([u.slug,u.title+p(u.kind==="html"?" .html":" .md"),p(fe(u.updatedAt)),p(u.updatedByName??"")]);if(!g.length)return $(p(`Nothing in ${r.label} yet.`));Z(g)}async function gn(e,n){let[t,...o]=(e??"").split("/").filter(Boolean);t||m("`dockito mkdir <project>[/folder[/subfolder]]`"),o.length>2&&m("Folders go at most 2 deep inside a project.");let s=S(),r=me(await s.tree(),n.workspace),a=z(r,t),c=a?.id??(await s.createProject(r.id,t)).id,f=!a;a||d(`${y("\u2713")} Project ${t}`);let w=oe(a),g=null;for(let u=0;u<o.length;u++){let k=w.idOf(o.slice(0,u+1));if(k){g=k;continue}g=(await s.createFolder(c,o[u],g)).id,w.add(o.slice(0,u+1),g),f=!0,d(`${y("\u2713")} Folder ${o.slice(0,u+1).join("/")}`)}f||$(p("Already there."))}async function hn(e){e||m("Name a doc: `dockito open <link or code>`");let n=`${A}/${F(e)}`;ft(n)||d(n)}async function mn(e,n){e||m("Name a doc: `dockito get <link or code> [-o file]`");let t=S(),o=await t.doc(F(e)),s=n.entry?Number(n.entry):null;n.entry&&(!Number.isInteger(s)||s<1)&&m("--entry takes an entry number from `dockito history`.");let{bytes:r}=await t.content(o.doc.id,s);if(!n.output)return void process.stdout.write(r);Xt(n.output,r),$(`${y("\u2713")} ${n.output} ${p(`\u2190 ${t.linkOf(o.doc.slug)}${s?` entry ${s}`:""}`)}`)}async function wn(e,n){e||m("Name a doc: `dockito history <link or code>`");let t=await S().doc(F(e));if(n.json)return d(JSON.stringify(t.versions,null,2));d(`${T(t.doc.title)} ${p(`${A}/${t.doc.slug}`)}`),Z(t.versions.map((o,s)=>[String(o.number),s===0?y("current"):p(fe(o.createdAt)),s===0?p(fe(o.createdAt)):"",o.byName??"",p(o.source),o.savedAt?`${I("saved")}${o.note?` ${o.note}`:""}`:"",o.gitCommit?p(o.gitCommit.slice(0,7)):""]))}async function kn(e,n){let t=Number(n);(!e||!Number.isInteger(t)||t<1)&&m("`dockito restore <doc> <entry>`; entries are in `dockito history`.");let o=S(),s=await o.doc(F(e)),r=await o.restore(s.doc.id,t,s.versions[0]?.number??null);d(`${y("\u2713")} Restored entry ${t} as entry ${r.version} ${p(o.linkOf(r.slug))}`)}async function yn(e,n,t){e||m('`dockito save <doc> [entry] -m "note"`');let o=S(),s=await o.doc(F(e)),r=n?Number(n):s.versions[0]?.number;(!Number.isInteger(r)||r<1)&&m("Entries are in `dockito history`."),await o.save(s.doc.id,r,t.message??null),d(`${y("\u2713")} Saved entry ${r}${t.message?p(` \xB7 ${t.message}`):""}`)}async function bn(e,n){e||m("`dockito share <link or code> [--private]`"),n.public&&m("An existing doc can be made public only from Share in the app. `dockito publish <file> --public` makes a new doc public.");let t=S(),o=await t.doc(F(e)),s=t.linkOf(o.doc.slug);if(n.private)return o.doc.public&&await t.makePrivate(o.doc.id),n.json?d(JSON.stringify({public:!1,link:s},null,2)):d(`${y("\u2713")} Private: only people in ${o.workspace.name} can open it ${p(s)}`);if(n.json)return d(JSON.stringify({public:o.doc.public,link:s},null,2));d(o.doc.public?`${y("Public")}: anyone with the link can open it ${s}`:`Private: only people in ${o.workspace.name} can open it ${p(s)}`)}var gt=`Dockito hosts Markdown and HTML docs at a short link, with History.
|
|
19
19
|
|
|
20
20
|
workspace a person's or a team's space; its slug is in every link
|
|
21
21
|
project docs grouped in a workspace, with folders up to 2 deep
|
|
@@ -28,43 +28,80 @@ ${S}`))}async function cn(e,n){e.length||w("Name a file: `dockito publish notes.
|
|
|
28
28
|
For AI agents:
|
|
29
29
|
- The CLI remembers nothing between runs. Run \`dockito tree\` to see
|
|
30
30
|
where docs can go and \`dockito ls <place>\` for what's there.
|
|
31
|
-
-
|
|
32
|
-
|
|
31
|
+
- Just a link to share: publish with no --to; it goes to the workspace's
|
|
32
|
+
Docs. When it belongs in a project, ask the user where, never guess,
|
|
33
|
+
and pass it with --to every time.
|
|
34
|
+
- Docs are private: only people in the workspace can open them. Add
|
|
35
|
+
--public (anyone with the link, no sign-in) only when the user clearly
|
|
36
|
+
asked for a public link. If they didn't say, keep it private.
|
|
33
37
|
- A folder of docs: \`dockito sync <folder> --to <project>\`. It shows a
|
|
34
38
|
plan; show it to the user before running with --yes.
|
|
35
|
-
-
|
|
39
|
+
- \`dockito <command> --help\` explains each command. Use --json; on
|
|
40
|
+
failure, read "error" and the commands it suggests.`,ht={sync:{use:"sync <folder> --to <project>",about:"Mirror a folder into a project",page:`Mirrors a local folder into a project: subfolders become folders, and each
|
|
41
|
+
file updates the doc with the same file name in the same folder, or becomes
|
|
42
|
+
a new doc there. Only files whose content changed are sent. Nothing is moved
|
|
43
|
+
or deleted in Dockito. The CLI remembers nothing: pass --to every time.
|
|
36
44
|
|
|
37
|
-
|
|
45
|
+
Docs made by sync are private.
|
|
46
|
+
|
|
47
|
+
--to <project[/folder]> Where it goes (required; \`dockito tree\` lists places)
|
|
48
|
+
-w, --workspace <slug> Another workspace
|
|
49
|
+
--create Make the project if it doesn't exist
|
|
50
|
+
--fold Put folders deeper than 2 into the deepest allowed;
|
|
51
|
+
clashing names get the left-out folders in front
|
|
52
|
+
--dry-run Show the plan, change nothing
|
|
53
|
+
--yes Apply a plan that makes a project or folders
|
|
54
|
+
|
|
55
|
+
It always shows a plan. Making a project or folders waits for --yes: show
|
|
56
|
+
the plan to the user first. Sending docs into folders that exist just runs.
|
|
57
|
+
|
|
58
|
+
dockito sync docs --to handbook
|
|
59
|
+
dockito sync docs --to handbook --create --fold --dry-run`},publish:{use:"publish <file...>",about:"Publish files; the same name in that place updates its doc",page:`Publishes Markdown or HTML files. A file with the same name in that place
|
|
60
|
+
updates its doc (same link, a new History entry); otherwise it's a new doc.
|
|
61
|
+
Unchanged files are skipped.
|
|
62
|
+
|
|
63
|
+
Docs are private: only people in the workspace can open them.
|
|
64
|
+
Add --public only when the user clearly asked for a public link (anyone
|
|
65
|
+
with the link, no sign-in). If they didn't say, keep it private. --public
|
|
66
|
+
works only for a new doc; an existing private doc can be made public only
|
|
67
|
+
from Share in the app.
|
|
68
|
+
|
|
69
|
+
--to <project[/folder]> Where (default: the workspace's Docs)
|
|
70
|
+
-w, --workspace <slug> Another workspace (default: your personal one)
|
|
71
|
+
-m, --message <note> Keep this entry as a saved point, with a note
|
|
72
|
+
--public Make the new doc public (only when the user asked)
|
|
73
|
+
--doc <doc> Update this doc (link or code) instead
|
|
74
|
+
--new A new doc even if the name is already there
|
|
75
|
+
|
|
76
|
+
dockito publish plan.md private, in your Docs
|
|
77
|
+
dockito publish plan.md --to handbook/specs private, in a folder
|
|
78
|
+
dockito publish plan.md --public the user asked for a public link`},share:{use:"share <doc>",about:"Who can open a doc; --private takes a public link back",page:`Says whether a doc is private (only people in its workspace) or public
|
|
79
|
+
(anyone with the link). --private makes it private again at once.
|
|
80
|
+
|
|
81
|
+
An existing doc is made public only from Share in the app; a new doc can be
|
|
82
|
+
published public with \`dockito publish <file> --public\` when the user asks.
|
|
83
|
+
|
|
84
|
+
dockito share <link or code>
|
|
85
|
+
dockito share <link or code> --private`},tree:{use:"tree",about:"Every workspace, project and folder you can use",page:"Lists every workspace this login can reach, its projects and their folders,\nwith doc counts, each written as the --to it takes. Docs themselves: `dockito ls`."},ls:{use:"ls [project/folder]",about:"What's in a place",page:`Lists the docs (with their codes), projects and folders in a place: your
|
|
86
|
+
workspace's top level, a project, or a folder. -w for another workspace.`},mkdir:{use:"mkdir <project/folder>",about:"Make a project or folders",page:`Makes whatever is missing: the project, then up to 2 levels of folders.
|
|
87
|
+
|
|
88
|
+
dockito mkdir handbook/specs/drafts`},open:{use:"open <doc>",about:"Open in the browser",page:"Opens a doc (link or code) in the browser."},get:{use:"get <doc> [-o file]",about:"Download a doc",page:"Prints a doc's file, or writes it with -o. --entry <n> gets a History entry\n(numbers from `dockito history`)."},history:{use:"history <doc>",about:"History entries",page:`Lists a doc's History: entry, when, who, from where (upload, edit, cli,
|
|
89
|
+
mcp), saved points with their notes, and the git commit.`},restore:{use:"restore <doc> <entry>",about:"Make a History entry current again",page:"Makes an older entry the current one, as a new entry. Nothing is lost."},save:{use:"save <doc> [entry] -m <note>",about:"Keep an entry as a saved point",page:`Keeps an entry (default: the current one) as a saved point, so History
|
|
90
|
+
never drops it, with an optional note.`},login:{use:"login [--update]",about:"Sign in through the browser",page:`Opens the browser, where you check a code and choose this login's access
|
|
91
|
+
in each workspace: View, Publish or Everything. --update changes that access.
|
|
92
|
+
--no-browser prints the link instead.`},logout:{use:"logout",about:"Sign out this machine",page:"Signs this machine out and removes its token."},whoami:{use:"whoami",about:"Who you are and what this login can reach",page:"Your name, the login's expiry, and its access in each workspace."},agent:{use:"agent",about:"What an AI agent needs to know",page:"Prints what Dockito is and how an AI agent should use this CLI."}},Ce=`Dockito CLI ${Me}
|
|
93
|
+
|
|
94
|
+
${gt}
|
|
38
95
|
|
|
39
96
|
Usage: dockito <command>
|
|
40
97
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
--yes Apply without asking; --dry-run shows the plan only
|
|
46
|
-
publish <file...> Publish files; a file with the same name in that
|
|
47
|
-
place updates its doc
|
|
48
|
-
--to <project/folder> Where (default: the workspace's Docs)
|
|
49
|
-
-m, --message <note> Keep this entry as a saved point
|
|
50
|
-
--doc <doc> Update this doc instead
|
|
51
|
-
--new Publish as a new doc even if the name is there
|
|
52
|
-
tree Every workspace, project and folder you can use
|
|
53
|
-
ls [project/folder] What's in a place
|
|
54
|
-
mkdir <project/folder> Make a project or folders
|
|
55
|
-
open <doc> Open in the browser
|
|
56
|
-
get <doc> [-o file] Download (--entry <n> for a History entry)
|
|
57
|
-
history <doc> History entries
|
|
58
|
-
restore <doc> <entry> Make a History entry current again
|
|
59
|
-
save <doc> [entry] -m ... Keep an entry as a saved point
|
|
60
|
-
|
|
61
|
-
login [--update] Sign in through the browser (--update changes access)
|
|
62
|
-
logout Sign out this machine
|
|
63
|
-
whoami Who you are and what this login can reach
|
|
64
|
-
agent What an AI agent needs to know, on its own
|
|
65
|
-
|
|
66
|
-
<doc> is a link or a code.
|
|
98
|
+
${Object.values(ht).map(e=>` ${e.use.padEnd(30)}${e.about}`).join(`
|
|
99
|
+
`)}
|
|
100
|
+
|
|
101
|
+
<doc> is a link or a code. \`dockito <command> --help\` for more.
|
|
67
102
|
-w, --workspace <slug> Another workspace (default: your personal one)
|
|
68
103
|
--json Machine-readable output
|
|
69
104
|
|
|
70
|
-
Environment: DOCKITO_TOKEN (use this token), DOCKITO_URL (another Dockito)
|
|
105
|
+
Environment: DOCKITO_TOKEN (use this token), DOCKITO_URL (another Dockito)`,pt=e=>{let n=ht[e];return n?`dockito ${n.use}
|
|
106
|
+
|
|
107
|
+
${n.page}`:null};async function $n(){let{values:e,positionals:n}=tn({allowPositionals:!0,options:{message:{type:"string",short:"m"},to:{type:"string"},doc:{type:"string"},new:{type:"boolean"},workspace:{type:"string",short:"w"},output:{type:"string",short:"o"},entry:{type:"string"},json:{type:"boolean"},update:{type:"boolean"},yes:{type:"boolean",short:"y"},"dry-run":{type:"boolean"},create:{type:"boolean"},fold:{type:"boolean"},"no-browser":{type:"boolean"},public:{type:"boolean"},private:{type:"boolean"},help:{type:"boolean",short:"h"},version:{type:"boolean",short:"v"}}}),[t,...o]=n;if(e.version)return d(Me);if(t==="help"&&o[0])return d(pt(o[0])??Ce);if(e.help&&t)return d(pt(t)??Ce);if(e.help||!t||t==="help")return d(Ce);switch(t){case"login":return cn(e);case"logout":return ln();case"whoami":return dn(e);case"sync":return ct(S(),o[0],e);case"publish":return un(o,e);case"tree":return pn(e);case"ls":return fn(o[0],e);case"mkdir":return gn(o[0],e);case"share":return bn(o[0],e);case"open":return hn(o[0]);case"get":return mn(o[0],e);case"history":return wn(o[0],e);case"restore":return kn(o[0],o[1]);case"save":return yn(o[0],o[1],e);case"agent":return d(gt);default:m(`Unknown command "${t}". Run \`dockito --help\`.`)}}function be(e){let n=2,t=()=>--n===0&&process.exit(e);process.stdout.write("",t),process.stderr.write("",t)}$n().then(()=>be(Number(process.exitCode??0)),e=>{let n=process.argv.includes("--json");if(e instanceof D)return n?d(JSON.stringify({error:e.code,message:e.message.replace(/\x1b\[[0-9;]*m/g,""),...e.data},null,2)):$(e.message),be(2);if(e instanceof te)return be(130);n&&e instanceof x?d(JSON.stringify({error:e.code,message:ee(e,A),...e.detail},null,2)):n&&e instanceof W?d(JSON.stringify({error:"failed",message:e.message},null,2)):e instanceof W?$(_(e.message)):e instanceof x?$(_(ee(e,A))):e instanceof TypeError&&/parseArgs|option|positional/i.test(String(e.message))?$(_(`${e.message}. Run \`dockito --help\`.`)):$(_(String(e?.stack??e))),be(1)});
|
package/package.json
CHANGED
|
@@ -1,15 +1,25 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dockito",
|
|
3
|
-
"version": "0.0.1-beta.
|
|
3
|
+
"version": "0.0.1-beta.4",
|
|
4
4
|
"description": "Dockito CLI: publish the docs your AI writes as links you can share.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"homepage": "https://dockito-site.dockito.workers.dev",
|
|
7
|
-
"keywords": [
|
|
7
|
+
"keywords": [
|
|
8
|
+
"dockito",
|
|
9
|
+
"docs",
|
|
10
|
+
"markdown",
|
|
11
|
+
"publish",
|
|
12
|
+
"cli",
|
|
13
|
+
"ai"
|
|
14
|
+
],
|
|
8
15
|
"type": "module",
|
|
9
16
|
"bin": {
|
|
10
17
|
"dockito": "dockito.js"
|
|
11
18
|
},
|
|
12
|
-
"files": [
|
|
19
|
+
"files": [
|
|
20
|
+
"dockito.js",
|
|
21
|
+
"README.md"
|
|
22
|
+
],
|
|
13
23
|
"engines": {
|
|
14
24
|
"node": ">=18.17"
|
|
15
25
|
}
|