merging master into experiimental

.claude/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.0.1",
+  "configurations": [
+    {
+      "name": "Web6Site",
+      "runtimeExecutable": "npx",
+      "runtimeArgs": ["serve", "-p", "5173", "C:\\Source\\Web6Site"],
+      "port": 5173
+    }
+  ]
+}

.devin/wiki.json

@@ -0,0 +1,9 @@
+{
+  "repo_notes": [
+    {
+      "content": "Use api.oasisweb4.one (not .com) as the canonical base URL for the hosted OASIS API in all examples, code snippets, and documentation. Base URL: https://api.oasisweb4.one, API prefix: https://api.oasisweb4.one/api, Swagger: https://api.oasisweb4.one/swagger/index.html.\n\nIn the Getting Started / Developer Guides section, document both paths clearly:\n1. Using the remote API: Users can call the hosted API at https://api.oasisweb4.one without cloning or running the repo. Include: register (POST /api/avatar/register), verify-email, authenticate (POST /api/avatar/authenticate), then use the JWT in Authorization header for other endpoints. No .NET SDK or local setup required.\n2. Running locally: Clone, restore, build, and run the WebAPI project for local development.",
+      "author": "OASIS docs"
+    }
+  ],
+  "pages": []
+}

.github/workflows/ci-cd.yml

@@ -7,7 +7,7 @@ on:
     branches: [ main, master, develop ]
 
 env:
-  DOTNET_VERSION: '9.0.x'
+  DOTNET_VERSION: '10.0.x'
   NODE_VERSION: '18.x'
 
 jobs:
@@ -25,21 +25,36 @@ jobs:
         ]
 
     steps:
-    - uses: actions/checkout@v4
-
+    - name: Checkout OASIS
+      uses: actions/checkout@v4
+      with:
+        path: OASIS
+
+    - name: Checkout NextGenSoftware-Libraries
+      uses: actions/checkout@v4
+      with:
+        repository: NextGenSoftwareUK/NextGenSoftware-Libraries
+        path: NextGenSoftware-Libraries
+
+    - name: Checkout holochain-client-csharp
+      uses: actions/checkout@v4
+      with:
+        repository: holochain-open-dev/holochain-client-csharp
+        path: holochain-client-csharp
+
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
         dotnet-version: ${{ env.DOTNET_VERSION }}
 
     - name: Restore dependencies
-      run: dotnet restore "OASIS Architecture/${{ matrix.project }}/${{ matrix.project }}.csproj"
+      run: dotnet restore "OASIS/OASIS Architecture/${{ matrix.project }}/${{ matrix.project }}.csproj"
 
     - name: Build
-      run: dotnet build "OASIS Architecture/${{ matrix.project }}/${{ matrix.project }}.csproj" --no-restore
+      run: dotnet build "OASIS/OASIS Architecture/${{ matrix.project }}/${{ matrix.project }}.csproj" --no-restore
 
     - name: Test
-      run: dotnet test "OASIS Architecture/${{ matrix.project }}.UnitTests/${{ matrix.project }}.UnitTests.csproj" --no-build --verbosity normal
+      run: dotnet test "OASIS/OASIS Architecture/${{ matrix.project }}.UnitTests/${{ matrix.project }}.UnitTests.csproj" --no-build --verbosity normal
 
   # Build and Test ONODE Projects
   test-onode:
@@ -54,21 +69,36 @@ jobs:
         ]
 
     steps:
-    - uses: actions/checkout@v4
-
+    - name: Checkout OASIS
+      uses: actions/checkout@v4
+      with:
+        path: OASIS
+
+    - name: Checkout NextGenSoftware-Libraries
+      uses: actions/checkout@v4
+      with:
+        repository: NextGenSoftwareUK/NextGenSoftware-Libraries
+        path: NextGenSoftware-Libraries
+
+    - name: Checkout holochain-client-csharp
+      uses: actions/checkout@v4
+      with:
+        repository: holochain-open-dev/holochain-client-csharp
+        path: holochain-client-csharp
+
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
         dotnet-version: ${{ env.DOTNET_VERSION }}
 
     - name: Restore dependencies
-      run: dotnet restore "ONODE/${{ matrix.project }}/${{ matrix.project }}.csproj"
+      run: dotnet restore "OASIS/ONODE/${{ matrix.project }}/${{ matrix.project }}.csproj"
 
     - name: Build
-      run: dotnet build "ONODE/${{ matrix.project }}/${{ matrix.project }}.csproj" --no-restore
+      run: dotnet build "OASIS/ONODE/${{ matrix.project }}/${{ matrix.project }}.csproj" --no-restore
 
     - name: Test
