Skip to content

docs(readme): refresh stale Dogfood metrics + bundle sizes#126

Merged
fedorovvvv merged 2 commits into
developfrom
docs/refresh-metrics
May 9, 2026
Merged

docs(readme): refresh stale Dogfood metrics + bundle sizes#126
fedorovvvv merged 2 commits into
developfrom
docs/refresh-metrics

Conversation

@fedorovvvv
Copy link
Copy Markdown
Collaborator

Summary

Sweep stale numeric claims in both READMEs to match the current
post-PRD-030 / post-PR #125 reality.

What changed (verbatim numbers)

Claim Before After Source of truth
Per-image bundle size ~1.8 MB ~1.4 MB `scripts/build.mjs` post-build report (`[build] dist/ ready (1.40M)`) after PR #125
Dogfood — bin LOC ~200 LOC removed — ADR-003 split bin/ across `cli.mjs` + `commands/` + `lib/`; entry shim is 5 lines, real total ~1.3K across 11 files `wc -l bin/**/*.mjs`
Dogfood — runtime deps in `bin/` 0 1 (`citty`, 0 transitive) ADR-003 (amended named-allowlist), `package.json#dependencies`
Dogfood — tarball ~6 MB with bundled `node_modules` ~870 kB packed / ~3 MB unpacked `npm pack --dry-run` (post-PRD-030 single-file bundle, no `node_modules/` in tarball)
Dogfood — CI matrix `3 OS in CI` `3 OS × Node 22` green smoke matrix `.github/workflows/*`
`npm run dev` artifact count comment (~11 artifacts) (100+ artifacts) `forgeplan health` — 99 on develop, anti-drift framing

Why

The previous numbers were accurate at the time they were written but
drifted as PRD-030 graduated the bundle approach, ADR-003 amended the
zero-dep rule to allow `citty`, and PR #125 dropped the precompressed
siblings. Anyone reading the README today would have a wrong mental
model of size, deps, and dogfood scale.

Test plan

  • `grep -nE "1\.8 MB |6 МБ|~200|~11" README.md README.ru.md` returns no hits.
  • Both READMEs render in GitHub markdown preview (table cells, no broken refs).
  • No content-equivalent claims out of sync between EN and RU.
  • Numbers match current local measurements (`du -sh dist*`, `npm pack --dry-run`, `forgeplan health`).

Refs: PRD-030, PR #125, ADR-003.

fedorovvvv and others added 2 commits May 9, 2026 15:49
Sweep stale numbers to match post-PRD-030 / post-PR-125 reality:

- "~1.8 MB single-file bundle" → "~1.4 MB" (matches `[build] dist/
  ready (1.40M)` after #125 drops precompressed siblings).
- Dogfood card row reframed:
  · drop "~200 LOC" (entry shim is now 5 lines after ADR-003 split,
    real work spans ~1.3K across `bin/{cli,commands,lib}/*`)
  · drop "0 runtime deps" (ADR-003 amended to a named-allowlist —
    `citty` is the one allowed runtime dep, with 0 transitives)
  · drop "~6 MB tarball with bundled node_modules" (PRD-030 graduated
    the legacy SvelteKit-with-`node_modules/` shape; current local
    pack is ~870 kB / ~3 MB unpacked)
  · lead with what users actually care about (per-image size + tarball
    weight) instead of LOC bragging
- "(~11 artifacts)" in `npm run dev` comment → "100+" (avoids drift;
  current `forgeplan health` reports 99 artifacts on develop).

Mirrors apply to both README.md and README.ru.md.

Refs: PRD-030, PR #125, ADR-003.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@fedorovvvv fedorovvvv enabled auto-merge May 9, 2026 11:52
@fedorovvvv fedorovvvv merged commit e986e42 into develop May 9, 2026
3 checks passed
@fedorovvvv fedorovvvv deleted the docs/refresh-metrics branch May 9, 2026 11:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant