pdd-cli 0.0.2__py3-none-any.whl

pdd/pdd_completion.fish

@@ -0,0 +1,72 @@
+# pdd_completion.fish - Fish shell completion for PDD CLI
+
+# Global options
+complete -c pdd -n "__fish_use_subcommand" -l force -d "Overwrite existing files without confirmation"
+complete -c pdd -n "__fish_use_subcommand" -l strength -x -d "Set AI model strength (0.0 to 1.0)"
+complete -c pdd -n "__fish_use_subcommand" -l temperature -x -d "Set AI model temperature"
+complete -c pdd -n "__fish_use_subcommand" -l verbose -d "Increase output verbosity"
+complete -c pdd -n "__fish_use_subcommand" -l quiet -d "Decrease output verbosity"
+complete -c pdd -n "__fish_use_subcommand" -l output-cost -r -d "Enable cost tracking and output CSV file"
+complete -c pdd -n "__fish_use_subcommand" -l review-examples -d "Review few-shot examples before execution"
+complete -c pdd -n "__fish_use_subcommand" -l help -d "Show help message"
+complete -c pdd -n "__fish_use_subcommand" -l version -d "Show version information"
+
+# Commands
+complete -c pdd -n "__fish_use_subcommand" -a generate -d "Generate code from prompt file"
+complete -c pdd -n "__fish_use_subcommand" -a example -d "Create example from prompt and code"
+complete -c pdd -n "__fish_use_subcommand" -a test -d "Generate or enhance unit tests"
+complete -c pdd -n "__fish_use_subcommand" -a preprocess -d "Preprocess prompt files"
+complete -c pdd -n "__fish_use_subcommand" -a fix -d "Fix errors in code and tests"
+complete -c pdd -n "__fish_use_subcommand" -a split -d "Split large prompt files"
+complete -c pdd -n "__fish_use_subcommand" -a change -d "Modify prompt based on change prompt"
+complete -c pdd -n "__fish_use_subcommand" -a update -d "Update prompt based on modified code"
+complete -c pdd -n "__fish_use_subcommand" -a detect -d "Detect prompts needing changes"
+complete -c pdd -n "__fish_use_subcommand" -a conflicts -d "Analyze conflicts between prompts"
+complete -c pdd -n "__fish_use_subcommand" -a crash -d "Fix code causing program crash"
+complete -c pdd -n "__fish_use_subcommand" -a trace -d "Trace code line to prompt"
+complete -c pdd -n "__fish_use_subcommand" -a bug -d "Generate unit test from bug report"
+complete -c pdd -n "__fish_use_subcommand" -a auto-deps -d "Analyze and insert dependencies"
+
+# Command-specific completions
+complete -c pdd -n "__fish_seen_subcommand_from generate" -l output -r -d "Output location for generated code"
+complete -c pdd -n "__fish_seen_subcommand_from generate" -a "(__fish_complete_suffix .prompt)"
+
+complete -c pdd -n "__fish_seen_subcommand_from example" -l output -r -d "Output location for example code"
+complete -c pdd -n "__fish_seen_subcommand_from example" -a "(__fish_complete_suffix .prompt)"
+complete -c pdd -n "__fish_seen_subcommand_from example" -a "(__fish_complete_suffix .py .js .java .cpp .rb .go)"
+
+complete -c pdd -n "__fish_seen_subcommand_from test" -l output -r -d "Output location for test file"
+complete -c pdd -n "__fish_seen_subcommand_from test" -l language -x -d "Specify programming language"
+complete -c pdd -n "__fish_seen_subcommand_from test" -l coverage-report -r -d "Path to coverage report"
+complete -c pdd -n "__fish_seen_subcommand_from test" -l existing-tests -r -d "Path to existing test file"
+complete -c pdd -n "__fish_seen_subcommand_from test" -l target-coverage -x -d "Target coverage percentage"
+complete -c pdd -n "__fish_seen_subcommand_from test" -l merge -d "Merge new tests with existing"
+complete -c pdd -n "__fish_seen_subcommand_from test" -a "(__fish_complete_suffix .prompt)"
+complete -c pdd -n "__fish_seen_subcommand_from test" -a "(__fish_complete_suffix .py .js .java .cpp .rb .go)"
+
+complete -c pdd -n "__fish_seen_subcommand_from preprocess" -l output -r -d "Output location for preprocessed file"
+complete -c pdd -n "__fish_seen_subcommand_from preprocess" -l xml -d "Insert XML delimiters"
+complete -c pdd -n "__fish_seen_subcommand_from preprocess" -l recursive -d "Recursively preprocess"
+complete -c pdd -n "__fish_seen_subcommand_from preprocess" -l double -d "Double curly brackets"
+complete -c pdd -n "__fish_seen_subcommand_from preprocess" -l exclude -x -d "Keys to exclude from doubling"
+complete -c pdd -n "__fish_seen_subcommand_from preprocess" -a "(__fish_complete_suffix .prompt)"
+
+complete -c pdd -n "__fish_seen_subcommand_from fix" -l output-test -r -d "Output location for fixed test"
+complete -c pdd -n "__fish_seen_subcommand_from fix" -l output-code -r -d "Output location for fixed code"
+complete -c pdd -n "__fish_seen_subcommand_from fix" -l output-results -r -d "Output location for fix results"
+complete -c pdd -n "__fish_seen_subcommand_from fix" -l loop -d "Enable iterative fixing"
+complete -c pdd -n "__fish_seen_subcommand_from fix" -l verification-program -r -d "Verification program path"
+complete -c pdd -n "__fish_seen_subcommand_from fix" -l max-attempts -x -d "Maximum fix attempts"
+complete -c pdd -n "__fish_seen_subcommand_from fix" -l budget -x -d "Maximum budget for fixing"
+complete -c pdd -n "__fish_seen_subcommand_from fix" -l auto-submit -d "Auto-submit if tests pass"
+complete -c pdd -n "__fish_seen_subcommand_from fix" -a "(__fish_complete_suffix .prompt)"
+complete -c pdd -n "__fish_seen_subcommand_from fix" -a "(__fish_complete_suffix .py .js .java .cpp .rb .go)"
+complete -c pdd -n "__fish_seen_subcommand_from fix" -a "(__fish_complete_suffix .log)"
+
+# File completion for all commands
+complete -c pdd -n "__fish_seen_subcommand_from generate example test preprocess fix split change update detect conflicts crash trace bug auto-deps" -a "(__fish_complete_suffix .prompt)"
+complete -c pdd -n "__fish_seen_subcommand_from generate example test preprocess fix split change update detect conflicts crash trace bug auto-deps" -a "(__fish_complete_suffix .py .js .java .cpp .rb .go)"
+complete -c pdd -n "__fish_seen_subcommand_from generate example test preprocess fix split change update detect conflicts crash trace bug auto-deps" -a "(__fish_complete_suffix .log .txt .csv)"
+
+# Help completion
+complete -c pdd -n "__fish_seen_subcommand_from help" -a "generate example test preprocess fix split change update detect conflicts crash trace bug auto-deps" -d "Show help for specific command"

