swallowkit 1.0.0-beta.22 → 1.0.0-beta.24

package/README.ja.md

@@ -22,8 +22,8 @@ Zod スキーマから自動的に CRUD 操作を生成する Scaffold 機能を
 - **🔄 Zod スキーマ共有** - フロントエンド、BFF、Azure Functions、Cosmos DB をまたいで Zod を唯一のソースとして維持
 - **⚡ CRUD コード生成** - `swallowkit scaffold` で Azure Functions + Next.js コードを自動生成
 - **🌐 Functions バックエンド多言語対応** - `init` 時に Azure Functions の言語として TypeScript、C#、Python を選択可能
-- **🧬 OpenAPI スキーマブリッジ** - C#/Python バックエンドでは `scaffold` が Zod から OpenAPI を出力し、各言語向けスキーマ資産を生成
-- **🛡️ 契約安全性** - 共有 Zod または OpenAPI 由来のモデルにより、フロント/BFF とバックエンドの契約を整合
+- **🧬 OpenAPI 出力 + ネイティブコード生成** - C#/Python バックエンドでは `scaffold` が Zod から OpenAPI を出力し、各言語のネイティブツールでスキーマ資産を生成
+- **🛡️ 契約安全性** - 共有 Zod またはネイティブ生成されたモデルにより、フロント/BFF とバックエンドの契約を整合
 - **🎯 BFF パターン** - Next.js API Routes が BFF レイヤーとして機能、自動検証・リソース名推論
 - **☁️ Azure 最適化** - Static Web Apps + Functions + Cosmos DB で最小コスト構成
 - **🚀 簡単デプロイ** - Bicep IaC + CI/CD ワークフローを自動生成
@@ -132,7 +132,7 @@ pnpm dlx swallowkit scaffold shared/models/todo.ts
 - ✅ Next.js BFF API Routes (自動検証・リソース名推論)
 - ✅ React コンポーネント (型安全なフォーム)
 
-`init` で `csharp` または `python` を選んだ場合、`swallowkit scaffold` はあわせて `functions/openapi/` に OpenAPI ドキュメントを出力し、`functions/generated/` に各言語向けスキーマ資産を生成します。
+`init` で `csharp` または `python` を選んだ場合、`swallowkit scaffold` はあわせて `functions/openapi/` に OpenAPI ドキュメントを出力し、`functions/generated/` にネイティブ生成された各言語向けスキーマ資産を生成します。
 
 ### 4. 開発サーバー起動
 
@@ -145,6 +145,11 @@ pnpm dlx swallowkit dev
 - Next.js: http://localhost:3000
 - Azure Functions: http://localhost:7071
 
+バックエンド言語ごとの補足:
+
+- **Python バックエンド**: `swallowkit dev` はローカルの Python 実行環境管理に **uv** を使います。プロジェクト内の `.uv/bin` に `uv` 本体を導入または再利用し、`.uv/python` に uv 管理の Python を保持し、Functions 本体用に `functions/.venv`、Python スキーマ生成用に `functions/.codegen-venv` を作成します。
+- **C# バックエンド**: Azure Functions isolated worker はコールドスタート時にワーカービルドが入るため、応答開始まで少し時間がかかることがあります。`swallowkit dev` は Functions ホストが HTTP 応答できる状態になるまで待ってから、バックエンド URL を ready として表示します。
+
 ### 5. フロントエンドから使用
 
 ```typescript
@@ -255,7 +260,7 @@ MCP server は explicit な Tool だけを公開する薄い adapter で、実
 **重要なパターン:**
 - **BFF (Backend For Frontend)**: Next.js API Routes が Azure Functions へのプロキシ
 - **共有スキーマ**: `shared/models/` の Zod スキーマを唯一のソースとして扱う
-- **C#/Python 向け OpenAPI ブリッジ**: TypeScript 以外の Functions は `functions/generated/` の生成資産を利用
+- **C#/Python 向け OpenAPI 出力**: TypeScript 以外の Functions は `functions/generated/` のネイティブ生成資産を利用
 - **外部コネクタ**: MySQL・PostgreSQL・REST API — scaffold 生成の Functions で同じ BFF パターンを維持
 - **契約安全性**: 共有 Zod または生成モデルで BFF とバックエンドの整合を保つ
 - **マネージド ID**: サービス間の安全な接続（接続文字列不要）

package/README.md

@@ -24,8 +24,8 @@ Featuring Scaffold functionality to automatically generate CRUD operations from
 - **🔄 Zod Schema Sharing** - Keep Zod as the source of truth across frontend, BFF, Azure Functions, and Cosmos DB
 - **⚡ CRUD Code Generation** - Auto-generate Azure Functions + Next.js code with `swallowkit scaffold`
 - **🌐 Multi-language Functions Backends** - Choose TypeScript, C#, or Python for Azure Functions during `init`
-- **🧬 OpenAPI Schema Bridge** - For C#/Python backends, `scaffold` exports OpenAPI from Zod and generates backend schema assets
-- **🛡️ Contract Safety** - Keep frontend/BFF contracts aligned with backend implementations through shared Zod or generated OpenAPI-derived models
+- **🧬 OpenAPI Export + Native Codegen** - For C#/Python backends, `scaffold` exports OpenAPI from Zod and generates backend schema assets with native language tooling
+- **🛡️ Contract Safety** - Keep frontend/BFF contracts aligned with backend implementations through shared Zod or native-generated backend models
 - **🎯 BFF Pattern** - Next.js API Routes as BFF layer with auto-validation and resource inference
 - **☁️ Azure Optimized** - Minimal-cost architecture with Static Web Apps + Functions + Cosmos DB
 - **🚀 Easy Deployment** - Auto-generated Bicep IaC + CI/CD workflows
@@ -133,7 +133,7 @@ This auto-generates:
 - ✅ Next.js BFF API Routes (auto-validation + resource inference)
 - ✅ React Components (type-safe forms)
 
-If you selected `csharp` or `python` at `init` time, `swallowkit scaffold` also writes an OpenAPI document under `functions/openapi/` and generates backend schema assets under `functions/generated/`.
+If you selected `csharp` or `python` at `init` time, `swallowkit scaffold` also writes an OpenAPI document under `functions/openapi/` and generates native backend schema assets under `functions/generated/`.
 
 ### 4. Start Development Server
 
@@ -146,6 +146,11 @@ pnpm dlx swallowkit dev
 - Next.js: http://localhost:3000
 - Azure Functions: http://localhost:7071
 
+Backend-specific notes:
+
+- **Python backends**: `swallowkit dev` uses **uv** for local runtime management. It installs or reuses a project-local `uv` binary under `.uv/bin`, keeps uv-managed Python under `.uv/python`, creates `functions/.venv` for the Functions app, and creates `functions/.codegen-venv` for Python schema generation.
+- **C# backends**: Azure Functions isolated worker can take longer to answer on cold start while the worker build completes. `swallowkit dev` waits for the Functions host to start responding before it prints the backend URL as ready.
+
 If you want to replace Cosmos DB Emulator data before startup, generate an environment template and then launch `dev` with that environment:
 
 ```bash
@@ -312,7 +317,7 @@ The MCP server is intentionally a thin adapter with explicit tools only. It dele
 **Key Patterns:**
 - **BFF (Backend For Frontend)**: Next.js API Routes proxy to Azure Functions
 - **Shared Schemas**: Zod schemas stay in `shared/models/` as the source of truth
-- **OpenAPI Bridge for C#/Python**: Non-TypeScript Functions consume generated assets under `functions/generated/`
+- **OpenAPI Export for C#/Python**: Non-TypeScript Functions consume native-generated assets under `functions/generated/`
 - **External Connectors**: MySQL, PostgreSQL, REST APIs — scaffold-generated Functions with the same BFF pattern
 - **Contract Safety**: BFF and backend stay aligned through shared Zod or generated backend models
 - **Managed Identity**: Secure service connections (no connection strings)

package/dist/cli/commands/dev.d.ts

@@ -1,4 +1,5 @@
 import { Command } from 'commander';
+import { BackendLanguage } from '../../types';
 export interface DevOptions {
     port?: string;
     functionsPort?: string;
@@ -9,14 +10,27 @@ export interface DevOptions {
     seedEnv?: string;
     mockConnectors?: boolean;
 }
+interface FunctionsCoreToolsCommand {
+    command: string;
+    argsPrefix: string[];
+    label: string;
+}
 export declare function buildFunctionsStartArgs(functionsPort: string): string[];
+export declare function parseCoreToolsVersion(output: string): string | null;
+export declare function compareVersionNumbers(left: string, right: string): number;
+export declare function buildFunctionsCoreToolsCommand(backendLanguage: BackendLanguage, installedVersion: string | null): FunctionsCoreToolsCommand;
 export declare function buildNextDevArgs(pm: string, port: string): string[];
+export declare function buildFunctionsBaseUrl(host: string | undefined, functionsPort: string): string;
+export declare function getFunctionsReadinessTimeoutMs(backendLanguage: BackendLanguage): number;
+export declare function waitForHttpServerReady(url: string, timeoutMs?: number, intervalMs?: number): Promise<boolean>;
 export declare function getPythonVirtualEnvPaths(functionsDir: string): {
     venvDir: string;
     binDir: string;
     pythonExecutable: string;
 };
+export declare function getCSharpFunctionsBuildArtifactPaths(functionsDir: string): string[];
 export declare function buildPythonFunctionsEnv(baseEnv: NodeJS.ProcessEnv, functionsDir: string): NodeJS.ProcessEnv;
 export declare function buildDevCommand(runDevEnvironment?: (options: DevOptions) => Promise<void>, verifyProject?: (commandName: string, projectRoot?: string) => void): Command;
 export declare const devCommand: Command;
+export {};
 //# sourceMappingURL=dev.d.ts.map

package/dist/cli/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAaD,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGnE;AAED,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAUA;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CAW3G;AAgQD,wBAAgB,eAAe,CAC7B,iBAAiB,GAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAuB,EAC/E,aAAa,GAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,IAA8B,GAC3F,OAAO,CAyBT;AAED,eAAO,MAAM,UAAU,SAAoB,CAAC"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAa9C,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAMD,UAAU,yBAAyB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAYD,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAezE;AAED,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,yBAAyB,CAqB3B;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAE7F;AAED,wBAAgB,8BAA8B,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,CAEvF;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,SAAS,SAAS,EAClB,UAAU,SAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAUA;AAED,wBAAgB,oCAAoC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAKnF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CAW3G;AAsTD,wBAAgB,eAAe,CAC7B,iBAAiB,GAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAuB,EAC/E,aAAa,GAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,IAA8B,GAC3F,OAAO,CAyBT;AAED,eAAO,MAAM,UAAU,SAAoB,CAAC"}

package/dist/cli/commands/dev.js

@@ -35,12 +35,21 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.devCommand = void 0;
 exports.buildFunctionsStartArgs = buildFunctionsStartArgs;
+exports.parseCoreToolsVersion = parseCoreToolsVersion;
+exports.compareVersionNumbers = compareVersionNumbers;
+exports.buildFunctionsCoreToolsCommand = buildFunctionsCoreToolsCommand;
 exports.buildNextDevArgs = buildNextDevArgs;
+exports.buildFunctionsBaseUrl = buildFunctionsBaseUrl;
+exports.getFunctionsReadinessTimeoutMs = getFunctionsReadinessTimeoutMs;
+exports.waitForHttpServerReady = waitForHttpServerReady;
 exports.getPythonVirtualEnvPaths = getPythonVirtualEnvPaths;
+exports.getCSharpFunctionsBuildArtifactPaths = getCSharpFunctionsBuildArtifactPaths;
 exports.buildPythonFunctionsEnv = buildPythonFunctionsEnv;
 exports.buildDevCommand = buildDevCommand;
 const commander_1 = require("commander");
 const child_process_1 = require("child_process");
