@bagelink/workspace 1.15.558 → 1.15.562

package/bin/bgl.ts

@@ -7,6 +7,8 @@ import { runDev } from '../src/dev.js'
 import { generateWorkspaceConfig } from '../src/init.js'
 import { setupLint } from '../src/lint.js'
 import { generateSDK, generateSDKForWorkspace } from '../src/sdk.js'
+import { resolveOpenApiUrl } from '../src/sdk.js'
+import { validateOpenApiConformance } from '../src/openapi.js'
 import { addProject, initWorkspace, listProjects } from '../src/workspace.js'
 
 const [,, command, subcommand, ...args] = process.argv
@@ -88,12 +90,14 @@ Lint Commands:
 			const splitMode = args.includes('--split') || args.includes('-s')
 			const modeIndex = args.indexOf('--mode')
 			const mode = modeIndex >= 0 ? args[modeIndex + 1] : undefined
+			const manifestIndex = args.indexOf('--manifest')
+			const manifest = manifestIndex >= 0 ? args[manifestIndex + 1] : undefined
 
 			let workspaceMode = isWorkspace(process.cwd())
 			if (forceWorkspace) workspaceMode = true
 			if (forceProject) workspaceMode = false
 
-			const sdkOptions = { split: splitMode || undefined, mode }
+			const sdkOptions = { split: splitMode || undefined, mode, manifest }
 
 			if (workspaceMode) {
 				console.log('✓ Detected workspace mode - will generate for multiple projects')
@@ -103,6 +107,16 @@ Lint Commands:
 				await generateSDK(process.cwd(), sdkOptions)
 			}
 		}
+		else if (subcommand === 'validate') {
+			const modeIndex = args.indexOf('--mode')
+			const mode = modeIndex >= 0 ? args[modeIndex + 1] : undefined
+			const manifestIndex = args.indexOf('--manifest')
+			const manifest = manifestIndex >= 0 ? args[manifestIndex + 1] : undefined
+			const openApiUrl = await resolveOpenApiUrl(process.cwd(), mode)
+			if (!openApiUrl) throw new Error('No openapi_url found in bgl.config.ts')
+			await validateOpenApiConformance(process.cwd(), openApiUrl, manifest)
+			console.log('✅ OpenAPI conforms to explicit module ownership manifest')
+		}
 		else {
 			console.log(`
 SDK Commands:
@@ -111,6 +125,8 @@ SDK Commands:
   bgl sdk generate --workspace   Force workspace mode
   bgl sdk generate --project     Force single project mode
   bgl sdk generate --mode <env>  Use openapi_url from that bgl.config.ts env
+  bgl sdk generate --manifest <path> Generate explicit per-module SDK files
+  bgl sdk validate [--manifest <path>] Validate endpoint ownership and schemas
 `)
 			process.exit(1)
 		}
@@ -153,12 +169,14 @@ Usage:
   bgl lint init             Set up linting (auto-detects workspace)
   bgl sdk generate          Generate SDK (auto-detects workspace)
   bgl sdk generate --split  Generate per-module API files
+  bgl sdk validate          Validate OpenAPI module ownership
 
 Options:
   --workspace, -w           Force workspace mode
   --project, -p             Force single project mode
   --split, -s               Split SDK into per-module files
   --mode <env>              Set environment (matches bgl.config.ts keys)
+  --manifest <path>         Ownership manifest (default: openapi.modules.json)
   --help, -h                Show this help message
 
 Note: Commands auto-detect workspace mode based on directory structure

package/dist/bin/bgl.cjs

@@ -659,22 +659,69 @@ function updatePackageJsonLint(root, configs) {
   }
 }
 
