Add temporalctx help command (#9)

Author: bicabone

README.md

@@ -81,6 +81,7 @@ temporalctx staging      # switch to "staging" context
 temporalctx -            # switch to previous context
 temporalctx -c           # print current context
 temporalctx edit         # open config in $EDITOR
+temporalctx help         # show command help
 tctx                     # alias for temporalctx
 ```
 

temporalctx.plugin.zsh

@@ -231,6 +231,20 @@ _temporalctx_edit_config() {
   ${=editor_cmd} "$config_file"
 }
 
+_temporalctx_help() {
+  cat <<'EOF'
+Usage:
+  temporalctx              interactive picker (fzf)
+  temporalctx <context>    switch to context
+  temporalctx -            switch to previous context
+  temporalctx -c           print current context
+  temporalctx edit         open config in $VISUAL/$EDITOR
+  temporalctx start        start local dev server
+  temporalctx stop         stop local dev server
+  temporalctx help         show this help
+EOF
+}
+
 _temporalctx_start_local_server() {
   local no_overmind pid_file pid socket procfile
   no_overmind="${1:-0}"
@@ -375,6 +389,9 @@ temporalctx() {
     "")
       _temporalctx_pick_context
       ;;
+    help|-h|--help)
+      _temporalctx_help
+      ;;
     start)
       if [[ "$2" == "--no-overmind" ]]; then
         no_overmind=1

tests/temporalctx_plugin_test.sh

@@ -106,6 +106,20 @@ assert_contains "$visual_args" "$cfg" "editor should receive config file path"
 [[ ! -f "$fallback_log" ]] || fail "EDITOR fallback should not run when VISUAL is set"
 log "case passed: edit subcommand"
 
+# Test: help output via subcommand and flag.
+log "case: help output"
+out="$(TEMPORAL_CONFIG="$cfg" zsh -c '
+  source "'$REPO_ROOT'/temporalctx.plugin.zsh"
+  echo "-- help --"
+  temporalctx help
+  echo "-- --help --"
+  temporalctx --help
+')"
+assert_contains "$out" "Usage:" "help output should include usage header"
+assert_contains "$out" "temporalctx <context>" "help output should describe context switching"
+assert_contains "$out" "temporalctx help" "help output should describe help command"
+log "case passed: help output"
+
 # Test: alias + local dev server start/stop via PID file.
 log "case: tctx alias and local dev server lifecycle"
 out="$(PATH="$tmp_root/bin:$PATH" TEMPORAL_CONFIG="$cfg" zsh -c '