pdd-cli 0.0.45__py3-none-any.whl → 0.0.90__py3-none-any.whl

pdd/core/utils.py

@@ -0,0 +1,90 @@
+"""
+Helper functions for the PDD CLI.
+"""
+import os
+import sys
+import subprocess
+from pathlib import Path
+from typing import Optional
+import click
+
+from ..install_completion import (
+    get_current_shell,
+    get_shell_rc_path,
+)
+
+def _first_pending_command(ctx: click.Context) -> Optional[str]:
+    """Return the first subcommand scheduled for this invocation."""
+    for arg in ctx.protected_args:
+        if not arg.startswith("-"):
+            return arg
+    return None
+
+
+def _api_env_exists() -> bool:
+    """Check whether the ~/.pdd/api-env file exists."""
+    return (Path.home() / ".pdd" / "api-env").exists()
+
+
+def _completion_installed() -> bool:
+    """Check if the shell RC file already sources the PDD completion script."""
+    shell = get_current_shell()
+    rc_path = get_shell_rc_path(shell) if shell else None
+    if not rc_path:
+        return False
+
+    try:
+        content = Path(rc_path).read_text(encoding="utf-8")
+    except (OSError, UnicodeDecodeError):
+        return False
+
+    return "PDD CLI completion" in content or "pdd_completion" in content
+
+
+def _project_has_local_configuration() -> bool:
+    """Detect project-level env configuration that should suppress reminders."""
+    cwd = Path.cwd()
+
+    env_file = cwd / ".env"
+    if env_file.exists():
+        try:
+            env_content = env_file.read_text(encoding="utf-8")
+        except (OSError, UnicodeDecodeError):
+            env_content = ""
+        if any(token in env_content for token in ("OPENAI_API_KEY=", "GOOGLE_API_KEY=", "ANTHROPIC_API_KEY=")):
+            return True
+
+    project_pdd_dir = cwd / ".pdd"
+    if project_pdd_dir.exists():
+        return True
+
+    return False
+
+
+def _should_show_onboarding_reminder(ctx: click.Context) -> bool:
+    """Determine whether to display the onboarding reminder banner."""
+    suppress = os.getenv("PDD_SUPPRESS_SETUP_REMINDER", "").lower()
+    if suppress in {"1", "true", "yes"}:
+        return False
+
+    first_command = _first_pending_command(ctx)
+    if first_command == "setup":
+        return False
+
+    if _api_env_exists():
+        return False
+
+    if _project_has_local_configuration():
+        return False
+
+    if _completion_installed():
+        return False
+
+    return True
+
+
+def _run_setup_utility() -> None:
+    """Execute the interactive setup utility script."""
+    result = subprocess.run([sys.executable, "-m", "pdd.setup_tool"])
+    if result.returncode not in (0, None):
+        raise RuntimeError(f"Setup utility exited with status {result.returncode}")

pdd/crash_main.py

@@ -2,9 +2,9 @@ import sys
 from typing import Tuple, Optional, Dict, Any
 import click
 from rich import print as rprint
-from . import DEFAULT_STRENGTH, DEFAULT_TIME
 from pathlib import Path
 
+from .config_resolution import resolve_effective_config
 from .construct_paths import construct_paths
 from .fix_code_loop import fix_code_loop
 # Import fix_code_module_errors conditionally or ensure it's always available
