Bump version

Author: gltanaka

CHANGELOG.md

@@ -1,30 +1,51 @@
+## v0.0.93 (2025-12-27)
+
+### Feat
+
+- enhance prompt functions with language support and output schema
+- add update command to Makefile for prompt updates based on code changes
+- add language parameter to various functions for improved language handling
+- implement .env file key management and improve project root detection
+- enhance cloud configuration and error handling
+
+### Fix
+
+- remove temporary 'NEW PARAMETER' comment
+- include Vertex AI credentials in retry calls for llm_invoke
+
 ## v0.0.92 (2025-12-25)
 
 ### Feat
 
-- add cloud configuration examples and enhance path handling
-- support subdirectory basenames in output path generation
-- implement environment variable checks for cloud execution in code generator
-- enhance error handling for cloud execution in code generator
-- add centralized cloud configuration module for PDD CLI
-- enhance cloud URL configuration and authentication handling
-- enhance backup organization and schema validation
+- **Centralized Cloud Configuration:** Added `pdd/core/cloud.py` module providing `CloudConfig` class for consistent cloud URL configuration and JWT token handling across all cloud-enabled commands. Supports `PDD_CLOUD_URL` for testing against different environments (local emulator, staging, production) and `PDD_JWT_TOKEN` for pre-injected tokens in CI/CD pipelines.
+
+- **Subdirectory Basename Support:** Updated `generate_output_paths`, `sync_main`, and `sync_orchestration` to handle module basenames with subdirectory paths (e.g., `core/cloud`). Directory structure is preserved in output filenames: `core/cloud` with pattern `test_{basename}.py` produces `core/test_cloud.py`.
+
+- **Enhanced Cloud Error Handling:** Cloud code generation now distinguishes between recoverable errors (5xx, timeouts → local fallback) and non-recoverable errors (401 auth, 402 insufficient credits, 403 access denied, 400 validation → immediate failure with clear error message). Added `PDD_CLOUD_ONLY` and `PDD_NO_LOCAL_FALLBACK` env vars to disable local fallback.
+
+- **CI/Headless Mode Detection:** Added automatic TTY detection for CI/non-interactive environments. When `--force` is set and running in headless mode (non-TTY), API key prompts are skipped and cloud authentication failures fail gracefully instead of blocking on user input.
 
 ### Fix
 
