@ryuenn3123/agentic-senior-core 2.0.24 → 2.0.26

package/lib/cli/skill-selector.mjs

@@ -43,55 +43,77 @@ export function formatSkillTierList(skillPlatformIndex) {
   return skillPlatformIndex.tiers.map((tierDefinition) => `${tierDefinition.name} (${tierDefinition.description})`).join('\n');
 }
 
-export function inferSkillDomainNamesFromSelection(selectedStackFileName, selectedBlueprintFileName) {
+export function inferSkillDomainNamesFromSelection(
+  selectedStackFileName,
+  selectedBlueprintFileName,
+  additionalStackFileNames = [],
+  additionalBlueprintFileNames = []
+) {
   const inferredDomainNames = new Set();
 
-  if (selectedBlueprintFileName === 'api-nextjs.md' || selectedBlueprintFileName === 'fastapi-service.md') {
-    inferredDomainNames.add('frontend');
-    inferredDomainNames.add('fullstack');
-    inferredDomainNames.add('cli');
-  }
+  function applyStackSignals(stackFileName) {
+    if (stackFileName === 'typescript.md') {
+      inferredDomainNames.add('frontend');
+      inferredDomainNames.add('cli');
+    }
 
-  if (selectedBlueprintFileName === 'go-service.md'
-    || selectedBlueprintFileName === 'spring-boot-api.md'
-    || selectedBlueprintFileName === 'laravel-api.md'
-    || selectedBlueprintFileName === 'aspnet-api.md') {
-    inferredDomainNames.add('backend');
-    inferredDomainNames.add('fullstack');
-    inferredDomainNames.add('cli');
-  }
+    if (stackFileName === 'go.md'
+      || stackFileName === 'java.md'
+      || stackFileName === 'php.md'
+      || stackFileName === 'csharp.md'
+      || stackFileName === 'python.md'
+      || stackFileName === 'ruby.md'
+      || stackFileName === 'rust.md') {
+      inferredDomainNames.add('backend');
+    }
 
-  if (selectedStackFileName === 'typescript.md') {
-    inferredDomainNames.add('frontend');
-    inferredDomainNames.add('cli');
+    if (stackFileName === 'react-native.md' || stackFileName === 'flutter.md') {
+      inferredDomainNames.add('frontend');
+      inferredDomainNames.add('fullstack');
+      inferredDomainNames.add('cli');
+    }
   }
 
-  if (selectedStackFileName === 'go.md'
-    || selectedStackFileName === 'java.md'
-    || selectedStackFileName === 'php.md'
-    || selectedStackFileName === 'csharp.md'
-    || selectedStackFileName === 'python.md'
-    || selectedStackFileName === 'ruby.md'
-    || selectedStackFileName === 'rust.md') {
-    inferredDomainNames.add('backend');
-  }
+  function applyBlueprintSignals(blueprintFileName) {
+    if (blueprintFileName === 'api-nextjs.md' || blueprintFileName === 'fastapi-service.md') {
+      inferredDomainNames.add('frontend');
+      inferredDomainNames.add('fullstack');
+      inferredDomainNames.add('cli');
+    }
 
-  if (selectedStackFileName === 'react-native.md' || selectedStackFileName === 'flutter.md') {
-    inferredDomainNames.add('frontend');
-    inferredDomainNames.add('fullstack');
-    inferredDomainNames.add('cli');
+    if (blueprintFileName === 'go-service.md'
+      || blueprintFileName === 'spring-boot-api.md'
+      || blueprintFileName === 'laravel-api.md'
+      || blueprintFileName === 'aspnet-api.md'
+      || blueprintFileName === 'nestjs-logic.md'
+      || blueprintFileName === 'graphql-grpc-api.md') {
+      inferredDomainNames.add('backend');
+      inferredDomainNames.add('fullstack');
+      inferredDomainNames.add('cli');
+    }
+
+    if (blueprintFileName === 'mobile-app.md') {
+      inferredDomainNames.add('frontend');
+      inferredDomainNames.add('fullstack');
+      inferredDomainNames.add('cli');
+    }
+
+    if (blueprintFileName === 'observability.md') {
+      inferredDomainNames.add('backend');
+      inferredDomainNames.add('fullstack');
+      inferredDomainNames.add('cli');
+    }
   }
 
-  if (selectedBlueprintFileName === 'mobile-app.md') {
-    inferredDomainNames.add('frontend');
-    inferredDomainNames.add('fullstack');
-    inferredDomainNames.add('cli');
+  applyBlueprintSignals(selectedBlueprintFileName);
+
+  applyStackSignals(selectedStackFileName);
+  for (const additionalStackFileName of additionalStackFileNames) {
+    applyStackSignals(additionalStackFileName);
   }
 
-  if (selectedBlueprintFileName === 'observability.md') {
-    inferredDomainNames.add('backend');
-    inferredDomainNames.add('fullstack');
-    inferredDomainNames.add('cli');
+  for (const additionalBlueprintFileName of additionalBlueprintFileNames) {
+    applyBlueprintSignals(additionalBlueprintFileName);
   }
 
   if (inferredDomainNames.size === 0) {

package/lib/cli/templates/architecture-decision-record.md.tmpl

@@ -18,9 +18,23 @@ This project requires a {{primaryDomain}} solution. The team evaluated available
 ### Decision
 
 - **Language/Runtime**: {{stackDisplayName}} (source: `.agent-context/stacks/{{stackFileName}}`)
+{{#if additionalStackDisplayNames}}
+- **Additional runtime context**:
+{{#each additionalStackDisplayNames}}
+  - {{this}}
+{{/each}}
+{{/if}}
 - **Architecture blueprint**: {{blueprintDisplayName}} (source: `.agent-context/blueprints/{{blueprintFileName}}`)
+{{#if additionalBlueprintDisplayNames}}
+- **Additional architecture blueprints**:
+{{#each additionalBlueprintDisplayNames}}
+  - {{this}}
+{{/each}}
+{{/if}}
 - **Database**: {{databaseChoice}}
 - **Auth**: {{authStrategy}}
+- **Runtime environment target**: {{runtimeEnvironmentLabel}}
+- **Containerization strategy**: {{dockerStrategy}}
 
 ### Rationale
 
@@ -36,6 +50,31 @@ The {{stackDisplayName}} stack was selected because:
 - Database access must follow `.agent-context/rules/database-design.md`.
 - API contracts must follow `.agent-context/rules/api-docs.md`.
 
+{{#if hasDocker}}
+---
+
+## ADR-004: Containerization Strategy (Dynamic)
+
+**Status**: Accepted
+**Date**: {{generatedDate}}
+
+### Context
+
+This project requires container support with separated development and production concerns.
+
+### Decision
+
+- Follow dynamic container generation based on real project dependencies and runtime profile.
+- Do not rely on static Docker templates copied from unrelated repositories.
+{{dockerDevelopmentGuidance}}
+{{dockerProductionGuidance}}
+
+### Consequences
+
+- Development and production Docker artifacts are treated as separate deliverables.
+- Changes in package/runtime dependencies must regenerate container setup instructions in the same change.
+{{/if}}
+
 ---
 
 ## ADR-002: Architecture Pattern

package/lib/cli/templates/flow-overview.md.tmpl

@@ -12,6 +12,18 @@ Template version: {{templateVersion}}
 **Domain**: {{primaryDomain}}
 **Stack**: {{stackDisplayName}}
 **Blueprint**: {{blueprintDisplayName}}
+**Runtime target**: {{runtimeEnvironmentLabel}}
+**Containerization**: {{dockerStrategy}}
+
+{{#if hasDocker}}
+## Container Flow (Dynamic Dev and Prod)
+
+- Container setup is generated dynamically by AI from current dependencies, not from static canned templates.
+{{dockerDevelopmentGuidance}}
+{{dockerProductionGuidance}}
+- Keep dev and prod container concerns explicitly separated.
+
+{{/if}}
 
 ## High-Level Architecture
 

package/lib/cli/templates/project-brief.md.id.tmpl

@@ -18,6 +18,8 @@ Versi template: {{templateVersion}}
 **Blueprint**: {{blueprintDisplayName}}
 **Database**: {{databaseChoice}}
 **Strategi autentikasi**: {{authStrategy}}
+**Target environment runtime**: {{runtimeEnvironmentLabel}}
+**Strategi containerisasi**: {{dockerStrategy}}
 
 ## Fitur Kunci
 

package/lib/cli/templates/project-brief.md.tmpl

@@ -15,9 +15,35 @@ Template version: {{templateVersion}}
 ## Technology Decisions
 
 **Stack**: {{stackDisplayName}}
+{{#if additionalStackDisplayNames}}
+**Additional stacks**:
+{{#each additionalStackDisplayNames}}
+- {{this}}
+{{/each}}
+{{/if}}
 **Blueprint**: {{blueprintDisplayName}}
+{{#if additionalBlueprintDisplayNames}}
+**Additional blueprints**:
+{{#each additionalBlueprintDisplayNames}}
+- {{this}}
+{{/each}}
+{{/if}}
 **Database**: {{databaseChoice}}
 **Auth strategy**: {{authStrategy}}
+**Runtime environment target**: {{runtimeEnvironmentLabel}}
+**Containerization strategy**: {{dockerStrategy}}
+
+{{#if hasDocker}}
+## Containerization Workflow (Dynamic)
+
+- Docker is enabled for this project: **{{dockerStrategy}}**.
+- Docker setup must be generated dynamically by AI based on current dependencies and runtime constraints.
+- Do not use fixed boilerplate templates that ignore actual project structure.
+{{dockerDevelopmentGuidance}}
+{{dockerProductionGuidance}}
+
+- Keep development and production container strategy separated to avoid environment drift.
+{{/if}}
 
 ## Key Features
 

package/lib/cli/utils.mjs

@@ -28,7 +28,7 @@ export function printUsage() {
   console.log('');
   console.log('Usage:');
   console.log('  agentic-senior-core launch');
-  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>] [--scaffold-docs] [--no-scaffold-docs] [--docs-lang <en|id>] [--project-config <path>]');
+  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>] [--scaffold-docs] [--no-scaffold-docs] [--docs-lang <en|id>] [--project-config <path>] [--runtime-env <auto|linux-wsl|linux|windows|macos>]');
   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');
@@ -54,6 +54,7 @@ export function printUsage() {
   console.log('  --no-scaffold-docs  Skip project documentation scaffolding');
   console.log('  --docs-lang      Optional override for generated project docs language (default: en)');
   console.log('  --project-config Path to a project config file for non-interactive doc scaffolding');
+  console.log('  --runtime-env   Override runtime environment hint (auto, linux-wsl, linux, windows, macos)');
   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');

package/package.json

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

package/scripts/frontend-usability-audit.mjs

@@ -21,6 +21,7 @@ const REQUIRED_FILES = [
   'docs/v1.7-issue-breakdown.md',
   'docs/v1.7-execution-playbook.md',
   '.agent-context/review-checklists/frontend-usability.md',
+  '.agent-context/review-checklists/frontend-excellence-rubric.md',
 ];
 
 const REQUIRED_ROADMAP_SNIPPETS = [
@@ -37,6 +38,14 @@ const REQUIRED_CHECKLIST_SNIPPETS = [
   'Documentation and Release Evidence',
 ];
 
+const REQUIRED_EXCELLENCE_RUBRIC_SNIPPETS = [
+  'Visual Direction and Identity',
+  'Typography Quality',
+  'Color System Diversity and Contrast',
+  'Interaction Choreography',
+  'Awwwards-level reference quality',
+];
+
 function assertFileExists(relativeFilePath, failures) {
   const absoluteFilePath = resolve(REPOSITORY_ROOT, relativeFilePath);
   if (!existsSync(absoluteFilePath)) {
@@ -61,6 +70,7 @@ function runAudit() {
 
   const roadmapPath = 'docs/roadmap.md';
   const checklistPath = '.agent-context/review-checklists/frontend-usability.md';
+  const excellenceRubricPath = '.agent-context/review-checklists/frontend-excellence-rubric.md';
 
   if (existsSync(resolve(REPOSITORY_ROOT, roadmapPath))) {
     const roadmapContent = readFileSync(resolve(REPOSITORY_ROOT, roadmapPath), 'utf8');
@@ -72,6 +82,17 @@ function runAudit() {
     assertContains('Checklist', checklistPath, checklistContent, REQUIRED_CHECKLIST_SNIPPETS, failures);
   }
 
+  if (existsSync(resolve(REPOSITORY_ROOT, excellenceRubricPath))) {
+    const excellenceRubricContent = readFileSync(resolve(REPOSITORY_ROOT, excellenceRubricPath), 'utf8');
+    assertContains(
+      'Frontend excellence rubric',
+      excellenceRubricPath,
+      excellenceRubricContent,
+      REQUIRED_EXCELLENCE_RUBRIC_SNIPPETS,
+      failures
+    );
+  }
+
   const reportPayload = {
     generatedAt: new Date().toISOString(),
     auditName: 'frontend-usability-audit',

package/scripts/release-gate.mjs

@@ -28,6 +28,7 @@ const REQUIRED_SKILL_DOMAINS = [
   'review-quality',
 ];
 const FRONTEND_PARITY_CHECKLIST_PATH = '.agent-context/review-checklists/frontend-skill-parity.md';
+const FRONTEND_EXCELLENCE_RUBRIC_PATH = '.agent-context/review-checklists/frontend-excellence-rubric.md';
 const FRONTEND_AUDIT_SCRIPT_PATH = 'scripts/frontend-usability-audit.mjs';
 const REQUIRED_FRONTEND_PARITY_SNIPPETS = [
   'Architecture and Composition',
@@ -36,6 +37,14 @@ const REQUIRED_FRONTEND_PARITY_SNIPPETS = [
   'UX Narrative and Conversion Clarity',
   'Release Evidence',
 ];
+const REQUIRED_FRONTEND_EXCELLENCE_RUBRIC_SNIPPETS = [
+  'Visual Direction and Identity',
+  'Typography Quality',
+  'Color System Diversity and Contrast',
+  'Interaction Choreography',
+  'Awwwards-level reference quality',
+];
+const BENCHMARK_GATE_SCRIPT_PATH = 'scripts/benchmark-gate.mjs';
 
 function readText(relativeFilePath) {
   const absolutePath = resolve(REPOSITORY_ROOT, relativeFilePath);
@@ -54,6 +63,46 @@ function pushResult(results, isPassed, checkName, details) {
   });
 }
 
+function parseMachineReadableReport(rawOutput) {
+  if (typeof rawOutput !== 'string' || rawOutput.trim().length === 0) {
+    return null;
+  }
+
+  try {
+    return JSON.parse(rawOutput);
+  } catch {
+    return null;
+  }
+}
+
+function runMachineReadableScript(scriptRelativePath) {
+  try {
+    const rawOutput = execFileSync('node', [scriptRelativePath], {
+      cwd: REPOSITORY_ROOT,
+      encoding: 'utf8',
+      maxBuffer: 1024 * 1024,
+    });
+
+    return {
+      report: parseMachineReadableReport(rawOutput),
+      executionErrorMessage: null,
+    };
+  } catch (scriptExecutionError) {
+    const rawOutput = scriptExecutionError && typeof scriptExecutionError === 'object' && 'stdout' in scriptExecutionError
+      ? String(scriptExecutionError.stdout ?? '')
+      : '';
+    const parsedReport = parseMachineReadableReport(rawOutput);
+    const executionErrorMessage = scriptExecutionError instanceof Error
+      ? scriptExecutionError.message
+      : 'Unknown execution error';
+
+    return {
+      report: parsedReport,
+      executionErrorMessage,
+    };
+  }
+}
+
 function validateCompatibilityManifestShape(parsedManifest, skillDomainName) {
   const validationErrors = [];
 
@@ -82,6 +131,7 @@ function validateCompatibilityManifestShape(parsedManifest, skillDomainName) {
 
 function runReleaseGate() {
   const results = [];
+  const diagnostics = {};
   const packageJsonPath = 'package.json';
   const changelogPath = 'CHANGELOG.md';
   const roadmapPath = 'docs/roadmap.md';
@@ -222,6 +272,28 @@ function runReleaseGate() {
     }
   }
 
+  const frontendExcellenceRubricContent = readText(FRONTEND_EXCELLENCE_RUBRIC_PATH);
+  if (!frontendExcellenceRubricContent) {
+    pushResult(results, false, 'frontend-excellence-rubric-exists', `Missing ${FRONTEND_EXCELLENCE_RUBRIC_PATH}`);
+  } else {
+    pushResult(results, true, 'frontend-excellence-rubric-exists', `${FRONTEND_EXCELLENCE_RUBRIC_PATH} is present`);
+
+    const missingFrontendExcellenceSnippets = REQUIRED_FRONTEND_EXCELLENCE_RUBRIC_SNIPPETS.filter(
+      (requiredSnippet) => !frontendExcellenceRubricContent.includes(requiredSnippet)
+    );
+
+    if (missingFrontendExcellenceSnippets.length === 0) {
+      pushResult(results, true, 'frontend-excellence-rubric-coverage', 'Frontend excellence rubric sections are complete');
+    } else {
+      pushResult(
+        results,
+        false,
+        'frontend-excellence-rubric-coverage',
+        `Missing frontend excellence rubric sections: ${missingFrontendExcellenceSnippets.join(', ')}`
+      );
+    }
+  }
+
   try {
     const frontendAuditRawOutput = execFileSync('node', [FRONTEND_AUDIT_SCRIPT_PATH], {
       cwd: REPOSITORY_ROOT,
@@ -245,12 +317,48 @@ function runReleaseGate() {
     pushResult(results, false, 'frontend-usability-audit', `Failed to execute frontend usability audit: ${frontendAuditErrorMessage}`);
   }
 
+  const benchmarkGateExecution = runMachineReadableScript(BENCHMARK_GATE_SCRIPT_PATH);
+  if (!benchmarkGateExecution.report) {
+    const failureDetails = benchmarkGateExecution.executionErrorMessage
+      ? `Benchmark gate execution failed before producing a machine-readable report: ${benchmarkGateExecution.executionErrorMessage}`
+      : 'Benchmark gate did not produce machine-readable JSON output';
+    pushResult(results, false, 'benchmark-threshold-gate', failureDetails);
+  } else {
+    diagnostics.benchmarkGate = benchmarkGateExecution.report;
+    pushResult(
+      results,
+      true,
+      'benchmark-threshold-gate',
+      `Benchmark threshold gate executed (passed=${benchmarkGateExecution.report.passed}, failures=${benchmarkGateExecution.report.failureCount})`
+    );
+
+    if (benchmarkGateExecution.report.passed === true) {
+      pushResult(results, true, 'benchmark-regression-block', 'Benchmark thresholds are healthy; release remains eligible');
+    } else {
+      const failedBenchmarkChecks = Array.isArray(benchmarkGateExecution.report.results)
+        ? benchmarkGateExecution.report.results
+          .filter((benchmarkCheckResult) => !benchmarkCheckResult.passed)
+          .map((benchmarkCheckResult) => `${benchmarkCheckResult.checkName}: ${benchmarkCheckResult.details}`)
+        : [];
+      const failureSummary = failedBenchmarkChecks.length > 0
+        ? failedBenchmarkChecks.join('; ')
+        : 'Benchmark gate failed but did not report individual failed checks';
+      pushResult(
+        results,
+        false,
+        'benchmark-regression-block',
+        `Benchmark threshold regression detected. ${failureSummary}`
+      );
+    }
+  }
+
   const failureCount = results.filter((checkResult) => !checkResult.passed).length;
   const releaseGateReport = {
     generatedAt: new Date().toISOString(),
     gateName: 'release-gate',
     passed: failureCount === 0,
     failureCount,
+    diagnostics,
     results,
   };
 

package/scripts/validate.mjs

@@ -258,6 +258,7 @@ async function validateRuleFiles() {
     'rules/database-design.md',
     'rules/realtime.md',
     'rules/frontend-architecture.md',
+    'rules/docker-runtime.md',
     'stacks/typescript.md',
     'stacks/python.md',
     'stacks/java.md',
@@ -285,6 +286,7 @@ async function validateRuleFiles() {
     'review-checklists/pr-checklist.md',
     'review-checklists/frontend-usability.md',
     'review-checklists/frontend-skill-parity.md',
+    'review-checklists/frontend-excellence-rubric.md',
     'review-checklists/release-operations.md',
     'review-checklists/security-audit.md',
     'review-checklists/performance-audit.md',