@ryuenn3123/agentic-senior-core 2.0.11 → 2.0.13

package/.cursorrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.0.11
+Generated by Agentic-Senior-Core CLI v2.0.13
 Timestamp: 2026-04-08T14:58:53.570Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.0.11
+Generated by Agentic-Senior-Core CLI v2.0.13
 Timestamp: 2026-04-08T14:58:53.570Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/README.md

@@ -42,20 +42,39 @@ AI:  *Creates properly layered modules with Zod validation, typed errors,
 
 The npm package is already published. For most users, this is the default path.
 
+**Step 1: Navigate to your project folder**
+```bash
+cd /path/to/your-project
+```
+
+**Step 2: Run initialization (does not require install)**
+
+Use `npx` or `npm exec` — both download the package temporarily, run it in your project folder, then clean up automatically.
+
 ```bash
-npm exec --yes @ryuenn3123/agentic-senior-core launch
-npm exec --yes @ryuenn3123/agentic-senior-core init
 npx @ryuenn3123/agentic-senior-core init
+# or
+npm exec --yes @ryuenn3123/agentic-senior-core init
 ```
 
-If you prefer a global install:
+**Alternative: Global install (optional)**
+
+If you want the tool available system-wide without repeating `npx`:
 
 ```bash
 npm install -g @ryuenn3123/agentic-senior-core
+# Then from any project folder:
 agentic-senior-core init
 ```
 
