flow-cli/flow.plugin.zsh at main · Data-Wise/flow-cli · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
# flow.plugin.zsh - ZSH Plugin Entry Point
# ADHD-optimized workflow management for developers
#
# Installation:
#   antidote: antidote install data-wise/flow-cli
#   zinit:    zinit light data-wise/flow-cli
#   manual:   source /path/to/flow.plugin.zsh

# Plugin directory detection
0=${(%):-%N}
FLOW_PLUGIN_DIR=${0:A:h}

# ============================================================================
# CONFIGURATION
# ============================================================================

# Default paths (override in .zshrc before sourcing)
: ${FLOW_CONFIG_DIR:=${XDG_CONFIG_HOME:-$HOME/.config}/flow}
: ${FLOW_DATA_DIR:=${XDG_DATA_HOME:-$HOME/.local/share}/flow}
: ${FLOW_PROJECTS_ROOT:=$HOME/projects}

# Feature flags
: ${FLOW_ATLAS_ENABLED:=auto}       # auto|yes|no
: ${FLOW_LOAD_DISPATCHERS:=yes}     # Load v, g, mcp, obs dispatchers

# ============================================================================
# CORE LIBRARY
# ============================================================================

source "$FLOW_PLUGIN_DIR/lib/core.zsh"
source "$FLOW_PLUGIN_DIR/lib/config.zsh"
source "$FLOW_PLUGIN_DIR/lib/atlas-bridge.zsh"
source "$FLOW_PLUGIN_DIR/lib/dotfile-helpers.zsh"
source "$FLOW_PLUGIN_DIR/lib/project-detector.zsh"
source "$FLOW_PLUGIN_DIR/lib/project-cache.zsh"
source "$FLOW_PLUGIN_DIR/lib/tui.zsh"
source "$FLOW_PLUGIN_DIR/lib/plugin-loader.zsh"
source "$FLOW_PLUGIN_DIR/lib/ai-recipes.zsh"
source "$FLOW_PLUGIN_DIR/lib/ai-usage.zsh"
source "$FLOW_PLUGIN_DIR/lib/help-browser.zsh"
source "$FLOW_PLUGIN_DIR/lib/inventory.zsh"
source "$FLOW_PLUGIN_DIR/lib/teaching-utils.zsh"
source "$FLOW_PLUGIN_DIR/lib/teach-style-helpers.zsh"
source "$FLOW_PLUGIN_DIR/lib/keychain-helpers.zsh"
source "$FLOW_PLUGIN_DIR/lib/backup-helpers.zsh"
source "$FLOW_PLUGIN_DIR/lib/cache-helpers.zsh"
source "$FLOW_PLUGIN_DIR/lib/cache-analysis.zsh"
source "$FLOW_PLUGIN_DIR/lib/status-dashboard.zsh"
source "$FLOW_PLUGIN_DIR/lib/email-helpers.zsh"
source "$FLOW_PLUGIN_DIR/lib/em-himalaya.zsh"
source "$FLOW_PLUGIN_DIR/lib/em-cache.zsh"
source "$FLOW_PLUGIN_DIR/lib/em-ai.zsh"
source "$FLOW_PLUGIN_DIR/lib/em-render.zsh"
source "$FLOW_PLUGIN_DIR/lib/em-ics.zsh"
source "$FLOW_PLUGIN_DIR/lib/em-watch.zsh"

# ============================================================================
# COMMANDS
# ============================================================================

for cmd_file in "$FLOW_PLUGIN_DIR/commands/"*.zsh(N); do
  source "$cmd_file"
done

# ============================================================================
# OPTIONAL: SPECIALIZED DISPATCHERS
# ============================================================================

if [[ "$FLOW_LOAD_DISPATCHERS" == "yes" ]]; then
  # Disable ZSH builtin 'r' (history repeat) to allow R dispatcher
  disable r

  for disp_file in "$FLOW_PLUGIN_DIR/lib/dispatchers/"*.zsh(N); do
    source "$disp_file"
  done
fi

# ============================================================================
# EXTERNAL INTEGRATIONS (via symlinks in zsh/functions/)
# ============================================================================

# Load symlinked integrations if they exist and resolve
for fn_file in "$FLOW_PLUGIN_DIR/zsh/functions/"*.zsh(N); do
  if [[ -L "$fn_file" ]] && [[ -e "$fn_file" ]]; then
    source "$fn_file"
  fi
done

# ============================================================================
# COMPLETIONS
# ============================================================================

fpath=("$FLOW_PLUGIN_DIR/completions" $fpath)

if [[ -d "$FLOW_PLUGIN_DIR/completions" ]]; then
  autoload -Uz compinit
  # Rebuild completion cache once per day
  if [[ -n "$FLOW_PLUGIN_DIR/completions"(#qNmh-20) ]]; then
    compinit -C
  else
    compinit
  fi
fi

# ============================================================================
# MAN PAGES
# ============================================================================

if [[ -d "$FLOW_PLUGIN_DIR/man" ]]; then
  export MANPATH="$FLOW_PLUGIN_DIR/man:${MANPATH:-}"
fi

# ============================================================================
# HOOKS
# ============================================================================

autoload -Uz add-zsh-hook

if [[ -f "$FLOW_PLUGIN_DIR/hooks/chpwd.zsh" ]]; then
  source "$FLOW_PLUGIN_DIR/hooks/chpwd.zsh"
  add-zsh-hook chpwd _flow_chpwd_hook
fi

if [[ -f "$FLOW_PLUGIN_DIR/hooks/precmd.zsh" ]]; then
  source "$FLOW_PLUGIN_DIR/hooks/precmd.zsh"
  add-zsh-hook precmd _flow_precmd_hook
fi

# ============================================================================
# INITIALIZATION
# ============================================================================

[[ -d "$FLOW_CONFIG_DIR" ]] || mkdir -p "$FLOW_CONFIG_DIR"
[[ -d "$FLOW_DATA_DIR" ]] || mkdir -p "$FLOW_DATA_DIR"

# Initialize atlas
_flow_init_atlas

# Initialize plugin system
_flow_plugin_init

# Export loaded marker
export FLOW_PLUGIN_LOADED=1
export FLOW_VERSION="7.6.0"

# Register exit hook for plugin cleanup
add-zsh-hook zshexit _flow_plugin_cleanup

# Welcome message (disable with FLOW_QUIET=1)
if [[ -z "$FLOW_QUIET" ]] && [[ -z "$FLOW_WELCOMED" ]]; then
  local plugin_count=${#_FLOW_PLUGINS[@]}
  if _flow_has_atlas; then
    _flow_log_debug "flow-cli v$FLOW_VERSION (atlas: connected, plugins: $plugin_count)"
  else
    _flow_log_debug "flow-cli v$FLOW_VERSION (standalone, plugins: $plugin_count)"
  fi
  export FLOW_WELCOMED=1
fi