@canonry/canonry 7.32.0 → 7.44.0

package/dist/chunk-3JVF3ULD.js

@@ -0,0 +1,550 @@
+import {
+  usageError
+} from "./chunk-HGMYEDAQ.js";
+import {
+  AppError,
+  parseWindowIn,
+  resolveDateRange
+} from "./chunk-GZ2KIONF.js";
+
+// src/cli-access.ts
+var CLI_ACCESS_BY_ID = Object.freeze({
+  "ads.account": "live",
+  "ads.activation-grant.create": "write",
+  "ads.activation-grant.revoke": "write",
+  "ads.ad-group.create": "write",
+  "ads.ad-group.pause": "write",
+  "ads.ad-group.update": "write",
+  "ads.ad.create": "write",
+  "ads.ad.pause": "write",
+  "ads.ad.update": "write",
+  "ads.campaign.activate-tree": "write",
+  "ads.campaign.create": "write",
+  "ads.campaign.pause": "write",
+  "ads.campaign.update": "write",
+  "ads.campaigns": "stored",
+  "ads.connect": "write",
+  "ads.conversions.event-settings": "live",
+  "ads.conversions.pixels": "live",
+  "ads.delivery-diagnostics": "stored",
+  "ads.disconnect": "write",
+  "ads.geo.search": "live",
+  "ads.image.upload": "write",
+  "ads.insights": "stored",
+  "ads.live-delivery": "live",
+  "ads.operation": "stored",
+  "ads.operation.reconcile": "write",
+  "ads.operation.resume-activation": "write",
+  "ads.operations.unresolved": "stored",
+  "ads.status": "stored",
+  "ads.summary": "stored",
+  "ads.sync": "write",
+  "agent.ask": "write",
+  "agent.conversations.list": "stored",
+  "agent.conversations.new": "write",
+  "agent.conversations.show": "stored",
+  "agent.conversations.resume": "write",
+  "agent.conversations.delete": "write",
+  "query.workspace": "stored",
+  "query.preview": "stored",
+  "query.commit": "write",
+  "agent.attach": "write",
+  "agent.clear": "write",
+  "agent.detach": "write",
+  "agent.memory.forget": "write",
+  "agent.memory.list": "stored",
+  "agent.memory.set": "write",
+  "agent.providers": "stored",
+  "agent.reset": "write",
+  "agent.transcript": "stored",
+  "analytics": "stored",
+  "apply": "write",
+  "backfill": "write",
+  "backfill.ai-referral-paths": "write",
+  "backfill.answer-mentions": "write",
+  "backfill.answer-visibility": "write",
+  "backfill.insights": "write",
+  "backfill.normalized-paths": "write",
+  "backfill.snapshot-attribution": "write",
+  "backfill.traffic-classification": "write",
+  "backlinks.cache.prune": "write",
+  "backlinks.doctor": "live",
+  "backlinks.extract": "live",
+  "backlinks.install": "write",
+  "backlinks.list": "stored",
+  "backlinks.releases": "stored",
+  "backlinks.releases.latest": "live",
+  "backlinks.sources": "stored",
+  "backlinks.status": "stored",
+  "backlinks.sync": "write",
+  "bing": "write",
+  "bing.connect": "write",
+  "bing.coverage": "write",
+  "bing.coverage-history": "stored",
+  "bing.disconnect": "write",
+  "bing.inspect": "write",
+  "bing.inspect-sitemap": "write",
+  "bing.inspections": "stored",
+  "bing.performance": "live",
+  "bing.refresh": "write",
+  "bing.request-indexing": "write",
+  "bing.set-site": "write",
+  "bing.sites": "live",
+  "bing.status": "stored",
+  "bootstrap": "write",
+  "cdp": "stored",
+  "cdp.connect": "write",
+  "cdp.screenshot": "live",
+  "cdp.status": "live",
+  "cdp.targets": "live",
+  "citations.visibility": "stored",
+  "competitor": "write",
+  "competitor.add": "write",
+  "competitor.aliases": "stored",
+  "competitor.aliases.detect": "stored",
+  "competitor.delete": "write",
+  "competitor.import": "write",
+  "competitor.landscape": "stored",
+  "competitor.list": "stored",
+  "competitor.remove": "write",
+  "competitor.suggest": "stored",
+  "content.brief": "write",
+  "content.dismiss": "write",
+  "content.dismissals": "stored",
+  "content.gaps": "stored",
+  "content.map": "stored",
+  "content.restore": "write",
+  "content.sources": "stored",
+  "content.targets": "stored",
+  "conversion-tracking.contracts": "stored",
+  "conversion-tracking.contracts.create": "write",
+  "conversion-tracking.contracts.delete": "write",
+  "conversion-tracking.contracts.get": "stored",
+  "conversion-tracking.contracts.integrity": "stored",
+  "conversion-tracking.contracts.update": "write",
+  "dashboard": "write",
+  "dashboard.reset-password": "write",
+  "demo": "write",
+  "discover.eval": "write",
+  "discover.harvest": "live",
+  "discover.list": "stored",
+  "discover.probe": "stored",
+  "discover.promote": "write",
+  "discover.promote.preview": "stored",
+  "discover.run": "write",
+  "discover.seed": "write",
+  "discover.show": "stored",
+  "doctor": "live",
+  "evidence": "stored",
+  "export": "stored",
+  "feedback": "write",
+  "ga": "write",
+  "ga.acquisition": "stored",
+  "ga.ai-referral-daily": "stored",
+  "ga.ai-referral-history": "stored",
+  "ga.attribution": "stored",
+  "ga.connect": "write",
+  "ga.coverage": "stored",
+  "ga.disconnect": "write",
+  "ga.measurement-analysis": "stored",
+  "ga.properties": "live",
+  "ga.search-landing-pages": "stored",
+  "ga.session-history": "stored",
+  "ga.social-referral-history": "stored",
+  "ga.social-referral-summary": "stored",
+  "ga.status": "stored",
+  "ga.sync": "write",
+  "ga.traffic": "stored",
+  "gbp.accounts": "live",
+  "gbp.attributes": "stored",
+  "gbp.connect": "write",
+  "gbp.disconnect": "write",
+  "gbp.keywords": "stored",
+  "gbp.locations": "stored",
+  "gbp.locations.deselect": "write",
+  "gbp.locations.discover": "write",
+  "gbp.locations.select": "write",
+  "gbp.lodging": "stored",
+  "gbp.metrics": "stored",
+  "gbp.place-actions": "stored",
+  "gbp.places": "stored",
+  "gbp.reviews": "stored",
+  "gbp.summary": "stored",
+  "gbp.sync": "write",
+  "get": "stored",
+  "google": "write",
+  "google-ads.customers": "live",
+  "google-ads.disconnect": "write",
+  "google-ads.performance": "stored",
+  "google-ads.select": "write",
+  "google-ads.snapshot": "stored",
+  "google-ads.snapshots": "stored",
+  "google-ads.status": "stored",
+  "google-ads.sync": "write",
+  "google.connect": "write",
+  "google.coverage": "stored",
+  "google.coverage-history": "stored",
+  "google.deindexed": "stored",
+  "google.disconnect": "write",
+  "google.discover-sitemaps": "live",
+  "google.inspect": "write",
+  "google.inspect-sitemap": "write",
+  "google.inspections": "stored",
+  "google.list-sitemaps": "live",
+  "google.performance": "stored",
+  "google.performance-daily": "stored",
+  "google.properties": "live",
+  "google.query-totals": "stored",
+  "google.refresh": "write",
+  "google.request-indexing": "write",
+  "google.set-property": "write",
+  "google.set-sitemap": "write",
+  "google.status": "stored",
+  "google.submit-sitemap": "write",
+  "google.sync": "write",
+  "google.top-pages": "stored",
+  "gtm.accounts": "live",
+  "gtm.containers": "live",
+  "gtm.disconnect": "write",
+  "gtm.select": "write",
+  "gtm.snapshot": "stored",
+  "gtm.snapshots": "stored",
+  "gtm.status": "stored",
+  "gtm.sync": "write",
+  "gtm.workspaces": "live",
+  "health": "stored",
+  "help": "stored",
+  "history": "stored",
+  "init": "write",
+  "insights": "stored",
+  "insights.dismiss": "write",
+  "key": "stored",
+  "key.create": "write",
+  "key.list": "stored",
+  "key.revoke": "write",
+  "key.whoami": "stored",
+  "keyword": "stored",
+  "keyword.add": "write",
+  "keyword.delete": "write",
+  "keyword.generate": "write",
+  "keyword.import": "write",
+  "keyword.list": "stored",
+  "keyword.remove": "write",
+  "keyword.replace": "write",
+  "logs": "stored",
+  "mcp": "write",
+  "mcp.config": "write",
+  "mcp.install": "write",
+  "measurement-plan.advanced": "write",
+  "measurement-plan.assignments.apply": "write",
+  "measurement-plan.assignments.preview": "stored",
+  "measurement-plan.assignments.replace": "write",
+  "measurement-plan.discover": "live",
+  "measurement-plan.groups.apply": "write",
+  "measurement-plan.groups.preview": "stored",
+  "measurement-plan.property": "stored",
+  "measurement-plan.property-evidence": "stored",
+  "measurement-plan.publish": "write",
+  "measurement-plan.report": "stored",
+  "measurement-plan.retire": "write",
+  "measurement-plan.show": "stored",
+  "measurement-plan.versions": "stored",
+  "measurement-plan.visibility": "stored",
+  "notify": "write",
+  "notify.add": "write",
+  "notify.events": "stored",
+  "notify.list": "stored",
+  "notify.remove": "write",
+  "notify.test": "write",
+  "organic-evidence": "stored",
+  "overview": "stored",
+  "project": "write",
+  "project.add-location": "write",
+  "project.create": "write",
+  "project.delete": "write",
+  "project.list": "stored",
+  "project.locations": "stored",
+  "project.remove-location": "write",
+  "project.set-default-location": "write",
+  "project.show": "stored",
+  "project.update": "write",
+  "query": "write",
+  "query.add": "write",
+  "query.delete": "write",
+  "query.generate": "write",
+  "query.import": "write",
+  "query.list": "stored",
+  "query.remove": "write",
+  "query.replace": "write",
+  "research.batch": "write",
+  "research.list": "stored",
+  "research.run": "write",
+  "research.show": "stored",
+  "results.clear": "write",
+  "results.export": "stored",
+  "run": "write",
+  "run.cancel": "write",
+  "run.completeness": "stored",
+  "run.fill": "write",
+  "run.list": "stored",
+  "run.show": "stored",
+  "run.trigger": "write",
+  "runs": "stored",
+  "schedule": "write",
+  "schedule.disable": "write",
+  "schedule.enable": "write",
+  "schedule.list": "stored",
+  "schedule.remove": "write",
+  "schedule.set": "write",
+  "schedule.show": "stored",
+  "search": "stored",
+  "site-health.overview": "stored",
+  "site-health.issues": "stored",
+  "site-health.issue-pages": "stored",
+  "site-health.pages": "stored",
+  "site-health.page-audit": "stored",
+  "site-health.structure": "stored",
+  "site-health.links": "stored",
+  "site-health.neighbors": "stored",
+  "site-health.dead-links": "stored",
+  "site-health.subgraph": "stored",
+  "site-health.path": "stored",
+  "site-health.changes": "stored",
+  "sentiment": "stored",
+  "sentiment.backfill": "write",
+  "sentiment.compare": "stored",
+  "sentiment.configure": "write",
+  "sentiment.evidence": "stored",
+  "sentiment.job": "stored",
+  "sentiment.jobs": "stored",
+  "sentiment.settings": "stored",
+  "serve": "write",
+  "settings": "stored",
+  "settings.google": "write",
+  "settings.provider": "write",
+  "settings.reload-providers": "write",
+  "skills": "write",
+  "skills.install": "write",
+  "skills.list": "stored",
+  "snapshot": "write",
+  "sources": "stored",
+  "start": "write",
+  "status": "stored",
+  "stop": "write",
+  "support": "stored",
+  "technical-aeo.changes": "stored",
+  "technical-aeo.issues": "stored",
+  "technical-aeo.issue-pages": "stored",
+  "technical-aeo.crawl": "write",
+  "technical-aeo.crawl-pages": "stored",
+  "technical-aeo.dead-links": "stored",
+  "technical-aeo.links": "stored",
+  "technical-aeo.links.neighbors": "stored",
+  "technical-aeo.page-audit": "stored",
+  "technical-aeo.pages": "stored",
+  "technical-aeo.path": "stored",
+  "technical-aeo.progress": "stored",
+  "technical-aeo.run": "write",
+  "technical-aeo.score": "stored",
+  "technical-aeo.structure": "stored",
+  "technical-aeo.subgraph": "stored",
+  "technical-aeo.trend": "stored",
+  "telemetry": "write",
+  "telemetry.disable": "write",
+  "telemetry.enable": "write",
+  "telemetry.status": "stored",
+  "traffic": "write",
+  "traffic.activate": "write",
+  "traffic.analytics": "stored",
+  "traffic.backfill": "write",
+  "traffic.connect": "write",
+  "traffic.connect.cloud-run": "write",
+  "traffic.connect.cloudflare": "write",
+  "traffic.connect.vercel": "write",
+  "traffic.connect.wordpress": "write",
+  "traffic.events": "stored",
+  "traffic.referral-assessment": "stored",
+  "traffic.reset": "write",
+  "traffic.samples": "stored",
+  "traffic.sources": "stored",
+  "traffic.status": "stored",
+  "traffic.sync": "write",
+  "user": "stored",
+  "user.create": "write",
+  "user.delete": "write",
+  "user.list": "stored",
+  "visibility-compare": "stored",
+  "visibility-stats": "stored",
+  "wordpress": "write",
+  "wordpress.audit": "live",
+  "wordpress.connect": "write",
+  "wordpress.create-page": "write",
+  "wordpress.diff": "live",
+  "wordpress.disconnect": "write",
+  "wordpress.llms-txt": "live",
+  "wordpress.onboard": "write",
+  "wordpress.page": "live",
+  "wordpress.pages": "live",
+  "wordpress.schema": "live",
+  "wordpress.schema.deploy": "write",
+  "wordpress.schema.status": "live",
+  "wordpress.set-llms-txt": "write",
+  "wordpress.set-meta": "write",
+  "wordpress.set-schema": "write",
+  "wordpress.staging": "stored",
+  "wordpress.staging.push": "write",
+  "wordpress.staging.status": "live",
+  "wordpress.status": "live",
+  "wordpress.update-page": "write"
+});
+function resolveCliAccess(spec) {
+  const id = spec.path.join(".");
+  if (spec.access) return spec.access;
+  const access = CLI_ACCESS_BY_ID[id];
+  if (!access) throw new Error(`Missing CLI operation access classification: ${id}`);
+  return access;
+}
+function resolveCliAccessForInvocation(spec, input) {
+  return spec.accessFor?.(input) ?? resolveCliAccess(spec);
+}
+
+// src/cli-output.ts
+function emitJsonl(records) {
+  let out = "";
+  for (const record of records) {
+    out += `${JSON.stringify(record)}
+`;
+  }
+  if (out) process.stdout.write(out);
+}
+
+// src/cli-command-helpers.ts
+function getString(values, key) {
+  const value = values[key];
+  return typeof value === "string" ? value : void 0;
+}
+function getBoolean(values, key) {
+  return values[key] === true;
+}
+function getStringArray(values, key) {
+  const value = values[key];
+  if (Array.isArray(value)) {
+    return value.filter((entry) => typeof entry === "string");
+  }
+  return void 0;
+}
+function requirePositional(input, index, config) {
+  const value = input.positionals[index];
+  if (value) return value;
+  throw usageError(`Error: ${config.message}
+Usage: ${config.usage}`, {
+    message: config.message,
+    details: {
+      command: config.command,
+      usage: config.usage
+    }
+  });
+}
+function requireProject(input, command, usage, message = "project name is required") {
+  return requirePositional(input, 0, { command, usage, message });
+}
+function stringOption() {
+  return { type: "string" };
+}
+function multiStringOption() {
+  return { type: "string", multiple: true };
+}
+function requireStringOption(input, key, config) {
+  const value = getString(input.values, key);
+  if (value) return value;
+  throw usageError(`Error: ${config.message}
+Usage: ${config.usage}`, {
+    message: config.message,
+    details: {
+      command: config.command,
+      usage: config.usage,
+      ...config.details ?? {}
+    }
+  });
+}
+function parseIntegerOption(input, key, config) {
+  const value = getString(input.values, key);
+  if (!value) return void 0;
+  const parsed = Number.parseInt(value, 10);
+  if (!Number.isNaN(parsed)) {
+    return parsed;
+  }
+  throw usageError(`Error: ${config.message}
+Usage: ${config.usage}`, {
+    message: config.message,
+    details: {
+      command: config.command,
+      usage: config.usage,
+      option: key,
+      value
+    }
+  });
+}
+function unknownSubcommand(subcommand, config) {
+  const resolved = subcommand ?? "(none)";
+  throw usageError(`Error: unknown ${config.command} subcommand: ${resolved}
+Usage: ${config.usage}`, {
+    message: `unknown ${config.command} subcommand: ${resolved}`,
+    details: {
+      command: config.command,
+      usage: config.usage,
+      available: config.available
+    }
+  });
+}
+function windowOptions(config = {}) {
+  const options = {};
+  if (config.window) options.window = stringOption();
+  if (config.dates) {
+    options.start = stringOption();
+    options.end = stringOption();
+  }
+  for (const alias of [config.aliases?.window, config.aliases?.start, config.aliases?.end]) {
+    if (alias !== void 0) options[alias] = stringOption();
+  }
+  return options;
+}
+function readWindowOptions(input, config) {
+  const read = (canonical) => {
+    const direct = getString(input.values, canonical);
+    const alias = config.aliases?.[canonical];
+    const old = alias ? getString(input.values, alias) : void 0;
+    if (direct !== void 0 && old !== void 0) throw usageError(`Use either --${canonical} or --${alias}, not both.`, { details: { command: config.command, usage: config.usage } });
+    return direct ?? old;
+  };
+  const rawWindow = read("window");
+  try {
+    const window = rawWindow === void 0 || rawWindow === "" ? void 0 : parseWindowIn(rawWindow, config.allowed ?? [], { fallback: config.allowed?.[0] ?? "", field: "window" });
+    const startDate = read("start");
+    const endDate = read("end");
+    if (rawWindow !== void 0 && (startDate !== void 0 || endDate !== void 0)) throw usageError("Use --window or --start/--end, not both.");
+    const dates = resolveDateRange({ startDate, endDate });
+    return { window, startDate: dates.startDate ?? void 0, endDate: dates.endDate ?? void 0 };
+  } catch (error) {
+    if (error instanceof AppError) throw usageError(error.message, { details: error.details });
+    throw error;
+  }
+}
+
+export {
+  getString,
+  getBoolean,
+  getStringArray,
+  requirePositional,
+  requireProject,
+  stringOption,
+  multiStringOption,
+  requireStringOption,
+  parseIntegerOption,
+  unknownSubcommand,
+  windowOptions,
+  readWindowOptions,
+  resolveCliAccess,
+  resolveCliAccessForInvocation,
+  emitJsonl
+};