# Bash Script Installer for Zsh The "Bash Script Installer" simplifies the setup of Zsh. ## Zsh ### Ubuntu ```zsh bash -c "$(curl -fsSL https://tinyurl.com/y6fhb594)" ``` ### WSL ```zsh bash -c "$(curl -fsSL https://tinyurl.com/ycyct6wp)" ``` ### MacOS ```zsh bash -c "$(curl -fsSL https://tinyurl.com/yptybtpa)" ``` ### Configuration ```zsh bash -c "$(curl -fsSL https://tinyurl.com/y8vf753j)" ``` ### Shell framework and prompt The installers use Oh My Zsh for framework features and plugins, with the OMZ theme disabled: ```zsh ZSH_THEME="" source "$ZSH/oh-my-zsh.sh" eval "$(starship init zsh)" ``` Starship owns the prompt and loads after Oh My Zsh. The managed Starship config is installed at `~/.config/starship.toml`. A Nerd Font is required for the Powerline symbols. ## AI commits The managed `aicommit` function can use Claude, Codex, Copilot, or OpenCode to create a commit from staged changes: ```zsh aicommit opencode ``` The installers place the shared commit instructions at `~/.config/ai-commit-prompt.txt` and the required OpenCode agent at `~/.config/opencode/agents/ai-commit.md`. The agent is hidden from the interactive agent selector but remains available to `aicommit opencode`. It may inspect Git status, the cached diff, and recent history, and may execute `git commit`; all unrelated tools and shell commands are denied. ## Plan-build workflow The local `plan_build` function is a thin cached launcher for the canonical public [plan-build gist](https://opengist.resetrix.work/weehong/plan-build). When curl is available, each invocation stages `plan_build.zsh`, `SKILL.md`, and `ARCHITECT.md`, requires all three to be non-empty, and syntax-checks the executable. It then moves the complete bundle into a unique immutable release directory and atomically switches one `current` symlink. Refresh activation is serialized with a kernel-backed Zsh file lock so concurrent callers cannot mix releases and crashes cannot leave a stale lock. If refresh fails, the launcher preserves and uses the last complete, validated release and repairs its skill links. Zsh is always required; curl is required only when no valid cached release exists. ```zsh plan_build plan_build --prompt plan_build --writing-plan plan_build --prompt --brainstorm plan_build --yolo --writing-plan plan_build --architect plan_build --architect --new plan_build --architect --yolo ``` The canonical executable defines the current command behavior and options. Each invocation binds the executable and both skills to its selected immutable release. The launcher also points the installed Claude Code skill paths through the active `current` release: - `SKILL.md` → `~/.claude/skills/plan-build/SKILL.md` - `ARCHITECT.md` → `~/.claude/skills/plan-build-architect/SKILL.md` The launcher defaults to `https://opengist.resetrix.work/weehong/plan-build/raw/HEAD` and `${XDG_CACHE_HOME:-$HOME/.cache}/plan-build`. Override these with `PLAN_BUILD_BASE_URL` and `PLAN_BUILD_CACHE_DIR`. Installed skill paths remain fixed at `~/.claude/skills`; cached invocations receive immutable release paths through environment variables. The downloaded script is remote executable code: syntax validation catches malformed Zsh but is not a security sandbox, so only point `PLAN_BUILD_BASE_URL` at a source you trust. Remote code is executed in a child Zsh process and is never sourced into the caller shell. Invoking `plan_build` once installs or repairs both skill links. To install standalone files without the cached launcher, follow the installation instructions in the canonical gist instead.

# Git Commit Message Generator Prompt ## Role You are an Automated Git Commit Engine. ## Objective Analyze staged changes (`git diff --cached`), identify the **primary logical change**, and generate a commit message that **strictly adheres** to Conventional Commits v1.0.0. --- ## Input The user will provide the output of: ```bash git diff --cached ``` --- ## Strict Rules (Zero Tolerance) ### 1. Header Format **Pattern:** `type(scope): subject` | Element | Rule | | :--- | :--- | | **Type** | ONLY use: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore` | | **Scope** | Optional, in parentheses, entirely lowercase (e.g., `docker`, `api`, `auth`) | | **Subject** | Lowercase, imperative mood ("add" not "added"), NO period at the end | | **Length** | Header MUST be ≤ 50 characters | ### 2. Body Format | Element | Rule | | :--- | :--- | | **Spacing** | Exactly ONE blank line between the header and the body | | **Bullet Points**| Use hyphens (`-`) only | | **Line Length** | Each line MUST be ≤ 72 characters | | **Case** | Lowercase throughout | ### 3. Content Rules * **NO** "Merge branch" or auto-generated text. * **NO** Markdown formatting (bold/italic/code blocks) inside the commit message string itself. * **NO** periods at the end of the subject line. * **NO** "Co-authored-by" trailers or any co-author attributions. --- ## Execution Steps ### Step 1: Atomic Scan Identify the **largest cluster of related changes** (the "Primary Scope"). **Priority Order for Type Selection:** 1. `ci` - Pipeline, CI/CD configuration changes 2. `feat` - New features 3. `fix` - Bug fixes 4. `refactor` - Code restructuring 5. `build` - Build system, dependencies 6. `test` - Test additions/modifications 7. `chore` - Maintenance tasks 8. `docs` - Documentation only (use ONLY if no code changes exist) ### Step 2: Classify Changes Categorize all changed files: | Category | Influences Subject? | Include in Body? | | :--- | :---: | :---: | | **Primary Scope** | ✅ Yes | ✅ Yes | | **Supporting Changes** | ❌ No | ✅ Yes | | **Documentation** | ❌ No | ✅ Yes (as a single line) | > **Key Rule:** Documentation changes (`docs/`) should be mentioned in the body but MUST NOT influence the subject type unless documentation is the *only* change in the commit. ### Step 3: Draft Commit Message Structure the message exactly like this: ```text type(scope): subject (≤50 chars, imperative, lowercase, no period) - primary change detail 1 - primary change detail 2 - supporting change detail - add/update project documentation ``` --- ## Output Format & Execution Authorization You must output **ONLY** a single bash code block containing the complete git command. Do not provide any conversational filler, explanations, or greeting. Once you have generated the `git commit` bash command, **you are explicitly authorized to execute it directly in the terminal** (if your environment supports agentic execution). * Do not ask for further user confirmation. * Execute sequentially. * If the command fails, output the exact error message and halt execution. **Format Template:** ```bash git commit -m "type(scope): subject - body detail 1 - body detail 2 - body detail 3" ``` --- ## Examples ### Example 1: CI/CD with Documentation * **Changes:** `.gitlab-ci.yaml` (new), `Dockerfile` (new), `docs/deployment.md` (new) * **Output:** ```bash git commit -m "ci: add gitlab pipeline and docker config - add gitlab-ci.yaml with build, test, publish stages - add Dockerfile for container deployment - add deployment documentation" ``` ### Example 2: Feature with Config Changes * **Changes:** `src/auth/login.java` (new), `pom.xml` (modified), `docs/api.md` (new) * **Output:** ```bash git commit -m "feat(auth): add user login endpoint - implement login service with jwt tokens - add spring-security dependency to pom.xml - add api documentation" ``` ### Example 3: Documentation Only * **Changes:** `docs/setup.md` (new), `docs/testing.md` (modified), `README.md` (modified) * **Output:** ```bash git commit -m "docs: add setup guide and update testing docs - add initial setup guide - update testing documentation with examples - update readme with quick start section" ``` --- ## Quick Reference | Type | When to Use | | :--- | :--- | | `feat` | New feature for the user | | `fix` | Bug fix for the user | | `docs` | Documentation only changes | | `style` | Formatting, missing semicolons, etc. (no code change) | | `refactor` | Code change that neither fixes a bug nor adds a feature | | `perf` | Code change that improves performance | | `test` | Adding or refactoring tests | | `build` | Build system or external dependencies | | `ci` | CI configuration files and scripts | | `chore` | Maintenance tasks, no production code changes |

--- description: Creates one conventional commit from the staged diff supplied in the prompt. mode: primary hidden: true permission: "*": deny bash: "*": deny "git status *": allow "git diff --cached*": allow "git log *": allow "git commit *": allow --- Follow the supplied commit instructions and staged diff. Generate a concise conventional commit message, then execute exactly one `git commit` with that message. You may inspect Git status, the cached diff, and recent log. Do not modify files or change the staged set.

# ============================================================================= # OS-SPECIFIC ALIASES # ============================================================================= if [[ "$OSTYPE" == "linux-gnu"* ]] && command -v apt-get >/dev/null 2>&1; then # Linux Only System update & cleanup alias uu='sudo apt-get update && \ sudo apt-get upgrade -y && \ sudo apt-get full-upgrade -y && \ sudo apt-get autoremove -y && \ sudo apt-get autoclean -y && \ sudo apt-get clean' elif [[ "$OSTYPE" == "darwin"* ]]; then # macOS Only alias flushdns='sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder' fi # ============================================================================= # UNIVERSAL GIT ALIASES (Fixed: Removed broken "$@" from aliases) # ============================================================================= alias gph='git push' alias gco='git checkout' alias gbh='git branch' alias gmt='git commit' alias gpl='git pull' alias grb='git rebase' alias grt='git reset' alias gst='git status' alias grmrf='git checkout -- . && git clean -fd'

#!/bin/bash set -euo pipefail # Configuration GIST_RAW_BASE="https://opengist.resetrix.work/weehong/f0d940c3c1214bf5b7996195199fdc09/raw/HEAD" CONFIG_FILES=( ".alias" ".func" ".pathrc" ".sourcerc" ".vimrc" ".zshrc" ".config/starship.toml" ".config/ai-commit-prompt.txt" ".config/opencode/agents/ai-commit.md" ) echo "Starting configuration download..." download_failed=0 for f in "${CONFIG_FILES[@]}"; do # Remove the leading dot for the URL path remote_name="${f#.}" [[ "$f" == ".config/starship.toml" ]] && remote_name="starship.toml" [[ "$f" == ".config/ai-commit-prompt.txt" ]] && remote_name="ai-commit-prompt.txt" [[ "$f" == ".config/opencode/agents/ai-commit.md" ]] && remote_name="ai-commit.md" url="$GIST_RAW_BASE/$remote_name" target="$HOME/$f" tmp="${target}.tmp.$$" echo "Downloading $f..." mkdir -p "$(dirname "$target")" # Use -f to fail silently on server errors, -s for silent, -L to follow redirects if curl -fsSL "$url" -o "$tmp" && mv "$tmp" "$target"; then echo "Successfully updated $target" else rm -f "$tmp" echo "Error: Failed to download $f from $url" >&2 download_failed=1 fi done if [ "$download_failed" -ne 0 ]; then echo "Configuration download completed with errors." >&2 exit 1 fi echo "Done! All configuration files have been replaced."

# ============================================================================= # CUSTOM FUNCTIONS # ============================================================================= # ----------------------------------------------------------------------------- # Function: funcs (List available .func functions) # ----------------------------------------------------------------------------- funcs() { local func_file="${1:-$HOME/.func}" if [ ! -f "$func_file" ]; then printf "Error: Function file '%s' not found.\n" "$func_file" >&2 return 1 fi printf "Available functions in %s:\n" "$func_file" awk ' /^# Function: / { line = $0 sub(/^# Function: /, "", line) name = line sub(/ .*/, "", name) desc = "" if (line ~ / \(.+\)$/) { desc = line sub(/^[^ ]+ \(/, "", desc) sub(/\)$/, "", desc) } if (desc != "") { printf " %-22s %s\n", name, desc } else { printf " %s\n", name } } ' "$func_file" } # ----------------------------------------------------------------------------- # Function: clip (Cross-platform clipboard) # ----------------------------------------------------------------------------- clip() { local cmd local args=() if command -v pbcopy >/dev/null 2>&1; then cmd="pbcopy" # macOS elif grep -qi "microsoft" /proc/version 2>/dev/null && command -v clip.exe >/dev/null 2>&1; then cmd="clip.exe" # WSL elif [ "$XDG_SESSION_TYPE" = "wayland" ] && command -v wl-copy >/dev/null 2>&1; then cmd="wl-copy" # Linux Wayland elif command -v xclip >/dev/null 2>&1; then cmd="xclip" # Linux X11 (Fallback 1) args=("-selection" "clipboard") elif command -v xsel >/dev/null 2>&1; then cmd="xsel" # Linux X11 (Fallback 2) args=("--clipboard" "--input") else printf "Error: No supported clipboard utility found.\n" >&2 return 1 fi if [ $# -gt 0 ]; then if [ -f "$1" ]; then "$cmd" "${args[@]}" < "$1" echo "Copied contents of '$1' to clipboard." else printf "Error: File '%s' not found.\n" "$1" >&2 return 1 fi else "$cmd" "${args[@]}" fi } # ----------------------------------------------------------------------------- # Function: open_file (Cross-platform file/directory opener) # ----------------------------------------------------------------------------- open_file() { local target="${1:-.}" if [[ "$OSTYPE" == "darwin"* ]]; then command open "$target" elif grep -qi "microsoft" /proc/version 2>/dev/null; then if command -v wslpath >/dev/null 2>&1 && command -v explorer.exe >/dev/null 2>&1; then explorer.exe "$(wslpath -w "$target")" else printf "Error: 'wslpath' or 'explorer.exe' not found.\n" >&2 return 1 fi elif [[ "$OSTYPE" == "linux-gnu"* ]]; then if command -v xdg-open >/dev/null 2>&1; then xdg-open "$target" else printf "Error: 'xdg-open' not found.\n" >&2 return 1 fi fi } alias open='open_file' # ----------------------------------------------------------------------------- # Function: clear_history (Supports shell, Claude, Codex, and OpenCode) # ----------------------------------------------------------------------------- clear_history() { case "${1:-}" in claude) if [ -d "$HOME/.claude/projects" ]; then # Use 'yes' to skip prompts and -f to ignore non-existent files yes | rm -rf "$HOME/.claude/projects"/* echo "Claude project history/cache cleared." fi ;; codex) local codex_home="${CODEX_HOME:-$HOME/.codex}" local codex_session_file local codex_session_id mkdir -p "$codex_home" : > "$codex_home/history.jsonl" if command -v codex >/dev/null 2>&1; then find "$codex_home/sessions" "$codex_home/archived_sessions" -type f -name '*.jsonl' -print 2>/dev/null | while IFS= read -r codex_session_file; do codex_session_id="$(sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p; q' "$codex_session_file")" if [ -n "$codex_session_id" ]; then codex delete --force "$codex_session_id" >/dev/null 2>&1 || true fi done fi rm -rf "$codex_home/sessions" "$codex_home/archived_sessions" "$codex_home/shell_snapshots" mkdir -p "$codex_home/sessions" "$codex_home/archived_sessions" "$codex_home/shell_snapshots" echo "Codex history cleared." ;; opencode) local opencode_state_home="${XDG_STATE_HOME:-$HOME/.local/state}/opencode" local opencode_data_home="${XDG_DATA_HOME:-$HOME/.local/share}/opencode" mkdir -p "$opencode_state_home" "$opencode_data_home" : > "$opencode_state_home/prompt-history.jsonl" rm -f \ "$opencode_data_home/opencode.db" \ "$opencode_data_home/opencode.db-shm" \ "$opencode_data_home/opencode.db-wal" rm -rf "$opencode_data_home/repos" "$opencode_data_home/log" mkdir -p "$opencode_data_home/repos" "$opencode_data_home/log" echo "OpenCode history cleared." ;; *) # 1. Truncate the file : > "$HISTFILE" # 2. Clear RAM by briefly setting history size to 0 local old_histsize=$HISTSIZE HISTSIZE=0 HISTSIZE=$old_histsize echo "Shell history cleared." ;; esac } # ----------------------------------------------------------------------------- # Function: require_cli (Check external CLI availability) # ----------------------------------------------------------------------------- require_cli() { local binary="$1" local label="$2" local resolved if command -v whence >/dev/null 2>&1; then if whence -p "$binary" >/dev/null 2>&1; then return 0 fi else resolved="$(command -v "$binary" 2>/dev/null)" || resolved="" if [ -n "$resolved" ] && [ -x "$resolved" ]; then return 0 fi fi printf "Error: %s ('%s') is not installed or not in your PATH.\n" "$label" "$binary" >&2 return 1 } # ----------------------------------------------------------------------------- # Function: claude (Includes --yolo and clear shortcuts) # ----------------------------------------------------------------------------- claude() { # Shortcut for clearing cache if [[ "$1" == "clear" ]]; then clear_history claude return 0 fi # Check if binary exists require_cli claude "Claude Code CLI" || return 1 # Handle --yolo mode if [[ "$1" == "--yolo" ]]; then shift command claude --dangerously-skip-permissions "$@" return $? fi command claude "$@" } # ----------------------------------------------------------------------------- # Internal: _prompt_confirm_indexing (Confirm project indexing via the terminal) # ----------------------------------------------------------------------------- _prompt_confirm_indexing() { local project_root="$1" local reply if ! (: </dev/tty) 2>/dev/null; then printf "Notice: No interactive terminal available; enhancing without project indexing.\n" >&2 return 1 fi printf "Allow Auggie to index and use project context from '%s'? (y/N) " "$project_root" >/dev/tty if ! IFS= read -r reply </dev/tty; then printf "\nNotice: Unable to read confirmation; enhancing without project indexing.\n" >&2 return 1 fi case "$reply" in y|Y|yes|YES|Yes) return 0 ;; *) return 1 ;; esac } # ----------------------------------------------------------------------------- # Internal: _enhance_prompt (Run Auggie and write only the enhanced prompt) # ----------------------------------------------------------------------------- _enhance_prompt() { local prompt="$1" local output_file="$2" local run_dir local prompt_file local workspace local cache_dir local auth_file local log_file local parsed_file local project_root local use_project_context local script_pid local waited local timeout_seconds local monitor_status if [ -z "$prompt" ]; then printf "Error: Prompt was empty.\n" >&2 return 1 fi if [ ! -s "$HOME/.augment/session.json" ]; then printf "Error: Auggie session file not found. Run 'auggie login' first.\n" >&2 return 1 fi run_dir="$(mktemp -d "${TMPDIR:-/tmp}/auggie-enhance.XXXXXX")" || return 1 prompt_file="$run_dir/prompt.txt" workspace="$run_dir/workspace" cache_dir="$run_dir/cache" auth_file="$HOME/.augment/session.json" log_file="$run_dir/auggie.log" parsed_file="$run_dir/enhanced.txt" mkdir -p "$workspace" "$cache_dir" printf "%s\n" "$prompt" > "$prompt_file" project_root="$(git rev-parse --show-toplevel 2>/dev/null)" || project_root="$PWD" use_project_context=0 timeout_seconds=90 if _prompt_confirm_indexing "$project_root"; then use_project_context=1 timeout_seconds=300 workspace="$project_root" cache_dir="$HOME/.augment" printf "Indexing approved; enhancing with project context from '%s'.\n" "$project_root" >&2 else printf "Enhancing without project indexing.\n" >&2 fi ( if [ "$use_project_context" -eq 1 ]; then AUGGIE_PROMPT_FILE="$prompt_file" \ AUGGIE_WORKSPACE="$workspace" \ AUGGIE_CACHE_DIR="$cache_dir" \ AUGGIE_AUTH_FILE="$auth_file" \ script -q -f -O "$log_file" -c 'auggie --print --enhance-prompt --workspace-root "$AUGGIE_WORKSPACE" --augment-cache-dir "$AUGGIE_CACHE_DIR" --augment-session-json "$AUGGIE_AUTH_FILE" --allow-indexing --wait-for-indexing --dont-save-session --instruction-file "$AUGGIE_PROMPT_FILE"' </dev/null >/dev/null 2>&1 & else AUGGIE_PROMPT_FILE="$prompt_file" \ AUGGIE_WORKSPACE="$workspace" \ AUGGIE_CACHE_DIR="$cache_dir" \ AUGGIE_AUTH_FILE="$auth_file" \ script -q -f -O "$log_file" -c 'auggie --print --enhance-prompt --no-discover-workspaces --workspace-root "$AUGGIE_WORKSPACE" --augment-cache-dir "$AUGGIE_CACHE_DIR" --augment-session-json "$AUGGIE_AUTH_FILE" --dont-save-session --instruction-file "$AUGGIE_PROMPT_FILE"' </dev/null >/dev/null 2>&1 & fi script_pid=$! waited=0 while kill -0 "$script_pid" >/dev/null 2>&1; do if grep -aq "🤖" "$log_file" 2>/dev/null || grep -aq "Tool call:" "$log_file" 2>/dev/null; then kill "$script_pid" >/dev/null 2>&1 || true wait "$script_pid" >/dev/null 2>&1 || true exit 0 fi if [ "$waited" -ge "$timeout_seconds" ]; then kill "$script_pid" >/dev/null 2>&1 || true wait "$script_pid" >/dev/null 2>&1 || true exit 124 fi sleep 1 waited=$((waited + 1)) done wait "$script_pid" >/dev/null 2>&1 || true exit 0 ) monitor_status=$? if [ "$monitor_status" -eq 124 ]; then printf "Error: Timed out waiting for Auggie to enhance the prompt.\n" >&2 rm -rf "$run_dir" return 124 fi perl -ne ' # Auggie redraws streamed terminal lines with carriage returns. Keep only # the final rendered segment so stale text cannot corrupt the prompt. s/\r$//; s/.*\r//; 1 while s/[^\x08]\x08//g; s/\x08//g; s/\e\][^\a]*(?:\a|\e\\)//g; s/\e\[[0-?]*[ -\/]*[@-~]//g; next if /Script started on/ || /Script done on/; if (/^(?:✨\s*)?Enhanced prompt:\s*(.*)$/) { $capturing = 1; $output .= "$1\n" if length $1; next; } next unless $capturing; exit if /^🤖/ || /Tool call:/ || /Session terminated/; $output .= $_; END { $output =~ s/^\s*\n//; $output =~ s/\s+\z//; print "$output\n" if length $output; } ' "$log_file" > "$parsed_file" if [ ! -s "$parsed_file" ]; then printf "Error: Auggie did not return an enhanced prompt.\n" >&2 rm -rf "$run_dir" return 1 fi if ! command cp "$parsed_file" "$output_file"; then printf "Error: Unable to save the enhanced prompt.\n" >&2 rm -rf "$run_dir" return 1 fi rm -rf "$run_dir" } # ----------------------------------------------------------------------------- # Function: prompt (Enhance a prompt with Auggie and optional project context) # ----------------------------------------------------------------------------- prompt() { local prompt local line local output_file require_cli auggie "Auggie CLI" || return 1 require_cli script "script utility" || return 1 if [ $# -gt 0 ]; then prompt="$*" elif [ ! -t 0 ]; then prompt="$(cat)" else echo "Reading prompt... Type 'EOF' on a new line and press Enter when finished." prompt="" while IFS= read -r line; do [ "$line" = "EOF" ] && break if [ -z "$prompt" ]; then prompt="$line" else prompt="${prompt}"$'\n'"${line}" fi done fi if [ -z "$prompt" ]; then printf "Error: Prompt was empty.\n" >&2 return 1 fi output_file="$(mktemp "${TMPDIR:-/tmp}/auggie-enhanced-prompt.XXXXXX")" || return 1 if ! _enhance_prompt "$prompt" "$output_file"; then rm -f "$output_file" return 1 fi if [ -t 1 ]; then clear fi printf "Enhanced prompt:\n" command cat "$output_file" rm -f "$output_file" command auggie account status } # ----------------------------------------------------------------------------- # Function: plan_build (Cached canonical plan-build launcher) # ----------------------------------------------------------------------------- plan_build() { emulate -L zsh setopt localtraps local base_url="${PLAN_BUILD_BASE_URL:-https://opengist.resetrix.work/weehong/plan-build/raw/HEAD}" local cache_dir="${PLAN_BUILD_CACHE_DIR:-${XDG_CACHE_HOME:-$HOME/.cache}/plan-build}" local curl_command="${PLAN_BUILD_CURL_COMMAND:-curl}" local skill_file="$HOME/.claude/skills/plan-build/SKILL.md" local architect_file="$HOME/.claude/skills/plan-build-architect/SKILL.md" local stage_dir="" release_dir="" current_tmp="" local skill_tmp="" architect_tmp="" skill_backup="" architect_backup="" local activation_lock="$cache_dir/.activate.lock" local activation_lock_fd="" local selected_release="" active_pid="" refresh_rc=1 call_rc=0 interrupted_rc=0 if ! zmodload zsh/system 2>/dev/null; then printf "Error: Unable to load the Zsh system module required by plan-build.\n" >&2 return 1 fi require_cli zsh "Zsh" || return 1 if ! command mkdir -p "$cache_dir" "${skill_file:h}" "${architect_file:h}"; then printf "Error: Unable to create plan-build cache or skill directories.\n" >&2 return 1 fi _plan_build_cleanup() { if [[ -n "${active_pid:-}" ]] && command kill -0 "$active_pid" 2>/dev/null; then command kill "$active_pid" 2>/dev/null || true wait "$active_pid" 2>/dev/null || true fi active_pid="" [[ -n "$stage_dir" && -d "$stage_dir" ]] && command rm -rf -- "$stage_dir" command rm -f -- "$current_tmp" "$skill_tmp" "$architect_tmp" command rm -f -- "$skill_backup" "$architect_backup" if [[ -n "${activation_lock_fd:-}" ]]; then zsystem flock -u "$activation_lock_fd" 2>/dev/null || true activation_lock_fd="" fi } _plan_build_cancel() { interrupted_rc="$1" [[ -n "${active_pid:-}" ]] && command kill "$active_pid" 2>/dev/null || true } trap '_plan_build_cleanup' EXIT trap '_plan_build_cancel 129' HUP trap '_plan_build_cancel 130' INT trap '_plan_build_cancel 143' TERM _plan_build_validate_release() { local candidate="$1" [[ -d "$candidate" && -s "$candidate/plan_build.zsh" && -s "$candidate/SKILL.md" && -s "$candidate/ARCHITECT.md" ]] && command zsh -n "$candidate/plan_build.zsh" } _plan_build_replace_path() { local replacement="$1" destination="$2" if command mv -fT "$replacement" "$destination" 2>/dev/null; then return 0 fi command mv -fh "$replacement" "$destination" } _plan_build_select_current() { local resolved [[ -L "$cache_dir/current" ]] || return 1 resolved="$cache_dir/current" resolved="${resolved:A}" _plan_build_validate_release "$resolved" || return 1 selected_release="$resolved" } _plan_build_acquire_activation_lock() { (( interrupted_rc )) && return 1 command touch "$activation_lock" || return 1 zsystem flock -t 10 -f activation_lock_fd "$activation_lock" } _plan_build_release_activation_lock() { [[ -n "$activation_lock_fd" ]] || return 0 zsystem flock -u "$activation_lock_fd" || return 1 activation_lock_fd="" } _plan_build_download() { local remote="$1" destination="$2" download_rc command "$curl_command" -fsSL "$remote" -o "$destination" & active_pid=$! wait "$active_pid" download_rc=$? active_pid="" (( interrupted_rc )) && return "$interrupted_rc" return "$download_rc" } _plan_build_backup_path() { local source="$1" backup="$2" [[ -e "$source" || -L "$source" ]] || return 0 command rm -f -- "$backup" && command cp -RP "$source" "$backup" } _plan_build_restore_path() { local destination="$1" backup="$2" had_old="$3" if (( had_old )); then _plan_build_replace_path "$backup" "$destination" || return 1 else command rm -f -- "$destination" fi } _plan_build_install_skill_links() { local activation_ok=1 local skill_had_old=0 architect_had_old=0 skill_tmp="$(command mktemp "${skill_file}.link.XXXXXX")" && command rm -f "$skill_tmp" && command ln -s "$cache_dir/current/SKILL.md" "$skill_tmp" || skill_tmp="" architect_tmp="$(command mktemp "${architect_file}.link.XXXXXX")" && command rm -f "$architect_tmp" && command ln -s "$cache_dir/current/ARCHITECT.md" "$architect_tmp" || architect_tmp="" [[ -n "$skill_tmp" && -L "$skill_tmp" && -n "$architect_tmp" && -L "$architect_tmp" ]] || return 1 skill_backup="${skill_file}.backup.$$.$RANDOM" architect_backup="${architect_file}.backup.$$.$RANDOM" [[ -e "$skill_file" || -L "$skill_file" ]] && skill_had_old=1 [[ -e "$architect_file" || -L "$architect_file" ]] && architect_had_old=1 _plan_build_backup_path "$skill_file" "$skill_backup" || activation_ok=0 (( activation_ok )) && _plan_build_backup_path "$architect_file" "$architect_backup" || activation_ok=0 (( activation_ok && ! interrupted_rc )) && _plan_build_replace_path "$skill_tmp" "$skill_file" || activation_ok=0 (( activation_ok )) && skill_tmp="" (( activation_ok && ! interrupted_rc )) && _plan_build_replace_path "$architect_tmp" "$architect_file" || activation_ok=0 (( activation_ok )) && architect_tmp="" if (( activation_ok )); then command rm -f -- "$skill_backup" "$architect_backup" skill_backup="" architect_backup="" return 0 fi if ! _plan_build_restore_path "$skill_file" "$skill_backup" "$skill_had_old"; then printf "Error: Unable to restore plan-build skill; backup preserved at %s.\n" "$skill_backup" >&2 skill_backup="" fi if ! _plan_build_restore_path "$architect_file" "$architect_backup" "$architect_had_old"; then printf "Error: Unable to restore architect skill; backup preserved at %s.\n" "$architect_backup" >&2 architect_backup="" fi return 1 } if (( $+commands[$curl_command] )) || [[ "$curl_command" == */* && -x "$curl_command" ]]; then stage_dir="$(command mktemp -d "$cache_dir/.stage.XXXXXX")" || stage_dir="" if [[ -n "$stage_dir" ]]; then _plan_build_download "$base_url/plan_build.zsh" "$stage_dir/plan_build.zsh" && _plan_build_download "$base_url/SKILL.md" "$stage_dir/SKILL.md" && _plan_build_download "$base_url/ARCHITECT.md" "$stage_dir/ARCHITECT.md" refresh_rc=$? if (( interrupted_rc )); then _plan_build_cleanup trap - EXIT HUP INT TERM return "$interrupted_rc" fi else refresh_rc=1 fi if (( refresh_rc == 0 )) && _plan_build_validate_release "$stage_dir"; then release_dir="$(command mktemp -d "$cache_dir/release.XXXXXX")" || release_dir="" if [[ -n "$release_dir" ]] && command rmdir "$release_dir" && command mv "$stage_dir" "$release_dir" && _plan_build_acquire_activation_lock; then stage_dir="" release_dir="${release_dir:A}" current_tmp="$(command mktemp "$cache_dir/.current.XXXXXX")" && command rm -f "$current_tmp" && command ln -s "$release_dir" "$current_tmp" || current_tmp="" if [[ -n "$current_tmp" && -L "$current_tmp" ]] && _plan_build_install_skill_links && _plan_build_replace_path "$current_tmp" "$cache_dir/current"; then current_tmp="" selected_release="$release_dir" fi _plan_build_release_activation_lock || true fi fi fi if (( interrupted_rc )); then _plan_build_cleanup trap - EXIT HUP INT TERM return "$interrupted_rc" fi if [[ -z "$selected_release" ]]; then if ! _plan_build_select_current; then if (( ! $+commands[$curl_command] )) && [[ ! ( "$curl_command" == */* && -x "$curl_command" ) ]]; then printf "Error: curl is required because no valid cached plan-build bundle is available.\n" >&2 else printf "Error: Unable to refresh plan-build and no valid cached bundle is available.\n" >&2 fi return 1 fi if (( ! $+commands[$curl_command] )) && [[ ! ( "$curl_command" == */* && -x "$curl_command" ) ]]; then printf "Warning: curl is unavailable; using the validated cached plan-build bundle.\n" >&2 else printf "Warning: Unable to refresh plan-build; using the validated cached bundle.\n" >&2 fi fi if [[ "$(command readlink "$skill_file" 2>/dev/null)" != "$cache_dir/current/SKILL.md" || "$(command readlink "$architect_file" 2>/dev/null)" != "$cache_dir/current/ARCHITECT.md" ]]; then if ! _plan_build_acquire_activation_lock || ! _plan_build_install_skill_links; then _plan_build_release_activation_lock 2>/dev/null || true if (( interrupted_rc )); then _plan_build_cleanup trap - EXIT HUP INT TERM return "$interrupted_rc" fi printf "Error: Unable to install the plan-build skill links.\n" >&2 return 1 fi _plan_build_release_activation_lock || true fi if (( interrupted_rc )); then _plan_build_cleanup trap - EXIT HUP INT TERM return "$interrupted_rc" fi PLAN_BUILD_SKILL_PATH="$selected_release/SKILL.md" \ PLAN_BUILD_ARCHITECT_SKILL_PATH="$selected_release/ARCHITECT.md" \ command zsh "$selected_release/plan_build.zsh" "$@" & active_pid=$! wait "$active_pid" call_rc=$? active_pid="" (( interrupted_rc )) && call_rc="$interrupted_rc" _plan_build_cleanup trap - EXIT HUP INT TERM return "$call_rc" } # ----------------------------------------------------------------------------- # Function: aicommit (Automated Conventional Commit Engine Wrapper) # ----------------------------------------------------------------------------- aicommit() { local diff engine prompt # 1. Get diff safely: exclude lock files/minified files and cap at ~100k characters to prevent CLI crashes diff=$(git diff --cached -- . ":(exclude)*.lock" ":(exclude)*-lock.json" ":(exclude)*.min.js" | head -c 100000) if [ -z "$diff" ]; then printf "❌ Error: Nothing staged to commit.\n" >&2 return 1 fi if [ ! -f "$HOME/.config/ai-commit-prompt.txt" ]; then printf "❌ Error: Configuration file not found at ~/.config/ai-commit-prompt.txt\n" >&2 printf "Please create it and paste your system prompt inside.\n" >&2 return 1 fi engine=${1:-claude} prompt=$(cat "$HOME/.config/ai-commit-prompt.txt") case "$engine" in claude) echo "🤖 Claude is analyzing staged changes..." cat "$HOME/.config/ai-commit-prompt.txt" <(echo -e "\n\nHere is the git diff:\n$diff") \ | command claude --allowedTools 'Bash(git commit *)' --permission-mode dontAsk -p \ "Read the provided instructions and diff, then generate and execute the commit." ;; codex) echo "🤖 Codex is analyzing staged changes..." cat "$HOME/.config/ai-commit-prompt.txt" <(echo -e "\n\nHere is the git diff:\n$diff") \ | command codex --ask-for-approval never exec --sandbox workspace-write --ephemeral \ "Read the provided instructions and diff, then generate and execute the commit." ;; copilot) echo "🤖 Copilot is analyzing staged changes..." copilot -p "$prompt Here is the git diff: $diff" -s --no-ask-user --allow-tool='shell(git:*)' ;; opencode) echo "🤖 OpenCode is analyzing staged changes..." cat "$HOME/.config/ai-commit-prompt.txt" <(echo -e "\n\nHere is the git diff:\n$diff") | opencode run --agent ai-commit ;; *) printf "❌ Error: Invalid engine '%s'\n" "$engine" >&2 printf "Usage: aicommit [claude | codex | copilot | opencode]\n" >&2 return 1 ;; esac } # ----------------------------------------------------------------------------- # Function: create (Efficiently create file + parent dirs) # ----------------------------------------------------------------------------- create() { if ! command -v install >/dev/null 2>&1; then printf "Error: 'install' coreutil is not available.\n" >&2 return 1 fi if [ $# -eq 0 ]; then printf "Usage: create <file> [file ...]\n" >&2 return 2 fi for p in "$@"; do # Expand tilde manually if shell doesn't [[ "$p" == "~/"* ]] && p="${HOME}/${p#\~/}" if [ -z "$p" ] || [ "$p" = "/" ]; then printf "create: refusing to operate on '%s'\n" "$p" >&2 continue fi if [ -e "$p" ]; then printf "create: '%s' already exists. Skipping.\n" "$p" >&2 continue fi if install -D /dev/null "$p"; then echo "Created '$p'" fi done } # ----------------------------------------------------------------------------- # Function: kill_port (Kill or check the process using a port) # ----------------------------------------------------------------------------- kill_port() { local action="kill" local signal="TERM" local port local pids local pid case "${1:-}" in -c|--check) action="check" shift ;; -k|--kill) action="kill" shift ;; -f|--force) action="kill" signal="KILL" shift ;; -h|--help|"") printf "Usage: kill_port [--check|-c|--kill|-k|--force|-f] <port_number>\n" >&2 return 1 ;; esac port="${1:-}" if [[ ! "$port" =~ ^[0-9]+$ ]] || [ "$port" -lt 1 ] || [ "$port" -gt 65535 ]; then printf "Error: port must be a number between 1 and 65535.\n" >&2 printf "Usage: kill_port [--check|-c|--kill|-k|--force|-f] <port_number>\n" >&2 return 1 fi if [[ "$OSTYPE" == "darwin"* ]]; then pids="$( { lsof -nP -tiTCP:"$port" -sTCP:LISTEN 2>/dev/null lsof -nP -tiUDP:"$port" 2>/dev/null } | sort -u )" if [ -z "$pids" ]; then printf "Port %s is FREE\n" "$port" return 0 fi printf "Port %s is in use:\n" "$port" lsof -nP -iTCP:"$port" -sTCP:LISTEN -iUDP:"$port" 2>/dev/null else local port_hex local inodes port_hex="$(printf "%04X" "$port")" inodes="$( awk -v port="$port_hex" ' NR > 1 { split($2, local_addr, ":") if (toupper(local_addr[length(local_addr)]) == port && ($4 == "0A" || FILENAME ~ /udp/)) { print $10 } } ' /proc/net/tcp /proc/net/tcp6 /proc/net/udp /proc/net/udp6 2>/dev/null | sort -u )" if [ -z "$inodes" ]; then printf "Port %s is FREE\n" "$port" return 0 fi pids="" pids="$( find /proc/[0-9]*/fd -maxdepth 1 -type l -printf "%p %l\n" 2>/dev/null | awk -v inodes="$inodes" ' BEGIN { split(inodes, inode_list, " ") for (i in inode_list) { wanted["socket:[" inode_list[i] "]"] = 1 } } $2 in wanted { split($1, path, "/") print path[3] } ' | sort -u )" if [ -z "$pids" ]; then printf "Port %s is in use, but no readable process owner was found.\n" "$port" >&2 return 1 fi printf "Port %s is in use:\n" "$port" for pid in $pids; do if [ -r "/proc/$pid/cmdline" ]; then printf " PID %-8s %s\n" "$pid" "$(tr '\0' ' ' < "/proc/$pid/cmdline")" else printf " PID %s\n" "$pid" fi done fi if [ "$action" = "kill" ]; then for pid in $pids; do if kill "-$signal" "$pid" 2>/dev/null; then printf "Killed PID %s with SIG%s.\n" "$pid" "$signal" else printf "Error: failed to kill PID %s. Try with sudo or --force.\n" "$pid" >&2 return 1 fi done fi } # ----------------------------------------------------------------------------- # Function: append_path (Adds to session PATH if exists) # ----------------------------------------------------------------------------- append_path() { local dir="$1" if [ -d "$dir" ]; then case ":$PATH:" in *":$dir:"*) ;; *) PATH="$PATH:$dir" ;; esac elif [ "${SUPPRESS_WARNINGS:-0}" -ne 1 ]; then echo "Warning: $dir does not exist." >&2 fi } # ----------------------------------------------------------------------------- # Function: add_path_to_config (Fixed awk/sed injection) # ----------------------------------------------------------------------------- add_path_to_config() { local new_path="$1" local config_file="$HOME/.bashrc" [[ "$SHELL" == *"zsh"* ]] && config_file="$HOME/.zshrc" if [ -z "$new_path" ]; then printf "Usage: add_path_to_config <directory>\n" >&2 return 1 fi new_path="${new_path/#\~/$HOME}" if [ ! -d "$new_path" ]; then printf "Warning: '%s' does not exist. Add anyway? (y/N) " "$new_path" read -r REPLY [[ ! $REPLY =~ ^[Yy]$ ]] && return 1 fi # Check if already exists in file if grep -Fq "append_path \"$new_path\"" "$config_file"; then printf "Notice: Already in %s.\n" "$config_file" return 0 fi # Robust Injection: Use sed to insert before export PATH or just append if grep -q "^export PATH" "$config_file"; then sed -i.bak "/^export PATH/i append_path \"$new_path\"" "$config_file" else echo "append_path \"$new_path\"" >> "$config_file" echo "export PATH" >> "$config_file" fi printf "✅ Success: Added to %s\n" "$config_file" append_path "$new_path" && export PATH }

