Add typed Homeboy promotion adapter

[chubes4]

Summary

Expose a typed Homeboy promotion adapter through DMC's managed-worktree safety boundary.

What changed

• Added promotion-apply CLI request/response schema handling.
• Resolved exact DMC registry entries and rejected primary, dirty, mismatched, external, and untrusted-unpushed targets.
• Reused WorkspaceWriter patch check/apply behavior with an additive dry-run mode.

How to test

1. Run php tests/homeboy-promotion-apply-cli.php; expect adapter success and rejection matrix passes.
2. Run php tests/workspace-handle.php; expect workspace handle contract passes.
3. Run php tests/worktree-get-cli-json-contract.php; expect managed worktree JSON resolution passes.
4. Run php tests/smoke-workspace-file-policy.php; expect 12/12 mutation policy checks pass.

Compatibility

Additive CLI and optional parameter only; existing patch behavior is unchanged.

Evidence

Declared public contracts

• workspace-promotion-apply: New WP-CLI adapter consumes Homeboy promotion requests and returns canonical managed-worktree responses.
• workspace-apply-patch-dry-run: WorkspaceWriter apply_patch gains an opt-in check-only mode used before mutation.

Compatibility impact: Existing workspace patch callers are source-compatible because dry_run defaults false; the new CLI is additive.

External-consumer impact: Homeboy can configure this command as a generic worktree provider apply invocation; existing DMC clients are unaffected.

External usage: completed; source: Homeboy #7898 live provider configuration and DMC workspace patch contract review; limitations: End-to-end no-override Cook requires the paired Homeboy provider-command slot and wp-coding-agents configuration change.; evidence: Extra-Chill/homeboy#7898

• Base unchanged since verification: main remains at 431e57d.
• CI expected: GitHub Actions repository checks
• Reviewer-resolvable evidence from source_refs[0]: Expose typed Homeboy promotion apply adapter for managed worktrees #945
• Reviewer-resolvable evidence from source_refs[1]: agent-task cook cannot promote into DMC-managed worktrees without an apply-capable provider command homeboy#7898
• Verified finalization base: main at 431e57d
• php-syntax: passed (all changed PHP files) (Passed)
• typed-adapter: passed (valid apply, dry-run, schema, handle, primary, dirty, and unpushed cases) (Passed)
• workspace-policy: passed (12 mutation policy checks) (Passed)
• workspace-resolution: passed (handle and worktree-get contracts) (Passed)

AI assistance

• AI assistance: Yes
• Tool(s): Homeboy (OpenCode)
• Model: openai/gpt-5.6-terra
• Used for: Implemented the DMC-owned typed promotion adapter and deterministic tests; GPT-5.6 Sol reviewed the ownership boundary, ran independent integration gates, and finalized the preserved candidate.

Source relationships

• Closes Expose typed Homeboy promotion apply adapter for managed worktrees #945
• Relates to agent-task cook cannot promote into DMC-managed worktrees without an apply-capable provider command homeboy#7898