feat: signal handling, ANSI auto-detect, verbosity levels, and command attributes

WebFiori/Cli/Attributes/Group.php

@@ -0,0 +1,29 @@
+<?php
+/**
+ * This file is licensed under MIT License.
+ *
+ * Copyright (c) 2026-present Webfiori Framework
+ *
+ * For more information on the license, please visit:
+ * https://github.com/WebFiori/.github/blob/main/LICENSE
+ *
+ */
+
+declare(strict_types=1);
+namespace WebFiori\Cli\Attributes;
+
+use Attribute;
+
+/**
+ * Attribute to assign a command to a named group for help display organization.
+ *
+ * @author Ibrahim
+ */
+#[Attribute(Attribute::TARGET_CLASS)]
+class Group {
+    public readonly string $name;
+
+    public function __construct(string $name) {
+        $this->name = $name;
+    }
+}

WebFiori/Cli/Attributes/SingleInstance.php

@@ -0,0 +1,34 @@
+<?php
+/**
+ * This file is licensed under MIT License.
+ *
+ * Copyright (c) 2026-present Webfiori Framework
+ *
+ * For more information on the license, please visit:
+ * https://github.com/WebFiori/.github/blob/main/LICENSE
+ *
+ */
+
+declare(strict_types=1);
+namespace WebFiori\Cli\Attributes;
+
+use Attribute;
+
+/**
+ * Attribute to prevent concurrent execution of a command.
+ *
+ * When applied to a command class, only one instance of the command
+ * can run at a time. Subsequent attempts will fail with a warning.
+ *
+ * @author Ibrahim
+ */
+#[Attribute(Attribute::TARGET_CLASS)]
+class SingleInstance {
+    public readonly int $exitCode;
+    public readonly ?string $lockPath;
+
+    public function __construct(?string $lockPath = null, int $exitCode = 1) {
+        $this->lockPath = $lockPath;
+        $this->exitCode = $exitCode;
+    }
+}