Sync feature-2 and master into cli master

npm-alias/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dealmachine",
-  "version": "0.4.1-rc.1",
+  "version": "0.4.1-rc.2",
   "description": "Short install alias for the DealMachine property intelligence CLI",
   "author": "DealMachine",
   "license": "MIT",
@@ -23,7 +23,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@dealmachine/cli": "0.4.1-rc.1"
+    "@dealmachine/cli": "0.4.1-rc.2"
   },
   "engines": {
     "node": ">=18"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dealmachine/cli",
-  "version": "0.4.1-rc.1",
+  "version": "0.4.1-rc.2",
   "description": "DealMachine CLI for property intelligence, people lookup, and enrichment through the public API",
   "author": "DealMachine",
   "license": "MIT",

src/commands/prospects.ts

@@ -26,6 +26,8 @@ type Prospect = {
   record_id: string;
   lifecycle: string;
   favorite: boolean;
+  /** Read only: hot, warm, cold, follow_up, do_not_contact, or null. */
+  status?: string | null;
   source: string;
   record: {
     address?: string | null;
@@ -56,16 +58,29 @@ function recordLabel(prospect: Prospect): string {
   return place ? `${main} (${place})` : String(main);
 }
 
+const STATUS_LABELS: Record<string, string> = {
+  hot: 'Hot',
+  warm: 'Warm',
+  cold: 'Cold',
+  follow_up: 'Follow up',
+  do_not_contact: 'Do Not Contact',
+};
+
+function statusLabel(prospect: Prospect): string {
+  return prospect.status ? (STATUS_LABELS[prospect.status] ?? prospect.status) : 'None';
+}
+
 function printProspectRows(prospects: Prospect[]) {
   const rows = prospects.map((p) => ({
     id: p.id,
     record: truncate(recordLabel(p), 44),
     lifecycle: p.lifecycle,
     fav: p.favorite ? '★' : '',
+    status: statusLabel(p),
     tags: truncate(p.tags.map((tag) => tag.name).join(', ') || '—', 24),
     added: formatDate(p.created_at),
   }));
-  printTable(rows, ['id', 'record', 'lifecycle', 'fav', 'tags', 'added']);
+  printTable(rows, ['id', 'record', 'lifecycle', 'fav', 'status', 'tags', 'added']);
 }
 
 function printPagination(p: Pagination) {
@@ -138,6 +153,7 @@ export async function prospectsGet(id: string, options: { json?: boolean }): Pro
     Type: p.record_type,
     Lifecycle: p.lifecycle,
     Favorite: p.favorite ? 'Yes' : 'No',
+    Status: statusLabel(p),
     Source: p.source,
     Tags: p.tags.map((tag) => `${tag.name} (${tag.id})`).join(', ') || '—',
     Notes: String(p.note_count ?? 0),
@@ -173,6 +189,7 @@ export async function prospectsGetByRecord(options: {
     Type: p.record_type,
     Lifecycle: p.lifecycle,
     Favorite: p.favorite ? 'Yes' : 'No',
+    Status: statusLabel(p),
     Source: p.source,
     Tags: p.tags.map((tag) => `${tag.name} (${tag.id})`).join(', ') || '—',
     Added: formatDate(p.created_at),

src/index.ts

@@ -1642,7 +1642,7 @@ prospectsCmd
   .option('--source <source>', 'Filter by source, e.g. driving, import, api, cli, or mcp')
   .option('--favorites', 'Only starred prospects')
   .option('--list <listId>', 'Only members of this list')
-  .option('--tag <tagId>', 'Only prospects with this tag, e.g. tag_5')
+  .option('--tag <tagId>', 'Only prospects with this tag, e.g. tag_31')
   .option('--search <term>', 'Address words for properties; name or city for people')
   .option('--sort <order>', 'newest (default) or oldest')
   .option('-p, --page <n>', 'Page number')
@@ -1654,7 +1654,7 @@ prospectsCmd
 Examples:
   dm prospects list
   dm prospects list --source driving
-  dm prospects list --lifecycle opportunity --tag tag_1
+  dm prospects list --lifecycle opportunity --tag tag_31
   dm prospects list --record-type person --search "austin" --json`
   )
   .action(async (options) => {

src/version.ts

@@ -1,2 +1,2 @@
-export const CLI_VERSION = '0.4.1-rc.1';
+export const CLI_VERSION = '0.4.1-rc.2';
 export const CLI_USER_AGENT = `dm-cli/${CLI_VERSION}`;

tests/commands/prospects.test.ts

@@ -1,6 +1,6 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
-import { prospectsArchive, prospectsReactivate } from '../../src/commands/prospects.js';
+import { prospectsArchive, prospectsReactivate, prospectsGet } from '../../src/commands/prospects.js';
 
 vi.mock('../../src/lib/config.js', () => ({
   readConfig: () => ({ apiKey: 'fixture-only', apiEnvironment: 'staging' }),
@@ -134,3 +134,23 @@ describe('dm prospects reactivate', () => {
     expect(log.mock.calls.flat().join('\n')).toContain('Prospects Restored');
   });
 });
+
+// Public output remains usable with both the additive field and older API responses.
+describe('dm prospects status display', () => {
+  it.each([
+    ['do_not_contact', 'Do Not Contact'],
+    ['follow_up', 'Follow up'],
+    [null, 'None'],
+    [undefined, 'None'],
+  ])('shows status %s on the prospect detail', async (status, label) => {
+    fetchMock.mockResolvedValue(jsonResponse(200, { data: {
+      id: 'prospect_8812', record_type: 'property', record_id: 'prop_1',
+      lifecycle: 'active', favorite: false, status, source: 'api',
+      record: { address: '123 Main St' }, tags: [], created_at: '2026-10-13T00:00:00Z',
+    } }));
+    await prospectsGet('prospect_8812', {});
+    const printed = log.mock.calls.flat().join('\n');
+    expect(printed).toContain('Status');
+    expect(printed).toContain(label);
+  });
+});