# ============================================================================= # ENVIRONMENT & PATH CONFIGURATION # ============================================================================= # 1. Source functions first if [[ -f "$HOME/.func" && -r "$HOME/.func" ]]; then source "$HOME/.func" fi # 2. Define Root Variables export DOTNET_ROOT="$HOME/.dotnet" # 3. PATH INITIALIZATION # ----------------------------------------------------------------------------- append_path "$HOME/.local/bin" append_path "$DOTNET_ROOT" append_path "$DOTNET_ROOT/tools" append_path "$HOME/.opencode/bin" append_path "$HOME/Flutter/bin" # macOS specific paths if [[ "$OSTYPE" == "darwin"* ]]; then append_path "/Applications/Espanso.app/Contents/MacOS" fi # Finalize PATH export PATH

# ============================================================================= # FILE: ~/.sourcerc # Description: Initializes third-party package managers and external tools. # ============================================================================= # ============================================================================= # GENERAL ENV # ============================================================================= if [[ -f "$HOME/.local/bin/env" && -r "$HOME/.local/bin/env" ]]; then source "$HOME/.local/bin/env" fi # ============================================================================= # CLAUDE CODE / AI GATEWAY # ============================================================================= # ============================================================================= # SDKMAN (Java/Kotlin/Scala Version Manager) # ============================================================================= export SDKMAN_DIR="$HOME/.sdkman" if [[ -f "$SDKMAN_DIR/bin/sdkman-init.sh" && -r "$SDKMAN_DIR/bin/sdkman-init.sh" ]]; then source "$SDKMAN_DIR/bin/sdkman-init.sh" fi # ============================================================================= # NVM (Node Version Manager) # ============================================================================= export NVM_DIR="$HOME/.nvm" if [[ -f "$NVM_DIR/nvm.sh" && -r "$NVM_DIR/nvm.sh" ]]; then source "$NVM_DIR/nvm.sh" fi if [[ -f "$NVM_DIR/bash_completion" && -r "$NVM_DIR/bash_completion" ]]; then source "$NVM_DIR/bash_completion" fi # ============================================================================= # GOOGLE CLOUD SDK # ============================================================================= if [[ -f "/opt/google-cloud-sdk/path.zsh.inc" ]]; then source "/opt/google-cloud-sdk/path.zsh.inc" fi if [[ -f "/opt/google-cloud-sdk/completion.zsh.inc" ]]; then source "/opt/google-cloud-sdk/completion.zsh.inc" fi

