feat(engine): add horizon-aware planning rollouts

[div0rce]

Summary

Adds deterministic short-horizon policy rollout support.

This keeps present-time recommendations separate from planning projections.

Key Changes

• Adds explicit horizon configuration with mode: "planning" and futureJustification: "forbidden"
• Adds generic future-state transition and policy evaluation primitives
• Adds deterministic rollout evaluator with all rollout output labeled planning_projection
• Marks the step-0 policy action as selected_present_action without changing solver output
• Keeps solver, routes, and UI behavior unchanged
• Bumps engine behavior version and replay index for the new engine subsystem

Non-Goals

• No long-horizon financial planning
• No stochastic uncertainty modeling
• No generic future-obligation planner
• No UI redesign

Verification

• npm run typecheck
• CHERRY_TMP_ROOT="$HOME/.cherry-tmp" npm test
• CHERRY_TMP_ROOT="$HOME/.cherry-tmp" npm run lint
• CHERRY_TMP_ROOT="$HOME/.cherry-tmp" npm run check
• CHERRY_TMP_ROOT="$HOME/.cherry-tmp" CHERRY_VINE_SIGNATURE_MODE=enforce npm run build
• CHERRY_TMP_ROOT="$HOME/.cherry-tmp" CHERRY_VINE_SIGNATURE_MODE=enforce npm run verify:repo-closure

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
cherry	Ready	Preview, Comment	Apr 29, 2026 3:59am

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0ca8b94df0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".