saasfunnels 0.2.3 → 0.3.1

package/README.md

@@ -10,12 +10,16 @@ This repository contains only the MIT-licensed CLI and its bounded runtime contr
 
 ## Install
 
-Install the stable CLI:
+Start in your app repository:
 
 ```bash
-npm install --global saasfunnels
+npx --yes saasfunnels@latest setup
 ```
 
+The explicit version tag avoids running an older project-local CLI. Setup asks where developer access is saved (Doppler or `.env.local`) when needed, requests approval before uploading findings, and shows each discovery stage. It never prints keys, rewrites env files, deploys your app, or approves inferred plans. Connect Stripe and create app credentials in the web Setup first. `setup run` remains a compatible entry point.
+
+For scripts, use `--env-file .env.local --send --non-interactive`, or inject `SAASFUNNELS_API_KEY` from your secret manager. Without explicit approval, non-interactive runs stop without uploading. Run `setup --help` for setup-only guidance. Runtime implementation and payment verification remain in the web Setup.
+
 ## Use
 
 ```bash
@@ -37,9 +41,9 @@ saasfunnels plans handoff --integration-id <id> \
 prices. Files that reference a Stripe price are reported as evidence; files that
 only look commercial by name and content are reported separately as guesses.
 Nothing leaves the machine until `.saasfunnels/plan-sources.json` lists the files
-and `plans handoff --send` is run, because plan mapping receives file contents
-rather than the `file:line` references a feature manifest sends. Commit that file
-so the approved set is reviewable.
+and `plans handoff --send` is run. The CLI extracts normalized mapping evidence
+locally; source contents stay on your machine. Commit the approval file so the
+approved set is reviewable.
 
 ### GitHub Action
 
@@ -51,7 +55,7 @@ so the approved set is reviewable.
     discovery-roots: app,lib
 ```
 
-On a pull request the Action scans as a `candidate`: the result is compared
+The Action uploads an existing feature manifest; it does not freshly scan application source. On a pull request the upload is a `candidate`: the result is compared
 against the branch's baseline and discarded. Only the default branch advances
 the lineage. Changing `discovery-roots` starts a new lineage, so drift is
 measured against a comparable scan rather than a wider or narrower one.
@@ -91,3 +95,13 @@ The package allowlist is enforced as `LICENSE`, `README.md`, `package.json`, the
 Documentation: https://docs.saasfunnels.ai/developer-tools/saasfunnels-cli
 
 Support: support@saasfunnels.ai
+
+### Guided application discovery
+
+Use `saasfunnels setup run` from the application repository after creating app credentials in Setup. Load `SAASFUNNELS_API_KEY` from **Developer setup access** into the local process environment. Its scopes are `developer:read` and `features:write`; it is not a browser or payment-administration key.
+
+The command asks before uploading structured discovery proposals. `--send` provides explicit non-interactive approval. It coordinates features, pricing extraction, and plan branches, reports progress, and waits for the Stripe catalog. Run `saasfunnels setup run --resume` after an interruption. Existing accepted stages and customer review decisions are preserved.
+
+If extraction is unsupported, review a `.saasfunnels/setup-pricing.json` file with `{ "plans": [{ "key": "pro", "name": "Pro", "features": { "export": true }, "prices": [{ "key": "price_ACTUAL_ID" }] }] }`, then resume. Use real identifiers from the connected merchant. Raw source files are never uploaded by guided setup or the pricing handoff.
+
+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.

package/dist/library.js

@@ -1,4 +1,4 @@
-import { createRequire as __saasfunnelsCreateRequire } from "node:module"; const require = __saasfunnelsCreateRequire(import.meta.url);
+import { createRequire as __saasfunnelsCreateRequire } from "node:module"; const require = __saasfunnelsCreateRequire(import.meta.url); const __filename = new URL(import.meta.url).pathname; const __dirname = require("node:path").dirname(__filename);
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -24264,7 +24264,7 @@ function validateFeatureCatalogManifest(value) {
 
 // src/identity.ts
 var SAASFUNNELS_CLI_NAME = "saasfunnels";
-var SAASFUNNELS_CLI_VERSION = "0.2.3";
+var SAASFUNNELS_CLI_VERSION = "0.3.1";
 var SAASFUNNELS_PRODUCT_NAME = "SaaSFunnels";
 var SAASFUNNELS_DEFAULT_API_BASE_URL = "https://app.saasfunnels.ai";
 var SAASFUNNELS_ENV = Object.freeze({