swallowkit 1.1.2 → 2.0.0-alpha.10

package/dist/core/project/mcp-config.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Project-scoped MCP launcher version management.
+ *
+ * `.mcp.json` intentionally resolves `swallowkit@latest` so that projects created
+ * with older releases still get the current stable tools. A prerelease project can
+ * be newer than `latest`; in that case the launcher is pinned to the project
+ * version until a stable release that understands project-aware delegation catches up.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_LATEST = exports.MCP_VERSION_ENV = exports.MCP_CONFIG_PATH = void 0;
+exports.resolveMcpPinVersion = resolveMcpPinVersion;
+exports.lookupPublishedLatestVersion = lookupPublishedLatestVersion;
+exports.readMcpConfigVersion = readMcpConfigVersion;
+exports.writeMcpConfigVersion = writeMcpConfigVersion;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const semver_1 = require("../../utils/semver");
+exports.MCP_CONFIG_PATH = ".mcp.json";
+exports.MCP_VERSION_ENV = "SWALLOWKIT_MCP_VERSION";
+exports.MCP_LATEST = "latest";
+/**
+ * Decide the SWALLOWKIT_MCP_VERSION value for a project that uses `projectVersion`.
+ * Uses `latest` unless the project version is newer than the published `latest`.
+ * When the registry could not be reached, prereleases are pinned conservatively.
+ */
+function resolveMcpPinVersion(projectVersion, publishedLatest) {
+    if (!(0, semver_1.parseSemver)(projectVersion)) {
+        return { version: exports.MCP_LATEST, reason: `Project version ${projectVersion} is not a valid semantic version.` };
+    }
+    if (publishedLatest && (0, semver_1.parseSemver)(publishedLatest)) {
+        const comparison = (0, semver_1.compareSemver)(projectVersion, publishedLatest);
+        return comparison > 0
+            ? { version: projectVersion, reason: `Project version ${projectVersion} is newer than published latest ${publishedLatest}.` }
+            : { version: exports.MCP_LATEST, reason: `Published latest ${publishedLatest} is the same as or newer than project version ${projectVersion}.` };
+    }
+    return (0, semver_1.isPrerelease)(projectVersion)
+        ? { version: projectVersion, reason: `Published latest is unknown; prerelease ${projectVersion} is pinned so MCP matches the project.` }
+        : { version: exports.MCP_LATEST, reason: "Published latest is unknown; stable projects keep latest." };
+}
+function lookupPublishedLatestVersion(packageName, timeoutMs = 15000) {
+    // Run outside the project so its devEngines/packageManager policy does not reject npm.
+    const result = (0, child_process_1.spawnSync)("npm", ["view", `${packageName}@latest`, "version"], {
+        cwd: os.tmpdir(),
+        encoding: "utf8",
+        timeout: timeoutMs,
+        shell: process.platform === "win32",
+        stdio: ["ignore", "pipe", "ignore"],
+    });
+    if (result.error || result.status !== 0)
+        return null;
+    const version = String(result.stdout).trim().split(/\s+/).pop() ?? "";
+    return (0, semver_1.parseSemver)(version) ? version : null;
+}
+function readMcpConfigVersion(projectDir) {
+    const configPath = path.join(projectDir, exports.MCP_CONFIG_PATH);
+    if (!fs.existsSync(configPath))
+        return null;
+    try {
+        const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+        const value = config?.mcpServers?.swallowkit?.env?.[exports.MCP_VERSION_ENV];
+        return typeof value === "string" ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Update only the SwallowKit MCP version in .mcp.json, preserving all other content. */
+function writeMcpConfigVersion(projectDir, version) {
+    const configPath = path.join(projectDir, exports.MCP_CONFIG_PATH);
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`${exports.MCP_CONFIG_PATH} was not found. Run this command from a SwallowKit project root.`);
+    }
+    const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+    const server = config?.mcpServers?.swallowkit;
+    if (!server || typeof server !== "object") {
+        throw new Error(`${exports.MCP_CONFIG_PATH} does not define mcpServers.swallowkit.`);
+    }
+    server.env = { ...(server.env ?? {}), [exports.MCP_VERSION_ENV]: version };
+    fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`);
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/core/project/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../../../src/core/project/mcp-config.ts"],"names":[],"mappings":"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"}

package/dist/core/project/react-project.d.ts

@@ -0,0 +1,26 @@
+import { BackendLanguage } from "../../types";
+import { PackageManager } from "../../utils/package-manager";
+export declare function buildReactSwaConfig(): {
+    platform: {
+        apiRuntime: string;
+    };
+    navigationFallback: {
+        rewrite: string;
+        exclude: string[];
+    };
+    routes: {
+        route: string;
+        allowedRoles: string[];
+    }[];
+    globalHeaders: {
+        "X-Content-Type-Options": string;
+        "X-Frame-Options": string;
+    };
+};
+export declare function createReactProject(projectDir: string, projectName: string, pm?: PackageManager): void;
+export declare function createReactBffProject(projectDir: string, projectName: string, pm: PackageManager): void;
+export declare function buildReactBffBuildSource(): string;
+export declare function buildReactReadme(projectName: string, pm: PackageManager, backend: BackendLanguage): string;
+export declare function buildReactGitHubSwaWorkflow(pm: PackageManager): string;
+export declare function buildReactAzureSwaPipeline(pm: PackageManager): string;
+//# sourceMappingURL=react-project.d.ts.map

package/dist/core/project/react-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-project.d.ts","sourceRoot":"","sources":["../../../src/core/project/react-project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,EACL,cAAc,EAIf,MAAM,6BAA6B,CAAC;AAiBrC,wBAAgB,mBAAmB;;;;;;;;;;;;;;;;EAkBlC;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,EAAE,GAAE,cAAuB,GAC1B,IAAI,CAyKN;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,cAAc,GACjB,IAAI,CAqGN;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAkBjD;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,eAAe,GACvB,MAAM,CA8ER;AAgBD,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CA4CtE;AAED,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAkCrE"}

package/dist/core/project/react-project.js

@@ -0,0 +1,443 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildReactSwaConfig = buildReactSwaConfig;
+exports.createReactProject = createReactProject;
+exports.createReactBffProject = createReactBffProject;
+exports.buildReactBffBuildSource = buildReactBffBuildSource;
+exports.buildReactReadme = buildReactReadme;
+exports.buildReactGitHubSwaWorkflow = buildReactGitHubSwaWorkflow;
+exports.buildReactAzureSwaPipeline = buildReactAzureSwaPipeline;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const react_dev_1 = require("../../utils/react-dev");
+const python_uv_1 = require("../../utils/python-uv");
+const home_page_1 = require("./home-page");
+const package_manager_1 = require("../../utils/package-manager");
+const react_bff_generator_1 = require("../scaffold/react-bff-generator");
+function write(projectDir, relativePath, content) {
+    const destination = path.join(projectDir, ...relativePath.split(/[\\/]/));
+    fs.mkdirSync(path.dirname(destination), { recursive: true });
+    fs.writeFileSync(destination, content);
+}
+function buildReactSwaConfig() {
+    return {
+        platform: { apiRuntime: "node:20" },
+        navigationFallback: {
+            rewrite: "/index.html",
+            exclude: [
+                "/api/*",
+                "/.auth/*",
+                "/assets/*",
+                "/*.{css,js,json,ico,png,svg,txt}",
+            ],
+        },
+        routes: [{ route: "/*", allowedRoles: ["anonymous"] }],
+        globalHeaders: {
+            "X-Content-Type-Options": "nosniff",
+            "X-Frame-Options": "DENY",
+        },
+    };
+}
+function createReactProject(projectDir, projectName, pm = "pnpm") {
+    write(projectDir, "package.json", JSON.stringify({
+        name: projectName,
+        version: "0.1.0",
+        private: true,
+        scripts: { dev: "vite --port 3000", preview: "vite preview" },
+        dependencies: {
+            react: "^19.0.0",
+            "react-dom": "^19.0.0",
+            "react-router-dom": "^7.0.0",
+        },
+        devDependencies: {
+            "@types/node": "^22.0.0",
+            "@types/react": "^19.0.0",
+            "@types/react-dom": "^19.0.0",
+            "@vitejs/plugin-react": "^5.0.0",
+            vite: "^7.0.0",
+            typescript: "^5.9.0",
+            tailwindcss: "^4.0.0",
+            "@tailwindcss/vite": "^4.0.0",
+            "@azure/static-web-apps-cli": "^2.0.0",
+        },
+    }, null, 2));
+    write(projectDir, "tsconfig.json", JSON.stringify({
+        compilerOptions: {
+            target: "ES2022",
+            lib: ["ES2022", "DOM", "DOM.Iterable"],
+            module: "ESNext",
+            moduleResolution: "bundler",
+            jsx: "react-jsx",
+            strict: true,
+            noEmit: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            resolveJsonModule: true,
+            paths: { "@/*": ["./*"] },
+            types: ["vite/client"],
+        },
+        include: ["src", "lib"],
+        exclude: ["node_modules", "functions", "bff", "shared", "dist"],
+    }, null, 2));
+    write(projectDir, "vite.config.mts", `import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import tailwindcss from '@tailwindcss/vite';
+import { fileURLToPath, URL } from 'node:url';
+
+export default defineConfig({
+  plugins: [react(), tailwindcss()],
+  resolve: { alias: {
+    '@': fileURLToPath(new URL('.', import.meta.url)),
+    '@${projectName}/shared': fileURLToPath(new URL('./shared/index.ts', import.meta.url)),
+  } },
+  server: {
+    port: 3000,
+    strictPort: true,
+    watch: { ignored: ${(0, react_dev_1.buildReactDevWatchIgnoredSource)("fileURLToPath(new URL('.', import.meta.url))")} },
+  },
+  build: { outDir: 'dist' },
+});
+`);
+    write(projectDir, "index.html", `<!doctype html>
+<html lang="en" class="h-full antialiased">
+  <head><meta charset="UTF-8" /><meta name="viewport" content="width=device-width, initial-scale=1.0" /><title>SwallowKit</title></head>
+  <body class="min-h-full flex flex-col"><div id="root" class="flex flex-1 flex-col"></div><script type="module" src="/src/main.tsx"></script></body>
+</html>
+`);
+    write(projectDir, "src\\main.tsx", `import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import { BrowserRouter } from 'react-router-dom';
+import App from './App';
+import './style.css';
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode><BrowserRouter><App /></BrowserRouter></StrictMode>,
+);
+`);
+    write(projectDir, "src\\App.tsx", `import { useRoutes, type RouteObject } from 'react-router-dom';
+import Home from './Home';
+
+const modules = import.meta.glob<RouteObject[]>('./pages/**/routes.tsx', { eager: true, import: 'default' });
+const pages = import.meta.glob<{ default: React.ComponentType }>('./pages/login.tsx', { eager: true });
+const Login = pages['./pages/login.tsx']?.default;
+
+export default function App() {
+  return useRoutes([
+    { path: '/', element: <Home /> },
+    ...(Login ? [{ path: '/login', element: <Login /> }] : []),
+    ...Object.values(modules).flat(),
+    { path: '*', element: <main>Page not found</main> },
+  ]);
+}
+`);
+    write(projectDir, "src\\Home.tsx", (0, home_page_1.buildHomePage)("react", pm));
+    write(projectDir, "src\\style.css", `@import "tailwindcss";
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: Arial, Helvetica, sans-serif;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Arial, Helvetica, sans-serif;
+}
+`);
+    write(projectDir, "lib\\scaffold-config.ts", `export interface ScaffoldModel { name: string; path: string; label: string; }
+export const scaffoldConfig = {
+  models: [] as ScaffoldModel[]
+};
+`);
+    write(projectDir, ".gitignore", "node_modules/\ndist/\n.env*.local\nlocal.settings.json\n");
+}
+function createReactBffProject(projectDir, projectName, pm) {
+    write(projectDir, "bff\\package.json", JSON.stringify({
+        name: "bff",
+        private: true,
+        version: "1.0.0",
+        description: "SWA managed HTTP-only Functions BFF (not the standalone backend)",
+        engines: { node: ">=20" },
+        scripts: {
+            build: "tsc --noEmit && node build.cjs",
+            start: "func start --port 7073",
+            prestart: `${pm} run build`,
+        },
+        devDependencies: {
+            "@azure/functions": "^3.5.0",
+            "@types/node": "^22.0.0",
+            typescript: "^5.9.0",
+            esbuild: "^0.25.0",
+            [`@${projectName}/shared`]: pm === "pnpm" ? "workspace:*" : "file:../shared",
+            zod: "^4.0.0",
+        },
+    }, null, 2));
+    write(projectDir, "bff\\build.cjs", buildReactBffBuildSource());
+    write(projectDir, "bff\\tsconfig.json", JSON.stringify({
+        compilerOptions: {
+            target: "ES2022",
+            lib: ["ES2022", "DOM"],
+            module: "Node16",
+            moduleResolution: "Node16",
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            noEmit: true,
+        },
+        include: ["src/**/*.ts"],
+    }, null, 2));
+    // Classic function.json registrations work with SWA's managed Functions runtime.
+    write(projectDir, "bff\\host.json", JSON.stringify({ version: "2.0", extensions: { http: { routePrefix: "api" } } }, null, 2));
+    write(projectDir, "bff\\local.settings.json", JSON.stringify({
+        IsEncrypted: false,
+        Values: {
+            FUNCTIONS_WORKER_RUNTIME: "node",
+            BACKEND_FUNCTIONS_BASE_URL: "http://localhost:7071",
+            BACKEND_FUNCTIONS_KEY: "",
+        },
+        Host: { LocalHttpPort: 7073, CORS: "http://localhost:4280" },
+    }, null, 2));
+    write(projectDir, "bff\\.gitignore", "node_modules/\ndist/\nlocal.settings.json\n");
+    write(projectDir, "bff\\.funcignore", "src/\nnode_modules/\nlocal.settings.json\ntsconfig.json\nbuild.cjs\n.gitignore\n");
+    write(projectDir, "bff\\src\\lib\\call-function.ts", (0, react_bff_generator_1.generateReactBffHelper)(projectName));
+    write(projectDir, "bff\\src\\greet\\index.ts", (0, react_bff_generator_1.generateReactGreetBff)());
+    write(projectDir, "bff\\greet\\function.json", (0, react_bff_generator_1.generateManagedFunctionConfig)("greet", ["GET", "POST"], "greet"));
+}
+function buildReactBffBuildSource() {
+    return `const fs = require('node:fs');
+const path = require('node:path');
+const { buildSync } = require('esbuild');
+
+const entryPoints = fs.readdirSync(path.join(__dirname, 'src'), { withFileTypes: true })
+  .filter(entry => entry.isDirectory() && fs.existsSync(path.join(__dirname, 'src', entry.name, 'index.ts')))
+  .map(entry => path.join('src', entry.name, 'index.ts'));
+if (!entryPoints.length) throw new Error('No managed BFF handlers found');
+buildSync({
+  absWorkingDir: __dirname, entryPoints, bundle: true,
+  platform: 'node', target: 'node20', outbase: 'src', outdir: 'dist', logLevel: 'info',
+});
+for (const entry of entryPoints) {
+  const output = path.join(__dirname, 'dist', path.basename(path.dirname(entry)), 'index.js');
+  if (!fs.existsSync(output)) throw new Error('Missing managed BFF bundle: ' + output);
+}
+`;
+}
+function buildReactReadme(projectName, pm, backend) {
+    const cmd = (0, package_manager_1.getCommands)(pm);
+    return `# ${projectName}
+
+Generated by SwallowKit: React + Vite + TypeScript on Azure Static Web Apps.
+
+## Architecture
+
+Browser → React SPA → /api (SWA managed Functions BFF) → standalone ${backend} Functions → Cosmos DB.
+
+- \`src/\`: React Router UI. No Next.js runtime.
+- \`bff/\`: HTTP-only SWA managed Functions. Validates shared schemas and forwards requests; no database/business logic.
+- \`functions/\`: independently deployed backend, NOT linked to SWA.
+- \`shared/models/\`: Zod source of truth.
+- \`infra/\`: Bicep infrastructure.
+
+Only the BFF reads BACKEND_FUNCTIONS_BASE_URL and BACKEND_FUNCTIONS_KEY.
+Never put those values in VITE_* variables or client code.
+
+## Develop
+
+\`\`\`sh
+${cmd.exec} swallowkit create-model todo
+${cmd.exec} swallowkit scaffold todo
+${cmd.exec} swallowkit dev
+\`\`\`
+
+Use http://localhost:4280, not Vite's direct port, for same-origin UI/BFF requests.
+Dev starts Vite (3000), the managed BFF (7073), the standalone Functions (7071),
+and SWA CLI (4280). \`--bff-port\`, \`--port\`, \`--functions-port\`, and \`--swa-port\` override ports.
+The BFF stays separate even with \`--no-functions\`; \`--no-swa\` starts only the
+direct Vite/BFF servers (no same-origin API routing or SWA authentication).
+Core Tools v4 must already be available. Start Cosmos DB Emulator manually if
+this application needs Cosmos; SwallowKit never starts it.
+${backend === "python" ? `
+Python environments use normal uv discovery and user settings, including installed
+Python, \`.python-version\`, and \`UV_PYTHON\`. Local Python is not pinned to the Azure
+deployment runtime (${python_uv_1.DEFAULT_AZURE_PYTHON_VERSION}). Functions uses \`functions/.venv\`; scaffold uses
+\`functions/.codegen-venv\`. Existing environments are never cleared automatically.
+When switching interpreters, explicitly recreate them with uv. Do not disable
+Windows application-control policy to run an unsigned interpreter.
+` : backend === "csharp" ? `
+The .NET isolated backend starts with \`dotnet run\` so extensions are loaded from
+the build output. Vite does not watch \`functions/\` or \`bff/\` build artifacts.
+` : ""}
+
+Local BFF settings live in \`bff/local.settings.json\` (gitignored). Backend settings
+live in \`functions/local.settings.json\`. Keep their secrets out of source control.
+\`--mock-connectors\` still routes through the BFF and mocks only connector data.
+
+## Verify
+
+\`\`\`sh
+${pm} run build
+${cmd.exec} swallowkit machine verify project
+${cmd.exec} swallowkit machine verify project --checks "structure,drift,typecheck,backend-build,build"
+\`\`\`
+
+The build compiles shared schemas, checks the SPA, builds static assets, and
+typechecks/bundles the managed BFF. Exercise CRUD and authentication through
+the SWA port as well; structural verification is not an end-to-end test.
+
+## Deploy
+
+Use the generated GitHub Actions / Azure Pipelines workflows when selected.
+Deploy \`dist/\` as the static app and \`bff/\` as its managed API, with
+\`skip_app_build: true\` and \`skip_api_build: true\` after \`${pm} run build\`.
+BFF bundles include shared schemas and Zod, so no workspace install is needed
+in SWA's API build. Deploy \`functions/\` independently, never as SWA's api_location.
+Do NOT link the standalone Functions app to SWA.
+
+After approved provisioning and backend deployment, apply the generated SWA
+appsettings module with the backend URL/key. The key is required for remote
+Functions calls, and stays server-side. SPA deep links use navigationFallback;
+/api and /.auth are excluded so missing APIs never become index.html.
+
+See AGENTS.md for ownership, plan/apply, authentication, and verification guidance.
+`;
+}
+const REACT_DEPLOY_PATHS = [
+    "src/**",
+    "bff/**",
+    "lib/**",
+    "shared/**",
+    "public/**",
+    "index.html",
+    "vite.config.mts",
+    "tsconfig.json",
+    "staticwebapp.config.json",
+    "package.json",
+    "pnpm-workspace.yaml",
+];
+function buildReactGitHubSwaWorkflow(pm) {
+    const paths = [
+        ...REACT_DEPLOY_PATHS,
+        pm === "pnpm" ? "pnpm-lock.yaml" : "package-lock.json",
+        ".github/workflows/deploy-swa.yml",
+    ];
+    return `name: Deploy React SPA and managed BFF
+on:
+  push:
+    branches: [main]
+    paths:
+${paths.map((entry) => `      - '${entry}'`).join("\n")}
+  pull_request:
+    branches: [main]
+    paths:
+${paths.map((entry) => `      - '${entry}'`).join("\n")}
+  workflow_dispatch:
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+${(0, package_manager_1.getCiSetupStep)(pm)}
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: ${pm}
+      - name: Build SPA and managed BFF
+        run: |
+          ${(0, package_manager_1.getCommands)(pm).ci}
+          ${pm} run build
+      - name: Deploy SPA and managed BFF (standalone Functions are NOT linked)
+        if: (github.event_name == 'push' || github.event_name == 'workflow_dispatch') && github.ref == 'refs/heads/main'
+        uses: Azure/static-web-apps-deploy@v1
+        with:
+          azure_static_web_apps_api_token: \${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}
+          repo_token: \${{ secrets.GITHUB_TOKEN }}
+          action: upload
+          app_location: dist
+          api_location: bff
+          output_location: ''
+          skip_app_build: true
+          skip_api_build: true
+`;
+}
+function buildReactAzureSwaPipeline(pm) {
+    return `trigger:
+  branches:
+    include: [main]
+  paths:
+    include:
+${[...REACT_DEPLOY_PATHS, pm === "pnpm" ? "pnpm-lock.yaml" : "package-lock.json", "pipelines/swa.yml"].map((entry) => `      - '${entry}'`).join("\n")}
+pr:
+  branches:
+    include: [main]
+pool:
+  vmImage: ubuntu-latest
+variables:
+  - group: azure-deployment
+steps:
+  - task: NodeTool@0
+    inputs:
+      versionSpec: '22.x'
+${(0, package_manager_1.getAzurePipelinesSetup)(pm)}
+  - script: |
+      ${(0, package_manager_1.getCommands)(pm).ci}
+      ${pm} run build
+    displayName: Build React SPA and managed BFF
+  - task: AzureStaticWebApp@0
+    condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
+    inputs:
+      app_location: dist
+      api_location: bff
+      output_location: ''
+      skip_app_build: true
+      skip_api_build: true
+      azure_static_web_apps_api_token: $(AZURE_STATIC_WEB_APPS_API_TOKEN)
+    displayName: Deploy SPA and managed BFF (standalone Functions are NOT linked)
+`;
+}
+//# sourceMappingURL=react-project.js.map

