@virsanghavi/axis-server 1.1.1 → 1.2.0

package/dist/mcp-server.mjs

@@ -827,6 +827,7 @@ var NerveCenter = class {
         delete this.state.locks[filePath];
         await this.saveState();
       }
+      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.`;
@@ -849,6 +850,31 @@ ${lockSummary || "No active locks."}
 ## Live Notepad
 ${notepad}`;
   }
+  // --- Lock Event Logging ---
+  async logLockEvent(eventType, filePath, requestingAgent, blockingAgent, intent) {
+    try {
+      if (this.contextManager.apiUrl) {
+        await this.callCoordination("lock-events", "POST", {
+          eventType,
+          filePath,
+          requestingAgent,
+          blockingAgent: blockingAgent || null,
+          intent: intent || null
+        });
+      } else if (this.useSupabase && this.supabase && this._projectId) {
+        await this.supabase.from("lock_events").insert({
+          project_id: this._projectId,
+          event_type: eventType,
+          file_path: filePath,
+          requesting_agent: requestingAgent,
+          blocking_agent: blockingAgent || null,
+          intent: intent || null
+        });
+      }
+    } catch (e) {
+      logger.warn(`[logLockEvent] Failed to log ${eventType} event: ${e.message}`);
+    }
+  }
   // --- Decision & Orchestration ---
   async proposeFileAccess(agentId, filePath, intent, userPrompt) {
     return await this.mutex.runExclusive(async () => {
@@ -864,6 +890,7 @@ ${notepad}`;
           });
           if (result.status === "DENIED") {
             logger.info(`[proposeFileAccess] DENIED by server: ${result.message}`);
+            this.logLockEvent("BLOCKED", filePath, agentId, result.current_lock?.agent_id, intent);
             return {
               status: "REQUIRES_ORCHESTRATION",
               message: result.message || `File '${filePath}' is locked by another agent`,
@@ -871,6 +898,7 @@ ${notepad}`;
             };
           }
           logger.info(`[proposeFileAccess] GRANTED by server`);
+          this.logLockEvent("GRANTED", filePath, agentId, void 0, intent);
           await this.appendToNotepad(`
 - [LOCK] ${agentId} locked ${filePath}
   Intent: ${intent}`);
@@ -900,6 +928,7 @@ ${notepad}`;
           if (error) throw error;
           const row = Array.isArray(data) ? data[0] : data;
           if (row && row.status === "DENIED") {
+            this.logLockEvent("BLOCKED", filePath, agentId, row.owner_id, intent);
             return {
               status: "REQUIRES_ORCHESTRATION",
               message: `Conflict: File '${filePath}' is locked by '${row.owner_id}'`,
@@ -911,6 +940,7 @@ ${notepad}`;
               }
             };
           }
+          this.logLockEvent("GRANTED", filePath, agentId, void 0, intent);
           await this.appendToNotepad(`
 - [LOCK] ${agentId} locked ${filePath}
   Intent: ${intent}`);
@@ -923,6 +953,7 @@ ${notepad}`;
       if (existing) {
         const isStale = Date.now() - existing.timestamp > this.lockTimeout;
         if (!isStale && existing.agentId !== agentId) {
+          this.logLockEvent("BLOCKED", filePath, agentId, existing.agentId, intent);
           return {
             status: "REQUIRES_ORCHESTRATION",
             message: `Conflict: File '${filePath}' is currently locked by '${existing.agentId}'`,
@@ -932,6 +963,7 @@ ${notepad}`;
       }
       this.state.locks[filePath] = { agentId, filePath, intent, userPrompt, timestamp: Date.now() };
       await this.saveState();
+      this.logLockEvent("GRANTED", filePath, agentId, void 0, intent);
       await this.appendToNotepad(`
 - [LOCK] ${agentId} locked ${filePath}
   Intent: ${intent}`);
@@ -1226,8 +1258,52 @@ async function ensureFileSystem() {
       await fs4.mkdir(axisInstructions, { recursive: true }).catch(() => {
       });
       const defaults = [
-        ["context.md", "# Project Context\n\n"],
-        ["conventions.md", "# Coding Conventions\n\n"],
+        ["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.
+
+## 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).
+
+## 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.
+`],
+        ["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.
+
+## Agent Behavioral Norms
+
+### Plan Before Write
+Every non-trivial task must follow: post_job -> claim_next_job -> propose_file_access -> (edit) -> complete_job.
+Skip only for single-line typo fixes.
+
+### Force-Unlock Policy
+force_unlock is a LAST RESORT. Before using it:
+1. Verify the lock is > 25 minutes old.
+2. Confirm the locking agent is unresponsive.
+3. Provide a specific reason string.
+Never casually unlock files \u2014 always try propose_file_access first.
+
+### Proactive Tool Usage
+Agents must use Axis MCP tools by default \u2014 do not wait for the user to say "use Axis".
+On session start, call get_project_soul or read_context to load project state.
+After significant progress, call update_shared_context.
+`],
         ["activity.md", "# Activity Log\n\n"]
       ];
       for (const [file, content] of defaults) {

package/package.json

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