@telepat/ideon 0.1.31 → 0.1.33

package/dist/ideon.js

@@ -586,7 +586,13 @@ var envSettingsSchema = z2.object({
   notificationsEnabled: z2.boolean().optional(),
   style: z2.enum(writingStyleValues).optional(),
   intent: z2.enum(contentIntentValues).optional(),
-  targetLength: targetLengthWordsSchema.optional()
+  targetLength: targetLengthWordsSchema.optional(),
+  googleAdsDeveloperToken: z2.string().optional(),
+  googleAdsClientId: z2.string().optional(),
+  googleAdsClientSecret: z2.string().optional(),
+  googleAdsRefreshToken: z2.string().optional(),
+  googleAdsCustomerId: z2.string().optional(),
+  googleAdsLoginCustomerId: z2.string().optional()
 });
 var jobInputSchema = z2.object({
   idea: z2.string().min(1).optional(),
@@ -619,9 +625,9 @@ function parseBoolean(value2) {
 }
 function readEnvSettings(env = process.env) {
   return envSettingsSchema.parse({
-    openRouterApiKey: env.IDEON_OPENROUTER_API_KEY,
-    replicateApiToken: env.IDEON_REPLICATE_API_TOKEN,
-    disableKeytar: parseBoolean(env.IDEON_DISABLE_KEYTAR),
+    openRouterApiKey: env.TELEPAT_OPENROUTER_KEY,
+    replicateApiToken: env.TELEPAT_REPLICATE_TOKEN,
+    disableKeytar: parseBoolean(env.TELEPAT_DISABLE_KEYTAR),
     model: env.IDEON_MODEL,
     temperature: parseNumber(env.IDEON_TEMPERATURE),
     maxTokens: parseNumber(env.IDEON_MAX_TOKENS),
@@ -631,7 +637,13 @@ function readEnvSettings(env = process.env) {
     notificationsEnabled: parseBoolean(env.IDEON_NOTIFICATIONS_ENABLED),
     style: env.IDEON_STYLE,
     intent: env.IDEON_INTENT,
-    targetLength: env.IDEON_TARGET_LENGTH
+    targetLength: env.IDEON_TARGET_LENGTH,
+    googleAdsDeveloperToken: env.TELEPAT_GOOGLE_ADS_DEVELOPER_TOKEN,
+    googleAdsClientId: env.TELEPAT_GOOGLE_ADS_CLIENT_ID,
+    googleAdsClientSecret: env.TELEPAT_GOOGLE_ADS_CLIENT_SECRET,
+    googleAdsRefreshToken: env.TELEPAT_GOOGLE_ADS_REFRESH_TOKEN,
+    googleAdsCustomerId: env.TELEPAT_GOOGLE_ADS_CUSTOMER_ID,
+    googleAdsLoginCustomerId: env.TELEPAT_GOOGLE_ADS_LOGIN_CUSTOMER_ID
   });
 }
 
@@ -666,6 +678,12 @@ async function saveSettings(settings) {
 var SERVICE_NAME = "ideon";
 var OPENROUTER_ACCOUNT = "openrouter-api-key";
 var REPLICATE_ACCOUNT = "replicate-api-token";
+var GOOGLE_ADS_DEVELOPER_TOKEN_ACCOUNT = "google-ads-developer-token";
+var GOOGLE_ADS_CLIENT_ID_ACCOUNT = "google-ads-client-id";
+var GOOGLE_ADS_CLIENT_SECRET_ACCOUNT = "google-ads-client-secret";
+var GOOGLE_ADS_REFRESH_TOKEN_ACCOUNT = "google-ads-refresh-token";
+var GOOGLE_ADS_CUSTOMER_ID_ACCOUNT = "google-ads-customer-id";
+var GOOGLE_ADS_LOGIN_CUSTOMER_ID_ACCOUNT = "google-ads-login-customer-id";
 var KEYTAR_UNAVAILABLE_ERROR_NAME = "KeytarUnavailableError";
 var hasWarnedAboutUnavailableKeytar = false;
 var keytarClientPromise = null;
@@ -679,7 +697,13 @@ var KeytarUnavailableError = class extends Error {
 function nullSecrets() {
   return {
     openRouterApiKey: null,
-    replicateApiToken: null
+    replicateApiToken: null,
+    googleAdsDeveloperToken: null,
+    googleAdsClientId: null,
+    googleAdsClientSecret: null,
+    googleAdsRefreshToken: null,
+    googleAdsCustomerId: null,
+    googleAdsLoginCustomerId: null
   };
 }
 function shouldDisableKeytar(options) {
@@ -725,7 +749,7 @@ function warnKeytarUnavailable(details) {
   }
   hasWarnedAboutUnavailableKeytar = true;
   console.warn(
-    `System keychain unavailable (${details}). Falling back to environment variables for secrets. Set IDEON_DISABLE_KEYTAR=true to skip keychain access in this environment.`
+    `System keychain unavailable (${details}). Falling back to environment variables for secrets. Set TELEPAT_DISABLE_KEYTAR=true to skip keychain access in this environment.`
   );
 }
 async function getKeytarClient() {
@@ -751,13 +775,34 @@ async function loadSecrets(options = {}) {
     return nullSecrets();
   }
   try {
-    const [openRouterApiKey, replicateApiToken] = await Promise.all([
+    const [
+      openRouterApiKey,
+      replicateApiToken,
+      googleAdsDeveloperToken,
+      googleAdsClientId,
+      googleAdsClientSecret,
+      googleAdsRefreshToken,
+      googleAdsCustomerId,
+      googleAdsLoginCustomerId
+    ] = await Promise.all([
       keytarClient.getPassword(SERVICE_NAME, OPENROUTER_ACCOUNT),
-      keytarClient.getPassword(SERVICE_NAME, REPLICATE_ACCOUNT)
+      keytarClient.getPassword(SERVICE_NAME, REPLICATE_ACCOUNT),
+      keytarClient.getPassword(SERVICE_NAME, GOOGLE_ADS_DEVELOPER_TOKEN_ACCOUNT),
+      keytarClient.getPassword(SERVICE_NAME, GOOGLE_ADS_CLIENT_ID_ACCOUNT),
+      keytarClient.getPassword(SERVICE_NAME, GOOGLE_ADS_CLIENT_SECRET_ACCOUNT),
+      keytarClient.getPassword(SERVICE_NAME, GOOGLE_ADS_REFRESH_TOKEN_ACCOUNT),
+      keytarClient.getPassword(SERVICE_NAME, GOOGLE_ADS_CUSTOMER_ID_ACCOUNT),
+      keytarClient.getPassword(SERVICE_NAME, GOOGLE_ADS_LOGIN_CUSTOMER_ID_ACCOUNT)
     ]);
     return {
       openRouterApiKey,
-      replicateApiToken
+      replicateApiToken,
+      googleAdsDeveloperToken,
+      googleAdsClientId,
+      googleAdsClientSecret,
+      googleAdsRefreshToken,
+      googleAdsCustomerId,
+      googleAdsLoginCustomerId
     };
   } catch (error) {
     if (isKeytarAvailabilityError(error)) {
@@ -771,13 +816,13 @@ async function loadSecrets(options = {}) {
 async function saveSecrets(secrets, options = {}) {
   if (shouldDisableKeytar(options)) {
     throw new KeytarUnavailableError(
-      "System keychain access is disabled by IDEON_DISABLE_KEYTAR=true. Use IDEON_OPENROUTER_API_KEY and IDEON_REPLICATE_API_TOKEN instead."
+      "System keychain access is disabled by TELEPAT_DISABLE_KEYTAR=true. Use TELEPAT_OPENROUTER_KEY and TELEPAT_REPLICATE_TOKEN instead."
     );
   }
   const keytarClient = await getKeytarClient();
   if (!keytarClient) {
     throw new KeytarUnavailableError(
-      `System keychain unavailable while saving credentials (${keytarUnavailableReason ?? "keytar module failed to load"}). Use IDEON_OPENROUTER_API_KEY and IDEON_REPLICATE_API_TOKEN instead.`
+      `System keychain unavailable while saving credentials (${keytarUnavailableReason ?? "keytar module failed to load"}). Use TELEPAT_OPENROUTER_KEY and TELEPAT_REPLICATE_TOKEN instead.`
     );
   }
   const tasks = [];
@@ -787,6 +832,24 @@ async function saveSecrets(secrets, options = {}) {
   if (secrets.replicateApiToken !== void 0) {
     tasks.push(saveSecretValue(keytarClient, REPLICATE_ACCOUNT, secrets.replicateApiToken));
   }
+  if (secrets.googleAdsDeveloperToken !== void 0) {
+    tasks.push(saveSecretValue(keytarClient, GOOGLE_ADS_DEVELOPER_TOKEN_ACCOUNT, secrets.googleAdsDeveloperToken));
+  }
+  if (secrets.googleAdsClientId !== void 0) {
+    tasks.push(saveSecretValue(keytarClient, GOOGLE_ADS_CLIENT_ID_ACCOUNT, secrets.googleAdsClientId));
+  }
+  if (secrets.googleAdsClientSecret !== void 0) {
+    tasks.push(saveSecretValue(keytarClient, GOOGLE_ADS_CLIENT_SECRET_ACCOUNT, secrets.googleAdsClientSecret));
+  }
+  if (secrets.googleAdsRefreshToken !== void 0) {
+    tasks.push(saveSecretValue(keytarClient, GOOGLE_ADS_REFRESH_TOKEN_ACCOUNT, secrets.googleAdsRefreshToken));
+  }
+  if (secrets.googleAdsCustomerId !== void 0) {
+    tasks.push(saveSecretValue(keytarClient, GOOGLE_ADS_CUSTOMER_ID_ACCOUNT, secrets.googleAdsCustomerId));
+  }
+  if (secrets.googleAdsLoginCustomerId !== void 0) {
+    tasks.push(saveSecretValue(keytarClient, GOOGLE_ADS_LOGIN_CUSTOMER_ID_ACCOUNT, secrets.googleAdsLoginCustomerId));
+  }
   await Promise.all(tasks);
 }
 async function saveSecretValue(keytarClient, account, value2) {
@@ -800,7 +863,7 @@ async function saveSecretValue(keytarClient, account, value2) {
     if (isKeytarAvailabilityError(error)) {
       const message = readErrorMessage(error);
       throw new KeytarUnavailableError(
-        `System keychain unavailable while saving credentials (${message}). Use IDEON_OPENROUTER_API_KEY and IDEON_REPLICATE_API_TOKEN instead.`
+        `System keychain unavailable while saving credentials (${message}). Use TELEPAT_OPENROUTER_KEY and TELEPAT_REPLICATE_TOKEN instead.`
       );
     }
     throw error;
@@ -820,7 +883,16 @@ var configSettingKeys = [
   "intent",
   "targetLength"
 ];
-var configSecretKeys = ["openRouterApiKey", "replicateApiToken"];
+var configSecretKeys = [
+  "openRouterApiKey",
+  "replicateApiToken",
+  "googleAdsDeveloperToken",
+  "googleAdsClientId",
+  "googleAdsClientSecret",
+  "googleAdsRefreshToken",
+  "googleAdsCustomerId",
+  "googleAdsLoginCustomerId"
+];
 function isConfigSettingKey(key) {
   return configSettingKeys.includes(key);
 }
@@ -850,7 +922,13 @@ async function configList() {
     },
     secrets: {
       openRouterApiKey: Boolean(secrets.openRouterApiKey),
-      replicateApiToken: Boolean(secrets.replicateApiToken)
+      replicateApiToken: Boolean(secrets.replicateApiToken),
+      googleAdsDeveloperToken: Boolean(secrets.googleAdsDeveloperToken),
+      googleAdsClientId: Boolean(secrets.googleAdsClientId),
+      googleAdsClientSecret: Boolean(secrets.googleAdsClientSecret),
+      googleAdsRefreshToken: Boolean(secrets.googleAdsRefreshToken),
+      googleAdsCustomerId: Boolean(secrets.googleAdsCustomerId),
+      googleAdsLoginCustomerId: Boolean(secrets.googleAdsLoginCustomerId)
     }
   };
 }
@@ -1088,6 +1166,32 @@ var configUnsetToolInputSchema = {
   key: z3.enum(configKeys)
 };
 var configUnsetToolInputZodSchema = z3.object(configUnsetToolInputSchema);
+var gkpGenerateIdeasToolInputSchema = {
+  seedKeywords: z3.array(z3.string().min(1)).optional(),
+  url: z3.string().min(1).optional(),
+  site: z3.string().min(1).optional(),
+  countryCodes: z3.array(z3.string().min(1)).optional(),
+  language: z3.string().min(1).optional(),
+  pageSize: z3.coerce.number().int().positive().optional()
+};
+var gkpGenerateIdeasToolInputZodSchema = z3.object(gkpGenerateIdeasToolInputSchema);
+var gkpGetHistoricalDataToolInputSchema = {
+  keywords: z3.array(z3.string().min(1)).min(1),
+  countryCodes: z3.array(z3.string().min(1)).optional(),
+  language: z3.string().min(1).optional(),
+  includeAverageCpc: z3.boolean().optional()
+};
+var gkpGetHistoricalDataToolInputZodSchema = z3.object(gkpGetHistoricalDataToolInputSchema);
+var gkpGetForecastDataToolInputSchema = {
+  keywords: z3.array(z3.string().min(1)).min(1),
+  keywordMatchType: z3.enum(["BROAD", "EXACT", "PHRASE"]).optional(),
+  maxCpcBidMicros: z3.coerce.number().int().positive().optional(),
+  countryCodes: z3.array(z3.string().min(1)).optional(),
+  language: z3.string().min(1).optional(),
+  startDate: z3.string().min(1).optional(),
+  endDate: z3.string().min(1).optional()
+};
+var gkpGetForecastDataToolInputZodSchema = z3.object(gkpGetForecastDataToolInputSchema);
 var ideonToolContracts = [
   {
     name: "ideon_write",
@@ -1145,6 +1249,23 @@ var ideonToolContracts = [
     enums: {
       key: [...configKeys]
     }
+  },
+  {
+    name: "gkp_generate_ideas",
+    required: [],
+    enums: {}
+  },
+  {
+    name: "gkp_get_historical_data",
+    required: ["keywords"],
+    enums: {}
+  },
+  {
+    name: "gkp_get_forecast_data",
+    required: ["keywords"],
+    enums: {
+      keywordMatchType: ["BROAD", "EXACT", "PHRASE"]
+    }
   }
 ];
 
@@ -1428,7 +1549,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // package.json
 var package_default = {
   name: "@telepat/ideon",
-  version: "0.1.31",
+  version: "0.1.33",
   description: "CLI for generating rich articles and images from ideas.",
   type: "module",
   repository: {
@@ -1535,17 +1656,17 @@ var package_default = {
 
 // src/config/resolver.ts
 import { readFile as readFile3 } from "fs/promises";
-async function resolveRunInput(input) {
+async function resolveRunInput(input2) {
   const envSettings = readEnvSettings();
   const [savedSettings, secrets] = await Promise.all([
     loadSavedSettings(),
     loadSecrets({ disableKeytar: envSettings.disableKeytar })
   ]);
-  const job = input.jobPath ? await loadJobInput(input.jobPath) : null;
+  const job = input2.jobPath ? await loadJobInput(input2.jobPath) : null;
   assertNoLegacyXMode(savedSettings.contentTargets, "saved settings contentTargets");
   assertNoLegacyXMode(job?.settings?.contentTargets, "job settings contentTargets");
-  assertNoLegacyXMode(input.contentTargets, "CLI contentTargets");
-  assertExactlyOnePrimary(input.contentTargets, "CLI contentTargets");
+  assertNoLegacyXMode(input2.contentTargets, "CLI contentTargets");
+  assertExactlyOnePrimary(input2.contentTargets, "CLI contentTargets");
   const mergedSettings = appSettingsSchema.parse({
     ...savedSettings,
     ...job?.settings ?? {},
@@ -1571,22 +1692,28 @@ async function resolveRunInput(input) {
     ...envSettings.style ? { style: envSettings.style } : {},
     ...envSettings.intent ? { intent: envSettings.intent } : {},
     ...envSettings.targetLength ? { targetLength: envSettings.targetLength } : {},
-    ...input.style ? { style: input.style } : {},
-    ...input.intent ? { intent: input.intent } : {},
-    ...input.targetLength ? { targetLength: input.targetLength } : {},
-    ...input.contentTargets ? { contentTargets: input.contentTargets } : {}
+    ...input2.style ? { style: input2.style } : {},
+    ...input2.intent ? { intent: input2.intent } : {},
+    ...input2.targetLength ? { targetLength: input2.targetLength } : {},
+    ...input2.contentTargets ? { contentTargets: input2.contentTargets } : {}
   });
-  const idea = input.idea ?? job?.idea ?? job?.prompt;
+  const idea = input2.idea ?? job?.idea ?? job?.prompt;
   if (!idea) {
     throw new Error("No idea provided. Pass an argument to `ideon write` or use --job with an idea in the JSON file.");
   }
-  const targetAudienceHint = normalizeOptionalText(input.audience) ?? normalizeOptionalText(job?.targetAudience);
+  const targetAudienceHint = normalizeOptionalText(input2.audience) ?? normalizeOptionalText(job?.targetAudience);
   return {
     config: {
       settings: mergedSettings,
       secrets: {
         openRouterApiKey: envSettings.openRouterApiKey ?? secrets.openRouterApiKey,
-        replicateApiToken: envSettings.replicateApiToken ?? secrets.replicateApiToken
+        replicateApiToken: envSettings.replicateApiToken ?? secrets.replicateApiToken,
+        googleAdsDeveloperToken: envSettings.googleAdsDeveloperToken ?? secrets.googleAdsDeveloperToken,
+        googleAdsClientId: envSettings.googleAdsClientId ?? secrets.googleAdsClientId,
+        googleAdsClientSecret: envSettings.googleAdsClientSecret ?? secrets.googleAdsClientSecret,
+        googleAdsRefreshToken: envSettings.googleAdsRefreshToken ?? secrets.googleAdsRefreshToken,
+        googleAdsCustomerId: envSettings.googleAdsCustomerId ?? secrets.googleAdsCustomerId,
+        googleAdsLoginCustomerId: envSettings.googleAdsLoginCustomerId ?? secrets.googleAdsLoginCustomerId
       }
     },
     idea,
@@ -2064,6 +2191,9 @@ function intentToGuidePath(intent) {
 function styleToGuidePath(style) {
   return `writing-guide/styles/${style}.md`;
 }
+function seoGuidePath(name) {
+  return `writing-guide/seo/${name}.md`;
+}
 function dedupe(items) {
   return Array.from(new Set(items));
 }
@@ -2079,6 +2209,7 @@ function buildPrimaryPlanGuideInstruction(intent, contentType) {
     "writing-guide/references/headline-writing-systems.md",
     "writing-guide/references/ideation-and-credibility-systems.md",
     "writing-guide/references/content-frameworks.md",
+    seoGuidePath("on-page-essentials"),
     intentToGuidePath(intent),
     formatToGuidePath(contentType)
   ];
@@ -2098,6 +2229,9 @@ function buildArticleSectionGuideInstruction(style, intent, contentType) {
     "writing-guide/references/prose-quality-checks.md",
     "writing-guide/references/readability-and-pace.md",
     "writing-guide/references/skimmability-patterns.md",
+    seoGuidePath("on-page-essentials"),
+    seoGuidePath("eeat-signals"),
+    seoGuidePath("fact-density"),
     styleToGuidePath(style),
     intentToGuidePath(intent),
     formatToGuidePath(contentType)
@@ -2445,9 +2579,9 @@ function buildLongFormPlanMessages(idea, options) {
         "",
         "Requirements:",
         "- The content should feel authoritative, practical, and clearly structured for scanning and deep reading.",
-        "- Generate a memorable title and a sharp subtitle that promise a concrete benefit, mechanism, or outcome.",
+        "- Generate a memorable title (under 60 characters) that leads with the primary entity. Include a sharp subtitle that promises a concrete benefit, mechanism, or outcome.",
         "- The slug must be lowercase kebab-case and publication-ready.",
-        "- The description should work as a concise meta description and align with the shared content plan.",
+        "- The description should work as a concise meta description (120-160 characters), include the primary entity, and align with the shared content plan.",
         `- Plan ${sectionCounts.label} strong sections with distinct focus areas and logical progression (no repetitive section intent).`,
         "- Frame section titles to reflect likely search intent or practical reader questions when appropriate.",
         "- Each section description should name the mechanism, evidence type, or practical action that makes the section useful.",
@@ -2468,7 +2602,7 @@ function buildLongFormPlanMessages(idea, options) {
         `- contentType: set to "${options.contentType}" exactly`,
         "- title: string",
         "- subtitle: string",
-        "- keywords: array of 3 to 8 strings",
+        "- keywords: array of 3 to 8 specific, non-generic strings representing primary entities and search topics (not exact-match duplicates of heading text)",
         "- slug: string in lowercase kebab-case",
         "- description: string",
         "- introBrief: string",
@@ -2615,6 +2749,30 @@ async function planPrimaryContent({
       return shortFormPlanSchema.parse(data);
     }
   });
+  if (!dryRun) {
+    const seoWarnings = [];
+    if (basePlan.title && basePlan.title.length > 60) {
+      seoWarnings.push(`Title is ${basePlan.title.length} chars (recommended: under 60 for search display safety)`);
+    }
+    if (basePlan.description) {
+      if (basePlan.description.length < 120) {
+        seoWarnings.push(`Description is ${basePlan.description.length} chars (recommended: 120-160 for meta description effectiveness)`);
+      } else if (basePlan.description.length > 160) {
+        seoWarnings.push(`Description is ${basePlan.description.length} chars (recommended: 120-160 for meta description effectiveness)`);
+      }
+    }
+    if (isLongForm) {
+      const longPlan = basePlan;
+      const headings = longPlan.sections.map((s) => s.title.toLowerCase());
+      const duplicateKeywords = longPlan.keywords.filter((kw) => headings.includes(kw.toLowerCase()));
+      if (duplicateKeywords.length > 0) {
+        seoWarnings.push(`Keywords duplicate heading text: ${duplicateKeywords.join(", ")} (consider using semantic variants)`);
+      }
+    }
+    for (const warning of seoWarnings) {
+      console.warn(`[seo] ${warning}`);
+    }
+  }
   const normalizedSlug = slugify(basePlan.slug || basePlan.title);
   const uniqueSlug = await resolveUniqueSlug(markdownOutputDir, normalizedSlug);
   if (isLongForm) {
@@ -2949,7 +3107,8 @@ function buildSectionMessages(plan, section, articleSoFar, style, intent, conten
         "Requirements:",
         `- ${paragraphCount} paragraphs.`,
         `- Target length: about ${sectionTargetWords} words.`,
-        "- Be concrete and specific.",
+        "- Be concrete and specific. Support key claims with statistics, data points, or authoritative citations.",
+        "- Include at least one practical insight that sounds like first-hand practitioner experience.",
         "- Continue naturally from the article draft so far without rehashing prior sections.",
         "- Use short Markdown lists only if they materially improve clarity."
       ].join("\n")
@@ -3232,13 +3391,13 @@ async function withRetry(op, opts) {
   }
   throw buildFinalError(opts.operationLabel, attemptsMade, lastError, lastClassification);
 }
-function computeDelayMs(input) {
-  if (typeof input.retryAfterMs === "number" && input.retryAfterMs > 0) {
-    return Math.min(input.maxBackoffMs, input.retryAfterMs);
+function computeDelayMs(input2) {
+  if (typeof input2.retryAfterMs === "number" && input2.retryAfterMs > 0) {
+    return Math.min(input2.maxBackoffMs, input2.retryAfterMs);
   }
-  const exponential = input.baseBackoffMs * 2 ** (input.attempt - 1);
-  const capped = Math.min(input.maxBackoffMs, exponential);
-  const jitter = input.jitterMs > 0 ? input.randomFraction() * input.jitterMs : 0;
+  const exponential = input2.baseBackoffMs * 2 ** (input2.attempt - 1);
+  const capped = Math.min(input2.maxBackoffMs, exponential);
+  const jitter = input2.jitterMs > 0 ? input2.randomFraction() * input2.jitterMs : 0;
   return Math.floor(capped + jitter);
 }
 function classifyHttpError(error) {
@@ -4296,18 +4455,18 @@ ${body.join("\n").trim()}
 
 // src/output/meta.ts
 import path7 from "path";
-function buildMetaJson(input) {
-  const plan = input.plan;
-  const contentPlan = input.contentPlan;
-  const generationDir = input.generationDir;
-  const title = plan?.title ?? contentPlan?.title ?? input.idea;
+function buildMetaJson(input2) {
+  const plan = input2.plan;
+  const contentPlan = input2.contentPlan;
+  const generationDir = input2.generationDir;
+  const title = plan?.title ?? contentPlan?.title ?? input2.idea;
   const slug = plan?.slug ?? "";
   const description = plan?.description ?? contentPlan?.description ?? "";
   const subtitle = (plan && "subtitle" in plan ? plan.subtitle : null) ?? null;
   const keywords = (plan && "keywords" in plan ? plan.keywords : null) ?? [];
   const contentType = plan?.contentType ?? contentPlan?.primaryContentType ?? "article";
   const angle = plan?.angle ?? null;
-  const coverImage = input.renderedImages.find((image) => image.kind === "cover") ?? null;
+  const coverImage = input2.renderedImages.find((image) => image.kind === "cover") ?? null;
   const cover = coverImage ? {
     path: coverImage.outputPath,
     relativePath: coverImage.relativePath,
@@ -4317,7 +4476,7 @@ function buildMetaJson(input) {
     title: section.title,
     description: section.description
   })) ?? [];
-  const images = input.renderedImages.map((image) => ({
+  const images = input2.renderedImages.map((image) => ({
     id: image.id,
     kind: image.kind,
     path: image.outputPath,
@@ -4325,30 +4484,30 @@ function buildMetaJson(input) {
     description: image.description,
     anchorAfterSection: image.anchorAfterSection
   }));
-  const outputs = input.outputs.map((output) => ({
-    fileId: output.fileId,
-    contentType: output.contentType,
-    path: output.markdownPath,
-    relativePath: path7.relative(generationDir, output.markdownPath)
+  const outputs = input2.outputs.map((output2) => ({
+    fileId: output2.fileId,
+    contentType: output2.contentType,
+    path: output2.markdownPath,
+    relativePath: path7.relative(generationDir, output2.markdownPath)
   }));
   return {
     version: 1,
     title,
     slug,
-    idea: input.idea,
+    idea: input2.idea,
     description,
     subtitle,
     keywords,
     contentType,
-    style: input.style,
-    intent: input.intent,
-    targetLength: input.targetLength,
+    style: input2.style,
+    intent: input2.intent,
+    targetLength: input2.targetLength,
     angle,
     cover,
     sections,
     images,
     outputs,
-    generatedAt: input.generatedAt,
+    generatedAt: input2.generatedAt,
     generationDir
   };
 }
@@ -4587,12 +4746,12 @@ function createInitialStages() {
     }
   ];
 }
-async function runPipelineShell(input, options = {}) {
+async function runPipelineShell(input2, options = {}) {
   const runStartedAtMs = Date.now();
   const runStartedAt = new Date(runStartedAtMs).toISOString();
   const runId = randomUUID();
-  const primaryTarget = getPrimaryTarget(input.config.settings.contentTargets);
-  const secondaryTargets = getSecondaryTargets(input.config.settings.contentTargets);
+  const primaryTarget = getPrimaryTarget(input2.config.settings.contentTargets);
+  const secondaryTargets = getSecondaryTargets(input2.config.settings.contentTargets);
   const stages = createInitialStages();
   options.onUpdate?.(cloneStages(stages));
   const dryRun = options.dryRun ?? false;
@@ -4658,10 +4817,10 @@ async function runPipelineShell(input, options = {}) {
   if (runMode === "fresh") {
     writeSession = await startFreshWriteSession(
       {
-        idea: input.idea,
-        targetAudienceHint: input.targetAudienceHint,
-        job: input.job,
-        settings: input.config.settings,
+        idea: input2.idea,
+        targetAudienceHint: input2.targetAudienceHint,
+        job: input2.job,
+        settings: input2.config.settings,
         dryRun,
         outputPaths
       },
@@ -4678,13 +4837,13 @@ async function runPipelineShell(input, options = {}) {
   }
   try {
     await ensureOutputDirectories(writeSession.outputPaths);
-    const openRouter = dryRun ? null : new OpenRouterClient(requireSecret(input.config.secrets.openRouterApiKey, "OpenRouter API key"));
-    const canRenderImagesLive = Boolean(input.config.secrets.replicateApiToken);
+    const openRouter = dryRun ? null : new OpenRouterClient(requireSecret(input2.config.secrets.openRouterApiKey, "OpenRouter API key"));
+    const canRenderImagesLive = Boolean(input2.config.secrets.replicateApiToken);
     const imageDryRun = dryRun || !canRenderImagesLive;
     const limn = imageDryRun ? null : new Limn({
-      openrouterApiKey: input.config.secrets.openRouterApiKey ?? void 0,
-      replicateApiKey: requireSecret(input.config.secrets.replicateApiToken, "Replicate API token"),
-      openrouterModel: input.config.settings.model
+      openrouterApiKey: input2.config.secrets.openRouterApiKey ?? void 0,
+      replicateApiKey: requireSecret(input2.config.secrets.replicateApiToken, "Replicate API token"),
+      openrouterModel: input2.config.settings.model
     });
     let contentPlan = writeSession.contentPlan;
     let plan = writeSession.plan;
@@ -4704,9 +4863,9 @@ async function runPipelineShell(input, options = {}) {
       };
     } else {
       contentPlan = await planContentPlan({
-        idea: input.idea,
-        targetAudienceHint: input.targetAudienceHint,
-        settings: input.config.settings,
+        idea: input2.idea,
+        targetAudienceHint: input2.targetAudienceHint,
+        settings: input2.config.settings,
         openRouter,
         dryRun,
         onInteraction(interaction) {
@@ -4756,10 +4915,10 @@ async function runPipelineShell(input, options = {}) {
         throw new Error("Shared content plan is missing for primary planning stage.");
       }
       plan = await planPrimaryContent({
-        idea: input.idea,
+        idea: input2.idea,
         contentType: primaryTarget.contentType,
         contentPlan,
-        settings: input.config.settings,
+        settings: input2.config.settings,
         markdownOutputDir: writeSession.outputPaths.markdownOutputDir,
         openRouter,
         dryRun,
@@ -4826,7 +4985,7 @@ async function runPipelineShell(input, options = {}) {
         const sectionItemTracking = /* @__PURE__ */ new Map();
         text = await writeArticleSections({
           plan: longPlan,
-          settings: input.config.settings,
+          settings: input2.config.settings,
           openRouter,
           dryRun,
           onInteraction(interaction) {
@@ -4941,7 +5100,7 @@ async function runPipelineShell(input, options = {}) {
           slots: buildImageSlots(longPlan, text.sections, { maxImages: options.maxImages }),
           planContext: longPlan,
           sections: text.sections,
-          settings: input.config.settings,
+          settings: input2.config.settings,
           openRouter,
           dryRun,
           onInteraction(interaction) {
@@ -5008,18 +5167,18 @@ async function runPipelineShell(input, options = {}) {
       markStageStarted(stageTracking, "sections");
       options.onUpdate?.(cloneStages(stages));
       primaryMarkdownTemplate = await writeSingleShotContent({
-        idea: input.idea,
+        idea: input2.idea,
         contentType: primaryTarget.contentType,
         role: "primary",
         primaryContentType: primaryTarget.contentType,
-        style: input.config.settings.style,
-        intent: input.config.settings.intent,
+        style: input2.config.settings.style,
+        intent: input2.config.settings.intent,
         outputIndex: 1,
         outputCountForType: 1,
         articleReferenceMarkdown: void 0,
         contentPlan,
         plan,
-        settings: input.config.settings,
+        settings: input2.config.settings,
         openRouter,
         dryRun,
         onInteraction(interaction) {
@@ -5066,7 +5225,7 @@ async function runPipelineShell(input, options = {}) {
       };
       options.onUpdate?.(cloneStages(stages));
     }
-    const baseSlug = plan?.slug ?? resolveGenerationSlug(input.idea, contentPlan?.title);
+    const baseSlug = plan?.slug ?? resolveGenerationSlug(input2.idea, contentPlan?.title);
     const generationDir = path9.join(
       writeSession.outputPaths.markdownOutputDir,
       buildGenerationDirectoryName(baseSlug)
@@ -5076,12 +5235,12 @@ async function runPipelineShell(input, options = {}) {
     await writeJsonFile(
       jobDefinitionPath,
       buildRunJobDefinition({
-        idea: input.idea,
-        targetAudienceHint: input.targetAudienceHint,
+        idea: input2.idea,
+        targetAudienceHint: input2.targetAudienceHint,
         dryRun,
         runMode,
-        settings: input.config.settings,
-        sourceJob: input.job
+        settings: input2.config.settings,
+        sourceJob: input2.job
       })
     );
     const planPath = plan ? path9.join(generationDir, "plan.md") : null;
@@ -5108,7 +5267,7 @@ async function runPipelineShell(input, options = {}) {
         }
         const renderedImages = await renderExpandedImages({
           prompts: imagePrompts,
-          settings: input.config.settings,
+          settings: input2.config.settings,
           limn,
           markdownPath: primaryMarkdownPath,
           assetDir: sharedAssetDir,
@@ -5192,7 +5351,7 @@ async function runPipelineShell(input, options = {}) {
       } else {
         const renderedImages = await renderExpandedImages({
           prompts: imagePrompts,
-          settings: input.config.settings,
+          settings: input2.config.settings,
           limn,
           markdownPath: primaryMarkdownPath,
           assetDir: sharedAssetDir,
@@ -5253,11 +5412,11 @@ async function runPipelineShell(input, options = {}) {
       }
       const coverImage = imageArtifacts?.renderedImages.find((image) => image.kind === "cover") ?? null;
       if (coverImage) {
-        primaryMarkdownTemplate = withCoverImage(primaryMarkdownTemplate, coverImage.relativePath, plan.title || deriveTitleFromIdea2(input.idea));
+        primaryMarkdownTemplate = withCoverImage(primaryMarkdownTemplate, coverImage.relativePath, plan.title || deriveTitleFromIdea2(input2.idea));
       }
       primaryMarkdownTemplate = applyPrimaryTitleHeading(
         primaryMarkdownTemplate,
-        plan.title || contentPlan.title || deriveTitleFromIdea2(input.idea)
+        plan.title || contentPlan.title || deriveTitleFromIdea2(input2.idea)
       );
     }
     const markdownPaths = [];
@@ -5278,9 +5437,9 @@ async function runPipelineShell(input, options = {}) {
       ...stages[5],
       status: "running",
       detail: requestedOutputs.length > 0 ? "Generating secondary channel outputs from primary anchor content." : "No secondary content requested.",
-      items: requestedOutputs.map((output) => ({
-        id: toOutputItemId(output.filePrefix, output.index),
-        label: formatOutputItemLabel(output.contentType, output.index, output.outputCountForType),
+      items: requestedOutputs.map((output2) => ({
+        id: toOutputItemId(output2.filePrefix, output2.index),
+        label: formatOutputItemLabel(output2.contentType, output2.index, output2.outputCountForType),
         status: "pending",
         detail: "Waiting to start."
       }))
@@ -5290,8 +5449,8 @@ async function runPipelineShell(input, options = {}) {
     if (!contentPlan) {
       throw new Error("Shared content plan is missing for output generation stage.");
     }
-    for (const output of requestedOutputs) {
-      const itemId = toOutputItemId(output.filePrefix, output.index);
+    for (const output2 of requestedOutputs) {
+      const itemId = toOutputItemId(output2.filePrefix, output2.index);
       const itemStartedAtMs = Date.now();
       const itemTracking = {
         retries: 0,
@@ -5300,7 +5459,7 @@ async function runPipelineShell(input, options = {}) {
       };
       stages[5] = {
         ...stages[5],
-        detail: `Generating ${formatOutputItemLabel(output.contentType, output.index, output.outputCountForType)}.`,
+        detail: `Generating ${formatOutputItemLabel(output2.contentType, output2.index, output2.outputCountForType)}.`,
         items: (stages[5].items ?? []).map((item) => {
           if (item.id !== itemId) {
             return item;
@@ -5313,19 +5472,19 @@ async function runPipelineShell(input, options = {}) {
         })
       };
       options.onUpdate?.(cloneStages(stages));
-      const markdownPath = path9.join(generationDir, `${output.filePrefix}-${output.index}.md`);
+      const markdownPath = path9.join(generationDir, `${output2.filePrefix}-${output2.index}.md`);
       try {
         const content = await writeSingleShotContent({
-          idea: input.idea,
-          contentType: output.contentType,
-          style: input.config.settings.style,
-          intent: input.config.settings.intent,
-          outputIndex: output.index,
-          outputCountForType: output.outputCountForType,
+          idea: input2.idea,
+          contentType: output2.contentType,
+          style: input2.config.settings.style,
+          intent: input2.config.settings.intent,
+          outputIndex: output2.index,
+          outputCountForType: output2.outputCountForType,
           articleReferenceMarkdown: primaryMarkdownTemplate ?? void 0,
           contentPlan,
           plan,
-          settings: input.config.settings,
+          settings: input2.config.settings,
           openRouter,
           dryRun,
           role: "secondary",
@@ -5342,13 +5501,13 @@ async function runPipelineShell(input, options = {}) {
           }
         });
         if (!content) {
-          throw new Error(`Generated empty content for ${output.contentType} output ${output.index}.`);
+          throw new Error(`Generated empty content for ${output2.contentType} output ${output2.index}.`);
         }
         markdownPaths.push(markdownPath);
         await writeUtf8File(markdownPath, content);
         generatedOutputs.push({
           fileId: itemId,
-          contentType: output.contentType,
+          contentType: output2.contentType,
           markdownPath
         });
         const itemDurationMs = Date.now() - itemStartedAtMs;
@@ -5356,10 +5515,10 @@ async function runPipelineShell(input, options = {}) {
         const itemCostSource = chooseStageCostSource(itemTracking.costSources, knownItemCost.source);
         outputItemCalls.push({
           itemId,
-          contentType: output.contentType,
-          filePrefix: output.filePrefix,
-          index: output.index,
-          outputCountForType: output.outputCountForType,
+          contentType: output2.contentType,
+          filePrefix: output2.filePrefix,
+          index: output2.index,
+          outputCountForType: output2.outputCountForType,
           durationMs: itemDurationMs,
           retries: itemTracking.retries,
           costUsd: knownItemCost.usd,
@@ -5367,7 +5526,7 @@ async function runPipelineShell(input, options = {}) {
         });
         stages[5] = {
           ...stages[5],
-          detail: `Completed ${formatOutputItemLabel(output.contentType, output.index, output.outputCountForType)}.`,
+          detail: `Completed ${formatOutputItemLabel(output2.contentType, output2.index, output2.outputCountForType)}.`,
           items: (stages[5].items ?? []).map((item) => {
             if (item.id !== itemId) {
               return item;
@@ -5413,14 +5572,14 @@ async function runPipelineShell(input, options = {}) {
       stageAnalytics: snapshotStageAnalytics(stageTracking, "output")
     };
     options.onUpdate?.(cloneStages(stages));
-    const eligibleOutputsForLinks = generatedOutputs.filter((output) => output.contentType !== "x-post" && output.contentType !== "x-thread");
+    const eligibleOutputsForLinks = generatedOutputs.filter((output2) => output2.contentType !== "x-post" && output2.contentType !== "x-thread");
     stages[6] = {
       ...stages[6],
       status: "running",
       detail: "Selecting expressions and resolving source URLs.",
-      items: eligibleOutputsForLinks.map((output) => ({
-        id: output.fileId,
-        label: output.fileId,
+      items: eligibleOutputsForLinks.map((output2) => ({
+        id: output2.fileId,
+        label: output2.fileId,
         status: "pending",
         detail: "Waiting to start."
       }))
@@ -5430,15 +5589,15 @@ async function runPipelineShell(input, options = {}) {
     if (!shouldEnrichLinks) {
       const customLinkActions = pipelineCustomLinkRaws.length > 0 || pipelineUnlinks.length > 0;
       if (customLinkActions && eligibleOutputsForLinks.length > 0) {
-        for (const output of eligibleOutputsForLinks) {
-          const existingLinks = await readExistingLinks(resolveLinksPath(output.markdownPath));
+        for (const output2 of eligibleOutputsForLinks) {
+          const existingLinks = await readExistingLinks(resolveLinksPath(output2.markdownPath));
           const mergedCustomLinks = resolvePipelineCustomLinks(
             existingLinks?.customLinks ?? [],
             pipelineCustomLinkRaws,
             pipelineUnlinks
           );
           const generatedLinks = existingLinks?.links ?? [];
-          await writeLinksFile(output.markdownPath, {
+          await writeLinksFile(output2.markdownPath, {
             version: 2,
             customLinks: mergedCustomLinks,
             links: generatedLinks
@@ -5482,12 +5641,12 @@ async function runPipelineShell(input, options = {}) {
     } else if (linksResult) {
       const linksByFileId = new Map(linksResult.map((item) => [item.fileId, item.links]));
       const customLinksByFileId = new Map(linksResult.map((item) => [item.fileId, item.customLinks]));
-      const resumedLinks = eligibleOutputsForLinks.map((output) => ({
-        fileId: output.fileId,
-        contentType: output.contentType,
-        markdownPath: output.markdownPath,
-        links: linksByFileId.get(output.fileId) ?? [],
-        customLinks: customLinksByFileId.get(output.fileId) ?? []
+      const resumedLinks = eligibleOutputsForLinks.map((output2) => ({
+        fileId: output2.fileId,
+        contentType: output2.contentType,
+        markdownPath: output2.markdownPath,
+        links: linksByFileId.get(output2.fileId) ?? [],
+        customLinks: customLinksByFileId.get(output2.fileId) ?? []
       }));
       linksResult = resumedLinks;
       for (const item of resumedLinks) {
@@ -5515,13 +5674,13 @@ async function runPipelineShell(input, options = {}) {
       const itemTracking = /* @__PURE__ */ new Map();
       linksResult = await enrichLinks({
         markdownFiles: eligibleOutputsForLinks,
-        articleTitle: plan?.title ?? contentPlan.title ?? deriveTitleFromIdea2(input.idea),
+        articleTitle: plan?.title ?? contentPlan.title ?? deriveTitleFromIdea2(input2.idea),
         articleDescription: plan?.description ?? contentPlan.description,
         openRouter,
-        settings: input.config.settings,
+        settings: input2.config.settings,
         dryRun,
         customLinks: parsePipelineCustomLinks(pipelineCustomLinkRaws, pipelineUnlinks),
-        maxLinks: pipelineMaxLinks ?? resolveDefaultMaxLinks(input.config.settings.targetLength),
+        maxLinks: pipelineMaxLinks ?? resolveDefaultMaxLinks(input2.config.settings.targetLength),
         onInteraction(interaction) {
           onLlmInteraction(interaction);
         },
@@ -5628,23 +5787,23 @@ async function runPipelineShell(input, options = {}) {
     await writeJsonFile(analyticsPath, analytics);
     await writeJsonFile(interactionsPath, interactions);
     const metaJson = buildMetaJson({
-      idea: input.idea,
+      idea: input2.idea,
       generationDir,
       contentPlan,
       plan,
       renderedImages: imageArtifacts?.renderedImages ?? [],
       outputs: generatedOutputs,
       generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      style: input.config.settings.style,
-      intent: input.config.settings.intent,
-      targetLength: input.config.settings.targetLength ? resolveTargetLengthAlias(input.config.settings.targetLength) : null
+      style: input2.config.settings.style,
+      intent: input2.config.settings.intent,
+      targetLength: input2.config.settings.targetLength ? resolveTargetLengthAlias(input2.config.settings.targetLength) : null
     });
     const metaJsonPath = path9.join(generationDir, "meta.json");
     await writeJsonFile(metaJsonPath, metaJson);
     const primaryMarkdownPathForArtifact = markdownPaths[0] ?? primaryMarkdownPath;
     const artifact = {
-      title: plan?.title ?? contentPlan.title ?? deriveTitleFromIdea2(input.idea),
-      slug: plan?.slug ?? resolveGenerationSlug(input.idea, contentPlan?.title),
+      title: plan?.title ?? contentPlan.title ?? deriveTitleFromIdea2(input2.idea),
+      slug: plan?.slug ?? resolveGenerationSlug(input2.idea, contentPlan?.title),
       sectionCount: text?.sections.length ?? 0,
       imageCount: imageArtifacts?.renderedImages.length ?? 0,
       outputCount: markdownPaths.length,
@@ -6030,19 +6189,19 @@ function resolveGenerationSlug(idea, planTitle) {
   }
   return slugifyIdea(idea, 80);
 }
-function buildRunJobDefinition(input) {
+function buildRunJobDefinition(input2) {
   return {
-    idea: input.idea,
-    prompt: input.idea,
-    ...input.targetAudienceHint ? { targetAudience: input.targetAudienceHint } : {},
-    contentTargets: input.settings.contentTargets,
-    style: input.settings.style,
-    settings: input.settings,
-    sourceJob: input.sourceJob,
+    idea: input2.idea,
+    prompt: input2.idea,
+    ...input2.targetAudienceHint ? { targetAudience: input2.targetAudienceHint } : {},
+    contentTargets: input2.settings.contentTargets,
+    style: input2.settings.style,
+    settings: input2.settings,
+    sourceJob: input2.sourceJob,
     runMetadata: {
       generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      dryRun: input.dryRun,
-      runMode: input.runMode
+      dryRun: input2.dryRun,
+      runMode: input2.runMode
     }
   };
 }
@@ -6198,7 +6357,7 @@ async function runLinksCommand(options, dependencies = {}) {
   const openRouterApiKey = resolved.config.secrets.openRouterApiKey;
   if (!openRouterApiKey) {
     throw new ReportedError(
-      "Missing OpenRouter API key. Run `ideon settings` to configure credentials or set IDEON_OPENROUTER_API_KEY."
+      "Missing OpenRouter API key. Run `ideon settings` to configure credentials or set TELEPAT_OPENROUTER_KEY."
     );
   }
   const openRouter = new OpenRouterClient(openRouterApiKey);
@@ -6678,7 +6837,7 @@ async function listAllGenerations(markdownOutputDir) {
     try {
       const metadata = await extractArticleMetadata(filePath);
       const identity = deriveOutputIdentity(filePath, markdownOutputDir);
-      const output = {
+      const output2 = {
         id: `${identity.generationId}:${identity.contentType}:${identity.index}`,
         generationId: identity.generationId,
         sourcePath: filePath,
@@ -6691,38 +6850,38 @@ async function listAllGenerations(markdownOutputDir) {
         contentTypeLabel: toContentTypeLabel(identity.contentType),
         index: identity.index
       };
-      const outputKey = `${output.generationId}:${output.contentType}:${output.index}`;
+      const outputKey = `${output2.generationId}:${output2.contentType}:${output2.index}`;
       const existing = outputMap.get(outputKey);
-      if (!existing || output.mtime > existing.mtime) {
-        outputMap.set(outputKey, output);
+      if (!existing || output2.mtime > existing.mtime) {
+        outputMap.set(outputKey, output2);
       }
     } catch {
     }
   }
   const grouped = /* @__PURE__ */ new Map();
-  for (const output of outputMap.values()) {
-    const existing = grouped.get(output.generationId);
+  for (const output2 of outputMap.values()) {
+    const existing = grouped.get(output2.generationId);
     if (existing) {
-      existing.push(output);
+      existing.push(output2);
     } else {
-      grouped.set(output.generationId, [output]);
+      grouped.set(output2.generationId, [output2]);
     }
   }
   const generations = [];
   for (const [id, outputs] of grouped.entries()) {
     outputs.sort((a, b) => compareContentTypes(a.contentType, b.contentType) || a.index - b.index || b.mtime - a.mtime);
     const primaryContentType = await resolvePrimaryContentType(outputs);
-    const primary = outputs.find((output) => output.contentType === primaryContentType) ?? outputs[0];
+    const primary = outputs.find((output2) => output2.contentType === primaryContentType) ?? outputs[0];
     if (!primary) {
       continue;
     }
-    const newestMtime = outputs.reduce((latest, output) => Math.max(latest, output.mtime), 0);
+    const newestMtime = outputs.reduce((latest, output2) => Math.max(latest, output2.mtime), 0);
     generations.push({
       id,
       title: primary.title,
       mtime: newestMtime,
       previewSnippet: primary.previewSnippet,
-      coverImageUrl: primary.coverImageUrl ?? outputs.find((output) => Boolean(output.coverImageUrl))?.coverImageUrl ?? null,
+      coverImageUrl: primary.coverImageUrl ?? outputs.find((output2) => Boolean(output2.coverImageUrl))?.coverImageUrl ?? null,
       primaryContentType,
       outputs
     });
@@ -6806,7 +6965,7 @@ function toContentTypeLabel(contentType) {
   return contentType.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
 }
 async function resolvePrimaryContentType(outputs) {
-  const fallback = outputs.find((output) => output.contentType === "article")?.contentType ?? outputs[0]?.contentType ?? "article";
+  const fallback = outputs.find((output2) => output2.contentType === "article")?.contentType ?? outputs[0]?.contentType ?? "article";
   const generationDir = path11.dirname(outputs[0]?.sourcePath ?? "");
   if (!generationDir) {
     return fallback;
@@ -6840,15 +6999,15 @@ async function runOutputCommand(options, dependencies = {}) {
   const outputPaths = resolveOutputPaths();
   const generations = await listAllGenerations(outputPaths.markdownOutputDir);
   const generation = resolveGeneration(generations, options.generationId);
-  const articleOutputs = generation.outputs.filter((output) => output.contentType === generation.primaryContentType);
+  const articleOutputs = generation.outputs.filter((output2) => output2.contentType === generation.primaryContentType);
   if (articleOutputs.length === 0) {
     throw new ReportedError(
       `Generation "${generation.id}" has no primary content outputs (type: ${generation.primaryContentType}).`
     );
   }
-  const articleOutput = articleOutputs.find((output) => output.index === targetIndex);
+  const articleOutput = articleOutputs.find((output2) => output2.index === targetIndex);
   if (!articleOutput) {
-    const available = articleOutputs.map((output) => output.index).join(", ");
+    const available = articleOutputs.map((output2) => output2.index).join(", ");
     throw new ReportedError(
       `Generation "${generation.id}" has no primary output at index ${targetIndex}. Available: ${available}.`
     );
@@ -6896,7 +7055,7 @@ function resolveGeneration(generations, generationId) {
     return exact;
   }
   const bySlug = generations.find(
-    (g) => g.outputs.some((output) => output.slug === generationId)
+    (g) => g.outputs.some((output2) => output2.slug === generationId)
   );
   if (bySlug) {
     return bySlug;
@@ -6996,7 +7155,688 @@ function parsePrimaryAndSecondarySpecs(options) {
   ];
 }
 
+// src/integrations/keywordplanner/models.ts
+var countryCodeToGeoTargetId = {
+  AD: 2020,
+  AE: 2784,
+  AF: 2004,
+  AG: 2028,
+  AI: 2660,
+  AL: 2008,
+  AM: 2051,
+  AO: 2024,
+  AQ: 2010,
+  AR: 2032,
+  AS: 2016,
+  AT: 2040,
+  AU: 2036,
+  AW: 2533,
+  AX: 2248,
+  AZ: 2031,
+  BA: 2070,
+  BB: 2052,
+  BD: 2050,
+  BE: 2056,
+  BF: 2854,
+  BG: 2100,
+  BH: 2048,
+  BI: 2108,
+  BJ: 2204,
+  BL: 2652,
+  BM: 2060,
+  BN: 2096,
+  BO: 2068,
+  BQ: 2535,
+  BR: 2076,
+  BS: 2044,
+  BT: 2064,
+  BV: 2074,
+  BW: 2072,
+  BY: 2112,
+  BZ: 2084,
+  CA: 2124,
+  CC: 2166,
+  CD: 2180,
+  CF: 2140,
+  CG: 2178,
+  CH: 2756,
+  CI: 2384,
+  CK: 2184,
+  CL: 2152,
+  CM: 2120,
+  CN: 2156,
+  CO: 2170,
+  CR: 2188,
+  CU: 2192,
+  CV: 2132,
+  CW: 2531,
+  CX: 2162,
+  CY: 2196,
+  CZ: 2203,
+  DE: 2276,
+  DJ: 2262,
+  DK: 2208,
+  DM: 2212,
+  DO: 2214,
+  DZ: 2012,
+  EC: 2218,
+  EE: 2233,
+  EG: 2818,
+  EH: 2732,
+  ER: 2232,
+  ES: 2724,
+  ET: 2231,
+  FI: 2246,
+  FJ: 2242,
+  FK: 2238,
+  FM: 2583,
+  FO: 2234,
+  FR: 2250,
+  GA: 2266,
+  GB: 2826,
+  GD: 2308,
+  GE: 2268,
+  GF: 2254,
+  GG: 2831,
+  GH: 2288,
+  GI: 2292,
+  GL: 2304,
+  GM: 2270,
+  GN: 2324,
+  GP: 2312,
+  GQ: 2226,
+  GR: 2300,
+  GS: 2239,
+  GT: 2320,
+  GU: 2316,
+  GW: 2624,
+  GY: 2328,
+  HK: 2344,
+  HM: 2334,
+  HN: 2340,
+  HR: 2191,
+  HT: 2332,
+  HU: 2348,
+  ID: 2360,
+  IE: 2372,
+  IL: 2376,
+  IM: 2833,
+  IN: 2356,
+  IO: 2086,
+  IQ: 2368,
+  IR: 2364,
+  IS: 2352,
+  IT: 2380,
+  JE: 2832,
+  JM: 2388,
+  JO: 2400,
+  JP: 2392,
+  KE: 2404,
+  KG: 2417,
+  KH: 2116,
+  KI: 2296,
+  KM: 2174,
+  KN: 2659,
+  KP: 2408,
+  KR: 2410,
+  KW: 2414,
+  KY: 2136,
+  KZ: 2398,
+  LA: 2418,
+  LB: 2422,
+  LC: 2662,
+  LI: 2438,
+  LK: 2144,
+  LR: 2430,
+  LS: 2426,
+  LT: 2440,
+  LU: 2442,
+  LV: 2428,
+  LY: 2434,
+  MA: 2504,
+  MC: 2492,
+  MD: 2498,
+  ME: 2499,
+  MF: 2663,
+  MG: 2450,
+  MH: 2584,
+  MK: 2807,
+  ML: 2466,
+  MM: 2104,
+  MN: 2496,
+  MO: 2446,
+  MP: 2580,
+  MQ: 2474,
+  MR: 2478,
+  MS: 2500,
+  MT: 2470,
+  MU: 2480,
+  MV: 2462,
+  MW: 2454,
+  MX: 2484,
+  MY: 2458,
+  MZ: 2508,
+  NA: 2516,
+  NC: 2540,
+  NE: 2562,
+  NF: 2574,
+  NG: 2566,
+  NI: 2558,
+  NL: 2528,
+  NO: 2578,
+  NP: 2524,
+  NR: 2520,
+  NU: 2570,
+  NZ: 2554,
+  OM: 2512,
+  PA: 2591,
+  PE: 2604,
+  PF: 2258,
+  PG: 2598,
+  PH: 2608,
+  PK: 2586,
+  PL: 2616,
+  PM: 2666,
+  PN: 2612,
+  PR: 2630,
+  PS: 2275,
+  PT: 2620,
+  PW: 2585,
+  PY: 2600,
+  QA: 2634,
+  RE: 2638,
+  RO: 2642,
+  RS: 2688,
+  RU: 2643,
+  RW: 2646,
+  SA: 2682,
+  SB: 2090,
+  SC: 2690,
+  SD: 2729,
+  SE: 2752,
+  SG: 2702,
+  SH: 2654,
+  SI: 2705,
+  SJ: 2744,
+  SK: 2703,
+  SL: 2694,
+  SM: 2674,
+  SN: 2686,
+  SO: 2706,
+  SR: 2740,
+  SS: 2728,
+  ST: 2678,
+  SV: 2222,
+  SX: 2534,
+  SY: 2760,
+  SZ: 2748,
+  TC: 2796,
+  TD: 2148,
+  TF: 2260,
+  TG: 2768,
+  TH: 2764,
+  TJ: 2762,
+  TK: 2772,
+  TL: 2626,
+  TM: 2795,
+  TN: 2788,
+  TO: 2776,
+  TR: 2792,
+  TT: 2780,
+  TV: 2798,
+  TW: 2158,
+  TZ: 2834,
+  UA: 2804,
+  UG: 2800,
+  UM: 2581,
+  US: 2840,
+  UY: 2858,
+  UZ: 2860,
+  VA: 2336,
+  VC: 2670,
+  VE: 2862,
+  VG: 2092,
+  VI: 2850,
+  VN: 2704,
+  VU: 2548,
+  WF: 2876,
+  WS: 2882,
+  YE: 2887,
+  YT: 2175,
+  ZA: 2710,
+  ZM: 2894,
+  ZW: 2716
+};
+var languageCodeToConstantId = {
+  af: 1064,
+  sq: 1066,
+  am: 1067,
+  ar: 1001,
+  hy: 1068,
+  az: 1069,
+  eu: 1070,
+  be: 1071,
+  bn: 1072,
+  bs: 1073,
+  bg: 1074,
+  my: 1075,
+  ca: 1076,
+  zh: 1020,
+  hr: 1077,
+  cs: 1078,
+  da: 1079,
+  nl: 1080,
+  en: 1e3,
+  et: 1081,
+  fi: 1082,
+  fr: 1002,
+  gl: 1083,
+  ka: 1084,
+  de: 1003,
+  el: 1008,
+  gu: 1085,
+  iw: 1009,
+  hi: 1086,
+  hu: 1087,
+  is: 1088,
+  id: 1089,
+  it: 1005,
+  ja: 1006,
+  kn: 1090,
+  kk: 1091,
+  km: 1092,
+  ko: 1007,
+  ky: 1093,
+  lo: 1094,
+  lv: 1095,
+  lt: 1096,
+  mk: 1097,
+  ms: 1098,
+  ml: 1099,
+  mr: 1100,
+  mn: 1101,
+  ne: 1102,
+  no: 1103,
+  fa: 1104,
+  pl: 1105,
+  pt: 1009,
+  pa: 1106,
+  ro: 1107,
+  ru: 1010,
+  sr: 1108,
+  si: 1109,
+  sk: 1110,
+  sl: 1111,
+  es: 1004,
+  sw: 1112,
+  sv: 1011,
+  tl: 1113,
+  ta: 1114,
+  te: 1115,
+  th: 1012,
+  tr: 1013,
+  uk: 1115,
+  ur: 1116,
+  uz: 1117,
+  vi: 1118,
+  zu: 1119
+};
+var DEFAULT_LANGUAGE = "en";
+var DEFAULT_FORECAST_COUNTRY = "US";
+var FORECAST_DEFAULT_DAYS = 30;
+var MONTH_MAP = {
+  JANUARY: 1,
+  FEBRUARY: 2,
+  MARCH: 3,
+  APRIL: 4,
+  MAY: 5,
+  JUNE: 6,
+  JULY: 7,
+  AUGUST: 8,
+  SEPTEMBER: 9,
+  OCTOBER: 10,
+  NOVEMBER: 11,
+  DECEMBER: 12
+};
+function parseStrInt(s) {
+  if (!s) return 0;
+  const n = Number.parseInt(s, 10);
+  return Number.isFinite(n) ? n : 0;
+}
+function normalizeCompetition(raw) {
+  if (!raw || raw === "COMPETITION_UNSPECIFIED") return "UNKNOWN";
+  return raw;
+}
+function resolveGeoTargetConstant(code) {
+  if (code.startsWith("geoTargetConstants/")) return code;
+  const id = countryCodeToGeoTargetId[code.toUpperCase()];
+  if (id === void 0) throw new Error(`Unsupported country code: ${code}`);
+  return `geoTargetConstants/${id}`;
+}
+function resolveLanguageConstant(code) {
+  if (code.startsWith("languageConstants/")) return code;
+  const id = languageCodeToConstantId[code.toLowerCase()];
+  if (id === void 0) throw new Error(`Unsupported language code: ${code}`);
+  return `languageConstants/${id}`;
+}
+function resolveGeoTargets(countryCodes, forForecast) {
+  if (!countryCodes || countryCodes.length === 0) {
+    if (forForecast) return [resolveGeoTargetConstant(DEFAULT_FORECAST_COUNTRY)];
+    return void 0;
+  }
+  return countryCodes.map(resolveGeoTargetConstant);
+}
+function resolveLanguage(lang) {
+  if (!lang) return resolveLanguageConstant(DEFAULT_LANGUAGE);
+  return resolveLanguageConstant(lang);
+}
+function buildGenerateIdeasBody(input2) {
+  const hasKeywords = input2.seedKeywords && input2.seedKeywords.length > 0;
+  const hasUrl = input2.url && input2.url.length > 0;
+  const hasSite = input2.site && input2.site.length > 0;
+  if (!hasKeywords && !hasUrl && !hasSite) {
+    throw new Error("At least one of seedKeywords, url, or site is required.");
+  }
+  if (hasSite && (hasKeywords || hasUrl)) {
+    throw new Error("site cannot be combined with seedKeywords or url.");
+  }
+  const body = {
+    language: resolveLanguage(input2.language)
+  };
+  const geoTargets = resolveGeoTargets(input2.countryCodes, false);
+  if (geoTargets) body.geoTargetConstants = geoTargets;
+  if (hasKeywords && hasUrl) {
+    body.keywordAndUrlSeed = { keywords: input2.seedKeywords, url: input2.url };
+  } else if (hasKeywords) {
+    body.keywordSeed = { keywords: input2.seedKeywords };
+  } else if (hasUrl) {
+    body.urlSeed = { url: input2.url };
+  } else if (hasSite) {
+    body.siteSeed = { site: input2.site };
+  }
+  if (input2.pageSize && input2.pageSize > 0) {
+    body.pageSize = input2.pageSize;
+  }
+  return body;
+}
+function buildGetHistoricalDataBody(input2) {
+  const body = {
+    keywords: input2.keywords
+  };
+  body.language = resolveLanguage(input2.language);
+  const geoTargets = resolveGeoTargets(input2.countryCodes, false);
+  if (geoTargets) body.geoTargetConstants = geoTargets;
+  body.historicalMetricsOptions = {
+    includeAverageCpc: input2.includeAverageCpc !== false,
+    monthlySearchVolume: true
+  };
+  return body;
+}
+function buildForecastBody(input2) {
+  const now = /* @__PURE__ */ new Date();
+  const startDate = input2.startDate || now.toISOString().split("T")[0];
+  const endDate = input2.endDate || new Date(now.getTime() + FORECAST_DEFAULT_DAYS * 864e5).toISOString().split("T")[0];
+  const geoTargets = resolveGeoTargets(input2.countryCodes, true);
+  const language = resolveLanguage(input2.language);
+  const biddableKeywords = input2.keywords.map((kw) => ({
+    keyword: {
+      text: kw,
+      matchType: input2.keywordMatchType || "BROAD"
+    }
+  }));
+  const campaign = {
+    languageConstants: [language],
+    geoTargetConstants: geoTargets,
+    forecastPeriod: { startDate, endDate },
+    adGroups: [{ biddableKeywords }]
+  };
+  if (input2.maxCpcBidMicros !== void 0) {
+    campaign.biddingStrategy = {
+      manualCpcBiddingStrategy: {
+        maxCpcBidMicros: String(input2.maxCpcBidMicros)
+      }
+    };
+  }
+  return { campaign };
+}
+function parseGenerateIdeasResponse(raw) {
+  const results = raw.results || [];
+  const ideas = results.map((r) => {
+    const metrics = r.keywordIdeaMetrics || {};
+    const closeVariantsRaw = r.closeVariants || [];
+    return {
+      text: r.text || "",
+      avgMonthlySearches: parseStrInt(metrics.avgMonthlySearches),
+      competition: normalizeCompetition(metrics.competition),
+      competitionIndex: parseStrInt(metrics.competitionIndex),
+      lowTopOfPageBidMicros: parseStrInt(metrics.lowTopOfPageBidMicros),
+      highTopOfPageBidMicros: parseStrInt(metrics.highTopOfPageBidMicros),
+      closeVariants: closeVariantsRaw.map((cv) => cv.text || "")
+    };
+  });
+  return { ideas, count: ideas.length };
+}
+function parseGetHistoricalDataResponse(raw) {
+  const metrics = raw.metrics || [];
+  const keywords = metrics.map((m) => {
+    const km = m.keywordMetrics || {};
+    const monthlyRaw = km.monthlySearchVolumes || [];
+    const monthlySearchVolumes = monthlyRaw.map((v) => ({
+      year: v.year || 0,
+      month: MONTH_MAP[v.month || ""] || 0,
+      monthlySearches: parseStrInt(v.monthlySearches)
+    }));
+    return {
+      text: m.text || "",
+      avgMonthlySearches: parseStrInt(km.avgMonthlySearches),
+      competition: normalizeCompetition(km.competition),
+      competitionIndex: parseStrInt(String(km.competitionIndex ?? "")),
+      lowTopOfPageBidMicros: parseStrInt(km.lowTopOfPageBidMicros),
+      highTopOfPageBidMicros: parseStrInt(km.highTopOfPageBidMicros),
+      monthlySearchVolumes
+    };
+  });
+  return { keywords, count: keywords.length };
+}
+function parseGetForecastDataResponse(raw) {
+  const adGroupMetrics = raw.adGroupForecastMetrics || [];
+  const keywords = [];
+  for (const ag of adGroupMetrics) {
+    const kfMetrics = ag.keywordForecastMetrics || [];
+    for (const kf of kfMetrics) {
+      const kw = kf.keyword || {};
+      const m = kf.metrics || {};
+      keywords.push({
+        text: kw.text || "",
+        matchType: kw.matchType || "BROAD",
+        impressions: m.impressions || 0,
+        clicks: m.clicks || 0,
+        costMicros: m.costMicros || 0,
+        ctr: m.ctr || 0
+      });
+    }
+  }
+  return { keywords, count: keywords.length };
+}
+
+// src/integrations/keywordplanner/client.ts
+var TOKEN_ENDPOINT = "https://oauth2.googleapis.com/token";
+var API_BASE = "https://googleads.googleapis.com/v24";
+var EXPIRY_BUFFER_MS = 6e4;
+var HTTP_TIMEOUT_MS = 3e4;
+var AUTH_ERROR_MESSAGES = {
+  DEVELOPER_TOKEN_INVALID: "Invalid developer token. Set it via: ideon config set googleAdsDeveloperToken <token>. Get one at https://ads.google.com/aw/apicenter.",
+  DEVELOPER_TOKEN_NOT_APPROVED: "Developer token is in test mode and cannot access real accounts. Apply for Basic access at https://ads.google.com/aw/apicenter and wait for Google approval (a few days).",
+  DEVELOPER_TOKEN_PROHIBITED: "Developer token is not associated with this Google Cloud project. Ensure the token and OAuth client belong to the same GCP project.",
+  OAUTH_TOKEN_INVALID: "OAuth access token is invalid. Re-configure your refresh token via: ideon config set googleAdsRefreshToken <token>.",
+  GOOGLE_ACCOUNT_COOKIE_INVALID: "Google account cookie is invalid. Re-configure your refresh token via: ideon config set googleAdsRefreshToken <token>.",
+  CLIENT_CUSTOMER_ID_INVALID: "Customer ID is invalid. Set it via: ideon config set googleAdsCustomerId <10-digit-id>. Use the account number from the top-right of the Google Ads UI.",
+  CLIENT_CUSTOMER_ID_IS_REQUIRED: "Customer ID is required. Set it via: ideon config set googleAdsCustomerId <10-digit-id>.",
+  CUSTOMER_NOT_FOUND: "Google Ads account not found. Verify googleAdsCustomerId is correct and the account is provisioned. Set via: ideon config set googleAdsCustomerId <id>.",
+  NOT_ADS_USER: "Google account is not associated with any Google Ads account. Sign in to ads.google.com and create or link an account first.",
+  USER_PERMISSION_DENIED: "Permission denied. If accessing through a manager account, set: ideon config set googleAdsLoginCustomerId <manager-account-id>.",
+  CUSTOMER_NOT_ENABLED: "Google Ads account is not enabled. Complete account setup at ads.google.com.",
+  ACCESS_TOKEN_SCOPE_INSUFFICIENT: 'OAuth token is missing required "adwords" scope. Re-authorize with scope https://www.googleapis.com/auth/adwords and set the new refresh token via: ideon config set googleAdsRefreshToken <token>.'
+};
+function stripDashes(customerId) {
+  return customerId.replace(/-/g, "");
+}
+function extractErrorMessage(statusCode, body) {
+  try {
+    const parsed = JSON.parse(body);
+    const errors = parsed.error;
+    if (errors && errors.length > 0) {
+      const firstError = errors[0];
+      const message = firstError.message;
+      const errorCode = firstError.errorCode;
+      if (errorCode) {
+        for (const [key, value2] of Object.entries(errorCode)) {
+          if (value2 === true && AUTH_ERROR_MESSAGES[key]) {
+            return AUTH_ERROR_MESSAGES[key];
+          }
+        }
+      }
+      if (message) return message;
+    }
+  } catch {
+  }
+  return `Google Ads API returned HTTP ${statusCode}: ${body}`;
+}
+var GkpClient = class {
+  developerToken;
+  clientId;
+  clientSecret;
+  refreshToken;
+  customerId;
+  loginCustomerId;
+  baseUrl;
+  accessToken = null;
+  tokenExpiresAt = 0;
+  constructor(options) {
+    this.developerToken = options.developerToken;
+    this.clientId = options.clientId;
+    this.clientSecret = options.clientSecret;
+    this.refreshToken = options.refreshToken;
+    this.customerId = stripDashes(options.customerId);
+    this.loginCustomerId = options.loginCustomerId ? stripDashes(options.loginCustomerId) : void 0;
+    this.baseUrl = `${API_BASE}/customers/${this.customerId}`;
+  }
+  async refreshAccessToken() {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), HTTP_TIMEOUT_MS);
+    try {
+      const body = new URLSearchParams({
+        client_id: this.clientId,
+        client_secret: this.clientSecret,
+        refresh_token: this.refreshToken,
+        grant_type: "refresh_token"
+      });
+      const response = await fetch(TOKEN_ENDPOINT, {
+        method: "POST",
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        body: body.toString(),
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        const errorBody = await response.text();
+        throw new Error(`OAuth2 token exchange failed (${response.status}): ${errorBody}`);
+      }
+      const data = await response.json();
+      if (!data.access_token) {
+        throw new Error("OAuth2 response did not include an access_token.");
+      }
+      this.accessToken = data.access_token;
+      this.tokenExpiresAt = Date.now() + data.expires_in * 1e3 - EXPIRY_BUFFER_MS;
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  async getAccessToken() {
+    if (this.accessToken && Date.now() < this.tokenExpiresAt) {
+      return this.accessToken;
+    }
+    await this.refreshAccessToken();
+    if (!this.accessToken) {
+      throw new Error("Failed to obtain access token.");
+    }
+    return this.accessToken;
+  }
+  buildHeaders() {
+    const headers = {
+      "developer-token": this.developerToken,
+      "Authorization": `Bearer ${this.accessToken}`,
+      "Content-Type": "application/json"
+    };
+    if (this.loginCustomerId) {
+      headers["login-customer-id"] = this.loginCustomerId;
+    }
+    return headers;
+  }
+  async request(method, path15, body) {
+    const token = await this.getAccessToken();
+    const headers = this.buildHeaders();
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), HTTP_TIMEOUT_MS);
+    try {
+      const response = await fetch(`${this.baseUrl}${path15}`, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      const responseText = await response.text();
+      if (!response.ok) {
+        throw new Error(extractErrorMessage(response.status, responseText));
+      }
+      return JSON.parse(responseText);
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  async generateKeywordIdeas(input2) {
+    const body = buildGenerateIdeasBody(input2);
+    const raw = await this.request("POST", ":generateKeywordIdeas", body);
+    return parseGenerateIdeasResponse(raw);
+  }
+  async getHistoricalMetrics(input2) {
+    const body = buildGetHistoricalDataBody(input2);
+    const raw = await this.request("POST", ":generateKeywordHistoricalMetrics", body);
+    return parseGetHistoricalDataResponse(raw);
+  }
+  async getForecastData(input2) {
+    const body = buildForecastBody(input2);
+    const raw = await this.request("POST", ":generateKeywordForecastMetrics", body);
+    return parseGetForecastDataResponse(raw);
+  }
+};
+
 // src/integrations/mcp/server.ts
+var gkpClient = null;
+async function getOrCreateGkpClient() {
+  if (gkpClient) return gkpClient;
+  const envSettings = readEnvSettings();
+  const secrets = await loadSecrets({ disableKeytar: envSettings.disableKeytar });
+  const devToken = envSettings.googleAdsDeveloperToken ?? secrets.googleAdsDeveloperToken;
+  const clientId = envSettings.googleAdsClientId ?? secrets.googleAdsClientId;
+  const clientSecret = envSettings.googleAdsClientSecret ?? secrets.googleAdsClientSecret;
+  const refreshToken = envSettings.googleAdsRefreshToken ?? secrets.googleAdsRefreshToken;
+  const customerId = envSettings.googleAdsCustomerId ?? secrets.googleAdsCustomerId;
+  const loginCustomerId = envSettings.googleAdsLoginCustomerId ?? secrets.googleAdsLoginCustomerId;
+  if (!devToken || !clientId || !clientSecret || !refreshToken || !customerId) {
+    throw new ReportedError(
+      "Google Ads credentials are not configured. Set googleAdsDeveloperToken, googleAdsClientId, googleAdsClientSecret, googleAdsRefreshToken, and googleAdsCustomerId via ideon_config_set or environment variables."
+    );
+  }
+  gkpClient = new GkpClient({
+    developerToken: devToken,
+    clientId,
+    clientSecret,
+    refreshToken,
+    customerId,
+    loginCustomerId: loginCustomerId || void 0
+  });
+  return gkpClient;
+}
 async function startIdeonMcpServer() {
   const server = new McpServer({
     name: "ideon",
@@ -7009,30 +7849,30 @@ async function startIdeonMcpServer() {
       description: "Generate content from an idea using the Ideon pipeline.",
       inputSchema: writeToolInputSchema
     },
-    async (input) => {
+    async (input2) => {
       try {
         const parsedTargets = parsePrimaryAndSecondarySpecs({
-          primarySpec: input.primary,
-          secondarySpecs: input.secondary
+          primarySpec: input2.primary,
+          secondarySpecs: input2.secondary
         });
         const resolved = await resolveRunInput({
-          idea: input.idea,
-          audience: input.audience,
-          jobPath: input.jobPath,
-          style: input.style,
-          intent: input.intent,
-          targetLength: input.length,
+          idea: input2.idea,
+          audience: input2.audience,
+          jobPath: input2.jobPath,
+          style: input2.style,
+          intent: input2.intent,
+          targetLength: input2.length,
           contentTargets: parsedTargets
         });
         const run = await runPipelineShell(resolved, {
           workingDir: cwd(),
           runMode: "fresh",
-          dryRun: input.dryRun ?? false,
-          enrichLinks: input.enrichLinks ?? false,
-          customLinks: input.link,
-          unlinks: input.unlink,
-          maxLinks: input.maxLinks,
-          maxImages: input.maxImages
+          dryRun: input2.dryRun ?? false,
+          enrichLinks: input2.enrichLinks ?? false,
+          customLinks: input2.link,
+          unlinks: input2.unlink,
+          maxLinks: input2.maxLinks,
+          maxImages: input2.maxImages
         });
         return {
           content: [
@@ -7063,7 +7903,7 @@ async function startIdeonMcpServer() {
       description: "Resume the last failed or interrupted Ideon write session.",
       inputSchema: writeResumeToolInputSchema
     },
-    async (input) => {
+    async (input2) => {
       try {
         const session = await loadWriteSession(cwd());
         if (!session) {
@@ -7087,12 +7927,12 @@ async function startIdeonMcpServer() {
         const run = await runPipelineShell(resumeInput, {
           workingDir: cwd(),
           runMode: "resume",
-          dryRun: input.dryRun ?? false,
-          enrichLinks: input.enrichLinks ?? false,
-          customLinks: input.link,
-          unlinks: input.unlink,
-          maxLinks: input.maxLinks,
-          maxImages: input.maxImages
+          dryRun: input2.dryRun ?? false,
+          enrichLinks: input2.enrichLinks ?? false,
+          customLinks: input2.link,
+          unlinks: input2.unlink,
+          maxLinks: input2.maxLinks,
+          maxImages: input2.maxImages
         });
         return {
           content: [
@@ -7122,11 +7962,11 @@ async function startIdeonMcpServer() {
       description: "Delete generated output and assets by slug.",
       inputSchema: deleteToolInputSchema
     },
-    async (input) => {
+    async (input2) => {
       try {
         const messages = [];
         await runDeleteCommand(
-          { slug: input.slug, force: true },
+          { slug: input2.slug, force: true },
           {
             cwd: cwd(),
             log: (message) => {
@@ -7138,11 +7978,11 @@ async function startIdeonMcpServer() {
           content: [
             {
               type: "text",
-              text: messages.length > 0 ? messages.join("\n") : `Deleted ${input.slug}.`
+              text: messages.length > 0 ? messages.join("\n") : `Deleted ${input2.slug}.`
             }
           ],
           structuredContent: {
-            slug: input.slug,
+            slug: input2.slug,
             deleted: true
           }
         };
@@ -7158,16 +7998,16 @@ async function startIdeonMcpServer() {
       description: "Run link enrichment for a previously generated article by slug.",
       inputSchema: linksToolInputSchema
     },
-    async (input) => {
+    async (input2) => {
       try {
         const messages = [];
         await runLinksCommand(
           {
-            slug: input.slug,
-            mode: input.mode ?? "fresh",
-            links: input.link,
-            unlinks: input.unlink,
-            maxLinks: input.maxLinks
+            slug: input2.slug,
+            mode: input2.mode ?? "fresh",
+            links: input2.link,
+            unlinks: input2.unlink,
+            maxLinks: input2.maxLinks
           },
           {
             cwd: cwd(),
@@ -7180,12 +8020,12 @@ async function startIdeonMcpServer() {
           content: [
             {
               type: "text",
-              text: messages.length > 0 ? messages.join("\n") : `Enriched links for ${input.slug}.`
+              text: messages.length > 0 ? messages.join("\n") : `Enriched links for ${input2.slug}.`
             }
           ],
           structuredContent: {
-            slug: input.slug,
-            mode: input.mode ?? "fresh"
+            slug: input2.slug,
+            mode: input2.mode ?? "fresh"
           }
         };
       } catch (error) {
@@ -7200,15 +8040,15 @@ async function startIdeonMcpServer() {
       description: "Export a generated article as a standalone markdown file with inline links and copied images.",
       inputSchema: exportToolInputZodSchema
     },
-    async (input) => {
+    async (input2) => {
       try {
         const messages = [];
         await runOutputCommand(
           {
-            generationId: input.generationId,
-            destinationPath: input.destinationPath,
-            index: input.index,
-            overwrite: input.overwrite
+            generationId: input2.generationId,
+            destinationPath: input2.destinationPath,
+            index: input2.index,
+            overwrite: input2.overwrite
           },
           {
             cwd: cwd(),
@@ -7221,14 +8061,14 @@ async function startIdeonMcpServer() {
           content: [
             {
               type: "text",
-              text: messages.length > 0 ? messages.join("\n") : `Exported ${input.generationId}.`
+              text: messages.length > 0 ? messages.join("\n") : `Exported ${input2.generationId}.`
             }
           ],
           structuredContent: {
-            generationId: input.generationId,
-            destinationPath: input.destinationPath,
-            index: input.index ?? 1,
-            overwrite: input.overwrite ?? false,
+            generationId: input2.generationId,
+            destinationPath: input2.destinationPath,
+            index: input2.index ?? 1,
+            overwrite: input2.overwrite ?? false,
             messages
           }
         };
@@ -7244,12 +8084,12 @@ async function startIdeonMcpServer() {
       description: "Read a configuration value or secret availability flag.",
       inputSchema: configGetToolInputSchema
     },
-    async (input) => {
+    async (input2) => {
       try {
-        if (!isConfigKey(input.key)) {
-          throw new ReportedError(`Unsupported config key: ${input.key}`);
+        if (!isConfigKey(input2.key)) {
+          throw new ReportedError(`Unsupported config key: ${input2.key}`);
         }
-        const result = await configGet(input.key);
+        const result = await configGet(input2.key);
         return {
           content: [
             {
@@ -7275,21 +8115,21 @@ async function startIdeonMcpServer() {
       description: "Set a configuration value or secret token.",
       inputSchema: configSetToolInputSchema
     },
-    async (input) => {
+    async (input2) => {
       try {
-        if (!isConfigKey(input.key)) {
-          throw new ReportedError(`Unsupported config key: ${input.key}`);
+        if (!isConfigKey(input2.key)) {
+          throw new ReportedError(`Unsupported config key: ${input2.key}`);
         }
-        await configSet(input.key, input.value);
+        await configSet(input2.key, input2.value);
         return {
           content: [
             {
               type: "text",
-              text: `Set ${input.key}.`
+              text: `Set ${input2.key}.`
             }
           ],
           structuredContent: {
-            key: input.key,
+            key: input2.key,
             updated: true
           }
         };
@@ -7329,21 +8169,21 @@ async function startIdeonMcpServer() {
       description: "Reset a setting to its default or delete a stored secret.",
       inputSchema: configUnsetToolInputSchema
     },
-    async (input) => {
+    async (input2) => {
       try {
-        if (!isConfigKey(input.key)) {
-          throw new ReportedError(`Unsupported config key: ${input.key}`);
+        if (!isConfigKey(input2.key)) {
+          throw new ReportedError(`Unsupported config key: ${input2.key}`);
         }
-        await configUnset(input.key);
+        await configUnset(input2.key);
         return {
           content: [
             {
               type: "text",
-              text: `Unset ${input.key}.`
+              text: `Unset ${input2.key}.`
             }
           ],
           structuredContent: {
-            key: input.key,
+            key: input2.key,
             updated: true
           }
         };
@@ -7352,6 +8192,86 @@ async function startIdeonMcpServer() {
       }
     }
   );
+  server.registerTool(
+    "gkp_generate_ideas",
+    {
+      title: "Google Keyword Planner - Generate Ideas",
+      description: "Generate keyword ideas from seed keywords, a URL, or a site using Google Ads Keyword Planner.",
+      inputSchema: gkpGenerateIdeasToolInputZodSchema
+    },
+    async (input2) => {
+      try {
+        const client = await getOrCreateGkpClient();
+        const result = await client.generateKeywordIdeas({
+          seedKeywords: input2.seedKeywords,
+          url: input2.url,
+          site: input2.site,
+          countryCodes: input2.countryCodes,
+          language: input2.language,
+          pageSize: input2.pageSize
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+          structuredContent: result
+        };
+      } catch (error) {
+        return formatToolError(error);
+      }
+    }
+  );
+  server.registerTool(
+    "gkp_get_historical_data",
+    {
+      title: "Google Keyword Planner - Historical Data",
+      description: "Get historical search volume and competition metrics for a list of keywords.",
+      inputSchema: gkpGetHistoricalDataToolInputZodSchema
+    },
+    async (input2) => {
+      try {
+        const client = await getOrCreateGkpClient();
+        const result = await client.getHistoricalMetrics({
+          keywords: input2.keywords,
+          countryCodes: input2.countryCodes,
+          language: input2.language,
+          includeAverageCpc: input2.includeAverageCpc
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+          structuredContent: result
+        };
+      } catch (error) {
+        return formatToolError(error);
+      }
+    }
+  );
+  server.registerTool(
+    "gkp_get_forecast_data",
+    {
+      title: "Google Keyword Planner - Forecast Data",
+      description: "Get projected impressions, clicks, and cost for a set of keywords.",
+      inputSchema: gkpGetForecastDataToolInputZodSchema
+    },
+    async (input2) => {
+      try {
+        const client = await getOrCreateGkpClient();
+        const result = await client.getForecastData({
+          keywords: input2.keywords,
+          keywordMatchType: input2.keywordMatchType,
+          maxCpcBidMicros: input2.maxCpcBidMicros,
+          countryCodes: input2.countryCodes,
+          language: input2.language,
+          startDate: input2.startDate,
+          endDate: input2.endDate
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+          structuredContent: result
+        };
+      } catch (error) {
+        return formatToolError(error);
+      }
+    }
+  );
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
@@ -7368,6 +8288,530 @@ async function runMcpServeCommand() {
   await startIdeonMcpServer();
 }
 
+// src/cli/commands/gads.ts
+import * as readline from "readline/promises";
+import { stdin as input, stdout as output } from "process";
+
+// src/integrations/keywordplanner/oauth.ts
+import { createServer } from "http";
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { URL as URL2 } from "url";
+var execFileAsync = promisify(execFile);
+var AUTH_ENDPOINT = "https://accounts.google.com/o/oauth2/v2/auth";
+var TOKEN_ENDPOINT2 = "https://oauth2.googleapis.com/token";
+var OAUTH_SCOPE = "https://www.googleapis.com/auth/adwords";
+var DEFAULT_REDIRECT_PORT = 9876;
+var MAX_PORT_ATTEMPTS = 4;
+var HTTP_TIMEOUT_MS2 = 12e4;
+var defaultDependencies2 = {
+  createHttpServer: createServer,
+  fetch: globalThis.fetch.bind(globalThis),
+  setTimeout: globalThis.setTimeout.bind(globalThis),
+  clearTimeout: globalThis.clearTimeout.bind(globalThis),
+  openBrowser: async (url) => {
+    if (process.platform === "darwin") {
+      await execFileAsync("open", [url]);
+    } else if (process.platform === "win32") {
+      await execFileAsync("cmd", ["/c", "start", "", url]);
+    } else {
+      await execFileAsync("xdg-open", [url]);
+    }
+  },
+  log: (message) => console.log(message)
+};
+function buildAuthUrl(clientId, redirectUri) {
+  const params = new URLSearchParams({
+    client_id: clientId,
+    redirect_uri: redirectUri,
+    response_type: "code",
+    scope: OAUTH_SCOPE,
+    access_type: "offline",
+    prompt: "consent"
+  });
+  return `${AUTH_ENDPOINT}?${params.toString()}`;
+}
+async function exchangeCode(code, clientId, clientSecret, redirectUri, deps) {
+  const body = new URLSearchParams({
+    code,
+    client_id: clientId,
+    client_secret: clientSecret,
+    redirect_uri: redirectUri,
+    grant_type: "authorization_code"
+  });
+  const response = await deps.fetch(TOKEN_ENDPOINT2, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: body.toString()
+  });
+  if (!response.ok) {
+    const errorBody = await response.text();
+    throw new Error(`OAuth2 token exchange failed (${response.status}): ${errorBody}`);
+  }
+  const data = await response.json();
+  if (!data.refresh_token) {
+    throw new Error("OAuth2 response did not include a refresh_token. Ensure prompt=consent was used.");
+  }
+  return data.refresh_token;
+}
+function waitForCode(server, redirectPath, redirectUri, deps) {
+  return new Promise((resolve, reject) => {
+    const timeout = deps.setTimeout(() => {
+      server.close();
+      reject(new Error("OAuth flow timed out after 120 seconds."));
+    }, HTTP_TIMEOUT_MS2);
+    function onRequest(req, res) {
+      const url = new URL2(req.url ?? "/", `http://localhost`);
+      if (url.pathname !== redirectPath) {
+        res.writeHead(404);
+        res.end("Not found.");
+        return;
+      }
+      const code = url.searchParams.get("code");
+      const error = url.searchParams.get("error");
+      if (error) {
+        deps.clearTimeout(timeout);
+        server.close();
+        res.writeHead(400, { "Content-Type": "text/html" });
+        res.end(`<h1>Authorization failed</h1><p>${error}</p><p>Close this window and try again.</p>`);
+        reject(new Error(`OAuth authorization error: ${error}`));
+        return;
+      }
+      if (!code) {
+        res.writeHead(400, { "Content-Type": "text/html" });
+        res.end("<h1>Missing authorization code</h1><p>Close this window and try again.</p>");
+        return;
+      }
+      deps.clearTimeout(timeout);
+      server.close();
+      res.writeHead(200, { "Content-Type": "text/html" });
+      res.end("<h1>Authorization successful</h1><p>You can close this window and return to the terminal.</p>");
+      resolve(code);
+    }
+    server.on("request", onRequest);
+    server.on("error", (err) => {
+      deps.clearTimeout(timeout);
+      reject(err);
+    });
+  });
+}
+async function startServerOnPort(port, deps) {
+  const redirectPath = "/callback";
+  const redirectUri = `http://localhost:${port}${redirectPath}`;
+  const server = deps.createHttpServer();
+  return new Promise((resolve, reject) => {
+    server.listen(port, () => {
+      resolve({ server, redirectPath, redirectUri });
+    });
+    server.on("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        reject(new Error(`Port ${port} is in use.`));
+      } else {
+        reject(err);
+      }
+    });
+  });
+}
+async function startOAuthFlow(options, dependencies = {}) {
+  const deps = { ...defaultDependencies2, ...dependencies };
+  let server = null;
+  let port = DEFAULT_REDIRECT_PORT;
+  let redirectPath = "/callback";
+  let redirectUri = "";
+  for (let attempt = 0; attempt < MAX_PORT_ATTEMPTS; attempt++) {
+    try {
+      const result = await startServerOnPort(port, deps);
+      server = result.server;
+      redirectPath = result.redirectPath;
+      redirectUri = result.redirectUri;
+      break;
+    } catch (err) {
+      if (err instanceof Error && err.message.startsWith("Port") && err.message.endsWith("is in use.")) {
+        port++;
+        continue;
+      }
+      throw err;
+    }
+  }
+  if (!server) {
+    throw new Error(`All ports ${DEFAULT_REDIRECT_PORT}\u2013${DEFAULT_REDIRECT_PORT + MAX_PORT_ATTEMPTS - 1} are in use. Close another process and try again.`);
+  }
+  const authUrl = buildAuthUrl(options.clientId, redirectUri);
+  deps.log("Opening browser for Google Ads authorization...");
+  deps.log(`If the browser does not open, visit:
+${authUrl}
+`);
+  try {
+    await deps.openBrowser(authUrl);
+  } catch {
+    deps.log("Could not open browser automatically. Please open the URL above manually.");
+  }
+  try {
+    const code = await waitForCode(server, redirectPath, redirectUri, deps);
+    const refreshToken = await exchangeCode(code, options.clientId, options.clientSecret, redirectUri, deps);
+    return { refreshToken };
+  } catch (err) {
+    if (server && server.listening) {
+      server.close();
+    }
+    throw err;
+  }
+}
+
+// src/cli/commands/gads.ts
+var GOOGLE_ADS_SECRET_KEYS = [
+  "googleAdsDeveloperToken",
+  "googleAdsClientId",
+  "googleAdsClientSecret",
+  "googleAdsRefreshToken",
+  "googleAdsCustomerId",
+  "googleAdsLoginCustomerId"
+];
+function createDefaultDependencies() {
+  const rl = readline.createInterface({ input, output });
+  return {
+    log: (message) => console.log(message),
+    prompt: async (question) => rl.question(question),
+    configSet,
+    configGet,
+    configUnset,
+    startOAuthFlow,
+    readEnvSettings,
+    loadSecrets,
+    isTTY: Boolean(input?.isTTY)
+  };
+}
+async function runGadsLoginCommand(options, dependencies = {}) {
+  const deps = { ...createDefaultDependencies(), ...dependencies };
+  if (!deps.isTTY) {
+    throw new ReportedError(
+      "OAuth login requires an interactive terminal with browser access.\n\nFor CI/CD or headless environments, set credentials via environment variables:\n  TELEPAT_GOOGLE_ADS_DEVELOPER_TOKEN\n  TELEPAT_GOOGLE_ADS_CLIENT_ID\n  TELEPAT_GOOGLE_ADS_CLIENT_SECRET\n  TELEPAT_GOOGLE_ADS_REFRESH_TOKEN\n  TELEPAT_GOOGLE_ADS_CUSTOMER_ID\n  TELEPAT_GOOGLE_ADS_LOGIN_CUSTOMER_ID (optional)\n\nEnvironment variables bypass keychain storage entirely."
+    );
+  }
+  const envSettings = deps.readEnvSettings();
+  const secrets = await deps.loadSecrets({ disableKeytar: envSettings.disableKeytar });
+  const hasRefreshToken = Boolean(envSettings.googleAdsRefreshToken ?? secrets.googleAdsRefreshToken);
+  if (hasRefreshToken && !options.force) {
+    deps.log("Already authenticated with Google Ads. Use --force to re-authorize.");
+    return;
+  }
+  const developerToken = options.developerToken ?? await deps.prompt("Google Ads developer token: ");
+  if (!developerToken.trim()) {
+    throw new ReportedError("Developer token cannot be empty.");
+  }
+  const clientId = options.clientId ?? await deps.prompt("OAuth2 client ID: ");
+  if (!clientId.trim()) {
+    throw new ReportedError("Client ID cannot be empty.");
+  }
+  const clientSecret = options.clientSecret ?? await deps.prompt("OAuth2 client secret: ");
+  if (!clientSecret.trim()) {
+    throw new ReportedError("Client secret cannot be empty.");
+  }
+  const customerId = options.customerId ?? await deps.prompt("Google Ads customer ID (10 digits, dashes optional): ");
+  if (!customerId.trim()) {
+    throw new ReportedError("Customer ID cannot be empty.");
+  }
+  if (options.loginCustomerId) {
+    await deps.configSet("googleAdsLoginCustomerId", options.loginCustomerId);
+  }
+  await deps.configSet("googleAdsDeveloperToken", developerToken);
+  await deps.configSet("googleAdsClientId", clientId);
+  await deps.configSet("googleAdsClientSecret", clientSecret);
+  await deps.configSet("googleAdsCustomerId", customerId);
+  deps.log("Starting OAuth2 authorization flow...");
+  deps.log("A browser window will open for Google Ads authorization.");
+  const result = await deps.startOAuthFlow({ clientId, clientSecret });
+  await deps.configSet("googleAdsRefreshToken", result.refreshToken);
+  deps.log("Google Ads credentials saved successfully.");
+  deps.log("Run `ideon gads test` to verify your credentials work.");
+}
+async function runGadsLogoutCommand(options, dependencies = {}) {
+  const deps = { ...createDefaultDependencies(), ...dependencies };
+  const keysToClear = options.all ? [...GOOGLE_ADS_SECRET_KEYS] : ["googleAdsRefreshToken"];
+  for (const key of keysToClear) {
+    await deps.configUnset(key);
+  }
+  const label2 = options.all ? "All Google Ads credentials" : "Google Ads refresh token";
+  deps.log(`${label2} cleared.`);
+}
+function detectCredentialSource(envValue, keyValue) {
+  if (envValue) return { set: true, source: "env" };
+  if (keyValue) return { set: true, source: "keychain" };
+  return { set: false, source: null };
+}
+function buildStatusResult(envSettings, secrets) {
+  return {
+    googleAdsDeveloperToken: detectCredentialSource(envSettings.googleAdsDeveloperToken, secrets.googleAdsDeveloperToken),
+    googleAdsClientId: detectCredentialSource(envSettings.googleAdsClientId, secrets.googleAdsClientId),
+    googleAdsClientSecret: detectCredentialSource(envSettings.googleAdsClientSecret, secrets.googleAdsClientSecret),
+    googleAdsRefreshToken: detectCredentialSource(envSettings.googleAdsRefreshToken, secrets.googleAdsRefreshToken),
+    googleAdsCustomerId: detectCredentialSource(envSettings.googleAdsCustomerId, secrets.googleAdsCustomerId),
+    googleAdsLoginCustomerId: detectCredentialSource(envSettings.googleAdsLoginCustomerId, secrets.googleAdsLoginCustomerId)
+  };
+}
+function formatStatusTTY(result) {
+  const lines = ["", "Google Ads Credential Status", "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"];
+  for (const [key, status] of Object.entries(result)) {
+    const label2 = key.replace("googleAds", "").replace(/([A-Z])/g, " $1").trim();
+    const displayLabel = label2.charAt(0).toLowerCase() + label2.slice(1);
+    if (status.set) {
+      lines.push(`  ${displayLabel.padEnd(20)} \u2713 ${status.source}`);
+    } else {
+      const suffix = key === "googleAdsLoginCustomerId" ? " (optional)" : "";
+      lines.push(`  ${displayLabel.padEnd(20)} \u2014 not set${suffix}`);
+    }
+  }
+  lines.push("");
+  lines.push("Run `ideon gads test` to verify credentials work.");
+  const allSet = Object.entries(result).filter(([k]) => k !== "googleAdsLoginCustomerId").every(([, s]) => s.set);
+  if (!allSet) {
+    lines.push("Run `ideon gads login` to set up missing credentials.");
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+async function runGadsStatusCommand(options, dependencies = {}) {
+  const deps = { ...createDefaultDependencies(), ...dependencies };
+  const envSettings = deps.readEnvSettings();
+  const secrets = await deps.loadSecrets({ disableKeytar: envSettings.disableKeytar });
+  const result = buildStatusResult(envSettings, secrets);
+  if (options.json) {
+    deps.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  deps.log(formatStatusTTY(result));
+}
+async function runGadsTestCommand(_options, dependencies = {}) {
+  const deps = { ...createDefaultDependencies(), ...dependencies };
+  const envSettings = deps.readEnvSettings();
+  const secrets = await deps.loadSecrets({ disableKeytar: envSettings.disableKeytar });
+  const devToken = envSettings.googleAdsDeveloperToken ?? secrets.googleAdsDeveloperToken;
+  const clientId = envSettings.googleAdsClientId ?? secrets.googleAdsClientId;
+  const clientSecret = envSettings.googleAdsClientSecret ?? secrets.googleAdsClientSecret;
+  const refreshToken = envSettings.googleAdsRefreshToken ?? secrets.googleAdsRefreshToken;
+  const customerId = envSettings.googleAdsCustomerId ?? secrets.googleAdsCustomerId;
+  const loginCustomerId = envSettings.googleAdsLoginCustomerId ?? secrets.googleAdsLoginCustomerId;
+  const missing = [];
+  if (!devToken) missing.push("googleAdsDeveloperToken");
+  if (!clientId) missing.push("googleAdsClientId");
+  if (!clientSecret) missing.push("googleAdsClientSecret");
+  if (!refreshToken) missing.push("googleAdsRefreshToken");
+  if (!customerId) missing.push("googleAdsCustomerId");
+  if (missing.length > 0) {
+    const setCommands = missing.map((k) => `ideon config set ${k} <value>`).join("\n  ");
+    throw new ReportedError(
+      `Missing required Google Ads credentials:
+  ${missing.join(", ")}
+
+Set them via:
+  ${setCommands}
+
+Or run \`ideon gads login\` for guided setup.`
+    );
+  }
+  const client = new GkpClient({
+    developerToken: devToken,
+    clientId,
+    clientSecret,
+    refreshToken,
+    customerId,
+    loginCustomerId: loginCustomerId || void 0
+  });
+  try {
+    const result = await client.generateKeywordIdeas({
+      seedKeywords: ["test"],
+      pageSize: 1
+    });
+    deps.log(`\u2713 Google Ads credentials verified.`);
+    deps.log(`  Customer ID: ${customerId}`);
+    deps.log(`  API response received successfully (${result.count} keyword${result.count === 1 ? "" : "s"} returned).`);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    throw new ReportedError(
+      `Google Ads credentials test failed:
+${message}
+
+Run \`ideon gads status\` to check configuration, or \`ideon gads login\` to re-authorize.`
+    );
+  }
+}
+
+// src/cli/commands/gkp.ts
+function createDefaultDependencies2() {
+  return {
+    log: (message) => console.log(message),
+    readEnvSettings,
+    loadSecrets,
+    GkpClientFactory: (options) => new GkpClient(options)
+  };
+}
+function parseCommaSeparated(value2) {
+  if (!value2) return void 0;
+  const items = value2.split(",").map((s) => s.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+async function createClient(deps) {
+  const envSettings = deps.readEnvSettings();
+  const secrets = await deps.loadSecrets({ disableKeytar: envSettings.disableKeytar });
+  const devToken = envSettings.googleAdsDeveloperToken ?? secrets.googleAdsDeveloperToken;
+  const clientId = envSettings.googleAdsClientId ?? secrets.googleAdsClientId;
+  const clientSecret = envSettings.googleAdsClientSecret ?? secrets.googleAdsClientSecret;
+  const refreshToken = envSettings.googleAdsRefreshToken ?? secrets.googleAdsRefreshToken;
+  const customerId = envSettings.googleAdsCustomerId ?? secrets.googleAdsCustomerId;
+  const loginCustomerId = envSettings.googleAdsLoginCustomerId ?? secrets.googleAdsLoginCustomerId;
+  const missing = [];
+  if (!devToken) missing.push("googleAdsDeveloperToken");
+  if (!clientId) missing.push("googleAdsClientId");
+  if (!clientSecret) missing.push("googleAdsClientSecret");
+  if (!refreshToken) missing.push("googleAdsRefreshToken");
+  if (!customerId) missing.push("googleAdsCustomerId");
+  if (missing.length > 0) {
+    const setCommands = missing.map((k) => `ideon config set ${k} <value>`).join("\n  ");
+    throw new ReportedError(
+      `Missing required Google Ads credentials:
+  ${missing.join(", ")}
+
+Set them via:
+  ${setCommands}
+
+Or run \`ideon gads login\` for guided setup.`
+    );
+  }
+  return deps.GkpClientFactory({
+    developerToken: devToken,
+    clientId,
+    clientSecret,
+    refreshToken,
+    customerId,
+    loginCustomerId: loginCustomerId || void 0
+  });
+}
+function microsToDollars(micros) {
+  const dollars = micros / 1e6;
+  return `$${dollars.toFixed(2)}`;
+}
+function formatIdeasTTY(result) {
+  if (result.ideas.length === 0) {
+    return "No keyword ideas found.";
+  }
+  const header = "Keyword".padEnd(40) + "Searches".padStart(14) + "Competition".padStart(14) + "Low Bid".padStart(12) + "High Bid".padStart(12);
+  const divider = "\u2500".repeat(header.length);
+  const rows = result.ideas.map((idea) => {
+    const text = idea.text.length > 38 ? idea.text.slice(0, 35) + "..." : idea.text;
+    return text.padEnd(40) + idea.avgMonthlySearches.toLocaleString().padStart(14) + idea.competition.padStart(14) + microsToDollars(idea.lowTopOfPageBidMicros).padStart(12) + microsToDollars(idea.highTopOfPageBidMicros).padStart(12);
+  });
+  return ["", "Keyword Ideas", divider, header, divider, ...rows, divider, `Total: ${result.count} keyword${result.count === 1 ? "" : "s"}`, ""].join("\n");
+}
+function formatHistoricalTTY(result) {
+  if (result.keywords.length === 0) {
+    return "No historical data found.";
+  }
+  const header = "Keyword".padEnd(40) + "Avg Monthly".padStart(14) + "Competition".padStart(14) + "Low Bid".padStart(12) + "High Bid".padStart(12);
+  const divider = "\u2500".repeat(header.length);
+  const rows = result.keywords.map((kw) => {
+    const text = kw.text.length > 38 ? kw.text.slice(0, 35) + "..." : kw.text;
+    return text.padEnd(40) + kw.avgMonthlySearches.toLocaleString().padStart(14) + kw.competition.padStart(14) + microsToDollars(kw.lowTopOfPageBidMicros).padStart(12) + microsToDollars(kw.highTopOfPageBidMicros).padStart(12);
+  });
+  return ["", "Historical Metrics", divider, header, divider, ...rows, divider, `Total: ${result.count} keyword${result.count === 1 ? "" : "s"}`, ""].join("\n");
+}
+function formatForecastTTY(result) {
+  if (result.keywords.length === 0) {
+    return "No forecast data found.";
+  }
+  const header = "Keyword".padEnd(32) + "Match".padStart(8) + "Impr.".padStart(10) + "Clicks".padStart(10) + "Cost".padStart(12) + "CTR".padStart(8);
+  const divider = "\u2500".repeat(header.length);
+  const rows = result.keywords.map((kw) => {
+    const text = kw.text.length > 30 ? kw.text.slice(0, 27) + "..." : kw.text;
+    return text.padEnd(32) + kw.matchType.padStart(8) + kw.impressions.toLocaleString().padStart(10) + kw.clicks.toLocaleString().padStart(10) + microsToDollars(kw.costMicros).padStart(12) + `${(kw.ctr * 100).toFixed(1)}%`.padStart(8);
+  });
+  return ["", "Forecast", divider, header, divider, ...rows, divider, `Total: ${result.count} keyword${result.count === 1 ? "" : "s"}`, ""].join("\n");
+}
+async function runGkpIdeasCommand(options, dependencies = {}) {
+  const deps = { ...createDefaultDependencies2(), ...dependencies };
+  const seedKeywords = parseCommaSeparated(options.keywords);
+  const url = options.url || void 0;
+  const site = options.site || void 0;
+  const countryCodes = parseCommaSeparated(options.country);
+  if (!seedKeywords && !url) {
+    throw new ReportedError("At least one of --keywords or --url is required.");
+  }
+  const client = await createClient(deps);
+  try {
+    const result = await client.generateKeywordIdeas({
+      seedKeywords: seedKeywords || void 0,
+      url,
+      site,
+      countryCodes,
+      language: options.language,
+      pageSize: options.pageSize
+    });
+    if (options.json) {
+      deps.log(JSON.stringify(result, null, 2));
+    } else {
+      deps.log(formatIdeasTTY(result));
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    throw new ReportedError(`Failed to generate keyword ideas:
+${message}`);
+  }
+}
+async function runGkpHistoricalCommand(options, dependencies = {}) {
+  const deps = { ...createDefaultDependencies2(), ...dependencies };
+  const keywords = parseCommaSeparated(options.keywords);
+  if (!keywords || keywords.length === 0) {
+    throw new ReportedError("--keywords is required.");
+  }
+  const countryCodes = parseCommaSeparated(options.country);
+  const client = await createClient(deps);
+  try {
+    const result = await client.getHistoricalMetrics({
+      keywords,
+      countryCodes,
+      language: options.language,
+      includeAverageCpc: options.includeCpc
+    });
+    if (options.json) {
+      deps.log(JSON.stringify(result, null, 2));
+    } else {
+      deps.log(formatHistoricalTTY(result));
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    throw new ReportedError(`Failed to get historical data:
+${message}`);
+  }
+}
+async function runGkpForecastCommand(options, dependencies = {}) {
+  const deps = { ...createDefaultDependencies2(), ...dependencies };
+  const keywords = parseCommaSeparated(options.keywords);
+  if (!keywords || keywords.length === 0) {
+    throw new ReportedError("--keywords is required.");
+  }
+  const countryCodes = parseCommaSeparated(options.country);
+  const client = await createClient(deps);
+  try {
+    const result = await client.getForecastData({
+      keywords,
+      keywordMatchType: options.matchType,
+      maxCpcBidMicros: options.maxCpcBid,
+      countryCodes,
+      language: options.language,
+      startDate: options.startDate,
+      endDate: options.endDate
+    });
+    if (options.json) {
+      deps.log(JSON.stringify(result, null, 2));
+    } else {
+      deps.log(formatForecastTTY(result));
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    throw new ReportedError(`Failed to get forecast data:
+${message}`);
+  }
+}
+
 // src/cli/commands/settings.tsx
 import { render } from "ink";
 
@@ -7561,7 +9005,7 @@ function SettingsFlow({ initialSettings, initialSecrets, onDone }) {
   const [showModelSelect, setShowModelSelect] = useState(false);
   const [menuMode, setMenuMode] = useState("main");
   const currentModelEntry = getLimnGenerationModels().find((m) => m.family === settings.t2i.modelId) ?? getLimnGenerationModels()[0];
-  useInput((input, key) => {
+  useInput((input2, key) => {
     if (key.escape) {
       if (editing) {
         setEditing(null);
@@ -7576,7 +9020,7 @@ function SettingsFlow({ initialSettings, initialSecrets, onDone }) {
         return;
       }
     }
-    if (key.ctrl && input === "c") {
+    if (key.ctrl && input2 === "c") {
       onDone(null);
       exit();
     }
@@ -7784,7 +9228,7 @@ async function openSettings() {
   } catch (error) {
     if (error instanceof KeytarUnavailableError) {
       console.log("Settings saved, but secrets were not stored in the system keychain.");
-      console.log("Use IDEON_OPENROUTER_API_KEY and IDEON_REPLICATE_API_TOKEN in this environment.");
+      console.log("Use TELEPAT_OPENROUTER_KEY and TELEPAT_REPLICATE_TOKEN in this environment.");
       return;
     }
     throw error;
@@ -7797,15 +9241,15 @@ import path14 from "path";
 import { spawn } from "child_process";
 
 // src/server/previewServer.ts
-import { execFile } from "child_process";
-import { promisify } from "util";
+import { execFile as execFile2 } from "child_process";
+import { promisify as promisify2 } from "util";
 import { readFile as readFile11, stat as stat6 } from "fs/promises";
 import { watch as fsWatch } from "fs";
 import path13 from "path";
 import { fileURLToPath } from "url";
 import express from "express";
 import { marked } from "marked";
-var execFileAsync = promisify(execFile);
+var execFileAsync2 = promisify2(execFile2);
 var MissingArticleError = class extends Error {
   constructor(message) {
     super(message);
@@ -7958,12 +9402,12 @@ async function getArticleContent(generationId, markdownOutputDir) {
     throw new MissingArticleError(`Generation "${generationId}" no longer exists.`);
   }
   const sourcePath = resolveGenerationSourcePath(generation, markdownOutputDir);
-  const canonicalSlug = generation.outputs.find((output) => output.contentType === generation.primaryContentType)?.slug ?? generation.outputs[0]?.slug ?? generation.id;
+  const canonicalSlug = generation.outputs.find((output2) => output2.contentType === generation.primaryContentType)?.slug ?? generation.outputs[0]?.slug ?? generation.id;
   const outputs = await Promise.all(
-    generation.outputs.map(async (output) => {
+    generation.outputs.map(async (output2) => {
       let markdown = "";
       try {
-        markdown = await readFile11(output.sourcePath, "utf8");
+        markdown = await readFile11(output2.sourcePath, "utf8");
       } catch (error) {
         if (isMissingFileError(error)) {
           throw new MissingArticleError(`Generation "${generationId}" no longer exists.`);
@@ -7971,13 +9415,13 @@ async function getArticleContent(generationId, markdownOutputDir) {
         throw error;
       }
       return {
-        id: output.id,
-        contentType: output.contentType,
-        contentTypeLabel: output.contentTypeLabel,
-        index: output.index,
+        id: output2.id,
+        contentType: output2.contentType,
+        contentTypeLabel: output2.contentTypeLabel,
+        index: output2.index,
         slug: canonicalSlug,
-        title: output.title,
-        htmlBody: await renderArticleHtml(markdown, generationId, output.sourcePath)
+        title: output2.title,
+        htmlBody: await renderArticleHtml(markdown, generationId, output2.sourcePath)
       };
     })
   );
@@ -8012,7 +9456,7 @@ async function resolveActivePreviewArticle(preferredMarkdownPath, markdownOutput
   };
 }
 function resolveGenerationSourcePath(generation, markdownOutputDir) {
-  return generation.outputs.find((output) => output.contentType === generation.primaryContentType)?.sourcePath ?? generation.outputs[0]?.sourcePath ?? path13.join(markdownOutputDir, generation.id);
+  return generation.outputs.find((output2) => output2.contentType === generation.primaryContentType)?.sourcePath ?? generation.outputs[0]?.sourcePath ?? path13.join(markdownOutputDir, generation.id);
 }
 function isMissingFileError(error) {
   return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
@@ -9632,14 +11076,14 @@ async function tryOpenBrowser(url) {
   }
   try {
     if (process.platform === "darwin") {
-      await execFileAsync("open", [url]);
+      await execFileAsync2("open", [url]);
       return;
     }
     if (process.platform === "win32") {
-      await execFileAsync("cmd", ["/c", "start", "", url]);
+      await execFileAsync2("cmd", ["/c", "start", "", url]);
       return;
     }
-    await execFileAsync("xdg-open", [url]);
+    await execFileAsync2("xdg-open", [url]);
   } catch {
   }
 }
@@ -9693,7 +11137,7 @@ async function runServeCommand(options) {
 // src/cli/commands/write.tsx
 import React4, { useEffect as useEffect3, useState as useState4 } from "react";
 import { render as render2, useApp as useApp3 } from "ink";
-import { createInterface } from "readline/promises";
+import { createInterface as createInterface2 } from "readline/promises";
 
 // src/cli/ui/pipelinePresenter.tsx
 import { Box as Box4, Text as Text4 } from "ink";
@@ -10166,17 +11610,17 @@ function formatPipelineStageCost(stage) {
   }
   return stage.costSource === "estimated" ? `~${formatted}` : formatted;
 }
-async function renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks, maxImages) {
+async function renderPlainPipeline(input2, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks, maxImages) {
   let previousStages = /* @__PURE__ */ new Map();
   let previousItemStatuses = /* @__PURE__ */ new Map();
-  const notificationsEnabled = input.config.settings.notifications.enabled;
+  const notificationsEnabled = input2.config.settings.notifications.enabled;
   try {
     await notifyWriteStarted({
       enabled: notificationsEnabled,
-      idea: input.idea,
+      idea: input2.idea,
       runMode
     });
-    const result = await runPipelineShell(input, {
+    const result = await runPipelineShell(input2, {
       dryRun,
       enrichLinks: enrichLinks2,
       runMode,
@@ -10306,8 +11750,8 @@ function WriteOptionsFlow({
       };
     });
   };
-  useInput2((input, key) => {
-    if (key.ctrl && input === "c") {
+  useInput2((input2, key) => {
+    if (key.ctrl && input2 === "c") {
       onDone(null);
       exit();
       return;
@@ -10323,7 +11767,7 @@ function WriteOptionsFlow({
       setCursor((current) => (current + 1) % secondarySelections.length);
       return;
     }
-    if (input === " ") {
+    if (input2 === " ") {
       setSecondarySelections(
         (current) => current.map(
           (item, index) => index === cursor && item.contentType !== primaryType ? {
@@ -10539,7 +11983,7 @@ function WriteOptionsFlow({
 import { jsx as jsx7 } from "react/jsx-runtime";
 var USER_INTERRUPTED_MESSAGE = "Write interrupted by user. Run `ideon write resume` to continue from the last checkpoint.";
 function WriteApp({
-  input,
+  input: input2,
   dryRun,
   enrichLinks: enrichLinks2,
   runMode,
@@ -10561,11 +12005,11 @@ function WriteApp({
     void (async () => {
       try {
         await notifyWriteStarted({
-          enabled: input.config.settings.notifications.enabled,
-          idea: input.idea,
+          enabled: input2.config.settings.notifications.enabled,
+          idea: input2.idea,
           runMode
         });
-        const runResult = await runPipelineShell(input, {
+        const runResult = await runPipelineShell(input2, {
           dryRun,
           enrichLinks: enrichLinks2,
           runMode,
@@ -10585,7 +12029,7 @@ function WriteApp({
         setResult(runResult);
         onSuccess?.(runResult);
         await notifyWriteSucceeded({
-          enabled: input.config.settings.notifications.enabled,
+          enabled: input2.config.settings.notifications.enabled,
           title: runResult.artifact.title,
           slug: runResult.artifact.slug
         });
@@ -10598,7 +12042,7 @@ function WriteApp({
         setErrorMessage(messageWithResumeHint);
         onError(new Error(messageWithResumeHint));
         await notifyWriteFailed({
-          enabled: input.config.settings.notifications.enabled,
+          enabled: input2.config.settings.notifications.enabled,
           message: messageWithResumeHint
         });
       }
@@ -10606,7 +12050,7 @@ function WriteApp({
     return () => {
       mounted = false;
     };
-  }, [dryRun, enrichLinks2, input, links, unlinks, maxLinks, maxImages, onError, runMode]);
+  }, [dryRun, enrichLinks2, input2, links, unlinks, maxLinks, maxImages, onError, runMode]);
   useEffect3(() => {
     if (!result && !errorMessage2) {
       return;
@@ -10618,11 +12062,11 @@ function WriteApp({
       clearTimeout(exitTimer);
     };
   }, [errorMessage2, exit, result]);
-  return /* @__PURE__ */ jsx7(PipelinePresenter, { prompt: input.idea, stages, result, errorMessage: errorMessage2 });
+  return /* @__PURE__ */ jsx7(PipelinePresenter, { prompt: input2.idea, stages, result, errorMessage: errorMessage2 });
 }
 async function runWriteCommand(options) {
-  const input = await resolveInputWithInteractiveIdeaFallback(options);
-  await runWritePipeline(input, options.dryRun, options.enrichLinks, "fresh", options.noInteractive, options.links, options.unlinks, options.maxLinks, options.maxImages, options.exportPath);
+  const input2 = await resolveInputWithInteractiveIdeaFallback(options);
+  await runWritePipeline(input2, options.dryRun, options.enrichLinks, "fresh", options.noInteractive, options.links, options.unlinks, options.maxLinks, options.maxImages, options.exportPath);
 }
 async function runWriteResumeCommand(options = {}) {
   const session = await loadWriteSession();
@@ -10636,7 +12080,7 @@ async function runWriteResumeCommand(options = {}) {
     idea: session.idea,
     audience: session.targetAudienceHint ?? void 0
   });
-  const input = {
+  const input2 = {
     ...resolved,
     job: session.job,
     config: {
@@ -10644,9 +12088,9 @@ async function runWriteResumeCommand(options = {}) {
       secrets: resolved.config.secrets
     }
   };
-  await runWritePipeline(input, session.dryRun, options.enrichLinks ?? false, "resume", options.noInteractive ?? false, options.links, options.unlinks, options.maxLinks, options.maxImages, options.exportPath);
+  await runWritePipeline(input2, session.dryRun, options.enrichLinks ?? false, "resume", options.noInteractive ?? false, options.links, options.unlinks, options.maxLinks, options.maxImages, options.exportPath);
 }
-async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteractive, links, unlinks, maxLinks, maxImages, exportPath) {
+async function runWritePipeline(input2, dryRun, enrichLinks2, runMode, noInteractive, links, unlinks, maxLinks, maxImages, exportPath) {
   let interruptHandled = false;
   const handleSignal = (signal) => {
     if (interruptHandled) {
@@ -10656,7 +12100,7 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
     void (async () => {
       try {
         await notifyWriteCanceled({
-          enabled: input.config.settings.notifications.enabled,
+          enabled: input2.config.settings.notifications.enabled,
           signal
         });
         await recordInterruptedWrite(signal);
@@ -10680,7 +12124,7 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
   process.on("SIGTERM", onSigterm);
   try {
     if (noInteractive || !process.stdout.isTTY) {
-      const result = await renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks, maxImages);
+      const result = await renderPlainPipeline(input2, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks, maxImages);
       if (exportPath) {
         await runOutputCommand({
           generationId: result.artifact.slug,
@@ -10695,7 +12139,7 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
       /* @__PURE__ */ jsx7(
         WriteApp,
         {
-          input,
+          input: input2,
           dryRun,
           enrichLinks: enrichLinks2,
           runMode,
@@ -10852,20 +12296,20 @@ function isMissingIdeaError(error) {
   return error.message.startsWith("No idea provided.");
 }
 async function promptForIdea() {
-  const readline = createInterface({
+  const readline2 = createInterface2({
     input: process.stdin,
     output: process.stdout
   });
   try {
     while (true) {
-      const idea = (await readline.question("Enter primary content prompt: ")).trim();
+      const idea = (await readline2.question("Enter primary content prompt: ")).trim();
       if (idea.length > 0) {
         return idea;
       }
       console.error("Prompt cannot be empty.");
     }
   } finally {
-    readline.close();
+    readline2.close();
   }
 }
 async function autoExport(exportPath, result) {
@@ -10902,6 +12346,36 @@ async function runCli(argv) {
   program.command("mcp").description("Model Context Protocol server operations.").command("serve").description("Start the Ideon MCP server over stdio transport.").action(async () => {
     await runMcpServeCommand();
   });
+  const gadsCommand = program.command("gads").description("Manage Google Ads integration credentials and verification.");
+  gadsCommand.command("login").description("Start OAuth flow to obtain Google Ads tokens.").option("--force", "Re-authorize even if a refresh token already exists", false).option("--developer-token <token>", "Google Ads developer token").option("--client-id <id>", "OAuth2 client ID").option("--client-secret <secret>", "OAuth2 client secret").option("--customer-id <id>", "Google Ads customer ID (10 digits)").option("--login-customer-id <id>", "Manager account customer ID (MCC only)").action(async (options) => {
+    await runGadsLoginCommand({
+      force: options.force,
+      developerToken: options.developerToken,
+      clientId: options.clientId,
+      clientSecret: options.clientSecret,
+      customerId: options.customerId,
+      loginCustomerId: options.loginCustomerId
+    });
+  });
+  gadsCommand.command("logout").description("Clear stored Google Ads credentials.").option("--all", "Clear all Google Ads credentials instead of just the refresh token", false).action(async (options) => {
+    await runGadsLogoutCommand({ all: options.all });
+  });
+  gadsCommand.command("status").description("Show which Google Ads credentials are configured.").option("--json", "Print machine-readable JSON output", false).action(async (options) => {
+    await runGadsStatusCommand({ json: options.json });
+  });
+  gadsCommand.command("test").description("Verify Google Ads credentials by making a test API call.").action(async () => {
+    await runGadsTestCommand({});
+  });
+  const gkpCommand = program.command("gkp").description("Query Google Ads Keyword Planner data.");
+  gkpCommand.command("ideas").description("Generate keyword ideas from seed keywords, a URL, or a site.").option("--keywords <keywords>", "Comma-separated seed keywords").option("--url <url>", "Seed URL for keyword ideas").option("--site <site>", "Seed site domain (exclusive with keywords/url)").option("--country <codes>", "Comma-separated ISO country codes (omit for all countries)").option("--language <code>", "ISO 639-1 language code (default: en)").option("--page-size <n>", "Number of results per page", (v) => Number.parseInt(v, 10)).option("--json", "Print machine-readable JSON output", false).action(async (options) => {
+    await runGkpIdeasCommand(options);
+  });
+  gkpCommand.command("historical").description("Get historical search volume and competition metrics for keywords.").requiredOption("--keywords <keywords>", "Comma-separated keywords to look up").option("--country <codes>", "Comma-separated ISO country codes (omit for all countries)").option("--language <code>", "ISO 639-1 language code (default: en)").option("--no-include-cpc", "Exclude average CPC from results").option("--json", "Print machine-readable JSON output", false).action(async (options) => {
+    await runGkpHistoricalCommand({ ...options, includeCpc: options.includeCpc });
+  });
+  gkpCommand.command("forecast").description("Get projected impressions, clicks, and cost for keywords.").requiredOption("--keywords <keywords>", "Comma-separated keywords to forecast").option("--match-type <type>", "Keyword match type: BROAD, EXACT, or PHRASE", "BROAD").option("--max-cpc-bid <micros>", "Max CPC bid in micros", (v) => Number.parseInt(v, 10)).option("--country <codes>", "Comma-separated ISO country codes (default: US)").option("--language <code>", "ISO 639-1 language code (default: en)").option("--start-date <date>", "Forecast start date (YYYY-MM-DD)").option("--end-date <date>", "Forecast end date (YYYY-MM-DD)").option("--json", "Print machine-readable JSON output", false).action(async (options) => {
+    await runGkpForecastCommand(options);
+  });
   const agentCommand = program.command("agent").description("Manage local agent integration runtime registrations.");
   agentCommand.command("install").description("Install a runtime integration profile (CLI/MCP only).").argument("<runtime>", "Runtime id (claude, chatgpt, gemini, generic-mcp)").option("--dry-run", "Preview actions without writing state", false).action(async (runtime, options) => {
     await runAgentInstallCommand({ runtime, dryRun: options.dryRun });