Files
mesh-delivery/modules/mesh-delivery-watchman/module.json
T
jschoubben f6163349af W1: the watchman reads the H1 take-in, the mover's entry and the want
The watchman follows the one model in one pass. Its take-in waits are the seat's take-in.pending
and take-in.taken, keyed <branch>.<source>, timed from the message's own time by the setting
take-in-bound (60 minutes by default), and seeded from indexer_pending's held take-ins; the group
bound goes. A taken-in mover's bus state is read from its catalog entry by fingerprint through
the seat mesh-catalog's verb entry, bus-state-overdue timed from the take-in. The manifest
verdicts and their findings, the head timing of source-moved, acting-part-late and
delivery-waits go, with their readers, consumes and the indexer_verdicts invoke. A want awaiting
its hand placement is not timed, and the want readers follow the H1 want. A record-opened is
heard on record-opened.<call>.

Builds: design 47 H §741, §744, §764 (the indexer: manifest-refused, manifest-accepted, the
watchman's findings; the assigner: acting-part-late, delivery-waits), §772; lead answers H-A-25,
H-A-37, H-A-49, H-A-70, H-A-78 (2), H-A-79, H-A-91 (2), H-A-94, H-A-95 (1), H-A-97, H-A-102

Claude-Session: https://claude.ai/code/session_01JG73KHUnBze48rdua8u2sy
2026-11-20 04:05:11 +01:00

211 lines
5.0 KiB
JSON

{
"module": "mesh-delivery-watchman",
"version": "0.1",
"slug": "watchman",
"claims": [
{
"name": "mesh-watchdogs",
"scope": "mesh",
"serves": [
"signals",
"stuck",
"presence",
"dead-letters",
"resync"
]
}
],
"reads": [
"mesh-provisioner.provisions"
],
"invokes": [
"mesh-delivery-indexer.indexer_pending",
"seat:mesh-hand-acts.hand-act",
"seat:mesh-conditions.conditions",
"seat:mesh-broker.show",
"seat:mesh-catalog.revision",
"seat:mesh-catalog.registrations",
"seat:mesh-catalog.entry",
"seat:mesh-delivery.source",
"seat:mesh-pipeline-runner.stands"
],
"consumes": [
"seat:mesh-wants.views.wants",
"seat:mesh-module-assigner.views.seat-holders",
"mesh-catalog.registration-changed",
"mesh-catalog.catalog-revision",
"mesh-delivery-indexer.take-in.pending",
"mesh-delivery-indexer.take-in.taken",
"mesh-delivery.source-moved",
"mesh-delivery.filling",
"mesh-delivery.full",
"mesh-delivery.room",
"mesh-delivery.record-opened",
"mesh-delivery.record-ended",
"mesh-catalog.filling",
"mesh-catalog.full",
"mesh-catalog.room",
"mesh-wants.filling",
"mesh-wants.full",
"mesh-wants.room",
"mesh-grants.filling",
"mesh-grants.full",
"mesh-grants.room",
"node-build-go.ask-taken",
"node-build-go.step-progress",
"node-build-go.step-ended",
"node-build-image.ask-taken",
"node-build-image.step-progress",
"node-build-image.step-ended",
"node-build-node.ask-taken",
"node-build-node.step-progress",
"node-build-node.step-ended",
"mesh-pipeline-runner.step-started",
"mesh-pipeline-runner.step-ended",
"mesh-wants.step-progress",
"mesh-wants.wait-held",
"mesh-wants.wait-ended",
"node-engine.wait-held",
"node-engine.wait-ended",
"node-engine.running",
"mesh-broker.created",
"mesh-broker.refused",
"mesh-broker.recreated",
"mesh-broker.dropped",
"mesh-conditions.findings-asked"
],
"tools": [
"watchman_findings",
"watchman_first_views",
"watchman_first_view_again",
"watchman_views"
],
"state": [
{
"name": "presence",
"history": 20
},
{
"name": "pulse",
"key-ttl": true
},
{
"name": "stuck",
"history": 20
},
{
"name": "first-views",
"history": 1
}
],
"own-secrets": {
"broker": "${dir:state}/broker"
},
"secrets-owner": "mesh-delivery-watchman",
"config": {
"take-in-bound": {
"type": "string",
"description": "how long a source revision's take-in the indexer holds may wait for its take-in.taken before it is the finding take-in-waits, a Go duration such as 60m, counted from its take-in.pending (design 47 H section 744).",
"trusted": false,
"default": "60m"
}
},
"resources": [
{
"id": "account",
"type": "user",
"name": "mesh-delivery-watchman",
"shell": "/usr/bin/nologin",
"home": "/var/lib/mesh-delivery-watchman"
},
{
"id": "state",
"type": "directory",
"mode": "0700",
"owner": "mesh-delivery-watchman",
"place": ".",
"unknown": "program"
},
{
"id": "take-in-bound",
"type": "file",
"path": "${dir:state}/take-in-bound",
"owner": "mesh-delivery-watchman",
"mode": "0600",
"content": "${config:take-in-bound}"
},
{
"id": "socket-dir",
"type": "directory",
"path": "/var/lib/mesh-delivery-watchman-tools",
"mode": "0755",
"owner": "mesh-delivery-watchman",
"unknown": "program"
},
{
"id": "watchman",
"type": "process",
"name": "mesh-delivery-watchman",
"artifact": "program",
"run": [
"./mesh-delivery-watchman"
],
"env": {
"MESH_BROKER_FILE": "${dir:state}/broker",
"MESH_WATCHMAN_TAKE_IN_BOUND_FILE": "${dir:state}/take-in-bound"
},
"user": "mesh-delivery-watchman",
"health": {
"kind": "unit"
}
}
],
"build": {
"artifacts": [
{
"name": "program",
"kind": "bundle",
"language": "go",
"system": "arch",
"from": "cmd/mesh-delivery-watchman",
"binary": "mesh-delivery-watchman"
},
{
"name": "tools",
"kind": "bundle",
"language": "go",
"system": "arch",
"from": "cmd/mesh-delivery-watchman-tools",
"binary": "mesh-delivery-watchman-tools",
"loads": [
"mesh-delivery-watchman-tools"
]
}
]
},
"requires": [
{
"name": "findings",
"storage": "key-value",
"template": "state",
"options": {
"history": 5
}
},
{
"name": "finding-events",
"storage": "stream",
"template": "events",
"options": {
"events": [
"finding-written.*",
"finding-cleared.*",
"findings-stated.*"
],
"max-age-days": 7,
"max-mib": 16
}
}
]
}