package/dist/core/project/react-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-project.js","sourceRoot":"","sources":["../../../src/core/project/react-project.ts"],"names":[],"mappings":"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"}

package/dist/core/project/state.d.ts

@@ -10,6 +10,13 @@ export declare function savePlanState<TPlan extends {
 }>(plan: TPlan, projectRoot?: string): void;
 export declare function loadPlanState<TPlan>(planId: string, projectRoot?: string): TPlan | null;
 export declare function deletePlanState(planId: string, projectRoot?: string): void;
+export declare function saveProvisionRun<T extends {
+    runId: string;
+}>(run: T, projectRoot?: string): void;
+export declare function loadProvisionRun<T>(runId: string, projectRoot?: string): T | null;
+export declare function listProvisionRuns<T>(projectRoot?: string): T[];
+/** A live local executor must not share an Azure target with another executor. */
+export declare function lockProvisionTarget(key: string, projectRoot?: string): () => void;
 export declare function saveLastVerifyState(result: unknown, projectRoot?: string): void;
 export declare function loadLastVerifyState<TResult>(projectRoot?: string): TResult | null;
 //# sourceMappingURL=state.d.ts.map

package/dist/core/project/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/core/project/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,oBAAoB,QAAoC,CAAC;AAqBtE,wBAAgB,aAAa,CAAC,KAAK,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5D,IAAI,EAAE,KAAK,EACX,WAAW,GAAE,MAAsB,GAClC,IAAI,CAGN;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAE,MAAsB,GAAG,KAAK,GAAG,IAAI,CAWtG;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,GAAE,MAAsB,GAAG,IAAI,CAKzF;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,GAAE,MAAsB,GAAG,IAAI,CAG9F;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAE,MAAsB,GAAG,OAAO,GAAG,IAAI,CAUhG"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/core/project/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,oBAAoB,QAAoC,CAAC;AAqBtE,wBAAgB,aAAa,CAAC,KAAK,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5D,IAAI,EAAE,KAAK,EACX,WAAW,GAAE,MAAsB,GAClC,IAAI,CAGN;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAE,MAAsB,GAAG,KAAK,GAAG,IAAI,CAWtG;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,GAAE,MAAsB,GAAG,IAAI,CAKzF;AAOD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,CAAC,EAAE,WAAW,GAAE,MAAsB,GAAG,IAAI,CAO/G;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,MAAsB,GAAG,CAAC,GAAG,IAAI,CAKhG;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAE,MAAsB,GAAG,CAAC,EAAE,CAK7E;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,GAAE,MAAsB,GAAG,MAAM,IAAI,CAuChG;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,GAAE,MAAsB,GAAG,IAAI,CAG9F;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAE,MAAsB,GAAG,OAAO,GAAG,IAAI,CAUhG"}