@wpmoo/odoo 0.8.67 → 0.8.69

package/README.md

@@ -1,19 +1,21 @@
-![WPMoo Odoo development workflow tooling](docs/assets/wpmoo-banner.png)
+![WPMoo Tool for Odoo development workflows](docs/assets/wpmoo-banner.png)
 
-[![CI](https://img.shields.io/github/actions/workflow/status/wpmoo-org/wpmoo-odoo/ci.yml?branch=main&label=CI&style=flat-square)](https://github.com/wpmoo-org/wpmoo-odoo/actions/workflows/ci.yml) [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&style=flat-square)](https://github.com/wpmoo-org/wpmoo-odoo) [![npm](https://img.shields.io/npm/v/@wpmoo/odoo?label=npm&logo=npm&style=flat-square&color=blue)](https://www.npmjs.com/package/@wpmoo/odoo) [![coverage](https://img.shields.io/codecov/c/github/wpmoo-org/wpmoo-odoo?branch=main&label=coverage&logo=codecov&style=flat-square&color=blue)](https://codecov.io/gh/wpmoo-org/wpmoo-odoo) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE) [![Odoo Tool](https://img.shields.io/badge/Odoo-Tool-714B67?style=flat-square)](https://github.com/wpmoo-org/wpmoo-odoo) [![Buy Me a Coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?logo=buymeacoffee&logoColor=000000&style=flat-square)](https://www.buymeacoffee.com/cangir) [![Patreon](https://img.shields.io/badge/Patreon-Support-F96854?logo=patreon&logoColor=white&style=flat-square)](https://www.patreon.com/wpmoo)
+[![CI](https://img.shields.io/github/actions/workflow/status/wpmoo-org/wpmoo-odoo/ci.yml?branch=main&label=CI&style=flat-square)](https://github.com/wpmoo-org/wpmoo-odoo/actions/workflows/ci.yml) [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&style=flat-square)](https://github.com/wpmoo-org/wpmoo-odoo) [![npm](https://img.shields.io/npm/v/@wpmoo/odoo?label=npm&logo=npm&style=flat-square&color=blue)](https://www.npmjs.com/package/@wpmoo/odoo) [![coverage](https://img.shields.io/codecov/c/github/wpmoo-org/wpmoo-odoo?branch=main&label=coverage&logo=codecov&style=flat-square&color=blue)](https://codecov.io/gh/wpmoo-org/wpmoo-odoo) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE) [![WPMoo Tool](https://img.shields.io/badge/WPMoo-Tool-714B67?style=flat-square)](https://github.com/wpmoo-org/wpmoo-odoo) [![Buy Me a Coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?logo=buymeacoffee&logoColor=000000&style=flat-square)](https://www.buymeacoffee.com/cangir) [![Patreon](https://img.shields.io/badge/Patreon-Support-F96854?logo=patreon&logoColor=white&style=flat-square)](https://www.patreon.com/wpmoo)
 
-# WPMoo Odoo
+# WPMoo Tool
 
-WPMoo Odoo is a development-first CLI for creating and operating Docker Compose based Odoo environments with source repositories managed as Git submodules.
+WPMoo Tool is a development-first CLI for creating and operating Docker Compose based environments for Odoo, with source repositories managed as Git submodules.
 
 It gives Odoo teams a repeatable environment layout, a guided cockpit for daily work, direct commands for automation, and recovery tools that refresh generated files without touching product source code.
 
+WPMoo Tool is an independent project and is not affiliated with, endorsed by, or sponsored by Odoo S.A. Odoo is a trademark of Odoo S.A.
+
 ## Development Status
 
 > [!IMPORTANT]
-> **Pre-1.0 active development:** WPMoo Odoo has not reached `1.0.0` yet. Until the `1.0.0` release, use it as a preview tool for evaluation, local trials, and feedback rather than a dependency for critical production workflows. Setup conventions and command behavior may still change between pre-1.0 releases.
+> **Pre-1.0 active development:** WPMoo Tool has not reached `1.0.0` yet. Until the `1.0.0` release, use it as a preview tool for evaluation, local trials, and feedback rather than a dependency for critical production workflows. Setup conventions and command behavior may still change between pre-1.0 releases.
 
-## Why WPMoo Odoo
+## Why WPMoo Tool
 
 - Create a local Odoo development environment from a dev repository and one or more source repositories.
 - Keep product source repositories under `odoo/custom/src/private`, `odoo/custom/src/oca`, or `odoo/custom/src/external` as Git submodules pinned to the selected Odoo branch.
@@ -423,7 +425,7 @@ npx @wpmoo/odoo doctor --fix
 
 ## External Resources
 
-WPMoo Odoo keeps the package small by copying external resources into generated environments:
+WPMoo Tool keeps the package small by copying external resources into generated environments:
 
 ```text
 gh:wpmoo-org/odoo-docker-compose

package/dist/cli.js

@@ -1,12 +1,10 @@
 #!/usr/bin/env node
-import { confirm, intro, isCancel, note, outro, select, text } from '@clack/prompts';
 import { realpathSync } from 'node:fs';
 import { basename, relative, resolve } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { commandFromArgs, isHelpRequested, isVersionRequested, optionsFromArgs, parseArgs, stripInternalFlags, } from './args.js';
-import { selectCockpitCommandFromPalette } from './cockpit/command-palette.js';
 import { collectDailyActionArgs } from './cockpit/daily-prompts.js';
-import { selectCockpitCategoryCommand, selectCockpitTopLevelMenu } from './cockpit/menu.js';
+import { selectCockpitTopLevelMenu } from './cockpit/menu.js';
 import { confirmCockpitCommandRisk } from './cockpit/safety.js';
 import { detectDevelopmentEnvironment } from './environment.js';
 import { commandOdooVersion } from './environment-version.js';
@@ -25,6 +23,7 @@ import { renderSafeResetPreview, safeResetEnvironment } from './safe-reset.js';
 import { listSources, renderSourceList, sourceListJson, sourceSyncJson, syncSources, } from './source-actions.js';
 import { checkGitHubRepositories, createGitHubRepositories, manualCreateCommands, repositoryPreflightAvailable, } from './repository-preflight.js';
 import { scaffold } from './scaffold.js';
+import { confirmPrompt, introPrompt, isPromptCancel, notePrompt, outroPrompt, selectPrompt, textPrompt } from './prompts/index.js';
 import { renderBanner } from './templates.js';
 import { checkForUpdate, installLatestPackage, isUpdateCheckSkipped, restartCli } from './update-check.js';
 import { packageName, packageVersion, renderVersion, renderVersionTag } from './version.js';
@@ -33,11 +32,11 @@ import { getGitHubAccounts, getGitHubRepositoryStatus, githubRepositoryUrl, real
 import { environmentGitHubOwner } from './environment-context.js';
 import { handlePromptCancel, handleUnavailableMenuChoice, installPromptCancelKeyTracker, isMenuBackSignal, MenuBackSignal, menuIntroTitle, menuPromptMessage, } from './menu-navigation.js';
 function handleCancel(value, action) {
-    handlePromptCancel(isCancel(value), action);
+    handlePromptCancel(isPromptCancel(value), action);
 }
 function showSubmenuIntro(title, showIntro, cancelAction) {
     if (showIntro) {
-        intro(menuIntroTitle(title, cancelAction));
+        introPrompt(menuIntroTitle(title, cancelAction));
     }
 }
 function asString(value, fallback, cancelAction = 'exit') {
@@ -59,7 +58,7 @@ async function selectDefaultGitHubOwner(cancelAction = 'exit', preferredOwner) {
         const initialValue = accounts.some((account) => account.login === preferredOwner)
             ? preferredOwner
             : accounts[0].login;
-        const selectedOwner = await select({
+        const selectedOwner = await selectPrompt({
             message: 'GitHub account/organization',
             options: accounts.map((account) => ({
                 value: account.login,
@@ -155,7 +154,7 @@ async function showStartup(argv, skipUpdateCheck) {
     const updateCheck = await checkForUpdate(packageName(), packageVersion());
     console.log(renderVersionTag(updateCheck.status === 'update-available' ? updateCheck.latestVersion : undefined));
     if (updateCheck.status === 'update-available') {
-        const shouldUpdate = await confirm({
+        const shouldUpdate = await confirmPrompt({
             message: `Update to v.${updateCheck.latestVersion}? (Y/n)`,
             active: 'Y',
             inactive: 'n',
@@ -184,28 +183,25 @@ async function selectCockpitCommandFromMenu() {
     if (selection.kind === 'exit') {
         return 'exit';
     }
-    if (selection.kind === 'command-palette') {
-        return selectCockpitCommandFromPalette();
-    }
-    return selectCockpitCategoryCommand(selection.category);
+    return selection.command;
 }
 async function optionsFromPrompts(showIntro = true, cancelAction = 'exit') {
     if (showIntro) {
-        intro('Create Odoo dev environment');
+        introPrompt('Create Odoo dev environment');
     }
-    const product = asString(await text({
+    const product = asString(await textPrompt({
         message: 'Product slug',
         placeholder: 'odoo_sample_module',
         validate: (value) => (value.trim() ? undefined : 'Enter a product/module slug.'),
     }), 'odoo_sample_module', cancelAction);
     const defaultTarget = `./${product}_dev`;
-    const target = resolve(asString(await text({
+    const target = resolve(asString(await textPrompt({
         message: 'Environment folder',
         placeholder: defaultTarget,
         defaultValue: defaultTarget,
         initialValue: defaultTarget,
     }), defaultTarget, cancelAction));
-    const connectGitHub = await select({
+    const connectGitHub = await selectPrompt({
         message: 'Connect this environment to Git/GitHub now?',
         options: [
             { value: true, label: 'Yes, connect Git/GitHub repositories' },
@@ -216,10 +212,10 @@ async function optionsFromPrompts(showIntro = true, cancelAction = 'exit') {
     handleCancel(connectGitHub, cancelAction);
     let selectedGitHubOwner;
     if (connectGitHub) {
-        note(renderRepositorySetupNote(product), 'Repository setup');
+        notePrompt(renderRepositorySetupNote(product), 'Repository setup');
         selectedGitHubOwner = await selectDefaultGitHubOwner(cancelAction);
     }
-    const selectedVersion = await select({
+    const selectedVersion = await selectPrompt({
         message: menuPromptMessage('Odoo version', cancelAction),
         options: supportedOdooVersions.map((version) => ({ value: version, label: version })),
         initialValue: supportedOdooVersions[0],
@@ -227,7 +223,7 @@ async function optionsFromPrompts(showIntro = true, cancelAction = 'exit') {
     handleCancel(selectedVersion, cancelAction);
     const odooVersion = String(selectedVersion);
     async function promptInstallAgentSkills() {
-        const installAgentSkills = await select({
+        const installAgentSkills = await selectPrompt({
             message: 'Install project-local Odoo Agent Skills?',
             options: [
                 { value: true, label: 'Yes, install latest default skills' },
@@ -287,7 +283,7 @@ async function optionsFromPrompts(showIntro = true, cancelAction = 'exit') {
             path: sourcePath,
             addons: [sourcePath],
         });
-        const shouldAddAnother = await select({
+        const shouldAddAnother = await selectPrompt({
             message: 'Add another source repo?',
             options: [
                 { value: false, label: 'No' },
@@ -299,7 +295,7 @@ async function optionsFromPrompts(showIntro = true, cancelAction = 'exit') {
         addAnother = Boolean(shouldAddAnother);
     }
     const installAgentSkills = await promptInstallAgentSkills();
-    const initEmpty = await select({
+    const initEmpty = await selectPrompt({
         message: 'Initialize repositories that exist but have no commits?',
         options: [
             { value: true, label: 'Yes, create the selected Odoo branch' },
@@ -348,12 +344,12 @@ async function addRepoOptionsFromPrompts(showIntro = true, cancelAction = 'exit'
     const preferredOwner = await environmentGitHubOwner(target);
     const selectedOwner = await selectDefaultGitHubOwner(cancelAction, preferredOwner);
     const owner = selectedOwner ??
-        asString(await text({
+        asString(await textPrompt({
             message: menuPromptMessage('GitHub owner/organization', cancelAction),
             placeholder: 'example-org',
             validate: (value) => (value.trim() ? undefined : 'Enter a GitHub owner or organization.'),
         }), 'example-org', cancelAction);
-    const repoName = asString(await text({
+    const repoName = asString(await textPrompt({
         message: menuPromptMessage('Source repo name', cancelAction),
         placeholder: 'odoo_sample_module_repo',
         validate: validateRepoName,
@@ -370,7 +366,7 @@ async function addRepoOptionsFromPrompts(showIntro = true, cancelAction = 'exit'
 }
 async function ensureAddRepoGitHubRepository(options, cancelAction = 'exit') {
     if (!(await repositoryPreflightAvailable())) {
-        note([
+        notePrompt([
             'GitHub CLI (`gh`) is not available or not authenticated.',
             'The source repo will be used as-is. If it does not exist, create it first or authenticate gh.',
         ].join('\n'), 'Repository check skipped');
@@ -380,8 +376,8 @@ async function ensureAddRepoGitHubRepository(options, cancelAction = 'exit') {
     if (status.status !== 'inaccessible') {
         return;
     }
-    note(`Source repo is not accessible: ${status.slug}`, 'Repository check');
-    const shouldCreate = await select({
+    notePrompt(`Source repo is not accessible: ${status.slug}`, 'Repository check');
+    const shouldCreate = await selectPrompt({
         message: 'Create this source repository with GitHub CLI?',
         options: [
             { value: true, label: 'Yes, create it' },
@@ -393,7 +389,7 @@ async function ensureAddRepoGitHubRepository(options, cancelAction = 'exit') {
     if (!shouldCreate) {
         throw new Error(`Source repository is not accessible: ${status.slug}`);
     }
-    const visibility = await select({
+    const visibility = await selectPrompt({
         message: 'Visibility for new repository',
         options: [
             { value: 'private', label: 'Private' },
@@ -417,12 +413,12 @@ async function selectSourceRepo(target, cancelAction = 'exit') {
         }));
     if (repoOptions.length === 0) {
         if (cancelAction === 'back') {
-            note(`No source repos found under ${target}/odoo/custom/src.\nNext: choose "Add source repo" first.`, 'Nothing to select');
+            notePrompt(`No source repos found under ${target}/odoo/custom/src.\nNext: choose "Add source repo" first.`, 'Nothing to select');
             handleUnavailableMenuChoice(cancelAction);
         }
         throw new Error(`No source repos found under ${target}/odoo/custom/src`);
     }
-    const selected = await select({
+    const selected = await selectPrompt({
         message: menuPromptMessage('Source repo', cancelAction),
         options: repoOptions,
         initialValue: repoOptions[0].value,
@@ -463,7 +459,7 @@ async function addModuleOptionsFromPrompts(showIntro = true, cancelAction = 'exi
     showSubmenuIntro('Add module to source repo', showIntro, cancelAction);
     const target = process.cwd();
     const sourceRepo = await selectSourceRepo(target, cancelAction);
-    const moduleName = asString(await text({
+    const moduleName = asString(await textPrompt({
         message: menuPromptMessage('Module name', cancelAction),
         placeholder: suggestedModuleName(sourceRepo.repoPath),
         validate: (value) => (value.trim() ? undefined : 'Enter the module technical name.'),
@@ -555,7 +551,7 @@ async function runSourceCommand(argv) {
             return;
         }
         console.log(renderBanner());
-        outro(`Synced source manifest in ${options.target}.`);
+        outroPrompt(`Synced source manifest in ${options.target}.`);
         return;
     }
     if (subcommand === 'add') {
@@ -565,7 +561,7 @@ async function runSourceCommand(argv) {
         }
         console.log(renderBanner());
         await addModuleRepo(options);
-        outro(`Added source repo under ${renderedSourceRepoPath(options.target, options.sourceType ?? 'private', options.repoPath)}.`);
+        outroPrompt(`Added source repo under ${renderedSourceRepoPath(options.target, options.sourceType ?? 'private', options.repoPath)}.`);
         return;
     }
     if (subcommand === 'remove') {
@@ -575,14 +571,14 @@ async function runSourceCommand(argv) {
         }
         console.log(renderBanner());
         await removeModuleRepo(options);
-        outro(`Removed source repo ${options.repoPath} from ${options.target}.`);
+        outroPrompt(`Removed source repo ${options.repoPath} from ${options.target}.`);
         return;
     }
     throw new Error(sourceUsage());
 }
 async function confirmSafeResetFromMenu(options) {
-    note(renderSafeResetPreview(options.target, options.stage), 'Safe reset preview');
-    const confirmed = await confirm({
+    notePrompt(renderSafeResetPreview(options.target, options.stage), 'Safe reset preview');
+    const confirmed = await confirmPrompt({
         message: menuPromptMessage('Continue with safe reset?', 'back'),
         active: 'Yes',
         inactive: 'No',
@@ -600,12 +596,12 @@ async function removeRepoOptionsFromPrompts(argv, showIntro = true, cancelAction
     const repos = await listModuleRepos(target);
     if (repos.length === 0) {
         if (cancelAction === 'back') {
-            note(`No module submodules found under ${target}/odoo/custom/src/private.\nNext: choose "Add source repo" first.`, 'Nothing to remove');
+            notePrompt(`No module submodules found under ${target}/odoo/custom/src/private.\nNext: choose "Add source repo" first.`, 'Nothing to remove');
             handleUnavailableMenuChoice(cancelAction);
         }
         throw new Error(`No module submodules found under ${target}/odoo/custom/src/private`);
     }
-    const repoPath = await select({
+    const repoPath = await selectPrompt({
         message: menuPromptMessage('Repo to remove', cancelAction),
         options: repos.map((repo) => ({ value: repo, label: repo })),
         initialValue: repos[0],
@@ -640,18 +636,18 @@ async function removeModuleOptionsFromPrompts(showIntro = true, cancelAction = '
     const modules = await listModulesInSourceRepo(target, sourceRepo.repoPath, sourceRepo.sourceType);
     if (modules.length === 0) {
         if (cancelAction === 'back') {
-            note(`No Odoo modules found under ${formatSourceRepoPromptPath(target, sourceRepo)}.\nNext: choose "Add module to source repo" first.`, 'Nothing to remove');
+            notePrompt(`No Odoo modules found under ${formatSourceRepoPromptPath(target, sourceRepo)}.\nNext: choose "Add module to source repo" first.`, 'Nothing to remove');
             handleUnavailableMenuChoice(cancelAction);
         }
         throw new Error(`No Odoo modules found under ${formatSourceRepoPromptPath(target, sourceRepo)}`);
     }
-    const moduleName = await select({
+    const moduleName = await selectPrompt({
         message: menuPromptMessage('Module to remove', cancelAction),
         options: modules.map((module) => ({ value: module, label: module })),
         initialValue: modules[0],
     });
     handleCancel(moduleName, cancelAction);
-    const deleteFiles = await confirm({
+    const deleteFiles = await confirmPrompt({
         message: menuPromptMessage('Delete module files too? (y/N)', cancelAction),
         active: 'Y',
         inactive: 'n',
@@ -689,13 +685,13 @@ async function ensureGitHubRepositories(options, interactive) {
             throw new Error(message);
         }
         if (interactive) {
-            note(message, 'Repository check skipped');
+            notePrompt(message, 'Repository check skipped');
         }
         return;
     }
     const { accessible, inaccessible: missing } = await checkGitHubRepositories(options);
     if (interactive && accessible.length > 0) {
-        note([
+        notePrompt([
             'These GitHub repositories already exist and are accessible:',
             '',
             ...accessible.map((repository) => `- ${repository.label}: ${repository.slug}`),
@@ -711,12 +707,12 @@ async function ensureGitHubRepositories(options, interactive) {
         await createGitHubRepositories(missing, options.repoVisibility ?? 'private');
         return;
     }
-    note([
+    notePrompt([
         'These GitHub repositories are not accessible. They may not exist, or your account may not have access:',
         '',
         missingList,
     ].join('\n'), 'Repository check');
-    const shouldCreate = await select({
+    const shouldCreate = await selectPrompt({
         message: 'Create the inaccessible repositories with GitHub CLI?',
         options: [
             { value: true, label: 'Yes, create them' },
@@ -724,12 +720,11 @@ async function ensureGitHubRepositories(options, interactive) {
         ],
         initialValue: true,
     });
-    if (isCancel(shouldCreate))
-        process.exit(1);
+    handleCancel(shouldCreate, 'exit');
     if (!shouldCreate) {
         throw new Error(['Required repositories are not accessible. Create them first:', '', ...manualCreateCommands(missing)].join('\n'));
     }
-    const visibility = await select({
+    const visibility = await selectPrompt({
         message: 'Visibility for new repositories',
         options: [
             { value: 'private', label: 'Private' },
@@ -737,8 +732,7 @@ async function ensureGitHubRepositories(options, interactive) {
         ],
         initialValue: 'private',
     });
-    if (isCancel(visibility))
-        process.exit(1);
+    handleCancel(visibility, 'exit');
     await createGitHubRepositories(missing, visibility);
 }
 async function runCockpitCommand(command, cwd) {
@@ -748,62 +742,62 @@ async function runCockpitCommand(command, cwd) {
     if (command.target.kind === 'daily') {
         const argv = await collectDailyActionArgs(command.target.command, cwd);
         if (!(await confirmCockpitCommandRisk(command))) {
-            note(`${command.slashAlias} was not run.`, 'Action skipped');
+            notePrompt(`${command.slashAlias} was not run.`, 'Action skipped');
             return 'continue';
         }
         await runDailyAction(command.target.command, argv, cwd);
-        note(`${command.slashAlias} completed.`, 'Done');
+        notePrompt(`${command.slashAlias} completed.`, 'Done');
         return 'continue';
     }
     if (command.id === 'status') {
-        note(await renderEnvironmentStatusForTarget(cwd), 'Environment status');
+        notePrompt(await renderEnvironmentStatusForTarget(cwd), 'Environment status');
         return 'continue';
     }
     if (command.id === 'doctor') {
-        note(await runDoctor(cwd), 'Doctor');
+        notePrompt(await runDoctor(cwd), 'Doctor');
         return 'continue';
     }
     if (command.id === 'add-repo') {
         const options = await addRepoOptionsFromPrompts(false, 'back');
         await ensureAddRepoGitHubRepository(options, 'back');
         await addModuleRepo(options);
-        note(`Added source repo under ${renderedSourceRepoPath(options.target, options.sourceType ?? 'private')}.`, 'Done');
+        notePrompt(`Added source repo under ${renderedSourceRepoPath(options.target, options.sourceType ?? 'private')}.`, 'Done');
         return 'continue';
     }
     if (command.id === 'remove-repo') {
         const options = await removeRepoOptionsFromPrompts([], false, 'back');
         if (!(await confirmCockpitCommandRisk(command))) {
-            note(`Source repo ${options.repoPath} was not removed.`, 'Action skipped');
+            notePrompt(`Source repo ${options.repoPath} was not removed.`, 'Action skipped');
             return 'continue';
         }
         await removeModuleRepo(options);
-        note(`Removed source repo ${options.repoPath} from ${options.target}.`, 'Done');
+        notePrompt(`Removed source repo ${options.repoPath} from ${options.target}.`, 'Done');
         return 'continue';
     }
     if (command.id === 'add-module') {
         const options = await addModuleOptionsFromPrompts(false, 'back');
         await addModuleToSourceRepo(options);
-        note(`Added module ${options.moduleName} under source repo ${options.repoPath}.`, 'Done');
+        notePrompt(`Added module ${options.moduleName} under source repo ${options.repoPath}.`, 'Done');
         return 'continue';
     }
     if (command.id === 'remove-module') {
         const options = await removeModuleOptionsFromPrompts(false, 'back');
         if (!(await confirmCockpitCommandRisk(command))) {
-            note(`Module ${options.moduleName} was not removed.`, 'Action skipped');
+            notePrompt(`Module ${options.moduleName} was not removed.`, 'Action skipped');
             return 'continue';
         }
         await removeModuleFromSourceRepo(options);
-        note(`Removed module ${options.moduleName} from source repo ${options.repoPath}.`, 'Done');
+        notePrompt(`Removed module ${options.moduleName} from source repo ${options.repoPath}.`, 'Done');
         return 'continue';
     }
     if (command.id === 'safe-reset') {
         const options = { target: cwd, stage: true };
         await confirmSafeResetFromMenu(options);
         await safeResetEnvironment(options);
-        note(`Safe reset refreshed generated environment files in ${cwd}.`, 'Done');
+        notePrompt(`Safe reset refreshed generated environment files in ${cwd}.`, 'Done');
         return 'continue';
     }
-    note(`Unknown cockpit command: ${command.slashAlias}`, 'No action');
+    notePrompt(`Unknown cockpit command: ${command.slashAlias}`, 'No action');
     return 'continue';
 }
 export async function runCli(cliArgv = process.argv.slice(2), cwd = process.cwd()) {
@@ -827,15 +821,15 @@ export async function runCli(cliArgv = process.argv.slice(2), cwd = process.cwd(
             const resolvedOptions = await optionsFromPrompts();
             await ensureGitHubRepositories(resolvedOptions, true);
             await scaffold(resolvedOptions);
-            note(renderPostCreateGuidance(resolvedOptions.target, cwd), 'Next steps');
-            outro(`Created Odoo dev overlay in ${resolvedOptions.target}. Review staged changes, then commit.`);
+            notePrompt(renderPostCreateGuidance(resolvedOptions.target, cwd), 'Next steps');
+            outroPrompt(`Created Odoo dev overlay in ${resolvedOptions.target}. Review staged changes, then commit.`);
             return;
         }
-        intro('WPMoo Odoo Dev');
+        introPrompt('WPMoo Tool');
         while (true) {
             try {
                 const status = await getEnvironmentStatus(cwd);
-                note(renderEnvironmentStatusSummary(status), 'Environment status');
+                notePrompt(renderEnvironmentStatusSummary(status), 'Environment status');
                 const command = await selectCockpitCommandFromMenu();
                 if (command === 'exit') {
                     return;
@@ -858,14 +852,14 @@ export async function runCli(cliArgv = process.argv.slice(2), cwd = process.cwd(
         if (options) {
             console.log(renderBanner());
             await addModuleRepo(options);
-            outro(`Added source repo under ${renderedSourceRepoPath(options.target, options.sourceType ?? 'private', options.repoPath)}.`);
+            outroPrompt(`Added source repo under ${renderedSourceRepoPath(options.target, options.sourceType ?? 'private', options.repoPath)}.`);
             return;
         }
         await showStartup(argv, skipUpdateCheck);
         const promptedOptions = await addRepoOptionsFromPrompts();
         await ensureAddRepoGitHubRepository(promptedOptions);
         await addModuleRepo(promptedOptions);
-        outro(`Added source repo under ${promptedOptions.target}/odoo/custom/src/private.`);
+        outroPrompt(`Added source repo under ${promptedOptions.target}/odoo/custom/src/private.`);
         return;
     }
     if (route.command === 'remove-repo') {
@@ -873,13 +867,13 @@ export async function runCli(cliArgv = process.argv.slice(2), cwd = process.cwd(
         if (options) {
             console.log(renderBanner());
             await removeModuleRepo(options);
-            outro(`Removed source repo ${options.repoPath} from ${options.target}.`);
+            outroPrompt(`Removed source repo ${options.repoPath} from ${options.target}.`);
             return;
         }
         await showStartup(argv, skipUpdateCheck);
         const promptedOptions = await removeRepoOptionsFromPrompts(route.argv);
         await removeModuleRepo(promptedOptions);
-        outro(`Removed source repo ${promptedOptions.repoPath} from ${promptedOptions.target}.`);
+        outroPrompt(`Removed source repo ${promptedOptions.repoPath} from ${promptedOptions.target}.`);
         return;
     }
     if (route.command === 'source') {
@@ -891,13 +885,13 @@ export async function runCli(cliArgv = process.argv.slice(2), cwd = process.cwd(
         if (options) {
             console.log(renderBanner());
             await addModuleToSourceRepo(options);
-            outro(`Added module ${options.moduleName} under source repo ${options.repoPath}.`);
+            outroPrompt(`Added module ${options.moduleName} under source repo ${options.repoPath}.`);
             return;
         }
         await showStartup(argv, skipUpdateCheck);
         const promptedOptions = await addModuleOptionsFromPrompts();
         await addModuleToSourceRepo(promptedOptions);
-        outro(`Added module ${promptedOptions.moduleName} under source repo ${promptedOptions.repoPath}.`);
+        outroPrompt(`Added module ${promptedOptions.moduleName} under source repo ${promptedOptions.repoPath}.`);
         return;
     }
     if (route.command === 'remove-module') {
@@ -905,13 +899,13 @@ export async function runCli(cliArgv = process.argv.slice(2), cwd = process.cwd(
         if (options) {
             console.log(renderBanner());
             await removeModuleFromSourceRepo(options);
-            outro(`Removed module ${options.moduleName} from source repo ${options.repoPath}.`);
+            outroPrompt(`Removed module ${options.moduleName} from source repo ${options.repoPath}.`);
             return;
         }
         await showStartup(argv, skipUpdateCheck);
         const promptedOptions = await removeModuleOptionsFromPrompts();
         await removeModuleFromSourceRepo(promptedOptions);
-        outro(`Removed module ${promptedOptions.moduleName} from source repo ${promptedOptions.repoPath}.`);
+        outroPrompt(`Removed module ${promptedOptions.moduleName} from source repo ${promptedOptions.repoPath}.`);
         return;
     }
     if (route.command === 'reset') {
@@ -923,7 +917,7 @@ export async function runCli(cliArgv = process.argv.slice(2), cwd = process.cwd(
         }
         const resetOptions = { target: options.target, stage: options.stage };
         await safeResetEnvironment(resetOptions);
-        outro(`Safe reset refreshed generated environment files in ${options.target}.`);
+        outroPrompt(`Safe reset refreshed generated environment files in ${options.target}.`);
         return;
     }
     if (route.command === 'doctor') {
@@ -978,8 +972,8 @@ export async function runCli(cliArgv = process.argv.slice(2), cwd = process.cwd(
             console.log(`- ${command}`);
         return;
     }
-    note(renderPostCreateGuidance(resolvedOptions.target, cwd), 'Next steps');
-    outro(`Created Odoo dev overlay in ${resolvedOptions.target}. Review staged changes, then commit.`);
+    notePrompt(renderPostCreateGuidance(resolvedOptions.target, cwd), 'Next steps');
+    outroPrompt(`Created Odoo dev overlay in ${resolvedOptions.target}. Review staged changes, then commit.`);
 }
 export function isCliEntrypoint(metaUrl, argvPath = process.argv[1]) {
     if (!argvPath)

package/dist/cockpit/command-palette.js

@@ -1,6 +1,6 @@
-import search from '@inquirer/search';
+import { isPromptCancel, searchPrompt } from '../prompts/index.js';
 import { searchCockpitCommands } from './command-registry.js';
-const defaultSearchPrompt = (config) => search(config);
+const defaultSearchPrompt = (config) => searchPrompt(config);
 function commandChoice(command) {
     return {
         value: command,
@@ -11,9 +11,13 @@ function commandChoice(command) {
 }
 export async function selectCockpitCommandFromPalette(options = {}) {
     const prompt = options.prompt ?? defaultSearchPrompt;
-    return prompt({
+    const selected = await prompt({
         message: 'Search commands',
         pageSize: 10,
         source: (term) => searchCockpitCommands(term).map(commandChoice),
     });
+    if (isPromptCancel(selected)) {
+        throw new Error('Prompt was canceled.');
+    }
+    return selected;
 }

package/dist/cockpit/daily-prompts.js

@@ -1,17 +1,17 @@
-import { isCancel, select, text } from '@clack/prompts';
 import { listModulesInSourceRepo } from '../module-actions.js';
 import { listModuleRepos } from '../repo-actions.js';
 import { listSources } from '../source-actions.js';
 import { handlePromptCancel, menuPromptMessage, } from '../menu-navigation.js';
+import { isPromptCancel, selectPrompt, textPrompt } from '../prompts/index.js';
 const manualModuleValue = '__wpmoo_manual_module_entry__';
 function defaultCancelHandler(value, action) {
-    handlePromptCancel(isCancel(value), action);
+    handlePromptCancel(isPromptCancel(value), action);
 }
 function promptDeps(deps = {}) {
     return {
-        select: deps.select ?? ((options) => select(options)),
-        text: deps.text ?? ((options) => text(options)),
-        list: deps.list ?? ((options) => select(options)),
+        select: deps.select ?? ((options) => selectPrompt(options)),
+        text: deps.text ?? ((options) => textPrompt(options)),
+        list: deps.list ?? ((options) => selectPrompt(options)),
         handleCancel: deps.handleCancel ?? defaultCancelHandler,
     };
 }

package/dist/cockpit/menu.js

@@ -1,7 +1,7 @@
-import { isCancel, select } from '@clack/prompts';
+import { styleText } from 'node:util';
 import { cockpitCommands, } from './command-registry.js';
-import { handlePromptCancel, menuPromptMessage, MenuBackSignal } from '../menu-navigation.js';
-export const cockpitMenuBackValue = '__wpmoo_cockpit_menu_back__';
+import { handlePromptCancel } from '../menu-navigation.js';
+import { isPromptCancel, promptSeparator, selectPrompt, } from '../prompts/index.js';
 const categoryLabels = {
     services: 'Services',
     modules: 'Modules',
@@ -10,29 +10,59 @@ const categoryLabels = {
     repositories: 'Repositories',
     maintenance: 'Maintenance',
 };
-const topLevelOptions = [
-    { value: 'command-palette', label: 'Command palette /' },
-    { value: 'services', label: categoryLabels.services },
-    { value: 'modules', label: categoryLabels.modules },
-    { value: 'database', label: categoryLabels.database },
-    { value: 'diagnostics', label: categoryLabels.diagnostics },
-    { value: 'repositories', label: categoryLabels.repositories },
-    { value: 'maintenance', label: categoryLabels.maintenance },
-    { value: 'exit', label: 'Exit' },
-];
-const categories = new Set([
+const topLevelCategoryOrder = [
     'services',
     'modules',
     'database',
     'diagnostics',
     'repositories',
     'maintenance',
-]);
+];
+const topLevelCommands = topLevelCategoryOrder.flatMap((category) => cockpitCommands.filter((command) => command.category === category && command.id !== 'exit'));
+const topLevelCommandLabelWidth = Math.max(...topLevelCommands.map((command) => command.label.length));
+function color(format, value) {
+    return styleText(format, value, { validateStream: false });
+}
+function categoryHeading(category) {
+    return color('white', categoryLabels[category]);
+}
+function commandName(command) {
+    return `${color('yellow', `  ${command.label.padEnd(topLevelCommandLabelWidth)}`)}${color('dim', `  ${command.description}`)}`;
+}
+function categoryChoices(category, index) {
+    const choices = [
+        promptSeparator(categoryHeading(category)),
+        ...topLevelCommands
+            .filter((command) => command.category === category)
+            .map((command) => ({
+            value: command,
+            name: commandName(command),
+            short: command.label,
+        })),
+    ];
+    if (index < topLevelCategoryOrder.length - 1) {
+        choices.push(promptSeparator(' '));
+    }
+    return choices;
+}
+const topLevelChoices = [
+    ...topLevelCategoryOrder.flatMap(categoryChoices),
+    { value: 'exit', name: 'Exit', short: 'Exit' },
+];
+const minimumTopLevelPageSize = 8;
+const startupViewportReservedRows = 23;
+function topLevelPageSize(choiceCount) {
+    const terminalRows = process.stdout.rows;
+    if (!terminalRows || terminalRows <= 0) {
+        return Math.min(choiceCount, 12);
+    }
+    return Math.min(choiceCount, Math.max(minimumTopLevelPageSize, terminalRows - startupViewportReservedRows));
+}
 function defaultSelect(options) {
-    return select(options);
+    return selectPrompt(options);
 }
 function defaultCancelHandler(value, action) {
-    handlePromptCancel(isCancel(value), action);
+    handlePromptCancel(isPromptCancel(value), action);
 }
 function menuDeps(deps = {}) {
     return {
@@ -40,49 +70,27 @@ function menuDeps(deps = {}) {
         handleCancel: deps.handleCancel ?? defaultCancelHandler,
     };
 }
-function isCockpitCommandCategory(value) {
-    return typeof value === 'string' && categories.has(value);
+function isCockpitCommand(value) {
+    return typeof value === 'object' && value !== null && 'id' in value && 'slashAlias' in value;
 }
 export async function selectCockpitTopLevelMenu(options = {}) {
     const deps = menuDeps(options);
     const selected = await deps.select({
         message: 'What do you want to do?',
-        options: [...topLevelOptions],
-        initialValue: 'command-palette',
+        choices: [...topLevelChoices],
+        default: topLevelCommands[0],
+        pageSize: topLevelPageSize(topLevelChoices.length),
+        loop: false,
     });
     deps.handleCancel(selected, 'exit');
-    if (selected === 'command-palette') {
-        return { kind: 'command-palette' };
-    }
     if (selected === 'exit') {
         return { kind: 'exit' };
     }
-    if (isCockpitCommandCategory(selected)) {
+    if (isCockpitCommand(selected)) {
         return {
-            kind: 'category',
-            category: selected,
+            kind: 'command',
+            command: selected,
         };
     }
     return { kind: 'exit' };
 }
-export async function selectCockpitCategoryCommand(category, options = {}) {
-    const deps = menuDeps(options);
-    const commands = cockpitCommands.filter((command) => command.category === category && command.id !== 'exit');
-    const selected = await deps.select({
-        message: menuPromptMessage(categoryLabels[category], 'back'),
-        options: [
-            ...commands.map((command) => ({
-                value: command,
-                label: command.label,
-                hint: command.description,
-            })),
-            { value: cockpitMenuBackValue, label: 'Back' },
-        ],
-        initialValue: commands[0],
-    });
-    deps.handleCancel(selected, 'back');
-    if (selected === cockpitMenuBackValue) {
-        throw new MenuBackSignal();
-    }
-    return selected;
-}

package/dist/cockpit/safety.js

@@ -1,7 +1,7 @@
-import { confirm, isCancel } from '@clack/prompts';
 import { handlePromptCancel, menuPromptMessage } from '../menu-navigation.js';
+import { confirmPrompt, isPromptCancel } from '../prompts/index.js';
 function defaultHandleCancel(value, action) {
-    handlePromptCancel(isCancel(value), action);
+    handlePromptCancel(isPromptCancel(value), action);
 }
 function riskConfirmationMessage(command, action) {
     return menuPromptMessage(`Run ${command.slashAlias} ${command.label}? This can change or remove environment state.`, action);
@@ -10,7 +10,7 @@ export async function confirmCockpitCommandRisk(command, deps = {}) {
     if (!command.isRisky) {
         return true;
     }
-    const prompt = deps.confirm ?? confirm;
+    const prompt = deps.confirm ?? confirmPrompt;
     const cancelAction = deps.cancelAction ?? 'back';
     const approved = await prompt({
         message: riskConfirmationMessage(command, cancelAction),

package/dist/daily-actions.js

@@ -150,7 +150,7 @@ async function assertEnvironmentRoot(cwd) {
         await access(join(cwd, markerPath));
     }
     catch {
-        throw new Error('Daily actions must be run from a WPMoo Odoo environment root containing .wpmoo/odoo.json.');
+        throw new Error('Daily actions must be run from a WPMoo Tool environment root containing .wpmoo/odoo.json.');
     }
 }
 async function assertScriptExists(cwd, script) {

package/dist/help.js

@@ -1,7 +1,7 @@
 export function renderHelp() {
     return `@wpmoo/odoo
 
-WPMoo Odoo lifecycle tooling.
+WPMoo Tool for Odoo lifecycle workflows.
 
 Usage:
   npx @wpmoo/odoo

package/dist/prompt-repositories.js

@@ -1,8 +1,8 @@
-import { confirm, isCancel, text } from '@clack/prompts';
+import { confirmPrompt, isPromptCancel, textPrompt, } from './prompts/index.js';
 import { handlePromptCancel, menuPromptMessage } from './menu-navigation.js';
 const defaultPrompt = {
-    confirm,
-    text,
+    confirm: confirmPrompt,
+    text: textPrompt,
 };
 export async function promptRepositoryUrl({ label, suggestedUrl, placeholder, prompt = defaultPrompt, cancelAction = 'exit', }) {
     if (suggestedUrl) {
@@ -12,7 +12,7 @@ export async function promptRepositoryUrl({ label, suggestedUrl, placeholder, pr
             inactive: 'n',
             initialValue: true,
         });
-        if (isCancel(useSuggested)) {
+        if (isPromptCancel(useSuggested)) {
             handlePromptCancel(true, cancelAction);
         }
         if (useSuggested) {
@@ -24,7 +24,7 @@ export async function promptRepositoryUrl({ label, suggestedUrl, placeholder, pr
         placeholder,
         validate: (input) => (input.trim() ? undefined : `Enter the ${label.toLowerCase()}.`),
     });
-    if (isCancel(value)) {
+    if (isPromptCancel(value)) {
         handlePromptCancel(true, cancelAction);
     }
     if (typeof value === 'string' && value.trim()) {

package/dist/prompts/index.js

@@ -0,0 +1,149 @@
+import { emitKeypressEvents } from 'node:readline';
+import inquirerSelect, { Separator as InquirerSeparator } from '@inquirer/select';
+import inquirerSearch from '@inquirer/search';
+import { confirm as inquirerConfirm, input as inquirerInput } from '@inquirer/prompts';
+import { recordPromptCancelKey } from '../menu-navigation.js';
+export const promptCancelled = Symbol.for('wpmoo.prompt.cancelled');
+export function promptSeparator(label) {
+    return new InquirerSeparator(label);
+}
+function isPromptCancelError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    return ['AbortError', 'CancelPromptError', 'AbortPromptError', 'ExitPromptError'].includes(error.name);
+}
+function markPromptCancel(error) {
+    if (error instanceof Error && error.name === 'ExitPromptError' && /SIGINT/.test(error.message)) {
+        recordPromptCancelKey({ ctrl: true, name: 'c', sequence: '\u0003' });
+        return promptCancelled;
+    }
+    return promptCancelled;
+}
+function mapSearchChoice(choice) {
+    if (choice.name !== undefined || choice.description !== undefined || choice.short !== undefined) {
+        return {
+            value: choice.value,
+            name: choice.name,
+            description: choice.description,
+            short: choice.short,
+        };
+    }
+    return {
+        value: choice.value,
+        name: choice.label,
+        description: choice.hint,
+    };
+}
+function asInquirerSearchConfig(options) {
+    return {
+        message: options.message,
+        source: async (term, signal) => {
+            const choices = await options.source(term, signal);
+            return choices.map((choice) => mapSearchChoice(choice));
+        },
+        pageSize: options.pageSize,
+    };
+}
+function installEscapeAbortController(controller) {
+    emitKeypressEvents(process.stdin);
+    const listener = (_value, key) => {
+        if (key.name !== 'escape' && key.sequence !== '\u001B') {
+            return;
+        }
+        recordPromptCancelKey(key);
+        if (!controller.signal.aborted) {
+            controller.abort();
+        }
+    };
+    process.stdin.on('keypress', listener);
+    return () => process.stdin.off('keypress', listener);
+}
+async function withPromptCancelGuard(callback) {
+    const controller = new AbortController();
+    const removeEscapeListener = installEscapeAbortController(controller);
+    try {
+        return await callback({ signal: controller.signal });
+    }
+    catch (error) {
+        if (!isPromptCancelError(error)) {
+            throw error;
+        }
+        return markPromptCancel(error);
+    }
+    finally {
+        removeEscapeListener();
+    }
+}
+function isClackSelectOptions(options) {
+    return 'options' in options;
+}
+function asInquirerSelectConfig(options) {
+    return {
+        message: options.message,
+        choices: options.options.map((option) => ({
+            value: option.value,
+            name: option.label,
+            description: option.hint,
+        })),
+        default: options.initialValue,
+        pageSize: options.pageSize,
+        loop: options.loop,
+    };
+}
+function asInquirerConfirmConfig(options) {
+    const hasChoiceLabels = Boolean(options.active && options.inactive);
+    return {
+        message: hasChoiceLabels ? `${options.message} (${options.active}/${options.inactive})` : options.message,
+        default: options.initialValue,
+    };
+}
+function asInquirerInputConfig(options) {
+    return {
+        message: options.message,
+        default: options.defaultValue ?? options.initialValue,
+        validate: options.validate
+            ? (value) => {
+                const result = options.validate?.(value);
+                return result === undefined ? true : result;
+            }
+            : undefined,
+    };
+}
+export function isPromptCancel(value) {
+    return value === promptCancelled;
+}
+export async function selectPrompt(options) {
+    if (isClackSelectOptions(options)) {
+        return withPromptCancelGuard((context) => inquirerSelect(asInquirerSelectConfig(options), context));
+    }
+    return withPromptCancelGuard((context) => inquirerSelect(options, context));
+}
+export async function inputPrompt(options) {
+    return withPromptCancelGuard((context) => inquirerInput(asInquirerInputConfig(options), context));
+}
+export async function textPrompt(options) {
+    return inputPrompt(options);
+}
+export async function confirmPrompt(options) {
+    return withPromptCancelGuard((context) => inquirerConfirm(asInquirerConfirmConfig(options), context));
+}
+export async function searchPrompt(options) {
+    return withPromptCancelGuard((context) => inquirerSearch(asInquirerSearchConfig(options), context));
+}
+export function introPrompt(title) {
+    const rule = '-'.repeat(Math.min(80, Math.max(title.length, 3)));
+    console.log('');
+    console.log(title);
+    console.log(rule);
+}
+export function notePrompt(message, title = 'Note') {
+    const lines = message.split('\n');
+    console.log(`[${title}]`);
+    for (const line of lines) {
+        console.log(`  ${line}`);
+    }
+}
+export function outroPrompt(message) {
+    console.log(`Done: ${message}`);
+}

package/dist/templates.js

@@ -297,15 +297,10 @@ function applyBannerGradient(banner) {
 export function renderBanner() {
     const banner = String.raw `
 
-░██       ░██ ░█████████  ░███     ░███
-░██       ░██ ░██     ░██ ░████   ░████
-░██  ░██  ░██ ░██     ░██ ░██░██ ░██░██  ░███████   ░███████
-░██ ░████ ░██ ░█████████  ░██ ░████ ░██ ░██    ░██ ░██    ░██
-░██░██ ░██░██ ░██         ░██  ░██  ░██ ░██    ░██ ░██    ░██
-░████   ░████ ░██         ░██       ░██ ░██    ░██ ░██    ░██
-░███     ░███ ░██         ░██       ░██  ░███████   ░███████
-
-░░░░░░░░░ Workflow Platform - Micro Object Oriented ░░░░░░░░░
+╭────────────────────────────────────────────╮
+│ WPMoo                                      │
+│ Workflow Platform · Micro Object Oriented  │
+╰────────────────────────────────────────────╯
 `;
     return `${ANSI_BOLD}${applyBannerGradient(banner)}${ANSI_RESET}`;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wpmoo/odoo",
-  "version": "0.8.67",
-  "description": "WPMoo Odoo lifecycle tooling for development, staging, and production workflows.",
+  "version": "0.8.69",
+  "description": "WPMoo Tool for Odoo development, staging, and production lifecycle workflows.",
   "type": "module",
   "repository": {
     "type": "git",
@@ -47,8 +47,9 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@clack/prompts": "^0.11.0",
+    "@inquirer/prompts": "^8.4.3",
     "@inquirer/search": "^4.1.9",
+    "@inquirer/select": "^5.1.5",
     "execa": "^9.6.0"
   },
   "devDependencies": {