From f1748727cec1e82e5c348de3e63dbd3fa18ef4fa Mon Sep 17 00:00:00 2001 From: magdev Date: Sun, 1 Feb 2026 15:52:40 +0100 Subject: [PATCH] docs: Update CLAUDE.md with v0.0.2 session learnings - Document composer path repository configuration with version aliases - Document Gitea CI/CD fix for handling re-releases - Add key learnings about submodule handling in CI environments Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 3e382e9..dc7857d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -280,6 +280,32 @@ add_action( 'wp_prometheus_collect_metrics', function( $collector ) { ## Session History +### 2026-02-01 - CI/CD Fixes (v0.0.2) + +- Fixed composer.json dependency configuration for CI compatibility +- **Key Learning**: Git submodules with path repositories need explicit version aliases for CI: + + ```json + "repositories": [ + { + "type": "path", + "url": "lib/wc-licensed-product-client", + "options": { + "symlink": false, + "versions": { + "magdev/wc-licensed-product-client": "0.2.2" + } + } + } + ] + ``` + +- Using `dev-main` constraints with `minimum-stability: dev` causes issues in CI +- Path repository with `symlink: false` and explicit `versions` mapping works reliably +- **Key Learning**: Gitea API returns "Release has no Tag" error when re-releasing existing tags +- Fixed release.yml to check for and delete existing releases before creating new ones +- Changed minimum-stability back to stable + ### 2026-02-01 - Initial Setup (v0.0.1) - Created initial plugin structure based on wp-fedistream blueprint