vantage-md 0.9.2 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -6,6 +6,54 @@ are summarized one section per minor line; the commit log has the rest.
6
6
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
7
7
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
8
8
 
9
+ ## [0.10.0] - 2026-10-09
10
+
11
+ The planning page becomes a to-do list of what needs you, every comment box
12
+ saves as you type, and `vantage-check` can ask an agent to fold answered
13
+ questions into their ledgers.
14
+
15
+ ### Changed
16
+
17
+ **The planning page shows what needs you, and counts the rest.** *Needs you*
18
+ now holds only the questions waiting on your reply: 10 cards at a time, or 20,
19
+ 30 or 50 if you choose, with no pages. Questions you have answered gather as
20
+ one-line rows at the top, and ✅ questions leave it. Answering a card shrinks
21
+ it to a row where it stands, and the next question joins the end. *Blocked*
22
+ and a new *Maintenance* group, which holds *Not on a roadmap*, *Ready to
23
+ build*, *Ready to graduate*, *Stage conflict* and the ✅ questions, are folded
24
+ until you open them. The section bar is gone, and the contents column is now
25
+ titled *On this page*. See [Needs you](userguide/guides/planning.md#needs-you).
26
+
27
+ **Nothing moves while you read.** An agent's reply, an answer you gave in
28
+ another tab or an edited document now marks what it concerns, such as **New
29
+ reply**, and is counted in the header as *3 updates · Refresh*. Press
30
+ **Refresh** to lay the page out again. See
31
+ [Late changes and Refresh](userguide/guides/planning.md#late-changes-and-refresh).
32
+
33
+ **Copy answers + maintenance** replaces Copy all agent requests. It copies
34
+ what Copy answers copies, then the agent requests for the kinds of maintenance
35
+ you check in its panel, which opens on hover or from its ▾. *Ready to build*
36
+ starts unchecked, so a copy never asks an agent to build something by accident.
37
+ See [Copy answers + maintenance](userguide/guides/planning.md#copy-answers--maintenance).
38
+
39
+ **The filter line says *18 match · 379 hidden*** in place of the notice that
40
+ repeated the filter. Press *379 hidden*, or ✕, to clear the filter, and Back
41
+ brings it back. Enter in the box now takes you to the results. See
42
+ [What the filter line says](userguide/guides/planning.md#what-the-filter-line-says).
43
+
44
+ **Every comment box saves as you type.** There is no Save and no Cancel, only
45
+ **Close**, and Esc or a click outside the box keeps your text instead of
46
+ throwing it away. A save that fails keeps retrying, and leaving the tab with
47
+ anything unsaved asks first. See
48
+ [Comment boxes save as you type](userguide/features.md#comment-boxes-save-as-you-type).
49
+
50
+ ### Added
51
+
52
+ **`vantage-check index --request compact`** lists the ✅ questions and asks an
53
+ agent to fold each into its document's Decision Ledger. `--request` with no
54
+ name now prints all five requests. See
55
+ [`vantage-check index`](userguide/guides/vantage-check.md#vantage-check-index).
56
+
9
57
  ## [0.9.2] - 2026-10-08
10
58
 
11
59
  ### Fixed
package/dist/index.cjs CHANGED
@@ -2690,6 +2690,12 @@ function resolveLinks(html, options = {}) {
2690
2690
  * actually cares about — if a line is neither, it does not belong.
2691
2691
  */
2692
2692
  /**
2693
+ * How a ruled question is compacted: the one copy, in the style guide's
2694
+ * *Record rulings before downstream work* bullet and in the planning
2695
+ * `compact` request, so the two cannot word it differently (P7).
2696
+ */
2697
+ const COMPACTION_RULE = "Fold the ruling into the body it governs, then compact the settled question into a Decision Ledger row retaining its exact ID, decision, date, and a link to the governing section. Remove the question's directive only with that compaction; repair inbound Markdown links to its former anchor in the same update. Keep question-specific `depends-on` fragments when the ledger retains their IDs. Preserve the decision, not the discarded options and leaning.";
2698
+ /**
2693
2699
  * Shared by the style guide and every review clipboard payload. These are
2694
2700
  * authoring instructions, not a claim that the checker measures agent latency.
2695
2701
  */
@@ -2698,7 +2704,7 @@ const ANSWER_PROCESSING_GUIDE = `### Record rulings before downstream work
2698
2704
  Vantage derives planning state from saved Markdown. Pending review comments can show an answer waiting on the agent, but an agent reply does not settle the question in the document; replying first can make it need the human again.
2699
2705
 
2700
2706
  - **Record a clear ruling first**, in the checkout Vantage serves, before launching or continuing downstream work based on it. Do not wait for a larger rewrite, implementation, independent review, a full test suite, or a commit. A saved edit in another worktree does not update this interface.
2701
- - **Finish a small, coherent document update.** Fold the ruling into the body it governs, then compact the settled question into a Decision Ledger row retaining its exact ID, decision, date, and a link to the governing section. Remove the question's directive only with that compaction; repair inbound Markdown links to its former anchor in the same update. Keep question-specific \`depends-on\` fragments when the ledger retains their IDs. Preserve the decision, not the discarded options and leaning.
2707
+ - **Finish a small, coherent document update.** ${COMPACTION_RULE}
2702
2708
  - **Keep unfinished work visible.** A decision is not evidence that it has been implemented. Update \`status\`, \`stage\`, \`next\`, and dependencies only as warranted; do not claim \`accepted\` while any question remains unanswered, including blocked ones, or use a \`done\` stage to hide work. A clarification request is not a ruling: reply without closing the question. For a partial answer, record the settled part and retain a narrower open question with its directive.
2703
2709
  - **Save each coherent update promptly**, rather than waiting for every document in the batch. The coordinator records rulings before handing those documents to a writer. Do not overwrite another writer's changes; if the served checkout is unavailable or the edit conflicts, report that obstacle explicitly instead of claiming the interface has updated.
2704
2710
  - **Then check the affected documents and deliver the comment responses.** Deliver responses for recorded rulings promptly, without waiting for downstream work or the rest of the batch. A response says what was recorded and what remains unbuilt. Do not claim the question is settled while its document is still open. Missing checker tooling does not justify postponing the saved update. Vantage cannot verify from prose alone that a ruling was incorporated correctly or enforce this ordering on an external agent.
@@ -2922,6 +2928,7 @@ exports.ALERT_TITLES = ALERT_TITLES;
2922
2928
  exports.ANSWER_PROCESSING_GUIDE = ANSWER_PROCESSING_GUIDE;
2923
2929
  exports.COLOR_THEME_ATTRIBUTE = COLOR_THEME_ATTRIBUTE;
2924
2930
  exports.COLOR_THEME_SOURCE_ATTRIBUTE = COLOR_THEME_SOURCE_ATTRIBUTE;
2931
+ exports.COMPACTION_RULE = COMPACTION_RULE;
2925
2932
  exports.DIRECTIVE_NAMES = DIRECTIVE_NAMES;
2926
2933
  exports.DIRECTIVE_VOCABULARY = DIRECTIVE_VOCABULARY;
2927
2934
  exports.DOC_STATUSES = DOC_STATUSES;