@ainyc/canonry 2.0.0 → 2.2.3

package/dist/{chunk-GH6WGN5B.js → chunk-TAII35VC.js}

@@ -16,6 +16,7 @@ import { drizzle } from "drizzle-orm/better-sqlite3";
 // ../db/src/schema.ts
 var schema_exports = {};
 __export(schema_exports, {
+  agentMemory: () => agentMemory,
   agentSessions: () => agentSessions,
   apiKeys: () => apiKeys,
   auditLog: () => auditLog,
@@ -425,6 +426,18 @@ var agentSessions = sqliteTable("agent_sessions", {
   index("idx_agent_sessions_project").on(table.projectId),
   index("idx_agent_sessions_updated").on(table.updatedAt)
 ]);
+var agentMemory = sqliteTable("agent_memory", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  key: text("key").notNull(),
+  value: text("value").notNull(),
+  source: text("source").notNull(),
+  createdAt: text("created_at").notNull(),
+  updatedAt: text("updated_at").notNull()
+}, (table) => [
+  uniqueIndex("uniq_agent_memory_project_key").on(table.projectId, table.key),
+  index("idx_agent_memory_project_updated").on(table.projectId, table.updatedAt)
+]);
 
 // ../db/src/client.ts
 function createClient(databasePath) {
@@ -894,7 +907,21 @@ var MIGRATIONS = [
   // registry no longer recognizes 'anthropic'/'google'. Safe to re-run: the
   // UPDATE is a no-op once the rename has been applied.
   `UPDATE agent_sessions SET model_provider = 'claude' WHERE model_provider = 'anthropic'`,
-  `UPDATE agent_sessions SET model_provider = 'gemini' WHERE model_provider = 'google'`
+  `UPDATE agent_sessions SET model_provider = 'gemini' WHERE model_provider = 'google'`,
+  // v40: Aero durable memory — project-scoped notes + compaction summaries.
+  `CREATE TABLE IF NOT EXISTS agent_memory (
+    id          TEXT PRIMARY KEY,
+    project_id  TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    key         TEXT NOT NULL,
+    value       TEXT NOT NULL,
+    source      TEXT NOT NULL,
+    created_at  TEXT NOT NULL,
+    updated_at  TEXT NOT NULL
+  )`,
+  `CREATE UNIQUE INDEX IF NOT EXISTS uniq_agent_memory_project_key
+    ON agent_memory(project_id, key)`,
+  `CREATE INDEX IF NOT EXISTS idx_agent_memory_project_updated
+    ON agent_memory(project_id, updated_at)`
 ];
 function isDuplicateColumnError(err) {
   if (!(err instanceof Error)) return false;
@@ -1425,6 +1452,7 @@ export {
   insights,
   healthSnapshots,
   agentSessions,
+  agentMemory,
   createClient,
   parseJsonColumn,
   extractLegacyCredentials,

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-YZKLIUH4.js";
+} from "./chunk-MXUOJWNL.js";
 import {
   apiKeys,
   competitors,
@@ -45,7 +46,7 @@ import {
   projects,
   querySnapshots,
   runs
-} from "./chunk-GH6WGN5B.js";
+} from "./chunk-TAII35VC.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -292,7 +293,7 @@ async function backfillAnswerVisibilityCommand(opts) {
   console.log(`  Errors:   ${providerErrors}`);
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-LHWXONQJ.js");
+  const { IntelligenceService } = await import("./intelligence-service-C5LAYDFM.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -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 = [
@@ -7440,6 +7470,73 @@ async function agentTranscriptReset(opts) {
   }
 }
 
+// src/commands/agent-memory.ts
+function toFormat2(raw) {
+  return raw === "json" ? "json" : "text";
+}
+async function agentMemoryList(opts) {
+  const format = toFormat2(opts.format);
+  try {
+    const client = createApiClient();
+    const result = await client.listAgentMemory(opts.project);
+    if (format === "json") {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (result.entries.length === 0) {
+      console.log(`No Aero memory notes for "${opts.project}".`);
+      return;
+    }
+    console.log(`Aero memory for ${opts.project} \u2014 ${result.entries.length} note(s)
+`);
+    for (const entry of result.entries) {
+      console.log(`[${entry.source}] ${entry.key}  (updated ${entry.updatedAt})`);
+      console.log(`  ${entry.value.replace(/\n/g, "\n  ")}`);
+      console.log();
+    }
+  } catch (err) {
+    printCliError(err, format);
+    process.exitCode = err instanceof CliError ? err.exitCode : 2;
+  }
+}
+async function agentMemorySet(opts) {
+  const format = toFormat2(opts.format);
+  try {
+    const client = createApiClient();
+    const result = await client.setAgentMemory(opts.project, {
+      key: opts.key,
+      value: opts.value
+    });
+    if (format === "json") {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(`Stored note "${result.entry.key}" for "${opts.project}" (source=${result.entry.source}).`);
+  } catch (err) {
+    printCliError(err, format);
+    process.exitCode = err instanceof CliError ? err.exitCode : 2;
+  }
+}
+async function agentMemoryForget(opts) {
+  const format = toFormat2(opts.format);
+  try {
+    const client = createApiClient();
+    const result = await client.forgetAgentMemory(opts.project, opts.key);
+    if (format === "json") {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (result.status === "forgotten") {
+      console.log(`Forgot note "${opts.key}" for "${opts.project}".`);
+    } else {
+      console.log(`No note with key "${opts.key}" for "${opts.project}".`);
+    }
+  } catch (err) {
+    printCliError(err, format);
+    process.exitCode = err instanceof CliError ? err.exitCode : 2;
+  }
+}
+
 // src/cli-commands/agent.ts
 var AGENT_ASK_SCOPES = ["all", "read-only"];
 var AGENT_CLI_COMMANDS = [
@@ -7452,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,
@@ -7485,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 });
     }
   },
@@ -7501,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 });
     }
   },
@@ -7521,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 });
     }
   },
@@ -7535,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 });
     }
   },
@@ -7549,14 +7650,68 @@ 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 });
     }
+  },
+  {
+    path: ["agent", "memory", "list"],
+    usage: "canonry agent memory list <project> [--format json]",
+    options: {},
+    run: async (input) => {
+      const usage = "canonry agent memory list <project> [--format json]";
+      const project = requireProject(input, "agent.memory.list", usage);
+      await agentMemoryList({ project, format: input.format });
+    }
+  },
+  {
+    path: ["agent", "memory", "set"],
+    usage: "canonry agent memory set <project> --key <k> --value <v> [--format json]",
+    options: {
+      key: stringOption(),
+      value: stringOption()
+    },
+    run: async (input) => {
+      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 });
+    }
+  },
+  {
+    path: ["agent", "memory", "forget"],
+    usage: "canonry agent memory forget <project> --key <k> [--format json]",
+    options: {
+      key: stringOption()
+    },
+    run: async (input) => {
+      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,8 +1,8 @@
 import {
   createServer,
   loadConfig
-} from "./chunk-YZKLIUH4.js";
-import "./chunk-GH6WGN5B.js";
+} from "./chunk-MXUOJWNL.js";
+import "./chunk-TAII35VC.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-LHWXONQJ.js → intelligence-service-C5LAYDFM.js}

@@ -1,6 +1,6 @@
 import {
   IntelligenceService
-} from "./chunk-GH6WGN5B.js";
+} from "./chunk-TAII35VC.js";
 export {
   IntelligenceService
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "2.0.0",
+  "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",
@@ -58,19 +58,19 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-integration-google": "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-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0"
+    "@ainyc/canonry-provider-openai": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",