Write comprehensive troubleshooting guide for top 20 failure modes (#603)

* docs: add adapter selection guide + OpenAPI auto-gen script

- docs/ADAPTER_GUIDE.md: comprehensive comparison matrix covering all 19
  adapters (models, reasoning, cost tier, tool support, structured output,
  MCP, recommended use cases) plus decision tree and custom adapter guide
- scripts/generate_openapi.py: regenerates docs/openapi.json from the
  FastAPI app definition without starting the server; updates are picked
  up automatically by the Redoc page at docs/api-reference.html
- docs/openapi-reference.md: updated generation instructions to reference
  the new script

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs: add workflow specs for ENT-003 audit integrity + ENT-004 SOC 2 export

ENT-003: verify_on_startup() exists but is dead code — spec documents
wiring into orchestrator.run() startup sequence, failure modes, and
bulletin posting on integrity violations.

ENT-004: current export is raw JSONL — spec adds SOC 2 control mappings
(CC6.1-CC8.1), evidence summaries, Merkle root attestation, and
structured JSON formatting for auditor consumption.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add BERNSTEIN_NO_TUI to CI and Docker deployment examples

Non-interactive environments (GitHub Actions, GitLab CI, Docker) need
BERNSTEIN_NO_TUI=true to prevent terminal escape codes from polluting logs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* [WIP] architect-747e986d partial work

* docs: fix missing WAITING_FOR_SUBTASKS→BLOCKED transition in LIFECYCLE.md

The Mermaid state diagram and transition table were missing the
`WAITING_FOR_SUBTASKS → BLOCKED` transition (subtask timeout escalation),
which is defined in lifecycle.py line 181. Added it back to match the code.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: chernistry