@ryuenn3123/agentic-senior-core 1.8.0

package/mcp.json

@@ -0,0 +1,29 @@
+{
+  "$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.",
+  "servers": {
+    "lint": {
+      "command": "node",
+      "args": ["./scripts/validate.mjs"],
+      "transport": "stdio"
+    },
+    "test": {
+      "command": "node",
+      "args": ["--test", "./tests/cli-smoke.test.mjs", "./tests/llm-judge.test.mjs"],
+      "transport": "stdio"
+    }
+  },
+  "workflows": {
+    "self-heal-on-failure": {
+      "trigger": ["ci.failure", "lint.failure"],
+      "steps": [
+        "collect_logs",
+        "map_violation_to_rule",
+        "propose_patch",
+        "run_checklist_review"
+      ]
+    }
+  }
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ryuenn3123/agentic-senior-core",
+  "version": "1.8.0",
+  "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
+  "bin": {
+    "agentic-senior-core": "bin/agentic-senior-core.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    ".agent-context/",
+    ".agents/",
+    ".github/",
+    ".gemini/",
+    ".cursorrules",
+    ".windsurfrules",
+    "AGENTS.md",
+    ".agent-override.md",
+    "mcp.json",
+    "README.md",
+    "LICENSE",
+    "CONTRIBUTING.md"
+  ],
+  "author": "fatidaprilian",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fatidaprilian/Agentic-Senior-Core.git"
+  },
+  "keywords": [
+    "ai",
+    "coding-standards",
+    "cursorrules",
+    "windsurf",
+    "copilot",
+    "antigravity",
+    "clean-code",
+    "engineering-standards",
+    "agentic"
+  ],
+  "scripts": {
+    "init": "node ./bin/agentic-senior-core.js init",
+    "audit:frontend-usability": "node ./scripts/frontend-usability-audit.mjs",
+    "gate:release": "node ./scripts/release-gate.mjs",
+    "sbom:generate": "node ./scripts/generate-sbom.mjs",
+    "benchmark:detection": "node ./scripts/detection-benchmark.mjs",
+    "validate": "node ./scripts/validate.mjs",
+    "test": "node --test ./tests/cli-smoke.test.mjs ./tests/llm-judge.test.mjs ./tests/enterprise-ops.test.mjs"
+  }
+}

