Add completion spec for timedatectl

Add JSON spec with subcommands (status, show, set-time, set-timezone,
list-timezones, set-local-rtc, set-ntp, timesync-status, show-timesync)
and global options. Includes a timezone_generator for dynamic timezone
completions via timedatectl list-timezones.

Co-Authored-By: Oz <oz-agent@warp.dev>

Author: acarl005

command-signatures/json/timedatectl.json

@@ -0,0 +1,134 @@
+{
+    "name": "timedatectl",
+    "description": "Control the system time and date",
+    "subcommands": [
+        {
+            "name": "status",
+            "description": "Show current time settings"
+        },
+        {
+            "name": "show",
+            "description": "Show properties of systemd-timedated"
+        },
+        {
+            "name": "set-time",
+            "description": "Set system time",
+            "args": {
+                "name": "TIME",
+                "description": "Time to set (format: \"YYYY-MM-DD HH:MM:SS\")"
+            }
+        },
+        {
+            "name": "set-timezone",
+            "description": "Set system time zone",
+            "args": {
+                "name": "TIMEZONE",
+                "generatorName": "timezone_generator"
+            }
+        },
+        {
+            "name": "list-timezones",
+            "description": "Show known time zones"
+        },
+        {
+            "name": "set-local-rtc",
+            "description": "Control whether RTC is in local time",
+            "args": {
+                "name": "BOOL",
+                "suggestions": [
+                    "true",
+                    "false"
+                ]
+            }
+        },
+        {
+            "name": "set-ntp",
+            "description": "Control network time sync",
+            "args": {
+                "name": "BOOL",
+                "suggestions": [
+                    "true",
+                    "false"
+                ]
+            }
+        },
+        {
+            "name": "timesync-status",
+            "description": "Show status of systemd-timesyncd"
+        },
+        {
+            "name": "show-timesync",
+            "description": "Show properties of systemd-timesyncd"
+        }
+    ],
+    "options": [
+        {
+            "name": [
+                "-h",
+                "--help"
+            ],
+            "description": "Show this help message"
+        },
+        {
+            "name": "--version",
+            "description": "Show package version"
+        },
+        {
+            "name": "--no-pager",
+            "description": "Do not pipe output into a pager"
+        },
+        {
+            "name": "--no-ask-password",
+            "description": "Do not prompt for password"
+        },
+        {
+            "name": [
+                "-H",
+                "--host"
+            ],
+            "description": "Operate on remote HOST",
+            "args": {
+                "name": "HOST"
+            }
+        },
+        {
+            "name": [
+                "-M",
+                "--machine"
+            ],
+            "description": "Operate on local CONTAINER",
+            "args": {
+                "name": "CONTAINER"
+            }
+        },
+        {
+            "name": "--adjust-system-clock",
+            "description": "Adjust system clock when changing local RTC mode"
+        },
+        {
+            "name": "--monitor",
+            "description": "Monitor status of systemd-timesyncd"
+        },
+        {
+            "name": [
+                "-p",
+                "--property"
+            ],
+            "description": "Show only properties by this NAME",
+            "args": {
+                "name": "NAME"
+            }
+        },
+        {
+            "name": [
+                "-a",
+                "--all"
+            ],
+            "description": "Show all properties"
+        },
+        {
+            "name": "--value",
+            "description": "Only show properties with values"
+        }
+    ]
+}

command-signatures/src/generators/mod.rs

@@ -41,6 +41,7 @@ mod screen;
 mod ssh;
 mod tar;
 mod terraform;
+mod timedatectl;
 mod tmux;
 mod tmuxinator;
 
@@ -86,6 +87,7 @@ pub fn dynamic_command_signature_data() -> HashMap<String, DynamicCompletionData
         kubecolor::generator(),
         kill::generator(),
         killall::generator(),
+        timedatectl::generator(),
         tmuxinator::generator(),
         tmux::generator(),
         node::generator(),

command-signatures/src/generators/timedatectl.rs

@@ -0,0 +1,19 @@
+use warp_completion_metadata::{
+    CommandBuilder, CommandSignatureGenerators, Generator, GeneratorResultsCollector, Suggestion,
+};
+
+pub fn generator() -> CommandSignatureGenerators {
+    CommandSignatureGenerators::new("timedatectl").add_generator(
+        "timezone_generator",
+        Generator::script(
+            CommandBuilder::single_command("timedatectl list-timezones"),
+            |output| {
+                output
+                    .trim()
+                    .lines()
+                    .map(|line| Suggestion::new(line.trim()))
+                    .collect_unordered_results()
+            },
+        ),
+    )
+}