@bobfrankston/gcards 0.1.36 → 0.1.38

package/.claude/settings.local.json

@@ -34,7 +34,20 @@
       "Bash(npm link:*)",
       "Bash(cmd /c \"dir /AL\")",
       "Bash(node gcards.ts:*)",
-      "Bash(npm run release:*)"
+      "Bash(npm run release:*)",
+      "Bash(npm update:*)",
+      "Bash(npm ls:*)",
+      "Bash(cmd.exe /c \"cd /d Y:\\\\dev\\\\projects\\\\oauth\\\\oauthsupport && npm run release\")",
+      "Bash(powershell.exe -Command \"Push-Location ''Y:\\\\dev\\\\projects\\\\oauth\\\\oauthsupport''; npm run release\")",
+      "WebSearch",
+      "WebFetch(domain:www.npmjs.com)",
+      "WebFetch(domain:github.com)",
+      "Bash(npm run check:*)",
+      "Bash(powershell.exe -Command \"if \\(Test-Path \"\"$env:APPDATA\\\\gcards\\\\keys.env\"\"\\) { Get-Content \"\"$env:APPDATA\\\\gcards\\\\keys.env\"\" | Select-String ''ANTHROPIC'' | ForEach-Object { $_Line -replace ''=.*'', ''=***'' } } else { Write-Host ''Not found: %APPDATA%\\\\gcards\\\\keys.env'' }\")",
+      "Bash(powershell.exe -Command \"if \\(Test-Path \"\"$env:USERPROFILE\\\\.gcards\\\\keys.env\"\"\\) { Write-Host ''Found: ~/.gcards/keys.env''; Get-Content \"\"$env:USERPROFILE\\\\.gcards\\\\keys.env\"\" | Select-String ''ANTHROPIC'' | ForEach-Object { $_Line -replace ''=.*'', ''=***'' } } else { Write-Host ''Not found: ~/.gcards/keys.env'' }\")",
+      "Bash(powershell.exe -Command \"if \\($env:ANTHROPIC_API_KEY\\) { Write-Host ''ANTHROPIC_API_KEY is set in environment'' } else { Write-Host ''ANTHROPIC_API_KEY NOT set in environment'' }\")",
+      "Bash(powershell.exe -Command \"Set-Clipboard -Value ''John Smith, CEO, Acme Corporation, john.smith@acme.com, +1-555-123-4567''\")",
+      "Bash(node:*)"
     ],
     "deny": [],
     "ask": []

package/gcards.code-workspace