-      run: dotnet test "ONODE/${{ matrix.project }}.UnitTests/${{ matrix.project }}.UnitTests.csproj" --no-build --verbosity normal
+      run: dotnet test "OASIS/ONODE/${{ matrix.project }}.UnitTests/${{ matrix.project }}.UnitTests.csproj" --no-build --verbosity normal
 
   # Build and Test STAR ODK Projects
   test-star-odk:
@@ -86,21 +116,36 @@ jobs:
         ]
 
     steps:
-    - uses: actions/checkout@v4
-
+    - name: Checkout OASIS
+      uses: actions/checkout@v4
+      with:
+        path: OASIS
+
+    - name: Checkout NextGenSoftware-Libraries
+      uses: actions/checkout@v4
+      with:
+        repository: NextGenSoftwareUK/NextGenSoftware-Libraries
+        path: NextGenSoftware-Libraries
+
+    - name: Checkout holochain-client-csharp
+      uses: actions/checkout@v4
+      with:
+        repository: holochain-open-dev/holochain-client-csharp
+        path: holochain-client-csharp
+
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
         dotnet-version: ${{ env.DOTNET_VERSION }}
 
     - name: Restore dependencies
-      run: dotnet restore "STAR ODK/${{ matrix.project }}/${{ matrix.project }}.csproj"
+      run: dotnet restore "OASIS/STAR ODK/${{ matrix.project }}/${{ matrix.project }}.csproj"
 
     - name: Build
-      run: dotnet build "STAR ODK/${{ matrix.project }}/${{ matrix.project }}.csproj" --no-restore
+      run: dotnet build "OASIS/STAR ODK/${{ matrix.project }}/${{ matrix.project }}.csproj" --no-restore
 
     - name: Test
-      run: dotnet test "STAR ODK/${{ matrix.project }}.UnitTests/${{ matrix.project }}.UnitTests.csproj" --no-build --verbosity normal
+      run: dotnet test "OASIS/STAR ODK/${{ matrix.project }}.UnitTests/${{ matrix.project }}.UnitTests.csproj" --no-build --verbosity normal
 
   # Integration Tests
   integration-tests:
@@ -109,8 +154,23 @@ jobs:
     needs: [test-oasis-architecture, test-onode, test-star-odk]
 
     steps:
-    - uses: actions/checkout@v4
-
+    - name: Checkout OASIS
+      uses: actions/checkout@v4
+      with:
+        path: OASIS
+
+    - name: Checkout NextGenSoftware-Libraries
+      uses: actions/checkout@v4
+      with:
+        repository: NextGenSoftwareUK/NextGenSoftware-Libraries
+        path: NextGenSoftware-Libraries
+
+    - name: Checkout holochain-client-csharp
+      uses: actions/checkout@v4
+      with:
+        repository: holochain-open-dev/holochain-client-csharp
+        path: holochain-client-csharp
+
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
@@ -137,15 +197,55 @@ jobs:
         dotnet test "STAR ODK/NextGenSoftware.OASIS.STAR.WebAPI.IntegrationTests/NextGenSoftware.OASIS.STAR.WebAPI.IntegrationTests.csproj" --no-build --verbosity normal
         dotnet test "STAR ODK/NextGenSoftware.OASIS.STAR.WebUI.IntegrationTests/NextGenSoftware.OASIS.STAR.WebUI.IntegrationTests.csproj" --no-build --verbosity normal
 
+  # STARAPIClient Unit + Integration + Harness
+  test-starapi-client:
+    name: Test STARAPIClient
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup .NET
+      uses: actions/setup-dotnet@v4
+      with:
+        dotnet-version: ${{ env.DOTNET_VERSION }}
+
+    - name: Run STARAPIClient test suite
+      shell: pwsh
+      run: |
+        & "OASIS/OASIS Omniverse/STARAPIClient/run_star_api_test_suite.ps1" -Configuration Release -KillStaleTestHosts $true
+
+    - name: Upload STARAPIClient test artifacts
+      uses: actions/upload-artifact@v4
+      if: always()
+      with:
+        name: starapiclient-test-results
+        path: OASIS/OASIS Omniverse/STARAPIClient/TestResults/
+        retention-days: 30
+
   # Unity Tests (if Unity is available)
   unity-tests:
     name: Unity Tests
     runs-on: ubuntu-latest
     if: false  # Disabled for now as Unity requires special setup
 
     steps:
-    - uses: actions/checkout@v4
-
+    - name: Checkout OASIS
+      uses: actions/checkout@v4
+      with:
+        path: OASIS
+
+    - name: Checkout NextGenSoftware-Libraries
+      uses: actions/checkout@v4
+      with:
+        repository: NextGenSoftwareUK/NextGenSoftware-Libraries
+        path: NextGenSoftware-Libraries
+
+    - name: Checkout holochain-client-csharp
+      uses: actions/checkout@v4
+      with:
+        repository: holochain-open-dev/holochain-client-csharp
+        path: holochain-client-csharp
+
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
@@ -160,12 +260,27 @@ jobs:
   build-and-package:
     name: Build and Package
     runs-on: ubuntu-latest
