@wavyx/pdcli 0.9.0 → 0.11.0

package/src/commands/org/list.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core'
 import BaseCommand from '../../base-command.js'
 import { collectPages } from '../../lib/pagination.js'
+import { CliError } from '../../lib/errors.js'
 
 const columns = {
   id: { header: 'ID' },
@@ -20,15 +21,52 @@ export default class OrgListCommand extends BaseCommand {
   static flags = {
     ...BaseCommand.baseFlags,
     owner: Flags.integer({ description: 'Filter by owner (user) ID' }),
+    filter: Flags.integer({ description: 'Filter by saved filter ID' }),
+    ids: Flags.string({
+      description: 'Comma-separated IDs to fetch (max 100)',
+      // The API silently drops `ids` when filter_id is present — refuse
+      // the combination instead (matches deal bulk-update).
+      exclusive: ['filter'],
+    }),
+    'sort-by': Flags.string({
+      description: 'Sort field',
+      options: ['id', 'update_time', 'add_time'],
+    }),
+    'sort-direction': Flags.string({
+      description: 'Sort direction',
+      options: ['asc', 'desc'],
+    }),
+    'updated-since': Flags.string({
+      description:
+        'Only items updated at/after this RFC3339 time (no fractional seconds)',
+    }),
+    'updated-until': Flags.string({
+      description:
+        'Only items updated before this RFC3339 time (no fractional seconds)',
+    }),
   }
 
   async run() {
     const { flags } = await this.parse(OrgListCommand)
-    const limit = flags.limit ?? 100
+    const limit = flags.limit ?? 500
+
+    const idList = flags.ids
+      ?.split(',')
+      .map((v) => v.trim())
+      .filter(Boolean)
+    if (idList && idList.length > 100) {
+      throw new CliError('--ids accepts at most 100 IDs', { exitCode: 64 })
+    }
 
     const query = {
       owner_id: flags.owner,
-      limit: Math.min(limit, 100),
+      filter_id: flags.filter,
+      ids: idList?.join(','),
+      sort_by: flags['sort-by'],
+      sort_direction: flags['sort-direction'],
+      updated_since: flags['updated-since'],
+      updated_until: flags['updated-until'],
+      limit: Math.min(limit, 500),
     }
 
     const items = await collectPages(

package/src/commands/org/relationship/add.js

@@ -0,0 +1,44 @@
+import { Flags } from '@oclif/core'
+import BaseCommand from '../../../base-command.js'
+import { outputRecord } from '../../../lib/entity-view.js'
+
+export default class OrgRelationshipAddCommand extends BaseCommand {
+  static description =
+    'Create an organization relationship. For a parent relationship the ' +
+    '--owner organization is the parent and --linked is the daughter.'
+
+  static examples = [
+    '<%= config.bin %> org relationship add --type parent --owner 1481 --linked 1480',
+    '<%= config.bin %> org relationship add --type related --owner 1 --linked 2',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    type: Flags.string({
+      required: true,
+      description: 'Relationship type',
+      options: ['parent', 'related'],
+    }),
+    owner: Flags.integer({
+      required: true,
+      description: 'Owner organization ID (the parent for type parent)',
+    }),
+    linked: Flags.integer({
+      required: true,
+      description: 'Linked organization ID (the daughter for type parent)',
+    }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(OrgRelationshipAddCommand)
+
+    const res = await this.apiClient.post('/api/v1/organizationRelationships', {
+      body: {
+        type: flags.type,
+        rel_owner_org_id: flags.owner,
+        rel_linked_org_id: flags.linked,
+      },
+    })
+    await outputRecord(this, res.data)
+  }
+}

package/src/commands/org/relationship/list.js

@@ -0,0 +1,52 @@
+import { Flags } from '@oclif/core'
+import BaseCommand from '../../../base-command.js'
+import { collectPages } from '../../../lib/pagination.js'
+
+const columns = {
+  id: { header: 'ID' },
+  type: { header: 'Type' },
+  owner: {
+    header: 'Owner Org',
+    get: (row) => row.rel_owner_org_id?.name ?? '',
+  },
+  linked: {
+    header: 'Linked Org',
+    get: (row) => row.rel_linked_org_id?.name ?? '',
+  },
+  related: {
+    header: 'Related',
+    get: (row) => row.related_organization_name ?? '',
+  },
+}
+
+export default class OrgRelationshipListCommand extends BaseCommand {
+  static description = 'List relationships for an organization'
+
+  static examples = [
+    '<%= config.bin %> org relationship list --org 1481',
+    '<%= config.bin %> org relationship list --org 1481 --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    org: Flags.integer({
+      required: true,
+      description: 'Organization ID to list relationships for',
+    }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(OrgRelationshipListCommand)
+    const limit = flags.limit ?? 500
+
+    // The endpoint takes only org_id (no server-side pagination) — the
+    // client-side cap below is what --limit actually controls.
+    const query = { org_id: flags.org }
+
+    const items = await collectPages(
+      this.apiClient.pageV1('/api/v1/organizationRelationships', query),
+      limit,
+    )
+    await this.outputResults(items, columns)
+  }
+}

package/src/commands/org/relationship/remove.js

@@ -0,0 +1,46 @@
+import { Args, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import BaseCommand from '../../../base-command.js'
+import { confirmAction } from '../../../lib/confirm.js'
+import { CliError } from '../../../lib/errors.js'
+
+export default class OrgRelationshipRemoveCommand extends BaseCommand {
+  static description = 'Delete an organization relationship'
+
+  static examples = [
+    '<%= config.bin %> org relationship remove 7',
+    '<%= config.bin %> org relationship remove 7 --yes',
+  ]
+
+  static args = {
+    id: Args.integer({
+      required: true,
+      description: 'Organization relationship ID',
+    }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    yes: Flags.boolean({
+      char: 'y',
+      description: 'Skip the confirmation prompt',
+      default: false,
+    }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(OrgRelationshipRemoveCommand)
+
+    const ok = await confirmAction(
+      `Delete organization relationship ${args.id}?`,
+      flags.yes,
+      { default: false },
+    )
+    if (!ok) {
+      throw new CliError('Aborted', { exitCode: 1 })
+    }
+
+    await this.apiClient.del(`/api/v1/organizationRelationships/${args.id}`)
+    this.log(chalk.green(`Deleted organization relationship ${args.id}`))
+  }
+}

package/src/commands/person/follower/add.js

@@ -0,0 +1,31 @@
+import { Args, Flags } from '@oclif/core'
+import BaseCommand from '../../../base-command.js'
+import { outputRecord } from '../../../lib/entity-view.js'
+
+export default class PersonFollowerAddCommand extends BaseCommand {
+  static description = 'Add a follower (user) to a person'
+
+  static examples = [
+    '<%= config.bin %> person follower add 42 --user 5',
+    '<%= config.bin %> person follower add 42 --user 5 --output json',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Person ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    user: Flags.integer({ required: true, description: 'User ID' }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(PersonFollowerAddCommand)
+
+    const res = await this.apiClient.post(
+      `/api/v2/persons/${args.id}/followers`,
+      { body: { user_id: flags.user } },
+    )
+    await outputRecord(this, res.data)
+  }
+}

package/src/commands/person/follower/list.js

@@ -0,0 +1,38 @@
+import { Args } from '@oclif/core'
+import BaseCommand from '../../../base-command.js'
+import { collectPages } from '../../../lib/pagination.js'
+
+const columns = {
+  user_id: { header: 'User' },
+  add_time: { header: 'Added' },
+}
+
+export default class PersonFollowerListCommand extends BaseCommand {
+  static description = 'List followers of a person'
+
+  static examples = [
+    '<%= config.bin %> person follower list 42',
+    '<%= config.bin %> person follower list 42 --output json',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Person ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(PersonFollowerListCommand)
+    const limit = flags.limit ?? 500
+
+    const query = { limit: Math.min(limit, 500) }
+
+    const items = await collectPages(
+      this.apiClient.pageV2(`/api/v2/persons/${args.id}/followers`, query),
+      limit,
+    )
+    await this.outputResults(items, columns)
+  }
+}

package/src/commands/person/follower/remove.js

@@ -0,0 +1,48 @@
+import { Args, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import BaseCommand from '../../../base-command.js'
+import { confirmAction } from '../../../lib/confirm.js'
+import { CliError } from '../../../lib/errors.js'
+
+export default class PersonFollowerRemoveCommand extends BaseCommand {
+  static description = 'Remove a follower from a person'
+
+  static examples = [
+    '<%= config.bin %> person follower remove 42 --user 5',
+    '<%= config.bin %> person follower remove 42 --user 5 --yes',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Person ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    user: Flags.integer({ required: true, description: 'User ID' }),
+    yes: Flags.boolean({
+      char: 'y',
+      description: 'Skip the confirmation prompt',
+      default: false,
+    }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(PersonFollowerRemoveCommand)
+
+    const ok = await confirmAction(
+      `Remove follower ${flags.user} from person ${args.id}?`,
+      flags.yes,
+      { default: false },
+    )
+    if (!ok) {
+      throw new CliError('Aborted', { exitCode: 1 })
+    }
+
+    await this.apiClient.del(
+      `/api/v2/persons/${args.id}/followers/${flags.user}`,
+    )
+    this.log(
+      chalk.green(`Removed follower ${flags.user} from person ${args.id}`),
+    )
+  }
+}

package/src/commands/person/list.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core'
 import BaseCommand from '../../base-command.js'
 import { collectPages } from '../../lib/pagination.js'
+import { CliError } from '../../lib/errors.js'
 
 function primary(list) {
   if (!Array.isArray(list) || list.length === 0) return ''
@@ -28,16 +29,53 @@ export default class PersonListCommand extends BaseCommand {
     ...BaseCommand.baseFlags,
     owner: Flags.integer({ description: 'Filter by owner (user) ID' }),
     org: Flags.integer({ description: 'Filter by organization ID' }),
+    filter: Flags.integer({ description: 'Filter by saved filter ID' }),
+    ids: Flags.string({
+      description: 'Comma-separated IDs to fetch (max 100)',
+      // The API silently drops `ids` when filter_id is present — refuse
+      // the combination instead (matches deal bulk-update).
+      exclusive: ['filter'],
+    }),
+    'sort-by': Flags.string({
+      description: 'Sort field',
+      options: ['id', 'update_time', 'add_time'],
+    }),
+    'sort-direction': Flags.string({
+      description: 'Sort direction',
+      options: ['asc', 'desc'],
+    }),
+    'updated-since': Flags.string({
+      description:
+        'Only items updated at/after this RFC3339 time (no fractional seconds)',
+    }),
+    'updated-until': Flags.string({
+      description:
+        'Only items updated before this RFC3339 time (no fractional seconds)',
+    }),
   }
 
   async run() {
     const { flags } = await this.parse(PersonListCommand)
-    const limit = flags.limit ?? 100
+    const limit = flags.limit ?? 500
+
+    const idList = flags.ids
+      ?.split(',')
+      .map((v) => v.trim())
+      .filter(Boolean)
+    if (idList && idList.length > 100) {
+      throw new CliError('--ids accepts at most 100 IDs', { exitCode: 64 })
+    }
 
     const query = {
       owner_id: flags.owner,
       org_id: flags.org,
-      limit: Math.min(limit, 100),
+      filter_id: flags.filter,
+      ids: idList?.join(','),
+      sort_by: flags['sort-by'],
+      sort_direction: flags['sort-direction'],
+      updated_since: flags['updated-since'],
+      updated_until: flags['updated-until'],
+      limit: Math.min(limit, 500),
     }
 
     const items = await collectPages(

package/src/commands/product/list.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core'
 import BaseCommand from '../../base-command.js'
 import { collectPages } from '../../lib/pagination.js'
+import { CliError } from '../../lib/errors.js'
 
 const columns = {
   id: { header: 'ID' },
@@ -25,15 +26,47 @@ export default class ProductListCommand extends BaseCommand {
   static flags = {
     ...BaseCommand.baseFlags,
     owner: Flags.integer({ description: 'Filter by owner (user) ID' }),
+    filter: Flags.integer({ description: 'Filter by saved filter ID' }),
+    ids: Flags.string({
+      description: 'Comma-separated IDs to fetch (max 100)',
+      // The API silently drops `ids` when filter_id is present — refuse
+      // the combination instead (matches deal bulk-update).
+      exclusive: ['filter'],
+    }),
+    'sort-by': Flags.string({
+      description: 'Sort field',
+      options: ['id', 'name', 'add_time', 'update_time'],
+    }),
+    'sort-direction': Flags.string({
+      description: 'Sort direction',
+      options: ['asc', 'desc'],
+    }),
+    'updated-since': Flags.string({
+      description:
+        'Only items updated at/after this RFC3339 time (no fractional seconds)',
+    }),
   }
 
   async run() {
     const { flags } = await this.parse(ProductListCommand)
-    const limit = flags.limit ?? 100
+    const limit = flags.limit ?? 500
+
+    const idList = flags.ids
+      ?.split(',')
+      .map((v) => v.trim())
+      .filter(Boolean)
+    if (idList && idList.length > 100) {
+      throw new CliError('--ids accepts at most 100 IDs', { exitCode: 64 })
+    }
 
     const query = {
       owner_id: flags.owner,
-      limit: Math.min(limit, 100),
+      filter_id: flags.filter,
+      ids: idList?.join(','),
+      sort_by: flags['sort-by'],
+      sort_direction: flags['sort-direction'],
+      updated_since: flags['updated-since'],
+      limit: Math.min(limit, 500),
     }
 
     const items = await collectPages(

package/src/commands/project/list.js

@@ -1,3 +1,4 @@
+import { Flags } from '@oclif/core'
 import BaseCommand from '../../base-command.js'
 import { collectPages } from '../../lib/pagination.js'
 
@@ -20,6 +21,10 @@ export default class ProjectListCommand extends BaseCommand {
 
   static flags = {
     ...BaseCommand.baseFlags,
+    archived: Flags.boolean({
+      description: 'List archived projects instead of active ones',
+      default: false,
+    }),
   }
 
   async run() {
@@ -30,10 +35,11 @@ export default class ProjectListCommand extends BaseCommand {
       limit: Math.min(limit, 100),
     }
 
-    const items = await collectPages(
-      this.apiClient.pageV2('/api/v2/projects', query),
-      limit,
-    )
+    // Archived projects share the same cursor pager as active projects.
+    const path = flags.archived
+      ? '/api/v2/projects/archived'
+      : '/api/v2/projects'
+    const items = await collectPages(this.apiClient.pageV2(path, query), limit)
     await this.outputResults(items, columns)
   }
 }

package/src/commands/search.js

@@ -11,6 +11,15 @@ const columns = {
   },
 }
 
+// Item types that have a dedicated v2 scoped-search endpoint (narrower OAuth
+// scope, narrower scope + 500-row pages vs itemSearch). Singular type → scoped endpoint path.
+const SCOPED_PATHS = {
+  deal: '/api/v2/deals/search',
+  person: '/api/v2/persons/search',
+  organization: '/api/v2/organizations/search',
+  product: '/api/v2/products/search',
+}
+
 export default class SearchCommand extends BaseCommand {
   static description =
     'Search across deals, persons, organizations, products, leads, files, and projects'
@@ -18,6 +27,7 @@ export default class SearchCommand extends BaseCommand {
   static examples = [
     '<%= config.bin %> search "acme"',
     '<%= config.bin %> search "acme" --item-types deal,person --output json',
+    '<%= config.bin %> search "acme" --item-types deal --status open',
   ]
 
   static args = {
@@ -34,6 +44,16 @@ export default class SearchCommand extends BaseCommand {
       description: 'Exact match (allows 1-character terms)',
       default: false,
     }),
+    status: Flags.string({
+      description: 'Filter by deal status (only with --item-types deal)',
+      options: ['open', 'won', 'lost'],
+    }),
+    person: Flags.integer({
+      description: 'Filter by person ID (only with --item-types deal)',
+    }),
+    org: Flags.integer({
+      description: 'Filter by organization ID (only with --item-types deal)',
+    }),
   }
 
   async run() {
@@ -47,15 +67,52 @@ export default class SearchCommand extends BaseCommand {
       )
     }
 
-    // Search costs 40 rate-limit tokens — single request, no auto-paging.
-    const body = await this.apiClient.get('/api/v2/itemSearch', {
-      query: {
-        term: args.term,
-        item_types: flags['item-types'],
-        exact_match: flags.exact ? true : undefined,
-        limit: flags.limit,
-      },
-    })
+    // A single routable item type uses the scoped endpoint; everything else
+    // (multi-type, no type, or a non-routable type like lead/file) stays on
+    // the generic itemSearch wrapper.
+    const types = flags['item-types']
+      ?.split(',')
+      .map((t) => t.trim())
+      .filter(Boolean)
+    const scopedType =
+      types?.length === 1 && SCOPED_PATHS[types[0]] ? types[0] : undefined
+
+    // --status/--person/--org narrow deal searches only and are accepted only
+    // when routing to the deals/search endpoint.
+    if (
+      (flags.status != null || flags.person != null || flags.org != null) &&
+      scopedType !== 'deal'
+    ) {
+      throw new CliError(
+        '--status, --person, and --org are valid only with --item-types deal',
+        { exitCode: 64 },
+      )
+    }
+
+    let body
+    if (scopedType) {
+      // Search costs 20 rate-limit tokens — single request, no auto-paging.
+      body = await this.apiClient.get(SCOPED_PATHS[scopedType], {
+        query: {
+          term: args.term,
+          exact_match: flags.exact ? true : undefined,
+          status: scopedType === 'deal' ? flags.status : undefined,
+          person_id: scopedType === 'deal' ? flags.person : undefined,
+          organization_id: scopedType === 'deal' ? flags.org : undefined,
+          limit: flags.limit,
+        },
+      })
+    } else {
+      // Search costs 20 rate-limit tokens — single request, no auto-paging.
+      body = await this.apiClient.get('/api/v2/itemSearch', {
+        query: {
+          term: args.term,
+          item_types: flags['item-types'],
+          exact_match: flags.exact ? true : undefined,
+          limit: flags.limit,
+        },
+      })
+    }
 
     const items = (body.data?.items ?? []).map((entry) => ({
       ...entry.item,

package/src/commands/task/create.js

@@ -0,0 +1,44 @@
+import { Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { buildWriteBody } from '../../lib/input.js'
+import { outputRecord } from '../../lib/entity-view.js'
+
+export default class TaskCreateCommand extends BaseCommand {
+  static description = 'Create a task'
+
+  static examples = [
+    '<%= config.bin %> task create --title "Write spec" --project 3',
+    '<%= config.bin %> task create --title "Subtask" --project 3 --parent 5 --assignee 7',
+    '<%= config.bin %> task create --title "Raw" --project 3 --body \'{"priority":5}\'',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    title: Flags.string({ required: true, description: 'Task title' }),
+    project: Flags.integer({ required: true, description: 'Project ID' }),
+    description: Flags.string({ description: 'Task description' }),
+    assignee: Flags.integer({ description: 'Assignee (user) ID' }),
+    'due-date': Flags.string({ description: 'Due date (YYYY-MM-DD)' }),
+    parent: Flags.integer({ description: 'Parent task ID' }),
+    body: Flags.string({ description: 'Raw JSON body to merge (flags win)' }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(TaskCreateCommand)
+
+    const body = buildWriteBody({
+      typed: {
+        title: flags.title,
+        project_id: flags.project,
+        description: flags.description,
+        assignee_id: flags.assignee,
+        due_date: flags['due-date'],
+        parent_task_id: flags.parent,
+      },
+      rawBody: flags.body,
+    })
+
+    const res = await this.apiClient.post('/api/v2/tasks', { body })
+    await outputRecord(this, res.data)
+  }
+}

package/src/commands/task/delete.js

@@ -0,0 +1,41 @@
+import { Args, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import BaseCommand from '../../base-command.js'
+import { confirmAction } from '../../lib/confirm.js'
+import { CliError } from '../../lib/errors.js'
+
+export default class TaskDeleteCommand extends BaseCommand {
+  static description = 'Delete a task'
+
+  static examples = [
+    '<%= config.bin %> task delete 7',
+    '<%= config.bin %> task delete 7 --yes',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Task ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    yes: Flags.boolean({
+      char: 'y',
+      description: 'Skip the confirmation prompt',
+      default: false,
+    }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(TaskDeleteCommand)
+
+    const ok = await confirmAction(`Delete task ${args.id}?`, flags.yes, {
+      default: false,
+    })
+    if (!ok) {
+      throw new CliError('Aborted', { exitCode: 1 })
+    }
+
+    await this.apiClient.del(`/api/v2/tasks/${args.id}`)
+    this.log(chalk.green(`Deleted task ${args.id}`))
+  }
+}