Function chapter_prompt

scripts/afml_docs_loop.py:131–174

(
    chapter: str,
    module: str,
    slug: str,
    module_query: str,
    chapter_hit: dict[str, Any],
    module_hit: dict[str, Any],
)

def chapter_prompt(
    chapter: str,
    module: str,
    slug: str,
    module_query: str,
    chapter_hit: dict[str, Any],
    module_hit: dict[str, Any],
) -> str:
    return f"""# Docs Writing Prompt: {chapter} -> {module}

## Scope
- Chapter: `{chapter}`
- Module: `{module}` (`/module/{slug}`)
- Source files:
  - `docs-site/src/data/moduleDocs.ts` (module content)
  - `docs-site/src/pages/modules.astro` (subject/chapter entry point)
  - `docs-site/src/pages/module/[slug].astro` (module page rendering)

## Required AFML grounding
Use AFML MCP retrieval before writing:
1. `afml_search(query=\"{chapter_hit.get('section','')}\", chapter=\"{chapter}\", top_k=3)`
2. `afml_search(query=\"{module_query}\", chapter=\"{chapter}\", top_k=3)`
3. `afml_get_context(query=\"{module_query}\", chapter=\"{chapter}\", top_k=2, window=1)`

Use chunk ids and page ranges in your internal notes.

## Content contract (must be complete)
1. High-level purpose and failure modes.
2. AFML math framing tied to API behavior.
3. Minimum 2 executable Rust examples (realistic, not toy-only).
4. Implementation caveats and production constraints.
5. Cross-links to adjacent modules in same chapter/subject.

## UI/UX contract (not AI slop)
1. Keep typography intentional and consistent.
2. Improve scanability with clear section rhythm and spacing.
3. Avoid generic gradient-heavy cards everywhere.
4. Keep code blocks readable on mobile and desktop.
5. Verify rendered page in Astro before marking complete.

## Current AFML anchors
- Chapter anchor: `{chapter_hit.get('chunk_id','')}` pages {chapter_hit.get('page_start',-1)}-{chapter_hit.get('page_end',-1)} ({chapter_hit.get('section','')})
- Module anchor: `{module_hit.get('chunk_id','')}` pages {module_hit.get('page_start',-1)}-{module_hit.get('page_end',-1)} ({module_hit.get('section','')})
"""


def build_state() -> dict[str, Any]: