Skip to content

chore(release): cut 0.10.0#986

Merged
danielmeppiel merged 1 commit intomainfrom
chore/release-0.10.0
Apr 27, 2026
Merged

chore(release): cut 0.10.0#986
danielmeppiel merged 1 commit intomainfrom
chore/release-0.10.0

Conversation

@danielmeppiel
Copy link
Copy Markdown
Collaborator

TL;DR

Cuts v0.10.0. Five PRs ship since v0.9.4: one user-facing docs add, one CI fix that finally lands the post-release docs deploy, and three maintainer-tooling pieces (pr-description-skill evals + mermaid hardening + Windows CI hotfix). Milestone 0.9.5 was renamed to 0.10.0 and the 40 open items moved to a fresh 0.10.1 bucket.

Changes

  • pyproject.toml: 0.9.4 -> 0.10.0
  • CHANGELOG.md: [Unreleased] promoted to [0.10.0] - 2026-04-27. Each entry is one line answering "so what" for users:
    • Added #980 README conversion block for npx skills add traffic
    • Fixed #981 docs auto-deploy on tag push (the real fix; #953 had landed an unreachable workflow_call branch)
    • Maintainer tooling #985 evals suite for pr-description-skill (genesis-driven; deterministic, no API key)
    • Maintainer tooling #984 mermaid hardening (diagram-type-by-intent + GH-renderer gotchas)
    • Maintainer tooling #979 Windows CI hotfix (UTF-8 fixture read)

Audit notes

PRs merged since v0.9.4: #985, #984, #981, #980, #979. PR #982 (multi-app shared/apm.md) is intentionally excluded -- still OPEN, blocked on upstream microsoft/apm-action bundles-file: input.

The previous [Unreleased] line crediting #953 for the docs-deploy fix was incorrect (that was the v0.9.4 attempt that left workflow_call unreachable). Re-attributed to #981 and the 0.9.4 entry left as-is.

Milestones

How to ship

