Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions .github/workflows/additional-gallery-candidates.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
name: Additional Gallery package candidate validation
on:
push:
branches: [ci/gallery-all-modules]
paths:
- .github/workflows/additional-gallery-candidates.yml
workflow_dispatch:
permissions:
contents: read
jobs:
folderencoder:
uses: stadub/PowershellScripts/.github/workflows/validate-release-candidate.yml@42814913be33a4662a57dbf011333b96c5fa294f
with:
module: FolderEncoder
version: 2.0.1
source_sha: afb5b7ef10cd53c388d4c6a6b6f6f8d5fb7652d6
automation_sha: 42814913be33a4662a57dbf011333b96c5fa294f
shell:
uses: stadub/PowershellScripts/.github/workflows/validate-release-candidate.yml@42814913be33a4662a57dbf011333b96c5fa294f
with:
module: Shell-Functions
version: 0.0.1
source_sha: 5b83779c7c62cca738dc99770ce3724ed4e7fb85
automation_sha: 42814913be33a4662a57dbf011333b96c5fa294f
uninstall:
uses: stadub/PowershellScripts/.github/workflows/validate-release-candidate.yml@42814913be33a4662a57dbf011333b96c5fa294f
with:
module: MiniModules.Uninstall
version: 1.0.1
source_sha: a351e867d6fdb14a9650fc1d4f12f67e2dcfdf4c
automation_sha: 42814913be33a4662a57dbf011333b96c5fa294f
7 changes: 5 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@ jobs:
./tests/Test-CiRunner.ps1
./tests/Test-CiStructure.ps1
./tests/Test-ReleaseSelection.ps1
./tests/Test-ReleaseVersionReferences.ps1
./tests/Test-GalleryAutomation.ps1
./tests/Test-GalleryKeySetup.ps1
./tests/Test-ReleaseOutput.ps1
Expand Down Expand Up @@ -93,10 +94,12 @@ jobs:
ref: ${{ matrix.source_sha }}
path: module-source
persist-credentials: false
- name: Test release snapshot selection on Windows
- name: Test release selection and Gallery version references on Windows
if: ${{ matrix.module == 'Base64String' && matrix.os == 'windows-latest' }}
shell: pwsh
run: ./tests/Test-ReleaseSelection.ps1
run: |
./tests/Test-ReleaseSelection.ps1
./tests/Test-ReleaseVersionReferences.ps1
- name: Run module checks
shell: pwsh
env:
Expand Down
9 changes: 6 additions & 3 deletions .github/workflows/release-gallery.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ on:
description: Module to release
type: choice
required: true
options: [Bookmarks, 7zip-Archive, Currency-Conv, Base64String, Pipe]
options: [Bookmarks, 7zip-Archive, Currency-Conv, Base64String, Pipe, FolderEncoder, Shell-Functions, MiniModules.Uninstall]
version:
description: Prepared version number (for example, 1.3.0)
description: Version already prepared for this module; see the release version plan
type: string
required: true
create_release:
Expand Down Expand Up @@ -38,12 +38,14 @@ jobs:
- name: Validate request
shell: pwsh
env:
MODULE: ${{ inputs.module }}
VERSION: ${{ inputs.version }}
MUTATE: ${{ inputs.create_release || !inputs.dry_run }}
REF: ${{ github.ref }}
run: |
if ($env:VERSION -notmatch '^\d+\.\d+\.\d+(\.\d+)?$') { throw 'Stable version required' }
if ($env:MUTATE -eq 'true' -and $env:REF -ne 'refs/heads/master') { throw 'Mutations require master' }
if ($env:MUTATE -eq 'true') { ./automation/scripts/gallery/Get-ReleaseConfig.ps1 -Module $env:MODULE -RequirePublication | Out-Null }
- name: Resolve the selected module's reviewed release snapshot
id: snapshot
shell: pwsh
Expand All @@ -67,6 +69,7 @@ jobs:
$config = ./automation/scripts/gallery/Get-ReleaseConfig.ps1 -Module $env:MODULE
git -C source merge-base --is-ancestor $env:SHA "origin/$($config.ReleaseBranch)"
if ($LASTEXITCODE -ne 0) { throw 'Snapshot is not on the configured release branch' }
./automation/scripts/gallery/Test-ReleaseVersionReference.ps1 -Module $env:MODULE -Version $env:VERSION
./automation/scripts/gallery/Build-GalleryPackage.ps1 -Module $env:MODULE -SourceRoot ./source -OutputRoot ./stage -ExpectedVersion $env:VERSION
./automation/scripts/gallery/Assert-SourcePackage.ps1 -Module $env:MODULE -SourceRoot ./source -PackageRoot ./stage
./automation/scripts/gallery/Package-Evidence.ps1 -Module $env:MODULE -Version $env:VERSION -SourceSha $env:SHA -PackageRoot ./stage -EvidencePath ./stage/evidence.json
Expand Down Expand Up @@ -181,7 +184,7 @@ jobs:
env:
MODULE: ${{ inputs.module }}
run: |
$config = ./scripts/gallery/Get-ReleaseConfig.ps1 -Module $env:MODULE
$config = ./scripts/gallery/Get-ReleaseConfig.ps1 -Module $env:MODULE -RequirePublication
"name=$($config.GalleryAccount)" >> $env:GITHUB_OUTPUT
"secret=$($config.GallerySecret)" >> $env:GITHUB_OUTPUT
"Gallery route: $env:MODULE -> $($config.GalleryAccount) ($($config.GallerySecret))" >> $env:GITHUB_STEP_SUMMARY
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/validate-release-candidate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ jobs:
- uses: actions/upload-artifact@v7.0.2
if: always()
with:
name: candidate-${{ matrix.os }}-${{ matrix.shell }}
name: candidate-${{ inputs.module }}-${{ matrix.os }}-${{ matrix.shell }}
path: |
stage/
source/TestResults/*.xml
Expand Down
55 changes: 51 additions & 4 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,9 +85,9 @@ new entries run syntax, manifest (where present), import and export checks, and
source Pester suites when available. Do not hide current FolderEncoder missing-file
or Shell-Functions empty-export failures with allow-failure rules.

Gallery publication remains limited to the original five configured packages.
FolderEncoder, Shell-Functions and Uninstall have no reviewed release branches or
publication configuration. EXportGithub, Git-Functions and shared infrastructure
The original Gallery setup limited publication to five configured packages.
The owner subsequently authorized the three new package candidates documented at
the end of this file; those routes remain review-blocked until separate approval. EXportGithub, Git-Functions and shared infrastructure
are script/infrastructure components rather than formal modules; they do not gain
module or publishing entries from this CI expansion.

Expand Down Expand Up @@ -259,7 +259,8 @@ The owner confirmed module-local WTFPL; preserve it during generation/staging an
use the repository license only as a fallback. Do not relicense other components.
The trusted completion entry maps only #22 to this exact version/SHA, still gated
on actual successful Gallery publish and verification. No upload or issue closure
has occurred; production workflow integration into master remains pending.
has occurred. Production workflow integration was explicitly approved and merged
through PR #31 at master 912d1d9bde07b95299f46eb99add2ae58bd2a0c9.

CI source selection now pins each unchanged module's maintained development ref
to a full SHA and records the identity with test artifacts. Component/release runs
Expand Down Expand Up @@ -296,3 +297,49 @@ The manual release form now selects module and prepared version; it resolves the
configured release tip once, records the full SHA, and reuses it throughout the
run. It does not rewrite source/package versions or publish development directly.
The form becomes visible only after reviewed automation is integrated into master.

## Additional publishing candidates (owner-authorized 2026-11-12)

The owner explicitly added FolderEncoder, Shell-Functions and Uninstall to release
preparation, superseding the earlier five-package publication limit. Verified
Gallery ownership maps FolderEncoder to Stadub. The owner explicitly selected
MiniModules for Shell-Functions and the new package name MiniModules.Uninstall.
Do not claim or relist the legacy Uninstall script owned by DimaStadub.

CI/component identity remains Uninstall; its Gallery manifest/package identity is
MiniModules.Uninstall, RootModule Uninstall.psm1, package directory ./out. The
root standalone generator uses an explicit runtime-file list and module README;
never recursively package the repository. Source and installed checks use the
CiModule mapping. Shell-Functions.psd1 is the canonical package manifest; retain
Shell-Function.psd1 as source compatibility metadata. FolderEncoder keeps its
existing MIT declaration without substituting the repository BSD LICENSE. Other
module licenses, including Base64String WTFPL, remain unchanged.

Versioned release preparation refs are FolderEncoder/release/2.0.1,
Shell-Functions/release/0.0.1 and Uninstall/release/1.0.1. Their candidate PRs must
explicitly include source preparation and generated out/ and remain unmerged
until separate owner approval. All three new config entries have publication
review blocks: read-only QA is allowed, GitHub release creation and upload are not.
Keep the master-only environment, dry-run default and account-specific keys.
See docs/releases/new-module-packaging.md for exact SHAs, evidence and limits.

## Gallery versions as release references (owner direction 2026-11-12)

Use scripts/gallery/version-reference.json and docs/releases/gallery-version-reference.md
as the dated Gallery baseline. Only 7zip-Archive receives a new major bump:
latest listed 1.1.0 -> planned 2.0.0 because automatic runtime downloads are removed
and an installed native runtime is now required. Preserve Base64String 1.3.0 and
the three already validated new-module candidate versions. Do not blanket-bump.

Bookmarks Gallery 3.0.1 has a different cmdlets-based implementation from repository
2.2.0; planned 3.0.2 is explicitly blocked pending exact source reconciliation.
No reachable 3.x source manifest was found. Do not relabel the 2.2 monolith or
invent missing runtime helpers. Currency-Conv latest listed is 1.0.2, but 1.5.0
is registered and unlisted; planned 1.5.1 must follow source/package validation.
Pipe’s reference plan is 1.0.1. These are plans, not prepared release claims.

The workflow checks recorded registered-version and major-version references
before staging; source/out versions must still match and source hashes/tests
must pass. Reference data never rewrites manifests or changes issue mappings.
Refresh Gallery observations before actual rollout. No merge, tag, GitHub release
or Gallery upload is authorized by this version audit.
Loading
Loading