@ryuenn3123/agentic-senior-core 2.5.16 → 2.5.18

package/.agent-context/prompts/init-project.md

@@ -1,7 +1,7 @@
 # Prompts: Initialize Project
 
 > Copy-paste one of these prompts to your AI agent (Cursor, Windsurf, Copilot, Antigravity) right after cloning this repository.
-> V1.4 recommendation: run `bunx @fatidaprilian/agentic-senior-core init` first to compile dynamic governance context.
+> V1.4 recommendation: run `bunx @fatidaprilian/agentic-senior-core init` first to compile dynamic rules operations context (Federated Governance baseline).
 
 ---
 

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:25:05.037Z",
+  "generatedAt": "2026-04-18T02:48:53.130Z",
   "reportName": "memory-continuity-benchmark",
   "schemaVersion": "1.0.0",
   "passed": true,

package/.cursorrules

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

package/.windsurfrules

@@ -1,7 +1,7 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.5.16
-Timestamp: 2026-04-18T00:00:00.000Z
+Generated by Agentic-Senior-Core CLI v2.5.18
+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>
@@ -74,7 +74,7 @@ If you see `Property $schema is not allowed`, keep `.vscode/mcp.json` without `$
 
 | Command | Purpose |
 |---------|---------|
-| `agentic-senior-core init` | Initialize governance context |
+| `agentic-senior-core init` | Initialize rules operations context (Federated Governance baseline) |
 | `agentic-senior-core upgrade --dry-run` | Preview safe upgrades |
 | `agentic-senior-core optimize --show` | Show token optimization state |
 | `agentic-senior-core skill frontend --tier advance` | Select skill packs |
@@ -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

@@ -583,7 +583,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     }
 
     console.log(`\nAgentic-Senior-Core CLI v${CLI_VERSION}`);
-    console.log('I will copy governance files into your target folder and compile a single rulebook for your AI tools.');
+    console.log('I will copy rules operations assets (Federated Governance baseline) into your target folder and compile a single rulebook for your AI tools.');
 
     if (selectedPreset) {
       console.log(`Using preset: ${initOptions.preset} (${selectedPreset.description}).`);
@@ -881,7 +881,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
           ? selectedProfilePack.defaultCi
       : selectedProfile.lockCi
         ? selectedProfile.defaultCi
-        : await askYesNo('Enable CI/CD guardrails and the LLM Judge policy?', userInterface, selectedProfile.defaultCi);
+        : await askYesNo('Enable CI/CD quality checks (guardrails) and the LLM Judge policy?', userInterface, selectedProfile.defaultCi);
 
     await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath, {
       includeMcpTemplate: shouldIncludeMcpTemplate,
@@ -1078,7 +1078,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log(`- Additional blueprints: ${selectedAdditionalBlueprintFileNames.map((blueprintFileName) => toTitleCase(blueprintFileName)).join(', ')}`);
     }
     console.log(`- Runtime environment: ${resolveRuntimeEnvironmentLabelFromKey(selectedRuntimeEnvironmentKey)} (detected: ${detectedRuntimeEnvironment.label})`);
-    console.log(`- CI/CD guardrails: ${includeCiGuardrails ? 'enabled' : 'disabled'}`);
+    console.log(`- CI/CD quality checks (guardrails): ${includeCiGuardrails ? 'enabled' : 'disabled'}`);
     console.log(`- Blocking severities: ${formatBlockingSeverities(selectedProfile.blockingSeverities)}`);
     console.log(`- Setup time: ${formatDuration(setupDurationMs)}`);
     console.log('- Generated files: .cursorrules, .windsurfrules, and .agent-context/state/onboarding-report.json');
@@ -1099,7 +1099,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log('- Token optimization policy: disabled (--no-token-optimize)');
     }
     console.log('\nPlain-language summary:');
-    console.log(`I prepared a ${selectedProfile.displayName.toLowerCase()} governance pack for a ${toTitleCase(selectedResolvedStackFileName)} project using the ${toTitleCase(selectedResolvedBlueprintFileName)} blueprint.`);
+    console.log(`I prepared a ${selectedProfile.displayName.toLowerCase()} rules operations pack (Federated Governance baseline) for a ${toTitleCase(selectedResolvedStackFileName)} project using the ${toTitleCase(selectedResolvedBlueprintFileName)} blueprint.`);
     if (selectedAdditionalStackFileNames.length > 0) {
       console.log(`I also included additional stack context for ${selectedAdditionalStackFileNames.map((stackFileName) => toTitleCase(stackFileName)).join(', ')}.`);
     }

package/lib/cli/commands/upgrade.mjs

@@ -100,7 +100,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
 
   try {
     console.log(`\nAgentic-Senior-Core CLI v${CLI_VERSION}`);
-    console.log('Running upgrade assistant for an existing repository.');
+    console.log('Running rules operations upgrade assistant (Federated Governance baseline) for an existing repository.');
 
     await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath, {
       includeMcpTemplate: upgradeOptions.includeMcpTemplate === true,
@@ -193,7 +193,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     if (selectedAdditionalBlueprintFileNames.length > 0) {
       console.log(`- Additional blueprints: ${selectedAdditionalBlueprintFileNames.map((blueprintFileName) => toTitleCase(blueprintFileName)).join(', ')}`);
     }
-    console.log(`- CI/CD guardrails: ${includeCiGuardrails ? 'enabled' : 'disabled'}`);
+    console.log(`- CI/CD quality checks (guardrails): ${includeCiGuardrails ? 'enabled' : 'disabled'}`);
     console.log(`- Existing rules lines: ${currentRuleLineCount}`);
     console.log(`- Planned rules lines: ${plannedRuleLineCount}`);
     console.log(`- Rules changed: ${isRulesContentChanged ? 'yes' : 'no'}`);

package/lib/cli/utils.mjs

@@ -49,7 +49,7 @@ export function printUsage() {
   console.log('  --project-description  Architecture intent text used for stack/blueprint recommendation');
   console.log('  --architect-token-budget  Max token estimate used by recommendation research (default: 900)');
   console.log('  --architect-timeout-ms  Max recommendation research time in milliseconds (default: 1500)');
-  console.log('  --ci         Override CI/CD guardrails (true|false)');
+  console.log('  --ci         Override CI/CD quality checks (guardrails) (true|false)');
   console.log('  --token-optimize  Explicitly enable token optimization policy during init (default behavior)');
   console.log('  --token-agent     Set token optimization agent target (copilot, claude, cursor, windsurf, gemini, codex, cline)');
   console.log('  --no-token-optimize  Disable token optimization policy during init');

package/package.json

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

package/scripts/validate.mjs

@@ -80,6 +80,81 @@ const REQUIRED_HUMAN_WRITING_SNIPPETS = [
     ],
   },
 ];
+const TERMINOLOGY_REFERENCE_PATHS = [
+  'README.md',
+  'docs/roadmap.md',
+];
+const REQUIRED_TERMINOLOGY_ROW_PATTERNS = [
+  {
+    label: 'Federated Governance -> Federated Rules Operations',
+    pattern: /\|\s*Federated Governance\s*\|\s*Federated Rules Operations\s*\|/u,
+  },
+  {
+    label: 'Governance Engine -> Rules Engine',
+    pattern: /\|\s*Governance Engine\s*\|\s*Rules Engine\s*\|/u,
+  },
+  {
+    label: 'Guardrails -> Quality Checks',
+    pattern: /\|\s*Guardrails\s*\|\s*Quality Checks\s*\|/u,
+  },
+];
+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 validationResult = {
   passed: 0,
@@ -192,6 +267,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',
@@ -727,6 +803,131 @@ 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);
+
+    if (!(await fileExists(absoluteReferencePath))) {
+      fail(`Missing terminology reference source: ${terminologyReferencePath}`);
+      continue;
+    }
+
+    const referenceContent = await readTextFile(absoluteReferencePath);
+
+    if (referenceContent.includes('Terminology Mapping (Final)')) {
+      pass(`${terminologyReferencePath} includes Terminology Mapping (Final)`);
+    } else {
+      fail(`${terminologyReferencePath} must include Terminology Mapping (Final)`);
+    }
+
+    for (const terminologyRowRule of REQUIRED_TERMINOLOGY_ROW_PATTERNS) {
+      if (terminologyRowRule.pattern.test(referenceContent)) {
+        pass(`${terminologyReferencePath} includes mapping row: ${terminologyRowRule.label}`);
+      } else {
+        fail(`${terminologyReferencePath} is missing mapping row: ${terminologyRowRule.label}`);
+      }
+    }
+
+    if (referenceContent.includes(REQUIRED_TERMINOLOGY_RULE_SNIPPET)) {
+      pass(`${terminologyReferencePath} includes first-mention canonical term rule`);
+    } 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 validateMcpConfiguration() {
   console.log('\nChecking MCP configuration...');
 
@@ -975,6 +1176,7 @@ async function main() {
   await validatePolicyFile();
   await validateVersionConsistency();
   await validateDocumentationFlow();
+  await validateTerminologyMapping();
   await validateMcpConfiguration();
   await validateHumanWritingGovernance();
   await validateInstructionAdapters();