Skip to content

Add flightdeck demo for one-command quickstart onboarding#56

Open
Gsbreddy wants to merge 1 commit into
mainfrom
cursor/simplify-onboarding-demo-bdd1
Open

Add flightdeck demo for one-command quickstart onboarding#56
Gsbreddy wants to merge 1 commit into
mainfrom
cursor/simplify-onboarding-demo-bdd1

Conversation

@Gsbreddy
Copy link
Copy Markdown
Collaborator

@Gsbreddy Gsbreddy commented May 5, 2026

Summary

Addresses friction feedback (“too many steps”) by shipping a single-command path that runs the full quickstart ledger flow (init → pricing → policy → register → ingest → diff → promote → history) in a disposable temp workspace—no sed or manual fixture paths.

Changes

  • New CLI: flightdeck demo with optional --verify, --doctor, --keep-workspace, --quickstart-root
  • PyPI / wheel: quickstart fixtures are included at build time via Hatch force-include into flightdeck/_bundled_quickstart (so pip install flightdeck-ai + flightdeck demo works without a git checkout)
  • Refactor: shared logic in src/flightdeck/demo_flow.py; quickstart_smoke / CI unchanged in behavior
  • Fixture resolution: FLIGHTDECK_QUICKSTART_ROOT (or --quickstart-root) → repo examples/quickstart → bundled copy
  • Docs: README “Fast start”, DEVELOPMENT.md, docs/cli.md, examples/quickstart/README.md, CHANGELOG.md
  • Tests: tests/test_demo_flow.py

Verification

  • uv run python -m ruff check src tests
  • uv run python -m pytest
  • uv run flightdeck-quickstart-verify
  • uv build (wheel contains _bundled_quickstart assets)
Open in Web Open in Cursor 

Introduce `flightdeck demo` to run the examples/quickstart ledger flow in a
temp workspace without sed or fixture paths. Ship quickstart fixtures in the
wheel via Hatch force-include to `_bundled_quickstart` for PyPI installs.
Refactor quickstart_smoke to share demo_flow helpers; document FLIGHTDECK_QUICKSTART_ROOT.

Co-authored-by: Gottam Sai Bharath <Gsbreddy@users.noreply.github.com>
@cursor
Copy link
Copy Markdown

cursor Bot commented May 5, 2026

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants