@ryuenn3123/agentic-senior-core 2.0.5 → 2.0.8

package/lib/cli/commands/init.mjs

@@ -57,6 +57,7 @@ export function parseInitArguments(commandArguments) {
     newbie: false,
     tokenOptimize: true,
     tokenAgent: 'copilot',
+    includeMcpTemplate: false,
   };
 
   for (let argumentIndex = 0; argumentIndex < commandArguments.length; argumentIndex++) {
@@ -160,6 +161,11 @@ export function parseInitArguments(commandArguments) {
       continue;
     }
 
+    if (currentArgument === '--mcp-template') {
+      parsedInitOptions.includeMcpTemplate = true;
+      continue;
+    }
+
     throw new Error(`Unknown option: ${currentArgument}`);
   }
 
@@ -177,6 +183,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
   const isTokenOptimizationEnabled = typeof initOptions.tokenOptimize === 'boolean'
     ? initOptions.tokenOptimize
     : true;
+  const shouldIncludeMcpTemplate = initOptions.includeMcpTemplate === true;
   const selectedTokenAgentName = normalizeAgentName(initOptions.tokenAgent || 'copilot');
 
   if (resolvedTargetDirectoryPath.toLowerCase() === 'c:\\windows' || resolvedTargetDirectoryPath.toLowerCase() === 'c:\\windows\\system32') {
@@ -348,7 +355,9 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         ? selectedProfile.defaultCi
         : await askYesNo('Enable CI/CD guardrails and the LLM Judge policy?', userInterface, selectedProfile.defaultCi);
 
-    await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath);
+    await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath, {
+      includeMcpTemplate: shouldIncludeMcpTemplate,
+    });
 
     if (isTokenOptimizationEnabled) {
       const detectedExternalProxy = detectRtkBinary();
@@ -419,6 +428,8 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     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');
+    console.log(`- Repository workflows copied: no (workflows remain source-repo assets)`);
+    console.log(`- MCP template file: ${shouldIncludeMcpTemplate ? 'copied (mcp.json)' : 'not copied by default (use --mcp-template)'}`);
     if (isTokenOptimizationEnabled) {
       console.log(`- Token optimization policy: enabled for ${selectedTokenAgentName}`);
     } else {
@@ -427,6 +438,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     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('Your AI tools will now receive one compiled rulebook plus the original source rules, and your review threshold is stored in .agent-context/policies/llm-judge-threshold.json.');
+    console.log('MCP server registration is manual inside your IDE settings, even when mcp.json exists.');
   } catch (error) {
     console.error('\n[FATAL] An error occurred during initialization. Attempting automatic rollback...');
     try {

package/lib/cli/commands/optimize.mjs

@@ -1,171 +1,171 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-
-import { ensureDirectory, formatDuration } from '../utils.mjs';
-import { compileDynamicContext, loadOnboardingReportIfExists } from '../compiler.mjs';
-import {
-  TOKEN_OPTIMIZATION_REPORT_FILE_NAME,
-  normalizeAgentName,
-  detectRtkBinary,
-  buildRtkInstallHint,
-  buildRtkHookCommand,
-  createTokenOptimizationState,
-  readTokenOptimizationState,
-  writeTokenOptimizationState,
-} from '../token-optimization.mjs';
-
-function normalizeMarkdownFileName(rawFileName, fallbackFileName) {
-  if (typeof rawFileName !== 'string' || rawFileName.trim().length === 0) {
-    return fallbackFileName;
-  }
-
-  const normalizedFileName = rawFileName.trim();
-  return normalizedFileName.endsWith('.md')
-    ? normalizedFileName
-    : `${normalizedFileName}.md`;
-}
-
-export function parseOptimizeArguments(commandArguments) {
-  const parsedOptimizeOptions = {
-    targetDirectory: '.',
-    agent: 'copilot',
-    enabled: true,
-    show: false,
-  };
-
-  for (let argumentIndex = 0; argumentIndex < commandArguments.length; argumentIndex++) {
-    const currentArgument = commandArguments[argumentIndex];
-
-    if (!currentArgument.startsWith('--')) {
-      parsedOptimizeOptions.targetDirectory = currentArgument;
-      continue;
-    }
-
-    if (currentArgument === '--agent') {
-      parsedOptimizeOptions.agent = commandArguments[argumentIndex + 1] || 'copilot';
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--agent=')) {
-      parsedOptimizeOptions.agent = currentArgument.split('=')[1] || 'copilot';
-      continue;
-    }
-
-    if (currentArgument === '--enable') {
-      parsedOptimizeOptions.enabled = true;
-      continue;
-    }
-
-    if (currentArgument === '--disable') {
-      parsedOptimizeOptions.enabled = false;
-      continue;
-    }
-
-    if (currentArgument === '--show') {
-      parsedOptimizeOptions.show = true;
-      continue;
-    }
-
-    throw new Error(`Unknown option: ${currentArgument}`);
-  }
-
-  parsedOptimizeOptions.agent = normalizeAgentName(parsedOptimizeOptions.agent);
-  return parsedOptimizeOptions;
-}
-
-export async function runOptimizeCommand(targetDirectoryArgument, optimizeOptions = {}) {
-  const optimizationStartedAt = Date.now();
-  const resolvedTargetDirectoryPath = path.resolve(targetDirectoryArgument || '.');
-
-  await ensureDirectory(resolvedTargetDirectoryPath);
-
-  const selectedAgentName = normalizeAgentName(optimizeOptions.agent || 'copilot');
-  const rtkDetection = detectRtkBinary();
-
-  if (optimizeOptions.show) {
-    const existingOptimizationState = await readTokenOptimizationState(resolvedTargetDirectoryPath);
-    console.log(
-      JSON.stringify(
-        {
-          targetDirectory: resolvedTargetDirectoryPath,
-          selectedAgent: selectedAgentName,
-          externalProxy: rtkDetection,
-          tokenOptimizationState: existingOptimizationState,
-        },
-        null,
-        2
-      )
-    );
-    return;
-  }
-
-  const onboardingReport = await loadOnboardingReportIfExists(resolvedTargetDirectoryPath);
-  if (!onboardingReport) {
-    throw new Error(
-      'Token optimization requires an initialized repository. Run "agentic-senior-core init" first.'
-    );
-  }
-
-  const tokenOptimizationState = createTokenOptimizationState({
-    isEnabled: optimizeOptions.enabled,
-    selectedAgentName,
-    rtkDetection,
-  });
-
-  await writeTokenOptimizationState(resolvedTargetDirectoryPath, tokenOptimizationState);
-
-  const selectedProfileName = typeof onboardingReport.selectedProfile === 'string'
-    ? onboardingReport.selectedProfile
-    : 'balanced';
-  const selectedStackFileName = normalizeMarkdownFileName(onboardingReport.selectedStack, 'typescript.md');
-  const selectedBlueprintFileName = normalizeMarkdownFileName(onboardingReport.selectedBlueprint, 'api-nextjs.md');
-  const includeCiGuardrails = typeof onboardingReport.ciGuardrailsEnabled === 'boolean'
-    ? onboardingReport.ciGuardrailsEnabled
-    : true;
-
-  await compileDynamicContext({
-    targetDirectoryPath: resolvedTargetDirectoryPath,
-    selectedProfileName,
-    selectedStackFileName,
-    selectedBlueprintFileName,
-    includeCiGuardrails,
-  });
-
-  const optimizationDurationMs = Date.now() - optimizationStartedAt;
-  const tokenOptimizationReport = {
-    generatedAt: new Date().toISOString(),
-    targetDirectory: resolvedTargetDirectoryPath,
-    enabled: tokenOptimizationState.enabled,
-    selectedAgent: tokenOptimizationState.selectedAgent,
-    preferredShellProxy: tokenOptimizationState.preferredShellProxy,
-    externalProxy: tokenOptimizationState.externalProxy,
-    setupDurationMs: optimizationDurationMs,
-  };
-
-  const reportFilePath = path.join(
-    resolvedTargetDirectoryPath,
-    '.agent-context',
-    'state',
-    TOKEN_OPTIMIZATION_REPORT_FILE_NAME
-  );
-  await fs.writeFile(reportFilePath, JSON.stringify(tokenOptimizationReport, null, 2) + '\n', 'utf8');
-
-  console.log(`\nToken optimization ${tokenOptimizationState.enabled ? 'enabled' : 'disabled'}.`);
-  console.log(`- Target directory: ${resolvedTargetDirectoryPath}`);
-  console.log(`- Agent profile: ${tokenOptimizationState.selectedAgent}`);
-  console.log(`- Preferred shell proxy: ${tokenOptimizationState.preferredShellProxy}`);
-  console.log(`- Setup time: ${formatDuration(optimizationDurationMs)}`);
-  console.log('- Updated files: .cursorrules, .windsurfrules, .agent-context/state/token-optimization.json');
-
-  if (tokenOptimizationState.enabled) {
-    if (rtkDetection.isAvailable) {
-      console.log(`- External proxy detected: ${rtkDetection.version ? `v${rtkDetection.version}` : 'yes'}`);
-      console.log('- Recommended hook command:');
-      console.log(`  ${buildRtkHookCommand(tokenOptimizationState.selectedAgent)}`);
-    } else {
-      console.log('- External proxy not detected. Native fallback mode has been activated.');
-      console.log(`- Install hint: ${buildRtkInstallHint()}`);
-    }
-  }
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+import { ensureDirectory, formatDuration } from '../utils.mjs';
+import { compileDynamicContext, loadOnboardingReportIfExists } from '../compiler.mjs';
+import {
+  TOKEN_OPTIMIZATION_REPORT_FILE_NAME,
+  normalizeAgentName,
+  detectRtkBinary,
+  buildRtkInstallHint,
+  buildRtkHookCommand,
+  createTokenOptimizationState,
+  readTokenOptimizationState,
+  writeTokenOptimizationState,
+} from '../token-optimization.mjs';
+
+function normalizeMarkdownFileName(rawFileName, fallbackFileName) {
+  if (typeof rawFileName !== 'string' || rawFileName.trim().length === 0) {
+    return fallbackFileName;
+  }
+
+  const normalizedFileName = rawFileName.trim();
+  return normalizedFileName.endsWith('.md')
+    ? normalizedFileName
+    : `${normalizedFileName}.md`;
+}
+
+export function parseOptimizeArguments(commandArguments) {
+  const parsedOptimizeOptions = {
+    targetDirectory: '.',
+    agent: 'copilot',
+    enabled: true,
+    show: false,
+  };
+
+  for (let argumentIndex = 0; argumentIndex < commandArguments.length; argumentIndex++) {
+    const currentArgument = commandArguments[argumentIndex];
+
+    if (!currentArgument.startsWith('--')) {
+      parsedOptimizeOptions.targetDirectory = currentArgument;
+      continue;
+    }
+
+    if (currentArgument === '--agent') {
+      parsedOptimizeOptions.agent = commandArguments[argumentIndex + 1] || 'copilot';
+      argumentIndex += 1;
+      continue;
+    }
+
+    if (currentArgument.startsWith('--agent=')) {
+      parsedOptimizeOptions.agent = currentArgument.split('=')[1] || 'copilot';
+      continue;
+    }
+
+    if (currentArgument === '--enable') {
+      parsedOptimizeOptions.enabled = true;
+      continue;
+    }
+
+    if (currentArgument === '--disable') {
+      parsedOptimizeOptions.enabled = false;
+      continue;
+    }
+
+    if (currentArgument === '--show') {
+      parsedOptimizeOptions.show = true;
+      continue;
+    }
+
+    throw new Error(`Unknown option: ${currentArgument}`);
+  }
+
+  parsedOptimizeOptions.agent = normalizeAgentName(parsedOptimizeOptions.agent);
+  return parsedOptimizeOptions;
+}
+
+export async function runOptimizeCommand(targetDirectoryArgument, optimizeOptions = {}) {
+  const optimizationStartedAt = Date.now();
+  const resolvedTargetDirectoryPath = path.resolve(targetDirectoryArgument || '.');
+
+  await ensureDirectory(resolvedTargetDirectoryPath);
+
+  const selectedAgentName = normalizeAgentName(optimizeOptions.agent || 'copilot');
+  const rtkDetection = detectRtkBinary();
+
+  if (optimizeOptions.show) {
+    const existingOptimizationState = await readTokenOptimizationState(resolvedTargetDirectoryPath);
+    console.log(
+      JSON.stringify(
+        {
+          targetDirectory: resolvedTargetDirectoryPath,
+          selectedAgent: selectedAgentName,
+          externalProxy: rtkDetection,
+          tokenOptimizationState: existingOptimizationState,
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+
+  const onboardingReport = await loadOnboardingReportIfExists(resolvedTargetDirectoryPath);
+  if (!onboardingReport) {
+    throw new Error(
+      'Token optimization requires an initialized repository. Run "agentic-senior-core init" first.'
+    );
+  }
+
+  const tokenOptimizationState = createTokenOptimizationState({
+    isEnabled: optimizeOptions.enabled,
+    selectedAgentName,
+    rtkDetection,
+  });
+
+  await writeTokenOptimizationState(resolvedTargetDirectoryPath, tokenOptimizationState);
+
+  const selectedProfileName = typeof onboardingReport.selectedProfile === 'string'
+    ? onboardingReport.selectedProfile
+    : 'balanced';
+  const selectedStackFileName = normalizeMarkdownFileName(onboardingReport.selectedStack, 'typescript.md');
+  const selectedBlueprintFileName = normalizeMarkdownFileName(onboardingReport.selectedBlueprint, 'api-nextjs.md');
+  const includeCiGuardrails = typeof onboardingReport.ciGuardrailsEnabled === 'boolean'
+    ? onboardingReport.ciGuardrailsEnabled
+    : true;
+
+  await compileDynamicContext({
+    targetDirectoryPath: resolvedTargetDirectoryPath,
+    selectedProfileName,
+    selectedStackFileName,
+    selectedBlueprintFileName,
+    includeCiGuardrails,
+  });
+
+  const optimizationDurationMs = Date.now() - optimizationStartedAt;
+  const tokenOptimizationReport = {
+    generatedAt: new Date().toISOString(),
+    targetDirectory: resolvedTargetDirectoryPath,
+    enabled: tokenOptimizationState.enabled,
+    selectedAgent: tokenOptimizationState.selectedAgent,
+    preferredShellProxy: tokenOptimizationState.preferredShellProxy,
+    externalProxy: tokenOptimizationState.externalProxy,
+    setupDurationMs: optimizationDurationMs,
+  };
+
+  const reportFilePath = path.join(
+    resolvedTargetDirectoryPath,
+    '.agent-context',
+    'state',
+    TOKEN_OPTIMIZATION_REPORT_FILE_NAME
+  );
+  await fs.writeFile(reportFilePath, JSON.stringify(tokenOptimizationReport, null, 2) + '\n', 'utf8');
+
+  console.log(`\nToken optimization ${tokenOptimizationState.enabled ? 'enabled' : 'disabled'}.`);
+  console.log(`- Target directory: ${resolvedTargetDirectoryPath}`);
+  console.log(`- Agent profile: ${tokenOptimizationState.selectedAgent}`);
+  console.log(`- Preferred shell proxy: ${tokenOptimizationState.preferredShellProxy}`);
+  console.log(`- Setup time: ${formatDuration(optimizationDurationMs)}`);
+  console.log('- Updated files: .cursorrules, .windsurfrules, .agent-context/state/token-optimization.json');
+
+  if (tokenOptimizationState.enabled) {
+    if (rtkDetection.isAvailable) {
+      console.log(`- External proxy detected: ${rtkDetection.version ? `v${rtkDetection.version}` : 'yes'}`);
+      console.log('- Recommended hook command:');
+      console.log(`  ${buildRtkHookCommand(tokenOptimizationState.selectedAgent)}`);
+    } else {
+      console.log('- External proxy not detected. Native fallback mode has been activated.');
+      console.log(`- Install hint: ${buildRtkInstallHint()}`);
+    }
+  }
+}

package/lib/cli/commands/upgrade.mjs

@@ -43,6 +43,7 @@ export function parseUpgradeArguments(commandArguments) {
     targetDirectory: '.',
     dryRun: false,
     skipConfirmation: false,
+    includeMcpTemplate: false,
   };
 
   for (let argumentIndex = 0; argumentIndex < commandArguments.length; argumentIndex++) {
@@ -63,6 +64,11 @@ export function parseUpgradeArguments(commandArguments) {
       continue;
     }
 
+    if (currentArgument === '--mcp-template') {
+      parsedUpgradeOptions.includeMcpTemplate = true;
+      continue;
+    }
+
     throw new Error(`Unknown option: ${currentArgument}`);
   }
 
@@ -95,7 +101,9 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     console.log(`\nAgentic-Senior-Core CLI v${CLI_VERSION}`);
     console.log('Running upgrade assistant for an existing repository.');
 
-    await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath);
+    await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath, {
+      includeMcpTemplate: upgradeOptions.includeMcpTemplate === true,
+    });
 
     const stackFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'stacks'));
     const blueprintFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'blueprints'));