@pagebridge/cli 0.0.1 → 0.0.2

package/.turbo/turbo-check-types.log

@@ -0,0 +1,4 @@
+
+> @pagebridge/cli@0.0.1 check-types F:\Code\pagebridge\oss\apps\cli
+> tsc --noEmit
+

package/dist/commands/diagnose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/commands/diagnose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,eAAO,MAAM,eAAe,SAyFxB,CAAC"}
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/commands/diagnose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,eAAO,MAAM,eAAe,SA2GxB,CAAC"}

package/dist/commands/diagnose.js

@@ -1,19 +1,32 @@
 import { Command } from "commander";
-import postgres from "postgres";
-import { createDbWithClient, unmatchDiagnostics, eq, desc, } from "@pagebridge/db";
+import { createDb, unmatchDiagnostics, eq, desc, } from "@pagebridge/db";
+import { resolve, requireConfig } from "../resolve-config.js";
+import { log } from "../logger.js";
+import { migrateIfRequested } from "../migrate.js";
 export const diagnoseCommand = new Command("diagnose")
     .description("View diagnostics for unmatched URLs")
     .requiredOption("--site <url>", "GSC site URL (e.g., sc-domain:example.com)")
     .option("--reason <reason>", "Filter by unmatch reason")
     .option("--limit <n>", "Limit number of results", "20")
     .option("--json", "Output as JSON")
+    .option("--migrate", "Run database migrations before querying")
+    .option("--db-url <url>", "PostgreSQL connection string")
     .action(async (options) => {
-    if (!process.env.DATABASE_URL) {
-        console.error("Missing required environment variable: DATABASE_URL");
-        process.exit(1);
-    }
-    const sql = postgres(process.env.DATABASE_URL);
-    const db = createDbWithClient(sql);
+    const dbUrl = resolve(options.dbUrl, "DATABASE_URL");
+    requireConfig([
+        { name: "DATABASE_URL", flag: "--db-url <url>", envVar: "DATABASE_URL", value: dbUrl },
+    ]);
+    // Run migrations if requested
+    await migrateIfRequested(!!options.migrate, dbUrl);
+    const { db, close } = createDb(dbUrl);
+    // Register shutdown handlers
+    const shutdown = async () => {
+        log.warn("Received shutdown signal, closing connections...");
+        await close();
+        process.exit(130);
+    };
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
     try {
         const query = db
             .select()
@@ -27,8 +40,8 @@ export const diagnoseCommand = new Command("diagnose")
             return;
         }
         if (results.length === 0) {
-            console.log(`No unmatched URLs found for ${options.site}`);
-            console.log(`Run 'sync --site ${options.site}' first to generate diagnostics.`);
+            log.info(`No unmatched URLs found for ${options.site}`);
+            log.info(`Run 'sync --site ${options.site}' first to generate diagnostics.`);
             return;
         }
         // Group by reason
@@ -38,23 +51,22 @@ export const diagnoseCommand = new Command("diagnose")
             existing.push(r);
             byReason.set(r.unmatchReason, existing);
         }
-        console.log(`\nUnmatched URL Diagnostics for ${options.site}\n`);
-        console.log(`Total: ${results.length} unmatched URLs\n`);
+        log.info(`\nUnmatched URL Diagnostics for ${options.site}\n`);
+        log.info(`Total: ${results.length} unmatched URLs\n`);
         for (const [reason, items] of byReason) {
-            console.log(`${getReasonEmoji(reason)} ${getReasonDescription(reason)} (${items.length}):`);
-            console.log();
+            log.info(`${getReasonEmoji(reason)} ${getReasonDescription(reason)} (${items.length}):`);
             for (const item of items) {
-                console.log(`  ${item.gscUrl}`);
+                log.info(`  ${item.gscUrl}`);
                 if (item.extractedSlug) {
-                    console.log(`    Extracted slug: "${item.extractedSlug}"`);
+                    log.info(`    Extracted slug: "${item.extractedSlug}"`);
                 }
                 if (item.similarSlugs) {
                     try {
                         const similar = JSON.parse(item.similarSlugs);
                         if (similar.length > 0) {
-                            console.log(`    Similar slugs in Sanity:`);
+                            log.info(`    Similar slugs in Sanity:`);
                             for (const s of similar) {
-                                console.log(`      - ${s}`);
+                                log.info(`      - ${s}`);
                             }
                         }
                     }
@@ -62,17 +74,23 @@ export const diagnoseCommand = new Command("diagnose")
                         // Ignore parse errors
                     }
                 }
-                console.log();
             }
         }
