@ryuenn3123/agentic-senior-core 4.4.0 → 5.2.0

package/lib/cli/commands/launch.mjs

@@ -1,76 +0,0 @@
-/**
- * Launch Command — Numbered interactive launcher.
- * Depends on: constants, utils, init command
- */
-import { createInterface } from 'node:readline/promises';
-import { stdin, stdout } from 'node:process';
-
-import { CLI_VERSION, INIT_PRESETS } from '../constants.mjs';
-import { askChoice, normalizeChoiceInput } from '../utils.mjs';
-import { runInitCommand } from './init.mjs';
-import { runOptimizeCommand } from './optimize.mjs';
-
-export async function runLaunchCommand() {
-  const userInterface = createInterface({ input: stdin, output: stdout });
-
-  try {
-    console.log(`\nAgentic-Senior-Core CLI v${CLI_VERSION}`);
-    console.log('Start with a numbered choice. You can still use commands later if you want direct control.');
-
-    const launchChoice = await askChoice(
-      'How do you want to start?',
-      [
-        'npm / npx path',
-        'Scope hint preset',
-        'Interactive init wizard',
-        'Enable token optimization',
-        'Exit',
-      ],
-      userInterface
-    );
-
-    if (launchChoice === 'npm / npx path') {
-      console.log('\nChoose one of these package paths:');
-      console.log('npm exec --yes @ryuenn3123/agentic-senior-core init');
-      console.log('npx @ryuenn3123/agentic-senior-core init');
-      console.log('npm install -g @ryuenn3123/agentic-senior-core && agentic-senior-core init');
-      return;
-    }
-
-    if (launchChoice === 'Scope hint preset') {
-      const presetNames = Object.keys(INIT_PRESETS);
-      const selectedPresetName = await askChoice(
-        'Choose a scope hint preset:',
-        presetNames.map((presetName) => `${presetName} - ${INIT_PRESETS[presetName].description}`),
-        userInterface
-      );
-
-      await runInitCommand('.', { preset: normalizeChoiceInput(selectedPresetName.split(' - ')[0]) });
-      return;
-    }
-
-    if (launchChoice === 'Interactive init wizard') {
-      await runInitCommand('.', {});
-      return;
-    }
-
-    if (launchChoice === 'Enable token optimization') {
-      const selectedAgent = await askChoice(
-        'Choose your primary agent integration:',
-        ['copilot', 'claude', 'cursor', 'windsurf', 'gemini', 'codex', 'cline'],
-        userInterface
-      );
-
-      await runOptimizeCommand('.', {
-        targetDirectory: '.',
-        agent: selectedAgent,
-        enabled: true,
-      });
-      return;
-    }
-
-    console.log('Exit selected.');
-  } finally {
-    userInterface.close();
-  }
-}

package/lib/cli/commands/optimize.mjs

