@ryuenn3123/agentic-senior-core 2.0.9 → 2.0.11

package/.cursorrules

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

package/README.md

@@ -38,54 +38,45 @@ AI:  *Creates properly layered modules with Zod validation, typed errors,
 
 ## Quick Start
 
-### Zero-Install: GitHub Template (New user friendly!)
+### Method 1 (Recommended): npm package
 
-The absolute fastest way to start your next top-tier project is to use this repository as a template.
-The **Use this template** button is in the GitHub repository header (top-right area), not inside this README text.
-If you prefer a direct link, open: **[Create from template](https://github.com/fatidaprilian/Agentic-Senior-Core/generate)**.
-Your new repository will instantly possess all the rules, configurations, and AI context files directly out of the box — zero CLI needed.
-
-### Option 0: NPM Install (Local or Global)
-
-If you already know you want the CLI from npm, use one of these paths:
+The npm package is already published. For most users, this is the default path.
 
 ```bash
+npm exec --yes @ryuenn3123/agentic-senior-core launch
 npm exec --yes @ryuenn3123/agentic-senior-core init
-npm install -g @ryuenn3123/agentic-senior-core
-agentic-senior-core init
+npx @ryuenn3123/agentic-senior-core init
 ```
 
-### Option 1: Interactive via GitHub Source (Pre-publish friendly)
-
-If npm package publication is not ready yet, run the CLI directly from GitHub and still keep the full interactive experience.
+If you prefer a global install:
 
 ```bash
-npm exec --yes --package=github:fatidaprilian/Agentic-Senior-Core agentic-senior-core init .
+npm install -g @ryuenn3123/agentic-senior-core
+agentic-senior-core init
 ```
 
-This gives the same interactive prompts to choose your profile (`beginner`, `balanced`, `strict`), stack, blueprint, and CI guardrails.
-
-If you want a plug-and-play starter instead of answering every question, use a preset:
+Use team defaults with profile packs:
 
 ```bash
-npx @ryuenn3123/agentic-senior-core init --preset frontend-web
-npx @ryuenn3123/agentic-senior-core init --preset backend-api
-npx @ryuenn3123/agentic-senior-core init --preset mobile-react-native
-npx @ryuenn3123/agentic-senior-core init --preset java-enterprise-api
-npx @ryuenn3123/agentic-senior-core init --preset dotnet-enterprise-api
+npx @ryuenn3123/agentic-senior-core init --profile-pack startup
 ```
 
-Expanded preset catalog:
+### Method 2: GitHub template and source execution
 
-- `frontend-web`, `backend-api`, `fullstack-product`, `platform-governance`
-- `mobile-react-native`, `mobile-flutter`, `observability-platform`
-- `typescript-nestjs-service`, `java-enterprise-api`, `dotnet-enterprise-api`, `php-laravel-api`, `kubernetes-platform`
+Use this method if your team prefers source-based bootstrap or template-first onboarding.
 
-### Option 2: GitHub Bootstrap Scripts (No npx required)
+GitHub template:
+- **[Create from template](https://github.com/fatidaprilian/Agentic-Senior-Core/generate)**
 
-Run directly from this repository bootstrap script and inject rules into your project root.
+GitHub source execution (interactive):
 
-Bootstrap script paths: `scripts/init-project.ps1` (Windows) and `scripts/init-project.sh` (Linux/macOS).
+```bash
+npm exec --yes --package=github:fatidaprilian/Agentic-Senior-Core agentic-senior-core init .
+```
+
+GitHub bootstrap scripts:
+- Windows: `scripts/init-project.ps1`
+- Linux/macOS: `scripts/init-project.sh`
 
 Windows PowerShell:
 
@@ -99,30 +90,37 @@ Linux/macOS Bash:
 bash ./scripts/init-project.sh . --profile balanced --stack typescript --blueprint api-nextjs --ci true
 ```
 
-Both scripts clone Agentic-Senior-Core into a temporary directory, run the same CLI engine, then clean up automatically.
-
-If you want interactive selection, omit `-Profile`, `-Stack`, `-Blueprint`, and `-Ci` on the script command.
-
-### Option 3: Interactive Auto-Setup via npm/npx (Post-publish)
+### Preset starters
 
-If you have an existing project and want to infuse it with Staff-level context:
+Use presets when you want faster onboarding with less manual selection.
 
 ```bash
-npx @ryuenn3123/agentic-senior-core init
+npx @ryuenn3123/agentic-senior-core init --preset frontend-web
+npx @ryuenn3123/agentic-senior-core init --preset backend-api
+npx @ryuenn3123/agentic-senior-core init --preset mobile-react-native
+npx @ryuenn3123/agentic-senior-core init --preset java-enterprise-api
+npx @ryuenn3123/agentic-senior-core init --preset dotnet-enterprise-api
 ```
 
-Use team defaults (V2.0 track) with profile packs:
+Expanded preset catalog:
+
+- `frontend-web`, `backend-api`, `fullstack-product`, `platform-governance`
+- `mobile-react-native`, `mobile-flutter`, `observability-platform`
+- `typescript-nestjs-service`, `java-enterprise-api`, `dotnet-enterprise-api`, `php-laravel-api`, `kubernetes-platform`
+
+### Newbie mode
+
+If you are new to stacks, blueprints, and guardrails, run:
 
 ```bash
-npx @ryuenn3123/agentic-senior-core init --profile-pack startup
+npx @ryuenn3123/agentic-senior-core init --newbie
 ```
 
-The CLI is smart. It auto-detects your current development stack, helps you build a governance profile (select from `beginner`, `balanced`, or `strict`), and writes the compiled rules straight to your root automatically!
+### Important behavior
 
-Important behavior:
 - `init` does not copy repository workflows from this project into your target repository.
-- 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 server registration and trust/start are manual in IDE settings.
+- MCP workspace scaffold is opt-in via `--mcp-template` and creates `.vscode/mcp.json`.
 
 ### MCP Setup in VS Code (No File Picker)
 
@@ -136,13 +134,25 @@ 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`.
+4. The generated server command is `node ./scripts/mcp-server.mjs` with `cwd` set to `${workspaceFolder}`.
 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
-npx @ryuenn3123/agentic-senior-core init --newbie
-```
+If logs repeatedly show `Waiting for server to respond to initialize request`, upgrade to the latest package version, regenerate the workspace config with `--mcp-template`, and restart the MCP server.
+
+### CLI Command Reference
+
+All available commands:
+
+| Command | Purpose | Example |
+|---------|---------|---------|
+| `launch` | Numbered onboarding launcher | `agentic-senior-core launch` |
+| `init` | Initialize governance in a project | `agentic-senior-core init . --profile balanced` |
+| `upgrade` | Upgrade existing governance safely | `agentic-senior-core upgrade . --dry-run` |
+| `optimize` | Manage token optimization profile | `agentic-senior-core optimize . --show` |
+| `mcp` | Start local MCP stdio server runtime | `agentic-senior-core mcp` |
+| `rollback` | Roll back from backup snapshot | `agentic-senior-core rollback .` |
+| `skill` | Select domain skill pack by tier | `agentic-senior-core skill frontend --tier advance` |
+| `--version` | Print CLI version | `agentic-senior-core --version` |
 
 ### Skill Selector
 
@@ -355,6 +365,19 @@ npm run report:quality-trend
 npm run report:governance-weekly
 ```
 
+## Release and npm Publish Flow
+
+This repository publishes to npm automatically through GitHub Actions on every push to `main`.
+
+Release checklist:
+1. Bump `package.json` version.
+2. Add matching release notes in `CHANGELOG.md`.
+3. Push to `main`.
+
+Important notes for maintainers and forks:
+- If the npm version already exists, publish will fail.
+- Publish requires valid `NPM_TOKEN` in repository secrets.
+
 ---
 
 ## Roadmap
@@ -380,7 +403,7 @@ npm run report:governance-weekly
 
 ### Current Forward Plan
 - V2.0: Skill marketplace trust tiers, transactional installs, rollback safety, and launch-menu onboarding.
-- V2.5: Cross-model benchmark harness and anti-regression quality gates.
+- V2.5: Cross-model benchmark harness, anti-regression quality gates, and advanced frontend design quality track (non-template UI direction, stronger UX craft, and frontend parity beyond baseline benchmark repos).
 - V3.0: Enterprise governance cloud, policy drift detection, and org-level override registry.
 
 Detailed timeline and success metrics: [docs/roadmap.md](docs/roadmap.md)

package/lib/cli/utils.mjs

@@ -138,8 +138,9 @@ export async function copyGovernanceAssetsToTarget(
       servers: {
         'agentic-senior-core': {
           type: 'stdio',
-          command: 'npx',
-          args: ['-y', '@ryuenn3123/agentic-senior-core', 'mcp'],
+          command: 'node',
+          cwd: '${workspaceFolder}',
+          args: ['./scripts/mcp-server.mjs'],
         },
       },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "2.0.9",
+  "version": "2.0.11",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {
@@ -53,6 +53,6 @@
     "report:quality-trend": "node ./scripts/quality-trend-report.mjs",
     "report:governance-weekly": "node ./scripts/governance-weekly-report.mjs",
     "validate": "node ./scripts/validate.mjs",
-    "test": "node --test ./tests/cli-smoke.test.mjs ./tests/llm-judge.test.mjs ./tests/enterprise-ops.test.mjs ./tests/skill-tier-gate.test.mjs"
+    "test": "node --test ./tests/cli-smoke.test.mjs ./tests/mcp-server.test.mjs ./tests/llm-judge.test.mjs ./tests/enterprise-ops.test.mjs ./tests/skill-tier-gate.test.mjs"
   }
 }

package/scripts/mcp-server.mjs

@@ -67,6 +67,28 @@ 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');
@@ -270,13 +292,15 @@ async function handleRequest(requestMessage) {
 }
 
 function readNextFramedMessage() {
-  const headerEndIndex = incomingBuffer.indexOf('\r\n\r\n');
-  if (headerEndIndex === -1) {
+  const headerTerminator = findHeaderTerminator(incomingBuffer);
+  if (!headerTerminator) {
     return null;
   }
 
+  const { headerEndIndex, delimiterLength, lineSeparator } = headerTerminator;
+
   const rawHeader = incomingBuffer.slice(0, headerEndIndex).toString('utf8');
-  const headerLines = rawHeader.split('\r\n');
+  const headerLines = rawHeader.split(lineSeparator);
   let contentLength = null;
 
   for (const headerLine of headerLines) {
@@ -299,7 +323,7 @@ function readNextFramedMessage() {
     return null;
   }
 
-  const bodyStartIndex = headerEndIndex + 4;
+  const bodyStartIndex = headerEndIndex + delimiterLength;
   const frameEndIndex = bodyStartIndex + contentLength;
 
   if (incomingBuffer.length < frameEndIndex) {

package/scripts/validate.mjs

@@ -182,6 +182,7 @@ async function validateRequiredFiles() {
     '.github/workflows/benchmark-intelligence.yml',
     '.github/workflows/governance-weekly-report.yml',
     'tests/cli-smoke.test.mjs',
+    'tests/mcp-server.test.mjs',
     'tests/llm-judge.test.mjs',
     'tests/enterprise-ops.test.mjs',
     'LICENSE',
@@ -729,6 +730,12 @@ async function validateMcpConfiguration() {
     fail('Workspace MCP server command must use Node');
   }
 
+  if (workspaceServerConfig?.cwd === '${workspaceFolder}') {
+    pass('Workspace MCP server cwd uses ${workspaceFolder}');
+  } else {
+    fail('Workspace MCP server cwd must be ${workspaceFolder}');
+  }
+
   if (Array.isArray(workspaceServerConfig?.args) && workspaceServerConfig.args.includes('./scripts/mcp-server.mjs')) {
     pass('Workspace MCP server points to scripts/mcp-server.mjs');
   } else {