12 November 2026
Compass 0.9.1: Stories, a funnel and a health check for the demo
A Compass demo now meets a visitor where the ad sent them: a story on the landing URL puts the step the ad promised first, the source travels with the visitor to the pilot page, and the operator sees the funnel by source and story in Settings. A public health URL says whether a visitor arriving now gets the demo. And a job's events are bounded, so one oversized item no longer takes the install down.
A story on the landing URL
Arrive with ?story=drift, ?story=honeytoken or ?story=cost on any page and the seven tour steps come in the order that story wants: drift starts on the IaC tab and the import pull request, honeytoken on the decoys, the trip and the response. ?src= and ?gclid= ride along, survive the sign-in round trip and are written once on the visitor's tour; the first landing wins.
?story=honeytoken&src=linkedin
The pilot exit
Set demo.links.pilot to your pilot page and every pull-request step says what it would be on the visitor's own account (1 of 10 free pilot pull requests), the panel's footer and the last step link to the page, and the link carries src=demo, the story, the gclid and the original source, so the page knows which ad the application came from without a cookie. Empty hides all of it.
"demo": {"links": {"pilot": "https://<your site>/pilot"}}
The funnel
Every exit the tour offers posts an event: the pilot link, the install page, the repository. The funnel counts the visitors of the last 7, 30 or 90 days by source and story: the steps they reached, the pull requests, the pilot clicks. Nobody is named. It is the Demo funnel card at the top of Settings, for the operator alone, and compass demo funnel in the terminal.
compass demo funnel days=30
Is the demo up, for a visitor arriving now?
GET /healthz/visitor is public and says nothing but up or down: 200 while a visitor arriving now gets the demo the ads promise, 503 naming the failing checks: the tour computes, a visitor's pull request within 24 hours, nothing queued longer than 15 minutes, the model budget has room, and your product's own checks. Poll it from the campaign and pause the ads after two failures.
curl -i https://<demo>/healthz/visitor
Your own steps and checks
A product built on Compass adds a tour step with register_tour_step(spec, fact): the same keys as the core's steps and a fact that says whether it is done. A story may name the step; where nobody registered it, it drops out, and a fact that raises is a step not done, never a tour that fails. register_health_check adds a check to the health URL the same way.
compass_core.demo.register_tour_step(spec, fact)
A job's events are bounded
A job keeps its first event and its latest 199. Before this, a job a scheduler touched every tick grew past DynamoDB's 400 KB item limit, and the refusal switched the whole process to the local store, where the bootstrap, the inbox and every later enqueue returned 500 until a restart. A refused item is now logged as that item's problem, and the table stays.
Three demo fixes
The import form puts demo.visitor_repo first and skips synthetic nodes, so a visitor's first pull request goes to a repository that exists. The Maps tab waits for the settings bootstrap before asking for nodes, so a visitor gets the demo's node budget rather than the default. And the dashboard asks for the jobs list only once it knows whose dashboard this is, instead of being refused on every poll.
The README, rewritten
What Compass is and what it is not, an FAQ, and the open-source and enterprise roadmap, with the six open captains as they stand. Two new documents: docs/honeytokens.md on the decoys and docs/iac_coverage.md on what the map counts as covered. The README links the canary-credential, autonomous DevOps, autonomous CloudOps and IaC coverage guides on beamreach.ai.
After the update
- An install that runs a demo and wants the public health URL fetches the new nginx.conf once: it passes /healthz/visitor to the API without sign-in. Everything else in the install stays as it is.
- In a demo, set demo.links.pilot in the workspace config to show the pilot line and the pilot exit; the funnel starts counting from this release, so the Demo funnel card is empty until visitors arrive.
Compass is open source (Apache-2.0).
Code, changelog and issues: github.com/beamreach-ai/compass. Already running it? The update card on Settings → Updates shows these notes before you update.
Beamreach