Repository navigation
feat(roadmap): define launch success metrics baseline + 90-day targets - #412
Merged
Merged
Conversation
Issue #100: the site had no defined success metrics for the KubeCon NA 2026 launch. Add data/launch-metrics.json (issue #100), a machine-collected and validated baseline for 5 signals: GitHub stars, watchers, forks, new unique human contributors since baseline, and good-first-issues claimed, each with a live-collected baseline and a 90-day post-launch target. - scripts/collect-launch-metrics.mjs fetches live data from the GitHub API and writes data/launch-metrics.json, following the same generated/never-hand-edited pattern as data/metrics.json. - scripts/validate-launch-metrics.mjs validates signal count, provenance, and that baseline/target values are sane non-negative integers with target90Day >= baseline; wired into the read-only validator suite. - The contributor signal is defined as a delta (new contributors since this baseline snapshot) rather than a raw cumulative count, since the repo's pre-launch history already has 45 human contributors -- a cumulative count can never sit below a small post-launch target. - ROADMAP.md and LAUNCH.md now point at this file as the source of truth instead of a hand-written table, and flag the committed baseline as a rehearsal capture to be refreshed at (or after) the W-6 pre-launch checkpoint (2026-09-28) so the numbers reflect that checkpoint rather than an earlier snapshot Phase 1 work has since made stale. Signed-off-by: mrbobbytables <mrbobbytables@users.noreply.github.com>
castrojo
reviewed
Sep 21, 2026
castrojo
left a comment
Member
There was a problem hiding this comment.
Substantive review:
- Adds launch success metrics tracking (data/launch-metrics.json, scripts/collect-launch-metrics.mjs, scripts/validate-launch-metrics.mjs) for KubeCon NA 2026 launch.
- Provides test coverage in tests/validate-launch-metrics.test.mjs.
- CI is green across all checks.
- Awaiting second/independent maintainer review before merge.
This was referenced Sep 21, 2026
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
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.
Closes #100.
The site had no defined success metrics for the KubeCon NA 2026 launch: no baseline, no targets, so an announcement post going out is unfalsifiable — there's no way to know whether it worked.
What this adds
data/launch-metrics.json: 5 signals, each with a live-collectedbaselineand atarget90Day: GitHub stars, GitHub watchers, GitHub forks, new unique human contributors since baseline, and good-first-issues claimed.scripts/collect-launch-metrics.mjs: fetches live data from the GitHub API and writes the file above, following the samegenerated: true/ never-hand-edited pattern asdata/metrics.json. Wired asnpm run collect:launch-metrics.scripts/validate-launch-metrics.mjs: validates 3-5 signals, unique ids, required provenance (sourceUrl/collectedAt), and thatbaseline/target90Dayare finite non-negative integers withtarget90Day >= baseline. Wired asnpm run validate:launch-metrics, added to the read-only validator suite (tests/validators-smoke.test.mjs), and covered bytests/validate-launch-metrics.test.mjs(16 tests).ROADMAP.mdandLAUNCH.mdnow point at this file as the source of truth for the launch success-metrics bullet, replacing a hand-written, already-stale table.Why the contributor signal is a delta, not a raw count
This repo's pre-launch history already has 45 human contributors (
git log/GitHub contributors API), so a raw cumulative "unique contributors" count can never sit below a small post-launch target — that was true of the number already inLAUNCH.mdbefore this PR (baseline 1, target 5), and it doesn't hold up against the real API data. Instead, the signal is "new unique human contributors since this baseline snapshot": the file recordspriorContributorLoginsat capture time, baseline is 0 by definition, and the 90-day re-measurement counts logins present then but absent from that list.Why the baseline is flagged as a rehearsal capture
A previous attempt at this issue (#143) was closed as stale because it froze a months-old (2026-08-08) baseline that conflicted with the launch plan's own W-6 pre-launch-checkpoint timing (2026-09-28, per
LAUNCH.md). This PR avoids repeating that: the committeddata/launch-metrics.jsonis live data captured today, but itscheckpointfield and theROADMAP.md/LAUNCH.mdprose both say explicitly to re-runnpm run collect:launch-metricsat (or after) 2026-09-28 before treating the numbers as the final pre-launch baseline for the 90-day comparison.Verification
npm run test:unit— 501/501 passing (16 new tests intests/validate-launch-metrics.test.mjs)node scripts/validate-launch-metrics.mjs— passesnode scripts/collect-launch-metrics.mjs(withGH_TOKEN) — regenerates the committed file byte-for-byte modulo timestampsnpm run build— succeedsnpx prettier --checkon all touched non-markdown files — passes (the touched.mdfiles have pre-existing prettier warnings unrelated to this change)— hive: backend=copilot model=claude-sonnet-5
🐝 Hive Agent:
contributor| SHA:0d81477