Skip to content

feat: BDR hierarchy schema for decade/thread/bead projection#98

Merged
jamestexas merged 2 commits intomainfrom
feat/bdr-schema
Mar 15, 2026
Merged

feat: BDR hierarchy schema for decade/thread/bead projection#98
jamestexas merged 2 commits intomainfrom
feat/bdr-schema

Conversation

@jamestexas
Copy link
Copy Markdown
Contributor

Summary

  • Adds bdr-hierarchy-schema.json to project the full BDR (Bead-Decade-Rosary) decomposition from Dolt as a navigable filesystem
  • decades/ groups beads by source_adr β€” one ADR = one decade, with summary.md overview and deps.mermaid dependency graph
  • threads/ within each decade provides the 8 semantic groupings (context, decision, alternatives, implementation, validation, open-questions, consequences, general)
  • by-channel view projects beads by BDR lattice tier (decade/thread/bead visibility levels)
  • cross-refs view surfaces cross-repo dependency edges via external_ref

Extends bdr-schema.json (flat beads only, mache-85t) with full hierarchy. Mermaid templates connect to mache-ml2. Enables README-as-projection (rosary-82fc59).

bead:mache-8eb3e6

Test plan

  • Mount schema against a repo with BDR-decomposed beads and verify decades/ tree structure
  • Verify summary.md renders readable bead table per decade
  • Verify deps.mermaid renders valid mermaid syntax
  • Verify thread grouping filters match beads with correct thread_group values
  • Verify cross-refs view surfaces beads with external_ref set

πŸ€– Generated with Claude Code

jamestexas and others added 2 commits March 14, 2026 20:30
bdr-schema.json: projects beads from Dolt issues table with BDR lattice
views (by-status, by-type, by-priority, by-repo, threads via external_ref).
Uses refs for cross-reference indexing (status-*, type-*, repo-*, thread-*).

markdown-schema.json: generic markdown projection using tree-sitter-markdown
node types (section/atx_heading, list/list_item, fenced_code_block,
block_quote, pipe_table, html_block). Enables schema-driven decomposition
of any markdown document β€” ADRs, READMEs, changelogs, investigation logs.

Part of BDR (Bead Decision Records) initiative β€” see agentic-research/bdr
ADR-001-harmony-lattice-decomposition.md for full design.

Related beads: mache-85t, rsry-036686

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Project the full BDR decomposition hierarchy from Dolt's issues table:

- decades/ groups beads by source_adr (one ADR = one decade)
- threads/ within each decade for semantic grouping (context, decision,
  implementation, validation, open-questions, consequences, alternatives)
- summary.md content template per decade with bead table + cross-refs
- deps.mermaid content templates (per-decade and global) for dependency
  graph rendering via mache-ml2
- by-channel view for BDR lattice tiers (decade/thread/bead visibility)
- cross-refs view for cross-repo dependency edges via external_ref

Extends existing bdr-schema.json (flat beads only) with full hierarchy.
Enables README-as-projection (rosary-82fc59).

Refs: mache-85t (beads schema with write-back), mache-ml2 (mermaid output)
bead:mache-8eb3e6

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@jamestexas jamestexas merged commit 3bc79bf into main Mar 15, 2026
12 checks passed
@jamestexas jamestexas deleted the feat/bdr-schema branch March 15, 2026 22:24
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