document360-writer 0.4.97 → 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 +22 -4
- package/dist/commands/devhints.d.ts +1 -1
- 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(`
|
|
@@ -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,7 +266,7 @@ 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:
|
|
@@ -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
|
|
@@ -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",
|