Skip to content

docs: organize completed changes and resolve historical questions - #98

Merged
fx merged 17 commits into
mainfrom
docs/audit-history
Oct 28, 2026
Merged

fx merged 17 commits into
mainfrom
docs/audit-history

Conversation

@fx

@fx fx commented Oct 28, 2026

Copy link
Copy Markdown
Owner

The change index mixed all completed proposals into the main navigation, and historical questions remained unchecked after their answers had landed elsewhere. Group changes 0001–0041 under completed history and triage their 62 questions against current specifications and code.

Resolved questions link their evidence. Deferred decisions retain an owner and a concrete trigger without claiming future behavior is implemented. All document paths, incoming links, machine-readable entries, and proposal-time motivations remain intact.

Contract: docs/changes/0045-organize-change-history.md and docs/specs/architecture/index.md.

Test plan

  • Validate every local documentation link and all existing history paths.
  • Validate unique index entries, statuses, dependencies, and human/machine index consistency.
  • Review all historical question dispositions against specifications and implementation evidence.
  • Run git diff --check.

Copilot AI lite review requested due to automatic review settings October 28, 2026 17:28

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The documentation-only changes address historical questions through evidence-backed resolutions or explicit follow-up ownership, leaving no active issues requiring action.

No open issues 🎉

What changed in this PR

This documentation-only pull request organizes completed change history, adds change 0045 to both indexes, and triages historical open questions with evidence or explicit follow-up ownership.

Changes:

  • Keeps changes 0042–0045 in the primary navigation and groups changes 0001–0041 under completed history.
  • Adds change 0045 to the human- and machine-readable indexes.
  • Resolves evidence-backed historical questions and records owners and triggers for deferred decisions.
  • Review notes: the resolution in change 0029 conflicts with the authoritative Grid specification; change 0045 also uses an inconsistent no-dependency marker and reports a question count that does not match the documented totals.
File Summary
docs/​index.yml Adds the machine-readable entry for change 0045.
docs/​index.md Separates current changes from completed historical changes.
docs/​changes/​0045-organize-change-history.md Documents history organization and question triage.
docs/​changes/​0036-add-embeddable-dialog-components.md Adds follow-up ownership for the deferred demo-host question.
docs/​changes/​0034-add-marketplace-tx-compatibility.md Adds follow-up criteria for compatibility questions.
docs/​changes/​0032-publish-a-linux-arm64-executable.md Adds follow-up criteria for platform and packaging decisions.
docs/​changes/​0031-publish-the-dialogs-and-config-contracts.md Adds follow-up criteria for contract-boundary questions.
docs/​changes/​0030-publish-bundled-capability-contracts.md Adds follow-up criteria for published-contract questions.
docs/​changes/​0029-add-interactive-grid-row-actions.md Records grid row-action decisions and follow-up metadata; one resolution conflicts with the authoritative Grid specification.
docs/​changes/​0028-add-the-grid-plugin.md Adds follow-up criteria for narrow-table behavior.
docs/​changes/​0027-add-multi-cell-select-rows.md Adds follow-up criteria for multi-cell presentation questions.
docs/​changes/​0025-guarantee-cell-width-by-construction.md Adds follow-up criteria for the no-match invariant question.
docs/​changes/​0024-relocate-and-cover-the-demo.md Adds follow-up criteria for coverage-root discovery.
docs/​changes/​0023-render-sub-dialogs-as-columns.md Adds follow-up criteria for column overflow and filter behavior.
docs/​changes/​0022-exempt-and-verify-the-tx-self-update.md Adds follow-up criteria for delegated update behavior.
docs/​changes/​0021-restyle-dialogs-as-norton-commander.md Adds follow-up criteria for accessibility and narrow-terminal behavior.
docs/​changes/​0020-add-select-filter-and-viewport.md Adds follow-up criteria for viewport policy questions.
docs/​changes/​0019-reduce-marketplace-clone-footprint.md Adds follow-up criteria for marketplace module-graph declarations.
docs/​changes/​0015-update-the-tx-executable.md Resolves delegated-version reporting with later evidence.
docs/​changes/​0014-pin-marketplace-versions.md Adds follow-up criteria for marketplace pinning questions.
docs/​changes/​0013-update-installed-marketplaces.md Adds follow-up criteria for marketplace update behavior.
docs/​changes/​0012-add-generic-update-lifecycle.md Adds follow-up criteria for update lifecycle questions.
docs/​changes/​0011-resolve-plugin-dependencies-by-node-rules.md Adds follow-up criteria for dependency-resolution questions.
docs/​changes/​0010-retry-marketplace-clones-over-ssh.md Adds follow-up criteria for SSH retry behavior.
docs/​changes/​0009-skip-quality-commands-for-documentation.md Adds follow-up criteria for workflow and checkout questions.
docs/​changes/​0008-link-local-marketplace-sources.md Adds follow-up criteria for local-marketplace behavior.
docs/​changes/​0007-delegate-dispatch-to-plugins.md Adds follow-up criteria for plugin-dispatch behavior.
docs/​changes/​0006-isolate-plugin-failure-exit-codes.md Adds follow-up criteria for plugin failure behavior.
docs/​changes/​0001-bootstrap-core-cli.md Resolves the initial platform question with later architecture evidence.

Review effort: Lite

@fx
fx merged commit e444678 into main Oct 28, 2026
2 checks passed
@fx
fx deleted the docs/audit-history branch October 28, 2026 17:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants