@virsanghavi/axis-server 1.9.0 → 1.9.2

package/dist/mcp-server.mjs

@@ -827,7 +827,7 @@ var NerveCenter = class _NerveCenter {
         delete this.state.locks[filePath];
         await this.saveState();
       }
-      this.logLockEvent("FORCE_UNLOCKED", filePath, "admin", void 0, reason);
+      await this.logLockEvent("FORCE_UNLOCKED", filePath, "admin", void 0, reason);
       await this.appendToNotepad(`
 - [FORCE UNLOCK] ${filePath} unlocked by admin. Reason: ${reason}`);
       return `File ${filePath} has been forcibly unlocked.`;
@@ -854,6 +854,7 @@ ${notepad}`;
   async logLockEvent(eventType, filePath, requestingAgent, blockingAgent, intent) {
     try {
       if (this.contextManager.apiUrl) {
+        logger.info(`[logLockEvent] Logging ${eventType} event via API for ${filePath} (agent: ${requestingAgent}, blocker: ${blockingAgent || "none"})`);
         await this.callCoordination("lock-events", "POST", {
           eventType,
           filePath,
@@ -861,7 +862,9 @@ ${notepad}`;
           blockingAgent: blockingAgent || null,
           intent: intent || null
         });
+        logger.info(`[logLockEvent] Successfully logged ${eventType} event`);
       } else if (this.useSupabase && this.supabase && this._projectId) {
+        logger.info(`[logLockEvent] Logging ${eventType} event via Supabase for ${filePath}`);
         await this.supabase.from("lock_events").insert({
           project_id: this._projectId,
           event_type: eventType,
@@ -870,9 +873,12 @@ ${notepad}`;
           blocking_agent: blockingAgent || null,
           intent: intent || null
         });
+        logger.info(`[logLockEvent] Successfully logged ${eventType} event`);
+      } else {
+        logger.warn(`[logLockEvent] No persistence backend available \u2014 ${eventType} event for ${filePath} will not be recorded`);
       }
     } catch (e) {
-      logger.warn(`[logLockEvent] Failed to log ${eventType} event: ${e.message}`);
+      logger.error(`[logLockEvent] Failed to log ${eventType} event for ${filePath}: ${e.message}`);
     }
   }
   // --- Decision & Orchestration ---
@@ -972,7 +978,7 @@ ${notepad}`;
           });
           if (result.status === "DENIED") {
             logger.info(`[proposeFileAccess] DENIED by server: ${result.message}`);
-            this.logLockEvent("BLOCKED", normalizedPath, agentId, result.current_lock?.agent_id, intent);
+            await this.logLockEvent("BLOCKED", normalizedPath, agentId, result.current_lock?.agent_id, intent);
             return {
               status: "REQUIRES_ORCHESTRATION",
               message: result.message || `File '${normalizedPath}' is locked by another agent`,
@@ -984,7 +990,7 @@ ${notepad}`;
             return { status: "REJECTED", message: result.message };
           }
           logger.info(`[proposeFileAccess] GRANTED by server`);
-          this.logLockEvent("GRANTED", normalizedPath, agentId, void 0, intent);
+          await this.logLockEvent("GRANTED", normalizedPath, agentId, void 0, intent);
           await this.appendToNotepad(`
 - [LOCK] ${agentId} locked ${normalizedPath}
   Intent: ${intent}`);
@@ -1001,7 +1007,7 @@ ${notepad}`;
               }
             } catch {
             }
-            this.logLockEvent("BLOCKED", normalizedPath, agentId, blockingAgent, intent);
+            await this.logLockEvent("BLOCKED", normalizedPath, agentId, blockingAgent, intent);
             return {
               status: "REQUIRES_ORCHESTRATION",
               message: `File '${normalizedPath}' is locked by another agent`
@@ -1024,7 +1030,7 @@ ${notepad}`;
           if (error) throw error;
           const row = Array.isArray(data) ? data[0] : data;
           if (row && row.status === "DENIED") {
-            this.logLockEvent("BLOCKED", normalizedPath, agentId, row.owner_id, intent);
+            await this.logLockEvent("BLOCKED", normalizedPath, agentId, row.owner_id, intent);
             return {
               status: "REQUIRES_ORCHESTRATION",
               message: `Conflict: File '${normalizedPath}' is locked by '${row.owner_id}'`,
@@ -1036,7 +1042,7 @@ ${notepad}`;
               }
             };
           }
-          this.logLockEvent("GRANTED", normalizedPath, agentId, void 0, intent);
+          await this.logLockEvent("GRANTED", normalizedPath, agentId, void 0, intent);
           await this.appendToNotepad(`
 - [LOCK] ${agentId} locked ${normalizedPath}
   Intent: ${intent}`);
@@ -1048,7 +1054,7 @@ ${notepad}`;
       const allLocks = Object.values(this.state.locks);
       const conflict = this.findExactConflict(filePath, agentId, allLocks);
       if (conflict) {
-        this.logLockEvent("BLOCKED", normalizedPath, agentId, conflict.agentId, intent);
+        await this.logLockEvent("BLOCKED", normalizedPath, agentId, conflict.agentId, intent);
         return {
           status: "REQUIRES_ORCHESTRATION",
           message: `Conflict: File '${normalizedPath}' is locked by '${conflict.agentId}'`,
@@ -1057,7 +1063,7 @@ ${notepad}`;
       }
       this.state.locks[normalizedPath] = { agentId, filePath: normalizedPath, intent, userPrompt, timestamp: Date.now() };
       await this.saveState();
