Function handleMemoryCli

src/cli-memory.ts:40–331

(args: string[])

}

export async function handleMemoryCli(args: string[]): Promise<void> {
  // Resolve project root: use CODEBASE_ROOT env or cwd (argv[2] is "memory", not a path)
  const cliRoot = process.env.CODEBASE_ROOT || process.cwd();
  const memoryPath = path.join(cliRoot, CODEBASE_CONTEXT_DIRNAME, MEMORY_FILENAME);
  const subcommand = args[0]; // list | add | remove
  const useJson = args.includes('--json');

  const listUsage =
    'Usage: codebase-context memory list [--category <cat>] [--type <type>] [--query <text>] [--json]';
  const addUsage =
    'Usage: codebase-context memory add --type <type> --category <category> --memory <text> --reason <text> [--scope-kind global|file|symbol] [--scope-file <path>] [--scope-symbol <name>] [--json]';
  const removeUsage = 'Usage: codebase-context memory remove <id> [--json]';

  const exitWithUsageError = (message: string, usage?: string): never => {
    if (useJson) {
      console.log(
        JSON.stringify(
          {
            status: 'error',
            message,
            ...(usage ? { usage } : {})
          },
          null,
          2
        )
      );
    } else {
      console.error(message);
      if (usage) console.error(usage);
    }
    process.exit(1);
  };

  if (subcommand === 'list') {
    const memories = await readMemoriesFile(memoryPath);
    const opts: { category?: CliMemoryCategory; type?: CliMemoryType; query?: string } = {};

    for (let i = 1; i < args.length; i++) {
      if (args[i] === '--category') {
        const value = args[i + 1];
        if (!value || value.startsWith('--')) {
          exitWithUsageError(
            `Error: --category requires a value. Allowed: ${MEMORY_CATEGORIES.join(', ')}`,
            listUsage
          );
        }

        if (isCliMemoryCategory(value)) {
          opts.category = value;
        } else {
          exitWithUsageError(
            `Error: invalid --category "${value}". Allowed: ${MEMORY_CATEGORIES.join(', ')}`,
            listUsage
          );
        }
        i++;
      } else if (args[i] === '--type') {
        const value = args[i + 1];