saasfunnels 0.5.0 → 0.5.2

package/README.md

@@ -48,7 +48,7 @@ approved set is reviewable.
 ### GitHub Action
 
 ```yaml
-- uses: LeadEngine-ai/saasfunnels-cli/action@v0.2.1
+- uses: LeadEngine-ai/saasfunnels-cli/action@v0.5.2
   with:
     api-key: ${{ secrets.SAASFUNNELS_API_KEY }}
     cli-version: 0.2.1 # pin it; a floating version rebaselines drift
@@ -92,9 +92,9 @@ npm run release:verify
 
 The package allowlist is enforced as `LICENSE`, `README.md`, `package.json`, the `saasfunnels` executable bundle, and the typed server-side library bundle/declarations.
 
-Documentation: https://docs.saasfunnels.ai/developer-tools/saasfunnels-cli
+Documentation: https://docs.saasfunnels.com/developer-tools/saasfunnels-cli
 
-Support: support@saasfunnels.ai
+Support: support@saasfunnels.com
 
 ### Guided application discovery
 
@@ -114,6 +114,8 @@ CLI 0.5.0 requires Setup contract 4 and stops before creating a run against an o
 
 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 coding-agent installation handoff can also create `.saasfunnels/shared-installation.json` with the shared host's source binding, supported entry families, and `entryBindings` naming each installed application event, API invocation, or lifecycle entry by its exact `kind` and `key`. Setup submits that binding once using the existing workspace, integration, environment, and installation revision. It records progress after each accepted stage. If the file is absent, existing workspace installation evidence is preserved; creating another Funnel never requires this file or another catalog upload. The application must still verify the installed host and hooks at runtime before Setup marks them connected.
+
 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

package/dist/library.js

@@ -233553,7 +233553,7 @@ You are adding SaaSFunnels Direct API events to this customer application. Treat
 - Endpoint: \`${endpoint}\`
 - Auth header: \`Authorization: Bearer ${ingestKeyPlaceholder}\`
 - Environment variable: \`SAASFUNNELS_INGEST_API_KEY=${ingestKeyPlaceholder}\`
-- Help article: \`https://docs.saasfunnels.ai/integrations-and-sources/direct-api-installation\`
+- Help article: \`https://docs.saasfunnels.com/integrations-and-sources/direct-api-installation\`
 
 ## Direct API-first event discovery
 
@@ -235858,9 +235858,9 @@ function validateFeatureCatalogManifest(value) {
 
 // src/identity.ts
 var SAASFUNNELS_CLI_NAME = "saasfunnels";
-var SAASFUNNELS_CLI_VERSION = "0.5.0";
+var SAASFUNNELS_CLI_VERSION = "0.5.2";
 var SAASFUNNELS_PRODUCT_NAME = "SaaSFunnels";
-var SAASFUNNELS_DEFAULT_API_BASE_URL = "https://app.saasfunnels.ai";
+var SAASFUNNELS_DEFAULT_API_BASE_URL = "https://app.saasfunnels.com";
 var SAASFUNNELS_ENV = Object.freeze({
   apiBaseUrl: ["SAASFUNNELS_API_BASE_URL", "PREVENUE_API_BASE_URL"],
   apiKey: ["SAASFUNNELS_API_KEY", "PREVENUE_API_KEY"],

package/dist/saasfunnels.js

@@ -218902,6 +218902,10 @@ var require_dist = __commonJS({
 // src/saasfunnels.ts
 import { createInterface as createInterface2 } from "node:readline/promises";
 
+// src/cli.ts
+import { execFile as execFile5 } from "node:child_process";
+import { promisify as promisify5 } from "node:util";
+
 // src/setup-access.ts
 import { execFile } from "node:child_process";
 import { readFile } from "node:fs/promises";
@@ -234044,9 +234048,9 @@ function extractSetupPatch(source, catalog, baseline) {
 
 // src/identity.ts
 var SAASFUNNELS_CLI_NAME = "saasfunnels";
-var SAASFUNNELS_CLI_VERSION = "0.5.0";
+var SAASFUNNELS_CLI_VERSION = "0.5.2";
 var SAASFUNNELS_PRODUCT_NAME = "SaaSFunnels";
-var SAASFUNNELS_DEFAULT_API_BASE_URL = "https://app.saasfunnels.ai";
+var SAASFUNNELS_DEFAULT_API_BASE_URL = "https://app.saasfunnels.com";
 var SAASFUNNELS_ENV = Object.freeze({
   apiBaseUrl: ["SAASFUNNELS_API_BASE_URL", "PREVENUE_API_BASE_URL"],
   apiKey: ["SAASFUNNELS_API_KEY", "PREVENUE_API_KEY"],
@@ -234930,7 +234934,7 @@ You are adding SaaSFunnels Direct API events to this customer application. Treat
 - Endpoint: \`${endpoint}\`
 - Auth header: \`Authorization: Bearer ${ingestKeyPlaceholder}\`
 - Environment variable: \`SAASFUNNELS_INGEST_API_KEY=${ingestKeyPlaceholder}\`
-- Help article: \`https://docs.saasfunnels.ai/integrations-and-sources/direct-api-installation\`
+- Help article: \`https://docs.saasfunnels.com/integrations-and-sources/direct-api-installation\`
 
 ## Direct API-first event discovery
 
@@ -238214,6 +238218,7 @@ var contextSchema = external_exports.object({
   installationId: external_exports.string().nullable(),
   integrationId: external_exports.string().nullable(),
   environment: external_exports.enum(["test", "production"]),
+  sharedInstallation: external_exports.object({ registryRevision: external_exports.number().int().nonnegative().nullable(), fingerprint: external_exports.string().nullable(), verified: external_exports.boolean() }).optional(),
   catalogReady: external_exports.boolean(),
   planNames: external_exports.array(external_exports.string()),
   catalogPrices: external_exports.array(
@@ -238386,7 +238391,7 @@ async function runGuidedSetup(options) {
     })).run;
     if (!run) throw new Error("Setup did not return a run.");
     await mkdir3(join6(options.cwd, ".saasfunnels"), { recursive: true });
-    await writeFile3(
+    const saveRun = () => writeFile3(
       statePath,
       JSON.stringify(
         {
@@ -238394,13 +238399,32 @@ async function runGuidedSetup(options) {
           generation: context.generation,
           repositoryKey,
           revision,
-          runId: run.id
+          runId: run.id,
+          receipts: run.receipts
         },
         null,
         2
       ) + "\n",
       { mode: 384 }
     );
+    await saveRun();
+    try {
+      const shared = JSON.parse(await readFile6(join6(options.cwd, ".saasfunnels", "shared-installation.json"), "utf8"));
+      if (context.sharedInstallation?.registryRevision == null)
+        throw new Error("The app connection has not issued a verified identity yet. Complete its shared installation first.");
+      await request("/api/developer-tools/setup/installation", {
+        ...shared,
+        schemaVersion: 1,
+        installationId: context.installationId,
+        installationRevision: context.sharedInstallation.registryRevision,
+        integrationId: context.integrationId,
+        environment: context.environment,
+        repositoryKey,
+        repositoryRevision: head
+      });
+    } catch (error51) {
+      if (error51.code !== "ENOENT") throw error51;
+    }
     const update = (state, failureCode = null) => {
       progressState = state;
       progressFailure = failureCode;
@@ -238446,6 +238470,7 @@ async function runGuidedSetup(options) {
         if (typeof result3.sequence === "number")
           run.sequence = result3.sequence;
         run.receipts[currentStage] = result3.receipt ?? { complete: true };
+        await saveRun();
         if (currentStage === "plans")
           run.planNames = result3.planNames ?? evidence.plans.flatMap((plan) => [plan.key, plan.name]);
       });
@@ -238708,7 +238733,7 @@ async function runGuidedSetup(options) {
     }
     return {
       exitCode: 0,
-      stdout: `Discovery submitted. ${selection === "rejected" ? "This submission was rejected in Setup. Current findings and decisions are retained." : selection === "superseded" ? "A newer submission is selected in Setup. Current findings and decisions are retained." : selection === "complete_candidate" ? "Existing findings and decisions are retained; review proposed removals or finish the pending publication in Setup." : "Corrections are ready for review; unrelated records and saved decisions are retained."} Open https://app.saasfunnels.ai/app/setup. Configuration has not been published.
+      stdout: `Discovery submitted. ${selection === "rejected" ? "This submission was rejected in Setup. Current findings and decisions are retained." : selection === "superseded" ? "A newer submission is selected in Setup. Current findings and decisions are retained." : selection === "complete_candidate" ? "Existing findings and decisions are retained; review proposed removals or finish the pending publication in Setup." : "Corrections are ready for review; unrelated records and saved decisions are retained."} Open https://app.saasfunnels.com/app/setup. Configuration has not been published.
 `,
       stderr: ""
     };
@@ -240767,7 +240792,14 @@ async function commandFeatures(args, flags, options) {
   }
   if (args[0] === "handoff") {
     const path2 = flagString(flags, "file") ?? ".saasfunnels/catalog.yaml";
-    const repositoryRevision = flagString(flags, "repository-revision");
+    const gitValue = async (...args2) => {
+      try {
+        return (await promisify5(execFile5)("git", args2, { cwd: cwd(options), timeout: 5e3, maxBuffer: 8192 })).stdout.trim();
+      } catch {
+        return "";
+      }
+    };
+    const repositoryRevision = flagString(flags, "repository-revision") ?? await gitValue("rev-parse", "HEAD");
     if (!repositoryRevision) {
       return result(
         2,
@@ -240775,7 +240807,16 @@ async function commandFeatures(args, flags, options) {
         "Missing --repository-revision for the structured Feature handoff.\n"
       );
     }
-    const repositoryKey = flagString(flags, "repository-key");
+    let repositoryKey = flagString(flags, "repository-key");
+    if (!repositoryKey) {
+      const remote = await gitValue("remote", "get-url", "origin");
+      if (remote) {
+        try {
+          repositoryKey = safeRepositoryKey(remote);
+        } catch {
+        }
+      }
+    }
     if (!repositoryKey) {
       return result(
         2,
@@ -240796,10 +240837,32 @@ async function commandFeatures(args, flags, options) {
       );
     }
     const discoveryRoots = (flagString(flags, "discovery-roots") ?? "").split(",").map((root) => root.trim()).filter(Boolean);
-    const source = await filesystem(options).readFile(
-      resolve5(cwd(options), path2),
-      "utf8"
-    );
+    let source;
+    try {
+      source = await filesystem(options).readFile(resolve5(cwd(options), path2), "utf8");
+    } catch (error51) {
+      if (error51.code !== "ENOENT") throw error51;
+      const key4 = envValue2(options, SAASFUNNELS_ENV.apiKey);
+      if (key4 && !flagString(flags, "file")) {
+        const query = new URLSearchParams({ repositoryKey, repositoryRevision, environment: flagString(flags, "environment") ?? "production", ...flagString(flags, "discovery-roots") ? { discoveryRoots: JSON.stringify([...discoveryRoots].sort()) } : {} });
+        try {
+          const response = await (options.fetch ?? fetch)(`${apiBaseUrl2(options, flags)}/api/developer-tools/features/instrumentation?${query}`, { headers: { authorization: `Bearer ${key4}` }, signal: AbortSignal.timeout(15e3) });
+          if (response.ok) {
+            const evidence = await response.json();
+            if (evidence.reused === true) return jsonMode(flags) ? jsonResult(0, { reused: true, currentRevision: evidence.currentRevision === true, manifestFingerprint: evidence.manifestFingerprint, validatedAt: evidence.validatedAt }) : result(
+              0,
+              `Reused the existing workspace Feature evidence. No catalog was uploaded.${evidence.currentRevision ? "" : " This is the previous scan, not verification of this checkout; Setup shows any remaining review."} Open Setup to continue.
+`
+            );
+          } else if (response.status !== 404) {
+            return result(2, "", "Workspace Feature evidence could not be checked. Open Setup to check the connection and resume; your existing catalog has not changed.\n");
+          }
+        } catch {
+          return result(2, "", "Workspace Feature evidence could not be checked. Open Setup to check the connection and resume; your existing catalog has not changed.\n");
+        }
+      }
+      return result(2, "", "No local discovery file was found. Open Setup to reuse your workspace catalog and finish any missing connection steps. Do not recreate the catalog.\n");
+    }
     const validation = parseFeatureManifestSource(source);
     if (!validation.ok || !validation.manifest) {
       return jsonMode(flags) ? jsonResult(1, validation) : result(
@@ -241478,7 +241541,7 @@ async function runSaaSFunnelsCli(argv2, options = {}) {
       return result(0, usage());
     if (command === "init") return await commandInit(parsed.flags, options);
     if (command === "setup") {
-      const help = "SaaSFunnels setup\n\nRun npx --yes saasfunnels@latest setup in your app repository.\nIt checks access, asks before sending findings, and discovers features and plans for review.\nUse --resume after an interruption, or --env-file .env.local to load developer access.\nFor automation, supply SAASFUNNELS_API_KEY and explicit upload approval with --send --non-interactive.\nApp implementation, deployment and payment verification remain in https://app.saasfunnels.ai/app/setup.\n";
+      const help = "SaaSFunnels setup\n\nRun npx --yes saasfunnels@latest setup in your app repository.\nIt checks access, asks before sending findings, and discovers features and plans for review.\nUse --resume after an interruption, or --env-file .env.local to load developer access.\nFor automation, supply SAASFUNNELS_API_KEY and explicit upload approval with --send --non-interactive.\nApp implementation, deployment and payment verification remain in https://app.saasfunnels.com/app/setup.\n";
       if (hasFlag(parsed.flags, "help") || args[0] === "help") return result(0, help);
       if (args.length > 1 || args[0] && args[0] !== "run") return result(2, "", help);
       const interactive = !jsonMode(parsed.flags) && !hasFlag(parsed.flags, "non-interactive");

package/dist/types/identity.d.ts

@@ -1,7 +1,7 @@
 export declare const SAASFUNNELS_CLI_NAME = "saasfunnels";
-export declare const SAASFUNNELS_CLI_VERSION = "0.5.0";
+export declare const SAASFUNNELS_CLI_VERSION = "0.5.2";
 export declare const SAASFUNNELS_PRODUCT_NAME = "SaaSFunnels";
-export declare const SAASFUNNELS_DEFAULT_API_BASE_URL = "https://app.saasfunnels.ai";
+export declare const SAASFUNNELS_DEFAULT_API_BASE_URL = "https://app.saasfunnels.com";
 export declare const SAASFUNNELS_ENV: Readonly<{
     apiBaseUrl: string[];
     apiKey: string[];

package/dist/types/mcp.d.ts

@@ -77,7 +77,7 @@ export type SaaSFunnelsMcpOptions = {
     output?: Pick<NodeJS.WritableStream, "write">;
 };
 declare const mcpProtocolVersion = "2025-06-18";
-declare const mcpServerVersion = "0.5.0";
+declare const mcpServerVersion = "0.5.2";
 export declare function saasFunnelsMcpResources(): McpResourceDefinition[];
 export declare function readSaaSFunnelsMcpResource(uri: string, options?: SaaSFunnelsMcpOptions): string;
 export declare function saasFunnelsMcpToolDefinitions({ allowFunnelTests, allowFunnelWrites, allowTestWrites, includeHostedAccountTools, }?: {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "saasfunnels",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "private": false,
   "description": "SaaSFunnels CLI and local stdio MCP server",
   "author": "SaaSFunnels",
-  "homepage": "https://docs.saasfunnels.ai/developer-tools/saasfunnels-cli",
+  "homepage": "https://docs.saasfunnels.com/developer-tools/saasfunnels-cli",
   "bugs": {
-    "email": "support@saasfunnels.ai",
+    "email": "support@saasfunnels.com",
     "url": "https://github.com/LeadEngine-ai/saasfunnels-cli/issues"
   },
   "repository": {