+const http = __importStar(require("http"));
+const https = __importStar(require("https"));
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
@@ -49,7 +58,10 @@ const cosmos_1 = require("@azure/cosmos");
 const config_1 = require("../../core/config");
 const dev_seeds_1 = require("./dev-seeds");
 const package_manager_1 = require("../../utils/package-manager");
+const python_uv_1 = require("../../utils/python-uv");
 const connector_mock_server_1 = require("../../core/mock/connector-mock-server");
+const MINIMUM_CSHARP_CORE_TOOLS_VERSION = '4.6.0';
+const NPM_CORE_TOOLS_PACKAGE = 'azure-functions-core-tools@4';
 function normalizeParsedDevOptions(options) {
     return {
         ...options,
@@ -59,10 +71,64 @@ function normalizeParsedDevOptions(options) {
 function buildFunctionsStartArgs(functionsPort) {
     return ['start', '--port', functionsPort];
 }
+function parseCoreToolsVersion(output) {
+    const match = output.match(/\d+\.\d+\.\d+/);
+    return match ? match[0] : null;
+}
+function compareVersionNumbers(left, right) {
+    const leftParts = left.split('.').map((value) => Number.parseInt(value, 10));
+    const rightParts = right.split('.').map((value) => Number.parseInt(value, 10));
+    const length = Math.max(leftParts.length, rightParts.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftPart = leftParts[index] ?? 0;
+        const rightPart = rightParts[index] ?? 0;
+        if (leftPart !== rightPart) {
+            return leftPart - rightPart;
+        }
+    }
+    return 0;
+}
+function buildFunctionsCoreToolsCommand(backendLanguage, installedVersion) {
+    if (backendLanguage === 'csharp' &&
+        (!installedVersion || compareVersionNumbers(installedVersion, MINIMUM_CSHARP_CORE_TOOLS_VERSION) < 0)) {
+        const reason = installedVersion
+            ? `installed func ${installedVersion} is too old for C# isolated`
+            : 'func is not installed';
+        return {
+            command: 'npm',
+            argsPrefix: ['exec', '--yes', NPM_CORE_TOOLS_PACKAGE, '--'],
+            label: `npm exec ${NPM_CORE_TOOLS_PACKAGE} (${reason})`,
+        };
+    }
+    return {
+        command: 'func',
+        argsPrefix: [],
+        label: installedVersion ? `func ${installedVersion}` : 'func',
+    };
+}
 function buildNextDevArgs(pm, port) {
     const baseArgs = ['next', 'dev', '--port', port, '--webpack'];
     return pm === 'pnpm' ? ['exec', ...baseArgs] : baseArgs;
 }
+function buildFunctionsBaseUrl(host, functionsPort) {
+    return `http://${host || 'localhost'}:${functionsPort}`;
+}
+function getFunctionsReadinessTimeoutMs(backendLanguage) {
+    return backendLanguage === 'csharp' ? 90000 : 30000;
+}
+async function waitForHttpServerReady(url, timeoutMs = 30000, intervalMs = 500) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() <= deadline) {
+        if (await probeHttpServer(url)) {
+            return true;
+        }
+        if (Date.now() + intervalMs > deadline) {
+            break;
+        }
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+    return probeHttpServer(url);
+}
 function getPythonVirtualEnvPaths(functionsDir) {
     const venvDir = path.join(functionsDir, '.venv');
     const binDir = process.platform === 'win32'
@@ -73,6 +139,12 @@ function getPythonVirtualEnvPaths(functionsDir) {
         : path.join(binDir, 'python');
     return { venvDir, binDir, pythonExecutable };
 }
+function getCSharpFunctionsBuildArtifactPaths(functionsDir) {
+    return [
+        path.join(functionsDir, 'bin'),
+        path.join(functionsDir, 'obj'),
+    ];
+}
 function buildPythonFunctionsEnv(baseEnv, functionsDir) {
     const { venvDir, binDir, pythonExecutable } = getPythonVirtualEnvPaths(functionsDir);
     const pathKey = getPathEnvKey(baseEnv);
@@ -101,10 +173,12 @@ function prependToPathEnv(env, entry) {
 async function checkCoreTools() {
     return checkCommand('func', ['--version']);
 }
-async function checkCommand(command, args = ['--version']) {
+async function checkCommand(command, args = ['--version'], options) {
     return new Promise((resolve) => {
         const checkProcess = (0, child_process_1.spawn)(command, args, {
-            shell: true,
+            cwd: options?.cwd,
+            env: options?.env ?? process.env,
+            shell: options?.shell ?? true,
             stdio: 'pipe',
         });
         checkProcess.on('close', (code) => {
@@ -115,22 +189,22 @@ async function checkCommand(command, args = ['--version']) {
         });
     });
 }
-async function resolvePythonBootstrapCommand() {
-    const candidates = process.platform === 'win32'
-        ? [
-            { command: 'py', argsPrefix: ['-3.11'], label: 'py -3.11' },
-            { command: 'python', argsPrefix: [], label: 'python' },
-        ]
-        : [
-            { command: 'python3', argsPrefix: [], label: 'python3' },
-            { command: 'python', argsPrefix: [], label: 'python' },
-        ];
-    for (const candidate of candidates) {
-        if (await checkCommand(candidate.command, [...candidate.argsPrefix, '--version'])) {
-            return candidate;
-        }
+async function resolveProjectLocalUvCommand(projectRoot) {
+    const uvEnv = (0, python_uv_1.buildProjectLocalUvEnv)(process.env, projectRoot);
+    const { localUvExecutable } = (0, python_uv_1.getProjectLocalUvPaths)(projectRoot);
+    if (await checkCommand('uv', ['--version'], { shell: false })) {
+        return { command: 'uv', env: uvEnv };
     }
-    throw new Error('Python 3.11 was not found. Install Python 3.11 and make sure `python`, `python3`, or `py -3.11` is available.');
+    if (fs.existsSync(localUvExecutable) && await checkCommand(localUvExecutable, ['--version'], { shell: false })) {
+        return { command: localUvExecutable, env: uvEnv };
+    }
+    console.log('📦 Installing project-local uv...');
+    const installer = (0, python_uv_1.getProjectLocalUvInstallerCommand)();
+    await runCommand(installer.command, installer.args, projectRoot, 'uv installation', (0, python_uv_1.buildProjectLocalUvInstallerEnv)(process.env, projectRoot), false);
+    if (!(fs.existsSync(localUvExecutable) && await checkCommand(localUvExecutable, ['--version'], { shell: false }))) {
+        throw new Error('Failed to install project-local uv.');
+    }
+    return { command: localUvExecutable, env: uvEnv };
 }
 async function getCommandPath(command) {
     const locator = process.platform === 'win32' ? 'where' : 'which';
@@ -141,6 +215,17 @@ async function getCommandPath(command) {
         .find(Boolean);
     return firstLine || null;
 }
+async function resolveInstalledCoreToolsVersion() {
+    if (!(await checkCoreTools())) {
+        return null;
+    }
+    try {
+        return parseCoreToolsVersion(await captureCommandOutput('func', ['--version']));
+    }
+    catch {
+        return null;
+    }
+}
 async function captureCommandOutput(command, args, cwd, env) {
     return new Promise((resolve, reject) => {
         const child = (0, child_process_1.spawn)(command, args, {
@@ -168,6 +253,35 @@ async function captureCommandOutput(command, args, cwd, env) {
         child.on('error', reject);
     });
 }
+async function probeHttpServer(url) {
+    return new Promise((resolve) => {
+        const target = new URL(url);
+        const requestFactory = target.protocol === 'https:' ? https.request : http.request;
+        let settled = false;
+        const finish = (value) => {
+            if (!settled) {
+                settled = true;
+                resolve(value);
+            }
+        };
+        const request = requestFactory({
+            hostname: target.hostname,
+            port: target.port,
+            path: target.pathname || '/',
+            method: 'GET',
+            timeout: 1000,
+        }, (response) => {
+            response.resume();
+            finish(true);
+        });
+        request.on('timeout', () => {
+            request.destroy();
+            finish(false);
+        });
+        request.on('error', () => finish(false));
+        request.end();
+    });
+}
 async function resolvePythonRuntimeDetails(functionsDir, env) {
     const { pythonExecutable } = getPythonVirtualEnvPaths(functionsDir);
     const output = await captureCommandOutput(pythonExecutable, [
@@ -216,28 +330,25 @@ async function bridgePythonCoreToolsForWindowsArm64(functionsDir, env) {
     return prependToPathEnv(env, patchedRoot);
 }
 async function preparePythonFunctionsEnvironment(functionsDir) {
-    const { pythonExecutable } = getPythonVirtualEnvPaths(functionsDir);
-    const hasUv = await checkCommand('uv', ['--version']);
-    if (!fs.existsSync(pythonExecutable)) {
-        if (hasUv) {
-            console.log('📦 Creating Python virtual environment with uv...');
-            await runCommand('uv', ['venv', '.venv', '--python', '3.11'], functionsDir, 'python virtual environment setup');
-        }
-        else {
-            const bootstrap = await resolvePythonBootstrapCommand();
-            console.log(`📦 Creating Python virtual environment with ${bootstrap.label}...`);
-            await runCommand(bootstrap.command, [...bootstrap.argsPrefix, '-m', 'venv', '.venv'], functionsDir, 'python virtual environment setup');
+    const projectRoot = (0, python_uv_1.getPythonProjectRoot)(functionsDir);
+    const { command: uvCommand, env: uvEnv } = await resolveProjectLocalUvCommand(projectRoot);
+    const { venvDir, pythonExecutable } = getPythonVirtualEnvPaths(functionsDir);
+    const hasUsableVirtualEnv = fs.existsSync(pythonExecutable) && await checkCommand(pythonExecutable, ['--version'], {
+        cwd: functionsDir,
+        env: uvEnv,
+        shell: false,
+    });
+    if (!hasUsableVirtualEnv) {
+        const venvArgs = (0, python_uv_1.buildUvVenvArgs)('.venv');
+        if (fs.existsSync(venvDir)) {
+            venvArgs.push('--clear');
         }
+        console.log('📦 Creating Python virtual environment with uv...');
+        await runCommand(uvCommand, venvArgs, functionsDir, 'python virtual environment setup', uvEnv, false);
     }
-    const pythonEnv = buildPythonFunctionsEnv(process.env, functionsDir);
-    console.log(`📦 Installing Python Azure Functions dependencies${hasUv ? ' with uv' : ''}...`);
-    if (hasUv) {
-        await runCommand('uv', ['pip', 'install', '--python', pythonExecutable, '-r', 'requirements.txt'], functionsDir, 'python dependency installation', pythonEnv);
-    }
-    else {
-        await runCommand('python', ['-m', 'pip', 'install', '--upgrade', 'pip'], functionsDir, 'python pip upgrade', pythonEnv);
-        await runCommand('python', ['-m', 'pip', 'install', '-r', 'requirements.txt'], functionsDir, 'python dependency installation', pythonEnv);
-    }
+    console.log('📦 Installing Python Azure Functions dependencies with uv...');
+    await runCommand(uvCommand, (0, python_uv_1.buildUvPipInstallArgs)(pythonExecutable, 'requirements.txt'), functionsDir, 'python dependency installation', uvEnv, false);
+    const pythonEnv = buildPythonFunctionsEnv(uvEnv, functionsDir);
     return bridgePythonCoreToolsForWindowsArm64(functionsDir, pythonEnv);
 }
 /**
@@ -271,7 +382,7 @@ function buildDevCommand(runDevEnvironment = startDevEnvironment, verifyProject
         .option('--host <host>', 'Host name', 'localhost')
         .option('--open', 'Open browser automatically', false)
         .option('--verbose', 'Show verbose logs', false)
-        .option('--no-functions', 'Skip Azure Functions startup', false)
+        .option('--no-functions', 'Skip Azure Functions startup')
         .option('--seed-env <environment>', 'Replace Cosmos DB Emulator data from dev-seeds/<environment> before startup')
         .option('--mock-connectors', 'Start mock server for connector models (serves Zod-generated data)', false)
         .action(async (options) => {
@@ -387,6 +498,9 @@ async function startDevEnvironment(options) {
     let mockServer = null;
     let envLocalPath = '';
     let envLocalDefaultUrl = ''; // default Functions URL to restore on shutdown
+    const functionsBaseUrl = buildFunctionsBaseUrl(options.host, functionsPort);
+    let functionsReadinessPromise = null;
+    let functionsReady = !!options.noFunctions;
     // Cleanup processes on Ctrl+C
     process.on('SIGINT', async () => {
         console.log('\n🛑 Stopping development servers...');
@@ -431,10 +545,12 @@ async function startDevEnvironment(options) {
         // 2. Check if Azure Functions exists
         const functionsDir = path.join(process.cwd(), 'functions');
         const hasFunctions = fs.existsSync(functionsDir) && hasFunctionsProject(functionsDir, backendLanguage);
+        let functionsCoreToolsCommand = null;
+        let installedCoreToolsVersion = null;
         if (hasFunctions && !options.noFunctions) {
-            // Check if Azure Functions Core Tools is installed
-            const coreToolsInstalled = await checkCoreTools();
-            if (!coreToolsInstalled) {
+            installedCoreToolsVersion = await resolveInstalledCoreToolsVersion();
+            functionsCoreToolsCommand = buildFunctionsCoreToolsCommand(backendLanguage, installedCoreToolsVersion);
+            if (functionsCoreToolsCommand.command === 'func' && !installedCoreToolsVersion) {
                 console.log('');
                 console.log('⚠️  Azure Functions Core Tools not found.');
                 console.log('');
@@ -481,6 +597,9 @@ async function startDevEnvironment(options) {
                     options.noFunctions = true;
                 }
             }
+            else if (functionsCoreToolsCommand.command !== 'func') {
+                console.log(`ℹ️  Using ${functionsCoreToolsCommand.label}.`);
+            }
             if (!options.noFunctions) {
                 // Check if Cosmos DB Emulator is running
                 const cosmosRunning = await checkCosmosDBEmulator();
@@ -521,8 +640,7 @@ async function startDevEnvironment(options) {
                     }
                 }
                 else if (backendLanguage === 'csharp') {
-                    console.log('📦 Building C# Azure Functions project...');
-                    await runCommand('dotnet', ['build'], functionsDir, 'dotnet build');
+                    console.log('ℹ️  C# Azure Functions can take longer on cold start while the worker builds.');
                 }
                 else {
                     functionsEnv = await preparePythonFunctionsEnvironment(functionsDir);
@@ -574,7 +692,8 @@ async function startDevEnvironment(options) {
                 }
             }
             // Azure Functions を起動
-            const funcProcess = (0, child_process_1.spawn)('func', buildFunctionsStartArgs(functionsPort), {
+            const functionsCommand = functionsCoreToolsCommand ?? buildFunctionsCoreToolsCommand(backendLanguage, installedCoreToolsVersion);
+            const funcProcess = (0, child_process_1.spawn)(functionsCommand.command, [...functionsCommand.argsPrefix, ...buildFunctionsStartArgs(functionsPort)], {
                 cwd: functionsDir,
                 shell: true,
                 stdio: 'pipe', // Always pipe to capture output
@@ -625,7 +744,8 @@ async function startDevEnvironment(options) {
                     }
                 }
             });
-            console.log(`✅ Azure Functions started (port: ${functionsPort})`);
+            console.log(`⏳ Waiting for Azure Functions to accept requests at ${functionsBaseUrl}...`);
+            functionsReadinessPromise = waitForHttpServerReady(functionsBaseUrl, getFunctionsReadinessTimeoutMs(backendLanguage));
         }
         else if (!hasFunctions) {
             console.log('');
@@ -714,8 +834,8 @@ async function startDevEnvironment(options) {
         // When --mock-connectors is active, bffTargetPort = mock port (7072); otherwise = Functions port (7071).
         // Next.js may load .env.local values that override spawn env vars, so we must keep them in sync.
         envLocalPath = path.join(process.cwd(), '.env.local');
-        envLocalDefaultUrl = `http://${options.host || 'localhost'}:${functionsPort}`;
-        const bffTargetUrl = `http://${options.host || 'localhost'}:${bffTargetPort}`;
+        envLocalDefaultUrl = functionsBaseUrl;
+        const bffTargetUrl = buildFunctionsBaseUrl(options.host, bffTargetPort);
         try {
             if (fs.existsSync(envLocalPath)) {
                 const envContent = fs.readFileSync(envLocalPath, 'utf-8');
@@ -729,8 +849,8 @@ async function startDevEnvironment(options) {
         catch { /* ignore */ }
         const nextEnv = {
             ...process.env,
-            BACKEND_FUNCTIONS_BASE_URL: `http://${options.host || 'localhost'}:${bffTargetPort}`,
-            FUNCTIONS_BASE_URL: `http://${options.host || 'localhost'}:${bffTargetPort}`,
+            BACKEND_FUNCTIONS_BASE_URL: bffTargetUrl,
+            FUNCTIONS_BASE_URL: bffTargetUrl,
         };
         const nextProcess = (0, child_process_1.spawn)(pm === 'pnpm' ? 'pnpm' : 'npx', nextArgs, {
             cwd: process.cwd(),
@@ -758,20 +878,33 @@ async function startDevEnvironment(options) {
             });
             process.exit(code || 0);
         });
+        if (functionsReadinessPromise) {
+            functionsReady = await functionsReadinessPromise;
+            console.log('');
+            if (functionsReady) {
+                console.log(`✅ Azure Functions ready (port: ${functionsPort})`);
+            }
+            else {
+                console.log(`⚠️  Azure Functions is still starting: ${functionsBaseUrl}`);
+            }
+        }
         console.log('');
         console.log('✅ SwallowKit development environment is running!');
         console.log('');
         console.log(`📱 Next.js: http://${options.host || 'localhost'}:${port}`);
         if (hasFunctions && !options.noFunctions) {
-            console.log(`⚡ Azure Functions: http://${options.host || 'localhost'}:${functionsPort}`);
+            console.log(`${functionsReady ? '⚡ Azure Functions' : '⏳ Azure Functions (starting)'}: ${functionsBaseUrl}`);
         }
         if (mockServer) {
-            console.log(`🔌 Mock Proxy: http://${options.host || 'localhost'}:${bffTargetPort} (BFF → here)`);
+            console.log(`🔌 Mock Proxy: ${bffTargetUrl} (BFF → here)`);
         }
         console.log('');
-        if (hasFunctions && !options.noFunctions) {
+        if (hasFunctions && !options.noFunctions && functionsReady) {
             console.log('💡 Azure Functions and Next.js BFF are connected');
         }
+        else if (hasFunctions && !options.noFunctions) {
+            console.log('💡 Azure Functions is still warming up; BFF routes can fail until the backend responds.');
+        }
         if (mockServer) {
             console.log('💡 Connector models served from mock server (Zod-generated data)');
         }
@@ -789,11 +922,11 @@ async function startDevEnvironment(options) {
         process.exit(1);
     }
 }
-async function runCommand(command, args, cwd, label, env) {
+async function runCommand(command, args, cwd, label, env, shell = true) {
     await new Promise((resolve, reject) => {
         const child = (0, child_process_1.spawn)(command, args, {
             cwd,
-            shell: true,
+            shell,
             stdio: 'inherit',
             env,
         });