Jyotisha/skills/birth-time-rectification/references/product-contract.md

Product contract

Version and ownership

• Skill: birth-time-rectification-v8.
• Prompt: rectification-director-v4.
• Algorithm: rectification-v5-matrix-scoring-2 remains unchanged.
• V8 changes the conversation and semantic-question contracts; it does not replace the V5 candidate engine.
• The server owns candidate-minute scanning, the event contribution matrix, Candidate Snapshots, diagnostics, stability gates, Decision Validator, deterministic fallback, Jobs, claim/lease, completed-job replay, atomic completion, idempotency, and persistence.
• Preserve v4_legacy, v5_shadow, and v5_agent deployment behavior. Shadow artifacts must not change the legacy visible reply.

Result boundary

The product can return a candidate time range only after deterministic minimum-event, minimum-domain, and stability gates pass. An internal or unstable Snapshot is not a public result. A repeated calculation of the same primary range is not a new update.

canConfirmExactMinute is always false. The product must not present a unique minute or representative minute as the user's true birth time, and rectification completion must not automatically write profiles.active_birth_time.

When evidence is sparse, conflicting, tied, date-sensitive, or unstable, stop or continue with one genuinely useful question. Never package uncertainty as certainty or extend the interview without a useful active opportunity.

Agent authority

The agent may only:

1. propose grounded evidence from the latest answer;
2. choose and directly write one safe interview question;
3. adapt through up to ten unique permitted read-only tool rounds;
4. offer a server-generated candidate range that has passed the public gate; or
5. stop with low confidence.

The final planning prompt exposes only the current runtime revision, prior tool observations, capabilities, and tool availability; it does not preload Case, candidate hypotheses, gap, or diagnostic payloads. The available read-only tools are case_read, candidate_scan, evidence_gap, and diagnostic_read; they expose the current authoritative server projection on demand. Every successful call becomes an immutable Observation in the in-run Dossier, increments its revision, and is visible to the next Director round. The agent must not create or alter events, normalized dates, candidate minutes, scores, diagnostic results, or profile birth data.