@ainyc/canonry 2.2.1 → 2.2.3

package/dist/cli.js

@@ -17,6 +17,7 @@ import {
   getConfigDir,
   getConfigPath,
   getOrCreateAnonymousId,
+  isEndpointMissing,
   isFirstRun,
   isTelemetryEnabled,
   listAgentProviders,
@@ -35,7 +36,7 @@ import {
   showFirstRunNotice,
   trackEvent,
   usageError
-} from "./chunk-2QNWFP6R.js";
+} from "./chunk-MXUOJWNL.js";
 import {
   apiKeys,
   competitors,
@@ -3327,14 +3328,8 @@ async function exportProject(project, opts) {
   const client = createApiClient();
   const data = await client.getExport(project);
   if (opts.includeResults) {
-    try {
-      const runs2 = await client.listRuns(project);
-      if (runs2.length > 0) {
-        const latestRun = await client.getRun(runs2[runs2.length - 1].id);
-        data.results = latestRun;
-      }
-    } catch {
-    }
+    const results = await loadLatestRunForExport(client, project);
+    if (results) data.results = results;
   }
   if (opts.format === "json") {
     console.log(JSON.stringify(data, null, 2));
@@ -3342,6 +3337,20 @@ async function exportProject(project, opts) {
   }
   console.log(stringify(data));
 }
+async function loadLatestRunForExport(client, project) {
+  try {
+    const latest = await client.getLatestRun(project);
+    return latest.run ?? null;
+  } catch (err) {
+    if (!isEndpointMissing(err)) throw err;
+  }
+  const runs2 = await client.listRuns(project);
+  if (runs2.length === 0) return null;
+  const latestRun = runs2.reduce(
+    (current, candidate) => candidate.createdAt > current.createdAt ? candidate : current
+  );
+  return client.getRun(latestRun.id);
+}
 
 // src/commands/history.ts
 function getClient10() {
@@ -3389,13 +3398,19 @@ function getClient11() {
 async function showStatus(project, format) {
   const client = getClient11();
   const projectData = await client.getProject(project);
-  let runs2 = [];
-  try {
-    runs2 = await client.listRuns(project);
-  } catch {
-  }
+  const latest = await getLatestRunSummary(client, project);
   if (format === "json") {
-    console.log(JSON.stringify({ project: projectData, runs: runs2 }, null, 2));
+    let runs2 = [];
+    try {
+      runs2 = await client.listRuns(project);
+    } catch {
+    }
+    console.log(JSON.stringify({
+      project: projectData,
+      runs: runs2,
+      latestRun: latest.run,
+      totalRuns: latest.totalRuns
+    }, null, 2));
     return;
   }
   console.log(`Status: ${projectData.displayName ?? projectData.name} (${projectData.name})
@@ -3403,24 +3418,39 @@ async function showStatus(project, format) {
   console.log(`  Domain:   ${projectData.canonicalDomain}`);
   console.log(`  Country:  ${projectData.country}`);
   console.log(`  Language: ${projectData.language}`);
-  if (runs2.length > 0) {
-    const latest = runs2.reduce(
-      (current, candidate) => candidate.createdAt > current.createdAt ? candidate : current
-    );
+  if (latest.run) {
     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(`    ID:       ${latest.run.id}`);
+    console.log(`    Status:   ${latest.run.status}`);
+    console.log(`    Created:  ${latest.run.createdAt}`);
+    if (latest.run.finishedAt) {
+      console.log(`    Finished: ${latest.run.finishedAt}`);
     }
     console.log(`
-  Total runs: ${runs2.length}`);
+  Total runs: ${latest.totalRuns}`);
   } else {
     console.log('\n  No runs yet. Use "canonry run" to trigger one.');
   }
 }
+async function getLatestRunSummary(client, project) {
+  try {
+    return await client.getLatestRun(project);
+  } catch (err) {
+    if (!isEndpointMissing(err)) throw err;
+    const runs2 = await client.listRuns(project);
+    if (runs2.length === 0) {
+      return { totalRuns: 0, run: null };
+    }
+    const latestRun = runs2.reduce(
+      (current, candidate) => candidate.createdAt > current.createdAt ? candidate : current
+    );
+    return {
+      totalRuns: runs2.length,
+      run: latestRun
+    };
+  }
+}
 
 // src/cli-commands/operator.ts
 var OPERATOR_CLI_COMMANDS = [
@@ -7519,27 +7549,48 @@ var AGENT_CLI_COMMANDS = [
       scope: stringOption()
     },
     run: async (input) => {
-      const [project, ...rest] = input.positionals;
-      if (!project || rest.length === 0) {
-        console.error('Usage: canonry agent ask <project> "<prompt>"');
-        process.exitCode = 1;
-        return;
+      const usage = `canonry agent ask <project> "<prompt>" [--provider ${listAgentProviders().join("|")}] [--model <id>] [--scope all|read-only] [--format json]`;
+      const project = requireProject(input, "agent.ask", usage);
+      const prompt2 = input.positionals.slice(1).join(" ").trim();
+      if (!prompt2) {
+        throw usageError(`Error: prompt is required
+Usage: ${usage}`, {
+          message: "prompt is required",
+          details: {
+            command: "agent.ask",
+            usage
+          }
+        });
       }
       const providerInput = getString(input.values, "provider");
       if (providerInput && !coerceAgentProvider(providerInput)) {
-        console.error(`--provider must be one of: ${listAgentProviders().join(", ")}`);
-        process.exitCode = 1;
-        return;
+        throw usageError(`Error: --provider must be one of: ${listAgentProviders().join(", ")}
+Usage: ${usage}`, {
+          message: `--provider must be one of: ${listAgentProviders().join(", ")}`,
+          details: {
+            command: "agent.ask",
+            usage,
+            provider: providerInput,
+            validProviders: listAgentProviders()
+          }
+        });
       }
       const scopeInput = getString(input.values, "scope");
       if (scopeInput && !AGENT_ASK_SCOPES.includes(scopeInput)) {
-        console.error(`--scope must be one of: ${AGENT_ASK_SCOPES.join(", ")}`);
-        process.exitCode = 1;
-        return;
+        throw usageError(`Error: --scope must be one of: ${AGENT_ASK_SCOPES.join(", ")}
+Usage: ${usage}`, {
+          message: `--scope must be one of: ${AGENT_ASK_SCOPES.join(", ")}`,
+          details: {
+            command: "agent.ask",
+            usage,
+            scope: scopeInput,
+            validScopes: AGENT_ASK_SCOPES
+          }
+        });
       }
       await agentAsk({
         project,
-        prompt: rest.join(" "),
+        prompt: prompt2,
         provider: coerceAgentProvider(providerInput),
         modelId: getString(input.values, "model"),
         scope: scopeInput,
@@ -7552,12 +7603,7 @@ var AGENT_CLI_COMMANDS = [
     usage: "canonry agent providers <project> [--format json]",
     options: {},
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        console.error("Usage: canonry agent providers <project>");
-        process.exitCode = 1;
-        return;
-      }
+      const project = requireProject(input, "agent.providers", "canonry agent providers <project> [--format json]");
       await agentProviders({ project, format: input.format });
     }
   },
@@ -7568,18 +7614,16 @@ var AGENT_CLI_COMMANDS = [
       url: stringOption()
     },
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        console.error("Usage: canonry agent attach <project> --url <webhook-url>");
-        process.exitCode = 1;
-        return;
-      }
-      const url = getString(input.values, "url");
-      if (!url) {
-        console.error("Missing required --url flag. Specify the agent webhook URL to attach.");
-        process.exitCode = 1;
-        return;
-      }
+      const usage = "canonry agent attach <project> --url <webhook-url> [--format json]";
+      const project = requireProject(input, "agent.attach", usage);
+      const url = requireStringOption(input, "url", {
+        command: "agent.attach",
+        usage,
+        message: "--url is required",
+        details: {
+          flag: "url"
+        }
+      });
       await agentAttach({ project, url, format: input.format });
     }
   },
@@ -7588,12 +7632,7 @@ var AGENT_CLI_COMMANDS = [
     usage: "canonry agent detach <project> [--format json]",
     options: {},
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        console.error("Usage: canonry agent detach <project>");
-        process.exitCode = 1;
-        return;
-      }
+      const project = requireProject(input, "agent.detach", "canonry agent detach <project> [--format json]");
       await agentDetach({ project, format: input.format });
     }
   },
@@ -7602,12 +7641,7 @@ var AGENT_CLI_COMMANDS = [
     usage: "canonry agent transcript <project> [--format json]",
     options: {},
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        console.error("Usage: canonry agent transcript <project>");
-        process.exitCode = 1;
-        return;
-      }
+      const project = requireProject(input, "agent.transcript", "canonry agent transcript <project> [--format json]");
       await agentTranscript({ project, format: input.format });
     }
   },