+const DEFAULT_OWNERSHIP_MANIFEST = "openapi.modules.json";
+function resolveWithinRoot(root, file) {
+  const absoluteRoot = node_path.resolve(root);
+  const path = node_path.resolve(absoluteRoot, file);
+  const relativePath = node_path.relative(absoluteRoot, path);
+  if (relativePath.startsWith("..") || relativePath.includes("/../") || relativePath === "") {
+    throw new Error(`Path must be inside the project root: ${file}`);
+  }
+  return path;
+}
+function readOwnershipManifest(root, file = DEFAULT_OWNERSHIP_MANIFEST) {
+  const path = resolveWithinRoot(root, file);
+  if (!node_fs.existsSync(path)) throw new Error(`Module ownership manifest not found: ${path}`);
+  return JSON.parse(node_fs.readFileSync(path, "utf8"));
+}
+async function fetchOpenApi(url) {
+  const response = await fetch(url, {
+    headers: { Authorization: "Basic YmFnZWxfdXNlcm5hbWU6Tm90U2VjdXJlQGJhZ2Vs" }
+  });
+  if (!response.ok) throw new Error(`HTTP ${response.status}: failed to fetch ${url}`);
+  return await response.json();
+}
+async function validateOpenApiConformance(root, openApiUrl, manifestFile = DEFAULT_OWNERSHIP_MANIFEST) {
+  const { validateOwnershipManifest } = await import('@bagelink/sdk');
+  const issues = validateOwnershipManifest(await fetchOpenApi(openApiUrl), readOwnershipManifest(root, manifestFile));
+  if (issues.length) throw new Error(`OpenAPI ownership conformance failed:
+${issues.map((issue) => `- ${issue.message}`).join("\n")}`);
+}
+async function generateOwnedModules(root, openApiUrl, outputDir, manifestFile = DEFAULT_OWNERSHIP_MANIFEST) {
+  const { generateModules } = await import('@bagelink/sdk');
+  const outputPath = resolveWithinRoot(root, outputDir);
+  const modules = generateModules(await fetchOpenApi(openApiUrl), readOwnershipManifest(root, manifestFile), "/api");
+  node_fs.rmSync(outputPath, { recursive: true, force: true });
+  node_fs.mkdirSync(outputPath, { recursive: true });
+  for (const module of modules) {
+    const moduleDir = resolveWithinRoot(outputPath, module.name);
+    node_fs.mkdirSync(moduleDir, { recursive: true });
+    node_fs.writeFileSync(node_path.resolve(moduleDir, "api.ts"), module.code);
+    node_fs.writeFileSync(node_path.resolve(moduleDir, "types.d.ts"), module.types);
+    node_fs.writeFileSync(node_path.resolve(moduleDir, "index.ts"), `export * from './api'
+export * from './types.d'
+`);
+  }
+  node_fs.writeFileSync(node_path.resolve(outputPath, "index.ts"), modules.map((module) => `export * as ${module.name.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase())} from './${module.name}'`).join("\n") + "\n");
+  node_fs.writeFileSync(node_path.resolve(outputPath, "manifest.json"), `${JSON.stringify({
+    version: 1,
+    modules: modules.map(({ name, paths, schemas }) => ({ name, paths, schemas }))
+  }, null, 2)}
+`);
+}
+
+async function resolveOpenApiUrl(root, mode = "development") {
+  const configPath = node_path.resolve(root, "bgl.config.ts");
+  if (!node_fs.existsSync(configPath)) return void 0;
+  const module = await import(`file://${configPath}`);
+  const workspace = module.default;
+  return typeof workspace === "function" ? workspace(mode)?.openapi_url : void 0;
+}
 async function generateSDK(root = process__default.cwd(), options = {}) {
   console.log("\n\u{1F527} Generating SDK from OpenAPI...\n");
-  let config = null;
   let openApiUrl;
   try {
-    const configPath = node_path.resolve(root, "bgl.config.ts");
-    if (node_fs.existsSync(configPath)) {
-      const module = await import(`file://${configPath}`);
-      const workspace = module.default;
-      if (typeof workspace === "function") {
-        config = workspace(options.mode ?? "development");
-        if (config?.openapi_url) {
-          openApiUrl = config.openapi_url;
-        }
-      }
-    }
+    openApiUrl = await resolveOpenApiUrl(root, options.mode);
   } catch {
   }
   const response = await prompts__default([
@@ -710,6 +757,11 @@ async function generateSDK(root = process__default.cwd(), options = {}) {
   console.log(`\u{1F500} Split mode: ${splitFiles ? "per-module" : "monolithic"}
 `);
   try {
+    if (options.manifest) {
+      await generateOwnedModules(root, finalUrl, outputDir, options.manifest);
+      console.log("\n\u2705 Generated deterministic per-module SDK!");
+      return;
+    }
     const { openAPI } = await import('@bagelink/sdk');
     const { types, code } = await openAPI(finalUrl, "/api");
     const outputPath = node_path.resolve(root, outputDir);
@@ -769,20 +821,9 @@ Import directly in your code:`);
 }
 async function generateSDKForWorkspace(root = process__default.cwd(), options = {}) {
   console.log("\n\u{1F3E2} Generating SDK for workspace...\n");
-  let config = null;
   let openApiUrl;
   try {
-    const configPath = node_path.resolve(root, "bgl.config.ts");
-    if (node_fs.existsSync(configPath)) {
-      const module = await import(`file://${configPath}`);
-      const workspace = module.default;
-      if (typeof workspace === "function") {
-        config = workspace(options.mode ?? "development");
-        if (config?.openapi_url) {
-          openApiUrl = config.openapi_url;
-        }
-      }
-    }
+    openApiUrl = await resolveOpenApiUrl(root, options.mode);
   } catch {
   }
   const response = await prompts__default({
@@ -804,6 +845,11 @@ async function generateSDKForWorkspace(root = process__default.cwd(), options =
   console.log(`\u{1F500} Split mode: ${splitFiles ? "per-module" : "monolithic"}
 `);
   try {
+    if (options.manifest) {
+      await generateOwnedModules(root, finalUrl, `${outputDir}/modules`, options.manifest);
+      console.log("\n\u2705 Generated deterministic per-module SDK in shared/modules!");
+      return;
+    }
     const { openAPI } = await import('@bagelink/sdk');
     const { types, code } = await openAPI(finalUrl, "/api");
     const outputPath = node_path.resolve(root, outputDir);
@@ -919,16 +965,27 @@ Lint Commands:
       const splitMode = args.includes("--split") || args.includes("-s");
       const modeIndex = args.indexOf("--mode");
       const mode = modeIndex >= 0 ? args[modeIndex + 1] : void 0;
+      const manifestIndex = args.indexOf("--manifest");
+      const manifest = manifestIndex >= 0 ? args[manifestIndex + 1] : void 0;
       let workspaceMode = isWorkspace(process__default.cwd());
       if (forceWorkspace) workspaceMode = true;
       if (forceProject) workspaceMode = false;
-      const sdkOptions = { split: splitMode || void 0, mode };
+      const sdkOptions = { split: splitMode || void 0, mode, manifest };
       if (workspaceMode) {
         console.log("\u2713 Detected workspace mode - will generate for multiple projects");
         await generateSDKForWorkspace(process__default.cwd(), sdkOptions);
       } else {
         await generateSDK(process__default.cwd(), sdkOptions);
       }
+    } else if (subcommand === "validate") {
+      const modeIndex = args.indexOf("--mode");
+      const mode = modeIndex >= 0 ? args[modeIndex + 1] : void 0;
+      const manifestIndex = args.indexOf("--manifest");
+      const manifest = manifestIndex >= 0 ? args[manifestIndex + 1] : void 0;
+      const openApiUrl = await resolveOpenApiUrl(process__default.cwd(), mode);
+      if (!openApiUrl) throw new Error("No openapi_url found in bgl.config.ts");
+      await validateOpenApiConformance(process__default.cwd(), openApiUrl, manifest);
+      console.log("\u2705 OpenAPI conforms to explicit module ownership manifest");
     } else {
       console.log(`
 SDK Commands:
@@ -937,6 +994,8 @@ SDK Commands:
   bgl sdk generate --workspace   Force workspace mode
   bgl sdk generate --project     Force single project mode
   bgl sdk generate --mode <env>  Use openapi_url from that bgl.config.ts env
+  bgl sdk generate --manifest <path> Generate explicit per-module SDK files
+  bgl sdk validate [--manifest <path>] Validate endpoint ownership and schemas
 `);
       process__default.exit(1);
     }
@@ -976,12 +1035,14 @@ Usage:
   bgl lint init             Set up linting (auto-detects workspace)
   bgl sdk generate          Generate SDK (auto-detects workspace)
   bgl sdk generate --split  Generate per-module API files
+  bgl sdk validate          Validate OpenAPI module ownership
 
 Options:
   --workspace, -w           Force workspace mode
   --project, -p             Force single project mode
   --split, -s               Split SDK into per-module files
   --mode <env>              Set environment (matches bgl.config.ts keys)
+  --manifest <path>         Ownership manifest (default: openapi.modules.json)
   --help, -h                Show this help message
 
 Note: Commands auto-detect workspace mode based on directory structure

package/dist/bin/bgl.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { resolve } from 'node:path';
+import { resolve, relative } from 'node:path';
 import process from 'node:process';
 import { spawn } from 'node:child_process';
 import { l as listProjects, w as writeNetlifyConfig, i as initWorkspace, a as addProject } from '../shared/workspace.Dhg5QE-j.mjs';
-import { existsSync, readFileSync, readdirSync, writeFileSync, unlinkSync, mkdirSync, rmSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync, writeFileSync, unlinkSync, rmSync, mkdirSync } from 'node:fs';
 import prompts from 'prompts';
 
 async function runBuild(filter, additionalArgs = []) {
@@ -652,22 +652,69 @@ function updatePackageJsonLint(root, configs) {
   }
 }
 
+const DEFAULT_OWNERSHIP_MANIFEST = "openapi.modules.json";
+function resolveWithinRoot(root, file) {
+  const absoluteRoot = resolve(root);
+  const path = resolve(absoluteRoot, file);
+  const relativePath = relative(absoluteRoot, path);
+  if (relativePath.startsWith("..") || relativePath.includes("/../") || relativePath === "") {
+    throw new Error(`Path must be inside the project root: ${file}`);
+  }
+  return path;
+}
+function readOwnershipManifest(root, file = DEFAULT_OWNERSHIP_MANIFEST) {
+  const path = resolveWithinRoot(root, file);
+  if (!existsSync(path)) throw new Error(`Module ownership manifest not found: ${path}`);
+  return JSON.parse(readFileSync(path, "utf8"));
+}
+async function fetchOpenApi(url) {
+  const response = await fetch(url, {
+    headers: { Authorization: "Basic YmFnZWxfdXNlcm5hbWU6Tm90U2VjdXJlQGJhZ2Vs" }
+  });
+  if (!response.ok) throw new Error(`HTTP ${response.status}: failed to fetch ${url}`);
+  return await response.json();
+}
+async function validateOpenApiConformance(root, openApiUrl, manifestFile = DEFAULT_OWNERSHIP_MANIFEST) {
+  const { validateOwnershipManifest } = await import('@bagelink/sdk');
+  const issues = validateOwnershipManifest(await fetchOpenApi(openApiUrl), readOwnershipManifest(root, manifestFile));
+  if (issues.length) throw new Error(`OpenAPI ownership conformance failed:
+${issues.map((issue) => `- ${issue.message}`).join("\n")}`);
+}
+async function generateOwnedModules(root, openApiUrl, outputDir, manifestFile = DEFAULT_OWNERSHIP_MANIFEST) {
+  const { generateModules } = await import('@bagelink/sdk');
+  const outputPath = resolveWithinRoot(root, outputDir);
+  const modules = generateModules(await fetchOpenApi(openApiUrl), readOwnershipManifest(root, manifestFile), "/api");
+  rmSync(outputPath, { recursive: true, force: true });
+  mkdirSync(outputPath, { recursive: true });
+  for (const module of modules) {
+    const moduleDir = resolveWithinRoot(outputPath, module.name);
+    mkdirSync(moduleDir, { recursive: true });
+    writeFileSync(resolve(moduleDir, "api.ts"), module.code);
+    writeFileSync(resolve(moduleDir, "types.d.ts"), module.types);
+    writeFileSync(resolve(moduleDir, "index.ts"), `export * from './api'
+export * from './types.d'
+`);
+  }
+  writeFileSync(resolve(outputPath, "index.ts"), modules.map((module) => `export * as ${module.name.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase())} from './${module.name}'`).join("\n") + "\n");
+  writeFileSync(resolve(outputPath, "manifest.json"), `${JSON.stringify({
+    version: 1,
+    modules: modules.map(({ name, paths, schemas }) => ({ name, paths, schemas }))
+  }, null, 2)}
+`);
+}
+
+async function resolveOpenApiUrl(root, mode = "development") {
+  const configPath = resolve(root, "bgl.config.ts");
+  if (!existsSync(configPath)) return void 0;
+  const module = await import(`file://${configPath}`);
+  const workspace = module.default;
+  return typeof workspace === "function" ? workspace(mode)?.openapi_url : void 0;
+}
 async function generateSDK(root = process.cwd(), options = {}) {
   console.log("\n\u{1F527} Generating SDK from OpenAPI...\n");
-  let config = null;
   let openApiUrl;
   try {
-    const configPath = resolve(root, "bgl.config.ts");
-    if (existsSync(configPath)) {
-      const module = await import(`file://${configPath}`);
-      const workspace = module.default;
-      if (typeof workspace === "function") {
-        config = workspace(options.mode ?? "development");
-        if (config?.openapi_url) {
-          openApiUrl = config.openapi_url;
-        }
-      }
-    }
+    openApiUrl = await resolveOpenApiUrl(root, options.mode);
   } catch {
   }
   const response = await prompts([
@@ -703,6 +750,11 @@ async function generateSDK(root = process.cwd(), options = {}) {
   console.log(`\u{1F500} Split mode: ${splitFiles ? "per-module" : "monolithic"}
 `);
   try {
+    if (options.manifest) {
+      await generateOwnedModules(root, finalUrl, outputDir, options.manifest);
+      console.log("\n\u2705 Generated deterministic per-module SDK!");
+      return;
+    }
     const { openAPI } = await import('@bagelink/sdk');
     const { types, code } = await openAPI(finalUrl, "/api");
     const outputPath = resolve(root, outputDir);
@@ -762,20 +814,9 @@ Import directly in your code:`);
 }
 async function generateSDKForWorkspace(root = process.cwd(), options = {}) {
   console.log("\n\u{1F3E2} Generating SDK for workspace...\n");
-  let config = null;
   let openApiUrl;
   try {
-    const configPath = resolve(root, "bgl.config.ts");
-    if (existsSync(configPath)) {
-      const module = await import(`file://${configPath}`);
-      const workspace = module.default;
-      if (typeof workspace === "function") {
-        config = workspace(options.mode ?? "development");
-        if (config?.openapi_url) {
-          openApiUrl = config.openapi_url;
-        }
-      }
-    }
+    openApiUrl = await resolveOpenApiUrl(root, options.mode);
   } catch {
   }
   const response = await prompts({
@@ -797,6 +838,11 @@ async function generateSDKForWorkspace(root = process.cwd(), options = {}) {
   console.log(`\u{1F500} Split mode: ${splitFiles ? "per-module" : "monolithic"}
 `);
   try {
+    if (options.manifest) {
+      await generateOwnedModules(root, finalUrl, `${outputDir}/modules`, options.manifest);
+      console.log("\n\u2705 Generated deterministic per-module SDK in shared/modules!");
+      return;
+    }
     const { openAPI } = await import('@bagelink/sdk');
     const { types, code } = await openAPI(finalUrl, "/api");
     const outputPath = resolve(root, outputDir);
@@ -912,16 +958,27 @@ Lint Commands:
       const splitMode = args.includes("--split") || args.includes("-s");
       const modeIndex = args.indexOf("--mode");
       const mode = modeIndex >= 0 ? args[modeIndex + 1] : void 0;
+      const manifestIndex = args.indexOf("--manifest");
+      const manifest = manifestIndex >= 0 ? args[manifestIndex + 1] : void 0;
       let workspaceMode = isWorkspace(process.cwd());
       if (forceWorkspace) workspaceMode = true;
       if (forceProject) workspaceMode = false;
-      const sdkOptions = { split: splitMode || void 0, mode };
+      const sdkOptions = { split: splitMode || void 0, mode, manifest };
       if (workspaceMode) {
         console.log("\u2713 Detected workspace mode - will generate for multiple projects");
         await generateSDKForWorkspace(process.cwd(), sdkOptions);
       } else {
         await generateSDK(process.cwd(), sdkOptions);
       }
+    } else if (subcommand === "validate") {
+      const modeIndex = args.indexOf("--mode");
+      const mode = modeIndex >= 0 ? args[modeIndex + 1] : void 0;
+      const manifestIndex = args.indexOf("--manifest");
+      const manifest = manifestIndex >= 0 ? args[manifestIndex + 1] : void 0;
+      const openApiUrl = await resolveOpenApiUrl(process.cwd(), mode);
+      if (!openApiUrl) throw new Error("No openapi_url found in bgl.config.ts");
+      await validateOpenApiConformance(process.cwd(), openApiUrl, manifest);
+      console.log("\u2705 OpenAPI conforms to explicit module ownership manifest");
     } else {
       console.log(`
 SDK Commands:
@@ -930,6 +987,8 @@ SDK Commands:
   bgl sdk generate --workspace   Force workspace mode
   bgl sdk generate --project     Force single project mode
   bgl sdk generate --mode <env>  Use openapi_url from that bgl.config.ts env
+  bgl sdk generate --manifest <path> Generate explicit per-module SDK files
+  bgl sdk validate [--manifest <path>] Validate endpoint ownership and schemas
 `);
       process.exit(1);
     }
@@ -969,12 +1028,14 @@ Usage:
   bgl lint init             Set up linting (auto-detects workspace)
   bgl sdk generate          Generate SDK (auto-detects workspace)
   bgl sdk generate --split  Generate per-module API files
+  bgl sdk validate          Validate OpenAPI module ownership
 
 Options:
   --workspace, -w           Force workspace mode
   --project, -p             Force single project mode
   --split, -s               Split SDK into per-module files
   --mode <env>              Set environment (matches bgl.config.ts keys)
+  --manifest <path>         Ownership manifest (default: openapi.modules.json)
   --help, -h                Show this help message
 
 Note: Commands auto-detect workspace mode based on directory structure

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bagelink/workspace",
   "type": "module",
-  "version": "1.15.558",
+  "version": "1.15.562",
   "description": "Monorepo workspace tooling for Bagel projects with proxy and config management",
   "author": {
     "name": "Bagel Studio",

package/src/openapi.ts

@@ -0,0 +1,64 @@
+import type { ModuleOwnershipManifest, OpenAPIObject } from '@bagelink/sdk'
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { relative, resolve } from 'node:path'
+
+export const DEFAULT_OWNERSHIP_MANIFEST = 'openapi.modules.json'
+
+function resolveWithinRoot(root: string, file: string): string {
+	const absoluteRoot = resolve(root)
+	const path = resolve(absoluteRoot, file)
+	const relativePath = relative(absoluteRoot, path)
+	if (relativePath.startsWith('..') || relativePath.includes('/../') || relativePath === '') {
+		throw new Error(`Path must be inside the project root: ${file}`)
+	}
+	return path
+}
+
+export function readOwnershipManifest(root: string, file = DEFAULT_OWNERSHIP_MANIFEST): ModuleOwnershipManifest {
+	const path = resolveWithinRoot(root, file)
+	if (!existsSync(path)) throw new Error(`Module ownership manifest not found: ${path}`)
+	return JSON.parse(readFileSync(path, 'utf8')) as ModuleOwnershipManifest
+}
+
+export async function fetchOpenApi(url: string): Promise<OpenAPIObject> {
+	const response = await fetch(url, {
+		headers: { Authorization: 'Basic YmFnZWxfdXNlcm5hbWU6Tm90U2VjdXJlQGJhZ2Vs' },
+	})
+	if (!response.ok) throw new Error(`HTTP ${response.status}: failed to fetch ${url}`)
+	return await response.json() as OpenAPIObject
+}
+
+export async function validateOpenApiConformance(
+	root: string,
+	openApiUrl: string,
+	manifestFile = DEFAULT_OWNERSHIP_MANIFEST,
+): Promise<void> {
+	const { validateOwnershipManifest } = await import('@bagelink/sdk')
+	const issues = validateOwnershipManifest(await fetchOpenApi(openApiUrl), readOwnershipManifest(root, manifestFile))
+	if (issues.length) throw new Error(`OpenAPI ownership conformance failed:\n${issues.map(issue => `- ${issue.message}`).join('\n')}`)
+}
+
+export async function generateOwnedModules(
+	root: string,
+	openApiUrl: string,
+	outputDir: string,
+	manifestFile = DEFAULT_OWNERSHIP_MANIFEST,
+): Promise<void> {
+	const { generateModules } = await import('@bagelink/sdk')
+	const outputPath = resolveWithinRoot(root, outputDir)
+	const modules = generateModules(await fetchOpenApi(openApiUrl), readOwnershipManifest(root, manifestFile), '/api')
+	rmSync(outputPath, { recursive: true, force: true })
+	mkdirSync(outputPath, { recursive: true })
+	for (const module of modules) {
+		const moduleDir = resolveWithinRoot(outputPath, module.name)
+		mkdirSync(moduleDir, { recursive: true })
+		writeFileSync(resolve(moduleDir, 'api.ts'), module.code)
+		writeFileSync(resolve(moduleDir, 'types.d.ts'), module.types)
+		writeFileSync(resolve(moduleDir, 'index.ts'), `export * from './api'\nexport * from './types.d'\n`)
+	}
+	writeFileSync(resolve(outputPath, 'index.ts'), modules.map(module => `export * as ${module.name.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase())} from './${module.name}'`).join('\n') + '\n')
+	writeFileSync(resolve(outputPath, 'manifest.json'), `${JSON.stringify({
+		version: 1,
+		modules: modules.map(({ name, paths, schemas }) => ({ name, paths, schemas })),
+	}, null, 2)}\n`)
+}

package/src/sdk.ts

@@ -1,14 +1,24 @@
-import type { WorkspaceConfig } from './types'
 import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs'
 import { resolve } from 'node:path'
 import process from 'node:process'
 import prompts from 'prompts'
+import { generateOwnedModules } from './openapi'
 
 export interface GenerateSDKOptions {
 	/** Force split mode (per-module files) */
 	split?: boolean
 	/** Which bgl.config.ts environment's openapi_url to use (default: 'development') */
 	mode?: string
+	/** Explicit module ownership manifest path, relative to the project root */
+	manifest?: string
+}
+
+export async function resolveOpenApiUrl(root: string, mode = 'development'): Promise<string | undefined> {
+	const configPath = resolve(root, 'bgl.config.ts')
+	if (!existsSync(configPath)) return undefined
+	const module = await import(`file://${configPath}`)
+	const workspace = module.default
+	return typeof workspace === 'function' ? workspace(mode)?.openapi_url : undefined
 }
 
 /**
@@ -21,21 +31,10 @@ export async function generateSDK(
 	console.log('\n🔧 Generating SDK from OpenAPI...\n')
 
 	// Try to load config
-	let config: WorkspaceConfig | null = null
 	let openApiUrl: string | undefined
 
 	try {
-		const configPath = resolve(root, 'bgl.config.ts')
-		if (existsSync(configPath)) {
-			const module = await import(`file://${configPath}`)
-			const workspace = module.default
-			if (typeof workspace === 'function') {
-				config = workspace(options.mode ?? 'development')
-				if (config?.openapi_url) {
-					openApiUrl = config.openapi_url
-				}
-			}
-		}
+		openApiUrl = await resolveOpenApiUrl(root, options.mode)
 	}
 	catch {
 		// Ignore config load errors
@@ -77,6 +76,11 @@ export async function generateSDK(
 	console.log(`🔀 Split mode: ${splitFiles ? 'per-module' : 'monolithic'}\n`)
 
 	try {
+		if (options.manifest) {
+			await generateOwnedModules(root, finalUrl, outputDir, options.manifest)
+			console.log('\n✅ Generated deterministic per-module SDK!')
+			return
+		}
 		const { openAPI } = await import('@bagelink/sdk')
 
 		const { types, code } = await openAPI(finalUrl, '/api')
@@ -157,21 +161,10 @@ export async function generateSDKForWorkspace(
 	console.log('\n🏢 Generating SDK for workspace...\n')
 
 	// Try to load config
-	let config: WorkspaceConfig | null = null
 	let openApiUrl: string | undefined
 
 	try {
-		const configPath = resolve(root, 'bgl.config.ts')
-		if (existsSync(configPath)) {
-			const module = await import(`file://${configPath}`)
-			const workspace = module.default
-			if (typeof workspace === 'function') {
-				config = workspace(options.mode ?? 'development')
-				if (config?.openapi_url) {
-					openApiUrl = config.openapi_url
-				}
-			}
-		}
+		openApiUrl = await resolveOpenApiUrl(root, options.mode)
 	}
 	catch {
 		// Ignore config load errors
@@ -199,6 +192,11 @@ export async function generateSDKForWorkspace(
 	console.log(`🔀 Split mode: ${splitFiles ? 'per-module' : 'monolithic'}\n`)
 
 	try {
+		if (options.manifest) {
+			await generateOwnedModules(root, finalUrl, `${outputDir}/modules`, options.manifest)
+			console.log('\n✅ Generated deterministic per-module SDK in shared/modules!')
+			return
+		}
 		const { openAPI } = await import('@bagelink/sdk')
 
 		const { types, code } = await openAPI(finalUrl, '/api')