stagent 0.6.3 → 0.8.0

package/src/components/tasks/task-create-panel.tsx

@@ -172,39 +172,11 @@ export function TaskCreatePanel({ projects, defaultProjectId }: TaskCreatePanelP
       : null;
 
   const handleDocPickerConfirm = useCallback(
-    (ids: string[]) => {
+    (ids: string[], meta: Array<{ id: string; originalName: string; mimeType: string; size: number }>) => {
       setSelectedDocIds(new Set(ids));
-      // Fetch metadata for newly selected docs
-      const newIds = ids.filter(
-        (id) => !selectedDocs.some((d) => d.id === id)
-      );
-      if (newIds.length > 0) {
-        const params = new URLSearchParams({ status: "ready" });
-        if (projectId) params.set("projectId", projectId);
-        fetch(`/api/documents?${params}`)
-          .then((r) => r.json())
-          .then((allDocs: Array<Record<string, unknown>>) => {
-            const idSet = new Set(ids);
-            setSelectedDocs(
-              allDocs
-                .filter((d) => idSet.has(d.id as string))
-                .map((d) => ({
-                  id: d.id as string,
-                  originalName: d.originalName as string,
-                  mimeType: d.mimeType as string,
-                  size: d.size as number,
-                }))
-            );
-          })
-          .catch(() => {});
-      } else {
-        // Remove deselected docs
-        setSelectedDocs((prev) =>
-          prev.filter((d) => ids.includes(d.id))
-        );
-      }
+      setSelectedDocs(meta);
     },
-    [projectId, selectedDocs]
+    []
   );
 
   async function handleSubmit(e: React.FormEvent) {
@@ -497,6 +469,8 @@ export function TaskCreatePanel({ projects, defaultProjectId }: TaskCreatePanelP
                   onConfirm={handleDocPickerConfirm}
                   groupBy="project"
                   title="Select Context Documents"
+                  allowCrossProject
+                  selectedDocumentMeta={selectedDocs}
                 />
               </FormSectionCard>
 

package/src/components/tasks/task-edit-dialog.tsx

@@ -124,35 +124,11 @@ export function TaskEditDialog({
       : null;
 
   const handleDocPickerConfirm = useCallback(
-    (ids: string[]) => {
+    (ids: string[], meta: Array<{ id: string; originalName: string; mimeType: string; size: number }>) => {
       setSelectedDocIds(new Set(ids));
-      const newIds = ids.filter(
-        (id) => !selectedDocs.some((d) => d.id === id)
-      );
-      if (newIds.length > 0) {
-        const params = new URLSearchParams({ status: "ready" });
-        if (task?.projectId) params.set("projectId", task.projectId);
-        fetch(`/api/documents?${params}`)
-          .then((r) => r.json())
-          .then((allDocs: Array<Record<string, unknown>>) => {
-            const idSet = new Set(ids);
-            setSelectedDocs(
-              allDocs
-                .filter((d) => idSet.has(d.id as string))
-                .map((d) => ({
-                  id: d.id as string,
-                  originalName: d.originalName as string,
-                  mimeType: d.mimeType as string,
-                  size: d.size as number,
-                }))
-            );
-          })
-          .catch(() => {});
-      } else {
-        setSelectedDocs((prev) => prev.filter((d) => ids.includes(d.id)));
-      }
+      setSelectedDocs(meta);
     },
-    [task?.projectId, selectedDocs]
+    []
   );
 
   async function handleSubmit(e: React.FormEvent) {
@@ -384,6 +360,8 @@ export function TaskEditDialog({
             onConfirm={handleDocPickerConfirm}
             groupBy="project"
             title="Select Context Documents"
+            allowCrossProject
+            selectedDocumentMeta={selectedDocs}
           />
 
           <Button

package/src/components/workflows/workflow-form-view.tsx

@@ -155,14 +155,14 @@ function normalizeParallelSteps(
 
   const normalizedBranches = branches.map((branch, index) => ({
     ...branch,
-    id: options?.cloneIds ? crypto.randomUUID() : branch.id,
+    id: options?.cloneIds ? crypto.randomUUID() : (branch.id || crypto.randomUUID()),
     name: branch.name || `Research Branch ${index + 1}`,
   }));
 
   const normalizedSynthesis = rawSynthesis
     ? {
         ...rawSynthesis,
-        id: options?.cloneIds ? crypto.randomUUID() : rawSynthesis.id,
+        id: options?.cloneIds ? crypto.randomUUID() : (rawSynthesis.id || crypto.randomUUID()),
         name: rawSynthesis.name || "Synthesize findings",
       }
     : undefined;
@@ -257,7 +257,7 @@ function normalizeSwarmSteps(
     id:
       options?.cloneIds && mayorStep
         ? crypto.randomUUID()
-        : (mayorStep?.id ?? crypto.randomUUID()),
+        : (mayorStep?.id || crypto.randomUUID()),
     name: mayorStep?.name || "Mayor plan",
   };
 
@@ -268,7 +268,7 @@ function normalizeSwarmSteps(
 
   const normalizedWorkers = nextWorkers.map((worker, index) => ({
     ...worker,
-    id: options?.cloneIds ? crypto.randomUUID() : worker.id,
+    id: options?.cloneIds ? crypto.randomUUID() : (worker.id || crypto.randomUUID()),
     name: worker.name || `Worker ${index + 1}`,
   }));
 
@@ -277,7 +277,7 @@ function normalizeSwarmSteps(
     id:
       options?.cloneIds && refineryStep
         ? crypto.randomUUID()
-        : (refineryStep?.id ?? crypto.randomUUID()),
+        : (refineryStep?.id || crypto.randomUUID()),
     name: refineryStep?.name || "Refine and merge",
   };
 
@@ -379,37 +379,11 @@ export function WorkflowFormView({
 
   // Handle document picker confirmation
   const handleDocPickerConfirm = useCallback(
-    (ids: string[]) => {
+    (ids: string[], meta: Array<{ id: string; originalName: string; mimeType: string; size: number }>) => {
       setSelectedDocIds(new Set(ids));
-      // Fetch metadata for newly selected docs
-      const newIds = ids.filter(
-        (id) => !selectedDocs.some((d) => d.id === id)
-      );
-      if (newIds.length > 0) {
-        fetch(`/api/documents?projectId=${projectId}&status=ready`)
-          .then((r) => r.json())
-          .then((allDocs: Array<Record<string, unknown>>) => {
-            const idSet = new Set(ids);
-            setSelectedDocs(
-              allDocs
-                .filter((d) => idSet.has(d.id as string))
-                .map((d) => ({
-                  id: d.id as string,
-                  originalName: d.originalName as string,
-                  mimeType: d.mimeType as string,
-                  size: d.size as number,
-                }))
-            );
-          })
-          .catch(() => {});
-      } else {
-        // Remove deselected docs
-        setSelectedDocs((prev) =>
-          prev.filter((d) => ids.includes(d.id))
-        );
-      }
+      setSelectedDocs(meta);
     },
-    [projectId, selectedDocs]
+    []
   );
 
   function removeDocument(id: string) {
@@ -498,7 +472,7 @@ export function WorkflowFormView({
               ? normalizeParallelSteps(def.steps)
               : def.pattern === "swarm"
                 ? normalizeSwarmSteps(def.steps)
-              : def.steps
+              : def.steps.map((s) => ({ ...s, id: s.id || crypto.randomUUID() }))
         );
       }
     }
@@ -1261,6 +1235,8 @@ export function WorkflowFormView({
                   selectedIds={selectedDocIds}
                   onConfirm={handleDocPickerConfirm}
                   groupBy="workflow"
+                  allowCrossProject
+                  selectedDocumentMeta={selectedDocs}
                 />
               </FormSectionCard>
             )}

package/src/components/workflows/workflow-status-view.tsx

@@ -544,7 +544,7 @@ export function WorkflowStatusView({ workflowId }: WorkflowStatusViewProps) {
               ) : (
                 <div className="space-y-3">
                   {data.steps.map((step, index) => (
-                    <div key={step.id} className="flex items-start gap-3">
+                    <div key={`${step.id}-${index}`} className="flex items-start gap-3">
                       <div className="mt-0.5 flex flex-col items-center">
                         {stepStatusIcons[step.state.status] ?? stepStatusIcons.pending}
                         {index < data.steps.length - 1 && (

package/src/instrumentation.ts

@@ -6,5 +6,8 @@ export async function register() {
 
     const { startChannelPoller } = await import("@/lib/channels/poller");
     startChannelPoller();
+
+    const { startAutoBackup } = await import("@/lib/snapshots/auto-backup");
+    startAutoBackup();
   }
 }

package/src/lib/agents/__tests__/claude-agent.test.ts

@@ -32,6 +32,8 @@ const {
     update: vi.fn().mockReturnValue({ set: mockSet }),
     insert: vi.fn().mockReturnValue({ values: mockValues }),
   };
+  // .where() must return a thenable with .all() for both async and sync query patterns
+  mockWhere.mockReturnValue({ then: (fn: (v: unknown[]) => void) => fn([]), all: () => [] });
   mockFrom.mockReturnValue({ where: mockWhere });
   mockSet.mockReturnValue({ where: mockSetWhere });
   mockValues.mockResolvedValue(undefined);
@@ -77,7 +79,8 @@ const {
 });
 
 vi.mock("@/lib/db", () => ({ db: mockDb }));
-vi.mock("@/lib/db/schema", () => ({
+vi.mock("@/lib/db/schema", async (importOriginal) => ({
+  ...(await importOriginal<typeof import("@/lib/db/schema")>()),
   tasks: {
     id: "id",
     status: "status",
@@ -181,6 +184,7 @@ beforeEach(() => {
   vi.resetAllMocks();
   // Re-establish mock chains after clearAllMocks
   mockDb.select.mockReturnValue({ from: mockFrom });
+  mockWhere.mockReturnValue({ then: (fn: (v: unknown[]) => void) => fn([]), all: () => [] });
   mockFrom.mockReturnValue({ where: mockWhere });
   mockDb.update.mockReturnValue({ set: mockSet });
   mockSet.mockReturnValue({ where: mockSetWhere });

package/src/lib/agents/claude-agent.ts

@@ -6,6 +6,7 @@ import { setExecution, removeExecution } from "./execution-manager";
 import { MAX_RESUME_COUNT, DEFAULT_MAX_TURNS, DEFAULT_MAX_BUDGET_USD } from "@/lib/constants/task-status";
 import { getAuthEnv, updateAuthStatus } from "@/lib/settings/auth";
 import { buildDocumentContext } from "@/lib/documents/context-builder";
+import { buildTableContext } from "@/lib/tables/context-builder";
 import {
   buildTaskOutputInstructions,
   prepareTaskOutputDirectory,
@@ -369,6 +370,7 @@ export async function buildTaskQueryContext(
   const profileInstructions = payload?.instructions ?? "";
   const basePrompt = task.description || task.title;
   const docContext = await buildDocumentContext(task.id);
+  const tableContext = await buildTableContext(task.id);
   const outputInstructions = buildTaskOutputInstructions(task.id);
   const learnedCtx = getActiveLearnedContext(profileId);
   const learnedCtxBlock = learnedCtx
@@ -394,7 +396,7 @@ export async function buildTaskQueryContext(
     : "";
 
   // F1: Separate system instructions from user content
-  const systemInstructions = [worktreeNote, profileInstructions, learnedCtxBlock, docContext, outputInstructions]
+  const systemInstructions = [worktreeNote, profileInstructions, learnedCtxBlock, docContext, tableContext, outputInstructions]
     .filter(Boolean)
     .join("\n\n");
 

package/src/lib/agents/profiles/builtins/document-writer/SKILL.md

@@ -14,3 +14,26 @@ You are a technical writer producing clear, well-structured documents.
 - Include a table of contents for documents with 3+ sections
 - Highlight action items or decisions needed in bold
 - If writing from a template, preserve the template's style and structure
+
+## Book Chapter Conventions
+
+When generating AI Native book chapters:
+
+- Preserve existing `> [!authors-note]` blocks unchanged during regeneration
+- Preserve existing `> [!case-study]` blocks — update content only if source material changed
+- Include "Building with Stagent" TypeScript code examples with realistic values
+- Include both "Stagent Today" and "Roadmap Vision" sections
+- Use `> [!case-study]` callout format: name the company, describe their pattern, draw parallel to Stagent
+- Follow the Problem → Solution → Implementation → Lessons narrative arc
+- Target the reading time specified in chapter frontmatter (~250 words/min)
+
+## Originality and Attribution Rules
+
+When writing chapters that reference external case studies (ai-native-notes/ articles):
+
+- **Never copy phrases verbatim** from source articles without quotation marks and explicit attribution
+- **Always credit authors by name** in case-study callouts (e.g., "Geoffrey Huntley" not just "Ralph Wiggum", "Dorsey and Botha" not just "Sequoia")
+- **When structuring content around an external framework** (e.g., 8090's five stations, Block's four pillars), explicitly acknowledge the source: "As [Author] describes in [Work]..." before elaborating
+- **Synthesize from multiple sources** rather than mirroring a single article's structure. If one source dominates a section, bring in at least one additional perspective
+- **Make it Stagent's own**: Every external concept should connect to Stagent's concrete implementation or roadmap. Don't just restate what Stripe/Ramp/Harvey built — explain what Stagent builds differently and why
+- **Use direct quotes sparingly** and only for memorable, well-attributed phrases. The majority of prose should be original analysis

package/src/lib/agents/profiles/builtins/technical-writer/SKILL.md

@@ -29,3 +29,13 @@ Structure documentation according to the type requested:
 - **ADR**: Title, status (proposed/accepted/deprecated/superseded), context, decision, consequences
 - **README**: Title, description, prerequisites, installation, usage, configuration, contributing, license
 - **Changelog**: Version header, date, categorized entries with PR/issue references where available
+- **Book Chapter Review**: Quality pass on AI Native book chapters — terminology consistency, API accuracy, case study attribution, code example quality, section presence, grammar/style. Edit in-place; do not rewrite.
+
+## Originality Checks (Book Chapter Review)
+
+During book chapter quality reviews, specifically check for:
+
+- **Verbatim copying**: Flag any passage >15 words matching source articles in `ai-native-notes/` that lacks quotation marks
+- **Author attribution**: Every case-study callout must name the author (e.g., "Geoffrey Huntley" not "Ralph Wiggum", "Dorsey and Botha" not "Sequoia")
+- **Structural mirroring**: If a chapter follows a source article's exact progression without acknowledgment, flag it and suggest an explicit framing line ("As [Author] traces in [Work]...")
+- **Single-source dependency**: If >50% of a section's ideas come from one source, flag it and suggest multi-source synthesis

package/src/lib/agents/profiles/builtins/technical-writer/profile.yaml

@@ -2,7 +2,7 @@ id: technical-writer
 name: Technical Writer
 version: "1.0.0"
 domain: work
-tags: [documentation, api-docs, adr, readme, changelog, technical-writing]
+tags: [documentation, api-docs, adr, readme, changelog, technical-writing, book-chapter-review]
 supportedRuntimes: [claude-code, openai-codex-app-server, anthropic-direct, openai-direct, ollama]
 preferredRuntime: anthropic-direct
 allowedTools:

package/src/lib/agents/runtime/anthropic-direct.ts

@@ -39,6 +39,11 @@ import {
   recordUsageLedgerEntry,
   resolveUsageActivityType,
 } from "@/lib/usage/ledger";
+import {
+  scanTaskOutputDocuments,
+  prepareTaskOutputDirectory,
+  buildTaskOutputInstructions,
+} from "@/lib/documents/output-scanner";
 
 // ── SDK lazy import ──────────────────────────────────────────────────
 
@@ -283,6 +288,14 @@ async function executeAnthropicDirectTask(taskId: string, isResume = false): Pro
       .where(eq(tasks.id, taskId));
 
     const ctx = await buildTaskQueryContext(task, agentProfileId);
+
+    // Prepare output directory so the agent can write output files
+    if (!isResume) {
+      await prepareTaskOutputDirectory(taskId);
+    }
+    const outputInstructions = buildTaskOutputInstructions(taskId);
+    ctx.systemInstructions = `${ctx.systemInstructions}\n\n${outputInstructions}`;
+
     const apiKey = await getAnthropicApiKey();
     const sdk = await getAnthropicSDK();
     const client = new sdk.default({ apiKey });
@@ -431,6 +444,22 @@ async function executeAnthropicDirectTask(taskId: string, isResume = false): Pro
       timestamp: new Date(),
     });
 
+    // Scan output directory for generated documents
+    try {
+      await scanTaskOutputDocuments(taskId);
+    } catch (error) {
+      await db.insert(agentLogs).values({
+        id: crypto.randomUUID(),
+        taskId,
+        agentType: agentProfileId,
+        event: "output_scan_failed",
+        payload: JSON.stringify({
+          error: error instanceof Error ? error.message : String(error),
+        }),
+        timestamp: new Date(),
+      });
+    }
+
     // Record usage
     await recordUsageLedgerEntry({
       taskId,

package/src/lib/agents/runtime/openai-direct.ts

@@ -39,6 +39,11 @@ import {
   recordUsageLedgerEntry,
   resolveUsageActivityType,
 } from "@/lib/usage/ledger";
+import {
+  scanTaskOutputDocuments,
+  prepareTaskOutputDirectory,
+  buildTaskOutputInstructions,
+} from "@/lib/documents/output-scanner";
 
 // ── SDK lazy import ──────────────────────────────────────────────────
 
@@ -209,6 +214,14 @@ async function executeOpenAIDirectTask(taskId: string, isResume = false): Promis
       .where(eq(tasks.id, taskId));
 
     const ctx = await buildTaskQueryContext(task, agentProfileId);
+
+    // Prepare output directory so the agent can write output files
+    if (!isResume) {
+      await prepareTaskOutputDirectory(taskId);
+    }
+    const outputInstructions = buildTaskOutputInstructions(taskId);
+    ctx.systemInstructions = `${ctx.systemInstructions}\n\n${outputInstructions}`;
+
     const apiKey = await getOpenAIApiKeyValue();
     const sdk = await getOpenAISDK();
     const client = new sdk.default({ apiKey });
@@ -347,6 +360,22 @@ async function executeOpenAIDirectTask(taskId: string, isResume = false): Promis
       timestamp: new Date(),
     });
 
+    // Scan output directory for generated documents
+    try {
+      await scanTaskOutputDocuments(taskId);
+    } catch (error) {
+      await db.insert(agentLogs).values({
+        id: crypto.randomUUID(),
+        taskId,
+        agentType: agentProfileId,
+        event: "output_scan_failed",
+        payload: JSON.stringify({
+          error: error instanceof Error ? error.message : String(error),
+        }),
+        timestamp: new Date(),
+      });
+    }
+
     await recordUsageLedgerEntry({
       taskId,
       workflowId: task.workflowId ?? null,

package/src/lib/book/chapter-generator.ts

@@ -18,6 +18,7 @@ interface ChapterContext {
   relatedJourney: string | undefined;
   currentMarkdown: string | null;
   sourceContents: string[];
+  caseStudyContents: string[];
   strategy: string | null;
 }
 
@@ -50,6 +51,17 @@ export function gatherChapterContext(chapterId: string): ChapterContext {
     }
   }
 
+  // Read case study articles from ai-native-notes/
+  const caseStudySlugs = mapping?.caseStudies ?? [];
+  const caseStudyContents: string[] = [];
+  for (const csSlug of caseStudySlugs) {
+    const csPath = join(appRoot, "ai-native-notes", `${csSlug}.md`);
+    if (existsSync(csPath)) {
+      const content = readFileSync(csPath, "utf-8");
+      caseStudyContents.push(`### Case Study: ${csSlug}\n${content}`);
+    }
+  }
+
   // Read the book strategy document
   const strategyPath = join(appRoot, "ai-native-notes", "ai-native-book-strategy.md");
   const strategy = existsSync(strategyPath)
@@ -69,6 +81,7 @@ export function gatherChapterContext(chapterId: string): ChapterContext {
     relatedJourney: chapter.relatedJourney,
     currentMarkdown,
     sourceContents,
+    caseStudyContents,
     strategy,
   };
 }
@@ -96,10 +109,14 @@ export function buildChapterRegenerationPrompt(chapterId: string): string {
     `${isNew ? "Write" : "Regenerate"} this book chapter following these rules:`,
     "1. **Narrative voice**: Write in first-person plural ('we') with a technical-but-approachable tone",
     "2. **Structure**: Follow the Problem → Solution → Implementation → Lessons pattern",
-    "3. **Code examples**: Include real code snippets from the Stagent codebase with filename comments",
-    "4. **Markdown format**: Use the conventions below for content blocks",
-    "5. **Reading time**: Target approximately " + ctx.readingTime + " minutes",
-    ...(isNew ? [] : ["6. **Preserve Author's Notes**: Keep any existing `> [!authors-note]` blocks unchanged"]),
+    "3. **Code examples**: Include 'Building with Stagent' TypeScript API examples showing how developers use the feature (realistic UUIDs, timestamps, async/await, comments on non-obvious lines)",
+    "4. **Case studies**: Weave 2-4 case study references as `> [!case-study]` callout blocks. Name the company, describe their pattern, draw a parallel to Stagent.",
+    "5. **Stagent sections**: Each chapter must include a 'Stagent Today' section (current implementation) and a 'Roadmap Vision' section (future direction informed by case studies).",
+    "6. **Narrative thread**: Reference the 'machine that builds machines' thesis — how Stagent uses its own capabilities to build/maintain itself.",
+    "7. **Originality**: Never copy phrases verbatim from case study material without quotation marks. Always credit authors by name in callouts. Synthesize from multiple sources rather than mirroring one article's structure. Make content Stagent's own — connect every external concept to Stagent's implementation.",
+    "8. **Markdown format**: Use the conventions below for content blocks",
+    "9. **Reading time**: Target approximately " + ctx.readingTime + " minutes",
+    ...(isNew ? [] : ["10. **Preserve Author's Notes**: Keep any existing `> [!authors-note]` blocks unchanged"]),
     "",
     "## Tools Available",
     "",
@@ -111,7 +128,7 @@ export function buildChapterRegenerationPrompt(chapterId: string): string {
     "",
     "- Sections: `## Section Title`",
     "- Code blocks: ` ```language ` with `<!-- filename: path -->` before the block",
-    "- Callouts: `> [!tip]`, `> [!warning]`, `> [!info]`, `> [!lesson]`, `> [!authors-note]`",
+    "- Callouts: `> [!tip]`, `> [!warning]`, `> [!info]`, `> [!lesson]`, `> [!authors-note]`, `> [!case-study]`",
     "- Interactive links: `[Try: label](href)`",
     "- Images: `![alt](src \"caption\")`",
     "",
@@ -141,6 +158,19 @@ export function buildChapterRegenerationPrompt(chapterId: string): string {
     );
   }
 
+  if (ctx.caseStudyContents.length > 0) {
+    sections.push(
+      "## Case Study Material",
+      "",
+      "Weave these case studies into the narrative as `> [!case-study]` callout blocks.",
+      "Each callout should: name the company, describe their specific pattern, and draw a parallel to the Stagent feature being discussed.",
+      "Do NOT create a separate 'Case Studies' section — integrate them inline where relevant.",
+      "",
+      ...ctx.caseStudyContents.map(c => c.slice(0, 3000)), // Truncate each to manage context
+      ""
+    );
+  }
+
   if (ctx.strategy) {
     sections.push(
       "## Book Strategy Reference",
@@ -179,3 +209,49 @@ export function buildChapterRegenerationPrompt(chapterId: string): string {
   return sections.join("\n");
 }
 
+/**
+ * Build an agent prompt for the technical-writer profile to quality-review
+ * a generated book chapter. This is a post-generation pass for consistency,
+ * accuracy, and style.
+ */
+export function buildChapterQualityPrompt(chapterId: string): string {
+  const ctx = gatherChapterContext(chapterId);
+  if (!ctx.currentMarkdown) {
+    throw new Error(`No chapter content found for ${chapterId} — generate it first`);
+  }
+
+  const sections: string[] = [
+    `# Chapter Quality Review: ${ctx.title}`,
+    "",
+    `Review Chapter ${ctx.chapterNumber}: "${ctx.title}" — ${ctx.subtitle}`,
+    "",
+    "## Review Checklist",
+    "",
+    "1. **Terminology consistency** — verify consistent use of terms across the chapter (e.g., 'agent profile' not 'agent persona', 'workflow' not 'pipeline' when referring to Stagent workflows)",
+    "2. **API accuracy** — read referenced source files to confirm code examples use correct API paths, parameter names, and response shapes",
+    "3. **Case study attribution** — every `> [!case-study]` callout must name the company, author (if known), and approximate date",
+    "4. **Code example quality** — 'Building with Stagent' examples should use realistic values (UUIDs, timestamps), async/await, and brief comments on non-obvious lines",
+    "5. **Section presence** — verify the chapter contains 'Stagent Today' and 'Roadmap Vision' sections",
+    "6. **Grammar and style** — first-person plural voice ('we'), technical but approachable, no marketing fluff",
+    "7. **Reading time** — content should match the target of ~" + ctx.readingTime + " minutes (~250 words/min)",
+    "",
+    "## Tools Available",
+    "",
+    "You have access to **Read**, **Grep**, **Glob**, **Write**, and **Edit** tools.",
+    "- Use **Read** and **Grep** to verify API paths and source code references",
+    "- Use **Edit** to make corrections directly in the chapter file",
+    "",
+    "## Chapter Content",
+    "",
+    "```markdown",
+    ctx.currentMarkdown,
+    "```",
+    "",
+    "## Output",
+    "",
+    `Edit the chapter file at: \`book/chapters/${ctx.slug}.md\``,
+    "Make corrections in-place. Do not rewrite the entire chapter — only fix issues found in the review checklist.",
+  ];
+
+  return sections.join("\n");
+}