@@ -1,284 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-
-import { ensureDirectory, formatDuration } from '../utils.mjs';
-import { loadOnboardingReportIfExists } from '../compiler.mjs';
-import {
-  TOKEN_OPTIMIZATION_REPORT_FILE_NAME,
-  normalizeAgentName,
-  detectRtkBinary,
-  detectAscxRuntime,
-  checkAscxTeeReadiness,
-  resolveRuntimeTokenSaverMode,
-  buildRuntimeTokenSaverWarnings,
-  buildRuntimeTokenSaverNextAction,
-  buildRtkInstallHint,
-  buildRtkHookCommand,
-  createTokenOptimizationState,
-  readTokenOptimizationState,
-  writeTokenOptimizationState,
-} from '../token-optimization.mjs';
-
-export function parseOptimizeArguments(commandArguments) {
-  const parsedOptimizeOptions = {
-    targetDirectory: '.',
-    agent: 'copilot',
-    enabled: true,
-    mode: 'configure',
-    show: false,
-  };
-
-  function setOptimizeMode(nextMode) {
-    if (parsedOptimizeOptions.mode !== 'configure' && parsedOptimizeOptions.mode !== nextMode) {
-      throw new Error(`Conflicting optimize modes: ${parsedOptimizeOptions.mode} and ${nextMode}`);
-    }
-
-    parsedOptimizeOptions.mode = nextMode;
-  }
-
-  for (let argumentIndex = 0; argumentIndex < commandArguments.length; argumentIndex++) {
-    const currentArgument = commandArguments[argumentIndex];
-
-    if (currentArgument === 'install') {
-      setOptimizeMode('install');
-      parsedOptimizeOptions.enabled = true;
-      continue;
-    }
-
-    if (currentArgument === 'off') {
-      setOptimizeMode('off');
-      parsedOptimizeOptions.enabled = false;
-      continue;
-    }
-
-    if (currentArgument === 'status') {
-      setOptimizeMode('status');
-      continue;
-    }
-
-    if (currentArgument === 'doctor') {
-      setOptimizeMode('doctor');
-      continue;
-    }
-
-    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;
-      if (parsedOptimizeOptions.mode === 'off') {
-        setOptimizeMode('install');
-      }
-      continue;
-    }
-
-    if (currentArgument === '--disable') {
-      parsedOptimizeOptions.enabled = false;
-      if (parsedOptimizeOptions.mode === 'install') {
-        setOptimizeMode('off');
-      }
-      continue;
-    }
-
-    if (currentArgument === '--show') {
-      setOptimizeMode('show');
-      parsedOptimizeOptions.show = true;
-      continue;
-    }
-
-    if (currentArgument === '--status') {
-      setOptimizeMode('status');
-      continue;
-    }
-
-    if (currentArgument === '--doctor') {
-      setOptimizeMode('doctor');
-      continue;
-    }
-
-    throw new Error(`Unknown option: ${currentArgument}`);
-  }
-
-  parsedOptimizeOptions.agent = normalizeAgentName(parsedOptimizeOptions.agent);
-  return parsedOptimizeOptions;
-}
-
-function formatStatusLine(label, value) {
-  return `${label}: ${value}`;
-}
-
-async function buildRuntimeTokenSaverStatus(resolvedTargetDirectoryPath, options = {}) {
-  const onboardingReport = await loadOnboardingReportIfExists(resolvedTargetDirectoryPath);
-  const existingOptimizationState = await readTokenOptimizationState(resolvedTargetDirectoryPath);
-  const ascxDetection = detectAscxRuntime();
-  const rtkDetection = detectRtkBinary();
-  const teeReadiness = await checkAscxTeeReadiness(resolvedTargetDirectoryPath, {
-    writeProbe: options.writeProbe === true,
-  });
-  const mode = resolveRuntimeTokenSaverMode({
-    tokenOptimizationState: existingOptimizationState,
-    ascxDetection,
-    rtkDetection,
-  });
-  const warnings = buildRuntimeTokenSaverWarnings({
-    mode,
-    onboardingReport,
-    ascxDetection,
-    teeReadiness,
-    rtkDetection,
-  });
-
-  return {
-    targetDirectory: resolvedTargetDirectoryPath,
-    initialized: Boolean(onboardingReport),
-    mode,
-    ascx: ascxDetection,
-    tee: teeReadiness,
-    rtk: rtkDetection,
-    nineRouter: {
-      status: 'not-checked',
-      reason: 'localhost probing is intentionally deferred',
-    },
-    warnings,
-    nextAction: buildRuntimeTokenSaverNextAction({ mode, warnings }),
-    tokenOptimizationState: existingOptimizationState,
-  };
-}
-
-function printRuntimeTokenSaverStatus(statusReport, options = {}) {
-  const title = options.title || 'Runtime token saver status';
-  const ascxStatus = statusReport.ascx.isAvailable
-    ? `found (${statusReport.ascx.source})`
-    : 'missing';
-  const rtkStatus = statusReport.rtk.isAvailable
-    ? `detected${statusReport.rtk.version ? ` (${statusReport.rtk.version})` : ''}`
-    : 'not-detected';
-
-  console.log(title);
-  console.log(formatStatusLine('target', statusReport.targetDirectory));
-  console.log(formatStatusLine('initialized', statusReport.initialized ? 'yes' : 'no'));
-  console.log(formatStatusLine('mode', statusReport.mode));
-  console.log(formatStatusLine('ascx', ascxStatus));
-  console.log(formatStatusLine('tee', `${statusReport.tee.status} (${statusReport.tee.path})`));
-  console.log(formatStatusLine('rtk', rtkStatus));
-  console.log(formatStatusLine('9router', statusReport.nineRouter.status));
-
-  if (statusReport.warnings.length > 0) {
-    console.log('warnings:');
-    for (const warning of statusReport.warnings) {
-      console.log(`- ${warning}`);
-    }
-  } else {
-    console.log('warnings: none');
-  }
-
-  console.log(formatStatusLine('next_action', statusReport.nextAction));
-}
-
-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.mode === 'status') {
-    const statusReport = await buildRuntimeTokenSaverStatus(resolvedTargetDirectoryPath);
-    printRuntimeTokenSaverStatus(statusReport);
-    return;
-  }
-
-  if (optimizeOptions.mode === 'doctor') {
-    const statusReport = await buildRuntimeTokenSaverStatus(resolvedTargetDirectoryPath, {
-      writeProbe: true,
-    });
-    printRuntimeTokenSaverStatus(statusReport, {
-      title: 'ASCX runtime token saver doctor',
-    });
-    return;
-  }
-
-  if (optimizeOptions.show || optimizeOptions.mode === '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.mode === 'off' ? false : optimizeOptions.enabled,
-    selectedAgentName,
-    rtkDetection,
-  });
-
-  await writeTokenOptimizationState(resolvedTargetDirectoryPath, tokenOptimizationState);
-
-  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: .agent-context/state/token-optimization.json and .agent-context/state/token-optimization-report.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/rollback.mjs

