Repository navigation
v0.2.8
Added
- AST segment translation as the default markdown body path: prose mdast segments, link labels, and
policysegments (fence comments and MDX string attributes) are batched via structuredsegmentBatchLLM calls with offset reinsert; parse failures or batch errors fall back to full-body translation. translator-segment-batch.schema.ts,callLanguageModelSegmentBatch, andsegmentBatchsystem prompt kind onTranslationLlmClient.- Segment helpers:
segment-translation.util.ts(eligibility),segment-batch.util.ts(token-aware packing and batch split on truncation). @react-docs-fixtures/*path alias andtests/fixtures/react-docs-fixtures.tsbarrel for react.dev markdown fixtures imported as UTF-8 text.- Opaque
sNkeys in segment-batch LLM payloads (segment-batch-opaque-id.util.ts); mdast paths are remapped before reinsert. - Partial follow-up for drop-only segment batch failures (retry missing ids only, up to 3 rounds).
SEGMENT_BATCH_MAX_ITEMS_PER_BATCH(55) cap inpackSegmentsIntoBatches.
Changed
- CI runs
bun run test:coverage;bunfig.tomlexcludes test files and CLI entrypoints from coverage totals. - Maintainer remediation triggers on unresolved
CHANGES_REQUESTEDpull request reviews (members, owners, collaborators, and contributors) submitted after the latest runner commit; PR conversation comments no longer invalidate open PRs. Review summaries and inline review comments from those reviews feed the remediation prompt; null review bodies from the API are treated as empty instead of aborting the run. - Segment batch failures split the batch or retry segments individually before full-body fallback; mismatch and truncation logs include id diagnostics and token context.
- remark/mdast stack promoted from devDependencies to runtime dependencies.
- Translation PR bodies: human-review notice as the opening paragraph; maintainer wiki link in a
[!TIP]callout; advisory warnings grouped by validator in<details>with per-violation diff blocks and fenced-code line ranges. - Verbatim fence masking applies only to the legacy full-body fallback path.
@deprecatedJSDoc on legacy full-body APIs used only by fallback:extractSegments,buildMarkdownDocumentSystemPrompt,translateWithChunking.
Fixed
- Segment extraction uses the unmasked document body so
MASK_VERBATIM_LARGE_FENCESplaceholders no longer force MDX-heavy pages onto the legacy path.
Removed
- Spike-only segment modules (
spike-writeup,integration-analysis,tooling-eval, corpus table utilities) and their production barrel exports.
What's Changed
- feat(translator): spike AST-based translatable segment extraction by @NivaldoFarias in #60
- default AST segment translation with legacy fallback by @NivaldoFarias in #61
- release
0.2.8by @NivaldoFarias in #62
Full Changelog: v0.2.7...v0.2.8