docs: fix stale references across all documentation

- ARCHITECTURE.md: fix WinRM subnet (192.168.1179), VM box shows VS 2026/Python 3.13/unzip+python build instead of .NET SDK 8/git clone/dotnet build
- BEST-PRACTICES.md: fix VMnet11/192.168.11  VMnet8 NAT/192.168.79
- CI-FLOW.md: Step 3 workflow YAML updated to actual Invoke-CIJob.ps1 params (Submodules, BuildCommand, GuestArtifactSource); note that -VMIPAddress is auto-detected
- OPTIMIZATION.md: BaseClean tier updated to VS BuildTools 2026, .NET SDK 10.0.203, Python 3.13.3
- gitea/workflow-example.yml: remove BUILD_VM_IP (auto-detected), replace -VMIPAddress/-Configuration with -Submodules/-BuildCommand/-GuestArtifactSource

docs/ARCHITECTURE.md

@@ -53,7 +53,7 @@ The runner host **never executes build tools directly**. Its only role is orches
 │  │                                      ├── Clone_Job_002.vmx        │  │
 │  │                                      └── Clone_Job_003.vmx        │  │
 │  └───────────────────────────────────────────────────────────────────┘  │
-│                                  │  WinRM :5985 (192.168.11.0/24)       │
+│                                  │  WinRM :5985 (192.168.79.0/24 NAT)   │
 └──────────────────────────────────┼──────────────────────────────────────┘
                                    │
           ┌────────────────────────┼──────────────────────────┐
@@ -64,13 +64,14 @@ The runner host **never executes build tools directly**. Its only role is orches
 │  (ephemeral)     │    │  (ephemeral)     │    │  (ephemeral)     │
 │                  │    │                  │    │                  │
 │  VS Build Tools  │    │  VS Build Tools  │    │  VS Build Tools  │
-│  .NET SDK 8      │    │  .NET SDK 8      │    │  .NET SDK 8      │
+│  2026 (v145)     │    │  2026 (v145)     │    │  2026 (v145)     │
-│  Git             │    │  Git             │    │  Git             │
+│  .NET SDK 10     │    │  .NET SDK 10     │    │  .NET SDK 10     │
+│  Python 3.13.3   │    │  Python 3.13.3   │    │  Python 3.13.3   │
 │  WinRM enabled   │    │  WinRM enabled   │    │  WinRM enabled   │
 │                  │    │                  │    │                  │
-│  > git clone     │    │  > git clone     │    │  > git clone     │
+│  > unzip src     │    │  > unzip src     │    │  > unzip src     │
-│  > dotnet build  │    │  > dotnet build  │    │  > dotnet build  │
+│  > python build  │    │  > python build  │    │  > python build  │
-│  > artifacts     │    │  > artifacts     │    │  > artifacts     │
+│  > dist/         │    │  > dist/         │    │  > dist/         │
 │                  │    │                  │    │                  │
 │  [DESTROYED]     │    │  [DESTROYED]     │    │  [DESTROYED]     │
 └──────────────────┘    └──────────────────┘    └──────────────────┘

docs/BEST-PRACTICES.md

@@ -35,7 +35,7 @@ $cred = Get-StoredCredential -Target 'BuildVMGuest'
 ### Current setup (HTTP / port 5985)
 
 Acceptable for an **isolated lab network** where:
-- Build VMs are on a dedicated host-only VMware network (192.168.11.0/24 — VMnet11 dedicated CI)
+- Build VMs sono su VMnet8 NAT (192.168.79.0/24) — raggiungibili dall'host, internet via NAT
 - No external traffic reaches port 5985
 - Credentials are managed via Windows Credential Manager
 

docs/CI-FLOW.md

@@ -54,16 +54,24 @@ The workflow YAML defines steps that run as PowerShell commands **on the host**.
 The first substantive step calls `Invoke-CIJob.ps1`:
 
 ```yaml
-- name: Build in ephemeral VM
+- name: Run CI Job
   shell: pwsh
   run: |
-    .\scripts\Invoke-CIJob.ps1 `
+    & 'N:\Code\Workspace\Local-CI-CD-System\scripts\Invoke-CIJob.ps1' `
-      -JobId    "${{ github.run_id }}" `
+      -JobId               '${{ github.run_id }}' `
-      -RepoUrl  "${{ env.GITEA_REPO_URL }}" `
+      -RepoUrl             'ssh://gitea-ci/Simone/<repo>.git' `
-      -Branch   "${{ github.ref_name }}" `
+      -Branch              '${{ github.ref_name }}' `
-      -Commit   "${{ github.sha }}"
+      -Commit              '${{ github.sha }}' `
+      -TemplatePath        $env:GITEA_CI_TEMPLATE_PATH `
+      -Submodules `
+      -BuildCommand        'python build_plugin.py --final --dist-dir dist' `
+      -GuestArtifactSource 'dist'
+    if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
 ```
 
+> Il parametro `-VMIPAddress` **non è più necessario** — l'IP viene rilevato automaticamente
+> tramite `vmrun getGuestIPAddress` dopo l'avvio della VM.
+
 ---
 
 ### Step 4 — Invoke-CIJob.ps1: Clone VM

docs/OPTIMIZATION.md

@@ -35,14 +35,14 @@ Tier 0: Base OS Install (Windows only, no tools)
 
 Tier 1: Build Toolchain
   └── Snapshot: "BaseClean" ← CLONE SOURCE (weekly refresh)
-       Includes: VS Build Tools 2022, .NET SDK, Git, WinRM config
+       Includes: VS Build Tools 2026, .NET SDK 10.0.203, Python 3.13.3, Git, WinRM config
        Requirement: ALL linked clones must reference this exact snapshot
 ```
 
 ### Refresh Schedule
 
 | Snapshot    | Refresh Frequency | Trigger                                    |
-|----------|------------------|-------|
+| ----------- | ----------------- | ------------------------------------------ |
 | `OSBase`    | Quarterly         | Windows cumulative update                  |
 | `BaseClean` | Weekly/Monthly    | .NET SDK patch, security update, VS update |
 
@@ -56,7 +56,7 @@ Tier 1: Build Toolchain
 ### RAM Budget (i9-10900X · 64 GB)
 
 | Component                             | RAM Usage |
-|-----------|----------|
+| ------------------------------------- | --------- |
 | Windows host OS                       | ~4 GB     |
 | VMware Workstation                    | ~0.5 GB   |
 | Gitea server                          | ~0.5–1 GB |

gitea/workflow-example.yml

@@ -31,14 +31,8 @@ jobs:
       # GITEA_CI_TEMPLATE_PATH is injected by runner/config.yaml global envs
       # GITEA_CI_CLONE_BASE_DIR is injected by runner/config.yaml global envs
 
-      # IP address for this build VM.
-      # For parallel builds, each concurrent job needs a unique IP.
-      # Assign via Gitea matrix or a simple offset scheme.
-      # Example: use a fixed IP per runner slot, mapped by capacity index.
-      # For single concurrent builds: use one fixed IP.
-      BUILD_VM_IP: "192.168.11.101"
-
       # Gitea Credential Manager target (set in runner/config.yaml)
+      # The VM IP is auto-detected via vmrun getGuestIPAddress — no BUILD_VM_IP needed.
       GUEST_CRED_TARGET: "BuildVMGuest"
 
     steps:
@@ -66,8 +60,9 @@ jobs:
             -RepoUrl               "${{ github.server_url }}/${{ github.repository }}.git" `
             -Branch                "${{ github.ref_name }}" `
             -Commit                "${{ github.sha }}" `
-            -Configuration         "Release" `
+            -Submodules `
-            -VMIPAddress           "$env:BUILD_VM_IP" `
+            -BuildCommand          'python build_plugin.py --final --dist-dir dist' `
+            -GuestArtifactSource   'dist' `
             -GuestCredentialTarget "$env:GUEST_CRED_TARGET"
 
           if ($LASTEXITCODE -ne 0) {