Write docs

Write, delete, move and rename markdown documentation files — this is how a site gets its pages and how its structure is changed, including a site just created from scratch by create_workspace. EVERYTHING in one call lands in ONE atomic git commit: batch a restructure (the moves, the deletions, and the pages whose links they change) into a single call rather than calling this repeatedly — a rename split across two commits leaves the published site with a broken link in between. files writes whole files. operations says what a content array cannot: {op:'delete', path, redirect_to?} removes a page, {op:'move', from, to, content?} renames or relocates one (its body carries over untouched unless you pass content; naming a directory moves every page under it). Operations are applied before files, so writing a page at a path you just moved away from leaves a stub behind rather than cancelling the move. Every move — and every delete that names redirect_to — is recorded in the site's redirect map in the same commit, so the old URL keeps working instead of 404-ing every external link to it. Publishes to the Docsbook-hosted repository using Docsbook's own GitHub credentials, so the user needs no GitHub access; the repository is created on the first write if it does not exist yet. The result carries site_url — report that link, do not construct one. It also carries widget_review: a read of the markdown you just wrote, naming any widget marker that will NOT render (unclosed, misspelled, nested, switched off) and any region that has the shape of a content widget and was left as plain markdown — a stacked set of snippets in three languages, a bare list of links closing the page, numbered step headings, a bolded Note:. Act on the ones that fit the page with a follow-up call; list_content_widgets has each widget's full contract. And style_review: where the prose departs from the house style — a paragraph past four lines, four paragraphs with nothing between them, identifiers (--flag, API_KEY, fooBar, file.json) written outside inline code, a long page with no links. list_content_widgets → writing_style is the style itself; read it before your first page. Every written page carries a LIFECYCLE — a status and a version in its own frontmatter — and this call maintains it: a new page opens at generated 0.1, an edit bumps the version, and an edit to an approved page sends it back to review, because the sign-off was of the text that just changed. The result's lifecycle says where each page landed; report a demotion rather than describing the docs as settled. Thaw it with set_doc_status first. set_doc_status is the separate, deliberate act.