@@ -5,6 +5,9 @@
 		},
 		{
 			"path": "../../../projects/OAuth/OauthSupport"
+		},
+		{
+			"path": "../cardserve"
 		}
 	],
 	"settings": {

package/gcards.ts

@@ -15,7 +15,8 @@ import type { GooglePerson, GoogleConnectionsResponse } from './glib/types.ts';
 import { GCARDS_GUID_KEY, extractGuids } from './glib/gctypes.ts';
 import type { ContactIndex, IndexEntry, DeletedEntry, DeleteQueue, DeleteQueueEntry, PushStatus, PendingChange, UserPaths } from './glib/gctypes.ts';
 import { DATA_DIR, CREDENTIALS_FILE, loadConfig, saveConfig, getUserPaths, ensureUserDir, loadIndex, normalizeUser, getAllUsers, resolveUser, FileLogger, processProblemsFile } from './glib/gutils.ts';
-import { explainApiError, isAIAvailable, showAISetupHint } from './glib/aihelper.ts';
+import { explainApiError, isAIAvailable, showAISetupHint, extractContactFromText, extractContactFromImage } from './glib/aihelper.ts';
+import Clipboard from '@crosscopy/clipboard';
 
 const PEOPLE_API_BASE = 'https://people.googleapis.com/v1';
 const CONTACTS_SCOPE_READ = 'https://www.googleapis.com/auth/contacts.readonly';
@@ -42,7 +43,7 @@ let abortController: AbortController | null = null;
 function setupEscapeHandler(): void {
     // Create new abort controller for this operation
     abortController = new AbortController();
-    
+
     // Handle Ctrl+C via SIGINT (works without raw mode)
     process.on('SIGINT', () => {
         escapePressed = true;
@@ -160,7 +161,7 @@ function saveIndex(paths: UserPaths, index: ContactIndex): void {
         sortedContacts[key] = value;
     }
     index.contacts = sortedContacts;
-    
+
     // Add helpful comments to the file
     const comment = `// index.json - Active contacts index
 // This file tracks all contacts synced from Google.
@@ -214,7 +215,7 @@ function saveDeleted(paths: UserPaths, deletedIndex: DeletedIndex): void {
         sorted[key] = value;
     }
     deletedIndex.deleted = sorted;
-    
+
     // Add helpful comments
     const comment = `// deleted.json - Tombstone index of deleted contacts
 // This file tracks contacts that have been deleted from Google.
@@ -315,14 +316,14 @@ function savePhotos(paths: UserPaths, photosIndex: PhotosIndex): void {
     <table>
         <tr><th>Photo</th><th>Name</th></tr>
 ${entries.map(([resourceName, entry]) => {
-    const id = resourceName.replace('people/', '');
-    const contactUrl = `https://contacts.google.com/person/${id}`;
-    const photoUrl = entry.photos[0]?.url || '';
-    return `        <tr>
+        const id = resourceName.replace('people/', '');
+        const contactUrl = `https://contacts.google.com/person/${id}`;
+        const photoUrl = entry.photos[0]?.url || '';
+        return `        <tr>
             <td>${photoUrl ? `<img src="${photoUrl}" alt="${entry.displayName}" loading="lazy">` : '(no photo)'}</td>
             <td><a href="${contactUrl}" target="_blank">${entry.displayName}</a><br><span class="deleted">Deleted: ${entry.deletedAt?.split('T')[0] || 'unknown'}</span></td>
         </tr>`;
-}).join('\n')}
+    }).join('\n')}
     </table>
 </body>
 </html>`;
@@ -342,7 +343,7 @@ function loadDeleteQueue(paths: UserPaths): DeleteQueue {
 
 function saveDeleteQueue(paths: UserPaths, queue: DeleteQueue): void {
     queue.updatedAt = new Date().toISOString();
-    
+
     // Add helpful comments
     const comment = `// _delete.json - Pending deletion queue
 // This file contains contacts marked for deletion that require review.
@@ -482,7 +483,7 @@ function saveContact(paths: UserPaths, person: GooglePerson): void {
 
     const id = person.resourceName.replace('people/', '');
     const filePath = path.join(paths.contactsDir, `${id}.json`);
-    
+
     // Add helpful comment for contact files
     const comment = `// Contact file from Google People API
 // To delete this contact: Add "_delete": "force" field at root level, then run 'gcards push'
@@ -723,7 +724,7 @@ async function syncContacts(user: string, options: { full: boolean; verbose: boo
         const indexedResourceNames = new Set(
             Object.keys(index.contacts).map(rn => rn.replace('people/', '') + '.json')
         );
-        
+
         for (const file of contactFiles) {
             if (!indexedResourceNames.has(file)) {
                 if (!fs.existsSync(paths.orphansDir)) {
@@ -1048,6 +1049,138 @@ async function createContactOnGoogle(person: GooglePerson, retryCount = 0, token
     return await response.json();
 }
 
+/**
+ * Add a contact from text, clipboard, or image file using AI extraction
+ */
+async function addContact(user: string, options: { clip: boolean; file: string; text: string; verbose: boolean }): Promise<void> {
+    const paths = getUserPaths(user);
+    ensureUserDir(user);
+
+    // Ensure _add directory exists
+    if (!fs.existsSync(paths.toAddDir)) {
+        fs.mkdirSync(paths.toAddDir, { recursive: true });
+    }
+
+    let extracted;
+    let sourceDesc: string;
+
+    if (options.file) {
+        // Read from image file
+        if (!fs.existsSync(options.file)) {
+            throw new Error(`File not found: ${options.file}`);
+        }
+        console.log(`Reading image from: ${options.file}`);
+        const imageBuffer = fs.readFileSync(options.file);
+        const base64 = imageBuffer.toString('base64');
+        const ext = path.extname(options.file).toLowerCase();
+        const mediaType = ext === '.jpg' || ext === '.jpeg' ? 'image/jpeg' : 'image/png';
+
+        console.log('Extracting contact info from image...');
+        extracted = await extractContactFromImage(base64, mediaType);
+        sourceDesc = `image:${path.basename(options.file)}`;
+
+    } else if (options.clip) {
+        // Read from clipboard
+        console.log('Reading from clipboard...');
+
+        try {
+            // Try image first
+            let hasImage = false;
+            try {
+                hasImage = await Clipboard.hasImage();
+            } catch {
+                // hasImage check failed, assume text
+            }
+
+            if (hasImage) {
+                console.log('Found image in clipboard');
+                const base64 = await Clipboard.getImageBase64();
+                if (!base64) {
+                    throw new Error('Failed to read image from clipboard');
+                }
+                console.log('Extracting contact info from image...');
+                extracted = await extractContactFromImage(base64, 'image/png');
+                sourceDesc = 'clipboard:image';
+            } else {
+                const text = await Clipboard.getText();
+                if (!text || text.trim().length === 0) {
+                    throw new Error('Clipboard is empty or contains unsupported content (try copying text or an image)');
+                }
+                console.log(`Found text in clipboard (${text.length} chars)`);
+                if (options.verbose) {
+                    console.log(`Text: ${text.substring(0, 200)}${text.length > 200 ? '...' : ''}`);
+                }
+                console.log('Extracting contact info from text...');
+                extracted = await extractContactFromText(text);
+                sourceDesc = 'clipboard:text';
+            }
+        } catch (clipError: any) {
+            throw new Error(`Clipboard error: ${clipError.message || clipError}. Make sure clipboard contains text or an image.`);
+        }
+
+    } else if (options.text) {
+        // Parse from command line text
+        console.log('Extracting contact info from text...');
+        if (options.verbose) {
+            console.log(`Text: ${options.text}`);
+        }
+        extracted = await extractContactFromText(options.text);
+        sourceDesc = 'text';
+
+    } else {
+        throw new Error('No input specified. Use -clip, --file, or provide text. See --help.');
+    }
+
+    if (!extracted) {
+        throw new Error('Failed to extract contact information');
+    }
+
+    // Build display name for the contact
+    let displayName = 'Unknown';
+    if (extracted.names?.[0]) {
+        const name = extracted.names[0];
+        if (name.givenName || name.familyName) {
+            displayName = [name.givenName, name.familyName].filter(Boolean).join(' ');
+        } else if (name.displayName) {
+            displayName = name.displayName;
+        }
+    } else if (extracted.organizations?.[0]?.name) {
+        displayName = extracted.organizations[0].name;
+    }
+
+    // Generate a unique filename
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').substring(0, 19);
+    const safeName = displayName.replace(/[^a-zA-Z0-9]/g, '_').substring(0, 30);
+    const filename = `${timestamp}_${safeName}.json`;
+    const filePath = path.join(paths.toAddDir, filename);
+
+    // Add metadata about source
+    const contactData = {
+        ...extracted,
+        userDefined: [
+            { key: 'addedVia', value: `gcards-add:${sourceDesc}` },
+            { key: 'addedAt', value: new Date().toISOString() }
+        ]
+    };
+
+    // Save to _add folder
+    fs.writeFileSync(filePath, JSON.stringify(contactData, null, 2));
+
+    console.log(`\nExtracted contact: ${displayName}`);
+    if (extracted.emailAddresses?.length) {
+        console.log(`  Email: ${extracted.emailAddresses.map(e => e.value).join(', ')}`);
+    }
+    if (extracted.phoneNumbers?.length) {
+        console.log(`  Phone: ${extracted.phoneNumbers.map(p => p.value).join(', ')}`);
+    }
+    if (extracted.organizations?.length) {
+        const org = extracted.organizations[0];
+        console.log(`  Org: ${[org.title, org.name].filter(Boolean).join(' @ ')}`);
+    }
+    console.log(`\nSaved to: ${filePath}`);
+    console.log(`Run 'gcards push' to create the contact on Google.`);
+}
+
 async function pushContacts(user: string, options: { yes: boolean; verbose: boolean; limit: number; since: string }): Promise<void> {
     const paths = getUserPaths(user);
     ensureUserDir(user);
@@ -1470,6 +1603,9 @@ async function main(): Promise<void> {
                 case 'push':
                     await pushContacts(user, { yes: options.yes, verbose: options.verbose, limit: options.limit, since: options.since });
                     break;
+                case 'add':
+                    await addContact(user, { clip: options.clip, file: options.file, text: options.text, verbose: options.verbose });
+                    break;
                 default:
                     console.error(`Unknown command: ${options.command}`);
                     showHelp();
@@ -1492,6 +1628,26 @@ async function main(): Promise<void> {
     }
 }
 
+/**
+ * Patch process.exit to throw an exception for easier debugging and testing.
+ * This allows catching accidental exits and inspecting the call stack.
+ */
+// const originalExit = process.exit;
+// process.exit = function patchedExit(code?: number): never {
+//     const err = new Error(`process.exit(${code}) called`);
+//     // Print stack for debugging
+//     console.error(err.stack);
+//     debugger;
+//     // Optionally, throw to allow catching in tests or debugging
+//     throw err;
+// };
+
 if (import.meta.main) {
-    await main();
+    try {
+        await main();
+    }
+    catch (e: any) {
+        console.log(`Fatal error: ${e.message}\n${e.stack}`);
+        debugger;
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/gcards",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "Google Contacts cleanup and management tool",
   "type": "module",
   "main": "gcards.ts",
@@ -29,12 +29,16 @@
   "author": "Bob Frankston",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.0.9",
     "tsx": "^4.21.0"
   },
   "dependencies": {
-    "@bobfrankston/miscassists": "^1.0.36",
-    "@bobfrankston/oauthsupport": "^1.0.1",
+    "@bobfrankston/miscassists": "^1.0.41",
+    "@bobfrankston/oauthsupport": "^1.0.3",
+    "@crosscopy/clipboard": "^0.2.8",
     "jsonc-parser": "^3.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/tmpclaude-87f0-cwd

@@ -0,0 +1 @@
+/y/dev/utils/cardx/gcards

package/.gitattributes

@@ -1 +0,0 @@
-* text=auto eol=lf

package/.vscode/launch.json

@@ -1,21 +0,0 @@
-{
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "gcards sync",
-            "program": "${workspaceFolder}/gcards.ts",
-            "args": ["sync"],
-            "skipFiles": ["<node_internals>/**"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "gcards sync --full",
-            "program": "${workspaceFolder}/gcards.ts",
-            "args": ["sync", "--full"],
-            "skipFiles": ["<node_internals>/**"]
-        }
-    ]
-}

package/.vscode/settings.json

@@ -1,23 +0,0 @@
-{
-    "workbench.colorTheme": "Visual Studio 2019 Dark",
-    "workbench.colorCustomizations": {
-        "activityBar.activeBackground": "#0ae04a",
-        "activityBar.background": "#0ae04a",
-        "activityBar.foreground": "#15202b",
-        "activityBar.inactiveForeground": "#15202b99",
-        "activityBarBadge.background": "#9266f8",
-        "activityBarBadge.foreground": "#15202b",
-        "commandCenter.border": "#e7e7e799",
-        "sash.hoverBorder": "#0ae04a",
-        "statusBar.background": "#08af3a",
-        "statusBar.foreground": "#e7e7e7",
-        "statusBarItem.hoverBackground": "#0ae04a",
-        "statusBarItem.remoteBackground": "#08af3a",
-        "statusBarItem.remoteForeground": "#e7e7e7",
-        "titleBar.activeBackground": "#08af3a",
-        "titleBar.activeForeground": "#e7e7e7",
-        "titleBar.inactiveBackground": "#08af3a99",
-        "titleBar.inactiveForeground": "#e7e7e799"
-    },
-    "peacock.color": "#08af3a"
-}

package/.vscode/tasks.json

@@ -1,20 +0,0 @@
-{
-    "version": "2.0.0",
-    "tasks": [
-        {
-            "label": "tsc: check",
-            "type": "shell",
-            "command": "tsc",
-            "args": ["--watch"],
-            "runOptions": {
-                "runOn": "folderOpen"
-            },
-            "problemMatcher": "$tsc-watch",
-            "isBackground": true,
-            "group": {
-                "kind": "build",
-                "isDefault": true
-            }
-        }
-    ]
-}

package/glib/aihelper.ts

@@ -1,215 +0,0 @@
-/**
- * AI-powered error explanation helper for Google People API errors
- * Uses Anthropic Claude (primary) or OpenAI (fallback)
- */
-
-import fs from 'fs';
-import path from 'path';
-
-// Load keys from standard locations (AppData for Windows, ~/.config for Unix)
-function loadEnvFile(): void {
-    const home = process.env.HOME || process.env.USERPROFILE || '';
-    const appData = process.env.APPDATA || path.join(home, '.config');
-
-    const locations = [
-        path.join(appData, 'gcards', 'keys.env'),  // Standard app config location
-        path.join(home, '.gcards', 'keys.env'),     // Unix dotfile style
-        path.join(process.cwd(), 'keys.env'),       // Local override (dev only)
-        path.join(process.cwd(), '.env'),
-    ];
-
-    for (const loc of locations) {
-        if (fs.existsSync(loc)) {
-            const content = fs.readFileSync(loc, 'utf-8');
-            for (const line of content.split(/\r?\n/)) {
-                const match = line.match(/^([A-Z_][A-Z0-9_]*)=(.*)$/);
-                if (match && !process.env[match[1]]) {
-                    process.env[match[1]] = match[2].trim().replace(/^["']|["']$/g, '');
-                }
-            }
-            break;
-        }
-    }
-}
-
-loadEnvFile();
-
-export interface AIErrorExplanation {
-    explanation: string;
-    suggestedFix: string;
-    correctedJson?: string;
-}
-
-const SYSTEM_PROMPT = `You are an expert on the Google People API for contacts. When given an API error and the JSON payload that caused it, provide:
-
-1. A brief explanation of what went wrong
-2. The specific fix needed
-3. If possible, the corrected JSON snippet
-
-Be extremely concise. No preamble. Format:
-PROBLEM: <one line>
-FIX: <one line>
-CORRECTED: <json if applicable, or "N/A">
-
-Common issues:
-- nicknames is a top-level field, NOT nested in names[]
-- phoneNumbers[].type values: "mobile", "home", "work", "homeFax", "workFax", "otherFax", "pager", "workMobile", "workPager", "main", "googleVoice", "other"
-- emailAddresses[].type values: "home", "work", "other"
-- addresses[].type values: "home", "work", "other"
-- birthdays[].date needs {year?, month, day} not a string
-- organizations[].type values: "work", "school"
-- Field names are camelCase not snake_case`;
-
-async function callAnthropic(errorMsg: string, payload: string): Promise<string | null> {
-    const apiKey = process.env.ANTHROPIC_API_KEY;
-    if (!apiKey) return null;
-
-    try {
-        const response = await fetch('https://api.anthropic.com/v1/messages', {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'x-api-key': apiKey,
-                'anthropic-version': '2023-06-01'
-            },
-            body: JSON.stringify({
-                model: 'claude-3-haiku-20240307',
-                max_tokens: 500,
-                system: SYSTEM_PROMPT,
-                messages: [{
-                    role: 'user',
-                    content: `Error: ${errorMsg}\n\nPayload:\n${payload}`
-                }]
-            })
-        });
-
-        if (!response.ok) return null;
-
-        const data = await response.json() as any;
-        return data.content?.[0]?.text || null;
-    } catch {
-        return null;
-    }
-}
-
-async function callOpenAI(errorMsg: string, payload: string): Promise<string | null> {
-    const apiKey = process.env.OPENAI_API_KEY;
-    if (!apiKey) return null;
-
-    try {
-        const response = await fetch('https://api.openai.com/v1/chat/completions', {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'Authorization': `Bearer ${apiKey}`
-            },
-            body: JSON.stringify({
-                model: 'gpt-4o-mini',
-                max_tokens: 500,
-                messages: [
-                    { role: 'system', content: SYSTEM_PROMPT },
-                    { role: 'user', content: `Error: ${errorMsg}\n\nPayload:\n${payload}` }
-                ]
-            })
-        });
-
-        if (!response.ok) return null;
-
-        const data = await response.json() as any;
-        return data.choices?.[0]?.message?.content || null;
-    } catch {
-        return null;
-    }
-}
-
-function parseAIResponse(response: string): AIErrorExplanation {
-    const lines = response.split('\n');
-    let explanation = '';
-    let suggestedFix = '';
-    let correctedJson: string | undefined;
-    let inCorrected = false;
-    const correctedLines: string[] = [];
-
-    for (const line of lines) {
-        if (line.startsWith('PROBLEM:')) {
-            explanation = line.substring(8).trim();
-        } else if (line.startsWith('FIX:')) {
-            suggestedFix = line.substring(4).trim();
-        } else if (line.startsWith('CORRECTED:')) {
-            const rest = line.substring(10).trim();
-            if (rest && rest !== 'N/A') {
-                inCorrected = true;
-                if (rest !== '{' && rest !== '[') {
-                    correctedLines.push(rest);
-                } else {
-                    correctedLines.push(rest);
-                }
-            }
-        } else if (inCorrected) {
-            correctedLines.push(line);
-        }
-    }
-
-    if (correctedLines.length > 0) {
-        const joined = correctedLines.join('\n').trim();
-        // Try to extract just the JSON part
-        const jsonMatch = joined.match(/(\{[\s\S]*\}|\[[\s\S]*\])/);
-        if (jsonMatch) {
-            correctedJson = jsonMatch[1];
-        } else if (joined !== 'N/A') {
-            correctedJson = joined;
-        }
-    }
-
-    return { explanation, suggestedFix, correctedJson };
-}
-
-/**
- * Get AI-powered explanation for a Google People API error
- * @param errorMessage The error message from the API
- * @param payload The JSON payload that caused the error (will be truncated if too long)
- * @returns Explanation and fix suggestion, or null if AI unavailable
- */
-export async function explainApiError(errorMessage: string, payload: unknown): Promise<AIErrorExplanation | null> {
-    // Truncate payload to avoid huge API calls
-    let payloadStr = typeof payload === 'string' ? payload : JSON.stringify(payload, null, 2);
-    if (payloadStr.length > 2000) {
-        payloadStr = payloadStr.substring(0, 2000) + '\n... (truncated)';
-    }
-
-    // Try Anthropic first, then OpenAI
-    let response = await callAnthropic(errorMessage, payloadStr);
-    if (!response) {
-        response = await callOpenAI(errorMessage, payloadStr);
-    }
-
-    if (!response) return null;
-
-    return parseAIResponse(response);
-}
-
-/**
- * Check if AI error explanation is available (any API key configured)
- */
-export function isAIAvailable(): boolean {
-    return !!(process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY);
-}
-
-/**
- * Get the expected keys.env path for the current platform
- */
-export function getKeysEnvPath(): string {
-    const home = process.env.HOME || process.env.USERPROFILE || '';
-    const appData = process.env.APPDATA || path.join(home, '.config');
-    return path.join(appData, 'gcards', 'keys.env');
-}
-
-/**
- * Show instructions for setting up AI keys (call when AI could have helped but wasn't available)
- */
-export function showAISetupHint(): void {
-    const keysPath = getKeysEnvPath();
-    console.log(`\n    Tip: Enable AI error explanations by creating ${keysPath}`);
-    console.log(`    Add: ANTHROPIC_API_KEY=sk-ant-... or OPENAI_API_KEY=sk-...`);
-    console.log(`    See README.md for details.`);
-}