kaizen-agent 1.47.0 → 1.49.0

package/skills/media/kaizen-book/examples/manuscript.md

@@ -0,0 +1,127 @@
+# Part One: The Keeper
+
+The first part follows Ilse through the long quiet.
+
+## The Long Quiet | In which nothing happens, carefully
+
+Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. She had stopped trying to reply to them; it felt like speaking to photographs. The station hummed the way old machines hum, as if remembering a song nobody had taught it. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her.
+
+Sometimes the relay crackled with fragments of voices from stations that no longer answered. When the alarm finally sounded, she did not believe it for almost a full minute. The station hummed the way old machines hum, as if remembering a song nobody had taught it.
+
+The station hummed the way old machines hum, as if remembering a song nobody had taught it. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. She had stopped trying to reply to them; it felt like speaking to photographs. She had stopped trying to reply to them; it felt like speaking to photographs.
+
+She wrote her reports anyway, in the careful hand her mother had used for letters home. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her.
+
+The station hummed the way old machines hum, as if remembering a song nobody had taught it. When the alarm finally sounded, she did not believe it for almost a full minute. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. She wrote her reports anyway, in the careful hand her mother had used for letters home. When the alarm finally sounded, she did not believe it for almost a full minute. The station hummed the way old machines hum, as if remembering a song nobody had taught it.
+
+She kept a list on the wall of the galley:
+
+- Check the lamp.
+- Water the garden.
+- Write the report, even if no one reads it.
+
+The station hummed the way old machines hum, as if remembering a song nobody had taught it. She wrote her reports anyway, in the careful hand her mother had used for letters home. The station hummed the way old machines hum, as if remembering a song nobody had taught it. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right.
+
+Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. When the alarm finally sounded, she did not believe it for almost a full minute. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her.
+
+Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. When the alarm finally sounded, she did not believe it for almost a full minute. When the alarm finally sounded, she did not believe it for almost a full minute. She wrote her reports anyway, in the careful hand her mother had used for letters home.
+
+Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. When the alarm finally sounded, she did not believe it for almost a full minute. The station hummed the way old machines hum, as if remembering a song nobody had taught it.
+
+> Keep the light, and the light will keep you.
+> — inscription above the hatch
+
+The garden in Module Four needed water, and the water needed the pump, and the pump needed her. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. She had stopped trying to reply to them; it felt like speaking to photographs. Sometimes the relay crackled with fragments of voices from stations that no longer answered.
+
+When the alarm finally sounded, she did not believe it for almost a full minute. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. Sometimes the relay crackled with fragments of voices from stations that no longer answered. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. She wrote her reports anyway, in the careful hand her mother had used for letters home. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again.
+
+Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. When the alarm finally sounded, she did not believe it for almost a full minute. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her.
+
+Sometimes the relay crackled with fragments of voices from stations that no longer answered. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. When the alarm finally sounded, she did not believe it for almost a full minute. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years.
+
+Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. Sometimes the relay crackled with fragments of voices from stations that no longer answered. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. She had stopped trying to reply to them; it felt like speaking to photographs. The station hummed the way old machines hum, as if remembering a song nobody had taught it.[^1]
+
+***
+
+Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. When the alarm finally sounded, she did not believe it for almost a full minute. Sometimes the relay crackled with fragments of voices from stations that no longer answered.
+
+Sometimes the relay crackled with fragments of voices from stations that no longer answered. When the alarm finally sounded, she did not believe it for almost a full minute. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. When the alarm finally sounded, she did not believe it for almost a full minute. The garden in Module Four needed water, and the water needed the pump, and the pump needed her.
+
+Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. The garden in Module Four needed water, and the water needed the pump, and the pump needed her.
+
+The station hummed the way old machines hum, as if remembering a song nobody had taught it. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. When the alarm finally sounded, she did not believe it for almost a full minute.
+
+[^1]: The phrase comes from the station's founding charter, signed in 2211.
+
+## Signals | A voice where no voice should be
+
+There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. She had stopped trying to reply to them; it felt like speaking to photographs. Sometimes the relay crackled with fragments of voices from stations that no longer answered. The station hummed the way old machines hum, as if remembering a song nobody had taught it. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. Sometimes the relay crackled with fragments of voices from stations that no longer answered.
+
+When the alarm finally sounded, she did not believe it for almost a full minute. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. The station hummed the way old machines hum, as if remembering a song nobody had taught it.
+
+There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. She wrote her reports anyway, in the careful hand her mother had used for letters home. She had stopped trying to reply to them; it felt like speaking to photographs.
+
+The garden in Module Four needed water, and the water needed the pump, and the pump needed her. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. She had stopped trying to reply to them; it felt like speaking to photographs. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her.
+
+Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. She had stopped trying to reply to them; it felt like speaking to photographs. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. She had stopped trying to reply to them; it felt like speaking to photographs.
+
+She had stopped trying to reply to them; it felt like speaking to photographs. She wrote her reports anyway, in the careful hand her mother had used for letters home. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again.
+
+![The Reach at shift change](images/reach.svg)
+
+She wrote her reports anyway, in the careful hand her mother had used for letters home. She wrote her reports anyway, in the careful hand her mother had used for letters home. The station hummed the way old machines hum, as if remembering a song nobody had taught it. The garden in Module Four needed water, and the water needed the pump, and the pump needed her.
+
+There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. The station hummed the way old machines hum, as if remembering a song nobody had taught it. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again.
+
+Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. Sometimes the relay crackled with fragments of voices from stations that no longer answered. When the alarm finally sounded, she did not believe it for almost a full minute. When the alarm finally sounded, she did not believe it for almost a full minute. Sometimes the relay crackled with fragments of voices from stations that no longer answered. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again.
+
+The garden in Module Four needed water, and the water needed the pump, and the pump needed her. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. She had stopped trying to reply to them; it felt like speaking to photographs.
+
+She had stopped trying to reply to them; it felt like speaking to photographs. She had stopped trying to reply to them; it felt like speaking to photographs. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. She had stopped trying to reply to them; it felt like speaking to photographs. The station hummed the way old machines hum, as if remembering a song nobody had taught it.
+
+Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. She wrote her reports anyway, in the careful hand her mother had used for letters home. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again.
+
+# Part Two: The Ship
+
+## Contact
+
+Sometimes the relay crackled with fragments of voices from stations that no longer answered. When the alarm finally sounded, she did not believe it for almost a full minute. The station hummed the way old machines hum, as if remembering a song nobody had taught it.
+
+The station hummed the way old machines hum, as if remembering a song nobody had taught it. When the alarm finally sounded, she did not believe it for almost a full minute. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again.
+
+Sometimes the relay crackled with fragments of voices from stations that no longer answered. When the alarm finally sounded, she did not believe it for almost a full minute. The station hummed the way old machines hum, as if remembering a song nobody had taught it.
+
+She wrote her reports anyway, in the careful hand her mother had used for letters home. When the alarm finally sounded, she did not believe it for almost a full minute. She had stopped trying to reply to them; it felt like speaking to photographs.
+
+There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. Sometimes the relay crackled with fragments of voices from stations that no longer answered. When the alarm finally sounded, she did not believe it for almost a full minute. Sometimes the relay crackled with fragments of voices from stations that no longer answered.
+
+### The Approach
+
+Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. The garden in Module Four needed water, and the water needed the pump, and the pump needed her.
+
+Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. Sometimes the relay crackled with fragments of voices from stations that no longer answered. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right.
+
+Outside, the dust of the Reach moved in slow rivers, catching the beam and letting it go again. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. The station hummed the way old machines hum, as if remembering a song nobody had taught it. She wrote her reports anyway, in the careful hand her mother had used for letters home. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. Sometimes the relay crackled with fragments of voices from stations that no longer answered.
+
+Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. The station hummed the way old machines hum, as if remembering a song nobody had taught it. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right.
+
+There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. Sometimes the relay crackled with fragments of voices from stations that no longer answered.[^a] And then it was there.[^b]
+
+[^a]: Ships of this class were retired a century earlier.
+[^b]: Ilse's log for this hour is a single line: *It came.*
+
+## The Last Light
+
+Sometimes the relay crackled with fragments of voices from stations that no longer answered. She wrote her reports anyway, in the careful hand her mother had used for letters home. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her.
+
+She wrote her reports anyway, in the careful hand her mother had used for letters home. When the alarm finally sounded, she did not believe it for almost a full minute. She wrote her reports anyway, in the careful hand her mother had used for letters home. She wrote her reports anyway, in the careful hand her mother had used for letters home. She had stopped trying to reply to them; it felt like speaking to photographs.
+
+She wrote her reports anyway, in the careful hand her mother had used for letters home. Every system on Kepler Reach leaned on another, and all of them, in the end, leaned on her. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. Sometimes the relay crackled with fragments of voices from stations that no longer answered.
+
+The station hummed the way old machines hum, as if remembering a song nobody had taught it. There was a comfort in procedure, in the small certainty that one thing, at least, was being done right. The garden in Module Four needed water, and the water needed the pump, and the pump needed her.
+
+She wrote her reports anyway, in the careful hand her mother had used for letters home. When the alarm finally sounded, she did not believe it for almost a full minute. Sometimes the relay crackled with fragments of voices from stations that no longer answered. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. Sometimes the relay crackled with fragments of voices from stations that no longer answered.
+
+Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. She wrote her reports anyway, in the careful hand her mother had used for letters home. Ilse checked the lamp twice each shift, although the logs had not recorded a passing ship in eleven years. She wrote her reports anyway, in the careful hand her mother had used for letters home. The garden in Module Four needed water, and the water needed the pump, and the pump needed her.
+
+Sometimes the relay crackled with fragments of voices from stations that no longer answered. She wrote her reports anyway, in the careful hand her mother had used for letters home. The garden in Module Four needed water, and the water needed the pump, and the pump needed her. When the alarm finally sounded, she did not believe it for almost a full minute.

