Skip to content

Migrate Financials beta cmdlet configuration and regenerate v3 module - #3899

Open
Ramses Sanchez-Hernandez (ramsessanchez) wants to merge 9 commits into
powershell-v3from
ramsessanchez-financials-v3-migration
Open

Ramses Sanchez-Hernandez (ramsessanchez) wants to merge 9 commits into
powershell-v3from
ramsessanchez-financials-v3-migration

Conversation

@ramsessanchez

@ramsessanchez Ramses Sanchez-Hernandez (ramsessanchez) commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

No linked issue; this implements the requested Financials v3 migration and beta generation.

Changes proposed in this pull request

  • Audit only src/Financials/Financials.md: it contains zero shared cmdlet directives, deferred parameter aliases/transforms, or deferred schema/response directives. Keep an honest empty mappings ledger with compatible-spec and legacy lineage evidence. Global and all profile-local readme directives are explicitly ignored and unchanged.
  • Preserve the real beta surface using nine shared natural-path-ID groups covering 23 operations, with root list/get/count defaults. Keep the four ordinary ItemCategory writes: the two item-navigation writes use the documented FinancialCompanyItemCategoryByItem noun because their alternative ItemId/ItemCategoryId sets have no shared minimal default. Apply the user's separate, explicit three terminal /post URI cmdlet exclusions, not a blanket POST exclusion or an invented legacy selection.
  • Include full beta Kiota/client, cmdlet, project and lock outputs, with separate authored and combined profile-generation commit boundaries. Normally integrate powershell-v3 at 6475f3f5beb4908d39ea356db32bf1e0fd3273cb. Fresh generation, compilation, normal-manifest imports and authenticated offline transport gates pass after Remove automatic GET after successful PATCH #3886: PATCH 204 succeeds with no output and no GET; PATCH 200 returns its actual model in one PATCH. Callers explicitly invoke GET independently if desired; no new readback flag.

Supported profile matrix

Profile Result Compiled exports Full build
beta Passed; full queued Kiota + wrapper Release pipeline, exit 0 / OK 713 776.7 seconds; 1170.86 seconds including queue wait
v1.0 Excluded: no compatible Financials specification; not an assertion of API absence N/A Not generated or invoked; no legacy fallback

Compatible beta spec Git blob: 82f1d616cff0416dbd226e02268ebdde6fded7b1. Legacy beta lineage blob: 0b7edf306b1217a3d6fd5c59c3e137bc7969fe28. Both OpenAPI inputs are unchanged.

The complete user-excluded cmdlet operation set is:

POST /financials/companies/{company-id}/journals/{journal-id}/post
POST /financials/companies/{company-id}/purchaseInvoices/{purchaseInvoice-id}/post
POST /financials/companies/{company-id}/salesInvoices/{salesInvoice-id}/post

All 47 other POST operations remain generated, including root/nested journal-line creation, customer creation, and sales-invoice postAndSend, cancel, and send. The 400 Kiota client files, including its lock and all three /post client builders, are byte-identical to the prior client output. No input pruning, manual generated-source edits, #3881 copy, or global framework changes are included; #3881 remains open and deferred.

Preserved commit boundaries

Commit Purpose
9e763b2b06 Original shared-source audit and beta regression coverage
e6179a14ad Natural-ID variants, precise ItemCategory names, current runtime beta API context
318f768925 Explicit user-directed terminal /post cmdlet exclusions
3113a9d48e Original combined full beta client/cmdlet/project/lock generation
dfa9a13635 Normal target integration of #3882 and #3886; no rebase/cherry-pick
2cb7548a92 Final own single-operation PATCH docs/tests, including all 131 beta PATCH routes with derived data on/off
22da94b15f Separate final combined beta corrective generation; unchanged client/locks retained in the profile boundary

The final corrective generation changes 410 cmdlet sources; existing client/project/lock output is genuinely unchanged. Full Git validation covers all 1118 changed paths, not a capped REST file list, and contains only Financials-owned source/generated output plus its dedicated test file. No bin/obj, binaries, packages, logs or evidence artifacts are committed.

Current validation commands and results

Session evidence root: C:\Users\ramsess\.copilot\session-state\5d71a8fa-285b-4ef7-a70b-30621c1de9fb\files\post3886-6475-final.

The full-build/TRX evidence above is unchanged. Current probe-only, actual
in-memory datastore guarded
runtime/media evidence and canonical handoff.json
are in C:\Users\ramsess\.copilot\session-state\5d71a8fa-285b-4ef7-a70b-30621c1de9fb\files\post3886-6475-memory-final.

$EvidenceRoot = 'C:\Users\ramsess\.copilot\session-state\5d71a8fa-285b-4ef7-a70b-30621c1de9fb\files\post3886-6475-final'
$RuntimeEvidenceRoot = 'C:\Users\ramsess\.copilot\session-state\5d71a8fa-285b-4ef7-a70b-30621c1de9fb\files\post3886-6475-memory-final'
$Worktree = 'C:\Users\ramsess\Repos\copilot-worktrees\msgraph-sdk-powershell\ramsessanchez-studious-doodle'
Set-Location -LiteralPath $Worktree
dotnet test .\tools\WrapperGenerator.Tests\WrapperGenerator.Tests.csproj --filter 'FullyQualifiedName~FinancialsDirectiveMigrationTests|FullyQualifiedName~CmdletConfiguratorTests|FullyQualifiedName~NamingTests|FullyQualifiedName~MultiRouteTests|FullyQualifiedName~RequiredQueryTests|FullyQualifiedName~PatchOperationTests|FullyQualifiedName~MutationRouteTests' --no-restore --verbosity minimal --logger 'trx;LogFileName=targeted.trx' --results-directory $EvidenceRoot
# PASS: actual TRX total=450, executed=450, passed=450, failed=0, notExecuted=0.

pwsh -NoProfile -File .\tools\Get-WrapperDirectiveMigrationInventory.ps1 -Module Financials -FailOnUnresolved
# PASS: zero rows; zero mapped/deferred/unresolved shared directives. New user exclusions are not fabricated ledger mappings.

pwsh -NoProfile -NonInteractive -File "$EvidenceRoot\Invoke-FinancialsBetaBuild.ps1" -RepoRoot $Worktree
# PASS: unchanged four-mutex queue invokes the complete command below; no skip flags.
pwsh -NoProfile -NonInteractive -File C:\Users\ramsess\.copilot\session-state\871a5292-dc5b-423e-8083-5165b0006603\files\Invoke-QueuedModuleBuild.ps1 -RepoRoot $Worktree -Module Financials -ApiVersion beta -Configuration Release
# PASS: exit 0, OK, 713 compiled-discovered cmdlets; full-beta.log and build-provenance.json.

dotnet build .\tools\WrapperGenerator\WrapperGenerator.csproj -c Release --no-restore --no-incremental --nologo -v minimal
dotnet build .\src\Financials\wrapper\beta\Microsoft.Graph.Wrapper.Financials.csproj -c Release --no-restore --no-incremental --nologo -v minimal
# PASS: both fresh builds exit 0; generator-no-incremental.log and module-no-incremental.log.

pwsh -NoProfile -NonInteractive -File "$RuntimeEvidenceRoot\Invoke-FinancialsRuntime.ps1" -RepoRoot $Worktree -Environment Global
pwsh -NoProfile -NonInteractive -File "$RuntimeEvidenceRoot\Invoke-FinancialsRuntime.ps1" -RepoRoot $Worktree -Environment USGov
# PASS: both exit 0; fresh normal-manifest imports export 713 cmdlets.

pwsh -NoProfile -NonInteractive -File "$RuntimeEvidenceRoot\Test-FinancialsMedia.ps1" -RepoRoot $Worktree -Environment Global
pwsh -NoProfile -NonInteractive -File "$RuntimeEvidenceRoot\Test-FinancialsMedia.ps1" -RepoRoot $Worktree -Environment USGov
# PASS: both exit 0; existing compiled PUT binary upload/typed Picture result, media GET byte[]/OutFile and genuine confirmation safety.

Both cloud proofs exercise all 27 exact natural-ID/ordinary route alternatives, the three absent cmdlet/retained client exclusions, all 47 retained compiled POST routes, escaped URLs, native optional queries and headers, real typed bodies/results, four PATCH 204 cases with one PATCH / zero objects / no GET while GET is configured to reject, four PATCH 200 cases with one PATCH / the actual typed model, and four independent caller-explicit GET successes and 403 errors. Ten WhatIf cases and ten genuine declined confirmations each send zero HTTP (one prompt per declined mutation); invalid binders fail before HTTP. Collection-create/action/GET/DELETE neighbors, beta cloud roots, unchanged factory BaseAddress, adapter reuse, context/reconnect/disconnect and explicit-token beta behavior pass. Financials has no native required-query operations; mandatory required-query transport cases are not applicable here.

Authentication is the normally packaged adapted 2.41.2 from the designated 4aa86cf9...\authentication-v2-sync\final-source\modules root. All 64 package-file hashes remain unchanged; physical nupkg SHA256 is 2FC09BFE6B70D313BC56DF8ADCCFB1976FB4E90A1898BF8A916B4B8B792898EB. Isolated Kiota version is 1.36.1+fd3bf87790149b87f40f7eae1a5feb9016625943, model parallelism 1. Wrapper output contains exactly its own three DLLs, no dependency preloads, and one correctly sourced Authentication-owned Kiota/RMS/URI/Multipart identity. No assembly injection, overlay, live Graph/OAuth, credential-store use, or Windows PowerShell 5.1 claim.

