@bergetai/odoo-cli 0.4.2 → 0.5.2

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

@@ -5,10 +5,11 @@ import { leadsCreateCommand, leadsDeleteCommand, leadsListCommand, leadsShowComm
 import { teamsCreateCommand, teamsDeleteCommand, teamsListCommand, teamsShowCommand, teamsUpdateCommand, crmTeams, } from "./commands/teams.js";
 import { ticketsCreateCommand, ticketsDeleteCommand, ticketsListCommand, ticketsShowCommand, ticketsUpdateCommand, helpdeskTickets, } from "./commands/helpdesk.js";
 import { addNoteCommand, listMessagesCommand, } from "./commands/notes.js";
-import { activitiesListCommand, activityDoneCommand, scheduleCommand, } from "./commands/activities.js";
+import { activitiesListCommand, activityDoneCommand, activityUpdateCommand, scheduleCommand, } from "./commands/activities.js";
 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";
@@ -226,6 +227,30 @@ Examples:
         .action(async (ids) => {
         await run((g) => activityDoneCommand(ids, g), program);
     });
+    leads
+        .command("activity-update")
+        .description("update activities — deadline, summary, note, type, assignee (preview with --dry-run)")
+        .argument("<id...>", "activity ids")
+        .option("--deadline <yyyy-mm-dd>", "new deadline")
+        .option("--summary <text>", "new summary")
+        .option("--note <text>", "new note")
+        .option("--type <name|id>", "new activity type (e.g. To-Do, Call, Meeting)")
+        .option("--assignee <name|id>", "new assignee (login, email, or name)")
+        .addHelpText("after", `
+Updates mail.activity records directly via write. At least one field is required.
+
+Examples:
+  # Push an activity deadline to tomorrow
+  $ odoo crm records activity-update 736 --deadline 2026-08-28
+
+  # Update summary + deadline for two activities
+  $ odoo crm records activity-update 736 731 --deadline 2026-08-28 --summary "Follow-up"
+
+  # Dry run
+  $ odoo crm records activity-update 736 --deadline 2026-08-28 --dry-run`)
+        .action(async (ids, opts) => {
+        await run((g) => activityUpdateCommand(ids, opts, g), program);
+    });
     const teams = crm.command("teams").description("sales teams (crm.team)");
     teams
         .command("list")
@@ -552,6 +577,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/activities.js

@@ -180,6 +180,101 @@ export async function activityDoneCommand(activityIds, globals) {
         console.log(`✓ Marked ${ids.length} activity(ies) as done: ${ids.join(", ")}`);
     }
 }
+/**
+ * Update one or more activities (mail.activity) — deadline, summary, note,
+ * type, or assignee. Uses `write` directly on mail.activity.
+ */
+export async function activityUpdateCommand(activityIds, opts, globals) {
+    const ids = activityIds.map((raw) => {
+        const n = Number.parseInt(raw, 10);
+        if (Number.isNaN(n) || n <= 0) {
+            throw usageError(`invalid activity id: ${raw}`, "provide a positive integer");
+        }
+        return n;
+    });
+    if (!opts.deadline && !opts.summary && opts.note === undefined && !opts.type && !opts.assignee) {
+        throw usageError("no fields to update", "provide at least one of --deadline, --summary, --note, --type, --assignee");
+    }
+    const client = await buildClient(globals);
+    // Verify the activities exist
+    const rows = (await client.executeKw("mail.activity", "search_read", [[["id", "in", ids]]], {
+        fields: ["id", "summary", "date_deadline", "state", "activity_type_id", "user_id"],
+        limit: ids.length,
+    }));
+    const byId = new Map(rows.map((r) => [r.id, r]));
+    const missing = ids.filter((id) => !byId.has(id));
+    if (missing.length > 0) {
+        throw notFoundError("record_not_found", `no mail.activity record(s) with id(s): ${missing.join(", ")}`, "no activities were modified — aborts the whole batch when any id is missing");
+    }
+    const values = {};
+    if (opts.deadline) {
+        values.date_deadline = parseDate(opts.deadline, "--deadline");
+    }
+    if (opts.summary) {
+        values.summary = opts.summary;
+    }
+    if (opts.note !== undefined) {
+        values.note = opts.note;
+    }
+    if (opts.type) {
+        const activityType = await resolveReference(client, "mail.activity.type", opts.type, {
+            label: "activity type",
+        });
+        values.activity_type_id = activityType.id;
+    }
+    if (opts.assignee) {
+        const user = await resolveReference(client, "res.users", opts.assignee, {
+            label: "user",
+            searchFields: ["login", "email", "name"],
+        });
+        values.user_id = user.id;
+    }
+    if (globals.verbose) {
+        logVerbose(`Updating ${ids.length} activity(ies): ${JSON.stringify(values)}`, globals.verbose);
+    }
+    if (globals.dryRun) {
+        if (globals.json) {
+            printJson({
+                model: "mail.activity",
+                action: "update",
+                dry_run: true,
+                ids,
+                values,
+                activities: rows.map((r) => ({
+                    id: r.id,
+                    summary: r.summary,
+                    date_deadline: r.date_deadline,
+                    state: r.state,
+                })),
+            });
+        }
+        else {
+            console.log(`[DRY RUN] Would update ${ids.length} activity(ies):`);
+            for (const r of rows) {
+                console.log(`  #${r.id} — ${r.summary} (deadline: ${r.date_deadline ?? "none"}, state: ${r.state})`);
+            }
+            console.log(`  New values: ${JSON.stringify(values, null, 2)}`);
+        }
+        return;
+    }
+    await client.executeKw("mail.activity", "write", [ids, values]);
+    if (globals.json) {
+        printJson({
+            model: "mail.activity",
+            action: "update",
+            dry_run: false,
+            updated: ids,
+            values,
+        });
+    }
+    else {
+        console.log(`✓ Updated ${ids.length} activity(ies): ${ids.join(", ")}`);
+        if (opts.deadline)
+            console.log(`  New deadline: ${values.date_deadline}`);
+        if (opts.summary)
+            console.log(`  New summary: ${values.summary}`);
+    }
+}
 /**
  * List activities for a crm.lead record.
  */

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/package.json

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