Get blueprint
Download
pipeline-observability-1.1.0.tgzEvery file of this release in one archive, ready to unpack into a folder.
Clone
npx -y darkprint clone autogen/pipeline-observabilityThere is no repository and no history behind a release. Download hands you its files as they stand, and Clone fetches the same files by name.
Observability for a pipeline you already have: tracing on every watched step, metrics per step in one report, monitoring of that report against thresholds, and an alert when a step fails or runs long. To feed the tracer, a step has to emit one structured value per run, json or a table will do, plus its outcome signal when it has one; the gate's signal is the only thing that reaches the alert sender.
- Messaging
Node tracer, Step Tracer. DOT line 5, card step-tracer@1.0.0. 4 nodes in the graph.
1 The graph
4 nodes · 4 edges- Hears from
- nothing in this graph
- Sends to
- summariser
2 The card skeleton
idstep-tracerline 1Filled.
The key a blueprint pins. A DOT node carries card="id@version", and this string is the only way a graph and a card find each other. It may be namespaced, berti/solver-a, so two authors can publish a card under the same short name.
nameStep Tracerline 2Filled.
What a person calls the node. The drawing prints it and every listing leads with it. Nothing matches on it: that is the id's job, and the two are free to disagree.
typetoolline 3Filled.
Exactly one node-type term from the vocabulary. It says what kind of work the node does and whether a person acts at it: a type under human-in-the-loop, such as human-gate, holds the run until somebody acts; every other type lets it pass. The static analysis groups nodes by this term. Either way it is the author's design choice; nothing here is measured.
phaseoutside the fivenot writtenLeft empty by this card.
Which of the five phases the node stands in, any number of them. The phases describe a blueprint's shape rather than placing every node in one. Intake, retrieval and routing are real work that none of the five names, so declaring none is a valid answer.
actionTurn every value a watched step emits into one trace record carrying the step's name, the time it arrived, its outcome, and the size and digest of the value, and hand the record on.lines 5–7Filled.
The operation, in one line, short enough to read off a drawing. It is prose for whoever opens the card. The agent is instructed by spec, and nothing parses this line.
specYou sit beside one step of a pipeline. You are handed whatever that step emits on step, and its outcome on outcome when the pipeline emits one. For every value that arrives, write one trace record and emit it on traces: the step's name, the time the value arrived in UTC, the outcome as the step reported it or unknown when nothing arrived on outcome, the byte size of the value, and a sha256 over its canonical form. When the outcome is a failure, copy the first line of the error into the record and nothing more of it. Never copy the value itself into a record: a trace names what passed and how big it was, and the payload stays on the edge it came in on. Write nothing to disk and keep nothing between records; whoever runs the graph decides where records are kept.146 wordslines 8–17Filled.
The instructions handed to the agent when someone runs the graph on their own machine. They must stand on their own, because the agent never sees the rest of the graph. They must not carry what the graph withholds: if the text supplies information no edge brings to this node, the isolation the graph draws exists only on paper. One check reads this field, card/spec-too-thin, and it only measures length.
modelnot namednot writtenLeft empty by this card.
Which model the agent is instantiated with, written the way the provider writes the identifier. A default rather than a binding: a graph's model_stylesheet sets the model for every node matching a shape, an explicit field here outranks the sheet, and whoever runs the blueprint outranks both. Absent on most cards, which means the node takes whatever the graph or the runner supplies.
agentnot namednot writtenLeft empty by this card.
A label the card's author chose for the agent behind the node. Nothing checks it.
skillskills/step-tracer.mdline 20Filled.
Where the written procedure for this agent lives, as a path inside the repository you run from. It is only a pointer: no skill document travels in a DarkPrint bundle, and you write the file it names. A node whose spec field holds the whole instruction declares none.
toolsnone requiredline 18Left empty by this card.
tool capability terms from the vocabulary: what the node is permitted to do. This does not say which server supplies the capability; the mcp field answers that. A node can carry either field without the other.
mcpno server is namedline 19Left empty by this card.
The MCP servers the node reaches, under the names they are registered with on the machine that runs the graph. Free text by design: an MCP server is a process somebody installed, and the vocabulary has no term for one.
paramsclock: utc, digest: sha256, include_error_head: truelines 21–24Filled.
Nested configuration for the node, free-form but JSON-serializable. It travels with the card to whoever runs the graph; nothing on this site interprets a key of it.
inputsstep: structured, outcome: statuslines 26–33Filled.
The ports data arrives on, each with a name and a data-type term from the vocabulary. Every incoming edge is checked against them: an edge whose source produces nothing this node accepts is reported as bundle/type-mismatch.
step: structured. One step's output, as the pipeline emitted it. Any typed structured value wires here. outcome: status. The step's own outcome, when the pipeline emits one, so a failure is counted rather than read as a missing record.
outputstraces: jsonlines 34–37Filled.
The ports data leaves on. An output type makes an edge into the next node meaningful. The next node's declared inputs and prohibitions are checked against it.
traces: json. One trace record per value seen, with the step's name, arrival time, outcome, size and digest.
dependenciesno upstream node is namedline 38Left empty by this card.
Cards this one expects to hear from, by id. This is the one card field that names topology, so it can point back at a line in the DOT on its own. The DOT still decides what is wired; this field says what the author expected to be wired.
cannotno type is refusedline 39Left empty by this card.
Data types that must never arrive, written as vocabulary term ids. Every incoming edge is checked against every entry, and an edge that can carry that type, or a narrower one, is refused as bundle/prohibition-violated. This is the half of the node's refusals that the checker enforces; will_not is the other half, which nothing checks automatically.
will_notcopy a step's payload into a record, write a record anywhere but its output portlines 40–42Filled.
What the node promises never to do, in the author's own sentences. Nothing checks an entry here, and nothing can: a promise like "never opens a shell" cannot be read off a graph. It is addressed to whoever reads the card and to the agent instantiated from it, which is why it is a field of its own rather than a second kind of entry inside cannot.
risk_markersnone declaredline 44Left empty by this card.
risk-marker terms the author declares for the node. The static analysis subtracts each distinct marker's weight from the blueprint's static risk-exposure reading, once per blueprint however many nodes carry it. An empty list is a valid answer. Three markers are also read off the graph whether or not a card declares them: unbounded loops, unvalidated external access and criteria leaks.
notesstep is typed structured rather than any so the edge into it stays a typed edge: json, a table, a report or a plan wires straight in, and a step that emits text or bytes needs a wrapping step first. The record carries a digest and a size in place of the value, which is what lets the records travel to the summariser without carrying the pipeline's data with them.70 wordslines 45–49Filled.
The author's commentary on the card, addressed to whoever reads it. Nothing checks it.
version1.0.0line 51Filled.
Semver of the card itself. A published version is never edited in place, so a pinned id@version means the same content forever and a change ships as a new version beside it.
authorautogenline 52Filled.
Who wrote the card. It is excluded from the card's digest, along with provenance. Two cards describing the same node are the same card, whoever typed them.
provenancenot statednot writtenLeft empty by this card.
Where the card came from when it did not start here, such as the blueprint it was forked from or the document behind it. Free text, and excluded from the card's digest.
filled, left empty; both are valid. The skeleton is the card’s fields with what each one is for: open a row to read it. Long values are cut at two lines until the row is opened. This card is pinned by tracer at topology.dot line 5.
Files
- README.mdwhat this blueprint is, its digest, and how to run itgeneratedSep 11, 2026
- cards/4 pinned cards, one document eachpinnedSep 11, 2026
- topology.dotthe topology, as the author wrote itsourceSep 11, 2026
README.md
Pipeline Observability
Observability for a pipeline you already have: tracing on every watched step, metrics per step in one report, monitoring of that report against thresholds, and an alert when a step fails or runs long. To feed the tracer, a step has to emit one structured value per run, json or a table will do, plus its outcome signal when it has one; the gate's signal is the only thing that reaches the alert sender.
blueprint pipeline-observability
bundle digest sha256:c6ef312cfffd549b691b3339a155ac1e12c280fac1329d7c61fda272354b39d1
nodes 4
cards pinned 4The digest is taken over topology.dot and the digest of every card version pinned in it.
Recompute it to confirm these files are the ones DarkPrint read. One changed byte gives a
different digest.
Run it
This runs on your machine. DarkPrint hands out the files and analyses them statically. It executes nothing and holds none of your provider keys.
This folder carries the topology and its pinned cards, nothing compiled. To compile them into
a pipeline a graph runner takes, run darkprint export <dir> --attractor. It writes Attractor
DOT to stdout, and that file opens with the same two lists this README carries under What
these files leave to the runner. Adapting the result, or building the run yourself from these
files instead, is your own harness's job.
2 of the 4 nodes name the model they run on, in their card's own model field. Read it off
cards/<ref>.yaml; whether your harness honours it is yours to decide.
What is in the folder
topology.dot node ids, edges, and the card version pinned on each node
cards/ the pinned cards, as the registry stores them; each carries the `spec` that becomes its node's prompt
README.md this file4 of the nodes in this bundle name a skill document. There is no skills/ directory above and
there is not meant to be: DarkPrint stores the pointer and reads nothing at the other end of
it. The paths are relative to the repository you run this blueprint from, and writing the
documents is yours to do. Nothing here needs them to run, because every card carries its own
spec inline.
tracer skills/step-tracer.md
summariser skills/run-summariser.md
gate skills/anomaly-gate.md
dispatch skills/alert-dispatch.mdWhat these files leave to the runner
Attractor reads more attributes than a DarkPrint blueprint has fields to set. Compile these files into a pipeline, by the command above or by hand, and the names below are the ones nothing in this folder sets. Write them in where your run needs them, and expect a later export of this blueprint to overwrite the whole compiled file. Appendix A of the Attractor spec tabulates most of them; the rest are named by the retry rules in §3.5, by the handler pseudocode in §4, and by §9.7's tool call hooks.
Left out, these fall to the runner and the pipeline still runs. The Attractor spec states a value or a behaviour for each one's absence, in Appendix A or in the handler pseudocode that reads it, so what you get is a choice nobody in this folder made:
- graph:
model_stylesheet,default_max_retries,default_max_retry,default_fidelity,retry_target,fallback_retry_target,stack.child_workdir,tool_hooks.pre,tool_hooks.post - node:
goal_gate,retry_target,fallback_retry_target,fidelity,thread_id,timeout,llm_provider,reasoning_effort,auto_status,allow_partial,join_policy,max_parallel,manager.poll_interval,manager.max_cycles,manager.stop_condition,manager.actions,stack.child_autostart,tool_hooks.pre,tool_hooks.post - edge:
fidelity,thread_id,loop_restart
Left out, these have nothing to fall to. The handler a node's shape selects reads each one directly, and with no value it refuses or goes round again while the rest of the compiled file reads as though the node would run. Read §4's handler section for the shape you are compiling before you leave one of these unset:
- graph:
stack.child_dotfile - node:
human.default_choice
The nodes
| node | card |
|---|---|
tracer | step-tracer@1.0.0 |
summariser | run-summariser@1.0.0 |
gate | anomaly-gate@1.0.0 |
dispatch | alert-dispatch@1.0.0 |
Exported from https://www.darkprint.io/blueprints/pipeline-observability
History
each release is a frozen snapshot, addressed by its digest- 1.1.0sha256:c6ef31…latest
Observability for a pipeline you already have: tracing on every watched step, metrics per step in one report, monitoring of that report against thresholds, and an alert when a step fails or runs long. To feed the tracer, a step has to emit one structured value per run, json or a table will do, plus its outcome signal when it has one; the gate's signal is the only thing that reaches the alert sender.
autogen · Sep 11, 2026
There is no repository behind a release, so there is nothing to pull.
Community notes (0)
No notes yet.
Nobody has posted about this blueprint yet.
Sign in to post a note.