Skip to content

[documentation-writing-alignment] Clarify reserved workflow and release interface descriptions #564

New issue
New issue
Open
Task
#582
Open
[documentation-writing-alignment] Clarify reserved workflow and release interface descriptions#564
Task
#582

Description

@MariusStorhaug
Marius Storhaug (MariusStorhaug)
opened on Nov 4, 2026

Context and request

Callers need direct descriptions of reserved workflow, settings and release interfaces. The existing integration coordinator releases strictly natural-language description scalars and native-help prose that preserve the existing condition/effect. This is not permission to change source behavior, contracts, whole files or proposal decisions.

Exact source and region handback

The verified main source is 64ffb1d87f86bd5d487891fdb140b78385a00531. Released surfaces are existing natural-language descriptions and native-help prose in the reserved Cleanup/Get-PSModuleSettings/Publish/Release/Resolve actions, settings-schema description values and reusable-workflow description values. No README, sibling writing path, test or fixture is included.

Verified examples:

Source Released prose change
.github/actions/Release-PSModule/action.yml, blob 33789546e161c48594230196d07f1c62d15c8721, lines 18/22 Direct grammar for the existing WhatIf description, with identical semantics; The working directory where the script will run from becomes Working directory for the script.
.github/workflows/workflow.yml, blob db9a0999cc190d04794a8ff1ea6e85514e2d6093, line 47 Specifies the version ... to be installed becomes Version ... to install, retaining its exact-version constraint.
docs/zensical.toml, blob e32fd2d9ad0a727f4a328555a5016237da4496b7, lines 159-164 Remove or neutralize only the final With your consent ... helping us ... better appeal inside the same description scalar.
.github/zensical.toml, blob 650af9f7605770619b367d5c714ca5e15ca0529a, lines 66-69 The same final consent-appeal edit, inside the existing description scalar.

The same strict grammar/directness allowance applies to existing descriptions/help within these released source areas. Use context anchors; incidental line movement is not a meaning conflict. Unmatched/new proposal-only files are not released and must not be imported.

Protected scope and acceptance criteria

  • Preserve all non-comment program tokens, native help tags/association, exact examples and links, keys, non-description values, defaults, expressions, permissions, outputs, version constraints and existing conditions/effects.
  • Consent keys/actions/defaults and site behavior stay exact. Do not change consent policy or introduce tracking claims. An unverified existing cookie/measurement statement remains a fact-check gap rather than an invented assertion.
  • Do not repair runtime defects, alter test behavior, change the settings schema, amend/wake held proposal branches, merge, change release labels or enable automation/lifecycle settings.
  • Read all candidate help/descriptions and relevant implementation evidence; record changed/no-change/no-prose/protected results and concrete before/after evidence.
  • One fresh-main focused draft PR uses small commits and opens after the first coherent change. One-off token/scalar comparisons and existing parser/help/metadata/lint checks prove the boundary; no repository prose/inventory/implementation-shape snapshot tests, enforcement tool or dependency are added.
  • Descriptions use direct, active en-US prose; procedures keep imperative actions. No supported/shipping/enforcement claim is added from a normative requirement.

The fixed Documentation, Natural Language and Writing Guide govern wording. Native PowerShell/YAML/JSON/TOML formats retain their own contracts.

Implementation plan

  • Verify the coordinator's exact scalar/help handback and example source blobs; replace the blanket ownership hold with released regions.
  • Inventory and read candidate source/help/descriptions; mark protected content and any fact-check gap before editing.
  • Establish parser/non-comment-token/help/example/directive and non-description scalar/raw-text baselines, plus existing relevant checks.
  • Make only released prose changes in small commits and open the focused draft PR early.
  • Recheck source/ownership before each commit; stop only for changed meaning, not incidental line movement.
  • Verify exact scalar/token preservation and wording; run existing checks, record complete acceptance/protected-gap evidence and leave the PR in draft.

Safe-action native help/descriptions remain the separate completed delivery #558. First-pass PRs and all their paths remain unchanged by this Task. Any substantive contract/consent question needs a precise separate follow-up, not a permanent hold on settled wording.

Delivery evidence

The focused draft PSModule/Process-PSModule#582 is finalized at 09d209ee07418174c6835cb64b6977c2740ad962 on interface-description-prose, from fresh main base 64ffb1d87f86bd5d487891fdb140b78385a00531. It opened after the first coherent commit. All seven small commits are pushed; the worktree is clean. The final diff modifies 18 files and no other surface.

Complete persistent audit, with each posted body read back from GitHub:

The two region tables cover all 109 exact replacements. YAML/JSON contains 56 revised description values; 102 description candidates have no change, three existing-contract values stay protected, and two TOML values lose only the final appeal. WhatIf retains the exact log-only scope through the action only logs, with the existing no-publish/create/upload clauses intact.

Final local evidence passes: exact raw-text/BOM/EOL and structured metadata boundaries for all 38 candidates; parser/non-comment tokens and flags/AST shape/directives/help tags and association for all eight PowerShell candidates; all 16 exact native examples; eight source-backed output formats and the release None entries; zero PSScriptAnalyzer findings; existing ConvertFrom-Yaml and Test-Json checks; both TOML parses; and git diff --check. The existing Zensical build exits 0 with No issues found on an exact session-local docs copy. All 66 rendered pages omit the appeal and retain the exact remaining consent statement and Accept/Reject labels. Default YAML lint has 152 baseline findings and 138 final findings, with no new rule/region finding; the existing formatting failures are not called a clean lint result.

No local controller, publishing, cleanup, installation, network example, fixture or benchmark is executed. No source behavior, test, fixture, README, Markdown source, plugin, dependency, repository enforcement tool, first-pass path, proposal branch, release label or lifecycle setting changes. Manual material stays local; no full STE-conformance claim is made.

The cookie/measurement statement remains unverified. Retained release-note fallback, settings-description, release-list/retry terminology and imprecise native-output questions are source-cited in the audit; no runtime, policy or owner decision is invented. #574-#576 and #578 remain separate, non-closing context.

Copilot review is explicitly requested at this final head. Its request command succeeds; the captured response contains no completed review. This delivery does not wait on hosted CI/review or certify final-head completion, and does not substitute earlier-head results. No CI/review watcher or waiting shell remains. The PR stays draft and this Task stays open until eventual review and merge. Only this Task is a closing reference.

