docs-cache 0.1.3 → 0.1.4

package/dist/chunks/add.mjs

@@ -1,3 +1,3 @@
-import{readFile as m,writeFile as y,access as x}from"node:fs/promises";import h from"node:path";import{v as w,D as v,a as b,s as C,w as F,r as D}from"../shared/docs-cache.D4Fth4X8.mjs";import{r as I}from"../shared/docs-cache.D9_kM5zq.mjs";import{r as N}from"../shared/docs-cache.BSvQNKuf.mjs";import"zod";import"node:process";import"cac";import"picocolors";const f=async o=>{try{return await x(o),!0}catch{return!1}},P="package.json",S=async o=>{const s=await m(o,"utf8"),r=JSON.parse(s),a=r["docs-cache"];return a?{parsed:r,config:w(a)}:{parsed:r,config:null}},O=async o=>{if(o){const a=D(o);return{resolvedPath:a,mode:h.basename(a)===P?"package":"config"}}const s=D();if(await f(s))return{resolvedPath:s,mode:"config"};const r=h.resolve(process.cwd(),P);return await f(r)&&(await S(r)).config?{resolvedPath:r,mode:"package"}:{resolvedPath:s,mode:"config"}},E=async o=>{const s=await O(o.configPath),r=s.resolvedPath;let a=v,t=null,l=null;if(await f(r))if(s.mode==="package"){const e=await S(r);l=e.parsed,t=e.config,a=t??v}else{const e=await m(r,"utf8");t=JSON.parse(e.toString()),a=w(t)}const k="https://raw.githubusercontent.com/fbosch/docs-cache/main/docs.config.schema.json",p=new Set(a.sources.map(e=>e.id)),u=[],d=o.entries.map(e=>{const c=N(e.repo),g=e.id||c.inferredId;if(!g)throw new Error("Unable to infer id. Provide an explicit id.");const n=b(g,"source id");return p.has(n)?(u.push(n),null):(p.add(n),e.targetDir&&I(r,e.targetDir),{id:n,repo:c.repoUrl,...e.targetDir?{targetDir:e.targetDir}:{},...c.ref?{ref:c.ref}:{}})}).filter(Boolean);if(d.length===0)throw new Error("All sources already exist in config.");const i={$schema:k,sources:[...a.sources,...d]};if(t?.cacheDir&&(i.cacheDir=t.cacheDir),t?.index!==void 0&&(i.index=t.index),t?.defaults&&(i.defaults=t.defaults),s.mode==="package"){const e=l??{};e["docs-cache"]=C(i),await y(r,`${JSON.stringify(e,null,2)}
-`,"utf8")}else await F(r,i);return{configPath:r,sources:d,skipped:u,created:!0}};export{E as addSources};
+import{readFile as D,writeFile as b,access as k}from"node:fs/promises";import l from"node:path";import{v,D as P,a as E,s as F,w as I,b as U,r as S}from"../shared/docs-cache.D4Fth4X8.mjs";import{e as A}from"../shared/docs-cache.DgrUGcWv.mjs";import{r as N}from"../shared/docs-cache.D9_kM5zq.mjs";import{r as O}from"../shared/docs-cache.BSvQNKuf.mjs";import"zod";import"node:process";import"cac";import"picocolors";const u=async o=>{try{return await k(o),!0}catch{return!1}},y="package.json",x=async o=>{const i=await D(o,"utf8"),e=JSON.parse(i),t=e["docs-cache"];return t?{parsed:e,config:v(t)}:{parsed:e,config:null}},J=async o=>{if(o){const t=S(o);return{resolvedPath:t,mode:l.basename(t)===y?"package":"config"}}const i=S();if(await u(i))return{resolvedPath:i,mode:"config"};const e=l.resolve(process.cwd(),y);return await u(e)&&(await x(e)).config?{resolvedPath:e,mode:"package"}:{resolvedPath:i,mode:"config"}},T=async o=>{const i=await J(o.configPath),e=i.resolvedPath;let t=P,a=null,g=null,d=!1;if(await u(e))if(i.mode==="package"){const r=await x(e);g=r.parsed,a=r.config,t=a??P,d=!!a}else{const r=await D(e,"utf8");a=JSON.parse(r.toString()),t=v(a),d=!0}const C="https://raw.githubusercontent.com/fbosch/docs-cache/main/docs.config.schema.json",p=new Set(t.sources.map(r=>r.id)),m=[],f=o.entries.map(r=>{const n=O(r.repo),w=r.id||n.inferredId;if(!w)throw new Error("Unable to infer id. Provide an explicit id.");const c=E(w,"source id");return p.has(c)?(m.push(c),null):(p.add(c),r.targetDir&&N(e,r.targetDir),{id:c,repo:n.repoUrl,...r.targetDir?{targetDir:r.targetDir}:{},...n.ref?{ref:n.ref}:{}})}).filter(Boolean);if(f.length===0)throw new Error("All sources already exist in config.");const s={$schema:C,sources:[...t.sources,...f]};if(a?.cacheDir&&(s.cacheDir=a.cacheDir),a?.index!==void 0&&(s.index=a.index),a?.defaults&&(s.defaults=a.defaults),i.mode==="package"){const r=g??{};r["docs-cache"]=F(s),await b(e,`${JSON.stringify(r,null,2)}
+`,"utf8")}else await I(e,s);const h=d?null:await A(l.dirname(e),a?.cacheDir??U);return{configPath:e,sources:f,skipped:m,created:!0,gitignoreUpdated:h?.updated??!1,gitignorePath:h?.gitignorePath??null}};export{T as addSources};
 //# sourceMappingURL=add.mjs.map

