feat(skill): publish digest-bound discovery with shared Pages

Plan and scope

Closes #520 (closed).

  1. Publish digest-bound .well-known/agent-skills/index.json discovery and flat-root consumer archives while preserving the existing named-root registry packages.
  2. Assemble built documentation and every skill contribution through one shared Pages publisher, preserving hidden assets, multiple skills and explicit release rules in either include order.
  3. Verify actual publisher artifacts with pinned skills@1.9.0, including byte-preserving installation and changed-download refusal; require complete source CI and all owned cleanup before guarded review.

Current-source qualification

Complete renewed source CI and all sixty-four descendant pipelines succeed. All eight Pages assembly/refusal cases, eleven package/schema/discovery cases and ninety-three catalog shell regressions pass. Required image, configuration, documentation and scan checks pass; inherited intentional legacy/ZAP/analysis negative findings remain visible without changing policy.

The actual shared publisher merges real built Docusaurus documentation with the packaged skill and uploads its readable discovery index. The following real pinned installer consumes those exact artifacts: both byte-preserving skill/supporting-file installation and tampered-download refusal pass without skips. Independent artifact inspection also verifies the index digest, flat archive layout and exact source bytes.

Both real connected workflow pipelines and the connected catalog-pipeline/housekeeping contracts pass. All six applicable owned cleanup traces are inspected, including exact Helm/ZAP namespaces, Argo CD application cleanup, native Molecule destruction and ephemeral review teardown. No allocated lifecycle remains active.

Fresh main is included and the executed merge tree equals the source tree. The final thirteen-file task diff and exact source tree are preserved by the rebase; delivered prerequisites are not duplicated. The built installation guide, complete final diff and every feedback/discussion page are checked. The removed preceding review request remained absent until renewed qualification completed.

Release boundary

The integration fixture uses pages: false: it tests the real publisher and installer but does not deploy a public catalog index. Normal tag-release Pages publication and public reachability must be verified before advertising a discovery URL or a new catalog release. Use the same released catalog version for skill and Docusaurus components.

Definition of Done

  • Nothing remains within the requested implementation and MR acceptance scope.
  • Current-source digest discovery, existing-package compatibility and shared Pages acceptance criteria pass.
  • Changes are limited to the task; delivered prerequisites and team changes are preserved.
  • Complete current-source required code/configuration/build/scan/deployment quality checks pass.
  • Actual positive/refusal paths, including both real pinned-installer cases, execute successfully without skips.
  • Final diff and all feedback are checked; source/target are fresh and no rebase is needed.
  • Last complete pipeline succeeds and all applicable owned cleanup is verified.
  • Actual built documentation is reviewed; normal release/publication prerequisites remain explicit.
Edited by Eugene Harold Krabs

Merge request reports

Loading
Loading