fix: type annotations for LSP/pyright compatibility

- Add Optional[str] to select_with_arrows() default_key parameter
- Add module-level _specify_tracker_active variable (replaces sys dynamic attr)
- Fix original_cwd initialization before try block in init_git_repo()
- Fix zip_path initialization in preset add command
- Bump version to 0.1.12

Author: kanfil

CHANGELOG.md

@@ -7,6 +7,16 @@ All notable changes to the Specify CLI and templates are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to to [Semantic Versioning](https://semver.org/spec/v2.0.0/).
 
+## [0.1.12] - 2026-03-19
+
+### Fixed
+
+- **Type annotations**: Fixed multiple LSP/type-checker warnings in `__init__.py`
+  - Added `Optional[str]` type hint to `select_with_arrows()` parameter
+  - Added module-level `_specify_tracker_active` variable instead of dynamic `sys` attribute
+  - Fixed `original_cwd` possibly unbound error in `init_git_repo()`
+  - Fixed `zip_path` initialization in `preset add` command
+
 ## [0.1.11] - 2026-03-19
 
 ### Fixed

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentic-sdlc-specify-cli"
-version = "0.1.11"
+version = "0.1.12"
 description = "Specify CLI, part of GitHub Spec Kit. A tool to bootstrap your projects for Spec-Driven Development (SDD)."
 requires-python = ">=3.11"
 dependencies = [

src/specify_cli/__init__.py

@@ -61,6 +61,9 @@
 ssl_context = truststore.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
 client = httpx.Client(verify=ssl_context)
 
+# Module-level tracker state (used to coordinate tracker output across functions)
+_specify_tracker_active: bool = False
+
 # Color constants for orange theme
 ACCENT_COLOR = "#f47721"
 BANNER_COLORS = ["#ff6b35", "#ff8c42", "#f47721", "#ff5722", "white", "bright_white"]
@@ -830,7 +833,9 @@ def get_key():
 
 
 def select_with_arrows(
-    options: dict, prompt_text: str = "Select an option", default_key: str = None
+    options: dict,
+    prompt_text: str = "Select an option",
+    default_key: Optional[str] = None,
 ) -> str:
     """
     Interactive selection using arrow keys with Rich Live display.
@@ -1787,8 +1792,8 @@ def init_git_repo(
     Returns:
         Tuple of (success: bool, error_message: Optional[str])
     """
+    original_cwd = Path.cwd()
     try:
-        original_cwd = Path.cwd()
         os.chdir(project_path)
         if not quiet:
             console.print("[cyan]Initializing git repository...[/cyan]")
@@ -3391,7 +3396,8 @@ def init(
 
     tracker = StepTracker("Initialize Specify Project")
 
-    sys._specify_tracker_active = True
+    global _specify_tracker_active
+    _specify_tracker_active = True
 
     tracker.add("precheck", "Check required tools")
     tracker.complete("precheck", "ok")
@@ -4056,14 +4062,15 @@ def preset_add(
                 f"Installing preset [cyan]{pack_info.get('name', pack_id)}[/cyan]..."
             )
 
+            zip_path: Optional[Path] = None
             try:
                 zip_path = catalog.download_pack(pack_id)
                 manifest = manager.install_from_zip(zip_path, speckit_version, priority)
                 console.print(
                     f"[green]✓[/green] Preset '{manifest.name}' v{manifest.version} installed (priority {priority})"
                 )
             finally:
-                if "zip_path" in locals() and zip_path.exists():
+                if zip_path is not None and zip_path.exists():
                     zip_path.unlink(missing_ok=True)
         else:
             console.print(