"$schema" = 'https://starship.rs/config-schema.json' format = """ [](red)\ $os\ $username\ [](bg:peach fg:red)\ $directory\ [](bg:yellow fg:peach)\ $git_branch\ $git_status\ [](fg:yellow bg:green)\ $c\ $rust\ $golang\ $nodejs\ $bun\ $php\ $java\ $kotlin\ $haskell\ $python\ [](fg:green bg:sapphire)\ $conda\ [](fg:sapphire bg:lavender)\ $time\ [ ](fg:lavender)\ $cmd_duration\ $line_break\ $character""" palette = 'catppuccin_mocha' [os] disabled = false style = "bg:red fg:crust" [os.symbols] Windows = "" Ubuntu = "󰕈" SUSE = "" Raspbian = "󰐿" Mint = "󰣭" Macos = "󰀵" Manjaro = "" Linux = "󰌽" Gentoo = "󰣨" Fedora = "󰣛" Alpine = "" Amazon = "" Android = "" AOSC = "" Arch = "󰣇" Artix = "󰣇" CentOS = "" Debian = "󰣚" Redhat = "󱄛" RedHatEnterprise = "󱄛" [username] show_always = true style_user = "bg:red fg:crust" style_root = "bg:red fg:crust" format = '[ $user]($style)' [directory] style = "bg:peach fg:crust" format = "[ $path ]($style)" truncation_length = 3 truncation_symbol = "…/" [directory.substitutions] "Documents" = "󰈙 " "Downloads" = " " "Music" = "󰝚 " "Pictures" = " " "Developer" = "󰲋 " [git_branch] symbol = "" style = "bg:yellow" format = '[[ $symbol $branch ](fg:crust bg:yellow)]($style)' [git_status] style = "bg:yellow" format = '[[($all_status$ahead_behind )](fg:crust bg:yellow)]($style)' [nodejs] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [bun] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [c] symbol = " " style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [rust] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [golang] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [php] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [java] symbol = " " style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [kotlin] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [haskell] symbol = "" style = "bg:green" format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)' [python] symbol = "" style = "bg:green" format = '[[ $symbol( $version)(\(#$virtualenv\)) ](fg:crust bg:green)]($style)' [docker_context] symbol = "" style = "bg:sapphire" format = '[[ $symbol( $context) ](fg:crust bg:sapphire)]($style)' [conda] symbol = "  " style = "fg:crust bg:sapphire" format = '[$symbol$environment ]($style)' ignore_base = false [time] disabled = false time_format = "%R" style = "bg:lavender" format = '[[  $time ](fg:crust bg:lavender)]($style)' [line_break] disabled = false [character] disabled = false success_symbol = '[❯](bold fg:green)' error_symbol = '[❯](bold fg:red)' vimcmd_symbol = '[❮](bold fg:green)' vimcmd_replace_one_symbol = '[❮](bold fg:lavender)' vimcmd_replace_symbol = '[❮](bold fg:lavender)' vimcmd_visual_symbol = '[❮](bold fg:yellow)' [cmd_duration] show_milliseconds = true format = " in $duration " style = "bg:lavender" disabled = false show_notifications = true min_time_to_notify = 45000 [palettes.catppuccin_mocha] rosewater = "#f5e0dc" flamingo = "#f2cdcd" pink = "#f5c2e7" mauve = "#cba6f7" red = "#f38ba8" maroon = "#eba0ac" peach = "#fab387" yellow = "#f9e2af" green = "#a6e3a1" teal = "#94e2d5" sky = "#89dceb" sapphire = "#74c7ec" blue = "#89b4fa" lavender = "#b4befe" text = "#cdd6f4" subtext1 = "#bac2de" subtext0 = "#a6adc8" overlay2 = "#9399b2" overlay1 = "#7f849c" overlay0 = "#6c7086" surface2 = "#585b70" surface1 = "#45475a" surface0 = "#313244" base = "#1e1e2e" mantle = "#181825" crust = "#11111b" [palettes.catppuccin_frappe] rosewater = "#f2d5cf" flamingo = "#eebebe" pink = "#f4b8e4" mauve = "#ca9ee6" red = "#e78284" maroon = "#ea999c" peach = "#ef9f76" yellow = "#e5c890" green = "#a6d189" teal = "#81c8be" sky = "#99d1db" sapphire = "#85c1dc" blue = "#8caaee" lavender = "#babbf1" text = "#c6d0f5" subtext1 = "#b5bfe2" subtext0 = "#a5adce" overlay2 = "#949cbb" overlay1 = "#838ba7" overlay0 = "#737994" surface2 = "#626880" surface1 = "#51576d" surface0 = "#414559" base = "#303446" mantle = "#292c3c" crust = "#232634" [palettes.catppuccin_latte] rosewater = "#dc8a78" flamingo = "#dd7878" pink = "#ea76cb" mauve = "#8839ef" red = "#d20f39" maroon = "#e64553" peach = "#fe640b" yellow = "#df8e1d" green = "#40a02b" teal = "#179299" sky = "#04a5e5" sapphire = "#209fb5" blue = "#1e66f5" lavender = "#7287fd" text = "#4c4f69" subtext1 = "#5c5f77" subtext0 = "#6c6f85" overlay2 = "#7c7f93" overlay1 = "#8c8fa1" overlay0 = "#9ca0b0" surface2 = "#acb0be" surface1 = "#bcc0cc" surface0 = "#ccd0da" base = "#eff1f5" mantle = "#e6e9ef" crust = "#dce0e8" [palettes.catppuccin_macchiato] rosewater = "#f4dbd6" flamingo = "#f0c6c6" pink = "#f5bde6" mauve = "#c6a0f6" red = "#ed8796" maroon = "#ee99a0" peach = "#f5a97f" yellow = "#eed49f" green = "#a6da95" teal = "#8bd5ca" sky = "#91d7e3" sapphire = "#7dc4e4" blue = "#8aadf4" lavender = "#b7bdf8" text = "#cad3f5" subtext1 = "#b8c0e0" subtext0 = "#a5adcb" overlay2 = "#939ab7" overlay1 = "#8087a2" overlay0 = "#6e738d" surface2 = "#5b6078" surface1 = "#494d64" surface0 = "#363a4f" base = "#24273a" mantle = "#1e2030" crust = "#181926"

#!/usr/bin/env zsh set -u repo_dir="${0:A:h}" source "$repo_dir/func" failures=0 fixture_dir="$(mktemp -d "${TMPDIR:-/tmp}/plan build launcher.XXXXXX")" || exit 1 source_dir="$(mktemp -d "${TMPDIR:-/tmp}/plan-build-source.XXXXXX")" || exit 1 export PLAN_BUILD_CACHE_DIR="$fixture_dir/cache with spaces" export PLAN_BUILD_BASE_URL="file://$source_dir" export HOME="$fixture_dir/home with spaces" PLAN_BUILD_SKILLS_DIR="$HOME/.claude/skills" mkdir -p "$source_dir" "$PLAN_BUILD_SKILLS_DIR/plan-build" "$PLAN_BUILD_SKILLS_DIR/plan-build-architect" print -r -- "old standard" > "$PLAN_BUILD_SKILLS_DIR/plan-build/SKILL.md" print -r -- "old architect" > "$PLAN_BUILD_SKILLS_DIR/plan-build-architect/SKILL.md" trap 'rm -rf -- "$fixture_dir" "$source_dir"' EXIT fail() { print -u2 -- "FAIL: $1" failures=$((failures + 1)) } assert_equal() { [[ "$1" = "$2" ]] || fail "$3 (expected '$1', got '$2')" } assert_contains() { [[ "$1" == *"$2"* ]] || fail "$3 (missing '$2')" } assert_file_contains() { command grep -Fq -- "$2" "$1" || fail "$3" } assert_bundle_consistent() { local release="$PLAN_BUILD_CACHE_DIR/current" local script_generation skill_generation architect_generation release="${release:A}" [[ -L "$PLAN_BUILD_CACHE_DIR/current" ]] || fail "$1 current is a symlink" [[ -d "$release" ]] || fail "$1 current resolves to a release" script_generation="$(command sed -n 's/^# generation: //p' "$release/plan_build.zsh")" skill_generation="$(command sed -n 's/ standard skill$//p' "$release/SKILL.md")" architect_generation="$(command sed -n 's/ architect skill$//p' "$release/ARCHITECT.md")" assert_equal "$script_generation" "$skill_generation" "$1 script/standard generation" assert_equal "$script_generation" "$architect_generation" "$1 script/architect generation" } assert_skill_links() { [[ -L "$PLAN_BUILD_SKILLS_DIR/plan-build/SKILL.md" ]] || fail "$1 standard path is symlink" [[ -L "$PLAN_BUILD_SKILLS_DIR/plan-build-architect/SKILL.md" ]] || fail "$1 architect path is symlink" assert_equal "$PLAN_BUILD_CACHE_DIR/current/SKILL.md" \ "$(command readlink "$PLAN_BUILD_SKILLS_DIR/plan-build/SKILL.md")" "$1 standard link target" assert_equal "$PLAN_BUILD_CACHE_DIR/current/ARCHITECT.md" \ "$(command readlink "$PLAN_BUILD_SKILLS_DIR/plan-build-architect/SKILL.md")" "$1 architect link target" } write_bundle() { local generation="$1" local exit_code="${2:-0}" local marker_file="${3:-}" print -r -- '#!/usr/bin/env zsh' > "$source_dir/plan_build.zsh" print -r -- "# generation: $generation" >> "$source_dir/plan_build.zsh" print -r -- "print -r -- \"$generation:\${(j:|:)@}\"" >> "$source_dir/plan_build.zsh" print -r -- "print -r -- \"path:\${0}\"" >> "$source_dir/plan_build.zsh" print -r -- 'print -r -- "skills:${PLAN_BUILD_SKILL_PATH}|${PLAN_BUILD_ARCHITECT_SKILL_PATH}"' >> "$source_dir/plan_build.zsh" [[ -n "$marker_file" ]] && print -r -- ": > ${(q)marker_file}" >> "$source_dir/plan_build.zsh" print -r -- "exit $exit_code" >> "$source_dir/plan_build.zsh" print -r -- "$generation standard skill" > "$source_dir/SKILL.md" print -r -- "$generation architect skill" > "$source_dir/ARCHITECT.md" } run_plan_build() { output="$(plan_build "$@" 2>&1)" rc=$? } write_bundle initial run_plan_build alpha "two words" assert_equal 0 "$rc" "initial migration status" assert_contains "$output" "initial:alpha|two words" "argument forwarding" assert_skill_links "initial migration" assert_bundle_consistent "initial migration" assert_file_contains "$PLAN_BUILD_SKILLS_DIR/plan-build/SKILL.md" "initial standard" "initial standard content" assert_file_contains "$PLAN_BUILD_SKILLS_DIR/plan-build-architect/SKILL.md" "initial architect" "initial architect content" execution_path="${${(f)output}[(r)path:*]#path:}" [[ "$execution_path" == "$PLAN_BUILD_CACHE_DIR"/release.*/plan_build.zsh ]] || fail "execution uses an immutable release path" assert_contains "$output" "skills:${execution_path:h}/SKILL.md|${execution_path:h}/ARCHITECT.md" \ "execution binds immutable skill paths" old_release="$PLAN_BUILD_CACHE_DIR/current" old_release="${old_release:A}" write_bundle replacement 23 run_plan_build forwarded assert_equal 23 "$rc" "canonical status forwarding" assert_contains "$output" "replacement:forwarded" "replacement executes" new_release="$PLAN_BUILD_CACHE_DIR/current" new_release="${new_release:A}" [[ "$new_release" != "$old_release" ]] || fail "refresh activates a unique release" assert_skill_links "replacement" assert_bundle_consistent "replacement" print -r -- 'if broken' > "$source_dir/plan_build.zsh" print -r -- "bad standard skill" > "$source_dir/SKILL.md" print -r -- "bad architect skill" > "$source_dir/ARCHITECT.md" run_plan_build fallback assert_equal 23 "$rc" "failed refresh fallback status" assert_contains "$output" "Warning: Unable to refresh" "failed refresh warning" assert_contains "$output" "replacement:fallback" "failed refresh executes current" preserved_release="$PLAN_BUILD_CACHE_DIR/current" preserved_release="${preserved_release:A}" assert_equal "$new_release" "$preserved_release" "failed refresh preserves current" assert_skill_links "failed refresh" assert_bundle_consistent "failed refresh" export PLAN_BUILD_CURL_COMMAND="definitely-missing-plan-build-curl" run_plan_build no-curl assert_equal 23 "$rc" "missing curl fallback status" assert_contains "$output" "curl is unavailable" "missing curl warning" assert_contains "$output" "replacement:no-curl" "missing curl executes current" rm -f "$PLAN_BUILD_SKILLS_DIR/plan-build/SKILL.md" "$PLAN_BUILD_SKILLS_DIR/plan-build-architect/SKILL.md" run_plan_build repaired-offline assert_equal 23 "$rc" "offline skill repair status" assert_skill_links "offline skill repair" unset PLAN_BUILD_CURL_COMMAND # An already selected immutable script must not change beneath a concurrent caller. ready_file="$fixture_dir/ready" go_file="$fixture_dir/go" first_output="$fixture_dir/first.out" print -r -- '#!/usr/bin/env zsh' > "$source_dir/plan_build.zsh" print -r -- '# generation: concurrent_first' >> "$source_dir/plan_build.zsh" print -r -- 'print -r -- "concurrent_first:${(j:|:)@}"' >> "$source_dir/plan_build.zsh" print -r -- ": > ${(q)ready_file}" >> "$source_dir/plan_build.zsh" print -r -- "while [[ ! -e ${(q)go_file} ]]; do sleep 0.01; done" >> "$source_dir/plan_build.zsh" print -r -- 'print -r -- "finished:first"' >> "$source_dir/plan_build.zsh" print -r -- "concurrent_first standard skill" > "$source_dir/SKILL.md" print -r -- "concurrent_first architect skill" > "$source_dir/ARCHITECT.md" (plan_build one > "$first_output" 2>&1) & first_pid=$! for attempt in {1..500}; do [[ -e "$ready_file" ]] && break sleep 0.01 done [[ -e "$ready_file" ]] || fail "first concurrent call reached canonical execution" write_bundle concurrent_second run_plan_build two assert_equal 0 "$rc" "second concurrent status" assert_contains "$output" "concurrent_second:two" "second concurrent generation" : > "$go_file" wait "$first_pid" || fail "first concurrent status" first_text="$(<"$first_output")" assert_contains "$first_text" "concurrent_first:one" "first call retains selected release" assert_contains "$first_text" "finished:first" "first immutable script finishes" assert_bundle_consistent "concurrent final current" assert_skill_links "concurrent final links" # Cancellation while refreshing must clean staging and never execute canonical code. blocking_curl="$fixture_dir/blocking-curl" cancel_started="$fixture_dir/cancel.started" cancel_executed="$fixture_dir/cancel.executed" write_bundle cancellation-marker 0 "$cancel_executed" run_plan_build activate-cancellation-marker assert_equal 0 "$rc" "cancellation marker bundle activation" rm -f "$cancel_executed" { print -r -- '#!/bin/sh' print -r -- "touch ${(q)cancel_started}" print -r -- 'while :; do sleep 1; done' } > "$blocking_curl" chmod +x "$blocking_curl" export PLAN_BUILD_CURL_COMMAND="$blocking_curl" (plan_build cancelled > "$fixture_dir/cancel.out" 2>&1; cancel_rc=$?; print -r -- "$cancel_rc" > "$fixture_dir/cancel.rc"; exit "$cancel_rc") & cancel_pid=$! for attempt in {1..500}; do [[ -e "$cancel_started" ]] && break sleep 0.01 done kill -TERM "$cancel_pid" wait "$cancel_pid" cancel_wait_rc=$? cancel_recorded_rc="" [[ -s "$fixture_dir/cancel.rc" ]] && cancel_recorded_rc="$(<"$fixture_dir/cancel.rc")" [[ "$cancel_wait_rc" = 143 || "$cancel_recorded_rc" = 143 ]] || fail "TERM returns conventional status 143" [[ ! -e "$cancel_executed" ]] || fail "TERM does not execute canonical plan-build" unset PLAN_BUILD_CURL_COMMAND # A pre-existing lock file must not be mistaken for an active kernel lock. print -r -- "stale contents" > "$PLAN_BUILD_CACHE_DIR/.activate.lock" write_bundle stale-lock-recovery run_plan_build recovered assert_equal 0 "$rc" "stale activation lock recovery status" assert_contains "$output" "stale-lock-recovery:recovered" "stale activation lock recovery execution" # Cancellation while canonical code runs must terminate the child promptly. canonical_started="$fixture_dir/canonical.started" canonical_finished="$fixture_dir/canonical.finished" print -r -- '#!/usr/bin/env zsh' > "$source_dir/plan_build.zsh" print -r -- '# generation: canonical-cancel' >> "$source_dir/plan_build.zsh" print -r -- "trap 'exit 143' TERM" >> "$source_dir/plan_build.zsh" print -r -- ": > ${(q)canonical_started}" >> "$source_dir/plan_build.zsh" print -r -- 'while :; do sleep 1; done' >> "$source_dir/plan_build.zsh" print -r -- ": > ${(q)canonical_finished}" >> "$source_dir/plan_build.zsh" print -r -- "canonical-cancel standard skill" > "$source_dir/SKILL.md" print -r -- "canonical-cancel architect skill" > "$source_dir/ARCHITECT.md" (plan_build canonical-cancel > "$fixture_dir/canonical-cancel.out" 2>&1; print -r -- "$?" > "$fixture_dir/canonical-cancel.rc") & canonical_pid=$! for attempt in {1..500}; do [[ -e "$canonical_started" ]] && break sleep 0.01 done [[ -e "$canonical_started" ]] || fail "canonical cancellation reached execution" kill -TERM "$canonical_pid" wait "$canonical_pid" assert_equal 143 "$(<"$fixture_dir/canonical-cancel.rc")" "canonical cancellation status" [[ ! -e "$canonical_finished" ]] || fail "canonical child continued after TERM" temp_count="$(command find "$PLAN_BUILD_CACHE_DIR" -maxdepth 1 \ \( -name '.stage.*' -o -name '.current.*' \) -print | command wc -l | command tr -d ' ')" assert_equal 0 "$temp_count" "cache staging and temporary links cleaned" skill_temp_count="$(command find "$PLAN_BUILD_SKILLS_DIR" \ \( -name '*.link.*' -o -name '*.backup.*' \) -print | command wc -l | command tr -d ' ')" assert_equal 0 "$skill_temp_count" "skill temporary links and backups cleaned" if (( failures )); then exit 1 fi print -- "PASS: plan_build launcher tests"

" Enable line numbers set number " Enable relative line numbers set relativenumber " Enable syntax highlighting syntax on " Set colorscheme colorscheme slate " Enable file type detection and plugins filetype plugin indent on " Set the tab width to 4 spaces set tabstop=4 set shiftwidth=4 set expandtab " Enable auto-indentation set autoindent set smartindent " Highlight current line set cursorline " Show matching parentheses set showmatch " Enable line wrapping set wrap " Enable mouse support set mouse=a " Use Wayland's clipboard tools when this Vim lacks native clipboard support if !has('clipboard') && exists('v:clipproviders') \ && executable('wl-copy') && executable('wl-paste') function! s:WaylandCopy(register, type, lines) abort let l:text = join(a:lines, "\n") if a:type ==# 'V' let l:text ..= "\n" endif call system('wl-copy', l:text) endfunction function! s:WaylandPaste(register) abort return ['', systemlist('wl-paste --no-newline')] endfunction let v:clipproviders['wltools'] = { \ 'copy': { \ '+': function('s:WaylandCopy'), \ '*': function('s:WaylandCopy') \ }, \ 'paste': { \ '+': function('s:WaylandPaste'), \ '*': function('s:WaylandPaste') \ } \ } set clipmethod^=wltools endif set clipboard=unnamedplus " Disable swap file set noswapfile " Enable incremental search set incsearch " Ignore case in search set ignorecase " Override ignorecase if search contains capital letters set smartcase " Display line and column number of the cursor position set ruler " Set the status line at the bottom set laststatus=2 " Show command in bottom bar set showcmd " Set command height set cmdheight=2 " Set history lines set history=1000 " Disable backup file set nobackup " Enable persistent undo set undofile " Set maximum number of undo levels set undolevels=1000 " Set undo directory if has("persistent_undo") silent !mkdir ~/.vim/undodir > /dev/null 2>&1 set undodir=~/.vim/undodir endif " Set search highlighting set hlsearch " Enable visual bell set visualbell " Set default file encoding set encoding=utf-8 " Set the leader key to space let mapleader = " " " Map <Leader>w to save the file nnoremap <Leader>w :w<CR> " Map <Leader>q to quit nnoremap <Leader>q :q<CR> " Map <Leader>x to save and quit nnoremap <Leader>x :wq<CR> " Enable folding set foldmethod=syntax set foldlevelstart=99 " Enable line wrapping at 80 characters set textwidth=80 set colorcolumn=80 " Add some basic key mappings " Map jj to escape insert mode inoremap jj <Esc> " Map <Leader>n to toggle line numbers nnoremap <Leader>n :set number!<CR> " Map <Leader>r to toggle relative line numbers nnoremap <Leader>r :set relativenumber!<CR> " Configure plugins (if you use a plugin manager like vim-plug) " Example with vim-plug: " call plug#begin('~/.vim/plugged') " Plug 'tpope/vim-sensible' " Plug 'preservim/nerdtree' " Plug 'junegunn/fzf', { 'do': { -> fzf#install() } } " Plug 'airblade/vim-gitgutter' " call plug#end() " NERDTree key mappings " nnoremap <C-n> :NERDTreeToggle<CR> " Enable automatic hard wrapping at textwidth (80 chars) set formatoptions+=t " Auto-wrap text using textwidth set formatoptions+=c " Auto-wrap comments using textwidth set formatoptions+=r " Continue comments when pressing Enter set formatoptions+=o " Continue comments when using 'o' or 'O' set formatoptions+=q " Allow formatting of comments with 'gq' set formatoptions+=n " Recognize numbered lists set formatoptions+=l " Don't break lines that were already long " Enable syntax highlighting syntax on " Increase memory limit for complex syntax parsing (Prevents E363) set maxmempattern=20000