package/scripts/detection-benchmark.mjs

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+
+/**
+ * detection-benchmark.mjs
+ *
+ * Lightweight benchmark for stack detection heuristics used by the CLI.
+ * Publishes top-1 accuracy and manual-correction-rate proxy.
+ */
+
+const BLUEPRINT_RECOMMENDATIONS = {
+  'typescript.md': 'api-nextjs.md',
+  'python.md': 'fastapi-service.md',
+  'java.md': 'spring-boot-api.md',
+  'php.md': 'laravel-api.md',
+  'go.md': 'go-service.md',
+  'csharp.md': 'aspnet-api.md',
+};
+
+const AMBIGUITY_THRESHOLD = 0.08;
+
+const BENCHMARK_FIXTURES = [
+  { fixtureName: 'typescript-basic', markers: ['package.json', 'tsconfig.json'], expectedStack: 'typescript.md' },
+  { fixtureName: 'typescript-next', markers: ['package.json', 'tsconfig.json', 'next.config.js'], expectedStack: 'typescript.md' },
+  { fixtureName: 'python-poetry', markers: ['pyproject.toml'], expectedStack: 'python.md' },
+  { fixtureName: 'python-requirements', markers: ['requirements.txt'], expectedStack: 'python.md' },
+  { fixtureName: 'java-maven', markers: ['pom.xml'], expectedStack: 'java.md' },
+  { fixtureName: 'java-gradle', markers: ['build.gradle'], expectedStack: 'java.md' },
+  { fixtureName: 'php-composer', markers: ['composer.json'], expectedStack: 'php.md' },
+  { fixtureName: 'go-module', markers: ['go.mod'], expectedStack: 'go.md' },
+  { fixtureName: 'dotnet-solution', markers: ['app.sln'], expectedStack: 'csharp.md' },
+  { fixtureName: 'rust-cargo', markers: ['Cargo.toml'], expectedStack: 'rust.md' },
+  { fixtureName: 'ruby-gemfile', markers: ['Gemfile'], expectedStack: 'ruby.md' },
+  { fixtureName: 'mixed-ts-python', markers: ['package.json', 'tsconfig.json', 'pyproject.toml'], expectedStack: 'typescript.md' },
+];
+
+function detectProjectFromMarkers(markers) {
+  const markerNames = new Set(markers);
+  const candidates = [];
+
+  if (markerNames.has('package.json') || markerNames.has('tsconfig.json') || markerNames.has('next.config.js') || markerNames.has('next.config.mjs')) {
+    let confidenceScore = 0.7;
+    if (markerNames.has('package.json')) confidenceScore += 0.12;
+    if (markerNames.has('tsconfig.json')) confidenceScore += 0.12;
+    if (markerNames.has('next.config.js') || markerNames.has('next.config.mjs')) confidenceScore += 0.05;
+    candidates.push({ stackFileName: 'typescript.md', confidenceScore: Math.min(confidenceScore, 0.97) });
+  }
+
+  if (markerNames.has('pyproject.toml') || markerNames.has('requirements.txt')) {
+    candidates.push({
+      stackFileName: 'python.md',
+      confidenceScore: markerNames.has('pyproject.toml') ? 0.96 : 0.78,
+    });
+  }
+
+  if (markerNames.has('pom.xml') || markerNames.has('build.gradle') || markerNames.has('build.gradle.kts')) {
+    candidates.push({
+      stackFileName: 'java.md',
+      confidenceScore: markerNames.has('pom.xml') ? 0.95 : 0.84,
+    });
+  }
+
+  if (markerNames.has('composer.json')) candidates.push({ stackFileName: 'php.md', confidenceScore: 0.95 });
+  if (markerNames.has('go.mod')) candidates.push({ stackFileName: 'go.md', confidenceScore: 0.96 });
+  if (markerNames.has('Cargo.toml')) candidates.push({ stackFileName: 'rust.md', confidenceScore: 0.96 });
+  if (markerNames.has('Gemfile')) candidates.push({ stackFileName: 'ruby.md', confidenceScore: 0.95 });
+
+  const hasDotNetMarker = Array.from(markerNames).some((markerName) => markerName.endsWith('.sln') || markerName.endsWith('.csproj'));
+  if (hasDotNetMarker) {
+    candidates.push({ stackFileName: 'csharp.md', confidenceScore: 0.95 });
+  }
+
+  if (candidates.length === 0) {
+    return {
+      recommendedStack: null,
+      recommendedBlueprint: null,
+      confidenceScore: 0,
+      confidenceGap: 0,
+      needsManualCorrection: true,
+    };
+  }
+
+  candidates.sort((leftCandidate, rightCandidate) => rightCandidate.confidenceScore - leftCandidate.confidenceScore);
+  const strongestCandidate = candidates[0];
+  const secondStrongestCandidate = candidates[1];
+  const confidenceGap = secondStrongestCandidate
+    ? Number((strongestCandidate.confidenceScore - secondStrongestCandidate.confidenceScore).toFixed(2))
+    : Number(strongestCandidate.confidenceScore.toFixed(2));
+
+  return {
+    recommendedStack: strongestCandidate.stackFileName,
+    recommendedBlueprint: BLUEPRINT_RECOMMENDATIONS[strongestCandidate.stackFileName] || null,
+    confidenceScore: strongestCandidate.confidenceScore,
+    confidenceGap,
+    needsManualCorrection: confidenceGap < AMBIGUITY_THRESHOLD,
+  };
+}
+
+function runBenchmark() {
+  let passingFixtureCount = 0;
+  let manualCorrectionCount = 0;
+
+  const fixtureResults = BENCHMARK_FIXTURES.map((benchmarkFixture) => {
+    const detectionResult = detectProjectFromMarkers(benchmarkFixture.markers);
+    const isCorrect = detectionResult.recommendedStack === benchmarkFixture.expectedStack;
+
+    if (isCorrect) {
+      passingFixtureCount += 1;
+    }
+
+    if (detectionResult.needsManualCorrection) {
+      manualCorrectionCount += 1;
+    }
+
+    return {
+      fixtureName: benchmarkFixture.fixtureName,
+      expectedStack: benchmarkFixture.expectedStack,
+      detectedStack: detectionResult.recommendedStack,
+      confidenceGap: detectionResult.confidenceGap,
+      needsManualCorrection: detectionResult.needsManualCorrection,
+      isCorrect,
+    };
+  });
+
+  const totalFixtureCount = BENCHMARK_FIXTURES.length;
+  const top1Accuracy = Number((passingFixtureCount / totalFixtureCount).toFixed(4));
+  const manualCorrectionRate = Number((manualCorrectionCount / totalFixtureCount).toFixed(4));
+
+  return {
+    generatedAt: new Date().toISOString(),
+    fixtureCount: totalFixtureCount,
+    top1Accuracy,
+    manualCorrectionRate,
+    fixtures: fixtureResults,
+  };
+}
+
+const benchmarkResult = runBenchmark();
+console.log(JSON.stringify(benchmarkResult, null, 2));

