Skip to content

docs: refresh README banner and fix stale counts#13

Draft
slavazeph-coder wants to merge 4 commits into
mainfrom
claude/update-readme-screenshot-hGuij
Draft

docs: refresh README banner and fix stale counts#13
slavazeph-coder wants to merge 4 commits into
mainfrom
claude/update-readme-screenshot-hGuij

Conversation

@slavazeph-coder

Copy link
Copy Markdown
Contributor

Summary

The README banner (docs/assets/crumb-banner.svg) was last updated at v0.2.0, so it still advertised "CRUMB 0.2.0" and "41 commands" while the repo is on v0.4.0 / v=1.2 with 44 CLI commands — which made the hero image read as missing/stale. Fixed that and swept the rest of the README for the same drift.

  • Refresh docs/assets/crumb-banner.svg: 0.2.00.4.0, add a wire format v=1.2 callout, bump the command badge to 44, and show a v1.2 CRUMB on the banner (refs + fold + handoff) so the image matches what the README now advertises.
  • README: update three stale command counts (41 / 41+ → 44).
  • README: update the "crumb it" cheat sheet default to v=1.2 (with a note that v=1.1 is still valid — v1.1 parsers accept v1.2).
  • README: correct "Five kinds" → "Six kinds" to include wake per SPEC.md §4.6.

No functional code changes — docs + image only.

Test plan

  • Confirm the updated SVG renders on the rendered README tab on GitHub
  • Verify the command-count text (44) matches cmd_* functions in cli/crumb.py
  • Verify the six kinds list matches SPEC.md §4.1–§4.6

claude and others added 2 commits April 15, 2026 17:03
- Update docs/assets/crumb-banner.svg from 0.2.0 → 0.4.0, add v=1.2
  wire-format callout, and swap the "41 commands" badge for 44.
- Show a v1.2 CRUMB on the banner (refs, fold, handoff) so the image
  reflects what the README now advertises.
- README: 41 / 41+ command counts → 44 (three places), and update the
  "crumb it" cheat sheet default to v=1.2 (v=1.1 noted as still valid).
- Correct "Five kinds" → "Six kinds" to include `wake` per SPEC §4.6.
@github-actions

github-actions Bot commented Apr 15, 2026

Copy link
Copy Markdown
Contributor

CRUMB Bench Results

File Score Grade Tokens Compression
./.crumb N/A - - -
./.crumb/latest.crumb N/A - - -
./CODEX_HANDOFF_0.4.0.crumb N/A - - -
./crumbs/map.crumb 79/100 B ~269 1.6x
./crumbs/mem.crumb 80/100 B ~225 1.7x
./examples/log-deployment.crumb 84/100 B ~147 2.0x
./examples/map-client-takeover.crumb 78/100 B ~290 1.6x
./examples/map-repo-onboarding.crumb 82/100 B ~166 1.7x
./examples/mem-mempalace-auth-migration.crumb 87/100 A ~120 2.5x
./examples/mem-terse-output.crumb 77/100 B ~336 1.6x
./examples/mem-user-preferences.crumb 83/100 B ~135 1.8x
./examples/task-bug-fix.crumb 83/100 B ~127 1.7x
./examples/task-content-repurpose-handoff.crumb 80/100 B ~250 1.7x
./examples/task-cross-tool-feature-handoff.crumb 79/100 B ~249 1.6x
./examples/task-feature-continuation.crumb 82/100 B ~134 1.7x
./examples/task-packed-auth-context.crumb 82/100 B ~233 2.1x
./examples/todo-sprint.crumb 84/100 B ~90 1.7x
./examples/v12-fold.crumb N/A - - -
./examples/v12-handoff.crumb N/A - - -
./examples/v12-refs.crumb N/A - - -
./examples/v12-typed-content.crumb N/A - - -
./examples/wake-session.crumb N/A - - -
./fixtures/extensions/mempalace-export.crumb 86/100 A ~102 2.3x
./fixtures/extensions/task-packed.crumb 85/100 B ~157 2.3x
./fixtures/invalid/bad-kind.crumb N/A - - -
./fixtures/invalid/missing-source.crumb N/A - - -
./fixtures/valid/log-basic.crumb 82/100 B ~51 1.4x
./fixtures/valid/mem-basic.crumb 81/100 B ~42 1.2x
./fixtures/valid/task-basic.crumb 81/100 B ~65 1.2x

Powered by crumb-format — two-stage context compression

@github-actions

Copy link
Copy Markdown
Contributor

✅ Shadow AI Scan

No Shadow AI findings detected at or above medium risk.

claude and others added 2 commits April 15, 2026 17:10
Two related fixes so `bench-pr.yml` stops reporting N/A for legitimate
CRUMBs on this repo's own PRs:

1. `pip install .` when running on a checkout of crumb-format itself
   (detected via pyproject.toml `name = "crumb-format"`), otherwise fall
   back to `pip install crumb-format` for the reusable workflow_call
   path. Before this, PRs that bump the wire format (e.g. 0.4.0 → v=1.2)
   were benched against the last-published PyPI version (0.3.0), which
   rejects v=1.2 and yields `N/A` for every v1.2 example.

2. Add `-type f` to the `find` invocation. The `.crumb/` session-state
   directory matched `*.crumb` and was benched as a file, producing an
   IsADirectoryError and a noisy `N/A` row. Mirror the change into the
   self-contained template for consistency.
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.

2 participants