Skip to content

v0.7.0

Latest

Choose a tag to compare

@github-actions github-actions released this 15 Nov 17:47
· 1 commit to main since this release

New

  • 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.