Skip to content

v1.0.2 - release validation patch

Choose a tag to compare

@cooperlarson cooperlarson released this 30 May 22:34
· 122 commits to main since this release

Forgot I added the semver release tooling to this repo and knocked the VERSION out of sync so v1.0.1 release failed. This should release cleanly now.

What's changed

Payload Markdown Docs 1.0.2

This release updates native CLI skill installation defaults and path handling, GitHub release body generation, changelog history collection, documentation, and packaging for the shared payload-markdown skill layout. It also updates Debian packaging paths and docs CTA routing for docs-set targets.

CLI skill installation defaults and path safety

The native CLI now treats skill-data installation as opt-in for npm dependency skill setups, documents related source and exclusion flags, and tightens skill path planning and write validation.

  • Default skill-data installation is disabled and described as opt-in when npm dependency skills are available.
  • CLI help documents the skills source root flag and exclusion flags for skills and LLMS content.
  • Skill install planning separates the primary skill directory from companion package directories.
  • Bundled skill path handling normalizes relative paths, validates safety, and rejects writes outside the target root.

Release body generation and changelog history

Release automation now builds a release body from release notes or the changelog, passes that body into the GitHub release step, and updates changelog collection for full-history handling.

  • The GitHub release workflow prepares a release body file from release notes or the changelog and passes it to the release action.
  • Changelog collection defines an empty-tree SHA constant for full-history handling.
  • Release workflow packaging logic prepares release artifacts from the generated body and asset list steps.

Skill artifact layout and installer guidance

Docs now consistently describe the native installer and agent install commands as creating a sibling payload-markdown skill, and quick start guidance reflects the updated install targets.

  • Docs-package guidance states that the native installer writes the companion payload-markdown skill beside the docs skill.
  • Claude and Codex guidance instructs that install commands create the sibling payload-markdown skill.
  • Quick start instructions reflect the updated Codex and Claude install target directories.
  • Installer workflow docs describe the output trees for both agent skill layouts.

Debian build and install flow

Debian packaging docs and rules now include local setup requirements, force skill-data installation for Debian builds, and install the shared skills root path.

  • Debian build instructions add the local setup steps required before packaging checks.
  • The Debian rules override forces skill-data installation on for the Debian build path.
  • The Debian install manifest installs the shared skills root rather than the older nested skill path.

Docs CTA routing and hero fallback

Docs CTA handling now preserves docsSet through hero fallback and CTA normalization, and set-target links resolve through the docs-set docs href helper.

  • DocsProductHero passes docsSet through the fallback action and CTA normalization flow.
  • CTA normalization resolves set-target links through the docs-set docs href helper instead of the public href helper.
  • The docs CTA button configuration label text was updated to distinguish the docs-route target.