Tons of changes

.build/tasks/generateDocs.ps1

@@ -127,7 +127,19 @@ task generate_docs {
         $newString = "Locale: $HelpCultureInfo"
         (Get-Content -Path "$Output") -replace $oldString, $newString | Set-Content -Path "$Output" -Encoding utf8
 
-        Copy-Item -Path $Output -Destination $helpDestination -Force
+        # Skip overwrite if the only change is the auto-updated ms.date front matter field
+        $destFile = Join-Path $helpDestination (Split-Path $Output -Leaf)
+        $shouldCopy = $true
+        if (Test-Path $destFile) {
+            $newContent      = (Get-Content $Output)   -replace '^ms\.date:.*$', ''
+            $existingContent = (Get-Content $destFile) -replace '^ms\.date:.*$', ''
+            if (($newContent -join "`n") -eq ($existingContent -join "`n")) {
+                $shouldCopy = $false
+            }
+        }
+        if ($shouldCopy) {
+            Copy-Item -Path $Output -Destination $helpDestination -Force
+        }
     }
 
     $newMarkdownModuleFileParams = @{
@@ -141,6 +153,23 @@ task generate_docs {
         Copy-Item -Path $markdownFile -Destination $helpDestination -Force
     }
 
-
-
+    # Generate docs/EXPORTED_COMMANDS.md from the en-US help files (single authoritative run)
+    $exportedCommandsPath = Join-Path $ProjectPath 'docs' 'EXPORTED_COMMANDS.md'
+    $commandNames = Get-ChildItem -Path $helpDestination -Filter '*.md' -File |
+        Where-Object { $_.BaseName -ne $ProjectName } |
+        Select-Object -ExpandProperty BaseName |
+        Sort-Object -Unique
+
+    $exportedLines = [System.Collections.Generic.List[string]]::new()
+    $exportedLines.Add("# Exported Commands (derived from ``docs/en-US``)")
+    $exportedLines.Add("")
+    $exportedLines.Add("This list was generated from the filenames in ``docs/en-US`` and represents the documented public commands in this repository.")
+    $exportedLines.Add("")
+    $exportedLines.Add("Generated on $(Get-Date -Format 'yyyy-MM-dd').")
+    $exportedLines.Add("")
+    foreach ($name in $commandNames) {
+        $exportedLines.Add("- $name")
+    }
+    $exportedLines | Set-Content -Path $exportedCommandsPath -Encoding UTF8
+    Write-Host "EXPORTED_COMMANDS.md written to: $exportedCommandsPath ($($commandNames.Count) commands)"
 }

.devcontainer/devcontainer.json