-      this.logLockEvent("GRANTED", normalizedPath, agentId, void 0, intent);
+      await this.logLockEvent("GRANTED", normalizedPath, agentId, void 0, intent);
       await this.appendToNotepad(`
 - [LOCK] ${agentId} locked ${normalizedPath}
   Intent: ${intent}`);
@@ -1113,8 +1119,10 @@ ${notepad}`;
   }
   async getProjectSoul() {
     let soul = "## Project Soul\n";
+    let context = "";
+    let couldNotRead = false;
     try {
-      const context = await this.contextManager.readFile("context.md");
+      context = await this.contextManager.readFile("context.md");
       soul += `
 ### Context
 ${context}`;
@@ -1123,8 +1131,19 @@ ${context}`;
 ### Conventions
 ${conventions}`;
     } catch (_e) {
+      couldNotRead = true;
       soul += "\n(Could not read local context files)";
     }
+    const unfilled = couldNotRead || /Describe your project|<!-- Describe|This project uses Axis/i.test(context) || context.trim().length < 450 && /# Project Context/i.test(context);
+    if (unfilled) {
+      soul += `
+
+### MANDATORY: Project soul is not yet filled
+You MUST fill the project soul before doing any other work. Do not proceed with other tasks until it is filled.
+- If the codebase has content to search: use \`search_codebase\` to explore, then \`read_context\` and \`update_context\` to populate \`context.md\` and \`conventions.md\`.
+- If there is nothing in the directory to search through: you MUST ask the user what the project is about, then update the soul files with their answer.
+This requirement is mandatory; ignoring it means working without context.`;
+    }
     return soul;
   }
   // --- Billing & Usage ---
@@ -1841,30 +1860,18 @@ async function ensureFileSystem() {
         ["context.md", `# Project Context
 
 ## Overview
-This project uses Axis \u2014 an open-source coordination layer for AI agents.
-Axis provides shared context, atomic file locks, a job board, and real-time
-activity feeds so that multiple agents (Cursor, Claude, Windsurf, Codex, etc.)
-can work on the same codebase without conflicts.
+<!-- Describe your project's goals and what it does. If this file is still just placeholders, agents MUST fill it: use search_codebase to infer content from the repo, or if there is nothing to search, ask the user what the project is about, then update via update_context. Do not proceed with other work until the soul is filled. -->
 
 ## Architecture
-- **MCP Server**: Exposes tools (locks, jobs, context, search) via the Model Context Protocol.
-- **Supabase Backend**: Postgres for state (locks, jobs, profiles); Realtime for live feeds.
-- **Frontend**: Next.js App Router + Tailwind CSS dashboard at useaxis.dev.
-- **npm Packages**: @virsanghavi/axis-server (runtime), @virsanghavi/axis-init (scaffolding).
+<!-- Stack, high-level design, and key systems -->
 
 ## Core Features
-1. File Locking \u2014 atomic, cross-IDE locks with 30-min TTL.
-2. Job Board \u2014 post / claim / complete tasks with priorities and dependencies.
-3. Shared Context \u2014 live notepad visible to every agent in real time.
-4. RAG Search \u2014 vector search over the indexed codebase.
-5. Soul Files \u2014 context.md, conventions.md, activity.md define project identity.
+<!-- List main capabilities of this project -->
 `],
         ["conventions.md", `# Coding Conventions
 
 ## Language & Style
-- TypeScript everywhere (strict mode).
-- Tailwind CSS for styling; no raw CSS unless unavoidable.
-- Functional React components; prefer server components in Next.js App Router.
+<!-- Your language, framework, and styling guidelines -->
 
 ## Agent Behavioral Norms (MANDATORY)
 
@@ -2077,7 +2084,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     },
     {
       name: "get_project_soul",
-      description: "**MANDATORY FIRST CALL**: Returns the project's goals, architecture, conventions, and active state.\n- Combines `context.md`, `conventions.md`, and other core directives into a single prompt.\n- You MUST call this as your FIRST action in every new session or task \u2014 before reading files, before responding to the user, before anything else.\n- Skipping this call means you are working without context and will make wrong decisions.",
+      description: "**MANDATORY FIRST CALL**: Returns the project's goals, architecture, conventions, and active state.\n- Combines `context.md`, `conventions.md`, and other core directives into a single prompt.\n- You MUST call this as your FIRST action in every new session or task \u2014 before reading files, before responding to the user, before anything else.\n- If the project soul is not yet filled, you MUST fill it before any other work: use search_codebase then update_context, or if there is nothing to search, you MUST ask the user what the project is about and then update the soul files. Do not proceed with other tasks until the soul is filled.\n- Skipping this call means you are working without context and will make wrong decisions.",
       inputSchema: { type: "object", properties: {}, required: [] }
     },
     // --- Job Board (Task Orchestration) ---

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@virsanghavi/axis-server",
-    "version": "1.9.0",
+    "version": "1.9.2",
     "description": "Axis MCP Server CLI",
     "main": "dist/index.js",
     "bin": {