-    needs: [test-oasis-architecture, test-onode, test-star-odk, integration-tests]
+    needs: [test-oasis-architecture, test-onode, test-star-odk, integration-tests, test-starapi-client]
     if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master'
 
     steps:
-    - uses: actions/checkout@v4
-
+    - name: Checkout OASIS
+      uses: actions/checkout@v4
+      with:
+        path: OASIS
+
+    - name: Checkout NextGenSoftware-Libraries
+      uses: actions/checkout@v4
+      with:
+        repository: NextGenSoftwareUK/NextGenSoftware-Libraries
+        path: NextGenSoftware-Libraries
+
+    - name: Checkout holochain-client-csharp
+      uses: actions/checkout@v4
+      with:
+        repository: holochain-open-dev/holochain-client-csharp
+        path: holochain-client-csharp
+
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
@@ -179,10 +294,10 @@ jobs:
 
     - name: Pack NuGet packages
       run: |
-        dotnet pack "OASIS Architecture/NextGenSoftware.OASIS.API.Core/NextGenSoftware.OASIS.API.Core.csproj" --configuration Release --no-build --output ./packages
-        dotnet pack "OASIS Architecture/NextGenSoftware.OASIS.Common/NextGenSoftware.OASIS.Common.csproj" --configuration Release --no-build --output ./packages
-        dotnet pack "OASIS Architecture/NextGenSoftware.OASIS.API.DNA/NextGenSoftware.OASIS.API.DNA.csproj" --configuration Release --no-build --output ./packages
-        dotnet pack "OASIS Architecture/NextGenSoftware.OASIS.OASISBootLoader/NextGenSoftware.OASIS.OASISBootLoader.csproj" --configuration Release --no-build --output ./packages
+        dotnet pack "OASIS/OASIS Architecture/NextGenSoftware.OASIS.API.Core/NextGenSoftware.OASIS.API.Core.csproj" --configuration Release --no-build --output ./packages
+        dotnet pack "OASIS/OASIS Architecture/NextGenSoftware.OASIS.Common/NextGenSoftware.OASIS.Common.csproj" --configuration Release --no-build --output ./packages
+        dotnet pack "OASIS/OASIS Architecture/NextGenSoftware.OASIS.API.DNA/NextGenSoftware.OASIS.API.DNA.csproj" --configuration Release --no-build --output ./packages
+        dotnet pack "OASIS/OASIS Architecture/NextGenSoftware.OASIS.OASISBootLoader/NextGenSoftware.OASIS.OASISBootLoader.csproj" --configuration Release --no-build --output ./packages
 
     - name: Upload build artifacts
       uses: actions/upload-artifact@v4
@@ -197,8 +312,23 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
-
+    - name: Checkout OASIS
+      uses: actions/checkout@v4
+      with:
+        path: OASIS
+
+    - name: Checkout NextGenSoftware-Libraries
+      uses: actions/checkout@v4
+      with:
+        repository: NextGenSoftwareUK/NextGenSoftware-Libraries
+        path: NextGenSoftware-Libraries
+
+    - name: Checkout holochain-client-csharp
+      uses: actions/checkout@v4
+      with:
+        repository: holochain-open-dev/holochain-client-csharp
+        path: holochain-client-csharp
+
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
@@ -218,8 +348,23 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
-
+    - name: Checkout OASIS
+      uses: actions/checkout@v4
+      with:
+        path: OASIS
+
+    - name: Checkout NextGenSoftware-Libraries
+      uses: actions/checkout@v4
+      with:
+        repository: NextGenSoftwareUK/NextGenSoftware-Libraries
+        path: NextGenSoftware-Libraries
+
+    - name: Checkout holochain-client-csharp
+      uses: actions/checkout@v4
+      with:
+        repository: holochain-open-dev/holochain-client-csharp
+        path: holochain-client-csharp
+
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
@@ -240,8 +385,23 @@ jobs:
     needs: [test-oasis-architecture, test-onode, test-star-odk]
 
     steps:
-    - uses: actions/checkout@v4
-
+    - name: Checkout OASIS
+      uses: actions/checkout@v4
+      with:
+        path: OASIS
+
+    - name: Checkout NextGenSoftware-Libraries
+      uses: actions/checkout@v4
+      with:
+        repository: NextGenSoftwareUK/NextGenSoftware-Libraries
+        path: NextGenSoftware-Libraries
+
+    - name: Checkout holochain-client-csharp
+      uses: actions/checkout@v4
+      with:
+        repository: holochain-open-dev/holochain-client-csharp
+        path: holochain-client-csharp
+
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with: