chore: PDD sync for #1652

[prompt-driven-github]

Summary

Adds pdd/prompts/compatibility_contract_python.prompt specifying a new compatibility_contract module that extracts the bounded public compatibility surface from an existing generated Python file and serializes it into a % Compatibility Surface block suitable for injection into generation context.

Closes #1652

Changes Made

Prompts Modified

• pdd/prompts/compatibility_contract_python.prompt - New prompt specifying extract_compatibility_contract(py_file: Path, *, max_symbols: int = 200, test_files: Optional[List[Path]] = None) -> CompatibilityContract and CompatibilityContract.to_prompt_block() for bounded public-surface extraction

Architecture Updated

• architecture.json - Registered new compatibility_contract module in the project architecture

User Stories Added

• user_stories/story__compatibility_contract.md - Issue-derived user story linked to the new prompt
• user_stories/contracts/compatibility_contract.contract.md - Machine-checkable contract for the user story

User Stories

• Policy: warn
• user_stories/story__compatibility_contract.md — issue-derived story linked to: compatibility_contract_python.prompt
• user_stories/contracts/compatibility_contract.contract.md — generated machine-checkable contract
• Validation: ❌ 1 of 1 linked story check(s) failed: user_stories/story__compatibility_contract.md
• ⚠️ Warning (non-blocking): failing linked story check(s): user_stories/story__compatibility_contract.md

Review Checklist

• Prompt syntax is valid
• PDD conventions followed
• Documentation is up to date

Next Steps After Merge

1. Regenerate code from modified prompts in dependency order:

   pdd sync compatibility_contract

2. Run tests to verify functionality
3. Deploy if applicable

---

Created by pdd change workflow

[prompt-driven-github]

FAILED: All agent providers failed: anthropic: Claude interactive mode timed out. Output tail:
�[9A✻

�[2C�[4A�[2D�[4B
�[9A✽

�[2C�[4A�]0;⠂ Execute agentic prompt instructions��[2D�[4B
�[9A✻

�[2C�[4A�[2D�[4B
�[16A●

�[2C�[4A�[2D�[4B
�[9A✶

�[2C�[4A�[2D�[4B
�[9A*

�[2C�[4A�[2D�[4B
�[16C�[9A3

�[2C�[4A�[2D�[4B
�[9A✢

�[2C�[4A�[2D�[4B
�[10C�[12A3

�[2C�[4A�[2D�[4B
�[9A·

�[2C�[4A�[2D�[4B
�[16A

�[2C�[4A�[2D�[4B
�[9A✢

�[2C�[4A�]0;⠐ Execute agentic prompt instructions��[2D�[4B
�[9A*

�[2C�[4A�[2D�[4B
�[9A✶

�[2C�[4A�[2D�[4B
�[9A✻

�[2C�[4A�[2D�[4B
�[9A✽

�[2C�[4A�[2D�[4B
�[16A●

�[2C�[4A�[2D�[4B
�[16C�[9A4

�[2C�[4A�[2D�[4B
�[10C�[12A4

�[2C�[4A�[2D�[4B
�[9A✻

�[2C�[4A�[2D�[4B
�[9A✶

�[2C�[4A�[2D�[4B
�[9A*

�[2C�[4A�]0;⠂ Execute agentic prompt instructions��[2D�[4B
�[9A✢

�[2C�[4A�[2D�[4B
�[16A

�[2C�[4A�[2D�[4B
�[9A·

�[2C�[4A�[2D�[4B
�[9A✢

�[2C�[4A�[2D�[4B
�[9A*�[15C5

�[2C�[4A�[2D�[4B
�[10C�[12A5

�[2C�[4A�[2D�[4B
�[9A✶

�[2C�[4A�[2D�[4B
�[16A●

�[2C�[4A�[2D�[4B
�[9A✻

�[2C�[4A�[2D�[4B
�[9A✽

�[2C�[4A�]0;⠐ Execute agentic prompt instructions��[2D�[4B
�[9A✻

�[2C�[4A�[2D�[4B
�[9A✶

�[2C�[4A�[2D�[4B
�[16A

�[2C�[4A�[2D�[4B
�[9A*

�[2C�[4A�[2D�[4B
�[9A✢

�[2C�[4A�[2D�[4B
�[16C�[9A6

�[2C�[4A�[2D�[4B
�[9A·

�[2C�[4A�[2D�[4B
�[10C�[12A6

�

PR Push Status

Skipped push because: Checkup did not verify all issues fixed after 3 fix-verify iterations. Step 7 verdict JSON could not be parsed (fail-closed): All agent providers failed: anthropic: Claude interactive mode timed out. Output tail:
�[9A✻

�[2C�[4A�[2D�[4B
�[9A✽

�[2C�[4A�]0;⠂ Execute agentic prompt instructio...

[prompt-driven-github]

Step 7/8: Final Gate Report

PR: #1660
Issue: #1652
final-gate-status: failed
final-gate-stage: layer1
issue_aligned: unknown

Summary

Layer 1 PR checkup failed before Layer 2 review loop could run.

Machine Verdict

{
  "failure_category": "provider_parser_failure",
  "findings": [
    {
      "area": "layer1",
      "finding": "Layer 1 checkup failed before Layer 2: Checkup did not verify all issues fixed after 3 fix-verify iterations. Step 7 verdict JSON could not be parsed (fail-closed): All agent providers failed: anthropic: Claude interactive mode timed out. Output tail: \r\u001b[9A\u273b\r\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\u001b[2C\u001b[4A\u001b[2D\u001b[4B\r\u001b[9A\u273d\r\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\u001b[2C\u001b[4A\u001b]0;\u2802 Execute agentic prompt instructio...",
      "location": "",
      "required_fix": "Resolve the Layer 1 checkup failure or push-guard refusal, then re-run the final gate.",
      "severity": "blocker",
      "status": "open"
    }
  ],
  "fresh_final_status": "missing",
  "full_suite_source": "local",
  "issue_aligned": null,
  "issue_url": "https://github.com/promptdriven/pdd/issues/1652",
  "layer1_status": "failed",
  "layer2_status": "skipped",
  "pr_url": "https://github.com/promptdriven/pdd/pull/1660",
  "reason": "Checkup did not verify all issues fixed after 3 fix-verify iterations. Step 7 verdict JSON could not be parsed (fail-closed): All agent providers failed: anthropic: Claude interactive mode timed out. Output tail: \r\u001b[9A\u273b\r\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\u001b[2C\u001b[4A\u001b[2D\u001b[4B\r\u001b[9A\u273d\r\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\u001b[2C\u001b[4A\u001b]0;\u2802 Execute agentic prompt instructio...",
  "reviewer_status": {},
  "schema": "pdd.checkup.final_gate.v1",
  "stage": "layer1",
  "status": "failed"
}

Issues Summary

Severity	Module	Description	Fixed
blocker	layer1	Layer 1 checkup failed before Layer 2: Checkup did not verify all issues fixed after 3 fix-verify iterations. Step 7 verdict JSON could not be parsed (fail-closed): All agent providers failed: anthropic: Claude interactive mode timed out. Output tail:
�[9A✻

�[2C�[4A�[2D�[4B
�[9A✽

�[2C�[4A�]0;⠂ Execute agentic prompt instructio... | No |