Supplemental normal-manifest media controls use the existing customer-picture /content route: PUT preserves exact octet-stream bytes and returns the actual typed Picture, while GET returns exact bytes or writes the exact OutFile without pipeline output. WhatIf and a genuine declined PUT confirmation each send zero HTTP (one prompt for the decline). Global and USGov beta URLs, generic headers, token pipeline, unchanged factory client and Authentication-owned dependency identities pass; media-beta-Global.json and media-beta-USGov.json retain the captures.

Runtime isolation correction (probe only): normal Authentication import into
an additional confirmation runspace can reset the shared GraphSession datastore.
The corrected runtime/media probes finish all additional-runspace module
imports first, then reapply the existing normal Set-MgTestDataStore helper
before the initial Connect. They assert the actual reflected shared
GraphSession.DataStore.GetType().FullName is
Microsoft.Graph.Authentication.Test.Mocks.MockDataStore before Connect,
transport, context/reconnect/disconnect/logout and cleanup. Every offline HTTP
capture independently enforces and records that actual type. Both Global and
USGov core/media reruns pass: 70 core checks plus 10 media checks per cloud,
160 actual datastore-boundary checks total. Source/helper hashes, boundaries,
actual types and captures are in the new runtime JSON and canonical handoff.
This does not infer actual credential I/O merely from an earlier datastore type.
The old raw runtime proofs/handoff stay unchanged as historical, not newly
guarded results. No source, Authentication package, build, TRX, generation,
commit, branch head or PR identity changed; the prior 713-export full build,
450-test result, all 400 client hashes and all 64 Authentication hashes remain
valid and are referenced by absolute path/hash in the new handoff.

Evidence and limits: handoff.json retains scalar counters, full Git scope, exact input/source/Auth/tool/queue identities, command exits, normal manifest/assembly hashes and artifact SHA256s. compiled-beta-Global.json and compiled-beta-USGov.json contain actual request/body/header/response captures. Old 47-second compile failures, 844672 implicit-readback/header failures and isolated candidate results remain untouched as historical evidence, not relabeled passes. Current positive checks implement the user-approved no-readback contract. Offline tests do not certify live service validity or every API shape. No normalized beta-prefix/full raw-parity pass is claimed; the two documented ItemCategoryByItem write names and three explicit exclusions intentionally differ from frozen published metadata. Existing YamlReader NU1903 and Authentication managed-identity deprecation warnings remain outside this module scope.

Other links

Record the empty shared directive ledger and compatible beta spec evidence without adding redundant overrides. Pin real beta operation identities and unaffected generator surfaces. Full beta generation remains a separate gate.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Use nine compatible shared variant groups with root defaults and retain alternative item-navigation writes through two exact path-based names. Update runtime beta API context, legacy/current lineage, empty shared-directive audit evidence and on/off regression coverage. Full beta build currently exposes the separate central Post/PostPath builder issue.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Honor the explicit user exclusion of the three exact /post action paths without suppressing collection POSTs or postAndSend. Keep specs and Kiota routes unchanged, preserve natural-ID groups and document this decision separately from the empty shared directive inventory. Regression coverage proves all 47 other POST routes remain generated with derived data on and off.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…ions

Run the full queued beta Release pipeline on normal target 844672d with adapted Authentication 2.41.2 and isolated Kiota 1.36.1. Build succeeds with 713 compiled cmdlets; the Kiota client and original /post builders remain byte-identical to the prior diagnostic output. Preserve projects and generator locks together. New-source tree includes unmodified Kiota trailing whitespace.

Runtime publication remains blocked by the separately tracked generic-header omission on PATCH 204 refetch (#3886); no blanket transport acceptance is claimed.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Preserve all shared natural-ID groups and the three user-approved terminal /post exclusions. Assert every supported beta PATCH emits only its mutation with no implicit GET or readback inputs; document actual 204 no-object and 200 typed-response behavior. Current module/configurator/naming/required-query and PATCH regression gates pass 450 tests on merged target 6475f3f.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Run full Kiota and wrapper beta Release generation on normally merged target 6475f3f after source correction 2cb7548. Preserve the client, all original client routes, locks and project boundary together; client and locks are byte-identical. Generated mutation cmdlets remove implicit GET and use the current generator's schema/query binding. Full pipeline reports OK with 713 compiled cmdlets; fresh no-incremental generator and module builds also succeed.

The three exact terminal /post URI cmdlet exclusions, 47 other POST routes and existing natural-ID groups remain unchanged. No v1.0 generation or unmerged framework overlay.

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

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant