Refresh scope document to match implemented core

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/`).
+- Generic pricing core under `adaptive_pricing_core/`, including:
-- Pricing model vocabulary, lifecycle reasoning, and capability registry.
+  canonical pricing schema and validation, boundary evaluation, comparable
-- Project-specific deployments under `projects/<slug>/`.
+  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/<slug>/`, 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).
+- Owning unrelated adjacent systems as the source of truth, including Bubble,
-- Making irreversible operational or pricing decisions without human approval.
+  Stripe, and OpenRouter runtimes.
-- Project-specific MVP material in generic doc paths (use `projects/<slug>/`).
+- 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/<slug>/`).
 
 ## Current State
 
-- **Phase:** framework plus first project deployment — root docs/research remain
+- **Phase:** framework plus executable core. The repo is no longer just docs and
-  generic, while Coulomb Social provides the first concrete implementation.
+  research around a single MVP; it now contains reusable pricing-core modules
-- **Runtime:** project-specific runtime exists under
+  and one concrete deployment.
-  `projects/coulomb-pricing/observatory/`; the repo root remains documentation,
+- **Implemented milestones:** `ADAPTIVE-WP-0003` through `ADAPTIVE-WP-0008`
-  research, registry scaffolding, and workplan coordination.
+  are finished. The repo now has canonical pricing models, explainable boundary
-- **Bootstrap:** State Hub integration (`ADAPTIVE-WP-0001`) wires agent orientation,
+  validation, comparable-customer LTV simulation, customer-tuning, provider
-  workplan tracking, and custodian brief sync.
+  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`

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.