Update splitting and release workflows

Author: palicko

.cursor/rules/release-workflow.mdc

@@ -25,15 +25,20 @@ Use these steps whenever a request involves releasing, versioning, publishing, o
    - `demo-bump.yml` runs after release success and calls `scripts/bump-demo.sh`.
    - This is currently a placeholder handoff for downstream integration.
 6. Mirror flow:
-   - Push a `v*` tag to trigger `split-webentor-setup.yml` and `split-webentor-starter.yml`.
+   - Push a namespaced tag to trigger the mirror workflow you intend:
+     - `core-v*` -> `split-webentor-core.yml`
+     - `setup-v*` -> `split-webentor-setup.yml`
+     - `starter-v*` -> `split-webentor-starter.yml`
    - Mirrors use `git subtree split` to publish package contents to standalone repos.
+   - Mirror scripts normalize namespaced tags to `vX.Y.Z` in target mirror repositories.
 7. Validation:
    - Verify published versions for `webentor-core` and `webentor-configs` on npm.
-   - Verify mirror repos received updates for `webentor-setup` and `webentor-starter`.
+   - Verify mirror repos received updates for `webentor-core`, `webentor-setup`, and `webentor-starter`.
+   - Update `docs/src/compatibility-matrix.md` with the tested-together release version set.
 
 ## Guardrails
 
 - Only `webentor-core` and `webentor-configs` are npm-published via Changesets.
-- `webentor-setup` and `webentor-starter` are delivered via split-mirror workflows.
+- `webentor-core`, `webentor-setup`, and `webentor-starter` are delivered via split-mirror workflows for standalone repositories.
 - Changesets baseline config is `.changeset/config.json` (`baseBranch: main`, `access: public`).
 - Required GitHub secrets for demo bump workflow: `WEBENTOR_DEMO_REPO`, `WEBENTOR_DEMO_TOKEN`.

.github/workflows/ci.yml

@@ -90,7 +90,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.2'
+          php-version: '8.3'
       - uses: actions/setup-node@v4
         with:
           node-version: '20'

.github/workflows/split-webentor-core.yml

@@ -0,0 +1,28 @@
+name: split-webentor-core
+
+on:
+  push:
+    tags:
+      - 'core-v*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Tag to mirror (defaults to current ref tag)'
+        required: false
+
+jobs:
+  split:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Split and mirror core package
+        env:
+          CORE_MIRROR_REPO: ${{ secrets.CORE_MIRROR_REPO }}
+          CORE_MIRROR_TOKEN: ${{ secrets.CORE_MIRROR_TOKEN }}
+          INPUT_TAG: ${{ github.event.inputs.tag }}
+          GITHUB_REF_NAME: ${{ github.ref_name }}
+        run: bash scripts/split-webentor-core.sh

.github/workflows/split-webentor-setup.yml

@@ -3,7 +3,7 @@ name: split-webentor-setup
 on:
   push:
     tags:
-      - 'v*'
+      - 'setup-v*'
   workflow_dispatch:
     inputs:
       tag:

.github/workflows/split-webentor-starter.yml

@@ -3,7 +3,7 @@ name: split-webentor-starter
 on:
   push:
     tags:
-      - 'v*'
+      - 'starter-v*'
   workflow_dispatch:
     inputs:
       tag:

docs/src/compatibility-matrix.md

@@ -43,3 +43,5 @@ IE11 is not supported.
 - PHP 8.2 may work in some configurations but is no longer the tested minimum.
 - The compatibility matrix is updated with each release. Consult the
   `CHANGELOG.md` in each package for version-specific changes.
+- Monorepo mirror triggers use namespaced tags (`core-v*`, `setup-v*`, `starter-v*`),
+  while mirror repositories receive normalized `vX.Y.Z` tags.

docs/src/contributing/developer-playbook.md

@@ -63,18 +63,20 @@ Repository automation is split by trigger type so CI stays fast and release step
 - `.github/workflows/demo-bump.yml`:
   - Runs after `release.yml` completes successfully.
   - Invokes `scripts/bump-demo.sh` to trigger downstream demo integration bump flow (placeholder implementation).
-- `.github/workflows/split-webentor-setup.yml` and `.github/workflows/split-webentor-starter.yml`:
-  - Run on `v*` tags (or manual dispatch).
+- `.github/workflows/split-webentor-core.yml`, `.github/workflows/split-webentor-setup.yml`, and `.github/workflows/split-webentor-starter.yml`:
+  - Run on namespaced monorepo tags (`core-v*`, `setup-v*`, `starter-v*`) or manual dispatch.
   - Use subtree split scripts to mirror package contents to standalone repositories.
+  - Mirror repositories receive normalized semver tags (`vX.Y.Z`) for downstream package tooling compatibility.
 
 ```mermaid
 flowchart LR
   pushOrPr["Push_or_PR"] --> ci["ci.yml"]
   pushMain["Push_main"] --> release["release.yml"]
   release --> demoBump["demo-bump.yml"]
   pushMainDocs["Push_main_with_docs_changes"] --> docsDeploy["docs-deploy.yml"]
-  pushTag["Push_tag_v*"] --> splitSetup["split-webentor-setup.yml"]
-  pushTag --> splitStarter["split-webentor-starter.yml"]
+  pushCoreTag["Push_tag_core-v*"] --> splitCore["split-webentor-core.yml"]
+  pushSetupTag["Push_tag_setup-v*"] --> splitSetup["split-webentor-setup.yml"]
+  pushStarterTag["Push_tag_starter-v*"] --> splitStarter["split-webentor-starter.yml"]
 ```
 
 ## How to change and release a package
@@ -91,7 +93,11 @@ Use this sequence for package changes so CI, releases, and downstream integratio
 4. Merge the PR into `main`; `release.yml` then opens/updates the "Version Packages" PR.
 5. Merge the version PR; Changesets bumps versions/changelogs and publishes npm packages.
 6. Confirm `demo-bump.yml` ran successfully after release.
-7. Push a `v*` tag when you want to trigger split mirrors for setup/starter repositories.
+7. Push a namespaced tag when you want to trigger a specific split mirror:
+   1. `core-v*` -> `split-webentor-core.yml`
+   2. `setup-v*` -> `split-webentor-setup.yml`
+   3. `starter-v*` -> `split-webentor-starter.yml`
+   4. Mirror scripts normalize these to `vX.Y.Z` tags in target repositories.
 
 ## Release and rollout order
 
@@ -102,11 +108,14 @@ When changes span multiple packages, keep this order and map each stage to autom
    - `release.yml` + Changesets handles version PR and npm publish after merge.
 2. `webentor-setup` (include upgrade recipe when behavior changes)
    - Validate runtime/CLI contract updates.
-   - Trigger split mirror via `v*` tag when ready.
+   - Trigger split mirror via `setup-v*` tag when ready.
 3. `webentor-starter`
    - Validate integrated behavior against updated package outputs.
-   - Trigger split mirror via `v*` tag when ready.
-4. `webentor-demo` integration validation and bump
+   - Trigger split mirror via `starter-v*` tag when ready.
+4. `webentor-core` mirror (for standalone Composer delivery)
+   - Trigger split mirror via `core-v*` tag when ready.
+   - Confirm target mirror tag is normalized to `vX.Y.Z`.
+5. `webentor-demo` integration validation and bump
    - Validate downstream compatibility after release.
    - `demo-bump.yml` is the automation hook for this handoff.
 

docs/src/onboarding/setup-init.md

@@ -14,9 +14,8 @@ You have nothing locally and want a runnable Webentor project. Start here.
 ## 2. Clone starter project
 
 ```bash
-# TODO: replace <starter-repo-url> with your internal starter/reference URL
-git clone <starter-repo-url> <project-dir>
-cd <project-dir>
+git clone https://github.com/Webikon/webentor-starter webentor-starter
+cd webentor-starter
 ```
 
 ## 3. Initialize project metadata and setup contract

packages/webentor-core/.npmrc

@@ -69,6 +69,7 @@
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-react": "^7.37.5",
+    "glob": "^13.0.6",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
     "patch-package": "^8.0.1",