Repository navigation
Guardana Control 0.10.0-alpha
Pre-releaseOne supervised run is now whole. A procedure of schema 0.2 names the
resources its steps bind, the exceptions it allows and how a run's children
are judged; supervise reports a resource outside the run, a denied action
retried in another form and an exception taken, judges a run's tree, and
draws one run as a static page. A finding is confirmed only on the named
run's own calls, so no run can get another one stopped, and a child run can
now be stopped on its own. procedure lint and procedure test check a
procedure with cases, and findings export reads the findings log with a
cursor. The fixes come from an audit of this release's own changes.
Security
- Built with Go 1.27.2, which fixes GO-2026-6599, GO-2026-6600, GO-2026-6603,
GO-2026-6604, GO-2026-6605, GO-2026-6607, GO-2026-6608 and GO-2026-6610 in
crypto/tls,net/httpand its HTTP/2 code,html/template,
mime/multipartandos;govulncheckfound the plane's calls reaching
the HTTP/2 ones under 1.27.1.
Added
- Procedure schema
0.2, read beside0.1
(ADR-0047).
bindingsname the resource type each binding holds andbindsties a
step or an allowed tool to one;exceptionswaive one rule for one step or
tool, on a granted approval, a failed step or a reason code;childrenis
inherit, which judges a root run and its whole tree, orseparate, which
judges one run's own calls and lists its children. A rule that may stop a
run is waived only on an approval. A0.1document reads as before, with
the same digest and the same confirmed findings. - Under a
0.2proceduresupervisereportsRESOURCE_OUTSIDE_RUNwhen one
binding's calls carry more than one resource, and
DENIED_ACTION_RETRIED_ARGUMENTS,_RESOURCEand_AROUNDwhen a policy
denial is followed by the same tool with other arguments, another tool or
upstream on the same resource (not a read after a denied non-read), or a source's report of the denied tool that no plane
call joins. An exception taken raisesEXCEPTION_TAKEN, never stronger than
the finding it waived. A finding names the run whose call it rests on, a
child included, and the report lists the run tree. - A child run can be stopped.
reactwrites a stop for a confirmed finding
about an open child of the finding's tenant, and a plane refuses that
child's next call while its parent and siblings run on. guardana-control findings exportwrites the findings log with a cursor,
in the formatguardana.control.findings-export0.1, up to the last
write a report closed
(ADR-0048).
A log this release creates starts with a header holding a randomlog_id,
which its cursors bind to; an older log is known by its first line.guardana-control procedure lintprints a procedure's id, version, digest,
children mode and each rule with its version and whether it may stop a run;
procedure testruns a document of cases against it and passes a case only
on an exact match (guide).supervise --view <file>draws the run as one static HTML page: the
expected steps beside the calls observed, each marked enforced, decided not
enforced, observed, exception or approval, blocked or not seen, by shape and
line as well as colour. It shows each finding's calls and their neighbours,
or with--view-allevery call up to a bound
(run view).
Changed
- Every reader of a route (
route sign,react, a plane at start,doctorand
thestopscommands) refuses one that names a rule or a rule version outside
the six whose finding may stop a run:REPEATED_DENIAL,
STEP_OUTSIDE_PROCEDURE,DEADLINE_EXCEEDED,RESOURCE_OUTSIDE_RUN,
DENIED_ACTION_RETRIED_ARGUMENTSandDENIED_ACTION_RETRIED_RESOURCE, each
at version1. Onlyroute signchecked a route's rules before, so a route
signed by other means could name any rule. - A finding record that carries a run on its event references, a count of
references left out, a children mode or a run tree is schema0.2, and a
0.9 reader refuses it by name. Read a findings log this release writes with
this release'snotifyandreact. supervisereads from the runs directory only the run's own tree, so a
directory holding more than 1000 runs no longer refuses a supervision.supervisecounts a source as heard only from import reports of its
descriptor's tenant and project, ascoveragedoes, and bounds each span
walk on its own as well as in total. Either can move a finding below
CONFIRMED; a changed verdict is a new record, and so a second alert.STEP_OUT_OF_ORDERandCONTINUED_AFTER_FAILUREare version2. Two
proposals of one instant are now untold even within one export, since a
plane ships several batches at a time, so a finding that rested on their
place in the export is indeterminate. The rule version is part of a
finding's id, so supervising a run again writes their findings as new
records and alerts again. Neither may stop a run; the six that may stay at
version1, so a route signed before still holds.
Fixed
- A finding that rests on many events, such as ten thousand denials, was past
the log's line bound and refused the whole write. It now cites ten
references, the most doubtful first, and counts the rest; its verdict is
still weighed over all of them. - Under a
0.2procedure judging a run's tree, one run's calls could confirm
a finding against another: a child's denial made the root's later call a
confirmed retry, a child's probe of another order confirmed
RESOURCE_OUTSIDE_RUNon the root, and a closed child took the tree's
REPEATED_DENIALand deadline. A finding is now confirmed only on the named
run's own calls (a retry by a descendant of the denied run included); one
that needs another run's call is suspected at most and stops nothing. Each
run's deadline is still timed from the tree's first event, which may be
another run's. - The retry rules turned themselves off past about a thousand denials; they
now judge every denial. A tree is bounded at 400 runs, where its report
still fits the log's line. DENIED_ACTION_RETRIED_AROUNDread as checked with a source never heard,
silent or not read, and so didSTEP_OUTSIDE_PROCEDUREwhen a span walk ran
out of steps; both read not checked now, andprocedure testcompares the
sources a case expects to be unheard.- A rule that is never confirmed could be recorded as confirmed; it is capped.
Image: ghcr.io/guardana/control-gateway@sha256:2b767c40c02999beaca84316f44be15404c3659d3c97526d6ee932835a83513b