@ryuenn3123/agentic-senior-core 2.0.5 → 2.0.7

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/compatibility.mjs

@@ -1,124 +1,124 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { platform, version } from 'node:process';
-
-import { pathExists } from './utils.mjs';
-
-export const SKILL_COMPATIBILITY_MANIFEST_FILE_NAME = 'compatibility-manifest.json';
-
-export function getCurrentPlatformLabel() {
-  if (platform === 'win32') {
-    return 'windows';
-  }
-
-  if (platform === 'darwin') {
-    return 'macos';
-  }
-
-  return 'linux';
-}
-
-export function parseNodeMajorVersion(rawVersionString = version) {
-  const normalizedVersionString = String(rawVersionString || '').trim();
-  const numericVersion = normalizedVersionString.startsWith('v')
-    ? normalizedVersionString.slice(1)
-    : normalizedVersionString;
-
-  const majorSegment = numericVersion.split('.')[0];
-  const parsedMajorVersion = Number.parseInt(majorSegment, 10);
-  return Number.isNaN(parsedMajorVersion) ? null : parsedMajorVersion;
-}
-
-export function parseNodeMinimumMajor(rawNodeMinimum) {
-  const normalizedNodeMinimum = String(rawNodeMinimum || '').trim();
-  if (!normalizedNodeMinimum) {
-    return null;
-  }
-
-  const majorSegment = normalizedNodeMinimum.split('.')[0];
-  const parsedMajorVersion = Number.parseInt(majorSegment, 10);
-  return Number.isNaN(parsedMajorVersion) ? null : parsedMajorVersion;
-}
-
-export async function readSkillDomainCompatibilityManifest(targetDirectoryPath, skillDomainName) {
-  const compatibilityManifestPath = path.join(
-    targetDirectoryPath,
-    '.agent-context',
-    'skills',
-    skillDomainName,
-    SKILL_COMPATIBILITY_MANIFEST_FILE_NAME
-  );
-
-  if (!(await pathExists(compatibilityManifestPath))) {
-    return {
-      exists: false,
-      compatibilityManifestPath,
-      parsedManifest: null,
-    };
-  }
-
-  try {
-    const compatibilityManifestContent = await fs.readFile(compatibilityManifestPath, 'utf8');
-    return {
-      exists: true,
-      compatibilityManifestPath,
-      parsedManifest: JSON.parse(compatibilityManifestContent),
-    };
-  } catch (error) {
-    return {
-      exists: true,
-      compatibilityManifestPath,
-      parsedManifest: null,
-      parseError: error instanceof Error ? error.message : String(error),
-    };
-  }
-}
-
-export async function evaluateSkillDomainCompatibility(targetDirectoryPath, skillDomainNames) {
-  const uniqueSkillDomainNames = Array.from(new Set(skillDomainNames || []));
-  const compatibilityWarnings = [];
-
-  const currentPlatformLabel = getCurrentPlatformLabel();
-  const currentNodeMajorVersion = parseNodeMajorVersion(version);
-
-  for (const skillDomainName of uniqueSkillDomainNames) {
-    const manifestResult = await readSkillDomainCompatibilityManifest(targetDirectoryPath, skillDomainName);
-
-    if (!manifestResult.exists) {
-      compatibilityWarnings.push(
-        `Domain ${skillDomainName} has no ${SKILL_COMPATIBILITY_MANIFEST_FILE_NAME}; compatibility cannot be verified.`
-      );
-      continue;
-    }
-
-    if (!manifestResult.parsedManifest) {
-      compatibilityWarnings.push(
-        `Domain ${skillDomainName} has invalid ${SKILL_COMPATIBILITY_MANIFEST_FILE_NAME}: ${manifestResult.parseError || 'Unknown parse error'}.`
-      );
-      continue;
-    }
-
-    const manifestPlatforms = Array.isArray(manifestResult.parsedManifest.platforms)
-      ? manifestResult.parsedManifest.platforms
-      : [];
-
-    if (manifestPlatforms.length > 0 && !manifestPlatforms.includes(currentPlatformLabel)) {
-      compatibilityWarnings.push(
-        `Domain ${skillDomainName} does not list platform ${currentPlatformLabel} in ${SKILL_COMPATIBILITY_MANIFEST_FILE_NAME}.`
-      );
-    }
-
-    const minimumNodeMajorVersion = parseNodeMinimumMajor(manifestResult.parsedManifest.nodeMin);
-    if (
-      typeof minimumNodeMajorVersion === 'number'
-      && typeof currentNodeMajorVersion === 'number'
-      && currentNodeMajorVersion < minimumNodeMajorVersion
-    ) {
-      compatibilityWarnings.push(
-        `Domain ${skillDomainName} requires Node.js >= ${minimumNodeMajorVersion}, current major version is ${currentNodeMajorVersion}.`
-      );
-    }
-  }
-
-  return compatibilityWarnings;
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { platform, version } from 'node:process';
+
+import { pathExists } from './utils.mjs';
+
+export const SKILL_COMPATIBILITY_MANIFEST_FILE_NAME = 'compatibility-manifest.json';
+
+export function getCurrentPlatformLabel() {
+  if (platform === 'win32') {
+    return 'windows';
+  }
+
+  if (platform === 'darwin') {
+    return 'macos';
+  }
+
+  return 'linux';
+}
+
+export function parseNodeMajorVersion(rawVersionString = version) {
+  const normalizedVersionString = String(rawVersionString || '').trim();
+  const numericVersion = normalizedVersionString.startsWith('v')
+    ? normalizedVersionString.slice(1)
+    : normalizedVersionString;
+
+  const majorSegment = numericVersion.split('.')[0];
+  const parsedMajorVersion = Number.parseInt(majorSegment, 10);
+  return Number.isNaN(parsedMajorVersion) ? null : parsedMajorVersion;
+}
+
+export function parseNodeMinimumMajor(rawNodeMinimum) {
+  const normalizedNodeMinimum = String(rawNodeMinimum || '').trim();
+  if (!normalizedNodeMinimum) {
+    return null;
+  }
+
+  const majorSegment = normalizedNodeMinimum.split('.')[0];
+  const parsedMajorVersion = Number.parseInt(majorSegment, 10);
+  return Number.isNaN(parsedMajorVersion) ? null : parsedMajorVersion;
+}
+
+export async function readSkillDomainCompatibilityManifest(targetDirectoryPath, skillDomainName) {
+  const compatibilityManifestPath = path.join(
+    targetDirectoryPath,
+    '.agent-context',
+    'skills',
+    skillDomainName,
+    SKILL_COMPATIBILITY_MANIFEST_FILE_NAME
+  );
+
+  if (!(await pathExists(compatibilityManifestPath))) {
+    return {
+      exists: false,
+      compatibilityManifestPath,
+      parsedManifest: null,
+    };
+  }
+
+  try {
+    const compatibilityManifestContent = await fs.readFile(compatibilityManifestPath, 'utf8');
+    return {
+      exists: true,
+      compatibilityManifestPath,
+      parsedManifest: JSON.parse(compatibilityManifestContent),
+    };
+  } catch (error) {
+    return {
+      exists: true,
+      compatibilityManifestPath,
+      parsedManifest: null,
+      parseError: error instanceof Error ? error.message : String(error),
+    };
+  }
+}
+
+export async function evaluateSkillDomainCompatibility(targetDirectoryPath, skillDomainNames) {
+  const uniqueSkillDomainNames = Array.from(new Set(skillDomainNames || []));
+  const compatibilityWarnings = [];
+
+  const currentPlatformLabel = getCurrentPlatformLabel();
+  const currentNodeMajorVersion = parseNodeMajorVersion(version);
+
+  for (const skillDomainName of uniqueSkillDomainNames) {
+    const manifestResult = await readSkillDomainCompatibilityManifest(targetDirectoryPath, skillDomainName);
+
+    if (!manifestResult.exists) {
+      compatibilityWarnings.push(
+        `Domain ${skillDomainName} has no ${SKILL_COMPATIBILITY_MANIFEST_FILE_NAME}; compatibility cannot be verified.`
+      );
+      continue;
+    }
+
+    if (!manifestResult.parsedManifest) {
+      compatibilityWarnings.push(
+        `Domain ${skillDomainName} has invalid ${SKILL_COMPATIBILITY_MANIFEST_FILE_NAME}: ${manifestResult.parseError || 'Unknown parse error'}.`
+      );
+      continue;
+    }
+
+    const manifestPlatforms = Array.isArray(manifestResult.parsedManifest.platforms)
+      ? manifestResult.parsedManifest.platforms
+      : [];
+
+    if (manifestPlatforms.length > 0 && !manifestPlatforms.includes(currentPlatformLabel)) {
+      compatibilityWarnings.push(
+        `Domain ${skillDomainName} does not list platform ${currentPlatformLabel} in ${SKILL_COMPATIBILITY_MANIFEST_FILE_NAME}.`
+      );
+    }
+
+    const minimumNodeMajorVersion = parseNodeMinimumMajor(manifestResult.parsedManifest.nodeMin);
+    if (
+      typeof minimumNodeMajorVersion === 'number'
+      && typeof currentNodeMajorVersion === 'number'
+      && currentNodeMajorVersion < minimumNodeMajorVersion
+    ) {
+      compatibilityWarnings.push(
+        `Domain ${skillDomainName} requires Node.js >= ${minimumNodeMajorVersion}, current major version is ${currentNodeMajorVersion}.`
+      );
+    }
+  }
+
+  return compatibilityWarnings;
+}

package/lib/cli/constants.mjs

@@ -93,6 +93,41 @@ export const INIT_PRESETS = {
     ci: true,
     description: 'Observability and platform starter',
   },
+  'typescript-nestjs-service': {
+    profile: 'balanced',
+    stack: 'typescript.md',
+    blueprint: 'nestjs-logic.md',
+    ci: true,
+    description: 'TypeScript service starter with NestJS module blueprint',
+  },
+  'java-enterprise-api': {
+    profile: 'strict',
+    stack: 'java.md',
+    blueprint: 'spring-boot-api.md',
+    ci: true,
+    description: 'Enterprise API starter for JVM teams',
+  },
+  'dotnet-enterprise-api': {
+    profile: 'strict',
+    stack: 'csharp.md',
+    blueprint: 'aspnet-api.md',
+    ci: true,
+    description: '.NET API starter with strict governance defaults',
+  },
+  'php-laravel-api': {
+    profile: 'balanced',
+    stack: 'php.md',
+    blueprint: 'laravel-api.md',
+    ci: true,
+    description: 'Laravel API starter with balanced guardrails',
+  },
+  'kubernetes-platform': {
+    profile: 'strict',
+    stack: 'go.md',
+    blueprint: 'kubernetes-manifests.md',
+    ci: true,
+    description: 'Platform starter focused on Kubernetes delivery assets',
+  },
 };
 
 export const PROFILE_PRESETS = {