Skip to content

chore(release): 0.2.0 — public-debut release - #5

Merged
PBNZ merged 4 commits into
mainfrom
release/0.2.0
Jul 6, 2026
Merged

chore(release): 0.2.0 — public-debut release#5
PBNZ merged 4 commits into
mainfrom
release/0.2.0

Conversation

@PBNZ

@PBNZ PBNZ commented Jul 6, 2026

Copy link
Copy Markdown
Owner

What & why

Cuts release 0.2.0 as the public-debut release: fixes the two known scaffolder defects, records the go-public/distribution decision as ADR-0004, and clears the release-hygiene backlog so installed copies can finally update past 0.1.0. Merging closes #2, #3, and #4 (commit footers).

Four conventional commits, in order:

  1. fix(new-repo): track template files swallowed by a global gitignore — a global *private*/env rule had silently kept powershell-module/core/Private/.gitkeep (powershell-module type: scaffold is missing the Private/ folder #2) and docker-compose/core/.env.example (previously unreported) out of git, so fresh clones and installed copies scaffolded incomplete repos. Both are now tracked, plus a repo-level !templates/** negation so it can't recur (verified with git check-ignore).
  2. fix(new-repo): modernise the powershell-module manifest defaultsPowerShellVersion = '7.0', CompatiblePSEditions = @('Core'), Gallery tag hints (powershell-module manifest: PowerShellVersion defaults to 5.1 and CompatiblePSEditions is missing #3). Verified against Microsoft Learn and smoke-tested with Test-ModuleManifest on a rendered manifest.
  3. docs: ADR-0004 — go public with 0.2.0; this repo stays the canonical marketplace; pbnz-skills lists the plugin as a git-subdir reference (listing, not copy). Also documents the alternate install in README and backfills two missing changelog entries.
  4. chore(release): 0.2.0 — version bumps in plugin.json + marketplace.json, category moved to the marketplace entry (flagged by claude plugin validate, now passes with zero warnings), changelog cut and link refs updated.

After merge: tag v0.1.0 (retroactive, at 5329a0d where 0.1.0 was declared) and v0.2.0 (at the merged commit), create the matching GitHub releases, then flip visibility. Merge-commit preserves the four commits; squash is also fine — the tag goes on whatever lands on main.

Checklist

  • One concern per PR (split unrelated changes). (One concern: the 0.2.0 public-debut release.)
  • Conventional Commit title (e.g. feat: …, fix: …, docs: …).
  • CHANGELOG.md updated under ## [Unreleased] if user-visible. (Unreleased cut to [0.2.0] - 2026-07-06.)
  • Validation passes locally (python scripts/*.py; see .github/workflows/validate.yml). (All five pass, plus claude plugin validate with zero warnings.)
  • An ADR added under docs/adr/ for any notable decision. (ADR-0004.)

🤖 Generated with Claude Code

https://claude.ai/code/session_01VZrsZsqCMvyd3CqqyXVsCR

PBNZ and others added 4 commits July 6, 2026 12:57
A global gitignore (*private* and env rules) silently kept two bundled
templates out of git, so fresh clones and installed copies scaffolded
incomplete repos:

- types/powershell-module/core/Private/.gitkeep — the type's own .psm1
  and README rely on Private/ existing
- types/docker-compose/core/.env.example — the committed template the
  type's README and compose.yaml point users at

Track both, and add a repo-level negation for the whole bundled
templates/ tree so a global rule can never silently drop template
payload again (verified with git check-ignore).

Fixes #2

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VZrsZsqCMvyd3CqqyXVsCR
The manifest template advertised PowerShellVersion 5.1 with no
CompatiblePSEditions, while everything else in the type is modern-
PowerShell-only (pwsh CI on ubuntu-latest, Publish-PSResource publish,
Install-PSResource docs). Scaffolds now declare what the type targets:

- PowerShellVersion = '7.0'
- CompatiblePSEditions = @('Core')
- a PSData hint to add the Gallery compatibility tags (PSEdition_Core
  plus OS tags) before publishing

Verified against Microsoft Learn (about_Module_Manifests,
module-psedition-support, package-manifest-affecting-ui) and smoke-
tested with Test-ModuleManifest on a rendered manifest.

Fixes #3

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VZrsZsqCMvyd3CqqyXVsCR
- ADR-0004: go public with 0.2.0; this repo stays the canonical
  marketplace; pbnz-skills lists the plugin as a git-subdir reference
  (a listing, not a copy)
- README: document the pbnz-skills install alternative
- CHANGELOG: backfill the where-things-go guide and naming-conventions
  entries that shipped without changelog lines

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VZrsZsqCMvyd3CqqyXVsCR
Cut the Unreleased backlog into 0.2.0: bump plugin.json and the
marketplace entry to 0.2.0, move category to the marketplace entry,
and date the changelog section. Tags v0.1.0 (retroactive, at the
commit that declared 0.1.0) and v0.2.0 accompany this commit, so
installed copies can finally see that content moved past 0.1.0.

Fixes #4

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VZrsZsqCMvyd3CqqyXVsCR
@PBNZ
PBNZ merged commit 0220ef5 into main Jul 6, 2026
1 check passed
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.

powershell-module type: scaffold is missing the Private/ folder

1 participant