saasfunnels 0.3.3 → 0.4.0

package/README.md

@@ -111,3 +111,38 @@ If extraction is unsupported, `.saasfunnels/setup-review.json` lists the files a
 Discovery follows Git ignore rules (including custom build folders) while keeping tracked application sources and new, non-ignored source files. Standalone folders without Git use the standard source filters.
 
 The command does not implement arbitrary payment code, approve feature access, or verify transactions. Complete **Review and verify** in Setup after deploying the runtime and payment integration. Requires the server's guided setup API release.
+
+### Discovery accuracy and review
+
+Guided setup proposes supported JavaScript/TypeScript gates and static JS/TS/JSON/YAML catalogs. Tests, fixture/demo scopes, comments, and generic role permissions are excluded. Named capabilities and numeric/unlimited limits remain separate; units, reset periods, and aggregation require review in Setup's existing Plans & pricing editor.
+
+A frontend scan is not evidence of complete backend coverage. Setup flags unsupported application languages, unresolved dynamic access, and optional add-on/capacity/trial declarations. Review these against the actual application's entitlement owner before confirming. Imported or dynamic pricing that cannot be statically resolved needs reviewed literal `.saasfunnels/setup-pricing.json` evidence or manual configuration; source is never executed. Arbitrary helper names and external services cannot be exhaustively discovered automatically.
+
+Feature configuration must be saved and published in Plans & pricing before Setup can confirm it. Naming an unnamed restriction records a review decision; it does not implement access. A new scanner version may require running without `--resume`; guided rescans preserve human decisions and leave local generated catalogs untouched.
+
+### Review prefilled configuration (Setup contract 3)
+
+CLI 0.4.x coordinates with the guided configuration review. Run
+`npx --yes saasfunnels@latest setup run` to submit proposals; workspace
+administrators review and publish them in Setup. The developer key never approves
+configuration or payment connections.
+
+Supported literal pricing declarations may include `quotas` with explicit unit,
+period, aggregation, and `usageSource: "customer_reported"`, plus `components`
+with exact Stripe product/price IDs, included quantities and quantity sources.
+Use `quantityBasis: "total"` for sources reporting all units, or `"additional"`
+for sources already reporting units above the allowance. Missing semantics require
+review rather than guessed defaults.
+
+A coding agent can place reviewed declarations in `.saasfunnels/setup-pricing.json`
+and question explanations in `.saasfunnels/setup-answers.json`. Explanations are
+bounded `{id, fingerprint, disposition, reason}` records; disposition is
+`configuration`, `not_applicable`, or `unresolved`. Configuration answers include
+`configuration: [{planKey, featureKey}]` or `[{planKey, componentKey}]` referencing
+corrected declarations. Required unsupported behavior must remain unresolved.
+Corrected configuration belongs in the pricing
+file. No source files or credentials belong in either upload.
+
+Changes to those files or application source require a fresh run. Use `--resume`
+only for unchanged interrupted work. The scan identity includes reviewed inputs
+and scanner contract version, so accepted old submissions cannot hide corrections.