-        console.log(`\nTo fix unmatched URLs:`);
-        console.log(`  1. Check if the Sanity document exists with the correct slug`);
-        console.log(`  2. Verify the document type is in the contentTypes list`);
-        console.log(`  3. Ensure the slug field name matches your configuration`);
-        console.log(`  4. If using a path prefix, verify it matches your URL structure`);
+        log.info(`\nTo fix unmatched URLs:`);
+        log.info(`  1. Check if the Sanity document exists with the correct slug`);
+        log.info(`  2. Verify the document type is in the contentTypes list`);
+        log.info(`  3. Ensure the slug field name matches your configuration`);
+        log.info(`  4. If using a path prefix, verify it matches your URL structure`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        log.error(`Diagnose failed: ${message}`);
+        process.exitCode = 1;
     }
     finally {
-        await sql.end();
+        await close();
+        process.removeListener("SIGTERM", shutdown);
+        process.removeListener("SIGINT", shutdown);
     }
 });
 function getReasonEmoji(reason) {

package/dist/commands/list-sites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-sites.d.ts","sourceRoot":"","sources":["../../src/commands/list-sites.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,gBAAgB,SA2CzB,CAAC"}
+{"version":3,"file":"list-sites.d.ts","sourceRoot":"","sources":["../../src/commands/list-sites.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,gBAAgB,SA6CzB,CAAC"}

package/dist/commands/list-sites.js

@@ -1,38 +1,43 @@
 import { Command } from "commander";
 import { GSCClient } from "@pagebridge/core";
+import { resolve, requireConfig } from "../resolve-config.js";
+import { log } from "../logger.js";
 export const listSitesCommand = new Command("list-sites")
     .description("List all sites the service account has access to")
-    .action(async () => {
-    if (!process.env.GOOGLE_SERVICE_ACCOUNT) {
-        console.error("❌ Missing GOOGLE_SERVICE_ACCOUNT environment variable");
-        process.exit(1);
-    }
+    .option("--google-service-account <json>", "Google service account JSON")
+    .action(async (options) => {
+    const googleServiceAccount = resolve(options.googleServiceAccount, "GOOGLE_SERVICE_ACCOUNT");
+    requireConfig([
+        { name: "GOOGLE_SERVICE_ACCOUNT", flag: "--google-service-account <json>", envVar: "GOOGLE_SERVICE_ACCOUNT", value: googleServiceAccount },
+    ]);
     let credentials;
     try {
-        credentials = JSON.parse(process.env.GOOGLE_SERVICE_ACCOUNT);
+        credentials = JSON.parse(googleServiceAccount);
     }
     catch {
-        console.error("❌ Failed to parse GOOGLE_SERVICE_ACCOUNT as JSON");
+        log.error("Failed to parse GOOGLE_SERVICE_ACCOUNT as JSON");
         process.exit(1);
     }
-    console.log(`🔑 Using service account: ${credentials.client_email}`);
+    log.info(`Using service account: ${credentials.client_email}`);
     const gsc = new GSCClient({ credentials });
     try {
         const sites = await gsc.listSites();
         if (sites.length === 0) {
-            console.log("\n⚠️  No sites found. The service account has no access to any GSC properties.");
-            console.log("\nTo fix this:");
-            console.log("1. Go to Google Search Console → Settings → Users and permissions");
-            console.log(`2. Add user: ${credentials.client_email}`);
-            console.log("3. Set permission level to 'Full'");
+            log.warn("No sites found. The service account has no access to any GSC properties.");
+            log.info("\nTo fix this:");
+            log.info("1. Go to Google Search Console > Settings > Users and permissions");
+            log.info(`2. Add user: ${credentials.client_email}`);
+            log.info("3. Set permission level to 'Full'");
         }
         else {
-            console.log(`\n✅ Found ${sites.length} site(s):\n`);
-            sites.forEach((site) => console.log(`   ${site}`));
-            console.log('\nUse one of these exact values with: pnpm sync --site "<value>"');
+            log.info(`Found ${sites.length} site(s):\n`);
+            sites.forEach((site) => log.info(`   ${site}`));
+            log.info('\nUse one of these exact values with: pnpm sync --site "<value>"');
         }
     }
     catch (error) {
-        console.error("❌ Failed to list sites:", error);
+        const message = error instanceof Error ? error.message : String(error);
+        log.error(`Failed to list sites: ${message}`);
+        process.exit(1);
     }
 });

package/dist/commands/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCpC,eAAO,MAAM,WAAW,SAmUpB,CAAC"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkCpC,eAAO,MAAM,WAAW,SAkYpB,CAAC"}

package/dist/commands/sync.js

@@ -1,8 +1,10 @@
 import { Command } from "commander";
 import { createClient as createSanityClient } from "@sanity/client";
-import postgres from "postgres";
 import { GSCClient, SyncEngine, DecayDetector, URLMatcher, TaskGenerator, } from "@pagebridge/core";
-import { createDbWithClient, unmatchDiagnostics } from "@pagebridge/db";
+import { createDb, sql, unmatchDiagnostics } from "@pagebridge/db";
+import { resolve, requireConfig } from "../resolve-config.js";
+import { log } from "../logger.js";
+import { migrateIfRequested } from "../migrate.js";
 function daysAgo(days) {
     const date = new Date();
     date.setDate(date.getDate() - days);
@@ -14,7 +16,7 @@ function createTimer(debug) {
         end: (label, startTime) => {
             if (debug) {
                 const elapsed = ((performance.now() - startTime) / 1000).toFixed(2);
-                console.log(`[DEBUG] ${label} completed in ${elapsed}s`);
+                log.debug(`${label} completed in ${elapsed}s`, true);
             }
         },
     };
@@ -29,38 +31,92 @@ export const syncCommand = new Command("sync")
     .option("--diagnose", "Show detailed diagnostics for unmatched URLs")
     .option("--diagnose-url <url>", "Diagnose why a specific URL is not matching")
     .option("--debug", "Enable debug logging with timing information")
+    .option("--migrate", "Run database migrations before syncing")
+    .option("--google-service-account <json>", "Google service account JSON")
+    .option("--db-url <url>", "PostgreSQL connection string")
+    .option("--sanity-project-id <id>", "Sanity project ID")
+    .option("--sanity-dataset <name>", "Sanity dataset name")
+    .option("--sanity-token <token>", "Sanity API token")
+    .option("--site-url <url>", "Your website base URL for URL matching")
     .action(async (options) => {
     const timer = createTimer(options.debug);
     const syncStartTime = timer.start();
-    const requiredEnvVars = [
-        "GOOGLE_SERVICE_ACCOUNT",
-        "DATABASE_URL",
-        "SANITY_PROJECT_ID",
-        "SANITY_DATASET",
-        "SANITY_TOKEN",
-        "SITE_URL",
-    ];
-    for (const envVar of requiredEnvVars) {
-        if (!process.env[envVar]) {
-            console.error(`Missing required environment variable: ${envVar}`);
-            process.exit(1);
-        }
+    // Validate --quiet-period
+    const quietPeriodDays = parseInt(options.quietPeriod);
+    if (isNaN(quietPeriodDays)) {
+        log.error(`Invalid --quiet-period value: "${options.quietPeriod}". Must be a number.`);
+        process.exit(1);
     }
+    const googleServiceAccount = resolve(options.googleServiceAccount, "GOOGLE_SERVICE_ACCOUNT");
+    const dbUrl = resolve(options.dbUrl, "DATABASE_URL");
+    const sanityProjectId = resolve(options.sanityProjectId, "SANITY_PROJECT_ID");
+    const sanityDataset = resolve(options.sanityDataset, "SANITY_DATASET");
+    const sanityToken = resolve(options.sanityToken, "SANITY_TOKEN");
+    const siteUrl = resolve(options.siteUrl, "SITE_URL");
+    requireConfig([
+        { name: "GOOGLE_SERVICE_ACCOUNT", flag: "--google-service-account <json>", envVar: "GOOGLE_SERVICE_ACCOUNT", value: googleServiceAccount },
+        { name: "DATABASE_URL", flag: "--db-url <url>", envVar: "DATABASE_URL", value: dbUrl },
+        { name: "SANITY_PROJECT_ID", flag: "--sanity-project-id <id>", envVar: "SANITY_PROJECT_ID", value: sanityProjectId },
+        { name: "SANITY_DATASET", flag: "--sanity-dataset <name>", envVar: "SANITY_DATASET", value: sanityDataset },
+        { name: "SANITY_TOKEN", flag: "--sanity-token <token>", envVar: "SANITY_TOKEN", value: sanityToken },
+        { name: "SITE_URL", flag: "--site-url <url>", envVar: "SITE_URL", value: siteUrl },
+    ]);
+    // Run migrations if requested
+    await migrateIfRequested(!!options.migrate, dbUrl);
     let t = timer.start();
     const sanity = createSanityClient({
-        projectId: process.env.SANITY_PROJECT_ID,
-        dataset: process.env.SANITY_DATASET,
-        token: process.env.SANITY_TOKEN,
+        projectId: sanityProjectId,
+        dataset: sanityDataset,
+        token: sanityToken,
         apiVersion: "2024-01-01",
         useCdn: false,
     });
-    const sql = postgres(process.env.DATABASE_URL);
-    const db = createDbWithClient(sql);
-    const gsc = new GSCClient({
-        credentials: JSON.parse(process.env.GOOGLE_SERVICE_ACCOUNT),
-    });
+    const { db, close } = createDb(dbUrl);
+    let credentials;
+    try {
+        credentials = JSON.parse(googleServiceAccount);
+    }
+    catch {
+        log.error("Failed to parse GOOGLE_SERVICE_ACCOUNT as JSON");
+        await close();
+        process.exit(1);
+    }
+    const gsc = new GSCClient({ credentials });
     timer.end("Client initialization", t);
-    console.log(`Starting sync for ${options.site}...`);
+    // Register shutdown handlers
+    const shutdown = async () => {
+        log.warn("Received shutdown signal, closing connections...");
+        await close();
+        process.exit(130);
+    };
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+    // Pre-flight connection validation
+    try {
+        log.info("Validating connections...");
+        t = timer.start();
+        await db.execute(sql `SELECT 1`);
+        timer.end("DB connection check", t);
+        t = timer.start();
+        await sanity.fetch('*[_type == "gscSite"][0]{ _id }');
+        timer.end("Sanity connection check", t);
+        t = timer.start();
+        const sites = await gsc.listSites();
+        timer.end("GSC connection check", t);
+        if (!sites.includes(options.site)) {
+            log.warn(`Site "${options.site}" not found in GSC site list. It may be new or the service account may lack access.`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        log.error(`Pre-flight connection check failed: ${message}`);
+        await close();
+        process.exitCode = 1;
+        process.removeListener("SIGTERM", shutdown);
+        process.removeListener("SIGINT", shutdown);
+        return;
+    }
+    log.info(`Starting sync for ${options.site}...`);
     // Find or create the gscSite document in Sanity
     t = timer.start();
     let siteDoc = await sanity.fetch(`*[_type == "gscSite" && siteUrl == $siteUrl][0]{
@@ -70,7 +126,7 @@ export const syncCommand = new Command("sync")
         slugField
       }`, { siteUrl: options.site });
     if (!siteDoc) {
-        console.log(`Creating gscSite document for ${options.site}...`);
+        log.info(`Creating gscSite document for ${options.site}...`);
         siteDoc = await sanity.create({
             _type: "gscSite",
             siteUrl: options.site,
@@ -85,15 +141,15 @@ export const syncCommand = new Command("sync")
     const contentTypes = siteDoc.contentTypes ?? ["post", "page"];
     const slugField = siteDoc.slugField ?? "slug";
     const pathPrefix = siteDoc.pathPrefix ?? undefined;
-    console.log(`Configuration:`);
-    console.log(`   Content types: ${contentTypes.join(", ")}`);
-    console.log(`   Slug field: ${slugField}`);
-    console.log(`   Path prefix: ${pathPrefix ?? "(none)"}`);
+    log.info(`Configuration:`);
+    log.info(`   Content types: ${contentTypes.join(", ")}`);
+    log.info(`   Slug field: ${slugField}`);
+    log.info(`   Path prefix: ${pathPrefix ?? "(none)"}`);
     const syncEngine = new SyncEngine({ gsc, db, sanity });
     const matcher = new URLMatcher(sanity, {
         contentTypes,
         slugField,
-        baseUrl: process.env.SITE_URL,
+        baseUrl: siteUrl,
         pathPrefix,
     });
     try {
@@ -104,16 +160,16 @@ export const syncCommand = new Command("sync")
             endDate: daysAgo(3),
         });
         timer.end("GSC data sync", t);
-        console.log(`Processed ${rowsProcessed} rows for ${pages.length} pages`);
+        log.info(`Processed ${rowsProcessed} rows for ${pages.length} pages`);
         t = timer.start();
         const matches = await matcher.matchUrls(pages);
         timer.end("URL matching", t);
         const matched = matches.filter((m) => !!m.sanityId);
         const unmatched = matches.filter((m) => !m.sanityId);
-        console.log(`Matched ${matched.length}/${pages.length} URLs to Sanity documents`);
+        log.info(`Matched ${matched.length}/${pages.length} URLs to Sanity documents`);
         // Store diagnostics for unmatched URLs
         if (unmatched.length > 0) {
-            console.log(`${unmatched.length} unmatched URLs`);
+            log.info(`${unmatched.length} unmatched URLs`);
             // Store diagnostics in database
             t = timer.start();
             for (const u of unmatched) {
@@ -162,7 +218,7 @@ export const syncCommand = new Command("sync")
             timer.end("Store unmatched diagnostics", t);
             // Show detailed diagnostics if --diagnose flag is set
             if (options.diagnose) {
-                console.log(`\nUnmatched URL Diagnostics:\n`);
+                log.info(`\nUnmatched URL Diagnostics:\n`);
                 // Group by reason
                 const byReason = new Map();
                 for (const u of unmatched) {
@@ -171,32 +227,31 @@ export const syncCommand = new Command("sync")
                     byReason.set(u.unmatchReason, existing);
                 }
                 for (const [reason, urls] of byReason) {
-                    console.log(`  ${getReasonEmoji(reason)} ${getReasonDescription(reason)} (${urls.length}):`);
+                    log.info(`  ${getReasonEmoji(reason)} ${getReasonDescription(reason)} (${urls.length}):`);
                     const toShow = urls.slice(0, 5);
                     for (const u of toShow) {
-                        console.log(`     ${u.gscUrl}`);
+                        log.info(`     ${u.gscUrl}`);
                         if (u.extractedSlug) {
-                            console.log(`        Extracted slug: "${u.extractedSlug}"`);
+                            log.info(`        Extracted slug: "${u.extractedSlug}"`);
                         }
                         if (u.diagnostics?.similarSlugs?.length) {
-                            console.log(`        Similar slugs in Sanity:`);
+                            log.info(`        Similar slugs in Sanity:`);
                             for (const similar of u.diagnostics.similarSlugs) {
-                                console.log(`          - ${similar}`);
+                                log.info(`          - ${similar}`);
                             }
                         }
                     }
                     if (urls.length > 5) {
-                        console.log(`     ... and ${urls.length - 5} more`);
+                        log.info(`     ... and ${urls.length - 5} more`);
                     }
-                    console.log();
                 }
             }
             else if (unmatched.length <= 10) {
-                unmatched.forEach((u) => console.log(`   - ${u.gscUrl}`));
-                console.log(`\n   Run with --diagnose for detailed diagnostics`);
+                unmatched.forEach((u) => log.info(`   - ${u.gscUrl}`));
+                log.info(`\n   Run with --diagnose for detailed diagnostics`);
             }
             else {
-                console.log(`   Run with --diagnose to see detailed diagnostics`);
+                log.info(`   Run with --diagnose to see detailed diagnostics`);
             }
         }
         // Handle --diagnose-url for a specific URL
@@ -204,25 +259,25 @@ export const syncCommand = new Command("sync")
             const targetUrl = options.diagnoseUrl;
             const allUrls = [targetUrl];
             const [result] = await matcher.matchUrls(allUrls);
-            console.log(`\nDiagnostics for: ${targetUrl}\n`);
+            log.info(`\nDiagnostics for: ${targetUrl}\n`);
             if (result) {
-                console.log(`   Matched: ${result.sanityId ? "Yes" : "No"}`);
-                console.log(`   Reason: ${getReasonDescription(result.unmatchReason)}`);
+                log.info(`   Matched: ${result.sanityId ? "Yes" : "No"}`);
+                log.info(`   Reason: ${getReasonDescription(result.unmatchReason)}`);
                 if (result.extractedSlug) {
-                    console.log(`   Extracted slug: "${result.extractedSlug}"`);
+                    log.info(`   Extracted slug: "${result.extractedSlug}"`);
                 }
                 if (result.matchedSlug) {
-                    console.log(`   Matched to Sanity slug: "${result.matchedSlug}"`);
+                    log.info(`   Matched to Sanity slug: "${result.matchedSlug}"`);
                 }
                 if (result.diagnostics) {
-                    console.log(`   Normalized URL: ${result.diagnostics.normalizedUrl}`);
-                    console.log(`   Path after prefix: ${result.diagnostics.pathAfterPrefix}`);
-                    console.log(`   Configured prefix: ${result.diagnostics.configuredPrefix ?? "(none)"}`);
-                    console.log(`   Available Sanity slugs: ${result.diagnostics.availableSlugsCount}`);
+                    log.info(`   Normalized URL: ${result.diagnostics.normalizedUrl}`);
+                    log.info(`   Path after prefix: ${result.diagnostics.pathAfterPrefix}`);
+                    log.info(`   Configured prefix: ${result.diagnostics.configuredPrefix ?? "(none)"}`);
+                    log.info(`   Available Sanity slugs: ${result.diagnostics.availableSlugsCount}`);
                     if (result.diagnostics.similarSlugs?.length) {
-                        console.log(`   Similar slugs in Sanity:`);
+                        log.info(`   Similar slugs in Sanity:`);
                         for (const similar of result.diagnostics.similarSlugs) {
-                            console.log(`      - ${similar}`);
+                            log.info(`      - ${similar}`);
                         }
                     }
                 }
@@ -230,12 +285,12 @@ export const syncCommand = new Command("sync")
         }
         // Check index status if requested
         if (options.checkIndex && matched.length > 0) {
-            console.log(`\nChecking index status for ${matched.length} pages...`);
+            log.info(`\nChecking index status for ${matched.length} pages...`);
             t = timer.start();
             const matchedUrls = matched.map((m) => m.gscUrl);
             const indexResult = await syncEngine.syncIndexStatus(options.site, matchedUrls);
             timer.end("Index status check", t);
-            console.log(`   Indexed: ${indexResult.indexed}, Not indexed: ${indexResult.notIndexed}, Skipped: ${indexResult.skipped}`);
+            log.info(`   Indexed: ${indexResult.indexed}, Not indexed: ${indexResult.notIndexed}, Skipped: ${indexResult.skipped}`);
         }
         if (!options.skipTasks) {
             t = timer.start();
@@ -243,16 +298,16 @@ export const syncCommand = new Command("sync")
             const detector = new DecayDetector(db);
             const signals = await detector.detectDecay(options.site, publishedDates, {
                 enabled: true,
-                days: parseInt(options.quietPeriod),
+                days: quietPeriodDays,
             });
             timer.end("Decay detection", t);
-            console.log(`Detected ${signals.length} decay signals`);
+            log.info(`Detected ${signals.length} decay signals`);
             if (options.dryRun) {
-                console.log("\nWould create the following tasks:");
+                log.info("\nWould create the following tasks:");
                 signals.forEach((s) => {
-                    console.log(`   [${s.severity.toUpperCase()}] ${s.page}`);
-                    console.log(`      Reason: ${s.reason}`);
-                    console.log(`      Position: ${s.metrics.positionBefore} -> ${s.metrics.positionNow}`);
+                    log.info(`   [${s.severity.toUpperCase()}] ${s.page}`);
+                    log.info(`      Reason: ${s.reason}`);
+                    log.info(`      Position: ${s.metrics.positionBefore} -> ${s.metrics.positionNow}`);
                 });
             }
             else {
@@ -260,24 +315,27 @@ export const syncCommand = new Command("sync")
                 const taskGenerator = new TaskGenerator(sanity);
                 const created = await taskGenerator.createTasks(siteId, signals, matches);
                 timer.end("Task generation", t);
-                console.log(`Created ${created} new refresh tasks`);
+                log.info(`Created ${created} new refresh tasks`);
             }
         }
         if (!options.dryRun) {
             t = timer.start();
             await syncEngine.writeSnapshots(siteId, matched);
             timer.end("Write Sanity snapshots", t);
-            console.log(`Updated Sanity snapshots`);
+            log.info(`Updated Sanity snapshots`);
         }
         timer.end("Total sync", syncStartTime);
-        console.log(`\nSync complete!`);
+        log.info(`\nSync complete!`);
     }
     catch (error) {
-        console.error("Sync failed:", error);
-        process.exit(1);
+        const message = error instanceof Error ? error.message : String(error);
+        log.error(`Sync failed: ${message}`);
+        process.exitCode = 1;
     }
     finally {
-        await sql.end();
+        await close();
+        process.removeListener("SIGTERM", shutdown);
+        process.removeListener("SIGINT", shutdown);
     }
 });
 async function getPublishedDates(sanity, matches) {

package/dist/index.js

@@ -1,10 +1,4 @@
 #!/usr/bin/env node
-import { config } from "dotenv";
-import { resolve } from "path";
-import { fileURLToPath } from "url";
-const __dirname = fileURLToPath(new URL(".", import.meta.url));
-// Load .env from monorepo root
-config({ path: resolve(__dirname, "../../../.env") });
 import { program } from "commander";
 import { syncCommand } from "./commands/sync.js";
 import { listSitesCommand } from "./commands/list-sites.js";

package/dist/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const log: {
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    debug(msg: string, enabled: boolean): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,GAAG;cACJ,MAAM;cAGN,MAAM;eAGL,MAAM;eAGN,MAAM,WAAW,OAAO;CAKpC,CAAC"}

package/dist/logger.js

@@ -0,0 +1,19 @@
+function format(level, msg) {
+    return `[${new Date().toISOString()}] [${level}]  ${msg}`;
+}
+export const log = {
+    info(msg) {
+        console.log(format("INFO", msg));
+    },
+    warn(msg) {
+        console.warn(format("WARN", msg));
+    },
+    error(msg) {
+        console.error(format("ERROR", msg));
+    },
+    debug(msg, enabled) {
+        if (enabled) {
+            console.log(format("DEBUG", msg));
+        }
+    },
+};

package/dist/migrate.d.ts

@@ -0,0 +1,2 @@
+export declare function migrateIfRequested(shouldMigrate: boolean, dbUrl: string): Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAKA,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAO7E"}

package/dist/migrate.js

@@ -0,0 +1,13 @@
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { runMigrations } from "@pagebridge/db";
+import { log } from "./logger.js";
+export async function migrateIfRequested(shouldMigrate, dbUrl) {
+    if (!shouldMigrate)
+        return;
+    log.info("Running database migrations...");
+    const pkgPath = import.meta.resolve("@pagebridge/db");
+    const migrationsFolder = resolve(fileURLToPath(pkgPath), "../../drizzle");
+    await runMigrations(dbUrl, migrationsFolder);
+    log.info("Migrations complete.");
+}

package/dist/resolve-config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Resolves a config value from a CLI option first, then env var fallback.
+ */
+export declare function resolve(optionValue: string | undefined, envVarName: string): string | undefined;
+interface ConfigEntry {
+    name: string;
+    flag: string;
+    envVar: string;
+    value: string | undefined;
+}
+/**
+ * Validates that all required config entries have values.
+ * If any are missing, prints a clear error listing every missing entry and exits.
+ */
+export declare function requireConfig(entries: ConfigEntry[]): void;
+export {};
+//# sourceMappingURL=resolve-config.d.ts.map

package/dist/resolve-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../src/resolve-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,OAAO,CACrB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAEpB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAU1D"}