document360-writer 0.4.96 → 0.4.98
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.js +26 -8
- package/dist/commands/devhints.d.ts +1 -1
- package/dist/commands/publish.d.ts +3 -3
- package/dist/lib/pickOptions.d.ts +15 -10
- package/package.json +2 -2
package/dist/cli.js
CHANGED
|
@@ -141,6 +141,24 @@ output shape; the writer judges it like a technical writer would. Two ways:
|
|
|
141
141
|
\`--yes\` if the target profile is production.
|
|
142
142
|
- **Queued (async)** \u2014 drop a \`request\` message (Part 3); the writer documents it on its next session or
|
|
143
143
|
via CI. Use this when a human should review before publishing.
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## Part 5 \u2014 Commit the docs agent's output (it can't commit itself)
|
|
148
|
+
|
|
149
|
+
The docs agent **cannot run git** \u2014 version control is yours. Everything it produces lives under
|
|
150
|
+
\`.d360-writer/\` and is **left uncommitted** until you commit it:
|
|
151
|
+
- \`.d360-writer/user-docs/\` (or the configured docs dir) \u2014 the article markdown it wrote.
|
|
152
|
+
- **\`.d360-writer/category-map.json\`** \u2014 the link between each local file and its Document360 article id
|
|
153
|
+
**plus the sync baseline**. This is load-bearing: if it's lost, the docs agent can't tell which local
|
|
154
|
+
file maps to which portal article, so a later publish can **create duplicates**. Treat it like a lockfile.
|
|
155
|
+
- \`.d360-writer/hints/\` + \`messages/\` status flips, \`devhints-state.json\`, and the \`architecture/\` brief.
|
|
156
|
+
|
|
157
|
+
**So: after the docs agent writes, links, or publishes, commit \`.d360-writer/\`.** A simple rule \u2014
|
|
158
|
+
whenever \`git status\` shows changes under \`.d360-writer/\`, commit them (e.g.
|
|
159
|
+
\`git add .d360-writer && git commit -m "docs: sync d360-writer output"\`) before you push. The docs agent
|
|
160
|
+
will remind you when it leaves changes, but it's your call to commit them. Without this, the team's docs
|
|
161
|
+
and \u2014 critically \u2014 the sync map are stranded on one machine.
|
|
144
162
|
`}function ec(){return`# Creator notes (optional \u2014 for the docs agent and the builder)
|
|
145
163
|
|
|
146
164
|
<!-- The ORIGINAL CREATOR's context. Most repos leave this empty \u2014 that's fine.
|
|
@@ -160,7 +178,7 @@ Anything only a human knows that would help document this product. For example:
|
|
|
160
178
|
`)}function So(e){try{let t=Kl(Is(e),"utf8"),n=JSON.parse(t);return n&&typeof n=="object"?n:null}catch{return null}}function Os(e,t){let o={...So(e)??{},emittedVersion:ne,emittedAt:t};Ot(Is(e),`${JSON.stringify(o,null,2)}
|
|
161
179
|
`)}function Us(e){try{return Xl(Es(e)).some(t=>/\.md$/i.test(t)&&t.toLowerCase()!=="creator-notes.md")}catch{return!1}}function _e(e){let n=So(e)?.completedVersion;return typeof n!="number"?{status:"unset"}:{status:n<ne?"stale":"current",completedVersion:n}}function vn(e,t=new Date().toISOString()){let n={guideRefreshed:!1,notifiedBuilder:!1,toVersion:ne};try{if(!xn($n(e)))return n;let o=So(e),r=o?.emittedVersion??0;n.completedVersion=o?.completedVersion;let s=o?.completedVersion??0;ne>r&&(bn(To(e)),Ot($n(e),Ns()),Os(e,t),n.guideRefreshed=!0),ne>s&&(Zl(e).some(p=>p.kind==="request"&&p.subject.startsWith(As))||(Ql(e,{id:`onb${ne}`,created:t,from:"docs",kind:"request",re:"",sources:[],subject:`${As}${ne})`,status:"open",body:[`The dev\u2194docs onboarding protocol moved to v${ne}${s?` (you last completed v${s})`:""}.`,"Re-run the hand-off so the docs agent and this repo stay in step \u2014 run this prompt here:","",ze()].join(`
|
|
162
180
|
`)}),n.notifiedBuilder=!0))}catch{}return n}function Cn(e){if(!xn($n(e)))return[];let t=_e(e);return t.status==="current"?[]:[`\u{1F514} Your builder agent ${t.completedVersion?`is on v${t.completedVersion}`:"hasn't completed the hand-off yet"} \u2014 d360-writer's dev\u2194docs protocol is now v${ne}.`,"Please run this prompt in your repository's coding agent (Claude Code / Codex / Cursor) for:",` ${e}`,wt,ze(),wt,"(Also saved in .d360-writer/messages/ \u2014 or run /devhints to re-show. This stops once your builder runs it.)"]}function Ro(){return['document360-writer (its "docs agent") has been removed from this repository. Please undo its dev\u2192docs',"hand-off setup and restore this repo to how it was before \u2014 in order:","","1. In this repo's agent-memory file (CLAUDE.md, or AGENTS.md \u2014 whichever it edited), REMOVE the",' "Documentation hand-off" section that was added (the rule about dropping hint files in'," `.d360-writer/hints/`, keeping `.d360-writer/architecture/` current, and checking"," `.d360-writer/messages/`). Leave everything else in that file untouched.","2. The `.d360-writer/` folder is already deleted on disk. If it was committed, remove it from version"," control too \u2014 `git rm -r --cached .d360-writer` (if it still resolves) \u2014 and commit the deletions.","3. Do NOT recreate any of those files or follow the hand-off protocol anymore.","","That's it \u2014 this repo is back to its pre-docs-agent state."].join(`
|
|
163
|
-
`)}function Pn(){return['\u{1F9F9} One leftover: your builder still has the "Documentation hand-off" rule in its CLAUDE.md / AGENTS.md'," (reset only clears d360-writer's own .d360-writer/ folder \u2014 never your repo's files)."," To restore it, paste this prompt into your repo's coding agent (Claude Code / Codex / Cursor):",wt,Ro(),wt]}function kt(e){return[...e?.status==="stale"?[`\u26A0 Your builder last completed devhints v${e.completedVersion}; this hand-off is v${ne}.`," Have them run the prompt below again \u2014 it now sets up two-way messages + on-demand docs.",""]:[],"\u2713 Wrote .d360-writer/DEV-HINTS-GUIDE.md + the .d360-writer/architecture/ (brief), .d360-writer/hints/, and .d360-writer/messages/ inboxes.","","\u{1F4CB} Copy this one prompt and run it in your repo's coding agent (Claude Code / Codex / Cursor):",wt,ze(),wt,"","That one run writes the architecture brief, adds the ongoing rule to your agent memory (CLAUDE.md / AGENTS.md)","and commits it so teammates inherit it, answers any open questions the writer left, and asks you for tribal","knowledge \u2014 no manual file edits. It also sets up the two-way channel: the writer can ask you questions","(`/inbox` on its side), and you can ask it to document a session on demand (Part 4 of the guide). When it","finishes, come back here and run: write the docs for this repo"]}var wt,ne,As,Ke=bo(()=>{"use strict";wt="-".repeat(64),ne=4;As="Re-run dev\u2194docs onboarding (protocol v"});var Fi={};il(Fi,{doctorCommand:()=>qt,renderDoctorChecks:()=>Wi,runDoctorChecks:()=>Mi});import{existsSync as Oi}from"node:fs";import{d360GetAll as $u,getAccessToken as vu,isExpired as fr,loadProfileMap as Cu,loadTokens as Pu,packageSkillsDir as Ui,projectConfigPath as Tu,readProjectConfig as Su,DEFAULT_DOCS_DIR as Ru,resolveActiveProfile as Du,classifyClaudeAuth as ju,CLAUDE_CODE_SETUP_HINT as Li,resolveModelSetting as Au,devHintsGuidePath as Eu}from"document360-engine";async function Mi(e){let t=[],n=Number(process.versions.node.split(".")[0]);t.push(n>=20?{level:"ok",label:`Node ${process.versions.node}`}:{level:"fail",label:`Node ${process.versions.node} \u2014 20+ required`,fix:"Install Node 20 or later (nodejs.org)"});let o=ju();o.state==="ready"?t.push({level:"ok",label:`Claude auth: ${o.kind==="api"?"API key":"subscription (Claude Code login found)"}`}):o.state==="maybe"?t.push({level:"warn",label:"Claude: no Claude Code login found (may be in the macOS Keychain)",fix:`If a docs turn ends with no output, sign in to Claude Code. ${Li}`}):t.push({level:"fail",label:"Claude: not signed in \u2014 the agent cannot run (no Claude Code credentials on this machine)",fix:Li});let r=Au(e);t.push({level:"ok",label:`Model: ${r.model??"Claude Code default"} (${r.source})`});let s=Su(e);if(!s)return t.push({level:"fail",label:`No ${Tu(e)}`,fix:"Run: /init (or d360-writer init)"}),t;t.push({level:"ok",label:`Project config: ${s.projectId}`});let c=(s.docsDir??Ru).replace(/\/+$/,"");t.push(s.mode==="engineer"?{level:"warn",label:"Mode: engineer \u2014 agent may modify any source file (dogfooding)",fix:'Remove "mode" from .d360-writer/config.json for the writer-mode boundary'}:{level:"ok",label:`Mode: writer \u2014 edits limited to ${c}/ and .d360-writer/ (docs, capture specs, config); product source is read-only`});let p=s.authoritativeSourceFiles??[];t.push(p.length>0?{level:"ok",label:`Sources: docs grounded in ${p.length} path(s) (${p.slice(0,3).join(", ")}${p.length>3?", \u2026":""})`}:{level:"warn",label:"Sources: not set \u2014 docs are grounded in the whole repo",fix:"Run: /scope to choose which files/folders the docs are written from"});let h;try{h=Du(e),t.push({level:"ok",label:`Profile: ${h.name} (${h.connection.name})${h.production?" \u26A0 PRODUCTION":""}`})}catch(k){return t.push({level:"fail",label:`Profile config: ${k.message.split(".")[0]}`,fix:"Run: /init to scaffold the profiles map"}),t}let b=Pu(h.name);b?fr(b)&&!b.refreshToken?t.push({level:"fail",label:"Document360: session expired (no refresh token)",fix:"/login"}):fr(b)?t.push({level:"warn",label:"Document360: token expired \u2014 will auto-refresh on next call"}):t.push({level:"ok",label:`Document360: logged in (until ${new Date(b.expiresAt).toLocaleString()})`}):t.push({level:"fail",label:"Document360: not logged in",fix:`Run: /login (or d360-writer login --profile ${h.name})`}),t.push(h.project.workspaceId?{level:"ok",label:`Workspace: ${h.project.workspaceName??h.project.workspaceId}`}:{level:"warn",label:"No workspace selected",fix:"Run: /workspace"});let w=Cu(e,h.name);w?w.projectId&&h.project.projectId&&w.projectId!==h.project.projectId?t.push({level:"fail",label:`Category map projectId (${w.projectId}) \u2260 profile projectId (${h.project.projectId})`,fix:"The map section belongs to a different project \u2014 fix .d360-writer/config.json or the map before publishing"}):t.push({level:"ok",label:`Category map: ${Object.keys(w.articles).length} articles, ${Object.keys(w.categories).length} categories`}):t.push({level:"ok",label:`Category map: none yet for "${h.name}" (created on first /publish)`}),t.push(Oi(Ui())?{level:"ok",label:"Skills bundle present"}:{level:"fail",label:`Skills folder missing at ${Ui()}`,fix:"Reinstall document360-writer (broken install)"});let R=_e(e);if((Oi(Eu(e))||R.status!=="unset")&&(R.status==="current"?t.push({level:"ok",label:`Dev hand-off: builder up to date (devhints v${ne})`}):R.status==="stale"?t.push({level:"warn",label:`Dev hand-off: builder on devhints v${R.completedVersion}, current is v${ne}`,fix:"Run /devhints and have the repo's coding agent re-run the prompt (adds two-way messages + on-demand docs)"}):t.push({level:"warn",label:"Dev hand-off: guide emitted but the builder hasn't completed it",fix:"Have the repo's coding agent run the /devhints prompt (sets up the two-way channel)"})),b&&(!fr(b)||b.refreshToken)){let k={profile:h.name,connection:h.connection};try{await vu(k);let C=await $u(k,"/v3/projects");t.push({level:"ok",label:`API reachable (${h.connection.apiUrl}) \u2014 ${C.length} project(s) visible`})}catch(C){t.push({level:"fail",label:`API call failed: ${C.message.slice(0,120)}`,fix:"/login if auth-related; otherwise check the apiUrl/network"})}}return t}function Wi(e){let t=[""];for(let r of e){let s=r.level==="ok"?E("\u2713"):r.level==="warn"?U("\u26A0"):$("\u2717");t.push(` ${s} ${r.label}${r.detail?f(` \u2014 ${r.detail}`):""}`),r.fix&&t.push(` ${f("fix:")} ${I(r.fix)}`)}let n=e.filter(r=>r.level==="fail").length,o=e.filter(r=>r.level==="warn").length;return t.push(""),t.push(n===0?E(`\u2713 ${o===0?"All checks passed":`Healthy (${o} warning${o===1?"":"s"})`}`):$(`\u2717 ${n} problem${n===1?"":"s"} found`)),t.push(""),t}async function qt(e,t){console.log(f("Running checks\u2026"));for(let n of Wi(await Mi(t.cwd)))console.log(n);return{kind:"continue"}}var On=bo(()=>{"use strict";Ke();W()});import{Command as Vp}from"commander";import{createRequire as Yp}from"node:module";import{AUTH_MODES as zp}from"document360-engine";import{input as vl}from"@inquirer/prompts";import{loginPkce as Cl,refreshTokens as Pl,toStoredTokens as ys,clearTokens as Tl,decodeJwtClaims as ws,isExpired as Sl,loadTokens as Rl,saveTokens as ks,resolveActiveProfile as fn,setProfileProject as Dl,readProjectConfig as jl}from"document360-engine";W();import{select as ul}from"@inquirer/prompts";import{resolveActiveProfile as dl,setProfileProject as pl,resolveProjectId as fl,listWorkspaces as ml}from"document360-engine";async function It(e,t){let n=dl(e,t),o={profile:n.name,connection:n.connection},r=n.project.projectId??fl(o);return{workspaces:await ml(o,r),projectId:r,projectName:n.project.projectName,profile:n.name,environment:n.connection.name,current:n.project.workspaceId}}var ps=e=>`${e.name??e.id}${e.workspace_type?` \xB7 ${e.workspace_type}`:""}`;function xo(e,t){let n=t.toLowerCase();return e.find(o=>(o.name??"").toLowerCase()===n)??e.find(o=>(o.name??"").toLowerCase().startsWith(n))??e.find(o=>o.id.startsWith(t))}function pn(e,t,n,o,r){pl(e,t,{projectId:n,workspaceId:o,workspaceName:r})}async function fs(e,t,n){let o;try{o=await It(e,n)}catch(s){return console.log($(`Could not list workspaces: ${s.message}`)),1}let r=xo(o.workspaces,t);return r?(pn(e,o.profile,o.projectId,r.id,r.name),console.log(E(`\u2713 Workspace set to "${r.name??r.id}" for profile "${o.profile}".`)),0):(console.log($(`No workspace matches "${t}". Available: ${o.workspaces.map(s=>s.name??s.id).join(", ")}`)),1)}async function ht(e,t){let n;try{n=await It(e,t)}catch(b){console.log($(`Could not list workspaces: ${b.message}`));return}let{workspaces:o,projectId:r,profile:s,current:c}=n;if(o.length===0){console.log(f("No workspaces found in this project."));return}if(!process.stdin.isTTY){console.log("");for(let b of o)console.log(` ${b.id===c?I("\u25CF"):" "} ${ps(b)} ${f(b.id)}`);console.log(f("Run: d360-writer workspace use <name>"));return}let p=await ul({message:"Select the Document360 workspace for this repo:",choices:o.map(b=>({name:`${ps(b)}${b.id===c?" (current)":""}`,value:b.id}))}),h=o.find(b=>b.id===p);pn(e,s,r,p,h?.name),console.log(E(`\u2713 Workspace set to "${h?.name??p}" for profile "${s}".`))}W();import{select as hl}from"@inquirer/prompts";import{resolveActiveProfile as gl,setProfileProject as wl,listProjects as yl}from"document360-engine";async function gt(e,t){let n=gl(e,t),o={profile:n.name,connection:n.connection};return{projects:await yl(o),profile:n.name,environment:n.connection.name,current:n.project.projectId}}var ms=e=>`${e.name??e.id}${e.sub_domain?` \xB7 ${e.sub_domain}`:""}`;function hs(e,t){let n=t.toLowerCase();return e.find(o=>(o.name??"").toLowerCase()===n)??e.find(o=>(o.name??"").toLowerCase().startsWith(n))??e.find(o=>o.id.startsWith(t))}function $o(e,t,n,o){wl(e,t,{projectId:n,projectName:o,workspaceId:void 0,workspaceName:void 0})}async function gs(e,t){let n;try{n=await gt(e,t)}catch(h){console.log($(`Could not list projects: ${h.message}`));return}let{projects:o,profile:r,current:s}=n;if(o.length===0){console.log(f("No projects found for this identity."));return}if(!process.stdin.isTTY){console.log("");for(let h of o)console.log(` ${h.id===s?I("\u25CF"):" "} ${ms(h)} ${f(h.id)}`);console.log(f("Run: d360-writer project use <name>"));return}let c=await hl({message:"Select the Document360 project for this repo:",choices:o.map(h=>({name:`${ms(h)}${h.id===s?" (current)":""}`,value:h.id}))}),p=o.find(h=>h.id===c);$o(e,r,c,p?.name),console.log(E(`\u2713 Project set to "${p?.name??c}" for profile "${r}". Next: pick a workspace.`))}W();import kl from"picocolors";function bl(e=process.env){return e.FORCE_HYPERLINK==="0"||!kl.isColorSupported?!1:e.FORCE_HYPERLINK?!0:!!(e.WT_SESSION||e.TERM_PROGRAM==="vscode"||e.TERM_PROGRAM==="iTerm.app"||e.TERM_PROGRAM==="WezTerm"||e.TERM_PROGRAM==="ghostty"||e.VTE_VERSION||e.KONSOLE_VERSION)}function xl(e,t=e,n){return bl(n)?`\x1B]8;;${e}\x07${t}\x1B]8;;\x07`:t}var $l=/https?:\/\/[^\s\x1b]+/g;function Nt(e,t){return e.replace($l,n=>xl(n,n,t))}function bs(e){return{...ws(e.idToken)??{},...ws(e.accessToken)??{}}}function mn(e){let t=bs(e),n=t.email??t.preferred_username??t.sub??"unknown",o=t.doc360_project_id?` \xB7 project ${t.doc360_project_id}`:"";return`${n}${o}`}async function hn(e){let t=fn(process.cwd(),e.profile),n=t.connection;console.log(f(`Profile "${t.name}" \u2192 ${n.name} (${n.apiUrl})${t.production?" \u26A0 PRODUCTION":""}`));let o=await Cl(n,{manual:e.manual,promptForRedirect:s=>vl({message:s})},s=>console.log(Nt(s))),r=ys(t.name,o);if(ks(r),await vo(r,t.name,s=>console.log(f(s))),console.log(""),console.log(E(`\u2713 Logged in to "${t.name}" as ${mn(r)}`)),console.log(f(` access token expires: ${r.expiresAt}`)),console.log(f(` refresh token: ${r.refreshToken?"yes":"NO \u2014 session ends at expiry"}`)),process.stdin.isTTY)try{jl(process.cwd())?.profiles?.[t.name]&&(console.log(""),await ht(process.cwd(),t.name))}catch{}}async function vo(e,t,n){let r=bs(e).doc360_project_id;if(!(typeof r!="string"||!r))try{if(fn(process.cwd(),t).project.projectId)return;let c;try{let{projects:p}=await gt(process.cwd(),t);c=p.find(h=>h.id===r)?.name}catch{}Dl(process.cwd(),t,{projectId:r,projectName:c}),n(` Project "${c??r}" written to profile "${t}".`)}catch{}}async function xs(e){let t=fn(process.cwd(),e.profile),n=t.connection,o=Rl(t.name);if(!o){console.log($(`Not logged in to Document360 (profile "${t.name}").`)),console.log(f(`Run: d360-writer login --profile ${t.name}`)),process.exitCode=1;return}if(console.log(`Profile ${I(t.name)}${t.production?" \u26A0 PRODUCTION":""}: ${mn(o)}`),Sl(o))if(o.refreshToken)try{let r=ys(t.name,await Pl(n,o.refreshToken));ks(r),console.log(E(`\u2713 Session refreshed \u2014 expires ${r.expiresAt}`))}catch(r){console.log(U(`Session expired and refresh failed (${r.message.slice(0,120)})`)),console.log(f(`Run: d360-writer login --profile ${t.name}`)),process.exitCode=1}else console.log(U("Session expired (no refresh token).")),console.log(f(`Run: d360-writer login --profile ${t.name}`)),process.exitCode=1;else console.log(f(` expires: ${o.expiresAt}`))}async function $s(e){let t=fn(process.cwd(),e.profile);Tl(t.name)?console.log(E(`\u2713 Logged out of Document360 (profile "${t.name}").`)):console.log(f(`No Document360 session for profile "${t.name}" \u2014 nothing to do.`))}W();import{readProjectConfig as vs,writeProjectConfig as Al,resolveActiveProfile as El,loadTokens as Il,isExpired as Nl}from"document360-engine";function gn(e){let t=vs(e);if(!t?.profiles||Object.keys(t.profiles).length===0){console.log($("No profiles in .d360-writer.json. Run: d360-writer init")),process.exitCode=1;return}console.log("");for(let[n,o]of Object.entries(t.profiles)){let r=n===t.defaultProfile?I("\u25CF "):" ",s=o.production?U(" \u26A0 PRODUCTION"):"",c=o.connection.environment??"(inline)",p=Il(n),h=p?Nl(p)&&!p.refreshToken?U("expired"):f("logged in"):f("not logged in");console.log(`${r}${I(n)} \u2192 ${c}${s} [${h}]`)}console.log(""),console.log(f("\u25CF = default. Switch with: d360-writer profile use <name>")),console.log("")}function wn(e,t){let n=vs(e);if(!n?.profiles?.[t]){let r=n?.profiles?Object.keys(n.profiles).join(", "):"(none \u2014 run init)";console.log($(`Unknown profile "${t}". Available: ${r}`)),process.exitCode=1;return}n.defaultProfile=t,Al(n,e);let o=n.profiles[t].production?U(" \u26A0 PRODUCTION"):"";console.log(E(`\u2713 Default profile is now "${t}"${o}`))}function yn(e,t){try{let n=El(e,t);console.log(""),console.log(`Profile ${I(n.name)}${n.production?U(" \u26A0 PRODUCTION"):""}`),console.log(f(` api: ${n.connection.apiUrl}`)),console.log(f(` identity: ${n.connection.authorizationUrl}`)),console.log(f(` clientId: ${n.connection.clientId}`)),console.log(f(` scopes: ${n.connection.scopes.join(" ")}`)),console.log(f(` project: ${n.project.projectId??"(set at login)"}`)),console.log(f(` workspace:${n.project.workspaceId?" "+n.project.workspaceId:" (none)"}`)),console.log("")}catch(n){console.log($(n.message)),process.exitCode=1}}W();import{existsSync as _l,readdirSync as Ol,statSync as Ul}from"node:fs";import{join as Ll}from"node:path";import{apiLogDir as Ml}from"document360-engine";function Cs(){let e=Ml();if(console.log(""),console.log(`Document360 API logs: ${I(e)}`),!_l(e)){console.log(f(" No logs yet \u2014 they appear after the first Document360 API call.")),console.log("");return}let t=Ol(e).filter(n=>n.endsWith(".jsonl")).sort().reverse();t.length===0&&console.log(f(" No logs yet \u2014 they appear after the first Document360 API call."));for(let n of t.slice(0,14)){let o=(Ul(Ll(e,n)).size/1024).toFixed(1);console.log(` ${n} ${f(`${o} KB`)}`)}console.log(""),console.log(f("Failed calls include request/response bodies (tokens redacted, 4 KB cap).")),console.log(f("Set D360_LOG_BODIES=1 to also log bodies for successful calls.")),console.log("")}W();import{createSession as Wl,resolveAuth as Fl,findByName as Hl,slugify as ql,touchSession as Bl,upsertSession as Gl,resolveActiveProfile as Vl}from"document360-engine";async function Ps(e,t,n,o,r,s){let c=Fl(n);c.kind==="none"&&(console.error(""),console.error($("ANTHROPIC_API_KEY is not set (required for --auth api).")),console.error(`Get a key at ${I("https://console.anthropic.com/settings/keys")}`),console.error(`Or use your Claude subscription instead: ${I("d360-writer --auth subscription")}`),process.exit(2)),c.kind==="subscription"&&console.error(f("Using your Claude subscription (no API key set)."));let p=null;try{p=Vl(e,r)}catch(k){console.error($(`Document360 profile error: ${k.message}`)),process.exit(2)}p.production&&(console.error(U(`\u26A0 Profile "${p.name}" is PRODUCTION.`)),s||(console.error($("Refusing to run against a production profile without --yes.")),process.exit(2)),console.error(f(" --yes given \u2014 proceeding against production.")));let h;if(o){let k=Hl(e,o);k||(console.error($(`No saved session matches "${o}" in this repo.`)),console.error(f("List sessions inside the REPL with /resume.")),process.exit(2)),h=k.uuid,console.error(f(`Resuming "${k.name}"`))}let b=Wl({cwd:e,resume:h,profileName:r,allowProdWrites:s===!0}),w=h??null,R=1;for await(let k of b.send(t))switch(k.type){case"session":if(!w){w=k.sessionId;let C=new Date().toISOString();Gl({uuid:w,name:ql(t),renamed:!1,titled:!1,cwd:e,firstPrompt:t,createdAt:C,updatedAt:C})}break;case"text":process.stdout.write(k.delta);break;case"tool":console.error(ee(` \u2699 ${k.name}`));break;case"result":R=k.ok?0:1,console.error(f(`(${k.inputTokens}\u2192${k.outputTokens} tokens`+(k.costUsd>0?`, $${k.costUsd<.01?k.costUsd.toFixed(4):k.costUsd.toFixed(2)}`:"")+")")),k.ok||console.error($("agent finished with an error result"));break;case"error":console.error(""),console.error($(`agent error: ${k.message}`)),process.exit(1)}w&&Bl(w),process.stdout.write(`
|
|
181
|
+
`)}function Pn(){return['\u{1F9F9} One leftover: your builder still has the "Documentation hand-off" rule in its CLAUDE.md / AGENTS.md'," (reset only clears d360-writer's own .d360-writer/ folder \u2014 never your repo's files)."," To restore it, paste this prompt into your repo's coding agent (Claude Code / Codex / Cursor):",wt,Ro(),wt]}function kt(e){return[...e?.status==="stale"?[`\u26A0 Your builder last completed devhints v${e.completedVersion}; this hand-off is v${ne}.`," Have them run the prompt below again \u2014 it now sets up two-way messages + on-demand docs.",""]:[],"\u2713 Wrote .d360-writer/DEV-HINTS-GUIDE.md + the .d360-writer/architecture/ (brief), .d360-writer/hints/, and .d360-writer/messages/ inboxes.","","\u{1F4CB} Copy this one prompt and run it in your repo's coding agent (Claude Code / Codex / Cursor):",wt,ze(),wt,"","That one run writes the architecture brief, adds the ongoing rule to your agent memory (CLAUDE.md / AGENTS.md)","and commits it so teammates inherit it, answers any open questions the writer left, and asks you for tribal","knowledge \u2014 no manual file edits. It also sets up the two-way channel: the writer can ask you questions","(`/inbox` on its side), and you can ask it to document a session on demand (Part 4 of the guide). When it","finishes, come back here and run: write the docs for this repo"]}var wt,ne,As,Ke=bo(()=>{"use strict";wt="-".repeat(64),ne=5;As="Re-run dev\u2194docs onboarding (protocol v"});var Fi={};il(Fi,{doctorCommand:()=>qt,renderDoctorChecks:()=>Wi,runDoctorChecks:()=>Mi});import{existsSync as Oi}from"node:fs";import{d360GetAll as $u,getAccessToken as vu,isExpired as fr,loadProfileMap as Cu,loadTokens as Pu,packageSkillsDir as Ui,projectConfigPath as Tu,readProjectConfig as Su,DEFAULT_DOCS_DIR as Ru,resolveActiveProfile as Du,classifyClaudeAuth as ju,CLAUDE_CODE_SETUP_HINT as Li,resolveModelSetting as Au,devHintsGuidePath as Eu}from"document360-engine";async function Mi(e){let t=[],n=Number(process.versions.node.split(".")[0]);t.push(n>=20?{level:"ok",label:`Node ${process.versions.node}`}:{level:"fail",label:`Node ${process.versions.node} \u2014 20+ required`,fix:"Install Node 20 or later (nodejs.org)"});let o=ju();o.state==="ready"?t.push({level:"ok",label:`Claude auth: ${o.kind==="api"?"API key":"subscription (Claude Code login found)"}`}):o.state==="maybe"?t.push({level:"warn",label:"Claude: no Claude Code login found (may be in the macOS Keychain)",fix:`If a docs turn ends with no output, sign in to Claude Code. ${Li}`}):t.push({level:"fail",label:"Claude: not signed in \u2014 the agent cannot run (no Claude Code credentials on this machine)",fix:Li});let r=Au(e);t.push({level:"ok",label:`Model: ${r.model??"Claude Code default"} (${r.source})`});let s=Su(e);if(!s)return t.push({level:"fail",label:`No ${Tu(e)}`,fix:"Run: /init (or d360-writer init)"}),t;t.push({level:"ok",label:`Project config: ${s.projectId}`});let c=(s.docsDir??Ru).replace(/\/+$/,"");t.push(s.mode==="engineer"?{level:"warn",label:"Mode: engineer \u2014 agent may modify any source file (dogfooding)",fix:'Remove "mode" from .d360-writer/config.json for the writer-mode boundary'}:{level:"ok",label:`Mode: writer \u2014 edits limited to ${c}/ and .d360-writer/ (docs, capture specs, config); product source is read-only`});let p=s.authoritativeSourceFiles??[];t.push(p.length>0?{level:"ok",label:`Sources: docs grounded in ${p.length} path(s) (${p.slice(0,3).join(", ")}${p.length>3?", \u2026":""})`}:{level:"warn",label:"Sources: not set \u2014 docs are grounded in the whole repo",fix:"Run: /scope to choose which files/folders the docs are written from"});let h;try{h=Du(e),t.push({level:"ok",label:`Profile: ${h.name} (${h.connection.name})${h.production?" \u26A0 PRODUCTION":""}`})}catch(k){return t.push({level:"fail",label:`Profile config: ${k.message.split(".")[0]}`,fix:"Run: /init to scaffold the profiles map"}),t}let b=Pu(h.name);b?fr(b)&&!b.refreshToken?t.push({level:"fail",label:"Document360: session expired (no refresh token)",fix:"/login"}):fr(b)?t.push({level:"warn",label:"Document360: token expired \u2014 will auto-refresh on next call"}):t.push({level:"ok",label:`Document360: logged in (until ${new Date(b.expiresAt).toLocaleString()})`}):t.push({level:"fail",label:"Document360: not logged in",fix:`Run: /login (or d360-writer login --profile ${h.name})`}),t.push(h.project.workspaceId?{level:"ok",label:`Workspace: ${h.project.workspaceName??h.project.workspaceId}`}:{level:"warn",label:"No workspace selected",fix:"Run: /workspace"});let w=Cu(e,h.name);w?w.projectId&&h.project.projectId&&w.projectId!==h.project.projectId?t.push({level:"fail",label:`Category map projectId (${w.projectId}) \u2260 profile projectId (${h.project.projectId})`,fix:"The map section belongs to a different project \u2014 fix .d360-writer/config.json or the map before publishing"}):t.push({level:"ok",label:`Category map: ${Object.keys(w.articles).length} articles, ${Object.keys(w.categories).length} categories`}):t.push({level:"ok",label:`Category map: none yet for "${h.name}" (created on first /publish)`}),t.push(Oi(Ui())?{level:"ok",label:"Skills bundle present"}:{level:"fail",label:`Skills folder missing at ${Ui()}`,fix:"Reinstall document360-writer (broken install)"});let R=_e(e);if((Oi(Eu(e))||R.status!=="unset")&&(R.status==="current"?t.push({level:"ok",label:`Dev hand-off: builder up to date (devhints v${ne})`}):R.status==="stale"?t.push({level:"warn",label:`Dev hand-off: builder on devhints v${R.completedVersion}, current is v${ne}`,fix:"Run /devhints and have the repo's coding agent re-run the prompt (adds two-way messages + on-demand docs)"}):t.push({level:"warn",label:"Dev hand-off: guide emitted but the builder hasn't completed it",fix:"Have the repo's coding agent run the /devhints prompt (sets up the two-way channel)"})),b&&(!fr(b)||b.refreshToken)){let k={profile:h.name,connection:h.connection};try{await vu(k);let C=await $u(k,"/v3/projects");t.push({level:"ok",label:`API reachable (${h.connection.apiUrl}) \u2014 ${C.length} project(s) visible`})}catch(C){t.push({level:"fail",label:`API call failed: ${C.message.slice(0,120)}`,fix:"/login if auth-related; otherwise check the apiUrl/network"})}}return t}function Wi(e){let t=[""];for(let r of e){let s=r.level==="ok"?E("\u2713"):r.level==="warn"?U("\u26A0"):$("\u2717");t.push(` ${s} ${r.label}${r.detail?f(` \u2014 ${r.detail}`):""}`),r.fix&&t.push(` ${f("fix:")} ${I(r.fix)}`)}let n=e.filter(r=>r.level==="fail").length,o=e.filter(r=>r.level==="warn").length;return t.push(""),t.push(n===0?E(`\u2713 ${o===0?"All checks passed":`Healthy (${o} warning${o===1?"":"s"})`}`):$(`\u2717 ${n} problem${n===1?"":"s"} found`)),t.push(""),t}async function qt(e,t){console.log(f("Running checks\u2026"));for(let n of Wi(await Mi(t.cwd)))console.log(n);return{kind:"continue"}}var On=bo(()=>{"use strict";Ke();W()});import{Command as Vp}from"commander";import{createRequire as Yp}from"node:module";import{AUTH_MODES as zp}from"document360-engine";import{input as vl}from"@inquirer/prompts";import{loginPkce as Cl,refreshTokens as Pl,toStoredTokens as ys,clearTokens as Tl,decodeJwtClaims as ws,isExpired as Sl,loadTokens as Rl,saveTokens as ks,resolveActiveProfile as fn,setProfileProject as Dl,readProjectConfig as jl}from"document360-engine";W();import{select as ul}from"@inquirer/prompts";import{resolveActiveProfile as dl,setProfileProject as pl,resolveProjectId as fl,listWorkspaces as ml}from"document360-engine";async function It(e,t){let n=dl(e,t),o={profile:n.name,connection:n.connection},r=n.project.projectId??fl(o);return{workspaces:await ml(o,r),projectId:r,projectName:n.project.projectName,profile:n.name,environment:n.connection.name,current:n.project.workspaceId}}var ps=e=>`${e.name??e.id}${e.workspace_type?` \xB7 ${e.workspace_type}`:""}`;function xo(e,t){let n=t.toLowerCase();return e.find(o=>(o.name??"").toLowerCase()===n)??e.find(o=>(o.name??"").toLowerCase().startsWith(n))??e.find(o=>o.id.startsWith(t))}function pn(e,t,n,o,r){pl(e,t,{projectId:n,workspaceId:o,workspaceName:r})}async function fs(e,t,n){let o;try{o=await It(e,n)}catch(s){return console.log($(`Could not list workspaces: ${s.message}`)),1}let r=xo(o.workspaces,t);return r?(pn(e,o.profile,o.projectId,r.id,r.name),console.log(E(`\u2713 Workspace set to "${r.name??r.id}" for profile "${o.profile}".`)),0):(console.log($(`No workspace matches "${t}". Available: ${o.workspaces.map(s=>s.name??s.id).join(", ")}`)),1)}async function ht(e,t){let n;try{n=await It(e,t)}catch(b){console.log($(`Could not list workspaces: ${b.message}`));return}let{workspaces:o,projectId:r,profile:s,current:c}=n;if(o.length===0){console.log(f("No workspaces found in this project."));return}if(!process.stdin.isTTY){console.log("");for(let b of o)console.log(` ${b.id===c?I("\u25CF"):" "} ${ps(b)} ${f(b.id)}`);console.log(f("Run: d360-writer workspace use <name>"));return}let p=await ul({message:"Select the Document360 workspace for this repo:",choices:o.map(b=>({name:`${ps(b)}${b.id===c?" (current)":""}`,value:b.id}))}),h=o.find(b=>b.id===p);pn(e,s,r,p,h?.name),console.log(E(`\u2713 Workspace set to "${h?.name??p}" for profile "${s}".`))}W();import{select as hl}from"@inquirer/prompts";import{resolveActiveProfile as gl,setProfileProject as wl,listProjects as yl}from"document360-engine";async function gt(e,t){let n=gl(e,t),o={profile:n.name,connection:n.connection};return{projects:await yl(o),profile:n.name,environment:n.connection.name,current:n.project.projectId}}var ms=e=>`${e.name??e.id}${e.sub_domain?` \xB7 ${e.sub_domain}`:""}`;function hs(e,t){let n=t.toLowerCase();return e.find(o=>(o.name??"").toLowerCase()===n)??e.find(o=>(o.name??"").toLowerCase().startsWith(n))??e.find(o=>o.id.startsWith(t))}function $o(e,t,n,o){wl(e,t,{projectId:n,projectName:o,workspaceId:void 0,workspaceName:void 0})}async function gs(e,t){let n;try{n=await gt(e,t)}catch(h){console.log($(`Could not list projects: ${h.message}`));return}let{projects:o,profile:r,current:s}=n;if(o.length===0){console.log(f("No projects found for this identity."));return}if(!process.stdin.isTTY){console.log("");for(let h of o)console.log(` ${h.id===s?I("\u25CF"):" "} ${ms(h)} ${f(h.id)}`);console.log(f("Run: d360-writer project use <name>"));return}let c=await hl({message:"Select the Document360 project for this repo:",choices:o.map(h=>({name:`${ms(h)}${h.id===s?" (current)":""}`,value:h.id}))}),p=o.find(h=>h.id===c);$o(e,r,c,p?.name),console.log(E(`\u2713 Project set to "${p?.name??c}" for profile "${r}". Next: pick a workspace.`))}W();import kl from"picocolors";function bl(e=process.env){return e.FORCE_HYPERLINK==="0"||!kl.isColorSupported?!1:e.FORCE_HYPERLINK?!0:!!(e.WT_SESSION||e.TERM_PROGRAM==="vscode"||e.TERM_PROGRAM==="iTerm.app"||e.TERM_PROGRAM==="WezTerm"||e.TERM_PROGRAM==="ghostty"||e.VTE_VERSION||e.KONSOLE_VERSION)}function xl(e,t=e,n){return bl(n)?`\x1B]8;;${e}\x07${t}\x1B]8;;\x07`:t}var $l=/https?:\/\/[^\s\x1b]+/g;function Nt(e,t){return e.replace($l,n=>xl(n,n,t))}function bs(e){return{...ws(e.idToken)??{},...ws(e.accessToken)??{}}}function mn(e){let t=bs(e),n=t.email??t.preferred_username??t.sub??"unknown",o=t.doc360_project_id?` \xB7 project ${t.doc360_project_id}`:"";return`${n}${o}`}async function hn(e){let t=fn(process.cwd(),e.profile),n=t.connection;console.log(f(`Profile "${t.name}" \u2192 ${n.name} (${n.apiUrl})${t.production?" \u26A0 PRODUCTION":""}`));let o=await Cl(n,{manual:e.manual,promptForRedirect:s=>vl({message:s})},s=>console.log(Nt(s))),r=ys(t.name,o);if(ks(r),await vo(r,t.name,s=>console.log(f(s))),console.log(""),console.log(E(`\u2713 Logged in to "${t.name}" as ${mn(r)}`)),console.log(f(` access token expires: ${r.expiresAt}`)),console.log(f(` refresh token: ${r.refreshToken?"yes":"NO \u2014 session ends at expiry"}`)),process.stdin.isTTY)try{jl(process.cwd())?.profiles?.[t.name]&&(console.log(""),await ht(process.cwd(),t.name))}catch{}}async function vo(e,t,n){let r=bs(e).doc360_project_id;if(!(typeof r!="string"||!r))try{if(fn(process.cwd(),t).project.projectId)return;let c;try{let{projects:p}=await gt(process.cwd(),t);c=p.find(h=>h.id===r)?.name}catch{}Dl(process.cwd(),t,{projectId:r,projectName:c}),n(` Project "${c??r}" written to profile "${t}".`)}catch{}}async function xs(e){let t=fn(process.cwd(),e.profile),n=t.connection,o=Rl(t.name);if(!o){console.log($(`Not logged in to Document360 (profile "${t.name}").`)),console.log(f(`Run: d360-writer login --profile ${t.name}`)),process.exitCode=1;return}if(console.log(`Profile ${I(t.name)}${t.production?" \u26A0 PRODUCTION":""}: ${mn(o)}`),Sl(o))if(o.refreshToken)try{let r=ys(t.name,await Pl(n,o.refreshToken));ks(r),console.log(E(`\u2713 Session refreshed \u2014 expires ${r.expiresAt}`))}catch(r){console.log(U(`Session expired and refresh failed (${r.message.slice(0,120)})`)),console.log(f(`Run: d360-writer login --profile ${t.name}`)),process.exitCode=1}else console.log(U("Session expired (no refresh token).")),console.log(f(`Run: d360-writer login --profile ${t.name}`)),process.exitCode=1;else console.log(f(` expires: ${o.expiresAt}`))}async function $s(e){let t=fn(process.cwd(),e.profile);Tl(t.name)?console.log(E(`\u2713 Logged out of Document360 (profile "${t.name}").`)):console.log(f(`No Document360 session for profile "${t.name}" \u2014 nothing to do.`))}W();import{readProjectConfig as vs,writeProjectConfig as Al,resolveActiveProfile as El,loadTokens as Il,isExpired as Nl}from"document360-engine";function gn(e){let t=vs(e);if(!t?.profiles||Object.keys(t.profiles).length===0){console.log($("No profiles in .d360-writer.json. Run: d360-writer init")),process.exitCode=1;return}console.log("");for(let[n,o]of Object.entries(t.profiles)){let r=n===t.defaultProfile?I("\u25CF "):" ",s=o.production?U(" \u26A0 PRODUCTION"):"",c=o.connection.environment??"(inline)",p=Il(n),h=p?Nl(p)&&!p.refreshToken?U("expired"):f("logged in"):f("not logged in");console.log(`${r}${I(n)} \u2192 ${c}${s} [${h}]`)}console.log(""),console.log(f("\u25CF = default. Switch with: d360-writer profile use <name>")),console.log("")}function wn(e,t){let n=vs(e);if(!n?.profiles?.[t]){let r=n?.profiles?Object.keys(n.profiles).join(", "):"(none \u2014 run init)";console.log($(`Unknown profile "${t}". Available: ${r}`)),process.exitCode=1;return}n.defaultProfile=t,Al(n,e);let o=n.profiles[t].production?U(" \u26A0 PRODUCTION"):"";console.log(E(`\u2713 Default profile is now "${t}"${o}`))}function yn(e,t){try{let n=El(e,t);console.log(""),console.log(`Profile ${I(n.name)}${n.production?U(" \u26A0 PRODUCTION"):""}`),console.log(f(` api: ${n.connection.apiUrl}`)),console.log(f(` identity: ${n.connection.authorizationUrl}`)),console.log(f(` clientId: ${n.connection.clientId}`)),console.log(f(` scopes: ${n.connection.scopes.join(" ")}`)),console.log(f(` project: ${n.project.projectId??"(set at login)"}`)),console.log(f(` workspace:${n.project.workspaceId?" "+n.project.workspaceId:" (none)"}`)),console.log("")}catch(n){console.log($(n.message)),process.exitCode=1}}W();import{existsSync as _l,readdirSync as Ol,statSync as Ul}from"node:fs";import{join as Ll}from"node:path";import{apiLogDir as Ml}from"document360-engine";function Cs(){let e=Ml();if(console.log(""),console.log(`Document360 API logs: ${I(e)}`),!_l(e)){console.log(f(" No logs yet \u2014 they appear after the first Document360 API call.")),console.log("");return}let t=Ol(e).filter(n=>n.endsWith(".jsonl")).sort().reverse();t.length===0&&console.log(f(" No logs yet \u2014 they appear after the first Document360 API call."));for(let n of t.slice(0,14)){let o=(Ul(Ll(e,n)).size/1024).toFixed(1);console.log(` ${n} ${f(`${o} KB`)}`)}console.log(""),console.log(f("Failed calls include request/response bodies (tokens redacted, 4 KB cap).")),console.log(f("Set D360_LOG_BODIES=1 to also log bodies for successful calls.")),console.log("")}W();import{createSession as Wl,resolveAuth as Fl,findByName as Hl,slugify as ql,touchSession as Bl,upsertSession as Gl,resolveActiveProfile as Vl}from"document360-engine";async function Ps(e,t,n,o,r,s){let c=Fl(n);c.kind==="none"&&(console.error(""),console.error($("ANTHROPIC_API_KEY is not set (required for --auth api).")),console.error(`Get a key at ${I("https://console.anthropic.com/settings/keys")}`),console.error(`Or use your Claude subscription instead: ${I("d360-writer --auth subscription")}`),process.exit(2)),c.kind==="subscription"&&console.error(f("Using your Claude subscription (no API key set)."));let p=null;try{p=Vl(e,r)}catch(k){console.error($(`Document360 profile error: ${k.message}`)),process.exit(2)}p.production&&(console.error(U(`\u26A0 Profile "${p.name}" is PRODUCTION.`)),s||(console.error($("Refusing to run against a production profile without --yes.")),process.exit(2)),console.error(f(" --yes given \u2014 proceeding against production.")));let h;if(o){let k=Hl(e,o);k||(console.error($(`No saved session matches "${o}" in this repo.`)),console.error(f("List sessions inside the REPL with /resume.")),process.exit(2)),h=k.uuid,console.error(f(`Resuming "${k.name}"`))}let b=Wl({cwd:e,resume:h,profileName:r,allowProdWrites:s===!0}),w=h??null,R=1;for await(let k of b.send(t))switch(k.type){case"session":if(!w){w=k.sessionId;let C=new Date().toISOString();Gl({uuid:w,name:ql(t),renamed:!1,titled:!1,cwd:e,firstPrompt:t,createdAt:C,updatedAt:C})}break;case"text":process.stdout.write(k.delta);break;case"tool":console.error(ee(` \u2699 ${k.name}`));break;case"result":R=k.ok?0:1,console.error(f(`(${k.inputTokens}\u2192${k.outputTokens} tokens`+(k.costUsd>0?`, $${k.costUsd<.01?k.costUsd.toFixed(4):k.costUsd.toFixed(2)}`:"")+")")),k.ok||console.error($("agent finished with an error result"));break;case"error":console.error(""),console.error($(`agent error: ${k.message}`)),process.exit(1)}w&&Bl(w),process.stdout.write(`
|
|
164
182
|
`),process.exit(R)}import{createInterface as xd}from"node:readline/promises";import{createSession as Dr,resolveAuth as $d,getSession as vd,setTitle as Cd,slugify as Pd,touchSession as pa,upsertSession as Td,generateTitle as Sd,resolveActiveProfile as fa,resolveModelSetting as Rd,readProjectConfig as Dd,decodeJwtClaims as ua,isExpired as jd,loadTokens as Ad}from"document360-engine";var _t=[{name:"init",usage:"/init",desc:"Pick an environment, scaffold .d360-writer.json, and set up the builder hand-off (prints the one-paste prompt)",group:"start"},{name:"login",usage:"/login",desc:"Sign in to Document360 (browser)",group:"start"},{name:"project",usage:"/project [name]",desc:"Choose the Document360 project (picker; lists all you can access)",group:"start"},{name:"devhints",usage:"/devhints",desc:"Re-show/refresh the builder hand-off prompt (set up by /init; run anytime to hand your repo agent the latest)",group:"start"},{name:"scope",usage:"/scope",desc:"Choose which repo folders back the docs (monorepos)",group:"start"},{name:"mcp",usage:"/mcp [list|add|remove]",desc:"Connect MCP servers (Notion, Linear, \u2026)",group:"start"},{name:"draft",usage:"/draft [<feature>]",desc:"Draft a feature's articles from its PRDs/specs in .d360-writer/input/ + the code",group:"docs"},{name:"document",usage:"/document [<what>] [--publish]",desc:"Document a shipped change \u2014 the agent picks the action (new section/article/update); bare: act on builder requests",group:"docs"},{name:"write",usage:"/write [--all|--scope <cat>|<path>] [--run]",desc:"Author the planned articles in parallel (bare = preview + cost; --run starts)",group:"docs"},{name:"screenshot",usage:"/screenshot [--list|id|--all|path]",desc:"--list: status; else author capture specs (bulk also refreshes the capture checklist; --no-setup skips)",group:"docs"},{name:"capture-setup",usage:"/capture-setup",desc:"Re-run the data-staging checklist + dev test-id requests (auto-runs after /screenshot --all)",group:"docs"},{name:"preview",usage:"/preview [path|id]",desc:"Render an article (no arg: pick from tracked)",group:"docs"},{name:"publish",usage:"/publish [path|--all]",desc:"Publish to Document360 (no arg: pick; --all: every candidate)",group:"publish"},{name:"audit",usage:"/audit",desc:"Gap analysis: code vs docs vs Document360 (what changed)",group:"publish"},{name:"inbox",usage:"/inbox",desc:"Act on messages from the repo's coding agent (requests to document, answers to your questions)",group:"publish"},{name:"catch-up",usage:"/catch-up [--publish]",desc:"Process ALL pending work (hints + requests + drift) \u2192 write \u2192 push to Document360 (bare = drafts; --publish goes live)",group:"publish"},{name:"sync",usage:"/sync [pull <path>|--all]",desc:"Drift report local vs Document360; pull portal edits",group:"publish"},{name:"convert",usage:"/convert [--scope <folder>] [--run]",desc:"Convert tracked articles to DFM (one-off legacy migration)",group:"publish"},{name:"profile",usage:"/profile [name|add <name> [env]]",desc:"Switch/create a Document360 connection (picker; s = session)",group:"setup"},{name:"workspace",usage:"/workspace [name]",desc:"Switch the Document360 workspace (picker)",group:"setup"},{name:"model",usage:"/model [name|default]",desc:"Set the Claude model for d360-writer",group:"setup"},{name:"logout",usage:"/logout",desc:"Sign out + clear project/workspace selection (then /login to re-pick)",group:"setup"},{name:"allow-prod",usage:"/allow-prod",desc:"Authorize writes to a production profile",group:"setup"},{name:"doctor",usage:"/doctor",desc:"Health-check: auth, profile, workspace, map, API",group:"setup"},{name:"update",usage:"/update",desc:"Update d360-writer to the latest version (then relaunch)",group:"setup"},{name:"reset",usage:"/reset",desc:"[DANGER] Delete all d360-writer files (docs, config, screenshots); types repo name to confirm",group:"setup"},{name:"resume",usage:"/resume [name]",desc:"Resume a session (no arg lists them)",group:"session"},{name:"rename",usage:"/rename [name]",desc:"Name the session (no arg: suggest one)",group:"session"},{name:"clear",usage:"/clear",desc:"Reset the conversation (resumable)",group:"session"},{name:"help",usage:"/help",desc:"Show this help",group:"session"},{name:"exit",usage:"/exit",desc:"Quit",group:"session"}],Yl=[{key:"start",label:"Start here"},{key:"docs",label:"Write & screenshots"},{key:"publish",label:"Publish & keep in sync"},{key:"setup",label:"Setup & health"},{key:"session",label:"Session"}];function kn(){let e=Math.max(..._t.map(n=>n.usage.length))+2,t=["document360-writer \u2014 commands","","New here? Four steps from a fresh repo to published docs:"," 1. /init \u2192 connect, scaffold config, AND print a one-paste hand-off prompt for your source repo"," 2. run that prompt in your repo's coding agent (Claude Code / Codex / Cursor)",' 3. "write the docs for this repo" \u2192 back here, the agent authors the articles'," 4. /publish \u2192 dual-publish to Document360",""," Screenshots are optional \u2014 add them anytime:"," /screenshot --all \u2192 d360-capture capture \u2192 re-/publish"];for(let{key:n,label:o}of Yl){t.push("",o);for(let r of _t.filter(s=>s.group===n))t.push(` ${r.usage.padEnd(e)}${r.desc}`)}return t.push("","Tip: anything not starting with / is sent to the agent."),t}function Ts(e){if(!e.startsWith("/"))return[];let t=e.slice(1).toLowerCase().split(/\s/)[0]??"";return _t.filter(n=>n.name.startsWith(t))}function Ss(e){return/<[^>]+>/.test(e.replace(/\[[^\]]*\]/g,""))}async function Co(){console.log("");for(let e of kn())console.log(e);return console.log(""),console.log("Reporting a problem? Run `d360-writer logs` for the API log files."),console.log(""),{kind:"continue"}}W();import{getSession as zl}from"document360-engine";async function Rs(e,t){let n=t.currentUuid(),o=n?zl(n):void 0;return console.log(o?f(`
|
|
165
183
|
(conversation reset \u2014 "${o.name}" is still available via /resume)
|
|
166
184
|
`):f(`
|
|
@@ -197,9 +215,9 @@ No MCP servers registered. Add one with /mcp add <name> <type> <ref>
|
|
|
197
215
|
`+bc[e.tone](Nt(e.text));case"done":return`
|
|
198
216
|
`+(e.ok?z.magenta("\u2736 "):z.red("\u2736 "))+z.gray(`Cooked for ${Mt(e.seconds)} \xB7 ${e.tokens} tokens`+(e.costUsd>0?` \xB7 ${le(e.costUsd)}`:""))}}function ni(e,t){return e.map(n=>Oo(n,t)).join(`
|
|
199
217
|
`)}import{resolveActiveProfile as xc,loadTokens as $c,isExpired as vc,decodeJwtClaims as oi}from"document360-engine";function Cc(e){return e.length>12?`${e.slice(0,8)}\u2026`:e}function Se(e,t){try{let n=xc(e,t),o=$c(n.name);if(!o)return{ok:!1,reason:`Not signed in to Document360 (profile "${n.name}"). Run /login first.`};if(vc(o)&&!o.refreshToken)return{ok:!1,reason:`Your Document360 session expired (profile "${n.name}"). Run /login.`};let r=n.project.projectId;if(r){let c={...oi(o.idToken)??{},...oi(o.accessToken)??{}}.doc360_project_id;if(typeof c=="string"&&c&&c!==r)return{ok:!1,reason:`Your Document360 session is signed into a different project than profile "${n.name}" (this profile's project is ${Cc(r)}). Run /login and pick this project.`}}return{ok:!0}}catch{return{ok:!0}}}var Wt=3;function Mo(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(`
|
|
200
|
-
`)}var ri={"local-ahead":"modified locally","untracked-local":"new (never published)",conflict:"\u26A0 conflict \u2014 publishing overwrites the portal edit"};function Ft(e){return e.filter(t=>t.path!==null&&t.status in ri&&!t.
|
|
201
|
-
`)}function Wo(e,t,n){let o=k=>t[k.index]?.paths.length??0,r=e.filter(k=>k.ok),s=e.filter(k=>!k.ok),c=e.reduce((k,C)=>k+o(C),0),p=r.reduce((k,C)=>k+o(C),0),h=n==="api"?`${le(e.reduce((k,C)=>k+C.costUsd,0))} total`:Ue(e.reduce((k,C)=>k+C.outputTokens,0)),b=`${r.length}/${e.length} partition${e.length===1?"":"s"}`,w=k=>`${k} article${k===1?"":"s"}`,R=[];if(s.length===0)R.push(`Published ${w(c)} (${b}) successfully \xB7 ${h}.`),R.push("All are DRAFTS \u2014 review and publish them in the Document360 portal.");else{R.push(`Published ${p}/${w(c)} (${b}) \xB7 ${h}.`),R.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 k of s)R.push(` \u2717 ${k.label}${k.error?` \u2014 ${k.error}`:""}`)}return R}async function Uo(e,t){let n=Tc(t),{model:o}=Rc(e.cwd,"standard");console.log(f(`Publishing ${t.length} article${t.length===1?"":"s"} across ${n.length} partition${n.length===1?"":"s"} (\u2264${Wt} agents at once) on ${o}\u2026`)),console.log(f(" (mid-run abort is TUI-only \u2014 Ctrl+C exits the REPL.)"));try{for await(let r of Dc({cwd:e.cwd,partitions:n,promptFor:s=>Dn(s.paths),concurrency:Wt,profileName:e.profileName,allowProdWrites:e.allowProdWrites(),model:o}))if(r.type==="partition_status")r.status==="running"?console.log(f(` \u25B8 ${r.label} \u2014 publishing\u2026`)):r.status==="done"?console.log(E(` \u2713 ${r.label}`)):console.log($(` \u2717 ${r.label}`));else if(r.type==="run_done"){console.log("");let s=process.env.ANTHROPIC_API_KEY?"api":"subscription";for(let c of Wo(r.results,n,s))console.log(r.ok?E(c):U(c))}}catch(r){console.log($(`Publish run failed: ${r.message}`))}return console.log(""),{kind:"continue"}}async function jn(e,t,n){let o=Sc(e,n);if(o.length===0)return[];let r=new Set(Ft((await Lo({cwd:e,profileName:t})).entries).map(s=>s.path));return o.filter(s=>r.has(s))}async function ii(e,t){let n=Se(t?.cwd??process.cwd(),t?.profileName);if(!n.ok)return console.log($(n.reason)),{kind:"continue"};let o=e[0];if(o==="--related"&&e[1]){if(!t)return{kind:"continue"};let r=await jn(t.cwd,t.profileName,e[1].replace(/\\/g,"/"));return r.length===0?(console.log(E("\u2713 All related articles are already published.")),{kind:"continue"}):await Uo(t,r)}if(o==="--all"){console.log(f("Checking what needs publishing\u2026"));try{let r=await Lo({cwd:t?.cwd??process.cwd()}),s=Ft(r.entries),c=Rn(r.entries);return c>0&&console.log(U(`\u26A0 ${c} article(s) already exist on Document360 but aren't linked \u2014 left out (publishing would duplicate them). Run /catch-up or ask me to
|
|
202
|
-
`),display:"/audit"}}W();import{checkbox as Ac}from"@inquirer/prompts";import{inventoryRepo as Ec,readProjectConfig as ai,writeProjectConfig as Ic}from"document360-engine";function Fo(e,t){let n=ai(e);n&&(n.authoritativeSourceFiles=t,Ic(n,e))}function En(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 li(e,t){let n=t?.cwd??process.cwd();if(!ai(n))return console.log($("No .d360-writer.json here. Run /init first.")),{kind:"continue"};let o=Ec(n);if(o.length===0)return console.log(f('No candidate source folders found. Set "authoritativeSourceFiles" in .d360-writer.json manually.')),{kind:"continue"};if(!process.stdin.isTTY||!t){console.log(""),console.log(I("Recommended documentation scope (run /scope in the REPL to choose):"));for(let s of o)console.log(` ${s.recommended?"\u25C9":"\u25CB"} ${s.path} ${f(En(s))}`);return console.log(""),{kind:"continue"}}let r;try{r=await t.withPausedInput(()=>Ac({message:"Which folders back the user docs? (space toggles, enter confirms)",choices:o.map(s=>({name:`${s.path} (${En(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"};Fo(n,r),console.log(E(`\u2713 Scoped to ${r.length} folder(s) \u2014 written to .d360-writer.json`));for(let s of r)console.log(` ${s}`);return console.log(""),{kind:"continue"}}W();import{confirm as Lc}from"@inquirer/prompts";import{applyPull as fi,computeSyncStatus as mi,planPull as Mc,D360AuthError as Wc}from"document360-engine";W();var ci=[{status:"conflict",header:"Changed in both places \u2014 pick a direction (/sync pull <path> or /publish <path>):",paint:$,mark:"!"},{status:"local-ahead",header:"Changed here \u2014 push with /publish <path>:",paint:U,mark:"M"},{status:"remote-ahead",header:"Changed on Document360 \u2014 pull with /sync pull <path>:",paint:I,mark:"M"},{status:"deleted-local",header:"Removed locally \u2014 still on Document360 (pull to restore, or leave it):",paint:$,mark:"D"},{status:"deleted-remote",header:"Gone from Document360 \u2014 still here (publish to recreate, or delete the file):",paint:$,mark:"D"},{status:"orphaned",header:"Gone from both sides \u2014 these tracking entries point at nothing now:",paint:ee,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:",paint:f,mark:"?"},{status:"unknown-base",header:"Tracked, not yet compared \u2014 the next publish or pull will set a baseline:",paint:ee,mark:"\xB7"}];function Nc(e){return e.path?e.path:`${e.title??"(untitled)"} ${ee(`[${e.articleId}]`)}`}function In(e){let t=[],n=e.entries.filter(h=>h.
|
|
218
|
+
`)}var ri={"local-ahead":"modified locally","untracked-local":"new (never published)",conflict:"\u26A0 conflict \u2014 publishing overwrites the portal edit"};function Ft(e){return e.filter(t=>t.path!==null&&t.status in ri&&!t.link).map(t=>({path:t.path,label:ri[t.status]}))}function Rn(e){return e.filter(t=>t.link).length}function jc(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 si(e){let t=[];e.length>1&&t.push({kind:"all",label:`Publish all ${e.length} articles`,paths:e.map(o=>o.path),indent:!1});let n=new Map;for(let o of e){let r=o.path.replace(/\\/g,"/").split("/").slice(0,-1).join("/"),s=n.get(r);s?s.push(o):n.set(r,[o])}for(let o of[...n.keys()].sort()){let r=n.get(o).sort((s,c)=>s.path.localeCompare(c.path));t.push({kind:"category",label:`${jc(o)} (${r.length})`,paths:r.map(s=>s.path),indent:!1});for(let s of r){let c=s.path.replace(/\\/g,"/").split("/").pop()??s.path;t.push({kind:"article",label:c,paths:[s.path],indent:!0,note:s.label})}}return t}function Dn(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(`
|
|
219
|
+
`)}function Wo(e,t,n){let o=k=>t[k.index]?.paths.length??0,r=e.filter(k=>k.ok),s=e.filter(k=>!k.ok),c=e.reduce((k,C)=>k+o(C),0),p=r.reduce((k,C)=>k+o(C),0),h=n==="api"?`${le(e.reduce((k,C)=>k+C.costUsd,0))} total`:Ue(e.reduce((k,C)=>k+C.outputTokens,0)),b=`${r.length}/${e.length} partition${e.length===1?"":"s"}`,w=k=>`${k} article${k===1?"":"s"}`,R=[];if(s.length===0)R.push(`Published ${w(c)} (${b}) successfully \xB7 ${h}.`),R.push("All are DRAFTS \u2014 review and publish them in the Document360 portal.");else{R.push(`Published ${p}/${w(c)} (${b}) \xB7 ${h}.`),R.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 k of s)R.push(` \u2717 ${k.label}${k.error?` \u2014 ${k.error}`:""}`)}return R}async function Uo(e,t){let n=Tc(t),{model:o}=Rc(e.cwd,"standard");console.log(f(`Publishing ${t.length} article${t.length===1?"":"s"} across ${n.length} partition${n.length===1?"":"s"} (\u2264${Wt} agents at once) on ${o}\u2026`)),console.log(f(" (mid-run abort is TUI-only \u2014 Ctrl+C exits the REPL.)"));try{for await(let r of Dc({cwd:e.cwd,partitions:n,promptFor:s=>Dn(s.paths),concurrency:Wt,profileName:e.profileName,allowProdWrites:e.allowProdWrites(),model:o}))if(r.type==="partition_status")r.status==="running"?console.log(f(` \u25B8 ${r.label} \u2014 publishing\u2026`)):r.status==="done"?console.log(E(` \u2713 ${r.label}`)):console.log($(` \u2717 ${r.label}`));else if(r.type==="run_done"){console.log("");let s=process.env.ANTHROPIC_API_KEY?"api":"subscription";for(let c of Wo(r.results,n,s))console.log(r.ok?E(c):U(c))}}catch(r){console.log($(`Publish run failed: ${r.message}`))}return console.log(""),{kind:"continue"}}async function jn(e,t,n){let o=Sc(e,n);if(o.length===0)return[];let r=new Set(Ft((await Lo({cwd:e,profileName:t})).entries).map(s=>s.path));return o.filter(s=>r.has(s))}async function ii(e,t){let n=Se(t?.cwd??process.cwd(),t?.profileName);if(!n.ok)return console.log($(n.reason)),{kind:"continue"};let o=e[0];if(o==="--related"&&e[1]){if(!t)return{kind:"continue"};let r=await jn(t.cwd,t.profileName,e[1].replace(/\\/g,"/"));return r.length===0?(console.log(E("\u2713 All related articles are already published.")),{kind:"continue"}):await Uo(t,r)}if(o==="--all"){console.log(f("Checking what needs publishing\u2026"));try{let r=await Lo({cwd:t?.cwd??process.cwd()}),s=Ft(r.entries),c=Rn(r.entries);return c>0&&console.log(U(`\u26A0 ${c} 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.`)),s.length===0?(console.log(E(c>0?"\u2713 Nothing else is ahead of Document360 to publish.":"\u2713 Nothing is ahead of Document360 \u2014 no publish candidates.")),{kind:"continue"}):t?await Uo(t,s.map(p=>p.path)):{kind:"forward-to-agent",prompt:Dn(s.map(p=>p.path)),display:"/publish --all"}}catch(r){return console.log($(`Could not compute sync status: ${r.message}`)),{kind:"continue"}}}if(!o){console.log(f("Checking what needs publishing\u2026"));let r;try{let s=await Lo({cwd:t?.cwd??process.cwd()});r=Ft(s.entries);let c=Rn(s.entries);c>0&&console.log(U(`\u26A0 ${c} 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.`))}catch(s){return console.log($(`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(E("\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(()=>Pc({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 Uo(t,r.map(s=>s.path))}return{kind:"forward-to-agent",prompt:Mo(o),display:`/publish ${o}`}}async function An(){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(`
|
|
220
|
+
`),display:"/audit"}}W();import{checkbox as Ac}from"@inquirer/prompts";import{inventoryRepo as Ec,readProjectConfig as ai,writeProjectConfig as Ic}from"document360-engine";function Fo(e,t){let n=ai(e);n&&(n.authoritativeSourceFiles=t,Ic(n,e))}function En(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 li(e,t){let n=t?.cwd??process.cwd();if(!ai(n))return console.log($("No .d360-writer.json here. Run /init first.")),{kind:"continue"};let o=Ec(n);if(o.length===0)return console.log(f('No candidate source folders found. Set "authoritativeSourceFiles" in .d360-writer.json manually.')),{kind:"continue"};if(!process.stdin.isTTY||!t){console.log(""),console.log(I("Recommended documentation scope (run /scope in the REPL to choose):"));for(let s of o)console.log(` ${s.recommended?"\u25C9":"\u25CB"} ${s.path} ${f(En(s))}`);return console.log(""),{kind:"continue"}}let r;try{r=await t.withPausedInput(()=>Ac({message:"Which folders back the user docs? (space toggles, enter confirms)",choices:o.map(s=>({name:`${s.path} (${En(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"};Fo(n,r),console.log(E(`\u2713 Scoped to ${r.length} folder(s) \u2014 written to .d360-writer.json`));for(let s of r)console.log(` ${s}`);return console.log(""),{kind:"continue"}}W();import{confirm as Lc}from"@inquirer/prompts";import{applyPull as fi,computeSyncStatus as mi,planPull as Mc,D360AuthError as Wc}from"document360-engine";W();var ci=[{status:"conflict",header:"Changed in both places \u2014 pick a direction (/sync pull <path> or /publish <path>):",paint:$,mark:"!"},{status:"local-ahead",header:"Changed here \u2014 push with /publish <path>:",paint:U,mark:"M"},{status:"remote-ahead",header:"Changed on Document360 \u2014 pull with /sync pull <path>:",paint:I,mark:"M"},{status:"deleted-local",header:"Removed locally \u2014 still on Document360 (pull to restore, or leave it):",paint:$,mark:"D"},{status:"deleted-remote",header:"Gone from Document360 \u2014 still here (publish to recreate, or delete the file):",paint:$,mark:"D"},{status:"orphaned",header:"Gone from both sides \u2014 these tracking entries point at nothing now:",paint:ee,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:",paint:f,mark:"?"},{status:"unknown-base",header:"Tracked, not yet compared \u2014 the next publish or pull will set a baseline:",paint:ee,mark:"\xB7"}];function Nc(e){return e.path?e.path:`${e.title??"(untitled)"} ${ee(`[${e.articleId}]`)}`}function In(e){let t=[],n=e.entries.filter(h=>h.link);if(n.length>0){t.push(""),t.push(xe("Already on Document360, just not linked \u2014 ask me to link these (a republish would duplicate them):"));for(let h of n)t.push(` ${U("~")} ${U(h.path??"")} ${ee(`\u2192 "${h.link.title}"`)}`)}for(let h of ci){let b=e.entries.filter(w=>w.status===h.status&&!(h.status==="untracked-local"&&w.link));if(b.length!==0){t.push(""),t.push(xe(h.header));for(let w of b)t.push(` ${h.paint(h.mark)} ${h.paint(Nc(w))}${w.detail?ee(` (${w.detail})`):""}`)}}let o=e.counts["in-sync"]??0,r=e.entries.length;t.push("");let s={"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"},c=n.length,p=r===o?E("\u2713 everything up to date"):[o>0?E(`\u2713 ${o} up to date`):null,c>0?`${c} to link`:null,...ci.map(h=>{let b=(e.counts[h.status]??0)-(h.status==="untracked-local"?c:0);return b>0?`${b} ${s[h.status]}`:null})].filter(Boolean).join(ee(" \xB7 "));return t.push(p+ee(` \xB7 ${r} tracked+seen \xB7 profile "${e.profile}" \xB7 docs root ${e.docsRoot}/`)),t}import{structuredPatch as _c}from"diff";import ui from"picocolors";var di=80,Oc="\x1B[48;2;74;28;28m",Uc="\x1B[48;2;24;66;24m",pi="\x1B[49m",Ho=e=>String(e).padStart(5);function Xe(e,t,n){let o=k=>{let C=k.replace(/\r\n/g,`
|
|
203
221
|
`);return C.endsWith(`
|
|
204
222
|
`)||C===""?C:C+`
|
|
205
223
|
`},r=o(e),s=o(t);if(r===s)return null;let c=Math.max(20,n-10),p=_c("a","b",r,s,"","",{context:3}),h=0,b=0,w=[];p.hunks.forEach((k,C)=>{C>0&&w.push(ui.gray(" \u2026"));let P=k.oldStart,N=k.newStart;for(let O of k.lines){let q=O[0],te=O.slice(1).slice(0,c);q==="-"?(b++,w.push(`${Oc}${Ho(P++)} - ${te}${pi}`)):q==="+"?(h++,w.push(`${Uc}${Ho(N++)} + ${te}${pi}`)):(w.push(ui.gray(Ho(N))+" "+te),P++,N++)}});let R=w.slice(0,di);return{added:h,removed:b,lines:R,hidden:Math.max(0,w.length-di)}}async function hi(e,t){let n=Se(t.cwd,t.profileName);if(!n.ok)return console.log($(n.reason)),{kind:"continue"};let o=(e[0]??"status").toLowerCase();try{if(o==="status")return await Fc(t.cwd),{kind:"continue"};if(o==="pull")return await Hc(t,e.slice(1)),{kind:"continue"};console.log($(`Unknown subcommand: /sync ${o}`)),console.log(f("Usage: /sync drift report (local vs Document360)")),console.log(f(" /sync pull <path> pull portal edits into the local file")),console.log(f(" /sync pull --all pull every remote-ahead article"))}catch(r){r instanceof Wc?console.log($(r.message)):console.log($(`Sync failed: ${r.message}`))}return{kind:"continue"}}async function Fc(e){console.log(f("Checking Document360 for drift\u2026"));let t=await mi({cwd:e});for(let n of In(t))console.log(n);console.log("")}async function Hc(e,t){let n=t[0];if(!n){console.log($("Usage: /sync pull <article-path> | --all"));return}let o;if(n==="--all"){if(console.log(f("Checking Document360 for drift\u2026")),o=(await mi({cwd:e.cwd})).entries.filter(s=>s.status==="remote-ahead"&&s.path).map(s=>s.path),o.length===0){console.log(E("\u2713 Nothing is remote-ahead \u2014 no pulls needed.")),console.log(f(" (conflicts are never bulk-pulled; pull them one by one: /sync pull <path>)"));return}console.log(`${xe(String(o.length))} article(s) are remote-ahead.`)}else o=[n.replace(/\\/g,"/")];for(let r of o){let s=await Mc({cwd:e.cwd,relPath:r});console.log(""),console.log(`${I("\u25CF")} ${xe(s.title)} ${ee(`(${s.path})`)}`);for(let b of s.notes)console.log(U(` \u26A0 ${b}`));s.overwritesLocalChanges&&console.log(U(" \u26A0 This OVERWRITES local edits made since the last sync."));let c=Xe(s.oldContent,s.newContent,Math.max(40,(process.stdout.columns??80)-1));if(!c){console.log(f(" Local file already matches the remote content \u2014 advancing the sync base only.")),fi({cwd:e.cwd},s);continue}let p=b=>b===1?"":"s";console.log(ee(` \u23BF Added ${c.added} line${p(c.added)}, removed ${c.removed} line${p(c.removed)}`));for(let b of c.lines)console.log(b);if(c.hidden>0&&console.log(f(` \u2026 +${c.hidden} more diff lines`)),!await e.withPausedInput(()=>Lc({message:`Write ${s.path}?`,default:!s.overwritesLocalChanges}))){console.log(f(" Skipped."));continue}fi({cwd:e.cwd},s),console.log(E(` \u2713 Pulled ${s.path} (sync base advanced).`))}console.log("")}W();import{statSync as qc}from"node:fs";import{resolve as Bc}from"node:path";import{estimateBulkCost as Gc,planPartitions as Vc,readProjectConfig as Yc,resolveModelForOperation as zc,runPartitioned as Kc,trackedArticlePaths as Xc}from"document360-engine";var qo=3;function Bo(e){let t,n=!1;for(let r=0;r<e.length;r++){let s=e[r];s==="--run"||s==="--yes"?n=!0:s==="--scope"?t=e[++r]:s?.startsWith("--scope=")&&(t=s.slice(8))}return{scope:t?.replace(/\\/g,"/").replace(/\/+$/,"")||void 0,run:n}}function Go(e,t){return t?e.filter(n=>{let o=n.replace(/\\/g,"/");return o===t||o.startsWith(`${t}/`)}):e}function Vo(e,t){return t.map(n=>{let o=0;try{o=qc(Bc(e,n)).size}catch{o=0}return{path:n,bytes:o}})}function Yo(e){return`Convert each of these articles to canonical Document360 Flavored Markdown (DFM) and re-publish each as a DRAFT. This is a mechanical syntax conversion, not a rewrite \u2014 be efficient:
|
|
@@ -231,8 +249,8 @@ Articles:
|
|
|
231
249
|
`);return{lines:s.slice(0,t).map(c=>fe(c,Rr)),hidden:Math.max(0,s.length-t)}}function qn(e,t,n,o="en"){return`${e.replace(/\/$/,"")}/${t}/document/v1/${o}/${n}`}function Bn(e,t){if(typeof e.article_id=="string"&&e.article_id)return e.article_id;try{let n=JSON.parse(t),r=(Array.isArray(n)?n[0]:n)?.id;return typeof r=="string"&&r?r:null}catch{return null}}function Gn(e){try{let t=JSON.parse(e),o=(Array.isArray(t)?t[0]:t)?.url;return typeof o=="string"&&/^https?:\/\//.test(o)?o:null}catch{return null}}var Ed=/^mcp__document360__d360_(create_article|update_article|fork_article|publish_article)$/;function Id(e,t,n,o){if(Ed.test(e))try{let r=fa(o),s=typeof t.project_id=="string"&&t.project_id||r.project.projectId,c=Bn(t,n),p=Gn(n);e.endsWith("publish_article")&&p&&console.log(I(` \u2B95 Live: ${p}`)),c&&s&&console.log(I(` \u2B95 Preview: ${qn(r.connection.portalUrl,s,c,r.project.languageCode??"en")}`))}catch{}}async function ma(e=process.cwd(),t="auto",n){let o=$d(t);o.kind==="none"&&(console.error(""),console.error($("ANTHROPIC_API_KEY is not set (required for --auth api).")),console.error(""),console.error(` ${I("export ANTHROPIC_API_KEY=sk-ant-...")} (macOS / Linux)`),console.error(` ${I('$env:ANTHROPIC_API_KEY="sk-ant-..."')} (PowerShell)`),console.error(""),console.error(`Get a key at ${I("https://console.anthropic.com/settings/keys")}`),console.error(`Or use your Claude subscription instead: ${I("d360-writer --auth subscription")}`),console.error(""),process.exit(2)),Nd(e,n),o.kind==="subscription"&&(o.stored?console.log(f(" Using your Claude subscription (no API key set).")):console.log(f(" No API key or stored Claude Code login found \u2014 trying your Claude session anyway.")),console.log(""));let r=!1,s=Dr({cwd:e,profileName:n,allowProdWrites:r}),c={uuid:null,firstPrompt:null,titleFired:!1},p=xd({input:process.stdin,output:process.stdout}),h=[],b=null,w=!1;p.on("line",C=>{if(b){let P=b;b=null,P(C)}else h.push(C)}),p.on("close",()=>{if(w=!0,b){let C=b;b=null,C(null)}});function R(){return h.length>0?Promise.resolve(h.shift()):w?Promise.resolve(null):(process.stdout.write(I("> ")),new Promise(C=>{b=C}))}let k={cwd:e,profileName:n,allowProdWrites:()=>r,restartAgent:()=>{s.close(),s=Dr({cwd:e,profileName:n,allowProdWrites:r}),c={uuid:null,firstPrompt:null,titleFired:!1}},currentUuid:()=>c.uuid,setModel:async C=>s.setModel(C),withPausedInput:async C=>{p.pause();try{return await C()}finally{p.resume()}}};try{for(;;){let C=await R();if(C===null)break;let P=C.trim();if(P){if(P.startsWith("/")){let N=ia(P);if(!N)continue;let O=sa[N.name];if(!O){console.log($(`Unknown command: /${N.name}`)),console.log(f("Type /help for the list."));continue}let q=await O(N.args,k);if(q.kind==="exit")break;if(q.kind==="clear"){k.restartAgent();continue}if(q.kind==="allow-prod"){r=!0,k.restartAgent(),console.log(E("\u2713 Production writes authorized for this session.")),console.log("");continue}if(q.kind==="resume"){s.close(),s=Dr({cwd:e,resume:q.uuid,profileName:n,allowProdWrites:r});let te=vd(q.uuid);c={uuid:q.uuid,firstPrompt:te?.firstPrompt??null,titleFired:!0},pa(q.uuid),console.log(E(`\u2713 Resumed "${q.name}"`)),console.log("");continue}q.kind==="forward-to-agent"&&(c.firstPrompt||(c.firstPrompt=q.display??q.prompt),await da(s,q.prompt,o,c,e));continue}c.firstPrompt||(c.firstPrompt=P),await da(s,P,o,c,e)}}}finally{s.close(),p.close()}}function Nd(e,t){console.log(""),console.log(Et("document360-writer")),console.log(f(` cwd: ${e}`));let n=Rd(e);if(console.log(f(` model: ${n.model??"auto (engine right-sizes per task)"}${n.model?` (${n.source})`:""}`)),console.log(_d(e,t)),!Dd(e))console.log(U(" First run: /init (scaffolds config + prints the builder hand-off prompt) \u2192 /login, then ask me to write the docs."));else{try{vn(e);for(let o of Cn(e))console.log(U(` ${o}`))}catch{}try{let o=vt($t(e));o&&console.log(U(` \u{1F4CB} ${o} from the repo's coding agent \u2014 run /catch-up.`))}catch{}}console.log(f(" Type a prompt, or /help for slash commands. /exit to quit.")),console.log("")}function _d(e,t){try{let n=fa(e,t),o=n.production?U(" \u26A0 PRODUCTION"):"",r=Ad(n.name);if(!r)return f(` Document360: profile "${n.name}"${o} \u2014 not logged in (d360-writer login)`);let s={...ua(r.idToken)??{},...ua(r.accessToken)??{}},c=s.email??s.preferred_username??"signed in";return jd(r)&&!r.refreshToken?U(` Document360: profile "${n.name}"${o} \u2014 session expired (d360-writer login)`):f(` Document360: ${c} \xB7 profile "${n.name}"${o}`)}catch(n){return f(` Document360: ${n.message.split(".")[0]}`)}}function Od(){console.error(""),console.error(`Sign in with your Claude subscription: run ${I("claude")} once, then retry.`),console.error(` (No Claude Code? ${I("npm install -g @anthropic-ai/claude-code")})`),console.error(`Or set an API key: ${I("https://console.anthropic.com/settings/keys")}`)}function Ud(e,t,n){e.uuid=t;let o=new Date().toISOString();Td({uuid:t,name:Pd(e.firstPrompt??"session"),renamed:!1,titled:!1,cwd:n,firstPrompt:e.firstPrompt??"",createdAt:o,updatedAt:o})}function Ld(e,t){e.titleFired=!0;let n=e.uuid,o=e.firstPrompt;!n||!o||Sd(o,t).then(r=>{r&&Cd(n,r)}).catch(()=>{})}async function da(e,t,n,o,r){let s=new Map;for await(let c of e.send(t))Md(c,o,r,n,s)}function Md(e,t,n,o,r){switch(e.type){case"session":t.uuid||Ud(t,e.sessionId,n);break;case"text":process.stdout.write(e.delta);break;case"tool":{let s=Fn(e.name,e.input);s&&(process.stdout.write(`
|
|
232
250
|
|
|
233
251
|
`),console.log(`${E("\u25CF")} ${xe(s.title)}${s.arg!==null?ee(`${s.sep}(${s.arg})`):""}`),r.set(e.id,{name:e.name,input:e.input}));break}case"article_diff":{let s=Xe(e.oldContent,e.newContent,Math.max(40,(process.stdout.columns??80)-1));if(!s)break;let c=p=>p===1?"":"s";console.log(ee(` \u23BF Added ${s.added} line${c(s.added)}, removed ${s.removed} line${c(s.removed)}`));for(let p of s.lines)console.log(p);s.hidden>0&&console.log(f(` \u2026 +${s.hidden} more diff lines`));break}case"tool_result":{let s=r.get(e.id);if(!s)break;r.delete(e.id);let c=Hn(e.output,4,e.isError?void 0:s.name,s.input),p=e.isError?$:ee;c.lines.forEach((h,b)=>console.log(p((b===0?" \u23BF ":" ")+h))),c.hidden>0&&console.log(f(` \u2026 +${c.hidden} lines`)),e.isError||Id(s.name,s.input,e.output,n);break}case"result":process.stdout.write(`
|
|
234
|
-
`),console.log(f(` (${e.inputTokens}\u2192${e.outputTokens} tokens`+(e.costUsd>0?`, $${e.costUsd<.01?e.costUsd.toFixed(4):e.costUsd.toFixed(2)}`:"")+")")),console.log(""),t.uuid&&(pa(t.uuid),t.titleFired||Ld(t,n));break;case"error":console.error(""),console.error($(`agent error: ${e.message}`)),o.kind==="subscription"&&e.kind==="auth"&&Od();break}}import{render as qp}from"ink";import{resolveAuth as Bp}from"document360-engine";import{useCallback as Y,useEffect as ve,useMemo as _r,useRef as X,useState as F}from"react";import{Box as Z,Text as T,useApp as Qd,useInput as Zd,useStdout as ep}from"ink";import{existsSync as Yt,readFileSync as Or,readdirSync as qa}from"node:fs";import{basename as zt,isAbsolute as tp,join as Kt}from"node:path";import{createSession as Na,classifyClaudeAuth as Ba,CLAUDE_CODE_SETUP_HINT as np,loginPkce as op,toStoredTokens as rp,saveTokens as sp,getAccessToken as ip,resolveActiveProfile as ce,resolveProjectId as ap,getArticle as lp,decodeJwtClaims as Ct,isExpired as De,loadTokens as Me,clearTokens as cp,clearProfileProject as up,setTitle as dp,slugify as pp,touchSession as Ur,upsertSession as fp,generateTitle as _a,findByName as mp,listSessions as hp,renameSession as gp,suggestNextAction as wp,readProjectConfig as Q,writeProjectConfig as yp,resolveModelSetting as Hr,loadProfileMap as Lr,applyPull as kp,computeSyncStatus as Mr,planPull as bp,inventoryRepo as xp,knownEnvironments as $p,resolveEnvironment as vp,planPartitions as Wr,partitionEvenly as Cp,screenshotPlaceholderIds as Pp,trackedArticlePaths as Tp,runPartitioned as Jn,estimateBulkCost as Oa,resolveModelForOperation as Qn,readDocsPlan as Sp,checkForUpdate as Rp,detectInstallKind as Dp,isSelfUpdatable as jp,devHintsGuidePath as Ua,toolFeedbackPath as Ap,DEFAULT_DOCS_DIR as Ga,setProfileProject as Ep}from"document360-engine";Ke();import{spawn as ha}from"node:child_process";function Wd(){return process.platform==="win32"?[["clip",[]]]:process.platform==="darwin"?[["pbcopy",[]]]:[["wl-copy",[]],["xclip",["-selection","clipboard"]],["xsel",["--clipboard","--input"]]]}function Fd(e,t,n){return new Promise(o=>{try{let r=process.platform==="win32"?ha([e,...t].join(" "),{stdio:["pipe","ignore","ignore"],shell:!0}):ha(e,t,{stdio:["pipe","ignore","ignore"]});r.on("error",()=>o(!1)),r.on("close",c=>o(c===0)),r.stdin?.on("error",()=>o(!1));let s=process.platform==="win32"?Buffer.from("\uFEFF"+n,"utf16le"):Buffer.from(n,"utf8");r.stdin?.end(s)}catch{o(!1)}})}async function ga(e){for(let[t,n]of Wd())if(await Fd(t,n,e))return!0;return!1}var Hd=/\breply with (the |a )?number\b|\bpick one\b|\bpress the number\b/i;function jr(e,t
|
|
235
|
-
`),
|
|
252
|
+
`),console.log(f(` (${e.inputTokens}\u2192${e.outputTokens} tokens`+(e.costUsd>0?`, $${e.costUsd<.01?e.costUsd.toFixed(4):e.costUsd.toFixed(2)}`:"")+")")),console.log(""),t.uuid&&(pa(t.uuid),t.titleFired||Ld(t,n));break;case"error":console.error(""),console.error($(`agent error: ${e.message}`)),o.kind==="subscription"&&e.kind==="auth"&&Od();break}}import{render as qp}from"ink";import{resolveAuth as Bp}from"document360-engine";import{useCallback as Y,useEffect as ve,useMemo as _r,useRef as X,useState as F}from"react";import{Box as Z,Text as T,useApp as Qd,useInput as Zd,useStdout as ep}from"ink";import{existsSync as Yt,readFileSync as Or,readdirSync as qa}from"node:fs";import{basename as zt,isAbsolute as tp,join as Kt}from"node:path";import{createSession as Na,classifyClaudeAuth as Ba,CLAUDE_CODE_SETUP_HINT as np,loginPkce as op,toStoredTokens as rp,saveTokens as sp,getAccessToken as ip,resolveActiveProfile as ce,resolveProjectId as ap,getArticle as lp,decodeJwtClaims as Ct,isExpired as De,loadTokens as Me,clearTokens as cp,clearProfileProject as up,setTitle as dp,slugify as pp,touchSession as Ur,upsertSession as fp,generateTitle as _a,findByName as mp,listSessions as hp,renameSession as gp,suggestNextAction as wp,readProjectConfig as Q,writeProjectConfig as yp,resolveModelSetting as Hr,loadProfileMap as Lr,applyPull as kp,computeSyncStatus as Mr,planPull as bp,inventoryRepo as xp,knownEnvironments as $p,resolveEnvironment as vp,planPartitions as Wr,partitionEvenly as Cp,screenshotPlaceholderIds as Pp,trackedArticlePaths as Tp,runPartitioned as Jn,estimateBulkCost as Oa,resolveModelForOperation as Qn,readDocsPlan as Sp,checkForUpdate as Rp,detectInstallKind as Dp,isSelfUpdatable as jp,devHintsGuidePath as Ua,toolFeedbackPath as Ap,DEFAULT_DOCS_DIR as Ga,setProfileProject as Ep}from"document360-engine";Ke();import{spawn as ha}from"node:child_process";function Wd(){return process.platform==="win32"?[["clip",[]]]:process.platform==="darwin"?[["pbcopy",[]]]:[["wl-copy",[]],["xclip",["-selection","clipboard"]],["xsel",["--clipboard","--input"]]]}function Fd(e,t,n){return new Promise(o=>{try{let r=process.platform==="win32"?ha([e,...t].join(" "),{stdio:["pipe","ignore","ignore"],shell:!0}):ha(e,t,{stdio:["pipe","ignore","ignore"]});r.on("error",()=>o(!1)),r.on("close",c=>o(c===0)),r.stdin?.on("error",()=>o(!1));let s=process.platform==="win32"?Buffer.from("\uFEFF"+n,"utf16le"):Buffer.from(n,"utf8");r.stdin?.end(s)}catch{o(!1)}})}async function ga(e){for(let[t,n]of Wd())if(await Fd(t,n,e))return!0;return!1}var Hd=/\breply with (the |a )?number\b|\bpick one\b|\bpress the number\b/i;function jr(e,t){if(t.closed)return e;let n=e.split(`
|
|
253
|
+
`),o=!1;for(let r=0;r<n.length&&!t.closed;r++){let s=n[r];if(!t.cueSeen){Hd.test(s)&&(t.cueSeen=!0);continue}let c=/^(\s{0,3})[-*•]\s+(.*)$/.exec(s);c?(n[r]=`${c[1]}${++t.num}. ${c[2]}`,o=!0):o&&s.trim()!==""&&/^\S/.test(s)&&(t.closed=!0)}return n.join(`
|
|
236
254
|
`)}import{existsSync as qd,mkdirSync as Bd,readFileSync as Gd,writeFileSync as Vd}from"node:fs";import{join as wa}from"node:path";import{writerDir as Yd}from"document360-engine";function ya(e){return wa(Yd(e),".sessions")}function ka(e,t){return wa(ya(e),`${t}.json`)}function ba(e,t,n){try{Bd(ya(e),{recursive:!0});let o=n.filter(r=>r.kind!=="banner");Vd(ka(e,t),JSON.stringify({v:1,items:o}),"utf8")}catch{}}function Ar(e,t){try{let n=ka(e,t);if(!qd(n))return[];let o=JSON.parse(Gd(n,"utf8"));return Array.isArray(o.items)?o.items:[]}catch{return[]}}var zd=e=>`\x1B]0;${e}\x07`,Kd=e=>`\x1B]9;4;${e};${e===1?100:0}\x07`;function xa(e){process.stdout.isTTY&&process.stdout.write(e)}function Gt(e){xa(zd(e))}function Vn(e){xa(Kd(e))}var Yn=["\xB7 "," \xB7"],Er="\u{1F7E3}";On();var Xd=/^(?:\d+[.)]|[-*•])\s+/;function $a(e,t,n=4){let o=new Set(t.map(s=>s.toLowerCase())),r=[];for(let s of e.split(`
|
|
237
255
|
`)){let c=s.trim().replace(Xd,""),p=c.match(/^`([^`]+)`$/);p&&(c=p[1].trim());let h=c.match(/^\/([a-z?][a-z0-9-]*)(?:\s+(\S.*?))?\s*$/i);if(!h||!o.has(h[1].toLowerCase()))continue;let b=`/${h[1].toLowerCase()}${h[2]?` ${h[2]}`:""}`;if(r.includes(b)||r.push(b),r.length>=n)break}return r}W();function Vt(e){return e.map(t=>({label:t.label,items:t.paths.length,status:"pending"}))}function Re(e,t,n){return e.map(o=>o.label===t?{...o,status:n}:o)}function Ir(e){return e.replace(/^[\w.-]+\//,"")}var zn=16,va={pending:"\u25CB",active:"\u25A0",done:"\u2714",failed:"\u2717"};function Nr(e){return e.trim().split(/\s+/).slice(1).join(" ")}function Ca(e,t){let n=Nr(t);return e.some(r=>r.trim()===t.trim()||!!n&&Nr(r)===n)?e.filter(r=>r.trim()!==t.trim()&&!(n&&Nr(r)===n)):[]}var Jd=/\[Pasted text #\d+ \+\d+ lines?\]/g;function Pa(e){return e.replace(/\r\n?/g,`
|
|
238
256
|
`)}function Ta(e){return e.includes(`
|
|
@@ -248,12 +266,12 @@ Articles:
|
|
|
248
266
|
Run /doctor anytime to re-check and see the fix. (You can configure Document360 meanwhile \u2014 the agent just needs Claude before it writes.)`}),!Q(e)){u({kind:"note",tone:"info",text:`Welcome! This repo isn't set up for d360-writer yet \u2014 three steps and you're writing docs:
|
|
249
267
|
${La}`}),B(l?["/doctor","/init"]:["/init"]);return}l&&B(["/doctor"]);try{let i=ce(e,s),a=Me(i.name);a&&De(a)&&a.refreshToken?ip({profile:i.name,connection:i.connection}).then(()=>{u({kind:"note",tone:"ok",text:"\u2713 Document360 session refreshed."}),re(g=>g+1)}).catch(()=>{u({kind:"note",tone:"warn",text:"Document360 session refresh failed \u2014 do you want to log in now? (press 1)"}),B(["/login"])}):(!a||De(a))&&(u({kind:"note",tone:"warn",text:`Profile "${i.name}" is not signed in \u2014 do you want to log in now? (press 1)`}),B(["/login"]))}catch{}try{let i=Q(e),a=ce(e,s),g=Me(a.name);i&&g&&!De(g)&&Ha(e,i.authoritativeSourceFiles)&&(u({kind:"note",tone:"info",text:"Large repo \u2014 the docs scope isn\u2019t set yet. Run /scope to choose which folders back your docs."}),B(["/scope"]))}catch{}try{vn(e);let i=Cn(e);i.length&&(u({kind:"note",tone:"warn",text:i.join(`
|
|
250
268
|
`)}),ft(ze()),Dt.current=!1)}catch{}try{let i=Q(e),a=ce(e,s),g=Me(a.name),d=!!g&&(!De(g)||!!g.refreshToken),m=!i||!Ha(e,i.authoritativeSourceFiles);if(i&&d&&m&&!l){let y=Lr(e,a.name),v=y?Object.keys(y.articles).length:0,D=vt($t(e));if(v>0){let j=D?["/catch-up","/audit"]:["/audit","/sync"],oe={"/catch-up":"write up everything your builder flagged","/audit":D?"also scan the code for other changes":"check the code for anything new or missing in the docs","/sync":"check Document360 for changes made there"},K=D?`\u{1F4CB} Your builder left ${D} for the docs:`:`\u{1F4DA} ${v} article${v===1?"":"s"} tracked for "${a.name}". What next?`;u({kind:"note",tone:"info",text:[K,...j.map((_,x)=>` ${x+1} ${_.padEnd(9)} ${oe[_]}`),"Or just tell me what to write or update."].join(`
|
|
251
|
-
`)}),B(j)}else u({kind:"note",tone:"info",text:'\u{1F4ED} No docs yet for this repo. Tell me "write the docs for this repo" and I\u2019ll read the code and draft a structure \u2014 or /audit to see what the docs should cover.'}),se("write the docs for this repo"),B(D?["/catch-up","/audit"]:["/audit"])}}catch{}lo()},[]),ve(()=>{let l=setInterval(()=>{lo()},Hp);return()=>clearInterval(l)},[lo]),ve(()=>{let l=null,i=null,a=()=>{l&&clearTimeout(l),l=setTimeout(()=>{l=null;let g=`${be.columns??80}x${be.rows??24}`;g!==Zr.current&&(Zr.current=g,el(d=>d+1),i&&clearTimeout(i),i=setTimeout(()=>{i=null,console.log("\x1B[?2026h\x1B[H\x1B[2J"+ni(nt.current,Ie())+"\x1B[?2026l")},80))},400)};return be.on("resize",a),()=>{l&&clearTimeout(l),i&&clearTimeout(i),be.off("resize",a)}},[be,Ie]);let Ye=Math.max(20,(be.columns??80)-1),es=_r(()=>_p(e,s),[e,s,Ce]),fo=(()=>{let l=Q(e);if(!l)return{text:"Press 1 to set up this repo, or /help\u2026",isSetup:!0};let i=Kt(e,(l.docsDir??Ga).replace(/\/+$/,"")),a=(()=>{try{return Yt(i)&&qa(i).length>0}catch{return!1}})();try{let g=ce(e,s),d=Me(g.name);if(!(!!d&&!(De(d)&&!d.refreshToken)))return{text:`Press 1 to sign in to Document360 (profile "${g.name}")\u2026`,isSetup:!0};if(!g.project.projectId)return{text:"Sign in to Document360 to pick your project\u2026",isSetup:!0};if(!g.project.workspaceId&&!a)return{text:"Press 1 to pick a workspace\u2026",isSetup:!0}}catch{}return a?{text:Op,isSetup:!1}:so?{text:"Press c to copy the prompt above, run it in your coding agent \u2014 then ask me to write the docs",isSetup:!1}:{text:"Ask me to write the docs for this repo",isSetup:!1}})(),jt=Ts(R),ts=jt.length>0&&!N,mo=p!==null?Ea(p,8,Ye):null,on=ge?ge.paths.filter(l=>!ge.query||l.toLowerCase().includes(ge.query.toLowerCase())).slice(0,8):[],rn=ye?ye.sessions.filter(l=>{let i=ye.query.toLowerCase();return!i||l.name.toLowerCase().includes(i)||l.firstPrompt.toLowerCase().includes(i)}).slice(0,8):[],de=Y((l,i)=>{me.current?.close(),me.current=Na({cwd:e,resume:l,profileName:i??s,allowProdWrites:ot.current}),l||(Pe.current={uuid:null,firstPrompt:null,titleFired:!1},rt(null)),dt(0),pt(0)},[e,s]),ns=Y((l,i,a)=>{if(Up.test(l))try{let g=ce(e,s),d=typeof i.project_id=="string"&&i.project_id||g.project.projectId,m=Bn(i,a),y=[],v=Gn(a);l.endsWith("publish_article")&&v&&y.push(`Live: ${v}`),m&&d&&y.push(`Preview: ${qn(g.connection.portalUrl,d,m,g.project.languageCode??"en")}`),y.length>0&&u({kind:"link",lines:y})}catch{}},[e,s,u]),pe=Y(async(l,i)=>{Xt(!0),se(null),B([]),Zt(null),io(null),po(null);let a=++Qe.current;i?.quietUser||u({kind:"user",text:i?.echoDisplay&&i.display?i.display:l});let g=Pe.current;g.firstPrompt||(g.firstPrompt=i?.display??l),We.current=Date.now(),Ze(0),O(!0),Qt.current.clear();let d="",m=!1,y=!1,v="",D={num:0,closed:!1},j=null,oe=()=>{j||(j=setTimeout(()=>{j=null,h(v.length>0?v:null)},60))},K=()=>{j&&clearTimeout(j),j=null,h(null)},_=()=>{if(v.trim()){let x=jr(v.trimEnd(),
|
|
269
|
+
`)}),B(j)}else u({kind:"note",tone:"info",text:'\u{1F4ED} No docs yet for this repo. Tell me "write the docs for this repo" and I\u2019ll read the code and draft a structure \u2014 or /audit to see what the docs should cover.'}),se("write the docs for this repo"),B(D?["/catch-up","/audit"]:["/audit"])}}catch{}lo()},[]),ve(()=>{let l=setInterval(()=>{lo()},Hp);return()=>clearInterval(l)},[lo]),ve(()=>{let l=null,i=null,a=()=>{l&&clearTimeout(l),l=setTimeout(()=>{l=null;let g=`${be.columns??80}x${be.rows??24}`;g!==Zr.current&&(Zr.current=g,el(d=>d+1),i&&clearTimeout(i),i=setTimeout(()=>{i=null,console.log("\x1B[?2026h\x1B[H\x1B[2J"+ni(nt.current,Ie())+"\x1B[?2026l")},80))},400)};return be.on("resize",a),()=>{l&&clearTimeout(l),i&&clearTimeout(i),be.off("resize",a)}},[be,Ie]);let Ye=Math.max(20,(be.columns??80)-1),es=_r(()=>_p(e,s),[e,s,Ce]),fo=(()=>{let l=Q(e);if(!l)return{text:"Press 1 to set up this repo, or /help\u2026",isSetup:!0};let i=Kt(e,(l.docsDir??Ga).replace(/\/+$/,"")),a=(()=>{try{return Yt(i)&&qa(i).length>0}catch{return!1}})();try{let g=ce(e,s),d=Me(g.name);if(!(!!d&&!(De(d)&&!d.refreshToken)))return{text:`Press 1 to sign in to Document360 (profile "${g.name}")\u2026`,isSetup:!0};if(!g.project.projectId)return{text:"Sign in to Document360 to pick your project\u2026",isSetup:!0};if(!g.project.workspaceId&&!a)return{text:"Press 1 to pick a workspace\u2026",isSetup:!0}}catch{}return a?{text:Op,isSetup:!1}:so?{text:"Press c to copy the prompt above, run it in your coding agent \u2014 then ask me to write the docs",isSetup:!1}:{text:"Ask me to write the docs for this repo",isSetup:!1}})(),jt=Ts(R),ts=jt.length>0&&!N,mo=p!==null?Ea(p,8,Ye):null,on=ge?ge.paths.filter(l=>!ge.query||l.toLowerCase().includes(ge.query.toLowerCase())).slice(0,8):[],rn=ye?ye.sessions.filter(l=>{let i=ye.query.toLowerCase();return!i||l.name.toLowerCase().includes(i)||l.firstPrompt.toLowerCase().includes(i)}).slice(0,8):[],de=Y((l,i)=>{me.current?.close(),me.current=Na({cwd:e,resume:l,profileName:i??s,allowProdWrites:ot.current}),l||(Pe.current={uuid:null,firstPrompt:null,titleFired:!1},rt(null)),dt(0),pt(0)},[e,s]),ns=Y((l,i,a)=>{if(Up.test(l))try{let g=ce(e,s),d=typeof i.project_id=="string"&&i.project_id||g.project.projectId,m=Bn(i,a),y=[],v=Gn(a);l.endsWith("publish_article")&&v&&y.push(`Live: ${v}`),m&&d&&y.push(`Preview: ${qn(g.connection.portalUrl,d,m,g.project.languageCode??"en")}`),y.length>0&&u({kind:"link",lines:y})}catch{}},[e,s,u]),pe=Y(async(l,i)=>{Xt(!0),se(null),B([]),Zt(null),io(null),po(null);let a=++Qe.current;i?.quietUser||u({kind:"user",text:i?.echoDisplay&&i.display?i.display:l});let g=Pe.current;g.firstPrompt||(g.firstPrompt=i?.display??l),We.current=Date.now(),Ze(0),O(!0),Qt.current.clear();let d="",m=!1,y=!1,v="",D={num:0,closed:!1,cueSeen:!1},j=null,oe=()=>{j||(j=setTimeout(()=>{j=null,h(v.length>0?v:null)},60))},K=()=>{j&&clearTimeout(j),j=null,h(null)},_=()=>{if(v.trim()){let x=jr(v.trimEnd(),D);u({kind:"assistant",text:x})}v="",K()};try{for await(let x of me.current.send(l))if(x.type==="session"){if(!g.uuid){g.uuid=x.sessionId;let A=new Date().toISOString(),M=pp(g.firstPrompt??"session");fp({uuid:x.sessionId,name:M,renamed:!1,titled:!1,cwd:e,firstPrompt:g.firstPrompt??"",createdAt:A,updatedAt:A}),rt(M)}}else if(x.type==="text"){v+=x.delta,d+=x.delta;let A=Ia(v);if(A>0){let M=v.slice(0,A).trimEnd();M&&u({kind:"assistant",text:jr(M,D)}),v=v.slice(A)}oe(),Ze(M=>M+x.delta.length)}else if(x.type==="tool"){m=!0;let A=Fn(x.name,x.input);A&&(_(),u({kind:"tool",title:A.title,sep:A.sep,arg:A.arg}),Qt.current.set(x.id,{name:x.name,input:x.input}))}else if(x.type==="article_diff"){let A=Xe(x.oldContent,x.newContent,Ie());A&&(_(),u({kind:"diff",added:A.added,removed:A.removed,lines:A.lines,hidden:A.hidden}))}else if(x.type==="tool_result"){x.isError&&/run \/login|not logged in|session expired|rejected the token/i.test(x.output)&&(en.current=!0);let A=Qt.current.get(x.id);if(A){Qt.current.delete(x.id),_();let M=Hn(x.output,4,x.isError?void 0:A.name,A.input);u({kind:"tool-result",lines:M.lines,hidden:M.hidden,isError:x.isError}),x.isError||ns(A.name,A.input,x.output)}}else if(x.type==="result"){if(_(),dt(M=>M+x.outputTokens),pt(M=>M+x.costUsd),u({kind:"done",seconds:Math.round((Date.now()-We.current)/1e3),tokens:x.outputTokens,costUsd:x.costUsd,ok:x.ok}),!y&&!m&&!d.trim()&&!St.current&&u({kind:"note",tone:"warn",text:"The agent produced no output. This usually means the Claude model/runtime did not start \u2014 check sign-in and model with /doctor (on a subscription, make sure Claude Code is logged in on this machine)."}),x.ok&&/🛠|📣 Feedback for the d360-writer developers/.test(d))try{let M=Ap(e);if(Yt(M)){let L=Or(M,"utf8").trim();L&&(po(L),u({kind:"note",tone:"info",text:"\u{1F6E0} Press c to copy this feedback \u2014 send it to the d360-writer team (Teams / Slack / email)."}))}}catch{}let A=x.ok?$a(d,_t.map(M=>M.name)):[];if(A.length>0?B(A):x.ok&&d.trim()&&wp(l,d,e).then(M=>{M&&Qe.current===a&&se(M)}).catch(()=>{}),g.uuid&&(Ur(g.uuid),!g.titleFired)){g.titleFired=!0;let M=g.uuid,L=g.firstPrompt;L&&_a(L,e).then(G=>{G&&(dp(M,G),rt(G))}).catch(()=>{})}}else x.type==="error"&&(_(),y=!0,x.kind==="auth"&&(en.current=!0),u({kind:"note",text:`agent error: ${x.message}`,tone:"error"}))}finally{O(!1),K(),re(x=>x+1),Pe.current.uuid&&ba(e,Pe.current.uuid,nt.current),en.current&&(en.current=!1,tn.current=i?.display??l,B(["/login"])),St.current&&(St.current=!1,Ge.current.length>0&&(u({kind:"note",tone:"info",text:`(${Ge.current.length} queued message(s) discarded)`}),Ge.current=[],oo([])),u({kind:"note",tone:"warn",text:"Interrupted. What do you want to do next?"}))}},[e,u,ns,Ie]),sn=Y(async l=>{let i=Wr(l),a=Qn(e,"standard");We.current=Date.now(),Ze(0),O(!0);let g=new AbortController;we.current=g,J({verb:"Publishing",total:i.length,done:0,active:[],rows:Vt(i),tools:0,chars:0,lastAt:Date.now(),startedAt:Date.now()}),u({kind:"note",tone:"info",text:`Publishing ${l.length} article${l.length===1?"":"s"} across ${i.length} partition${i.length===1?"":"s"} (\u2264${Wt} agents at once) on ${a.model}\u2026 (esc to stop)`});try{for await(let d of Jn({cwd:e,partitions:i,promptFor:m=>Dn(m.paths),concurrency:Wt,profileName:s,allowProdWrites:ot.current,model:a.model,signal:g.signal}))if(d.type==="partition_status")d.status==="running"?J(m=>m&&{...m,active:[...m.active,d.label],rows:Re(m.rows,d.label,"active"),lastAt:Date.now()}):J(m=>m&&{...m,active:m.active.filter(y=>y!==d.label),done:m.done+1,rows:Re(m.rows,d.label,d.status==="done"?"done":"failed"),lastAt:Date.now()});else if(d.type==="partition_event")J(m=>{if(!m)return m;let y={...m,lastAt:Date.now()};return d.event.type==="tool"?y.tools=m.tools+1:d.event.type==="text"&&(y.chars=m.chars+d.event.delta.length),y});else if(d.type==="run_done"){pt(v=>v+d.totalCostUsd),dt(v=>v+d.results.reduce((D,j)=>D+j.outputTokens,0));let m=d.aborted?"Stopped. ":"",y=t.kind==="api"?"api":"subscription";u({kind:"note",tone:d.aborted?"warn":d.ok?"ok":"warn",text:m+Wo(d.results,i,y).join(`
|
|
252
270
|
`)})}}catch(d){u({kind:"note",tone:"error",text:`Publish run failed: ${d.message}`})}finally{we.current=null,J(null),O(!1),re(d=>d+1)}},[e,s,u,t]),ho=Y(async l=>{await pe(Mo(l),{display:`/publish ${l}`,quietUser:!0});try{let i=await jn(e,s,l.replace(/\\/g,"/"));i.length>0&&(Zt(`Related articles not yet published (${i.length}):`),B([`/publish --related ${l}`,...i.map(a=>`/publish ${a}`)]))}catch{}},[e,s,pe]),go=Y(l=>{let i=Me(l);if(!i||De(i)&&!i.refreshToken)return null;let a={...Ct(i.idToken)??{},...Ct(i.accessToken)??{}};return a.email??a.preferred_username??"signed in"},[]),wo=Y((l,i)=>{if(i){let a=Q(e);a&&(a.defaultProfile=l,yp(a,e))}c(l),de(void 0,l),u({kind:"note",tone:"ok",text:`\u2713 Switched to profile "${l}"${i?" (saved as default)":" (this session only)"} \u2014 agent restarted.`}),go(l)||(u({kind:"note",tone:"warn",text:`Profile "${l}" is not signed in \u2014 do you want to log in now? (press 1)`}),B(["/login"])),re(a=>a+1)},[e,u,de,go]),an=Y((l,i,a)=>{pn(e,l,i,a.id,a.name),u({kind:"note",tone:"ok",text:`Switched to workspace "${a.name??a.id}" (agent restarted).`}),de(),Lr(e,l)||(u({kind:"note",tone:"ok",text:"\u2713 Connected. Configuration is done \u2014 one important step remains."}),u({kind:"note",tone:"warn",text:"\u26A0 Before I write the docs, hand the prompt below to your builder (your repo's coding agent). It gives me the architecture brief that makes the docs accurate:"}),u({kind:"note",tone:"info",text:kt(yt(e)).join(`
|
|
253
271
|
`)}),ft(ze()),Dt.current=_e(e).status==="current",u({kind:"note",tone:"info",text:`No separate builder agent? Then just ask me now: "write the docs for this repo" \u2014 I'll read the code directly.`}))},[e,u,de,ft]),ln=Y(async l=>{let i;try{i=await It(e,l)}catch{u({kind:"note",tone:"info",text:"Next: pick a workspace \u2014 run /workspace."}),B(["/workspace"]);return}if(i.workspaces.length===0){u({kind:"note",tone:"warn",text:"This project has no workspaces yet. Create one in Document360, then run /workspace."});return}let a=i.workspaces.filter(d=>(d.workspace_type??"").toLowerCase()!=="apidocumentation"),g=a.length>0?a:i.workspaces;if(g.length===1){let d=g[0],m=i.workspaces.length-g.length;u({kind:"note",tone:"ok",text:`Selected the "${d.name??d.id}" workspace${m>0?" (skipped the API-documentation workspace)":""}.`}),an(i.profile,i.projectId,d);return}u({kind:"note",tone:"info",text:`Next: pick the workspace your articles publish to (${g.length} available).`}),B(["/workspace"])},[e,u,an]),os=Y((l,i)=>{$o(e,l,i.id,i.name),u({kind:"note",tone:"ok",text:`Project set to "${i.name??i.id}" (agent restarted).`}),de(),ln(l)},[e,u,de,ln]),rs=Y(async l=>{let i;try{i=ce(e,l)}catch{return}if(!i.project.workspaceId){if(i.project.projectId){if(!i.project.projectName)try{let{projects:a}=await gt(e,i.name),g=a.find(d=>d.id===i.project.projectId);g?.name&&Ep(e,i.name,{projectName:g.name})}catch{}await ln(i.name);return}u({kind:"note",tone:"info",text:"Next: pick the Document360 project."}),B(["/project"])}},[e,u,ln]),cn=Y(()=>{let l=Ae.current[0];if(!l)return;u({kind:"note",tone:"info",text:`\u25CF ${l.title} (${l.path})`});for(let a of l.notes)u({kind:"note",tone:"warn",text:`\u26A0 ${a}`});l.overwritesLocalChanges&&u({kind:"note",tone:"warn",text:"\u26A0 This OVERWRITES local edits made since the last sync."});let i=Xe(l.oldContent,l.newContent,Ie());u(i?{kind:"diff",added:i.added,removed:i.removed,lines:i.lines,hidden:i.hidden}:{kind:"note",tone:"info",text:"Local file already matches the remote content \u2014 applying only advances the sync base."}),u({kind:"note",tone:"info",text:`Write ${l.path}? (y/n \u2014 anything else cancels)`})},[u,Ie]),ss=Y(l=>{if(Ae.current.length===0)return!1;let i=l.trim().toLowerCase();if(i==="y"||i==="yes"){let a=Ae.current.shift();try{kp({cwd:e,profileName:s},a),u({kind:"note",tone:"ok",text:`\u2713 Pulled ${a.path} (sync base advanced).`}),Ae.current.length===0&&B(g=>g.length>0?g:["/sync"])}catch(g){u({kind:"note",tone:"error",text:`Pull failed: ${g.message}`})}}else if(i==="n"||i==="no"){let a=Ae.current.shift();u({kind:"note",tone:"info",text:`Skipped ${a.path}.`})}else{let a=Ae.current.length;return Ae.current=[],u({kind:"note",tone:"info",text:`Pull cancelled (${a} article(s) left untouched).`}),!0}return cn(),!0},[e,s,cn,u]),is=Y(l=>{let i=no.current;if(!i)return!1;if(no.current=null,se(null),Qe.current++,l.trim()!==i.repoName)return u({kind:"note",tone:"warn",text:"Reset cancelled \u2014 nothing deleted."}),!0;let{removed:a,failed:g}=Pr(e,i.targets);u({kind:"note",tone:g.length?"warn":"ok",text:`\u2713 Reset complete \u2014 removed ${a.length} item${a.length===1?"":"s"}. The repo is back to its original state.`});for(let d of g)u({kind:"note",tone:"error",text:` \u2717 ${d.path}: ${d.error}`});return i.hadDevhints&&(u({kind:"note",tone:"warn",text:Pn().join(`
|
|
254
272
|
`)}),ft(Ro())),u({kind:"note",tone:"info",text:`Clean slate \u2014 set up d360-writer again whenever you're ready:
|
|
255
273
|
${La}`}),B(["/init"]),Xt(!1),!0},[e,u,ft]),as=Y(async l=>{let i=l.slice(1).trim().split(/\s+/),a=(i[0]??"").toLowerCase(),g=i.slice(1);switch(Xt(!0),a){case"help":u({kind:"note",tone:"info",text:kn().join(`
|
|
256
|
-
`)});return;case"exit":case"quit":me.current?.close(),r();return;case"clear":de(),nt.current=[],Xt(!1),se(null),Qe.current++,u({kind:"note",tone:"info",text:"Conversation reset (the previous session is still resumable via /resume)."});return;case"login":{let d;try{d=ce(e,s)}catch(m){u({kind:"note",tone:"error",text:m.message});return}u({kind:"note",tone:"info",text:`Profile "${d.name}" \u2192 ${d.connection.name} (${d.connection.apiUrl})${d.production?" \u26A0 PRODUCTION":""}`}),te(!0);try{let m=await op(d.connection,{promptForRedirect:()=>Promise.reject(new Error("Manual login is CLI-only. Run: d360-writer login --manual"))},v=>u({kind:"note",tone:"info",text:v})),y=rp(d.name,m);if(sp(y),await vo(y,d.name,v=>u({kind:"note",tone:"info",text:v})),u({kind:"note",tone:"ok",text:`\u2713 Logged in to "${d.name}" as ${mn(y)}`}),await rs(s),Rt.current){let v=Rt.current;Rt.current=null;let D=Se(e,s);D.ok?(u({kind:"note",tone:"ok",text:`\u2713 Signed into the right project \u2014 press 1 to run ${v}.`}),B([v])):(u({kind:"note",tone:"warn",text:`${D.reason} (then ${v}.)`}),B(["/login"]),Rt.current=v)}else tn.current&&(se(tn.current),tn.current=null,u({kind:"note",tone:"info",text:"Press tab to re-send your last prompt."}))}catch(m){u({kind:"note",tone:"error",text:`Login failed: ${m.message}`})}finally{te(!1),re(m=>m+1)}return}case"allow-prod":{let d=!1;try{d=ce(e,s).production}catch{}if(!d){u({kind:"note",tone:"info",text:"Current profile is not production \u2014 writes are already allowed."});return}ot.current=!0,de(),u({kind:"note",tone:"warn",text:"\u26A0 Production writes authorized for this session."});return}case"rename":{let d=ur(g.join(" ")),m=Pe.current.uuid;if(!m){u({kind:"note",tone:"error",text:"Send a message first \u2014 sessions save once the agent replies."});return}if(!d){u({kind:"note",tone:"info",text:"Thinking of a name\u2026"});let y=Pe.current.firstPrompt??"";_a(y,e).then(v=>{v?(se(`/rename ${v}`),u({kind:"note",tone:"info",text:`Suggestion: "${v}" \u2014 press tab to accept, or type /rename <your name>.`})):u({kind:"note",tone:"info",text:"Usage: /rename <name>"})}).catch(()=>u({kind:"note",tone:"info",text:"Usage: /rename <name>"}));return}gp(m,d),rt(d),Gt(`${Er} d360-writer \xB7 ${d}`),u({kind:"note",tone:"ok",text:`Session renamed to "${d}".`});return}case"profile":{let d=g[0],m=Q(e);if(!d){let y=Object.entries(m?.profiles??{});if(y.length===0){u({kind:"note",tone:"info",text:"No profiles. Run /init first."});return}let v=y.map(([oe,K])=>({name:oe,env:K.connection?.environment??"custom",prod:K.production===!0,who:go(oe)})),D=s??m?.defaultProfile,j=Math.max(0,v.findIndex(oe=>oe.name===D));st({cursor:j,current:j,rows:v});return}if(d==="add"){let y=dr(e,g[1],g[2]);if(y){u({kind:"note",tone:"error",text:y});return}u({kind:"note",tone:"ok",text:`\u2713 Profile "${g[1]}" created (environment: ${g[2]??g[1]}).`}),wo(g[1],!1);return}if(!m?.profiles?.[d]){u({kind:"note",tone:"error",text:`Unknown profile "${d}". Create it: /profile add ${d} <environment>`});return}wo(d,!0);return}case"doctor":await qt(g,{cwd:e});return;case"mcp":await Sn(g);return;case"init":{if(Q(e)){u({kind:"note",tone:"info",text:"This repo is already set up \u2014 edit .d360-writer.json directly (or d360-writer init for the CLI wizard)."});return}let d=$p().map(m=>({name:m,apiUrl:vp(m).apiUrl}));it({cursor:0,rows:d});return}case"resume":{let d=g.join(" ").trim(),m=hp(e).filter(D=>D.uuid!==Pe.current.uuid);if(!d){if(!m.length){u({kind:"note",tone:"info",text:"No saved sessions for this repo yet."});return}Ve({query:"",cursor:0,sessions:m});return}let y=mp(e,d);if(!y){u({kind:"note",tone:"error",text:`No session matches "${d}".`});return}de(y.uuid),Pe.current={uuid:y.uuid,firstPrompt:y.firstPrompt,titleFired:!0},rt(y.name),Ur(y.uuid),nt.current=[];let v=Ar(e,y.uuid);for(let D of v)u(D);u({kind:"note",tone:"ok",text:v.length?`Resumed "${y.name}" \u2014 restored ${v.length} message(s); continue where you left off.`:`Resumed "${y.name}" (agent memory reconnected; no saved transcript to replay).`});return}case"workspace":{let d=g.join(" ").trim(),m;try{m=await It(e,s)}catch(v){u({kind:"note",tone:"error",text:`Could not list workspaces: ${v.message}`});return}if(!d){let v=m.workspaces.map(j=>({id:j.id,name:j.name??j.id,type:j.workspace_type}));if(v.length===0){u({kind:"note",tone:"info",text:"No workspaces in this project."});return}let D=Math.max(0,v.findIndex(j=>j.id===m.current));at({cursor:D,current:D,rows:v,profile:m.profile,projectId:m.projectId,projectName:m.projectName,environment:m.environment});return}let y=xo(m.workspaces,d);if(!y){u({kind:"note",tone:"error",text:`No workspace matches "${d}".`});return}an(m.profile,m.projectId,y);return}case"project":{let d=g.join(" ").trim(),m;try{m=await gt(e,s)}catch(v){u({kind:"note",tone:"error",text:`Could not list projects: ${v.message} (signed in? try /login)`});return}if(!d){let v=m.projects.map(j=>({id:j.id,name:j.name??j.id,sub:j.sub_domain}));if(v.length===0){u({kind:"note",tone:"info",text:"No projects found for this identity."});return}let D=v.findIndex(j=>j.id===m.current);lt({cursor:Math.max(0,D),current:D,rows:v,profile:m.profile,environment:m.environment});return}let y=hs(m.projects,d);if(!y){u({kind:"note",tone:"error",text:`No project matches "${d}". Available: ${m.projects.map(v=>v.name??v.id).join(", ")}`});return}os(m.profile,y);return}case"logout":{let d;try{d=ce(e,s).name}catch(y){u({kind:"note",tone:"error",text:y.message});return}let m=cp(d);up(e,d),de(),re(y=>y+1),u({kind:"note",tone:m?"ok":"info",text:m?`\u2713 Signed out of "${d}" and cleared its project/workspace selection.`:`Profile "${d}" was not signed in. Cleared any project/workspace selection.`}),u({kind:"note",tone:"info",text:"Run /login to sign in and pick a project."}),B(["/login"]);return}case"publish":{if(!co(l.trim()))return;if(g[0]==="--related"&&g[1]){let m=await jn(e,s,g[1].replace(/\\/g,"/"));if(m.length===0){u({kind:"note",tone:"ok",text:"\u2713 All related articles are already published."});return}await sn(m);return}if(g[0]&&g[0]!=="--all"){await ho(g[0]);return}let d=g[0]==="--all";u({kind:"note",tone:"info",text:"Checking what needs publishing\u2026"});try{let m=await Mr({cwd:e,profileName:s}),y=Ft(m.entries),v=Rn(m.entries);if(v>0&&u({kind:"note",tone:"warn",text:`\u26A0 ${v} article${v===1?"":"s"} already exist on Document360 but aren\u2019t linked \u2014 left OUT of publish (publishing would duplicate them). Run /catch-up (or ask me to
|
|
274
|
+
`)});return;case"exit":case"quit":me.current?.close(),r();return;case"clear":de(),nt.current=[],Xt(!1),se(null),Qe.current++,u({kind:"note",tone:"info",text:"Conversation reset (the previous session is still resumable via /resume)."});return;case"login":{let d;try{d=ce(e,s)}catch(m){u({kind:"note",tone:"error",text:m.message});return}u({kind:"note",tone:"info",text:`Profile "${d.name}" \u2192 ${d.connection.name} (${d.connection.apiUrl})${d.production?" \u26A0 PRODUCTION":""}`}),te(!0);try{let m=await op(d.connection,{promptForRedirect:()=>Promise.reject(new Error("Manual login is CLI-only. Run: d360-writer login --manual"))},v=>u({kind:"note",tone:"info",text:v})),y=rp(d.name,m);if(sp(y),await vo(y,d.name,v=>u({kind:"note",tone:"info",text:v})),u({kind:"note",tone:"ok",text:`\u2713 Logged in to "${d.name}" as ${mn(y)}`}),await rs(s),Rt.current){let v=Rt.current;Rt.current=null;let D=Se(e,s);D.ok?(u({kind:"note",tone:"ok",text:`\u2713 Signed into the right project \u2014 press 1 to run ${v}.`}),B([v])):(u({kind:"note",tone:"warn",text:`${D.reason} (then ${v}.)`}),B(["/login"]),Rt.current=v)}else tn.current&&(se(tn.current),tn.current=null,u({kind:"note",tone:"info",text:"Press tab to re-send your last prompt."}))}catch(m){u({kind:"note",tone:"error",text:`Login failed: ${m.message}`})}finally{te(!1),re(m=>m+1)}return}case"allow-prod":{let d=!1;try{d=ce(e,s).production}catch{}if(!d){u({kind:"note",tone:"info",text:"Current profile is not production \u2014 writes are already allowed."});return}ot.current=!0,de(),u({kind:"note",tone:"warn",text:"\u26A0 Production writes authorized for this session."});return}case"rename":{let d=ur(g.join(" ")),m=Pe.current.uuid;if(!m){u({kind:"note",tone:"error",text:"Send a message first \u2014 sessions save once the agent replies."});return}if(!d){u({kind:"note",tone:"info",text:"Thinking of a name\u2026"});let y=Pe.current.firstPrompt??"";_a(y,e).then(v=>{v?(se(`/rename ${v}`),u({kind:"note",tone:"info",text:`Suggestion: "${v}" \u2014 press tab to accept, or type /rename <your name>.`})):u({kind:"note",tone:"info",text:"Usage: /rename <name>"})}).catch(()=>u({kind:"note",tone:"info",text:"Usage: /rename <name>"}));return}gp(m,d),rt(d),Gt(`${Er} d360-writer \xB7 ${d}`),u({kind:"note",tone:"ok",text:`Session renamed to "${d}".`});return}case"profile":{let d=g[0],m=Q(e);if(!d){let y=Object.entries(m?.profiles??{});if(y.length===0){u({kind:"note",tone:"info",text:"No profiles. Run /init first."});return}let v=y.map(([oe,K])=>({name:oe,env:K.connection?.environment??"custom",prod:K.production===!0,who:go(oe)})),D=s??m?.defaultProfile,j=Math.max(0,v.findIndex(oe=>oe.name===D));st({cursor:j,current:j,rows:v});return}if(d==="add"){let y=dr(e,g[1],g[2]);if(y){u({kind:"note",tone:"error",text:y});return}u({kind:"note",tone:"ok",text:`\u2713 Profile "${g[1]}" created (environment: ${g[2]??g[1]}).`}),wo(g[1],!1);return}if(!m?.profiles?.[d]){u({kind:"note",tone:"error",text:`Unknown profile "${d}". Create it: /profile add ${d} <environment>`});return}wo(d,!0);return}case"doctor":await qt(g,{cwd:e});return;case"mcp":await Sn(g);return;case"init":{if(Q(e)){u({kind:"note",tone:"info",text:"This repo is already set up \u2014 edit .d360-writer.json directly (or d360-writer init for the CLI wizard)."});return}let d=$p().map(m=>({name:m,apiUrl:vp(m).apiUrl}));it({cursor:0,rows:d});return}case"resume":{let d=g.join(" ").trim(),m=hp(e).filter(D=>D.uuid!==Pe.current.uuid);if(!d){if(!m.length){u({kind:"note",tone:"info",text:"No saved sessions for this repo yet."});return}Ve({query:"",cursor:0,sessions:m});return}let y=mp(e,d);if(!y){u({kind:"note",tone:"error",text:`No session matches "${d}".`});return}de(y.uuid),Pe.current={uuid:y.uuid,firstPrompt:y.firstPrompt,titleFired:!0},rt(y.name),Ur(y.uuid),nt.current=[];let v=Ar(e,y.uuid);for(let D of v)u(D);u({kind:"note",tone:"ok",text:v.length?`Resumed "${y.name}" \u2014 restored ${v.length} message(s); continue where you left off.`:`Resumed "${y.name}" (agent memory reconnected; no saved transcript to replay).`});return}case"workspace":{let d=g.join(" ").trim(),m;try{m=await It(e,s)}catch(v){u({kind:"note",tone:"error",text:`Could not list workspaces: ${v.message}`});return}if(!d){let v=m.workspaces.map(j=>({id:j.id,name:j.name??j.id,type:j.workspace_type}));if(v.length===0){u({kind:"note",tone:"info",text:"No workspaces in this project."});return}let D=Math.max(0,v.findIndex(j=>j.id===m.current));at({cursor:D,current:D,rows:v,profile:m.profile,projectId:m.projectId,projectName:m.projectName,environment:m.environment});return}let y=xo(m.workspaces,d);if(!y){u({kind:"note",tone:"error",text:`No workspace matches "${d}".`});return}an(m.profile,m.projectId,y);return}case"project":{let d=g.join(" ").trim(),m;try{m=await gt(e,s)}catch(v){u({kind:"note",tone:"error",text:`Could not list projects: ${v.message} (signed in? try /login)`});return}if(!d){let v=m.projects.map(j=>({id:j.id,name:j.name??j.id,sub:j.sub_domain}));if(v.length===0){u({kind:"note",tone:"info",text:"No projects found for this identity."});return}let D=v.findIndex(j=>j.id===m.current);lt({cursor:Math.max(0,D),current:D,rows:v,profile:m.profile,environment:m.environment});return}let y=hs(m.projects,d);if(!y){u({kind:"note",tone:"error",text:`No project matches "${d}". Available: ${m.projects.map(v=>v.name??v.id).join(", ")}`});return}os(m.profile,y);return}case"logout":{let d;try{d=ce(e,s).name}catch(y){u({kind:"note",tone:"error",text:y.message});return}let m=cp(d);up(e,d),de(),re(y=>y+1),u({kind:"note",tone:m?"ok":"info",text:m?`\u2713 Signed out of "${d}" and cleared its project/workspace selection.`:`Profile "${d}" was not signed in. Cleared any project/workspace selection.`}),u({kind:"note",tone:"info",text:"Run /login to sign in and pick a project."}),B(["/login"]);return}case"publish":{if(!co(l.trim()))return;if(g[0]==="--related"&&g[1]){let m=await jn(e,s,g[1].replace(/\\/g,"/"));if(m.length===0){u({kind:"note",tone:"ok",text:"\u2713 All related articles are already published."});return}await sn(m);return}if(g[0]&&g[0]!=="--all"){await ho(g[0]);return}let d=g[0]==="--all";u({kind:"note",tone:"info",text:"Checking what needs publishing\u2026"});try{let m=await Mr({cwd:e,profileName:s}),y=Ft(m.entries),v=Rn(m.entries);if(v>0&&u({kind:"note",tone:"warn",text:`\u26A0 ${v} article${v===1?"":"s"} already exist on Document360 but aren\u2019t linked \u2014 left OUT of publish (publishing would duplicate them). Run /catch-up (or ask me to link them) first.`}),y.length===0){u({kind:"note",tone:"ok",text:v>0?"\u2713 Nothing else is ahead of Document360 to publish.":"\u2713 Nothing is ahead of Document360 \u2014 no publish candidates."});let D=m.counts["unknown-base"]??0;D>0&&u({kind:"note",tone:"info",text:`(${D} article(s) have no sync base yet \u2014 publish those by path if needed.)`});return}if(d){await sn(y.map(D=>D.path));return}ct({cursor:0,rows:si(y)})}catch(m){u({kind:"note",tone:"error",text:`Could not compute sync status: ${m.message}`}),u({kind:"note",tone:"info",text:"Publish a specific article: /publish <article-path>"})}return}case"preview":{let d=g.join(" ").trim();if(!d){let y=[];try{y=Object.keys(Lr(e,ce(e,s).name)?.articles??{})}catch{}if(y.length===0){u({kind:"note",tone:"info",text:"No tracked articles to pick from yet. Usage: /preview <path-to.md | article-id>"});return}Be({query:"",cursor:0,paths:y});return}let m=tp(d)?d:Kt(e,d);if(Yt(m)){try{u({kind:"preview",name:zt(m),text:Wa(Or(m,"utf8"))})}catch(y){u({kind:"note",tone:"error",text:`Could not read ${m}: ${y.message}`})}return}if(Lp.test(d)){try{let y=ce(e,s),v={profile:y.name,connection:y.connection},D=y.project.projectId??ap(v),j=await lp(v,D,d);u({kind:"preview",name:j.title??d,text:j.content??"*(article has no content)*"})}catch(y){u({kind:"note",tone:"error",text:`Could not fetch article: ${y.message}`})}return}u({kind:"note",tone:"error",text:`"${d}" is neither a file (relative to ${e}) nor an article id.`});return}case"model":{let d=g[0]?.trim();if(!d){let D=_n(Hr(e));He({cursor:D,current:D});return}let{lines:m,changed:y,effective:v}=Ht(e,d);for(let D of m)u({kind:"note",tone:D.startsWith("\u26A0")?"warn":D.startsWith("\u2713")?"ok":"info",text:D});y&&(Qr(D=>D+1),me.current?.setModel(v));return}case"convert":{if(!Q(e)){u({kind:"note",tone:"error",text:"No d360-writer config here. Run /init first."});return}let{scope:d,run:m}=Bo(g),y=Tp(e,s);if(y.length===0){u({kind:"note",tone:"error",text:"No tracked articles in d360-category-map.json. Publish some first (/publish), then /convert."});return}let v=Go(y,d);if(v.length===0){u({kind:"note",tone:"error",text:`No tracked articles under "${d}". (${y.length} are tracked overall.)`});return}let D=Wr(v),j=3,oe=`/convert${d?` --scope ${d}`:""} --run`,K=Qn(e,"light");if(!m){let x=Oa({files:Vo(e,v),op:"convert",model:K.model}),A=d?`Scope: ${d} (${v.length} of ${y.length} tracked)
|
|
257
275
|
`:"",M=`
|
|
258
276
|
Model: ${K.model}${K.forced?" (forced)":" \u2014 mechanical work; /model to override"}`;u({kind:"note",tone:"info",text:A+zo(D,x,j).join(`
|
|
259
277
|
`)+M}),B([oe]);return}We.current=Date.now(),Ze(0),O(!0);let _=new AbortController;we.current=_,J({verb:"Converting",total:D.length,done:0,active:[],rows:Vt(D),tools:0,chars:0,lastAt:Date.now(),startedAt:Date.now()}),u({kind:"note",tone:"info",text:`Converting ${v.length} articles across ${D.length} partitions (\u2264${j} agents at once) on ${K.model}\u2026 (esc to stop)`});try{for await(let x of Jn({cwd:e,partitions:D,promptFor:Yo,concurrency:j,profileName:s,allowProdWrites:ot.current,model:K.model,signal:_.signal}))if(x.type==="partition_status")x.status==="running"?J(A=>A&&{...A,active:[...A.active,x.label],rows:Re(A.rows,x.label,"active"),lastAt:Date.now()}):J(A=>A&&{...A,active:A.active.filter(M=>M!==x.label),done:A.done+1,rows:Re(A.rows,x.label,x.status==="done"?"done":"failed"),lastAt:Date.now()});else if(x.type==="partition_event")J(A=>{if(!A)return A;let M={...A,lastAt:Date.now()};return x.event.type==="tool"?M.tools=A.tools+1:x.event.type==="text"&&(M.chars=A.chars+x.event.delta.length),M});else if(x.type==="run_done"){pt(L=>L+x.totalCostUsd),dt(L=>L+x.results.reduce((G,ae)=>G+ae.outputTokens,0));let A=x.aborted?"Stopped. ":"",M=t.kind==="api"?"api":"subscription";u({kind:"note",tone:x.aborted?"warn":x.ok?"ok":"warn",text:A+Ko(x.results,D,M).join(`
|
|
@@ -10,7 +10,7 @@ import type { ReplContext } from '../repl.js';
|
|
|
10
10
|
* v4 → the writer can send the builder a `request` (not just a question), e.g. an auto "re-run
|
|
11
11
|
* onboarding" note when this protocol version moves ahead of what the builder last completed.
|
|
12
12
|
*/
|
|
13
|
-
export declare const DEVHINTS_VERSION =
|
|
13
|
+
export declare const DEVHINTS_VERSION = 5;
|
|
14
14
|
/**
|
|
15
15
|
* The committed protocol guide the SOURCE repo's coding agent follows. Self-contained because that
|
|
16
16
|
* agent has none of d360-writer's context. Two parts: (1) a ONE-TIME architecture brief that onboards
|
|
@@ -10,9 +10,9 @@ export declare function publishCandidates(entries: SyncEntryState[]): {
|
|
|
10
10
|
path: string;
|
|
11
11
|
label: string;
|
|
12
12
|
}[];
|
|
13
|
-
/** Count of files that
|
|
14
|
-
tell the user why they were left out instead of silently dropping them. */
|
|
15
|
-
export declare function
|
|
13
|
+
/** Count of files that already exist on Document360 but aren't linked (link candidates), so the /publish
|
|
14
|
+
flows can tell the user why they were left out instead of silently dropping them. */
|
|
15
|
+
export declare function linkCandidateCount(entries: SyncEntryState[]): number;
|
|
16
16
|
/** A row in the grouped /publish picker: "all", a category (publishes all its candidates), or one
|
|
17
17
|
article. `paths` is what gets published when the row is chosen (one for an article, many otherwise). */
|
|
18
18
|
export type PublishRow = {
|
|
@@ -1,13 +1,18 @@
|
|
|
1
1
|
export declare const PICK_CUE: RegExp;
|
|
2
|
-
|
|
3
|
-
* Once the "reply with the number" cue has appeared this turn, renumber the FIRST contiguous block of
|
|
4
|
-
* top-level option bullets (`-`/`*`/`•`) to `1.` `2.` `3.` so they're actually pickable. Conservative:
|
|
5
|
-
* only top-level bullets; only the first block; indented continuation lines (wrapped descriptions) do NOT
|
|
6
|
-
* close it — only a non-indented, non-bullet line does. `state` carries the counter + a `closed` flag
|
|
7
|
-
* across streamed chunks; `turnTextSoFar` lets a cue that arrived in an earlier chunk still apply. No-op if
|
|
8
|
-
* the agent already numbered the options (no bullets to convert).
|
|
9
|
-
*/
|
|
10
|
-
export declare function renumberPickOptions(chunk: string, turnTextSoFar: string, state: {
|
|
2
|
+
export type PickState = {
|
|
11
3
|
num: number;
|
|
12
4
|
closed: boolean;
|
|
13
|
-
|
|
5
|
+
cueSeen: boolean;
|
|
6
|
+
};
|
|
7
|
+
/**
|
|
8
|
+
* Renumber the option bullets that FOLLOW a "reply with the number" cue line to `1.` `2.` `3.` so they're
|
|
9
|
+
* actually pickable. Walks line by line, flipping `cueSeen` only when it passes the cue line itself — so
|
|
10
|
+
* bullets that appear BEFORE the cue (e.g. an earlier "things to flag" list) are never touched, and only
|
|
11
|
+
* the FIRST contiguous block AFTER the cue is numbered (dogfood: the cue trailed an unrelated bullet list
|
|
12
|
+
* in an /audit, and the old "cue anywhere → first block" logic renumbered the wrong one and missed the
|
|
13
|
+
* real options). Conservative: top-level `-`/`*`/`•` only; indented continuation lines (wrapped
|
|
14
|
+
* descriptions) don't close the block — only a non-indented, non-bullet line does. `state` persists across
|
|
15
|
+
* streamed chunks (the cue line and the options can arrive in different chunks). No-op once the block is
|
|
16
|
+
* closed, or if the agent already numbered the options.
|
|
17
|
+
*/
|
|
18
|
+
export declare function renumberPickOptions(chunk: string, state: PickState): string;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "document360-writer",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.98",
|
|
4
4
|
"description": "Standalone documentation agent CLI. Reads your code, writes your docs. Specialized for Document360 publishing.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
"@inquirer/prompts": "^8.4.3",
|
|
35
35
|
"commander": "^14.0.3",
|
|
36
36
|
"diff": "^8.0.4",
|
|
37
|
-
"document360-engine": "^0.2.
|
|
37
|
+
"document360-engine": "^0.2.52",
|
|
38
38
|
"ink": "^5.2.1",
|
|
39
39
|
"picocolors": "^1.1.1",
|
|
40
40
|
"react": "^18.3.1",
|