@bobfrankston/gcards 0.1.14 → 0.1.16

package/.claude/settings.local.json

@@ -22,7 +22,8 @@
       "Bash(npx tsx:*)",
       "WebFetch(domain:lh3.googleusercontent.com)",
       "Bash(curl:*)",
-      "Bash(bun build:*)"
+      "Bash(bun build:*)",
+      "Bash(xargs -I {} sh -c 'echo \"\"=== {} ===\"\" && head -20 {}')"
     ],
     "deny": [],
     "ask": []

package/gcards.ts

@@ -79,6 +79,7 @@ function cleanupEscapeHandler(): void {
         process.stdin.pause();
         process.stdin.removeAllListeners('data');
     }
+    process.stdin.unref();  // Allow Node to exit even if stdin is open
 }
 
 async function getAccessToken(user: string, writeAccess = false, forceRefresh = false): Promise<string> {
@@ -257,7 +258,14 @@ function saveSyncToken(paths: UserPaths, token: string): void {
 }
 
 async function sleep(ms: number): Promise<void> {
-    return new Promise(resolve => setTimeout(resolve, ms));
+    return new Promise(resolve => {
+        const timeout = setTimeout(resolve, ms);
+        // Allow escape to interrupt sleep
+        if (escapePressed) {
+            clearTimeout(timeout);
+            resolve();
+        }
+    });
 }
 
 async function fetchContactsWithRetry(
@@ -1053,6 +1061,12 @@ async function pushContacts(user: string, options: { yes: boolean; verbose: bool
             problems.push(errorMsg);
             errorCount++;
 
+            // Check for etag mismatch - needs resync
+            if (error.message?.includes('FAILED_PRECONDITION') || error.message?.includes('etag')) {
+                console.log(`    → Contact changed on Google. Run 'gcards sync' then retry.`);
+                continue;
+            }
+
             // Get AI explanation if available and error is from API
             if (error instanceof ApiError && error.payload) {
                 if (isAIAvailable()) {
@@ -1107,6 +1121,12 @@ async function pushContacts(user: string, options: { yes: boolean; verbose: bool
     const skipped = skippedPhoto + skippedStarred;
     const skippedDetails = skipped > 0 ? ` (${skippedPhoto} photo, ${skippedStarred} starred)` : '';
     console.log(`\nPush complete: ${successCount} succeeded, ${errorCount} failed, ${skipped} skipped${skippedDetails}`);
+
+    // Check if any errors were etag related
+    const etagErrors = problems.filter(p => p.includes('FAILED_PRECONDITION') || p.includes('etag'));
+    if (etagErrors.length > 0) {
+        console.log(`\n${etagErrors.length} contact(s) had etag conflicts. Run 'gcards sync' to refresh, then retry push.`);
+    }
 }
 
 async function main(): Promise<void> {

package/gfix.ts

@@ -11,6 +11,7 @@
 import fs from 'fs';
 import path from 'path';
 import readline from 'readline';
+import { parse as parseJsonc } from 'jsonc-parser';
 import type { GooglePerson, GoogleName, GooglePhoneNumber, GoogleEmailAddress, GoogleBirthday } from './glib/types.ts';
 import type { DeleteQueue, DeleteQueueEntry, UserPaths } from './glib/gctypes.ts';
 import { DATA_DIR, resolveUser, getUserPaths, loadIndex, getAllUsers, normalizeUser, matchUsers } from './glib/gutils.ts';
@@ -746,7 +747,36 @@ function parseFullName(fullName: string): ParsedName {
     };
 }
 
-/** Fix names: parse givenName into first/middle/last, clean fileAs */
+/** Check if string looks like a phone number */
+function looksLikePhone(s: string): boolean {
+    const digits = s.replace(/\D/g, '');
+    return digits.length >= 7 && digits.length <= 15 && /^[\d\s\-.()+]+$/.test(s);
+}
+
+/** Fix repeated words in a string - returns cleaned string or null if no fix needed */
+function fixRepeatedWords(s: string): string | null {
+    const words = s.split(/\s+/);
+    if (words.length < 3) return null;
+
+    // Count consecutive repeated words
+    const seen = new Set<string>();
+    const result: string[] = [];
+    for (const word of words) {
+        const lower = word.toLowerCase().replace(/[.,]+$/, ''); // normalize
+        if (!seen.has(lower)) {
+            seen.add(lower);
+            result.push(word.replace(/[.]+$/, '')); // remove trailing dots
+        }
+    }
+
+    // Only return if we actually removed something
+    if (result.length < words.length) {
+        return result.join(' ').trim();
+    }
+    return null;
+}
+
+/** Fix names: parse givenName into first/middle/last, clean fileAs, handle nameless contacts */
 async function runNamesFix(user: string, mode: 'inspect' | 'apply'): Promise<void> {
     const paths = getUserPaths(user);
 
@@ -767,61 +797,93 @@ async function runNamesFix(user: string, mode: 'inspect' | 'apply'): Promise<voi
 
     const changeLogs: NameChangeLog[] = [];
     const problems: string[] = [];
+    const needsAction: { file: string; displayName: string; reason: string }[] = [];
     let contactsModified = 0;
 
+    // Track nameless contacts for deletion
+    const emailOnly: { file: string; resourceName: string; email: string }[] = [];
+    const phoneOnly: { file: string; resourceName: string; phone: string }[] = [];
+    const emailOnlyFile = path.join(paths.userDir, 'emailonly.json');
+    const phoneOnlyFile = path.join(paths.userDir, 'phoneonly.json');
+    const needsActionFile = path.join(paths.userDir, 'needsaction.txt');
+
     for (const file of files) {
         const filePath = path.join(paths.contactsDir, file);
-        const contact = JSON.parse(fs.readFileSync(filePath, 'utf-8')) as GooglePerson;
+        let contact: GooglePerson;
+        try {
+            contact = parseJsonc(fs.readFileSync(filePath, 'utf-8')) as GooglePerson;
+        } catch (e: any) {
+            needsAction.push({ file, displayName: '(parse error)', reason: e.message });
+            console.log(`  [NEEDS-ACTION:parse-error] ${file}: ${e.message}`);
+            continue;
+        }
 
         const name = contact.names?.[0];
-        if (!name) continue;
+
+        // Handle contacts with no names -> DELETE
+        if (!name || !name.givenName) {
+            const email = contact.emailAddresses?.[0]?.value;
+            const phone = contact.phoneNumbers?.[0]?.value;
+            if (email) {
+                emailOnly.push({ file, resourceName: contact.resourceName, email });
+                console.log(`  [DELETE:email-only] ${email} (${file})`);
+            } else if (phone) {
+                phoneOnly.push({ file, resourceName: contact.resourceName, phone });
+                console.log(`  [DELETE:phone-only] ${phone} (${file})`);
+            } else {
+                emailOnly.push({ file, resourceName: contact.resourceName, email: '(empty contact)' });
+                console.log(`  [DELETE:empty] no name/email/phone (${file})`);
+            }
+            continue;
+        }
+
+        // Check if name is actually a phone number -> DELETE
+        if (looksLikePhone(name.givenName)) {
+            phoneOnly.push({ file, resourceName: contact.resourceName, phone: name.givenName });
+            console.log(`  [DELETE:phone-only] "${name.givenName}" (${file})`);
+            continue;
+        }
+
+        // Check if name is actually an email address (including malformed like "foo. bar@x. y. com") -> DELETE
+        const nameNormalized = name.givenName.replace(/\.\s+/g, '.').replace(/\s+\./g, '.');
+        if (nameNormalized.includes('@') && nameNormalized.match(/^[^\s]+@[^\s]+\.[^\s]+$/)) {
+            const cleanEmail = nameNormalized.toLowerCase();
+            emailOnly.push({ file, resourceName: contact.resourceName, email: cleanEmail });
+            console.log(`  [DELETE:email-in-name] "${name.givenName}" -> ${cleanEmail} (${file})`);
+            continue;
+        }
 
         const changes: string[] = [];
         let modified = false;
         let parsedFirst = '';
         let parsedLast = '';
 
-        // Check displayName for corruption (repeated words like "Dr. Dr. Dr. Dr.")
-        const displayName = name.displayName || name.givenName || 'Unknown';
-        const displayWords = displayName.split(/\s+/);
-        if (displayWords.length > 4) {
-            const wordCounts = new Map<string, number>();
-            for (const w of displayWords) {
-                wordCounts.set(w.toLowerCase(), (wordCounts.get(w.toLowerCase()) || 0) + 1);
+        // Fix repeated words in givenName (like "Brian Taraci Taraci Taraci...")
+        const fixedGivenName = fixRepeatedWords(name.givenName);
+        if (fixedGivenName) {
+            changes.push(`givenName: "${name.givenName.slice(0, 40)}..." -> "${fixedGivenName}" (removed repeated words)`);
+            if (mode === 'apply') {
+                name.givenName = fixedGivenName;
+                modified = true;
             }
-            const maxCount = Math.max(...wordCounts.values());
-            if (maxCount > 3) {
-                problems.push(`${file}: repeated words in displayName (${maxCount}x) - corrupted data`);
-                console.log(`  [CORRUPTED] ${displayName.slice(0, 60)}... (${file})`);
-                continue;
+        }
+
+        // Fix repeated words in familyName
+        if (name.familyName) {
+            const fixedFamilyName = fixRepeatedWords(name.familyName);
+            if (fixedFamilyName) {
+                changes.push(`familyName: "${name.familyName.slice(0, 40)}..." -> "${fixedFamilyName}" (removed repeated words)`);
+                if (mode === 'apply') {
+                    name.familyName = fixedFamilyName;
+                    modified = true;
+                }
             }
         }
 
         // If givenName exists but no familyName, parse it
         if (name.givenName && !name.familyName) {
-            // Check for repeated words (corrupted data like "Smith Smith Smith...")
-            const words = name.givenName.split(/\s+/);
-            if (words.length > 4) {
-                const wordCounts = new Map<string, number>();
-                for (const w of words) {
-                    wordCounts.set(w.toLowerCase(), (wordCounts.get(w.toLowerCase()) || 0) + 1);
-                }
-                const maxCount = Math.max(...wordCounts.values());
-                if (maxCount > 3) {
-                    const displayName = name.displayName || name.givenName.slice(0, 50) + '...' || 'Unknown';
-                    problems.push(`${file}: repeated words (${maxCount}x) - corrupted data`);
-                    console.log(`  [CORRUPTED] ${displayName} (${file})`);
-                    continue;
-                }
-            }
 
-            // Check for email addresses
-            if (name.givenName.includes('@')) {
-                const displayName = name.displayName || name.givenName || 'Unknown';
-                problems.push(`${file}: "${name.givenName}" - email address, not a name`);
-                console.log(`  [EMAIL] ${displayName} (${file}): "${name.givenName}"`);
-                continue;
-            }
+            // Note: email-in-name is now handled earlier as DELETE
 
             const parsed = parseFullName(name.givenName);
 
@@ -829,7 +891,7 @@ async function runNamesFix(user: string, mode: 'inspect' | 'apply'): Promise<voi
             if (parsed.isCompany) {
                 const displayName = name.displayName || name.givenName || 'Unknown';
                 problems.push(`${file}: "${name.givenName}" - looks like a company name`);
-                console.log(`  [COMPANY] ${displayName} (${file}): "${name.givenName}"`);
+                console.log(`  [SKIP:company] ${displayName} (${file})`);
                 continue;
             }
 
@@ -837,7 +899,7 @@ async function runNamesFix(user: string, mode: 'inspect' | 'apply'): Promise<voi
             if (parsed.ambiguous) {
                 const displayName = name.displayName || name.givenName || 'Unknown';
                 problems.push(`${file}: "${name.givenName}" - ambiguous (could be "Last, First" or unknown suffix)`);
-                console.log(`  [AMBIGUOUS] ${displayName} (${file}): "${name.givenName}"`);
+                console.log(`  [SKIP:ambiguous] ${displayName} (${file})`);
                 continue;
             }
 
@@ -845,7 +907,7 @@ async function runNamesFix(user: string, mode: 'inspect' | 'apply'): Promise<voi
             if (!parsed.last) {
                 const displayName = name.displayName || name.givenName || 'Unknown';
                 problems.push(`${file}: "${name.givenName}" - no last name detected`);
-                console.log(`  [NO LAST NAME] ${displayName} (${file}): "${name.givenName}"`);
+                console.log(`  [SKIP:no-last-name] ${displayName} (${file})`);
                 continue;
             }
 
@@ -997,17 +1059,58 @@ async function runNamesFix(user: string, mode: 'inspect' | 'apply'): Promise<voi
         console.log(`\nProblems file: ${problemsPath}`);
     }
 
+    // Write needsaction.txt for manual fixing
+    if (needsAction.length > 0) {
+        const content = needsAction.map(c => `${c.file}\t${c.displayName}\t${c.reason}`).join('\n');
+        fs.writeFileSync(needsActionFile, content);
+        console.log(`\nNeeds action file: ${needsActionFile}`);
+    }
+
+    // Handle email-only and phone-only contacts
+    if (mode === 'apply' && (emailOnly.length > 0 || phoneOnly.length > 0)) {
+        if (!fs.existsSync(paths.toDeleteDir)) {
+            fs.mkdirSync(paths.toDeleteDir, { recursive: true });
+        }
+
+        if (emailOnly.length > 0) {
+            for (const entry of emailOnly) {
+                const src = path.join(paths.contactsDir, entry.file);
+                const dst = path.join(paths.toDeleteDir, entry.file);
+                fs.renameSync(src, dst);
+            }
+            const existing = fs.existsSync(emailOnlyFile) ? JSON.parse(fs.readFileSync(emailOnlyFile, 'utf-8')) : [];
+            existing.push(...emailOnly.map(e => ({ file: e.file, resourceName: e.resourceName, email: e.email, movedAt: new Date().toISOString() })));
+            fs.writeFileSync(emailOnlyFile, JSON.stringify(existing, null, 2));
+        }
+
+        if (phoneOnly.length > 0) {
+            for (const entry of phoneOnly) {
+                const src = path.join(paths.contactsDir, entry.file);
+                const dst = path.join(paths.toDeleteDir, entry.file);
+                fs.renameSync(src, dst);
+            }
+            const existing = fs.existsSync(phoneOnlyFile) ? JSON.parse(fs.readFileSync(phoneOnlyFile, 'utf-8')) : [];
+            existing.push(...phoneOnly.map(e => ({ file: e.file, resourceName: e.resourceName, phone: e.phone, movedAt: new Date().toISOString() })));
+            fs.writeFileSync(phoneOnlyFile, JSON.stringify(existing, null, 2));
+        }
+    }
+
     console.log(`\n${'='.repeat(50)}`);
     console.log(`Summary:`);
     console.log(`  Contacts with changes: ${changeLogs.length}`);
+    console.log(`  To delete (email/phone only): ${emailOnly.length + phoneOnly.length}`);
+    console.log(`  Needs manual action (see needsaction.txt): ${needsAction.length}`);
     console.log(`  Ambiguous (see problems.txt): ${problems.length}`);
     if (mode === 'apply') {
         console.log(`  Contacts modified: ${contactsModified}`);
+        if (emailOnly.length > 0 || phoneOnly.length > 0) {
+            console.log(`  Moved to _delete/: ${emailOnly.length + phoneOnly.length} (recovery: emailonly.json, phoneonly.json)`);
+        }
     }
-    if (mode === 'inspect' && changeLogs.length > 0) {
+    if (mode === 'inspect' && (changeLogs.length > 0 || emailOnly.length > 0 || phoneOnly.length > 0)) {
         console.log(`\nTo apply fixes, run: gfix names -u ${user} --apply`);
     }
-    if (mode === 'apply' && contactsModified > 0) {
+    if (mode === 'apply' && (contactsModified > 0 || emailOnly.length > 0 || phoneOnly.length > 0)) {
         console.log(`\nAfter review, run: gcards push -u ${user}`);
     }
 }
@@ -1858,26 +1961,42 @@ async function main(): Promise<void> {
     let targetUser = '';
     let applyFlag = false;
     const positionalArgs: string[] = [];
+    const unrecognized: string[] = [];
 
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
-        if ((arg === '-u' || arg === '--user' || arg === '-user') && i + 1 < args.length) {
-            user = args[++i];
-        } else if ((arg === '-to' || arg === '--to') && i + 1 < args.length) {
-            targetUser = args[++i];
-        } else if (arg === '--apply') {
-            applyFlag = true;
-        } else if ((arg === '-limit' || arg === '--limit') && i + 1 < args.length) {
-            processLimit = parseInt(args[++i], 10) || 0;
-        } else if (!arg.startsWith('-')) {
-            if (!command) {
-                command = arg;
-            } else {
-                positionalArgs.push(arg);
-            }
+        switch (arg) {
+            case '-u': case '--user': case '-user':
+                user = args[++i] || '';
+                break;
+            case '-to': case '--to':
+                targetUser = args[++i] || '';
+                break;
+            case '--apply':
+                applyFlag = true;
+                break;
+            case '-limit': case '--limit':
+                processLimit = parseInt(args[++i], 10) || 0;
+                break;
+            default:
+                if (!arg.startsWith('-')) {
+                    if (!command) {
+                        command = arg;
+                    } else {
+                        positionalArgs.push(arg);
+                    }
+                } else {
+                    unrecognized.push(arg);
+                }
         }
     }
 
+    if (unrecognized.length > 0) {
+        console.error(`Unrecognized argument(s): ${unrecognized.join(', ')}`);
+        console.error(`Use 'gfix' for usage information.`);
+        process.exit(1);
+    }
+
     if (!command) {
         showUsage();
         return;

package/glib/gutils.ts

@@ -5,6 +5,7 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
+import { parse as parseJsonc } from 'jsonc-parser';
 import type { GcardsConfig, ContactIndex, UserPaths } from './gctypes.ts';
 
 export const APP_DIR = path.dirname(import.meta.dirname);  // Parent of glib/
@@ -34,7 +35,11 @@ export const CREDENTIALS_FILE = path.join(APP_DIR, 'credentials.json');
 
 export function loadConfig(): GcardsConfig {
     if (fs.existsSync(CONFIG_FILE)) {
-        return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+        try {
+            return parseJsonc(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+        } catch (e: any) {
+            throw new Error(`Failed to parse ${CONFIG_FILE}: ${e.message}`);
+        }
     }
     return {};
 }
@@ -76,7 +81,11 @@ export function ensureUserDir(user: string): void {
 
 export function loadIndex(paths: UserPaths): ContactIndex {
     if (fs.existsSync(paths.indexFile)) {
-        return JSON.parse(fs.readFileSync(paths.indexFile, 'utf-8'));
+        try {
+            return parseJsonc(fs.readFileSync(paths.indexFile, 'utf-8'));
+        } catch (e: any) {
+            throw new Error(`Failed to parse ${paths.indexFile}: ${e.message}`);
+        }
     }
     return { contacts: {}, lastSync: '' };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/gcards",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Google Contacts cleanup and management tool",
   "type": "module",
   "main": "gcards.ts",
@@ -32,6 +32,7 @@
     "tsx": "^4.21.0"
   },
   "dependencies": {
-    "@bobfrankston/miscassists": "file:../../../projects/NodeJS/miscassists"
+    "@bobfrankston/miscassists": "file:../../../projects/NodeJS/miscassists",
+    "jsonc-parser": "^3.3.1"
   }
 }