swallowkit 1.0.0-beta.6 → 1.0.0-beta.60

package/src/cli/commands/scaffold.ts

@@ -0,0 +1,1081 @@
+/**
+ * SwallowKit Scaffold コマンド
+ * Zod モデルから Azure Functions と Next.js BFF の CRUD コードを生成
+ */
+
+import * as fs from "fs";
+import * as path from "path";
+import { spawnSync } from "child_process";
+import { getBackendLanguage, getConnectorDefinition, getAuthConfig, getFullConfig, getNormalizedAuthConfig, ensureSwallowKitProject, normalizeAuthConfig, validateConfig } from "../../core/config";
+import { ModelInfo, parseModelFile, toKebabCase, toPascalCase, toCamelCase } from "../../core/scaffold/model-parser";
+import {
+  generateCSharpAzureFunctionsCRUD,
+  generateCompactAzureFunctionsCRUD,
+  generatePythonAzureFunctionsCRUD,
+} from "../../core/scaffold/functions-generator";
+import {
+  generateRdbConnectorFunctionTS,
+  generateApiConnectorFunctionTS,
+  generateRdbConnectorFunctionCSharp,
+  generateApiConnectorFunctionCSharp,
+  generateRdbConnectorFunctionPython,
+  generateApiConnectorFunctionPython,
+} from "../../core/scaffold/connector-functions-generator";
+import { generateCompactBFFRoutes, generateBFFCallFunction, generateConnectorBFFRoutes } from "../../core/scaffold/nextjs-generator";
+import {
+  generateListPage,
+  generateDetailPage,
+  generateFormComponent,
+  generateNewPage,
+  generateEditPage,
+  generateAuthLayout,
+  UIAuthOptions,
+} from "../../core/scaffold/ui-generator";
+import { generateLanguageSchemaArtifacts, validateNativeSchemaToolchain } from "../../core/scaffold/native-schema-generator";
+import { detectFromProject, getCommands } from "../../utils/package-manager";
+import {
+  BackendLanguage,
+  RdbConnectorConfig,
+  ApiConnectorConfig,
+  RdbModelConnectorConfig,
+  ApiModelConnectorConfig,
+  ModelAuthPolicy,
+  AuthConfig,
+} from "../../types";
+import { syncProjectManifest } from "../../core/project/manifest";
+import { generateBFFCallFunctionWithAuth, generateBFFCallFunctionWithMultipleAuth, generateBFFCallFunctionWithSwaAuth, generateNamedAuthRouterCSharp, generateNamedAuthRouterPython, generateNamedAuthRouterTS } from "../../core/scaffold/auth-generator";
+import {
+  FileOperationSession,
+  getActiveFileSession,
+  hashFileIfExists,
+} from "../../core/operations/file-session";
+import { recordSessionOperations } from "../../core/project/artifacts";
+
+const SCAFFOLD_GENERATOR = "scaffold";
+
+interface ScaffoldOptions {
+  model: string; // モデルファイルのパス（例: "lib/models/todo.ts" or "todo"）
+  functionsDir?: string; // Azure Functions のディレクトリ（デフォルト: "functions"）
+  apiDir?: string; // Next.js API routes のディレクトリ（デフォルト: "app/api"）
+  apiOnly?: boolean; // true の場合、UI を生成しない（デフォルト: false）
+}
+
+function getMachineAwareStdio(): "inherit" | "pipe" {
+  return process.env.SWALLOWKIT_MACHINE_OUTPUT === "1" ? "pipe" : "inherit";
+}
+
+function runSpawnSyncCommand(command: string, args: string[], cwd: string): void {
+  const result = spawnSync(command, args, {
+    cwd,
+    stdio: getMachineAwareStdio(),
+    shell: true,
+  });
+
+  if (typeof result.status === "number" && result.status !== 0) {
+    throw new Error(`${command} ${args.join(" ")} exited with code ${result.status}`);
+  }
+
+  if (result.error) {
+    throw result.error;
+  }
+}
+
+export async function scaffoldCommand(options: ScaffoldOptions) {
+  // SwallowKit プロジェクトディレクトリかどうかを検証
+  ensureSwallowKitProject("scaffold");
+
+  const configValidation = validateConfig(getFullConfig());
+  if (!configValidation.valid) throw new Error(`Invalid SwallowKit configuration:\n${configValidation.errors.map(error => `- ${error}`).join("\n")}`);
+
+  // Plan(dry-run) や Apply からセッションが供給される。単体実行時は commit セッションを生成。
+  const session = getActiveFileSession() ?? new FileOperationSession("commit");
+
+  console.log("🏗️  SwallowKit Scaffold: Generating CRUD operations...\n");
+
+  try {
+    // 1. Resolve model file path
+    const modelPath = resolveModelPath(options.model);
+    console.log(`📄 Model file: ${modelPath}`);
+
+    // 2. Parse model file
+    console.log("🔍 Parsing model file...");
+    const modelInfo = await parseModelFile(modelPath);
+    console.log(`✅ Model parsed: ${modelInfo.name} (${modelInfo.schemaName})`);
+
+    const backendLanguage = getBackendLanguage();
+    console.log(`🧠 Backend language: ${backendLanguage}`);
+    
+    // コネクタモデルかどうかを判定
+    const isConnectorModel = !!modelInfo.connectorConfig;
+    if (isConnectorModel) {
+      console.log(`🔌 Connector model detected: ${modelInfo.connectorConfig!.connector}`);
+      console.log(`   Operations: ${modelInfo.connectorConfig!.operations.join(", ")}`);
+    }
+    
+    // ネストスキーマ参照があれば表示
+    if (modelInfo.nestedSchemaRefs.length > 0) {
+      console.log(`🔗 Nested schema references detected:`);
+      for (const ref of modelInfo.nestedSchemaRefs) {
+        const relType = ref.isArray ? 'array' : 'single';
+        const optional = ref.isOptional ? ' (optional)' : '';
+        console.log(`   - ${ref.fieldName}: ${ref.modelName} [${relType}]${optional}`);
+      }
+    }
+
+    // 3. Check for ID field
+    if (!modelInfo.hasId) {
+      console.warn(
+        "⚠️  Warning: Model does not have an 'id' field. CRUD operations may not work correctly."
+      );
+    }
+
+    // 4. Read shared package name
+    const functionsDir = options.functionsDir || "functions";
+    const sharedPackageName = readSharedPackageName();
+    const relatedModels = backendLanguage === "typescript"
+      ? [modelInfo]
+      : await collectModelGraph(modelPath);
+    for (const relatedModel of relatedModels) {
+      session.registerInput(relatedModel.filePath);
+    }
+
+    // 4b. 書き込み前に外部 codegen toolchain を検証し、失敗時はプロジェクト無変更で終了する
+    if (session.mode === "commit" && backendLanguage !== "typescript" && !isConnectorModel) {
+      await validateNativeSchemaToolchain(
+        relatedModels,
+        modelInfo,
+        backendLanguage,
+        path.join(process.cwd(), functionsDir)
+      );
+    }
+
+    if (options.apiOnly) {
+      console.log("ℹ️  --api-only skips UI generation only; Functions, BFF routes, OpenAPI, and native schema assets are still updated.");
+    }
+
+    // 5. Generate BFF callFunction helper
+    await generateCallFunctionHelper(session);
+
+    // 6. Generate Azure Functions code
+    if (isConnectorModel) {
+      await generateConnectorFunctionsCode(modelInfo, functionsDir, sharedPackageName, backendLanguage, session);
+      // 6b. Install connector driver dependencies
+      await installConnectorDriverDependencies(modelInfo, functionsDir, backendLanguage, session);
+    } else {
+      await generateFunctionsCode(modelInfo, functionsDir, sharedPackageName, backendLanguage, session);
+
+      if (backendLanguage !== "typescript") {
+        await generateLanguageSchemaArtifacts(relatedModels, modelInfo, functionsDir, backendLanguage, session);
+      }
+    }
+
+    // 7. Generate Next.js BFF API Routes
+    const apiDir = options.apiDir || "app/api";
+    if (isConnectorModel) {
+      await generateConnectorBFFRoutesFiles(modelInfo, apiDir, sharedPackageName, session);
+    } else {
+      await generateBFFRoutes(modelInfo, apiDir, sharedPackageName, session);
+    }
+
+    // 8. Generate Cosmos DB container Bicep file (skip for connector models)
+    if (!isConnectorModel) {
+      await generateCosmosContainer(modelInfo, session);
+    }
+
+    // 9. Generate UI components (unless --api-only)
+    if (!options.apiOnly) {
+      const uiAuthConfig = getAuthConfig();
+      const uiAuthPolicy = resolveAuthPolicy(modelInfo, uiAuthConfig);
+      const uiAuthOptions: UIAuthOptions | undefined =
+        uiAuthPolicy && uiAuthConfig && uiAuthConfig.provider !== 'none'
+          ? createUIAuthOptions(uiAuthPolicy, uiAuthConfig)
+          : undefined;
+      await generateUIComponents(modelInfo, sharedPackageName, uiAuthOptions, session);
+      if (uiAuthOptions?.authenticatedFetchImport) {
+        applyExternalTokenFetchToGeneratedUi(modelInfo, session, uiAuthOptions.authenticatedFetchImport);
+      }
+      await updateNavigationMenu(modelInfo, session);
+    }
+
+    if (session.mode === "commit") {
+      recordSessionOperations(session.operations, {
+        schemaHash: hashFileIfExists(modelPath) ?? undefined,
+        sourceModel: modelInfo.name,
+      });
+      await syncProjectManifest();
+    }
+
+    console.log("\n✅ Scaffold completed successfully!");
+    console.log("\n📝 Next steps:");
+    console.log(`  1. Review generated files in ${describeFunctionsOutputPath(functionsDir, backendLanguage)} and ${apiDir}/`);
+    if (!options.apiOnly) {
+      console.log(`  2. Check the generated UI pages in app/${toKebabCase(modelInfo.name)}/`);
+      console.log("  3. Navigate to the model from the homepage menu");
+    }
+    if (backendLanguage !== "typescript") {
+      console.log(`  ${options.apiOnly ? "2" : "4"}. Review generated OpenAPI export and native schema assets in ${functionsDir}/openapi/ and ${functionsDir}/generated/`);
+    }
+    console.log(
+      `  ${options.apiOnly ? (backendLanguage === "typescript" ? "2" : "3") : (backendLanguage === "typescript" ? "4" : "5")}. Ensure BACKEND_FUNCTIONS_BASE_URL is set in your .env.local file`
+    );
+    console.log(
+      `  ${options.apiOnly ? (backendLanguage === "typescript" ? "3" : "4") : (backendLanguage === "typescript" ? "5" : "6")}. Configure CosmosDBConnection in functions/local.settings.json`
+    );
+    console.log(`  ${options.apiOnly ? (backendLanguage === "typescript" ? "4" : "5") : (backendLanguage === "typescript" ? "6" : "7")}. Run '${getCommands(detectFromProject()).dlx} swallowkit dev' to test the generated code`);
+  } catch (error: any) {
+    console.error("\n❌ Scaffold failed:", error.message);
+    process.exit(1);
+  }
+}
+
+function applyExternalTokenFetchToGeneratedUi(modelInfo: ModelInfo, session: FileOperationSession, importPath = '@/lib/auth/authenticated-fetch'): void {
+  const uiPrefix = `app/${toKebabCase(modelInfo.name)}/`;
+  for (const operation of session.operations) {
+    if (!operation.path.startsWith(uiPrefix) || !operation.path.endsWith('.tsx') || operation.action === 'delete') continue;
+    let content = session.readFile(operation.absolutePath);
+    if (!content.includes('fetch(')) continue;
+    content = content.replace(/\bfetch\(/g, 'authenticatedFetch(');
+    content = content.replace(
+      /(if \(!res\.ok\) throw new Error\([^\n]+\);)/g,
+      `if (res.status === 401) throw new Error('Authentication required');\n        $1`
+    );
+    if (!content.includes(importPath)) {
+      const directive = content.match(/^'use client';\s*\r?\n/)?.[0] ?? '';
+      content = `${directive}import { authenticatedFetch } from '${importPath}';\n${content.slice(directive.length)}`;
+    }
+    session.writeFile(operation.absolutePath, content, {
+      ownership: 'managed',
+      generator: SCAFFOLD_GENERATOR,
+      sourceModel: modelInfo.name,
+    });
+  }
+}
+
+/**
+ * モデルの authPolicy と auth config から実効的な認可ポリシーを解決
+ * - モデルに authPolicy があればそれを使用
+ * - なければ auth.authorization.defaultPolicy に従う
+ * - auth 設定がなければ undefined（ガードなし）
+ */
+export function resolveAuthPolicy(modelInfo: ModelInfo, authConfig: AuthConfig | undefined): ModelAuthPolicy | undefined {
+  // モデルに明示的な authPolicy がある場合はそれを使用
+  if (modelInfo.authPolicy) {
+    const normalized = normalizeAuthConfig(authConfig);
+    for (const policyName of [modelInfo.authPolicy.policy, typeof modelInfo.authPolicy.read === 'string' ? modelInfo.authPolicy.read : undefined, typeof modelInfo.authPolicy.write === 'string' ? modelInfo.authPolicy.write : undefined].filter((value): value is string => Boolean(value))) {
+      if (!normalized?.authorization.policies[policyName]) throw new Error(`Model '${modelInfo.name}' references undefined auth policy '${policyName}'. Define auth.authorization.policies.${policyName}.`);
+    }
+    return modelInfo.authPolicy;
+  }
+
+  // auth 設定がない場合はガードなし
+  if (!authConfig || authConfig.provider === 'none') {
+    return undefined;
+  }
+
+  // defaultPolicy が 'authenticated' なら認証のみ（ロール指定なし）のポリシーを返す
+  const defaultPolicy = authConfig.authorization?.defaultPolicy === 'public' ? 'anonymous' : authConfig.authorization?.defaultPolicy ?? 'authenticated';
+  if (defaultPolicy === 'authenticated') {
+    return {}; // 空のポリシー = 認証のみ、ロール制限なし
+  }
+
+  if (defaultPolicy !== 'anonymous') return { policy: defaultPolicy };
+
+  // defaultPolicy が 'anonymous' なら認証不要
+  return undefined;
+}
+
+/**
+ * モデルファイルのパスを解決
+ */
+export function resolveModelPath(modelInput: string): string {
+  const cwd = process.cwd();
+
+  // 絶対パスの場合
+  if (path.isAbsolute(modelInput)) {
+    return modelInput;
+  }
+
+  // 拡張子がある場合（相対パス）
+  if (modelInput.endsWith(".ts")) {
+    const fullPath = path.join(cwd, modelInput);
+    if (fs.existsSync(fullPath)) {
+      return fullPath;
+    }
+  }
+
+  // 拡張子がない場合、shared/models/ で探す
+  const defaultPath = path.join(cwd, "shared", "models", `${modelInput}.ts`);
+  if (fs.existsSync(defaultPath)) {
+    return defaultPath;
+  }
+
+  // lib/models/ でも探す（後方互換性）
+  const libPath = path.join(cwd, "lib", "models", `${modelInput}.ts`);
+  if (fs.existsSync(libPath)) {
+    return libPath;
+  }
+
+  // src/models/ でも探す
+  const srcPath = path.join(cwd, "src", "models", `${modelInput}.ts`);
+  if (fs.existsSync(srcPath)) {
+    return srcPath;
+  }
+
+  // 見つからない場合はエラー
+  throw new Error(
+    `Model file not found: ${modelInput}\n` +
+      `  Tried:\n` +
+      `    - ${modelInput}\n` +
+      `    - ${defaultPath}\n` +
+      `    - ${libPath}\n` +
+      `    - ${srcPath}\n` +
+      `  Please specify a valid model file path.`
+  );
+}
+
+/**
+ * Read shared package name from shared/package.json
+ */
+function readSharedPackageName(): string {
+  const cwd = process.cwd();
+  const sharedPkgPath = path.join(cwd, "shared", "package.json");
+
+  if (!fs.existsSync(sharedPkgPath)) {
+    throw new Error(
+      "shared/package.json not found.\n" +
+        "The shared package is required for model imports.\n" +
+        `Run "${getCommands(detectFromProject()).dlx} swallowkit init" to set up your project.`
+    );
+  }
+
+  const pkg = JSON.parse(fs.readFileSync(sharedPkgPath, "utf-8"));
+  return pkg.name;
+}
+
+/**
+ * Generate BFF callFunction helper (lib/api/call-function.ts)
+ */
+async function generateCallFunctionHelper(session: FileOperationSession): Promise<void> {
+  console.log("\n📦 Generating BFF callFunction helper...");
+
+  const cwd = process.cwd();
+
+  const helperDir = path.join(cwd, "lib", "api");
+  const helperPath = path.join(helperDir, "call-function.ts");
+
+  // auth 設定がある場合は Authorization ヘッダー転送版を生成
+  const authConfig = getAuthConfig();
+  const normalizedAuth = normalizeAuthConfig(authConfig);
+  const hasAuth = Boolean(normalizedAuth && Object.keys(normalizedAuth.schemes).length > 0);
+  let helperCode: string;
+  if (hasAuth) {
+    const providers = new Set(Object.values(normalizedAuth!.schemes).map(scheme => scheme.provider));
+    helperCode = normalizedAuth!.schemes.default && Object.keys(normalizedAuth!.schemes).length === 1
+      ? authConfig?.provider === "swa" ? generateBFFCallFunctionWithSwaAuth() : generateBFFCallFunctionWithAuth()
+      : providers.has("swa") ? generateBFFCallFunctionWithMultipleAuth() : generateBFFCallFunctionWithAuth();
+  } else {
+    helperCode = generateBFFCallFunction();
+  }
+
+  session.writeFile(helperPath, helperCode, { ownership: "managed", generator: SCAFFOLD_GENERATOR });
+  console.log(`✅ Created: ${helperPath}`);
+}
+
+/**
+ * Generate Azure Functions CRUD code
+ */
+async function generateFunctionsCode(
+  modelInfo: ModelInfo,
+  functionsDir: string,
+  sharedPackageName: string,
+  backendLanguage: BackendLanguage,
+  session: FileOperationSession
+): Promise<void> {
+  console.log("\n🔨 Generating Azure Functions CRUD code...");
+
+  // Resolve auth policy: model-level authPolicy or global defaultPolicy
+  const authConfig = getAuthConfig();
+  const authPolicy = resolveAuthPolicy(modelInfo, authConfig);
+  if (authPolicy) {
+    console.log(`🔐 Auth policy detected: ${JSON.stringify(authPolicy)}`);
+  }
+
+  const modelKebab = toKebabCase(modelInfo.name);
+  const managedMeta = { ownership: "managed" as const, generator: SCAFFOLD_GENERATOR, sourceModel: modelInfo.name };
+  if (backendLanguage === "typescript") {
+    const normalizedAuth = getNormalizedAuthConfig();
+    if (normalizedAuth && Object.keys(normalizedAuth.schemes).some(name => name !== "default")) {
+      const routerPath = path.join(process.cwd(), functionsDir, "src", "auth", "auth-router.ts");
+      session.writeFile(routerPath, generateNamedAuthRouterTS(normalizedAuth), { ownership: "managed", generator: SCAFFOLD_GENERATOR });
+    }
+    const functionFilePath = path.join(
+      process.cwd(),
+      functionsDir,
+      "src",
+      `${modelKebab}.ts`
+    );
+
+    const code = generateCompactAzureFunctionsCRUD(modelInfo, sharedPackageName, authPolicy, authConfig?.provider);
+    session.writeFile(functionFilePath, code, managedMeta);
+    console.log(`✅ Created: ${functionFilePath}`);
+    return;
+  }
+
+  if (backendLanguage === "csharp") {
+    const normalizedAuth = getNormalizedAuthConfig();
+    if (normalizedAuth && Object.keys(normalizedAuth.schemes).some(name => name !== "default")) {
+      const routerPath = path.join(process.cwd(), functionsDir, "Auth", "AuthRouter.cs");
+      session.writeFile(routerPath, generateNamedAuthRouterCSharp(normalizedAuth), { ownership: "managed", generator: SCAFFOLD_GENERATOR });
+    }
+    const crudDir = path.join(process.cwd(), functionsDir, "Crud");
+    const functionFilePath = path.join(crudDir, `${modelInfo.name}CrudFunctions.cs`);
+
+    // Remove init-generated template (singular) to avoid route conflicts
+    const templatePath = path.join(crudDir, `${modelInfo.name}Function.cs`);
+    if (session.fileExists(templatePath)) {
+      session.deleteFile(templatePath, managedMeta);
+      console.log(`🗑️  Removed template: ${templatePath}`);
+    }
+
+    session.writeFile(functionFilePath, generateCSharpAzureFunctionsCRUD(modelInfo, authPolicy), managedMeta);
+    console.log(`✅ Created: ${functionFilePath}`);
+    return;
+  }
+
+  const normalizedAuth = getNormalizedAuthConfig();
+  if (normalizedAuth && Object.keys(normalizedAuth.schemes).some(name => name !== "default")) {
+    const routerPath = path.join(process.cwd(), functionsDir, "auth", "auth_router.py");
+    session.writeFile(routerPath, generateNamedAuthRouterPython(normalizedAuth), { ownership: "managed", generator: SCAFFOLD_GENERATOR });
+  }
+
+  const blueprintsDir = path.join(process.cwd(), functionsDir, "blueprints");
+  const blueprintPath = path.join(blueprintsDir, `${modelKebab.replace(/-/g, "_")}.py`);
+
+  const { blueprint, registration } = generatePythonAzureFunctionsCRUD(modelInfo, authPolicy);
+  session.writeFile(blueprintPath, blueprint, managedMeta);
+  updatePythonFunctionRegistrations(path.join(process.cwd(), functionsDir, "function_app.py"), registration, session);
+  console.log(`✅ Created: ${blueprintPath}`);
+}
+
+export function createUIAuthOptions(policy: ModelAuthPolicy, authConfig: AuthConfig): UIAuthOptions {
+  const normalized = normalizeAuthConfig(authConfig);
+  const readPolicyName = typeof policy.read === 'string' ? policy.read : policy.policy;
+  const writePolicyName = typeof policy.write === 'string' ? policy.write : policy.policy;
+  const readNamed = readPolicyName ? normalized?.authorization.policies[readPolicyName] : undefined;
+  const named = writePolicyName ? normalized?.authorization.policies[writePolicyName] : undefined;
+  const writeRoles = named?.roles ?? (Array.isArray(policy.write) ? policy.write : policy.roles) ?? [];
+  const externalScheme = [...(readNamed?.schemes ?? []), ...(named?.schemes ?? [])].find(name => normalized?.schemes[name]?.provider === 'external-token');
+  const authScheme = readNamed?.schemes[0] ?? named?.schemes[0];
+  const authenticatedFetchImport = externalScheme ? `@/lib/auth/schemes/${toKebabCase(externalScheme)}/authenticated-fetch` : authConfig.provider === 'external-token' ? '@/lib/auth/authenticated-fetch' : undefined;
+  const authContextImport = authScheme ? `@/lib/auth/schemes/${toKebabCase(authScheme)}/auth-context` : '@/lib/auth/auth-context';
+  return { authPolicy: policy, writeRoles, authenticatedFetchImport, authContextImport };
+}
+
+/**
+ * コネクタモデル用 Azure Functions コード生成
+ */
+async function generateConnectorFunctionsCode(
+  modelInfo: ModelInfo,
+  functionsDir: string,
+  sharedPackageName: string,
+  backendLanguage: BackendLanguage,
+  session: FileOperationSession
+): Promise<void> {
+  console.log("\n🔌 Generating Connector Azure Functions code...");
+
+  const connectorConfig = modelInfo.connectorConfig!;
+  const connectorDef = getConnectorDefinition(connectorConfig.connector);
+
+  if (!connectorDef) {
+    throw new Error(
+      `Connector '${connectorConfig.connector}' not found in swallowkit.config.js.\n` +
+      `  Please add it to the 'connectors' section of your configuration.`
+    );
+  }
+
+  // Resolve auth policy (same logic as Cosmos model scaffolding)
+  const authConfig = getAuthConfig();
+  const authPolicy = resolveAuthPolicy(modelInfo, authConfig);
+  if (authPolicy) {
+    console.log(`🔐 Auth policy detected: ${JSON.stringify(authPolicy)}`);
+  }
+
+  const modelKebab = toKebabCase(modelInfo.name);
+  const connectorManagedMeta = { ownership: "managed" as const, generator: SCAFFOLD_GENERATOR, sourceModel: modelInfo.name };
+
+  if (backendLanguage === "typescript") {
+    const functionFilePath = path.join(
+      process.cwd(),
+      functionsDir,
+      "src",
+      `${modelKebab}.ts`
+    );
+
+    let code: string;
+    if (connectorDef.type === "rdb") {
+      code = generateRdbConnectorFunctionTS(
+        modelInfo, sharedPackageName,
+        connectorDef as RdbConnectorConfig,
+        connectorConfig as RdbModelConnectorConfig,
+        authPolicy,
+        authConfig?.provider
+      );
+    } else {
+      code = generateApiConnectorFunctionTS(
+        modelInfo, sharedPackageName,
+        connectorDef as ApiConnectorConfig,
+        connectorConfig as ApiModelConnectorConfig,
+        authPolicy,
+        authConfig?.provider
+      );
+    }
+
+    session.writeFile(functionFilePath, code, connectorManagedMeta);
+    console.log(`✅ Created: ${functionFilePath}`);
+    return;
+  }
+
+  if (backendLanguage === "csharp") {
+    const functionFilePath = path.join(
+      process.cwd(),
+      functionsDir,
+      "Connectors",
+      `${modelInfo.name}ConnectorFunctions.cs`
+    );
+
+    let code: string;
+    if (connectorDef.type === "rdb") {
+      code = generateRdbConnectorFunctionCSharp(
+        modelInfo,
+        connectorDef as RdbConnectorConfig,
+        connectorConfig as RdbModelConnectorConfig
+      );
+    } else {
+      code = generateApiConnectorFunctionCSharp(
+        modelInfo,
+        connectorDef as ApiConnectorConfig,
+        connectorConfig as ApiModelConnectorConfig
+      );
+    }
+
+    session.writeFile(functionFilePath, code, connectorManagedMeta);
+    console.log(`✅ Created: ${functionFilePath}`);
+    return;
+  }
+
+  // Python
+  const blueprintsDir = path.join(process.cwd(), functionsDir, "blueprints");
+  const blueprintPath = path.join(blueprintsDir, `${modelKebab.replace(/-/g, "_")}.py`);
+
+  let result: { blueprint: string; registration: string };
+  if (connectorDef.type === "rdb") {
+    result = generateRdbConnectorFunctionPython(
+      modelInfo,
+      connectorDef as RdbConnectorConfig,
+      connectorConfig as RdbModelConnectorConfig
+    );
+  } else {
+    result = generateApiConnectorFunctionPython(
+      modelInfo,
+      connectorDef as ApiConnectorConfig,
+      connectorConfig as ApiModelConnectorConfig
+    );
+  }
+
+  session.writeFile(blueprintPath, result.blueprint, connectorManagedMeta);
+  updatePythonFunctionRegistrations(path.join(process.cwd(), functionsDir, "function_app.py"), result.registration, session);
+  console.log(`✅ Created: ${blueprintPath}`);
+}
+
+/**
+ * コネクタモデルの scaffold 後に、生成コードが必要とする RDB/API ドライバを
+ * functions ディレクトリにインストールする。
+ */
+async function installConnectorDriverDependencies(
+  modelInfo: ModelInfo,
+  functionsDir: string,
+  backendLanguage: BackendLanguage,
+  session: FileOperationSession
+): Promise<void> {
+  const connectorConfig = modelInfo.connectorConfig!;
+  const connectorDef = getConnectorDefinition(connectorConfig.connector);
+  if (!connectorDef || connectorDef.type !== "rdb") return;
+
+  const rdbDef = connectorDef as RdbConnectorConfig;
+  const functionsPath = path.join(process.cwd(), functionsDir);
+
+  if (backendLanguage === "typescript") {
+    const driverMap: Record<string, { deps: string[]; devDeps: string[] }> = {
+      mysql:     { deps: ["mysql2"],  devDeps: [] },
+      postgres:  { deps: ["pg"],      devDeps: ["@types/pg"] },
+      sqlserver: { deps: ["mssql"],   devDeps: [] },
+    };
+    const entry = driverMap[rdbDef.provider];
+    if (!entry) return;
+
+    // package.json を読んで、既にインストール済みならスキップ
+    const pkgJsonPath = path.join(functionsPath, "package.json");
+    if (fs.existsSync(pkgJsonPath)) {
+      const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
+      const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+      const missingDeps = entry.deps.filter(d => !allDeps[d]);
+      const missingDevDeps = entry.devDeps.filter(d => !allDeps[d]);
+      if (missingDeps.length === 0 && missingDevDeps.length === 0) return;
+    }
+
+    if (session.mode === "collect") {
+      session.addWarning(
+        `external-install: ${rdbDef.provider} driver dependencies (${[...entry.deps, ...entry.devDeps].join(", ")}) will be installed into ${functionsDir}/ on apply.`
+      );
+      return;
+    }
+
+    console.log(`\n📦 Installing ${rdbDef.provider} driver dependencies...`);
+    const pm = detectFromProject(functionsPath);
+    const cmds = getCommands(pm);
+
+    if (entry.deps.length > 0) {
+      runSpawnSyncCommand(cmds.name, [pm === "pnpm" ? "add" : "install", ...entry.deps], functionsPath);
+    }
+    if (entry.devDeps.length > 0) {
+      runSpawnSyncCommand(cmds.name, [pm === "pnpm" ? "add" : "install", "-D", ...entry.devDeps], functionsPath);
+    }
+    console.log(`✅ ${rdbDef.provider} driver installed`);
+    return;
+  }
+
+  if (backendLanguage === "csharp") {
+    const nugetMap: Record<string, string> = {
+      mysql:     "MySqlConnector",
+      postgres:  "Npgsql",
+      sqlserver: "Microsoft.Data.SqlClient",
+    };
+    const pkg = nugetMap[rdbDef.provider];
+    if (!pkg) return;
+    if (session.mode === "collect") {
+      session.addWarning(`external-install: NuGet package ${pkg} will be added to ${functionsDir}/functions.csproj on apply.`);
+      return;
+    }
+    console.log(`\n📦 Installing ${rdbDef.provider} NuGet package...`);
+    runSpawnSyncCommand("dotnet", ["add", path.join(functionsPath, "functions.csproj"), "package", pkg], functionsPath);
+    console.log(`✅ ${pkg} installed`);
+    return;
+  }
+
+  // Python — requirements.txt に追記
+  const pipMap: Record<string, string> = {
+    mysql:     "mysql-connector-python",
+    postgres:  "psycopg2-binary",
+    sqlserver: "pymssql",
+  };
+  const pipPkg = pipMap[rdbDef.provider];
+  if (!pipPkg) return;
+  const reqPath = path.join(functionsPath, "requirements.txt");
+  if (session.fileExists(reqPath)) {
+    const existing = session.readFile(reqPath);
+    if (!existing.includes(pipPkg)) {
+      console.log(`\n📦 Adding ${pipPkg} to requirements.txt...`);
+      session.writeFile(reqPath, `${existing}\n${pipPkg}\n`, { ownership: "extension-point", generator: SCAFFOLD_GENERATOR });
+      console.log(`✅ ${pipPkg} added`);
+    }
+  }
+}
+
+/**
+ * コネクタモデル用 BFF ルート生成（操作制限に対応）
+ */
+async function generateConnectorBFFRoutesFiles(
+  modelInfo: ModelInfo,
+  apiDir: string,
+  sharedPackageName: string,
+  session: FileOperationSession
+): Promise<void> {
+  console.log("\n🔌 Generating Connector BFF API routes...");
+
+  const modelCamel = toCamelCase(modelInfo.name);
+  const operations = modelInfo.connectorConfig!.operations;
+
+  const listRoutePath = path.join(process.cwd(), apiDir, modelCamel, "route.ts");
+  const detailRoutePath = path.join(process.cwd(), apiDir, modelCamel, "[id]", "route.ts");
+
+  const routes = generateConnectorBFFRoutes(modelInfo, sharedPackageName, operations);
+
+  const meta = { ownership: "managed" as const, generator: SCAFFOLD_GENERATOR, sourceModel: modelInfo.name };
+  session.writeFile(listRoutePath, routes.listRoute, meta);
+  session.writeFile(detailRoutePath, routes.detailRoute, meta);
+
+  console.log(`✅ Created: ${listRoutePath}`);
+  console.log(`✅ Created: ${detailRoutePath}`);
+}
+
+async function collectModelGraph(modelPath: string, seen = new Map<string, ModelInfo>()): Promise<ModelInfo[]> {
+  const resolvedPath = path.resolve(modelPath);
+  if (seen.has(resolvedPath)) {
+    return Array.from(seen.values());
+  }
+
+  const modelInfo = await parseModelFile(resolvedPath);
+  seen.set(resolvedPath, modelInfo);
+
+  for (const ref of modelInfo.nestedSchemaRefs) {
+    const nestedPath = resolveNestedModelPath(resolvedPath, ref.importPath);
+    await collectModelGraph(nestedPath, seen);
+  }
+
+  return Array.from(seen.values());
+}
+
+function resolveNestedModelPath(modelPath: string, importPath: string): string {
+  let resolvedPath = path.resolve(path.dirname(modelPath), importPath);
+  if (!resolvedPath.endsWith(".ts")) {
+    resolvedPath += ".ts";
+  }
+  return resolvedPath;
+}
+
+function describeFunctionsOutputPath(functionsDir: string, backendLanguage: BackendLanguage): string {
+  if (backendLanguage === "typescript") {
+    return `${functionsDir}/src/`;
+  }
+  if (backendLanguage === "csharp") {
+    return `${functionsDir}/Crud/`;
+  }
+  return `${functionsDir}/blueprints/`;
+}
+
+function updatePythonFunctionRegistrations(functionAppPath: string, registration: string, session: FileOperationSession): void {
+  if (!session.fileExists(functionAppPath)) {
+    throw new Error(`Python Functions entrypoint not found: ${functionAppPath}`);
+  }
+
+  const content = session.readFile(functionAppPath);
+
+  // Check if import line already exists (handles init-generated layout)
+  const importLine = registration.split("\n").find((l) => l.startsWith("from ") || l.startsWith("import "));
+  if (importLine && content.includes(importLine)) {
+    return;
+  }
+  if (content.includes(registration)) {
+    return;
+  }
+
+  const marker = "# SwallowKit scaffold registrations";
+  if (!content.includes(marker)) {
+    throw new Error(`Could not find scaffold registration marker in ${functionAppPath}`);
+  }
+
+  const updated = content.replace(marker, `${registration}\n${marker}`);
+  session.writeFile(functionAppPath, updated, { ownership: "extension-point", generator: SCAFFOLD_GENERATOR });
+}
+
+/**
+ * Next.js BFF API Routes を生成
+ */
+async function generateBFFRoutes(
+  modelInfo: any,
+  apiDir: string,
+  sharedPackageName: string,
+  session: FileOperationSession
+): Promise<void> {
+  console.log("\n🔨 Generating Next.js BFF API routes...");
+
+  const modelCamel = modelInfo.name.charAt(0).toLowerCase() + modelInfo.name.slice(1);
+
+  // List route: app/api/[model]/route.ts
+  const listRoutePath = path.join(
+    process.cwd(),
+    apiDir,
+    modelCamel,
+    "route.ts"
+  );
+
+  // Detail route: app/api/[model]/[id]/route.ts
+  const detailRoutePath = path.join(
+    process.cwd(),
+    apiDir,
+    modelCamel,
+    "[id]",
+    "route.ts"
+  );
+
+  // コードを生成
+  const routes = generateCompactBFFRoutes(modelInfo, sharedPackageName);
+
+  // ファイルに書き込み
+  const meta = { ownership: "managed" as const, generator: SCAFFOLD_GENERATOR, sourceModel: modelInfo.name };
+  session.writeFile(listRoutePath, routes.listRoute, meta);
+  session.writeFile(detailRoutePath, routes.detailRoute, meta);
+
+  console.log(`✅ Created: ${listRoutePath}`);
+  console.log(`✅ Created: ${detailRoutePath}`);
+}
+
+/**
+ * Generate Cosmos DB container Bicep file
+ */
+export async function generateCosmosContainer(modelInfo: any, session: FileOperationSession = new FileOperationSession("commit")): Promise<void> {
+  console.log("\n🗄️  Generating Cosmos DB container Bicep file...");
+
+  const modelKebab = toKebabCase(modelInfo.name);
+  const modelPascal = toPascalCase(modelInfo.name);
+  const cwd = process.cwd();
+
+  // Check if infra directory exists
+  const infraDir = path.join(cwd, "infra");
+  if (!fs.existsSync(infraDir)) {
+    console.log("ℹ️  infra directory not found. Skipping Cosmos DB container generation.");
+    return;
+  }
+
+  // Generate container Bicep file
+  const containersDir = path.join(infraDir, "containers");
+  const containerFileName = `${modelKebab}-container.bicep`;
+  const containerFilePath = path.join(containersDir, containerFileName);
+
+  const bicepContent = `@description('Cosmos DB account name')
+param cosmosAccountName string
+
+@description('Database name')
+param databaseName string
+
+@description('Container name')
+param containerName string = '${modelPascal}s'
+
+@description('Partition key path')
+param partitionKeyPath string = '${modelInfo.partitionKey}'
+
+// Reference existing Cosmos DB account
+resource cosmosAccount 'Microsoft.DocumentDB/databaseAccounts@2023-11-15' existing = {
+  name: cosmosAccountName
+}
+
+// Reference existing database
+resource database 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2023-11-15' existing = {
+  parent: cosmosAccount
+  name: databaseName
+}
+
+// Container for ${modelPascal}
+resource container 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-11-15' = {
+  parent: database
+  name: containerName
+  properties: {
+    resource: {
+      id: containerName
+      partitionKey: {
+        paths: [
+          partitionKeyPath
+        ]
+        kind: 'Hash'
+      }
+      indexingPolicy: {
+        automatic: true
+        indexingMode: 'consistent'
+        includedPaths: [
+          {
+            path: '/*'
+          }
+        ]
+        excludedPaths: [
+          {
+            path: '/_etag/?'
+          }
+        ]
+      }
+    }
+  }
+}
+
+output containerName string = container.name
+`;
+
+  // Write Bicep file (overwrite if exists)
+  session.writeFile(containerFilePath, bicepContent, { ownership: "managed", generator: SCAFFOLD_GENERATOR, sourceModel: modelInfo.name });
+  console.log(`✅ Created: ${containerFilePath}`);
+
+  // Update main.bicep to include this container module
+  await updateMainBicepWithContainer(modelKebab, modelPascal, session);
+}
+
+/**
+ * Update main.bicep to include new container module
+ */
+async function updateMainBicepWithContainer(modelKebab: string, modelPascal: string, session: FileOperationSession): Promise<void> {
+  const cwd = process.cwd();
+  const mainBicepPath = path.join(cwd, "infra", "main.bicep");
+
+  if (!session.fileExists(mainBicepPath)) {
+    console.log("ℹ️  main.bicep not found. Please manually add the container module.");
+    return;
+  }
+
+  let mainBicepContent = session.readFile(mainBicepPath);
+
+  // Check if container module already exists
+  const containerModuleName = `${modelPascal.charAt(0).toLowerCase()}${modelPascal.slice(1)}Container`;
+  if (mainBicepContent.includes(`module ${containerModuleName}`)) {
+    console.log(`ℹ️  Container module '${containerModuleName}' already exists in main.bicep`);
+    return;
+  }
+
+  // Find the position to insert the container module (after cosmosDb modules)
+  // Look for the end of both cosmosDb modules (FreeTier and Serverless)
+  const cosmosModulePattern = /module cosmosDbServerless ['"]modules\/cosmosdb-serverless\.bicep['"] = if \(cosmosDbMode == 'serverless'\) \{[\s\S]*?\n\}/;
+  const cosmosModuleMatch = mainBicepContent.match(cosmosModulePattern);
+  
+  if (!cosmosModuleMatch) {
+    console.log("⚠️  Could not find Cosmos DB Serverless module in main.bicep. Please manually add the container module:");
+    console.log(`\nmodule ${containerModuleName} 'containers/${modelKebab}-container.bicep' = {
+  name: '${modelKebab}-container'
+  params: {
+    cosmosAccountName: cosmosDbMode == 'freetier' ? cosmosDbFreeTier.outputs.accountName : cosmosDbServerless.outputs.accountName
+    databaseName: databaseName
+    cosmosDbMode: cosmosDbMode
+  }
+  dependsOn: [
+    cosmosDbFreeTier
+    cosmosDbServerless
+  ]
+}\n`);
+    return;
+  }
+
+  // Find the end of the cosmosDbServerless module
+  const insertPosition = cosmosModuleMatch.index! + cosmosModuleMatch[0].length;
+
+  // Create the container module declaration
+  const containerModule = `
+
+// ${modelPascal} Container
+module ${containerModuleName} 'containers/${modelKebab}-container.bicep' = {
+  name: '${modelKebab}-container'
+  params: {
+    cosmosAccountName: cosmosDbMode == 'freetier' ? cosmosDbFreeTier.outputs.accountName : cosmosDbServerless.outputs.accountName
+    databaseName: '\${projectName}Database'
+  }
+}`;
+
+  // Insert the module
+  mainBicepContent = 
+    mainBicepContent.slice(0, insertPosition) +
+    containerModule +
+    mainBicepContent.slice(insertPosition);
+
+  session.writeFile(mainBicepPath, mainBicepContent, { ownership: "extension-point", generator: SCAFFOLD_GENERATOR });
+  console.log(`✅ Added container module to main.bicep`);
+}
+
+/**
+ * Generate UI components (list, detail, form, create, edit pages)
+ */
+export async function generateUIComponents(modelInfo: ModelInfo, sharedPackageName: string, authOptions?: UIAuthOptions, session: FileOperationSession = new FileOperationSession("commit")): Promise<void> {
+  console.log("\n🎨 Generating UI components...");
+
+  const modelKebab = toKebabCase(modelInfo.name);
+  const modelName = modelInfo.name;
+  const cwd = process.cwd();
+
+  // Create directory structure: app/[model]/
+  const modelDir = path.join(cwd, "app", modelKebab);
+  const componentsDir = path.join(modelDir, "_components");
+  const newDir = path.join(modelDir, "new");
+  const idDir = path.join(modelDir, "[id]");
+  const editDir = path.join(idDir, "edit");
+
+  // Generate and write files
+  const listPage = generateListPage(modelInfo, sharedPackageName, authOptions);
+  const detailPage = generateDetailPage(modelInfo, sharedPackageName, authOptions);
+  const formComponent = generateFormComponent(modelInfo, sharedPackageName);
+  const newPage = generateNewPage(modelInfo, authOptions);
+  const editPage = generateEditPage(modelInfo, sharedPackageName, authOptions);
+  const authLayout = generateAuthLayout(modelInfo, authOptions);
+
+  const meta = { ownership: "managed" as const, generator: SCAFFOLD_GENERATOR, sourceModel: modelInfo.name };
+  session.writeFile(path.join(modelDir, "page.tsx"), listPage, meta);
+  session.writeFile(path.join(idDir, "page.tsx"), detailPage, meta);
+  session.writeFile(path.join(componentsDir, `${modelName}Form.tsx`), formComponent, meta);
+  session.writeFile(path.join(newDir, "page.tsx"), newPage, meta);
+  session.writeFile(path.join(editDir, "page.tsx"), editPage, meta);
+  if (authLayout) {
+    session.writeFile(path.join(modelDir, "layout.tsx"), authLayout, meta);
+  }
+
+  console.log(`✅ Created: ${path.join(modelDir, "page.tsx")}`);
+  console.log(`✅ Created: ${path.join(idDir, "page.tsx")}`);
+  console.log(`✅ Created: ${path.join(componentsDir, `${modelName}Form.tsx`)}`);
+  console.log(`✅ Created: ${path.join(newDir, "page.tsx")}`);
+  console.log(`✅ Created: ${path.join(editDir, "page.tsx")}`);
+  if (authLayout) {
+    console.log(`✅ Created: ${path.join(modelDir, "layout.tsx")}`);
+  }
+}
+
+/**
+ * Update navigation menu on the homepage
+ */
+async function updateNavigationMenu(modelInfo: any, session: FileOperationSession): Promise<void> {
+  console.log("\n📋 Updating navigation menu...");
+
+  const modelKebab = toKebabCase(modelInfo.name);
+  const cwd = process.cwd();
+
+  // Update scaffold config
+  const configPath = path.join(cwd, "lib", "scaffold-config.ts");
+  
+  if (!session.fileExists(configPath)) {
+    console.log("⚠️  scaffold-config.ts not found. Skipping navigation menu update.");
+    return;
+  }
+
+  // Read existing config
+  const configContent = session.readFile(configPath);
+  
+  // Parse models array - extract each model entry
+  const models: Array<{ name: string; path: string; label: string }> = [];
+  const modelsMatch = configContent.match(/models:\s*\[([\s\S]*?)\]\s*as\s*ScaffoldModel\[\]/);
+  
+  if (modelsMatch) {
+    const modelsArrayContent = modelsMatch[1];
+    // Match each object in the array: { name: '...', path: '...', label: '...' }
+    const modelPattern = /\{\s*name:\s*['"]([^'"]+)['"]\s*,\s*path:\s*['"]([^'"]+)['"]\s*,\s*label:\s*['"]([^'"]+)['"]\s*\}/g;
+    let match;
+    while ((match = modelPattern.exec(modelsArrayContent)) !== null) {
+      models.push({
+        name: match[1],
+        path: match[2],
+        label: match[3]
+      });
+    }
+  }
+
+  // Check if model already exists
+  if (models.find(m => m.name === modelInfo.name)) {
+    console.log(`ℹ️  ${modelInfo.name} already in navigation menu`);
+    return;
+  }
+
+  // Add new model
+  models.push({
+    name: modelInfo.name,
+    path: `/${modelKebab}`,
+    label: modelInfo.displayName
+  });
+
+  // Generate new scaffold-config.ts content
+  const newConfigContent = `export interface ScaffoldModel {
+  name: string;
+  path: string;
+  label: string;
+}
+
+export const scaffoldConfig = {
+  models: [
+${models.map(m => `    { name: '${m.name}', path: '${m.path}', label: '${m.label}' },`).join('\n')}
+  ] as ScaffoldModel[]
+};
+`;
+
+  session.writeFile(configPath, newConfigContent, { ownership: "extension-point", generator: SCAFFOLD_GENERATOR });
+  console.log(`✅ Added ${modelInfo.name} to navigation menu`);
+}
+