Restructure implementations into per-library subfolders with shared multi-package infrastructure

Move each language's PCF library into a pcf/ subfolder so additional
libraries (e.g. PFS, built on PCF) can live alongside it, mirroring the
Rust reference layout.

- ts: add a private npm-workspaces root (single hoisted lockfile); run
  package scripts via -w @kduma-oss/pcf in CI/release.
- dotnet: add shared Directory.Build.props holding common metadata and the
  single lockstep <Version>, trimmed from Pcf.csproj.
- php: pcf/ is a self-contained Composer package; split workflow targets it.
- Update CI/release workflows (working dirs, path filters, artifact paths,
  version-bump targets) and READMEs; document the PFS->PCF dependency recipe
  in implementations/README.md.

Author: claude

.github/workflows/dotnet-ci.yml

@@ -4,17 +4,19 @@ on:
   push:
     branches: [master]
     paths:
-      - 'implementations/dotnet/**'
+      - 'implementations/dotnet/pcf/**'
+      - 'implementations/dotnet/Directory.Build.props'
       - '.github/workflows/dotnet-ci.yml'
   pull_request:
     branches: [master]
     paths:
-      - 'implementations/dotnet/**'
+      - 'implementations/dotnet/pcf/**'
+      - 'implementations/dotnet/Directory.Build.props'
       - '.github/workflows/dotnet-ci.yml'
 
 defaults:
   run:
-    working-directory: implementations/dotnet
+    working-directory: implementations/dotnet/pcf
 
 jobs:
   test:

.github/workflows/php-split.yml

@@ -4,7 +4,7 @@ on:
   push:
     branches: [master]
     paths:
-      - 'implementations/php/**'
+      - 'implementations/php/pcf/**'
       - '.github/workflows/php-split.yml'
   workflow_dispatch:
     inputs:
@@ -22,7 +22,7 @@ on:
 
 jobs:
   split:
-    name: split implementations/php → kduma-OSS-splits/PHP-PCF-lib
+    name: split implementations/php/pcf → kduma-OSS-splits/PHP-PCF-lib
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -78,7 +78,7 @@ jobs:
         env:
           PAT: x-access-token:${{ steps.app-token.outputs.token }}
         with:
-          package_directory: 'implementations/php'
+          package_directory: 'implementations/php/pcf'
           repository_organization: 'kduma-OSS-splits'
           repository_name: 'PHP-PCF-lib'
           branch: 'master'
@@ -92,7 +92,7 @@ jobs:
           PAT: x-access-token:${{ steps.app-token.outputs.token }}
         with:
           tag: ${{ steps.resolve-tag.outputs.tag }}
-          package_directory: 'implementations/php'
+          package_directory: 'implementations/php/pcf'
           repository_organization: 'kduma-OSS-splits'
           repository_name: 'PHP-PCF-lib'
           branch: 'master'

.github/workflows/php.yml

@@ -8,7 +8,7 @@ on:
 
 defaults:
   run:
-    working-directory: implementations/php
+    working-directory: implementations/php/pcf
 
 jobs:
   test:
@@ -66,4 +66,4 @@ jobs:
       - uses: actions/upload-artifact@v4
         with:
           name: pcf-testvector-php
-          path: implementations/php/pcf_testvector.bin
+          path: implementations/php/pcf/pcf_testvector.bin

.github/workflows/release-prepare.yml

@@ -82,16 +82,16 @@ jobs:
           sed -i 's|pcf = { path = "\.\./\.\./reference/PCF-v1.0", version = "[^"]*" }|pcf = { path = "../../reference/PCF-v1.0", version = "'"$NEW"'" }|' tools/pcf-debug/Cargo.toml
           sed -i 's|pcf = { path = "\.\./\.\./reference/PCF-v1.0", version = "[^"]*" }|pcf = { path = "../../reference/PCF-v1.0", version = "'"$NEW"'" }|' tools/pcf-compact/Cargo.toml
 
-      - name: Bump TypeScript package
+      - name: Bump TypeScript packages
         shell: bash
         working-directory: implementations/ts
-        run: npm version '${{ steps.version.outputs.version }}' --no-git-tag-version --allow-same-version
+        run: npm version '${{ steps.version.outputs.version }}' -ws --no-git-tag-version --allow-same-version
 
-      - name: Bump .NET Pcf.csproj
+      - name: Bump .NET Directory.Build.props
         shell: bash
         run: |
           NEW='${{ steps.version.outputs.version }}'
