Bountystash
===========

Turn messy technical asks into structured, reviewable work items across browser, terminal, and agent-friendly surfaces.

Current capabilities
--------------------
- Capture intake and normalize into stable packet fields for bounty, rfq, rfp, and private_security work.
- Persist immutable work versions with exact and quotient hashes plus append-only backend events.
- Expose reviewer queue and history views, with additive JSON API routes for tooling.

Useful routes
-------------
- / - landing page with featured examples, recent activity preview, and intake form
- /review - reviewer queue with private security separated
- /history - system-wide recent event ledger
- /work/{id} - persisted work detail when you already have a work item ID
- /examples/auth-loop - seeded example packet
- /examples/webhook-rfq - seeded example packet
- /examples/pipeline-rfp - seeded example packet

Useful API endpoints
--------------------
/api/* routes stay JSON for machine use; non-API routes default to readable output for non-browser clients.
- /api/examples - seeded examples as JSON
- /api/examples/{slug} - one seeded example as JSON
- /api/review - review queue as JSON
- /api/work - recent work items as JSON
- /api/work/{id} - one persisted work item as JSON
- /api/events/recent - recent backend events as JSON
- /api/draft - create a draft from JSON

Format overrides
----------------
- ?format=html - force browser HTML on a human-facing route
- ?format=md - force markdown output on a human-facing route
- ?format=text - force plain text output on a human-facing route

Next step
---------
Discovery: /.well-known/bountystash-manifest
Start with /examples/auth-loop for a safe sample, or move to /api/examples when you need structured JSON immediately.