package/dist/chunks/init.mjs

@@ -1,3 +1,3 @@
-import{readFile as g,writeFile as k,access as v}from"node:fs/promises";import f from"node:path";import{confirm as F,isCancel as N,select as O,text as P}from"@clack/prompts";import{c as A,b as o,s as J,w as S}from"../shared/docs-cache.D4Fth4X8.mjs";import"zod";import"../shared/docs-cache.D9_kM5zq.mjs";import"node:process";import"cac";import"picocolors";const h=async s=>{try{return await v(s),!0}catch{return!1}},V=async(s,r={})=>{const b=r.confirm??F,l=r.isCancel??N,y=r.select??O,j=r.text??P,w=s.cwd??process.cwd(),d=f.resolve(w,A),a=f.resolve(w,"package.json"),n=[];if(await h(d)&&n.push(d),await h(a)){const i=await g(a,"utf8");JSON.parse(i)["docs-cache"]&&n.push(a)}if(n.length>0)throw new Error(`Config already exists at ${n.join(", ")}. Init aborted.`);let p=!1;if(await h(a)){const i=await g(a,"utf8");if(!JSON.parse(i)["docs-cache"]){const c=await y({message:"Config location",options:[{value:"config",label:"docs.config.json"},{value:"package",label:"package.json"}],initialValue:"config"});if(l(c))throw new Error("Init cancelled.");p=c==="package"}}const I=p?a:d,$=s.cacheDirOverride??o,x=await j({message:"Cache directory",initialValue:$});if(l(x))throw new Error("Init cancelled.");const C=await b({message:"Generate index.json (summary of cached sources + paths for tools)",initialValue:!1});if(l(C))throw new Error("Init cancelled.");const t={configPath:I,cacheDir:x,index:C},e=f.resolve(w,t.configPath);if(f.basename(e)==="package.json"){const i=await g(e,"utf8"),c=JSON.parse(i);if(c["docs-cache"])throw new Error(`docs-cache config already exists in ${e}.`);const m={$schema:"https://raw.githubusercontent.com/fbosch/docs-cache/main/docs.config.schema.json",sources:[]},D=t.cacheDir||o;return D!==o&&(m.cacheDir=D),t.index&&(m.index=!0),c["docs-cache"]=J(m),await k(e,`${JSON.stringify(c,null,2)}
-`,"utf8"),{configPath:e,created:!0}}if(await h(e))throw new Error(`Config already exists at ${e}.`);const u={$schema:"https://raw.githubusercontent.com/fbosch/docs-cache/main/docs.config.schema.json",sources:[]},E=t.cacheDir||o;return E!==o&&(u.cacheDir=E),t.index&&(u.index=!0),await S(e,u),{configPath:e,created:!0}};export{V as initConfig};
+import{readFile as y,writeFile as N,access as S}from"node:fs/promises";import r from"node:path";import{confirm as V,isCancel as G,select as J,text as U}from"@clack/prompts";import{c as _,b as n,s as L,w as T}from"../shared/docs-cache.D4Fth4X8.mjs";import{g as H,e as F}from"../shared/docs-cache.DgrUGcWv.mjs";import"zod";import"../shared/docs-cache.D9_kM5zq.mjs";import"node:process";import"cac";import"picocolors";const h=async c=>{try{return await S(c),!0}catch{return!1}},M=async(c,s={})=>{const x=s.confirm??V,l=s.isCancel??G,O=s.select??J,$=s.text??U,f=c.cwd??process.cwd(),d=r.resolve(f,_),i=r.resolve(f,"package.json"),g=[];if(await h(d)&&g.push(d),await h(i)){const t=await y(i,"utf8");JSON.parse(t)["docs-cache"]&&g.push(i)}if(g.length>0)throw new Error(`Config already exists at ${g.join(", ")}. Init aborted.`);let C=!1;if(await h(i)){const t=await y(i,"utf8");if(!JSON.parse(t)["docs-cache"]){const o=await O({message:"Config location",options:[{value:"config",label:"docs.config.json"},{value:"package",label:"package.json"}],initialValue:"config"});if(l(o))throw new Error("Init cancelled.");C=o==="package"}}const k=C?i:d,v=c.cacheDirOverride??n,u=await $({message:"Cache directory",initialValue:v});if(l(u))throw new Error("Init cancelled.");const A=u||n,b=await x({message:"Generate index.json (summary of cached sources + paths for tools)",initialValue:!1});if(l(b))throw new Error("Init cancelled.");const D=await H(f,A);let j=!1;if(D.entry&&!D.hasEntry){const t=await x({message:"Add cache directory to .gitignore",initialValue:!0});if(l(t))throw new Error("Init cancelled.");j=t}const a={configPath:k,cacheDir:u,index:b,gitignore:j},e=r.resolve(f,a.configPath);if(r.basename(e)==="package.json"){const t=await y(e,"utf8"),o=JSON.parse(t);if(o["docs-cache"])throw new Error(`docs-cache config already exists in ${e}.`);const p={$schema:"https://raw.githubusercontent.com/fbosch/docs-cache/main/docs.config.schema.json",sources:[]},E=a.cacheDir||n;E!==n&&(p.cacheDir=E),a.index&&(p.index=!0),o["docs-cache"]=L(p),await N(e,`${JSON.stringify(o,null,2)}
+`,"utf8");const P=a.gitignore?await F(r.dirname(e),E):null;return{configPath:e,created:!0,gitignoreUpdated:P?.updated??!1,gitignorePath:P?.gitignorePath??null}}if(await h(e))throw new Error(`Config already exists at ${e}.`);const w={$schema:"https://raw.githubusercontent.com/fbosch/docs-cache/main/docs.config.schema.json",sources:[]},m=a.cacheDir||n;m!==n&&(w.cacheDir=m),a.index&&(w.index=!0),await T(e,w);const I=a.gitignore?await F(r.dirname(e),m):null;return{configPath:e,created:!0,gitignoreUpdated:I?.updated??!1,gitignorePath:I?.gitignorePath??null}};export{M as initConfig};
 //# sourceMappingURL=init.mjs.map

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import w from"node:path";import s from"node:process";import f from"picocolors";import{p as j,E as h,s as l,u as c}from"./shared/docs-cache.D9_kM5zq.mjs";import"cac";const u="docs-cache",O=`
+import w from"node:path";import a from"node:process";import l from"picocolors";import{p as j,E as f,s as g,u as r}from"./shared/docs-cache.D9_kM5zq.mjs";import"cac";const u="docs-cache",O=`
 Usage: ${u} <command> [options]
 
 Commands:
