command_registry.h

Go to the documentation of this file.

#ifndef YAZE_CLI_SERVICE_COMMAND_REGISTRY_H_
#define YAZE_CLI_SERVICE_COMMAND_REGISTRY_H_
 
#include <map>
#include <memory>
#include <string>
#include <vector>
 
#include "absl/status/statusor.h"
#include "cli/service/resources/command_handler.h"
 
namespace yaze {
namespace cli {
 
class CommandRegistry {
 public:
  struct CommandMetadata {
    std::string name;         // e.g., "resource-list"
    std::string category;     // e.g., "resource", "emulator", "dungeon"
    std::string description;  // Short description
    std::string usage;        // Full usage string
    bool available_to_agent;  // Can AI call this via tool dispatch?
    bool requires_rom;        // Requires ROM context?
    bool requires_grpc;       // Requires gRPC/emulator running?
    std::vector<std::string> aliases;   // Alternative names
    std::vector<std::string> examples;  // Usage examples
    std::string todo_reference;  // TODO tracker reference (if incomplete)
  };
 
  static CommandRegistry& Instance();
 
  void Register(std::unique_ptr<resources::CommandHandler> handler,
                const CommandMetadata& metadata);
 
  void RegisterHandlers(
      std::vector<std::unique_ptr<resources::CommandHandler>> handlers);
 
  resources::CommandHandler* Get(const std::string& name) const;
 
  const CommandMetadata* GetMetadata(const std::string& name) const;
 
  std::vector<std::string> GetCommandsInCategory(
      const std::string& category) const;
 
  std::vector<std::string> GetCategories() const;
 
  std::vector<std::string> GetAgentCommands() const;
 
  std::string ExportFunctionSchemas() const;
 
  std::string GenerateHelp(const std::string& name) const;
 
  std::string GenerateCategoryHelp(const std::string& category) const;
 
  std::string GenerateCompleteHelp() const;
 
  absl::Status Execute(const std::string& name,
                       const std::vector<std::string>& args,
                       Rom* rom_context = nullptr,
                       std::string* captured_output = nullptr);
 
  bool HasCommand(const std::string& name) const;
 
  size_t Count() const { return handlers_.size(); }
 
 private:
  CommandRegistry() = default;
 
  // Storage
  std::map<std::string, std::unique_ptr<resources::CommandHandler>> handlers_;
  std::map<std::string, CommandMetadata> metadata_;
  std::map<std::string, std::string> aliases_;  // alias → canonical name
 
  // Auto-register CLI commands
  void RegisterCliCommands();
};
 
}  // namespace cli
}  // namespace yaze
 
#endif  // YAZE_CLI_SERVICE_COMMAND_REGISTRY_H_