@cerefox/memory 1.1.0 → 1.2.0

package/dist/bin/cerefox.js

@@ -7438,7 +7438,7 @@ var exports_meta = {};
 __export(exports_meta, {
   PKG_VERSION: () => PKG_VERSION
 });
-var PKG_VERSION = "1.1.0";
+var PKG_VERSION = "1.2.0";
 var init_meta = () => {};
 
 // ../../_shared/config/paths.ts
@@ -25858,7 +25858,7 @@ async function checkServerCompatibility(opts) {
 var COMPATIBILITY;
 var init_compatibility = __esm(() => {
   COMPATIBILITY = {
-    minSchema: "0.10.3",
+    minSchema: "0.10.5",
     minEdgeFunctions: "0.6.0"
   };
 });
@@ -55148,6 +55148,12 @@ var init_audit_log = __esm(() => {
   auditLogTool = {
     name: "cerefox_get_audit_log",
     description: "Retrieve audit log entries showing who changed what and when. Supports filtering by document, author, operation type, and time range. Returns entries with document titles, author attribution, size changes, and descriptions.",
+    annotations: {
+      title: "Read audit log",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       required: [],
@@ -55346,6 +55352,13 @@ var init_relations = __esm(() => {
   setRelationTool = {
     name: "cerefox_set_relation",
     description: "Link two documents with a typed, directed relation (source → target). " + `Known types with behaviour: ${KNOWN_TYPES}. Symmetric types (related_to, ` + "contradicts, duplicates) write both directions. `supersedes` marks the target " + "superseded; `contradicts` marks both stale. Any other type string is accepted " + "and stored, just without special behaviour. Re-setting the same edge updates it.",
+    annotations: {
+      title: "Link two documents",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       required: ["source_id", "target_id", "rel_type"],
@@ -55369,6 +55382,13 @@ var init_relations = __esm(() => {
   deleteRelationTool = {
     name: "cerefox_delete_relation",
     description: "Remove a typed relation between two documents. Symmetric types remove both " + "directions. Lifecycle status set by an earlier relation is NOT reverted.",
+    annotations: {
+      title: "Remove a relation",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       required: ["source_id", "target_id", "rel_type"],
@@ -55385,6 +55405,12 @@ var init_relations = __esm(() => {
   getRelationsTool = {
     name: "cerefox_get_relations",
     description: "List every relation touching a document, in both directions (→ outbound, " + "← inbound). Shows each neighbour's title and lifecycle status, so an agent " + "can tell whether retrieved knowledge has been superseded or contradicted.",
+    annotations: {
+      title: "List a document's relations",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       required: ["document_id"],
@@ -55398,6 +55424,12 @@ var init_relations = __esm(() => {
   getNeighborsTool = {
     name: "cerefox_get_neighbors",
     description: "Walk the relation graph outward from a document along ONE relation type. " + "Use after cerefox_get_relations shows which types exist. depth > 1 follows " + "chains (useful for follows / reply_to); cycles terminate safely. Optional " + "from_time / to_time filter neighbours by their creation time.",
+    annotations: {
+      title: "Walk the relation graph",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       required: ["document_id", "rel_type"],
@@ -55450,6 +55482,12 @@ var init_get_document = __esm(() => {
   getDocumentTool = {
     name: "cerefox_get_document",
     description: "Retrieve the full reconstructed content of a document. Pass version_id to retrieve an archived version; omit it (or pass null) for the current version. Version UUIDs are returned by cerefox_list_versions. The response header includes the document's current content_hash — pass it back as expected_content_hash when updating via cerefox_ingest (optimistic concurrency).",
+    annotations: {
+      title: "Read document",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       required: ["document_id"],
@@ -55535,6 +55573,12 @@ var init_get_help = __esm(() => {
   getHelpTool = {
     name: "cerefox_get_help",
     description: "Retrieve Cerefox's own agent-usage guidance (the AGENT_QUICK_REFERENCE.md content). Call with no arguments to get the full reference + a section index. Call with `topic` to get a single section (case-insensitive substring match against H2 headings). Use this whenever you're uncertain about Cerefox conventions — link forms, project-membership semantics, update workflows, etc.",
+    annotations: {
+      title: "Read Cerefox conventions",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       properties: {
@@ -55789,6 +55833,13 @@ var init_ingest = __esm(() => {
   ingestTool = {
     name: "cerefox_ingest",
     description: "Save a note or document to the Cerefox knowledge base.",
+    annotations: {
+      title: "Save or update a document",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       required: ["title", "content"],
@@ -55853,6 +55904,12 @@ var init_list_metadata_keys = __esm(() => {
   listMetadataKeysTool = {
     name: "cerefox_list_metadata_keys",
     description: "List all metadata keys currently in use across documents in the Cerefox knowledge base. Returns each key with its document count and up to 5 example values.",
+    annotations: {
+      title: "List metadata keys",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       properties: {
@@ -55894,6 +55951,12 @@ var init_list_projects = __esm(() => {
   listProjectsTool = {
     name: "cerefox_list_projects",
     description: "List all projects with their names and IDs. Use this to discover available projects before filtering by project_name in other tools.",
+    annotations: {
+      title: "List projects",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       properties: {
@@ -55939,6 +56002,12 @@ var init_list_versions = __esm(() => {
   listVersionsTool = {
     name: "cerefox_list_versions",
     description: "List all archived versions of a document, newest first. Returns version_id (use with cerefox_get_document), version_number, source, chunk_count, total_chars, and created_at.",
+    annotations: {
+      title: "List document versions",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       required: ["document_id"],
@@ -56032,6 +56101,12 @@ var init_metadata_search = __esm(() => {
   metadataSearchTool = {
     name: "cerefox_metadata_search",
     description: "Find or list documents by metadata key-value criteria without a text search term. Use to discover documents tagged with specific attributes, browse by taxonomy, retrieve messages/tasks by type and status, or list all documents in a project (pass project_name alone). At least one of metadata_filter, project_name, updated_since, or created_since must be supplied; results are ordered newest-updated first.",
+    annotations: {
+      title: "Find documents by metadata",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       properties: {
@@ -56192,6 +56267,12 @@ var init_search = __esm(() => {
   searchTool = {
     name: "cerefox_search",
     description: "Search the Cerefox personal knowledge base. Returns complete documents ranked by hybrid (FTS + semantic) relevance.",
+    annotations: {
+      title: "Search knowledge base",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       required: ["query"],
@@ -56277,6 +56358,13 @@ var init_set_document_projects = __esm(() => {
   setDocumentProjectsTool = {
     name: "cerefox_set_document_projects",
     description: "Set the document's project memberships to EXACTLY the given list. Destructive replace: any existing memberships not in this list are removed. Pass an empty list to clear all project memberships. Projects are looked up by name (case-insensitive); missing projects are created. Logged as update-metadata in the audit log — content is untouched. Use cerefox_ingest with project_names if you want to set memberships AND update content in one call. Use this tool when you only need to change project membership without re-writing the document body.",
+    annotations: {
+      title: "Replace project memberships",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       required: ["document_id", "project_names"],
@@ -69491,7 +69579,8 @@ function buildServer() {
     tools: (await listEnabledTools(supabase)).map((t) => ({
       name: t.name,
       description: t.description,
-      inputSchema: t.inputSchema
+      inputSchema: t.inputSchema,
+      ...t.annotations ? { annotations: t.annotations } : {}
     }))
   }));
   server.setRequestHandler(CallToolRequestSchema, async (req) => {
@@ -75610,8 +75699,8 @@ import { homedir as homedir6 } from "node:os";
 import { join as join9 } from "node:path";
 
 // ../../_shared/ef-meta/index.ts
-var EF_VERSION = "1.1.0";
-var EF_LAST_CHANGED = "1.1.0-beta.7";
+var EF_VERSION = "1.2.0";
+var EF_LAST_CHANGED = "1.2.0";
 
 // src/cli/util/checks.ts
 init_config();
@@ -79020,6 +79109,7 @@ init_sync_self_docs();
 
 // src/cli/commands/web.ts
 init_cli_core();
+import { readFileSync as readFileSync19 } from "node:fs";
 
 // ../../node_modules/.bun/@hono+node-server@2.0.12+19b9adbcbc3b652f/node_modules/@hono/node-server/dist/constants-BLSFu_RU.mjs
 var X_ALREADY_SENT = "x-hono-already-sent";
@@ -84462,6 +84552,17 @@ async function runForeground(host, port, watch) {
     process.exit(1);
   }
 }
+function readStartupRefusal() {
+  try {
+    const tail = readFileSync19(daemonPaths.logFile, "utf8").slice(-4000);
+    const idx = tail.lastIndexOf("Refusing to start:");
+    if (idx === -1)
+      return null;
+    return tail.slice(idx).trim();
+  } catch {
+    return null;
+  }
+}
 function registerWeb(program2) {
   const web = program2.command("web").description("Start the local web UI / API server (foreground; see `web start` for daemon).").option("--host <host>", "Bind host.", "127.0.0.1").option("--port <port>", "Bind port.", "8000").option("--watch", "Enable hot-reload (dev mode; reserved).").action(async (rawOpts) => {
     await runForeground(rawOpts.host, parsePort(rawOpts.port), rawOpts.watch);
@@ -84492,8 +84593,15 @@ function registerWeb(program2) {
             println(c.dim(`  Logs:    ${daemonPaths.logFile}`));
             println(c.dim(`  Stop:    cerefox web stop`));
           } else {
-            eprintln(`Started (pid ${outcome.pid}) but it is not responding on :${port} yet.
+            const refusal = readStartupRefusal();
+            if (refusal) {
+              eprintln(refusal);
+              eprintln(`
+Full log: ${daemonPaths.logFile}`);
+            } else {
+              eprintln(`Started (pid ${outcome.pid}) but it is not responding on :${port} yet.
 ` + `Check the log for errors: ${daemonPaths.logFile}`);
+            }
             process.exit(1);
           }
           break;