package/scripts/frontend-usability-audit.mjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+/**
+ * frontend-usability-audit.mjs
+ *
+ * Governance-level audit for V1.7 frontend execution assets.
+ * This repository does not host a frontend runtime app, so the audit validates
+ * required execution artifacts and quality gates documentation.
+ */
+
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const REPOSITORY_ROOT = resolve(__dirname, '..');
+
+const REQUIRED_FILES = [
+  'docs/roadmap.md',
+  'docs/v1.7-issue-breakdown.md',
+  'docs/v1.7-execution-playbook.md',
+  '.agent-context/review-checklists/frontend-usability.md',
+];
+
+const REQUIRED_ROADMAP_SNIPPETS = [
+  'V1.7',
+  'Frontend Product Experience',
+  'Release status: Completed',
+  'Delivered Scope',
+];
+
+const REQUIRED_CHECKLIST_SNIPPETS = [
+  'Responsiveness',
+  'Accessibility',
+  'Performance',
+  'Documentation and Release Evidence',
+];
+
+function assertFileExists(relativeFilePath, failures) {
+  const absoluteFilePath = resolve(REPOSITORY_ROOT, relativeFilePath);
+  if (!existsSync(absoluteFilePath)) {
+    failures.push(`Missing required file: ${relativeFilePath}`);
+  }
+}
+
+function assertContains(contentLabel, filePath, fileContent, snippets, failures) {
+  for (const snippetText of snippets) {
+    if (!fileContent.includes(snippetText)) {
+      failures.push(`${contentLabel} missing snippet "${snippetText}" in ${filePath}`);
+    }
+  }
+}
+
+function runAudit() {
+  const failures = [];
+
+  for (const requiredFilePath of REQUIRED_FILES) {
+    assertFileExists(requiredFilePath, failures);
+  }
+
+  const roadmapPath = 'docs/roadmap.md';
+  const checklistPath = '.agent-context/review-checklists/frontend-usability.md';
+
+  if (existsSync(resolve(REPOSITORY_ROOT, roadmapPath))) {
+    const roadmapContent = readFileSync(resolve(REPOSITORY_ROOT, roadmapPath), 'utf8');
+    assertContains('Roadmap', roadmapPath, roadmapContent, REQUIRED_ROADMAP_SNIPPETS, failures);
+  }
+
+  if (existsSync(resolve(REPOSITORY_ROOT, checklistPath))) {
+    const checklistContent = readFileSync(resolve(REPOSITORY_ROOT, checklistPath), 'utf8');
+    assertContains('Checklist', checklistPath, checklistContent, REQUIRED_CHECKLIST_SNIPPETS, failures);
+  }
+
+  const reportPayload = {
+    generatedAt: new Date().toISOString(),
+    auditName: 'frontend-usability-audit',
+    passed: failures.length === 0,
+    failureCount: failures.length,
+    failures,
+  };
+
+  console.log(JSON.stringify(reportPayload, null, 2));
+  process.exit(reportPayload.passed ? 0 : 1);
+}
+
+runAudit();

package/scripts/generate-sbom.mjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * generate-sbom.mjs
+ *
+ * Minimal CycloneDX-compatible SBOM for governance CI evidence.
+ */
+
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { randomUUID } from 'node:crypto';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const REPOSITORY_ROOT = resolve(__dirname, '..');
+const PACKAGE_JSON_PATH = resolve(REPOSITORY_ROOT, 'package.json');
+
+function buildComponents(dependencyGroup, dependencies) {
+  return Object.entries(dependencies || {}).map(([dependencyName, dependencyVersion]) => ({
+    type: 'library',
+    name: dependencyName,
+    version: String(dependencyVersion).replace(/^[^\d]*/, ''),
+    scope: dependencyGroup,
+    purl: `pkg:npm/${dependencyName}@${String(dependencyVersion).replace(/^[^\d]*/, '')}`,
+  }));
+}
+
+function generateSbom() {
+  const packageManifest = JSON.parse(readFileSync(PACKAGE_JSON_PATH, 'utf8'));
+  const runtimeComponents = buildComponents('required', packageManifest.dependencies);
+  const developmentComponents = buildComponents('optional', packageManifest.devDependencies);
+  const allComponents = [...runtimeComponents, ...developmentComponents];
+
+  const sbomPayload = {
+    bomFormat: 'CycloneDX',
+    specVersion: '1.5',
+    serialNumber: `urn:uuid:${randomUUID()}`,
+    version: 1,
+    metadata: {
+      timestamp: new Date().toISOString(),
+      component: {
+        type: 'application',
+        name: packageManifest.name,
+        version: packageManifest.version,
+      },
+      tools: [
+        {
+          vendor: 'Agentic-Senior-Core',
+          name: 'generate-sbom.mjs',
+          version: packageManifest.version,
+        },
+      ],
+    },
+    components: allComponents,
+  };
+
+  console.log(JSON.stringify(sbomPayload, null, 2));
+}
+
+generateSbom();