pdd/pdd_completion.sh

@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+
+# PDD CLI Bash Completion Script
+# Version: 0.0.2
+# Supports all PDD commands and options with filename completion
+
+_pdd() {
+    local cur prev words cword
+    
+    # Replace _init_completion with manual initialization
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+    words=("${COMP_WORDS[@]}")
+    cword=$COMP_CWORD
+
+    # Global options
+    local global_opts="--force --strength --temperature --verbose --quiet --output-cost --review-examples --help --version"
+
+    # Commands
+    local commands="generate example test preprocess fix split change update detect conflicts crash trace bug auto-deps"
+
+    # Command-specific options
+    local generate_opts="--output"
+    local example_opts="--output"
+    local test_opts="--output --language --coverage-report --existing-tests --target-coverage --merge"
+    local preprocess_opts="--output --xml --recursive --double --exclude"
+    local fix_opts="--output-test --output-code --output-results --loop --verification-program --max-attempts --budget --auto-submit"
+    local split_opts="--output-sub --output-modified"
+    local change_opts="--output --csv"
+    local update_opts="--output --git"
+    local detect_opts="--output"
+    local conflicts_opts="--output"
+    local crash_opts="--output --output-program --loop --max-attempts --budget"
+    local trace_opts="--output"
+    local bug_opts="--output --language"
+    local auto_deps_opts="--output --csv --force-scan"
+
+    # Complete global options before command
+    if [[ $cword -eq 1 ]]; then
+        COMPREPLY=($(compgen -W "$global_opts $commands" -- "$cur"))
+        return
+    fi
+
+    # Complete command-specific options
+    case ${words[1]} in
+        generate)
+            _complete_files ".prompt"
+            COMPREPLY+=($(compgen -W "$generate_opts" -- "$cur"))
+            ;;
+        example)
+            _complete_files ".prompt"
+            _complete_files
+            COMPREPLY+=($(compgen -W "$example_opts" -- "$cur"))
+            ;;
+        test)
+            _complete_files ".prompt"
+            _complete_files
+            COMPREPLY+=($(compgen -W "$test_opts" -- "$cur"))
+            ;;
+        preprocess)
+            _complete_files ".prompt"
+            COMPREPLY+=($(compgen -W "$preprocess_opts" -- "$cur"))
+            ;;
+        fix)
+            _complete_files ".prompt"
+            _complete_files
+            _complete_files
+            _complete_files
+            COMPREPLY+=($(compgen -W "$fix_opts" -- "$cur"))
+            ;;
+        split)
+            _complete_files ".prompt"
+            _complete_files
+            _complete_files
+            COMPREPLY+=($(compgen -W "$split_opts" -- "$cur"))
+            ;;
+        change)
+            _complete_files ".prompt"
+            _complete_files
+            _complete_files
+            COMPREPLY+=($(compgen -W "$change_opts" -- "$cur"))
+            ;;
+        update)
+            _complete_files ".prompt"
+            _complete_files
+            _complete_files
+            COMPREPLY+=($(compgen -W "$update_opts" -- "$cur"))
+            ;;
+        detect)
+            _complete_files ".prompt"
+            _complete_files
+            COMPREPLY+=($(compgen -W "$detect_opts" -- "$cur"))
+            ;;
+        conflicts)
+            _complete_files ".prompt"
+            _complete_files
+            COMPREPLY+=($(compgen -W "$conflicts_opts" -- "$cur"))
+            ;;
+        crash)
+            _complete_files ".prompt"
+            _complete_files
+            _complete_files
+            _complete_files
+            COMPREPLY+=($(compgen -W "$crash_opts" -- "$cur"))
+            ;;
+        trace)
+            _complete_files ".prompt"
+            _complete_files
+            COMPREPLY+=($(compgen -W "$trace_opts" -- "$cur"))
+            ;;
+        bug)
+            _complete_files ".prompt"
+            _complete_files
+            _complete_files
+            _complete_files
+            _complete_files
+            COMPREPLY+=($(compgen -W "$bug_opts" -- "$cur"))
+            ;;
+        auto-deps)
+            _complete_files ".prompt"
+            COMPREPLY+=($(compgen -W "$auto_deps_opts" -- "$cur"))
+            ;;
+        *)
+            COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+            ;;
+    esac
+}
+
+_complete_files() {
+    local ext=$1
+    local files
+    if [[ -n $ext ]]; then
+        files=$(compgen -f -X "!*$ext" -- "$cur")
+    else
+        files=$(compgen -f -- "$cur")
+    fi
+    COMPREPLY+=($(compgen -W "$files" -- "$cur"))
+}
+
+complete -F _pdd pdd

