Materialize remote workspaces for local runners

[chubes4]

Summary

Add an explicit DMC lifecycle operation that materializes registered GitHub API workspace state into authoritative local checkouts for command runners.

What changed

• A new workspace materialize ability and CLI command resolve registered remote identity, clone or validate the local primary, create the local worktree from the remote branch or recorded base when unpushed, preserve task metadata, and return a resolver-ready local path.

How to test

1. Run php tests/worktree-add-lifecycle.php; expect An unpushed remote worktree materializes locally from origin/main, retains its task URL, and appears in targeted lookup..
2. Run php tests/mounted-runtime-context.php; expect Existing mounted-runtime backend behavior remains valid..

Compatibility

Existing remote API workspaces remain unchanged until materialize is explicitly invoked; normal clone, duplicate-remote, freshness, disk-budget, bootstrap, context injection, and task-tracker policies remain authoritative.

Evidence

• Base unchanged since verification: main remains at 3dda9c3.
• Reviewer-resolvable evidence from source_refs[0]: Materialize remote workspaces for local command runners #956
• Reviewer-resolvable evidence from source_refs[1]: Allow pre-tool-call middleware to complete a call successfully WordPress/mcp-adapter#255
• Verified finalization base: main at 3dda9c3
• materialization-lifecycle: passed (unpushed registered branch materializes from recorded base_ref and preserves task metadata) (Passed)
• mounted-runtime: passed (mounted runtime context regression passes) (Passed)
• syntax-and-diff: passed (all changed PHP files lint and diff hygiene is clean) (Passed)

AI assistance

• AI assistance: Yes
• Tool(s): Homeboy (OpenCode with Homeboy)
• Model: openai/gpt-5.6-terra + openai/gpt-5.6-sol
• Used for: OpenAI gpt-5.6-terra drafted the materialization ability, CLI, lifecycle, and regression test through Homeboy; OpenAI gpt-5.6-sol reviewed the patch, found and fixed the unpushed-branch base-ref gap, and ran deterministic verification. Chris Huber owns the committed result.

Source relationships

• Closes Materialize remote workspaces for local command runners #956