document360-engine 0.2.0 → 0.2.1

package/LICENSE

@@ -1,21 +1,15 @@
-MIT License
+Copyright (c) 2026 Kovai.co. All rights reserved.
 
-Copyright (c) 2026 Saravana Kumar
+This software and its source code are proprietary to Kovai.co and are part
+of the Document360 product family. They are provided solely for use with
+the Document360 platform.
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+No license is granted to copy, modify, merge, publish, distribute,
+sublicense, sell, or create derivative works of this software, in whole or
+in part, except with the prior written permission of Kovai.co.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+KOVAI.CO BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING FROM
+THE USE OF THE SOFTWARE.

package/README.md

@@ -44,4 +44,4 @@ All `EngineEvent` variants are plain JSON, so a wrapper can stream them over IPC
 
 ## License
 
-MIT
+Proprietary — © 2026 Kovai.co. All rights reserved. See [LICENSE](LICENSE).

package/dist/config.d.ts

@@ -30,6 +30,13 @@ export type ProjectConfig = {
     projectId: string;
     captureDir?: string;
     outputDir?: string;
+    /** Repo-relative root of the local docs tree (e.g. "user-docs"). Inferred from
+        the category map when absent; set explicitly once docs span multiple roots. */
+    docsDir?: string;
+    /** 'writer' (default): file edits restricted to the documentation scope
+        (markdown, capture specs, d360 config). 'engineer': unrestricted —
+        for repos that want the agent to modify product source (dogfooding). */
+    mode?: 'writer' | 'engineer';
     authoritativeSourceFiles?: string[];
     terminologyGlossary?: Record<string, string>;
     defaultModel?: string;
@@ -70,5 +77,18 @@ export declare function readProjectConfig(cwd?: string): ProjectConfig | null;
 export declare function writeProjectConfig(cfg: ProjectConfig, cwd?: string): void;
 export declare function readUserConfig(): UserConfig;
 export declare function writeUserConfig(cfg: UserConfig): void;
+/** Where the active model came from — for display (/model, banner) and debugging. */
+export type ResolvedModel = {
+    /** Alias ('haiku'|'sonnet'|'opus') or full id; null = the Claude Code runtime decides. */
+    model: string | null;
+    source: 'project' | 'user' | 'env' | 'claude-settings' | 'claude-default';
+};
+/** Pure resolution order: project config > user config > ANTHROPIC_MODEL env >
+    Claude Code's own settings.json model > the runtime's plan default. */
+export declare function pickModel(project?: string, user?: string, env?: string, claudeSettings?: string): ResolvedModel;
+/** Resolve the model the next agent session will use (and where it came from).
+    NOTE: env and lower tiers are not passed to the SDK by the engine — the
+    spawned runtime applies them itself; this resolver mirrors that for display. */
+export declare function resolveModelSetting(cwd?: string): ResolvedModel;
 export declare function readMcpConfig(): UserMcpConfig;
 export declare function writeMcpConfig(cfg: UserMcpConfig): void;

package/dist/d360/tools.d.ts

@@ -1,9 +1,24 @@
 import type { McpServerConfig } from '@anthropic-ai/claude-agent-sdk';
 import { D360AuthError } from './client.js';
 import type { ActiveProfile } from './profile.js';
+/** UI-only event: article content changed — wrappers render a Claude Code-style diff.
+    Deliberately NOT part of the tool result (tool results enter the model's context;
+    the model already knows both contents — the diff is for the human). */
+export type ArticleDiffEvent = {
+    type: 'article_diff';
+    articleId: string;
+    title: string | null;
+    oldContent: string;
+    newContent: string;
+};
 export type ToolServerOptions = {
     /** False on a production profile until the user authorizes writes (/allow-prod or --yes). */
     writesAllowed: boolean;
+    /** Side channel for UI-only events (e.g. article diffs); never enters model context. */
+    onUiEvent?: (ev: ArticleDiffEvent) => void;
+    /** Repo root for sync bookkeeping (d360-category-map.json). When absent — or the
+        repo has no map/profile section — article writes skip base recording entirely. */
+    cwd?: string;
 };
 /**
  * Build the in-process Document360 tool server for the active profile. Project resolves

package/dist/index.d.ts

@@ -11,3 +11,5 @@ export * from './d360/environments.js';
 export * from './d360/profile.js';
 export * from './d360/client.js';
 export * from './d360/apiLog.js';
+export * from './sync/index.js';
+export * from './scope/inventory.js';

package/dist/index.js

@@ -1,18 +1,28 @@
-// document360-engine — headless documentation agent. Public API consumed by the
-// terminal wrapper (document360-writer) and future GUI wrappers (document360-desktop).
-// The engine never renders UI; it emits typed EngineEvents and exposes auth/profile/
-// config/session operations.
-export * from './session.js'; // createSession, EngineSession, EngineEvent, CreateSessionOptions
-export * from './config.js';
-export * from './lib/auth.js';
-export * from './lib/sessionStore.js';
-export * from './lib/titleGen.js';
-export * from './lib/suggestGen.js';
-export * from './lib/paths.js';
-export * from './d360/oauth.js';
-export * from './d360/tokenStore.js';
-export * from './d360/environments.js';
-export * from './d360/profile.js';
-export * from './d360/client.js';
-export * from './d360/apiLog.js';
-//# sourceMappingURL=index.js.map
+import{readdirSync as Hr,readFileSync as xt,existsSync as De,statSync as Wr}from"node:fs";import{join as Re}from"node:path";import{query as zr}from"@anthropic-ai/claude-agent-sdk";import{existsSync as Et}from"node:fs";import{isAbsolute as It,relative as $t,resolve as Oe}from"node:path";var Ue=new Set(["Edit","Write","MultiEdit","NotebookEdit"]);function le(e,t,r){let n=It(t)?t:Oe(e,t),o=$t(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 Ot=/^(\/dev\/null|nul|null)$/i,Q=e=>e.replace(/^['"]/,"").replace(/['"]$/,""),Ut=new Set(["rm","rmdir","mv","truncate","touch","mkdir","chmod","chown"]),Mt=new Set(["cp","ln","install"]);function Me(e,t,r){let n=i=>{let c=Q(i);return!c||c.startsWith("&")||c.startsWith("-")||Ot.test(c)?!1:!le(t,c,r)},o=/(?:^|[^0-9>])>>?\s*("[^"]+"|'[^']+'|[^\s|&;<>]+)/g,s;for(;s=o.exec(e);)if(n(s[1]))return Q(s[1]);for(let i of e.split(/&&|\|\||[;|]/)){let c=i.trim().split(/\s+/).filter(Boolean);if(c.length===0)continue;let d=c[0].replace(/.*[/\\]/,""),u=c.slice(1),l=u.filter(f=>!f.startsWith("-")),p=[];Ut.has(d)?p=l:Mt.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=>Et(Oe(t,Q(f)))));for(let f of p)if(n(f))return Q(f)}return null}function de(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 Nt}from"node:os";import{join as R,dirname as qe}from"node:path";import{fileURLToPath as qt}from"node:url";import{existsSync as Be,mkdirSync as Bt}from"node:fs";var Lt=qt(import.meta.url),Ne=qe(Lt);function Ft(){let e=Ne;for(let t=0;t<4;t++){if(Be(R(e,"package.json")))return e;e=qe(e)}return R(Ne,"..","..")}function Le(){return R(Ft(),"skills")}function j(){return R(Nt(),".document360-writer")}function ue(){return R(j(),"config.json")}function pe(){return R(j(),"mcp.json")}function fe(){return R(j(),"sessions.json")}function ge(e=process.cwd()){return R(e,".d360-writer.json")}function Fe(e=process.cwd()){return R(e,".d360-writer","skills")}function T(e){Be(e)||Bt(e,{recursive:!0})}import{readFileSync as Z,writeFileSync as me,existsSync as he}from"node:fs";import{homedir as Ht}from"node:os";import{join as Wt}from"node:path";var V=class extends Error{};function He(e,t){if(!e?.profiles||Object.keys(e.profiles).length===0)throw new V("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 V(`No profile specified and no defaultProfile set. Available: ${Object.keys(e.profiles).join(", ")}`);let n=e.profiles[r];if(!n)throw new V(`Unknown profile "${r}". Available: ${Object.keys(e.profiles).join(", ")}`);return{name:r,profile:n}}function O(e=process.cwd()){let t=ge(e);return he(t)?JSON.parse(Z(t,"utf8")):null}function We(e,t=process.cwd()){me(ge(t),JSON.stringify(e,null,2)+`
+`,"utf8")}function ye(){let e=ue();if(!he(e))return{};try{return JSON.parse(Z(e,"utf8"))}catch{return{}}}function Un(e){T(j()),me(ue(),JSON.stringify(e,null,2)+`
+`,"utf8")}function zt(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 Jt(){try{let e=JSON.parse(Z(Wt(Ht(),".claude","settings.json"),"utf8"));return typeof e.model=="string"&&e.model?e.model:void 0}catch{return}}function Mn(e=process.cwd()){return zt(O(e)?.defaultModel,ye().defaultModel,process.env.ANTHROPIC_MODEL,Jt())}function ze(){let e=pe();if(!he(e))return{servers:{}};try{return JSON.parse(Z(e,"utf8"))}catch{return{servers:{}}}}function Nn(e){T(j()),me(pe(),JSON.stringify(e,null,2)+`
+`,"utf8")}var X=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 qr,readFileSync as wt}from"node:fs";import{basename as Br,isAbsolute as Lr,resolve as _t}from"node:path";import{createSdkMcpServer as Fr,tool as b}from"@anthropic-ai/claude-agent-sdk";import{z as g}from"zod";import{createHash as Vt,randomBytes as Je}from"node:crypto";import{createServer as Gt}from"node:http";import{spawn as we}from"node:child_process";var Ve=600*1e3;function _e(e){return e.toString("base64").replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}function Kt(e){let t=_e(Je(32)),r=_e(Vt("sha256").update(t).digest()),n=_e(Je(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 Yt(e){if(process.env.D360_NO_BROWSER)return;let t=process.platform;if(t==="win32"){let r=e.replace(/'/g,"''");we("powershell",["-NoProfile","-NonInteractive","-Command",`Start-Process '${r}'`],{detached:!0,stdio:"ignore"}).unref()}else t==="darwin"?we("open",[e],{detached:!0,stdio:"ignore"}).unref():we("xdg-open",[e],{detached:!0,stdio:"ignore"}).unref()}function Qt(e,t){let r=new URL(e),n,o=new Promise((s,i)=>{let c=setTimeout(()=>{i(new Error(`Timed out after ${Ve/6e4} minutes waiting for the browser login.`)),n.close()},Ve);n=Gt((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"),h=l.searchParams.get("state"),k=S=>{u.writeHead(400,{"content-type":"text/html"}),u.end(`<html><body><h3>Login failed</h3><p>${S}</p><p>Return to the terminal.</p></body></html>`),clearTimeout(c),i(new Error(S)),n.close()};if(p)return k(`${p}: ${l.searchParams.get("error_description")??""}`);if(!f)return k("No authorization code in the callback.");if(h!==t)return k("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(c),s(f),n.close()}),n.on("error",d=>{clearTimeout(c),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 Ke(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 Ge(e,t,r){return Ke(e,new URLSearchParams({grant_type:"authorization_code",code:t,redirect_uri:e.redirectUri,client_id:e.clientId,code_verifier:r}))}async function Ye(e,t){return Ke(e,new URLSearchParams({grant_type:"refresh_token",refresh_token:t,client_id:e.clientId}))}function Qe(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 Wn(e,t,r){let{url:n,verifier:o,state:s}=Kt(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 Ge(e,l,o)}let{result:i}=Qt(e.redirectUri,s);r("Opening your browser for Document360 sign-in\u2026"),r(`If it did not open, visit:
+  ${n}`),Yt(n);let c=await i;return Ge(e,c,o)}import{existsSync as Ze,readFileSync as Zt,unlinkSync as Xt,writeFileSync as er}from"node:fs";import{join as Xe}from"node:path";function et(){return Xe(j(),"auth")}function ke(e){return Xe(et(),`${e}.json`)}function tt(e){T(et()),er(ke(e.profile),JSON.stringify(e,null,2))}function be(e){let t=ke(e);if(!Ze(t))return null;try{return JSON.parse(Zt(t,"utf8"))}catch{return null}}function Kn(e){let t=ke(e);return Ze(t)?(Xt(t),!0):!1}function rt(e,t=60){return Date.now()>=new Date(e.expiresAt).getTime()-t*1e3}function nt(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}}import{appendFileSync as tr,readdirSync as rr,unlinkSync as nr}from"node:fs";import{join as ve}from"node:path";var or=14,sr=4096;function ir(){return ve(j(),"logs")}function ar(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 cr(e,t=sr){return e.length<=t?e:`${e.slice(0,t)}\u2026 [+${e.length-t} chars]`}function ee(e){return e===void 0?void 0:cr(ar(e))}var Se=()=>process.env.D360_LOG_BODIES==="1",lr=/^d360-api-(\d{4}-\d{2}-\d{2})\.jsonl$/;function dr(e){let t=new Date(Date.now()-or*24*60*60*1e3).toISOString().slice(0,10);for(let r of rr(e)){let n=r.match(lr);if(n&&n[1]<t)try{nr(ve(e,r))}catch{}}}var ot=!1;function xe(e){try{let t=ir();T(t),ot||(ot=!0,dr(t));let r=ve(t,`d360-api-${e.ts.slice(0,10)}.jsonl`);tr(r,JSON.stringify(e)+`
+`,"utf8")}catch{}}var A=class extends Error{},te=class extends Error{constructor(r,n,o){super(r);this.status=n;this.requestId=o}status;requestId};async function st(e){let t=be(e.profile);if(!t)throw new A(`Not logged in to Document360 (profile "${e.profile}"). Run /login (or: d360-writer login --profile ${e.profile})`);if(!rt(t))return t.accessToken;if(!t.refreshToken)throw new A(`Document360 session expired (profile "${e.profile}"). Run /login (or: d360-writer login --profile ${e.profile})`);try{let r=Qe(e.profile,await Ye(e.connection,t.refreshToken));return tt(r),r.accessToken}catch(r){throw new A(`Document360 session expired and refresh failed (${r.message.slice(0,120)}). Run /login (or: d360-writer login --profile ${e.profile})`)}}function N(e,t){if(t)return t;let r=be(e.profile),o=(r?nt(r.accessToken)??{}:{}).doc360_project_id;if(typeof o=="string"&&o)return o;throw new A("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 re(e,t,r,n={}){let o=await st(e),s=new URL(r.startsWith("http")?r:`${e.connection.apiUrl}${r}`);for(let[f,h]of Object.entries(n.query??{}))h!==void 0&&s.searchParams.set(f,String(h));let i=n.body!==void 0?JSON.stringify(n.body):void 0,c=Date.now(),d=f=>xe({ts:new Date().toISOString(),profile:e.profile,method:t,url:s.toString(),ms:Date.now()-c,ok:f.ok,status:f.status,requestId:f.requestId,error:f.error,...f.withBodies?{requestBody:ee(i),responseBody:ee(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(k=>k.message??k.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 A(`Document360 rejected the token (401). Run /login (or: d360-writer login --profile ${e.profile})`);let h=p.request_id?` [request_id: ${p.request_id}]`:"";throw new te(`Document360 API ${u.status}: ${f}${h}`,u.status,p.request_id)}return d({ok:!0,status:u.status,requestId:p.request_id,responseBody:l,withBodies:Se()}),p}async function E(e,t,r){return(await re(e,"GET",t,r)).data}async function q(e,t,r){return(await re(e,"POST",t,r)).data}async function it(e,t,r){return(await re(e,"PATCH",t,r)).data}async function at(e,t,r){let n=await st(e),o=`${e.connection.apiUrl}${t}`,s=Date.now(),i=l=>xe({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:ee(l.responseBody)}:{}}),c;try{c=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 c.text(),u={};if(d)try{u=JSON.parse(d)}catch{}if(!c.ok||u.success===!1){let l=u.errors?.map(f=>f.message??f.code).filter(Boolean).join("; ")||d.slice(0,300)||c.statusText;if(i({ok:!1,status:c.status,requestId:u.request_id,error:l,responseBody:d,withBodies:!0}),c.status===401)throw new A(`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 te(`Document360 upload ${c.status}: ${l}${p}`,c.status,u.request_id)}return i({ok:!0,status:c.status,requestId:u.request_id,responseBody:d,withBodies:Se()}),u.data}async function I(e,t,r={}){let n=[],o;for(let s=0;s<50;s++){let i=await re(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 oo(e,t){return I(e,`/v3/projects/${t}/workspaces`)}async function so(e,t,r){return E(e,`/v3/projects/${t}/articles/${r}`,{query:{content_mode:"raw"}})}import{existsSync as ur,readFileSync as pr,writeFileSync as fr}from"node:fs";import{join as gr}from"node:path";function ct(e){return gr(e,"d360-category-map.json")}function lt(e){let t=ct(e);if(!ur(t))return null;try{return JSON.parse(pr(t,"utf8"))}catch{return null}}function dt(e){return typeof e=="string"?{id:e}:{...e}}function H(e,t){let n=lt(e)?.[t];if(!n)return null;let o={};for(let[s,i]of Object.entries(n.articles??{}))o[s]=dt(i);return{environment:n.environment,projectId:n.projectId,workspaceId:n.workspaceId,lastAnalyzedCommit:n.lastAnalyzedCommit,categories:{...n.categories??{}},articles:o}}function ut(e,t){for(let[r,n]of Object.entries(e.articles))if(n.id===t)return r;return null}function ne(e,t,r,n){let o=lt(e),s=o?.[t];if(!o||!s)return!1;s.articles??={};let i=s.articles[r],c=i!==void 0?dt(i):null;return s.articles[r]={...c??{},...n,lastSyncedAt:new Date().toISOString()},fr(ct(e),JSON.stringify(o,null,2)+`
+`,"utf8"),!0}import{createHash as mr}from"node:crypto";function hr(e){let t=e.replace(/^\uFEFF/,"").replace(/\r\n/g,`
+`);return t=t.replace(/\n*$/,""),t===""?"":t+`
+`}function U(e){return"sha256:"+mr("sha256").update(hr(e),"utf8").digest("hex")}function B(e,t){return U(`${e??""}
+${t??""}`)}import{existsSync as _r,readdirSync as kr,readFileSync as br,statSync as vr}from"node:fs";import{join as Pe}from"node:path";var pt={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 yr(){return Object.keys(pt)}function fo(e="berlin"){return oe({environment:e})}function oe(e){let t=e.environment??"berlin",r=pt[t];if(!r)throw new Error(`Unknown Document360 environment "${t}". Known: ${yr().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 L(e,t){let r=O(e);if(r===null){let s=t??"berlin";return{name:s,connection:oe({environment:s}),project:{},production:!1}}let{name:n,profile:o}=He(r,t);return{name:n,connection:oe(o.connection),project:o.project??{},production:o.production===!0}}function yo(e,t,r){let n=O(e);n?.profiles?.[t]&&(n.profiles[t].project={...n.profiles[t].project,...r},We(n,e))}function ft(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 wr=4;function gt(e,t,r,n={getAll:I,get:E}){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++],k=await n.get(e,`${o}/articles/${h}`,{query:{content_mode:"raw"}}),S=d.get(h);S.title=k.title??S.title,S.content=k.content,S.latestVersion=k.latest_version,S.modifiedAt=k.modified_at,S.contentHash=B(k.title??S.title,k.content)}};return await Promise.all(Array.from({length:Math.min(wr,l.length)},f)),{articles:d,categories:u}}}}function Sr(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 xr(e,t){let r=Pe(e,t);if(!_r(r))return[];let n=[],o=(s,i)=>{for(let c of kr(s)){let d=Pe(s,c),u=i?`${i}/${c}`:c;vr(d).isDirectory()?o(d,u):c.endsWith(".md")&&n.push(u)}};return o(r,t.replace(/\\/g,"/")),n}function Pr(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 mt(e){let t=L(e.cwd,e.profileName),r=O(e.cwd),n=H(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??N(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=ft(r,n),d=Object.values(n.articles).map(_=>_.id),l=await(e.provider??gt(o,s,i)).fetch(d),p=new Set(xr(e.cwd,c)),f=[];for(let[_,$]of Object.entries(n.articles)){let G=p.has(_);p.delete(_);let D=l.articles.get($.id),ae=!!($.localHash&&$.remoteContentHash),z=Sr({mapped:!0,localExists:G,remoteExists:D!==void 0,hasBase:ae,localHashNow:G?U(br(Pe(e.cwd,_),"utf8")):void 0,baseLocalHash:$.localHash,remoteContentHashNow:D?.contentHash,baseRemoteContentHash:$.remoteContentHash}),F=[];if(z==="remote-ahead"||z==="conflict"){let K=D?.modifiedAt?.slice(0,10);F.push(`remote edited${K?` ${K}`:""}${D?.latestVersion?` (v${D.latestVersion})`:""}`)}D?.hidden&&F.push("hidden on D360"),f.push({path:_,articleId:$.id,title:D?.title,status:z,detail:F.length>0?F.join("; "):void 0})}for(let _ of[...p].sort())f.push({path:_,articleId:null,status:"untracked-local"});let h=new Set(d),k=Pr(n,l);for(let _ of l.articles.values())h.has(_.id)||!_.categoryId||!k.has(_.categoryId)||f.push({path:null,articleId:_.id,title:_.title,status:"untracked-remote",detail:_.hidden?"hidden on D360":void 0});let S={};for(let _ of f)S[_.status]=(S[_.status]??0)+1;return{profile:t.name,projectId:s,workspaceId:i,docsRoot:c,entries:f,counts:S,generatedAt:new Date().toISOString()}}import{readdirSync as jr}from"node:fs";import{join as se}from"node:path";var Cr=new Set([".git","node_modules","dist","build","bin","obj","out","target",".vs",".vscode",".idea",".next","coverage",".turbo",".cache","packages"]),Dr=40,Rr=3,je=5e3,Tr=/\.(csproj|vbproj|fsproj)$|^(package\.json|go\.mod|Cargo\.toml|pyproject\.toml|setup\.py|pom\.xml|build\.gradle(\.kts)?)$/i,Ar=/\.sln$|^(Directory\.(Build|Packages)\.props|global\.json|go\.work)$/i;function Er(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 Ir=/(?:^|[.\-_])(web|portal|ui|app|apps|client|site|widget|admin|dashboard|frontend|api)(?:$|[.\-_])/i,$r=/(?:^|[.\-_])(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 Ce(e){let t=[],r=[];try{for(let n of jr(e,{withFileTypes:!0}))n.isDirectory()?!n.name.startsWith(".")&&!Cr.has(n.name)&&t.push(n.name):n.isFile()&&r.push(n.name)}catch{}return{dirs:t,files:r}}function Or(e){let t=new Set;for(let r of e){let n=Er(r);n&&t.add(n)}return t}var ht=e=>e.some(t=>Tr.test(t)),Ur=e=>e.some(t=>Ar.test(t));function Mr(e){let t=0,r=n=>{if(t>=je)return;let{dirs:o,files:s}=Ce(n);t+=s.length;for(let i of o){if(t>=je)return;r(se(n,i))}};return r(e),Math.min(t,je)}function Nr(e,t){let r=e.split("/").pop()??e,n=t.size?[...t].join("+"):"";return $r.test(r)?{recommended:!1,reason:`tests/infrastructure${n?` \xB7 ${n}`:""}`}:Ir.test(r)?{recommended:!0,reason:`user-facing surface${n?` \xB7 ${n}`:""}`}:{recommended:!1,reason:n?`${n} project`:"source folder"}}function yt(e){let t=[],r=(s,i)=>{let c=Or(i.files),{recommended:d,reason:u}=Nr(s,c);t.push({path:s,fileCount:Mr(se(e,s)),stacks:[...c],recommended:d,reason:u})},n=(s,i)=>{let c=s?se(e,s):e,d=Ce(c);if(s&&ht(d.files)){r(s,d);return}if(s&&d.dirs.length===0){r(s,d);return}let u=p=>ht(Ce(se(c,p)).files);if((Ur(d.files)||d.dirs.some(u)||s==="")&&i<Rr){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(Dr,o.length))}var kt="/v3/projects",x=e=>`${kt}/${e}`;function v(e){return{content:[{type:"text",text:JSON.stringify(e,null,2)??'{"success":true}'}]}}function w(e){return{content:[{type:"text",text:e instanceof Error?e.message:String(e)}],isError:!0}}function bt(e,t){let r={profile:e.name,connection:e.connection},n=e.project.projectId,o=e.project.workspaceId,s=()=>N(r,n),i=a=>{let m=a??o;if(!m)throw new Error("No workspace_id given and none in the profile. Call d360_list_workspaces first.");return m},c=(a,m)=>{if(t.cwd)try{let y=_t(t.cwd,a);ne(t.cwd,e.name,a.replace(/\\/g,"/"),{...m,...qr(y)?{localHash:U(wt(y,"utf8"))}:{}})}catch{}},d=()=>t.writesAllowed?null:w(`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=b("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 v({profile:e.name,environment:e.connection.name,production:e.production,projectId:n??N(r),workspaceId:o??null})}catch(a){return w(a)}}),l=b("d360_list_projects","List all Document360 projects the signed-in user can access (id, name, sub-domain, status).",{},async()=>{try{return v(await I(r,kt))}catch(a){return w(a)}}),p=b("d360_list_workspaces","List workspaces (project versions) for the current project. Each has id, name, slug, is_default, workspace_type.",{project_id:g.string().optional().describe("Defaults to the logged-in/config project.")},async a=>{try{return v(await I(r,`${x(a.project_id??s())}/workspaces`))}catch(m){return w(m)}}),f=b("d360_list_categories","List categories in a workspace (the folder structure for articles).",{workspace_id:g.string().optional().describe("Defaults to d360.workspaceId in config."),project_id:g.string().optional()},async a=>{try{let m=a.workspace_id??o;return m?v(await I(r,`${x(a.project_id??s())}/workspaces/${m}/categories`)):w("No workspace_id given and none in config. Call d360_list_workspaces first.")}catch(m){return w(m)}}),h=b("d360_list_articles","List articles in a workspace (id, title, status, category). Use to see existing docs before writing.",{workspace_id:g.string().optional().describe("Defaults to d360.workspaceId in config."),project_id:g.string().optional()},async a=>{try{let m=a.workspace_id??o;return m?v(await I(r,`${x(a.project_id??s())}/workspaces/${m}/articles`)):w("No workspace_id given and none in config. Call d360_list_workspaces first.")}catch(m){return w(m)}}),k=b("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:g.string(),content_mode:g.enum(["raw","display"]).optional().describe("raw = stored markdown source (default), display = processed."),published:g.boolean().optional().describe("Read the published version instead of the latest draft."),project_id:g.string().optional()},async a=>{try{return v(await E(r,`${x(a.project_id??s())}/articles/${a.article_id}`,{query:{content_mode:a.content_mode,published:a.published}}))}catch(m){return w(m)}}),S=b("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:g.string(),workspace_id:g.string().optional().describe("Defaults to d360.workspaceId in config."),project_id:g.string().optional()},async a=>{try{let m=a.workspace_id??o;return m?v(await q(r,`${x(a.project_id??s())}/workspaces/ai/query`,{body:{query:a.query,workspace_id:m}})):w("No workspace_id given and none in config. Call d360_list_workspaces first.")}catch(m){return w(m)}}),_=b("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 w("Sync status needs a repo context (no cwd configured for this session).");let a=await mt({cwd:t.cwd,profileName:e.name});return v({profile:a.profile,docsRoot:a.docsRoot,generatedAt:a.generatedAt,counts:a.counts,attention:a.entries.filter(m=>m.status!=="in-sync")})}catch(a){return w(a)}}),$=b("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?v(yt(t.cwd)):w("Repo inventory needs a repo context (no cwd configured for this session).")}catch(a){return w(a)}}),G=b("d360_create_category","Create a category (a docs folder). Returns the new category id.",{name:g.string(),workspace_id:g.string().optional(),parent_category_id:g.string().optional().describe("Omit for a top-level category."),content:g.string().optional(),slug:g.string().optional(),order:g.number().optional(),project_id:g.string().optional()},async a=>{let m=d();if(m)return m;try{return v(await q(r,`${x(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 w(y)}}),D=b("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:g.string(),category_id:g.string(),content:g.string().optional().describe("Markdown body."),workspace_id:g.string().optional(),slug:g.string().optional(),order:g.number().optional(),project_id:g.string().optional(),local_path:g.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 m=d();if(m)return m;try{let y=await q(r,`${x(a.project_id??s())}/articles/bulk`,{body:{articles:[{title:a.title,category_id:a.category_id,workspace_id:i(a.workspace_id),content:a.content,slug:a.slug,order:a.order,content_type:"markdown"}]}}),M=Array.isArray(y)?y[0]:void 0;return a.local_path&&typeof M?.id=="string"&&c(a.local_path,{id:M.id,remoteContentHash:B(a.title,a.content),remoteVersion:1}),v(y)}catch(y){return w(y)}}),ae=b("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:g.string(),title:g.string().optional(),content:g.string().optional().describe("Markdown body."),category_id:g.string().optional(),hidden:g.boolean().optional(),version_number:g.number().optional(),auto_fork:g.boolean().optional().describe("If the target version is published, fork a new draft instead of erroring."),project_id:g.string().optional()},async a=>{let m=d();if(m)return m;try{let{article_id:y,project_id:M,...P}=a,Y=M??s(),C=null;if(typeof P.content=="string"&&t.onUiEvent)try{C=await E(r,`${x(Y)}/articles/${y}`,{query:{content_mode:"raw"}})}catch{}let ce=e.project.languageCode??C?.lang_code,Ae=await it(r,`${x(Y)}/articles/${y}`,{body:P,...ce?{query:{lang_code:ce}}:{}});if(C&&typeof P.content=="string"&&(C.content??"")!==P.content&&t.onUiEvent?.({type:"article_diff",articleId:y,title:C.title??null,oldContent:C.content??"",newContent:P.content}),typeof P.content=="string"&&t.cwd)try{let Ee=H(t.cwd,e.name),Ie=Ee?ut(Ee,y):null,J=Ae,$e=P.title??J?.title??C?.title;Ie&&typeof $e=="string"&&c(Ie,{id:y,remoteContentHash:B($e,P.content),...typeof J?.latest_version=="number"?{remoteVersion:J.latest_version}:{},...typeof J?.modified_at=="string"?{remoteModifiedAt:J.modified_at}:{}})}catch{}return v(Ae)}catch(y){return w(y)}}),z=b("d360_fork_article","Fork a published article into a new draft version \u2014 the safe way to start editing live content.",{article_id:g.string(),project_id:g.string().optional()},async a=>{let m=d();if(m)return m;try{return v(await q(r,`${x(a.project_id??s())}/articles/${a.article_id}/fork`))}catch(y){return w(y)}}),F=b("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:g.string(),version_number:g.number(),workspace_id:g.string().optional(),message:g.string().optional(),project_id:g.string().optional()},async a=>{let m=d();if(m)return m;try{return v(await q(r,`${x(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 w(y)}}),K=b("d360_unpublish_article","Unpublish an article version, reverting it to draft (removes it from readers).",{article_id:g.string(),version_number:g.number().describe("The published version to unpublish (see d360_get_article)."),workspace_id:g.string().optional(),project_id:g.string().optional()},async a=>{let m=d();if(m)return m;try{return v(await q(r,`${x(a.project_id??s())}/articles/${a.article_id}/unpublish`,{body:{workspace_id:i(a.workspace_id),version_number:a.version_number}}))}catch(y){return w(y)}}),Tt=b("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:g.string().describe("Local path to the file (absolute, or relative to the repo)."),folder_id:g.string().optional(),title:g.string().optional(),project_id:g.string().optional()},async a=>{let m=d();if(m)return m;try{let y=a.project_id??s(),M=Lr(a.file_path)?a.file_path:_t(process.cwd(),a.file_path),P=a.folder_id;if(!P&&(P=(await E(r,`${x(y)}/drive/folders/default`))?.id,!P))return w("Could not resolve the default Drive folder.");let Y=wt(M),C=new FormData;return C.append("file",new Blob([Y]),a.title??Br(M)),v(await at(r,`${x(y)}/drive/folders/${P}/files`,C))}catch(y){return w(y)}}),At=b("d360_search_drive","Search Drive files (e.g. to reuse an already-uploaded screenshot instead of uploading a duplicate).",{search_keyword:g.string().optional(),allow_images_only:g.boolean().optional(),project_id:g.string().optional()},async a=>{try{return v(await I(r,`${x(a.project_id??s())}/drive/search`,{query:{search_keyword:a.search_keyword,allow_images_only:a.allow_images_only}}))}catch(m){return w(m)}});return Fr({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. Auth errors mean the session expired \u2014 tell the user to run /login (works inside this session).",tools:[u,l,p,f,h,k,S,_,$,G,D,ae,z,F,K,Tt,At]})}var Pt="CLAUDE.md";function vt(e){if(!De(e))return[];let t=[];for(let r of Hr(e)){let n=Re(e,r);if(r===Pt||!Wr(n).isDirectory())continue;let o=Re(n,"SKILL.md");De(o)&&t.push({name:r,body:xt(o,"utf8")})}return t}function St(e){let t=Re(e,Pt);return De(t)?xt(t,"utf8"):null}function Jr(e,t){let r=Le(),n=Fe(e),o=St(r),s=St(n),i=vt(r),c=vt(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
+
+${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(`
+
+`)}function Vr(){let e=ze(),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 Gr=/auth|api key|login|credential|401|forbidden/i,Te=class{queue;iterator;sdkQuery;uiEvents=[];sessionId=null;constructor(t={}){let r=t.cwd??process.cwd(),n=O(r),o=Jr(r,n),s=Vr();try{let l=L(r,t.profileName),p=!l.production||t.allowProdWrites===!0;s.document360=bt(l,{writesAllowed:p,cwd:r,onUiEvent:f=>this.uiEvents.push(f)})}catch{}this.queue=new X;let i=async(l,p)=>{if(Ue.has(l)){let f=p.file_path??p.notebook_path;if(f&&!le(r,f,n))return{behavior:"deny",message:de(f)}}if(l==="Bash"||l==="PowerShell"){let f=p.command;if(typeof f=="string"){let h=Me(f,r,n);if(h)return{behavior:"deny",message:de(h)}}}return{behavior:"allow",updatedInput:p}},c=n?.mode==="engineer",d={cwd:r,systemPrompt:o,mcpServers:s,...c?{permissionMode:"bypassPermissions",allowDangerouslySkipPermissions:!0}:{permissionMode:"default",canUseTool:i},disallowedTools:["Skill"],includePartialMessages:!0,settingSources:[],model:n?.defaultModel??ye().defaultModel,resume:t.resume},u=zr({prompt:this.queue,options:d});this.sdkQuery=u,this.iterator=u[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:Gr.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=Yr(r.value);if(o){for(let s of o)yield s;if(o.some(s=>s.type==="result"))return}}}close(){this.queue.close()}};function ts(e={}){return new Te(e)}function Kr(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(`
+`):""}function Yr(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:Kr(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,ok:r.subtype==="success"}]}return null}import{existsSync as Qr}from"node:fs";import{homedir as Zr}from"node:os";import{join as Xr}from"node:path";var is=["auto","api","subscription"];function jt(){return process.env.CLAUDE_CODE_OAUTH_TOKEN?!0:Qr(Xr(Zr(),".claude",".credentials.json"))}function as(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:jt()}):t?{kind:"api"}:{kind:"subscription",stored:jt()}}import{existsSync as en,readFileSync as tn,writeFileSync as rn}from"node:fs";var nn=100;function W(){let e=fe();if(!en(e))return[];try{let t=JSON.parse(tn(e,"utf8"));return Array.isArray(t)?t:[]}catch{return[]}}function ie(e){T(j());let t=[...e].sort((r,n)=>n.updatedAt.localeCompare(r.updatedAt)).slice(0,nn);rn(fe(),JSON.stringify(t,null,2))}function us(e){let t=W().filter(r=>r.uuid!==e.uuid);t.push(e),ie(t)}function ps(e){return W().find(t=>t.uuid===e)}function on(e){return W().filter(t=>t.cwd===e).sort((t,r)=>r.updatedAt.localeCompare(t.updatedAt))}function fs(e,t){let r=on(e),n=t.toLowerCase(),o=r.find(c=>c.name.toLowerCase()===n);if(o)return o;let s=r.filter(c=>c.name.toLowerCase().startsWith(n));if(s.length===1)return s[0];let i=r.filter(c=>c.uuid.startsWith(t));if(i.length===1)return i[0]}function gs(e){let t=W(),r=t.find(n=>n.uuid===e);r&&(r.updatedAt=new Date().toISOString(),ie(t))}function ms(e,t){let r=W(),n=r.find(o=>o.uuid===e);return n?(n.name=t,n.renamed=!0,n.updatedAt=new Date().toISOString(),ie(r),!0):!1}function hs(e,t){let r=W(),n=r.find(o=>o.uuid===e);!n||n.renamed||(n.name=t,n.titled=!0,ie(r))}function ys(e,t=6){return e.toLowerCase().replace(/[^a-z0-9\s-]/g,"").split(/\s+/).filter(Boolean).slice(0,t).join("-")||"session"}function ws(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 sn}from"@anthropic-ai/claude-agent-sdk";var an=6e4;async function bs(e,t){try{return await Promise.race([cn(e,t),ln()])}catch{return null}}async function cn(e,t){let r=sn({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(`
+`),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"?dn(o.result):null}return null}function ln(){return new Promise(e=>setTimeout(()=>e(null),an).unref())}function dn(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 un}from"@anthropic-ai/claude-agent-sdk";var pn=3e4;async function xs(e,t,r){try{return await Promise.race([fn(e,t,r),gn()])}catch{return null}}async function fn(e,t,r){let n=un({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(`
+`),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 gn(){return new Promise(e=>setTimeout(()=>e(null),pn).unref())}function mn(e){let t=e.trim().split(`
+`)[0].replace(/^["'`]+|["'`]+$/g,"").trim();return!t||/^none\b/i.test(t)||t.length<4||t.length>100?null:t}var hn=/^---\r?\n[\s\S]*?\r?\n---\r?\n/;function Ct(e){let t=e.match(hn);return t?{frontmatter:t[0],body:e.slice(t[0].length)}:{frontmatter:null,body:e}}import{existsSync as yn,mkdirSync as wn,readFileSync as _n,writeFileSync as kn}from"node:fs";import{dirname as bn,join as Dt}from"node:path";var Rt=/^\[Screenshot: [^\]]+\]\s*$/;function vn(e){let t=e.replace(/\r\n/g,`
+`).split(`
+`),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&&Rt.test(t[i])&&r.set(t[i].trim(),[...s,...t.slice(n+1,i)])}return r}function Sn(e,t,r){let n=[],o=t.replace(/\r\n/g,`
+`).replace(/^\n+/,""),s=r?Ct(r).frontmatter:null,i=o,c=0;if(r){let u=vn(r);u.size>0&&(i=o.split(`
+`).flatMap(l=>{let p=u.get(l.trim());return p&&Rt.test(l)?(c++,[...p,l]):[l]}).join(`
+`))}return c>0&&n.push(`${c} 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}
+
+${i}`.replace(/\n*$/,`
+`),notes:n}}async function $s(e,t=E){let r=L(e.cwd,e.profileName),n=H(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??N(s),c=await t(s,`/v3/projects/${i}/articles/${o.id}`,{query:{content_mode:"raw"}}),d=Dt(e.cwd,e.relPath),u=yn(d)?_n(d,"utf8"):null,l=c.title??"",{content:p,notes:f}=Sn(l,c.content??"",u);return{path:e.relPath,articleId:o.id,title:l,oldContent:u??"",newContent:p,remoteContentHash:B(c.title,c.content),latestVersion:c.latest_version,modifiedAt:c.modified_at,overwritesLocalChanges:u!==null&&o.localHash!==void 0&&U(u)!==o.localHash,notes:f}}function Os(e,t){let r=L(e.cwd,e.profileName),n=Dt(e.cwd,t.path),o=t.oldContent.includes(`\r
+`)?t.newContent.replace(/\n/g,`\r
+`):t.newContent;wn(bn(n),{recursive:!0}),kn(n,o,"utf8"),ne(e.cwd,r.name,t.path,{id:t.articleId,localHash:U(o),remoteContentHash:t.remoteContentHash,remoteVersion:t.latestVersion,remoteModifiedAt:t.modifiedAt})}export{is as AUTH_MODES,te as D360ApiError,A as D360AuthError,Te as EngineSession,V as ProfileConfigError,ir as apiLogDir,Os as applyPull,Kt as buildAuthorizationUrl,ct as categoryMapPath,Sr as classify,Kn as clearTokens,mt as computeSyncStatus,ts as createSession,gt as createV3RemoteProvider,E as d360Get,I as d360GetAll,it as d360Patch,q as d360Post,at as d360Upload,nt as decodeJwtClaims,T as ensureDir,Ge as exchangeCode,fs as findByName,ut as findPathByArticleId,bs as generateTitle,st as getAccessToken,so as getArticle,ps as getSession,U as hashContent,B as hashRemote,yt as inventoryRepo,rt as isExpired,yr as knownEnvironments,on as listSessions,oo as listWorkspaces,H as loadProfileMap,W as loadSessions,be as loadTokens,xe as logApiCall,Se as logBodiesAlways,ee as loggableBody,Wn as loginPkce,hr as normalizeMarkdown,Ft as packageRoot,Le as packageSkillsDir,zt as pickModel,$s as planPull,ge as projectConfigPath,Fe as projectSkillsDir,ze as readMcpConfig,O as readProjectConfig,ye as readUserConfig,Sn as reconstructLocalMarkdown,ne as recordSyncBase,ar as redactSecrets,Ye as refreshTokens,ws as relativeTime,ms as renameSession,L as resolveActiveProfile,as as resolveAuth,oe as resolveConnection,ft as resolveDocsRoot,fo as resolveEnvironment,Mn as resolveModelSetting,He as resolveProfile,N as resolveProjectId,tt as saveTokens,fe as sessionsFilePath,yo as setProfileProject,hs as setTitle,ys as slugify,Ct as splitFrontmatter,xs as suggestNextAction,Qe as toStoredTokens,gs as touchSession,cr as truncateBody,us as upsertSession,ue as userConfigPath,j as userDir,pe as userMcpConfigPath,Nn as writeMcpConfig,We as writeProjectConfig,Un as writeUserConfig};

package/dist/lib/writerMode.d.ts

@@ -0,0 +1,18 @@
+import type { ProjectConfig } from '../config.js';
+/** Harness tools that write files via a `file_path`/`notebook_path` argument. */
+export declare const FILE_EDIT_TOOLS: Set<string>;
+export declare function isDocWritePath(cwd: string, target: string, cfg: ProjectConfig | null): boolean;
+/**
+ * Writer-mode Bash/PowerShell gate: returns the first write target that escapes the
+ * documentation scope, or null when the command writes nothing out of scope.
+ *
+ * HEURISTIC, not a sandbox. It catches the realistic ways an agent would edit source
+ * from a shell — output redirection (`cat > src/x.cs`, `echo >> f`) and the common
+ * write/delete commands (rm/mv/cp/tee/dd/sed -i/…). It deliberately ALLOWS read-only
+ * and unrecognised commands (never break `ls`/`grep`/`git status`/`dotnet --info`),
+ * biasing toward false-negatives over breaking legitimate inspection. Exotic shell
+ * can still escape; the soft system-prompt boundary backs intent for the rest.
+ */
+export declare function bashWriteEscapesScope(command: string, cwd: string, cfg: ProjectConfig | null): string | null;
+/** The deny message names the boundary AND the escape hatch — the agent relays it. */
+export declare function writerModeDenyMessage(target: string): string;

package/dist/scope/inventory.d.ts

@@ -0,0 +1,19 @@
+export type ScopeCandidate = {
+    /** Repo-relative, forward-slash path. */
+    path: string;
+    /** Approximate file count under this folder (capped — for display only). */
+    fileCount: number;
+    /** Detected stacks, e.g. ['.NET'] or ['.NET', 'JS/TS']. */
+    stacks: string[];
+    /** Pre-tick in the picker? */
+    recommended: boolean;
+    /** One-line why, shown in the picker. */
+    reason: string;
+};
+/**
+ * Inventory candidate folders for scoping, repo-relative, forward-slash paths.
+ * Descends through container folders (solution markers, or folders whose children
+ * are projects) and emits a row at each project leaf. Sorted recommended-first;
+ * capped at MAX_ROWS but every recommended (surface) row is always kept.
+ */
+export declare function inventoryRepo(cwd: string): ScopeCandidate[];

package/dist/session.d.ts

@@ -1,3 +1,4 @@
+import { type ArticleDiffEvent } from './d360/tools.js';
 /**
  * UI-agnostic event emitted while the agent works. Wrappers (terminal/desktop)
  * render these; the engine never prints. All variants are plain JSON (IPC-ready).
@@ -18,7 +19,7 @@ export type EngineEvent = {
     id: string;
     output: string;
     isError: boolean;
-} | {
+} | ArticleDiffEvent | {
     type: 'result';
     inputTokens: number;
     outputTokens: number;
@@ -44,9 +45,19 @@ export type CreateSessionOptions = {
 export declare class EngineSession {
     private readonly queue;
     private readonly iterator;
+    private readonly sdkQuery;
+    /** UI-only events from in-process tools (article diffs); drained between SDK messages. */
+    private readonly uiEvents;
     /** The engine's own session UUID, once revealed (for resume/persistence). */
     sessionId: string | null;
     constructor(opts?: CreateSessionOptions);
+    /** Interrupt the in-flight turn (TUI Esc, Claude Code-style). The active send()
+        iteration ends with its result event; the session stays open for further
+        turns. Safe no-op when nothing is running. */
+    interrupt(): Promise<void>;
+    /** Switch the model for subsequent turns WITHOUT restarting the session — the
+        conversation continues. undefined = the runtime's own default chain. */
+    setModel(model?: string): Promise<void>;
     /** Send one user turn; yields EngineEvents until the agent produces its result. */
     send(text: string): AsyncIterable<EngineEvent>;
     close(): void;

package/dist/sync/categoryMap.d.ts

@@ -0,0 +1,39 @@
+/** Article entry in d360-category-map.json (schema v2). Legacy entries are bare
+    UUID strings — loaded as `{ id }` with no base, i.e. sync status unknown-base. */
+export type ArticleSyncEntry = {
+    id: string;
+    /** Hash of the normalized LOCAL .md file at last sync (incl. H1 + screenshot comments). */
+    localHash?: string;
+    /** hashRemote(title, raw content) of the D360 article at last sync. */
+    remoteContentHash?: string;
+    /** latest_version at last sync (best-effort; content hash is the real signal). */
+    remoteVersion?: number;
+    remoteModifiedAt?: string;
+    lastSyncedAt?: string;
+};
+export type ProfileMap = {
+    environment?: string;
+    projectId?: string;
+    workspaceId?: string;
+    /** HEAD commit at the end of the last gap-analysis run (written by the agent;
+        the gap-analysis skill diffs <marker>..HEAD for incremental analysis). */
+    lastAnalyzedCommit?: string;
+    /** Repo-relative folder path (forward slashes) -> category id. */
+    categories: Record<string, string>;
+    /** Repo-relative .md path (forward slashes) -> sync entry (legacy strings normalized). */
+    articles: Record<string, ArticleSyncEntry>;
+};
+export declare function categoryMapPath(cwd: string): string;
+/** Load one profile's section, normalizing legacy bare-UUID article entries. */
+export declare function loadProfileMap(cwd: string, profile: string): ProfileMap | null;
+export declare function findPathByArticleId(map: ProfileMap, articleId: string): string | null;
+/**
+ * Record (or advance) an article's sync base after a successful push/pull. Fresh
+ * read-modify-write of the raw file; only the touched entry becomes an object —
+ * untouched legacy strings stay strings (minimal git diff). No-ops (returns false)
+ * when the map file or profile section is absent, so consumers without a map
+ * (e.g. FlowForge before init) are never affected.
+ */
+export declare function recordSyncBase(cwd: string, profile: string, relPath: string, base: {
+    id: string;
+} & Partial<Omit<ArticleSyncEntry, 'id'>>): boolean;

package/dist/sync/docsRoot.d.ts

@@ -0,0 +1,8 @@
+import type { ProjectConfig } from '../config.js';
+import type { ProfileMap } from './categoryMap.js';
+/**
+ * Where the local docs tree lives, repo-relative: explicit `docsDir` in
+ * .d360-writer.json wins; otherwise inferred as the common first path segment
+ * of the mapped article paths (e.g. "user-docs").
+ */
+export declare function resolveDocsRoot(cfg: ProjectConfig | null, map: ProfileMap | null): string;

package/dist/sync/frontmatter.d.ts

@@ -0,0 +1,10 @@
+/** YAML frontmatter handling for local articles. Frontmatter (e.g. `sources:` lists
+    for gap analysis) lives ONLY in the local markdown — publish strips it, and pull
+    must preserve it. Same delimiter rules as the writer's preview stripFrontmatter
+    (duplicated deliberately — engine and writer stay decoupled). */
+/** Split a markdown document into its leading frontmatter block (delimiters included,
+    null when absent) and the remaining body. */
+export declare function splitFrontmatter(md: string): {
+    frontmatter: string | null;
+    body: string;
+};

package/dist/sync/hash.d.ts

@@ -0,0 +1,7 @@
+/** Canonical form for hashing: BOM stripped, CRLF->LF, exactly one trailing newline.
+    Keeps hashes stable across Windows/Unix checkouts and editor trailing-newline noise. */
+export declare function normalizeMarkdown(s: string): string;
+export declare function hashContent(s: string): string;
+/** Remote identity = title + content (the title lives outside the body on D360,
+    so a title-only edit must still register as remote change). */
+export declare function hashRemote(title: string | undefined, content: string | undefined): string;

package/dist/sync/index.d.ts

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './hash.js';
+export * from './frontmatter.js';
+export * from './categoryMap.js';
+export * from './docsRoot.js';
+export * from './remote.js';
+export * from './status.js';
+export * from './pull.js';

package/dist/sync/pull.d.ts

@@ -0,0 +1,41 @@
+import { type D360Context, type D360RequestOptions } from '../d360/client.js';
+export type PullPlan = {
+    path: string;
+    articleId: string;
+    title: string;
+    /** Current local file content; '' when the file does not exist yet. */
+    oldContent: string;
+    /** Reconstructed local markdown to write. */
+    newContent: string;
+    remoteContentHash: string;
+    latestVersion?: number;
+    modifiedAt?: string;
+    /** True when the local file changed since the last sync base — applying this
+        pull overwrites those edits (the conflict direction-pick). */
+    overwritesLocalChanges: boolean;
+    /** Irreversible-transform warnings the user should see before approving. */
+    notes: string[];
+};
+/**
+ * Rebuild a local article from D360 state. The publish transforms are partially
+ * irreversible — what we can restore (H1 title, screenshot spec comments kept
+ * locally) we do; what we cannot (relative cross-article links flattened to
+ * plain text on publish) is flagged in `notes` for the human reviewing the diff.
+ */
+export declare function reconstructLocalMarkdown(title: string, remoteContent: string, existingLocal: string | null): {
+    content: string;
+    notes: string[];
+};
+type GetFn = <T>(ctx: D360Context, path: string, opts?: D360RequestOptions) => Promise<T>;
+export type PullOptions = {
+    cwd: string;
+    profileName?: string;
+};
+/** Fetch the remote article for a mapped path and build the local write plan.
+    Pure read — nothing is written until applyPull. */
+export declare function planPull(opts: PullOptions & {
+    relPath: string;
+}, get?: GetFn): Promise<PullPlan>;
+/** Write the pulled content and advance the sync base to the pulled state. */
+export declare function applyPull(opts: PullOptions, plan: PullPlan): void;
+export {};

package/dist/sync/remote.d.ts

@@ -0,0 +1,37 @@
+import { type D360Context, type D360RequestOptions } from '../d360/client.js';
+export type RemoteArticleState = {
+    id: string;
+    title?: string;
+    categoryId?: string;
+    hidden?: boolean;
+    /** Populated only for ids requested in fetch(detailIds). */
+    latestVersion?: number;
+    modifiedAt?: string;
+    contentHash?: string;
+    content?: string;
+};
+export type RemoteCategoryState = {
+    id: string;
+    name?: string;
+    parentId?: string;
+};
+export type RemoteState = {
+    articles: Map<string, RemoteArticleState>;
+    categories: Map<string, RemoteCategoryState>;
+};
+/**
+ * The replaceable seam between sync and the Document360 API. Today's v3 API
+ * forces 1 listing + N per-article detail calls; when the workspace-manifest
+ * endpoint (server-computed content hashes) lands, only this provider changes.
+ */
+export interface RemoteStateProvider {
+    /** detailIds: article ids needing version/hash/content (the mapped set).
+        The full workspace article listing is always returned. */
+    fetch(detailIds: string[]): Promise<RemoteState>;
+}
+/** Injected in tests; defaults to the real HTTP client. */
+export type RemoteFetchers = {
+    getAll: <T>(ctx: D360Context, path: string, opts?: D360RequestOptions) => Promise<T[]>;
+    get: <T>(ctx: D360Context, path: string, opts?: D360RequestOptions) => Promise<T>;
+};
+export declare function createV3RemoteProvider(ctx: D360Context, projectId: string, workspaceId: string, fetchers?: RemoteFetchers): RemoteStateProvider;

package/dist/sync/status.d.ts

@@ -0,0 +1,27 @@
+import { type RemoteStateProvider } from './remote.js';
+import type { SyncStatus, SyncStatusReport } from './types.js';
+/** Pure three-way classification of one article against its recorded base. */
+export type ClassifyInput = {
+    mapped: boolean;
+    localExists: boolean;
+    remoteExists: boolean;
+    /** Entry has both localHash and remoteContentHash recorded. */
+    hasBase: boolean;
+    localHashNow?: string;
+    baseLocalHash?: string;
+    remoteContentHashNow?: string;
+    baseRemoteContentHash?: string;
+};
+export declare function classify(i: ClassifyInput): SyncStatus;
+export type ComputeSyncStatusOptions = {
+    cwd: string;
+    profileName?: string;
+    /** Test/manifest-endpoint injection; defaults to the v3 list+detail provider. */
+    provider?: RemoteStateProvider;
+};
+/**
+ * Deterministic local<->Document360 drift report for the active profile. No LLM
+ * involved: 1 article listing + 1 category listing + N article-detail calls
+ * (N = mapped articles) until the manifest endpoint replaces the provider.
+ */
+export declare function computeSyncStatus(opts: ComputeSyncStatusOptions): Promise<SyncStatusReport>;

package/dist/sync/types.d.ts

@@ -0,0 +1,22 @@
+/** Per-article classification against the recorded sync base (three-way, git-style). */
+export type SyncStatus = 'in-sync' | 'local-ahead' | 'remote-ahead' | 'conflict' | 'untracked-local' | 'untracked-remote' | 'deleted-local' | 'deleted-remote' | 'orphaned' | 'unknown-base';
+export type SyncEntryState = {
+    /** Repo-relative path with forward slashes; null for untracked-remote. */
+    path: string | null;
+    /** Document360 article id; null for untracked-local. */
+    articleId: string | null;
+    title?: string;
+    status: SyncStatus;
+    /** Human context, e.g. "draft edited 2026-06-10 (v3)". */
+    detail?: string;
+};
+export type SyncStatusReport = {
+    profile: string;
+    projectId: string;
+    workspaceId: string;
+    /** Repo-relative docs root that was scanned. */
+    docsRoot: string;
+    entries: SyncEntryState[];
+    counts: Partial<Record<SyncStatus, number>>;
+    generatedAt: string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document360-engine",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Headless documentation agent engine for document360-writer / -desktop. Emits a typed event stream; no UI.",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,7 +18,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc -b",
+    "build": "rimraf dist tsconfig.tsbuildinfo && tsc -b && node ../../scripts/bundle.mjs",
     "clean": "rimraf dist",
     "prepublishOnly": "npm run build",
     "test": "vitest run"
@@ -31,7 +31,7 @@
     "url": "git+https://github.com/saravana-mv/document360-writer.git",
     "directory": "packages/engine"
   },
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.150",
     "zod": "^4.4.3"