diff --git a/website/docs/developer-guide/macos-bundle-updates.md b/website/docs/developer-guide/macos-bundle-updates.md index 73e3a4081c..3e1aa2aab2 100644 --- a/website/docs/developer-guide/macos-bundle-updates.md +++ b/website/docs/developer-guide/macos-bundle-updates.md @@ -81,7 +81,7 @@ conditional publication, and retention. They are not proof of a signed install or actual app replacement. Native macOS packaged-update drivers are part of the existing -[install/update family](../tests/install/BUNDLED_UPDATES.md). The stable gate +[install/update family](https://github.com/NousResearch/hermes-agent/blob/main/tests/install/BUNDLED_UPDATES.md). The stable gate requires signed-package transitions on both architectures. Each acceptance claim needs a successful native run for the exact old/new package pair. Workflow definitions and historical helper results do not establish acceptance diff --git a/website/docs/developer-guide/pm-audit-status.md b/website/docs/developer-guide/pm-audit-status.md index b1358c92eb..6be9d0a51a 100644 --- a/website/docs/developer-guide/pm-audit-status.md +++ b/website/docs/developer-guide/pm-audit-status.md @@ -6,9 +6,9 @@ Subsequent work adds shared bundle assembly, signed-package E2E, the stable release gate, Termux APT distribution, and Python 3.14. Those changes do not retroactively extend earlier test receipts. -For current implementation contracts, use [Package management](../website/docs/reference/package-management.md), +For current implementation contracts, use [Package management](../reference/package-management.md), [shared bundle builds](shared-bundle-builds.md), [stable releases](stable-releases.md), -and [bundled update acceptance](../tests/install/BUNDLED_UPDATES.md). +and [bundled update acceptance](https://github.com/NousResearch/hermes-agent/blob/main/tests/install/BUNDLED_UPDATES.md). This change integrates repairs from the aggregate branch audit. It is not a release certificate. The audit compared `49945b14029e09fef608db9ede899377cdb54e11` @@ -39,7 +39,7 @@ Setup completed, PM published a dependency generation, and PowerShell activation ran the store interpreter and source CLI. A separate PM installation passed its real dependency check. These checks do not prove signed-package installation, updates, or Nix builds. The broader PM plugin/config YAML coupling remains unchanged. -The [developer workflow](../website/docs/reference/package-management.md#developer-workflow) +The [developer workflow](../reference/package-management.md#developer-workflow) distinguishes runtime activation from independent test and editor environments. ## Implemented repairs diff --git a/website/docs/developer-guide/shared-bundle-builds.md b/website/docs/developer-guide/shared-bundle-builds.md index 2411722a86..6253ebae64 100644 --- a/website/docs/developer-guide/shared-bundle-builds.md +++ b/website/docs/developer-guide/shared-bundle-builds.md @@ -2,7 +2,7 @@ Hermes separates dependency preparation, product builds, and distribution packaging. The compiler and agent-assembly interfaces live in -[`scripts/build/README.md`](../scripts/build/README.md). These are current +[`scripts/build/README.md`](https://github.com/NousResearch/hermes-agent/blob/main/scripts/build/README.md). These are current interfaces, not proof that every distribution passed native acceptance. ## Providers, products, and distributions @@ -289,7 +289,7 @@ format on a fresh native runner, then runs the same composer/provider/reply check as install-e2e. Windows universal assembly stages bytes before the smoke; its canary feed is published separately only after both native smoke matrices pass. macOS feed publication and stable candidate acceptance are likewise gated. -See [install and chat acceptance](../tests/install/README.md#post-build-artifact-smoke) +See [install and chat acceptance](https://github.com/NousResearch/hermes-agent/blob/main/tests/install/README.md#post-build-artifact-smoke) for covered formats, checkpoint evidence and the Store/Linux/no-upload limits. `scripts.releases.handoff fetch --public-base URL` downloads a staged artifact diff --git a/website/docs/developer-guide/stable-releases.md b/website/docs/developer-guide/stable-releases.md index 7eb98ce1c0..673e97e5ec 100644 --- a/website/docs/developer-guide/stable-releases.md +++ b/website/docs/developer-guide/stable-releases.md @@ -198,7 +198,7 @@ package identities must agree, and versions must increase. Stable sideload Windows versions must equal the tag's three components plus `.0`; Store packages retain their separate version policy. Missing baseline artifacts are a blocker, not permission to fabricate or skip acceptance. -See [the bundled update contract](../tests/install/BUNDLED_UPDATES.md). +See [the bundled update contract](https://github.com/NousResearch/hermes-agent/blob/main/tests/install/BUNDLED_UPDATES.md). ## Explicit exclusions and policy diff --git a/website/docs/reference/package-management.md b/website/docs/reference/package-management.md index fc4c1252c1..e3f00b2fa4 100644 --- a/website/docs/reference/package-management.md +++ b/website/docs/reference/package-management.md @@ -50,7 +50,7 @@ completion result cannot report success. Correlated PM failures remain in the update receipt, and interrupted restarts retain their fleet obligation. Dependency or build failures never retry through pip or a source re-download. Use `hermes pm repair` for damaged dependency files. See the developer -[source completion ownership note](https://github.com/NousResearch/hermes-agent/blob/main/docs/source-update-completion.md). +[source completion ownership note](../developer-guide/source-update-completion.md). ## Source installs and packaged builds diff --git a/website/sidebars.ts b/website/sidebars.ts index d5ab164574..15e537ebbe 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -854,6 +854,17 @@ const sidebars: SidebarsConfig = { 'developer-guide/trajectory-format', ], }, + { + type: 'category', + label: 'Packaging & Releases', + items: [ + 'developer-guide/source-update-completion', + 'developer-guide/shared-bundle-builds', + 'developer-guide/stable-releases', + 'developer-guide/macos-bundle-updates', + 'developer-guide/pm-audit-status', + ], + }, ], }, {