{"uid":"cap_AWsk4jCivbpEPN0vLVHcO","slug":"novapath-coaching-metric-reconciliation-10e64c45","name":"NovaPath Coaching Metric Reconciliation","description":"Reconcile two coaching metrics across numerator, denominator, status, date window, attribution and evidence rules. Explains why similar percentages disagree and returns a common reporting contract.","url":"https://instructional-decision-engine-x402.vercel.app/coaching/metric-reconciliation?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"left":{"type":"object","required":["numerator","denominator","numeratorDefinition","denominatorDefinition","dateBasis","start","end","attribution","evidenceRule"],"properties":{"end":{"type":"string","pattern":"^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"},"start":{"type":"string","pattern":"^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"},"dateBasis":{"enum":["created","completed","observed"],"type":"string"},"numerator":{"type":"integer","maximum":1000000,"minimum":0},"attribution":{"enum":["assigned","delivered","linked"],"type":"string"},"denominator":{"type":"integer","maximum":1000000,"minimum":0},"evidenceRule":{"enum":["none","metadata","linked_content","reflection"],"type":"string"},"numeratorDefinition":{"enum":["completed_actions","completed_or_continued_actions","observed_cycles","evidence_linked_actions"],"type":"string"},"denominatorDefinition":{"enum":["all_actions","actions_with_observations","planned_cycles","observed_cycles"],"type":"string"}},"additionalProperties":false},"right":{"type":"object","required":["numerator","denominator","numeratorDefinition","denominatorDefinition","dateBasis","start","end","attribution","evidenceRule"],"properties":{"end":{"type":"string","pattern":"^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"},"start":{"type":"string","pattern":"^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"},"dateBasis":{"enum":["created","completed","observed"],"type":"string"},"numerator":{"type":"integer","maximum":1000000,"minimum":0},"attribution":{"enum":["assigned","delivered","linked"],"type":"string"},"denominator":{"type":"integer","maximum":1000000,"minimum":0},"evidenceRule":{"enum":["none","metadata","linked_content","reflection"],"type":"string"},"numeratorDefinition":{"enum":["completed_actions","completed_or_continued_actions","observed_cycles","evidence_linked_actions"],"type":"string"},"denominatorDefinition":{"enum":["all_actions","actions_with_observations","planned_cycles","observed_cycles"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OttocI3ygbPxxKeFqbyYV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reconciles two coaching metrics by comparing their numerator, denominator, date window, attribution, and evidence rules to explain why similar percentages disagree and produce a common reporting contract.","exampleAgentPrompt":"I have two coaching metric reports for the same program that show different completion rates — the left report has 120 completed_actions out of 200 all_actions using completed date basis from 2024-08-01 to 2024-12-31 with assigned attribution and no evidence rule, and the right report has 95 evidence_linked_actions out of 180 actions_with_observations using observed date basis over the same window with linked attribution and linked_content evidence — can you reconcile these and explain why they disagree?","exampleUseCases":[{"title":"Coaching dashboard discrepancy investigation","prompt":"Our instructional coaching dashboard is showing 68% completion but the district report shows 54% for the same teachers and the same August-to-December 2024 window. Left side: 136 completed_actions out of 200 all_actions, created date basis, assigned attribution, no evidence rule. Right side: 108 completed_or_continued_actions out of 200 actions_with_observations, observed date basis, delivered attribution, metadata evidence. Can you reconcile these and tell me what's driving the gap?"},{"title":"End-of-year coaching audit alignment","prompt":"I need to produce a single unified coaching completion report for our year-end audit but two teams calculated the numbers differently. Team A got 340 completed_actions over 500 planned_cycles from 2024-01-01 to 2024-06-30 using completed date basis, linked attribution, and reflection evidence. Team B got 290 observed_cycles over 400 observed_cycles from the same period using observed date basis, assigned attribution, and linked_content evidence. Please reconcile these and give me a common reporting contract we can both agree on."},{"title":"Multi-school coaching metric standardization","prompt":"We're trying to standardize coaching metrics across three schools but two of our measurement approaches keep producing conflicting percentages. The first approach: 75 evidence_linked_actions numerator, 150 actions_with_observations denominator, observed date basis, 2024-09-01 to 2025-01-31, linked attribution, linked_content evidence. The second: 90 completed_or_continued_actions numerator, 175 all_actions denominator, completed date basis, same window, delivered attribution, metadata evidence. Explain the disagreement and give me a reconciled contract we can use going forward."}],"resultDescription":"Returns a structured reconciliation report that identifies which dimension differences (numerator definition, denominator definition, date basis, attribution method, evidence rule, or date window) cause the percentage discrepancy between the two metrics, explains the magnitude and direction of each contributing factor, and provides a common reporting contract specifying agreed-upon definitions for unified future reporting.","failureModes":["Denominator of zero for either side causes division error or invalid metric","Mismatched or invalid date formats rejected by pattern validation","Numerator exceeding denominator may trigger a logical inconsistency warning","Start date after end date returns a validation error","Missing required fields on either left or right object causes a 400-level error","Highly ambiguous definition combinations may produce low-confidence reconciliation output"],"whenToPreferThis":"Choose this endpoint when two coaching metric reports show different percentages for what appears to be the same program or time period, and you need a systematic explanation of why the numbers differ across numerator/denominator definitions, date basis, attribution, or evidence rules. It is the right choice when you need to produce a single harmonized reporting contract from two divergent measurement approaches. Prefer it over manual comparison when the discrepancy involves multiple interacting dimensions that are hard to disentangle by inspection alone.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:09.501Z","isFirstParty":false,"canonicalSlug":"novapath-coaching-metric-reconciliation-10e64c45"}