Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
b9efb2d
Migrate Sites shared directives with complete legacy evidence
ramsessanchez Oct 22, 2026
dc871b6
Regenerate Sites v1.0 Kiota client and cmdlets
ramsessanchez Oct 22, 2026
8cfa5ef
Audit independently proven Sites beta recursive route defaults
ramsessanchez Oct 22, 2026
f91af12
Constrain Sites beta route policy to six ambiguous GET groups
ramsessanchez Oct 22, 2026
592b0f5
Merge powershell-v3 for current Sites migration APIs
ramsessanchez Oct 30, 2026
05a10b3
Align Sites migration with current shared generator APIs
ramsessanchez Oct 30, 2026
f94a3d0
Regenerate Sites v1.0 on merged operation-variant APIs
ramsessanchez Oct 30, 2026
f4b55ca
Generate Sites beta typed client and cmdlets on current APIs
ramsessanchez Oct 30, 2026
b44e613
Pin Sites bridge uniqueness and actual operation kinds
ramsessanchez Oct 30, 2026
a7d8d20
Merge powershell-v3 Authentication closure for Sites acceptance
ramsessanchez Nov 3, 2026
0959c21
Refresh Sites acceptance provenance after Authentication integration
ramsessanchez Nov 3, 2026
66cb03a
Regenerate Sites v1.0 against normal Authentication closure
ramsessanchez Nov 3, 2026
2868d9e
Regenerate Sites beta against normal Authentication closure
ramsessanchez Nov 3, 2026
92d7d28
Merge final PATCH operation target for Sites acceptance
ramsessanchez Nov 6, 2026
ad18c75
Pin Sites PATCH single-operation contract on final target
ramsessanchez Nov 6, 2026
dc1cbf6
Regenerate Sites v1.0 for PATCH single-operation behavior
ramsessanchez Nov 6, 2026
701adaf
Regenerate Sites beta for PATCH single-operation behavior
ramsessanchez Nov 6, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
The diff you're trying to view is too large. We only load the first 3000 changed files.
49 changes: 48 additions & 1 deletion src/Sites/Sites.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,79 +15,126 @@ require:

> see https://github.com/Azure/autorest/blob/master/docs/powershell/directives.md

The wrapper migration inventories only this shared file. Profile-local readmes and
`src/readme.graph.md` are intentionally ignored. Parameter aliases/defaults and
schema/response transforms are deferred. Reviewed method/path/old-ID/new-ID evidence
lives in `wrapper/Sites_directiveMigrationMap.json`; module-specific regressions live
in `tools/WrapperGenerator.Tests/SitesDirectiveMigrationTests.cs`. Original AutoRest
directives remain active.

`wrapper/Sites_multiRouteEvidence.json` records 192 exact recursive termStore
operations behind 84 formerly colliding public names. Published defaults are
independently pinned to Learn's default syntax and unique path-ID contracts, not
the lossy metadata inventory's first URI. All 84 default contracts use the direct
tree. The shared configuration preserves those direct command names and uses
distinct `NestedChild` nouns for the actual `/children/{id}/children` navigation;
both URLs remain reachable without endpoint selectors or mutation merges.
Existing derived v1.0 and curated termStores/singleton behavior remains authoritative.

PATCH commands return only the mutation response. A successful 204 returns no
object and does not issue a GET; callers can invoke the corresponding GET command
explicitly with its independent permissions, headers, and query inputs.

