MVP alpha.13: Moves assurance artifacts from project root to the folder 'runecontext' and updates stale docs

[ZebulonRouseFrantzich]

This pull request updates the documentation, test fixtures, and CLI implementation to introduce and document the v0.1.0-alpha.13 release of RuneContext. It adds support for new upgrade and self-update CLI flows, updates references to the new version throughout the codebase and documentation, and corrects assurance artifact paths for consistency with the project structure.

Release and CLI Feature Updates:

• Updated all documentation and fixtures to reference the new v0.1.0-alpha.13 release, including version tags, compatibility, and upgrade paths. [1] [2] [3] [4] [5] [6]
• Documented and added support for new CLI commands: runectx upgrade cli and runectx upgrade cli apply, enabling preview and execution of CLI self-updates, with explicit documentation of their behavior and options. [1] [2] [3]

Documentation Improvements:

• Enhanced the README.md to describe the new upgrade UX, CLI self-update flows, and improved upgrade rendering. [1] [2] [3] [4]
• Added a reference to the new canonical standard for self-update/runtime asset discovery.

Test Fixture and Compatibility Updates:

• Updated test fixtures and release manifests to reflect the new version, supported upgrade edges, and compatibility information for v0.1.0-alpha.13. [1] [2] [3] [4]

Assurance Path Consistency:

• Fixed assurance baseline and backfill path references in CLI implementations and documentation to consistently use runecontext/assurance/ instead of assurance/. [1] [2] [3] [4]

CLI Behavior and Output:

• Improved CLI dry-run and explain output to use the correct assurance paths, ensuring that plan outputs match the actual file structure. [1] [2] [3]

These changes collectively ensure that the CLI, documentation, and fixtures are aligned with the new release, improve upgrade and self-update workflows, and maintain consistency in assurance artifact handling.

[Copilot]

Pull request overview

Updates RuneContext for the v0.1.0-alpha.13 release by making runecontext/assurance/ the canonical assurance-artifact location, refining upgrade planning/execution to treat explicit migrations as sparse real edges within a version interval, and refreshing docs/fixtures/metadata to match the new release and CLI self-update flows.

Changes:

• Move assurance baseline/receipts/backfill paths from legacy assurance/ to canonical runecontext/assurance/ across CLI, contracts validation, and fixtures.
• Add/enable the real 0.1.0-alpha.12 -> 0.1.0-alpha.13 staged migration (move tree + rewrite baseline imported-evidence paths).
• Refine upgrade planning to select only explicit migration edges inside the current→target interval, keeping version-bump-only upgrades zero-hop when no edges exist; bump release metadata/fixtures to alpha.13.

Reviewed changes

Copilot reviewed 54 out of 58 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
schemas/MACHINE-READABLE-PROFILE.md	Updates generated-artifact examples to reference runecontext/assurance/ baseline path.
runecontext/standards/release/self-update-runtime-asset-discovery.md	Adds a standard requiring executable-anchored runtime/self-update asset discovery.
runecontext/changes/CHG-2026-025-7854-migrate-assurance-artifacts-under-runecontext-for-alpha13-upgrades/verification.md	Adds verification plan for assurance-layout migration across alpha.12→alpha.13.
runecontext/changes/CHG-2026-025-7854-migrate-assurance-artifacts-under-runecontext-for-alpha13-upgrades/tasks.md	Adds task list for implementing assurance-layout migration and tests.
runecontext/changes/CHG-2026-025-7854-migrate-assurance-artifacts-under-runecontext-for-alpha13-upgrades/status.yaml	Introduces change record for assurance layout migration work.
runecontext/changes/CHG-2026-025-7854-migrate-assurance-artifacts-under-runecontext-for-alpha13-upgrades/standards.md	Links applicable standards for the assurance-layout migration change.
runecontext/changes/CHG-2026-025-7854-migrate-assurance-artifacts-under-runecontext-for-alpha13-upgrades/references.md	Captures reference pointers for the assurance-layout migration change.
runecontext/changes/CHG-2026-025-7854-migrate-assurance-artifacts-under-runecontext-for-alpha13-upgrades/proposal.md	Documents proposal and scope for moving assurance artifacts under runecontext/.
runecontext/changes/CHG-2026-025-7854-migrate-assurance-artifacts-under-runecontext-for-alpha13-upgrades/design.md	Documents canonical layout + migration/validation rules for alpha.13 boundary.
runecontext/changes/CHG-2026-024-3756-plan-interval-based-real-migration-edge-discovery-for-project-upgrades/verification.md	Adds verification plan for interval-based explicit migration-edge planning semantics.
runecontext/changes/CHG-2026-024-3756-plan-interval-based-real-migration-edge-discovery-for-project-upgrades/tasks.md	Adds tasks for planner/apply semantics and coverage.
runecontext/changes/CHG-2026-024-3756-plan-interval-based-real-migration-edge-discovery-for-project-upgrades/status.yaml	Introduces change record for interval-based migration-edge discovery.
runecontext/changes/CHG-2026-024-3756-plan-interval-based-real-migration-edge-discovery-for-project-upgrades/standards.md	Links applicable standards for the interval-planning change.
runecontext/changes/CHG-2026-024-3756-plan-interval-based-real-migration-edge-discovery-for-project-upgrades/references.md	Captures reference pointers for the interval-planning change.
runecontext/changes/CHG-2026-024-3756-plan-interval-based-real-migration-edge-discovery-for-project-upgrades/proposal.md	Documents proposal/scope for sparse real migration-edge planning.
runecontext/changes/CHG-2026-024-3756-plan-interval-based-real-migration-edge-discovery-for-project-upgrades/design.md	Documents planner/apply semantics for sparse interval-based migration edges.
runecontext/changes/CHG-2026-022-58d8-refine-project-upgrade-compatibility-and-version-bump-only-semantics/status.yaml	Adds relationship link to the new interval-planning change.
runecontext/changes/CHG-2026-021-6d7e-extend-metadata-descriptor-with-explicit-layout-assurance-and-feature-contracts/status.yaml	Adds relationship link to the new assurance-layout migration change.
runecontext/changes/CHG-2026-017-d68f-add-staged-per-hop-upgrade-execution-and-validation/status.yaml	Adds relationship links to new upgrade-planning and assurance-migration changes.
runecontext/changes/CHG-2026-016-e00c-add-multi-hop-upgrade-path-planning-and-preview-contracts/status.yaml	Adds relationship link to interval-based migration-edge planning change.
runecontext/changes/CHG-2026-015-6da4-add-real-multi-hop-upgrade-planning-and-staged-migration-execution/status.yaml	Adds relationship links to interval planning and assurance-layout migration changes.
README.md	Refreshes docs for upgrade/self-update UX (but still contains alpha.12 references).
nix/release/metadata.nix	Bumps Nix release metadata to 0.1.0-alpha.13.
internal/contracts/mvp_readiness_reference_matrix_test.go	Updates verified fixture expectations for runecontext/assurance/baseline.yaml.
internal/contracts/change_commands_promote_test.go	Updates promotion receipt path expectations to runecontext/assurance/....
internal/contracts/change_commands_helpers_test.go	Updates helper paths for baseline and receipts to runecontext/assurance/....
internal/contracts/change_commands_close_test.go	Updates change receipt path expectations to runecontext/assurance/....
internal/contracts/assurance_validation_test.go	Updates test baselines/receipts to use canonical runecontext/assurance/... paths.
internal/contracts/assurance_runtime_validation.go	Switches runtime validation/discovery to runecontext/assurance/... for baseline/receipts/backfill.
internal/contracts/assurance_runtime_test.go	Updates assurance runtime tests to canonical runecontext/assurance/... paths.
internal/contracts/assurance_runtime_shared.go	Updates captured receipt writer to emit under runecontext/assurance/receipts/....
internal/cli/cli_upgrade_types.go	Registers the real migration edge alpha.12 -> alpha.13 and adds interval migration-edge planner API.
internal/cli/cli_upgrade_planner.go	Uses interval-based migration-edge planning for forward comparable upgrades; keeps fallback path planning otherwise.
internal/cli/cli_upgrade_planner_interval_test.go	Adds unit tests for selecting sparse edges, zero-hop, overlap rejection, and disabling on non-forward intervals.
internal/cli/cli_upgrade_migration.go	Registers hop-specific migration for alpha.12 -> alpha.13 and wires it into apply migration registry.
internal/cli/cli_upgrade_migration_assurance_alpha13.go	Implements assurance-layout migration (move tree + rewrite baseline imported evidence paths).
internal/cli/cli_upgrade_interval_edges.go	Adds helpers for selecting/sorting/checking non-overlapping migration edges within an interval.
internal/cli/cli_upgrade_compatibility_test.go	Adds coverage for interval migration-edge planning behavior in preview output.
internal/cli/cli_upgrade_apply.go	Removes in-file hop executor (moved into dedicated hop execution file).
internal/cli/cli_upgrade_apply_staged_test.go	Adds staged-apply tests for interval version advance and assurance-layout migration + rollback on conflict.
internal/cli/cli_upgrade_apply_hops.go	Adds hop execution that can advance staged version to hop.From before applying each real migration.
internal/cli/cli_metadata_command_test.go	Updates metadata tests to expect explicit upgrade edges populated for registered migrations.
internal/cli/cli_assurance.go	Updates enable dry-run/explain output to use canonical baseline path helper.
internal/cli/cli_assurance_test.go	Updates assurance enable tests to use canonical baseline path helper.
internal/cli/cli_assurance_paths.go	Introduces centralized helpers for canonical assurance baseline/backfill paths.
internal/cli/cli_assurance_enable.go	Switches baseline read/write for enable flow to runecontext/assurance/baseline.yaml.
internal/cli/cli_assurance_capture.go	Updates capture dry-run plan text to reference canonical receipts path.
internal/cli/cli_assurance_backfill.go	Updates backfill dry-run plan to canonical backfill directory.
internal/cli/cli_assurance_backfill_test.go	Updates tests for canonical baseline/backfill/receipts paths and output strings.
internal/cli/cli_assurance_backfill_inputs.go	Updates baseline path + imported-evidence relative-path calculation to canonical backfill path helper.
internal/cli/cli_assurance_backfill_history.go	Writes imported git history into canonical backfill directory; removes unused commit-shortening helper.
fixtures/source-resolution/monorepo/packages/service/runecontext/assurance/baseline.yaml	Adds baseline fixture for monorepo service root under canonical path (indentation inconsistent with profile).
fixtures/release/release-manifest-with-metadata.json	Updates fixture metadata to alpha.13 + explicit upgrade edge alpha.12 -> alpha.13.
fixtures/reference-projects/verified/runecontext/assurance/baseline.yaml	Adds/updates verified reference baseline fixture under canonical assurance path.
fixtures/reference-projects/README.md	Updates reference-project docs to mention runecontext/assurance/ baseline location.
fixtures/reference-projects/monorepo/packages/service/runecontext/assurance/baseline.yaml	Adds baseline fixture for monorepo reference project under canonical path.
fixtures/cli-json-golden/metadata-success.json	Updates golden metadata output to alpha.13 and includes explicit upgrade edge(s).
docs/reference/generated/runecontext-reference.json	Updates generated reference JSON to alpha.13 and includes explicit upgrade edge(s).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 56 out of 69 changed files in this pull request and generated 1 comment.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.