-- resolve path resolution mismatch in sync_orchestration
-- mock isatty in test fixture for headless mode compatibility
-- extend --force to skip API key prompts in CI/headless environments
-- add headless mode detection for CI/non-TTY environments
-- add timeout and non-TTY mode for pdd sync in CI
-- rename code.py to buggy.py in agentic test fixtures
-- correct typo in prompt tag from <proompt_content> to <prompt_content>
-- package docs and add fallback path resolution for includes
+- **Path Resolution Mismatch (Issue #177):** Fixed `sync_orchestration` to use absolute paths when calling `code_generator_main` and `context_generator_main`, preventing path resolution mode conflicts between sync (`cwd`) and generate (`config_base`). Also ensures output directories exist before writing.
 
-### Refactor
+- **Package Include Resolution (Issue #175):** `preprocess.py` now falls back to package directory when resolving `<include>` directives, allowing bundled docs like `docs/prompting_guide.md` to be found after pip/wheel installation.
+
+- **Sync Log Subdirectory Handling:** All sync log and fingerprint file operations now use `_safe_basename()` to properly handle subdirectory basenames in filenames.
+
+- **Prompt Tag Typo:** Corrected `<proompt_content>` to `<prompt_content>` in agentic fix prompt.
+
+- **Agentic Test Fixtures:** Renamed `code.py` to `buggy.py` in agentic test fixtures to avoid confusion with module names.
+
+### CI
+
+- **Package Install Test Workflow:** Added `.github/workflows/package-test.yml` to validate that packaged PDD correctly resolves `<include>` directives for bundled docs when installed via pip/wheel (not editable install).
+
+### Tests
 
-- remove local _safe_basename function and update tests for subdirectory handling
-- centralize cloud configuration and authentication handling
+- Added 266 lines of tests in `tests/core/test_cloud.py` covering `CloudConfig` URL resolution, JWT token handling, and environment variable precedence.
+- Added subdirectory basename tests in `test_generate_output_paths.py` and `test_sync_orchestration.py`.
+- Added headless mode and force flag tests across sync and code generator modules.
 
 ## v0.0.91 (2025-12-24)
 

Makefile

@@ -37,6 +37,7 @@ help:
 	@echo "  make public-diff ITEM=path   - Show diff between public clone file and local file (uses same ITEM rules)"
 	@echo "  make sync-public             - Fetch public remote and list commits missing locally"
 	@echo "Fixing & Maintenance:"
+	@echo "  make update [MODULE=name]    - Update prompt based on code changes (uses git)"
 	@echo "  make fix [MODULE=name]       - Fix prompts command"
 	@echo "  make crash MODULE=name       - Fix crashes in code"
 	@echo "  make detect CHANGE_FILE=path  - Detect which prompts need changes based on a description file"
@@ -99,7 +100,7 @@ TEST_OUTPUTS := $(patsubst $(PDD_DIR)/%.py,$(TESTS_DIR)/test_%.py,$(PY_OUTPUTS))
 # All Example files in context directory (recursive)
 EXAMPLE_FILES := $(shell find $(CONTEXT_DIR) -name "*_example.py" 2>/dev/null)
 
-.PHONY: all clean test requirements production coverage staging regression sync-regression all-regression install build analysis fix crash update-extension generate run-examples verify detect change lint publish publish-public publish-public-cap public-ensure public-update public-import public-diff sync-public
+.PHONY: all clean test requirements production coverage staging regression sync-regression all-regression install build analysis fix crash update update-extension generate run-examples verify detect change lint publish publish-public publish-public-cap public-ensure public-update public-import public-diff sync-public
 
 all: $(PY_OUTPUTS) $(MAKEFILE_OUTPUT) $(CSV_OUTPUTS) $(EXAMPLE_OUTPUTS) $(TEST_OUTPUTS)
 
@@ -401,6 +402,29 @@ else
 	done
 endif
 
+# Update prompt based on code changes
+update:
+ifdef MODULE
+	@echo "Updating prompt for module: $(MODULE)"
+	$(eval PY_FILE := $(PDD_DIR)/$(MODULE).py)
+	$(eval PY_PROMPT := $(PROMPTS_DIR)/$(MODULE)_python.prompt)
+
+	@if [ ! -f "$(PY_FILE)" ]; then \
+		echo "Error: Code file $(PY_FILE) not found."; \
+		exit 1; \
+	fi
+	@if [ ! -f "$(PY_PROMPT)" ]; then \
+		echo "Error: Prompt file $(PY_PROMPT) not found."; \
+		exit 1; \
+	fi
+
+	@echo "Updating $(PY_PROMPT) based on changes in $(PY_FILE)"
+	conda run -n pdd --no-capture-output pdd --verbose update --git $(PY_PROMPT) $(PY_FILE)
+else
+	@echo "Running repository-wide prompt update"
+	conda run -n pdd --no-capture-output pdd --verbose update
+endif
+
 # Generate requirements.txt
 requirements:
 	@echo "Generating requirements.txt"

README.md

@@ -1,6 +1,6 @@
 # PDD (Prompt-Driven Development) Command Line Interface
 
-![PDD-CLI Version](https://img.shields.io/badge/pdd--cli-v0.0.92-blue) [![Discord](https://img.shields.io/badge/Discord-join%20chat-7289DA.svg?logo=discord&logoColor=white)](https://discord.gg/Yp4RTh8bG7)
+![PDD-CLI Version](https://img.shields.io/badge/pdd--cli-v0.0.93-blue) [![Discord](https://img.shields.io/badge/Discord-join%20chat-7289DA.svg?logo=discord&logoColor=white)](https://discord.gg/Yp4RTh8bG7)
 
 ## Introduction
 
@@ -285,7 +285,7 @@ export PDD_TEST_OUTPUT_PATH=/path/to/tests/
 
 ## Version
 
-Current version: 0.0.92
+Current version: 0.0.93
 
 To check your installed version, run:
 ```

examples/hello/.pdd/meta/hello_python.json

@@ -1,9 +1,12 @@
 {
-  "pdd_version": "0.0.88",
-  "timestamp": "2025-12-22T08:35:27.733455+00:00",
+  "pdd_version": "0.0.92",
+  "timestamp": "2025-12-27T06:20:47.556501+00:00",
   "command": "test",
   "prompt_hash": "f8df355ee1c6e73a393a00c18232048a83fde694b33c472771246631a3724bf6",
-  "code_hash": "29aa57b99745c5b05294fd6a6d1824c48f5aa98ede79f1749dc095f347c8953c",
-  "example_hash": "81ef141e1fdd1e87c85f288e5be103edba9f404b7bfc7e0320d42c8aa4af3235",
-  "test_hash": "194b2eb564e82c016b45813ee19df84149c3e539becb487e2bc805f2e244ef2f"
+  "code_hash": "3550d60e3f28f2b52aa5e96d6d30d71a39d96034999119e6b03c992d561ebfb8",
+  "example_hash": "0457722ba39ac828b1735059a263f8ec351f702c0e27f7944687bed2a2a0b1b3",
+  "test_hash": "f1d1487a1384af1c7eceaa1eca0d9ed4251e832ce2bf7d8b41be41fbccb5c57e",
+  "test_files": {
+    "test_hello.py": "f1d1487a1384af1c7eceaa1eca0d9ed4251e832ce2bf7d8b41be41fbccb5c57e"
+  }
 }

examples/hello/.pdd/meta/hello_python_run.json

@@ -1,8 +1,11 @@
 {
-  "timestamp": "2025-12-23T07:41:46.034334+00:00",
+  "timestamp": "2025-12-27T06:20:47.161210+00:00",
   "exit_code": 0,
   "tests_passed": 3,
   "tests_failed": 0,
   "coverage": 100.0,
-  "test_hash": "0d66a51dff392f38ad3f13bce1bd9ae5e2dbff20186ecec77f42e8ac00f11eb5"
+  "test_hash": "f1d1487a1384af1c7eceaa1eca0d9ed4251e832ce2bf7d8b41be41fbccb5c57e",
+  "test_files": {
+    "test_hello.py": "f1d1487a1384af1c7eceaa1eca0d9ed4251e832ce2bf7d8b41be41fbccb5c57e"
+  }
 }

examples/hello/C

@@ -1,25 +1,32 @@
 import sys
 import os
 
-# Add the source directory to the system path to allow importing the module.
-# The module is located in the '../src' directory relative to this script.
+# Add the src directory to the system path to allow importing the hello module
+# This ensures the example is portable and can find the module relative to this script's location
 current_dir = os.path.dirname(os.path.abspath(__file__))
 src_path = os.path.join(current_dir, '..', 'src')
 sys.path.append(src_path)
 
-# Import the specific function from the module
 from hello import hello
 
-def main():
+def run_example():
     """
-    Demonstrates the usage of the hello module.
+    Demonstrates the usage of the hello function from the hello module.
+
+    Input Parameters:
+        None
+
+    Output:
+        Prints "hello" to the standard output.
     """
-    print("Calling hello() function:")
+    print("--- Running hello() example ---")
 
     # Call the hello function
-    # Input: None
-    # Output: Prints "hello" to standard output
+    # This function takes no arguments and returns None.
+    # Its primary side effect is printing to the console.
     hello()
 
+    print("--- Example complete ---")
+
 if __name__ == "__main__":
-    main()
+    run_example()

examples/hello/E

@@ -0,0 +1 @@
+write a python function 'hello' that prints "hello"