anchors watch

The background watcher: sees changes and QUEUES work.

The watcher (PROPAGATION §6) observes the repo and, for each file that changes,
classifies the change and QUEUES a task in .anchors/tasks/ (with the suggested next
step). It does NOT execute nor call AI — whoever works pulls the task with 'anchors
next'. That is the inversion: the watcher only turns "it changed" into "there is work".

Runs in the BACKGROUND — the terminal stays free. Control it with the subcommands:
  anchors watch start    starts the watcher (daemonizes, returns the terminal)
  anchors watch status   is it running? since when? paused?
  anchors watch stop     shuts it down
  anchors watch pause    pauses (stops reacting, without shutting down)
  anchors watch resume   resumes
  anchors watch logs     shows what the watcher reported

Usage

anchors watch

Subcommands

`anchors watch logs`

Show the watcher log.

Usage

anchors watch logs [flags]

Flags

Flag	Default	What it does
`--root`	`.`	project root

`anchors watch pause`

Pause the watcher (without shutting it down).

Usage

anchors watch pause [flags]

Flags

Flag	Default	What it does
`--root`	`.`	project root

`anchors watch resume`

Resume the paused watcher.

Usage

anchors watch resume [flags]

Flags

Flag	Default	What it does
`--root`	`.`	project root

`anchors watch start`

Start the watcher in the background.

Usage

anchors watch start [flags]

Flags

Flag	Default	What it does
`--root`	`.`	project root

`anchors watch status`

Watcher state.

Usage

anchors watch status [flags]

Flags

Flag	Default	What it does
`--root`	`.`	project root

`anchors watch stop`

Shut down the watcher.

Usage

anchors watch stop [flags]

Flags

Flag	Default	What it does
`--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