seo 0.2.39 → 0.2.40

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import{$ as e,$n as t,$r as n,$t as r,A as i,An as a,Ar as o,At as s,B as c,Bn as l,Br as u,Bt as d,C as f,Cn as p,Cr as m,Ct as h,D as g,Dn as _,Dr as v,Dt as y,E as b,En as ee,Er as x,Et as te,F as ne,Fn as re,Fr as ie,Ft as S,G as ae,Gn as oe,Gr as se,Gt as ce,H as le,Hn as ue,Hr as de,Ht as fe,I as pe,In as me,Ir as he,It as ge,J as _e,Jn as ve,Jr as ye,Jt as be,K as xe,Kn as Se,Kr as Ce,Kt as we,L as Te,Ln as Ee,Lr as De,Lt as Oe,M as ke,Mn as Ae,Mr as je,Mt as Me,N as Ne,Nn as Pe,Nr as Fe,Nt as Ie,O as Le,On as Re,Or as ze,Ot as Be,P as Ve,Pn as He,Pr as Ue,Pt as We,Q as Ge,Qn as Ke,Qr as qe,Qt as Je,R as Ye,Rn as Xe,Rr as Ze,Rt as Qe,S as $e,Sn as et,Sr as tt,St as nt,T as rt,Tn as it,Tr as at,Tt as ot,U as st,Un as ct,Ur as lt,Ut as ut,V as dt,Vn as ft,Vr as pt,Vt as mt,W as ht,Wn as gt,Wr as _t,Wt as vt,X as yt,Xn as bt,Xr as xt,Xt as St,Y as Ct,Yn as wt,Yr as Tt,Yt as Et,Z as Dt,Zn as Ot,Zr as kt,Zt as At,_ as jt,_n as Mt,_r as Nt,_t as Pt,a as Ft,ai as It,an as Lt,ar as Rt,at as zt,b as Bt,bn as Vt,br as Ht,bt as Ut,ci as C,cn as Wt,cr as Gt,ct as Kt,d as qt,dn as Jt,dr as Yt,dt as Xt,ei as Zt,en as Qt,er as $t,et as en,f as tn,fn as nn,fr as rn,ft as an,g as on,gn as sn,gr as cn,gt as ln,h as un,hn as dn,hr as fn,ht as pn,i as mn,ii as hn,in as gn,ir as _n,it as vn,j as yn,jn as bn,jr as xn,jt as Sn,k as Cn,kn as wn,kr as Tn,kt as En,li as Dn,ln as On,lr as kn,lt as An,m as jn,mn as Mn,mr as Nn,mt as Pn,n as Fn,ni as In,nn as Ln,nr as Rn,nt as zn,o as Bn,oi as Vn,on as Hn,or as Un,ot as Wn,p as Gn,pn as Kn,pr as qn,pt as Jn,q as Yn,qn as Xn,qr as Zn,qt as Qn,ri as $n,rn as er,rr as tr,rt as nr,s as rr,si as ir,sn as ar,sr as or,st as sr,t as cr,ti as lr,tn as ur,tr as dr,tt as fr,u as pr,ui as mr,un as hr,ur as gr,ut as _r,v as vr,vn as yr,vr as br,vt as xr,w as Sr,wn as Cr,wr,wt as Tr,x as Er,xn as Dr,xr as Or,xt as kr,y as Ar,yn as jr,yr as Mr,yt as Nr,z as Pr,zn as Fr,zr as Ir,zt as Lr}from"./dist-BzIdDb8y.js";import{createHash as Rr,randomUUID as zr}from"node:crypto";import{constants as Br,copyFileSync as Vr,createWriteStream as Hr,existsSync as Ur,mkdirSync as Wr,readFileSync as Gr,readdirSync as Kr,realpathSync as qr,renameSync as Jr,statSync as Yr,writeFileSync as Xr}from"node:fs";import{basename as Zr,dirname as Qr,extname as $r,isAbsolute as ei,join as w,posix as ti,relative as ni,resolve as ri,win32 as ii}from"node:path";import{arch as ai,homedir as oi,platform as si}from"node:os";import{lstat as ci,mkdir as li,mkdtemp as ui,readFile as di,readdir as fi,rename as pi,rm as mi,stat as hi,unlink as gi,writeFile as _i}from"node:fs/promises";import{isDeepStrictEqual as vi,stripVTControlCharacters as yi}from"node:util";import{fileURLToPath as bi}from"node:url";import{spawn as xi,spawnSync as Si}from"node:child_process";import{defineCommand as T,runCommand as Ci,runMain as wi}from"citty";import{cancel as Ti,confirm as Ei,intro as Di,isCancel as Oi,log as ki,multiselect as Ai,note as E,outro as ji,password as Mi,select as Ni,text as Pi}from"@clack/prompts";import Fi from"picocolors";import Ii from"string-width";import Li from"cli-table3";import{applyEdits as Ri,modify as zi,parse as Bi,printParseErrorCode as Vi}from"jsonc-parser";import{finished as Hi}from"node:stream/promises";import Ui from"update-notifier";function D(e){return e.replaceAll(`&`,`&amp;`).replaceAll(`<`,`&lt;`).replaceAll(`>`,`&gt;`).replaceAll(`"`,`&quot;`).replaceAll(`'`,`&#39;`)}function Wi(e){try{let t=new URL(e);return t.protocol===`http:`||t.protocol===`https:`?t.toString():void 0}catch{return}}function Gi(e){let t=Wi(e),n=D(e);return t?`<a href="${D(t)}" rel="noreferrer">${n}</a>`:n}function Ki(e){return e.length===0?`<p class="empty">No items to report.</p>`:`<ul>${e.map(e=>`<li>${D(e)}</li>`).join(``)}</ul>`}function qi(e){return e.sections.map(e=>`<section class="panel">
+import{$ as e,$n as t,$r as n,$t as r,A as i,An as a,Ar as o,At as s,B as c,Bn as l,Br as u,Bt as d,C as f,Cn as p,Cr as m,Ct as h,D as g,Dn as _,Dr as v,Dt as y,E as b,En as ee,Er as x,Et as te,F as ne,Fn as re,Fr as ie,Ft as S,G as ae,Gn as oe,Gr as se,Gt as ce,H as le,Hn as ue,Hr as de,Ht as fe,I as pe,In as me,Ir as he,It as ge,J as _e,Jn as ve,Jr as ye,Jt as be,K as xe,Kn as Se,Kr as Ce,Kt as we,L as Te,Ln as Ee,Lr as De,Lt as Oe,M as ke,Mn as Ae,Mr as je,Mt as Me,N as Ne,Nn as Pe,Nr as Fe,Nt as Ie,O as Le,On as Re,Or as ze,Ot as Be,P as Ve,Pn as He,Pr as Ue,Pt as We,Q as Ge,Qn as Ke,Qr as qe,Qt as Je,R as Ye,Rn as Xe,Rr as Ze,Rt as Qe,S as $e,Sn as et,Sr as tt,St as nt,T as rt,Tn as it,Tr as at,Tt as ot,U as st,Un as ct,Ur as lt,Ut as ut,V as dt,Vn as ft,Vr as pt,Vt as mt,W as ht,Wn as gt,Wr as _t,Wt as vt,X as yt,Xn as bt,Xr as xt,Xt as St,Y as Ct,Yn as wt,Yr as Tt,Yt as Et,Z as Dt,Zn as Ot,Zr as kt,Zt as At,_ as jt,_n as Mt,_r as Nt,_t as Pt,a as Ft,ai as It,an as Lt,ar as Rt,at as zt,b as Bt,bn as Vt,br as Ht,bt as Ut,ci as C,cn as Wt,cr as Gt,ct as Kt,d as qt,dn as Jt,dr as Yt,dt as Xt,ei as Zt,en as Qt,er as $t,et as en,f as tn,fn as nn,fr as rn,ft as an,g as on,gn as sn,gr as cn,gt as ln,h as un,hn as dn,hr as fn,ht as pn,i as mn,ii as hn,in as gn,ir as _n,it as vn,j as yn,jn as bn,jr as xn,jt as Sn,k as Cn,kn as wn,kr as Tn,kt as En,li as Dn,ln as On,lr as kn,lt as An,m as jn,mn as Mn,mr as Nn,mt as Pn,n as Fn,ni as In,nn as Ln,nr as Rn,nt as zn,o as Bn,oi as Vn,on as Hn,or as Un,ot as Wn,p as Gn,pn as Kn,pr as qn,pt as Jn,q as Yn,qn as Xn,qr as Zn,qt as Qn,ri as $n,rn as er,rr as tr,rt as nr,s as rr,si as ir,sn as ar,sr as or,st as sr,t as cr,ti as lr,tn as ur,tr as dr,tt as fr,u as pr,ui as mr,un as hr,ur as gr,ut as _r,v as vr,vn as yr,vr as br,vt as xr,w as Sr,wn as Cr,wr,wt as Tr,x as Er,xn as Dr,xr as Or,xt as kr,y as Ar,yn as jr,yr as Mr,yt as Nr,z as Pr,zn as Fr,zr as Ir,zt as Lr}from"./dist-CQRh_a0k.js";import{createHash as Rr,randomUUID as zr}from"node:crypto";import{constants as Br,copyFileSync as Vr,createWriteStream as Hr,existsSync as Ur,mkdirSync as Wr,readFileSync as Gr,readdirSync as Kr,realpathSync as qr,renameSync as Jr,statSync as Yr,writeFileSync as Xr}from"node:fs";import{basename as Zr,dirname as Qr,extname as $r,isAbsolute as ei,join as w,posix as ti,relative as ni,resolve as ri,win32 as ii}from"node:path";import{arch as ai,homedir as oi,platform as si}from"node:os";import{lstat as ci,mkdir as li,mkdtemp as ui,readFile as di,readdir as fi,rename as pi,rm as mi,stat as hi,unlink as gi,writeFile as _i}from"node:fs/promises";import{isDeepStrictEqual as vi,stripVTControlCharacters as yi}from"node:util";import{fileURLToPath as bi}from"node:url";import{spawn as xi,spawnSync as Si}from"node:child_process";import{defineCommand as T,runCommand as Ci,runMain as wi}from"citty";import{cancel as Ti,confirm as Ei,intro as Di,isCancel as Oi,log as ki,multiselect as Ai,note as E,outro as ji,password as Mi,select as Ni,text as Pi}from"@clack/prompts";import Fi from"picocolors";import Ii from"string-width";import Li from"cli-table3";import{applyEdits as Ri,modify as zi,parse as Bi,printParseErrorCode as Vi}from"jsonc-parser";import{finished as Hi}from"node:stream/promises";import Ui from"update-notifier";function D(e){return e.replaceAll(`&`,`&amp;`).replaceAll(`<`,`&lt;`).replaceAll(`>`,`&gt;`).replaceAll(`"`,`&quot;`).replaceAll(`'`,`&#39;`)}function Wi(e){try{let t=new URL(e);return t.protocol===`http:`||t.protocol===`https:`?t.toString():void 0}catch{return}}function Gi(e){let t=Wi(e),n=D(e);return t?`<a href="${D(t)}" rel="noreferrer">${n}</a>`:n}function Ki(e){return e.length===0?`<p class="empty">No items to report.</p>`:`<ul>${e.map(e=>`<li>${D(e)}</li>`).join(``)}</ul>`}function qi(e){return e.sections.map(e=>`<section class="panel">
         <h2>${D(e.title)}</h2>
         ${Ki(e.bullets)}
       </section>`).join(``)}function Ji(e){return e.map(e=>`<section class="panel">
@@ -131,90 +131,90 @@ import{$ as e,$n as t,$r as n,$t as r,A as i,An as a,Ar as o,At as s,B as c,Bn a
 `)}function To(e,t){return e.length===0?t.colors.dim(`No parameters.`):So(e.map(e=>({title:e.name,description:e.description,meta:[e.type,e.required?`required`:`optional`]})),t,{empty:`No parameters.`})}function L(e={}){return!!(!e.json&&process.stdin.isTTY&&process.stdout.isTTY&&!process.env.CI)}function R(e){process.stdout.write(`${JSON.stringify(e,null,2)}\n`)}function z(e){let t=ao(e,Ga());t&&process.stdout.write(`${t}\n`)}function B(e,t){process.stdout.write(`${io(e,t,Ga())}\n`)}function Eo(e){process.stdout.write(`${oo(e,Ga())}\n`)}function Do(e,t){process.stdout.write(`${go(e,Ga(),t)}\n`)}function Oo(e){process.stdout.write(`${_o(e,Ga())}\n`)}function ko(e){process.stdout.write(`${po(e,Ga())}\n`)}function Ao(e,t){process.stdout.write(`${xo(e,Ga(),t)}\n`)}function jo(e,t){process.stdout.write(`${So(e,Ga(),t)}\n`)}function Mo(e,...t){process.stdout.write(`${Co(e,t,Ga())}\n`)}function No(e,t){process.stdout.write(`${wo(e,t,Ga())}\n`)}function Po(e){process.stdout.write(`${To(e,Ga())}\n`)}function Fo(e){return e<1024?`${e} B`:e<1024*1024?`${(e/1024).toFixed(1)} KB`:`${(e/(1024*1024)).toFixed(1)} MB`}function V(e){return typeof e==`symbol`&&process.exit(1),e}function Io(e){Tn(e?.googleAccounts)}function Lo(e,t){let n=t.trim().toLowerCase();return!n||e.some(e=>e.toLowerCase().includes(n))}async function Ro(e){let t=e.choices;if(e.choices.length>8){let n=V(await Pi({message:e.searchMessage,placeholder:`Type part of the name or URL, or leave blank`}));if(t=e.choices.filter(t=>Lo(e.searchValues(t),n)),!t.length)throw new C(`INVALID_INPUT`,e.emptyMessage)}return V(await Ni({message:e.message,options:t.map(t=>{let n=e.hint?.(t);return{value:t,label:e.label(t),...n?{hint:n}:{}}})}))}async function zo(e){if(e.site)return e.site;let t=Zn(),n=!!t.defaultSite&&(t.clients.some(e=>e.siteUrl===t.defaultSite)||t.sites.some(e=>e.siteUrl===t.defaultSite));if(e.options?.allowDefault!==!1&&t.defaultSite&&n)return Io(t.clients.find(e=>e.isDefault&&e.siteUrl===t.defaultSite)),t.defaultSite;if(e.options?.json||!L())throw new C(`INVALID_INPUT`,t.defaultSite?`Saved default site ${t.defaultSite} does not match any saved project. Pass --site or --project, or run \`seo start\` to save a new default.`:"No site selected. Pass --site, use --project on supported commands, or run `seo start` in a terminal.");let r=await m(e.options?.refresh,e.options?.account);if(!r.length)throw new C(`PROPERTY_NOT_FOUND`,`No Search Console properties found for this Google login.`);return r.length===1?r[0]?.siteUrl??``:(await Ro({message:`Choose a Search Console property`,searchMessage:`Search Search Console properties`,emptyMessage:`No Search Console properties matched that search.`,choices:r,label:e=>e.siteUrl,hint:e=>e.permissionLevel,searchValues:e=>[e.siteUrl,e.permissionLevel??``]})).siteUrl}async function H(e){if(e.client&&e.project&&e.client!==e.project)throw new C(`INVALID_INPUT`,`Use either --project or --client, not both.`);let t=e.project??e.client;if(t){let e=yt(t);if(!e)throw new C(`INVALID_INPUT`,`Project not found: ${t}`);return Io(e),{client:e,site:e.siteUrl}}let n=yt();return!e.site&&n?(Io(n),{client:n,site:n.siteUrl}):{site:await zo({site:e.site,options:e.options})}}async function U(e){if(e.client&&e.project&&e.client!==e.project)throw new C(`INVALID_INPUT`,`Use either --project or --client, not both.`);let t=e.project??e.client;if(t){let e=yt(t);if(!e)throw new C(`INVALID_INPUT`,`Project not found: ${t}`);return Io(e),e}let n=Ge();if(!n.length)return;let r=yt();if(r)return Io(r),r;if(e.options?.json||!L())return;let i=await Ro({message:`Choose a project`,searchMessage:`Search projects`,emptyMessage:`No projects matched that search.`,choices:n,label:e=>e.name,hint:e=>e.siteUrl,searchValues:e=>[e.id,e.name,e.siteUrl]});return Io(i),i}async function Bo(e){if(e.property)return e.property;let t=Zn();if(t.analytics.google.defaultPropertyId)return t.analytics.google.defaultPropertyId;if(e.options?.json||!L())throw new C(`INVALID_INPUT`,`No Google Analytics property selected. Pass --property or run this command in a terminal to choose one.`);let n=(await or(e.options?.account)).flatMap(e=>e.propertySummaries.map(t=>({property:Rt(t.property),displayName:t.displayName??t.property,account:e.displayName??e.account})));if(!n.length)throw new C(`PROPERTY_NOT_FOUND`,`No Google Analytics properties found for this Google login.`);return n.length===1?n[0]?.property??``:(await Ro({message:`Choose a Google Analytics property`,searchMessage:`Search Google Analytics properties`,emptyMessage:`No Google Analytics properties matched that search.`,choices:n,label:e=>`${e.displayName} (${e.property})`,hint:e=>e.account,searchValues:e=>[e.property,e.displayName,e.account]})).property}async function Vo(e,t={}){let n=O(e[`report-id`]);if(n){let e=a(n);if(!e)throw Error(`No saved crawl report found for ${n}.`);return e}let r=k(e),i=O(e.site),o=r||i?await H({client:r,site:i,options:t}):void 0,s=Re(o?.site);if(!s)throw Error(o?.site?`No saved crawl report found for ${o.site}. Run \`seo crawl --project ${o.client?.id??o.site} --save\` first.`:"No saved crawl report found. Run `seo crawl <url> --save` first, or pass --report-id.");return s}function Ho(e){let t=t=>e.checks.filter(e=>e.status===t).length,n=t(`fail`),r=t(`warning`),i=t(`unknown`),a=t(`pass`),o=n?`fail`:r?`warning`:i?`unknown`:`pass`;ko({title:`AI search evidence`,target:e.url,status:o,summary:e.headline,metrics:[{label:`Passed`,value:a,status:`pass`},{label:`Review`,value:r,status:`warning`},{label:`Failed`,value:n,status:`fail`},{label:`Unknown`,value:i,status:`unknown`}],sections:e.sections.map(e=>({title:e.title,diagnostics:e.checks.map(e=>({status:e.status,title:e.title,explanation:e.plainEnglish,fix:e.status===`pass`?void 0:e.action,evidence:(e.urls??[]).slice(0,5)}))})),notes:[`Data: ${e.dataStatus}. Report: ${e.reportId}.`,...e.caveats]})}const Uo=T({meta:{name:`ai-readiness`,description:`Review AI-search technical evidence and optional observations`},args:{"report-id":{type:`string`,description:`Saved crawl report id to analyze.`},site:{type:`string`,description:`GSC property URL for selecting the latest saved crawl.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=re(await Vo(e,{json:t}));if(t){R(n);return}Ho(n)}});function Wo(e){let t=O(e.agentReadinessUrl),n=O(e.url);if(t&&n&&t!==n)throw Error(`Use either the positional URL or --url, not both.`);return t??n}function Go(e){let t=e.summary.failed>0?`fail`:e.summary.warnings>0?`warning`:e.summary.unknown>0?`unknown`:`pass`;ko({title:`AI agent readiness`,target:e.url,status:t,summary:e.headline,metrics:[{label:`Passed`,value:e.summary.passed,status:`pass`},{label:`Review`,value:e.summary.warnings,status:`warning`},{label:`Failed`,value:e.summary.failed,status:`fail`},{label:`Unknown`,value:e.summary.unknown,status:`unknown`}],sections:e.sections.map(e=>({title:e.title,diagnostics:e.checks.filter(e=>![`info`,`notApplicable`].includes(e.status)).map(e=>({status:e.status,title:e.title,explanation:e.plainEnglish,fix:e.status===`pass`?void 0:e.action,evidence:(e.urls??[]).slice(0,5)}))})),notes:[`Profile: ${e.profile}. Data: ${e.dataStatus}. Report: ${e.reportId}.`,...e.caveats]})}const Ko=T({meta:{name:`agent-readiness`,description:`Check raw HTML, missing pages, guidance, Markdown, discovery, and identity for AI agents`},args:{agentReadinessUrl:{type:`positional`,required:!1,description:`Public site URL to check.`},url:{type:`string`,description:`Public site URL to check.`},"report-id":{type:`string`,description:`Saved crawl report id to analyze without fetching again.`},site:{type:`string`,description:`GSC property URL for selecting the latest saved crawl.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},"max-pages":{type:`string`,description:`Maximum public HTML pages to crawl.`},"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.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=Wo(e),r=O(e[`report-id`]);if(n&&r)throw Error(`Use either a URL or --report-id, not both.`);let i=Ee(n?await(async()=>{let r=k(e),i=O(e.site),a=r||i?await H({client:r,site:i,options:{json:t}}):void 0;return it({url:n,projectId:a?.client?.id,site:a?.site,maxPages:j(e[`max-pages`]),fetchRate:Ba(e),refresh:A(e.refresh),checkAgentDiscovery:!0,useSitemap:!0,checkExternal:!1})})():await Vo(e,{json:t}));if(t){R(i);return}Go(i)}}),qo=`@seoskill/clicky-provider`;function Jo(e){return e===`keychain`?`system keychain`:e===`file`?`private local file`:e===`provider-store`?`provider credential store`:e??`missing`}async function Yo(e){let t=await ue(),n=t.registry.get(`clicky`);if(n)return n;let r=t.failures.find(e=>e.id===`clicky`);if(r)throw new C(`PROVIDER_UNAVAILABLE`,`The Clicky provider package could not load: ${r.message}`);if(!L({json:e.json}))throw new C(`PROVIDER_UNAVAILABLE`,`Clicky is now an optional provider package. Run \`seo providers install ${qo} --yes\`, then run this command again.`);let i;try{i=await b(qo)}catch(e){throw new C(`PROVIDER_UNAVAILABLE`,e instanceof Error?e.message:String(e))}if(E([`${i.package}@${i.version}`,`Publisher: ${i.publisher??`not supplied by npm`}`,`Repository: ${i.repository??`not supplied by npm`}`,`Integrity: ${i.integrity}`].join(`
 `),`Clicky package`),E(`This package can read files, use the network, and run with the same local permissions as seo.`,`Local permissions`),!V(await Ei({message:`Install the Clicky provider package?`,initialValue:!0})))throw new C(`PROVIDER_UNAVAILABLE`,`The Clicky provider package is required for this command.`);await g(i),t=await ue();let a=t.registry.get(`clicky`);if(!a)throw new C(`PROVIDER_UNAVAILABLE`,"The Clicky provider package was installed but could not load. Run `seo providers doctor`.");return a}async function Xo(e){if(e.siteId)return e.siteId;let t=Yn(await U({client:e.project,options:{json:e.json}}));if(t?.provider===`clicky`)return t.siteId;if(t?.provider===`extension`&&t.providerId===`clicky`&&t.account.siteId)return t.account.siteId;throw new C(`INVALID_INPUT`,`No Clicky site is selected. Pass --site-id or use a project connected to Clicky.`)}async function Zo(e,t){let n=await wt(t);if(n)return{siteKey:n.siteKey,source:n.source};try{let n=await gt({providerId:`clicky`,account:{siteId:t},fields:e.connection.fields});return n.sitekey?{siteKey:n.sitekey,source:`provider-store`}:{}}catch{return{}}}const Qo=T({meta:{name:`connect`,description:`Validate and save a Clicky sitekey`},args:{"site-id":{type:`string`,description:`Numeric Clicky site ID.`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let n=F(e),r=await Yo({json:n}),i=L({json:n}),a=k(e),o=a?await U({project:a,options:{json:n}}):void 0;i&&Di(`Connect Clicky`);let s=Yn(o),c=s?.provider===`clicky`?s.siteId:s?.provider===`extension`&&s.providerId===`clicky`?s.account.siteId:void 0,l=O(e[`site-id`])??c??(i?V(await Pi({message:`Clicky site ID`,validate:e=>/^\d{1,30}$/u.test(e?.trim()??``)?void 0:`Enter the numeric site ID from Clicky`})):void 0);if(!l)throw new C(`INVALID_INPUT`,`Pass --site-id when the selected project is not already connected to Clicky.`);let u=await Zo(r,l),d=u.siteKey??(i?V(await Mi({message:`Clicky sitekey`,validate:e=>/^[A-Za-z0-9]{12,64}$/u.test(e?.trim()??``)?void 0:`Enter the sitekey from Clicky`})):void 0);if(!d)throw new C(`AUTH_REQUIRED`,`Run this command in a terminal or set ${Se}.`);await ee({providerId:`clicky`,account:{siteId:l},credentials:{sitekey:d}});let f=u.source??await bt(l,d);await oe({providerId:`clicky`,account:{siteId:l},credentials:{sitekey:d}}),t(`clicky`,{siteId:l});let p=o?fr(o.id,{provider:`extension`,providerId:`clicky`,account:{siteId:l}}):void 0,m={siteId:l,connected:!0,credentialSource:f,project:p?{id:p.id,name:p.name}:void 0};if(n){R(m);return}let h=p?`Connection verified and attached to ${p.name}. Saved in the ${Jo(f)}.`:`Connection verified. Saved in the ${Jo(f)}.`;i?ji(h):process.stdout.write(`${h}\n`)}}),$o=T({meta:{name:`status`,description:`Show the local Clicky connection`},args:{"site-id":{type:`string`,description:`Numeric Clicky site ID.`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},check:{type:`boolean`,default:!1,description:`Verify the saved sitekey with Clicky.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await Yo({json:t}),r=await Xo({siteId:O(e[`site-id`]),project:k(e),json:t}),i=await Zo(n,r),a=A(e.check);a&&i.siteKey&&await ee({providerId:`clicky`,account:{siteId:r},credentials:{sitekey:i.siteKey}});let o={siteId:r,connected:!!i.siteKey,credentialSource:i.source,liveCheck:a?i.siteKey?`passed`:`unavailable`:`not-requested`};if(t){R(o);return}z([[`Site ID`,r],[`Connected`,o.connected?`yes`:`no`],[`Credential`,Jo(o.credentialSource)],[`Live check`,o.liveCheck]])}}),es=T({meta:{name:`report`,description:`Run a bounded Clicky analytics report`},args:{"site-id":{type:`string`,description:`Numeric Clicky site ID.`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},type:{type:`string`,default:`pages-entrance`,description:`Clicky report type. Defaults to pages-entrance.`},"start-date":{type:`string`,required:!0,description:`First site calendar date in YYYY-MM-DD format.`},"end-date":{type:`string`,required:!0,description:`Last site calendar date in YYYY-MM-DD format.`},limit:{type:`string`,default:`100`,description:`Maximum retained rows. Defaults to 100 and caps at 5000.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local Clicky cache.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await Yo({json:t}),r=await Xo({siteId:O(e[`site-id`]),project:k(e),json:t}),i=await Zo(n,r),a=await yn({providerId:`clicky`,actionId:`report`,account:{siteId:r},...i.siteKey?{credentials:{sitekey:i.siteKey}}:{},params:{type:O(e.type)??`pages-entrance`,startDate:O(e[`start-date`])??``,endDate:O(e[`end-date`])??``,limit:j(e.limit)??100},refresh:A(e.refresh)});if(!a.data||typeof a.data!=`object`)throw new C(`PROVIDER_UNAVAILABLE`,`The Clicky provider returned an invalid report.`);let o={...a.data,cache:a.cache};if(t){R(o);return}z([[`Site ID`,o.siteId],[`Report`,o.type],[`Rows`,String(o.returnedRows)],[`Cache`,o.cache]]),B([`Value`,`Title`,`URL`],o.rows.slice(0,25).map(e=>[String(e.value??``),String(e.title??``),String(e.url??``)]))}}),ts=T({meta:{name:`disconnect`,description:`Remove a saved Clicky sitekey`},args:{"site-id":{type:`string`,description:`Numeric Clicky site ID.`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e);await Yo({json:t});let n=await Xo({siteId:O(e[`site-id`]),project:k(e),json:t});await Xn(n),await ct({providerId:`clicky`,account:{siteId:n}});let r=!!process.env[Se];t?R({siteId:n,savedCredentialRemoved:!0,environmentCredential:r?`active`:`missing`}):process.stdout.write(r?`Saved sitekey removed. ${Se} is still active.\n`:`Clicky is disconnected for this site.
 `)}}),ns=T({meta:{name:`clicky`,description:`Connect Clicky and read bounded analytics reports`},subCommands:{connect:Qo,status:$o,report:es,detach:T({meta:{name:`detach`,description:`Remove Clicky from one project without deleting its sitekey`},args:{project:{type:`string`,required:!0,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:t})=>{let n=F(t),r=await U({project:k(t),options:{json:n}}),i=Yn(r),a=i?.provider===`extension`&&i.providerId===`clicky`?`extension:clicky`:i?.provider===`clicky`?`clicky`:void 0;if(!r||!a)throw new C(`INVALID_INPUT`,`The selected project is not attached to Clicky.`);let o=e(r.id,a),s={project:{id:o.id,name:o.name},detached:!0,selectedAnalytics:o.analytics.selected,savedSitekey:!0};n?R(s):process.stdout.write(`Clicky detached from ${o.name}. The saved sitekey was kept.\n`)}}),disconnect:ts}}),rs=T({meta:{name:`properties`,description:`List Google Analytics accounts and properties`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},save:{type:`string`,description:`Save this numeric Google Analytics property ID as the default.`},account:{type:`string`,description:`Saved Google account email.`}},run:async({args:e})=>{let t=await or(O(e.account)),n=t.flatMap(e=>e.propertySummaries.map(t=>({account:e.displayName??e.account,property:Rt(t.property),displayName:t.displayName??t.property}))),r=O(e.save);if(r){let e=Zn();e.analytics.google.defaultPropertyId=r,kt(e)}if(F(e)){R({accountSummaries:t,properties:n,saved:r});return}r&&process.stdout.write(`Saved default Google Analytics property ${r}.\n`),B([`Property`,`Name`,`Account`],n.map(e=>[e.property,e.displayName,e.account]))}});function W(e){return Math.round(e).toLocaleString(`en-GB`)}function is(e){return e.toFixed(1)}function as(e){return`${(e*100).toFixed(1)}%`}function G(e,t=72){return Ya(e,t)}function os(e){return e.verification?.requested?`${e.verification.verified} checked, ${e.verification.failed} failed`:`off`}function ss(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){ko(ss(e))}function q(e,t){B(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=cs(e,r);i&&(process.stdout.write(`
-`),ko(i),t.length>r.length&&process.stdout.write(`Showing ${r.length} of ${t.length}. Use --json for full data.\n`))}function cs(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 ls(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`)}}async function us(e,t={resolveClient:U,resolveGoogleAnalyticsProperty:Bo}){if(e.property)return t.resolveGoogleAnalyticsProperty({property:e.property,options:e.options});let n=await t.resolveClient({client:e.project,options:e.options});return t.resolveGoogleAnalyticsProperty({property:Dt(n),options:e.options})}const ds=T({meta:{name:`analytics`,description:`Read analytics data from connected providers`},subCommands:{clicky:ns,google:T({meta:{name:`google`,description:`Read Google Analytics properties and reports`},subCommands:{properties:rs,report:T({meta:{name:`report`,description:`Run a Google Analytics report`},args:{property:{type:`string`,description:`Google Analytics property ID. If omitted in a terminal, choose one.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name with an optional Google Analytics property.`},account:{type:`string`,description:`Saved Google account email.`},"start-date":{type:`string`,default:`28daysAgo`},"end-date":{type:`string`,default:`yesterday`},dimensions:{type:`string`,default:`landingPage`},metrics:{type:`string`,default:`sessions,totalUsers,eventCount`},limit:{type:`string`,default:`25`},body:{type:`string`},"body-file":{type:`string`},refresh:{type:`boolean`,default:!1,description:`Bypass the local Google Analytics cache.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=await us({property:O(e.property),project:k(e),options:{json:t,account:O(e.account)}}),r=await kn(n,await Ha(e.body,e[`body-file`])??{dateRanges:[{startDate:O(e[`start-date`]),endDate:O(e[`end-date`])}],dimensions:(N(e.dimensions)??[]).map(e=>({name:e})),metrics:(N(e.metrics)??[]).map(e=>({name:e})),limit:O(e.limit)},{refresh:A(e.refresh),accountEmail:O(e.account)});if(t){R(r);return}let i=Un(r);if(K({title:`Google Analytics report`,target:n,status:`info`,summary:`${r.rowCount??i.length} rows returned for the requested dimensions and metrics.`,metrics:[{label:`Rows`,value:r.rowCount??i.length},{label:`Displayed`,value:Math.min(i.length,25)}]}),i.length){let e=Object.keys(i[0]??{});B(e,i.slice(0,25).map(t=>e.map(e=>t[e]??``)))}}})}})}});function fs(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 ps(e){return e.active===`keychain`?`system keychain`:e.configured===`keychain`?`private file fallback`:`private file`}function ms(e){return e===`shared`?`SEO Skill app`:`Local OAuth config`}function hs(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`,ms(e.clientSource)],[`Expires`,Pa(e.expiresAt)]),t}const gs=T({meta:{name:`auth`,description:`Authentication commands`},subCommands:{login:T({meta:{name:`login`,description:`Run Google OAuth flow`},run:async()=>{if((await v()).activeMode===`service-account`)throw new C(`AUTH_CONFIG_REQUIRED`,`A service account is active from the environment. Unset its credential variable before running browser OAuth.`);let e=await x();z(hs({accountEmail:e.account_email,clientSource:e.client_source,expiresAt:e.expires_at,scope:e.scope}))}}),logout:T({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 v(),n=O(e.account);if(n&&e.all)throw new C(`INVALID_INPUT`,`Use either --account or --all, not both.`);let r=e.all?void 0:n??t.accounts.find(e=>e.active)?.accountEmail;if(await lt(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`);return}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:T({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 v();if(t.activeMode===`service-account`){let n={mode:`service-account`,account:t.identity??null,source:fs(t.serviceAccount.source)};if(F(e)){R(n);return}z([[`Account type`,`Service account`],[`Account`,t.identity??`Invalid configuration`],[`Credentials`,n.source],[`Access`,`Search Console and Google Analytics, read only`]]);return}let n=O(e.account),r=n?await ye(n):t.tokens;if(n&&!r)throw new C(`AUTH_REQUIRED`,`Google account ${n} is not connected.`);if(!r){if(F(e)){R({mode:`oauth`,account:null});return}process.stdout.write(`Not logged in.
-`);return}if(F(e)){R({mode:`oauth`,account:r.account_email,scopes:r.scope.split(/\s+/u).filter(Boolean),clientSource:r.client_source,expiresAt:r.expires_at});return}z(hs({accountEmail:r.account_email,clientSource:r.client_source,expiresAt:r.expires_at,scope:r.scope}))}}),status:T({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 v(),n=O(e.account),r=n?await ye(n):t.tokens;if(n&&!r&&t.activeMode!==`service-account`)throw new C(`AUTH_REQUIRED`,`Google account ${n} is not connected.`);let i=t.activeMode===`oauth`?await se():void 0;if(F(e)){R({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`,fs(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]),z(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 se();z([[`Account`,r.account_email],[`Connected accounts`,String(t.accounts.length)],[`Scopes`,r.scope],[`Client`,ms(r.client_source)],[`Expires`,Pa(r.expires_at)],[`Tokens file`,ir().tokensFile],[`Token storage`,ps(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:T({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 C(`INVALID_INPUT`,`Choose either --keychain or --file, not both.`);let t=e.keychain||e.file?await xt(e.keychain?`keychain`:`file`):await se();if(F(e)){R(t);return}z([[`Configured storage`,t.configured],[`Active storage`,ps(t)],...t.reason?[[`Note`,t.reason]]:[]])}}),refresh:T({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 v()).activeMode===`service-account`){process.stdout.write(`Service accounts request short-lived Google tokens automatically. No local refresh token is stored.
+`),ko(i),t.length>r.length&&process.stdout.write(`Showing ${r.length} of ${t.length}. Use --json for full data.\n`))}function cs(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 ls(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`)}}async function us(e,t={resolveClient:U,resolveGoogleAnalyticsProperty:Bo}){if(e.property)return t.resolveGoogleAnalyticsProperty({property:e.property,options:e.options});let n=await t.resolveClient({client:e.project,options:e.options});return t.resolveGoogleAnalyticsProperty({property:Dt(n),options:e.options})}const ds=T({meta:{name:`analytics`,description:`Read analytics data from connected providers`},subCommands:{clicky:ns,google:T({meta:{name:`google`,description:`Read Google Analytics properties and reports`},subCommands:{properties:rs,report:T({meta:{name:`report`,description:`Run a Google Analytics report`},args:{property:{type:`string`,description:`Google Analytics property ID. If omitted in a terminal, choose one.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name with an optional Google Analytics property.`},account:{type:`string`,description:`Saved Google account email.`},"start-date":{type:`string`,default:`28daysAgo`},"end-date":{type:`string`,default:`yesterday`},dimensions:{type:`string`,default:`landingPage`},metrics:{type:`string`,default:`sessions,totalUsers,eventCount`},limit:{type:`string`,default:`25`},body:{type:`string`},"body-file":{type:`string`},refresh:{type:`boolean`,default:!1,description:`Bypass the local Google Analytics cache.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=await us({property:O(e.property),project:k(e),options:{json:t,account:O(e.account)}}),r=await kn(n,await Ha(e.body,e[`body-file`])??{dateRanges:[{startDate:O(e[`start-date`]),endDate:O(e[`end-date`])}],dimensions:(N(e.dimensions)??[]).map(e=>({name:e})),metrics:(N(e.metrics)??[]).map(e=>({name:e})),limit:O(e.limit)},{refresh:A(e.refresh),accountEmail:O(e.account)});if(t){R(r);return}let i=Un(r);if(K({title:`Google Analytics report`,target:n,status:`info`,summary:`${r.rowCount??i.length} rows returned for the requested dimensions and metrics.`,metrics:[{label:`Rows`,value:r.rowCount??i.length},{label:`Displayed`,value:Math.min(i.length,25)}]}),i.length){let e=Object.keys(i[0]??{});B(e,i.slice(0,25).map(t=>e.map(e=>t[e]??``)))}}})}})}});function fs(){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 ps(){return E(fs(),`Google sign-in`),x()}function ms(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 hs(e){return e.active===`keychain`?`system keychain`:e.configured===`keychain`?`private file fallback`:`private file`}function gs(e){return e===`shared`?`SEO Skill app`:`Local OAuth config`}function _s(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`,gs(e.clientSource)],[`Expires`,Pa(e.expiresAt)]),t}const vs=T({meta:{name:`auth`,description:`Authentication commands`},subCommands:{login:T({meta:{name:`login`,description:`Run Google OAuth flow`},run:async()=>{if((await v()).activeMode===`service-account`)throw new C(`AUTH_CONFIG_REQUIRED`,`A service account is active from the environment. Unset its credential variable before running browser OAuth.`);let e=await ps();z(_s({accountEmail:e.account_email,clientSource:e.client_source,expiresAt:e.expires_at,scope:e.scope}))}}),logout:T({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 v(),n=O(e.account);if(n&&e.all)throw new C(`INVALID_INPUT`,`Use either --account or --all, not both.`);let r=e.all?void 0:n??t.accounts.find(e=>e.active)?.accountEmail;if(await lt(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`);return}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:T({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 v();if(t.activeMode===`service-account`){let n={mode:`service-account`,account:t.identity??null,source:ms(t.serviceAccount.source)};if(F(e)){R(n);return}z([[`Account type`,`Service account`],[`Account`,t.identity??`Invalid configuration`],[`Credentials`,n.source],[`Access`,`Search Console and Google Analytics, read only`]]);return}let n=O(e.account),r=n?await ye(n):t.tokens;if(n&&!r)throw new C(`AUTH_REQUIRED`,`Google account ${n} is not connected.`);if(!r){if(F(e)){R({mode:`oauth`,account:null});return}process.stdout.write(`Not logged in.
+`);return}if(F(e)){R({mode:`oauth`,account:r.account_email,scopes:r.scope.split(/\s+/u).filter(Boolean),clientSource:r.client_source,expiresAt:r.expires_at});return}z(_s({accountEmail:r.account_email,clientSource:r.client_source,expiresAt:r.expires_at,scope:r.scope}))}}),status:T({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 v(),n=O(e.account),r=n?await ye(n):t.tokens;if(n&&!r&&t.activeMode!==`service-account`)throw new C(`AUTH_REQUIRED`,`Google account ${n} is not connected.`);let i=t.activeMode===`oauth`?await se():void 0;if(F(e)){R({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`,ms(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]),z(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 se();z([[`Account`,r.account_email],[`Connected accounts`,String(t.accounts.length)],[`Scopes`,r.scope],[`Client`,gs(r.client_source)],[`Expires`,Pa(r.expires_at)],[`Tokens file`,ir().tokensFile],[`Token storage`,hs(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:T({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 C(`INVALID_INPUT`,`Choose either --keychain or --file, not both.`);let t=e.keychain||e.file?await xt(e.keychain?`keychain`:`file`):await se();if(F(e)){R(t);return}z([[`Configured storage`,t.configured],[`Active storage`,hs(t)],...t.reason?[[`Note`,t.reason]]:[]])}}),refresh:T({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 v()).activeMode===`service-account`){process.stdout.write(`Service accounts request short-lived Google tokens automatically. No local refresh token is stored.
 `);return}let t=await ze(O(e.account));process.stdout.write(`Refreshed. New expiry ${new Date(t.expires_at).toISOString()}.\n`)}}),accounts:T({meta:{name:`accounts`,description:`List saved Google accounts`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=Ce();if(F(e)){R({accounts:t});return}if(t.length===0){process.stdout.write(`No Google accounts are connected.
 `);return}z(t.map(e=>[e.active?`Active account`:`Account`,e.accountEmail]))}}),use:T({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=O(e.account);if(!t)throw new C(`INVALID_INPUT`,`Google account is required.`);Tt(t),process.stdout.write(`Default Google account: ${t}\n`)}}),"setup-client":T({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(!L({json:F(e)}))throw new C(`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.");Di(`Local Google OAuth client`),E([`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.`].join(`
-`),`Advanced`),qe({clientId:V(await Pi({message:`Google Desktop OAuth client ID`,validate:e=>e?void 0:`Client ID is required`})),clientSecret:V(await Mi({message:`Google Desktop OAuth client secret`,validate:e=>e?void 0:`Client secret is required`}))}),ji(`Saved local OAuth config to ${ir().oauthClientFile}`)}})}}),_s=[`gsc`,`google-analytics`,`semrush`,`dataforseo`,`ahrefs`,`serpbase`,`clicky`,`http`];function vs(e){if(e!==void 0){if(typeof e==`string`&&_s.includes(e))return e;throw new C(`INVALID_INPUT`,`--provider must be one of: ${_s.join(`, `)}.`)}}const ys=T({meta:{name:`cache`,description:`Cache helpers`},subCommands:{stats:T({meta:{name:`stats`,description:`Show local cache size and row counts`},run:async()=>{let e=It();z([[`DB`,e.dbPath],[`Size`,Fo(e.sizeBytes)],[`Cached data`,`${Fo(e.logicalSizeBytes)} of ${Fo(e.maxSizeBytes)} automatic limit`],[`Sites`,String(e.counts.sites??0)],[`Search Console`,String(e.counts.gsc_cache??0)],[`Google Analytics`,String(e.counts.google_analytics_cache??0)],[`Semrush`,String(e.counts.semrush_cache??0)],[`DataForSEO`,String(e.counts.provider_cache??0)],[`Ahrefs`,String(e.counts.ahrefs_cache??0)],[`SerpBase`,String(e.counts.serpbase_cache??0)],[`Clicky`,String(e.counts.clicky_cache??0)],[`HTTP`,String(e.counts.http_cache??0)]])}}),clear:T({meta:{name:`clear`,description:`Clear cached API and HTTP data`},args:{provider:{type:`string`,description:`Optional cache provider: gsc, google-analytics, semrush, dataforseo, ahrefs, serpbase, clicky, or http`}},run:async({args:e})=>{let t=hn(vs(e.provider));process.stdout.write(`Removed ${t} cached rows.\n`)}})}});async function bs(e,t={}){return(await H({client:e.client,project:e.project,site:e.site,options:t})).site}function xs(e){if(e.startsWith(`http://`)||e.startsWith(`https://`))return e;if(e.startsWith(`sc-domain:`))return`https://${e.slice(10)}/`}function Ss(e){return e.replace(/^sc-domain:/,``).replace(/^https?:\/\//,``)}function Cs(e){return e.toLowerCase().replace(/^https?:\/\//,``).replace(/^sc-domain:/,``).replace(/[^a-z0-9]+/g,`-`).replace(/^-+|-+$/g,``).slice(0,60)}function ws(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 Ts(e){return e?e===`serp-framing`?`wording gap`:e===`content-gap`?`content gap`:e===`technical-check`?`technical check`:`covered`:`-`}const Es=`__create_project__`,Ds=`__skip_project__`;function Os(e){return[{value:Es,label:`Create a new project`,hint:`Save a separate site and its data sources`},...e.map(e=>({value:e.id,label:`Update ${e.name}`,hint:`${e.id}, ${e.siteUrl}`})),{value:Ds,label:`Continue without a project profile`,hint:`Pass --site or --url when you run reports`}]}function ks(e,t){let n=Cs(e);if(!n)throw Error(`Project id could not be derived.`);let r=new Set(t.map(e=>e.id.toLowerCase()));if(!r.has(n.toLowerCase()))return n;let i=2;for(;r.has(`${n}-${i}`.toLowerCase());)i+=1;return`${n}-${i}`}async function As(e){if(e.skipProfile)return{mode:`skip`};if(e.requestedId){let t=e.requestedId.toLowerCase(),n=Cs(e.requestedId).toLowerCase(),r=e.clients.find(e=>e.id.toLowerCase()===n||e.name.toLowerCase()===t);return r?{mode:`update`,client:r}:{mode:`create`,requestedId:e.requestedId}}if(!e.interactive)return{mode:`create`};let t=Os(e.clients),n=V(await(e.prompt?e.prompt(t):Ni({message:`Create a project or update an existing one?`,options:t})));if(n===Es)return{mode:`create`};if(n===Ds)return{mode:`skip`};let r=e.clients.find(e=>e.id===n);if(!r)throw Error(`Project not found: ${n}`);return{mode:`update`,client:r}}function js(e){let t=e.platform===`win32`?ii:ti;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 Ms(e={}){let t=e.home??oi(),n=e.platform??process.platform,r=js({home:t,platform:n,env:e.env??process.env}),i=n===`win32`?ii:ti,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 Ns(e,t={}){let n=t.platform??process.platform,r=t.exists??Ur,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=w(e,t);if(r(n))return n}for(let e of a){let t=w(Qr(i),e);if(r(t))return t}return e}function Ps(e){return Ns(e)!==e}function Fs(e={}){let t=e.targets??Ms(),n=e.hasCommand??Ps,r=e.hasPath??Ur;return t.filter(e=>e.kind===`native`?e.commandNames.some(n):r(e.path)||e.detectionPaths.some(r)||e.commandNames.some(n))}const Is={insertSpaces:!0,tabSize:2,eol:`
-`};function Ls(){return new Date().toISOString().replace(/[:.]/g,`-`)}function Rs(e,t){Wr(Qr(e),{recursive:!0,mode:448});let n=`${e}.${process.pid}.${Date.now()}.tmp`;Xr(n,t,{encoding:`utf8`,mode:Ur(e)?Yr(e).mode&511:384}),Jr(n,e)}function zs(e){let t=`${e}.bak-${Ls()}`,n=t,r=2;for(;Ur(n);)n=`${t}-${r}`,r+=1;Vr(e,n,Br.COPYFILE_EXCL)}function Bs(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Vs(e){if(!Ur(e.path))return{source:`{}
-`,config:{}};let t=Gr(e.path,`utf8`),n=[],r=Bi(t,n,{allowTrailingComma:!0});if(n.length>0){let t=n[0],r=t?`${Vi(t.error)} at offset ${t.offset}`:`unknown parse error`;throw Error(`Cannot update ${e.path}: invalid JSONC (${r}).`)}if(!Bs(r))throw Error(`Cannot update ${e.path}: config root must be an object.`);if(r.mcpServers!==void 0&&!Bs(r.mcpServers))throw Error(`Cannot update ${e.path}: mcpServers must be an object.`);return{source:t,config:r}}function Hs(e){return e.includes(`mcp`)&&e.includes(`serve`)&&e.some(e=>e===`seo`||e.startsWith(`seo@`)||e===`@seo/cli`)}function Us(e,t){return typeof e.command!=`string`||t.length!==3||t[1]!==`mcp`||t[2]!==`serve`||!Bs(e.env)?!1:e.env.SEO_MCP_CONFIGURED_BY===`seo`}function Ws(e){if(!Bs(e)||!Array.isArray(e.args))return!1;let t=e.args.filter(e=>typeof e==`string`);return Hs(t)||Us(e,t)}function Gs(e){let t=Ri(e.source,zi(e.source,[`mcpServers`,`seo`],e.value,{formattingOptions:Is}));Ur(e.target.path)&&zs(e.target.path),Rs(e.target.path,t)}function Ks(e,t){let n=Si(e,t,{encoding:`utf8`});return{status:n.status,stdout:n.stdout??``,stderr:n.stderr??``,error:n.error}}function qs(e){let t=e.replaceAll(`\\`,`/`).toLowerCase();return t.includes(`/_npx/`)||t.includes(`/.npm/_npx/`)||t.includes(`/.cache/pnpm/dlx/`)}function Js(e){if(!e||!Ur(e))return;let t=qr(e);return qs(t)?void 0:t}function Ys(e={}){let t=Js(e.cliPath??process.argv[1]);if(t)return{command:e.nodePath??process.execPath,args:[t,`mcp`,`serve`]};let n=`seo@${e.version??Ir}`;return(e.platform??process.platform)===`win32`?{command:`cmd`,args:[`/c`,`npx`,`-y`,n,`mcp`,`serve`]}:{command:`npx`,args:[`-y`,n,`mcp`,`serve`]}}function Xs(e=!1,t=Ys()){let n=ir(),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 Zs(e){return e.includes(`SEO_MCP_CONFIGURED_BY`)||/args:\s+-y\s+(?:seo(?:@\S+)?|@seo\/cli)\s+mcp\s+serve\b/.test(e)}function Qs(e,t,n){let r=Ns(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&&!Zs(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=ir(),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 $s(e,t={}){let n={runCommand:t.runCommand??Ks,reinstall:t.reinstall??!1,serverCommand:t.serverCommand??Ys()};if(e.kind===`native`)return Qs(e,`install`,n);let{source:r,config:i}=Vs(e),a=i.mcpServers?.seo,o=Xs(e.includeType,n.serverCommand);if(vi(a,o)&&!n.reinstall)return{client:e.client,path:e.path,changed:!1};if(a!==void 0&&!Ws(a))throw Error(`Cannot install SEO MCP: ${e.path} already has an unmanaged mcpServers.seo entry.`);return Gs({target:e,source:r,value:o}),{client:e.client,path:e.path,changed:!0}}function ec(e,t={}){if(e.kind===`native`)return Qs(e,`uninstall`,{runCommand:t.runCommand??Ks,reinstall:!1,serverCommand:Ys()});if(!Ur(e.path))return{client:e.client,path:e.path,changed:!1};let{source:n,config:r}=Vs(e),i=r.mcpServers;if(i?.seo===void 0)return{client:e.client,path:e.path,changed:!1};if(!Ws(i.seo))throw Error(`Cannot uninstall SEO MCP: ${e.path} has an unmanaged mcpServers.seo entry.`);return Gs({target:e,source:n,value:void 0}),{client:e.client,path:e.path,changed:!0}}function tc(e={}){let t=Si(`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`}.`}}function nc(e,t=[]){let n=[{value:`google`,label:`Google Analytics`,hint:`Use a property available to your Google login`},...t.filter(e=>e.capabilities.some(e=>e.id===`landing-page-visits`)&&e.id!==`google`).map(e=>({value:`extension:${e.id}`,label:e.displayName,hint:`Installed provider from ${e.package}`}))];return e?[{value:`keep`,label:`Keep ${$n(e)}`,hint:`Leave this project connection unchanged`},...n,{value:`remove`,label:`Remove traffic analytics`}]:[...n,{value:`skip`,label:`Skip traffic analytics`}]}async function rc(e,t={},n=!0){if(!e.capabilities.some(e=>e.id===`landing-page-visits`))throw new C(`INVALID_INPUT`,`Provider ${e.id} does not supply landing-page visits.`);let r={...t},i={};for(let t of e.connection.fields.filter(e=>e.kind===`account`)){if(r[t.id]?.trim())continue;if(!n){if(t.required!==!1)throw new C(`INVALID_INPUT`,`${t.label} is required.`);continue}let e=V(await Pi({message:t.label,validate:e=>t.required!==!1&&!e?.trim()?`${t.label} is required`:void 0})).trim();e&&(r[t.id]=e)}let a=e.connection.normalizeAccount?e.connection.normalizeAccount(r):r;try{Object.assign(i,await gt({providerId:e.id,account:a,fields:e.connection.fields}))}catch{}if(e.id===`clicky`&&!i.sitekey){let e=await wt(a.siteId??``);e&&(i.sitekey=e.siteKey)}for(let t of e.connection.fields.filter(e=>e.kind===`secret`)){let r=t.envVar?process.env[t.envVar]?.trim():void 0;if(r&&(i[t.id]=r),i[t.id])continue;if(!n)throw new C(`AUTH_REQUIRED`,t.envVar?`Set ${t.envVar} to connect ${e.displayName}.`:`${t.label} is required to connect ${e.displayName}.`);let a=V(await Mi({message:t.label,validate:e=>t.required!==!1&&!e?.trim()?`${t.label} is required`:void 0})).trim();a&&(i[t.id]=a)}return e.connection.verificationNotice&&E(e.connection.verificationNotice,`Connection check`),await ee({providerId:e.id,account:a,credentials:i}),Object.keys(i).length>0&&await oe({providerId:e.id,account:a,credentials:i}),{provider:`extension`,extension:{providerId:e.id,account:a}}}function ic(e){let t=e.canSkip?[{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 ac(e,t){let n=[],r=!0,i=0;async function a(){for(;i<e.length;){let a=e[i];if(i+=1,a)try{let e=await Gt(a.property,t);n.push(...e.filter(e=>e.webStreamData).map(e=>({account:a.account,property:a.property,propertyName:a.label,stream:e})))}catch{r=!1}}}return await Promise.all(Array.from({length:Math.min(e.length,4)},()=>a())),{candidates:n,complete:r}}async function oc(e){let t=await v();if(t.activeMode===`service-account`)return{status:`service-account`,accountEmail:t.identity};let n=typeof e[`search-console-account`]==`string`?e[`search-console-account`]:void 0,r=Ce();if(n){let e=r.find(e=>e.accountEmail.toLowerCase()===n.toLowerCase());if(!e)throw new C(`AUTH_REQUIRED`,`Google account ${n} is not connected. Run \`seo auth login\` first.`);return{status:`already-connected`,accountEmail:e.accountEmail}}if(e[`skip-auth`])return{status:`skipped`};if(!L({json:e.json===!0})){if(t.tokens)return{status:`already-connected`,accountEmail:t.tokens.account_email};throw new C(`AUTH_REQUIRED`,"Not logged in. Run `seo auth login`, or pass --skip-auth to save a project profile without connecting Google.")}if(r.length>0){let n=V(await Ni({message:`Google account for Search Console`,options:[...r.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`},...typeof e.site==`string`?[{value:{type:`skip`},label:`Skip for now`}]:[]]}));if(n.type===`account`)return Tt(n.accountEmail),{status:`already-connected`,accountEmail:n.accountEmail};if(n.type===`skip`)return{status:`skipped`};if(t.sharedConfigured||t.byoConfigured){let e=await x();return E(`Connected as ${e.account_email}. seo has read-only access and cannot change your site.`,`Google connected`),{status:`connected`,accountEmail:e.account_email}}}let i=V(await Ni({message:`Connect Google now?`,options:ic({sharedConfigured:t.sharedConfigured,byoConfigured:t.byoConfigured,canSkip:typeof e.site==`string`&&e.site.length>0})}));if(i===`skip`)return{status:`skipped`};i===`setup`&&qe({clientId:V(await Pi({message:`Google Desktop OAuth client ID`,validate:e=>e?void 0:`Client ID is required`})),clientSecret:V(await Mi({message:`Google Desktop OAuth client secret`,validate:e=>e?void 0:`Client secret is required`}))});let a=await x();return E(`Connected as ${a.account_email}. seo has read-only access and cannot change your site.`,`Google connected`),{status:`connected`,accountEmail:a.account_email}}async function sc(e){if(e.property)return{propertyId:e.property,accountEmail:e.accountEmail,selection:`explicit`,reason:`Set with --google-analytics-property.`};if(!(e.interactive??L()))return;let t=(await or(e.accountEmail).catch(()=>[])).flatMap(e=>e.propertySummaries.map(t=>({property:Rt(t.property),label:t.displayName??t.property,account:e.displayName??e.account})));if(!t.length)return;let{candidates:n,complete:r}=await ac(t,e.accountEmail),i=r?aa(e.site,n):[],a=new Map;for(let e of i)a.set(e.property,e);let o=[...a.values()];if(o.length===1){let t=o[0];return t?{propertyId:t.property,accountEmail:e.accountEmail,selection:`matched`,reason:oa(t,e.site)}:void 0}let s=o.length?o.map(e=>({property:e.property,label:e.propertyName,account:e.account,match:e})):t,c=V(await Ni({message:o.length?`Several Google Analytics properties match this site. Which property should seo use?`:r?`No Google Analytics web stream clearly matches this site. Attach a property?`:`Some Google Analytics web streams could not be read. Attach a property?`,options:[{value:``,label:`Skip Google Analytics for now`},...s.map(t=>({value:t,label:`${t.label} (${t.property})`,hint:t.match?oa(t.match,e.site):t.account}))]}));if(c)return{propertyId:c.property,accountEmail:e.accountEmail,selection:`manual`,reason:c.match?oa(c.match,e.site):r?`Selected ${c.label} during setup. Its web stream did not clearly match ${e.site}.`:`Selected ${c.label} during setup. seo could not read every Google Analytics web stream, so it did not guess a match.`}}async function cc(e){if(e.googleProperty&&e.clickySiteId)throw new C(`INVALID_INPUT`,`Pass either --google-analytics-property or --clicky-site-id, not both.`);let t=e.interactive??L();if(e.clickySiteId){let n=(await l()).registry.get(`clicky`);if(!n)throw new C(`PROVIDER_UNAVAILABLE`,"The Clicky provider package is not installed. Run `seo providers install @seoskill/clicky-provider`.");return rc(n,{siteId:e.clickySiteId},t)}if(e.googleProperty){let n=await lc({requested:e.googleAccount,interactive:t}),r=await sc({property:e.googleProperty,accountEmail:n,site:e.site,interactive:t});return r?{provider:`google`,google:r}:void 0}if(!t)return;let n=await l(),r=V(await Ni({message:`Traffic analytics`,options:nc(e.current,n.registry.list())}));if(r===`keep`)return;if(r===`remove`)return{provider:`none`};if(r===`skip`)return;if(r.startsWith(`extension:`)){let e=r.slice(10),t=n.registry.get(e);if(!t)throw new C(`INVALID_INPUT`,`Provider ${e} is installed but could not be loaded. Run \`seo providers doctor\`.`);return rc(t)}let i=await sc({accountEmail:await lc({interactive:t}),site:e.site,interactive:t});return i||E(`No Google Analytics property was available for this Google login. You can connect one later.`,`Traffic analytics skipped`),i?{provider:`google`,google:i}:void 0}async function lc(e){let t=await v();if(t.activeMode===`service-account`)return t.identity;let n=Ce();if(e.requested){let t=n.find(t=>t.accountEmail.toLowerCase()===e.requested?.toLowerCase());if(!t)throw new C(`AUTH_REQUIRED`,`Google account ${e.requested} is not connected. Run \`seo auth login\` first.`);return t.accountEmail}if(!e.interactive)return n.find(e=>e.active)?.accountEmail;if(n.length===0)return(await x()).account_email;let r=V(await Ni({message:`Google account for Google Analytics`,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(r.type===`account`)return r.accountEmail;let i=await x();return E(`Connected as ${i.account_email}. seo has read-only access and cannot change your site.`,`Google connected`),i.account_email}async function uc(e){return e[`skip-skill`]||!L({json:e.json===!0})?{status:`skipped`}:V(await Ei({message:`Install the SEO skill so coding agents know how to run reports?`,initialValue:!0}))?tc():{status:`declined`}}async function dc(e){if(e[`skip-mcp`]||!L({json:e.json===!0}))return[];let t=Fs();if(t.length===0||!V(await Ei({message:`Install seo as an MCP server too?`,initialValue:!0})))return[];let n=V(await Ai({message:`Which MCP clients?`,options:t.map(e=>({value:e.client,label:e.label,hint:e.path})),initialValues:t.map(e=>e.client)}));return t.filter(e=>n.includes(e.client)).map(e=>{try{return $s(e)}catch(t){return{client:e.client,path:e.path,changed:!1,error:t instanceof Error?t.message:String(t)}}})}function fc(e){return e.status===`installed`?`installed`:e.status===`failed`?`install failed`:`not installed`}function pc(e){return/^[A-Za-z0-9_./:@-]+$/.test(e)?e:`'${e.replaceAll(`'`,`'\\''`)}'`}function mc(){process.stdout.write(`
-`),Eo({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`})}function hc(e){let t=e.filter(e=>e.error).length,n=e.length-t;return e.length===0?`not installed`:t===0?`${n} installed`:n===0?`${t} skipped`:`${n} installed, ${t} skipped`}function gc(e){let t=e.filter(e=>!!e.error);if(t.length!==0)return t.map(e=>`${e.client}: ${e.error}`).join(`
-`)}async function _c(e){let t=F(e);if(t||Di(process.argv[2]===`start`?`seo start`:`seo setup`),e[`dry-run`]){let e=[`seo auth login`,`seo start`,`seo report --project acme`,`seo refresh-priorities --project acme --verify-content`,`seo technical-watch --project acme`];t?R({dryRun:!0,next:e}):(E(e.join(`
-`),`This setup will guide you through`),ji(`Dry run complete.`));return}Vn();let n=L({json:t});n&&E(`A project profile remembers one site and its report defaults so future commands stay short.`,`Project profiles`);let r=Ge(),i=await As({clients:r,interactive:n,requestedId:O(e.id),skipProfile:A(e[`skip-profile`])}),a=i.mode===`update`?i.client:void 0,o=O(e.site)??a?.siteUrl,s={site:o,options:{allowDefault:i.mode===`update`,json:t,refresh:A(e.refresh)}},c=n?void 0:await zo(s),l=await oc(o?{...e,site:o}:e),u=l.status,d=c??await zo({...s,options:{...s.options,account:l.accountEmail}}),f=Ss(d);if(i.mode===`skip`){let n=await dc(e),r=await uc(e),i=`--site ${pc(d)}`,a=[`seo report ${i}`,`seo refresh-priorities ${i} --verify-content`,`seo technical-watch ${i}`],o={site:d,auth:u,mcp:n,skill:r,next:a};if(t){R(o);return}z([[`Project profile`,`not saved`],[`GSC property`,d],[`Auth`,u],[`MCP`,hc(n)],[`SEO skill`,fc(r)]]);let s=gc(n);s&&E(s,`MCP setup skipped`),r.error&&E(r.error,`SEO skill install failed`),E(a.join(`
-`),`Try next`),ji(`Setup complete.`),mc();return}let p=O(e.name)??(n?V(await Pi({message:`Project name`,placeholder:a?.name??f,defaultValue:a?.name??f})):a?.name??f),m=a?.id??(i.mode===`create`&&i.requestedId?Cs(i.requestedId):ks(p,r)),h=a?.startUrl??xs(d)??``,g=O(e.url)??(n?V(await Pi({message:`Website URL to crawl`,placeholder:h||`https://example.com`,defaultValue:h})):h||void 0),_=e.urls===void 0?a?.watchUrls??[]:P(e.urls),v=await cc({googleProperty:O(e[`google-analytics-property`]),googleAccount:O(e[`google-analytics-account`]),clickySiteId:O(e[`clicky-site-id`]),current:Yn(a),site:d,interactive:n}),y=v?.provider===`google`?v.google:void 0,b=v?.provider===`extension`?v.extension:void 0,ee=a?.brandTerms??dr({id:m,name:p,siteUrl:d}),x=e.brand===void 0?ee:P(e.brand),te=j(e[`report-day`])??a?.reportDay??1,ne=j(e.weekday)??a?.technicalWeekday??1,re=A(e.default)??a?.isDefault??!0,ie={name:p,siteUrl:d,startUrl:g,watchUrls:_,brandTerms:x,analytics:v===void 0?void 0:v.provider===`google`?{...a?.analytics,selected:`google`,google:{propertyId:v.google.propertyId}}:v.provider===`extension`?{...a?.analytics,selected:`extension:${v.extension.providerId}`,extensions:{...a?.analytics.extensions,[v.extension.providerId]:{account:v.extension.account}}}:{},googleAccounts:{...a?.googleAccounts,...l.accountEmail?{searchConsole:l.accountEmail}:{},...y?.accountEmail?{googleAnalytics:y.accountEmail}:{}},reportDay:te,technicalWeekday:ne,isDefault:re},S=a?vn(a.id,ie):en({id:m,...ie}),ae=await dc(e),oe=await uc(e),se=[`seo report --project ${S.id}`,`seo refresh-priorities --project ${S.id} --verify-content`,`seo technical-watch --project ${S.id}`],ce={client:S,site:d,auth:u,googleAnalytics:y,extension:b,mcp:ae,skill:oe,next:se};if(t){R(ce);return}let le=Yn(S);z([[`Project profile`,`${S.name} (${S.id})`],[`GSC property`,S.siteUrl],[`Search Console account`,S.googleAccounts?.searchConsole??`default Google account`],[`Crawl URL`,S.startUrl??`not set`],[`Watch URLs`,String(S.watchUrls.length)],[`Brand terms`,S.brandTerms.join(`, `)||`not set`],[`Traffic analytics`,le?$n(le):`not connected (optional)`],...y?[[`Google Analytics selection`,y.reason]]:[],...S.googleAccounts?.googleAnalytics?[[`Google Analytics account`,S.googleAccounts.googleAnalytics]]:[],[`Auth`,u],[`MCP`,hc(ae)],[`SEO skill`,fc(oe)]]);let ue=gc(ae);ue&&E(ue,`MCP setup skipped`),oe.error&&E(oe.error,`SEO skill install failed`),E(se.join(`
-`),`Try next`),ji(`Setup complete.`),mc()}const vc=T({meta:{name:`setup`,description:`Guided setup for auth, one project profile, MCP, and next commands`},args:{id:{type:`string`,description:`Short stable project id.`},name:{type:`string`,description:`Human project name.`},site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},"search-console-account":{type:`string`,description:`Saved Google account email for Search Console.`},url:{type:`string`,description:`Default technical crawl start URL.`},urls:{type:`string`,description:`Comma-separated URLs to watch with URL Inspection.`},"google-analytics-property":{type:`string`,description:`Optional Google Analytics property ID.`},"google-analytics-account":{type:`string`,description:`Saved Google account email for Google Analytics.`},"clicky-site-id":{type:`string`,description:`Optional Clicky site ID. Set SEO_CLICKY_SITEKEY outside a terminal.`},brand:{type:`string`,description:`Comma-separated branded query terms to exclude by default.`},"report-day":{type:`string`,description:`Preferred monthly report day. Defaults to 1.`},weekday:{type:`string`,description:`Preferred technical-watch weekday. Defaults to Monday.`},default:{type:`boolean`,description:`Make this the default project.`},"skip-profile":{type:`boolean`,default:!1,description:`Do not save a project profile during setup.`},"skip-auth":{type:`boolean`,default:!1,description:`Skip Google sign-in during setup.`},"skip-mcp":{type:`boolean`,default:!1,description:`Skip MCP install prompts.`},"skip-skill":{type:`boolean`,default:!1,description:`Skip the SEO skill install prompt.`},refresh:{type:`boolean`,default:!1,description:`Refresh GSC property discovery.`},"dry-run":{type:`boolean`,default:!1,description:`Show what setup does without changing files.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>_c(e)}),yc=T({...vc,meta:{name:`start`,description:`Start here: connect first-party data, save a profile, and get the first report commands`}}),bc=T({...vc,meta:{name:`setup`,description:`Guided setup for one saved project profile`}}),xc=T({meta:{name:`brand`,description:`Detect and manage project brand query terms`},subCommands:{detect:T({meta:{name:`detect`,description:`Suggest branded query terms from GSC navigational queries`},args:{client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name. Defaults to default.`},site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},days:{type:`string`,description:`Detection window length in days. Defaults to 28.`},limit:{type:`string`,description:`Maximum candidate terms. Defaults to 10.`},"min-impressions":{type:`string`,description:`Minimum query impressions. Defaults to 10.`},save:{type:`boolean`,default:!1,description:`Save suggested terms to the selected project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass local GSC cache.`}},run:async({args:e})=>{let t=F(e),n=yt(k(e)),r=await Rn({site:await zo({site:O(e.site)??n?.siteUrl,options:{json:t,refresh:A(e.refresh)}}),id:n?.id,name:n?.name,days:j(e.days),limit:j(e.limit),minImpressions:j(e[`min-impressions`]),refresh:A(e.refresh)}),i=A(e.save)&&n?en({id:n.id,name:n.name,siteUrl:n.siteUrl,startUrl:n.startUrl,watchUrls:n.watchUrls,analytics:n.analytics,brandTerms:r.suggestedTerms,reportDay:n.reportDay,technicalWeekday:n.technicalWeekday,isDefault:n.isDefault}):void 0;if(A(e.save)&&!n)throw Error(`Pass --project to save detected brand terms.`);if(t){R({...r,saved:i});return}z([[`Property`,r.site],[`Derived terms`,r.derivedTerms.join(`, `)],[`Suggested terms`,r.suggestedTerms.join(`, `)],[`Saved`,i?i.id:`no`]]),B([`Term`,`Score`,`Evidence`],r.candidates.map(e=>[e.term,e.score,e.evidence.map(e=>`${e.query} (${Math.round(e.clicks)} clicks)`).join(`, `)]))}})}}),Sc={project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`}},Cc={type:`boolean`,default:!1,description:`Print machine-readable JSON.`};async function wc(e){let t=await U({project:k(e),options:{json:F(e)}});if(!t)throw new C(`INVALID_INPUT`,`Select a saved project with --project or make one the default.`);return t}async function Tc(e){let t=O(e.keyword),n=O(e.keywords)?.split(`,`).map(e=>e.trim()).filter(Boolean),r=O(e.file),i=[...t?[t]:[],...n??[]];if(r){let e=await hi(r).catch(()=>void 0);if(!e?.isFile()||e.size>1e5)throw new C(`INVALID_INPUT`,`Keyword files must be regular files no larger than 100 KB.`);i.push(...(await di(r,`utf8`)).split(/\r?\n/u).map(e=>e.trim()).filter(Boolean))}if(i.length===0)throw new C(`INVALID_INPUT`,`Pass --keyword, comma-separated --keywords, or a newline-delimited --file.`);return i}const Ec=T({meta:{name:`add`,description:`Add or update keywords in a saved set`},args:{...Sc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},keyword:{type:`string`,description:`One keyword.`},keywords:{type:`string`,description:`Comma-separated keywords.`},file:{type:`string`,description:`Newline-delimited keyword file.`},tags:{type:`string`,description:`Comma-separated tags applied to every keyword.`},"target-url":{type:`string`,description:`Existing target page for every keyword.`},"proposed-url":{type:`string`,description:`Proposed page for every keyword.`},json:Cc},run:async({args:e})=>{let t=O(e[`target-url`]),n=O(e[`proposed-url`]);if(t&&n)throw new C(`INVALID_INPUT`,`Use either --target-url or --proposed-url.`);let r=xr({projectId:(await wc(e)).id,idOrName:O(e.set)??``,items:(await Tc(e)).map(r=>({keyword:r,tags:P(e.tags),...t||n?{page:{kind:t?`target`:`proposed`,url:t??n??``}}:{}}))});F(e)?R(r):z([[`Set`,r.setId],[`Added`,String(r.added)],[`Updated`,String(r.updated)],[`Keywords`,String(r.keywordCount)]])}}),Dc=T({meta:{name:`create`,description:`Create an empty saved keyword set`},args:{...Sc,name:{type:`string`,description:`Keyword set name.`,required:!0},country:{type:`string`,description:`Two-letter country code.`,required:!0},language:{type:`string`,description:`Search language code.`,required:!0},"search-engine":{type:`string`,default:`google`,description:`Search engine: google or bing.`},"location-code":{type:`string`,description:`Optional provider location code.`},location:{type:`string`,description:`Optional canonical location name.`},device:{type:`string`,description:`Optional device: desktop or mobile.`},provider:{type:`string`,description:`Optional preferred provider.`},"source-report":{type:`string`,description:`Report that produced the initial research.`},json:Cc},run:async({args:e})=>{let t=j(e[`location-code`]);if(t!==void 0&&!Number.isSafeInteger(t))throw new C(`INVALID_INPUT`,`--location-code must be an integer.`);let n=await wc(e),r=nt({projectId:n.id,name:O(e.name)??``,market:{searchEngine:O(e[`search-engine`]),countryCode:O(e.country),languageCode:O(e.language),...t!==void 0||O(e.location)?{location:{code:t,name:O(e.location)}}:{},device:O(e.device)},provider:O(e.provider),sourceReport:O(e[`source-report`])});F(e)?R(r):z([[`Created`,r.name],[`Project`,n.name],[`Keywords`,`0`],[`Id`,r.id]])}}),Oc=T({meta:{name:`delete`,description:`Delete a saved keyword set`},args:{...Sc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},yes:{type:`boolean`,default:!1,description:`Confirm permanent deletion.`},json:Cc},run:async({args:e})=>{if(!A(e.yes))throw new C(`INVALID_INPUT`,`Pass --yes to delete the keyword set.`);let t=await wc(e),n=O(e.set)??``;if(!h({projectId:t.id,idOrName:n}))throw new C(`INVALID_INPUT`,`Keyword set not found: ${n}`);let r={deleted:!0,projectId:t.id,set:n};F(e)?R(r):process.stdout.write(`Deleted keyword set ${n}.\n`)}}),kc=T({meta:{name:`export`,description:`Export a bounded saved keyword set`},args:{...Sc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},format:{type:`string`,default:`csv`,description:`Output format: csv or json.`},output:{type:`string`,description:`Output file, or - for stdout.`,required:!0},tag:{type:`string`,description:`Only export keywords with this tag.`},limit:{type:`string`,default:`1000`,description:`Rows to export, from 1 to 1000.`},offset:{type:`string`,default:`0`,description:`Rows to skip.`}},run:async({args:e})=>{let t=O(e.format);if(t!==`csv`&&t!==`json`)throw new C(`INVALID_INPUT`,`--format must be csv or json.`);let n=j(e.limit),r=j(e.offset);if(!Number.isSafeInteger(n)||!Number.isSafeInteger(r))throw new C(`INVALID_INPUT`,`--limit and --offset must be integers.`);let i=Tr({projectId:(await wc(e)).id,idOrName:O(e.set)??``,tag:O(e.tag),limit:n,offset:r}),a=t===`json`?`${JSON.stringify(i,null,2)}\n`:Ac(i),o=O(e.output)??``;if(o===`-`)process.stdout.write(a);else{try{await _i(o,a,{encoding:`utf8`,flag:`wx`,mode:384})}catch(e){throw e.code===`EEXIST`?new C(`INVALID_INPUT`,`Refusing to overwrite the existing file at ${o}.`):e}process.stdout.write(`Wrote ${i.items.length} keywords to ${o}.\n`)}}});function Ac(e){return p(e.items.map(e=>{let t=e.latestMetric?.metric;return{keyword:e.keyword,normalized_keyword:e.normalizedKeyword,tags:e.tags.join(`; `),page_kind:e.page?.kind,page_url:e.page?.url,metric_provider:e.latestMetric?.provider,metric_observed_at:e.latestMetric?.observedAt,monthly_search_volume:jc(t?.monthlySearchVolume),cpc_usd:jc(t?.cpcUsd),paid_competition:jc(t?.paidCompetition),keyword_difficulty:jc(t?.keywordDifficulty),intent:t?.intent.state===`observed`?t.intent.value:null,result_count:jc(t?.resultCount)}}),[`keyword`,`normalized_keyword`,`tags`,`page_kind`,`page_url`,`metric_provider`,`metric_observed_at`,`monthly_search_volume`,`cpc_usd`,`paid_competition`,`keyword_difficulty`,`intent`,`result_count`])}function jc(e){return e?.state===`observed`?e.value:null}function Mc(e){if(e.length===0){process.stdout.write(`No keyword sets saved for this project.
-`);return}B([`Name`,`Keywords`,`Market`,`Provider`,`Updated`],e.map(e=>[e.name,e.keywordCount,`${e.market.countryCode}/${e.market.languageCode}`,e.provider??`automatic`,e.updatedAt]))}function Nc(e){if(z([[`Name`,e.set.name],[`Project`,e.set.projectId],[`Keywords`,String(e.set.keywordCount)],[`Market`,`${e.set.market.searchEngine} ${e.set.market.countryCode}/${e.set.market.languageCode}`],[`Provider`,e.set.provider??`automatic`],[`Last refreshed`,e.set.lastRefreshedAt??`never`]]),e.items.length===0){process.stdout.write(`
+`),`Advanced`),qe({clientId:V(await Pi({message:`Google Desktop OAuth client ID`,validate:e=>e?void 0:`Client ID is required`})),clientSecret:V(await Mi({message:`Google Desktop OAuth client secret`,validate:e=>e?void 0:`Client secret is required`}))}),ji(`Saved local OAuth config to ${ir().oauthClientFile}`)}})}}),ys=[`gsc`,`google-analytics`,`semrush`,`dataforseo`,`ahrefs`,`serpbase`,`clicky`,`http`];function bs(e){if(e!==void 0){if(typeof e==`string`&&ys.includes(e))return e;throw new C(`INVALID_INPUT`,`--provider must be one of: ${ys.join(`, `)}.`)}}const xs=T({meta:{name:`cache`,description:`Cache helpers`},subCommands:{stats:T({meta:{name:`stats`,description:`Show local cache size and row counts`},run:async()=>{let e=It();z([[`DB`,e.dbPath],[`Size`,Fo(e.sizeBytes)],[`Cached data`,`${Fo(e.logicalSizeBytes)} of ${Fo(e.maxSizeBytes)} automatic limit`],[`Sites`,String(e.counts.sites??0)],[`Search Console`,String(e.counts.gsc_cache??0)],[`Google Analytics`,String(e.counts.google_analytics_cache??0)],[`Semrush`,String(e.counts.semrush_cache??0)],[`DataForSEO`,String(e.counts.provider_cache??0)],[`Ahrefs`,String(e.counts.ahrefs_cache??0)],[`SerpBase`,String(e.counts.serpbase_cache??0)],[`Clicky`,String(e.counts.clicky_cache??0)],[`HTTP`,String(e.counts.http_cache??0)]])}}),clear:T({meta:{name:`clear`,description:`Clear cached API and HTTP data`},args:{provider:{type:`string`,description:`Optional cache provider: gsc, google-analytics, semrush, dataforseo, ahrefs, serpbase, clicky, or http`}},run:async({args:e})=>{let t=hn(bs(e.provider));process.stdout.write(`Removed ${t} cached rows.\n`)}})}});async function Ss(e,t={}){return(await H({client:e.client,project:e.project,site:e.site,options:t})).site}function Cs(e){if(e.startsWith(`http://`)||e.startsWith(`https://`))return e;if(e.startsWith(`sc-domain:`))return`https://${e.slice(10)}/`}function ws(e){return e.replace(/^sc-domain:/,``).replace(/^https?:\/\//,``)}function Ts(e){return e.toLowerCase().replace(/^https?:\/\//,``).replace(/^sc-domain:/,``).replace(/[^a-z0-9]+/g,`-`).replace(/^-+|-+$/g,``).slice(0,60)}function Es(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 Ds(e){return e?e===`serp-framing`?`wording gap`:e===`content-gap`?`content gap`:e===`technical-check`?`technical check`:`covered`:`-`}const Os=`__create_project__`,ks=`__skip_project__`;function As(e){return[{value:Os,label:`Create a new project`,hint:`Save a separate site and its data sources`},...e.map(e=>({value:e.id,label:`Update ${e.name}`,hint:`${e.id}, ${e.siteUrl}`})),{value:ks,label:`Continue without a project profile`,hint:`Pass --site or --url when you run reports`}]}function js(e,t){let n=Ts(e);if(!n)throw Error(`Project id could not be derived.`);let r=new Set(t.map(e=>e.id.toLowerCase()));if(!r.has(n.toLowerCase()))return n;let i=2;for(;r.has(`${n}-${i}`.toLowerCase());)i+=1;return`${n}-${i}`}async function Ms(e){if(e.skipProfile)return{mode:`skip`};if(e.requestedId){let t=e.requestedId.toLowerCase(),n=Ts(e.requestedId).toLowerCase(),r=e.clients.find(e=>e.id.toLowerCase()===n||e.name.toLowerCase()===t);return r?{mode:`update`,client:r}:{mode:`create`,requestedId:e.requestedId}}if(!e.interactive)return{mode:`create`};let t=As(e.clients),n=V(await(e.prompt?e.prompt(t):Ni({message:`Create a project or update an existing one?`,options:t})));if(n===Os)return{mode:`create`};if(n===ks)return{mode:`skip`};let r=e.clients.find(e=>e.id===n);if(!r)throw Error(`Project not found: ${n}`);return{mode:`update`,client:r}}function Ns(e){let t=e.platform===`win32`?ii:ti;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 Ps(e={}){let t=e.home??oi(),n=e.platform??process.platform,r=Ns({home:t,platform:n,env:e.env??process.env}),i=n===`win32`?ii:ti,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 Fs(e,t={}){let n=t.platform??process.platform,r=t.exists??Ur,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=w(e,t);if(r(n))return n}for(let e of a){let t=w(Qr(i),e);if(r(t))return t}return e}function Is(e){return Fs(e)!==e}function Ls(e={}){let t=e.targets??Ps(),n=e.hasCommand??Is,r=e.hasPath??Ur;return t.filter(e=>e.kind===`native`?e.commandNames.some(n):r(e.path)||e.detectionPaths.some(r)||e.commandNames.some(n))}const Rs={insertSpaces:!0,tabSize:2,eol:`
+`};function zs(){return new Date().toISOString().replace(/[:.]/g,`-`)}function Bs(e,t){Wr(Qr(e),{recursive:!0,mode:448});let n=`${e}.${process.pid}.${Date.now()}.tmp`;Xr(n,t,{encoding:`utf8`,mode:Ur(e)?Yr(e).mode&511:384}),Jr(n,e)}function Vs(e){let t=`${e}.bak-${zs()}`,n=t,r=2;for(;Ur(n);)n=`${t}-${r}`,r+=1;Vr(e,n,Br.COPYFILE_EXCL)}function Hs(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Us(e){if(!Ur(e.path))return{source:`{}
+`,config:{}};let t=Gr(e.path,`utf8`),n=[],r=Bi(t,n,{allowTrailingComma:!0});if(n.length>0){let t=n[0],r=t?`${Vi(t.error)} at offset ${t.offset}`:`unknown parse error`;throw Error(`Cannot update ${e.path}: invalid JSONC (${r}).`)}if(!Hs(r))throw Error(`Cannot update ${e.path}: config root must be an object.`);if(r.mcpServers!==void 0&&!Hs(r.mcpServers))throw Error(`Cannot update ${e.path}: mcpServers must be an object.`);return{source:t,config:r}}function Ws(e){return e.includes(`mcp`)&&e.includes(`serve`)&&e.some(e=>e===`seo`||e.startsWith(`seo@`)||e===`@seo/cli`)}function Gs(e,t){return typeof e.command!=`string`||t.length!==3||t[1]!==`mcp`||t[2]!==`serve`||!Hs(e.env)?!1:e.env.SEO_MCP_CONFIGURED_BY===`seo`}function Ks(e){if(!Hs(e)||!Array.isArray(e.args))return!1;let t=e.args.filter(e=>typeof e==`string`);return Ws(t)||Gs(e,t)}function qs(e){let t=Ri(e.source,zi(e.source,[`mcpServers`,`seo`],e.value,{formattingOptions:Rs}));Ur(e.target.path)&&Vs(e.target.path),Bs(e.target.path,t)}function Js(e,t){let n=Si(e,t,{encoding:`utf8`});return{status:n.status,stdout:n.stdout??``,stderr:n.stderr??``,error:n.error}}function Ys(e){let t=e.replaceAll(`\\`,`/`).toLowerCase();return t.includes(`/_npx/`)||t.includes(`/.npm/_npx/`)||t.includes(`/.cache/pnpm/dlx/`)}function Xs(e){if(!e||!Ur(e))return;let t=qr(e);return Ys(t)?void 0:t}function Zs(e={}){let t=Xs(e.cliPath??process.argv[1]);if(t)return{command:e.nodePath??process.execPath,args:[t,`mcp`,`serve`]};let n=`seo@${e.version??Ir}`;return(e.platform??process.platform)===`win32`?{command:`cmd`,args:[`/c`,`npx`,`-y`,n,`mcp`,`serve`]}:{command:`npx`,args:[`-y`,n,`mcp`,`serve`]}}function Qs(e=!1,t=Zs()){let n=ir(),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 ec(e,t,n){let r=Fs(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=ir(),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 tc(e,t={}){let n={runCommand:t.runCommand??Js,reinstall:t.reinstall??!1,serverCommand:t.serverCommand??Zs()};if(e.kind===`native`)return ec(e,`install`,n);let{source:r,config:i}=Us(e),a=i.mcpServers?.seo,o=Qs(e.includeType,n.serverCommand);if(vi(a,o)&&!n.reinstall)return{client:e.client,path:e.path,changed:!1};if(a!==void 0&&!Ks(a))throw Error(`Cannot install SEO MCP: ${e.path} already has an unmanaged mcpServers.seo entry.`);return qs({target:e,source:r,value:o}),{client:e.client,path:e.path,changed:!0}}function nc(e,t={}){if(e.kind===`native`)return ec(e,`uninstall`,{runCommand:t.runCommand??Js,reinstall:!1,serverCommand:Zs()});if(!Ur(e.path))return{client:e.client,path:e.path,changed:!1};let{source:n,config:r}=Us(e),i=r.mcpServers;if(i?.seo===void 0)return{client:e.client,path:e.path,changed:!1};if(!Ks(i.seo))throw Error(`Cannot uninstall SEO MCP: ${e.path} has an unmanaged mcpServers.seo entry.`);return qs({target:e,source:n,value:void 0}),{client:e.client,path:e.path,changed:!0}}function rc(e={}){let t=Si(`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`}.`}}function ic(e,t=[]){let n=[{value:`google`,label:`Google Analytics`,hint:`Use a property available to your Google login`},...t.filter(e=>e.capabilities.some(e=>e.id===`landing-page-visits`)&&e.id!==`google`).map(e=>({value:`extension:${e.id}`,label:e.displayName,hint:`Installed provider from ${e.package}`}))];return e?[{value:`keep`,label:`Keep ${$n(e)}`,hint:`Leave this project connection unchanged`},...n,{value:`remove`,label:`Remove traffic analytics`}]:[...n,{value:`skip`,label:`Skip traffic analytics`}]}async function ac(e,t={},n=!0){if(!e.capabilities.some(e=>e.id===`landing-page-visits`))throw new C(`INVALID_INPUT`,`Provider ${e.id} does not supply landing-page visits.`);let r={...t},i={};for(let t of e.connection.fields.filter(e=>e.kind===`account`)){if(r[t.id]?.trim())continue;if(!n){if(t.required!==!1)throw new C(`INVALID_INPUT`,`${t.label} is required.`);continue}let e=V(await Pi({message:t.label,validate:e=>t.required!==!1&&!e?.trim()?`${t.label} is required`:void 0})).trim();e&&(r[t.id]=e)}let a=e.connection.normalizeAccount?e.connection.normalizeAccount(r):r;try{Object.assign(i,await gt({providerId:e.id,account:a,fields:e.connection.fields}))}catch{}if(e.id===`clicky`&&!i.sitekey){let e=await wt(a.siteId??``);e&&(i.sitekey=e.siteKey)}for(let t of e.connection.fields.filter(e=>e.kind===`secret`)){let r=t.envVar?process.env[t.envVar]?.trim():void 0;if(r&&(i[t.id]=r),i[t.id])continue;if(!n)throw new C(`AUTH_REQUIRED`,t.envVar?`Set ${t.envVar} to connect ${e.displayName}.`:`${t.label} is required to connect ${e.displayName}.`);let a=V(await Mi({message:t.label,validate:e=>t.required!==!1&&!e?.trim()?`${t.label} is required`:void 0})).trim();a&&(i[t.id]=a)}return e.connection.verificationNotice&&E(e.connection.verificationNotice,`Connection check`),await ee({providerId:e.id,account:a,credentials:i}),Object.keys(i).length>0&&await oe({providerId:e.id,account:a,credentials:i}),{provider:`extension`,extension:{providerId:e.id,account:a}}}function oc(e){let t=e.canSkip?[{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 sc(e,t){let n=[],r=!0,i=0;async function a(){for(;i<e.length;){let a=e[i];if(i+=1,a)try{let e=await Gt(a.property,t);n.push(...e.filter(e=>e.webStreamData).map(e=>({account:a.account,property:a.property,propertyName:a.label,stream:e})))}catch{r=!1}}}return await Promise.all(Array.from({length:Math.min(e.length,4)},()=>a())),{candidates:n,complete:r}}async function cc(e){let t=await v();if(t.activeMode===`service-account`)return{status:`service-account`,accountEmail:t.identity};let n=typeof e[`search-console-account`]==`string`?e[`search-console-account`]:void 0,r=Ce();if(n){let e=r.find(e=>e.accountEmail.toLowerCase()===n.toLowerCase());if(!e)throw new C(`AUTH_REQUIRED`,`Google account ${n} is not connected. Run \`seo auth login\` first.`);return{status:`already-connected`,accountEmail:e.accountEmail}}if(e[`skip-auth`])return{status:`skipped`};if(!L({json:e.json===!0})){if(t.tokens)return{status:`already-connected`,accountEmail:t.tokens.account_email};throw new C(`AUTH_REQUIRED`,"Not logged in. Run `seo auth login`, or pass --skip-auth to save a project profile without connecting Google.")}if(r.length>0){let n=V(await Ni({message:`Google account for Search Console`,options:[...r.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`},...typeof e.site==`string`?[{value:{type:`skip`},label:`Skip for now`}]:[]]}));if(n.type===`account`)return Tt(n.accountEmail),{status:`already-connected`,accountEmail:n.accountEmail};if(n.type===`skip`)return{status:`skipped`};if(t.sharedConfigured||t.byoConfigured){let e=await ps();return E(`Connected as ${e.account_email}. seo has read-only access and cannot change your site.`,`Google connected`),{status:`connected`,accountEmail:e.account_email}}}let i=V(await Ni({message:`Connect Google now?`,options:oc({sharedConfigured:t.sharedConfigured,byoConfigured:t.byoConfigured,canSkip:typeof e.site==`string`&&e.site.length>0})}));if(i===`skip`)return{status:`skipped`};i===`setup`&&qe({clientId:V(await Pi({message:`Google Desktop OAuth client ID`,validate:e=>e?void 0:`Client ID is required`})),clientSecret:V(await Mi({message:`Google Desktop OAuth client secret`,validate:e=>e?void 0:`Client secret is required`}))});let a=await ps();return E(`Connected as ${a.account_email}. seo has read-only access and cannot change your site.`,`Google connected`),{status:`connected`,accountEmail:a.account_email}}async function lc(e){if(e.property)return{propertyId:e.property,accountEmail:e.accountEmail,selection:`explicit`,reason:`Set with --google-analytics-property.`};if(!(e.interactive??L()))return;let t=(await or(e.accountEmail).catch(()=>[])).flatMap(e=>e.propertySummaries.map(t=>({property:Rt(t.property),label:t.displayName??t.property,account:e.displayName??e.account})));if(!t.length)return;let{candidates:n,complete:r}=await sc(t,e.accountEmail),i=r?aa(e.site,n):[],a=new Map;for(let e of i)a.set(e.property,e);let o=[...a.values()];if(o.length===1){let t=o[0];return t?{propertyId:t.property,accountEmail:e.accountEmail,selection:`matched`,reason:oa(t,e.site)}:void 0}let s=o.length?o.map(e=>({property:e.property,label:e.propertyName,account:e.account,match:e})):t,c=V(await Ni({message:o.length?`Several Google Analytics properties match this site. Which property should seo use?`:r?`No Google Analytics web stream clearly matches this site. Attach a property?`:`Some Google Analytics web streams could not be read. Attach a property?`,options:[{value:``,label:`Skip Google Analytics for now`},...s.map(t=>({value:t,label:`${t.label} (${t.property})`,hint:t.match?oa(t.match,e.site):t.account}))]}));if(c)return{propertyId:c.property,accountEmail:e.accountEmail,selection:`manual`,reason:c.match?oa(c.match,e.site):r?`Selected ${c.label} during setup. Its web stream did not clearly match ${e.site}.`:`Selected ${c.label} during setup. seo could not read every Google Analytics web stream, so it did not guess a match.`}}async function uc(e){if(e.googleProperty&&e.clickySiteId)throw new C(`INVALID_INPUT`,`Pass either --google-analytics-property or --clicky-site-id, not both.`);let t=e.interactive??L();if(e.clickySiteId){let n=(await l()).registry.get(`clicky`);if(!n)throw new C(`PROVIDER_UNAVAILABLE`,"The Clicky provider package is not installed. Run `seo providers install @seoskill/clicky-provider`.");return ac(n,{siteId:e.clickySiteId},t)}if(e.googleProperty){let n=await dc({requested:e.googleAccount,interactive:t}),r=await lc({property:e.googleProperty,accountEmail:n,site:e.site,interactive:t});return r?{provider:`google`,google:r}:void 0}if(!t)return;let n=await l(),r=V(await Ni({message:`Traffic analytics`,options:ic(e.current,n.registry.list())}));if(r===`keep`)return;if(r===`remove`)return{provider:`none`};if(r===`skip`)return;if(r.startsWith(`extension:`)){let e=r.slice(10),t=n.registry.get(e);if(!t)throw new C(`INVALID_INPUT`,`Provider ${e} is installed but could not be loaded. Run \`seo providers doctor\`.`);return ac(t)}let i=await lc({accountEmail:await dc({interactive:t}),site:e.site,interactive:t});return i||E(`No Google Analytics property was available for this Google login. You can connect one later.`,`Traffic analytics skipped`),i?{provider:`google`,google:i}:void 0}async function dc(e){let t=await v();if(t.activeMode===`service-account`)return t.identity;let n=Ce();if(e.requested){let t=n.find(t=>t.accountEmail.toLowerCase()===e.requested?.toLowerCase());if(!t)throw new C(`AUTH_REQUIRED`,`Google account ${e.requested} is not connected. Run \`seo auth login\` first.`);return t.accountEmail}if(!e.interactive)return n.find(e=>e.active)?.accountEmail;if(n.length===0)return(await ps()).account_email;let r=V(await Ni({message:`Google account for Google Analytics`,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(r.type===`account`)return r.accountEmail;let i=await ps();return E(`Connected as ${i.account_email}. seo has read-only access and cannot change your site.`,`Google connected`),i.account_email}async function fc(e){return e[`skip-skill`]||!L({json:e.json===!0})?{status:`skipped`}:V(await Ei({message:`Install the SEO skill so coding agents know how to run reports?`,initialValue:!0}))?rc():{status:`declined`}}async function pc(e){if(e[`skip-mcp`]||!L({json:e.json===!0}))return[];let t=Ls();if(t.length===0||!V(await Ei({message:`Install seo as an MCP server too?`,initialValue:!0})))return[];let n=V(await Ai({message:`Which MCP clients?`,options:t.map(e=>({value:e.client,label:e.label,hint:e.path})),initialValues:t.map(e=>e.client)}));return t.filter(e=>n.includes(e.client)).map(e=>{try{return tc(e)}catch(t){return{client:e.client,path:e.path,changed:!1,error:t instanceof Error?t.message:String(t)}}})}function mc(e){return e.status===`installed`?`installed`:e.status===`failed`?`install failed`:`not installed`}function hc(e){return/^[A-Za-z0-9_./:@-]+$/.test(e)?e:`'${e.replaceAll(`'`,`'\\''`)}'`}function gc(){process.stdout.write(`
+`),Eo({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`})}function _c(e){let t=e.filter(e=>e.error).length,n=e.length-t;return e.length===0?`not installed`:t===0?`${n} installed`:n===0?`${t} skipped`:`${n} installed, ${t} skipped`}function vc(e){let t=e.filter(e=>!!e.error);if(t.length!==0)return t.map(e=>`${e.client}: ${e.error}`).join(`
+`)}async function yc(e){let t=F(e);if(t||Di(process.argv[2]===`start`?`seo start`:`seo setup`),e[`dry-run`]){let e=[`seo auth login`,`seo start`,`seo report --project acme`,`seo refresh-priorities --project acme --verify-content`,`seo technical-watch --project acme`];t?R({dryRun:!0,next:e}):(E(e.join(`
+`),`This setup will guide you through`),ji(`Dry run complete.`));return}Vn();let n=L({json:t});n&&E(`A project profile remembers one site and its report defaults so future commands stay short.`,`Project profiles`);let r=Ge(),i=await Ms({clients:r,interactive:n,requestedId:O(e.id),skipProfile:A(e[`skip-profile`])}),a=i.mode===`update`?i.client:void 0,o=O(e.site)??a?.siteUrl,s={site:o,options:{allowDefault:i.mode===`update`,json:t,refresh:A(e.refresh)}},c=n?void 0:await zo(s),l=await cc(o?{...e,site:o}:e),u=l.status,d=c??await zo({...s,options:{...s.options,account:l.accountEmail}}),f=ws(d);if(i.mode===`skip`){let n=await pc(e),r=await fc(e),i=`--site ${hc(d)}`,a=[`seo report ${i}`,`seo refresh-priorities ${i} --verify-content`,`seo technical-watch ${i}`],o={site:d,auth:u,mcp:n,skill:r,next:a};if(t){R(o);return}z([[`Project profile`,`not saved`],[`GSC property`,d],[`Auth`,u],[`MCP`,_c(n)],[`SEO skill`,mc(r)]]);let s=vc(n);s&&E(s,`MCP setup skipped`),r.error&&E(r.error,`SEO skill install failed`),E(a.join(`
+`),`Try next`),ji(`Setup complete.`),gc();return}let p=O(e.name)??(n?V(await Pi({message:`Project name`,placeholder:a?.name??f,defaultValue:a?.name??f})):a?.name??f),m=a?.id??(i.mode===`create`&&i.requestedId?Ts(i.requestedId):js(p,r)),h=a?.startUrl??Cs(d)??``,g=O(e.url)??(n?V(await Pi({message:`Website URL to crawl`,placeholder:h||`https://example.com`,defaultValue:h})):h||void 0),_=e.urls===void 0?a?.watchUrls??[]:P(e.urls),v=await uc({googleProperty:O(e[`google-analytics-property`]),googleAccount:O(e[`google-analytics-account`]),clickySiteId:O(e[`clicky-site-id`]),current:Yn(a),site:d,interactive:n}),y=v?.provider===`google`?v.google:void 0,b=v?.provider===`extension`?v.extension:void 0,ee=a?.brandTerms??dr({id:m,name:p,siteUrl:d}),x=e.brand===void 0?ee:P(e.brand),te=j(e[`report-day`])??a?.reportDay??1,ne=j(e.weekday)??a?.technicalWeekday??1,re=A(e.default)??a?.isDefault??!0,ie={name:p,siteUrl:d,startUrl:g,watchUrls:_,brandTerms:x,analytics:v===void 0?void 0:v.provider===`google`?{...a?.analytics,selected:`google`,google:{propertyId:v.google.propertyId}}:v.provider===`extension`?{...a?.analytics,selected:`extension:${v.extension.providerId}`,extensions:{...a?.analytics.extensions,[v.extension.providerId]:{account:v.extension.account}}}:{},googleAccounts:{...a?.googleAccounts,...l.accountEmail?{searchConsole:l.accountEmail}:{},...y?.accountEmail?{googleAnalytics:y.accountEmail}:{}},reportDay:te,technicalWeekday:ne,isDefault:re},S=a?vn(a.id,ie):en({id:m,...ie}),ae=await pc(e),oe=await fc(e),se=[`seo report --project ${S.id}`,`seo refresh-priorities --project ${S.id} --verify-content`,`seo technical-watch --project ${S.id}`],ce={client:S,site:d,auth:u,googleAnalytics:y,extension:b,mcp:ae,skill:oe,next:se};if(t){R(ce);return}let le=Yn(S);z([[`Project profile`,`${S.name} (${S.id})`],[`GSC property`,S.siteUrl],[`Search Console account`,S.googleAccounts?.searchConsole??`default Google account`],[`Crawl URL`,S.startUrl??`not set`],[`Watch URLs`,String(S.watchUrls.length)],[`Brand terms`,S.brandTerms.join(`, `)||`not set`],[`Traffic analytics`,le?$n(le):`not connected (optional)`],...y?[[`Google Analytics selection`,y.reason]]:[],...S.googleAccounts?.googleAnalytics?[[`Google Analytics account`,S.googleAccounts.googleAnalytics]]:[],[`Auth`,u],[`MCP`,_c(ae)],[`SEO skill`,mc(oe)]]);let ue=vc(ae);ue&&E(ue,`MCP setup skipped`),oe.error&&E(oe.error,`SEO skill install failed`),E(se.join(`
+`),`Try next`),ji(`Setup complete.`),gc()}const bc=T({meta:{name:`setup`,description:`Guided setup for auth, one project profile, MCP, and next commands`},args:{id:{type:`string`,description:`Short stable project id.`},name:{type:`string`,description:`Human project name.`},site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},"search-console-account":{type:`string`,description:`Saved Google account email for Search Console.`},url:{type:`string`,description:`Default technical crawl start URL.`},urls:{type:`string`,description:`Comma-separated URLs to watch with URL Inspection.`},"google-analytics-property":{type:`string`,description:`Optional Google Analytics property ID.`},"google-analytics-account":{type:`string`,description:`Saved Google account email for Google Analytics.`},"clicky-site-id":{type:`string`,description:`Optional Clicky site ID. Set SEO_CLICKY_SITEKEY outside a terminal.`},brand:{type:`string`,description:`Comma-separated branded query terms to exclude by default.`},"report-day":{type:`string`,description:`Preferred monthly report day. Defaults to 1.`},weekday:{type:`string`,description:`Preferred technical-watch weekday. Defaults to Monday.`},default:{type:`boolean`,description:`Make this the default project.`},"skip-profile":{type:`boolean`,default:!1,description:`Do not save a project profile during setup.`},"skip-auth":{type:`boolean`,default:!1,description:`Skip Google sign-in during setup.`},"skip-mcp":{type:`boolean`,default:!1,description:`Skip MCP install prompts.`},"skip-skill":{type:`boolean`,default:!1,description:`Skip the SEO skill install prompt.`},refresh:{type:`boolean`,default:!1,description:`Refresh GSC property discovery.`},"dry-run":{type:`boolean`,default:!1,description:`Show what setup does without changing files.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>yc(e)}),xc=T({...bc,meta:{name:`start`,description:`Start here: connect first-party data, save a profile, and get the first report commands`}}),Sc=T({...bc,meta:{name:`setup`,description:`Guided setup for one saved project profile`}}),Cc=T({meta:{name:`brand`,description:`Detect and manage project brand query terms`},subCommands:{detect:T({meta:{name:`detect`,description:`Suggest branded query terms from GSC navigational queries`},args:{client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name. Defaults to default.`},site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},days:{type:`string`,description:`Detection window length in days. Defaults to 28.`},limit:{type:`string`,description:`Maximum candidate terms. Defaults to 10.`},"min-impressions":{type:`string`,description:`Minimum query impressions. Defaults to 10.`},save:{type:`boolean`,default:!1,description:`Save suggested terms to the selected project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass local GSC cache.`}},run:async({args:e})=>{let t=F(e),n=yt(k(e)),r=await Rn({site:await zo({site:O(e.site)??n?.siteUrl,options:{json:t,refresh:A(e.refresh)}}),id:n?.id,name:n?.name,days:j(e.days),limit:j(e.limit),minImpressions:j(e[`min-impressions`]),refresh:A(e.refresh)}),i=A(e.save)&&n?en({id:n.id,name:n.name,siteUrl:n.siteUrl,startUrl:n.startUrl,watchUrls:n.watchUrls,analytics:n.analytics,brandTerms:r.suggestedTerms,reportDay:n.reportDay,technicalWeekday:n.technicalWeekday,isDefault:n.isDefault}):void 0;if(A(e.save)&&!n)throw Error(`Pass --project to save detected brand terms.`);if(t){R({...r,saved:i});return}z([[`Property`,r.site],[`Derived terms`,r.derivedTerms.join(`, `)],[`Suggested terms`,r.suggestedTerms.join(`, `)],[`Saved`,i?i.id:`no`]]),B([`Term`,`Score`,`Evidence`],r.candidates.map(e=>[e.term,e.score,e.evidence.map(e=>`${e.query} (${Math.round(e.clicks)} clicks)`).join(`, `)]))}})}}),wc={project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`}},Tc={type:`boolean`,default:!1,description:`Print machine-readable JSON.`};async function Ec(e){let t=await U({project:k(e),options:{json:F(e)}});if(!t)throw new C(`INVALID_INPUT`,`Select a saved project with --project or make one the default.`);return t}async function Dc(e){let t=O(e.keyword),n=O(e.keywords)?.split(`,`).map(e=>e.trim()).filter(Boolean),r=O(e.file),i=[...t?[t]:[],...n??[]];if(r){let e=await hi(r).catch(()=>void 0);if(!e?.isFile()||e.size>1e5)throw new C(`INVALID_INPUT`,`Keyword files must be regular files no larger than 100 KB.`);i.push(...(await di(r,`utf8`)).split(/\r?\n/u).map(e=>e.trim()).filter(Boolean))}if(i.length===0)throw new C(`INVALID_INPUT`,`Pass --keyword, comma-separated --keywords, or a newline-delimited --file.`);return i}const Oc=T({meta:{name:`add`,description:`Add or update keywords in a saved set`},args:{...wc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},keyword:{type:`string`,description:`One keyword.`},keywords:{type:`string`,description:`Comma-separated keywords.`},file:{type:`string`,description:`Newline-delimited keyword file.`},tags:{type:`string`,description:`Comma-separated tags applied to every keyword.`},"target-url":{type:`string`,description:`Existing target page for every keyword.`},"proposed-url":{type:`string`,description:`Proposed page for every keyword.`},json:Tc},run:async({args:e})=>{let t=O(e[`target-url`]),n=O(e[`proposed-url`]);if(t&&n)throw new C(`INVALID_INPUT`,`Use either --target-url or --proposed-url.`);let r=xr({projectId:(await Ec(e)).id,idOrName:O(e.set)??``,items:(await Dc(e)).map(r=>({keyword:r,tags:P(e.tags),...t||n?{page:{kind:t?`target`:`proposed`,url:t??n??``}}:{}}))});F(e)?R(r):z([[`Set`,r.setId],[`Added`,String(r.added)],[`Updated`,String(r.updated)],[`Keywords`,String(r.keywordCount)]])}}),kc=T({meta:{name:`create`,description:`Create an empty saved keyword set`},args:{...wc,name:{type:`string`,description:`Keyword set name.`,required:!0},country:{type:`string`,description:`Two-letter country code.`,required:!0},language:{type:`string`,description:`Search language code.`,required:!0},"search-engine":{type:`string`,default:`google`,description:`Search engine: google or bing.`},"location-code":{type:`string`,description:`Optional provider location code.`},location:{type:`string`,description:`Optional canonical location name.`},device:{type:`string`,description:`Optional device: desktop or mobile.`},provider:{type:`string`,description:`Optional preferred provider.`},"source-report":{type:`string`,description:`Report that produced the initial research.`},json:Tc},run:async({args:e})=>{let t=j(e[`location-code`]);if(t!==void 0&&!Number.isSafeInteger(t))throw new C(`INVALID_INPUT`,`--location-code must be an integer.`);let n=await Ec(e),r=nt({projectId:n.id,name:O(e.name)??``,market:{searchEngine:O(e[`search-engine`]),countryCode:O(e.country),languageCode:O(e.language),...t!==void 0||O(e.location)?{location:{code:t,name:O(e.location)}}:{},device:O(e.device)},provider:O(e.provider),sourceReport:O(e[`source-report`])});F(e)?R(r):z([[`Created`,r.name],[`Project`,n.name],[`Keywords`,`0`],[`Id`,r.id]])}}),Ac=T({meta:{name:`delete`,description:`Delete a saved keyword set`},args:{...wc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},yes:{type:`boolean`,default:!1,description:`Confirm permanent deletion.`},json:Tc},run:async({args:e})=>{if(!A(e.yes))throw new C(`INVALID_INPUT`,`Pass --yes to delete the keyword set.`);let t=await Ec(e),n=O(e.set)??``;if(!h({projectId:t.id,idOrName:n}))throw new C(`INVALID_INPUT`,`Keyword set not found: ${n}`);let r={deleted:!0,projectId:t.id,set:n};F(e)?R(r):process.stdout.write(`Deleted keyword set ${n}.\n`)}}),jc=T({meta:{name:`export`,description:`Export a bounded saved keyword set`},args:{...wc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},format:{type:`string`,default:`csv`,description:`Output format: csv or json.`},output:{type:`string`,description:`Output file, or - for stdout.`,required:!0},tag:{type:`string`,description:`Only export keywords with this tag.`},limit:{type:`string`,default:`1000`,description:`Rows to export, from 1 to 1000.`},offset:{type:`string`,default:`0`,description:`Rows to skip.`}},run:async({args:e})=>{let t=O(e.format);if(t!==`csv`&&t!==`json`)throw new C(`INVALID_INPUT`,`--format must be csv or json.`);let n=j(e.limit),r=j(e.offset);if(!Number.isSafeInteger(n)||!Number.isSafeInteger(r))throw new C(`INVALID_INPUT`,`--limit and --offset must be integers.`);let i=Tr({projectId:(await Ec(e)).id,idOrName:O(e.set)??``,tag:O(e.tag),limit:n,offset:r}),a=t===`json`?`${JSON.stringify(i,null,2)}\n`:Mc(i),o=O(e.output)??``;if(o===`-`)process.stdout.write(a);else{try{await _i(o,a,{encoding:`utf8`,flag:`wx`,mode:384})}catch(e){throw e.code===`EEXIST`?new C(`INVALID_INPUT`,`Refusing to overwrite the existing file at ${o}.`):e}process.stdout.write(`Wrote ${i.items.length} keywords to ${o}.\n`)}}});function Mc(e){return p(e.items.map(e=>{let t=e.latestMetric?.metric;return{keyword:e.keyword,normalized_keyword:e.normalizedKeyword,tags:e.tags.join(`; `),page_kind:e.page?.kind,page_url:e.page?.url,metric_provider:e.latestMetric?.provider,metric_observed_at:e.latestMetric?.observedAt,monthly_search_volume:Nc(t?.monthlySearchVolume),cpc_usd:Nc(t?.cpcUsd),paid_competition:Nc(t?.paidCompetition),keyword_difficulty:Nc(t?.keywordDifficulty),intent:t?.intent.state===`observed`?t.intent.value:null,result_count:Nc(t?.resultCount)}}),[`keyword`,`normalized_keyword`,`tags`,`page_kind`,`page_url`,`metric_provider`,`metric_observed_at`,`monthly_search_volume`,`cpc_usd`,`paid_competition`,`keyword_difficulty`,`intent`,`result_count`])}function Nc(e){return e?.state===`observed`?e.value:null}function Pc(e){if(e.length===0){process.stdout.write(`No keyword sets saved for this project.
+`);return}B([`Name`,`Keywords`,`Market`,`Provider`,`Updated`],e.map(e=>[e.name,e.keywordCount,`${e.market.countryCode}/${e.market.languageCode}`,e.provider??`automatic`,e.updatedAt]))}function Fc(e){if(z([[`Name`,e.set.name],[`Project`,e.set.projectId],[`Keywords`,String(e.set.keywordCount)],[`Market`,`${e.set.market.searchEngine} ${e.set.market.countryCode}/${e.set.market.languageCode}`],[`Provider`,e.set.provider??`automatic`],[`Last refreshed`,e.set.lastRefreshedAt??`never`]]),e.items.length===0){process.stdout.write(`
 No keywords matched this view.
 `);return}process.stdout.write(`
-`),B([`Keyword`,`Tags`,`Volume`,`Page`],e.items.map(e=>[e.keyword,e.tags.join(`, `)||`-`,e.latestMetric?.metric.monthlySearchVolume.state===`observed`?e.latestMetric.metric.monthlySearchVolume.value:`-`,e.page?.url??`-`])),e.pagination.nextOffset!==null&&process.stdout.write(`\nMore rows are available. Continue with --offset ${e.pagination.nextOffset}.\n`)}const Pc=T({meta:{name:`list`,description:`List saved keyword sets for a project`},args:{...Sc,json:Cc},run:async({args:e})=>{let t=await wc(e),n=ot({projectId:t.id});F(e)?R({projectId:t.id,sets:n}):Mc(n)}}),Fc=T({meta:{name:`refresh`,description:`Preview or refresh saved keyword metrics`},args:{...Sc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},provider:{type:`string`,description:`Optional keyword provider.`},limit:{type:`string`,default:`1000`,description:`Keywords to refresh, from 1 to 1000.`},offset:{type:`string`,default:`0`,description:`Saved keyword offset, from 0 to 100000.`},yes:{type:`boolean`,default:!1,description:`Run the paid refresh after estimating its cost.`},json:Cc},run:async({args:e})=>{let t=j(e.limit),n=j(e.offset);if(!Number.isSafeInteger(t))throw new C(`INVALID_INPUT`,`--limit must be an integer.`);if(!Number.isSafeInteger(n))throw new C(`INVALID_INPUT`,`--offset must be an integer.`);let r=await Pt({projectId:(await wc(e)).id,idOrName:O(e.set)??``,provider:O(e.provider),limit:t,offset:n,execute:A(e.yes)});if(F(e)){R(r);return}z([[`Set`,r.set.name],[`Mode`,r.mode],[`Keywords`,String(r.selection.selectedKeywords)],[`Offset`,String(r.selection.offset)],[`Requests`,String(r.cost.requestCount)],[`Estimated cost`,r.cost.estimatedMicros===null?`unavailable`:`$${(r.cost.estimatedMicros/1e6).toFixed(4)}`],...r.execution?[[`Saved snapshots`,String(r.execution.savedSnapshots)],[`Partial batches`,String(r.execution.partialBatches)],[`Failed batches`,String(r.execution.failedBatches)],[`Actual cost`,r.execution.actualMicros===null?`unavailable`:`$${(r.execution.actualMicros/1e6).toFixed(4)}`]]:[]]),r.mode===`preview`&&process.stdout.write(`\nRun again with --yes to refresh these ${r.selection.selectedKeywords} keywords.\n`)}}),Ic=T({meta:{name:`remove`,description:`Remove keywords from a saved set`},args:{...Sc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},keyword:{type:`string`,description:`One keyword.`},keywords:{type:`string`,description:`Comma-separated keywords.`},file:{type:`string`,description:`Newline-delimited keyword file.`},json:Cc},run:async({args:e})=>{let t=Nr({projectId:(await wc(e)).id,idOrName:O(e.set)??``,keywords:await Tc(e)});F(e)?R(t):z([[`Set`,t.setId],[`Removed`,String(t.removed)],[`Keywords`,String(t.keywordCount)]])}}),Lc=T({meta:{name:`keyword-sets`,description:`Manage project keyword research sets`},subCommands:{create:Dc,list:Pc,show:T({meta:{name:`show`,description:`Show a bounded saved keyword set view`},args:{...Sc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},tag:{type:`string`,description:`Only return keywords with this tag.`},limit:{type:`string`,default:`100`,description:`Rows to return, from 1 to 1000.`},offset:{type:`string`,default:`0`,description:`Rows to skip.`},json:Cc},run:async({args:e})=>{let t=j(e.limit),n=j(e.offset);if(!Number.isSafeInteger(t)||!Number.isSafeInteger(n))throw new C(`INVALID_INPUT`,`--limit and --offset must be integers.`);let r=Tr({projectId:(await wc(e)).id,idOrName:O(e.set)??``,tag:O(e.tag),limit:t,offset:n});F(e)?R(r):Nc(r)}}),add:Ec,remove:Ic,refresh:Fc,export:kc,delete:Oc}});function Rc(e){jo(e.map(e=>({title:`${e.name}${e.isDefault?` (default)`:``}`,description:e.siteUrl,meta:[e.id,e.startUrl?`crawl ${e.startUrl}`:``,e.watchUrls.length?`${e.watchUrls.length} watched URL${e.watchUrls.length===1?``:`s`}`:``,e.brandTerms.length?`${e.brandTerms.length} brand term${e.brandTerms.length===1?``:`s`}`:``]})),{empty:`No saved projects.`})}function zc(e){z([[`ID`,e.id],[`Name`,e.name],[`GSC property`,e.siteUrl],[`Search Console account`,e.googleAccounts?.searchConsole??`default Google account`],[`Crawl URL`,e.startUrl??`not set`],[`Watch URLs`,e.watchUrls.join(`, `)||`not set`],[`Brand terms`,e.brandTerms.join(`, `)||`not set`],[`Google Analytics property`,e.analytics.google?.propertyId??`not set`],[`Google Analytics account`,e.googleAccounts?.googleAnalytics??`default Google account`],[`Clicky site`,e.analytics.clicky?.siteId??`not set`],[`Selected analytics`,e.analytics.selected??`not set`],[`Report day`,e.reportDay?String(e.reportDay):`not set`],[`Technical weekday`,e.technicalWeekday===void 0?`not set`:String(e.technicalWeekday)],[`Default`,e.isDefault?`yes`:`no`]])}const Bc=T({meta:{name:`add`,description:`Create or update a project profile`},args:{id:{type:`string`,description:`Short stable project id, for example acme.`},name:{type:`string`,description:`Human project name.`},site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},"search-console-account":{type:`string`,description:`Saved Google account email for Search Console.`},url:{type:`string`,description:`Default technical crawl start URL.`},urls:{type:`string`,description:`Comma-separated URLs to watch with URL Inspection.`},"google-analytics-property":{type:`string`,description:`Optional Google Analytics property ID for this project.`},"google-analytics-account":{type:`string`,description:`Saved Google account email for Google Analytics.`},"clicky-site-id":{type:`string`,description:`Optional legacy Clicky site ID. New connections use seo start.`},brand:{type:`string`,description:`Comma-separated branded query terms to exclude by default.`},"report-day":{type:`string`,description:`Preferred monthly report day, 1-31.`},weekday:{type:`string`,description:`Preferred technical-watch weekday, 0-7.`},default:{type:`boolean`,description:`Make this the default project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=O(e.id),r=n?yt(n)??yt(Cs(n)):void 0,i=O(e[`google-analytics-property`]),a=O(e[`google-analytics-account`]),o=O(e[`search-console-account`]),s=O(e[`clicky-site-id`]);if(i&&s)throw new C(`INVALID_INPUT`,`Pass either --google-analytics-property or --clicky-site-id, not both.`);if(a&&!i&&!r?.analytics.google?.propertyId)throw new C(`INVALID_INPUT`,`--google-analytics-account needs a Google Analytics property.`);let c=await zo({site:O(e.site)??r?.siteUrl,options:{json:t,account:o}}),l={name:O(e.name),siteUrl:c,startUrl:O(e.url),watchUrls:e.urls===void 0?void 0:P(e.urls),brandTerms:e.brand===void 0?void 0:P(e.brand),analytics:i||a?{...r?.analytics,selected:`google`,google:{propertyId:i??r?.analytics.google?.propertyId??``}}:s?{...r?.analytics,selected:`clicky`,clicky:{siteId:s}}:void 0,googleAccounts:o||a?{...r?.googleAccounts,...o?{searchConsole:o}:{},...a?{googleAnalytics:a}:{}}:void 0,reportDay:j(e[`report-day`]),technicalWeekday:j(e.weekday),isDefault:A(e.default)},u=r?vn(r.id,l):en({id:n,...l});if(t){R(u);return}zc(u)}}),Vc=T({meta:{name:`default`,description:`Set the default project`},args:{id:{type:`string`,required:!0,description:`Project id or name.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=nr(O(e.id)??``);if(F(e)){R(t);return}process.stdout.write(`Default project set to ${t.id}.\n`)}}),Hc=T({meta:{name:`delete`,description:`Delete a project profile`},args:{id:{type:`string`,required:!0,description:`Project id or name.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.id)??``,n=Ct(t);if(F(e)){R({id:t,deleted:n});return}process.stdout.write(`${n?`Deleted`:`Not found`} ${t}.\n`)}}),Uc=T({meta:{name:`client`,description:`Manage saved project profiles`},subCommands:{setup:bc,brand:xc,"keyword-sets":Lc,list:T({meta:{name:`list`,description:`List saved project profiles`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=Ge();if(F(e)){R({clients:t});return}Rc(t)}}),add:Bc,show:T({meta:{name:`show`,description:`Show one project profile`},args:{id:{type:`string`,description:`Project id or name. Defaults to the default project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=yt(O(e.id));if(!t)throw Error(`Project not found.`);if(F(e)){R(t);return}zc(t)}}),default:Vc,delete:Hc}}),Wc=T({...Uc,meta:{name:`projects`,description:`Manage saved project profiles`}}),Gc=T({meta:{name:`content`,description:`Optimize page content from real GSC queries`},subCommands:{optimize:T({meta:{name:`optimize`,description:`Build a content optimization report for one URL`},args:{site:{type:`string`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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":Fa(`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=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await Xe({site:n.site,url:O(e.url)??``,days:j(e.days),limit:j(e.limit),minImpressions:j(e[`min-impressions`]),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),verifyContent:A(e[`verify-content`])!==!1,js:A(e.js)?!0:`auto`,refresh:A(e.refresh)});if(t){R(r);return}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:W(r.summary.queries)},{label:`Opportunities`,value:W(r.summary.opportunities)},{label:`Estimated lift`,value:W(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(`
+`),B([`Keyword`,`Tags`,`Volume`,`Page`],e.items.map(e=>[e.keyword,e.tags.join(`, `)||`-`,e.latestMetric?.metric.monthlySearchVolume.state===`observed`?e.latestMetric.metric.monthlySearchVolume.value:`-`,e.page?.url??`-`])),e.pagination.nextOffset!==null&&process.stdout.write(`\nMore rows are available. Continue with --offset ${e.pagination.nextOffset}.\n`)}const Ic=T({meta:{name:`list`,description:`List saved keyword sets for a project`},args:{...wc,json:Tc},run:async({args:e})=>{let t=await Ec(e),n=ot({projectId:t.id});F(e)?R({projectId:t.id,sets:n}):Pc(n)}}),Lc=T({meta:{name:`refresh`,description:`Preview or refresh saved keyword metrics`},args:{...wc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},provider:{type:`string`,description:`Optional keyword provider.`},limit:{type:`string`,default:`1000`,description:`Keywords to refresh, from 1 to 1000.`},offset:{type:`string`,default:`0`,description:`Saved keyword offset, from 0 to 100000.`},yes:{type:`boolean`,default:!1,description:`Run the paid refresh after estimating its cost.`},json:Tc},run:async({args:e})=>{let t=j(e.limit),n=j(e.offset);if(!Number.isSafeInteger(t))throw new C(`INVALID_INPUT`,`--limit must be an integer.`);if(!Number.isSafeInteger(n))throw new C(`INVALID_INPUT`,`--offset must be an integer.`);let r=await Pt({projectId:(await Ec(e)).id,idOrName:O(e.set)??``,provider:O(e.provider),limit:t,offset:n,execute:A(e.yes)});if(F(e)){R(r);return}z([[`Set`,r.set.name],[`Mode`,r.mode],[`Keywords`,String(r.selection.selectedKeywords)],[`Offset`,String(r.selection.offset)],[`Requests`,String(r.cost.requestCount)],[`Estimated cost`,r.cost.estimatedMicros===null?`unavailable`:`$${(r.cost.estimatedMicros/1e6).toFixed(4)}`],...r.execution?[[`Saved snapshots`,String(r.execution.savedSnapshots)],[`Partial batches`,String(r.execution.partialBatches)],[`Failed batches`,String(r.execution.failedBatches)],[`Actual cost`,r.execution.actualMicros===null?`unavailable`:`$${(r.execution.actualMicros/1e6).toFixed(4)}`]]:[]]),r.mode===`preview`&&process.stdout.write(`\nRun again with --yes to refresh these ${r.selection.selectedKeywords} keywords.\n`)}}),Rc=T({meta:{name:`remove`,description:`Remove keywords from a saved set`},args:{...wc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},keyword:{type:`string`,description:`One keyword.`},keywords:{type:`string`,description:`Comma-separated keywords.`},file:{type:`string`,description:`Newline-delimited keyword file.`},json:Tc},run:async({args:e})=>{let t=Nr({projectId:(await Ec(e)).id,idOrName:O(e.set)??``,keywords:await Dc(e)});F(e)?R(t):z([[`Set`,t.setId],[`Removed`,String(t.removed)],[`Keywords`,String(t.keywordCount)]])}}),zc=T({meta:{name:`keyword-sets`,description:`Manage project keyword research sets`},subCommands:{create:kc,list:Ic,show:T({meta:{name:`show`,description:`Show a bounded saved keyword set view`},args:{...wc,set:{type:`string`,description:`Keyword set id or name.`,required:!0},tag:{type:`string`,description:`Only return keywords with this tag.`},limit:{type:`string`,default:`100`,description:`Rows to return, from 1 to 1000.`},offset:{type:`string`,default:`0`,description:`Rows to skip.`},json:Tc},run:async({args:e})=>{let t=j(e.limit),n=j(e.offset);if(!Number.isSafeInteger(t)||!Number.isSafeInteger(n))throw new C(`INVALID_INPUT`,`--limit and --offset must be integers.`);let r=Tr({projectId:(await Ec(e)).id,idOrName:O(e.set)??``,tag:O(e.tag),limit:t,offset:n});F(e)?R(r):Fc(r)}}),add:Oc,remove:Rc,refresh:Lc,export:jc,delete:Ac}});function Bc(e){jo(e.map(e=>({title:`${e.name}${e.isDefault?` (default)`:``}`,description:e.siteUrl,meta:[e.id,e.startUrl?`crawl ${e.startUrl}`:``,e.watchUrls.length?`${e.watchUrls.length} watched URL${e.watchUrls.length===1?``:`s`}`:``,e.brandTerms.length?`${e.brandTerms.length} brand term${e.brandTerms.length===1?``:`s`}`:``]})),{empty:`No saved projects.`})}function Vc(e){z([[`ID`,e.id],[`Name`,e.name],[`GSC property`,e.siteUrl],[`Search Console account`,e.googleAccounts?.searchConsole??`default Google account`],[`Crawl URL`,e.startUrl??`not set`],[`Watch URLs`,e.watchUrls.join(`, `)||`not set`],[`Brand terms`,e.brandTerms.join(`, `)||`not set`],[`Google Analytics property`,e.analytics.google?.propertyId??`not set`],[`Google Analytics account`,e.googleAccounts?.googleAnalytics??`default Google account`],[`Clicky site`,e.analytics.clicky?.siteId??`not set`],[`Selected analytics`,e.analytics.selected??`not set`],[`Report day`,e.reportDay?String(e.reportDay):`not set`],[`Technical weekday`,e.technicalWeekday===void 0?`not set`:String(e.technicalWeekday)],[`Default`,e.isDefault?`yes`:`no`]])}const Hc=T({meta:{name:`add`,description:`Create or update a project profile`},args:{id:{type:`string`,description:`Short stable project id, for example acme.`},name:{type:`string`,description:`Human project name.`},site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},"search-console-account":{type:`string`,description:`Saved Google account email for Search Console.`},url:{type:`string`,description:`Default technical crawl start URL.`},urls:{type:`string`,description:`Comma-separated URLs to watch with URL Inspection.`},"google-analytics-property":{type:`string`,description:`Optional Google Analytics property ID for this project.`},"google-analytics-account":{type:`string`,description:`Saved Google account email for Google Analytics.`},"clicky-site-id":{type:`string`,description:`Optional legacy Clicky site ID. New connections use seo start.`},brand:{type:`string`,description:`Comma-separated branded query terms to exclude by default.`},"report-day":{type:`string`,description:`Preferred monthly report day, 1-31.`},weekday:{type:`string`,description:`Preferred technical-watch weekday, 0-7.`},default:{type:`boolean`,description:`Make this the default project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=O(e.id),r=n?yt(n)??yt(Ts(n)):void 0,i=O(e[`google-analytics-property`]),a=O(e[`google-analytics-account`]),o=O(e[`search-console-account`]),s=O(e[`clicky-site-id`]);if(i&&s)throw new C(`INVALID_INPUT`,`Pass either --google-analytics-property or --clicky-site-id, not both.`);if(a&&!i&&!r?.analytics.google?.propertyId)throw new C(`INVALID_INPUT`,`--google-analytics-account needs a Google Analytics property.`);let c=await zo({site:O(e.site)??r?.siteUrl,options:{json:t,account:o}}),l={name:O(e.name),siteUrl:c,startUrl:O(e.url),watchUrls:e.urls===void 0?void 0:P(e.urls),brandTerms:e.brand===void 0?void 0:P(e.brand),analytics:i||a?{...r?.analytics,selected:`google`,google:{propertyId:i??r?.analytics.google?.propertyId??``}}:s?{...r?.analytics,selected:`clicky`,clicky:{siteId:s}}:void 0,googleAccounts:o||a?{...r?.googleAccounts,...o?{searchConsole:o}:{},...a?{googleAnalytics:a}:{}}:void 0,reportDay:j(e[`report-day`]),technicalWeekday:j(e.weekday),isDefault:A(e.default)},u=r?vn(r.id,l):en({id:n,...l});if(t){R(u);return}Vc(u)}}),Uc=T({meta:{name:`default`,description:`Set the default project`},args:{id:{type:`string`,required:!0,description:`Project id or name.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=nr(O(e.id)??``);if(F(e)){R(t);return}process.stdout.write(`Default project set to ${t.id}.\n`)}}),Wc=T({meta:{name:`delete`,description:`Delete a project profile`},args:{id:{type:`string`,required:!0,description:`Project id or name.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.id)??``,n=Ct(t);if(F(e)){R({id:t,deleted:n});return}process.stdout.write(`${n?`Deleted`:`Not found`} ${t}.\n`)}}),Gc=T({meta:{name:`client`,description:`Manage saved project profiles`},subCommands:{setup:Sc,brand:Cc,"keyword-sets":zc,list:T({meta:{name:`list`,description:`List saved project profiles`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=Ge();if(F(e)){R({clients:t});return}Bc(t)}}),add:Hc,show:T({meta:{name:`show`,description:`Show one project profile`},args:{id:{type:`string`,description:`Project id or name. Defaults to the default project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=yt(O(e.id));if(!t)throw Error(`Project not found.`);if(F(e)){R(t);return}Vc(t)}}),default:Uc,delete:Wc}}),Kc=T({...Gc,meta:{name:`projects`,description:`Manage saved project profiles`}}),qc=T({meta:{name:`content`,description:`Optimize page content from real GSC queries`},subCommands:{optimize:T({meta:{name:`optimize`,description:`Build a content optimization report for one URL`},args:{site:{type:`string`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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":Fa(`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=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await Xe({site:n.site,url:O(e.url)??``,days:j(e.days),limit:j(e.limit),minImpressions:j(e[`min-impressions`]),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),verifyContent:A(e[`verify-content`])!==!1,js:A(e.js)?!0:`auto`,refresh:A(e.refresh)});if(t){R(r);return}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:W(r.summary.queries)},{label:`Opportunities`,value:W(r.summary.opportunities)},{label:`Estimated lift`,value:W(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,W(e.queries),W(e.impressions),W(e.clicks)]))),Y(`Caveats`,r.caveats)}})}});var Kc=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 qc(e){return`  `.repeat(e)}function Jc(e){return e&&typeof e==`object`&&`toJSON`in e&&typeof e.toJSON==`function`?e.toJSON():e}async function Yc(e,t,n,r,i=!1){let a=Jc(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,W(e.queries),W(e.impressions),W(e.clicks)]))),Y(`Caveats`,r.caveats)}})}});var Jc=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 Yc(e){return`  `.repeat(e)}function Xc(e){return e&&typeof e==`object`&&`toJSON`in e&&typeof e.toJSON==`function`?e.toJSON():e}async function Zc(e,t,n,r,i=!1){let a=Xc(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(qc(n+1)),await Yc(e,a[t],n+1,r,!0);return await e.write(`\n${qc(n)}]`),!0}let t=Object.entries(a).filter(([,e])=>{let t=Jc(e);return![`undefined`,`function`,`symbol`].includes(typeof t)});if(t.length===0)return await e.write(`{}`),!0;await e.write(`{
+`),await e.write(Yc(n+1)),await Zc(e,a[t],n+1,r,!0);return await e.write(`\n${Yc(n)}]`),!0}let t=Object.entries(a).filter(([,e])=>{let t=Xc(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(`${qc(n+1)}${JSON.stringify(a)}: `),await Yc(e,o,n+1,r)}return await e.write(`\n${qc(n)}}`),!0}finally{r.delete(a)}}async function Xc(e,t){let n=new Kc(e);await Yc(n,t,0,new Set)||await n.write(`undefined`),await n.write(`
-`),await n.flush()}async function Zc(e,t){if(!e){await Xc(process.stdout,t);return}await li(Qr(e),{recursive:!0});let n=Hr(e);try{await Xc(n,t),n.end(),await Hi(n)}catch(e){throw n.destroy(),e}process.stdout.write(`Wrote ${e}\n`)}function Qc(e){return e===`high`?`fail`:`warning`}function $c(e,t=yr(e)){let n=Mt(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:Qc(e.severity),title:`${e.title} on ${e.count} ${e.count===1?`URL`:`URLs`}`,explanation:lr(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:lr(e.ruleId)?.whyItMatters??e.whyThisRanks,evidence:e.sampleUrls.slice(0,5),fix:e.howToFix}));ko({title:e.config.strategy===`health`?`Sitemap health pass`:`Site crawl`,target:e.config.url,status:r,summary: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},...!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 el={"google-analytics-property":{type:`string`,description:`Google Analytics property ID for landing-page sessions. Defaults from --project when saved.`},"clicky-site-id":{type:`string`,description:`Clicky site ID for landing-page visits. Defaults from --project when saved.`}};function tl(e,t){let n=O(e[`google-analytics-property`]),r=O(e[`clicky-site-id`]);if(n&&r)throw new C(`INVALID_INPUT`,`Pass either --google-analytics-property or --clicky-site-id, not both.`);return n?{provider:`google`,propertyId:n}:r?{provider:`clicky`,siteId:ve(r)}:t}const nl={high:3,medium:2,low:1},rl=T({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. Optional when --project has a saved crawl URL.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...el,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.`},save:{type:`boolean`,default:!1,description:`Save the crawl report locally.`},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=F(e),n=sl(e.format,t),r=O(e.output),i=cl(e.csv),a=al(e.severity),o=al(e[`fail-on`]),s=k(e),c=await ll(e),l=ol(e),u=O(e[`sitemap-url`]),d=A(e.health),f=il(e.mode);if(n===`junit`&&!d)throw Error(`--format junit requires --health.`);if((d||u)&&f&&f!==`sitemap`)throw Error(`--health and --sitemap-url require sitemap mode.`);if(d&&La(e,`sitemap`))throw Error(`--health cannot be combined with --no-sitemap.`);if((d||u)&&c.length)throw Error(`--health and --sitemap-url cannot be combined with URL list input.`);let p=O(e.site)||s||!l&&!c.length&&!u?await H({client:s,site:O(e.site),options:{json:t}}):void 0,m=l??p?.client?.startUrl??(p?.site?xs(p.site):void 0)??(u?new URL(`/`,u).toString():void 0)??c[0];if(!m)throw Error(`No crawl URL selected. Pass a URL, --url, or use --project with a saved crawl URL.`);let h=await it({url:m,projectId:p?.client?.id,site:p?.site,mode:f??(d||u?`sitemap`:c.length?`list`:void 0),strategy:d?`health`:`full`,sitemapUrl:u,urls:c,maxPages:j(e[`max-pages`]),maxDepth:j(e[`max-depth`]),concurrency:j(e.concurrency),refresh:A(e.refresh),fetchRate:Ba({...e,"fetch-concurrency":e.concurrency}),include:N(e.include),exclude:N(e.exclude),googleAnalyticsPropertyId:O(e[`google-analytics-property`]),analyticsConnection:tl(e,Yn(p?.client)),useSitemap:!La(e,`sitemap`),respectRobots:!La(e,`robots`),checkExternal:!La(e,`external`),js:Ia(e)}),g=A(e.save)?bn(h):void 0,_=yr(h,{severity:a}),v=o?h.issues.some(e=>nl[e.severity]>=nl[o]):!1,y=h.status===`failed`,b={...h,topFixes:_,reviewObservations:Mt(h,{severity:a}),...o?{failOn:o,failedThreshold:v}:{},...g?{saved:g}:{}};if(n===`json`){await Zc(r,b),(y||v)&&(process.exitCode=1);return}if(n===`csv`){await dl(r,i===`pages`?dn(h):Jt(h)),(y||v)&&(process.exitCode=1);return}if(n===`html`){await dl(r,nn(h,_)),(y||v)&&(process.exitCode=1);return}if(n===`junit`){await dl(r,Kn(h)),(y||v)&&(process.exitCode=1);return}if(n===`markdown`){await dl(r,Mn(h,_)),(y||v)&&(process.exitCode=1);return}if(r){await dl(r,sn(h,_)),(y||v)&&(process.exitCode=1);return}$c(h,_),(g||o)&&(process.stdout.write(`
+`),await e.write(`${Yc(n+1)}${JSON.stringify(a)}: `),await Zc(e,o,n+1,r)}return await e.write(`\n${Yc(n)}}`),!0}finally{r.delete(a)}}async function Qc(e,t){let n=new Jc(e);await Zc(n,t,0,new Set)||await n.write(`undefined`),await n.write(`
+`),await n.flush()}async function $c(e,t){if(!e){await Qc(process.stdout,t);return}await li(Qr(e),{recursive:!0});let n=Hr(e);try{await Qc(n,t),n.end(),await Hi(n)}catch(e){throw n.destroy(),e}process.stdout.write(`Wrote ${e}\n`)}function el(e){return e===`high`?`fail`:`warning`}function tl(e,t=yr(e)){let n=Mt(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:el(e.severity),title:`${e.title} on ${e.count} ${e.count===1?`URL`:`URLs`}`,explanation:lr(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:lr(e.ruleId)?.whyItMatters??e.whyThisRanks,evidence:e.sampleUrls.slice(0,5),fix:e.howToFix}));ko({title:e.config.strategy===`health`?`Sitemap health pass`:`Site crawl`,target:e.config.url,status:r,summary: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},...!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 nl={"google-analytics-property":{type:`string`,description:`Google Analytics property ID for landing-page sessions. Defaults from --project when saved.`},"clicky-site-id":{type:`string`,description:`Clicky site ID for landing-page visits. Defaults from --project when saved.`}};function rl(e,t){let n=O(e[`google-analytics-property`]),r=O(e[`clicky-site-id`]);if(n&&r)throw new C(`INVALID_INPUT`,`Pass either --google-analytics-property or --clicky-site-id, not both.`);return n?{provider:`google`,propertyId:n}:r?{provider:`clicky`,siteId:ve(r)}:t}const il={high:3,medium:2,low:1},al=T({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. Optional when --project has a saved crawl URL.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...nl,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.`},save:{type:`boolean`,default:!1,description:`Save the crawl report locally.`},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=F(e),n=ll(e.format,t),r=O(e.output),i=ul(e.csv),a=sl(e.severity),o=sl(e[`fail-on`]),s=k(e),c=await dl(e),l=cl(e),u=O(e[`sitemap-url`]),d=A(e.health),f=ol(e.mode);if(n===`junit`&&!d)throw Error(`--format junit requires --health.`);if((d||u)&&f&&f!==`sitemap`)throw Error(`--health and --sitemap-url require sitemap mode.`);if(d&&La(e,`sitemap`))throw Error(`--health cannot be combined with --no-sitemap.`);if((d||u)&&c.length)throw Error(`--health and --sitemap-url cannot be combined with URL list input.`);let p=O(e.site)||s||!l&&!c.length&&!u?await H({client:s,site:O(e.site),options:{json:t}}):void 0,m=l??p?.client?.startUrl??(p?.site?Cs(p.site):void 0)??(u?new URL(`/`,u).toString():void 0)??c[0];if(!m)throw Error(`No crawl URL selected. Pass a URL, --url, or use --project with a saved crawl URL.`);let h=await it({url:m,projectId:p?.client?.id,site:p?.site,mode:f??(d||u?`sitemap`:c.length?`list`:void 0),strategy:d?`health`:`full`,sitemapUrl:u,urls:c,maxPages:j(e[`max-pages`]),maxDepth:j(e[`max-depth`]),concurrency:j(e.concurrency),refresh:A(e.refresh),fetchRate:Ba({...e,"fetch-concurrency":e.concurrency}),include:N(e.include),exclude:N(e.exclude),googleAnalyticsPropertyId:O(e[`google-analytics-property`]),analyticsConnection:rl(e,Yn(p?.client)),useSitemap:!La(e,`sitemap`),respectRobots:!La(e,`robots`),checkExternal:!La(e,`external`),js:Ia(e)}),g=A(e.save)?bn(h):void 0,_=yr(h,{severity:a}),v=o?h.issues.some(e=>il[e.severity]>=il[o]):!1,y=h.status===`failed`,b={...h,topFixes:_,reviewObservations:Mt(h,{severity:a}),...o?{failOn:o,failedThreshold:v}:{},...g?{saved:g}:{}};if(n===`json`){await $c(r,b),(y||v)&&(process.exitCode=1);return}if(n===`csv`){await pl(r,i===`pages`?dn(h):Jt(h)),(y||v)&&(process.exitCode=1);return}if(n===`html`){await pl(r,nn(h,_)),(y||v)&&(process.exitCode=1);return}if(n===`junit`){await pl(r,Kn(h)),(y||v)&&(process.exitCode=1);return}if(n===`markdown`){await pl(r,Mn(h,_)),(y||v)&&(process.exitCode=1);return}if(r){await pl(r,sn(h,_)),(y||v)&&(process.exitCode=1);return}tl(h,_),(g||o)&&(process.stdout.write(`
 Run metadata
-`),z([[`Saved report`,g?.id??`no`],[`Fail threshold`,o??`off`]])),(y||v)&&(process.exitCode=1)}});function il(e){let t=O(e);if(t){if([`site`,`page`,`list`,`sitemap`].includes(t))return t;throw Error(`Mode must be one of: site, page, list, sitemap.`)}}function al(e){let t=O(e);if(t){if([`low`,`medium`,`high`].includes(t))return t;throw Error(`Severity must be one of: low, medium, high.`)}}function ol(e){let t=O(e.crawlUrl),n=O(e.url);if(t&&n&&t!==n)throw Error(`Use either a URL argument or --url, not both.`);return t??n}function sl(e,t){let n=O(e);if(t&&n&&n!==`json`)throw Error(`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 Error(`Format must be one of: pretty, json, csv, html, markdown, junit.`)}function cl(e){let t=O(e);if(!t)return`issues`;if([`issues`,`pages`].includes(t))return t;throw Error(`CSV table must be one of: issues, pages.`)}async function ll(e){let t=N(e.urls)??[],n=O(e[`urls-file`]);return n&&t.push(...ul(await di(n,`utf8`))),[...new Set(t)]}function ul(e){return e.split(/[\n,]/).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`))}async function dl(e,t){if(!e){process.stdout.write(t);return}await li(Qr(e),{recursive:!0}),await _i(e,t),process.stdout.write(`Wrote ${e}\n`)}async function fl(e,t){let n=k(e),r=O(e.site);if(!(!n&&!r))return(await H({client:n,site:r,options:{json:t}})).site}function pl(e){jo(e.map(e=>({title:e.id,description:e.site??e.url,meta:[e.status,`${e.totalPages} page${e.totalPages===1?``:`s`}`,`${e.issueCount} issue${e.issueCount===1?``:`s`}`,e.createdAt]})),{empty:`No saved crawl reports.`})}function ml(e){$c(e)}function hl(e){K({title:`Crawl report comparison`,target:e.after.url,status:e.comparability.status!==`comparable`||e.completeness.status!==`complete`?`unknown`:e.summary.newStatusErrors>0||e.summary.issueGroupsWorse>0?`warning`:`pass`,summary:e.headline,metrics:[{label:`Before`,value:`${e.before.id} (${e.before.generatedAt})`},{label:`After`,value:`${e.after.id} (${e.after.generatedAt})`},{label:`Comparability`,value:e.comparability.status},{label:`Completeness`,value:e.completeness.status},{label:`Pages`,value:`${e.after.summary.totalPages} (${e.summary.pageDelta>=0?`+`:``}${e.summary.pageDelta})`},{label:`Issues`,value:`${e.after.summary.highIssues+e.after.summary.mediumIssues+e.after.summary.lowIssues} (${e.summary.issueDelta>=0?`+`:``}${e.summary.issueDelta})`},{label:`New status errors`,value:e.summary.newStatusErrors},{label:`Fixed status errors`,value:e.summary.fixedStatusErrors},{label:`Issue groups worse`,value:e.summary.issueGroupsWorse},{label:`Issue groups better`,value:e.summary.issueGroupsBetter},{label:`Changed pages`,value:e.summary.changedPages},{label:`Added pages`,value:e.summary.addedPages},{label:`Removed pages`,value:e.summary.removedPages}]}),J(`Top actions`,e.topActions.map(e=>({label:e.title,context:e.plainEnglish,action:e.action})),e.topActions.length),e.pageChanges.length&&(process.stdout.write(`
+`),z([[`Saved report`,g?.id??`no`],[`Fail threshold`,o??`off`]])),(y||v)&&(process.exitCode=1)}});function ol(e){let t=O(e);if(t){if([`site`,`page`,`list`,`sitemap`].includes(t))return t;throw Error(`Mode must be one of: site, page, list, sitemap.`)}}function sl(e){let t=O(e);if(t){if([`low`,`medium`,`high`].includes(t))return t;throw Error(`Severity must be one of: low, medium, high.`)}}function cl(e){let t=O(e.crawlUrl),n=O(e.url);if(t&&n&&t!==n)throw Error(`Use either a URL argument or --url, not both.`);return t??n}function ll(e,t){let n=O(e);if(t&&n&&n!==`json`)throw Error(`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 Error(`Format must be one of: pretty, json, csv, html, markdown, junit.`)}function ul(e){let t=O(e);if(!t)return`issues`;if([`issues`,`pages`].includes(t))return t;throw Error(`CSV table must be one of: issues, pages.`)}async function dl(e){let t=N(e.urls)??[],n=O(e[`urls-file`]);return n&&t.push(...fl(await di(n,`utf8`))),[...new Set(t)]}function fl(e){return e.split(/[\n,]/).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`))}async function pl(e,t){if(!e){process.stdout.write(t);return}await li(Qr(e),{recursive:!0}),await _i(e,t),process.stdout.write(`Wrote ${e}\n`)}async function ml(e,t){let n=k(e),r=O(e.site);if(!(!n&&!r))return(await H({client:n,site:r,options:{json:t}})).site}function hl(e){jo(e.map(e=>({title:e.id,description:e.site??e.url,meta:[e.status,`${e.totalPages} page${e.totalPages===1?``:`s`}`,`${e.issueCount} issue${e.issueCount===1?``:`s`}`,e.createdAt]})),{empty:`No saved crawl reports.`})}function gl(e){tl(e)}function _l(e){K({title:`Crawl report comparison`,target:e.after.url,status:e.comparability.status!==`comparable`||e.completeness.status!==`complete`?`unknown`:e.summary.newStatusErrors>0||e.summary.issueGroupsWorse>0?`warning`:`pass`,summary:e.headline,metrics:[{label:`Before`,value:`${e.before.id} (${e.before.generatedAt})`},{label:`After`,value:`${e.after.id} (${e.after.generatedAt})`},{label:`Comparability`,value:e.comparability.status},{label:`Completeness`,value:e.completeness.status},{label:`Pages`,value:`${e.after.summary.totalPages} (${e.summary.pageDelta>=0?`+`:``}${e.summary.pageDelta})`},{label:`Issues`,value:`${e.after.summary.highIssues+e.after.summary.mediumIssues+e.after.summary.lowIssues} (${e.summary.issueDelta>=0?`+`:``}${e.summary.issueDelta})`},{label:`New status errors`,value:e.summary.newStatusErrors},{label:`Fixed status errors`,value:e.summary.fixedStatusErrors},{label:`Issue groups worse`,value:e.summary.issueGroupsWorse},{label:`Issue groups better`,value:e.summary.issueGroupsBetter},{label:`Changed pages`,value:e.summary.changedPages},{label:`Added pages`,value:e.summary.addedPages},{label:`Removed pages`,value:e.summary.removedPages}]}),J(`Top actions`,e.topActions.map(e=>({label:e.title,context:e.plainEnglish,action:e.action})),e.topActions.length),e.pageChanges.length&&(process.stdout.write(`
 Changed pages
 `),B([`Kind`,`Changes`,`URL`],e.pageChanges.slice(0,15).map(e=>[e.kind,e.changes.join(`, `),G(e.url,80)])),e.pageChanges.length>15&&process.stdout.write(`Showing 15 of ${e.pageChanges.length}. Use --json for all changes.\n`)),e.issueChanges.length&&(process.stdout.write(`
 Issue movement
-`),B([`Rule`,`Before`,`After`,`Delta`],e.issueChanges.slice(0,10).map(e=>[e.ruleId,String(e.before),String(e.after),`${e.delta>=0?`+`:``}${e.delta}`]))),Y(`Caveats`,e.caveats)}function gl(e,t){if(t.value===`latest`)return e.find(e=>e.id!==t.skipId);if(t.skipId){let n=e.findIndex(e=>e.id===t.skipId);return(n>=0?e.slice(n+1):e).find(e=>e.id!==t.skipId)}return e[1]}function _l(e){if(e.value!==`latest`&&e.value!==`previous`)return a(e.value);let t=gl(wn({site:e.site,limit:20}),{value:e.value,skipId:e.skipId});return t?a(t.id):void 0}const vl=T({meta:{name:`crawl-reports`,description:`List, show, or delete saved crawl reports`},args:{site:{type:`string`,description:`GSC property URL for filtering reports.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},id:{type:`string`,description:`Saved crawl report id to show.`},latest:{type:`boolean`,default:!1,description:`Show the latest saved crawl report.`},delete:{type:`string`,description:`Delete a saved crawl report by id.`},rerun:{type:`string`,description:`Rerun a saved crawl report by id, or pass latest.`},compare:{type:`string`,description:`Compare a saved report id, latest, or previous.`},against:{type:`string`,description:`Baseline report id. Defaults to previous.`},limit:{type:`string`,description:`Maximum reports to list. Defaults to 20.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await fl(e,t),r=O(e.delete),i=O(e.rerun),o=O(e.compare),s=O(e.id);if(r){let e=_(r);if(t){R({id:r,deleted:e});return}process.stdout.write(e?`Deleted crawl report ${r}.\n`:`No saved crawl report found for ${r}.\n`);return}if(i){let e=i===`latest`?Re(n):a(i);if(!e)throw Error(i===`latest`?`No saved crawl reports found.`:`No saved crawl report found for ${i}.`);let r=await it({...e.config,projectId:e.projectId,site:e.site,googleAnalyticsPropertyId:e.googleAnalyticsPropertyId}),o=bn(r);if(t){R({...r,rerunOf:e.id,saved:o,topFixes:yr(r),reviewObservations:Mt(r)});return}process.stdout.write(`Reran crawl report ${e.id}.\n\n`),ml(r);return}if(o){let r=_l({value:o,site:n});if(!r)throw Error(`No saved crawl report found for ${o}.`);let i=O(e.against)??`previous`,a=_l({value:i,site:r.site??n,skipId:r.id});if(!a)throw Error(`No baseline crawl report found for ${i}. Save at least two reports or pass --against <id>.`);let s=hr({before:a,after:r});if(t){R(s);return}hl(s);return}if(s||A(e.latest)){let e=s?a(s):Re(n);if(!e)throw Error(s?`No saved crawl report found for ${s}.`:`No saved crawl reports found.`);if(t){R(e);return}ml(e);return}let c=wn({site:n,limit:j(e.limit)});if(t){R({reports:c});return}pl(c)}}),yl=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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.`},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 Ha(e.body,e[`body-file`])??{startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),dimensions:N(e.dimensions)??[`query`,`page`],type:O(e.type)??`web`,rowLimit:j(e.limit),dataState:`final`},n=F(e),r=await bs({client:k(e),site:O(e.site)??O(t.siteUrl)},{json:n,refresh:A(e.refresh),account:O(e.account)});delete t.siteUrl;let i=await wr(r,t,{refresh:A(e.refresh),accountEmail:O(e.account)}),a=j(e.limit),o=a?i.rows.slice(0,a):i.rows;if(n){R({site:r,request:t,...i,rows:o,rowsReturned:o.length});return}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}]}),B([`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)]))}}),bl=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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=F(e),n=await bs({client:k(e),site:O(e.site)},{json:t,account:O(e.account)}),r=O(e.url);if(!r)throw Error(`Pass --url.`);let i=await at({siteUrl:n,inspectionUrl:r,accountEmail:O(e.account),languageCode:O(e.language)});if(t){R(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`}]})}}),xl={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=xl[e];return[n.cli,{...n.arg,...t[e]}]}))}function Sl(e){return e.toLocaleString(`en-GB`,{maximumFractionDigits:e>=100?0:1})}function Cl(e){if(e===null)return`n/a`;let t=Math.abs(e)>=10?e.toFixed(0):e.toFixed(1);return`${e>0?`+`:``}${t}%`}const wl=T({meta:{name:`traffic-anomaly`,description:`Detect unusual recent GSC traffic movement`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=await vt({site:await bs({client:k(e),site:O(e.site)},{json:t,refresh:A(e.refresh)}),days:j(e.days),recentDays:j(e.recent),refresh:A(e.refresh)});if(t){R(n);return}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,Sl(e.baselineMean),Sl(e.comparisonMean),Cl(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])}}),Tl=T({meta:{name:`update-correlate`,description:`Compare traffic movement with official Google update windows`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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.`},"ignore-change-log":{type:`boolean`,default:!1,description:`Do not use saved change-log entries as confounders.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=k(e),r=await bs({client:n,site:O(e.site)},{json:t,refresh:A(e.refresh)}),i=await ce({site:r,days:j(e.days),recentDays:j(e.recent),paddingDays:j(e[`padding-days`]),knownConfounders:O(e[`known-change`])?[O(e[`known-change`])??``]:void 0,includeChangeLog:!A(e[`ignore-change-log`]),refresh:A(e.refresh)});if(t){R(i);return}K({title:`Google update correlation`,target:i.site,status:`unknown`,summary:i.summary,metrics:[{label:`Classification`,value:i.classification.replaceAll(`-`,` `)},{label:`Attribution`,value:i.attribution.replaceAll(`-`,` `)},{label:`Confidence`,value:i.confidence},{label:`Updates matched`,value:i.overlappingUpdates.length},{label:`Known confounders`,value:i.confounders.length},{label:`Source`,value:i.source.name}]}),Y(`Evidence`,i.evidence),Y(`Report caveats`,i.caveats),Y(`Recommended next checks`,i.actions),q([`Metric`,`Direction`,`Baseline/day`,`Recent/day`,`Change`,`z`],i.anomalies.map(e=>[e.metric,e.direction,Sl(e.baselineMean),Sl(e.comparisonMean),Cl(e.percentChange),e.zScore??`n/a`])),i.overlappingUpdates.length&&(process.stdout.write(`
+`),B([`Rule`,`Before`,`After`,`Delta`],e.issueChanges.slice(0,10).map(e=>[e.ruleId,String(e.before),String(e.after),`${e.delta>=0?`+`:``}${e.delta}`]))),Y(`Caveats`,e.caveats)}function vl(e,t){if(t.value===`latest`)return e.find(e=>e.id!==t.skipId);if(t.skipId){let n=e.findIndex(e=>e.id===t.skipId);return(n>=0?e.slice(n+1):e).find(e=>e.id!==t.skipId)}return e[1]}function yl(e){if(e.value!==`latest`&&e.value!==`previous`)return a(e.value);let t=vl(wn({site:e.site,limit:20}),{value:e.value,skipId:e.skipId});return t?a(t.id):void 0}const bl=T({meta:{name:`crawl-reports`,description:`List, show, or delete saved crawl reports`},args:{site:{type:`string`,description:`GSC property URL for filtering reports.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},id:{type:`string`,description:`Saved crawl report id to show.`},latest:{type:`boolean`,default:!1,description:`Show the latest saved crawl report.`},delete:{type:`string`,description:`Delete a saved crawl report by id.`},rerun:{type:`string`,description:`Rerun a saved crawl report by id, or pass latest.`},compare:{type:`string`,description:`Compare a saved report id, latest, or previous.`},against:{type:`string`,description:`Baseline report id. Defaults to previous.`},limit:{type:`string`,description:`Maximum reports to list. Defaults to 20.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await ml(e,t),r=O(e.delete),i=O(e.rerun),o=O(e.compare),s=O(e.id);if(r){let e=_(r);if(t){R({id:r,deleted:e});return}process.stdout.write(e?`Deleted crawl report ${r}.\n`:`No saved crawl report found for ${r}.\n`);return}if(i){let e=i===`latest`?Re(n):a(i);if(!e)throw Error(i===`latest`?`No saved crawl reports found.`:`No saved crawl report found for ${i}.`);let r=await it({...e.config,projectId:e.projectId,site:e.site,googleAnalyticsPropertyId:e.googleAnalyticsPropertyId}),o=bn(r);if(t){R({...r,rerunOf:e.id,saved:o,topFixes:yr(r),reviewObservations:Mt(r)});return}process.stdout.write(`Reran crawl report ${e.id}.\n\n`),gl(r);return}if(o){let r=yl({value:o,site:n});if(!r)throw Error(`No saved crawl report found for ${o}.`);let i=O(e.against)??`previous`,a=yl({value:i,site:r.site??n,skipId:r.id});if(!a)throw Error(`No baseline crawl report found for ${i}. Save at least two reports or pass --against <id>.`);let s=hr({before:a,after:r});if(t){R(s);return}_l(s);return}if(s||A(e.latest)){let e=s?a(s):Re(n);if(!e)throw Error(s?`No saved crawl report found for ${s}.`:`No saved crawl reports found.`);if(t){R(e);return}gl(e);return}let c=wn({site:n,limit:j(e.limit)});if(t){R({reports:c});return}hl(c)}}),xl=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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.`},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 Ha(e.body,e[`body-file`])??{startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),dimensions:N(e.dimensions)??[`query`,`page`],type:O(e.type)??`web`,rowLimit:j(e.limit),dataState:`final`},n=F(e),r=await Ss({client:k(e),site:O(e.site)??O(t.siteUrl)},{json:n,refresh:A(e.refresh),account:O(e.account)});delete t.siteUrl;let i=await wr(r,t,{refresh:A(e.refresh),accountEmail:O(e.account)}),a=j(e.limit),o=a?i.rows.slice(0,a):i.rows;if(n){R({site:r,request:t,...i,rows:o,rowsReturned:o.length});return}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}]}),B([`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)]))}}),Sl=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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=F(e),n=await Ss({client:k(e),site:O(e.site)},{json:t,account:O(e.account)}),r=O(e.url);if(!r)throw Error(`Pass --url.`);let i=await at({siteUrl:n,inspectionUrl:r,accountEmail:O(e.account),languageCode:O(e.language)});if(t){R(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`}]})}}),Cl={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=Cl[e];return[n.cli,{...n.arg,...t[e]}]}))}function wl(e){return e.toLocaleString(`en-GB`,{maximumFractionDigits:e>=100?0:1})}function Tl(e){if(e===null)return`n/a`;let t=Math.abs(e)>=10?e.toFixed(0):e.toFixed(1);return`${e>0?`+`:``}${t}%`}const El=T({meta:{name:`traffic-anomaly`,description:`Detect unusual recent GSC traffic movement`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=await vt({site:await Ss({client:k(e),site:O(e.site)},{json:t,refresh:A(e.refresh)}),days:j(e.days),recentDays:j(e.recent),refresh:A(e.refresh)});if(t){R(n);return}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,wl(e.baselineMean),wl(e.comparisonMean),Tl(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])}}),Dl=T({meta:{name:`update-correlate`,description:`Compare traffic movement with official Google update windows`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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.`},"ignore-change-log":{type:`boolean`,default:!1,description:`Do not use saved change-log entries as confounders.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=k(e),r=await Ss({client:n,site:O(e.site)},{json:t,refresh:A(e.refresh)}),i=await ce({site:r,days:j(e.days),recentDays:j(e.recent),paddingDays:j(e[`padding-days`]),knownConfounders:O(e[`known-change`])?[O(e[`known-change`])??``]:void 0,includeChangeLog:!A(e[`ignore-change-log`]),refresh:A(e.refresh)});if(t){R(i);return}K({title:`Google update correlation`,target:i.site,status:`unknown`,summary:i.summary,metrics:[{label:`Classification`,value:i.classification.replaceAll(`-`,` `)},{label:`Attribution`,value:i.attribution.replaceAll(`-`,` `)},{label:`Confidence`,value:i.confidence},{label:`Updates matched`,value:i.overlappingUpdates.length},{label:`Known confounders`,value:i.confounders.length},{label:`Source`,value:i.source.name}]}),Y(`Evidence`,i.evidence),Y(`Report caveats`,i.caveats),Y(`Recommended next checks`,i.actions),q([`Metric`,`Direction`,`Baseline/day`,`Recent/day`,`Change`,`z`],i.anomalies.map(e=>[e.metric,e.direction,wl(e.baselineMean),wl(e.comparisonMean),Tl(e.percentChange),e.zScore??`n/a`])),i.overlappingUpdates.length&&(process.stdout.write(`
 Updates
-`),B([`Start`,`End`,`Type`,`Name`],i.overlappingUpdates.map(e=>[e.start.slice(0,10),e.end?.slice(0,10)??`open`,e.type,e.name]))),ls(`seo segment-impact ${n?`--project ${JSON.stringify(n)}`:`--site ${JSON.stringify(r)}`} --dimension page`)}});function El(e){ko({title:`Entity evidence`,target:e.url,status:e.dataStatus===`partial`?`unknown`:`info`,summary:e.headline,metrics:[{label:`Pages`,value:`${e.evaluatedPages}/${e.crawlPages}`},{label:`sameAs`,value:e.entities.sameAs.length},{label:`Social`,value:e.entities.socialProfiles.length},{label:`Authors`,value:e.entities.authors.length}],sections:[{title:`Observed entity signals`,diagnostics:e.checks.map(e=>({status:e.status,title:e.title,explanation:e.plainEnglish,fix:e.action,evidence:(e.urls??[]).slice(0,5)}))}],notes:[`Data: ${e.dataStatus}. Report: ${e.reportId}.`,...e.caveats]})}const Dl=T({meta:{name:`entity-readiness`,description:`Check schema, sameAs, social, author, and naming signals from a saved crawl`},args:{"report-id":{type:`string`,description:`Saved crawl report id to analyze.`},site:{type:`string`,description:`GSC property URL for selecting the latest saved crawl.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=me(await Vo(e,{json:t}));if(t){R(n);return}El(n)}});function Ol(){return new Date().toISOString().slice(0,10)}function kl(e){let t=O(e)??`page`;if(t!==`site`&&t!==`page`&&t!==`query`&&t!==`group`)throw Error(`Invalid --scope. Use site, page, query, or group.`);return t}const Al=T({meta:{name:`change-log`,description:`Annotate SEO changes and measure before/after impact`},subCommands:{list:T({meta:{name:`list`,description:`List recorded SEO changes`},args:{site:{type:`string`},limit:{type:`string`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=Qn({site:O(e.site),limit:j(e.limit)});if(F(e)){R({changes:t});return}B([`ID`,`Date`,`Site`,`Scope`,`Target`,`Title`],t.map(e=>[e.id,e.changedAt,e.site,e.scope,e.target,e.title]))}}),add:T({meta:{name:`add`,description:`Record an SEO change`},args:{site:{type:`string`},scope:{type:`string`,default:`page`},target:{type:`string`,required:!0},title:{type:`string`,required:!0},description:{type:`string`},date:{type:`string`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=be({site:await zo({site:O(e.site),options:{json:t}}),scope:kl(e.scope),target:O(e.target)??``,title:O(e.title)??``,description:O(e.description),changedAt:O(e.date)??Ol()});if(t){R(n);return}z([[`ID`,n.id],[`Date`,n.changedAt],[`Site`,n.site],[`Scope`,n.scope],[`Target`,n.target],[`Title`,n.title]])}}),delete:T({meta:{name:`delete`,description:`Delete a recorded SEO change`},args:{id:{type:`string`,required:!0},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e.id)??``,n=we(t);if(F(e)){R({id:t,deleted:n});return}process.stdout.write(`${n?`Deleted`:`Not found`} ${t}.\n`)}}),measure:T({meta:{name:`measure`,description:`Measure a change with equal finalized before/after windows`},args:{id:{type:`string`},site:{type:`string`},scope:{type:`string`},target:{type:`string`},title:{type:`string`},date:{type:`string`},before:{type:`string`},after:{type:`string`},json:{type:`boolean`,default:!1},refresh:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=O(e.id);if(!n&&(!O(e.site)||!O(e.scope)||!O(e.target)||!O(e.date)))throw Error(`Pass --id, or pass --site, --scope, --target, and --date for an ad hoc measurement.`);let r=await Lr({id:n,site:n?void 0:await zo({site:O(e.site),options:{json:t}}),scope:n?void 0:kl(e.scope),target:n?void 0:O(e.target),title:O(e.title),changedAt:n?void 0:O(e.date),beforeDays:M(e.before,`--before`),afterDays:M(e.after,`--after`),refresh:A(e.refresh)});if(t){R(r);return}K({title:`Change measurement`,target:r.change.title,status:r.dataStatus===`complete`?`info`:`unknown`,summary:r.note,metrics:[{label:`Verdict`,value:r.verdict},{label:`Confidence`,value:r.confidence},{label:`Before`,value:`${r.before.startDate} to ${r.before.endDate}`},{label:`After`,value:`${r.after.startDate} to ${r.after.endDate}`},{label:`Window`,value:`${r.window.effectiveDays}/${r.window.requestedDays} finalized days`}]}),B([`Metric`,`Before`,`After`,`Delta`],[[`Clicks`,r.before.metrics?.clicks??`unavailable`,r.after.metrics?.clicks??`unavailable`,r.delta.clicks===null?`unavailable`:r.delta.clickPct===null?`${r.delta.clicks}`:`${r.delta.clicks} (${r.delta.clickPct}%)`],[`Impressions`,r.before.metrics?.impressions??`unavailable`,r.after.metrics?.impressions??`unavailable`,r.delta.impressions===null?`unavailable`:r.delta.impressionPct===null?`${r.delta.impressions}`:`${r.delta.impressions} (${r.delta.impressionPct}%)`],[`CTR`,r.before.metrics?.ctr??`unavailable`,r.after.metrics?.ctr??`unavailable`,r.delta.ctr??`unavailable`],[`Position`,r.before.metrics?.position??`unavailable`,r.after.metrics?.position??`unavailable`,r.delta.position??`unavailable`]]),Y(`Warnings`,r.warnings),Y(`Caveats`,r.caveats)}})}});function jl(e){let t=O(e)??`page`;if(t!==`page`&&t!==`query`)throw Error(`Invalid --dimension. Use page or query.`);return t}function Ml(e){let t=O(e)??`contains`;if(t!==`equals`&&t!==`contains`&&t!==`regex`)throw Error(`Invalid --match. Use equals, contains, or regex.`);return t}const Nl=T({meta:{name:`content-groups`,description:`Create and manage reusable page/query groups`},subCommands:{list:T({meta:{name:`list`,description:`List saved content groups`},args:{site:{type:`string`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=fe(O(e.site));if(F(e)){R({groups:t});return}B([`ID`,`Site`,`Name`,`Dimension`,`Match`,`Pattern`],t.map(e=>[e.id,e.site,e.name,e.dimension,e.matchType,e.pattern]))}}),add:T({meta:{name:`add`,description:`Create a reusable page or query group`},args:{site:{type:`string`},name:{type:`string`,required:!0},dimension:{type:`string`,default:`page`},match:{type:`string`,default:`contains`},pattern:{type:`string`,required:!0},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=d({site:await zo({site:O(e.site),options:{json:t}}),name:O(e.name)??``,dimension:jl(e.dimension),matchType:Ml(e.match),pattern:O(e.pattern)??``});if(t){R(n);return}z([[`ID`,n.id],[`Site`,n.site],[`Name`,n.name],[`Filter`,`${n.dimension} ${n.matchType} ${n.pattern}`]])}}),delete:T({meta:{name:`delete`,description:`Delete a content group`},args:{id:{type:`string`,required:!0},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e.id)??``,n=mt(t);if(F(e)){R({id:t,deleted:n});return}process.stdout.write(`${n?`Deleted`:`Not found`} ${t}.\n`)}})}});function Pl(){return new Date().toISOString().slice(0,10)}function Fl(e){let t=O(e)??`page`;if(t!==`site`&&t!==`page`&&t!==`query`&&t!==`group`)throw Error(`Invalid --scope. Use site, page, query, or group.`);return t}function Il(e){return e?Fl(e):void 0}function Ll(e){return e===null?`n/a`:`${e.toFixed(1)}%`}function Rl(e){return e==null?`unavailable`:W(e)}function zl(e,t){return e===null?`unavailable`:`${W(e)} (${Ll(t)})`}function Bl(e,t=1){return e==null?`unavailable`:e.toFixed(t)}function Vl(e){K({title:`SEO test report`,target:e.change.title,status:e.dataStatus===`complete`?`info`:`unknown`,summary:e.note,metrics:[{label:`Verdict`,value:e.verdict},{label:`Confidence`,value:e.confidence},{label:`Before`,value:`${e.before.startDate} to ${e.before.endDate}`},{label:`After`,value:`${e.after.startDate} to ${e.after.endDate}`},{label:`Window`,value:`${e.window.effectiveDays}/${e.window.requestedDays} finalized days`}]}),B([`Metric`,`Before`,`After`,`Delta`],[[`GSC clicks`,Rl(e.before.metrics?.clicks),Rl(e.after.metrics?.clicks),zl(e.delta.clicks,e.delta.clickPct)],[`GSC impressions`,Rl(e.before.metrics?.impressions),Rl(e.after.metrics?.impressions),zl(e.delta.impressions,e.delta.impressionPct)],[`GSC CTR`,e.before.metrics?`${(e.before.metrics.ctr*100).toFixed(1)}%`:`unavailable`,e.after.metrics?`${(e.after.metrics.ctr*100).toFixed(1)}%`:`unavailable`,e.delta.ctr===null?`unavailable`:`${(e.delta.ctr*100).toFixed(1)} pts`],[`GSC position`,Bl(e.before.metrics?.position),Bl(e.after.metrics?.position),Bl(e.delta.position)]]),e.analytics&&(process.stdout.write(`
+`),B([`Start`,`End`,`Type`,`Name`],i.overlappingUpdates.map(e=>[e.start.slice(0,10),e.end?.slice(0,10)??`open`,e.type,e.name]))),ls(`seo segment-impact ${n?`--project ${JSON.stringify(n)}`:`--site ${JSON.stringify(r)}`} --dimension page`)}});function Ol(e){ko({title:`Entity evidence`,target:e.url,status:e.dataStatus===`partial`?`unknown`:`info`,summary:e.headline,metrics:[{label:`Pages`,value:`${e.evaluatedPages}/${e.crawlPages}`},{label:`sameAs`,value:e.entities.sameAs.length},{label:`Social`,value:e.entities.socialProfiles.length},{label:`Authors`,value:e.entities.authors.length}],sections:[{title:`Observed entity signals`,diagnostics:e.checks.map(e=>({status:e.status,title:e.title,explanation:e.plainEnglish,fix:e.action,evidence:(e.urls??[]).slice(0,5)}))}],notes:[`Data: ${e.dataStatus}. Report: ${e.reportId}.`,...e.caveats]})}const kl=T({meta:{name:`entity-readiness`,description:`Check schema, sameAs, social, author, and naming signals from a saved crawl`},args:{"report-id":{type:`string`,description:`Saved crawl report id to analyze.`},site:{type:`string`,description:`GSC property URL for selecting the latest saved crawl.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=me(await Vo(e,{json:t}));if(t){R(n);return}Ol(n)}});function Al(){return new Date().toISOString().slice(0,10)}function jl(e){let t=O(e)??`page`;if(t!==`site`&&t!==`page`&&t!==`query`&&t!==`group`)throw Error(`Invalid --scope. Use site, page, query, or group.`);return t}const Ml=T({meta:{name:`change-log`,description:`Annotate SEO changes and measure before/after impact`},subCommands:{list:T({meta:{name:`list`,description:`List recorded SEO changes`},args:{site:{type:`string`},limit:{type:`string`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=Qn({site:O(e.site),limit:j(e.limit)});if(F(e)){R({changes:t});return}B([`ID`,`Date`,`Site`,`Scope`,`Target`,`Title`],t.map(e=>[e.id,e.changedAt,e.site,e.scope,e.target,e.title]))}}),add:T({meta:{name:`add`,description:`Record an SEO change`},args:{site:{type:`string`},scope:{type:`string`,default:`page`},target:{type:`string`,required:!0},title:{type:`string`,required:!0},description:{type:`string`},date:{type:`string`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=be({site:await zo({site:O(e.site),options:{json:t}}),scope:jl(e.scope),target:O(e.target)??``,title:O(e.title)??``,description:O(e.description),changedAt:O(e.date)??Al()});if(t){R(n);return}z([[`ID`,n.id],[`Date`,n.changedAt],[`Site`,n.site],[`Scope`,n.scope],[`Target`,n.target],[`Title`,n.title]])}}),delete:T({meta:{name:`delete`,description:`Delete a recorded SEO change`},args:{id:{type:`string`,required:!0},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e.id)??``,n=we(t);if(F(e)){R({id:t,deleted:n});return}process.stdout.write(`${n?`Deleted`:`Not found`} ${t}.\n`)}}),measure:T({meta:{name:`measure`,description:`Measure a change with equal finalized before/after windows`},args:{id:{type:`string`},site:{type:`string`},scope:{type:`string`},target:{type:`string`},title:{type:`string`},date:{type:`string`},before:{type:`string`},after:{type:`string`},json:{type:`boolean`,default:!1},refresh:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=O(e.id);if(!n&&(!O(e.site)||!O(e.scope)||!O(e.target)||!O(e.date)))throw Error(`Pass --id, or pass --site, --scope, --target, and --date for an ad hoc measurement.`);let r=await Lr({id:n,site:n?void 0:await zo({site:O(e.site),options:{json:t}}),scope:n?void 0:jl(e.scope),target:n?void 0:O(e.target),title:O(e.title),changedAt:n?void 0:O(e.date),beforeDays:M(e.before,`--before`),afterDays:M(e.after,`--after`),refresh:A(e.refresh)});if(t){R(r);return}K({title:`Change measurement`,target:r.change.title,status:r.dataStatus===`complete`?`info`:`unknown`,summary:r.note,metrics:[{label:`Verdict`,value:r.verdict},{label:`Confidence`,value:r.confidence},{label:`Before`,value:`${r.before.startDate} to ${r.before.endDate}`},{label:`After`,value:`${r.after.startDate} to ${r.after.endDate}`},{label:`Window`,value:`${r.window.effectiveDays}/${r.window.requestedDays} finalized days`}]}),B([`Metric`,`Before`,`After`,`Delta`],[[`Clicks`,r.before.metrics?.clicks??`unavailable`,r.after.metrics?.clicks??`unavailable`,r.delta.clicks===null?`unavailable`:r.delta.clickPct===null?`${r.delta.clicks}`:`${r.delta.clicks} (${r.delta.clickPct}%)`],[`Impressions`,r.before.metrics?.impressions??`unavailable`,r.after.metrics?.impressions??`unavailable`,r.delta.impressions===null?`unavailable`:r.delta.impressionPct===null?`${r.delta.impressions}`:`${r.delta.impressions} (${r.delta.impressionPct}%)`],[`CTR`,r.before.metrics?.ctr??`unavailable`,r.after.metrics?.ctr??`unavailable`,r.delta.ctr??`unavailable`],[`Position`,r.before.metrics?.position??`unavailable`,r.after.metrics?.position??`unavailable`,r.delta.position??`unavailable`]]),Y(`Warnings`,r.warnings),Y(`Caveats`,r.caveats)}})}});function Nl(e){let t=O(e)??`page`;if(t!==`page`&&t!==`query`)throw Error(`Invalid --dimension. Use page or query.`);return t}function Pl(e){let t=O(e)??`contains`;if(t!==`equals`&&t!==`contains`&&t!==`regex`)throw Error(`Invalid --match. Use equals, contains, or regex.`);return t}const Fl=T({meta:{name:`content-groups`,description:`Create and manage reusable page/query groups`},subCommands:{list:T({meta:{name:`list`,description:`List saved content groups`},args:{site:{type:`string`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=fe(O(e.site));if(F(e)){R({groups:t});return}B([`ID`,`Site`,`Name`,`Dimension`,`Match`,`Pattern`],t.map(e=>[e.id,e.site,e.name,e.dimension,e.matchType,e.pattern]))}}),add:T({meta:{name:`add`,description:`Create a reusable page or query group`},args:{site:{type:`string`},name:{type:`string`,required:!0},dimension:{type:`string`,default:`page`},match:{type:`string`,default:`contains`},pattern:{type:`string`,required:!0},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=d({site:await zo({site:O(e.site),options:{json:t}}),name:O(e.name)??``,dimension:Nl(e.dimension),matchType:Pl(e.match),pattern:O(e.pattern)??``});if(t){R(n);return}z([[`ID`,n.id],[`Site`,n.site],[`Name`,n.name],[`Filter`,`${n.dimension} ${n.matchType} ${n.pattern}`]])}}),delete:T({meta:{name:`delete`,description:`Delete a content group`},args:{id:{type:`string`,required:!0},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e.id)??``,n=mt(t);if(F(e)){R({id:t,deleted:n});return}process.stdout.write(`${n?`Deleted`:`Not found`} ${t}.\n`)}})}});function Il(){return new Date().toISOString().slice(0,10)}function Ll(e){let t=O(e)??`page`;if(t!==`site`&&t!==`page`&&t!==`query`&&t!==`group`)throw Error(`Invalid --scope. Use site, page, query, or group.`);return t}function Rl(e){return e?Ll(e):void 0}function zl(e){return e===null?`n/a`:`${e.toFixed(1)}%`}function Bl(e){return e==null?`unavailable`:W(e)}function Vl(e,t){return e===null?`unavailable`:`${W(e)} (${zl(t)})`}function Hl(e,t=1){return e==null?`unavailable`:e.toFixed(t)}function Ul(e){K({title:`SEO test report`,target:e.change.title,status:e.dataStatus===`complete`?`info`:`unknown`,summary:e.note,metrics:[{label:`Verdict`,value:e.verdict},{label:`Confidence`,value:e.confidence},{label:`Before`,value:`${e.before.startDate} to ${e.before.endDate}`},{label:`After`,value:`${e.after.startDate} to ${e.after.endDate}`},{label:`Window`,value:`${e.window.effectiveDays}/${e.window.requestedDays} finalized days`}]}),B([`Metric`,`Before`,`After`,`Delta`],[[`GSC clicks`,Bl(e.before.metrics?.clicks),Bl(e.after.metrics?.clicks),Vl(e.delta.clicks,e.delta.clickPct)],[`GSC impressions`,Bl(e.before.metrics?.impressions),Bl(e.after.metrics?.impressions),Vl(e.delta.impressions,e.delta.impressionPct)],[`GSC CTR`,e.before.metrics?`${(e.before.metrics.ctr*100).toFixed(1)}%`:`unavailable`,e.after.metrics?`${(e.after.metrics.ctr*100).toFixed(1)}%`:`unavailable`,e.delta.ctr===null?`unavailable`:`${(e.delta.ctr*100).toFixed(1)} pts`],[`GSC position`,Hl(e.before.metrics?.position),Hl(e.after.metrics?.position),Hl(e.delta.position)]]),e.analytics&&(process.stdout.write(`
 Google Analytics impact
-`),B([`Metric`,`Before`,`After`,`Delta`],[[`Sessions`,W(e.analytics.before.metrics.sessions),W(e.analytics.after.metrics.sessions),`${W(e.analytics.delta.sessions)} (${Ll(e.analytics.delta.sessionPct)})`],[`Conversions`,W(e.analytics.before.metrics.conversions),W(e.analytics.after.metrics.conversions),`${W(e.analytics.delta.conversions)} (${Ll(e.analytics.delta.conversionPct)})`],[`Revenue`,e.analytics.before.metrics.totalRevenue.toFixed(2),e.analytics.after.metrics.totalRevenue.toFixed(2),`${e.analytics.delta.totalRevenue.toFixed(2)} (${Ll(e.analytics.delta.revenuePct)})`]])),e.control&&(process.stdout.write(`
+`),B([`Metric`,`Before`,`After`,`Delta`],[[`Sessions`,W(e.analytics.before.metrics.sessions),W(e.analytics.after.metrics.sessions),`${W(e.analytics.delta.sessions)} (${zl(e.analytics.delta.sessionPct)})`],[`Conversions`,W(e.analytics.before.metrics.conversions),W(e.analytics.after.metrics.conversions),`${W(e.analytics.delta.conversions)} (${zl(e.analytics.delta.conversionPct)})`],[`Revenue`,e.analytics.before.metrics.totalRevenue.toFixed(2),e.analytics.after.metrics.totalRevenue.toFixed(2),`${e.analytics.delta.totalRevenue.toFixed(2)} (${zl(e.analytics.delta.revenuePct)})`]])),e.control&&(process.stdout.write(`
 Control comparison
-`),z([[`Control`,e.control.change.title],[`Adjusted clicks`,e.control.adjusted.clickDelta===null?`n/a`:W(e.control.adjusted.clickDelta)],[`Adjusted click %`,e.control.adjusted.clickPctPoints===null?`n/a`:`${e.control.adjusted.clickPctPoints.toFixed(1)} pts`],[`Note`,e.control.note]])),Y(`Warnings`,e.warnings),Y(`Caveats`,e.caveats)}const Hl=T({meta:{name:`tests`,description:`Create and report local SEO tests from Search Console and Google Analytics data`},subCommands:{list:T({meta:{name:`list`,description:`List saved SEO tests`},args:{site:{type:`string`,description:`GSC property URL.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},limit:{type:`string`,description:`Maximum tests to list. Defaults to 20.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=k(e),r=Qn({site:(n||O(e.site)?await H({client:n,site:O(e.site),options:{json:t}}):void 0)?.site,limit:j(e.limit)});if(t){R({tests:r});return}B([`ID`,`Date`,`Scope`,`Target`,`Title`],r.map(e=>[e.id,e.changedAt,e.scope,e.target,e.title]))}}),create:T({meta:{name:`create`,description:`Create a local SEO test`},args:{site:{type:`string`,description:`GSC property URL.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},scope:{type:`string`,default:`page`,description:`Change scope: site, page, query, or group.`},target:{type:`string`,required:!0,description:`Changed URL, query, group pattern, or site marker.`},title:{type:`string`,required:!0,description:`Plain-English name for the test.`},description:{type:`string`,description:`Optional note about what changed.`},date:{type:`string`,description:`Change date in YYYY-MM-DD. Defaults to today.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t}}),r=be({site:n.site,scope:Fl(e.scope),target:O(e.target)??``,title:O(e.title)??``,description:O(e.description),changedAt:O(e.date)??Pl()});if(t){R(r);return}z([[`ID`,r.id],[`Date`,r.changedAt],[`Project`,n.client?.name??n.site],[`Scope`,r.scope],[`Target`,r.target],[`Title`,r.title]])}}),report:T({meta:{name:`report`,description:`Report an SEO test with equal finalized before/after windows`},args:{id:{type:`string`,description:`Saved SEO test id.`},site:{type:`string`,description:`GSC property URL.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},scope:{type:`string`,description:`Ad-hoc change scope: site, page, query, or group.`},target:{type:`string`,description:`Ad-hoc changed URL, query, group pattern, or site marker.`},title:{type:`string`,description:`Ad-hoc test title.`},date:{type:`string`,description:`Ad-hoc change date in YYYY-MM-DD.`},property:{type:`string`,description:`Google Analytics property ID.`},"control-scope":{type:`string`,description:`Control scope: site, page, query, or group.`},"control-target":{type:`string`,description:`Control URL, query, group pattern, or site marker.`},"control-title":{type:`string`,description:`Plain-English name for the control group.`},before:{type:`string`,description:`Days before the change date. Defaults to 28.`},after:{type:`string`,description:`Days after the change date. Defaults to 28.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local Search Console and Google Analytics cache.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=O(e.id),r=!n||k(e)||O(e.site)?await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}):void 0,i=await Lr({id:n,site:n?void 0:r?.site,scope:n?void 0:Il(e.scope),target:n?void 0:O(e.target),title:O(e.title),changedAt:n?void 0:O(e.date),googleAnalyticsPropertyId:O(e.property)??r?.client?.analytics.google?.propertyId,controlScope:Il(e[`control-scope`]),controlTarget:O(e[`control-target`]),controlTitle:O(e[`control-title`]),beforeDays:M(e.before,`--before`),afterDays:M(e.after,`--after`),refresh:A(e.refresh)});if(t){R(i);return}Vl(i)}})}});function Ul(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 Wl={site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`}},Gl={...X([`includeBrand`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}};function Kl(e){return{includeBrand:A(e[`include-brand`]),verifyContent:A(e[`verify-content`]),verifyLimit:j(e[`verify-limit`])??3,js:A(e.js)?!0:void 0,rate:Ba(e),refresh:A(e.refresh)}}function ql(e){return{client:k(e),site:O(e.site),refresh:A(e.refresh)}}const{json:Jl,...Yl}=Gl,Xl=Yl,Zl={client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name. Defaults to the configured default.`},site:{type:`string`,description:`GSC property URL/id when not using a saved project.`}};function Ql(e){return{type:`string`,description:`Output folder. Defaults to ./seo-export/<project>-${e}-YYYY-MM-DD.`}}function $l(e){return e.toLowerCase().replace(/^sc-domain:/,``).replace(/^https?:\/\//,``).replace(/[^a-z0-9._-]+/g,`-`).replace(/^-+|-+$/g,``)}function eu(e){let t=new Date().toISOString().slice(0,10),n=$l(e.clientId??e.site);return ri(process.cwd(),`seo-export`,`${n}-${e.report}-${t}`)}async function tu(e,t){await li(e,{recursive:!0});let n=[];for(let r of t){let t=ri(e,r.filename);await _i(t,p(r.rows,r.headers),`utf8`),n.push(t)}return n}function nu(e,t){process.stdout.write(`Wrote ${On(t.length,`CSV file`)} to ${e}\n`);for(let e of t)process.stdout.write(`- ${e}\n`)}const ru=T({meta:{name:`diagnose`,description:`Export diagnosis tables: priorities, anomalies, movement, decay, cannibalisation, striking-distance, and quick wins.`},args:{...Zl,out:Ql(`diagnose`),days:{type:`string`,description:`GSC lookback window. Defaults to 90.`},recent:{type:`string`,description:`Recent anomaly window in days.`},limit:{type:`string`,description:`Maximum rows per movement/opportunity table.`},"include-brand":{type:`boolean`,default:!1,description:`Include branded queries in opportunity reports.`},"verify-content":{type:`boolean`,default:!1,description:`Verify top opportunities against page title, meta, and content.`},"verify-limit":{type:`string`,description:`Maximum opportunity URLs to verify.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for verified pages.`},"fetch-concurrency":{type:`string`,description:`Maximum concurrent page fetches per host. Defaults to 4.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host. Defaults to 4.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds. Defaults to 1000.`},refresh:{type:`boolean`,default:!1,description:`Bypass local cache and fetch fresh data.`}},run:async({args:e})=>{let t=await H({client:k(e),site:O(e.site)}),n=await ut({site:t.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:t.client?.brandTerms,includeBrand:A(e[`include-brand`]),verifyContent:A(e[`verify-content`]),verifyLimit:j(e[`verify-limit`]),js:A(e.js)?!0:`auto`,rate:Ba(e),refresh:A(e.refresh),progress:Ul(!0)}),r=O(e.out)??eu({report:`diagnose`,clientId:t.client?.id,site:t.site});nu(r,await tu(r,jr(n)))}}),iu=`.seo-okf.json`,au=`${JSON.stringify({generator:`seo`,format:`okf`,version:1})}\n`;function ou(e,t){let n=ri(e,t),r=ni(ri(e),n);if(!r||r.startsWith(`..`)||ei(r))throw new C(`INVALID_INPUT`,`Unsafe OKF file path: ${t}`);return n}async function su(e,t){for(let n of t){let t=ou(e,n.path);await li(Qr(t),{recursive:!0}),await _i(t,n.content)}await _i(w(e,iu),au)}async function cu(e){let t=[],n=0;async function r(e,i=``){let a=await fi(e,{withFileTypes:!0});for(let o of a){let a=i?`${i}/${o.name}`:o.name,s=w(e,o.name);if(o.isDirectory())await r(s,a);else if(o.isFile()&&o.name.endsWith(`.md`)){if(t.length>=5006)throw new C(`INVALID_INPUT`,`OKF validation accepts at most ${gn} Markdown files.`);let e=await ci(s);if(e.size>2e6)throw new C(`INVALID_INPUT`,`OKF file exceeds ${Lt} bytes: ${a}`);if(n+=e.size,n>67108864)throw new C(`INVALID_INPUT`,`OKF Markdown files exceed ${Hn} bytes in total.`);t.push({path:a,content:await di(s,`utf8`)})}}}return await r(e),t.sort((e,t)=>e.path<t.path?-1:+(e.path>t.path))}async function lu(e){try{let t=await ci(e);if(t.isSymbolicLink()||!t.isDirectory())throw new C(`INVALID_INPUT`,`OKF output must be a real directory: ${e}`);if(!(await fi(e)).length)return!0;try{if(await di(w(e,iu),`utf8`)===au)return!0}catch{}throw new C(`INVALID_INPUT`,`Refusing to replace non-empty unmanaged directory: ${e}`)}catch(e){if(e.code===`ENOENT`)return!1;throw e}}async function uu(e,t){if(!Wt(t,{profile:`seo-export`}).valid)throw new C(`INVALID_INPUT`,`Generated bundle did not pass the SEO export profile and was not written.`);let n=ri(e),r=Qr(n);await li(r,{recursive:!0});let i=await lu(n),a=await ui(w(r,`.${Zr(n)}-staging-`)),o=w(r,`.${Zr(n)}-backup-${zr()}`),s=!1;try{await su(a,t);let e=Wt(await cu(a),{profile:`seo-export`});if(!e.valid)throw new C(`INTERNAL_ERROR`,`Staged OKF files failed validation after writing.`);return i&&(await pi(n,o),s=!0),await pi(a,n),s&&await mi(o,{recursive:!0,force:!0}),e}catch(e){throw await mi(a,{recursive:!0,force:!0}),s&&(await mi(n,{recursive:!0,force:!0}),await pi(o,n)),e}}async function du(e,t){if(!e){process.stdout.write(t);return}await li(Qr(e),{recursive:!0}),await _i(e,t),process.stdout.write(`Wrote ${e}\n`)}function fu(e){let t=O(e)??`okf`;if([`okf`,`markdown`,`json`].includes(t))return t;throw Error(`Format must be one of: okf, markdown, json.`)}function pu(e){return{reportId:e.id,url:e.config.url,generatedAt:e.generatedAt,crawl:{summary:e.summary,caveats:e.caveats,warnings:e.warnings,pages:e.pages.map(e=>({url:e.finalUrl,title:e.title,metaDescription:e.metaDescription,status:e.status,indexable:e.indexable,wordCount:e.wordCount,schemaTypes:e.schemaTypes,sameAs:e.schemaSameAs,internalInlinks:e.internalInlinkCount,contentSample:e.contentSample}))},aiReadiness:re(e),entityReadiness:me(e),llmsTxt:Ae(e)}}function mu(e){let t=pu(e);return`${[`# Site Knowledge Export`,``,`Source: ${e.config.url}`,`Crawl report: ${e.id}`,`Generated: ${t.generatedAt}`,``,`## Summary`,``,`- Documents: ${e.summary.totalPages}${e.requestEvidenceStatus===`available`?` from ${e.requests.length} URL requests`:e.requestEvidenceStatus===`partial`?` from ${e.requests.length} observed URL requests (request evidence is partial)`:` (request evidence unavailable for this legacy report)`}`,`- Indexable pages: ${e.summary.indexablePages}`,`- Crawl findings: ${e.issues.length} (${e.summary.highIssues} high, ${e.summary.mediumIssues} medium, ${e.summary.lowIssues} low)`,`- AI-search evidence: ${t.aiReadiness.dataStatus} (${t.aiReadiness.assessment})`,`- Entity evidence: ${t.entityReadiness.dataStatus} (${t.entityReadiness.assessment})`,``,`## Top AI Readiness Actions`,``,...t.aiReadiness.topActions.length?t.aiReadiness.topActions.map(e=>`- ${e.title}: ${e.action}`):[`- No AI-search technical actions in this crawl.`],``,`## Entity Signals`,``,`- sameAs profiles: ${t.entityReadiness.entities.sameAs.length}`,`- Social profiles: ${t.entityReadiness.entities.socialProfiles.length}`,`- Authors: ${t.entityReadiness.entities.authors.length}`,``,`## Important Pages`,``,...e.pages.filter(e=>e.indexable&&e.status<400).slice(0,100).map(e=>`- [${e.title??e.finalUrl}](${e.finalUrl}) - ${e.metaDescription??e.contentSample??`No summary available.`}`),``,`# Citations`,``,`- [Crawl start URL](${e.config.url})`,``].join(`
-`)}\n`}const hu=T({meta:{name:`knowledge`,description:`Export site knowledge from a saved crawl as OKF, Markdown, or JSON`},args:{"report-id":{type:`string`,description:`Saved crawl report id to export.`},site:{type:`string`,description:`GSC property URL for selecting the latest saved crawl.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},format:{type:`string`,description:`Output format: okf, markdown, or json. Defaults to okf.`},output:{type:`string`,description:`Output directory for OKF, or output file for Markdown/JSON.`},"max-concepts":{type:`string`,description:`Maximum OKF page concepts. Defaults to 500.`},json:{type:`boolean`,default:!1,description:`Print command metadata as JSON.`}},run:async({args:e})=>{let t=F(e),n=fu(e.format),r=n===`okf`?er(M(e[`max-concepts`],`--max-concepts`)):void 0,i=await Vo(e,{json:t}),a=O(e.output);if(n===`okf`){let e=Ln(i,{maxConcepts:r}),o=a??`./okf`,s=await uu(o,e.files);if(t){R({format:n,output:o,bundle:e,validation:s});return}process.stdout.write(`Wrote OKF bundle to ${o}\n\n`),z([[`Files`,String(e.files.length)],[`Concepts`,String(e.conceptCount)],[`Page concepts`,String(e.pageConceptCount)],[`Valid`,s.valid?`yes`:`no`]]);return}if(n===`json`){await du(a,`${JSON.stringify(pu(i),null,2)}\n`);return}await du(a,mu(i))}}),gu=T({meta:{name:`monthly`,description:`Export monthly report tables plus the underlying diagnosis detail CSVs.`},args:{...Zl,out:Ql(`monthly`),month:{type:`string`,description:`Report month as YYYY-MM. Defaults to the latest month with final GSC data.`},...X([`limit`],{limit:{description:`Maximum rows per diagnostic section. Defaults to 10.`}}),...Xl},run:async({args:e})=>{let t=await H({client:k(e),site:O(e.site),options:{refresh:A(e.refresh)}}),n=await Ut({site:t.site,month:O(e.month),limit:j(e.limit),brandTerms:t.client?.brandTerms,...Kl(e),progress:Ul(!0)}),r=O(e.out)??eu({report:`monthly`,clientId:t.client?.id,site:t.site});nu(r,await tu(r,Vt(n)))}}),_u=T({meta:{name:`narrative`,description:`Export report narrative tables plus the underlying diagnosis detail CSVs.`},args:{...Zl,out:Ql(`narrative`),...X([`days`,`recentDays`],{days:{description:`Diagnosis window length in days. Defaults to 90.`}}),"start-date":{type:`string`,description:`Optional report start date as YYYY-MM-DD.`},"end-date":{type:`string`,description:`Optional report end date as YYYY-MM-DD.`},...X([`limit`],{limit:{description:`Maximum rows per diagnostic section. Defaults to 10.`}}),"change-limit":{type:`string`,description:`Maximum saved changes to measure. Defaults to 5.`},...Xl},run:async({args:e})=>{let t=await H({client:k(e),site:O(e.site),options:{refresh:A(e.refresh)}}),n=await kr({site:t.site,days:j(e.days),recentDays:j(e.recent),startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),limit:j(e.limit),changeLimit:j(e[`change-limit`]),brandTerms:t.client?.brandTerms,...Kl(e),progress:Ul(!0)}),r=O(e.out)??eu({report:`narrative`,clientId:t.client?.id,site:t.site});nu(r,await tu(r,Vt(n)))}});function vu(e){return y({days:M(e.days,`--days`),sitemaps:N(e.sitemap),maxSitemapUrls:M(e[`max-sitemap-urls`],`--max-sitemap-urls`),templateLimit:M(e.limit,`--limit`),minimumTemplateUrls:M(e[`minimum-template-urls`],`--minimum-template-urls`),minimumTemplateShare:M(e[`minimum-template-share`],`--minimum-template-share`),minimumTemplateImpressions:M(e[`minimum-template-impressions`],`--minimum-template-impressions`),crawlSamples:M(e[`crawl-samples`],`--crawl-samples`),inspectSamples:M(e[`inspect-samples`],`--inspect-samples`),brandTerms:N(e[`brand-terms`]),includeBrand:A(e[`include-brand`]),js:A(e.js)?!0:`auto`,refresh:A(e.refresh),rate:Va(e)})}const yu=T({meta:{name:`pseo`,description:`Export pSEO audit tables: templates, demand patterns, top queries, sample coverage, crawl samples, and inspection samples.`},args:{...Zl,out:Ql(`pseo`),days:{type:`string`,description:`GSC lookback window. Defaults to 28.`},limit:{type:`string`,description:`Maximum pSEO templates to export.`},sitemap:{type:`string`,description:`Comma-separated sitemap URLs. Can be passed once.`},"crawl-samples":{type:`string`,description:`Number of representative URLs to fetch per template. Defaults to 0.`},"inspect-samples":{type:`string`,description:`Number of representative URLs to inspect in GSC per template. Defaults to 0.`},"max-sitemap-urls":{type:`string`,description:`Maximum discovered URLs per sitemap. Defaults to 50000.`},"minimum-template-urls":{type:`string`,description:`Minimum repeated URLs required for a template. Defaults to 3.`},"minimum-template-share":{type:`string`,description:`Minimum share of discovered URLs from 0 to 1. Defaults to 0.`},"minimum-template-impressions":{type:`string`,description:`Minimum retained page impressions for a template. Defaults to 0.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude from query evidence.`},"include-brand":{type:`boolean`,default:!1,description:`Include branded queries in pSEO demand analysis.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for crawled samples.`},"fetch-concurrency":{type:`string`,description:`Maximum concurrent page fetches per host. Defaults to 4.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host. Defaults to 4.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds. Defaults to 1000.`},refresh:{type:`boolean`,default:!1,description:`Bypass local cache and fetch fresh data.`}},run:async({args:e})=>{let t=vu(e),n=await H({client:k(e),site:O(e.site)}),r=await Be({site:n.site,...t,brandTerms:t.brandTerms??n.client?.brandTerms,progress:Ul(!0)}),i=O(e.out)??eu({report:`pseo`,clientId:n.client?.id,site:n.site});nu(i,await tu(i,Dr(r)))}}),bu=T({meta:{name:`refresh-priorities`,description:`Export the ranked SEO priority queue, score breakdowns, grouped findings, and diagnosis detail CSVs.`},args:{...Zl,out:Ql(`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.`}}),...el,"verify-content":Fa(`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=await H({client:k(e),site:O(e.site),options:{refresh:A(e.refresh)}}),n=await an({site:t.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:t.client?.brandTerms,includeBrand:A(e[`include-brand`]),googleAnalyticsPropertyId:O(e[`google-analytics-property`])??t.client?.analytics.google?.propertyId,analyticsConnection:tl(e,Yn(t.client)),verifyContent:A(e[`verify-content`]),verifyLimit:j(e[`verify-limit`]),refresh:A(e.refresh)}),r=O(e.out)??eu({report:`refresh-priorities`,clientId:t.client?.id,site:t.site});nu(r,await tu(r,et(n)))}}),xu=T({meta:{name:`export`,description:`Export full report data to CSV files`},subCommands:{diagnose:ru,knowledge:hu,narrative:_u,monthly:gu,"update-postmortem":T({meta:{name:`update-postmortem`,description:`Export update postmortem attribution, findings, template movement, and segment movers.`},args:{...Zl,out:Ql(`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.`},"ignore-change-log":{type:`boolean`,default:!1,description:`Do not use saved change-log entries as confounders.`}},run:async({args:e})=>{let t=await H({client:k(e),site:O(e.site),options:{refresh:A(e.refresh)}}),n=await _r({site:t.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:t.client?.brandTerms,includeBrand:A(e[`include-brand`]),knownConfounders:O(e[`known-change`])?[O(e[`known-change`])??``]:void 0,includeChangeLog:!A(e[`ignore-change-log`]),refresh:A(e.refresh)}),r=O(e.out)??eu({report:`update-postmortem`,clientId:t.client?.id,site:t.site});nu(r,await tu(r,ta(n)))}}),"refresh-priorities":bu,pseo:yu}}),Su={project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},site:{type:`string`,description:`Site URL.`}};async function Cu(e){let t=O(e.site);if(t)return t;let n=await U({project:k(e),options:{json:F(e)}});if(!n)throw new C(`INVALID_INPUT`,`Pass --site or select a saved project.`);return n.siteUrl}async function wu(e){let t=O(e.url),n=N(e.urls)??[],r=O(e.file);if(!t&&n.length===0&&!r)throw new C(`INVALID_INPUT`,`Pass --url, comma-separated --urls, or a newline-delimited --file.`);let i=[...t?[t]:[],...n];if(r){let e=await hi(r).catch(()=>void 0);if(!e)throw new C(`INVALID_INPUT`,`IndexNow URL file not found: ${r}`);if(!e.isFile()||e.size>21e5)throw new C(`INVALID_INPUT`,`IndexNow URL files must be regular files no larger than 2.1 MB.`);i.push(...(await di(r,`utf8`)).split(/\r?\n/).map(e=>e.trim()).filter(Boolean))}return i}const Tu=T({meta:{name:`indexnow`,description:`Set up and submit changed URLs with IndexNow`},subCommands:{setup:T({meta:{name:`setup`,description:`Generate an IndexNow key file for one site`},args:{...Su,output:{type:`string`,description:`Public asset directory for the generated key file.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.output);if(!t)throw new C(`INVALID_INPUT`,`Pass --output with the public asset directory that deploys at the site root.`);let n=dt({site:await Cu(e)}),r=ri(t),i=w(r,`${n.key}.txt`);await li(r,{recursive:!0});try{await _i(i,`${n.key}\n`,{encoding:`utf8`,flag:`wx`,mode:384})}catch(e){throw e.code===`EEXIST`?new C(`INVALID_INPUT`,`Refusing to overwrite the existing file at ${i}.`):e}let a;try{a=await ae(n)}catch(e){throw await gi(i).catch(()=>void 0),e}let o={configured:!0,host:n.host,keyLocation:n.keyLocation,keyFile:i,credentialSource:a,nextStep:`Deploy ${i}, then run seo indexnow verify --site ${new URL(n.keyLocation).origin}`};F(e)?R(o):z([[`Host`,o.host],[`Key file`,o.keyFile],[`Public URL`,o.keyLocation],[`Saved in`,o.credentialSource],[`Next`,o.nextStep]])}}),status:T({meta:{name:`status`,description:`Show saved IndexNow hosts`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await le(),n={configuredSites:t.length,sites:t};F(e)?R(n):B([`Host`,`Key location`,`Created`],t.map(e=>[e.host,e.keyLocation,e.createdAt]))}}),verify:T({meta:{name:`verify`,description:`Check the public IndexNow key file`},args:{...Su,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await ht({site:await Cu(e)}),n={...await c({record:t.record}),credentialSource:t.source};F(e)?R(n):z([[`Verified`,n.verified?`yes`:`no`],[`HTTP status`,String(n.status)],[`Key location`,n.keyLocation],[`Credential`,n.credentialSource]]),n.verified||(process.exitCode=4)}}),submit:T({meta:{name:`submit`,description:`Notify IndexNow about changed URLs`},args:{...Su,url:{type:`string`,description:`One changed URL.`},urls:{type:`string`,description:`Comma-separated changed URLs.`},file:{type:`string`,description:`Newline-delimited changed URL file.`},"dry-run":{type:`boolean`,default:!1,description:`Validate without notifying IndexNow.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await ht({site:await Cu(e)}),n=await Pr({record:t.record,urls:await wu(e),dryRun:A(e[`dry-run`])}),r={...n,credentialSource:t.source};if(F(e)){R(r);return}z([[`Host`,n.host],[`Status`,n.status],[`URLs`,String(n.submittedUrls)],[`Dry run`,n.dryRun?`yes`:`no`],[`Key location`,n.keyLocation]]);for(let e of n.caveats)process.stdout.write(`\n${e}\n`)}}),remove:T({meta:{name:`remove`,description:`Remove a saved IndexNow key`},args:{...Su,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await st(await Cu(e)),n={removed:t,note:`The deployed key file was not removed.`};F(e)?R(n):process.stdout.write(`${t?`Saved key removed.`:`No saved key found.`} ${n.note}\n`)}})}}),Eu=T({...yc,meta:{name:`init`,description:"Legacy alias for `seo start`."}}),Du=T({meta:{name:`links`,description:`Review bounded referring-link evidence from Ahrefs, DataForSEO, Bing or a file`},args:{project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},site:{type:`string`,description:`Verified Bing Webmaster site URL.`},provider:{type:`string`,description:`Live link source: ahrefs, dataforseo or bing.`},target:{type:`string`,description:`Domain or absolute page URL for Ahrefs or DataForSEO.`},scope:{type:`string`,description:`Live provider target scope: domain or page.`},"include-subdomains":{type:`boolean`,default:!0,description:`Include subdomains for a live provider domain target.`},"search-site":{type:`string`,description:`Search Console property used to add target-page search evidence.`},file:{type:`string`,description:`Local CSV, JSON, JSONL, or NDJSON link export.`},format:{type:`string`,description:`Import format override: csv, json, or jsonl.`},"row-limit":{type:`string`,description:`Maximum source rows. Defaults: 100 live provider, 500 Bing, 10000 files.`},"target-limit":{type:`string`,description:`Maximum Bing target pages to inspect. Defaults to 20.`},"detail-pages":{type:`string`,description:`Maximum Bing result pages per target. Defaults to 1.`},limit:{type:`string`,description:`Maximum link rows returned. Defaults to 100.`},days:{type:`string`,description:`Search Console lookback window for linked target pages. Defaults to 90.`},refresh:{type:`boolean`,default:!1,description:`Bypass local provider and Search Console caches.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=O(e.file),r=O(e.format),i=O(e.provider);if(i&&![`ahrefs`,`dataforseo`,`bing`].includes(i))throw new C(`INVALID_INPUT`,`--provider must be ahrefs, dataforseo or bing.`);if(n&&i)throw new C(`INVALID_INPUT`,`Do not pass --provider with a local link file.`);let a=O(e.scope);if(a&&a!==`domain`&&a!==`page`)throw new C(`INVALID_INPUT`,`--scope must be domain or page.`);if(r&&![`csv`,`json`,`jsonl`].includes(r))throw new C(`INVALID_INPUT`,`--format must be csv, json, or jsonl.`);let o=M(e[`row-limit`],`--row-limit`),s=O(e.target),c=O(e.site);if(n&&(c||s))throw new C(`INVALID_INPUT`,`Pass one link source: --file, --site for Bing, or --target for Ahrefs or DataForSEO.`);if(c&&s)throw new C(`INVALID_INPUT`,`Pass --site for Bing or --target for a live research provider, not both.`);if(s&&i===`bing`)throw new C(`INVALID_INPUT`,`Use --site with Bing or --target with Ahrefs or DataForSEO.`);if(c&&[`ahrefs`,`dataforseo`].includes(i??``))throw new C(`INVALID_INPUT`,`Use --target with Ahrefs or DataForSEO, or --site with Bing.`);let l=k(e),u=l?await U({project:l,options:{json:t}}):void 0;!n&&!u&&!s&&(u=await U({options:{json:t}}));let d;if(n)d=await Ve({file:n,format:r,rowLimit:o});else if(i===`ahrefs`||i===`dataforseo`||s){let t=s??u?.startUrl??u?.siteUrl.replace(/^sc-domain:/u,``);if(!t)throw new C(`INVALID_INPUT`,`Pass --target or use a saved project with a crawl URL or Search Console property.`);let n={target:t,scope:a,includeSubdomains:A(e[`include-subdomains`]),rowLimit:o,refresh:A(e.refresh),context:{projectId:u?.id,reportId:`link-evidence`,reportRunId:zr()}};d=i===`ahrefs`?await Ye(n):await ne(n)}else{let t=c??_e(u);if(!t)throw new C(`INVALID_INPUT`,`Pass --site, connect Bing to a saved project, or import a link file with --file.`);d=await Te({site:t,rowLimit:o,targetLimit:M(e[`target-limit`],`--target-limit`),detailPagesPerTarget:M(e[`detail-pages`],`--detail-pages`)})}let f=O(e[`search-site`])??u?.siteUrl,p=u||f||d.externalProvider?await pe({evidence:d,searchConsoleSite:f,crawlSite:u?.siteUrl??f??d.externalProvider?.summary.data.target,days:M(e.days,`--days`),refresh:A(e.refresh)}):void 0,m=Ne({evidence:d,limit:M(e.limit,`--limit`),targetContext:p});if(t){R(m);return}let h=m.providerEvidence?[m.providerEvidence.summary.cost.actualMicros,m.providerEvidence.backlinks.cost.actualMicros]:[],g=h.every(e=>e!==null)?h.reduce((e,t)=>e+t,0):null,_=m.providerEvidence?[m.providerEvidence.summary.cost.native?.actualUnits,m.providerEvidence.backlinks.cost.native?.actualUnits]:[],v=_.every(e=>e!=null)?_.reduce((e,t)=>e+t,0):null,y=m.providerEvidence?[m.providerEvidence.summary.cache.status,m.providerEvidence.backlinks.cache.status].every(e=>e===`hit`):!1;K({title:`Inbound link evidence`,target:m.provenance.provider,status:m.dataStatus===`complete`?`info`:`unknown`,summary:`${W(m.summary.observedLinks)} retained links from ${W(m.summary.referringDomains)} referring domains.`,metrics:[{label:`Evidence`,value:m.dataStatus},{label:`Observed links`,value:W(m.summary.observedLinks)},{label:`Referring domains`,value:W(m.summary.referringDomains)},{label:`Target pages`,value:W(m.summary.targetPages)},{label:`Returned rows`,value:`${W(m.selection.returnedRows)} of ${W(m.selection.availableRows)}`},...m.providerSummary?.backlinks.state===`observed`?[{label:`Provider backlinks`,value:W(m.providerSummary.backlinks.value)}]:[],...m.providerSummary?.referringDomains.state===`observed`?[{label:`Provider domains`,value:W(m.providerSummary.referringDomains.value)}]:[],...m.providerEvidence?[{label:`Provider cost`,value:g===null?v===null?`Unknown`:`${W(v)} API units${y?` (cached)`:``}`:`$${(g/1e6).toFixed(4)}${y?` (cached)`:``}`}]:[],...m.providerSummary?.brokenBacklinks.state===`observed`&&m.providerSummary.brokenBacklinks.value>0?[{label:`Provider broken links`,value:W(m.providerSummary.brokenBacklinks.value)}]:[]]}),m.findings.length&&q([`Priority`,`Finding`,`Target`],m.findings.map(e=>[e.priority,e.code,G(e.targetUrl,72)])),m.links.length&&q([`Source`,`Target`,`Anchor`],m.links.map(e=>[G(e.sourceUrl,58),G(e.targetUrl,58),G(e.anchorText??``,36)])),Y(`Warnings`,m.warnings),Y(`Report caveats`,m.caveats)}});async function Ou(e,t){if(!e){process.stdout.write(t);return}await li(Qr(e),{recursive:!0}),await _i(e,t),process.stdout.write(`Wrote ${e}\n`)}const ku={url:{type:`string`,description:`Public site or subpath URL to crawl.`},"report-id":{type:`string`,description:`Saved crawl report id to use.`},site:{type:`string`,description:`GSC property URL for selecting the latest saved crawl.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},"max-pages":{type:`string`,description:`Maximum public HTML pages to crawl.`},"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.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}};async function Au(e,t){let n=O(e.url),r=O(e[`report-id`]);if(n&&r)throw Error(`Use either --url or --report-id, not both.`);if(!n)return Vo(e,{json:t.json});let i=k(e),a=O(e.site),o=i||a?await H({client:i,site:a,options:{json:t.json}}):void 0;return it({url:n,projectId:o?.client?.id,site:o?.site,maxPages:j(e[`max-pages`]),fetchRate:Ba(e),refresh:A(e.refresh),useSitemap:!0,checkExternal:!1})}const ju=T({meta:{name:`llms`,description:`Check or generate an optional llms.txt file`},subCommands:{audit:T({meta:{name:`audit`,description:`Check an optional llms.txt file body and links`},args:ku,run:async({args:e})=>{let t=F(e),n=await Pe(await Au(e,{json:t}));if(t){R(n);return}K({title:`llms.txt audit`,target:n.url,status:n.issues.length>0?`warning`:n.dataStatus===`complete`?`pass`:`info`,summary:n.headline,metrics:[{label:`SEO impact`,value:n.googleSearchImpact},{label:`Optional`,value:n.optional?`Yes`:`No`},{label:`Found`,value:n.exists?`Yes`:`No`},{label:`URL`,value:n.llmsTxtUrl},{label:`HTTP status`,value:n.status?String(n.status):`Unavailable`}],diagnostics:[{title:`Issues`,items:n.issues.map(e=>({status:e.severity===`high`?`fail`:`warning`,title:e.title,explanation:e.plainEnglish,fix:e.action}))}]}),Y(`Caveats`,n.caveats),Y(`Recommended pages`,n.recommendedPages.slice(0,10).map(e=>`${e.section}: ${e.url}`))}}),generate:T({meta:{name:`generate`,description:`Generate a valid llms.txt v2 draft from crawl data`},args:{...ku,output:{type:`string`,description:`Write llms.txt to this path instead of stdout.`},"max-urls":{type:`string`,description:`Maximum URLs to include. Defaults to 250.`},"token-budget":{type:`string`,description:`Approximate token budget. Defaults to 12000.`},exclude:{type:`string`,description:`Comma-separated URL patterns to exclude.`},title:{type:`string`,description:`Override the llms.txt title.`},description:{type:`string`,description:`Override the llms.txt description.`}},run:async({args:e})=>{let t=F(e),n=He(await Au(e,{json:t}),{maxUrls:j(e[`max-urls`]),tokenBudget:j(e[`token-budget`]),maxBytes:t?65536:void 0,exclude:N(e.exclude),title:O(e.title),description:O(e.description)});if(t){R(n);return}await Ou(O(e.output),n.content),O(e.output)&&z([[`URLs`,String(n.includedUrls)],[`Estimated tokens`,String(n.estimatedTokens)],[`Truncated`,n.limits.truncated?n.limits.reasons.join(`, `):`No`]])}})}}),Mu=T({meta:{name:`logs`,description:`Manage local log retention`},subCommands:{prune:T({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=ke();if(F(e)){R(t);return}e.quiet||process.stdout.write(`Rotated ${t.rotated} and removed ${t.removed} log files. ${Fo(t.sizeBytes)} retained.\n`)}})}}),Nu=[{client:`claude-desktop`,flag:`claude-desktop`},{client:`claude-code`,flag:`claude-code`},{client:`codex`,flag:`codex`},{client:`cursor`,flag:`cursor`}];function Pu(e,t){return A(e.all)?t:Nu.filter(({flag:t})=>A(e[t])).map(({client:e})=>e)}const Fu=T({meta:{name:`mcp`,description:`MCP server helpers`},subCommands:{serve:T({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-4dMgVWqm.js`);await t({test:A(e.test)})}}),install:T({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(A(e.uninstall)&&A(e.reinstall))throw new C(`INVALID_INPUT`,`Use either --uninstall or --reinstall, not both.`);let t=Ms(),n=Fs({targets:t}),r=F(e),i=Pu(e,n.map(e=>e.client));if(i.length===0){if(!L({json:r}))throw new C(`INVALID_INPUT`,`Choose an MCP client with --claude-desktop, --claude-code, --codex, --cursor, or --all.`);let a=n.length>0?n:t;i=V(await Ai({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 C(`INVALID_INPUT`,`MCP setup is not supported for ${a.join(`, `)} on ${process.platform}.`);let o=t.filter(e=>i.includes(e.client)).map(t=>A(e.uninstall)?ec(t):$s(t,{reinstall:A(e.reinstall)}));if(r){R({operation:A(e.uninstall)?`uninstall`:`install`,results:o});return}for(let e of o)process.stdout.write(`${e.changed?`updated`:`skipped`} ${e.client} · ${e.path}\n`)}})}}),Iu=T({meta:{name:`crawl-diff`,description:`Crawl a site and diff technical/page changes vs last run`},args:{url:{type:`string`,required:!0,description:`Start URL to crawl.`},site:{type:`string`,description:`Optional GSC property to associate with the crawl.`},limit:{type:`string`,description:`Maximum pages to crawl. Defaults to 50.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering when Playwright is installed.`}},run:async({args:e})=>{let t=await Oe({startUrl:O(e.url)??``,site:O(e.site),limit:j(e.limit),refresh:A(e.refresh),js:A(e.js)?!0:`auto`});if(F(e)){R(t);return}if(K({title:`Crawl history comparison`,target:t.run.startUrl,status:t.previousRun===void 0?`unknown`:t.summary.newErrors>0||t.summary.indexabilityFlips>0?`warning`:`pass`,summary:t.previousRun===void 0?`No previous crawl was available for comparison.`:`${t.summary.changed} changed, ${t.summary.added} added, and ${t.summary.removed} removed URLs.`,metrics:[{label:`Run`,value:t.run.id},{label:`Crawled`,value:t.summary.crawled},{label:`Previous run`,value:t.previousRun?.id??`None`},{label:`Added`,value:t.summary.added},{label:`Removed`,value:t.summary.removed},{label:`Changed`,value:t.summary.changed},{label:`New errors`,value:t.summary.newErrors},{label:`Indexability flips`,value:t.summary.indexabilityFlips},{label:`High priority`,value:t.summary.highPriorityRecommendations}]}),t.recommendations.length&&(process.stdout.write(`
+`),z([[`Control`,e.control.change.title],[`Adjusted clicks`,e.control.adjusted.clickDelta===null?`n/a`:W(e.control.adjusted.clickDelta)],[`Adjusted click %`,e.control.adjusted.clickPctPoints===null?`n/a`:`${e.control.adjusted.clickPctPoints.toFixed(1)} pts`],[`Note`,e.control.note]])),Y(`Warnings`,e.warnings),Y(`Caveats`,e.caveats)}const Wl=T({meta:{name:`tests`,description:`Create and report local SEO tests from Search Console and Google Analytics data`},subCommands:{list:T({meta:{name:`list`,description:`List saved SEO tests`},args:{site:{type:`string`,description:`GSC property URL.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},limit:{type:`string`,description:`Maximum tests to list. Defaults to 20.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=k(e),r=Qn({site:(n||O(e.site)?await H({client:n,site:O(e.site),options:{json:t}}):void 0)?.site,limit:j(e.limit)});if(t){R({tests:r});return}B([`ID`,`Date`,`Scope`,`Target`,`Title`],r.map(e=>[e.id,e.changedAt,e.scope,e.target,e.title]))}}),create:T({meta:{name:`create`,description:`Create a local SEO test`},args:{site:{type:`string`,description:`GSC property URL.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},scope:{type:`string`,default:`page`,description:`Change scope: site, page, query, or group.`},target:{type:`string`,required:!0,description:`Changed URL, query, group pattern, or site marker.`},title:{type:`string`,required:!0,description:`Plain-English name for the test.`},description:{type:`string`,description:`Optional note about what changed.`},date:{type:`string`,description:`Change date in YYYY-MM-DD. Defaults to today.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t}}),r=be({site:n.site,scope:Ll(e.scope),target:O(e.target)??``,title:O(e.title)??``,description:O(e.description),changedAt:O(e.date)??Il()});if(t){R(r);return}z([[`ID`,r.id],[`Date`,r.changedAt],[`Project`,n.client?.name??n.site],[`Scope`,r.scope],[`Target`,r.target],[`Title`,r.title]])}}),report:T({meta:{name:`report`,description:`Report an SEO test with equal finalized before/after windows`},args:{id:{type:`string`,description:`Saved SEO test id.`},site:{type:`string`,description:`GSC property URL.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},scope:{type:`string`,description:`Ad-hoc change scope: site, page, query, or group.`},target:{type:`string`,description:`Ad-hoc changed URL, query, group pattern, or site marker.`},title:{type:`string`,description:`Ad-hoc test title.`},date:{type:`string`,description:`Ad-hoc change date in YYYY-MM-DD.`},property:{type:`string`,description:`Google Analytics property ID.`},"control-scope":{type:`string`,description:`Control scope: site, page, query, or group.`},"control-target":{type:`string`,description:`Control URL, query, group pattern, or site marker.`},"control-title":{type:`string`,description:`Plain-English name for the control group.`},before:{type:`string`,description:`Days before the change date. Defaults to 28.`},after:{type:`string`,description:`Days after the change date. Defaults to 28.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local Search Console and Google Analytics cache.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=O(e.id),r=!n||k(e)||O(e.site)?await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}):void 0,i=await Lr({id:n,site:n?void 0:r?.site,scope:n?void 0:Rl(e.scope),target:n?void 0:O(e.target),title:O(e.title),changedAt:n?void 0:O(e.date),googleAnalyticsPropertyId:O(e.property)??r?.client?.analytics.google?.propertyId,controlScope:Rl(e[`control-scope`]),controlTarget:O(e[`control-target`]),controlTitle:O(e[`control-title`]),beforeDays:M(e.before,`--before`),afterDays:M(e.after,`--after`),refresh:A(e.refresh)});if(t){R(i);return}Ul(i)}})}});function Gl(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 Kl={site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`}},ql={...X([`includeBrand`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}};function Jl(e){return{includeBrand:A(e[`include-brand`]),verifyContent:A(e[`verify-content`]),verifyLimit:j(e[`verify-limit`])??3,js:A(e.js)?!0:void 0,rate:Ba(e),refresh:A(e.refresh)}}function Yl(e){return{client:k(e),site:O(e.site),refresh:A(e.refresh)}}const{json:Xl,...Zl}=ql,Ql=Zl,$l={client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name. Defaults to the configured default.`},site:{type:`string`,description:`GSC property URL/id when not using a saved project.`}};function eu(e){return{type:`string`,description:`Output folder. Defaults to ./seo-export/<project>-${e}-YYYY-MM-DD.`}}function tu(e){return e.toLowerCase().replace(/^sc-domain:/,``).replace(/^https?:\/\//,``).replace(/[^a-z0-9._-]+/g,`-`).replace(/^-+|-+$/g,``)}function nu(e){let t=new Date().toISOString().slice(0,10),n=tu(e.clientId??e.site);return ri(process.cwd(),`seo-export`,`${n}-${e.report}-${t}`)}async function ru(e,t){await li(e,{recursive:!0});let n=[];for(let r of t){let t=ri(e,r.filename);await _i(t,p(r.rows,r.headers),`utf8`),n.push(t)}return n}function iu(e,t){process.stdout.write(`Wrote ${On(t.length,`CSV file`)} to ${e}\n`);for(let e of t)process.stdout.write(`- ${e}\n`)}const au=T({meta:{name:`diagnose`,description:`Export diagnosis tables: priorities, anomalies, movement, decay, cannibalisation, striking-distance, and quick wins.`},args:{...$l,out:eu(`diagnose`),days:{type:`string`,description:`GSC lookback window. Defaults to 90.`},recent:{type:`string`,description:`Recent anomaly window in days.`},limit:{type:`string`,description:`Maximum rows per movement/opportunity table.`},"include-brand":{type:`boolean`,default:!1,description:`Include branded queries in opportunity reports.`},"verify-content":{type:`boolean`,default:!1,description:`Verify top opportunities against page title, meta, and content.`},"verify-limit":{type:`string`,description:`Maximum opportunity URLs to verify.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for verified pages.`},"fetch-concurrency":{type:`string`,description:`Maximum concurrent page fetches per host. Defaults to 4.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host. Defaults to 4.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds. Defaults to 1000.`},refresh:{type:`boolean`,default:!1,description:`Bypass local cache and fetch fresh data.`}},run:async({args:e})=>{let t=await H({client:k(e),site:O(e.site)}),n=await ut({site:t.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:t.client?.brandTerms,includeBrand:A(e[`include-brand`]),verifyContent:A(e[`verify-content`]),verifyLimit:j(e[`verify-limit`]),js:A(e.js)?!0:`auto`,rate:Ba(e),refresh:A(e.refresh),progress:Gl(!0)}),r=O(e.out)??nu({report:`diagnose`,clientId:t.client?.id,site:t.site});iu(r,await ru(r,jr(n)))}}),ou=`.seo-okf.json`,su=`${JSON.stringify({generator:`seo`,format:`okf`,version:1})}\n`;function cu(e,t){let n=ri(e,t),r=ni(ri(e),n);if(!r||r.startsWith(`..`)||ei(r))throw new C(`INVALID_INPUT`,`Unsafe OKF file path: ${t}`);return n}async function lu(e,t){for(let n of t){let t=cu(e,n.path);await li(Qr(t),{recursive:!0}),await _i(t,n.content)}await _i(w(e,ou),su)}async function uu(e){let t=[],n=0;async function r(e,i=``){let a=await fi(e,{withFileTypes:!0});for(let o of a){let a=i?`${i}/${o.name}`:o.name,s=w(e,o.name);if(o.isDirectory())await r(s,a);else if(o.isFile()&&o.name.endsWith(`.md`)){if(t.length>=5006)throw new C(`INVALID_INPUT`,`OKF validation accepts at most ${gn} Markdown files.`);let e=await ci(s);if(e.size>2e6)throw new C(`INVALID_INPUT`,`OKF file exceeds ${Lt} bytes: ${a}`);if(n+=e.size,n>67108864)throw new C(`INVALID_INPUT`,`OKF Markdown files exceed ${Hn} bytes in total.`);t.push({path:a,content:await di(s,`utf8`)})}}}return await r(e),t.sort((e,t)=>e.path<t.path?-1:+(e.path>t.path))}async function du(e){try{let t=await ci(e);if(t.isSymbolicLink()||!t.isDirectory())throw new C(`INVALID_INPUT`,`OKF output must be a real directory: ${e}`);if(!(await fi(e)).length)return!0;try{if(await di(w(e,ou),`utf8`)===su)return!0}catch{}throw new C(`INVALID_INPUT`,`Refusing to replace non-empty unmanaged directory: ${e}`)}catch(e){if(e.code===`ENOENT`)return!1;throw e}}async function fu(e,t){if(!Wt(t,{profile:`seo-export`}).valid)throw new C(`INVALID_INPUT`,`Generated bundle did not pass the SEO export profile and was not written.`);let n=ri(e),r=Qr(n);await li(r,{recursive:!0});let i=await du(n),a=await ui(w(r,`.${Zr(n)}-staging-`)),o=w(r,`.${Zr(n)}-backup-${zr()}`),s=!1;try{await lu(a,t);let e=Wt(await uu(a),{profile:`seo-export`});if(!e.valid)throw new C(`INTERNAL_ERROR`,`Staged OKF files failed validation after writing.`);return i&&(await pi(n,o),s=!0),await pi(a,n),s&&await mi(o,{recursive:!0,force:!0}),e}catch(e){throw await mi(a,{recursive:!0,force:!0}),s&&(await mi(n,{recursive:!0,force:!0}),await pi(o,n)),e}}async function pu(e,t){if(!e){process.stdout.write(t);return}await li(Qr(e),{recursive:!0}),await _i(e,t),process.stdout.write(`Wrote ${e}\n`)}function mu(e){let t=O(e)??`okf`;if([`okf`,`markdown`,`json`].includes(t))return t;throw Error(`Format must be one of: okf, markdown, json.`)}function hu(e){return{reportId:e.id,url:e.config.url,generatedAt:e.generatedAt,crawl:{summary:e.summary,caveats:e.caveats,warnings:e.warnings,pages:e.pages.map(e=>({url:e.finalUrl,title:e.title,metaDescription:e.metaDescription,status:e.status,indexable:e.indexable,wordCount:e.wordCount,schemaTypes:e.schemaTypes,sameAs:e.schemaSameAs,internalInlinks:e.internalInlinkCount,contentSample:e.contentSample}))},aiReadiness:re(e),entityReadiness:me(e),llmsTxt:Ae(e)}}function gu(e){let t=hu(e);return`${[`# Site Knowledge Export`,``,`Source: ${e.config.url}`,`Crawl report: ${e.id}`,`Generated: ${t.generatedAt}`,``,`## Summary`,``,`- Documents: ${e.summary.totalPages}${e.requestEvidenceStatus===`available`?` from ${e.requests.length} URL requests`:e.requestEvidenceStatus===`partial`?` from ${e.requests.length} observed URL requests (request evidence is partial)`:` (request evidence unavailable for this legacy report)`}`,`- Indexable pages: ${e.summary.indexablePages}`,`- Crawl findings: ${e.issues.length} (${e.summary.highIssues} high, ${e.summary.mediumIssues} medium, ${e.summary.lowIssues} low)`,`- AI-search evidence: ${t.aiReadiness.dataStatus} (${t.aiReadiness.assessment})`,`- Entity evidence: ${t.entityReadiness.dataStatus} (${t.entityReadiness.assessment})`,``,`## Top AI Readiness Actions`,``,...t.aiReadiness.topActions.length?t.aiReadiness.topActions.map(e=>`- ${e.title}: ${e.action}`):[`- No AI-search technical actions in this crawl.`],``,`## Entity Signals`,``,`- sameAs profiles: ${t.entityReadiness.entities.sameAs.length}`,`- Social profiles: ${t.entityReadiness.entities.socialProfiles.length}`,`- Authors: ${t.entityReadiness.entities.authors.length}`,``,`## Important Pages`,``,...e.pages.filter(e=>e.indexable&&e.status<400).slice(0,100).map(e=>`- [${e.title??e.finalUrl}](${e.finalUrl}) - ${e.metaDescription??e.contentSample??`No summary available.`}`),``,`# Citations`,``,`- [Crawl start URL](${e.config.url})`,``].join(`
+`)}\n`}const _u=T({meta:{name:`knowledge`,description:`Export site knowledge from a saved crawl as OKF, Markdown, or JSON`},args:{"report-id":{type:`string`,description:`Saved crawl report id to export.`},site:{type:`string`,description:`GSC property URL for selecting the latest saved crawl.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},format:{type:`string`,description:`Output format: okf, markdown, or json. Defaults to okf.`},output:{type:`string`,description:`Output directory for OKF, or output file for Markdown/JSON.`},"max-concepts":{type:`string`,description:`Maximum OKF page concepts. Defaults to 500.`},json:{type:`boolean`,default:!1,description:`Print command metadata as JSON.`}},run:async({args:e})=>{let t=F(e),n=mu(e.format),r=n===`okf`?er(M(e[`max-concepts`],`--max-concepts`)):void 0,i=await Vo(e,{json:t}),a=O(e.output);if(n===`okf`){let e=Ln(i,{maxConcepts:r}),o=a??`./okf`,s=await fu(o,e.files);if(t){R({format:n,output:o,bundle:e,validation:s});return}process.stdout.write(`Wrote OKF bundle to ${o}\n\n`),z([[`Files`,String(e.files.length)],[`Concepts`,String(e.conceptCount)],[`Page concepts`,String(e.pageConceptCount)],[`Valid`,s.valid?`yes`:`no`]]);return}if(n===`json`){await pu(a,`${JSON.stringify(hu(i),null,2)}\n`);return}await pu(a,gu(i))}}),vu=T({meta:{name:`monthly`,description:`Export monthly report tables plus the underlying diagnosis detail CSVs.`},args:{...$l,out:eu(`monthly`),month:{type:`string`,description:`Report month as YYYY-MM. Defaults to the latest month with final GSC data.`},...X([`limit`],{limit:{description:`Maximum rows per diagnostic section. Defaults to 10.`}}),...Ql},run:async({args:e})=>{let t=await H({client:k(e),site:O(e.site),options:{refresh:A(e.refresh)}}),n=await Ut({site:t.site,month:O(e.month),limit:j(e.limit),brandTerms:t.client?.brandTerms,...Jl(e),progress:Gl(!0)}),r=O(e.out)??nu({report:`monthly`,clientId:t.client?.id,site:t.site});iu(r,await ru(r,Vt(n)))}}),yu=T({meta:{name:`narrative`,description:`Export report narrative tables plus the underlying diagnosis detail CSVs.`},args:{...$l,out:eu(`narrative`),...X([`days`,`recentDays`],{days:{description:`Diagnosis window length in days. Defaults to 90.`}}),"start-date":{type:`string`,description:`Optional report start date as YYYY-MM-DD.`},"end-date":{type:`string`,description:`Optional report end date as YYYY-MM-DD.`},...X([`limit`],{limit:{description:`Maximum rows per diagnostic section. Defaults to 10.`}}),"change-limit":{type:`string`,description:`Maximum saved changes to measure. Defaults to 5.`},...Ql},run:async({args:e})=>{let t=await H({client:k(e),site:O(e.site),options:{refresh:A(e.refresh)}}),n=await kr({site:t.site,days:j(e.days),recentDays:j(e.recent),startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),limit:j(e.limit),changeLimit:j(e[`change-limit`]),brandTerms:t.client?.brandTerms,...Jl(e),progress:Gl(!0)}),r=O(e.out)??nu({report:`narrative`,clientId:t.client?.id,site:t.site});iu(r,await ru(r,Vt(n)))}});function bu(e){return y({days:M(e.days,`--days`),sitemaps:N(e.sitemap),maxSitemapUrls:M(e[`max-sitemap-urls`],`--max-sitemap-urls`),templateLimit:M(e.limit,`--limit`),minimumTemplateUrls:M(e[`minimum-template-urls`],`--minimum-template-urls`),minimumTemplateShare:M(e[`minimum-template-share`],`--minimum-template-share`),minimumTemplateImpressions:M(e[`minimum-template-impressions`],`--minimum-template-impressions`),crawlSamples:M(e[`crawl-samples`],`--crawl-samples`),inspectSamples:M(e[`inspect-samples`],`--inspect-samples`),brandTerms:N(e[`brand-terms`]),includeBrand:A(e[`include-brand`]),js:A(e.js)?!0:`auto`,refresh:A(e.refresh),rate:Va(e)})}const xu=T({meta:{name:`pseo`,description:`Export pSEO audit tables: templates, demand patterns, top queries, sample coverage, crawl samples, and inspection samples.`},args:{...$l,out:eu(`pseo`),days:{type:`string`,description:`GSC lookback window. Defaults to 28.`},limit:{type:`string`,description:`Maximum pSEO templates to export.`},sitemap:{type:`string`,description:`Comma-separated sitemap URLs. Can be passed once.`},"crawl-samples":{type:`string`,description:`Number of representative URLs to fetch per template. Defaults to 0.`},"inspect-samples":{type:`string`,description:`Number of representative URLs to inspect in GSC per template. Defaults to 0.`},"max-sitemap-urls":{type:`string`,description:`Maximum discovered URLs per sitemap. Defaults to 50000.`},"minimum-template-urls":{type:`string`,description:`Minimum repeated URLs required for a template. Defaults to 3.`},"minimum-template-share":{type:`string`,description:`Minimum share of discovered URLs from 0 to 1. Defaults to 0.`},"minimum-template-impressions":{type:`string`,description:`Minimum retained page impressions for a template. Defaults to 0.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude from query evidence.`},"include-brand":{type:`boolean`,default:!1,description:`Include branded queries in pSEO demand analysis.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for crawled samples.`},"fetch-concurrency":{type:`string`,description:`Maximum concurrent page fetches per host. Defaults to 4.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host. Defaults to 4.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds. Defaults to 1000.`},refresh:{type:`boolean`,default:!1,description:`Bypass local cache and fetch fresh data.`}},run:async({args:e})=>{let t=bu(e),n=await H({client:k(e),site:O(e.site)}),r=await Be({site:n.site,...t,brandTerms:t.brandTerms??n.client?.brandTerms,progress:Gl(!0)}),i=O(e.out)??nu({report:`pseo`,clientId:n.client?.id,site:n.site});iu(i,await ru(i,Dr(r)))}}),Su=T({meta:{name:`refresh-priorities`,description:`Export the ranked SEO priority queue, score breakdowns, grouped findings, and diagnosis detail CSVs.`},args:{...$l,out:eu(`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.`}}),...nl,"verify-content":Fa(`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=await H({client:k(e),site:O(e.site),options:{refresh:A(e.refresh)}}),n=await an({site:t.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:t.client?.brandTerms,includeBrand:A(e[`include-brand`]),googleAnalyticsPropertyId:O(e[`google-analytics-property`])??t.client?.analytics.google?.propertyId,analyticsConnection:rl(e,Yn(t.client)),verifyContent:A(e[`verify-content`]),verifyLimit:j(e[`verify-limit`]),refresh:A(e.refresh)}),r=O(e.out)??nu({report:`refresh-priorities`,clientId:t.client?.id,site:t.site});iu(r,await ru(r,et(n)))}}),Cu=T({meta:{name:`export`,description:`Export full report data to CSV files`},subCommands:{diagnose:au,knowledge:_u,narrative:yu,monthly:vu,"update-postmortem":T({meta:{name:`update-postmortem`,description:`Export update postmortem attribution, findings, template movement, and segment movers.`},args:{...$l,out:eu(`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.`},"ignore-change-log":{type:`boolean`,default:!1,description:`Do not use saved change-log entries as confounders.`}},run:async({args:e})=>{let t=await H({client:k(e),site:O(e.site),options:{refresh:A(e.refresh)}}),n=await _r({site:t.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:t.client?.brandTerms,includeBrand:A(e[`include-brand`]),knownConfounders:O(e[`known-change`])?[O(e[`known-change`])??``]:void 0,includeChangeLog:!A(e[`ignore-change-log`]),refresh:A(e.refresh)}),r=O(e.out)??nu({report:`update-postmortem`,clientId:t.client?.id,site:t.site});iu(r,await ru(r,ta(n)))}}),"refresh-priorities":Su,pseo:xu}}),wu={project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},site:{type:`string`,description:`Site URL.`}};async function Tu(e){let t=O(e.site);if(t)return t;let n=await U({project:k(e),options:{json:F(e)}});if(!n)throw new C(`INVALID_INPUT`,`Pass --site or select a saved project.`);return n.siteUrl}async function Eu(e){let t=O(e.url),n=N(e.urls)??[],r=O(e.file);if(!t&&n.length===0&&!r)throw new C(`INVALID_INPUT`,`Pass --url, comma-separated --urls, or a newline-delimited --file.`);let i=[...t?[t]:[],...n];if(r){let e=await hi(r).catch(()=>void 0);if(!e)throw new C(`INVALID_INPUT`,`IndexNow URL file not found: ${r}`);if(!e.isFile()||e.size>21e5)throw new C(`INVALID_INPUT`,`IndexNow URL files must be regular files no larger than 2.1 MB.`);i.push(...(await di(r,`utf8`)).split(/\r?\n/).map(e=>e.trim()).filter(Boolean))}return i}const Du=T({meta:{name:`indexnow`,description:`Set up and submit changed URLs with IndexNow`},subCommands:{setup:T({meta:{name:`setup`,description:`Generate an IndexNow key file for one site`},args:{...wu,output:{type:`string`,description:`Public asset directory for the generated key file.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.output);if(!t)throw new C(`INVALID_INPUT`,`Pass --output with the public asset directory that deploys at the site root.`);let n=dt({site:await Tu(e)}),r=ri(t),i=w(r,`${n.key}.txt`);await li(r,{recursive:!0});try{await _i(i,`${n.key}\n`,{encoding:`utf8`,flag:`wx`,mode:384})}catch(e){throw e.code===`EEXIST`?new C(`INVALID_INPUT`,`Refusing to overwrite the existing file at ${i}.`):e}let a;try{a=await ae(n)}catch(e){throw await gi(i).catch(()=>void 0),e}let o={configured:!0,host:n.host,keyLocation:n.keyLocation,keyFile:i,credentialSource:a,nextStep:`Deploy ${i}, then run seo indexnow verify --site ${new URL(n.keyLocation).origin}`};F(e)?R(o):z([[`Host`,o.host],[`Key file`,o.keyFile],[`Public URL`,o.keyLocation],[`Saved in`,o.credentialSource],[`Next`,o.nextStep]])}}),status:T({meta:{name:`status`,description:`Show saved IndexNow hosts`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await le(),n={configuredSites:t.length,sites:t};F(e)?R(n):B([`Host`,`Key location`,`Created`],t.map(e=>[e.host,e.keyLocation,e.createdAt]))}}),verify:T({meta:{name:`verify`,description:`Check the public IndexNow key file`},args:{...wu,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await ht({site:await Tu(e)}),n={...await c({record:t.record}),credentialSource:t.source};F(e)?R(n):z([[`Verified`,n.verified?`yes`:`no`],[`HTTP status`,String(n.status)],[`Key location`,n.keyLocation],[`Credential`,n.credentialSource]]),n.verified||(process.exitCode=4)}}),submit:T({meta:{name:`submit`,description:`Notify IndexNow about changed URLs`},args:{...wu,url:{type:`string`,description:`One changed URL.`},urls:{type:`string`,description:`Comma-separated changed URLs.`},file:{type:`string`,description:`Newline-delimited changed URL file.`},"dry-run":{type:`boolean`,default:!1,description:`Validate without notifying IndexNow.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await ht({site:await Tu(e)}),n=await Pr({record:t.record,urls:await Eu(e),dryRun:A(e[`dry-run`])}),r={...n,credentialSource:t.source};if(F(e)){R(r);return}z([[`Host`,n.host],[`Status`,n.status],[`URLs`,String(n.submittedUrls)],[`Dry run`,n.dryRun?`yes`:`no`],[`Key location`,n.keyLocation]]);for(let e of n.caveats)process.stdout.write(`\n${e}\n`)}}),remove:T({meta:{name:`remove`,description:`Remove a saved IndexNow key`},args:{...wu,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await st(await Tu(e)),n={removed:t,note:`The deployed key file was not removed.`};F(e)?R(n):process.stdout.write(`${t?`Saved key removed.`:`No saved key found.`} ${n.note}\n`)}})}}),Ou=T({...xc,meta:{name:`init`,description:"Legacy alias for `seo start`."}}),ku=T({meta:{name:`links`,description:`Review bounded referring-link evidence from Ahrefs, DataForSEO, Bing or a file`},args:{project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},site:{type:`string`,description:`Verified Bing Webmaster site URL.`},provider:{type:`string`,description:`Live link source: ahrefs, dataforseo or bing.`},target:{type:`string`,description:`Domain or absolute page URL for Ahrefs or DataForSEO.`},scope:{type:`string`,description:`Live provider target scope: domain or page.`},"include-subdomains":{type:`boolean`,default:!0,description:`Include subdomains for a live provider domain target.`},"search-site":{type:`string`,description:`Search Console property used to add target-page search evidence.`},file:{type:`string`,description:`Local CSV, JSON, JSONL, or NDJSON link export.`},format:{type:`string`,description:`Import format override: csv, json, or jsonl.`},"row-limit":{type:`string`,description:`Maximum source rows. Defaults: 100 live provider, 500 Bing, 10000 files.`},"target-limit":{type:`string`,description:`Maximum Bing target pages to inspect. Defaults to 20.`},"detail-pages":{type:`string`,description:`Maximum Bing result pages per target. Defaults to 1.`},limit:{type:`string`,description:`Maximum link rows returned. Defaults to 100.`},days:{type:`string`,description:`Search Console lookback window for linked target pages. Defaults to 90.`},refresh:{type:`boolean`,default:!1,description:`Bypass local provider and Search Console caches.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=O(e.file),r=O(e.format),i=O(e.provider);if(i&&![`ahrefs`,`dataforseo`,`bing`].includes(i))throw new C(`INVALID_INPUT`,`--provider must be ahrefs, dataforseo or bing.`);if(n&&i)throw new C(`INVALID_INPUT`,`Do not pass --provider with a local link file.`);let a=O(e.scope);if(a&&a!==`domain`&&a!==`page`)throw new C(`INVALID_INPUT`,`--scope must be domain or page.`);if(r&&![`csv`,`json`,`jsonl`].includes(r))throw new C(`INVALID_INPUT`,`--format must be csv, json, or jsonl.`);let o=M(e[`row-limit`],`--row-limit`),s=O(e.target),c=O(e.site);if(n&&(c||s))throw new C(`INVALID_INPUT`,`Pass one link source: --file, --site for Bing, or --target for Ahrefs or DataForSEO.`);if(c&&s)throw new C(`INVALID_INPUT`,`Pass --site for Bing or --target for a live research provider, not both.`);if(s&&i===`bing`)throw new C(`INVALID_INPUT`,`Use --site with Bing or --target with Ahrefs or DataForSEO.`);if(c&&[`ahrefs`,`dataforseo`].includes(i??``))throw new C(`INVALID_INPUT`,`Use --target with Ahrefs or DataForSEO, or --site with Bing.`);let l=k(e),u=l?await U({project:l,options:{json:t}}):void 0;!n&&!u&&!s&&(u=await U({options:{json:t}}));let d;if(n)d=await Ve({file:n,format:r,rowLimit:o});else if(i===`ahrefs`||i===`dataforseo`||s){let t=s??u?.startUrl??u?.siteUrl.replace(/^sc-domain:/u,``);if(!t)throw new C(`INVALID_INPUT`,`Pass --target or use a saved project with a crawl URL or Search Console property.`);let n={target:t,scope:a,includeSubdomains:A(e[`include-subdomains`]),rowLimit:o,refresh:A(e.refresh),context:{projectId:u?.id,reportId:`link-evidence`,reportRunId:zr()}};d=i===`ahrefs`?await Ye(n):await ne(n)}else{let t=c??_e(u);if(!t)throw new C(`INVALID_INPUT`,`Pass --site, connect Bing to a saved project, or import a link file with --file.`);d=await Te({site:t,rowLimit:o,targetLimit:M(e[`target-limit`],`--target-limit`),detailPagesPerTarget:M(e[`detail-pages`],`--detail-pages`)})}let f=O(e[`search-site`])??u?.siteUrl,p=u||f||d.externalProvider?await pe({evidence:d,searchConsoleSite:f,crawlSite:u?.siteUrl??f??d.externalProvider?.summary.data.target,days:M(e.days,`--days`),refresh:A(e.refresh)}):void 0,m=Ne({evidence:d,limit:M(e.limit,`--limit`),targetContext:p});if(t){R(m);return}let h=m.providerEvidence?[m.providerEvidence.summary.cost.actualMicros,m.providerEvidence.backlinks.cost.actualMicros]:[],g=h.every(e=>e!==null)?h.reduce((e,t)=>e+t,0):null,_=m.providerEvidence?[m.providerEvidence.summary.cost.native?.actualUnits,m.providerEvidence.backlinks.cost.native?.actualUnits]:[],v=_.every(e=>e!=null)?_.reduce((e,t)=>e+t,0):null,y=m.providerEvidence?[m.providerEvidence.summary.cache.status,m.providerEvidence.backlinks.cache.status].every(e=>e===`hit`):!1;K({title:`Inbound link evidence`,target:m.provenance.provider,status:m.dataStatus===`complete`?`info`:`unknown`,summary:`${W(m.summary.observedLinks)} retained links from ${W(m.summary.referringDomains)} referring domains.`,metrics:[{label:`Evidence`,value:m.dataStatus},{label:`Observed links`,value:W(m.summary.observedLinks)},{label:`Referring domains`,value:W(m.summary.referringDomains)},{label:`Target pages`,value:W(m.summary.targetPages)},{label:`Returned rows`,value:`${W(m.selection.returnedRows)} of ${W(m.selection.availableRows)}`},...m.providerSummary?.backlinks.state===`observed`?[{label:`Provider backlinks`,value:W(m.providerSummary.backlinks.value)}]:[],...m.providerSummary?.referringDomains.state===`observed`?[{label:`Provider domains`,value:W(m.providerSummary.referringDomains.value)}]:[],...m.providerEvidence?[{label:`Provider cost`,value:g===null?v===null?`Unknown`:`${W(v)} API units${y?` (cached)`:``}`:`$${(g/1e6).toFixed(4)}${y?` (cached)`:``}`}]:[],...m.providerSummary?.brokenBacklinks.state===`observed`&&m.providerSummary.brokenBacklinks.value>0?[{label:`Provider broken links`,value:W(m.providerSummary.brokenBacklinks.value)}]:[]]}),m.findings.length&&q([`Priority`,`Finding`,`Target`],m.findings.map(e=>[e.priority,e.code,G(e.targetUrl,72)])),m.links.length&&q([`Source`,`Target`,`Anchor`],m.links.map(e=>[G(e.sourceUrl,58),G(e.targetUrl,58),G(e.anchorText??``,36)])),Y(`Warnings`,m.warnings),Y(`Report caveats`,m.caveats)}});async function Au(e,t){if(!e){process.stdout.write(t);return}await li(Qr(e),{recursive:!0}),await _i(e,t),process.stdout.write(`Wrote ${e}\n`)}const ju={url:{type:`string`,description:`Public site or subpath URL to crawl.`},"report-id":{type:`string`,description:`Saved crawl report id to use.`},site:{type:`string`,description:`GSC property URL for selecting the latest saved crawl.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},"max-pages":{type:`string`,description:`Maximum public HTML pages to crawl.`},"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.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}};async function Mu(e,t){let n=O(e.url),r=O(e[`report-id`]);if(n&&r)throw Error(`Use either --url or --report-id, not both.`);if(!n)return Vo(e,{json:t.json});let i=k(e),a=O(e.site),o=i||a?await H({client:i,site:a,options:{json:t.json}}):void 0;return it({url:n,projectId:o?.client?.id,site:o?.site,maxPages:j(e[`max-pages`]),fetchRate:Ba(e),refresh:A(e.refresh),useSitemap:!0,checkExternal:!1})}const Nu=T({meta:{name:`llms`,description:`Check or generate an optional llms.txt file`},subCommands:{audit:T({meta:{name:`audit`,description:`Check an optional llms.txt file body and links`},args:ju,run:async({args:e})=>{let t=F(e),n=await Pe(await Mu(e,{json:t}));if(t){R(n);return}K({title:`llms.txt audit`,target:n.url,status:n.issues.length>0?`warning`:n.dataStatus===`complete`?`pass`:`info`,summary:n.headline,metrics:[{label:`SEO impact`,value:n.googleSearchImpact},{label:`Optional`,value:n.optional?`Yes`:`No`},{label:`Found`,value:n.exists?`Yes`:`No`},{label:`URL`,value:n.llmsTxtUrl},{label:`HTTP status`,value:n.status?String(n.status):`Unavailable`}],diagnostics:[{title:`Issues`,items:n.issues.map(e=>({status:e.severity===`high`?`fail`:`warning`,title:e.title,explanation:e.plainEnglish,fix:e.action}))}]}),Y(`Caveats`,n.caveats),Y(`Recommended pages`,n.recommendedPages.slice(0,10).map(e=>`${e.section}: ${e.url}`))}}),generate:T({meta:{name:`generate`,description:`Generate a valid llms.txt v2 draft from crawl data`},args:{...ju,output:{type:`string`,description:`Write llms.txt to this path instead of stdout.`},"max-urls":{type:`string`,description:`Maximum URLs to include. Defaults to 250.`},"token-budget":{type:`string`,description:`Approximate token budget. Defaults to 12000.`},exclude:{type:`string`,description:`Comma-separated URL patterns to exclude.`},title:{type:`string`,description:`Override the llms.txt title.`},description:{type:`string`,description:`Override the llms.txt description.`}},run:async({args:e})=>{let t=F(e),n=He(await Mu(e,{json:t}),{maxUrls:j(e[`max-urls`]),tokenBudget:j(e[`token-budget`]),maxBytes:t?65536:void 0,exclude:N(e.exclude),title:O(e.title),description:O(e.description)});if(t){R(n);return}await Au(O(e.output),n.content),O(e.output)&&z([[`URLs`,String(n.includedUrls)],[`Estimated tokens`,String(n.estimatedTokens)],[`Truncated`,n.limits.truncated?n.limits.reasons.join(`, `):`No`]])}})}}),Pu=T({meta:{name:`logs`,description:`Manage local log retention`},subCommands:{prune:T({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=ke();if(F(e)){R(t);return}e.quiet||process.stdout.write(`Rotated ${t.rotated} and removed ${t.removed} log files. ${Fo(t.sizeBytes)} retained.\n`)}})}}),Fu=[{client:`claude-desktop`,flag:`claude-desktop`},{client:`claude-code`,flag:`claude-code`},{client:`codex`,flag:`codex`},{client:`cursor`,flag:`cursor`}];function Iu(e,t){return A(e.all)?t:Fu.filter(({flag:t})=>A(e[t])).map(({client:e})=>e)}const Lu=T({meta:{name:`mcp`,description:`MCP server helpers`},subCommands:{serve:T({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-BquQC9xr.js`);await t({test:A(e.test)})}}),install:T({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(A(e.uninstall)&&A(e.reinstall))throw new C(`INVALID_INPUT`,`Use either --uninstall or --reinstall, not both.`);let t=Ps(),n=Ls({targets:t}),r=F(e),i=Iu(e,n.map(e=>e.client));if(i.length===0){if(!L({json:r}))throw new C(`INVALID_INPUT`,`Choose an MCP client with --claude-desktop, --claude-code, --codex, --cursor, or --all.`);let a=n.length>0?n:t;i=V(await Ai({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 C(`INVALID_INPUT`,`MCP setup is not supported for ${a.join(`, `)} on ${process.platform}.`);let o=t.filter(e=>i.includes(e.client)).map(t=>A(e.uninstall)?nc(t):tc(t,{reinstall:A(e.reinstall)}));if(r){R({operation:A(e.uninstall)?`uninstall`:`install`,results:o});return}for(let e of o)process.stdout.write(`${e.changed?`updated`:`skipped`} ${e.client} · ${e.path}\n`)}})}}),Ru=T({meta:{name:`crawl-diff`,description:`Crawl a site and diff technical/page changes vs last run`},args:{url:{type:`string`,required:!0,description:`Start URL to crawl.`},site:{type:`string`,description:`Optional GSC property to associate with the crawl.`},limit:{type:`string`,description:`Maximum pages to crawl. Defaults to 50.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering when Playwright is installed.`}},run:async({args:e})=>{let t=await Oe({startUrl:O(e.url)??``,site:O(e.site),limit:j(e.limit),refresh:A(e.refresh),js:A(e.js)?!0:`auto`});if(F(e)){R(t);return}if(K({title:`Crawl history comparison`,target:t.run.startUrl,status:t.previousRun===void 0?`unknown`:t.summary.newErrors>0||t.summary.indexabilityFlips>0?`warning`:`pass`,summary:t.previousRun===void 0?`No previous crawl was available for comparison.`:`${t.summary.changed} changed, ${t.summary.added} added, and ${t.summary.removed} removed URLs.`,metrics:[{label:`Run`,value:t.run.id},{label:`Crawled`,value:t.summary.crawled},{label:`Previous run`,value:t.previousRun?.id??`None`},{label:`Added`,value:t.summary.added},{label:`Removed`,value:t.summary.removed},{label:`Changed`,value:t.summary.changed},{label:`New errors`,value:t.summary.newErrors},{label:`Indexability flips`,value:t.summary.indexabilityFlips},{label:`High priority`,value:t.summary.highPriorityRecommendations}]}),t.recommendations.length&&(process.stdout.write(`
 Recommended actions
 `),B([`Severity`,`Category`,`URL`,`Action`],t.recommendations.slice(0,10).map(e=>[e.severity,e.category,G(e.url,56),G(e.action,72)])),J(`Top crawl actions`,t.recommendations.map(e=>({label:e.category,context:`${e.severity}, ${G(e.url,96)}`,action:e.action})))),t.items.length&&(process.stdout.write(`
 Changed URLs
 `),B([`Kind`,`URL`,`Changes`,`Recommendation`],t.items.slice(0,50).map(e=>[e.kind,G(e.url,56),e.changes.join(`, `),e.recommendation?.title??`-`]))),t.warnings.length){process.stdout.write(`
 Warnings
-`);for(let e of t.warnings.slice(0,10))process.stdout.write(`- ${e}\n`)}}});function Lu(){return{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},url:{type:`string`,description:`Start URL to crawl. Defaults from the project or GSC property.`},urls:{type:`string`,description:`Comma-separated URLs to inspect with URL Inspection.`},sitemaps:{type:`string`,description:`Comma-separated XML sitemap URLs for quota-aware index monitoring.`},properties:{type:`string`,description:`Comma-separated GSC properties for sitemap index monitoring.`},limit:{type:`string`,description:`Maximum pages to crawl. Defaults to 50.`},"daily-limit":{type:`string`,description:`URL Inspection daily limit per property. Defaults to 2000.`},"inspect-limit":{type:`string`,description:`Maximum sitemap URLs to inspect in this run. Defaults to 100.`},"max-urls":{type:`string`,description:`Maximum sitemap URLs to load for monitoring. Defaults to 50000.`},language:{type:`string`,description:`Optional URL Inspection language code.`},"recover-links":Fa(`Check search-value GSC pages for broken, blocked, or poorly redirected URLs.`,`Skip link recovery checks.`),"recover-days":{type:`string`,description:`GSC lookback window for link recovery. Defaults to 90.`},"recover-limit":{type:`string`,description:`Maximum search-value pages to check for link recovery. Defaults to 10.`},"recover-min-clicks":{type:`string`,description:`Minimum clicks for link recovery candidates. Defaults to 1.`},"recover-min-impressions":{type:`string`,description:`Minimum impressions for link recovery candidates. Defaults to 100.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP/GSC cache where supported.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering when Playwright is installed.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}}}function Ru(){return{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},"stale-days":{type:`string`,description:`Mark checks stale after this many days. Defaults to 8.`},refresh:{type:`boolean`,default:!1,description:`Refresh property selection data when prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}}}function zu(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 Bu(e){let t=e.steps.map(e=>zu(e.status)),n=t.includes(`fail`)?`fail`:t.includes(`warning`)?`warning`:t.includes(`unknown`)?`unknown`:`pass`;ko({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:zu(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}))}]})}function Vu(e){if(Bu(e),e.output.crawl?.recommendations.length&&(process.stdout.write(`
+`);for(let e of t.warnings.slice(0,10))process.stdout.write(`- ${e}\n`)}}});function zu(){return{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},url:{type:`string`,description:`Start URL to crawl. Defaults from the project or GSC property.`},urls:{type:`string`,description:`Comma-separated URLs to inspect with URL Inspection.`},sitemaps:{type:`string`,description:`Comma-separated XML sitemap URLs for quota-aware index monitoring.`},properties:{type:`string`,description:`Comma-separated GSC properties for sitemap index monitoring.`},limit:{type:`string`,description:`Maximum pages to crawl. Defaults to 50.`},"daily-limit":{type:`string`,description:`URL Inspection daily limit per property. Defaults to 2000.`},"inspect-limit":{type:`string`,description:`Maximum sitemap URLs to inspect in this run. Defaults to 100.`},"max-urls":{type:`string`,description:`Maximum sitemap URLs to load for monitoring. Defaults to 50000.`},language:{type:`string`,description:`Optional URL Inspection language code.`},"recover-links":Fa(`Check search-value GSC pages for broken, blocked, or poorly redirected URLs.`,`Skip link recovery checks.`),"recover-days":{type:`string`,description:`GSC lookback window for link recovery. Defaults to 90.`},"recover-limit":{type:`string`,description:`Maximum search-value pages to check for link recovery. Defaults to 10.`},"recover-min-clicks":{type:`string`,description:`Minimum clicks for link recovery candidates. Defaults to 1.`},"recover-min-impressions":{type:`string`,description:`Minimum impressions for link recovery candidates. Defaults to 100.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP/GSC cache where supported.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering when Playwright is installed.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}}}function Bu(){return{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},"stale-days":{type:`string`,description:`Mark checks stale after this many days. Defaults to 8.`},refresh:{type:`boolean`,default:!1,description:`Refresh property selection data when prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}}}function Vu(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 Hu(e){let t=e.steps.map(e=>Vu(e.status)),n=t.includes(`fail`)?`fail`:t.includes(`warning`)?`warning`:t.includes(`unknown`)?`unknown`:`pass`;ko({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:Vu(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}))}]})}function Uu(e){if(Hu(e),e.output.crawl?.recommendations.length&&(process.stdout.write(`
 Crawl actions
 `),B([`Severity`,`URL`,`Action`],e.output.crawl.recommendations.slice(0,10).map(e=>[e.severity,G(e.url,56),G(e.action,72)])),J(`Top crawl actions`,e.output.crawl.recommendations.map(e=>({label:e.severity,context:G(e.url,96),action:e.action})))),e.output.index?.items.length){let t=e.output.index.items.filter(e=>e.currentIssue||e.changed||e.inspectionStatus!==`succeeded`).slice(0,25);t.length&&(process.stdout.write(`
 Index reviews, changes, and failed checks
 `),B([`Check`,`Change`,`Index state`,`Evidence`,`URL`],t.map(e=>[e.inspectionStatus,e.changeKind,e.indexStatus,G((e.errorCode??e.issueCodes.join(`, `))||`none`,40),G(e.url,64)])))}e.output.recovery?.items.length&&(process.stdout.write(`
 Recoverable URLs
-`),B([`Severity`,`Issue`,`Clicks`,`Impr`,`URL`,`Action`],e.output.recovery.items.slice(0,10).map(e=>[e.severity,e.issue,W(e.clicks),W(e.impressions),G(e.url,56),G(e.recommendation.action,72)])),J(`Top recovery actions`,e.output.recovery.items.map(e=>({label:G(e.url,96),context:`${e.severity}, ${W(e.clicks)} clicks at risk`,action:e.recommendation.action}))))}function Hu(e){K({title:`Technical monitoring status`,target:e.site,status:e.health===`clear`?`pass`:e.health===`attention`?`warning`:`unknown`,summary:e.summary.attention>0?`${e.summary.attention} checks need attention.`:e.summary.stale>0||e.summary.notRun>0?`${e.summary.stale} checks are stale and ${e.summary.notRun} have not run.`:`No monitoring checks currently need attention.`,metrics:[{label:`Health`,value:e.health},{label:`Attention`,value:e.summary.attention},{label:`Stale`,value:e.summary.stale},{label:`Not run`,value:e.summary.notRun}]}),B([`Check`,`Status`,`Last run`,`Summary`],e.checks.map(e=>[e.name,e.status,e.lastRunAt??`-`,e.summary]));let t=e.checks.filter(e=>e.action);t.length&&(process.stdout.write(`
+`),B([`Severity`,`Issue`,`Clicks`,`Impr`,`URL`,`Action`],e.output.recovery.items.slice(0,10).map(e=>[e.severity,e.issue,W(e.clicks),W(e.impressions),G(e.url,56),G(e.recommendation.action,72)])),J(`Top recovery actions`,e.output.recovery.items.map(e=>({label:G(e.url,96),context:`${e.severity}, ${W(e.clicks)} clicks at risk`,action:e.recommendation.action}))))}function Wu(e){K({title:`Technical monitoring status`,target:e.site,status:e.health===`clear`?`pass`:e.health===`attention`?`warning`:`unknown`,summary:e.summary.attention>0?`${e.summary.attention} checks need attention.`:e.summary.stale>0||e.summary.notRun>0?`${e.summary.stale} checks are stale and ${e.summary.notRun} have not run.`:`No monitoring checks currently need attention.`,metrics:[{label:`Health`,value:e.health},{label:`Attention`,value:e.summary.attention},{label:`Stale`,value:e.summary.stale},{label:`Not run`,value:e.summary.notRun}]}),B([`Check`,`Status`,`Last run`,`Summary`],e.checks.map(e=>[e.name,e.status,e.lastRunAt??`-`,e.summary]));let t=e.checks.filter(e=>e.action);t.length&&(process.stdout.write(`
 Next actions
-`),B([`Check`,`Action`],t.map(e=>[e.name,G(e.action??``,96)])),J(`Next action details`,t.map(e=>({label:e.name,action:e.action??``}))))}function Uu(e,t){let n=O(t);return n?`--${e} ${JSON.stringify(n)}`:void 0}function Wu(e,t){return A(t)?`--${e}`:void 0}function Gu(e){return A(e)===!1?`--recover-links=false`:void 0}const Ku=T({meta:{name:`monitoring`,description:`Run and review recurring technical SEO monitoring`},subCommands:{run:T({meta:{name:`run`,description:`Run crawl, index, and link recovery monitoring for a property`},args:Lu(),run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=P(e.urls),i=P(e.sitemaps),a=O(e.url)??n.client?.startUrl??xs(n.site),o=await Xt({site:n.site,startUrl:a,urls:r.length?r:n.client?.watchUrls,sitemaps:i.length?i:void 0,properties:P(e.properties).length?P(e.properties):void 0,limit:j(e.limit),languageCode:O(e.language),dailyLimit:j(e[`daily-limit`]),inspectLimit:j(e[`inspect-limit`]),maxUrls:j(e[`max-urls`]),refresh:A(e.refresh),js:A(e.js)?!0:`auto`,recoverLinks:A(e[`recover-links`]),recoverDays:j(e[`recover-days`]),recoverLimit:j(e[`recover-limit`]),recoverMinClicks:j(e[`recover-min-clicks`]),recoverMinImpressions:j(e[`recover-min-impressions`])});if(t){R(o);return}Vu(o)}}),status:T({meta:{name:`status`,description:`Show the latest saved monitoring state for a property`},args:Ru(),run:async({args:e})=>{let t=F(e),n=s({site:(await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}})).site,staleAfterDays:j(e[`stale-days`])});if(t){R(n);return}Hu(n)}}),cron:T({meta:{name:`cron`,description:`Print a local cron line for recurring monitoring`},args:{...Lu(),hour:{type:`string`,default:`9`,description:`Hour in local cron time. Defaults to 9.`},minute:{type:`string`,default:`0`,description:`Minute in local cron time. Defaults to 0.`},weekday:{type:`string`,description:`Weekly monitoring day. Defaults to client setting, then Monday.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=j(e.hour)??9,i=j(e.minute)??0,a=j(e.weekday)??n.client?.technicalWeekday??1,o=[`seo monitoring run`,n.client?`--project ${JSON.stringify(n.client.id)}`:`--site ${JSON.stringify(n.site)}`,Uu(`url`,e.url),Uu(`urls`,e.urls),Uu(`sitemaps`,e.sitemaps),Uu(`properties`,e.properties),Uu(`limit`,e.limit),Uu(`daily-limit`,e[`daily-limit`]),Uu(`inspect-limit`,e[`inspect-limit`]),Uu(`max-urls`,e[`max-urls`]),Uu(`language`,e.language),Uu(`recover-days`,e[`recover-days`]),Uu(`recover-limit`,e[`recover-limit`]),Uu(`recover-min-clicks`,e[`recover-min-clicks`]),Uu(`recover-min-impressions`,e[`recover-min-impressions`]),Gu(e[`recover-links`]),Wu(`refresh`,e.refresh),Wu(`js`,e.js),`--json`].filter(Boolean).join(` `),s={name:`monitoring`,cron:`${i} ${r} * * ${a}`,command:o};if(t){R({site:n.site,line:s});return}z([[`Property`,n.site],[`Install`,`crontab -e`]]),process.stdout.write(`${s.cron} ${s.command}\n`)}})}}),qu=T({meta:{name:`index-coverage`,description:`Find crawlable pages that deserve a closer Google index check`},args:{project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},"crawl-report-id":{type:`string`,description:`Saved crawl report id. Defaults to the latest for the site.`},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=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=P(e.sitemaps),i=await ge({site:n.site,crawlReportId:O(e[`crawl-report-id`]),sitemaps:r.length?r:void 0,days:j(e.days),rowLimit:j(e[`row-limit`]),maxSitemapUrls:j(e[`max-sitemap-urls`]),itemsPerSection:j(e.limit),refresh:A(e.refresh)});if(t){R(i);return}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(`
+`),B([`Check`,`Action`],t.map(e=>[e.name,G(e.action??``,96)])),J(`Next action details`,t.map(e=>({label:e.name,action:e.action??``}))))}function Gu(e,t){let n=O(t);return n?`--${e} ${JSON.stringify(n)}`:void 0}function Ku(e,t){return A(t)?`--${e}`:void 0}function qu(e){return A(e)===!1?`--recover-links=false`:void 0}const Ju=T({meta:{name:`monitoring`,description:`Run and review recurring technical SEO monitoring`},subCommands:{run:T({meta:{name:`run`,description:`Run crawl, index, and link recovery monitoring for a property`},args:zu(),run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=P(e.urls),i=P(e.sitemaps),a=O(e.url)??n.client?.startUrl??Cs(n.site),o=await Xt({site:n.site,startUrl:a,urls:r.length?r:n.client?.watchUrls,sitemaps:i.length?i:void 0,properties:P(e.properties).length?P(e.properties):void 0,limit:j(e.limit),languageCode:O(e.language),dailyLimit:j(e[`daily-limit`]),inspectLimit:j(e[`inspect-limit`]),maxUrls:j(e[`max-urls`]),refresh:A(e.refresh),js:A(e.js)?!0:`auto`,recoverLinks:A(e[`recover-links`]),recoverDays:j(e[`recover-days`]),recoverLimit:j(e[`recover-limit`]),recoverMinClicks:j(e[`recover-min-clicks`]),recoverMinImpressions:j(e[`recover-min-impressions`])});if(t){R(o);return}Uu(o)}}),status:T({meta:{name:`status`,description:`Show the latest saved monitoring state for a property`},args:Bu(),run:async({args:e})=>{let t=F(e),n=s({site:(await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}})).site,staleAfterDays:j(e[`stale-days`])});if(t){R(n);return}Wu(n)}}),cron:T({meta:{name:`cron`,description:`Print a local cron line for recurring monitoring`},args:{...zu(),hour:{type:`string`,default:`9`,description:`Hour in local cron time. Defaults to 9.`},minute:{type:`string`,default:`0`,description:`Minute in local cron time. Defaults to 0.`},weekday:{type:`string`,description:`Weekly monitoring day. Defaults to client setting, then Monday.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=j(e.hour)??9,i=j(e.minute)??0,a=j(e.weekday)??n.client?.technicalWeekday??1,o=[`seo monitoring run`,n.client?`--project ${JSON.stringify(n.client.id)}`:`--site ${JSON.stringify(n.site)}`,Gu(`url`,e.url),Gu(`urls`,e.urls),Gu(`sitemaps`,e.sitemaps),Gu(`properties`,e.properties),Gu(`limit`,e.limit),Gu(`daily-limit`,e[`daily-limit`]),Gu(`inspect-limit`,e[`inspect-limit`]),Gu(`max-urls`,e[`max-urls`]),Gu(`language`,e.language),Gu(`recover-days`,e[`recover-days`]),Gu(`recover-limit`,e[`recover-limit`]),Gu(`recover-min-clicks`,e[`recover-min-clicks`]),Gu(`recover-min-impressions`,e[`recover-min-impressions`]),qu(e[`recover-links`]),Ku(`refresh`,e.refresh),Ku(`js`,e.js),`--json`].filter(Boolean).join(` `),s={name:`monitoring`,cron:`${i} ${r} * * ${a}`,command:o};if(t){R({site:n.site,line:s});return}z([[`Property`,n.site],[`Install`,`crontab -e`]]),process.stdout.write(`${s.cron} ${s.command}\n`)}})}}),Yu=T({meta:{name:`index-coverage`,description:`Find crawlable pages that deserve a closer Google index check`},args:{project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},"crawl-report-id":{type:`string`,description:`Saved crawl report id. Defaults to the latest for the site.`},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=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=P(e.sitemaps),i=await ge({site:n.site,crawlReportId:O(e[`crawl-report-id`]),sitemaps:r.length?r:void 0,days:j(e.days),rowLimit:j(e[`row-limit`]),maxSitemapUrls:j(e[`max-sitemap-urls`]),itemsPerSection:j(e.limit),refresh:A(e.refresh)});if(t){R(i);return}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
-`),B([`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)}}),Ju=T({meta:{name:`index-watch`,description:`Inspect URLs with GSC and alert on index status changes`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},urls:{type:`string`,description:`Comma-separated URLs to inspect.`},sitemaps:{type:`string`,description:`Comma-separated XML sitemap URLs to plan quota-aware monitoring.`},plan:{type:`boolean`,default:!1,description:`Plan sitemap URL allocation across GSC properties without inspecting URLs.`},properties:{type:`string`,description:`Comma-separated GSC properties to use for planning. Defaults to account properties.`},"daily-limit":{type:`string`,description:`URL Inspection daily limit per property. Defaults to 2000.`},"target-days":{type:`string`,description:`Target number of days to inspect all monitored URLs. Defaults to 1.`},"max-urls":{type:`string`,description:`Maximum sitemap URLs to load for planning. Defaults to 50000.`},"inspect-limit":{type:`string`,description:`Maximum URLs to inspect in this run from sitemap mode. Defaults to 100.`},language:{type:`string`,description:`Optional URL Inspection language code.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=P(e.urls),r=await zo({site:O(e.site),options:{json:t}}),i=P(e.sitemaps);if(A(e.plan)){if(!i.length)throw Error(`Pass at least one sitemap with --sitemaps.`);let n=await S({site:r,sitemaps:i,properties:P(e.properties).length?P(e.properties):void 0,dailyLimit:j(e[`daily-limit`]),targetCycleDays:j(e[`target-days`]),maxUrls:j(e[`max-urls`])});if(t){R(n);return}K({title:`Index monitoring plan`,target:n.site,status:n.warnings.length>0?`warning`:`info`,summary:`${n.summary.urlCount} sitemap URLs can be checked in an estimated ${On(n.summary.estimatedCycleDays,`day`)}.`,metrics:[{label:`Sitemap URLs`,value:n.summary.urlCount},{label:`Properties`,value:n.summary.properties},{label:`Daily capacity`,value:n.summary.dailyCapacity},{label:`Target cycle`,value:On(n.summary.targetCycleDays,`day`)},{label:`Suggested properties`,value:n.summary.suggestedProperties}]}),n.properties.length&&B([`Property`,`URLs`,`Cycle`,`Sample URL`],n.properties.map(e=>[e.property,e.urlCount,On(e.cycleDays,`day`),e.sampleUrls[0]??`-`])),n.suggestions.length&&(process.stdout.write(`
+`),B([`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)}}),Xu=T({meta:{name:`index-watch`,description:`Inspect URLs with GSC and alert on index status changes`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},urls:{type:`string`,description:`Comma-separated URLs to inspect.`},sitemaps:{type:`string`,description:`Comma-separated XML sitemap URLs to plan quota-aware monitoring.`},plan:{type:`boolean`,default:!1,description:`Plan sitemap URL allocation across GSC properties without inspecting URLs.`},properties:{type:`string`,description:`Comma-separated GSC properties to use for planning. Defaults to account properties.`},"daily-limit":{type:`string`,description:`URL Inspection daily limit per property. Defaults to 2000.`},"target-days":{type:`string`,description:`Target number of days to inspect all monitored URLs. Defaults to 1.`},"max-urls":{type:`string`,description:`Maximum sitemap URLs to load for planning. Defaults to 50000.`},"inspect-limit":{type:`string`,description:`Maximum URLs to inspect in this run from sitemap mode. Defaults to 100.`},language:{type:`string`,description:`Optional URL Inspection language code.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=P(e.urls),r=await zo({site:O(e.site),options:{json:t}}),i=P(e.sitemaps);if(A(e.plan)){if(!i.length)throw Error(`Pass at least one sitemap with --sitemaps.`);let n=await S({site:r,sitemaps:i,properties:P(e.properties).length?P(e.properties):void 0,dailyLimit:j(e[`daily-limit`]),targetCycleDays:j(e[`target-days`]),maxUrls:j(e[`max-urls`])});if(t){R(n);return}K({title:`Index monitoring plan`,target:n.site,status:n.warnings.length>0?`warning`:`info`,summary:`${n.summary.urlCount} sitemap URLs can be checked in an estimated ${On(n.summary.estimatedCycleDays,`day`)}.`,metrics:[{label:`Sitemap URLs`,value:n.summary.urlCount},{label:`Properties`,value:n.summary.properties},{label:`Daily capacity`,value:n.summary.dailyCapacity},{label:`Target cycle`,value:On(n.summary.targetCycleDays,`day`)},{label:`Suggested properties`,value:n.summary.suggestedProperties}]}),n.properties.length&&B([`Property`,`URLs`,`Cycle`,`Sample URL`],n.properties.map(e=>[e.property,e.urlCount,On(e.cycleDays,`day`),e.sampleUrls[0]??`-`])),n.suggestions.length&&(process.stdout.write(`
 Suggested URL-prefix properties
 `),B([`Property`,`URLs`,`Current property`,`Cycle`,`Reason`],n.suggestions.map(e=>[e.property,e.urlCount,e.currentProperty,On(e.estimatedCycleDays,`day`),e.reason]))),Y(`Warnings`,n.warnings.slice(0,10));return}if(i.length){let n=await Ie({site:r,sitemaps:i,properties:P(e.properties).length?P(e.properties):void 0,dailyLimit:j(e[`daily-limit`]),inspectLimit:j(e[`inspect-limit`]),maxUrls:j(e[`max-urls`]),languageCode:O(e.language)});if(t){R(n);return}K({title:`Index monitoring run`,target:n.site,status:n.summary.failed>0||n.summary.quotaBlocked>0?`unknown`:n.summary.alerts>0||n.summary.regressions>0?`warning`:n.summary.attempted>0?`pass`:`info`,summary:`${n.summary.inspected} URLs inspected, with ${n.summary.alerts} new alerts and ${n.summary.regressions} regressions.`,metrics:[{label:`Inventory URLs`,value:n.summary.inventoryUrls},{label:`Selected`,value:n.summary.selected},{label:`Inspected`,value:n.summary.inspected},{label:`Failed`,value:n.summary.failed},{label:`Quota blocked`,value:n.summary.quotaBlocked},{label:`Current reviews`,value:n.summary.currentIssues},{label:`Regressions`,value:n.summary.regressions},{label:`Recoveries`,value:n.summary.recoveries},{label:`New alerts`,value:n.summary.alerts}]}),n.properties.length&&B([`Property`,`Inventory`,`Selected`,`Inspected`,`Failed`,`Current`,`Alerts`],n.properties.map(e=>[e.property,e.inventoryUrls,e.selectedUrls,e.inspected,e.failed+e.quotaBlocked,e.currentIssues,e.alerts]));let a=n.items.filter(e=>e.currentIssue||e.changed||e.inspectionStatus!==`succeeded`).slice(0,50);a.length&&(process.stdout.write(`
 Index reviews, changes, and failed checks
-`),B([`Check`,`Change`,`Index state`,`Evidence`,`URL`],a.map(e=>[e.inspectionStatus,e.changeKind,e.indexStatus,(e.errorCode??e.issueCodes.join(`, `))||`none`,e.url]))),Y(`Warnings`,n.warnings.slice(0,10));return}if(!n.length)throw Error(`Pass at least one URL with --urls.`);let a=await We({site:r,urls:n,languageCode:O(e.language),dailyLimit:j(e[`daily-limit`])});if(t){R(a);return}K({title:`Index watch`,target:a.site,status:a.summary.failed>0||a.summary.quotaBlocked>0?`unknown`:a.summary.alerts>0||a.summary.regressions>0?`warning`:a.summary.attempted>0?`pass`:`info`,summary:`${a.summary.inspected} URLs inspected, with ${a.summary.alerts} new alerts.`,metrics:[{label:`Property`,value:a.source.property},{label:`Attempted`,value:a.summary.attempted},{label:`Inspected`,value:a.summary.inspected},{label:`Failed`,value:a.summary.failed},{label:`Quota blocked`,value:a.summary.quotaBlocked},{label:`Current reviews`,value:a.summary.currentIssues},{label:`Regressions`,value:a.summary.regressions},{label:`Recoveries`,value:a.summary.recoveries},{label:`New alerts`,value:a.summary.alerts}]}),B([`Check`,`Change`,`Index state`,`Evidence`,`URL`],a.items.map(e=>[e.inspectionStatus,e.changeKind,e.indexStatus,(e.errorCode??e.issueCodes.join(`, `))||`none`,e.url]))}}),Yu=T({meta:{name:`link-recover`,description:`Find search-value URLs that are now broken, blocked, or poorly redirected`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=await Sn({site:await bs({client:k(e),site:O(e.site)},{json:t}),days:j(e.days),limit:j(e.limit),minClicks:j(e[`min-clicks`]),minImpressions:j(e[`min-impressions`]),refresh:A(e.refresh),js:A(e.js)?!0:`auto`});if(t){R(n);return}K({title:`Link recovery`,target:n.site,status:n.warnings.length>0?`unknown`:n.summary.recoverable>0?`warning`:`pass`,summary:n.summary.recoverable>0?`${W(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:W(n.summary.checked)},{label:`Recoverable`,value:W(n.summary.recoverable)},{label:`High severity`,value:W(n.summary.high)},{label:`Clicks at risk`,value:W(n.summary.clicksAtRisk)},{label:`Impressions at risk`,value:W(n.summary.impressionsAtRisk)}]}),n.items.length&&(q([`Severity`,`Issue`,`Clicks`,`Impr`,`URL`,`Action`],n.items.map(e=>[e.severity,e.issue,W(e.clicks),W(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}, ${W(e.clicks)} clicks at risk`,action:e.recommendation.action})))),Y(`Warnings`,n.warnings.slice(0,10))}}),Xu=T({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:O(e.url)??``,maxHops:j(e[`max-hops`]),refresh:A(e.refresh),js:A(e.js)?!0:`auto`});if(F(e)){R(t);return}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}]}),B([`#`,`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(`
+`),B([`Check`,`Change`,`Index state`,`Evidence`,`URL`],a.map(e=>[e.inspectionStatus,e.changeKind,e.indexStatus,(e.errorCode??e.issueCodes.join(`, `))||`none`,e.url]))),Y(`Warnings`,n.warnings.slice(0,10));return}if(!n.length)throw Error(`Pass at least one URL with --urls.`);let a=await We({site:r,urls:n,languageCode:O(e.language),dailyLimit:j(e[`daily-limit`])});if(t){R(a);return}K({title:`Index watch`,target:a.site,status:a.summary.failed>0||a.summary.quotaBlocked>0?`unknown`:a.summary.alerts>0||a.summary.regressions>0?`warning`:a.summary.attempted>0?`pass`:`info`,summary:`${a.summary.inspected} URLs inspected, with ${a.summary.alerts} new alerts.`,metrics:[{label:`Property`,value:a.source.property},{label:`Attempted`,value:a.summary.attempted},{label:`Inspected`,value:a.summary.inspected},{label:`Failed`,value:a.summary.failed},{label:`Quota blocked`,value:a.summary.quotaBlocked},{label:`Current reviews`,value:a.summary.currentIssues},{label:`Regressions`,value:a.summary.regressions},{label:`Recoveries`,value:a.summary.recoveries},{label:`New alerts`,value:a.summary.alerts}]}),B([`Check`,`Change`,`Index state`,`Evidence`,`URL`],a.items.map(e=>[e.inspectionStatus,e.changeKind,e.indexStatus,(e.errorCode??e.issueCodes.join(`, `))||`none`,e.url]))}}),Zu=T({meta:{name:`link-recover`,description:`Find search-value URLs that are now broken, blocked, or poorly redirected`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=await Sn({site:await Ss({client:k(e),site:O(e.site)},{json:t}),days:j(e.days),limit:j(e.limit),minClicks:j(e[`min-clicks`]),minImpressions:j(e[`min-impressions`]),refresh:A(e.refresh),js:A(e.js)?!0:`auto`});if(t){R(n);return}K({title:`Link recovery`,target:n.site,status:n.warnings.length>0?`unknown`:n.summary.recoverable>0?`warning`:`pass`,summary:n.summary.recoverable>0?`${W(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:W(n.summary.checked)},{label:`Recoverable`,value:W(n.summary.recoverable)},{label:`High severity`,value:W(n.summary.high)},{label:`Clicks at risk`,value:W(n.summary.clicksAtRisk)},{label:`Impressions at risk`,value:W(n.summary.impressionsAtRisk)}]}),n.items.length&&(q([`Severity`,`Issue`,`Clicks`,`Impr`,`URL`,`Action`],n.items.map(e=>[e.severity,e.issue,W(e.clicks),W(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}, ${W(e.clicks)} clicks at risk`,action:e.recommendation.action})))),Y(`Warnings`,n.warnings.slice(0,10))}}),Qu=T({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:O(e.url)??``,maxHops:j(e[`max-hops`]),refresh:A(e.refresh),js:A(e.js)?!0:`auto`});if(F(e)){R(t);return}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}]}),B([`#`,`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(`
 Final page
-`),z([[`Title`,t.finalPage.title??`-`],[`Canonical`,t.finalPage.canonical??`-`],[`Meta robots`,t.finalPage.metaRobots??`-`]])),Y(`Warnings`,t.warnings.slice(0,10))}});function Zu(e,t){process.stdout.write(`OKF validation for ${e}\n\n`),z([[`Version`,t.formatVersion??`not declared`],[`Compatibility`,t.compatibility],[`Profile`,t.profile],[`Valid`,t.valid?`yes`:`no`],[`Files`,String(t.files)],[`Concepts`,String(t.concepts)],[`Errors`,String(t.issueCounts.errors)],[`Warnings`,String(t.issueCounts.warnings)],[`With sources`,String(t.provenance.sources)],[`Generated`,String(t.generation.generated)],[`Human reviewed`,String(t.trust.humanReviewed)],[`Machine confirmed`,String(t.trust.machineConfirmed)],[`Unverified`,String(t.trust.unverified)],[`Draft`,String(t.lifecycle.draft)],[`Stable`,String(t.lifecycle.stable)],[`Deprecated`,String(t.lifecycle.deprecated)],[`Fresh`,String(t.freshness.fresh)],[`Stale`,String(t.freshness.stale)],[`Freshness unspecified`,String(t.freshness.unspecified)],[`Attested computations`,String(t.attestation.concepts)],[`Complete attestation contracts`,String(t.attestation.completeContracts)],[`Incomplete attestation contracts`,String(t.attestation.incompleteContracts)],[`Inline computations`,String(t.attestation.inlineComputations)],[`File computations`,String(t.attestation.fileComputations)]]),t.issues.length&&(process.stdout.write(`
+`),z([[`Title`,t.finalPage.title??`-`],[`Canonical`,t.finalPage.canonical??`-`],[`Meta robots`,t.finalPage.metaRobots??`-`]])),Y(`Warnings`,t.warnings.slice(0,10))}});function $u(e,t){process.stdout.write(`OKF validation for ${e}\n\n`),z([[`Version`,t.formatVersion??`not declared`],[`Compatibility`,t.compatibility],[`Profile`,t.profile],[`Valid`,t.valid?`yes`:`no`],[`Files`,String(t.files)],[`Concepts`,String(t.concepts)],[`Errors`,String(t.issueCounts.errors)],[`Warnings`,String(t.issueCounts.warnings)],[`With sources`,String(t.provenance.sources)],[`Generated`,String(t.generation.generated)],[`Human reviewed`,String(t.trust.humanReviewed)],[`Machine confirmed`,String(t.trust.machineConfirmed)],[`Unverified`,String(t.trust.unverified)],[`Draft`,String(t.lifecycle.draft)],[`Stable`,String(t.lifecycle.stable)],[`Deprecated`,String(t.lifecycle.deprecated)],[`Fresh`,String(t.freshness.fresh)],[`Stale`,String(t.freshness.stale)],[`Freshness unspecified`,String(t.freshness.unspecified)],[`Attested computations`,String(t.attestation.concepts)],[`Complete attestation contracts`,String(t.attestation.completeContracts)],[`Incomplete attestation contracts`,String(t.attestation.incompleteContracts)],[`Inline computations`,String(t.attestation.inlineComputations)],[`File computations`,String(t.attestation.fileComputations)]]),t.issues.length&&(process.stdout.write(`
 Issues
-`),B([`Severity`,`Path`,`Message`],t.issues.slice(0,25).map(e=>[e.severity,e.path,e.message]))),t.issuesTruncated&&process.stdout.write(`\n${t.omittedIssues} more validation issues were omitted.\n`)}function Qu(e){let t=O(e)??`okf`;if(t===`okf`||t===`seo-export`)return t;throw new C(`INVALID_INPUT`,`Profile must be okf or seo-export.`)}const $u=T({meta:{name:`okf`,description:`Export, validate, and explain OKF site knowledge bundles`},subCommands:{export:T({meta:{name:`export`,description:`Export a saved crawl as an OKF bundle`},args:{"report-id":{type:`string`,description:`Saved crawl report id to export.`},site:{type:`string`,description:`GSC property URL for selecting the latest saved crawl.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},output:{type:`string`,description:`Output directory. Defaults to ./okf.`},"max-concepts":{type:`string`,description:`Maximum page concepts to export. Defaults to 500.`},title:{type:`string`,description:`Override the root bundle title.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=er(M(e[`max-concepts`],`--max-concepts`)),r=Ln(await Vo(e,{json:t}),{maxConcepts:n,title:O(e.title)}),i=O(e.output)??`./okf`,a=await uu(i,r.files);if(t){R({output:i,bundle:r,validation:a});return}process.stdout.write(`Wrote OKF bundle to ${i}\n\n`),z([[`Files`,String(r.files.length)],[`Concepts`,String(r.conceptCount)],[`Page concepts`,String(r.pageConceptCount)],[`Valid`,a.valid?`yes`:`no`]])}}),validate:T({meta:{name:`validate`,description:`Validate an OKF bundle directory`},args:{path:{type:`positional`,required:!0,description:`OKF bundle directory.`},profile:{type:`string`,description:`Validation profile: okf or seo-export. Defaults to okf.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.path);if(!t)throw Error(`Pass an OKF bundle directory.`);let n=Wt(await cu(t),{profile:Qu(e.profile)});if(n.valid||(process.exitCode=1),F(e)){R(n);return}Zu(t,n)}}),explain:T({meta:{name:`explain`,description:`Explain OKF validation results in plain English`},args:{path:{type:`positional`,required:!0,description:`OKF bundle directory.`},profile:{type:`string`,description:`Validation profile: okf or seo-export. Defaults to okf.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.path);if(!t)throw Error(`Pass an OKF bundle directory.`);let n=ar(Wt(await cu(t),{profile:Qu(e.profile)}));if(n.valid||(process.exitCode=1),F(e)){R(n);return}if(process.stdout.write(`${n.summary}\n\n`),z([[`Version`,n.formatVersion??`not declared`],[`Compatibility`,n.compatibility],[`Profile`,n.profile],[`Valid`,n.valid?`yes`:`no`],[`Files`,String(n.files)],[`Concepts`,String(n.concepts)],[`Errors`,String(n.errors)],[`Warnings`,String(n.warnings)],[`With sources`,String(n.provenance.sources)],[`Generated`,String(n.generation.generated)],[`Human reviewed`,String(n.trust.humanReviewed)],[`Machine confirmed`,String(n.trust.machineConfirmed)],[`Unverified`,String(n.trust.unverified)],[`Draft`,String(n.lifecycle.draft)],[`Stable`,String(n.lifecycle.stable)],[`Deprecated`,String(n.lifecycle.deprecated)],[`Fresh`,String(n.freshness.fresh)],[`Stale`,String(n.freshness.stale)],[`Freshness unspecified`,String(n.freshness.unspecified)],[`Attested computations`,String(n.attestation.concepts)],[`Complete attestation contracts`,String(n.attestation.completeContracts)],[`Incomplete attestation contracts`,String(n.attestation.incompleteContracts)],[`Inline computations`,String(n.attestation.inlineComputations)],[`File computations`,String(n.attestation.fileComputations)]]),n.nextActions.length){process.stdout.write(`
+`),B([`Severity`,`Path`,`Message`],t.issues.slice(0,25).map(e=>[e.severity,e.path,e.message]))),t.issuesTruncated&&process.stdout.write(`\n${t.omittedIssues} more validation issues were omitted.\n`)}function ed(e){let t=O(e)??`okf`;if(t===`okf`||t===`seo-export`)return t;throw new C(`INVALID_INPUT`,`Profile must be okf or seo-export.`)}const td=T({meta:{name:`okf`,description:`Export, validate, and explain OKF site knowledge bundles`},subCommands:{export:T({meta:{name:`export`,description:`Export a saved crawl as an OKF bundle`},args:{"report-id":{type:`string`,description:`Saved crawl report id to export.`},site:{type:`string`,description:`GSC property URL for selecting the latest saved crawl.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},output:{type:`string`,description:`Output directory. Defaults to ./okf.`},"max-concepts":{type:`string`,description:`Maximum page concepts to export. Defaults to 500.`},title:{type:`string`,description:`Override the root bundle title.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=er(M(e[`max-concepts`],`--max-concepts`)),r=Ln(await Vo(e,{json:t}),{maxConcepts:n,title:O(e.title)}),i=O(e.output)??`./okf`,a=await fu(i,r.files);if(t){R({output:i,bundle:r,validation:a});return}process.stdout.write(`Wrote OKF bundle to ${i}\n\n`),z([[`Files`,String(r.files.length)],[`Concepts`,String(r.conceptCount)],[`Page concepts`,String(r.pageConceptCount)],[`Valid`,a.valid?`yes`:`no`]])}}),validate:T({meta:{name:`validate`,description:`Validate an OKF bundle directory`},args:{path:{type:`positional`,required:!0,description:`OKF bundle directory.`},profile:{type:`string`,description:`Validation profile: okf or seo-export. Defaults to okf.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.path);if(!t)throw Error(`Pass an OKF bundle directory.`);let n=Wt(await uu(t),{profile:ed(e.profile)});if(n.valid||(process.exitCode=1),F(e)){R(n);return}$u(t,n)}}),explain:T({meta:{name:`explain`,description:`Explain OKF validation results in plain English`},args:{path:{type:`positional`,required:!0,description:`OKF bundle directory.`},profile:{type:`string`,description:`Validation profile: okf or seo-export. Defaults to okf.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.path);if(!t)throw Error(`Pass an OKF bundle directory.`);let n=ar(Wt(await uu(t),{profile:ed(e.profile)}));if(n.valid||(process.exitCode=1),F(e)){R(n);return}if(process.stdout.write(`${n.summary}\n\n`),z([[`Version`,n.formatVersion??`not declared`],[`Compatibility`,n.compatibility],[`Profile`,n.profile],[`Valid`,n.valid?`yes`:`no`],[`Files`,String(n.files)],[`Concepts`,String(n.concepts)],[`Errors`,String(n.errors)],[`Warnings`,String(n.warnings)],[`With sources`,String(n.provenance.sources)],[`Generated`,String(n.generation.generated)],[`Human reviewed`,String(n.trust.humanReviewed)],[`Machine confirmed`,String(n.trust.machineConfirmed)],[`Unverified`,String(n.trust.unverified)],[`Draft`,String(n.lifecycle.draft)],[`Stable`,String(n.lifecycle.stable)],[`Deprecated`,String(n.lifecycle.deprecated)],[`Fresh`,String(n.freshness.fresh)],[`Stale`,String(n.freshness.stale)],[`Freshness unspecified`,String(n.freshness.unspecified)],[`Attested computations`,String(n.attestation.concepts)],[`Complete attestation contracts`,String(n.attestation.completeContracts)],[`Incomplete attestation contracts`,String(n.attestation.incompleteContracts)],[`Inline computations`,String(n.attestation.inlineComputations)],[`File computations`,String(n.attestation.fileComputations)]]),n.nextActions.length){process.stdout.write(`
 Next actions
-`);for(let e of n.nextActions)process.stdout.write(`- ${e}\n`)}}})}}),ed=T({meta:{name:`ai-referrals`,description:`Find AI referral traffic detected in Google Analytics`},args:{property:{type:`string`,description:`Google Analytics property ID. If omitted in a terminal, choose one.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name with an optional Google Analytics property.`},"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=F(e),n=await U({client:k(e),options:{json:t}}),r=await _n({property:await Bo({property:O(e.property)??n?.analytics.google?.propertyId,options:{json:t}}),startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),maxRows:M(e[`max-rows`],`--max-rows`),resultLimit:M(e[`result-limit`],`--result-limit`),limit:M(e.limit,`--limit`),refresh:e.refresh===!0});if(t){R(r);return}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:W(r.summary.sessions)},{label:`AI users`,value:r.summary.totalUsers===null?`Unavailable`:W(r.summary.totalUsers)},{label:`Sources`,value:W(r.summary.sources)},{label:`Landing pages`,value:W(r.summary.landingPages)},{label:`Landing-page output`,value:`${W(r.selection.landingPages.returnedRows)} returned / ${W(r.selection.landingPages.retainedRows)} retained`},{label:`Source rows`,value:W(r.dataSource.sourceDiscovery.returnedRows)}]}),r.sources.length&&(process.stdout.write(`
+`);for(let e of n.nextActions)process.stdout.write(`- ${e}\n`)}}})}}),nd=T({meta:{name:`ai-referrals`,description:`Find AI referral traffic detected in Google Analytics`},args:{property:{type:`string`,description:`Google Analytics property ID. If omitted in a terminal, choose one.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name with an optional Google Analytics property.`},"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=F(e),n=await U({client:k(e),options:{json:t}}),r=await _n({property:await Bo({property:O(e.property)??n?.analytics.google?.propertyId,options:{json:t}}),startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),maxRows:M(e[`max-rows`],`--max-rows`),resultLimit:M(e[`result-limit`],`--result-limit`),limit:M(e.limit,`--limit`),refresh:e.refresh===!0});if(t){R(r);return}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:W(r.summary.sessions)},{label:`AI users`,value:r.summary.totalUsers===null?`Unavailable`:W(r.summary.totalUsers)},{label:`Sources`,value:W(r.summary.sources)},{label:`Landing pages`,value:W(r.summary.landingPages)},{label:`Landing-page output`,value:`${W(r.selection.landingPages.returnedRows)} returned / ${W(r.selection.landingPages.retainedRows)} retained`},{label:`Source rows`,value:W(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,W(e.sessions),W(e.eventCount),as(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),W(e.sessions),W(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`)}}),td=T({meta:{name:`cannibal`,description:`Find queries with material exposure across multiple URLs`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=A(e.refresh),i=await H({client:k(e),site:O(e.site),options:{json:t,refresh:n}}),a=await r({site:i.site,days:M(e.days,`--days`),limit:M(e.limit,`--limit`),minImpressions:M(e[`min-impressions`],`--min-impressions`),brandTerms:[...i.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),refresh:n});if(t){R(a);return}K({title:`Cannibalisation report`,target:a.site,status:a.dataStatus===`complete`?`info`:`unknown`,summary:a.summary.verdict,metrics:[{label:`Evidence`,value:a.dataStatus},{label:`Range`,value:`${a.range.startDate} to ${a.range.endDate}`},{label:`Eligible`,value:W(a.summary.eligibleClusters)},{label:`Returned`,value:W(a.summary.returnedClusters)},{label:`Suppressed brand queries`,value:W(a.summary.suppressedQueries)},{label:`GSC completeness`,value:a.source.completeness},{label:`Brand queries`,value:A(e[`include-brand`])?`included`:`excluded`}]}),q([`Query`,`URLs`,`Property impr`,`Exposure`,`HHI`,`Review first`],a.items.map(e=>[G(e.query,42),e.pages.length,e.propertyImpressions===void 0?`n/a`:W(e.propertyImpressions),W(e.pageExposureImpressions),e.hhi.toFixed(2),G(e.suggestedOwnerUrl,56)])),J(`Top cannibalisation actions`,a.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`,a.caveats),Y(`Provider usage`,[a.ledgerSummary])}}),nd=T({meta:{name:`community-intent`,description:`Find GSC queries with forum, review, and comparison intent`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},"start-date":{type:`string`,description:`Exact GSC start date (YYYY-MM-DD). Use with --end-date.`},"end-date":{type:`string`,description:`Exact GSC end date (YYYY-MM-DD). Use with --start-date.`},"max-rows":{type:`string`,description:`Maximum retained GSC query rows. Defaults to 50000.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},...X([`days`,`limit`,`minImpressions`,`includeBrand`,`refresh`],{days:{description:`GSC lookback within the current 16-month retention.`},limit:{description:`Maximum intent queries to print. Defaults to 25.`},minImpressions:{description:`Minimum query impressions. Defaults to 20.`},includeBrand:{description:`Include branded queries in community-intent reports.`},refresh:{description:`Bypass local GSC cache.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await $t({site:n.site,days:M(e.days,`--days`),startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),limit:M(e.limit,`--limit`),minImpressions:M(e[`min-impressions`],`--min-impressions`),maxRows:M(e[`max-rows`],`--max-rows`),brandTerms:[...n.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),refresh:A(e.refresh)});if(t){R(r);return}K({title:`Community intent report`,target:r.site,status:r.dataStatus===`available`||r.dataStatus===`empty`?`info`:`unknown`,summary:r.summary.verdict,metrics:[{label:`Evidence`,value:r.dataStatus},{label:`Classified queries`,value:W(r.summary.classifiedQueries)},{label:`Returned queries`,value:W(r.summary.returnedQueries)},{label:`Impressions`,value:W(r.summary.returnedImpressions)},{label:`Clicks`,value:W(r.summary.returnedClicks)},{label:`GSC completeness`,value:r.source.completeness}]}),q([`Intent`,`Query`,`Impr`,`Clicks`,`Confidence`,`Action`],r.items.map(e=>[e.intent,G(e.query,42),W(e.impressions),W(e.clicks),e.confidence,G(e.action,76)])),J(`Top community-intent actions`,r.items.map(e=>({label:e.query,context:`${e.intent}, ${W(e.impressions)} impressions`,action:e.action}))),Y(`Report caveats`,r.caveats),Y(`Warnings`,r.warnings)}}),rd=T({meta:{name:`ctr-underperformers`,description:`Find high-impression queries with weak CTR for their position`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...X([`includeBrand`,`minImpressions`],{minImpressions:{description:`Minimum query impressions. Defaults to 200.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t}}),r=await ur({site:n.site,minImpressions:j(e[`min-impressions`]),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`])});if(t){R(r);return}K({title:`CTR underperformers`,target:r.site,status:r.dataStatus===`partial`?`unknown`:`info`,summary:r.summary.verdict,metrics:[{label:`Underperformers`,value:W(r.summary.underperformers)},{label:`Estimated click gap`,value:W(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),is(e.position),W(e.impressions),as(e.actualCtr),as(e.expectedCtr),W(e.clickShortfall),G(e.recommendation.action,72)])),J(`Top CTR actions`,r.items.map(e=>({label:e.query,context:`${W(e.clickShortfall)} click gap, ${as(e.actualCtr)} CTR`,action:e.recommendation.action})))}});function id(e){return e>0?is(e):`n/a`}const ad=T({meta:{name:`decaying`,description:`Find query/page rows losing clicks between two GSC windows`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=A(e.refresh),r=O(e.comparison),i=M(e.days,`--days`),a=M(e.limit,`--limit`),o=M(e[`min-drop-pct`],`--min-drop-pct`),s=M(e[`min-previous-clicks`],`--min-previous-clicks`),c=M(e[`min-click-loss`],`--min-click-loss`);if(r!==void 0&&r!==`previous-period`&&r!==`year-over-year`)throw new C(`INVALID_INPUT`,`--comparison must be previous-period or year-over-year.`);let l=await H({client:k(e),site:O(e.site),options:{json:t,refresh:n}}),u=await Je({site:l.site,days:i,limit:a,comparison:r,brandTerms:[...l.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),minDropPct:o,minPreviousClicks:s,minClickLoss:c,refresh:n});if(t){R(u);return}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:W(u.summary.returnedRows)},{label:`Eligible declines`,value:W(u.summary.eligibleRows)},{label:`Decay clusters`,value:W(u.summary.groups)},{label:`Observed click decline`,value:W(u.summary.returnedObservedRetainedQueryClickLoss)},{label:`Eligible click decline`,value:W(u.summary.observedRetainedQueryClickLoss)},{label:`Brand queries`,value:u.summary.brandFiltering},{label:`Minimum drop`,value:`${u.filters.minDropPct}%`},{label:`Minimum previous clicks`,value:W(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),W(e.count),W(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:`${W(e.count)} retained rows, ${W(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(`, `),W(e.clickLoss),`${W(e.previous.clicks)} -> ${W(e.current.clicks)}`,`${W(e.previous.impressions)} -> ${W(e.current.impressions)}`,`${as(e.previous.ctr)} -> ${as(e.current.ctr)}`,`${id(e.previous.position)} -> ${id(e.current.position)}`,G(e.recommendation.action,64)])),J(`Top decay actions`,u.items.map(e=>({label:e.query,context:`${e.template.label}, ${W(e.clickLoss)} fewer observed clicks`,action:e.recommendation.action}))))}}),od=T({meta:{name:`internal-links`,description:`Find verified internal-link review candidates for one URL`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},url:{type:`string`,required:!0,description:`Target page that should receive relevant internal links.`},...X([`days`,`limit`,`checkLimit`,`minImpressions`,`includeBrand`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=A(e.refresh),r=M(e.days,`--days`),i=M(e.limit,`--limit`),a=M(e[`check-limit`],`--check-limit`),o=M(e[`min-impressions`],`--min-impressions`),s=Va(e),c=await H({client:k(e),site:O(e.site),options:{json:t,refresh:n}}),l=await Qe({site:c.site,targetUrl:O(e.url)??``,days:r,limit:i,checkLimit:a,minImpressions:o,brandTerms:[...c.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),js:A(e.js)?!0:void 0,rate:s,refresh:n});if(t){R(l);return}K({title:`Internal link opportunities`,target:l.targetUrl,status:l.summary.failedChecks>0||l.summary.uncheckedCandidates>0?`unknown`:`info`,summary:l.summary.verdict,metrics:[{label:`Target state`,value:l.target.verification},{label:`Preferred target`,value:l.target.preferredUrl},{label:`Target queries`,value:W(l.summary.targetQueries)},{label:`Matched sources`,value:W(l.summary.candidateSources)},{label:`Checked sources`,value:W(l.summary.checkedSources)},{label:`Attempted sources`,value:W(l.summary.attemptedSources)},{label:`Review candidates`,value:W(l.summary.returnedSources)},{label:`Technical exclusions`,value:W(l.summary.technicalExclusions)},{label:`Existing links`,value:W(l.summary.existingLinksObserved)},{label:`Failed checks`,value:W(l.summary.failedChecks)},{label:`Unchecked sources`,value:W(l.summary.uncheckedCandidates)},{label:`GSC completeness`,value:l.source.completeness},{label:`Brand queries`,value:l.summary.brandFiltering}]}),Y(`Why this matters`,[`Exact-query overlap is useful affinity evidence; precision lexical matches are review evidence only.`,`Source and target pages are checked for redirects, indexability, canonicals, and existing link placement before an action is returned.`]),Y(`Recommended actions`,l.recommendations),Y(`Report caveats`,l.caveats),l.items.length&&(q([`Source URL`,`Matched impr`,`Match`,`Link evidence`,`Action`],l.items.map(e=>[G(e.sourceUrl,52),W(e.matchedQueryImpressions),e.bestMatchKind,e.linkEvidence.status,e.actionType])),J(`Top internal-link reviews`,l.items.map(e=>({label:G(e.sourceUrl,96),context:`${W(e.matchedQueryImpressions)} matched-query impressions; ${e.bestMatchKind}`,action:e.recommendation.action}))),Y(`Provider usage`,[l.ledgerSummary]))}}),sd=T({meta:{name:`page-opportunities`,description:`Find first-party traffic growth opportunities for one URL`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},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":Fa(`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=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await Fr({site:n.site,url:O(e.url)??``,days:j(e.days),limit:j(e.limit),minImpressions:j(e[`min-impressions`]),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),verifyContent:A(e[`verify-content`])!==!1,js:A(e.js)?!0:`auto`,refresh:A(e.refresh)});if(t){R(r);return}if(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:ws(r.page?.fetchDiagnostics)},{label:`Verification`,value:r.verification.status},{label:`Rows`,value:`${W(r.selection.returnedRows)} returned / ${W(r.selection.eligibleRows)} eligible / ${W(r.selection.sourceRows)} source`},{label:`Queries`,value:W(r.summary.queries)},{label:`Impressions`,value:W(r.summary.impressions)},{label:`Opportunities`,value:W(r.summary.opportunities)},{label:`CTR shortfall`,value:W(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){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`)}}),rd=T({meta:{name:`cannibal`,description:`Find queries with material exposure across multiple URLs`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=A(e.refresh),i=await H({client:k(e),site:O(e.site),options:{json:t,refresh:n}}),a=await r({site:i.site,days:M(e.days,`--days`),limit:M(e.limit,`--limit`),minImpressions:M(e[`min-impressions`],`--min-impressions`),brandTerms:[...i.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),refresh:n});if(t){R(a);return}K({title:`Cannibalisation report`,target:a.site,status:a.dataStatus===`complete`?`info`:`unknown`,summary:a.summary.verdict,metrics:[{label:`Evidence`,value:a.dataStatus},{label:`Range`,value:`${a.range.startDate} to ${a.range.endDate}`},{label:`Eligible`,value:W(a.summary.eligibleClusters)},{label:`Returned`,value:W(a.summary.returnedClusters)},{label:`Suppressed brand queries`,value:W(a.summary.suppressedQueries)},{label:`GSC completeness`,value:a.source.completeness},{label:`Brand queries`,value:A(e[`include-brand`])?`included`:`excluded`}]}),q([`Query`,`URLs`,`Property impr`,`Exposure`,`HHI`,`Review first`],a.items.map(e=>[G(e.query,42),e.pages.length,e.propertyImpressions===void 0?`n/a`:W(e.propertyImpressions),W(e.pageExposureImpressions),e.hhi.toFixed(2),G(e.suggestedOwnerUrl,56)])),J(`Top cannibalisation actions`,a.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`,a.caveats),Y(`Provider usage`,[a.ledgerSummary])}}),id=T({meta:{name:`community-intent`,description:`Find GSC queries with forum, review, and comparison intent`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},"start-date":{type:`string`,description:`Exact GSC start date (YYYY-MM-DD). Use with --end-date.`},"end-date":{type:`string`,description:`Exact GSC end date (YYYY-MM-DD). Use with --start-date.`},"max-rows":{type:`string`,description:`Maximum retained GSC query rows. Defaults to 50000.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},...X([`days`,`limit`,`minImpressions`,`includeBrand`,`refresh`],{days:{description:`GSC lookback within the current 16-month retention.`},limit:{description:`Maximum intent queries to print. Defaults to 25.`},minImpressions:{description:`Minimum query impressions. Defaults to 20.`},includeBrand:{description:`Include branded queries in community-intent reports.`},refresh:{description:`Bypass local GSC cache.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await $t({site:n.site,days:M(e.days,`--days`),startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),limit:M(e.limit,`--limit`),minImpressions:M(e[`min-impressions`],`--min-impressions`),maxRows:M(e[`max-rows`],`--max-rows`),brandTerms:[...n.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),refresh:A(e.refresh)});if(t){R(r);return}K({title:`Community intent report`,target:r.site,status:r.dataStatus===`available`||r.dataStatus===`empty`?`info`:`unknown`,summary:r.summary.verdict,metrics:[{label:`Evidence`,value:r.dataStatus},{label:`Classified queries`,value:W(r.summary.classifiedQueries)},{label:`Returned queries`,value:W(r.summary.returnedQueries)},{label:`Impressions`,value:W(r.summary.returnedImpressions)},{label:`Clicks`,value:W(r.summary.returnedClicks)},{label:`GSC completeness`,value:r.source.completeness}]}),q([`Intent`,`Query`,`Impr`,`Clicks`,`Confidence`,`Action`],r.items.map(e=>[e.intent,G(e.query,42),W(e.impressions),W(e.clicks),e.confidence,G(e.action,76)])),J(`Top community-intent actions`,r.items.map(e=>({label:e.query,context:`${e.intent}, ${W(e.impressions)} impressions`,action:e.action}))),Y(`Report caveats`,r.caveats),Y(`Warnings`,r.warnings)}}),ad=T({meta:{name:`ctr-underperformers`,description:`Find high-impression queries with weak CTR for their position`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...X([`includeBrand`,`minImpressions`],{minImpressions:{description:`Minimum query impressions. Defaults to 200.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t}}),r=await ur({site:n.site,minImpressions:j(e[`min-impressions`]),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`])});if(t){R(r);return}K({title:`CTR underperformers`,target:r.site,status:r.dataStatus===`partial`?`unknown`:`info`,summary:r.summary.verdict,metrics:[{label:`Underperformers`,value:W(r.summary.underperformers)},{label:`Estimated click gap`,value:W(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),is(e.position),W(e.impressions),as(e.actualCtr),as(e.expectedCtr),W(e.clickShortfall),G(e.recommendation.action,72)])),J(`Top CTR actions`,r.items.map(e=>({label:e.query,context:`${W(e.clickShortfall)} click gap, ${as(e.actualCtr)} CTR`,action:e.recommendation.action})))}});function od(e){return e>0?is(e):`n/a`}const sd=T({meta:{name:`decaying`,description:`Find query/page rows losing clicks between two GSC windows`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=A(e.refresh),r=O(e.comparison),i=M(e.days,`--days`),a=M(e.limit,`--limit`),o=M(e[`min-drop-pct`],`--min-drop-pct`),s=M(e[`min-previous-clicks`],`--min-previous-clicks`),c=M(e[`min-click-loss`],`--min-click-loss`);if(r!==void 0&&r!==`previous-period`&&r!==`year-over-year`)throw new C(`INVALID_INPUT`,`--comparison must be previous-period or year-over-year.`);let l=await H({client:k(e),site:O(e.site),options:{json:t,refresh:n}}),u=await Je({site:l.site,days:i,limit:a,comparison:r,brandTerms:[...l.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),minDropPct:o,minPreviousClicks:s,minClickLoss:c,refresh:n});if(t){R(u);return}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:W(u.summary.returnedRows)},{label:`Eligible declines`,value:W(u.summary.eligibleRows)},{label:`Decay clusters`,value:W(u.summary.groups)},{label:`Observed click decline`,value:W(u.summary.returnedObservedRetainedQueryClickLoss)},{label:`Eligible click decline`,value:W(u.summary.observedRetainedQueryClickLoss)},{label:`Brand queries`,value:u.summary.brandFiltering},{label:`Minimum drop`,value:`${u.filters.minDropPct}%`},{label:`Minimum previous clicks`,value:W(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),W(e.count),W(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:`${W(e.count)} retained rows, ${W(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(`, `),W(e.clickLoss),`${W(e.previous.clicks)} -> ${W(e.current.clicks)}`,`${W(e.previous.impressions)} -> ${W(e.current.impressions)}`,`${as(e.previous.ctr)} -> ${as(e.current.ctr)}`,`${od(e.previous.position)} -> ${od(e.current.position)}`,G(e.recommendation.action,64)])),J(`Top decay actions`,u.items.map(e=>({label:e.query,context:`${e.template.label}, ${W(e.clickLoss)} fewer observed clicks`,action:e.recommendation.action}))))}}),cd=T({meta:{name:`internal-links`,description:`Find verified internal-link review candidates for one URL`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},url:{type:`string`,required:!0,description:`Target page that should receive relevant internal links.`},...X([`days`,`limit`,`checkLimit`,`minImpressions`,`includeBrand`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=A(e.refresh),r=M(e.days,`--days`),i=M(e.limit,`--limit`),a=M(e[`check-limit`],`--check-limit`),o=M(e[`min-impressions`],`--min-impressions`),s=Va(e),c=await H({client:k(e),site:O(e.site),options:{json:t,refresh:n}}),l=await Qe({site:c.site,targetUrl:O(e.url)??``,days:r,limit:i,checkLimit:a,minImpressions:o,brandTerms:[...c.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),js:A(e.js)?!0:void 0,rate:s,refresh:n});if(t){R(l);return}K({title:`Internal link opportunities`,target:l.targetUrl,status:l.summary.failedChecks>0||l.summary.uncheckedCandidates>0?`unknown`:`info`,summary:l.summary.verdict,metrics:[{label:`Target state`,value:l.target.verification},{label:`Preferred target`,value:l.target.preferredUrl},{label:`Target queries`,value:W(l.summary.targetQueries)},{label:`Matched sources`,value:W(l.summary.candidateSources)},{label:`Checked sources`,value:W(l.summary.checkedSources)},{label:`Attempted sources`,value:W(l.summary.attemptedSources)},{label:`Review candidates`,value:W(l.summary.returnedSources)},{label:`Technical exclusions`,value:W(l.summary.technicalExclusions)},{label:`Existing links`,value:W(l.summary.existingLinksObserved)},{label:`Failed checks`,value:W(l.summary.failedChecks)},{label:`Unchecked sources`,value:W(l.summary.uncheckedCandidates)},{label:`GSC completeness`,value:l.source.completeness},{label:`Brand queries`,value:l.summary.brandFiltering}]}),Y(`Why this matters`,[`Exact-query overlap is useful affinity evidence; precision lexical matches are review evidence only.`,`Source and target pages are checked for redirects, indexability, canonicals, and existing link placement before an action is returned.`]),Y(`Recommended actions`,l.recommendations),Y(`Report caveats`,l.caveats),l.items.length&&(q([`Source URL`,`Matched impr`,`Match`,`Link evidence`,`Action`],l.items.map(e=>[G(e.sourceUrl,52),W(e.matchedQueryImpressions),e.bestMatchKind,e.linkEvidence.status,e.actionType])),J(`Top internal-link reviews`,l.items.map(e=>({label:G(e.sourceUrl,96),context:`${W(e.matchedQueryImpressions)} matched-query impressions; ${e.bestMatchKind}`,action:e.recommendation.action}))),Y(`Provider usage`,[l.ledgerSummary]))}}),ld=T({meta:{name:`page-opportunities`,description:`Find first-party traffic growth opportunities for one URL`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},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":Fa(`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=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await Fr({site:n.site,url:O(e.url)??``,days:j(e.days),limit:j(e.limit),minImpressions:j(e[`min-impressions`]),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),verifyContent:A(e[`verify-content`])!==!1,js:A(e.js)?!0:`auto`,refresh:A(e.refresh)});if(t){R(r);return}if(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:Es(r.page?.fetchDiagnostics)},{label:`Verification`,value:r.verification.status},{label:`Rows`,value:`${W(r.selection.returnedRows)} returned / ${W(r.selection.eligibleRows)} eligible / ${W(r.selection.sourceRows)} source`},{label:`Queries`,value:W(r.summary.queries)},{label:`Impressions`,value:W(r.summary.impressions)},{label:`Opportunities`,value:W(r.summary.opportunities)},{label:`CTR shortfall`,value:W(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){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.
-`);return}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),as(e.ctr),e.expectedCtr===void 0?`n/a`:as(e.expectedCtr),W(e.impressions),e.estimatedCtrClickShortfall===void 0?`n/a`:W(e.estimatedCtrClickShortfall),G(e.recommendation,72)])),J(`Top page actions`,r.items.map(e=>({label:e.query,context:`${e.opportunityType}, ${W(e.impressions)} impressions`,action:e.recommendation})))}}),cd=T({meta:{name:`query-cluster`,description:`Cluster GSC queries into repeated demand themes`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},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=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t}}),r=await te({site:n.site,scope:O(e.scope),brand:n.client?.brandTerms?.[0],brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),minImpressions:j(e[`min-impressions`]),limit:j(e.limit)});if(t){R(r);return}K({title:`Query clusters`,target:r.site,status:`info`,summary:r.summary.verdict,metrics:[{label:`Scope`,value:r.scope??`All pages`},{label:`Clusters`,value:W(r.summary.clusters)},{label:`Queries`,value:W(r.summary.queries)},{label:`Impressions`,value:W(r.summary.impressions)},{label:`Clicks`,value:W(r.summary.clicks)},{label:`Minimum impressions`,value:W(r.summary.minImpressions)},{label:`Result limit`,value:W(r.summary.limit)},{label:`High opportunity`,value:W(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,W(e.totals?.impressions??0),as(e.totals?.ctr??0),as(e.benchmark?.expectedCtr??0),e.estimatedClickLift===void 0?`-`:W(e.estimatedClickLift),G(e.recommendation??``,72)])),J(`Top cluster actions`,r.clusters.map(e=>({label:e.label,context:`${W(e.totals?.impressions??0)} impressions, ${e.estimatedClickLift===void 0?`ranking opportunity`:`${W(e.estimatedClickLift)} estimated click lift`}`,action:e.recommendation??``})))}}),ld=T({meta:{name:`quick-wins`,description:`Find high-ranking low-CTR query/page opportunities`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=j(e[`verify-limit`]),r=A(e[`verify-content`])===!0||n!==void 0,i=await H({client:k(e),site:O(e.site),options:{json:t}}),a=await At({site:i.site,days:j(e.days),limit:j(e.limit),minImpressions:j(e[`min-impressions`]),brandTerms:[...i.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:A(e.js)?!0:void 0,rate:Ba(e),refresh:A(e.refresh)});if(t){R(a);return}K({title:`Quick wins`,target:a.site,status:a.source.possiblyTruncated?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible rows`,value:W(a.summary.eligibleRows)},{label:`Returned rows`,value:W(a.summary.returnedRows)},{label:`Query clusters`,value:W(a.summary.repeatedQueryGroups)},{label:`Template patterns`,value:W(a.summary.templatePatterns)},{label:`CTR click shortfall`,value:W(a.summary.returnedEstimatedCtrClickShortfall)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Evidence`,value:a.dataStatus},{label:`Verification`,value:os(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),W(e.urlCount),W(e.rowCount),W(e.totalEstimatedCtrClickShortfall),W(e.totalImpressions),G(e.action,72)])),J(`Top template actions`,a.templateRecommendations.map(e=>({label:e.templateLabel,context:`${W(e.urlCount)} URLs, ${W(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),W(e.urlCount),W(e.rowCount),W(e.totalEstimatedCtrClickShortfall),W(e.totalImpressions),G(e.sampleUrls[0]??`-`,46),G(e.recommendation,72)])),J(`Top cluster actions`,a.groups.map(e=>({label:e.label,context:`${W(e.urlCount)} URLs, ${W(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),is(e.position),W(e.impressions),`${as(e.ctr)} / ${as(e.targetCtr)}`,W(e.estimatedCtrClickShortfall),ws(e.contentVerification?.fetchDiagnostics),Ts(e.contentVerification?.classification),G(e.recommendation.action,64)])),J(`Top opportunity actions`,a.items.map(e=>({label:e.query,context:`${e.template.label}, pos ${is(e.position)}, ${W(e.impressions)} impressions`,action:e.recommendation.action}))))}}),ud=T({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.`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=j(e[`verify-limit`]),r=A(e[`verify-content`])===!0||n!==void 0,i=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),a=await ln({site:i.site,range:j(e.days),minImpressions:j(e[`min-impressions`]),limit:O(e.limit)?Number(O(e.limit)):10,brandTerms:i.client?.brandTerms,includeBrand:A(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:A(e.js)?!0:void 0,rate:Ba(e),refresh:A(e.refresh)});if(t){R(a);return}if(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:W(a.summary.eligiblePages)},{label:`Returned pages`,value:W(a.summary.returnedPages)},{label:`Eligible queries`,value:W(a.summary.eligibleQueries)},{label:`Impressions`,value:W(a.summary.eligibleImpressions)},{label:`Content issues`,value:W(a.summary.contentIssues)},{label:`Technical issues`,value:W(a.summary.technicalIssues)},{label:`Fetch failures`,value:W(a.summary.fetchFailures)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Evidence`,value:a.dataStatus},{label:`Verification`,value:os(a)}]}),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),!a.items.length){process.stdout.write(`No average-position candidates matched this report.
-`),process.stdout.write(`${a.ledgerSummary}\n`);return}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),W(e.queryCount),ws(e.fetchDiagnostics),Ts(e.contentVerification?.classification),e.recommendation.action])),J(`Top second-page actions`,a.items.map(e=>({label:e.primaryQuery,context:`${e.template.label}, pos ${is(e.position)}, ${W(e.impressions)} impressions`,action:e.recommendation.action}))),process.stdout.write(`${a.ledgerSummary}\n`)}}),dd=T({meta:{name:`seo-to-ai-query`,description:`Convert GSC search queries into AI-style monitoring prompts`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},"start-date":{type:`string`,description:`Exact GSC start date (YYYY-MM-DD). Use with --end-date.`},"end-date":{type:`string`,description:`Exact GSC end date (YYYY-MM-DD). Use with --start-date.`},"max-rows":{type:`string`,description:`Maximum retained GSC query rows. Defaults to 50000.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},...X([`days`,`limit`,`minImpressions`,`includeBrand`,`refresh`],{days:{description:`GSC lookback within the current 16-month retention.`},limit:{description:`Maximum source queries to convert. Defaults to 25.`},minImpressions:{description:`Minimum query impressions. Defaults to 20.`},includeBrand:{description:`Include branded queries in prompt generation.`},refresh:{description:`Bypass local GSC cache.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await pn({site:n.site,days:M(e.days,`--days`),startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),limit:M(e.limit,`--limit`),minImpressions:M(e[`min-impressions`],`--min-impressions`),maxRows:M(e[`max-rows`],`--max-rows`),brandTerms:[...n.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),refresh:A(e.refresh)});if(t){R(r);return}K({title:`SEO to AI query prompts`,target:r.site,status:r.dataStatus===`available`||r.dataStatus===`empty`?`info`:`unknown`,summary:r.summary.verdict,metrics:[{label:`Evidence`,value:r.dataStatus},{label:`Eligible queries`,value:W(r.summary.eligibleQueries)},{label:`Returned queries`,value:W(r.summary.returnedQueries)},{label:`Prompts`,value:W(r.summary.prompts)},{label:`GSC completeness`,value:r.source.completeness}]}),q([`Query`,`Impr`,`Prompt`],r.items.flatMap(e=>e.prompts.map(t=>[G(e.query,42),W(e.impressions),G(t,86)]))),Y(`Report caveats`,r.caveats),Y(`Warnings`,r.warnings)}}),fd=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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=k(e),n=O(e.site),r=t?await U({project:t,options:{json:F(e)}}):void 0,i=t||n?void 0:await U({options:{json:F(e)}}),a=await tr({url:O(e.url)??``,site:r?.siteUrl??n??i?.siteUrl,js:A(e.js)?!0:`auto`,refresh:A(e.refresh)});if(F(e)){R(a);return}K({title:`Page audit`,target:a.url,status:a.issues.some(e=>e.severity===`high`)?`fail`:a.issues.length>0?`warning`:`pass`,summary:a.issues.length>0?`${a.issues.length} ${a.issues.length===1?`issue needs`:`issues need`} review.`:`No page issues were found by the available checks.`,metrics:[{label:`Final URL`,value:a.page.finalUrl},{label:`Title`,value:a.page.title??`Missing`},{label:`Meta description`,value:a.page.metaDescription??`Missing`},{label:`Words`,value:a.page.wordCount},{label:`Fetch`,value:ws(a.fetchDiagnostics)}],diagnostics:[{title:`Issues`,items:a.issues.map(e=>({status:e.severity===`high`?`fail`:`warning`,title:`${e.code}: ${e.principle}`,explanation:e.detail}))}]})}});function pd(e){let t=O(e)??`mobile`;if(t!==`mobile`&&t!==`desktop`)throw new C(`INVALID_INPUT`,`Invalid --strategy. Use mobile or desktop.`);return t}function md(e){return e?e.displayValue??String(e.value??`not measured`):`not measured`}function hd(e){if(!e)return`not available`;let t=e.unit===`milliseconds`?`ms`:``;return`${e.p75}${t} (${e.rating})`}const gd=T({meta:{name:`perf`,description:`Audit lab performance and field Core Web Vitals`},subCommands:{audit:T({meta:{name:`audit`,description:`Run a Lighthouse/Core Web Vitals performance audit`},args:{url:{type:`string`,description:`URL to audit. Defaults to the selected project crawl URL.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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=F(e),n=await U({client:k(e),options:{json:t}}),r=O(e.url)??n?.startUrl;if(!r)throw Error(`No URL selected. Pass --url or use --project with a crawl URL.`);let i=await En({url:r,strategy:pd(e.strategy),lighthouseBin:O(e[`lighthouse-bin`]),cruxApiKey:O(e[`crux-key`]),refresh:A(e.refresh),includeRaw:t&&A(e.raw)});if(t){R(i);return}K({title:`Performance report`,target:i.url,status:i.dataStatus===`partial`?`unknown`:i.grade===`good`?`pass`:`warning`,summary:i.headline,metrics:[{label:`Source`,value:i.source},{label:`Strategy`,value:i.strategy},{label:`Lab score`,value:i.score===void 0?`Unknown`:`${i.score}/100`},{label:`Lab grade`,value:i.grade},{label:`Evidence`,value:i.dataStatus},{label:`FCP`,value:md(i.metrics.firstContentfulPaint)},{label:`LCP`,value:md(i.metrics.largestContentfulPaint)},{label:`TBT`,value:md(i.metrics.totalBlockingTime)},{label:`CLS`,value:md(i.metrics.cumulativeLayoutShift)},{label:`INP`,value:md(i.metrics.interactionToNextPaint)},{label:`Server response`,value:md(i.metrics.serverResponseTime)},{label:`Fallback fetch`,value:md(i.metrics.fallbackFetchDuration)},{label:`Field data`,value:i.fieldData?`${i.fieldData.scope} ${i.fieldData.formFactor.toLowerCase()} (${i.fieldData.assessment.status})`:i.fieldDataStatus.status},{label:`Field LCP p75`,value:hd(i.fieldData?.metrics.largestContentfulPaint)},{label:`Field INP p75`,value:hd(i.fieldData?.metrics.interactionToNextPaint)},{label:`Field CLS p75`,value:hd(i.fieldData?.metrics.cumulativeLayoutShift)},{label:`Field period`,value:i.fieldData?.collectionPeriod?.firstDate&&i.fieldData.collectionPeriod.lastDate?`${i.fieldData.collectionPeriod.firstDate} to ${i.fieldData.collectionPeriod.lastDate}`:`Unavailable`}]}),J(`Top actions`,i.topActions.map(e=>({label:e.title,action:e.action,context:e.plainEnglish}))),Y(`Caveats`,i.caveats)}})}}),_d=T({meta:{name:`diagnose`,description:`Find where Google Search performance changed`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Baseline window length in days. Defaults to 90.`},limit:{description:`Maximum rows per diagnostic section. Defaults to 10.`}}),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await ut({site:n.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),refresh:A(e.refresh),progress:Ul(!t)});if(t){R(r);return}K({title:`SEO diagnosis`,target:r.site,status:r.dataStatus===`complete`?r.priorities.length>0?`warning`:`pass`:`unknown`,summary:r.priorities.length>0?`${r.priorities.length} priorities need review.`:`No priorities were returned by the available evidence.`,metrics:[{label:`Evidence`,value:r.dataStatus},{label:`Update overlap`,value:r.summary.updateAttribution.replaceAll(`-`,` `)},{label:`Significant anomalies`,value:r.summary.significantAnomalies},{label:`Update matches`,value:r.summary.updateMatches},{label:`Decay items`,value:r.summary.decayItems},{label:`Cannibal items`,value:r.summary.cannibalItems},{label:`Striking distance`,value:r.summary.strikingDistanceItems},{label:`Quick wins`,value:r.summary.quickWinItems}]}),B([`Priority`,`Confidence`,`Reason`,`Action`],r.priorities.map(e=>[e.label,e.confidence,e.reason,e.action])),r.skippedSections?.length&&B([`Skipped section`,`Reason`],r.skippedSections.map(e=>[e.section,e.reason])),J(`Priority action details`,r.priorities.map(e=>({label:e.label,context:e.confidence,action:e.action})))}}),vd=T({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 xe();if(F(e)){R(t),t.ok||(process.exitCode=1);return}Do(`SEO doctor`,vo(t.checks)),process.stdout.write(`
-`),Oo(t.checks),process.stdout.write(`\nChecked ${t.generatedAt}\n`),t.ok||(process.exitCode=1)}}),yd=e=>{let t=O(e)??`page`;if(t!==`page`&&t!==`query`&&t!==`country`&&t!==`device`)throw Error(`Invalid --dimension. Use page, query, country, or device.`);return t},bd=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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=F(e),n=yd(e.dimension),r=M(e.days,`--days`),i=M(e.compare,`--compare`),a=M(e.limit,`--limit`),o=M(e[`unmatched-limit`],`--unmatched-limit`),s=M(e[`max-rows`],`--max-rows`),c=await Qt({site:(await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}})).site,dimension:n,days:r,compareDays:i,startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),limit:a,unmatchedLimit:o,maxRows:s,refresh:A(e.refresh)});if(t){R(c);return}K({title:`Segment impact`,target:c.site,status:c.dataStatus===`complete`?`info`:`unknown`,summary:c.summary.verdict,metrics:[{label:`Dimension`,value:c.dimension},{label:`Evidence`,value:c.dataStatus},{label:`Before`,value:`${c.before.startDate} to ${c.before.endDate}`},{label:`After`,value:`${c.after.startDate} to ${c.after.endDate}`}]}),B([`Segment`,`Clicks before`,`Clicks after`,`Delta`,`Pos delta`],c.items.map(e=>[e.key,e.beforeClicks,e.afterClicks,e.clickDelta,e.positionDelta??`-`])),c.unmatchedSegments.length&&(process.stdout.write(`
+`);return}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),as(e.ctr),e.expectedCtr===void 0?`n/a`:as(e.expectedCtr),W(e.impressions),e.estimatedCtrClickShortfall===void 0?`n/a`:W(e.estimatedCtrClickShortfall),G(e.recommendation,72)])),J(`Top page actions`,r.items.map(e=>({label:e.query,context:`${e.opportunityType}, ${W(e.impressions)} impressions`,action:e.recommendation})))}}),ud=T({meta:{name:`query-cluster`,description:`Cluster GSC queries into repeated demand themes`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},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=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t}}),r=await te({site:n.site,scope:O(e.scope),brand:n.client?.brandTerms?.[0],brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),minImpressions:j(e[`min-impressions`]),limit:j(e.limit)});if(t){R(r);return}K({title:`Query clusters`,target:r.site,status:`info`,summary:r.summary.verdict,metrics:[{label:`Scope`,value:r.scope??`All pages`},{label:`Clusters`,value:W(r.summary.clusters)},{label:`Queries`,value:W(r.summary.queries)},{label:`Impressions`,value:W(r.summary.impressions)},{label:`Clicks`,value:W(r.summary.clicks)},{label:`Minimum impressions`,value:W(r.summary.minImpressions)},{label:`Result limit`,value:W(r.summary.limit)},{label:`High opportunity`,value:W(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,W(e.totals?.impressions??0),as(e.totals?.ctr??0),as(e.benchmark?.expectedCtr??0),e.estimatedClickLift===void 0?`-`:W(e.estimatedClickLift),G(e.recommendation??``,72)])),J(`Top cluster actions`,r.clusters.map(e=>({label:e.label,context:`${W(e.totals?.impressions??0)} impressions, ${e.estimatedClickLift===void 0?`ranking opportunity`:`${W(e.estimatedClickLift)} estimated click lift`}`,action:e.recommendation??``})))}}),dd=T({meta:{name:`quick-wins`,description:`Find high-ranking low-CTR query/page opportunities`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=j(e[`verify-limit`]),r=A(e[`verify-content`])===!0||n!==void 0,i=await H({client:k(e),site:O(e.site),options:{json:t}}),a=await At({site:i.site,days:j(e.days),limit:j(e.limit),minImpressions:j(e[`min-impressions`]),brandTerms:[...i.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:A(e.js)?!0:void 0,rate:Ba(e),refresh:A(e.refresh)});if(t){R(a);return}K({title:`Quick wins`,target:a.site,status:a.source.possiblyTruncated?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible rows`,value:W(a.summary.eligibleRows)},{label:`Returned rows`,value:W(a.summary.returnedRows)},{label:`Query clusters`,value:W(a.summary.repeatedQueryGroups)},{label:`Template patterns`,value:W(a.summary.templatePatterns)},{label:`CTR click shortfall`,value:W(a.summary.returnedEstimatedCtrClickShortfall)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Evidence`,value:a.dataStatus},{label:`Verification`,value:os(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),W(e.urlCount),W(e.rowCount),W(e.totalEstimatedCtrClickShortfall),W(e.totalImpressions),G(e.action,72)])),J(`Top template actions`,a.templateRecommendations.map(e=>({label:e.templateLabel,context:`${W(e.urlCount)} URLs, ${W(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),W(e.urlCount),W(e.rowCount),W(e.totalEstimatedCtrClickShortfall),W(e.totalImpressions),G(e.sampleUrls[0]??`-`,46),G(e.recommendation,72)])),J(`Top cluster actions`,a.groups.map(e=>({label:e.label,context:`${W(e.urlCount)} URLs, ${W(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),is(e.position),W(e.impressions),`${as(e.ctr)} / ${as(e.targetCtr)}`,W(e.estimatedCtrClickShortfall),Es(e.contentVerification?.fetchDiagnostics),Ds(e.contentVerification?.classification),G(e.recommendation.action,64)])),J(`Top opportunity actions`,a.items.map(e=>({label:e.query,context:`${e.template.label}, pos ${is(e.position)}, ${W(e.impressions)} impressions`,action:e.recommendation.action}))))}}),fd=T({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.`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...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=F(e),n=j(e[`verify-limit`]),r=A(e[`verify-content`])===!0||n!==void 0,i=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),a=await ln({site:i.site,range:j(e.days),minImpressions:j(e[`min-impressions`]),limit:O(e.limit)?Number(O(e.limit)):10,brandTerms:i.client?.brandTerms,includeBrand:A(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:A(e.js)?!0:void 0,rate:Ba(e),refresh:A(e.refresh)});if(t){R(a);return}if(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:W(a.summary.eligiblePages)},{label:`Returned pages`,value:W(a.summary.returnedPages)},{label:`Eligible queries`,value:W(a.summary.eligibleQueries)},{label:`Impressions`,value:W(a.summary.eligibleImpressions)},{label:`Content issues`,value:W(a.summary.contentIssues)},{label:`Technical issues`,value:W(a.summary.technicalIssues)},{label:`Fetch failures`,value:W(a.summary.fetchFailures)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Evidence`,value:a.dataStatus},{label:`Verification`,value:os(a)}]}),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),!a.items.length){process.stdout.write(`No average-position candidates matched this report.
+`),process.stdout.write(`${a.ledgerSummary}\n`);return}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),W(e.queryCount),Es(e.fetchDiagnostics),Ds(e.contentVerification?.classification),e.recommendation.action])),J(`Top second-page actions`,a.items.map(e=>({label:e.primaryQuery,context:`${e.template.label}, pos ${is(e.position)}, ${W(e.impressions)} impressions`,action:e.recommendation.action}))),process.stdout.write(`${a.ledgerSummary}\n`)}}),pd=T({meta:{name:`seo-to-ai-query`,description:`Convert GSC search queries into AI-style monitoring prompts`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},"start-date":{type:`string`,description:`Exact GSC start date (YYYY-MM-DD). Use with --end-date.`},"end-date":{type:`string`,description:`Exact GSC end date (YYYY-MM-DD). Use with --start-date.`},"max-rows":{type:`string`,description:`Maximum retained GSC query rows. Defaults to 50000.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},...X([`days`,`limit`,`minImpressions`,`includeBrand`,`refresh`],{days:{description:`GSC lookback within the current 16-month retention.`},limit:{description:`Maximum source queries to convert. Defaults to 25.`},minImpressions:{description:`Minimum query impressions. Defaults to 20.`},includeBrand:{description:`Include branded queries in prompt generation.`},refresh:{description:`Bypass local GSC cache.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await pn({site:n.site,days:M(e.days,`--days`),startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),limit:M(e.limit,`--limit`),minImpressions:M(e[`min-impressions`],`--min-impressions`),maxRows:M(e[`max-rows`],`--max-rows`),brandTerms:[...n.client?.brandTerms??[],...N(e[`brand-terms`])??[]],includeBrand:A(e[`include-brand`]),refresh:A(e.refresh)});if(t){R(r);return}K({title:`SEO to AI query prompts`,target:r.site,status:r.dataStatus===`available`||r.dataStatus===`empty`?`info`:`unknown`,summary:r.summary.verdict,metrics:[{label:`Evidence`,value:r.dataStatus},{label:`Eligible queries`,value:W(r.summary.eligibleQueries)},{label:`Returned queries`,value:W(r.summary.returnedQueries)},{label:`Prompts`,value:W(r.summary.prompts)},{label:`GSC completeness`,value:r.source.completeness}]}),q([`Query`,`Impr`,`Prompt`],r.items.flatMap(e=>e.prompts.map(t=>[G(e.query,42),W(e.impressions),G(t,86)]))),Y(`Report caveats`,r.caveats),Y(`Warnings`,r.warnings)}}),md=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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=k(e),n=O(e.site),r=t?await U({project:t,options:{json:F(e)}}):void 0,i=t||n?void 0:await U({options:{json:F(e)}}),a=await tr({url:O(e.url)??``,site:r?.siteUrl??n??i?.siteUrl,js:A(e.js)?!0:`auto`,refresh:A(e.refresh)});if(F(e)){R(a);return}K({title:`Page audit`,target:a.url,status:a.issues.some(e=>e.severity===`high`)?`fail`:a.issues.length>0?`warning`:`pass`,summary:a.issues.length>0?`${a.issues.length} ${a.issues.length===1?`issue needs`:`issues need`} review.`:`No page issues were found by the available checks.`,metrics:[{label:`Final URL`,value:a.page.finalUrl},{label:`Title`,value:a.page.title??`Missing`},{label:`Meta description`,value:a.page.metaDescription??`Missing`},{label:`Words`,value:a.page.wordCount},{label:`Fetch`,value:Es(a.fetchDiagnostics)}],diagnostics:[{title:`Issues`,items:a.issues.map(e=>({status:e.severity===`high`?`fail`:`warning`,title:`${e.code}: ${e.principle}`,explanation:e.detail}))}]})}});function hd(e){let t=O(e)??`mobile`;if(t!==`mobile`&&t!==`desktop`)throw new C(`INVALID_INPUT`,`Invalid --strategy. Use mobile or desktop.`);return t}function gd(e){return e?e.displayValue??String(e.value??`not measured`):`not measured`}function _d(e){if(!e)return`not available`;let t=e.unit===`milliseconds`?`ms`:``;return`${e.p75}${t} (${e.rating})`}const vd=T({meta:{name:`perf`,description:`Audit lab performance and field Core Web Vitals`},subCommands:{audit:T({meta:{name:`audit`,description:`Run a Lighthouse/Core Web Vitals performance audit`},args:{url:{type:`string`,description:`URL to audit. Defaults to the selected project crawl URL.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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=F(e),n=await U({client:k(e),options:{json:t}}),r=O(e.url)??n?.startUrl;if(!r)throw Error(`No URL selected. Pass --url or use --project with a crawl URL.`);let i=await En({url:r,strategy:hd(e.strategy),lighthouseBin:O(e[`lighthouse-bin`]),cruxApiKey:O(e[`crux-key`]),refresh:A(e.refresh),includeRaw:t&&A(e.raw)});if(t){R(i);return}K({title:`Performance report`,target:i.url,status:i.dataStatus===`partial`?`unknown`:i.grade===`good`?`pass`:`warning`,summary:i.headline,metrics:[{label:`Source`,value:i.source},{label:`Strategy`,value:i.strategy},{label:`Lab score`,value:i.score===void 0?`Unknown`:`${i.score}/100`},{label:`Lab grade`,value:i.grade},{label:`Evidence`,value:i.dataStatus},{label:`FCP`,value:gd(i.metrics.firstContentfulPaint)},{label:`LCP`,value:gd(i.metrics.largestContentfulPaint)},{label:`TBT`,value:gd(i.metrics.totalBlockingTime)},{label:`CLS`,value:gd(i.metrics.cumulativeLayoutShift)},{label:`INP`,value:gd(i.metrics.interactionToNextPaint)},{label:`Server response`,value:gd(i.metrics.serverResponseTime)},{label:`Fallback fetch`,value:gd(i.metrics.fallbackFetchDuration)},{label:`Field data`,value:i.fieldData?`${i.fieldData.scope} ${i.fieldData.formFactor.toLowerCase()} (${i.fieldData.assessment.status})`:i.fieldDataStatus.status},{label:`Field LCP p75`,value:_d(i.fieldData?.metrics.largestContentfulPaint)},{label:`Field INP p75`,value:_d(i.fieldData?.metrics.interactionToNextPaint)},{label:`Field CLS p75`,value:_d(i.fieldData?.metrics.cumulativeLayoutShift)},{label:`Field period`,value:i.fieldData?.collectionPeriod?.firstDate&&i.fieldData.collectionPeriod.lastDate?`${i.fieldData.collectionPeriod.firstDate} to ${i.fieldData.collectionPeriod.lastDate}`:`Unavailable`}]}),J(`Top actions`,i.topActions.map(e=>({label:e.title,action:e.action,context:e.plainEnglish}))),Y(`Caveats`,i.caveats)}})}}),yd=T({meta:{name:`diagnose`,description:`Find where Google Search performance changed`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Baseline window length in days. Defaults to 90.`},limit:{description:`Maximum rows per diagnostic section. Defaults to 10.`}}),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await ut({site:n.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),refresh:A(e.refresh),progress:Gl(!t)});if(t){R(r);return}K({title:`SEO diagnosis`,target:r.site,status:r.dataStatus===`complete`?r.priorities.length>0?`warning`:`pass`:`unknown`,summary:r.priorities.length>0?`${r.priorities.length} priorities need review.`:`No priorities were returned by the available evidence.`,metrics:[{label:`Evidence`,value:r.dataStatus},{label:`Update overlap`,value:r.summary.updateAttribution.replaceAll(`-`,` `)},{label:`Significant anomalies`,value:r.summary.significantAnomalies},{label:`Update matches`,value:r.summary.updateMatches},{label:`Decay items`,value:r.summary.decayItems},{label:`Cannibal items`,value:r.summary.cannibalItems},{label:`Striking distance`,value:r.summary.strikingDistanceItems},{label:`Quick wins`,value:r.summary.quickWinItems}]}),B([`Priority`,`Confidence`,`Reason`,`Action`],r.priorities.map(e=>[e.label,e.confidence,e.reason,e.action])),r.skippedSections?.length&&B([`Skipped section`,`Reason`],r.skippedSections.map(e=>[e.section,e.reason])),J(`Priority action details`,r.priorities.map(e=>({label:e.label,context:e.confidence,action:e.action})))}}),bd=T({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 xe();if(F(e)){R(t),t.ok||(process.exitCode=1);return}Do(`SEO doctor`,vo(t.checks)),process.stdout.write(`
+`),Oo(t.checks),process.stdout.write(`\nChecked ${t.generatedAt}\n`),t.ok||(process.exitCode=1)}}),xd=e=>{let t=O(e)??`page`;if(t!==`page`&&t!==`query`&&t!==`country`&&t!==`device`)throw Error(`Invalid --dimension. Use page, query, country, or device.`);return t},Sd=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},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=F(e),n=xd(e.dimension),r=M(e.days,`--days`),i=M(e.compare,`--compare`),a=M(e.limit,`--limit`),o=M(e[`unmatched-limit`],`--unmatched-limit`),s=M(e[`max-rows`],`--max-rows`),c=await Qt({site:(await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}})).site,dimension:n,days:r,compareDays:i,startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),limit:a,unmatchedLimit:o,maxRows:s,refresh:A(e.refresh)});if(t){R(c);return}K({title:`Segment impact`,target:c.site,status:c.dataStatus===`complete`?`info`:`unknown`,summary:c.summary.verdict,metrics:[{label:`Dimension`,value:c.dimension},{label:`Evidence`,value:c.dataStatus},{label:`Before`,value:`${c.before.startDate} to ${c.before.endDate}`},{label:`After`,value:`${c.after.startDate} to ${c.after.endDate}`}]}),B([`Segment`,`Clicks before`,`Clicks after`,`Delta`,`Pos delta`],c.items.map(e=>[e.key,e.beforeClicks,e.afterClicks,e.clickDelta,e.positionDelta??`-`])),c.unmatchedSegments.length&&(process.stdout.write(`
 One-window evidence (not treated as zero)
-`),B([`Segment`,`Retained in`,`Clicks`,`Impressions`],c.unmatchedSegments.map(e=>[e.key,e.retainedIn,e.clicks,e.impressions]))),Y(`Warnings`,c.warnings)}});function xd(e){return`${W(e)} ${e===1?`row`:`rows`}`}const Sd=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...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=F(e),n=j(e[`verify-limit`]),r=A(e[`verify-content`])===!0||n!==void 0,i=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),a=await St({site:i.site,days:j(e.days),minImpressions:j(e[`min-impressions`]),limit:j(e.limit),brandTerms:i.client?.brandTerms,includeBrand:A(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:A(e.js)?!0:void 0,rate:Ba(e),refresh:A(e.refresh)});if(t){R(a);return}if(K({title:`Striking-distance opportunities`,target:a.site,status:a.source.possiblyTruncated?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible rows`,value:W(a.summary.eligibleRows)},{label:`Returned rows`,value:W(a.summary.returnedRows)},{label:`Template groups`,value:W(a.summary.groups)},{label:`Impressions`,value:W(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),W(e.rowCount),W(e.uniqueUrls),W(e.totalImpressions),is(e.impressionWeightedPosition),e.actionScope,G(e.recommendation.action,72)])),J(`Top striking-distance group actions`,a.groups.map(e=>({label:e.label,context:`${xd(e.rowCount)}, ${W(e.totalImpressions)} impressions`,action:e.recommendation.action})))),!a.items.length){process.stdout.write(`No striking-distance opportunities matched these filters.
-`);return}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),W(e.impressions),as(e.ctr),is(e.position),e.priority.score,ws(e.contentVerification?.fetchDiagnostics),Ts(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 ${is(e.position)}, ${W(e.impressions)} impressions`,action:e.recommendation.action})))}});function Cd(e){return e===`keychain`?`system keychain`:e===`file`?`private local file`:e??`missing`}function Z(e){return e===null?`unavailable`:`$${(e/1e6).toFixed(2)}`}function wd(e,t,n={}){if(e===void 0)return;if(O(e)?.trim().toLowerCase()===`off`)return n.notice?0:null;let r=j(e);if(r===void 0||r<0||r>1e6)throw new C(`INVALID_INPUT`,`${t} must be a USD amount from 0 to 1000000, or off.`);let i=Math.round(r*1e6);if(!Number.isSafeInteger(i))throw new C(`INVALID_INPUT`,`${t} is too precise.`);return i}function Td(e,t,n,r){if(e===void 0)return;let i=j(e);if(i===void 0||!Number.isInteger(i)||i<n||i>r)throw new C(`INVALID_INPUT`,`${t} must be an integer from ${n} to ${r}.`);return i}function Ed(e){return T({meta:{name:`limits`,description:`Show or change local ${e.displayName} spend limits`},args:{"daily-notice":{type:`string`,description:`UTC daily notice in USD, or off.`},"daily-limit":{type:`string`,description:`UTC daily hard limit in USD, or off.`},"monthly-limit":{type:`string`,description:`UTC monthly hard limit in USD, or off.`},requests:{type:`string`,description:`Maximum provider requests in one report run.`},rows:{type:`string`,description:`Maximum requested provider rows in one report run.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:t})=>{let n=pt(e.provider),r=wd(t[`daily-notice`],`--daily-notice`,{notice:!0}),i=wd(t[`daily-limit`],`--daily-limit`),a=wd(t[`monthly-limit`],`--monthly-limit`),o=Td(t.requests,`--requests`,1,100),s=Td(t.rows,`--rows`,1,1e5),c=[r,i,a,o,s].some(e=>e!==void 0),l=c?de(e.provider,{dailyNoticeMicros:r===void 0?n.dailyNoticeMicros:r,dailyHardLimitMicros:i===void 0?n.dailyHardLimitMicros:i,monthlyHardLimitMicros:a===void 0?n.monthlyHardLimitMicros:a,maxRequestsPerReport:o??n.maxRequestsPerReport,maxRowsPerReport:s??n.maxRowsPerReport}):n,u={provider:e.provider,changed:c,limits:l};if(F(t)){R(u);return}z([[`UTC daily notice`,l.dailyNoticeMicros===0?`off`:Z(l.dailyNoticeMicros)],[`UTC daily hard limit`,l.dailyHardLimitMicros===null?`off`:Z(l.dailyHardLimitMicros)],[`UTC monthly hard limit`,l.monthlyHardLimitMicros===null?`off`:Z(l.monthlyHardLimitMicros)],[`Requests per report`,String(l.maxRequestsPerReport)],[`Rows per report`,String(l.maxRowsPerReport)]])}})}function Dd(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 Od=T({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(!L({json:F(e)}))throw new C(`AUTH_REQUIRED`,`Run \`seo providers ahrefs connect\` in a terminal. Agents and CI can set ${Mr}.`);Di(`Connect Ahrefs`),E(`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=V(await Mi({message:`Ahrefs API v3 key`,validate:e=>e?.trim()?void 0:`API key is required`})),n=await new br({apiKey:t}).limitsAndUsage(),r=await tt(t);E(`${n.subscription} subscription. API key units: ${Dd(n.apiKeyUnits)}.`,`Connection verified`),ji(`Saved in the ${Cd(r)}. Run seo providers ahrefs status --check to verify it again.`)}}),kd=T({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 Or(),n=!!e.check,r=n&&t?await new br().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`}};if(F(e)){R(i);return}z([[`Connected`,i.connected?`yes`:`no`],[`API version`,i.apiVersion?`Version 3`:`not connected`],[`Credential`,Cd(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`,Dd(r.apiKeyUnits)],[`Workspace units`,Dd(r.workspaceUnits)],[`Usage resets`,r.usageResetsAt],[`Key expires`,r.apiKeyExpiresAt]]:[]])}}),Ad=T({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 Ht();let t=!!process.env[Mr]?.trim(),n={savedCredentialRemoved:!0,environmentCredential:t?`active`:`missing`,note:t?`The environment variable was not changed. Clear ${Mr} to fully disconnect.`:`Ahrefs is disconnected.`};F(e)?R(n):process.stdout.write(`${n.note}\n`)}}),jd=T({meta:{name:`ahrefs`,description:`Connect Ahrefs for optional search and link data`},subCommands:{connect:Od,status:kd,limits:T({meta:{name:`limits`,description:`Show or change local Ahrefs report work limits`},args:{requests:{type:`string`,description:`Maximum Ahrefs requests in one report run.`},rows:{type:`string`,description:`Maximum requested Ahrefs rows in one report run.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=pt(`ahrefs`),n=Td(e.requests,`--requests`,1,100),r=Td(e.rows,`--rows`,1,1e5),i=n!==void 0||r!==void 0,a=i?de(`ahrefs`,{...t,maxRequestsPerReport:n??t.maxRequestsPerReport,maxRowsPerReport:r??t.maxRowsPerReport}):t,o={provider:`ahrefs`,maxRequestsPerReport:a.maxRequestsPerReport,maxRowsPerReport:a.maxRowsPerReport,changed:i,note:`Paid requests also preflight the live API-unit balance and enforce fixed per-request and per-report unit caps.`};if(F(e)){R(o);return}z([[`Requests per report`,String(o.maxRequestsPerReport)],[`Rows per report`,String(o.maxRowsPerReport)],[`Changed`,o.changed?`yes`:`no`],[`Note`,o.note]])}}),disconnect:Ad}});function Md(e){return e.filter(e=>e.isVerified)}function Nd(e){if(e.startsWith(`sc-domain:`))return e.slice(10).replace(/^www\./,``).toLowerCase();try{return new URL(e).hostname.replace(/^www\./,``).toLowerCase()}catch{return}}function Pd(e,t){let n=Nd(e);if(!n)return;let r=Md(t).filter(e=>Nd(e.url)===n);return r.length===1?r[0]:void 0}async function Fd(e){let t=Md(e.sites),n=e.explicitSite??e.savedSite;if(n){let e=t.find(e=>e.url===n);if(!e)throw new C(`PROPERTY_NOT_FOUND`,`Bing Webmaster did not return a verified site matching ${n}.`);return e.url}let r=e.projectSite?Pd(e.projectSite,t):void 0;if(r)return r.url;if(t.length===1)return t[0]?.url;if(t.length!==0){if(!L({json:e.json}))throw new C(`INVALID_INPUT`,`Several verified Bing sites are available. Pass --site to choose one.`);return V(await Ni({message:`Choose a verified Bing Webmaster site`,options:t.map(e=>({value:e.url,label:e.url}))}))}}const Id={project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},site:{type:`string`,description:`Verified Bing Webmaster site URL.`}},Ld=T({meta:{name:`bing`,description:`Connect and report on Bing Webmaster`},subCommands:{connect:T({meta:{name:`connect`,description:`Connect Bing Webmaster and attach a verified site`},args:{...Id,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e);if(!L({json:t}))throw new C(`AUTH_REQUIRED`,"Run `seo providers bing connect` in a terminal. Agents and CI can set SEO_BING_API_KEY and run the report directly.");Di(`Connect Bing Webmaster`),E(`Paste the API key from Bing Webmaster Tools Settings, then API Access. The key stays on this machine.`,`API key`);let n=V(await Mi({message:`Bing Webmaster API key`,validate:e=>e?.trim()?void 0:`API key is required`})),r=await new An({apiKey:n}).listSites(),i=await U({project:k(e),options:{json:t}}),a=await Fd({explicitSite:O(e.site),projectSite:i?.siteUrl,savedSite:_e(i),sites:r.sites,json:t});if(!a)throw new C(`PROPERTY_NOT_FOUND`,`No verified Bing Webmaster sites were found for this API key.`);await Ze(sr,n);let o=i?zn(i.id,a):void 0;E(`${a}${o?` is attached to ${o.name}.`:` is ready for direct reports.`}`,`Bing connected`),ji(o?`Run seo providers bing report --project ${o.id}`:`Run seo providers bing report --site ${a}`)}}),status:T({meta:{name:`status`,description:`Show the local Bing connection`},args:{project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await De({name:sr,envVar:Wn}),n=await U({project:k(e),options:{json:F(e)}}),r={connected:!!t,credentialSource:t?.source,project:n?{id:n.id,name:n.name,site:_e(n)}:void 0};if(F(e)){R(r);return}z([[`Connected`,r.connected?`yes`:`no`],[`Credential`,r.credentialSource??`missing`],[`Project`,r.project?.name??`not selected`],[`Bing site`,r.project?.site??`not attached`]])}}),disconnect:T({meta:{name:`disconnect`,description:`Remove the saved Bing Webmaster credential`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await he(sr);let t={disconnected:!0,note:`Saved project site mappings were kept for a later reconnect.`};F(e)?R(t):process.stdout.write(`${t.note}\n`)}}),sites:T({meta:{name:`sites`,description:`List Bing Webmaster sites`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let{client:t,credentialSource:n}=await Kt(),r=await t.listSites(),i={...r,credentialSource:n};if(F(e)){R(i);return}B([`Site`,`Verified`],r.sites.map(e=>[e.url,e.isVerified?`yes`:`no`]))}}),report:T({meta:{name:`report`,description:`Find Bing traffic, crawl, query, and page insights`},args:{...Id,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await U({project:k(e),options:{json:t}}),r=O(e.site)??_e(n);if(!r)throw new C(`INVALID_INPUT`,`Pass --site or connect Bing Webmaster to a saved project first.`);let i=await zt({site:r});if(t){R(i);return}let a=i.traffic.status===`unavailable`?void 0:i.traffic.data,o=i.crawl.status===`unavailable`?void 0:i.crawl.data,s=a?.analysis;K({title:`Bing Webmaster report`,target:i.site,status:i.dataStatus===`complete`?i.summary.warnings>0?`warning`:`pass`:`unknown`,summary:i.summary.findings>0?`${i.summary.findings} findings need review across Bing traffic and crawl evidence.`:`No findings were returned by the available Bing evidence.`,metrics:[{label:`Evidence`,value:i.dataStatus},{label:`28-day clicks`,value:s?.current.clicks??`Unavailable`},{label:`Click change`,value:s?.changes.clicksPercent===null||s?.changes.clicksPercent===void 0?`Unavailable`:`${s.changes.clicksPercent.toFixed(1)}%`},{label:`28-day impressions`,value:s?.current.impressions??`Unavailable`},{label:`Impression change`,value:s?.changes.impressionsPercent===null||s?.changes.impressionsPercent===void 0?`Unavailable`:`${s.changes.impressionsPercent.toFixed(1)}%`},{label:`Crawled pages`,value:o?.latest?.crawledPages??`Unavailable`},{label:`4xx responses`,value:o?.latest?.code4xx??`Unavailable`},{label:`Findings`,value:i.summary.findings}],diagnostics:[{title:`Review first`,items:i.findings.slice(0,5).map(e=>({status:e.severity===`warning`?`warning`:`info`,title:e.title,explanation:e.interpretation,evidence:[e.verification]}))}],notes:i.caveats})}})}}),Rd=T({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(!L({json:F(e)}))throw new C(`AUTH_REQUIRED`,`Run \`seo providers dataforseo connect\` in a terminal. Agents and CI can set ${xn} and ${je}.`);Di(`Connect DataForSEO`),E(`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=V(await Pi({message:`DataForSEO API login`,validate:e=>e?.trim()?void 0:`API login is required`})),n=V(await Mi({message:`DataForSEO API password`,validate:e=>e?void 0:`API password is required`})),r={login:t.trim(),password:n},i=await new o({credentials:()=>r}).userData(),a=await ie(r);E(`${i.login} is connected with an account balance of ${Z(i.balanceMicros)}.`,`Connection verified`),ji(`Saved in the ${Cd(a)}. Run seo providers dataforseo status --check to verify it again.`)}}),zd=T({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 Ue(),n=!!e.check,r=n&&t?await new o().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`}};if(F(e)){R(i);return}z([[`Connected`,i.connected?`yes`:`no`],[`Credential`,Cd(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`,Z(r.balanceMicros)]]:[]])}}),Bd=T({meta:{name:`disconnect`,description:`Remove saved DataForSEO credentials`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await Fe();let t=!!process.env[xn]?.trim(),n=!!process.env[je],r={savedCredentialsRemoved:!0,environmentCredentials:t&&n?`active`:t||n?`partial`:`missing`,note:t||n?`Environment variables were not changed. Clear ${xn} and ${je} to fully disconnect.`:`DataForSEO is disconnected.`};F(e)?R(r):process.stdout.write(`${r.note}\n`)}}),Vd=T({meta:{name:`dataforseo`,description:`Connect DataForSEO for optional search data`},subCommands:{connect:Rd,status:zd,limits:Ed({provider:`dataforseo`,displayName:`DataForSEO`}),spend:T({meta:{name:`spend`,description:`Show local DataForSEO spend and account context`},args:{account:Fa(`Read account-wide context from the free endpoint.`,`Show only the local spend ledger.`),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=u(`dataforseo`),n=e.account?await Ue():void 0,r;if(!e.account)r={status:`not-requested`};else if(!n)r={status:`unavailable`,reason:`DataForSEO is not connected. Local spend remains available without account context.`};else try{let e=await new o().userData();r={status:`observed`,account:e.login,balanceMicros:e.balanceMicros,dailySpendMicros:e.accountDailySpendMicros,dailySpendPeriod:e.accountDailySpendPeriod,dailyLimitMicros:e.accountDailyLimitMicros,observedAt:e.observedAt,requestCostMicros:e.requestCostMicros,semantics:`Account values include every client using these credentials. Local values include only requests recorded by this installation.`}}catch(e){r={status:`unavailable`,reason:e instanceof Error?e.message:`DataForSEO account context is unavailable.`}}let i={local:t,account:r};if(F(e)){R(i);return}z([[`Local today (UTC)`,`${Z(t.today.effectiveCostMicros)} across ${t.today.requests} requests`],[`Local month (UTC)`,`${Z(t.month.effectiveCostMicros)} across ${t.month.requests} requests`],[`Unknown local cost`,Z(t.month.estimatedOrUnknownCostMicros)],[`Account today`,r.status===`observed`?Z(r.dailySpendMicros):r.status===`unavailable`?r.reason:`not requested`],[`Account balance`,r.status===`observed`?Z(r.balanceMicros):`unavailable`]]),r.status===`observed`&&process.stdout.write(`${r.semantics}\n`)}}),disconnect:Bd}});function Hd(e){if(!e)return{};let t;try{t=JSON.parse(e)}catch{throw new C(`INVALID_INPUT`,`--account must be a JSON object.`)}if(!t||Array.isArray(t)||typeof t!=`object`)throw new C(`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 C(`INVALID_INPUT`,`--account must contain at most 20 bounded string fields.`);return Object.fromEntries(n.map(([e,t])=>[e,t.trim()]))}function Ud(e){if(!e)return{};let t;try{t=JSON.parse(e)}catch{throw new C(`INVALID_INPUT`,`--params must be a JSON object.`)}if(!t||Array.isArray(t)||typeof t!=`object`)throw new C(`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)>64*1024)throw new C(`INVALID_INPUT`,`--params must be a JSON object smaller than 64 KiB.`);return Object.fromEntries(n)}async function Wd(e){let t=await ue(),n=t.registry.get(e);if(n)return n;let r=t.failures.find(t=>t.id===e);throw r?new C(`INVALID_INPUT`,`Provider ${e} could not load: ${r.message}`):new C(`INVALID_INPUT`,`Provider ${e} is not installed.`)}function Gd(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 C(`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 C(`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 C(`INVALID_INPUT`,`${t.label} is required.`);return i}async function Kd(){return i()}const qd={list:T({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 Kd();if(F(e)){R(t);return}t.installed.length>0?B([`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.
+`),B([`Segment`,`Retained in`,`Clicks`,`Impressions`],c.unmatchedSegments.map(e=>[e.key,e.retainedIn,e.clicks,e.impressions]))),Y(`Warnings`,c.warnings)}});function Cd(e){return`${W(e)} ${e===1?`row`:`rows`}`}const wd=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...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=F(e),n=j(e[`verify-limit`]),r=A(e[`verify-content`])===!0||n!==void 0,i=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),a=await St({site:i.site,days:j(e.days),minImpressions:j(e[`min-impressions`]),limit:j(e.limit),brandTerms:i.client?.brandTerms,includeBrand:A(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:A(e.js)?!0:void 0,rate:Ba(e),refresh:A(e.refresh)});if(t){R(a);return}if(K({title:`Striking-distance opportunities`,target:a.site,status:a.source.possiblyTruncated?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible rows`,value:W(a.summary.eligibleRows)},{label:`Returned rows`,value:W(a.summary.returnedRows)},{label:`Template groups`,value:W(a.summary.groups)},{label:`Impressions`,value:W(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),W(e.rowCount),W(e.uniqueUrls),W(e.totalImpressions),is(e.impressionWeightedPosition),e.actionScope,G(e.recommendation.action,72)])),J(`Top striking-distance group actions`,a.groups.map(e=>({label:e.label,context:`${Cd(e.rowCount)}, ${W(e.totalImpressions)} impressions`,action:e.recommendation.action})))),!a.items.length){process.stdout.write(`No striking-distance opportunities matched these filters.
+`);return}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),W(e.impressions),as(e.ctr),is(e.position),e.priority.score,Es(e.contentVerification?.fetchDiagnostics),Ds(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 ${is(e.position)}, ${W(e.impressions)} impressions`,action:e.recommendation.action})))}});function Td(e){return e===`keychain`?`system keychain`:e===`file`?`private local file`:e??`missing`}function Z(e){return e===null?`unavailable`:`$${(e/1e6).toFixed(2)}`}function Ed(e,t,n={}){if(e===void 0)return;if(O(e)?.trim().toLowerCase()===`off`)return n.notice?0:null;let r=j(e);if(r===void 0||r<0||r>1e6)throw new C(`INVALID_INPUT`,`${t} must be a USD amount from 0 to 1000000, or off.`);let i=Math.round(r*1e6);if(!Number.isSafeInteger(i))throw new C(`INVALID_INPUT`,`${t} is too precise.`);return i}function Dd(e,t,n,r){if(e===void 0)return;let i=j(e);if(i===void 0||!Number.isInteger(i)||i<n||i>r)throw new C(`INVALID_INPUT`,`${t} must be an integer from ${n} to ${r}.`);return i}function Od(e){return T({meta:{name:`limits`,description:`Show or change local ${e.displayName} spend limits`},args:{"daily-notice":{type:`string`,description:`UTC daily notice in USD, or off.`},"daily-limit":{type:`string`,description:`UTC daily hard limit in USD, or off.`},"monthly-limit":{type:`string`,description:`UTC monthly hard limit in USD, or off.`},requests:{type:`string`,description:`Maximum provider requests in one report run.`},rows:{type:`string`,description:`Maximum requested provider rows in one report run.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:t})=>{let n=pt(e.provider),r=Ed(t[`daily-notice`],`--daily-notice`,{notice:!0}),i=Ed(t[`daily-limit`],`--daily-limit`),a=Ed(t[`monthly-limit`],`--monthly-limit`),o=Dd(t.requests,`--requests`,1,100),s=Dd(t.rows,`--rows`,1,1e5),c=[r,i,a,o,s].some(e=>e!==void 0),l=c?de(e.provider,{dailyNoticeMicros:r===void 0?n.dailyNoticeMicros:r,dailyHardLimitMicros:i===void 0?n.dailyHardLimitMicros:i,monthlyHardLimitMicros:a===void 0?n.monthlyHardLimitMicros:a,maxRequestsPerReport:o??n.maxRequestsPerReport,maxRowsPerReport:s??n.maxRowsPerReport}):n,u={provider:e.provider,changed:c,limits:l};if(F(t)){R(u);return}z([[`UTC daily notice`,l.dailyNoticeMicros===0?`off`:Z(l.dailyNoticeMicros)],[`UTC daily hard limit`,l.dailyHardLimitMicros===null?`off`:Z(l.dailyHardLimitMicros)],[`UTC monthly hard limit`,l.monthlyHardLimitMicros===null?`off`:Z(l.monthlyHardLimitMicros)],[`Requests per report`,String(l.maxRequestsPerReport)],[`Rows per report`,String(l.maxRowsPerReport)]])}})}function kd(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 Ad=T({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(!L({json:F(e)}))throw new C(`AUTH_REQUIRED`,`Run \`seo providers ahrefs connect\` in a terminal. Agents and CI can set ${Mr}.`);Di(`Connect Ahrefs`),E(`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=V(await Mi({message:`Ahrefs API v3 key`,validate:e=>e?.trim()?void 0:`API key is required`})),n=await new br({apiKey:t}).limitsAndUsage(),r=await tt(t);E(`${n.subscription} subscription. API key units: ${kd(n.apiKeyUnits)}.`,`Connection verified`),ji(`Saved in the ${Td(r)}. Run seo providers ahrefs status --check to verify it again.`)}}),jd=T({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 Or(),n=!!e.check,r=n&&t?await new br().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`}};if(F(e)){R(i);return}z([[`Connected`,i.connected?`yes`:`no`],[`API version`,i.apiVersion?`Version 3`:`not connected`],[`Credential`,Td(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`,kd(r.apiKeyUnits)],[`Workspace units`,kd(r.workspaceUnits)],[`Usage resets`,r.usageResetsAt],[`Key expires`,r.apiKeyExpiresAt]]:[]])}}),Md=T({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 Ht();let t=!!process.env[Mr]?.trim(),n={savedCredentialRemoved:!0,environmentCredential:t?`active`:`missing`,note:t?`The environment variable was not changed. Clear ${Mr} to fully disconnect.`:`Ahrefs is disconnected.`};F(e)?R(n):process.stdout.write(`${n.note}\n`)}}),Nd=T({meta:{name:`ahrefs`,description:`Connect Ahrefs for optional search and link data`},subCommands:{connect:Ad,status:jd,limits:T({meta:{name:`limits`,description:`Show or change local Ahrefs report work limits`},args:{requests:{type:`string`,description:`Maximum Ahrefs requests in one report run.`},rows:{type:`string`,description:`Maximum requested Ahrefs rows in one report run.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=pt(`ahrefs`),n=Dd(e.requests,`--requests`,1,100),r=Dd(e.rows,`--rows`,1,1e5),i=n!==void 0||r!==void 0,a=i?de(`ahrefs`,{...t,maxRequestsPerReport:n??t.maxRequestsPerReport,maxRowsPerReport:r??t.maxRowsPerReport}):t,o={provider:`ahrefs`,maxRequestsPerReport:a.maxRequestsPerReport,maxRowsPerReport:a.maxRowsPerReport,changed:i,note:`Paid requests also preflight the live API-unit balance and enforce fixed per-request and per-report unit caps.`};if(F(e)){R(o);return}z([[`Requests per report`,String(o.maxRequestsPerReport)],[`Rows per report`,String(o.maxRowsPerReport)],[`Changed`,o.changed?`yes`:`no`],[`Note`,o.note]])}}),disconnect:Md}});function Pd(e){return e.filter(e=>e.isVerified)}function Fd(e){if(e.startsWith(`sc-domain:`))return e.slice(10).replace(/^www\./,``).toLowerCase();try{return new URL(e).hostname.replace(/^www\./,``).toLowerCase()}catch{return}}function Id(e,t){let n=Fd(e);if(!n)return;let r=Pd(t).filter(e=>Fd(e.url)===n);return r.length===1?r[0]:void 0}async function Ld(e){let t=Pd(e.sites),n=e.explicitSite??e.savedSite;if(n){let e=t.find(e=>e.url===n);if(!e)throw new C(`PROPERTY_NOT_FOUND`,`Bing Webmaster did not return a verified site matching ${n}.`);return e.url}let r=e.projectSite?Id(e.projectSite,t):void 0;if(r)return r.url;if(t.length===1)return t[0]?.url;if(t.length!==0){if(!L({json:e.json}))throw new C(`INVALID_INPUT`,`Several verified Bing sites are available. Pass --site to choose one.`);return V(await Ni({message:`Choose a verified Bing Webmaster site`,options:t.map(e=>({value:e.url,label:e.url}))}))}}const Rd={project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},site:{type:`string`,description:`Verified Bing Webmaster site URL.`}},zd=T({meta:{name:`bing`,description:`Connect and report on Bing Webmaster`},subCommands:{connect:T({meta:{name:`connect`,description:`Connect Bing Webmaster and attach a verified site`},args:{...Rd,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e);if(!L({json:t}))throw new C(`AUTH_REQUIRED`,"Run `seo providers bing connect` in a terminal. Agents and CI can set SEO_BING_API_KEY and run the report directly.");Di(`Connect Bing Webmaster`),E(`Paste the API key from Bing Webmaster Tools Settings, then API Access. The key stays on this machine.`,`API key`);let n=V(await Mi({message:`Bing Webmaster API key`,validate:e=>e?.trim()?void 0:`API key is required`})),r=await new An({apiKey:n}).listSites(),i=await U({project:k(e),options:{json:t}}),a=await Ld({explicitSite:O(e.site),projectSite:i?.siteUrl,savedSite:_e(i),sites:r.sites,json:t});if(!a)throw new C(`PROPERTY_NOT_FOUND`,`No verified Bing Webmaster sites were found for this API key.`);await Ze(sr,n);let o=i?zn(i.id,a):void 0;E(`${a}${o?` is attached to ${o.name}.`:` is ready for direct reports.`}`,`Bing connected`),ji(o?`Run seo providers bing report --project ${o.id}`:`Run seo providers bing report --site ${a}`)}}),status:T({meta:{name:`status`,description:`Show the local Bing connection`},args:{project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await De({name:sr,envVar:Wn}),n=await U({project:k(e),options:{json:F(e)}}),r={connected:!!t,credentialSource:t?.source,project:n?{id:n.id,name:n.name,site:_e(n)}:void 0};if(F(e)){R(r);return}z([[`Connected`,r.connected?`yes`:`no`],[`Credential`,r.credentialSource??`missing`],[`Project`,r.project?.name??`not selected`],[`Bing site`,r.project?.site??`not attached`]])}}),disconnect:T({meta:{name:`disconnect`,description:`Remove the saved Bing Webmaster credential`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await he(sr);let t={disconnected:!0,note:`Saved project site mappings were kept for a later reconnect.`};F(e)?R(t):process.stdout.write(`${t.note}\n`)}}),sites:T({meta:{name:`sites`,description:`List Bing Webmaster sites`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let{client:t,credentialSource:n}=await Kt(),r=await t.listSites(),i={...r,credentialSource:n};if(F(e)){R(i);return}B([`Site`,`Verified`],r.sites.map(e=>[e.url,e.isVerified?`yes`:`no`]))}}),report:T({meta:{name:`report`,description:`Find Bing traffic, crawl, query, and page insights`},args:{...Rd,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await U({project:k(e),options:{json:t}}),r=O(e.site)??_e(n);if(!r)throw new C(`INVALID_INPUT`,`Pass --site or connect Bing Webmaster to a saved project first.`);let i=await zt({site:r});if(t){R(i);return}let a=i.traffic.status===`unavailable`?void 0:i.traffic.data,o=i.crawl.status===`unavailable`?void 0:i.crawl.data,s=a?.analysis;K({title:`Bing Webmaster report`,target:i.site,status:i.dataStatus===`complete`?i.summary.warnings>0?`warning`:`pass`:`unknown`,summary:i.summary.findings>0?`${i.summary.findings} findings need review across Bing traffic and crawl evidence.`:`No findings were returned by the available Bing evidence.`,metrics:[{label:`Evidence`,value:i.dataStatus},{label:`28-day clicks`,value:s?.current.clicks??`Unavailable`},{label:`Click change`,value:s?.changes.clicksPercent===null||s?.changes.clicksPercent===void 0?`Unavailable`:`${s.changes.clicksPercent.toFixed(1)}%`},{label:`28-day impressions`,value:s?.current.impressions??`Unavailable`},{label:`Impression change`,value:s?.changes.impressionsPercent===null||s?.changes.impressionsPercent===void 0?`Unavailable`:`${s.changes.impressionsPercent.toFixed(1)}%`},{label:`Crawled pages`,value:o?.latest?.crawledPages??`Unavailable`},{label:`4xx responses`,value:o?.latest?.code4xx??`Unavailable`},{label:`Findings`,value:i.summary.findings}],diagnostics:[{title:`Review first`,items:i.findings.slice(0,5).map(e=>({status:e.severity===`warning`?`warning`:`info`,title:e.title,explanation:e.interpretation,evidence:[e.verification]}))}],notes:i.caveats})}})}}),Bd=T({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(!L({json:F(e)}))throw new C(`AUTH_REQUIRED`,`Run \`seo providers dataforseo connect\` in a terminal. Agents and CI can set ${xn} and ${je}.`);Di(`Connect DataForSEO`),E(`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=V(await Pi({message:`DataForSEO API login`,validate:e=>e?.trim()?void 0:`API login is required`})),n=V(await Mi({message:`DataForSEO API password`,validate:e=>e?void 0:`API password is required`})),r={login:t.trim(),password:n},i=await new o({credentials:()=>r}).userData(),a=await ie(r);E(`${i.login} is connected with an account balance of ${Z(i.balanceMicros)}.`,`Connection verified`),ji(`Saved in the ${Td(a)}. Run seo providers dataforseo status --check to verify it again.`)}}),Vd=T({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 Ue(),n=!!e.check,r=n&&t?await new o().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`}};if(F(e)){R(i);return}z([[`Connected`,i.connected?`yes`:`no`],[`Credential`,Td(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`,Z(r.balanceMicros)]]:[]])}}),Hd=T({meta:{name:`disconnect`,description:`Remove saved DataForSEO credentials`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await Fe();let t=!!process.env[xn]?.trim(),n=!!process.env[je],r={savedCredentialsRemoved:!0,environmentCredentials:t&&n?`active`:t||n?`partial`:`missing`,note:t||n?`Environment variables were not changed. Clear ${xn} and ${je} to fully disconnect.`:`DataForSEO is disconnected.`};F(e)?R(r):process.stdout.write(`${r.note}\n`)}}),Ud=T({meta:{name:`dataforseo`,description:`Connect DataForSEO for optional search data`},subCommands:{connect:Bd,status:Vd,limits:Od({provider:`dataforseo`,displayName:`DataForSEO`}),spend:T({meta:{name:`spend`,description:`Show local DataForSEO spend and account context`},args:{account:Fa(`Read account-wide context from the free endpoint.`,`Show only the local spend ledger.`),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=u(`dataforseo`),n=e.account?await Ue():void 0,r;if(!e.account)r={status:`not-requested`};else if(!n)r={status:`unavailable`,reason:`DataForSEO is not connected. Local spend remains available without account context.`};else try{let e=await new o().userData();r={status:`observed`,account:e.login,balanceMicros:e.balanceMicros,dailySpendMicros:e.accountDailySpendMicros,dailySpendPeriod:e.accountDailySpendPeriod,dailyLimitMicros:e.accountDailyLimitMicros,observedAt:e.observedAt,requestCostMicros:e.requestCostMicros,semantics:`Account values include every client using these credentials. Local values include only requests recorded by this installation.`}}catch(e){r={status:`unavailable`,reason:e instanceof Error?e.message:`DataForSEO account context is unavailable.`}}let i={local:t,account:r};if(F(e)){R(i);return}z([[`Local today (UTC)`,`${Z(t.today.effectiveCostMicros)} across ${t.today.requests} requests`],[`Local month (UTC)`,`${Z(t.month.effectiveCostMicros)} across ${t.month.requests} requests`],[`Unknown local cost`,Z(t.month.estimatedOrUnknownCostMicros)],[`Account today`,r.status===`observed`?Z(r.dailySpendMicros):r.status===`unavailable`?r.reason:`not requested`],[`Account balance`,r.status===`observed`?Z(r.balanceMicros):`unavailable`]]),r.status===`observed`&&process.stdout.write(`${r.semantics}\n`)}}),disconnect:Hd}});function Wd(e){if(!e)return{};let t;try{t=JSON.parse(e)}catch{throw new C(`INVALID_INPUT`,`--account must be a JSON object.`)}if(!t||Array.isArray(t)||typeof t!=`object`)throw new C(`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 C(`INVALID_INPUT`,`--account must contain at most 20 bounded string fields.`);return Object.fromEntries(n.map(([e,t])=>[e,t.trim()]))}function Gd(e){if(!e)return{};let t;try{t=JSON.parse(e)}catch{throw new C(`INVALID_INPUT`,`--params must be a JSON object.`)}if(!t||Array.isArray(t)||typeof t!=`object`)throw new C(`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)>64*1024)throw new C(`INVALID_INPUT`,`--params must be a JSON object smaller than 64 KiB.`);return Object.fromEntries(n)}async function Kd(e){let t=await ue(),n=t.registry.get(e);if(n)return n;let r=t.failures.find(t=>t.id===e);throw r?new C(`INVALID_INPUT`,`Provider ${e} could not load: ${r.message}`):new C(`INVALID_INPUT`,`Provider ${e} is not installed.`)}function qd(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 C(`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 C(`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 C(`INVALID_INPUT`,`${t.label} is required.`);return i}async function Jd(){return i()}const Yd={list:T({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 Jd();if(F(e)){R(t);return}t.installed.length>0?B([`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:T({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=await Cn(O(e.id)??``);if(F(e)){R(t);return}z([[`Provider`,t.displayName],[`Package`,`${t.package}@${t.version}`],[`Description`,t.description],[`Capabilities`,t.capabilities.map(e=>e.id).join(`, `)||`none`],[`Actions`,t.actions.map(e=>e.id).join(`, `)||`none`]])}}),install:T({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=O(e.package)??``,n=F(e),r=A(e.yes),i=L({json:n});if(!r&&!i)throw new C(`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 b(t)}catch(e){throw new C(`INVALID_INPUT`,e instanceof Error?e.message:String(e))}if(!r&&(Di(`Install provider package`),E([`${a.package}@${a.version}`,`Publisher: ${a.publisher??`not supplied by npm`}`,`Repository: ${a.repository??`not supplied by npm`}`,`Integrity: ${a.integrity}`].join(`
-`),`Package`),E(`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`),!V(await Ei({message:`Install ${a.package}@${a.version}?`,initialValue:!1})))){ji(`Provider was not installed.`);return}let o;try{o=await g(a)}catch(e){throw new C(`PROVIDER_UNAVAILABLE`,e instanceof Error?e.message:String(e))}let s={installed:o,package:a};if(n){R(s);return}ji(`Installed provider ${o.id} from ${o.package}@${o.version}.`)}}),remove:T({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=O(e.id)??``,n=F(e),r=A(e.yes),i=L({json:n});if(!r&&!i)throw new C(`INVALID_INPUT`,`Pass --yes to remove a provider extension in JSON or CI mode.`);if(!r&&!V(await Ei({message:`Remove provider ${t}?`,initialValue:!1})))return;let a=await Le(t);if(!a)throw new C(`INVALID_INPUT`,`Provider ${t} is not installed.`);if(n){R({removed:a});return}process.stdout.write(`Removed ${t}.\n`)}}),connect:T({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 n=O(e.id)??``,r=F(e),i=L({json:r}),a=await Wd(n),o={...Ke(n),...Hd(O(e.account))},s={};if(i){Di(`Connect ${a.displayName}`),a.connection.verificationNotice&&E(a.connection.verificationNotice,`Connection check`);for(let e of a.connection.fields){if(e.kind===`account`){let t=V(await Pi({message:e.label,placeholder:e.description,initialValue:o[e.id],validate:t=>e.required!==!1&&!t?.trim()?`${e.label} is required`:void 0}));t?.trim()&&(o[e.id]=t.trim());continue}if(e.envVar&&process.env[e.envVar]?.trim())continue;let t=V(await Mi({message:e.label,validate:t=>e.required!==!1&&!t?.trim()?`${e.label} is required`:void 0}));t?.trim()&&(s[e.id]=t.trim())}}o=Gd(a,o);let c={...s};Object.keys(c).length===0&&(c=await gt({providerId:n,account:o,fields:a.connection.fields})),await ft({providerId:n,account:o,credentials:c}),Object.keys(s).length>0&&await oe({providerId:n,account:o,credentials:s}),t(n,o);let l={provider:n,connected:!0,account:o,capabilities:(a.capabilities??[]).map(e=>e.id),actions:(a.actions??[]).map(e=>e.id)};r?R(l):ji(`Connected ${a.displayName}. Run seo providers describe ${n} to see what it can do.`)}}),status:T({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=O(e.id)??``,n=await Wd(t),r=Ke(t),i;try{i=await gt({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=A(e.check);if(o&&!a)throw new C(`AUTH_REQUIRED`,`Provider ${t} is not connected. Run \`seo providers connect ${t}\`.`);o&&i&&await ft({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`};if(F(e)){R(s);return}B([`Provider`,`Connected`,`Capabilities`,`Check`],[[n.displayName,a?`yes`:`no`,s.capabilities.join(`, `),s.check]])}}),disconnect:T({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=O(e.id)??``;await Wd(t),await ct({providerId:t,account:Ke(t)}),Ot(t);let n={provider:t,disconnected:!0,note:`Environment variables were not changed.`};F(e)?R(n):process.stdout.write(`Disconnected ${t}. ${n.note}\n`)}}),run:T({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=O(e.id)??``,n=O(e.action)??``;await Wd(t),R(await yn({providerId:t,actionId:n,account:{...Ke(t),...Hd(O(e.account))},params:Ud(O(e.params)),refresh:A(e.refresh)}))}}),limits:T({meta:{name:`limits`,description:`Show or change local limits for one installed provider`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},"daily-notice":{type:`string`,description:`UTC daily notice in USD, or off.`},"daily-limit":{type:`string`,description:`UTC daily hard limit in USD, or off.`},"monthly-limit":{type:`string`,description:`UTC monthly hard limit in USD, or off.`},requests:{type:`string`,description:`Maximum provider requests in one report run.`},rows:{type:`string`,description:`Maximum requested provider rows in one report run.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.id)??``;await Wd(t);let n=pt(t),r={dailyNoticeMicros:wd(e[`daily-notice`],`--daily-notice`,{notice:!0}),dailyHardLimitMicros:wd(e[`daily-limit`],`--daily-limit`),monthlyHardLimitMicros:wd(e[`monthly-limit`],`--monthly-limit`),maxRequestsPerReport:Td(e.requests,`--requests`,1,100),maxRowsPerReport:Td(e.rows,`--rows`,1,1e5)},i=Object.values(r).some(e=>e!==void 0),a=i?de(t,{dailyNoticeMicros:r.dailyNoticeMicros??n.dailyNoticeMicros,dailyHardLimitMicros:r.dailyHardLimitMicros===void 0?n.dailyHardLimitMicros:r.dailyHardLimitMicros,monthlyHardLimitMicros:r.monthlyHardLimitMicros===void 0?n.monthlyHardLimitMicros:r.monthlyHardLimitMicros,maxRequestsPerReport:r.maxRequestsPerReport??n.maxRequestsPerReport,maxRowsPerReport:r.maxRowsPerReport??n.maxRowsPerReport}):n,o={provider:t,changed:i,limits:a};if(F(e)){R(o);return}z([[`UTC daily notice`,a.dailyNoticeMicros===0?`off`:Z(a.dailyNoticeMicros)],[`UTC daily hard limit`,a.dailyHardLimitMicros===null?`off`:Z(a.dailyHardLimitMicros)],[`UTC monthly hard limit`,a.monthlyHardLimitMicros===null?`off`:Z(a.monthlyHardLimitMicros)],[`Requests per report`,String(a.maxRequestsPerReport)],[`Rows per report`,String(a.maxRowsPerReport)]])}}),spend:T({meta:{name:`spend`,description:`Show locally recorded spend for one installed provider`},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=O(e.id)??``;await Wd(t);let n={provider:t,local:u(t)};if(F(e)){R(n);return}z([[`Today`,Z(n.local.today.effectiveCostMicros)],[`This month`,Z(n.local.month.effectiveCostMicros)],[`Requests today`,String(n.local.today.requests)]])}}),doctor:T({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 Kd(),n={ok:t.installed.every(e=>e.loadStatus===`ready`),installed:t.installed};if(F(e)){R(n);return}if(n.installed.length===0){process.stdout.write(`No provider extensions are installed.
-`);return}B([`Provider`,`Package`,`Version`,`Status`],n.installed.map(e=>[e.id,e.package,e.version,e.error??e.loadStatus]))}})},Jd=T({meta:{name:`semrush`,description:`Connect Semrush Version 3 for optional search data`},subCommands:{connect:T({meta:{name:`connect`,description:`Validate and save a Semrush Version 3 API key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!L({json:F(e)}))throw new C(`AUTH_REQUIRED`,`Run \`seo providers semrush connect\` in a terminal. Agents and CI can set ${Yt}.`);Di(`Connect Semrush`),E(`Use the permanent Version 3 API Key shown on your Semrush API Keys page. Semrush creates this key automatically. The balance check is free; research reports consume API units.`,`API key`);let t=V(await Mi({message:`Semrush Version 3 API key`,validate:e=>e?.trim()?void 0:`API key is required`})),n=await new gr({apiKey:t}).apiUnitBalance(),r=await Nn(t);E(`${n.remainingUnits.toLocaleString(`en-US`)} API units remain.`,`Connection verified`),ji(`Saved in the ${Cd(r)}. Run seo providers semrush status --check to verify it again.`)}}),status:T({meta:{name:`status`,description:`Show the local Semrush connection`},args:{check:{type:`boolean`,default:!1,description:`Verify the Version 3 API key with a free balance request.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await qn(),n=!!e.check,r=n&&t?await new gr().apiUnitBalance():void 0,i={connected:!!t,apiVersion:t?3:null,credentialSource:t?.source,migratedLegacyCredential:t?.migrated??!1,liveCheck:r?{status:`passed`,remainingUnits:r.remainingUnits,observedAt:r.observedAt,requestCostUnits:0}:{status:n?`unavailable`:`not-requested`}};if(F(e)){R(i);return}z([[`Connected`,i.connected?`yes`:`no`],[`API version`,i.apiVersion?`Version 3`:`not connected`],[`Credential`,Cd(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?[[`API units remaining`,r.remainingUnits.toLocaleString(`en-US`)]]:[]])}}),disconnect:T({meta:{name:`disconnect`,description:`Remove the saved Semrush Version 3 API key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await rn();let t=!!process.env[Yt],n={savedCredentialRemoved:!0,environmentCredential:t?`active`:`missing`,note:t?`The environment variable was not changed. Clear ${Yt} to fully disconnect.`:`Semrush is disconnected.`};F(e)?R(n):process.stdout.write(`${n.note}\n`)}})}}),Yd=T({meta:{name:`providers`,description:`Connect optional data providers`},subCommands:{...qd,ahrefs:jd,bing:Ld,dataforseo:Vd,semrush:Jd}});function Xd(e){let t=e.indexed+e.notIndexed+e.unknown+e.warnings;return t?`${e.indexed}/${t} indexed`:`-`}function Zd(e){if(!e.samples.length)return`-`;let t=e.medianWordCount===void 0?`words ?`:`${W(e.medianWordCount)} words`,n=e.weakQueryCoverage?`; ${e.weakQueryCoverage} weak coverage`:``;return`${t}; ${e.usable}/${e.samples.length} usable${n}`}function Qd(e){return e===`serp-framing-review`?`wording review`:e===`body-term-review`?`literal term review`:`covered terms`}function $d(e){let t=e.staticSegments.map(e=>`/${e.value}`).join(``),n=e.variableSegments.slice(0,3).map(e=>{let t=e.examples.slice(0,3).join(`, `);return`${e.placeholder}@${e.index+1}${t?` (${t})`:``}`});return[t?`static ${t}`:`no fixed path prefix`,n.length?`variables ${n.join(`; `)}`:`no variables`].join(`; `)}function ef(e){if(e.checkedQueries)return`${Math.round(e.impressionShare*100)}% impression fit across ${On(e.checkedQueries,`checked query/page row`)}`}function tf(e){return e.startsWith(`theme: `)?`${e.slice(7)}-related`:e===`general`?`broad`:e}function nf(e){for(let t of e.slice(0,5)){process.stdout.write(`\n${t.signature}\n`),t.evidence.length&&process.stdout.write(`  Evidence: ${t.evidence.join(`; `)}.\n`),process.stdout.write(`  Shape: ${$d(t.shape)}\n`);let e=ef(t.metrics.entityFit);e&&process.stdout.write(`  Entity fit: ${e}\n`);let n=t.metrics.queryPatterns.slice(0,3).map(e=>`${tf(e.label)} (${W(e.impressions)} impr: ${e.examples.slice(0,2).join(`; `)})`);n.length&&process.stdout.write(`  Demand: ${n.join(` | `)}\n`);let r=t.metrics.topQueries.slice(0,3);if(r.length){process.stdout.write(`  Top queries:
+`),`Package`),E(`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`),!V(await Ei({message:`Install ${a.package}@${a.version}?`,initialValue:!1})))){ji(`Provider was not installed.`);return}let o;try{o=await g(a)}catch(e){throw new C(`PROVIDER_UNAVAILABLE`,e instanceof Error?e.message:String(e))}let s={installed:o,package:a};if(n){R(s);return}ji(`Installed provider ${o.id} from ${o.package}@${o.version}.`)}}),remove:T({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=O(e.id)??``,n=F(e),r=A(e.yes),i=L({json:n});if(!r&&!i)throw new C(`INVALID_INPUT`,`Pass --yes to remove a provider extension in JSON or CI mode.`);if(!r&&!V(await Ei({message:`Remove provider ${t}?`,initialValue:!1})))return;let a=await Le(t);if(!a)throw new C(`INVALID_INPUT`,`Provider ${t} is not installed.`);if(n){R({removed:a});return}process.stdout.write(`Removed ${t}.\n`)}}),connect:T({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 n=O(e.id)??``,r=F(e),i=L({json:r}),a=await Kd(n),o={...Ke(n),...Wd(O(e.account))},s={};if(i){Di(`Connect ${a.displayName}`),a.connection.verificationNotice&&E(a.connection.verificationNotice,`Connection check`);for(let e of a.connection.fields){if(e.kind===`account`){let t=V(await Pi({message:e.label,placeholder:e.description,initialValue:o[e.id],validate:t=>e.required!==!1&&!t?.trim()?`${e.label} is required`:void 0}));t?.trim()&&(o[e.id]=t.trim());continue}if(e.envVar&&process.env[e.envVar]?.trim())continue;let t=V(await Mi({message:e.label,validate:t=>e.required!==!1&&!t?.trim()?`${e.label} is required`:void 0}));t?.trim()&&(s[e.id]=t.trim())}}o=qd(a,o);let c={...s};Object.keys(c).length===0&&(c=await gt({providerId:n,account:o,fields:a.connection.fields})),await ft({providerId:n,account:o,credentials:c}),Object.keys(s).length>0&&await oe({providerId:n,account:o,credentials:s}),t(n,o);let l={provider:n,connected:!0,account:o,capabilities:(a.capabilities??[]).map(e=>e.id),actions:(a.actions??[]).map(e=>e.id)};r?R(l):ji(`Connected ${a.displayName}. Run seo providers describe ${n} to see what it can do.`)}}),status:T({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=O(e.id)??``,n=await Kd(t),r=Ke(t),i;try{i=await gt({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=A(e.check);if(o&&!a)throw new C(`AUTH_REQUIRED`,`Provider ${t} is not connected. Run \`seo providers connect ${t}\`.`);o&&i&&await ft({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`};if(F(e)){R(s);return}B([`Provider`,`Connected`,`Capabilities`,`Check`],[[n.displayName,a?`yes`:`no`,s.capabilities.join(`, `),s.check]])}}),disconnect:T({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=O(e.id)??``;await Kd(t),await ct({providerId:t,account:Ke(t)}),Ot(t);let n={provider:t,disconnected:!0,note:`Environment variables were not changed.`};F(e)?R(n):process.stdout.write(`Disconnected ${t}. ${n.note}\n`)}}),run:T({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=O(e.id)??``,n=O(e.action)??``;await Kd(t),R(await yn({providerId:t,actionId:n,account:{...Ke(t),...Wd(O(e.account))},params:Gd(O(e.params)),refresh:A(e.refresh)}))}}),limits:T({meta:{name:`limits`,description:`Show or change local limits for one installed provider`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},"daily-notice":{type:`string`,description:`UTC daily notice in USD, or off.`},"daily-limit":{type:`string`,description:`UTC daily hard limit in USD, or off.`},"monthly-limit":{type:`string`,description:`UTC monthly hard limit in USD, or off.`},requests:{type:`string`,description:`Maximum provider requests in one report run.`},rows:{type:`string`,description:`Maximum requested provider rows in one report run.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.id)??``;await Kd(t);let n=pt(t),r={dailyNoticeMicros:Ed(e[`daily-notice`],`--daily-notice`,{notice:!0}),dailyHardLimitMicros:Ed(e[`daily-limit`],`--daily-limit`),monthlyHardLimitMicros:Ed(e[`monthly-limit`],`--monthly-limit`),maxRequestsPerReport:Dd(e.requests,`--requests`,1,100),maxRowsPerReport:Dd(e.rows,`--rows`,1,1e5)},i=Object.values(r).some(e=>e!==void 0),a=i?de(t,{dailyNoticeMicros:r.dailyNoticeMicros??n.dailyNoticeMicros,dailyHardLimitMicros:r.dailyHardLimitMicros===void 0?n.dailyHardLimitMicros:r.dailyHardLimitMicros,monthlyHardLimitMicros:r.monthlyHardLimitMicros===void 0?n.monthlyHardLimitMicros:r.monthlyHardLimitMicros,maxRequestsPerReport:r.maxRequestsPerReport??n.maxRequestsPerReport,maxRowsPerReport:r.maxRowsPerReport??n.maxRowsPerReport}):n,o={provider:t,changed:i,limits:a};if(F(e)){R(o);return}z([[`UTC daily notice`,a.dailyNoticeMicros===0?`off`:Z(a.dailyNoticeMicros)],[`UTC daily hard limit`,a.dailyHardLimitMicros===null?`off`:Z(a.dailyHardLimitMicros)],[`UTC monthly hard limit`,a.monthlyHardLimitMicros===null?`off`:Z(a.monthlyHardLimitMicros)],[`Requests per report`,String(a.maxRequestsPerReport)],[`Rows per report`,String(a.maxRowsPerReport)]])}}),spend:T({meta:{name:`spend`,description:`Show locally recorded spend for one installed provider`},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=O(e.id)??``;await Kd(t);let n={provider:t,local:u(t)};if(F(e)){R(n);return}z([[`Today`,Z(n.local.today.effectiveCostMicros)],[`This month`,Z(n.local.month.effectiveCostMicros)],[`Requests today`,String(n.local.today.requests)]])}}),doctor:T({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 Jd(),n={ok:t.installed.every(e=>e.loadStatus===`ready`),installed:t.installed};if(F(e)){R(n);return}if(n.installed.length===0){process.stdout.write(`No provider extensions are installed.
+`);return}B([`Provider`,`Package`,`Version`,`Status`],n.installed.map(e=>[e.id,e.package,e.version,e.error??e.loadStatus]))}})},Xd=T({meta:{name:`semrush`,description:`Connect Semrush Version 3 for optional search data`},subCommands:{connect:T({meta:{name:`connect`,description:`Validate and save a Semrush Version 3 API key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!L({json:F(e)}))throw new C(`AUTH_REQUIRED`,`Run \`seo providers semrush connect\` in a terminal. Agents and CI can set ${Yt}.`);Di(`Connect Semrush`),E(`Use the permanent Version 3 API Key shown on your Semrush API Keys page. Semrush creates this key automatically. The balance check is free; research reports consume API units.`,`API key`);let t=V(await Mi({message:`Semrush Version 3 API key`,validate:e=>e?.trim()?void 0:`API key is required`})),n=await new gr({apiKey:t}).apiUnitBalance(),r=await Nn(t);E(`${n.remainingUnits.toLocaleString(`en-US`)} API units remain.`,`Connection verified`),ji(`Saved in the ${Td(r)}. Run seo providers semrush status --check to verify it again.`)}}),status:T({meta:{name:`status`,description:`Show the local Semrush connection`},args:{check:{type:`boolean`,default:!1,description:`Verify the Version 3 API key with a free balance request.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await qn(),n=!!e.check,r=n&&t?await new gr().apiUnitBalance():void 0,i={connected:!!t,apiVersion:t?3:null,credentialSource:t?.source,migratedLegacyCredential:t?.migrated??!1,liveCheck:r?{status:`passed`,remainingUnits:r.remainingUnits,observedAt:r.observedAt,requestCostUnits:0}:{status:n?`unavailable`:`not-requested`}};if(F(e)){R(i);return}z([[`Connected`,i.connected?`yes`:`no`],[`API version`,i.apiVersion?`Version 3`:`not connected`],[`Credential`,Td(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?[[`API units remaining`,r.remainingUnits.toLocaleString(`en-US`)]]:[]])}}),disconnect:T({meta:{name:`disconnect`,description:`Remove the saved Semrush Version 3 API key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await rn();let t=!!process.env[Yt],n={savedCredentialRemoved:!0,environmentCredential:t?`active`:`missing`,note:t?`The environment variable was not changed. Clear ${Yt} to fully disconnect.`:`Semrush is disconnected.`};F(e)?R(n):process.stdout.write(`${n.note}\n`)}})}}),Zd=T({meta:{name:`providers`,description:`Connect optional data providers`},subCommands:{...Yd,ahrefs:Nd,bing:zd,dataforseo:Ud,semrush:Xd}});function Qd(e){let t=e.indexed+e.notIndexed+e.unknown+e.warnings;return t?`${e.indexed}/${t} indexed`:`-`}function $d(e){if(!e.samples.length)return`-`;let t=e.medianWordCount===void 0?`words ?`:`${W(e.medianWordCount)} words`,n=e.weakQueryCoverage?`; ${e.weakQueryCoverage} weak coverage`:``;return`${t}; ${e.usable}/${e.samples.length} usable${n}`}function ef(e){return e===`serp-framing-review`?`wording review`:e===`body-term-review`?`literal term review`:`covered terms`}function tf(e){let t=e.staticSegments.map(e=>`/${e.value}`).join(``),n=e.variableSegments.slice(0,3).map(e=>{let t=e.examples.slice(0,3).join(`, `);return`${e.placeholder}@${e.index+1}${t?` (${t})`:``}`});return[t?`static ${t}`:`no fixed path prefix`,n.length?`variables ${n.join(`; `)}`:`no variables`].join(`; `)}function nf(e){if(e.checkedQueries)return`${Math.round(e.impressionShare*100)}% impression fit across ${On(e.checkedQueries,`checked query/page row`)}`}function rf(e){return e.startsWith(`theme: `)?`${e.slice(7)}-related`:e===`general`?`broad`:e}function af(e){for(let t of e.slice(0,5)){process.stdout.write(`\n${t.signature}\n`),t.evidence.length&&process.stdout.write(`  Evidence: ${t.evidence.join(`; `)}.\n`),process.stdout.write(`  Shape: ${tf(t.shape)}\n`);let e=nf(t.metrics.entityFit);e&&process.stdout.write(`  Entity fit: ${e}\n`);let n=t.metrics.queryPatterns.slice(0,3).map(e=>`${rf(e.label)} (${W(e.impressions)} impr: ${e.examples.slice(0,2).join(`; `)})`);n.length&&process.stdout.write(`  Demand: ${n.join(` | `)}\n`);let r=t.metrics.topQueries.slice(0,3);if(r.length){process.stdout.write(`  Top queries:
 `);for(let e of r)process.stdout.write(`    - ${G(e.query,72)} (${W(e.impressions)} impr, pos ${is(e.position)})\n`)}let i=t.crawl.samples.map(e=>e.queryCoverage).filter(e=>!!e).slice(0,3);if(i.length){process.stdout.write(`  Sample coverage:
-`);for(let e of i){let t=e.missingTerms.length?` missing ${e.missingTerms.slice(0,4).join(`, `)}`:``;process.stdout.write(`    - ${Qd(e.classification)}: ${G(e.query,64)} (body ${(e.bodyCoverage*100).toFixed(0)}%${t})\n`)}}let a=t.metrics.entityFit.weakExamples.slice(0,2);if(a.length){process.stdout.write(`  Weak entity-fit examples:
-`);for(let e of a){let t=e.pathTerms.slice(0,4);process.stdout.write(`    - ${G(e.query,64)} -> expected ${On(t.length,`path term`)}: ${t.join(`, `)}\n`)}}process.stdout.write(`  Action: ${t.recommendation}\n`)}}const rf=T({meta:{name:`pseo`,description:`Programmatic SEO audits that cluster URL patterns and sample template pages`},subCommands:{audit:T({meta:{name:`audit`,description:`Group GSC/sitemap URLs into pSEO templates, then sample pages for crawl and index evidence`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...X([`days`,`limit`,`includeBrand`,`js`,`refresh`],{limit:{description:`Maximum templates to show. Defaults to 25.`},includeBrand:{description:`Include branded queries in template metrics.`},js:{description:`Force JavaScript rendering for crawl samples.`},refresh:{description:`Bypass local GSC and HTTP cache.`}}),sitemap:{type:`string`,description:`Comma-separated sitemap URLs to include in template counts.`},"crawl-samples":{type:`string`,description:`Sample URLs to fetch per detected template. This is not crawl depth.`},"inspect-samples":{type:`string`,description:`Sample URLs to check per detected template with URL Inspection.`},"max-sitemap-urls":{type:`string`,description:`Maximum discovered URLs per sitemap. Defaults to 50000.`},"minimum-template-urls":{type:`string`,description:`Minimum repeated URLs required for a template. Defaults to 3.`},"minimum-template-share":{type:`string`,description:`Minimum share of discovered URLs from 0 to 1. Defaults to 0.`},"minimum-template-impressions":{type:`string`,description:`Minimum retained page impressions for a template. Defaults to 0.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude from query evidence.`},"fetch-concurrency":{type:`string`,description:`Maximum concurrent page fetches per host. Defaults to 4.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host. Defaults to 4.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds. Defaults to 1000.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=vu(e),r=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),i=await Be({site:r.site,...n,brandTerms:n.brandTerms??r.client?.brandTerms,progress:Ul(!t)});if(t){R(i);return}if(K({title:`Programmatic SEO audit`,target:i.site,status:i.templates.length>0?`info`:`unknown`,summary:i.templates.length>0?`${W(i.summary.templates)} page templates were analysed.`:`No page templates could be established from the available evidence.`,metrics:[{label:`Templates`,value:W(i.summary.templates)},{label:`GSC pages`,value:W(i.summary.gscPages)},{label:`Sitemap URLs`,value:W(i.summary.sitemapUrls)},{label:`Clicks`,value:W(i.summary.clicks)},{label:`Impressions`,value:W(i.summary.impressions)},{label:`Usable crawls`,value:`${W(i.summary.crawledUrls)}/${W(i.summary.crawlAttempts)}`},{label:`Inspections`,value:`${W(i.summary.inspectedUrls)}/${W(i.summary.inspectionAttempts)}`}]}),Y(`Report caveats`,i.caveats),!i.templates.length){process.stdout.write(`No pSEO templates found from GSC/sitemap data.
-`);return}q([`Verdict`,`Template`,`URLs`,`Clicks`,`Impr`,`CTR`,`Pos`,`Index`,`Crawl`,`Action`],i.templates.map(e=>[`${e.verdict} (${e.confidence})`,G(e.signature,28),W(e.urlCount),W(e.metrics.clicks),W(e.metrics.impressions),as(e.metrics.ctr),e.metrics.position.toFixed(1),Xd(e.inspection),Zd(e.crawl),G(e.recommendation,72)])),nf(i.templates),i.warnings.length&&process.stdout.write(`Warnings: ${i.warnings.join(`; `)}\n`),ls(`seo export pseo ${r.client?`--project ${JSON.stringify(r.client.id)}`:`--site ${JSON.stringify(r.site)}`}`)}})}}),af={"ai-search":`AI search`,crawl:`Crawling and technical checks`,diagnosis:`Diagnosis`,experiments:`Experiments`,monitoring:`Monitoring`,opportunities:`Opportunities`,reporting:`Reporting`,setup:`Setup`,workflows:`Workflows`};function of(e){let t=O(e);if(t){if(!cr.includes(t))throw new C(`INVALID_INPUT`,`Unknown report category: ${t}. Choose ${cr.join(`, `)}.`);return t}}async function sf(e,t){let n=O(e),r=O(t);if(n&&r)throw new C(`INVALID_INPUT`,`Use either --params or --params-file, not both.`);if(!n&&!r)return{};let i=n??await di(r??``,`utf8`),a;try{a=JSON.parse(i)}catch{throw new C(`INVALID_INPUT`,`Report parameters must be valid JSON.`)}if(!a||typeof a!=`object`||Array.isArray(a))throw new C(`INVALID_INPUT`,`Report parameters must be an object.`);return a}function cf(e){if(!e.isError)return;let t=e.structuredContent;throw new C(t?.error?.code??`INTERNAL_ERROR`,t?.error?.message??`The report could not be completed.`)}function lf(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 uf=T({meta:{name:`reports`,description:`Discover and run the complete report catalog`},subCommands:{list:T({meta:{name:`list`,description:`List report ids available to the CLI and MCP server`},args:{category:{type:`string`,description:`Filter by category: ${cr.join(`, `)}.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=rr(of(e.category));if(F(e)){R({reports:t,categories:cr});return}Ao(t,{noun:`report`,categoryLabels:af}),process.stdout.write(`
+`);for(let e of i){let t=e.missingTerms.length?` missing ${e.missingTerms.slice(0,4).join(`, `)}`:``;process.stdout.write(`    - ${ef(e.classification)}: ${G(e.query,64)} (body ${(e.bodyCoverage*100).toFixed(0)}%${t})\n`)}}let a=t.metrics.entityFit.weakExamples.slice(0,2);if(a.length){process.stdout.write(`  Weak entity-fit examples:
+`);for(let e of a){let t=e.pathTerms.slice(0,4);process.stdout.write(`    - ${G(e.query,64)} -> expected ${On(t.length,`path term`)}: ${t.join(`, `)}\n`)}}process.stdout.write(`  Action: ${t.recommendation}\n`)}}const of=T({meta:{name:`pseo`,description:`Programmatic SEO audits that cluster URL patterns and sample template pages`},subCommands:{audit:T({meta:{name:`audit`,description:`Group GSC/sitemap URLs into pSEO templates, then sample pages for crawl and index evidence`},args:{site:{type:`string`},project:{type:`string`,description:`Saved project id or name.`},client:{type:`string`,description:`Legacy alias for --project.`},...X([`days`,`limit`,`includeBrand`,`js`,`refresh`],{limit:{description:`Maximum templates to show. Defaults to 25.`},includeBrand:{description:`Include branded queries in template metrics.`},js:{description:`Force JavaScript rendering for crawl samples.`},refresh:{description:`Bypass local GSC and HTTP cache.`}}),sitemap:{type:`string`,description:`Comma-separated sitemap URLs to include in template counts.`},"crawl-samples":{type:`string`,description:`Sample URLs to fetch per detected template. This is not crawl depth.`},"inspect-samples":{type:`string`,description:`Sample URLs to check per detected template with URL Inspection.`},"max-sitemap-urls":{type:`string`,description:`Maximum discovered URLs per sitemap. Defaults to 50000.`},"minimum-template-urls":{type:`string`,description:`Minimum repeated URLs required for a template. Defaults to 3.`},"minimum-template-share":{type:`string`,description:`Minimum share of discovered URLs from 0 to 1. Defaults to 0.`},"minimum-template-impressions":{type:`string`,description:`Minimum retained page impressions for a template. Defaults to 0.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude from query evidence.`},"fetch-concurrency":{type:`string`,description:`Maximum concurrent page fetches per host. Defaults to 4.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host. Defaults to 4.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds. Defaults to 1000.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=F(e),n=bu(e),r=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),i=await Be({site:r.site,...n,brandTerms:n.brandTerms??r.client?.brandTerms,progress:Gl(!t)});if(t){R(i);return}if(K({title:`Programmatic SEO audit`,target:i.site,status:i.templates.length>0?`info`:`unknown`,summary:i.templates.length>0?`${W(i.summary.templates)} page templates were analysed.`:`No page templates could be established from the available evidence.`,metrics:[{label:`Templates`,value:W(i.summary.templates)},{label:`GSC pages`,value:W(i.summary.gscPages)},{label:`Sitemap URLs`,value:W(i.summary.sitemapUrls)},{label:`Clicks`,value:W(i.summary.clicks)},{label:`Impressions`,value:W(i.summary.impressions)},{label:`Usable crawls`,value:`${W(i.summary.crawledUrls)}/${W(i.summary.crawlAttempts)}`},{label:`Inspections`,value:`${W(i.summary.inspectedUrls)}/${W(i.summary.inspectionAttempts)}`}]}),Y(`Report caveats`,i.caveats),!i.templates.length){process.stdout.write(`No pSEO templates found from GSC/sitemap data.
+`);return}q([`Verdict`,`Template`,`URLs`,`Clicks`,`Impr`,`CTR`,`Pos`,`Index`,`Crawl`,`Action`],i.templates.map(e=>[`${e.verdict} (${e.confidence})`,G(e.signature,28),W(e.urlCount),W(e.metrics.clicks),W(e.metrics.impressions),as(e.metrics.ctr),e.metrics.position.toFixed(1),Qd(e.inspection),$d(e.crawl),G(e.recommendation,72)])),af(i.templates),i.warnings.length&&process.stdout.write(`Warnings: ${i.warnings.join(`; `)}\n`),ls(`seo export pseo ${r.client?`--project ${JSON.stringify(r.client.id)}`:`--site ${JSON.stringify(r.site)}`}`)}})}}),sf={"ai-search":`AI search`,crawl:`Crawling and technical checks`,diagnosis:`Diagnosis`,experiments:`Experiments`,monitoring:`Monitoring`,opportunities:`Opportunities`,reporting:`Reporting`,setup:`Setup`,workflows:`Workflows`};function cf(e){let t=O(e);if(t){if(!cr.includes(t))throw new C(`INVALID_INPUT`,`Unknown report category: ${t}. Choose ${cr.join(`, `)}.`);return t}}async function lf(e,t){let n=O(e),r=O(t);if(n&&r)throw new C(`INVALID_INPUT`,`Use either --params or --params-file, not both.`);if(!n&&!r)return{};let i=n??await di(r??``,`utf8`),a;try{a=JSON.parse(i)}catch{throw new C(`INVALID_INPUT`,`Report parameters must be valid JSON.`)}if(!a||typeof a!=`object`||Array.isArray(a))throw new C(`INVALID_INPUT`,`Report parameters must be an object.`);return a}function uf(e){if(!e.isError)return;let t=e.structuredContent;throw new C(t?.error?.code??`INTERNAL_ERROR`,t?.error?.message??`The report could not be completed.`)}function df(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 ff=T({meta:{name:`reports`,description:`Discover and run the complete report catalog`},subCommands:{list:T({meta:{name:`list`,description:`List report ids available to the CLI and MCP server`},args:{category:{type:`string`,description:`Filter by category: ${cr.join(`, `)}.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=rr(cf(e.category));if(F(e)){R({reports:t,categories:cr});return}Ao(t,{noun:`report`,categoryLabels:sf}),process.stdout.write(`
 `),Eo({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>`})}}),describe:T({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`."},check:{type:`string`,description:`Show fix guidance for one check id from the report output.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e.check);if(t){let n=Ft(O(e.id)??``,t);if(F(e)){R({report:n});return}Do(`${n.name}: ${n.check}`,n.checkFix.goal),process.stdout.write(`
 `),Mo(`Fix`,n.checkFix.fix),process.stdout.write(`
 `),Mo(`Agent prompt`,n.checkFix.prompt),process.stdout.write(`
@@ -230,37 +230,37 @@ One-window evidence (not treated as zero)
 `),Eo({title:`Implement findings`,body:n.agentWorkflow.completion,command:n.agentWorkflow.actionView.cli}),n.related.length>0&&(process.stdout.write(`
 `),No(`Related reports`,n.related.map(e=>`${e.id}: ${e.reason}`))),process.stdout.write(`
 Parameters
-`),Po(lf(n.inputSchema)),n.fixableChecks&&(process.stdout.write(`
+`),Po(df(n.inputSchema)),n.fixableChecks&&(process.stdout.write(`
 `),Eo({title:`Fix a failed check`,body:`Get the fix steps, an agent prompt, and spec links for one check id from the report output.`,command:`seo reports describe ${n.id} --check <check-id>`})),process.stdout.write(`
-`),Eo({title:`Need the exact schema?`,command:`seo reports describe ${n.id} --json`})}}),run:T({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=await Bn(O(e.id)??``,await sf(e.params,e[`params-file`]),{view:A(e[`actions-only`])?`actions`:`full`});if(cf(t),F(e)){R(t.structuredContent??{});return}for(let e of t.content)process.stdout.write(`${e.text}\n`)}})}}),df={format:{type:`string`,description:`Output format: terminal or html. Defaults to terminal.`},output:{type:`string`,description:`HTML output file. A dated filename is used by default.`},view:{type:`string`,description:`HTML detail level: client or analyst. Defaults to client.`}};function ff(e){let t=O(e.format)??`terminal`;if(t!==`terminal`&&t!==`html`)throw new C(`INVALID_INPUT`,`Choose terminal or html for --format.`);if(t===`terminal`){if(O(e.output)||O(e.view))throw new C(`INVALID_INPUT`,`Use --output and --view with --format html.`);return}if(A(e.json))throw new C(`INVALID_INPUT`,`Use either --json or --format html, not both.`);let n=O(e.view)??`client`;if(n!==`client`&&n!==`analyst`)throw new C(`INVALID_INPUT`,`Choose client or analyst for --view.`);return{output:O(e.output),view:n}}function pf(e){return e.toLowerCase().replace(/^sc-domain:/,``).replace(/^https?:\/\//,``).replace(/[^a-z0-9._-]+/g,`-`).replace(/^-+|-+$/g,``).slice(0,80)}function mf(e){let t=(e.date??new Date).toISOString().slice(0,10),n=pf(e.projectId??e.site)||`site`;return ri(process.cwd(),`${n}-${pf(e.reportName)}-${t}.html`)}async function hf(e){let t=ri(e.options.output??mf({reportName:e.reportName,projectId:e.projectId,site:e.report.site}));return await li(Qr(t),{recursive:!0}),await _i(t,Zi({report:e.report,title:e.title,view:e.options.view,additionalSections:e.additionalSections}),`utf8`),t}function gf(e){process.stdout.write(`Wrote HTML report to ${e}\n`)}const _f=T({meta:{name:`monthly-report`,description:`Generate a monthly SEO report narrative`},args:{...Wl,month:{type:`string`,description:`Report month as YYYY-MM. Defaults to the latest month with final GSC data.`},...X([`limit`],{limit:{description:`Maximum rows per diagnostic section. Defaults to 10.`}}),...Gl,...df},run:async({args:e})=>{let t=F(e),n=ff(e),r=ql(e),i=await H({client:r.client,site:r.site,options:{json:t,refresh:r.refresh}}),a=await Ut({site:i.site,month:O(e.month),limit:j(e.limit),brandTerms:i.client?.brandTerms,...Kl(e),progress:Ul(!t)});if(t){R(a);return}if(n){gf(await hf({report:a,reportName:`monthly-report`,title:`Monthly SEO report for ${a.month}`,options:n,projectId:i.client?.id}));return}process.stdout.write(`${a.markdown}\n`);let o=i.client?`--project ${JSON.stringify(i.client.id)}`:`--site ${JSON.stringify(i.site)}`,s=O(e.month);process.stdout.write(`
-`),ls(`seo export monthly ${o}${s?` --month ${JSON.stringify(s)}`:``}`)}}),vf=T({meta:{name:`report-narrative`,description:`Generate a client-ready SEO narrative from diagnosis data`},args:{...Wl,...X([`days`,`recentDays`],{days:{description:`Diagnosis window length in days. Defaults to 90.`}}),"start-date":{type:`string`,description:`Optional report start date as YYYY-MM-DD.`},"end-date":{type:`string`,description:`Optional report end date as YYYY-MM-DD.`},...X([`limit`],{limit:{description:`Maximum rows per diagnostic section. Defaults to 10.`}}),"change-limit":{type:`string`,description:`Maximum saved changes to measure. Defaults to 5.`},...Gl,...df},run:async({args:e})=>{let t=F(e),n=ff(e),r=ql(e),i=await H({client:r.client,site:r.site,options:{json:t,refresh:r.refresh}}),a=await kr({site:i.site,days:j(e.days),recentDays:j(e.recent),startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),limit:j(e.limit),changeLimit:j(e[`change-limit`]),brandTerms:i.client?.brandTerms,...Kl(e),progress:Ul(!t)});if(t){R(a);return}if(n){gf(await hf({report:a,reportName:`narrative-report`,title:`SEO narrative report`,options:n,projectId:i.client?.id}));return}process.stdout.write(`${a.markdown}\n`);let o=i.client?`--project ${JSON.stringify(i.client.id)}`:`--site ${JSON.stringify(i.site)}`;process.stdout.write(`
-`),ls(`seo export narrative ${o}`)}}),yf=T({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=O(e.category),n=In().filter(e=>!t||e.category===t);if(F(e)){R({rules:n});return}Ao(n.map(e=>({id:e.id,category:e.category,name:`${e.title} · ${e.defaultSeverity}`})),{noun:`rule`})}}),bf=T({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=O(e.rule)??``,n=lr(t);if(!n)throw Error(`Unknown rule: ${t}`);if(F(e)){R(n);return}z([[`Rule`,n.id],[`Title`,n.title],[`Category`,n.category],[`Severity`,n.defaultSeverity]]),process.stdout.write(`
+`),Eo({title:`Need the exact schema?`,command:`seo reports describe ${n.id} --json`})}}),run:T({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=await Bn(O(e.id)??``,await lf(e.params,e[`params-file`]),{view:A(e[`actions-only`])?`actions`:`full`});if(uf(t),F(e)){R(t.structuredContent??{});return}for(let e of t.content)process.stdout.write(`${e.text}\n`)}})}}),pf={format:{type:`string`,description:`Output format: terminal or html. Defaults to terminal.`},output:{type:`string`,description:`HTML output file. A dated filename is used by default.`},view:{type:`string`,description:`HTML detail level: client or analyst. Defaults to client.`}};function mf(e){let t=O(e.format)??`terminal`;if(t!==`terminal`&&t!==`html`)throw new C(`INVALID_INPUT`,`Choose terminal or html for --format.`);if(t===`terminal`){if(O(e.output)||O(e.view))throw new C(`INVALID_INPUT`,`Use --output and --view with --format html.`);return}if(A(e.json))throw new C(`INVALID_INPUT`,`Use either --json or --format html, not both.`);let n=O(e.view)??`client`;if(n!==`client`&&n!==`analyst`)throw new C(`INVALID_INPUT`,`Choose client or analyst for --view.`);return{output:O(e.output),view:n}}function hf(e){return e.toLowerCase().replace(/^sc-domain:/,``).replace(/^https?:\/\//,``).replace(/[^a-z0-9._-]+/g,`-`).replace(/^-+|-+$/g,``).slice(0,80)}function gf(e){let t=(e.date??new Date).toISOString().slice(0,10),n=hf(e.projectId??e.site)||`site`;return ri(process.cwd(),`${n}-${hf(e.reportName)}-${t}.html`)}async function _f(e){let t=ri(e.options.output??gf({reportName:e.reportName,projectId:e.projectId,site:e.report.site}));return await li(Qr(t),{recursive:!0}),await _i(t,Zi({report:e.report,title:e.title,view:e.options.view,additionalSections:e.additionalSections}),`utf8`),t}function vf(e){process.stdout.write(`Wrote HTML report to ${e}\n`)}const yf=T({meta:{name:`monthly-report`,description:`Generate a monthly SEO report narrative`},args:{...Kl,month:{type:`string`,description:`Report month as YYYY-MM. Defaults to the latest month with final GSC data.`},...X([`limit`],{limit:{description:`Maximum rows per diagnostic section. Defaults to 10.`}}),...ql,...pf},run:async({args:e})=>{let t=F(e),n=mf(e),r=Yl(e),i=await H({client:r.client,site:r.site,options:{json:t,refresh:r.refresh}}),a=await Ut({site:i.site,month:O(e.month),limit:j(e.limit),brandTerms:i.client?.brandTerms,...Jl(e),progress:Gl(!t)});if(t){R(a);return}if(n){vf(await _f({report:a,reportName:`monthly-report`,title:`Monthly SEO report for ${a.month}`,options:n,projectId:i.client?.id}));return}process.stdout.write(`${a.markdown}\n`);let o=i.client?`--project ${JSON.stringify(i.client.id)}`:`--site ${JSON.stringify(i.site)}`,s=O(e.month);process.stdout.write(`
+`),ls(`seo export monthly ${o}${s?` --month ${JSON.stringify(s)}`:``}`)}}),bf=T({meta:{name:`report-narrative`,description:`Generate a client-ready SEO narrative from diagnosis data`},args:{...Kl,...X([`days`,`recentDays`],{days:{description:`Diagnosis window length in days. Defaults to 90.`}}),"start-date":{type:`string`,description:`Optional report start date as YYYY-MM-DD.`},"end-date":{type:`string`,description:`Optional report end date as YYYY-MM-DD.`},...X([`limit`],{limit:{description:`Maximum rows per diagnostic section. Defaults to 10.`}}),"change-limit":{type:`string`,description:`Maximum saved changes to measure. Defaults to 5.`},...ql,...pf},run:async({args:e})=>{let t=F(e),n=mf(e),r=Yl(e),i=await H({client:r.client,site:r.site,options:{json:t,refresh:r.refresh}}),a=await kr({site:i.site,days:j(e.days),recentDays:j(e.recent),startDate:O(e[`start-date`]),endDate:O(e[`end-date`]),limit:j(e.limit),changeLimit:j(e[`change-limit`]),brandTerms:i.client?.brandTerms,...Jl(e),progress:Gl(!t)});if(t){R(a);return}if(n){vf(await _f({report:a,reportName:`narrative-report`,title:`SEO narrative report`,options:n,projectId:i.client?.id}));return}process.stdout.write(`${a.markdown}\n`);let o=i.client?`--project ${JSON.stringify(i.client.id)}`:`--site ${JSON.stringify(i.site)}`;process.stdout.write(`
+`),ls(`seo export narrative ${o}`)}}),xf=T({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=O(e.category),n=In().filter(e=>!t||e.category===t);if(F(e)){R({rules:n});return}Ao(n.map(e=>({id:e.id,category:e.category,name:`${e.title} · ${e.defaultSeverity}`})),{noun:`rule`})}}),Sf=T({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=O(e.rule)??``,n=lr(t);if(!n)throw Error(`Unknown rule: ${t}`);if(F(e)){R(n);return}z([[`Rule`,n.id],[`Title`,n.title],[`Category`,n.category],[`Severity`,n.defaultSeverity]]),process.stdout.write(`
 `),Mo(`Why it matters`,n.whyItMatters),process.stdout.write(`
 `),Mo(`How to fix`,n.howToFix),process.stdout.write(`
 `),Mo(`Impact if ignored`,n.impactIfIgnored),process.stdout.write(`
-`),Mo(`How to verify`,n.howToVerify)}});function xf(e){return JSON.stringify(e)}function Sf(e){let t=e.cadence??`weekly`;if(![`daily`,`weekly`,`monthly`].includes(t))throw new C(`INVALID_INPUT`,`Rank tracking cron cadence must be daily, weekly, or monthly.`);let n=e.devices?.length?[...new Set(e.devices)]:void 0;if(n?.some(e=>![`desktop`,`mobile`].includes(e))||(n?.length??0)>2)throw new C(`INVALID_INPUT`,`Rank tracking devices must be desktop, mobile, or both.`);if(e.depth!==void 0&&(!Number.isSafeInteger(e.depth)||e.depth<1||e.depth>100))throw new C(`INVALID_INPUT`,`Rank tracking depth must be from 1 to 100.`);if(e.provider!==void 0&&![`dataforseo`,`serpbase`].includes(e.provider))throw new C(`INVALID_INPUT`,`Exact rank collection supports dataforseo or serpbase.`);let r=e.provider===`serpbase`?25:1e3;if(e.keywordLimit!==void 0&&(!Number.isSafeInteger(e.keywordLimit)||e.keywordLimit<1||e.keywordLimit>r))throw new C(`INVALID_INPUT`,e.provider===`serpbase`?`Live SerpBase rank tracking can collect 1 to 25 keywords per run.`:`Queued rank tracking can collect 1 to 1000 keywords per run.`);let i={projectId:e.projectId,set:e.set,targetDomain:e.targetDomain,...e.tag?{tag:e.tag}:{},...n?{devices:n}:{},...e.provider?{provider:e.provider}:{},collectionMethod:e.provider===`serpbase`?`live`:`queued`,cadence:t,...e.depth===void 0?{}:{depth:e.depth},...e.keywordLimit===void 0?{}:{keywordLimit:e.keywordLimit},start:!0};return{name:`rank-tracking`,cron:`${e.minute} ${e.hour} * * *`,command:[`seo reports run rank-tracking`,`--params ${xf(JSON.stringify(i))}`,`--json`].join(` `)}}const Cf=T({meta:{name:`schedule`,description:`Print local cron entries for recurring SEO workflows`},subCommands:{cron:T({meta:{name:`cron`,description:`Print crontab lines for local recurring SEO workflows`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},url:{type:`string`,description:`Start URL for technical-watch. Defaults from the GSC property when possible.`},urls:{type:`string`,description:`Comma-separated URLs for index-watch.`},hour:{type:`string`,default:`9`,description:`Hour in local cron time. Defaults to 9.`},minute:{type:`string`,default:`0`,description:`Minute in local cron time. Defaults to 0.`},weekday:{type:`string`,description:`Weekly technical-watch day. Defaults to client setting, then Monday.`},day:{type:`string`,description:`Monthly report day. Defaults to client setting, then 1.`},"rank-set":{type:`string`,description:`Saved keyword set to collect with the rank-tracking report.`},"rank-domain":{type:`string`,description:`Target domain for exact rank matching.`},"rank-tag":{type:`string`,description:`Optional saved keyword tag to track.`},"rank-devices":{type:`string`,description:`Comma-separated desktop and mobile devices.`},"rank-depth":{type:`string`,description:`Organic result depth from 1 to 100.`},"rank-limit":{type:`string`,description:`Maximum saved keywords from 1 to 1000.`},"rank-provider":{type:`string`,description:`Connected provider for exact rank collection.`},"rank-cadence":{type:`string`,description:`Rank collection cadence: daily, weekly, or monthly.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t}}),r=n.site,i=O(e.url)??n.client?.startUrl??xs(n.site),a=j(e.hour)??9,o=j(e.minute)??0,s=j(e.weekday)??n.client?.technicalWeekday??1,c=j(e.day)??n.client?.reportDay??1,l=n.client?`--project ${xf(n.client.id)}`:`--site ${xf(r)}`,u=O(e.urls)??n.client?.watchUrls.join(`,`),d=[{name:`technical-watch`,cron:`${o} ${a} * * ${s}`,command:[`seo technical-watch`,l,i?`--url ${xf(i)}`:void 0,u?`--urls ${xf(u)}`:void 0,`--json`].filter(Boolean).join(` `)},{name:`monthly-report`,cron:`${o} ${a} ${c} * *`,command:[`seo monthly-report`,l,`--json`].join(` `)}],f=O(e[`rank-set`]),p=O(e[`rank-domain`]);if(f||p){if(!f||!p)throw new C(`INVALID_INPUT`,`Pass both --rank-set and --rank-domain for scheduled rank tracking.`);if(!n.client)throw new C(`INVALID_INPUT`,`Scheduled rank tracking needs a saved project profile.`);d.push(Sf({projectId:n.client.id,set:f,targetDomain:p,tag:O(e[`rank-tag`]),devices:P(e[`rank-devices`]),depth:j(e[`rank-depth`]),keywordLimit:j(e[`rank-limit`]),provider:O(e[`rank-provider`]),cadence:O(e[`rank-cadence`]),hour:a,minute:o,weekday:s,day:c}))}if(t){R({site:r,lines:d});return}let m=Vn();z([[`Property`,r],[`Install`,`crontab -e`]]);for(let e of d)process.stdout.write(`${e.cron} seo logs prune --quiet; ${e.command} >> ${xf(`${m.logDir}/${e.name}.log`)} 2>&1\n`)}})}}),wf=T({meta:{name:`server-logs`,description:`Analyze local web server access logs`},subCommands:{analyze:T({meta:{name:`analyze`,description:`Stream a local access log into bounded crawler evidence`},args:{file:{type:`string`,description:`Local combined, JSONL, or NDJSON access log.`,required:!0},format:{type:`string`,description:`Input format override: combined or jsonl.`},"row-limit":{type:`string`,description:`Maximum rows to parse. Defaults to 1000000.`},"path-limit":{type:`string`,description:`Maximum crawler and path aggregates to retain. Defaults to 25000.`},limit:{type:`string`,description:`Maximum crawler path rows returned. Defaults to 100.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},csv:{type:`string`,description:`CSV table: crawler-summary, crawler-paths, crawler-errors, or status-codes.`},output:{type:`string`,description:`Write CSV output to this path instead of stdout.`}},run:async({args:e})=>{let t=O(e.file);if(!t)throw new C(`INVALID_INPUT`,`Pass --file.`);let n=F(e),r=e.csv===void 0?void 0:Tf(e.csv),i=O(e.output);if(n&&r)throw new C(`INVALID_INPUT`,`Use either --json or --csv, not both.`);if(i&&!r)throw new C(`INVALID_INPUT`,`--output requires --csv.`);let a=O(e.format);if(a&&![`combined`,`jsonl`].includes(a))throw new C(`INVALID_INPUT`,`--format must be combined or jsonl.`);let o=await Sr({file:t,format:a,rowLimit:M(e[`row-limit`],`--row-limit`),pathLimit:M(e[`path-limit`],`--path-limit`)}),s=f({evidence:o,limit:M(e.limit,`--limit`)});if(r){let e=rt(o,r);await Ef(i,e.content),e.capped&&process.stderr.write(`Warning: ${e.omittedRows.toLocaleString()} CSV rows were omitted by the export limit.\n`);return}if(n){R(s);return}K({title:`Server log report`,status:s.dataStatus===`complete`?s.summary.invalidRows>0?`warning`:`info`:`unknown`,summary:`${W(s.summary.crawlerRows)} crawler requests found in ${W(s.summary.parsedRows)} parsed requests.`,metrics:[{label:`Evidence`,value:s.dataStatus},{label:`Parsed requests`,value:W(s.summary.parsedRows)},{label:`Crawler requests`,value:W(s.summary.crawlerRows)},{label:`Crawler families`,value:W(s.crawlers.length)},{label:`Invalid rows`,value:W(s.summary.invalidRows)},{label:`Returned paths`,value:`${W(s.selection.returnedCrawlerPaths)} of ${W(s.selection.availableCrawlerPaths)}`}]}),s.crawlers.length&&(process.stdout.write(`
+`),Mo(`How to verify`,n.howToVerify)}});function Cf(e){return JSON.stringify(e)}function wf(e){let t=e.cadence??`weekly`;if(![`daily`,`weekly`,`monthly`].includes(t))throw new C(`INVALID_INPUT`,`Rank tracking cron cadence must be daily, weekly, or monthly.`);let n=e.devices?.length?[...new Set(e.devices)]:void 0;if(n?.some(e=>![`desktop`,`mobile`].includes(e))||(n?.length??0)>2)throw new C(`INVALID_INPUT`,`Rank tracking devices must be desktop, mobile, or both.`);if(e.depth!==void 0&&(!Number.isSafeInteger(e.depth)||e.depth<1||e.depth>100))throw new C(`INVALID_INPUT`,`Rank tracking depth must be from 1 to 100.`);if(e.provider!==void 0&&![`dataforseo`,`serpbase`].includes(e.provider))throw new C(`INVALID_INPUT`,`Exact rank collection supports dataforseo or serpbase.`);let r=e.provider===`serpbase`?25:1e3;if(e.keywordLimit!==void 0&&(!Number.isSafeInteger(e.keywordLimit)||e.keywordLimit<1||e.keywordLimit>r))throw new C(`INVALID_INPUT`,e.provider===`serpbase`?`Live SerpBase rank tracking can collect 1 to 25 keywords per run.`:`Queued rank tracking can collect 1 to 1000 keywords per run.`);let i={projectId:e.projectId,set:e.set,targetDomain:e.targetDomain,...e.tag?{tag:e.tag}:{},...n?{devices:n}:{},...e.provider?{provider:e.provider}:{},collectionMethod:e.provider===`serpbase`?`live`:`queued`,cadence:t,...e.depth===void 0?{}:{depth:e.depth},...e.keywordLimit===void 0?{}:{keywordLimit:e.keywordLimit},start:!0};return{name:`rank-tracking`,cron:`${e.minute} ${e.hour} * * *`,command:[`seo reports run rank-tracking`,`--params ${Cf(JSON.stringify(i))}`,`--json`].join(` `)}}const Tf=T({meta:{name:`schedule`,description:`Print local cron entries for recurring SEO workflows`},subCommands:{cron:T({meta:{name:`cron`,description:`Print crontab lines for local recurring SEO workflows`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},url:{type:`string`,description:`Start URL for technical-watch. Defaults from the GSC property when possible.`},urls:{type:`string`,description:`Comma-separated URLs for index-watch.`},hour:{type:`string`,default:`9`,description:`Hour in local cron time. Defaults to 9.`},minute:{type:`string`,default:`0`,description:`Minute in local cron time. Defaults to 0.`},weekday:{type:`string`,description:`Weekly technical-watch day. Defaults to client setting, then Monday.`},day:{type:`string`,description:`Monthly report day. Defaults to client setting, then 1.`},"rank-set":{type:`string`,description:`Saved keyword set to collect with the rank-tracking report.`},"rank-domain":{type:`string`,description:`Target domain for exact rank matching.`},"rank-tag":{type:`string`,description:`Optional saved keyword tag to track.`},"rank-devices":{type:`string`,description:`Comma-separated desktop and mobile devices.`},"rank-depth":{type:`string`,description:`Organic result depth from 1 to 100.`},"rank-limit":{type:`string`,description:`Maximum saved keywords from 1 to 1000.`},"rank-provider":{type:`string`,description:`Connected provider for exact rank collection.`},"rank-cadence":{type:`string`,description:`Rank collection cadence: daily, weekly, or monthly.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t}}),r=n.site,i=O(e.url)??n.client?.startUrl??Cs(n.site),a=j(e.hour)??9,o=j(e.minute)??0,s=j(e.weekday)??n.client?.technicalWeekday??1,c=j(e.day)??n.client?.reportDay??1,l=n.client?`--project ${Cf(n.client.id)}`:`--site ${Cf(r)}`,u=O(e.urls)??n.client?.watchUrls.join(`,`),d=[{name:`technical-watch`,cron:`${o} ${a} * * ${s}`,command:[`seo technical-watch`,l,i?`--url ${Cf(i)}`:void 0,u?`--urls ${Cf(u)}`:void 0,`--json`].filter(Boolean).join(` `)},{name:`monthly-report`,cron:`${o} ${a} ${c} * *`,command:[`seo monthly-report`,l,`--json`].join(` `)}],f=O(e[`rank-set`]),p=O(e[`rank-domain`]);if(f||p){if(!f||!p)throw new C(`INVALID_INPUT`,`Pass both --rank-set and --rank-domain for scheduled rank tracking.`);if(!n.client)throw new C(`INVALID_INPUT`,`Scheduled rank tracking needs a saved project profile.`);d.push(wf({projectId:n.client.id,set:f,targetDomain:p,tag:O(e[`rank-tag`]),devices:P(e[`rank-devices`]),depth:j(e[`rank-depth`]),keywordLimit:j(e[`rank-limit`]),provider:O(e[`rank-provider`]),cadence:O(e[`rank-cadence`]),hour:a,minute:o,weekday:s,day:c}))}if(t){R({site:r,lines:d});return}let m=Vn();z([[`Property`,r],[`Install`,`crontab -e`]]);for(let e of d)process.stdout.write(`${e.cron} seo logs prune --quiet; ${e.command} >> ${Cf(`${m.logDir}/${e.name}.log`)} 2>&1\n`)}})}}),Ef=T({meta:{name:`server-logs`,description:`Analyze local web server access logs`},subCommands:{analyze:T({meta:{name:`analyze`,description:`Stream a local access log into bounded crawler evidence`},args:{file:{type:`string`,description:`Local combined, JSONL, or NDJSON access log.`,required:!0},format:{type:`string`,description:`Input format override: combined or jsonl.`},"row-limit":{type:`string`,description:`Maximum rows to parse. Defaults to 1000000.`},"path-limit":{type:`string`,description:`Maximum crawler and path aggregates to retain. Defaults to 25000.`},limit:{type:`string`,description:`Maximum crawler path rows returned. Defaults to 100.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},csv:{type:`string`,description:`CSV table: crawler-summary, crawler-paths, crawler-errors, or status-codes.`},output:{type:`string`,description:`Write CSV output to this path instead of stdout.`}},run:async({args:e})=>{let t=O(e.file);if(!t)throw new C(`INVALID_INPUT`,`Pass --file.`);let n=F(e),r=e.csv===void 0?void 0:Df(e.csv),i=O(e.output);if(n&&r)throw new C(`INVALID_INPUT`,`Use either --json or --csv, not both.`);if(i&&!r)throw new C(`INVALID_INPUT`,`--output requires --csv.`);let a=O(e.format);if(a&&![`combined`,`jsonl`].includes(a))throw new C(`INVALID_INPUT`,`--format must be combined or jsonl.`);let o=await Sr({file:t,format:a,rowLimit:M(e[`row-limit`],`--row-limit`),pathLimit:M(e[`path-limit`],`--path-limit`)}),s=f({evidence:o,limit:M(e.limit,`--limit`)});if(r){let e=rt(o,r);await Of(i,e.content),e.capped&&process.stderr.write(`Warning: ${e.omittedRows.toLocaleString()} CSV rows were omitted by the export limit.\n`);return}if(n){R(s);return}K({title:`Server log report`,status:s.dataStatus===`complete`?s.summary.invalidRows>0?`warning`:`info`:`unknown`,summary:`${W(s.summary.crawlerRows)} crawler requests found in ${W(s.summary.parsedRows)} parsed requests.`,metrics:[{label:`Evidence`,value:s.dataStatus},{label:`Parsed requests`,value:W(s.summary.parsedRows)},{label:`Crawler requests`,value:W(s.summary.crawlerRows)},{label:`Crawler families`,value:W(s.crawlers.length)},{label:`Invalid rows`,value:W(s.summary.invalidRows)},{label:`Returned paths`,value:`${W(s.selection.returnedCrawlerPaths)} of ${W(s.selection.availableCrawlerPaths)}`}]}),s.crawlers.length&&(process.stdout.write(`
 Crawler activity
 `),q([`Crawler`,`Type`,`Requests`,`4xx`,`5xx`],s.crawlers.map(e=>[e.family,e.category,String(e.requests),String(e.clientError),String(e.serverError)]))),s.crawlerPaths.length&&(process.stdout.write(`
 Crawler paths
-`),q([`Crawler`,`Path`,`Requests`,`4xx`,`5xx`],s.crawlerPaths.map(e=>[e.family,G(e.path,72),String(e.requests),String(e.clientError),String(e.serverError)])));for(let e of s.warnings)process.stdout.write(`\nWarning: ${e}\n`);process.stdout.write(`\nNote: ${s.caveats[0]}\n`)}})}});function Tf(e){let t=O(e);if(t&&[`crawler-summary`,`crawler-paths`,`crawler-errors`,`status-codes`].includes(t))return t;throw new C(`INVALID_INPUT`,`CSV table must be crawler-summary, crawler-paths, crawler-errors, or status-codes.`)}async function Ef(e,t){if(!e){process.stdout.write(t);return}await li(Qr(e),{recursive:!0}),await _i(e,t),process.stdout.write(`Wrote ${e}\n`)}function Df(){return kf(`skills`,process.env.SEO_SKILLS_DIR)}function Of(){return kf(`evals`,process.env.SEO_EVALS_DIR)}function kf(e,t){if(t)return ri(t);let n=Qr(bi(import.meta.url));for(let t=0;t<6;t+=1){let t=w(n,e);if(Ur(w(t,`README.md`)))return t;n=Qr(n)}throw new C(`INTERNAL_ERROR`,`Packaged ${e} could not be found. Reinstall \`seo\` and try again.`)}function Af(e){return Gr(w(e,`SKILL.md`),`utf8`).match(/^description:\s*(.+)$/m)?.[1]?.trim()??``}const jf=`claude -p`;function Mf(){let e=Of();return Kr(e,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.json`)).map(t=>({subject:Zr(t.name,`.json`),path:w(e,t.name)})).sort((e,t)=>e.subject<t.subject?-1:+(e.subject>t.subject))}function Nf(e,t){let n;try{n=Gr(t,`utf8`)}catch{throw new C(`INVALID_INPUT`,`Cannot read eval file for ${e}.`)}let r;try{r=JSON.parse(n)}catch{throw new C(`INVALID_INPUT`,`Eval file ${e}.json is not valid JSON.`)}if(!r||typeof r!=`object`||Array.isArray(r))throw new C(`INVALID_INPUT`,`Eval file ${e}.json must be an object.`);let i=r;if(i.subject!==e)throw new C(`INVALID_INPUT`,`Eval file ${e}.json must set subject to "${e}".`);if(!Array.isArray(i.evals)||i.evals.length===0)throw new C(`INVALID_INPUT`,`Eval file ${e}.json must have a non-empty evals array.`);let a=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 C(`INVALID_INPUT`,`${i}: id must be an integer.`);let o=r.id;if(a.has(o))throw new C(`INVALID_INPUT`,`${i}: duplicate id ${o}.`);if(a.add(o),typeof r.prompt!=`string`||r.prompt.trim().length===0)throw new C(`INVALID_INPUT`,`${i}: prompt must be a non-empty string.`);if(typeof r.expected_output!=`string`||r.expected_output.trim().length===0)throw new C(`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 C(`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 C(`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 Pf(){let e=w(Df(),`seo`,`SKILL.md`);if(!Ur(e))throw new C(`INTERNAL_ERROR`,"The seo router skill could not be found. Reinstall `seo` or use --no-skill.");return Gr(e,`utf8`)}function Ff(e){let t=[],n=``,r=!1,i=!1,a=!1;for(let o=0;o<e.length;o+=1){let s=e[o];if(i){s===`'`?i=!1:n+=s,r=!0;continue}if(a){s===`"`?a=!1:s===`\\`&&(e[o+1]===`"`||e[o+1]===`\\`)?(n+=e[o+1],o+=1):n+=s,r=!0;continue}if(s===`'`){i=!0,r=!0;continue}if(s===`"`){a=!0,r=!0;continue}if(s===`\\`){o+1<e.length&&(n+=e[o+1],o+=1,r=!0);continue}if(s===` `||s===`	`||s===`
-`||s===`\r`){r&&=(t.push(n),n=``,!1);continue}n+=s,r=!0}if(i||a)throw new C(`INVALID_INPUT`,`Unbalanced quote in agent command.`);return r&&t.push(n),t}function If(e,t){let n=Ff(e);if(n.length===0)throw new C(`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 Lf(e,t){return e?`${e.trim()}\n\n---\n\nUser request:\n${t}`:t}function Rf(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(`
+`),q([`Crawler`,`Path`,`Requests`,`4xx`,`5xx`],s.crawlerPaths.map(e=>[e.family,G(e.path,72),String(e.requests),String(e.clientError),String(e.serverError)])));for(let e of s.warnings)process.stdout.write(`\nWarning: ${e}\n`);process.stdout.write(`\nNote: ${s.caveats[0]}\n`)}})}});function Df(e){let t=O(e);if(t&&[`crawler-summary`,`crawler-paths`,`crawler-errors`,`status-codes`].includes(t))return t;throw new C(`INVALID_INPUT`,`CSV table must be crawler-summary, crawler-paths, crawler-errors, or status-codes.`)}async function Of(e,t){if(!e){process.stdout.write(t);return}await li(Qr(e),{recursive:!0}),await _i(e,t),process.stdout.write(`Wrote ${e}\n`)}function kf(){return jf(`skills`,process.env.SEO_SKILLS_DIR)}function Af(){return jf(`evals`,process.env.SEO_EVALS_DIR)}function jf(e,t){if(t)return ri(t);let n=Qr(bi(import.meta.url));for(let t=0;t<6;t+=1){let t=w(n,e);if(Ur(w(t,`README.md`)))return t;n=Qr(n)}throw new C(`INTERNAL_ERROR`,`Packaged ${e} could not be found. Reinstall \`seo\` and try again.`)}function Mf(e){return Gr(w(e,`SKILL.md`),`utf8`).match(/^description:\s*(.+)$/m)?.[1]?.trim()??``}const Nf=`claude -p`;function Pf(){let e=Af();return Kr(e,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.json`)).map(t=>({subject:Zr(t.name,`.json`),path:w(e,t.name)})).sort((e,t)=>e.subject<t.subject?-1:+(e.subject>t.subject))}function Ff(e,t){let n;try{n=Gr(t,`utf8`)}catch{throw new C(`INVALID_INPUT`,`Cannot read eval file for ${e}.`)}let r;try{r=JSON.parse(n)}catch{throw new C(`INVALID_INPUT`,`Eval file ${e}.json is not valid JSON.`)}if(!r||typeof r!=`object`||Array.isArray(r))throw new C(`INVALID_INPUT`,`Eval file ${e}.json must be an object.`);let i=r;if(i.subject!==e)throw new C(`INVALID_INPUT`,`Eval file ${e}.json must set subject to "${e}".`);if(!Array.isArray(i.evals)||i.evals.length===0)throw new C(`INVALID_INPUT`,`Eval file ${e}.json must have a non-empty evals array.`);let a=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 C(`INVALID_INPUT`,`${i}: id must be an integer.`);let o=r.id;if(a.has(o))throw new C(`INVALID_INPUT`,`${i}: duplicate id ${o}.`);if(a.add(o),typeof r.prompt!=`string`||r.prompt.trim().length===0)throw new C(`INVALID_INPUT`,`${i}: prompt must be a non-empty string.`);if(typeof r.expected_output!=`string`||r.expected_output.trim().length===0)throw new C(`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 C(`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 C(`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 If(){let e=w(kf(),`seo`,`SKILL.md`);if(!Ur(e))throw new C(`INTERNAL_ERROR`,"The seo router skill could not be found. Reinstall `seo` or use --no-skill.");return Gr(e,`utf8`)}function Lf(e){let t=[],n=``,r=!1,i=!1,a=!1;for(let o=0;o<e.length;o+=1){let s=e[o];if(i){s===`'`?i=!1:n+=s,r=!0;continue}if(a){s===`"`?a=!1:s===`\\`&&(e[o+1]===`"`||e[o+1]===`\\`)?(n+=e[o+1],o+=1):n+=s,r=!0;continue}if(s===`'`){i=!0,r=!0;continue}if(s===`"`){a=!0,r=!0;continue}if(s===`\\`){o+1<e.length&&(n+=e[o+1],o+=1,r=!0);continue}if(s===` `||s===`	`||s===`
+`||s===`\r`){r&&=(t.push(n),n=``,!1);continue}n+=s,r=!0}if(i||a)throw new C(`INVALID_INPUT`,`Unbalanced quote in agent command.`);return r&&t.push(n),t}function Rf(e,t){let n=Lf(e);if(n.length===0)throw new C(`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 zf(e,t){return e?`${e.trim()}\n\n---\n\nUser request:\n${t}`:t}function Bf(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 zf(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);continue}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 Bf(e,t){let n=zf(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 Vf(e,t){return new Promise(n=>{let r=Date.now(),[i,...a]=e,o;try{o=xi(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),p=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=>{p({stdout:s,stderr:c,code:null,timedOut:u,spawnError:e.message})}),o.on(`close`,e=>{p({stdout:s,stderr:c,code:e,timedOut:u})}),o.stdin&&(t.input===void 0?o.stdin.end():o.stdin.end(t.input))})}async function Hf(e,t,n){let{argv:r,usesPlaceholder:i}=If(e,t);return Vf(r,{input:i?void 0:t,timeoutMs:n})}async function Uf(e,t){let n=Date.now(),r=Lf(t.skillBody,e.prompt),i=await Hf(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:Wf(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:Wf(e.assertions)};if(a.length===0)return{...o,status:`errored`,error:`Agent returned no output on stdout.`,durationMs:Date.now()-n,assertions:Wf(e.assertions)};if(!t.judge)return{...o,status:`unjudged`,durationMs:Date.now()-n,assertions:Wf(e.assertions)};let s=0,c=``;for(let r=0;r<2;r+=1){let i=Rf(e.prompt,a,e.assertions,r>0),l=await Hf(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:Wf(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:Wf(e.assertions)};let u=Bf(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:Wf(e.assertions)}}function Wf(e){return e.map(e=>({assertion:e,verdict:`unjudged`}))}async function Gf(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 Kf(e){let t={passed:0,failed:0,errored:0,unjudged:0};for(let n of e)t[n.status]+=1;return t}function qf(e){let t=[],n=O(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 Jf(e){let t=Mf();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 C(`INVALID_INPUT`,`Unknown eval subject: ${e}.${n?` Known subjects: ${n}.`:``}`)}return r})}function Yf(e){let t=Mf().map(e=>{let t=Nf(e.subject,e.path);return{subject:e.subject,evals:t.evals.length}});if(e){R({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 Vf(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);continue}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 Hf(e,t){let n=Vf(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 Uf(e,t){return new Promise(n=>{let r=Date.now(),[i,...a]=e,o;try{o=xi(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),p=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=>{p({stdout:s,stderr:c,code:null,timedOut:u,spawnError:e.message})}),o.on(`close`,e=>{p({stdout:s,stderr:c,code:e,timedOut:u})}),o.stdin&&(t.input===void 0?o.stdin.end():o.stdin.end(t.input))})}async function Wf(e,t,n){let{argv:r,usesPlaceholder:i}=Rf(e,t);return Uf(r,{input:i?void 0:t,timeoutMs:n})}async function Gf(e,t){let n=Date.now(),r=zf(t.skillBody,e.prompt),i=await Wf(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:Kf(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:Kf(e.assertions)};if(a.length===0)return{...o,status:`errored`,error:`Agent returned no output on stdout.`,durationMs:Date.now()-n,assertions:Kf(e.assertions)};if(!t.judge)return{...o,status:`unjudged`,durationMs:Date.now()-n,assertions:Kf(e.assertions)};let s=0,c=``;for(let r=0;r<2;r+=1){let i=Bf(e.prompt,a,e.assertions,r>0),l=await Wf(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:Kf(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:Kf(e.assertions)};let u=Hf(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:Kf(e.assertions)}}function Kf(e){return e.map(e=>({assertion:e,verdict:`unjudged`}))}async function qf(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 Jf(e){let t={passed:0,failed:0,errored:0,unjudged:0};for(let n of e)t[n.status]+=1;return t}function Yf(e){let t=[],n=O(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 Xf(e){let t=Pf();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 C(`INVALID_INPUT`,`Unknown eval subject: ${e}.${n?` Known subjects: ${n}.`:``}`)}return r})}function Zf(e){let t=Pf().map(e=>{let t=Ff(e.subject,e.path);return{subject:e.subject,evals:t.evals.length}});if(e){R({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 Xf(e){return e===`passed`?`PASS`:e===`failed`?`FAIL`:e===`errored`?`ERROR`:`UNJUDGED`}function Zf(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 Qf(e){return e===`passed`?`PASS`:e===`failed`?`FAIL`:e===`errored`?`ERROR`:`UNJUDGED`}function $f(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[${Xf(e.status)}] eval ${e.id} (${e.durationMs}ms)\n`),process.stdout.write(`  prompt: ${$f(e.prompt,100)}\n`),e.error&&process.stdout.write(`  error: ${e.error}\n`),!t.judged){process.stdout.write(`  reply: ${$f(e.reply,200)}\n`),process.stdout.write(`  assertions to review:
-`);for(let t of e.assertions)process.stdout.write(`    - [ ] ${t.assertion}\n`);continue}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=Kf(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=Qf(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 Qf(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 $f(e,t){let n=e.replace(/\s+/g,` `).trim();return n.length>t?`${n.slice(0,t-1)}…`:n}const ep=T({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:jf,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:Fa(`Judge assertions with an agent.`,`Skip judging and print replies with an assertion checklist.`),skill:Fa(`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=F(e);if(e.list===!0){Yf(t);return}let n=Jf(qf(e)),r=j(e.id);if(r!==void 0&&n.length!==1)throw new C(`INVALID_INPUT`,`--id needs exactly one subject. Name the subject to filter.`);let i=j(e.timeout)??300;if(!(i>0))throw new C(`INVALID_INPUT`,`--timeout must be a positive number of seconds.`);let a=Math.max(1,Math.min(4,j(e.concurrency)??1)),o=O(e.agent)??jf,s=e.judge===!1?null:O(e[`judge-agent`])??o,c=e.skill===!1?null:Pf(),l={agent:o,judge:s,skillBody:c,timeoutMs:i*1e3},u=[];for(let e of n){let n=Nf(e.subject,e.path).evals;if(r!==void 0&&(n=n.filter(e=>e.id===r),n.length===0))throw new C(`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 Gf(n,a,e=>Uf(e,l)),o=Kf(i);u.push({subject:e.subject,...o,evals:i})}let d=Qf(u),f=d.failed>0||d.errored>0;t?R({schemaVersion:1,agent:o,judge:s,judged:s!==null,skillContext:c!==null,timeoutSeconds:i,concurrency:a,subjects:u,totals:d}):Zf(u,{judged:s!==null,agent:o,judge:s}),f&&(process.exitCode=1)}});function tp(){let e=Df();return Kr(e,{withFileTypes:!0}).filter(t=>t.isDirectory()&&Ur(w(e,t.name,`SKILL.md`))).map(t=>({name:t.name,description:Af(w(e,t.name)),path:w(e,t.name)})).sort((e,t)=>e.name<t.name?-1:+(e.name>t.name))}function np(e){let t=tp();if(!e)return t;let n=t.find(t=>t.name===e);if(!n)throw new C(`INVALID_INPUT`,`Unknown skill: ${e}.`);return[n]}const rp=T({meta:{name:`skill`,description:`Inspect the packaged SEO skill and run its evals`},subCommands:{list:T({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=tp();if(F(e)){R({skills:t});return}Do(`SEO skill`,`Packaged with this CLI.`),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[${Qf(e.status)}] eval ${e.id} (${e.durationMs}ms)\n`),process.stdout.write(`  prompt: ${tp(e.prompt,100)}\n`),e.error&&process.stdout.write(`  error: ${e.error}\n`),!t.judged){process.stdout.write(`  reply: ${tp(e.reply,200)}\n`),process.stdout.write(`  assertions to review:
+`);for(let t of e.assertions)process.stdout.write(`    - [ ] ${t.assertion}\n`);continue}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=Jf(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=ep(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 ep(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 tp(e,t){let n=e.replace(/\s+/g,` `).trim();return n.length>t?`${n.slice(0,t-1)}…`:n}const np=T({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:Nf,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:Fa(`Judge assertions with an agent.`,`Skip judging and print replies with an assertion checklist.`),skill:Fa(`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=F(e);if(e.list===!0){Zf(t);return}let n=Xf(Yf(e)),r=j(e.id);if(r!==void 0&&n.length!==1)throw new C(`INVALID_INPUT`,`--id needs exactly one subject. Name the subject to filter.`);let i=j(e.timeout)??300;if(!(i>0))throw new C(`INVALID_INPUT`,`--timeout must be a positive number of seconds.`);let a=Math.max(1,Math.min(4,j(e.concurrency)??1)),o=O(e.agent)??Nf,s=e.judge===!1?null:O(e[`judge-agent`])??o,c=e.skill===!1?null:If(),l={agent:o,judge:s,skillBody:c,timeoutMs:i*1e3},u=[];for(let e of n){let n=Ff(e.subject,e.path).evals;if(r!==void 0&&(n=n.filter(e=>e.id===r),n.length===0))throw new C(`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 qf(n,a,e=>Gf(e,l)),o=Jf(i);u.push({subject:e.subject,...o,evals:i})}let d=ep(u),f=d.failed>0||d.errored>0;t?R({schemaVersion:1,agent:o,judge:s,judged:s!==null,skillContext:c!==null,timeoutSeconds:i,concurrency:a,subjects:u,totals:d}):$f(u,{judged:s!==null,agent:o,judge:s}),f&&(process.exitCode=1)}});function rp(){let e=kf();return Kr(e,{withFileTypes:!0}).filter(t=>t.isDirectory()&&Ur(w(e,t.name,`SKILL.md`))).map(t=>({name:t.name,description:Mf(w(e,t.name)),path:w(e,t.name)})).sort((e,t)=>e.name<t.name?-1:+(e.name>t.name))}function ip(e){let t=rp();if(!e)return t;let n=t.find(t=>t.name===e);if(!n)throw new C(`INVALID_INPUT`,`Unknown skill: ${e}.`);return[n]}const ap=T({meta:{name:`skill`,description:`Inspect the packaged SEO skill and run its evals`},subCommands:{list:T({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=rp();if(F(e)){R({skills:t});return}Do(`SEO skill`,`Packaged with this CLI.`),process.stdout.write(`
 `);for(let e of t)z([[`Name`,e.name],[`Purpose`,`Helps agents choose and run the right SEO audit or report.`],[`Path`,e.path]]);process.stdout.write(`
-`),Eo({title:`Add it to an agent`,body:`Run setup to install the skill and connect your first site.`,command:`seo start`})}}),path:T({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=O(e.name),n=t?np(t)[0]?.path:Df();F(e)?R({name:t,path:n}):process.stdout.write(`${n}\n`)}}),install:T({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=F(e),n=tc({quiet:t});if(t){R(n),n.status===`failed`&&(process.exitCode=1);return}if(n.status===`failed`)throw new C(`INTERNAL_ERROR`,`Skill install failed: ${n.error}`);process.stdout.write(`SEO skill installed. Agents that support skills can discover it now.
-`)}}),eval:ep}}),ip=T({meta:{name:`privacy`,description:`Show local config, token, cache, and log storage paths`},run:async()=>{let e=_t(),t=It();z(e.map(e=>[e.label,`${e.path} · ${Fo(e.sizeBytes)} · ${e.mode}`])),process.stdout.write(`
-`),z(Object.entries(t.counts).map(([e,t])=>[e,String(t)]))}}),ap=T({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=F(e);if(!e.yes&&!L({json:t}))throw new C(`INVALID_INPUT`,`Cannot prompt here. Pass --yes to confirm reset.`);if(!(e.yes||V(await Ei({message:`Delete saved credentials and all local data?`,initialValue:!1})))){Ti(`Reset aborted.`);return}await $e(),t?R({reset:!0}):process.stdout.write(`Reset complete.
-`)}}),op=T({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 m(A(e.refresh),O(e.account));if(F(e)){R({sites:t});return}B([`Property`,`Permission`],t.map(e=>[e.siteUrl,e.permissionLevel??`unknown`]))}}),sp=T({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 Et({product:O(e.product),limit:j(e.limit)});if(F(e)){R({updates:t});return}jo(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.`})}}),cp={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 lp(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 up(e,t){let n=lp(e);if(t){R(n);return}z([[`Anonymous telemetry`,e.enabled?`enabled`:`disabled`],[`Reason`,e.reason?cp[e.reason]:`local setting`],[`State file`,e.stateFile],[`Install cohort`,e.state?.cohort??`not created`]]),process.stdout.write(`
+`),Eo({title:`Add it to an agent`,body:`Run setup to install the skill and connect your first site.`,command:`seo start`})}}),path:T({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=O(e.name),n=t?ip(t)[0]?.path:kf();F(e)?R({name:t,path:n}):process.stdout.write(`${n}\n`)}}),install:T({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=F(e),n=rc({quiet:t});if(t){R(n),n.status===`failed`&&(process.exitCode=1);return}if(n.status===`failed`)throw new C(`INTERNAL_ERROR`,`Skill install failed: ${n.error}`);process.stdout.write(`SEO skill installed. Agents that support skills can discover it now.
+`)}}),eval:np}}),op=T({meta:{name:`privacy`,description:`Show local config, token, cache, and log storage paths`},run:async()=>{let e=_t(),t=It();z(e.map(e=>[e.label,`${e.path} · ${Fo(e.sizeBytes)} · ${e.mode}`])),process.stdout.write(`
+`),z(Object.entries(t.counts).map(([e,t])=>[e,String(t)]))}}),sp=T({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=F(e);if(!e.yes&&!L({json:t}))throw new C(`INVALID_INPUT`,`Cannot prompt here. Pass --yes to confirm reset.`);if(!(e.yes||V(await Ei({message:`Delete saved credentials and all local data?`,initialValue:!1})))){Ti(`Reset aborted.`);return}await $e(),t?R({reset:!0}):process.stdout.write(`Reset complete.
+`)}}),cp=T({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 m(A(e.refresh),O(e.account));if(F(e)){R({sites:t});return}B([`Property`,`Permission`],t.map(e=>[e.siteUrl,e.permissionLevel??`unknown`]))}}),lp=T({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 Et({product:O(e.product),limit:j(e.limit)});if(F(e)){R({updates:t});return}jo(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.`})}}),up={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 dp(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 fp(e,t){let n=dp(e);if(t){R(n);return}z([[`Anonymous telemetry`,e.enabled?`enabled`:`disabled`],[`Reason`,e.reason?up[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 dp={type:`boolean`,default:!1,description:`Print machine-readable JSON.`},fp=T({meta:{name:`telemetry`,description:`Check or change anonymous usage telemetry`},subCommands:{status:T({meta:{name:`status`,description:`Show whether anonymous usage telemetry is enabled`},args:{json:dp},run:async({args:e})=>up(qt(),F(e))}),enable:T({meta:{name:`enable`,description:`Enable anonymous usage telemetry in local settings`},args:{json:dp},run:async({args:e})=>{up(jn(!0),F(e))}}),disable:T({meta:{name:`disable`,description:`Disable anonymous usage telemetry in local settings`},args:{json:dp},run:async({args:e})=>{up(jn(!1),F(e))}})}}),pp=T({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. Optional when --project has a saved crawl URL.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...el,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=F(e),n=k(e),r=await gp(e),i=hp(e),a=O(e.site)||n||!i&&!r.length?await H({client:n,site:O(e.site),options:{json:t}}):void 0,o=i??a?.client?.startUrl??(a?.site?xs(a.site):void 0)??r[0];if(!o)throw Error(`No crawl URL selected. Pass a URL, --url, or use --project with a saved crawl URL.`);let s=await Pn({url:o,projectId:a?.client?.id,site:a?.site,mode:mp(e.mode)??(r.length?`list`:void 0),urls:r,maxPages:j(e[`max-pages`]),maxDepth:j(e[`max-depth`]),concurrency:j(e.concurrency),refresh:A(e.refresh),fetchRate:Ba({...e,"fetch-concurrency":e.concurrency}),include:N(e.include),exclude:N(e.exclude),googleAnalyticsPropertyId:O(e[`google-analytics-property`]),analyticsConnection:tl(e,Yn(a?.client)),useSitemap:!La(e,`sitemap`),respectRobots:!La(e,`robots`),checkExternal:!La(e,`external`),js:!!A(e.js),limit:j(e.limit)});if(t){R(s);return}Bu(s),B([`Rank`,`Score`,`Rule`,`Severity`,`Affected`,`Target`,`Action`],s.output.queue.map((e,t)=>[t+1,e.score,e.ruleId,e.severity,e.affectedUrls,e.target,e.action])),J(`Implementation queue details`,s.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 mp(e){let t=O(e);if(t){if([`site`,`page`,`list`,`sitemap`].includes(t))return t;throw Error(`Mode must be one of: site, page, list, sitemap.`)}}function hp(e){let t=O(e.crawlUrl),n=O(e.url);if(t&&n&&t!==n)throw Error(`Use either a URL argument or --url, not both.`);return t??n}async function gp(e){let t=N(e.urls)??[],n=O(e[`urls-file`]);return n&&t.push(..._p(await di(n,`utf8`))),[...new Set(t)]}function _p(e){return e.split(/[\n,]/).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`))}function vp(e,t){let{narrative:n}=e.output,{diagnosis:r}=n;return{...e,...t?{workflow:t}:{},output:{narrative:{site:n.site,generatedAt:n.generatedAt,dataStatus:n.dataStatus,periodDays:n.periodDays,period:n.period,headline:n.headline,caveats:n.caveats,sections:n.sections,priorities:n.priorities,diagnosis:{site:r.site,generatedAt:r.generatedAt,dataStatus:r.dataStatus,summary:r.summary,skippedSections:r.skippedSections,partialReasons:r.partialReasons,priorities:r.priorities}}}}}function yp(e){return/^[A-Za-z0-9_./:@-]+$/.test(e)?e:`'${e.replaceAll(`'`,`'\\''`)}'`}function bp(e){try{return new URL(e).origin}catch{throw new C(`INVALID_INPUT`,`Pass a valid absolute URL with --url.`)}}function xp(e){let t=e.topRows??20,{evidence:n}=e;return{source:n.source,exportedAt:n.exportedAt,importedAt:n.importedAt,files:n.files,queries:{totalRows:n.queries.totalRows,capped:n.queries.capped,topRowsShown:Math.min(t,n.queries.rows.length),rows:n.queries.rows.slice(0,t)},pages:{totalRows:n.pages.totalRows,capped:n.pages.capped,topRowsShown:Math.min(t,n.pages.rows.length),rows:n.pages.rows.slice(0,t)},...e.reconciliation?{reconciliation:e.reconciliation}:{},...e.pageInventory?{pageInventory:e.pageInventory}:{},warnings:n.warnings,caveats:n.caveats}}function Sp(e){if(!e.rows.length)return;let t=e.rows.slice(0,15);process.stdout.write(`\nContent inventory${e.pageCount>1?` page ${e.page} of ${e.pageCount}`:``} (${e.rows.length} exported page${e.rows.length===1?``:`s`} with suggested dispositions)\n`),B([`Path`,`Clicks`,`Impressions`,`Position`,`Suggested`],t.map(e=>[G(e.path,48),e.clicks,e.impressions,e.position??`-`,e.suggestedDisposition])),e.rows.length>t.length&&process.stdout.write(`Showing ${t.length} of ${e.rows.length} tiered rows.\n`),e.pageCount>1&&process.stdout.write(`Showing inventory page ${e.page} of ${e.pageCount}; ${e.totalPages} retained rows are available.\n`),process.stdout.write(`${e.note}\n`)}function Cp(e){let t=e.evidence.queries.totalRows,n=e.evidence.pages.totalRows,r=`Loaded a local Search Console export (${t} query row${t===1?``:`s`}, ${n} page row${n===1?``:`s`}).`;if(!e.reconciliation)return r;let i=e.reconciliation.unreachedCount;return i===0?`${r} Every exported page URL was reached by the crawl.`:`${r} ${i} exported page URL${i===1?``:`s`} with impressions were not reached by this crawl.`}function wp(e){let t=e.crawledUrls;return`Found ${e.highIssues} high, ${e.mediumIssues} medium, and ${e.lowIssues} low technical issues across ${t} crawled ${t===1?`page`:`pages`}.`}function Tp(e){return yr(e,{limit:e.issues.length})}function Ep(e){return Mt(e,{limit:e.issues.length})}function Dp(e){if(!e)return[];let t=e=>{let t=e.window?` in the last ${e.window.days} days`:``,n=`for ${e.joinedPages} of ${e.totalPages} crawled URLs`;return e.status===`skipped`?`${e.label}: not connected.`:e.status===`unavailable`?`${e.label}: unavailable. ${e.warning??`No data was joined.`}`:e.status===`partial`?`${e.label}: partial data ${n}${t}. ${e.warning??``}`.trim():e.status===`none`?`${e.label}: no matching crawled URLs${t}.`:`${e.label}: joined ${n}${t}.`};return[t({label:`Search Console`,status:e.searchConsole.status,joinedPages:Math.max(e.searchConsole.joinedMetricPages,e.searchConsole.joinedQueryPages),totalPages:e.searchConsole.totalPages,window:e.searchConsole.window,warning:e.searchConsole.warning}),t({label:`Google Analytics`,status:e.analytics.status,joinedPages:e.analytics.joinedPages,totalPages:e.analytics.totalPages,window:e.analytics.window,warning:e.analytics.warning})]}function Op(e,t){if(e===t)return 0;let n=[...e],r=[...t],i=Math.min(n.length,r.length);for(let e=0;e<i;e+=1){let t=(n[e]?.codePointAt(0)??0)-(r[e]?.codePointAt(0)??0);if(t!==0)return t}return n.length-r.length}function kp(e){return e.toLowerCase().replace(/[^\p{L}\p{N}]+/gu,` `).trim()}function Ap(e){try{let t=new URL(e),n=t.pathname.length>1&&t.pathname.endsWith(`/`)?t.pathname.slice(0,-1):t.pathname;return`${t.origin}${n}${t.search}`}catch{return e.length>1&&e.endsWith(`/`)?e.slice(0,-1):e}}function jp(e,t=[]){return[...e.map(e=>({url:e.finalUrl||e.url,title:e.title})),...t]}function Mp(e){try{let t=new URL(e);return`${t.pathname}${t.search}`||`/`}catch{return e}}function Np(e){let t;try{t=new URL(e)}catch{return null}return`${t.pathname!==`/`&&t.pathname.endsWith(`/`)?t.pathname.slice(0,-1):t.pathname}${t.search}`}const Pp=[`review: shares a search phrase with another page title; confirm query-to-page evidence and intent before consolidating`,`keep: has clicks in the export window`,`review: has impressions but no crawl path reached it`,`update: has impressions with a weak average position (average position above 20 in the export)`,`review: low observed demand in the export window`];function Fp(e){let t=e.maxRows??50,n=e.page??1;if(!Number.isSafeInteger(t)||t<1)throw new C(`INVALID_INPUT`,`Inventory page size must be positive.`);if(!Number.isSafeInteger(n)||n<1)throw new C(`INVALID_INPUT`,`Inventory page must be positive.`);let r=new Set;for(let t of e.reconciliation?.unreachedPages??[]){let e=Np(t.url);e!==null&&r.add(e)}let i=new Map,a=[...e.crawledPages].sort((e,t)=>Op(e.url,t.url));for(let e of a){if(typeof e.title!=`string`)continue;let t=Np(e.url);t!==null&&(i.has(t)||i.set(t,e.title))}let o=new Map;for(let t of e.overlap?.candidates??[])for(let e of t.pages){let n=Np(e.url);n!==null&&(o.has(n)||o.set(n,t.query))}let s=[...e.pages].sort((e,t)=>t.impressions-e.impressions||t.clicks-e.clicks||Op(e.url,t.url)),c=Math.ceil(s.length/t);if(c>0&&n>c)throw new C(`INVALID_INPUT`,`Inventory page ${n} does not exist; choose a page from 1 to ${c}.`);let l=(n-1)*t,u=s.slice(l,l+t).map(t=>{let n=Np(t.url),a=n===null||!e.reconciliation?null:r.has(n)?!1:!e.reconciliation.capped||null,s=n===null?null:i.get(n)??null,c=n===null?null:o.get(n)??null,l,u;return c===null?t.clicks>0?(l=`keep`,u=`has clicks in the export window`):t.impressions>0&&a===!1?(l=`review`,u=`has impressions but no crawl path reached it`):t.impressions>0&&t.position!==null&&t.position>20?(l=`update`,u=`has impressions with a weak average position`):(l=`review`,u=`low observed demand in the export window`):(l=`review`,u=`shares a search phrase with another page title and needs query-to-page and intent verification`),{url:t.url,path:Mp(t.url),clicks:t.clicks,impressions:t.impressions,position:t.position,reachedByCrawl:a,title:s,overlapQuery:c,suggestedDisposition:l,tier:u}}),d=c>1,f=[`Suggested dispositions are heuristic tiers from the export numbers and crawl reach. Decide each page with the owner.`];return d&&f.push(`This is inventory page ${n} of ${c}. Fetch every page before treating the returned inventory as complete.`),e.sourceCapped===!0&&f.push(`The source import was capped, so rows missing from this inventory are unknown.`),{rows:u,totalPages:e.pages.length,capped:e.sourceCapped===!0||d,sourceCapped:e.sourceCapped===!0,page:n,pageSize:t,pageCount:c,nextPage:n<c?n+1:null,criteria:[...Pp],note:f.join(` `)}}function Ip(e){let t=e.maxQueries??50,n=e.maxCandidates??10,r=new Map;for(let t of e.queries){let e=kp(t.query);if(e.split(` `).length<2)continue;let n=r.get(e);n?(n.impressions+=t.impressions,n.clicks+=t.clicks):r.set(e,{impressions:t.impressions,clicks:t.clicks})}let i=r.size,a=[...r.entries()].map(([e,t])=>({query:e,...t})).sort((e,t)=>t.impressions-e.impressions||t.clicks-e.clicks||Op(e.query,t.query)).slice(0,t),o=new Map,s=[...e.pages].sort((e,t)=>Op(e.url,t.url));for(let e of s){if(typeof e.title!=`string`)continue;let t=kp(e.title);if(!t)continue;let n=Ap(e.url);o.has(n)||o.set(n,{url:e.url,title:e.title,normalizedTitle:t})}let c=[...o.values()],l=[];for(let e of a){let t=` ${e.query} `,n=c.filter(e=>` ${e.normalizedTitle} `.includes(t));n.length<2||l.push({query:e.query,impressions:e.impressions,clicks:e.clicks,pages:n.map(e=>({url:e.url,title:e.title})).sort((e,t)=>Op(e.url,t.url))})}l.sort((e,t)=>t.impressions-e.impressions||t.clicks-e.clicks||Op(e.query,t.query));let u=i>a.length,d=l.length>n;return{candidates:l.slice(0,n),eligibleQueries:i,consideredQueries:a.length,queryLimitReached:u,candidateLimitReached:d,capped:u||d}}const Lp={high:0,medium:1,low:2};function Rp(e,t){let n=Lp[e.fix.severity]-Lp[t.fix.severity];return n===0?t.fix.count===e.fix.count?t.fix.score===e.fix.score?e.fix.ruleId<t.fix.ruleId?-1:+(e.fix.ruleId>t.fix.ruleId):t.fix.score-e.fix.score:t.fix.count-e.fix.count:n}function zp(e){let t=e.unreachedAudit,n=[...e.topFixes.map(e=>({fix:e,prefix:``,source:`crawl`})),...(t?.topFixes??[]).map(e=>({fix:e,prefix:`${t?.titlePrefix} `,source:`unreached`}))].sort(Rp),r=[...e.reviewObservations.map(e=>({fix:e,prefix:``,source:`crawl`})),...(t?.reviewObservations??[]).map(e=>({fix:e,prefix:`${t?.titlePrefix} `,source:`unreached`}))].sort(Rp),i=[];for(let{fix:t,prefix:r,source:a}of n){let n=a===`crawl`?e.crawlReportId:e.unreachedAudit?.reportId;i.push({id:`${a}:${t.ruleId}`,kind:`fix`,title:`${r}${t.ruleId}: ${t.title} (${t.count} URL${t.count===1?``:`s`})`,action:t.howToFix,confidence:`high`,severity:t.severity,affectedCount:t.count,sampleUrls:t.sampleUrls,...n?{affectedUrlsReport:{id:`affected-urls`,params:{reportId:n,ruleId:t.ruleId}}}:{},evidence:{ruleId:t.ruleId,source:a,whyThisRanks:t.whyThisRanks},verification:t.verification})}let a=e.reconciliation;if(a&&a.unreachedCount>0){let e=a.unreachedPages.reduce((e,t)=>e+t.impressions,0);i.push({id:`export:unreached-pages`,kind:`review`,title:`${a.unreachedCount} exported page URL${a.unreachedCount===1?``:`s`} with search impressions were not reached by this crawl`,action:`These pages carry ${e} combined impressions across the ${a.unreachedPages.length} retained export rows, but no crawl path reached them. Add internal links or sitemap entries when they should be reachable. The join used URL paths from a local export; treat it as a discovery lead within this crawl bound, not proof of orphan status.`,confidence:`medium`,affectedCount:a.unreachedCount,evidence:{retainedRows:a.unreachedPages.length,impressions:e},review:{question:`Should each retained exported page be reachable from the current site?`,changeOnlyIf:`Add a crawl path only for a page that should remain part of the current site and has no intended exclusion.`,ifNotNeeded:`Record no change for a page that is intentionally retired, excluded, or awaiting an owner decision.`,doNot:[`Do not call a page orphaned from this path-only join.`,`Do not redirect unrelated pages to one generic destination.`]},verification:{expected:`Every retained exported page is reachable in the rerun or explicitly accounted for as deferred or no-change with owner intent.`}})}let o=e.topicOverlap,s=o?.candidates[0];if(o&&s){let e=o.candidates.length,t=s.pages.map(e=>Mp(e.url));i.push({id:`export:topic-overlap`,kind:`review`,title:`topic overlap candidates: ${e} exported ${e===1?`query appears`:`queries appear`} in 2+ page titles`,action:`Top candidate: "${s.query}" (${s.impressions} impressions, ${s.clicks} clicks) appears in the titles of ${t.join(` and `)}. This is a title-based heuristic built from the export's separate query and page tables. The export contains no query-to-page mapping, so it cannot show which pages Google served for the query. Verify with the cannibalisation report (seo cannibal) after connecting a Search Console property.`,confidence:`medium`,affectedCount:e,evidence:{topQuery:s.query,topPages:s.pages,impressions:s.impressions,clicks:s.clicks},review:{question:`Does query-to-page evidence confirm that these pages compete for the same search intent?`,changeOnlyIf:`Consolidate or redirect only after query-to-page evidence and page intent confirm real overlap.`,ifNotNeeded:`Keep the pages separate and record why their intents differ.`,doNot:[`Do not merge or redirect pages from a title-match heuristic alone.`]},verification:{expected:`Confirm intent with query-to-page evidence before consolidating or redirecting either page.`}})}let c=e.pageInventory,l=c?.rows[0];if(c&&l){let e={keep:0,update:0,review:0};for(let t of c.rows)e[t.suggestedDisposition]+=1;let t=[...c.pageCount>1?[`page ${c.page} of ${c.pageCount}; ${c.rows.length} of ${c.totalPages} retained rows`]:[],...c.sourceCapped?[`source import capped`]:[]],n=t.length?` (${t.join(`; `)})`:``;i.push({id:`export:content-inventory`,kind:`review`,title:`content inventory: ${c.rows.length} exported page${c.rows.length===1?``:`s`} tiered with suggested dispositions`,action:`Suggested tiers: keep ${e.keep}, update ${e.update}, review ${e.review}${n}. Example: ${l.path} (${l.clicks} clicks, ${l.impressions} impressions, position ${l.position??`not in the export`}) is tiered ${l.suggestedDisposition} because it ${l.tier}. ${c.note} Work the inventory page by page instead of applying one blanket policy.`,confidence:`medium`,affectedCount:c.rows.length,evidence:{dispositions:e,capped:c.capped},review:{question:`Has every returned inventory row received an evidence-backed disposition?`,changeOnlyIf:`Apply a content change, removal, or redirect only after deciding that row from its own evidence and product relevance.`,ifConfirmed:`Record one disposition and reason for every returned inventory row.`,ifNotNeeded:`Keep a page unchanged when its evidence and current product role support keeping it.`,doNot:[`Do not use one blanket disposition for the inventory.`,`Do not redirect unrelated URLs to a generic hub.`]},verification:{expected:`Every returned inventory row has an owner-confirmed keep, update, or review decision; every inventory page has been fetched; redirected rows resolve to the intended destination.`}})}for(let{fix:t,prefix:n,source:a}of r){let r=a===`crawl`?e.crawlReportId:e.unreachedAudit?.reportId;i.push({id:`${a}:${t.ruleId}`,kind:`review`,title:`${n}${t.ruleId}: ${t.title} (${t.count} URL${t.count===1?``:`s`})`,action:`Observed state that needs intent confirmation before treating it as a defect. ${t.howToFix}`,confidence:`medium`,severity:t.severity,affectedCount:t.count,sampleUrls:t.sampleUrls,...r?{affectedUrlsReport:{id:`affected-urls`,params:{reportId:r,ruleId:t.ruleId}}}:{},evidence:{ruleId:t.ruleId,source:a,whyThisRanks:t.whyThisRanks},verification:t.verification})}return i}function Bp(e,t){let n=[];for(let r of e.unreachedPages.slice(0,t))try{let t=new URL(r.url);n.push(`${e.crawlOrigin}${t.pathname}${t.search}`)}catch{}return n}function Q(e,t,n){e.some(e=>e.command===t)||e.push({command:t,why:n})}function Vp(e){let t=e.report;return t?{status:e.status,...e.reason?{reason:e.reason}:{},reportId:t.id,generatedAt:t.generatedAt,crawlStatus:t.status,capped:t.summary.pageLimitReached,maxPages:t.config.maxPages,searchDataJoined:(t.dataSources?.searchConsole.joinedMetricPages??0)>0||(t.dataSources?.searchConsole.joinedQueryPages??0)>0,dataSources:t.dataSources,summary:t.summary,topFixes:Tp(t),reviewObservations:Ep(t),issueGroupsComplete:!0}:{status:e.status,...e.reason?{reason:e.reason}:{}}}function Hp(e){return{ruleId:e.ruleId,title:e.title,category:e.category,severity:e.severity,recommendation:e.recommendation,count:e.count,sampleUrls:e.sampleUrls.slice(0,3),score:e.score,scoreFactors:e.scoreFactors,whyThisRanks:e.whyThisRanks,detailsCommand:`seo explain --rule ${e.ruleId}`}}function Up(e){return`topFixes`in e?{...e,topFixes:e.topFixes.map(Hp),reviewObservations:e.reviewObservations.map(Hp)}:e}function Wp(e,t){return t?[...e,...t]:[...e]}function Gp(e,t={}){if(!(`topFixes`in e)){process.stdout.write(`\nTechnical crawl evidence: ${e.reason??e.status}\n`);return}let n=e.status===`reused`?`saved`:`new`;if(process.stdout.write(`\nTechnical crawl evidence (${n})\n`),e.reason&&process.stdout.write(`${e.reason}\n`),e.capped&&process.stdout.write(`Coverage is capped at ${e.maxPages} pages. Run \`seo crawl\` for a broader investigation.\n`),!t.providerFree)for(let t of Dp(e.dataSources))process.stdout.write(`${t}\n`);if(!e.topFixes.length){process.stdout.write(`No prioritised technical fixes were found.
+`)}const pp={type:`boolean`,default:!1,description:`Print machine-readable JSON.`},mp=T({meta:{name:`telemetry`,description:`Check or change anonymous usage telemetry`},subCommands:{status:T({meta:{name:`status`,description:`Show whether anonymous usage telemetry is enabled`},args:{json:pp},run:async({args:e})=>fp(qt(),F(e))}),enable:T({meta:{name:`enable`,description:`Enable anonymous usage telemetry in local settings`},args:{json:pp},run:async({args:e})=>{fp(jn(!0),F(e))}}),disable:T({meta:{name:`disable`,description:`Disable anonymous usage telemetry in local settings`},args:{json:pp},run:async({args:e})=>{fp(jn(!1),F(e))}})}}),hp=T({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. Optional when --project has a saved crawl URL.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...nl,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=F(e),n=k(e),r=await vp(e),i=_p(e),a=O(e.site)||n||!i&&!r.length?await H({client:n,site:O(e.site),options:{json:t}}):void 0,o=i??a?.client?.startUrl??(a?.site?Cs(a.site):void 0)??r[0];if(!o)throw Error(`No crawl URL selected. Pass a URL, --url, or use --project with a saved crawl URL.`);let s=await Pn({url:o,projectId:a?.client?.id,site:a?.site,mode:gp(e.mode)??(r.length?`list`:void 0),urls:r,maxPages:j(e[`max-pages`]),maxDepth:j(e[`max-depth`]),concurrency:j(e.concurrency),refresh:A(e.refresh),fetchRate:Ba({...e,"fetch-concurrency":e.concurrency}),include:N(e.include),exclude:N(e.exclude),googleAnalyticsPropertyId:O(e[`google-analytics-property`]),analyticsConnection:rl(e,Yn(a?.client)),useSitemap:!La(e,`sitemap`),respectRobots:!La(e,`robots`),checkExternal:!La(e,`external`),js:!!A(e.js),limit:j(e.limit)});if(t){R(s);return}Hu(s),B([`Rank`,`Score`,`Rule`,`Severity`,`Affected`,`Target`,`Action`],s.output.queue.map((e,t)=>[t+1,e.score,e.ruleId,e.severity,e.affectedUrls,e.target,e.action])),J(`Implementation queue details`,s.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 gp(e){let t=O(e);if(t){if([`site`,`page`,`list`,`sitemap`].includes(t))return t;throw Error(`Mode must be one of: site, page, list, sitemap.`)}}function _p(e){let t=O(e.crawlUrl),n=O(e.url);if(t&&n&&t!==n)throw Error(`Use either a URL argument or --url, not both.`);return t??n}async function vp(e){let t=N(e.urls)??[],n=O(e[`urls-file`]);return n&&t.push(...yp(await di(n,`utf8`))),[...new Set(t)]}function yp(e){return e.split(/[\n,]/).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`))}function bp(e,t){let{narrative:n}=e.output,{diagnosis:r}=n;return{...e,...t?{workflow:t}:{},output:{narrative:{site:n.site,generatedAt:n.generatedAt,dataStatus:n.dataStatus,periodDays:n.periodDays,period:n.period,headline:n.headline,caveats:n.caveats,sections:n.sections,priorities:n.priorities,diagnosis:{site:r.site,generatedAt:r.generatedAt,dataStatus:r.dataStatus,summary:r.summary,skippedSections:r.skippedSections,partialReasons:r.partialReasons,priorities:r.priorities}}}}}function xp(e){return/^[A-Za-z0-9_./:@-]+$/.test(e)?e:`'${e.replaceAll(`'`,`'\\''`)}'`}function Sp(e){try{return new URL(e).origin}catch{throw new C(`INVALID_INPUT`,`Pass a valid absolute URL with --url.`)}}function Cp(e){let t=e.topRows??20,{evidence:n}=e;return{source:n.source,exportedAt:n.exportedAt,importedAt:n.importedAt,files:n.files,queries:{totalRows:n.queries.totalRows,capped:n.queries.capped,topRowsShown:Math.min(t,n.queries.rows.length),rows:n.queries.rows.slice(0,t)},pages:{totalRows:n.pages.totalRows,capped:n.pages.capped,topRowsShown:Math.min(t,n.pages.rows.length),rows:n.pages.rows.slice(0,t)},...e.reconciliation?{reconciliation:e.reconciliation}:{},...e.pageInventory?{pageInventory:e.pageInventory}:{},warnings:n.warnings,caveats:n.caveats}}function wp(e){if(!e.rows.length)return;let t=e.rows.slice(0,15);process.stdout.write(`\nContent inventory${e.pageCount>1?` page ${e.page} of ${e.pageCount}`:``} (${e.rows.length} exported page${e.rows.length===1?``:`s`} with suggested dispositions)\n`),B([`Path`,`Clicks`,`Impressions`,`Position`,`Suggested`],t.map(e=>[G(e.path,48),e.clicks,e.impressions,e.position??`-`,e.suggestedDisposition])),e.rows.length>t.length&&process.stdout.write(`Showing ${t.length} of ${e.rows.length} tiered rows.\n`),e.pageCount>1&&process.stdout.write(`Showing inventory page ${e.page} of ${e.pageCount}; ${e.totalPages} retained rows are available.\n`),process.stdout.write(`${e.note}\n`)}function Tp(e){let t=e.evidence.queries.totalRows,n=e.evidence.pages.totalRows,r=`Loaded a local Search Console export (${t} query row${t===1?``:`s`}, ${n} page row${n===1?``:`s`}).`;if(!e.reconciliation)return r;let i=e.reconciliation.unreachedCount;return i===0?`${r} Every exported page URL was reached by the crawl.`:`${r} ${i} exported page URL${i===1?``:`s`} with impressions were not reached by this crawl.`}function Ep(e){let t=e.crawledUrls;return`Found ${e.highIssues} high, ${e.mediumIssues} medium, and ${e.lowIssues} low technical issues across ${t} crawled ${t===1?`page`:`pages`}.`}function Dp(e){return yr(e,{limit:e.issues.length})}function Op(e){return Mt(e,{limit:e.issues.length})}function kp(e){if(!e)return[];let t=e=>{let t=e.window?` in the last ${e.window.days} days`:``,n=`for ${e.joinedPages} of ${e.totalPages} crawled URLs`;return e.status===`skipped`?`${e.label}: not connected.`:e.status===`unavailable`?`${e.label}: unavailable. ${e.warning??`No data was joined.`}`:e.status===`partial`?`${e.label}: partial data ${n}${t}. ${e.warning??``}`.trim():e.status===`none`?`${e.label}: no matching crawled URLs${t}.`:`${e.label}: joined ${n}${t}.`};return[t({label:`Search Console`,status:e.searchConsole.status,joinedPages:Math.max(e.searchConsole.joinedMetricPages,e.searchConsole.joinedQueryPages),totalPages:e.searchConsole.totalPages,window:e.searchConsole.window,warning:e.searchConsole.warning}),t({label:`Google Analytics`,status:e.analytics.status,joinedPages:e.analytics.joinedPages,totalPages:e.analytics.totalPages,window:e.analytics.window,warning:e.analytics.warning})]}function Ap(e,t){if(e===t)return 0;let n=[...e],r=[...t],i=Math.min(n.length,r.length);for(let e=0;e<i;e+=1){let t=(n[e]?.codePointAt(0)??0)-(r[e]?.codePointAt(0)??0);if(t!==0)return t}return n.length-r.length}function jp(e){return e.toLowerCase().replace(/[^\p{L}\p{N}]+/gu,` `).trim()}function Mp(e){try{let t=new URL(e),n=t.pathname.length>1&&t.pathname.endsWith(`/`)?t.pathname.slice(0,-1):t.pathname;return`${t.origin}${n}${t.search}`}catch{return e.length>1&&e.endsWith(`/`)?e.slice(0,-1):e}}function Np(e,t=[]){return[...e.map(e=>({url:e.finalUrl||e.url,title:e.title})),...t]}function Pp(e){try{let t=new URL(e);return`${t.pathname}${t.search}`||`/`}catch{return e}}function Fp(e){let t;try{t=new URL(e)}catch{return null}return`${t.pathname!==`/`&&t.pathname.endsWith(`/`)?t.pathname.slice(0,-1):t.pathname}${t.search}`}const Ip=[`review: shares a search phrase with another page title; confirm query-to-page evidence and intent before consolidating`,`keep: has clicks in the export window`,`review: has impressions but no crawl path reached it`,`update: has impressions with a weak average position (average position above 20 in the export)`,`review: low observed demand in the export window`];function Lp(e){let t=e.maxRows??50,n=e.page??1;if(!Number.isSafeInteger(t)||t<1)throw new C(`INVALID_INPUT`,`Inventory page size must be positive.`);if(!Number.isSafeInteger(n)||n<1)throw new C(`INVALID_INPUT`,`Inventory page must be positive.`);let r=new Set;for(let t of e.reconciliation?.unreachedPages??[]){let e=Fp(t.url);e!==null&&r.add(e)}let i=new Map,a=[...e.crawledPages].sort((e,t)=>Ap(e.url,t.url));for(let e of a){if(typeof e.title!=`string`)continue;let t=Fp(e.url);t!==null&&(i.has(t)||i.set(t,e.title))}let o=new Map;for(let t of e.overlap?.candidates??[])for(let e of t.pages){let n=Fp(e.url);n!==null&&(o.has(n)||o.set(n,t.query))}let s=[...e.pages].sort((e,t)=>t.impressions-e.impressions||t.clicks-e.clicks||Ap(e.url,t.url)),c=Math.ceil(s.length/t);if(c>0&&n>c)throw new C(`INVALID_INPUT`,`Inventory page ${n} does not exist; choose a page from 1 to ${c}.`);let l=(n-1)*t,u=s.slice(l,l+t).map(t=>{let n=Fp(t.url),a=n===null||!e.reconciliation?null:r.has(n)?!1:!e.reconciliation.capped||null,s=n===null?null:i.get(n)??null,c=n===null?null:o.get(n)??null,l,u;return c===null?t.clicks>0?(l=`keep`,u=`has clicks in the export window`):t.impressions>0&&a===!1?(l=`review`,u=`has impressions but no crawl path reached it`):t.impressions>0&&t.position!==null&&t.position>20?(l=`update`,u=`has impressions with a weak average position`):(l=`review`,u=`low observed demand in the export window`):(l=`review`,u=`shares a search phrase with another page title and needs query-to-page and intent verification`),{url:t.url,path:Pp(t.url),clicks:t.clicks,impressions:t.impressions,position:t.position,reachedByCrawl:a,title:s,overlapQuery:c,suggestedDisposition:l,tier:u}}),d=c>1,f=[`Suggested dispositions are heuristic tiers from the export numbers and crawl reach. Decide each page with the owner.`];return d&&f.push(`This is inventory page ${n} of ${c}. Fetch every page before treating the returned inventory as complete.`),e.sourceCapped===!0&&f.push(`The source import was capped, so rows missing from this inventory are unknown.`),{rows:u,totalPages:e.pages.length,capped:e.sourceCapped===!0||d,sourceCapped:e.sourceCapped===!0,page:n,pageSize:t,pageCount:c,nextPage:n<c?n+1:null,criteria:[...Ip],note:f.join(` `)}}function Rp(e){let t=e.maxQueries??50,n=e.maxCandidates??10,r=new Map;for(let t of e.queries){let e=jp(t.query);if(e.split(` `).length<2)continue;let n=r.get(e);n?(n.impressions+=t.impressions,n.clicks+=t.clicks):r.set(e,{impressions:t.impressions,clicks:t.clicks})}let i=r.size,a=[...r.entries()].map(([e,t])=>({query:e,...t})).sort((e,t)=>t.impressions-e.impressions||t.clicks-e.clicks||Ap(e.query,t.query)).slice(0,t),o=new Map,s=[...e.pages].sort((e,t)=>Ap(e.url,t.url));for(let e of s){if(typeof e.title!=`string`)continue;let t=jp(e.title);if(!t)continue;let n=Mp(e.url);o.has(n)||o.set(n,{url:e.url,title:e.title,normalizedTitle:t})}let c=[...o.values()],l=[];for(let e of a){let t=` ${e.query} `,n=c.filter(e=>` ${e.normalizedTitle} `.includes(t));n.length<2||l.push({query:e.query,impressions:e.impressions,clicks:e.clicks,pages:n.map(e=>({url:e.url,title:e.title})).sort((e,t)=>Ap(e.url,t.url))})}l.sort((e,t)=>t.impressions-e.impressions||t.clicks-e.clicks||Ap(e.query,t.query));let u=i>a.length,d=l.length>n;return{candidates:l.slice(0,n),eligibleQueries:i,consideredQueries:a.length,queryLimitReached:u,candidateLimitReached:d,capped:u||d}}const zp={high:0,medium:1,low:2};function Bp(e,t){let n=zp[e.fix.severity]-zp[t.fix.severity];return n===0?t.fix.count===e.fix.count?t.fix.score===e.fix.score?e.fix.ruleId<t.fix.ruleId?-1:+(e.fix.ruleId>t.fix.ruleId):t.fix.score-e.fix.score:t.fix.count-e.fix.count:n}function Vp(e){let t=e.unreachedAudit,n=[...e.topFixes.map(e=>({fix:e,prefix:``,source:`crawl`})),...(t?.topFixes??[]).map(e=>({fix:e,prefix:`${t?.titlePrefix} `,source:`unreached`}))].sort(Bp),r=[...e.reviewObservations.map(e=>({fix:e,prefix:``,source:`crawl`})),...(t?.reviewObservations??[]).map(e=>({fix:e,prefix:`${t?.titlePrefix} `,source:`unreached`}))].sort(Bp),i=[];for(let{fix:t,prefix:r,source:a}of n){let n=a===`crawl`?e.crawlReportId:e.unreachedAudit?.reportId;i.push({id:`${a}:${t.ruleId}`,kind:`fix`,title:`${r}${t.ruleId}: ${t.title} (${t.count} URL${t.count===1?``:`s`})`,action:t.howToFix,confidence:`high`,severity:t.severity,affectedCount:t.count,sampleUrls:t.sampleUrls,...n?{affectedUrlsReport:{id:`affected-urls`,params:{reportId:n,ruleId:t.ruleId}}}:{},evidence:{ruleId:t.ruleId,source:a,whyThisRanks:t.whyThisRanks},verification:t.verification})}let a=e.reconciliation;if(a&&a.unreachedCount>0){let e=a.unreachedPages.reduce((e,t)=>e+t.impressions,0);i.push({id:`export:unreached-pages`,kind:`review`,title:`${a.unreachedCount} exported page URL${a.unreachedCount===1?``:`s`} with search impressions were not reached by this crawl`,action:`These pages carry ${e} combined impressions across the ${a.unreachedPages.length} retained export rows, but no crawl path reached them. Add internal links or sitemap entries when they should be reachable. The join used URL paths from a local export; treat it as a discovery lead within this crawl bound, not proof of orphan status.`,confidence:`medium`,affectedCount:a.unreachedCount,evidence:{retainedRows:a.unreachedPages.length,impressions:e},review:{question:`Should each retained exported page be reachable from the current site?`,changeOnlyIf:`Add a crawl path only for a page that should remain part of the current site and has no intended exclusion.`,ifNotNeeded:`Record no change for a page that is intentionally retired, excluded, or awaiting an owner decision.`,doNot:[`Do not call a page orphaned from this path-only join.`,`Do not redirect unrelated pages to one generic destination.`]},verification:{expected:`Every retained exported page is reachable in the rerun or explicitly accounted for as deferred or no-change with owner intent.`}})}let o=e.topicOverlap,s=o?.candidates[0];if(o&&s){let e=o.candidates.length,t=s.pages.map(e=>Pp(e.url));i.push({id:`export:topic-overlap`,kind:`review`,title:`topic overlap candidates: ${e} exported ${e===1?`query appears`:`queries appear`} in 2+ page titles`,action:`Top candidate: "${s.query}" (${s.impressions} impressions, ${s.clicks} clicks) appears in the titles of ${t.join(` and `)}. This is a title-based heuristic built from the export's separate query and page tables. The export contains no query-to-page mapping, so it cannot show which pages Google served for the query. Verify with the cannibalisation report (seo cannibal) after connecting a Search Console property.`,confidence:`medium`,affectedCount:e,evidence:{topQuery:s.query,topPages:s.pages,impressions:s.impressions,clicks:s.clicks},review:{question:`Does query-to-page evidence confirm that these pages compete for the same search intent?`,changeOnlyIf:`Consolidate or redirect only after query-to-page evidence and page intent confirm real overlap.`,ifNotNeeded:`Keep the pages separate and record why their intents differ.`,doNot:[`Do not merge or redirect pages from a title-match heuristic alone.`]},verification:{expected:`Confirm intent with query-to-page evidence before consolidating or redirecting either page.`}})}let c=e.pageInventory,l=c?.rows[0];if(c&&l){let e={keep:0,update:0,review:0};for(let t of c.rows)e[t.suggestedDisposition]+=1;let t=[...c.pageCount>1?[`page ${c.page} of ${c.pageCount}; ${c.rows.length} of ${c.totalPages} retained rows`]:[],...c.sourceCapped?[`source import capped`]:[]],n=t.length?` (${t.join(`; `)})`:``;i.push({id:`export:content-inventory`,kind:`review`,title:`content inventory: ${c.rows.length} exported page${c.rows.length===1?``:`s`} tiered with suggested dispositions`,action:`Suggested tiers: keep ${e.keep}, update ${e.update}, review ${e.review}${n}. Example: ${l.path} (${l.clicks} clicks, ${l.impressions} impressions, position ${l.position??`not in the export`}) is tiered ${l.suggestedDisposition} because it ${l.tier}. ${c.note} Work the inventory page by page instead of applying one blanket policy.`,confidence:`medium`,affectedCount:c.rows.length,evidence:{dispositions:e,capped:c.capped},review:{question:`Has every returned inventory row received an evidence-backed disposition?`,changeOnlyIf:`Apply a content change, removal, or redirect only after deciding that row from its own evidence and product relevance.`,ifConfirmed:`Record one disposition and reason for every returned inventory row.`,ifNotNeeded:`Keep a page unchanged when its evidence and current product role support keeping it.`,doNot:[`Do not use one blanket disposition for the inventory.`,`Do not redirect unrelated URLs to a generic hub.`]},verification:{expected:`Every returned inventory row has an owner-confirmed keep, update, or review decision; every inventory page has been fetched; redirected rows resolve to the intended destination.`}})}for(let{fix:t,prefix:n,source:a}of r){let r=a===`crawl`?e.crawlReportId:e.unreachedAudit?.reportId;i.push({id:`${a}:${t.ruleId}`,kind:`review`,title:`${n}${t.ruleId}: ${t.title} (${t.count} URL${t.count===1?``:`s`})`,action:`Observed state that needs intent confirmation before treating it as a defect. ${t.howToFix}`,confidence:`medium`,severity:t.severity,affectedCount:t.count,sampleUrls:t.sampleUrls,...r?{affectedUrlsReport:{id:`affected-urls`,params:{reportId:r,ruleId:t.ruleId}}}:{},evidence:{ruleId:t.ruleId,source:a,whyThisRanks:t.whyThisRanks},verification:t.verification})}return i}function Hp(e,t){let n=[];for(let r of e.unreachedPages.slice(0,t))try{let t=new URL(r.url);n.push(`${e.crawlOrigin}${t.pathname}${t.search}`)}catch{}return n}function Q(e,t,n){e.some(e=>e.command===t)||e.push({command:t,why:n})}function Up(e){let t=e.report;return t?{status:e.status,...e.reason?{reason:e.reason}:{},reportId:t.id,generatedAt:t.generatedAt,crawlStatus:t.status,capped:t.summary.pageLimitReached,maxPages:t.config.maxPages,searchDataJoined:(t.dataSources?.searchConsole.joinedMetricPages??0)>0||(t.dataSources?.searchConsole.joinedQueryPages??0)>0,dataSources:t.dataSources,summary:t.summary,topFixes:Dp(t),reviewObservations:Op(t),issueGroupsComplete:!0}:{status:e.status,...e.reason?{reason:e.reason}:{}}}function Wp(e){return{ruleId:e.ruleId,title:e.title,category:e.category,severity:e.severity,recommendation:e.recommendation,count:e.count,sampleUrls:e.sampleUrls.slice(0,3),score:e.score,scoreFactors:e.scoreFactors,whyThisRanks:e.whyThisRanks,detailsCommand:`seo explain --rule ${e.ruleId}`}}function Gp(e){return`topFixes`in e?{...e,topFixes:e.topFixes.map(Wp),reviewObservations:e.reviewObservations.map(Wp)}:e}function Kp(e,t){return t?[...e,...t]:[...e]}function qp(e,t={}){if(!(`topFixes`in e)){process.stdout.write(`\nTechnical crawl evidence: ${e.reason??e.status}\n`);return}let n=e.status===`reused`?`saved`:`new`;if(process.stdout.write(`\nTechnical crawl evidence (${n})\n`),e.reason&&process.stdout.write(`${e.reason}\n`),e.capped&&process.stdout.write(`Coverage is capped at ${e.maxPages} pages. Run \`seo crawl\` for a broader investigation.\n`),!t.providerFree)for(let t of kp(e.dataSources))process.stdout.write(`${t}\n`);if(!e.topFixes.length){process.stdout.write(`No prioritised technical fixes were found.
 `),e.reviewObservations.length&&process.stdout.write(`${e.reviewObservations.length} review observation${e.reviewObservations.length===1?``:`s`} need confirmation before they become implementation work.\n`);return}process.stdout.write(t.providerFree?`
 Prioritised technical fixes
 `:e.searchDataJoined?`
@@ -269,21 +269,21 @@ Technical fixes with search value
 Technical fixes (no Search Console data joined)
 `),e.searchDataJoined?B([`Score`,`Rule`,`Severity`,`Search value`,`Verify`],e.topFixes.map(e=>[e.score,e.ruleId,e.severity,`${e.scoreFactors.clicks} clicks / ${e.scoreFactors.sessions} visits${e.scoreFactors.conversions===void 0?``:` / ${e.scoreFactors.conversions} conv.`}`,G(e.howToVerify,72)])):B([`#`,`Rule`,`Severity`,`Affected URLs`,`Verify`],e.topFixes.map((e,t)=>[t+1,e.ruleId,e.severity,e.count,G(e.howToVerify,72)])),e.reviewObservations.length&&(t.providerFree?(process.stdout.write(`
 Review observations (confirm intent before treating as defects)
-`),B([`Rule`,`Severity`,`Affected URLs`,`Sample`],e.reviewObservations.map(e=>[e.ruleId,e.severity,e.count,G(e.sampleUrls[0]??``,60)]))):process.stdout.write(`\n${e.reviewObservations.length} review observation${e.reviewObservations.length===1?``:`s`} were kept out of this action queue.\n`))}function Kp(e){process.stdout.write(`
+`),B([`Rule`,`Severity`,`Affected URLs`,`Sample`],e.reviewObservations.map(e=>[e.ruleId,e.severity,e.count,G(e.sampleUrls[0]??``,60)]))):process.stdout.write(`\n${e.reviewObservations.length} review observation${e.reviewObservations.length===1?``:`s`} were kept out of this action queue.\n`))}function Jp(e){process.stdout.write(`
 Search Console export (local file evidence)
-`),process.stdout.write(`${Cp(e)}\n`);for(let t of e.evidence.warnings)process.stdout.write(`Warning: ${t}\n`);let t=e.reconciliation?.unreachedPages??[];if(t.length&&(process.stdout.write(`
+`),process.stdout.write(`${Tp(e)}\n`);for(let t of e.evidence.warnings)process.stdout.write(`Warning: ${t}\n`);let t=e.reconciliation?.unreachedPages??[];if(t.length&&(process.stdout.write(`
 Exported page URLs not reached by this crawl (by impressions)
 `),B([`URL`,`Clicks`,`Impressions`,`Position`],t.slice(0,10).map(e=>[G(e.url,64),e.clicks,e.impressions,e.position??`-`]))),e.unreachedAudit){let t=e.unreachedAudit;process.stdout.write(`\nAudited ${t.auditedUrls} of the ${t.totalUnreached} unreached URLs in this run\n`);let n=[...t.topFixes,...t.reviewObservations];n.length&&B([`Rule`,`Severity`,`Affected URLs`,`Sample`],n.map(e=>[e.ruleId,e.severity,e.count,G(e.sampleUrls[0]??``,60)]))}e.topicOverlap?.candidates.length&&(process.stdout.write(`
 Topic overlap candidates (title-based heuristic; the export has no query-to-page mapping)
-`),B([`Query`,`Impressions`,`Pages`],e.topicOverlap.candidates.map(e=>[G(e.query,40),e.impressions,G(e.pages.map(e=>Mp(e.url)).join(`, `),64)]))),e.pageInventory&&Sp(e.pageInventory);for(let t of e.evidence.caveats)process.stdout.write(`Note: ${t}\n`)}function qp(e){process.stdout.write(`
+`),B([`Query`,`Impressions`,`Pages`],e.topicOverlap.candidates.map(e=>[G(e.query,40),e.impressions,G(e.pages.map(e=>Pp(e.url)).join(`, `),64)]))),e.pageInventory&&wp(e.pageInventory);for(let t of e.evidence.caveats)process.stdout.write(`Note: ${t}\n`)}function Yp(e){process.stdout.write(`
 Provider-backed sections skipped
-`);let t=`dataSources`in e?Dp(e.dataSources):[],n=t.length?t:[`Search Console: not connected.`,`Google Analytics: not connected.`];for(let e of n)process.stdout.write(`${e}\n`);process.stdout.write("Run `seo start` when you want traffic, query, ranking, and analytics evidence added to the report.\n")}function Jp(e){let t=[],n=e.technicalCrawl;return n&&(`topFixes`in n?t.push({title:`Technical crawl evidence`,summary:`${n.summary.crawledUrls} pages were included in the ${n.status===`reused`?`saved`:`new`} crawl evidence.`,items:[...n.topFixes.map(e=>`${e.ruleId}: ${e.title}. ${e.count} affected URLs. ${e.recommendation}`),...Dp(n.dataSources)]}):t.push({title:`Technical crawl evidence`,summary:n.reason??`Technical evidence was ${n.status}.`,items:[]})),e.followups?.length&&t.push({title:`Recommended next commands`,items:e.followups.map(e=>`${e.command}: ${e.why}`)}),t}function Yp(e,t,n){if(!(`topFixes`in e))return`Technical crawl evidence was ${e.status}. Search Console and Google Analytics sections were skipped because they are not connected.`;let r=[wp(e.summary)];return t&&r.push(Cp(t)),n&&r.push(`Audited ${n.auditedUrls} of the ${n.totalUnreached} unreached URLs in this run; their findings are in the action list.`),r.push(`Search Console and Google Analytics are not connected; provider-backed sections were skipped.`),r.join(` `)}function Xp(e){if(!(`topFixes`in e))return{tool:`seo_crawl`,status:`skipped`,summary:e.reason??`Technical crawl evidence was ${e.status}.`};let t=e.summary.crawledUrls;return{tool:`seo_crawl`,status:`completed`,summary:`${e.status===`reused`?`Loaded`:`Completed`} technical evidence for ${t} crawled ${t===1?`page`:`pages`}.`}}function Zp(e){return e?[{tool:`seo_search_console_export`,status:`completed`,summary:Cp(e)}]:[]}function Qp(e){if(e.unreachedCount===0)return;let t=[];for(let n of e.unreachedPages.slice(0,10))try{let r=new URL(n.url);t.push(`${e.crawlOrigin}${r.pathname}${r.search}`)}catch{}if(!t.length)return;let n=e.unreachedCount-t.length;return{command:`seo reports run audit-urls --params '${JSON.stringify({urls:t})}' --json`,why:`Fetch page-level evidence for exported URLs this crawl never reached${n>0?` (first ${t.length} of ${e.unreachedCount})`:``}.${e.originMismatch?` URLs were mapped onto the --url origin by path because the export origin differs.`:``}`}}function $p(e,t={}){if(t.searchDataAvailable===!1){let e=[];return t.crawlStartUrl&&t.technicalBaselineStatus!==`created`&&t.technicalBaselineStatus!==`refreshed`&&t.technicalBaselineStatus!==`reused`?(Q(e,`seo crawl --url ${yp(t.crawlStartUrl)} --health`,`Run the fast sitemap response and access gate before fetching page bodies.`),Q(e,`seo crawl --url ${yp(t.crawlStartUrl)} --save`,`Create the technical crawl that this report needs before opening a page-level follow-up.`)):t.crawlStartUrl&&Q(e,`seo audit-page --url ${yp(t.crawlStartUrl)}`,`Inspect one important page in detail after the site-level crawl.`),Q(e,`seo start`,`Connect Search Console when you want traffic, query, and ranking evidence alongside the crawl.`),e}let n=t.projectId?`--project ${yp(t.projectId)}`:`--site ${yp(e.site)}`,r=e.output.narrative.diagnosis,i=r.decay.rangeDays,a=[],o=new Set((r.skippedSections??[]).map(e=>e.section));Q(a,`seo refresh-priorities ${n} --days ${i} --verify-content --limit 25`,`Turn the report into a ranked action queue with content checks.`),r.decay.summary.eligibleRows>0&&Q(a,`seo decaying ${n} --days ${i} --limit 25`,`Inspect query/page declines observed in both retained-row windows.`),r.cannibalization.items.length>0&&Q(a,`seo cannibal ${n} --days ${i} --limit 25`,`Find queries split across competing URLs.`),r.quickWins.summary.eligibleRows>0&&Q(a,`seo quick-wins ${n} --days ${i} --verify-content --verify-limit 5`,`Review average-position rows below their heuristic CTR target with optional page evidence.`),r.strikingDistance.summary.eligibleRows>0&&Q(a,`seo second-page ${n} --days ${i} --verify-content --verify-limit 5`,`Work pages sitting just outside page-one rankings.`),(o.has(`traffic anomaly`)||o.has(`update correlation`))&&(Q(a,`seo quick-wins ${n} --days ${i} --min-impressions 10 --verify-content --verify-limit 5`,`Sparse GSC data: lower thresholds and look for early content wins.`),Q(a,`seo second-page ${n} --days ${i} --min-impressions 10 --verify-content --verify-limit 5`,`Sparse GSC data: inspect early second-page opportunities.`));let s=r.segments.page.items.find(e=>e.key.startsWith(`http`));return s&&Q(a,`seo audit-page --url ${yp(s.key)}`,`Audit the biggest moved URL for title, metadata, links, and schema.`),t.crawlStartUrl&&t.technicalBaselineStatus!==`created`&&t.technicalBaselineStatus!==`refreshed`&&t.technicalBaselineStatus!==`reused`&&(Q(a,`seo crawl --url ${yp(t.crawlStartUrl)} --health`,`Run the fast sitemap response and access gate before fetching page bodies.`),Q(a,`seo crawl --url ${yp(t.crawlStartUrl)} ${n} --save`,`Create the first technical crawler baseline with plain-English fixes and JSON-ready issue data.`)),Q(a,`seo technical-watch ${n} --limit 50`,`Save a crawl/index baseline so future reports can flag technical drift.`),a.slice(0,6)}function em(e){e.length&&(process.stdout.write(`
+`);let t=`dataSources`in e?kp(e.dataSources):[],n=t.length?t:[`Search Console: not connected.`,`Google Analytics: not connected.`];for(let e of n)process.stdout.write(`${e}\n`);process.stdout.write("Run `seo start` when you want traffic, query, ranking, and analytics evidence added to the report.\n")}function Xp(e){let t=[],n=e.technicalCrawl;return n&&(`topFixes`in n?t.push({title:`Technical crawl evidence`,summary:`${n.summary.crawledUrls} pages were included in the ${n.status===`reused`?`saved`:`new`} crawl evidence.`,items:[...n.topFixes.map(e=>`${e.ruleId}: ${e.title}. ${e.count} affected URLs. ${e.recommendation}`),...kp(n.dataSources)]}):t.push({title:`Technical crawl evidence`,summary:n.reason??`Technical evidence was ${n.status}.`,items:[]})),e.followups?.length&&t.push({title:`Recommended next commands`,items:e.followups.map(e=>`${e.command}: ${e.why}`)}),t}function Zp(e,t,n){if(!(`topFixes`in e))return`Technical crawl evidence was ${e.status}. Search Console and Google Analytics sections were skipped because they are not connected.`;let r=[Ep(e.summary)];return t&&r.push(Tp(t)),n&&r.push(`Audited ${n.auditedUrls} of the ${n.totalUnreached} unreached URLs in this run; their findings are in the action list.`),r.push(`Search Console and Google Analytics are not connected; provider-backed sections were skipped.`),r.join(` `)}function Qp(e){if(!(`topFixes`in e))return{tool:`seo_crawl`,status:`skipped`,summary:e.reason??`Technical crawl evidence was ${e.status}.`};let t=e.summary.crawledUrls;return{tool:`seo_crawl`,status:`completed`,summary:`${e.status===`reused`?`Loaded`:`Completed`} technical evidence for ${t} crawled ${t===1?`page`:`pages`}.`}}function $p(e){return e?[{tool:`seo_search_console_export`,status:`completed`,summary:Tp(e)}]:[]}function em(e){if(e.unreachedCount===0)return;let t=[];for(let n of e.unreachedPages.slice(0,10))try{let r=new URL(n.url);t.push(`${e.crawlOrigin}${r.pathname}${r.search}`)}catch{}if(!t.length)return;let n=e.unreachedCount-t.length;return{command:`seo reports run audit-urls --params '${JSON.stringify({urls:t})}' --json`,why:`Fetch page-level evidence for exported URLs this crawl never reached${n>0?` (first ${t.length} of ${e.unreachedCount})`:``}.${e.originMismatch?` URLs were mapped onto the --url origin by path because the export origin differs.`:``}`}}function tm(e,t={}){if(t.searchDataAvailable===!1){let e=[];return t.crawlStartUrl&&t.technicalBaselineStatus!==`created`&&t.technicalBaselineStatus!==`refreshed`&&t.technicalBaselineStatus!==`reused`?(Q(e,`seo crawl --url ${xp(t.crawlStartUrl)} --health`,`Run the fast sitemap response and access gate before fetching page bodies.`),Q(e,`seo crawl --url ${xp(t.crawlStartUrl)} --save`,`Create the technical crawl that this report needs before opening a page-level follow-up.`)):t.crawlStartUrl&&Q(e,`seo audit-page --url ${xp(t.crawlStartUrl)}`,`Inspect one important page in detail after the site-level crawl.`),Q(e,`seo start`,`Connect Search Console when you want traffic, query, and ranking evidence alongside the crawl.`),e}let n=t.projectId?`--project ${xp(t.projectId)}`:`--site ${xp(e.site)}`,r=e.output.narrative.diagnosis,i=r.decay.rangeDays,a=[],o=new Set((r.skippedSections??[]).map(e=>e.section));Q(a,`seo refresh-priorities ${n} --days ${i} --verify-content --limit 25`,`Turn the report into a ranked action queue with content checks.`),r.decay.summary.eligibleRows>0&&Q(a,`seo decaying ${n} --days ${i} --limit 25`,`Inspect query/page declines observed in both retained-row windows.`),r.cannibalization.items.length>0&&Q(a,`seo cannibal ${n} --days ${i} --limit 25`,`Find queries split across competing URLs.`),r.quickWins.summary.eligibleRows>0&&Q(a,`seo quick-wins ${n} --days ${i} --verify-content --verify-limit 5`,`Review average-position rows below their heuristic CTR target with optional page evidence.`),r.strikingDistance.summary.eligibleRows>0&&Q(a,`seo second-page ${n} --days ${i} --verify-content --verify-limit 5`,`Work pages sitting just outside page-one rankings.`),(o.has(`traffic anomaly`)||o.has(`update correlation`))&&(Q(a,`seo quick-wins ${n} --days ${i} --min-impressions 10 --verify-content --verify-limit 5`,`Sparse GSC data: lower thresholds and look for early content wins.`),Q(a,`seo second-page ${n} --days ${i} --min-impressions 10 --verify-content --verify-limit 5`,`Sparse GSC data: inspect early second-page opportunities.`));let s=r.segments.page.items.find(e=>e.key.startsWith(`http`));return s&&Q(a,`seo audit-page --url ${xp(s.key)}`,`Audit the biggest moved URL for title, metadata, links, and schema.`),t.crawlStartUrl&&t.technicalBaselineStatus!==`created`&&t.technicalBaselineStatus!==`refreshed`&&t.technicalBaselineStatus!==`reused`&&(Q(a,`seo crawl --url ${xp(t.crawlStartUrl)} --health`,`Run the fast sitemap response and access gate before fetching page bodies.`),Q(a,`seo crawl --url ${xp(t.crawlStartUrl)} ${n} --save`,`Create the first technical crawler baseline with plain-English fixes and JSON-ready issue data.`)),Q(a,`seo technical-watch ${n} --limit 50`,`Save a crawl/index baseline so future reports can flag technical drift.`),a.slice(0,6)}function nm(e){e.length&&(process.stdout.write(`
 Recommended next commands
-`),B([`Command`,`Why`],e.map(e=>[e.command,e.why])))}function tm(e){process.stdout.write(`# Technical SEO report: ${e}\n\n`)}function nm(e){return T({meta:e,args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...e.printFollowups?{url:{type:`string`,description:`Crawl URL for a technical-only report. Search Console analyses are skipped unless you also pass --site or --project.`}}:{},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Search performance window in days. Defaults to 90.`},limit:{description:`Maximum rows per section. Defaults to 10.`}}),...e.printFollowups?{crawl:Fa(`Create or reuse a bounded technical crawl before the report.`,`Skip technical crawl evidence for this report.`),"crawl-max-pages":{type:`string`,description:`Maximum pages for the report crawl. Defaults to 100.`},"crawl-max-depth":{type:`string`,description:`Maximum link depth for the report crawl. Defaults to 4.`},full:{type:`boolean`,default:!1,description:`Include the full report in JSON output. Default JSON is a compact summary for agents.`},"actions-only":{type:`boolean`,default:!1,description:`Return findings, verification, and the content inventory without the full report body. JSON only.`},"search-console-export":{type:`string`,description:`Path to a local Search Console export (a directory or CSV with the standard query and page tables). URL mode only; query and page tables stay separate.`},"inventory-page":{type:`string`,default:`1`,description:`Page of local Search Console export inventory rows to return. URL mode only.`},...df}:{},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:t})=>{let r=F(t),i=e.printFollowups?ff(t):void 0,a=e.printFollowups&&A(t.full),o=e.printFollowups&&A(t[`actions-only`]);if(o&&!r)throw new C(`INVALID_INPUT`,`Use --actions-only with --json so findings and completion outcomes stay machine-readable.`);if(o&&a)throw new C(`INVALID_INPUT`,`Choose either --actions-only or --full, not both.`);let s=k(t),c=O(t.site),l=e.printFollowups?O(t.url):void 0,u=!!(s||c||!l),d=e.printFollowups?O(t[`search-console-export`]):void 0,f=e.printFollowups?j(t[`inventory-page`])??1:1;if(!Number.isSafeInteger(f)||f<1)throw new C(`INVALID_INPUT`,`--inventory-page must be a positive integer.`);if(f!==1&&!d)throw new C(`INVALID_INPUT`,`Use --inventory-page only with --search-console-export.`);if(d&&u)throw new C(`INVALID_INPUT`,`Use --search-console-export only with --url. A connected property already provides query and page evidence, and imported tables must not be blended with it.`);let p=u?await H({client:s,site:c,options:{json:r,refresh:A(t.refresh)}}):void 0,m=p?.site??bp(l??``),h=await Jn({site:m,days:j(t.days),recentDays:j(t.recent),limit:j(t.limit),brandTerms:p?.client?.brandTerms,includeBrand:A(t[`include-brand`]),refresh:A(t.refresh),skipSearchData:!u}),g=e.workflowName?{...h,workflow:e.workflowName}:h,_=e.printFollowups?await Cr({site:m,searchSite:p?.site,url:l??p?.client?.startUrl??xs(m),projectId:p?.client?.id,googleAnalyticsPropertyId:p?.client?.analytics.google?.propertyId,analyticsConnection:Yn(p?.client),crawl:!La(t,`crawl`),refresh:A(t.refresh),maxPages:j(t[`crawl-max-pages`]),maxDepth:j(t[`crawl-max-depth`])}):void 0,v=_?Vp(_):void 0,y=d?await Oa({path:d}):void 0,b=y&&_?.report&&l?Na({pages:y.pages.rows,crawledUrls:_.report.pages.flatMap(e=>[e.url,e.finalUrl]),crawlOrigin:bp(l)}):void 0,ee=y?{evidence:y,reconciliation:b}:void 0,x=await(async()=>{if(!b||b.unreachedCount===0)return;let e=Bp(b,20);if(!e.length)return;let n=await it({url:e[0]??``,urls:e,mode:`list`,maxPages:e.length,useSitemap:!1,refresh:A(t.refresh)});return bn(n,void 0,{retention:`baseline`}),{reportId:n.id,auditedUrls:n.summary.totalPages,totalUnreached:b.unreachedCount,capped:b.unreachedCount>e.length,issueGroupsComplete:!0,topFixes:Tp(n),reviewObservations:Ep(n),pages:n.pages.map(e=>({url:e.finalUrl||e.url,title:e.title??null}))}})(),te=_?.report?jp(_.report.pages,x?.pages):void 0,ne=y&&te?Ip({queries:y.queries.rows,pages:te}):void 0,re=y&&te?Fp({pages:y.pages.rows,sourceCapped:y.pages.capped,page:f,reconciliation:b,crawledPages:te,overlap:ne}):void 0,ie=_?.report?zp({crawlReportId:_.report.id,topFixes:Tp(_.report),reviewObservations:Ep(_.report),reconciliation:b,...x?{unreachedAudit:{reportId:x.reportId,topFixes:x.topFixes,reviewObservations:x.reviewObservations,titlePrefix:`unreached pages:`}}:{},...ne?{topicOverlap:ne}:{},...re?{pageInventory:re}:{}}):void 0,S=e.printFollowups?$p(g,{crawlStartUrl:l??p?.client?.startUrl??xs(m),projectId:p?.client?.id,technicalBaselineStatus:_?.status,searchDataAvailable:u}):void 0;if(S&&b&&(!x||x.capped)){let e=Qp(b);e&&S.unshift(e)}if(r){let t=e.printFollowups&&!a?vp(h,e.workflowName):g,r=Wp(t.actions,ie),i=!u&&v?{...t,summary:Yp(v,ee,x),steps:[Xp(v),...Zp(ee),...t.steps],actions:r,...a?{}:{output:{searchSections:{status:`skipped`,reason:`No Search Console property was selected. Pass --site or --project, or run seo start to connect one.`}}}}:{...t,actions:r},s=v||S?{...i,...e.printFollowups?{detail:a?`full`:`summary`}:{},...v?{technicalCrawl:e.printFollowups&&!a?Up(v):v}:{},...y?{searchConsoleExport:{...xp({evidence:y,reconciliation:b,pageInventory:re}),...x?{unreachedPagesAudit:x}:{},...ne?{topicOverlapCandidates:ne}:{}}}:{},...S?{nextCommands:S}:{}}:t,c={reportId:`report`,preferRootActions:!0,verify:`Rerun seo report with the same inputs and confirm the finding is absent or its evidence now matches the intended state.`,...!u&&v&&`issueGroupsComplete`in v&&v.issueGroupsComplete?{coverage:`complete`}:{}};R(Fn(o?n(s,c):Zt(s,c)));return}if(i){gf(await hf({report:g.output.narrative,reportName:`report`,title:u?`SEO report`:`Technical SEO report`,options:i,projectId:p?.client?.id,additionalSections:Jp({technicalCrawl:v,followups:S})}));return}u?(process.stdout.write(`${g.output.narrative.markdown}\n\n`),Bu(g)):tm(m),v&&(Gp(v,{providerFree:!u}),y&&Kp({evidence:y,reconciliation:b,unreachedAudit:x,topicOverlap:ne,pageInventory:re}),u||qp(v)),S&&em(S)}})}const rm=nm({name:`diagnose-property`,description:`Find what changed in Google Search and what to inspect next`}),im=nm({name:`report`,workflowName:`report`,printFollowups:!0,description:`Run the main SEO report and recommend the next best follow-up commands`}),am=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...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.`}}),...el,"verify-content":Fa(`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=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await an({site:n.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),googleAnalyticsPropertyId:O(e[`google-analytics-property`]),analyticsConnection:tl(e,Yn(n.client)),verifyContent:A(e[`verify-content`]),verifyLimit:j(e[`verify-limit`]),refresh:A(e.refresh)});if(t){R(r);return}Bu(r),B([`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})))}}),om=T({meta:{name:`technical-watch`,description:`Agent workflow for crawl-diff and index-watch monitoring`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},url:{type:`string`,description:`Start URL to crawl. Defaults from the GSC property when possible.`},urls:{type:`string`,description:`Comma-separated URLs to inspect with URL Inspection.`},sitemaps:{type:`string`,description:`Comma-separated XML sitemap URLs for quota-aware index monitoring.`},properties:{type:`string`,description:`Comma-separated GSC properties for sitemap index monitoring.`},limit:{type:`string`,description:`Maximum pages to crawl. Defaults to 50.`},"daily-limit":{type:`string`,description:`URL Inspection daily limit per property. Defaults to 2000.`},"inspect-limit":{type:`string`,description:`Maximum sitemap URLs to inspect in this run. Defaults to 100.`},"max-urls":{type:`string`,description:`Maximum sitemap URLs to load for monitoring. Defaults to 50000.`},language:{type:`string`,description:`Optional URL Inspection language code.`},"recover-links":Fa(`Check search-value GSC pages for broken, blocked, or poorly redirected URLs. Defaults to true.`,`Skip link recovery checks.`),"recover-days":{type:`string`,description:`GSC lookback window for link recovery. Defaults to 90.`},"recover-limit":{type:`string`,description:`Maximum search-value pages to check for link recovery. Defaults to 10.`},"recover-min-clicks":{type:`string`,description:`Minimum clicks for link recovery candidates. Defaults to 1.`},"recover-min-impressions":{type:`string`,description:`Minimum impressions for link recovery candidates. Defaults to 100.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP/GSC cache where supported.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering when Playwright is installed.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=P(e.urls),i=P(e.sitemaps),a=O(e.url)??n.client?.startUrl??xs(n.site),o=await Xt({site:n.site,startUrl:a,urls:r.length?r:n.client?.watchUrls,sitemaps:i.length?i:void 0,properties:P(e.properties).length?P(e.properties):void 0,limit:j(e.limit),languageCode:O(e.language),dailyLimit:j(e[`daily-limit`]),inspectLimit:j(e[`inspect-limit`]),maxUrls:j(e[`max-urls`]),refresh:A(e.refresh),js:A(e.js)?!0:`auto`,recoverLinks:A(e[`recover-links`]),recoverDays:j(e[`recover-days`]),recoverLimit:j(e[`recover-limit`]),recoverMinClicks:j(e[`recover-min-clicks`]),recoverMinImpressions:j(e[`recover-min-impressions`])});if(t){R(o);return}Vu(o)}});function sm(e){return e===null?`-`:e.toLocaleString(`en-GB`,{maximumFractionDigits:e>=100?0:1})}function cm(e){return[...e.winners.map(e=>({direction:`winner`,item:e})),...e.losers.map(e=>({direction:`loser`,item:e}))]}function lm(e,t){let n=cm(t);n.length&&(process.stdout.write(`\n${e}\n`),B([`Direction`,`Key`,`Clicks`,`Impr.`,`Position`],n.map(({direction:e,item:t})=>[e,t.key,sm(t.clickDelta),sm(t.impressionDelta),sm(t.positionDelta)])))}function um(e){process.stdout.write(`
+`),B([`Command`,`Why`],e.map(e=>[e.command,e.why])))}function rm(e){process.stdout.write(`# Technical SEO report: ${e}\n\n`)}function im(e){return T({meta:e,args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...e.printFollowups?{url:{type:`string`,description:`Crawl URL for a technical-only report. Search Console analyses are skipped unless you also pass --site or --project.`}}:{},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Search performance window in days. Defaults to 90.`},limit:{description:`Maximum rows per section. Defaults to 10.`}}),...e.printFollowups?{crawl:Fa(`Create or reuse a bounded technical crawl before the report.`,`Skip technical crawl evidence for this report.`),"crawl-max-pages":{type:`string`,description:`Maximum pages for the report crawl. Defaults to 100.`},"crawl-max-depth":{type:`string`,description:`Maximum link depth for the report crawl. Defaults to 4.`},full:{type:`boolean`,default:!1,description:`Include the full report in JSON output. Default JSON is a compact summary for agents.`},"actions-only":{type:`boolean`,default:!1,description:`Return findings, verification, and the content inventory without the full report body. JSON only.`},"search-console-export":{type:`string`,description:`Path to a local Search Console export (a directory or CSV with the standard query and page tables). URL mode only; query and page tables stay separate.`},"inventory-page":{type:`string`,default:`1`,description:`Page of local Search Console export inventory rows to return. URL mode only.`},...pf}:{},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:t})=>{let r=F(t),i=e.printFollowups?mf(t):void 0,a=e.printFollowups&&A(t.full),o=e.printFollowups&&A(t[`actions-only`]);if(o&&!r)throw new C(`INVALID_INPUT`,`Use --actions-only with --json so findings and completion outcomes stay machine-readable.`);if(o&&a)throw new C(`INVALID_INPUT`,`Choose either --actions-only or --full, not both.`);let s=k(t),c=O(t.site),l=e.printFollowups?O(t.url):void 0,u=!!(s||c||!l),d=e.printFollowups?O(t[`search-console-export`]):void 0,f=e.printFollowups?j(t[`inventory-page`])??1:1;if(!Number.isSafeInteger(f)||f<1)throw new C(`INVALID_INPUT`,`--inventory-page must be a positive integer.`);if(f!==1&&!d)throw new C(`INVALID_INPUT`,`Use --inventory-page only with --search-console-export.`);if(d&&u)throw new C(`INVALID_INPUT`,`Use --search-console-export only with --url. A connected property already provides query and page evidence, and imported tables must not be blended with it.`);let p=u?await H({client:s,site:c,options:{json:r,refresh:A(t.refresh)}}):void 0,m=p?.site??Sp(l??``),h=await Jn({site:m,days:j(t.days),recentDays:j(t.recent),limit:j(t.limit),brandTerms:p?.client?.brandTerms,includeBrand:A(t[`include-brand`]),refresh:A(t.refresh),skipSearchData:!u}),g=e.workflowName?{...h,workflow:e.workflowName}:h,_=e.printFollowups?await Cr({site:m,searchSite:p?.site,url:l??p?.client?.startUrl??Cs(m),projectId:p?.client?.id,googleAnalyticsPropertyId:p?.client?.analytics.google?.propertyId,analyticsConnection:Yn(p?.client),crawl:!La(t,`crawl`),refresh:A(t.refresh),maxPages:j(t[`crawl-max-pages`]),maxDepth:j(t[`crawl-max-depth`])}):void 0,v=_?Up(_):void 0,y=d?await Oa({path:d}):void 0,b=y&&_?.report&&l?Na({pages:y.pages.rows,crawledUrls:_.report.pages.flatMap(e=>[e.url,e.finalUrl]),crawlOrigin:Sp(l)}):void 0,ee=y?{evidence:y,reconciliation:b}:void 0,x=await(async()=>{if(!b||b.unreachedCount===0)return;let e=Hp(b,20);if(!e.length)return;let n=await it({url:e[0]??``,urls:e,mode:`list`,maxPages:e.length,useSitemap:!1,refresh:A(t.refresh)});return bn(n,void 0,{retention:`baseline`}),{reportId:n.id,auditedUrls:n.summary.totalPages,totalUnreached:b.unreachedCount,capped:b.unreachedCount>e.length,issueGroupsComplete:!0,topFixes:Dp(n),reviewObservations:Op(n),pages:n.pages.map(e=>({url:e.finalUrl||e.url,title:e.title??null}))}})(),te=_?.report?Np(_.report.pages,x?.pages):void 0,ne=y&&te?Rp({queries:y.queries.rows,pages:te}):void 0,re=y&&te?Lp({pages:y.pages.rows,sourceCapped:y.pages.capped,page:f,reconciliation:b,crawledPages:te,overlap:ne}):void 0,ie=_?.report?Vp({crawlReportId:_.report.id,topFixes:Dp(_.report),reviewObservations:Op(_.report),reconciliation:b,...x?{unreachedAudit:{reportId:x.reportId,topFixes:x.topFixes,reviewObservations:x.reviewObservations,titlePrefix:`unreached pages:`}}:{},...ne?{topicOverlap:ne}:{},...re?{pageInventory:re}:{}}):void 0,S=e.printFollowups?tm(g,{crawlStartUrl:l??p?.client?.startUrl??Cs(m),projectId:p?.client?.id,technicalBaselineStatus:_?.status,searchDataAvailable:u}):void 0;if(S&&b&&(!x||x.capped)){let e=em(b);e&&S.unshift(e)}if(r){let t=e.printFollowups&&!a?bp(h,e.workflowName):g,r=Kp(t.actions,ie),i=!u&&v?{...t,summary:Zp(v,ee,x),steps:[Qp(v),...$p(ee),...t.steps],actions:r,...a?{}:{output:{searchSections:{status:`skipped`,reason:`No Search Console property was selected. Pass --site or --project, or run seo start to connect one.`}}}}:{...t,actions:r},s=v||S?{...i,...e.printFollowups?{detail:a?`full`:`summary`}:{},...v?{technicalCrawl:e.printFollowups&&!a?Gp(v):v}:{},...y?{searchConsoleExport:{...Cp({evidence:y,reconciliation:b,pageInventory:re}),...x?{unreachedPagesAudit:x}:{},...ne?{topicOverlapCandidates:ne}:{}}}:{},...S?{nextCommands:S}:{}}:t,c={reportId:`report`,preferRootActions:!0,verify:`Rerun seo report with the same inputs and confirm the finding is absent or its evidence now matches the intended state.`,...!u&&v&&`issueGroupsComplete`in v&&v.issueGroupsComplete?{coverage:`complete`}:{}};R(Fn(o?n(s,c):Zt(s,c)));return}if(i){vf(await _f({report:g.output.narrative,reportName:`report`,title:u?`SEO report`:`Technical SEO report`,options:i,projectId:p?.client?.id,additionalSections:Xp({technicalCrawl:v,followups:S})}));return}u?(process.stdout.write(`${g.output.narrative.markdown}\n\n`),Hu(g)):rm(m),v&&(qp(v,{providerFree:!u}),y&&Jp({evidence:y,reconciliation:b,unreachedAudit:x,topicOverlap:ne,pageInventory:re}),u||Yp(v)),S&&nm(S)}})}const am=im({name:`diagnose-property`,description:`Find what changed in Google Search and what to inspect next`}),om=im({name:`report`,workflowName:`report`,printFollowups:!0,description:`Run the main SEO report and recommend the next best follow-up commands`}),sm=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...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.`}}),...nl,"verify-content":Fa(`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=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await an({site:n.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),googleAnalyticsPropertyId:O(e[`google-analytics-property`]),analyticsConnection:rl(e,Yn(n.client)),verifyContent:A(e[`verify-content`]),verifyLimit:j(e[`verify-limit`]),refresh:A(e.refresh)});if(t){R(r);return}Hu(r),B([`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})))}}),cm=T({meta:{name:`technical-watch`,description:`Agent workflow for crawl-diff and index-watch monitoring`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},url:{type:`string`,description:`Start URL to crawl. Defaults from the GSC property when possible.`},urls:{type:`string`,description:`Comma-separated URLs to inspect with URL Inspection.`},sitemaps:{type:`string`,description:`Comma-separated XML sitemap URLs for quota-aware index monitoring.`},properties:{type:`string`,description:`Comma-separated GSC properties for sitemap index monitoring.`},limit:{type:`string`,description:`Maximum pages to crawl. Defaults to 50.`},"daily-limit":{type:`string`,description:`URL Inspection daily limit per property. Defaults to 2000.`},"inspect-limit":{type:`string`,description:`Maximum sitemap URLs to inspect in this run. Defaults to 100.`},"max-urls":{type:`string`,description:`Maximum sitemap URLs to load for monitoring. Defaults to 50000.`},language:{type:`string`,description:`Optional URL Inspection language code.`},"recover-links":Fa(`Check search-value GSC pages for broken, blocked, or poorly redirected URLs. Defaults to true.`,`Skip link recovery checks.`),"recover-days":{type:`string`,description:`GSC lookback window for link recovery. Defaults to 90.`},"recover-limit":{type:`string`,description:`Maximum search-value pages to check for link recovery. Defaults to 10.`},"recover-min-clicks":{type:`string`,description:`Minimum clicks for link recovery candidates. Defaults to 1.`},"recover-min-impressions":{type:`string`,description:`Minimum impressions for link recovery candidates. Defaults to 100.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP/GSC cache where supported.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering when Playwright is installed.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=P(e.urls),i=P(e.sitemaps),a=O(e.url)??n.client?.startUrl??Cs(n.site),o=await Xt({site:n.site,startUrl:a,urls:r.length?r:n.client?.watchUrls,sitemaps:i.length?i:void 0,properties:P(e.properties).length?P(e.properties):void 0,limit:j(e.limit),languageCode:O(e.language),dailyLimit:j(e[`daily-limit`]),inspectLimit:j(e[`inspect-limit`]),maxUrls:j(e[`max-urls`]),refresh:A(e.refresh),js:A(e.js)?!0:`auto`,recoverLinks:A(e[`recover-links`]),recoverDays:j(e[`recover-days`]),recoverLimit:j(e[`recover-limit`]),recoverMinClicks:j(e[`recover-min-clicks`]),recoverMinImpressions:j(e[`recover-min-impressions`])});if(t){R(o);return}Uu(o)}});function lm(e){return e===null?`-`:e.toLocaleString(`en-GB`,{maximumFractionDigits:e>=100?0:1})}function um(e){return[...e.winners.map(e=>({direction:`winner`,item:e})),...e.losers.map(e=>({direction:`loser`,item:e}))]}function dm(e,t){let n=um(t);n.length&&(process.stdout.write(`\n${e}\n`),B([`Direction`,`Key`,`Clicks`,`Impr.`,`Position`],n.map(({direction:e,item:t})=>[e,t.key,lm(t.clickDelta),lm(t.impressionDelta),lm(t.positionDelta)])))}function fm(e){process.stdout.write(`
 Segment coverage
-`),B([`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 dm(e){e.length&&(process.stdout.write(`
+`),B([`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 pm(e){e.length&&(process.stdout.write(`
 Template movement
-`),B([`Direction`,`Template`,`Pattern confidence`,`URLs`,`Clicks`,`Returned share`,`Common terms`],e.map(e=>[e.direction,e.signature,e.confidence,e.urlCount,sm(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 fm=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...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.`},"ignore-change-log":{type:`boolean`,default:!1,description:`Do not use saved change-log entries as confounders.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await _r({site:n.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),knownConfounders:O(e[`known-change`])?[O(e[`known-change`])??``]:void 0,includeChangeLog:!A(e[`ignore-change-log`]),refresh:A(e.refresh)});if(t){R(r);return}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)),dm(r.output.templateMovement),Y(`Update evidence`,r.output.update.evidence),um(r.output.segments),lm(`Page winners and losers`,r.output.segments.page),lm(`Query winners and losers`,r.output.segments.query),lm(`Device winners and losers`,r.output.segments.device),lm(`Country winners and losers`,r.output.segments.country),ls(`seo export update-postmortem ${n.client?`--project ${JSON.stringify(n.client.id)}`:`--site ${JSON.stringify(n.site)}`}`)}}),pm=new Set([`database`,`filesystem`,`internal`,`unknown`]);function mm(e){return e.replace(/^v/,``).split(`.`)[0]||`unknown`}function hm(e){return Er(e[0])?e[0]:void 0}function gm(e,t){return Gn(e)?`seo ${e}`:t?`seo ${t}`:`seo command`}function _m(e){let t=Bt(e.error);if(!pm.has(t.errorCategory))return;let n=hm(e.args),r=gm(e.report,n),i=[mr(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??Ir),a.searchParams.set(`runtime`,`Node ${mm(e.nodeVersion??process.version)} on ${e.processPlatform??si()} (${e.processArch??ai()})`),a.searchParams.set(`diagnostics`,i),a.toString()}function vm(e){return e.replaceAll(`\\`,`/`).toLowerCase()}function ym(e,t){return t===`win32`?`${e}.cmd`:e}function bm(e,t=process.platform){let n=vm(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:ym(`pnpm`,t),args:[`add`,`--global`,`seo@latest`]};if(n.includes(`/.bun/install/global/`))return{command:ym(`bun`,t),args:[`add`,`--global`,`seo@latest`]};if(n.includes(`/.config/yarn/global/`))return{command:ym(`yarn`,t),args:[`global`,`add`,`seo@latest`]};if(n.includes(`/node_modules/seo/`))return{command:ym(`npm`,t),args:[`install`,`--global`,`seo@latest`]}}}function xm(e,t){let n=e=>e.replace(/^v/,``).split(`-`)[0]?.split(`.`).map(e=>Number.parseInt(e,10))??[],r=n(e),i=n(t);for(let e=0;e<3;e+=1){let t=r[e]??0,n=i[e]??0;if(!Number.isFinite(t)||!Number.isFinite(n))return!1;if(n>t)return!0;if(n<t)return!1}return!1}function Sm(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 Cm(e){if(e)try{return qr(e)}catch{return e}}async function wm(e){let t=await Ni({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 Oi(t)?`later`:t}function Tm(e){return Si(e.command,e.args,{stdio:`inherit`}).status}async function Em(e,t={}){if(!Sm({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=Cm(t.cliPath??process.argv[1]),r=n?bm(n,t.platform??process.platform):void 0;if(!r)return;let i=(t.createNotifier??(e=>Ui({pkg:e,shouldNotifyInNpmScript:!1})))(e).update;if(!(!i||!xm(i.current,i.latest))&&await(t.prompt??wm)({command:r,update:i})!==`later`)return(t.run??Tm)(r)===0?(ki.success(`Updated seo to ${i.latest}. Run your command again.`),0):(ki.error(`The update failed. Your current version is unchanged.`),1)}const Dm={name:`seo`,version:Ir},Om=[{title:`Start here`,commands:[[`seo start`,`Connect first-party data and save a project profile`],[`seo report`,`Run the main SEO report for the default project`],[`seo report --site sc-domain:example.com`,`Run without a profile`],[`seo report --url https://example.com`,`Start with a local technical report`]]},{title:`Projects`,commands:[[`seo projects list`,`List saved project profiles`],[`seo projects add`,`Create or update a project profile`],[`seo sites`,`List Search Console properties`],[`seo doctor`,`Check local auth and config`]]},{title:`Act on a report`,commands:[[`seo refresh-priorities`,`Rank the next best SEO actions`],[`seo quick-wins`,`Find ranking 4-10 low-CTR wins`],[`seo second-page`,`Investigate URLs averaging positions 10-20`],[`seo technical-watch`,`Crawl and index-monitor a site`]]},{title:`Agent and power tools`,commands:[[`seo report --json`,`Run the main report as structured JSON`],[`seo export diagnose`,`Export report data to CSV`],[`seo mcp install`,`Install SEO tools into MCP clients`],[`seo skill list`,`Show the packaged SEO skill`],[`seo reports list`,`Discover every structured report`]]}],km=[...Om,{title:`Deeper analysis`,commands:[[`seo decaying`,`Find pages and queries losing clicks`],[`seo cannibal`,`Review queries exposed across multiple URLs`],[`seo ctr-underperformers`,`Find weak CTR by ranking position`],[`seo query-cluster`,`Cluster repeated demand themes`],[`seo page-opportunities`,`Analyze one URL for growth ideas`],[`seo content optimize`,`Build a content optimization report`],[`seo perf audit`,`Run a page performance audit`],[`seo internal-links`,`Find internal link opportunities`],[`seo community-intent`,`Find forum, review, and comparison intent`],[`seo ai-referrals`,`Find AI referral traffic in Google Analytics`],[`seo seo-to-ai-query`,`Convert searches into AI-monitor prompts`]]},{title:`Technical and data`,commands:[[`seo audit-page`,`Audit one page`],[`seo crawl --sitemap-url <url> --health`,`Run the fast sitemap gate before a full crawl`],[`seo crawl`,`Run a full crawl for page and content evidence`],[`seo agent-readiness`,`Check content-site readiness for AI agents`],[`seo ai-readiness`,`Review AI-search technical evidence`],[`seo llms audit`,`Inspect optional llms.txt presence`],[`seo entity-readiness`,`Check brand/entity signals from a saved crawl`],[`seo okf export`,`Export a saved crawl as an OKF knowledge bundle`],[`seo crawl-queue`,`Run a crawl and rank the implementation queue`],[`seo crawl-reports`,`List saved crawl reports`],[`seo rules`,`List crawler rule ids`],[`seo explain --rule missing_title`,`Explain a crawler rule`],[`seo crawl-diff`,`Compare crawl changes`],[`seo index-coverage`,`Choose pages for URL Inspection`],[`seo index-watch`,`Check URL Inspection status`],[`seo indexnow submit`,`Notify IndexNow about changed URLs`],[`seo link-recover`,`Find broken search-value URLs`],[`seo links`,`Review bounded referring-link evidence`],[`seo server-logs analyze`,`Review crawler requests in an access log`],[`seo redirect-trace`,`Trace redirects`],[`seo gsc-query`,`Run a raw GSC query`],[`seo url-inspect`,`Run URL Inspection`],[`seo analytics google properties`,`List Google Analytics properties`],[`seo analytics google report`,`Run a Google Analytics report`],[`seo updates`,`List official Google ranking updates`]]},{title:`Reports and ops`,commands:[[`seo monthly-report`,`Generate a monthly narrative`],[`seo report-narrative`,`Generate a client-ready narrative`],[`seo update-postmortem`,`Analyze update winners and losers`],[`seo schedule cron`,`Print cron entries`],[`seo monitoring`,`Run and review monitoring`],[`seo change-log`,`Track SEO changes`],[`seo tests`,`Create and report local SEO tests`],[`seo content-groups`,`Manage reusable page/query groups`],[`seo pseo`,`Audit programmatic SEO templates`],[`seo auth`,`Manage Google auth`],[`seo providers bing`,`Connect and report on Bing Webmaster`],[`seo providers dataforseo`,`Connect optional search data`],[`seo providers semrush`,`Connect optional Semrush data`],[`seo providers list`,`List optional provider packages`],[`seo providers connect`,`Connect an installed provider package`],[`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 Am(e){Do(`seo v${Dm.version}`,`Run SEO audits, find what needs fixing, and ship the changes with your agent.`),process.stdout.write(`
+`),B([`Direction`,`Template`,`Pattern confidence`,`URLs`,`Clicks`,`Returned share`,`Common terms`],e.map(e=>[e.direction,e.signature,e.confidence,e.urlCount,lm(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 mm=T({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.`},client:{type:`string`,description:`Legacy alias for --project.`},project:{type:`string`,description:`Saved project id or name.`},...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.`},"ignore-change-log":{type:`boolean`,default:!1,description:`Do not use saved change-log entries as confounders.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=F(e),n=await H({client:k(e),site:O(e.site),options:{json:t,refresh:A(e.refresh)}}),r=await _r({site:n.site,days:j(e.days),recentDays:j(e.recent),limit:j(e.limit),brandTerms:n.client?.brandTerms,includeBrand:A(e[`include-brand`]),knownConfounders:O(e[`known-change`])?[O(e[`known-change`])??``]:void 0,includeChangeLog:!A(e[`ignore-change-log`]),refresh:A(e.refresh)});if(t){R(r);return}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)),pm(r.output.templateMovement),Y(`Update evidence`,r.output.update.evidence),fm(r.output.segments),dm(`Page winners and losers`,r.output.segments.page),dm(`Query winners and losers`,r.output.segments.query),dm(`Device winners and losers`,r.output.segments.device),dm(`Country winners and losers`,r.output.segments.country),ls(`seo export update-postmortem ${n.client?`--project ${JSON.stringify(n.client.id)}`:`--site ${JSON.stringify(n.site)}`}`)}}),hm=new Set([`database`,`filesystem`,`internal`,`unknown`]);function gm(e){return e.replace(/^v/,``).split(`.`)[0]||`unknown`}function _m(e){return Er(e[0])?e[0]:void 0}function vm(e,t){return Gn(e)?`seo ${e}`:t?`seo ${t}`:`seo command`}function ym(e){let t=Bt(e.error);if(!hm.has(t.errorCategory))return;let n=_m(e.args),r=vm(e.report,n),i=[mr(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??Ir),a.searchParams.set(`runtime`,`Node ${gm(e.nodeVersion??process.version)} on ${e.processPlatform??si()} (${e.processArch??ai()})`),a.searchParams.set(`diagnostics`,i),a.toString()}function bm(e){return e.replaceAll(`\\`,`/`).toLowerCase()}function xm(e,t){return t===`win32`?`${e}.cmd`:e}function Sm(e,t=process.platform){let n=bm(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:xm(`pnpm`,t),args:[`add`,`--global`,`seo@latest`]};if(n.includes(`/.bun/install/global/`))return{command:xm(`bun`,t),args:[`add`,`--global`,`seo@latest`]};if(n.includes(`/.config/yarn/global/`))return{command:xm(`yarn`,t),args:[`global`,`add`,`seo@latest`]};if(n.includes(`/node_modules/seo/`))return{command:xm(`npm`,t),args:[`install`,`--global`,`seo@latest`]}}}function Cm(e,t){let n=e=>e.replace(/^v/,``).split(`-`)[0]?.split(`.`).map(e=>Number.parseInt(e,10))??[],r=n(e),i=n(t);for(let e=0;e<3;e+=1){let t=r[e]??0,n=i[e]??0;if(!Number.isFinite(t)||!Number.isFinite(n))return!1;if(n>t)return!0;if(n<t)return!1}return!1}function wm(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 Tm(e){if(e)try{return qr(e)}catch{return e}}async function Em(e){let t=await Ni({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 Oi(t)?`later`:t}function Dm(e){return Si(e.command,e.args,{stdio:`inherit`}).status}async function Om(e,t={}){if(!wm({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=Tm(t.cliPath??process.argv[1]),r=n?Sm(n,t.platform??process.platform):void 0;if(!r)return;let i=(t.createNotifier??(e=>Ui({pkg:e,shouldNotifyInNpmScript:!1})))(e).update;if(!(!i||!Cm(i.current,i.latest))&&await(t.prompt??Em)({command:r,update:i})!==`later`)return(t.run??Dm)(r)===0?(ki.success(`Updated seo to ${i.latest}. Run your command again.`),0):(ki.error(`The update failed. Your current version is unchanged.`),1)}const km={name:`seo`,version:Ir},Am=[{title:`Start here`,commands:[[`seo start`,`Connect first-party data and save a project profile`],[`seo report`,`Run the main SEO report for the default project`],[`seo report --site sc-domain:example.com`,`Run without a profile`],[`seo report --url https://example.com`,`Start with a local technical report`]]},{title:`Projects`,commands:[[`seo projects list`,`List saved project profiles`],[`seo projects add`,`Create or update a project profile`],[`seo sites`,`List Search Console properties`],[`seo doctor`,`Check local auth and config`]]},{title:`Act on a report`,commands:[[`seo refresh-priorities`,`Rank the next best SEO actions`],[`seo quick-wins`,`Find ranking 4-10 low-CTR wins`],[`seo second-page`,`Investigate URLs averaging positions 10-20`],[`seo technical-watch`,`Crawl and index-monitor a site`]]},{title:`Agent and power tools`,commands:[[`seo report --json`,`Run the main report as structured JSON`],[`seo export diagnose`,`Export report data to CSV`],[`seo mcp install`,`Install SEO tools into MCP clients`],[`seo skill list`,`Show the packaged SEO skill`],[`seo reports list`,`Discover every structured report`]]}],jm=[...Am,{title:`Deeper analysis`,commands:[[`seo decaying`,`Find pages and queries losing clicks`],[`seo cannibal`,`Review queries exposed across multiple URLs`],[`seo ctr-underperformers`,`Find weak CTR by ranking position`],[`seo query-cluster`,`Cluster repeated demand themes`],[`seo page-opportunities`,`Analyze one URL for growth ideas`],[`seo content optimize`,`Build a content optimization report`],[`seo perf audit`,`Run a page performance audit`],[`seo internal-links`,`Find internal link opportunities`],[`seo community-intent`,`Find forum, review, and comparison intent`],[`seo ai-referrals`,`Find AI referral traffic in Google Analytics`],[`seo seo-to-ai-query`,`Convert searches into AI-monitor prompts`]]},{title:`Technical and data`,commands:[[`seo audit-page`,`Audit one page`],[`seo crawl --sitemap-url <url> --health`,`Run the fast sitemap gate before a full crawl`],[`seo crawl`,`Run a full crawl for page and content evidence`],[`seo agent-readiness`,`Check content-site readiness for AI agents`],[`seo ai-readiness`,`Review AI-search technical evidence`],[`seo llms audit`,`Inspect optional llms.txt presence`],[`seo entity-readiness`,`Check brand/entity signals from a saved crawl`],[`seo okf export`,`Export a saved crawl as an OKF knowledge bundle`],[`seo crawl-queue`,`Run a crawl and rank the implementation queue`],[`seo crawl-reports`,`List saved crawl reports`],[`seo rules`,`List crawler rule ids`],[`seo explain --rule missing_title`,`Explain a crawler rule`],[`seo crawl-diff`,`Compare crawl changes`],[`seo index-coverage`,`Choose pages for URL Inspection`],[`seo index-watch`,`Check URL Inspection status`],[`seo indexnow submit`,`Notify IndexNow about changed URLs`],[`seo link-recover`,`Find broken search-value URLs`],[`seo links`,`Review bounded referring-link evidence`],[`seo server-logs analyze`,`Review crawler requests in an access log`],[`seo redirect-trace`,`Trace redirects`],[`seo gsc-query`,`Run a raw GSC query`],[`seo url-inspect`,`Run URL Inspection`],[`seo analytics google properties`,`List Google Analytics properties`],[`seo analytics google report`,`Run a Google Analytics report`],[`seo updates`,`List official Google ranking updates`]]},{title:`Reports and ops`,commands:[[`seo monthly-report`,`Generate a monthly narrative`],[`seo report-narrative`,`Generate a client-ready narrative`],[`seo update-postmortem`,`Analyze update winners and losers`],[`seo schedule cron`,`Print cron entries`],[`seo monitoring`,`Run and review monitoring`],[`seo change-log`,`Track SEO changes`],[`seo tests`,`Create and report local SEO tests`],[`seo content-groups`,`Manage reusable page/query groups`],[`seo pseo`,`Audit programmatic SEO templates`],[`seo auth`,`Manage Google auth`],[`seo providers bing`,`Connect and report on Bing Webmaster`],[`seo providers dataforseo`,`Connect optional search data`],[`seo providers semrush`,`Connect optional Semrush data`],[`seo providers list`,`List optional provider packages`],[`seo providers connect`,`Connect an installed provider package`],[`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 Mm(e){Do(`seo v${km.version}`,`Run SEO audits, find what needs fixing, and ship the changes with your agent.`),process.stdout.write(`
 `),Ao(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(`
-`),Mo(`More help`,"Use `seo help <command>` or `seo <command> --help` for command help.","Use `seo help all` for the longer command list.")}const jm=T({meta:{name:`seo`,version:Dm.version,description:`Local-first SEO CLI and MCP server`},subCommands:{init:Eu,indexnow:Tu,analytics:ds,llms:ju,auth:gs,mcp:Fu,okf:$u,doctor:vd,privacy:ip,telemetry:fp,reset:ap,cache:ys,logs:Mu,crawl:rl,"crawl-queue":pp,"crawl-reports":vl,client:Uc,content:Gc,project:Wc,projects:Wc,providers:Yd,"change-log":Al,tests:Hl,"content-groups":Nl,"crawl-diff":Iu,diagnose:_d,"diagnose-property":rm,export:xu,"index-coverage":qu,"index-watch":Ju,"link-recover":Yu,links:Du,"monthly-report":_f,monitoring:Ku,"report-narrative":vf,rules:yf,explain:bf,"refresh-priorities":am,"redirect-trace":Xu,schedule:Cf,"server-logs":wf,skill:rp,start:yc,setup:vc,report:im,reports:uf,"segment-impact":bd,"striking-distance":Sd,"technical-watch":om,"update-postmortem":fm,sites:op,"gsc-query":yl,"url-inspect":bl,updates:sp,"traffic-anomaly":wl,"update-correlate":Tl,"ai-referrals":ed,"agent-readiness":Ko,"ai-readiness":Uo,"entity-readiness":Dl,"audit-page":fd,"second-page":ud,cannibal:td,"community-intent":nd,decaying:ad,"quick-wins":ld,"page-opportunities":sd,perf:gd,"internal-links":od,"ctr-underperformers":rd,"query-cluster":cd,"seo-to-ai-query":dd,pseo:rf},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")}}),Mm={cannibal:`cannibalisation`,crawl:`site-crawl`,"crawl-queue":`top-fixes`,decaying:`decaying-pages`,"diagnose-property":`search-performance-overview`,doctor:`setup-check`,explain:`explain-crawl-issue`,"link-recover":`link-recovery`,"monthly-report":`monthly-report`,"query-cluster":`query-clusters`,report:`search-performance-overview`,"report-narrative":`narrative-report`,rules:`crawler-rules`,"update-correlate":`update-correlation`},Nm=new Set([`agent-readiness`,`ai-readiness`,`ai-referrals`,`audit-page`,`community-intent`,`crawl-diff`,`ctr-underperformers`,`entity-readiness`,`index-coverage`,`index-watch`,`internal-links`,`link-evidence`,`page-opportunities`,`quick-wins`,`redirect-trace`,`refresh-priorities`,`second-page`,`segment-impact`,`seo-to-ai-query`,`striking-distance`,`technical-watch`,`traffic-anomaly`,`update-postmortem`]),Pm=new Set(rr().map(e=>e.id));function Fm(e){let[t,n,r]=e;if(t)return t===`reports`&&n===`run`?r&&Pm.has(r)?r:void 0:t===`content`&&n===`optimize`?`content-optimization`:t===`change-log`&&n===`measure`?`measure-change`:t===`llms`&&n===`audit`?`llms-txt-audit`:t===`links`?`link-evidence`:t===`llms`&&n===`generate`?`generate-llms-txt`:t===`okf`&&n===`export`?`okf-build`:t===`okf`&&n===`validate`?`okf-validate`:t===`monitoring`&&n===`run`?`technical-watch`:t===`perf`&&n===`audit`?`performance-audit`:t===`pseo`&&n===`audit`?`pseo-audit`:t===`tests`&&n===`report`?`measure-change`:Mm[t]??(Nm.has(t)?t:void 0)}const $=process.argv.slice(2),Im={agent:pr()},Lm=$[0]===`telemetry`,Rm=$[0]===`mcp`&&$[1]===`serve`;!Lm&&!Rm&&tn(Im);const zm=await Em(Dm,{argv:$});zm!==void 0&&process.exit(zm),($.length===0||$.length===1&&[`help`,`--help`,`-h`].includes($[0]??``))&&(Am(Om),process.exit(0)),$[0]===`help`&&$[1]===`all`&&(Am(km),process.exit(0));const Bm=$[0]===`help`&&$.length>1?[...$.slice(1),`--help`]:$;Bm!==$&&(process.argv=[process.argv[0]??`node`,process.argv[1]??`seo`,...Bm]);const Vm=Bm.some(e=>[`--help`,`-h`].includes(e)),Hm=$.length===1&&[`--version`,`-v`].includes($[0]??``),Um=Vm||Hm?void 0:Fm(Bm);if(Vm||Hm)await wi(jm);else{Um&&vr(Um,Im);try{await Ci(jm,{rawArgs:Bm}),Um&&on(Um,Im),[`init`,`setup`,`start`].includes(Bm[0]??``)&&!Bm.includes(`--dry-run`)&&Ar(Im)}catch(e){if(Um)jt(Um,e,Im);else if(!Lm){let t=hm(Bm);t&&un(t,e,Im)}let t=mr(e);if($.includes(`--json`))process.stdout.write(`${JSON.stringify(Dn(t),null,2)}\n`);else{process.stderr.write(`Error: ${t.message}\n`);let n=_m({args:Bm,error:e,report:Um});n&&process.stderr.write(`Report this bug: ${n}\n`)}process.exitCode=t.exitCode}}export{};
+`),Mo(`More help`,"Use `seo help <command>` or `seo <command> --help` for command help.","Use `seo help all` for the longer command list.")}const Nm=T({meta:{name:`seo`,version:km.version,description:`Local-first SEO CLI and MCP server`},subCommands:{init:Ou,indexnow:Du,analytics:ds,llms:Nu,auth:vs,mcp:Lu,okf:td,doctor:bd,privacy:op,telemetry:mp,reset:sp,cache:xs,logs:Pu,crawl:al,"crawl-queue":hp,"crawl-reports":bl,client:Gc,content:qc,project:Kc,projects:Kc,providers:Zd,"change-log":Ml,tests:Wl,"content-groups":Fl,"crawl-diff":Ru,diagnose:yd,"diagnose-property":am,export:Cu,"index-coverage":Yu,"index-watch":Xu,"link-recover":Zu,links:ku,"monthly-report":yf,monitoring:Ju,"report-narrative":bf,rules:xf,explain:Sf,"refresh-priorities":sm,"redirect-trace":Qu,schedule:Tf,"server-logs":Ef,skill:ap,start:xc,setup:bc,report:om,reports:ff,"segment-impact":Sd,"striking-distance":wd,"technical-watch":cm,"update-postmortem":mm,sites:cp,"gsc-query":xl,"url-inspect":Sl,updates:lp,"traffic-anomaly":El,"update-correlate":Dl,"ai-referrals":nd,"agent-readiness":Ko,"ai-readiness":Uo,"entity-readiness":kl,"audit-page":md,"second-page":fd,cannibal:rd,"community-intent":id,decaying:sd,"quick-wins":dd,"page-opportunities":ld,perf:vd,"internal-links":cd,"ctr-underperformers":ad,"query-cluster":ud,"seo-to-ai-query":pd,pseo:of},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")}}),Pm={cannibal:`cannibalisation`,crawl:`site-crawl`,"crawl-queue":`top-fixes`,decaying:`decaying-pages`,"diagnose-property":`search-performance-overview`,doctor:`setup-check`,explain:`explain-crawl-issue`,"link-recover":`link-recovery`,"monthly-report":`monthly-report`,"query-cluster":`query-clusters`,report:`search-performance-overview`,"report-narrative":`narrative-report`,rules:`crawler-rules`,"update-correlate":`update-correlation`},Fm=new Set([`agent-readiness`,`ai-readiness`,`ai-referrals`,`audit-page`,`community-intent`,`crawl-diff`,`ctr-underperformers`,`entity-readiness`,`index-coverage`,`index-watch`,`internal-links`,`link-evidence`,`page-opportunities`,`quick-wins`,`redirect-trace`,`refresh-priorities`,`second-page`,`segment-impact`,`seo-to-ai-query`,`striking-distance`,`technical-watch`,`traffic-anomaly`,`update-postmortem`]),Im=new Set(rr().map(e=>e.id));function Lm(e){let[t,n,r]=e;if(t)return t===`reports`&&n===`run`?r&&Im.has(r)?r:void 0:t===`content`&&n===`optimize`?`content-optimization`:t===`change-log`&&n===`measure`?`measure-change`:t===`llms`&&n===`audit`?`llms-txt-audit`:t===`links`?`link-evidence`:t===`llms`&&n===`generate`?`generate-llms-txt`:t===`okf`&&n===`export`?`okf-build`:t===`okf`&&n===`validate`?`okf-validate`:t===`monitoring`&&n===`run`?`technical-watch`:t===`perf`&&n===`audit`?`performance-audit`:t===`pseo`&&n===`audit`?`pseo-audit`:t===`tests`&&n===`report`?`measure-change`:Pm[t]??(Fm.has(t)?t:void 0)}const $=process.argv.slice(2),Rm={agent:pr()},zm=$[0]===`telemetry`,Bm=$[0]===`mcp`&&$[1]===`serve`;!zm&&!Bm&&tn(Rm);const Vm=await Om(km,{argv:$});Vm!==void 0&&process.exit(Vm),($.length===0||$.length===1&&[`help`,`--help`,`-h`].includes($[0]??``))&&(Mm(Am),process.exit(0)),$[0]===`help`&&$[1]===`all`&&(Mm(jm),process.exit(0));const Hm=$[0]===`help`&&$.length>1?[...$.slice(1),`--help`]:$;Hm!==$&&(process.argv=[process.argv[0]??`node`,process.argv[1]??`seo`,...Hm]);const Um=Hm.some(e=>[`--help`,`-h`].includes(e)),Wm=$.length===1&&[`--version`,`-v`].includes($[0]??``),Gm=Um||Wm?void 0:Lm(Hm);if(Um||Wm)await wi(Nm);else{Gm&&vr(Gm,Rm);try{await Ci(Nm,{rawArgs:Hm}),Gm&&on(Gm,Rm),[`init`,`setup`,`start`].includes(Hm[0]??``)&&!Hm.includes(`--dry-run`)&&Ar(Rm)}catch(e){if(Gm)jt(Gm,e,Rm);else if(!zm){let t=_m(Hm);t&&un(t,e,Rm)}let t=mr(e);if($.includes(`--json`))process.stdout.write(`${JSON.stringify(Dn(t),null,2)}\n`);else{process.stderr.write(`Error: ${t.message}\n`);let n=ym({args:Hm,error:e,report:Gm});n&&process.stderr.write(`Report this bug: ${n}\n`)}process.exitCode=t.exitCode}}export{};
 //# sourceMappingURL=cli.js.map