@@ -24,7 +24,10 @@ def crash_main(
     output_program: Optional[str] = None,
     loop: bool = False,
     max_attempts: Optional[int] = None,
-    budget: Optional[float] = None
+    budget: Optional[float] = None,
+    agentic_fallback: bool = True,
+    strength: Optional[float] = None,
+    temperature: Optional[float] = None,
 ) -> Tuple[bool, str, str, int, float, str]:
     """
     Main function to fix errors in a code module and its calling program that caused a crash.
@@ -39,6 +42,7 @@ def crash_main(
     :param loop: Enable iterative fixing process.
     :param max_attempts: Maximum number of fix attempts before giving up.
     :param budget: Maximum cost allowed for the fixing process.
+    :param agentic_fallback: Enable agentic fallback if the primary fix mechanism fails.
     :return: A tuple containing:
         - bool: Success status
         - str: The final fixed code module
@@ -54,9 +58,9 @@ def crash_main(
     quiet = ctx.params.get("quiet", ctx.obj.get("quiet", False))
     verbose = ctx.params.get("verbose", ctx.obj.get("verbose", False))
 
-    strength = ctx.obj.get("strength", DEFAULT_STRENGTH)
-    temperature = ctx.obj.get("temperature", 0)
-    time_param = ctx.obj.get("time", DEFAULT_TIME)
+    # Store parameter values for later resolution
+    param_strength = strength
+    param_temperature = temperature
 
     try:
         input_file_paths = {
@@ -77,8 +81,20 @@ def crash_main(
             force=force,
             quiet=quiet,
             command="crash",
-            command_options=command_options
+            command_options=command_options,
+            context_override=ctx.obj.get('context'),
+            confirm_callback=ctx.obj.get('confirm_callback')
         )
+        # Use centralized config resolution with proper priority:
+        # CLI > pddrc > defaults
+        effective_config = resolve_effective_config(
+            ctx,
+            resolved_config,
+            param_overrides={"strength": param_strength, "temperature": param_temperature}
+        )
+        strength = effective_config["strength"]
+        temperature = effective_config["temperature"]
+        time_param = effective_config["time"]
 
         prompt_content = input_strings["prompt_file"]
         code_content = input_strings["code_file"]
@@ -94,7 +110,8 @@ def crash_main(
         if loop:
             success, final_program, final_code, attempts, cost, model = fix_code_loop(
                 code_file, prompt_content, program_file, strength, temperature,
-                max_attempts or 3, budget or 5.0, error_file, verbose, time_param
+                max_attempts if max_attempts is not None else 3, budget or 5.0, error_file, verbose, time_param,
+                prompt_file=prompt_file, agentic_fallback=agentic_fallback
             )
             # Always set final_code/final_program to something non-empty
             if not final_code:
@@ -161,20 +178,36 @@ def crash_main(
                 if code_updated:
                     rprint(f"[bold]Fixed code saved to:[/bold] {output_code_path_str}")
                 else:
-                    rprint(f"[info]Code file '{Path(code_file).name}' was not modified (but output file was written).[/info]")
+                    rprint(f"[bold]Code saved to:[/bold] {output_code_path_str} [dim](not modified)[/dim]")
             if output_program_path_str:
                 if program_updated:
                     rprint(f"[bold]Fixed program saved to:[/bold] {output_program_path_str}")
                 else:
-                    rprint(f"[info]Program file '{Path(program_file).name}' was not modified (but output file was written).[/info]")
+                    rprint(f"[bold]Program saved to:[/bold] {output_program_path_str} [dim](not modified)[/dim]")
+
+            if verbose:
+                rprint("\n[bold]Verbose diagnostics:[/bold]")
+                rprint(f"  Code file: {code_file}")
+                rprint(f"  Program file: {program_file}")
+                rprint(f"  Code updated: {code_updated}")
+                rprint(f"  Program updated: {program_updated}")
+                rprint(f"  Original code length: {len(original_code_content)} chars")
+                rprint(f"  Final code length: {len(final_code)} chars")
+                rprint(f"  Original program length: {len(original_program_content)} chars")
+                rprint(f"  Final program length: {len(final_program)} chars")
 
         return success, final_code, final_program, attempts, cost, model
 
     except FileNotFoundError as e:
         if not quiet:
             rprint(f"[bold red]Error:[/bold red] Input file not found: {e}")
-        sys.exit(1)
+        # Return error result instead of sys.exit(1) to allow orchestrator to handle gracefully
+        return False, "", "", 0, 0.0, f"FileNotFoundError: {e}"
+    except click.Abort:
+        # User cancelled - re-raise to stop the sync loop
+        raise
     except Exception as e:
         if not quiet:
             rprint(f"[bold red]An unexpected error occurred:[/bold red] {str(e)}")
-        sys.exit(1)
+        # Return error result instead of sys.exit(1) to allow orchestrator to handle gracefully
+        return False, "", "", 0, 0.0, f"Error: {e}"

pdd/data/language_format.csv

@@ -1,63 +1,71 @@
-language,comment,extension
-Python,#,.py
-Java,//,.java
-C++,//,.cpp
-JavaScript,//,.js
-HTML,"<!-- -->",.html
-CSS,"/**/",.css
-Ruby,#,.rb
-PHP,//,.php
-Swift,//,.swift
-Go,//,.go
-Rust,//,.rs
-Kotlin,//,.kt
-TypeScript,//,.ts
-TypeScriptReact,//,.tsx
-C#,//,.cs
-SQL,--,.sql
-Shell,#,.sh
-Bash,#,.sh
-Fish,#,.fish
-Zsh,#,.zsh
-PowerShell,#,.ps1
-Perl,#,.pl
-R,#,.R
-MATLAB,%,.m
-Lua,--,.lua
-Haskell,--,.hs
-Scala,//,.scala
-Groovy,//,.groovy
-Dart,//,.dart
-F#,//,.fs
-YAML,#,.yml
-JSON,del,.json
-JSONL,del,.jsonl
-XML,"<!-- -->",.xml
-Makefile,#,
-CSV,del,.csv
-Markdown,del,.md
-LaTeX,%,.tex
-Assembly,;,.asm
-Fortran,!,.f90
-COBOL,*>,.cob
-Lisp,;,.lisp
-Prolog,%,.pl
-Erlang,%,.erl
-Clojure,;,.clj
-Julia,#,.jl
-Elixir,#,.ex
-Pascal,//,.pas
-VBScript,"'",.vbs
-CoffeeScript,#,.coffee
-Objective-C,//,.m
-Scheme,;,.scm
-Tcl,#,.tcl
-D,//,.d
-Ada,--,.ada
-Nim,#,.nim
-OCaml,"(**)",.ml
-LLM,del,.prompt
-prompt,del,.prompt
-TOML,#,.toml
-Log,del,.log
-reStructuredText,del,.rst
+language,comment,extension,run_command,run_test_command
+Python,#,.py,python {file},python -m pytest {file} -v
+Java,//,.java,java {file},
+C++,//,.cpp,,
+JavaScript,//,.js,node {file},
+HTML,"<!-- -->",.html,,
+CSS,"/**/",.css,,
+Ruby,#,.rb,ruby {file},
+PHP,//,.php,php {file},
+Swift,//,.swift,swift {file},swift test
+Go,//,.go,go run {file},go test -v {file}
+Rust,//,.rs,,cargo test
+Kotlin,//,.kt,kotlin {file},
+TypeScript,//,.ts,npx tsx {file},
+TypeScriptReact,//,.tsx,npx tsx {file},
+C#,//,.cs,dotnet run {file},dotnet test
+SQL,--,.sql,,
+Shell,#,.sh,sh {file},
+Bash,#,.sh,bash {file},
+Fish,#,.fish,fish {file},
+Zsh,#,.zsh,zsh {file},
+PowerShell,#,.ps1,pwsh {file},
+Perl,#,.pl,perl {file},
+R,#,.R,Rscript {file},
+MATLAB,%,.m,,
+Lua,--,.lua,lua {file},
+Haskell,--,.hs,runhaskell {file},
+Scala,//,.scala,scala {file},
+Groovy,//,.groovy,groovy {file},
+Dart,//,.dart,dart run {file},
+F#,//,.fs,dotnet fsi {file},
+YAML,#,.yml,,
+YAML,#,.yaml,,
+JSON,del,.json,,
+JSONL,del,.jsonl,,
+XML,"<!-- -->",.xml,,
+Makefile,#,,,
+CSV,del,.csv,,
+Markdown,del,.md,,
+LaTeX,%,.tex,,
+Assembly,;,.asm,,
+Fortran,!,.f90,gfortran -o {file}.out {file} && ./{file}.out,
+COBOL,*>,.cob,,
+Lisp,;,.lisp,sbcl --script {file},
+Prolog,%,.pl,swipl -s {file},
+Erlang,%,.erl,escript {file},
+Clojure,;,.clj,clojure {file},
+Julia,#,.jl,julia {file},
+Elixir,#,.ex,elixir {file},
+Pascal,//,.pas,fpc {file} && ./{file},
+VBScript,"'",.vbs,cscript {file},
+CoffeeScript,#,.coffee,coffee {file},
+Objective-C,//,.m,,
+Scheme,;,.scm,scheme --script {file},
+Tcl,#,.tcl,tclsh {file},
+D,//,.d,rdmd {file},
+Ada,--,.ada,,
+Nim,#,.nim,nim r {file},
+OCaml,"(**)",.ml,ocaml {file},
+LLM,del,.prompt,,
+prompt,del,.prompt,,
+TOML,#,.toml,,
+Log,del,.log,,
+reStructuredText,del,.rst,,
+Text,del,.txt,,
+INI,;,.ini,,
+Verilog,//,.v,,
+Systemverilog,//,.sv,,
+Prisma,///,.prisma,,
+Lean,--,.lean,lean {file},
+Agda,--,.agda,,

pdd/data/llm_model.csv

@@ -1,18 +1,20 @@
-provider,model,input,output,coding_arena_elo,base_url,api_key,max_reasoning_tokens,structured_output,reasoning_type
-OpenAI,gpt-4.1-nano,0.1,0.4,1249,,OPENAI_API_KEY,0,True,none
-xai,xai/grok-3-beta,3.0,15.0,1332,https://api.x.ai/v1,XAI_API_KEY,0,False,none
-Anthropic,claude-3-5-haiku-20241022,.8,4,1261,,ANTHROPIC_API_KEY,0,True,none
-OpenAI,deepseek/deepseek-chat,.27,1.1,1353,https://api.deepseek.com/beta,DEEPSEEK_API_KEY,0,False,none
-Google,vertex_ai/gemini-2.5-flash,0.15,0.6,1330,,VERTEX_CREDENTIALS,0,True,effort
-Google,gemini-2.5-pro,1.25,10.0,1360,,GOOGLE_API_KEY,0,True,none
-Anthropic,claude-sonnet-4-20250514,3.0,15.0,1340,,ANTHROPIC_API_KEY,64000,True,budget
-Google,vertex_ai/gemini-2.5-pro,1.25,10.0,1361,,VERTEX_CREDENTIALS,0,True,none
-OpenAI,o4-mini,1.1,4.4,1333,,OPENAI_API_KEY,0,True,effort
-OpenAI,o3,10.0,40.0,1389,,OPENAI_API_KEY,0,True,effort
-OpenAI,gpt-4.1,2.0,8.0,1335,,OPENAI_API_KEY,0,True,none
-OpenAI,deepseek/deepseek-reasoner,0.55,2.19,1337,https://api.deepseek.com/beta,DEEPSEEK_API_KEY,0,False,none
-Fireworks,fireworks_ai/accounts/fireworks/models/deepseek-r1,3.0,8.0,1338,,FIREWORKS_API_KEY,0,False,none
-OpenAI,chatgpt-4o-latest,5,15,1369,,OPENAI_API_KEY,0,False,none
-Anthropic,bedrock/us.anthropic.claude-3-7-sonnet-20250219-v1:0,3.0,15.0,1339,,,64000,True,budget
-OpenAI,azure/o4-mini,1.1,4.4,1334,,OPENAI_API_KEY,0,True,effort
-OpenAI,openai/mlx-community/Qwen3-30B-A3B-4bit,0,0,1293,http://localhost:8080,,0,False,none
+provider,model,input,output,coding_arena_elo,base_url,api_key,max_reasoning_tokens,structured_output,reasoning_type,location
+OpenAI,gpt-5-nano,0.05,0.4,1249,,OPENAI_API_KEY,0,True,none,
+Google,vertex_ai/gemini-3-flash-preview,0.5,3.0,1430,,VERTEX_CREDENTIALS,0,True,effort,
+Google,gemini/gemini-3-pro-preview,1.25,10.0,1487,,GEMINI_API_KEY,0,True,effort,
+Google,vertex_ai/claude-sonnet-4-5,3.0,15.0,1370,,VERTEX_CREDENTIALS,128000,True,budget,
+Google,vertex_ai/gemini-3-pro-preview,1.25,10.0,1487,,VERTEX_CREDENTIALS,0,True,effort,
+OpenAI,gpt-5.1-codex-mini,0.25,2.0,1325,,OPENAI_API_KEY,0,True,effort,
+OpenAI,gpt-5.2,1.75,14.0,1486,,OPENAI_API_KEY,0,True,effort,
+OpenAI,gpt-5.1-codex,1.25,10.0,1478,,OPENAI_API_KEY,0,True,effort,
+OpenAI,gpt-5.1-codex-max,1.25,10.0,1480,,OPENAI_API_KEY,0,True,effort,
+Google,vertex_ai/deepseek-ai/deepseek-v3.2-maas,0.28,0.42,1450,,VERTEX_CREDENTIALS,0,False,effort,global
+Fireworks,fireworks_ai/accounts/fireworks/models/qwen3-coder-480b-a35b-instruct,0.45,1.80,1363,,FIREWORKS_API_KEY,0,False,none,
+Google,vertex_ai/claude-opus-4-5,5.0,25.0,1465,,VERTEX_CREDENTIALS,128000,True,budget,
+OpenAI,openai/mlx-community/Qwen3-30B-A3B-4bit,0,0,1040,http://localhost:8080,,0,False,none,
+lm_studio,lm_studio/openai-gpt-oss-120b-mlx-6,0.0001,0,1082,http://localhost:1234/v1,,0,True,effort,
+Fireworks,fireworks_ai/accounts/fireworks/models/glm-4p6,0.55,2.19,1442,,FIREWORKS_API_KEY,0,False,none,
+OpenAI,groq/moonshotai/kimi-k2-instruct-0905,1.0,3.0,1330,,GROQ_API_KEY,0,True,none,
+Anthropic,anthropic/claude-sonnet-4-5-20250929,3.0,15.0,1370,,ANTHROPIC_API_KEY,128000,True,budget,
+Anthropic,anthropic/claude-opus-4-5-20251101,5.0,25.0,1474,,ANTHROPIC_API_KEY,128000,True,budget,
+Anthropic,anthropic/claude-haiku-4-5-20251001,1.0,5.0,1270,,ANTHROPIC_API_KEY,128000,True,budget,

pdd/detect_change_main.py

@@ -6,7 +6,7 @@ from rich import print as rprint
 
 from .construct_paths import construct_paths
 from .detect_change import detect_change
-from . import DEFAULT_TIME
+from . import DEFAULT_TIME, DEFAULT_STRENGTH
 
 def detect_change_main(
     ctx: click.Context,
@@ -44,7 +44,8 @@ def detect_change_main(
             force=ctx.obj.get('force', False),
             quiet=ctx.obj.get('quiet', False),
             command="detect",
-            command_options=command_options
+            command_options=command_options,
+            context_override=ctx.obj.get('context')
         )
 
         # Get change description content
@@ -54,7 +55,7 @@ def detect_change_main(
         prompt_contents = [input_strings[f"prompt_file_{i}"] for i in range(len(prompt_files))]
 
         # Get model parameters from context
-        strength = ctx.obj.get('strength', 0.9)
+        strength = ctx.obj.get('strength', DEFAULT_STRENGTH)
         temperature = ctx.obj.get('temperature', 0)
         time_budget = ctx.obj.get('time', DEFAULT_TIME)
 
@@ -100,4 +101,4 @@ def detect_change_main(
     except Exception as e:
         if not ctx.obj.get('quiet', False):
             rprint(f"[bold red]Error:[/bold red] {str(e)}")
-        sys.exit(1)
+        sys.exit(1)