Directories
¶
| Path | Synopsis |
|---|---|
|
Package agent runs the "propose" step: it gives the role's question to a coding agent and collects its proposals in out/intentions.yaml.
|
Package agent runs the "propose" step: it gives the role's question to a coding agent and collects its proposals in out/intentions.yaml. |
|
Package backlog decides what becomes of a role's acts on a project's issues (docs/spec/backlog-acts.md): each is checked against the code and the forge, then done, proposed to a person, or dropped.
|
Package backlog decides what becomes of a role's acts on a project's issues (docs/spec/backlog-acts.md): each is checked against the code and the forge, then done, proposed to a person, or dropped. |
|
builtin
|
|
|
committer
Package committer holds the deterministic checks of the committer role (roles/committer).
|
Package committer holds the deterministic checks of the committer role (roles/committer). |
|
documentalist
Package documentalist holds the deterministic part of the documentalist role (roles/documentalist): which docs became suspect because a source changed, which are only pending because the cascade is cut, the hygiene checks (budgets, duplicates, links, identifiers gone from the code), and the judge of the patches the agent proposes for suspect docs.
|
Package documentalist holds the deterministic part of the documentalist role (roles/documentalist): which docs became suspect because a source changed, which are only pending because the cascade is cut, the hygiene checks (budgets, duplicates, links, identifiers gone from the code), and the judge of the patches the agent proposes for suspect docs. |
|
productowner
Package productowner holds the deterministic steps of the product owner role (roles/product-owner): pre lists the open issues with what the engine knows of each; the acts the agent proposes are checked when the engine applies them (internal/backlog).
|
Package productowner holds the deterministic steps of the product owner role (roles/product-owner): pre lists the open issues with what the engine knows of each; the acts the agent proposes are checked when the engine applies them (internal/backlog). |
|
reviewer
Package reviewer holds the deterministic steps of the reviewer role (roles/reviewer, ADR-0020): the rules no judgement is needed for, the lenses put to the agent as parts of one question, each finding's quotes found again, whether it lies in the change or outside it, the judge's answers read, and the verdict.
|
Package reviewer holds the deterministic steps of the reviewer role (roles/reviewer, ADR-0020): the rules no judgement is needed for, the lenses put to the agent as parts of one question, each finding's quotes found again, whether it lies in the change or outside it, the judge's answers read, and the verdict. |
|
Package doctor says what workline needs on this machine and in a repository, what is missing, and the command that sets each one up, as `flutter doctor` and `brew doctor` do.
|
Package doctor says what workline needs on this machine and in a repository, what is missing, and the command that sets each one up, as `flutter doctor` and `brew doctor` do. |
|
Package engine runs one role once: check, prepare, propose, judge, apply (docs/spec/role-contract.md, "One run").
|
Package engine runs one role once: check, prepare, propose, judge, apply (docs/spec/role-contract.md, "One run"). |
|
Package forge applies what reaches a forge — comments, labels, issues, merge requests — on GitHub, GitLab, or a simulated forge for the tests.
|
Package forge applies what reaches a forge — comments, labels, issues, merge requests — on GitHub, GitLab, or a simulated forge for the tests. |
|
Package gate runs a gate: a list of checks, each a command whose result is read against thresholds decided in advance (docs/spec/gates.md).
|
Package gate runs a gate: a list of checks, each a command whose result is read against thresholds decided in advance (docs/spec/gates.md). |
|
Package gitrange reads the range of commits a run is given: `base..head`, a single commit, or `head ^base…` when the commits stand on several commits already pushed — a branch that merged main (internal/hooks).
|
Package gitrange reads the range of commits a run is given: `base..head`, a single commit, or `head ^base…` when the commits stand on several commits already pushed — a branch that merged main (internal/hooks). |
|
Package hooks installs workline's git hooks.
|
Package hooks installs workline's git hooks. |
|
Package intent reads the proposals an agent writes and checks them against the closed catalogue (docs/spec/role-contract.md, "Intentions").
|
Package intent reads the proposals an agent writes and checks them against the closed catalogue (docs/spec/role-contract.md, "Intentions"). |
|
Package judge asks an agent one yes-or-no question on what a role produced, at the best independence available from the agent that produced it (ADR-0005): another provider, another model of it, or the same model in a context of its own.
|
Package judge asks an agent one yes-or-no question on what a role produced, at the best independence available from the agent that produced it (ADR-0005): another provider, another model of it, or the same model in a context of its own. |
|
Package line runs the steps routing names for an event, in order, and the handoffs they ask for (docs/spec/routing.md).
|
Package line runs the steps routing names for an event, in order, and the handoffs they ask for (docs/spec/routing.md). |
|
Package pathglob matches repository paths against patterns where `*` stays within one folder and `**` spans any number of folders.
|
Package pathglob matches repository paths against patterns where `*` stays within one folder and `**` spans any number of folders. |
|
Package release says what a project's releases are, for the roles that hold them (ADR-0017): the branches a release tool opens its pull request from, and the last release, one lookup for every reader.
|
Package release says what a project's releases are, for the roles that hold them (ADR-0017): the branches a release tool opens its pull request from, and the last release, one lookup for every reader. |
|
Package report writes findings in the formats forges read: SARIF 2.1.0, for GitHub code scanning (and GitLab Ultimate), and GitLab's Code Quality report, which every GitLab tier shows on a merge request.
|
Package report writes findings in the formats forges read: SARIF 2.1.0, for GitHub code scanning (and GitLab Ultimate), and GitLab's Code Quality report, which every GitLab tier shows on a merge request. |
|
Package review shows a person what the machine proposes, for them to accept or refuse: a page any browser opens, and a question on the terminal.
|
Package review shows a person what the machine proposes, for them to accept or refuse: a page any browser opens, and a question on the terminal. |
|
Package role loads a role's contract (role.yaml) and the project's settings for it, as described in docs/spec/role-contract.md.
|
Package role loads a role's contract (role.yaml) and the project's settings for it, as described in docs/spec/role-contract.md. |
|
Package rolefs extracts the built-in roles to a cache folder, because their pre and post scripts must exist as executable files to be run.
|
Package rolefs extracts the built-in roles to a cache folder, because their pre and post scripts must exist as executable files to be run. |
|
Package routing reads which roles and gates run on which event, and which handoffs are allowed (docs/spec/routing.md).
|
Package routing reads which roles and gates run on which event, and which handoffs are allowed (docs/spec/routing.md). |
|
Package sample is the weekly sample of the docs the documentalist vouched for (ADR-0014, step 4): one in ten of the docs whose `checked` it moved in a week, read whole against their sources at the commit `checked` names, by a judge standing apart from the model that vouched (ADR-0005).
|
Package sample is the weekly sample of the docs the documentalist vouched for (ADR-0014, step 4): one in ten of the docs whose `checked` it moved in a week, read whole against their sources at the commit `checked` names, by a judge standing apart from the model that vouched (ADR-0005). |
|
Package setup sets workline up on a machine, asking what to enable: the global git hooks, the agent, the tools the roles use.
|
Package setup sets workline up on a machine, asking what to enable: the global git hooks, the agent, the tools the roles use. |
|
Package tools knows the programs workline calls but does not ship — the optional tools a role `uses`, the agents, the forges' CLIs — and how each one is installed, so a missing one is named with the command that installs it on this machine.
|
Package tools knows the programs workline calls but does not ship — the optional tools a role `uses`, the agents, the forges' CLIs — and how each one is installed, so a missing one is named with the command that installs it on this machine. |
|
Package verdict reads and writes the verdict a run ends with.
|
Package verdict reads and writes the verdict a run ends with. |
|
Package work reads and moves work items kept as files in .workline/work/, for projects without a forge (docs/spec/routing.md, "Work starts from a clear need").
|
Package work reads and moves work items kept as files in .workline/work/, for projects without a forge (docs/spec/routing.md, "Work starts from a clear need"). |
Click to show internal directories.
Click to hide internal directories.