@ainyc/canonry 1.7.0 → 1.8.0

package/dist/cli.js

@@ -4,6 +4,7 @@ import {
   configExists,
   createClient,
   createServer,
+  effectiveDomains,
   getConfigDir,
   getConfigPath,
   getOrCreateAnonymousId,
@@ -11,11 +12,12 @@ import {
   isTelemetryEnabled,
   loadConfig,
   migrate,
+  notificationEventSchema,
   providerQuotaPolicySchema,
   saveConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-2QG7TZ4A.js";
+} from "./chunk-3FHF3YVA.js";
 
 // src/cli.ts
 import { parseArgs } from "util";
@@ -316,6 +318,107 @@ Canonry server running at http://${host === "0.0.0.0" ? "localhost" : host}:${po
   }
 }
 
+// src/commands/daemon.ts
+import { spawn } from "child_process";
+import fs2 from "fs";
+import path3 from "path";
+function getPidPath() {
+  return path3.join(getConfigDir(), "canonry.pid");
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    if (err.code === "EPERM") return true;
+    return false;
+  }
+}
+async function waitForReady(host, port, maxMs = 1e4) {
+  const url = `http://${host === "0.0.0.0" ? "127.0.0.1" : host}:${port}/health`;
+  const deadline = Date.now() + maxMs;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch(url);
+      if (res.ok) return true;
+    } catch {
+    }
+    await new Promise((r) => setTimeout(r, 200));
+  }
+  return false;
+}
+async function startDaemon(opts) {
+  const pidPath = getPidPath();
+  if (fs2.existsSync(pidPath)) {
+    const existingPid = parseInt(fs2.readFileSync(pidPath, "utf-8").trim(), 10);
+    if (!isNaN(existingPid) && isProcessAlive(existingPid)) {
+      console.error(`Canonry is already running (PID: ${existingPid})`);
+      process.exit(1);
+    }
+    fs2.unlinkSync(pidPath);
+  }
+  const cliPath = path3.resolve(new URL(import.meta.url).pathname);
+  const inSourceMode = new URL(import.meta.url).pathname.endsWith(".ts");
+  const args = inSourceMode ? ["--import", "tsx", cliPath, "serve"] : [cliPath, "serve"];
+  if (opts.port) args.push("--port", opts.port);
+  if (opts.host) args.push("--host", opts.host);
+  const child = spawn(process.execPath, args, {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+  if (!child.pid) {
+    console.error("Failed to start Canonry server");
+    process.exit(1);
+  }
+  const configDir = getConfigDir();
+  if (!fs2.existsSync(configDir)) {
+    fs2.mkdirSync(configDir, { recursive: true });
+  }
+  fs2.writeFileSync(pidPath, String(child.pid), "utf-8");
+  const port = opts.port ?? "4100";
+  const host = opts.host ?? "127.0.0.1";
+  process.stderr.write("Waiting for server to start...");
+  const ready = await waitForReady(host, port);
+  if (!ready) {
+    try {
+      fs2.unlinkSync(pidPath);
+    } catch {
+    }
+    console.error("\nFailed to start: server did not respond within 10s");
+    process.exit(1);
+  }
+  process.stderr.write("\n");
+  console.log(`Canonry started (PID: ${child.pid}), listening on http://${host === "0.0.0.0" ? "localhost" : host}:${port}`);
+}
+function stopDaemon() {
+  const pidPath = getPidPath();
+  if (!fs2.existsSync(pidPath)) {
+    console.log("Canonry is not running (no PID file found)");
+    return;
+  }
+  const pid = parseInt(fs2.readFileSync(pidPath, "utf-8").trim(), 10);
+  if (isNaN(pid)) {
+    console.error("Invalid PID file. Removing it.");
+    fs2.unlinkSync(pidPath);
+    return;
+  }
+  if (!isProcessAlive(pid)) {
+    console.log(`Canonry is not running (stale PID: ${pid}). Cleaning up.`);
+    fs2.unlinkSync(pidPath);
+    return;
+  }
+  try {
+    process.kill(pid, "SIGTERM");
+    fs2.unlinkSync(pidPath);
+    console.log(`Canonry stopped (PID: ${pid})`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`Failed to stop Canonry (PID: ${pid}): ${msg}`);
+    process.exit(1);
+  }
+}
+
 // src/client.ts
 var ApiClient = class {
   baseUrl;
@@ -324,8 +427,8 @@ var ApiClient = class {
     this.baseUrl = baseUrl.replace(/\/$/, "") + "/api/v1";
     this.apiKey = apiKey;
   }
-  async request(method, path3, body) {
-    const url = `${this.baseUrl}${path3}`;
+  async request(method, path4, body) {
+    const url = `${this.baseUrl}${path4}`;
     const headers = {
       "Authorization": `Bearer ${this.apiKey}`,
       "Content-Type": "application/json"
@@ -464,39 +567,56 @@ async function createProject(name, opts) {
   const result = await client.putProject(name, {
     displayName: opts.displayName,
     canonicalDomain: opts.domain,
+    ownedDomains: opts.ownedDomains ?? [],
     country: opts.country,
     language: opts.language
   });
   console.log(`Project created: ${result.name} (${result.id})`);
 }
-async function listProjects() {
+async function listProjects(format) {
   const client = getClient();
   const projects = await client.listProjects();
+  if (format === "json") {
+    console.log(JSON.stringify(projects, null, 2));
+    return;
+  }
   if (projects.length === 0) {
     console.log("No projects found.");
     return;
   }
   console.log("Projects:\n");
   const nameWidth = Math.max(4, ...projects.map((p) => p.name.length));
-  const domainWidth = Math.max(6, ...projects.map((p) => p.canonicalDomain.length));
+  const domainLabel = (p) => {
+    const extra = Math.max(0, effectiveDomains(p).length - 1);
+    return extra > 0 ? `${p.canonicalDomain} (+${extra})` : p.canonicalDomain;
+  };
+  const domainWidth = Math.max(6, ...projects.map((p) => domainLabel(p).length));
   console.log(
     `  ${"NAME".padEnd(nameWidth)}  ${"DOMAIN".padEnd(domainWidth)}  COUNTRY  LANGUAGE`
   );
   console.log(`  ${"\u2500".repeat(nameWidth)}  ${"\u2500".repeat(domainWidth)}  \u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
   for (const p of projects) {
     console.log(
-      `  ${p.name.padEnd(nameWidth)}  ${p.canonicalDomain.padEnd(domainWidth)}  ${p.country.padEnd(7)}  ${p.language}`
+      `  ${p.name.padEnd(nameWidth)}  ${domainLabel(p).padEnd(domainWidth)}  ${p.country.padEnd(7)}  ${p.language}`
     );
   }
 }
-async function showProject(name) {
+async function showProject(name, format) {
   const client = getClient();
   const project = await client.getProject(name);
+  if (format === "json") {
+    console.log(JSON.stringify(project, null, 2));
+    return;
+  }
   console.log(`Project: ${project.displayName}
 `);
   console.log(`  Name:             ${project.name}`);
   console.log(`  ID:               ${project.id}`);
   console.log(`  Domain:           ${project.canonicalDomain}`);
+  const secondaryDomains = effectiveDomains(project).slice(1);
+  if (secondaryDomains.length > 0) {
+    console.log(`  Owned domains:    ${secondaryDomains.join(", ")}`);
+  }
   console.log(`  Country:          ${project.country}`);
   console.log(`  Language:         ${project.language}`);
   console.log(`  Config source:    ${project.configSource}`);
@@ -507,6 +627,27 @@ async function showProject(name) {
   console.log(`  Created:          ${project.createdAt}`);
   console.log(`  Updated:          ${project.updatedAt}`);
 }
+async function updateProjectSettings(name, opts) {
+  const client = getClient();
+  const project = await client.getProject(name);
+  let ownedDomains = opts.ownedDomains ?? project.ownedDomains ?? [];
+  if (opts.addOwnedDomain) {
+    const toAdd = opts.addOwnedDomain.filter((d) => !ownedDomains.includes(d));
+    ownedDomains = [...ownedDomains, ...toAdd];
+  }
+  if (opts.removeOwnedDomain) {
+    const toRemove = new Set(opts.removeOwnedDomain);
+    ownedDomains = ownedDomains.filter((d) => !toRemove.has(d));
+  }
+  const result = await client.putProject(name, {
+    displayName: opts.displayName ?? project.displayName,
+    canonicalDomain: opts.domain ?? project.canonicalDomain,
+    ownedDomains,
+    country: opts.country ?? project.country,
+    language: opts.language ?? project.language
+  });
+  console.log(`Project updated: ${result.name}`);
+}
 async function deleteProject(name) {
   const client = getClient();
   await client.deleteProject(name);
@@ -514,7 +655,7 @@ async function deleteProject(name) {
 }
 
 // src/commands/keyword.ts
-import fs2 from "fs";
+import fs3 from "fs";
 function getClient2() {
   const config = loadConfig();
   return new ApiClient(config.apiUrl, config.apiKey);
@@ -524,9 +665,13 @@ async function addKeywords(project, keywords) {
   await client.appendKeywords(project, keywords);
   console.log(`Added ${keywords.length} key phrase(s) to "${project}".`);
 }
-async function listKeywords(project) {
+async function listKeywords(project, format) {
   const client = getClient2();
   const kws = await client.listKeywords(project);
+  if (format === "json") {
+    console.log(JSON.stringify(kws, null, 2));
+    return;
+  }
   if (kws.length === 0) {
     console.log(`No key phrases found for "${project}".`);
     return;
@@ -538,10 +683,10 @@ async function listKeywords(project) {
   }
 }
 async function importKeywords(project, filePath) {
-  if (!fs2.existsSync(filePath)) {
+  if (!fs3.existsSync(filePath)) {
     throw new Error(`File not found: ${filePath}`);
   }
-  const content = fs2.readFileSync(filePath, "utf-8");
+  const content = fs3.readFileSync(filePath, "utf-8");
   const keywords = content.split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
   if (keywords.length === 0) {
     console.log("No key phrases found in file.");
@@ -582,9 +727,13 @@ async function addCompetitors(project, domains) {
   await client.putCompetitors(project, allDomains);
   console.log(`Added ${domains.length} competitor(s) to "${project}".`);
 }
-async function listCompetitors(project) {
+async function listCompetitors(project, format) {
   const client = getClient3();
   const comps = await client.listCompetitors(project);
+  if (format === "json") {
+    console.log(JSON.stringify(comps, null, 2));
+    return;
+  }
   if (comps.length === 0) {
     console.log(`No competitors found for "${project}".`);
     return;
@@ -601,6 +750,7 @@ function getClient4() {
   const config = loadConfig();
   return new ApiClient(config.apiUrl, config.apiKey);
 }
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "partial", "failed"]);
 async function triggerRun(project, opts) {
   const client = getClient4();
   const body = {};
@@ -608,6 +758,21 @@ async function triggerRun(project, opts) {
     body.providers = [opts.provider];
   }
   const run = await client.triggerRun(project, body);
+  if (opts?.wait) {
+    process.stderr.write(`Run ${run.id} started`);
+    const result = await pollRun(client, run.id);
+    if (opts?.format === "json") {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      process.stderr.write("\n");
+      printRunDetail(result);
+    }
+    return;
+  }
+  if (opts?.format === "json") {
+    console.log(JSON.stringify(run, null, 2));
+    return;
+  }
   console.log(`Run created: ${run.id}`);
   console.log(`  Kind:   ${run.kind}`);
   console.log(`  Status: ${run.status}`);
@@ -615,9 +780,72 @@ async function triggerRun(project, opts) {
     console.log(`  Provider: ${opts.provider}`);
   }
 }
-async function listRuns(project) {
+async function triggerRunAll(opts) {
+  const client = getClient4();
+  const projects = await client.listProjects();
+  if (projects.length === 0) {
+    if (opts?.format === "json") {
+      console.log("[]");
+    } else {
+      console.log("No projects found.");
+    }
+    return;
+  }
+  const body = {};
+  if (opts?.provider) {
+    body.providers = [opts.provider];
+  }
+  const results = [];
+  for (const p of projects) {
+    try {
+      const run = await client.triggerRun(p.name, body);
+      results.push({ project: p.name, runId: run.id, status: run.status });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      results.push({ project: p.name, runId: "", status: "error", error: msg });
+    }
+  }
+  if (opts?.wait) {
+    const pending = results.filter((r) => r.runId && !TERMINAL_STATUSES.has(r.status));
+    if (pending.length > 0) {
+      process.stderr.write(`Waiting for ${pending.length} run(s)`);
+      await Promise.all(pending.map(async (r) => {
+        const final = await pollRun(client, r.runId);
+        r.status = final.status;
+      }));
+      process.stderr.write("\n");
+    }
+  }
+  if (opts?.format === "json") {
+    console.log(JSON.stringify(results, null, 2));
+    return;
+  }
+  console.log(`Triggered ${results.length} run(s):
+`);
+  console.log("  PROJECT                          RUN ID                                STATUS");
+  console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  for (const r of results) {
+    const proj = r.project.padEnd(31);
+    const id = (r.runId || "(failed)").padEnd(36);
+    console.log(`  ${proj}  ${id}  ${r.status}`);
+  }
+}
+async function showRun(id, format) {
+  const client = getClient4();
+  const run = await client.getRun(id);
+  if (format === "json") {
+    console.log(JSON.stringify(run, null, 2));
+    return;
+  }
+  printRunDetail(run);
+}
+async function listRuns(project, format) {
   const client = getClient4();
   const runs = await client.listRuns(project);
+  if (format === "json") {
+    console.log(JSON.stringify(runs, null, 2));
+    return;
+  }
   if (runs.length === 0) {
     console.log(`No runs found for "${project}".`);
     return;
@@ -632,39 +860,77 @@ async function listRuns(project) {
     );
   }
 }
+var POLL_TIMEOUT_MS = 10 * 60 * 1e3;
+async function pollRun(client, runId) {
+  const deadline = Date.now() + POLL_TIMEOUT_MS;
+  for (; ; ) {
+    await new Promise((r) => setTimeout(r, 2e3));
+    if (Date.now() > deadline) {
+      throw new Error(`Timed out waiting for run ${runId} after ${POLL_TIMEOUT_MS / 1e3}s`);
+    }
+    const run = await client.getRun(runId);
+    process.stderr.write(".");
+    if (TERMINAL_STATUSES.has(run.status)) {
+      return run;
+    }
+  }
+}
+function printRunDetail(run) {
+  console.log(`Run: ${run.id}`);
+  console.log(`  Status:   ${run.status}`);
+  console.log(`  Kind:     ${run.kind}`);
+  if (run.trigger) console.log(`  Trigger:  ${run.trigger}`);
+  if (run.startedAt) console.log(`  Started:  ${run.startedAt}`);
+  if (run.finishedAt) console.log(`  Finished: ${run.finishedAt}`);
+  if (run.createdAt) console.log(`  Created:  ${run.createdAt}`);
+  if (run.error) console.log(`  Error:    ${run.error}`);
+  const snapshots = run.snapshots;
+  if (snapshots && snapshots.length > 0) {
+    console.log(`
+  Snapshots: ${snapshots.length}`);
+    for (const s of snapshots) {
+      const state = s.citationState === "cited" ? "  cited    " : "  not-cited";
+      console.log(`    ${state}  ${s.provider}  ${s.keyword}`);
+    }
+  }
+}
 
 // src/commands/status.ts
 function getClient5() {
   const config = loadConfig();
   return new ApiClient(config.apiUrl, config.apiKey);
 }
-async function showStatus(project) {
+async function showStatus(project, format) {
   const client = getClient5();
   const projectData = await client.getProject(project);
+  let runs = [];
+  try {
+    runs = await client.listRuns(project);
+  } catch {
+  }
+  if (format === "json") {
+    console.log(JSON.stringify({ project: projectData, runs }, null, 2));
+    return;
+  }
   console.log(`Status: ${projectData.displayName} (${projectData.name})
 `);
   console.log(`  Domain:   ${projectData.canonicalDomain}`);
   console.log(`  Country:  ${projectData.country}`);
   console.log(`  Language: ${projectData.language}`);
-  try {
-    const runs = await client.listRuns(project);
-    if (runs.length > 0) {
-      const latest = runs[runs.length - 1];
-      console.log(`
+  if (runs.length > 0) {
+    const latest = runs[runs.length - 1];
+    console.log(`
   Latest run:`);
-      console.log(`    ID:       ${latest.id}`);
-      console.log(`    Status:   ${latest.status}`);
-      console.log(`    Created:  ${latest.createdAt}`);
-      if (latest.finishedAt) {
-        console.log(`    Finished: ${latest.finishedAt}`);
-      }
-      console.log(`
-  Total runs: ${runs.length}`);
-    } else {
-      console.log('\n  No runs yet. Use "canonry run" to trigger one.');
+    console.log(`    ID:       ${latest.id}`);
+    console.log(`    Status:   ${latest.status}`);
+    console.log(`    Created:  ${latest.createdAt}`);
+    if (latest.finishedAt) {
+      console.log(`    Finished: ${latest.finishedAt}`);
     }
-  } catch {
-    console.log("\n  Run info unavailable.");
+    console.log(`
+  Total runs: ${runs.length}`);
+  } else {
+    console.log('\n  No runs yet. Use "canonry run" to trigger one.');
   }
 }
 
@@ -673,9 +939,13 @@ function getClient6() {
   const config = loadConfig();
   return new ApiClient(config.apiUrl, config.apiKey);
 }
-async function showEvidence(project) {
+async function showEvidence(project, format) {
   const client = getClient6();
   const timeline = await client.getTimeline(project);
+  if (format === "json") {
+    console.log(JSON.stringify(timeline, null, 2));
+    return;
+  }
   if (timeline.length === 0) {
     console.log('No keyword evidence yet. Trigger a run first with "canonry run".');
     return;
@@ -700,10 +970,14 @@ function getClient7() {
   const config = loadConfig();
   return new ApiClient(config.apiUrl, config.apiKey);
 }
-async function showHistory(project) {
+async function showHistory(project, format) {
   const client = getClient7();
   try {
     const entries = await client.getHistory(project);
+    if (format === "json") {
+      console.log(JSON.stringify(entries, null, 2));
+      return;
+    }
     if (entries.length === 0) {
       console.log(`No audit history for "${project}".`);
       return;
@@ -725,13 +999,13 @@ async function showHistory(project) {
 }
 
 // src/commands/apply.ts
-import fs3 from "fs";
+import fs4 from "fs";
 import { parseAllDocuments } from "yaml";
 async function applyConfig(filePath) {
-  if (!fs3.existsSync(filePath)) {
+  if (!fs4.existsSync(filePath)) {
     throw new Error(`File not found: ${filePath}`);
   }
-  const content = fs3.readFileSync(filePath, "utf-8");
+  const content = fs4.readFileSync(filePath, "utf-8");
   const docs = parseAllDocuments(content);
   const clientConfig = loadConfig();
   const client = new ApiClient(clientConfig.apiUrl, clientConfig.apiKey);
@@ -789,10 +1063,17 @@ async function setProvider(name, opts) {
   if (result.model) {
     console.log(`  Model: ${result.model}`);
   }
+  if (result.quota) {
+    console.log(`  Quota: ${result.quota.maxConcurrency} concurrent \xB7 ${result.quota.maxRequestsPerMinute}/min \xB7 ${result.quota.maxRequestsPerDay}/day`);
+  }
 }
-async function showSettings() {
+async function showSettings(format) {
   const client = getClient8();
   const settings = await client.getSettings();
+  if (format === "json") {
+    console.log(JSON.stringify(settings, null, 2));
+    return;
+  }
   console.log("Provider settings:\n");
   for (const provider of settings.providers) {
     const status = provider.configured ? "configured" : "not configured";
@@ -822,9 +1103,13 @@ async function setSchedule(project, opts) {
   console.log(`Schedule set for "${project}":`);
   printSchedule(result);
 }
-async function showSchedule(project) {
+async function showSchedule(project, format) {
   const client = getClient9();
   const result = await client.getSchedule(project);
+  if (format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
   printSchedule(result);
 }
 async function enableSchedule(project) {
@@ -884,9 +1169,13 @@ async function addNotification(project, opts) {
   console.log(`Notification created for "${project}":`);
   printNotification(result);
 }
-async function listNotifications(project) {
+async function listNotifications(project, format) {
   const client = getClient10();
   const results = await client.listNotifications(project);
+  if (format === "json") {
+    console.log(JSON.stringify(results, null, 2));
+    return;
+  }
   if (results.length === 0) {
     console.log(`No notifications configured for "${project}"`);
     return;
@@ -912,6 +1201,23 @@ async function testNotification(project, id) {
     console.error(`Test webhook failed: HTTP ${result.status}`);
   }
 }
+var EVENT_DESCRIPTIONS = {
+  "citation.lost": "A keyword lost its citation status",
+  "citation.gained": "A keyword gained citation status",
+  "run.completed": "A visibility run completed successfully",
+  "run.failed": "A visibility run failed"
+};
+function listEvents(format) {
+  const events = notificationEventSchema.options;
+  if (format === "json") {
+    console.log(JSON.stringify(events.map((e) => ({ event: e, description: EVENT_DESCRIPTIONS[e] ?? "" })), null, 2));
+    return;
+  }
+  console.log("Available notification events:\n");
+  for (const event of events) {
+    console.log(`  ${event.padEnd(20)}  ${EVENT_DESCRIPTIONS[event] ?? ""}`);
+  }
+}
 function printNotification(n) {
   console.log(`  ID:      ${n.id}`);
   console.log(`  Channel: ${n.channel}`);
@@ -987,8 +1293,11 @@ Usage:
   canonry init [--force]               Initialize config and database (interactive)
   canonry init --gemini-key <key>     Initialize non-interactively (also reads env vars)
   canonry bootstrap [--force]          Bootstrap config/database from env vars
-  canonry serve                       Start the local server
+  canonry serve                       Start the local server (foreground)
+  canonry start                       Start the server as a background daemon
+  canonry stop                        Stop the background daemon
   canonry project create <name>       Create a project
+  canonry project update <name>       Update project settings
   canonry project list                List all projects
   canonry project show <name>         Show project details
   canonry project delete <name>       Delete a project
@@ -1000,6 +1309,9 @@ Usage:
   canonry competitor list <project>   List competitors
   canonry run <project>               Trigger a run (all providers)
   canonry run <project> --provider <name>  Trigger a run for a specific provider
+  canonry run <project> --wait        Trigger and wait for completion
+  canonry run --all                   Trigger runs for all projects
+  canonry run show <id>               Show run details and snapshots
   canonry runs <project>              List runs for a project
   canonry status <project>            Show project summary
   canonry evidence <project>          Show per-phrase results
@@ -1015,8 +1327,9 @@ Usage:
   canonry notify list <project>       List notifications
   canonry notify remove <project> <id>  Remove notification
   canonry notify test <project> <id>  Send test webhook
+  canonry notify events               List available notification event types
   canonry settings                    Show active provider and quota settings
-  canonry settings provider <name>    Update a provider config (--api-key, --base-url, --model)
+  canonry settings provider <name>    Update a provider config
   canonry telemetry status            Show telemetry status
   canonry telemetry enable            Enable anonymous telemetry
   canonry telemetry disable           Disable anonymous telemetry
@@ -1032,19 +1345,37 @@ Options:
   --local-key <key>    Local LLM API key (or LOCAL_API_KEY env var)
   --port <port>        Server port (default: 4100)
   --host <host>        Server bind address (default: 127.0.0.1)
-  --domain <domain>    Canonical domain for project create
+  --domain <domain>    Canonical domain for project create/update
+  --owned-domain <domain>  Additional owned domain for citation matching (repeatable)
+  --add-domain <domain>    Add an owned domain (project update, repeatable)
+  --remove-domain <domain> Remove an owned domain (project update, repeatable)
+  --display-name <name>    Display name for project create/update
   --country <code>     Country code (default: US)
   --language <lang>    Language code (default: en)
-  --provider <name>    Provider to use (gemini, openai, claude)
+  --provider <name>    Provider to use (gemini, openai, claude, local)
+  --format <fmt>       Output format: text (default) or json
+  --wait               Wait for run to complete before returning
+  --all                Run all projects (with 'run' command)
   --include-results    Include results in export
   --preset <preset>    Schedule preset (daily, weekly, twice-daily, daily@HH, weekly@DAY)
   --cron <expr>        Cron expression for schedule
   --timezone <tz>      IANA timezone for schedule (default: UTC)
   --webhook <url>      Webhook URL for notifications
   --events <list>      Comma-separated notification events
+  --api-key <key>      Provider API key (settings provider)
+  --base-url <url>     Provider base URL (settings provider)
+  --model <name>       Provider model name (settings provider)
+  --max-concurrent <n> Max concurrent requests per provider
+  --max-per-minute <n> Max requests per minute per provider
+  --max-per-day <n>    Max requests per day per provider
 `.trim();
 var _require = createRequire(import.meta.url);
 var { version: VERSION } = _require("../package.json");
+function extractFormat(cmdArgs) {
+  const idx = cmdArgs.indexOf("--format");
+  if (idx !== -1 && cmdArgs[idx + 1] === "json") return "json";
+  return "text";
+}
 async function main() {
   const args = process.argv.slice(2);
   if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
@@ -1056,6 +1387,7 @@ async function main() {
     return;
   }
   const command = args[0];
+  const format = extractFormat(args);
   if (command !== "telemetry" && command !== "init" && isTelemetryEnabled() && isFirstRun()) {
     showFirstRunNotice();
     getOrCreateAnonymousId();
@@ -1111,6 +1443,22 @@ async function main() {
         await serveCommand();
         break;
       }
+      case "start": {
+        const { values } = parseArgs({
+          args: args.slice(1),
+          options: {
+            port: { type: "string", short: "p", default: "4100" },
+            host: { type: "string", short: "H" }
+          },
+          allowPositionals: false
+        });
+        await startDaemon({ port: values.port, host: values.host });
+        break;
+      }
+      case "stop": {
+        stopDaemon();
+        break;
+      }
       case "project": {
         const subcommand = args[1];
         switch (subcommand) {
@@ -1124,22 +1472,56 @@ async function main() {
               args: args.slice(3),
               options: {
                 domain: { type: "string", short: "d" },
+                "owned-domain": { type: "string", multiple: true },
                 country: { type: "string", default: "US" },
                 language: { type: "string", default: "en" },
-                "display-name": { type: "string" }
+                "display-name": { type: "string" },
+                format: { type: "string" }
               },
               allowPositionals: false
             });
             await createProject(name, {
               domain: values.domain ?? name,
+              ownedDomains: values["owned-domain"] ?? [],
               country: values.country ?? "US",
               language: values.language ?? "en",
               displayName: values["display-name"] ?? name
             });
             break;
           }
+          case "update": {
+            const name = args[2];
+            if (!name) {
+              console.error("Error: project name is required");
+              process.exit(1);
+            }
+            const { values } = parseArgs({
+              args: args.slice(3),
+              options: {
+                domain: { type: "string", short: "d" },
+                "owned-domain": { type: "string", multiple: true },
+                "add-domain": { type: "string", multiple: true },
+                "remove-domain": { type: "string", multiple: true },
+                country: { type: "string" },
+                language: { type: "string" },
+                "display-name": { type: "string" },
+                format: { type: "string" }
+              },
+              allowPositionals: false
+            });
+            await updateProjectSettings(name, {
+              displayName: values["display-name"],
+              domain: values.domain,
+              ownedDomains: values["owned-domain"],
+              addOwnedDomain: values["add-domain"],
+              removeOwnedDomain: values["remove-domain"],
+              country: values.country,
+              language: values.language
+            });
+            break;
+          }
           case "list":
-            await listProjects();
+            await listProjects(format);
             break;
           case "show": {
             const name = args[2];
@@ -1147,7 +1529,7 @@ async function main() {
               console.error("Error: project name is required");
               process.exit(1);
             }
-            await showProject(name);
+            await showProject(name, format);
             break;
           }
           case "delete": {
@@ -1161,7 +1543,7 @@ async function main() {
           }
           default:
             console.error(`Unknown project subcommand: ${subcommand ?? "(none)"}`);
-            console.log("Available: create, list, show, delete");
+            console.log("Available: create, update, list, show, delete");
             process.exit(1);
         }
         break;
@@ -1171,7 +1553,7 @@ async function main() {
         switch (subcommand) {
           case "add": {
             const project = args[2];
-            const kws = args.slice(3);
+            const kws = args.slice(3).filter((a, i, arr) => !a.startsWith("--") && !(i > 0 && arr[i - 1].startsWith("--")));
             if (!project || kws.length === 0) {
               console.error("Error: project name and at least one key phrase required");
               process.exit(1);
@@ -1185,7 +1567,7 @@ async function main() {
               console.error("Error: project name is required");
               process.exit(1);
             }
-            await listKeywords(project);
+            await listKeywords(project, format);
             break;
           }
           case "import": {
@@ -1209,7 +1591,8 @@ async function main() {
               options: {
                 provider: { type: "string" },
                 count: { type: "string" },
-                save: { type: "boolean", default: false }
+                save: { type: "boolean", default: false },
+                format: { type: "string" }
               },
               allowPositionals: false
             });
@@ -1235,7 +1618,7 @@ async function main() {
         switch (subcommand) {
           case "add": {
             const project = args[2];
-            const domains = args.slice(3);
+            const domains = args.slice(3).filter((a, i, arr) => !a.startsWith("--") && !(i > 0 && arr[i - 1].startsWith("--")));
             if (!project || domains.length === 0) {
               console.error("Error: project name and at least one domain required");
               process.exit(1);
@@ -1249,7 +1632,7 @@ async function main() {
               console.error("Error: project name is required");
               process.exit(1);
             }
-            await listCompetitors(project);
+            await listCompetitors(project, format);
             break;
           }
           default:
@@ -1260,19 +1643,48 @@ async function main() {
         break;
       }
       case "run": {
-        const project = args[1];
-        if (!project) {
-          console.error("Error: project name is required");
-          process.exit(1);
+        if (args[1] === "show") {
+          const id = args[2];
+          if (!id) {
+            console.error("Error: run ID is required");
+            process.exit(1);
+          }
+          await showRun(id, format);
+          break;
         }
         const runParsed = parseArgs({
-          args: args.slice(2),
+          args: args.slice(1),
           options: {
-            provider: { type: "string" }
+            provider: { type: "string" },
+            wait: { type: "boolean", default: false },
+            all: { type: "boolean", default: false },
+            format: { type: "string" }
           },
-          allowPositionals: false
+          allowPositionals: true
         });
-        await triggerRun(project, { provider: runParsed.values.provider });
+        const runFormat = runParsed.values.format === "json" ? "json" : format;
+        if (runParsed.values.all) {
+          if (runParsed.positionals.length > 0) {
+            console.error("Error: --all cannot be combined with a project name");
+            process.exit(1);
+          }
+          await triggerRunAll({
+            provider: runParsed.values.provider,
+            wait: runParsed.values.wait,
+            format: runFormat
+          });
+        } else {
+          const project = runParsed.positionals[0];
+          if (!project) {
+            console.error("Error: project name is required (or use --all)");
+            process.exit(1);
+          }
+          await triggerRun(project, {
+            provider: runParsed.values.provider,
+            wait: runParsed.values.wait,
+            format: runFormat
+          });
+        }
         break;
       }
       case "runs": {
@@ -1281,7 +1693,7 @@ async function main() {
           console.error("Error: project name is required");
           process.exit(1);
         }
-        await listRuns(project);
+        await listRuns(project, format);
         break;
       }
       case "status": {
@@ -1290,7 +1702,7 @@ async function main() {
           console.error("Error: project name is required");
           process.exit(1);
         }
-        await showStatus(project);
+        await showStatus(project, format);
         break;
       }
       case "evidence": {
@@ -1299,7 +1711,7 @@ async function main() {
           console.error("Error: project name is required");
           process.exit(1);
         }
-        await showEvidence(project);
+        await showEvidence(project, format);
         break;
       }
       case "history": {
@@ -1308,7 +1720,7 @@ async function main() {
           console.error("Error: project name is required");
           process.exit(1);
         }
-        await showHistory(project);
+        await showHistory(project, format);
         break;
       }
       case "export": {
@@ -1357,7 +1769,8 @@ async function main() {
                 preset: { type: "string" },
                 cron: { type: "string" },
                 timezone: { type: "string" },
-                provider: { type: "string", multiple: true }
+                provider: { type: "string", multiple: true },
+                format: { type: "string" }
               },
               allowPositionals: false
             });
@@ -1374,7 +1787,7 @@ async function main() {
             break;
           }
           case "show":
-            await showSchedule(schedProject);
+            await showSchedule(schedProject, format);
             break;
           case "enable":
             await enableSchedule(schedProject);
@@ -1394,6 +1807,10 @@ async function main() {
       }
       case "notify": {
         const notifSubcommand = args[1];
+        if (notifSubcommand === "events") {
+          listEvents(format);
+          break;
+        }
         const notifProject = args[2];
         if (!notifProject && notifSubcommand !== void 0) {
           console.error("Error: project name is required");
@@ -1405,7 +1822,8 @@ async function main() {
               args: args.slice(3),
               options: {
                 webhook: { type: "string" },
-                events: { type: "string" }
+                events: { type: "string" },
+                format: { type: "string" }
               },
               allowPositionals: false
             });
@@ -1414,7 +1832,7 @@ async function main() {
               process.exit(1);
             }
             if (!values.events) {
-              console.error("Error: --events is required (comma-separated)");
+              console.error('Error: --events is required (comma-separated). Use "canonry notify events" to see valid events.');
               process.exit(1);
             }
             await addNotification(notifProject, {
@@ -1424,7 +1842,7 @@ async function main() {
             break;
           }
           case "list":
-            await listNotifications(notifProject);
+            await listNotifications(notifProject, format);
             break;
           case "remove": {
             const notifId = args[3];
@@ -1446,7 +1864,7 @@ async function main() {
           }
           default:
             console.error(`Unknown notify subcommand: ${notifSubcommand ?? "(none)"}`);
-            console.log("Available: add, list, remove, test");
+            console.log("Available: add, list, remove, test, events");
             process.exit(1);
         }
         break;
@@ -1464,7 +1882,11 @@ async function main() {
             options: {
               "api-key": { type: "string" },
               "base-url": { type: "string" },
-              model: { type: "string" }
+              model: { type: "string" },
+              "max-concurrent": { type: "string" },
+              "max-per-minute": { type: "string" },
+              "max-per-day": { type: "string" },
+              format: { type: "string" }
             },
             allowPositionals: false
           });
@@ -1479,9 +1901,18 @@ async function main() {
               process.exit(1);
             }
           }
-          await setProvider(name, { apiKey: values["api-key"], baseUrl: values["base-url"], model: values.model });
+          const quota = {};
+          if (values["max-concurrent"]) quota.maxConcurrency = parseInt(values["max-concurrent"], 10);
+          if (values["max-per-minute"]) quota.maxRequestsPerMinute = parseInt(values["max-per-minute"], 10);
+          if (values["max-per-day"]) quota.maxRequestsPerDay = parseInt(values["max-per-day"], 10);
+          await setProvider(name, {
+            apiKey: values["api-key"],
+            baseUrl: values["base-url"],
+            model: values.model,
+            quota: Object.keys(quota).length > 0 ? quota : void 0
+          });
         } else {
-          await showSettings();
+          await showSettings(format);
         }
         break;
       }