seo 0.16.1 → 0.17.0

package/dist/cli.js

@@ -1,131 +1,137 @@
 #!/usr/bin/env node
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import{$ as e,$n as t,$t as n,A as r,An as i,At as a,B as o,Bn as s,Bt as c,C as l,Cn as u,Ct as d,D as f,Dn as ee,Dt as te,E as p,En as ne,Et as m,F as re,Fn as ie,Ft as ae,G as oe,Gn as se,Gt as ce,H as le,Hn as ue,Ht as de,I as fe,In as pe,It as me,J as he,Jn as ge,Jt as _e,K as ve,Kn as ye,Kt as be,L as xe,Ln as Se,Lt as Ce,M as we,Mn as Te,Mt as Ee,N as De,Nn as Oe,Nt as ke,O as Ae,On as je,Ot as Me,P as Ne,Pn as Pe,Pt as Fe,Q as Ie,Qn as Le,Qt as Re,R as ze,Rn as Be,Rt as Ve,S as He,Sn as Ue,St as We,T as Ge,Tn as Ke,Tt as qe,U as Je,Un as Ye,Ut as Xe,V as Ze,Vn as Qe,Vt as $e,W as et,Wn as tt,Wt as nt,X as rt,Xn as it,Xt as at,Y as ot,Yn as st,Yt as ct,Z as lt,Zn as ut,Zt as dt,_ as ft,_n as pt,_t as mt,a as ht,an as gt,ar as _t,at as vt,b as yt,bn as bt,bt as xt,c as St,cn as Ct,cr as wt,ct as Tt,d as Et,dn as Dt,dr as Ot,dt as kt,en as At,er as jt,et as Mt,f as Nt,fn as Pt,ft as Ft,g as It,gn as Lt,gt as Rt,h as zt,hn as Bt,ht as Vt,i as Ht,in as Ut,ir as Wt,it as Gt,j as Kt,jn as qt,jt as Jt,k as Yt,kn as Xt,kt as Zt,l as Qt,ln as $t,lr as en,lt as tn,m as nn,mn as rn,mt as an,nn as on,nr as sn,nt as cn,o as ln,on as un,or as dn,ot as fn,p as pn,pn as mn,pt as hn,q as gn,qn as _n,qt as vn,rn as yn,rr as bn,rt as xn,sn as Sn,sr as h,st as Cn,t as wn,tn as Tn,tr as En,tt as Dn,u as On,un as kn,ur as An,ut as jn,v as Mn,vn as Nn,vt as Pn,w as Fn,wn as In,wt as Ln,x as Rn,xn as zn,xt as Bn,y as Vn,yn as Hn,yt as Un,z as Wn,zn as Gn,zt as Kn}from"./dist-CqzyPI3J.js";import{randomBytes as qn}from"node:crypto";import{arch as Jn,homedir as Yn,platform as Xn}from"node:os";import{basename as Zn,dirname as Qn,join as g,posix as $n,relative as er,resolve as tr,sep as nr,win32 as rr}from"node:path";import{constants as ir,copyFileSync as ar,createWriteStream as or,existsSync as _,mkdirSync as sr,readFileSync as cr,readdirSync as lr,realpathSync as ur,renameSync as dr,rmSync as fr,statSync as pr,writeFileSync as mr}from"node:fs";import{fileURLToPath as hr}from"node:url";import{cp as gr,mkdir as _r,readFile as v,readdir as vr,rename as yr,writeFile as br}from"node:fs/promises";import{isDeepStrictEqual as xr,stripVTControlCharacters as Sr}from"node:util";import{spawn as Cr,spawnSync as wr}from"node:child_process";import{defineCommand as y,runCommand as Tr,runMain as Er}from"citty";import{cancel as Dr,confirm as Or,intro as kr,isCancel as Ar,log as jr,multiselect as Mr,note as b,outro as x,password as Nr,select as Pr,text as Fr}from"@clack/prompts";import Ir from"picocolors";import Lr from"string-width";import Rr from"cli-table3";import{finished as zr}from"node:stream/promises";import{applyEdits as Br,modify as Vr,parse as Hr,printParseErrorCode as Ur}from"jsonc-parser";import Wr from"update-notifier";const S={summary:/* @__PURE__ */ `workflow.site.generated_at.summary.attribution.confidence.classification.updates_matched.known_confounders.page_segment_status.page_segment_eligible_rows.page_segment_returned_rows.page_segment_limited_rows.page_segment_result_limit.page_segment_source_row_limit.page_segment_source_possibly_truncated.page_segment_warnings.query_segment_status.query_segment_eligible_rows.query_segment_returned_rows.query_segment_limited_rows.query_segment_result_limit.query_segment_source_row_limit.query_segment_source_possibly_truncated.query_segment_warnings.device_segment_status.device_segment_eligible_rows.device_segment_returned_rows.device_segment_limited_rows.device_segment_result_limit.device_segment_source_row_limit.device_segment_source_possibly_truncated.device_segment_warnings.country_segment_status.country_segment_eligible_rows.country_segment_returned_rows.country_segment_limited_rows.country_segment_result_limit.country_segment_source_row_limit.country_segment_source_possibly_truncated.country_segment_warnings`.split(`.`),steps:[`rank`,`tool`,`status`,`summary`],actions:[`rank`,`title`,`confidence`,`action`],findings:[`dimension`,`data_status`,`eligible_rows`,`returned_rows`,`limited_rows`,`result_limit`,`unmatched_rows`,`summary`,`winner_key`,`winner_click_delta`,`winner_impression_delta`,`winner_position_delta`,`loser_key`,`loser_click_delta`,`loser_impression_delta`,`loser_position_delta`],templates:[`rank`,`direction`,`template`,`confidence`,`url_count`,`click_delta`,`impression_delta`,`movement_share`,`movement_share_scope`,`confidence_scope`,`eligible_rows`,`returned_rows`,`limited_rows`,`result_limit`,`source_possibly_truncated`,`common_terms`,`sample_urls`,`summary`],evidence:[`rank`,`evidence`],confounders:[`rank`,`source`,`title`,`date`,`scope`,`target`,`description`],segment:[`rank`,`dimension`,`data_status`,`evidence_scope`,`key`,`before_clicks`,`after_clicks`,`click_delta`,`before_impressions`,`after_impressions`,`impression_delta`,`before_position`,`after_position`,`position_delta`],unmatchedSegment:[`rank`,`dimension`,`data_status`,`key`,`retained_in`,`clicks`,`impressions`,`position`,`reason`]};function Gr(e,t){return[...e.output.segments[t].winners,...e.output.segments[t].losers].map((n,r)=>({rank:r+1,dimension:t,data_status:e.output.segments[t].dataStatus,evidence_scope:n.evidenceScope,key:n.key,before_clicks:n.beforeClicks,after_clicks:n.afterClicks,click_delta:n.clickDelta,before_impressions:n.beforeImpressions,after_impressions:n.afterImpressions,impression_delta:n.impressionDelta,before_position:n.beforePosition,after_position:n.afterPosition,position_delta:n.positionDelta}))}function Kr(e,t){return e.output.segments[t].unmatchedSegments.map((n,r)=>({rank:r+1,dimension:t,data_status:e.output.segments[t].dataStatus,key:n.key,retained_in:n.retainedIn,clicks:n.clicks,impressions:n.impressions,position:n.position,reason:n.reason}))}function qr(e){return[{filename:`postmortem-summary.csv`,headers:[...S.summary],rows:[{workflow:e.workflow,site:e.site,generated_at:e.generatedAt,summary:e.summary,attribution:e.output.update.attribution,confidence:e.output.update.confidence,classification:e.output.update.classification,updates_matched:e.output.update.overlappingUpdates.length,known_confounders:e.output.update.confounders.length,page_segment_status:e.output.segments.page.dataStatus,page_segment_eligible_rows:e.output.segments.page.coverage.eligibleRows,page_segment_returned_rows:e.output.segments.page.coverage.returnedRows,page_segment_limited_rows:e.output.segments.page.coverage.limitedRows,page_segment_result_limit:e.output.segments.page.coverage.resultLimit,page_segment_source_row_limit:e.output.segments.page.coverage.sourceRowLimit,page_segment_source_possibly_truncated:e.output.segments.page.coverage.sourcePossiblyTruncated,page_segment_warnings:e.output.segments.page.warnings.join(`; `),query_segment_status:e.output.segments.query.dataStatus,query_segment_eligible_rows:e.output.segments.query.coverage.eligibleRows,query_segment_returned_rows:e.output.segments.query.coverage.returnedRows,query_segment_limited_rows:e.output.segments.query.coverage.limitedRows,query_segment_result_limit:e.output.segments.query.coverage.resultLimit,query_segment_source_row_limit:e.output.segments.query.coverage.sourceRowLimit,query_segment_source_possibly_truncated:e.output.segments.query.coverage.sourcePossiblyTruncated,query_segment_warnings:e.output.segments.query.warnings.join(`; `),device_segment_status:e.output.segments.device.dataStatus,device_segment_eligible_rows:e.output.segments.device.coverage.eligibleRows,device_segment_returned_rows:e.output.segments.device.coverage.returnedRows,device_segment_limited_rows:e.output.segments.device.coverage.limitedRows,device_segment_result_limit:e.output.segments.device.coverage.resultLimit,device_segment_source_row_limit:e.output.segments.device.coverage.sourceRowLimit,device_segment_source_possibly_truncated:e.output.segments.device.coverage.sourcePossiblyTruncated,device_segment_warnings:e.output.segments.device.warnings.join(`; `),country_segment_status:e.output.segments.country.dataStatus,country_segment_eligible_rows:e.output.segments.country.coverage.eligibleRows,country_segment_returned_rows:e.output.segments.country.coverage.returnedRows,country_segment_limited_rows:e.output.segments.country.coverage.limitedRows,country_segment_result_limit:e.output.segments.country.coverage.resultLimit,country_segment_source_row_limit:e.output.segments.country.coverage.sourceRowLimit,country_segment_source_possibly_truncated:e.output.segments.country.coverage.sourcePossiblyTruncated,country_segment_warnings:e.output.segments.country.warnings.join(`; `)}]},{filename:`workflow-steps.csv`,headers:[...S.steps],rows:e.steps.map((e,t)=>({rank:t+1,tool:e.tool,status:e.status,summary:e.summary}))},{filename:`workflow-actions.csv`,headers:[...S.actions],rows:e.actions.map((e,t)=>({rank:t+1,title:e.title,confidence:e.confidence,action:e.action}))},{filename:`postmortem-findings.csv`,headers:[...S.findings],rows:e.output.insights.map(e=>({dimension:e.dimension,data_status:e.dataStatus,eligible_rows:e.coverage.eligibleRows,returned_rows:e.coverage.returnedRows,limited_rows:e.coverage.limitedRows,result_limit:e.coverage.resultLimit,unmatched_rows:e.unmatchedRows,summary:e.summary,winner_key:e.winner?.key,winner_click_delta:e.winner?.clickDelta,winner_impression_delta:e.winner?.impressionDelta,winner_position_delta:e.winner?.positionDelta,loser_key:e.loser?.key,loser_click_delta:e.loser?.clickDelta,loser_impression_delta:e.loser?.impressionDelta,loser_position_delta:e.loser?.positionDelta}))},{filename:`postmortem-template-movement.csv`,headers:[...S.templates],rows:e.output.templateMovement.map((e,t)=>({rank:t+1,direction:e.direction,template:e.signature,confidence:e.confidence,url_count:e.urlCount,click_delta:e.clickDelta,impression_delta:e.impressionDelta,movement_share:e.movementShare,movement_share_scope:e.movementShareScope,confidence_scope:e.confidenceScope,eligible_rows:e.segmentCoverage.eligibleRows,returned_rows:e.segmentCoverage.returnedRows,limited_rows:e.segmentCoverage.limitedRows,result_limit:e.segmentCoverage.resultLimit,source_possibly_truncated:e.segmentCoverage.sourcePossiblyTruncated,common_terms:e.commonTerms.join(`; `),sample_urls:e.sampleUrls.join(`; `),summary:e.summary}))},{filename:`postmortem-update-evidence.csv`,headers:[...S.evidence],rows:e.output.update.evidence.map((e,t)=>({rank:t+1,evidence:e}))},{filename:`postmortem-confounders.csv`,headers:[...S.confounders],rows:e.output.update.confounders.map((e,t)=>({rank:t+1,source:e.source,title:e.title,date:e.date,scope:e.scope,target:e.target,description:e.description}))},...[`page`,`query`,`device`,`country`].map(t=>({filename:`postmortem-segment-${t}.csv`,headers:[...S.segment],rows:Gr(e,t)})),...[`page`,`query`,`device`,`country`].map(t=>({filename:`postmortem-segment-${t}-unmatched.csv`,headers:[...S.unmatchedSegment],rows:Kr(e,t)}))]}function Jr(e){return _(e)?lr(e,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.log`)).map(t=>{let n=g(e,t.name),r=pr(n);return{path:n,size:r.size,modifiedAt:r.mtimeMs}}):[]}function Yr(e,t){let n=Qn(e),r=Zn(e,`.log`),i=0;for(;;){let e=g(n,`${r}.${t}${i?`-${i}`:``}.log`);if(!_(e))return e;i+=1}}function Xr(e={}){let t=e.directory??En().logDir,n=e.now??Date.now(),r=e.maxFileBytes??8388608,i=e.maxTotalBytes??67108864,a=e.maxAgeMs??12096e5;sr(t,{recursive:!0,mode:448});let o=0,s=0;for(let e of Jr(t))e.size<=r||(dr(e.path,Yr(e.path,n)),o+=1);for(let e of Jr(t))e.modifiedAt>=n-a||(fr(e.path,{force:!0}),s+=1);let c=Jr(t).sort((e,t)=>e.modifiedAt-t.modifiedAt||(e.path<t.path?-1:+(e.path>t.path))),l=c.reduce((e,t)=>e+t.size,0);for(let e of c){if(l<=i)break;fr(e.path,{force:!0}),l-=e.size,s+=1}return{rotated:o,removed:s,sizeBytes:l}}function Zr(e){let t=e-Date.now();if(t<=0)return`expired`;let n=Math.round(t/6e4);if(n<60)return`in ${n}m`;let r=Math.floor(n/60),i=n%60;return i?`in ${r}h ${i}m`:`in ${r}h`}function Qr(e,t){return{type:`boolean`,default:!0,description:e,negativeDescription:t}}function C(e){return typeof e==`string`?e:void 0}function w(e){return typeof e==`boolean`?e:void 0}function $r(e){let t=C(e.rendering);if(t!==void 0&&t!==`auto`&&t!==`on`&&t!==`off`)throw new h(`INVALID_INPUT`,`--rendering must be auto, on, or off.`);if(w(e.js)===!0&&t&&t!==`on`)throw new h(`INVALID_INPUT`,`Use either --js or --rendering on, not both with different modes.`);return t??(w(e.js)?`on`:`auto`)}function T(e,t){let n=w(e[t]);if(n===!1)return!0;if(n===!0)return!1;let r=w(e[ei(t)]);if(r===!1)return!0;if(r===!0)return!1;if(w(e[`no-${t}`])===!0||w(e[`no${ti(t)}`])===!0)return!0}function ei(e){return e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function ti(e){let t=ei(e);return t?`${t[0]?.toUpperCase()}${t.slice(1)}`:``}function E(e){if(typeof e==`number`)return e;if(typeof e!=`string`||!e.trim())return;let t=Number(e);return Number.isFinite(t)?t:void 0}function D(e,t){if(e===void 0||e===``)return;let n=E(e);if(n===void 0)throw new h(`INVALID_INPUT`,`${t} must be a number.`);return n}function O(e){if(typeof e!=`string`)return;let t=e.split(`,`).map(e=>e.trim()).filter(Boolean);return t.length?t:void 0}function ni(e){return O(e)??[]}function ri(e){let t={concurrency:E(e[`fetch-concurrency`]),intervalCap:E(e[`fetch-interval-cap`]),intervalMs:E(e[`fetch-interval-ms`])};return Object.values(t).some(e=>e!==void 0)?t:void 0}function k(e){return e.json===!0}async function ii(e,t){let n=C(e),r=C(t);if(n&&r)throw Error(`Use either --body or --body-file, not both.`);if(!n&&!r)return;let i=n??await v(r??``,`utf8`),a=JSON.parse(i);if(!a||typeof a!=`object`||Array.isArray(a))throw Error(`JSON body must be an object.`);return a}function A(e){if(e)return e;throw new h(`INVALID_INPUT`,"No site given. Pass --site with a domain, URL or sc-domain: property. Run `seo sites` to list your Search Console properties.")}async function ai(e,t={}){let n=A(e),r=(await Pt(t.refresh,t.account)).map(e=>e.siteUrl),i=bn(r,n);if(!i)throw new h(`PROPERTY_NOT_FOUND`,`This Google login has no Search Console property for ${n}. Run \`seo sites\` to list the properties it can read.`);return i}function oi(e){if(e)return e;throw new h(`INVALID_INPUT`,"No Google Analytics property given. Pass --property with the numeric property id. Run `seo analytics google properties` to list them.")}function si(e){if(typeof e==`number`)return Number.isFinite(e)?Math.round(e):void 0;if(!e)return;let t=Number.parseInt(e,10);return Number.isFinite(t)?t:void 0}function ci(e={}){let t=e.env??process.env,n=si(e.columns)??si(e.streamColumns)??si(t.COLUMNS)??80;return Math.min(200,Math.max(40,n))}function j(e={}){let t=e.env??process.env,n=e.isTTY??!!process.stdout.isTTY,r=e.color??!!(n&&t.NO_COLOR===void 0);return{columns:ci({...e,env:t,streamColumns:e.streamColumns??process.stdout.columns}),colors:Ir.createColors(r),hasColor:r,isInteractive:n&&!t.CI}}function M(e){return Lr(Sr(e))}function li(e,t){let n=[],r=``;for(let i of e)r&&M(`${r}${i}`)>t?(n.push(r),r=i):r+=i;return r&&n.push(r),n}function ui(e,t){if(!e)return[``];let n=e.trim().split(/\s+/u),r=[],i=``;for(let e of n){let n=M(e)>t?li(e,t):[e];for(let e of n)i?M(`${i} ${e}`)<=t?i+=` ${e}`:(r.push(i),i=e):i=e}return i&&r.push(i),r.length>0?r:[``]}function N(e,t){let n=Math.max(1,t);return e.replaceAll(`\r
+import{$ as e,$n as t,$t as n,A as r,An as i,At as a,B as o,Bn as s,Bt as c,C as l,Cn as u,Cr as d,Ct as f,D as ee,Dn as te,Dt as p,E as m,En as h,Et as g,F as ne,Fn as re,Ft as ie,G as ae,Gn as oe,Gt as se,H as ce,Hn as le,Ht as ue,I as de,In as fe,It as pe,J as me,Jn as he,Jt as ge,K as _e,Kn as ve,Kt as ye,L as be,Ln as xe,Lt as Se,M as Ce,Mn as we,Mt as Te,N as Ee,Nn as De,Nt as Oe,O as ke,On as Ae,Ot as je,P as Me,Pn as Ne,Pt as Pe,Q as Fe,Qn as Ie,Qt as Le,R as Re,Rn as ze,Rt as Be,S as Ve,Sn as He,Sr as Ue,St as We,T as Ge,Tn as Ke,Tt as qe,U as Je,Un as Ye,Ut as Xe,V as Ze,Vn as Qe,Vt as $e,W as et,Wn as tt,Wt as nt,X as rt,Xn as it,Xt as at,Y as ot,Yn as st,Yt as ct,Z as lt,Zn as ut,Zt as dt,_ as ft,_n as pt,_r as mt,_t as ht,a as gt,an as _t,ar as vt,at as yt,b as bt,bn as xt,br as St,bt as Ct,c as wt,cn as Tt,cr as Et,ct as Dt,d as Ot,dn as kt,dr as At,dt as jt,en as Mt,er as Nt,et as Pt,f as Ft,fn as It,fr as Lt,ft as Rt,g as zt,gn as Bt,gr as Vt,gt as Ht,h as Ut,hn as Wt,hr as Gt,ht as Kt,i as qt,in as Jt,ir as Yt,it as Xt,j as Zt,jn as Qt,jt as $t,k as en,kn as tn,kt as nn,l as rn,ln as an,lr as on,lt as sn,m as cn,mn as ln,mr as un,mt as dn,nn as fn,nr as pn,nt as mn,o as hn,on as gn,or as _n,ot as vn,p as yn,pn as bn,pr as xn,pt as Sn,q as Cn,qn as wn,qt as Tn,rn as En,rr as Dn,rt as On,sn as kn,sr as An,st as jn,t as Mn,tn as Nn,tr as Pn,tt as Fn,u as In,un as Ln,ur as Rn,ut as zn,v as Bn,vn as Vn,vr as Hn,vt as Un,w as Wn,wn as Gn,wt as Kn,x as qn,xn as Jn,xr as Yn,xt as Xn,y as Zn,yn as Qn,yr as _,z as $n,zn as er,zt as tr}from"./dist-DzEqoO8B.js";import{randomBytes as nr}from"node:crypto";import{arch as rr,homedir as ir,platform as ar}from"node:os";import{basename as or,dirname as sr,join as v,posix as cr,relative as lr,resolve as ur,sep as dr,win32 as fr}from"node:path";import{constants as pr,copyFileSync as mr,createWriteStream as hr,existsSync as y,mkdirSync as gr,readFileSync as _r,readdirSync as vr,realpathSync as yr,renameSync as br,rmSync as xr,statSync as Sr,writeFileSync as Cr}from"node:fs";import{fileURLToPath as wr}from"node:url";import{cp as Tr,mkdir as Er,open as Dr,readFile as b,readdir as Or,rename as kr,stat as Ar,writeFile as jr}from"node:fs/promises";import{isDeepStrictEqual as Mr,stripVTControlCharacters as Nr}from"node:util";import{spawn as Pr,spawnSync as Fr}from"node:child_process";import{defineCommand as x,runCommand as Ir,runMain as Lr}from"citty";import{cancel as Rr,confirm as zr,intro as Br,isCancel as Vr,log as Hr,multiselect as Ur,note as S,outro as C,password as Wr,select as Gr,text as Kr}from"@clack/prompts";import qr from"picocolors";import Jr from"string-width";import Yr from"cli-table3";import{finished as Xr}from"node:stream/promises";import{applyEdits as Zr,modify as Qr,parse as $r,printParseErrorCode as ei}from"jsonc-parser";import ti from"update-notifier";const w={summary:/* @__PURE__ */ `workflow.site.generated_at.summary.attribution.confidence.classification.updates_matched.known_confounders.page_segment_status.page_segment_eligible_rows.page_segment_returned_rows.page_segment_limited_rows.page_segment_result_limit.page_segment_source_row_limit.page_segment_source_possibly_truncated.page_segment_warnings.query_segment_status.query_segment_eligible_rows.query_segment_returned_rows.query_segment_limited_rows.query_segment_result_limit.query_segment_source_row_limit.query_segment_source_possibly_truncated.query_segment_warnings.device_segment_status.device_segment_eligible_rows.device_segment_returned_rows.device_segment_limited_rows.device_segment_result_limit.device_segment_source_row_limit.device_segment_source_possibly_truncated.device_segment_warnings.country_segment_status.country_segment_eligible_rows.country_segment_returned_rows.country_segment_limited_rows.country_segment_result_limit.country_segment_source_row_limit.country_segment_source_possibly_truncated.country_segment_warnings`.split(`.`),steps:[`rank`,`tool`,`status`,`summary`],actions:[`rank`,`title`,`confidence`,`action`],findings:[`dimension`,`data_status`,`eligible_rows`,`returned_rows`,`limited_rows`,`result_limit`,`unmatched_rows`,`summary`,`winner_key`,`winner_click_delta`,`winner_impression_delta`,`winner_position_delta`,`loser_key`,`loser_click_delta`,`loser_impression_delta`,`loser_position_delta`],templates:[`rank`,`direction`,`template`,`confidence`,`url_count`,`click_delta`,`impression_delta`,`movement_share`,`movement_share_scope`,`confidence_scope`,`eligible_rows`,`returned_rows`,`limited_rows`,`result_limit`,`source_possibly_truncated`,`common_terms`,`sample_urls`,`summary`],evidence:[`rank`,`evidence`],confounders:[`rank`,`source`,`title`,`date`,`scope`,`target`,`description`],segment:[`rank`,`dimension`,`data_status`,`evidence_scope`,`key`,`before_clicks`,`after_clicks`,`click_delta`,`before_impressions`,`after_impressions`,`impression_delta`,`before_position`,`after_position`,`position_delta`],unmatchedSegment:[`rank`,`dimension`,`data_status`,`key`,`retained_in`,`clicks`,`impressions`,`position`,`reason`]};function ni(e,t){return[...e.output.segments[t].winners,...e.output.segments[t].losers].map((n,r)=>({rank:r+1,dimension:t,data_status:e.output.segments[t].dataStatus,evidence_scope:n.evidenceScope,key:n.key,before_clicks:n.beforeClicks,after_clicks:n.afterClicks,click_delta:n.clickDelta,before_impressions:n.beforeImpressions,after_impressions:n.afterImpressions,impression_delta:n.impressionDelta,before_position:n.beforePosition,after_position:n.afterPosition,position_delta:n.positionDelta}))}function ri(e,t){return e.output.segments[t].unmatchedSegments.map((n,r)=>({rank:r+1,dimension:t,data_status:e.output.segments[t].dataStatus,key:n.key,retained_in:n.retainedIn,clicks:n.clicks,impressions:n.impressions,position:n.position,reason:n.reason}))}function ii(e){return[{filename:`postmortem-summary.csv`,headers:[...w.summary],rows:[{workflow:e.workflow,site:e.site,generated_at:e.generatedAt,summary:e.summary,attribution:e.output.update.attribution,confidence:e.output.update.confidence,classification:e.output.update.classification,updates_matched:e.output.update.overlappingUpdates.length,known_confounders:e.output.update.confounders.length,page_segment_status:e.output.segments.page.dataStatus,page_segment_eligible_rows:e.output.segments.page.coverage.eligibleRows,page_segment_returned_rows:e.output.segments.page.coverage.returnedRows,page_segment_limited_rows:e.output.segments.page.coverage.limitedRows,page_segment_result_limit:e.output.segments.page.coverage.resultLimit,page_segment_source_row_limit:e.output.segments.page.coverage.sourceRowLimit,page_segment_source_possibly_truncated:e.output.segments.page.coverage.sourcePossiblyTruncated,page_segment_warnings:e.output.segments.page.warnings.join(`; `),query_segment_status:e.output.segments.query.dataStatus,query_segment_eligible_rows:e.output.segments.query.coverage.eligibleRows,query_segment_returned_rows:e.output.segments.query.coverage.returnedRows,query_segment_limited_rows:e.output.segments.query.coverage.limitedRows,query_segment_result_limit:e.output.segments.query.coverage.resultLimit,query_segment_source_row_limit:e.output.segments.query.coverage.sourceRowLimit,query_segment_source_possibly_truncated:e.output.segments.query.coverage.sourcePossiblyTruncated,query_segment_warnings:e.output.segments.query.warnings.join(`; `),device_segment_status:e.output.segments.device.dataStatus,device_segment_eligible_rows:e.output.segments.device.coverage.eligibleRows,device_segment_returned_rows:e.output.segments.device.coverage.returnedRows,device_segment_limited_rows:e.output.segments.device.coverage.limitedRows,device_segment_result_limit:e.output.segments.device.coverage.resultLimit,device_segment_source_row_limit:e.output.segments.device.coverage.sourceRowLimit,device_segment_source_possibly_truncated:e.output.segments.device.coverage.sourcePossiblyTruncated,device_segment_warnings:e.output.segments.device.warnings.join(`; `),country_segment_status:e.output.segments.country.dataStatus,country_segment_eligible_rows:e.output.segments.country.coverage.eligibleRows,country_segment_returned_rows:e.output.segments.country.coverage.returnedRows,country_segment_limited_rows:e.output.segments.country.coverage.limitedRows,country_segment_result_limit:e.output.segments.country.coverage.resultLimit,country_segment_source_row_limit:e.output.segments.country.coverage.sourceRowLimit,country_segment_source_possibly_truncated:e.output.segments.country.coverage.sourcePossiblyTruncated,country_segment_warnings:e.output.segments.country.warnings.join(`; `)}]},{filename:`workflow-steps.csv`,headers:[...w.steps],rows:e.steps.map((e,t)=>({rank:t+1,tool:e.tool,status:e.status,summary:e.summary}))},{filename:`workflow-actions.csv`,headers:[...w.actions],rows:e.actions.map((e,t)=>({rank:t+1,title:e.title,confidence:e.confidence,action:e.action}))},{filename:`postmortem-findings.csv`,headers:[...w.findings],rows:e.output.insights.map(e=>({dimension:e.dimension,data_status:e.dataStatus,eligible_rows:e.coverage.eligibleRows,returned_rows:e.coverage.returnedRows,limited_rows:e.coverage.limitedRows,result_limit:e.coverage.resultLimit,unmatched_rows:e.unmatchedRows,summary:e.summary,winner_key:e.winner?.key,winner_click_delta:e.winner?.clickDelta,winner_impression_delta:e.winner?.impressionDelta,winner_position_delta:e.winner?.positionDelta,loser_key:e.loser?.key,loser_click_delta:e.loser?.clickDelta,loser_impression_delta:e.loser?.impressionDelta,loser_position_delta:e.loser?.positionDelta}))},{filename:`postmortem-template-movement.csv`,headers:[...w.templates],rows:e.output.templateMovement.map((e,t)=>({rank:t+1,direction:e.direction,template:e.signature,confidence:e.confidence,url_count:e.urlCount,click_delta:e.clickDelta,impression_delta:e.impressionDelta,movement_share:e.movementShare,movement_share_scope:e.movementShareScope,confidence_scope:e.confidenceScope,eligible_rows:e.segmentCoverage.eligibleRows,returned_rows:e.segmentCoverage.returnedRows,limited_rows:e.segmentCoverage.limitedRows,result_limit:e.segmentCoverage.resultLimit,source_possibly_truncated:e.segmentCoverage.sourcePossiblyTruncated,common_terms:e.commonTerms.join(`; `),sample_urls:e.sampleUrls.join(`; `),summary:e.summary}))},{filename:`postmortem-update-evidence.csv`,headers:[...w.evidence],rows:e.output.update.evidence.map((e,t)=>({rank:t+1,evidence:e}))},{filename:`postmortem-confounders.csv`,headers:[...w.confounders],rows:e.output.update.confounders.map((e,t)=>({rank:t+1,source:e.source,title:e.title,date:e.date,scope:e.scope,target:e.target,description:e.description}))},...[`page`,`query`,`device`,`country`].map(t=>({filename:`postmortem-segment-${t}.csv`,headers:[...w.segment],rows:ni(e,t)})),...[`page`,`query`,`device`,`country`].map(t=>({filename:`postmortem-segment-${t}-unmatched.csv`,headers:[...w.unmatchedSegment],rows:ri(e,t)}))]}function ai(e){return y(e)?vr(e,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.log`)).map(t=>{let n=v(e,t.name),r=Sr(n);return{path:n,size:r.size,modifiedAt:r.mtimeMs}}):[]}function oi(e,t){let n=sr(e),r=or(e,`.log`),i=0;for(;;){let e=v(n,`${r}.${t}${i?`-${i}`:``}.log`);if(!y(e))return e;i+=1}}function si(e={}){let t=e.directory??xn().logDir,n=e.now??Date.now(),r=e.maxFileBytes??8388608,i=e.maxTotalBytes??67108864,a=e.maxAgeMs??12096e5;gr(t,{recursive:!0,mode:448});let o=0,s=0;for(let e of ai(t))e.size<=r||(br(e.path,oi(e.path,n)),o+=1);for(let e of ai(t))e.modifiedAt>=n-a||(xr(e.path,{force:!0}),s+=1);let c=ai(t).sort((e,t)=>e.modifiedAt-t.modifiedAt||(e.path<t.path?-1:+(e.path>t.path))),l=c.reduce((e,t)=>e+t.size,0);for(let e of c){if(l<=i)break;xr(e.path,{force:!0}),l-=e.size,s+=1}return{rotated:o,removed:s,sizeBytes:l}}function ci(e){let t=e-Date.now();if(t<=0)return`expired`;let n=Math.round(t/6e4);if(n<60)return`in ${n}m`;let r=Math.floor(n/60),i=n%60;return i?`in ${r}h ${i}m`:`in ${r}h`}function li(e,t){return{type:`boolean`,default:!0,description:e,negativeDescription:t}}function T(e){return typeof e==`string`?e:void 0}function E(e){return typeof e==`boolean`?e:void 0}function ui(e){let t=T(e.rendering);if(t!==void 0&&t!==`auto`&&t!==`on`&&t!==`off`)throw new _(`INVALID_INPUT`,`--rendering must be auto, on, or off.`);if(E(e.js)===!0&&t&&t!==`on`)throw new _(`INVALID_INPUT`,`Use either --js or --rendering on, not both with different modes.`);return t??(E(e.js)?`on`:`auto`)}function D(e,t){let n=E(e[t]);if(n===!1)return!0;if(n===!0)return!1;let r=E(e[di(t)]);if(r===!1)return!0;if(r===!0)return!1;if(E(e[`no-${t}`])===!0||E(e[`no${fi(t)}`])===!0)return!0}function di(e){return e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function fi(e){let t=di(e);return t?`${t[0]?.toUpperCase()}${t.slice(1)}`:``}function O(e){if(typeof e==`number`)return e;if(typeof e!=`string`||!e.trim())return;let t=Number(e);return Number.isFinite(t)?t:void 0}function k(e,t){if(e===void 0||e===``)return;let n=O(e);if(n===void 0)throw new _(`INVALID_INPUT`,`${t} must be a number.`);return n}function A(e){if(typeof e!=`string`)return;let t=e.split(`,`).map(e=>e.trim()).filter(Boolean);return t.length?t:void 0}function pi(e){return A(e)??[]}function mi(e){let t={concurrency:O(e[`fetch-concurrency`]),intervalCap:O(e[`fetch-interval-cap`]),intervalMs:O(e[`fetch-interval-ms`])};return Object.values(t).some(e=>e!==void 0)?t:void 0}function j(e){return e.json===!0}async function hi(e,t){let n=T(e),r=T(t);if(n&&r)throw Error(`Use either --body or --body-file, not both.`);if(!n&&!r)return;let i=n??await b(r??``,`utf8`),a=JSON.parse(i);if(!a||typeof a!=`object`||Array.isArray(a))throw Error(`JSON body must be an object.`);return a}function M(e){if(e)return e;throw new _(`INVALID_INPUT`,"No site given. Pass --site with a domain, URL or sc-domain: property. Run `seo sites` to list your Search Console properties.")}async function gi(e,t={}){let n=M(e),r=(await Gn(t.refresh,t.account)).map(e=>e.siteUrl),i=Gt(r,n);if(!i)throw new _(`PROPERTY_NOT_FOUND`,`This Google login has no Search Console property for ${n}. Run \`seo sites\` to list the properties it can read.`);return i}function _i(e){if(e)return e;throw new _(`INVALID_INPUT`,"No Google Analytics property given. Pass --property with the numeric property id. Run `seo analytics google properties` to list them.")}function vi(e){if(typeof e==`number`)return Number.isFinite(e)?Math.round(e):void 0;if(!e)return;let t=Number.parseInt(e,10);return Number.isFinite(t)?t:void 0}function yi(e={}){let t=e.env??process.env,n=vi(e.columns)??vi(e.streamColumns)??vi(t.COLUMNS)??80;return Math.min(200,Math.max(40,n))}function N(e={}){let t=e.env??process.env,n=e.isTTY??!!process.stdout.isTTY,r=e.color??!!(n&&t.NO_COLOR===void 0);return{columns:yi({...e,env:t,streamColumns:e.streamColumns??process.stdout.columns}),colors:qr.createColors(r),hasColor:r,isInteractive:n&&!t.CI}}function P(e){return Jr(Nr(e))}function bi(e,t){let n=[],r=``;for(let i of e)r&&P(`${r}${i}`)>t?(n.push(r),r=i):r+=i;return r&&n.push(r),n}function xi(e,t){if(!e)return[``];let n=e.trim().split(/\s+/u),r=[],i=``;for(let e of n){let n=P(e)>t?bi(e,t):[e];for(let e of n)i?P(`${i} ${e}`)<=t?i+=` ${e}`:(r.push(i),i=e):i=e}return i&&r.push(i),r.length>0?r:[``]}function F(e,t){let n=Math.max(1,t);return e.replaceAll(`\r
 `,`
 `).split(`
-`).flatMap(e=>ui(e,n))}function di(e,t){if(M(e)<=t)return e;let n=Math.max(1,t-M(`...`)),r=``;for(let t of e){if(M(`${r}${t}`)>n)break;r+=t}return`${r}...`}const fi={top:``,"top-mid":``,"top-left":``,"top-right":``,bottom:``,"bottom-mid":``,"bottom-left":``,"bottom-right":``,left:``,"left-mid":``,mid:``,"mid-mid":``,right:``,"right-mid":``,middle:``};function pi(e){return e===void 0?``:String(e)}function mi(e,t){return e.map((e,n)=>{let r=t.map(e=>pi(e[n]));return Math.min(42,Math.max(M(e),...r.map(M),4))})}function hi(e,t,n){return e.length===0||e.length>4||!e.map((e,n)=>t.every(e=>/^-?(?:\d+(?:\.\d+)?|\d+(?:\.\d+)?%)$/u.test(pi(e[n]).trim()))).some(Boolean)?!1:mi(e,t).reduce((e,t)=>e+t+2,0)<=n.columns}function gi(e,t,n){if(!/(?:status|state|assessment|data|allowed)/iu.test(e))return t;let r=t.trim().toLowerCase();return[`pass`,`passed`,`completed`,`allowed`,`yes`].includes(r)?n.colors.green(t):[`warn`,`warning`,`review`,`partial`].includes(r)?n.colors.yellow(t):[`fail`,`failed`,`blocked`,`no`].includes(r)?n.colors.red(t):[`unknown`,`unavailable`].includes(r)?n.colors.blue(t):t}function _i(e,t,n){let r=mi(e,t).map(e=>e+2),i=new Rr({chars:fi,colWidths:r,head:e.map(e=>n.colors.bold(e)),style:{border:[],head:[],"padding-left":0,"padding-right":2},wordWrap:!1});for(let a of t)i.push(e.map((e,t)=>N(gi(e,pi(a[t]),n),Math.max(1,(r[t]??3)-2)).join(`
-`)));return i.toString()}function vi(e,t,n,r){let i=r.columns-n-2;return i<24?[r.colors.dim(e),...N(t,r.columns-2).map(e=>`  ${e}`)]:N(t,i).map((t,i)=>{let a=i===0?e.padEnd(n):``.padEnd(n);return`${r.colors.dim(a)}${` `.repeat(2)}${t}`})}function yi(e,t,n,r={}){let i=Math.min(28,Math.max(...e.map(e=>M(e)),0)),a=r.rowNumbers??!1,o=String(t.length).length;return t.map((t,r)=>{let s=[];a&&s.push(n.colors.bold(String(r+1).padStart(o,`0`)));for(let[r,a]of e.entries())s.push(...vi(a,gi(a,pi(t[r]),n),i,n));return s.join(`
+`).flatMap(e=>xi(e,n))}function Si(e,t){if(P(e)<=t)return e;let n=Math.max(1,t-P(`...`)),r=``;for(let t of e){if(P(`${r}${t}`)>n)break;r+=t}return`${r}...`}const Ci={top:``,"top-mid":``,"top-left":``,"top-right":``,bottom:``,"bottom-mid":``,"bottom-left":``,"bottom-right":``,left:``,"left-mid":``,mid:``,"mid-mid":``,right:``,"right-mid":``,middle:``};function wi(e){return e===void 0?``:String(e)}function Ti(e,t){return e.map((e,n)=>{let r=t.map(e=>wi(e[n]));return Math.min(42,Math.max(P(e),...r.map(P),4))})}function Ei(e,t,n){return e.length===0||e.length>4||!e.map((e,n)=>t.every(e=>/^-?(?:\d+(?:\.\d+)?|\d+(?:\.\d+)?%)$/u.test(wi(e[n]).trim()))).some(Boolean)?!1:Ti(e,t).reduce((e,t)=>e+t+2,0)<=n.columns}function Di(e,t,n){if(!/(?:status|state|assessment|data|allowed)/iu.test(e))return t;let r=t.trim().toLowerCase();return[`pass`,`passed`,`completed`,`allowed`,`yes`].includes(r)?n.colors.green(t):[`warn`,`warning`,`review`,`partial`].includes(r)?n.colors.yellow(t):[`fail`,`failed`,`blocked`,`no`].includes(r)?n.colors.red(t):[`unknown`,`unavailable`].includes(r)?n.colors.blue(t):t}function Oi(e,t,n){let r=Ti(e,t).map(e=>e+2),i=new Yr({chars:Ci,colWidths:r,head:e.map(e=>n.colors.bold(e)),style:{border:[],head:[],"padding-left":0,"padding-right":2},wordWrap:!1});for(let a of t)i.push(e.map((e,t)=>F(Di(e,wi(a[t]),n),Math.max(1,(r[t]??3)-2)).join(`
+`)));return i.toString()}function ki(e,t,n,r){let i=r.columns-n-2;return i<24?[r.colors.dim(e),...F(t,r.columns-2).map(e=>`  ${e}`)]:F(t,i).map((t,i)=>{let a=i===0?e.padEnd(n):``.padEnd(n);return`${r.colors.dim(a)}${` `.repeat(2)}${t}`})}function Ai(e,t,n,r={}){let i=Math.min(28,Math.max(...e.map(e=>P(e)),0)),a=r.rowNumbers??!1,o=String(t.length).length;return t.map((t,r)=>{let s=[];a&&s.push(n.colors.bold(String(r+1).padStart(o,`0`)));for(let[r,a]of e.entries())s.push(...ki(a,Di(a,wi(t[r]),n),i,n));return s.join(`
 `)}).join(`
 
-`)}function bi(e,t,n,r={}){return t.length===0?n.colors.dim(`No results.`):r.layout===`table`||r.layout!==`records`&&hi(e,t,n)?_i(e,t,n):yi(e,t,n,r)}function xi(e,t){if(e.length===0)return``;let n=Math.min(28,Math.max(...e.map(([e])=>M(e))));return e.flatMap(([e,r])=>{let i=vi(e,r,n,t);return i.length>0&&(i[0]=(i[0]??``).replace(e,t.colors.bold(e))),i}).join(`
-`)}function Si(e,t){let n=[t.colors.bold(e.title)];return e.body&&n.push(...N(e.body,t.columns)),e.command&&n.push(t.colors.cyan(di(e.command,t.columns))),n.join(`
-`)}function Ci(e,t){return e===`pass`?t.colors.green:e===`warning`?t.colors.yellow:e===`fail`?t.colors.red:e===`unknown`?t.colors.blue:e===`info`?t.colors.cyan:t.colors.dim}function wi(e){return e===`warning`?`WARN`:e===`notApplicable`?`N/A`:e.toUpperCase()}function Ti(e,t,n){let r=` `.repeat(t);return N(e,Math.max(1,n-t)).map(e=>`${r}${e}`)}function Ei(e,t){let n=Ci(e.status,t)(`[${wi(e.status)}]`.padEnd(10)),r=Math.max(1,t.columns-10),i=N(e.title,r).map((e,r)=>`${r===0?n:` `.repeat(10)}${t.colors.bold(e)}`);i.push(...Ti(e.explanation,10,t.columns));for(let n of e.evidence??[]){let e=N(n,Math.max(1,t.columns-20));i.push(...e.map((e,n)=>`${` `.repeat(10)}${n===0?`${t.colors.dim(`Evidence`)}  `:`          `}${e}`))}if(e.fix){let n=N(e.fix,Math.max(1,t.columns-15));i.push(...n.map((e,n)=>`${` `.repeat(10)}${n===0?`${t.colors.cyan(t.colors.bold(`Fix`))}  `:`     `}${e}`))}return i.join(`
-`)}function Di(e,t){return N(e.map(e=>{let n=String(e.value),r=e.status?Ci(e.status,t)(n):t.colors.bold(n);return`${e.label} ${r}`}).join(t.colors.dim(`  ·  `)),t.columns).join(`
-`)}function Oi(e,t){let n=Ci(e.status,t),r=[t.colors.bold(e.title)];e.target&&r.push(t.colors.dim(e.target)),r.push(``),r.push(`${n(wi(e.status))}  ${N(e.summary,Math.max(1,t.columns-6)).join(`
-      `)}`),e.metrics?.length&&r.push(Di(e.metrics,t));for(let n of e.sections.filter(e=>e.diagnostics.length>0))r.push(``,t.colors.bold(n.title)),r.push(n.diagnostics.map(e=>Ei(e,t)).join(`
+`)}function ji(e,t,n,r={}){return t.length===0?n.colors.dim(`No results.`):r.layout===`table`||r.layout!==`records`&&Ei(e,t,n)?Oi(e,t,n):Ai(e,t,n,r)}function Mi(e,t){if(e.length===0)return``;let n=Math.min(28,Math.max(...e.map(([e])=>P(e))));return e.flatMap(([e,r])=>{let i=ki(e,r,n,t);return i.length>0&&(i[0]=(i[0]??``).replace(e,t.colors.bold(e))),i}).join(`
+`)}function Ni(e,t){let n=[t.colors.bold(e.title)];return e.body&&n.push(...F(e.body,t.columns)),e.command&&n.push(t.colors.cyan(Si(e.command,t.columns))),n.join(`
+`)}function Pi(e,t){return e===`pass`?t.colors.green:e===`warning`?t.colors.yellow:e===`fail`?t.colors.red:e===`unknown`?t.colors.blue:e===`info`?t.colors.cyan:t.colors.dim}function Fi(e){return e===`warning`?`WARN`:e===`notApplicable`?`N/A`:e.toUpperCase()}function Ii(e,t,n){let r=` `.repeat(t);return F(e,Math.max(1,n-t)).map(e=>`${r}${e}`)}function Li(e,t){let n=Pi(e.status,t)(`[${Fi(e.status)}]`.padEnd(10)),r=Math.max(1,t.columns-10),i=F(e.title,r).map((e,r)=>`${r===0?n:` `.repeat(10)}${t.colors.bold(e)}`);i.push(...Ii(e.explanation,10,t.columns));for(let n of e.evidence??[]){let e=F(n,Math.max(1,t.columns-20));i.push(...e.map((e,n)=>`${` `.repeat(10)}${n===0?`${t.colors.dim(`Evidence`)}  `:`          `}${e}`))}if(e.fix){let n=F(e.fix,Math.max(1,t.columns-15));i.push(...n.map((e,n)=>`${` `.repeat(10)}${n===0?`${t.colors.cyan(t.colors.bold(`Fix`))}  `:`     `}${e}`))}return i.join(`
+`)}function Ri(e,t){return F(e.map(e=>{let n=String(e.value),r=e.status?Pi(e.status,t)(n):t.colors.bold(n);return`${e.label} ${r}`}).join(t.colors.dim(`  ·  `)),t.columns).join(`
+`)}function zi(e,t){let n=Pi(e.status,t),r=[t.colors.bold(e.title)];e.target&&r.push(t.colors.dim(e.target)),r.push(``),r.push(`${n(Fi(e.status))}  ${F(e.summary,Math.max(1,t.columns-6)).join(`
+      `)}`),e.metrics?.length&&r.push(Ri(e.metrics,t));for(let n of e.sections.filter(e=>e.diagnostics.length>0))r.push(``,t.colors.bold(n.title)),r.push(n.diagnostics.map(e=>Li(e,t)).join(`
 
-`));if(e.notes?.length){r.push(``,t.colors.bold(`Notes`));for(let n of e.notes){let e=N(n,Math.max(1,t.columns-2));r.push(...e.map((e,t)=>`${t===0?`- `:`  `}${e}`))}}return r.join(`
-`)}function ki(e,t,n=`${t}s`){return e===1?t:n}function Ai(e,t,n){let r=` `.repeat(t);return N(e,Math.max(1,n-t)).map(e=>`${r}${e}`)}function ji(e,t,n){return[t.colors.bold(e),...n?N(n,t.columns):[]].join(`
-`)}function Mi(e,t){let n={pass:t.colors.green,warn:t.colors.yellow,fail:t.colors.red};return e.map(e=>{let r=[`${n[e.status](e.status.toUpperCase().padEnd(4))}  ${t.colors.bold(e.label)}`];if(r.push(...Ai(e.detail,6,t.columns)),e.fix){let n=N(e.fix,Math.max(1,t.columns-11));r.push(...n.map((e,n)=>`${` `.repeat(6)}${n===0?`${t.colors.bold(`Fix`)}  `:`     `}${e}`))}return r.join(`
+`));if(e.notes?.length){r.push(``,t.colors.bold(`Notes`));for(let n of e.notes){let e=F(n,Math.max(1,t.columns-2));r.push(...e.map((e,t)=>`${t===0?`- `:`  `}${e}`))}}return r.join(`
+`)}function Bi(e,t,n=`${t}s`){return e===1?t:n}function Vi(e,t,n){let r=` `.repeat(t);return F(e,Math.max(1,n-t)).map(e=>`${r}${e}`)}function Hi(e,t,n){return[t.colors.bold(e),...n?F(n,t.columns):[]].join(`
+`)}function Ui(e,t){let n={pass:t.colors.green,warn:t.colors.yellow,fail:t.colors.red};return e.map(e=>{let r=[`${n[e.status](e.status.toUpperCase().padEnd(4))}  ${t.colors.bold(e.label)}`];if(r.push(...Vi(e.detail,6,t.columns)),e.fix){let n=F(e.fix,Math.max(1,t.columns-11));r.push(...n.map((e,n)=>`${` `.repeat(6)}${n===0?`${t.colors.bold(`Fix`)}  `:`     `}${e}`))}return r.join(`
 `)}).join(`
 
-`)}function Ni(e){let t=e.filter(e=>e.status===`pass`).length,n=e.filter(e=>e.status===`warn`).length,r=e.filter(e=>e.status===`fail`).length;return`${t} ${ki(t,`check`)} passed, ${n} ${ki(n,`warning`)}, ${r} failed.`}function Pi(e,t,n){let r=n.columns-t-2-2;return r<24||M(e.id)>t?[...Ai(e.id,2,n.columns).map(e=>n.colors.cyan(e)),...Ai(e.name,4,n.columns)].join(`
-`):N(e.name,r).map((r,i)=>{let a=i===0?e.id.padEnd(t):``.padEnd(t);return`  ${n.colors.cyan(a)}${` `.repeat(2)}${r}`}).join(`
-`)}function Fi(e){let t=e.replaceAll(`-`,` `);return t.charAt(0).toUpperCase()+t.slice(1)}function Ii(e,t,n){let r=/* @__PURE__ */ new Map;for(let t of e){let e=r.get(t.category)??[];e.push(t),r.set(t.category,e)}let i=`${e.length} ${ki(e.length,n.noun)} across ${r.size} ${ki(r.size,`category`,`categories`)}.`,a=Math.min(30,Math.max(...e.map(e=>M(e.id)),0)),o=Object.keys(n.categoryLabels??{}).filter(e=>r.has(e)),s=[...r.keys()].filter(e=>!o.includes(e));return[i,...[...o,...s].map(e=>{let i=r.get(e)??[],o=n.categoryLabels?.[e]??Fi(e);return[t.colors.bold(`${o} (${i.length})`),...i.map(e=>Pi(e,a,t))].join(`
+`)}function Wi(e){let t=e.filter(e=>e.status===`pass`).length,n=e.filter(e=>e.status===`warn`).length,r=e.filter(e=>e.status===`fail`).length;return`${t} ${Bi(t,`check`)} passed, ${n} ${Bi(n,`warning`)}, ${r} failed.`}function Gi(e,t,n){let r=n.columns-t-2-2;return r<24||P(e.id)>t?[...Vi(e.id,2,n.columns).map(e=>n.colors.cyan(e)),...Vi(e.name,4,n.columns)].join(`
+`):F(e.name,r).map((r,i)=>{let a=i===0?e.id.padEnd(t):``.padEnd(t);return`  ${n.colors.cyan(a)}${` `.repeat(2)}${r}`}).join(`
+`)}function Ki(e){let t=e.replaceAll(`-`,` `);return t.charAt(0).toUpperCase()+t.slice(1)}function qi(e,t,n){let r=/* @__PURE__ */ new Map;for(let t of e){let e=r.get(t.category)??[];e.push(t),r.set(t.category,e)}let i=`${e.length} ${Bi(e.length,n.noun)} across ${r.size} ${Bi(r.size,`category`,`categories`)}.`,a=Math.min(30,Math.max(...e.map(e=>P(e.id)),0)),o=Object.keys(n.categoryLabels??{}).filter(e=>r.has(e)),s=[...r.keys()].filter(e=>!o.includes(e));return[i,...[...o,...s].map(e=>{let i=r.get(e)??[],o=n.categoryLabels?.[e]??Ki(e);return[t.colors.bold(`${o} (${i.length})`),...i.map(e=>Gi(e,a,t))].join(`
 `)})].join(`
 
-`)}function Li(e,t,n){return e.length===0?t.colors.dim(n.empty):e.map(e=>{let n=[t.colors.bold(e.title)];e.description&&n.push(...Ai(e.description,2,t.columns));let r=e.meta?.filter(Boolean).join(` · `);return r&&n.push(...Ai(r,2,t.columns).map(e=>t.colors.dim(e))),n.join(`
+`)}function Ji(e,t,n){return e.length===0?t.colors.dim(n.empty):e.map(e=>{let n=[t.colors.bold(e.title)];e.description&&n.push(...Vi(e.description,2,t.columns));let r=e.meta?.filter(Boolean).join(` · `);return r&&n.push(...Vi(r,2,t.columns).map(e=>t.colors.dim(e))),n.join(`
 `)}).join(`
 
-`)}function Ri(e,t,n){let r=t.filter(e=>e.trim().length>0).flatMap(e=>N(e,n.columns));return[n.colors.bold(e),...r].join(`
-`)}function zi(e,t,n){let r=t.flatMap(e=>N(e,Math.max(1,n.columns-2)).map((e,t)=>`${t===0?`- `:`  `}${e}`));return[n.colors.bold(e),...r].join(`
-`)}function Bi(e,t){return e.length===0?t.colors.dim(`No parameters.`):Li(e.map(e=>({title:e.name,description:e.description,meta:[e.type,e.required?`required`:`optional`]})),t,{empty:`No parameters.`})}function P(e={}){return!(e.json||!process.stdin.isTTY||!process.stdout.isTTY||process.env.CI)}function F(e){let t=e&&typeof e==`object`&&!Array.isArray(e)?Qt():void 0,n=t?{...e,updateNotice:t}:e;process.stdout.write(`${JSON.stringify(n,null,2)}\n`)}function I(e){let t=xi(e,j());t&&process.stdout.write(`${t}\n`)}function L(e,t){process.stdout.write(`${bi(e,t,j())}\n`)}function R(e){process.stdout.write(`${Si(e,j())}\n`)}function Vi(e,t){process.stdout.write(`${ji(e,j(),t)}\n`)}function Hi(e){process.stdout.write(`${Mi(e,j())}\n`)}function Ui(e){process.stdout.write(`${Oi(e,j())}\n`)}function Wi(e,t){process.stdout.write(`${Ii(e,j(),t)}\n`)}function Gi(e,t){process.stdout.write(`${Li(e,j(),t)}\n`)}function z(e,...t){process.stdout.write(`${Ri(e,t,j())}\n`)}function Ki(e,t){process.stdout.write(`${zi(e,t,j())}\n`)}function qi(e){process.stdout.write(`${Bi(e,j())}\n`)}function Ji(e){return e<1024?`${e} B`:e<1048576?`${(e/1024).toFixed(1)} KB`:`${(e/1048576).toFixed(1)} MB`}function B(e){return typeof e==`symbol`&&process.exit(1),e}const Yi={site:`--site`,url:`--url`,section:`--section`,date:`--date`,pages:`--pages`,dimensions:`--dimensions`,detail:`--detail`,offset:`--offset`,max_urls:`--max-urls`,mark:`--mark`,issues:`--issues`,note:`--note`,end_date:`--end-date`},Xi=e=>/^[\w:/.,<>@#?=&%+-]+$/.test(String(e))?String(e):`"${e}"`,Zi=(e,t)=>[`seo ${e}`,...Object.entries(t??{}).filter(([,e])=>e!==void 0).map(([e,t])=>`${Yi[e]??`--${e}`} ${Xi(t??``)}`)].join(` `),Qi={account:{type:`string`,description:`Saved Google account email.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local cache and fetch fresh data.`}},$i={"start-date":{type:`string`,description:`Optional YYYY-MM-DD.`},"end-date":{type:`string`,description:`Optional YYYY-MM-DD.`}},ea={detail:{type:`string`,description:`summary (default), rows for the next page, or full.`},offset:{type:`string`,description:`rows only: the first row.`}};function V(e){let t=C(e.detail)??`summary`;if(![`summary`,`rows`,`full`].includes(t))throw new h(`INVALID_INPUT`,`--detail is summary, rows or full.`);return t}function ta(e,t){return ai(t,{refresh:w(e.refresh),account:C(e.account)})}async function H(e,t){try{let n=await t(r({call:Zi,account:C(e.account),refresh:w(e.refresh)}));k(e)?F(n.data):process.stdout.write(`${n.text}\n`)}catch(e){throw p(e)}}const na=y({meta:{name:`report`,description:"Start here. No --site: last week across your audited sites (beta, after `seo login`). --site: overview and every section. Add --section for one"},args:{site:{type:`string`,description:"Site, URL or Search Console property. Leave it out for the summary of every audited site (beta, after `seo login`)."},section:{type:`string`,description:`Optional, needs --site. One of ${[...Ie,xn,Dn].join(`, `)}. issues keeps a list of what was found for the site, on this machine. ${Dn} lays the latest Google ranking update (or the latest that started by --end-date) over the site.`},mark:{type:`string`,description:`With --site and --issues: ${Gt.join(`, `)}. Records what the person decided; runs no checks.`},issues:{type:`string`,description:`With --mark: issue ids from --section issues, comma-separated.`},note:{type:`string`,description:`Optional, with --mark: why.`},...$i,...ea,...Qi},run:async({args:t})=>{let n=C(t.section),r=[...Ie,xn,Dn];if(n&&!r.includes(n))throw new h(`INVALID_INPUT`,`--section is one of ${r.join(`, `)}.`);let i=C(t.site),a=C(t.mark),o=C(t.issues);if(a||o){if(a&&!Gt.includes(a))throw new h(`INVALID_INPUT`,`--mark is one of ${Gt.join(`, `)}.`);let e=await ta(t,A(i));await H(t,r=>Mt({site:e,section:n,mark:a,issues:o?.split(`,`),note:C(t.note)},r));return}if(!i&&!n&&Pe()){await H(t,e=>et(e));return}let s=n===`bing`?await ta(t,i).catch(()=>A(i)):await ta(t,i).catch(async r=>{if(n||!i)throw r;return await H(t,n=>e({site:A(i),startDate:C(t[`start-date`]),endDate:C(t[`end-date`])},n).catch(()=>{throw r})),null});s!==null&&await H(t,e=>Mt({site:s,section:n,startDate:C(t[`start-date`]),endDate:C(t[`end-date`]),detail:V(t),offset:E(t.offset)},e))}}),ra=y({meta:{name:`page`,description:`One URL: live page facts, Google index status and its queries`},args:{url:{type:`string`,description:`The page URL.`,required:!0},...$i,...ea,...Qi},run:async({args:e})=>{let t=C(e.url)??``;if(!/^https?:\/\/\S+$/.test(t))throw new h(`INVALID_INPUT`,`--url must be a full http(s) URL.`);let n=await ta(e,t);await H(e,r=>he({site:n,url:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:E(e.offset)},r))}}),ia=y({meta:{name:`compare`,description:`Equal periods before and after a date, with the pages and queries that moved`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},date:{type:`string`,description:`YYYY-MM-DD: the first day after the change.`,required:!0},pages:{type:`string`,description:`Optional URL text, such as /blog/.`},...Qi},run:async({args:e})=>{let t=await ta(e,C(e.site));await H(e,n=>ve({site:t,date:C(e.date)??``,pages:C(e.pages)},n))}}),aa=y({meta:{name:`index`,description:`Google indexing reasons for known URLs, checked live, and pages that lost most of their clicks`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},"max-urls":{type:`string`,description:`How many URLs to ask Google about, 100 by default. Ask for more when you want a fuller picture; it stops at the URL Inspection quota left today.`},...$i,...ea,...Qi},run:async({args:e})=>{let t=await ta(e,C(e.site)),n=E(e[`max-urls`]);if(n!==void 0&&(!Number.isInteger(n)||n<1||n>2e3))throw new h(`INVALID_INPUT`,`--max-urls is a whole number from 1 to ${fn}.`);await H(e,r=>gn({site:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:E(e.offset),maxUrls:n},r))}}),oa=y({meta:{name:`data`,description:`Raw Search Console or Bing rows beside the previous period, or Clicky landing pages`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},source:{type:`string`,description:`search_console (default), bing or clicky. Bing takes the first dimension, query or page. Clicky takes the site or its Clicky site ID.`},dimensions:{type:`string`,description:`Comma-separated: ${hn.join(`, `)}. Default query.`},page:{type:`string`,description:`Optional: only rows for pages whose URL contains this.`},query:{type:`string`,description:`Optional: only rows for queries that contain this.`},...$i,...ea,...Qi},run:async({args:e})=>{let t=O(e.dimensions)??[`query`],n=t.filter(e=>!hn.includes(e));if(n.length)throw new h(`INVALID_INPUT`,`Unknown dimensions: ${n.join(`, `)}. Use ${hn.join(`, `)}.`);let r=C(e.source)??`search_console`;if(![`search_console`,`bing`,`clicky`].includes(r))throw new h(`INVALID_INPUT`,`--source is search_console, bing or clicky.`);if(r===`clicky`){let t=A(C(e.site));await H(e,async()=>Tt({site:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:E(e.offset)},await Yt(),{connect:"save it at https://seoskill.dev/account#keys and run `seo login`, or run `seo analytics clicky connect` to keep it on this machine only.",refresh:Ae,call:e=>Zi(`data`,{source:`clicky`,site:t,detail:`rows`,offset:e})}));return}if(r===`bing`){let n=A(C(e.site));await H(e,r=>tn({site:n,dimension:t[0]===`page`?`page`:`query`,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:E(e.offset)},r));return}let i=await ta(e,C(e.site)),a=C(e.page),o=C(e.query);await H(e,n=>an({site:i,dimensions:t,filters:[...a?[{dimension:`page`,operator:`contains`,expression:a}]:[],...o?[{dimension:`query`,operator:`contains`,expression:o}]:[]],startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:E(e.offset)},n))}}),sa=y({meta:{name:`research`,description:`Keyword, SERP, competitor, backlink and AI answer data from your DataForSEO or Ahrefs key`},args:{action:{type:`positional`,required:!0,description:ot.join(`, `)},provider:{type:`string`,description:`${rt.join(`, `)}. Default: the first one with a saved key.`},keywords:{type:`string`,description:`Comma-separated keywords.`},tasks:{type:`string`,description:`ai_answers only: comma-separated tasks an earlier run returned as not ready.`},target:{type:`string`,description:`Domain or URL.`},competitors:{type:`string`,description:`link_gap only: 2 to 5 comma-separated competitor domains.`},country:{type:`string`,description:`Two-letter country code. Default us.`},...ea,account:Qi.account,json:Qi.json},run:async({args:e})=>{let t=C(e.action);if(!ot.includes(t))throw new h(`INVALID_INPUT`,`The action is one of ${ot.join(`, `)}.`);let n=await Yt(),r={dataforseo:`x-dataforseo-login`,ahrefs:`x-ahrefs-key`},i=C(e.provider)??(t===`ai_answers`?`dataforseo`:rt.find(e=>n.has(r[e])))??`dataforseo`;if(!rt.includes(i))throw new h(`INVALID_INPUT`,`--provider is one of ${rt.join(`, `)}.`);if(!n.has(r[i]))throw new h(`AUTH_CONFIG_REQUIRED`,`No ${i} key. Save it at https://seoskill.dev/account#keys and run \`seo login\`, or run \`seo providers ${i} connect\` to keep it on this machine only.`);let a=O(e.keywords)??[],o=C(e.target),s=O(e.competitors)??[],c=C(e.country);if(t===`ai_answers`){if(i!==`dataforseo`)throw new h(`INVALID_INPUT`,`ai_answers uses dataforseo.`);let r=O(e.tasks)??[],s=a.length||r.length?o??``:await ta(e,o);await H(e,i=>Ft({site:s,country:c??`us`,detail:V(e),offset:E(e.offset)??0,questions:a,tasks:r,waitSeconds:240},n,i,(e,n)=>Zi(`research`,{action:t,target:o,tasks:n.join(`,`)||void 0,country:c,detail:`rows`,offset:e}).replace(`--action `,``)))}else await H(e,()=>lt({provider:i,action:t,keywords:a,target:o,competitors:s,country:c,detail:V(e),offset:E(e.offset)},n,{call:e=>Zi(`research`,{action:t,provider:i,keywords:a.join(`,`)||void 0,target:o,competitors:s.join(`,`)||void 0,country:c,detail:`rows`,offset:e}).replace(`--action `,``)}))}}),ca=y({meta:{name:`lint`,description:`Check copy for patterns common in AI-written text, weak copy and title and description length`},args:{paths:{type:`positional`,required:!0,description:`Files, folders or globs: .md, .mdx, .html, .astro or .txt. Up to 100 files.`},preset:{type:`string`,description:`${Rt.join(`, `)}. Default blog for Markdown and text, landing for HTML and Astro. meta reads one title or description per line.`},format:{type:`string`,description:`${Vt.join(`, `)}. Default: from each file name.`},"fail-on":{type:`string`,description:`error (default) or warning: exit with code 1 when a finding at that level or above is found.`},ignore:{type:`string`,description:`Rule ids or review lenses to skip, comma-separated.`},"ignore-phrase":{type:`string`,description:`A phrase to allow, such as a product name a rule keeps matching. Repeat it for more.`},json:Qi.json},run:async({args:e})=>{let t=C(e.preset);if(t&&!Rt.includes(t))throw new h(`INVALID_INPUT`,`--preset is one of ${Rt.join(`, `)}.`);let n=C(e.format);if(n&&!Vt.includes(n))throw new h(`INVALID_INPUT`,`--format is one of ${Vt.join(`, `)}.`);let r=C(e[`fail-on`])??`error`;if(r!==`error`&&r!==`warning`)throw new h(`INVALID_INPUT`,`--fail-on is error or warning.`);let i=(e._??[]).filter(e=>typeof e==`string`),a=[].concat(e[`ignore-phrase`]??[]).filter(e=>typeof e==`string`);try{let o=await cn({paths:i,preset:t,format:n,ignoreRules:O(e.ignore),ignorePhrases:a},e=>l(e));k(e)?F(o.data):process.stdout.write(`${o.text}\n`);let{errors:s,warnings:c}=o.data;(s>0||r===`warning`&&c>0)&&(process.exitCode=1)}catch(e){throw p(e)}}});function la(e){return e===`keychain`?`system keychain`:e===`file`?`private local file`:e===`environment`?vn:e??`missing`}function ua(e){if(e&&Un(e))return e.trim();throw new h(`INVALID_INPUT`,`No Clicky site given. Pass --site-id with the numeric Clicky site ID.`)}async function da(e,t){return Pn({siteId:e,sitekey:t}).catch(e=>{throw new h(e instanceof mt&&e.code===`auth`?`AUTH_REQUIRED`:`PROVIDER_UNAVAILABLE`,e instanceof Error?e.message:String(e))})}const fa={type:`boolean`,default:!1,description:`Print machine-readable JSON.`},pa={type:`string`,description:`Numeric Clicky site ID.`},ma=y({meta:{name:`connect`,description:`Check and save a Clicky site on this machine`},args:{"site-id":pa,json:fa},run:async({args:e})=>{let t=k(e),n=P({json:t});n&&kr(`Connect Clicky`);let r=ua(C(e[`site-id`])??(n?B(await Fr({message:`Clicky site ID`,validate:e=>Un(e??``)?void 0:`Enter the numeric site ID from Clicky`})):void 0)),i=process.env.SEO_CLICKY_SITEKEY?.trim()||(n?B(await Nr({message:`Clicky sitekey`,validate:e=>xt(e??``)?void 0:`Enter the sitekey from Clicky (Preferences, Info)`})):void 0);if(!i)throw new h(`AUTH_REQUIRED`,`Run this command in a terminal or set ${vn}.`);let a=await da(r,i.trim()),o=await dt(r,i.trim()),s={siteId:r,domain:a,connected:!0,credentialSource:o};if(t){F(s);return}let c=`Clicky site ${r}${a?` (${a})`:``} saved in the ${la(o)}. Next: seo analytics clicky report --site ${r}`;n?x(c):process.stdout.write(`${c}\n`)}}),ha=y({meta:{name:`status`,description:`Show a Clicky site saved on this machine`},args:{"site-id":pa,check:{type:`boolean`,default:!1,description:`Check the saved sitekey with Clicky.`},json:fa},run:async({args:e})=>{let t=ua(C(e[`site-id`])),n=await at(t),r=w(e.check);r&&n&&await da(t,n.siteKey);let i={siteId:t,connected:!!n,credentialSource:n?.source,liveCheck:r?n?`passed`:`unavailable`:`not-requested`};k(e)?F(i):I([[`Site ID`,t],[`Connected`,i.connected?`yes`:`no`],[`Credential`,la(i.credentialSource)],[`Live check`,i.liveCheck]])}}),ga=y({meta:{name:`report`,description:`Clicky landing pages, traffic sources and search engines`},args:{site:{type:`string`,description:`The site, or its numeric Clicky site ID.`},...$i,...ea,json:fa},run:async({args:e})=>{let t=A(C(e.site));await H(e,async()=>Tt({site:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:E(e.offset)},await Yt(),{connect:"save it at https://seoskill.dev/account#keys and run `seo login`, or run `seo analytics clicky connect` to keep it on this machine only.",refresh:Ae,call:e=>`seo analytics clicky report --site ${t} --detail rows --offset ${e}`}))}}),_a=y({meta:{name:`disconnect`,description:`Remove a Clicky site saved on this machine`},args:{"site-id":pa,json:fa},run:async({args:e})=>{let t=ua(C(e[`site-id`]));await _e(t);let n=!!process.env[vn],r={siteId:t,savedCredentialRemoved:!0,environmentCredential:n?`active`:`missing`};k(e)?F(r):process.stdout.write(n?`Saved sitekey removed. ${vn} is still active.\n`:`Clicky is disconnected for this site.
-`)}}),va=y({meta:{name:`clicky`,description:`Read Clicky, or save a Clicky site on this machine only`},subCommands:{connect:ma,status:ha,report:ga,disconnect:_a}}),ya=y({meta:{name:`properties`,description:`List Google Analytics accounts and properties`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},account:{type:`string`,description:`Saved Google account email.`}},run:async({args:e})=>{let t=await pt(C(e.account)),n=t.flatMap(e=>e.propertySummaries.map(t=>({account:e.displayName??e.account,property:Lt(t.property),displayName:t.displayName??t.property})));k(e)?F({accountSummaries:t,properties:n}):L([`Property`,`Name`,`Account`],n.map(e=>[e.property,e.displayName,e.account]))}}),ba=y({meta:{name:`report`,description:`Google Analytics landing pages for visits from search`},args:{property:{type:`string`,description:"Numeric Google Analytics property ID. Run `seo analytics google properties` to list them."},...$i,...ea,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=oi(C(e.property));await H(e,async()=>kt({property:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:E(e.offset)},await jn(await Ge(),t,bt.signIn),{signIn:bt.signIn,call:e=>`seo analytics google report --property ${t} --detail rows --offset ${e}`}))}}),xa=y({meta:{name:`google`,description:`Read Google Analytics properties and reports`},subCommands:{properties:ya,report:ba}}),Sa=y({meta:{name:`analytics`,description:`Read analytics data from connected providers`},subCommands:{clicky:va,google:xa}});function Ca(){return`Your browser will open. Choose your Google account and select all permission boxes for read-only access. Keep this terminal open and finish the browser steps within five minutes.`}async function wa(){return b(Ca(),`Google sign-in`),zn()}function Ta(e){return e?e===`environment-json`?`SEO_GOOGLE_SERVICE_ACCOUNT_JSON`:e===`environment-file`?`SEO_GOOGLE_SERVICE_ACCOUNT_FILE`:`GOOGLE_APPLICATION_CREDENTIALS`:`invalid or conflicting configuration`}function Ea(e){return e.active===`keychain`?`system keychain`:e.configured===`keychain`?`private file fallback`:`private file`}function Da(e){return e===`shared`?`SEO Skill app`:`Local OAuth config`}function Oa(e){let t=[[`Account`,e.accountEmail]],n=new Set(e.scope.split(/\s+/u).filter(Boolean));return n.has(`https://www.googleapis.com/auth/webmasters.readonly`)?t.push([`Search Console`,`Read only`]):t.push([`Search Console`,`Not granted`]),n.has(`https://www.googleapis.com/auth/analytics.readonly`)?t.push([`Google Analytics`,`Read only`]):t.push([`Google Analytics`,`Not granted`]),t.push([`OAuth app`,Da(e.clientSource)],[`Expires`,Zr(e.expiresAt)]),t}const ka=y({meta:{name:`auth`,description:`Authentication commands`},subCommands:{login:y({meta:{name:`login`,description:`Run Google OAuth flow`},run:async()=>{if((await Ue()).activeMode===`service-account`)throw new h(`AUTH_CONFIG_REQUIRED`,`A service account is active from the environment. Unset its credential variable before running browser OAuth.`);let e=await wa();I(Oa({accountEmail:e.account_email,clientSource:e.client_source,expiresAt:e.expires_at,scope:e.scope}))}}),logout:y({meta:{name:`logout`,description:`Delete a local Google login`},args:{account:{type:`string`,description:`Delete the login for this Google account.`},all:{type:`boolean`,default:!1,description:`Delete every saved Google login.`}},run:async({args:e})=>{let t=await Ue(),n=C(e.account);if(n&&e.all)throw new h(`INVALID_INPUT`,`Use either --account or --all, not both.`);let r=e.all?void 0:n??t.accounts.find(e=>e.active)?.accountEmail;await In(r),t.activeMode===`service-account`?process.stdout.write(`${e.all?`Deleted all local Google logins.`:r?`Deleted the local login for ${r}.`:`No local Google login was found.`} Service account credentials remain available through the environment.\n`):process.stdout.write(`${e.all?`Deleted all local Google logins.`:r?`Deleted the local login for ${r}.`:`No local Google login was found.`}\nRevoke at https://myaccount.google.com/permissions if you also want Google to forget the grant.\n`)}}),whoami:y({meta:{name:`whoami`,description:`Show the signed-in Google account`},args:{account:{type:`string`,description:`Show this saved Google account.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Ue();if(t.activeMode===`service-account`){let n={mode:`service-account`,account:t.identity??null,source:Ta(t.serviceAccount.source)};if(k(e)){F(n);return}I([[`Account type`,`Service account`],[`Account`,t.identity??`Invalid configuration`],[`Credentials`,n.source],[`Access`,`Search Console and Google Analytics, read only`]]);return}let n=C(e.account),r=n?await je(n):t.tokens;if(n&&!r)throw new h(`AUTH_REQUIRED`,`Google account ${n} is not connected.`);if(r)k(e)?F({mode:`oauth`,account:r.account_email,scopes:r.scope.split(/\s+/u).filter(Boolean),clientSource:r.client_source,expiresAt:r.expires_at}):I(Oa({accountEmail:r.account_email,clientSource:r.client_source,expiresAt:r.expires_at,scope:r.scope}));else{if(k(e)){F({mode:`oauth`,account:null});return}process.stdout.write(`Not logged in.
-`)}}}),status:y({meta:{name:`status`,description:`Show local Google auth status`},args:{account:{type:`string`,description:`Show status for this saved Google account.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Ue(),n=C(e.account),r=n?await je(n):t.tokens;if(n&&!r&&t.activeMode!==`service-account`)throw new h(`AUTH_REQUIRED`,`Google account ${n} is not connected.`);let i=t.activeMode===`oauth`?await ne():void 0;if(k(e)){F({authenticated:t.activeMode===`oauth`?!!r:t.serviceAccount.configured,mode:t.activeMode,identity:t.identity,account:t.activeMode===`oauth`?r?.account_email:void 0,scopes:t.activeMode===`oauth`?r?.scope:void 0,clientSource:t.activeMode===`oauth`?r?.client_source:void 0,expiresAt:t.activeMode===`oauth`?r?.expires_at:void 0,sharedConfigured:t.sharedConfigured,byoConfigured:t.byoConfigured,serviceAccount:{configured:t.serviceAccount.configured,identity:t.serviceAccount.identity,source:t.serviceAccount.source,error:t.serviceAccount.error},accounts:t.accounts,...i?{tokenStorage:i}:{}});return}if(t.activeMode===`service-account`){let e=[[`Mode`,`service account`],[`Identity`,t.identity??`unavailable`],[`Source`,Ta(t.serviceAccount.source)],[`Scopes`,`Search Console readonly, Google Analytics readonly`],[`Storage`,`credentials stay in the environment`]];t.serviceAccount.error&&e.push([`Status`,t.serviceAccount.error]),I(e);return}if(!r){let e=t.serviceAccount.error?t.serviceAccount.error:t.sharedConfigured?`Shared seo app available`:t.byoConfigured?`Local OAuth config available`:`No OAuth client configured`;process.stdout.write(`Not logged in. ${e}. Run \`seo auth login\` to connect Google.\n`);return}let a=i??await ne();I([[`Account`,r.account_email],[`Connected accounts`,String(t.accounts.length)],[`Scopes`,r.scope],[`Client`,Da(r.client_source)],[`Expires`,Zr(r.expires_at)],[`Tokens file`,En().tokensFile],[`Token storage`,Ea(a)],...a.reason?[[`Storage note`,a.reason]]:[],[`OAuth mode`,t.sharedConfigured?`SEO Skill app available`:t.byoConfigured?`Local OAuth config available`:`missing`],[`Revoke at`,`https://myaccount.google.com/permissions`]])}}),storage:y({meta:{name:`storage`,description:`Show or change local OAuth token storage`},args:{keychain:{type:`boolean`,default:!1,description:`Store OAuth tokens in the system keychain when available.`},file:{type:`boolean`,default:!1,description:`Store OAuth tokens in the private local file.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(e.keychain&&e.file)throw new h(`INVALID_INPUT`,`Choose either --keychain or --file, not both.`);let t=e.keychain||e.file?await i(e.keychain?`keychain`:`file`):await ne();k(e)?F(t):I([[`Configured storage`,t.configured],[`Active storage`,Ea(t)],...t.reason?[[`Note`,t.reason]]:[]])}}),refresh:y({meta:{name:`refresh`,description:`Refresh the Google OAuth token`},args:{account:{type:`string`,description:`Refresh this saved Google account.`}},run:async({args:e})=>{if((await Ue()).activeMode===`service-account`){process.stdout.write(`Service accounts request short-lived Google tokens automatically. No local refresh token is stored.
-`);return}let t=await u(C(e.account));process.stdout.write(`Refreshed. New expiry ${new Date(t.expires_at).toISOString()}.\n`)}}),accounts:y({meta:{name:`accounts`,description:`List saved Google accounts`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=ee();k(e)?F({accounts:t}):t.length===0?process.stdout.write(`No Google accounts are connected.
-`):I(t.map(e=>[e.active?`Active account`:`Account`,e.accountEmail]))}}),use:y({meta:{name:`use`,description:`Select the default Google account`},args:{account:{type:`positional`,required:!0,description:`Saved Google account email.`}},run:({args:e})=>{let t=C(e.account);if(!t)throw new h(`INVALID_INPUT`,`Google account is required.`);Xt(t),process.stdout.write(`Default Google account: ${t}\n`)}}),"setup-client":y({meta:{name:`setup-client`,description:`Save your own Google Desktop OAuth client`},args:{json:{type:`boolean`,default:!1,description:`Return a structured error instead of prompting.`}},run:async({args:e})=>{if(!P({json:k(e)}))throw new h(`INVALID_INPUT`,"`seo auth setup-client` needs an interactive terminal. Run it without --json, or set SEO_GOOGLE_CLIENT_ID and SEO_GOOGLE_CLIENT_SECRET.");kr(`Local Google OAuth client`),b(`This is the advanced path.
+`)}function Yi(e,t,n){let r=t.filter(e=>e.trim().length>0).flatMap(e=>F(e,n.columns));return[n.colors.bold(e),...r].join(`
+`)}function Xi(e,t,n){let r=t.flatMap(e=>F(e,Math.max(1,n.columns-2)).map((e,t)=>`${t===0?`- `:`  `}${e}`));return[n.colors.bold(e),...r].join(`
+`)}function Zi(e,t){return e.length===0?t.colors.dim(`No parameters.`):Ji(e.map(e=>({title:e.name,description:e.description,meta:[e.type,e.required?`required`:`optional`]})),t,{empty:`No parameters.`})}function I(e={}){return!(e.json||!process.stdin.isTTY||!process.stdout.isTTY||process.env.CI)}function L(e){let t=e&&typeof e==`object`&&!Array.isArray(e)?rn():void 0,n=t?{...e,updateNotice:t}:e;process.stdout.write(`${JSON.stringify(n,null,2)}\n`)}function R(e){let t=Mi(e,N());t&&process.stdout.write(`${t}\n`)}function z(e,t){process.stdout.write(`${ji(e,t,N())}\n`)}function Qi(e){process.stdout.write(`${Ni(e,N())}\n`)}function $i(e,t){process.stdout.write(`${Hi(e,N(),t)}\n`)}function ea(e){process.stdout.write(`${Ui(e,N())}\n`)}function ta(e){process.stdout.write(`${zi(e,N())}\n`)}function na(e,t){process.stdout.write(`${qi(e,N(),t)}\n`)}function ra(e,t){process.stdout.write(`${Ji(e,N(),t)}\n`)}function ia(e,...t){process.stdout.write(`${Yi(e,t,N())}\n`)}function aa(e,t){process.stdout.write(`${Xi(e,t,N())}\n`)}function oa(e){process.stdout.write(`${Zi(e,N())}\n`)}function sa(e){return e<1024?`${e} B`:e<1048576?`${(e/1024).toFixed(1)} KB`:`${(e/1048576).toFixed(1)} MB`}function B(e){return typeof e==`symbol`&&process.exit(1),e}function ca(e){if(!e)return;let t=Date.now();return e=>{let n=((Date.now()-t)/1e3).toFixed(1);process.stderr.write(`[seo ${n}s] ${e}\n`)}}const la={site:`--site`,url:`--url`,section:`--section`,date:`--date`,pages:`--pages`,dimensions:`--dimensions`,detail:`--detail`,offset:`--offset`,max_urls:`--max-urls`,mark:`--mark`,issues:`--issues`,note:`--note`,end_date:`--end-date`},ua=e=>/^[\w:/.,<>@#?=&%+-]+$/.test(String(e))?String(e):`"${e}"`,da=(e,t)=>[`seo ${e}`,...Object.entries(t??{}).filter(([,e])=>e!==void 0).map(([e,t])=>`${la[e]??`--${e}`} ${ua(t??``)}`)].join(` `),fa={account:{type:`string`,description:`Saved Google account email.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local cache and fetch fresh data.`}},pa={"start-date":{type:`string`,description:`Optional YYYY-MM-DD.`},"end-date":{type:`string`,description:`Optional YYYY-MM-DD.`}},ma={detail:{type:`string`,description:`summary (default), rows for the next page, or full.`},offset:{type:`string`,description:`rows only: the first row.`}};function V(e){let t=T(e.detail)??`summary`;if(![`summary`,`rows`,`full`].includes(t))throw new _(`INVALID_INPUT`,`--detail is summary, rows or full.`);return t}function ha(e,t){return gi(t,{refresh:E(e.refresh),account:T(e.account)})}async function H(e,t){try{let n=await t({...Zt({call:da,account:T(e.account),refresh:E(e.refresh)}),progress:ca(!j(e))});j(e)?L(n.data):process.stdout.write(`${n.text}\n`)}catch(e){throw m(e)}}const ga=x({meta:{name:`report`,description:"Start here. No --site: last week across your audited sites (beta, after `seo login`). --site: overview and every section. Add --section for one"},args:{site:{type:`string`,description:"Site, URL or Search Console property. Leave it out for the summary of every audited site (beta, after `seo login`)."},section:{type:`string`,description:`Optional, needs --site. One of ${[...e,Xt,mn].join(`, `)}. issues keeps a list of what was found for the site, on this machine. ${mn} lays the latest Google ranking update (or the latest that started by --end-date) over the site.`},mark:{type:`string`,description:`With --site and --issues: ${yt.join(`, `)}. Records what the person decided; runs no checks.`},issues:{type:`string`,description:`With --mark: issue ids from --section issues, comma-separated.`},note:{type:`string`,description:`Optional, with --mark: why.`},...pa,...ma,...fa},run:async({args:t})=>{let n=T(t.section),r=[...e,Xt,mn];if(n&&!r.includes(n))throw new _(`INVALID_INPUT`,`--section is one of ${r.join(`, `)}.`);let i=T(t.site),a=T(t.mark),o=T(t.issues);if(a||o){if(a&&!yt.includes(a))throw new _(`INVALID_INPUT`,`--mark is one of ${yt.join(`, `)}.`);let e=await ha(t,M(i));await H(t,r=>Fn({site:e,section:n,mark:a,issues:o?.split(`,`),note:T(t.note)},r));return}if(!i&&!n&&ve()){await H(t,e=>ae(e));return}let s=n===`bing`?await ha(t,i).catch(()=>M(i)):await ha(t,i).catch(async e=>{if(n||!i)throw e;return await H(t,n=>Pt({site:M(i),startDate:T(t[`start-date`]),endDate:T(t[`end-date`])},n).catch(()=>{throw e})),null});s!==null&&await H(t,e=>Fn({site:s,section:n,startDate:T(t[`start-date`]),endDate:T(t[`end-date`]),detail:V(t),offset:O(t.offset)},e))}}),_a=x({meta:{name:`page`,description:`One URL: live page facts, Google index status and its queries`},args:{url:{type:`string`,description:`The page URL.`,required:!0},...pa,...ma,...fa},run:async({args:e})=>{let t=T(e.url)??``;if(!/^https?:\/\/\S+$/.test(t))throw new _(`INVALID_INPUT`,`--url must be a full http(s) URL.`);let n=await ha(e,t);await H(e,r=>ot({site:n,url:t,startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),detail:V(e),offset:O(e.offset)},r))}}),va=x({meta:{name:`compare`,description:`Equal periods before and after a date, with the pages and queries that moved`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},date:{type:`string`,description:`YYYY-MM-DD: the first day after the change.`,required:!0},pages:{type:`string`,description:`Optional URL text, such as /blog/.`},...fa},run:async({args:e})=>{let t=await ha(e,T(e.site));await H(e,n=>Cn({site:t,date:T(e.date)??``,pages:T(e.pages)},n))}}),ya=x({meta:{name:`index`,description:`Google indexing reasons for known URLs, checked live, and pages that lost most of their clicks`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},"max-urls":{type:`string`,description:`How many URLs to ask Google about, 100 by default. Ask for more when you want a fuller picture; it stops at the URL Inspection quota left today.`},...pa,...ma,...fa},run:async({args:e})=>{let t=await ha(e,T(e.site)),n=O(e[`max-urls`]);if(n!==void 0&&(!Number.isInteger(n)||n<1||n>2e3))throw new _(`INVALID_INPUT`,`--max-urls is a whole number from 1 to ${jn}.`);await H(e,r=>me({site:t,startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),detail:V(e),offset:O(e.offset),maxUrls:n},r))}}),ba=x({meta:{name:`data`,description:`Raw Search Console or Bing rows beside the previous period, or Clicky landing pages`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},source:{type:`string`,description:`search_console (default), bing or clicky. Bing takes the first dimension, query or page. Clicky takes the site or its Clicky site ID.`},dimensions:{type:`string`,description:`Comma-separated: ${dn.join(`, `)}. Default query.`},page:{type:`string`,description:`Optional: only rows for pages whose URL contains this.`},query:{type:`string`,description:`Optional: only rows for queries that contain this.`},...pa,...ma,...fa},run:async({args:e})=>{let t=A(e.dimensions)??[`query`],n=t.filter(e=>!dn.includes(e));if(n.length)throw new _(`INVALID_INPUT`,`Unknown dimensions: ${n.join(`, `)}. Use ${dn.join(`, `)}.`);let r=T(e.source)??`search_console`;if(![`search_console`,`bing`,`clicky`].includes(r))throw new _(`INVALID_INPUT`,`--source is search_console, bing or clicky.`);if(r===`clicky`){let t=M(T(e.site));await H(e,async()=>sn({site:t,startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),detail:V(e),offset:O(e.offset)},await en(),{connect:"save it at https://seoskill.dev/account#keys and run `seo login`, or run `seo analytics clicky connect` to keep it on this machine only.",refresh:ke,call:e=>da(`data`,{source:`clicky`,site:t,detail:`rows`,offset:e})}));return}if(r===`bing`){let n=M(T(e.site));await H(e,r=>zn({site:n,dimension:t[0]===`page`?`page`:`query`,startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),detail:V(e),offset:O(e.offset)},r));return}let i=await ha(e,T(e.site)),a=T(e.page),o=T(e.query);await H(e,n=>Kt({site:i,dimensions:t,filters:[...a?[{dimension:`page`,operator:`contains`,expression:a}]:[],...o?[{dimension:`query`,operator:`contains`,expression:o}]:[]],startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),detail:V(e),offset:O(e.offset)},n))}}),xa=x({meta:{name:`research`,description:`Keyword, SERP, competitor, backlink and AI answer data from your DataForSEO or Ahrefs key`},args:{action:{type:`positional`,required:!0,description:rt.join(`, `)},provider:{type:`string`,description:`${lt.join(`, `)}. Default: the saved key, DataForSEO when both are saved.`},scope:{type:`string`,description:`${Ht.join(`, `)}. Default: from the target. A domain is the whole site, a path ending in / is every URL under it (example.com/blog/), any other path is one page.`},keywords:{type:`string`,description:`Comma-separated keywords.`},tasks:{type:`string`,description:`ai_answers only: comma-separated tasks an earlier run returned as not ready.`},also:{type:`string`,description:`ai_answers only: the brand's other domains, comma-separated, such as claude.ai beside claude.com. A citation to any of them counts as citing the target.`},brand:{type:`string`,description:`ai_answers only: comma-separated brand names that count as a mention, such as Datadog for datadoghq.com. Default: each domain's name.`},target:{type:`string`,description:`Domain, subfolder ending in / or page URL.`},competitors:{type:`string`,description:`link_gap only: 2 to 5 comma-separated competitor domains.`},country:{type:`string`,description:`Two-letter country code. Default us.`},depth:{type:`string`,description:`serp only: results per keyword, 1 to 100. Default 20. Deeper costs more.`},...ma,account:fa.account,json:fa.json,refresh:{type:`boolean`,default:!1,description:`Ask the provider again instead of reading the result saved in the last day.`}},run:async({args:e})=>{let t=T(e.action);if(!rt.includes(t))throw new _(`INVALID_INPUT`,`The action is one of ${rt.join(`, `)}.`);let n=await en(),i=T(e.provider);if(i&&!lt.includes(i))throw new _(`INVALID_INPUT`,`--provider is one of ${lt.join(`, `)}.`);let a=T(e.scope);if(a&&!Ht.includes(a))throw new _(`INVALID_INPUT`,`--scope is one of ${Ht.join(`, `)}.`);let o=A(e.keywords)??[],s=T(e.target),c=A(e.competitors)??[],l=T(e.country);if(t===`ai_answers`){if(i===`ahrefs`)throw new _(`INVALID_INPUT`,`ai_answers uses dataforseo.`);let r=A(e.tasks)??[],a=A(e.also),c=A(e.brand),u=o.length||r.length?s??``:await ha(e,s);await H(e,i=>Sn({site:u,country:l??`us`,detail:V(e),offset:O(e.offset)??0,questions:o,tasks:r,also:a,brand:c,waitSeconds:240},n,i,(e,n)=>da(`research`,{action:t,target:s,also:a?.join(`,`),brand:c?.join(`,`),tasks:n.join(`,`)||void 0,country:l,detail:`rows`,offset:e}).replace(`--action `,``)))}else await H(e,()=>Fe({provider:i,scope:a,depth:O(e.depth),action:t,keywords:o,target:s,competitors:c,country:l,detail:V(e),offset:O(e.offset)},n,{store:r(E(e.refresh)),call:n=>da(`research`,{action:t,provider:i,scope:a,depth:O(e.depth),keywords:o.join(`,`)||void 0,target:s,competitors:c.join(`,`)||void 0,country:l,detail:`rows`,offset:n}).replace(`--action `,``)}))}}),Sa=x({meta:{name:`lint`,description:`Check copy for patterns common in AI-written text, weak copy and title and description length`},args:{paths:{type:`positional`,required:!1,description:`Files, folders or globs: .md, .mdx, .html, .astro or .txt. Up to 100 files.`},url:{type:`string`,description:`Instead of files: a live page. Checks its main content as Markdown (what seo page --detail full shows), with the blog preset unless you set one.`},only:{type:`string`,description:`Check only these categories, comma-separated: ${ht.join(`, `)}. ai is patterns common in AI-written text; copy is weak copy and house style such as dashes; seo is titles, descriptions and headings.`},preset:{type:`string`,description:`${Xn.join(`, `)}. Default blog for Markdown and text, landing for HTML and Astro. meta reads one title or description per line of a .txt file; start a line with "title:" or "description:" to say which.`},"meta-kind":{type:`string`,description:`With --preset meta: title or description, what a line with no "title:" or "description:" label is. Default: a line up to 70 characters is a title, a longer one a description.`},format:{type:`string`,description:`${Un.join(`, `)}. Default: from each file name.`},"fail-on":{type:`string`,description:`error (default) or warning: exit with code 1 when a finding at that level or above is found. A file or page that could not be checked in full also exits with code 1.`},ignore:{type:`string`,description:`Rule ids or review lenses to skip, comma-separated.`},"ignore-phrase":{type:`string`,description:`A phrase to allow, such as a product name a rule keeps matching. Repeat it for more.`},json:fa.json},run:async({args:e})=>{let t=T(e.preset);if(t&&!Xn.includes(t))throw new _(`INVALID_INPUT`,`--preset is one of ${Xn.join(`, `)}.`);let n=T(e[`meta-kind`]);if(n&&!Ct.includes(n))throw new _(`INVALID_INPUT`,`--meta-kind is ${Ct.join(` or `)}.`);let r=T(e.format);if(r&&!Un.includes(r))throw new _(`INVALID_INPUT`,`--format is one of ${Un.join(`, `)}.`);let i=T(e[`fail-on`])??`error`;if(i!==`error`&&i!==`warning`)throw new _(`INVALID_INPUT`,`--fail-on is error or warning.`);let a=(e._??[]).filter(e=>typeof e==`string`),o=T(e.url);if(!!o==a.length>0)throw new _(`INVALID_INPUT`,`Give files, folders or globs to check, or --url with a live page, but not both.`);let s=A(e.only);if(s?.filter(e=>!ht.includes(e))?.length)throw new _(`INVALID_INPUT`,`--only takes ${ht.join(`, `)}, comma-separated.`);let c=[].concat(e[`ignore-phrase`]??[]).filter(e=>typeof e==`string`);try{let{pageMarkdown:u}=Zt({call:da}),d=await On({paths:o?void 0:a,url:o,preset:t,format:r,ignoreRules:A(e.ignore),ignorePhrases:c,only:s,metaKind:n},e=>l(e),u&&(e=>u(e,2e5)));j(e)?L(d.data):process.stdout.write(`${d.text}\n`);let{errors:f,warnings:ee,skipped:te,partial:p}=d.data;(f>0||i===`warning`&&ee>0||te>0||p>0)&&(process.exitCode=1)}catch(e){throw m(e)}}});function Ca(e){return e===`keychain`?`system keychain`:e===`file`?`private local file`:e===`environment`?_t:e??`missing`}function wa(e){if(e&&Kn(e))return e.trim();throw new _(`INVALID_INPUT`,`No Clicky site given. Pass --site-id with the numeric Clicky site ID.`)}async function Ta(e,t){return f({siteId:e,sitekey:t}).catch(e=>{throw new _(e instanceof We&&e.code===`auth`?`AUTH_REQUIRED`:`PROVIDER_UNAVAILABLE`,e instanceof Error?e.message:String(e))})}const Ea={type:`boolean`,default:!1,description:`Print machine-readable JSON.`},Da={type:`string`,description:`Numeric Clicky site ID.`},Oa=x({meta:{name:`connect`,description:`Check and save a Clicky site on this machine`},args:{"site-id":Da,json:Ea},run:async({args:e})=>{let t=j(e),n=I({json:t});n&&Br(`Connect Clicky`);let r=wa(T(e[`site-id`])??(n?B(await Kr({message:`Clicky site ID`,validate:e=>Kn(e??``)?void 0:`Enter the numeric site ID from Clicky`})):void 0)),i=process.env.SEO_CLICKY_SITEKEY?.trim()||(n?B(await Wr({message:`Clicky sitekey`,validate:e=>qe(e??``)?void 0:`Enter the sitekey from Clicky (Preferences, Info)`})):void 0);if(!i)throw new _(`AUTH_REQUIRED`,`Run this command in a terminal or set ${_t}.`);let a=await Ta(r,i.trim()),o=await an(r,i.trim()),s={siteId:r,domain:a,connected:!0,credentialSource:o};if(t){L(s);return}let c=`Clicky site ${r}${a?` (${a})`:``} saved in the ${Ca(o)}. Next: seo analytics clicky report --site ${r}`;n?C(c):process.stdout.write(`${c}\n`)}}),ka=x({meta:{name:`status`,description:`Show a Clicky site saved on this machine`},args:{"site-id":Da,check:{type:`boolean`,default:!1,description:`Check the saved sitekey with Clicky.`},json:Ea},run:async({args:e})=>{let t=wa(T(e[`site-id`])),n=await Tt(t),r=E(e.check);r&&n&&await Ta(t,n.siteKey);let i={siteId:t,connected:!!n,credentialSource:n?.source,liveCheck:r?n?`passed`:`unavailable`:`not-requested`};j(e)?L(i):R([[`Site ID`,t],[`Connected`,i.connected?`yes`:`no`],[`Credential`,Ca(i.credentialSource)],[`Live check`,i.liveCheck]])}}),Aa=x({meta:{name:`report`,description:`Clicky landing pages, traffic sources and search engines`},args:{site:{type:`string`,description:`The site, or its numeric Clicky site ID.`},...pa,...ma,json:Ea},run:async({args:e})=>{let t=M(T(e.site));await H(e,async()=>sn({site:t,startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),detail:V(e),offset:O(e.offset)},await en(),{connect:"save it at https://seoskill.dev/account#keys and run `seo login`, or run `seo analytics clicky connect` to keep it on this machine only.",refresh:ke,call:e=>`seo analytics clicky report --site ${t} --detail rows --offset ${e}`}))}}),ja=x({meta:{name:`disconnect`,description:`Remove a Clicky site saved on this machine`},args:{"site-id":Da,json:Ea},run:async({args:e})=>{let t=wa(T(e[`site-id`]));await gn(t);let n=!!process.env[_t],r={siteId:t,savedCredentialRemoved:!0,environmentCredential:n?`active`:`missing`};j(e)?L(r):process.stdout.write(n?`Saved sitekey removed. ${_t} is still active.\n`:`Clicky is disconnected for this site.
+`)}}),Ma=x({meta:{name:`clicky`,description:`Read Clicky, or save a Clicky site on this machine only`},subCommands:{connect:Oa,status:ka,report:Aa,disconnect:ja}}),Na=x({meta:{name:`properties`,description:`List Google Analytics accounts and properties`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},account:{type:`string`,description:`Saved Google account email.`}},run:async({args:e})=>{let t=await tn(T(e.account)),n=t.flatMap(e=>e.propertySummaries.map(t=>({account:e.displayName??e.account,property:Ae(t.property),displayName:t.displayName??t.property})));j(e)?L({accountSummaries:t,properties:n}):z([`Property`,`Name`,`Account`],n.map(e=>[e.property,e.displayName,e.account]))}}),Pa=x({meta:{name:`report`,description:`Google Analytics landing pages for visits from search`},args:{property:{type:`string`,description:"Numeric Google Analytics property ID. Run `seo analytics google properties` to list them."},...pa,...ma,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=_i(T(e.property));await H(e,async()=>Rt({property:t,startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),detail:V(e),offset:O(e.offset)},await jt(await Ge(),t,we.signIn),{signIn:we.signIn,call:e=>`seo analytics google report --property ${t} --detail rows --offset ${e}`}))}}),Fa=x({meta:{name:`google`,description:`Read Google Analytics properties and reports`},subCommands:{properties:Na,report:Pa}}),Ia=x({meta:{name:`analytics`,description:`Read analytics data from connected providers`},subCommands:{clicky:Ma,google:Fa}});function La(){return`Your browser will open. Choose your Google account and select all permission boxes for read-only access. Keep this terminal open and finish the browser steps within five minutes.`}async function Ra(){return S(La(),`Google sign-in`),De()}function za(e){return e?e===`environment-json`?`SEO_GOOGLE_SERVICE_ACCOUNT_JSON`:e===`environment-file`?`SEO_GOOGLE_SERVICE_ACCOUNT_FILE`:`GOOGLE_APPLICATION_CREDENTIALS`:`invalid or conflicting configuration`}function Ba(e){return e.active===`keychain`?`system keychain`:e.configured===`keychain`?`private file fallback`:`private file`}function Va(e){return e===`shared`?`SEO Skill app`:`Local OAuth config`}function Ha(e){let t=[[`Account`,e.accountEmail]],n=new Set(e.scope.split(/\s+/u).filter(Boolean));return n.has(`https://www.googleapis.com/auth/webmasters.readonly`)?t.push([`Search Console`,`Read only`]):t.push([`Search Console`,`Not granted`]),n.has(`https://www.googleapis.com/auth/analytics.readonly`)?t.push([`Google Analytics`,`Read only`]):t.push([`Google Analytics`,`Not granted`]),t.push([`OAuth app`,Va(e.clientSource)],[`Expires`,ci(e.expiresAt)]),t}const Ua=x({meta:{name:`auth`,description:`Authentication commands`},subCommands:{login:x({meta:{name:`login`,description:`Run Google OAuth flow`},run:async()=>{if((await Ne()).activeMode===`service-account`)throw new _(`AUTH_CONFIG_REQUIRED`,`A service account is active from the environment. Unset its credential variable before running browser OAuth.`);let e=await Ra();R(Ha({accountEmail:e.account_email,clientSource:e.client_source,expiresAt:e.expires_at,scope:e.scope}))}}),logout:x({meta:{name:`logout`,description:`Delete a local Google login`},args:{account:{type:`string`,description:`Delete the login for this Google account.`},all:{type:`boolean`,default:!1,description:`Delete every saved Google login.`}},run:async({args:e})=>{let t=await Ne(),n=T(e.account);if(n&&e.all)throw new _(`INVALID_INPUT`,`Use either --account or --all, not both.`);let r=e.all?void 0:n??t.accounts.find(e=>e.active)?.accountEmail;await fe(r),t.activeMode===`service-account`?process.stdout.write(`${e.all?`Deleted all local Google logins.`:r?`Deleted the local login for ${r}.`:`No local Google login was found.`} Service account credentials remain available through the environment.\n`):process.stdout.write(`${e.all?`Deleted all local Google logins.`:r?`Deleted the local login for ${r}.`:`No local Google login was found.`}\nRevoke at https://myaccount.google.com/permissions if you also want Google to forget the grant.\n`)}}),whoami:x({meta:{name:`whoami`,description:`Show the signed-in Google account`},args:{account:{type:`string`,description:`Show this saved Google account.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Ne();if(t.activeMode===`service-account`){let n={mode:`service-account`,account:t.identity??null,source:za(t.serviceAccount.source)};if(j(e)){L(n);return}R([[`Account type`,`Service account`],[`Account`,t.identity??`Invalid configuration`],[`Credentials`,n.source],[`Access`,`Search Console and Google Analytics, read only`]]);return}let n=T(e.account),r=n?await s(n):t.tokens;if(n&&!r)throw new _(`AUTH_REQUIRED`,`Google account ${n} is not connected.`);if(r)j(e)?L({mode:`oauth`,account:r.account_email,scopes:r.scope.split(/\s+/u).filter(Boolean),clientSource:r.client_source,expiresAt:r.expires_at}):R(Ha({accountEmail:r.account_email,clientSource:r.client_source,expiresAt:r.expires_at,scope:r.scope}));else{if(j(e)){L({mode:`oauth`,account:null});return}process.stdout.write(`Not logged in.
+`)}}}),status:x({meta:{name:`status`,description:`Show local Google auth status`},args:{account:{type:`string`,description:`Show status for this saved Google account.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Ne(),n=T(e.account),r=n?await s(n):t.tokens;if(n&&!r&&t.activeMode!==`service-account`)throw new _(`AUTH_REQUIRED`,`Google account ${n} is not connected.`);let i=t.activeMode===`oauth`?await ze():void 0;if(j(e)){L({authenticated:t.activeMode===`oauth`?!!r:t.serviceAccount.configured,mode:t.activeMode,identity:t.identity,account:t.activeMode===`oauth`?r?.account_email:void 0,scopes:t.activeMode===`oauth`?r?.scope:void 0,clientSource:t.activeMode===`oauth`?r?.client_source:void 0,expiresAt:t.activeMode===`oauth`?r?.expires_at:void 0,sharedConfigured:t.sharedConfigured,byoConfigured:t.byoConfigured,serviceAccount:{configured:t.serviceAccount.configured,identity:t.serviceAccount.identity,source:t.serviceAccount.source,error:t.serviceAccount.error},accounts:t.accounts,...i?{tokenStorage:i}:{}});return}if(t.activeMode===`service-account`){let e=[[`Mode`,`service account`],[`Identity`,t.identity??`unavailable`],[`Source`,za(t.serviceAccount.source)],[`Scopes`,`Search Console readonly, Google Analytics readonly`],[`Storage`,`credentials stay in the environment`]];t.serviceAccount.error&&e.push([`Status`,t.serviceAccount.error]),R(e);return}if(!r){let e=t.serviceAccount.error?t.serviceAccount.error:t.sharedConfigured?`Shared seo app available`:t.byoConfigured?`Local OAuth config available`:`No OAuth client configured`;process.stdout.write(`Not logged in. ${e}. Run \`seo auth login\` to connect Google.\n`);return}let a=i??await ze();R([[`Account`,r.account_email],[`Connected accounts`,String(t.accounts.length)],[`Scopes`,r.scope],[`Client`,Va(r.client_source)],[`Expires`,ci(r.expires_at)],[`Tokens file`,xn().tokensFile],[`Token storage`,Ba(a)],...a.reason?[[`Storage note`,a.reason]]:[],[`OAuth mode`,t.sharedConfigured?`SEO Skill app available`:t.byoConfigured?`Local OAuth config available`:`missing`],[`Revoke at`,`https://myaccount.google.com/permissions`]])}}),storage:x({meta:{name:`storage`,description:`Show or change local OAuth token storage`},args:{keychain:{type:`boolean`,default:!1,description:`Store OAuth tokens in the system keychain when available.`},file:{type:`boolean`,default:!1,description:`Store OAuth tokens in the private local file.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(e.keychain&&e.file)throw new _(`INVALID_INPUT`,`Choose either --keychain or --file, not both.`);let t=e.keychain||e.file?await le(e.keychain?`keychain`:`file`):await ze();j(e)?L(t):R([[`Configured storage`,t.configured],[`Active storage`,Ba(t)],...t.reason?[[`Note`,t.reason]]:[]])}}),refresh:x({meta:{name:`refresh`,description:`Refresh the Google OAuth token`},args:{account:{type:`string`,description:`Refresh this saved Google account.`}},run:async({args:e})=>{if((await Ne()).activeMode===`service-account`){process.stdout.write(`Service accounts request short-lived Google tokens automatically. No local refresh token is stored.
+`);return}let t=await re(T(e.account));process.stdout.write(`Refreshed. New expiry ${new Date(t.expires_at).toISOString()}.\n`)}}),accounts:x({meta:{name:`accounts`,description:`List saved Google accounts`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=er();j(e)?L({accounts:t}):t.length===0?process.stdout.write(`No Google accounts are connected.
+`):R(t.map(e=>[e.active?`Active account`:`Account`,e.accountEmail]))}}),use:x({meta:{name:`use`,description:`Select the default Google account`},args:{account:{type:`positional`,required:!0,description:`Saved Google account email.`}},run:({args:e})=>{let t=T(e.account);if(!t)throw new _(`INVALID_INPUT`,`Google account is required.`);Qe(t),process.stdout.write(`Default Google account: ${t}\n`)}}),"setup-client":x({meta:{name:`setup-client`,description:`Save your own Google Desktop OAuth client`},args:{json:{type:`boolean`,default:!1,description:`Return a structured error instead of prompting.`}},run:async({args:e})=>{if(!I({json:j(e)}))throw new _(`INVALID_INPUT`,"`seo auth setup-client` needs an interactive terminal. Run it without --json, or set SEO_GOOGLE_CLIENT_ID and SEO_GOOGLE_CLIENT_SECRET.");Br(`Local Google OAuth client`),S(`This is the advanced path.
 Most users should use the shared seo Google app.
-Your actual sensitive data is the local refresh token, not the desktop app client secret.`,`Advanced`);let t=B(await Fr({message:`Google Desktop OAuth client ID`,validate:e=>e?void 0:`Client ID is required`})),n=B(await Nr({message:`Google Desktop OAuth client secret`,validate:e=>e?void 0:`Client secret is required`}));qt({clientId:t,clientSecret:n}),x(`Saved local OAuth config to ${En().oauthClientFile}`)}})}}),Aa=[`gsc`,`google-analytics`,`dataforseo`,`ahrefs`,`clicky`,`http`];function ja(e){if(e!==void 0){if(typeof e==`string`&&Aa.includes(e))return e;throw new h(`INVALID_INPUT`,`--provider must be one of: ${Aa.join(`, `)}.`)}}const Ma=y({meta:{name:`cache`,description:`Cache helpers`},subCommands:{stats:y({meta:{name:`stats`,description:`Show local cache size and row counts`},run:async()=>{let e=Hn();I([[`DB`,e.dbPath],[`Size`,Ji(e.sizeBytes)],[`Cached data`,`${Ji(e.logicalSizeBytes)} of ${Ji(e.maxSizeBytes)} automatic limit`],[`Sites`,String(e.counts.sites??0)],[`Search Console`,String(e.counts.gsc_cache??0)],[`URL Inspection`,String(e.counts.url_inspection_cache??0)],[`Google Analytics`,String(e.counts.google_analytics_cache??0)],[`DataForSEO`,String(e.counts.provider_cache??0)],[`Ahrefs`,String(e.counts.ahrefs_cache??0)],[`Clicky`,String(e.counts.clicky_cache??0)],[`HTTP`,String(e.counts.http_cache??0)]])}}),clear:y({meta:{name:`clear`,description:`Clear cached API and HTTP data`},args:{provider:{type:`string`,description:`Optional cache provider: gsc, google-analytics, dataforseo, ahrefs, clicky, or http`}},run:async({args:e})=>{let t=Nn(ja(e.provider));process.stdout.write(`Removed ${t} cached rows.\n`)}})}});function U(e){return Math.round(e).toLocaleString(`en-GB`)}function Na(e){return e.toFixed(1)}function W(e){return`${(e*100).toFixed(1)}%`}function G(e,t=72){return di(e,t)}function Pa(e){return e.verification?.requested?`${e.verification.verified} checked, ${e.verification.failed} failed`:`off`}function Fa(e){return{title:e.title,target:e.target,status:e.status,summary:e.summary,metrics:e.metrics,sections:(e.diagnostics??[]).map(e=>({title:e.title,diagnostics:e.items})),notes:e.notes}}function K(e){Ui(Fa(e))}function q(e,t){L(e,t.slice(0,25)),t.length>25&&process.stdout.write(`Showing 25 of ${t.length}. Use --json for full data.\n`)}function J(e,t,n=5){let r=t.filter(e=>e.action.trim().length>0).slice(0,n),i=Ia(e,r);i&&(process.stdout.write(`
-`),Ui(i),t.length>r.length&&process.stdout.write(`Showing ${r.length} of ${t.length}. Use --json for full data.\n`))}function Ia(e,t){if(t.length)return{title:e,status:`info`,summary:`${t.length} ${t.length===1?`action`:`actions`} shown.`,sections:[{title:`Actions`,diagnostics:t.map(e=>({status:`info`,title:e.label,explanation:e.context??`Review the evidence before making changes.`,fix:e.action}))}]}}function La(e){process.stdout.write(`\nNext: ${e}\n`)}function Y(e,t){let n=t.filter(e=>e.trim().length>0);if(n.length){process.stdout.write(`\n${e}\n`);for(let e of n)process.stdout.write(`- ${e}\n`)}}const Ra=y({meta:{name:`content`,description:`Optimize page content from real GSC queries`},subCommands:{optimize:y({meta:{name:`optimize`,description:`Build a content optimization report for one URL`},args:{site:{type:`string`},url:{type:`string`,required:!0},days:{type:`string`,description:`GSC lookback days. Defaults to 28.`},limit:{type:`string`,description:`Maximum GSC queries to inspect. Defaults to 25.`},"min-impressions":{type:`string`,description:`Minimum query impressions. Defaults to 10.`},"include-brand":{type:`boolean`,default:!1,description:`Include branded queries.`},"verify-content":Qr(`Fetch the page for content checks. Defaults to true.`,`Skip fetching the page for content checks.`),js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for page extraction.`},refresh:{type:`boolean`,default:!1,description:`Bypass local GSC and HTTP cache.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=k(e),n=A(C(e.site)),r=await $t({site:n,url:C(e.url)??``,days:E(e.days),limit:E(e.limit),minImpressions:E(e[`min-impressions`]),includeBrand:w(e[`include-brand`]),verifyContent:w(e[`verify-content`])!==!1,js:w(e.js)?!0:`auto`,refresh:w(e.refresh)});t?F(r):(K({title:`Content optimization`,target:r.url,status:`info`,summary:r.summary.verdict,metrics:[{label:`Score`,value:`${r.summary.score}/100`},{label:`Primary intent`,value:r.summary.primaryIntent},{label:`Primary query`,value:r.summary.primaryQuery??`None`},{label:`Queries`,value:U(r.summary.queries)},{label:`Opportunities`,value:U(r.summary.opportunities)},{label:`Estimated lift`,value:U(r.summary.estimatedClickLift)}]}),J(`Top actions`,r.topActions.map(e=>({label:e.title,action:e.action,context:e.plainEnglish}))),r.brief.sections.length&&(process.stdout.write(`
+Your actual sensitive data is the local refresh token, not the desktop app client secret.`,`Advanced`);let t=B(await Kr({message:`Google Desktop OAuth client ID`,validate:e=>e?void 0:`Client ID is required`})),n=B(await Wr({message:`Google Desktop OAuth client secret`,validate:e=>e?void 0:`Client secret is required`}));Ye({clientId:t,clientSecret:n}),C(`Saved local OAuth config to ${xn().oauthClientFile}`)}})}}),Wa=[`gsc`,`google-analytics`,`dataforseo`,`ahrefs`,`clicky`,`http`];function Ga(e){if(e!==void 0){if(typeof e==`string`&&Wa.includes(e))return e;throw new _(`INVALID_INPUT`,`--provider must be one of: ${Wa.join(`, `)}.`)}}const Ka=x({meta:{name:`cache`,description:`Cache helpers`},subCommands:{stats:x({meta:{name:`stats`,description:`Show local cache size and row counts`},run:async()=>{let e=Qt();R([[`DB`,e.dbPath],[`Size`,sa(e.sizeBytes)],[`Cached data`,`${sa(e.logicalSizeBytes)} of ${sa(e.maxSizeBytes)} automatic limit`],[`Sites`,String(e.counts.sites??0)],[`Search Console`,String(e.counts.gsc_cache??0)],[`URL Inspection`,String(e.counts.url_inspection_cache??0)],[`Google Analytics`,String(e.counts.google_analytics_cache??0)],[`DataForSEO`,String(e.counts.provider_cache??0)],[`Ahrefs`,String(e.counts.ahrefs_cache??0)],[`Clicky`,String(e.counts.clicky_cache??0)],[`HTTP`,String(e.counts.http_cache??0)]])}}),clear:x({meta:{name:`clear`,description:`Clear cached API and HTTP data`},args:{provider:{type:`string`,description:`Optional cache provider: gsc, google-analytics, dataforseo, ahrefs, clicky, or http`}},run:async({args:e})=>{let t=i(Ga(e.provider));process.stdout.write(`Removed ${t} cached rows.\n`)}})}});function U(e){return Math.round(e).toLocaleString(`en-GB`)}function qa(e){return e.toFixed(1)}function W(e){return`${(e*100).toFixed(1)}%`}function G(e,t=72){return Si(e,t)}function Ja(e){return e.verification?.requested?`${e.verification.verified} checked, ${e.verification.failed} failed`:`off`}function Ya(e){return{title:e.title,target:e.target,status:e.status,summary:e.summary,metrics:e.metrics,sections:(e.diagnostics??[]).map(e=>({title:e.title,diagnostics:e.items})),notes:e.notes}}function K(e){ta(Ya(e))}function q(e,t){z(e,t.slice(0,25)),t.length>25&&process.stdout.write(`Showing 25 of ${t.length}. Use --json for full data.\n`)}function J(e,t,n=5){let r=t.filter(e=>e.action.trim().length>0).slice(0,n),i=Xa(e,r);i&&(process.stdout.write(`
+`),ta(i),t.length>r.length&&process.stdout.write(`Showing ${r.length} of ${t.length}. Use --json for full data.\n`))}function Xa(e,t){if(t.length)return{title:e,status:`info`,summary:`${t.length} ${t.length===1?`action`:`actions`} shown.`,sections:[{title:`Actions`,diagnostics:t.map(e=>({status:`info`,title:e.label,explanation:e.context??`Review the evidence before making changes.`,fix:e.action}))}]}}function Za(e){process.stdout.write(`\nNext: ${e}\n`)}function Y(e,t){let n=t.filter(e=>e.trim().length>0);if(n.length){process.stdout.write(`\n${e}\n`);for(let e of n)process.stdout.write(`- ${e}\n`)}}const Qa=x({meta:{name:`content`,description:`Optimize page content from real GSC queries`},subCommands:{optimize:x({meta:{name:`optimize`,description:`Build a content optimization report for one URL`},args:{site:{type:`string`},url:{type:`string`,required:!0},days:{type:`string`,description:`GSC lookback days. Defaults to 28.`},limit:{type:`string`,description:`Maximum GSC queries to inspect. Defaults to 25.`},"min-impressions":{type:`string`,description:`Minimum query impressions. Defaults to 10.`},"include-brand":{type:`boolean`,default:!1,description:`Include branded queries.`},"verify-content":li(`Fetch the page for content checks. Defaults to true.`,`Skip fetching the page for content checks.`),js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for page extraction.`},refresh:{type:`boolean`,default:!1,description:`Bypass local GSC and HTTP cache.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=j(e),n=M(T(e.site)),r=await Jn({site:n,url:T(e.url)??``,days:O(e.days),limit:O(e.limit),minImpressions:O(e[`min-impressions`]),includeBrand:E(e[`include-brand`]),verifyContent:E(e[`verify-content`])!==!1,js:E(e.js)?!0:`auto`,refresh:E(e.refresh)});t?L(r):(K({title:`Content optimization`,target:r.url,status:`info`,summary:r.summary.verdict,metrics:[{label:`Score`,value:`${r.summary.score}/100`},{label:`Primary intent`,value:r.summary.primaryIntent},{label:`Primary query`,value:r.summary.primaryQuery??`None`},{label:`Queries`,value:U(r.summary.queries)},{label:`Opportunities`,value:U(r.summary.opportunities)},{label:`Estimated lift`,value:U(r.summary.estimatedClickLift)}]}),J(`Top actions`,r.topActions.map(e=>({label:e.title,action:e.action,context:e.plainEnglish}))),r.brief.sections.length&&(process.stdout.write(`
 Suggested sections
 `),q([`Heading`,`Queries`],r.brief.sections.map(e=>[G(e.heading,48),G(e.queries.join(`, `),80)]))),r.intentMix.length&&(process.stdout.write(`
 Intent mix
-`),q([`Intent`,`Queries`,`Impressions`,`Clicks`],r.intentMix.map(e=>[e.intent,U(e.queries),U(e.impressions),U(e.clicks)]))),Y(`Caveats`,r.caveats))}})}});var za=class{stream;buffer=``;constructor(e){this.stream=e}async write(e){this.buffer+=e,this.buffer.length>=65536&&await this.flush()}async flush(){if(!this.buffer)return;let e=this.buffer;this.buffer=``,this.stream.write(e)||await new Promise((e,t)=>{let n=()=>{i(),e()},r=e=>{i(),t(e)},i=()=>{this.stream.off(`drain`,n),this.stream.off(`error`,r)};this.stream.once(`drain`,n),this.stream.once(`error`,r)})}};function Ba(e){return`  `.repeat(e)}function Va(e){return e&&typeof e==`object`&&`toJSON`in e&&typeof e.toJSON==`function`?e.toJSON():e}async function Ha(e,t,n,r,i=!1){let a=Va(t);if(a===null)return await e.write(`null`),!0;if(typeof a==`string`||typeof a==`boolean`)return await e.write(JSON.stringify(a)),!0;if(typeof a==`number`)return await e.write(Number.isFinite(a)?String(a):`null`),!0;if(typeof a==`bigint`&&JSON.stringify(a),a===void 0||typeof a==`function`||typeof a==`symbol`)return i&&await e.write(`null`),i;if(!a||typeof a!=`object`)return!1;if(r.has(a))throw TypeError(`Converting circular structure to JSON`);r.add(a);try{if(Array.isArray(a)){if(a.length===0)return await e.write(`[]`),!0;await e.write(`[
+`),q([`Intent`,`Queries`,`Impressions`,`Clicks`],r.intentMix.map(e=>[e.intent,U(e.queries),U(e.impressions),U(e.clicks)]))),Y(`Caveats`,r.caveats))}})}});var $a=class{stream;buffer=``;constructor(e){this.stream=e}async write(e){this.buffer+=e,this.buffer.length>=65536&&await this.flush()}async flush(){if(!this.buffer)return;let e=this.buffer;this.buffer=``,this.stream.write(e)||await new Promise((e,t)=>{let n=()=>{i(),e()},r=e=>{i(),t(e)},i=()=>{this.stream.off(`drain`,n),this.stream.off(`error`,r)};this.stream.once(`drain`,n),this.stream.once(`error`,r)})}};function eo(e){return`  `.repeat(e)}function to(e){return e&&typeof e==`object`&&`toJSON`in e&&typeof e.toJSON==`function`?e.toJSON():e}async function no(e,t,n,r,i=!1){let a=to(t);if(a===null)return await e.write(`null`),!0;if(typeof a==`string`||typeof a==`boolean`)return await e.write(JSON.stringify(a)),!0;if(typeof a==`number`)return await e.write(Number.isFinite(a)?String(a):`null`),!0;if(typeof a==`bigint`&&JSON.stringify(a),a===void 0||typeof a==`function`||typeof a==`symbol`)return i&&await e.write(`null`),i;if(!a||typeof a!=`object`)return!1;if(r.has(a))throw TypeError(`Converting circular structure to JSON`);r.add(a);try{if(Array.isArray(a)){if(a.length===0)return await e.write(`[]`),!0;await e.write(`[
 `);for(let t=0;t<a.length;t+=1)t>0&&await e.write(`,
-`),await e.write(Ba(n+1)),await Ha(e,a[t],n+1,r,!0);return await e.write(`\n${Ba(n)}]`),!0}let t=Object.entries(a).filter(([,e])=>{let t=Va(e);return![`undefined`,`function`,`symbol`].includes(typeof t)});if(t.length===0)return await e.write(`{}`),!0;await e.write(`{
+`),await e.write(eo(n+1)),await no(e,a[t],n+1,r,!0);return await e.write(`\n${eo(n)}]`),!0}let t=Object.entries(a).filter(([,e])=>{let t=to(e);return![`undefined`,`function`,`symbol`].includes(typeof t)});if(t.length===0)return await e.write(`{}`),!0;await e.write(`{
 `);for(let i=0;i<t.length;i+=1){let[a,o]=t[i];i>0&&await e.write(`,
-`),await e.write(`${Ba(n+1)}${JSON.stringify(a)}: `),await Ha(e,o,n+1,r)}return await e.write(`\n${Ba(n)}}`),!0}finally{r.delete(a)}}async function Ua(e,t){let n=new za(e);await Ha(n,t,0,/* @__PURE__ */ new Set)||await n.write(`undefined`),await n.write(`
-`),await n.flush()}async function Wa(e,t){if(!e){await Ua(process.stdout,t);return}await _r(Qn(e),{recursive:!0});let n=or(e);try{await Ua(n,t),n.end(),await zr(n)}catch(e){throw n.destroy(),e}process.stdout.write(`Wrote ${e}\n`)}function Ga(e){return e.length?e.join(`, `):`none`}function Ka(e,t){let n=e.robotsTxt,r=(n?.botAccess??[]).filter(e=>e.purpose===t),i=t===`search`?`AI search bots`:`AI training bots`;if(!n||r.some(e=>e.allowed===null))return{status:`unknown`,title:`${i}: unknown`,explanation:`robots.txt could not be read (${n?.availability??`not checked`}).`};let a=r.filter(e=>e.allowed===!1);return{status:a.length?t===`search`?`warning`:`info`:`pass`,title:a.length?`${i}: ${a.length} of ${r.length} blocked`:`${i}: all ${r.length} allowed`,explanation:a.length?`Blocked: ${Ga(a.map(e=>e.userAgent))}.`:`Checked: ${Ga(r.map(e=>e.userAgent))}.`}}function qa(e){let t=e.markdownNegotiation,n=e.markdownCopies,r=t?.markdown?`Accept: text/markdown returns Markdown${t.varyAccept?` with Vary: Accept`:` without Vary: Accept`}.`:t?.availability===`available`?`Accept: text/markdown returns ${t.contentType||`no content type`}.`:`Accept: text/markdown could not be checked (${t?.availability??`not checked`}).`,i=n?` ${n.publicPagesWithLink} of ${n.publicPages} public pages link to a Markdown copy${n.privatePagesWithLink?`, and ${n.privatePagesWithLink} signed-in pages do`:``}. ${n.checked} copies checked, ${n.broken.length} broken.${n.largest?` Largest checked copy: about ${n.largest.estimatedTokens} tokens.`:``}`:``;return{status:t?.markdown||n?.publicPagesWithLink?n?.broken.length||n?.privatePagesWithLink?`warning`:`pass`:t?.availability===`available`?`info`:`unknown`,title:`Markdown copies`,explanation:`${r}${i}`}}function Ja(e){let t=e.llmsTxt;if(!t||t.availability===void 0)return{status:`unknown`,title:`llms.txt`,explanation:`Not checked.`};if(t.availability!==`available`)return{status:t.availability===`absent`?`info`:`unknown`,title:`llms.txt`,explanation:t.availability===`absent`?`Not found (HTTP ${t.status??`none`}).`:`Could not be read (${t.availability}).`};let n=t.links;return{status:n?.broken.length?`warning`:`pass`,title:`llms.txt`,explanation:n?`${n.found} same-site links; ${n.checked} checked, ${n.broken.length} broken.`:`Present.`}}function Ya(e){if(!e)return[];let t=(e.agentResources??[]).filter(e=>e.exists).map(e=>new URL(e.url).pathname),n=[...e.robotsTxt?.contentSignals??[],...e.startPageHeaders?.contentSignal?[e.startPageHeaders.contentSignal]:[]];return[Ka(e,`search`),Ka(e,`training`),qa(e),Ja(e),{status:`info`,title:`Agent files`,explanation:`Found: ${Ga(t)}.`},{status:`info`,title:`Content-Signal and Link header`,explanation:`Content-Signal: ${Ga([...new Set(n)])}. Link header relations on the start page: ${Ga(e.startPageHeaders?.linkRelations??[])}.`}]}function Xa(e){return e===`high`?`fail`:`warning`}function Za(e,t=un(e)){let n=gt(e),r=e.status===`failed`||e.summary.highIssues>0?`fail`:e.status===`partial`?`unknown`:e.summary.mediumIssues>0||e.summary.lowIssues>0?`warning`:`pass`,i=e.access.samples.slice(0,5).map(e=>({status:`fail`,title:e.evidence.guidance.summary,explanation:`${e.evidence.provider} returned ${e.evidence.kind} evidence for the crawler request.`,evidence:[e.url],fix:e.evidence.guidance.recommendedAction})),a=t.slice(0,10).map(e=>({status:Xa(e.severity),title:`${e.title} on ${e.count} ${e.count===1?`URL`:`URLs`}`,explanation:An(e.ruleId)?.whyItMatters??e.whyThisRanks,evidence:e.sampleUrls.slice(0,5),fix:e.howToFix})),o=n.slice(0,10).map(e=>({status:`warning`,title:`${e.title} on ${e.count} ${e.count===1?`URL`:`URLs`}`,explanation:An(e.ruleId)?.whyItMatters??e.whyThisRanks,evidence:e.sampleUrls.slice(0,5),fix:e.howToFix}));Ui({title:e.config.strategy===`health`?`Sitemap health pass`:`Site crawl`,target:e.config.url,status:r,summary:Re(e)??(e.status===`partial`?`Partial evidence from ${e.summary.totalPages} retained pages. Review the caveats before treating missing findings as an all-clear.`:`${e.summary.totalPages} pages retained with ${e.issues.length} findings.`),metrics:[{label:`Pages`,value:e.summary.totalPages},{label:`High`,value:e.summary.highIssues,status:`fail`},{label:`Medium`,value:e.summary.mediumIssues,status:`warning`},{label:`Low`,value:e.summary.lowIssues,status:`info`},{label:`Failed fetches`,value:e.summary.failedUrls}],sections:[{title:`Access diagnostics`,diagnostics:i},{title:`Prioritised fixes`,diagnostics:a},{title:`Review before changing anything`,diagnostics:o},{title:`Agent access`,diagnostics:Ya(e.ai)},...!i.length&&!a.length&&!o.length?[{title:`Checks`,diagnostics:[{status:`pass`,title:`No prioritised findings were observed`,explanation:`The evaluated crawl evidence did not produce a prioritised fix or review item.`}]}]:[]],notes:[`Strategy: ${e.config.strategy}. Data: ${e.status}. Report: ${e.id}.`,...e.warnings,...e.caveats]})}const Qa={"google-analytics-property":{type:`string`,description:`Google Analytics property ID for landing-page sessions.`},"clicky-site-id":{type:`string`,description:`Clicky site ID for landing-page visits.`}};function $a(e){let t=C(e[`google-analytics-property`]),n=C(e[`clicky-site-id`]);if(t&&n)throw new h(`INVALID_INPUT`,`Pass either --google-analytics-property or --clicky-site-id, not both.`);if(t)return{provider:`google`,propertyId:t};if(n)return{provider:`clicky`,siteId:ct(n)}}function eo(e){let t=e.trim();if(/^https?:\/\//i.test(t))return t;if(t.startsWith(`sc-domain:`))return`https://${t.slice(10)}/`;if(/^[a-z0-9-]+(\.[a-z0-9-]+)+(:\d+)?(\/\S*)?$/i.test(t))return`https://${t.includes(`/`)?t:`${t}/`}`}function to(e){return e?e.backpressure?.status===`stopped`?`stopped: ${e.backpressure.reason??`origin cooldown`}`:e.backpressure?.status===`slowed`?`slowed ${e.backpressure.delayMs}ms`:e.rendering?.status===`unavailable`?`raw HTML; rendering unavailable`:e.rendering?.status===`failed`?`raw HTML; rendering failed`:e.blocked?`blocked`:e.rendered?`rendered`:e.cache===`hit`?`cached`:e.fetched?`fetched`:e.source:`-`}function no(e){return e?e===`serp-framing`?`wording gap`:e===`content-gap`?`content gap`:e===`technical-check`?`technical check`:`covered`:`-`}const ro={high:3,medium:2,low:1},io=y({meta:{name:`crawl`,description:`Run a fast sitemap health pass or a full technical crawl`},args:{crawlUrl:{type:`positional`,required:!1,description:`Site start URL. Optional with --sitemap-url.`},url:{type:`string`,description:`Start URL to crawl. Defaults to the --site home page.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},...Qa,mode:{type:`string`,description:`Crawl mode: site, page, list, or sitemap. Start with sitemap --health for large sites.`},health:{type:`boolean`,default:!1,description:`Run the uncached sitemap status and redirect pass before a full audit. No page-body analysis.`},"sitemap-url":{type:`string`,description:`Explicit sitemap URL. Selects sitemap mode when --mode is omitted.`},urls:{type:`string`,description:`Comma-separated URLs for list mode.`},"urls-file":{type:`string`,description:`File with one URL per line for list mode.`},"max-pages":{type:`string`,description:`Maximum pages to crawl, up to 10,000. Defaults to 500.`},"max-depth":{type:`string`,description:`Maximum click depth, up to 64. Defaults to 16.`},concurrency:{type:`string`,description:`Parallel page fetches, up to 16. Defaults to 8, or progressively up to 4 with --health.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache and fetch fresh pages.`},include:{type:`string`,description:`Comma-separated URL patterns to include.`},exclude:{type:`string`,description:`Comma-separated URL patterns to exclude.`},"no-sitemap":{type:`boolean`,default:!1,description:`Do not seed URLs from sitemap.xml.`},"no-robots":{type:`boolean`,default:!1,description:`Do not skip URLs disallowed by robots.txt.`},"no-external":{type:`boolean`,default:!1,description:`Do not check external links. Reserved for full link checks.`},js:{type:`boolean`,default:!1,description:`Legacy alias for --rendering on.`},rendering:{type:`string`,description:`JavaScript rendering mode: auto, on, or off. Defaults to auto.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON. Alias for --format json.`},format:{type:`string`,description:`Output format: pretty, json, csv, html, markdown, or junit. JUnit requires --health.`},output:{type:`string`,description:`Write output to this path instead of stdout.`},csv:{type:`string`,description:`CSV table to render: issues or pages. Defaults to issues.`},severity:{type:`string`,description:`Only show top fixes at this severity.`},"fail-on":{type:`string`,description:`Exit non-zero when issues exist at this severity or above.`}},run:async({args:e})=>{let t=k(e),r=co(e.format,t),i=C(e.output),a=lo(e.csv),o=oo(e.severity),s=oo(e[`fail-on`]),c=await uo(e),l=so(e),u=C(e[`sitemap-url`]),d=w(e.health),f=ao(e.mode);if(r===`junit`&&!d)throw new h(`INVALID_INPUT`,`--format junit requires --health.`);if((d||u)&&f&&f!==`sitemap`)throw new h(`INVALID_INPUT`,`--health and --sitemap-url require sitemap mode.`);if(d&&T(e,`sitemap`))throw new h(`INVALID_INPUT`,`--health cannot be combined with --no-sitemap.`);if((d||u)&&c.length)throw new h(`INVALID_INPUT`,`--health and --sitemap-url cannot be combined with URL list input.`);let ee=C(e.site),te=(l?eo(l)??l:void 0)??(ee?eo(ee):void 0)??(u?new URL(`/`,u).toString():void 0)??c[0];if(!te)throw new h(`INVALID_INPUT`,"No crawl URL given. Pass a URL, --url or --site. Run `seo sites` to list your Search Console properties.");let p=await $e({url:te,site:ee,mode:f??(d||u?`sitemap`:c.length?`list`:void 0),strategy:d?`health`:`full`,sitemapUrl:u,urls:c,maxPages:E(e[`max-pages`]),maxDepth:E(e[`max-depth`]),concurrency:E(e.concurrency),refresh:w(e.refresh),fetchRate:ri({...e,"fetch-concurrency":e.concurrency}),include:O(e.include),exclude:O(e.exclude),googleAnalyticsPropertyId:C(e[`google-analytics-property`]),analyticsConnection:$a(e),useSitemap:!T(e,`sitemap`),respectRobots:!T(e,`robots`),checkExternal:!T(e,`external`),js:$r(e)}),ne=un(p,{severity:o}),m=s?p.issues.some(e=>ro[e.severity]>=ro[s]):!1,re=p.status===`failed`,ie={...p,topFixes:ne,reviewObservations:gt(p,{severity:o}),...s?{failOn:s,failedThreshold:m}:{}};r===`json`?(await Wa(i,ie),(re||m)&&(process.exitCode=1)):r===`csv`?(await po(i,a===`pages`?yn(p):n(p)),(re||m)&&(process.exitCode=1)):r===`html`?(await po(i,At(p,ne)),(re||m)&&(process.exitCode=1)):r===`junit`?(await po(i,Tn(p)),(re||m)&&(process.exitCode=1)):r===`markdown`?(await po(i,on(p,ne)),(re||m)&&(process.exitCode=1)):i?(await po(i,Ut(p,ne)),(re||m)&&(process.exitCode=1)):(Za(p,ne),s&&(process.stdout.write(`
+`),await e.write(`${eo(n+1)}${JSON.stringify(a)}: `),await no(e,o,n+1,r)}return await e.write(`\n${eo(n)}}`),!0}finally{r.delete(a)}}async function ro(e,t){let n=new $a(e);await no(n,t,0,/* @__PURE__ */ new Set)||await n.write(`undefined`),await n.write(`
+`),await n.flush()}async function io(e,t){if(!e){await ro(process.stdout,t);return}await Er(sr(e),{recursive:!0});let n=hr(e);try{await ro(n,t),n.end(),await Xr(n)}catch(e){throw n.destroy(),e}process.stdout.write(`Wrote ${e}\n`)}function ao(e){return e.length?e.join(`, `):`none`}function oo(e,t){let n=e.robotsTxt,r=(n?.botAccess??[]).filter(e=>e.purpose===t),i=t===`search`?`AI search bots`:`AI training bots`;if(!n||r.some(e=>e.allowed===null))return{status:`unknown`,title:`${i}: unknown`,explanation:`robots.txt could not be read (${n?.availability??`not checked`}).`};let a=r.filter(e=>e.allowed===!1);return{status:a.length?t===`search`?`warning`:`info`:`pass`,title:a.length?`${i}: ${a.length} of ${r.length} blocked`:`${i}: all ${r.length} allowed`,explanation:a.length?`Blocked: ${ao(a.map(e=>e.userAgent))}.`:`Checked: ${ao(r.map(e=>e.userAgent))}.`}}function so(e){let t=e.markdownNegotiation,n=e.markdownCopies,r=t?.markdown?`Accept: text/markdown returns Markdown${t.varyAccept?` with Vary: Accept`:` without Vary: Accept`}.`:t?.availability===`available`?`Accept: text/markdown returns ${t.contentType||`no content type`}.`:`Accept: text/markdown could not be checked (${t?.availability??`not checked`}).`,i=n?` ${n.publicPagesWithLink} of ${n.publicPages} public pages link to a Markdown copy${n.privatePagesWithLink?`, and ${n.privatePagesWithLink} signed-in pages do`:``}. ${n.checked} copies checked, ${n.broken.length} broken.${n.largest?` Largest checked copy: about ${n.largest.estimatedTokens} tokens.`:``}`:``;return{status:t?.markdown||n?.publicPagesWithLink?n?.broken.length||n?.privatePagesWithLink?`warning`:`pass`:t?.availability===`available`?`info`:`unknown`,title:`Markdown copies`,explanation:`${r}${i}`}}function co(e){let t=e.llmsTxt;if(!t||t.availability===void 0)return{status:`unknown`,title:`llms.txt`,explanation:`Not checked.`};if(t.availability!==`available`)return{status:t.availability===`absent`?`info`:`unknown`,title:`llms.txt`,explanation:t.availability===`absent`?`Not found (HTTP ${t.status??`none`}).`:`Could not be read (${t.availability}).`};let n=t.links;return{status:n?.broken.length?`warning`:`pass`,title:`llms.txt`,explanation:n?`${n.found} same-site links; ${n.checked} checked, ${n.broken.length} broken.`:`Present.`}}function lo(e){if(!e)return[];let t=(e.agentResources??[]).filter(e=>e.exists).map(e=>new URL(e.url).pathname),n=[...e.robotsTxt?.contentSignals??[],...e.startPageHeaders?.contentSignal?[e.startPageHeaders.contentSignal]:[]];return[oo(e,`search`),oo(e,`training`),so(e),co(e),{status:`info`,title:`Agent files`,explanation:`Found: ${ao(t)}.`},{status:`info`,title:`Content-Signal and Link header`,explanation:`Content-Signal: ${ao([...new Set(n)])}. Link header relations on the start page: ${ao(e.startPageHeaders?.linkRelations??[])}.`}]}function uo(e){return e===`high`?`fail`:`warning`}function fo(e,t=Vn(e)){let n=pt(e),r=e.status===`failed`||e.summary.highIssues>0?`fail`:e.status===`partial`?`unknown`:e.summary.mediumIssues>0||e.summary.lowIssues>0?`warning`:`pass`,i=e.access.samples.slice(0,5).map(e=>({status:`fail`,title:e.evidence.guidance.summary,explanation:`${e.evidence.provider} returned ${e.evidence.kind} evidence for the crawler request.`,evidence:[e.url],fix:e.evidence.guidance.recommendedAction})),a=t.slice(0,10).map(e=>({status:uo(e.severity),title:`${e.title} on ${e.count} ${e.count===1?`URL`:`URLs`}`,explanation:Ue(e.ruleId)?.whyItMatters??e.whyThisRanks,evidence:e.sampleUrls.slice(0,5),fix:e.howToFix})),o=n.slice(0,10).map(e=>({status:`warning`,title:`${e.title} on ${e.count} ${e.count===1?`URL`:`URLs`}`,explanation:Ue(e.ruleId)?.whyItMatters??e.whyThisRanks,evidence:e.sampleUrls.slice(0,5),fix:e.howToFix}));ta({title:e.config.strategy===`health`?`Sitemap health pass`:`Site crawl`,target:e.config.url,status:r,summary:Ln(e)??(e.status===`partial`?`Partial evidence from ${e.summary.totalPages} retained pages. Review the caveats before treating missing findings as an all-clear.`:`${e.summary.totalPages} pages retained with ${e.issues.length} findings.`),metrics:[{label:`Pages`,value:e.summary.totalPages},{label:`High`,value:e.summary.highIssues,status:`fail`},{label:`Medium`,value:e.summary.mediumIssues,status:`warning`},{label:`Low`,value:e.summary.lowIssues,status:`info`},{label:`Failed fetches`,value:e.summary.failedUrls}],sections:[{title:`Access diagnostics`,diagnostics:i},{title:`Prioritised fixes`,diagnostics:a},{title:`Review before changing anything`,diagnostics:o},{title:`Agent access`,diagnostics:lo(e.ai)},...!i.length&&!a.length&&!o.length?[{title:`Checks`,diagnostics:[{status:`pass`,title:`No prioritised findings were observed`,explanation:`The evaluated crawl evidence did not produce a prioritised fix or review item.`}]}]:[]],notes:[`Strategy: ${e.config.strategy}. Data: ${e.status}. Report: ${e.id}.`,...e.warnings,...e.caveats]})}const po={"google-analytics-property":{type:`string`,description:`Google Analytics property ID for landing-page sessions.`},"clicky-site-id":{type:`string`,description:`Clicky site ID for landing-page visits.`}};function mo(e){let t=T(e[`google-analytics-property`]),n=T(e[`clicky-site-id`]);if(t&&n)throw new _(`INVALID_INPUT`,`Pass either --google-analytics-property or --clicky-site-id, not both.`);if(t)return{provider:`google`,propertyId:t};if(n)return{provider:`clicky`,siteId:kn(n)}}const ho=[`health`,`sitemap-url`,`site`,`severity`,`fail-on`,`csv`,`max-pages`,`max-depth`,`include`,`exclude`],go=[`GPTBot`,`OAI-SearchBot`,`ClaudeBot`,`PerplexityBot`,`Google-Extended`,`CCBot`];async function _o(e){process.stdout.write(e)||await new Promise(e=>process.stdout.once(`drain`,e))}async function vo(e,t){let n=T(e.format),r=j(e);if(n&&n!==`jsonl`&&n!==`pretty`)throw new _(`INVALID_INPUT`,`Sites mode writes one JSON row per line. Use --format jsonl (or --json), or --format pretty for counts only.`);if(r&&n===`pretty`)throw new _(`INVALID_INPUT`,`Use either --json or --format, not both.`);for(let t of ho)if(e[t]!==void 0&&e[t]!==!1)throw new _(`INVALID_INPUT`,`--${t} does not apply to sites mode.`);let i=r||n===`jsonl`,a=T(e.output),o=T(e.crawlUrl)??T(e.url),s=o?[o,...t]:t;if(!s.length)throw new _(`INVALID_INPUT`,`No sites given. Pass --urls example.com,example.org or --urls-file with one site per line.`);a&&await Er(sr(a),{recursive:!0});let c=a?await Dr(a,`w`):void 0,l=async e=>{c?await c.write(e):i&&await _o(e)},u=!i&&process.stderr.isTTY,d=0,f;try{f=await Le({sites:s,concurrency:O(e.concurrency),respectRobots:!D(e,`robots`),onRow:async e=>{await l(`${JSON.stringify(e)}\n`),d+=1,u&&process.stderr.write(`\rChecked ${d} sites`)}}),u&&d&&process.stderr.write(`
+`),await l(`${JSON.stringify(f)}\n`)}finally{await c?.close()}i||bo(f,a),a&&process.stdout.write(`Wrote ${a}\n`)}function yo(e,t,n=[]){return[e,[`${t.available} found`,...n,`${t.absent} missing`,`${t[`access-blocked`]} access blocked`,`${t[`rate-limited`]} rate limited`,`${t.unreachable} unreachable (${t.failed} with no response)`].join(`, `)]}function bo(e,t){let n=[e.invalid?`${e.invalid} not valid sites`:``,e.duplicatesRemoved?`${e.duplicatesRemoved} duplicates removed`:``].filter(Boolean),r=e.homepage;R([[`Sites`,`${e.checked} checked of ${e.sites}${n.length?` (${n.join(`, `)})`:``}. Limit ${dt.toLocaleString(`en-US`)} per run.`],yo(`robots.txt`,e.robotsTxt),[`Home page`,[`${r.available} answered 2xx`,`${r.absent} answered 4xx`,`${r[`access-blocked`]} access blocked`,`${r[`rate-limited`]} rate limited`,`${r.unreachable} unreachable (${r.failed} with no response)`,`${r.skipped} not requested because robots.txt disallows it or could not be read`].join(`, `)],yo(`llms.txt`,e.llmsTxt,[`${e.llmsTxt.startsWithH1} start with an H1`]),...e.botAccess.filter(e=>go.includes(e.userAgent)).map(e=>[e.userAgent,`${e.blocked} block it in robots.txt, ${e.allowed} allow it, ${e.unknown} unknown (robots.txt not read)`]),[`Run`,`${e.status}, ${Math.round(e.durationMs/1e3)}s, ${e.concurrency} sites at a time, ${e.timeoutMs/1e3}s per request`]]),t||process.stdout.write(`
+Add --json for one row per site, or --output <file> to save the rows.
+`)}function xo(e){let t=e.trim();if(/^https?:\/\//i.test(t))return t;if(t.startsWith(`sc-domain:`))return`https://${t.slice(10)}/`;if(/^[a-z0-9-]+(\.[a-z0-9-]+)+(:\d+)?(\/\S*)?$/i.test(t))return`https://${t.includes(`/`)?t:`${t}/`}`}function So(e){return e?e.backpressure?.status===`stopped`?`stopped: ${e.backpressure.reason??`origin cooldown`}`:e.backpressure?.status===`slowed`?`slowed ${e.backpressure.delayMs}ms`:e.rendering?.status===`unavailable`?`raw HTML; rendering unavailable`:e.rendering?.status===`failed`?`raw HTML; rendering failed`:e.blocked?`blocked`:e.rendered?`rendered`:e.cache===`hit`?`cached`:e.fetched?`fetched`:e.source:`-`}function Co(e){return e?e===`serp-framing`?`wording gap`:e===`content-gap`?`content gap`:e===`technical-check`?`technical check`:`covered`:`-`}const wo={high:3,medium:2,low:1},To=x({meta:{name:`crawl`,description:`Run a fast sitemap health pass or a full technical crawl`},args:{crawlUrl:{type:`positional`,required:!1,description:`Site start URL. Optional with --sitemap-url.`},url:{type:`string`,description:`Start URL to crawl. Defaults to the --site home page.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},...po,mode:{type:`string`,description:`Crawl mode: site, page, list, sitemap, or sites. Start with sitemap --health for large sites. sites checks robots.txt, the home page and llms.txt for up to 1,000 sites from --urls or --urls-file.`},health:{type:`boolean`,default:!1,description:`Run the uncached sitemap status and redirect pass before a full audit. No page-body analysis.`},"sitemap-url":{type:`string`,description:`Explicit sitemap URL. Selects sitemap mode when --mode is omitted.`},urls:{type:`string`,description:`Comma-separated URLs for list mode, or sites for sites mode.`},"urls-file":{type:`string`,description:`File with one URL per line for list mode, or one site per line for sites mode.`},"max-pages":{type:`string`,description:`Maximum pages to crawl, up to 10,000. Defaults to 500.`},"max-depth":{type:`string`,description:`Maximum click depth, up to 64. Defaults to 16.`},concurrency:{type:`string`,description:`Parallel page fetches, up to 16. Defaults to 8, or progressively up to 4 with --health. In sites mode, sites checked at once.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache and fetch fresh pages.`},include:{type:`string`,description:`Comma-separated URL patterns to include.`},exclude:{type:`string`,description:`Comma-separated URL patterns to exclude.`},"no-sitemap":{type:`boolean`,default:!1,description:`Do not seed URLs from sitemap.xml.`},"no-robots":{type:`boolean`,default:!1,description:`Do not skip URLs disallowed by robots.txt.`},"no-external":{type:`boolean`,default:!1,description:`Do not check external links. Reserved for full link checks.`},js:{type:`boolean`,default:!1,description:`Legacy alias for --rendering on.`},rendering:{type:`string`,description:`JavaScript rendering mode: auto, on, or off. Defaults to auto.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON. Alias for --format json, or --format jsonl in sites mode.`},format:{type:`string`,description:`Output format: pretty, json, csv, html, markdown, or junit. JUnit requires --health. Sites mode takes jsonl or pretty.`},output:{type:`string`,description:`Write output to this path instead of stdout.`},csv:{type:`string`,description:`CSV table to render: issues or pages. Defaults to issues.`},severity:{type:`string`,description:`Only show top fixes at this severity.`},"fail-on":{type:`string`,description:`Exit non-zero when issues exist at this severity or above.`}},run:async({args:e})=>{let t=Eo(e.mode);if(t===`sites`){await vo(e,await jo(e));return}let r=j(e),i=ko(e.format,r),a=T(e.output),o=Ao(e.csv),s=Do(e.severity),c=Do(e[`fail-on`]),l=await jo(e),u=Oo(e),d=T(e[`sitemap-url`]),f=E(e.health);if(i===`junit`&&!f)throw new _(`INVALID_INPUT`,`--format junit requires --health.`);if((f||d)&&t&&t!==`sitemap`)throw new _(`INVALID_INPUT`,`--health and --sitemap-url require sitemap mode.`);if(f&&D(e,`sitemap`))throw new _(`INVALID_INPUT`,`--health cannot be combined with --no-sitemap.`);if((f||d)&&l.length)throw new _(`INVALID_INPUT`,`--health and --sitemap-url cannot be combined with URL list input.`);let ee=T(e.site),te=(u?xo(u)??u:void 0)??(ee?xo(ee):void 0)??(d?new URL(`/`,d).toString():void 0)??l[0];if(!te)throw new _(`INVALID_INPUT`,"No crawl URL given. Pass a URL, --url or --site. Run `seo sites` to list your Search Console properties.");let p=await n({url:te,site:ee,mode:t??(f||d?`sitemap`:l.length?`list`:void 0),strategy:f?`health`:`full`,sitemapUrl:d,urls:l,maxPages:O(e[`max-pages`]),maxDepth:O(e[`max-depth`]),concurrency:O(e.concurrency),refresh:E(e.refresh),fetchRate:mi({...e,"fetch-concurrency":e.concurrency}),include:A(e.include),exclude:A(e.exclude),googleAnalyticsPropertyId:T(e[`google-analytics-property`]),analyticsConnection:mo(e),useSitemap:!D(e,`sitemap`),respectRobots:!D(e,`robots`),checkExternal:!D(e,`external`),js:ui(e)}),m=Vn(p,{severity:s}),h=c?p.issues.some(e=>wo[e.severity]>=wo[c]):!1,g=p.status===`failed`,ne={...p,topFixes:m,reviewObservations:pt(p,{severity:s}),...c?{failOn:c,failedThreshold:h}:{}};i===`json`?(await io(a,ne),(g||h)&&(process.exitCode=1)):i===`csv`?(await No(a,o===`pages`?Wt(p):kt(p)),(g||h)&&(process.exitCode=1)):i===`html`?(await No(a,It(p,m)),(g||h)&&(process.exitCode=1)):i===`junit`?(await No(a,bn(p)),(g||h)&&(process.exitCode=1)):i===`markdown`?(await No(a,ln(p,m)),(g||h)&&(process.exitCode=1)):a?(await No(a,Bt(p,m)),(g||h)&&(process.exitCode=1)):(fo(p,m),c&&(process.stdout.write(`
 Run metadata
-`),I([[`Fail threshold`,s]])),(re||m)&&(process.exitCode=1))}});function ao(e){let t=C(e);if(t){if([`site`,`page`,`list`,`sitemap`].includes(t))return t;throw new h(`INVALID_INPUT`,`Mode must be one of: site, page, list, sitemap.`)}}function oo(e){let t=C(e);if(t){if([`low`,`medium`,`high`].includes(t))return t;throw new h(`INVALID_INPUT`,`Severity must be one of: low, medium, high.`)}}function so(e){let t=C(e.crawlUrl),n=C(e.url);if(t&&n&&t!==n)throw new h(`INVALID_INPUT`,`Use either a URL argument or --url, not both.`);return t??n}function co(e,t){let n=C(e);if(t&&n&&n!==`json`)throw new h(`INVALID_INPUT`,`Use either --json or --format, not both.`);if(!n)return t?`json`:`pretty`;if([`pretty`,`json`,`csv`,`html`,`markdown`,`junit`].includes(n))return n;throw new h(`INVALID_INPUT`,`Format must be one of: pretty, json, csv, html, markdown, junit.`)}function lo(e){let t=C(e);if(!t)return`issues`;if([`issues`,`pages`].includes(t))return t;throw new h(`INVALID_INPUT`,`CSV table must be one of: issues, pages.`)}async function uo(e){let t=O(e.urls)??[],n=C(e[`urls-file`]);return n&&t.push(...fo(await v(n,`utf8`))),[...new Set(t)]}function fo(e){return e.split(/[\n,]/).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`))}async function po(e,t){e?(await _r(Qn(e),{recursive:!0}),await br(e,t),process.stdout.write(`Wrote ${e}\n`)):process.stdout.write(t)}const mo=y({meta:{name:`gsc-query`,description:`Run a raw Search Console Search Analytics query`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},account:{type:`string`,description:`Saved Google account email.`},"start-date":{type:`string`,description:`Start date YYYY-MM-DD.`},"end-date":{type:`string`,description:`End date YYYY-MM-DD. Without dates: the last 28 days of final data.`},dimensions:{type:`string`,description:`Comma-separated GSC dimensions, for example query,page.`},type:{type:`string`,description:`Search type. Defaults to web.`},limit:{type:`string`,description:`Maximum rows to request and print.`},body:{type:`string`,description:`Raw Search Analytics JSON body.`},"body-file":{type:`string`,description:`Path to a Search Analytics JSON body file.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass local cache and fetch fresh GSC data.`}},run:async({args:e})=>{let t=await ii(e.body,e[`body-file`])??{startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),dimensions:O(e.dimensions)??[`query`,`page`],type:C(e.type)??`web`,rowLimit:E(e.limit),dataState:`final`};try{Object.assign(t,sn({startDate:C(t.startDate),endDate:C(t.endDate)},28))}catch(e){throw p(e)}let n=k(e),r=A(C(e.site)??C(t.siteUrl));delete t.siteUrl;let i=await mn(r,t,{refresh:w(e.refresh),accountEmail:C(e.account)}),a=E(e.limit),o=a?i.rows.slice(0,a):i.rows;n?F({site:r,request:t,...i,rows:o,rowsReturned:o.length}):(K({title:`Search Console query`,target:r,status:i.rowsFetched>o.length?`unknown`:`info`,summary:`${o.length} rows returned from ${i.rowsFetched} fetched rows.`,metrics:[{label:`Rows returned`,value:o.length},{label:`Rows fetched`,value:i.rowsFetched},{label:`API calls`,value:i.calls}]}),L([`Keys`,`Clicks`,`Impr`,`CTR`,`Pos`],o.slice(0,25).map(e=>[e.keys.join(` | `),Math.round(e.clicks),Math.round(e.impressions),e.ctr.toFixed(3),e.position.toFixed(1)])))}}),ho=y({meta:{name:`url-inspect`,description:`Inspect a URL with the Search Console URL Inspection API`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},account:{type:`string`,description:`Saved Google account email.`},url:{type:`string`,description:`URL to inspect.`},language:{type:`string`,description:`Optional inspection language code.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=A(C(e.site)),r=C(e.url);if(!r)throw Error(`Pass --url.`);let i=await rn({siteUrl:n,inspectionUrl:r,accountEmail:C(e.account),languageCode:C(e.language)});if(t){F(i);return}let a=i.inspectionResult?.indexStatusResult;K({title:`URL Inspection`,target:r,status:a===void 0?`unknown`:a.verdict===`PASS`?`pass`:`warning`,summary:a===void 0?`Google did not return index status evidence for this URL.`:`${a.verdict??`Unknown`}: ${a.coverageState??`Coverage state unavailable`}.`,metrics:[{label:`Property`,value:n},{label:`Robots`,value:a?.robotsTxtState??`Unknown`},{label:`Last crawl`,value:a?.lastCrawlTime??`Unknown`},{label:`Google canonical`,value:a?.googleCanonical??`Unknown`}]})}}),go={days:{cli:`days`,arg:{type:`string`,description:`GSC lookback window. Defaults to 28.`}},recentDays:{cli:`recent`,arg:{type:`string`,description:`Recent anomaly window in days. Defaults to 14.`}},range:{cli:`days`,arg:{type:`string`,description:`GSC lookback window. Defaults to 28.`}},limit:{cli:`limit`,arg:{type:`string`,description:`Maximum rows to return.`}},checkLimit:{cli:`check-limit`,arg:{type:`string`,description:`Maximum candidate pages to fetch and check.`}},minImpressions:{cli:`min-impressions`,arg:{type:`string`,description:`Minimum query impressions.`}},includeBrand:{cli:`include-brand`,arg:{type:`boolean`,default:!1,description:`Include branded queries in opportunity reports.`}},verifyContent:{cli:`verify-content`,arg:{type:`boolean`,default:!1,description:`Verify top opportunities against page title, meta, and content.`}},verifyLimit:{cli:`verify-limit`,arg:{type:`string`,description:`Maximum opportunity URLs to verify.`}},js:{cli:`js`,arg:{type:`boolean`,default:!1,description:`Force JavaScript rendering for verified pages.`}},fetchConcurrency:{cli:`fetch-concurrency`,arg:{type:`string`,description:`Maximum concurrent page fetches per host, up to 16. Defaults to 4.`}},fetchIntervalCap:{cli:`fetch-interval-cap`,arg:{type:`string`,description:`Maximum page fetches per interval per host. Defaults to 4.`}},fetchIntervalMs:{cli:`fetch-interval-ms`,arg:{type:`string`,description:`Fetch rate interval in milliseconds. Defaults to 1000.`}},refresh:{cli:`refresh`,arg:{type:`boolean`,default:!1,description:`Bypass local cache and fetch fresh data.`}}};function X(e,t={}){return Object.fromEntries(e.map(e=>{let n=go[e];return[n.cli,{...n.arg,...t[e]}]}))}function _o(e){return e.toLocaleString(`en-GB`,{maximumFractionDigits:e>=100?0:1})}function vo(e){if(e===null)return`n/a`;let t=Math.abs(e)>=10?e.toFixed(0):e.toFixed(1);return`${e>0?`+`:``}${t}%`}const yo=y({meta:{name:`traffic-anomaly`,description:`Detect unusual recent GSC traffic movement`},args:{site:{type:`string`},...X([`days`,`recentDays`,`refresh`],{days:{description:`Baseline window length in days. Defaults to 90.`},recentDays:{description:`Recent anomaly window in days. Defaults to 7.`},refresh:{description:`Bypass local cache and fetch fresh GSC data.`}}),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=await Jt({site:A(C(e.site)),days:E(e.days),recentDays:E(e.recent),refresh:w(e.refresh)});t?F(n):(K({title:`Traffic anomaly report`,target:n.site,status:n.coverage?.status===`complete`?n.anomalies.some(e=>e.significant)?`warning`:`pass`:`unknown`,summary:n.anomalies.some(e=>e.significant)?`At least one recent metric moved beyond the report threshold.`:`No significant recent movement was found in the retained evidence.`,metrics:[{label:`Metrics checked`,value:n.anomalies.length},{label:`Significant`,value:n.anomalies.filter(e=>e.significant).length},{label:`Observed days`,value:n.coverage?.observedDays??`Unavailable`},{label:`Expected days`,value:n.coverage?.expectedDays??`Unavailable`}]}),q([`Metric`,`Direction`,`Baseline/day`,`Recent/day`,`Change`,`z`,`Significant`],n.anomalies.map(e=>[e.metric,e.direction,_o(e.baselineMean),_o(e.comparisonMean),vo(e.percentChange),e.zScore??`n/a`,e.significant?`yes`:`no`])),n.coverage&&Y(`Evidence coverage`,[`${n.coverage.observedDays} of ${n.coverage.expectedDays} requested calendar days returned date aggregates.`,...n.coverage.caveats]))}}),bo=y({meta:{name:`update-correlate`,description:`Compare traffic movement with official Google update windows`},args:{site:{type:`string`},...X([`days`,`recentDays`,`refresh`],{days:{description:`Baseline window length in days. Defaults to 90.`},recentDays:{description:`Recent anomaly window in days. Defaults to 7.`},refresh:{description:`Bypass local cache and fetch fresh GSC data.`}}),"padding-days":{type:`string`,description:`Days around update windows to count as overlap.`},"known-change":{type:`string`,description:`Manual site-side change to treat as a confounder, for example pruning pages or blocking traffic.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=A(C(e.site)),r=await Ee({site:n,days:E(e.days),recentDays:E(e.recent),paddingDays:E(e[`padding-days`]),knownConfounders:C(e[`known-change`])?[C(e[`known-change`])??``]:void 0,refresh:w(e.refresh)});t?F(r):(K({title:`Google update correlation`,target:r.site,status:`unknown`,summary:r.summary,metrics:[{label:`Classification`,value:r.classification.replaceAll(`-`,` `)},{label:`Attribution`,value:r.attribution.replaceAll(`-`,` `)},{label:`Confidence`,value:r.confidence},{label:`Updates matched`,value:r.overlappingUpdates.length},{label:`Known confounders`,value:r.confounders.length},{label:`Source`,value:r.source.name}]}),Y(`Evidence`,r.evidence),Y(`Report caveats`,r.caveats),Y(`Recommended next checks`,r.actions),q([`Metric`,`Direction`,`Baseline/day`,`Recent/day`,`Change`,`z`],r.anomalies.map(e=>[e.metric,e.direction,_o(e.baselineMean),_o(e.comparisonMean),vo(e.percentChange),e.zScore??`n/a`])),r.overlappingUpdates.length&&(process.stdout.write(`
+`),R([[`Fail threshold`,c]])),(g||h)&&(process.exitCode=1))}});function Eo(e){let t=T(e);if(t){if([`site`,`page`,`list`,`sitemap`,`sites`].includes(t))return t;throw new _(`INVALID_INPUT`,`Mode must be one of: site, page, list, sitemap, sites.`)}}function Do(e){let t=T(e);if(t){if([`low`,`medium`,`high`].includes(t))return t;throw new _(`INVALID_INPUT`,`Severity must be one of: low, medium, high.`)}}function Oo(e){let t=T(e.crawlUrl),n=T(e.url);if(t&&n&&t!==n)throw new _(`INVALID_INPUT`,`Use either a URL argument or --url, not both.`);return t??n}function ko(e,t){let n=T(e);if(t&&n&&n!==`json`)throw new _(`INVALID_INPUT`,`Use either --json or --format, not both.`);if(!n)return t?`json`:`pretty`;if([`pretty`,`json`,`csv`,`html`,`markdown`,`junit`].includes(n))return n;throw new _(`INVALID_INPUT`,`Format must be one of: pretty, json, csv, html, markdown, junit.`)}function Ao(e){let t=T(e);if(!t)return`issues`;if([`issues`,`pages`].includes(t))return t;throw new _(`INVALID_INPUT`,`CSV table must be one of: issues, pages.`)}async function jo(e){let t=A(e.urls)??[],n=T(e[`urls-file`]);return n&&t.push(...Mo(await b(n,`utf8`))),[...new Set(t)]}function Mo(e){return e.split(/[\n,]/).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`))}async function No(e,t){e?(await Er(sr(e),{recursive:!0}),await jr(e,t),process.stdout.write(`Wrote ${e}\n`)):process.stdout.write(t)}const Po=x({meta:{name:`gsc-query`,description:`Run a raw Search Console Search Analytics query`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},account:{type:`string`,description:`Saved Google account email.`},"start-date":{type:`string`,description:`Start date YYYY-MM-DD.`},"end-date":{type:`string`,description:`End date YYYY-MM-DD. Without dates: the last 28 days of final data.`},dimensions:{type:`string`,description:`Comma-separated GSC dimensions, for example query,page.`},type:{type:`string`,description:`Search type. Defaults to web.`},limit:{type:`string`,description:`Maximum rows to request and print.`},body:{type:`string`,description:`Raw Search Analytics JSON body.`},"body-file":{type:`string`,description:`Path to a Search Analytics JSON body file.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass local cache and fetch fresh GSC data.`}},run:async({args:e})=>{let t=await hi(e.body,e[`body-file`])??{startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),dimensions:A(e.dimensions)??[`query`,`page`],type:T(e.type)??`web`,rowLimit:O(e.limit),dataState:`final`};try{Object.assign(t,un({startDate:T(t.startDate),endDate:T(t.endDate)},28))}catch(e){throw m(e)}let n=j(e),r=M(T(e.site)??T(t.siteUrl));delete t.siteUrl;let i=await Ke(r,t,{refresh:E(e.refresh),accountEmail:T(e.account)}),a=O(e.limit),o=a?i.rows.slice(0,a):i.rows;n?L({site:r,request:t,...i,rows:o,rowsReturned:o.length}):(K({title:`Search Console query`,target:r,status:i.rowsFetched>o.length?`unknown`:`info`,summary:`${o.length} rows returned from ${i.rowsFetched} fetched rows.`,metrics:[{label:`Rows returned`,value:o.length},{label:`Rows fetched`,value:i.rowsFetched},{label:`API calls`,value:i.calls}]}),z([`Keys`,`Clicks`,`Impr`,`CTR`,`Pos`],o.slice(0,25).map(e=>[e.keys.join(` | `),Math.round(e.clicks),Math.round(e.impressions),e.ctr.toFixed(3),e.position.toFixed(1)])))}}),Fo=x({meta:{name:`url-inspect`,description:`Inspect a URL with the Search Console URL Inspection API`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},account:{type:`string`,description:`Saved Google account email.`},url:{type:`string`,description:`URL to inspect.`},language:{type:`string`,description:`Optional inspection language code.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=M(T(e.site)),r=T(e.url);if(!r)throw Error(`Pass --url.`);let i=await h({siteUrl:n,inspectionUrl:r,accountEmail:T(e.account),languageCode:T(e.language)});if(t){L(i);return}let a=i.inspectionResult?.indexStatusResult;K({title:`URL Inspection`,target:r,status:a===void 0?`unknown`:a.verdict===`PASS`?`pass`:`warning`,summary:a===void 0?`Google did not return index status evidence for this URL.`:`${a.verdict??`Unknown`}: ${a.coverageState??`Coverage state unavailable`}.`,metrics:[{label:`Property`,value:n},{label:`Robots`,value:a?.robotsTxtState??`Unknown`},{label:`Last crawl`,value:a?.lastCrawlTime??`Unknown`},{label:`Google canonical`,value:a?.googleCanonical??`Unknown`}]})}}),Io={days:{cli:`days`,arg:{type:`string`,description:`GSC lookback window. Defaults to 28.`}},recentDays:{cli:`recent`,arg:{type:`string`,description:`Recent anomaly window in days. Defaults to 14.`}},range:{cli:`days`,arg:{type:`string`,description:`GSC lookback window. Defaults to 28.`}},limit:{cli:`limit`,arg:{type:`string`,description:`Maximum rows to return.`}},checkLimit:{cli:`check-limit`,arg:{type:`string`,description:`Maximum candidate pages to fetch and check.`}},minImpressions:{cli:`min-impressions`,arg:{type:`string`,description:`Minimum query impressions.`}},includeBrand:{cli:`include-brand`,arg:{type:`boolean`,default:!1,description:`Include branded queries in opportunity reports.`}},verifyContent:{cli:`verify-content`,arg:{type:`boolean`,default:!1,description:`Verify top opportunities against page title, meta, and content.`}},verifyLimit:{cli:`verify-limit`,arg:{type:`string`,description:`Maximum opportunity URLs to verify.`}},js:{cli:`js`,arg:{type:`boolean`,default:!1,description:`Force JavaScript rendering for verified pages.`}},fetchConcurrency:{cli:`fetch-concurrency`,arg:{type:`string`,description:`Maximum concurrent page fetches per host, up to 16. Defaults to 4.`}},fetchIntervalCap:{cli:`fetch-interval-cap`,arg:{type:`string`,description:`Maximum page fetches per interval per host. Defaults to 4.`}},fetchIntervalMs:{cli:`fetch-interval-ms`,arg:{type:`string`,description:`Fetch rate interval in milliseconds. Defaults to 1000.`}},refresh:{cli:`refresh`,arg:{type:`boolean`,default:!1,description:`Bypass local cache and fetch fresh data.`}}};function X(e,t={}){return Object.fromEntries(e.map(e=>{let n=Io[e];return[n.cli,{...n.arg,...t[e]}]}))}function Lo(e){return e.toLocaleString(`en-GB`,{maximumFractionDigits:e>=100?0:1})}function Ro(e){if(e===null)return`n/a`;let t=Math.abs(e)>=10?e.toFixed(0):e.toFixed(1);return`${e>0?`+`:``}${t}%`}const zo=x({meta:{name:`traffic-anomaly`,description:`Detect unusual recent GSC traffic movement`},args:{site:{type:`string`},...X([`days`,`recentDays`,`refresh`],{days:{description:`Baseline window length in days. Defaults to 90.`},recentDays:{description:`Recent anomaly window in days. Defaults to 7.`},refresh:{description:`Bypass local cache and fetch fresh GSC data.`}}),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=await $e({site:M(T(e.site)),days:O(e.days),recentDays:O(e.recent),refresh:E(e.refresh)});t?L(n):(K({title:`Traffic anomaly report`,target:n.site,status:n.coverage?.status===`complete`?n.anomalies.some(e=>e.significant)?`warning`:`pass`:`unknown`,summary:n.anomalies.some(e=>e.significant)?`At least one recent metric moved beyond the report threshold.`:`No significant recent movement was found in the retained evidence.`,metrics:[{label:`Metrics checked`,value:n.anomalies.length},{label:`Significant`,value:n.anomalies.filter(e=>e.significant).length},{label:`Observed days`,value:n.coverage?.observedDays??`Unavailable`},{label:`Expected days`,value:n.coverage?.expectedDays??`Unavailable`}]}),q([`Metric`,`Direction`,`Baseline/day`,`Recent/day`,`Change`,`z`,`Significant`],n.anomalies.map(e=>[e.metric,e.direction,Lo(e.baselineMean),Lo(e.comparisonMean),Ro(e.percentChange),e.zScore??`n/a`,e.significant?`yes`:`no`])),n.coverage&&Y(`Evidence coverage`,[`${n.coverage.observedDays} of ${n.coverage.expectedDays} requested calendar days returned date aggregates.`,...n.coverage.caveats]))}}),Bo=x({meta:{name:`update-correlate`,description:`Compare traffic movement with official Google update windows`},args:{site:{type:`string`},...X([`days`,`recentDays`,`refresh`],{days:{description:`Baseline window length in days. Defaults to 90.`},recentDays:{description:`Recent anomaly window in days. Defaults to 7.`},refresh:{description:`Bypass local cache and fetch fresh GSC data.`}}),"padding-days":{type:`string`,description:`Days around update windows to count as overlap.`},"known-change":{type:`string`,description:`Manual site-side change to treat as a confounder, for example pruning pages or blocking traffic.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=M(T(e.site)),r=await ue({site:n,days:O(e.days),recentDays:O(e.recent),paddingDays:O(e[`padding-days`]),knownConfounders:T(e[`known-change`])?[T(e[`known-change`])??``]:void 0,refresh:E(e.refresh)});t?L(r):(K({title:`Google update correlation`,target:r.site,status:`unknown`,summary:r.summary,metrics:[{label:`Classification`,value:r.classification.replaceAll(`-`,` `)},{label:`Attribution`,value:r.attribution.replaceAll(`-`,` `)},{label:`Confidence`,value:r.confidence},{label:`Updates matched`,value:r.overlappingUpdates.length},{label:`Known confounders`,value:r.confounders.length},{label:`Source`,value:r.source.name}]}),Y(`Evidence`,r.evidence),Y(`Report caveats`,r.caveats),Y(`Recommended next checks`,r.actions),q([`Metric`,`Direction`,`Baseline/day`,`Recent/day`,`Change`,`z`],r.anomalies.map(e=>[e.metric,e.direction,Lo(e.baselineMean),Lo(e.comparisonMean),Ro(e.percentChange),e.zScore??`n/a`])),r.overlappingUpdates.length&&(process.stdout.write(`
 Updates
-`),L([`Start`,`End`,`Type`,`Name`],r.overlappingUpdates.map(e=>[e.start.slice(0,10),e.end?.slice(0,10)??`open`,e.type,e.name]))),La(`seo segment-impact --site ${JSON.stringify(n)} --dimension page`))}}),xo={site:{type:`string`,description:`Search Console property, for example sc-domain:example.com.`}};function So(e){return{type:`string`,description:`Output folder. Defaults to ./seo-export/<site>-${e}-YYYY-MM-DD.`}}function Co(e){return e.toLowerCase().replace(/^sc-domain:/,``).replace(/^https?:\/\//,``).replace(/[^a-z0-9._-]+/g,`-`).replace(/^-+|-+$/g,``)}function wo(e){let t=(/* @__PURE__ */ new Date()).toISOString().slice(0,10),n=Co(e.site);return tr(process.cwd(),`seo-export`,`${n}-${e.report}-${t}`)}async function To(e,t){await _r(e,{recursive:!0});let n=[];for(let r of t){let t=tr(e,r.filename);await br(t,Ct(r.rows,r.headers),`utf8`),n.push(t)}return n}function Eo(e,t){process.stdout.write(`Wrote ${Kn(t.length,`CSV file`)} to ${e}\n`);for(let e of t)process.stdout.write(`- ${e}\n`)}const Do=y({meta:{name:`refresh-priorities`,description:`Export the ranked SEO priority queue, score breakdowns, grouped findings, and diagnosis detail CSVs.`},args:{...xo,out:So(`refresh-priorities`),...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum queue items to export. Defaults to 25.`}}),...Qa,"verify-content":Qr(`Verify top opportunities against page title, meta, and content. Defaults to true.`,`Skip page content verification.`),"verify-limit":{type:`string`,description:`Maximum opportunity URLs to verify. Defaults to 5.`}},run:async({args:e})=>{let t=A(C(e.site)),n=await We({site:t,days:E(e.days),recentDays:E(e.recent),limit:E(e.limit),includeBrand:w(e[`include-brand`]),googleAnalyticsPropertyId:C(e[`google-analytics-property`]),analyticsConnection:$a(e),verifyContent:w(e[`verify-content`]),verifyLimit:E(e[`verify-limit`]),refresh:w(e.refresh)}),r=C(e.out)??wo({report:`refresh-priorities`,site:t});Eo(r,await To(r,Sn(n)))}}),Oo=y({meta:{name:`update-postmortem`,description:`Export update postmortem attribution, findings, template movement, and segment movers.`},args:{...xo,out:So(`update-postmortem`),...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum winners/losers per segment. Defaults to 20.`}}),"known-change":{type:`string`,description:`Manual site-side change to treat as a confounder, for example pruning pages or blocking traffic.`}},run:async({args:e})=>{let t=A(C(e.site)),n=await Bn({site:t,days:E(e.days),recentDays:E(e.recent),limit:E(e.limit),includeBrand:w(e[`include-brand`]),knownConfounders:C(e[`known-change`])?[C(e[`known-change`])??``]:void 0,refresh:w(e.refresh)}),r=C(e.out)??wo({report:`update-postmortem`,site:t});Eo(r,await To(r,qr(n)))}}),ko=y({meta:{name:`export`,description:`Export full report data to CSV files`},subCommands:{"update-postmortem":Oo,"refresh-priorities":Do}});function Ao(e,t,n={}){if(process.platform!==`win32`)return wr(e,t,n);let r=e=>/^[\w./:=@\\-]+$/.test(e)?e:`"${e.replaceAll(`"`,`""`)}"`;return wr([e,...t].map(r).join(` `),{...n,shell:!0})}function jo(e){let t=e.platform===`win32`?rr:$n;return e.platform===`win32`?e.env.APPDATA??t.resolve(e.home,`AppData/Roaming`):e.platform===`darwin`?t.resolve(e.home,`Library/Application Support`):e.env.XDG_CONFIG_HOME??t.resolve(e.home,`.config`)}function Mo(e={}){let t=e.home??Yn(),n=e.platform??process.platform,r=jo({home:t,platform:n,env:e.env??process.env}),i=n===`win32`?rr:$n,a=[];if(n===`darwin`||n===`win32`){let e=i.resolve(r,`Claude`);a.push({kind:`json`,client:`claude-desktop`,label:`Claude Desktop`,path:i.resolve(e,`claude_desktop_config.json`),commandNames:[],detectionPaths:n===`darwin`?[e,`/Applications/Claude.app`]:[e]})}return a.push({kind:`json`,client:`claude-code`,label:`Claude Code`,path:i.resolve(t,`.claude.json`),includeType:!0,commandNames:[`claude`],detectionPaths:[i.resolve(t,`.claude`)]},{kind:`native`,client:`codex`,label:`Codex`,path:i.resolve(t,`.codex/config.toml`),executable:`codex`,commandNames:[`codex`],detectionPaths:[i.resolve(t,`.codex`)]},{kind:`json`,client:`cursor`,label:`Cursor`,path:i.resolve(t,`.cursor/mcp.json`),commandNames:[`cursor`,`cursor-agent`],detectionPaths:[i.resolve(t,`.cursor`),...n===`darwin`?[`/Applications/Cursor.app`]:[]]}),a}function No(e,t={}){let n=t.platform??process.platform,r=t.exists??_,i=t.nodePath??process.execPath,a=n===`win32`?[`${e}.cmd`,`${e}.exe`,e]:[e],o=(t.path??process.env.PATH??``).split(n===`win32`?`;`:`:`).filter(Boolean);for(let e of o)for(let t of a){let n=g(e,t);if(r(n))return n}for(let e of a){let t=g(Qn(i),e);if(r(t))return t}return e}function Po(e){return No(e)!==e}function Fo(e={}){let t=e.targets??Mo(),n=e.hasCommand??Po,r=e.hasPath??_;return t.filter(e=>e.kind===`native`?e.commandNames.some(n):r(e.path)||e.detectionPaths.some(r)||e.commandNames.some(n))}const Io={insertSpaces:!0,tabSize:2,eol:`
-`};function Lo(){return(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g,`-`)}function Ro(e,t){sr(Qn(e),{recursive:!0,mode:448});let n=`${e}.${process.pid}.${Date.now()}.tmp`,r=_(e)?pr(e).mode&511:384;mr(n,t,{encoding:`utf8`,mode:r}),dr(n,e)}function zo(e){let t=`${e}.bak-${Lo()}`,n=t,r=2;for(;_(n);)n=`${t}-${r}`,r+=1;ar(e,n,ir.COPYFILE_EXCL)}function Bo(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Vo(e){if(!_(e.path))return{source:`{}
-`,config:{}};let t=cr(e.path,`utf8`),n=[],r=Hr(t,n,{allowTrailingComma:!0});if(n.length>0){let t=n[0],r=t?`${Ur(t.error)} at offset ${t.offset}`:`unknown parse error`;throw Error(`Cannot update ${e.path}: invalid JSONC (${r}).`)}if(!Bo(r))throw Error(`Cannot update ${e.path}: config root must be an object.`);if(r.mcpServers!==void 0&&!Bo(r.mcpServers))throw Error(`Cannot update ${e.path}: mcpServers must be an object.`);return{source:t,config:r}}function Ho(e){return e.includes(`mcp`)&&e.includes(`serve`)&&e.some(e=>e===`seo`||e.startsWith(`seo@`)||e===`@seo/cli`)}function Uo(e,t){return typeof e.command!=`string`||t.length!==3||t[1]!==`mcp`||t[2]!==`serve`||!Bo(e.env)?!1:e.env.SEO_MCP_CONFIGURED_BY===`seo`}function Wo(e){if(!Bo(e)||!Array.isArray(e.args))return!1;let t=e.args.filter(e=>typeof e==`string`);return Ho(t)||Uo(e,t)}function Go(e){let t=Br(e.source,Vr(e.source,[`mcpServers`,e.name??`seo`],e.value,{formattingOptions:Io}));_(e.target.path)&&zo(e.target.path),Ro(e.target.path,t)}function Ko(e,t){let n=Ao(e,t,{encoding:`utf8`});return{status:n.status,stdout:String(n.stdout??``),stderr:String(n.stderr??``),error:n.error}}function qo(e){let t=e.replaceAll(`\\`,`/`).toLowerCase();return t.includes(`/_npx/`)||t.includes(`/.npm/_npx/`)||t.includes(`/.cache/pnpm/dlx/`)}function Jo(e){if(!e||!_(e))return;let t=ur(e);return qo(t)?void 0:t}function Yo(e={}){let t=Jo(e.cliPath??process.argv[1]);if(t)return{command:e.nodePath??process.execPath,args:[t,`mcp`,`serve`]};let n=`seo@${e.version??ut}`;return(e.platform??process.platform)===`win32`?{command:`cmd`,args:[`/c`,`npx`,`-y`,n,`mcp`,`serve`]}:{command:`npx`,args:[`-y`,n,`mcp`,`serve`]}}function Xo(e=!1,t=Yo()){let n=En(),r={command:t.command,args:t.args,env:{SEO_CONFIG_DIR:n.configDir,SEO_MCP_CONFIGURED_BY:`seo`}};return e&&(r.type=`stdio`),r}function Zo(e){return e.includes(`SEO_MCP_CONFIGURED_BY`)||/args:\s+-y\s+(?:seo(?:@\S+)?|@seo\/cli)\s+mcp\s+serve\b/.test(e)}function Qo(e,t,n){let r=No(e.executable),i=n.runCommand(r,[`mcp`,`get`,`seo`]);if(i.error?.code===`ENOENT`)throw Error("Cannot install SEO MCP for Codex: the `codex` command is not available on PATH. Install Codex CLI or choose another MCP client.");let a=i.status===0;if(a&&!Zo(i.stdout))throw Error(`Cannot ${t} SEO MCP: ${e.path} already has an unmanaged mcp_servers.seo entry.`);if(t===`install`&&a&&!n.reinstall||t===`uninstall`&&!a)return{client:e.client,path:e.path,changed:!1};if(t===`install`&&a){let e=n.runCommand(r,[`mcp`,`remove`,`seo`]);if(e.error||e.status!==0){let t=e.error?.message??e.stderr.trim()??`unknown error`;throw Error(`Cannot reinstall SEO MCP for Codex: ${t}`)}}let o=En(),s=t===`install`?[`mcp`,`add`,`seo`,`--env`,`SEO_CONFIG_DIR=${o.configDir}`,`--env`,`SEO_MCP_CONFIGURED_BY=seo`,`--`,n.serverCommand.command,...n.serverCommand.args]:[`mcp`,`remove`,`seo`],c=n.runCommand(r,s);if(c.error||c.status!==0){let e=c.error?.message??c.stderr.trim()??`unknown error`;throw Error(`Cannot ${t} SEO MCP for Codex: ${e}`)}return{client:e.client,path:e.path,changed:!0}}function $o(e,t={}){let n={runCommand:t.runCommand??Ko,reinstall:t.reinstall??!1,serverCommand:t.serverCommand??Yo()};if(e.kind===`native`)return Qo(e,`install`,n);let{source:r,config:i}=Vo(e),a=i.mcpServers?.seo,o=Xo(e.includeType,n.serverCommand);if(xr(a,o)&&!n.reinstall)return{client:e.client,path:e.path,changed:!1};if(a!==void 0&&!Wo(a))throw Error(`Cannot install SEO MCP: ${e.path} already has an unmanaged mcpServers.seo entry.`);return Go({target:e,source:r,value:o}),{client:e.client,path:e.path,changed:!0}}function es(e,t={}){if(e.kind===`native`)return Qo(e,`uninstall`,{runCommand:t.runCommand??Ko,reinstall:!1,serverCommand:Yo()});if(!_(e.path))return{client:e.client,path:e.path,changed:!1};let{source:n,config:r}=Vo(e),i=r.mcpServers;if(i?.seo===void 0)return{client:e.client,path:e.path,changed:!1};if(!Wo(i.seo))throw Error(`Cannot uninstall SEO MCP: ${e.path} has an unmanaged mcpServers.seo entry.`);return Go({target:e,source:n,value:void 0}),{client:e.client,path:e.path,changed:!0}}const ts=`https://seoskill.dev/mcp`,ns=`seoskill`;function rs(e){return e.client!==`claude-desktop`}function is(e){return e.includeType?{type:`http`,url:ts}:{url:ts}}function as(e){return Bo(e)&&e.url===`https://seoskill.dev/mcp`}function os(e,t={}){if(!rs(e))throw Error(`${e.label} takes the hosted server from its Connectors settings, not its config file.`);if(e.kind===`native`){let n=t.runCommand??Ko,r=No(e.executable),i=n(r,[`mcp`,`get`,ns]);if(i.error?.code===`ENOENT`)throw Error("Cannot add the hosted MCP server for Codex: the `codex` command is not available on PATH.");if(i.status===0){if(i.stdout.includes(`https://seoskill.dev/mcp`))return{client:e.client,path:e.path,changed:!1};throw Error(`Cannot add the hosted MCP server: ${e.path} already has a different mcp_servers.${ns} entry.`)}let a=n(r,[`mcp`,`add`,ns,`--url`,ts]);if(a.error||a.status!==0){let e=a.error?.message??a.stderr.trim()??`unknown error`;throw Error(`Cannot add the hosted MCP server for Codex: ${e}`)}return{client:e.client,path:e.path,changed:!0}}let{source:n,config:r}=Vo(e),i=r.mcpServers?.[ns];if(as(i))return{client:e.client,path:e.path,changed:!1};if(i!==void 0)throw Error(`Cannot add the hosted MCP server: ${e.path} already has a different mcpServers.${ns} entry.`);return Go({target:e,source:n,value:is(e),name:ns}),{client:e.client,path:e.path,changed:!0}}const ss=e=>process.stdout.write(`${e}\n`);async function cs(){let{google:e,bing:t,keys:n}=await Oe();return{status:`linked`,google:e.map(e=>e.email),bing:t.length,keys:Object.keys(n).filter(e=>e!==`x-dataforseo-login`&&!e.startsWith(`x-clicky-`)),clicky:Object.keys(n).filter(e=>e.startsWith(Cn)).length}}function ls(e){return[`Linked to your seoskill.dev account.`,`Google: ${e.google.join(`, `)||`none`}.`,`Bing: ${e.bing?`${e.bing} linked`:`not connected (add it at ${Te}/account)`}.`,`Keys: ${e.keys.length?e.keys.map(e=>e.replace(/^x-|-(key|password)$/g,``)).join(`, `):`none`}.`,`Clicky: ${e.clicky?`${e.clicky} site${e.clicky===1?``:`s`}`:`none`}.`,`Next: seo sites, then seo report --site <site>.`].join(`
-`)}const us=y({meta:{name:`login`,description:`Link this machine to your seoskill.dev account: its Google accounts, Bing and keys`},args:{json:{type:`boolean`,default:!1,description:`Print JSON.`}},run:async({args:e})=>{let t=k(e),n=async()=>{let e=await cs();t?F(e):ss(ls(e))};if(process.env.SEO_TOKEN?.trim()){await n();return}if(Gn()){let e=await pe();if(e===`linked`)return n();if(e===`pending`&&!P({json:t})){let e=Gn();t?F({status:`pending`,...fs(e)}):ss(`Waiting for approval. Open ${e?.url} and click "Link this machine", then run \`seo login\` again.`);return}}else if(Pe()){await n();return}let r=Gn()??await s();if(!P({json:t}))t?F({status:`pending`,...fs(r)}):ss([`Open this link in the person's browser and ask them to approve it:`,r.url,`Code: ${r.code}. After they approve, run \`seo login\` again.`].join(`
-`));else{if(await ds())return n();ss("The login expired. Run `seo login` again."),process.exitCode=1}}});async function ds(){let e=Gn()??await s();for(ss(`Opening ${e.url}\nApprove code ${e.code} there. Waiting…`),await Be(e.url);Gn();){await new Promise(e=>setTimeout(e,3e3));let e=await pe();if(e===`linked`)return!0;if(e===`expired`)break}return!1}const fs=e=>({url:e?.url,code:e?.code}),ps=y({meta:{name:`logout`,description:`Unlink this machine from your seoskill.dev account`},args:{json:{type:`boolean`,default:!1,description:`Print JSON.`}},run:async({args:e})=>{let t=await ie();k(e)?F({unlinked:t}):ss(t?`This machine is no longer linked to your seoskill.dev account.`:`This machine was not linked.`)}});function ms(e={}){let t=Ao(`npx`,[`-y`,`skills`,`add`,`iannuttall/seo`],{stdio:e.quiet?`ignore`:`inherit`});return t.error?{status:`failed`,error:t.error.message}:t.status===0?{status:`installed`}:{status:`failed`,error:`npx skills add exited with status ${t.status??`unknown`}.`}}async function hs(e){let t=async()=>{let{google:e}=await Oe().catch(()=>({google:[]}));return{status:`linked`,accountEmail:e.map(e=>e.email).join(`, `)||void 0}};if(process.env.SEO_TOKEN?.trim()||Pe())return t();if(!e.interactive)return null;let n=B(await Pr({message:`How do you want to sign in?`,options:[{value:`account`,label:`Sign in or create a free seoskill.dev account`,hint:`Recommended. Your Google accounts, Bing and keys in one place, for the CLI and the hosted MCP`},{value:`local`,label:`Sign in with Google on this machine only`},{value:`skip`,label:`Skip for now`}]}));return n===`skip`?{status:`skipped`}:n===`local`?null:await ds()?t():(b("The link expired. Run `seo login` to try again.",`Not signed in`),{status:`skipped`})}function gs(e){let t={value:`skip`,label:`Skip for now`};return e.sharedConfigured||e.byoConfigured?[{value:`login`,label:`Connect Google`,hint:`Opens your browser for read-only Search Console and Google Analytics access`},t]:[{value:`setup`,label:`Set up Google login for local development`,hint:`This source checkout does not include the public app credentials`},t]}async function _s(){let e=await wa();return b(`Connected as ${e.account_email}. seo has read-only access and cannot change your site.`,`Google connected`),{status:`connected`,accountEmail:e.account_email}}async function vs(e){let t=await Ue();if(t.activeMode===`service-account`)return{status:`service-account`,accountEmail:t.identity};if(!e.interactive){if(t.tokens)return{status:`already-connected`,accountEmail:t.tokens.account_email};throw new h(`AUTH_REQUIRED`,Se())}let n=ee();if(n.length>0){let e=B(await Pr({message:`Google account to use`,options:[...n.map(e=>({value:{type:`account`,accountEmail:e.accountEmail},label:e.accountEmail,hint:e.active?`Current default`:void 0})),{value:{type:`connect`},label:`Connect another Google account`}]}));if(e.type===`account`)return Xt(e.accountEmail),{status:`already-connected`,accountEmail:e.accountEmail};if(t.sharedConfigured||t.byoConfigured)return _s()}let r=B(await Pr({message:`Connect Google now?`,options:gs({sharedConfigured:t.sharedConfigured,byoConfigured:t.byoConfigured})}));if(r===`skip`)return{status:`skipped`};if(r===`setup`){let e=B(await Fr({message:`Google Desktop OAuth client ID`,validate:e=>e?void 0:`Client ID is required`})),t=B(await Nr({message:`Google Desktop OAuth client secret`,validate:e=>e?void 0:`Client secret is required`}));qt({clientId:e,clientSecret:t})}return _s()}async function ys(){return B(await Or({message:`Install the SEO skill so your agents know how to use seo?`,initialValue:!0}))?ms():{status:`declined`}}async function bs(){let e=Fo();if(e.length===0)return[];let t=B(await Pr({message:`Add an MCP server to your agents?`,options:[{value:`hosted`,label:`Free hosted server (recommended)`,hint:`${ts}, your agent asks you to sign in with Google`},{value:`local`,label:`Local server`,hint:`Runs on this machine with the sign-in from this setup`},{value:`skip`,label:`Skip for now`}]}));if(t===`skip`)return[];let n=B(await Mr({message:`Which agents?`,options:e.map(e=>({value:e.client,label:e.label,hint:e.path})),initialValues:e.map(e=>e.client)})),r=e.filter(e=>n.includes(e.client)).map(e=>{let n=t===`hosted`&&rs(e)?`hosted`:`local`;try{return{...n===`hosted`?os(e):$o(e),server:n}}catch(t){return{client:e.client,path:e.path,server:n,changed:!1,error:t instanceof Error?t.message:String(t)}}});return t===`hosted`&&r.some(e=>e.client===`claude-desktop`)&&b(`Claude Desktop got the local server. To use the hosted one there, open Settings, then Connectors, and add ${ts} as a custom connector.`,`Claude Desktop`),r}const xs=[`seo sites`,`seo report --site <site>`],Ss=[`Sign in or create your free seoskill.dev account, or sign in with Google on this machine only (read-only Search Console and Google Analytics).`,`Add the free hosted MCP server (${ts}) or a local one to your agents.`,`Install the SEO skill for your agents.`];function Cs(e){return e.status===`skipped`?`skipped`:e.status===`linked`?`seoskill.dev account${e.accountEmail?` (${e.accountEmail})`:``}`:e.status===`service-account`?`service account${e.accountEmail?` ${e.accountEmail}`:``}`:e.accountEmail??`connected`}function ws(e){return e.status===`installed`?`installed`:e.status===`failed`?`install failed`:`not installed`}function Ts(e){return e.length===0?`not added`:e.map(e=>e.error?`${e.client} skipped`:`${e.client} (${e.server})`).join(`, `)}function Es(){process.stdout.write(`
-`),R({title:`Help other people find SEO Skill`,body:`If SEO Skill saved you time, a GitHub star helps other people find it.`,command:`https://github.com/iannuttall/seo`})}async function Ds(e){let t=k(e);if(t||kr(process.argv[2]===`setup`?`seo setup`:`seo start`),e[`dry-run`]){t?F({dryRun:!0,steps:Ss,next:xs}):(b(Ss.map((e,t)=>`${t+1}. ${e}`).join(`
-`),`Setup will`),b(xs.join(`
-`),`Then run`),x(`Dry run complete. Nothing was changed.`));return}jt();let n=P({json:t}),r=await hs({interactive:n})??await vs({interactive:n}),i=n?await bs():[],a=n?await ys():{status:`skipped`};if(t){F({auth:r,mcp:i,skill:a,next:xs});return}I([[`Sign-in`,Cs(r)],[`MCP server`,Ts(i)],[`SEO skill`,ws(a)]]);let o=i.filter(e=>e.error);o.length&&b(o.map(e=>`${e.client}: ${e.error}`).join(`
-`),`MCP setup skipped`),a.error&&b(a.error,`SEO skill install failed`),b(`seo sites                  list your Search Console properties
-seo report --site <site>   run the main report for one of them`,`Try next`),x(`Setup complete.`),Es()}const Os=y({meta:{name:`setup`,description:`Sign in with Google, then add the MCP server and skill`},args:{"dry-run":{type:`boolean`,default:!1,description:`Show what setup does without changing anything.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON. Never prompts.`}},run:async({args:e})=>Ds(e)}),ks=y({...Os,meta:{name:`start`,description:`Start here: sign in with Google, then add the MCP server and skill to your agents`}}),As=y({...ks,meta:{name:`init`,description:"Legacy alias for `seo start`."}}),js=y({meta:{name:`logs`,description:`Manage local log retention`},subCommands:{prune:y({meta:{name:`prune`,description:`Rotate large logs and remove old local logs`},args:{quiet:{type:`boolean`,default:!1,description:`Do not print a result.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=Xr();k(e)?F(t):e.quiet||process.stdout.write(`Rotated ${t.rotated} and removed ${t.removed} log files. ${Ji(t.sizeBytes)} retained.\n`)}})}}),Ms=[{client:`claude-desktop`,flag:`claude-desktop`},{client:`claude-code`,flag:`claude-code`},{client:`codex`,flag:`codex`},{client:`cursor`,flag:`cursor`}];function Ns(e,t){return w(e.all)?t:Ms.filter(({flag:t})=>w(e[t])).map(({client:e})=>e)}const Ps=y({meta:{name:`mcp`,description:`MCP server helpers`},subCommands:{serve:y({meta:{name:`serve`,description:`Run the SEO MCP server`},args:{test:{type:`boolean`,default:!1,description:`Start in test mode`}},run:async({args:e})=>{let{startMcpServer:t}=await import(`./dist-BZ5-V3qL.js`);await t({test:w(e.test)})}}),install:y({meta:{name:`install`,description:`Install or remove SEO MCP config for local clients`},args:{uninstall:{type:`boolean`,default:!1,description:`Remove the SEO MCP config instead of adding it`},reinstall:{type:`boolean`,default:!1,description:`Rewrite an existing managed SEO MCP config`},"claude-desktop":{type:`boolean`,default:!1,description:`Update Claude Desktop`},"claude-code":{type:`boolean`,default:!1,description:`Update Claude Code`},codex:{type:`boolean`,default:!1,description:`Update Codex CLI, app, and IDE extension`},cursor:{type:`boolean`,default:!1,description:`Update Cursor`},all:{type:`boolean`,default:!1,description:`Update every detected MCP client`},json:{type:`boolean`,default:!1,description:`Print structured JSON output`}},run:async({args:e})=>{if(w(e.uninstall)&&w(e.reinstall))throw new h(`INVALID_INPUT`,`Use either --uninstall or --reinstall, not both.`);let t=Mo(),n=Fo({targets:t}),r=k(e),i=Ns(e,n.map(e=>e.client));if(i.length===0){if(!P({json:r}))throw new h(`INVALID_INPUT`,`Choose an MCP client with --claude-desktop, --claude-code, --codex, --cursor, or --all.`);let a=n.length>0?n:t;i=B(await Mr({message:e.uninstall?`Remove seo from which MCP clients?`:`Install seo into which MCP clients?`,options:a.map(e=>({value:e.client,label:e.label,hint:e.path})),initialValues:n.map(e=>e.client),required:!0}))}let a=i.filter(e=>!t.some(t=>t.client===e));if(a.length>0)throw new h(`INVALID_INPUT`,`MCP setup is not supported for ${a.join(`, `)} on ${process.platform}.`);let o=t.filter(e=>i.includes(e.client)).map(t=>w(e.uninstall)?es(t):$o(t,{reinstall:w(e.reinstall)}));if(r)F({operation:w(e.uninstall)?`uninstall`:`install`,results:o});else for(let e of o)process.stdout.write(`${e.changed?`updated`:`skipped`} ${e.client} · ${e.path}\n`)}})}}),Fs=y({meta:{name:`index-coverage`,description:`Find crawlable pages that deserve a closer Google index check`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},url:{type:`string`,description:`Start URL to crawl. Defaults to the home page.`},sitemaps:{type:`string`,description:`Comma-separated XML sitemap URLs. Defaults to declarations captured by the crawl.`},days:{type:`string`,description:`Finalized Search Console date range. Defaults to 90 days.`},"row-limit":{type:`string`,description:`Maximum Search Console page rows. Defaults to 100000.`},"max-sitemap-urls":{type:`string`,description:`Maximum sitemap inventory URLs. Defaults to 100000.`},limit:{type:`string`,description:`Maximum URLs returned in each evidence group. Defaults to 100.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local Search Console cache.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=A(C(e.site)),r=ni(e.sitemaps),i=await Zt({site:n,url:C(e.url),sitemaps:r.length?r:void 0,days:E(e.days),rowLimit:E(e[`row-limit`]),maxSitemapUrls:E(e[`max-sitemap-urls`]),itemsPerSection:E(e.limit),refresh:w(e.refresh)});t?F(i):(K({title:`Index coverage`,target:i.site,status:i.sources.crawl.completeness===`complete`&&i.sources.searchConsole.completeness===`complete`?i.summary.crawlableCandidatesWithoutRetainedSearchVisibility>0?`warning`:`pass`:`unknown`,summary:`${i.summary.crawlableCandidatesWithoutRetainedSearchVisibility} crawlable pages need URL Inspection review.`,metrics:[{label:`Crawl report`,value:i.input.crawlReport.id},{label:`Crawl evidence`,value:i.sources.crawl.completeness},{label:`Sitemap evidence`,value:i.sources.sitemap.completeness},{label:`Search evidence`,value:i.sources.searchConsole.completeness},{label:`Search window`,value:`${i.sources.searchConsole.startDate} to ${i.sources.searchConsole.endDate}`},{label:`Search-visible pages`,value:i.summary.retainedSearchVisibleUrls},{label:`Blocked/non-indexable`,value:i.summary.blockedOrNonIndexableCrawlUrls},{label:`Sitemap only`,value:i.summary.sitemapOnlyUrls},{label:`Search Console only`,value:i.summary.searchConsoleOnlyUrls}]}),i.crawlableWithoutRetainedSearchVisibility.items.length&&(process.stdout.write(`
+`),z([`Start`,`End`,`Type`,`Name`],r.overlappingUpdates.map(e=>[e.start.slice(0,10),e.end?.slice(0,10)??`open`,e.type,e.name]))),Za(`seo segment-impact --site ${JSON.stringify(n)} --dimension page`))}}),Vo={site:{type:`string`,description:`Search Console property, for example sc-domain:example.com.`}};function Ho(e){return{type:`string`,description:`Output folder. Defaults to ./seo-export/<site>-${e}-YYYY-MM-DD.`}}function Uo(e){return e.toLowerCase().replace(/^sc-domain:/,``).replace(/^https?:\/\//,``).replace(/[^a-z0-9._-]+/g,`-`).replace(/^-+|-+$/g,``)}function Wo(e){let t=(/* @__PURE__ */ new Date()).toISOString().slice(0,10),n=Uo(e.site);return ur(process.cwd(),`seo-export`,`${n}-${e.report}-${t}`)}async function Go(e,t){await Er(e,{recursive:!0});let n=[];for(let r of t){let t=ur(e,r.filename);await jr(t,xt(r.rows,r.headers),`utf8`),n.push(t)}return n}function Ko(e,t){process.stdout.write(`Wrote ${ct(t.length,`CSV file`)} to ${e}\n`);for(let e of t)process.stdout.write(`- ${e}\n`)}const qo=x({meta:{name:`refresh-priorities`,description:`Export the ranked SEO priority queue, score breakdowns, grouped findings, and diagnosis detail CSVs.`},args:{...Vo,out:Ho(`refresh-priorities`),...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum queue items to export. Defaults to 25.`}}),...po,"verify-content":li(`Verify top opportunities against page title, meta, and content. Defaults to true.`,`Skip page content verification.`),"verify-limit":{type:`string`,description:`Maximum opportunity URLs to verify. Defaults to 5.`}},run:async({args:e})=>{let t=M(T(e.site)),n=await p({site:t,days:O(e.days),recentDays:O(e.recent),limit:O(e.limit),includeBrand:E(e[`include-brand`]),googleAnalyticsPropertyId:T(e[`google-analytics-property`]),analyticsConnection:mo(e),verifyContent:E(e[`verify-content`]),verifyLimit:O(e[`verify-limit`]),refresh:E(e.refresh)}),r=T(e.out)??Wo({report:`refresh-priorities`,site:t});Ko(r,await Go(r,Qn(n)))}}),Jo=x({meta:{name:`update-postmortem`,description:`Export update postmortem attribution, findings, template movement, and segment movers.`},args:{...Vo,out:Ho(`update-postmortem`),...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum winners/losers per segment. Defaults to 20.`}}),"known-change":{type:`string`,description:`Manual site-side change to treat as a confounder, for example pruning pages or blocking traffic.`}},run:async({args:e})=>{let t=M(T(e.site)),n=await g({site:t,days:O(e.days),recentDays:O(e.recent),limit:O(e.limit),includeBrand:E(e[`include-brand`]),knownConfounders:T(e[`known-change`])?[T(e[`known-change`])??``]:void 0,refresh:E(e.refresh)}),r=T(e.out)??Wo({report:`update-postmortem`,site:t});Ko(r,await Go(r,ii(n)))}}),Yo=x({meta:{name:`export`,description:`Export full report data to CSV files`},subCommands:{"update-postmortem":Jo,"refresh-priorities":qo}});function Xo(e,t,n={}){if(process.platform!==`win32`)return Fr(e,t,n);let r=e=>/^[\w./:=@\\-]+$/.test(e)?e:`"${e.replaceAll(`"`,`""`)}"`;return Fr([e,...t].map(r).join(` `),{...n,shell:!0})}function Zo(e){let t=e.platform===`win32`?fr:cr;return e.platform===`win32`?e.env.APPDATA??t.resolve(e.home,`AppData/Roaming`):e.platform===`darwin`?t.resolve(e.home,`Library/Application Support`):e.env.XDG_CONFIG_HOME??t.resolve(e.home,`.config`)}function Qo(e={}){let t=e.home??ir(),n=e.platform??process.platform,r=Zo({home:t,platform:n,env:e.env??process.env}),i=n===`win32`?fr:cr,a=[];if(n===`darwin`||n===`win32`){let e=i.resolve(r,`Claude`);a.push({kind:`json`,client:`claude-desktop`,label:`Claude Desktop`,path:i.resolve(e,`claude_desktop_config.json`),commandNames:[],detectionPaths:n===`darwin`?[e,`/Applications/Claude.app`]:[e]})}return a.push({kind:`json`,client:`claude-code`,label:`Claude Code`,path:i.resolve(t,`.claude.json`),includeType:!0,commandNames:[`claude`],detectionPaths:[i.resolve(t,`.claude`)]},{kind:`native`,client:`codex`,label:`Codex`,path:i.resolve(t,`.codex/config.toml`),executable:`codex`,commandNames:[`codex`],detectionPaths:[i.resolve(t,`.codex`)]},{kind:`json`,client:`cursor`,label:`Cursor`,path:i.resolve(t,`.cursor/mcp.json`),commandNames:[`cursor`,`cursor-agent`],detectionPaths:[i.resolve(t,`.cursor`),...n===`darwin`?[`/Applications/Cursor.app`]:[]]}),a}function $o(e,t={}){let n=t.platform??process.platform,r=t.exists??y,i=t.nodePath??process.execPath,a=n===`win32`?[`${e}.cmd`,`${e}.exe`,e]:[e],o=(t.path??process.env.PATH??``).split(n===`win32`?`;`:`:`).filter(Boolean);for(let e of o)for(let t of a){let n=v(e,t);if(r(n))return n}for(let e of a){let t=v(sr(i),e);if(r(t))return t}return e}function es(e){return $o(e)!==e}function ts(e={}){let t=e.targets??Qo(),n=e.hasCommand??es,r=e.hasPath??y;return t.filter(e=>e.kind===`native`?e.commandNames.some(n):r(e.path)||e.detectionPaths.some(r)||e.commandNames.some(n))}const ns={insertSpaces:!0,tabSize:2,eol:`
+`};function rs(){return(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g,`-`)}function is(e,t){gr(sr(e),{recursive:!0,mode:448});let n=`${e}.${process.pid}.${Date.now()}.tmp`,r=y(e)?Sr(e).mode&511:384;Cr(n,t,{encoding:`utf8`,mode:r}),br(n,e)}function as(e){let t=`${e}.bak-${rs()}`,n=t,r=2;for(;y(n);)n=`${t}-${r}`,r+=1;mr(e,n,pr.COPYFILE_EXCL)}function os(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function ss(e){if(!y(e.path))return{source:`{}
+`,config:{}};let t=_r(e.path,`utf8`),n=[],r=$r(t,n,{allowTrailingComma:!0});if(n.length>0){let t=n[0],r=t?`${ei(t.error)} at offset ${t.offset}`:`unknown parse error`;throw Error(`Cannot update ${e.path}: invalid JSONC (${r}).`)}if(!os(r))throw Error(`Cannot update ${e.path}: config root must be an object.`);if(r.mcpServers!==void 0&&!os(r.mcpServers))throw Error(`Cannot update ${e.path}: mcpServers must be an object.`);return{source:t,config:r}}function cs(e){return e.includes(`mcp`)&&e.includes(`serve`)&&e.some(e=>e===`seo`||e.startsWith(`seo@`)||e===`@seo/cli`)}function ls(e,t){return typeof e.command!=`string`||t.length!==3||t[1]!==`mcp`||t[2]!==`serve`||!os(e.env)?!1:e.env.SEO_MCP_CONFIGURED_BY===`seo`}function us(e){if(!os(e)||!Array.isArray(e.args))return!1;let t=e.args.filter(e=>typeof e==`string`);return cs(t)||ls(e,t)}function ds(e){let t=Zr(e.source,Qr(e.source,[`mcpServers`,e.name??`seo`],e.value,{formattingOptions:ns}));y(e.target.path)&&as(e.target.path),is(e.target.path,t)}function fs(e,t){let n=Xo(e,t,{encoding:`utf8`});return{status:n.status,stdout:String(n.stdout??``),stderr:String(n.stderr??``),error:n.error}}function ps(e){let t=e.replaceAll(`\\`,`/`).toLowerCase();return t.includes(`/_npx/`)||t.includes(`/.npm/_npx/`)||t.includes(`/.cache/pnpm/dlx/`)}function ms(e){if(!e||!y(e))return;let t=yr(e);return ps(t)?void 0:t}function hs(e={}){let t=ms(e.cliPath??process.argv[1]);if(t)return{command:e.nodePath??process.execPath,args:[t,`mcp`,`serve`]};let n=`seo@${e.version??on}`;return(e.platform??process.platform)===`win32`?{command:`cmd`,args:[`/c`,`npx`,`-y`,n,`mcp`,`serve`]}:{command:`npx`,args:[`-y`,n,`mcp`,`serve`]}}function gs(e=!1,t=hs()){let n=xn(),r={command:t.command,args:t.args,env:{SEO_CONFIG_DIR:n.configDir,SEO_MCP_CONFIGURED_BY:`seo`}};return e&&(r.type=`stdio`),r}function _s(e){return e.includes(`SEO_MCP_CONFIGURED_BY`)||/args:\s+-y\s+(?:seo(?:@\S+)?|@seo\/cli)\s+mcp\s+serve\b/.test(e)}function vs(e,t,n){let r=$o(e.executable),i=n.runCommand(r,[`mcp`,`get`,`seo`]);if(i.error?.code===`ENOENT`)throw Error("Cannot install SEO MCP for Codex: the `codex` command is not available on PATH. Install Codex CLI or choose another MCP client.");let a=i.status===0;if(a&&!_s(i.stdout))throw Error(`Cannot ${t} SEO MCP: ${e.path} already has an unmanaged mcp_servers.seo entry.`);if(t===`install`&&a&&!n.reinstall||t===`uninstall`&&!a)return{client:e.client,path:e.path,changed:!1};if(t===`install`&&a){let e=n.runCommand(r,[`mcp`,`remove`,`seo`]);if(e.error||e.status!==0){let t=e.error?.message??e.stderr.trim()??`unknown error`;throw Error(`Cannot reinstall SEO MCP for Codex: ${t}`)}}let o=xn(),s=t===`install`?[`mcp`,`add`,`seo`,`--env`,`SEO_CONFIG_DIR=${o.configDir}`,`--env`,`SEO_MCP_CONFIGURED_BY=seo`,`--`,n.serverCommand.command,...n.serverCommand.args]:[`mcp`,`remove`,`seo`],c=n.runCommand(r,s);if(c.error||c.status!==0){let e=c.error?.message??c.stderr.trim()??`unknown error`;throw Error(`Cannot ${t} SEO MCP for Codex: ${e}`)}return{client:e.client,path:e.path,changed:!0}}function ys(e,t={}){let n={runCommand:t.runCommand??fs,reinstall:t.reinstall??!1,serverCommand:t.serverCommand??hs()};if(e.kind===`native`)return vs(e,`install`,n);let{source:r,config:i}=ss(e),a=i.mcpServers?.seo,o=gs(e.includeType,n.serverCommand);if(Mr(a,o)&&!n.reinstall)return{client:e.client,path:e.path,changed:!1};if(a!==void 0&&!us(a))throw Error(`Cannot install SEO MCP: ${e.path} already has an unmanaged mcpServers.seo entry.`);return ds({target:e,source:r,value:o}),{client:e.client,path:e.path,changed:!0}}function bs(e,t={}){if(e.kind===`native`)return vs(e,`uninstall`,{runCommand:t.runCommand??fs,reinstall:!1,serverCommand:hs()});if(!y(e.path))return{client:e.client,path:e.path,changed:!1};let{source:n,config:r}=ss(e),i=r.mcpServers;if(i?.seo===void 0)return{client:e.client,path:e.path,changed:!1};if(!us(i.seo))throw Error(`Cannot uninstall SEO MCP: ${e.path} has an unmanaged mcpServers.seo entry.`);return ds({target:e,source:n,value:void 0}),{client:e.client,path:e.path,changed:!0}}const xs=`https://seoskill.dev/mcp`,Ss=`seoskill`;function Cs(e){return e.client!==`claude-desktop`}function ws(e){return e.includeType?{type:`http`,url:xs}:{url:xs}}function Ts(e){return os(e)&&e.url===`https://seoskill.dev/mcp`}function Es(e,t={}){if(!Cs(e))throw Error(`${e.label} takes the hosted server from its Connectors settings, not its config file.`);if(e.kind===`native`){let n=t.runCommand??fs,r=$o(e.executable),i=n(r,[`mcp`,`get`,Ss]);if(i.error?.code===`ENOENT`)throw Error("Cannot add the hosted MCP server for Codex: the `codex` command is not available on PATH.");if(i.status===0){if(i.stdout.includes(`https://seoskill.dev/mcp`))return{client:e.client,path:e.path,changed:!1};throw Error(`Cannot add the hosted MCP server: ${e.path} already has a different mcp_servers.${Ss} entry.`)}let a=n(r,[`mcp`,`add`,Ss,`--url`,xs]);if(a.error||a.status!==0){let e=a.error?.message??a.stderr.trim()??`unknown error`;throw Error(`Cannot add the hosted MCP server for Codex: ${e}`)}return{client:e.client,path:e.path,changed:!0}}let{source:n,config:r}=ss(e),i=r.mcpServers?.[Ss];if(Ts(i))return{client:e.client,path:e.path,changed:!1};if(i!==void 0)throw Error(`Cannot add the hosted MCP server: ${e.path} already has a different mcpServers.${Ss} entry.`);return ds({target:e,source:n,value:ws(e),name:Ss}),{client:e.client,path:e.path,changed:!0}}const Ds=e=>process.stdout.write(`${e}\n`);async function Os(){let{google:e,bing:t,keys:n}=await oe();return{status:`linked`,google:e.map(e=>e.email),bing:t.length,keys:Object.keys(n).filter(e=>e!==`x-dataforseo-login`&&!e.startsWith(`x-clicky-`)),clicky:Object.keys(n).filter(e=>e.startsWith(Dt)).length}}function ks(e){return[`Linked to your seoskill.dev account.`,`Google: ${e.google.join(`, `)||`none`}.`,`Bing: ${e.bing?`${e.bing} linked`:`not connected (add it at ${tt}/account)`}.`,`Keys: ${e.keys.length?e.keys.map(e=>e.replace(/^x-|-(key|password)$/g,``)).join(`, `):`none`}.`,`Clicky: ${e.clicky?`${e.clicky} site${e.clicky===1?``:`s`}`:`none`}.`,`Next: seo sites, then seo report --site <site>.`].join(`
+`)}const As=x({meta:{name:`login`,description:`Link this machine to your seoskill.dev account: its Google accounts, Bing and keys`},args:{json:{type:`boolean`,default:!1,description:`Print JSON.`}},run:async({args:e})=>{let t=j(e),n=async()=>{let e=await Os();t?L(e):Ds(ks(e))};if(process.env.SEO_TOKEN?.trim()){await n();return}if(ut()){let e=await he();if(e===`linked`)return n();if(e===`pending`&&!I({json:t})){let e=ut();t?L({status:`pending`,...Ms(e)}):Ds(`Waiting for approval. Open ${e?.url} and click "Link this machine", then run \`seo login\` again.`);return}}else if(ve()){await n();return}let r=ut()??await Ie();if(!I({json:t}))t?L({status:`pending`,...Ms(r)}):Ds([`Open this link in the person's browser and ask them to approve it:`,r.url,`Code: ${r.code}. After they approve, run \`seo login\` again.`].join(`
+`));else{if(await js())return n();Ds("The login expired. Run `seo login` again."),process.exitCode=1}}});async function js(){let e=ut()??await Ie();for(Ds(`Opening ${e.url}\nApprove code ${e.code} there. Waiting…`),await it(e.url);ut();){await new Promise(e=>setTimeout(e,3e3));let e=await he();if(e===`linked`)return!0;if(e===`expired`)break}return!1}const Ms=e=>({url:e?.url,code:e?.code}),Ns=x({meta:{name:`logout`,description:`Unlink this machine from your seoskill.dev account`},args:{json:{type:`boolean`,default:!1,description:`Print JSON.`}},run:async({args:e})=>{let t=await wn();j(e)?L({unlinked:t}):Ds(t?`This machine is no longer linked to your seoskill.dev account.`:`This machine was not linked.`)}});function Ps(e={}){let t=Xo(`npx`,[`-y`,`skills`,`add`,`iannuttall/seo`],{stdio:e.quiet?`ignore`:`inherit`});return t.error?{status:`failed`,error:t.error.message}:t.status===0?{status:`installed`}:{status:`failed`,error:`npx skills add exited with status ${t.status??`unknown`}.`}}async function Fs(e){let t=async()=>{let{google:e}=await oe().catch(()=>({google:[]}));return{status:`linked`,accountEmail:e.map(e=>e.email).join(`, `)||void 0}};if(process.env.SEO_TOKEN?.trim()||ve())return t();if(!e.interactive)return null;let n=B(await Gr({message:`How do you want to sign in?`,options:[{value:`account`,label:`Sign in or create a free seoskill.dev account`,hint:`Recommended. Your Google accounts, Bing and keys in one place, for the CLI and the hosted MCP`},{value:`local`,label:`Sign in with Google on this machine only`},{value:`skip`,label:`Skip for now`}]}));return n===`skip`?{status:`skipped`}:n===`local`?null:await js()?t():(S("The link expired. Run `seo login` to try again.",`Not signed in`),{status:`skipped`})}function Is(e){let t={value:`skip`,label:`Skip for now`};return e.sharedConfigured||e.byoConfigured?[{value:`login`,label:`Connect Google`,hint:`Opens your browser for read-only Search Console and Google Analytics access`},t]:[{value:`setup`,label:`Set up Google login for local development`,hint:`This source checkout does not include the public app credentials`},t]}async function Ls(){let e=await Ra();return S(`Connected as ${e.account_email}. seo has read-only access and cannot change your site.`,`Google connected`),{status:`connected`,accountEmail:e.account_email}}async function Rs(e){let t=await Ne();if(t.activeMode===`service-account`)return{status:`service-account`,accountEmail:t.identity};if(!e.interactive){if(t.tokens)return{status:`already-connected`,accountEmail:t.tokens.account_email};throw new _(`AUTH_REQUIRED`,st())}let n=er();if(n.length>0){let e=B(await Gr({message:`Google account to use`,options:[...n.map(e=>({value:{type:`account`,accountEmail:e.accountEmail},label:e.accountEmail,hint:e.active?`Current default`:void 0})),{value:{type:`connect`},label:`Connect another Google account`}]}));if(e.type===`account`)return Qe(e.accountEmail),{status:`already-connected`,accountEmail:e.accountEmail};if(t.sharedConfigured||t.byoConfigured)return Ls()}let r=B(await Gr({message:`Connect Google now?`,options:Is({sharedConfigured:t.sharedConfigured,byoConfigured:t.byoConfigured})}));if(r===`skip`)return{status:`skipped`};if(r===`setup`){let e=B(await Kr({message:`Google Desktop OAuth client ID`,validate:e=>e?void 0:`Client ID is required`})),t=B(await Wr({message:`Google Desktop OAuth client secret`,validate:e=>e?void 0:`Client secret is required`}));Ye({clientId:e,clientSecret:t})}return Ls()}async function zs(){return B(await zr({message:`Install the SEO skill so your agents know how to use seo?`,initialValue:!0}))?Ps():{status:`declined`}}async function Bs(){let e=ts();if(e.length===0)return[];let t=B(await Gr({message:`Add an MCP server to your agents?`,options:[{value:`hosted`,label:`Free hosted server (recommended)`,hint:`${xs}, your agent asks you to sign in with Google`},{value:`local`,label:`Local server`,hint:`Runs on this machine with the sign-in from this setup`},{value:`skip`,label:`Skip for now`}]}));if(t===`skip`)return[];let n=B(await Ur({message:`Which agents?`,options:e.map(e=>({value:e.client,label:e.label,hint:e.path})),initialValues:e.map(e=>e.client)})),r=e.filter(e=>n.includes(e.client)).map(e=>{let n=t===`hosted`&&Cs(e)?`hosted`:`local`;try{return{...n===`hosted`?Es(e):ys(e),server:n}}catch(t){return{client:e.client,path:e.path,server:n,changed:!1,error:t instanceof Error?t.message:String(t)}}});return t===`hosted`&&r.some(e=>e.client===`claude-desktop`)&&S(`Claude Desktop got the local server. To use the hosted one there, open Settings, then Connectors, and add ${xs} as a custom connector.`,`Claude Desktop`),r}const Vs=[`seo sites`,`seo report --site <site>`],Hs=[`Sign in or create your free seoskill.dev account, or sign in with Google on this machine only (read-only Search Console and Google Analytics).`,`Add the free hosted MCP server (${xs}) or a local one to your agents.`,`Install the SEO skill for your agents.`];function Us(e){return e.status===`skipped`?`skipped`:e.status===`linked`?`seoskill.dev account${e.accountEmail?` (${e.accountEmail})`:``}`:e.status===`service-account`?`service account${e.accountEmail?` ${e.accountEmail}`:``}`:e.accountEmail??`connected`}function Ws(e){return e.status===`installed`?`installed`:e.status===`failed`?`install failed`:`not installed`}function Gs(e){return e.length===0?`not added`:e.map(e=>e.error?`${e.client} skipped`:`${e.client} (${e.server})`).join(`, `)}function Ks(){process.stdout.write(`
+`),Qi({title:`Help other people find SEO Skill`,body:`If SEO Skill saved you time, a GitHub star helps other people find it.`,command:`https://github.com/iannuttall/seo`})}async function qs(e){let t=j(e);if(t||Br(process.argv[2]===`setup`?`seo setup`:`seo start`),e[`dry-run`]){t?L({dryRun:!0,steps:Hs,next:Vs}):(S(Hs.map((e,t)=>`${t+1}. ${e}`).join(`
+`),`Setup will`),S(Vs.join(`
+`),`Then run`),C(`Dry run complete. Nothing was changed.`));return}Lt();let n=I({json:t}),r=await Fs({interactive:n})??await Rs({interactive:n}),i=n?await Bs():[],a=n?await zs():{status:`skipped`};if(t){L({auth:r,mcp:i,skill:a,next:Vs});return}R([[`Sign-in`,Us(r)],[`MCP server`,Gs(i)],[`SEO skill`,Ws(a)]]);let o=i.filter(e=>e.error);o.length&&S(o.map(e=>`${e.client}: ${e.error}`).join(`
+`),`MCP setup skipped`),a.error&&S(a.error,`SEO skill install failed`),S(`seo sites                  list your Search Console properties
+seo report --site <site>   run the main report for one of them`,`Try next`),C(`Setup complete.`),Ks()}const Js=x({meta:{name:`setup`,description:`Sign in with Google, then add the MCP server and skill`},args:{"dry-run":{type:`boolean`,default:!1,description:`Show what setup does without changing anything.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON. Never prompts.`}},run:async({args:e})=>qs(e)}),Ys=x({...Js,meta:{name:`start`,description:`Start here: sign in with Google, then add the MCP server and skill to your agents`}}),Xs=x({...Ys,meta:{name:`init`,description:"Legacy alias for `seo start`."}}),Zs=x({meta:{name:`logs`,description:`Manage local log retention`},subCommands:{prune:x({meta:{name:`prune`,description:`Rotate large logs and remove old local logs`},args:{quiet:{type:`boolean`,default:!1,description:`Do not print a result.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=si();j(e)?L(t):e.quiet||process.stdout.write(`Rotated ${t.rotated} and removed ${t.removed} log files. ${sa(t.sizeBytes)} retained.\n`)}})}}),Qs=[{client:`claude-desktop`,flag:`claude-desktop`},{client:`claude-code`,flag:`claude-code`},{client:`codex`,flag:`codex`},{client:`cursor`,flag:`cursor`}];function $s(e,t){return E(e.all)?t:Qs.filter(({flag:t})=>E(e[t])).map(({client:e})=>e)}const ec=x({meta:{name:`mcp`,description:`MCP server helpers`},subCommands:{serve:x({meta:{name:`serve`,description:`Run the SEO MCP server`},args:{test:{type:`boolean`,default:!1,description:`Start in test mode`}},run:async({args:e})=>{let{startMcpServer:t}=await import(`./dist-CWH3D29C.js`);await t({test:E(e.test)})}}),install:x({meta:{name:`install`,description:`Install or remove SEO MCP config for local clients`},args:{uninstall:{type:`boolean`,default:!1,description:`Remove the SEO MCP config instead of adding it`},reinstall:{type:`boolean`,default:!1,description:`Rewrite an existing managed SEO MCP config`},"claude-desktop":{type:`boolean`,default:!1,description:`Update Claude Desktop`},"claude-code":{type:`boolean`,default:!1,description:`Update Claude Code`},codex:{type:`boolean`,default:!1,description:`Update Codex CLI, app, and IDE extension`},cursor:{type:`boolean`,default:!1,description:`Update Cursor`},all:{type:`boolean`,default:!1,description:`Update every detected MCP client`},json:{type:`boolean`,default:!1,description:`Print structured JSON output`}},run:async({args:e})=>{if(E(e.uninstall)&&E(e.reinstall))throw new _(`INVALID_INPUT`,`Use either --uninstall or --reinstall, not both.`);let t=Qo(),n=ts({targets:t}),r=j(e),i=$s(e,n.map(e=>e.client));if(i.length===0){if(!I({json:r}))throw new _(`INVALID_INPUT`,`Choose an MCP client with --claude-desktop, --claude-code, --codex, --cursor, or --all.`);let a=n.length>0?n:t;i=B(await Ur({message:e.uninstall?`Remove seo from which MCP clients?`:`Install seo into which MCP clients?`,options:a.map(e=>({value:e.client,label:e.label,hint:e.path})),initialValues:n.map(e=>e.client),required:!0}))}let a=i.filter(e=>!t.some(t=>t.client===e));if(a.length>0)throw new _(`INVALID_INPUT`,`MCP setup is not supported for ${a.join(`, `)} on ${process.platform}.`);let o=t.filter(e=>i.includes(e.client)).map(t=>E(e.uninstall)?bs(t):ys(t,{reinstall:E(e.reinstall)}));if(r)L({operation:E(e.uninstall)?`uninstall`:`install`,results:o});else for(let e of o)process.stdout.write(`${e.changed?`updated`:`skipped`} ${e.client} · ${e.path}\n`)}})}}),tc=x({meta:{name:`index-coverage`,description:`Find crawlable pages that deserve a closer Google index check`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},url:{type:`string`,description:`Start URL to crawl. Defaults to the home page.`},sitemaps:{type:`string`,description:`Comma-separated XML sitemap URLs. Defaults to declarations captured by the crawl.`},days:{type:`string`,description:`Finalized Search Console date range. Defaults to 90 days.`},"row-limit":{type:`string`,description:`Maximum Search Console page rows. Defaults to 100000.`},"max-sitemap-urls":{type:`string`,description:`Maximum sitemap inventory URLs. Defaults to 100000.`},limit:{type:`string`,description:`Maximum URLs returned in each evidence group. Defaults to 100.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local Search Console cache.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=M(T(e.site)),r=pi(e.sitemaps),i=await tr({site:n,url:T(e.url),sitemaps:r.length?r:void 0,days:O(e.days),rowLimit:O(e[`row-limit`]),maxSitemapUrls:O(e[`max-sitemap-urls`]),itemsPerSection:O(e.limit),refresh:E(e.refresh)});t?L(i):(K({title:`Index coverage`,target:i.site,status:i.sources.crawl.completeness===`complete`&&i.sources.searchConsole.completeness===`complete`?i.summary.crawlableCandidatesWithoutRetainedSearchVisibility>0?`warning`:`pass`:`unknown`,summary:`${i.summary.crawlableCandidatesWithoutRetainedSearchVisibility} crawlable pages need URL Inspection review.`,metrics:[{label:`Crawl report`,value:i.input.crawlReport.id},{label:`Crawl evidence`,value:i.sources.crawl.completeness},{label:`Sitemap evidence`,value:i.sources.sitemap.completeness},{label:`Search evidence`,value:i.sources.searchConsole.completeness},{label:`Search window`,value:`${i.sources.searchConsole.startDate} to ${i.sources.searchConsole.endDate}`},{label:`Search-visible pages`,value:i.summary.retainedSearchVisibleUrls},{label:`Blocked/non-indexable`,value:i.summary.blockedOrNonIndexableCrawlUrls},{label:`Sitemap only`,value:i.summary.sitemapOnlyUrls},{label:`Search Console only`,value:i.summary.searchConsoleOnlyUrls}]}),i.crawlableWithoutRetainedSearchVisibility.items.length&&(process.stdout.write(`
 Representative URL Inspection candidates
-`),L([`URL`,`Status`,`In sitemap`],i.crawlableWithoutRetainedSearchVisibility.items.map(e=>[G(e.url,80),e.status,e.inSitemap?`yes`:`no`]))),Y(`How to read this report`,i.caveats))}}),Is=y({meta:{name:`link-recover`,description:`Find search-value URLs that are now broken, blocked, or poorly redirected`},args:{site:{type:`string`},...X([`days`,`limit`,`minImpressions`,`refresh`,`js`],{days:{description:`GSC lookback window. Defaults to 90.`},limit:{description:`Maximum GSC pages to check. Defaults to 50.`},minImpressions:{description:`Minimum impressions to check a page. Defaults to 100.`},refresh:{description:`Bypass local GSC and HTTP caches.`},js:{description:`Force JavaScript rendering for final page extraction.`}}),"min-clicks":{type:`string`,description:`Minimum clicks to check a page. Defaults to 1.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=await te({site:A(C(e.site)),days:E(e.days),limit:E(e.limit),minClicks:E(e[`min-clicks`]),minImpressions:E(e[`min-impressions`]),refresh:w(e.refresh),js:w(e.js)?!0:`auto`});t?F(n):(K({title:`Link recovery`,target:n.site,status:n.warnings.length>0?`unknown`:n.summary.recoverable>0?`warning`:`pass`,summary:n.summary.recoverable>0?`${U(n.summary.recoverable)} previously visible URLs need recovery review.`:`No recoverable URLs were found in the retained evidence.`,metrics:[{label:`Range`,value:`${n.range.startDate} to ${n.range.endDate}`},{label:`Checked`,value:U(n.summary.checked)},{label:`Recoverable`,value:U(n.summary.recoverable)},{label:`High severity`,value:U(n.summary.high)},{label:`Clicks at risk`,value:U(n.summary.clicksAtRisk)},{label:`Impressions at risk`,value:U(n.summary.impressionsAtRisk)}]}),n.items.length&&(q([`Severity`,`Issue`,`Clicks`,`Impr`,`URL`,`Action`],n.items.map(e=>[e.severity,e.issue,U(e.clicks),U(e.impressions),G(e.url,56),G(e.recommendation.action,72)])),J(`Top recovery actions`,n.items.map(e=>({label:G(e.url,96),context:`${e.severity}, ${U(e.clicks)} clicks at risk`,action:e.recommendation.action})))),Y(`Warnings`,n.warnings.slice(0,10)))}}),Ls=y({meta:{name:`redirect-trace`,description:`Trace redirects and report final indexability/canonical issues`},args:{url:{type:`string`,required:!0,description:`URL to trace.`},"max-hops":{type:`string`,description:`Maximum redirect hops to follow. Defaults to 10.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache for final page extraction.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for final page extraction.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Me({url:C(e.url)??``,maxHops:E(e[`max-hops`]),refresh:w(e.refresh),js:w(e.js)?!0:`auto`});k(e)?F(t):(K({title:`Redirect trace`,target:t.url,status:t.summary.issues.length>0?`warning`:t.summary.finalIndexable===void 0?`unknown`:`pass`,summary:t.summary.issues.length>0?t.summary.issues.join(`, `):`${t.summary.hops} redirect hops ended at HTTP ${t.summary.finalStatus}.`,metrics:[{label:`Final URL`,value:t.finalUrl},{label:`Final status`,value:t.summary.finalStatus},{label:`Indexable`,value:t.summary.finalIndexable===void 0?`Unknown`:t.summary.finalIndexable?`Yes`:`No`},{label:`Hops`,value:t.summary.hops}]}),L([`#`,`Status`,`URL`,`Next`],t.chain.map((e,t)=>[t+1,e.status,G(e.url,72),G(e.nextUrl??`-`,72)])),t.finalPage&&(process.stdout.write(`
+`),z([`URL`,`Status`,`In sitemap`],i.crawlableWithoutRetainedSearchVisibility.items.map(e=>[G(e.url,80),e.status,e.inSitemap?`yes`:`no`]))),Y(`How to read this report`,i.caveats))}}),nc=x({meta:{name:`link-recover`,description:`Find search-value URLs that are now broken, blocked, or poorly redirected`},args:{site:{type:`string`},...X([`days`,`limit`,`minImpressions`,`refresh`,`js`],{days:{description:`GSC lookback window. Defaults to 90.`},limit:{description:`Maximum GSC pages to check. Defaults to 50.`},minImpressions:{description:`Minimum impressions to check a page. Defaults to 100.`},refresh:{description:`Bypass local GSC and HTTP caches.`},js:{description:`Force JavaScript rendering for final page extraction.`}}),"min-clicks":{type:`string`,description:`Minimum clicks to check a page. Defaults to 1.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=await Te({site:M(T(e.site)),days:O(e.days),limit:O(e.limit),minClicks:O(e[`min-clicks`]),minImpressions:O(e[`min-impressions`]),refresh:E(e.refresh),js:E(e.js)?!0:`auto`});t?L(n):(K({title:`Link recovery`,target:n.site,status:n.warnings.length>0?`unknown`:n.summary.recoverable>0?`warning`:`pass`,summary:n.summary.recoverable>0?`${U(n.summary.recoverable)} previously visible URLs need recovery review.`:`No recoverable URLs were found in the retained evidence.`,metrics:[{label:`Range`,value:`${n.range.startDate} to ${n.range.endDate}`},{label:`Checked`,value:U(n.summary.checked)},{label:`Recoverable`,value:U(n.summary.recoverable)},{label:`High severity`,value:U(n.summary.high)},{label:`Clicks at risk`,value:U(n.summary.clicksAtRisk)},{label:`Impressions at risk`,value:U(n.summary.impressionsAtRisk)}]}),n.items.length&&(q([`Severity`,`Issue`,`Clicks`,`Impr`,`URL`,`Action`],n.items.map(e=>[e.severity,e.issue,U(e.clicks),U(e.impressions),G(e.url,56),G(e.recommendation.action,72)])),J(`Top recovery actions`,n.items.map(e=>({label:G(e.url,96),context:`${e.severity}, ${U(e.clicks)} clicks at risk`,action:e.recommendation.action})))),Y(`Warnings`,n.warnings.slice(0,10)))}}),rc=x({meta:{name:`redirect-trace`,description:`Trace redirects and report final indexability/canonical issues, or check a redirect map`},args:{url:{type:`string`,description:`URL to trace.`},map:{type:`string`,description:`CSV of old_url,expected_new_url lines (header optional), or one URL per line. Traces up to ${pe.toLocaleString(`en-US`)} rows, 5 at a time.`},"max-hops":{type:`string`,description:`Maximum redirect hops to follow, up to 10. Defaults to 10.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache for final page extraction.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for final page extraction.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.map);if(t){await sc(e,t);return}let n=T(e.url);if(!n)throw new _(`INVALID_INPUT`,`Pass --url to trace one URL, or --map with a CSV of old and expected URLs.`);let r=await Oe({url:n,maxHops:O(e[`max-hops`]),refresh:E(e.refresh),js:E(e.js)?!0:`auto`});j(e)?L(r):(K({title:`Redirect trace`,target:r.url,status:r.summary.issues.length>0||r.summary.error?`warning`:r.summary.finalIndexable===void 0?`unknown`:`pass`,summary:[r.summary.error?`${r.summary.outcome===`timeout`?`Timed out`:`Failed`} at ${r.finalUrl}: ${r.summary.error}`:r.summary.issues.length>0?``:`${r.summary.hops} redirect ${r.summary.hops===1?`hop`:`hops`} ended at HTTP ${r.summary.finalStatus}.`,r.summary.issues.join(`, `)].filter(Boolean).join(` `),metrics:[{label:`Final URL`,value:r.finalUrl},{label:`Final status`,value:r.summary.finalStatus??`No response`},{label:`Indexable`,value:r.summary.finalIndexable===void 0?`Unknown`:r.summary.finalIndexable?`Yes`:`No`},{label:`Hops`,value:r.summary.hops}]}),z([`#`,`Status`,`URL`,`Next`],r.chain.map((e,t)=>[t+1,e.status,G(e.url,72),G(e.nextUrl??`-`,72)])),r.finalPage&&(process.stdout.write(`
 Final page
-`),I([[`Title`,t.finalPage.title??`-`],[`Canonical`,t.finalPage.canonical??`-`],[`Meta robots`,t.finalPage.metaRobots??`-`]])),Y(`Warnings`,t.warnings.slice(0,10)))}}),Rs=y({meta:{name:`ai-referrals`,description:`Find AI referral traffic detected in Google Analytics`},args:{property:{type:`string`,description:"Numeric Google Analytics property ID. Run `seo analytics google properties` to list them."},"start-date":{type:`string`,default:`28daysAgo`},"end-date":{type:`string`,default:`yesterday`},"max-rows":{type:`string`,description:`Maximum Google Analytics rows per query. Defaults to 100000.`},"result-limit":{type:`string`,description:`Maximum ranked landing pages returned. Defaults to 25.`},limit:{type:`string`,description:`Legacy alias for --max-rows.`},refresh:{type:`boolean`,default:!1,description:`Bypass cached Google Analytics responses.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=k(e),n=oi(C(e.property)),r=await Bt({property:n,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),maxRows:D(e[`max-rows`],`--max-rows`),resultLimit:D(e[`result-limit`],`--result-limit`),limit:D(e.limit,`--limit`),refresh:e.refresh===!0});if(t)F(r);else{if(K({title:`AI referral report`,target:r.property,status:r.dataStatus===`complete`?`info`:`unknown`,summary:r.summary.verdict,metrics:[{label:`Evidence`,value:r.dataStatus===`complete`?`Complete`:`Partial`,status:r.dataStatus===`complete`?`pass`:`unknown`},{label:`AI sessions`,value:U(r.summary.sessions)},{label:`AI users`,value:r.summary.totalUsers===null?`Unavailable`:U(r.summary.totalUsers)},{label:`Sources`,value:U(r.summary.sources)},{label:`Landing pages`,value:U(r.summary.landingPages)},{label:`Landing-page output`,value:`${U(r.selection.landingPages.returnedRows)} returned / ${U(r.selection.landingPages.retainedRows)} retained`},{label:`Source rows`,value:U(r.dataSource.sourceDiscovery.returnedRows)}]}),r.sources.length&&(process.stdout.write(`
+`),R([[`Title`,r.finalPage.title??`-`],[`Canonical`,r.finalPage.canonical??`-`],[`Meta robots`,r.finalPage.metaRobots??`-`]])),Y(`Warnings`,r.warnings.slice(0,10)))}}),ic={matches:`matches`,chain:`chain`,redirects:`redirects`,wrong_target:`wrong target`,not_redirected:`not redirected`,loop:`loop`,too_many_hops:`too many hops`,timeout:`timeout`,error:`error`},ac=[`matches`,`redirects`];async function oc(e){process.stdout.write(e)||await new Promise(e=>process.stdout.once(`drain`,e))}async function sc(e,t){for(let t of[`url`,`max-hops`])if(T(e[t])!==void 0)throw new _(`INVALID_INPUT`,`--${t} does not apply to --map.`);for(let t of[`refresh`,`js`])if(e[t]===!0)throw new _(`INVALID_INPUT`,`--${t} does not apply to --map.`);let n=(await Ar(t)).size;if(n>2e6)throw new _(`INVALID_INPUT`,`${t} is ${n.toLocaleString(`en-US`)} bytes. Map mode reads up to ${ie.toLocaleString(`en-US`)} bytes and ${pe.toLocaleString(`en-US`)} rows per run, so split the file.`);let r=Se(await b(t,`utf8`)),i=j(e),a=!i&&process.stderr.isTTY,o=[],s=0,c=0,l=await Be(r,async e=>{c+=1,i?await oc(`${JSON.stringify(e)}\n`):ac.includes(e.verdict)&&e.final_status===200||(s+=1,o.length<50&&o.push(e)),a&&process.stderr.write(`\rTraced ${c} of ${r.length}`)});if(a&&process.stderr.write(`
+`),i){await oc(`${JSON.stringify(l)}\n`);return}let u=Object.keys(ic).filter(e=>l.verdicts[e]).map(e=>`${l.verdicts[e]} ${ic[e]}`);K({title:`Redirect map`,target:t,status:ac.reduce((e,t)=>e+(l.verdicts[t]??0),0)===l.rows&&!l.final_not_200?`pass`:`warning`,summary:`${l.rows} rows traced: ${u.join(`, `)}.${l.final_not_200?` ${l.final_not_200} ended on a status other than 200.`:``}`,metrics:[{label:`Rows`,value:l.rows},...Object.keys(ic).filter(e=>l.verdicts[e]).map(e=>({label:ic[e],value:l.verdicts[e]??0}))]}),o.length&&(process.stdout.write(`
+Rows to look at
+`),z([`Line`,`Verdict`,`Hops`,`Status`,`Old URL`,`Ends at`],o.map(e=>[e.line,ic[e.verdict],e.hops,e.final_status??`-`,G(e.url,50),G(e.error?`${e.error} at ${e.final_url}`:e.final_url,72)])),s>o.length&&process.stdout.write(`Showing the first ${o.length}. Use --json for every row.\n`)),process.stdout.write(`\nEach hop waits up to ${Pe/1e3}s, up to 10 hops per URL, with the SEO Skill crawler user agent.\n`)}const cc=x({meta:{name:`ai-referrals`,description:`Find AI referral traffic detected in Google Analytics`},args:{property:{type:`string`,description:"Numeric Google Analytics property ID. Run `seo analytics google properties` to list them."},"start-date":{type:`string`,default:`28daysAgo`},"end-date":{type:`string`,default:`yesterday`},"max-rows":{type:`string`,description:`Maximum Google Analytics rows per query. Defaults to 100000.`},"result-limit":{type:`string`,description:`Maximum ranked landing pages returned. Defaults to 25.`},limit:{type:`string`,description:`Legacy alias for --max-rows.`},refresh:{type:`boolean`,default:!1,description:`Bypass cached Google Analytics responses.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=j(e),n=_i(T(e.property)),r=await te({property:n,startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),maxRows:k(e[`max-rows`],`--max-rows`),resultLimit:k(e[`result-limit`],`--result-limit`),limit:k(e.limit,`--limit`),refresh:e.refresh===!0});if(t)L(r);else{if(K({title:`AI referral report`,target:r.property,status:r.dataStatus===`complete`?`info`:`unknown`,summary:r.summary.verdict,metrics:[{label:`Evidence`,value:r.dataStatus===`complete`?`Complete`:`Partial`,status:r.dataStatus===`complete`?`pass`:`unknown`},{label:`AI sessions`,value:U(r.summary.sessions)},{label:`AI users`,value:r.summary.totalUsers===null?`Unavailable`:U(r.summary.totalUsers)},{label:`Sources`,value:U(r.summary.sources)},{label:`Landing pages`,value:U(r.summary.landingPages)},{label:`Landing-page output`,value:`${U(r.selection.landingPages.returnedRows)} returned / ${U(r.selection.landingPages.retainedRows)} retained`},{label:`Source rows`,value:U(r.dataSource.sourceDiscovery.returnedRows)}]}),r.sources.length&&(process.stdout.write(`
 AI sources
 `),q([`Source`,`Sessions`,`Events`,`Share of AI sessions`],r.sources.map(e=>[e.label,U(e.sessions),U(e.eventCount),W(e.shareOfAiSessions)]))),r.landingPages.length&&(process.stdout.write(`
 Landing pages
 `),q([`Landing page`,`Sessions`,`Events`,`Top source`],r.landingPages.map(e=>[G(e.landingPage,64),U(e.sessions),U(e.eventCount),e.topSourceDetails.label]))),r.dataSource.partialReasons.length){process.stdout.write(`
 Evidence warnings
-`);for(let e of r.dataSource.partialReasons)process.stdout.write(`- ${e}\n`)}process.stdout.write(`\nNote: ${r.summary.caveat}\n`)}}}),zs=y({meta:{name:`cannibal`,description:`Find queries with material exposure across multiple URLs`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`minImpressions`,`refresh`],{minImpressions:{description:`Minimum query impressions. Defaults to 50.`}}),"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=k(e),n=w(e.refresh),r=A(C(e.site)),i=await Ce({site:r,days:D(e.days,`--days`),limit:D(e.limit,`--limit`),minImpressions:D(e[`min-impressions`],`--min-impressions`),brandTerms:[...O(e[`brand-terms`])??[]],includeBrand:w(e[`include-brand`]),refresh:n});t?F(i):(K({title:`Cannibalisation report`,target:i.site,status:i.dataStatus===`complete`?`info`:`unknown`,summary:i.summary.verdict,metrics:[{label:`Evidence`,value:i.dataStatus},{label:`Range`,value:`${i.range.startDate} to ${i.range.endDate}`},{label:`Eligible`,value:U(i.summary.eligibleClusters)},{label:`Returned`,value:U(i.summary.returnedClusters)},{label:`Suppressed brand queries`,value:U(i.summary.suppressedQueries)},{label:`GSC completeness`,value:i.source.completeness},{label:`Brand queries`,value:w(e[`include-brand`])?`included`:`excluded`}]}),q([`Query`,`URLs`,`Property impr`,`Exposure`,`HHI`,`Review first`],i.items.map(e=>[G(e.query,42),e.pages.length,e.propertyImpressions===void 0?`n/a`:U(e.propertyImpressions),U(e.pageExposureImpressions),e.hhi.toFixed(2),G(e.suggestedOwnerUrl,56)])),J(`Top cannibalisation actions`,i.items.map(e=>({label:e.query,context:`${e.pages.length} material URLs; first review ${G(e.suggestedOwnerUrl,64)}`,action:e.recommendation.action}))),Y(`Report caveats`,i.caveats),Y(`Provider usage`,[i.ledgerSummary]))}}),Bs=y({meta:{name:`ctr-underperformers`,description:`Find high-impression queries with weak CTR for their position`},args:{site:{type:`string`},...X([`includeBrand`,`minImpressions`],{minImpressions:{description:`Minimum query impressions. Defaults to 1 per 5,000 retained impressions, from 30 to 200.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=k(e),n=A(C(e.site)),r=await c({site:n,minImpressions:E(e[`min-impressions`]),includeBrand:w(e[`include-brand`])});t?F(r):(K({title:`CTR underperformers`,target:r.site,status:r.dataStatus===`partial`?`unknown`:`info`,summary:r.summary.verdict,metrics:[{label:`Underperformers`,value:U(r.summary.underperformers)},{label:`Estimated click gap`,value:U(r.summary.estimatedClickShortfall)},{label:`Brand queries`,value:r.summary.brandFiltering},{label:`Evidence`,value:r.dataStatus},{label:`GSC completeness`,value:r.source.completeness}]}),Y(`Why this matters`,[`These queries already have visibility; the fastest win is usually better SERP framing, not new content.`,`Start with high-impression rows where actual CTR is far below the expected CTR for that ranking position.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),q([`Query`,`URL`,`Pos`,`Impr`,`CTR`,`Expected`,`Gap`,`Action`],r.items.map(e=>[G(e.query,36),G(e.url,48),Na(e.position),U(e.impressions),W(e.actualCtr),W(e.expectedCtr),U(e.clickShortfall),G(e.recommendation.action,72)])),J(`Top CTR actions`,r.items.map(e=>({label:e.query,context:`${U(e.clickShortfall)} click gap, ${W(e.actualCtr)} CTR`,action:e.recommendation.action}))))}});function Vs(e){return e>0?Na(e):`n/a`}const Hs=y({meta:{name:`decaying`,description:`Find query/page rows losing clicks between two GSC windows`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`refresh`]),comparison:{type:`string`,description:`Comparison: previous-period or year-over-year.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},"min-drop-pct":{type:`string`,description:`Minimum click drop percentage. Defaults to 20.`},"min-previous-clicks":{type:`string`,description:`Minimum previous-window clicks for a query/page row. Defaults to 2.`},"min-click-loss":{type:`string`,description:`Minimum absolute click loss. Defaults to 1.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=k(e),n=w(e.refresh),r=C(e.comparison),i=D(e.days,`--days`),a=D(e.limit,`--limit`),o=D(e[`min-drop-pct`],`--min-drop-pct`),s=D(e[`min-previous-clicks`],`--min-previous-clicks`),c=D(e[`min-click-loss`],`--min-click-loss`);if(r!==void 0&&r!==`previous-period`&&r!==`year-over-year`)throw new h(`INVALID_INPUT`,`--comparison must be previous-period or year-over-year.`);let l=A(C(e.site)),u=await me({site:l,days:i,limit:a,comparison:r,brandTerms:[...O(e[`brand-terms`])??[]],includeBrand:w(e[`include-brand`]),minDropPct:o,minPreviousClicks:s,minClickLoss:c,refresh:n});t?F(u):(K({title:`Decaying pages`,target:u.site,status:u.dataStatus===`complete`?u.summary.returnedRows>0?`warning`:`pass`:`unknown`,summary:u.summary.verdict,metrics:[{label:`Evidence`,value:u.dataStatus},{label:`Comparison`,value:u.comparison},{label:`Observed declines`,value:U(u.summary.returnedRows)},{label:`Eligible declines`,value:U(u.summary.eligibleRows)},{label:`Decay clusters`,value:U(u.summary.groups)},{label:`Observed click decline`,value:U(u.summary.returnedObservedRetainedQueryClickLoss)},{label:`Eligible click decline`,value:U(u.summary.observedRetainedQueryClickLoss)},{label:`Brand queries`,value:u.summary.brandFiltering},{label:`Minimum drop`,value:`${u.filters.minDropPct}%`},{label:`Minimum previous clicks`,value:U(u.filters.minPreviousClicks)},{label:`GSC completeness`,value:u.source.completeness}]}),Y(`Why this matters`,[`This report compares retained query/page rows and only counts declines observed in both windows.`,`Position, CTR, and impression movements are signals for investigation, not proof of cause.`]),Y(`Recommended actions`,u.recommendations),Y(`Report caveats`,u.caveats),Y(`Warnings`,u.warnings),u.items.length&&(u.groups.length&&(q([`Cluster`,`Rows`,`Observed loss`,`Drop`,`Sample query`,`Action`],u.groups.map(e=>[G(e.label,42),U(e.count),U(e.totalClickLoss),`${e.averageDropPct.toFixed(1)}%`,G(e.sampleQueries[0]??`-`,40),G(e.recommendation,72)])),J(`Top decay cluster actions`,u.groups.map(e=>({label:e.label,context:`${U(e.count)} retained rows, ${U(e.totalClickLoss)} observed click decline`,action:e.recommendation})))),q([`Query`,`Template`,`URL`,`Signals`,`Decline`,`Clicks`,`Impr`,`CTR`,`Pos`,`Action`],u.items.map(e=>[G(e.query,32),G(e.template.label,26),G(e.url,44),e.signals.join(`, `),U(e.clickLoss),`${U(e.previous.clicks)} -> ${U(e.current.clicks)}`,`${U(e.previous.impressions)} -> ${U(e.current.impressions)}`,`${W(e.previous.ctr)} -> ${W(e.current.ctr)}`,`${Vs(e.previous.position)} -> ${Vs(e.current.position)}`,G(e.recommendation.action,64)])),J(`Top decay actions`,u.items.map(e=>({label:e.query,context:`${e.template.label}, ${U(e.clickLoss)} fewer observed clicks`,action:e.recommendation.action})))))}});function Us(e){if(!e)return;let t=Date.now();return e=>{let n=((Date.now()-t)/1e3).toFixed(1);process.stderr.write(`[seo ${n}s] ${e}\n`)}}const Ws=y({meta:{name:`internal-links`,description:`Internal links to add across a site (--site) or to one page (--url), placed in real sentences`},args:{site:{type:`string`,description:`Site to audit: a domain, URL or Search Console property.`},url:{type:`string`,description:`One page to find internal links to.`},"max-pages":{type:`string`,description:`Site audits only: pages to crawl, 500 by default, up to 5,000.`},...$i,...ea,refresh:{type:`boolean`,default:!1,description:`Bypass the local cache and fetch fresh data.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=w(e.refresh),r=C(e.url),i=C(e.site);if(!!r==!!i)throw new h(`INVALID_INPUT`,`Send --site to audit a whole site, or --url to find links to one page.`);let o=C(e[`max-pages`]),s=o===void 0?void 0:E(o);if(o!==void 0&&s===void 0)throw new h(`INVALID_INPUT`,`--max-pages is a whole number.`);let c=r??i,l=await a({site:c,targetUrl:r,maxPages:s,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),refresh:n},{...await f({site:c,refresh:n}),progress:Us(!t&&process.stderr.isTTY)});if(t){F(l);return}let u={...r?{url:r}:{site:i},...s===void 0?{}:{"max-pages":s}};process.stdout.write(`${vt(l,{detail:V(e),offset:E(e.offset)??0,more:(e,t)=>Zi(`internal-links`,{...u,detail:e,offset:t})})}\n`)}}),Gs=y({meta:{name:`page-opportunities`,description:`Find first-party traffic growth opportunities for one URL`},args:{site:{type:`string`},url:{type:`string`,required:!0},...X([`days`,`limit`,`minImpressions`,`includeBrand`,`js`,`refresh`],{limit:{description:`Maximum page queries to inspect. Defaults to 25.`},minImpressions:{description:`Minimum query impressions. Defaults to 10.`},includeBrand:{description:`Include branded queries in page opportunity reports.`},js:{description:`Force JavaScript rendering for page extraction.`},refresh:{description:`Bypass local GSC and HTTP cache.`}}),"verify-content":Qr(`Fetch the page for title/H1/body checks. Defaults to true.`,`Skip fetching the page for title/H1/body checks.`),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=k(e),n=A(C(e.site)),r=await kn({site:n,url:C(e.url)??``,days:E(e.days),limit:E(e.limit),minImpressions:E(e[`min-impressions`]),includeBrand:w(e[`include-brand`]),verifyContent:w(e[`verify-content`])!==!1,js:w(e.js)?!0:`auto`,refresh:w(e.refresh)});t?F(r):(K({title:`Page opportunities`,target:r.url,status:r.verification.status===`failed`?`unknown`:`info`,summary:r.summary.verdict,metrics:[{label:`Title`,value:r.page?.title??`Not fetched`},{label:`Fetch`,value:to(r.page?.fetchDiagnostics)},{label:`Verification`,value:r.verification.status},{label:`Rows`,value:`${U(r.selection.returnedRows)} returned / ${U(r.selection.eligibleRows)} eligible / ${U(r.selection.sourceRows)} source`},{label:`Queries`,value:U(r.summary.queries)},{label:`Impressions`,value:U(r.summary.impressions)},{label:`Opportunities`,value:U(r.summary.opportunities)},{label:`CTR shortfall`,value:U(r.summary.estimatedCtrClickShortfall)},{label:`Focus`,value:r.summary.focus},{label:`Evidence`,value:r.dataStatus}]}),Y(`Why this matters`,[`This report starts from queries where this exact URL already has impressions, so recommendations stay tied to first-party demand.`,`Content verification separates body gaps from title/meta framing issues, which helps avoid adding copy when the page already covers the query.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),r.items.length?(q([`Type`,`Query`,`Evidence`,`Pos`,`CTR`,`Expected`,`Impr`,`Shortfall`,`Action`],r.items.map(e=>[e.opportunityType,G(e.query,38),e.verification.signals.length?e.verification.signals.join(`, `):e.verification.status,e.position.toFixed(1),W(e.ctr),e.expectedCtr===void 0?`n/a`:W(e.expectedCtr),U(e.impressions),e.estimatedCtrClickShortfall===void 0?`n/a`:U(e.estimatedCtrClickShortfall),G(e.recommendation,72)])),J(`Top page actions`,r.items.map(e=>({label:e.query,context:`${e.opportunityType}, ${U(e.impressions)} impressions`,action:e.recommendation})))):process.stdout.write(r.dataStatus===`empty`?`No GSC query rows found for this exact URL.
+`);for(let e of r.dataSource.partialReasons)process.stdout.write(`- ${e}\n`)}process.stdout.write(`\nNote: ${r.summary.caveat}\n`)}}}),lc=x({meta:{name:`cannibal`,description:`Find queries with material exposure across multiple URLs`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`minImpressions`,`refresh`],{minImpressions:{description:`Minimum query impressions. Defaults to 50.`}}),"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=j(e),n=E(e.refresh),r=M(T(e.site)),i=await Tn({site:r,days:k(e.days,`--days`),limit:k(e.limit,`--limit`),minImpressions:k(e[`min-impressions`],`--min-impressions`),brandTerms:[...A(e[`brand-terms`])??[]],includeBrand:E(e[`include-brand`]),refresh:n});t?L(i):(K({title:`Cannibalisation report`,target:i.site,status:i.dataStatus===`complete`?`info`:`unknown`,summary:i.summary.verdict,metrics:[{label:`Evidence`,value:i.dataStatus},{label:`Range`,value:`${i.range.startDate} to ${i.range.endDate}`},{label:`Eligible`,value:U(i.summary.eligibleClusters)},{label:`Returned`,value:U(i.summary.returnedClusters)},{label:`Suppressed brand queries`,value:U(i.summary.suppressedQueries)},{label:`GSC completeness`,value:i.source.completeness},{label:`Brand queries`,value:E(e[`include-brand`])?`included`:`excluded`}]}),q([`Query`,`URLs`,`Property impr`,`Exposure`,`HHI`,`Review first`],i.items.map(e=>[G(e.query,42),e.pages.length,e.propertyImpressions===void 0?`n/a`:U(e.propertyImpressions),U(e.pageExposureImpressions),e.hhi.toFixed(2),G(e.suggestedOwnerUrl,56)])),J(`Top cannibalisation actions`,i.items.map(e=>({label:e.query,context:`${e.pages.length} material URLs; first review ${G(e.suggestedOwnerUrl,64)}`,action:e.recommendation.action}))),Y(`Report caveats`,i.caveats),Y(`Provider usage`,[i.ledgerSummary]))}}),uc=x({meta:{name:`ctr-underperformers`,description:`Find high-impression queries with weak CTR for their position`},args:{site:{type:`string`},...X([`includeBrand`,`minImpressions`],{minImpressions:{description:`Minimum query impressions. Defaults to 1 per 5,000 retained impressions, from 30 to 200.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=j(e),n=M(T(e.site)),r=await at({site:n,minImpressions:O(e[`min-impressions`]),includeBrand:E(e[`include-brand`])});t?L(r):(K({title:`CTR underperformers`,target:r.site,status:r.dataStatus===`partial`?`unknown`:`info`,summary:r.summary.verdict,metrics:[{label:`Underperformers`,value:U(r.summary.underperformers)},{label:`Estimated click gap`,value:U(r.summary.estimatedClickShortfall)},{label:`Brand queries`,value:r.summary.brandFiltering},{label:`Evidence`,value:r.dataStatus},{label:`GSC completeness`,value:r.source.completeness}]}),Y(`Why this matters`,[`These queries already have visibility; the fastest win is usually better SERP framing, not new content.`,`Start with high-impression rows where actual CTR is far below the expected CTR for that ranking position.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),q([`Query`,`URL`,`Pos`,`Impr`,`CTR`,`Expected`,`Gap`,`Action`],r.items.map(e=>[G(e.query,36),G(e.url,48),qa(e.position),U(e.impressions),W(e.actualCtr),W(e.expectedCtr),U(e.clickShortfall),G(e.recommendation.action,72)])),J(`Top CTR actions`,r.items.map(e=>({label:e.query,context:`${U(e.clickShortfall)} click gap, ${W(e.actualCtr)} CTR`,action:e.recommendation.action}))))}});function dc(e){return e>0?qa(e):`n/a`}const fc=x({meta:{name:`decaying`,description:`Find query/page rows losing clicks between two GSC windows`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`refresh`]),comparison:{type:`string`,description:`Comparison: previous-period or year-over-year.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},"min-drop-pct":{type:`string`,description:`Minimum click drop percentage. Defaults to 20.`},"min-previous-clicks":{type:`string`,description:`Minimum previous-window clicks for a query/page row. Defaults to 2.`},"min-click-loss":{type:`string`,description:`Minimum absolute click loss. Defaults to 1.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=j(e),n=E(e.refresh),r=T(e.comparison),i=k(e.days,`--days`),a=k(e.limit,`--limit`),o=k(e[`min-drop-pct`],`--min-drop-pct`),s=k(e[`min-previous-clicks`],`--min-previous-clicks`),c=k(e[`min-click-loss`],`--min-click-loss`);if(r!==void 0&&r!==`previous-period`&&r!==`year-over-year`)throw new _(`INVALID_INPUT`,`--comparison must be previous-period or year-over-year.`);let l=M(T(e.site)),u=await ye({site:l,days:i,limit:a,comparison:r,brandTerms:[...A(e[`brand-terms`])??[]],includeBrand:E(e[`include-brand`]),minDropPct:o,minPreviousClicks:s,minClickLoss:c,refresh:n});t?L(u):(K({title:`Decaying pages`,target:u.site,status:u.dataStatus===`complete`?u.summary.returnedRows>0?`warning`:`pass`:`unknown`,summary:u.summary.verdict,metrics:[{label:`Evidence`,value:u.dataStatus},{label:`Comparison`,value:u.comparison},{label:`Observed declines`,value:U(u.summary.returnedRows)},{label:`Eligible declines`,value:U(u.summary.eligibleRows)},{label:`Decay clusters`,value:U(u.summary.groups)},{label:`Observed click decline`,value:U(u.summary.returnedObservedRetainedQueryClickLoss)},{label:`Eligible click decline`,value:U(u.summary.observedRetainedQueryClickLoss)},{label:`Brand queries`,value:u.summary.brandFiltering},{label:`Minimum drop`,value:`${u.filters.minDropPct}%`},{label:`Minimum previous clicks`,value:U(u.filters.minPreviousClicks)},{label:`GSC completeness`,value:u.source.completeness}]}),Y(`Why this matters`,[`This report compares retained query/page rows and only counts declines observed in both windows.`,`Position, CTR, and impression movements are signals for investigation, not proof of cause.`]),Y(`Recommended actions`,u.recommendations),Y(`Report caveats`,u.caveats),Y(`Warnings`,u.warnings),u.items.length&&(u.groups.length&&(q([`Cluster`,`Rows`,`Observed loss`,`Drop`,`Sample query`,`Action`],u.groups.map(e=>[G(e.label,42),U(e.count),U(e.totalClickLoss),`${e.averageDropPct.toFixed(1)}%`,G(e.sampleQueries[0]??`-`,40),G(e.recommendation,72)])),J(`Top decay cluster actions`,u.groups.map(e=>({label:e.label,context:`${U(e.count)} retained rows, ${U(e.totalClickLoss)} observed click decline`,action:e.recommendation})))),q([`Query`,`Template`,`URL`,`Signals`,`Decline`,`Clicks`,`Impr`,`CTR`,`Pos`,`Action`],u.items.map(e=>[G(e.query,32),G(e.template.label,26),G(e.url,44),e.signals.join(`, `),U(e.clickLoss),`${U(e.previous.clicks)} -> ${U(e.current.clicks)}`,`${U(e.previous.impressions)} -> ${U(e.current.impressions)}`,`${W(e.previous.ctr)} -> ${W(e.current.ctr)}`,`${dc(e.previous.position)} -> ${dc(e.current.position)}`,G(e.recommendation.action,64)])),J(`Top decay actions`,u.items.map(e=>({label:e.query,context:`${e.template.label}, ${U(e.clickLoss)} fewer observed clicks`,action:e.recommendation.action})))))}}),pc=x({meta:{name:`internal-links`,description:`Internal links to add across a site (--site) or to one page (--url), placed in real sentences`},args:{site:{type:`string`,description:`Site to audit: a domain, URL or Search Console property.`},url:{type:`string`,description:`One page to find internal links to.`},"max-pages":{type:`string`,description:`Site audits only: pages to crawl, 500 by default, up to 5,000.`},...pa,...ma,refresh:{type:`boolean`,default:!1,description:`Bypass the local cache and fetch fresh data.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=E(e.refresh),r=T(e.url),i=T(e.site);if(!!r==!!i)throw new _(`INVALID_INPUT`,`Send --site to audit a whole site, or --url to find links to one page.`);let a=T(e[`max-pages`]),o=a===void 0?void 0:O(a);if(a!==void 0&&o===void 0)throw new _(`INVALID_INPUT`,`--max-pages is a whole number.`);let s=r??i,l=await c({site:s,targetUrl:r,maxPages:o,startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),refresh:n},{...await ee({site:s,refresh:n}),progress:ca(!t&&process.stderr.isTTY)});if(t){L(l);return}let u={...r?{url:r}:{site:i},...o===void 0?{}:{"max-pages":o}};process.stdout.write(`${vn(l,{detail:V(e),offset:O(e.offset)??0,more:(e,t)=>da(`internal-links`,{...u,detail:e,offset:t})})}\n`)}}),mc=x({meta:{name:`page-opportunities`,description:`Find first-party traffic growth opportunities for one URL`},args:{site:{type:`string`},url:{type:`string`,required:!0},...X([`days`,`limit`,`minImpressions`,`includeBrand`,`js`,`refresh`],{limit:{description:`Maximum page queries to inspect. Defaults to 25.`},minImpressions:{description:`Minimum query impressions. Defaults to 10.`},includeBrand:{description:`Include branded queries in page opportunity reports.`},js:{description:`Force JavaScript rendering for page extraction.`},refresh:{description:`Bypass local GSC and HTTP cache.`}}),"verify-content":li(`Fetch the page for title/H1/body checks. Defaults to true.`,`Skip fetching the page for title/H1/body checks.`),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=j(e),n=M(T(e.site)),r=await He({site:n,url:T(e.url)??``,days:O(e.days),limit:O(e.limit),minImpressions:O(e[`min-impressions`]),includeBrand:E(e[`include-brand`]),verifyContent:E(e[`verify-content`])!==!1,js:E(e.js)?!0:`auto`,refresh:E(e.refresh)});t?L(r):(K({title:`Page opportunities`,target:r.url,status:r.verification.status===`failed`?`unknown`:`info`,summary:r.summary.verdict,metrics:[{label:`Title`,value:r.page?.title??`Not fetched`},{label:`Fetch`,value:So(r.page?.fetchDiagnostics)},{label:`Verification`,value:r.verification.status},{label:`Rows`,value:`${U(r.selection.returnedRows)} returned / ${U(r.selection.eligibleRows)} eligible / ${U(r.selection.sourceRows)} source`},{label:`Queries`,value:U(r.summary.queries)},{label:`Impressions`,value:U(r.summary.impressions)},{label:`Opportunities`,value:U(r.summary.opportunities)},{label:`CTR shortfall`,value:U(r.summary.estimatedCtrClickShortfall)},{label:`Focus`,value:r.summary.focus},{label:`Evidence`,value:r.dataStatus}]}),Y(`Why this matters`,[`This report starts from queries where this exact URL already has impressions, so recommendations stay tied to first-party demand.`,`Content verification separates body gaps from title/meta framing issues, which helps avoid adding copy when the page already covers the query.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),r.items.length?(q([`Type`,`Query`,`Evidence`,`Pos`,`CTR`,`Expected`,`Impr`,`Shortfall`,`Action`],r.items.map(e=>[e.opportunityType,G(e.query,38),e.verification.signals.length?e.verification.signals.join(`, `):e.verification.status,e.position.toFixed(1),W(e.ctr),e.expectedCtr===void 0?`n/a`:W(e.expectedCtr),U(e.impressions),e.estimatedCtrClickShortfall===void 0?`n/a`:U(e.estimatedCtrClickShortfall),G(e.recommendation,72)])),J(`Top page actions`,r.items.map(e=>({label:e.query,context:`${e.opportunityType}, ${U(e.impressions)} impressions`,action:e.recommendation})))):process.stdout.write(r.dataStatus===`empty`?`No GSC query rows found for this exact URL.
 `:`GSC rows were found, but none met the report criteria.
-`))}}),Ks=y({meta:{name:`query-cluster`,description:`Cluster GSC queries into repeated demand themes`},args:{site:{type:`string`},scope:{type:`string`},...X([`includeBrand`,`minImpressions`,`limit`],{includeBrand:{description:`Include branded queries in query clustering.`},minImpressions:{description:`Minimum impressions per query. Defaults to 25.`},limit:{description:`Maximum clusters to return. Defaults to 25; max 100.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=k(e),n=A(C(e.site)),r=await qe({site:n,scope:C(e.scope),includeBrand:w(e[`include-brand`]),minImpressions:E(e[`min-impressions`]),limit:E(e.limit)});t?F(r):(K({title:`Query clusters`,target:r.site,status:`info`,summary:r.summary.verdict,metrics:[{label:`Scope`,value:r.scope??`All pages`},{label:`Clusters`,value:U(r.summary.clusters)},{label:`Queries`,value:U(r.summary.queries)},{label:`Impressions`,value:U(r.summary.impressions)},{label:`Clicks`,value:U(r.summary.clicks)},{label:`Minimum impressions`,value:U(r.summary.minImpressions)},{label:`Result limit`,value:U(r.summary.limit)},{label:`High opportunity`,value:U(r.summary.highOpportunityClusters)},{label:`Brand queries`,value:r.summary.brandFiltering}]}),Y(`Why this matters`,[`Clusters show repeated demand themes, so they are better inputs for page sections, hubs, and templates than one-off query exports.`,`Prioritise clusters with high impressions and low clicks; they usually reveal unclear intent coverage or weak SERP framing.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),q([`Cluster`,`Intent`,`Queries`,`Impr`,`CTR`,`Expected`,`Lift`,`Action`],r.clusters.map(e=>[G(e.label,32),e.intent,e.queries.length,U(e.totals?.impressions??0),W(e.totals?.ctr??0),W(e.benchmark?.expectedCtr??0),e.estimatedClickLift===void 0?`-`:U(e.estimatedClickLift),G(e.recommendation??``,72)])),J(`Top cluster actions`,r.clusters.map(e=>({label:e.label,context:`${U(e.totals?.impressions??0)} impressions, ${e.estimatedClickLift===void 0?`ranking opportunity`:`${U(e.estimatedClickLift)} estimated click lift`}`,action:e.recommendation??``}))))}}),qs=y({meta:{name:`quick-wins`,description:`Find high-ranking low-CTR query/page opportunities`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`minImpressions`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=k(e),n=E(e[`verify-limit`]),r=w(e[`verify-content`])===!0||n!==void 0,i=A(C(e.site)),a=await ae({site:i,days:E(e.days),limit:E(e.limit),minImpressions:E(e[`min-impressions`]),brandTerms:[...O(e[`brand-terms`])??[]],includeBrand:w(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:w(e.js)?!0:void 0,rate:ri(e),refresh:w(e.refresh)});t?F(a):(K({title:`Quick wins`,target:a.site,status:a.source.possiblyTruncated?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible rows`,value:U(a.summary.eligibleRows)},{label:`Returned rows`,value:U(a.summary.returnedRows)},{label:`Query clusters`,value:U(a.summary.repeatedQueryGroups)},{label:`Template patterns`,value:U(a.summary.templatePatterns)},{label:`CTR click shortfall`,value:U(a.summary.returnedEstimatedCtrClickShortfall)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Evidence`,value:a.dataStatus},{label:`Verification`,value:Pa(a)}]}),Y(`Why this matters`,[`These rows have GSC average positions from 4 to 10 and observed CTR below a site-peer or versioned fallback target.`,`Page evidence is needed before treating a CTR shortfall as a title, content, or technical finding.`]),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),a.items.length&&(a.templateRecommendations.length&&(q([`Template`,`URLs`,`Rows`,`Shortfall`,`Impr`,`Action`],a.templateRecommendations.map(e=>[G(e.templateLabel,34),U(e.urlCount),U(e.rowCount),U(e.totalEstimatedCtrClickShortfall),U(e.totalImpressions),G(e.action,72)])),J(`Top template actions`,a.templateRecommendations.map(e=>({label:e.templateLabel,context:`${U(e.urlCount)} URLs, ${U(e.totalEstimatedCtrClickShortfall)} heuristic CTR click shortfall`,action:`${e.action} ${e.evidence}`})))),a.groups.length&&(q([`Cluster`,`URLs`,`Rows`,`Shortfall`,`Impr`,`Sample URL`,`Action`],a.groups.map(e=>[G(e.label,44),U(e.urlCount),U(e.rowCount),U(e.totalEstimatedCtrClickShortfall),U(e.totalImpressions),G(e.sampleUrls[0]??`-`,46),G(e.recommendation,72)])),J(`Top cluster actions`,a.groups.map(e=>({label:e.label,context:`${U(e.urlCount)} URLs, ${U(e.totalEstimatedCtrClickShortfall)} heuristic CTR click shortfall`,action:e.recommendation})))),q([`Query`,`Template`,`URL`,`Pos`,`Impr`,`CTR / target`,`Shortfall`,`Fetch`,`Check`,`Action`],a.items.map(e=>[G(e.query,36),G(e.template.label,24),G(e.url,48),Na(e.position),U(e.impressions),`${W(e.ctr)} / ${W(e.targetCtr)}`,U(e.estimatedCtrClickShortfall),to(e.contentVerification?.fetchDiagnostics),no(e.contentVerification?.classification),G(e.recommendation.action,64)])),J(`Top opportunity actions`,a.items.map(e=>({label:e.query,context:`${e.template.label}, pos ${Na(e.position)}, ${U(e.impressions)} impressions`,action:e.recommendation.action})))))}}),Js=y({meta:{name:`second-page`,description:`Find URLs averaging positions above 10 through 20 in GSC`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`range`,`minImpressions`,`limit`,`includeBrand`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=E(e[`verify-limit`]),r=w(e[`verify-content`])===!0||n!==void 0,i=A(C(e.site)),a=await Ln({site:i,range:E(e.days),minImpressions:E(e[`min-impressions`]),limit:C(e.limit)?Number(C(e.limit)):10,includeBrand:w(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:w(e.js)?!0:void 0,rate:ri(e),refresh:w(e.refresh)});t?F(a):(K({title:`Second-page opportunities`,target:a.site,status:a.source.possiblyTruncated||a.summary.fetchFailures>0?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible pages`,value:U(a.summary.eligiblePages)},{label:`Returned pages`,value:U(a.summary.returnedPages)},{label:`Eligible queries`,value:U(a.summary.eligibleQueries)},{label:`Impressions`,value:U(a.summary.eligibleImpressions)},{label:`Content issues`,value:U(a.summary.contentIssues)},{label:`Technical issues`,value:U(a.summary.technicalIssues)},{label:`Fetch failures`,value:U(a.summary.fetchFailures)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Evidence`,value:a.dataStatus},{label:`Verification`,value:Pa(a)}]}),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),a.items.length?(q([`Query`,`Template`,`Pos`,`Impr`,`CTR`,`Queries`,`Fetch`,`Check`,`Action`],a.items.map(e=>[e.primaryQuery,e.template.label,e.position.toFixed(1),Math.round(e.impressions),e.ctr.toFixed(3),U(e.queryCount),to(e.fetchDiagnostics),no(e.contentVerification?.classification),e.recommendation.action])),J(`Top second-page actions`,a.items.map(e=>({label:e.primaryQuery,context:`${e.template.label}, pos ${Na(e.position)}, ${U(e.impressions)} impressions`,action:e.recommendation.action}))),process.stdout.write(`${a.ledgerSummary}\n`)):(process.stdout.write(`No average-position candidates matched this report.
-`),process.stdout.write(`${a.ledgerSummary}\n`)))}}),Ys=y({meta:{name:`audit-page`,description:`Fetch one page and audit title, metadata, content, links, and schema`},args:{url:{type:`string`,required:!0,description:`URL to audit.`},site:{type:`string`,description:`Optional GSC property for page search metrics, for example sc-domain:example.com.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for extraction.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache.`}},run:async({args:e})=>{let t=await Dt({url:C(e.url)??``,site:C(e.site),js:w(e.js)?!0:`auto`,refresh:w(e.refresh)});k(e)?F(t):K({title:`Page audit`,target:t.url,status:t.issues.some(e=>e.severity===`high`)?`fail`:t.issues.length>0?`warning`:`pass`,summary:t.issues.length>0?`${t.issues.length} ${t.issues.length===1?`issue needs`:`issues need`} review.`:`No page issues were found by the available checks.`,metrics:[{label:`Final URL`,value:t.page.finalUrl},{label:`Title`,value:t.page.title??`Missing`},{label:`Meta description`,value:t.page.metaDescription??`Missing`},{label:`Words`,value:t.page.wordCount},{label:`Fetch`,value:to(t.fetchDiagnostics)}],diagnostics:[{title:`Issues`,items:t.issues.map(e=>({status:e.severity===`high`?`fail`:`warning`,title:`${e.code}: ${e.principle}`,explanation:e.detail}))}]})}});function Xs(e){let t=C(e)??`mobile`;if(t!==`mobile`&&t!==`desktop`)throw new h(`INVALID_INPUT`,`Invalid --strategy. Use mobile or desktop.`);return t}function Zs(e){return e?e.displayValue??String(e.value??`not measured`):`not measured`}function Qs(e){if(!e)return`not available`;let t=e.unit===`milliseconds`?`ms`:``;return`${e.p75}${t} (${e.rating})`}const $s=y({meta:{name:`perf`,description:`Audit lab performance and field Core Web Vitals`},subCommands:{audit:y({meta:{name:`audit`,description:`Run a Lighthouse/Core Web Vitals performance audit`},args:{url:{type:`string`,description:`URL to audit.`},strategy:{type:`string`,default:`mobile`,description:`Audit strategy: mobile or desktop.`},"lighthouse-bin":{type:`string`,description:`Custom Lighthouse binary path. Defaults to the bundled version.`},"crux-key":{type:`string`,description:`CrUX API key. Prefer SEO_CRUX_API_KEY to avoid shell history.`},raw:{type:`boolean`,default:!1,description:`Include the full Lighthouse JSON in JSON output.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local performance report cache.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=k(e),n=C(e.url);if(!n)throw new h(`INVALID_INPUT`,`No URL given. Pass --url.`);let r=await m({url:n,strategy:Xs(e.strategy),lighthouseBin:C(e[`lighthouse-bin`]),cruxApiKey:C(e[`crux-key`]),refresh:w(e.refresh),includeRaw:t&&w(e.raw)});t?F(r):(K({title:`Performance report`,target:r.url,status:r.dataStatus===`partial`?`unknown`:r.grade===`good`?`pass`:`warning`,summary:r.headline,metrics:[{label:`Source`,value:r.source},{label:`Strategy`,value:r.strategy},{label:`Lab score`,value:r.score===void 0?`Unknown`:`${r.score}/100`},{label:`Lab grade`,value:r.grade},{label:`Evidence`,value:r.dataStatus},{label:`FCP`,value:Zs(r.metrics.firstContentfulPaint)},{label:`LCP`,value:Zs(r.metrics.largestContentfulPaint)},{label:`TBT`,value:Zs(r.metrics.totalBlockingTime)},{label:`CLS`,value:Zs(r.metrics.cumulativeLayoutShift)},{label:`INP`,value:Zs(r.metrics.interactionToNextPaint)},{label:`Server response`,value:Zs(r.metrics.serverResponseTime)},{label:`Fallback fetch`,value:Zs(r.metrics.fallbackFetchDuration)},{label:`Field data`,value:r.fieldData?`${r.fieldData.scope} ${r.fieldData.formFactor.toLowerCase()} (${r.fieldData.assessment.status})`:r.fieldDataStatus.status},{label:`Field LCP p75`,value:Qs(r.fieldData?.metrics.largestContentfulPaint)},{label:`Field INP p75`,value:Qs(r.fieldData?.metrics.interactionToNextPaint)},{label:`Field CLS p75`,value:Qs(r.fieldData?.metrics.cumulativeLayoutShift)},{label:`Field period`,value:r.fieldData?.collectionPeriod?.firstDate&&r.fieldData.collectionPeriod.lastDate?`${r.fieldData.collectionPeriod.firstDate} to ${r.fieldData.collectionPeriod.lastDate}`:`Unavailable`}]}),J(`Top actions`,r.topActions.map(e=>({label:e.title,action:e.action,context:e.plainEnglish}))),Y(`Caveats`,r.caveats))}})}}),ec=y({meta:{name:`doctor`,description:`Check local auth, scopes, config, and defaults`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Fn();k(e)?(F(t),t.ok||(process.exitCode=1)):(Vi(`SEO doctor`,Ni(t.checks)),process.stdout.write(`
-`),Hi(t.checks),process.stdout.write(`\nChecked ${t.generatedAt}\n`),t.ok||(process.exitCode=1))}}),tc=e=>{let t=C(e)??`page`;if(t!==`page`&&t!==`query`&&t!==`country`&&t!==`device`)throw Error(`Invalid --dimension. Use page, query, country, or device.`);return t},nc=y({meta:{name:`segment-impact`,description:`Compare GSC movement by page, query, device, or country`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},dimension:{type:`string`,default:`page`,description:`Segment by page, query, country, or device.`},...X([`days`,`limit`,`refresh`],{days:{description:`Recent window length from 1 to 240 days. Defaults to 28.`},limit:{description:`Maximum segment rows to print. Defaults to 25.`},refresh:{description:`Bypass local cache and fetch fresh GSC data.`}}),compare:{type:`string`,description:`Legacy 1-240 day comparison length. Must equal the current window.`},"start-date":{type:`string`,description:`Exact current-window start date in YYYY-MM-DD format.`},"end-date":{type:`string`,description:`Exact current-window end date in YYYY-MM-DD format.`},"max-rows":{type:`string`,description:`Maximum retained GSC rows per window. Defaults to 100000.`},"unmatched-limit":{type:`string`,description:`Maximum one-window evidence rows to return. Defaults to 25.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=tc(e.dimension),r=D(e.days,`--days`),i=D(e.compare,`--compare`),a=D(e.limit,`--limit`),o=D(e[`unmatched-limit`],`--unmatched-limit`),s=D(e[`max-rows`],`--max-rows`),c=A(C(e.site)),l=await Ve({site:c,dimension:n,days:r,compareDays:i,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),limit:a,unmatchedLimit:o,maxRows:s,refresh:w(e.refresh)});t?F(l):(K({title:`Segment impact`,target:l.site,status:l.dataStatus===`complete`?`info`:`unknown`,summary:l.summary.verdict,metrics:[{label:`Dimension`,value:l.dimension},{label:`Evidence`,value:l.dataStatus},{label:`Before`,value:`${l.before.startDate} to ${l.before.endDate}`},{label:`After`,value:`${l.after.startDate} to ${l.after.endDate}`}]}),L([`Segment`,`Clicks before`,`Clicks after`,`Delta`,`Pos delta`],l.items.map(e=>[e.key,e.beforeClicks,e.afterClicks,e.clickDelta,e.positionDelta??`-`])),l.unmatchedSegments.length&&(process.stdout.write(`
+`))}}),hc=x({meta:{name:`query-cluster`,description:`Cluster GSC queries into repeated demand themes`},args:{site:{type:`string`},scope:{type:`string`},...X([`includeBrand`,`minImpressions`,`limit`],{includeBrand:{description:`Include branded queries in query clustering.`},minImpressions:{description:`Minimum impressions per query. Defaults to 25.`},limit:{description:`Maximum clusters to return. Defaults to 25; max 100.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=j(e),n=M(T(e.site)),r=await a({site:n,scope:T(e.scope),includeBrand:E(e[`include-brand`]),minImpressions:O(e[`min-impressions`]),limit:O(e.limit)});t?L(r):(K({title:`Query clusters`,target:r.site,status:`info`,summary:r.summary.verdict,metrics:[{label:`Scope`,value:r.scope??`All pages`},{label:`Clusters`,value:U(r.summary.clusters)},{label:`Queries`,value:U(r.summary.queries)},{label:`Impressions`,value:U(r.summary.impressions)},{label:`Clicks`,value:U(r.summary.clicks)},{label:`Minimum impressions`,value:U(r.summary.minImpressions)},{label:`Result limit`,value:U(r.summary.limit)},{label:`High opportunity`,value:U(r.summary.highOpportunityClusters)},{label:`Brand queries`,value:r.summary.brandFiltering}]}),Y(`Why this matters`,[`Clusters show repeated demand themes, so they are better inputs for page sections, hubs, and templates than one-off query exports.`,`Prioritise clusters with high impressions and low clicks; they usually reveal unclear intent coverage or weak SERP framing.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),q([`Cluster`,`Intent`,`Queries`,`Impr`,`CTR`,`Expected`,`Lift`,`Action`],r.clusters.map(e=>[G(e.label,32),e.intent,e.queries.length,U(e.totals?.impressions??0),W(e.totals?.ctr??0),W(e.benchmark?.expectedCtr??0),e.estimatedClickLift===void 0?`-`:U(e.estimatedClickLift),G(e.recommendation??``,72)])),J(`Top cluster actions`,r.clusters.map(e=>({label:e.label,context:`${U(e.totals?.impressions??0)} impressions, ${e.estimatedClickLift===void 0?`ranking opportunity`:`${U(e.estimatedClickLift)} estimated click lift`}`,action:e.recommendation??``}))))}}),gc=x({meta:{name:`quick-wins`,description:`Find high-ranking low-CTR query/page opportunities`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`minImpressions`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=j(e),n=O(e[`verify-limit`]),r=E(e[`verify-content`])===!0||n!==void 0,i=M(T(e.site)),a=await se({site:i,days:O(e.days),limit:O(e.limit),minImpressions:O(e[`min-impressions`]),brandTerms:[...A(e[`brand-terms`])??[]],includeBrand:E(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:E(e.js)?!0:void 0,rate:mi(e),refresh:E(e.refresh)});t?L(a):(K({title:`Quick wins`,target:a.site,status:a.source.possiblyTruncated?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible rows`,value:U(a.summary.eligibleRows)},{label:`Returned rows`,value:U(a.summary.returnedRows)},{label:`Query clusters`,value:U(a.summary.repeatedQueryGroups)},{label:`Template patterns`,value:U(a.summary.templatePatterns)},{label:`CTR click shortfall`,value:U(a.summary.returnedEstimatedCtrClickShortfall)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Evidence`,value:a.dataStatus},{label:`Verification`,value:Ja(a)}]}),Y(`Why this matters`,[`These rows have GSC average positions from 4 to 10 and observed CTR below a site-peer or versioned fallback target.`,`Page evidence is needed before treating a CTR shortfall as a title, content, or technical finding.`]),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),a.items.length&&(a.templateRecommendations.length&&(q([`Template`,`URLs`,`Rows`,`Shortfall`,`Impr`,`Action`],a.templateRecommendations.map(e=>[G(e.templateLabel,34),U(e.urlCount),U(e.rowCount),U(e.totalEstimatedCtrClickShortfall),U(e.totalImpressions),G(e.action,72)])),J(`Top template actions`,a.templateRecommendations.map(e=>({label:e.templateLabel,context:`${U(e.urlCount)} URLs, ${U(e.totalEstimatedCtrClickShortfall)} heuristic CTR click shortfall`,action:`${e.action} ${e.evidence}`})))),a.groups.length&&(q([`Cluster`,`URLs`,`Rows`,`Shortfall`,`Impr`,`Sample URL`,`Action`],a.groups.map(e=>[G(e.label,44),U(e.urlCount),U(e.rowCount),U(e.totalEstimatedCtrClickShortfall),U(e.totalImpressions),G(e.sampleUrls[0]??`-`,46),G(e.recommendation,72)])),J(`Top cluster actions`,a.groups.map(e=>({label:e.label,context:`${U(e.urlCount)} URLs, ${U(e.totalEstimatedCtrClickShortfall)} heuristic CTR click shortfall`,action:e.recommendation})))),q([`Query`,`Template`,`URL`,`Pos`,`Impr`,`CTR / target`,`Shortfall`,`Fetch`,`Check`,`Action`],a.items.map(e=>[G(e.query,36),G(e.template.label,24),G(e.url,48),qa(e.position),U(e.impressions),`${W(e.ctr)} / ${W(e.targetCtr)}`,U(e.estimatedCtrClickShortfall),So(e.contentVerification?.fetchDiagnostics),Co(e.contentVerification?.classification),G(e.recommendation.action,64)])),J(`Top opportunity actions`,a.items.map(e=>({label:e.query,context:`${e.template.label}, pos ${qa(e.position)}, ${U(e.impressions)} impressions`,action:e.recommendation.action})))))}}),_c=x({meta:{name:`second-page`,description:`Find URLs averaging positions above 10 through 20 in GSC`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`range`,`minImpressions`,`limit`,`includeBrand`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=O(e[`verify-limit`]),r=E(e[`verify-content`])===!0||n!==void 0,i=M(T(e.site)),a=await nn({site:i,range:O(e.days),minImpressions:O(e[`min-impressions`]),limit:T(e.limit)?Number(T(e.limit)):10,includeBrand:E(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:E(e.js)?!0:void 0,rate:mi(e),refresh:E(e.refresh)});t?L(a):(K({title:`Second-page opportunities`,target:a.site,status:a.source.possiblyTruncated||a.summary.fetchFailures>0?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible pages`,value:U(a.summary.eligiblePages)},{label:`Returned pages`,value:U(a.summary.returnedPages)},{label:`Eligible queries`,value:U(a.summary.eligibleQueries)},{label:`Impressions`,value:U(a.summary.eligibleImpressions)},{label:`Content issues`,value:U(a.summary.contentIssues)},{label:`Technical issues`,value:U(a.summary.technicalIssues)},{label:`Fetch failures`,value:U(a.summary.fetchFailures)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Evidence`,value:a.dataStatus},{label:`Verification`,value:Ja(a)}]}),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),a.items.length?(q([`Query`,`Template`,`Pos`,`Impr`,`CTR`,`Queries`,`Fetch`,`Check`,`Action`],a.items.map(e=>[e.primaryQuery,e.template.label,e.position.toFixed(1),Math.round(e.impressions),e.ctr.toFixed(3),U(e.queryCount),So(e.fetchDiagnostics),Co(e.contentVerification?.classification),e.recommendation.action])),J(`Top second-page actions`,a.items.map(e=>({label:e.primaryQuery,context:`${e.template.label}, pos ${qa(e.position)}, ${U(e.impressions)} impressions`,action:e.recommendation.action}))),process.stdout.write(`${a.ledgerSummary}\n`)):(process.stdout.write(`No average-position candidates matched this report.
+`),process.stdout.write(`${a.ledgerSummary}\n`)))}}),vc=x({meta:{name:`audit-page`,description:`Fetch one page and audit title, metadata, content, links, and schema`},args:{url:{type:`string`,required:!0,description:`URL to audit.`},site:{type:`string`,description:`Optional GSC property for page search metrics, for example sc-domain:example.com.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for extraction.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache.`}},run:async({args:e})=>{let t=await u({url:T(e.url)??``,site:T(e.site),js:E(e.js)?!0:`auto`,refresh:E(e.refresh)});j(e)?L(t):K({title:`Page audit`,target:t.url,status:t.issues.some(e=>e.severity===`high`)?`fail`:t.issues.length>0?`warning`:`pass`,summary:t.issues.length>0?`${t.issues.length} ${t.issues.length===1?`issue needs`:`issues need`} review.`:`No page issues were found by the available checks.`,metrics:[{label:`Final URL`,value:t.page.finalUrl},{label:`Title`,value:t.page.title??`Missing`},{label:`Meta description`,value:t.page.metaDescription??`Missing`},{label:`Words`,value:t.page.wordCount},{label:`Fetch`,value:So(t.fetchDiagnostics)}],diagnostics:[{title:`Issues`,items:t.issues.map(e=>({status:e.severity===`high`?`fail`:`warning`,title:`${e.code}: ${e.principle}`,explanation:e.detail}))}]})}});function yc(e){let t=T(e)??`mobile`;if(t!==`mobile`&&t!==`desktop`)throw new _(`INVALID_INPUT`,`Invalid --strategy. Use mobile or desktop.`);return t}function bc(e){return e?e.displayValue??String(e.value??`not measured`):`not measured`}function xc(e){if(!e)return`not available`;let t=e.unit===`milliseconds`?`ms`:``;return`${e.p75}${t} (${e.rating})`}const Sc=x({meta:{name:`perf`,description:`Audit lab performance and field Core Web Vitals`},subCommands:{audit:x({meta:{name:`audit`,description:`Run a Lighthouse/Core Web Vitals performance audit`},args:{url:{type:`string`,description:`URL to audit.`},strategy:{type:`string`,default:`mobile`,description:`Audit strategy: mobile or desktop.`},"lighthouse-bin":{type:`string`,description:`Custom Lighthouse binary path. Defaults to the bundled version.`},"crux-key":{type:`string`,description:`CrUX API key. Prefer SEO_CRUX_API_KEY to avoid shell history.`},raw:{type:`boolean`,default:!1,description:`Include the full Lighthouse JSON in JSON output.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local performance report cache.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=j(e),n=T(e.url);if(!n)throw new _(`INVALID_INPUT`,`No URL given. Pass --url.`);let r=await $t({url:n,strategy:yc(e.strategy),lighthouseBin:T(e[`lighthouse-bin`]),cruxApiKey:T(e[`crux-key`]),refresh:E(e.refresh),includeRaw:t&&E(e.raw)});t?L(r):(K({title:`Performance report`,target:r.url,status:r.dataStatus===`partial`?`unknown`:r.grade===`good`?`pass`:`warning`,summary:r.headline,metrics:[{label:`Source`,value:r.source},{label:`Strategy`,value:r.strategy},{label:`Lab score`,value:r.score===void 0?`Unknown`:`${r.score}/100`},{label:`Lab grade`,value:r.grade},{label:`Evidence`,value:r.dataStatus},{label:`FCP`,value:bc(r.metrics.firstContentfulPaint)},{label:`LCP`,value:bc(r.metrics.largestContentfulPaint)},{label:`TBT`,value:bc(r.metrics.totalBlockingTime)},{label:`CLS`,value:bc(r.metrics.cumulativeLayoutShift)},{label:`INP`,value:bc(r.metrics.interactionToNextPaint)},{label:`Server response`,value:bc(r.metrics.serverResponseTime)},{label:`Fallback fetch`,value:bc(r.metrics.fallbackFetchDuration)},{label:`Field data`,value:r.fieldData?`${r.fieldData.scope} ${r.fieldData.formFactor.toLowerCase()} (${r.fieldData.assessment.status})`:r.fieldDataStatus.status},{label:`Field LCP p75`,value:xc(r.fieldData?.metrics.largestContentfulPaint)},{label:`Field INP p75`,value:xc(r.fieldData?.metrics.interactionToNextPaint)},{label:`Field CLS p75`,value:xc(r.fieldData?.metrics.cumulativeLayoutShift)},{label:`Field period`,value:r.fieldData?.collectionPeriod?.firstDate&&r.fieldData.collectionPeriod.lastDate?`${r.fieldData.collectionPeriod.firstDate} to ${r.fieldData.collectionPeriod.lastDate}`:`Unavailable`}]}),J(`Top actions`,r.topActions.map(e=>({label:e.title,action:e.action,context:e.plainEnglish}))),Y(`Caveats`,r.caveats))}})}}),Cc=x({meta:{name:`doctor`,description:`Check local auth, scopes, config, and defaults`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Wn();j(e)?(L(t),t.ok||(process.exitCode=1)):($i(`SEO doctor`,Wi(t.checks)),process.stdout.write(`
+`),ea(t.checks),process.stdout.write(`\nChecked ${t.generatedAt}\n`),t.ok||(process.exitCode=1))}}),wc=e=>{let t=T(e)??`page`;if(t!==`page`&&t!==`query`&&t!==`country`&&t!==`device`)throw Error(`Invalid --dimension. Use page, query, country, or device.`);return t},Tc=x({meta:{name:`segment-impact`,description:`Compare GSC movement by page, query, device, or country`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},dimension:{type:`string`,default:`page`,description:`Segment by page, query, country, or device.`},...X([`days`,`limit`,`refresh`],{days:{description:`Recent window length from 1 to 240 days. Defaults to 28.`},limit:{description:`Maximum segment rows to print. Defaults to 25.`},refresh:{description:`Bypass local cache and fetch fresh GSC data.`}}),compare:{type:`string`,description:`Legacy 1-240 day comparison length. Must equal the current window.`},"start-date":{type:`string`,description:`Exact current-window start date in YYYY-MM-DD format.`},"end-date":{type:`string`,description:`Exact current-window end date in YYYY-MM-DD format.`},"max-rows":{type:`string`,description:`Maximum retained GSC rows per window. Defaults to 100000.`},"unmatched-limit":{type:`string`,description:`Maximum one-window evidence rows to return. Defaults to 25.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=wc(e.dimension),r=k(e.days,`--days`),i=k(e.compare,`--compare`),a=k(e.limit,`--limit`),o=k(e[`unmatched-limit`],`--unmatched-limit`),s=k(e[`max-rows`],`--max-rows`),c=M(T(e.site)),l=await ge({site:c,dimension:n,days:r,compareDays:i,startDate:T(e[`start-date`]),endDate:T(e[`end-date`]),limit:a,unmatchedLimit:o,maxRows:s,refresh:E(e.refresh)});t?L(l):(K({title:`Segment impact`,target:l.site,status:l.dataStatus===`complete`?`info`:`unknown`,summary:l.summary.verdict,metrics:[{label:`Dimension`,value:l.dimension},{label:`Evidence`,value:l.dataStatus},{label:`Before`,value:`${l.before.startDate} to ${l.before.endDate}`},{label:`After`,value:`${l.after.startDate} to ${l.after.endDate}`}]}),z([`Segment`,`Clicks before`,`Clicks after`,`Delta`,`Pos delta`],l.items.map(e=>[e.key,e.beforeClicks,e.afterClicks,e.clickDelta,e.positionDelta??`-`])),l.unmatchedSegments.length&&(process.stdout.write(`
 One-window evidence (not treated as zero)
-`),L([`Segment`,`Retained in`,`Clicks`,`Impressions`],l.unmatchedSegments.map(e=>[e.key,e.retainedIn,e.clicks,e.impressions]))),Y(`Warnings`,l.warnings))}});function rc(e){return`${U(e)} ${e===1?`row`:`rows`}`}const ic=y({meta:{name:`striking-distance`,description:`Find query/page rows averaging positions above 10 through 20`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`days`,`minImpressions`,`limit`,`includeBrand`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=E(e[`verify-limit`]),r=w(e[`verify-content`])===!0||n!==void 0,i=A(C(e.site)),a=await Fe({site:i,days:E(e.days),minImpressions:E(e[`min-impressions`]),limit:E(e.limit),includeBrand:w(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:w(e.js)?!0:void 0,rate:ri(e),refresh:w(e.refresh)});t?F(a):(K({title:`Striking-distance opportunities`,target:a.site,status:a.source.possiblyTruncated?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible rows`,value:U(a.summary.eligibleRows)},{label:`Returned rows`,value:U(a.summary.returnedRows)},{label:`Template groups`,value:U(a.summary.groups)},{label:`Impressions`,value:U(a.summary.eligibleImpressions)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Verification`,value:a.verification.requested?`Requested`:`Off`},{label:`Evidence`,value:a.dataStatus}]}),Y(`Why this matters`,[`These rows have a GSC average position above 10 and at most 20. Treat them as candidates for investigation, not guaranteed page-two rankings.`,`Groups use all eligible rows. A shared-template label is only a candidate until recurring evidence is verified across distinct URLs.`]),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),a.groups.length&&(q([`Group`,`Rows`,`URLs`,`Impr`,`Avg pos`,`Scope`,`Action`],a.groups.map(e=>[G(e.label,36),U(e.rowCount),U(e.uniqueUrls),U(e.totalImpressions),Na(e.impressionWeightedPosition),e.actionScope,G(e.recommendation.action,72)])),J(`Top striking-distance group actions`,a.groups.map(e=>({label:e.label,context:`${rc(e.rowCount)}, ${U(e.totalImpressions)} impressions`,action:e.recommendation.action})))),a.items.length?(q([`Query`,`Template`,`URL`,`Impr`,`CTR`,`Pos`,`Score`,`Fetch`,`Check`,`Action`],a.items.map(e=>[G(e.query,36),G(e.template.label,24),G(e.url,48),U(e.impressions),W(e.ctr),Na(e.position),e.priority.score,to(e.contentVerification?.fetchDiagnostics),no(e.contentVerification?.classification),G(e.recommendation.action,72)])),J(`Top striking-distance actions`,a.items.map(e=>({label:e.query,context:`${e.template.label}, pos ${Na(e.position)}, ${U(e.impressions)} impressions`,action:e.recommendation.action})))):process.stdout.write(`No striking-distance opportunities matched these filters.
-`))}});function ac(e){return e===`keychain`?`system keychain`:e===`file`?`private local file`:e??`missing`}function oc(e){return e===null?`unavailable`:`$${(e/1e6).toFixed(2)}`}function sc(e){return e.limit===null?e.used===null?`not reported`:`${e.used.toLocaleString(`en-US`)} used; no key limit`:`${(e.remaining??0).toLocaleString(`en-US`)} of ${e.limit.toLocaleString(`en-US`)} remaining`}const cc=y({meta:{name:`connect`,description:`Validate and save an Ahrefs API v3 key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!P({json:k(e)}))throw new h(`AUTH_REQUIRED`,`Run \`seo providers ahrefs connect\` in a terminal. Agents and CI can set ${o}.`);kr(`Connect Ahrefs`),b(`Paste an API v3 key from Ahrefs Account settings. The validation check and Domain Rating are free; other research can consume API units.`,`API key`);let t=B(await Nr({message:`Ahrefs API v3 key`,validate:e=>e?.trim()?void 0:`API key is required`})),n=await new pn({apiKey:t}).limitsAndUsage(),r=await Je(t);b(`${n.subscription} subscription. API key units: ${sc(n.apiKeyUnits)}.`,`Connection verified`),x(`Saved in the ${ac(r)}. Run seo providers ahrefs status --check to verify it again.`)}}),lc=y({meta:{name:`status`,description:`Show the local Ahrefs connection`},args:{check:{type:`boolean`,default:!1,description:`Verify the API key with the free account endpoint.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await le(),n=!!e.check,r=n&&t?await new pn().limitsAndUsage():void 0,i={connected:!!t,apiVersion:t?3:null,credentialSource:t?.source,liveCheck:r?{status:`passed`,subscription:r.subscription,apiKeyExpiresAt:r.apiKeyExpiresAt,usageResetsAt:r.usageResetsAt,apiKeyUnits:r.apiKeyUnits,workspaceUnits:r.workspaceUnits,observedAt:r.observedAt,requestCostUnits:r.requestCostUnits}:{status:n?`unavailable`:`not-requested`}};k(e)?F(i):I([[`Connected`,i.connected?`yes`:`no`],[`API version`,i.apiVersion?`Version 3`:`not connected`],[`Credential`,ac(i.credentialSource)],[`Live check`,i.liveCheck.status===`passed`?`passed at ${i.liveCheck.observedAt}`:i.liveCheck.status===`unavailable`?`not available without credentials`:`not requested; pass --check to verify`],...r?[[`Subscription`,r.subscription],[`API key units`,sc(r.apiKeyUnits)],[`Workspace units`,sc(r.workspaceUnits)],[`Usage resets`,r.usageResetsAt],[`Key expires`,r.apiKeyExpiresAt]]:[]])}}),uc=y({meta:{name:`disconnect`,description:`Remove the saved Ahrefs API v3 key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await Ze();let t=!!process.env[o]?.trim(),n={savedCredentialRemoved:!0,environmentCredential:t?`active`:`missing`,note:t?`The environment variable was not changed. Clear ${o} to fully disconnect.`:`Ahrefs is disconnected.`};k(e)?F(n):process.stdout.write(`${n.note}\n`)}}),dc=y({meta:{name:`ahrefs`,description:`Connect Ahrefs for optional search and link data`},subCommands:{connect:cc,status:lc,disconnect:uc}}),fc="Run `seo providers bing connect` with a new API key.",pc=y({meta:{name:`connect`,description:`Check and save a Bing Webmaster Tools API key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!P({json:k(e)}))throw new h(`AUTH_REQUIRED`,`Run \`seo providers bing connect\` in a terminal. Agents and CI can set ${fe}.`);kr(`Connect Bing Webmaster Tools`),b(`In Bing Webmaster Tools, open Settings, then API access, and copy the API key. Bing data is free.`,`API key`);let t=B(await Nr({message:`Bing Webmaster API key`,validate:e=>e?.trim()?void 0:`API key is required`})),n=await dn(_t({apiKey:t},{signIn:fc})),r=await Wn(t);b(`${n.filter(e=>e.verified).length} verified sites.`,`Connection verified`),x(`Saved in the ${ac(r)}.`)}}),mc=y({meta:{name:`status`,description:`Show the Bing Webmaster connection`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await ze(),n=t?await dn(_t({apiKey:t.apiKey},{signIn:fc})):null,r={connected:!!t,credentialSource:t?.source??null,sites:n?.filter(e=>e.verified).map(e=>e.url)??[]};k(e)?F(r):process.stdout.write(t?`Connected (${ac(t.source)}). Verified sites: ${r.sites.join(`, `)||`none`}.\n`:"Not connected. Run `seo providers bing connect`.\n")}}),hc=y({meta:{name:`disconnect`,description:`Remove the saved Bing Webmaster API key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await xe();let t=!!process.env[fe]?.trim(),n=t?`The saved key is removed. Clear ${fe} to fully disconnect.`:`Bing is disconnected.`;k(e)?F({removed:!0,environment:t}):process.stdout.write(`${n}\n`)}}),gc=y({meta:{name:`bing`,description:`Connect Bing Webmaster Tools for Bing search data`},subCommands:{connect:pc,status:mc,disconnect:hc}}),_c=y({meta:{name:`connect`,description:`Validate and save DataForSEO API credentials`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!P({json:k(e)}))throw new h(`AUTH_REQUIRED`,`Run \`seo providers dataforseo connect\` in a terminal. Agents and CI can set ${Kt} and ${we}.`);kr(`Connect DataForSEO`),b(`Use the API login and API password from DataForSEO API Access. The validation call is free; later research reports can make charged requests.`,`API credentials`);let t=B(await Fr({message:`DataForSEO API login`,validate:e=>e?.trim()?void 0:`API login is required`})),n=B(await Nr({message:`DataForSEO API password`,validate:e=>e?void 0:`API password is required`})),r={login:t.trim(),password:n},i=await new Nt({credentials:()=>r}).userData(),a=await re(r);b(`${i.login} is connected with an account balance of ${oc(i.balanceMicros)}.`,`Connection verified`),x(`Saved in the ${ac(a)}. Run seo providers dataforseo status --check to verify it again.`)}}),vc=y({meta:{name:`status`,description:`Show the local DataForSEO connection`},args:{check:{type:`boolean`,default:!1,description:`Verify credentials with the free account endpoint.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Ne(),n=!!e.check,r=n&&t?await new Nt().userData():void 0,i={connected:!!t,credentialSource:t?.source,migratedLegacyCredentials:t?.migrated??!1,liveCheck:r?{status:`passed`,account:r.login,timezone:r.timezone,balanceMicros:r.balanceMicros,observedAt:r.observedAt,requestCostMicros:r.requestCostMicros}:{status:n?`unavailable`:`not-requested`}};k(e)?F(i):I([[`Connected`,i.connected?`yes`:`no`],[`Credential`,ac(i.credentialSource)],[`Live check`,i.liveCheck.status===`passed`?`passed at ${i.liveCheck.observedAt}`:i.liveCheck.status===`unavailable`?`not available without credentials`:`not requested; pass --check to verify`],...r?[[`Account`,r.login],[`Balance`,oc(r.balanceMicros)]]:[]])}}),yc=y({meta:{name:`disconnect`,description:`Remove saved DataForSEO credentials`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await De();let t=!!process.env[Kt]?.trim(),n=!!process.env[we],r={savedCredentialsRemoved:!0,environmentCredentials:t&&n?`active`:t||n?`partial`:`missing`,note:t||n?`Environment variables were not changed. Clear ${Kt} and ${we} to fully disconnect.`:`DataForSEO is disconnected.`};k(e)?F(r):process.stdout.write(`${r.note}\n`)}}),bc=y({meta:{name:`dataforseo`,description:`Connect DataForSEO for optional search data`},subCommands:{connect:_c,status:vc,disconnect:yc}});function xc(e){if(!e)return{};let t;try{t=JSON.parse(e)}catch{throw new h(`INVALID_INPUT`,`--account must be a JSON object.`)}if(!t||Array.isArray(t)||typeof t!=`object`)throw new h(`INVALID_INPUT`,`--account must be a JSON object.`);let n=Object.entries(t);if(n.length>20||n.some(([e,t])=>!e||e.length>64||typeof t!=`string`||t.length>4096))throw new h(`INVALID_INPUT`,`--account must contain at most 20 bounded string fields.`);return Object.fromEntries(n.map(([e,t])=>[e,t.trim()]))}function Sc(e){if(!e)return{};let t;try{t=JSON.parse(e)}catch{throw new h(`INVALID_INPUT`,`--params must be a JSON object.`)}if(!t||Array.isArray(t)||typeof t!=`object`)throw new h(`INVALID_INPUT`,`--params must be a JSON object.`);let n=Object.entries(t);if(n.length>100||n.some(([e])=>!/^[A-Za-z][A-Za-z0-9-]{0,63}$/u.test(e))||Buffer.byteLength(e)>65536)throw new h(`INVALID_INPUT`,`--params must be a JSON object smaller than 64 KiB.`);return Object.fromEntries(n)}async function Cc(e){let t=await Xe(),n=t.registry.get(e);if(n)return n;let r=t.failures.find(t=>t.id===e);throw r?new h(`INVALID_INPUT`,`Provider ${e} could not load: ${r.message}`):new h(`INVALID_INPUT`,`Provider ${e} is not installed.`)}function wc(e,t){let n=new Set(e.connection.fields.filter(e=>e.kind===`account`).map(e=>e.id)),r=Object.keys(t).find(e=>!n.has(e));if(r)throw new h(`INVALID_INPUT`,`${r} is not an account field for ${e.displayName}.`);let i=e.connection.normalizeAccount?e.connection.normalizeAccount(t):{...t};if(Object.keys(i).find(e=>!n.has(e)))throw new h(`PROVIDER_UNAVAILABLE`,`${e.displayName} returned an unknown account field.`);for(let t of e.connection.fields.filter(e=>e.kind===`account`&&e.required!==!1))if(!i[t.id]?.trim())throw new h(`INVALID_INPUT`,`${t.label} is required.`);return i}async function Tc(){return Mn()}const Ec={list:y({meta:{name:`list`,description:`List installed provider packages`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Tc();k(e)?F(t):t.installed.length>0?L([`Installed provider`,`Package`,`Version`,`Status`],t.installed.map(e=>[e.id,e.package,e.version,e.loadStatus])):process.stdout.write(`No provider extensions are installed.
-`)}}),describe:y({meta:{name:`describe`,description:`Describe one installed provider for an agent`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=await ft(t);k(e)?F(n):I([[`Provider`,n.displayName],[`Package`,`${n.package}@${n.version}`],[`Description`,n.description],[`Capabilities`,n.capabilities.map(e=>e.id).join(`, `)||`none`],[`Actions`,n.actions.map(e=>e.id).join(`, `)||`none`]])}}),install:y({meta:{name:`install`,description:`Install one provider package from npm`},args:{package:{type:`positional`,required:!0,description:`npm package name with an optional exact version.`},yes:{type:`boolean`,default:!1,description:`Approve third-party code installation without prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.package)??``,n=k(e),r=w(e.yes),i=P({json:n});if(!r&&!i)throw new h(`INVALID_INPUT`,`Provider installation runs third-party code. Review the package, then pass --yes to approve it in JSON or CI mode.`);let a;try{a=await nn(t)}catch(e){throw new h(`INVALID_INPUT`,e instanceof Error?e.message:String(e))}if(!r&&(kr(`Install provider package`),b([`${a.package}@${a.version}`,`Publisher: ${a.publisher??`not supplied by npm`}`,`Repository: ${a.repository??`not supplied by npm`}`,`Integrity: ${a.integrity}`].join(`
-`),`Package`),b(`This package can read files, use the network, and run with the same local permissions as seo. Installing it is not a security review or endorsement.`,`Third-party code`),!B(await Or({message:`Install ${a.package}@${a.version}?`,initialValue:!1})))){x(`Provider was not installed.`);return}let o;try{o=await zt(a)}catch(e){throw new h(`PROVIDER_UNAVAILABLE`,e instanceof Error?e.message:String(e))}n?F({installed:o,package:a}):x(`Installed provider ${o.id} from ${o.package}@${o.version}.`)}}),remove:y({meta:{name:`remove`,description:`Remove one installed provider extension`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},yes:{type:`boolean`,default:!1,description:`Remove the package without prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=k(e),r=w(e.yes),i=P({json:n});if(!r&&!i)throw new h(`INVALID_INPUT`,`Pass --yes to remove a provider extension in JSON or CI mode.`);if(!r&&!B(await Or({message:`Remove provider ${t}?`,initialValue:!1})))return;let a=await It(t);if(!a)throw new h(`INVALID_INPUT`,`Provider ${t} is not installed.`);n?F({removed:a}):process.stdout.write(`Removed ${t}.\n`)}}),connect:y({meta:{name:`connect`,description:`Validate and save one installed provider connection`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},account:{type:`string`,description:`Account fields as JSON. Secret fields must use their environment variables.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=k(e),r=P({json:n}),i=await Cc(t),a={...yt(t),...xc(C(e.account))},o={};if(r){kr(`Connect ${i.displayName}`),i.connection.verificationNotice&&b(i.connection.verificationNotice,`Connection check`);for(let e of i.connection.fields){if(e.kind===`account`){let t=B(await Fr({message:e.label,placeholder:e.description,initialValue:a[e.id],validate:t=>e.required!==!1&&!t?.trim()?`${e.label} is required`:void 0}));t?.trim()&&(a[e.id]=t.trim());continue}if(e.envVar&&process.env[e.envVar]?.trim())continue;let t=B(await Nr({message:e.label,validate:t=>e.required!==!1&&!t?.trim()?`${e.label} is required`:void 0}));t?.trim()&&(o[e.id]=t.trim())}}a=wc(i,a);let s={...o};Object.keys(s).length===0&&(s=await ce({providerId:t,account:a,fields:i.connection.fields})),await de({providerId:t,account:a,credentials:s}),Object.keys(o).length>0&&await be({providerId:t,account:a,credentials:o}),Rn(t,a);let c={provider:t,connected:!0,account:a,capabilities:(i.capabilities??[]).map(e=>e.id),actions:(i.actions??[]).map(e=>e.id)};n?F(c):x(`Connected ${i.displayName}. Run seo providers describe ${t} to see what it can do.`)}}),status:y({meta:{name:`status`,description:`Show one installed provider connection`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},check:{type:`boolean`,default:!1,description:`Run the provider connection check.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=await Cc(t),r=yt(t),i;try{i=await ce({providerId:t,account:r,fields:n.connection.fields})}catch{i=void 0}let a=n.connection.fields.filter(e=>e.kind===`account`&&e.required!==!1).every(e=>!!r[e.id]?.trim())&&i!==void 0,o=w(e.check);if(o&&!a)throw new h(`AUTH_REQUIRED`,`Provider ${t} is not connected. Run \`seo providers connect ${t}\`.`);o&&i&&await de({providerId:t,account:r,credentials:i});let s={provider:t,installed:!0,connected:a,account:r,capabilities:(n.capabilities??[]).map(e=>e.id),actions:(n.actions??[]).map(e=>e.id),check:o?`passed`:`not-requested`};k(e)?F(s):L([`Provider`,`Connected`,`Capabilities`,`Check`],[[n.displayName,a?`yes`:`no`,s.capabilities.join(`, `),s.check]])}}),disconnect:y({meta:{name:`disconnect`,description:`Remove one saved provider connection`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``;await Cc(t);let n=yt(t);await nt({providerId:t,account:n}),Vn(t);let r={provider:t,disconnected:!0,note:`Environment variables were not changed.`};k(e)?F(r):process.stdout.write(`Disconnected ${t}. ${r.note}\n`)}}),run:y({meta:{name:`run`,description:`Run one action supplied by an installed provider`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},action:{type:`positional`,required:!0,description:`Provider action id.`},account:{type:`string`,description:`Account fields as JSON. Defaults to the saved connection.`},params:{type:`string`,description:`Action parameters as a JSON object.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local provider cache.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=C(e.action)??``;await Cc(t);let r={...yt(t),...xc(C(e.account))};F(await He({providerId:t,actionId:n,account:r,params:Sc(C(e.params)),refresh:w(e.refresh)}))}}),doctor:y({meta:{name:`doctor`,description:`Validate installed provider packages and entry points`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Tc(),n={ok:t.installed.every(e=>e.loadStatus===`ready`),installed:t.installed};k(e)?F(n):n.installed.length===0?process.stdout.write(`No provider extensions are installed.
-`):L([`Provider`,`Package`,`Version`,`Status`],n.installed.map(e=>[e.id,e.package,e.version,e.error??e.loadStatus]))}})},Dc=y({meta:{name:`providers`,description:`Connect optional data providers`},subCommands:{...Ec,ahrefs:dc,bing:gc,dataforseo:bc}}),Oc={"ai-search":`AI search`,crawl:`Crawling and technical checks`,diagnosis:`Diagnosis`,monitoring:`Monitoring`,opportunities:`Opportunities`,reporting:`Reporting`,setup:`Setup`,workflows:`Workflows`};function kc(e){let t=C(e);if(t){if(!wn.includes(t))throw new h(`INVALID_INPUT`,`Unknown report category: ${t}. Choose ${wn.join(`, `)}.`);return t}}async function Ac(e,t){let n=C(e),r=C(t);if(n&&r)throw new h(`INVALID_INPUT`,`Use either --params or --params-file, not both.`);if(!n&&!r)return{};let i=n??await v(r??``,`utf8`),a;try{a=JSON.parse(i)}catch{throw new h(`INVALID_INPUT`,`Report parameters must be valid JSON.`)}if(!a||typeof a!=`object`||Array.isArray(a))throw new h(`INVALID_INPUT`,`Report parameters must be an object.`);return a}function jc(e){if(!e.isError)return;let t=e.structuredContent;throw new h(t?.error?.code??`INTERNAL_ERROR`,t?.error?.message??`The report could not be completed.`)}function Mc(e){if(!e||typeof e!=`object`)return[];let t=e,n=new Set(t.required??[]);return Object.entries(t.properties??{}).map(([e,t])=>{let r=Array.isArray(t.type)?t.type.join(` | `):t.type??`any`;return{name:e,type:r===`array`&&t.items?.type?`${t.items.type}[]`:t.format?`${r} (${t.format})`:r,required:n.has(e),description:t.description}})}const Nc=y({meta:{name:`list`,description:`List report ids available to the CLI and MCP server`},args:{category:{type:`string`,description:`Filter by category: ${wn.join(`, `)}.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=kc(e.category),n=ln(t);k(e)?F({reports:n,categories:wn}):(Wi(n,{noun:`report`,categoryLabels:Oc}),process.stdout.write(`
-`),R({title:`Need the detail?`,body:`Describe one report to see when to use it, what it needs, and what the result can prove.`,command:`seo reports describe <id>`}))}}),Pc=y({meta:{name:`describe`,description:`Show the purpose and parameter schema for one report`},args:{id:{type:`positional`,required:!0,description:"Report id from `seo reports list`."},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=Ht(C(e.id)??``);k(e)?F({report:t}):(Vi(t.name,t.description),process.stdout.write(`
-`),I([[`ID`,t.id],[`Category`,t.category],[`Outcome`,t.outcome]]),process.stdout.write(`
-`),Ki(`Use when`,t.useWhen),process.stdout.write(`
-`),Ki(`Avoid when`,t.avoidWhen),process.stdout.write(`
-`),Ki(`Read in order`,t.readOrder),process.stdout.write(`
-`),Ki(`Do not claim`,t.doNotClaim),process.stdout.write(`
-`),z(`Verify`,t.verify),process.stdout.write(`
-`),R({title:`Implement findings`,body:t.agentWorkflow.completion,command:t.agentWorkflow.actionView.cli}),t.related.length>0&&(process.stdout.write(`
-`),Ki(`Related reports`,t.related.map(e=>`${e.id}: ${e.reason}`))),process.stdout.write(`
+`),z([`Segment`,`Retained in`,`Clicks`,`Impressions`],l.unmatchedSegments.map(e=>[e.key,e.retainedIn,e.clicks,e.impressions]))),Y(`Warnings`,l.warnings))}});function Ec(e){return`${U(e)} ${e===1?`row`:`rows`}`}const Dc=x({meta:{name:`striking-distance`,description:`Find query/page rows averaging positions above 10 through 20`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`days`,`minImpressions`,`limit`,`includeBrand`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=O(e[`verify-limit`]),r=E(e[`verify-content`])===!0||n!==void 0,i=M(T(e.site)),a=await nt({site:i,days:O(e.days),minImpressions:O(e[`min-impressions`]),limit:O(e.limit),includeBrand:E(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:E(e.js)?!0:void 0,rate:mi(e),refresh:E(e.refresh)});t?L(a):(K({title:`Striking-distance opportunities`,target:a.site,status:a.source.possiblyTruncated?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible rows`,value:U(a.summary.eligibleRows)},{label:`Returned rows`,value:U(a.summary.returnedRows)},{label:`Template groups`,value:U(a.summary.groups)},{label:`Impressions`,value:U(a.summary.eligibleImpressions)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Verification`,value:a.verification.requested?`Requested`:`Off`},{label:`Evidence`,value:a.dataStatus}]}),Y(`Why this matters`,[`These rows have a GSC average position above 10 and at most 20. Treat them as candidates for investigation, not guaranteed page-two rankings.`,`Groups use all eligible rows. A shared-template label is only a candidate until recurring evidence is verified across distinct URLs.`]),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),a.groups.length&&(q([`Group`,`Rows`,`URLs`,`Impr`,`Avg pos`,`Scope`,`Action`],a.groups.map(e=>[G(e.label,36),U(e.rowCount),U(e.uniqueUrls),U(e.totalImpressions),qa(e.impressionWeightedPosition),e.actionScope,G(e.recommendation.action,72)])),J(`Top striking-distance group actions`,a.groups.map(e=>({label:e.label,context:`${Ec(e.rowCount)}, ${U(e.totalImpressions)} impressions`,action:e.recommendation.action})))),a.items.length?(q([`Query`,`Template`,`URL`,`Impr`,`CTR`,`Pos`,`Score`,`Fetch`,`Check`,`Action`],a.items.map(e=>[G(e.query,36),G(e.template.label,24),G(e.url,48),U(e.impressions),W(e.ctr),qa(e.position),e.priority.score,So(e.contentVerification?.fetchDiagnostics),Co(e.contentVerification?.classification),G(e.recommendation.action,72)])),J(`Top striking-distance actions`,a.items.map(e=>({label:e.query,context:`${e.template.label}, pos ${qa(e.position)}, ${U(e.impressions)} impressions`,action:e.recommendation.action})))):process.stdout.write(`No striking-distance opportunities matched these filters.
+`))}});function Oc(e){return e===`keychain`?`system keychain`:e===`file`?`private local file`:e??`missing`}function kc(e){return e===null?`unavailable`:`$${(e/1e6).toFixed(2)}`}function Ac(e){return e.limit===null?e.used===null?`not reported`:`${e.used.toLocaleString(`en-US`)} used; no key limit`:`${(e.remaining??0).toLocaleString(`en-US`)} of ${e.limit.toLocaleString(`en-US`)} remaining`}const jc=x({meta:{name:`connect`,description:`Validate and save an Ahrefs API v3 key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!I({json:j(e)}))throw new _(`AUTH_REQUIRED`,`Run \`seo providers ahrefs connect\` in a terminal. Agents and CI can set ${Ze}.`);Br(`Connect Ahrefs`),S(`Paste an API v3 key from Ahrefs Account settings. The validation check and Domain Rating are free; other research can consume API units.`,`API key`);let t=B(await Wr({message:`Ahrefs API v3 key`,validate:e=>e?.trim()?void 0:`API key is required`})),n=await new yn({apiKey:t}).limitsAndUsage(),r=await et(t);S(`${n.subscription} subscription. API key units: ${Ac(n.apiKeyUnits)}.`,`Connection verified`),C(`Saved in the ${Oc(r)}. Run seo providers ahrefs status --check to verify it again.`)}}),Mc=x({meta:{name:`status`,description:`Show the local Ahrefs connection`},args:{check:{type:`boolean`,default:!1,description:`Verify the API key with the free account endpoint.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Je(),n=!!e.check,r=n&&t?await new yn().limitsAndUsage():void 0,i={connected:!!t,apiVersion:t?3:null,credentialSource:t?.source,liveCheck:r?{status:`passed`,subscription:r.subscription,apiKeyExpiresAt:r.apiKeyExpiresAt,usageResetsAt:r.usageResetsAt,apiKeyUnits:r.apiKeyUnits,workspaceUnits:r.workspaceUnits,observedAt:r.observedAt,requestCostUnits:r.requestCostUnits}:{status:n?`unavailable`:`not-requested`}};j(e)?L(i):R([[`Connected`,i.connected?`yes`:`no`],[`API version`,i.apiVersion?`Version 3`:`not connected`],[`Credential`,Oc(i.credentialSource)],[`Live check`,i.liveCheck.status===`passed`?`passed at ${i.liveCheck.observedAt}`:i.liveCheck.status===`unavailable`?`not available without credentials`:`not requested; pass --check to verify`],...r?[[`Subscription`,r.subscription],[`API key units`,Ac(r.apiKeyUnits)],[`Workspace units`,Ac(r.workspaceUnits)],[`Usage resets`,r.usageResetsAt],[`Key expires`,r.apiKeyExpiresAt]]:[]])}}),Nc=x({meta:{name:`disconnect`,description:`Remove the saved Ahrefs API v3 key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await ce();let t=!!process.env[Ze]?.trim(),n={savedCredentialRemoved:!0,environmentCredential:t?`active`:`missing`,note:t?`The environment variable was not changed. Clear ${Ze} to fully disconnect.`:`Ahrefs is disconnected.`};j(e)?L(n):process.stdout.write(`${n.note}\n`)}}),Pc=x({meta:{name:`ahrefs`,description:`Connect Ahrefs for optional search and link data`},subCommands:{connect:jc,status:Mc,disconnect:Nc}}),Fc="Run `seo providers bing connect` with a new API key.",Ic=x({meta:{name:`connect`,description:`Check and save a Bing Webmaster Tools API key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!I({json:j(e)}))throw new _(`AUTH_REQUIRED`,`Run \`seo providers bing connect\` in a terminal. Agents and CI can set ${be}.`);Br(`Connect Bing Webmaster Tools`),S(`In Bing Webmaster Tools, open Settings, then API access, and copy the API key. Bing data is free.`,`API key`);let t=B(await Wr({message:`Bing Webmaster API key`,validate:e=>e?.trim()?void 0:`API key is required`})),n=await Hn(mt({apiKey:t},{signIn:Fc})),r=await o(t);S(`${n.filter(e=>e.verified).length} verified sites.`,`Connection verified`),C(`Saved in the ${Oc(r)}.`)}}),Lc=x({meta:{name:`status`,description:`Show the Bing Webmaster connection`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await $n(),n=t?await Hn(mt({apiKey:t.apiKey},{signIn:Fc})):null,r={connected:!!t,credentialSource:t?.source??null,sites:n?.filter(e=>e.verified).map(e=>e.url)??[]};j(e)?L(r):process.stdout.write(t?`Connected (${Oc(t.source)}). Verified sites: ${r.sites.join(`, `)||`none`}.\n`:"Not connected. Run `seo providers bing connect`.\n")}}),Rc=x({meta:{name:`disconnect`,description:`Remove the saved Bing Webmaster API key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await Re();let t=!!process.env[be]?.trim(),n=t?`The saved key is removed. Clear ${be} to fully disconnect.`:`Bing is disconnected.`;j(e)?L({removed:!0,environment:t}):process.stdout.write(`${n}\n`)}}),zc=x({meta:{name:`bing`,description:`Connect Bing Webmaster Tools for Bing search data`},subCommands:{connect:Ic,status:Lc,disconnect:Rc}}),Bc=x({meta:{name:`connect`,description:`Validate and save DataForSEO API credentials`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!I({json:j(e)}))throw new _(`AUTH_REQUIRED`,`Run \`seo providers dataforseo connect\` in a terminal. Agents and CI can set ${Ce} and ${Ee}.`);Br(`Connect DataForSEO`),S(`Use the API login and API password from DataForSEO API Access. The validation call is free; later research reports can make charged requests.`,`API credentials`);let t=B(await Kr({message:`DataForSEO API login`,validate:e=>e?.trim()?void 0:`API login is required`})),n=B(await Wr({message:`DataForSEO API password`,validate:e=>e?void 0:`API password is required`})),r={login:t.trim(),password:n},i=await new Ft({credentials:()=>r}).userData(),a=await de(r);S(`${i.login} is connected with an account balance of ${kc(i.balanceMicros)}.`,`Connection verified`),C(`Saved in the ${Oc(a)}. Run seo providers dataforseo status --check to verify it again.`)}}),Vc=x({meta:{name:`status`,description:`Show the local DataForSEO connection`},args:{check:{type:`boolean`,default:!1,description:`Verify credentials with the free account endpoint.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await ne(),n=!!e.check,r=n&&t?await new Ft().userData():void 0,i={connected:!!t,credentialSource:t?.source,migratedLegacyCredentials:t?.migrated??!1,liveCheck:r?{status:`passed`,account:r.login,timezone:r.timezone,balanceMicros:r.balanceMicros,observedAt:r.observedAt,requestCostMicros:r.requestCostMicros}:{status:n?`unavailable`:`not-requested`}};j(e)?L(i):R([[`Connected`,i.connected?`yes`:`no`],[`Credential`,Oc(i.credentialSource)],[`Live check`,i.liveCheck.status===`passed`?`passed at ${i.liveCheck.observedAt}`:i.liveCheck.status===`unavailable`?`not available without credentials`:`not requested; pass --check to verify`],...r?[[`Account`,r.login],[`Balance`,kc(r.balanceMicros)]]:[]])}}),Hc=x({meta:{name:`disconnect`,description:`Remove saved DataForSEO credentials`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await Me();let t=!!process.env[Ce]?.trim(),n=!!process.env[Ee],r={savedCredentialsRemoved:!0,environmentCredentials:t&&n?`active`:t||n?`partial`:`missing`,note:t||n?`Environment variables were not changed. Clear ${Ce} and ${Ee} to fully disconnect.`:`DataForSEO is disconnected.`};j(e)?L(r):process.stdout.write(`${r.note}\n`)}}),Uc=x({meta:{name:`dataforseo`,description:`Connect DataForSEO for optional search data`},subCommands:{connect:Bc,status:Vc,disconnect:Hc}});function Wc(e){if(!e)return{};let t;try{t=JSON.parse(e)}catch{throw new _(`INVALID_INPUT`,`--account must be a JSON object.`)}if(!t||Array.isArray(t)||typeof t!=`object`)throw new _(`INVALID_INPUT`,`--account must be a JSON object.`);let n=Object.entries(t);if(n.length>20||n.some(([e,t])=>!e||e.length>64||typeof t!=`string`||t.length>4096))throw new _(`INVALID_INPUT`,`--account must contain at most 20 bounded string fields.`);return Object.fromEntries(n.map(([e,t])=>[e,t.trim()]))}function Gc(e){if(!e)return{};let t;try{t=JSON.parse(e)}catch{throw new _(`INVALID_INPUT`,`--params must be a JSON object.`)}if(!t||Array.isArray(t)||typeof t!=`object`)throw new _(`INVALID_INPUT`,`--params must be a JSON object.`);let n=Object.entries(t);if(n.length>100||n.some(([e])=>!/^[A-Za-z][A-Za-z0-9-]{0,63}$/u.test(e))||Buffer.byteLength(e)>65536)throw new _(`INVALID_INPUT`,`--params must be a JSON object smaller than 64 KiB.`);return Object.fromEntries(n)}async function Kc(e){let t=await Nn(),n=t.registry.get(e);if(n)return n;let r=t.failures.find(t=>t.id===e);throw r?new _(`INVALID_INPUT`,`Provider ${e} could not load: ${r.message}`):new _(`INVALID_INPUT`,`Provider ${e} is not installed.`)}function qc(e,t){let n=new Set(e.connection.fields.filter(e=>e.kind===`account`).map(e=>e.id)),r=Object.keys(t).find(e=>!n.has(e));if(r)throw new _(`INVALID_INPUT`,`${r} is not an account field for ${e.displayName}.`);let i=e.connection.normalizeAccount?e.connection.normalizeAccount(t):{...t};if(Object.keys(i).find(e=>!n.has(e)))throw new _(`PROVIDER_UNAVAILABLE`,`${e.displayName} returned an unknown account field.`);for(let t of e.connection.fields.filter(e=>e.kind===`account`&&e.required!==!1))if(!i[t.id]?.trim())throw new _(`INVALID_INPUT`,`${t.label} is required.`);return i}async function Jc(){return Bn()}const Yc={list:x({meta:{name:`list`,description:`List installed provider packages`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Jc();j(e)?L(t):t.installed.length>0?z([`Installed provider`,`Package`,`Version`,`Status`],t.installed.map(e=>[e.id,e.package,e.version,e.loadStatus])):process.stdout.write(`No provider extensions are installed.
+`)}}),describe:x({meta:{name:`describe`,description:`Describe one installed provider for an agent`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.id)??``,n=await ft(t);j(e)?L(n):R([[`Provider`,n.displayName],[`Package`,`${n.package}@${n.version}`],[`Description`,n.description],[`Capabilities`,n.capabilities.map(e=>e.id).join(`, `)||`none`],[`Actions`,n.actions.map(e=>e.id).join(`, `)||`none`]])}}),install:x({meta:{name:`install`,description:`Install one provider package from npm`},args:{package:{type:`positional`,required:!0,description:`npm package name with an optional exact version.`},yes:{type:`boolean`,default:!1,description:`Approve third-party code installation without prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.package)??``,n=j(e),r=E(e.yes),i=I({json:n});if(!r&&!i)throw new _(`INVALID_INPUT`,`Provider installation runs third-party code. Review the package, then pass --yes to approve it in JSON or CI mode.`);let a;try{a=await cn(t)}catch(e){throw new _(`INVALID_INPUT`,e instanceof Error?e.message:String(e))}if(!r&&(Br(`Install provider package`),S([`${a.package}@${a.version}`,`Publisher: ${a.publisher??`not supplied by npm`}`,`Repository: ${a.repository??`not supplied by npm`}`,`Integrity: ${a.integrity}`].join(`
+`),`Package`),S(`This package can read files, use the network, and run with the same local permissions as seo. Installing it is not a security review or endorsement.`,`Third-party code`),!B(await zr({message:`Install ${a.package}@${a.version}?`,initialValue:!1})))){C(`Provider was not installed.`);return}let o;try{o=await Ut(a)}catch(e){throw new _(`PROVIDER_UNAVAILABLE`,e instanceof Error?e.message:String(e))}n?L({installed:o,package:a}):C(`Installed provider ${o.id} from ${o.package}@${o.version}.`)}}),remove:x({meta:{name:`remove`,description:`Remove one installed provider extension`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},yes:{type:`boolean`,default:!1,description:`Remove the package without prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.id)??``,n=j(e),r=E(e.yes),i=I({json:n});if(!r&&!i)throw new _(`INVALID_INPUT`,`Pass --yes to remove a provider extension in JSON or CI mode.`);if(!r&&!B(await zr({message:`Remove provider ${t}?`,initialValue:!1})))return;let a=await zt(t);if(!a)throw new _(`INVALID_INPUT`,`Provider ${t} is not installed.`);n?L({removed:a}):process.stdout.write(`Removed ${t}.\n`)}}),connect:x({meta:{name:`connect`,description:`Validate and save one installed provider connection`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},account:{type:`string`,description:`Account fields as JSON. Secret fields must use their environment variables.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.id)??``,n=j(e),r=I({json:n}),i=await Kc(t),a={...bt(t),...Wc(T(e.account))},o={};if(r){Br(`Connect ${i.displayName}`),i.connection.verificationNotice&&S(i.connection.verificationNotice,`Connection check`);for(let e of i.connection.fields){if(e.kind===`account`){let t=B(await Kr({message:e.label,placeholder:e.description,initialValue:a[e.id],validate:t=>e.required!==!1&&!t?.trim()?`${e.label} is required`:void 0}));t?.trim()&&(a[e.id]=t.trim());continue}if(e.envVar&&process.env[e.envVar]?.trim())continue;let t=B(await Wr({message:e.label,validate:t=>e.required!==!1&&!t?.trim()?`${e.label} is required`:void 0}));t?.trim()&&(o[e.id]=t.trim())}}a=qc(i,a);let s={...o};Object.keys(s).length===0&&(s=await En({providerId:t,account:a,fields:i.connection.fields})),await Mt({providerId:t,account:a,credentials:s}),Object.keys(o).length>0&&await Jt({providerId:t,account:a,credentials:o}),qn(t,a);let c={provider:t,connected:!0,account:a,capabilities:(i.capabilities??[]).map(e=>e.id),actions:(i.actions??[]).map(e=>e.id)};n?L(c):C(`Connected ${i.displayName}. Run seo providers describe ${t} to see what it can do.`)}}),status:x({meta:{name:`status`,description:`Show one installed provider connection`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},check:{type:`boolean`,default:!1,description:`Run the provider connection check.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.id)??``,n=await Kc(t),r=bt(t),i;try{i=await En({providerId:t,account:r,fields:n.connection.fields})}catch{i=void 0}let a=n.connection.fields.filter(e=>e.kind===`account`&&e.required!==!1).every(e=>!!r[e.id]?.trim())&&i!==void 0,o=E(e.check);if(o&&!a)throw new _(`AUTH_REQUIRED`,`Provider ${t} is not connected. Run \`seo providers connect ${t}\`.`);o&&i&&await Mt({providerId:t,account:r,credentials:i});let s={provider:t,installed:!0,connected:a,account:r,capabilities:(n.capabilities??[]).map(e=>e.id),actions:(n.actions??[]).map(e=>e.id),check:o?`passed`:`not-requested`};j(e)?L(s):z([`Provider`,`Connected`,`Capabilities`,`Check`],[[n.displayName,a?`yes`:`no`,s.capabilities.join(`, `),s.check]])}}),disconnect:x({meta:{name:`disconnect`,description:`Remove one saved provider connection`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.id)??``;await Kc(t);let n=bt(t);await fn({providerId:t,account:n}),Zn(t);let r={provider:t,disconnected:!0,note:`Environment variables were not changed.`};j(e)?L(r):process.stdout.write(`Disconnected ${t}. ${r.note}\n`)}}),run:x({meta:{name:`run`,description:`Run one action supplied by an installed provider`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},action:{type:`positional`,required:!0,description:`Provider action id.`},account:{type:`string`,description:`Account fields as JSON. Defaults to the saved connection.`},params:{type:`string`,description:`Action parameters as a JSON object.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local provider cache.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.id)??``,n=T(e.action)??``;await Kc(t);let r={...bt(t),...Wc(T(e.account))};L(await Ve({providerId:t,actionId:n,account:r,params:Gc(T(e.params)),refresh:E(e.refresh)}))}}),doctor:x({meta:{name:`doctor`,description:`Validate installed provider packages and entry points`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Jc(),n={ok:t.installed.every(e=>e.loadStatus===`ready`),installed:t.installed};j(e)?L(n):n.installed.length===0?process.stdout.write(`No provider extensions are installed.
+`):z([`Provider`,`Package`,`Version`,`Status`],n.installed.map(e=>[e.id,e.package,e.version,e.error??e.loadStatus]))}})},Xc=x({meta:{name:`providers`,description:`Connect optional data providers`},subCommands:{...Yc,ahrefs:Pc,bing:zc,dataforseo:Uc}}),Zc={"ai-search":`AI search`,crawl:`Crawling and technical checks`,diagnosis:`Diagnosis`,monitoring:`Monitoring`,opportunities:`Opportunities`,reporting:`Reporting`,setup:`Setup`,workflows:`Workflows`};function Qc(e){let t=T(e);if(t){if(!Mn.includes(t))throw new _(`INVALID_INPUT`,`Unknown report category: ${t}. Choose ${Mn.join(`, `)}.`);return t}}async function $c(e,t){let n=T(e),r=T(t);if(n&&r)throw new _(`INVALID_INPUT`,`Use either --params or --params-file, not both.`);if(!n&&!r)return{};let i=n??await b(r??``,`utf8`),a;try{a=JSON.parse(i)}catch{throw new _(`INVALID_INPUT`,`Report parameters must be valid JSON.`)}if(!a||typeof a!=`object`||Array.isArray(a))throw new _(`INVALID_INPUT`,`Report parameters must be an object.`);return a}function el(e){if(!e.isError)return;let t=e.structuredContent;throw new _(t?.error?.code??`INTERNAL_ERROR`,t?.error?.message??`The report could not be completed.`)}function tl(e){if(!e||typeof e!=`object`)return[];let t=e,n=new Set(t.required??[]);return Object.entries(t.properties??{}).map(([e,t])=>{let r=Array.isArray(t.type)?t.type.join(` | `):t.type??`any`;return{name:e,type:r===`array`&&t.items?.type?`${t.items.type}[]`:t.format?`${r} (${t.format})`:r,required:n.has(e),description:t.description}})}const nl=x({meta:{name:`list`,description:`List report ids available to the CLI and MCP server`},args:{category:{type:`string`,description:`Filter by category: ${Mn.join(`, `)}.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=Qc(e.category),n=hn(t);j(e)?L({reports:n,categories:Mn}):(na(n,{noun:`report`,categoryLabels:Zc}),process.stdout.write(`
+`),Qi({title:`Need the detail?`,body:`Describe one report to see when to use it, what it needs, and what the result can prove.`,command:`seo reports describe <id>`}))}}),rl=x({meta:{name:`describe`,description:`Show the purpose and parameter schema for one report`},args:{id:{type:`positional`,required:!0,description:"Report id from `seo reports list`."},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=qt(T(e.id)??``);j(e)?L({report:t}):($i(t.name,t.description),process.stdout.write(`
+`),R([[`ID`,t.id],[`Category`,t.category],[`Outcome`,t.outcome]]),process.stdout.write(`
+`),aa(`Use when`,t.useWhen),process.stdout.write(`
+`),aa(`Avoid when`,t.avoidWhen),process.stdout.write(`
+`),aa(`Read in order`,t.readOrder),process.stdout.write(`
+`),aa(`Do not claim`,t.doNotClaim),process.stdout.write(`
+`),ia(`Verify`,t.verify),process.stdout.write(`
+`),Qi({title:`Implement findings`,body:t.agentWorkflow.completion,command:t.agentWorkflow.actionView.cli}),t.related.length>0&&(process.stdout.write(`
+`),aa(`Related reports`,t.related.map(e=>`${e.id}: ${e.reason}`))),process.stdout.write(`
 Parameters
-`),qi(Mc(t.inputSchema)),process.stdout.write(`
-`),R({title:`Need the exact schema?`,command:`seo reports describe ${t.id} --json`}))}}),Fc=y({meta:{name:`run`,description:`Run one report with JSON parameters`},args:{id:{type:`positional`,required:!0,description:"Report id from `seo reports list`."},params:{type:`string`,description:`Report parameters as a JSON object.`},"params-file":{type:`string`,description:`Read report parameters from a JSON file.`},"actions-only":{type:`boolean`,default:!1,description:`Return findings, verification, and retained inventories without the full report body.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=await Ac(e.params,e[`params-file`]),r=await ht(t,n,{view:w(e[`actions-only`])?`actions`:`full`});if(jc(r),k(e))F(r.structuredContent??{});else for(let e of r.content)process.stdout.write(`${e.text}\n`)}}),Ic=y({meta:{name:`reports`,description:`Discover and run the complete report catalog`},subCommands:{list:Nc,describe:Pc,run:Fc}}),Lc=y({meta:{name:`rules`,description:`List crawler rule ids and default guidance`},args:{category:{type:`string`,description:`Filter rules by category.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.category),n=Ot().filter(e=>!t||e.category===t);k(e)?F({rules:n}):Wi(n.map(e=>({id:e.id,category:e.category,name:`${e.title} · ${e.defaultSeverity}`})),{noun:`rule`})}}),Rc=y({meta:{name:`explain`,description:`Explain one crawler rule in plain English`},args:{rule:{type:`string`,required:!0,description:`Rule id to explain, for example missing_title.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.rule)??``,n=An(t);if(!n)throw Error(`Unknown rule: ${t}`);k(e)?F(n):(I([[`Rule`,n.id],[`Title`,n.title],[`Category`,n.category],[`Severity`,n.defaultSeverity]]),process.stdout.write(`
-`),z(`Why it matters`,n.whyItMatters),process.stdout.write(`
-`),z(`How to fix`,n.howToFix),process.stdout.write(`
-`),z(`Impact if ignored`,n.impactIfIgnored),process.stdout.write(`
-`),z(`How to verify`,n.howToVerify))}});function zc(){return Hc(`skills`,process.env.SEO_SKILLS_DIR)}function Bc(){return Hc(`evals`,process.env.SEO_EVALS_DIR)}function Vc(){return Hc(`site-kit`)}function Hc(e,t){if(t)return tr(t);let n=Qn(hr(import.meta.url));for(let t=0;t<6;t+=1){let t=g(n,e);if(_(g(t,`README.md`)))return t;n=Qn(n)}throw new h(`INTERNAL_ERROR`,`Packaged ${e} could not be found. Reinstall \`seo\` and try again.`)}function Uc(e){return cr(g(e,`SKILL.md`),`utf8`).match(/^description:\s*(.+)$/m)?.[1]?.trim()??``}const Wc=[[`setup`,`Sign in to the accounts the site needs, one at a time`],[`market`,`Choose a market with real demand and data you can own`],[`data`,`Get, clean and keep the dataset`],[`plan`,`Plan the pages from what people search for`],[`build`,`Start the site and deploy a private preview`],[`golden-page`,`Build one page that is the best answer on the web`],[`writing`,`Write copy people enjoy and AI answers can quote`],[`scale`,`Turn the golden page into every page, with gates`],[`launch`,`Go live and get the important pages indexed`],[`grow`,`Measure with your own data and improve every week`]],Gc=/* @__PURE__ */ new Set([`node_modules`,`dist`,`.astro`,`.wrangler`]);function Kc(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-|-$/g,``)}function qc(e){return Kc(Zn(e)).split(`-`).filter(Boolean).map(e=>`${e[0]?.toUpperCase()}${e.slice(1)}`).join(` `)}function Jc(e){let t=(e??`example.com`).trim().toLowerCase().replace(/^https?:\/\//,``).replace(/\/.*$/,``);if(!/^(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z]{2,}$/.test(t))throw new h(`INVALID_INPUT`,`--domain must be a domain such as example.com, not ${e}.`);return t}async function Yc(e,t){let n=JSON.parse(await v(e,`utf8`));t(n),await br(e,`${JSON.stringify(n,null,2)}\n`)}function Xc(){return Ao(`pnpm`,[`--version`],{stdio:`ignore`}).status===0?`pnpm`:`npm`}const Zc=y({meta:{name:`new`,description:`Copy the Astro on Cloudflare starter into a new folder`},args:{folder:{type:`positional`,required:!0,description:`Folder to create. It must not exist or must be empty.`},name:{type:`string`,description:`Site name. Defaults to the folder name.`},domain:{type:`string`,description:`Production domain. Defaults to example.com until you buy one.`},install:{type:`boolean`,default:!0,description:`Install packages after copying.`,negativeDescription:`Copy the files only.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=tr(String(e.folder));if(_(n)&&(await vr(n)).some(e=>e!==`.git`))throw new h(`INVALID_INPUT`,`${n} is not empty. Choose a new folder for the site.`);let r=C(e.name)?.trim()||qc(n),i=Jc(C(e.domain)),a=Kc(Zn(n))||`site`,o=qn(16).toString(`hex`),s=g(Vc(),`starter`);await gr(s,n,{recursive:!0,filter:e=>!er(s,e).split(nr).some(e=>Gc.has(e))}),await yr(g(n,`gitignore`),g(n,`.gitignore`)),await Yc(g(n,`site.config.json`),e=>{e.name=r,e.domain=i,e.indexNowKey=o}),await br(g(n,`public`,`${o}.txt`),o),await Yc(g(n,`package.json`),e=>{e.name=a;let t=e.devDependencies;t.seo=`^${ut}`});let c=g(n,`wrangler.jsonc`);await br(c,(await v(c,`utf8`)).replace(`"name": "example-site"`,`"name": ${JSON.stringify(a)}`));let l=g(n,`README.md`);await br(l,(await v(l,`utf8`)).replace(/^# .*$/m,`# ${r}`));let u=T(e,`install`)===!0?void 0:Xc(),d=!1;u&&(t||process.stdout.write(`Installing packages with ${u}...\n`),d=Ao(u,[`install`],{cwd:n,stdio:t?`ignore`:`inherit`}).status===0);let f=[`cd ${er(process.cwd(),n)||`.`}`,`seo site guide setup`];t?F({folder:n,name:r,domain:i,installed:d,packageManager:u??null,next:f}):(Vi(`Created ${r}`,n),I([[`Domain`,i],[`Packages`,d?`installed with ${u}`:u?`${u} install failed. Run it in the folder.`:`not installed`]]),process.stdout.write(`
-`),z(`What is in it`,"An example site about parks, built from src/data. It already passes `seo site check`: titles, canonicals, JSON-LD, sharing images, Markdown copies, llms.txt and sitemaps are done for every page.",`Later steps replace the example data and pages with yours.`),R({title:`Next`,body:`Read the first step. Each step ends with the next one.`,command:f.join(` && `)}))}});function Qc(e){let t=Kc(e.join(` `));return Wc.find(([e])=>e===t)?.[0]}const $c=y({meta:{name:`guide`,description:`Print the instructions for one step of building the site`},args:{step:{type:`positional`,required:!1,description:Wc.map(([e])=>e).join(`, `)},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=e._?.length?e._:[C(e.step)??``];if(!n.join(``).trim()){if(t){F({steps:Wc.map(([e,t])=>({step:e,summary:t}))});return}Vi(`Build a site, one step at a time`,"Run `seo site guide <step>` and follow it before the next step."),Ki(`Steps`,Wc.map(([e,t])=>`${e}: ${t}`)),R({title:`Start here`,command:`seo site guide setup`});return}let r=Qc(n);if(!r)throw new h(`INVALID_INPUT`,`Unknown step "${n.join(` `)}". Steps: ${Wc.map(([e])=>e).join(`, `)}.`);let i=await v(g(Vc(),`guide`,`${r}.md`),`utf8`),a=Wc.findIndex(([e])=>e===r),o=Wc[a+1]?.[0];t?F({step:r,number:a+1,of:Wc.length,markdown:i,next:o?`seo site guide ${o}`:null}):process.stdout.write(i.endsWith(`
-`)?i:`${i}\n`)}});async function el(e){return(await vr(e,{withFileTypes:!0,recursive:!0})).filter(e=>e.isFile()).map(t=>er(e,g(t.parentPath,t.name)).split(nr).join(`/`))}function tl(e){Vi(e.status===`passed`?`Site check passed`:e.status===`partial`?`Site check stopped early`:`Site check failed`,e.origin),I([[`Pages`,e.pagesChecked===e.pagesFound?String(e.pagesFound):`${e.pagesChecked} of ${e.pagesFound} checked`],[`Failures`,String(e.failures)],[`Warnings`,String(e.warnings)]]),process.stdout.write(`
-`);for(let t of e.rules.slice(0,40)){let n=e.issues.filter(e=>e.rule===t.rule).slice(0,3).map(e=>e.found?`${e.file}: ${e.found}`:e.file);Ki(`${t.level===`fail`?`Fail`:`Warn`} ${t.rule} (${t.group}, ${t.count}). ${t.fix}`,t.count>n.length?[...n,`and ${t.count-n.length} more`]:n)}e.rules.length>40&&process.stdout.write(`${e.rules.length-40} more rules failed. Use --json for all of them.\n\n`),e.status===`partial`&&z(`Not every page was checked`,`The check stops at ${e.pagesChecked} pages, so it cannot say the rest pass. Split the site or build fewer, stronger pages.`),R(e.status===`passed`?{title:`Next`,body:`Deploy the build, or read the next step of the guide.`,command:`seo site guide`}:{title:`Next`,body:`Fix the template or the data behind the first rule, then build again.`,command:`pnpm build`})}const nl=y({meta:{name:`check`,description:`Check the built site and fail on any rule it breaks`},args:{dir:{type:`string`,description:`Site folder with site.config.json. Defaults to this folder.`},dist:{type:`string`,description:`Build folder. Defaults to dist inside the site folder.`},domain:{type:`string`,description:`Production domain. Defaults to the one in site.config.json.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=tr(C(e.dir)??`.`),r=tr(n,C(e.dist)??`dist`),i=g(n,`site.config.json`),a=_(i)?JSON.parse(await v(i,`utf8`)):{},o=C(e.domain)??a.domain;if(!o)throw new h(`INVALID_INPUT`,"No domain. Run this in a folder made by `seo site new`, or pass --domain.");if(!_(r))throw new h(`INVALID_INPUT`,`${r} does not exist. Build the site first with \`pnpm build\`.`);let s=await Et({origin:`https://${Jc(o)}`,files:await el(r),readText:e=>v(g(r,e),`utf8`),readBytes:e=>v(g(r,e)),allowWords:a.allowWords??[],sources:_(g(n,`src`))?{files:(await el(g(n,`src`))).map(e=>`src/${e}`),readText:e=>v(g(n,e),`utf8`)}:void 0});t?F(s):tl(s),s.status!==`passed`&&(process.exitCode=1)}}),rl=y({meta:{name:`site`,description:`Build a data-driven site on Astro and Cloudflare`},subCommands:{new:Zc,guide:$c,check:nl}}),il=`claude -p`;function al(){let e=Bc();return lr(e,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.json`)).map(t=>({subject:Zn(t.name,`.json`),path:g(e,t.name)})).sort((e,t)=>e.subject<t.subject?-1:+(e.subject>t.subject))}function ol(e,t){let n;try{n=cr(t,`utf8`)}catch{throw new h(`INVALID_INPUT`,`Cannot read eval file for ${e}.`)}let r;try{r=JSON.parse(n)}catch{throw new h(`INVALID_INPUT`,`Eval file ${e}.json is not valid JSON.`)}if(!r||typeof r!=`object`||Array.isArray(r))throw new h(`INVALID_INPUT`,`Eval file ${e}.json must be an object.`);let i=r;if(i.subject!==e)throw new h(`INVALID_INPUT`,`Eval file ${e}.json must set subject to "${e}".`);if(!Array.isArray(i.evals)||i.evals.length===0)throw new h(`INVALID_INPUT`,`Eval file ${e}.json must have a non-empty evals array.`);let a=/* @__PURE__ */ new Set;return{subject:e,evals:i.evals.map((t,n)=>{let r=t,i=`${e}.json eval ${n+1}`;if(!Number.isInteger(r?.id))throw new h(`INVALID_INPUT`,`${i}: id must be an integer.`);let o=r.id;if(a.has(o))throw new h(`INVALID_INPUT`,`${i}: duplicate id ${o}.`);if(a.add(o),typeof r.prompt!=`string`||r.prompt.trim().length===0)throw new h(`INVALID_INPUT`,`${i}: prompt must be a non-empty string.`);if(typeof r.expected_output!=`string`||r.expected_output.trim().length===0)throw new h(`INVALID_INPUT`,`${i}: expected_output must be a non-empty string.`);if(!Array.isArray(r.assertions)||r.assertions.length===0||r.assertions.some(e=>typeof e!=`string`||e.trim().length===0))throw new h(`INVALID_INPUT`,`${i}: assertions must be a non-empty array of non-empty strings.`);if(r.files!==void 0&&!Array.isArray(r.files))throw new h(`INVALID_INPUT`,`${i}: files must be an array.`);return{id:o,prompt:r.prompt,expected_output:r.expected_output,assertions:r.assertions,files:r.files??[]}})}}function sl(){let e=g(zc(),`seo`,`SKILL.md`);if(!_(e))throw new h(`INTERNAL_ERROR`,"The seo router skill could not be found. Reinstall `seo` or use --no-skill.");return cr(e,`utf8`)}function cl(e){let t=[],n=``,r=!1,i=!1,a=!1;for(let o=0;o<e.length;o+=1){let s=e[o];i?(s===`'`?i=!1:n+=s,r=!0):a?(s===`"`?a=!1:s===`\\`&&(e[o+1]===`"`||e[o+1]===`\\`)?(n+=e[o+1],o+=1):n+=s,r=!0):s===`'`?(i=!0,r=!0):s===`"`?(a=!0,r=!0):s===`\\`?o+1<e.length&&(n+=e[o+1],o+=1,r=!0):s===` `||s===`	`||s===`
-`||s===`\r`?r&&=(t.push(n),n=``,!1):(n+=s,r=!0)}if(i||a)throw new h(`INVALID_INPUT`,`Unbalanced quote in agent command.`);return r&&t.push(n),t}function ll(e,t){let n=cl(e);if(n.length===0)throw new h(`INVALID_INPUT`,`Agent command must not be empty.`);let r=n.some(e=>e.includes(`{prompt}`));return{argv:r?n.map(e=>e.split(`{prompt}`).join(t)):n,usesPlaceholder:r}}function ul(e,t){return e?`${e.trim()}\n\n---\n\nUser request:\n${t}`:t}function dl(e,t,n,r=!1){let i=[`You are judging whether an AI agent response satisfies a list of assertions.`,`Judge only against the assertions. Be strict but fair.`,``,`Original request:`,e,``,`Agent response:`,t,``,`Assertions to evaluate, in this exact order:`,`<assertions>`,n.map((e,t)=>`${t+1}. ${e}`).join(`
+`),oa(tl(t.inputSchema)),process.stdout.write(`
+`),Qi({title:`Need the exact schema?`,command:`seo reports describe ${t.id} --json`}))}}),il=x({meta:{name:`run`,description:`Run one report with JSON parameters`},args:{id:{type:`positional`,required:!0,description:"Report id from `seo reports list`."},params:{type:`string`,description:`Report parameters as a JSON object.`},"params-file":{type:`string`,description:`Read report parameters from a JSON file.`},"actions-only":{type:`boolean`,default:!1,description:`Return findings, verification, and retained inventories without the full report body.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.id)??``,n=await $c(e.params,e[`params-file`]),r=await gt(t,n,{view:E(e[`actions-only`])?`actions`:`full`});if(el(r),j(e))L(r.structuredContent??{});else for(let e of r.content)process.stdout.write(`${e.text}\n`)}}),al=x({meta:{name:`reports`,description:`Discover and run the complete report catalog`},subCommands:{list:nl,describe:rl,run:il}}),ol=x({meta:{name:`rules`,description:`List crawler rule ids and default guidance`},args:{category:{type:`string`,description:`Filter rules by category.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.category),n=d().filter(e=>!t||e.category===t);j(e)?L({rules:n}):na(n.map(e=>({id:e.id,category:e.category,name:`${e.title} · ${e.defaultSeverity}`})),{noun:`rule`})}}),sl=x({meta:{name:`explain`,description:`Explain one crawler rule in plain English`},args:{rule:{type:`string`,required:!0,description:`Rule id to explain, for example missing_title.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=T(e.rule)??``,n=Ue(t);if(!n)throw Error(`Unknown rule: ${t}`);j(e)?L(n):(R([[`Rule`,n.id],[`Title`,n.title],[`Category`,n.category],[`Severity`,n.defaultSeverity]]),process.stdout.write(`
+`),ia(`Why it matters`,n.whyItMatters),process.stdout.write(`
+`),ia(`How to fix`,n.howToFix),process.stdout.write(`
+`),ia(`Impact if ignored`,n.impactIfIgnored),process.stdout.write(`
+`),ia(`How to verify`,n.howToVerify))}});function cl(){return dl(`skills`,process.env.SEO_SKILLS_DIR)}function ll(){return dl(`evals`,process.env.SEO_EVALS_DIR)}function ul(){return dl(`site-kit`)}function dl(e,t){if(t)return ur(t);let n=sr(wr(import.meta.url));for(let t=0;t<6;t+=1){let t=v(n,e);if(y(v(t,`README.md`)))return t;n=sr(n)}throw new _(`INTERNAL_ERROR`,`Packaged ${e} could not be found. Reinstall \`seo\` and try again.`)}function fl(e){return _r(v(e,`SKILL.md`),`utf8`).match(/^description:\s*(.+)$/m)?.[1]?.trim()??``}const pl=[[`setup`,`Sign in to the accounts the site needs, one at a time`],[`market`,`Choose a market with real demand and data you can own`],[`data`,`Get, clean and keep the dataset`],[`plan`,`Plan the pages from what people search for`],[`build`,`Start the site and deploy a private preview`],[`golden-page`,`Build one page that is the best answer on the web`],[`writing`,`Write copy people enjoy and AI answers can quote`],[`scale`,`Turn the golden page into every page, with gates`],[`launch`,`Go live and get the important pages indexed`],[`grow`,`Measure with your own data and improve every week`]],ml=/* @__PURE__ */ new Set([`node_modules`,`dist`,`.astro`,`.wrangler`]);function hl(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-|-$/g,``)}function gl(e){return hl(or(e)).split(`-`).filter(Boolean).map(e=>`${e[0]?.toUpperCase()}${e.slice(1)}`).join(` `)}function _l(e){let t=(e??`example.com`).trim().toLowerCase().replace(/^https?:\/\//,``).replace(/\/.*$/,``);if(!/^(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z]{2,}$/.test(t))throw new _(`INVALID_INPUT`,`--domain must be a domain such as example.com, not ${e}.`);return t}async function vl(e,t){let n=JSON.parse(await b(e,`utf8`));t(n),await jr(e,`${JSON.stringify(n,null,2)}\n`)}function yl(){return Xo(`pnpm`,[`--version`],{stdio:`ignore`}).status===0?`pnpm`:`npm`}const bl=x({meta:{name:`new`,description:`Copy the Astro on Cloudflare starter into a new folder`},args:{folder:{type:`positional`,required:!0,description:`Folder to create. It must not exist or must be empty.`},name:{type:`string`,description:`Site name. Defaults to the folder name.`},domain:{type:`string`,description:`Production domain. Defaults to example.com until you buy one.`},install:{type:`boolean`,default:!0,description:`Install packages after copying.`,negativeDescription:`Copy the files only.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=ur(String(e.folder));if(y(n)&&(await Or(n)).some(e=>e!==`.git`))throw new _(`INVALID_INPUT`,`${n} is not empty. Choose a new folder for the site.`);let r=T(e.name)?.trim()||gl(n),i=_l(T(e.domain)),a=hl(or(n))||`site`,o=nr(16).toString(`hex`),s=v(ul(),`starter`);await Tr(s,n,{recursive:!0,filter:e=>!lr(s,e).split(dr).some(e=>ml.has(e))}),await kr(v(n,`gitignore`),v(n,`.gitignore`)),await vl(v(n,`site.config.json`),e=>{e.name=r,e.domain=i,e.indexNowKey=o}),await jr(v(n,`public`,`${o}.txt`),o),await vl(v(n,`package.json`),e=>{e.name=a;let t=e.devDependencies;t.seo=`^${on}`});let c=v(n,`wrangler.jsonc`);await jr(c,(await b(c,`utf8`)).replace(`"name": "example-site"`,`"name": ${JSON.stringify(a)}`));let l=v(n,`README.md`);await jr(l,(await b(l,`utf8`)).replace(/^# .*$/m,`# ${r}`));let u=D(e,`install`)===!0?void 0:yl(),d=!1;u&&(t||process.stdout.write(`Installing packages with ${u}...\n`),d=Xo(u,[`install`],{cwd:n,stdio:t?`ignore`:`inherit`}).status===0);let f=[`cd ${lr(process.cwd(),n)||`.`}`,`seo site guide setup`];t?L({folder:n,name:r,domain:i,installed:d,packageManager:u??null,next:f}):($i(`Created ${r}`,n),R([[`Domain`,i],[`Packages`,d?`installed with ${u}`:u?`${u} install failed. Run it in the folder.`:`not installed`]]),process.stdout.write(`
+`),ia(`What is in it`,"An example site about parks, built from src/data. It already passes `seo site check`: titles, canonicals, JSON-LD, sharing images, Markdown copies, llms.txt and sitemaps are done for every page.",`Later steps replace the example data and pages with yours.`),Qi({title:`Next`,body:`Read the first step. Each step ends with the next one.`,command:f.join(` && `)}))}});function xl(e){let t=hl(e.join(` `));return pl.find(([e])=>e===t)?.[0]}const Sl=x({meta:{name:`guide`,description:`Print the instructions for one step of building the site`},args:{step:{type:`positional`,required:!1,description:pl.map(([e])=>e).join(`, `)},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=e._?.length?e._:[T(e.step)??``];if(!n.join(``).trim()){if(t){L({steps:pl.map(([e,t])=>({step:e,summary:t}))});return}$i(`Build a site, one step at a time`,"Run `seo site guide <step>` and follow it before the next step."),aa(`Steps`,pl.map(([e,t])=>`${e}: ${t}`)),Qi({title:`Start here`,command:`seo site guide setup`});return}let r=xl(n);if(!r)throw new _(`INVALID_INPUT`,`Unknown step "${n.join(` `)}". Steps: ${pl.map(([e])=>e).join(`, `)}.`);let i=await b(v(ul(),`guide`,`${r}.md`),`utf8`),a=pl.findIndex(([e])=>e===r),o=pl[a+1]?.[0];t?L({step:r,number:a+1,of:pl.length,markdown:i,next:o?`seo site guide ${o}`:null}):process.stdout.write(i.endsWith(`
+`)?i:`${i}\n`)}});async function Cl(e){return(await Or(e,{withFileTypes:!0,recursive:!0})).filter(e=>e.isFile()).map(t=>lr(e,v(t.parentPath,t.name)).split(dr).join(`/`))}function wl(e){$i(e.status===`passed`?`Site check passed`:e.status===`partial`?`Site check stopped early`:`Site check failed`,e.origin),R([[`Pages`,e.pagesChecked===e.pagesFound?String(e.pagesFound):`${e.pagesChecked} of ${e.pagesFound} checked`],[`Failures`,String(e.failures)],[`Warnings`,String(e.warnings)]]),process.stdout.write(`
+`);for(let t of e.rules.slice(0,40)){let n=e.issues.filter(e=>e.rule===t.rule).slice(0,3).map(e=>e.found?`${e.file}: ${e.found}`:e.file);aa(`${t.level===`fail`?`Fail`:`Warn`} ${t.rule} (${t.group}, ${t.count}). ${t.fix}`,t.count>n.length?[...n,`and ${t.count-n.length} more`]:n)}e.rules.length>40&&process.stdout.write(`${e.rules.length-40} more rules failed. Use --json for all of them.\n\n`),e.status===`partial`&&ia(`Not every page was checked`,`The check stops at ${e.pagesChecked} pages, so it cannot say the rest pass. Split the site or build fewer, stronger pages.`),Qi(e.status===`passed`?{title:`Next`,body:`Deploy the build, or read the next step of the guide.`,command:`seo site guide`}:{title:`Next`,body:`Fix the template or the data behind the first rule, then build again.`,command:`pnpm build`})}const Tl=x({meta:{name:`check`,description:`Check the built site and fail on any rule it breaks`},args:{dir:{type:`string`,description:`Site folder with site.config.json. Defaults to this folder.`},dist:{type:`string`,description:`Build folder. Defaults to dist inside the site folder.`},domain:{type:`string`,description:`Production domain. Defaults to the one in site.config.json.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=ur(T(e.dir)??`.`),r=ur(n,T(e.dist)??`dist`),i=v(n,`site.config.json`),a=y(i)?JSON.parse(await b(i,`utf8`)):{},o=T(e.domain)??a.domain;if(!o)throw new _(`INVALID_INPUT`,"No domain. Run this in a folder made by `seo site new`, or pass --domain.");if(!y(r))throw new _(`INVALID_INPUT`,`${r} does not exist. Build the site first with \`pnpm build\`.`);let s=await Ot({origin:`https://${_l(o)}`,files:await Cl(r),readText:e=>b(v(r,e),`utf8`),readBytes:e=>b(v(r,e)),allowWords:a.allowWords??[],sources:y(v(n,`src`))?{files:(await Cl(v(n,`src`))).map(e=>`src/${e}`),readText:e=>b(v(n,e),`utf8`)}:void 0});t?L(s):wl(s),s.status!==`passed`&&(process.exitCode=1)}}),El=x({meta:{name:`site`,description:`Build a data-driven site on Astro and Cloudflare`},subCommands:{new:bl,guide:Sl,check:Tl}}),Dl=`claude -p`;function Ol(){let e=ll();return vr(e,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.json`)).map(t=>({subject:or(t.name,`.json`),path:v(e,t.name)})).sort((e,t)=>e.subject<t.subject?-1:+(e.subject>t.subject))}function kl(e,t){let n;try{n=_r(t,`utf8`)}catch{throw new _(`INVALID_INPUT`,`Cannot read eval file for ${e}.`)}let r;try{r=JSON.parse(n)}catch{throw new _(`INVALID_INPUT`,`Eval file ${e}.json is not valid JSON.`)}if(!r||typeof r!=`object`||Array.isArray(r))throw new _(`INVALID_INPUT`,`Eval file ${e}.json must be an object.`);let i=r;if(i.subject!==e)throw new _(`INVALID_INPUT`,`Eval file ${e}.json must set subject to "${e}".`);if(!Array.isArray(i.evals)||i.evals.length===0)throw new _(`INVALID_INPUT`,`Eval file ${e}.json must have a non-empty evals array.`);let a=/* @__PURE__ */ new Set;return{subject:e,evals:i.evals.map((t,n)=>{let r=t,i=`${e}.json eval ${n+1}`;if(!Number.isInteger(r?.id))throw new _(`INVALID_INPUT`,`${i}: id must be an integer.`);let o=r.id;if(a.has(o))throw new _(`INVALID_INPUT`,`${i}: duplicate id ${o}.`);if(a.add(o),typeof r.prompt!=`string`||r.prompt.trim().length===0)throw new _(`INVALID_INPUT`,`${i}: prompt must be a non-empty string.`);if(typeof r.expected_output!=`string`||r.expected_output.trim().length===0)throw new _(`INVALID_INPUT`,`${i}: expected_output must be a non-empty string.`);if(!Array.isArray(r.assertions)||r.assertions.length===0||r.assertions.some(e=>typeof e!=`string`||e.trim().length===0))throw new _(`INVALID_INPUT`,`${i}: assertions must be a non-empty array of non-empty strings.`);if(r.files!==void 0&&!Array.isArray(r.files))throw new _(`INVALID_INPUT`,`${i}: files must be an array.`);return{id:o,prompt:r.prompt,expected_output:r.expected_output,assertions:r.assertions,files:r.files??[]}})}}function Al(){let e=v(cl(),`seo`,`SKILL.md`);if(!y(e))throw new _(`INTERNAL_ERROR`,"The seo router skill could not be found. Reinstall `seo` or use --no-skill.");return _r(e,`utf8`)}function jl(e){let t=[],n=``,r=!1,i=!1,a=!1;for(let o=0;o<e.length;o+=1){let s=e[o];i?(s===`'`?i=!1:n+=s,r=!0):a?(s===`"`?a=!1:s===`\\`&&(e[o+1]===`"`||e[o+1]===`\\`)?(n+=e[o+1],o+=1):n+=s,r=!0):s===`'`?(i=!0,r=!0):s===`"`?(a=!0,r=!0):s===`\\`?o+1<e.length&&(n+=e[o+1],o+=1,r=!0):s===` `||s===`	`||s===`
+`||s===`\r`?r&&=(t.push(n),n=``,!1):(n+=s,r=!0)}if(i||a)throw new _(`INVALID_INPUT`,`Unbalanced quote in agent command.`);return r&&t.push(n),t}function Ml(e,t){let n=jl(e);if(n.length===0)throw new _(`INVALID_INPUT`,`Agent command must not be empty.`);let r=n.some(e=>e.includes(`{prompt}`));return{argv:r?n.map(e=>e.split(`{prompt}`).join(t)):n,usesPlaceholder:r}}function Nl(e,t){return e?`${e.trim()}\n\n---\n\nUser request:\n${t}`:t}function Pl(e,t,n,r=!1){let i=[`You are judging whether an AI agent response satisfies a list of assertions.`,`Judge only against the assertions. Be strict but fair.`,``,`Original request:`,e,``,`Agent response:`,t,``,`Assertions to evaluate, in this exact order:`,`<assertions>`,n.map((e,t)=>`${t+1}. ${e}`).join(`
 `),`</assertions>`,``,`Judge outcomes, not narration. An assertion about reading, checking, or`,`following fields or steps passes when the reply demonstrably used that`,`information or produced the result it protects, even if the reply never`,`names the field or step. Fail it only when the reply contradicts it or`,`shows the work was not done.`,``,`Reply with STRICT JSON only. No prose, no markdown, no code fence:`,`{"results":[{"assertion":"<assertion text>","pass":true,"reason":"<short reason>"}]}`,`Return exactly ${n.length} result${n.length===1?``:`s`}, one per assertion, in the same order.`].join(`
-`);return r?`${i}\n\nYour previous reply could not be parsed as the required JSON with one result per assertion. Reply again with STRICT JSON only, in the exact shape shown, and nothing else.`:i}function fl(e){let t=e.indexOf(`{`);if(t===-1)return;let n=0,r=!1,i=!1;for(let a=t;a<e.length;a+=1){let o=e[a];if(r)i?i=!1:o===`\\`?i=!0:o===`"`&&(r=!1);else if(o===`"`)r=!0;else if(o===`{`)n+=1;else if(o===`}`&&(--n,n===0))try{return JSON.parse(e.slice(t,a+1))}catch{return}}}function pl(e,t){let n=fl(e);if(!n||typeof n!=`object`)return{error:`Judge reply did not contain a JSON object.`};let r=n.results;return Array.isArray(r)?r.length===t.length?{verdicts:t.map((e,t)=>{let n=r[t];return{assertion:e,verdict:n?.pass===!0?`pass`:`fail`,reason:typeof n?.reason==`string`&&n.reason.trim().length>0?n.reason.trim():`No reason given.`,source:`judge verdict`}})}:{error:`Judge returned ${r.length} results for ${t.length} assertions.`}:{error:`Judge reply had no results array.`}}function ml(e,t){return new Promise(n=>{let r=Date.now(),[i,...a]=e,o;try{o=Cr(i,a,{stdio:[`pipe`,`pipe`,`pipe`]})}catch(e){n({stdout:``,stderr:``,code:null,timedOut:!1,spawnError:e instanceof Error?e.message:String(e),durationMs:Date.now()-r});return}let s=``,c=``,l=!1,u=!1,d,f=setTimeout(()=>{u=!0,o.kill(`SIGTERM`),d=setTimeout(()=>{try{o.kill(`SIGKILL`)}catch{}},2e3),d.unref()},t.timeoutMs),ee=e=>{l||(l=!0,clearTimeout(f),d&&clearTimeout(d),n({...e,durationMs:Date.now()-r}))};o.stdout?.on(`data`,e=>{s+=e}),o.stderr?.on(`data`,e=>{c+=e}),o.on(`error`,e=>{ee({stdout:s,stderr:c,code:null,timedOut:u,spawnError:e.message})}),o.on(`close`,e=>{ee({stdout:s,stderr:c,code:e,timedOut:u})}),o.stdin&&(t.input===void 0?o.stdin.end():o.stdin.end(t.input))})}async function hl(e,t,n){let{argv:r,usesPlaceholder:i}=ll(e,t);return ml(r,{input:i?void 0:t,timeoutMs:n})}async function gl(e,t){let n=Date.now(),r=ul(t.skillBody,e.prompt),i=await hl(t.agent,r,t.timeoutMs),a=i.stdout.trim(),o={id:e.id,prompt:e.prompt,reply:a,agentDurationMs:i.durationMs};if(i.spawnError)return{...o,status:`errored`,error:`Agent command failed to start: ${i.spawnError}`,durationMs:Date.now()-n,assertions:_l(e.assertions)};if(i.timedOut)return{...o,status:`errored`,error:`Agent timed out after ${Math.round(t.timeoutMs/1e3)}s.`,durationMs:Date.now()-n,assertions:_l(e.assertions)};if(a.length===0)return{...o,status:`errored`,error:`Agent returned no output on stdout.`,durationMs:Date.now()-n,assertions:_l(e.assertions)};if(!t.judge)return{...o,status:`unjudged`,durationMs:Date.now()-n,assertions:_l(e.assertions)};let s=0,c=``;for(let r=0;r<2;r+=1){let i=dl(e.prompt,a,e.assertions,r>0),l=await hl(t.judge,i,t.timeoutMs);if(s+=l.durationMs,l.spawnError)return{...o,status:`errored`,error:`Judge command failed to start: ${l.spawnError}`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:_l(e.assertions)};if(l.timedOut)return{...o,status:`errored`,error:`Judge timed out after ${Math.round(t.timeoutMs/1e3)}s.`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:_l(e.assertions)};let u=pl(l.stdout,e.assertions);if(`verdicts`in u){let e=u.verdicts.some(e=>e.verdict===`fail`);return{...o,status:e?`failed`:`passed`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:u.verdicts}}c=u.error}return{...o,status:`errored`,error:`Judge output could not be parsed after a retry: ${c}`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:_l(e.assertions)}}function _l(e){return e.map(e=>({assertion:e,verdict:`unjudged`}))}async function vl(e,t,n){let r=Array(e.length),i=0,a=async()=>{for(;;){let t=i;if(i+=1,t>=e.length)return;r[t]=await n(e[t],t)}},o=Math.max(1,Math.min(t,e.length));return await Promise.all(Array.from({length:o},()=>a())),r}function yl(e){let t={passed:0,failed:0,errored:0,unjudged:0};for(let n of e)t[n.status]+=1;return t}function bl(e){let t=[],n=C(e.subject);n&&t.push(n);let r=e._;if(Array.isArray(r))for(let e of r)typeof e==`string`&&e.length>0&&t.push(e);return[...new Set(t)]}function xl(e){let t=al();if(e.length===0)return t;let n=new Map(t.map(e=>[e.subject,e]));return e.map(e=>{let r=n.get(e);if(!r){let n=t.map(e=>e.subject).join(`, `);throw new h(`INVALID_INPUT`,`Unknown eval subject: ${e}.${n?` Known subjects: ${n}.`:``}`)}return r})}function Sl(e){let t=al().map(e=>{let t=ol(e.subject,e.path);return{subject:e.subject,evals:t.evals.length}});if(e){F({schemaVersion:1,subjects:t});return}if(t.length===0){process.stdout.write(`No eval subjects found.
+`);return r?`${i}\n\nYour previous reply could not be parsed as the required JSON with one result per assertion. Reply again with STRICT JSON only, in the exact shape shown, and nothing else.`:i}function Fl(e){let t=e.indexOf(`{`);if(t===-1)return;let n=0,r=!1,i=!1;for(let a=t;a<e.length;a+=1){let o=e[a];if(r)i?i=!1:o===`\\`?i=!0:o===`"`&&(r=!1);else if(o===`"`)r=!0;else if(o===`{`)n+=1;else if(o===`}`&&(--n,n===0))try{return JSON.parse(e.slice(t,a+1))}catch{return}}}function Il(e,t){let n=Fl(e);if(!n||typeof n!=`object`)return{error:`Judge reply did not contain a JSON object.`};let r=n.results;return Array.isArray(r)?r.length===t.length?{verdicts:t.map((e,t)=>{let n=r[t];return{assertion:e,verdict:n?.pass===!0?`pass`:`fail`,reason:typeof n?.reason==`string`&&n.reason.trim().length>0?n.reason.trim():`No reason given.`,source:`judge verdict`}})}:{error:`Judge returned ${r.length} results for ${t.length} assertions.`}:{error:`Judge reply had no results array.`}}function Ll(e,t){return new Promise(n=>{let r=Date.now(),[i,...a]=e,o;try{o=Pr(i,a,{stdio:[`pipe`,`pipe`,`pipe`]})}catch(e){n({stdout:``,stderr:``,code:null,timedOut:!1,spawnError:e instanceof Error?e.message:String(e),durationMs:Date.now()-r});return}let s=``,c=``,l=!1,u=!1,d,f=setTimeout(()=>{u=!0,o.kill(`SIGTERM`),d=setTimeout(()=>{try{o.kill(`SIGKILL`)}catch{}},2e3),d.unref()},t.timeoutMs),ee=e=>{l||(l=!0,clearTimeout(f),d&&clearTimeout(d),n({...e,durationMs:Date.now()-r}))};o.stdout?.on(`data`,e=>{s+=e}),o.stderr?.on(`data`,e=>{c+=e}),o.on(`error`,e=>{ee({stdout:s,stderr:c,code:null,timedOut:u,spawnError:e.message})}),o.on(`close`,e=>{ee({stdout:s,stderr:c,code:e,timedOut:u})}),o.stdin&&(t.input===void 0?o.stdin.end():o.stdin.end(t.input))})}async function Rl(e,t,n){let{argv:r,usesPlaceholder:i}=Ml(e,t);return Ll(r,{input:i?void 0:t,timeoutMs:n})}async function zl(e,t){let n=Date.now(),r=Nl(t.skillBody,e.prompt),i=await Rl(t.agent,r,t.timeoutMs),a=i.stdout.trim(),o={id:e.id,prompt:e.prompt,reply:a,agentDurationMs:i.durationMs};if(i.spawnError)return{...o,status:`errored`,error:`Agent command failed to start: ${i.spawnError}`,durationMs:Date.now()-n,assertions:Bl(e.assertions)};if(i.timedOut)return{...o,status:`errored`,error:`Agent timed out after ${Math.round(t.timeoutMs/1e3)}s.`,durationMs:Date.now()-n,assertions:Bl(e.assertions)};if(a.length===0)return{...o,status:`errored`,error:`Agent returned no output on stdout.`,durationMs:Date.now()-n,assertions:Bl(e.assertions)};if(!t.judge)return{...o,status:`unjudged`,durationMs:Date.now()-n,assertions:Bl(e.assertions)};let s=0,c=``;for(let r=0;r<2;r+=1){let i=Pl(e.prompt,a,e.assertions,r>0),l=await Rl(t.judge,i,t.timeoutMs);if(s+=l.durationMs,l.spawnError)return{...o,status:`errored`,error:`Judge command failed to start: ${l.spawnError}`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:Bl(e.assertions)};if(l.timedOut)return{...o,status:`errored`,error:`Judge timed out after ${Math.round(t.timeoutMs/1e3)}s.`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:Bl(e.assertions)};let u=Il(l.stdout,e.assertions);if(`verdicts`in u){let e=u.verdicts.some(e=>e.verdict===`fail`);return{...o,status:e?`failed`:`passed`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:u.verdicts}}c=u.error}return{...o,status:`errored`,error:`Judge output could not be parsed after a retry: ${c}`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:Bl(e.assertions)}}function Bl(e){return e.map(e=>({assertion:e,verdict:`unjudged`}))}async function Vl(e,t,n){let r=Array(e.length),i=0,a=async()=>{for(;;){let t=i;if(i+=1,t>=e.length)return;r[t]=await n(e[t],t)}},o=Math.max(1,Math.min(t,e.length));return await Promise.all(Array.from({length:o},()=>a())),r}function Hl(e){let t={passed:0,failed:0,errored:0,unjudged:0};for(let n of e)t[n.status]+=1;return t}function Ul(e){let t=[],n=T(e.subject);n&&t.push(n);let r=e._;if(Array.isArray(r))for(let e of r)typeof e==`string`&&e.length>0&&t.push(e);return[...new Set(t)]}function Wl(e){let t=Ol();if(e.length===0)return t;let n=new Map(t.map(e=>[e.subject,e]));return e.map(e=>{let r=n.get(e);if(!r){let n=t.map(e=>e.subject).join(`, `);throw new _(`INVALID_INPUT`,`Unknown eval subject: ${e}.${n?` Known subjects: ${n}.`:``}`)}return r})}function Gl(e){let t=Ol().map(e=>{let t=kl(e.subject,e.path);return{subject:e.subject,evals:t.evals.length}});if(e){L({schemaVersion:1,subjects:t});return}if(t.length===0){process.stdout.write(`No eval subjects found.
 `);return}let n=Math.max(...t.map(e=>e.subject.length));process.stdout.write(`Eval subjects
-`);for(let e of t){let t=e.evals===1?`eval`:`evals`;process.stdout.write(`  ${e.subject.padEnd(n)}  ${e.evals} ${t}\n`)}}function Cl(e){return e===`passed`?`PASS`:e===`failed`?`FAIL`:e===`errored`?`ERROR`:`UNJUDGED`}function wl(e,t){t.judged?process.stdout.write(`Assertion verdicts below are judge verdicts, model judgments from the judge agent, not ground truth.
+`);for(let e of t){let t=e.evals===1?`eval`:`evals`;process.stdout.write(`  ${e.subject.padEnd(n)}  ${e.evals} ${t}\n`)}}function Kl(e){return e===`passed`?`PASS`:e===`failed`?`FAIL`:e===`errored`?`ERROR`:`UNJUDGED`}function ql(e,t){t.judged?process.stdout.write(`Assertion verdicts below are judge verdicts, model judgments from the judge agent, not ground truth.
 
 `):process.stdout.write(`Judging was skipped. Review each agent reply against the assertion checklist by hand.
 
-`);for(let n of e){process.stdout.write(`# ${n.subject}\n`);for(let e of n.evals)if(process.stdout.write(`\n[${Cl(e.status)}] eval ${e.id} (${e.durationMs}ms)\n`),process.stdout.write(`  prompt: ${El(e.prompt,100)}\n`),e.error&&process.stdout.write(`  error: ${e.error}\n`),!t.judged){process.stdout.write(`  reply: ${El(e.reply,200)}\n`),process.stdout.write(`  assertions to review:
-`);for(let t of e.assertions)process.stdout.write(`    - [ ] ${t.assertion}\n`)}else for(let t of e.assertions){let e=t.verdict===`pass`?`pass`:t.verdict===`fail`?`fail`:`unjudged`;process.stdout.write(`  - ${e}: ${t.assertion}\n`),t.reason&&process.stdout.write(`      judge verdict: ${t.reason}\n`)}let e=yl(n.evals);process.stdout.write(`\nSubject ${n.subject}: ${e.passed} passed, ${e.failed} failed, ${e.errored} errored${e.unjudged?`, ${e.unjudged} unjudged`:``}.\n\n`)}let n=Tl(e);process.stdout.write(`Totals: ${n.passed} passed, ${n.failed} failed, ${n.errored} errored${n.unjudged?`, ${n.unjudged} unjudged`:``} across ${n.evals} evals.\n`)}function Tl(e){let t={passed:0,failed:0,errored:0,unjudged:0,evals:0};for(let n of e)t.passed+=n.passed,t.failed+=n.failed,t.errored+=n.errored,t.unjudged+=n.unjudged,t.evals+=n.evals.length;return t}function El(e,t){let n=e.replace(/\s+/g,` `).trim();return n.length>t?`${n.slice(0,t-1)}…`:n}const Dl=y({meta:{name:`eval`,description:`Run behaviour evals for the seo skill against a local agent and judge the results`},args:{subject:{type:`positional`,required:!1,description:`Eval subject (report id or job). Omit to run every subject.`},list:{type:`boolean`,default:!1,description:`List eval subjects with their eval counts and exit.`},id:{type:`string`,description:`Run one eval id within a single subject.`},agent:{type:`string`,default:il,description:`Agent command. Use {prompt} to place the prompt in argv, otherwise it is sent on stdin.`},"judge-agent":{type:`string`,description:`Judge command. Defaults to the same command as --agent.`},judge:Qr(`Judge assertions with an agent.`,`Skip judging and print replies with an assertion checklist.`),skill:Qr(`Send the seo router skill as context before the prompt.`,`Omit the seo router skill context.`),timeout:{type:`string`,default:`300`,description:`Timeout in seconds per agent or judge call.`},concurrency:{type:`string`,default:`1`,description:`Evals to run in parallel (max 4).`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e);if(e.list===!0){Sl(t);return}let n=xl(bl(e)),r=E(e.id);if(r!==void 0&&n.length!==1)throw new h(`INVALID_INPUT`,`--id needs exactly one subject. Name the subject to filter.`);let i=E(e.timeout)??300;if(!(i>0))throw new h(`INVALID_INPUT`,`--timeout must be a positive number of seconds.`);let a=Math.max(1,Math.min(4,E(e.concurrency)??1)),o=C(e.agent)??il,s=e.judge===!1?null:C(e[`judge-agent`])??o,c=e.skill===!1?null:sl(),l={agent:o,judge:s,skillBody:c,timeoutMs:i*1e3},u=[];for(let e of n){let n=ol(e.subject,e.path).evals;if(r!==void 0&&(n=n.filter(e=>e.id===r),n.length===0))throw new h(`INVALID_INPUT`,`No eval with id ${r} in subject ${e.subject}.`);t||process.stderr.write(`Running ${n.length} eval${n.length===1?``:`s`} for ${e.subject}...\n`);let i=await vl(n,a,e=>gl(e,l)),o=yl(i);u.push({subject:e.subject,...o,evals:i})}let d=Tl(u),f=d.failed>0||d.errored>0;t?F({schemaVersion:1,agent:o,judge:s,judged:s!==null,skillContext:c!==null,timeoutSeconds:i,concurrency:a,subjects:u,totals:d}):wl(u,{judged:s!==null,agent:o,judge:s}),f&&(process.exitCode=1)}});function Ol(){let e=zc();return lr(e,{withFileTypes:!0}).filter(t=>t.isDirectory()&&_(g(e,t.name,`SKILL.md`))).map(t=>({name:t.name,description:Uc(g(e,t.name)),path:g(e,t.name)})).sort((e,t)=>e.name<t.name?-1:+(e.name>t.name))}function kl(e){let t=Ol();if(!e)return t;let n=t.find(t=>t.name===e);if(!n)throw new h(`INVALID_INPUT`,`Unknown skill: ${e}.`);return[n]}const Al=y({meta:{name:`list`,description:`Show the packaged SEO skill`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=Ol();if(k(e))F({skills:t});else{Vi(`SEO skill`,`Packaged with this CLI.`),process.stdout.write(`
-`);for(let e of t)I([[`Name`,e.name],[`Purpose`,`Helps agents choose and run the right SEO audit or report.`],[`Path`,e.path]]);process.stdout.write(`
-`),R({title:`Add it to an agent`,body:`Run setup to install the skill and connect your first site.`,command:`seo start`})}}}),jl=y({meta:{name:`path`,description:`Print a packaged agent skill path`},args:{name:{type:`positional`,description:`Skill name. Omit it for the skill directory.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=C(e.name),n=t?kl(t)[0]?.path:zc();k(e)?F({name:t,path:n}):process.stdout.write(`${n}\n`)}}),Ml=y({meta:{name:`install`,description:`Install the SEO skill for coding agents`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=k(e),n=ms({quiet:t});if(t)F(n),n.status===`failed`&&(process.exitCode=1);else{if(n.status===`failed`)throw new h(`INTERNAL_ERROR`,`Skill install failed: ${n.error}`);process.stdout.write(`SEO skill installed. Agents that support skills can discover it now.
-`)}}}),Nl=y({meta:{name:`skill`,description:`Inspect the packaged SEO skill and run its evals`},subCommands:{list:Al,path:jl,install:Ml,eval:Dl}}),Pl=y({meta:{name:`privacy`,description:`Show local config, token, cache, and log storage paths`},run:async()=>{let e=Ke(),t=Hn();I(e.map(e=>[e.label,`${e.path} · ${Ji(e.sizeBytes)} · ${e.mode}`])),process.stdout.write(`
-`),I(Object.entries(t.counts).map(([e,t])=>[e,String(t)]))}}),Fl=y({meta:{name:`reset`,description:`Delete saved credentials and all local data`},args:{yes:{type:`boolean`,default:!1,description:`Confirm deletion without prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e);if(!e.yes&&!P({json:t}))throw new h(`INVALID_INPUT`,`Cannot prompt here. Pass --yes to confirm reset.`);e.yes||B(await Or({message:`Delete saved credentials and all local data?`,initialValue:!1}))?(await On(),t?F({reset:!0}):process.stdout.write(`Reset complete.
-`)):Dr(`Reset aborted.`)}}),Il=y({meta:{name:`sites`,description:`List Search Console properties available to this Google login`},args:{json:{type:`boolean`,default:!1},refresh:{type:`boolean`,default:!1},account:{type:`string`,description:`Saved Google account email.`}},run:async({args:e})=>{let t=await Pt(w(e.refresh),C(e.account));k(e)?F({sites:t}):L([`Property`,`Permission`],t.map(e=>[e.siteUrl,e.permissionLevel??`unknown`]))}}),Ll=y({meta:{name:`updates`,description:`List official Google Search Status ranking updates`},args:{product:{type:`string`,default:`Ranking`},limit:{type:`string`,default:`10`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=await ke({product:C(e.product),limit:E(e.limit)});k(e)?F({updates:t}):Gi(t.map(e=>({title:e.name,meta:[e.type,e.status,`${e.start.slice(0,10)} to ${e.end?.slice(0,10)??`present`}`]})),{empty:`No matching Google Search updates.`})}}),Rl={ci:`disabled automatically in CI or tests`,do_not_track:`disabled by DO_NOT_TRACK`,environment:`disabled by a telemetry environment variable`,local_setting:`disabled in local settings`,invalid_state:`disabled because the local state file is invalid`};function zl(e){return{enabled:e.enabled,...e.reason?{reason:e.reason}:{},stateFile:e.stateFile,...e.state?{firstRunAt:e.state.firstRunAt,cohort:e.state.cohort,sentMilestones:e.state.sentMilestones}:{}}}function Bl(e,t){let n=zl(e);t?F(n):(I([[`Anonymous telemetry`,e.enabled?`enabled`:`disabled`],[`Reason`,e.reason?Rl[e.reason]:`local setting`],[`State file`,e.stateFile],[`Install cohort`,e.state?.cohort??`not created`]]),process.stdout.write(`
+`);for(let n of e){process.stdout.write(`# ${n.subject}\n`);for(let e of n.evals)if(process.stdout.write(`\n[${Kl(e.status)}] eval ${e.id} (${e.durationMs}ms)\n`),process.stdout.write(`  prompt: ${Yl(e.prompt,100)}\n`),e.error&&process.stdout.write(`  error: ${e.error}\n`),!t.judged){process.stdout.write(`  reply: ${Yl(e.reply,200)}\n`),process.stdout.write(`  assertions to review:
+`);for(let t of e.assertions)process.stdout.write(`    - [ ] ${t.assertion}\n`)}else for(let t of e.assertions){let e=t.verdict===`pass`?`pass`:t.verdict===`fail`?`fail`:`unjudged`;process.stdout.write(`  - ${e}: ${t.assertion}\n`),t.reason&&process.stdout.write(`      judge verdict: ${t.reason}\n`)}let e=Hl(n.evals);process.stdout.write(`\nSubject ${n.subject}: ${e.passed} passed, ${e.failed} failed, ${e.errored} errored${e.unjudged?`, ${e.unjudged} unjudged`:``}.\n\n`)}let n=Jl(e);process.stdout.write(`Totals: ${n.passed} passed, ${n.failed} failed, ${n.errored} errored${n.unjudged?`, ${n.unjudged} unjudged`:``} across ${n.evals} evals.\n`)}function Jl(e){let t={passed:0,failed:0,errored:0,unjudged:0,evals:0};for(let n of e)t.passed+=n.passed,t.failed+=n.failed,t.errored+=n.errored,t.unjudged+=n.unjudged,t.evals+=n.evals.length;return t}function Yl(e,t){let n=e.replace(/\s+/g,` `).trim();return n.length>t?`${n.slice(0,t-1)}…`:n}const Xl=x({meta:{name:`eval`,description:`Run behaviour evals for the seo skill against a local agent and judge the results`},args:{subject:{type:`positional`,required:!1,description:`Eval subject (report id or job). Omit to run every subject.`},list:{type:`boolean`,default:!1,description:`List eval subjects with their eval counts and exit.`},id:{type:`string`,description:`Run one eval id within a single subject.`},agent:{type:`string`,default:Dl,description:`Agent command. Use {prompt} to place the prompt in argv, otherwise it is sent on stdin.`},"judge-agent":{type:`string`,description:`Judge command. Defaults to the same command as --agent.`},judge:li(`Judge assertions with an agent.`,`Skip judging and print replies with an assertion checklist.`),skill:li(`Send the seo router skill as context before the prompt.`,`Omit the seo router skill context.`),timeout:{type:`string`,default:`300`,description:`Timeout in seconds per agent or judge call.`},concurrency:{type:`string`,default:`1`,description:`Evals to run in parallel (max 4).`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e);if(e.list===!0){Gl(t);return}let n=Wl(Ul(e)),r=O(e.id);if(r!==void 0&&n.length!==1)throw new _(`INVALID_INPUT`,`--id needs exactly one subject. Name the subject to filter.`);let i=O(e.timeout)??300;if(!(i>0))throw new _(`INVALID_INPUT`,`--timeout must be a positive number of seconds.`);let a=Math.max(1,Math.min(4,O(e.concurrency)??1)),o=T(e.agent)??Dl,s=e.judge===!1?null:T(e[`judge-agent`])??o,c=e.skill===!1?null:Al(),l={agent:o,judge:s,skillBody:c,timeoutMs:i*1e3},u=[];for(let e of n){let n=kl(e.subject,e.path).evals;if(r!==void 0&&(n=n.filter(e=>e.id===r),n.length===0))throw new _(`INVALID_INPUT`,`No eval with id ${r} in subject ${e.subject}.`);t||process.stderr.write(`Running ${n.length} eval${n.length===1?``:`s`} for ${e.subject}...\n`);let i=await Vl(n,a,e=>zl(e,l)),o=Hl(i);u.push({subject:e.subject,...o,evals:i})}let d=Jl(u),f=d.failed>0||d.errored>0;t?L({schemaVersion:1,agent:o,judge:s,judged:s!==null,skillContext:c!==null,timeoutSeconds:i,concurrency:a,subjects:u,totals:d}):ql(u,{judged:s!==null,agent:o,judge:s}),f&&(process.exitCode=1)}});function Zl(){let e=cl();return vr(e,{withFileTypes:!0}).filter(t=>t.isDirectory()&&y(v(e,t.name,`SKILL.md`))).map(t=>({name:t.name,description:fl(v(e,t.name)),path:v(e,t.name)})).sort((e,t)=>e.name<t.name?-1:+(e.name>t.name))}function Ql(e){let t=Zl();if(!e)return t;let n=t.find(t=>t.name===e);if(!n)throw new _(`INVALID_INPUT`,`Unknown skill: ${e}.`);return[n]}const $l=x({meta:{name:`list`,description:`Show the packaged SEO skill`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=Zl();if(j(e))L({skills:t});else{$i(`SEO skill`,`Packaged with this CLI.`),process.stdout.write(`
+`);for(let e of t)R([[`Name`,e.name],[`Purpose`,`Helps agents choose and run the right SEO audit or report.`],[`Path`,e.path]]);process.stdout.write(`
+`),Qi({title:`Add it to an agent`,body:`Run setup to install the skill and connect your first site.`,command:`seo start`})}}}),eu=x({meta:{name:`path`,description:`Print a packaged agent skill path`},args:{name:{type:`positional`,description:`Skill name. Omit it for the skill directory.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=T(e.name),n=t?Ql(t)[0]?.path:cl();j(e)?L({name:t,path:n}):process.stdout.write(`${n}\n`)}}),tu=x({meta:{name:`install`,description:`Install the SEO skill for coding agents`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=j(e),n=Ps({quiet:t});if(t)L(n),n.status===`failed`&&(process.exitCode=1);else{if(n.status===`failed`)throw new _(`INTERNAL_ERROR`,`Skill install failed: ${n.error}`);process.stdout.write(`SEO skill installed. Agents that support skills can discover it now.
+`)}}}),nu=x({meta:{name:`skill`,description:`Inspect the packaged SEO skill and run its evals`},subCommands:{list:$l,path:eu,install:tu,eval:Xl}}),ru=x({meta:{name:`privacy`,description:`Show local config, token, cache, and log storage paths`},run:async()=>{let e=xe(),t=Qt();R(e.map(e=>[e.label,`${e.path} · ${sa(e.sizeBytes)} · ${e.mode}`])),process.stdout.write(`
+`),R(Object.entries(t.counts).map(([e,t])=>[e,String(t)]))}}),iu=x({meta:{name:`reset`,description:`Delete saved credentials and all local data`},args:{yes:{type:`boolean`,default:!1,description:`Confirm deletion without prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e);if(!e.yes&&!I({json:t}))throw new _(`INVALID_INPUT`,`Cannot prompt here. Pass --yes to confirm reset.`);e.yes||B(await zr({message:`Delete saved credentials and all local data?`,initialValue:!1}))?(await In(),t?L({reset:!0}):process.stdout.write(`Reset complete.
+`)):Rr(`Reset aborted.`)}}),au=x({meta:{name:`sites`,description:`List Search Console properties available to this Google login`},args:{json:{type:`boolean`,default:!1},refresh:{type:`boolean`,default:!1},account:{type:`string`,description:`Saved Google account email.`}},run:async({args:e})=>{let t=await Gn(E(e.refresh),T(e.account));j(e)?L({sites:t}):z([`Property`,`Permission`],t.map(e=>[e.siteUrl,e.permissionLevel??`unknown`]))}}),ou=x({meta:{name:`updates`,description:`List official Google Search Status ranking updates`},args:{product:{type:`string`,default:`Ranking`},limit:{type:`string`,default:`10`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=await Xe({product:T(e.product),limit:O(e.limit)});j(e)?L({updates:t}):ra(t.map(e=>({title:e.name,meta:[e.type,e.status,`${e.start.slice(0,10)} to ${e.end?.slice(0,10)??`present`}`]})),{empty:`No matching Google Search updates.`})}}),su={ci:`disabled automatically in CI or tests`,do_not_track:`disabled by DO_NOT_TRACK`,environment:`disabled by a telemetry environment variable`,local_setting:`disabled in local settings`,invalid_state:`disabled because the local state file is invalid`};function cu(e){return{enabled:e.enabled,...e.reason?{reason:e.reason}:{},stateFile:e.stateFile,...e.state?{firstRunAt:e.state.firstRunAt,cohort:e.state.cohort,sentMilestones:e.state.sentMilestones}:{}}}function lu(e,t){let n=cu(e);t?L(n):(R([[`Anonymous telemetry`,e.enabled?`enabled`:`disabled`],[`Reason`,e.reason?su[e.reason]:`local setting`],[`State file`,e.stateFile],[`Install cohort`,e.state?.cohort??`not created`]]),process.stdout.write(`
 Only tool usage is sent. URLs, report data, Google data, and identifiers are never sent.
 `),process.stdout.write(`Details: https://seoskill.dev/telemetry
-`))}const Vl={type:`boolean`,default:!1,description:`Print machine-readable JSON.`},Hl=y({meta:{name:`telemetry`,description:`Check or change anonymous usage telemetry`},subCommands:{status:y({meta:{name:`status`,description:`Show whether anonymous usage telemetry is enabled`},args:{json:Vl},run:async({args:e})=>Bl(ue(),k(e))}),enable:y({meta:{name:`enable`,description:`Enable anonymous usage telemetry in local settings`},args:{json:Vl},run:async({args:e})=>{Bl(se(!0),k(e))}}),disable:y({meta:{name:`disable`,description:`Disable anonymous usage telemetry in local settings`},args:{json:Vl},run:async({args:e})=>{Bl(se(!1),k(e))}})}});function Ul(e){let t=e.toLowerCase();return[`pass`,`passed`,`complete`,`completed`,`joined`].includes(t)?`pass`:[`warn`,`warning`,`partial`,`review`].includes(t)?`warning`:[`fail`,`failed`,`error`].includes(t)?`fail`:[`unknown`,`unavailable`].includes(t)?`unknown`:`info`}function Wl(e){let t=e.steps.map(e=>Ul(e.status)),n=t.includes(`fail`)?`fail`:t.includes(`warning`)?`warning`:t.includes(`unknown`)?`unknown`:`pass`;Ui({title:e.workflow,target:e.site,status:n,summary:e.summary,metrics:[{label:`Completed`,value:t.filter(e=>e===`pass`).length,status:`pass`},{label:`Review`,value:t.filter(e=>e===`warning`).length,status:`warning`},{label:`Unknown`,value:t.filter(e=>e===`unknown`).length,status:`unknown`}],sections:[{title:`Evidence collection`,diagnostics:e.steps.map(e=>({status:Ul(e.status),title:e.tool,explanation:e.summary,evidence:[`Status: ${e.status}`]}))},{title:`Priority actions`,diagnostics:e.actions.map(e=>({status:`warning`,title:e.title,explanation:`Confidence: ${e.confidence}.`,fix:e.action}))}]})}const Gl=y({meta:{name:`crawl-queue`,description:`Run a crawl and return a ranked implementation queue`},args:{crawlUrl:{type:`positional`,required:!1,description:`Start URL to crawl.`},url:{type:`string`,description:`Start URL to crawl. Defaults to the --site home page.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},...Qa,mode:{type:`string`,description:`Crawl mode: site, page, list, or sitemap. Defaults to site.`},urls:{type:`string`,description:`Comma-separated URLs for list mode.`},"urls-file":{type:`string`,description:`File with one URL per line for list mode.`},"max-pages":{type:`string`,description:`Maximum pages to crawl. Defaults to 500.`},"max-depth":{type:`string`,description:`Maximum click depth. Defaults to 16.`},concurrency:{type:`string`,description:`Parallel page fetches. Defaults to 8.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache and fetch fresh pages.`},include:{type:`string`,description:`Comma-separated URL patterns to include.`},exclude:{type:`string`,description:`Comma-separated URL patterns to exclude.`},limit:{type:`string`,description:`Maximum queue items to print. Defaults to 25.`},"no-sitemap":{type:`boolean`,default:!1,description:`Do not seed URLs from sitemap.xml.`},"no-robots":{type:`boolean`,default:!1,description:`Do not skip URLs disallowed by robots.txt.`},"no-external":{type:`boolean`,default:!1,description:`Do not check external links.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering when Playwright is installed.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=await Jl(e),r=ql(e),i=C(e.site),a=r??(i?eo(i):void 0)??n[0];if(!a)throw new h(`INVALID_INPUT`,"No crawl URL given. Pass a URL, --url or --site. Run `seo sites` to list your Search Console properties.");let o=await d({url:a,site:i,mode:Kl(e.mode)??(n.length?`list`:void 0),urls:n,maxPages:E(e[`max-pages`]),maxDepth:E(e[`max-depth`]),concurrency:E(e.concurrency),refresh:w(e.refresh),fetchRate:ri({...e,"fetch-concurrency":e.concurrency}),include:O(e.include),exclude:O(e.exclude),googleAnalyticsPropertyId:C(e[`google-analytics-property`]),analyticsConnection:$a(e),useSitemap:!T(e,`sitemap`),respectRobots:!T(e,`robots`),checkExternal:!T(e,`external`),js:!!w(e.js),limit:E(e.limit)});t?F(o):(Wl(o),L([`Rank`,`Score`,`Rule`,`Severity`,`Affected`,`Target`,`Action`],o.output.queue.map((e,t)=>[t+1,e.score,e.ruleId,e.severity,e.affectedUrls,e.target,e.action])),J(`Implementation queue details`,o.output.queue.map(e=>({label:`${e.ruleId} (${e.affectedUrls} URLs)`,context:`${e.severity}, score ${e.score}`,action:`${e.action} Verify with: ${e.verification.command}`}))))}});function Kl(e){let t=C(e);if(t){if([`site`,`page`,`list`,`sitemap`].includes(t))return t;throw Error(`Mode must be one of: site, page, list, sitemap.`)}}function ql(e){let t=C(e.crawlUrl),n=C(e.url);if(t&&n&&t!==n)throw Error(`Use either a URL argument or --url, not both.`);return t??n}async function Jl(e){let t=O(e.urls)??[],n=C(e[`urls-file`]);return n&&t.push(...Yl(await v(n,`utf8`))),[...new Set(t)]}function Yl(e){return e.split(/[\n,]/).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`))}const Xl=y({meta:{name:`refresh-priorities`,description:`Agent workflow for a ranked SEO action queue`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum queue items to print. Defaults to 25.`}}),...Qa,"verify-content":Qr(`Verify top opportunities against page title, meta, and content. Defaults to true.`,`Skip page content verification.`),"verify-limit":{type:`string`,description:`Maximum opportunity URLs to verify. Defaults to 5.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=A(C(e.site)),r=await We({site:n,days:E(e.days),recentDays:E(e.recent),limit:E(e.limit),includeBrand:w(e[`include-brand`]),googleAnalyticsPropertyId:C(e[`google-analytics-property`]),analyticsConnection:$a(e),verifyContent:w(e[`verify-content`]),verifyLimit:E(e[`verify-limit`]),refresh:w(e.refresh)});t?F(r):(Wl(r),L([`Source`,`Category`,`Score`,`Findings`,`Template`,`Analytics`,`Target`,`Action`],r.output.queue.map(e=>[e.source,e.category,e.score,e.grouped?.count??1,e.template?.label??`-`,e.analytics?.sessions??`-`,e.target,e.action])),J(`Queue action details`,r.output.queue.map(e=>({label:e.target,context:`${e.category}, score ${e.score}`,action:e.action}))))}});function Zl(e){return e===null?`-`:e.toLocaleString(`en-GB`,{maximumFractionDigits:e>=100?0:1})}function Ql(e){return[...e.winners.map(e=>({direction:`winner`,item:e})),...e.losers.map(e=>({direction:`loser`,item:e}))]}function $l(e,t){let n=Ql(t);n.length&&(process.stdout.write(`\n${e}\n`),L([`Direction`,`Key`,`Clicks`,`Impr.`,`Position`],n.map(({direction:e,item:t})=>[e,t.key,Zl(t.clickDelta),Zl(t.impressionDelta),Zl(t.positionDelta)])))}function eu(e){process.stdout.write(`
+`))}const uu={type:`boolean`,default:!1,description:`Print machine-readable JSON.`},du=x({meta:{name:`telemetry`,description:`Check or change anonymous usage telemetry`},subCommands:{status:x({meta:{name:`status`,description:`Show whether anonymous usage telemetry is enabled`},args:{json:uu},run:async({args:e})=>lu(Nt(),j(e))}),enable:x({meta:{name:`enable`,description:`Enable anonymous usage telemetry in local settings`},args:{json:uu},run:async({args:e})=>{lu(Dn(!0),j(e))}}),disable:x({meta:{name:`disable`,description:`Disable anonymous usage telemetry in local settings`},args:{json:uu},run:async({args:e})=>{lu(Dn(!1),j(e))}})}});function fu(e){let t=e.toLowerCase();return[`pass`,`passed`,`complete`,`completed`,`joined`].includes(t)?`pass`:[`warn`,`warning`,`partial`,`review`].includes(t)?`warning`:[`fail`,`failed`,`error`].includes(t)?`fail`:[`unknown`,`unavailable`].includes(t)?`unknown`:`info`}function pu(e){let t=e.steps.map(e=>fu(e.status)),n=t.includes(`fail`)?`fail`:t.includes(`warning`)?`warning`:t.includes(`unknown`)?`unknown`:`pass`;ta({title:e.workflow,target:e.site,status:n,summary:e.summary,metrics:[{label:`Completed`,value:t.filter(e=>e===`pass`).length,status:`pass`},{label:`Review`,value:t.filter(e=>e===`warning`).length,status:`warning`},{label:`Unknown`,value:t.filter(e=>e===`unknown`).length,status:`unknown`}],sections:[{title:`Evidence collection`,diagnostics:e.steps.map(e=>({status:fu(e.status),title:e.tool,explanation:e.summary,evidence:[`Status: ${e.status}`]}))},{title:`Priority actions`,diagnostics:e.actions.map(e=>({status:`warning`,title:e.title,explanation:`Confidence: ${e.confidence}.`,fix:e.action}))}]})}const mu=x({meta:{name:`crawl-queue`,description:`Run a crawl and return a ranked implementation queue`},args:{crawlUrl:{type:`positional`,required:!1,description:`Start URL to crawl.`},url:{type:`string`,description:`Start URL to crawl. Defaults to the --site home page.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},...po,mode:{type:`string`,description:`Crawl mode: site, page, list, or sitemap. Defaults to site.`},urls:{type:`string`,description:`Comma-separated URLs for list mode.`},"urls-file":{type:`string`,description:`File with one URL per line for list mode.`},"max-pages":{type:`string`,description:`Maximum pages to crawl. Defaults to 500.`},"max-depth":{type:`string`,description:`Maximum click depth. Defaults to 16.`},concurrency:{type:`string`,description:`Parallel page fetches. Defaults to 8.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache and fetch fresh pages.`},include:{type:`string`,description:`Comma-separated URL patterns to include.`},exclude:{type:`string`,description:`Comma-separated URL patterns to exclude.`},limit:{type:`string`,description:`Maximum queue items to print. Defaults to 25.`},"no-sitemap":{type:`boolean`,default:!1,description:`Do not seed URLs from sitemap.xml.`},"no-robots":{type:`boolean`,default:!1,description:`Do not skip URLs disallowed by robots.txt.`},"no-external":{type:`boolean`,default:!1,description:`Do not check external links.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering when Playwright is installed.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=await _u(e),r=gu(e),i=T(e.site),a=r??(i?xo(i):void 0)??n[0];if(!a)throw new _(`INVALID_INPUT`,"No crawl URL given. Pass a URL, --url or --site. Run `seo sites` to list your Search Console properties.");let o=await je({url:a,site:i,mode:hu(e.mode)??(n.length?`list`:void 0),urls:n,maxPages:O(e[`max-pages`]),maxDepth:O(e[`max-depth`]),concurrency:O(e.concurrency),refresh:E(e.refresh),fetchRate:mi({...e,"fetch-concurrency":e.concurrency}),include:A(e.include),exclude:A(e.exclude),googleAnalyticsPropertyId:T(e[`google-analytics-property`]),analyticsConnection:mo(e),useSitemap:!D(e,`sitemap`),respectRobots:!D(e,`robots`),checkExternal:!D(e,`external`),js:!!E(e.js),limit:O(e.limit)});t?L(o):(pu(o),z([`Rank`,`Score`,`Rule`,`Severity`,`Affected`,`Target`,`Action`],o.output.queue.map((e,t)=>[t+1,e.score,e.ruleId,e.severity,e.affectedUrls,e.target,e.action])),J(`Implementation queue details`,o.output.queue.map(e=>({label:`${e.ruleId} (${e.affectedUrls} URLs)`,context:`${e.severity}, score ${e.score}`,action:`${e.action} Verify with: ${e.verification.command}`}))))}});function hu(e){let t=T(e);if(t){if([`site`,`page`,`list`,`sitemap`].includes(t))return t;throw Error(`Mode must be one of: site, page, list, sitemap.`)}}function gu(e){let t=T(e.crawlUrl),n=T(e.url);if(t&&n&&t!==n)throw Error(`Use either a URL argument or --url, not both.`);return t??n}async function _u(e){let t=A(e.urls)??[],n=T(e[`urls-file`]);return n&&t.push(...vu(await b(n,`utf8`))),[...new Set(t)]}function vu(e){return e.split(/[\n,]/).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`))}const yu=x({meta:{name:`refresh-priorities`,description:`Agent workflow for a ranked SEO action queue`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum queue items to print. Defaults to 25.`}}),...po,"verify-content":li(`Verify top opportunities against page title, meta, and content. Defaults to true.`,`Skip page content verification.`),"verify-limit":{type:`string`,description:`Maximum opportunity URLs to verify. Defaults to 5.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=M(T(e.site)),r=await p({site:n,days:O(e.days),recentDays:O(e.recent),limit:O(e.limit),includeBrand:E(e[`include-brand`]),googleAnalyticsPropertyId:T(e[`google-analytics-property`]),analyticsConnection:mo(e),verifyContent:E(e[`verify-content`]),verifyLimit:O(e[`verify-limit`]),refresh:E(e.refresh)});t?L(r):(pu(r),z([`Source`,`Category`,`Score`,`Findings`,`Template`,`Analytics`,`Target`,`Action`],r.output.queue.map(e=>[e.source,e.category,e.score,e.grouped?.count??1,e.template?.label??`-`,e.analytics?.sessions??`-`,e.target,e.action])),J(`Queue action details`,r.output.queue.map(e=>({label:e.target,context:`${e.category}, score ${e.score}`,action:e.action}))))}});function bu(e){return e===null?`-`:e.toLocaleString(`en-GB`,{maximumFractionDigits:e>=100?0:1})}function xu(e){return[...e.winners.map(e=>({direction:`winner`,item:e})),...e.losers.map(e=>({direction:`loser`,item:e}))]}function Su(e,t){let n=xu(t);n.length&&(process.stdout.write(`\n${e}\n`),z([`Direction`,`Key`,`Clicks`,`Impr.`,`Position`],n.map(({direction:e,item:t})=>[e,t.key,bu(t.clickDelta),bu(t.impressionDelta),bu(t.positionDelta)])))}function Cu(e){process.stdout.write(`
 Segment coverage
-`),L([`Dimension`,`Eligible`,`Returned`,`Limited`,`Result cap`,`Source cap`,`Source capped`],[`page`,`query`,`device`,`country`].map(t=>{let n=e[t].coverage;return[t,n.eligibleRows,n.returnedRows,n.limitedRows,n.resultLimit,n.sourceRowLimit,n.sourcePossiblyTruncated?`yes`:`no`]}))}function tu(e){e.length&&(process.stdout.write(`
+`),z([`Dimension`,`Eligible`,`Returned`,`Limited`,`Result cap`,`Source cap`,`Source capped`],[`page`,`query`,`device`,`country`].map(t=>{let n=e[t].coverage;return[t,n.eligibleRows,n.returnedRows,n.limitedRows,n.resultLimit,n.sourceRowLimit,n.sourcePossiblyTruncated?`yes`:`no`]}))}function wu(e){e.length&&(process.stdout.write(`
 Template movement
-`),L([`Direction`,`Template`,`Pattern confidence`,`URLs`,`Clicks`,`Returned share`,`Common terms`],e.map(e=>[e.direction,e.signature,e.confidence,e.urlCount,Zl(e.clickDelta),`${Math.round(e.movementShare*100)}%`,e.commonTerms.join(`, `)||`-`])),Y(`Template actions`,e.map(e=>e.summary)),Y(`Template evidence scope`,[`Shares use returned directional page click movement. Pattern confidence applies only to returned matched-retained page segments.`]))}const nu=y({meta:{name:`update-postmortem`,description:`Agent workflow for Google update winner/loser analysis`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum winners/losers per segment. Defaults to 20.`}}),"known-change":{type:`string`,description:`Manual site-side change to treat as a confounder, for example pruning pages or blocking traffic.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=k(e),n=A(C(e.site)),r=await Bn({site:n,days:E(e.days),recentDays:E(e.recent),limit:E(e.limit),includeBrand:w(e[`include-brand`]),knownConfounders:C(e[`known-change`])?[C(e[`known-change`])??``]:void 0,refresh:w(e.refresh)});t?F(r):(K({title:`Update postmortem`,target:r.site,status:`unknown`,summary:r.summary,metrics:[{label:`Attribution`,value:r.output.update.attribution.replaceAll(`-`,` `)},{label:`Confidence`,value:r.output.update.confidence},{label:`Known confounders`,value:r.output.update.confounders.length}]}),Y(`Recommended actions`,r.actions.map(e=>`${e.title} (${e.confidence}): ${e.action}`)),Y(`Postmortem findings`,r.output.insights.map(e=>e.summary)),Y(`Segment evidence warnings`,[...r.output.segments.page.warnings,...r.output.segments.query.warnings,...r.output.segments.device.warnings,...r.output.segments.country.warnings].filter((e,t,n)=>n.indexOf(e)===t)),tu(r.output.templateMovement),Y(`Update evidence`,r.output.update.evidence),eu(r.output.segments),$l(`Page winners and losers`,r.output.segments.page),$l(`Query winners and losers`,r.output.segments.query),$l(`Device winners and losers`,r.output.segments.device),$l(`Country winners and losers`,r.output.segments.country),La(`seo export update-postmortem --site ${JSON.stringify(n)}`))}}),ru=/* @__PURE__ */ new Set([`database`,`filesystem`,`internal`,`unknown`]);function iu(e){return e.replace(/^v/,``).split(`.`)[0]||`unknown`}function au(e){return t(e[0])?e[0]:void 0}function ou(e,t){return tt(e)?`seo ${e}`:t?`seo ${t}`:`seo command`}function su(e){let t=Le(e.error);if(!ru.has(t.errorCategory))return;let n=au(e.args),r=ou(e.report,n),i=[en(e.error).code,t.errorCategory,t.failureReason,t.failureContext].filter(Boolean).join(` | `),a=new URL(`https://github.com/iannuttall/seo/issues/new`);return a.searchParams.set(`template`,`bug.yml`),a.searchParams.set(`title`,`bug: ${r} failed`),a.searchParams.set(`version`,e.version??ut),a.searchParams.set(`runtime`,`Node ${iu(e.nodeVersion??process.version)} on ${e.processPlatform??Xn()} (${e.processArch??Jn()})`),a.searchParams.set(`diagnostics`,i),a.toString()}const cu={"refresh-priorities":`seo report`,"query-cluster":`seo report`,"quick-wins":`seo report --section quick-wins`,"ctr-underperformers":`seo report --section low-ctr`,"striking-distance":`seo report --section striking-distance`,"second-page":`seo report --section second-page`,decaying:`seo report --section content-decay`,cannibal:`seo report --section cannibalization`,"traffic-anomaly":`seo report --section traffic-drop`,"page-opportunities":`seo page --url <url>`,"audit-page":`seo page --url <url>`,"url-inspect":`seo page --url <url>`,"segment-impact":`seo compare --date <date>`,"update-correlate":`seo compare --date <date>`,"update-postmortem":`seo compare --date <date>`,"link-recover":`seo index`,"gsc-query":`seo data`},lu={"agent-readiness":null,"ai-readiness":null,"community-intent":null,"entity-readiness":null,llms:null,"monthly-report":`seo report`,okf:null,pseo:null,"report-narrative":`seo report`,"seo-to-ai-query":null,"server-logs":null,links:`seo research backlinks --target <domain>`,"export knowledge":null,"export monthly":`seo report --json`,"export narrative":`seo report --json`,"export pseo":null,indexnow:null,"providers semrush":`seo providers`,"providers limits":null,"providers spend":null,"providers dataforseo limits":null,"providers dataforseo spend":null,"providers ahrefs limits":null,"change-log":null,client:null,project:null,projects:null,"content-groups":null,"crawl-diff":`seo crawl`,"crawl-reports":`seo crawl`,diagnose:`seo report`,"diagnose-property":`seo report`,"export diagnose":`seo report --json`,"index-watch":`seo page --url <url>`,monitoring:`seo crawl`,schedule:null,"technical-watch":`seo crawl`,tests:`seo compare --date <date>`},Z=`It saved history between runs. Your agent keeps its own notes now.`,uu=`Commands take --site now instead of a saved project.`,du=`Spend is controlled in your provider account. Set limits in DataForSEO, Ahrefs or the other provider.`,fu={"providers limits":du,"providers spend":du,"providers dataforseo limits":du,"providers dataforseo spend":du,"providers ahrefs limits":du,"change-log":Z,client:uu,project:uu,projects:uu,"content-groups":Z,"crawl-diff":Z,"crawl-reports":Z,diagnose:Z,"diagnose-property":Z,"export diagnose":Z,"index-watch":Z,monitoring:Z,schedule:Z,"technical-watch":Z,tests:Z},pu=/* @__PURE__ */ new Set([`client`,`project`,`projects`]);function mu(e){let t=e.findIndex(e=>e.startsWith(`-`)),n=t===-1?e:e.slice(0,t),r=+(n[0]===`help`);for(let e=3;e>=1;--e){let t=n.slice(r,r+e).join(` `);if(n.length-r>=e&&Object.hasOwn(lu,t))return t}return null}function hu(e){let t=Object.hasOwn(cu,e)?cu[e]:void 0;return t?`\`seo ${e}\` is now \`${t}\`. The old name stops working in 1.0.0.`:null}function gu(e){let t=mu(e);if(!t)return null;let n=lu[t],r=t.split(` `)[0]??``,i=n?`Use \`${n}\` instead.`:pu.has(r)?"Run `seo sites` to list your Search Console properties.":r===`providers`?"Run `seo providers --help` for the provider commands.":"Run `seo help` for the commands.";return`\`seo ${t}\` was removed. ${Object.hasOwn(fu,t)?fu[t]:`SEO Skill now focuses on Search Console, analytics and keyword data.`} ${i}`}const _u={"internal-links":[`--days`,`--limit`,`--check-limit`,`--min-impressions`,`--brand-terms`,`--include-brand`,`--no-include-brand`,`--js`,`--no-js`,`--fetch-concurrency`,`--fetch-interval-cap`,`--fetch-interval-ms`]},vu=e=>e.split(`=`)[0]??``;function yu(e){let t=e.find(e=>[`--project`,`--client`].includes(vu(e)));if(t)return`\`${vu(t)}\` was removed. ${uu} Pass --site with a domain, URL or sc-domain: property, or run \`seo sites\` to list your Search Console properties.`;let n=e[0]??``,r=Object.hasOwn(_u,n)?e.find(e=>_u[n]?.includes(vu(e))):void 0;if(!r)return null;let i=vu(r);return`\`${i}\` was removed from \`seo ${n}\`. It now sets its own limits, brand terms and page fetching, and shows them in the output.${i===`--days`?` Pass --start-date and --end-date for other dates.`:``}`}function bu(e){return e.replaceAll(`\\`,`/`).toLowerCase()}function xu(e,t){return t===`win32`?`${e}.cmd`:e}function Su(e,t=process.platform){let n=bu(e);if(!(n.includes(`/_npx/`)||n.includes(`/.npm/_npx/`)||n.includes(`/.cache/pnpm/dlx/`)||n.includes(`/.volta/`))){if(n.includes(`/.pnpm/`)||n.includes(`/pnpm/global/`))return{command:xu(`pnpm`,t),args:[`add`,`--global`,`seo@latest`]};if(n.includes(`/.bun/install/global/`))return{command:xu(`bun`,t),args:[`add`,`--global`,`seo@latest`]};if(n.includes(`/.config/yarn/global/`))return{command:xu(`yarn`,t),args:[`global`,`add`,`seo@latest`]};if(n.includes(`/node_modules/seo/`))return{command:xu(`npm`,t),args:[`install`,`--global`,`seo@latest`]}}}function Cu(e){return!(!e.stdinIsTty||!e.stdoutIsTty||e.env.CI||e.env.NO_UPDATE_NOTIFIER||e.env.NODE_ENV===`test`||e.env.npm_lifecycle_event||e.env.npm_execpath||e.env.TERM===`dumb`||e.argv.includes(`--json`)||e.argv.some(e=>[`--help`,`-h`,`--version`,`-v`].includes(e))||[`help`,`mcp`].includes(e.argv[0]??``))}function wu(e){if(e)try{return ur(e)}catch{return e}}async function Tu(e){let t=await Pr({message:`seo ${e.update.latest} is available. You have ${e.update.current}.`,options:[{value:`update`,label:`Update now`,hint:[e.command.command,...e.command.args].join(` `)},{value:`later`,label:`Later`}],initialValue:`later`});return Ar(t)?`later`:t}function Eu(e){return Ao(e.command,e.args,{stdio:`inherit`}).status}async function Du(e,t={}){if(!Cu({argv:t.argv??process.argv.slice(2),env:t.env??process.env,stdinIsTty:t.stdinIsTty??!!process.stdin.isTTY,stdoutIsTty:t.stdoutIsTty??!!process.stdout.isTTY}))return;let n=wu(t.cliPath??process.argv[1]),r=n?Su(n,t.platform??process.platform):void 0;if(!r)return;let i=(t.createNotifier??(e=>Wr({pkg:e,shouldNotifyInNpmScript:!1})))(e).update;if(i&&St(i.current,i.latest)&&await(t.prompt??Tu)({command:r,update:i})!==`later`)return(t.run??Eu)(r)===0?(jr.success(`Updated seo to ${i.latest}. Run your command again.`),0):(jr.error(`The update failed. Your current version is unchanged.`),1)}function Ou(e){if(process.stderr.isTTY&&!process.env.CI&&!(e.includes(`--json`)||e[0]===`mcp`))try{let{configDir:e,configFile:t}=En();if(!_(t))return;let n=g(e,`notices.json`),r=_(n)?JSON.parse(cr(n,`utf8`)):[];if(r.includes(`0.4`))return;process.stderr.write(`
+`),z([`Direction`,`Template`,`Pattern confidence`,`URLs`,`Clicks`,`Returned share`,`Common terms`],e.map(e=>[e.direction,e.signature,e.confidence,e.urlCount,bu(e.clickDelta),`${Math.round(e.movementShare*100)}%`,e.commonTerms.join(`, `)||`-`])),Y(`Template actions`,e.map(e=>e.summary)),Y(`Template evidence scope`,[`Shares use returned directional page click movement. Pattern confidence applies only to returned matched-retained page segments.`]))}const Tu=x({meta:{name:`update-postmortem`,description:`Agent workflow for Google update winner/loser analysis`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum winners/losers per segment. Defaults to 20.`}}),"known-change":{type:`string`,description:`Manual site-side change to treat as a confounder, for example pruning pages or blocking traffic.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=j(e),n=M(T(e.site)),r=await g({site:n,days:O(e.days),recentDays:O(e.recent),limit:O(e.limit),includeBrand:E(e[`include-brand`]),knownConfounders:T(e[`known-change`])?[T(e[`known-change`])??``]:void 0,refresh:E(e.refresh)});t?L(r):(K({title:`Update postmortem`,target:r.site,status:`unknown`,summary:r.summary,metrics:[{label:`Attribution`,value:r.output.update.attribution.replaceAll(`-`,` `)},{label:`Confidence`,value:r.output.update.confidence},{label:`Known confounders`,value:r.output.update.confounders.length}]}),Y(`Recommended actions`,r.actions.map(e=>`${e.title} (${e.confidence}): ${e.action}`)),Y(`Postmortem findings`,r.output.insights.map(e=>e.summary)),Y(`Segment evidence warnings`,[...r.output.segments.page.warnings,...r.output.segments.query.warnings,...r.output.segments.device.warnings,...r.output.segments.country.warnings].filter((e,t,n)=>n.indexOf(e)===t)),wu(r.output.templateMovement),Y(`Update evidence`,r.output.update.evidence),Cu(r.output.segments),Su(`Page winners and losers`,r.output.segments.page),Su(`Query winners and losers`,r.output.segments.query),Su(`Device winners and losers`,r.output.segments.device),Su(`Country winners and losers`,r.output.segments.country),Za(`seo export update-postmortem --site ${JSON.stringify(n)}`))}}),Eu=/* @__PURE__ */ new Set([`database`,`filesystem`,`internal`,`unknown`]);function Du(e){return e.replace(/^v/,``).split(`.`)[0]||`unknown`}function Ou(e){return At(e[0])?e[0]:void 0}function ku(e,t){return pn(e)?`seo ${e}`:t?`seo ${t}`:`seo command`}function Au(e){let t=Rn(e.error);if(!Eu.has(t.errorCategory))return;let n=Ou(e.args),r=ku(e.report,n),i=[Yn(e.error).code,t.errorCategory,t.failureReason,t.failureContext].filter(Boolean).join(` | `),a=new URL(`https://github.com/iannuttall/seo/issues/new`);return a.searchParams.set(`template`,`bug.yml`),a.searchParams.set(`title`,`bug: ${r} failed`),a.searchParams.set(`version`,e.version??on),a.searchParams.set(`runtime`,`Node ${Du(e.nodeVersion??process.version)} on ${e.processPlatform??ar()} (${e.processArch??rr()})`),a.searchParams.set(`diagnostics`,i),a.toString()}const ju={"refresh-priorities":`seo report`,"query-cluster":`seo report`,"quick-wins":`seo report --section quick-wins`,"ctr-underperformers":`seo report --section low-ctr`,"striking-distance":`seo report --section striking-distance`,"second-page":`seo report --section second-page`,decaying:`seo report --section content-decay`,cannibal:`seo report --section cannibalization`,"traffic-anomaly":`seo report --section traffic-drop`,"page-opportunities":`seo page --url <url>`,"audit-page":`seo page --url <url>`,"url-inspect":`seo page --url <url>`,"segment-impact":`seo compare --date <date>`,"update-correlate":`seo compare --date <date>`,"update-postmortem":`seo compare --date <date>`,"link-recover":`seo index`,"gsc-query":`seo data`},Mu={"agent-readiness":null,"ai-readiness":null,"community-intent":null,"entity-readiness":null,llms:null,"monthly-report":`seo report`,okf:null,pseo:null,"report-narrative":`seo report`,"seo-to-ai-query":null,"server-logs":null,links:`seo research backlinks --target <domain>`,"export knowledge":null,"export monthly":`seo report --json`,"export narrative":`seo report --json`,"export pseo":null,indexnow:null,"providers semrush":`seo providers`,"providers limits":null,"providers spend":null,"providers dataforseo limits":null,"providers dataforseo spend":null,"providers ahrefs limits":null,"change-log":null,client:null,project:null,projects:null,"content-groups":null,"crawl-diff":`seo crawl`,"crawl-reports":`seo crawl`,diagnose:`seo report`,"diagnose-property":`seo report`,"export diagnose":`seo report --json`,"index-watch":`seo page --url <url>`,monitoring:`seo crawl`,schedule:null,"technical-watch":`seo crawl`,tests:`seo compare --date <date>`},Z=`It saved history between runs. Your agent keeps its own notes now.`,Nu=`Commands take --site now instead of a saved project.`,Pu=`Spend is controlled in your provider account. Set limits in DataForSEO, Ahrefs or the other provider.`,Fu={"providers limits":Pu,"providers spend":Pu,"providers dataforseo limits":Pu,"providers dataforseo spend":Pu,"providers ahrefs limits":Pu,"change-log":Z,client:Nu,project:Nu,projects:Nu,"content-groups":Z,"crawl-diff":Z,"crawl-reports":Z,diagnose:Z,"diagnose-property":Z,"export diagnose":Z,"index-watch":Z,monitoring:Z,schedule:Z,"technical-watch":Z,tests:Z},Iu=/* @__PURE__ */ new Set([`client`,`project`,`projects`]);function Lu(e){let t=e.findIndex(e=>e.startsWith(`-`)),n=t===-1?e:e.slice(0,t),r=+(n[0]===`help`);for(let e=3;e>=1;--e){let t=n.slice(r,r+e).join(` `);if(n.length-r>=e&&Object.hasOwn(Mu,t))return t}return null}function Ru(e){let t=Object.hasOwn(ju,e)?ju[e]:void 0;return t?`\`seo ${e}\` is now \`${t}\`. The old name stops working in 1.0.0.`:null}function zu(e){let t=Lu(e);if(!t)return null;let n=Mu[t],r=t.split(` `)[0]??``,i=n?`Use \`${n}\` instead.`:Iu.has(r)?"Run `seo sites` to list your Search Console properties.":r===`providers`?"Run `seo providers --help` for the provider commands.":"Run `seo help` for the commands.";return`\`seo ${t}\` was removed. ${Object.hasOwn(Fu,t)?Fu[t]:`SEO Skill now focuses on Search Console, analytics and keyword data.`} ${i}`}const Bu={"internal-links":[`--days`,`--limit`,`--check-limit`,`--min-impressions`,`--brand-terms`,`--include-brand`,`--no-include-brand`,`--js`,`--no-js`,`--fetch-concurrency`,`--fetch-interval-cap`,`--fetch-interval-ms`]},Vu=e=>e.split(`=`)[0]??``;function Hu(e){let t=e.find(e=>[`--project`,`--client`].includes(Vu(e)));if(t)return`\`${Vu(t)}\` was removed. ${Nu} Pass --site with a domain, URL or sc-domain: property, or run \`seo sites\` to list your Search Console properties.`;let n=e[0]??``,r=Object.hasOwn(Bu,n)?e.find(e=>Bu[n]?.includes(Vu(e))):void 0;if(!r)return null;let i=Vu(r);return`\`${i}\` was removed from \`seo ${n}\`. It now sets its own limits, brand terms and page fetching, and shows them in the output.${i===`--days`?` Pass --start-date and --end-date for other dates.`:``}`}function Uu(e){return e.replaceAll(`\\`,`/`).toLowerCase()}function Wu(e,t){return t===`win32`?`${e}.cmd`:e}function Gu(e,t=process.platform){let n=Uu(e);if(!(n.includes(`/_npx/`)||n.includes(`/.npm/_npx/`)||n.includes(`/.cache/pnpm/dlx/`)||n.includes(`/.volta/`))){if(n.includes(`/.pnpm/`)||n.includes(`/pnpm/global/`))return{command:Wu(`pnpm`,t),args:[`add`,`--global`,`seo@latest`]};if(n.includes(`/.bun/install/global/`))return{command:Wu(`bun`,t),args:[`add`,`--global`,`seo@latest`]};if(n.includes(`/.config/yarn/global/`))return{command:Wu(`yarn`,t),args:[`global`,`add`,`seo@latest`]};if(n.includes(`/node_modules/seo/`))return{command:Wu(`npm`,t),args:[`install`,`--global`,`seo@latest`]}}}function Ku(e){return!(!e.stdinIsTty||!e.stdoutIsTty||e.env.CI||e.env.NO_UPDATE_NOTIFIER||e.env.NODE_ENV===`test`||e.env.npm_lifecycle_event||e.env.npm_execpath||e.env.TERM===`dumb`||e.argv.includes(`--json`)||e.argv.some(e=>[`--help`,`-h`,`--version`,`-v`].includes(e))||[`help`,`mcp`].includes(e.argv[0]??``))}function qu(e){if(e)try{return yr(e)}catch{return e}}async function Ju(e){let t=await Gr({message:`seo ${e.update.latest} is available. You have ${e.update.current}.`,options:[{value:`update`,label:`Update now`,hint:[e.command.command,...e.command.args].join(` `)},{value:`later`,label:`Later`}],initialValue:`later`});return Vr(t)?`later`:t}function Yu(e){return Xo(e.command,e.args,{stdio:`inherit`}).status}async function Xu(e,t={}){if(!Ku({argv:t.argv??process.argv.slice(2),env:t.env??process.env,stdinIsTty:t.stdinIsTty??!!process.stdin.isTTY,stdoutIsTty:t.stdoutIsTty??!!process.stdout.isTTY}))return;let n=qu(t.cliPath??process.argv[1]),r=n?Gu(n,t.platform??process.platform):void 0;if(!r)return;let i=(t.createNotifier??(e=>ti({pkg:e,shouldNotifyInNpmScript:!1})))(e).update;if(i&&wt(i.current,i.latest)&&await(t.prompt??Ju)({command:r,update:i})!==`later`)return(t.run??Yu)(r)===0?(Hr.success(`Updated seo to ${i.latest}. Run your command again.`),0):(Hr.error(`The update failed. Your current version is unchanged.`),1)}function Zu(e){if(process.stderr.isTTY&&!process.env.CI&&!(e.includes(`--json`)||e[0]===`mcp`))try{let{configDir:e,configFile:t}=xn();if(!y(t))return;let n=v(e,`notices.json`),r=y(n)?JSON.parse(_r(n,`utf8`)):[];if(r.includes(`0.4`))return;process.stderr.write(`
 SEO Skill 0.4: eight commands replace the old reports, and projects are gone: every command takes --site (run \`seo sites\` to list yours). Old command names print what to use instead.
 Free hosted MCP server, nothing to install: https://seoskill.dev/docs/mcp
 To stay on the old version: npm i -g seo@0.2.41
 What changed: https://github.com/iannuttall/seo/blob/main/CHANGELOG.md
 
-`),mr(n,JSON.stringify([...r,`0.4`]),{mode:384})}catch{}}const ku={name:`seo`,version:ut},Au=[{title:`Start here`,commands:[[`seo start`,`Sign in with Google, then add the MCP server and skill`],[`seo report`,`Last week across your audited sites (beta, after seo login)`],[`seo report --site <site>`,`One site: overview and every section`],[`seo report --site <site> --section quick-wins`,`One section of the report, with live page checks`]]},{title:`Commands`,commands:[[`seo page --url <url>`,`One page: live facts, index status, queries`],[`seo compare --date <date>`,`Before and after a date`],[`seo index`,`Pages that lost most of their clicks`],[`seo research <action>`,`Keyword, SERP, competitor and backlink data from your key`],[`seo data`,`Raw Search Console, Bing or Clicky rows`],[`seo crawl`,`Crawl a site and list technical issues`],[`seo internal-links`,`Pages that could link to a target page`],[`seo lint <files>`,`Check copy for AI writing patterns and length`],[`seo site new <folder>`,`Start a data-driven site on Astro and Cloudflare`]]},{title:`Setup`,commands:[[`seo login`,`Use your seoskill.dev account on this machine`],[`seo sites`,`List Search Console properties`],[`seo mcp install`,`Add the local MCP server to your agents`],[`seo providers`,`Connect DataForSEO or Ahrefs`],[`seo doctor`,`Check local auth and config`]]}],ju=[...Au,{title:`More commands`,commands:[[`seo crawl-queue`,`Run a crawl and rank the fix queue`],[`seo rules`,`List crawler rule ids`],[`seo explain --rule missing_title`,`Explain a crawler rule`],[`seo redirect-trace`,`Trace redirects`],[`seo perf audit`,`Run a page performance audit`],[`seo index-coverage`,`Choose pages for URL Inspection`],[`seo ai-referrals`,`AI referral traffic in Google Analytics`],[`seo analytics google report`,`Google Analytics landing pages for visits from search`],[`seo updates`,`List official Google ranking updates`],[`seo export`,`Export report data to CSV`],[`seo reports list`,`List every structured report`],[`seo skill list`,`Show the packaged SEO skill`],[`seo auth`,`Manage Google auth`],[`seo cache`,`Manage local cache`],[`seo privacy`,`Show local storage paths`],[`seo telemetry status`,`Check anonymous usage telemetry`],[`seo reset`,`Delete saved credentials and all local data`]]}];function Mu(e){Vi(`seo v${ku.version}`,`Your own Search Console, Google Analytics and Bing data, as facts for your agent.`),process.stdout.write(`
-`),Wi(e.flatMap(e=>e.commands.map(([t,n])=>({category:e.title,id:t,name:n}))),{noun:`command`,categoryLabels:Object.fromEntries(e.map(e=>[e.title,e.title]))}),process.stdout.write(`
-`),z(`More help`,"Use `seo help <command>` or `seo <command> --help` for command help.","Use `seo help all` for the longer command list.")}const Nu=y({meta:{name:`seo`,version:ku.version,description:`Local-first SEO CLI and MCP server`},subCommands:{init:As,analytics:Sa,auth:ka,mcp:Ps,doctor:ec,privacy:Pl,telemetry:Hl,reset:Fl,cache:Ma,logs:js,crawl:io,"crawl-queue":Gl,content:Ra,providers:Dc,export:ko,"index-coverage":Fs,"link-recover":Is,rules:Lc,explain:Rc,"refresh-priorities":Xl,"redirect-trace":Ls,skill:Nl,start:ks,setup:Os,site:rl,login:us,logout:ps,report:na,page:ra,compare:ia,index:aa,data:oa,research:sa,lint:ca,reports:Ic,"segment-impact":nc,"striking-distance":ic,"update-postmortem":nu,sites:Il,"gsc-query":mo,"url-inspect":ho,updates:Ll,"traffic-anomaly":yo,"update-correlate":bo,"ai-referrals":Rs,"audit-page":Ys,"second-page":Js,cannibal:zs,decaying:Hs,"quick-wins":qs,"page-opportunities":Gs,perf:$s,"internal-links":Ws,"ctr-underperformers":Bs,"query-cluster":Ks},run:async()=>{process.argv.slice(2).length===0&&process.stdout.write("Use `seo start` to set up, then `seo report` for the main report.\n")}}),Pu={cannibal:`cannibalisation`,crawl:`site-crawl`,"crawl-queue":`top-fixes`,decaying:`decaying-pages`,doctor:`setup-check`,explain:`explain-crawl-issue`,"link-recover":`link-recovery`,"query-cluster":`query-clusters`,report:`search-performance-overview`,rules:`crawler-rules`,"update-correlate":`update-correlation`},Fu=/* @__PURE__ */ new Set([`ai-referrals`,`audit-page`,`ctr-underperformers`,`index-coverage`,`internal-links`,`page-opportunities`,`quick-wins`,`redirect-trace`,`refresh-priorities`,`second-page`,`segment-impact`,`striking-distance`,`traffic-anomaly`,`update-postmortem`]),Iu=new Set(ln().map(e=>e.id));function Lu(e,t){let n=e.indexOf(t);return n>=0?e[n+1]:e.find(e=>e.startsWith(`${t}=`))?.slice(t.length+1)}function Ru(e){let[t,n,r]=e;if(t)return t in Wt?oe(t,{section:Lu(e,`--section`),action:n})??void 0:t===`reports`&&n===`run`?r&&Iu.has(r)?r:void 0:t===`content`&&n===`optimize`?`content-optimization`:t===`perf`&&n===`audit`?`performance-audit`:Pu[t]??(Fu.has(t)?t:void 0)}const zu=process.argv.slice(2);function Bu(e){let t=e[1];return t&&[`list`,`describe`,`run`,`-h`,`--help`].includes(t)?e:t===void 0?[`reports`,`list`]:t.startsWith(`-`)?(process.stderr.write("Running `seo report`: `seo reports` lists reports.\n"),[`report`,...e.slice(1)]):[`reports`,`run`,...e.slice(1)]}const Q=zu[0]===`mcp`&&(zu[1]===void 0||/^-(?!h$|-help$)/.test(zu[1]))&&!process.stdin.isTTY?[`mcp`,`serve`,...zu.slice(1)]:zu[0]===`reports`?Bu(zu):zu;Ou(Q);const Vu=gu(Q)??yu(Q);Vu&&(process.stderr.write(`${Vu}\n`),process.exit(2));const Hu=hu(Q[0]??``);Hu&&!Q.some(e=>[`--help`,`-h`].includes(e))&&process.stderr.write(`${Hu}\n`);const Uu={agent:Qe()},Wu=Q[0]===`telemetry`,Gu=Q[0]===`mcp`&&Q[1]===`serve`;!Wu&&!Gu&&Ye(Uu),Gu||Qt();const Ku=await Du(ku,{argv:Q});Ku!==void 0&&process.exit(Ku),(Q.length===0||Q.length===1&&[`help`,`--help`,`-h`].includes(Q[0]??``))&&(Mu(Au),process.exit(0)),Q[0]===`help`&&Q[1]===`all`&&(Mu(ju),process.exit(0));const $=Q[0]===`help`&&Q.length>1?[...Q.slice(1),`--help`]:Q;$!==Q&&(process.argv=[process.argv[0]??`node`,process.argv[1]??`seo`,...$]);const qu=$.some(e=>[`--help`,`-h`].includes(e)),Ju=Q.length===1&&[`--version`,`-v`].includes(Q[0]??``),Yu=qu||Ju?void 0:Ru($);if(qu||Ju)await Er(Nu);else{Yu&&st(Yu,Uu);let e=Q.includes(`--json`);try{await Tr(Nu,{rawArgs:$}),Yu&&_n(Yu,Uu),[`init`,`setup`,`start`].includes($[0]??``)&&!$.includes(`--dry-run`)&&it(Uu)}catch(t){if(t?.code===`E_NO_COMMAND`&&await Er(Nu,{rawArgs:[...$,`--help`]}),Yu)ge(Yu,t,Uu);else if(!Wu){let e=au($);e&&ye(e,t,Uu)}let n=en(t);if(e){let e=Qt();process.stdout.write(`${JSON.stringify({...wt(n),...e?{updateNotice:e}:{}},null,2)}\n`)}else{process.stderr.write(`Error: ${n.message}\n`);let e=su({args:$,error:t,report:Yu});e&&process.stderr.write(`Report this bug: ${e}\n`)}process.exitCode=n.exitCode}let t=e||Gu?void 0:Qt();t&&process.stderr.write(`\n${t}\n`)}export{};
+`),Cr(n,JSON.stringify([...r,`0.4`]),{mode:384})}catch{}}const Qu={name:`seo`,version:on},$u=[{title:`Start here`,commands:[[`seo start`,`Sign in with Google, then add the MCP server and skill`],[`seo report`,`Last week across your audited sites (beta, after seo login)`],[`seo report --site <site>`,`One site: overview and every section`],[`seo report --site <site> --section quick-wins`,`One section of the report, with live page checks`]]},{title:`Commands`,commands:[[`seo page --url <url>`,`One page: live facts, index status, queries`],[`seo compare --date <date>`,`Before and after a date`],[`seo index`,`Pages that lost most of their clicks`],[`seo research <action>`,`Keyword, SERP, competitor and backlink data from your key`],[`seo data`,`Raw Search Console, Bing or Clicky rows`],[`seo crawl`,`Crawl a site and list technical issues`],[`seo internal-links`,`Pages that could link to a target page`],[`seo lint <files>`,`Check copy for AI writing patterns and length`],[`seo site new <folder>`,`Start a data-driven site on Astro and Cloudflare`]]},{title:`Setup`,commands:[[`seo login`,`Use your seoskill.dev account on this machine`],[`seo sites`,`List Search Console properties`],[`seo mcp install`,`Add the local MCP server to your agents`],[`seo providers`,`Connect DataForSEO or Ahrefs`],[`seo doctor`,`Check local auth and config`]]}],ed=[...$u,{title:`More commands`,commands:[[`seo crawl-queue`,`Run a crawl and rank the fix queue`],[`seo rules`,`List crawler rule ids`],[`seo explain --rule missing_title`,`Explain a crawler rule`],[`seo redirect-trace`,`Trace redirects`],[`seo perf audit`,`Run a page performance audit`],[`seo index-coverage`,`Choose pages for URL Inspection`],[`seo ai-referrals`,`AI referral traffic in Google Analytics`],[`seo analytics google report`,`Google Analytics landing pages for visits from search`],[`seo updates`,`List official Google ranking updates`],[`seo export`,`Export report data to CSV`],[`seo reports list`,`List every structured report`],[`seo skill list`,`Show the packaged SEO skill`],[`seo auth`,`Manage Google auth`],[`seo cache`,`Manage local cache`],[`seo privacy`,`Show local storage paths`],[`seo telemetry status`,`Check anonymous usage telemetry`],[`seo reset`,`Delete saved credentials and all local data`]]}];function td(e){$i(`seo v${Qu.version}`,`Your own Search Console, Google Analytics and Bing data, as facts for your agent.`),process.stdout.write(`
+`),na(e.flatMap(e=>e.commands.map(([t,n])=>({category:e.title,id:t,name:n}))),{noun:`command`,categoryLabels:Object.fromEntries(e.map(e=>[e.title,e.title]))}),process.stdout.write(`
+`),ia(`More help`,"Use `seo help <command>` or `seo <command> --help` for command help.","Use `seo help all` for the longer command list.")}const nd=x({meta:{name:`seo`,version:Qu.version,description:`Local-first SEO CLI and MCP server`},subCommands:{init:Xs,analytics:Ia,auth:Ua,mcp:ec,doctor:Cc,status:Cc,privacy:ru,telemetry:du,reset:iu,cache:Ka,logs:Zs,crawl:To,"crawl-queue":mu,content:Qa,providers:Xc,export:Yo,"index-coverage":tc,"link-recover":nc,rules:ol,explain:sl,"refresh-priorities":yu,"redirect-trace":rc,skill:nu,start:Ys,setup:Js,site:El,login:As,logout:Ns,report:ga,page:_a,compare:va,index:ya,data:ba,research:xa,lint:Sa,reports:al,"segment-impact":Tc,"striking-distance":Dc,"update-postmortem":Tu,sites:au,"gsc-query":Po,"url-inspect":Fo,updates:ou,"traffic-anomaly":zo,"update-correlate":Bo,"ai-referrals":cc,"audit-page":vc,"second-page":_c,cannibal:lc,decaying:fc,"quick-wins":gc,"page-opportunities":mc,perf:Sc,"internal-links":pc,"ctr-underperformers":uc,"query-cluster":hc},run:async()=>{process.argv.slice(2).length===0&&process.stdout.write("Use `seo start` to set up, then `seo report` for the main report.\n")}}),rd={cannibal:`cannibalisation`,crawl:`site-crawl`,"crawl-queue":`top-fixes`,decaying:`decaying-pages`,doctor:`setup-check`,status:`setup-check`,explain:`explain-crawl-issue`,"link-recover":`link-recovery`,"query-cluster":`query-clusters`,report:`search-performance-overview`,rules:`crawler-rules`,"update-correlate":`update-correlation`},id=/* @__PURE__ */ new Set([`ai-referrals`,`audit-page`,`ctr-underperformers`,`index-coverage`,`internal-links`,`page-opportunities`,`quick-wins`,`redirect-trace`,`refresh-priorities`,`second-page`,`segment-impact`,`striking-distance`,`traffic-anomaly`,`update-postmortem`]),ad=new Set(hn().map(e=>e.id));function od(e,t){let n=e.indexOf(t);return n>=0?e[n+1]:e.find(e=>e.startsWith(`${t}=`))?.slice(t.length+1)}function sd(e){let[t,n,r]=e;if(t)return t in Vt?_e(t,{section:od(e,`--section`),action:n})??void 0:t===`reports`&&n===`run`?r&&ad.has(r)?r:void 0:t===`content`&&n===`optimize`?`content-optimization`:t===`perf`&&n===`audit`?`performance-audit`:rd[t]??(id.has(t)?t:void 0)}const cd=process.argv.slice(2);function ld(e){let t=e[1];return t&&[`list`,`describe`,`run`,`-h`,`--help`].includes(t)?e:t===void 0?[`reports`,`list`]:t.startsWith(`-`)?(process.stderr.write("Running `seo report`: `seo reports` lists reports.\n"),[`report`,...e.slice(1)]):[`reports`,`run`,...e.slice(1)]}const Q=cd[0]===`mcp`&&(cd[1]===void 0||/^-(?!h$|-help$)/.test(cd[1]))&&!process.stdin.isTTY?[`mcp`,`serve`,...cd.slice(1)]:cd[0]===`reports`?ld(cd):cd;Zu(Q);const ud=zu(Q)??Hu(Q);ud&&(process.stderr.write(`${ud}\n`),process.exit(2));const dd=Ru(Q[0]??``);dd&&!Q.some(e=>[`--help`,`-h`].includes(e))&&process.stderr.write(`${dd}\n`);const fd={agent:t()},pd=Q[0]===`telemetry`,md=Q[0]===`mcp`&&Q[1]===`serve`;!pd&&!md&&Pn(fd),md||rn();const hd=await Xu(Qu,{argv:Q});hd!==void 0&&process.exit(hd),(Q.length===0||Q.length===1&&[`help`,`--help`,`-h`].includes(Q[0]??``))&&(td($u),process.exit(0)),Q[0]===`help`&&Q[1]===`all`&&(td(ed),process.exit(0));const $=Q[0]===`help`&&Q.length>1?[...Q.slice(1),`--help`]:Q;$!==Q&&(process.argv=[process.argv[0]??`node`,process.argv[1]??`seo`,...$]);const gd=$.some(e=>[`--help`,`-h`].includes(e)),_d=Q.length===1&&[`--version`,`-v`].includes(Q[0]??``),vd=gd||_d?void 0:sd($);if(gd||_d)await Lr(nd);else{vd&&An(vd,fd);let e=Q.includes(`--json`);try{await Ir(nd,{rawArgs:$}),vd&&vt(vd,fd),[`init`,`setup`,`start`].includes($[0]??``)&&!$.includes(`--dry-run`)&&Et(fd)}catch(t){if(t?.code===`E_NO_COMMAND`&&await Lr(nd,{rawArgs:[...$,`--help`]}),vd)_n(vd,t,fd);else if(!pd){let e=Ou($);e&&Yt(e,t,fd)}let n=Yn(t);if(e){let e=rn();process.stdout.write(`${JSON.stringify({...St(n),...e?{updateNotice:e}:{}},null,2)}\n`)}else{process.stderr.write(`Error: ${n.message}\n`);let e=Au({args:$,error:t,report:vd});e&&process.stderr.write(`Report this bug: ${e}\n`)}process.exitCode=n.exitCode}let t=e||md?void 0:rn();t&&process.stderr.write(`\n${t}\n`)}export{};
 //# sourceMappingURL=cli.js.map