मुख्य अवधारणाएँ

Workspace

Workspace एक project directory है जिसमें .beads/ folder होता है। Database backend SQLite (legacy) या Dolt हो सकता है। हर workspace अपने issues का set independently track करता है, दूसरे projects से अलग।

Beadbox ~/.beadbox/registry.json की registry, आपके last active workspace को track करने वाली cookie, और current working directory में .beads/ folders की scanning से workspaces detect करता है। Header में selector से workspaces switch करें।

Embedded mode में, सारा data local रहता है, बिना किसी account या cloud dependency के। Workspace optionally multi-writer access के लिए remote Dolt server से connect हो सकता है, जिससे push और pull synchronization possible होता है।

Bead

Bead काम की बुनियादी इकाई है: एक issue, task या ticket। हर bead में होता है:

• bd CLI द्वारा assign किया गया unique ID (जैसे bb-a3f2), workspace prefix और base32-encoded suffix से बना
• Title और optional description (markdown supported)
• Status: open, in_progress, blocked, deferred, ready_for_qa, qa_passed, ready_to_ship, या closed
• Priority: P0 (critical) से P4 (backlog) तक
• Type: task, bug, feature, epic, chore, या decision (core types)। molecule और gate जैसे custom types हर workspace के लिए configure किए जा सकते हैं।
• Optional assignee

bd create से bead बनाएँ और bd show से देखें। Beadbox में, tree में किसी bead पर click करके detail panel खोलें।

Epic

Epic एक ऐसा bead है जिसके children हैं। यह related काम को group करता है और overall progress track करता है। Tree view में, epics closed children की संख्या के आधार पर progress bar दिखाते हैं।

--parent pass करके child बनाएँ:

bd create --title="Subtask" --type=task --parent=EPIC-ID

Epics nest हो सकते हैं। Epic का child खुद एक epic हो सकता है जिसके अपने children हों। Tree view इस hierarchy को expand/collapse controls के साथ render करता है।

Dependency

एक bead दूसरे beads को block कर सकता है। जब bead A bead B को block करता है, तो A close होने तक B आगे नहीं बढ़ सकता। Dependencies tree view में blocker badges के रूप में और detail panel में dependency list के रूप में दिखती हैं।

bd dep से dependency set करें:

bd dep BEAD-A --blocks BEAD-B

Beadbox dependency graph draw करता है ताकि आप एक नज़र में देख सकें कि कौन से beads progress block कर रहे हैं।

Comment

हर bead का एक comment thread होता है। Comments agents और humans के bead के बारे में communicate करने का तरीक़ा है: implementation से पहले plans post करना, completion report करना, blockers flag करना, और QA verification steps देना।

CLI से comment add करें:

bd comments add BEAD-ID --author agent-name "PLAN: ..."
bd comments add BEAD-ID --author agent-name "DONE: ..."

Beadbox में, comments detail panel में markdown के रूप में chronologically render होते हैं।

Status Lifecycle

हर bead इस lifecycle को follow करता है:

हर status का Beadbox में एक अलग color badge है। Filter bar से status के हिसाब से beads दिखा या छिपा सकते हैं। Activity Dashboard इन statuses का इस्तेमाल करके beads को pipeline stage के हिसाब से group करता है।