linkedin-automation-cli 1.0.0

package/docs/superpowers/plans/2026-03-15-profile-extraction-plan.md

@@ -0,0 +1,943 @@
+# LinkedIn Profile Extraction Implementation Plan
+
+> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Add LinkedIn profile data extraction feature with CLI command support**Architecture:** Create `LinkedInProfile` class using existing `SelectorEngine` pattern, multi-layer selectors for and result types following existing conventions
+**Tech Stack:** TypeScript, Playwright, Vitest, Commander.js
+
+---
+
+## Chunk 1: Foundation
+
+### Task 1: Add Types
+
+**Files:**
+- Modify: `src/types/index.ts`
+- Test: `src/types/index.test.ts`
+
+- [ ] **Step 1: Write failing test**
+
+```typescript
+// src/types/index.test.ts
+import { describe, it, expect } from 'vitest';
+import type { ProfileData, ProfileExtractionOptions, ProfileExtractionResult } from '../types';
+
+describe('Profile Types', () => {
+  it('should allow valid ProfileData', () => {
+    const data: ProfileData = {
+      full_name: 'John Doe',
+      headline: 'Engineer at Company',
+      location: 'San Francisco',
+      current_company: 'Company',
+      current_title: 'Engineer',
+      company_linkedin_url: 'https://linkedin.com/company/x',
+      years_experience: 5,
+      email: 'john@example.com',
+      phone: '+1234567890',
+      profile_url: 'https://www.linkedin.com/in/johndoe',
+    };
+    expect(data.full_name).toBe('John Doe');
+  });
+
+  it('should allow null optional fields', () => {
+    const data: ProfileData = {
+      full_name: 'Jane Doe',
+      headline: '',
+      location: '',
+      current_company: null,
+      current_title: null,
+      company_linkedin_url: null,
+      years_experience: null,
+      email: null,
+      phone: null,
+      profile_url: 'https://www.linkedin.com/in/janedoe',
+    };
+    expect(data.current_company).toBeNull();
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+```bash
+npm test --grep "Profile Types"
+```
+
+Expected: FAIL (module not found)
+
+- [ ] **Step 3: Add types to src/types/index.ts**
+
+```typescript
+// Append to src/types/index.ts (after existing types)
+
+// ============================================================================
+// Profile Extraction Types
+// ============================================================================
+
+/**
+ * Profile data extracted from a LinkedIn profile
+ */
+export interface ProfileData {
+  // Top card fields
+  full_name: string;
+  headline: string;
+  location: string;
+
+  // Experience section
+  current_company: string | null;
+  current_title: string | null;
+  company_linkedin_url: string | null;
+
+  // Calculated
+  years_experience: number | null;
+
+  // Contact info (optional - requires clicking to reveal)
+  email: string | null;
+  phone: string | null;
+
+  // Reference
+  profile_url: string; // Canonical URL after LinkedIn redirects
+}
+
+/**
+ * Options for profile extraction
+ */
+export interface ProfileExtractionOptions {
+  profileUrl: string;
+  includeContact?: boolean;
+  timeout?: number;
+}
+
+/**
+ * Result of profile extraction following existing pattern
+ */
+export interface ProfileExtractionResult {
+  success: boolean;
+  message: string;
+  data?: ProfileData;
+  error?: string;
+}
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+```bash
+npm test --grep "Profile Types"
+```
+
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/types/index.ts src/types/index.test.ts
+git commit -m "feat: add ProfileData and related types
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>"
+```
+
+---
+
+### Task 2: Add Profile Selectors
+
+**Files:**
+- Modify: `src/linkedin/selectors.ts`
+
+- [ ] **Step 1: Add profile selectors to Add to `src/linkedin/selectors.ts` inside the `SELECTORS` object (after `connection`):
+
+```typescript
+  profile: {
+    // Top card
+    name: [
+      'h1.text-heading-xlarge',
+      '[data-testid="top-card-profile-name"]',
+      '.pv-top-card .text-heading-xlarge',
+      'section.artdeco-card h1',
+    ],
+    headline: [
+      '.text-body-medium',
+      '[data-testid="top-card-profile-headline"]',
+      '.pv-top-card .text-body-medium',
+    ],
+    location: [
+      '.text-body-small.inline.t-black--light',
+      '[data-testid="top-card-profile-location"]',
+      '.pv-top-card .text-body-small',
+    ],
+
+    // Experience section
+    experienceSection: [
+      '#experience',
+      'section[id*="experience"]',
+      '[data-testid="experience-section"]',
+    ],
+    experienceList: [
+      '.pv-profile-section__list-item',
+      '[data-testid="experience-item"]',
+      'li[class*="experience"]',
+    ],
+    experienceTitle: [
+      '.pv-entity__secondary-title',
+      '[data-testid="experience-title"]',
+      'span[aria-hidden="true"]',
+    ],
+    experienceCompany: [
+      '.pv-entity__company-summary-info',
+      '[data-testid="experience-company"]',
+      'a[href*="/company/"]',
+    ],
+    experienceDuration: [
+      '.pv-entity__date-range',
+      '[data-testid="experience-duration"]',
+      'span[class*="date-range"]',
+    ],
+    companyLink: [
+      'a[href*="/company/"]',
+      '[data-testid="company-link"]',
+    ],
+
+    // Contact info
+    contactInfoButton: [
+      'a[href*="contact-info"]',
+      'button[aria-label*="contact info" i]',
+      '[data-control-name="contact_see_more"]',
+    ],
+    contactInfoPanel: [
+      '.pv-contact-info',
+      '[data-testid="contact-info-panel"]',
+      '.artdeco-modal__content',
+    ],
+    contactInfoCloseButton: [
+      '.artdeco-modal__dismiss',
+      'button[aria-label*="Dismiss"]',
+      'button[aria-label*="Close"]',
+      '[data-testid="modal-close"]',
+    ],
+    email: [
+      'a[href^="mailto:"]',
+      '[data-testid="contact-email"]',
+      '.pv-contact-info__contact-type[href*="mailto"]',
+    ],
+    phone: [
+      'a[href^="tel:"]',
+      '[data-testid="contact-phone"]',
+      '.pv-contact-info__contact-type[href*="tel"]',
+    ],
+  } as const,
+```
+
+- [ ] **Step 2: Verify build**
+
+```bash
+npm run build
+```
+
+Expected: PASS
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/linkedin/selectors.ts
+git commit -m "feat: add profile selectors
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>"
+```
+
+---
+
+### Task 3: Add Environment Variable
+
+**Files:**
+- Modify: `.env.example`
+
+- [ ] **Step 1: Add PAGE_AGENT_CDP_PORT**
+
+```bash
+# Append to .env.example
+echo "" >> .env.example
+echo "# Page Agent CDP Port (default: 9222)" >> .env.example
+echo "PAGE_AGENT_CDP_PORT=9222" >> .env.example
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add .env.example
+git commit -m "docs: add PAGE_AGENT_CDP_PORT to env example
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>"
+```
+
+---
+
+## Chunk 2: Core Implementation
+
+### Task 4: Implement LinkedInProfile Class
+
+**Files:**
+- Create: `src/linkedin/profile.ts`
+- Create: `src/linkedin/profile.test.ts`
+
+- [ ] **Step 1: Write failing test**
+
+```typescript
+// src/linkedin/profile.test.ts
+import { describe, it, expect } from 'vitest';
+import {
+  LinkedInProfile,
+  validateProfileUrl,
+  parseDurationString,
+  calculateTotalExperience
+} from './profile';
+
+describe('LinkedInProfile', () => {
+  it('should be defined', () => {
+    expect(LinkedInProfile).toBeDefined();
+  });
+});
+
+describe('validateProfileUrl', () => {
+  it('should accept valid LinkedIn profile URLs', () => {
+    const validUrls = [
+      'https://www.linkedin.com/in/johndoe/',
+      'https://linkedin.com/in/jane-doe-123/',
+      'http://www.linkedin.com/in/user',
+    ];
+    validUrls.forEach(url => {
+      expect(validateProfileUrl(url)).toBe(true);
+    });
+  });
+
+  it('should reject invalid URLs', () => {
+    const invalidUrls = [
+      'https://www.google.com/',
+      'https://linkedin.com/company/test',
+      'not-a-url',
+      '',
+    ];
+    invalidUrls.forEach(url => {
+      expect(validateProfileUrl(url)).toBe(false);
+    });
+  });
+});
+
+describe('parseDurationString', () => {
+  it('should parse "Present" duration', () => {
+    const result = parseDurationString('Jan 2020 - Present (5 yrs 3 mos)');
+    expect(result).not.toBeNull();
+    expect(result!.years).toBe(5);
+    expect(result!.endDate).toBeNull();
+  });
+
+  it('should parse range duration', () => {
+    const result = parseDurationString('Mar 2019 - Dec 2021 (2 yr 10 mos)');
+    expect(result).not.toBeNull();
+    expect(result!.years).toBe(1); // Uses the10 from "(2 yr 10 mos)"
+  });
+
+  it('should parse year-only duration', () => {
+    const result = parseDurationString('2018 - 2022 (4 years)');
+    expect(result).not.toBeNull();
+    expect(result!.years).toBe(4);
+  });
+
+  it('should return null for invalid duration', () => {
+    expect(parseDurationString('invalid')).toBeNull();
+    expect(parseDurationString('')).toBeNull();
+  });
+});
+
+describe('calculateTotalExperience', () => {
+  it('should sum years from durations', () => {
+    const durations = [
+      { startDate: new Date(), endDate: null, years: 5 },
+      { startDate: new Date(), endDate: new Date(), years: 3 },
+    ];
+    expect(calculateTotalExperience(durations)).toBe(8);
+  });
+
+  it('should return 0 for empty array', () => {
+    expect(calculateTotalExperience([])).toBe(0);
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+```bash
+npm test --grep "LinkedInProfile"
+```
+
+Expected: FAIL (module not found)
+
+- [ ] **Step 3: Write implementation**
+
+```typescript
+// src/linkedin/profile.ts
+import type { Page } from 'playwright';
+import { SelectorEngine } from './selector-engine';
+import { SELECTORS } from './selectors';
+import type {
+  ProfileData,
+  ProfileExtractionOptions
+  ProfileExtractionResult
+} from '../types';
+
+// ============================================================================
+// URL Validation
+// ============================================================================
+
+const LINKEDIN_PROFILE_URL_REGEX = /^https?:\/\/(?:www\.)?linkedin\.com\/in\/[^\/]+\/?$/;
+
+export function validateProfileUrl(url: string): boolean {
+  return LINKEDIN_PROFILE_URL_REGEX.test(url);
+}
+
+// ============================================================================
+// Duration Parsing
+// ============================================================================
+
+interface ParsedDuration {
+  startDate: Date;
+  endDate: Date | null;
+  years: number;
+}
+
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+
+function parseMonthYear(text: string): Date {
+  const parts = text.trim().split(/\s+/);
+  const monthName = parts[0];
+  const year = parseInt(parts[1], 10);
+  const month = MONTHS.indexOf(monthName);
+  return new Date(year, month, 1);
+}
+
+export function parseDurationString(durationText: string): ParsedDuration | null {
+  if (!durationText || durationText.trim().length === 0) {
+    return null;
+  }
+
+  const text = durationText.trim();
+
+  // Pattern: "Jan 2020 - Present (5 yrs 3 mos)"
+  const presentPattern = /^(\w+\s+\d{4})\s*-\s*Present\s*\((\d+)\s*yrs?\s*(?:\d+\s*mos?)?\)$/i;
+  // Pattern: "Mar 2019 - Dec 2021 (2 yr 10 mos)"
+  const rangePattern = /^(\w+\s+\d{4})\s*-\s*(\w+\s+\d{4})\s*\((\d+)\s*(?:yrs?|years?)\s*(?:\d+\s*mos?)?\)$/i;
+  // Pattern: "2018 - 2022 (4 years)"
+  const yearOnlyPattern = /^(\d{4})\s*-\s*(\d{4})\s*\((\d+)\s*years?\)$/i;
+
+  let match = text.match(presentPattern);
+  if (match) {
+    const startDate = parseMonthYear(match[1]);
+    const years = parseInt(match[2], 10);
+    return { startDate, endDate: null, years };
+  }
+
+  match = text.match(rangePattern);
+  if (match) {
+    const startDate = parseMonthYear(match[1]);
+    const endDate = parseMonthYear(match[2]);
+    const years = parseInt(match[3], 10);
+    return { startDate, endDate, years };
+  }
+
+  match = text.match(yearOnlyPattern);
+  if (match) {
+    const startDate = new Date(parseInt(match[1], 10), 0, 1);
+    const endDate = new Date(parseInt(match[2], 10), 11, 31);
+    const years = parseInt(match[3], 10);
+    return { startDate, endDate, years };
+  }
+
+  return null;
+}
+
+export function calculateTotalExperience(durations: ParsedDuration[]): number {
+  return durations.reduce((total, d) => total + d.years, 0);
+}
+
+// ============================================================================
+// LinkedInProfile Class
+// ============================================================================
+
+/**
+ * LinkedInProfile class for extracting structured data from LinkedIn profiles.
+ * Uses SelectorEngine with multi-layer fallbacks for resilience.
+ */
+export class LinkedInProfile {
+  private page: Page;
+  private selectorEngine: SelectorEngine;
+
+  constructor(page: Page) {
+    this.page = page;
+    this.selectorEngine = new SelectorEngine(page);
+  }
+
+  /**
+   * Extract profile data from a LinkedIn profile URL.
+   */
+  async extract(options: ProfileExtractionOptions): Promise<ProfileExtractionResult> {
+    const timeout = options.timeout ?? 30000;
+
+    // Validate URL
+    if (!validateProfileUrl(options.profileUrl)) {
+      return {
+        success: false,
+        message: 'Invalid LinkedIn profile URL',
+        error: 'URL must match pattern: https://www.linkedin.com/in/{username}/',
+      };
+    }
+
+    try {
+      // Navigate to profile
+      await this.page.goto(options.profileUrl, {
+        waitUntil: 'domcontentloaded',
+        timeout,
+      });
+      await this.page.waitForTimeout(3000);
+
+      // Extract top card data
+      const fullName = await this.extractText('profile', 'name');
+      if (!fullName) {
+        return {
+          success: false,
+          message: 'Could not extract profile name',
+          error: 'Profile name not found on page',
+        };
+      }
+
+      const headline = await this.extractText('profile', 'headline');
+      const location = await this.extractText('profile', 'location');
+
+      // Extract experience data
+      const experienceData = await this.extractExperienceData();
+
+      // Extract contact info if requested
+      let email: string | null = null;
+      let phone: string | null = null;
+      if (options.includeContact) {
+        const contactInfo = await this.extractContactInfo();
+        email = contactInfo.email;
+        phone = contactInfo.phone;
+      }
+
+      const profileData: ProfileData = {
+        full_name: fullName,
+        headline: headline ?? '',
+        location: location ?? '',
+        current_company: experienceData.currentCompany,
+        current_title: experienceData.currentTitle,
+        company_linkedin_url: experienceData.companyUrl,
+        years_experience: experienceData.yearsExperience,
+        email,
+        phone,
+        profile_url: this.page.url(),
+      };
+
+      return {
+        success: true,
+        message: 'Profile extracted successfully',
+        data: profileData
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+      return {
+        success: false,
+        message: errorMessage,
+        error: errorMessage
+      };
+    }
+  }
+
+  /**
+   * Extract text using selector engine with fallbacks
+   */
+  private async extractText(
+    category: 'profile',
+    key: keyof typeof SELECTORS.profile
+  ): Promise<string | null> {
+    const result = await this.selectorEngine.findElement(category, key, { timeout: 5000 });
+    if (!result.element) {
+      return null;
+    }
+    const text = await result.element.textContent();
+    return text?.trim() || null;
+  }
+
+  /**
+   * Extract experience data from the profile
+   */
+  private async extractExperienceData(): Promise<{
+    currentCompany: string | null;
+    currentTitle: string | null;
+    companyUrl: string | null;
+    yearsExperience: number | null;
+  }> {
+    // Find experience section
+    const sectionResult = await this.selectorEngine.findElement('profile', 'experienceSection', { timeout: 5000 });
+    if (!sectionResult.element) {
+    return { currentCompany: null, currentTitle: null, companyUrl: null, yearsExperience: null };
+    }
+
+    // Get first experience item
+    const items = await this.page.$$(SELECTORS.profile.experienceList.join(', '));
+    if (items.length === 0) {
+      return { currentCompany: null, currentTitle: null, companyUrl: null, yearsExperience: null };
+    }
+
+    const firstItem = items[0];
+
+    // Extract title
+    let currentTitle: string | null = null;
+    for (const selector of SELECTORS.profile.experienceTitle) {
+      try {
+        const titleEl = await firstItem.$(selector);
+        if (titleEl) {
+          const text = await titleEl.textContent();
+          if (text?.trim()) {
+            currentTitle = text.trim();
+            break;
+          }
+        }
+      } catch {
+        // Try next selector
+      }
+    }
+
+    // Extract company and    let currentCompany: string | null = null;
+    let companyUrl: string | null = null;
+    for (const selector of SELECTORS.profile.experienceCompany) {
+      try {
+        const companyEl = await firstItem.$(selector);
+        if (companyEl) {
+          const text = await companyEl.textContent();
+          if (text?.trim()) {
+            currentCompany = text.trim();
+          }
+          // Try to get company link
+          const linkEl = await companyEl.$('a[href*="/company/"]');
+          if (linkEl) {
+            companyUrl = await linkEl.getAttribute('href');
+          }
+          if (currentCompany) break;
+        }
+      } catch {
+        // Try next selector
+      }
+    }
+
+    // Extract duration for years calculation
+    let yearsExperience: number | null = null;
+    for (const selector of SELECTORS.profile.experienceDuration) {
+      try {
+        const durationEl = await firstItem.$(selector);
+        if (durationEl) {
+          const durationText = await durationEl.textContent();
+          const parsed = parseDurationString(durationText || '');
+          if (parsed) {
+            yearsExperience = parsed.years;
+            break;
+          }
+        }
+      } catch {
+        // Try next selector
+      }
+    }
+
+    return { currentCompany, currentTitle, companyUrl, yearsExperience };
+  }
+
+  /**
+   * Extract contact info by clicking the contact info button
+   */
+  private async extractContactInfo(): Promise<{ email: string | null; phone: string | null }> {
+    // Click contact info button
+    const buttonResult = await this.selectorEngine.findElement('profile', 'contactInfoButton', { timeout: 5000 });
+    if (!buttonResult.element) {
+      return { email: null, phone: null };
+    }
+
+    await buttonResult.element.click();
+    await this.page.waitForTimeout(2000);
+
+    // Extract email and phone
+    const email = await this.extractText('profile', 'email');
+    const phone = await this.extractText('profile', 'phone');
+
+    // Close modal
+    const closeResult = await this.selectorEngine.findElement('profile', 'contactInfoCloseButton', { timeout: 2000 });
+    if (closeResult.element) {
+      await closeResult.element.click();
+    } else {
+      await this.page.keyboard.press('Escape');
+    }
+    await this.page.waitForTimeout(1000);
+
+    return { email, phone };
+  }
+}
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+```bash
+npm test --grep "LinkedInProfile"
+```
+
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/linkedin/profile.ts src/linkedin/profile.test.ts
+git commit -m "feat: implement LinkedInProfile class
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>"
+```
+
+---
+
+## Chunk 3: CLI Commands
+
+### Task 5: Add CLI Commands
+
+**Files:**
+- Create: `src/cli/profile.ts`
+- Create: `src/cli/profile.test.ts`
+- Modify: `src/cli/index.ts`
+
+- [ ] **Step 1: Write failing test**
+
+```typescript
+// src/cli/profile.test.ts
+import { describe, it, expect } from 'vitest';
+import { Command } from 'commander';
+import { registerProfileCommands } from './profile';
+
+describe('registerProfileCommands', () => {
+  it('should register profile command', () => {
+    const program = new Command();
+    registerProfileCommands(program);
+
+    const commands = program.commands;
+    expect(commands.some(c => c.name() === 'profile')).toBe(true);
+  });
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+```bash
+npm test --grep "registerProfileCommands"
+```
+
+Expected: FAIL (module not found)
+
+- [ ] **Step 3: Write CLI implementation**
+
+```typescript
+// src/cli/profile.ts
+import { Command } from 'commander';
+import { BrowserController } from '../core/browser';
+import { LinkedInProfile } from '../linkedin/profile';
+import { getAuditLogger } from '../core/audit';
+import type { ProfileData } from '../types';
+
+const CDP_PORT = parseInt(process.env.PAGE_AGENT_CDP_PORT || '9222', 10);
+
+export function registerProfileCommands(program: Command): void {
+  const profile = program.command('profile').description('LinkedIn profile commands');
+
+  profile
+    .command('get <url>')
+    .description('Extract profile data from a LinkedIn URL')
+    .option('--include-contact', 'Extract contact info (email, phone)')
+    .option('--json', 'Output as JSON')
+    .option('--no-cdp', 'Do not connect to existing browser via CDP')
+    .option('--cdp-port <port>', 'CDP port number', String(CDP_PORT))
+    .action(async (url: string, options) => {
+      const browser = new BrowserController();
+
+      try {
+        // Initialize browser
+        await browser.init({
+          connectToCDP: !options.noCdp,
+          cdpPort: parseInt(options.cdpPort, 10),
+          headless: false,
+        });
+
+        const page = browser.getPage();
+        if (!page) {
+          console.error('Failed to get page from browser');
+          process.exit(1);
+        }
+
+        const extractor = new LinkedInProfile(page);
+
+        // Extract profile
+        const result = await extractor.extract({
+          profileUrl: url,
+          includeContact: options.includeContact,
+        });
+
+        // Log audit
+        await getAuditLogger().log({
+          action: 'profile_extract',
+          details: {
+            profileUrl: url,
+            includeContact: options.includeContact ?? false,
+            success: result.success,
+            extractedFields: result.data
+              ? (Object.keys(result.data) as (keyof ProfileData)[]).filter(
+                  (k) => result.data![k] !== null
+                )
+              : [],
+          },
+          success: result.success,
+          error: result.error,
+        });
+
+        if (result.success && result.data) {
+          if (options.json) {
+            console.log(JSON.stringify(result.data, null, 2));
+          } else {
+            printProfileOutput(result.data, options.includeContact);
+          }
+        } else {
+          console.error(`Error: ${result.error}`);
+          process.exit(1);
+        }
+      } finally {
+        await browser.close();
+      }
+    });
+}
+
+/**
+ * Print profile data in human-readable format
+ */
+function printProfileOutput(data: ProfileData, includeContact?: boolean): void {
+  console.log(`\nProfile: ${data.full_name}`);
+  console.log('━'.repeat(50));
+  console.log(`Headline:      ${data.headline || 'N/A'}`);
+  console.log(`Location:      ${data.location || 'N/A'}`);
+  console.log(`Company:       ${data.current_company ?? 'N/A'}`);
+  console.log(`Title:         ${data.current_title ?? 'N/A'}`);
+  console.log(`Company URL:   ${data.company_linkedin_url ?? 'N/A'}`);
+  console.log(`Experience:    ${data.years_experience !== null ? `${data.years_experience} years` : 'N/A'}`);
+
+  if (includeContact) {
+    console.log(`Email:         ${data.email ?? 'Not available'}`);
+    console.log(`Phone:         ${data.phone ?? 'Not available'}`);
+  } else {
+    console.log(`Email:         (use --include-contact to reveal)`);
+    console.log(`Phone:         (use --include-contact to reveal)`);
+  }
+}
+```
+
+- [ ] **Step 4: Update src/cli/index.ts exports**
+
+```typescript
+// Add to src/cli/index.ts
+export { registerProfileCommands } from './profile';
+```
+
+- [ ] **Step 5: Run test to verify it passes**
+
+```bash
+npm test --grep "registerProfileCommands"
+```
+
+Expected: PASS
+
+- [ ] **Step 6: Run build**
+
+```bash
+npm run build
+```
+
+Expected: PASS
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add src/cli/profile.ts src/cli/profile.test.ts src/cli/index.ts
+git commit -m "feat: add profile CLI commands
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>"
+```
+
+---
+
+## Chunk 4: Finalization
+
+### Task 6: Run Full Test Suite
+
+- [ ] **Step 1: Run all tests**
+
+```bash
+npm test
+```
+
+Expected: All tests pass
+
+- [ ] **Step 2: Run type check**
+
+```bash
+npm run typecheck
+```
+
+Expected: No errors
+
+- [ ] **Step 3: Run lint**
+
+```bash
+npm run lint
+```
+
+Expected: No errors (fix if any)
+
+- [ ] **Step 4: Run build**
+
+```bash
+npm run build
+```
+
+Expected: Success
+
+- [ ] **Step 5: Commit any fixes if needed**
+
+---
+
+### Task 7: Final Review and Commit
+
+- [ ] **Step 1: Review all changes**
+
+```bash
+git status
+git log --oneline -10
+```
+
+- [ ] **Step 2: Create summary commit if needed**
+
+---
+
+## Summary
+
+**Files Created:**
+- `src/linkedin/profile.ts` - LinkedInProfile class with URL validation, duration parsing
+- `src/linkedin/profile.test.ts` - Unit tests
+- `src/cli/profile.ts` - CLI commands
+- `src/cli/profile.test.ts` - CLI tests
+- `src/types/index.test.ts` - Type tests
+
+**Files Modified:**
+- `src/types/index.ts` - Added ProfileData, ProfileExtractionOptions, ProfileExtractionResult types
+- `src/linkedin/selectors.ts` - Added profile selectors
+- `src/cli/index.ts` - Exported registerProfileCommands
+- `.env.example` - Added PAGE_AGENT_CDP_PORT
+
+**Total Tasks: 7
+**Estimated Time: 1-2 hours (with tests)