diff --git a/SCOPE.md b/SCOPE.md index 9da38a6..b074eca 100644 --- a/SCOPE.md +++ b/SCOPE.md @@ -12,33 +12,64 @@ adapting, and implementing pricing models across the product lifecycle. See ## In Scope -- Generic framework documentation (`INTENT.md`, `docs/`, `research/`, `registry/`). -- Pricing model vocabulary, lifecycle reasoning, and capability registry. -- Project-specific deployments under `projects//`. +- Generic pricing core under `adaptive_pricing_core/`, including: + canonical pricing schema and validation, boundary evaluation, comparable + customer LTV, customer-tuning solver, provider-publication primitives, Stripe + mapping, and governance models. +- Generic framework documentation and research (`INTENT.md`, `docs/`, + `research/`, `registry/`). +- Project-specific proving grounds under `projects//`, with Coulomb + Social as the first full adopter of the generic core. +- Local execution surfaces that keep internal pricing definitions as the source + of truth, including provider shadow publication, governed recommendations, + tuning contracts, health checks, and audit history. - State Hub workplans under `workplans/` (ADR-001). ## Out of Scope -- Owning unrelated adjacent systems (Bubble.io, Stripe, OpenRouter runtimes). -- Making irreversible operational or pricing decisions without human approval. -- Project-specific MVP material in generic doc paths (use `projects//`). +- Owning unrelated adjacent systems as the source of truth, including Bubble, + Stripe, and OpenRouter runtimes. +- Live payment-provider mutation as the default repo behavior. Current provider + execution stops at mapping, shadow-state publication, drift detection, and + rollback planning. +- Treating approximate provider mappings as fully enforced billing behavior when + they still require supplemental operational or contract logic. +- Autonomous customer-visible pricing rollouts or irreversible pricing changes + without human approval. +- Project-specific deployment material in generic doc paths (use + `projects//`). ## Current State -- **Phase:** framework plus first project deployment — root docs/research remain - generic, while Coulomb Social provides the first concrete implementation. -- **Runtime:** project-specific runtime exists under - `projects/coulomb-pricing/observatory/`; the repo root remains documentation, - research, registry scaffolding, and workplan coordination. -- **Bootstrap:** State Hub integration (`ADAPTIVE-WP-0001`) wires agent orientation, - workplan tracking, and custodian brief sync. +- **Phase:** framework plus executable core. The repo is no longer just docs and + research around a single MVP; it now contains reusable pricing-core modules + and one concrete deployment. +- **Implemented milestones:** `ADAPTIVE-WP-0003` through `ADAPTIVE-WP-0008` + are finished. The repo now has canonical pricing models, explainable boundary + validation, comparable-customer LTV simulation, customer-tuning, provider + shadow publication, and governance workflows. +- **Generic runtime surface:** reusable implementation lives under + `adaptive_pricing_core/`. +- **Deployment surface:** Coulomb Social remains the first proving ground under + `projects/coulomb-pricing/observatory/`, including the dashboard/API, data + loaders, tuning pilot, Stripe shadow-publication flow, and governed + recommendation surfaces. +- **Execution boundary:** Stripe support is currently a provider abstraction and + local shadow-state publisher, not live Stripe API management. +- **Coordination:** State Hub integration (`ADAPTIVE-WP-0001`) remains the repo + workflow backbone for orientation, workplan tracking, and brief sync. ## Getting Oriented - Start with: `INTENT.md` - Product requirements (generic): `docs/ProductRequirementsDocument.md` +- Canonical pricing schema: `docs/PricingModelSchema.md` +- Customer tuning: `docs/CustomerTuningSolver.md` +- Provider publication: `docs/StripePublication.md` +- Governance workflow: `docs/GovernanceWorkflows.md` - Implementation roadmap: `docs/ImplementationRoadmap.md` - Agent instructions: `AGENTS.md` - Workplans: `workplans/` -- Coulomb MVP artifacts: `projects/coulomb-pricing/` +- Generic code: `adaptive_pricing_core/` +- Coulomb deployment artifacts: `projects/coulomb-pricing/` - Offline hub brief: `.custodian-brief.md` diff --git a/workplans/ADHOC-2026-07-03.md b/workplans/ADHOC-2026-07-03.md new file mode 100644 index 0000000..b275fc8 --- /dev/null +++ b/workplans/ADHOC-2026-07-03.md @@ -0,0 +1,28 @@ +--- +id: ADHOC-2026-07-03 +type: workplan +title: "Ad hoc repo maintenance - 2026-07-03" +domain: financials +repo: adaptive-pricing +status: finished +owner: codex +topic_slug: helix-forge +created: "2026-07-03" +updated: "2026-07-03" +state_hub_workstream_id: "f5c22683-5dd8-46e9-9ff3-2215af2eb66e" +--- + +# Ad hoc repo maintenance - 2026-07-03 + +## Refresh Scope Document To Match Implemented Capabilities + +```task +id: ADHOC-2026-07-03-T01 +status: done +priority: medium +state_hub_task_id: "1443b72e-2ee2-4c49-98a4-b309bf99e917" +``` + +Update `SCOPE.md` so the repo boundary, current state, and execution limits +match the implemented generic pricing core, Coulomb proving ground, and current +Stripe shadow-publication / governance surfaces.