pdd/pdd_completion.zsh

@@ -0,0 +1,418 @@
+#compdef pdd
+
+##
+# ZSH Completion for PDD CLI (Prompt-Driven Development)
+#
+# Save this file as "pdd_completion.zsh" and source it from your ~/.zshrc:
+#   autoload -U compinit && compinit
+#   fpath=(/path/to/this/file $fpath)
+#   source /path/to/pdd_completion.zsh
+#
+# Or place it in a standard completion directory recognized by ZSH.
+#
+# After installation, typing:
+#   pdd <Tab>
+# will offer completions for subcommands and options as described in the PDD CLI README.
+##
+
+# 1) Define global options for all commands.
+local -a _pdd_global_opts
+_pdd_global_opts=(
+  '--force[Overwrite existing files without asking for confirmation.]'
+  '--strength[Set the strength of the AI model (0.0 to 1.0, default: 0.5)]:strength:(0.0 0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 0.9 1.0)'
+  '--temperature[Set the temperature of the AI model (default: 0.0)]:temperature:(0.0 0.25 0.5 0.75 1.0)'
+  '--verbose[Increase output verbosity for more detailed information.]'
+  '--quiet[Decrease output verbosity (minimal information).]'
+  '--output-cost[Enable cost tracking and output a CSV file with usage details.]:filename:_files'
+  '--review-examples[Review and optionally exclude few-shot examples before command execution.]'
+  '--help[Show help message and exit.]'
+  '--version[Show version and exit.]'
+)
+
+##
+# Per-subcommand completion functions
+##
+
+# generate
+# Usage: pdd [GLOBAL OPTIONS] generate [OPTIONS] PROMPT_FILE
+# Options:
+#   --output [LOCATION]
+# Args:
+#   1: PROMPT_FILE
+_pdd_generate() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Specify where to save the generated code.]:filename:_files' \
+    '1:prompt-file:_files' \
+    '*:filename:_files'
+}
+
+# example
+# Usage: pdd [GLOBAL OPTIONS] example [OPTIONS] PROMPT_FILE CODE_FILE
+# Options:
+#   --output [LOCATION]
+# Args:
+#   1: PROMPT_FILE
+#   2: CODE_FILE
+_pdd_example() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Specify where to save the generated example code.]:filename:_files' \
+    '1:prompt-file:_files' \
+    '2:code-file:_files' \
+    '*:filename:_files'
+}
+
+# test
+# Usage: pdd [GLOBAL OPTIONS] test [OPTIONS] PROMPT_FILE CODE_FILE
+# Options:
+#   --output [LOCATION]
+#   --language [LANGUAGE]
+#   --coverage-report [PATH]
+#   --existing-tests [PATH]
+#   --target-coverage [FLOAT]
+#   --merge
+# Args:
+#   1: PROMPT_FILE
+#   2: CODE_FILE
+_pdd_test() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Specify where to save the generated test file.]:filename:_files' \
+    '--language=[Specify the programming language.]:string:_guard' \
+    '--coverage-report=[Path to a coverage report file.]:filename:_files' \
+    '--existing-tests=[Path to existing test file.]:filename:_files' \
+    '--target-coverage=[Desired code coverage percentage (default 90.0)]:float' \
+    '--merge[Merge new tests with existing test file when using --existing-tests.]' \
+    '1:prompt-file:_files' \
+    '2:code-file:_files' \
+    '*:filename:_files'
+}
+
+# preprocess
+# Usage: pdd [GLOBAL OPTIONS] preprocess [OPTIONS] PROMPT_FILE
+# Options:
+#   --output [LOCATION]
+#   --xml
+#   --recursive
+#   --double
+#   --exclude
+# Arg:
+#   1: PROMPT_FILE
+_pdd_preprocess() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Where to save the preprocessed prompt file.]:filename:_files' \
+    '--xml[Insert XML delimiters instead of normal preprocessing.]' \
+    '--recursive[Recursively preprocess all prompt files in the prompt file.]' \
+    '--double[Double curly braces in prompt file(s).]' \
+    '--exclude=[List of keys to exclude from curly bracket doubling.]:string:_guard' \
+    '1:prompt-file:_files' \
+    '*:filename:_files'
+}
+
+# fix
+# Usage: pdd [GLOBAL OPTIONS] fix [OPTIONS] PROMPT_FILE CODE_FILE UNIT_TEST_FILE ERROR_FILE
+# Options:
+#   --output-test [LOCATION]
+#   --output-code [LOCATION]
+#   --output-results [LOCATION]
+#   --loop
+#   --verification-program [PATH]
+#   --max-attempts [INT]
+#   --budget [FLOAT]
+#   --auto-submit
+# Args:
+#   1: PROMPT_FILE
+#   2: CODE_FILE
+#   3: UNIT_TEST_FILE
+#   4: ERROR_FILE
+_pdd_fix() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output-test=[Where to save the fixed unit test file.]:filename:_files' \
+    '--output-code=[Where to save the fixed code file.]:filename:_files' \
+    '--output-results=[Where to save the fix results.]:filename:_files' \
+    '--loop[Enable iterative fixing process.]' \
+    '--verification-program=[Path to a Python program that verifies code.]:filename:_files' \
+    '--max-attempts=[Maximum fix attempts (default 3)]:int' \
+    '--budget=[Maximum cost allowed for fixes (default 5.0)]:float' \
+    '--auto-submit[Automatically submit example if all tests pass in fix loop.]' \
+    '1:prompt-file:_files' \
+    '2:code-file:_files' \
+    '3:unit-test-file:_files' \
+    '4:error-file:_files' \
+    '*:filename:_files'
+}
+
+# split
+# Usage: pdd [GLOBAL OPTIONS] split [OPTIONS] INPUT_PROMPT INPUT_CODE EXAMPLE_CODE
+# Options:
+#   --output-sub [LOCATION]
+#   --output-modified [LOCATION]
+# Args:
+#   1: INPUT_PROMPT
+#   2: INPUT_CODE
+#   3: EXAMPLE_CODE
+_pdd_split() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output-sub=[Where to save the generated sub-prompt file.]:filename:_files' \
+    '--output-modified=[Where to save the modified prompt file.]:filename:_files' \
+    '1:prompt-file:_files' \
+    '2:code-file:_files' \
+    '3:example-code-file:_files' \
+    '*:filename:_files'
+}
+
+# change
+# Usage: pdd [GLOBAL OPTIONS] change [OPTIONS] CHANGE_PROMPT_FILE INPUT_CODE [INPUT_PROMPT_FILE]
+# Options:
+#   --output [LOCATION]
+#   --csv
+# Args:
+#   1: CHANGE_PROMPT_FILE
+#   2: INPUT_CODE (filename or directory)
+#   3: INPUT_PROMPT_FILE (optional)
+_pdd_change() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Where to save the modified prompt file.]:filename:_files' \
+    '--csv[Use a CSV file for batch changes (columns: prompt_name, change_instructions).]' \
+    '1:change-prompt-file:_files' \
+    '2:input-code:_files' \
+    '3:optional-prompt-file:_files' \
+    '*:filename:_files'
+}
+
+# update
+# Usage: pdd [GLOBAL OPTIONS] update [OPTIONS] INPUT_PROMPT_FILE MODIFIED_CODE_FILE [INPUT_CODE_FILE]
+# Options:
+#   --output [LOCATION]
+#   --git
+# Args:
+#   1: INPUT_PROMPT_FILE
+#   2: MODIFIED_CODE_FILE
+#   3: INPUT_CODE_FILE (optional)
+_pdd_update() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Where to save the updated prompt file.]:filename:_files' \
+    '--git[Use git history to find the original code file.]' \
+    '1:prompt-file:_files' \
+    '2:modified-code-file:_files' \
+    '3:original-code-file:_files' \
+    '*:filename:_files'
+}
+
+# detect
+# Usage: pdd [GLOBAL OPTIONS] detect [OPTIONS] PROMPT_FILES... CHANGE_FILE
+# Options:
+#   --output [LOCATION]
+# Args:
+#   (multiple) PROMPT_FILES
+#   (final) CHANGE_FILE
+_pdd_detect() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Where to save the CSV file with analysis results.]:filename:_files' \
+    '*:prompt-files:_files' \
+    ':change-file:_files'
+}
+
+# conflicts
+# Usage: pdd [GLOBAL OPTIONS] conflicts [OPTIONS] PROMPT1 PROMPT2
+# Options:
+#   --output [LOCATION]
+# Args:
+#   1: PROMPT1
+#   2: PROMPT2
+_pdd_conflicts() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Where to save the conflict analysis CSV file.]:filename:_files' \
+    '1:prompt-file1:_files' \
+    '2:prompt-file2:_files' \
+    '*:filename:_files'
+}
+
+# crash
+# Usage: pdd [GLOBAL OPTIONS] crash [OPTIONS] PROMPT_FILE CODE_FILE PROGRAM_FILE ERROR_FILE
+# Options:
+#   --output [LOCATION]
+#   --output-program [LOCATION]
+#   --loop
+#   --max-attempts [INT]
+#   --budget [FLOAT]
+# Args:
+#   1: PROMPT_FILE
+#   2: CODE_FILE
+#   3: PROGRAM_FILE
+#   4: ERROR_FILE
+_pdd_crash() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Where to save the fixed code file.]:filename:_files' \
+    '--output-program=[Where to save the fixed program file.]:filename:_files' \
+    '--loop[Enable iterative fixing process.]' \
+    '--max-attempts=[Maximum fix attempts.]:int' \
+    '--budget=[Maximum cost allowed for fixes (default 5.0)]:float' \
+    '1:prompt-file:_files' \
+    '2:code-file:_files' \
+    '3:program-file:_files' \
+    '4:error-file:_files' \
+    '*:filename:_files'
+}
+
+# trace
+# Usage: pdd [GLOBAL OPTIONS] trace [OPTIONS] PROMPT_FILE CODE_FILE CODE_LINE
+# Options:
+#   --output [LOCATION]
+# Args:
+#   1: PROMPT_FILE
+#   2: CODE_FILE
+#   3: CODE_LINE
+_pdd_trace() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Where to save the trace analysis results.]:filename:_files' \
+    '1:prompt-file:_files' \
+    '2:code-file:_files' \
+    '3:code-line: ' \
+    '*:filename:_files'
+}
+
+# bug
+# Usage: pdd [GLOBAL OPTIONS] bug [OPTIONS] PROMPT_FILE CODE_FILE PROGRAM_FILE CURRENT_OUTPUT_FILE DESIRED_OUTPUT_FILE
+# Options:
+#   --output [LOCATION]
+#   --language [LANGUAGE]
+# Args:
+#   1: PROMPT_FILE
+#   2: CODE_FILE
+#   3: PROGRAM_FILE
+#   4: CURRENT_OUTPUT_FILE
+#   5: DESIRED_OUTPUT_FILE
+_pdd_bug() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Where to save the generated unit test.]:filename:_files' \
+    '--language=[Programming language for the unit test (default: Python)]:string:_guard' \
+    '1:prompt-file:_files' \
+    '2:code-file:_files' \
+    '3:program-file:_files' \
+    '4:current-output-file:_files' \
+    '5:desired-output-file:_files' \
+    '*:filename:_files'
+}
+
+# auto-deps
+# Usage: pdd [GLOBAL OPTIONS] auto-deps [OPTIONS] PROMPT_FILE DIRECTORY_PATH
+# Options:
+#   --output [LOCATION]
+#   --csv [FILENAME]
+#   --force-scan
+# Args:
+#   1: PROMPT_FILE
+#   2: DIRECTORY_PATH
+_pdd_auto_deps() {
+  _arguments -s \
+    $_pdd_global_opts \
+    '--output=[Where to save the modified prompt file with dependencies inserted.]:filename:_files' \
+    '--csv=[CSV file for dependency info (default: project_dependencies.csv).]:filename:_files' \
+    '--force-scan[Force rescanning of all potential dependency files.]' \
+    '1:prompt-file:_files' \
+    '2:directory:_files -/' \
+    '*:filename:_files'
+}
+
+##
+# Main PDD completion dispatcher
+##
+_pdd() {
+  local context="$curcontext" state line
+  typeset -A opt_args
+
+  # List of known subcommands with descriptions
+  local -a _pdd_subcommands
+  _pdd_subcommands=(
+    'generate:Create runnable code from a prompt file'
+    'example:Create an example file from an existing code file and the prompt'
+    'test:Generate or enhance unit tests for a given code file'
+    'preprocess:Preprocess prompt files and save the results'
+    'fix:Fix errors in code and unit tests'
+    'split:Split large complex prompt files'
+    'change:Modify an input prompt file based on change instructions'
+    'update:Update the original prompt file based on modified code'
+    'detect:Analyze prompt files and a change description to see which need updating'
+    'conflicts:Analyze two prompt files for conflicts'
+    'crash:Fix errors in a code module and its calling program'
+    'trace:Find the prompt file line number associated with a code line'
+    'bug:Generate a unit test based on incorrect vs desired outputs'
+    'auto-deps:Analyze a prompt file and directory for needed dependencies'
+  )
+
+  # If there's no subcommand yet (i.e., user typed only "pdd " or "pdd -<Tab>"), offer global opts or subcommands.
+  if (( CURRENT == 2 )); then
+    _arguments -s \
+      $_pdd_global_opts \
+      '1: :->subcmds' && return 0
+    # Show subcommands if user hasn't typed an option that consumes the argument.
+    _describe -t subcommands 'pdd subcommand' _pdd_subcommands
+    return
+  fi
+
+  # If the user typed a known subcommand, dispatch to that subcommand's completion function.
+  case $words[2] in
+    generate)
+      _pdd_generate
+      ;;
+    example)
+      _pdd_example
+      ;;
+    test)
+      _pdd_test
+      ;;
+    preprocess)
+      _pdd_preprocess
+      ;;
+    fix)
+      _pdd_fix
+      ;;
+    split)
+      _pdd_split
+      ;;
+    change)
+      _pdd_change
+      ;;
+    update)
+      _pdd_update
+      ;;
+    detect)
+      _pdd_detect
+      ;;
+    conflicts)
+      _pdd_conflicts
+      ;;
+    crash)
+      _pdd_crash
+      ;;
+    trace)
+      _pdd_trace
+      ;;
+    bug)
+      _pdd_bug
+      ;;
+    auto-deps)
+      _pdd_auto_deps
+      ;;
+    # If the subcommand is unknown or not typed yet, fall back to showing the list of subcommands.
+    *)
+      _describe -t subcommands 'pdd subcommand' _pdd_subcommands
+      ;;
+  esac
+}
+
+compdef _pdd pdd
+
+# End of pdd_completion.zsh