package/scripts/init-project.ps1

@@ -0,0 +1,105 @@
+#!/usr/bin/env pwsh
+
+[CmdletBinding()]
+param(
+  [string]$TargetDirectory = ".",
+  [ValidateSet("beginner", "balanced", "strict")]
+  [string]$Profile,
+  [string]$Stack,
+  [string]$Blueprint,
+  [ValidateSet("true", "false")]
+  [string]$Ci,
+  [switch]$Newbie,
+  [string]$RepositoryUrl = "https://github.com/fatidaprilian/Agentic-Senior-Core.git",
+  [string[]]$AdditionalArguments
+)
+
+$ErrorActionPreference = "Stop"
+
+function Resolve-AbsolutePath {
+  param([string]$PathValue)
+
+  if ([string]::IsNullOrWhiteSpace($PathValue)) {
+    throw "TargetDirectory cannot be empty."
+  }
+
+  if ([System.IO.Path]::IsPathRooted($PathValue)) {
+    return [System.IO.Path]::GetFullPath($PathValue)
+  }
+
+  $combinedPath = Join-Path -Path (Get-Location) -ChildPath $PathValue
+  return [System.IO.Path]::GetFullPath($combinedPath)
+}
+
+function New-TemporaryDirectory {
+  $temporaryDirectoryName = "agentic-senior-core-bootstrap-$(Get-Date -Format 'yyyyMMddHHmmssfff')"
+  $temporaryDirectoryPath = Join-Path -Path ([System.IO.Path]::GetTempPath()) -ChildPath $temporaryDirectoryName
+  New-Item -ItemType Directory -Path $temporaryDirectoryPath | Out-Null
+  return $temporaryDirectoryPath
+}
+
+$targetDirectoryPath = Resolve-AbsolutePath -PathValue $TargetDirectory
+if (-not (Test-Path -Path $targetDirectoryPath -PathType Container)) {
+  throw "Target directory does not exist: $targetDirectoryPath"
+}
+
+$temporaryRootDirectoryPath = New-TemporaryDirectory
+$bootstrapRepositoryPath = Join-Path -Path $temporaryRootDirectoryPath -ChildPath "Agentic-Senior-Core"
+
+try {
+  if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+    throw "Git is required but was not found in PATH."
+  }
+
+  if (-not (Get-Command node -ErrorAction SilentlyContinue)) {
+    throw "Node.js is required but was not found in PATH."
+  }
+
+  Write-Host "[Agentic-Senior-Core] Cloning bootstrap repository into temporary directory..."
+  & git clone --depth 1 $RepositoryUrl $bootstrapRepositoryPath | Out-Null
+  if ($LASTEXITCODE -ne 0) {
+    throw "Failed to clone repository from $RepositoryUrl"
+  }
+
+  $cliScriptPath = Join-Path -Path $bootstrapRepositoryPath -ChildPath "bin\agentic-senior-core.js"
+  if (-not (Test-Path -Path $cliScriptPath -PathType Leaf)) {
+    throw "CLI entry file not found: $cliScriptPath"
+  }
+
+  $cliArguments = @($cliScriptPath, "init", $targetDirectoryPath)
+
+  if ($Profile) {
+    $cliArguments += @("--profile", $Profile)
+  }
+
+  if ($Stack) {
+    $cliArguments += @("--stack", $Stack)
+  }
+
+  if ($Blueprint) {
+    $cliArguments += @("--blueprint", $Blueprint)
+  }
+
+  if ($Ci) {
+    $cliArguments += @("--ci", $Ci)
+  }
+
+  if ($Newbie.IsPresent) {
+    $cliArguments += "--newbie"
+  }
+
+  if ($AdditionalArguments) {
+    $cliArguments += $AdditionalArguments
+  }
+
+  Write-Host "[Agentic-Senior-Core] Running CLI against target directory: $targetDirectoryPath"
+  & node @cliArguments
+  if ($LASTEXITCODE -ne 0) {
+    throw "CLI exited with a non-zero status code: $LASTEXITCODE"
+  }
+}
+finally {
+  if (Test-Path -Path $temporaryRootDirectoryPath) {
+    Remove-Item -Path $temporaryRootDirectoryPath -Recurse -Force
+  }
+}