-Use team defaults with profile packs:
+| Approach | Installation | Where to Run | Use Case |
+|----------|--------------|---|---|
+| **npx (default)** | None — temporary download | Inside your project folder | Clearest workflow; no system pollution |
+| **Global install** | System-wide | From anywhere | Convenience if using frequently across many projects |
+
+> Note: Both approaches do the same thing: create `.cursorrules`, `.instructions.md`, `.agent-context/` **in your current project folder**. The only difference is convenience. Use `npx` if unsure — it's clearer and doesn't clutter your system.
+
+**Use team defaults with profile packs:**
 
 ```bash
 npx @ryuenn3123/agentic-senior-core init --profile-pack startup
@@ -118,10 +137,22 @@ npx @ryuenn3123/agentic-senior-core init --newbie
 
 ### Important behavior
 
+- `init` creates governance files **in your project folder** (the folder where you run the command).
 - `init` does not copy repository workflows from this project into your target repository.
 - MCP server registration and trust/start are manual in IDE settings.
 - MCP workspace scaffold is opt-in via `--mcp-template` and creates `.vscode/mcp.json`.
 
+**What files are created?**
+```
+your-project/
+├── .cursorrules          (agent instructions for Cursor)
+├── .windsurfrules        (agent instructions for Windsurf)
+├── .instructions.md      (canonical governance and AI behavior policy)
+├── .agent-context/       (blueprints, skills, rules, profiles, state maps)
+└── .vscode/
+    └── mcp.json          (only if --mcp-template is used)
+```
+
 ### MCP Setup in VS Code (No File Picker)
 
 If you are looking for a file picker in the MCP UI, that is expected because VS Code uses MCP server registration, not generic JSON file import.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "2.0.11",
+  "version": "2.0.13",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {

package/scripts/mcp-server.mjs

@@ -67,32 +67,10 @@ const TOOL_DEFINITIONS = [
 
 let incomingBuffer = Buffer.alloc(0);
 
-function findHeaderTerminator(buffer) {
-  const crlfHeaderEndIndex = buffer.indexOf('\r\n\r\n');
-  if (crlfHeaderEndIndex !== -1) {
-    return {
-      headerEndIndex: crlfHeaderEndIndex,
-      delimiterLength: 4,
-      lineSeparator: '\r\n',
-    };
-  }
-
-  const lfHeaderEndIndex = buffer.indexOf('\n\n');
-  if (lfHeaderEndIndex !== -1) {
-    return {
-      headerEndIndex: lfHeaderEndIndex,
-      delimiterLength: 2,
-      lineSeparator: '\n',
-    };
-  }
-
-  return null;
-}
-
 function writeMessage(payload) {
   const serializedPayload = JSON.stringify(payload);
-  const payloadLength = Buffer.byteLength(serializedPayload, 'utf8');
-  process.stdout.write(`Content-Length: ${payloadLength}\r\n\r\n${serializedPayload}`);
+  // MCP standard: line-delimited JSON (no Content-Length header)
+  process.stdout.write(serializedPayload + '\n');
 }
 
 function sendResponse(id, result) {
@@ -291,69 +269,94 @@ async function handleRequest(requestMessage) {
   }
 }
 
-function readNextFramedMessage() {
-  const headerTerminator = findHeaderTerminator(incomingBuffer);
-  if (!headerTerminator) {
-    return null;
+function processIncomingBuffer() {
+  const fullContent = incomingBuffer.toString('utf8');
+  
+  // Try to parse as line-delimited JSON first (modern MCP standard)
+  let parseMode = 'line-delimited';
+  let contentToProcess = fullContent;
+  
+  // Check if Content-Length header is present (LSP-style for backward compatibility)
+  if (fullContent.includes('Content-Length:')) {
+    parseMode = 'content-length';
   }
-
-  const { headerEndIndex, delimiterLength, lineSeparator } = headerTerminator;
-
-  const rawHeader = incomingBuffer.slice(0, headerEndIndex).toString('utf8');
-  const headerLines = rawHeader.split(lineSeparator);
-  let contentLength = null;
-
-  for (const headerLine of headerLines) {
-    const separatorIndex = headerLine.indexOf(':');
-    if (separatorIndex === -1) {
-      continue;
-    }
-
-    const headerName = headerLine.slice(0, separatorIndex).trim().toLowerCase();
-    const headerValue = headerLine.slice(separatorIndex + 1).trim();
-
-    if (headerName === 'content-length') {
-      contentLength = Number.parseInt(headerValue, 10);
-      break;
+  
+  if (parseMode === 'content-length') {
+    // LSP-style: Parse Content-Length headers
+    const headerTerminatorIndex = Math.max(
+      fullContent.indexOf('\r\n\r\n'),
+      fullContent.indexOf('\n\n')
+    );
+    
+    if (headerTerminatorIndex === -1) {
+      return; // Incomplete header, wait for more data
     }
-  }
-
-  if (!Number.isFinite(contentLength) || contentLength < 0) {
-    incomingBuffer = Buffer.alloc(0);
-    return null;
-  }
-
-  const bodyStartIndex = headerEndIndex + delimiterLength;
-  const frameEndIndex = bodyStartIndex + contentLength;
-
-  if (incomingBuffer.length < frameEndIndex) {
-    return null;
-  }
-
-  const rawMessage = incomingBuffer.slice(bodyStartIndex, frameEndIndex).toString('utf8');
-  incomingBuffer = incomingBuffer.slice(frameEndIndex);
-  return rawMessage;
-}
-
-function processIncomingBuffer() {
-  while (true) {
-    const framedMessage = readNextFramedMessage();
-    if (framedMessage === null) {
+    
+    const headerText = fullContent.slice(0, headerTerminatorIndex);
+    const contentLengthMatch = headerText.match(/Content-Length:\s*(\d+)/i);
+    
+    if (!contentLengthMatch) {
+      incomingBuffer = Buffer.alloc(0);
       return;
     }
-
-    let parsedRequest;
+    
+    const contentLength = parseInt(contentLengthMatch[1], 10);
+    const headerEndLength = fullContent[headerTerminatorIndex] === '\r' ? 4 : 2;
+    const bodyStartIndex = headerTerminatorIndex + headerEndLength;
+    const bodyEndIndex = bodyStartIndex + contentLength;
+    
+    if (fullContent.length < bodyEndIndex) {
+      return; // Body not yet complete
+    }
+    
+    const messageBody = fullContent.slice(bodyStartIndex, bodyEndIndex);
+    incomingBuffer = Buffer.from(fullContent.slice(bodyEndIndex), 'utf8');
+    
     try {
-      parsedRequest = JSON.parse(framedMessage);
+      const parsedRequest = JSON.parse(messageBody);
+      Promise.resolve(handleRequest(parsedRequest)).catch((error) => {
+        if (typeof parsedRequest?.id !== 'undefined') {
+          sendError(parsedRequest.id, -32603, 'Internal error', String(error?.message || error));
+        }
+      });
     } catch {
-      continue;
+      // Ignore parse errors
     }
-
-    Promise.resolve(handleRequest(parsedRequest)).catch((error) => {
-      if (typeof parsedRequest?.id !== 'undefined') {
-        sendError(parsedRequest.id, -32603, 'Internal error', String(error?.message || error));
+    
+    // Recursively process if there's more data
+    if (incomingBuffer.length > 0) {
+      processIncomingBuffer();
+    }
+  } else {
+    // Line-delimited: parse one JSON per line
+    const lines = fullContent.split('\n');
+    
+    // Keep incomplete last line in buffer
+    if (fullContent.endsWith('\n')) {
+      incomingBuffer = Buffer.alloc(0);
+    } else {
+      const lastLine = lines.pop() || '';
+      incomingBuffer = Buffer.from(lastLine, 'utf8');
+    }
+    
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      
+      let parsedRequest;
+      try {
+        parsedRequest = JSON.parse(trimmed);
+      } catch {
+        // Ignore non-JSON lines
+        continue;
       }
-    });
+      
+      Promise.resolve(handleRequest(parsedRequest)).catch((error) => {
+        if (typeof parsedRequest?.id !== 'undefined') {
+          sendError(parsedRequest.id, -32603, 'Internal error', String(error?.message || error));
+        }
+      });
+    }
   }
 }