@wpmoo/odoo 0.8.36 → 0.8.38

package/README.md

@@ -266,6 +266,34 @@ tool-owned development guideline files.
 - Legacy `--org`, `--community-repo`, and `--pro-repo` flags are still accepted
   when no `--source-repo-url` flags are provided.
 
+## Release
+
+For local release checks from the repository root, run:
+
+```bash
+npm run release:check
+```
+
+The script checks whether the current package version already exists on npm. If
+it does, it runs a patch version bump without creating a git tag, then stops so
+you can commit and push `package.json` and `package-lock.json` before publishing.
+If the version is not published yet, it keeps the current version and runs
+`npm test -- test/package.test.ts` and `npm pack --dry-run`. Actual publishing
+is handled by the GitHub Actions workflow.
+
+For GitHub Actions publishing, configure npm Trusted Publishing for
+`wpmoo-org/wpmoo-odoo` with workflow filename `publish.yml`, then run the
+`Publish` workflow manually from GitHub Actions or push a matching release tag:
+
+```bash
+VERSION="$(node -p "require('./package.json').version")"
+git tag -a "v$VERSION" -m "Release v$VERSION"
+git push origin "v$VERSION"
+```
+
+The workflow uses OIDC instead of an npm token, verifies typecheck/tests/build,
+fails if a pushed tag does not match the package version, fails if the package
+version already exists on npm, runs `npm pack --dry-run`, and publishes to npm.
 
 ## Support
 

package/dist/doctor.js

@@ -19,6 +19,18 @@ async function exists(path) {
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
+function commandErrorText(error) {
+    const parts = [errorMessage(error)];
+    if (isRecord(error)) {
+        for (const key of ['stderr', 'stdout']) {
+            const value = error[key];
+            if (typeof value === 'string' && value.trim()) {
+                parts.push(value.trim());
+            }
+        }
+    }
+    return parts.join('\n');
+}
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -95,9 +107,39 @@ function validatePort(name, env, errors) {
 function renderFailure(errors) {
     return ['WPMoo doctor failed:', ...errors.map((error) => `- ${error}`)].join('\n');
 }
+function isNotGitCheckoutError(error) {
+    return commandErrorText(error).toLowerCase().includes('not a git repository');
+}
+function isSourceRepoSubmodule(path, sourceRepos) {
+    return sourceRepos.some((repo) => {
+        const sourcePath = `odoo/custom/src/private/${repo.path}`;
+        return path === sourcePath || path.startsWith(`${sourcePath}/`);
+    });
+}
+function sourceSubmoduleStatusErrors(output, sourceRepos) {
+    const errors = [];
+    for (const rawLine of output.split(/\r?\n/)) {
+        const line = rawLine.trimEnd();
+        if (!line)
+            continue;
+        const status = line[0];
+        const parts = line.slice(1).trim().split(/\s+/);
+        const path = parts[1];
+        if (!path || !isSourceRepoSubmodule(path, sourceRepos))
+            continue;
+        if (status === '-') {
+            errors.push(`Uninitialized Git submodule: ${path}`);
+        }
+        else if (status === 'U') {
+            errors.push(`Conflicted Git submodule: ${path}`);
+        }
+    }
+    return errors;
+}
 export async function runDoctor(target = process.cwd(), runner = realCommandRunner) {
     const lines = ['WPMoo doctor'];
     const errors = [];
+    const warnings = [];
     const metadata = await readMetadata(target);
     lines.push(`OK metadata ${markerPath}`);
     const engine = metadataString(metadata, 'engine') ?? 'compose';
@@ -160,9 +202,42 @@ export async function runDoctor(target = process.cwd(), runner = realCommandRunn
     catch (error) {
         errors.push(`Docker CLI check failed: ${errorMessage(error)}`);
     }
+    try {
+        await runner('docker', ['compose', 'version'], { cwd: target });
+        lines.push('OK docker compose');
+    }
+    catch (error) {
+        errors.push(`Docker Compose check failed: ${errorMessage(error)}`);
+    }
+    if (sourceRepos.length > 0) {
+        try {
+            const result = await runner('git', ['submodule', 'status', '--recursive'], { cwd: target });
+            const submoduleErrors = sourceSubmoduleStatusErrors(result.stdout, sourceRepos);
+            errors.push(...submoduleErrors);
+            if (submoduleErrors.length === 0) {
+                lines.push(`OK git submodules ${sourceRepos.length} checked`);
+            }
+        }
+        catch (error) {
+            if (isNotGitCheckoutError(error)) {
+                lines.push('OK git submodules skipped (not a git checkout)');
+            }
+            else {
+                errors.push(`Git submodule status check failed: ${errorMessage(error)}`);
+            }
+        }
+    }
+    try {
+        await runner('gh', ['auth', 'status'], { cwd: target });
+        lines.push('OK GitHub CLI auth');
+    }
+    catch (error) {
+        warnings.push(`WARN GitHub CLI auth: ${errorMessage(error)}`);
+    }
     if (errors.length > 0) {
         throw new Error(renderFailure(errors));
     }
+    lines.push(...warnings);
     lines.push('Doctor checks passed.');
     return lines.join('\n');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wpmoo/odoo",
-  "version": "0.8.36",
+  "version": "0.8.38",
   "description": "WPMoo Odoo lifecycle tooling for development, staging, and production workflows.",
   "type": "module",
   "repository": {
@@ -38,6 +38,7 @@
   "scripts": {
     "prebuild": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
     "build": "tsc -p tsconfig.build.json",
+    "release:check": "bash scripts/release-check.sh",
     "test": "vitest run",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },