@ryuenn3123/agentic-senior-core 2.0.8 → 2.0.9

package/.cursorrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.0.8
+Generated by Agentic-Senior-Core CLI v2.0.9
 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.8
+Generated by Agentic-Senior-Core CLI v2.0.9
 Timestamp: 2026-04-08T14:58:53.570Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/README.md

@@ -121,8 +121,23 @@ The CLI is smart. It auto-detects your current development stack, helps you buil
 
 Important behavior:
 - `init` does not copy repository workflows from this project into your target repository.
-- MCP server registration is manual in IDE settings.
-- If you want the MCP file scaffold, run `init` with `--mcp-template`.
+- MCP server registration and trust/start are managed manually in IDE settings.
+- If you want the MCP workspace scaffold, run `init` with `--mcp-template` (creates `.vscode/mcp.json`).
+
+### 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.
+
+1. Generate workspace MCP config:
+
+```bash
+npx @ryuenn3123/agentic-senior-core init --mcp-template
+```
+
+2. Open Command Palette and run `MCP: Open Workspace Folder Configuration`.
+3. Confirm the file is `.vscode/mcp.json` with server `agentic-senior-core`.
+4. The generated server command is `npx -y @ryuenn3123/agentic-senior-core mcp`.
+5. Open Chat Customizations > MCP Servers, then trust/start the server.
 
 If you are totally new to concepts like blueprints and guardrails, no problem — just run:
 ```bash
@@ -270,8 +285,8 @@ Our documentation has shifted into dedicated tracks to keep this README light:
 - **Automated Guardrails:** CI blueprints include LLM-as-a-Judge flow using `pr-checklist.md`.
 - **Pre-Publish Safety:** Built-in forbidden content checks detect hardcoded secrets and stray debugger artifacts before hitting the NPM registry.
 - **Machine-Readable CI Output:** LLM Judge emits `JSON_REPORT` payloads and writes `.agent-context/state/llm-judge-report.json` for PR/MR annotation tooling.
-- **MCP Self-Healing Loop:** `mcp.json` defines diagnostics + fix proposal workflow when lint/CI fails.
-- **MCP Registration Model:** IDE MCP server registration is manual; `mcp.json` is an optional template file (`--mcp-template`).
+- **MCP Runtime Server:** `scripts/mcp-server.mjs` exposes validate/test/release checks as MCP tools.
+- **MCP Registration Model:** IDE MCP server registration is manual; workspace config lives in `.vscode/mcp.json` (`--mcp-template`).
 
 ---
 
@@ -282,7 +297,9 @@ Our documentation has shifted into dedicated tracks to keep this README light:
 ├── .cursorrules                    # Dynamic compiled governance entry point
 ├── .windsurfrules                  # Dynamic compiled governance entry point
 ├── .agent-override.md              # Team-specific exceptions (scoped + expiry)
-├── mcp.json                        # Optional MCP template file (copied with --mcp-template)
+├── mcp.json                        # Governance metadata and knowledge-layer contract
+├── .vscode/
+│   └── mcp.json                    # VS Code MCP workspace server configuration
 ├── AGENTS.md                       # Universal agent discovery
 ├── .github/copilot-instructions.md # GitHub Copilot entry point
 ├── .gemini/instructions.md         # Antigravity / Gemini entry point
@@ -300,6 +317,7 @@ Our documentation has shifted into dedicated tracks to keep this README light:
 ├── scripts/
 │   ├── validate.mjs                # Repository validator
 │   ├── llm-judge.mjs               # LLM-as-a-Judge CI gate
+│   ├── mcp-server.mjs              # Local MCP stdio server (validate/test/release tools)
 │   ├── init-project.sh             # GitHub bootstrap script (Linux/macOS)
 │   └── init-project.ps1            # GitHub bootstrap script (Windows)
 ├── docs/

package/bin/agentic-senior-core.js

@@ -11,6 +11,7 @@ import { CLI_VERSION } from '../lib/cli/constants.mjs';
 import { printUsage } from '../lib/cli/utils.mjs';
 import { runLaunchCommand } from '../lib/cli/commands/launch.mjs';
 import { runRollbackCommand } from '../lib/cli/commands/rollback.mjs';
+import { runMcpServerCommand } from '../lib/cli/commands/mcp.mjs';
 import { runOptimizeCommand, parseOptimizeArguments } from '../lib/cli/commands/optimize.mjs';
 import { runInitCommand, parseInitArguments } from '../lib/cli/commands/init.mjs';
 import { runUpgradeCommand, parseUpgradeArguments } from '../lib/cli/commands/upgrade.mjs';
@@ -63,6 +64,11 @@ async function main() {
     return;
   }
 
+  if (commandArgument === 'mcp') {
+    await runMcpServerCommand();
+    return;
+  }
+
   console.error(`Unknown command: ${commandArgument}`);
   printUsage();
   exit(1);

package/lib/cli/commands/init.mjs

@@ -429,7 +429,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     console.log(`- Setup time: ${formatDuration(setupDurationMs)}`);
     console.log('- Generated files: .cursorrules, .windsurfrules, and .agent-context/state/onboarding-report.json');
     console.log(`- Repository workflows copied: no (workflows remain source-repo assets)`);
-    console.log(`- MCP template file: ${shouldIncludeMcpTemplate ? 'copied (mcp.json)' : 'not copied by default (use --mcp-template)'}`);
+    console.log(`- MCP template file: ${shouldIncludeMcpTemplate ? 'created (.vscode/mcp.json)' : 'not created by default (use --mcp-template)'}`);
     if (isTokenOptimizationEnabled) {
       console.log(`- Token optimization policy: enabled for ${selectedTokenAgentName}`);
     } else {

package/lib/cli/commands/mcp.mjs

@@ -0,0 +1,3 @@
+export async function runMcpServerCommand() {
+  await import('../../../scripts/mcp-server.mjs');
+}

package/lib/cli/utils.mjs

@@ -31,6 +31,7 @@ export function printUsage() {
   console.log('  agentic-senior-core init [target-directory] [--preset <name>] [--profile <beginner|balanced|strict>] [--profile-pack <name>] [--stack <name>] [--blueprint <name>] [--ci <true|false>] [--newbie] [--token-optimize] [--no-token-optimize] [--token-agent <name>]');
   console.log('  agentic-senior-core upgrade [target-directory] [--dry-run] [--yes] [--mcp-template]');
   console.log('  agentic-senior-core optimize [target-directory] [--agent <copilot|claude|cursor|windsurf|gemini|codex|cline>] [--enable|--disable] [--show]');
+  console.log('  agentic-senior-core mcp');
   console.log('  agentic-senior-core rollback [target-directory]');
   console.log('  agentic-senior-core skill [domain] [--tier <standard|advance|expert|above>] [--json]');
   console.log('  agentic-senior-core --version');
@@ -48,7 +49,7 @@ export function printUsage() {
   console.log('  --token-optimize  Explicitly enable token optimization policy during init (default behavior)');
   console.log('  --token-agent     Set token optimization agent target (copilot, claude, cursor, windsurf, gemini, codex, cline)');
   console.log('  --no-token-optimize  Disable token optimization policy during init');
-  console.log('  --mcp-template   Also copy mcp.json template (MCP server registration in IDE is still manual)');
+  console.log('  --mcp-template   Create .vscode/mcp.json workspace template (MCP trust/start remains manual in IDE)');
   console.log('  --dry-run    Preview upgrade without writing files');
   console.log('  --yes        Skip confirmation prompts for upgrade');
   console.log('  --agent      Target agent integration for token optimization mode');
@@ -129,14 +130,27 @@ export async function copyGovernanceAssetsToTarget(
   }
 
   if (shouldIncludeMcpTemplate) {
-    const sourceMcpPath = path.join(REPO_ROOT, 'mcp.json');
-    const targetMcpPath = path.join(resolvedTargetDirectoryPath, 'mcp.json');
-
-    if (
-      await pathExists(sourceMcpPath)
-      && path.resolve(sourceMcpPath) !== path.resolve(targetMcpPath)
-    ) {
-      await fs.copyFile(sourceMcpPath, targetMcpPath);
+    const vscodeDirectoryPath = path.join(resolvedTargetDirectoryPath, '.vscode');
+    const workspaceMcpConfigurationPath = path.join(vscodeDirectoryPath, 'mcp.json');
+
+    const workspaceMcpConfiguration = {
+      $schema: 'vscode://schemas/mcp',
+      servers: {
+        'agentic-senior-core': {
+          type: 'stdio',
+          command: 'npx',
+          args: ['-y', '@ryuenn3123/agentic-senior-core', 'mcp'],
+        },
+      },
+    };
+
+    if (!(await pathExists(workspaceMcpConfigurationPath))) {
+      await ensureDirectory(vscodeDirectoryPath);
+      await fs.writeFile(
+        workspaceMcpConfigurationPath,
+        JSON.stringify(workspaceMcpConfiguration, null, 2) + '\n',
+        'utf8'
+      );
     }
   }
 }

package/mcp.json

@@ -1,5 +1,4 @@
 {
-  "$schema": "https://modelcontextprotocol.io/schemas/mcp.json",
   "version": "1.0",
   "name": "agentic-senior-core",
   "description": "MCP configuration for governance-aware diagnostics and self-healing workflows with full knowledge injection.",

package/package.json

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

package/scripts/mcp-server.mjs

@@ -0,0 +1,347 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
+const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '..');
+const PACKAGE_VERSION = JSON.parse(
+  readFileSync(resolve(REPOSITORY_ROOT, 'package.json'), 'utf8')
+).version;
+const DEFAULT_PROTOCOL_VERSION = '2024-11-05';
+
+const TEST_SUITE_ARGS = {
+  full: ['--test', './tests/cli-smoke.test.mjs', './tests/llm-judge.test.mjs', './tests/enterprise-ops.test.mjs', './tests/skill-tier-gate.test.mjs'],
+  cli: ['--test', './tests/cli-smoke.test.mjs'],
+  enterprise: ['--test', './tests/enterprise-ops.test.mjs'],
+  'llm-judge': ['--test', './tests/llm-judge.test.mjs'],
+  'skill-tier': ['--test', './tests/skill-tier-gate.test.mjs'],
+};
+
+const TOOL_DEFINITIONS = [
+  {
+    name: 'validate',
+    description: 'Run repository validation checks.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      additionalProperties: false,
+    },
+  },
+  {
+    name: 'test',
+    description: 'Run test suites (full or targeted).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        suite: {
+          type: 'string',
+          enum: ['full', 'cli', 'enterprise', 'llm-judge', 'skill-tier'],
+          description: 'Target test suite. Defaults to full.',
+        },
+      },
+      additionalProperties: false,
+    },
+  },
+  {
+    name: 'release_gate',
+    description: 'Run release gate checks.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      additionalProperties: false,
+    },
+  },
+  {
+    name: 'forbidden_content_check',
+    description: 'Run forbidden content scan used by publish gate.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      additionalProperties: false,
+    },
+  },
+];
+
+let incomingBuffer = Buffer.alloc(0);
+
+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}`);
+}
+
+function sendResponse(id, result) {
+  writeMessage({
+    jsonrpc: '2.0',
+    id,
+    result,
+  });
+}
+
+function sendError(id, code, message, data) {
+  writeMessage({
+    jsonrpc: '2.0',
+    id,
+    error: {
+      code,
+      message,
+      data,
+    },
+  });
+}
+
+function normalizeToolName(rawToolName) {
+  return typeof rawToolName === 'string' ? rawToolName.trim() : '';
+}
+
+function buildCommandOutput(commandLabel, commandArguments, exitCode, stdoutContent, stderrContent) {
+  const outputSections = [
+    `Command: node ${commandArguments.join(' ')}`,
+    `Exit code: ${exitCode}`,
+  ];
+
+  if (stdoutContent.trim().length > 0) {
+    outputSections.push(`STDOUT:\n${stdoutContent.trimEnd()}`);
+  }
+
+  if (stderrContent.trim().length > 0) {
+    outputSections.push(`STDERR:\n${stderrContent.trimEnd()}`);
+  }
+
+  return [
+    `[${commandLabel}]`,
+    outputSections.join('\n\n'),
+  ].join('\n\n');
+}
+
+function runNodeCommand(commandLabel, commandArguments) {
+  return new Promise((resolveResult) => {
+    const childProcess = spawn(process.execPath, commandArguments, {
+      cwd: REPOSITORY_ROOT,
+      env: process.env,
+    });
+
+    let stdoutContent = '';
+    let stderrContent = '';
+
+    childProcess.stdout.on('data', (chunk) => {
+      stdoutContent += chunk.toString('utf8');
+    });
+
+    childProcess.stderr.on('data', (chunk) => {
+      stderrContent += chunk.toString('utf8');
+    });
+
+    childProcess.on('error', (error) => {
+      resolveResult({
+        content: [
+          {
+            type: 'text',
+            text: `[${commandLabel}] Failed to start command: ${error.message}`,
+          },
+        ],
+        isError: true,
+      });
+    });
+
+    childProcess.on('close', (exitCode) => {
+      const normalizedExitCode = typeof exitCode === 'number' ? exitCode : 1;
+      resolveResult({
+        content: [
+          {
+            type: 'text',
+            text: buildCommandOutput(
+              commandLabel,
+              commandArguments,
+              normalizedExitCode,
+              stdoutContent,
+              stderrContent
+            ),
+          },
+        ],
+        isError: normalizedExitCode !== 0,
+      });
+    });
+  });
+}
+
+async function executeToolCall(toolName, toolArguments = {}) {
+  if (toolName === 'validate') {
+    return runNodeCommand('validate', ['./scripts/validate.mjs']);
+  }
+
+  if (toolName === 'test') {
+    const requestedSuite = typeof toolArguments.suite === 'string'
+      ? toolArguments.suite
+      : 'full';
+
+    const selectedSuite = TEST_SUITE_ARGS[requestedSuite] ? requestedSuite : 'full';
+    return runNodeCommand(`test:${selectedSuite}`, TEST_SUITE_ARGS[selectedSuite]);
+  }
+
+  if (toolName === 'release_gate') {
+    return runNodeCommand('release_gate', ['./scripts/release-gate.mjs']);
+  }
+
+  if (toolName === 'forbidden_content_check') {
+    return runNodeCommand('forbidden_content_check', ['./scripts/forbidden-content-check.mjs']);
+  }
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text: `Unknown tool: ${toolName}`,
+      },
+    ],
+    isError: true,
+  };
+}
+
+async function handleRequest(requestMessage) {
+  const requestId = requestMessage.id;
+  const requestMethod = requestMessage.method;
+  const requestParams = requestMessage.params || {};
+
+  if (typeof requestMethod !== 'string') {
+    if (typeof requestId !== 'undefined') {
+      sendError(requestId, -32600, 'Invalid Request');
+    }
+    return;
+  }
+
+  if (requestMethod === 'initialize') {
+    const negotiatedProtocolVersion = typeof requestParams.protocolVersion === 'string'
+      ? requestParams.protocolVersion
+      : DEFAULT_PROTOCOL_VERSION;
+
+    sendResponse(requestId, {
+      protocolVersion: negotiatedProtocolVersion,
+      capabilities: {
+        tools: {
+          listChanged: false,
+        },
+      },
+      serverInfo: {
+        name: 'agentic-senior-core',
+        version: PACKAGE_VERSION,
+      },
+    });
+    return;
+  }
+
+  if (requestMethod === 'notifications/initialized') {
+    return;
+  }
+
+  if (requestMethod === 'ping') {
+    if (typeof requestId !== 'undefined') {
+      sendResponse(requestId, {});
+    }
+    return;
+  }
+
+  if (requestMethod === 'tools/list') {
+    sendResponse(requestId, {
+      tools: TOOL_DEFINITIONS,
+    });
+    return;
+  }
+
+  if (requestMethod === 'tools/call') {
+    const requestedToolName = normalizeToolName(requestParams.name);
+
+    if (!requestedToolName) {
+      sendError(requestId, -32602, 'Invalid params: tool name is required');
+      return;
+    }
+
+    const toolResult = await executeToolCall(requestedToolName, requestParams.arguments || {});
+    sendResponse(requestId, toolResult);
+    return;
+  }
+
+  if (typeof requestId !== 'undefined') {
+    sendError(requestId, -32601, `Method not found: ${requestMethod}`);
+  }
+}
+
+function readNextFramedMessage() {
+  const headerEndIndex = incomingBuffer.indexOf('\r\n\r\n');
+  if (headerEndIndex === -1) {
+    return null;
+  }
+
+  const rawHeader = incomingBuffer.slice(0, headerEndIndex).toString('utf8');
+  const headerLines = rawHeader.split('\r\n');
+  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 (!Number.isFinite(contentLength) || contentLength < 0) {
+    incomingBuffer = Buffer.alloc(0);
+    return null;
+  }
+
+  const bodyStartIndex = headerEndIndex + 4;
+  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) {
+      return;
+    }
+
+    let parsedRequest;
+    try {
+      parsedRequest = JSON.parse(framedMessage);
+    } catch {
+      continue;
+    }
+
+    Promise.resolve(handleRequest(parsedRequest)).catch((error) => {
+      if (typeof parsedRequest?.id !== 'undefined') {
+        sendError(parsedRequest.id, -32603, 'Internal error', String(error?.message || error));
+      }
+    });
+  }
+}
+
+process.stdin.on('data', (chunk) => {
+  incomingBuffer = Buffer.concat([incomingBuffer, chunk]);
+  processIncomingBuffer();
+});
+
+process.stdin.on('end', () => {
+  process.exit(0);
+});
+
+process.on('SIGINT', () => {
+  process.exit(0);
+});

