@ainyc/canonry 4.186.9 → 4.188.0

package/dist/{chunk-U3M2VALC.js → chunk-QPYMAXLJ.js}

@@ -88,6 +88,7 @@ import {
   queryTrackingPreviewRequestSchema,
   reportPeriodSchema,
   researchRunCreateSchema,
+  resultsClearRequestSchema,
   runTriggerRequestSchema,
   schedulableRunKindSchema,
   scheduleUpsertRequestSchema,
@@ -98,7 +99,7 @@ import {
   trafficEventKindSchema,
   trafficSeriesGranularitySchema,
   visibilityReportRequestSchema
-} from "./chunk-LNBX7RTN.js";
+} from "./chunk-HIIOVQSH.js";
 
 // src/cli-error.ts
 function isMachineFormat(format) {
@@ -172,6 +173,7 @@ import { z } from "zod";
 var dashboardManagedSweepsSchema = z.boolean().nullish();
 var researchAllowViewersSchema = z.boolean().nullish();
 var researchViewerDailyRunLimitSchema = z.number().int().positive().nullish();
+var dashboardManagedRunKindsSchema = z.array(schedulableRunKindSchema).nullish();
 var envSchema = z.object({
   DATABASE_URL: z.string().default("postgresql://aeo:aeo@postgres:5432/aeo_platform"),
   API_PORT: z.coerce.number().int().positive().default(3e3),
@@ -407,6 +409,12 @@ Do not use "canonry init --force" for recovery. It replaces credentials without
       message: `Invalid config at ${configPath}: research.allowViewers must be true, false, or left blank.`
     });
   }
+  if (!dashboardManagedRunKindsSchema.safeParse(parsed.dashboard?.managedRunKinds).success) {
+    throw new CliError({
+      code: "CONFIG_INVALID",
+      message: `Invalid config at ${configPath}: dashboard.managedRunKinds must be a list of schedulable run kinds.`
+    });
+  }
   if (!researchViewerDailyRunLimitSchema.safeParse(parsed.research?.viewerDailyRunLimit).success) {
     throw new CliError({
       code: "CONFIG_INVALID",
@@ -2335,6 +2343,22 @@ var postApiV1ProjectsByNameQueryTrackingCommit = (options) => {
     }
   });
 };
+var postApiV1ProjectsByNameResultsClear = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/results/clear",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
 var getApiV1ProjectsByNameResearchRunsByRunId = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -8021,6 +8045,14 @@ var ApiClient = class {
     );
   }
   // ── Research query runs ────────────────────────────────────────────────
