@bergetai/odoo-cli 0.12.4 → 0.12.7

package/README.md

@@ -46,6 +46,8 @@ odoo models fields res.partner --filter "^email" --json
 odoo models fields crm.lead --custom              # only x_* custom fields
 odoo models read res.partner --ids 51,52 --fields name,city
 odoo models read crm.lead --search "microsoft" --json  # ilike on name (max 100)
+odoo models search mail.activity --domain '[["user_id","=",39],["date_deadline","<=","2026-09-25"]]' --json
+odoo models search mail.activity --filter user_id=39 --fields res_id,summary,date_deadline --json
 
 # List and inspect records
 odoo crm leads list --open --limit 20
@@ -68,6 +70,9 @@ odoo sales orders update 11515 --set plan_id=2 --dry-run
 odoo sales lines add 11515 --lines extra.json
 odoo sales lines update 11818 --lines fix.json
 odoo sales plans list
+odoo sales plans pricing list --pricelist "SEK price list"   # recurring prices (sale.subscription.pricing)
+odoo sales plans pricing create --pricelist 11 --product 188 --plan Yearly --price 19800 --dry-run
+odoo sales plans pricing update 131 --price 19800 --dry-run
 odoo sales invoices precedent --product 188        # invoicing currency history
 odoo sales pdf 11515 --out ./quotation.pdf
 
@@ -155,7 +160,7 @@ Note: `odoo --version` prints the CLI's own version; `odoo version` queries the
 
 ## Features
 
