Skip to content

v4.0.0 Quality, Safety, and Reliability Update

Latest
Latest

Choose a tag to compare

View all tags
@lowtidebuild lowtidebuild released this 27 Apr 06:06
· 3 commits to main since this release
v4.0.0
1f9d1e2

v4.0.0 Quality, Safety, and Reliability Update

English

This release makes Ebook Writer Agent more reliable for real book production. The biggest change is that many quality checks are now enforced by scripts instead of relying only on agent instructions.

What improved

  • Cleaner final books
    The pipeline now blocks visible production issues such as leftover image markers, failed-image text, broken placeholders, malformed PDFs, and broken web viewer output before final review.

  • More trustworthy writing
    Research claims, citations, and chapter writing are now connected through a structured evidence flow. Chapters are guided by chapter-specific evidence packs instead of repeatedly relying on the full research report.

  • Better outline and resume behavior
    Book outlines are now stored as structured JSON and validated before chapter writing. Pipeline state is also more reliable, making resume, retry, and partial regeneration safer.

  • Safer code example execution
    Runnable code examples now execute in a sandbox. Local process execution requires explicit opt-in, and obvious network access is blocked before running examples.

  • More reliable images
    Text-heavy diagrams now default to deterministic local SVG rendering, reducing dependence on external image providers. Gemini, OpenAI, and Codex image paths remain available as optional overrides.

  • Lower token waste
    Large reference documents are chunked and summarized before agent use. Writers and editors receive smaller, more relevant context instead of repeatedly loading entire research files.

  • Clearer plugin behavior
    Domain plugins are no longer auto-activated just because a plugin folder exists. A plugin is used only when explicitly requested with --plugin.

Behavior changes to know

  • Use --plugin <domain> to activate a domain plugin.
  • Reference files under input/references/ are ignored by git by default.
  • Local code execution requires --allow-unsafe-process.
  • Codex image generation is optional and no longer part of the default path.

Validation

The test suite passes:

75 passed

한국어

이번 릴리스는 Ebook Writer Agent를 실제 책 제작에 더 안정적으로 사용할 수 있도록 만든 품질·안전성 업데이트입니다. 가장 큰 변화는 "에이전트가 잘 따라주길 기대하는 지시"를 줄이고, 실제 스크립트 검증으로 품질을 강제하도록 바꾼 점입니다.

좋아진 점

  • 최종 책 품질 개선
    남은 이미지 마커, 이미지 생성 실패 문구, placeholder, 깨진 PDF, 잘못된 웹 뷰어 같은 독자가 바로 보게 되는 문제를 최종 검토 전에 차단합니다.

  • 더 믿을 수 있는 본문 작성
    리서치 주장, 인용, 챕터 작성 흐름이 구조화되었습니다. 각 챕터는 전체 리서치 보고서를 반복해서 읽는 대신, 해당 챕터에 필요한 근거 묶음을 중심으로 작성됩니다.

  • 목차와 재개 안정성 개선
    목차가 구조화된 JSON으로 저장되고 검증됩니다. 파이프라인 상태 관리도 개선되어 중단 후 재개, 재시도, 일부 챕터 재생성이 더 안전해졌습니다.

  • 코드 예제 실행 안전성 강화
    실행 가능한 코드 예제는 샌드박스에서 검증됩니다. 로컬 process 실행은 명시적으로 허용해야 하며, 네트워크 접근이 의심되는 코드는 실행 전에 차단됩니다.

  • 이미지 파이프라인 안정화
    텍스트가 많은 다이어그램은 기본적으로 로컬 SVG 렌더러를 사용합니다. 외부 이미지 서비스 의존도가 줄었고, Gemini/OpenAI/Codex 경로는 선택 옵션으로 유지됩니다.

  • 토큰 낭비 감소
    큰 참고자료는 chunk와 요약 형태로 처리됩니다. Writer와 Editor는 전체 문서를 반복해서 읽지 않고 필요한 맥락만 받습니다.

  • 플러그인 동작 명확화
    플러그인 폴더가 있다고 자동으로 적용되지 않습니다. 이제 --plugin을 명시한 경우에만 도메인 플러그인이 활성화됩니다.

알아둘 변경 사항

  • 도메인 플러그인을 쓰려면 --plugin <domain>을 명시해야 합니다.
  • input/references/ 아래 참고자료는 기본적으로 git에 포함되지 않습니다.
  • 로컬 코드 실행은 --allow-unsafe-process를 명시해야 합니다.
  • Codex 이미지 생성은 기본 경로가 아니라 선택 옵션입니다.

검증

테스트 결과:

75 passed
Assets 2
Loading