package/skills/media/kaizen-book/references/interview.md

@@ -0,0 +1,85 @@
+# The interview: before a word of the book is written
+
+A new book starts with an interview, never with a draft. The answers become `book/brief.md`,
+which the author approves before the outline is drafted. Skip only the questions the author has already answered
+in their request, and say which ones you took from it.
+
+## How to ask
+
+- One round at a time, with AskUserQuestion, at most 4 questions per round, 2–4 concrete options
+  each. Free text is always available, so never add an "other" option.
+- Put the recommended or most common choice first. Fill options from what is already known: a
+  romance author is offered romance tropes, not hard-sci-fi subgenres.
+- Ask in the author's language. If they wrote in Indonesian, every question and option is in Indonesian.
+- Four rounds is normal, and six is the limit. Once the brief is good enough to outline from, stop asking and write it.
+- An answer that changes the shape of the book (fiction to memoir, novel to short-story collection)
+  restarts the round it belongs to, not the whole interview.
+
+## Round 1 — what kind of book
+
+| Question | Typical options |
+|---|---|
+| What kind of book? | Novel / novella · short-story collection · memoir or biography · non-fiction (history, essays, religious, self-help, how-to) · children's book |
+| Genre (fiction) | science fiction · romance · fantasy · mystery/thriller · horror · literary · historical · young adult |
+| Subject (non-fiction) | Ask for the subject in one line, then: argument · narrative history · practical guide · collected essays/articles |
+| Who reads it? | Age band (children 6–9 · middle grade · young adult · adult), and general readers or specialists |
+
+## Round 2 — size and voice
+
+| Question | Typical options |
+|---|---|
+| Language | The author's language first; bilingual front matter if asked |
+| Length | Short (~15k words, 6–10 chapters) · novella (~30k, 10–15) · novel (~70k, 20–30) · long (100k+, consider volumes) |
+| Point of view (fiction) | first person · close third, one character · third, several characters · omniscient |
+| Tense (fiction) | past · present |
+| Tone | Offer 3–4 tones that fit the genre: romance → warm & witty / slow-burn & aching / steamy / sweet & clean; thriller → cold & clipped / paranoid / procedural |
+| Voice reference | "Like which book or author?" Use the answer for voice only, and never imitate the text itself |
+
+## Round 3 — the story or the argument
+
+Fiction:
+- Premise in one or two sentences: who wants what, what stands in the way, and what is at stake.
+- The protagonist: name, age, the flaw, and what they want versus what they need.
+- Two to four other main characters, each with their role in one line.
+- Setting: place, time, and the one rule of this world that matters (magic system, tech, social order).
+- Ending: happy / bittersweet / tragic / open. For a romance, HEA (happily ever after) or HFN (happy for now) is a genre promise; ask, don't assume.
+- Content limits: violence, sex, language. What is on the page, implied, or off limits.
+
+Non-fiction:
+- Thesis or promise: what the reader knows or can do after the last page.
+- Sources the author has: notes, articles, interviews, earlier writing. Existing text is the author's
+  material and is used as it is; it is never rewritten without asking.
+- Structure: chronological · thematic · problem→solution · collected pieces grouped into parts.
+- Facts and citations: footnotes or endnotes · a bibliography · none.
+
+## Round 4 — the object
+
+| Question | Options |
+|---|---|
+| Look (`style` in book.json) | classic · romance · scifi · fantasy · thriller · literary · children. Name the one that matches the genre first, with its one-line note from `assets/styles.json` |
+| Cover | Typeset cover in the style's colours (default) · their own image (ask for the file; 2:3 portrait, at least 1200×1800) |
+| Parts and volumes | One volume · parts (`#` headings) · several printed volumes (very long books) |
+| Front matter | Dedication · copyright line · preface or foreword (who writes it) |
+| Where it goes | Just the files · a website with link previews (ask for the domain) · print only |
+
+## The brief
+
+Write `book/brief.md`. The author approves it, and it is the scope for everything after:
+
+```markdown
+# Brief — <working title>
+- Kind / genre: …            - Readers: …
+- Language: …                - Length: … words, … chapters
+- POV / tense: …             - Tone: …   (voice like: …)
+- Premise / thesis: …
+- Characters / sources: …
+- Setting / structure: …
+- Ending / promise: …
+- Content limits: …
+- Look: style `…`, cover: …, parts: …, volumes: …
+- Front matter: …
+- Delivery: …
+```
+
+Then create `book/book.json` from it (title, author, lang, style, and so on) and move on to the outline in
+[`writing.md`](writing.md).

