Skip to content

Improve fixture-mode first run flow#89

Open
jmcte wants to merge 1 commit into
mainfrom
codex/issue-84-first-run
Open

Improve fixture-mode first run flow#89
jmcte wants to merge 1 commit into
mainfrom
codex/issue-84-first-run

Conversation

@jmcte
Copy link
Copy Markdown
Contributor

@jmcte jmcte commented May 23, 2026

Summary

  • add a fixture-mode quickstart and link it from README
  • add mpi seed --from-fixtures to populate a persistent SQLite DB, index fixture metadata, and enqueue deterministic candidates
  • add mpi --version, :memory: persistence warnings, and friendly one-line errors for missing fixture paths / bad DB paths
  • add doctor next_step guidance in text and JSON output
  • cover seed/search/queue, version, warning, and error paths in CLI tests

Verification

  • PYTHONPATH=src python3.12 -m unittest discover -s tests -p 'test_cli.py' -v
  • PYTHONPATH=src python3.12 -m unittest discover -s tests -p 'test_doctor.py' -v
  • bash scripts/ci/run-fast-checks.sh

Closes #84.

@jmcte jmcte requested a review from pheidon as a code owner May 23, 2026 15:58
@athena-omt athena-omt added area:ai AI/model/agent behavior surface. lane:daedalus Daedalus implementation/forge lane. review:athena Athena review governance requested. risk:medium Medium-risk change; normal care required. state:waiting-checks Waiting for CI/check status to settle. status:needs-review PR is ready for Athena review. labels May 23, 2026
@pheidon pheidon removed the lane:daedalus Daedalus implementation/forge lane. label May 23, 2026
Copy link
Copy Markdown

@pheidon pheidon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved from Pheidon second-pass review. I found no code-level blocker in the fixture-mode first-run flow, no unresolved review comments, and local fast checks passed (126 tests). Merge should still wait for required GitHub CI to complete.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:ai AI/model/agent behavior surface. review:athena Athena review governance requested. risk:medium Medium-risk change; normal care required. state:waiting-checks Waiting for CI/check status to settle. status:needs-review PR is ready for Athena review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

R3: First-run experience — quickstart, friendly doctor, CLI error paths

3 participants