@wpmoo/odoo 0.8.52 → 0.8.53

package/README.md

@@ -30,14 +30,14 @@ files without touching product source code.
 - Node.js `>=20.17`
 - Git
 - Docker and Docker Compose for generated environment runtime commands
-- Optional: GitHub CLI (`gh`) for repository discovery, repository creation, and
-  deeper diagnostics
+- GitHub CLI (`gh`) is optional. Use it for repository discovery, repository
+  creation, and deeper diagnostics.
 
 The wizard currently offers Odoo `19.0`, `18.0`, `17.0`, and `16.0`. The copied
 Compose resource must include the matching `docker-compose_<version>.yml` file
 for the selected branch.
 
-Install GitHub CLI when you want WPMoo to discover your personal account and
+Set up GitHub CLI only when you want WPMoo to discover your personal account and
 organizations or create missing repositories from the interactive wizard:
 
 ```bash
@@ -54,11 +54,18 @@ npx @wpmoo/odoo
 ```
 
 If the current directory is not already a WPMoo environment, the CLI opens the
-create flow. It asks for the product slug, Odoo version, dev environment repo,
-source repo URLs, optional extra source repos, project-local Agent Skills, and
-empty repository initialization behavior.
+create flow. It asks for the product slug, Odoo version, and environment folder.
+Choose any environment folder; the default is `./<product>_dev`.
 
-For non-interactive usage:
+After folder selection, connect Git/GitHub to use repository URLs. Choose
+local-only setup to skip Git/GitHub connection and source repo prompts. Add
+source repositories later from the cockpit (`Repositories` -> `add-repo`) or
+`npx @wpmoo/odoo add-repo`.
+
+For non-interactive usage with repository URLs:
+
+Direct `create` commands keep the existing repo URL options; use
+`--target <path>` to choose a custom folder.
 
 ```bash
 npx @wpmoo/odoo create \
@@ -183,7 +190,8 @@ not search parent directories or run arbitrary script names.
 ## Generated Environment Layout
 
 A generated environment is a separate Git repository, usually named
-`<product>_dev`. Product source code stays in child source repositories.
+`<product>_dev`, but the wizard and `--target` can use any folder. Product
+source code stays in child source repositories.
 
 ```text
 odoo_sample_module_dev/
@@ -244,7 +252,8 @@ Compose commands.
 
 ## Repository and Module Management
 
-Add a source repository from the cockpit or direct command:
+Add a source repository after local-only setup from the cockpit or direct
+command:
 
 ```bash
 npx @wpmoo/odoo add-repo \
@@ -252,7 +261,8 @@ npx @wpmoo/odoo add-repo \
   --init-empty-repos
 ```
 
-When GitHub CLI is available and authenticated, the interactive flow can:
+GitHub CLI is optional for repository setup. When it is available and
+authenticated, the interactive flow can:
 
 - detect the owner or organization from the current environment;
 - suggest repository URLs;

package/dist/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { confirm, intro, isCancel, note, outro, select, text } from '@clack/prompts';
 import { realpathSync } from 'node:fs';
-import { resolve } from 'node:path';
+import { basename, resolve } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { commandFromArgs, defaultTargetForProduct, isHelpRequested, isVersionRequested, optionsFromArgs, parseArgs, stripInternalFlags, } from './args.js';
+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';
@@ -153,9 +153,27 @@ async function optionsFromPrompts(showIntro = true, cancelAction = 'exit') {
         placeholder: 'odoo_sample_module',
         validate: (value) => (value.trim() ? undefined : 'Enter a product/module slug.'),
     }), 'odoo_sample_module', cancelAction);
