@myapihq/cli 1.1.0-wip.4 → 1.2.0

package/dist/commands/company.js

@@ -0,0 +1,149 @@
+import { company as sdkCompany } from '@myapihq/sdk';
+import { requireConfig } from '../config.js';
+import { error, printTable, info, printJson } from '../output.js';
+import { requireOrg, requireArg } from '../helpers.js';
+export const EXPOSES = [
+    'POST /company/orgs/{org_id}/search',
+    'GET /company/orgs/{org_id}/{company_id}',
+];
+export const SCHEMA = {
+    org: 'string',
+    // Goldfox filter dimensions
+    confidence: 'string',
+    country: 'string',
+    'country-consistent': 'boolean',
+    'has-c-level': 'boolean',
+    'has-careers-page': 'boolean',
+    'has-decision-maker': 'boolean',
+    'has-investors-page': 'boolean',
+    'has-shop-page': 'boolean',
+    'is-registered-entity': 'boolean',
+    keyword: 'string',
+    'min-headcount': 'number',
+    'min-source-count': 'number',
+    'tld-class': 'string',
+    'include-people': 'number',
+    limit: 'number',
+    offset: 'number',
+};
+function csv(v) {
+    if (typeof v !== 'string' || v.trim() === '')
+        return undefined;
+    return v.split(',').map(s => s.trim()).filter(Boolean);
+}
+function buildSearch(flags) {
+    return {
+        confidence: csv(flags.confidence),
+        country: csv(flags.country),
+        country_consistent: typeof flags['country-consistent'] === 'boolean' ? flags['country-consistent'] : undefined,
+        has_c_level: typeof flags['has-c-level'] === 'boolean' ? flags['has-c-level'] : undefined,
+        has_careers_page: typeof flags['has-careers-page'] === 'boolean' ? flags['has-careers-page'] : undefined,
+        has_decision_maker: typeof flags['has-decision-maker'] === 'boolean' ? flags['has-decision-maker'] : undefined,
+        has_investors_page: typeof flags['has-investors-page'] === 'boolean' ? flags['has-investors-page'] : undefined,
+        has_shop_page: typeof flags['has-shop-page'] === 'boolean' ? flags['has-shop-page'] : undefined,
+        is_registered_entity: typeof flags['is-registered-entity'] === 'boolean' ? flags['is-registered-entity'] : undefined,
+        keyword: typeof flags.keyword === 'string' ? flags.keyword : undefined,
+        min_headcount: typeof flags['min-headcount'] === 'number' ? flags['min-headcount'] : undefined,
+        min_source_count: typeof flags['min-source-count'] === 'number' ? flags['min-source-count'] : undefined,
+        tld_class: csv(flags['tld-class']),
+        limit: typeof flags.limit === 'number' ? flags.limit : undefined,
+        offset: typeof flags.offset === 'number' ? flags.offset : undefined,
+        include_people: typeof flags['include-people'] === 'number' ? flags['include-people'] : undefined,
+    };
+}
+// Compact signal summary for the table: just the booleans that ARE true,
+// short-coded ("c=c_level dm=decision_maker careers inv shop"). Keeps the
+// table dense without dumping 6 yes/no columns per row.
+function signals(c) {
+    const out = [];
+    if (c.has_c_level)
+        out.push('c-level');
+    if (c.has_decision_maker)
+        out.push('dm');
+    if (c.has_careers_page)
+        out.push('careers');
+    if (c.has_investors_page)
+        out.push('investors');
+    if (c.has_shop_page)
+        out.push('shop');
+    return out.join(',');
+}
+async function search(flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi company search [filters...] [--org <id>]');
+    const options = buildSearch(flags);
+    const res = await sdkCompany.searchCompanies(config.api_key, orgId, options);
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    info(`${res.companies.length} of ${res.total} companies${res.has_more ? ' (more available — pass --offset)' : ''}`);
+    printTable(res.companies.map(c => ({
+        id: c.id,
+        domain: c.domain ?? '',
+        name: c.name,
+        country: c.country ?? '',
+        confidence: c.confidence ?? '',
+        headcount: c.headcount_lower_bound ?? '',
+        sources: c.source_count ?? '',
+        signals: signals(c),
+    })), { flags, empty: 'No companies matched. Try fewer filters.' });
+}
+async function get(companyId, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi company get <company_id> [--include-people N] [--org <id>]');
+    requireArg(companyId, 'company_id', 'myapi company get <company_id> [--include-people N] [--org <id>]');
+    const includePeople = typeof flags['include-people'] === 'number' ? flags['include-people'] : undefined;
+    const res = await sdkCompany.getCompany(config.api_key, orgId, companyId, includePeople);
+    printJson(res);
+}
+const SUBCOMMAND_USAGE = {
+    'search': `myapi company search [--confidence <csv>] [--country <csv>] [--country-consistent]
+       [--tld-class <csv>] [--has-c-level] [--has-careers-page]
+       [--has-decision-maker] [--has-investors-page] [--has-shop-page]
+       [--is-registered-entity] [--keyword <text>] [--min-headcount N]
+       [--min-source-count N] [--include-people N]
+       [--limit N] [--offset N] [--org <id>]
+
+Goldfox-sourced filters; OR within an array, AND across fields.
+seniority + email_type + min-link-confidence are people-only — silently
+ignored here.
+
+Values:
+  --confidence    high (default), low, very_low
+  --tld-class     cctld, generic, vanity, low_trust, other
+  --country       ISO 3166-1 alpha-2 (US, DE, GB, ...)
+  --keyword       substring match on domain only
+
+Examples:
+  myapi company search --country DE --is-registered-entity --has-careers-page
+  myapi company search --confidence high --min-source-count 5 --include-people 3
+  myapi company search --tld-class cctld --country FR,DE --min-headcount 10`,
+    'get': 'myapi company get <company_id> [--include-people N] [--org <id>]',
+};
+export async function run(subcommand, args, flags) {
+    if (!subcommand || (flags.help && !subcommand)) {
+        info(`Usage: myapi company <subcommand>
+
+Subcommands:
+  search    Filter companies across the Goldfox database
+  get       Get a single company (optionally with embedded people)
+
+All commands accept --org <id> (or set a default: myapi config set-org <id>).
+Filter shape is shared with people + audience — see myapi audience --help.`);
+        return;
+    }
+    if (flags.help) {
+        const usage = SUBCOMMAND_USAGE[subcommand];
+        if (usage)
+            info(`Usage: ${usage}`);
+        else
+            info(`Unknown subcommand: ${subcommand}. Run "myapi company --help" for the list.`);
+        return;
+    }
+    switch (subcommand) {
+        case 'search': return search(flags);
+        case 'get': return get(args[0], flags);
+        default: error(`Unknown subcommand: ${subcommand}. Run "myapi company --help" for valid subcommands.`);
+    }
+}

package/dist/commands/config.d.ts

@@ -1,6 +1,8 @@
 import type { FlagSchema } from '../flags.js';
 import type { Flags } from '../helpers.js';
+import type { Exposes } from '../exposes.js';
 export declare const SCHEMA: FlagSchema;
+export declare const EXPOSES: Exposes;
 export declare function setOrg(id: string, _flags: Flags, via?: string): Promise<void>;
 export declare function setFunnel(id: string, _flags: Flags, via?: string): Promise<void>;
 export declare function setDomain(domain: string, _flags: Flags, via?: string): Promise<void>;

package/dist/commands/config.js

@@ -4,6 +4,10 @@ import { success, error, info, printJson } from '../output.js';
 export const SCHEMA = {
     _via: 'string',
 };
+export const EXPOSES = [
+    'GET /hq/orgs/{org_id}',
+    'GET /funnel/orgs/{org_id}/funnels/{funnel_id}',
+];
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 export async function setOrg(id, _flags, via = 'auth config') {
     if (!id) {
@@ -16,8 +20,24 @@ export async function setOrg(id, _flags, via = 'auth config') {
     info('› Validating…');
     const org = await hq.getOrg(config.api_key, id);
     config.default_org = org.id;
+    // The previous default_funnel belongs to a different org and won't
+    // resolve under the new one — clear it. If the new org has exactly one
+    // funnel, auto-pick it so `myapi funnel push` etc. just work; otherwise
+    // leave it blank for the user to set explicitly. listFunnels failures
+    // are best-effort — if it errors we just leave default_funnel cleared.
+    delete config.default_funnel;
+    try {
+        const funnels = await sdkFunnel.listFunnels(config.api_key, org.id);
+        if (funnels.length === 1) {
+            config.default_funnel = funnels[0].id;
+        }
+    }
+    catch { /* swallow — clearing alone is still correct */ }
     saveConfig(config);
     success(`Default organization set to: ${org.name || org.id}`);
+    if (config.default_funnel) {
+        info(`  Default funnel auto-resolved to ${config.default_funnel}.`);
+    }
 }
 export async function setFunnel(id, _flags, via = 'auth config') {
     if (!id) {

package/dist/commands/crm/companies.d.ts

@@ -0,0 +1,6 @@
+import type { FlagSchema } from '../../flags.js';
+import { type Flags } from '../../helpers.js';
+import type { Exposes } from '../../exposes.js';
+export declare const EXPOSES: Exposes;
+export declare const SCHEMA: FlagSchema;
+export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/crm/companies.js

@@ -0,0 +1,193 @@
+// `myapi crm companies <subcommand>` — engaged-companies half of CRM.
+import { crm } from '@myapihq/sdk';
+import { requireConfig } from '../../config.js';
+import { success, error, info, printTable, printJson } from '../../output.js';
+import { requireOrg, requireArg } from '../../helpers.js';
+export const EXPOSES = [
+    'POST /crm/orgs/{org_id}/companies',
+    'POST /crm/orgs/{org_id}/companies/promote',
+    'POST /crm/orgs/{org_id}/companies/search',
+    'GET /crm/orgs/{org_id}/companies/{id}',
+    'PATCH /crm/orgs/{org_id}/companies/{id}',
+    'DELETE /crm/orgs/{org_id}/companies/{id}',
+];
+export const SCHEMA = {};
+function csv(v) {
+    if (typeof v !== 'string' || v.trim() === '')
+        return undefined;
+    return v.split(',').map(s => s.trim()).filter(Boolean);
+}
+function parseCustom(v) {
+    if (typeof v !== 'string' || v.trim() === '')
+        return undefined;
+    try {
+        return JSON.parse(v);
+    }
+    catch (e) {
+        error(`--custom-json is not valid JSON: ${e.message}`);
+    }
+}
+function buildSearchFilter(flags) {
+    return {
+        lifecycle_stage: csv(flags.stage),
+        source: csv(flags.source),
+        domain: typeof flags.domain === 'string' ? flags.domain : undefined,
+        include_deleted: flags['include-deleted'] === true || undefined,
+        limit: typeof flags.limit === 'number' ? flags.limit : undefined,
+        offset: typeof flags.offset === 'number' ? flags.offset : undefined,
+    };
+}
+function renderCompanies(res, flags) {
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    info(`${res.companies.length} of ${res.total} compan${res.total === 1 ? 'y' : 'ies'}`);
+    printTable(res.companies.map(c => ({
+        id: c.id,
+        domain: c.domain ?? '',
+        name: c.name ?? '',
+        stage: c.lifecycle_stage,
+        source: c.source,
+        deleted: c.deleted_at ? '✓' : '',
+    })), { flags, empty: 'No companies matched.' });
+}
+// ── Subcommands ─────────────────────────────────────────────────────────
+async function search(flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm companies search [filters...] [--org <id>]');
+    const res = await crm.searchCompanies(config.api_key, orgId, buildSearchFilter(flags));
+    renderCompanies(res, flags);
+}
+async function list(flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm companies list [--limit N] [--org <id>]');
+    const res = await crm.searchCompanies(config.api_key, orgId, {
+        limit: typeof flags.limit === 'number' ? flags.limit : undefined,
+        offset: typeof flags.offset === 'number' ? flags.offset : undefined,
+    });
+    renderCompanies(res, flags);
+}
+async function create(domainArg, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm companies create <domain> [--name <n>] [--stage <s>] [--custom-json <json>] [--org <id>]');
+    requireArg(domainArg, 'domain', 'myapi crm companies create <domain>');
+    const input = {
+        domain: domainArg,
+        name: typeof flags.name === 'string' ? flags.name : undefined,
+        lifecycle_stage: typeof flags.stage === 'string' ? flags.stage : undefined,
+        custom: parseCustom(flags['custom-json']),
+        source: 'manual',
+    };
+    const c = await crm.createCompany(config.api_key, orgId, input);
+    if (flags.json) {
+        printJson(c);
+        return;
+    }
+    success(`Company ${c.id} (${c.domain})`);
+}
+async function get(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm companies get <id> [--org <id>]');
+    requireArg(id, 'id', 'myapi crm companies get <id>');
+    const c = await crm.getCompany(config.api_key, orgId, id);
+    printJson(c);
+}
+async function update(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm companies update <id> [--stage <s>] [--name <n>] [--custom-json <json>] [--org <id>]');
+    requireArg(id, 'id', 'myapi crm companies update <id>');
+    const patch = {
+        name: typeof flags.name === 'string' ? flags.name : undefined,
+        lifecycle_stage: typeof flags.stage === 'string' ? flags.stage : undefined,
+        custom: parseCustom(flags['custom-json']),
+    };
+    const c = await crm.updateCompany(config.api_key, orgId, id, patch);
+    if (flags.json) {
+        printJson(c);
+        return;
+    }
+    success(`Company ${c.id} updated (stage=${c.lifecycle_stage})`);
+}
+async function del(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm companies delete <id> [--org <id>]');
+    requireArg(id, 'id', 'myapi crm companies delete <id>');
+    await crm.deleteCompany(config.api_key, orgId, id);
+    success(`Company ${id} soft-deleted (restore with "myapi crm companies restore ${id}")`);
+}
+async function restore(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm companies restore <id> [--org <id>]');
+    requireArg(id, 'id', 'myapi crm companies restore <id>');
+    const c = await crm.updateCompany(config.api_key, orgId, id, { deleted_at: null });
+    if (flags.json) {
+        printJson(c);
+        return;
+    }
+    success(`Company ${c.id} restored`);
+}
+// Goldfox company id IS the domain (Simon's note in routes.md).
+async function promote(domain, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm companies promote <domain> [--org <id>]');
+    requireArg(domain, 'domain', 'myapi crm companies promote <domain>');
+    const c = await crm.promoteCompany(config.api_key, orgId, domain);
+    if (flags.json) {
+        printJson(c);
+        return;
+    }
+    success(`Promoted ${c.domain} → ${c.id}`);
+}
+// ── Dispatcher ──────────────────────────────────────────────────────────
+const SUBCOMMAND_USAGE = {
+    list: 'myapi crm companies list [--limit N] [--offset N] [--org <id>] [--json]',
+    search: `myapi crm companies search [--stage <csv>] [--source <csv>] [--domain <d>]
+       [--include-deleted] [--limit N] [--offset N] [--org <id>] [--json]
+
+  --stage   cold, warm, qualified, customer, churned
+  --source  goldfox, email, pixel, webhook, manual`,
+    create: 'myapi crm companies create <domain> [--name <n>] [--stage <s>] [--custom-json <json>] [--org <id>]',
+    get: 'myapi crm companies get <id> [--org <id>]',
+    update: 'myapi crm companies update <id> [--stage <s>] [--name <n>] [--custom-json <json>] [--org <id>]',
+    delete: 'myapi crm companies delete <id> [--org <id>]',
+    restore: 'myapi crm companies restore <id> [--org <id>]',
+    promote: 'myapi crm companies promote <domain> [--org <id>]',
+};
+export async function run(subcommand, args, flags) {
+    if (!subcommand || (flags.help && !subcommand)) {
+        info(`Usage: myapi crm companies <subcommand>
+
+Subcommands:
+  list                List all companies
+  search              Filter by stage / source / domain
+  create <domain>     Manually create (source='manual')
+  get <id>            Fetch one company
+  update <id>         Patch stage, name, custom JSON
+  delete <id>         Soft-delete
+  restore <id>        Undo a soft-delete
+  promote <domain>    Promote a Goldfox company → CRM (Goldfox company id IS the domain)
+
+All commands accept --org <id> (or set default: myapi config set-org <id>).`);
+        return;
+    }
+    if (flags.help) {
+        const usage = SUBCOMMAND_USAGE[subcommand];
+        if (usage)
+            info(`Usage: ${usage}`);
+        else
+            info(`Unknown subcommand: ${subcommand}. Run "myapi crm companies --help" for the list.`);
+        return;
+    }
+    switch (subcommand) {
+        case 'list': return list(flags);
+        case 'search': return search(flags);
+        case 'create': return create(args[0], flags);
+        case 'get': return get(args[0], flags);
+        case 'update': return update(args[0], flags);
+        case 'delete': return del(args[0], flags);
+        case 'restore': return restore(args[0], flags);
+        case 'promote': return promote(args[0], flags);
+        default: error(`Unknown subcommand: ${subcommand}. Run "myapi crm companies --help" for valid subcommands.`);
+    }
+}

package/dist/commands/crm/contacts.d.ts

@@ -0,0 +1,6 @@
+import type { FlagSchema } from '../../flags.js';
+import { type Flags } from '../../helpers.js';
+import type { Exposes } from '../../exposes.js';
+export declare const EXPOSES: Exposes;
+export declare const SCHEMA: FlagSchema;
+export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/crm/contacts.js

@@ -0,0 +1,241 @@
+// `myapi crm contacts <subcommand>` — the engaged-people half of CRM.
+import { crm } from '@myapihq/sdk';
+import { requireConfig } from '../../config.js';
+import { success, error, info, printTable, printJson } from '../../output.js';
+import { requireOrg, requireArg } from '../../helpers.js';
+export const EXPOSES = [
+    'POST /crm/orgs/{org_id}/contacts',
+    'POST /crm/orgs/{org_id}/contacts/promote',
+    'POST /crm/orgs/{org_id}/contacts/search',
+    'GET /crm/orgs/{org_id}/contacts/{id}',
+    'PATCH /crm/orgs/{org_id}/contacts/{id}',
+    'DELETE /crm/orgs/{org_id}/contacts/{id}',
+    'GET /crm/orgs/{org_id}/contacts/{id}/events',
+];
+export const SCHEMA = {};
+// Comma-separated → string[]. Empty/missing → undefined so we don't send
+// empty arrays to the backend.
+function csv(v) {
+    if (typeof v !== 'string' || v.trim() === '')
+        return undefined;
+    return v.split(',').map(s => s.trim()).filter(Boolean);
+}
+function parseCustom(v) {
+    if (typeof v !== 'string' || v.trim() === '')
+        return undefined;
+    try {
+        return JSON.parse(v);
+    }
+    catch (e) {
+        error(`--custom-json is not valid JSON: ${e.message}`);
+    }
+}
+function buildSearchFilter(flags) {
+    return {
+        lifecycle_stage: csv(flags.stage),
+        source: csv(flags.source),
+        email: typeof flags.email === 'string' ? flags.email : undefined,
+        company_id: typeof flags['company-id'] === 'string' ? flags['company-id'] : undefined,
+        min_last_engagement_days: typeof flags['min-last-engagement-days'] === 'number' ? flags['min-last-engagement-days'] : undefined,
+        max_last_engagement_days: typeof flags['max-last-engagement-days'] === 'number' ? flags['max-last-engagement-days'] : undefined,
+        include_deleted: flags['include-deleted'] === true || undefined,
+        limit: typeof flags.limit === 'number' ? flags.limit : undefined,
+        offset: typeof flags.offset === 'number' ? flags.offset : undefined,
+    };
+}
+function renderContacts(res, flags) {
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    info(`${res.contacts.length} of ${res.total} contact${res.total === 1 ? '' : 's'}`);
+    printTable(res.contacts.map(c => ({
+        id: c.id,
+        email: c.email ?? '',
+        name: [c.first_name, c.last_name].filter(Boolean).join(' ') || '',
+        stage: c.lifecycle_stage,
+        source: c.source,
+        last_engagement: c.last_engagement_at ?? '',
+        deleted: c.deleted_at ? '✓' : '',
+    })), { flags, empty: 'No contacts matched.' });
+}
+// ── Subcommands ─────────────────────────────────────────────────────────
+async function search(flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm contacts search [filters...] [--org <id>]');
+    const res = await crm.searchContacts(config.api_key, orgId, buildSearchFilter(flags));
+    renderContacts(res, flags);
+}
+// `list` is `search` with no filters — separate verb for discoverability.
+async function list(flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm contacts list [--limit N] [--org <id>]');
+    const res = await crm.searchContacts(config.api_key, orgId, {
+        limit: typeof flags.limit === 'number' ? flags.limit : undefined,
+        offset: typeof flags.offset === 'number' ? flags.offset : undefined,
+    });
+    renderContacts(res, flags);
+}
+async function create(emailArg, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm contacts create <email> [--first-name <n>] [--last-name <n>] [--stage <s>] [--custom-json <json>] [--org <id>]');
+    requireArg(emailArg, 'email', 'myapi crm contacts create <email>');
+    const input = {
+        email: emailArg,
+        first_name: typeof flags['first-name'] === 'string' ? flags['first-name'] : undefined,
+        last_name: typeof flags['last-name'] === 'string' ? flags['last-name'] : undefined,
+        company_id: typeof flags['company-id'] === 'string' ? flags['company-id'] : undefined,
+        lifecycle_stage: typeof flags.stage === 'string' ? flags.stage : undefined,
+        custom: parseCustom(flags['custom-json']),
+        source: 'manual',
+    };
+    const c = await crm.createContact(config.api_key, orgId, input);
+    if (flags.json) {
+        printJson(c);
+        return;
+    }
+    success(`Contact ${c.id} (${c.email})`);
+}
+async function get(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm contacts get <id> [--org <id>]');
+    requireArg(id, 'id', 'myapi crm contacts get <id>');
+    const c = await crm.getContact(config.api_key, orgId, id);
+    printJson(c);
+}
+async function update(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm contacts update <id> [--stage <s>] [--first-name <n>] [--last-name <n>] [--company-id <id>] [--custom-json <json>] [--org <id>]');
+    requireArg(id, 'id', 'myapi crm contacts update <id>');
+    const patch = {
+        first_name: typeof flags['first-name'] === 'string' ? flags['first-name'] : undefined,
+        last_name: typeof flags['last-name'] === 'string' ? flags['last-name'] : undefined,
+        company_id: typeof flags['company-id'] === 'string' ? flags['company-id'] : undefined,
+        lifecycle_stage: typeof flags.stage === 'string' ? flags.stage : undefined,
+        custom: parseCustom(flags['custom-json']),
+    };
+    const c = await crm.updateContact(config.api_key, orgId, id, patch);
+    if (flags.json) {
+        printJson(c);
+        return;
+    }
+    success(`Contact ${c.id} updated (stage=${c.lifecycle_stage})`);
+}
+async function del(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm contacts delete <id> [--org <id>]');
+    requireArg(id, 'id', 'myapi crm contacts delete <id>');
+    await crm.deleteContact(config.api_key, orgId, id);
+    success(`Contact ${id} soft-deleted (events retained; restore with "myapi crm contacts restore ${id}")`);
+}
+async function restore(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm contacts restore <id> [--org <id>]');
+    requireArg(id, 'id', 'myapi crm contacts restore <id>');
+    const c = await crm.updateContact(config.api_key, orgId, id, { deleted_at: null });
+    if (flags.json) {
+        printJson(c);
+        return;
+    }
+    success(`Contact ${c.id} restored`);
+}
+async function promote(personId, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm contacts promote <goldfox_person_id> [--org <id>]');
+    requireArg(personId, 'goldfox_person_id', 'myapi crm contacts promote <goldfox_person_id>');
+    const c = await crm.promoteContact(config.api_key, orgId, personId);
+    if (flags.json) {
+        printJson(c);
+        return;
+    }
+    success(`Promoted to ${c.id} (${c.email})`);
+}
+async function events(id, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi crm contacts events <id> [--kind <k>] [--limit N] [--cursor <c>] [--org <id>]');
+    requireArg(id, 'id', 'myapi crm contacts events <id>');
+    const res = await crm.getContactEvents(config.api_key, orgId, id, {
+        limit: typeof flags.limit === 'number' ? flags.limit : undefined,
+        cursor: typeof flags.cursor === 'string' ? flags.cursor : undefined,
+        kind: typeof flags.kind === 'string' ? flags.kind : undefined,
+    });
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    if (res.events.length === 0) {
+        info('No events.');
+        return;
+    }
+    for (const e of res.events) {
+        const summary = JSON.stringify(e.payload);
+        info(`${e.at}  ${e.kind.padEnd(18)}  ${summary}`);
+    }
+    if (res.next_cursor)
+        info(`\n— More — pass --cursor "${res.next_cursor}" to continue`);
+}
+// ── Dispatcher ──────────────────────────────────────────────────────────
+const SUBCOMMAND_USAGE = {
+    list: 'myapi crm contacts list [--limit N] [--offset N] [--org <id>] [--json]',
+    search: `myapi crm contacts search [--stage <csv>] [--source <csv>] [--email <e>]
+       [--company-id <id>] [--min-last-engagement-days N] [--max-last-engagement-days N]
+       [--include-deleted] [--limit N] [--offset N] [--org <id>] [--json]
+
+  --stage     cold, warm, qualified, customer, churned
+  --source    goldfox, email, pixel, webhook, manual
+
+  Engagement filters:
+    --min-last-engagement-days N   contacts engaged within N days
+    --max-last-engagement-days N   contacts last engaged > N days ago (re-engagement filter).
+                                   NOTE: includes contacts with no engagement at all
+                                   (e.g. promoted-but-never-emailed leads) — that's intentional.`,
+    create: 'myapi crm contacts create <email> [--first-name <n>] [--last-name <n>] [--stage <s>] [--company-id <id>] [--custom-json <json>] [--org <id>]',
+    get: 'myapi crm contacts get <id> [--org <id>]',
+    update: 'myapi crm contacts update <id> [--stage <s>] [--first-name <n>] [--last-name <n>] [--company-id <id>] [--custom-json <json>] [--org <id>]',
+    delete: 'myapi crm contacts delete <id> [--org <id>]',
+    restore: 'myapi crm contacts restore <id> [--org <id>]',
+    promote: `myapi crm contacts promote <goldfox_person_id> [--org <id>]
+
+Promotes a Goldfox person row into your CRM (source='goldfox', stage='cold').
+Idempotent — promoting the same person twice returns the same contact.`,
+    events: 'myapi crm contacts events <id> [--kind <k>] [--limit 1..200] [--cursor <c>] [--org <id>]',
+};
+export async function run(subcommand, args, flags) {
+    if (!subcommand || (flags.help && !subcommand)) {
+        info(`Usage: myapi crm contacts <subcommand>
+
+Subcommands:
+  list                        Most-recently-engaged contacts (no filter)
+  search                      Filter by stage / source / email / engagement window
+  create <email>              Manually create (source='manual')
+  get <id>                    Fetch one contact (with embedded Goldfox enrichment, when available)
+  update <id>                 Patch stage, names, company_id, custom JSON
+  delete <id>                 Soft-delete (events retained)
+  restore <id>                Undo a soft-delete
+  promote <goldfox_person_id> Promote a Goldfox lead → CRM contact (idempotent)
+  events <id>                 Timeline of events on a contact (newest first)
+
+All commands accept --org <id> (or set default: myapi config set-org <id>).`);
+        return;
+    }
+    if (flags.help) {
+        const usage = SUBCOMMAND_USAGE[subcommand];
+        if (usage)
+            info(`Usage: ${usage}`);
+        else
+            info(`Unknown subcommand: ${subcommand}. Run "myapi crm contacts --help" for the list.`);
+        return;
+    }
+    switch (subcommand) {
+        case 'list': return list(flags);
+        case 'search': return search(flags);
+        case 'create': return create(args[0], flags);
+        case 'get': return get(args[0], flags);
+        case 'update': return update(args[0], flags);
+        case 'delete': return del(args[0], flags);
+        case 'restore': return restore(args[0], flags);
+        case 'promote': return promote(args[0], flags);
+        case 'events': return events(args[0], flags);
+        default: error(`Unknown subcommand: ${subcommand}. Run "myapi crm contacts --help" for valid subcommands.`);
+    }
+}

package/dist/commands/crm/index.d.ts

@@ -0,0 +1,6 @@
+import type { FlagSchema } from '../../flags.js';
+import type { Flags } from '../../helpers.js';
+import type { Exposes } from '../../exposes.js';
+export declare const EXPOSES: Exposes;
+export declare const SCHEMA: FlagSchema;
+export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;