+  /** Preview or clear exact saved visibility/research run IDs. */
+  async clearResults(project, request) {
+    return this.invoke(() => postApiV1ProjectsByNameResultsClear({
+      client: this.heyClient,
+      path: { name: project },
+      body: request
+    }));
+  }
   /**
    * Start one saved research batch. Research results are deliberately kept
    * outside the tracked-query basket and visibility-run history.
@@ -9859,6 +9891,17 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/export"],
     handler: (client2, input) => client2.getExport(input.project)
   }),
+  defineTool({
+    name: "canonry_results_clear",
+    title: "Preview or clear saved results",
+    description: "Clear only explicitly selected visibility runs and research batches. Preview is the default; back up evidence and set confirm=true to delete. Refuses active work and other run kinds. Preserves queries, plans, schedules, Site Health, backlinks, usage, and the audit trail.",
+    access: "write",
+    tier: "monitoring",
+    inputSchema: resultsClearRequestSchema.safeExtend({ project: projectNameSchema }),
+    annotations: writeAnnotations({ idempotentHint: false, destructiveHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/results/clear"],
+    handler: (client2, input) => client2.clearResults(input.project, { runIds: input.runIds, researchRunIds: input.researchRunIds, confirm: input.confirm })
+  }),
   defineTool({
     name: "canonry_project_history",
     title: "Get project history",
@@ -13021,6 +13064,7 @@ function parseSkillsClient(value) {
 }
 
 export {
+  dashboardManagedRunKindsSchema,
   getBootstrapEnv,
   isMachineFormat,
   EXIT_USER_ERROR,

package/dist/cli.js

@@ -28,11 +28,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-O26JKJXV.js";
+} from "./chunk-6YJQGOR6.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-XD2ZD2BP.js";
+} from "./chunk-A47HAZDJ.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -58,7 +58,7 @@ import {
   saveConfigPatch,
   systemError,
   usageError
-} from "./chunk-U3M2VALC.js";
+} from "./chunk-QPYMAXLJ.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -72,7 +72,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-EMSDPSQM.js";
+} from "./chunk-GPTEXYYL.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -141,11 +141,12 @@ import {
   queryTrackingCommitRequestSchema,
   queryTrackingPreviewRequestSchema,
   resolveProviderInput,
+  resultsClearRequestSchema,
   shareOfVoiceLabel,
   shareOfVoiceReason,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-LNBX7RTN.js";
+} from "./chunk-HIIOVQSH.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -11428,6 +11429,18 @@ async function showHistory(project, format, opts = {}) {
     });
   }
 }
+async function clearResults(project, opts) {
+  const request = resultsClearRequestSchema.safeParse({ runIds: opts.runIds, researchRunIds: opts.researchRunIds, confirm: opts.confirm });
+  if (!request.success) throw new CliError({ code: "INVALID_ARGUMENT", message: request.error.issues.map((issue) => issue.message).join(" "), exitCode: 1 });
+  const result = await getClient20().clearResults(project, request.data);
+  if (opts.format === "jsonl") emitJsonl([result]);
+  else if (opts.format === "json") console.log(JSON.stringify(result, null, 2));
+  else {
+    console.log(`${result.dryRun ? "Would clear" : "Cleared"} ${result.runIds.length} visibility runs and ${result.researchRunIds.length} research batches.`);
+    console.log(`${result.querySnapshots} saved visibility answers; ${result.researchQueries} research queries.`);
+    if (result.dryRun) console.log("Back up the evidence, then repeat with --confirm to delete these exact runs.");
+  }
+}
 
 // src/commands/status.ts
 function getClient21() {
@@ -11499,7 +11512,21 @@ function parseResultsExportFormat(value) {
 
 Usage: ${RESULTS_EXPORT_USAGE}`);
 }
+var RESULTS_CLEAR_USAGE = "canonry results clear <project> [--run <id> ...] [--research-run <id> ...] [--confirm] [--format json|jsonl]";
 var OPERATOR_CLI_COMMANDS = [
+  {
+    path: ["results", "clear"],
+    usage: RESULTS_CLEAR_USAGE,
+    options: { run: multiStringOption(), "research-run": multiStringOption(), confirm: { type: "boolean", default: false } },
+    run: async (input) => {
+      await clearResults(requireProject(input, "results.clear", RESULTS_CLEAR_USAGE), {
+        runIds: getStringArray(input.values, "run") ?? [],
+        researchRunIds: getStringArray(input.values, "research-run") ?? [],
+        confirm: getBoolean(input.values, "confirm"),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["results", "export"],
     usage: RESULTS_EXPORT_USAGE,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { FastifyInstance } from 'fastify';
 import { DatabaseClient } from '@ainyc/canonry-db';
-import { ProviderQuotaPolicy, EmbedConfigEntry, AgentPluginState, GoogleAdsCampaignMetricsQuery, GoogleAdsRawSnapshotDto, GoogleAdsEffectiveGoalGraphDto, GoogleMarketingProvider, GoogleAdsAccessibleCustomersResponse, GoogleAdsAccessibleCustomerDto, GtmAccountsResponse, GtmContainerListResponse, GtmWorkspaceListResponse, GtmRawSnapshotDto } from '@ainyc/canonry-contracts';
+import { ProviderQuotaPolicy, SchedulableRunKind, EmbedConfigEntry, AgentPluginState, GoogleAdsCampaignMetricsQuery, GoogleAdsRawSnapshotDto, GoogleAdsEffectiveGoalGraphDto, GoogleMarketingProvider, GoogleAdsAccessibleCustomersResponse, GoogleAdsAccessibleCustomerDto, GtmAccountsResponse, GtmContainerListResponse, GtmWorkspaceListResponse, GtmRawSnapshotDto } from '@ainyc/canonry-contracts';
 import { GoogleTokenResponse } from '@ainyc/canonry-integration-google';
 
 type GoogleConnectionType = 'gsc' | 'ga4' | 'gbp';
@@ -306,8 +306,10 @@ interface DashboardConfigEntry {
      * or CLI update notice.
      */
     showUpdateNotification?: boolean;
-    /** Hide dashboard sweep controls; operators can still use `canonry run`. Defaults to false. */
+    /** Legacy alias for managedRunKinds: ['answer-visibility']. */
     managedSweeps?: boolean | null;
+    /** Presentation only. Managed sweeps hide all launches; managed scans hide viewer launches. */
+    managedRunKinds?: SchedulableRunKind[] | null;
 }
 interface ResearchConfigEntry {
     /** Allow signed-in viewers to run paid research queries. Defaults to false. */

package/dist/index.js

@@ -3,12 +3,12 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-O26JKJXV.js";
+} from "./chunk-6YJQGOR6.js";
 import {
   loadConfig
-} from "./chunk-U3M2VALC.js";
-import "./chunk-EMSDPSQM.js";
-import "./chunk-LNBX7RTN.js";
+} from "./chunk-QPYMAXLJ.js";
+import "./chunk-GPTEXYYL.js";
+import "./chunk-HIIOVQSH.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-UZGA24EF.js → intelligence-service-4KMWHEYP.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-EMSDPSQM.js";
-import "./chunk-LNBX7RTN.js";
+} from "./chunk-GPTEXYYL.js";
+import "./chunk-HIIOVQSH.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -1,13 +1,13 @@
 import {
   autoSyncSkills
-} from "./chunk-XD2ZD2BP.js";
+} from "./chunk-A47HAZDJ.js";
 import {
   createApiClient,
   createCanonryMcpServer
-} from "./chunk-U3M2VALC.js";
+} from "./chunk-QPYMAXLJ.js";
 import {
   isReadOnlyKey
-} from "./chunk-LNBX7RTN.js";
+} from "./chunk-HIIOVQSH.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.186.9",
+  "version": "4.188.0",
   "type": "module",
   "description": "Self-hosted AI visibility (AEO) platform: track how ChatGPT, Claude, Gemini, and Perplexity cite your domain, join it with Search Console, GA4, server-side traffic, and paid media, and fix what you find through agent tools (CLI, REST, MCP). Local SQLite.",
   "license": "FSL-1.1-ALv2",
@@ -70,32 +70,32 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-web": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
+    "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
-    "@ainyc/canonry-integration-cloudflare-queue": "0.0.0",
-    "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
     "@ainyc/canonry-integration-google-ads": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-cloudflare-queue": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
-    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
+    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0"
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0"
   },
   "scripts": {
     "build": "pnpm run build:cli && pnpm run build:web",