-    const target = defaultTargetForProduct(product);
-    note(renderRepositorySetupNote(product), 'Repository setup');
-    const selectedGitHubOwner = await selectDefaultGitHubOwner(cancelAction);
+    const defaultTarget = `./${product}_dev`;
+    const target = resolve(asString(await text({
+        message: 'Environment folder',
+        placeholder: defaultTarget,
+        defaultValue: defaultTarget,
+        initialValue: defaultTarget,
+    }), defaultTarget, cancelAction));
+    const connectGitHub = await select({
+        message: 'Connect this environment to Git/GitHub now?',
+        options: [
+            { value: true, label: 'Yes, connect Git/GitHub repositories' },
+            { value: false, label: 'No, scaffold local-only' },
+        ],
+        initialValue: true,
+    });
+    handleCancel(connectGitHub, cancelAction);
+    let selectedGitHubOwner;
+    if (connectGitHub) {
+        note(renderRepositorySetupNote(product), 'Repository setup');
+        selectedGitHubOwner = await selectDefaultGitHubOwner(cancelAction);
+    }
     const selectedVersion = await select({
         message: menuPromptMessage('Odoo version', cancelAction),
         options: supportedOdooVersions.map((version) => ({ value: version, label: version })),
@@ -163,6 +181,37 @@ async function optionsFromPrompts(showIntro = true, cancelAction = 'exit') {
     });
     handleCancel(selectedVersion, cancelAction);
     const odooVersion = String(selectedVersion);
+    async function promptInstallAgentSkills() {
+        const installAgentSkills = await select({
+            message: 'Install project-local Odoo Agent Skills?',
+            options: [
+                { value: true, label: 'Yes, install latest default skills' },
+                { value: false, label: 'No' },
+            ],
+            initialValue: false,
+        });
+        handleCancel(installAgentSkills, cancelAction);
+        return Boolean(installAgentSkills);
+    }
+    if (!connectGitHub) {
+        const installAgentSkills = await promptInstallAgentSkills();
+        return {
+            product,
+            odooVersion,
+            engine: 'compose',
+            devRepo: basename(target),
+            devRepoUrl: target,
+            sourceRepos: [],
+            target,
+            dryRun: false,
+            initEmptyRepos: false,
+            stage: false,
+            agentSkillsTemplateUrl: installAgentSkills ? defaultAgentSkillsTemplateUrl : undefined,
+            createMissingRepos: false,
+            repoVisibility: 'private',
+            skipSubmodules: true,
+        };
+    }
     const detectedDevRepoUrl = await getOriginUrl(realGit, target);
     const defaultDevRepoUrl = selectedGitHubOwner
         ? githubRepositoryUrl(selectedGitHubOwner, `${product}_dev`)
@@ -204,15 +253,7 @@ async function optionsFromPrompts(showIntro = true, cancelAction = 'exit') {
         handleCancel(shouldAddAnother, cancelAction);
         addAnother = Boolean(shouldAddAnother);
     }
-    const installAgentSkills = await select({
-        message: 'Install project-local Odoo Agent Skills?',
-        options: [
-            { value: true, label: 'Yes, install latest default skills' },
-            { value: false, label: 'No' },
-        ],
-        initialValue: false,
-    });
-    handleCancel(installAgentSkills, cancelAction);
+    const installAgentSkills = await promptInstallAgentSkills();
     const initEmpty = await select({
         message: 'Initialize repositories that exist but have no commits?',
         options: [
@@ -477,6 +518,9 @@ async function ensureGitHubRepositories(options, interactive) {
     if (options.dryRun) {
         return;
     }
+    if (options.skipSubmodules) {
+        return;
+    }
     if (!interactive && !options.createMissingRepos) {
         return;
     }

package/dist/help.js

@@ -5,7 +5,7 @@ WPMoo Odoo lifecycle tooling.
 
 Usage:
   npx @wpmoo/odoo
-  npx @wpmoo/odoo create --product <slug> --dev-repo-url <url> --source-repo-url <url>
+  npx @wpmoo/odoo create --product <slug> [--target <path>] --dev-repo-url <url> --source-repo-url <url>
   npx @wpmoo/odoo status
   npx @wpmoo/odoo add-repo --repo-url <url>
   npx @wpmoo/odoo remove-repo --repo <name>
@@ -31,7 +31,7 @@ Usage:
 Options:
   --product <slug>             Product slug, for example my_odoo_module.
   --odoo-version <branch>      Odoo branch to pin submodules to. Default: 19.0.
-  --dev-repo-url <url>         Development environment repository URL for docs.
+  --dev-repo-url <url>         Optional development environment repository URL for docs.
   --target <path>              Target dev repo directory. Default: ./<product>_dev.
   --engine <value>             Environment engine: compose. Default: compose.
   --compose-template-url <url> Standalone compose resource source. Default: gh:wpmoo-org/odoo-docker-compose.
@@ -73,13 +73,22 @@ Cockpit:
   diagnostics, repositories, and maintenance categories.
   Direct commands such as npx @wpmoo/odoo status and npx @wpmoo/odoo test remain available.
 
+Wizard local-only path:
+  Run npx @wpmoo/odoo from a workspace directory to open the create wizard.
+  Choose any environment folder; the default is ./<product>_dev.
+  Skip Git/GitHub connection to create a local-only environment.
+  Add source repos later from the cockpit or with add-repo.
+
 Status and doctor:
   status: fast and offline. Reads local environment metadata and files only.
   doctor: deeper health check. May check Docker CLI access and GitHub workflows.
 
 Task recipes:
   Create environment:
+    npx @wpmoo/odoo
     npx @wpmoo/odoo create --product <slug> --dev-repo-url <url> --source-repo-url <url>
+  Create local-only environment:
+    npx @wpmoo/odoo
   Add source repo:
     npx @wpmoo/odoo add-repo --repo-url <url>
   Add module:
@@ -100,6 +109,7 @@ Example:
   npx @wpmoo/odoo create \\
     --product odoo_sample_module \\
     --odoo-version 19.0 \\
+    --target ./custom_odoo_dev \\
     --dev-repo-url https://github.com/example-org/odoo_sample_module_dev.git \\
     --source-repo-url https://github.com/example-org/odoo_sample_module.git
 

package/dist/templates.js

@@ -17,7 +17,13 @@ function yamlList(items) {
 function allAddons(options) {
     return options.sourceRepos.flatMap((repo) => repo.addons);
 }
+function hasSourceRepos(options) {
+    return options.sourceRepos.length > 0;
+}
 function repositoryLayout(options) {
+    const sourceRepoRows = hasSourceRepos(options)
+        ? options.sourceRepos.map((repo) => `│               ├── ${repo.path}/`).join('\n')
+        : '│               └── README.md';
     return `${options.devRepo}/
 ├── docker-compose_17.0.yml
 ├── docker-compose_18.0.yml
@@ -29,12 +35,17 @@ function repositoryLayout(options) {
 │   └── custom/
 │       └── src/
 │           └── private/
-${options.sourceRepos.map((repo) => `│               ├── ${repo.path}/`).join('\n')}
+${sourceRepoRows}
 ├── docs/
 ├── README.md
 └── AGENTS.md`;
 }
 function sourceRepoDocs(options) {
+    if (!hasSourceRepos(options)) {
+        return `This environment was scaffolded without source repository submodules.
+Add source repositories later from the cockpit or with \`npx @wpmoo/odoo add-repo\`.
+They will be added under \`odoo/custom/src/private\`.`;
+    }
     return options.sourceRepos
         .map((repo) => `### ${repo.path}
 
@@ -58,6 +69,35 @@ ${repo.addons.map((addon) => `├── ${addon}/`).join('\n')}
 \`\`\``)
         .join('\n\n');
 }
+function cloneDocs(options) {
+    if (!hasSourceRepos(options)) {
+        return `## Local Folder
+
+This environment is ready in this folder:
+
+\`\`\`bash
+cd ${options.devRepo}
+\`\`\`
+
+If you later connect it to Git, commit the generated files after reviewing them.
+`;
+    }
+    return `## Clone
+
+Clone with submodules:
+
+\`\`\`bash
+git clone --recurse-submodules ${options.devRepoUrl}
+cd ${options.devRepo}
+\`\`\`
+
+If already cloned:
+
+\`\`\`bash
+git submodule update --init --recursive
+\`\`\`
+`;
+}
 function optionalAgentSkillsReadme(options) {
     if (!options.agentSkillsTemplateUrl)
         return '';
@@ -118,9 +158,9 @@ 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\`.
+Source repositories stay under \`odoo/custom/src/private\` when configured. At
+container startup, \`entrypoint.sh\` scans those repositories for addons and
+exposes them through \`/mnt/wpmoo-addons\`.
 
 ## Daily Command Hub (\`./moo\`)
 
@@ -487,8 +527,9 @@ export function renderReadme(options) {
 
 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\`.
+This folder owns the development environment only. Product source code lives
+in source repository submodules under \`odoo/custom/src/private\` when source
+repositories are connected.
 
 ## Repository Layout
 
@@ -496,20 +537,7 @@ in source repository submodules under \`odoo/custom/src/private\`.
 ${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
-\`\`\`
+${cloneDocs(options)}
 
 ## WPMoo CLI Shortcut
 
@@ -535,23 +563,34 @@ ${sourceRepoDocs(options)}
 ${environmentUsageDocs(options)}
 ## Branching
 
-Use Odoo major-version branches in source repositories:
+Use Odoo major-version branches in source repositories when you add them:
 
 \`\`\`text
 ${options.odooVersion}
 \`\`\`
 
-This dev repository can stay on \`main\` and pin exact source commits through
-submodule references.
+If this environment is connected to Git, the 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');
+    const repoList = hasSourceRepos(options)
+        ? options.sourceRepos.map((repo) => `- \`${repo.path}\`: \`${repo.url}\``).join('\n')
+        : '- No source repositories are configured yet.';
+    const sourceLayout = hasSourceRepos(options)
+        ? `Product repositories are Git submodules:
+
+\`\`\`text
+${options.sourceRepos.map((repo) => `odoo/custom/src/private/${repo.path}`).join('\n')}
+\`\`\`
+
+${repoDuplicationNote()}`
+        : 'No source repositories are configured yet. Use `./moo add-repo` or the cockpit Repositories menu before module-specific work.';
+    const addonList = hasSourceRepos(options)
+        ? options.sourceRepos
+            .map((repo) => `\`${repo.path}\` addons:\n${repo.addons.map((addon) => `- \`${addon}\``).join('\n')}`)
+            .join('\n\n')
+        : 'No addon boundaries are known yet. Add source repositories before module-specific implementation.';
     return `# AGENTS.md
 
 ## Project
@@ -565,13 +604,7 @@ ${repoList}
 
 ## Source Layout
 
-Product repositories are Git submodules:
-
-\`\`\`text
-${options.sourceRepos.map((repo) => `odoo/custom/src/private/${repo.path}`).join('\n')}
-\`\`\`
-
-${repoDuplicationNote()}
+${sourceLayout}
 ${optionalAgentSkillsAgentsSection(options)}
 ## Addon Boundaries
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wpmoo/odoo",
-  "version": "0.8.52",
+  "version": "0.8.53",
   "description": "WPMoo Odoo lifecycle tooling for development, staging, and production workflows.",
   "type": "module",
   "repository": {