@wpmoo/odoo 0.8.30

package/dist/templates.js

@@ -0,0 +1,414 @@
+export function defaultCommunityAddons(product) {
+    return [product];
+}
+export function defaultProAddons(product) {
+    return [`${product}_pro`];
+}
+function titleizeProduct(product) {
+    return product
+        .split(/[_-]+/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(' ');
+}
+function yamlList(items) {
+    return items.map((item) => `  - ${item}`).join('\n');
+}
+function allAddons(options) {
+    return options.sourceRepos.flatMap((repo) => repo.addons);
+}
+function repositoryLayout(options) {
+    return `${options.devRepo}/
+├── docker-compose_17.0.yml
+├── docker-compose_18.0.yml
+├── docker-compose_19.0.yml
+├── scripts/
+├── etc/
+├── odoo/
+│   └── custom/
+│       └── src/
+│           └── private/
+${options.sourceRepos.map((repo) => `│               ├── ${repo.path}/`).join('\n')}
+├── docs/
+├── README.md
+└── AGENTS.md`;
+}
+function sourceRepoDocs(options) {
+    return options.sourceRepos
+        .map((repo) => `### ${repo.path}
+
+URL:
+
+\`\`\`text
+${repo.url}
+\`\`\`
+
+Submodule path:
+
+\`\`\`text
+odoo/custom/src/private/${repo.path}
+\`\`\`
+
+Expected addon layout:
+
+\`\`\`text
+${repo.path}/
+${repo.addons.map((addon) => `├── ${addon}/`).join('\n')}
+\`\`\``)
+        .join('\n\n');
+}
+function optionalAgentSkillsReadme(options) {
+    if (!options.agentSkillsTemplateUrl)
+        return '';
+    return `
+## Agent Skills
+
+This environment is configured to install project-local Agent Skills from:
+
+\`\`\`text
+${options.agentSkillsTemplateUrl}${options.agentSkillsTemplateRef ? `#${options.agentSkillsTemplateRef}` : ''}
+\`\`\`
+
+After external resource installation, skills normally live under:
+
+\`\`\`text
+.agents/skills/
+\`\`\`
+
+Agents that support the Agent Skills standard can load them on demand.
+`;
+}
+function optionalAgentSkillsAgentsSection(options) {
+    if (!options.agentSkillsTemplateUrl)
+        return '';
+    return `
+## Active Agent Skills
+
+When using an agent that supports Agent Skills, prefer the project-local skills
+installed under \`.agents/skills/\`. They are sourced from:
+
+\`\`\`text
+${options.agentSkillsTemplateUrl}${options.agentSkillsTemplateRef ? `#${options.agentSkillsTemplateRef}` : ''}
+\`\`\`
+`;
+}
+function environmentKind() {
+    return 'Docker Compose';
+}
+function repoDuplicationNote() {
+    return 'Keep these repositories under `odoo/custom/src/private`; the Compose entrypoint exposes discovered addons through `/mnt/wpmoo-addons`.';
+}
+function verificationCommand(options) {
+    const firstAddon = allAddons(options)[0] ?? options.product;
+    return `./scripts/test.sh ${firstAddon}`;
+}
+function environmentUsageDocs(options) {
+    return `## Docker Compose Notes
+
+This environment uses the standalone WPMoo Odoo Compose resource. Compose files
+are version-specific and static:
+
+\`\`\`text
+docker-compose_17.0.yml
+docker-compose_18.0.yml
+docker-compose_19.0.yml
+\`\`\`
+
+If copied from the standalone resource, additional compose documentation is kept
+in \`docs/compose.md\`.
+
+Source repositories stay under \`odoo/custom/src/private\`. At container startup,
+\`entrypoint.sh\` scans those repositories for addons and exposes them through
+\`/mnt/wpmoo-addons\`.
+
+## Common Commands
+
+\`\`\`bash
+cp .env.example .env
+./scripts/up.sh
+./scripts/logs.sh
+./scripts/shell.sh
+./scripts/down.sh
+\`\`\`
+
+Run tests for one planned product addon:
+
+\`\`\`bash
+./scripts/test.sh ${allAddons(options)[0] ?? options.product}
+\`\`\`
+`;
+}
+const BANNER_GRADIENT_START = [31, 151, 231];
+const BANNER_GRADIENT_END = [209, 95, 127];
+const ANSI_BOLD = '\u001B[1m';
+const ANSI_RESET = '\u001B[0m';
+function gradientColor(column, width) {
+    const ratio = width <= 1 ? 0 : column / (width - 1);
+    const [startR, startG, startB] = BANNER_GRADIENT_START;
+    const [endR, endG, endB] = BANNER_GRADIENT_END;
+    const r = Math.round(startR + (endR - startR) * ratio);
+    const g = Math.round(startG + (endG - startG) * ratio);
+    const b = Math.round(startB + (endB - startB) * ratio);
+    return `\u001B[38;2;${r};${g};${b}m`;
+}
+function applyBannerGradient(banner) {
+    const lines = banner.split('\n');
+    const width = Math.max(...lines.map((line) => line.length));
+    return lines
+        .map((line) => Array.from(line)
+        .map((character, column) => `${gradientColor(column, width)}${character}`)
+        .join(''))
+        .join('\n');
+}
+export function renderBanner() {
+    const banner = String.raw `
+
+░██       ░██ ░█████████  ░███     ░███
+░██       ░██ ░██     ░██ ░████   ░████
+░██  ░██  ░██ ░██     ░██ ░██░██ ░██░██  ░███████   ░███████
+░██ ░████ ░██ ░█████████  ░██ ░████ ░██ ░██    ░██ ░██    ░██
+░██░██ ░██░██ ░██         ░██  ░██  ░██ ░██    ░██ ░██    ░██
+░████   ░████ ░██         ░██       ░██ ░██    ░██ ░██    ░██
+░███     ░███ ░██         ░██       ░██  ░███████   ░███████
+
+░░░░░░░░░ Workflow Platform - Micro Object Oriented ░░░░░░░░░
+`;
+    return `${ANSI_BOLD}${applyBannerGradient(banner)}${ANSI_RESET}`;
+}
+export function renderGitignore() {
+    return `# macOS/editor noise
+.DS_Store
+.idea/
+.vscode/*.log
+
+# Node/local package files
+node_modules/
+dist/
+coverage/
+*.log
+
+# Python/cache files
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Local environment files
+.env
+.env.*
+!.env.example
+*.local
+
+# Local generated files
+*.code-workspace
+auto/
+data/
+filestore/
+sessions/
+odoo/custom/auto/
+odoo/custom/src/*/.git-aggregate-cache/
+
+# Backups and archives
+*.bak
+*.backup
+*.dump
+*.sql
+*.zip
+*.tar
+*.tar.gz
+`;
+}
+export function renderMooDelegationScript() {
+    return `#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd -- "$(dirname -- "\${BASH_SOURCE[0]}")" && pwd)"
+cd "$script_dir"
+
+exec npx --yes @wpmoo/odoo@latest "$@"
+`;
+}
+export function renderAddonsYaml(options) {
+    return `# Addons activated from source submodules.
+#
+# Source repos are managed as Git submodules under odoo/custom/src/private.
+# Do not duplicate these same repos in repos.yaml.
+
+${options.sourceRepos.map((repo) => `private/${repo.path}:\n${yamlList(repo.addons)}`).join('\n\n')}
+`;
+}
+export function renderReposYaml(options) {
+    return `# git-aggregator repositories.
+#
+# Project source repositories are intentionally not listed here because
+# they are pinned as Git submodules:
+#
+${options.sourceRepos.map((repo) => `# - private/${repo.path}`).join('\n')}
+#
+# Keep this file for upstream/OCA repositories that should be aggregated.
+
+odoo:
+  defaults:
+    depth: $DEPTH_MERGE
+  remotes:
+    origin: https://github.com/OCA/OCB.git
+    odoo: https://github.com/odoo/odoo.git
+  target: origin $ODOO_VERSION
+  merges:
+    - origin $ODOO_VERSION
+`;
+}
+export function renderReadme(options) {
+    const title = titleizeProduct(options.product);
+    return `# ${title} Development Environment
+
+Private ${environmentKind()} development environment for the ${title} product.
+
+This repository owns the development environment only. Product source code lives
+in source repository submodules under \`odoo/custom/src/private\`.
+
+## Repository Layout
+
+\`\`\`text
+${repositoryLayout(options)}
+\`\`\`
+
+## Clone
+
+Clone with submodules:
+
+\`\`\`bash
+git clone --recurse-submodules ${options.devRepoUrl}
+cd ${options.devRepo}
+\`\`\`
+
+If already cloned:
+
+\`\`\`bash
+git submodule update --init --recursive
+\`\`\`
+
+## WPMoo CLI Shortcut
+
+This environment includes a local \`moo\` delegation script. From the repository
+root:
+
+\`\`\`bash
+./moo
+./moo add-module
+\`\`\`
+
+If this repository root is on your \`PATH\`, you can run \`moo ...\` from
+anywhere and the script will delegate back to this environment.
+${optionalAgentSkillsReadme(options)}
+## Source Repositories
+
+${sourceRepoDocs(options)}
+
+${environmentUsageDocs(options)}
+## Branching
+
+Use Odoo major-version branches in source repositories:
+
+\`\`\`text
+${options.odooVersion}
+\`\`\`
+
+This dev repository can stay on \`main\` and pin exact source commits through
+submodule references.
+`;
+}
+export function renderAgents(options) {
+    const repoList = options.sourceRepos
+        .map((repo) => `- \`${repo.path}\`: \`${repo.url}\``)
+        .join('\n');
+    const addonList = options.sourceRepos
+        .map((repo) => `\`${repo.path}\` addons:\n${repo.addons.map((addon) => `- \`${addon}\``).join('\n')}`)
+        .join('\n\n');
+    return `# AGENTS.md
+
+## Project
+
+Private ${environmentKind()} development environment for the ${titleizeProduct(options.product)} product.
+
+## Repository Roles
+
+- \`${options.devRepo}\`: environment/config only, private.
+${repoList}
+
+## Source Layout
+
+Product repositories are Git submodules:
+
+\`\`\`text
+${options.sourceRepos.map((repo) => `odoo/custom/src/private/${repo.path}`).join('\n')}
+\`\`\`
+
+${repoDuplicationNote()}
+${optionalAgentSkillsAgentsSection(options)}
+## Addon Boundaries
+
+${addonList}
+
+Public/community addons must not depend on private paid addons. Private paid
+addons may depend on public/community addons.
+
+## Odoo 19 Rules
+
+- Use \`<list>\` instead of \`<tree>\`.
+- Use direct view expressions such as \`invisible="..."\` instead of \`attrs\`.
+- Use \`models.Constraint\` instead of \`_sql_constraints\`.
+- Use \`@api.ondelete(at_uninstall=False)\` for delete validation.
+- Avoid \`default_*\` field names in \`res.config.settings\`.
+- Keep core/community installable without any pro modules.
+
+## Verification
+
+Use the environment's addon test/update command:
+
+\`\`\`bash
+${verificationCommand(options)}
+\`\`\`
+
+Only report completion after the relevant update/test command exits cleanly.
+`;
+}
+export function renderAppstoreRelease(options) {
+    return `# Odoo Apps Release Notes
+
+Paid addons can live together in a private source repository during development.
+Each paid addon still needs its own App Store metadata.
+
+Per addon checklist:
+
+- \`__manifest__.py\` has correct \`name\`, \`summary\`, \`version\`, \`depends\`,
+  \`license\`, \`price\`, \`currency\`, and \`support\`.
+- \`license\` is appropriate for paid distribution, typically \`OPL-1\`.
+- \`static/description/icon.png\` exists.
+- \`static/description/index.html\` exists.
+- Screenshots are stored under \`static/description/\`.
+- Community dependency versions are compatible with the target Odoo major
+  version.
+
+Recommended release flow:
+
+1. Develop in the relevant private source repository.
+2. Update the addon manifest version.
+3. Run update/test commands in this dev environment.
+4. Tag the source commit.
+5. Prepare an App Store publish package or publish mirror per paid addon.
+6. Trigger Odoo Apps repository scan/update.
+
+If App Store scan coupling becomes a problem, create separate private publish
+mirror repositories for each paid addon. Keep development in
+\`odoo/custom/src/private\`; mirrors should be generated artifacts, not
+hand-edited source repositories.
+`;
+}
+export function renderPlaceholder(title, body) {
+    return `# ${title}
+
+${body}
+`;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/update-check.js

@@ -0,0 +1,106 @@
+import { spawn } from 'node:child_process';
+import { execa } from 'execa';
+export const realNpm = {
+    async run(args) {
+        const result = await execa('npm', args, args[0] === 'view' ? { timeout: 5000 } : {});
+        return { stdout: result.stdout, stderr: result.stderr };
+    },
+};
+function truthyEnv(value) {
+    return value !== undefined && ['1', 'true', 'yes', 'y'].includes(value.toLowerCase().trim());
+}
+export function isUpdateCheckSkipped(argv, env = process.env) {
+    if (argv.includes('--no-update-check'))
+        return true;
+    if (truthyEnv(env.WPMOO_SKIP_UPDATE_CHECK))
+        return true;
+    return false;
+}
+function numericParts(version) {
+    return version
+        .replace(/^v/, '')
+        .split('-', 1)[0]
+        .split('.')
+        .map((part) => Number.parseInt(part, 10) || 0);
+}
+export function compareVersions(currentVersion, latestVersion) {
+    const current = numericParts(currentVersion);
+    const latest = numericParts(latestVersion);
+    const length = Math.max(current.length, latest.length);
+    for (let index = 0; index < length; index += 1) {
+        const currentPart = current[index] ?? 0;
+        const latestPart = latest[index] ?? 0;
+        if (currentPart !== latestPart) {
+            return currentPart - latestPart;
+        }
+    }
+    return 0;
+}
+function parseNpmPackageInfo(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed) {
+        throw new Error('npm did not return package metadata');
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed === 'object' && parsed !== null) {
+            const record = parsed;
+            const version = typeof record.version === 'string' ? record.version.trim() : '';
+            const dist = record.dist;
+            const nestedTarball = typeof dist === 'object' && dist !== null && typeof dist.tarball === 'string'
+                ? String(dist.tarball).trim()
+                : '';
+            const dottedTarball = typeof record['dist.tarball'] === 'string' ? record['dist.tarball'].trim() : '';
+            const tarball = nestedTarball || dottedTarball;
+            if (version && tarball) {
+                return { version, tarball };
+            }
+        }
+    }
+    catch {
+        // Fall through to the validation error below.
+    }
+    throw new Error('npm did not return a package version and tarball');
+}
+async function viewPackageInfo(packageSpecValue, runner) {
+    const result = await runner.run(['view', packageSpecValue, 'version', 'dist.tarball', '--json']);
+    return parseNpmPackageInfo(result.stdout);
+}
+export async function checkForUpdate(packageName, currentVersion, runner = realNpm) {
+    try {
+        const latest = await viewPackageInfo(packageSpec(packageName, 'latest'), runner);
+        if (compareVersions(currentVersion, latest.version) < 0) {
+            const exact = await viewPackageInfo(packageSpec(packageName, latest.version), runner);
+            if (exact.version !== latest.version || !exact.tarball) {
+                throw new Error(`npm metadata for ${packageSpec(packageName, latest.version)} did not validate`);
+            }
+            return { status: 'update-available', currentVersion, latestVersion: exact.version, tarball: exact.tarball };
+        }
+        return { status: 'current', currentVersion, latestVersion: latest.version };
+    }
+    catch {
+        return { status: 'unavailable', currentVersion };
+    }
+}
+export function packageSpec(packageName, version) {
+    return `${packageName}@${version}`;
+}
+export async function installLatestPackage(packageName, version, runner = realNpm) {
+    await runner.run(['install', '-g', packageSpec(packageName, version)]);
+}
+export function restartArgs(packageName, version, argv) {
+    return ['exec', '--yes', '--package', packageSpec(packageName, version), '--', 'wpmoo', ...argv];
+}
+export function restartEnvironment(env = process.env) {
+    return { ...env, WPMOO_SKIP_UPDATE_CHECK: '1' };
+}
+export async function restartCli(packageName, version, argv) {
+    const child = spawn('npm', restartArgs(packageName, version, argv), {
+        env: restartEnvironment(),
+        stdio: 'inherit',
+    });
+    return new Promise((resolve, reject) => {
+        child.on('error', reject);
+        child.on('exit', (code) => resolve(code));
+    });
+}

package/dist/version.js

@@ -0,0 +1,19 @@
+import { readFileSync } from 'node:fs';
+function readPackageJson() {
+    return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+}
+export function packageVersion() {
+    return readPackageJson().version;
+}
+export function renderVersion() {
+    const packageJson = readPackageJson();
+    return `${packageJson.name} ${packageJson.version}`;
+}
+export function packageName() {
+    return readPackageJson().name;
+}
+export function renderVersionTag(latestVersion) {
+    const current = packageVersion();
+    const updateSuffix = latestVersion ? ` -> v.${latestVersion} available` : '';
+    return `\u001B[33mv.${current}${updateSuffix}\u001B[0m`;
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@wpmoo/odoo",
+  "version": "0.8.30",
+  "description": "WPMoo Odoo lifecycle tooling for development, staging, and production workflows.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wpmoo-org/wpmoo-odoo.git"
+  },
+  "homepage": "https://github.com/wpmoo-org/wpmoo-odoo",
+  "bugs": {
+    "url": "https://github.com/wpmoo-org/wpmoo-odoo/issues"
+  },
+  "readmeFilename": "README.md",
+  "bin": {
+    "wpmoo": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "docs/assets"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "prebuild": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "execa": "^9.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT"
+}