@ryuenn3123/agentic-senior-core 2.0.25 → 2.0.27

package/lib/cli/project-scaffolder.mjs

@@ -22,7 +22,7 @@ const PROJECT_DOC_FILE_NAMES = [
   'flow-overview.md',
 ];
 
-export const PROJECT_DOC_TEMPLATE_VERSION = '1.1.0';
+export const PROJECT_DOC_TEMPLATE_VERSION = '1.2.0';
 
 const DOMAIN_CHOICES = [
   'API service',
@@ -50,6 +50,13 @@ const AUTH_CHOICES = [
   'Other',
 ];
 
+const DOCKER_STRATEGY_CHOICES = [
+  'No Docker (run services directly)',
+  'Docker for development only',
+  'Docker for production only',
+  'Docker for both development and production',
+];
+
 const DISCOVERY_MODE_CHOICES = [
   'Quick mode (mostly choices, fastest)',
   'Detailed mode (type your own answers)',
@@ -101,6 +108,100 @@ const FEATURE_PRESET_MAP = {
   ],
 };
 
+function parseBooleanLikeValue(rawValue) {
+  const normalizedValue = String(rawValue || '').trim().toLowerCase();
+  if (['true', 'yes', 'y', '1'].includes(normalizedValue)) {
+    return true;
+  }
+
+  if (['false', 'no', 'n', '0'].includes(normalizedValue)) {
+    return false;
+  }
+
+  return null;
+}
+
+function resolveDockerStrategy({ dockerStrategy, useDocker, useDockerDevelopment, useDockerProduction }) {
+  if (typeof dockerStrategy === 'string' && dockerStrategy.trim().length > 0) {
+    const normalizedDockerStrategy = dockerStrategy.trim().toLowerCase();
+    const directMatch = DOCKER_STRATEGY_CHOICES.find(
+      (dockerStrategyChoice) => dockerStrategyChoice.toLowerCase() === normalizedDockerStrategy
+    );
+
+    if (directMatch) {
+      return directMatch;
+    }
+  }
+
+  const normalizedUseDocker = typeof useDocker === 'boolean' ? useDocker : parseBooleanLikeValue(useDocker);
+  const normalizedUseDockerDevelopment = typeof useDockerDevelopment === 'boolean'
+    ? useDockerDevelopment
+    : parseBooleanLikeValue(useDockerDevelopment);
+  const normalizedUseDockerProduction = typeof useDockerProduction === 'boolean'
+    ? useDockerProduction
+    : parseBooleanLikeValue(useDockerProduction);
+
+  if (normalizedUseDocker === false) {
+    return DOCKER_STRATEGY_CHOICES[0];
+  }
+
+  if (normalizedUseDockerDevelopment === true && normalizedUseDockerProduction === true) {
+    return DOCKER_STRATEGY_CHOICES[3];
+  }
+
+  if (normalizedUseDockerDevelopment === true && normalizedUseDockerProduction !== true) {
+    return DOCKER_STRATEGY_CHOICES[1];
+  }
+
+  if (normalizedUseDockerProduction === true && normalizedUseDockerDevelopment !== true) {
+    return DOCKER_STRATEGY_CHOICES[2];
+  }
+
+  if (normalizedUseDocker === true) {
+    return DOCKER_STRATEGY_CHOICES[3];
+  }
+
+  return DOCKER_STRATEGY_CHOICES[0];
+}
+
+function parseDockerStrategy(dockerStrategy) {
+  const normalizedDockerStrategy = String(dockerStrategy || '').toLowerCase();
+
+  if (normalizedDockerStrategy.includes('both development and production')) {
+    return {
+      dockerStrategy: DOCKER_STRATEGY_CHOICES[3],
+      hasDocker: true,
+      useDockerDevelopment: true,
+      useDockerProduction: true,
+    };
+  }
+
+  if (normalizedDockerStrategy.includes('development only')) {
+    return {
+      dockerStrategy: DOCKER_STRATEGY_CHOICES[1],
+      hasDocker: true,
+      useDockerDevelopment: true,
+      useDockerProduction: false,
+    };
+  }
+
+  if (normalizedDockerStrategy.includes('production only')) {
+    return {
+      dockerStrategy: DOCKER_STRATEGY_CHOICES[2],
+      hasDocker: true,
+      useDockerDevelopment: false,
+      useDockerProduction: true,
+    };
+  }
+
+  return {
+    dockerStrategy: DOCKER_STRATEGY_CHOICES[0],
+    hasDocker: false,
+    useDockerDevelopment: false,
+    useDockerProduction: false,
+  };
+}
+
 async function askFeatureList(userInterface) {
   console.log('\nList your key features (one per line, press Enter to finish):');
 
@@ -253,6 +354,42 @@ export async function runProjectDiscovery(userInterface, options = {}) {
     authStrategy = (await userInterface.question('Describe your auth setup: ')).trim() || 'Custom auth';
   }
 
+  let dockerStrategy = DOCKER_STRATEGY_CHOICES[0];
+  if (isQuickMode) {
+    dockerStrategy = await askChoice(
+      'Containerization strategy:',
+      DOCKER_STRATEGY_CHOICES,
+      userInterface
+    );
+  } else {
+    const useDocker = await askYesNo(
+      'Use Docker for this project (development and/or production)?',
+      userInterface,
+      false
+    );
+
+    if (useDocker) {
+      const useDockerDevelopment = await askYesNo(
+        'Use Docker for development workflow?',
+        userInterface,
+        true
+      );
+      const useDockerProduction = await askYesNo(
+        'Use Docker for production runtime/build?',
+        userInterface,
+        true
+      );
+
+      dockerStrategy = resolveDockerStrategy({
+        useDocker,
+        useDockerDevelopment,
+        useDockerProduction,
+      });
+    }
+  }
+
+  const parsedDockerStrategy = parseDockerStrategy(dockerStrategy);
+
   let features = [];
   if (isQuickMode) {
     const selectedFeaturePreset = await askChoice(
@@ -297,6 +434,9 @@ export async function runProjectDiscovery(userInterface, options = {}) {
     primaryDomain,
     databaseChoice,
     authStrategy,
+    dockerStrategy: parsedDockerStrategy.dockerStrategy,
+    useDockerDevelopment: parsedDockerStrategy.useDockerDevelopment,
+    useDockerProduction: parsedDockerStrategy.useDockerProduction,
     features,
     additionalContext,
   };
@@ -343,6 +483,13 @@ export function resolveDocumentManifest(discoveryAnswers) {
 export function buildTemplateContext(discoveryAnswers, initContext) {
   const hasDatabase = !discoveryAnswers.databaseChoice.toLowerCase().startsWith('none');
   const hasAuth = !discoveryAnswers.authStrategy.toLowerCase().startsWith('none');
+  const additionalStackFileNames = Array.isArray(initContext.additionalStackFileNames)
+    ? initContext.additionalStackFileNames
+    : [];
+  const additionalBlueprintFileNames = Array.isArray(initContext.additionalBlueprintFileNames)
+    ? initContext.additionalBlueprintFileNames
+    : [];
+  const parsedDockerStrategy = parseDockerStrategy(discoveryAnswers.dockerStrategy);
 
   const baseUrlMap = {
     'API service': 'http://localhost:3000',
@@ -362,14 +509,34 @@ export function buildTemplateContext(discoveryAnswers, initContext) {
     additionalContext: discoveryAnswers.additionalContext,
     stackFileName: initContext.stackFileName,
     stackDisplayName: toTitleCase(initContext.stackFileName),
+    additionalStackFileNames,
+    additionalStackDisplayNames: additionalStackFileNames.length > 0
+      ? additionalStackFileNames.map((stackFileName) => toTitleCase(stackFileName))
+      : null,
     blueprintFileName: initContext.blueprintFileName,
     blueprintDisplayName: toTitleCase(initContext.blueprintFileName),
+    additionalBlueprintFileNames,
+    additionalBlueprintDisplayNames: additionalBlueprintFileNames.length > 0
+      ? additionalBlueprintFileNames.map((blueprintFileName) => toTitleCase(blueprintFileName))
+      : null,
+    runtimeEnvironmentKey: initContext.runtimeEnvironmentKey || 'linux',
+    runtimeEnvironmentLabel: initContext.runtimeEnvironmentLabel || 'Linux',
     cliVersion: CLI_VERSION,
     templateVersion: PROJECT_DOC_TEMPLATE_VERSION,
     generatedAt: new Date().toISOString(),
     generatedDate: new Date().toISOString().split('T')[0],
     hasDatabase,
     hasAuth,
+    hasDocker: parsedDockerStrategy.hasDocker,
+    dockerStrategy: parsedDockerStrategy.dockerStrategy,
+    useDockerDevelopment: parsedDockerStrategy.useDockerDevelopment,
+    useDockerProduction: parsedDockerStrategy.useDockerProduction,
+    dockerDevelopmentGuidance: parsedDockerStrategy.useDockerDevelopment
+      ? '- Development containers are required: optimize for fast rebuilds, bind mounts, and debug-friendly startup.'
+      : '',
+    dockerProductionGuidance: parsedDockerStrategy.useDockerProduction
+      ? '- Production containers are required: use multi-stage builds, non-root runtime, and minimal image footprint.'
+      : '',
     baseUrl: baseUrlMap[discoveryAnswers.primaryDomain] || 'http://localhost:3000',
   };
 }
@@ -595,6 +762,12 @@ export async function loadProjectConfig(configFilePath) {
     primaryDomain: configEntries.primaryDomain || configEntries.domain || 'API service',
     databaseChoice: configEntries.databaseChoice || configEntries.database || 'None (stateless service)',
     authStrategy: configEntries.authStrategy || configEntries.auth || 'None (public service)',
+    dockerStrategy: resolveDockerStrategy({
+      dockerStrategy: configEntries.dockerStrategy || configEntries.containerStrategy,
+      useDocker: configEntries.useDocker,
+      useDockerDevelopment: configEntries.useDockerDevelopment || configEntries.dockerDevelopment,
+      useDockerProduction: configEntries.useDockerProduction || configEntries.dockerProduction,
+    }),
     features: Array.isArray(configEntries.features) ? configEntries.features : [],
     additionalContext: configEntries.additionalContext || configEntries.context || 'No additional context provided.',
     docsLang: configEntries.docsLang || configEntries.docsLanguage || 'en',

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.25",
+  "version": "2.0.27",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {
@@ -52,6 +52,7 @@
     "benchmark:writer-judge": "node ./scripts/benchmark-writer-judge-matrix.mjs",
     "benchmark:gate": "node ./scripts/benchmark-gate.mjs",
     "benchmark:intelligence": "node ./scripts/benchmark-intelligence.mjs",
+    "benchmark:continuity": "node ./scripts/memory-continuity-benchmark.mjs",
     "report:quality-trend": "node ./scripts/quality-trend-report.mjs",
     "report:docs-quality-drift": "node ./scripts/docs-quality-drift-report.mjs",
     "report:governance-weekly": "node ./scripts/governance-weekly-report.mjs",