saasfunnels 0.5.0 → 0.5.1

package/README.md

@@ -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

@@ -235858,7 +235858,7 @@ function validateFeatureCatalogManifest(value) {
 
 // src/identity.ts
 var SAASFUNNELS_CLI_NAME = "saasfunnels";
-var SAASFUNNELS_CLI_VERSION = "0.5.0";
+var SAASFUNNELS_CLI_VERSION = "0.5.1";
 var SAASFUNNELS_PRODUCT_NAME = "SaaSFunnels";
 var SAASFUNNELS_DEFAULT_API_BASE_URL = "https://app.saasfunnels.ai";
 var SAASFUNNELS_ENV = Object.freeze({

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,7 +234048,7 @@ 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.1";
 var SAASFUNNELS_PRODUCT_NAME = "SaaSFunnels";
 var SAASFUNNELS_DEFAULT_API_BASE_URL = "https://app.saasfunnels.ai";
 var SAASFUNNELS_ENV = Object.freeze({
@@ -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]);
       });
@@ -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(

package/dist/types/identity.d.ts

@@ -1,5 +1,5 @@
 export declare const SAASFUNNELS_CLI_NAME = "saasfunnels";
-export declare const SAASFUNNELS_CLI_VERSION = "0.5.0";
+export declare const SAASFUNNELS_CLI_VERSION = "0.5.1";
 export declare const SAASFUNNELS_PRODUCT_NAME = "SaaSFunnels";
 export declare const SAASFUNNELS_DEFAULT_API_BASE_URL = "https://app.saasfunnels.ai";
 export declare const SAASFUNNELS_ENV: Readonly<{

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.1";
 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,6 +1,6 @@
 {
   "name": "saasfunnels",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "private": false,
   "description": "SaaSFunnels CLI and local stdio MCP server",
   "author": "SaaSFunnels",