@bergetai/odoo-cli 0.4.1 → 0.5.1

package/README.md

@@ -24,6 +24,13 @@ odoo auth status --json
 # Unauthenticated connectivity check
 odoo version
 
+# Partners (companies and contacts — res.partner)
+odoo partners list --company --json
+odoo partners show 51
+odoo partners create --name "Acme Corp" --is-company true --email info@acme.example
+odoo partners update 51 --email new@acme.example --dry-run
+odoo partners delete 54 --dry-run
+
 # List and inspect records
 odoo crm leads list --open --limit 20
 odoo crm leads show 42
@@ -59,6 +66,7 @@ Note: `odoo --version` prints the CLI's own version; `odoo version` queries the
 ## Features
 
 - Read-only CRM surface (`crm leads list/show`) — default columns, `--fields`/`--all-fields`, `--limit`/`--offset`/`--order`, `--domain`/`--filter` with `fields_get` type checking, reference resolution (`--stage`/`--team`/`--assignee`/`--tag`), table/JSON output with `search_count` envelope
+- Partners surface (`partners list/show/create/update/delete`) — `res.partner` CRUD with `--company`/`--individual` filters, `--archived` (include inactive), first-class flags for `--name`, `--email`, `--phone`, `--website`, `--parent` (m2o), `--is-company`, `--street`, `--city`, `--zip`, `--country` (m2o), `--comment`, full `--dry-run` support, `--fields`/`--all-fields`, table/JSON output
 - Sales teams surface (`crm teams list/show/create/update/delete`) — `--archived` (include inactive teams), `--team-leader` (team leader, login/email/name), `--active`/`--use-leads`/`--use-opportunities`/`--invoiced-target`/`--color`/`--sequence`, full `--dry-run` support, `--fields`/`--all-fields`, table/JSON output
 - 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)

package/dist/cli.js

@@ -9,6 +9,7 @@ import { activitiesListCommand, activityDoneCommand, scheduleCommand, } from "./
 import { createTaskCommand, projectListCommand, projectShowCommand, tasksListCommand, tasksShowCommand, } from "./commands/project.js";
 import { documentsDocuments, documentsListCommand, foldersListCommand, documentsShowCommand, documentsCreateCommand, documentsUpdateCommand, documentsDeleteCommand, treeCommand, uploadCommand, } from "./commands/documents.js";
 import { versionCommand } from "./commands/version.js";
+import { partnersCreateCommand, partnersDeleteCommand, partnersListCommand, partnersShowCommand, partnersUpdateCommand, resPartner, } from "./commands/partners.js";
 import { CliError } from "./errors.js";
 import { applyGlobalOptions, enforceTransportSecurity, DEFAULT_TIMEOUT, } from "./global-options.js";
 import { printError } from "./output.js";
@@ -552,6 +553,52 @@ Examples:
         .action(async (opts) => {
         await run((g) => uploadCommand(opts, g), program);
     });
+    const partners = program
+        .command("partners")
+        .description("Contacts and companies (res.partner)");
+    partners
+        .command("list")
+        .description("search and list partners with curated default columns")
+        .option("--archived", "include archived partners (active = false) instead of active only")
+        .option("--company", "only companies (is_company = true)")
+        .option("--individual", "only individuals (is_company = false)")
+        .option("--filter <f=v>", "equality filter; repeatable, AND-ed", collect, [])
+        .option("--domain <json>", "Odoo domain as a JSON array (mutually exclusive with --filter)")
+        .option("--fields <a,b,c>", "columns to display")
+        .option("--limit <n>", "max records (default: 50)", "50")
+        .option("--offset <n>", "skip the first n records", "0")
+        .option("--order <order>", 'sort order, e.g. "name asc"', undefined)
+        .action(async (opts) => {
+        await run((g) => partnersListCommand(opts, g), program);
+    });
+    partners
+        .command("show")
+        .description("read one partner")
+        .argument("<id>", "record id")
+        .option("--fields <a,b,c>", "fields to display")
+        .option("--all-fields", "display every readable field")
+        .action(async (id, opts) => {
+        await run((g) => partnersShowCommand(id, opts, g), program);
+    });
+    addMutationFlags(partners
+        .command("create")
+        .description("create a partner (company or individual; preview with --dry-run)"), resPartner).action(async (opts) => {
+        await run((g) => partnersCreateCommand(opts, g), program);
+    });
+    addMutationFlags(partners
+        .command("update")
+        .description("update partners (preview with --dry-run)"), resPartner)
+        .argument("<id...>", "record ids")
+        .action(async (ids, opts) => {
+        await run((g) => partnersUpdateCommand(ids, opts, g), program);
+    });
+    partners
+        .command("delete")
+        .description("delete partners (preview with --dry-run; unknown ids are skipped)")
+        .argument("<id...>", "record ids")
+        .action(async (ids) => {
+        await run((g) => partnersDeleteCommand(ids, g), program);
+    });
     return program;
 }
 async function run(fn, program) {

package/dist/commands/partners.js

@@ -0,0 +1,244 @@
+import { ModelFields } from "../model.js";
+import { authenticatedClient, showCommand, } from "../resource.js";
+import { createCommand, deleteCommand, updateCommand, } from "../mutation.js";
+import { buildFilterClauses, parseDomain } from "../filter.js";
+import { usageError } from "../errors.js";
+import { colorEnabled, printJson } from "../output.js";
+import { formatTable, humanCell } from "../table.js";
+function parseYesNoFlag(raw, flagName) {
+    const v = raw.toLowerCase();
+    if (v === "true" || v === "1" || v === "yes")
+        return true;
+    if (v === "false" || v === "0" || v === "no")
+        return false;
+    throw usageError(`invalid ${flagName} value ${JSON.stringify(raw)}`, "expected: true or false");
+}
+/**
+ * Mutation flags for res.partner. Keeps a focused first-class surface — the
+ * full partner model has hundreds of fields; `--set` and `--values` cover the
+ * long tail. `--parent` resolves the parent company (many2one), and
+ * `--is-company` is a boolean flag matching the Odoo `is_company` selection.
+ */
+const resPartnerMutation = {
+    flags: [
+        {
+            flags: "--name <name>",
+            option: "name",
+            field: "name",
+            help: "Partner name",
+            requiredOnCreate: true,
+        },
+        {
+            flags: "--email <address>",
+            option: "email",
+            field: "email",
+            help: "Email",
+        },
+        {
+            flags: "--phone <number>",
+            option: "phone",
+            field: "phone",
+            help: "Phone",
+        },
+        {
+            flags: "--website <url>",
+            option: "website",
+            field: "website",
+            help: "Website",
+        },
+        {
+            flags: "--parent <name|id>",
+            option: "parent",
+            field: "parent_id",
+            help: "Parent company (name or id)",
+            reference: {
+                model: "res.partner",
+                label: "partner",
+                searchFields: ["name", "email"],
+            },
+        },
+        {
+            flags: "--is-company <true|false>",
+            option: "isCompany",
+            field: "is_company",
+            help: "Is a company (default: false on create)",
+            parse: parseYesNoFlag,
+        },
+        {
+            flags: "--active <true|false>",
+            option: "active",
+            field: "active",
+            help: "Active flag (default: true on create)",
+            parse: parseYesNoFlag,
+        },
+        {
+            flags: "--street <text>",
+            option: "street",
+            field: "street",
+            help: "Street",
+        },
+        {
+            flags: "--city <text>",
+            option: "city",
+            field: "city",
+            help: "City",
+        },
+        {
+            flags: "--zip <code>",
+            option: "zip",
+            field: "zip",
+            help: "Postal / ZIP code",
+        },
+        {
+            flags: "--country <name|id>",
+            option: "country",
+            field: "country_id",
+            help: "Country (name or id)",
+            reference: {
+                model: "res.country",
+                label: "country",
+            },
+        },
+        {
+            flags: "--comment <text>",
+            option: "comment",
+            field: "comment",
+            help: "Internal comment",
+        },
+    ],
+    createDefaultValues: {
+        is_company: false,
+        active: true,
+    },
+};
+export const resPartner = {
+    model: "res.partner",
+    showCommand: "odoo partners show",
+    defaultListFields: [
+        "id",
+        "name",
+        "is_company",
+        "email",
+        "phone",
+        "parent_id",
+        "active",
+        "create_date",
+    ],
+    showExtraFields: [
+        "website",
+        "street",
+        "city",
+        "zip",
+        "country_id",
+        "comment",
+        "company_id",
+        "write_date",
+    ],
+    resolutionHints: {
+        parent_id: "--parent",
+        country_id: "--country",
+    },
+    priorityLabels: {},
+    pinnedDomain: [],
+    references: {
+        assignee: {
+            model: "res.partner",
+            label: "partner",
+            field: "parent_id",
+            searchFields: ["name", "email"],
+        },
+    },
+    mutation: resPartnerMutation,
+};
+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(",")
+        .map((f) => f.trim())
+        .filter((f) => f !== "");
+    if (fields.length === 0) {
+        throw usageError("--fields requires at least one field name");
+    }
+    return fields;
+}
+export async function partnersListCommand(opts, globals) {
+    const client = await authenticatedClient(globals);
+    if (opts.domain && opts.filter && opts.filter.length > 0) {
+        throw usageError("--domain and --filter are mutually exclusive", "pick one filtering form");
+    }
+    if (opts.company && opts.individual) {
+        throw usageError("--company and --individual are mutually exclusive", "pick one (or neither to list both)");
+    }
+    const limit = parseCount(opts.limit, "--limit");
+    const offset = parseCount(opts.offset, "--offset");
+    const fieldsMeta = await ModelFields.load(client, "res.partner");
+    const domain = [];
+    if (opts.archived) {
+        domain.push(["active", "=", false]);
+    }
+    else {
+        domain.push(["active", "=", true]);
+    }
+    if (opts.company)
+        domain.push(["is_company", "=", true]);
+    if (opts.individual)
+        domain.push(["is_company", "=", false]);
+    if (opts.domain) {
+        domain.push(...parseDomain(opts.domain));
+    }
+    else if (opts.filter && opts.filter.length > 0) {
+        domain.push(...buildFilterClauses(opts.filter, fieldsMeta, {
+            parent_id: "--parent",
+            country_id: "--country",
+        }));
+    }
+    const fields = opts.fields
+        ? parseFieldList(opts.fields)
+        : resPartner.defaultListFields;
+    for (const field of fields) {
+        if (field !== "id" && !fieldsMeta.get(field)) {
+            throw usageError(`unknown field ${JSON.stringify(field)} on res.partner`, `run \`odoo partners show <id> --all-fields\` to see available fields`);
+        }
+    }
+    const order = opts.order ?? "id asc";
+    // active_test:false so Odoo returns both active and archived rows; the
+    // domain above is the authoritative filter.
+    const kwargs = {
+        fields,
+        limit,
+        offset,
+        order,
+        context: { active_test: false },
+    };
+    const [records, count] = await Promise.all([
+        client.executeKw("res.partner", "search_read", [domain], kwargs),
+        client.executeKw("res.partner", "search_count", [domain], {
+            context: { active_test: false },
+        }),
+    ]);
+    if (globals.json) {
+        printJson({ model: "res.partner", records, count, limit, offset });
+        return;
+    }
+    const headers = fields.map((f) => fieldsMeta.get(f)?.string ?? f);
+    const rows = records.map((rec) => fields.map((f) => humanCell(rec[f])));
+    const color = colorEnabled(globals.noColor);
+    process.stdout.write(formatTable(headers, rows, color) + "\n");
+}
+export function partnersShowCommand(idArg, opts, globals) {
+    return showCommand(resPartner, idArg, opts, globals);
+}
+export function partnersCreateCommand(opts, globals) {
+    return createCommand(resPartner, opts, globals);
+}
+export function partnersUpdateCommand(idArgs, opts, globals) {
+    return updateCommand(resPartner, idArgs, opts, globals);
+}
+export function partnersDeleteCommand(idArgs, globals) {
+    return deleteCommand(resPartner, idArgs, globals);
+}

package/dist/commands/project.js

@@ -168,9 +168,10 @@ export async function createTaskCommand(opts, globals) {
         }
         return;
     }
-    const taskId = (await client.executeKw("project.task", "create", [
+    const rawTaskId = (await client.executeKw("project.task", "create", [
         [taskValues],
     ]));
+    const taskId = Array.isArray(rawTaskId) ? rawTaskId[0] : rawTaskId;
     const result = {
         task_id: taskId,
         name: opts.name,

package/package.json

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