kd-cli 2.0.4__py3-none-any.whl

kd/cli/namespaces/init.py

@@ -0,0 +1,42 @@
+"""Init command: kd init
+
+Scaffolds a local .kd/config.yaml in the current directory
+and manages .gitignore integration.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from kd.cli.core.command_base import Command, CommandResult
+from kd.cli.core.option_registry import ResolvedOptions
+from kd.config import init_project_config
+
+
+class InitCommand(Command):
+    """Initialize project-local config."""
+
+    def __init__(self) -> None:
+        super().__init__(
+            "init",
+            "Initialize project config (.kd/config.yaml)",
+            usage="kd init [URL]",
+            long_description="Creates .kd/config.yaml in the current directory. "
+            "Optionally pre-fills the YouTrack URL. Adds .kd/ to .gitignore "
+            "if in a git repository.",
+            examples=[
+                "kd init",
+                "kd init https://example.youtrack.cloud",
+            ],
+            see_also=["/system/config list", "/system/config which"],
+        )
+
+    def execute(
+        self, args: list[str], options: ResolvedOptions, client: Any = None
+    ) -> CommandResult:
+        url = args[0] if args else None
+        result = init_project_config(url=url)
+        return {
+            "created": str(result.created),
+            "gitignore": result.gitignore_action,
+        }