package/scripts/validate.mjs

@@ -151,6 +151,7 @@ async function validateRequiredFiles() {
     'scripts/benchmark-gate.mjs',
     'scripts/benchmark-intelligence.mjs',
     'scripts/governance-weekly-report.mjs',
+    'scripts/mcp-server.mjs',
     'scripts/frontend-usability-audit.mjs',
     'scripts/release-gate.mjs',
     'scripts/generate-sbom.mjs',
@@ -175,6 +176,7 @@ async function validateRequiredFiles() {
     '.agent-context/state/benchmark-watchlist.json',
     '.agent-context/state/skill-platform.json',
     '.agent-context/skills/index.json',
+    '.vscode/mcp.json',
     '.github/workflows/release-gate.yml',
     '.github/workflows/sbom-compliance.yml',
     '.github/workflows/benchmark-intelligence.yml',
@@ -700,6 +702,8 @@ async function validateMcpConfiguration() {
   const mcpConfiguration = JSON.parse(await readTextFile(join(ROOT_DIR, 'mcp.json')));
   const lintServerCommand = mcpConfiguration.servers?.lint?.command;
   const testServerCommand = mcpConfiguration.servers?.test?.command;
+  const workspaceMcpConfiguration = JSON.parse(await readTextFile(join(ROOT_DIR, '.vscode', 'mcp.json')));
+  const workspaceServerConfig = workspaceMcpConfiguration.servers?.['agentic-senior-core'];
 
   if (lintServerCommand === 'node') {
     pass('MCP lint server uses Node');
@@ -712,6 +716,24 @@ async function validateMcpConfiguration() {
   } else {
     fail('MCP test server must use Node');
   }
+
+  if (workspaceMcpConfiguration.$schema === 'vscode://schemas/mcp') {
+    pass('Workspace MCP config uses trusted VS Code schema');
+  } else {
+    fail('Workspace MCP config must use $schema: vscode://schemas/mcp');
+  }
+
+  if (workspaceServerConfig?.command === 'node') {
+    pass('Workspace MCP server command uses Node');
+  } else {
+    fail('Workspace MCP server command must use Node');
+  }
+
+  if (Array.isArray(workspaceServerConfig?.args) && workspaceServerConfig.args.includes('./scripts/mcp-server.mjs')) {
+    pass('Workspace MCP server points to scripts/mcp-server.mjs');
+  } else {
+    fail('Workspace MCP server must include ./scripts/mcp-server.mjs argument');
+  }
 }
 
 async function validateHumanWritingGovernance() {