@@ -1,64 +0,0 @@
-import path from 'node:path';
-import { performRollback } from '../rollback.mjs';
-import { ensureDirectory } from '../utils.mjs';
-
-/**
- * Command module for `rollback`
- */
-export async function runRollbackCommand(commandArguments) {
-  // Parse simple argument <targetDir>
-  const targetDirectoryArgument = commandArguments.length > 0 ? commandArguments[0] : null;
-
-  if (!targetDirectoryArgument) {
-    console.error('Usage: agentic-senior-core rollback <target-directory>');
-    process.exit(1);
-  }
-
-  const resolvedTargetDirectoryPath = path.resolve(targetDirectoryArgument);
-
-  if (resolvedTargetDirectoryPath.toLowerCase() === 'c:\\windows' || resolvedTargetDirectoryPath.toLowerCase() === 'c:\\windows\\system32') {
-    console.error('\n[FATAL] Target directory resolved to a Windows system folder (C:\\Windows).');
-    console.error('If you are running Windows npm from inside WSL, this is caused by cmd.exe lacking UNC path support.');
-    console.error('Please install and use a native Linux Node.js/npm directly inside WSL to setup your project.');
-    process.exit(1);
-  }
-  
-  try {
-      await ensureDirectory(resolvedTargetDirectoryPath);
-    } catch {
-      console.error(`[FATAL] Cannot access target directory: ${resolvedTargetDirectoryPath}`);
-      process.exit(1);
-  }
-
-  console.log(`Starting manual rollback for directory: ${resolvedTargetDirectoryPath} ...\n`);
-
-  try {
-      const report = await performRollback(resolvedTargetDirectoryPath);
-
-      if (report.success) {
-          console.log('[OK] Rollback successful.\n');
-      } else {
-          console.error('[WARN] Rollback completed with errors.\n');
-      }
-
-      console.log('Restored files:');
-      if (report.restoredFiles.length === 0) console.log('  (none)');
-      report.restoredFiles.forEach(f => console.log(`  + ${f}`));
-
-      console.log('\nDeleted (new) files:');
-      if (report.deletedFiles.length === 0) console.log('  (none)');
-      report.deletedFiles.forEach(f => console.log(`  - ${f}`));
-
-      if (report.errors.length > 0) {
-          console.error('\nErrors encountered:');
-          report.errors.forEach(e => console.error(`  ! ${e}`));
-      }
-
-      const exitCode = report.success ? 0 : 1;
-      process.exit(exitCode);
-  } catch (error) {
-      console.error('\n[FATAL] Rollback operation failed:');
-      console.error(error.message);
-      process.exit(1);
-  }
-}

package/lib/cli/commands/upgrade/token-optimization-state.mjs

@@ -1,51 +0,0 @@
-import {
-  createTokenOptimizationState,
-  detectRtkBinary,
-  normalizeAgentName,
-  readTokenOptimizationState,
-  writeTokenOptimizationState,
-} from '../../token-optimization.mjs';
-
-export async function resolveUpgradeTokenOptimizationPlan(targetDirectoryPath, existingOnboardingReport) {
-  const existingState = await readTokenOptimizationState(targetDirectoryPath);
-  const optedOut = existingOnboardingReport?.tokenOptimization?.enabled === false;
-  const selectedAgentName = normalizeAgentName(
-    existingOnboardingReport?.tokenOptimization?.selectedAgent || 'copilot'
-  );
-
-  return {
-    existingState,
-    optedOut,
-    selectedAgentName,
-    shouldSeed: !existingState && !optedOut,
-    previewLabel: optedOut
-      ? 'disabled (preserved opt-out)'
-      : existingState
-        ? 'enabled'
-        : 'enabled (will seed missing ASCX state)',
-    reportState: existingState
-      || (optedOut ? existingOnboardingReport?.tokenOptimization || { enabled: false } : null),
-  };
-}
-
-export async function applyUpgradeTokenOptimizationPlan(targetDirectoryPath, plan) {
-  if (!plan.shouldSeed) {
-    return {
-      createdFileName: null,
-      reportState: plan.reportState,
-    };
-  }
-
-  const tokenOptimizationState = createTokenOptimizationState({
-    isEnabled: true,
-    selectedAgentName: plan.selectedAgentName,
-    rtkDetection: detectRtkBinary(),
-  });
-
-  await writeTokenOptimizationState(targetDirectoryPath, tokenOptimizationState);
-
-  return {
-    createdFileName: '.agent-context/state/token-optimization.json',
-    reportState: tokenOptimizationState,
-  };
-}