diff --git a/docs/releases/v3.3.6-luxor.md b/docs/releases/v3.3.6-luxor.md index e9b8cbf9f..772100922 100644 --- a/docs/releases/v3.3.6-luxor.md +++ b/docs/releases/v3.3.6-luxor.md @@ -4,12 +4,14 @@ Released: 2026-10-19 ## Summary -3.3.6 is a one-change patch: the process that goes with the Decisions tab. 3.3.5 shipped +3.3.6 is the patch that makes the Decisions tab usable end to end: the process that goes with it, one command to turn it on, and stamps that no longer flag every card. 3.3.5 shipped the tab, which turns `codev/state/pending-decisions.md` into cards and writes the owner's word back into the file, but the agreement behind it, what an item looks like, how an architect sends one, and what the hub architect does with each ruling, existed only in one adopter's repository. This release puts that document in the framework, points the architect -role at it, and pins its format to the code with a test. +role at it, and pins its format to the code with a test. It adds `afx decisions init`, +so turning the tab on is one command, and it settles the time convention: agents write UTC, +the tab shows your time. ## The owner decisions process (#1826, PR #1832) @@ -42,6 +44,40 @@ yet copy skeleton reference documents into an adopter's `codev/resources/`. Unti lands, read it in the package under `skeleton/resources/decision-protocol.md`, or on GitHub at `codev-skeleton/resources/decision-protocol.md`. +## Turning the tab on: `afx decisions init` (#1840, PR #1841) + +One command creates the decisions file from its template and turns on the Decisions tab: + +```bash +afx decisions init +``` + +It writes `codev/state/pending-decisions.md`, or the path `dashboard.decisionsFile` names, +prints where the file went, and gives the one sentence to tell the main architect: "Route +every ask for my word through the decisions file." It never replaces an existing file, which +holds the owner's rulings, and it refuses a path outside the workspace, the same rule the tab +applies. The template lives once in the code and the protocol document is pinned to it by a +test. The architect role now says: when the owner asks to use decisions, run the command and +follow the document. + +## Stamps: everything in UTC, shown in your time (#1836, PR #1837) + +Nearly every card used to carry "Not converted: the date or time is not in a recognized +format", because the tab accepted only a full stamp with date and zone and hubs wrote a bare +time or none. Now: + +- Agents write every time in UTC, `YYYY-MM-DD HH:mm UTC`, and the tab shows it in each + viewer's own time. The file template carries a `_Zone: UTC_` line. +- A stamp with no zone takes the file's zone; a bare time is read as today in that zone and + the card shows the converted time alone, with no date nobody wrote. +- A heading with no stamp, or one the tab cannot read, keeps its question and shows no warning. + The warning remains only for an ambiguous zone such as `IST` and for a clock time that was + skipped or repeated. + +Anything a person types in another zone still converts. Follow-ups: a bad `_Zone:` line +reported once at the top of the tab (#1838); the Ruled list and question-and-answer lines +converted to the viewer's time as well (#1839). + ## Upgrade ```bash @@ -54,5 +90,5 @@ file exists, and the hub notice goes only to an architect named `main`. ## Contributors -- **M Waleed Kadous (@waleedkadous)** — the decisions process document (PR #1832). -- The AIR builder for #1826. +- **M Waleed Kadous (@waleedkadous)** — the decisions process document (PR #1832), the UTC stamp convention (PR #1837), and `afx decisions init` (PR #1841). +- Builders working under AIR and BUGFIX for #1826, #1836 and #1840.