Generated from cat-harness/sdlc/processes/bean-open.bpmn by gen-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.

BPMN diagram: Open the bean

How it connects

Lanes — who acts

lanerolewhat it does here
Agent (this session)authoring-agentChecks, creates and claims a bean it may hold. Open_Owner is the one branch this lane cannot finish itself: a bean that turns out to be someone else’s goes to Lane_Sibling, and nothing on it is resolved, scrapped or edited from here.
Sibling session or human (not yours to close)sibling-sessionThe only task here with no cat-harness.processes:bean op: its whole job is to write nothing to a bean it does not own, ending at Open_NotYours so the caller stops rather than works.

Steps

Every one of the 4 step(s) is documented.

steplaneskill / sub-processwhat it does
Check before you create (exact-title search)
Open_CheckExists
Agent (this session)todo-managerSTRICT. beans create is not idempotent: it mints a
fresh 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-managerbeans 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-coordinationNever 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-coordinationIdempotent. 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 calls
this process (check:bean-calls).

Decisions

Every one of the 2 decision(s) is documented.

decisionwhat decides itbranches
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)

folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed dev