You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The skill proviso-simplify finds where the spec tree could say
the same more simply, such as rules restating one another or a promise
held only in a Rationale, or where its behaviour could be simpler. A
fresh agent that reads only the tree proposes; you decide, and each
proposal you take becomes an amendment through proviso-integrate.
Run proviso update to install it.
A contract element can say what it builds on, in the field - Builds on: `concept-summary`. A rule that refers to the element
is then changed through every change of what it builds on, and the
check is led to it; before, a member made of another contract's
members depended on nothing but the terms it represents. A Builds on
field without a backtick reference is the error builds-on-empty.
This is model 1; trees of model 0 read as before. Run proviso update
so the skills write the field where it applies.
Changed
A checked element turns stale when what it rests on changes again.
A rule changed through a contract, once checked, stayed covered when
the contract changed a second time; proviso verify now reports it
stale, so the check reads it again. A check recorded by an earlier
release may show such elements stale after the upgrade.
Proviso reads every model version from the oldest it still
supports, not only its own. A change that only adds to the notation,
such as a new optional field, raises the model version without a
migration: a tree accepted under an older model version reads as it
did, with the same fingerprints and no new lint error. When a tree's
manifest names a model version outside that range, proviso lint and proviso version name the range this binary reads.
A ? inside a literal or a backtick reference is a value, as
lint always took it: proviso diff and proviso verify no longer
count it as undecided.
pack, impact and show write nothing but their output to
stdout, as lint, diff, verify and rehome already promised,
so a script can read it whole.
Every command but init and update promises to leave the git
repository as it was,lint and show included, and to change
nothing under the spec root but what it is for; a command refused
because lint finds an error changes nothing at all.
A stale skill or agent is named with the model version its release
writes ("installed by 0.5.0, which writes model 0"), no longer
"reads".
Upgrading
When a release raises the model version, upgrade everyone who works
on the tree. The first acceptance with that release writes the
manifest under the new model version, and from then on an older
Proviso refuses the tree, naming the model version it needs. Until
then, an older Proviso on a branch whose tree already uses the new
notation reports it as an unknown field.