@clickminded/coauthor-cli 0.0.86 → 0.0.88

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/commands.js CHANGED
@@ -2480,7 +2480,11 @@ function seoPlanItemLine(item) {
2480
2480
  const id = planString(item, 'id') ?? '';
2481
2481
  const postType = planString(item, 'post_type');
2482
2482
  const linkMagnet = (item.kind === undefined || item.kind === 'post') && postType !== null && SEO_PLAN_LINK_MAGNET_POST_TYPES.includes(postType) ? '[link magnet] ' : '';
2483
- const head = ` ${id} ${linkMagnet}${title}`;
2483
+ const aiGap = item.ai_gap && typeof item.ai_gap === 'object' && Array.isArray(item.ai_gap.competitors)
2484
+ ? item.ai_gap.competitors
2485
+ : null;
2486
+ const aiGapTag = aiGap && aiGap.length > 0 ? '[AI gap] ' : '';
2487
+ const head = ` ${id} ${linkMagnet}${aiGapTag}${title}`;
2484
2488
  const search = keyword && keyword !== title ? ` [search: ${keyword}]` : '';
2485
2489
  const where = planString(item, 'existing_url');
2486
2490
  const position = typeof item.existing_position === 'number' ? ` (position ${item.existing_position})` : '';
@@ -2492,6 +2496,7 @@ function seoPlanItemLine(item) {
2492
2496
  `${head}${search}${facts ? ` (${facts})` : ''}${written}${dismissed}${done}`,
2493
2497
  where ? ` ${where}${position}` : null,
2494
2498
  hint ? ` ${hint}` : null,
2499
+ aiGapTag ? ` Google AI answers cite ${aiGap.filter((domain) => typeof domain === 'string').join(', ')} for this, not you.` : null,
2495
2500
  ].filter(Boolean).join('\n');
2496
2501
  }
2497
2502
  /**
@@ -2549,6 +2554,9 @@ function seoPlanShowMessage(data, kind) {
2549
2554
  lines.push(`This is a free preview of the plan (the first posts and a few pages to improve). \`coauthor seo-plan generate --wait\` finishes it into the full plan${firstPlanFree ? ', which is free (your first plan)' : ''}.`);
2550
2555
  if (view.stale === true)
2551
2556
  lines.push('The profile\'s website or market changed since this plan was made. `coauthor seo-plan generate` updates it.');
2557
+ if (view.ai_search_update_available === true) {
2558
+ lines.push(`New: AI search ideas. This plan was made before CoAuthor checked AI answers. \`coauthor seo-plan generate\` updates it to add the searches where Google's AI answers recommend competitors instead of this site${estimate ? ` (about ${estimate} credits)` : ''}.`);
2559
+ }
2552
2560
  const monthly = view.monthly_check === null || view.monthly_check === undefined ? null : planRecord(view.monthly_check);
2553
2561
  if (monthly) {
2554
2562
  if (monthly.enabled === true) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clickminded/coauthor-cli",
3
- "version": "0.0.86",
3
+ "version": "0.0.88",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "coauthor": "dist/index.js",
@@ -82,6 +82,18 @@ Other fields to use when you recommend an idea:
82
82
 
83
83
  A mention is not a citation: most mentions mean the AI read the page while answering. Report both numbers as they are, and do not promise that writing a post will change them. The human output of `show` prints one summary line. The web app shows a "Where AI search mentions you" section.
84
84
 
85
+ ### AI gap ideas
86
+
87
+ Some plans tag ideas whose searches are ones where Google AI answers cite a competitor and never mention the site. Those items carry `ai_gap` (`null` on every other item):
88
+
89
+ - `competitors`: the competitor domains the answers cite, most mentioned first (up to 3).
90
+ - `ai_search_volume`: DataForSEO's estimate of monthly AI searches behind the idea's matching searches.
91
+ - `questions`: on United States / English plans, up to 3 ChatGPT questions about the idea whose answers cite a competitor (`question`, `competitor`). Empty elsewhere.
92
+
93
+ An AI gap idea went through the same checks as every other idea; the tag explains why it matters, it does not mean the idea is more likely to rank. The human output of `show` prefixes it with `[AI gap]` and names the competitors. When you write one, `seo-plan write` puts its questions into the post's brief, and the outline answers them.
94
+
95
+ `ai_search_update_available` (top level of `show --json`) is `true` for a full plan made before AI search ideas went live on 2026-11-18. That plan has no `ai_visibility` and no AI gap ideas. Running `coauthor seo-plan generate` updates it and adds them, using the user's credits (`estimate_credits`). Mention it once when it is `true`, and do not update the plan without the user's go-ahead. It turns `false` after an update, and it is always `false` for previews and stale plans.
96
+
85
97
  ## Write this
86
98
 
87
99
  `coauthor seo-plan write <item-id> --json` opens a project for a `post` item and returns `data.project_id`, `data.created` and `data.start_prompt`. The project is already set up from the plan: the keyword, the post format, where the product goes, the related searches, and the posts it should link to. You do not need a brief interview or a keyword step.
@@ -687,6 +687,18 @@ Other fields to use when you recommend an idea:
687
687
 
688
688
  A mention is not a citation: most mentions mean the AI read the page while answering. Report both numbers as they are, and do not promise that writing a post will change them. The human output of `show` prints one summary line. The web app shows a "Where AI search mentions you" section.
689
689
 
690
+ #### AI gap ideas
691
+
692
+ Some plans tag ideas whose searches are ones where Google AI answers cite a competitor and never mention the site. Those items carry `ai_gap` (`null` on every other item):
693
+
694
+ - `competitors`: the competitor domains the answers cite, most mentioned first (up to 3).
695
+ - `ai_search_volume`: DataForSEO's estimate of monthly AI searches behind the idea's matching searches.
696
+ - `questions`: on United States / English plans, up to 3 ChatGPT questions about the idea whose answers cite a competitor (`question`, `competitor`). Empty elsewhere.
697
+
698
+ An AI gap idea went through the same checks as every other idea; the tag explains why it matters, it does not mean the idea is more likely to rank. The human output of `show` prefixes it with `[AI gap]` and names the competitors. When you write one, `seo-plan write` puts its questions into the post's brief, and the outline answers them.
699
+
700
+ `ai_search_update_available` (top level of `show --json`) is `true` for a full plan made before AI search ideas went live on 2026-11-18. That plan has no `ai_visibility` and no AI gap ideas. Running `coauthor seo-plan generate` updates it and adds them, using the user's credits (`estimate_credits`). Mention it once when it is `true`, and do not update the plan without the user's go-ahead. It turns `false` after an update, and it is always `false` for previews and stale plans.
701
+
690
702
  ### Write this
691
703
 
692
704
  `coauthor seo-plan write <item-id> --json` opens a project for a `post` item and returns `data.project_id`, `data.created` and `data.start_prompt`. The project is already set up from the plan: the keyword, the post format, where the product goes, the related searches, and the posts it should link to. You do not need a brief interview or a keyword step.