Skip to content

feat: add CRUMB Capsules, Relay timeline, and filesystem brain bridge#9

Open
slavazeph-coder wants to merge 10 commits into
mainfrom
feat/capsules-relay-brain-bridge
Open

feat: add CRUMB Capsules, Relay timeline, and filesystem brain bridge#9
slavazeph-coder wants to merge 10 commits into
mainfrom
feat/capsules-relay-brain-bridge

Conversation

@slavazeph-coder

Copy link
Copy Markdown
Contributor

This PR adds the first additive implementation pass for the next public layer of CRUMB:

What landed

  • cli/capsule_tools.py
    • capsule bundle builder
    • dark HTML share card generator
    • markdown preview generator
    • relay timeline scanner for .crumb files
    • simple filesystem brain save/recall bridge
  • capsule_cli.py
    • standalone helper CLI for capsule creation and relay output
  • brain_bridge_cli.py
    • standalone helper CLI for saving crumbs into a workspace-scoped brain directory and recalling them later
  • docs/CAPSULES_RELAY_BRAIN.md
    • design, usage, and next-step docs for the new layer
  • examples/task-launch-crumb-capsules.crumb
    • example task crumb for the capsule product layer

Why this shape

The repo is already strong on structured handoffs and MeTalk compression. This PR adds the next layer without breaking CRUMB v1.1 or forcing a heavyweight backend into the core product.

This keeps the architecture split clean:

  • Brain remembers
  • CRUMB packages
  • Capsules spread

Important note

This PR is intentionally additive.

I did not patch the existing monolithic cli/crumb.py, crumb_cli.py, README.md, or pyproject.toml entrypoints from this session because the available GitHub connector path safely supported file creation for this pass, but not a straightforward high-confidence contents update workflow for the existing large files.

So this lands real code and docs now, while leaving a clear follow-up patch to:

  1. wire capsule and brain bridge into the main crumb CLI
  2. add package entrypoints if desired
  3. fold the docs into the top-level README
  4. add test coverage through the normal local repo workflow

Follow-up patch ideas

  • crumb capsule create
  • crumb relay
  • crumb bridge brain save
  • crumb bridge brain recall
  • browser extension one-click capsule export
  • signed capsule metadata
  • QR/share links

claude and others added 8 commits March 30, 2026 13:41
…n stats

- `crumb compress`: two-stage compression pipeline inspired by Google's
  TurboQuant. Stage 1 (PolarQuant-like) does semantic dedup, Stage 2
  (QJL-like) does signal-scored pruning. Configurable target ratio.
- `crumb bench`: gamified compression scoring — grades crumbs A-F on
  density, compressibility, structure, and conciseness (out of 100).
- `crumb inspect` now shows token cost, content density, keyword density.
- `crumb dream` now reports compression ratio after consolidation.

CLI now at 26 commands.

https://claude.ai/code/session_018rgag4FMarjfsCwLpaRXSZ
- `crumb from-git`: auto-generate task crumb from git history — recent
  commits, changed files, branch context. Instant handoff for any dev
  switching contexts mid-branch.

- CI bench action (.github/workflows/bench-pr.yml): runs `crumb bench`
  on all .crumb files in PRs, posts score table as a comment. Reusable
  workflow + copy-paste template for other repos.

- VS Code extension (vscode-extension/): command palette commands
  (new task, validate, compress, bench, "crumb it"), .crumb syntax
  highlighting, and 5 snippet templates. Ready for marketplace publish.

CLI now at 27 commands.

https://claude.ai/code/session_018rgag4FMarjfsCwLpaRXSZ
* feat: ship MeTalk and PyPI-ready crumb-format 0.2.0

* fix: install crumb-format from checkout in CI workflows

* chore: auto-generate .crumb handoff for PR #3

* fix: use local reusable bench workflow in CI template

* chore: auto-generate .crumb handoff for PR #3

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@github-actions

github-actions Bot commented Apr 9, 2026

Copy link
Copy Markdown
Contributor

CRUMB Bench Results

File Score Grade Tokens Compression
./.crumb N/A - - -
./.crumb/latest.crumb N/A - - -
./crumbs/map.crumb 79/100 B ~269 1.6x
./crumbs/mem.crumb 80/100 B ~225 1.7x
./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-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-launch-crumb-capsules.crumb 82/100 B ~173 1.7x
./examples/task-packed-auth-context.crumb 82/100 B ~233 2.1x
./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 — TurboQuant-inspired context compression

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