Skip to content

Bss/pricing#7

Open
diffora wants to merge 1 commit into
mainfrom
bss/pricing
Open

Bss/pricing#7
diffora wants to merge 1 commit into
mainfrom
bss/pricing

Conversation

@diffora

@diffora diffora commented Jul 16, 2026

Copy link
Copy Markdown
Owner

No description provided.

@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown

Important

Review skipped

Too many files!

This PR contains 63 files, which is 13 over the limit of 50.

To get a review, narrow the scope:
• coderabbit review --type committed # exclude uncommitted changes
• coderabbit review --dir # limit to a subdirectory
• coderabbit review --base # compare against a closer base

Upgrade to a paid plan to raise the limit.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: db8eea80-7d0d-4b49-8907-66e2b1d7a12f

📥 Commits

Reviewing files that changed from the base of the PR and between 9527f48 and f00d5d2.

📒 Files selected for processing (63)
  • gears/bss/pricing/docs/ADR/0001-cpt-cf-bss-pricing-adr-canonical-scope-key.md
  • gears/bss/pricing/docs/ADR/0002-cpt-cf-bss-pricing-adr-grandfathering-cohort-axis.md
  • gears/bss/pricing/docs/ADR/0003-cpt-cf-bss-pricing-adr-pricewindow-consolidation.md
  • gears/bss/pricing/docs/DECISIONS.md
  • gears/bss/pricing/docs/DESIGN.md
  • gears/bss/pricing/docs/PRD.md
  • gears/bss/pricing/docs/STRIPE-GAP-ANALYSIS.md
  • gears/bss/pricing/docs/design/01-foundation.md
  • gears/bss/pricing/docs/design/02-plan-definition.md
  • gears/bss/pricing/docs/design/03-price-structure.md
  • gears/bss/pricing/docs/design/04-currency-tax.md
  • gears/bss/pricing/docs/design/05-governance.md
  • gears/bss/pricing/docs/design/06-consumer-contracts.md
  • gears/bss/pricing/docs/design/07-pricewindow-linkage.md
  • gears/bss/pricing/docs/design/08-bundles.md
  • gears/bss/pricing/docs/design/09-price-overlays.md
  • gears/bss/pricing/docs/design/10-advanced-primitives.md
  • gears/bss/pricing/docs/design/11-lifecycle.md
  • gears/bss/pricing/docs/design/12-operator-efficiency.md
  • gears/bss/pricing/docs/design/README.md
  • gears/bss/products/docs/PRD.md
  • gears/bss/rating/docs/ADR/0001-cpt-cf-bss-rating-adr-scope-key-adoption.md
  • gears/bss/rating/docs/ADR/0002-cpt-cf-bss-rating-adr-rating-gear-consolidation.md
  • gears/bss/rating/docs/DECISIONS.md
  • gears/bss/rating/docs/DESIGN.md
  • gears/bss/rating/docs/PRD.md
  • gears/bss/rating/docs/SEAMS.md
  • gears/bss/rating/docs/design/01-foundation.md
  • gears/bss/rating/docs/design/02-selection-eligibility.md
  • gears/bss/rating/docs/design/03-metering-models.md
  • gears/bss/rating/docs/design/04-overlays-precedence.md
  • gears/bss/rating/docs/design/05-commitments-reservations.md
  • gears/bss/rating/docs/design/06-coupons.md
  • gears/bss/rating/docs/design/07-currency-fx.md
  • gears/bss/rating/docs/design/08-retroactivity-corrections.md
  • gears/bss/rating/docs/design/09-period-plan-change.md
  • gears/bss/rating/docs/design/10-governance-asc606.md
  • gears/bss/rating/docs/design/11-consumer-contracts.md
  • gears/bss/rating/docs/design/12-usage-ingestion-normalization.md
  • gears/bss/rating/docs/design/13-q-store-attribution.md
  • gears/bss/rating/docs/design/14-unit-synthesis-period-tick.md
  • gears/bss/rating/docs/design/15-rated-output-balance-effects.md
  • gears/bss/rating/docs/design/16-billing-handoff-operations.md
  • gears/bss/rating/docs/design/README.md
  • gears/bss/subscriptions/docs/ADR/0001-cpt-cf-bss-subscriptions-adr-manifest-closed-status-machine.md
  • gears/bss/subscriptions/docs/ADR/0002-cpt-cf-bss-subscriptions-adr-when-not-math-split.md
  • gears/bss/subscriptions/docs/ADR/0003-cpt-cf-bss-subscriptions-adr-scheduled-intents-on-aggregate.md
  • gears/bss/subscriptions/docs/DECISIONS.md
  • gears/bss/subscriptions/docs/DESIGN.md
  • gears/bss/subscriptions/docs/PRD.md
  • gears/bss/subscriptions/docs/SEAMS.md
  • gears/bss/subscriptions/docs/STRIPE-ZUORA-GAP-ANALYSIS.md
  • gears/bss/subscriptions/docs/design/01-foundation-lifecycle.md
  • gears/bss/subscriptions/docs/design/02-composition-versioning.md
  • gears/bss/subscriptions/docs/design/03-plan-changes.md
  • gears/bss/subscriptions/docs/design/04-suspension-renewal-grace.md
  • gears/bss/subscriptions/docs/design/05-entitlements.md
  • gears/bss/subscriptions/docs/design/06-trials.md
  • gears/bss/subscriptions/docs/design/07-tenancy-transfer.md
  • gears/bss/subscriptions/docs/design/08-events-billing.md
  • gears/bss/subscriptions/docs/design/09-consumer-contracts.md
  • gears/bss/subscriptions/docs/design/README.md
  • gears/system/usage-collector/docs/PRD-phase2-usage-event-feed.md

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:

  • Review on demand using usage pricing
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch bss/pricing

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

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

