@kentcdodds/lineage

@kentcdodds/lineage

Intent

Give Kent an interactive, commit-level look at countable lines in kentcdodds/kody — not use-kody, which has no application source. The app should ignore generated output even when that output is committed (Wrangler types, lockfiles, generated/ trees, Linguist-generated paths, and @generated / DO NOT EDIT headers), store the series in this package's storage, and stay useful offline as an installable PWA. Success is a graph you can slice by time, language, and type (source / tests / docs), with linked commits and short labels that open a longer narrative.

What it does

• Hosted chart app with cumulative, added/removed, and net-per-commit modes
• Backfill and ingest helpers write commit buckets into packageStorage()
• GitHub push webhook fills new main commits as they land
• Commentary helpers attach short labels and longer narratives to commits
• Status / series / inspect helpers for agents and the UI to share the same numbers

Prerequisites / setup

1. Tracked repo defaults to kentcdodds/kody on main (override via ./settings without republishing).
2. User secret githubLocWebhookSecret — HMAC for the github-push webhook (x-hub-signature-256). Do not paste the secret value in chat.
3. Depends on @kentcdodds/github for GitHub API access used by ingest / backfill.
4. Prefer event-driven webhook ingest; the backfill-missing cron (every 30m, America/Denver) is catch-up only — do not disable live webhooks or jobs.
5. Hosted app: https://kentcdodds.kody.run/packages/lineage
6. Agents: see AGENTS.md for import paths and smoke checks.

Done when

• Hosted app loads and shows a countable series for kentcdodds/kody
• ./status reports stored commits; webhook or backfill fills gaps
• Generated files stay out of countable totals; commentaries open from chart labels