buchwandler

Quickstart

This is the human operator path. It stops before translation until required policy decisions are approved.

Project-root profile commands use --profile PROFILE. Inside translations/PROFILE/, use . and the validated profile marker resolves the profile.

1. Initialize and extract

booktx init ./demo --source-file ./book.epub --source-lang en
booktx extract ./demo
booktx chapters ./demo --audit

2. Create a profile

booktx profile create ./demo PROFILE \
  --target de --target-locale de-DE --model MODEL
booktx guide ./demo --profile PROFILE

3. Prepare and review context

booktx context init ./demo --profile PROFILE --non-interactive
booktx source analyze ./demo --write --sync-profiles
booktx source interview-plan ./demo --profile PROFILE --write
booktx source interview-next ./demo --profile PROFILE --format markdown
booktx context questionnaire ./demo --profile PROFILE --stdout

Recommendations and questionnaire output are not approval. Show them to the human and wait for an explicit decision.

4. Approve and prepare the agent

booktx context approve ./demo --profile PROFILE Q001 \
  --text "<USER_APPROVED_TEXT>" --approved-by "user:NAME"
booktx context mark-ready ./demo --profile PROFILE
booktx glossary mandate ./demo "Empire" --profile PROFILE \
  --target "Imperium" --forbid "Reich"
booktx agents write ./demo --mode isolated --profile PROFILE

Start the harness inside demo/translations/PROFILE/.

5. Run and build

From the profile root:

booktx guide .
booktx status .
booktx translate next . --unit batch --max-words 800 --format block
booktx translate insert . --task-id TASK --file ingest/TASK.block.txt --format block
booktx check .
booktx validate .
booktx build .

Use booktx translate todo-next and todo-resume for bounded multi-chapter runs. Do not edit the profile store or rendered context directly.

6. Continue with the guides