…ns, products, UC feed

The full BSS design program squashed to one commit against main (44
commits, 2026-06-28…2026-07-16). Docs only; gates green throughout
(cfs validate / validate-toc / check-language).

PRICING (Plan & Price Modeling — gears/bss/pricing):
- PRD + complete 12-slice design set: Catalog Foundation (publish-through-
  the-engine, fail-closed validation, frozen read model +
  pricingSnapshotRef), plan definition, price structure & model kinds,
  currency/tax, governance (two-person materiality), consumer contracts,
  PriceWindow machinery consolidated into the gear (ADR-0003), bundles /
  price lists / advanced primitives, AuthZ (PEP catalog), lifecycle +
  operator efficiency; pricing_ table prefix; module renamed
  plan-price → pricing.
- Decision register D-01…D-46 + R-01…R-14 closed; slice-walkthrough gap
  waves H1–H31; 8-axis canonical scope key; server-side price resolution.

RATING (ex-Tariffs — gears/bss/rating):
- Tariffs PRD vendored as baseline → cross-gear seam map vs pricing
  (SEAMS A–H: scope key, overlays, windows, snapshot, models/metering,
  proration/FX, governance/bundles) → resolutions propagated into the PRD.
- Design slices 01–11 (pure-function evaluation core: foundation,
  selection/eligibility, metering models, overlays, commitments, coupons,
  FX, retroactivity, period/plan-change, governance/ASC606, consumer
  contracts).
- ADR-0002: Tariffs + rating pipeline consolidated into ONE rating gear
  (rating-core no-I/O crate + pipeline); migration commits A–C; pipeline
  slices 12–16 authored (usage ingestion & normalization, windowed Q
  store & attribution, unit synthesis & period tick, rated output & delta
  dedup & balance effects, Billing handoff & operations).
- Decision register T-D-01…T-D-17; SEAMS §I registry seams (RG1 open,
  RG2/RG3 closed) and §J Usage Collector ingestion bridge (UC1–UC6:
  transport gates slice-12, watermark, attribution join, dedup-key
  derivation, correction visibility, temporal shape).
- usage_record hot/cold tiering posture (S3-compatible Parquet + digest-
  verified manifest to the ≥7y correction horizon).

SUBSCRIPTIONS (gears/bss/subscriptions):
- Single normative PRD (vendored VHP-806, merged with the predecessor
  entitlements PRD) + SEAMS + DESIGN set; SUB-D-01…12 (scheduled intents,
  updateQuantity, collectionPaused, ramps, activation date trio, transfer,
  void, grace polish); design-review veto batch + consistency passes.

PRODUCTS registry (gears/bss/products — NEW):
- Registry PRD vendored from constructorfabric PR constructorfabric#4177 @ 6d3aab4
  (upstream-detach: this repo is canonical; provenance note kept);
  RG2 fix applied in text (unit ≠ dimension — declared dimension set is a
  plan-price concern; separate SKUs demoted rule → option; composite =
  output unit, inputs are units); gear renamed product-sku → products
  (dir + 135-id prefix); RG3 naming reconciled; registry pointers
  de-staled across subscriptions/pricing.

USAGE-COLLECTOR (gears/system/usage-collector — proposal doc, NEW):
- Phase-2 'Usage Event Feed & Ingestion Watermarks' PRD: durable
  per-tenant acceptedSeq feed (usage + compensations + status
  transitions), deterministic cursor replay, acceptance-progress
  watermarks, feed-lag NFR + ingestion non-regression, Plugin SPI
  accepted-order scan. Executes the v1 DESIGN §4 reserved hooks, additive
  under ADR-0006; driving consumer = rating pipeline slice 12.

CROSS-CUTTING product decisions (2026-07-16, confirmed):
- D-44 / T-D-17 — level-based billing into launch: aggregationFunction
  {sum, peak, time_weighted} + aggregationGranularity; granule fold over
  gauge samples, window Q = Σ folds (additive — every counter invariant
  untouched); cloudlet peak-per-hour, storage GB-month.
- D-45 — first-class includedAllowance {quantity, rolloverPolicy},
  publish-compiled (none → $0 first band + frozen marker; carry → D-43
  per-period promotional grant, Billing executes).
- D-46 — registry sellable flag + sellability-gate predicate 6
  (standalone lines; bundle components exempt).
- gears-rust declared the canonical home for BSS gear docs;
  vhp-architecture is legacy provenance (no drift-tracking obligation).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant