vantage-md 0.9.1 → 0.10.0

package/CHANGELOG.md

@@ -6,6 +6,64 @@ are summarized one section per minor line; the commit log has the rest.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.10.0] - 2026-10-09
+
+The planning page becomes a to-do list of what needs you, every comment box
+saves as you type, and `vantage-check` can ask an agent to fold answered
+questions into their ledgers.
+
+### Changed
+
+**The planning page shows what needs you, and counts the rest.** *Needs you*
+now holds only the questions waiting on your reply: 10 cards at a time, or 20,
+30 or 50 if you choose, with no pages. Questions you have answered gather as
+one-line rows at the top, and ✅ questions leave it. Answering a card shrinks
+it to a row where it stands, and the next question joins the end. *Blocked*
+and a new *Maintenance* group, which holds *Not on a roadmap*, *Ready to
+build*, *Ready to graduate*, *Stage conflict* and the ✅ questions, are folded
+until you open them. The section bar is gone, and the contents column is now
+titled *On this page*. See [Needs you](userguide/guides/planning.md#needs-you).
+
+**Nothing moves while you read.** An agent's reply, an answer you gave in
+another tab or an edited document now marks what it concerns, such as **New
+reply**, and is counted in the header as *3 updates · Refresh*. Press
+**Refresh** to lay the page out again. See
+[Late changes and Refresh](userguide/guides/planning.md#late-changes-and-refresh).
+
+**Copy answers + maintenance** replaces Copy all agent requests. It copies
+what Copy answers copies, then the agent requests for the kinds of maintenance
+you check in its panel, which opens on hover or from its ▾. *Ready to build*
+starts unchecked, so a copy never asks an agent to build something by accident.
+See [Copy answers + maintenance](userguide/guides/planning.md#copy-answers--maintenance).
+
+**The filter line says *18 match · 379 hidden*** in place of the notice that
+repeated the filter. Press *379 hidden*, or ✕, to clear the filter, and Back
+brings it back. Enter in the box now takes you to the results. See
+[What the filter line says](userguide/guides/planning.md#what-the-filter-line-says).
+
+**Every comment box saves as you type.** There is no Save and no Cancel, only
+**Close**, and Esc or a click outside the box keeps your text instead of
+throwing it away. A save that fails keeps retrying, and leaving the tab with
+anything unsaved asks first. See
+[Comment boxes save as you type](userguide/features.md#comment-boxes-save-as-you-type).
+
+### Added
+
+**`vantage-check index --request compact`** lists the ✅ questions and asks an
+agent to fold each into its document's Decision Ledger. `--request` with no
+name now prints all five requests. See
+[`vantage-check index`](userguide/guides/vantage-check.md#vantage-check-index).
+
+## [0.9.2] - 2026-10-08
+
+### Fixed
+
+- `vantage-check` no longer asks you to link a file that git ignores. If a
+  committed document names a private, gitignored file — a local config file
+  that exists on your machine and nowhere else — the checker used to flag that
+  name on your machine and let it pass in a clean checkout. It now leaves the
+  mention alone. A link you wrote to that file is still checked.
+
 ## [0.9.1] - 2026-10-06
 
 ### Changed

package/dist/index.cjs

@@ -2689,6 +2689,26 @@ function resolveLinks(html, options = {}) {
 * Every rule stated here should be one a checker can enforce or a renderer
 * actually cares about — if a line is neither, it does not belong.
 */
+/**
+* How a ruled question is compacted: the one copy, in the style guide's
+* *Record rulings before downstream work* bullet and in the planning
+* `compact` request, so the two cannot word it differently (P7).
+*/
+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.";
+/**
+* Shared by the style guide and every review clipboard payload. These are
+* authoring instructions, not a claim that the checker measures agent latency.
+*/
+const ANSWER_PROCESSING_GUIDE = `### Record rulings before downstream work
+
+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.
+
+- **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.
+- **Finish a small, coherent document update.** ${COMPACTION_RULE}
+- **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.
+- **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.
+- **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.
+`;
 const STYLE_GUIDE = `## Markdown style guide (for Vantage viewer)
 
 When writing or updating markdown documents that will be viewed in Vantage, follow these conventions:
@@ -2896,6 +2916,7 @@ A question a document leaves for a human to rule on is an *Open Question*, writt
 - **Write a question as a list item.** Outside a list, a question runs from the block its directive lands on through the blocks after it, up to the next heading (for a question written as a heading, the next one of its level or higher), the next rule or the next question, so whatever prose follows it before then is read as part of it. There the directive goes above the question's title, since every viewer reads the question's marker from the block it lands on: a directive below the bold title lands on the block after it, which carries no marker, so every viewer reads the question as open. \`vantage-check\` reports that as \`vantage/question-name\`.
 - **\`oq\` is the name \`question\` replaces.** Vantage keeps reading \`<!-- vantage: oq id=OQ-9 leaning="…" -->\` as it always has, and \`vantage-check\` warns on it (\`vantage/oq-deprecated\`) with the \`question\` to write instead, keys unchanged. Vantage before 0.8 drops \`question\` whole, so a reader still on 0.7 gets no one-click answer and no anchor on a question written with it, and misreads nothing. So keep an \`oq\` on an open question unless you know every reader of the repository is on 0.8 or later. A repository whose readers are still on 0.7 says so with a \`target\` before 0.8, such as \`target = "0.7"\`: there an open question takes \`oq\`, new ones included, and \`vantage-check\` asks for \`oq\` rather than \`question\` on one. **Never put \`oq\` on a \u{1F512} or \u2705 question**: every Vantage before 0.8 offers the one-click button on every \`oq\`, whatever its marker says, and on a question with no leaning it files the literal text "Take the stated leaning." \`vantage-check\` reports that as an error (\`vantage/question-name\`).
 
+${ANSWER_PROCESSING_GUIDE}
 ### Tables, task lists, and math
 - **Tables**: Use standard markdown tables for structured comparisons and schemas.
 - **Task lists**: Use \`- [ ]\` and \`- [x]\` for actionable checklists and status tracking.
@@ -2904,8 +2925,10 @@ A question a document leaves for a human to rule on is an *Open Question*, writt
 `;
 //#endregion
 exports.ALERT_TITLES = ALERT_TITLES;
+exports.ANSWER_PROCESSING_GUIDE = ANSWER_PROCESSING_GUIDE;
 exports.COLOR_THEME_ATTRIBUTE = COLOR_THEME_ATTRIBUTE;
 exports.COLOR_THEME_SOURCE_ATTRIBUTE = COLOR_THEME_SOURCE_ATTRIBUTE;
+exports.COMPACTION_RULE = COMPACTION_RULE;
 exports.DIRECTIVE_NAMES = DIRECTIVE_NAMES;
 exports.DIRECTIVE_VOCABULARY = DIRECTIVE_VOCABULARY;
 exports.DOC_STATUSES = DOC_STATUSES;