Skip to content

v0.2.0-rc.3

Pre-release
Pre-release

Choose a tag to compare

@dvalnn dvalnn released this 13 Nov 15:23
e6a5c2d

The third candidate for v0.2.0. A review now sizes itself: tiered_review seats its lenses and picks its checklist
from the change, and one build block decides whether tests come first. Config reaches a classics composition under
any root, and guidance travels as instructions.

Install or upgrade

curl -fsSL https://raw.githubusercontent.com/dvalnn/maestro/next/install.sh | MAESTRO_VERSION=v0.2.0-rc.3 sh

This is a pre-release on GitHub releases: without the pin the script keeps
installing the newest stable, v0.1.0. Put MAESTRO_CHANNEL=rc before sh instead to follow every candidate. Manual
steps are in INSTALL.md.

Upgrade notes

  • Finish or discard rc.2 classics concerts before upgrading. Node paths and params changed, so an rc.2 concert on
    the classics bundle does not resume or encore on rc.3.
  • Bind the three new lens profiles. classics.build_then_review and fix_until_clean review through
    tiered_review, which seats classics/lens, classics/deep-lens, classics/top-lens or classics/cross-lens by
    the size of the change; each needs a runtime. The starter config in INSTALL.md lists all ten profiles. No skeptic
    runs, and classics.panel.* no longer tunes these two.
  • classics.build_then_review loses --tested and --max-repairs. Set -c classics.build.testFirst=true, or the
    same key in a preset or config, to have a tester write the tests first.
  • classics.fix_until_clean keeps maxFixes, checks and grounds. Its maxRepairs, fix, lenses, skeptics
    and consolidate params are gone; a config key naming one is refused as unclaimed. The gate's repair is tuned under
    classics.repair_until_green.maxRepairs and .fix.
  • Node paths moved. The builder is build/build, the tester build/test_first/tester, spec and brief sit under
    build/, and the review's nodes under tiered_review/ where they sat under panel/. A --node or a script naming
    the old paths must follow.
  • A profile's skills field is refused at resolution. Move the guidance into instructions, which now takes a
    list of files; the frame's ## Disciplines section is gone.
  • A used composition's params sit under the pack that declares it. classics.<composition>.<param> now reaches
    that composition under any root, a bare .maestro file included, so an existing classics.* key applies there too.
    A -c key that reaches no composition of the concert is refused as CFG.unreached, and keys a file or preset sets
    for an unused composition are still schema-checked.
  • A pack is refused when one of its compositions declares another pack's id. A bare file may still re-export one.

Added

  • classics.review_change reviews a revision range or a change by tiered_review: --request, and exactly one of
    --revs and --change.
  • tiered_review counts the changed lines of the changeset and seats one tier's lenses: small to 200 lines, medium
    to 800, large to 2000, xlarge above, where a second model reads alongside. classics.tiered_review.floor sets the
    lowest tier. Each lens gets the checklist sections the changed paths call for.
  • build, a block for compositions: it delivers a spec with one builder, or with tests first under
    classics.build.testFirst.
  • A composition's pack field names the pack whose config keys reach it.

Changed

  • classics.build_then_review and classics.build_then_repair build through build, so one config key decides
    whether tests come first in both.
  • A review that no lens delivered is rejected, with the reason "no lens delivered a review", where it used to pass
    as clean.
  • A profile's instructions takes a list of files, and the classics seats carry their guidance there.

Fixed

  • A config key for a classics composition is no longer ignored under a root from another pack or a bare file.