package/scripts/init-project.sh

@@ -0,0 +1,131 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+TARGET_DIRECTORY="."
+PROFILE=""
+STACK=""
+BLUEPRINT=""
+CI_VALUE=""
+ENABLE_NEWBIE_MODE="false"
+REPOSITORY_URL="https://github.com/fatidaprilian/Agentic-Senior-Core.git"
+ADDITIONAL_ARGUMENTS=()
+
+while (($# > 0)); do
+	case "$1" in
+		--profile)
+			PROFILE="${2:-}"
+			shift 2
+			;;
+		--profile=*)
+			PROFILE="${1#*=}"
+			shift
+			;;
+		--stack)
+			STACK="${2:-}"
+			shift 2
+			;;
+		--stack=*)
+			STACK="${1#*=}"
+			shift
+			;;
+		--blueprint)
+			BLUEPRINT="${2:-}"
+			shift 2
+			;;
+		--blueprint=*)
+			BLUEPRINT="${1#*=}"
+			shift
+			;;
+		--ci)
+			CI_VALUE="${2:-}"
+			shift 2
+			;;
+		--ci=*)
+			CI_VALUE="${1#*=}"
+			shift
+			;;
+		--newbie)
+			ENABLE_NEWBIE_MODE="true"
+			shift
+			;;
+		--repository-url)
+			REPOSITORY_URL="${2:-}"
+			shift 2
+			;;
+		--repository-url=*)
+			REPOSITORY_URL="${1#*=}"
+			shift
+			;;
+		--)
+			shift
+			ADDITIONAL_ARGUMENTS+=("$@")
+			break
+			;;
+		-* )
+			echo "Unknown option: $1" >&2
+			exit 1
+			;;
+		*)
+			TARGET_DIRECTORY="$1"
+			shift
+			;;
+	esac
+done
+
+if ! command -v git >/dev/null 2>&1; then
+	echo "Git is required but was not found in PATH." >&2
+	exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+	echo "Node.js is required but was not found in PATH." >&2
+	exit 1
+fi
+
+RESOLVED_TARGET_DIRECTORY="$(cd "$TARGET_DIRECTORY" && pwd)"
+TEMPORARY_ROOT_DIRECTORY="$(mktemp -d 2>/dev/null || mktemp -d -t agentic-senior-core-bootstrap)"
+BOOTSTRAP_REPOSITORY_PATH="$TEMPORARY_ROOT_DIRECTORY/Agentic-Senior-Core"
+
+cleanup_temporary_directory() {
+	rm -rf "$TEMPORARY_ROOT_DIRECTORY"
+}
+trap cleanup_temporary_directory EXIT
+
+echo "[Agentic-Senior-Core] Cloning bootstrap repository into temporary directory..."
+git clone --depth 1 "$REPOSITORY_URL" "$BOOTSTRAP_REPOSITORY_PATH" >/dev/null
+
+CLI_SCRIPT_PATH="$BOOTSTRAP_REPOSITORY_PATH/bin/agentic-senior-core.js"
+if [[ ! -f "$CLI_SCRIPT_PATH" ]]; then
+	echo "CLI entry file not found: $CLI_SCRIPT_PATH" >&2
+	exit 1
+fi
+
+CLI_ARGUMENTS=("$CLI_SCRIPT_PATH" init "$RESOLVED_TARGET_DIRECTORY")
+
+if [[ -n "$PROFILE" ]]; then
+	CLI_ARGUMENTS+=(--profile "$PROFILE")
+fi
+
+if [[ -n "$STACK" ]]; then
+	CLI_ARGUMENTS+=(--stack "$STACK")
+fi
+
+if [[ -n "$BLUEPRINT" ]]; then
+	CLI_ARGUMENTS+=(--blueprint "$BLUEPRINT")
+fi
+
+if [[ -n "$CI_VALUE" ]]; then
+	CLI_ARGUMENTS+=(--ci "$CI_VALUE")
+fi
+
+if [[ "$ENABLE_NEWBIE_MODE" == "true" ]]; then
+	CLI_ARGUMENTS+=(--newbie)
+fi
+
+if ((${#ADDITIONAL_ARGUMENTS[@]} > 0)); then
+	CLI_ARGUMENTS+=("${ADDITIONAL_ARGUMENTS[@]}")
+fi
+
+echo "[Agentic-Senior-Core] Running CLI against target directory: $RESOLVED_TARGET_DIRECTORY"
+node "${CLI_ARGUMENTS[@]}"