-          sed -i 's|<Version>[^<]*</Version>|<Version>'"$NEW"'</Version>|' implementations/dotnet/src/Pcf/Pcf.csproj
+          sed -i 's|<Version>[^<]*</Version>|<Version>'"$NEW"'</Version>|' implementations/dotnet/Directory.Build.props
 
       - name: Show diff
         run: git --no-pager diff --stat && git --no-pager diff

.github/workflows/release.yml

@@ -162,13 +162,13 @@ jobs:
       - name: Ensure npm >= 11.5.1 (trusted publishing support)
         run: npm install -g npm@latest
       - run: npm ci
-      - run: npm run build
+      - run: npm run build -w @kduma-oss/pcf
       - name: npm publish (OIDC trusted publishing, auto-provenance)
         run: |
           if [ "${{ needs.resolve.outputs.dry_run }}" = "true" ]; then
-            npm publish --access public --dry-run
+            npm publish -w @kduma-oss/pcf --access public --dry-run
           else
-            npm publish --access public
+            npm publish -w @kduma-oss/pcf --access public
           fi
 
   publish-nuget:
@@ -180,7 +180,7 @@ jobs:
       contents: read
     defaults:
       run:
-        working-directory: implementations/dotnet
+        working-directory: implementations/dotnet/pcf
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-dotnet@v4
@@ -212,7 +212,7 @@ jobs:
       - uses: actions/upload-artifact@v4
         with:
           name: nuget-package
-          path: implementations/dotnet/out/*.nupkg
+          path: implementations/dotnet/pcf/out/*.nupkg
 
   split-php:
     name: Split PHP to packagist source repo

.github/workflows/ts-ci.yml

@@ -22,7 +22,7 @@ jobs:
           cache: npm
           cache-dependency-path: implementations/ts/package-lock.json
       - run: npm ci
-      - run: npm run build
+      - run: npm run build -w @kduma-oss/pcf
 
   test:
     name: test (${{ matrix.os }})
@@ -39,7 +39,7 @@ jobs:
           cache: npm
           cache-dependency-path: implementations/ts/package-lock.json
       - run: npm ci
-      - run: npm test
+      - run: npm test -w @kduma-oss/pcf
 
   test-vector:
     name: regenerate spec test vector
@@ -53,15 +53,15 @@ jobs:
           cache-dependency-path: implementations/ts/package-lock.json
       - run: npm ci
       - name: Build and run the test-vector example
-        run: npm run gen-testvector -- pcf_testvector.bin
+        run: npm run gen-testvector -w @kduma-oss/pcf -- pcf_testvector.bin
       - name: Inspect generated test vector
         run: |
-          ls -l pcf_testvector.bin
-          test "$(wc -c < pcf_testvector.bin)" = "395"
+          ls -l pcf/pcf_testvector.bin
+          test "$(wc -c < pcf/pcf_testvector.bin)" = "395"
       - uses: actions/upload-artifact@v4
         with:
           name: pcf-testvector-ts
-          path: implementations/ts/pcf_testvector.bin
+          path: implementations/ts/pcf/pcf_testvector.bin
 
   coverage:
     name: code coverage
@@ -75,8 +75,8 @@ jobs:
           cache-dependency-path: implementations/ts/package-lock.json
       - run: npm ci
       - name: Generate coverage report (enforces >=95% line / 100% function)
-        run: npm run coverage
+        run: npm run coverage -w @kduma-oss/pcf
       - uses: actions/upload-artifact@v4
         with:
           name: coverage-lcov-ts
-          path: implementations/ts/coverage/lcov.info
+          path: implementations/ts/pcf/coverage/lcov.info

implementations/README.md

@@ -0,0 +1,17 @@
+<Project>
+
+  <!-- Shared metadata for every .NET library under implementations/dotnet/
+       (pcf/, and future libraries such as pfs/). Lockstep version lives here. -->
+  <PropertyGroup>
+    <Version>0.0.5</Version>
+    <Authors>Krystian Duma</Authors>
+    <Company>kduma-OSS</Company>
+    <Product>Partitioned Container Format</Product>
+    <Copyright>Copyright (c) Krystian Duma</Copyright>
+    <PackageLicenseExpression>MIT</PackageLicenseExpression>
+    <PackageProjectUrl>https://github.com/kduma-OSS/Partitioned-Container-Format</PackageProjectUrl>
+    <RepositoryUrl>https://github.com/kduma-OSS/Partitioned-Container-Format</RepositoryUrl>
+    <RepositoryType>git</RepositoryType>
+  </PropertyGroup>
+
+</Project>