pdd-cli 0.0.243__tar.gz → 0.0.244__tar.gz

{pdd_cli-0.0.243 → pdd_cli-0.0.244}/.gitignore

@@ -297,3 +297,4 @@ fake_test_output.py
 github_token
 diff_base.txt
 modules.txt
+.loop/

pdd_cli-0.0.244/.pdd/meta/agentic_e2e_fix_orchestrator_python.json

@@ -0,0 +1,16 @@
+{
+  "pdd_version": "0.0.239",
+  "timestamp": "2026-05-18T17:51:01.000000+00:00",
+  "command": "test",
+  "prompt_hash": "adf10da24b68c65331eb614832ff3425e972dd2ae5e60eda4244f4b2483eb822",
+  "code_hash": "761a06fb3f05a5fc0666ba27e0a5eda1f8fd59b5040ee37d9892c607d97d70d1",
+  "example_hash": "3de20bfd0d4f8b22aabf1738f905d6bfa8873a7537be20eece44353b02c23c0a",
+  "test_hash": "4032f1210063a34c392d0fcb1f66438f39a9eda722f609fcf6e4b8f6b8605aa9",
+  "test_files": {
+    "test_agentic_e2e_fix_orchestrator.py": "4032f1210063a34c392d0fcb1f66438f39a9eda722f609fcf6e4b8f6b8605aa9"
+  },
+  "include_deps": {
+    "context/ci_validation_example.py": "06b910b216f68af58862e76712ccf82bae1bdf87f3fa95b043408fb079f45ce0",
+    "context/python_preamble.prompt": "0388ed131bf986f8752e1bc4c81e4da0460cfe2908ec8c60b1314edbab768254"
+  }
+}

pdd_cli-0.0.244/.pdd/meta/agentic_e2e_fix_orchestrator_python_run.json

@@ -0,0 +1,11 @@
+{
+  "timestamp": "2026-05-18T17:51:01+00:00",
+  "exit_code": 0,
+  "tests_passed": 354,
+  "tests_failed": 0,
+  "coverage": 90.0,
+  "test_hash": "4032f1210063a34c392d0fcb1f66438f39a9eda722f609fcf6e4b8f6b8605aa9",
+  "test_files": {
+    "test_agentic_e2e_fix_orchestrator.py": "4032f1210063a34c392d0fcb1f66438f39a9eda722f609fcf6e4b8f6b8605aa9"
+  }
+}

pdd_cli-0.0.244/.pdd/meta/agentic_update_python.json

@@ -0,0 +1,20 @@
+{
+  "pdd_version": "0.0.233",
+  "timestamp": "2026-05-18T18:31:38.435880+00:00",
+  "command": "fix",
+  "prompt_hash": "13f0da74b87e3762232a46cced41431c1e272b74377bf8f5a707599ce7e555c5",
+  "code_hash": "781941ac33605196b6f559db9d6964115f29b9a821b040eb2e3e185527c3cb00",
+  "example_hash": "dafed5c5980cce43f16f6828ef45f76e3fdd4ee8a41d21e53cea846b2b6dca33",
+  "test_hash": "45d00c80b59d0037dbb148b706fe758a789fa9a5fce1129a675cee1b4dfc99bd",
+  "test_files": {
+    "test_agentic_update.py": "45d00c80b59d0037dbb148b706fe758a789fa9a5fce1129a675cee1b4dfc99bd"
+  },
+  "include_deps": {
+    "context/agentic_common_example.py": "113b5829cae3a9e38c362b74d5115ba09cab06c7be5831527d9829f97f7b3b7d",
+    "context/load_prompt_template_example.py": "a1cd6619182c6c951f5856dda4070e202875a5884bbfab9cc191d24de2f4951f",
+    "context/python_preamble.prompt": "0388ed131bf986f8752e1bc4c81e4da0460cfe2908ec8c60b1314edbab768254",
+    "pdd/agentic_common.py": "501dbc79b1ceef0e69ca4e7266a366660e134c20b47d671c8a9460e23c13dd8b",
+    "pdd/sync_order.py": "48f8afb825b97d406c850e0d2feb02092ee8f2a345d7767ef0e09bb68b0c71bb",
+    "prompts/agentic_update_LLM.prompt": "0fe3ff3c55d39cd68d3f4d1105e156a608c8668a27c3d81efea5289b2430ba17"
+  }
+}

pdd_cli-0.0.244/.pdd/meta/update_main_python.json

@@ -0,0 +1,28 @@
+{
+  "pdd_version": "0.0.233",
+  "timestamp": "2026-05-18T20:41:18.604230+00:00",
+  "command": "fix",
+  "prompt_hash": "41b905a730ae827bacf21ff1e7b90c6c0e8ca7434b00e2ad20cdeaf55b521ef7",
+  "code_hash": "fd07ab8da4af31865b8739ab5e3430db2ef98e00db1b986daa40807f824a8a1b",
+  "example_hash": "b318834c648f25e6141d81f3ecac1d9da592a6bb4740500983f2b07b8a10d902",
+  "test_hash": "41a5171b2dc10ff3de4655db5c39834bea7f176c1dbc0b82713633b5a52b00bc",
+  "test_files": {
+    "test_update_main.py": "41a5171b2dc10ff3de4655db5c39834bea7f176c1dbc0b82713633b5a52b00bc"
+  },
+  "include_deps": {
+    "context/agentic_common_example.py": "113b5829cae3a9e38c362b74d5115ba09cab06c7be5831527d9829f97f7b3b7d",
+    "context/agentic_update_example.py": "dafed5c5980cce43f16f6828ef45f76e3fdd4ee8a41d21e53cea846b2b6dca33",
+    "context/api_key_scanner_example.py": "4b9f880a30445f25edffc394857ae0c218097726c41ab996a03fcbc4350b5482",
+    "context/architecture_sync_example.py": "3dbf29b2f53c4ad341c5722e2778ce1c3ffde318e1b2c0161c343e28505c32fa",
+    "context/auto_include_example.py": "0c278ed716298149777bc7082827eb8aa6d80dac264c66b6cded6871232f2df7",
+    "context/construct_paths_example.py": "9fb88745a2a0e2834f9da30c2128a122fef4d5a74212ceacc5f9c3d9ddb9a8ca",
+    "context/ctx_obj_params.prompt": "829e2ab327e37b75afcd0dcf3893dcaec9012a89a1f6e5198ec7cfc0395d2782",
+    "context/git_update_example.py": "811304cee2cb890879ee68a816aed49dff2e7b50cfdca3125e16e0ae99819574",
+    "context/metadata_sync_example.py": "704453b3386724eef225b61c48f2fe922e1a973ac211c494e1d955dd44bcca11",
+    "context/operation_log_example.py": "2660def7012d9b79bad3db33cf399ac603cc1c35dff0b064cbdd2638a013de1d",
+    "context/python_preamble.prompt": "0388ed131bf986f8752e1bc4c81e4da0460cfe2908ec8c60b1314edbab768254",
+    "context/sync_determine_operation_example.py": "94a333b37d9875bcc9b39e22d4d00de1b196ad2f7e0fa997e6f638e153dbdfad",
+    "context/update_prompt_example.py": "56b9d8c7aa823c2996a3dc5741a47844e223bfd088366d74e48b6a099b5a11c4",
+    "pdd/validate_prompt_includes.py": "fa97b72a58534e255768634f928f4cfdd2130a7a4d8b296da3eefdf77d47855b"
+  }
+}

{pdd_cli-0.0.243/pdd_cli.egg-info → pdd_cli-0.0.244}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdd-cli
-Version: 0.0.243
+Version: 0.0.244
 Summary: PDD (Prompt-Driven Development) Command Line Interface
 Author: Greg Tanaka
 Author-email: glt@alumni.caltech.edu

{pdd_cli-0.0.243 → pdd_cli-0.0.244}/README.md

@@ -1704,6 +1704,7 @@ Where used:
 - Dependency references: Examples serve as lightweight (token efficient) interface references for other prompts and can be included as dependencies of a generate target.
 - Sanity checks: The example program is typically used as the runnable program for `crash` and `verify`, providing a quick end-to-end sanity check that the generated code runs and behaves as intended.
 - Auto-deps integration: The `auto-deps` command can scan example files (e.g., `examples/**/*.py`) and insert relevant references into prompts. Based on each example’s content (imports, API usage, filenames), it identifies useful development units to include as dependencies.
+- Metadata finalization: A successful `pdd example` updates the affected module's fingerprint and clears its stale `.pdd/meta/<basename>_<language>_run.json` runtime-verification report, so a regenerated example never leaves runtime state describing the pre-mutation output.
 
 **When to use**: Choose this command when creating reusable references that other prompts can efficiently import. This produces token-efficient examples that are easier to reuse across multiple prompts compared to including full implementations.
 
@@ -2410,7 +2411,7 @@ Options:
 - `--git`: Use git history to find the original code file, eliminating the need for the `INPUT_CODE_FILE` argument.
 - `--extensions EXTENSIONS`: In repository-wide mode, filter the update to only include files with the specified comma-separated extensions (e.g., `py,js,ts`).
 - `--simple`: Use the legacy 2-stage LLM update process instead of the default agentic mode. Useful when agentic CLIs are not available or for faster updates.
-- `--sync-metadata`: After the prompt update, run the shared metadata-sync orchestrator so prompt PDD tags, `architecture.json` entries, run reports, and fingerprint state are reconciled in one step. Works in single-file, regeneration, and repo modes. **Fingerprint note:** default single-file/regeneration `pdd update <code>` already finalizes the per-target fingerprint (`.pdd/meta/<basename>_<language>.json`) on success, and logs a skip reason when finalization is intentionally bypassed; `--sync-metadata` does not gate that behavior. Without this flag, the broader prompt-tag/architecture/run-report orchestrator is not run and those layers must be reconciled with separate commands. **Scope note:** the `tags` stage currently *preserves* existing PDD tags and only *seeds* tags from the matching `architecture.json` entry when a prompt has none — LLM-first **refresh** of stale-but-present tags is tracked at issue [#870](https://github.com/promptdriven/pdd/issues/870) and is not invoked by this orchestrator. When a prompt has zero PDD tags AND no architecture entry, the `tags` stage reports `skipped` (never `ok`) so operators see honest status. On any stage `failed`, `pdd update --sync-metadata` exits non-zero so CI auto-heal does not treat a half-finalized update as healed.
+- `--sync-metadata`: After the prompt update, run the shared metadata-sync orchestrator so prompt PDD tags, `architecture.json` entries, run reports, and fingerprint state are reconciled in one step. Works in single-file, regeneration, and repo modes. **Fingerprint note:** default single-file/regeneration `pdd update <code>` already finalizes the per-target fingerprint (`.pdd/meta/<basename>_<language>.json`) on success, and logs a skip reason when finalization is intentionally bypassed; `--sync-metadata` does not gate that behavior. Default repo-mode `pdd update --repo` likewise finalizes per-pair fingerprints and, before writing each fingerprint, clears the affected module's stale `.pdd/meta/<basename>_<language>_run.json` runtime-verification report so metadata and runtime state stay in lock-step (clear failures are surfaced as non-fatal warnings, and if the stale `_run.json` still exists after the clear attempt the fingerprint write is skipped so a fresh fingerprint cannot coexist with stale runtime state — closing issue [#1057](https://github.com/promptdriven/pdd/issues/1057)). Without this flag, the broader prompt-tag/architecture/run-report orchestrator is not run and those layers must be reconciled with separate commands. **Scope note:** the `tags` stage currently *preserves* existing PDD tags and only *seeds* tags from the matching `architecture.json` entry when a prompt has none — LLM-first **refresh** of stale-but-present tags is tracked at issue [#870](https://github.com/promptdriven/pdd/issues/870) and is not invoked by this orchestrator. When a prompt has zero PDD tags AND no architecture entry, the `tags` stage reports `skipped` (never `ok`) so operators see honest status. On any stage `failed`, `pdd update --sync-metadata` exits non-zero so CI auto-heal does not treat a half-finalized update as healed.
 
 Example (Metadata Sync):
 ```bash

{pdd_cli-0.0.243 → pdd_cli-0.0.244}/architecture.json

@@ -449,7 +449,7 @@
     }
   },
   {
-    "reason": "Daily Rising Stars resurface check \u2014 Cloud Scheduler function scanning contribution thresholds to identify high-potential nurtured candidates and detect churned candidates",
+    "reason": "Daily Rising Stars resurface check — Cloud Scheduler function scanning contribution thresholds to identify high-potential nurtured candidates and detect churned candidates",
     "description": "Cloud Function entry point recruiting_resurface_check triggered by Cloud Scheduler (daily). Scans all recruiting/candidates with crmFunnelStage in ('nurture', 'contributing'). For each candidate, evaluates four resurface criteria from config thresholds: (1) merged_prs >= threshold (e.g., 3 merged PRs), (2) hackathon_score >= threshold (e.g., top 25%), (3) platform_usage_days >= threshold (power user), (4) marketplace_examples >= threshold (marketplace contributor). Candidates meeting any criterion are marked resurfaced=true with appropriate ResurfaceReason, CrmFunnelStage updated to 'resurfaced', and CRM GitHub Issue label updated from recruiting-nurture to recruiting-resurfaced. Also detects churned candidates: if last_activity_at > 60 days ago and no contributions, sets crmFunnelStage='churned' and updates CRM label to recruiting-churned. Verifies merged PR counts via GitHub API to prevent gaming. Logs all resurface and churn transitions. Returns summary counts.",
     "dependencies": [],
     "priority": 18,
@@ -1514,7 +1514,8 @@
     "reason": "Coordinates agentic prompt updates through Claude, Gemini, Codex, or OpenCode CLIs.",
     "description": "Coordinates repository-aware prompt update runs through external agentic CLIs and reports prompt/test changes.",
     "dependencies": [
-      "agentic_update_LLM.prompt"
+      "agentic_update_LLM.prompt",
+      "sync_order_python.prompt"
     ],
     "priority": 43,
     "filename": "agentic_update_python.prompt",
@@ -1944,7 +1945,7 @@
   },
   {
     "reason": "CLI entry point for the code generator command.",
-    "description": "Command-line interface for code generator. Parses arguments, orchestrates the workflow, and formats output. Raises structured ArchitectureConformanceError failures with output/expected/found/missing fields plus failed-attempt total_cost/model_name (constructor accepts an optional repair_directive override for the <pdd-interface> signature check whose source of truth is the prompt, not architecture.json), and injects a non-empty PDD_REPAIR_DIRECTIVE into the generation prompt inside an <architecture_repair_directive> block so sync retry attempts receive concrete missing-export instructions. Architecture conformance now also enforces the prompt's <pdd-interface> signature across module/cli/command interface types in three categories: (1) missing function/method \u2014 declared callables (including dotted methods like ContentSelector.select) absent from the generated code surface as bare names in missing_symbols; (2) missing parameter \u2014 declared parameter names absent from a matching function/method signature surface as dotted funcname.paramname entries; (3) signature drift \u2014 annotation drift is conservative (raises only when both sides specify and differ) while default drift is strict (raises when the prompt declares a default and the generated code drops or changes it, since callers omitting an optional kwarg would otherwise break with TypeError). Each category emits a distinct error sentence so the agentic_sync_runner repair loop can build a targeted directive (add missing function/method, add missing parameter, or update parameter to match the prompt's annotation/default).",
+    "description": "Command-line interface for code generator. Parses arguments, orchestrates the workflow, and formats output. Raises structured ArchitectureConformanceError failures with output/expected/found/missing fields plus failed-attempt total_cost/model_name (constructor accepts an optional repair_directive override for the <pdd-interface> signature check whose source of truth is the prompt, not architecture.json), and injects a non-empty PDD_REPAIR_DIRECTIVE into the generation prompt inside an <architecture_repair_directive> block so sync retry attempts receive concrete missing-export instructions. Architecture conformance now also enforces the prompt's <pdd-interface> signature across module/cli/command interface types in three categories: (1) missing function/method — declared callables (including dotted methods like ContentSelector.select) absent from the generated code surface as bare names in missing_symbols; (2) missing parameter — declared parameter names absent from a matching function/method signature surface as dotted funcname.paramname entries; (3) signature drift — annotation drift is conservative (raises only when both sides specify and differ) while default drift is strict (raises when the prompt declares a default and the generated code drops or changes it, since callers omitting an optional kwarg would otherwise break with TypeError). Each category emits a distinct error sentence so the agentic_sync_runner repair loop can build a targeted directive (add missing function/method, add missing parameter, or update parameter to match the prompt's annotation/default).",
     "dependencies": [
       "auto_include_python.prompt",
       "agentic_langtest_python.prompt",
@@ -5421,6 +5422,12 @@
     "interface": {
       "type": "module",
       "module": {
+        "constants": [
+          {
+            "name": "BUNDLED_SAMPLE_TOPLEVEL_DIRS",
+            "type": "FrozenSet[str]"
+          }
+        ],
         "functions": [
           {
             "name": "extract_modules",
@@ -5454,7 +5461,7 @@
           },
           {
             "name": "find_architecture_for_project",
-            "signature": "(project_root: Path)",
+            "signature": "(project_root: Path, *, skip_bundled_sample_arch: bool = True)",
             "returns": "List[Path]"
           },
           {
@@ -5469,7 +5476,7 @@
           },
           {
             "name": "load_combined_architecture_data",
-            "signature": "(project_root: Path)",
+            "signature": "(project_root: Path, *, skip_bundled_sample_arch: bool = True)",
             "returns": "Tuple[Optional[List[Dict[str, Any]]], Path]"
           },
           {
@@ -5785,7 +5792,7 @@
   },
   {
     "reason": "Orchestrates the 13-step agentic change workflow for implementing GitHub issues.",
-    "description": "Orchestrates the 13-step agentic change workflow. Includes Step 8.5 (pre-flight drift heal) \u2014 detects prompts whose code has drifted and runs `pdd update` per module inside the worktree before Step 9 rewrites the prompts. Includes Step 10.5 (doc-sync contract verifier) \u2014 before Step 10, calls pdd.sync_order.discover_associated_documents to populate the LLM's associated_documents context, using the authoritative changed-file set so Step 9's worktree fallback path cannot bypass discovery when FILES_* markers are missing; after Step 10, enforces that every discovered doc appears in exactly one of ASSOCIATED_DOCS_MODIFIED / ASSOCIATED_DOCS_CONFLICTS / ASSOCIATED_DOCS_UNCHANGED. Silent drops and bucket overlaps are appended as ORCHESTRATOR_POSTCHECK_WARNINGS and routed to Step 11 via step10_output; PDD_STRICT_DOC_SYNC=1 turns violations into hard workflow aborts (issue #739).",
+    "description": "Orchestrates the 13-step agentic change workflow. Includes Step 8.5 (pre-flight drift heal) — detects prompts whose code has drifted and runs `pdd update` per module inside the worktree before Step 9 rewrites the prompts. Includes Step 10.5 (doc-sync contract verifier) — before Step 10, calls pdd.sync_order.discover_associated_documents to populate the LLM's associated_documents context, using the authoritative changed-file set so Step 9's worktree fallback path cannot bypass discovery when FILES_* markers are missing; after Step 10, enforces that every discovered doc appears in exactly one of ASSOCIATED_DOCS_MODIFIED / ASSOCIATED_DOCS_CONFLICTS / ASSOCIATED_DOCS_UNCHANGED. Silent drops and bucket overlaps are appended as ORCHESTRATOR_POSTCHECK_WARNINGS and routed to Step 11 via step10_output; PDD_STRICT_DOC_SYNC=1 turns violations into hard workflow aborts (issue #739).",
     "dependencies": [
       "architecture_sync_python.prompt",
       "agentic_common_python.prompt"
@@ -6183,7 +6190,7 @@
         "functions": [
           {
             "name": "run_agentic_e2e_fix_orchestrator",
-            "signature": "(issue_url, issue_content, repo_owner, repo_name, issue_number, issue_author, issue_title, *, cwd, timeout_adder, max_cycles, resume, verbose, quiet, use_github_state, protect_tests, ci_retries=3, skip_ci=False, skip_cleanup=False, reasoning_time=None)",
+            "signature": "(issue_url, issue_content, repo_owner, repo_name, issue_number, issue_author, issue_title, *, cwd, timeout_adder=0.0, max_cycles=5, resume=True, verbose=False, quiet=False, use_github_state=True, protect_tests=False, ci_retries=3, skip_ci=False, skip_cleanup=False, reasoning_time=None)",
             "returns": "Tuple[bool, str, float, str, List[str]]"
           },
           {
@@ -6890,12 +6897,12 @@
           },
           {
             "name": "sync_all_prompts_to_architecture",
-            "signature": "(prompts_dir: Path, architecture_path: Path, dry_run: bool) -> Dict[str, Any]",
-            "returns": "Dict with keys: success, updated_count, skipped_count, results, errors"
+            "signature": "(prompts_dir: Path = PROMPTS_DIR, architecture_path: Path = ARCHITECTURE_JSON_PATH, dry_run: bool = False, only_files: Optional[set] = None) -> Dict[str, Any]",
+            "returns": "Dict with keys: success, updated_count, skipped_count, results, errors, registered"
           },
           {
             "name": "validate_dependencies",
-            "signature": "(dependencies: List[str], prompts_dir: Path) -> Dict[str, Any]",
+            "signature": "(dependencies: List[str], prompts_dir: Path = PROMPTS_DIR) -> Dict[str, Any]",
             "returns": "Dict with keys: valid, missing, duplicates"
           },
           {
@@ -6905,7 +6912,7 @@
           },
           {
             "name": "get_architecture_entry_for_prompt",
-            "signature": "(prompt_filename: str, architecture_path: Path) -> Optional[Dict[str, Any]]",
+            "signature": "(prompt_filename: str, architecture_path: Path = ARCHITECTURE_JSON_PATH) -> Optional[Dict[str, Any]]",
             "returns": "Architecture entry dict or None"
           },
           {
@@ -6917,6 +6924,16 @@
             "name": "generate_tags_from_architecture",
             "signature": "(arch_entry: Dict[str, Any]) -> str",
             "returns": "XML tags string ready to prepend to prompt"
+          },
+          {
+            "name": "normalize_architecture_filenames",
+            "signature": "(arch_data: List[Dict[str, Any]]) -> None",
+            "returns": "None (mutates arch_data in place)"
+          },
+          {
+            "name": "register_untracked_prompts",
+            "signature": "(prompts_dir: Path = PROMPTS_DIR, architecture_path: Path = ARCHITECTURE_JSON_PATH, dry_run: bool = False, only_files: Optional[set] = None) -> Dict[str, Any]",
+            "returns": "Dict with keys: registered, skipped, errors"
           }
         ]
       }
@@ -7249,7 +7266,7 @@
   },
   {
     "reason": "Global and GitHub issue-driven module identification plus parallel sync orchestration.",
-    "description": "Entry point for no-argument global sync and agentic issue sync. Global sync scans architecture.json for stale/missing modules and dispatches AsyncSyncRunner in dependency order; issue sync parses a GitHub issue URL, identifies modules, validates dependencies, and dispatches AsyncSyncRunner \u2014 or DurableSyncRunner when invoked with durable=True. Issue sync uses build_dep_graph_from_architecture_data against in-memory combined architecture so nested-architecture edges are preserved (Phase 0 of #1328).",
+    "description": "Entry point for no-argument global sync and agentic issue sync. Global sync scans architecture.json for stale/missing modules and dispatches AsyncSyncRunner in dependency order; issue sync parses a GitHub issue URL, identifies modules, validates dependencies, and dispatches AsyncSyncRunner — or DurableSyncRunner when invoked with durable=True. Issue sync uses build_dep_graph_from_architecture_data against in-memory combined architecture so nested-architecture edges are preserved (Phase 0 of #1328).",
     "dependencies": [
       "architecture_sync_python.prompt",
       "auto_deps_main_python.prompt",
@@ -7411,7 +7428,7 @@
     }
   },
   {
-    "reason": "Entry point for the agentic checkup workflow \u2014 fetches GitHub issue, loads project context, and dispatches to the checkup orchestrator or PR review-loop.",
+    "reason": "Entry point for the agentic checkup workflow — fetches GitHub issue, loads project context, and dispatches to the checkup orchestrator or PR review-loop.",
     "description": "Accepts a GitHub issue URL, fetches issue content and comments, loads architecture.json and .pddrc, then invokes either the multi-step checkup orchestrator or the PR-mode primary-reviewer/fixer review loop. PR review-loop context is bounded and includes PR body, changed files, comments, and submitted reviews.",
     "dependencies": [
       "agentic_common_python.prompt",
@@ -7484,7 +7501,8 @@
       "agentic_common_python.prompt",
       "agentic_change_python.prompt",
       "agentic_checkup_orchestrator_python.prompt",
-      "agentic_e2e_fix_orchestrator_python.prompt"
+      "agentic_e2e_fix_orchestrator_python.prompt",
+      "architecture_registry_python.prompt"
     ],
     "priority": 217.5,
     "filename": "checkup_review_loop_python.prompt",
@@ -7577,7 +7595,7 @@
     }
   },
   {
-    "reason": "Multi-step orchestrator for pdd checkup \u2014 8 steps with iterative fix-verify loop and worktree isolation.",
+    "reason": "Multi-step orchestrator for pdd checkup — 8 steps with iterative fix-verify loop and worktree isolation.",
     "description": "Orchestrates the 8-step agentic checkup workflow: discover, deps, build, interfaces, test, fix (6.1/6.2/6.3), verify, create PR. Steps 3-7 run in an iterative while loop (max 3 iterations) with exit on 'All Issues Fixed'. Supports resume via workflow state persistence, git worktree isolation, and --no-fix mode.",
     "dependencies": [],
     "priority": 218,
@@ -7634,7 +7652,7 @@
   },
   {
     "reason": "Agentic instruction for assigning logical graph positions to modules in an\narchitecture file. The agent reads the file and an optional PRD/README, reasons about the\nlogical structure of the system, groups modules into functional swimlanes, and writes the\nupdated file in-place so pdd connect shows a graph that makes the architecture easy to\nunderstand at a glance.",
-    "description": "Takes {project_root} and {architecture_path} as inputs. Agent reads the architecture file and any PRD/README. Reasons about functional groupings, pipeline stages, and dependency relationships. Places modules in swimlane columns (one per major functional area, shared/hub modules in center). Dependency depth drives y-axis (depth \u00d7 500px). Writes updated file in-place with position: {x, y} on every module. Outputs a one-line summary.",
+    "description": "Takes {project_root} and {architecture_path} as inputs. Agent reads the architecture file and any PRD/README. Reasons about functional groupings, pipeline stages, and dependency relationships. Places modules in swimlane columns (one per major functional area, shared/hub modules in center). Dependency depth drives y-axis (depth × 500px). Writes updated file in-place with position: {x, y} on every module. Outputs a one-line summary.",
     "dependencies": [],
     "priority": 219,
     "filename": "arrange_graph_layout_LLM.prompt",
@@ -8791,4 +8809,4 @@
       "y": 800
     }
   }
-]
+]

{pdd_cli-0.0.243 → pdd_cli-0.0.244}/context/operation_log_example.py

@@ -97,17 +97,6 @@ def demonstrate_state_management():
         "test": Path("tests/test_calculator.py"),
     }
 
-    # Save fingerprint after successful operation
-    save_fingerprint(
-        basename=basename,
-        language=language,
-        operation="generate",
-        paths=paths,
-        cost=0.192,
-        model="gemini/gemini-3-pro-preview",
-    )
-    print("Saved fingerprint")
-
     # Save run report after test execution
     run_report = {
         "tests_passed": 10,
@@ -117,9 +106,35 @@ def demonstrate_state_management():
     save_run_report(basename, language, run_report)
     print("Saved run report")
 
-    # Clear stale run report before regeneration
-    clear_run_report(basename, language)
-    print("Cleared run report")
+    # After a successful regeneration that mutates code/tests/etc., invalidate
+    # the stale runtime-verification report BEFORE writing the fresh
+    # fingerprint. Required ordering (issue #1057): clear_run_report() then
+    # save_fingerprint(). If clear_run_report fails or the stale _run.json
+    # still exists afterward, skip save_fingerprint() so a fresh fingerprint
+    # never coexists with stale runtime state.
+    from pdd.operation_log import get_run_report_path
+
+    try:
+        clear_run_report(basename, language)
+        print("Cleared run report")
+    except Exception as exc:  # noqa: BLE001 - non-fatal cleanup warning
+        print(f"WARN: clear_run_report failed: {exc}")
+
+    if get_run_report_path(basename, language).exists():
+        print(
+            "WARN: stale run report still present; skipping save_fingerprint "
+            "to avoid partial-sync state (issue #1057)"
+        )
+    else:
+        save_fingerprint(
+            basename=basename,
+            language=language,
+            operation="generate",
+            paths=paths,
+            cost=0.192,
+            model="gemini/gemini-3-pro-preview",
+        )
+        print("Saved fingerprint")
 
 
 # Example CLI command using the @log_operation decorator
@@ -133,10 +148,13 @@ def generate(prompt_file: str, output: Optional[str]) -> Tuple[str, float, str]:
 
     The decorator automatically:
     1. Infers module identity from prompt_file
-    2. Clears stale run report (clears_run_report=True)
-    3. Creates initial log entry
-    4. Executes the wrapped function
-    5. Updates log entry with results
+    2. Creates initial log entry
+    3. Executes the wrapped function
+    4. Updates log entry with results
+    5. On success only: clears stale run report (clears_run_report=True)
+       and verifies deletion before saving fingerprint, so a failed command
+       never erases existing runtime verification state and a fresh fingerprint
+       cannot coexist with a stale run report (issue #1057)
     6. Saves fingerprint on success (updates_fingerprint=True)
     """
     # Simulate generation

{pdd_cli-0.0.243 → pdd_cli-0.0.244}/docs/architecture_include_validation.md

@@ -36,3 +36,20 @@ Warning: examples/prompts_linter/architecture.json: architecture.json / <include
 CI runs `pdd checkup --validate-arch-includes` against the repo plus a small aligned
 fixture under `tests/fixtures/arch_include_validate_ok/` so the step fails if the
 command or validation logic regresses.
+
+## Discovery-layer skip (used by sync and related tooling)
+
+`pdd.architecture_registry.find_architecture_for_project` applies the same
+bundled-sample skip by default: top-level `examples/`, `example_project/`,
+`example_workspace/`, and `staging/` trees are excluded so a root-level
+`pdd sync` (and other discovery-driven tooling such as `metadata_sync` and
+`auto_deps_architecture`) does not flatten sample modules into the project's
+own `architecture.json` (issue #1060). Real nested architecture files under
+other top-level names (`services/`, `apps/`, `packages/`, `libs/`, `frontend/`,
+`backend/`, etc.) are still discovered.
+
+If your monorepo intentionally uses one of the four sample names for production
+modules, opt back in by passing `skip_bundled_sample_arch=False` to the
+discovery helper, or run the validator with `pdd checkup --validate-arch-includes
+--strict`. The skip is a no-op when the project root is itself a bundled-example
+directory, so scans started inside one of those trees continue to work.

{pdd_cli-0.0.243 → pdd_cli-0.0.244}/pdd/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.0.243'
-__version_tuple__ = version_tuple = (0, 0, 243)
+__version__ = version = '0.0.244'
+__version_tuple__ = version_tuple = (0, 0, 244)
 
-__commit_id__ = commit_id = 'g4275a2f8c'
+__commit_id__ = commit_id = 'gf449cc0d0'