@ryuenn3123/agentic-senior-core 2.5.18 → 2.5.19

package/.agent-context/state/memory-continuity-benchmark.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-18T02:48:53.130Z",
+  "generatedAt": "2026-04-18T02:58:09.480Z",
   "reportName": "memory-continuity-benchmark",
   "schemaVersion": "1.0.0",
   "passed": true,

package/.cursorrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.5.18
+Generated by Agentic-Senior-Core CLI v2.5.19
 Timestamp: 2026-04-18T03:00:00.000Z
 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.5.18
+Generated by Agentic-Senior-Core CLI v2.5.19
 Timestamp: 2026-04-18T03:00:00.000Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/lib/cli/commands/init.mjs

@@ -502,6 +502,14 @@ async function askBlueprintSelection(promptMessage, selectableBlueprintFileNames
   return selectableBlueprintFileNames[selectedIndex] || selectableBlueprintFileNames[0] || null;
 }
 
+function buildExistingProjectMajorConstraints() {
+  return [
+    'Preserve existing project markers and avoid forced stack migration.',
+    'Keep stack rule loading lazy and scoped to touched code.',
+    'Explicit stack or blueprint overrides always win over auto-detection.',
+  ];
+}
+
 export async function runInitCommand(targetDirectoryArgument, initOptions = {}) {
   const resolvedTargetDirectoryPath = path.resolve(targetDirectoryArgument || '.');
   const isTokenOptimizationEnabled = typeof initOptions.tokenOptimize === 'boolean'
@@ -654,6 +662,64 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     console.log(`\nSelected profile: ${selectedProfile.displayName}`);
     console.log(`This profile will block these review severities in CI: ${formatBlockingSeverities(selectedProfile.blockingSeverities)}.`);
 
+    const detectionMajorConstraints = buildExistingProjectMajorConstraints();
+    const detectionTransparency = {
+      declaredAt: new Date().toISOString(),
+      declarationType: projectDetection.hasExistingProjectFiles ? 'existing-project' : 'fresh-project',
+      declarationShown: projectDetection.hasExistingProjectFiles,
+      detectionSummary: projectDetection.hasExistingProjectFiles
+        ? buildDetectionSummary(projectDetection)
+        : 'No existing project markers were detected.',
+      activeRulesSummary: {
+        canonicalSource: '.instructions.md',
+        compiledEntrypoints: ['.cursorrules', '.windsurfrules'],
+        stackLoadingMode: 'lazy',
+        selectedProfile: selectedProfileName,
+        selectedProfileDisplayName: selectedProfile.displayName,
+        blockingSeverities: selectedProfile.blockingSeverities,
+        ciGuardrailsEnabled: null,
+      },
+      majorConstraints: detectionMajorConstraints,
+      quickConfirmation: {
+        offered: false,
+        response: projectDetection.hasExistingProjectFiles ? 'pending' : 'not-applicable',
+        source: 'existing-project-detection',
+      },
+      decision: {
+        mode: projectDetection.hasExistingProjectFiles ? 'pending' : 'fresh-directory',
+        selectedStackFileName: null,
+        selectedBlueprintFileName: null,
+      },
+    };
+
+    if (projectDetection.hasExistingProjectFiles) {
+      console.log('\nExisting project detection transparency:');
+
+      if (projectDetection.recommendedStackFileName) {
+        const confidenceScoreLabel = Number(projectDetection.confidenceScore || 0).toFixed(2);
+        console.log(
+          `- Detected stack: ${toTitleCase(projectDetection.recommendedStackFileName)} (${projectDetection.confidenceLabel}, score ${confidenceScoreLabel})`
+        );
+
+        if (projectDetection.secondaryStackFileNames?.length) {
+          console.log(
+            `- Secondary stack signals: ${projectDetection.secondaryStackFileNames.map((stackFileName) => toTitleCase(stackFileName)).join(', ')}`
+          );
+        }
+      } else {
+        console.log('- Detected stack: unresolved (insufficient markers).');
+      }
+
+      console.log('- Active rules baseline: canonical .instructions.md -> compiled .cursorrules/.windsurfrules');
+      console.log(
+        `- Active review profile: ${selectedProfile.displayName} (blocking severities: ${formatBlockingSeverities(selectedProfile.blockingSeverities)})`
+      );
+      console.log('- Major constraints:');
+      for (const majorConstraint of detectionMajorConstraints) {
+        console.log(`  - ${majorConstraint}`);
+      }
+    }
+
     if (selectedProfilePack) {
       console.log(`Applying team profile pack: ${selectedProfilePack.displayName}.`);
       console.log(`Pack defaults: stack ${toTitleCase(selectedProfilePack.defaultStackFileName)}, blueprint ${toTitleCase(selectedProfilePack.defaultBlueprintFileName)}.`);
@@ -667,11 +733,15 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       && !selectedStackFileNameFromOption
       && !selectedPreset?.stack
       && !selectedProfilePack?.defaultStackFileName;
+    const detectedBlueprintFileName = projectDetection.recommendedBlueprintFileName
+      || BLUEPRINT_RECOMMENDATIONS[projectDetection.recommendedStackFileName]
+      || null;
 
     let selectedManualStackFileName = null;
     let selectedManualBlueprintFileName = null;
     let selectedAdditionalStackFileNames = [];
     let selectedAdditionalBlueprintFileNames = [];
+    let detectedSetupWasApplied = false;
 
     let architectureRecommendation = null;
     let architectPreferenceState = await readArchitectPreferenceState();
@@ -684,11 +754,73 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       && !selectedProfile.defaultStackFileName;
 
     if (shouldAutoApplyDetectedStack) {
-      console.log(`Using detected stack automatically for this existing project: ${toTitleCase(projectDetection.recommendedStackFileName)}.`);
-      if (projectDetection.secondaryStackFileNames?.length) {
-        console.log(`Detected additional stack signals: ${projectDetection.secondaryStackFileNames.map((stackFileName) => toTitleCase(stackFileName)).join(', ')}.`);
+      if (isInteractiveSession) {
+        detectionTransparency.quickConfirmation.offered = true;
+        console.log('\nQuick confirmation for existing project detection:');
+        console.log(`- Suggested stack: ${toTitleCase(projectDetection.recommendedStackFileName)}`);
+        if (detectedBlueprintFileName) {
+          console.log(`- Suggested blueprint: ${toTitleCase(detectedBlueprintFileName)}`);
+        }
+
+        const shouldUseDetectedSetup = await askYesNo(
+          'Use detected setup for this existing project?',
+          userInterface,
+          true
+        );
+
+        if (shouldUseDetectedSetup) {
+          detectedSetupWasApplied = true;
+          detectionTransparency.quickConfirmation.response = 'confirmed-detected';
+          detectionTransparency.decision.mode = 'confirmed-detected';
+          console.log(`Using detected stack automatically for this existing project: ${toTitleCase(projectDetection.recommendedStackFileName)}.`);
+          if (projectDetection.secondaryStackFileNames?.length) {
+            console.log(`Detected additional stack signals: ${projectDetection.secondaryStackFileNames.map((stackFileName) => toTitleCase(stackFileName)).join(', ')}.`);
+          }
+          selectedAdditionalStackFileNames = projectDetection.secondaryStackFileNames || [];
+        } else {
+          const overrideStackFileName = await askStackSelection(
+            'Override detected stack (quick selection):',
+            stackFileNames,
+            userInterface
+          );
+          const overrideBlueprintCandidates = filterBlueprintFileNamesByCandidates(
+            blueprintFileNames,
+            [BLUEPRINT_RECOMMENDATIONS[overrideStackFileName]].filter(Boolean)
+          );
+          const overrideBlueprintFileName = await askBlueprintSelection(
+            'Override detected blueprint (quick selection):',
+            overrideBlueprintCandidates,
+            userInterface
+          );
+
+          selectedManualStackFileName = overrideStackFileName;
+          selectedManualBlueprintFileName = overrideBlueprintFileName;
+          selectedAdditionalStackFileNames = normalizeAdditionalStackSelection(
+            overrideStackFileName,
+            projectDetection.secondaryStackFileNames || []
+          );
+          detectionTransparency.quickConfirmation.response = 'overridden-detected';
+          detectionTransparency.decision.mode = 'overridden-detected';
+          console.log(
+            `Detection override applied: ${toTitleCase(overrideStackFileName)} + ${toTitleCase(overrideBlueprintFileName)}.`
+          );
+        }
+      } else {
+        detectedSetupWasApplied = true;
+        detectionTransparency.quickConfirmation.response = 'non-interactive-auto';
+        detectionTransparency.decision.mode = 'non-interactive-auto';
+        console.log(`Using detected stack automatically for this existing project: ${toTitleCase(projectDetection.recommendedStackFileName)}.`);
+        if (projectDetection.secondaryStackFileNames?.length) {
+          console.log(`Detected additional stack signals: ${projectDetection.secondaryStackFileNames.map((stackFileName) => toTitleCase(stackFileName)).join(', ')}.`);
+        }
+        selectedAdditionalStackFileNames = projectDetection.secondaryStackFileNames || [];
       }
-      selectedAdditionalStackFileNames = projectDetection.secondaryStackFileNames || [];
+    } else if (projectDetection.hasExistingProjectFiles && projectDetection.recommendedStackFileName) {
+      detectionTransparency.quickConfirmation.response = 'explicit-selection-or-low-confidence';
+      detectionTransparency.decision.mode = 'explicit-selection-or-low-confidence';
+    } else if (!projectDetection.hasExistingProjectFiles) {
+      detectionTransparency.quickConfirmation.response = 'not-applicable';
+      detectionTransparency.decision.mode = 'fresh-directory';
     }
 
     if (shouldRunArchitectureRecommendation) {
@@ -805,10 +937,10 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
 
     const selectedResolvedStackFileName = selectedStackFileNameFromOption
       || selectedPreset?.stack
-      || (shouldAutoApplyDetectedStack ? projectDetection.recommendedStackFileName : null)
+      || selectedManualStackFileName
+      || (detectedSetupWasApplied ? projectDetection.recommendedStackFileName : null)
       || selectedProfilePack?.defaultStackFileName
       || selectedProfile.defaultStackFileName
-      || selectedManualStackFileName
       || stackFileNames[0];
 
     selectedAdditionalStackFileNames = normalizeAdditionalStackSelection(
@@ -816,9 +948,9 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       selectedAdditionalStackFileNames
     );
 
-    const recommendedBlueprintFileName = projectDetection.recommendedBlueprintFileName
-      && shouldAutoApplyDetectedStack
-      ? projectDetection.recommendedBlueprintFileName
+    const recommendedBlueprintFileName = detectedSetupWasApplied
+      && detectedBlueprintFileName
+      ? detectedBlueprintFileName
       : BLUEPRINT_RECOMMENDATIONS[selectedResolvedStackFileName] || null;
 
     if (!recommendedBlueprintFileName && !selectedBlueprintFileNameFromOption && !selectedProfile.defaultBlueprintFileName) {
@@ -864,6 +996,12 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         : derivedAdditionalBlueprintFileNames
     );
 
+    detectionTransparency.decision.selectedStackFileName = selectedResolvedStackFileName;
+    detectionTransparency.decision.selectedBlueprintFileName = selectedResolvedBlueprintFileName;
+    detectionTransparency.decision.selectedAdditionalStackFileNames = selectedAdditionalStackFileNames;
+    detectionTransparency.decision.selectedAdditionalBlueprintFileNames = selectedAdditionalBlueprintFileNames;
+    detectionTransparency.decision.usedDetectedSetup = detectedSetupWasApplied;
+
     const selectedSkillDomainNames = inferSkillDomainNamesFromSelection(
       selectedResolvedStackFileName,
       selectedResolvedBlueprintFileName,
@@ -883,6 +1021,8 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         ? selectedProfile.defaultCi
         : await askYesNo('Enable CI/CD quality checks (guardrails) and the LLM Judge policy?', userInterface, selectedProfile.defaultCi);
 
+    detectionTransparency.activeRulesSummary.ciGuardrailsEnabled = includeCiGuardrails;
+
     await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath, {
       includeMcpTemplate: shouldIncludeMcpTemplate,
     });
@@ -1044,6 +1184,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         stateFile: isMemoryContinuityEnabled ? '.agent-context/state/memory-continuity.json' : null,
       },
       architectRecommendation: architectureRecommendation,
+      detectionTransparency,
     });
 
     if (architectPreferenceUpdated && architectPreferenceState) {

package/lib/cli/commands/upgrade.mjs

@@ -24,7 +24,11 @@ import {
   copyGovernanceAssetsToTarget,
 } from '../utils.mjs';
 
-import { detectProjectContext } from '../detector.mjs';
+import {
+  detectProjectContext,
+  buildDetectionSummary,
+  formatDetectionCandidates,
+} from '../detector.mjs';
 import {
   buildCompiledRulesContent,
   writeSelectedPolicy,
@@ -76,6 +80,14 @@ export function parseUpgradeArguments(commandArguments) {
   return parsedUpgradeOptions;
 }
 
+function buildExistingProjectMajorConstraints() {
+  return [
+    'Preserve existing project markers and avoid forced stack migration.',
+    'Keep stack rule loading lazy and scoped to touched code.',
+    'Upgrade keeps prior onboarding choices unless user overrides them.',
+  ];
+}
+
 export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions = {}) {
   const resolvedTargetDirectoryPath = path.resolve(targetDirectoryArgument || '.');
 
@@ -143,6 +155,56 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       ? existingOnboardingReport.ciGuardrailsEnabled
       : true;
 
+    const detectionMajorConstraints = buildExistingProjectMajorConstraints();
+    const detectionTransparency = {
+      declaredAt: new Date().toISOString(),
+      declarationType: 'existing-project',
+      declarationShown: true,
+      detectionSummary: buildDetectionSummary(projectDetection),
+      activeRulesSummary: {
+        canonicalSource: '.instructions.md',
+        compiledEntrypoints: ['.cursorrules', '.windsurfrules'],
+        stackLoadingMode: 'lazy',
+        selectedProfile: selectedProfileName,
+        selectedProfileDisplayName: toTitleCase(selectedProfileName),
+        blockingSeverities: PROFILE_PRESETS[selectedProfileName]?.blockingSeverities || [],
+        ciGuardrailsEnabled: includeCiGuardrails,
+      },
+      majorConstraints: detectionMajorConstraints,
+      quickConfirmation: {
+        offered: false,
+        response: 'upgrade-auto',
+        source: 'upgrade-assistant',
+      },
+      decision: {
+        mode: 'upgrade-auto',
+        selectedStackFileName,
+        selectedBlueprintFileName,
+      },
+    };
+
+    console.log('\nExisting project detection transparency:');
+    if (projectDetection.recommendedStackFileName) {
+      const confidenceScoreLabel = Number(projectDetection.confidenceScore || 0).toFixed(2);
+      console.log(
+        `- Detected stack: ${toTitleCase(projectDetection.recommendedStackFileName)} (${projectDetection.confidenceLabel}, score ${confidenceScoreLabel})`
+      );
+    } else {
+      console.log('- Detected stack: unresolved (insufficient markers).');
+    }
+    console.log('- Active rules baseline: canonical .instructions.md -> compiled .cursorrules/.windsurfrules');
+    console.log(
+      `- Active review profile: ${toTitleCase(selectedProfileName)} (blocking severities: ${(
+        PROFILE_PRESETS[selectedProfileName]?.blockingSeverities || []
+      ).join(', ') || 'none'})`
+    );
+    console.log('- Top candidates:');
+    console.log(formatDetectionCandidates(projectDetection.rankedCandidates));
+    console.log('- Major constraints:');
+    for (const majorConstraint of detectionMajorConstraints) {
+      console.log(`  - ${majorConstraint}`);
+    }
+
     const selectedSkillDomainNames = inferSkillDomainNamesFromSelection(
       selectedStackFileName,
       selectedBlueprintFileName,
@@ -249,6 +311,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         compatibilityWarnings,
         runtimeEnvironment: existingOnboardingReport?.runtimeEnvironment || null,
         operationMode: 'upgrade',
+        detectionTransparency,
       });
 
       console.log('\nUpgrade complete.');

package/lib/cli/compiler.mjs

@@ -56,6 +56,7 @@ export async function writeOnboardingReport({
   tokenOptimization = undefined,
   memoryContinuity = undefined,
   architectRecommendation = null,
+  detectionTransparency = null,
 }) {
   const onboardingReportPath = path.join(targetDirectoryPath, '.agent-context', 'state', 'onboarding-report.json');
   const resolvedTokenOptimization = typeof tokenOptimization === 'undefined'
@@ -110,6 +111,7 @@ export async function writeOnboardingReport({
       detectionReasoning: projectDetection.detectionReasoning,
       rankedCandidates: projectDetection.rankedCandidates,
       evidence: projectDetection.evidence,
+      detectionTransparency: detectionTransparency || null,
     },
   };
 

package/package.json

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

package/scripts/validate.mjs

@@ -155,6 +155,31 @@ const REQUIRED_COMPLIANCE_CANONICAL_SNIPPETS = [
     label: 'release operations checklist keeps canonical term Federated Governance',
   },
 ];
+const REQUIRED_DETECTION_TRANSPARENCY_SNIPPETS = [
+  {
+    path: 'lib/cli/commands/init.mjs',
+    snippets: [
+      'Existing project detection transparency:',
+      'Use detected setup for this existing project?',
+      'detectionTransparency',
+    ],
+  },
+  {
+    path: 'lib/cli/commands/upgrade.mjs',
+    snippets: [
+      'Existing project detection transparency:',
+      'formatDetectionCandidates(projectDetection.rankedCandidates)',
+      'detectionTransparency',
+    ],
+  },
+  {
+    path: 'lib/cli/compiler.mjs',
+    snippets: [
+      'detectionTransparency = null',
+      'detectionTransparency: detectionTransparency || null',
+    ],
+  },
+];
 
 const validationResult = {
   passed: 0,
@@ -928,6 +953,28 @@ async function validateTerminologyMapping() {
   }
 }
 
+async function validateDetectionTransparencyCoverage() {
+  console.log('\nChecking existing-project detection transparency coverage...');
+
+  for (const transparencyRule of REQUIRED_DETECTION_TRANSPARENCY_SNIPPETS) {
+    const absoluteTransparencyPath = join(ROOT_DIR, transparencyRule.path);
+
+    if (!(await fileExists(absoluteTransparencyPath))) {
+      fail(`Missing detection transparency source: ${transparencyRule.path}`);
+      continue;
+    }
+
+    const transparencyContent = await readTextFile(absoluteTransparencyPath);
+    for (const requiredSnippet of transparencyRule.snippets) {
+      if (transparencyContent.includes(requiredSnippet)) {
+        pass(`${transparencyRule.path} includes detection transparency snippet: ${requiredSnippet}`);
+      } else {
+        fail(`${transparencyRule.path} is missing detection transparency snippet: ${requiredSnippet}`);
+      }
+    }
+  }
+}
+
 async function validateMcpConfiguration() {
   console.log('\nChecking MCP configuration...');
 
@@ -1177,6 +1224,7 @@ async function main() {
   await validateVersionConsistency();
   await validateDocumentationFlow();
   await validateTerminologyMapping();
+  await validateDetectionTransparencyCoverage();
   await validateMcpConfiguration();
   await validateHumanWritingGovernance();
   await validateInstructionAdapters();