package/skills/media/kaizen-book/references/proofread.md

@@ -0,0 +1,47 @@
+# Proofreading
+
+There are two passes. The script checks structure and you read for language. Nothing is changed until the
+author picks which items to accept.
+
+## 1. Structure: `python3 $S/check_book.py book`
+
+It reports chapter numbering gaps, footnote markers without notes and notes nobody cites, empty chapters
+and headings, `##Heading` without a space, broken image paths, Word field codes and HTML leftovers,
+soft hyphens, double spaces, space before punctuation, unclosed bold, mixed straight and curly quotes, and
+repeated words. Errors stop the build; warnings are judgement calls. Fix errors that are mechanical
+(a missing space after `##`) directly and list them. Anything that changes wording goes in the
+change list below.
+
+Also search for `[[CHECK:` markers left while drafting. Every one is an open question for the author.
+
+## 2. Language: `book/proofread.md`
+
+Read chapter by chapter, against `book/style.md`. Write numbered items, one per change:
+
+```markdown
+# Proofread — <title>, <date>
+| # | Where | Original | Correction | Reason |
+|---|---|---|---|---|
+| 1 | Bab 3, ¶4 | "di karenakan" | "dikarenakan" | KBBI: prefix written together |
+| 2 | Ch 7, ¶12 | "Marta" | "Martha" | style sheet spelling |
+```
+
+Look for:
+- spelling and grammar in the book's language and standard: for Indonesian, KBBI and EYD (prefixes *di-*/*ke-* versus
+  prepositions *di*/*ke*, capitalisation, italics for foreign words); for English, the US or UK choice in the style sheet;
+- consistency with the style sheet: names, terms, transliterations, numbers, dates;
+- continuity (fiction): a character who knows something before they learn it, timelines, a changed eye colour;
+- facts (non-fiction): dates, names and quotes that disagree within the book;
+- punctuation: dialogue quotes, dashes, ellipses, and missing or doubled full stops;
+- footnote numbering and placement (the marker comes after the punctuation, unless the language's
+  convention says otherwise).
+
+Do not "improve" the author's style in a proofread. Changes of voice, wording or structure are a
+separate edit, and only with the author's say-so. When a passage reads badly enough that you would rewrite it, list it as
+a query ("Q:"), not a correction.
+
+## 3. Apply
+
+The author answers with the numbers to accept ("all except 4, 9", "1–20"). Apply exactly those, and
+mark each item `✓ applied` or `✗ declined` in `proofread.md`, which becomes the change record (like an
+editor's change list). Then run `check_book.py` again and rebuild.

package/skills/media/kaizen-book/references/writing.md

@@ -0,0 +1,53 @@
+# Writing the book
+
+The order is: brief (approved) → outline (approved) → chapters in batches → proofread → build. Every
+step leaves a file in `book/`, so another session or another tool can pick the book up where it stopped.
+
+## Outline: `book/outline.md`
+
+- Fiction: one entry per chapter, with title, POV character, what happens, what changes by the end of the chapter, and
+  the hook into the next one. Mark the turning points: inciting incident (~10%), first turn (~25%),
+  midpoint (~50%), crisis (~75%), climax and resolution.
+- Non-fiction: one entry per chapter, with its claim or question, its sources, and what the reader takes away.
+- Group the chapters into parts when the brief asks for parts. A part becomes `# Part title` in the manuscript.
+- Show the outline and wait for approval. A rejected outline is revised, never "fixed while drafting".
+
+## The style sheet: `book/style.md`
+
+Start it with the outline and update it after every batch of chapters. This is what keeps chapter 20 consistent with chapter 2:
+
+- Names and spellings: characters, places, invented words, titles and honorifics, transliterations (one
+  system, used everywhere).
+- Facts established so far: ages, eye colours, dates, who knows what and when.
+- Voice rules: POV, tense, dialogue punctuation, how numbers are written, the spelling standard
+  (KBBI/EYD for Indonesian, US or UK spelling for English).
+- Words to avoid: the author's dislikes, anachronisms, and your own tics (see below).
+
+## Drafting
+
+- Write into `book/manuscript.md` in the format `build_book.py` reads:
+  `# Part`, `## Chapter title | optional subtitle`, `### Section`, blank line between paragraphs,
+  `> quote`, `- list`, `***` scene break, `![caption](images/file.jpg)`, footnote `[^1]` with
+  `[^1]: note text` later in the same chapter.
+- Write in batches of three to five chapters. After each batch, show a short summary of each chapter and what
+  you changed in the style sheet, and stop for the author. They may want to steer before the next batch.
+- Read `brief.md`, `style.md`, the outline entry, and the end of the previous chapter before writing a chapter.
+  Don't reread the whole manuscript.
+- Aim for the brief's chapter length. Report the word count per chapter and the running total.
+- Prose: concrete over abstract, scenes over summary (fiction), one idea per paragraph (non-fiction).
+  Vary sentence length. Dialogue carries subtext, and people rarely say exactly what they mean.
+- Avoid the habits that mark machine prose: stacked adjectives, "a testament to", "tapestry",
+  "delve", "in the realm of", "it's not X, it's Y", every chapter ending on a reflective one-liner,
+  everyone "letting out a breath they didn't know they were holding". Put any you catch in the style sheet's
+  avoid list.
+- Facts in non-fiction: never invent a source, a quote, a date or a statistic. Anything the author's material
+  does not support is marked `[[CHECK: …]]` for the author, and the structure check reports these
+  markers until they are resolved.
+- The author's own text is theirs. Edit it only as the brief allows (light copyedit, restructure, or
+  rewrite), and say what kind of edit you made.
+
+## Existing manuscripts
+
+If the author already has a text, convert it with
+`pandoc in.docx -t gfm --wrap=none --extract-media=book/images -o book/manuscript.md`. Then fix
+the headings so parts are `#` and chapters are `##`, and go straight to proofreading.

package/skills/media/kaizen-book/scripts/build_book.py

@@ -0,0 +1,279 @@
+#!/usr/bin/env python3
+"""Build a single-file e-book reader from book/manuscript.md + book/book.json.
+
+Usage: python3 build_book.py <book-dir> [--out output] [--no-fonts]
+Writes <out>/book.html. Stdlib only. Run pdf.mjs afterwards for the PDFs.
+"""
+import base64, html, json, mimetypes, os, re, sys, urllib.request
+
+SKILL = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+LABELS = {
+    "id": {"start": "Mulai Membaca", "resume": "Lanjutkan", "contents": "Daftar Isi", "cover": "Sampul",
+           "tap": "Ketuk untuk membuka", "settings": "Pengaturan tampilan", "theme": "Tema", "size": "Ukuran huruf",
+           "light": "Kertas", "sepia": "Sepia", "night": "Malam", "print": "Cetak / PDF", "notes": "Catatan",
+           "page": "hlm.", "by": "oleh", "close": "Tutup", "prev": "Sebelumnya", "next": "Berikutnya"},
+    "en": {"start": "Start Reading", "resume": "Continue", "contents": "Contents", "cover": "Cover",
+           "tap": "Tap to open", "settings": "Display settings", "theme": "Theme", "size": "Text size",
+           "light": "Paper", "sepia": "Sepia", "night": "Night", "print": "Print / PDF", "notes": "Notes",
+           "page": "p.", "by": "by", "close": "Close", "prev": "Previous", "next": "Next"},
+}
+
+# ---------------------------------------------------------------- Markdown
+
+def inline(s, ch):
+    """Inline Markdown to HTML. `ch` collects footnote refs for this chapter."""
+    out, pos = [], 0
+    code = re.compile(r"`([^`]+)`")
+    parts = code.split(s)
+    for i, p in enumerate(parts):
+        if i % 2:
+            out.append("<code>%s</code>" % html.escape(p))
+            continue
+        p = html.escape(p, quote=False)
+        p = re.sub(r"!\[([^\]]*)\]\(([^)\s]+)\)", lambda m: '<img alt="%s" src="%s">' % (m[1], ch["img"](m[2])), p)
+        p = re.sub(r"\[\^([^\]]+)\]", lambda m: ch["ref"](m[1]), p)
+        p = re.sub(r"\[([^\]]+)\]\(([^)\s]+)\)", r'<a href="\2" target="_blank" rel="noopener">\1</a>', p)
+        p = re.sub(r"\*\*(.+?)\*\*|__(.+?)__", lambda m: "<strong>%s</strong>" % (m[1] or m[2]), p)
+        p = re.sub(r"(?<![\w*])\*(?!\s)(.+?)(?<!\s)\*(?!\w)|(?<![\w_])_(?!\s)(.+?)(?<!\s)_(?!\w)",
+                   lambda m: "<em>%s</em>" % (m[1] or m[2]), p)
+        p = re.sub(r"(  |\\)\n", "<br>", p)
+        out.append(p)
+    return "".join(out)
+
+
+def parse(text, book_dir):
+    """Returns {"intro": html, "parts": [{"title", "intro", "chs": [{"t", "sub", "html"}]}]}."""
+    text = text.replace("\r\n", "\n").lstrip("")
+    lines = text.split("\n")
+    parts = [{"title": None, "intro": "", "chs": []}]
+    cur = {"buf": [], "notes": {}, "order": []}
+
+    def img(src):
+        if re.match(r"^(https?:|data:)", src):
+            return src
+        path = os.path.join(book_dir, src)
+        if not os.path.exists(path):
+            print("warning: image not found: %s" % src, file=sys.stderr)
+            return src
+        if os.path.getsize(path) > 1_500_000:
+            print("warning: %s is %.1f MB; resize it to keep the book light" % (src, os.path.getsize(path) / 1e6), file=sys.stderr)
+        mime = mimetypes.guess_type(path)[0] or "image/jpeg"
+        return "data:%s;base64,%s" % (mime, base64.b64encode(open(path, "rb").read()).decode())
+
+    chap_no = [0]
+
+    def ref(key):
+        if key not in cur["order"]:
+            cur["order"].append(key)
+        n = cur["order"].index(key) + 1
+        return '<sup class="fn"><a href="#" data-fn="%d">%d</a></sup>' % (n, n)
+
+    ctx = {"img": img, "ref": ref}
+
+    def flush():
+        """Render the buffered block lines into the current chapter (or part intro)."""
+        blocks, block, code = [], [], None
+        for ln in cur["buf"]:
+            if code is not None:  # inside ``` … ```: keep every line, blank ones too
+                if ln.strip().startswith("```"):
+                    blocks.append(code); code = None
+                else:
+                    code.append(ln)
+            elif ln.strip().startswith("```"):
+                if block:
+                    blocks.append(block); block = []
+                code = ["\0code"]
+            elif ln.strip() == "":
+                if block:
+                    blocks.append(block); block = []
+            else:
+                block.append(ln)
+        for b in (block, code):
+            if b:
+                blocks.append(b)
+        out = []
+        for b in blocks:
+            if b[0] == "\0code":
+                out.append("<pre><code>%s</code></pre>" % html.escape("\n".join(b[1:])))
+                continue
+            first = b[0].strip()
+            joined = "\n".join(x.strip() for x in b)
+            if re.match(r"^\[\^[^\]]+\]:", first):
+                key = None
+                for x in b:
+                    m = re.match(r"^\[\^([^\]]+)\]:\s*(.*)", x.strip())
+                    if m:
+                        key = m[1]; cur["notes"][key] = m[2]
+                    elif key:
+                        cur["notes"][key] += " " + x.strip()
+                continue
+            if re.match(r"^(\*\s*\*\s*\*|-{3,}|\*{3,}|⁂)$", first) and len(b) == 1:
+                out.append('<p class="scene">⁂</p>')
+            elif first.startswith("### ") or first.startswith("#### "):
+                lvl = 3 if first.startswith("### ") else 4
+                out.append("<h%d>%s</h%d>" % (lvl, inline(first[lvl + 1:].strip(), ctx), lvl))
+                rest = b[1:]
+                if rest:
+                    out.append('<p dir="auto">%s</p>' % inline("\n".join(rest), ctx))
+            elif first.startswith(">"):
+                inner = "\n".join(re.sub(r"^>\s?", "", x.strip()) for x in b)
+                paras = [p for p in re.split(r"\n\s*\n", inner) if p.strip()]
+                out.append("<blockquote>%s</blockquote>" % "".join('<p dir="auto">%s</p>' % inline(p, ctx) for p in paras))
+            elif re.match(r"^([-*+]|\d+[.)])\s", first):
+                ordered = bool(re.match(r"^\d", first))
+                items, it = [], None
+                for x in b:
+                    m = re.match(r"^\s*([-*+]|\d+[.)])\s+(.*)", x)
+                    if m:
+                        it = [m[2]]; items.append(it)
+                    elif it is not None:
+                        it.append(x.strip())
+                tag = "ol" if ordered else "ul"
+                out.append("<%s>%s</%s>" % (tag, "".join('<li dir="auto">%s</li>' % inline("\n".join(i), ctx) for i in items), tag))
+            elif re.match(r"^!\[[^\]]*\]\([^)]+\)$", joined):
+                m = re.match(r"^!\[([^\]]*)\]\(([^)]+)\)$", joined)
+                cap = '<figcaption>%s</figcaption>' % inline(m[1], ctx) if m[1] else ""
+                out.append('<figure><img alt="%s" src="%s">%s</figure>' % (html.escape(m[1]), img(m[2]), cap))
+            elif first.startswith("<"):
+                out.append(joined)
+            else:
+                out.append('<p dir="auto">%s</p>' % inline("\n".join(x.rstrip(" ") if not x.endswith("  ") else x for x in b), ctx))
+        cur["buf"] = []
+        if cur["order"]:
+            notes = "".join('<li data-n="%d">%s</li>' % (i + 1, inline(cur["notes"].get(k, "<em>?</em>"), ctx))
+                            for i, k in enumerate(cur["order"]))
+            out.append('<ol class="notes">%s</ol>' % notes)
+        return "".join(out)
+
+    target = ("intro", parts[0])
+    in_fence = False
+
+    def close():
+        body = flush()
+        kind, obj = target
+        if kind == "intro":
+            obj["intro"] += body
+        else:
+            obj["html"] += body
+        cur["notes"], cur["order"] = {}, []
+
+    for ln in lines:
+        if ln.strip().startswith("```"):
+            in_fence = not in_fence
+            cur["buf"].append(ln)
+            continue
+        m = re.match(r"^(#{1,2})\s+(.*)$", ln) if not in_fence else None
+        if m:
+            close()
+            title = m[2].strip()
+            if m[1] == "#":
+                p = {"title": title, "intro": "", "chs": []}
+                if parts[-1]["title"] is None and not parts[-1]["chs"] and not parts[-1]["intro"]:
+                    parts[-1] = p
+                else:
+                    parts.append(p)
+                target = ("intro", p)
+            else:
+                t, _, sub = title.partition(" | ")
+                c = {"t": t.strip(), "sub": sub.strip(), "html": ""}
+                parts[-1]["chs"].append(c)
+                target = ("ch", c)
+            continue
+        cur["buf"].append(ln)
+    close()
+    return [p for p in parts if p["title"] or p["chs"] or p["intro"]]
+
+# ---------------------------------------------------------------- Fonts
+
+def embed_fonts(families, cache):
+    """Google Fonts CSS with latin/latin-ext woff2 inlined, cached on disk. '' on failure (falls back to <link>)."""
+    os.makedirs(cache, exist_ok=True)
+    key = re.sub(r"\W+", "_", "-".join(families)) + ".css"
+    path = os.path.join(cache, key)
+    if os.path.exists(path):
+        return open(path).read()
+    q = "&".join("family=" + f.replace(" ", "+") + ":ital,wght@0,400;0,600;0,700;1,400" for f in families)
+    url = "https://fonts.googleapis.com/css2?%s&display=swap" % q
+    ua = {"User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 Chrome/130 Safari/537.36"}
+    try:
+        try:
+            css = urllib.request.urlopen(urllib.request.Request(url, headers=ua), timeout=20).read().decode()
+        except Exception:  # a family without italics or weight 600/700
+            q = "&".join("family=" + f.replace(" ", "+") for f in families)
+            url = "https://fonts.googleapis.com/css2?%s&display=swap" % q
+            css = urllib.request.urlopen(urllib.request.Request(url, headers=ua), timeout=20).read().decode()
+        keep = []
+        for sub, block in re.findall(r"/\* ([\w-]+) \*/\s*(@font-face\s*{[^}]*})", css):
+            if sub not in ("latin", "latin-ext"):
+                continue
+            def inl(m):
+                data = urllib.request.urlopen(urllib.request.Request(m[1], headers=ua), timeout=30).read()
+                return "url(data:font/woff2;base64,%s)" % base64.b64encode(data).decode()
+            keep.append(re.sub(r"url\((https://[^)]+)\)", inl, block))
+        out = "\n".join(keep)
+        open(path, "w").write(out)
+        return out
+    except Exception as e:
+        print("warning: fonts not embedded (%s); the book loads them online instead" % e, file=sys.stderr)
+        return ""
+
+# ---------------------------------------------------------------- Build
+
+def main():
+    args = sys.argv[1:]
+    if not args or args[0].startswith("-"):
+        sys.exit(__doc__)
+    book_dir = args[0]
+    out_dir = args[args.index("--out") + 1] if "--out" in args else "output"
+    cfg = json.load(open(os.path.join(book_dir, "book.json")))
+    styles = json.load(open(os.path.join(SKILL, "assets", "styles.json")))
+    style = dict(styles.get(cfg.get("style", "classic"), styles["classic"]))
+    for k, v in cfg.get("theme", {}).items():  # per-book overrides
+        style[k] = {**style[k], **v} if isinstance(v, dict) and isinstance(style.get(k), dict) else v
+    lang = cfg.get("lang", "en")
+    labels = {**LABELS.get(lang, LABELS["en"]), **cfg.get("labels", {})}
+
+    parts = parse(open(os.path.join(book_dir, cfg.get("manuscript", "manuscript.md"))).read(), book_dir)
+    if not any(p["chs"] for p in parts):
+        sys.exit("error: no chapters found; chapters start with '## '")
+
+    cover = None
+    if cfg.get("cover"):
+        p = os.path.join(book_dir, cfg["cover"])
+        if os.path.exists(p):
+            cover = "data:%s;base64,%s" % (mimetypes.guess_type(p)[0] or "image/jpeg", base64.b64encode(open(p, "rb").read()).decode())
+        else:
+            print("warning: cover not found: %s; using a typeset cover" % cfg["cover"], file=sys.stderr)
+
+    fams = list(dict.fromkeys(style["fonts"].values()))
+    font_css = "" if "--no-fonts" in args else embed_fonts(fams, os.path.join(os.path.expanduser("~"), ".kaizen", "kaizen-book", "fonts"))
+    font_link = "" if font_css else '<link rel="stylesheet" href="https://fonts.googleapis.com/css2?%s&display=swap">' % "&".join(
+        "family=" + f.replace(" ", "+") for f in fams)
+
+    data = {
+        "title": cfg["title"], "subtitle": cfg.get("subtitle", ""), "author": cfg.get("author", ""),
+        "tagline": cfg.get("tagline", ""), "edition": cfg.get("edition", ""), "lang": lang,
+        "key": cfg.get("id") or re.sub(r"\W+", "-", cfg["title"].lower()).strip("-"),
+        "cover": cover, "style": style, "labels": labels, "parts": parts,
+        "dedication": cfg.get("dedication", ""), "copyright": cfg.get("copyright", ""),
+        "volumes": cfg.get("volumes", []),
+        "volume_print": cfg.get("volume_print", "mono"),
+    }
+    tpl = open(os.path.join(SKILL, "assets", "reader.html")).read()
+    js = json.dumps(data, ensure_ascii=False).replace("</", "<\\/")
+    out = (tpl.replace("/*@@FONTS@@*/", font_css)
+              .replace("<!--@@FONTLINK@@-->", font_link)
+              .replace("@@LANG@@", html.escape(lang))
+              .replace("@@TITLE@@", html.escape(cfg["title"]))
+              .replace("@@DESC@@", html.escape(cfg.get("description") or cfg.get("tagline", "")))
+              .replace('"@@BOOK@@"', js))
+    os.makedirs(out_dir, exist_ok=True)
+    dest = os.path.join(out_dir, "book.html")
+    open(dest, "w").write(out)
+    n = sum(len(p["chs"]) for p in parts)
+    print("ok %s — %d parts, %d chapters, %.1f MB" % (dest, len([p for p in parts if p["title"]]), n, len(out.encode()) / 1e6))
+
+
+if __name__ == "__main__":
+    main()

package/skills/media/kaizen-book/scripts/check.sh

@@ -0,0 +1,10 @@
+#!/bin/sh
+# Lists what kaizen-book needs and whether it is here. Exit 1 if anything is missing.
+H="${KAIZEN_BOOK_HOME:-$HOME/.kaizen/kaizen-book}"; miss=0
+for c in python3 node npm pdfinfo; do
+  if command -v $c >/dev/null 2>&1; then echo "ok      $c"; else echo "MISSING $c"; miss=1; fi
+done
+command -v pdfinfo >/dev/null 2>&1 || echo "        pdfinfo comes with poppler (poppler-utils): contents page numbers need it"
+if [ -d "$H/node_modules/playwright" ]; then echo "ok      playwright ($H)"; else echo "MISSING playwright: run scripts/setup.sh"; miss=1; fi
+command -v pandoc >/dev/null 2>&1 && echo "ok      pandoc (optional, .docx import)" || echo "-       pandoc not found (optional, only for .docx manuscripts)"
+exit $miss