@enjoys/context-engine 1.0.0 → 1.0.2

package/data/completion/bash.json

@@ -0,0 +1,1184 @@
+{
+  "language": "bash",
+  "completions": [
+    {
+      "label": "echo",
+      "kind": 1,
+      "detail": "Display a line of text",
+      "documentation": { "value": "Write arguments to stdout.\n\n```bash\necho \"Hello, world!\"\necho -n \"No newline\"\necho -e \"Tab:\\tNewline:\\n\"\n```" },
+      "insertText": "echo ${1:message}",
+      "insertTextRules": 4,
+      "sortText": "00_echo"
+    },
+    {
+      "label": "printf",
+      "kind": 1,
+      "detail": "Format and print data",
+      "documentation": { "value": "Formats and prints arguments under control of a format string.\n\n```bash\nprintf \"Name: %s, Age: %d\\n\" \"Alice\" 30\nprintf \"%05d\\n\" 42\nprintf -v var \"formatted %s\" \"string\"\n```" },
+      "insertText": "printf \"${1:format}\" ${2:arguments}",
+      "insertTextRules": 4,
+      "sortText": "00_printf"
+    },
+    {
+      "label": "read",
+      "kind": 1,
+      "detail": "Read a line from stdin",
+      "documentation": { "value": "Read a line from standard input and split it into fields.\n\n```bash\nread -p \"Enter name: \" name\nread -r line\nread -a array_var\nread -t 5 -p \"Timeout in 5s: \" answer\n```" },
+      "insertText": "read -r ${1:variable}",
+      "insertTextRules": 4,
+      "sortText": "00_read"
+    },
+    {
+      "label": "cd",
+      "kind": 1,
+      "detail": "Change the current directory",
+      "documentation": { "value": "Change the shell working directory.\n\n```bash\ncd /path/to/dir\ncd ~\ncd -        # go to previous directory\ncd ..       # go up one level\n```" },
+      "insertText": "cd ${1:directory}",
+      "insertTextRules": 4,
+      "sortText": "00_cd"
+    },
+    {
+      "label": "pwd",
+      "kind": 1,
+      "detail": "Print working directory",
+      "documentation": { "value": "Print the name of the current working directory.\n\n```bash\npwd\npwd -P   # resolve symlinks\npwd -L   # use logical path (default)\n```" },
+      "insertText": "pwd",
+      "insertTextRules": 4,
+      "sortText": "00_pwd"
+    },
+    {
+      "label": "export",
+      "kind": 14,
+      "detail": "Set environment variable",
+      "documentation": { "value": "Mark a variable for export to child processes.\n\n```bash\nexport PATH=\"/usr/local/bin:$PATH\"\nexport MY_VAR=\"value\"\nexport -n MY_VAR    # unexport\nexport -p           # list all exported\n```" },
+      "insertText": "export ${1:VAR}=\"${2:value}\"",
+      "insertTextRules": 4,
+      "sortText": "00_export"
+    },
+    {
+      "label": "source",
+      "kind": 1,
+      "detail": "Execute commands from a file in the current shell",
+      "documentation": { "value": "Read and execute commands from a file in the current shell environment.\n\n```bash\nsource ~/.bashrc\nsource ./config.sh\n. ./env.sh        # shorthand for source\n```" },
+      "insertText": "source ${1:file}",
+      "insertTextRules": 4,
+      "sortText": "00_source"
+    },
+    {
+      "label": "alias",
+      "kind": 1,
+      "detail": "Define or display aliases",
+      "documentation": { "value": "Create a shortcut name for a command.\n\n```bash\nalias ll='ls -la'\nalias gs='git status'\nalias       # list all aliases\nalias ll    # show specific alias\n```" },
+      "insertText": "alias ${1:name}='${2:command}'",
+      "insertTextRules": 4,
+      "sortText": "00_alias"
+    },
+    {
+      "label": "unalias",
+      "kind": 1,
+      "detail": "Remove alias definitions",
+      "documentation": { "value": "Remove alias definitions.\n\n```bash\nunalias ll\nunalias -a    # remove all aliases\n```" },
+      "insertText": "unalias ${1:name}",
+      "insertTextRules": 4,
+      "sortText": "00_unalias"
+    },
+    {
+      "label": "type",
+      "kind": 1,
+      "detail": "Describe a command",
+      "documentation": { "value": "Indicate how a command name would be interpreted.\n\n```bash\ntype ls       # ls is aliased to ...\ntype cd       # cd is a shell builtin\ntype -t echo  # builtin\ntype -a echo  # show all locations\n```" },
+      "insertText": "type ${1:command}",
+      "insertTextRules": 4,
+      "sortText": "00_type"
+    },
+    {
+      "label": "which",
+      "kind": 1,
+      "detail": "Locate a command",
+      "documentation": { "value": "Show the full path of a command.\n\n```bash\nwhich python\nwhich -a node   # show all matches\n```" },
+      "insertText": "which ${1:command}",
+      "insertTextRules": 4,
+      "sortText": "00_which"
+    },
+    {
+      "label": "eval",
+      "kind": 1,
+      "detail": "Evaluate arguments as a shell command",
+      "documentation": { "value": "Concatenate arguments and execute them as a shell command.\n\n```bash\ncmd=\"ls -la\"\neval \"$cmd\"\neval \"echo \\$HOME\"\n```" },
+      "insertText": "eval \"${1:command}\"",
+      "insertTextRules": 4,
+      "sortText": "00_eval"
+    },
+    {
+      "label": "exec",
+      "kind": 1,
+      "detail": "Replace the shell with a command",
+      "documentation": { "value": "Replace the shell process with the specified command, or redirect file descriptors.\n\n```bash\nexec /bin/zsh\nexec > output.log 2>&1    # redirect all output\nexec 3< input.txt         # open fd 3 for reading\n```" },
+      "insertText": "exec ${1:command}",
+      "insertTextRules": 4,
+      "sortText": "00_exec"
+    },
+    {
+      "label": "exit",
+      "kind": 14,
+      "detail": "Exit the shell",
+      "documentation": { "value": "Exit the shell with a status code.\n\n```bash\nexit 0    # success\nexit 1    # general error\nexit      # exit with last command's status\n```" },
+      "insertText": "exit ${1:0}",
+      "insertTextRules": 4,
+      "sortText": "00_exit"
+    },
+    {
+      "label": "return",
+      "kind": 14,
+      "detail": "Return from a function",
+      "documentation": { "value": "Return from a shell function with a status code.\n\n```bash\nmy_func() {\n    if [[ -z \"$1\" ]]; then\n        return 1\n    fi\n    return 0\n}\n```" },
+      "insertText": "return ${1:0}",
+      "insertTextRules": 4,
+      "sortText": "00_return"
+    },
+    {
+      "label": "shift",
+      "kind": 1,
+      "detail": "Shift positional parameters",
+      "documentation": { "value": "Shift positional parameters to the left by n positions (default 1).\n\n```bash\nwhile [[ $# -gt 0 ]]; do\n    echo \"$1\"\n    shift\ndone\nshift 2   # shift by 2 positions\n```" },
+      "insertText": "shift ${1:1}",
+      "insertTextRules": 4,
+      "sortText": "00_shift"
+    },
+    {
+      "label": "trap",
+      "kind": 1,
+      "detail": "Trap signals and events",
+      "documentation": { "value": "Execute a command when the shell receives a signal.\n\n```bash\ntrap 'echo Interrupted' INT\ntrap 'rm -f /tmp/tmpfile; exit' EXIT\ntrap '' SIGTERM     # ignore SIGTERM\ntrap - INT          # reset to default\n```" },
+      "insertText": "trap '${1:command}' ${2:SIGNAL}",
+      "insertTextRules": 4,
+      "sortText": "00_trap"
+    },
+    {
+      "label": "set",
+      "kind": 1,
+      "detail": "Set or unset shell options",
+      "documentation": { "value": "Set shell options and positional parameters.\n\n```bash\nset -e          # exit on error\nset -u          # error on unset variables\nset -o pipefail # fail on pipe errors\nset -x          # print commands before execution\nset -- \"a\" \"b\"  # set positional params\n```" },
+      "insertText": "set -${1:euo} pipefail",
+      "insertTextRules": 4,
+      "sortText": "00_set"
+    },
+    {
+      "label": "unset",
+      "kind": 1,
+      "detail": "Unset variables or functions",
+      "documentation": { "value": "Remove variable or function definitions.\n\n```bash\nunset MY_VAR\nunset -f my_function\nunset -v my_variable\n```" },
+      "insertText": "unset ${1:variable}",
+      "insertTextRules": 4,
+      "sortText": "00_unset"
+    },
+    {
+      "label": "declare",
+      "kind": 14,
+      "detail": "Declare variables and attributes",
+      "documentation": { "value": "Declare variables and set attributes.\n\n```bash\ndeclare -i num=42       # integer\ndeclare -r CONST=\"val\"  # readonly\ndeclare -a arr=(1 2 3)  # indexed array\ndeclare -A map          # associative array\ndeclare -x VAR=\"val\"    # export\ndeclare -l lower=\"ABC\"  # lowercase\ndeclare -u upper=\"abc\"  # uppercase\n```" },
+      "insertText": "declare -${1:i} ${2:variable}=${3:value}",
+      "insertTextRules": 4,
+      "sortText": "00_declare"
+    },
+    {
+      "label": "local",
+      "kind": 14,
+      "detail": "Declare local variable in function",
+      "documentation": { "value": "Create a local variable visible only within a function.\n\n```bash\nmy_func() {\n    local name=\"Alice\"\n    local -i count=0\n    local -a items=(a b c)\n}\n```" },
+      "insertText": "local ${1:variable}=\"${2:value}\"",
+      "insertTextRules": 4,
+      "sortText": "00_local"
+    },
+    {
+      "label": "readonly",
+      "kind": 14,
+      "detail": "Mark variables as read-only",
+      "documentation": { "value": "Mark variables or functions as readonly.\n\n```bash\nreadonly PI=3.14159\nreadonly -a COLORS=(red green blue)\nreadonly -f my_func\n```" },
+      "insertText": "readonly ${1:variable}=\"${2:value}\"",
+      "insertTextRules": 4,
+      "sortText": "00_readonly"
+    },
+    {
+      "label": "if",
+      "kind": 14,
+      "detail": "Conditional statement",
+      "documentation": { "value": "Execute commands based on a condition.\n\n```bash\nif [[ condition ]]; then\n    commands\nelif [[ condition ]]; then\n    commands\nelse\n    commands\nfi\n```" },
+      "insertText": "if [[ ${1:condition} ]]; then\n\t${2:commands}\nfi",
+      "insertTextRules": 4,
+      "sortText": "01_if"
+    },
+    {
+      "label": "then",
+      "kind": 14,
+      "detail": "Then clause of if statement",
+      "documentation": { "value": "Begins the body of an `if` or `elif` conditional block." },
+      "insertText": "then",
+      "insertTextRules": 4,
+      "sortText": "01_then"
+    },
+    {
+      "label": "elif",
+      "kind": 14,
+      "detail": "Else-if clause",
+      "documentation": { "value": "Additional condition check within an `if` block.\n\n```bash\nif [[ $x -eq 1 ]]; then\n    echo \"one\"\nelif [[ $x -eq 2 ]]; then\n    echo \"two\"\nfi\n```" },
+      "insertText": "elif [[ ${1:condition} ]]; then\n\t${2:commands}",
+      "insertTextRules": 4,
+      "sortText": "01_elif"
+    },
+    {
+      "label": "else",
+      "kind": 14,
+      "detail": "Else clause",
+      "documentation": { "value": "Default branch when no `if`/`elif` conditions are true." },
+      "insertText": "else\n\t${1:commands}",
+      "insertTextRules": 4,
+      "sortText": "01_else"
+    },
+    {
+      "label": "fi",
+      "kind": 14,
+      "detail": "End if statement",
+      "documentation": { "value": "Closes an `if` conditional block." },
+      "insertText": "fi",
+      "insertTextRules": 4,
+      "sortText": "01_fi"
+    },
+    {
+      "label": "for",
+      "kind": 14,
+      "detail": "For loop",
+      "documentation": { "value": "Iterate over a list of items.\n\n```bash\nfor item in \"${list[@]}\"; do\n    echo \"$item\"\ndone\n\nfor i in {1..10}; do\n    echo \"$i\"\ndone\n\nfor ((i=0; i<10; i++)); do\n    echo \"$i\"\ndone\n```" },
+      "insertText": "for ${1:item} in ${2:list}; do\n\t${3:commands}\ndone",
+      "insertTextRules": 4,
+      "sortText": "01_for"
+    },
+    {
+      "label": "while",
+      "kind": 14,
+      "detail": "While loop",
+      "documentation": { "value": "Execute commands while a condition is true.\n\n```bash\nwhile [[ condition ]]; do\n    commands\ndone\n\nwhile read -r line; do\n    echo \"$line\"\ndone < file.txt\n```" },
+      "insertText": "while ${1:condition}; do\n\t${2:commands}\ndone",
+      "insertTextRules": 4,
+      "sortText": "01_while"
+    },
+    {
+      "label": "until",
+      "kind": 14,
+      "detail": "Until loop",
+      "documentation": { "value": "Execute commands until a condition becomes true.\n\n```bash\nuntil [[ $count -ge 10 ]]; do\n    ((count++))\ndone\n```" },
+      "insertText": "until ${1:condition}; do\n\t${2:commands}\ndone",
+      "insertTextRules": 4,
+      "sortText": "01_until"
+    },
+    {
+      "label": "do",
+      "kind": 14,
+      "detail": "Begin loop body",
+      "documentation": { "value": "Marks the beginning of the loop body in `for`, `while`, `until`, and `select` loops." },
+      "insertText": "do",
+      "insertTextRules": 4,
+      "sortText": "01_do"
+    },
+    {
+      "label": "done",
+      "kind": 14,
+      "detail": "End loop body",
+      "documentation": { "value": "Marks the end of a `for`, `while`, `until`, or `select` loop." },
+      "insertText": "done",
+      "insertTextRules": 4,
+      "sortText": "01_done"
+    },
+    {
+      "label": "case",
+      "kind": 14,
+      "detail": "Case statement",
+      "documentation": { "value": "Pattern matching conditional.\n\n```bash\ncase \"$value\" in\n    pattern1) commands ;;\n    pattern2|pattern3) commands ;;\n    *) default_commands ;;\nesac\n```" },
+      "insertText": "case \"${1:variable}\" in\n\t${2:pattern})\n\t\t${3:commands}\n\t\t;;\n\t*)\n\t\t${4:default}\n\t\t;;\nesac",
+      "insertTextRules": 4,
+      "sortText": "01_case"
+    },
+    {
+      "label": "esac",
+      "kind": 14,
+      "detail": "End case statement",
+      "documentation": { "value": "Closes a `case` pattern matching block." },
+      "insertText": "esac",
+      "insertTextRules": 4,
+      "sortText": "01_esac"
+    },
+    {
+      "label": "select",
+      "kind": 14,
+      "detail": "Select loop for menus",
+      "documentation": { "value": "Create a numbered menu for user selection.\n\n```bash\nselect opt in \"Option 1\" \"Option 2\" \"Quit\"; do\n    case $opt in\n        \"Option 1\") echo \"Selected 1\" ;;\n        \"Option 2\") echo \"Selected 2\" ;;\n        \"Quit\") break ;;\n        *) echo \"Invalid\" ;;\n    esac\ndone\n```" },
+      "insertText": "select ${1:opt} in ${2:options}; do\n\t${3:commands}\ndone",
+      "insertTextRules": 4,
+      "sortText": "01_select"
+    },
+    {
+      "label": "break",
+      "kind": 14,
+      "detail": "Exit from a loop",
+      "documentation": { "value": "Exit from a `for`, `while`, `until`, or `select` loop.\n\n```bash\nbreak      # break innermost loop\nbreak 2    # break out of 2 nested loops\n```" },
+      "insertText": "break",
+      "insertTextRules": 4,
+      "sortText": "01_break"
+    },
+    {
+      "label": "continue",
+      "kind": 14,
+      "detail": "Skip to next loop iteration",
+      "documentation": { "value": "Resume the next iteration of a loop.\n\n```bash\ncontinue     # skip to next iteration\ncontinue 2   # continue outer loop\n```" },
+      "insertText": "continue",
+      "insertTextRules": 4,
+      "sortText": "01_continue"
+    },
+    {
+      "label": "function",
+      "kind": 14,
+      "detail": "Define a function",
+      "documentation": { "value": "Define a shell function.\n\n```bash\nfunction greet() {\n    echo \"Hello, $1!\"\n}\n\n# or without 'function' keyword:\ngreet() {\n    echo \"Hello, $1!\"\n}\n```" },
+      "insertText": "${1:function_name}() {\n\t${2:commands}\n}",
+      "insertTextRules": 4,
+      "sortText": "01_function"
+    },
+    {
+      "label": "grep",
+      "kind": 1,
+      "detail": "Search text using patterns",
+      "documentation": { "value": "Search for lines matching a pattern.\n\n```bash\ngrep \"pattern\" file.txt\ngrep -r \"TODO\" ./src\ngrep -i -n \"error\" log.txt\ngrep -E \"^[0-9]+\" data.txt\ngrep -v \"exclude\" file.txt\ngrep -c \"count\" file.txt\n```" },
+      "insertText": "grep ${1:-r} \"${2:pattern}\" ${3:file}",
+      "insertTextRules": 4,
+      "sortText": "02_grep"
+    },
+    {
+      "label": "sed",
+      "kind": 1,
+      "detail": "Stream editor for text transformation",
+      "documentation": { "value": "Transform text using patterns and commands.\n\n```bash\nsed 's/old/new/g' file.txt\nsed -i 's/old/new/g' file.txt       # in-place edit\nsed -n '10,20p' file.txt             # print lines 10-20\nsed '/pattern/d' file.txt            # delete matching lines\nsed '1i\\Header line' file.txt       # insert at line 1\n```" },
+      "insertText": "sed '${1:s/old/new/g}' ${2:file}",
+      "insertTextRules": 4,
+      "sortText": "02_sed"
+    },
+    {
+      "label": "awk",
+      "kind": 1,
+      "detail": "Pattern scanning and processing",
+      "documentation": { "value": "Process and analyze text files.\n\n```bash\nawk '{print $1}' file.txt\nawk -F: '{print $1, $3}' /etc/passwd\nawk '/pattern/ {print $0}' file.txt\nawk 'NR==1 {print}' file.txt\nawk '{sum += $1} END {print sum}' data.txt\n```" },
+      "insertText": "awk '${1:{print \\$0}}' ${2:file}",
+      "insertTextRules": 4,
+      "sortText": "02_awk"
+    },
+    {
+      "label": "find",
+      "kind": 1,
+      "detail": "Search for files in a directory hierarchy",
+      "documentation": { "value": "Find files and directories matching criteria.\n\n```bash\nfind . -name \"*.txt\"\nfind . -type f -name \"*.log\" -mtime -7\nfind /path -size +100M\nfind . -name \"*.tmp\" -delete\nfind . -type f -exec chmod 644 {} \\;\nfind . -name \"*.py\" | xargs grep \"import\"\n```" },
+      "insertText": "find ${1:.} -name \"${2:pattern}\"",
+      "insertTextRules": 4,
+      "sortText": "02_find"
+    },
+    {
+      "label": "xargs",
+      "kind": 1,
+      "detail": "Build and execute commands from stdin",
+      "documentation": { "value": "Construct argument lists and execute commands.\n\n```bash\nfind . -name \"*.txt\" | xargs grep \"pattern\"\necho \"a b c\" | xargs -n1 echo\nfind . -name \"*.bak\" -print0 | xargs -0 rm\ncat urls.txt | xargs -P 4 -I {} curl {}\n```" },
+      "insertText": "xargs ${1:command}",
+      "insertTextRules": 4,
+      "sortText": "02_xargs"
+    },
+    {
+      "label": "sort",
+      "kind": 1,
+      "detail": "Sort lines of text",
+      "documentation": { "value": "Sort lines in text files.\n\n```bash\nsort file.txt\nsort -n numbers.txt       # numeric sort\nsort -r file.txt          # reverse sort\nsort -u file.txt          # unique sort\nsort -t: -k3 -n /etc/passwd\n```" },
+      "insertText": "sort ${1:file}",
+      "insertTextRules": 4,
+      "sortText": "02_sort"
+    },
+    {
+      "label": "uniq",
+      "kind": 1,
+      "detail": "Report or omit repeated lines",
+      "documentation": { "value": "Filter adjacent matching lines.\n\n```bash\nsort file.txt | uniq\nsort file.txt | uniq -c    # count occurrences\nsort file.txt | uniq -d    # only duplicates\nsort file.txt | uniq -u    # only unique\n```" },
+      "insertText": "uniq ${1:file}",
+      "insertTextRules": 4,
+      "sortText": "02_uniq"
+    },
+    {
+      "label": "wc",
+      "kind": 1,
+      "detail": "Word, line, character, and byte count",
+      "documentation": { "value": "Count lines, words, and characters.\n\n```bash\nwc file.txt         # lines, words, chars\nwc -l file.txt      # line count only\nwc -w file.txt      # word count only\nwc -c file.txt      # byte count\nfind . -name '*.py' | wc -l\n```" },
+      "insertText": "wc -${1:l} ${2:file}",
+      "insertTextRules": 4,
+      "sortText": "02_wc"
+    },
+    {
+      "label": "cut",
+      "kind": 1,
+      "detail": "Remove sections from lines",
+      "documentation": { "value": "Extract columns or fields from text.\n\n```bash\ncut -d: -f1 /etc/passwd    # first field, colon delim\ncut -c1-10 file.txt         # characters 1-10\ncut -f2,4 -d'\\t' data.tsv  # fields 2 and 4\n```" },
+      "insertText": "cut -d'${1:delimiter}' -f${2:fields} ${3:file}",
+      "insertTextRules": 4,
+      "sortText": "02_cut"
+    },
+    {
+      "label": "tr",
+      "kind": 1,
+      "detail": "Translate or delete characters",
+      "documentation": { "value": "Translate, squeeze, or delete characters.\n\n```bash\necho \"HELLO\" | tr 'A-Z' 'a-z'    # to lowercase\necho \"hello\" | tr 'a-z' 'A-Z'    # to uppercase\ntr -d '\\n' < file.txt             # delete newlines\ntr -s ' ' < file.txt              # squeeze spaces\n```" },
+      "insertText": "tr '${1:set1}' '${2:set2}'",
+      "insertTextRules": 4,
+      "sortText": "02_tr"
+    },
+    {
+      "label": "tee",
+      "kind": 1,
+      "detail": "Read from stdin and write to stdout and files",
+      "documentation": { "value": "Duplicate output to both stdout and files.\n\n```bash\ncommand | tee output.log\ncommand | tee -a output.log     # append\ncommand | tee file1 file2       # multiple files\n```" },
+      "insertText": "tee ${1:file}",
+      "insertTextRules": 4,
+      "sortText": "02_tee"
+    },
+    {
+      "label": "head",
+      "kind": 1,
+      "detail": "Output the first part of files",
+      "documentation": { "value": "Display the first lines of a file.\n\n```bash\nhead file.txt          # first 10 lines\nhead -n 20 file.txt    # first 20 lines\nhead -c 100 file.txt   # first 100 bytes\n```" },
+      "insertText": "head -n ${1:10} ${2:file}",
+      "insertTextRules": 4,
+      "sortText": "02_head"
+    },
+    {
+      "label": "tail",
+      "kind": 1,
+      "detail": "Output the last part of files",
+      "documentation": { "value": "Display the last lines of a file.\n\n```bash\ntail file.txt          # last 10 lines\ntail -n 20 file.txt    # last 20 lines\ntail -f /var/log/syslog # follow log in real time\ntail -n +5 file.txt    # from line 5 onwards\n```" },
+      "insertText": "tail -n ${1:10} ${2:file}",
+      "insertTextRules": 4,
+      "sortText": "02_tail"
+    },
+    {
+      "label": "cat",
+      "kind": 1,
+      "detail": "Concatenate and display files",
+      "documentation": { "value": "Concatenate files and print to stdout.\n\n```bash\ncat file.txt\ncat file1.txt file2.txt > combined.txt\ncat -n file.txt        # with line numbers\ncat -A file.txt        # show all (tabs, EOL)\n```" },
+      "insertText": "cat ${1:file}",
+      "insertTextRules": 4,
+      "sortText": "02_cat"
+    },
+    {
+      "label": "less",
+      "kind": 1,
+      "detail": "View file contents with paging",
+      "documentation": { "value": "View file contents page by page.\n\n```bash\nless file.txt\nless -N file.txt       # with line numbers\nless +F /var/log/syslog # follow mode\n```" },
+      "insertText": "less ${1:file}",
+      "insertTextRules": 4,
+      "sortText": "02_less"
+    },
+    {
+      "label": "diff",
+      "kind": 1,
+      "detail": "Compare files line by line",
+      "documentation": { "value": "Compare files and show differences.\n\n```bash\ndiff file1.txt file2.txt\ndiff -u old.txt new.txt    # unified format\ndiff -r dir1/ dir2/        # recursive compare\ndiff --color file1 file2\n```" },
+      "insertText": "diff ${1:file1} ${2:file2}",
+      "insertTextRules": 4,
+      "sortText": "02_diff"
+    },
+    {
+      "label": "chmod",
+      "kind": 1,
+      "detail": "Change file permissions",
+      "documentation": { "value": "Change file mode bits.\n\n```bash\nchmod +x script.sh\nchmod 755 script.sh\nchmod -R 644 ./dir\nchmod u+rw,go-w file.txt\n```" },
+      "insertText": "chmod ${1:755} ${2:file}",
+      "insertTextRules": 4,
+      "sortText": "02_chmod"
+    },
+    {
+      "label": "chown",
+      "kind": 1,
+      "detail": "Change file owner and group",
+      "documentation": { "value": "Change file ownership.\n\n```bash\nchown user:group file.txt\nchown -R www-data:www-data /var/www\nchown user file.txt\n```" },
+      "insertText": "chown ${1:user}:${2:group} ${3:file}",
+      "insertTextRules": 4,
+      "sortText": "02_chown"
+    },
+    {
+      "label": "mkdir",
+      "kind": 1,
+      "detail": "Create directories",
+      "documentation": { "value": "Create one or more directories.\n\n```bash\nmkdir mydir\nmkdir -p path/to/nested/dir\nmkdir -m 755 secure_dir\n```" },
+      "insertText": "mkdir -p ${1:directory}",
+      "insertTextRules": 4,
+      "sortText": "02_mkdir"
+    },
+    {
+      "label": "rmdir",
+      "kind": 1,
+      "detail": "Remove empty directories",
+      "documentation": { "value": "Remove empty directories.\n\n```bash\nrmdir empty_dir\nrmdir -p path/to/empty_dirs\n```" },
+      "insertText": "rmdir ${1:directory}",
+      "insertTextRules": 4,
+      "sortText": "02_rmdir"
+    },
+    {
+      "label": "cp",
+      "kind": 1,
+      "detail": "Copy files and directories",
+      "documentation": { "value": "Copy files and directories.\n\n```bash\ncp source.txt dest.txt\ncp -r source_dir/ dest_dir/\ncp -a source/ dest/          # preserve attributes\ncp -i file.txt backup/       # interactive (prompt)\n```" },
+      "insertText": "cp ${1:source} ${2:destination}",
+      "insertTextRules": 4,
+      "sortText": "02_cp"
+    },
+    {
+      "label": "mv",
+      "kind": 1,
+      "detail": "Move or rename files",
+      "documentation": { "value": "Move or rename files and directories.\n\n```bash\nmv old.txt new.txt\nmv file.txt /path/to/dest/\nmv -i source dest       # interactive\nmv -n source dest       # no overwrite\n```" },
+      "insertText": "mv ${1:source} ${2:destination}",
+      "insertTextRules": 4,
+      "sortText": "02_mv"
+    },
+    {
+      "label": "rm",
+      "kind": 1,
+      "detail": "Remove files or directories",
+      "documentation": { "value": "Remove files or directories.\n\n```bash\nrm file.txt\nrm -f file.txt          # force, no prompt\nrm -r directory/         # recursive\nrm -rf directory/        # force recursive\nrm -i file.txt           # interactive\n```" },
+      "insertText": "rm ${1:file}",
+      "insertTextRules": 4,
+      "sortText": "02_rm"
+    },
+    {
+      "label": "ln",
+      "kind": 1,
+      "detail": "Create links between files",
+      "documentation": { "value": "Create hard and symbolic links.\n\n```bash\nln -s /path/to/target link_name   # symbolic link\nln target link_name                # hard link\nln -sf /new/target link_name      # force symbolic\n```" },
+      "insertText": "ln -s ${1:target} ${2:link_name}",
+      "insertTextRules": 4,
+      "sortText": "02_ln"
+    },
+    {
+      "label": "touch",
+      "kind": 1,
+      "detail": "Create file or update timestamps",
+      "documentation": { "value": "Create an empty file or update file timestamps.\n\n```bash\ntouch newfile.txt\ntouch -t 202301010000 file.txt   # set specific time\ntouch -r ref_file target_file    # copy timestamp\n```" },
+      "insertText": "touch ${1:file}",
+      "insertTextRules": 4,
+      "sortText": "02_touch"
+    },
+    {
+      "label": "tar",
+      "kind": 1,
+      "detail": "Archive files",
+      "documentation": { "value": "Create and extract archive files.\n\n```bash\ntar czf archive.tar.gz dir/    # create gzipped\ntar xzf archive.tar.gz         # extract gzipped\ntar xjf archive.tar.bz2        # extract bzip2\ntar tf archive.tar              # list contents\ntar czf backup.tar.gz --exclude='*.log' dir/\n```" },
+      "insertText": "tar ${1:czf} ${2:archive.tar.gz} ${3:directory}",
+      "insertTextRules": 4,
+      "sortText": "02_tar"
+    },
+    {
+      "label": "gzip",
+      "kind": 1,
+      "detail": "Compress or decompress files",
+      "documentation": { "value": "Compress or expand files.\n\n```bash\ngzip file.txt           # compress (replaces file)\ngzip -d file.txt.gz     # decompress\ngzip -k file.txt        # keep original\ngzip -9 file.txt        # max compression\n```" },
+      "insertText": "gzip ${1:file}",
+      "insertTextRules": 4,
+      "sortText": "02_gzip"
+    },
+    {
+      "label": "curl",
+      "kind": 1,
+      "detail": "Transfer data from or to a server",
+      "documentation": { "value": "Make HTTP requests and transfer data.\n\n```bash\ncurl https://example.com\ncurl -o file.txt https://example.com/file\ncurl -X POST -d '{\"key\":\"val\"}' -H 'Content-Type: application/json' url\ncurl -sS https://example.com | jq .\ncurl -L -O https://example.com/download.tar.gz\n```" },
+      "insertText": "curl ${1:-sS} ${2:url}",
+      "insertTextRules": 4,
+      "sortText": "02_curl"
+    },
+    {
+      "label": "wget",
+      "kind": 1,
+      "detail": "Download files from the web",
+      "documentation": { "value": "Non-interactive network downloader.\n\n```bash\nwget https://example.com/file.tar.gz\nwget -O output.html https://example.com\nwget -q -O- https://example.com\nwget -r -np https://example.com/dir/\n```" },
+      "insertText": "wget ${1:url}",
+      "insertTextRules": 4,
+      "sortText": "02_wget"
+    },
+    {
+      "label": "test",
+      "kind": 1,
+      "detail": "Evaluate conditional expression",
+      "documentation": { "value": "Evaluate conditional expressions. Usually used as `[` or `[[`.\n\n```bash\ntest -f file.txt && echo \"exists\"\n[ -d /path ] && echo \"is directory\"\n[[ -z \"$var\" ]] && echo \"empty\"\n[[ \"$a\" == \"$b\" ]] && echo \"equal\"\n```" },
+      "insertText": "test ${1:expression}",
+      "insertTextRules": 4,
+      "sortText": "00_test"
+    },
+    {
+      "label": "[[ -f file ]]",
+      "kind": 15,
+      "detail": "Test if file exists and is regular file",
+      "documentation": { "value": "Conditional test operators:\n\n```bash\n[[ -f file ]]    # file exists and is regular file\n[[ -d dir ]]     # directory exists\n[[ -e path ]]    # path exists (any type)\n[[ -r file ]]    # file is readable\n[[ -w file ]]    # file is writable\n[[ -x file ]]    # file is executable\n[[ -s file ]]    # file exists and is non-empty\n[[ -L file ]]    # file is symbolic link\n```" },
+      "insertText": "[[ -f \"${1:file}\" ]]",
+      "insertTextRules": 4,
+      "sortText": "03_test_f"
+    },
+    {
+      "label": "[[ -d dir ]]",
+      "kind": 15,
+      "detail": "Test if directory exists",
+      "documentation": { "value": "Test if path is a directory.\n\n```bash\nif [[ -d \"$dir\" ]]; then\n    echo \"Directory exists\"\nfi\n```" },
+      "insertText": "[[ -d \"${1:directory}\" ]]",
+      "insertTextRules": 4,
+      "sortText": "03_test_d"
+    },
+    {
+      "label": "[[ -e path ]]",
+      "kind": 15,
+      "detail": "Test if path exists",
+      "documentation": { "value": "Test if a file or directory exists.\n\n```bash\nif [[ -e \"$path\" ]]; then\n    echo \"Path exists\"\nfi\n```" },
+      "insertText": "[[ -e \"${1:path}\" ]]",
+      "insertTextRules": 4,
+      "sortText": "03_test_e"
+    },
+    {
+      "label": "[[ -z string ]]",
+      "kind": 15,
+      "detail": "Test if string is empty",
+      "documentation": { "value": "Test if a string has zero length.\n\n```bash\nif [[ -z \"$var\" ]]; then\n    echo \"Variable is empty\"\nfi\n```" },
+      "insertText": "[[ -z \"${1:string}\" ]]",
+      "insertTextRules": 4,
+      "sortText": "03_test_z"
+    },
+    {
+      "label": "[[ -n string ]]",
+      "kind": 15,
+      "detail": "Test if string is non-empty",
+      "documentation": { "value": "Test if a string has non-zero length.\n\n```bash\nif [[ -n \"$var\" ]]; then\n    echo \"Variable is not empty\"\nfi\n```" },
+      "insertText": "[[ -n \"${1:string}\" ]]",
+      "insertTextRules": 4,
+      "sortText": "03_test_n"
+    },
+    {
+      "label": "[[ a -eq b ]]",
+      "kind": 15,
+      "detail": "Integer comparison operators",
+      "documentation": { "value": "Integer comparison operators:\n\n```bash\n[[ $a -eq $b ]]    # equal\n[[ $a -ne $b ]]    # not equal\n[[ $a -gt $b ]]    # greater than\n[[ $a -lt $b ]]    # less than\n[[ $a -ge $b ]]    # greater or equal\n[[ $a -le $b ]]    # less or equal\n```" },
+      "insertText": "[[ ${1:a} -${2:eq} ${3:b} ]]",
+      "insertTextRules": 4,
+      "sortText": "03_test_eq"
+    },
+    {
+      "label": "${var:-default}",
+      "kind": 5,
+      "detail": "Variable with default value",
+      "documentation": { "value": "Use default value if variable is unset or null.\n\n```bash\nname=${name:-\"World\"}\necho \"Hello, ${user:-guest}\"\n```" },
+      "insertText": "${${1:var}:-${2:default}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_default"
+    },
+    {
+      "label": "${var:+alternate}",
+      "kind": 5,
+      "detail": "Variable with alternate value",
+      "documentation": { "value": "Use alternate value if variable IS set and non-null.\n\n```bash\nresult=${var:+\"var is set\"}\nflags=\"${verbose:+-v}\"\n```" },
+      "insertText": "${${1:var}:+${2:alternate}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_alternate"
+    },
+    {
+      "label": "${var:=default}",
+      "kind": 5,
+      "detail": "Assign default if unset",
+      "documentation": { "value": "Assign default value if variable is unset or null.\n\n```bash\n: ${CONFIG_DIR:=/etc/myapp}\necho ${name:=\"Anonymous\"}\n```" },
+      "insertText": "${${1:var}:=${2:default}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_assign_default"
+    },
+    {
+      "label": "${var:?error}",
+      "kind": 5,
+      "detail": "Error if variable unset",
+      "documentation": { "value": "Display error and exit if variable is unset or null.\n\n```bash\n: ${HOME:?\"HOME is not set\"}\nfile=${1:?\"Usage: $0 <filename>\"}\n```" },
+      "insertText": "${${1:var}:?${2:error message}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_error"
+    },
+    {
+      "label": "${#var}",
+      "kind": 5,
+      "detail": "String length",
+      "documentation": { "value": "Get the length of a string variable.\n\n```bash\nstr=\"Hello\"\necho ${#str}    # 5\necho ${#arr[@]} # array length\n```" },
+      "insertText": "${#${1:var}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_length"
+    },
+    {
+      "label": "${var%pattern}",
+      "kind": 5,
+      "detail": "Remove shortest suffix match",
+      "documentation": { "value": "Remove shortest trailing pattern match.\n\n```bash\npath=\"/home/user/file.txt\"\necho ${path%/*}       # /home/user\necho ${path%.txt}     # /home/user/file\n```" },
+      "insertText": "${${1:var}%${2:pattern}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_suffix_short"
+    },
+    {
+      "label": "${var%%pattern}",
+      "kind": 5,
+      "detail": "Remove longest suffix match",
+      "documentation": { "value": "Remove longest trailing pattern match.\n\n```bash\npath=\"dir1/dir2/file.tar.gz\"\necho ${path%%/*}      # dir1\necho ${path%%.*}      # dir1/dir2/file\n```" },
+      "insertText": "${${1:var}%%${2:pattern}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_suffix_long"
+    },
+    {
+      "label": "${var#pattern}",
+      "kind": 5,
+      "detail": "Remove shortest prefix match",
+      "documentation": { "value": "Remove shortest leading pattern match.\n\n```bash\npath=\"/home/user/file.txt\"\necho ${path#*/}       # home/user/file.txt\n```" },
+      "insertText": "${${1:var}#${2:pattern}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_prefix_short"
+    },
+    {
+      "label": "${var##pattern}",
+      "kind": 5,
+      "detail": "Remove longest prefix match",
+      "documentation": { "value": "Remove longest leading pattern match.\n\n```bash\npath=\"/home/user/file.txt\"\necho ${path##*/}      # file.txt\n```" },
+      "insertText": "${${1:var}##${2:pattern}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_prefix_long"
+    },
+    {
+      "label": "${var/pattern/replacement}",
+      "kind": 5,
+      "detail": "Pattern substitution (first match)",
+      "documentation": { "value": "Replace first match of pattern.\n\n```bash\nstr=\"hello world hello\"\necho ${str/hello/Hi}      # Hi world hello\n```" },
+      "insertText": "${${1:var}/${2:pattern}/${3:replacement}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_replace"
+    },
+    {
+      "label": "${var//pattern/replacement}",
+      "kind": 5,
+      "detail": "Pattern substitution (all matches)",
+      "documentation": { "value": "Replace all matches of pattern.\n\n```bash\nstr=\"hello world hello\"\necho ${str//hello/Hi}      # Hi world Hi\n```" },
+      "insertText": "${${1:var}//${2:pattern}/${3:replacement}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_replace_all"
+    },
+    {
+      "label": "${var:offset:length}",
+      "kind": 5,
+      "detail": "Substring extraction",
+      "documentation": { "value": "Extract a substring.\n\n```bash\nstr=\"Hello World\"\necho ${str:0:5}    # Hello\necho ${str:6}      # World\necho ${str: -5}    # World (note the space)\n```" },
+      "insertText": "${${1:var}:${2:offset}:${3:length}}",
+      "insertTextRules": 4,
+      "sortText": "04_var_substring"
+    },
+    {
+      "label": "${var^}",
+      "kind": 5,
+      "detail": "Uppercase first character",
+      "documentation": { "value": "Convert first character to uppercase.\n\n```bash\nname=\"alice\"\necho ${name^}     # Alice\necho ${name^^}    # ALICE (all uppercase)\n```" },
+      "insertText": "${${1:var}^}",
+      "insertTextRules": 4,
+      "sortText": "04_var_upper"
+    },
+    {
+      "label": "${var,}",
+      "kind": 5,
+      "detail": "Lowercase first character",
+      "documentation": { "value": "Convert first character to lowercase.\n\n```bash\nname=\"ALICE\"\necho ${name,}     # aLICE\necho ${name,,}    # alice (all lowercase)\n```" },
+      "insertText": "${${1:var},}",
+      "insertTextRules": 4,
+      "sortText": "04_var_lower"
+    },
+    {
+      "label": "if-then-fi",
+      "kind": 27,
+      "detail": "If-then-fi block (snippet)",
+      "documentation": { "value": "Complete if-then-fi conditional block.\n\n```bash\nif [[ condition ]]; then\n    commands\nfi\n```" },
+      "insertText": "if [[ ${1:condition} ]]; then\n\t${2:# commands}\nfi",
+      "insertTextRules": 4,
+      "sortText": "05_snip_if"
+    },
+    {
+      "label": "if-then-else-fi",
+      "kind": 27,
+      "detail": "If-then-else-fi block (snippet)",
+      "documentation": { "value": "Complete if-then-else-fi block.\n\n```bash\nif [[ condition ]]; then\n    commands\nelse\n    other_commands\nfi\n```" },
+      "insertText": "if [[ ${1:condition} ]]; then\n\t${2:# true branch}\nelse\n\t${3:# false branch}\nfi",
+      "insertTextRules": 4,
+      "sortText": "05_snip_if_else"
+    },
+    {
+      "label": "for-in-do-done",
+      "kind": 27,
+      "detail": "For-in loop (snippet)",
+      "documentation": { "value": "For-in loop over a list.\n\n```bash\nfor item in \"${array[@]}\"; do\n    echo \"$item\"\ndone\n```" },
+      "insertText": "for ${1:item} in ${2:\"$\\{list[@]\\}\"}; do\n\t${3:echo \"\\$${1:item}\"}\ndone",
+      "insertTextRules": 4,
+      "sortText": "05_snip_for_in"
+    },
+    {
+      "label": "for-c-style",
+      "kind": 27,
+      "detail": "C-style for loop (snippet)",
+      "documentation": { "value": "C-style for loop.\n\n```bash\nfor ((i=0; i<10; i++)); do\n    echo \"$i\"\ndone\n```" },
+      "insertText": "for ((${1:i}=${2:0}; ${1:i}<${3:10}; ${1:i}++)); do\n\t${4:echo \"\\$${1:i}\"}\ndone",
+      "insertTextRules": 4,
+      "sortText": "05_snip_for_c"
+    },
+    {
+      "label": "while-read-loop",
+      "kind": 27,
+      "detail": "While-read loop (snippet)",
+      "documentation": { "value": "Read a file line by line.\n\n```bash\nwhile IFS= read -r line; do\n    echo \"$line\"\ndone < file.txt\n```" },
+      "insertText": "while IFS= read -r ${1:line}; do\n\t${2:echo \"\\$${1:line}\"}\ndone < ${3:file.txt}",
+      "insertTextRules": 4,
+      "sortText": "05_snip_while_read"
+    },
+    {
+      "label": "while-true-loop",
+      "kind": 27,
+      "detail": "Infinite while loop (snippet)",
+      "documentation": { "value": "Infinite loop until break.\n\n```bash\nwhile true; do\n    commands\n    [[ condition ]] && break\ndone\n```" },
+      "insertText": "while true; do\n\t${1:# commands}\n\t${2:break}\ndone",
+      "insertTextRules": 4,
+      "sortText": "05_snip_while_true"
+    },
+    {
+      "label": "case-esac",
+      "kind": 27,
+      "detail": "Case statement (snippet)",
+      "documentation": { "value": "Pattern matching case statement.\n\n```bash\ncase \"$var\" in\n    pattern1) commands ;;\n    pattern2) commands ;;\n    *) default ;;\nesac\n```" },
+      "insertText": "case \"${1:\\$variable}\" in\n\t${2:pattern1})\n\t\t${3:commands}\n\t\t;;\n\t${4:pattern2})\n\t\t${5:commands}\n\t\t;;\n\t*)\n\t\t${6:echo \"Unknown option\"}\n\t\t;;\nesac",
+      "insertTextRules": 4,
+      "sortText": "05_snip_case"
+    },
+    {
+      "label": "function-def",
+      "kind": 27,
+      "detail": "Function definition (snippet)",
+      "documentation": { "value": "Define a new shell function.\n\n```bash\nmy_function() {\n    local arg1=\"$1\"\n    # function body\n}\n```" },
+      "insertText": "${1:function_name}() {\n\tlocal ${2:arg}=\"\\$1\"\n\t${3:# function body}\n}",
+      "insertTextRules": 4,
+      "sortText": "05_snip_function"
+    },
+    {
+      "label": "#!/bin/bash",
+      "kind": 27,
+      "detail": "Bash shebang (snippet)",
+      "documentation": { "value": "Shebang line for a bash script with strict mode.\n\n```bash\n#!/bin/bash\nset -euo pipefail\n```" },
+      "insertText": "#!/bin/bash\nset -euo pipefail\nIFS=$$'\\n\\t'\n\n${1:# Script starts here}",
+      "insertTextRules": 4,
+      "sortText": "05_snip_shebang"
+    },
+    {
+      "label": "#!/usr/bin/env bash",
+      "kind": 27,
+      "detail": "Portable bash shebang (snippet)",
+      "documentation": { "value": "Portable shebang line using env to find bash.\n\n```bash\n#!/usr/bin/env bash\nset -euo pipefail\n```" },
+      "insertText": "#!/usr/bin/env bash\nset -euo pipefail\n\n${1:# Script starts here}",
+      "insertTextRules": 4,
+      "sortText": "05_snip_shebang_env"
+    },
+    {
+      "label": "heredoc",
+      "kind": 27,
+      "detail": "Here document (snippet)",
+      "documentation": { "value": "Multi-line string using a here document.\n\n```bash\ncat <<EOF\nHello, $USER.\nToday is $(date).\nEOF\n\ncat <<'EOF'   # no variable expansion\n$literal \\text\nEOF\n```" },
+      "insertText": "cat <<${1:EOF}\n${2:content}\n${1:EOF}",
+      "insertTextRules": 4,
+      "sortText": "05_snip_heredoc"
+    },
+    {
+      "label": "herestring",
+      "kind": 27,
+      "detail": "Here string (snippet)",
+      "documentation": { "value": "Feed a string to a command's stdin.\n\n```bash\nread -r first rest <<< \"Hello World\"\ngrep \"pattern\" <<< \"$string_var\"\n```" },
+      "insertText": "<<< \"${1:string}\"",
+      "insertTextRules": 4,
+      "sortText": "05_snip_herestring"
+    },
+    {
+      "label": "trap-cleanup",
+      "kind": 27,
+      "detail": "Trap cleanup on exit (snippet)",
+      "documentation": { "value": "Set up a cleanup function that runs on script exit.\n\n```bash\ncleanup() {\n    rm -rf \"$tmpdir\"\n}\ntrap cleanup EXIT\n```" },
+      "insertText": "cleanup() {\n\t${1:rm -rf \"\\$tmpdir\"}\n}\ntrap cleanup EXIT",
+      "insertTextRules": 4,
+      "sortText": "05_snip_trap_cleanup"
+    },
+    {
+      "label": "getopts-loop",
+      "kind": 27,
+      "detail": "Parse options with getopts (snippet)",
+      "documentation": { "value": "Parse command-line options.\n\n```bash\nwhile getopts \":hv:f:\" opt; do\n    case $opt in\n        h) usage ;;\n        v) verbose=1 ;;\n        f) file=\"$OPTARG\" ;;\n        \\?) echo \"Invalid: -$OPTARG\" ;;\n        :) echo \"Missing arg: -$OPTARG\" ;;\n    esac\ndone\nshift $((OPTIND - 1))\n```" },
+      "insertText": "while getopts \":${1:hv:f:}\" opt; do\n\tcase \\$opt in\n\t\t${2:h}) ${3:usage} ;;\n\t\t${4:v}) ${5:verbose=1} ;;\n\t\t${6:f}) ${7:file=\"\\$OPTARG\"} ;;\n\t\t\\\\?) echo \"Invalid option: -\\$OPTARG\" >&2; exit 1 ;;\n\t\t:) echo \"Option -\\$OPTARG requires an argument\" >&2; exit 1 ;;\n\tesac\ndone\nshift \\$((OPTIND - 1))",
+      "insertTextRules": 4,
+      "sortText": "05_snip_getopts"
+    },
+    {
+      "label": "array-iterate",
+      "kind": 27,
+      "detail": "Iterate over array (snippet)",
+      "documentation": { "value": "Loop over all elements of an array.\n\n```bash\nfor item in \"${array[@]}\"; do\n    echo \"$item\"\ndone\n```" },
+      "insertText": "for ${1:item} in \"${${2:array}[@]}\"; do\n\techo \"\\$${1:item}\"\ndone",
+      "insertTextRules": 4,
+      "sortText": "05_snip_array_iter"
+    },
+    {
+      "label": "pipe-while",
+      "kind": 27,
+      "detail": "Process command output line by line (snippet)",
+      "documentation": { "value": "Pipe command output to a while-read loop.\n\n```bash\ncommand | while IFS= read -r line; do\n    echo \"$line\"\ndone\n```" },
+      "insertText": "${1:command} | while IFS= read -r ${2:line}; do\n\techo \"\\$${2:line}\"\ndone",
+      "insertTextRules": 4,
+      "sortText": "05_snip_pipe_while"
+    },
+    {
+      "label": "process-substitution",
+      "kind": 27,
+      "detail": "Process substitution (snippet)",
+      "documentation": { "value": "Use command output as a file.\n\n```bash\ndiff <(command1) <(command2)\nwhile read -r line; do\n    echo \"$line\"\ndone < <(command)\n```" },
+      "insertText": "<(${1:command})",
+      "insertTextRules": 4,
+      "sortText": "05_snip_proc_sub"
+    },
+    {
+      "label": "command-substitution",
+      "kind": 27,
+      "detail": "Command substitution (snippet)",
+      "documentation": { "value": "Capture command output into a variable.\n\n```bash\nresult=$(command arg1 arg2)\ntoday=$(date +%Y-%m-%d)\ncount=$(wc -l < file.txt)\n```" },
+      "insertText": "$(${1:command})",
+      "insertTextRules": 4,
+      "sortText": "05_snip_cmd_sub"
+    },
+    {
+      "label": "arithmetic",
+      "kind": 27,
+      "detail": "Arithmetic expression (snippet)",
+      "documentation": { "value": "Perform arithmetic.\n\n```bash\n((count++))\n((result = a + b))\nif ((x > 10)); then echo \"big\"; fi\nresult=$((a * b + c))\n```" },
+      "insertText": "$((${1:expression}))",
+      "insertTextRules": 4,
+      "sortText": "05_snip_arithmetic"
+    },
+    {
+      "label": "tempfile",
+      "kind": 27,
+      "detail": "Create temporary file (snippet)",
+      "documentation": { "value": "Safely create and clean up a temporary file.\n\n```bash\ntmpfile=$(mktemp)\ntrap 'rm -f \"$tmpfile\"' EXIT\n```" },
+      "insertText": "${1:tmpfile}=$(mktemp)\ntrap 'rm -f \"\\$${1:tmpfile}\"' EXIT",
+      "insertTextRules": 4,
+      "sortText": "05_snip_tempfile"
+    },
+    {
+      "label": "tempdir",
+      "kind": 27,
+      "detail": "Create temporary directory (snippet)",
+      "documentation": { "value": "Safely create and clean up a temporary directory.\n\n```bash\ntmpdir=$(mktemp -d)\ntrap 'rm -rf \"$tmpdir\"' EXIT\n```" },
+      "insertText": "${1:tmpdir}=$(mktemp -d)\ntrap 'rm -rf \"\\$${1:tmpdir}\"' EXIT",
+      "insertTextRules": 4,
+      "sortText": "05_snip_tempdir"
+    },
+    {
+      "label": "check-command-exists",
+      "kind": 27,
+      "detail": "Check if command exists (snippet)",
+      "documentation": { "value": "Verify a command is available before using it.\n\n```bash\nif ! command -v docker &> /dev/null; then\n    echo \"docker not found\"\n    exit 1\nfi\n```" },
+      "insertText": "if ! command -v ${1:command} &> /dev/null; then\n\techo \"${1:command} is not installed\" >&2\n\texit 1\nfi",
+      "insertTextRules": 4,
+      "sortText": "05_snip_check_cmd"
+    },
+    {
+      "label": "error-handling",
+      "kind": 27,
+      "detail": "Error handling function (snippet)",
+      "documentation": { "value": "Define an error handler with line number reporting.\n\n```bash\ndie() {\n    echo \"Error: $*\" >&2\n    exit 1\n}\n```" },
+      "insertText": "die() {\n\techo \"Error: \\$*\" >&2\n\texit 1\n}",
+      "insertTextRules": 4,
+      "sortText": "05_snip_error_handling"
+    },
+    {
+      "label": "logging",
+      "kind": 27,
+      "detail": "Logging functions (snippet)",
+      "documentation": { "value": "Simple logging functions.\n\n```bash\nlog()  { echo \"[$(date +'%Y-%m-%d %H:%M:%S')] $*\"; }\nwarn() { log \"WARN: $*\" >&2; }\nerr()  { log \"ERROR: $*\" >&2; }\n```" },
+      "insertText": "log()  { echo \"[\\$(date +'%Y-%m-%d %H:%M:%S')] \\$*\"; }\nwarn() { log \"WARN: \\$*\" >&2; }\nerr()  { log \"ERROR: \\$*\" >&2; }",
+      "insertTextRules": 4,
+      "sortText": "05_snip_logging"
+    },
+    {
+      "label": "script-dir",
+      "kind": 27,
+      "detail": "Get script directory (snippet)",
+      "documentation": { "value": "Reliably get the directory of the current script.\n\n```bash\nSCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"\n```" },
+      "insertText": "SCRIPT_DIR=\"\\$(cd \"\\$(dirname \"\\${BASH_SOURCE[0]}\")\" && pwd)\"",
+      "insertTextRules": 4,
+      "sortText": "05_snip_script_dir"
+    },
+    {
+      "label": "confirm-prompt",
+      "kind": 27,
+      "detail": "Confirmation prompt (snippet)",
+      "documentation": { "value": "Ask for user confirmation.\n\n```bash\nread -rp \"Are you sure? [y/N] \" ans\n[[ \"$ans\" =~ ^[Yy] ]] || exit 0\n```" },
+      "insertText": "read -rp \"${1:Are you sure?} [y/N] \" ans\n[[ \"\\$ans\" =~ ^[Yy] ]] || exit 0",
+      "insertTextRules": 4,
+      "sortText": "05_snip_confirm"
+    },
+    {
+      "label": "retry-loop",
+      "kind": 27,
+      "detail": "Retry a command (snippet)",
+      "documentation": { "value": "Retry a command with exponential backoff.\n\n```bash\nretry() {\n    local max=5 delay=1 i\n    for ((i=1; i<=max; i++)); do\n        \"$@\" && return 0\n        sleep $delay\n        ((delay *= 2))\n    done\n    return 1\n}\n```" },
+      "insertText": "retry() {\n\tlocal max=${1:5} delay=1 i\n\tfor ((i=1; i<=max; i++)); do\n\t\t\"\\$@\" && return 0\n\t\techo \"Attempt \\$i/\\$max failed. Retrying in \\${delay}s...\" >&2\n\t\tsleep \\$delay\n\t\t((delay *= 2))\n\tdone\n\treturn 1\n}",
+      "insertTextRules": 4,
+      "sortText": "05_snip_retry"
+    },
+    {
+      "label": "parallel-jobs",
+      "kind": 27,
+      "detail": "Run parallel background jobs (snippet)",
+      "documentation": { "value": "Run commands in parallel and wait for all.\n\n```bash\npids=()\nfor item in \"${items[@]}\"; do\n    process \"$item\" &\n    pids+=(\"$!\")\ndone\nfor pid in \"${pids[@]}\"; do\n    wait \"$pid\"\ndone\n```" },
+      "insertText": "pids=()\nfor ${1:item} in \"${${2:items}[@]}\"; do\n\t${3:process} \"\\$${1:item}\" &\n\tpids+=(\"\\$!\")\ndone\nfor pid in \"\\${pids[@]}\"; do\n\twait \"\\$pid\"\ndone",
+      "insertTextRules": 4,
+      "sortText": "05_snip_parallel"
+    },
+    {
+      "label": "basename",
+      "kind": 1,
+      "detail": "Strip directory from filename",
+      "documentation": { "value": "Return the filename portion of a path.\n\n```bash\nbasename /path/to/file.txt        # file.txt\nbasename /path/to/file.txt .txt   # file\nbasename -a /path/a /path/b       # a  b\n```" },
+      "insertText": "basename ${1:path}",
+      "insertTextRules": 4,
+      "sortText": "02_basename"
+    },
+    {
+      "label": "dirname",
+      "kind": 1,
+      "detail": "Strip filename from path",
+      "documentation": { "value": "Return the directory portion of a path.\n\n```bash\ndirname /path/to/file.txt    # /path/to\ndirname ./file.txt            # .\n```" },
+      "insertText": "dirname ${1:path}",
+      "insertTextRules": 4,
+      "sortText": "02_dirname"
+    },
+    {
+      "label": "date",
+      "kind": 1,
+      "detail": "Display or set date and time",
+      "documentation": { "value": "Display the current date/time or convert date formats.\n\n```bash\ndate\ndate +\"%Y-%m-%d %H:%M:%S\"\ndate -d \"yesterday\" +%Y-%m-%d\ndate -u    # UTC time\n```" },
+      "insertText": "date +\"${1:%Y-%m-%d %H:%M:%S}\"",
+      "insertTextRules": 4,
+      "sortText": "02_date"
+    },
+    {
+      "label": "sleep",
+      "kind": 1,
+      "detail": "Delay for a specified time",
+      "documentation": { "value": "Pause execution for a specified duration.\n\n```bash\nsleep 5      # 5 seconds\nsleep 0.5    # half second\nsleep 1m     # 1 minute\nsleep 1h     # 1 hour\n```" },
+      "insertText": "sleep ${1:1}",
+      "insertTextRules": 4,
+      "sortText": "02_sleep"
+    },
+    {
+      "label": "mktemp",
+      "kind": 1,
+      "detail": "Create temporary file or directory",
+      "documentation": { "value": "Safely create a temporary file or directory.\n\n```bash\ntmpfile=$(mktemp)\ntmpdir=$(mktemp -d)\nmktemp /tmp/myapp.XXXXXX\n```" },
+      "insertText": "mktemp ${1:-d}",
+      "insertTextRules": 4,
+      "sortText": "02_mktemp"
+    },
+    {
+      "label": "xargs",
+      "kind": 1,
+      "detail": "Build and execute commands from stdin",
+      "documentation": { "value": "Construct argument lists and invoke commands.\n\n```bash\nfind . -name '*.txt' | xargs wc -l\necho '1 2 3' | xargs -n1 echo\nfind . -print0 | xargs -0 rm\ncat list.txt | xargs -I {} cp {} /dest/\n```" },
+      "insertText": "xargs ${1:-I {}} ${2:command}",
+      "insertTextRules": 4,
+      "sortText": "02_xargs2"
+    },
+    {
+      "label": "wait",
+      "kind": 1,
+      "detail": "Wait for background processes",
+      "documentation": { "value": "Wait for background jobs to complete.\n\n```bash\ncommand1 &\ncommand2 &\nwait         # wait for all\nwait $pid    # wait for specific PID\nwait -n      # wait for any one job\n```" },
+      "insertText": "wait ${1}",
+      "insertTextRules": 4,
+      "sortText": "00_wait"
+    },
+    {
+      "label": "jobs",
+      "kind": 1,
+      "detail": "List active jobs",
+      "documentation": { "value": "Display status of jobs in the current session.\n\n```bash\njobs\njobs -l   # include PID\njobs -p   # PIDs only\n```" },
+      "insertText": "jobs",
+      "insertTextRules": 4,
+      "sortText": "00_jobs"
+    },
+    {
+      "label": "bg",
+      "kind": 1,
+      "detail": "Resume job in background",
+      "documentation": { "value": "Resume a suspended job in the background.\n\n```bash\nbg       # resume last stopped job\nbg %1    # resume job 1\n```" },
+      "insertText": "bg",
+      "insertTextRules": 4,
+      "sortText": "00_bg"
+    },
+    {
+      "label": "fg",
+      "kind": 1,
+      "detail": "Resume job in foreground",
+      "documentation": { "value": "Bring a background job to the foreground.\n\n```bash\nfg       # bring last job to foreground\nfg %1    # bring job 1 to foreground\n```" },
+      "insertText": "fg",
+      "insertTextRules": 4,
+      "sortText": "00_fg"
+    },
+    {
+      "label": "kill",
+      "kind": 1,
+      "detail": "Send signal to a process",
+      "documentation": { "value": "Send a signal to a process.\n\n```bash\nkill $pid\nkill -9 $pid       # SIGKILL (force)\nkill -TERM $pid    # SIGTERM (graceful)\nkill -HUP $pid     # SIGHUP (reload)\nkill %1            # kill job 1\n```" },
+      "insertText": "kill ${1:pid}",
+      "insertTextRules": 4,
+      "sortText": "02_kill"
+    },
+    {
+      "label": "pushd",
+      "kind": 1,
+      "detail": "Push directory onto stack",
+      "documentation": { "value": "Save current directory and change to a new one.\n\n```bash\npushd /some/dir     # save cwd, cd to /some/dir\npopd                # return to saved directory\n```" },
+      "insertText": "pushd ${1:directory}",
+      "insertTextRules": 4,
+      "sortText": "00_pushd"
+    },
+    {
+      "label": "popd",
+      "kind": 1,
+      "detail": "Pop directory from stack",
+      "documentation": { "value": "Return to the directory saved by pushd.\n\n```bash\npushd /tmp\n# ... work in /tmp ...\npopd   # return to previous directory\n```" },
+      "insertText": "popd",
+      "insertTextRules": 4,
+      "sortText": "00_popd"
+    },
+    {
+      "label": "mapfile",
+      "kind": 1,
+      "detail": "Read lines into an array",
+      "documentation": { "value": "Read lines from stdin into an indexed array.\n\n```bash\nmapfile -t lines < file.txt\nmapfile -t words < <(echo \"a b c\" | tr ' ' '\\n')\nreadarray -t arr < file.txt   # alias for mapfile\n```" },
+      "insertText": "mapfile -t ${1:array} < ${2:file}",
+      "insertTextRules": 4,
+      "sortText": "00_mapfile"
+    },
+    {
+      "label": "readarray",
+      "kind": 1,
+      "detail": "Read lines into an array (alias for mapfile)",
+      "documentation": { "value": "Read lines from stdin into an indexed array. Alias for `mapfile`.\n\n```bash\nreadarray -t lines < file.txt\n```" },
+      "insertText": "readarray -t ${1:array} < ${2:file}",
+      "insertTextRules": 4,
+      "sortText": "00_readarray"
+    }
+  ]
+}