Merge -> tag v0.10.0 push triggers build-release.yml -> bot cuts release -> docs.yml (now correctly tag-triggered per #981) deploys docs.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

Copilot AI review requested due to automatic review settings April 27, 2026 10:10
@danielmeppiel danielmeppiel added this to the 0.10.0 milestone Apr 27, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Cuts the v0.10.0 release by updating the Python package version and promoting the changelog entries from Unreleased into a dated 0.10.0 section.

Changes:

  • Bump package version in pyproject.toml from 0.9.4 to 0.10.0.
  • Promote CHANGELOG.md entries into ## [0.10.0] - 2026-04-27 and update the attributions/descriptions for the shipped PRs.
Show a summary per file
File Description
pyproject.toml Updates the project version to 0.10.0 for the release.
CHANGELOG.md Adds the 0.10.0 release section and moves/edits entries to reflect shipped changes.

Copilot's findings

  • Files reviewed: 2/2 changed files
  • Comments generated: 3

Comment thread CHANGELOG.md Outdated
- `pr-description-skill` mermaid guidance hardened: new asset `assets/mermaid-conventions.md` defines diagram-type-by-intent (sequenceDiagram for execution flow with `rect rgb(...)` boxing, flowchart for pipelines/architecture with `classDef new`, stateDiagram-v2 for state machines) and captures GitHub-renderer gotchas that `mmdc` does not always catch (notably: square brackets in flowchart edge labels MUST be quoted -- `|"[label]"|` not `|[label]|`).
- `pr-description-skill` ships an evals suite (genesis-driven): 18 trigger evals on the val-split ship gate + 3 content scenarios with/without the skill loaded (anchor delta +6 to +11 across refactor / docs-only / dep-bump shapes). Runs deterministically without an LLM API key, so PR-description quality regressions are caught in CI. (#985)
- `pr-description-skill` mermaid guidance hardened: new asset `assets/mermaid-conventions.md` defines diagram-type-by-intent (sequenceDiagram for execution flow with `rect rgb(...)` boxing, flowchart for pipelines/architecture with `classDef new`, stateDiagram-v2 for state machines) and captures GitHub-renderer gotchas that `mmdc` does not always catch (notably: square brackets in flowchart edge labels MUST be quoted -- `|"[label]"|` not `|[label]|`). (#984)
- Windows CI no longer crashes on the non-ASCII SKILL.md test fixture (forced UTF-8 read; cp1252 default was raising `UnicodeDecodeError` during test discovery). (#979)
Copy link

Copilot AI Apr 27, 2026

Choose a reason for hiding this comment

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

The #979 changelog entry says the fix was "forced UTF-8 read", but PR #979's stated fix is pinning UTF-8 write encoding for the non-ASCII fixture (so later reads/validation succeed on Windows cp1252). Please adjust this wording to reflect the actual change.

Suggested change
- Windows CI no longer crashes on the non-ASCII SKILL.md test fixture (forced UTF-8 read; cp1252 default was raising `UnicodeDecodeError` during test discovery). (#979)
- Windows CI no longer crashes on the non-ASCII `SKILL.md` test fixture (pins UTF-8 write encoding for the fixture so later reads on Windows `cp1252` do not raise `UnicodeDecodeError` during test discovery). (#979)

Copilot uses AI. Check for mistakes.
Comment thread CHANGELOG.md Outdated

### Added

- README "Coming from `npx skills add`?" conversion block: a 30-second migration table for users arriving from the agentskills.io ecosystem, mapping every `npx skills` verb to its `apm` equivalent. (#980)
Copy link

Copilot AI Apr 27, 2026

Choose a reason for hiding this comment

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

The #980 entry description appears to overclaim what the linked PR did. PR #980 (per its own summary) adds a short "Coming from npx skills add?" block with two apm install examples and a docs link; it does not provide a full verb-by-verb migration table. Please reword this line to match the actual README change so the changelog stays accurate.

Suggested change
- README "Coming from `npx skills add`?" conversion block: a 30-second migration table for users arriving from the agentskills.io ecosystem, mapping every `npx skills` verb to its `apm` equivalent. (#980)
- README adds a "Coming from `npx skills add`?" block with `apm install` examples and a docs link for users migrating from the agentskills.io ecosystem. (#980)

Copilot uses AI. Check for mistakes.
Comment thread CHANGELOG.md Outdated
### Fixed

- Docs site auto-deploys again after bot-cut releases by correctly detecting tag-push context in `docs.yml`. (#953)
- Docs site actually auto-deploys after bot-cut releases now: triggers on tag push instead of via `workflow_call` (the branch added in #953 was unreachable from the bot's release event). (#981)
Copy link

Copilot AI Apr 27, 2026

Choose a reason for hiding this comment

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

This #981 changelog line reads as if the fix was to trigger docs deploy on tag push "instead of" workflow_call, but the underlying change (as described in PR #981) is that docs.yml is still called as a reusable workflow and now correctly detects the caller's tag-push context (github.event_name == 'push' + ref_type == 'tag'). Consider rephrasing to avoid implying workflow_call was removed or replaced.

Suggested change
- Docs site actually auto-deploys after bot-cut releases now: triggers on tag push instead of via `workflow_call` (the branch added in #953 was unreachable from the bot's release event). (#981)
- Docs site actually auto-deploys after bot-cut releases now: `docs.yml` correctly detects the caller's tag-push context via `workflow_call` (the branch added in #953 was unreachable from the bot's release event). (#981)

Copilot uses AI. Check for mistakes.
@danielmeppiel
Copy link
Copy Markdown
Collaborator Author

Audit fixup pushed (a1d35c59):

Could not locate a "marketplace authoring" PR post-v0.9.4 — only 5 PRs landed since the tag: #985, #984, #981, #980, #926. Likely a recall slip with #974 SKILL_BUNDLE / npx skills add parity, which was credited under v0.9.4.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

@danielmeppiel danielmeppiel force-pushed the chore/release-0.10.0 branch 2 times, most recently from 6ebda95 to e628cbc Compare April 27, 2026 14:56
@danielmeppiel
Copy link
Copy Markdown
Collaborator Author

Updated for the post-cut merges (force-pushed e628cbc1, rebased on origin/main):

Final v0.10.0 = 7 PRs: #926, #790, #722, #980, #981, #985, #984, #989. Diff is now just CHANGELOG + pyproject -- branch is clean on top of main.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@danielmeppiel danielmeppiel merged commit ce7a9ac into main Apr 27, 2026
7 checks passed
@danielmeppiel danielmeppiel deleted the chore/release-0.10.0 branch April 27, 2026 15:08
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.

3 participants