Activity

  1. Marius Storhaug (MariusStorhaug)
    added the
    Task
    issue type on Nov 4, 2026

  2. MariusStorhaug commented on Nov 4, 2026

    @MariusStorhaug
    Marius Storhaug (MariusStorhaug)
    on Nov 4, 2026
    MemberAuthor

    Recorded the exact scalar/comment handback gate and the separate release, caller/artifact/dependency, and consent behavior decisions. The writing review does not certify unresolved contracts or authorize source/configuration/lifecycle changes.

  3. MariusStorhaug commented on Nov 4, 2026

    @MariusStorhaug
    Marius Storhaug (MariusStorhaug)
    on Nov 4, 2026
    MemberAuthor

    The integration coordinator released strict existing description/native-help prose and the final consent appeal in two verified TOML description values. The current body records source identities and exact code/scalar/condition/behavior preservation. It does not release whole files, proposal-only content, tracking claims, runtime fixes, owner branches, merges or lifecycle settings.

  4. MariusStorhaug commented on Nov 4, 2026

    @MariusStorhaug
    Marius Storhaug (MariusStorhaug)
    on Nov 4, 2026
    MemberAuthor

    Parent independent content acceptance is complete for 09d209ee07418174c6835cb64b6977c2740ad962, compared with main 64ffb1d87f86bd5d487891fdb140b78385a00531.

    The full 18-file diff stays inside the recorded handback: five native-help source files, five action metadata files, five reusable-workflow description files, one settings schema, and two consent description scalars. No README, sibling writing path, test, fixture, proposal-only file, owner branch, release label or lifecycle setting changes.

    Independent parent checks pass:

    • All five changed PowerShell files retain case-sensitive non-comment token text/flags, AST structure, BOM state and zero baseline/head parse errors.
    • All eleven changed YAML/JSON files retain every non-description node. Exactly 56 natural-language description values differ.
    • Both TOML files retain every configuration value except the existing consent description. After whitespace normalization, the only removed text is the final appeal; consent keys/actions/defaults and the original cookie/measurement statement remain unchanged.
    • The complete committed diff passes git diff --check.
    • Hunk review preserves WhatIf's log-only condition/effect, version/range constraints, source names, examples, masks, defaults, outputs and existing release/recovery conditions. Typed help formatting reflects existing source-backed output types, not new behavior.

    The current GitHub read-back shows this exact head as OPEN/DRAFT, with null auto-merge and no pending or failing hosted check. This content acceptance does not mark the PR ready, approve a merge, certify unverified contract/measurement claims, or assert full STE conformance. The author-side complete candidate inventory and final audit remain part of the current delivery record.

  5. MariusStorhaug commented on Nov 4, 2026

    @MariusStorhaug
    Marius Storhaug (MariusStorhaug)
    on Nov 4, 2026
    MemberAuthor

    Final candidate inventory and acceptance evidence

    Final source: 09d209ee07418174c6835cb64b6977c2740ad962 on interface-description-prose; base: 64ffb1d87f86bd5d487891fdb140b78385a00531 on main.

    Draft: #582. The first coherent commit opened this fresh-main draft; seven small commits retain one focused delivery.

    The inventory covers 38 source files, 163 existing description scalars and 22 native-help units. The final diff changes 18 files through 109 exact replacement regions. The descriptions contain 56 revised YAML/JSON values, 102 no-change values, three protected existing-contract values and two final-appeal-only TOML edits. No new help section, example, output contract, file, dependency or repository check is added.

    Every description candidate

    Each linked filename pins the complete base source. The Source column gives exact line spans in that file.

    .github\actions\Cleanup-PSModulePrereleases\action.yml; base blob e9ebcecb916703909f341ce97a137a061cd12538.

    Existing field Classification Exact source
    description revised L2
    inputs.AutoCleanup.description no-change L7
    inputs.ReleaseTag.description no-change L11
    inputs.PullRequest.description no-change L15
    inputs.WhatIf.description revised L19
    inputs.WorkingDirectory.description revised L23

    .github\actions\Get-PSModuleSettings\action.yml; base blob 1a20970101d1fc3af839d0ff8ffdd452f2f5270d.

    Existing field Classification Exact source
    description revised L2
    inputs.Name.description no-change L10
    inputs.SettingsPath.description revised L13
    inputs.Debug.description no-change L16
    inputs.Verbose.description no-change L20
    inputs.Version.description revised L24
    inputs.Prerelease.description no-change L27
    inputs.WorkingDirectory.description revised L31
    inputs.ImportantFilePatterns.description revised L35-L38
    outputs.Settings.description revised L46

    .github\actions\Get-PSModuleSettings\src\Settings.schema.json; base blob a51b90ac7acfe2ab9d454e92b988b1d5d5a8e5c0.

    Existing field Classification Exact source
    description no-change L5
    properties/Name/description no-change L10
    properties/ImportantFilePatterns/description revised L14
    properties/Test/description revised L22
    properties/Test/properties/Skip/description no-change L26
    properties/Test/properties/Linux/description no-change L30
    properties/Test/properties/MacOS/description no-change L34
    properties/Test/properties/Windows/description no-change L38
    properties/Test/properties/SourceCode/description no-change L42
    properties/Test/properties/PSModule/description no-change L46
    properties/Test/properties/Module/description no-change L50
    properties/Test/properties/TestResults/properties/Skip/description revised L57
    properties/Test/properties/CodeCoverage/description no-change L63
    properties/Test/properties/CodeCoverage/properties/Skip/description revised L67
    properties/Test/properties/CodeCoverage/properties/PercentTarget/description no-change L73
    properties/Test/properties/CodeCoverage/properties/StepSummaryMode/description revised L77
    properties/Build/description revised L85
    properties/Build/properties/Skip/description no-change L89
    properties/Build/properties/Module/properties/Skip/description no-change L96
    properties/Build/properties/Docs/description no-change L102
    properties/Build/properties/Docs/properties/Skip/description no-change L106
    properties/Build/properties/Docs/properties/ShowSummaryOnSuccess/description no-change L110
    properties/Build/properties/Site/properties/Skip/description no-change L119
    properties/Publish/description revised L127
    properties/Publish/properties/Module/description no-change L131
    properties/Publish/properties/Module/properties/Skip/description no-change L135
    properties/Publish/properties/Module/properties/AutoCleanup/description protected-existing-contract L139
    properties/Publish/properties/Module/properties/AutoPatching/description no-change L143
    properties/Publish/properties/Module/properties/IncrementalPrerelease/description no-change L147
    properties/Publish/properties/Module/properties/DatePrereleaseFormat/description no-change L151
    properties/Publish/properties/Module/properties/VersionPrefix/description no-change L155
    properties/Publish/properties/Module/properties/MajorLabels/description revised L159
    properties/Publish/properties/Module/properties/MinorLabels/description revised L163
    properties/Publish/properties/Module/properties/PatchLabels/description revised L167
    properties/Publish/properties/Module/properties/IgnoreLabels/description revised L171
    properties/Publish/properties/Module/properties/PrereleaseLabels/description no-change L175
    properties/Publish/properties/Module/properties/UsePRTitleAsReleaseName/description revised L179
    properties/Publish/properties/Module/properties/UsePRBodyAsReleaseNotes/description revised L183
    properties/Publish/properties/Module/properties/UsePRTitleAsNotesHeading/description revised L187
    properties/Publish/properties/Module/properties/ReleaseType/description no-change L196
    properties/Publish/properties/Site/description no-change L202
    properties/Publish/properties/Site/properties/Skip/description revised L206
    properties/Linter/description revised L214
    properties/Linter/properties/Skip/description no-change L218
    properties/Linter/properties/ShowSummaryOnSuccess/description no-change L222
    properties/Linter/properties/env/description no-change L226
    properties/SettingsPath/description no-change L235
    properties/Debug/description no-change L243
    properties/Verbose/description no-change L251
    properties/Version/description no-change L255
    properties/Prerelease/description protected-existing-contract L263
    properties/WorkingDirectory/description no-change L267
    properties/HasImportantChanges/description protected-existing-contract L271
    properties/Run/description revised L275
    definitions/osConfig/properties/Skip/description no-change L284
    definitions/testCategory/properties/Skip/description no-change L293
    definitions/testCategory/properties/Linux/description no-change L297
    definitions/testCategory/properties/MacOS/description no-change L301
    definitions/testCategory/properties/Windows/description no-change L305
    definitions/testSuite/properties/RunsOn/description no-change L314
    definitions/testSuite/properties/OSName/description no-change L318
    definitions/moduleTestSuite/properties/RunsOn/description no-change L331
    definitions/moduleTestSuite/properties/OSName/description no-change L335
    definitions/moduleTestSuite/properties/TestPath/description no-change L339
    definitions/moduleTestSuite/properties/TestName/description no-change L343

    .github\actions\Publish-PSModule\action.yml; base blob d21604d13cde1fa2bf94e6cb3fe3d3db4118c279.

    Existing field Classification Exact source
    description no-change L2
    inputs.Name.description no-change L7
    inputs.ModulePath.description revised L10
    inputs.PSGALLERY_API_KEY.description revised L14
    inputs.PullRequest.description no-change L17
    inputs.WhatIf.description revised L21
    inputs.WorkingDirectory.description revised L25
    inputs.ArtifactName.description revised L29

    .github\actions\Release-PSModule\action.yml; base blob 33789546e161c48594230196d07f1c62d15c8721.

    Existing field Classification Exact source
    description no-change L2
    inputs.Name.description no-change L7
    inputs.ModulePath.description revised L10
    inputs.ArtifactName.description revised L14
    inputs.WhatIf.description revised L18
    inputs.WorkingDirectory.description revised L22
    inputs.UsePRTitleAsReleaseName.description revised L26
    inputs.UsePRBodyAsReleaseNotes.description revised L30
    inputs.UsePRTitleAsNotesHeading.description revised L34
    inputs.ReleaseTag.description no-change L38
    inputs.PullRequest.description no-change L41
    inputs.CommitSha.description no-change L45
    outputs.ReleaseTag.description no-change L51
    outputs.ReleaseUrl.description no-change L54

    .github\actions\Resolve-PSModuleVersion\action.yml; base blob 5192f28fef7242d55fb24fead21570c0ee6e9ebe.

    Existing field Classification Exact source
    description revised L2
    inputs.Settings.description no-change L10
    inputs.Name.description revised L13
    inputs.WorkingDirectory.description revised L16
    inputs.Debug.description no-change L20
    inputs.Verbose.description no-change L24
    inputs.EventPath.description revised L28
    inputs.EventJson.description revised L32
    outputs.Version.description no-change L38
    outputs.Prerelease.description no-change L41
    outputs.FullVersion.description no-change L44
    outputs.ReleaseType.description no-change L47
    outputs.CreateRelease.description no-change L50

    .github\workflows\AfterAll-ModuleLocal.yml; base blob 7671605ec8c0abb56271f9024b0b122cf9e334d2.

    Existing field Classification Exact source
    on.workflow_call.secrets.TestData.description revised L7-L10
    on.workflow_call.inputs.Settings.description no-change L15

    .github\workflows\BeforeAll-ModuleLocal.yml; base blob bd56f376c72042248b41e58d0f20c7643442911e.

    Existing field Classification Exact source
    on.workflow_call.secrets.TestData.description revised L7-L10
    on.workflow_call.inputs.Settings.description no-change L15

    .github\workflows\Build-Docs.yml; base blob a8d2fe6bc18386065825164d44040cb380d03024.

    Existing field Classification Exact source
    on.workflow_call.inputs.Settings.description no-change L8

    .github\workflows\Build-Module.yml; base blob 655e2618c6dad4b91a9a453713b690280e475fba.

    Existing field Classification Exact source
    on.workflow_call.secrets.GitHubAppClientId.description no-change L7
    on.workflow_call.secrets.GitHubAppPrivateKey.description no-change L10
    on.workflow_call.inputs.Settings.description no-change L15
    on.workflow_call.inputs.ArtifactName.description no-change L19

    .github\workflows\Build-Site.yml; base blob 3b334b3335e1cf835e7249cf32a0e73683226250.

    Existing field Classification Exact source
    on.workflow_call.inputs.Settings.description no-change L8

    .github\workflows\Get-CodeCoverage.yml; base blob 1d7f7ccd04e10bf7b94609d37aedf60bd85b1700.

    Existing field Classification Exact source
    on.workflow_call.inputs.Settings.description no-change L8

    .github\workflows\Get-TestResults.yml; base blob 8fb20d3def79676072b44f62bff6ae4a9ca8bc1f.

    Existing field Classification Exact source
    on.workflow_call.inputs.Settings.description no-change L8
    on.workflow_call.inputs.BeforeAllModuleLocalResult.description no-change L12

    .github\workflows\Lint-Repository.yml; base blob 8ed41fe8b9136fa98dccf7257e578f4630752069.

    Existing field Classification Exact source
    on.workflow_call.inputs.Settings.description no-change L8

    .github\workflows\Lint-SourceCode.yml; base blob 1b3db8115ad6382cec59948333d78fabce732969.

    Existing field Classification Exact source
    on.workflow_call.inputs.Settings.description no-change L8

    .github\workflows\Plan.yml; base blob 0e0f1a7b852d92ad9a63d12edea56490b055e967.

    Existing field Classification Exact source
    on.workflow_call.secrets.GitHubAppClientId.description no-change L14
    on.workflow_call.secrets.GitHubAppPrivateKey.description no-change L17
    on.workflow_call.inputs.SettingsPath.description no-change L22
    on.workflow_call.inputs.Debug.description no-change L26
    on.workflow_call.inputs.Verbose.description no-change L31
    on.workflow_call.inputs.Version.description revised L36
    on.workflow_call.inputs.Prerelease.description revised L41
    on.workflow_call.inputs.WorkingDirectory.description revised L46
    on.workflow_call.inputs.ImportantFilePatterns.description revised L51-L54
    on.workflow_call.outputs.Settings.description no-change L62

    .github\workflows\Publish-Module.yml; base blob 4042920c704883f40d1cd1510d97b7d9533b580d.

    Existing field Classification Exact source
    on.workflow_call.secrets.PSGALLERY_API_KEY.description no-change L7
    on.workflow_call.secrets.GitHubAppClientId.description no-change L10
    on.workflow_call.secrets.GitHubAppPrivateKey.description no-change L13
    on.workflow_call.inputs.Settings.description no-change L18

    .github\workflows\Publish-Site.yml; base blob f0ff58bb3dd24a25aea92a6f6084b5faa5dd1ab4.

    Existing field Classification Exact source
    on.workflow_call.inputs.Settings.description no-change L8

    .github\workflows\Test-Module.yml; base blob 1d48d2f642666de1f4f2c964490095bafaee3716.

    Existing field Classification Exact source
    on.workflow_call.inputs.Settings.description no-change L8

    .github\workflows\Test-ModuleLocal.yml; base blob a3945bad4059942e6b2b919985fa12e5f1a572b3.

    Existing field Classification Exact source
    on.workflow_call.secrets.TestData.description revised L7-L10
    on.workflow_call.inputs.Settings.description no-change L15

    .github\workflows\Test-SourceCode.yml; base blob 89465a2a274d6301029837f8d69ac22ebd5fc7d2.

    Existing field Classification Exact source
    on.workflow_call.inputs.Settings.description no-change L8

    .github\workflows\workflow.yml; base blob db9a0999cc190d04794a8ff1ea6e85514e2d6093.

    Existing field Classification Exact source
    on.workflow_call.secrets.PSGALLERY_API_KEY.description no-change L7
    on.workflow_call.secrets.GitHubAppClientId.description no-change L10
    on.workflow_call.secrets.GitHubAppPrivateKey.description no-change L13
    on.workflow_call.secrets.TestData.description revised L16-L27
    on.workflow_call.inputs.SettingsPath.description revised L32
    on.workflow_call.inputs.Debug.description no-change L37
    on.workflow_call.inputs.Verbose.description no-change L42
    on.workflow_call.inputs.Version.description revised L47
    on.workflow_call.inputs.Prerelease.description revised L52
    on.workflow_call.inputs.WorkingDirectory.description revised L57
    on.workflow_call.inputs.ImportantFilePatterns.description revised L62-L65

    docs\zensical.toml; base blob e32fd2d9ad0a727f4a328555a5016237da4496b7.

    Existing field Classification Exact source
    project.extra.consent.description revised-final-appeal-only L159

    .github\zensical.toml; base blob 650af9f7605770619b367d5c714ca5e15ca0529a.

    Existing field Classification Exact source
    project.extra.consent.description revised-final-appeal-only L68

    Every native-help unit

    The table classifies each existing section. Protected includes exact examples and links. No prose means that no such section exists; this PR does not add scaffolding. Native parameter descriptions are listed separately below.

    Unit Revised sections Unchanged/protected sections No-prose sections Base source
    Resolve-WorkflowEventRouting Synopsis None Description, Inputs, Outputs, Notes, Examples, Links .github\actions\Get-PSModuleSettings\src\Get-PSModuleSettings.Helpers.psm1, L1
    Select-PullRequestForPush Synopsis None Description, Inputs, Outputs, Notes, Examples, Links .github\actions\Get-PSModuleSettings\src\Get-PSModuleSettings.Helpers.psm1, L82
    Get-FilesFromGitTree Synopsis None Description, Inputs, Outputs, Notes, Examples, Links .github\actions\Get-PSModuleSettings\src\Get-PSModuleSettings.Helpers.psm1, L112
    Get-FilesFromGitHubComparison Synopsis None Description, Inputs, Outputs, Notes, Examples, Links .github\actions\Get-PSModuleSettings\src\Get-PSModuleSettings.Helpers.psm1, L133
    Get-TestItemsFromFolder Synopsis, Description, Outputs None Inputs, Notes, Examples, Links .github\actions\Get-PSModuleSettings\src\main.ps1, L528
    Find-TestDirectory Synopsis, Description, Outputs None Inputs, Notes, Examples, Links .github\actions\Get-PSModuleSettings\src\main.ps1, L563
    Get-ModuleVersionString Synopsis, Description, Outputs Examples (protected) Inputs, Notes, Links .github\actions\Publish-PSModule\src\Publish-PSModule.Helpers.psm1, L1
    release.ps1 Synopsis, Description, Inputs, Outputs Examples (protected) Notes, Links .github\actions\Release-PSModule\src\release.ps1, L1
    Split-CommaSeparatedList Synopsis Examples (protected) Description, Inputs, Outputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L1
    Read-ActionInput Synopsis, Description, Outputs Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L22
    Get-PublishConfiguration Synopsis, Description, Outputs Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L63
    Get-GitHubPullRequest Synopsis, Description, Outputs Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L123
    Resolve-ReleaseDecision Synopsis, Description, Outputs Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L207
    ConvertFrom-GitHubReleaseJson Synopsis, Description Outputs (protected), Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L338
    Get-GitHubRelease Synopsis, Description Outputs (protected), Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L370
    Get-LatestGitHubVersion Synopsis, Description Outputs (protected), Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L407
    Get-LatestPSGalleryVersion Synopsis, Description Outputs (protected), Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L451
    Get-LatestPublishedVersion Synopsis, Description Outputs (protected), Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L509
    Get-NextPrereleaseNumber Synopsis, Description, Outputs Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L556
    Get-NextModuleVersion Synopsis, Description Outputs (protected), Examples (protected) Inputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L631
    Get-ResolvedModuleVersion Synopsis, Description Outputs (protected) Inputs, Notes, Examples, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L727
    Write-ActionOutput Synopsis Examples (protected) Description, Inputs, Outputs, Notes, Links .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1, L807

    Existing native parameter descriptions

    Unit / parameter Classification Existing description
    Get-TestItemsFromFolder / FolderPath revised The path to the folder to search for test items.
    Find-TestDirectory / Path revised The root path to start searching for directories.
    Get-ModuleVersionString / ModuleVersion no-change The module version from the compiled manifest, in Major.Minor.Patch format.
    Get-ModuleVersionString / Prerelease no-change The prerelease label from the compiled manifest. Empty for a stable release.
    Split-CommaSeparatedList / Value no-change The comma-separated string to split.
    Get-PublishConfiguration / SettingsJson no-change The JSON string containing the module settings.
    Get-GitHubPullRequest / SettingsJson no-change The complete settings object, including normalized workflow context.
    Resolve-ReleaseDecision / Configuration no-change The publish configuration object.
    Resolve-ReleaseDecision / PullRequest no-change The pull request data object.
    ConvertFrom-GitHubReleaseJson / Json no-change The raw JSON returned by 'gh release list'. Empty or null when the command produced no output.
    Get-LatestGitHubVersion / Releases no-change The GitHub releases array to search. Empty or null when the repository has no releases.
    Get-LatestPSGalleryVersion / ModuleName no-change The name of the module to find in the PowerShell Gallery.
    Get-LatestPublishedVersion / GitHubVersion no-change The latest version found in GitHub releases. Null when the repository has no releases.
    Get-LatestPublishedVersion / PSGalleryVersion no-change The latest version found in the PowerShell Gallery. Null when the module is unpublished.
    Get-NextPrereleaseNumber / ModuleName no-change The module name to query in the PowerShell Gallery.
    Get-NextPrereleaseNumber / BaseVersion no-change The base version string without prerelease (e.g. '1.2.3').
    Get-NextPrereleaseNumber / PrereleaseName no-change The sanitized prerelease name derived from the branch name.
    Get-NextPrereleaseNumber / Releases no-change The GitHub releases list. Empty or null when the repository has no releases.
    Get-NextModuleVersion / LatestVersion no-change The current latest published version. Null resolves to a '0.0.0' baseline.
    Get-NextModuleVersion / Decision no-change The release decision object.
    Get-NextModuleVersion / Configuration no-change The publish configuration object.
    Get-NextModuleVersion / ModuleName no-change The name of the module.
    Get-NextModuleVersion / Releases no-change The GitHub releases list, used for incremental prerelease calculation.
    Empty or null when the repository has no releases.
    Get-ResolvedModuleVersion / GitHubVersion no-change The latest version found in GitHub Releases.
    Get-ResolvedModuleVersion / PSGalleryVersion no-change The latest stable version found in the PowerShell Gallery.
    Get-ResolvedModuleVersion / Decision no-change The release decision for this workflow run.
    Get-ResolvedModuleVersion / Configuration no-change The publish configuration object.
    Get-ResolvedModuleVersion / ModuleName no-change The name of the module.
    Get-ResolvedModuleVersion / Releases no-change The GitHub releases list, used for prerelease numbering.
    Write-ActionOutput / Decision no-change The release decision object.
    Write-ActionOutput / NewVersion no-change The resolved next version.

    All 31 existing parameter descriptions are classified. Undocumented parameters remain no-prose; their syntax and binding metadata stay exact.

    No released prose and protected surfaces

    • The cleanup controller, publish controller and resolver src\main.ps1 have no native-help prose. Their complete bytes remain unchanged.
    • Docs.yml, Linter.yml, Release.yml, Test-Actions.yml, Workflow-Test-Default.yml and Workflow-Test-WithManifest.yml have no released reusable-workflow description value. Their complete bytes remain unchanged.
    • Every README, Markdown source, plugin, test, functional fixture tree and first-pass Module authors have direct development and validation procedures #565-Native help and action descriptions state framework behavior directly #570 path stays unchanged. No unmatched proposal-only file is imported.
    • Existing .OUTPUTS entries that describe arrays or PSSemVer without a verified precise native type remain protected. Missing examples/sections remain absent. No output or example is invented.
    • Both consent descriptions retain the complete preceding cookie/measurement statement. Consent keys, actions, defaults, policy and all other configuration values remain exact.

    Protected program and parser evidence

    PowerShell candidate Non-comment tokens AST nodes Parser / flags / requirements / directives / help association
    .github\actions\Cleanup-PSModulePrereleases\src\cleanup.ps1 372 363 PASS
    .github\actions\Get-PSModuleSettings\src\Get-PSModuleSettings.Helpers.psm1 660 436 PASS
    .github\actions\Get-PSModuleSettings\src\main.ps1 4626 4423 PASS
    .github\actions\Publish-PSModule\src\Publish-PSModule.Helpers.psm1 95 45 PASS
    .github\actions\Publish-PSModule\src\publish.ps1 750 700 PASS
    .github\actions\Release-PSModule\src\release.ps1 1362 1237 PASS
    .github\actions\Resolve-PSModuleVersion\src\main.ps1 181 167 PASS
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1 3137 2520 PASS

    Non-comment token text and flags, AST node sequence, requirements, structural directives, native-help tags/association, rendered syntax and parameter binding metadata match the pre-edit source. The rendered syntax comparison excludes only the released parameter-description text that PowerShell repeats inside syntax objects. Object-property order is not semantic; array order remains exact. BOM and line-ending state are checked separately, including U+FEFF decoding before ParseInput. The raw-text comparison accepts only the 109 exact planned replacements and rejects every other byte change.

    Exact condition, constraint, example and link checks

    • PASS: Cleanup-PSModulePrereleases: identical specified condition; only modifies logs; explicit negative effects retained.
    • PASS: Publish-PSModule: identical specified condition; only modifies logs; explicit negative effects retained.
    • PASS: Release-PSModule: identical specified condition; only modifies logs; explicit negative effects retained.
    • PASS: Action exact-version OR range, exact [1.2.0, 2.0.0) example, and both workflow exact-only must constraints retained.
    • PASS: Both artifact-name must-match requirements retained.
    • PASS: Enabled/unset release-title/body alternatives and joint heading/body/H1/PR-number conditions retained; existing fallback claims not certified.
    • PASS: Exact TestData JSON/environment/caller-mapping examples, inheritance limitation, single-line requirement and masking split retained.
    • PASS: Every HTTP(S) link in all 38 candidate files is byte-identical and in the same order.
    • PASS: All 16 native examples and exact file-pattern/version-format examples retained; stable recovery equality condition retained.
    • PASS: Anonymous in-memory negative control: a changed WhatIf default differs from the protected metadata structure.

    Existing commands and results

    Check Result
    Native Parser.ParseInput Eight candidates; zero parse errors; protected token/flag/AST/directive comparisons pass.
    Native Get-Help -Full 22 units inspected from definition-only temporary modules or script help; all 16 examples remain exact. No function body or example runs.
    Native input/output formatting Eight source-backed output entries and the release script's existing None input/output entries use type, blank line and prose. Existing tags and output claims are retained.
    Invoke-ScriptAnalyzer -Settings .github\linters\.powershell-psscriptanalyzer.psd1 All eight candidates: zero findings before and after.
    Existing ConvertFrom-Yaml All ten changed YAML files parse.
    Existing Test-Json -Json '{}' -SchemaFile ...\Settings.schema.json True; schema and anonymous empty settings validate. All non-description schema nodes remain exact.
    YAML default rules Baseline CLI/default-rule findings: 152; final default-rule findings: 138; no new rule/region finding. Existing CRLF, document-start, truthy-key, line-length and comment-spacing findings are not presented as a clean lint result.
    Python tomllib Both complete TOML files parse; only the existing consent description values differ.
    Existing zensical build --clean Exit 0; No issues found. Runs on a byte-for-byte session-local copy of the current docs tree, not on fixtures or a publishing route.
    Rendered HTML All 66 pages omit the final appeal and retain the exact remaining consent statement and Accept/Reject labels. This verifies text, not tracking behavior.
    git diff --check BASE..HEAD Clean. Worktree is clean; all seven commits are pushed.
    Live source/ownership gates Main remains the released base; current #564 handback and first-pass file exclusions are checked before every commit.

    No local publishing, cleanup, installation, network example, fixture or benchmark script runs. No repository check, snapshot test, enforcement tool, dependency, audit Markdown or implementation-shape test is added. No Markdown source changes, so no Markdown rewrite/lint claim is made. Existing standalone actionlint/zizmor validation is disabled by the repository's Linter workflow; no new tool is installed.

    Precise retained factual and contract follow-ups

    Writing and delivery boundaries

    Wording uses the fixed MSXOrg/docs@1b0d4893c8fefabe604d04393068a8ff6f848082 Documentation Model, Natural Language, Writing Guide, Documentation, Markdown, native PowerShell/YAML/GitHub Actions guidance, and Task/PR formats. The official STE overview and FAQ and the local Issue 9 rules/dictionary are consulted. Technical computing/release terms retain their source-backed meanings; no full STE-conformance claim follows from a scan. The manual and extracted material stay local and are not republished.

    Copilot review is explicitly requested at this final head. The command returns success; its captured response has no completed review. Hosted checks are not waited on and final-head completion is not certified. Earlier-head results are not substituted for final-head results. There is no CI/review watcher or waiting shell to stop. The PR stays draft; no merge, ready transition, auto-merge, Agent merge, release-label or lifecycle setting changes.

    The scoped issue-convergence search covers the writing campaign and its source/contract siblings. Only #564 is a closing reference, effective after eventual merge. Other campaign and contract issues remain non-closing context.

  6. MariusStorhaug commented on Nov 4, 2026

    @MariusStorhaug
    Marius Storhaug (MariusStorhaug)
    on Nov 4, 2026
    MemberAuthor

    Exact native-help changed-region inventory

    Final source: 09d209ee07418174c6835cb64b6977c2740ad962 on interface-description-prose; base: 64ffb1d87f86bd5d487891fdb140b78385a00531 on main.

    Draft: #582. The first coherent commit opened this fresh-main draft; seven small commits retain one focused delivery.

    All 50 regions below are exact pre-edit source replacements. Line breaks are retained as <br> inside verbatim text. Source citations pin both immutable revisions. All surrounding text is unchanged. Empty After text means only the cited final appeal is removed.

    Region / path Before After Preserved meaning / guard Immutable sources
    settings-routing-synopsis
    .github\actions\Get-PSModuleSettings\src\Get-PSModuleSettings.Helpers.psm1    		 Resolves release and execution routing from normalized GitHub event state. Resolve release and execution routing from normalized GitHub event state. Imperative native synopsis; no new help section. before L4-L4; after L4-L4
    settings-push-selection-synopsis
    .github\actions\Get-PSModuleSettings\src\Get-PSModuleSettings.Helpers.psm1    		 Selects the merged default-branch pull request associated with a pushed commit. Select the merged default-branch pull request associated with a pushed commit. Same merged/default-branch/pushed-commit restrictions. before L85-L85; after L85-L85
    settings-git-tree-synopsis
    .github\actions\Get-PSModuleSettings\src\Get-PSModuleSettings.Helpers.psm1    		 Returns the files contained in a complete Git tree response. Return the files from a complete Git tree response. Same complete-response restriction. before L115-L115; after L115-L115
    settings-comparison-synopsis
    .github\actions\Get-PSModuleSettings\src\Get-PSModuleSettings.Helpers.psm1    		 Returns files from a complete GitHub compare response. Return files from a complete GitHub compare response. Same complete-response restriction. before L136-L136; after L136-L136
    test-items-synopsis
    .github\actions\Get-PSModuleSettings\src\main.ps1    		 Retrieves test items from a specified folder. Get test items from the specified folder. Imperative native synopsis. before L531-L531; after L531-L531
    test-items-description
    .github\actions\Get-PSModuleSettings\src\main.ps1    		 This function searches for test-related files in the specified folder.
    It looks for configuration files (.Configuration.ps1), container files (.Container.ps1),
    and test files (*.Tests.ps1) in that order of precedence.    		 The function searches the specified folder for test-related files.
    It searches for configuration files (.Configuration.ps1), container files (.Container.ps1),
    and test files (*.Tests.ps1), in that order of precedence.    		 Same three exact file-pattern examples and precedence. before L534-L536; after L534-L536
    test-items-parameter
    .github\actions\Get-PSModuleSettings\src\main.ps1    		 The path to the folder to search for test items. Path to the folder to search for test items. Same FolderPath help association. before L539-L539; after L539-L539
    test-items-output-format
    .github\actions\Get-PSModuleSettings\src\main.ps1    		 System.IO.FileInfo[]
    Returns an array of test-related files found in the folder.    		 System.IO.FileInfo[]

    An array of test-related files from the folder.    		 Retain the exact source-backed type; separate the prose paragraph. before L542-L543; after L542-L544
    test-directories-synopsis
    .github\actions\Get-PSModuleSettings\src\main.ps1    		 Finds test directories recursively. Find test directories recursively. Same recursive scope. before L566-L566; after L567-L567
    test-directories-description
    .github\actions\Get-PSModuleSettings\src\main.ps1    		 This function recursively searches for all directories starting from the specified path.
    It returns a flat array of all directory paths found.    		 The function searches recursively for all directories from the specified path.
    It returns all directory paths in a flat array.    		 Same recursive search and flat-array description; no directory traversal change. before L569-L570; after L570-L571
    test-directories-parameter
    .github\actions\Get-PSModuleSettings\src\main.ps1    		 The root path to start searching for directories. Root path for the directory search. Same Path help association. before L573-L573; after L574-L574
    test-directories-output-format
    .github\actions\Get-PSModuleSettings\src\main.ps1    		 System.String[]
    Returns an array of directory paths.    		 System.String[]

    An array of directory paths.    		 Retain the exact source-backed type; separate the prose paragraph. before L576-L577; after L577-L579
    publish-version-synopsis
    .github\actions\Publish-PSModule\src\Publish-PSModule.Helpers.psm1    		 Builds the SemVer version string that identifies the module itself. Build the SemVer version string that identifies the module. Same module version identity, not the repository tag. before L4-L4; after L4-L4
    publish-version-description
    .github\actions\Publish-PSModule\src\Publish-PSModule.Helpers.psm1    		 Composes the module version and, when there is one, the prerelease label. This is the string the
    PowerShell Gallery and the module manifest understand: Major.Minor.Patch optionally followed by
    -&lt;prerelease&gt;. It never carries the repository's version prefix, because neither the manifest's
    ModuleVersion nor a Gallery package version accepts one.    		 If a prerelease label is present, the function puts the module version and the label together.
    The PowerShell Gallery and the module manifest use this string: Major.Minor.Patch optionally followed by -&lt;prerelease&gt;.
    The string never includes the repository's version prefix.
    Neither the manifest's ModuleVersion nor a Gallery package version accepts a prefix.    		 Same optional prerelease suffix, exact format examples and prefix exclusion. before L7-L10; after L7-L10
    publish-version-output-format
    .github\actions\Publish-PSModule\src\Publish-PSModule.Helpers.psm1    		 String with the module version. System.String

    The module version.    		 Use the existing [OutputType([string])] type in native help format; no new output claim. before L13-L13; after L13-L15
    release-script-synopsis
    .github\actions\Release-PSModule\src\release.ps1    		 Creates or resumes a GitHub release for a versioned PowerShell module artifact. Create or resume a GitHub release for a versioned PowerShell module artifact. Same create/resume alternatives. before L6-L6; after L6-L6
    release-script-description
    .github\actions\Release-PSModule\src\release.ps1    		 Validates the supplied module artifact, creates a GitHub release when its tag does not
    already exist, uploads the artifact ZIP, and reports the result on the source pull request.    		 The script validates the supplied module artifact. If the release tag does not exist, the script creates a GitHub release.
    It uploads the artifact ZIP and reports the result on the source pull request.    		 Same validation, missing-tag creation condition, ZIP upload and source-PR report. before L9-L10; after L9-L10
    release-script-input-format
    .github\actions\Release-PSModule\src\release.ps1    		 None. The Release-PSModule composite action supplies values through environment variables. None

    The Release-PSModule composite action supplies values through environment variables.    		 Same no-pipeline-input claim and environment source; separate type from prose. before L18-L18; after L18-L20
    release-script-output-format
    .github\actions\Release-PSModule\src\release.ps1    		 None. The script writes ReleaseTag and ReleaseUrl to the GitHub Actions output file. None

    The script writes ReleaseTag and ReleaseUrl to the GitHub Actions output file.    		 Same no-pipeline-output claim and exact step output identifiers; separate type from prose. before L21-L21; after L23-L25
    resolve-split-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Splits a comma-separated string into a trimmed, non-empty array. Split a comma-separated string into a trimmed, non-empty array. Same split, trim and non-empty filtering. before L4-L4; after L4-L4
    resolve-input-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Reads and validates action inputs from environment variables. Read and validate action inputs from environment variables. Imperative native synopsis. before L25-L25; after L25-L25
    resolve-input-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Reads the module name and settings JSON from GitHub Actions environment variables.
    Falls back to the repository name when the module name input is not provided.    		 The function reads the module name and settings JSON from GitHub Actions environment variables.
    If the module name input is not provided, it uses the repository name.    		 Same environment inputs and missing-name fallback. before L28-L29; after L28-L29
    resolve-input-output-format
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 PSCustomObject with Name and SettingsJson properties. System.Management.Automation.PSCustomObject

    An object with Name and SettingsJson properties.    		 Existing [OutputType([PSCustomObject])] and literal object shape support this type. before L32-L32; after L32-L34
    resolve-config-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Parses the settings JSON into a publish configuration object. Parse the settings JSON into a publish configuration object. Imperative native synopsis. before L66-L66; after L68-L68
    resolve-config-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Extracts publish module settings including auto-patching flags, version prefix,
    release type, and label classification arrays.    		 The function extracts module publish settings: auto-patching flags, version prefix,
    release type, and label classification arrays.    		 Same configuration fields. before L69-L70; after L71-L72
    resolve-config-output-format
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 PSCustomObject with publish configuration properties. System.Management.Automation.PSCustomObject

    An object with publish configuration properties.    		 Existing [OutputType([PSCustomObject])] and literal object shape support this type. before L73-L73; after L75-L77
    resolve-pr-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Reads normalized pull-request context from settings, with event-payload fallback. Read normalized pull-request context from settings, with event-payload fallback. Same context priority and fallback. before L126-L126; after L130-L130
    resolve-pr-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 The settings action resolves the pull request associated with a default-branch push
    before this action runs. When no pull request exists, a direct push or manual
    dispatch on the default branch still receives release context so it resolves the
    default patch bump.    		 The settings action resolves the pull request for a default-branch push before this action runs.
    If no pull request exists, a direct push or manual dispatch on the default branch receives release context.
    This context resolves the default patch bump.    		 Same default-branch direct-push/manual-dispatch and missing-PR conditions and default patch effect. before L129-L132; after L133-L135
    resolve-pr-output-format
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 PSCustomObject with pull-request metadata, or a default-branch direct-release
    context with no pull-request number.    		 System.Management.Automation.PSCustomObject

    An object with pull-request metadata, or a default-branch direct-release context with no pull-request number.    		 Same two object variants; existing literal PSCustomObject results support the type. No-output branch is not changed. before L135-L136; after L138-L140
    resolve-decision-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Determines whether to publish a release and what kind of version bump to apply. Find whether to publish a release and which version bump to apply. Same release and version-bump decision. before L210-L210; after L214-L214
    resolve-decision-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Evaluates the PR labels against the configured label categories and release type
    to produce a complete release decision.    		 The function evaluates the PR labels against the configured label categories and release type to produce a complete release decision. Same label categories, release type and result. before L213-L214; after L217-L217
    resolve-decision-output-format
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 PSCustomObject with ShouldPublish, CreateRelease, CreatePrerelease, MajorRelease,
    MinorRelease, PatchRelease, HasVersionBump, and PrereleaseName properties.    		 System.Management.Automation.PSCustomObject

    An object with ShouldPublish, CreateRelease, CreatePrerelease, MajorRelease,
    MinorRelease, PatchRelease, HasVersionBump, and PrereleaseName properties.    		 Same eight exact properties and existing PSCustomObject type. before L217-L218; after L220-L223
    resolve-json-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Converts the JSON output of 'gh release list' into a flat array of release objects. Convert the JSON output of 'gh release list' into a flat array of release objects. Same exact command example and array description. before L341-L341; after L346-L346
    resolve-json-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Normalizes the release listing so a repository with no releases, or a command that
    produced no output at all, yields an empty array instead of $null.    		 The function normalizes the release list.
    If the repository has no releases or the command produces no output, the result is an empty array instead of $null.    		 Same no-releases/no-command-output alternatives and empty-array intent; no pipeline contract repair. before L344-L345; after L349-L350
    resolve-releases-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Retrieves all releases from the current GitHub repository. Get all releases from the current GitHub repository. Same existing all-releases claim; gh pagination is not changed or certified. before L373-L373; after L378-L378
    resolve-releases-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Lists the releases of the current repository. A repository that has no releases yet
    produces no output, so callers normalize the result with @() before using it.    		 The function lists releases from the current repository. If the repository has no releases, it produces no output.
    Callers use @() to normalize the result.    		 Same no-output condition and exact @() caller expression. before L376-L377; after L381-L382
    resolve-github-version-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Extracts the latest stable version from a GitHub releases list. Get the latest stable version from a GitHub releases list. Same latest/stable claim. before L410-L410; after L415-L415
    resolve-github-version-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Returns the version of the release marked as latest. A repository that has no releases
    yet - or that has releases but none marked as latest - resolves to '0.0.0' so a brand-new
    module can still be versioned before its first release exists.    		 The function returns the version of the release marked as latest.
    If the repository has no releases or no release has the latest marker, the function returns '0.0.0'.
    This baseline lets the workflow set a module version before the first release.    		 Same latest marker, no-releases/no-latest alternatives and exact '0.0.0' baseline. before L413-L415; after L418-L420
    resolve-gallery-version-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Finds the latest stable version of a module in the PowerShell Gallery. Find the latest stable version of a module in the PowerShell Gallery. Same latest/stable claim. before L454-L454; after L459-L459
    resolve-gallery-version-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Queries the PowerShell Gallery for the latest published version of the module.
    Retries up to five times with a ten-second delay between attempts.    		 The function queries the PowerShell Gallery for the latest published version of the module.
    It retries up to five times, with a ten-second delay between attempts.    		 Same latest query, up-to-five wording and ten-second delay; no network example execution. before L457-L458; after L462-L463
    resolve-published-version-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Returns the highest version between GitHub and the PowerShell Gallery. Return the highest version between GitHub and the PowerShell Gallery. Same comparison. before L512-L512; after L517-L517
    resolve-published-version-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Compares the two known published versions and returns the highest one. A missing
    (null) version is treated as '0.0.0', so a module that has never been released to
    GitHub or published to the PowerShell Gallery resolves to a '0.0.0' baseline.    		 The function compares the two known published versions and returns the highest one.
    If a version is missing (null), the function treats it as '0.0.0'.
    A module with no GitHub release or PowerShell Gallery publication has a '0.0.0' baseline.    		 Same highest-version result, null handling claim and exact baseline. before L515-L517; after L520-L522
    resolve-prerelease-number-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Calculates the next incremental prerelease number across GitHub and PSGallery. Calculate the next incremental prerelease number across GitHub and PSGallery. Same two sources. before L559-L559; after L564-L564
    resolve-prerelease-number-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Queries both GitHub releases and the PowerShell Gallery for existing prereleases
    matching the base version and prerelease name, then returns the next number
    zero-padded to three digits.    		 The function queries GitHub releases and the PowerShell Gallery for prereleases that match the base version and prerelease name.
    It returns the next number, zero-padded to three digits.    		 Same sources, joint version/name filter and zero-padding claim. before L562-L564; after L567-L568
    resolve-prerelease-number-output-format
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 String. A zero-padded three-digit number (e.g. '001'). System.String

    A zero-padded three-digit number (e.g. '001').    		 Existing [OutputType([string])] supports the type. Exact '001' example and three-digit claim remain. before L567-L567; after L571-L573
    resolve-next-version-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Calculates the next module version based on the release decision. Calculate the next module version from the release decision. Same release decision. before L634-L634; after L640-L640
    resolve-next-version-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Increments the current version according to the version bump type (major, minor, or patch),
    then optionally appends a prerelease suffix with support for date-based and incremental numbering.    		 The function increments the current version for the major, minor, or patch version bump.
    It can append a prerelease suffix with date-based and incremental numbering.    		 Same three bump types and optional date/increment suffix support. before L637-L638; after L643-L644
    resolve-resume-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Resolves the next module version and resumes an incomplete stable release when possible. Resolve the next module version and resume an incomplete stable release when possible. Same conditional resume capability. before L730-L730; after L736-L736
    resolve-resume-description
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Normally the highest version from GitHub Releases and the PowerShell Gallery is the
    version baseline. If Gallery contains exactly the stable version implied by the latest
    GitHub release and this run's version bump, Gallery publication succeeded but GitHub
    release creation did not. In that case, return the Gallery version rather than bumping
    again so the workflow can resume the missing GitHub release.    		 The highest version from GitHub Releases and the PowerShell Gallery is normally the version baseline.
    If Gallery contains exactly the stable version implied by the latest GitHub release and this run's version bump,
    Gallery publication succeeded. GitHub release creation did not succeed in this case.
    The function returns the Gallery version instead of another version bump so the workflow can resume the missing GitHub release.    		 Same normal baseline, exact stable-version equality condition and resume-without-another-bump effect; no recovery contract change. before L733-L737; after L739-L742
    resolve-output-synopsis
    .github\actions\Resolve-PSModuleVersion\src\Resolve-PSModuleVersion.Helpers.psm1    		 Emits the resolved version and release type as GitHub Actions step outputs. Write the resolved version and release type as GitHub Actions step outputs. Same step outputs; no output added or redirected. before L810-L810; after L815-L815

  7. MariusStorhaug commented on Nov 4, 2026

    @MariusStorhaug
    Marius Storhaug (MariusStorhaug)
    on Nov 4, 2026
    MemberAuthor

    Exact description/consent changed-region inventory

    Final source: 09d209ee07418174c6835cb64b6977c2740ad962 on interface-description-prose; base: 64ffb1d87f86bd5d487891fdb140b78385a00531 on main.

    Draft: #582. The first coherent commit opened this fresh-main draft; seven small commits retain one focused delivery.

    All 59 regions below are exact pre-edit source replacements. Line breaks are retained as <br> inside verbatim text. Source citations pin both immutable revisions. All surrounding text is unchanged. Empty After text means only the cited final appeal is removed.

    Region / path Before After Preserved meaning / guard Immutable sources
    working-directory
    .github\actions\Cleanup-PSModulePrereleases\action.yml    		 The working directory where the script will run from. Working directory for the script. Same script working directory; no default or path-resolution change. before L23-L23; after L23-L23
    working-directory
    .github\actions\Get-PSModuleSettings\action.yml    		 The working directory where the script will run from. Working directory for the script. Same script working directory; no default or path-resolution change. before L31-L31; after L31-L31
    working-directory
    .github\actions\Publish-PSModule\action.yml    		 The working directory where the script will run from. Working directory for the script. Same script working directory; no default or path-resolution change. before L25-L25; after L25-L25
    working-directory
    .github\actions\Release-PSModule\action.yml    		 The working directory where the script will run from. Working directory for the script. Same script working directory; no default or path-resolution change. before L22-L22; after L22-L22
    working-directory
    .github\actions\Resolve-PSModuleVersion\action.yml    		 The working directory where the script will run from. Working directory for the script. Same script working directory; no default or path-resolution change. before L16-L16; after L16-L16
    artifact-module-path
    .github\actions\Publish-PSModule\action.yml    		 Path to the folder containing the <Name>/ module subdirectory from Build-PSModule. Path to the folder with the <Name>/ module subdirectory from Build-PSModule. The exact <Name>/ layout example and Build-PSModule source stay unchanged. before L10-L10; after L10-L10
    artifact-module-path
    .github\actions\Release-PSModule\action.yml    		 Path to the folder containing the <Name>/ module subdirectory from Build-PSModule. Path to the folder with the <Name>/ module subdirectory from Build-PSModule. The exact <Name>/ layout example and Build-PSModule source stay unchanged. before L10-L10; after L10-L10
    artifact-name-match
    .github\actions\Publish-PSModule\action.yml    		 Name of the uploaded artifact to download. Must match the name used in the upstream upload-artifact step. Name of the uploaded artifact to download. It must match the name used in the upstream upload-artifact step. The required name match retains must; no artifact/output contract change. before L29-L29; after L29-L29
    artifact-name-match
    .github\actions\Release-PSModule\action.yml    		 Name of the uploaded artifact to download. Must match the name used in the upstream upload-artifact step. Name of the uploaded artifact to download. It must match the name used in the upstream upload-artifact step. The required name match retains must; no artifact/output contract change. before L14-L14; after L14-L14
    cleanup-synopsis
    .github\actions\Cleanup-PSModulePrereleases\action.yml    		 Cleanup prerelease GitHub releases associated with the current pull request branch. Delete prerelease GitHub releases associated with the current pull request branch. The same deletion and branch association; no event, tag or retention change. before L2-L2; after L2-L2
    cleanup-whatif
    .github\actions\Cleanup-PSModulePrereleases\action.yml    		 If specified, the action will only log the changes it would make. If specified, the action only logs the changes it would make. Identical If specified condition and log-only effect. Early review keeps only before logs so it limits the action, not merely log content. before L19-L19; after L19-L19
    settings-action-synopsis
    .github\actions\Get-PSModuleSettings\action.yml    		 Get settings for a PowerShell module workflow Get settings for a PowerShell module workflow. Punctuation only. before L2-L2; after L2-L2
    settings-path-formats
    .github\actions\Get-PSModuleSettings\action.yml    		 Path to the settings file (json, yaml/yml, or psd1) Path to the settings file (json, yaml/yml, or psd1). All exact format identifiers remain. before L13-L13; after L13-L13
    settings-module-version-range
    .github\actions\Get-PSModuleSettings\action.yml    		 Specifies the version of the GitHub module to be installed. Accepts an exact version or a NuGet version range (for example '[1.2.0, 2.0.0)'). Version of the GitHub module to install. The action accepts an exact version or a NuGet version range (for example '[1.2.0, 2.0.0)'). The exact-version OR NuGet-range constraint and exact range example remain. before L24-L24; after L24-L24
    settings-important-patterns
    .github\actions\Get-PSModuleSettings\action.yml    		 Newline-separated list of regex patterns that identify important files.
    Changes matching these patterns trigger build, test, and publish stages.
    When set, fully replaces the defaults.    		 Newline-separated list of regular expression patterns that identify
    important files.
    Changes that match these patterns trigger build, test, and publish
    stages.
    When set, the list fully replaces the defaults.    		 Same newline-separated regex list, stage trigger and full-default replacement condition. before L36-L38; after L36-L40
    settings-output-punctuation
    .github\actions\Get-PSModuleSettings\action.yml    		 The complete settings object as JSON, including test suites The complete settings object as JSON, including test suites. Punctuation only; no output route change. before L46-L46; after L48-L48
    publish-api-key
    .github\actions\Publish-PSModule\action.yml    		 PowerShell Gallery API Key. PowerShell Gallery API key. Capitalization only; exact key name is protected. before L14-L14; after L14-L14
    publish-whatif
    .github\actions\Publish-PSModule\action.yml    		 If specified, the action will only log the changes it would make, but will not publish the module. If specified, the action only logs the changes it would make, but does not publish the module. Identical If specified condition, log-only effect and no-publication effect. before L21-L21; after L21-L21
    release-whatif
    .github\actions\Release-PSModule\action.yml    		 If specified, the action will only log the changes it would make, but will not actually create the release or upload artifacts. If specified, the action only logs the changes it would make, but does not create the release or upload artifacts. Identical If specified condition, log-only effect and no-create/no-upload effects. before L18-L18; after L18-L18
    release-title-choice
    .github\actions\Release-PSModule\action.yml    		 When enabled, uses the pull request title as the name for the GitHub release. If not set, the version string is used. When enabled, the action uses the pull request title as the GitHub release name. If not set, it uses the version string. Same enable/unset alternatives. Missing-title fallback remains a separate contract question. before L26-L26; after L26-L26
    release-notes-choice
    .github\actions\Release-PSModule\action.yml    		 When enabled, uses the pull request body as the release notes for the GitHub release. If not set, the release notes are auto-generated. When enabled, the action uses the pull request body as the GitHub release notes. If not set, it auto-generates the release notes. Same enable/unset alternatives. Existing pushed-commit-message fallback discrepancy is not repaired or certified. before L30-L30; after L30-L30
    release-notes-heading
    .github\actions\Release-PSModule\action.yml    		 When enabled along with UsePRBodyAsReleaseNotes, the release notes will begin with the pull request title as a H1 heading followed by the pull request body. The title will reference the pull request number. When enabled with UsePRBodyAsReleaseNotes, the release notes start with the pull request title as an H1 heading. The pull request body follows the heading. The title references the pull request number. Same joint condition, H1 title, body order and PR-number reference. before L34-L34; after L34-L34
    resolve-action-synopsis
    .github\actions\Resolve-PSModuleVersion\action.yml    		 Resolves the next module version from settings, PR labels, GitHub releases, and the PowerShell Gallery. Resolve the next module version from settings, PR labels, GitHub releases, and the PowerShell Gallery. Imperative native action synopsis; same sources. before L2-L2; after L2-L2
    resolve-name-fallback
    .github\actions\Resolve-PSModuleVersion\action.yml    		 Name of the module. When empty, the repository name is used. Module name. When empty, the action uses the repository name. Same empty-name condition and repository-name effect. before L13-L13; after L13-L13
    resolve-event-path
    .github\actions\Resolve-PSModuleVersion\action.yml    		 Path to the GitHub event JSON file. Defaults to the standard GitHub event path. Override for testing. Path to the GitHub event JSON file. The default is the standard GitHub event path. Override for testing. Same default and testing override; expressions remain exact. before L28-L28; after L28-L28
    resolve-event-json
    .github\actions\Resolve-PSModuleVersion\action.yml    		 GitHub event payload as a JSON string. When set, overrides reading from the event file. Use for testing. GitHub event payload as a JSON string. When set, this value overrides the event file. Use for testing. Same set-value precedence and testing purpose. before L32-L32; after L32-L32
    schema-important-patterns
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Regex patterns that identify important files. Changes matching these patterns trigger build, test, and publish stages. Defaults to ['^src/', '^README\.md$'] when not configured. Regular expression patterns that identify important files. Changes that match these patterns trigger build, test, and publish stages. When not configured, the defaults are ['^src/', '^README\.md$']. Same trigger, missing-configuration condition and exact regex examples. before L14-L14; after L14-L14
    schema-test-configuration
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Test configuration settings Test configuration Remove a redundant noun. before L22-L22; after L22-L22
    schema-test-results
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Skip test results collection Skip collection of test results Same skip effect. before L57-L57; after L57-L57
    schema-code-coverage
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Skip code coverage collection Skip collection of code coverage Same skip effect. before L67-L67; after L67-L67
    schema-step-summary-mode
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Mode for displaying step summary Display mode for the step summary Same display setting. before L77-L77; after L77-L77
    schema-build-configuration
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Build configuration settings Build configuration Remove a redundant noun. before L85-L85; after L85-L85
    schema-publish-configuration
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Publish configuration settings Publish configuration Remove a redundant noun. before L127-L127; after L127-L127
    schema-major-labels
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Comma-separated labels that trigger major version bump Comma-separated labels that trigger a major version bump Same major-version trigger. before L159-L159; after L159-L159
    schema-minor-labels
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Comma-separated labels that trigger minor version bump Comma-separated labels that trigger a minor version bump Same minor-version trigger. before L163-L163; after L163-L163
    schema-patch-labels
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Comma-separated labels that trigger patch version bump Comma-separated labels that trigger a patch version bump Same patch-version trigger. before L167-L167; after L167-L167
    schema-ignore-labels
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Comma-separated labels that prevent release Comma-separated labels that prevent a release Same release-prevention effect. before L171-L171; after L171-L171
    schema-release-title
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Use pull request title as the GitHub release name Use the pull request title as the GitHub release name Same title selection. before L179-L179; after L179-L179
    schema-release-body
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Use pull request body as the release notes content Use the pull request body as the release notes content Same body selection. before L183-L183; after L183-L183
    schema-release-heading
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Add pull request title as H1 heading in release notes Add the pull request title as an H1 heading in release notes Same H1 title effect. before L187-L187; after L187-L187
    schema-site-publication
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Skip publishing the generated documentation site Skip publication of the generated documentation site Same publication skip; no site-build or consent change. before L206-L206; after L206-L206
    schema-linter-configuration
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Linter configuration settings Linter configuration Remove a redundant noun. before L214-L214; after L214-L214
    schema-run-evergreen
    .github\actions\Get-PSModuleSettings\src\Settings.schema.json    		 Deprecated. Runtime execution flags are now stored on each phase object. Deprecated. Runtime execution flags are stored on each phase object. Retain the deprecation and owning phase; remove a time-dependent word. before L275-L275; after L275-L275
    workflow-exact-module-version
    .github\workflows\Plan.yml    		 Specifies the version of the GitHub module to be installed. The value must be an exact version. Version of the GitHub module to install. The value must be an exact version. Retain exact-version-only and must; do not import the action's range contract. before L36-L36; after L36-L36
    workflow-exact-module-version
    .github\workflows\workflow.yml    		 Specifies the version of the GitHub module to be installed. The value must be an exact version. Version of the GitHub module to install. The value must be an exact version. Retain exact-version-only and must; do not import the action's range contract. before L47-L47; after L49-L49
    workflow-prerelease-choice
    .github\workflows\Plan.yml    		 Whether to use a prerelease version of the 'GitHub' module. Use a prerelease version of the 'GitHub' module. Same boolean selection; default false is protected. before L41-L41; after L41-L41
    workflow-prerelease-choice
    .github\workflows\workflow.yml    		 Whether to use a prerelease version of the 'GitHub' module. Use a prerelease version of the 'GitHub' module. Same boolean selection; default false is protected. before L52-L52; after L54-L54
    workflow-root-path
    .github\workflows\Plan.yml    		 The path to the root of the repo. Path to the repository root. Same repository-root contract; no path-resolution change. before L46-L46; after L46-L46
    workflow-root-path
    .github\workflows\workflow.yml    		 The path to the root of the repo. Path to the repository root. Same repository-root contract; no path-resolution change. before L57-L57; after L59-L59
    workflow-important-patterns
    .github\workflows\Plan.yml    		 Newline-separated list of regex patterns that identify important files.
    Changes matching these patterns trigger build, test, and publish stages.
    When set, fully replaces the defaults (^src/ and ^README.md$).    		 Newline-separated list of regular expression patterns that identify
    important files.
    Changes that match these patterns trigger build, test, and publish
    stages.
    When set, the list fully replaces the defaults
    (^src/ and ^README.md$).    		 Same newline-separated patterns, stage trigger, full replacement and exact default examples. before L52-L54; after L52-L57
    workflow-important-patterns
    .github\workflows\workflow.yml    		 Newline-separated list of regex patterns that identify important files.
    Changes matching these patterns trigger build, test, and publish stages.
    When set, fully replaces the defaults (^src/ and ^README.md$).    		 Newline-separated list of regular expression patterns that identify
    important files.
    Changes that match these patterns trigger build, test, and publish
    stages.
    When set, the list fully replaces the defaults
    (^src/ and ^README.md$).    		 Same newline-separated patterns, stage trigger, full replacement and exact default examples. before L63-L65; after L65-L70
    workflow-settings-precedence
    .github\workflows\workflow.yml    		 The path to the settings file. Settings in the settings file take precedence over the action inputs. Path to the settings file. Settings in this file take precedence over the action inputs. Same settings-file precedence statement; no runtime precedence repair or certification. before L32-L32; after L34-L34
    workflow-test-data
    .github\workflows\workflow.yml    		 Optional single-line JSON object carrying all data the module test jobs
    (BeforeAll-ModuleLocal, Test-ModuleLocal, AfterAll-ModuleLocal) need, in two maps:
    { "secrets": { "NAME": "value", ... }, "variables": { "NAME": "value", ... } }
    Every entry is exposed as an environment variable the module's Pester tests read via
    $env:<name>. Values under "secrets" are masked in the logs; values under "variables" are not.    		 Optional single-line JSON object with all data the module test jobs
    (BeforeAll-ModuleLocal, Test-ModuleLocal, AfterAll-ModuleLocal) need, in two maps:
    { "secrets": { "NAME": "value", ... }, "variables": { "NAME": "value", ... } }
    The workflow exposes every entry as an environment variable that the
    module's Pester tests read via $env:<name>.
    It masks values under "secrets" in the logs but does not mask values
    under "variables".    		 Exact JSON and environment examples, all three jobs, all entries, and masked/unmasked split remain. before L17-L21; after L17-L23
    workflow-test-data-mapping
    .github\workflows\workflow.yml    		 key, confirm the caller explicitly maps a TestData JSON value; secrets: inherit only passes key, confirm the caller explicitly maps a TestData JSON value. secrets: inherit only passes Split a sentence; retain the explicit caller mapping and exact secrets: inherit limitation. before L26-L26; after L28-L28
    beforeall-test-data
    .github\workflows\BeforeAll-ModuleLocal.yml    		 Optional single-line JSON object with 'secrets' and 'variables' maps. Each entry is exposed
    as an environment variable available to the BeforeAll setup script; 'secrets' values are
    masked in the logs, 'variables' values are not.    		 Optional single-line JSON object with 'secrets' and 'variables' maps.
    The workflow exposes each entry as an environment variable for the
    BeforeAll setup script. It masks 'secrets' values in the logs but does
    not mask 'variables' values.    		 Same optional single-line maps, environment scope, setup script and masking split. before L8-L10; after L8-L11
    afterall-test-data
    .github\workflows\AfterAll-ModuleLocal.yml    		 Optional single-line JSON object with 'secrets' and 'variables' maps. Each entry is exposed
    as an environment variable available to the AfterAll teardown script; 'secrets' values are
    masked in the logs, 'variables' values are not.    		 Optional single-line JSON object with 'secrets' and 'variables' maps.
    The workflow exposes each entry as an environment variable for the
    AfterAll teardown script. It masks 'secrets' values in the logs but
    does not mask 'variables' values.    		 Same optional single-line maps, environment scope, teardown script and masking split. before L8-L10; after L8-L11
    modulelocal-test-data
    .github\workflows\Test-ModuleLocal.yml    		 Optional single-line JSON object with 'secrets' and 'variables' maps. Each entry is exposed
    as an environment variable the module's Pester tests read via $env:<name>; 'secrets' values
    are masked in the logs, 'variables' values are not.    		 Optional single-line JSON object with 'secrets' and 'variables' maps.
    The workflow exposes each entry as an environment variable that the
    module's Pester tests read via $env:<name>. It masks 'secrets' values
    in the logs but does not mask 'variables' values.    		 Same optional maps, exact $env:<name> example, Pester reader and masking split. before L8-L10; after L8-L11
    site-consent-appeal
    docs\zensical.toml    		 With your consent, you're helping us to
    make our documentation better.    		 (removed) Remove only the final appeal. Retain the preceding unverified cookie/measurement statement verbatim and every consent setting. before L162-L163; after L162-L162
    template-consent-appeal
    .github\zensical.toml    		 With your consent, you're helping us to make our documentation better. (removed) Remove only the final appeal. Retain the preceding unverified cookie/measurement statement verbatim and every consent setting. before L68-L68; after L68-L68

  8. MariusStorhaug commented on Nov 4, 2026

    @MariusStorhaug
    Marius Storhaug (MariusStorhaug)
    on Nov 4, 2026
    MemberAuthor

    The confirmed release-list scope discrepancy now has a separate native Bug, #583. Parent read-only reproduction returns 30 releases from the default CLI call while the first REST page contains 100, without claiming that page is complete. The runtime fix and page-boundary behavior regression remain outside this prose delivery. Other cookie/measurement and contract limits retain the exact source-cited audit above; no source, release record, policy or lifecycle change is made.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Task

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions