Repository navigation
ADD 1.12.0 — multi-milestone polish
[1.12.0] — 2026-06-26
Multi-milestone polish release — the intake/roadmap front grows a real queue,
the parallel-front residuals close, and the UDD loop gains a design-intake beat.
Backward-compatible throughout; a single-active project sees no behavior change.
Added (multi-milestone-intake — a request that is several milestones)
queuedmilestone status. The milestone status enum becomes
active · queued · done (was active · done). A milestone can now exist
non-active, awaiting promotion — created withnew-milestone --queuedand made
active with an explicitactivate. Migration-safe: an old state with noqueued
milestones reads byte-identically.- Roadmap intake.
intake.mdnow guides decomposing a request that is several
milestones into a roadmap that creates all N — 1 active + N−1 queued — instead
of only the first. Promotion stays human-gated; the whole set is never auto-activated. - Queued-backlog resume cue.
statussurfaces the queued backlog (active
milestone + what's queued next), so a multi-milestone session resumes cleanly. The
cue is present-only — byte-identical output when nothing is queued.
Added (multi-active-polish — close the parallel-front residuals)
waves --mergefolds the active SET into one cross-milestone DAG and critical
path (today'swavesis per-milestone only).mine --allwidens the ownership lens past the active milestones — every
not-done task you own or are assigned, across all milestones plus loose, with an
email-OR-name match. Plainmine(active-only) stays byte-identical.doctorvalue-domain checks.doctornow flags a badgateenum
(∉ {PASS, RISK-ACCEPTED, HARD-STOP}), a badphase, archived inconsistency, or a
malformed owner/assignee — beyond the existing referential pointers. It adds
findings only; it never auto-fails or retro-reds grandfathered history.new-milestoneadd-and-focus. Creating a milestone while one is active now
preserves the active SET (adds the new one and focuses it) instead of replacing
the set and evicting the others.--queuedand single-active stay byte-identical.
Added (udd-design-intake)
design-intakebeat. The UDD design loop opens with a new front beat that
interviews the human on four axes — FIDELITY · CONCEPT · LAYOUT · VISUAL DESIGN
— recorded inDESIGN.mdbefore review-capture-confirm. Convention-only (the engine
never renders); identity values (brand color/type) stay human-owned — surfaced to
decide, never auto-picked.
Added / Changed (loose tasks since 1.11.0)
- Descriptive-slug nudge (
new-milestone). A milestone slug that is a bare
version number (v2,v1-1,1.2— matched by^v?\d+([._-]\d+)*$) prints an
advisorynote:suggesting a short descriptive name (e.g.payment-retries) and
still creates the milestone — never blocks. - Full-ISO
created:stamp. MILESTONE.md'screated:line is the full UTC ISO
timestamp (2026-06-26T03:47:28+00:00); a single_now()instant feeds both the
rendered file and thestate.jsonrecord. add.py freeze— an engine-stamped human-approval write at the §3 contract
freeze (DRAFT → FROZEN @ vN with a structured actor line). A security finding remains
an un-forceable HARD-STOP.- Queued + await-confirm reminder. A milestone that is both
queuedand
--await-confirmnow surfaces itsmilestone-confirmreminder at resume. - Flow docs. Book ch.02 gains a subsection explaining the milestone-scale
composition rule — tasks are listed breadth-first up front (the DAG), then each
specified just-in-time.
This release bundles 3 closed milestones (udd-design-intake,
multi-milestone-intake, multi-active-polish) and the loose tasks above since
1.11.0. Every milestone was built end-to-end through ADD's own
spec→tests→build→verify flow.