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);
  
  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);
  
  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 all commands
  void RegisterAllCommands();
};
 
}  // namespace cli
}  // namespace yaze
 
#endif  // YAZE_CLI_SERVICE_COMMAND_REGISTRY_H_