Directories
¶
| Path | Synopsis |
|---|---|
|
Package cli is the ynf command line (ADR-011).
|
Package cli is the ynf command line (ADR-011). |
|
Package config loads ynf's own config.yaml (ADR-009): found in the home factory folder by the same lookup as lanes, validated against the published schema, with defaults applied.
|
Package config loads ynf's own config.yaml (ADR-009): found in the home factory folder by the same lookup as lanes, validated against the published schema, with defaults applied. |
|
Package decide is ynf's decider (ADR-006): a pure function from (lane, item, facts, event) to (next item, actions).
|
Package decide is ynf's decider (ADR-006): a pure function from (lane, item, facts, event) to (next item, actions). |
|
Package egress is ynf's allow-list proxy (ADR-007).
|
Package egress is ynf's allow-list proxy (ADR-007). |
|
Package engine is ynf's outer loop (ADR-001): one idempotent step per event — correlate, claim, probe, decide, act, record, release — plus the sweep that turns searches and due timers into events.
|
Package engine is ynf's outer loop (ADR-001): one idempotent step per event — correlate, claim, probe, decide, act, record, release — plus the sweep that turns searches and due timers into events. |
|
Package event is ynf's one event envelope (ADR-002): every adapter, push or pull, and ynf itself emits a CloudEvents 1.0 event with a type from ynf's closed vocabulary.
|
Package event is ynf's one event envelope (ADR-002): every adapter, push or pull, and ynf itself emits a CloudEvents 1.0 event with a type from ynf's closed vocabulary. |
|
Package executor runs a runner's command somewhere (ADR-007).
|
Package executor runs a runner's command somewhere (ADR-007). |
|
Package facts is the structured snapshot of the world a decision reads (ADR-003: probed fresh before every decision, never trusted from an event).
|
Package facts is the structured snapshot of the world a decision reads (ADR-003: probed fresh before every decision, never trusted from an event). |
|
Package forge is ynf's port to where code lives (ADR-003, ADR-007): pull requests, their checks and reviews, branches and files, and the writes only ynf makes.
|
Package forge is ynf's port to where code lives (ADR-003, ADR-007): pull requests, their checks and reviews, branches and files, and the writes only ynf makes. |
|
Package gate is the diff gate (ADR-007): before ynf pushes anything, the changed paths must be inside the lane's allowed paths and outside every protected path.
|
Package gate is the diff gate (ADR-007): before ynf pushes anything, the changed paths must be inside the lane's allowed paths and outside every protected path. |
|
Package item is the work item: one document per unit of work (ADR-002), moved through the state machine by the decider (ADR-006).
|
Package item is the work item: one document per unit of work (ADR-002), moved through the state machine by the decider (ADR-006). |
|
Package lease gives one ynf instance an exclusive, fault-tolerant claim on a work item (ADR-005): a compare-and-swap on the item document that bumps an epoch, a heartbeat that renews it, and fencing so a holder that lost its lease without knowing cannot write.
|
Package lease gives one ynf instance an exclusive, fault-tolerant claim on a work item (ADR-005): a compare-and-swap on the item document that bumps an epoch, a heartbeat that renews it, and fencing so a holder that lost its lease without knowing cannot write. |
|
Package memory is ynf's memory port (ADR-008, ADR-012): ynm when it is installed, nothing when it is not.
|
Package memory is ynf's memory port (ADR-008, ADR-012): ynm when it is installed, nothing when it is not. |
|
Package policy loads lane policy (ADR-006): .agents/factory/lanes.yaml, validated against the published schema, with defaults applied, a hash per lane for the decision record, CEL guards over structured facts, and placeholders filled only from labels.
|
Package policy loads lane policy (ADR-006): .agents/factory/lanes.yaml, validated against the published schema, with defaults applied, a hash per lane for the decision record, CEL guards over structured facts, and placeholders filled only from labels. |
|
Package runner is ynf's runner port (ADR-012): what a lane's inner loop is.
|
Package runner is ynf's runner port (ADR-012): what a lane's inner loop is. |
|
Package shadow is shadow mode's record and arithmetic (FR-26, ADR-011): what a shadow run pinned, what each attempt produced beside the human's patch, how a person graded the two blind, and the yield those grades give, with its confidence interval.
|
Package shadow is shadow mode's record and arithmetic (FR-26, ADR-011): what a shadow run pinned, what each attempt produced beside the human's patch, how a person graded the two blind, and the yield those grades give, with its confidence interval. |
|
Package spool is ynf's side of the spool layout in ynr ADR-003 and ADR-004: the root's three folders (factory/ for ynf's own writer, runs/<run id>/ one per run, manifests/<run id>.json one per run), the manifest, the quota on a run's folder, ynr serve for the length of a factory job, and what is swept into the run capture (ADR-007, ADR-009, ADR-010, ADR-011).
|
Package spool is ynf's side of the spool layout in ynr ADR-003 and ADR-004: the root's three folders (factory/ for ynf's own writer, runs/<run id>/ one per run, manifests/<run id>.json one per run), the manifest, the quota on a run's folder, ynr serve for the length of a factory job, and what is swept into the run capture (ADR-007, ADR-009, ADR-010, ADR-011). |
|
Package store is ynf's state port (ADR-004): key/value documents with compare-and-swap, an append-only log per item, and timers.
|
Package store is ynf's state port (ADR-004): key/value documents with compare-and-swap, an append-only log per item, and timers. |
|
s3store
Package s3store is the S3 store provider (ADR-004), for the hosted service and the CI-native host, where state must outlive any one process.
|
Package s3store is the S3 store provider (ADR-004), for the hosted service and the CI-native host, where state must outlive any one process. |
|
sqlite
Package sqlite is the SQLite store provider (ADR-004), for the daemon host.
|
Package sqlite is the SQLite store provider (ADR-004), for the daemon host. |
|
storetest
Package storetest is the conformance suite every store provider must pass (ADR-004), including concurrent compare-and-swap races.
|
Package storetest is the conformance suite every store provider must pass (ADR-004), including concurrent compare-and-swap races. |
|
Package telemetry is ynf's side of ynr's OpenTelemetry contract (ADR-011; ynr ADR-002, 003, 004 and 006).
|
Package telemetry is ynf's side of ynr's OpenTelemetry contract (ADR-011; ynr ADR-002, 003, 004 and 006). |
|
gen
command
Command gen writes internal/telemetry/names.go from telemetry/registry, ynf's Weaver registry.
|
Command gen writes internal/telemetry/names.go from telemetry/registry, ynf's Weaver registry. |
|
registry
Package registry reads ynf's telemetry registry (telemetry/registry), an OpenTelemetry Weaver registry, and writes the Go constants generated from it.
|
Package registry reads ynf's telemetry registry (telemetry/registry), an OpenTelemetry Weaver registry, and writes the Go constants generated from it. |
|
spooltest
Package spooltest reads a spool folder back, for tests that prove what ynf wrote: the OTLP JSON lines of every file in it, parsed into spans, events, log records and metric points.
|
Package spooltest reads a spool folder back, for tests that prove what ynf wrote: the OTLP JSON lines of every file in it, parsed into spans, events, log records and metric points. |
|
Package tracker is ynf's port to where work items live (ADR-003): GitHub Issues, JIRA and others.
|
Package tracker is ynf's port to where work items live (ADR-003): GitHub Issues, JIRA and others. |
|
mcptracker
Package mcptracker is the mcp tracker provider (ADR-003): a tracker whose system has an MCP server, such as JIRA Cloud or Data Center, read and written by calling the server's tools directly.
|
Package mcptracker is the mcp tracker provider (ADR-003): a tracker whose system has an MCP server, such as JIRA Cloud or Data Center, read and written by calling the server's tools directly. |
|
Package workspace is ynf's git: a mirror per repository, a checkout per step, and the commit and push that only ynf (never the agent) performs (ADR-007).
|
Package workspace is ynf's git: a mirror per repository, a checkout per step, and the commit and push that only ynf (never the agent) performs (ADR-007). |
Click to show internal directories.
Click to hide internal directories.