chore: import upstream snapshot with attribution

2026-07-13 13:33:03 +08:00
commit 5b57521aa1
8226 changed files with 3425766 additions and 0 deletions
@@ -0,0 +1,43 @@
+//
+//  cli_command_spec.hpp
+//
+//  Command specifications for declarative parsing
+//
+
+#pragma once
+
+#include <string>
+#include <vector>
+#include <map>
+
+namespace mnncli {
+
+enum class ArgKind {
+    Flag,       // Boolean flag (e.g., -v, --verbose)
+    Value,      // Option with value (e.g., -c <path>, --config <path>)
+    MultiValue  // Option with multiple values
+};
+
+struct OptionSpec {
+    std::string long_name;
+    char short_name;  // 0 if no short name
+    ArgKind kind;
+    bool required = false;
+    std::string help;
+};
+
+struct CommandSpec {
+    std::string name;
+    std::vector<OptionSpec> options;
+    size_t min_positional = 0;
+    size_t max_positional = 0;
+    std::string help;
+};
+
+// Command specs (defined in cli_command_spec.cpp)
+const CommandSpec& GetSpec(const std::string& command);
+
+// Generate usage text from spec
+std::string MakeUsage(const CommandSpec& spec);
+
+} // namespace mnncli