Generated from
cat-harness/sdlc/processes/bean-open.bpmnbygen-processes-viz.ts— do not edit here. All processes · cat-harness processes
Open the bean
Process_BeanOpen · strict · 4 step(s)
The opening half of every bean’s life: check before you create, find out whose it is, and claim it before any work starts — or leave it alone when it is someone else’s. Called, never run on its own: the caller is the process about to do the work, and it calls this where the bean becomes its own.
The caller’s own gateway reads which end this reached. Claimed means the bean is in progress and the caller works it; not yours means a sibling holds it, nothing was written, and the caller stops. Process_BeanClose is the other half, called before each end the caller reaches after a claim.
How it connects
- Called by: Drain the beans, Agent bean lifecycle, Code change and review, A refused merge-train member, Test Data Curation — Fixed Sets and Generated Recipes, Test-plan execution, Watching a pinned upstream dependency, Adopting an upstream version bump, Getting started, Authoring a document, Content Change and Review, Content lifecycle, Draft, review and publish, Editing and HCI validation, L1 document ingestion — a document to the L1 source knowledge graph, Data sharing agreement document life cycle, Authoring a paper, DIIG — from a health system bottleneck to a costed implementation plan, L2 DAK authoring
- Calls: none
- Presented on: no docs page section shows this diagram
- Running instances: none recorded
Lanes — who acts
Steps
Every one of the 4 step(s) is documented.
| step | lane | skill / sub-process | what it does |
|---|---|---|---|
Check before you create (exact-title search)Open_CheckExists | Agent (this session) | todo-manager | STRICT. beans create is not idempotent: it mints afresh id every call and dedupes on nothing, so re-entering a step duplicates the plan instead of no-op’ing. In the qou folio an unguarded re-run produced 14,688 duplicate beans — 92% of every open bean — which starved the idle-backlog policy of signal and collided with 15 real ids. |
Create the bean (agent CLI, not an engine op)Open_Create | Agent (this session) | todo-manager | beans create "<title>". This is the AGENT’s call.The workflow engine has no create op — its vocabulary is claim, note,resolve and archive, all of which act on an instance’s existing bean. |
Leave it alone (coordinate instead)Open_LeaveAlone | Sibling session or human (not yours to close) | bean-coordination | Never resolve, scrap or delete a bean another session or a human owns. Claiming is how two sessions avoid picking the same item; closing someone else’s is how one of them loses work it had not finished reporting. |
Claim it (status: in-progress)Open_Claim | Agent (this session) | bean-coordination | Idempotent. Claim BEFORE working, and note the branch, so a sibling session can see the item is taken rather than discovering it by collision. The only claim op in the corpus: every process that claims callsthis process ( check:bean-calls). |
Decisions
Every one of the 2 decision(s) is documented.
| decision | what decides it | branches |
|---|---|---|
Already exists?Open_Exists | Answered by the exact-title check before it (todo-manager §’Check before you create’): beans list --json --search followed by an exact comparison of titles, since --search is fuzzy. no (0 exact matches) creates the bean. yes (1 or more) does not create a second one — beans create mints a fresh id every call and dedupes on nothing — and asks whose the existing bean is. | no → Create the bean (agent CLI, not an engine op) yes → Whose bean? |
Whose bean?Open_Owner | Answered from the existing bean and its surroundings (bean-coordination). someone else's means a sibling is mid-flight on it: a claim naming a branch, a recent note, or an open PR. That bean is left alone and this process ends at Open_NotYours. mine / unclaimed claims it. A claim is branch-local, so check the bean’s status on the store’s tip and the open PRs naming it, not only the copy on your branch. | someone else’s → Leave it alone (coordinate instead) mine / unclaimed → Claim it (status: in-progress) |