@@ -7616,12 +7650,7 @@ var AGENT_CLI_COMMANDS = [
     usage: "canonry agent reset <project> [--format json]",
     options: {},
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        console.error("Usage: canonry agent reset <project>");
-        process.exitCode = 1;
-        return;
-      }
+      const project = requireProject(input, "agent.reset", "canonry agent reset <project> [--format json]");
       await agentTranscriptReset({ project, format: input.format });
     }
   },
@@ -7630,12 +7659,8 @@ var AGENT_CLI_COMMANDS = [
     usage: "canonry agent memory list <project> [--format json]",
     options: {},
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        throw usageError("Usage: canonry agent memory list <project>", {
-          message: "project name is required"
-        });
-      }
+      const usage = "canonry agent memory list <project> [--format json]";
+      const project = requireProject(input, "agent.memory.list", usage);
       await agentMemoryList({ project, format: input.format });
     }
   },
@@ -7647,19 +7672,24 @@ var AGENT_CLI_COMMANDS = [
       value: stringOption()
     },
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        throw usageError("Usage: canonry agent memory set <project> --key <k> --value <v>", {
-          message: "project name is required"
-        });
-      }
-      const key = getString(input.values, "key");
-      const value = getString(input.values, "value");
-      if (!key || !value) {
-        throw usageError("--key and --value are both required.", {
-          message: "--key and --value are both required"
-        });
-      }
+      const usage = "canonry agent memory set <project> --key <k> --value <v> [--format json]";
+      const project = requireProject(input, "agent.memory.set", usage);
+      const key = requireStringOption(input, "key", {
+        command: "agent.memory.set",
+        usage,
+        message: "--key is required",
+        details: {
+          flag: "key"
+        }
+      });
+      const value = requireStringOption(input, "value", {
+        command: "agent.memory.set",
+        usage,
+        message: "--value is required",
+        details: {
+          flag: "value"
+        }
+      });
       await agentMemorySet({ project, key, value, format: input.format });
     }
   },
@@ -7670,18 +7700,16 @@ var AGENT_CLI_COMMANDS = [
       key: stringOption()
     },
     run: async (input) => {
-      const project = input.positionals[0];
-      if (!project) {
-        throw usageError("Usage: canonry agent memory forget <project> --key <k>", {
-          message: "project name is required"
-        });
-      }
-      const key = getString(input.values, "key");
-      if (!key) {
-        throw usageError("--key is required.", {
-          message: "--key is required"
-        });
-      }
+      const usage = "canonry agent memory forget <project> --key <k> [--format json]";
+      const project = requireProject(input, "agent.memory.forget", usage);
+      const key = requireStringOption(input, "key", {
+        command: "agent.memory.forget",
+        usage,
+        message: "--key is required",
+        details: {
+          flag: "key"
+        }
+      });
       await agentMemoryForget({ project, key, format: input.format });
     }
   }

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   createServer,
   loadConfig
-} from "./chunk-2QNWFP6R.js";
+} from "./chunk-MXUOJWNL.js";
 import "./chunk-TAII35VC.js";
 export {
   createServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "2.2.1",
+  "version": "2.2.3",
   "type": "module",
   "description": "The ultimate open-source AEO monitoring tool - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -62,15 +62,15 @@
     "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",