@@ -23,14 +23,14 @@ Global options:
   --concurrency <n>
   --json
   --timeout-ms <n>
-`,m=()=>{s.stdout.write(O.trimStart())},p=e=>{s.stderr.write(`${l.error} ${e}
-`)},D=e=>{const t=e.findIndex(i=>!i.startsWith("-")),g=t===-1?[]:e.slice(t+1),d=[];let r=-1;const n=new Set(["--config","--cache-dir","--concurrency","--timeout-ms"]);for(let i=0;i<g.length;i+=1){const o=g[i];if(o==="--source"){const a=g[i+1];if(!a||a.startsWith("-"))throw new Error("--source expects a value.");d.push({repo:a}),r=d.length-1,i+=1;continue}if(o==="--target"||o==="--target-dir"){const a=g[i+1];if(!a||a.startsWith("-"))throw new Error("--target expects a value.");if(r===-1)throw new Error("--target must follow a --source entry.");d[r].targetDir=a,i+=1;continue}if(n.has(o)){i+=1;continue}o.startsWith("--")||(d.push({repo:o}),r=d.length-1)}return d},S=async(e,t,g,d)=>{if(e==="add"){const{addSources:r}=await import("./chunks/add.mjs"),{runSync:n}=await import("./chunks/sync.mjs").then(function(a){return a.s}),i=D(d);if(i.length===0)throw new Error("Usage: docs-cache add [--source <repo> --target <dir>] <repo...>");const o=await r({configPath:t.config,entries:i});if(t.offline?t.json||c.line(`${l.warn} Offline: skipped sync`):await n({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json,lockOnly:t.lockOnly,offline:t.offline,failOnMiss:t.failOnMiss,sourceFilter:o.sources.map(a=>a.id),timeoutMs:t.timeoutMs}),t.json)s.stdout.write(`${JSON.stringify(o,null,2)}
-`);else{for(const a of o.sources){const v=a.repo.replace(/^https?:\/\//,"").replace(/\.git$/,""),y=a.targetDir?` ${f.dim("->")} ${f.magenta(a.targetDir)}`:"";c.item(l.success,a.id,`${f.blue(v)}${y}`)}o.skipped?.length&&c.line(`${l.warn} Skipped ${o.skipped.length} existing source${o.skipped.length===1?"":"s"}: ${o.skipped.join(", ")}`),c.line(`${l.info} Updated ${f.gray(w.relative(s.cwd(),o.configPath)||"docs.config.json")}`)}return}if(e==="remove"){const{removeSources:r}=await import("./chunks/remove.mjs"),{pruneCache:n}=await import("./chunks/prune.mjs");if(g.length===0)throw new Error("Usage: docs-cache remove <id...>");const i=await r({configPath:t.config,ids:g});if(t.json)s.stdout.write(`${JSON.stringify(i,null,2)}
-`);else{if(i.removed.length>0&&c.line(`${l.success} Removed ${i.removed.length} source${i.removed.length===1?"":"s"}: ${i.removed.join(", ")}`),i.missing.length>0&&c.line(`${l.warn} Missing ${i.missing.length} source${i.missing.length===1?"":"s"}: ${i.missing.join(", ")}`),i.targetsRemoved.length>0){const o=i.targetsRemoved.map(a=>`${a.id} -> ${c.path(a.targetDir)}`).join(", ");c.line(`${l.success} Removed ${i.targetsRemoved.length} target${i.targetsRemoved.length===1?"":"s"}: ${o}`)}c.line(`${l.info} Updated ${f.gray(w.relative(s.cwd(),i.configPath)||"docs.config.json")}`)}t.prune&&await n({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json});return}if(e==="status"){const{getStatus:r,printStatus:n}=await import("./chunks/status.mjs"),i=await r({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json});t.json?s.stdout.write(`${JSON.stringify(i,null,2)}
-`):n(i);return}if(e==="clean"){const{cleanCache:r}=await import("./chunks/clean.mjs"),n=await r({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json});t.json?s.stdout.write(`${JSON.stringify(n,null,2)}
-`):n.removed?c.line(`${l.success} Removed cache at ${c.path(n.cacheDir)}`):c.line(`${l.info} Cache already missing at ${c.path(n.cacheDir)}`);return}if(e==="prune"){const{pruneCache:r}=await import("./chunks/prune.mjs"),n=await r({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json});t.json?s.stdout.write(`${JSON.stringify(n,null,2)}
-`):n.removed.length===0?c.line(`${l.info} No cache entries to prune.`):c.line(`${l.success} Pruned ${n.removed.length} cache entr${n.removed.length===1?"y":"ies"}: ${n.removed.join(", ")}`);return}if(e==="sync"){const{printSyncPlan:r,runSync:n}=await import("./chunks/sync.mjs").then(function(o){return o.s}),i=await n({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json,lockOnly:t.lockOnly,offline:t.offline,failOnMiss:t.failOnMiss,timeoutMs:t.timeoutMs});t.json?s.stdout.write(`${JSON.stringify(i,null,2)}
-`):r(i);return}if(e==="verify"){const{printVerify:r,verifyCache:n}=await import("./chunks/verify.mjs").then(function(o){return o.a}),i=await n({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json});t.json?s.stdout.write(`${JSON.stringify(i,null,2)}
-`):r(i),i.results.some(o=>!o.ok)&&s.exit(h.FatalError);return}if(e==="init"){const{initConfig:r}=await import("./chunks/init.mjs");if(t.config)throw new Error("Init does not accept --config. Use the project root.");const n=await r({cacheDirOverride:t.cacheDir,json:t.json});t.json?s.stdout.write(`${JSON.stringify(n,null,2)}
-`):c.line(`${l.success} Wrote ${f.gray(c.path(n.configPath))}`);return}c.line(`${u} ${e}: not implemented yet.`)};async function x(){try{s.on("uncaughtException",$),s.on("unhandledRejection",$);const e=j(),t=e.rawArgs;e.help&&(m(),s.exit(h.Success)),e.command||(m(),s.exit(h.InvalidArgument)),e.command!=="add"&&e.command!=="remove"&&e.positionals.length>0&&(p(`${u}: unexpected arguments.`),m(),s.exit(h.InvalidArgument)),e.command!=="add"&&e.options.targetDir&&(p(`${u}: --target-dir is only valid for add.`),m(),s.exit(h.InvalidArgument)),await S(e.command,e.options,e.positionals,e.rawArgs)}catch(e){$(e)}}function $(e){const t=e.message||String(e);p(t),s.exit(h.FatalError)}export{u as CLI_NAME,x as main};
+`,m=()=>{a.stdout.write(O.trimStart())},p=e=>{a.stderr.write(`${g.error} ${e}
+`)},D=e=>{const t=e.findIndex(i=>!i.startsWith("-")),h=t===-1?[]:e.slice(t+1),d=[];let s=-1;const n=new Set(["--config","--cache-dir","--concurrency","--timeout-ms"]);for(let i=0;i<h.length;i+=1){const o=h[i];if(o==="--source"){const c=h[i+1];if(!c||c.startsWith("-"))throw new Error("--source expects a value.");d.push({repo:c}),s=d.length-1,i+=1;continue}if(o==="--target"||o==="--target-dir"){const c=h[i+1];if(!c||c.startsWith("-"))throw new Error("--target expects a value.");if(s===-1)throw new Error("--target must follow a --source entry.");d[s].targetDir=c,i+=1;continue}if(n.has(o)){i+=1;continue}o.startsWith("--")||(d.push({repo:o}),s=d.length-1)}return d},S=async(e,t,h,d)=>{if(e==="add"){const{addSources:s}=await import("./chunks/add.mjs"),{runSync:n}=await import("./chunks/sync.mjs").then(function(c){return c.s}),i=D(d);if(i.length===0)throw new Error("Usage: docs-cache add [--source <repo> --target <dir>] <repo...>");const o=await s({configPath:t.config,entries:i});if(t.offline?t.json||r.line(`${g.warn} Offline: skipped sync`):await n({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json,lockOnly:t.lockOnly,offline:t.offline,failOnMiss:t.failOnMiss,sourceFilter:o.sources.map(c=>c.id),timeoutMs:t.timeoutMs}),t.json)a.stdout.write(`${JSON.stringify(o,null,2)}
+`);else{for(const c of o.sources){const y=c.repo.replace(/^https?:\/\//,"").replace(/\.git$/,""),v=c.targetDir?` ${l.dim("->")} ${l.magenta(c.targetDir)}`:"";r.item(g.success,c.id,`${l.blue(y)}${v}`)}o.skipped?.length&&r.line(`${g.warn} Skipped ${o.skipped.length} existing source${o.skipped.length===1?"":"s"}: ${o.skipped.join(", ")}`),r.line(`${g.info} Updated ${l.gray(w.relative(a.cwd(),o.configPath)||"docs.config.json")}`),o.gitignoreUpdated&&o.gitignorePath&&r.line(`${g.info} Updated ${l.gray(r.path(o.gitignorePath))}`)}return}if(e==="remove"){const{removeSources:s}=await import("./chunks/remove.mjs"),{pruneCache:n}=await import("./chunks/prune.mjs");if(h.length===0)throw new Error("Usage: docs-cache remove <id...>");const i=await s({configPath:t.config,ids:h});if(t.json)a.stdout.write(`${JSON.stringify(i,null,2)}
+`);else{if(i.removed.length>0&&r.line(`${g.success} Removed ${i.removed.length} source${i.removed.length===1?"":"s"}: ${i.removed.join(", ")}`),i.missing.length>0&&r.line(`${g.warn} Missing ${i.missing.length} source${i.missing.length===1?"":"s"}: ${i.missing.join(", ")}`),i.targetsRemoved.length>0){const o=i.targetsRemoved.map(c=>`${c.id} -> ${r.path(c.targetDir)}`).join(", ");r.line(`${g.success} Removed ${i.targetsRemoved.length} target${i.targetsRemoved.length===1?"":"s"}: ${o}`)}r.line(`${g.info} Updated ${l.gray(w.relative(a.cwd(),i.configPath)||"docs.config.json")}`)}t.prune&&await n({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json});return}if(e==="status"){const{getStatus:s,printStatus:n}=await import("./chunks/status.mjs"),i=await s({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json});t.json?a.stdout.write(`${JSON.stringify(i,null,2)}
+`):n(i);return}if(e==="clean"){const{cleanCache:s}=await import("./chunks/clean.mjs"),n=await s({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json});t.json?a.stdout.write(`${JSON.stringify(n,null,2)}
+`):n.removed?r.line(`${g.success} Removed cache at ${r.path(n.cacheDir)}`):r.line(`${g.info} Cache already missing at ${r.path(n.cacheDir)}`);return}if(e==="prune"){const{pruneCache:s}=await import("./chunks/prune.mjs"),n=await s({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json});t.json?a.stdout.write(`${JSON.stringify(n,null,2)}
+`):n.removed.length===0?r.line(`${g.info} No cache entries to prune.`):r.line(`${g.success} Pruned ${n.removed.length} cache entr${n.removed.length===1?"y":"ies"}: ${n.removed.join(", ")}`);return}if(e==="sync"){const{printSyncPlan:s,runSync:n}=await import("./chunks/sync.mjs").then(function(o){return o.s}),i=await n({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json,lockOnly:t.lockOnly,offline:t.offline,failOnMiss:t.failOnMiss,timeoutMs:t.timeoutMs});t.json?a.stdout.write(`${JSON.stringify(i,null,2)}
+`):s(i);return}if(e==="verify"){const{printVerify:s,verifyCache:n}=await import("./chunks/verify.mjs").then(function(o){return o.a}),i=await n({configPath:t.config,cacheDirOverride:t.cacheDir,json:t.json});t.json?a.stdout.write(`${JSON.stringify(i,null,2)}
+`):s(i),i.results.some(o=>!o.ok)&&a.exit(f.FatalError);return}if(e==="init"){const{initConfig:s}=await import("./chunks/init.mjs");if(t.config)throw new Error("Init does not accept --config. Use the project root.");const n=await s({cacheDirOverride:t.cacheDir,json:t.json});t.json?a.stdout.write(`${JSON.stringify(n,null,2)}
+`):(r.line(`${g.success} Wrote ${l.gray(r.path(n.configPath))}`),n.gitignoreUpdated&&n.gitignorePath&&r.line(`${g.info} Updated ${l.gray(r.path(n.gitignorePath))}`));return}r.line(`${u} ${e}: not implemented yet.`)};async function P(){try{a.on("uncaughtException",$),a.on("unhandledRejection",$);const e=j(),t=e.rawArgs;e.help&&(m(),a.exit(f.Success)),e.command||(m(),a.exit(f.InvalidArgument)),e.command!=="add"&&e.command!=="remove"&&e.positionals.length>0&&(p(`${u}: unexpected arguments.`),m(),a.exit(f.InvalidArgument)),e.command!=="add"&&e.options.targetDir&&(p(`${u}: --target-dir is only valid for add.`),m(),a.exit(f.InvalidArgument)),await S(e.command,e.options,e.positionals,e.rawArgs)}catch(e){$(e)}}function $(e){const t=e.message||String(e);p(t),a.exit(f.FatalError)}export{u as CLI_NAME,P as main};
 //# sourceMappingURL=cli.mjs.map

package/dist/shared/docs-cache.DgrUGcWv.mjs

@@ -0,0 +1,5 @@
+import{readFile as o,writeFile as f,access as P}from"node:fs/promises";import a from"node:path";import{t as p}from"./docs-cache.D9_kM5zq.mjs";const g=async n=>{try{return await P(n),!0}catch{return!1}},l=n=>{const r=n.trim();if(!r||r.startsWith("#")||r.startsWith("!"))return"";let t=r.replace(/^\//,"");return t=t.replace(/^\.\//,""),t=t.replace(/\/+$/,""),p(t)},d=(n,r)=>{const t=a.isAbsolute(r)?a.resolve(r):a.resolve(n,r),e=a.relative(n,t);return e===".."||e.startsWith(`..${a.sep}`)||a.isAbsolute(e)?null:e.length===0?".":e},u=async(n,r)=>{const t=a.resolve(n,".gitignore"),e=d(n,r);if(!e)return{gitignorePath:t,entry:null,hasEntry:!1};const i=l(e);if(!i)return{gitignorePath:t,entry:null,hasEntry:!1};let s="";await g(t)&&(s=await o(t,"utf8"));const h=s.split(/\r?\n/),c=new Set(h.map(y=>l(y)).filter(Boolean));return{gitignorePath:t,entry:`${i}/`,hasEntry:c.has(i)}},w=async(n,r)=>{const t=await u(n,r);if(!t.entry)return{updated:!1,gitignorePath:t.gitignorePath,entry:null};if(t.hasEntry)return{updated:!1,gitignorePath:t.gitignorePath,entry:t.entry};let e="";await g(t.gitignorePath)&&(e=await o(t.gitignorePath,"utf8"));const i=e.length===0||e.endsWith(`
+`)?"":`
+`,s=`${e}${i}${t.entry}
+`;return await f(t.gitignorePath,s,"utf8"),{updated:!0,gitignorePath:t.gitignorePath,entry:t.entry}};export{w as e,u as g};
+//# sourceMappingURL=docs-cache.DgrUGcWv.mjs.map

package/package.json

@@ -1,91 +1,94 @@
 {
-  "name": "docs-cache",
-  "private": false,
-  "type": "module",
-  "version": "0.1.3",
-  "description": "CLI for deterministic local caching of external documentation for agents and tools",
-  "author": "Frederik Bosch",
-  "license": "MIT",
-  "homepage": "https://github.com/fbosch/docs-cache#readme",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/fbosch/docs-cache.git"
-  },
-  "bugs": {
-    "url": "https://github.com/fbosch/docs-cache/issues"
-  },
-  "keywords": [
-    "docs",
-    "documentation",
-    "cache",
-    "agent",
-    "ai",
-    "git",
-    "cli"
-  ],
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18"
-  },
-  "bin": {
-    "docs-cache": "./bin/docs-cache.mjs"
-  },
-  "files": [
-    "bin",
-    "dist/cli.mjs",
-    "dist/chunks/*.mjs",
-    "dist/lock.mjs",
-    "dist/shared/*.mjs",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "@clack/prompts": "^1.0.0",
-    "cac": "^6.7.14",
-    "fast-glob": "^3.3.2",
-    "picocolors": "^1.1.1",
-    "picomatch": "^2.3.1",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.3.8",
-    "@size-limit/file": "^11.2.0",
-    "@types/node": "^24.2.1",
-    "bumpp": "^10.3.2",
-    "c8": "^10.1.3",
-    "jiti": "^2.5.1",
-    "lint-staged": "^16.2.7",
-    "simple-git-hooks": "^2.13.1",
-    "size-limit": "^11.2.0",
-    "tinybench": "^6.0.0",
-    "typescript": "^5.9.3",
-    "unbuild": "^3.6.1"
-  },
-  "size-limit": [
-    {
-      "path": "dist/cli.mjs",
-      "limit": "10 kB"
-    }
-  ],
-  "simple-git-hooks": {
-    "pre-commit": "pnpm lint-staged"
-  },
-  "lint-staged": {
-    "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
-      "biome check --write --no-errors-on-unmatched"
-    ]
-  },
-  "scripts": {
-    "build": "unbuild",
-    "dev": "unbuild --stub",
-    "lint": "biome check .",
-    "release": "pnpm run lint && pnpm run typecheck && bumpp && pnpm publish --access public",
-    "test": "pnpm build && node --test",
-    "test:coverage": "pnpm build && c8 --include dist --exclude bin --reporter=text node --test",
-    "bench": "pnpm build && node scripts/benchmarks/run.mjs",
-    "schema:build": "node scripts/generate-schema.mjs",
-    "size": "size-limit",
-    "test:watch": "node --test --watch",
-    "typecheck": "tsc --noEmit"
-  }
-}
+	"name": "docs-cache",
+	"private": false,
+	"type": "module",
+	"version": "0.1.4",
+	"packageManager": "pnpm@10.14.0+sha512.ad27a79641b49c3e481a16a805baa71817a04bbe06a38d17e60e2eaee83f6a146c6a688125f5792e48dd5ba30e7da52a5cda4c3992b9ccf333f9ce223af84748",
+	"description": "CLI for deterministic local caching of external documentation for agents and tools",
+	"author": "Frederik Bosch",
+	"license": "MIT",
+	"homepage": "https://github.com/fbosch/docs-cache#readme",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/fbosch/docs-cache.git"
+	},
+	"bugs": {
+		"url": "https://github.com/fbosch/docs-cache/issues"
+	},
+	"keywords": [
+		"docs",
+		"documentation",
+		"cache",
+		"agent",
+		"ai",
+		"git",
+		"cli"
+	],
+	"sideEffects": false,
+	"engines": {
+		"node": ">=18"
+	},
+	"bin": {
+		"docs-cache": "./bin/docs-cache.mjs"
+	},
+	"files": [
+		"bin",
+		"dist/cli.mjs",
+		"dist/chunks/*.mjs",
+		"dist/lock.mjs",
+		"dist/shared/*.mjs",
+		"README.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"build": "unbuild",
+		"dev": "unbuild --stub",
+		"lint": "biome check .",
+		"prepublishOnly": "pnpm audit --audit-level=high && pnpm build && pnpm size && pnpm schema:build",
+		"release": "pnpm run lint && pnpm run typecheck && bumpp && pnpm publish --access public",
+		"test": "pnpm build && node --test",
+		"test:coverage": "pnpm build && c8 --include dist --exclude bin --reporter=text node --test",
+		"bench": "pnpm build && node scripts/benchmarks/run.mjs",
+		"schema:build": "node scripts/generate-schema.mjs",
+		"size": "size-limit",
+		"test:watch": "node --test --watch",
+		"typecheck": "tsc --noEmit",
+		"prepare": "simple-git-hooks"
+	},
+	"dependencies": {
+		"@clack/prompts": "^1.0.0",
+		"cac": "^6.7.14",
+		"fast-glob": "^3.3.2",
+		"picocolors": "^1.1.1",
+		"picomatch": "^2.3.1",
+		"zod": "^4.3.6"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.3.8",
+		"@size-limit/file": "^11.2.0",
+		"@types/node": "^24.2.1",
+		"bumpp": "^10.3.2",
+		"c8": "^10.1.3",
+		"jiti": "^2.5.1",
+		"lint-staged": "^16.2.7",
+		"simple-git-hooks": "^2.13.1",
+		"size-limit": "^11.2.0",
+		"tinybench": "^6.0.0",
+		"typescript": "^5.9.3",
+		"unbuild": "^3.6.1"
+	},
+	"size-limit": [
+		{
+			"path": "dist/cli.mjs",
+			"limit": "10 kB"
+		}
+	],
+	"simple-git-hooks": {
+		"pre-commit": "pnpm lint-staged"
+	},
+	"lint-staged": {
+		"*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
+			"biome check --write --no-errors-on-unmatched"
+		]
+	}
+}