@ryuenn3123/agentic-senior-core 2.5.17 → 2.5.19

package/.agent-context/review-checklists/release-operations.md

@@ -2,6 +2,10 @@
 
 Use this checklist before promoting any release tag or package publish operation.
 
+## 0) Terminology Boundary (Compliance and Audit)
+- Compliance and audit artifacts keep the canonical enterprise term: `Federated Governance`.
+- Developer-facing aliases are allowed outside compliance artifacts when first mention includes the canonical term in parentheses.
+
 ## 1) Versioning and Changelog Integrity
 - `package.json` version is valid semantic version (`x.y.z`).
 - `CHANGELOG.md` has a matching release header for the package version.

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

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-18T02:40:52.883Z",
+  "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.17
+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.17
+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/README.md

@@ -7,7 +7,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
 
-**Production-grade rules engine for AI coding agents.**
+**Production-grade Rules Engine (Governance Engine) for AI coding agents.**
 Works with Cursor, Windsurf, GitHub Copilot, Claude Code, Gemini, and other LLM-powered IDE workflows.
 
 </div>
@@ -103,6 +103,8 @@ Use `--dry-run` first to preview changes safely, then apply with `--yes`.
 
 Rule: on first mention in developer-facing docs, include canonical term in parentheses.
 
+Full mapping reference: docs/terminology-mapping.md
+
 ---
 
 ## Reference Docs
@@ -115,6 +117,7 @@ Rule: on first mention in developer-facing docs, include canonical term in paren
 - V2 upgrade playbook: docs/v2-upgrade-playbook.md
 - Integration playbook: docs/integration-playbook.md
 - Benchmark and stack reference: docs/benchmark-reference.md
+- Terminology mapping reference: docs/terminology-mapping.md
 - Product roadmap: docs/roadmap.md
 
 ---

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.17",
+  "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

@@ -100,6 +100,86 @@ const REQUIRED_TERMINOLOGY_ROW_PATTERNS = [
 ];
 const REQUIRED_TERMINOLOGY_RULE_SNIPPET =
   'Rule: on first mention in developer-facing docs, include canonical term in parentheses.';
