undominated-payback-basis
Check switching-cost payback against savings per period using exact arithmetic. Use when a migration claims to pay back in a stated number of periods.
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- undominated-payback-basis
- license
- MIT
- metadata
- { "author": "Undominated.ai", "version": "1.0.1" }
- description
- Check switching-cost payback against savings per period using exact arithmetic. Use when a migration claims to pay back in a stated number of periods.
02 资源文件 6
- 参考文档examples/conflict.json125 B
- 参考文档examples/precision-tail.json128 B
- 参考文档examples/repeating.json128 B
- 参考文档examples/synthetic.json123 B
- 许可证LICENSE1.0 KB
- 脚本scripts/check.py4.7 KB
03 SKILL.md 正文
Payback basis
Payback is switching cost divided by savings per period. Dividing by the whole bill answers a different question. Establish that the supplied amounts have the same currency and that the saving and optional whole bill use one common period before running the check.
Input contract
currency: required three uppercase ASCII letters. The checker validates the format, not membership in a currency registry or conversion accuracy.switchingCostandsavingPerPeriod: required non-negative decimal strings.claimedPeriods: required non-negative decimal string, ornullfor an unknown claim.wholeBill: optional non-negative decimal string ornull; used only to diagnose a mistaken denominator.
JSON numbers, exponents, signs and non-finite values are invalid. Negative savings are outside this non-negative payback contract; do not turn a cost increase into a saving.
Deliverable and limits
Return exactRatio as reduced numerator/denominator strings. recomputedPeriods is an exact decimal only when that fraction terminates; otherwise it is null. No default Decimal precision or floating-point tolerance is used. A rounded decimal claim of one third requires review; the exact ratio remains 1/3. A zero saving makes payback undefined, including when switching cost is zero. Zero switching cost with positive savings gives exact zero payback.
This contract compares exact claims. If a product needs rounded or ceiling periods, define and test that separate display rule rather than presenting its rounded value as an exact equality. The checker does not verify source truth, period alignment, taxes, discounting, exchange rates or payment timing.
examples/repeating.json and examples/precision-tail.json both require review. The original conflict example divides by the whole bill.
Run the local check
Resolve paths relative to this skill directory:
python3 scripts/check.py examples/synthetic.json
python3 scripts/check.py /absolute/path/to/your-input.json
The examples are synthetic, not market measurements. Python 3.10+; standard library only. The script reads one explicit UTF-8 JSON file, prints JSON and makes no network requests or file writes.
Exit codes: 0 consistency check passed, 1 review required, 2 invalid input. CLI argument and malformed-input errors return structured JSON; --help displays usage text. Unknown or duplicate JSON fields, non-JSON constants and invalid types are rejected. Files are limited to 1 MiB; decimal strings to 1000 characters; identity/field names to 512 characters, with no surrounding whitespace or ASCII control characters.
This source-only skill is not included in undominated-check@0.4.0. Keep SKILL.md, the checker, examples and MIT licence together. A pass validates the bounded supplied-input contract, not production suitability or permission to publish. The skill does not authorize external actions.
04 同仓库更多 Skills
undominated-zero-base-undefined
Refuse a multiple whose base is zero. The multiple is undefined. This checker does not emit a quotient.
undominated-withheld-provider
Check a supplied publication denylist by exact provider-name matching. A pass does not approve a provider or establish that the supplied list is complete.
undominated-withdrawal-residue
Check an explicitly observed withdrawn numeric field and its named dependents for leftover values. Use after a source value has been removed from a snapshot.
undominated-unrated-sentinel
Keep a missing score out of a ranked list, so unrated is not scored zero and a scored row is not dropped in silence.
undominated-unit-not-scaled
Refuse a scale factor or a restated invoice unit. A per-thousand row is not turned into a per-million row by multiplying. Amounts are not read.
undominated-topk-not-dump
Refuse a prompt whose scope is the whole catalogue. Retrieval stays top-k. No catalogue is copied.