anchors report-bug

Report a bug in Anchors itself at github.com/co2-lab/anchors.

When what is wrong is ANCHORS — a command, a gate, the map, a file Anchors seeds —
and not this project's configuration or code, report it where it is fixed for every
project: github.com/co2-lab/anchors. `anchors guide report-bug` says how to tell
the two apart and what to do while the fix does not come.

  anchors report-bug "<what happened>" --expected "<what should happen>" [--repro <file>|-]
  anchors report-bug ... --dry-run      print the issue, send nothing

The issue has the sections of the repository's bug form, with the release and the
platform filled in. An open issue with the same title gets a "seen again" comment
instead of a duplicate.

That repository is PUBLIC. Write in Anchors' terms — the command, the gate, what it did,
what it should do — and a made-up minimal case, never this project's code, names or
data. The command refuses a text that carries the project's path, the home folder or the
project's repository.

Usage

anchors report-bug <what happened> [flags]

Flags

Flag	Default	What it does
--dry-run		print the issue and send nothing
--expected		what should have happened (required)
--repro		a file with the minimal case — made up, not the project’s — or - for standard input
--root	.	project root

The work queue — family

Commands of the same family — what tells each apart:

Command	What it does
anchors next	Pull and claim the next item from the queue (the worker calls this)
anchors queue	List live tasks (the work the watcher queued)
anchors work	Emit the work prompt of a stage (spec|code|feature|test|review) for a target
anchors done	Close claimed task(s) (moves to the .anchors/done/ history)
anchors drop	Discard a task from the queue without completing it (removes; does not archive)
anchors reclaim	Return to the queue the tasks stuck in claimed (dead worker)
anchors deliver	Record the delivery of a stage — the review trigger
anchors decided	Release the card escalate --for-user stopped, once the decision is made
anchors discard	Take off the board the card that no longer makes sense, without deleting it
anchors unblock	Open the work card that unblocks a card stuck in needs-user
anchors escalate	Open the issue for a change needed in the plan or the spec
anchors report-bug	Report a bug in Anchors itself at github.com/co2-lab/anchors
anchors synthesize	Two PRs conflicting in CONTENT become a synthesis card
anchors watch	The background watcher: sees changes and QUEUES work
anchors monitor	Watch the project’s long processes: one line when one starts, stalls, dies or ends
anchors flow	Operate the work flows (the puzzle of actions and results)
anchors board	The project board — published by the pipeline, or served live