@@ -1,5 +1,6 @@
 {
   "name": "FabricTools PowerShell Dev",
+	"image": "mcr.microsoft.com/powershell:lts-debian-12",
   "features": {
     "ghcr.io/devcontainers/features/powershell:1": {},
     "ghcr.io/devcontainers/features/git:1": {},

.github/workflows/deploy-preview-module.yml

@@ -33,7 +33,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v5
       with:
         ref: ${{ github.head_ref }}   # checkout the correct branch name
         fetch-depth: 0
@@ -64,7 +64,7 @@ jobs:
     if: ${{ success() && (github.ref == 'refs/heads/develop' || startsWith(github.ref, 'refs/tags/')) }}
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v5
       with:
         ref: ${{ github.head_ref }}   # checkout the correct branch name
         fetch-depth: 0

.github/workflows/pr.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v5
       with:
         ref: ${{github.event.pull_request.head.ref}}
         repository: ${{github.event.pull_request.head.repo.full_name}}   # checkout the correct branch name
@@ -45,7 +45,7 @@ jobs:
     - Build_Stage_Package_Module
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v5
       with:
         ref: ${{github.event.pull_request.head.ref}}
         repository: ${{github.event.pull_request.head.repo.full_name}}   # checkout the correct branch name
@@ -71,7 +71,7 @@ jobs:
     - Build_Stage_Package_Module
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v5
       with:
         ref: ${{github.event.pull_request.head.ref}}
         repository: ${{github.event.pull_request.head.repo.full_name}}   # checkout the correct branch name
@@ -98,7 +98,7 @@ jobs:
     - Build_Stage_Package_Module
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v5
       with:
         ref: ${{github.event.pull_request.head.ref}}
         repository: ${{github.event.pull_request.head.repo.full_name}}   # checkout the correct branch name
@@ -128,7 +128,7 @@ jobs:
     - Test_Stage_test_windows_ps
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v5
       with:
         ref: ${{github.event.pull_request.head.ref}}   # checkout the correct branch name
         repository: ${{github.event.pull_request.head.repo.full_name}}   # checkout the correct branch name

.github/workflows/publish-module.yml

@@ -21,15 +21,15 @@ permissions:
   checks: write # to allow the workflow to create checks
   statuses: write # to allow the workflow to create statuses
 
-name: Deploy Module (only)
+name: Publish Module
 # This workflow is triggered on push to the main branch and deploys the module to the PowerShell Gallery and creates a GitHub Release.
 jobs:
   Build_Stage_Package_Module:
     name: Package Module
     runs-on: ubuntu-latest
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v5
       with:
         ref: ${{ github.head_ref }}   # checkout the triggered ref (branch or tag)
         fetch-depth: 0
@@ -51,7 +51,7 @@ jobs:
     if: ${{ success() && (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/')) }}
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v5
       with:
         ref: ${{ github.head_ref }}   # checkout the triggered ref (branch or tag)
         fetch-depth: 0

.gitignore

@@ -33,3 +33,6 @@ package-lock.json
 
 # Agents
 .agents/
+
+# Claude Code
+.claude/

.specify/memory/constitution.md

@@ -28,7 +28,7 @@ All contributors MUST follow the project's Code of Conduct. Communication and co
 
 ### 2. Develop-in-Source & Reproducible Builds
 
-All development work MUST happen in the `source/` directory. Builds MUST be reproducible using the provided `build.ps1` workflow (examples: `./build.ps1 -ResolveDependency -Tasks noop -UsePSResourceGet` and `./build.ps1 -Tasks build`). The `output/` folder is the canonical build artifact location and MUST not be edited manually; any such edits will be overwritten by the build process.
+All development work MUST happen in the `src/` directory. Builds MUST be reproducible using the provided `build.ps1` workflow (examples: `./build.ps1 -ResolveDependency -Tasks noop -UsePSResourceGet` and `./build.ps1 -Tasks build`). The `output/` folder is the canonical build artifact location and MUST not be edited manually; any such edits will be overwritten by the build process.
 
 ### 3. Test-First Quality Gates
 
@@ -46,12 +46,12 @@ Dependencies MUST be declared and resolved using the build tools (the manifest's
 
 - The module supports PowerShell 5.1 and later as specified in the manifest; contributors MUST ensure compatibility with supported editions.
 - The module is currently published as Public PREVIEW; it MUST NOT be used in production environments without explicit risk acceptance.
-- Required modules listed in `source/FabricTools.psd1` (for example `Az.Accounts`, `MicrosoftPowerBIMgmt.Profile`, `Az.Resources`) MUST be respected; dependency resolution SHOULD use `PSResourceGet` or the included build helpers.
+- Required modules listed in `src/FabricTools.psd1` (for example `Az.Accounts`, `MicrosoftPowerBIMgmt.Profile`, `Az.Resources`) MUST be respected; dependency resolution SHOULD use `PSResourceGet` or the included build helpers.
 - All security disclosures and vulnerability reports MUST follow `SECURITY.md` and be handled confidentially.
 
 ## Development Workflow & Quality Gates
 
-- Develop in `source/` (not in `output/`). Use the Sampler structure described in the Wiki and run dependency resolution before development.
+- Develop in `src/` (not in `output/`). Use the Sampler structure described in the Wiki and run dependency resolution before development.
 - Dependency prep example commands (developer guidance):
 
 	- `./build.ps1 -ResolveDependency -Tasks noop -UsePSResourceGet` — resolve dependencies only.

.vscode/settings.json

@@ -20,7 +20,10 @@
         "*.ps1xml": "xml"
     },
     "cSpell.words": [
-        "Balabuch",
+        "Tiago", "Balabuch",
+        "Kamil", "Nowinski",
+        "Dont",
+        "Lakehouse", "lakehouses",
         "buildhelpers",
         "COMPANYNAME",
         "endregion",
@@ -33,7 +36,14 @@
         "PROJECTURI",
         "pscmdlet",
         "RELEASENOTES",
-        "steppable"
+        "steppable",
+        "Kusto",
+        "Eventstream", "Eventstreams",
+        "Eventhouse", "eventhouses",
+        "Queryset", "Querysets",
+        "Datamarts", "Datamart",
+        "Refreshables",
+        "ipynb"
     ],
     "[markdown]": {
         "files.trimTrailingWhitespace": false,

CHANGELOG.md

@@ -7,13 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Added `Get-FabricDataset` cmdlet to retrieve Power BI datasets from My Workspace or a specific workspace, with optional filtering by `DatasetId` or `DatasetName` (`WorkspaceId` parameter, alias `GroupId`)
+- Added `Get-FabricDatasetRefreshHistory` cmdlet to retrieve the refresh history of a Power BI dataset, with optional `WorkspaceId` (alias `GroupId`) and `Top` parameters
+- Added `Invoke-FabricDatasetRefresh` cmdlet (in `Dataset` folder) to trigger on-demand dataset refreshes, supporting both standard and enhanced refresh parameters (`Type`, `CommitMode`, `MaxParallelism`, `RetryCount`, `Timeout`, `EffectiveDate`, `ApplyRefreshPolicy`, `Objects`)
+- Updated unit tests for `Invoke-FabricDatasetRefresh` to cover the new parameter set, alias, ShouldProcess, body construction, and error handling
+
 ### Changed
 
 - Renamed `Add-FabricWorkspaceCapacityAssignment` to `Add-FabricWorkspaceCapacity` (issue #42)
 - Renamed `Remove-FabricWorkspaceCapacityAssignment` to `Remove-FabricWorkspaceCapacity` (issue #42)
+- Refactored `Invoke-FabricRestMethod` call in bunch of cmdlets to use hash splatting instead of backtick line continuation (issue #87)
+- Refactored cmdlets to use `HandleResponse = $true` on `Invoke-FabricRestMethod`, removing manual status-code switches, LRO polling, and pagination loops from each cmdlet
+- `Invoke-FabricRestMethod` handles response by default
 
 ### Fixed
 
+- `Connect-FabricAccount` now automatically re-authenticates when MFA or conditional access has expired, without requiring the `-Reset` switch
 - Made `ReportPathDefinition` parameter optional in `New-FabricReport` (issue #43)
 - Fixed PowerShell 5.1 compatibility by replacing ternary operators with if-else statements (issue #166)
 - Added PSFramework as a required module dependency to prevent "not recognized" errors on fresh environments (issue #167)
@@ -27,6 +36,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Removed `Invoke-FabricAPIRequest_duplicate` and `Invoke-FabricRestMethodExtended`
 - Removed all legacy FAB and PowerBI aliases from functions to clean up the module and remove references to old PowerBI-focused codebase (issue #47).
 - Removed `Register-FabricWorkspaceToCapacity` and `Unregister-FabricWorkspaceToCapacity`, as they are no longer needed (issue #42)
+- Removed abandoned `New-FabricNotebookNEW` file (incomplete/broken duplicate of `New-FabricNotebook`)
 
 ### Security
 
@@ -90,7 +100,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `Remove-FabricSQLDatabase` uses unified function to handle API results
 - Updated the `WorkspaceId`, `CapacitiesIds`,`CapacityId`,`CopyJobId`,`datamartId`,`DataPipelineId`,`DataWarehouseGUID`,`DomainId`,`EnvironmentId`,`EventhouseId`,`EventstreamId`,`ExternalDataShareId`,`ItemId`,`KQLDashboardId`,`KQLDatabaseId`,`KQLQuerysetId`,`LakehouseId`,`MirroredDatabaseId`,`MirroredWarehouseId`,`MLExperimentId`,`MLModelId`,`NotebookId`,`operationId`,`PaginatedReportId`,`ParentDomainId`,`parentEventhouseId`,`PrincipalId`,`ReflexId`,`ReportId`,`SemanticModelId`,`SparkCustomPoolId`,`SparkJobDefinitionId`,`SQLDatabaseId`,`SQLEndpointId`,`subscriptionID`,`UserId`,`WarehouseId`,`WorkspaceGUID`,`WorkspaceId`,`WorkspaceIds`, and `WorkspaceRoleAssignmentId` parameters to the datatype GUID [#125](https://github.com/dataplat/FabricTools/issues/125)
 - Internal function `Invoke-FabricRestMethod`: (#143)
-  - handles API response, no need to use `Test-FabricApiResponse` from parent public function 
+  - handles API response, no need to use `Test-FabricApiResponse` from parent public function
   - handles pagination automatically (when `-HandleResponse` is provided)
 - All Deployment Pipeline functions raise an error when an exception is caught. Used splatting for params.
 - Refactored SQL Database functions to use enhanced capability in `Invoke-FabricRestMethod`. Used splatting for params.
@@ -160,7 +170,7 @@ For a full list of changes and details, please see the commit history.
 - Removed unnecessary or duplicate functions (e.g., `Get-AllFabricDatasetRefreshes`, `Get-AllFabricCapacities`).
 - Removed obsolete scripts and commented-out configuration paths.
 - Removed `Invoke-FabricAPIRequest` and replaced it by `Invoke-FabricRestMethodExtended`
-- Removed `Confirm-FabricAuthToken` 
+- Removed `Confirm-FabricAuthToken`
 - Renamed `Test-TokenExpired` to `Confirm-TokenState` and extended it using `EnableTokenRefresh` Feature Flag
 - Removed `Set-FabricApiHeaders` and merged the entire logic to `Connect-FabricAccount`