docs(base): generalize analysis contracts

[huarenmin13]

Summary

Port the final net changes from #2262 onto a fresh branch based on the current main, without carrying the original PR's intermediate commit history.

Changes

• Lock each analysis output series to an explicit source, population, measure, grouping, and applicable time/formula semantics before conclusion-bearing calculations.
• Keep user-requested metrics independent and prevent diagnostic alternatives from silently replacing the selected field, filter, date, denominator, or formula.
• Model continuous calendar buckets as adjacent half-open intervals and preserve empty buckets according to the locked metric contract.
• Document an exact +data-query recovery path for local-calendar boundaries, with complete NDJSON fallback when the date-dimension result cannot be proven complete.
• Require export, JOIN, boundary-record, and compatible bucket-to-total coverage checks before presenting a complete conclusion.

Impact

This is a documentation-only change. It adds no task-specific field priority, denominator default, evaluation case ID, or business-specific analysis recipe.

Validation

• node scripts/skill-format-check/index.js
• QUALITY_GATE_CHANGED_FROM=upstream/main make quality-gate
• git diff --check upstream/main...HEAD
• Final two-file content matches the current docs(base): generalize analysis contracts #2262 head.

Related

• Port of docs(base): generalize analysis contracts #2262

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 971250e2-c661-402b-82ba-ee4ed05ee9a8

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}