document360-engine 0.2.5 → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +3 -0
- package/dist/index.js +20 -20
- package/dist/lib/coalesce.d.ts +7 -0
- package/dist/orchestrate/partition.d.ts +33 -0
- package/dist/orchestrate/run.d.ts +78 -0
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -13,3 +13,6 @@ export * from './d360/client.js';
|
|
|
13
13
|
export * from './d360/apiLog.js';
|
|
14
14
|
export * from './sync/index.js';
|
|
15
15
|
export * from './scope/inventory.js';
|
|
16
|
+
export * from './orchestrate/partition.js';
|
|
17
|
+
export * from './orchestrate/run.js';
|
|
18
|
+
export * from './cost/estimate.js';
|
package/dist/index.js
CHANGED
|
@@ -1,28 +1,28 @@
|
|
|
1
|
-
import{readdirSync as
|
|
2
|
-
`,"utf8")}function
|
|
3
|
-
`,"utf8")}function
|
|
4
|
-
`,"utf8")}var
|
|
5
|
-
${n}`),
|
|
6
|
-
`,"utf8")}catch{}}var
|
|
7
|
-
`,"utf8"),!0}import{createHash as
|
|
1
|
+
import{readdirSync as ln,readFileSync as $t,existsSync as Ue,statSync as un}from"node:fs";import{join as Ne}from"node:path";import{query as dn}from"@anthropic-ai/claude-agent-sdk";import{existsSync as Jt}from"node:fs";import{isAbsolute as Gt,relative as Vt,resolve as We}from"node:path";var He=new Set(["Edit","Write","MultiEdit","NotebookEdit"]);function ge(e,t,r){let n=Gt(t)?t:We(e,t),o=Vt(e,n).replace(/\\/g,"/");return o===""||o.startsWith("..")?!1:/\.(md|markdown)$/i.test(o)||o===".d360-writer.json"||o==="d360-category-map.json"||o===".d360-writer"||o.startsWith(".d360-writer/")?!0:[r?.captureDir,r?.outputDir].filter(i=>typeof i=="string"&&i.length>0).map(i=>i.replace(/\\/g,"/").replace(/\/+$/,"")).some(i=>o===i||o.startsWith(`${i}/`))}var Kt=/^(\/dev\/null|nul|null)$/i,ne=e=>e.replace(/^['"]/,"").replace(/['"]$/,""),Yt=new Set(["rm","rmdir","mv","truncate","touch","mkdir","chmod","chown"]),Qt=new Set(["cp","ln","install"]);function ze(e,t,r){let n=i=>{let a=ne(i);return!a||a.startsWith("&")||a.startsWith("-")||Kt.test(a)?!1:!ge(t,a,r)},o=/(?:^|[^0-9>])>>?\s*("[^"]+"|'[^']+'|[^\s|&;<>]+)/g,s;for(;s=o.exec(e);)if(n(s[1]))return ne(s[1]);for(let i of e.split(/&&|\|\||[;|]/)){let a=i.trim().split(/\s+/).filter(Boolean);if(a.length===0)continue;let d=a[0].replace(/.*[/\\]/,""),u=a.slice(1),l=u.filter(f=>!f.startsWith("-")),p=[];Yt.has(d)?p=l:Qt.has(d)?p=l.slice(-1):d==="tee"?p=l:d==="dd"?p=u.filter(f=>f.startsWith("of=")).map(f=>f.slice(3)):(d==="sed"||d==="perl")&&u.some(f=>/^-i/.test(f)||f==="--in-place")&&(p=l.filter(f=>Jt(We(t,ne(f)))));for(let f of p)if(n(f))return ne(f)}return null}function he(e){return`Writer mode: "${e}" is outside the documentation scope (markdown, capture specs, d360 config). Note the needed change for the engineering team instead of making it. Repos that want the agent to modify source code set "mode": "engineer" in .d360-writer.json.`}import{homedir as Zt}from"node:os";import{join as U,dirname as Ge}from"node:path";import{fileURLToPath as Xt}from"node:url";import{existsSync as Ve,mkdirSync as er}from"node:fs";var tr=Xt(import.meta.url),Je=Ge(tr);function rr(){let e=Je;for(let t=0;t<4;t++){if(Ve(U(e,"package.json")))return e;e=Ge(e)}return U(Je,"..","..")}function Ke(){return U(rr(),"skills")}function A(){return U(Zt(),".document360-writer")}function ye(){return U(A(),"config.json")}function we(){return U(A(),"mcp.json")}function ke(){return U(A(),"sessions.json")}function be(e=process.cwd()){return U(e,".d360-writer.json")}function Ye(e=process.cwd()){return U(e,".d360-writer","skills")}function N(e){Ve(e)||er(e,{recursive:!0})}import{readFileSync as oe,writeFileSync as _e,existsSync as ve}from"node:fs";import{homedir as nr}from"node:os";import{join as or}from"node:path";var ee=class extends Error{};function Qe(e,t){if(!e?.profiles||Object.keys(e.profiles).length===0)throw new ee("No connection profiles in .d360-writer.json. This version requires a `profiles` map + `defaultProfile` (the old d360.environment/projectId shape is no longer supported). Run `d360-writer init` to scaffold the new shape.");let r=t??e.defaultProfile;if(!r)throw new ee(`No profile specified and no defaultProfile set. Available: ${Object.keys(e.profiles).join(", ")}`);let n=e.profiles[r];if(!n)throw new ee(`Unknown profile "${r}". Available: ${Object.keys(e.profiles).join(", ")}`);return{name:r,profile:n}}function W(e=process.cwd()){let t=be(e);return ve(t)?JSON.parse(oe(t,"utf8")):null}function Ze(e,t=process.cwd()){_e(be(t),JSON.stringify(e,null,2)+`
|
|
2
|
+
`,"utf8")}function Se(){let e=ye();if(!ve(e))return{};try{return JSON.parse(oe(e,"utf8"))}catch{return{}}}function so(e){N(A()),_e(ye(),JSON.stringify(e,null,2)+`
|
|
3
|
+
`,"utf8")}function sr(e,t,r,n){return e?{model:e,source:"project"}:t?{model:t,source:"user"}:r?{model:r,source:"env"}:n?{model:n,source:"claude-settings"}:{model:null,source:"claude-default"}}function ir(){try{let e=JSON.parse(oe(or(nr(),".claude","settings.json"),"utf8"));return typeof e.model=="string"&&e.model?e.model:void 0}catch{return}}function io(e=process.cwd()){return sr(W(e)?.defaultModel,Se().defaultModel,process.env.ANTHROPIC_MODEL,ir())}function Xe(){let e=we();if(!ve(e))return{servers:{}};try{return JSON.parse(oe(e,"utf8"))}catch{return{servers:{}}}}function ao(e){N(A()),_e(we(),JSON.stringify(e,null,2)+`
|
|
4
|
+
`,"utf8")}var se=class{resolvers=[];buffer=[];closed=!1;push(t){if(this.closed)return;let r={type:"user",message:{role:"user",content:t},parent_tool_use_id:null},n=this.resolvers.shift();n?n(r):this.buffer.push(r)}close(){this.closed=!0;for(let t of this.resolvers)t(null);this.resolvers=[]}async*[Symbol.asyncIterator](){for(;;){if(this.buffer.length>0){yield this.buffer.shift();continue}if(this.closed)return;let t=await new Promise(r=>this.resolvers.push(r));if(t===null)return;yield t}}};import{existsSync as nn,readFileSync as Dt,statSync as on}from"node:fs";import{basename as sn,isAbsolute as an,resolve as $e}from"node:path";import{createSdkMcpServer as cn,tool as S}from"@anthropic-ai/claude-agent-sdk";import{z as m}from"zod";import{createHash as ar,randomBytes as et}from"node:crypto";import{createServer as cr}from"node:http";import{spawn as Pe}from"node:child_process";var tt=600*1e3;function xe(e){return e.toString("base64").replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}function lr(e){let t=xe(et(32)),r=xe(ar("sha256").update(t).digest()),n=xe(et(16)),o=new URL(e.authorizationUrl);return o.searchParams.set("client_id",e.clientId),o.searchParams.set("response_type","code"),o.searchParams.set("redirect_uri",e.redirectUri),o.searchParams.set("scope",e.scopes.join(" ")),o.searchParams.set("state",n),o.searchParams.set("code_challenge",r),o.searchParams.set("code_challenge_method","S256"),e.acrValues&&o.searchParams.set("acr_values",e.acrValues),e.prompt&&o.searchParams.set("prompt",e.prompt),{url:o.toString(),verifier:t,state:n}}function ur(e){if(process.env.D360_NO_BROWSER)return;let t=process.platform;if(t==="win32"){let r=e.replace(/'/g,"''");Pe("powershell",["-NoProfile","-NonInteractive","-Command",`Start-Process '${r}'`],{detached:!0,stdio:"ignore"}).unref()}else t==="darwin"?Pe("open",[e],{detached:!0,stdio:"ignore"}).unref():Pe("xdg-open",[e],{detached:!0,stdio:"ignore"}).unref()}function dr(e,t){let r=new URL(e),n,o=new Promise((s,i)=>{let a=setTimeout(()=>{i(new Error(`Timed out after ${tt/6e4} minutes waiting for the browser login.`)),n.close()},tt);n=cr((d,u)=>{let l=new URL(d.url??"/",`http://${r.host}`);if(l.pathname!==r.pathname){u.writeHead(404).end();return}let p=l.searchParams.get("error"),f=l.searchParams.get("code"),y=l.searchParams.get("state"),_=h=>{u.writeHead(400,{"content-type":"text/html"}),u.end(`<html><body><h3>Login failed</h3><p>${h}</p><p>Return to the terminal.</p></body></html>`),clearTimeout(a),i(new Error(h)),n.close()};if(p)return _(`${p}: ${l.searchParams.get("error_description")??""}`);if(!f)return _("No authorization code in the callback.");if(y!==t)return _("State mismatch \u2014 possible CSRF; try again.");u.writeHead(200,{"content-type":"text/html"}),u.end("<html><body><h3>\u2713 Document360 login complete</h3><p>You can close this tab and return to the terminal.</p></body></html>"),clearTimeout(a),s(f),n.close()}),n.on("error",d=>{clearTimeout(a),i(new Error(`Could not listen on ${r.host} (${d.message}). Another process may hold the port \u2014 set D360_REDIRECT_URI to a free port and retry.`))}),n.listen(Number(r.port)||80,r.hostname)});return{server:n,result:o}}async function nt(e,t){let r=await fetch(e.tokenUrl,{method:"POST",headers:{"content-type":"application/x-www-form-urlencoded"},body:t}),n=await r.text();if(!r.ok)throw new Error(`Token endpoint ${r.status}: ${n.slice(0,400)}`);return JSON.parse(n)}async function rt(e,t,r){return nt(e,new URLSearchParams({grant_type:"authorization_code",code:t,redirect_uri:e.redirectUri,client_id:e.clientId,code_verifier:r}))}async function ot(e,t){return nt(e,new URLSearchParams({grant_type:"refresh_token",refresh_token:t,client_id:e.clientId}))}function st(e,t){let r=Date.now();return{profile:e,accessToken:t.access_token,refreshToken:t.refresh_token,idToken:t.id_token,scope:t.scope,obtainedAt:new Date(r).toISOString(),expiresAt:new Date(r+(t.expires_in??3600)*1e3).toISOString()}}async function mo(e,t,r){let{url:n,verifier:o,state:s}=lr(e);if(t.manual){r("Open this URL in a browser and sign in:"),r(n);let d=await t.promptForRedirect("Paste the full URL you were redirected to (it contains ?code=...):"),u=new URL(d.trim()),l=u.searchParams.get("code"),p=u.searchParams.get("state");if(!l)throw new Error("No code parameter found in the pasted URL.");if(p!==s)throw new Error("State mismatch in the pasted URL \u2014 restart the login.");return rt(e,l,o)}let{result:i}=dr(e.redirectUri,s);r("Opening your browser for Document360 sign-in\u2026"),r(`If it did not open, visit:
|
|
5
|
+
${n}`),ur(n);let a=await i;return rt(e,a,o)}import{existsSync as it,readFileSync as pr,unlinkSync as fr,writeFileSync as mr}from"node:fs";import{join as at}from"node:path";function ct(){return at(A(),"auth")}function Te(e){return at(ct(),`${e}.json`)}function lt(e){N(ct()),mr(Te(e.profile),JSON.stringify(e,null,2))}function ie(e){let t=Te(e);if(!it(t))return null;try{return JSON.parse(pr(t,"utf8"))}catch{return null}}function ko(e){let t=Te(e);return it(t)?(fr(t),!0):!1}function Re(e,t=60){return Date.now()>=new Date(e.expiresAt).getTime()-t*1e3}function ut(e){if(!e)return null;let t=e.split(".");if(t.length!==3)return null;try{let r=Buffer.from(t[1].replace(/-/g,"+").replace(/_/g,"/"),"base64").toString("utf8");return JSON.parse(r)}catch{return null}}function dt(e,t,r){let n=e.get(t);if(n)return n;let o=r().finally(()=>{e.get(t)===o&&e.delete(t)});return e.set(t,o),o}import{appendFileSync as gr,readdirSync as hr,unlinkSync as yr}from"node:fs";import{join as Ce}from"node:path";var wr=14,kr=4096;function br(){return Ce(A(),"logs")}function _r(e){return e.replace(/Bearer\s+[A-Za-z0-9._~+/=-]{8,}/g,"Bearer [redacted]").replace(/eyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{5,}\.[A-Za-z0-9_-]+/g,"[redacted-jwt]")}function vr(e,t=kr){return e.length<=t?e:`${e.slice(0,t)}\u2026 [+${e.length-t} chars]`}function ae(e){return e===void 0?void 0:vr(_r(e))}var je=()=>process.env.D360_LOG_BODIES==="1",Sr=/^d360-api-(\d{4}-\d{2}-\d{2})\.jsonl$/;function Pr(e){let t=new Date(Date.now()-wr*24*60*60*1e3).toISOString().slice(0,10);for(let r of hr(e)){let n=r.match(Sr);if(n&&n[1]<t)try{yr(Ce(e,r))}catch{}}}var pt=!1;function Ee(e){try{let t=br();N(t),pt||(pt=!0,Pr(t));let r=Ce(t,`d360-api-${e.ts.slice(0,10)}.jsonl`);gr(r,JSON.stringify(e)+`
|
|
6
|
+
`,"utf8")}catch{}}var xr=new Map,L=class extends Error{},ce=class extends Error{constructor(r,n,o){super(r);this.status=n;this.requestId=o}status;requestId};async function ft(e){let t=ie(e.profile);if(!t)throw new L(`Not logged in to Document360 (profile "${e.profile}"). Run /login (or: d360-writer login --profile ${e.profile})`);if(!Re(t))return t.accessToken;if(!t.refreshToken)throw new L(`Document360 session expired (profile "${e.profile}"). Run /login (or: d360-writer login --profile ${e.profile})`);return dt(xr,e.profile,async()=>{let r=ie(e.profile);if(r&&!Re(r))return r.accessToken;let n=r?.refreshToken??t.refreshToken;try{let o=st(e.profile,await ot(e.connection,n));return lt(o),o.accessToken}catch(o){throw new L(`Document360 session expired and refresh failed (${o.message.slice(0,120)}). Run /login (or: d360-writer login --profile ${e.profile})`)}})}function V(e,t){if(t)return t;let r=ie(e.profile),o=(r?ut(r.accessToken)??{}:{}).doc360_project_id;if(typeof o=="string"&&o)return o;throw new L("No Document360 project resolved. Log in (the project is chosen during login) or set the profile's project.projectId in .d360-writer.json.")}async function le(e,t,r,n={}){let o=await ft(e),s=new URL(r.startsWith("http")?r:`${e.connection.apiUrl}${r}`);for(let[f,y]of Object.entries(n.query??{}))y!==void 0&&s.searchParams.set(f,String(y));let i=n.body!==void 0?JSON.stringify(n.body):void 0,a=Date.now(),d=f=>Ee({ts:new Date().toISOString(),profile:e.profile,method:t,url:s.toString(),ms:Date.now()-a,ok:f.ok,status:f.status,requestId:f.requestId,error:f.error,...f.withBodies?{requestBody:ae(i),responseBody:ae(f.responseBody)}:{}}),u;try{u=await fetch(s,{method:t,headers:{authorization:`Bearer ${o}`,accept:"application/json",...i!==void 0?{"content-type":"application/json"}:{}},body:i})}catch(f){throw d({ok:!1,error:`network: ${f.message}`,withBodies:!0}),f}let l=await u.text(),p={};if(l)try{p=JSON.parse(l)}catch{}if(!u.ok||p.success===!1){let f=p.errors?.map(_=>_.message??_.code).filter(Boolean).join("; ")||l.slice(0,300)||u.statusText;if(d({ok:!1,status:u.status,requestId:p.request_id,error:f,responseBody:l,withBodies:!0}),u.status===401)throw new L(`Document360 rejected the token (401). Run /login (or: d360-writer login --profile ${e.profile})`);let y=p.request_id?` [request_id: ${p.request_id}]`:"";throw new ce(`Document360 API ${u.status}: ${f}${y}`,u.status,p.request_id)}return d({ok:!0,status:u.status,requestId:p.request_id,responseBody:l,withBodies:je()}),p}async function M(e,t,r){return(await le(e,"GET",t,r)).data}async function K(e,t,r){return(await le(e,"POST",t,r)).data}async function mt(e,t,r){return(await le(e,"PATCH",t,r)).data}async function gt(e,t,r){let n=await ft(e),o=`${e.connection.apiUrl}${t}`,s=Date.now(),i=l=>Ee({ts:new Date().toISOString(),profile:e.profile,method:"POST",url:o,ms:Date.now()-s,ok:l.ok,status:l.status,requestId:l.requestId,error:l.error,...l.withBodies?{requestBody:"[multipart form-data]",responseBody:ae(l.responseBody)}:{}}),a;try{a=await fetch(o,{method:"POST",headers:{authorization:`Bearer ${n}`,accept:"application/json"},body:r})}catch(l){throw i({ok:!1,error:`network: ${l.message}`,withBodies:!0}),l}let d=await a.text(),u={};if(d)try{u=JSON.parse(d)}catch{}if(!a.ok||u.success===!1){let l=u.errors?.map(f=>f.message??f.code).filter(Boolean).join("; ")||d.slice(0,300)||a.statusText;if(i({ok:!1,status:a.status,requestId:u.request_id,error:l,responseBody:d,withBodies:!0}),a.status===401)throw new L(`Document360 rejected the token (401). Run /login (or: d360-writer login --profile ${e.profile})`);let p=u.request_id?` [request_id: ${u.request_id}]`:"";throw new ce(`Document360 upload ${a.status}: ${l}${p}`,a.status,u.request_id)}return i({ok:!0,status:a.status,requestId:u.request_id,responseBody:d,withBodies:je()}),u.data}async function B(e,t,r={}){let n=[],o;for(let s=0;s<50;s++){let i=await le(e,"GET",t,{...r,query:{...r.query,cursor:o}});if(Array.isArray(i.data)&&n.push(...i.data),!i.pagination?.has_more||!i.pagination.next_cursor)break;o=i.pagination.next_cursor}return n}async function Eo(e,t){return B(e,`/v3/projects/${t}/workspaces`)}async function Do(e,t,r){return M(e,`/v3/projects/${t}/articles/${r}`,{query:{content_mode:"raw"}})}import{existsSync as Tr,readFileSync as Rr,writeFileSync as Cr}from"node:fs";import{join as jr}from"node:path";function ht(e){return jr(e,"d360-category-map.json")}function yt(e){let t=ht(e);if(!Tr(t))return null;try{return JSON.parse(Rr(t,"utf8"))}catch{return null}}function wt(e){return typeof e=="string"?{id:e}:{...e}}function O(e,t){let n=yt(e)?.[t];if(!n)return null;let o={};for(let[s,i]of Object.entries(n.articles??{}))o[s]=wt(i);return{environment:n.environment,projectId:n.projectId,workspaceId:n.workspaceId,lastAnalyzedCommit:n.lastAnalyzedCommit,categories:{...n.categories??{}},articles:o}}function kt(e,t){for(let[r,n]of Object.entries(e.articles))if(n.id===t)return r;return null}function ue(e,t,r,n){let o=yt(e),s=o?.[t];if(!o||!s)return!1;s.articles??={};let i=s.articles[r],a=i!==void 0?wt(i):null;return s.articles[r]={...a??{},...n,lastSyncedAt:new Date().toISOString()},Cr(ht(e),JSON.stringify(o,null,2)+`
|
|
7
|
+
`,"utf8"),!0}import{createHash as Er}from"node:crypto";function Dr(e){let t=e.replace(/^\uFEFF/,"").replace(/\r\n/g,`
|
|
8
8
|
`);return t=t.replace(/\n*$/,""),t===""?"":t+`
|
|
9
|
-
`}function
|
|
10
|
-
${t??""}`)}import{existsSync as Dr,readdirSync as Er,readFileSync as Ar,statSync as Ir}from"node:fs";import{join as Re}from"node:path";var wt={berlin:{apiUrl:"https://apihub.berlin.document360.net",portalUrl:"https://portal.berlin.document360.net",authorizationUrl:"https://identity.berlin.document360.net/connect/authorize",tokenUrl:"https://identity.berlin.document360.net/connect/token",clientId:"d360WriterAgentClient",scopes:["openid","profile","email","customerApi","offline_access"],acrValues:"project_select",redirectUri:"http://127.0.0.1:3223/callback",prompt:"login"},sharjah:{apiUrl:"https://apihub.sharjah.document360.net",portalUrl:"https://portal.sharjah.document360.net",authorizationUrl:"https://identity.sharjah.document360.net/connect/authorize",tokenUrl:"https://identity.sharjah.document360.net/connect/token",clientId:"d360WriterAgentClient",scopes:["openid","profile","email","customerApi","offline_access"],acrValues:"project_select",redirectUri:"http://127.0.0.1:3223/callback",prompt:"login"}};function jr(){return Object.keys(wt)}function jo(e="berlin"){return ce({environment:e})}function ce(e){let t=e.environment??"berlin",r=wt[t];if(!r)throw new Error(`Unknown Document360 environment "${t}". Known: ${jr().join(", ")}`);let n=process.env.D360_SCOPES?.split(/[\s,]+/).filter(Boolean);return{name:t,apiUrl:process.env.D360_API_URL??e.apiUrl??r.apiUrl,portalUrl:process.env.D360_PORTAL_URL??e.portalUrl??r.portalUrl,authorizationUrl:process.env.D360_AUTHORIZATION_URL??e.authorizationUrl??r.authorizationUrl,tokenUrl:process.env.D360_TOKEN_URL??e.tokenUrl??r.tokenUrl,clientId:process.env.D360_CLIENT_ID??e.clientId??r.clientId,scopes:n??e.scopes??r.scopes,acrValues:process.env.D360_ACR_VALUES??e.acrValues??r.acrValues,redirectUri:process.env.D360_REDIRECT_URI??e.redirectUri??r.redirectUri,prompt:process.env.D360_PROMPT??e.prompt??r.prompt}}function W(e,t){let r=N(e);if(r===null){let s=t??"berlin";return{name:s,connection:ce({environment:s}),project:{},production:!1}}let{name:n,profile:o}=Ke(r,t);return{name:n,connection:ce(o.connection),project:o.project??{},production:o.production===!0}}function Ao(e,t,r){let n=N(e);n?.profiles?.[t]&&(n.profiles[t].project={...n.profiles[t].project,...r},Ye(n,e))}function kt(e,t){if(e?.docsDir)return e.docsDir.replace(/\\/g,"/").replace(/\/+$/,"");let r=new Set(Object.keys(t?.articles??{}).map(n=>n.split("/")[0]).filter(Boolean));if(r.size===1)return[...r][0];throw new Error(r.size===0?'Cannot locate the docs folder: no mapped articles yet. Set "docsDir" in .d360-writer.json.':`Cannot locate the docs folder: mapped articles span multiple roots (${[...r].join(", ")}). Set "docsDir" in .d360-writer.json.`)}var Rr=4;function _t(e,t,r,n={getAll:O,get:D}){let o=`/v3/projects/${t}`;return{async fetch(s){let[i,c]=await Promise.all([n.getAll(e,`${o}/workspaces/${r}/articles`),n.getAll(e,`${o}/workspaces/${r}/categories`)]),d=new Map;for(let h of i)d.set(h.id,{id:h.id,title:h.title,categoryId:h.category_id,hidden:h.hidden});let u=new Map;for(let h of c)u.set(h.id,{id:h.id,name:h.name,parentId:h.parent_category_id});let l=s.filter(h=>d.has(h)),p=0,f=async()=>{for(;p<l.length;){let h=l[p++],_=await n.get(e,`${o}/articles/${h}`,{query:{content_mode:"raw"}}),b=d.get(h);b.title=_.title??b.title,b.content=_.content,b.latestVersion=_.latest_version,b.modifiedAt=_.modified_at,b.contentHash=z(_.title??b.title,_.content)}};return await Promise.all(Array.from({length:Math.min(Rr,l.length)},f)),{articles:d,categories:u}}}}function Mr(e){if(!e.mapped)return e.localExists?"untracked-local":"untracked-remote";if(!e.localExists&&!e.remoteExists)return"orphaned";if(!e.localExists)return"deleted-local";if(!e.remoteExists)return"deleted-remote";if(!e.hasBase)return"unknown-base";let t=e.localHashNow!==e.baseLocalHash,r=e.remoteContentHashNow!==e.baseRemoteContentHash;return t&&r?"conflict":t?"local-ahead":r?"remote-ahead":"in-sync"}function Or(e,t){let r=Re(e,t);if(!Dr(r))return[];let n=[],o=(s,i)=>{for(let c of Er(s)){let d=Re(s,c),u=i?`${i}/${c}`:c;Ir(d).isDirectory()?o(d,u):c.endsWith(".md")&&n.push(u)}};return o(r,t.replace(/\\/g,"/")),n}function $r(e,t){let r=new Set(Object.values(e.categories)),n=new Map;for(let i of t.categories.values()){if(!i.parentId)continue;let c=n.get(i.parentId)??[];c.push(i.id),n.set(i.parentId,c)}let o=new Set,s=[...r];for(;s.length>0;){let i=s.shift();o.has(i)||(o.add(i),s.push(...n.get(i)??[]))}return o}async function bt(e){let t=W(e.cwd,e.profileName),r=N(e.cwd),n=B(e.cwd,t.name);if(!n)throw new Error(`No d360-category-map.json section for profile "${t.name}". Publish at least one article first (/publish).`);let o={profile:t.name,connection:t.connection},s=n.projectId??t.project.projectId??F(o),i=n.workspaceId??t.project.workspaceId;if(!i)throw new Error(`No workspace recorded for profile "${t.name}". Run /workspace to select one.`);let c=kt(r,n),d=Object.values(n.articles).map(v=>v.id),l=await(e.provider??_t(o,s,i)).fetch(d),p=new Set(Or(e.cwd,c)),f=[];for(let[v,$]of Object.entries(n.articles)){let X=p.has(v);p.delete(v);let E=l.articles.get($.id),pe=!!($.localHash&&$.remoteContentHash),V=Mr({mapped:!0,localExists:X,remoteExists:E!==void 0,hasBase:pe,localHashNow:X?L(Ar(Re(e.cwd,v),"utf8")):void 0,baseLocalHash:$.localHash,remoteContentHashNow:E?.contentHash,baseRemoteContentHash:$.remoteContentHash}),J=[];if(V==="remote-ahead"||V==="conflict"){let ee=E?.modifiedAt?.slice(0,10);J.push(`remote edited${ee?` ${ee}`:""}${E?.latestVersion?` (v${E.latestVersion})`:""}`)}E?.hidden&&J.push("hidden on D360"),f.push({path:v,articleId:$.id,title:E?.title,status:V,detail:J.length>0?J.join("; "):void 0})}for(let v of[...p].sort())f.push({path:v,articleId:null,status:"untracked-local"});let h=new Set(d),_=$r(n,l);for(let v of l.articles.values())h.has(v.id)||!v.categoryId||!_.has(v.categoryId)||f.push({path:null,articleId:v.id,title:v.title,status:"untracked-remote",detail:v.hidden?"hidden on D360":void 0});let b={};for(let v of f)b[v.status]=(b[v.status]??0)+1;return{profile:t.name,projectId:s,workspaceId:i,docsRoot:c,entries:f,counts:b,generatedAt:new Date().toISOString()}}import{posix as De}from"node:path";var Ur=/\[([^\]]+)\]\(([^)\s]+)\)/g;function Ee(e,t,r){if(!r)return{content:e,resolved:0,unresolved:0};let n=De.dirname(t.replace(/\\/g,"/")),o=0,s=0;return{content:e.replace(Ur,(c,d,u)=>{if(/^(https?:|mailto:|#|\/)/i.test(u)||!/\.(md|markdown)(#[^)]*)?$/i.test(u))return c;let l=u.indexOf("#"),p=l===-1?u:u.slice(0,l),f=l===-1?"":u.slice(l),h=De.normalize(De.join(n,p)).replace(/^\.\//,""),_=r.articles[h]?.url;return _?(o++,`[${d}](${_}${f})`):(s++,d)}),resolved:o,unresolved:s}}import{readdirSync as Nr}from"node:fs";import{join as le}from"node:path";var Br=new Set([".git","node_modules","dist","build","bin","obj","out","target",".vs",".vscode",".idea",".next","coverage",".turbo",".cache","packages"]),Lr=40,qr=3,Ae=5e3,Fr=/\.(csproj|vbproj|fsproj)$|^(package\.json|go\.mod|Cargo\.toml|pyproject\.toml|setup\.py|pom\.xml|build\.gradle(\.kts)?)$/i,Hr=/\.sln$|^(Directory\.(Build|Packages)\.props|global\.json|go\.work)$/i;function zr(e){return/\.(csproj|vbproj|fsproj|sln)$/i.test(e)||/^(Directory\.(Build|Packages)\.props|global\.json)$/i.test(e)?".NET":/^(package\.json|angular\.json|tsconfig\.json)$/i.test(e)?"JS/TS":/^(pyproject\.toml|requirements\.txt|setup\.py)$/i.test(e)?"Python":/^(go\.mod|go\.work)$/i.test(e)?"Go":/^Cargo\.toml$/i.test(e)?"Rust":/^(pom\.xml|build\.gradle(\.kts)?)$/i.test(e)?"Java":null}var Wr=/(?:^|[.\-_])(web|portal|ui|app|apps|client|site|widget|admin|dashboard|frontend|api)(?:$|[.\-_])/i,Jr=/(?:^|[.\-_])(tests?|specs?|helm|docker|migrations?|functions?|ci|builds?|scripts|tools|proxy|coverage|release|libs?|redis|signalr|websocket|dataaccess|nuget|sdk|infra|infrastructure|deploy|deployment|e2e)(?:$|[.\-_])/i;function Ie(e){let t=[],r=[];try{for(let n of Nr(e,{withFileTypes:!0}))n.isDirectory()?!n.name.startsWith(".")&&!Br.has(n.name)&&t.push(n.name):n.isFile()&&r.push(n.name)}catch{}return{dirs:t,files:r}}function Gr(e){let t=new Set;for(let r of e){let n=zr(r);n&&t.add(n)}return t}var vt=e=>e.some(t=>Fr.test(t)),Vr=e=>e.some(t=>Hr.test(t));function Kr(e){let t=0,r=n=>{if(t>=Ae)return;let{dirs:o,files:s}=Ie(n);t+=s.length;for(let i of o){if(t>=Ae)return;r(le(n,i))}};return r(e),Math.min(t,Ae)}function Yr(e,t){let r=e.split("/").pop()??e,n=t.size?[...t].join("+"):"";return Jr.test(r)?{recommended:!1,reason:`tests/infrastructure${n?` \xB7 ${n}`:""}`}:Wr.test(r)?{recommended:!0,reason:`user-facing surface${n?` \xB7 ${n}`:""}`}:{recommended:!1,reason:n?`${n} project`:"source folder"}}function St(e){let t=[],r=(s,i)=>{let c=Gr(i.files),{recommended:d,reason:u}=Yr(s,c);t.push({path:s,fileCount:Kr(le(e,s)),stacks:[...c],recommended:d,reason:u})},n=(s,i)=>{let c=s?le(e,s):e,d=Ie(c);if(s&&vt(d.files)){r(s,d);return}if(s&&d.dirs.length===0){r(s,d);return}let u=p=>vt(Ie(le(c,p)).files);if((Vr(d.files)||d.dirs.some(u)||s==="")&&i<qr){for(let p of d.dirs)n(s?`${s}/${p}`:p,i+1);return}s&&r(s,d)};n("",0),t.sort((s,i)=>Number(i.recommended)-Number(s.recommended)||s.path.localeCompare(i.path));let o=t.filter(s=>s.recommended);return t.slice(0,Math.max(Lr,o.length))}var Q={"claude-fable-5":{inputPerMTok:10,outputPerMTok:50},"claude-opus-4-8":{inputPerMTok:5,outputPerMTok:25},"claude-opus-4-7":{inputPerMTok:5,outputPerMTok:25},"claude-opus-4-6":{inputPerMTok:5,outputPerMTok:25},"claude-opus-4-5":{inputPerMTok:5,outputPerMTok:25},"claude-sonnet-4-6":{inputPerMTok:3,outputPerMTok:15},"claude-sonnet-4-5":{inputPerMTok:3,outputPerMTok:15},"claude-haiku-4-5":{inputPerMTok:1,outputPerMTok:5}},xt="claude-opus-4-8";function Pt(e){if(e&&Q[e])return{model:e,rate:Q[e],assumed:!1};if(e){let t=Object.keys(Q).filter(r=>e.startsWith(r)).sort((r,n)=>n.length-r.length)[0];if(t)return{model:t,rate:Q[t],assumed:!1}}return{model:xt,rate:Q[xt],assumed:!0}}function Z(e,t){return e/1e6*t}var Qr=3.5,Zr={convert:{in:1.3,out:1.1,outFloor:0},rewrite:{in:1.4,out:1.2,outFloor:0},publish:{in:1.1,out:.2,outFloor:200},audit:{in:1.2,out:.15,outFloor:0}},Tt=.7,Ct=1.5,ue=e=>Math.round(e);function jt(e){let{op:t,model:r}=e,n=Zr[t],{model:o,rate:s,assumed:i}=Pt(r),c=e.files.filter(b=>!(b.bytes>0)).map(b=>b.path),d=e.files.filter(b=>b.bytes>0),u=0,l=0;for(let b of d){let v=b.bytes/Qr;u+=v*n.in,l+=Math.max(v*n.out,n.outFloor)}let p=[ue(u*Tt),ue(u*Ct)],f=[ue(l*Tt),ue(l*Ct)],h=[Z(p[0],s.inputPerMTok)+Z(f[0],s.outputPerMTok),Z(p[1],s.inputPerMTok)+Z(f[1],s.outputPerMTok)],_=`Rough estimate from file sizes, priced at ${o} list rates`+(i?" (model unset \u2014 assumed)":"")+". Actuals vary with cache reuse and reasoning depth; the live cost meter reconciles as the run proceeds.";return{model:o,modelAssumed:i,op:t,articles:d.length,skipped:c,inputTokens:p,outputTokens:f,usd:h,note:_}}var Dt="/v3/projects",P=e=>`${Dt}/${e}`;function x(e){return{content:[{type:"text",text:JSON.stringify(e,null,2)??'{"success":true}'}]}}function k(e){return{content:[{type:"text",text:e instanceof Error?e.message:String(e)}],isError:!0}}function Et(e,t){let r={profile:e.name,connection:e.connection},n=e.project.projectId,o=e.project.workspaceId,s=()=>F(r,n),i=a=>{let g=a??o;if(!g)throw new Error("No workspace_id given and none in the profile. Call d360_list_workspaces first.");return g},c=(a,g)=>{if(t.cwd)try{let y=Me(t.cwd,a);ae(t.cwd,e.name,a.replace(/\\/g,"/"),{...g,...Xr(y)?{localHash:L(Rt(y,"utf8"))}:{}})}catch{}},d=()=>t.writesAllowed?null:k(`Refusing to write to PRODUCTION profile "${e.name}". Authorize this session first: run /allow-prod in the REPL, or pass --yes in one-shot/CI.`),u=S("d360_context","Report the active Document360 connection: profile name, environment, project/workspace id, and whether it is a production profile. Call this before maintaining d360-category-map.json so you scope IDs to the right profile.",{},async()=>{try{return x({profile:e.name,environment:e.connection.name,production:e.production,projectId:n??F(r),workspaceId:o??null})}catch(a){return k(a)}}),l=S("d360_list_projects","List all Document360 projects the signed-in user can access (id, name, sub-domain, status).",{},async()=>{try{return x(await O(r,Dt))}catch(a){return k(a)}}),p=S("d360_list_workspaces","List workspaces (project versions) for the current project. Each has id, name, slug, is_default, workspace_type.",{project_id:m.string().optional().describe("Defaults to the logged-in/config project.")},async a=>{try{return x(await O(r,`${P(a.project_id??s())}/workspaces`))}catch(g){return k(g)}}),f=S("d360_list_categories","List categories in a workspace (the folder structure for articles).",{workspace_id:m.string().optional().describe("Defaults to d360.workspaceId in config."),project_id:m.string().optional()},async a=>{try{let g=a.workspace_id??o;return g?x(await O(r,`${P(a.project_id??s())}/workspaces/${g}/categories`)):k("No workspace_id given and none in config. Call d360_list_workspaces first.")}catch(g){return k(g)}}),h=S("d360_list_articles","List articles in a workspace (id, title, status, category). Use to see existing docs before writing.",{workspace_id:m.string().optional().describe("Defaults to d360.workspaceId in config."),project_id:m.string().optional()},async a=>{try{let g=a.workspace_id??o;return g?x(await O(r,`${P(a.project_id??s())}/workspaces/${g}/articles`)):k("No workspace_id given and none in config. Call d360_list_workspaces first.")}catch(g){return k(g)}}),_=S("d360_get_article","Get a single article including its content. content_mode=raw returns the stored markdown source (best for editing); display returns processed content.",{article_id:m.string(),content_mode:m.enum(["raw","display"]).optional().describe("raw = stored markdown source (default), display = processed."),published:m.boolean().optional().describe("Read the published version instead of the latest draft."),project_id:m.string().optional()},async a=>{try{return x(await D(r,`${P(a.project_id??s())}/articles/${a.article_id}`,{query:{content_mode:a.content_mode,published:a.published}}))}catch(g){return k(g)}}),b=S("d360_ai_query","Ask Document360's AI search over a workspace's published content. Returns an answer grounded in existing articles \u2014 use to check what's already documented.",{query:m.string(),workspace_id:m.string().optional().describe("Defaults to d360.workspaceId in config."),project_id:m.string().optional()},async a=>{try{let g=a.workspace_id??o;return g?x(await H(r,`${P(a.project_id??s())}/workspaces/ai/query`,{body:{query:a.query,workspace_id:g}})):k("No workspace_id given and none in config. Call d360_list_workspaces first.")}catch(g){return k(g)}}),v=S("d360_sync_status","Deterministic drift report: local docs tree vs Document360, classified against the sync bases in d360-category-map.json. Call this BEFORE any docs gap/coverage analysis \u2014 it proves whether the local docs tree can be trusted as the Document360 inventory (no need to fetch article content). Statuses: local-ahead (push pending), remote-ahead (portal edit to pull), conflict, untracked-local/remote, deleted-local/remote, unknown-base (no base recorded yet).",{},async()=>{try{if(!t.cwd)return k("Sync status needs a repo context (no cwd configured for this session).");let a=await bt({cwd:t.cwd,profileName:e.name});return x({profile:a.profile,docsRoot:a.docsRoot,generatedAt:a.generatedAt,counts:a.counts,attention:a.entries.filter(g=>g.status!=="in-sync")})}catch(a){return k(a)}}),$=S("d360_repo_inventory","Deterministic inventory of candidate source folders for documentation scope (no file reads of your own needed). Returns project-level folders with: path, fileCount, detected stacks, a `recommended` flag (user-facing surfaces pre-recommended; tests/infrastructure not), and a one-line reason. Use this when analyzing a large/multi-project repo to decide which folders back the docs \u2014 it is the same data the /scope picker pre-ticks, so your recommendation and the picker agree. Cheap; safe to call before reading any source.",{},async()=>{try{return t.cwd?x(St(t.cwd)):k("Repo inventory needs a repo context (no cwd configured for this session).")}catch(a){return k(a)}}),X=S("d360_estimate_cost",'Deterministic, no-network token/cost ESTIMATE for a bulk operation. Call this BEFORE you propose a repo-scale run (convert / rewrite / publish / audit MANY articles) so you can show the user the article count and a cost band and get an explicit go-ahead \u2014 see the "Confirm before bulk or irreversible actions" rule. It sizes work from local file BYTES (coarse \u2014 returns [low, high] bands, not a quote). Omit `paths` to estimate over every article tracked in d360-category-map.json; pass `paths` for a subset. Cheap and read-only; safe to call before any write.',{op:m.enum(["convert","rewrite","publish","audit"]).describe("What you intend to do to each article (drives the output-size heuristic)."),paths:m.array(m.string()).optional().describe("Repo-relative .md paths. Omit or leave empty to estimate over all articles in the category map.")},async({op:a,paths:g})=>{try{if(!t.cwd)return k("Cost estimate needs a repo context (no cwd configured for this session).");let y;if(g&&g.length>0)y=g.map(w=>w.replace(/\\/g,"/"));else{let w=B(t.cwd,e.name);if(y=w?Object.keys(w.articles):[],y.length===0)return k("No articles are tracked in d360-category-map.json for this profile, and no `paths` were given. Pass `paths` explicitly (the repo-relative .md files you intend to operate on).")}let T=y.map(w=>{let C=0;try{C=en(Me(t.cwd,w)).size}catch{C=0}return{path:w,bytes:C}});return x(jt({files:T,op:a,model:t.model}))}catch(y){return k(y)}}),E=S("d360_create_category","Create a category (a docs folder). Returns the new category id.",{name:m.string(),workspace_id:m.string().optional(),parent_category_id:m.string().optional().describe("Omit for a top-level category."),content:m.string().optional(),slug:m.string().optional(),order:m.number().optional(),project_id:m.string().optional()},async a=>{let g=d();if(g)return g;try{return x(await H(r,`${P(a.project_id??s())}/categories`,{body:{name:a.name,workspace_id:i(a.workspace_id),parent_category_id:a.parent_category_id,content:a.content,slug:a.slug,order:a.order,content_type:"markdown"}}))}catch(y){return k(y)}}),pe=S("d360_create_article","Create a DRAFT article in a category. The body is always Markdown (product rule \u2014 we never create WYSIWYG/Block articles). Returns the new article id. Does not publish.",{title:m.string(),category_id:m.string(),content:m.string().optional().describe("Markdown body."),workspace_id:m.string().optional(),slug:m.string().optional(),order:m.number().optional(),project_id:m.string().optional(),local_path:m.string().optional().describe("Repo-relative path of the local .md this article mirrors (e.g. user-docs/01-intro/01-a.md). When given, the new article id + sync base are recorded into d360-category-map.json automatically \u2014 do not edit the articles map yourself.")},async a=>{let g=d();if(g)return g;try{let y=a.project_id??s(),T=a.content;typeof T=="string"&&a.local_path&&t.cwd&&(T=Ee(T,a.local_path,B(t.cwd,e.name)).content);let w=await H(r,`${P(y)}/articles/bulk`,{body:{articles:[{title:a.title,category_id:a.category_id,workspace_id:i(a.workspace_id),content:T,slug:a.slug,order:a.order,content_type:"markdown"}]}}),C=Array.isArray(w)?w[0]:void 0;if(a.local_path&&typeof C?.id=="string"){let R;try{let U=await D(r,`${P(y)}/articles/${C.id}`,{});R=typeof U?.url=="string"?U.url:void 0}catch{}c(a.local_path,{id:C.id,remoteContentHash:z(a.title,T),remoteVersion:1,...R?{url:R}:{}})}return x(w)}catch(y){return k(y)}}),V=S("d360_update_article","Update an article's title/content/category. Edits the latest draft by default; set auto_fork to safely edit a published article (creates a new draft version).",{article_id:m.string(),title:m.string().optional(),content:m.string().optional().describe("Markdown body."),category_id:m.string().optional(),hidden:m.boolean().optional(),version_number:m.number().optional(),auto_fork:m.boolean().optional().describe("If the target version is published, fork a new draft instead of erroring."),project_id:m.string().optional()},async a=>{let g=d();if(g)return g;try{let{article_id:y,project_id:T,...w}=a,C=T??s(),R=typeof w.content=="string"&&t.cwd?B(t.cwd,e.name):null,U=R?yt(R,y):null;typeof w.content=="string"&&U&&R&&(w.content=Ee(w.content,U,R).content);let q=null;if(typeof w.content=="string"&&t.onUiEvent)try{q=await D(r,`${P(C)}/articles/${y}`,{query:{content_mode:"raw"}})}catch{}let Ne=e.project.languageCode??q?.lang_code,Be=await pt(r,`${P(C)}/articles/${y}`,{body:w,...Ne?{query:{lang_code:Ne}}:{}});if(q&&typeof w.content=="string"&&(q.content??"")!==w.content&&t.onUiEvent?.({type:"article_diff",articleId:y,title:q.title??null,oldContent:q.content??"",newContent:w.content}),typeof w.content=="string"&&U)try{let K=Be,Le=w.title??K?.title??q?.title;typeof Le=="string"&&c(U,{id:y,remoteContentHash:z(Le,w.content),...typeof K?.latest_version=="number"?{remoteVersion:K.latest_version}:{},...typeof K?.modified_at=="string"?{remoteModifiedAt:K.modified_at}:{}})}catch{}return x(Be)}catch(y){return k(y)}}),J=S("d360_fork_article","Fork a published article into a new draft version \u2014 the safe way to start editing live content.",{article_id:m.string(),project_id:m.string().optional()},async a=>{let g=d();if(g)return g;try{return x(await H(r,`${P(a.project_id??s())}/articles/${a.article_id}/fork`))}catch(y){return k(y)}}),ee=S("d360_publish_article","Publish an article version. This makes the draft live to readers \u2014 only call when the user explicitly asks to publish.",{article_id:m.string(),version_number:m.number(),workspace_id:m.string().optional(),message:m.string().optional(),project_id:m.string().optional()},async a=>{let g=d();if(g)return g;try{return x(await H(r,`${P(a.project_id??s())}/articles/${a.article_id}/publish`,{body:{workspace_id:i(a.workspace_id),version_number:a.version_number,message:a.message}}))}catch(y){return k(y)}}),Lt=S("d360_unpublish_article","Unpublish an article version, reverting it to draft (removes it from readers).",{article_id:m.string(),version_number:m.number().describe("The published version to unpublish (see d360_get_article)."),workspace_id:m.string().optional(),project_id:m.string().optional()},async a=>{let g=d();if(g)return g;try{return x(await H(r,`${P(a.project_id??s())}/articles/${a.article_id}/unpublish`,{body:{workspace_id:i(a.workspace_id),version_number:a.version_number}}))}catch(y){return k(y)}}),qt=S("d360_upload_drive_file","Upload a local file (e.g. a captured screenshot PNG) to Drive and return its URL for embedding in an article. Uploads to the default folder unless folder_id is given.",{file_path:m.string().describe("Local path to the file (absolute, or relative to the repo)."),folder_id:m.string().optional(),title:m.string().optional(),project_id:m.string().optional()},async a=>{let g=d();if(g)return g;try{let y=a.project_id??s(),T=rn(a.file_path)?a.file_path:Me(process.cwd(),a.file_path),w=a.folder_id;if(!w&&(w=(await D(r,`${P(y)}/drive/folders/default`))?.id,!w))return k("Could not resolve the default Drive folder.");let C=Rt(T),R=new FormData;return R.append("file",new Blob([C]),a.title??tn(T)),x(await ft(r,`${P(y)}/drive/folders/${w}/files`,R))}catch(y){return k(y)}}),Ft=S("d360_search_drive","Search Drive files (e.g. to reuse an already-uploaded screenshot instead of uploading a duplicate).",{search_keyword:m.string().optional(),allow_images_only:m.boolean().optional(),project_id:m.string().optional()},async a=>{try{return x(await O(r,`${P(a.project_id??s())}/drive/search`,{query:{search_keyword:a.search_keyword,allow_images_only:a.allow_images_only}}))}catch(g){return k(g)}});return nn({name:"document360",version:"0.2.0",instructions:"First-party Document360 tools. The signed-in user's permissions apply server-side. Project/workspace default from the active profile; pass ids explicitly to override. Create articles as DRAFTS; only call d360_publish_article when the user explicitly asks to publish. All articles are Markdown \u2014 the tools enforce this; never attempt WYSIWYG/Block content. To edit a published article, fork it (d360_fork_article) or update with auto_fork. Before any docs gap/coverage analysis, call d360_sync_status to verify the local docs tree matches Document360. When scoping a large repo (which folders back the docs), call d360_repo_inventory for the candidate folders. Before a bulk run (converting/publishing/auditing many articles), call d360_estimate_cost and show the user the count + cost band first. Auth errors mean the session expired \u2014 tell the user to run /login (works inside this session).",tools:[u,l,p,f,h,_,b,v,$,X,E,pe,V,J,ee,Lt,qt,Ft]})}var Ot="CLAUDE.md";function At(e){if(!Oe(e))return[];let t=[];for(let r of on(e)){let n=$e(e,r);if(r===Ot||!sn(n).isDirectory())continue;let o=$e(n,"SKILL.md");Oe(o)&&t.push({name:r,body:Mt(o,"utf8")})}return t}function It(e){let t=$e(e,Ot);return Oe(t)?Mt(t,"utf8"):null}function cn(e,t){let r=Ge(),n=Ve(e),o=It(r),s=It(n),i=At(r),c=At(n),d=new Set(c.map(p=>p.name)),u=[...i.filter(p=>!d.has(p.name)),...c],l=[];if(o&&l.push(o),s&&l.push(`# Project addendum
|
|
9
|
+
`}function H(e){return"sha256:"+Er("sha256").update(Dr(e),"utf8").digest("hex")}function Y(e,t){return H(`${e??""}
|
|
10
|
+
${t??""}`)}import{existsSync as Mr,readdirSync as Or,readFileSync as $r,statSync as Ur}from"node:fs";import{join as De}from"node:path";var bt={berlin:{apiUrl:"https://apihub.berlin.document360.net",portalUrl:"https://portal.berlin.document360.net",authorizationUrl:"https://identity.berlin.document360.net/connect/authorize",tokenUrl:"https://identity.berlin.document360.net/connect/token",clientId:"d360WriterAgentClient",scopes:["openid","profile","email","customerApi","offline_access"],acrValues:"project_select",redirectUri:"http://127.0.0.1:3223/callback",prompt:"login"},sharjah:{apiUrl:"https://apihub.sharjah.document360.net",portalUrl:"https://portal.sharjah.document360.net",authorizationUrl:"https://identity.sharjah.document360.net/connect/authorize",tokenUrl:"https://identity.sharjah.document360.net/connect/token",clientId:"d360WriterAgentClient",scopes:["openid","profile","email","customerApi","offline_access"],acrValues:"project_select",redirectUri:"http://127.0.0.1:3223/callback",prompt:"login"}};function Ar(){return Object.keys(bt)}function No(e="berlin"){return de({environment:e})}function de(e){let t=e.environment??"berlin",r=bt[t];if(!r)throw new Error(`Unknown Document360 environment "${t}". Known: ${Ar().join(", ")}`);let n=process.env.D360_SCOPES?.split(/[\s,]+/).filter(Boolean);return{name:t,apiUrl:process.env.D360_API_URL??e.apiUrl??r.apiUrl,portalUrl:process.env.D360_PORTAL_URL??e.portalUrl??r.portalUrl,authorizationUrl:process.env.D360_AUTHORIZATION_URL??e.authorizationUrl??r.authorizationUrl,tokenUrl:process.env.D360_TOKEN_URL??e.tokenUrl??r.tokenUrl,clientId:process.env.D360_CLIENT_ID??e.clientId??r.clientId,scopes:n??e.scopes??r.scopes,acrValues:process.env.D360_ACR_VALUES??e.acrValues??r.acrValues,redirectUri:process.env.D360_REDIRECT_URI??e.redirectUri??r.redirectUri,prompt:process.env.D360_PROMPT??e.prompt??r.prompt}}function q(e,t){let r=W(e);if(r===null){let s=t??"berlin";return{name:s,connection:de({environment:s}),project:{},production:!1}}let{name:n,profile:o}=Qe(r,t);return{name:n,connection:de(o.connection),project:o.project??{},production:o.production===!0}}function Fo(e,t,r){let n=W(e);n?.profiles?.[t]&&(n.profiles[t].project={...n.profiles[t].project,...r},Ze(n,e))}function _t(e,t){if(e?.docsDir)return e.docsDir.replace(/\\/g,"/").replace(/\/+$/,"");let r=new Set(Object.keys(t?.articles??{}).map(n=>n.split("/")[0]).filter(Boolean));if(r.size===1)return[...r][0];throw new Error(r.size===0?'Cannot locate the docs folder: no mapped articles yet. Set "docsDir" in .d360-writer.json.':`Cannot locate the docs folder: mapped articles span multiple roots (${[...r].join(", ")}). Set "docsDir" in .d360-writer.json.`)}var Ir=4;function vt(e,t,r,n={getAll:B,get:M}){let o=`/v3/projects/${t}`;return{async fetch(s){let[i,a]=await Promise.all([n.getAll(e,`${o}/workspaces/${r}/articles`),n.getAll(e,`${o}/workspaces/${r}/categories`)]),d=new Map;for(let y of i)d.set(y.id,{id:y.id,title:y.title,categoryId:y.category_id,hidden:y.hidden});let u=new Map;for(let y of a)u.set(y.id,{id:y.id,name:y.name,parentId:y.parent_category_id});let l=s.filter(y=>d.has(y)),p=0,f=async()=>{for(;p<l.length;){let y=l[p++],_=await n.get(e,`${o}/articles/${y}`,{query:{content_mode:"raw"}}),h=d.get(y);h.title=_.title??h.title,h.content=_.content,h.latestVersion=_.latest_version,h.modifiedAt=_.modified_at,h.contentHash=Y(_.title??h.title,_.content)}};return await Promise.all(Array.from({length:Math.min(Ir,l.length)},f)),{articles:d,categories:u}}}}function Nr(e){if(!e.mapped)return e.localExists?"untracked-local":"untracked-remote";if(!e.localExists&&!e.remoteExists)return"orphaned";if(!e.localExists)return"deleted-local";if(!e.remoteExists)return"deleted-remote";if(!e.hasBase)return"unknown-base";let t=e.localHashNow!==e.baseLocalHash,r=e.remoteContentHashNow!==e.baseRemoteContentHash;return t&&r?"conflict":t?"local-ahead":r?"remote-ahead":"in-sync"}function Lr(e,t){let r=De(e,t);if(!Mr(r))return[];let n=[],o=(s,i)=>{for(let a of Or(s)){let d=De(s,a),u=i?`${i}/${a}`:a;Ur(d).isDirectory()?o(d,u):a.endsWith(".md")&&n.push(u)}};return o(r,t.replace(/\\/g,"/")),n}function Br(e,t){let r=new Set(Object.values(e.categories)),n=new Map;for(let i of t.categories.values()){if(!i.parentId)continue;let a=n.get(i.parentId)??[];a.push(i.id),n.set(i.parentId,a)}let o=new Set,s=[...r];for(;s.length>0;){let i=s.shift();o.has(i)||(o.add(i),s.push(...n.get(i)??[]))}return o}async function St(e){let t=q(e.cwd,e.profileName),r=W(e.cwd),n=O(e.cwd,t.name);if(!n)throw new Error(`No d360-category-map.json section for profile "${t.name}". Publish at least one article first (/publish).`);let o={profile:t.name,connection:t.connection},s=n.projectId??t.project.projectId??V(o),i=n.workspaceId??t.project.workspaceId;if(!i)throw new Error(`No workspace recorded for profile "${t.name}". Run /workspace to select one.`);let a=_t(r,n),d=Object.values(n.articles).map(w=>w.id),l=await(e.provider??vt(o,s,i)).fetch(d),p=new Set(Lr(e.cwd,a)),f=[];for(let[w,R]of Object.entries(n.articles)){let z=p.has(w);p.delete(w);let C=l.articles.get(R.id),Q=!!(R.localHash&&R.remoteContentHash),j=Nr({mapped:!0,localExists:z,remoteExists:C!==void 0,hasBase:Q,localHashNow:z?H($r(De(e.cwd,w),"utf8")):void 0,baseLocalHash:R.localHash,remoteContentHashNow:C?.contentHash,baseRemoteContentHash:R.remoteContentHash}),$=[];if(j==="remote-ahead"||j==="conflict"){let J=C?.modifiedAt?.slice(0,10);$.push(`remote edited${J?` ${J}`:""}${C?.latestVersion?` (v${C.latestVersion})`:""}`)}C?.hidden&&$.push("hidden on D360"),f.push({path:w,articleId:R.id,title:C?.title,status:j,detail:$.length>0?$.join("; "):void 0})}for(let w of[...p].sort())f.push({path:w,articleId:null,status:"untracked-local"});let y=new Set(d),_=Br(n,l);for(let w of l.articles.values())y.has(w.id)||!w.categoryId||!_.has(w.categoryId)||f.push({path:null,articleId:w.id,title:w.title,status:"untracked-remote",detail:w.hidden?"hidden on D360":void 0});let h={};for(let w of f)h[w.status]=(h[w.status]??0)+1;return{profile:t.name,projectId:s,workspaceId:i,docsRoot:a,entries:f,counts:h,generatedAt:new Date().toISOString()}}import{posix as Ae}from"node:path";var qr=/\[([^\]]+)\]\(([^)\s]+)\)/g;function Ie(e,t,r){if(!r)return{content:e,resolved:0,unresolved:0};let n=Ae.dirname(t.replace(/\\/g,"/")),o=0,s=0;return{content:e.replace(qr,(a,d,u)=>{if(/^(https?:|mailto:|#|\/)/i.test(u)||!/\.(md|markdown)(#[^)]*)?$/i.test(u))return a;let l=u.indexOf("#"),p=l===-1?u:u.slice(0,l),f=l===-1?"":u.slice(l),y=Ae.normalize(Ae.join(n,p)).replace(/^\.\//,""),_=r.articles[y]?.url;return _?(o++,`[${d}](${_}${f})`):(s++,d)}),resolved:o,unresolved:s}}import{readdirSync as Fr}from"node:fs";import{join as pe}from"node:path";var Wr=new Set([".git","node_modules","dist","build","bin","obj","out","target",".vs",".vscode",".idea",".next","coverage",".turbo",".cache","packages"]),Hr=40,zr=3,Me=5e3,Jr=/\.(csproj|vbproj|fsproj)$|^(package\.json|go\.mod|Cargo\.toml|pyproject\.toml|setup\.py|pom\.xml|build\.gradle(\.kts)?)$/i,Gr=/\.sln$|^(Directory\.(Build|Packages)\.props|global\.json|go\.work)$/i;function Vr(e){return/\.(csproj|vbproj|fsproj|sln)$/i.test(e)||/^(Directory\.(Build|Packages)\.props|global\.json)$/i.test(e)?".NET":/^(package\.json|angular\.json|tsconfig\.json)$/i.test(e)?"JS/TS":/^(pyproject\.toml|requirements\.txt|setup\.py)$/i.test(e)?"Python":/^(go\.mod|go\.work)$/i.test(e)?"Go":/^Cargo\.toml$/i.test(e)?"Rust":/^(pom\.xml|build\.gradle(\.kts)?)$/i.test(e)?"Java":null}var Kr=/(?:^|[.\-_])(web|portal|ui|app|apps|client|site|widget|admin|dashboard|frontend|api)(?:$|[.\-_])/i,Yr=/(?:^|[.\-_])(tests?|specs?|helm|docker|migrations?|functions?|ci|builds?|scripts|tools|proxy|coverage|release|libs?|redis|signalr|websocket|dataaccess|nuget|sdk|infra|infrastructure|deploy|deployment|e2e)(?:$|[.\-_])/i;function Oe(e){let t=[],r=[];try{for(let n of Fr(e,{withFileTypes:!0}))n.isDirectory()?!n.name.startsWith(".")&&!Wr.has(n.name)&&t.push(n.name):n.isFile()&&r.push(n.name)}catch{}return{dirs:t,files:r}}function Qr(e){let t=new Set;for(let r of e){let n=Vr(r);n&&t.add(n)}return t}var Pt=e=>e.some(t=>Jr.test(t)),Zr=e=>e.some(t=>Gr.test(t));function Xr(e){let t=0,r=n=>{if(t>=Me)return;let{dirs:o,files:s}=Oe(n);t+=s.length;for(let i of o){if(t>=Me)return;r(pe(n,i))}};return r(e),Math.min(t,Me)}function en(e,t){let r=e.split("/").pop()??e,n=t.size?[...t].join("+"):"";return Yr.test(r)?{recommended:!1,reason:`tests/infrastructure${n?` \xB7 ${n}`:""}`}:Kr.test(r)?{recommended:!0,reason:`user-facing surface${n?` \xB7 ${n}`:""}`}:{recommended:!1,reason:n?`${n} project`:"source folder"}}function xt(e){let t=[],r=(s,i)=>{let a=Qr(i.files),{recommended:d,reason:u}=en(s,a);t.push({path:s,fileCount:Xr(pe(e,s)),stacks:[...a],recommended:d,reason:u})},n=(s,i)=>{let a=s?pe(e,s):e,d=Oe(a);if(s&&Pt(d.files)){r(s,d);return}if(s&&d.dirs.length===0){r(s,d);return}let u=p=>Pt(Oe(pe(a,p)).files);if((Zr(d.files)||d.dirs.some(u)||s==="")&&i<zr){for(let p of d.dirs)n(s?`${s}/${p}`:p,i+1);return}s&&r(s,d)};n("",0),t.sort((s,i)=>Number(i.recommended)-Number(s.recommended)||s.path.localeCompare(i.path));let o=t.filter(s=>s.recommended);return t.slice(0,Math.max(Hr,o.length))}var te={"claude-fable-5":{inputPerMTok:10,outputPerMTok:50},"claude-opus-4-8":{inputPerMTok:5,outputPerMTok:25},"claude-opus-4-7":{inputPerMTok:5,outputPerMTok:25},"claude-opus-4-6":{inputPerMTok:5,outputPerMTok:25},"claude-opus-4-5":{inputPerMTok:5,outputPerMTok:25},"claude-sonnet-4-6":{inputPerMTok:3,outputPerMTok:15},"claude-sonnet-4-5":{inputPerMTok:3,outputPerMTok:15},"claude-haiku-4-5":{inputPerMTok:1,outputPerMTok:5}},Tt="claude-opus-4-8";function Rt(e){if(e&&te[e])return{model:e,rate:te[e],assumed:!1};if(e){let t=Object.keys(te).filter(r=>e.startsWith(r)).sort((r,n)=>n.length-r.length)[0];if(t)return{model:t,rate:te[t],assumed:!1}}return{model:Tt,rate:te[Tt],assumed:!0}}function re(e,t){return e/1e6*t}var tn=3.5,rn={convert:{in:1.3,out:1.1,outFloor:0},rewrite:{in:1.4,out:1.2,outFloor:0},publish:{in:1.1,out:.2,outFloor:200},audit:{in:1.2,out:.15,outFloor:0}},Ct=.7,jt=1.5,fe=e=>Math.round(e);function Et(e){let{op:t,model:r}=e,n=rn[t],{model:o,rate:s,assumed:i}=Rt(r),a=e.files.filter(h=>!(h.bytes>0)).map(h=>h.path),d=e.files.filter(h=>h.bytes>0),u=0,l=0;for(let h of d){let w=h.bytes/tn;u+=w*n.in,l+=Math.max(w*n.out,n.outFloor)}let p=[fe(u*Ct),fe(u*jt)],f=[fe(l*Ct),fe(l*jt)],y=[re(p[0],s.inputPerMTok)+re(f[0],s.outputPerMTok),re(p[1],s.inputPerMTok)+re(f[1],s.outputPerMTok)],_=`Rough estimate from file sizes, priced at ${o} list rates`+(i?" (model unset \u2014 assumed)":"")+". Actuals vary with cache reuse and reasoning depth; the live cost meter reconciles as the run proceeds.";return{model:o,modelAssumed:i,op:t,articles:d.length,skipped:a,inputTokens:p,outputTokens:f,usd:y,note:_}}var At="/v3/projects",x=e=>`${At}/${e}`;function P(e){return{content:[{type:"text",text:JSON.stringify(e,null,2)??'{"success":true}'}]}}function v(e){return{content:[{type:"text",text:e instanceof Error?e.message:String(e)}],isError:!0}}function It(e,t){let r={profile:e.name,connection:e.connection},n=e.project.projectId,o=e.project.workspaceId,s=()=>V(r,n),i=c=>{let g=c??o;if(!g)throw new Error("No workspace_id given and none in the profile. Call d360_list_workspaces first.");return g},a=(c,g)=>{if(t.cwd)try{let k=$e(t.cwd,c);ue(t.cwd,e.name,c.replace(/\\/g,"/"),{...g,...nn(k)?{localHash:H(Dt(k,"utf8"))}:{}})}catch{}},d=()=>t.writesAllowed?null:v(`Refusing to write to PRODUCTION profile "${e.name}". Authorize this session first: run /allow-prod in the REPL, or pass --yes in one-shot/CI.`),u=S("d360_context","Report the active Document360 connection: profile name, environment, project/workspace id, and whether it is a production profile. Call this before maintaining d360-category-map.json so you scope IDs to the right profile.",{},async()=>{try{return P({profile:e.name,environment:e.connection.name,production:e.production,projectId:n??V(r),workspaceId:o??null})}catch(c){return v(c)}}),l=S("d360_list_projects","List all Document360 projects the signed-in user can access (id, name, sub-domain, status).",{},async()=>{try{return P(await B(r,At))}catch(c){return v(c)}}),p=S("d360_list_workspaces","List workspaces (project versions) for the current project. Each has id, name, slug, is_default, workspace_type.",{project_id:m.string().optional().describe("Defaults to the logged-in/config project.")},async c=>{try{return P(await B(r,`${x(c.project_id??s())}/workspaces`))}catch(g){return v(g)}}),f=S("d360_list_categories","List categories in a workspace (the folder structure for articles).",{workspace_id:m.string().optional().describe("Defaults to d360.workspaceId in config."),project_id:m.string().optional()},async c=>{try{let g=c.workspace_id??o;return g?P(await B(r,`${x(c.project_id??s())}/workspaces/${g}/categories`)):v("No workspace_id given and none in config. Call d360_list_workspaces first.")}catch(g){return v(g)}}),y=S("d360_list_articles","List articles in a workspace (id, title, status, category). Use to see existing docs before writing.",{workspace_id:m.string().optional().describe("Defaults to d360.workspaceId in config."),project_id:m.string().optional()},async c=>{try{let g=c.workspace_id??o;return g?P(await B(r,`${x(c.project_id??s())}/workspaces/${g}/articles`)):v("No workspace_id given and none in config. Call d360_list_workspaces first.")}catch(g){return v(g)}}),_=S("d360_get_article","Get a single article including its content. content_mode=raw returns the stored markdown source (best for editing); display returns processed content.",{article_id:m.string(),content_mode:m.enum(["raw","display"]).optional().describe("raw = stored markdown source (default), display = processed."),published:m.boolean().optional().describe("Read the published version instead of the latest draft."),project_id:m.string().optional()},async c=>{try{return P(await M(r,`${x(c.project_id??s())}/articles/${c.article_id}`,{query:{content_mode:c.content_mode,published:c.published}}))}catch(g){return v(g)}}),h=S("d360_ai_query","Ask Document360's AI search over a workspace's published content. Returns an answer grounded in existing articles \u2014 use to check what's already documented.",{query:m.string(),workspace_id:m.string().optional().describe("Defaults to d360.workspaceId in config."),project_id:m.string().optional()},async c=>{try{let g=c.workspace_id??o;return g?P(await K(r,`${x(c.project_id??s())}/workspaces/ai/query`,{body:{query:c.query,workspace_id:g}})):v("No workspace_id given and none in config. Call d360_list_workspaces first.")}catch(g){return v(g)}}),w=S("d360_sync_status","Deterministic drift report: local docs tree vs Document360, classified against the sync bases in d360-category-map.json. Call this BEFORE any docs gap/coverage analysis \u2014 it proves whether the local docs tree can be trusted as the Document360 inventory (no need to fetch article content). Statuses: local-ahead (push pending), remote-ahead (portal edit to pull), conflict, untracked-local/remote, deleted-local/remote, unknown-base (no base recorded yet).",{},async()=>{try{if(!t.cwd)return v("Sync status needs a repo context (no cwd configured for this session).");let c=await St({cwd:t.cwd,profileName:e.name});return P({profile:c.profile,docsRoot:c.docsRoot,generatedAt:c.generatedAt,counts:c.counts,attention:c.entries.filter(g=>g.status!=="in-sync")})}catch(c){return v(c)}}),R=S("d360_repo_inventory","Deterministic inventory of candidate source folders for documentation scope (no file reads of your own needed). Returns project-level folders with: path, fileCount, detected stacks, a `recommended` flag (user-facing surfaces pre-recommended; tests/infrastructure not), and a one-line reason. Use this when analyzing a large/multi-project repo to decide which folders back the docs \u2014 it is the same data the /scope picker pre-ticks, so your recommendation and the picker agree. Cheap; safe to call before reading any source.",{},async()=>{try{return t.cwd?P(xt(t.cwd)):v("Repo inventory needs a repo context (no cwd configured for this session).")}catch(c){return v(c)}}),z=S("d360_estimate_cost",'Deterministic, no-network token/cost ESTIMATE for a bulk operation. Call this BEFORE you propose a repo-scale run (convert / rewrite / publish / audit MANY articles) so you can show the user the article count and a cost band and get an explicit go-ahead \u2014 see the "Confirm before bulk or irreversible actions" rule. It sizes work from local file BYTES (coarse \u2014 returns [low, high] bands, not a quote). Omit `paths` to estimate over every article tracked in d360-category-map.json; pass `paths` for a subset. Cheap and read-only; safe to call before any write.',{op:m.enum(["convert","rewrite","publish","audit"]).describe("What you intend to do to each article (drives the output-size heuristic)."),paths:m.array(m.string()).optional().describe("Repo-relative .md paths. Omit or leave empty to estimate over all articles in the category map.")},async({op:c,paths:g})=>{try{if(!t.cwd)return v("Cost estimate needs a repo context (no cwd configured for this session).");let k;if(g&&g.length>0)k=g.map(b=>b.replace(/\\/g,"/"));else{let b=O(t.cwd,e.name);if(k=b?Object.keys(b.articles):[],k.length===0)return v("No articles are tracked in d360-category-map.json for this profile, and no `paths` were given. Pass `paths` explicitly (the repo-relative .md files you intend to operate on).")}let E=k.map(b=>{let D=0;try{D=on($e(t.cwd,b)).size}catch{D=0}return{path:b,bytes:D}});return P(Et({files:E,op:c,model:t.model}))}catch(k){return v(k)}}),C=S("d360_create_category","Create a category (a docs folder). Returns the new category id.",{name:m.string(),workspace_id:m.string().optional(),parent_category_id:m.string().optional().describe("Omit for a top-level category."),content:m.string().optional(),slug:m.string().optional(),order:m.number().optional(),project_id:m.string().optional()},async c=>{let g=d();if(g)return g;try{return P(await K(r,`${x(c.project_id??s())}/categories`,{body:{name:c.name,workspace_id:i(c.workspace_id),parent_category_id:c.parent_category_id,content:c.content,slug:c.slug,order:c.order,content_type:"markdown"}}))}catch(k){return v(k)}}),Q=S("d360_create_article","Create a DRAFT article in a category. The body is always Markdown (product rule \u2014 we never create WYSIWYG/Block articles). Returns the new article id. Does not publish.",{title:m.string(),category_id:m.string(),content:m.string().optional().describe("Markdown body."),workspace_id:m.string().optional(),slug:m.string().optional(),order:m.number().optional(),project_id:m.string().optional(),local_path:m.string().optional().describe("Repo-relative path of the local .md this article mirrors (e.g. user-docs/01-intro/01-a.md). When given, the new article id + sync base are recorded into d360-category-map.json automatically \u2014 do not edit the articles map yourself.")},async c=>{let g=d();if(g)return g;try{let k=c.project_id??s(),E=c.content;typeof E=="string"&&c.local_path&&t.cwd&&(E=Ie(E,c.local_path,O(t.cwd,e.name)).content);let b=await K(r,`${x(k)}/articles/bulk`,{body:{articles:[{title:c.title,category_id:c.category_id,workspace_id:i(c.workspace_id),content:E,slug:c.slug,order:c.order,content_type:"markdown"}]}}),D=Array.isArray(b)?b[0]:void 0;if(c.local_path&&typeof D?.id=="string"){let I;try{let F=await M(r,`${x(k)}/articles/${D.id}`,{});I=typeof F?.url=="string"?F.url:void 0}catch{}a(c.local_path,{id:D.id,remoteContentHash:Y(c.title,E),remoteVersion:1,...I?{url:I}:{}})}return P(b)}catch(k){return v(k)}}),j=S("d360_update_article","Update an article's title/content/category. Edits the latest draft by default; set auto_fork to safely edit a published article (creates a new draft version).",{article_id:m.string(),title:m.string().optional(),content:m.string().optional().describe("Markdown body."),category_id:m.string().optional(),hidden:m.boolean().optional(),version_number:m.number().optional(),auto_fork:m.boolean().optional().describe("If the target version is published, fork a new draft instead of erroring."),project_id:m.string().optional()},async c=>{let g=d();if(g)return g;try{let{article_id:k,project_id:E,...b}=c,D=E??s(),I=typeof b.content=="string"&&t.cwd?O(t.cwd,e.name):null,F=I?kt(I,k):null;typeof b.content=="string"&&F&&I&&(b.content=Ie(b.content,F,I).content);let G=null;if(typeof b.content=="string"&&t.onUiEvent)try{G=await M(r,`${x(D)}/articles/${k}`,{query:{content_mode:"raw"}})}catch{}let Be=e.project.languageCode??G?.lang_code,qe=await mt(r,`${x(D)}/articles/${k}`,{body:b,...Be?{query:{lang_code:Be}}:{}});if(G&&typeof b.content=="string"&&(G.content??"")!==b.content&&t.onUiEvent?.({type:"article_diff",articleId:k,title:G.title??null,oldContent:G.content??"",newContent:b.content}),typeof b.content=="string"&&F)try{let X=qe,Fe=b.title??X?.title??G?.title;typeof Fe=="string"&&a(F,{id:k,remoteContentHash:Y(Fe,b.content),...typeof X?.latest_version=="number"?{remoteVersion:X.latest_version}:{},...typeof X?.modified_at=="string"?{remoteModifiedAt:X.modified_at}:{}})}catch{}return P(qe)}catch(k){return v(k)}}),$=S("d360_fork_article","Fork a published article into a new draft version \u2014 the safe way to start editing live content.",{article_id:m.string(),project_id:m.string().optional()},async c=>{let g=d();if(g)return g;try{return P(await K(r,`${x(c.project_id??s())}/articles/${c.article_id}/fork`))}catch(k){return v(k)}}),J=S("d360_publish_article","Publish an article version. This makes the draft live to readers \u2014 only call when the user explicitly asks to publish.",{article_id:m.string(),version_number:m.number(),workspace_id:m.string().optional(),message:m.string().optional(),project_id:m.string().optional()},async c=>{let g=d();if(g)return g;try{return P(await K(r,`${x(c.project_id??s())}/articles/${c.article_id}/publish`,{body:{workspace_id:i(c.workspace_id),version_number:c.version_number,message:c.message}}))}catch(k){return v(k)}}),T=S("d360_unpublish_article","Unpublish an article version, reverting it to draft (removes it from readers).",{article_id:m.string(),version_number:m.number().describe("The published version to unpublish (see d360_get_article)."),workspace_id:m.string().optional(),project_id:m.string().optional()},async c=>{let g=d();if(g)return g;try{return P(await K(r,`${x(c.project_id??s())}/articles/${c.article_id}/unpublish`,{body:{workspace_id:i(c.workspace_id),version_number:c.version_number}}))}catch(k){return v(k)}}),Ht=S("d360_upload_drive_file","Upload a local file (e.g. a captured screenshot PNG) to Drive and return its URL for embedding in an article. Uploads to the default folder unless folder_id is given.",{file_path:m.string().describe("Local path to the file (absolute, or relative to the repo)."),folder_id:m.string().optional(),title:m.string().optional(),project_id:m.string().optional()},async c=>{let g=d();if(g)return g;try{let k=c.project_id??s(),E=an(c.file_path)?c.file_path:$e(process.cwd(),c.file_path),b=c.folder_id;if(!b&&(b=(await M(r,`${x(k)}/drive/folders/default`))?.id,!b))return v("Could not resolve the default Drive folder.");let D=Dt(E),I=new FormData;return I.append("file",new Blob([D]),c.title??sn(E)),P(await gt(r,`${x(k)}/drive/folders/${b}/files`,I))}catch(k){return v(k)}}),zt=S("d360_search_drive","Search Drive files (e.g. to reuse an already-uploaded screenshot instead of uploading a duplicate).",{search_keyword:m.string().optional(),allow_images_only:m.boolean().optional(),project_id:m.string().optional()},async c=>{try{return P(await B(r,`${x(c.project_id??s())}/drive/search`,{query:{search_keyword:c.search_keyword,allow_images_only:c.allow_images_only}}))}catch(g){return v(g)}});return cn({name:"document360",version:"0.2.0",instructions:"First-party Document360 tools. The signed-in user's permissions apply server-side. Project/workspace default from the active profile; pass ids explicitly to override. Create articles as DRAFTS; only call d360_publish_article when the user explicitly asks to publish. All articles are Markdown \u2014 the tools enforce this; never attempt WYSIWYG/Block content. To edit a published article, fork it (d360_fork_article) or update with auto_fork. Before any docs gap/coverage analysis, call d360_sync_status to verify the local docs tree matches Document360. When scoping a large repo (which folders back the docs), call d360_repo_inventory for the candidate folders. Before a bulk run (converting/publishing/auditing many articles), call d360_estimate_cost and show the user the count + cost band first. Auth errors mean the session expired \u2014 tell the user to run /login (works inside this session).",tools:[u,l,p,f,y,_,h,w,R,z,C,Q,j,$,J,T,Ht,zt]})}var Ut="CLAUDE.md";function Mt(e){if(!Ue(e))return[];let t=[];for(let r of ln(e)){let n=Ne(e,r);if(r===Ut||!un(n).isDirectory())continue;let o=Ne(n,"SKILL.md");Ue(o)&&t.push({name:r,body:$t(o,"utf8")})}return t}function Ot(e){let t=Ne(e,Ut);return Ue(t)?$t(t,"utf8"):null}function pn(e,t){let r=Ke(),n=Ye(e),o=Ot(r),s=Ot(n),i=Mt(r),a=Mt(n),d=new Set(a.map(p=>p.name)),u=[...i.filter(p=>!d.has(p.name)),...a],l=[];if(o&&l.push(o),s&&l.push(`# Project addendum
|
|
11
11
|
|
|
12
12
|
${s}`),t&&(l.push("# Project configuration"),l.push("```json"),l.push(JSON.stringify(t,null,2)),l.push("```")),u.length>0){l.push("# Capabilities"),l.push('You have the following specialized documentation skills. Activate the one whose preconditions match the user request. If multiple match, run them in order. These skills are INLINE INSTRUCTIONS in this prompt \u2014 "activating" one means following its steps directly. They are NOT registered with any Skill tool; never attempt to invoke them via a Skill/skill-runner tool.');for(let p of u)l.push(`## Skill: ${p.name}`),l.push(p.body)}return l.join(`
|
|
13
13
|
|
|
14
|
-
`)}function
|
|
15
|
-
`):""}function
|
|
16
|
-
`),options:{cwd:t,model:"haiku",maxTurns:1,settingSources:[],systemPrompt:"You generate terse kebab-case session titles. Output only the title, nothing else.",allowedTools:[]}});for await(let n of r){let o=n;if(o.type==="result")return o.subtype==="success"&&typeof o.result=="string"?
|
|
17
|
-
`),options:{cwd:r,model:"haiku",maxTurns:1,settingSources:[],systemPrompt:"You propose the next user prompt for a docs-writing CLI. Output only the prompt, or NONE.",allowedTools:[]}});for await(let o of n){let s=o;if(s.type==="result")return s.subtype==="success"&&typeof s.result=="string"?
|
|
18
|
-
`)[0].replace(/^["'`]+|["'`]+$/g,"").trim();return!t||/^none\b/i.test(t)||t.length<4||t.length>100?null:t}var
|
|
14
|
+
`)}function fn(){let e=Xe(),t={};for(let[r,n]of Object.entries(e.servers))n.type==="stdio"?t[r]={type:"stdio",command:n.command,args:n.args,env:n.env}:n.type==="http"?t[r]={type:"http",url:n.url,headers:n.headers}:n.type==="sse"&&(t[r]={type:"sse",url:n.url,headers:n.headers});return t}var mn=/auth|api key|login|credential|401|forbidden/i,Le=class{queue;iterator;sdkQuery;uiEvents=[];sessionId=null;constructor(t={}){let r=t.cwd??process.cwd(),n=W(r),o=pn(r,n),s=fn(),i=n?.defaultModel??Se().defaultModel;try{let p=q(r,t.profileName),f=!p.production||t.allowProdWrites===!0;s.document360=It(p,{writesAllowed:f,cwd:r,model:i,onUiEvent:y=>this.uiEvents.push(y)})}catch{}this.queue=new se;let a=async(p,f)=>{if(He.has(p)){let y=f.file_path??f.notebook_path;if(y&&!ge(r,y,n))return{behavior:"deny",message:he(y)}}if(p==="Bash"||p==="PowerShell"){let y=f.command;if(typeof y=="string"){let _=ze(y,r,n);if(_)return{behavior:"deny",message:he(_)}}}return{behavior:"allow",updatedInput:f}},d=n?.mode==="engineer",u={cwd:r,systemPrompt:o,mcpServers:s,...d?{permissionMode:"bypassPermissions",allowDangerouslySkipPermissions:!0}:{permissionMode:"default",canUseTool:a},disallowedTools:["Skill","AskUserQuestion"],includePartialMessages:!0,settingSources:[],model:i,resume:t.resume},l=dn({prompt:this.queue,options:u});this.sdkQuery=l,this.iterator=l[Symbol.asyncIterator]()}async interrupt(){try{await this.sdkQuery.interrupt()}catch{}}async setModel(t){await this.sdkQuery.setModel(t)}async*send(t){for(this.queue.push(t);;){let r;try{r=await this.iterator.next()}catch(s){let i=s.message;yield{type:"error",kind:mn.test(i)?"auth":"agent",message:i};return}if(r.done)return;for(;this.uiEvents.length>0;)yield this.uiEvents.shift();let n=r.value?.session_id;n&&!this.sessionId&&(this.sessionId=n,yield{type:"session",sessionId:n});let o=hn(r.value);if(o){for(let s of o)yield s;if(o.some(s=>s.type==="result"))return}}}close(){this.queue.close()}};function Nt(e={}){return new Le(e)}function gn(e){return typeof e=="string"?e:Array.isArray(e)?e.map(t=>{let r=t;return r.type==="text"&&typeof r.text=="string"?r.text:""}).filter(Boolean).join(`
|
|
15
|
+
`):""}function hn(e){if(!e||typeof e!="object")return null;let t=e;if(t.type==="stream_event"){let r=t.event;return r?.delta&&typeof r.delta.text=="string"?[{type:"text",delta:r.delta.text}]:null}if(t.type==="assistant"){let r=t.message,n=[];for(let o of r?.content??[]){let s=o;s.type==="tool_use"&&n.push({type:"tool",id:s.id??"",name:s.name??"tool",input:s.input??{}})}return n.length>0?n:null}if(t.type==="user"){let r=t.message;if(!Array.isArray(r?.content))return null;let n=[];for(let o of r.content){let s=o;s.type==="tool_result"&&n.push({type:"tool_result",id:s.tool_use_id??"",output:gn(s.content),isError:s.is_error===!0})}return n.length>0?n:null}if(t.type==="result"){let r=t;return[{type:"result",inputTokens:r.usage?.input_tokens??0,outputTokens:r.usage?.output_tokens??0,cacheReadTokens:r.usage?.cache_read_input_tokens??0,cacheCreationTokens:r.usage?.cache_creation_input_tokens??0,costUsd:r.total_cost_usd??0,ok:r.subtype==="success"}]}return null}import{existsSync as yn}from"node:fs";import{homedir as wn}from"node:os";import{join as kn}from"node:path";var Us=["auto","api","subscription"];function Lt(){return process.env.CLAUDE_CODE_OAUTH_TOKEN?!0:yn(kn(wn(),".claude",".credentials.json"))}function Ns(e){let t=!!process.env.ANTHROPIC_API_KEY;return e==="api"?t?{kind:"api"}:{kind:"none"}:e==="subscription"?(delete process.env.ANTHROPIC_API_KEY,{kind:"subscription",stored:Lt()}):t?{kind:"api"}:{kind:"subscription",stored:Lt()}}import{existsSync as bn,readFileSync as _n,writeFileSync as vn}from"node:fs";var Sn=100;function Z(){let e=ke();if(!bn(e))return[];try{let t=JSON.parse(_n(e,"utf8"));return Array.isArray(t)?t:[]}catch{return[]}}function me(e){N(A());let t=[...e].sort((r,n)=>n.updatedAt.localeCompare(r.updatedAt)).slice(0,Sn);vn(ke(),JSON.stringify(t,null,2))}function Fs(e){let t=Z().filter(r=>r.uuid!==e.uuid);t.push(e),me(t)}function Ws(e){return Z().find(t=>t.uuid===e)}function Pn(e){return Z().filter(t=>t.cwd===e).sort((t,r)=>r.updatedAt.localeCompare(t.updatedAt))}function Hs(e,t){let r=Pn(e),n=t.toLowerCase(),o=r.find(a=>a.name.toLowerCase()===n);if(o)return o;let s=r.filter(a=>a.name.toLowerCase().startsWith(n));if(s.length===1)return s[0];let i=r.filter(a=>a.uuid.startsWith(t));if(i.length===1)return i[0]}function zs(e){let t=Z(),r=t.find(n=>n.uuid===e);r&&(r.updatedAt=new Date().toISOString(),me(t))}function Js(e,t){let r=Z(),n=r.find(o=>o.uuid===e);return n?(n.name=t,n.renamed=!0,n.updatedAt=new Date().toISOString(),me(r),!0):!1}function Gs(e,t){let r=Z(),n=r.find(o=>o.uuid===e);!n||n.renamed||(n.name=t,n.titled=!0,me(r))}function Vs(e,t=6){return e.toLowerCase().replace(/[^a-z0-9\s-]/g,"").split(/\s+/).filter(Boolean).slice(0,t).join("-")||"session"}function Ks(e){let t=Date.now()-new Date(e).getTime(),r=Math.floor(t/6e4);if(r<1)return"just now";if(r<60)return`${r}m ago`;let n=Math.floor(r/60);return n<24?`${n}h ago`:`${Math.floor(n/24)}d ago`}import{query as xn}from"@anthropic-ai/claude-agent-sdk";var Tn=6e4;async function Zs(e,t){try{return await Promise.race([Rn(e,t),Cn()])}catch{return null}}async function Rn(e,t){let r=xn({prompt:["Generate a short session title for a documentation-writing session that started with this request:","",e.slice(0,500),"","Reply with ONLY the title: 3-6 words, lowercase, kebab-case, no quotes, no punctuation."].join(`
|
|
16
|
+
`),options:{cwd:t,model:"haiku",maxTurns:1,settingSources:[],systemPrompt:"You generate terse kebab-case session titles. Output only the title, nothing else.",allowedTools:[]}});for await(let n of r){let o=n;if(o.type==="result")return o.subtype==="success"&&typeof o.result=="string"?jn(o.result):null}return null}function Cn(){return new Promise(e=>setTimeout(()=>e(null),Tn).unref())}function jn(e){let t=e.trim().toLowerCase().replace(/[^a-z0-9\s-]/g,"").replace(/\s+/g,"-").replace(/-+/g,"-").replace(/^-|-$/g,"").split("-").slice(0,8).join("-").slice(0,60);return t.length>=3?t:null}import{query as En}from"@anthropic-ai/claude-agent-sdk";var Dn=3e4;async function ti(e,t,r){try{return await Promise.race([An(e,t,r),In()])}catch{return null}}async function An(e,t,r){let n=En({prompt:["In a documentation-writing session, the user asked:","",e.slice(0,800),"","The assistant's reply ended with:","",t.slice(-4e3),"","Suggest the user's most likely next prompt. Reply with ONLY that prompt:","imperative, specific, at most 15 words, no quotes \u2014 a complete, grammatical","sentence the user could send verbatim. If the assistant asked a question,",'answer it. If the assistant offered options AND recommended one ("the right','approach", "recommended", "I suggest"), your suggestion must accept the',"RECOMMENDED option \u2014 never an alternative the assistant advised against or","deferred. If there is no clear next action, reply with exactly: NONE"].join(`
|
|
17
|
+
`),options:{cwd:r,model:"haiku",maxTurns:1,settingSources:[],systemPrompt:"You propose the next user prompt for a docs-writing CLI. Output only the prompt, or NONE.",allowedTools:[]}});for await(let o of n){let s=o;if(s.type==="result")return s.subtype==="success"&&typeof s.result=="string"?Mn(s.result):null}return null}function In(){return new Promise(e=>setTimeout(()=>e(null),Dn).unref())}function Mn(e){let t=e.trim().split(`
|
|
18
|
+
`)[0].replace(/^["'`]+|["'`]+$/g,"").trim();return!t||/^none\b/i.test(t)||t.length<4||t.length>100?null:t}var On=/^---\r?\n[\s\S]*?\r?\n---\r?\n/;function Bt(e){let t=e.match(On);return t?{frontmatter:t[0],body:e.slice(t[0].length)}:{frontmatter:null,body:e}}import{existsSync as $n,mkdirSync as Un,readFileSync as Nn,writeFileSync as Ln}from"node:fs";import{dirname as Bn,join as qt}from"node:path";var Ft=/^\[Screenshot: [^\]]+\]\s*$/;function qn(e){let t=e.replace(/\r\n/g,`
|
|
19
19
|
`).split(`
|
|
20
|
-
`),r=new Map;for(let n=0;n<t.length;n++){if(!t[n].startsWith("<!-- SCREENSHOT"))continue;let o=n;for(;n<t.length&&!t[n].includes("-->");)n++;if(n>=t.length)break;let s=t.slice(o,n+1),i=n+1;for(;i<t.length&&t[i].trim()==="";)i++;i<t.length&&
|
|
21
|
-
`).replace(/^\n+/,""),s=r?
|
|
22
|
-
`).flatMap(l=>{let p=u.get(l.trim());return p&&
|
|
23
|
-
`))}return
|
|
20
|
+
`),r=new Map;for(let n=0;n<t.length;n++){if(!t[n].startsWith("<!-- SCREENSHOT"))continue;let o=n;for(;n<t.length&&!t[n].includes("-->");)n++;if(n>=t.length)break;let s=t.slice(o,n+1),i=n+1;for(;i<t.length&&t[i].trim()==="";)i++;i<t.length&&Ft.test(t[i])&&r.set(t[i].trim(),[...s,...t.slice(n+1,i)])}return r}function Fn(e,t,r){let n=[],o=t.replace(/\r\n/g,`
|
|
21
|
+
`).replace(/^\n+/,""),s=r?Bt(r).frontmatter:null,i=o,a=0;if(r){let u=qn(r);u.size>0&&(i=o.split(`
|
|
22
|
+
`).flatMap(l=>{let p=u.get(l.trim());return p&&Ft.test(l)?(a++,[...p,l]):[l]}).join(`
|
|
23
|
+
`))}return a>0&&n.push(`${a} screenshot spec comment(s) re-attached from the existing local file.`),r&&/\]\((\.\.?\/)[^)]+\.md\)/.test(r)&&n.push("The existing local file has relative cross-article links; publishing flattened them to plain text on Document360, so this pull does not restore them."),/!\[[^\]]*\]\(https?:\/\/[^)]*\)/.test(o)&&n.push("Remote content embeds uploaded images (Drive URLs); they are kept as-is locally."),s&&n.push("Existing frontmatter preserved."),{content:`${s??""}# ${e}
|
|
24
24
|
|
|
25
25
|
${i}`.replace(/\n*$/,`
|
|
26
|
-
`),notes:n}}async function
|
|
26
|
+
`),notes:n}}async function di(e,t=M){let r=q(e.cwd,e.profileName),n=O(e.cwd,r.name),o=n?.articles[e.relPath];if(!n||!o)throw new Error(`"${e.relPath}" is not in d360-category-map.json for profile "${r.name}". Run /sync to see tracked articles.`);let s={profile:r.name,connection:r.connection},i=n.projectId??r.project.projectId??V(s),a=await t(s,`/v3/projects/${i}/articles/${o.id}`,{query:{content_mode:"raw"}}),d=qt(e.cwd,e.relPath),u=$n(d)?Nn(d,"utf8"):null,l=a.title??"",{content:p,notes:f}=Fn(l,a.content??"",u);return{path:e.relPath,articleId:o.id,title:l,oldContent:u??"",newContent:p,remoteContentHash:Y(a.title,a.content),latestVersion:a.latest_version,modifiedAt:a.modified_at,overwritesLocalChanges:u!==null&&o.localHash!==void 0&&H(u)!==o.localHash,notes:f}}function pi(e,t){let r=q(e.cwd,e.profileName),n=qt(e.cwd,t.path),o=t.oldContent.includes(`\r
|
|
27
27
|
`)?t.newContent.replace(/\n/g,`\r
|
|
28
|
-
`):t.newContent;
|
|
28
|
+
`):t.newContent;Un(Bn(n),{recursive:!0}),Ln(n,o,"utf8"),ue(e.cwd,r.name,t.path,{id:t.articleId,localHash:H(o),remoteContentHash:t.remoteContentHash,remoteVersion:t.latestVersion,remoteModifiedAt:t.modifiedAt})}var Wn=12,Wt=e=>e.replace(/\\/g,"/");function Hn(e){let t=new Map;for(let r of e){let n=Wt(r),o=n.lastIndexOf("/"),s=o>=0?n.slice(0,o):"(root)",i=t.get(s);i||(i=[],t.set(s,i)),i.push(n)}return[...t.entries()].map(([r,n])=>({label:r,paths:n.sort()})).sort((r,n)=>r.label.localeCompare(n.label))}function zn(e,t){let r=Math.max(1,t),n=e.map(Wt).sort(),o=[];for(let s=0;s<n.length;s+=r)o.push(n.slice(s,s+r));return o.map((s,i)=>({label:`chunk ${i+1}/${o.length}`,paths:s}))}function Ti(e,t){let r=t?.maxPerPartition??Wn,n=[];for(let o of Hn(e)){if(o.paths.length<=r){n.push(o);continue}let s=zn(o.paths,r);s.forEach((i,a)=>n.push({label:`${o.label} (${a+1}/${s.length})`,paths:i.paths}))}return n}function Ri(e,t){let r;try{r=q(e,t).name}catch{return[]}let n=O(e,r);return n?Object.keys(n.articles):[]}var Jn=e=>Nt(e);async function*Ei(e){let{cwd:t,partitions:r,promptFor:n,signal:o}=e,s=e.spawn??Jn,i=Math.max(1,Math.min(e.concurrency??3,Math.max(1,r.length))),a=[],d=[],u=null,l=h=>{d.push(h);let w=u;u=null,w?.()},p=async h=>{let w=r[h];l({type:"partition_status",index:h,label:w.label,status:"running"});let R=s({cwd:t,profileName:e.profileName,allowProdWrites:e.allowProdWrites}),z=0,C=0,Q=!1,j,$=()=>{R.interrupt?.()};o?.addEventListener("abort",$,{once:!0});try{for await(let T of R.send(n(w)))l({type:"partition_event",index:h,label:w.label,event:T}),T.type==="result"?(z+=T.costUsd,C+=T.outputTokens,Q=T.ok):T.type==="error"&&(j=T.message)}catch(T){j=T instanceof Error?T.message:String(T)}finally{o?.removeEventListener("abort",$);try{R.close()}catch{}}o?.aborted&&!j&&(j="aborted");let J=Q&&!j;a.push({index:h,label:w.label,ok:J,costUsd:z,outputTokens:C,error:j}),l({type:"partition_status",index:h,label:w.label,status:J?"done":"failed"})},f=0,y=(async()=>{let h=async()=>{for(;;){if(o?.aborted)return;let w=f++;if(w>=r.length)return;await p(w)}};await Promise.all(Array.from({length:i},()=>h()))})(),_=!1;for(y.then(()=>{_=!0;let h=u;u=null,h?.()});;){if(d.length>0){yield d.shift();continue}if(_)break;await new Promise(h=>{u=h})}a.sort((h,w)=>h.index-w.index),yield{type:"run_done",ok:!o?.aborted&&a.length>0&&a.every(h=>h.ok),aborted:o?.aborted??!1,totalCostUsd:a.reduce((h,w)=>h+w.costUsd,0),results:a}}export{Us as AUTH_MODES,ce as D360ApiError,L as D360AuthError,Wn as DEFAULT_MAX_PER_PARTITION,Le as EngineSession,ee as ProfileConfigError,br as apiLogDir,pi as applyPull,lr as buildAuthorizationUrl,ht as categoryMapPath,Nr as classify,ko as clearTokens,St as computeSyncStatus,Nt as createSession,vt as createV3RemoteProvider,M as d360Get,B as d360GetAll,mt as d360Patch,K as d360Post,gt as d360Upload,ut as decodeJwtClaims,N as ensureDir,Et as estimateBulkCost,rt as exchangeCode,Hs as findByName,kt as findPathByArticleId,Zs as generateTitle,ft as getAccessToken,Do as getArticle,Ws as getSession,H as hashContent,Y as hashRemote,xt as inventoryRepo,Re as isExpired,Ar as knownEnvironments,Pn as listSessions,Eo as listWorkspaces,O as loadProfileMap,Z as loadSessions,ie as loadTokens,Ee as logApiCall,je as logBodiesAlways,ae as loggableBody,mo as loginPkce,Dr as normalizeMarkdown,rr as packageRoot,Ke as packageSkillsDir,Hn as partitionByCategory,zn as partitionEvenly,sr as pickModel,Ti as planPartitions,di as planPull,be as projectConfigPath,Ye as projectSkillsDir,Xe as readMcpConfig,W as readProjectConfig,Se as readUserConfig,Fn as reconstructLocalMarkdown,ue as recordSyncBase,_r as redactSecrets,ot as refreshTokens,Ks as relativeTime,Js as renameSession,q as resolveActiveProfile,Ns as resolveAuth,de as resolveConnection,Ie as resolveCrossLinks,_t as resolveDocsRoot,No as resolveEnvironment,io as resolveModelSetting,Qe as resolveProfile,V as resolveProjectId,Ei as runPartitioned,lt as saveTokens,ke as sessionsFilePath,Fo as setProfileProject,Gs as setTitle,Vs as slugify,Bt as splitFrontmatter,ti as suggestNextAction,st as toStoredTokens,zs as touchSession,Ri as trackedArticlePaths,vr as truncateBody,Fs as upsertSession,ye as userConfigPath,A as userDir,we as userMcpConfigPath,ao as writeMcpConfig,Ze as writeProjectConfig,so as writeUserConfig};
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Coalesce concurrent async calls keyed by a string: while one call for a key is in
|
|
3
|
+
* flight, later callers for the same key get the SAME promise instead of starting their
|
|
4
|
+
* own. Used to dedupe OAuth token refreshes when N partition workers share one process
|
|
5
|
+
* (refresh-token rotation invalidates the losers if they each refresh — see d360/client.ts).
|
|
6
|
+
*/
|
|
7
|
+
export declare function coalesce<T>(inFlight: Map<string, Promise<T>>, key: string, fn: () => Promise<T>): Promise<T>;
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Deterministic work partitioning for repo-scale bulk runs (#28(d), see
|
|
3
|
+
* plans/bulk-operations-and-cost.md). Splits a flat list of article paths into partitions
|
|
4
|
+
* that each fit comfortably in one agent context, so the orchestrator (run.ts) can fan them
|
|
5
|
+
* out across fresh sessions instead of grinding all of them through one context.
|
|
6
|
+
*
|
|
7
|
+
* Pure — no fs, no network. The caller supplies the path list (e.g. from the category map).
|
|
8
|
+
*/
|
|
9
|
+
export type Partition = {
|
|
10
|
+
/** Human-facing label (the category folder, or a chunk range) for progress display. */
|
|
11
|
+
label: string;
|
|
12
|
+
/** Repo-relative .md paths in this partition (forward slashes). */
|
|
13
|
+
paths: string[];
|
|
14
|
+
};
|
|
15
|
+
/** Default ceiling on articles per partition — past this, one context starts to strain. */
|
|
16
|
+
export declare const DEFAULT_MAX_PER_PARTITION = 12;
|
|
17
|
+
/** Group paths by their immediate parent folder (the natural category unit). Sorted by label. */
|
|
18
|
+
export declare function partitionByCategory(articlePaths: string[]): Partition[];
|
|
19
|
+
/** Split a flat list into chunks of at most `maxPer`, labelled by 1-based chunk index. */
|
|
20
|
+
export declare function partitionEvenly(paths: string[], maxPer: number): Partition[];
|
|
21
|
+
/**
|
|
22
|
+
* The recommended plan: group by category, then sub-split any category that exceeds
|
|
23
|
+
* `maxPerPartition` so no single partition overflows one context. Empty input → no partitions.
|
|
24
|
+
*/
|
|
25
|
+
export declare function planPartitions(articlePaths: string[], opts?: {
|
|
26
|
+
maxPerPartition?: number;
|
|
27
|
+
}): Partition[];
|
|
28
|
+
/**
|
|
29
|
+
* Convenience: every article path tracked in d360-category-map.json for the active profile.
|
|
30
|
+
* Resolves the default profile when `profileName` is omitted (consistent with computeSyncStatus);
|
|
31
|
+
* returns [] when there is no config/profile/map.
|
|
32
|
+
*/
|
|
33
|
+
export declare function trackedArticlePaths(cwd: string, profileName?: string): string[];
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Partitioned bulk-run orchestrator (#28(d), see plans/bulk-operations-and-cost.md).
|
|
3
|
+
*
|
|
4
|
+
* Fans a list of partitions out across fresh engine sessions — each partition runs an agent
|
|
5
|
+
* turn in its OWN context, so a repo-scale operation that would exhaust one context (the
|
|
6
|
+
* SNAG-0081 failure) is split into context-sized pieces. Runs at a bounded concurrency and
|
|
7
|
+
* merges every partition's EngineEvent stream into one ordered async stream the wrapper renders.
|
|
8
|
+
*
|
|
9
|
+
* Deterministic orchestration, agentic work: how to split / how many at once / how to
|
|
10
|
+
* aggregate is fixed code here; the per-article judgment stays inside each agent session.
|
|
11
|
+
*
|
|
12
|
+
* Process invariant (relied on for safety): all in-process D360 tool callbacks — token
|
|
13
|
+
* refresh, category-map writes — execute in THIS one process. Token refresh is coalesced
|
|
14
|
+
* (d360/client.ts) and recordSyncBase is synchronous (atomic in the event loop), so
|
|
15
|
+
* concurrent partitions do not corrupt the token store or d360-category-map.json.
|
|
16
|
+
*/
|
|
17
|
+
import { type EngineEvent } from '../session.js';
|
|
18
|
+
import type { Partition } from './partition.js';
|
|
19
|
+
/** The slice of EngineSession the orchestrator needs — keeps the session factory injectable for tests. */
|
|
20
|
+
export interface PartitionWorker {
|
|
21
|
+
send(text: string): AsyncIterable<EngineEvent>;
|
|
22
|
+
/** Interrupt the in-flight turn (for Esc-abort). Optional; EngineSession provides it. */
|
|
23
|
+
interrupt?(): void | Promise<void>;
|
|
24
|
+
close(): void;
|
|
25
|
+
}
|
|
26
|
+
export type SpawnWorker = (opts: {
|
|
27
|
+
cwd: string;
|
|
28
|
+
profileName?: string;
|
|
29
|
+
allowProdWrites?: boolean;
|
|
30
|
+
}) => PartitionWorker;
|
|
31
|
+
export type PartitionStatus = 'running' | 'done' | 'failed';
|
|
32
|
+
export type PartitionResult = {
|
|
33
|
+
index: number;
|
|
34
|
+
label: string;
|
|
35
|
+
ok: boolean;
|
|
36
|
+
costUsd: number;
|
|
37
|
+
outputTokens: number;
|
|
38
|
+
/** Set when the partition errored (agent error event or a thrown exception). */
|
|
39
|
+
error?: string;
|
|
40
|
+
};
|
|
41
|
+
/** One item in the merged run stream. */
|
|
42
|
+
export type PartitionedRunEvent = {
|
|
43
|
+
type: 'partition_status';
|
|
44
|
+
index: number;
|
|
45
|
+
label: string;
|
|
46
|
+
status: PartitionStatus;
|
|
47
|
+
} | {
|
|
48
|
+
type: 'partition_event';
|
|
49
|
+
index: number;
|
|
50
|
+
label: string;
|
|
51
|
+
event: EngineEvent;
|
|
52
|
+
} | {
|
|
53
|
+
type: 'run_done';
|
|
54
|
+
ok: boolean;
|
|
55
|
+
aborted: boolean;
|
|
56
|
+
totalCostUsd: number;
|
|
57
|
+
results: PartitionResult[];
|
|
58
|
+
};
|
|
59
|
+
export type RunPartitionedOptions = {
|
|
60
|
+
cwd: string;
|
|
61
|
+
partitions: Partition[];
|
|
62
|
+
/** Build the agent prompt for one partition (e.g. "convert these N articles to DFM: …"). */
|
|
63
|
+
promptFor: (partition: Partition) => string;
|
|
64
|
+
/** Max partitions running at once. Default 3 (D360 API rate limits, not CPU, are the cap). */
|
|
65
|
+
concurrency?: number;
|
|
66
|
+
profileName?: string;
|
|
67
|
+
allowProdWrites?: boolean;
|
|
68
|
+
/** Abort the run (Esc): stop launching new partitions and interrupt the active ones. */
|
|
69
|
+
signal?: AbortSignal;
|
|
70
|
+
/** Test seam: spawn a worker. Defaults to a real engine session. */
|
|
71
|
+
spawn?: SpawnWorker;
|
|
72
|
+
};
|
|
73
|
+
/**
|
|
74
|
+
* Run all partitions, yielding a merged event stream and finishing with a `run_done`
|
|
75
|
+
* summary. A partition that errors is isolated (reported failed; others continue), so the
|
|
76
|
+
* run completes and the failed slice is re-runnable on its own.
|
|
77
|
+
*/
|
|
78
|
+
export declare function runPartitioned(opts: RunPartitionedOptions): AsyncIterable<PartitionedRunEvent>;
|
package/package.json
CHANGED