Repository-ready package for deploying and operating a local AI-assisted fiction pipeline with a browser GUI (no microphone/speech recognition):
- Typed/pasted idea intake
- Book Brain Builder (pre-production)
- Dossier Evaluation Squad (validation)
- Auto Book Builder (continuity-safe drafting)
- Refinement, surgical edit, and audio QA loop
MASTER_BOOK_PIPELINE_SYSTEM_SPEC.md: Complete canonical specification.PIPELINE_ARCHITECTURE.md: End-to-end flow and stage responsibilities.frontend/:Auto Book Builder No Microphonelocal browser GUI (typed Codex CLI workflow).skills/: Individual skill contracts.deployment/: Setup, config, schemas, validation, acceptance.operations/: Recovery, versioning, security, maintenance.CONTRIBUTING.md: How collaborators should propose changes.
- Read
MASTER_BOOK_PIPELINE_SYSTEM_SPEC.md. - Follow
deployment/DEPLOYMENT_RUNBOOK.md. - Start
frontend/(npm install && npm run startin that folder). - Validate with
deployment/VALIDATION_AND_ACCEPTANCE.md. - Operate and troubleshoot with
operations/OPERATIONS_AND_RECOVERY.md.
- Node.js 18+ and npm installed.
- Codex CLI installed and authenticated locally.
- Local skill directory present (
/Users/lastresort/codex/skillsby default). - Run and verify:
cd frontendnpm installnpm run start- open
http://127.0.0.1:8787
- Launcher docs:
docs/LOCAL_LAUNCHER_SETUP.md - Start:
./launchers/macos/AutoBookBuilder.command - App launcher:
launchers/macos/AutoBookBuilderLauncher.app(Launchpad-friendly; launches the no-microphone app variant in this repo) - Stop:
./launchers/macos/StopAutoBookBuilder.command - Status:
./scripts/status-autobook.sh - Rebuild app bundle:
./scripts/build-macos-launcher-app.sh
First-time setup:
chmod +x scripts/*.sh launchers/macos/*.command
- No-code / low-code operators using Codex/Claude Code-style agents.
- Technical collaborators implementing or maintaining pipeline behavior.
The local project filesystem and artifact contracts in deployment/ARTIFACT_SCHEMAS.md are authoritative.