create-odoo-module 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+All notable changes to `create-odoo-module` are documented here.
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+Versioning follows [Semantic Versioning](https://semver.org/).
+
+---
+
+## [1.0.0] — 2026-06-20
+
+### Added
+- **Core CLI** with `commander.js` — argument parsing, subcommands (`list`, `upgrade`)
+- **Interactive mode** via `inquirer.js` — guided setup when no flags given
+- **Odoo module generator** — produces complete Python module:
+  - `__manifest__.py` with correct version format (`17.0.1.0.0`)
+  - `models/` — full model with state machine, constraints, computed fields, sequence
+  - `security/` — CSV access rules + XML security groups
+  - `data/` — auto-sequence record
+  - `static/` — JS + SCSS placeholders
+  - `i18n/` — `.pot` translation template
+  - `tests/` — 10 pytest tests covering full lifecycle (with `--with-tests`)
+  - `wizard/` — transient model bulk-action dialog (with `--with-wizard`)
+  - `report/` — QWeb PDF report + template (with `--with-reports`)
+  - OWL component with `@odoo/owl` (with `--with-owl`)
+- **REST API generator** — full CRUD controller:
+  - `GET /api/{module}` with pagination, search, filter
+  - `GET /api/{module}/:id`
+  - `POST /api/{module}` (create)
+  - `PUT /api/{module}/:id` (update)
+  - `DELETE /api/{module}/:id` (delete, state-guarded)
+  - `POST /api/{module}/:id/action` (business methods)
+  - `GET /api/{module}/stats` (aggregate by state)
+  - Standardised `{status, data, meta}` JSON responses
+- **UI/Views generator** — full XML views suite:
+  - Search view with filters, separators, Group By options
+  - Form view with statusbar, ribbon, chatter, priority stars
+  - List view with decoration rules, inline action buttons
+  - Kanban view with `many2one_avatar_user`
+  - Activity view
+  - `ir.actions.act_window` wiring all views
+  - Top-level + sub-menus with icon
+- **Flutter app generator** — production-ready Dart app:
+  - `pubspec.yaml` — `odoo_rpc`, `flutter_riverpod`, `go_router`, `flutter_secure_storage`
+  - `OdooConfig` — server URL + DB constants
+  - `OdooJsonRpcClient` — typed `callKw` wrapper with typed exceptions
+  - `AuthService` — login / logout with `SharedPreferences`
+  - Typed `{Module}Record` — `fromMap`, `toMap`, `copyWith`, computed getters
+  - `{Module}Repository` — full CRUD + business action calls
+  - Riverpod `AsyncNotifier` with pagination, refresh, loadMore
+  - 4 screens: Login, List (search + pull-to-refresh), Detail (actions), Create
+  - `StateBadge`, `LoadingOverlay`, `{Module}Card` widgets
+  - Unit tests for Dart model
+  - Integration test scaffold
+- **Deploy generator**:
+  - `deploy.sh` (Linux/macOS) — file copy + XML-RPC install/upgrade
+  - `deploy.ps1` (Windows PowerShell) — equivalent
+  - `docker-compose.yml` — Odoo + PostgreSQL local dev stack
+  - `odoo.conf` — Odoo config for Docker
+  - GitHub Actions CI pipeline (with `--with-ci`)
+- **Module name validator** — reserved names, length, pattern
+- **String utilities** — `toSnakeCase`, `toPascalCase`, `toKebabCase`, `toOdooModel`
+- **Pro license verification** — API-based, cached 24h, fail-open
+- **Update notifier** — alerts when a newer version is available
+- **Coloured banner** — gradient ASCII art via `gradient-string` + `boxen`
+- **Jest test suite** — 40+ tests across CLI, generators, string utils
+- **ESLint** config
+- Supports **Odoo 16, 17, 18**
+
+---
+
+## [Unreleased]
+
+### Planned for v1.1.0
+- `upgrade` command — update existing generated projects to newer templates
+- Pro template: `fleet` — Fleet Management
+- Pro template: `hr` — Human Resources
+- Pro template: `inventory` — Inventory + barcode
+- Pro template: `pos` — Point of Sale
+- Pro template: `crm` — CRM Pipeline with OWL dashboard
+- `--with-graphql` flag — GraphQL endpoint via Strawberry
+- Supabase / PostgreSQL direct integration option
+- Windows CI runner in GitHub Actions

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 create-odoo-module contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,309 @@
+# create-odoo-module
+
+> **Next.js for Odoo. One command. Full-stack ERP + Flutter app in seconds.**
+
+[![npm version](https://img.shields.io/npm/v/create-odoo-module?color=%23875A7B)](https://www.npmjs.com/package/create-odoo-module)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+```bash
+npx create-odoo-module my-module --with-api --with-ui
+```
+
+One command generates a **full Odoo Python module** + **REST API** + **Flutter mobile app**, wired together and ready to deploy — in under 30 seconds.
+
+---
+
+## Table of Contents
+
+- [Why?](#why)
+- [Quick Start](#quick-start)
+- [Options & Flags](#options--flags)
+- [What Gets Generated?](#what-gets-generated)
+- [Examples](#examples)
+- [Pro Templates](#pro-templates)
+- [Requirements](#requirements)
+- [Publish to npm](#publish-to-npm)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Why?
+
+Setting up an Odoo module from scratch takes:
+
+| Task                         | Without tool | With create-odoo-module |
+|------------------------------|:------------:|:-----------------------:|
+| Python venv + dependencies   | ~30 min      | **0 min**               |
+| `__manifest__.py` setup      | ~20 min      | **instant**             |
+| Model + Views + Menus        | ~90 min      | **instant**             |
+| REST API controller          | ~120 min     | **instant**             |
+| Flutter app wired to Odoo    | ~480 min     | **instant**             |
+| Deploy scripts               | ~60 min      | **instant**             |
+| **Total**                    | **~8 hours** | **< 30 seconds**        |
+
+---
+
+## Quick Start
+
+### Interactive mode (recommended for new users)
+
+```bash
+npx create-odoo-module
+```
+
+Answers a few questions, generates everything.
+
+### Fully non-interactive
+
+```bash
+npx create-odoo-module fleet-manager \
+  --with-api \
+  --with-ui \
+  --with-tests \
+  --with-reports \
+  --odoo-version 17 \
+  --author "Acme Corp" \
+  --no-interactive
+```
+
+### After generation
+
+```bash
+cd fleet-manager
+cp .env.example .env           # Fill in Odoo URL, DB, credentials
+npm run dev                    # Start local Odoo via Docker Compose
+npm run deploy                 # Upload & install module in Odoo
+npm run flutter:run            # Launch Flutter app
+```
+
+---
+
+## Options & Flags
+
+```
+Arguments:
+  [module-name]            Name of your Odoo module (e.g. fleet-manager)
+
+Options:
+  --with-api               Include REST API controllers (GET/POST/PUT/DELETE)
+  --with-ui                Include Flutter mobile app (login + CRUD screens)
+  --with-tests             Include Python pytest + Dart flutter_test files
+  --with-reports           Include QWeb PDF report template
+  --with-owl               Include OWL JavaScript components
+  --with-wizard            Include wizard (transient model dialog)
+  --with-docker            Include Docker Compose dev environment (default: true)
+  --with-ci                Include GitHub Actions CI/CD pipeline
+  --odoo-version <ver>     Target Odoo version: 16 | 17 | 18  (default: 17)
+  --template <name>        Use a Pro template: fleet | hr | inventory | pos | crm
+  --pro-key <key>          Pro license key for premium templates
+  --author <name>          Module author / company name (default: "Your Company")
+  --website <url>          Author website
+  --category <cat>         Odoo app category (default: "Custom")
+  --depends <modules>      Extra Odoo depends, comma-separated (e.g. "sale,account")
+  --no-interactive         Skip all interactive prompts (use flags only)
+  --no-git                 Skip git init in generated project
+  --verbose                Show verbose output
+  -v, --version            Output current version
+  -h, --help               Display help
+```
+
+### Subcommands
+
+```bash
+npx create-odoo-module list           # List all Pro templates
+npx create-odoo-module upgrade <path> # Upgrade existing project (v1.1.0+)
+```
+
+---
+
+## What Gets Generated?
+
+Running:
+
+```bash
+npx create-odoo-module fleet-manager --with-api --with-ui --with-tests
+```
+
+Produces:
+
+```
+fleet-manager/
+│
+├── 📁 odoo_module/                    ← Full Odoo Python module
+│   ├── __init__.py
+│   ├── __manifest__.py                ← Auto-configured manifest
+│   ├── models/
+│   │   └── fleet_manager.py           ← Full model: fields, states, CRUD, constraints
+│   ├── views/
+│   │   ├── fleet_manager_views.xml    ← Form + List + Kanban + Activity + Search
+│   │   └── fleet_manager_menus.xml    ← Top-level + sub-menus
+│   ├── controllers/
+│   │   └── fleet_manager_controller.py ← REST API: GET/POST/PUT/DELETE + stats
+│   ├── security/
+│   │   ├── ir.model.access.csv        ← ACL rules
+│   │   └── fleet_manager_security.xml ← Groups
+│   ├── data/
+│   │   └── fleet_manager_data.xml     ← Sequence
+│   ├── report/                        ← QWeb PDF (with --with-reports)
+│   ├── wizard/                        ← Bulk action wizard (with --with-wizard)
+│   ├── tests/                         ← pytest suite (with --with-tests)
+│   ├── static/src/
+│   │   ├── js/fleet_manager.js        ← OWL component (with --with-owl)
+│   │   └── scss/fleet_manager.scss
+│   └── i18n/fleet_manager.pot
+│
+├── 📁 flutter_app/                    ← Flutter app (with --with-ui)
+│   ├── lib/
+│   │   ├── main.dart                  ← Entry point + Material 3 theme
+│   │   └── src/
+│   │       ├── config/odoo_config.dart
+│   │       ├── core/                  ← JSON-RPC client + auth service + exceptions
+│   │       ├── models/                ← Typed Dart model with fromMap / toMap
+│   │       ├── repositories/          ← CRUD data layer + Riverpod providers
+│   │       ├── screens/               ← Login + List + Detail + Create screens
+│   │       └── widgets/               ← Card + StateBadge + LoadingOverlay
+│   └── test/                          ← Flutter unit tests
+│
+├── 📁 scripts/
+│   ├── deploy.sh                      ← Linux/macOS deploy via xmlrpc
+│   ├── deploy.ps1                     ← Windows PowerShell deploy
+│   ├── docker-compose.yml             ← Odoo + PostgreSQL dev stack
+│   └── odoo.conf                      ← Odoo config for Docker
+│
+├── .env.example                       ← Environment variable template
+├── .gitignore
+├── package.json                       ← npm scripts: deploy, dev, flutter:*
+└── README.md
+```
+
+### Generated Model features
+
+- `name`, `reference` (auto-sequence), `description`, `active`, `color`
+- `state` with full state machine: draft → confirmed → in_progress → done | cancelled
+- `user_id`, `company_id`, `tag_ids` relational fields
+- `date_start`, `date_end`, `duration_days` (computed)
+- `priority` (stars widget)
+- `@api.constrains` date validation
+- `_sql_constraints` unique reference
+- `mail.thread` + `mail.activity.mixin` (chatter)
+- Business methods: `action_confirm`, `action_start`, `action_done`, `action_cancel`, `action_reset_draft`
+
+### Generated REST API endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET`  | `/api/{module}` | List records (pagination, search, filter) |
+| `GET`  | `/api/{module}/:id` | Get single record |
+| `POST` | `/api/{module}` | Create record |
+| `PUT`  | `/api/{module}/:id` | Update record |
+| `DELETE` | `/api/{module}/:id` | Delete record |
+| `POST` | `/api/{module}/:id/action` | Call business action |
+| `GET`  | `/api/{module}/stats` | Aggregate stats by state |
+
+All endpoints return standardised JSON: `{ status: "success"|"error", data: ..., meta: ... }`.
+
+---
+
+## Examples
+
+```bash
+# Basic module (no API, no Flutter)
+npx create-odoo-module hospital-records
+
+# Full stack: Odoo 18 + REST API + Flutter
+npx create-odoo-module patient-manager --with-api --with-ui --odoo-version 18
+
+# With tests + reports + OWL components
+npx create-odoo-module maintenance-tracker \
+  --with-api --with-tests --with-reports --with-owl
+
+# Extra Odoo dependencies
+npx create-odoo-module pos-extension \
+  --depends "point_of_sale,account" \
+  --odoo-version 17
+
+# CI/CD pipeline included
+npx create-odoo-module my-module --with-ci --with-tests
+```
+
+---
+
+## Pro Templates
+
+Premium pre-built templates for common industry scenarios:
+
+| Template | Description | Includes |
+|----------|-------------|----------|
+| `fleet`  | Fleet Management | Vehicle tracking, maintenance, fuel logs |
+| `hr`     | Human Resources | Employees, contracts, payroll |
+| `inventory` | Inventory | Products, lots, barcode scanner |
+| `pos`    | Point of Sale | POS extension, custom payments |
+| `crm`    | CRM Pipeline | Leads, pipeline, OWL dashboard |
+
+```bash
+# List templates
+npx create-odoo-module list
+
+# Use a Pro template
+npx create-odoo-module my-fleet --template fleet --pro-key YOUR_KEY
+```
+
+**Get Pro access:** https://create-odoo-module.dev/pro ($19/month)
+
+---
+
+## Requirements
+
+| Requirement | Version | Notes |
+|-------------|---------|-------|
+| **Node.js** | ≥ 18    | Required to run the CLI |
+| **Docker**  | Any     | Optional — for local Odoo via Docker Compose |
+| **Flutter SDK** | ≥ 3.19 | Required only with `--with-ui` |
+| **Git**     | Any     | Optional — for git init in generated project |
+
+No Python required on your machine — Python code is deployed to Odoo server.
+
+---
+
+## Publish to npm
+
+```bash
+# 1. Login to npm
+npm login
+
+# 2. Dry run to verify what will be published
+npm pack --dry-run
+
+# 3. Publish
+npm publish --access public
+
+# 4. Verify
+npx create-odoo-module --version
+```
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/Brah-Timo/create-odoo-module.git
+cd create-odoo-module
+npm install
+npm test
+npm link   # Use locally: npx create-odoo-module
+```
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+<p align="center">
+  Made with ♥ for the Odoo developer community<br>
+  <a href="https://create-odoo-module.dev">create-odoo-module.dev</a>
+</p>

package/bin/create-odoo-module.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+'use strict';
+
+// ─── Node version check ───────────────────────────────────────────────────────
+const [major] = process.versions.node.split('.').map(Number);
+if (major < 18) {
+  console.error(
+    `\n  ✗  create-odoo-module requires Node.js 18 or higher.\n` +
+    `     Current version: ${process.version}\n` +
+    `     Download: https://nodejs.org\n`
+  );
+  process.exit(1);
+}
+
+// ─── Imports ─────────────────────────────────────────────────────────────────
+const { Command } = require('commander');
+const chalk       = require('chalk');
+const gradient    = require('gradient-string');
+const boxen       = require('boxen');
+const { updateNotifier } = require('update-notifier');
+const pkg         = require('../package.json');
+const { runCLI }  = require('../src/cli/index');
+
+// ─── Update notifier (non-blocking) ─────────────────────────────────────────
+try {
+  const notifier = updateNotifier({ pkg, updateCheckInterval: 1000 * 60 * 60 * 24 });
+  if (notifier.update) {
+    console.log(
+      boxen(
+        chalk.yellow('Update available!') +
+        `  ${chalk.dim(pkg.version)} → ${chalk.green(notifier.update.latest)}\n` +
+        chalk.cyan(`npm install -g ${pkg.name}@latest`),
+        { padding: 1, margin: 1, borderStyle: 'round', borderColor: 'yellow' }
+      )
+    );
+  }
+} catch (_) { /* update-notifier is optional */ }
+
+// ─── Banner ───────────────────────────────────────────────────────────────────
+const banner = gradient(['#875A7B', '#00A09D'])(
+  `
+  ██████╗██████╗ ███████╗ █████╗ ████████╗███████╗
+ ██╔════╝██╔══██╗██╔════╝██╔══██╗╚══██╔══╝██╔════╝
+ ██║     ██████╔╝█████╗  ███████║   ██║   █████╗
+ ██║     ██╔══██╗██╔══╝  ██╔══██║   ██║   ██╔══╝
+ ╚██████╗██║  ██║███████╗██║  ██║   ██║   ███████╗
+  ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝`
+);
+
+console.log(banner);
+console.log(
+  boxen(
+    chalk.bold.white('create-odoo-module') +
+    chalk.dim(` v${pkg.version}`) + '\n' +
+    chalk.cyan('Next.js for Odoo') +
+    chalk.dim(' — One command. Full-stack ERP + Flutter app.'),
+    {
+      padding: { top: 0, bottom: 0, left: 2, right: 2 },
+      margin: { top: 0, bottom: 1, left: 0, right: 0 },
+      borderStyle: 'round',
+      borderColor: '#875A7B',
+      textAlignment: 'center'
+    }
+  )
+);
+
+// ─── CLI Program ──────────────────────────────────────────────────────────────
+const program = new Command();
+
+program
+  .name('create-odoo-module')
+  .description('Generate a full Odoo module + Flutter app in seconds')
+  .version(pkg.version, '-v, --version', 'Output the current version')
+  .helpOption('-h, --help', 'Display help for command');
+
+// ─── Main command: create ─────────────────────────────────────────────────────
+program
+  .argument('[module-name]', 'Name of your Odoo module (e.g. fleet-manager)')
+  .option('--with-api',            'Include REST API controllers',            false)
+  .option('--with-ui',             'Include Flutter mobile app',              false)
+  .option('--with-tests',          'Include Python + Dart test files',        false)
+  .option('--with-reports',        'Include QWeb PDF reports',                false)
+  .option('--with-owl',            'Include OWL JavaScript components',       false)
+  .option('--with-wizard',         'Include wizard (transient model)',        false)
+  .option('--with-docker',         'Include Docker Compose dev environment',  true)
+  .option('--with-ci',             'Include GitHub Actions CI/CD pipeline',   false)
+  .option('--odoo-version <ver>',  'Target Odoo version (16 | 17 | 18)',      '17')
+  .option('--template <name>',     'Use a Pro template (fleet/hr/inventory/pos/crm)')
+  .option('--pro-key <key>',       'Pro license key for premium templates')
+  .option('--author <name>',       'Module author name',                      'Your Company')
+  .option('--website <url>',       'Author website',                          'https://yourcompany.com')
+  .option('--category <cat>',      'Odoo app category',                       'Custom')
+  .option('--depends <modules>',   'Extra Odoo depends (comma separated)',    '')
+  .option('--no-interactive',      'Skip all interactive prompts (use flags only)')
+  .option('--no-git',              'Skip git init in generated project')
+  .option('--verbose',             'Show verbose output',                     false)
+  .addHelpText('after', `
+${chalk.bold('Examples:')}
+  ${chalk.cyan('$ npx create-odoo-module')}
+  ${chalk.cyan('$ npx create-odoo-module fleet-manager')}
+  ${chalk.cyan('$ npx create-odoo-module fleet-manager --with-api --with-ui')}
+  ${chalk.cyan('$ npx create-odoo-module hospital --with-api --with-ui --with-tests --odoo-version 18')}
+  ${chalk.cyan('$ npx create-odoo-module pos-extend --template pos --pro-key YOUR_KEY')}
+
+${chalk.bold('Pro Templates:')}
+  ${chalk.yellow('fleet')}      Fleet Management with vehicle tracking
+  ${chalk.yellow('hr')}         Human Resources with payroll
+  ${chalk.yellow('inventory')}  Inventory with barcode scanner
+  ${chalk.yellow('pos')}        Point of Sale extension
+  ${chalk.yellow('crm')}        CRM with pipeline dashboard
+
+${chalk.bold('Documentation:')}
+  ${chalk.underline('https://create-odoo-module.dev/docs')}
+  `)
+  .action(async (moduleName, options) => {
+    try {
+      await runCLI(moduleName, options);
+    } catch (err) {
+      if (options.verbose) {
+        console.error(chalk.red('\n✗ Fatal error:'), err);
+      } else {
+        console.error(chalk.red(`\n✗ ${err.message}`));
+        console.error(chalk.dim('  Run with --verbose for full error details'));
+      }
+      process.exit(1);
+    }
+  });
+
+// ─── list command ─────────────────────────────────────────────────────────────
+program
+  .command('list')
+  .description('List all available Pro templates')
+  .action(() => {
+    const { listTemplates } = require('../src/cli/index');
+    listTemplates();
+  });
+
+// ─── upgrade command ──────────────────────────────────────────────────────────
+program
+  .command('upgrade <module-path>')
+  .description('Upgrade an existing create-odoo-module project')
+  .action(async (modulePath) => {
+    console.log(chalk.yellow(`\n⚠  upgrade command coming in v1.1.0\n`));
+  });
+
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "create-odoo-module",
+  "version": "1.0.0",
+  "description": "Next.js for Odoo. One command. Full-stack ERP + Flutter app in seconds.",
+  "bin": {
+  "create-odoo-module": "bin/create-odoo-module.js"
+  },
+  "main": "./src/cli/index.js",
+  "keywords": [
+    "odoo",
+    "flutter",
+    "dart",
+    "cli",
+    "scaffold",
+    "generator",
+    "erp",
+    "module",
+    "create",
+    "boilerplate",
+    "odoo-module",
+    "odoo-generator",
+    "odoo-scaffold",
+    "odoo-flutter",
+    "odoo-rest-api"
+  ],
+  "author": "create-odoo-module <contact@create-odoo-module.dev>",
+  "license": "MIT",
+  "homepage": "https://create-odoo-module.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Brah-Timo/create-odoo-module.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Brah-Timo/create-odoo-module/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "axios": "^1.6.0",
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "commander": "^12.0.0",
+    "ejs": "^3.1.9",
+    "execa": "^8.0.1",
+    "figures": "^3.2.0",
+    "fs-extra": "^11.2.0",
+    "gradient-string": "^2.0.2",
+    "inquirer": "^9.2.0",
+    "ora": "^5.4.1",
+    "semver": "^7.6.0",
+    "update-notifier": "^5.1.0",
+    "validate-npm-package-name": "^5.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "eslint": "^8.57.0",
+    "jest": "^29.7.0"
+  },
+  "scripts": {
+    "test": "jest --coverage",
+    "test:watch": "jest --watch",
+    "lint": "eslint src/ bin/ --fix",
+    "prepublishOnly": "npm test",
+    "link": "npm link",
+    "start": "node bin/create-odoo-module.js"
+  },
+  "jest": {
+    "testEnvironment": "node",
+    "testMatch": [
+      "**/tests/**/*.test.js"
+    ],
+    "collectCoverageFrom": [
+      "src/**/*.js"
+    ]
+  }
+}

package/src/cli/args-parser.js

@@ -0,0 +1,36 @@
+'use strict';
+
+/**
+ * Parse a comma-separated list of extra Odoo depends
+ * e.g. "sale_management,account" → ['sale_management', 'account']
+ */
+function parseExtraDepends(dependsString) {
+  if (!dependsString) return [];
+  return dependsString
+    .split(',')
+    .map(d => d.trim())
+    .filter(d => d.length > 0 && /^[a-z][a-z0-9_]*$/.test(d));
+}
+
+/**
+ * Parse Odoo version string, normalise to '16'|'17'|'18'
+ */
+function parseOdooVersion(version) {
+  if (!version) return '17';
+  const str = String(version);
+  if (str.startsWith('16')) return '16';
+  if (str.startsWith('17')) return '17';
+  if (str.startsWith('18')) return '18';
+  return '17'; // fallback
+}
+
+/**
+ * Parse a boolean flag that may come as string 'true'/'false'
+ */
+function parseBool(value, defaultVal = false) {
+  if (value === true || value === 'true')  return true;
+  if (value === false || value === 'false') return false;
+  return defaultVal;
+}
+
+module.exports = { parseExtraDepends, parseOdooVersion, parseBool };