+const TERMINOLOGY_REFERENCE_DOCUMENT_PATH = 'docs/terminology-mapping.md';
+const REQUIRED_DEVELOPER_FIRST_MENTION_PATTERNS = [
+  {
+    path: 'README.md',
+    label: 'Rules Engine first mention includes Governance Engine',
+    pattern: /Rules Engine\s*\(Governance Engine\)/u,
+  },
+  {
+    path: 'docs/deep-dive.md',
+    label: 'Dynamic Rules Engine first mention includes Governance Engine',
+    pattern: /Dynamic Rules Engine\s*\(Governance Engine\)/u,
+  },
+  {
+    path: 'docs/faq.md',
+    label: 'Quality Checks first mention includes Guardrails',
+    pattern: /Quality Checks\s*\(Guardrails\)/u,
+  },
+  {
+    path: '.agent-context/prompts/init-project.md',
+    label: 'Init prompt first mention includes Federated Governance baseline',
+    pattern: /rules operations context\s*\(Federated Governance baseline\)/iu,
+  },
+  {
+    path: 'lib/cli/commands/init.mjs',
+    label: 'Init command wording includes Federated Governance baseline',
+    pattern: /rules operations\s+(assets|pack)[^\n]*\(Federated Governance baseline\)/iu,
+  },
+  {
+    path: 'lib/cli/commands/upgrade.mjs',
+    label: 'Upgrade command wording includes Federated Governance baseline',
+    pattern: /rules operations upgrade assistant\s*\(Federated Governance baseline\)/iu,
+  },
+  {
+    path: 'lib/cli/utils.mjs',
+    label: 'CLI help wording includes quality checks and guardrails',
+    pattern: /quality checks\s*\(guardrails\)/iu,
+  },
+];
+const COMPLIANCE_TERMINOLOGY_BOUNDARY_PATHS = [
+  '.agent-context/review-checklists/security-audit.md',
+  '.agent-context/review-checklists/performance-audit.md',
+  '.agent-context/review-checklists/release-operations.md',
+  'scripts/release-gate.mjs',
+  'scripts/forbidden-content-check.mjs',
+];
+const COMPLIANCE_ALIAS_TERMS = [
+  'Federated Rules Operations',
+];
+const REQUIRED_COMPLIANCE_CANONICAL_SNIPPETS = [
+  {
+    path: '.agent-context/review-checklists/release-operations.md',
+    snippet: 'Federated Governance',
+    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,
@@ -212,6 +292,7 @@ async function validateRequiredFiles() {
     'CHANGELOG.md',
     'docs/faq.md',
     'docs/deep-dive.md',
+    'docs/terminology-mapping.md',
     'docs/v1.7-execution-playbook.md',
     'docs/v1.7-issue-breakdown.md',
     'docs/v1.8-operations-playbook.md',
@@ -750,6 +831,40 @@ async function validateDocumentationFlow() {
 async function validateTerminologyMapping() {
   console.log('\nChecking terminology mapping consistency...');
 
+  const terminologyReferenceDocumentPath = join(ROOT_DIR, TERMINOLOGY_REFERENCE_DOCUMENT_PATH);
+
+  if (!(await fileExists(terminologyReferenceDocumentPath))) {
+    fail(`Missing terminology reference document: ${TERMINOLOGY_REFERENCE_DOCUMENT_PATH}`);
+  } else {
+    const terminologyReferenceContent = await readTextFile(terminologyReferenceDocumentPath);
+
+    if (terminologyReferenceContent.includes('Dual-Term Mapping')) {
+      pass(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} includes Dual-Term Mapping section`);
+    } else {
+      fail(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} must include Dual-Term Mapping section`);
+    }
+
+    for (const terminologyRowRule of REQUIRED_TERMINOLOGY_ROW_PATTERNS) {
+      if (terminologyRowRule.pattern.test(terminologyReferenceContent)) {
+        pass(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} includes mapping row: ${terminologyRowRule.label}`);
+      } else {
+        fail(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} is missing mapping row: ${terminologyRowRule.label}`);
+      }
+    }
+
+    if (terminologyReferenceContent.includes('first mention must include canonical term in parentheses')) {
+      pass(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} defines first-mention canonical term rule`);
+    } else {
+      fail(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} must define first-mention canonical term rule`);
+    }
+
+    if (terminologyReferenceContent.includes('Compliance and audit artifacts must keep canonical enterprise terminology')) {
+      pass(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} defines compliance terminology boundary`);
+    } else {
+      fail(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} must define compliance terminology boundary`);
+    }
+  }
+
   for (const terminologyReferencePath of TERMINOLOGY_REFERENCE_PATHS) {
     const absoluteReferencePath = join(ROOT_DIR, terminologyReferencePath);
 
@@ -779,6 +894,84 @@ async function validateTerminologyMapping() {
     } else {
       fail(`${terminologyReferencePath} must include first-mention canonical term rule`);
     }
+
+    if (referenceContent.includes(TERMINOLOGY_REFERENCE_DOCUMENT_PATH)) {
+      pass(`${terminologyReferencePath} links to ${TERMINOLOGY_REFERENCE_DOCUMENT_PATH}`);
+    } else {
+      fail(`${terminologyReferencePath} must link to ${TERMINOLOGY_REFERENCE_DOCUMENT_PATH}`);
+    }
+  }
+
+  for (const firstMentionRule of REQUIRED_DEVELOPER_FIRST_MENTION_PATTERNS) {
+    const absoluteFirstMentionPath = join(ROOT_DIR, firstMentionRule.path);
+
+    if (!(await fileExists(absoluteFirstMentionPath))) {
+      fail(`Missing developer-facing first-mention source: ${firstMentionRule.path}`);
+      continue;
+    }
+
+    const firstMentionContent = await readTextFile(absoluteFirstMentionPath);
+    if (firstMentionRule.pattern.test(firstMentionContent)) {
+      pass(`${firstMentionRule.path} keeps first-mention rule: ${firstMentionRule.label}`);
+    } else {
+      fail(`${firstMentionRule.path} must keep first-mention rule: ${firstMentionRule.label}`);
+    }
+  }
+
+  for (const compliancePath of COMPLIANCE_TERMINOLOGY_BOUNDARY_PATHS) {
+    const absoluteCompliancePath = join(ROOT_DIR, compliancePath);
+
+    if (!(await fileExists(absoluteCompliancePath))) {
+      fail(`Missing compliance/audit artifact for terminology boundary: ${compliancePath}`);
+      continue;
+    }
+
+    const complianceContent = await readTextFile(absoluteCompliancePath);
+    for (const aliasTerm of COMPLIANCE_ALIAS_TERMS) {
+      if (complianceContent.includes(aliasTerm)) {
+        fail(`${compliancePath} must not use developer-facing alias in compliance context: ${aliasTerm}`);
+      } else {
+        pass(`${compliancePath} keeps canonical terminology boundary for alias: ${aliasTerm}`);
+      }
+    }
+  }
+
+  for (const complianceRule of REQUIRED_COMPLIANCE_CANONICAL_SNIPPETS) {
+    const absoluteComplianceRulePath = join(ROOT_DIR, complianceRule.path);
+
+    if (!(await fileExists(absoluteComplianceRulePath))) {
+      fail(`Missing compliance canonical source: ${complianceRule.path}`);
+      continue;
+    }
+
+    const complianceRuleContent = await readTextFile(absoluteComplianceRulePath);
+    if (complianceRuleContent.includes(complianceRule.snippet)) {
+      pass(`${complianceRule.path} keeps canonical terminology rule: ${complianceRule.label}`);
+    } else {
+      fail(`${complianceRule.path} must keep canonical terminology rule: ${complianceRule.label}`);
+    }
+  }
+}
+
+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}`);
+      }
+    }
   }
 }
 
@@ -1031,6 +1224,7 @@ async function main() {
   await validateVersionConsistency();
   await validateDocumentationFlow();
   await validateTerminologyMapping();
+  await validateDetectionTransparencyCoverage();
   await validateMcpConfiguration();
   await validateHumanWritingGovernance();
   await validateInstructionAdapters();