-- Sales surface (`sales`) — quotations and sales orders (`sale.order`) without the raw XML-RPC plumbing: `orders list` (curated columns incl. pricelist/currency, `--partner`/`--state` filters plus `--filter`/`--domain`), `orders read` (full header, partner with VAT/address, and the order lines with sections/notes), `orders create` (first-class flags for `--partner`/`--pricelist`/`--payment-terms`/`--validity`/`--opportunity`/`--salesperson`/`--plan`/`--note`, order lines as a JSON array via `--lines <file>`/`-` supporting `line_section`/`line_note` lines and product lines with `tax_ids`; missing line name/price default from the product), `orders update` (header-only `--set` with an allowlist — setting `state` is refused by design: confirm/cancel is a human step in the Odoo UI), `lines add`/`lines update` (same JSON line format), `plans list` (`sale.subscription.plan`), `invoices precedent --product` (posted customer-invoice lines for a product, newest first — invoicing currency precedent), and `pdf <id> --out <path>` (portal quotation PDF via the order's `access_token`, verified `%PDF` magic). **Sending quotations is deliberately not implemented** — it is done by a human via 'Send by Email' in the Odoo UI (gives the customer Accept & Sign), CLI policy 2026-09-24
+- Sales surface (`sales`) — quotations and sales orders (`sale.order`) without the raw XML-RPC plumbing: `orders list` (curated columns incl. pricelist/currency, `--partner`/`--state` filters plus `--filter`/`--domain`), `orders read` (full header, partner with VAT/address, and the order lines with sections/notes), `orders create` (first-class flags for `--partner`/`--pricelist`/`--payment-terms`/`--validity`/`--opportunity`/`--salesperson`/`--plan`/`--note`, order lines as a JSON array via `--lines <file>`/`-` supporting `line_section`/`line_note` lines and product lines with `tax_ids`; missing line name/price default from the product), `orders update` (header-only `--set` with an allowlist — setting `state` is refused by design: confirm/cancel is a human step in the Odoo UI), `lines add`/`lines update` (same JSON line format), `plans list` (`sale.subscription.plan`), `plans pricing list`/`create`/`update` (recurring prices, `sale.subscription.pricing` — one rule per pricelist+product+plan; subscription order lines price from these rules, not from `product.pricelist.item`), `invoices precedent --product` (posted customer-invoice lines for a product, newest first — invoicing currency precedent), and `pdf <id> --out <path>` (portal quotation PDF via the order's `access_token`, verified `%PDF` magic). **Sending quotations is deliberately not implemented** — it is done by a human via 'Send by Email' in the Odoo UI (gives the customer Accept & Sign), CLI policy 2026-09-24
 - Signature pipeline (`sign`) — Odoo Sign with safety rails learned from live incidents:
   - `sign templates list/show` and `sign templates create-from-document <id>` — builds a
     `sign.template` from a Documents file, converting non-PDF files (`.docx` etc.) to PDF through
@@ -181,7 +186,7 @@ Note: `odoo --version` prints the CLI's own version; `odoo version` queries the
 - Read-only Helpdesk surface (`helpdesk tickets list/show`) — `--open`/`--closed` via stage `fold`, strict team-scoped stage resolution, module-not-installed error (exit 4)
 - Read-only Project surface (`project list/show`) — `--user` (project manager) and `--tag` filters, archived projects excluded by default, module-not-installed error (exit 4)
 - Read-only Project task surface (`project tasks list/show`) — `--project` (required on list, resolved by name or id), project-scoped `--stage`, `--assignee` (many2many `user_ids`), `--tag`, `--priority` (0/Low, 1/High), `--open`/`--closed` via the task's `is_closed` flag, `--domain`/`--filter`, table/JSON output with `search_count` envelope, module-not-installed error (exit 4)
-- Generic model surface (`models fields/read`) — introspect and read any model exposed through `execute_kw`: `fields` lists `fields_get` metadata (type, label, selection, relation, required, store) with `--filter <regex>` (case-insensitive on field name or label) and `--custom` (only `x_*` fields); `read` fetches up to 100 records by `--ids 1,2,3` or a name ilike `--search`, with `--fields a,b,c` (default: name). Unknown models/fields use the standard error taxonomy
+- Generic model surface (`models fields/read/search`) — introspect, read and search any model exposed through `execute_kw`: `fields` lists `fields_get` metadata (type, label, selection, relation, required, store) with `--filter <regex>` (case-insensitive on field name or label) and `--custom` (only `x_*` fields); `read` fetches up to 100 records by `--ids 1,2,3` or a name ilike `--search`, with `--fields a,b,c` (default: name); `search` runs an arbitrary domain via `--domain <json>` (or repeatable `--filter f=v`, mutually exclusive) with `--fields` (default: id[,name]), `--limit`/`--offset`/`--order`, and `--include-archived` (runs with `active_test: false`; eager-fetches rows other list engines hide by default). Unknown models/fields use the standard error taxonomy
 - Documents surface (`documents`) — `tree` (hierarchical folder listing with `--count`/`--depth`/`--folder`), `records list/show` (folders excluded by default, `--type folder|binary|url|all`, `--folder`/`--owner`/`--partner`/`--tag`), `folders list`, `records create` (folder via `--folder-type folder`, link via `--link <url>`), `records update` (move via `--folder`), `records delete`, `upload` (local file → base64 `datas`, MIME guessed from extension, `--dry-run` previews without sending bytes), and `records download <id>` (binary document → local file, `--out <path>`/`--force`, `--out -` streams to stdout). Everywhere a `--folder` is accepted, folders resolve by name, numeric id, or nested `'Parent > Child'` path (segments resolved within their parent, which disambiguates repeated folder names). Folders are `documents.document` rows with `type='folder'`; the hierarchy is `folder_id`. Module-not-installed error (exit 4)
 - Writes (`create`, `update`, `delete`) — single-call atomic batch `write`, client-side no-op diffing, delete convergence with `skipped` ids, post-failure "record may have been created" hint on `create`
 - `--dry-run` for all mutations — full validation, resolution, and before/after diffs without mutating

package/dist/cli.js

@@ -13,10 +13,10 @@ import { partnersCreateCommand, partnersDeleteCommand, partnersListCommand, part
 import { usersDeleteCommand, usersShowCommand, } from "./commands/users.js";
 import { attachmentsDeleteCommand, attachmentsDownloadCommand, attachmentsListCommand, attachmentsShowCommand, } from "./commands/attachments.js";
 import { signTemplatesCreateFromDocumentCommand, signTemplatesListCommand, signTemplatesShowCommand, signItemsAddCommand, signRequestsCreateCommand, signRequestsListCommand, signRequestsCancelCommand, } from "./commands/sign.js";
-import { invoicesPrecedentCommand, linesAddCommand, linesUpdateCommand, ordersCreateCommand, ordersListCommand, ordersReadCommand, ordersUpdateCommand, pdfCommand, plansListCommand, } from "./commands/sales.js";
+import { invoicesPrecedentCommand, linesAddCommand, linesUpdateCommand, ordersCreateCommand, ordersListCommand, ordersReadCommand, ordersUpdateCommand, pdfCommand, plansListCommand, plansPricingCreateCommand, plansPricingListCommand, plansPricingUpdateCommand, } from "./commands/sales.js";
 import { messagesDeleteCommand, messagesListCommand, messagesScrubCommand, messagesShowCommand, } from "./commands/messages.js";
 import { contactsDeleteCommand, contactsListCommand, contactsShowCommand, listsListCommand, listsShowCommand, tracesDeleteCommand, tracesListCommand, tracesShowCommand, } from "./commands/marketing.js";
-import { modelsFieldsCommand, modelsReadCommand, } from "./commands/models.js";
+import { modelsFieldsCommand, modelsReadCommand, modelsSearchCommand, } from "./commands/models.js";
 import { footprintCommand, } from "./commands/footprint.js";
 import { CliError } from "./errors.js";
 import { applyGlobalOptions, enforceTransportSecurity, DEFAULT_TIMEOUT, } from "./global-options.js";
@@ -1033,6 +1033,59 @@ Examples:
         .action(async (opts) => {
         await run((g) => plansListCommand(opts, g), program);
     });
+    const salesPlansPricing = salesPlans
+        .command("pricing")
+        .description("recurring prices per pricelist/product/plan (sale.subscription.pricing)");
+    salesPlansPricing
+        .command("list")
+        .description("list recurring pricing rules")
+        .option("--pricelist <name|id>", "filter by pricelist (product.pricelist)")
+        .option("--product <name|id>", "filter by product (product.template)")
+        .option("--plan <name|id>", "filter by plan (sale.subscription.plan)")
+        .option("--limit <n>", "max records (default: 50)", "50")
+        .addHelpText("after", `
+Subscription order lines price from these rules, not from
+product.pricelist.item. If an order's pricelist has no rule for the order's
+plan, the line silently prices at 0 — check here before switching pricelists.
+
+Examples:
+  $ odoo sales plans pricing list --pricelist "SEK price list"
+  $ odoo sales plans pricing list --product "Berget Code Seat" --json`)
+        .action(async (opts) => {
+        await run((g) => plansPricingListCommand(opts, g), program);
+    });
+    salesPlansPricing
+        .command("create")
+        .description("create a recurring pricing rule (preview with --dry-run)")
+        .requiredOption("--pricelist <name|id>", "pricelist (product.pricelist)")
+        .requiredOption("--product <name|id>", "product (product.template)")
+        .requiredOption("--plan <name|id>", "recurring plan (sale.subscription.plan)")
+        .requiredOption("--price <amount>", "recurring price (number)")
+        .addHelpText("after", `
+Only one rule per (pricelist, product, plan) is allowed — duplicates are
+rejected; use 'sales plans pricing update' to change an existing rule.
+
+Examples:
+  $ odoo sales plans pricing create --pricelist "SEK price list" --product 188 --plan Yearly --price 19800 --dry-run
+  $ odoo sales plans pricing create --pricelist 11 --product 188 --plan 2 --price 19800`)
+        .action(async (opts) => {
+        await run((g) => plansPricingCreateCommand(opts, g), program);
+    });
+    salesPlansPricing
+        .command("update")
+        .description("update a recurring pricing rule (preview with --dry-run)")
+        .argument("<id>", "sale.subscription.pricing id")
+        .option("--pricelist <name|id>", "pricelist (product.pricelist)")
+        .option("--product <name|id>", "product (product.template)")
+        .option("--plan <name|id>", "recurring plan (sale.subscription.plan)")
+        .option("--price <amount>", "recurring price (number)")
+        .addHelpText("after", `
+Examples:
+  $ odoo sales plans pricing update 131 --price 19800 --dry-run
+  $ odoo sales plans pricing update 131 --plan Yearly`)
+        .action(async (id, opts) => {
+        await run((g) => plansPricingUpdateCommand(id, opts, g), program);
+    });
     const salesInvoices = sales
         .command("invoices")
         .description("invoicing reports (account.move.line)");
@@ -1320,6 +1373,25 @@ Examples:
         .action(async (model, opts) => {
         await run((g) => modelsReadCommand(model, opts, g), program);
     });
+    models
+        .command("search")
+        .description("search records by domain (search_read; use --fields, --limit, --order)")
+        .argument("<model>", "model technical name, e.g. mail.activity")
+        .option("--domain <json>", 'Odoo domain as a JSON array, e.g. [["date_deadline","<=","2026-01-31"]]')
+        .option("--filter <field=value>", "equality filter on raw values (repeatable); many2one values must be numeric ids", collect, [])
+        .option("--fields <a,b,c>", "fields to fetch (default: id[,name])")
+        .option("--limit <n>", "max records (default: 50)", "50")
+        .option("--offset <n>", "skip the first n records", "0")
+        .option("--order <order>", 'sort order, e.g. "date_deadline asc"')
+        .option("--include-archived", "match archived records too (runs with active_test: false)")
+        .addHelpText("after", `
+Examples:
+  $ odoo models search mail.activity --domain '[["user_id","=",39],["date_deadline","<=","2026-09-25"]]' --json
+  $ odoo models search mail.activity --filter user_id=39 --fields res_id,summary,date_deadline --json
+  $ odoo models search crm.lead --domain '[["team_id","=",2]]' --order "create_date desc" --limit 20 --json`)
+        .action(async (model, opts) => {
+        await run((g) => modelsSearchCommand(model, opts, g), program);
+    });
     return program;
 }
 async function run(fn, program) {

package/dist/commands/models.js

@@ -1,9 +1,16 @@
+import { buildFilterClauses, parseDomain } from "../filter.js";
 import { notFoundError, usageError } from "../errors.js";
 import { fieldsGet, ModelFields } from "../model.js";
 import { colorEnabled, printJson } from "../output.js";
 import { authenticatedClient } from "../resource.js";
 import { formatTable, humanCell } from "../table.js";
 const MAX_READ = 100;
+function parseCount(raw, flag) {
+    if (!/^\d+$/.test(raw)) {
+        throw usageError(`invalid ${flag} value ${JSON.stringify(raw)}`, "expected a non-negative integer");
+    }
+    return Number(raw);
+}
 function parseFieldList(raw) {
     const fields = raw
         .split(",")
@@ -125,3 +132,54 @@ export async function modelsReadCommand(model, opts, globals) {
     const rows = records.map((r) => fields.map((f) => humanCell(r[f])));
     process.stdout.write(formatTable(headers, rows, colorEnabled(globals.noColor)) + "\n");
 }
+/**
+ * `models search <model>` — generic domain search over any model reachable
+ * through execute_kw. The read-side counterpart to `models read` when the
+ * name-ilike search is not enough: arbitrary domains via JSON --domain, or
+ * another model's filter surface via repeatable --filter f=v (id equality on
+ * many2one fields). Sqlite-style paging via --limit/--offset; ordering via
+ * --order. --include-archived disables active_test so archived rows are
+ * matched; on models without an `active` field it is a no-op.
+ */
+export async function modelsSearchCommand(model, opts, globals) {
+    if (opts.domain !== undefined && opts.filter && opts.filter.length > 0) {
+        throw usageError("--domain and --filter are mutually exclusive", "pick one filtering form");
+    }
+    const limit = parseCount(opts.limit, "--limit");
+    const offset = parseCount(opts.offset, "--offset");
+    const client = await authenticatedClient(globals);
+    const meta = await ModelFields.load(client, model);
+    const domain = [];
+    if (opts.domain !== undefined) {
+        domain.push(...parseDomain(opts.domain));
+    }
+    else if (opts.filter && opts.filter.length > 0) {
+        domain.push(...buildFilterClauses(opts.filter, meta, {}, `run \`odoo models fields ${model}\` to list available fields`));
+    }
+    const defaultFields = meta.get("name") ? ["id", "name"] : ["id"];
+    const fields = opts.fields !== undefined ? parseFieldList(opts.fields) : defaultFields;
+    for (const field of fields) {
+        if (field !== "id" && !meta.get(field)) {
+            throw usageError(`unknown field ${JSON.stringify(field)} on ${model}`, "run `odoo models fields <model>` to list available fields");
+        }
+    }
+    const context = opts.includeArchived
+        ? { active_test: false }
+        : undefined;
+    const kwargs = { fields, limit, offset, order: opts.order ?? "id asc" };
+    if (context)
+        kwargs.context = context;
+    const [records, count] = await Promise.all([
+        client.executeKw(model, "search_read", [domain], kwargs),
+        client.executeKw(model, "search_count", [domain], {
+            ...(context ? { context } : {}),
+        }),
+    ]);
+    if (globals.json) {
+        printJson({ model, records, count, limit, offset });
+        return;
+    }
+    const headers = fields.map((f) => meta.get(f)?.string ?? f);
+    const rows = records.map((r) => fields.map((f) => humanCell(r[f])));
+    process.stdout.write(formatTable(headers, rows, colorEnabled(globals.noColor)) + "\n");
+}

package/dist/commands/sales.js

@@ -15,7 +15,8 @@ import { resolveConfig } from "../config.js";
 import { conflictError, networkError, notFoundError, usageError, } from "../errors.js";
 import { buildFilterClauses, parseDomain, parseFilterScalar } from "../filter.js";
 import { ModelFields, resolveReference } from "../model.js";
-import { parseDate } from "../mutation.js";
+import { parseDate, parseDecimal } from "../mutation.js";
+import { XmlRpcFaultError } from "../xmlrpc.js";
 import { colorEnabled, printJson, verbose as logVerbose } from "../output.js";
 import { authenticatedClient, parseId, } from "../resource.js";
 import { formatKeyValues, formatTable, humanCell } from "../table.js";
@@ -25,6 +26,7 @@ import { formatKeyValues, formatTable, humanCell } from "../table.js";
 const SALE_ORDER = "sale.order";
 const SALE_ORDER_LINE = "sale.order.line";
 const SUBSCRIPTION_PLAN = "sale.subscription.plan";
+const SUBSCRIPTION_PRICING = "sale.subscription.pricing";
 const STATE_LABELS = {
     draft: "Quotation",
     sent: "Quotation Sent",
@@ -724,6 +726,232 @@ export async function plansListCommand(opts, globals) {
     ]);
     process.stdout.write(formatTable(headers, rows, colorEnabled(globals.noColor)) + "\n");
 }
+// ---------------------------------------------------------------------------
+// plans pricing — recurring prices per pricelist/product/plan
+// (sale.subscription.pricing). Subscription order lines price from these
+// rules, NOT from product.pricelist.item — an order whose pricelist lacks a
+// pricing rule for the plan on the order silently prices the line at 0.
+// ---------------------------------------------------------------------------
+const PRICING_FIELDS = [
+    "id",
+    "pricelist_id",
+    "product_template_id",
+    "plan_id",
+    "price",
+];
+async function resolvePricingRefs(client, opts, globals) {
+    const refs = {};
+    if (opts.pricelist !== undefined) {
+        refs.pricelist = await resolveReference(client, "product.pricelist", opts.pricelist, { label: "pricelist" });
+        logVerbose(`resolved --pricelist "${opts.pricelist}" -> [${refs.pricelist.id}, "${refs.pricelist.name}"]`, globals.verbose);
+    }
+    if (opts.product !== undefined) {
+        refs.product = await resolveReference(client, "product.template", opts.product, { label: "product template" });
+        logVerbose(`resolved --product "${opts.product}" -> [${refs.product.id}, "${refs.product.name}"]`, globals.verbose);
+    }
+    if (opts.plan !== undefined) {
+        refs.plan = await resolveReference(client, SUBSCRIPTION_PLAN, opts.plan, {
+            label: "plan",
+        });
+        logVerbose(`resolved --plan "${opts.plan}" -> [${refs.plan.id}, "${refs.plan.name}"]`, globals.verbose);
+    }
+    return refs;
+}
+export async function plansPricingListCommand(opts, globals) {
+    const client = await authenticatedClient(globals);
+    await ModelFields.load(client, SUBSCRIPTION_PRICING);
+    const limit = parseCount(opts.limit, "--limit");
+    const refs = await resolvePricingRefs(client, opts, globals);
+    const domain = [];
+    if (refs.pricelist)
+        domain.push(["pricelist_id", "=", refs.pricelist.id]);
+    if (refs.product)
+        domain.push(["product_template_id", "=", refs.product.id]);
+    if (refs.plan)
+        domain.push(["plan_id", "=", refs.plan.id]);
+    const records = (await client.executeKw(SUBSCRIPTION_PRICING, "search_read", [
+        domain,
+    ], {
+        fields: PRICING_FIELDS,
+        limit,
+        order: "id asc",
+    }));
+    if (globals.json) {
+        printJson({ model: SUBSCRIPTION_PRICING, records, count: records.length });
+        return;
+    }
+    const headers = ["ID", "Pricelist", "Product", "Plan", "Price"];
+    const rows = records.map((r) => [
+        String(r.id),
+        humanCell(r.pricelist_id),
+        humanCell(r.product_template_id),
+        humanCell(r.plan_id),
+        humanCell(r.price),
+    ]);
+    process.stdout.write(formatTable(headers, rows, colorEnabled(globals.noColor)) + "\n");
+}
+export async function plansPricingCreateCommand(opts, globals) {
+    const client = await authenticatedClient(globals);
+    await ModelFields.load(client, SUBSCRIPTION_PRICING);
+    const refs = await resolvePricingRefs(client, opts, globals);
+    const price = parseDecimal(opts.price, "--price");
+    // Guardrail: one rule per (pricelist, product, plan) — a duplicate would
+    // make line pricing ambiguous.
+    const duplicates = (await client.executeKw(SUBSCRIPTION_PRICING, "search_read", [
+        [
+            ["pricelist_id", "=", refs.pricelist.id],
+            ["product_template_id", "=", refs.product.id],
+            ["plan_id", "=", refs.plan.id],
+        ],
+    ], { fields: ["id", "price"], limit: 5 }));
+    if (duplicates.length > 0) {
+        throw conflictError("duplicate_pricing", `a pricing rule already exists for pricelist ${refs.pricelist.id}, product ${refs.product.id}, plan ${refs.plan.id} (id ${duplicates[0].id}, price ${duplicates[0].price})`, `use 'sales plans pricing update ${duplicates[0].id}' to change it`);
+    }
+    const values = {
+        pricelist_id: refs.pricelist.id,
+        product_template_id: refs.product.id,
+        plan_id: refs.plan.id,
+        price,
+    };
+    if (globals.dryRun) {
+        if (globals.json) {
+            printJson({
+                model: SUBSCRIPTION_PRICING,
+                action: "create",
+                dry_run: true,
+                values,
+            });
+            return;
+        }
+        const lines = [
+            `Would create ${SUBSCRIPTION_PRICING}:`,
+            `  pricelist_id:        [${refs.pricelist.id}, ${JSON.stringify(refs.pricelist.name)}]`,
+            `  product_template_id: [${refs.product.id}, ${JSON.stringify(refs.product.name)}]`,
+            `  plan_id:             [${refs.plan.id}, ${JSON.stringify(refs.plan.name)}]`,
+            `  price:               ${price}`,
+        ];
+        process.stdout.write(lines.join("\n") + "\n");
+        return;
+    }
+    let id;
+    try {
+        id = await client.executeKw(SUBSCRIPTION_PRICING, "create", [values]);
+    }
+    catch (error) {
+        if (!(error instanceof XmlRpcFaultError) &&
+            error.exitCode === 6) {
+            throw networkError(error.message, "the request reached the server; the record may have been created — verify with list before retrying");
+        }
+        if (error instanceof XmlRpcFaultError) {
+            throw conflictError("server_fault", `the server rejected the create (fault ${error.faultCode})`, "retry with --verbose to see the full server response");
+        }
+        throw error;
+    }
+    if (typeof id !== "number" || !Number.isInteger(id)) {
+        throw networkError(`unexpected create() response from the server: ${JSON.stringify(id)}`);
+    }
+    if (globals.json) {
+        printJson({
+            model: SUBSCRIPTION_PRICING,
+            action: "create",
+            dry_run: false,
+            id,
+        });
+        return;
+    }
+    const color = colorEnabled(false) && process.stdout.isTTY === true;
+    const line = `Created ${SUBSCRIPTION_PRICING} ${id}`;
+    process.stdout.write((color ? `\x1b[32m${line}\x1b[0m` : line) + "\n");
+}
+export async function plansPricingUpdateCommand(idArg, opts, globals) {
+    const pricingId = parseId(idArg);
+    const client = await authenticatedClient(globals);
+    await ModelFields.load(client, SUBSCRIPTION_PRICING);
+    const refs = await resolvePricingRefs(client, opts, globals);
+    const values = {};
+    if (refs.pricelist)
+        values.pricelist_id = refs.pricelist.id;
+    if (refs.product)
+        values.product_template_id = refs.product.id;
+    if (refs.plan)
+        values.plan_id = refs.plan.id;
+    if (opts.price !== undefined)
+        values.price = parseDecimal(opts.price, "--price");
+    if (Object.keys(values).length === 0) {
+        throw usageError("nothing to update", "pass at least one of --pricelist, --product, --plan, --price");
+    }
+    // Read-first pass: existence check + diff, mirroring orders update.
+    const rows = (await client.executeKw(SUBSCRIPTION_PRICING, "read", [
+        [pricingId],
+    ], { fields: PRICING_FIELDS }));
+    if (rows.length === 0) {
+        throw notFoundError("record_not_found", `no ${SUBSCRIPTION_PRICING} record with id ${pricingId}`);
+    }
+    const rec = rows[0];
+    const changes = {};
+    for (const [field, after] of Object.entries(values)) {
+        const before = rec[field];
+        const beforeId = Array.isArray(before) ? before[0] : before;
+        if (beforeId !== after) {
+            changes[field] = { before, after };
+        }
+    }
+    if (globals.dryRun) {
+        if (globals.json) {
+            printJson({
+                model: SUBSCRIPTION_PRICING,
+                action: "update",
+                dry_run: true,
+                changes: { [String(pricingId)]: changes },
+            });
+            return;
+        }
+        const lines = [];
+        if (Object.keys(changes).length === 0) {
+            lines.push(`Unchanged ${SUBSCRIPTION_PRICING} ${pricingId} — nothing to change`);
+        }
+        else {
+            lines.push(`Would update ${SUBSCRIPTION_PRICING} ${pricingId}:`);
+            for (const [field, change] of Object.entries(changes)) {
+                lines.push(`  ${field}: ${humanCell(change.before)} -> ${humanCell(change.after)}`);
+            }
+        }
+        process.stdout.write(lines.join("\n") + "\n");
+        return;
+    }
+    if (Object.keys(changes).length > 0) {
+        try {
+            await client.executeKw(SUBSCRIPTION_PRICING, "write", [
+                [pricingId],
+                values,
+            ]);
+        }
+        catch (error) {
+            if (error instanceof XmlRpcFaultError) {
+                throw conflictError("server_fault", `the server rejected the update (fault ${error.faultCode})`, "retry with --verbose to see the full server response");
+            }
+            throw error;
+        }
+    }
+    if (globals.json) {
+        printJson({
+            model: SUBSCRIPTION_PRICING,
+            action: "update",
+            dry_run: false,
+            changes: { [String(pricingId)]: changes },
+        });
+        return;
+    }
+    const color = colorEnabled(false) && process.stdout.isTTY === true;
+    const line = Object.keys(changes).length === 0
+        ? `Unchanged ${SUBSCRIPTION_PRICING} ${pricingId}`
+        : `Updated ${SUBSCRIPTION_PRICING} ${pricingId}`;
+    process.stdout.write((Object.keys(changes).length === 0
+        ? line
+        : color
+            ? `\x1b[33m${line}\x1b[0m`
+            : line) + "\n");
+}
 export async function invoicesPrecedentCommand(opts, globals) {
     const client = await authenticatedClient(globals);
     if (!opts.product) {

package/dist/filter.js

@@ -33,7 +33,7 @@ export function parseFilterScalar(raw) {
  * many2one fields only accept numeric ids — a non-numeric value is a usage
  * error pointing at the resolution flags, never a silently empty result.
  */
-export function buildFilterClauses(filters, fields, resolutionHints) {
+export function buildFilterClauses(filters, fields, resolutionHints, unknownFieldHint) {
     const clauses = [];
     for (const filter of filters) {
         const eq = filter.indexOf("=");
@@ -44,7 +44,8 @@ export function buildFilterClauses(filters, fields, resolutionHints) {
         const rawValue = filter.slice(eq + 1);
         const meta = fields.get(field);
         if (!meta) {
-            throw usageError(`unknown field ${JSON.stringify(field)} in --filter`, "check the field name with `odoo crm leads show <id> --all-fields`");
+            throw usageError(`unknown field ${JSON.stringify(field)} in --filter`, unknownFieldHint ??
+                "check the field name with `odoo crm leads show <id> --all-fields`");
         }
         const value = parseFilterScalar(rawValue);
         if (meta.type === "many2one" &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bergetai/odoo-cli",
-  "version": "0.12.4",
+  "version": "0.12.7",
   "description": "Agent-first CLI for the Odoo External API",
   "publishConfig": {
     "access": "public"