Install referral telemetry, README positioning, installer shim - #6
Merged
Conversation
The website installer records a first-touch referral slug to ~/.polylane/ref
(from polylane.com/install?ref=…). Telemetry reads it, validates it against
^[a-zA-Z0-9._-]{1,64}$, and sends it as the optional cli.ref field beside
installSource, so installs are attributable to the surface that produced
them (directory listing, landing page, README). Missing or invalid refs are
silently omitted; the read is cached and can never break a command.
PRIVACY.md and `polylane telemetry status` document the new field.
README: adds the channel positioning line ("Your coding agent writes the
code. It can't see production. Polylane is the missing sense."), the
`npx skills add coreplanelabs/cli` path, and fixes "anomalies" to
"detections" per the product-wide rename.
install/install.sh becomes a delegating shim: the authoritative installer
lives on the website at polylane.com/install; this file only keeps old
links and raw fetches working (env vars and flags pass through, fetch
failures are fatal rather than piping nothing into bash).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
cli.reftelemetry field: reads~/.polylane/ref(written by the website installer frompolylane.com/install?ref=…), validates^[a-zA-Z0-9._-]{1,64}$, sends it besideinstallSourceso installs are attributable to the surface that produced them. Silently omitted when missing/invalid; cached read, can never break a command. PRIVACY.md andpolylane telemetry statusupdated to keep the inventory truthful. Receiver-side schema + WAE blob land in the nominal PR.npx skills add coreplanelabs/cliin the setup section, "anomalies" → "detections" per the rename.polylane.com/install(env/flags pass through; fetch failure is fatal instead of piping nothing into bash).install.ps1deliberately untouched — it is the live upstream for the site's/install.ps1proxy.Test plan
npm test117/117, lint clean,npm run buildclean (417 KB bundle)"cli": {…, "ref": "gh-readme"}; invalid → field omitted🤖 Generated with Claude Code