document360-writer 0.5.115 → 0.5.117

package/dist/cli.js

@@ -312,7 +312,7 @@ ${s}${m}`).join("")}).join(`
 `+cp[e.tone](bn(dp(e.text)));case"done":{let o=e.inTokens&&e.inTokens>0?` \xB7 ${Cn(e.inTokens)} in${e.cachedPct!=null?` (${e.cachedPct}% cached)`:""}`:"";return`
 `+(e.ok?Z.magenta("\u2736 "):Z.red("\u2736 "))+Z.gray(`Cooked for ${Rn(e.seconds)} \xB7 ${Cn(e.tokens)} tokens out${o}`+(e.costUsd>0?` \xB7 ${be(e.costUsd)}`:""))}}}function Xa(e,t){return e.map(n=>Jr(n,t)).join(`
 `)}import{resolveActiveProfile as up,loadTokens as pp,isExpired as fp,decodeJwtClaims as Qa}from"document360-engine";function hp(e){return e.length>12?`${e.slice(0,8)}\u2026`:e}function Ne(e,t){try{let n=up(e,t),o=pp(n.name);if(!o)return{ok:!1,reason:`Not signed in to Document360 (profile "${n.name}"). Run /login first.`};if(fp(o)&&!o.refreshToken)return{ok:!1,reason:`Your Document360 session expired (profile "${n.name}"). Run /login.`};let r=n.project.projectId;if(r){let l={...Qa(o.idToken)??{},...Qa(o.accessToken)??{}}.doc360_project_id;if(typeof l=="string"&&l&&l!==r)return{ok:!1,reason:`Your Document360 session is signed into a different project than profile "${n.name}" (this profile's project is ${hp(r)}). Run /login and pick this project.`}}return{ok:!0}}catch{return{ok:!0}}}var Pn=3;function Zr(e){return[`Run the publish-to-d360 skill for the article at: ${e}`,"","Steps you must follow:","1. Read the article markdown \u2014 use the repo-relative path exactly as given above (it resolves against the working directory; do not reconstruct an absolute path).","2. Compute the D360 publish form (strip the YAML frontmatter and the H1 title, strip every <!-- SCREENSHOT ... --> block while keeping the visible [Screenshot: ...] line, normalize cross-article links).","3. Look up the article ID in <repo>/d360-category-map.json. If present, call the document360 MCP update-article tool. If absent, call create-article with local_path set to the repo-relative .md path (the tool records the new ID + sync base in the category map itself \u2014 do not edit the articles map by hand).","4. Report what changed and remind me to publish the draft manually in the Document360 portal."].join(`
-`)}var Ja={"local-ahead":"modified locally","untracked-local":"new (never published)",conflict:"\u26A0 conflict \u2014 publishing overwrites the portal edit"};function es(e){return e.filter(t=>t.path!==null&&t.status in Ja&&!t.link).map(t=>({path:t.path,label:Ja[t.status]}))}function So(e){let t=es(e),n=new Set(e.filter(o=>o.status==="conflict"&&o.path).map(o=>o.path));return{clean:t.filter(o=>!n.has(o.path)),conflicts:t.filter(o=>n.has(o.path))}}function Do(e){let t=e!==1;return`\u26A0 ${e} conflict${t?"s":""} NOT published (portal edit${t?"s":""} kept safe) \u2014 ${t?"these were":"it was"} edited both here and on the portal, so ${t?"they are":"it is"} left untouched. Settle ${t?"them":"it"}: /resolve  (or /publish <path> to keep yours, /pull <path> to take the portal's).`}function jo(e){return e.filter(t=>t.link).length}function ts(e,t){try{let n=$p(e,xp(e,t).name);if(!n)return null;let o=0;for(let r of Object.keys(n.articles))try{o+=Cp(mp(gp(e,r),"utf8"),r,n).unresolved}catch{}return o===0?null:`\u2139 ${o} cross-link${o===1?"":"s"} point to pages not published yet \u2014 they show as plain text for now and turn into live links once those pages are published.`}catch{return null}}function Rp(e){let t=e.replace(/\\/g,"/").split("/").pop()??e,n=t.replace(/^\d+[-_]/,"").replace(/[-_]+/g," ").trim();return n?n.charAt(0).toUpperCase()+n.slice(1):t}function ol(e,t=[]){let n=[];e.length>1&&n.push({kind:"all",label:`Publish all ${e.length} articles`,paths:e.map(r=>r.path),indent:!1});let o=new Map;for(let r of e){let s=r.path.replace(/\\/g,"/").split("/").slice(0,-1).join("/"),l=o.get(s);l?l.push(r):o.set(s,[r])}for(let r of[...o.keys()].sort()){let s=o.get(r).sort((l,p)=>l.path.localeCompare(p.path));n.push({kind:"category",label:`${Rp(r)}  (${s.length})`,paths:s.map(l=>l.path),indent:!1});for(let l of s){let p=l.path.replace(/\\/g,"/").split("/").pop()??l.path;n.push({kind:"article",label:p,paths:[l.path],indent:!0,note:l.label})}}for(let r of[...t].sort((s,l)=>s.path.localeCompare(l.path))){let s=r.path.replace(/\\/g,"/").split("/").pop()??r.path;n.push({kind:"article",label:s,paths:[r.path],indent:!1,note:r.label,conflict:!0})}return n}function Ao(e){return[`Run the publish-to-d360 skill for ALL of these ${e.length} articles, one by one:`,"",...e.map(t=>`- ${t}`),"","Use the repo-relative paths exactly as listed (they resolve against the working directory; do not reconstruct absolute paths). Apply the normal per-article publish flow (frontmatter/H1/screenshot-comment strips, link normalization; update when mapped, create with local_path when not). If one article fails, note it and continue. Finish with a summary table (article | created/updated | failures) and remind me drafts need review in the portal."].join(`
+`)}var Ja={"local-ahead":"modified locally","untracked-local":"new (never published)",conflict:"\u26A0 conflict \u2014 publishing overwrites the portal edit"};function es(e){return e.filter(t=>t.path!==null&&t.status in Ja&&!t.link).map(t=>({path:t.path,label:Ja[t.status]}))}function So(e){let t=es(e),n=new Set(e.filter(o=>o.status==="conflict"&&o.path).map(o=>o.path));return{clean:t.filter(o=>!n.has(o.path)),conflicts:t.filter(o=>n.has(o.path))}}function Do(e){let t=e!==1;return`\u26A0 ${e} conflict${t?"s":""} NOT published (portal edit${t?"s":""} kept safe) \u2014 ${t?"these were":"it was"} edited both here and on the portal, so ${t?"they are":"it is"} left untouched. Settle ${t?"them":"it"}: /resolve  (or /publish <path> to keep yours, /pull <path> to take the portal's).`}function jo(e){return e.filter(t=>t.link).length}function ts(e,t){try{let n=$p(e,xp(e,t).name);if(!n)return null;let o=0;for(let r of Object.keys(n.articles))try{o+=Cp(mp(gp(e,r),"utf8"),r,n).unresolved}catch{}return o===0?null:`\u2139 ${o} cross-link${o===1?"":"s"} point to pages not published yet \u2014 they show as plain text for now and turn into live links once those pages are published.`}catch{return null}}function Rp(e){let t=e.replace(/\\/g,"/").split("/").pop()??e,n=t.replace(/^\d+[-_]/,"").replace(/[-_]+/g," ").trim();return n?n.charAt(0).toUpperCase()+n.slice(1):t}function ol(e,t=[]){let n=[];e.length>1&&n.push({kind:"all",label:`Publish all ${e.length} articles`,paths:e.map(r=>r.path),indent:!1});let o=new Map;for(let r of e){let s=r.path.replace(/\\/g,"/").split("/").slice(0,-1).join("/"),l=o.get(s);l?l.push(r):o.set(s,[r])}for(let r of[...o.keys()].sort()){let s=o.get(r).sort((l,p)=>l.path.localeCompare(p.path));n.push({kind:"category",label:`${Rp(r)}  (${s.length})`,paths:s.map(l=>l.path),indent:!1});for(let l of s){let p=l.path.replace(/\\/g,"/").split("/").pop()??l.path;n.push({kind:"article",label:p,paths:[l.path],indent:!0,note:l.label})}}for(let r of[...t].sort((s,l)=>s.path.localeCompare(l.path))){let s=r.path.replace(/\\/g,"/").split("/").pop()??r.path;n.push({kind:"article",label:s,paths:[r.path],indent:!1,note:r.label,conflict:!0})}return n}function Ao(e){return[`Run the publish-to-d360 skill for ALL of these ${e.length} articles, one by one:`,"",...e.map(t=>`- ${t}`),"","Use the repo-relative paths exactly as listed (they resolve against the working directory; do not reconstruct absolute paths). Apply the normal per-article publish flow (frontmatter/H1/screenshot-comment strips, link normalization; update when mapped, create with local_path when not). Compute each publish form IN MEMORY and pass it straight to the tool \u2014 NEVER write it to disk (no *.publish.md siblings, no temp copies anywhere in the docs tree; the local .md files stay untouched). If one article fails, note it and continue. Finish with a summary table (article | created/updated | failures) and remind me drafts need review in the portal."].join(`
 `)}function ns(e,t,n){let o=v=>t[v.index]?.paths.length??0,r=e.filter(v=>v.ok),s=e.filter(v=>!v.ok),l=e.reduce((v,_)=>v+o(_),0),p=r.reduce((v,_)=>v+o(_),0),m=n==="api"?`${be(e.reduce((v,_)=>v+_.costUsd,0))} total`:rt(e.reduce((v,_)=>v+_.outputTokens,0)),k=`${r.length}/${e.length} partition${e.length===1?"":"s"}`,g=v=>`${v} article${v===1?"":"s"}`,T=[];if(s.length===0)T.push(`Published ${g(l)} (${k}) successfully \xB7 ${m}.`),T.push("All are DRAFTS \u2014 review and publish them in the Document360 portal.");else{T.push(`Published ${p}/${g(l)} (${k}) \xB7 ${m}.`),T.push(`${s.length} partition${s.length===1?"":"s"} failed \u2014 re-run /publish --all to retry just the rest (published articles are skipped):`);for(let v of s)T.push(`  \u2717 ${v.label}${v.error?` \u2014 ${v.error}`:""}`)}return T}async function vt(e,t){let{model:n}=bp(e.cwd,"standard"),o=async(r,s)=>{let l=yp(r);console.log(f(s?`Resolving cross-links in ${r.length} article${r.length===1?"":"s"} whose targets published this run (second pass)\u2026`:`Publishing ${r.length} article${r.length===1?"":"s"} across ${l.length} partition${l.length===1?"":"s"} (\u2264${Pn} agents at once) on ${n}\u2026`)),s||console.log(f("  (mid-run abort is TUI-only \u2014 Ctrl+C exits the REPL.)"));let p=!1;for await(let m of vp({cwd:e.cwd,partitions:l,promptFor:k=>Ao(k.paths),concurrency:Pn,profileName:e.profileName,allowProdWrites:e.allowProdWrites(),model:n}))if(m.type==="partition_status")m.status==="running"?console.log(f(`  \u25B8 ${m.label} \u2014 publishing\u2026`)):m.status==="done"?console.log(D(`  \u2713 ${m.label}`)):console.log(R(`  \u2717 ${m.label}`));else if(m.type==="run_done"){p=m.aborted,console.log("");let k=process.env.ANTHROPIC_API_KEY?"api":"subscription";for(let T of ns(m.results,l,k))console.log(m.ok?D(T):L(T));let g=ts(e.cwd,e.profileName);g&&console.log(f(g));try{let T=el(await Za({cwd:e.cwd,profileName:e.profileName}));T&&console.log(f(T))}catch{}try{let T=nl(await tl({cwd:e.cwd,profileName:e.profileName}));T&&console.log(f(T))}catch{}}return p};try{if(!await o(t,!1)){let s=await os(e.cwd,e.profileName,t);s.length>0&&await o(s,!0)}}catch(r){console.log(R(`Publish run failed: ${r.message}`))}return console.log(""),{kind:"continue"}}async function Eo(e,t,n){let o=kp(e,n);if(o.length===0)return[];let r=new Set(es((await To({cwd:e,profileName:t})).entries).map(s=>s.path));return o.filter(s=>r.has(s))}async function os(e,t,n){try{let o=new Set(n),r=await To({cwd:e,profileName:t});return es(r.entries).map(s=>s.path).filter(s=>o.has(s))}catch{return[]}}async function rl(e,t){let n=Ne(t?.cwd??process.cwd(),t?.profileName);if(!n.ok)return console.log(R(n.reason)),{kind:"continue"};let o=e[0];if(o==="--related"&&e[1]){if(!t)return{kind:"continue"};let r=await Eo(t.cwd,t.profileName,e[1].replace(/\\/g,"/"));return r.length===0?(console.log(D("\u2713 All related articles are already published.")),{kind:"continue"}):await vt(t,r)}if(o==="--all"){console.log(f("Checking what needs publishing\u2026"));try{let r=await To({cwd:t?.cwd??process.cwd()}),{clean:s,conflicts:l}=So(r.entries),p=jo(r.entries),m=e.includes("--force")&&l.length>0;p>0&&console.log(L(`\u26A0 ${p} article(s) already exist on Document360 but aren't linked \u2014 left out (publishing would duplicate them). Run /catch-up or ask me to link them first.`)),l.length>0&&!m&&console.log(L(Do(l.length)));let k=m?[...s,...l]:s;if(k.length===0){if(l.length>0)return console.log(f("Resolve the conflicts: /resolve")),{kind:"continue"};if(console.log(D(p>0?"\u2713 Nothing else is ahead of Document360 to publish.":"\u2713 Nothing is ahead of Document360 \u2014 no publish candidates.")),t)try{let g=el(await Za({cwd:t.cwd,profileName:t.profileName}));g&&console.log(f(g));let T=nl(await tl({cwd:t.cwd,profileName:t.profileName}));T&&console.log(f(T))}catch{}return{kind:"continue"}}return t?await vt(t,k.map(g=>g.path)):{kind:"forward-to-agent",prompt:Ao(k.map(g=>g.path)),display:"/publish --all"}}catch(r){return console.log(R(`Could not compute sync status: ${r.message}`)),{kind:"continue"}}}if(o&&o.startsWith("--")&&(o=e.find(r=>!r.startsWith("--"))??""),!o){console.log(f("Checking what needs publishing\u2026"));let r;try{let s=await To({cwd:t?.cwd??process.cwd()}),{clean:l,conflicts:p}=So(s.entries);r=l;let m=jo(s.entries);if(m>0&&console.log(L(`\u26A0 ${m} article(s) already exist on Document360 but aren't linked \u2014 left out (publishing would duplicate them). Run /catch-up or ask me to link them first.`)),p.length>0&&console.log(L(Do(p.length))),r.length===0&&p.length>0)return console.log(f("Resolve the conflicts: /resolve")),{kind:"continue"}}catch(s){return console.log(R(`Could not compute sync status: ${s.message}`)),console.log(f("Publish a specific article: /publish <article-path>")),{kind:"continue"}}if(r.length===0)return console.log(D("\u2713 Nothing is ahead of Document360 \u2014 no publish candidates.")),console.log(f("  (Articles without a sync base are unverified \u2014 publish those by path if needed.)")),{kind:"continue"};if(!process.stdin.isTTY||!t){for(let s of r)console.log(`  ${s.path}  ${f(`(${s.label})`)}`);return console.log(f("Run: /publish <article-path>")),{kind:"continue"}}try{o=await t.withPausedInput(()=>wp({message:"Publish which article?",choices:[...r.length>1?[{name:`All ${r.length} candidates`,value:"--all",description:"one agent run over every candidate"}]:[],...r.map(s=>({name:s.path,value:s.path,description:s.label}))]}))}catch{return console.log(f("Cancelled.")),{kind:"continue"}}if(o==="--all")return await vt(t,r.map(s=>s.path))}return{kind:"forward-to-agent",prompt:Zr(o),display:`/publish ${o}`}}async function Tn(){return{kind:"forward-to-agent",prompt:["Run the gap-analysis skill against this repo.","","Follow its stages in order:","1. d360_sync_status first \u2014 stop and report if any article is in conflict or remote-ahead (the local copy cannot be trusted until resolved).","2. git diff since the lastAnalyzedCommit marker in d360-category-map.json (or last 30 days if no marker), filtered to the authoritativeSourceFiles paths.","2.5. d360_pending_hints \u2014 the source agent's own notes on what it shipped. Verify each (sources exist, commit is an ancestor of HEAD, source shows the surface) before trusting; fold verified ones into the table, flag the rest.","3. Map changes (diff + hints) to articles via their `sources:` frontmatter; read only implicated articles and changed source files. If articles are missing `sources:`, this is the one-time bootstrap pass \u2014 backfill them.","4. Output the proposal table: | Article (path or proposed title) | Action (create | update | retire | link) | Reason | Evidence | Scope |, then advance lastAnalyzedCommit and stamp consumed hints.","","Do not start writing or updating any article yet \u2014 the proposal table is the deliverable."].join(`
 `),display:"/audit"}}W();import{readProjectConfig as Pp}from"document360-engine";function rs(){return["Run the discover-product skill against this repo.","","Build (or continue refining) the product brief at `.d360-writer/product-brief.md` by interviewing the","source repo's coding agent (the builder):","1. Gather all grounding \u2014 the code surface (analyze-codebase pass), `.d360-writer/architecture/`","   (+ CREATOR-NOTES), any specs under `.d360-writer/input/`, existing docs, git log, and the current","   product brief if one exists.","2. Self-assess against the 8-point readiness rubric (identity, audience, core mental model,","   misconceptions, positioning, key concepts & terminology, critical journeys, boundaries/non-goals).","3. Write/update the brief \u2014 every claim cited to its grounding \u2014 and keep its frontmatter current","   (status, rounds, open_questions, last_updated).","4. For the dimensions you cannot yet ground confidently, ask the builder a focused batch (\u22646) of pointed",'   questions via d360_ask_builder, with the subject prefixed "[discovery] ". Then END the turn \u2014 the',"   builder answers async; /catch-up will ingest the answers and continue the loop.","","Set status: confident and hand off to propose-structure ONLY when every rubric dimension passes. If the","builder stays silent across a few rounds, degrade gracefully per the skill (best-effort brief, flagged","open questions) rather than blocking the docs. Do NOT write or publish any articles in this turn."].join(`
 `)}async function sl(e,t){let n=t?.cwd??process.cwd();return Pp(n)?{kind:"forward-to-agent",prompt:rs(),display:"/discover"}:(console.log(R("No d360-writer config here. Run /init first.")),{kind:"continue"})}W();import{checkbox as Tp}from"@inquirer/prompts";import{inventoryRepo as Sp,readProjectConfig as il,writeProjectConfig as Dp}from"document360-engine";function ss(e,t){let n=il(e);n&&(n.authoritativeSourceFiles=t,Dp(n,e))}function No(e){let t=[`${e.fileCount}${e.fileCount>=5e3?"+":""} files`];return e.stacks.length&&t.push(e.stacks.join("+")),t.push(e.reason),t.join(" \xB7 ")}async function al(e,t){let n=t?.cwd??process.cwd();if(!il(n))return console.log(R("No .d360-writer/config.json here. Run /init first.")),{kind:"continue"};let o=Sp(n);if(o.length===0)return console.log(f('No candidate source folders found. Set "authoritativeSourceFiles" in .d360-writer/config.json manually.')),{kind:"continue"};if(!process.stdin.isTTY||!t){console.log(""),console.log(O("Recommended documentation scope (run /scope in the REPL to choose):"));for(let s of o)console.log(`  ${s.recommended?"\u25C9":"\u25CB"} ${s.path}  ${f(No(s))}`);return console.log(""),{kind:"continue"}}let r;try{r=await t.withPausedInput(()=>Tp({message:"Which folders back the user docs? (space toggles, enter confirms)",choices:o.map(s=>({name:`${s.path}  (${No(s)})`,value:s.path,checked:s.recommended})),pageSize:20}))}catch{return console.log(f("Cancelled.")),{kind:"continue"}}if(r.length===0)return console.log(f("Nothing selected \u2014 scope unchanged.")),{kind:"continue"};ss(n,r),console.log(D(`\u2713 Scoped to ${r.length} folder(s) \u2014 written to .d360-writer/config.json`));for(let s of r)console.log(`  ${s}`);return console.log(""),{kind:"continue"}}W();import{confirm as Up}from"@inquirer/prompts";import{applyPull as ls,computeSyncStatus as gl,compareRemoteSources as Wp,planPull as wl,planImport as Fp,applyImport as Hp,establishBaselines as qp,rebaselineServerMeta as Bp,D360AuthError as Vp}from"document360-engine";W();var ll=[{status:"conflict",header:"Changed in both places \u2014 pick a direction (/pull <path> or /publish <path>):",paint:R,mark:"!"},{status:"local-ahead",header:"Changed here \u2014 push with /publish <path>:",paint:L,mark:"M"},{status:"remote-ahead",header:"Changed on Document360 \u2014 pull with /pull <path> (or just /pull):",paint:O,mark:"M"},{status:"deleted-local",header:"Removed locally \u2014 still on Document360 (pull to restore, or leave it):",paint:R,mark:"D"},{status:"deleted-remote",header:"Gone from Document360 \u2014 still here (publish to recreate, or delete the file):",paint:R,mark:"D"},{status:"orphaned",header:"Gone from both sides \u2014 these tracking entries point at nothing now:",paint:ie,mark:"X"},{status:"untracked-local",header:"New here \u2014 not on Document360 yet (publish to add them):",paint:f,mark:"?"},{status:"untracked-remote",header:"On Document360 \u2014 not in your local docs yet (run /pull to import them):",paint:f,mark:"?"},{status:"unknown-base",header:"Tracked, not yet compared \u2014 run /pull --baseline to set a baseline (or the next publish/pull sets one):",paint:ie,mark:"\xB7"}];function jp(e){return e.path?e.path:`${e.title??"(untitled)"}  ${ie(`[${e.articleId}]`)}`}function Ap(e){let t=e/1e3;if(t<60)return`${t.toFixed(1)}s`;let n=Math.floor(t/60);return`${n}m ${Math.round(t-n*60)}s`}function Io(e,t){let n=[],o=e.entries.filter(g=>g.link);if(o.length>0){n.push(""),n.push(ke("Already on Document360, just not linked \u2014 ask me to link these (a republish would duplicate them):"));for(let g of o)n.push(`  ${L("~")} ${L(g.path??"")}  ${ie(`\u2192 "${g.link.title}"`)}`)}for(let g of ll){let T=e.entries.filter(v=>v.status===g.status&&!(g.status==="untracked-local"&&v.link));if(T.length!==0){n.push(""),n.push(ke(g.header));for(let v of T)n.push(`  ${g.paint(g.mark)} ${g.paint(jp(v))}${v.detail?ie(`  (${v.detail})`):""}`)}}let r=e.counts["in-sync"]??0,s=e.entries.length;n.push("");let l={"in-sync":"up to date","local-ahead":"changed here","remote-ahead":"changed on Document360",conflict:"changed both places","untracked-local":"new here","untracked-remote":"only on Document360","deleted-local":"removed locally","deleted-remote":"gone from Document360",orphaned:"gone both sides","unknown-base":"not yet compared"},p=o.length,m=s===r?D("\u2713 everything up to date"):[r>0?D(`\u2713 ${r} up to date`):null,p>0?`${p} to link`:null,...ll.map(g=>{let T=(e.counts[g.status]??0)-(g.status==="untracked-local"?p:0);return T>0?`${T} ${l[g.status]}`:null})].filter(Boolean).join(ie(" \xB7 ")),k=t!==void 0?` \xB7 synced in ${Ap(t)}`:"";return n.push(m+ie(` \xB7 ${s} tracked+seen \xB7 profile "${e.profile}" \xB7 docs root ${e.docsRoot}/${k}`)),n}import{structuredPatch as Ep}from"diff";import cl from"picocolors";var dl=80,Np="\x1B[48;2;74;28;28m",Ip="\x1B[48;2;24;66;24m",ul="\x1B[49m",is=e=>String(e).padStart(5);function pl(e,t){let n=Math.min(e.length,t.length),o=0;for(;o<n&&e[o]===t[o];)o++;return o}function fl(e,t,n){if(n===void 0||n<t-4)return e.slice(0,t);let o=Math.max(0,n-12);return`\u2026${e.slice(o).slice(0,Math.max(8,t-1))}`}function Ye(e,t,n){let o=v=>{let _=v.replace(/\r\n/g,`
@@ -344,7 +344,7 @@ Articles:
 `),display:"/capture-setup"}}var ec="-".repeat(64);function Hs(e){let t=Ch;try{let g=xh(e);g?.captureDir&&(t=g.captureDir.replace(/\\/g,"/").replace(/\/+$/,""))}catch{}let n=bh(t)?vh(t,"CAPTURE-TESTID-REQUESTS.json"):$h(e,t,"CAPTURE-TESTID-REQUESTS.json");if(!yh(n))return null;let o;try{let g=JSON.parse(kh(n,"utf8").replace(/^/,""));o=Array.isArray(g?.requests)?g.requests:[]}catch{return null}if(o.length===0)return null;let r=new Set(o.map(g=>g.file).filter(Boolean)).size,s=o.length,l=`${s} data-testid attribute${s===1?"":"s"}`,p=`${r} source file${r===1?"":"s"}`,m=`${t}/CAPTURE-TESTID-REQUESTS.md`,k=`${t}/CAPTURE-TESTID-REQUESTS.json`;return[`\u{1F4CB} Developer hand-off \u2014 ${l} requested across ${p}.`,"\u26A0 Do NOT run this prompt here. d360-writer documents code; it does not change it \u2014","  these edits belong in your code repo. Open a SEPARATE terminal in:",`      ${e}`,"  start Claude Code (or your coding agent), and paste everything between the lines.","  Tip: run it in plan mode first \u2014 these are a hypothesis to verify, not a verified patch.","",ec,`Read ${m} and ${k}. They list ${l} that d360-writer THINKS this repo needs for screenshot automation. Treat them as a hypothesis to VERIFY against the source \u2014 not a verified patch list.`,"","For EACH request in the JSON:",'1. Locate the element in THIS repo. Trace it from the route/page, not the feature name. If "anchorVerified" is false, find it by the "element"/"reason" description; otherwise confirm the "anchor" snippet still exists in "file".',"2. If the element already has a data-testid, skip it and note the existing one.","3. Confirm the attribute will reach the DOM: the rendering component must forward unknown props (a {...rest} spread or explicit pass-through). If it is a shared wrapper (e.g. Modal, ContextMenu) that destructures a fixed prop list, a data-testid is silently dropped \u2014 thread it through the component, or report it as needing a code change instead of forcing it.",'4. Only then add data-testid="<testid>" to the verified element. Add nothing else; do not rename, restructure, reformat, or change behaviour.',"","When done, report: which testids you added (file + element), which were already present, which requests were wrong (wrong file/anchor/page) with the correction, and which need threading through a shared component. Never force a request that does not match the source \u2014 flag it instead.",ec]}nt();W();import{listOpenForDocs as Rh,readProjectConfig as Ph}from"document360-engine";function qs(e){try{return Rh(e).length}catch{return 0}}function Bs(){return["Process the two-way message inbox from the source repo's coding agent (the builder).","","1. Call d360_inbox to list the OPEN messages addressed to you.","2. For each message, act by its kind:",'   \u2022 request ("document the X we shipped") \u2192 treat it as a session hand-off: run the document-handoff',"     skill \u2014 read what changed, ground it in the cited sources + the architecture brief, then decide and","     apply the RIGHT doc action (new section, new article, update existing, or retire). No fixed shape.",'   \u2022 answer to a [discovery]-tagged question (subject starts "[discovery] ") \u2192 this is product-discovery,',"     not an article edit: fold the fact into `.d360-writer/product-brief.md` (updating the cited grounding,","     clearing the matching OPEN marker), then RE-RUN the discover-product readiness assessment \u2014 set the","     brief's frontmatter status to `confident` and offer propose-structure if every rubric dimension now","     passes, else ask the next focused batch via d360_ask_builder. Do not touch articles for these.",'   \u2022 answer to a [depth]-tagged question (subject starts "[depth] ") \u2192 this is per-feature depth-mining,',"     not the brief and not an article edit: fold it into the DOCS PLAN per propose-structure's","     depth-reconcile \u2014 adjust that feature's article palette in plan.json/AGENT-PLAN.md (add rows citing","     the answer's .d360-writer/messages/ file in `sources`, never renumber existing rows), decrement","     open_depth_questions in AGENT-PLAN.md's frontmatter, and flip status to `pinned` at zero.","   \u2022 answer (a reply to any other question you asked; `re` = your question id) \u2192 fold the fact into the","     affected article(s), and into `.d360-writer/architecture/` if it is durable product knowledge.","3. After acting on a message, mark it resolved: edit its file in `.d360-writer/messages/` and set the","   frontmatter `status: done` (add `done_at` with the current UTC time). Never delete the file.","4. Drafts only \u2014 do not publish unless explicitly asked. End with a one-line summary of what you did per","   message (and, for any request you could not fully ground, what you still need)."].join(`
 `)}async function tc(e,t){let n=t?.cwd??process.cwd();return Ph(n)?qs(n)===0?(console.log(f("Inbox empty \u2014 no open messages from the builder. (They arrive via the builder's /devhints hand-off.)")),{kind:"continue"}):{kind:"forward-to-agent",prompt:Bs(),display:"/inbox"}:(console.log(R("No d360-writer config here. Run /init first.")),{kind:"continue"})}W();import{listOpenHints as Th,listOpenForDocs as Sh,listOpenDirectives as Dh,readProjectConfig as jh,computeSyncStatus as Ah,planPull as Eh,applyPull as Nh,planImport as Ih,applyImport as _h}from"document360-engine";function En(e){let t=0,n=0,o=0,r=0;try{t=Th(e).length}catch{}try{let s=Sh(e);n=s.filter(l=>l.kind==="request").length,o=s.filter(l=>l.kind==="answer").length}catch{}try{r=Dh(e).length}catch{}return{hints:t,requests:n,answers:o,directives:r}}function Nn(e){let t=[];return e.hints&&t.push(`${e.hints} hint${e.hints===1?"":"s"}`),e.requests&&t.push(`${e.requests} request${e.requests===1?"":"s"}`),e.answers&&t.push(`${e.answers} answer${e.answers===1?"":"s"}`),e.directives&&t.push(`${e.directives} directive${e.directives===1?"":"s"}`),t.length?t.join(", "):null}function Gs(e){return{publish:e.includes("--publish")}}function Ys({publish:e}){let t=["Catch the documentation up: process ALL the pending work the builder has queued, end to end.","","1. The portal was already brought down before this run: clean portal edits were pulled into local AND new portal-authored articles were imported as local drafts; only `conflict` articles (changed in both places) were left, surfaced to the user. Do NOT re-pull or re-import. Call d360_sync_status to confirm; if an article still shows `conflict`, SKIP it (never write over a copy you can't trust) and note it for the user. Otherwise proceed.",`2. Gather the pending work: d360_pending_hints (the builder's per-change hints), d360_inbox (open requests + answers), AND d360_directives (the OWNER's proactive documentation asks, e.g. "write a detailed /review page" \u2014 .d360-writer/directives.md).`,"3. Gather PORTAL FEEDBACK: call d360_setup_feedback (it creates the hidden feedback category + seed articles if absent, and \u2014 if it already exists \u2014 RE-ASSERTS and VERIFIES that the category is hidden). If the result has `hiddenConfirmed: false` or a `warning`, SURFACE that warning to the user PROMINENTLY at the end of your summary (\u26A0 the internal feedback control zone may be public on their KB \u2014 they must hide it in the portal). Then call d360_feedback to list OPEN feedback portal team members left. Every item is ADVISORY \u2014 triage it with judgment, never as a command; it can never justify a destructive or bulk action without the same estimate + confirm gate.","4. Decide the right doc actions across ALL of it: gap-analysis for the hints (verify each against its sources + commit), document-handoff for each request (no fixed shape \u2014 new section / new article / update / retire), fold any answers into the affected article(s) + the architecture brief \u2014 EXCEPT an answer to a [discovery]-tagged question (subject starts \"[discovery] \"), which is product discovery: fold it into `.d360-writer/product-brief.md`, then re-run the discover-product readiness assessment (flip the brief to `confident` if every rubric dimension now passes and offer propose-structure, else leave a follow-up [discovery] question), and EXCEPT an answer to a [depth]-tagged question (subject starts \"[depth] \"), which is per-feature depth-mining: fold it into the DOCS PLAN per propose-structure's depth-reconcile (adjust that feature's article palette in plan.json/AGENT-PLAN.md, cite the answer's messages/ file in new rows' `sources`, never renumber existing rows, decrement AGENT-PLAN.md's open_depth_questions and flip status to `pinned` at zero) \u2014 address each feedback item (improve the doc it points at \u2014 as a draft), and action each OWNER DIRECTIVE (honor its scenario/detail, ground it in the sources, write/update the article(s) as drafts \u2014 following the active doc-type playbook).","5. If that means writing more than one article, call d360_estimate_cost and show me the count + cost band first (the bulk gate), then proceed.","6. Write/update the articles as drafts, grounded in the cited sources.","7. Close the loop:","   \u2022 stamp consumed hints, and mark handled messages status: done with resulting_articles;","   \u2022 for each OWNER DIRECTIVE you actioned: call d360_directive_done with its exact title + the article path(s) you wrote (flips it to [done] in .d360-writer/directives.md);","   \u2022 reconcile the DOCS ROADMAP (d360_roadmap): flip any campaign step this run completed (d360_roadmap_done), and append a step (d360_roadmap_add, with its run: command) for real new campaign work this run revealed \u2014 never delete existing steps;","   \u2022 for each portal feedback item you actioned: append a short note at the BOTTOM of that feedback article via d360_update_article \u2014 `**d360-writer response:** \u2713 actioned in <article> \u2014 <date>` (or `declined \u2014 <reason>`) \u2014 NEVER overwriting the person's own text \u2014 then call d360_feedback_done(article_id, resulting_articles);","   \u2022 EXCEPT the Creator-notes item (is_creator_notes:true): do NOT reply in it \u2014 instead fold its content into `.d360-writer/architecture/CREATOR-NOTES.md` as an appended, dated `## From portal Creator notes (<date>)` section (preserve every existing note + human edit), then call d360_feedback_done for it.","8. Push the drafts to Document360.","9. Cross-link second pass: any article you wrote that links to ANOTHER article in this same batch had that inline link degrade to plain text (its target had no live URL yet when the source was written). Now that every target exists, re-update the affected articles so those inline links resolve to live URLs \u2014 only the ones that had such forward references need it. (The structured Related Articles sidebars are already two-way linked; this is just inline body links.)"];return t.push(e?"10. Then publish the new/updated articles live (publish-to-d360 skill), respecting the production write-guard.":"Leave everything as DRAFTS for review \u2014 do not publish live (run /publish when you want them live)."),t.push("","End with a one-line-per-item summary of what you wrote/updated, and anything you couldn't ground (plus the d360_ask_builder question you left for it)."),t.join(`
 `)}var Oh={status:Ah,plan:Eh,apply:Nh,planImport:Ih,applyImport:_h};async function zs(e,t=Oh){let n={pulled:[],imported:[],conflicts:[],failed:[]},o;try{o=await t.status({cwd:e.cwd,profileName:e.profileName})}catch(r){return n.error=r.message,n}for(let r of o.entries)if(r.status==="conflict"&&r.path)n.conflicts.push(r.path);else if(r.status==="untracked-remote"&&r.articleId)try{let s=await t.planImport({cwd:e.cwd,profileName:e.profileName,articleId:r.articleId});t.applyImport({cwd:e.cwd,profileName:e.profileName},s),n.imported.push(s.path)}catch(s){n.failed.push({path:r.title??r.articleId,error:s.message})}else if(r.status==="remote-ahead"&&r.path)try{let s=await t.plan({cwd:e.cwd,profileName:e.profileName,relPath:r.path});t.apply({cwd:e.cwd,profileName:e.profileName},s),n.pulled.push(r.path)}catch(s){n.failed.push({path:r.path,error:s.message})}return n}var Vs=(e,t=5)=>`${e.slice(0,t).join(", ")}${e.length>t?`, +${e.length-t} more`:""}`,Fo=e=>e===1?"":"s";function Ks(e){if(e.error)return[`\u26A0 Couldn't check Document360 for portal changes (${e.error.slice(0,100)}) \u2014 proceeding; the agent will re-check.`];let t=[];return e.pulled.length&&t.push(`\u2713 Pulled ${e.pulled.length} portal edit${Fo(e.pulled.length)} into local: ${Vs(e.pulled)}`),e.imported.length&&t.push(`\u2713 Imported ${e.imported.length} new portal article${Fo(e.imported.length)} into local drafts: ${Vs(e.imported)}`),e.conflicts.length&&t.push(`\u26A0 ${e.conflicts.length} article${Fo(e.conflicts.length)} changed both locally and in the portal \u2014 left untouched (resolve: /pull <path>): ${Vs(e.conflicts)}`),e.failed.length&&t.push(`\u26A0 ${e.failed.length} pull/import${Fo(e.failed.length)} failed \u2014 left for /pull.`),t}async function nc(e,t){let n=t?.cwd??process.cwd();if(!jh(n))return console.log(R("No d360-writer config here. Run /init first.")),{kind:"continue"};let o=Ne(n,t?.profileName);if(!o.ok)return console.log(R(o.reason)),{kind:"continue"};let{publish:r}=Gs(e);console.log(f("Reconciling with Document360 (pulling any portal changes)\u2026"));let s=await zs({cwd:n,profileName:t?.profileName});for(let p of Ks(s))console.log(p.startsWith("\u2713")?D(p):p.startsWith("\u2139")?f(p):L(p));let l=Nn(En(n));return console.log(f(l?`Catching up on ${l}\u2026`:"Checking for code changes the builder didn't hint\u2026")),{kind:"forward-to-agent",prompt:Ys({publish:r}),display:`/catch-up${r?" --publish":""}`}}W();import{spawn as Lh}from"node:child_process";var xt="document360-writer",Ho=`npm i -g ${xt}@latest`;async function qo(){let e=process.platform==="win32";return new Promise(t=>{try{let n=Lh(`npm i -g ${xt}@latest`,{stdio:"ignore",shell:!0,detached:!e,windowsHide:!0});n.on("error",o=>t({ok:!1,output:String(o)})),n.on("close",o=>t({ok:o===0,output:""})),e||n.unref()}catch(n){t({ok:!1,output:String(n)})}})}async function oc(){return console.log(f(`Updating ${xt}\u2026`)),(await qo()).ok?console.log(D("\u2713 Updated. Exit (/exit) and relaunch d360-writer to apply.")):console.log(R(`Update failed \u2014 run manually:  ${Ho}`)),{kind:"continue"}}W();nt();import{existsSync as Xs,rmSync as Mh}from"node:fs";import{basename as rc,resolve as Qs}from"node:path";import{execFileSync as Uh}from"node:child_process";import{input as Wh}from"@inquirer/prompts";import{readProjectConfig as Fh,devHintsGuidePath as Hh}from"document360-engine";var qh=[".d360-writer.json",".d360-writer","d360-category-map.json",".d360-capture.json",".d360-capture-cache"],Bh=new Set([".d360-writer.json","d360-category-map.json",".d360-capture.json",".d360-capture-cache"]),Bo=e=>(e??"").replace(/\\/g,"/").replace(/\/+$/,""),sc=e=>e===".d360-writer"||e.startsWith(".d360-writer/");function ic(e){let t=Bo(e);return t===""||t.startsWith("..")||t.startsWith("/")||/^[a-zA-Z]:/.test(t)?!1:sc(t)?!0:Bh.has(t)}function Js(e){let t=null;try{t=Fh(e)}catch{t=null}let n=new Set(qh);for(let o of[Bo(t?.docsDir),Bo(t?.captureDir),Bo(t?.outputDir)])o&&sc(o)&&n.add(o);return[...n].filter(o=>ic(o)&&Xs(Qs(e,o)))}function Zs(e,t){let n=[],o=[];for(let r of t){if(!ic(r)){o.push({path:r,error:"refused \u2014 outside .d360-writer/ (protected)"});continue}try{Mh(Qs(e,r),{recursive:!0,force:!0}),n.push(r)}catch(s){o.push({path:r,error:s.message})}}return{removed:n,failed:o}}function ac(e,t){try{return Uh("git",["status","--porcelain","--",t],{cwd:e,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).split(`
-`).filter(o=>o.trim()&&/\.md\s*$/.test(o)).length}catch{return 0}}function Vh(e){return ac(e,".d360-writer/hints")}function Gh(e){return ac(e,".d360-writer/messages")}function ei(e,t){if(t.length===0)return["Nothing to reset \u2014 no d360-writer files found in this repo."];let n=Vh(e),o=Gh(e),r=Xs(Qs(e,"user-docs"));return["\u26A0 This permanently DELETES everything d360-writer created here:",...t.map(s=>`  \u2022 ${s}`),"",...n>0?[`\u26A0 ${n} doc hint(s) under .d360-writer/hints/ are not committed \u2014 commit them first or they're gone.`]:[],...o>0?[`\u26A0 ${o} message(s) under .d360-writer/messages/ are not committed \u2014 commit them first or they're gone.`]:[],...r?["Note: a repo-root user-docs/ is NOT touched (only .d360-writer/ is removed)."]:[],"Undo = git: committed files are restorable; untracked ones (most screenshots) are gone.",`To confirm, type the repo name:  ${rc(e)}`]}async function lc(e,t){let n=Js(t.cwd);for(let m of ei(t.cwd,n))console.log(n.length===0?f(m):m);if(n.length===0)return{kind:"continue"};let o=rc(t.cwd);if((await t.withPausedInput(()=>Wh({message:`Type "${o}" to delete (anything else cancels):`}).catch(()=>""))).trim()!==o)return console.log(L("Reset cancelled \u2014 nothing deleted.")),{kind:"continue"};let s=Xs(Hh(t.cwd)),{removed:l,failed:p}=Zs(t.cwd,n);console.log(D(`\u2713 Reset complete \u2014 removed ${l.length} item${l.length===1?"":"s"}. The repo is back to its original state.`));for(let m of p)console.log(R(`  \u2717 ${m.path}: ${m.error}`));if(s){for(let m of xo())console.log(m);console.log(f("(Select and copy the prompt above to paste into your coding agent.)"))}return console.log(f("Set up d360-writer again with /init (then /login, /workspace).")),{kind:"continue"}}W();import{lintDocs as Yh}from"document360-engine";function Vo(e){if(e.length===0)return["\u2713 No issues found \u2014 no leaked internals, unknown commands, stale version facts, or AI-tells in the docs."];let t=new Map;for(let o of e){let r=t.get(o.path)??[];r.push(o),t.set(o.path,r)}let n=[`\u26A0 ${e.length} doc issue${e.length===1?"":"s"} in ${t.size} article${t.size===1?"":"s"} (leaked internals / unknown commands / stale facts / AI-tells):`];for(let[o,r]of t){n.push(`  ${o}`);for(let s of r)n.push(`    L${s.line}: "${s.term}" \u2014 ${s.message}`)}return n}function ti(e){let t=new Map;for(let o of e){let r=t.get(o.path)??[];r.push(o),t.set(o.path,r)}return["The documentation quality check found issues in already-written articles. FIX each one by EDITING the","article in place \u2014 do not rewrite whole articles, just resolve the flagged problems. Ground every change","in the actual product source (the authoritativeSourceFiles); never invent.","","How to fix, by issue type:","- internal-leak (an agent codename, an internal skill name, or a d360_* tool name): this is the","  documentation engine's own machinery and must NOT appear in user docs. Reword the sentence to describe","  the behavior in plain user terms, or delete the internal aside. Do NOT swap it for another internal term.","- unknown-command: the named /command or --flag does not exist in the product source. Find the correct","  command/flag in the source and use it; if there is no real equivalent, remove the claim.","- stale-fact: the version contradicts the product's package.json engines \u2014 correct it to the real value.","- ai-tell: a machine-sounding buzzword (e.g. delve, leverage, furthermore, robust). Rewrite the phrase in","  plain, direct developer language; preserve the meaning; do NOT swap one buzzword for another.","","Rules: edit ONLY the listed articles; do not touch others; do not publish; introduce no new internal","nouns, invented commands, or wrong facts. When done, every listed issue should be gone.","","Issues:",[...t.entries()].map(([o,r])=>[o,...r.map(s=>`  - L${s.line} [${s.kind}]: "${s.term}" \u2014 ${s.message}`)].join(`
+`).filter(o=>o.trim()&&/\.md\s*$/.test(o)).length}catch{return 0}}function Vh(e){return ac(e,".d360-writer/hints")}function Gh(e){return ac(e,".d360-writer/messages")}function ei(e,t){if(t.length===0)return["Nothing to reset \u2014 no d360-writer files found in this repo."];let n=Vh(e),o=Gh(e),r=Xs(Qs(e,"user-docs"));return["\u26A0 This permanently DELETES everything d360-writer created here:",...t.map(s=>`  \u2022 ${s}`),"",...n>0?[`\u26A0 ${n} doc hint(s) under .d360-writer/hints/ are not committed \u2014 commit them first or they're gone.`]:[],...o>0?[`\u26A0 ${o} message(s) under .d360-writer/messages/ are not committed \u2014 commit them first or they're gone.`]:[],...r?["Note: a repo-root user-docs/ is NOT touched (only .d360-writer/ is removed)."]:[],"Undo = git: committed files are restorable; untracked ones (most screenshots) are gone.",`To confirm, type the repo name:  ${rc(e)}`]}async function lc(e,t){let n=Js(t.cwd);for(let m of ei(t.cwd,n))console.log(n.length===0?f(m):m);if(n.length===0)return{kind:"continue"};let o=rc(t.cwd);if((await t.withPausedInput(()=>Wh({message:`Type "${o}" to delete (anything else cancels):`}).catch(()=>""))).trim()!==o)return console.log(L("Reset cancelled \u2014 nothing deleted.")),{kind:"continue"};let s=Xs(Hh(t.cwd)),{removed:l,failed:p}=Zs(t.cwd,n);console.log(D(`\u2713 Reset complete \u2014 removed ${l.length} item${l.length===1?"":"s"}. The repo is back to its original state.`));for(let m of p)console.log(R(`  \u2717 ${m.path}: ${m.error}`));if(s){for(let m of xo())console.log(m);console.log(f("(Select and copy the prompt above to paste into your coding agent.)"))}return console.log(f("Set up d360-writer again with /init (then /login, /workspace).")),{kind:"continue"}}W();import{lintDocs as Yh}from"document360-engine";function Vo(e){if(e.length===0)return["\u2713 No issues found \u2014 no leaked internals, unknown commands, stale version facts, or AI-tells in the docs."];let t=new Map;for(let o of e){let r=t.get(o.path)??[];r.push(o),t.set(o.path,r)}let n=[`\u26A0 ${e.length} doc issue${e.length===1?"":"s"} in ${t.size} article${t.size===1?"":"s"} (leaked internals / unknown commands / stale facts / AI-tells):`];for(let[o,r]of t){n.push(`  ${o}`);for(let s of r)n.push(`    L${s.line}: "${s.term}" \u2014 ${s.message}`)}return n}function ti(e){let t=new Map;for(let o of e){let r=t.get(o.path)??[];r.push(o),t.set(o.path,r)}return["The documentation quality check found issues in already-written articles. FIX each one by EDITING the","article in place \u2014 do not rewrite whole articles, just resolve the flagged problems. Ground every change","in the actual product source (the authoritativeSourceFiles); never invent.","","How to fix, by issue type:","- internal-leak (an agent codename, an internal skill name, or a d360_* tool name): this is the","  documentation engine's own machinery and must NOT appear in user docs. Reword the sentence to describe","  the behavior in plain user terms, or delete the internal aside. Do NOT swap it for another internal term.","- unknown-command: the named /command or --flag does not exist in the product source. Find the correct","  command/flag in the source and use it; if there is no real equivalent, remove the claim.","- stale-fact: the version contradicts the product's package.json engines \u2014 correct it to the real value.","- ai-tell: a machine-sounding buzzword (e.g. delve, leverage, furthermore, robust). Rewrite the phrase in","  plain, direct developer language; preserve the meaning; do NOT swap one buzzword for another.","- stray-file: a junk *.publish.md file (a publish transform wrongly written to disk). DELETE the file \u2014",'  do not edit it, do not publish it; the real article is its sibling without ".publish". Nothing else changes.',"","Rules: edit ONLY the listed articles; do not touch others; do not publish; introduce no new internal","nouns, invented commands, or wrong facts. When done, every listed issue should be gone.","","Issues:",[...t.entries()].map(([o,r])=>[o,...r.map(s=>`  - L${s.line} [${s.kind}]: "${s.term}" \u2014 ${s.message}`)].join(`
 `)).join(`
 `)].join(`
 `)}async function cc(e,t){let n=e.includes("--fix"),o=e.find(l=>!l.startsWith("--")),r=o?` ${o}`:"",s=Yh({cwd:t.cwd,scope:o});if(n)return s.length===0?(console.log(D("\u2713 Nothing to fix \u2014 the docs are already clean.")),{kind:"continue"}):(console.log(f(`Fixing ${s.length} doc issue${s.length===1?"":"s"} (run /check again after to confirm)\u2026`)),{kind:"forward-to-agent",prompt:ti(s),display:`/check${r} --fix`});console.log(f("Linting the docs (engine internals, unknown commands, stale facts, AI-tells)\u2026"));for(let l of Vo(s))console.log(s.length===0?D(l):L(l));return s.length>0&&console.log(f("Run /check --fix to have the agent correct these.")),console.log(""),{kind:"continue"}}W();import{lintDocs as Zh,loadStyleGuide as em,buildReviewPrompt as tm,readProjectConfig as nm,DEFAULT_DOCS_DIR as om}from"document360-engine";W();import{readProjectConfig as zh,loadProfileMap as Kh,resolveActiveProfile as Xh,desiredCategoryOrder as Qh,desiredArticleOrder as Jh}from"document360-engine";function dc(e){let t=e.replace(/\.(md|markdown)$/i,"").replace(/^\d+[-_]/,"").replace(/[-_]+/g," ").trim();return t?t.charAt(0).toUpperCase()+t.slice(1):e}var uc=e=>e.replace(/\\/g,"/").split("/").pop()??e;function In(e,t){try{if(!zh(e))return[];let n=Xh(e,t),o=Kh(e,n.name);if(!o)return[];let r=new Map;for(let l of Jh(o)){let p=r.get(l.categoryPath);p?p.push(l):r.set(l.categoryPath,[l])}let s=[];for(let l of Qh(o)){s.push(dc(uc(l.path)));for(let p of(r.get(l.path)??[]).sort((m,k)=>m.order-k.order))s.push(`  ${dc(uc(p.path))}`)}return s}catch{return[]}}async function pc(e,t){let n=In(t.cwd,t.profileName);if(n.length===0)return console.log(f("No documentation structure yet \u2014 run /init and author some articles first.")),{kind:"continue"};console.log(O("Documentation order (categories \u2192 articles):"));for(let o of n)console.log(o);return console.log(""),{kind:"continue"}}function ni(e,t){let n=nm(e);if(!n)return null;let o=(n.docsDir??om).replace(/\\/g,"/").replace(/\/+$/,""),r=t.includes("--fix"),s=t.find(g=>!g.startsWith("--"))?.replace(/\\/g,"/").replace(/\/+$/,""),l=Zh({cwd:e}),p=s?l.filter(g=>g.path===`${o}/${s}`||g.path.startsWith(`${o}/${s}/`)):l,m=s?"":In(e).join(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document360-writer",
-  "version": "0.5.115",
+  "version": "0.5.117",
   "description": "Standalone documentation agent CLI. Reads your code, writes your docs. Specialized for Document360 publishing.",
   "type": "module",
   "bin": {
@@ -34,7 +34,7 @@
     "@inquirer/prompts": "^8.4.3",
     "commander": "^14.0.3",
     "diff": "^8.0.4",
-    "document360-engine": "^0.2.125",
+    "document360-engine": "^0.2.127",
     "ink": "^5.2.1",
     "picocolors": "^1.1.1",
     "react": "^18.3.1",