``` yaml
directive:
# Remove invalid paths.
- remove-path-by-operation: group\.site_.*Onenote$|group\.site\.onenote.*$|.*\.onenote\..*\.parent.*|.*\.notebook\.section.*|.*\.sectionGroup\.section.*|.*\.section\.page.*|site\..*_(Create|Get|Update|Delete)Activity$|site\..*\.activity.*|^site_(remove|add)$|^.*site\.(.*_.*SourceColumn|contentType_.*(Base|BaseType|ColumnPosition)|.*_(Get|Create|Update|Delete)Activity|.*\.activity.*|^(user|group|site)_.*Onenote$|.*\.onenote\..*parent.*|.*\.notebook_(Get|Update|Delete)Section.*|.*\.sectionGroup_(Get|Update|Delete)Section.*|.*\.section_(Get|Update|Delete)Page|.*\.section.page.*|.*\.onenote_(List|Create|Update|Delete)(Operation|Resource)|^site_UpdatePage$
# Wrapper migration 1: authorized source correction appends exactly one missing
# terminal ')'. The invalid original below has NO defined match set; .NET reports
# "Not enough )'s" at offset 631. This is a source/behavior correction, not API absence.
# Original invalid selector: group\.site_.*Onenote$|group\.site\.onenote.*$|.*\.onenote\..*\.parent.*|.*\.notebook\.section.*|.*\.sectionGroup\.section.*|.*\.section\.page.*|site\..*_(Create|Get|Update|Delete)Activity$|site\..*\.activity.*|^site_(remove|add)$|^.*site\.(.*_.*SourceColumn|contentType_.*(Base|BaseType|ColumnPosition)|.*_(Get|Create|Update|Delete)Activity|.*\.activity.*|^(user|group|site)_.*Onenote$|.*\.onenote\..*parent.*|.*\.notebook_(Get|Update|Delete)Section.*|.*\.sectionGroup_(Get|Update|Delete)Section.*|.*\.section_(Get|Update|Delete)Page|.*\.section.page.*|.*\.onenote_(List|Create|Update|Delete)(Operation|Resource)|^site_UpdatePage$
# The ledger accounts for the COMPLETE corrected-selector legacy matches in each
# profile and bridges actual surviving routes/IDs, including guarded final action
# or function qualification. Module tests cover suppressions and unaffected neighbors.
- remove-path-by-operation: group\.site_.*Onenote$|group\.site\.onenote.*$|.*\.onenote\..*\.parent.*|.*\.notebook\.section.*|.*\.sectionGroup\.section.*|.*\.section\.page.*|site\..*_(Create|Get|Update|Delete)Activity$|site\..*\.activity.*|^site_(remove|add)$|^.*site\.(.*_.*SourceColumn|contentType_.*(Base|BaseType|ColumnPosition)|.*_(Get|Create|Update|Delete)Activity|.*\.activity.*|^(user|group|site)_.*Onenote$|.*\.onenote\..*parent.*|.*\.notebook_(Get|Update|Delete)Section.*|.*\.sectionGroup_(Get|Update|Delete)Section.*|.*\.section_(Get|Update|Delete)Page|.*\.section.page.*|.*\.onenote_(List|Create|Update|Delete)(Operation|Resource)|^site_UpdatePage$)
# Remove cmdlets
# Wrapper migration 2: suppress beta POST /sites only; neither actual input has a
# root site DELETE. Preserve root GETs/PATCH and the separate group-site actions.
- where:
verb: Remove|New
subject: ^Site$
remove: true
# Wrapper migration 3: all five exact GroupSite page PATCHes are covered by
# directive 1's reviewed OneNote suppression; no redundant override is added.
- where:
verb: Update
subject: ^GroupSiteOnenoteNotebookSectionGroupSectionPage$|^GroupSiteOnenoteNotebookSectionPage$|^GroupSiteOnenotePage$|^GroupSiteOnenoteSectionGroupSectionPage$|^GroupSiteOnenoteSectionPage$
variant: ^(Patch|PatchExpanded|PatchViaIdentity|PatchViaIdentityExpanded)$
remove: true
# Wrapper migration 4: retain existing curated collection/item SubSite renames.
- where:
verb: Get
subject: ^Site$
variant: ^Get1$|^GetViaIdentity1$|^List2$
set:
subject: SubSite
# Wrapper migration 5: exact nested count rename; root SiteCount is unaffected.
- where:
verb: Get
subject: ^SiteCount$
variant: ^Get$|^GetViaIdentity$
set:
subject: SubSiteCount
# Wrapper migration 6: List1 is the /sites/{id}/lists collection. Structural
# naming already emits SiteList and preserves the paired item GET.
- where:
verb: Get
subject: ^(Site)$
variant: ^List1$
set:
subject: $1List
# Wrapper migration 7: retain existing curated GroupSubSite collection/item names.
- where:
verb: Get
subject: ^GroupSite$
variant: ^Get1$|^GetViaIdentity1$|^List2$
set:
subject: GroupSubSite
# Wrapper migration 8: exact nested count rename; parent GroupSiteCount is kept.
- where:
verb: Get
subject: ^GroupSiteCount$
variant: ^Get$|^GetViaIdentity$
set:
subject: GroupSubSiteCount
# Wrapper migration 9: structural naming already emits GroupSiteList for List1.
- where:
verb: Get
subject: ^(GroupSite)$
variant: ^List1$
set:
subject: $1List
# Wrapper migration 10: singleton drive naming already supplies DefaultDrive.
# The group-root drive is absent from both same-module inputs, not fabricated.
- where:
verb: Get
subject: ^(Group|Site|GroupSite)(Drive)$
variant: ^Get$|^GetViaIdentity$
set:
subject: $1Default$2
# Wrapper audit 11: no site-root OneNote operations exist in either actual legacy
# or compatible profile. GroupSite OneNote is not this Site-only selector.
- where:
verb: Get
subject: ^(Site)OnenoteNotebook(RecentNotebook$)
set:
subject: $1$2
# Wrapper migration 12: actual getAllSites function maps published variant Get2
# to AllSite, retaining the existing v1 derived rename and covering beta.
- where:
verb: Get
variant: Get2
subject: ^(Site)$
set:
subject: All$1
# Rename cmdlets that call onenotePatchContent action.
# Wrapper audit 13: no SiteOnenote operations exist in either actual same-profile
# legacy/compatible input; do not invent a successor from GroupSite operations.
- where:
verb: Update
subject: (^SiteOnenote.*)
set:
subject: $1Content
# Wrapper deferred 14: retain the SiteId default/parameter transform unchanged.
- where:
parameter-name: SiteId
verb: Get
Expand Down
Loading
Loading