Add optional --full install mode for opinionated helper aliases

Author: bicabone

README.md

@@ -46,10 +46,15 @@ To bypass wrapping for a command/session, set `TEMPORALCTX_DISABLE_WRAP=1`.
 ./install.sh
 # or
 ./install.sh ~/my-custom-zsh/plugins
+# or include opinionated tq/td/tl helpers in $ZSHC/temporal.zsh
+./install.sh --full
 ```
 
 Then add `temporalctx` to your `plugins=(...)` in `.zshrc`.
 
+`--full` is optional and installs plugin-owned helper functions (`tq`, `td`, `tl`) by symlinking:
+- `${ZSHC:-~/.config/zsh}/temporal.zsh` -> `<plugin-dir>/temporalctx.full.zsh`
+
 ## Config format
 
 ```yaml

install.sh

@@ -4,10 +4,37 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_DIR="$SCRIPT_DIR"
 
-if [[ $# -gt 1 ]]; then
-  echo "Usage: ./install.sh [target-directory]" >&2
-  exit 1
-fi
+usage() {
+  echo "Usage: ./install.sh [--full] [target-directory]" >&2
+}
+
+full_mode=0
+user_target=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --full)
+      full_mode=1
+      shift
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    --*)
+      echo "Unknown option: $1" >&2
+      usage
+      exit 1
+      ;;
+    *)
+      if [[ -n "$user_target" ]]; then
+        usage
+        exit 1
+      fi
+      user_target="$1"
+      shift
+      ;;
+  esac
+done
 
 if ! command -v temporal >/dev/null 2>&1; then
   echo "temporal CLI is required but was not found in PATH." >&2
@@ -16,8 +43,7 @@ if ! command -v temporal >/dev/null 2>&1; then
 fi
 
 default_target_base="${ZSH_CUSTOM:-${ZSH:-$HOME/.oh-my-zsh}/custom}/plugins"
-if [[ $# -eq 1 ]]; then
-  user_target="$1"
+if [[ -n "$user_target" ]]; then
   if [[ "$(basename "$user_target")" == "temporalctx" ]]; then
     target_dir="$user_target"
   else
@@ -73,6 +99,19 @@ else
   echo "Config already exists at $config_file"
 fi
 
+if [[ "$full_mode" == "1" ]]; then
+  zshc_dir="${ZSHC:-$HOME/.config/zsh}"
+  helper_source="$target_dir/temporalctx.full.zsh"
+  helper_target="$zshc_dir/temporal.zsh"
+  mkdir -p "$zshc_dir"
+  if [[ ! -f "$helper_source" ]]; then
+    echo "Could not find opinionated helpers at $helper_source" >&2
+    exit 1
+  fi
+  ln -sfn "$helper_source" "$helper_target"
+  echo "Installed opinionated helpers at $helper_target"
+fi
+
 echo
 echo "Installation complete."
 echo "Add temporalctx to your Oh My Zsh plugins list, for example:"

temporalctx.full.zsh

@@ -0,0 +1,27 @@
+# Opinionated Temporal helper aliases/functions.
+# Installed by `./install.sh --full`.
+
+# Query a workflow's state.
+# Usage: tq <workflow-id>
+tq() {
+  local wf_id="${1:?Usage: tq <workflow-id>}"
+  temporal workflow query \
+    --workflow-id "$wf_id" \
+    --type getState
+}
+
+# Describe a workflow.
+# Usage: td <workflow-id>
+td() {
+  local wf_id="${1:?Usage: td <workflow-id>}"
+  temporal workflow describe \
+    --workflow-id "$wf_id"
+}
+
+# List recent workflows.
+# Usage: tl [limit]
+tl() {
+  local limit="${1:-10}"
+  temporal workflow list \
+    --limit "$limit"
+}

tests/install_test.sh

@@ -44,4 +44,16 @@ PATH="$tmp_root/bin:$PATH" HOME="$home2" "$REPO_ROOT/install.sh" "$custom_target
 [[ -L "$custom_target/temporalctx" || -d "$custom_target/temporalctx/.git" ]] || fail "custom target should install to <dir>/temporalctx"
 log "case passed: custom target"
 
+# Test: --full installs opinionated helpers into ZSHC/temporal.zsh.
+log "case: --full installs opinionated helpers in ZSHC"
+home3="$tmp_root/home3"
+zshc3="$tmp_root/zshc3"
+plugins3="$tmp_root/plugins3"
+mkdir -p "$home3" "$zshc3" "$plugins3"
+PATH="$tmp_root/bin:$PATH" HOME="$home3" ZSHC="$zshc3" "$REPO_ROOT/install.sh" --full "$plugins3" >"$tmp_root/install3.out" 2>"$tmp_root/install3.err"
+[[ -L "$zshc3/temporal.zsh" ]] || fail "--full should install temporal.zsh as a symlink in ZSHC"
+link_target="$(readlink "$zshc3/temporal.zsh")"
+assert_contains "$link_target" "temporalctx.full.zsh" "--full helper symlink should point to plugin helper file"
+log "case passed: --full helpers"
+
 echo "PASS: install.sh"