@objectstack/cli 3.0.5 → 3.0.7

package/dist/index.js

@@ -1,2799 +1,20 @@
-import {
-  collectMetadataStats,
-  configExists,
-  createTimer,
-  formatZodErrors,
-  loadConfig,
-  printError,
-  printHeader,
-  printInfo,
-  printKV,
-  printMetadataStats,
-  printServerReady,
-  printStep,
-  printSuccess,
-  printWarning,
-  resolveConfigPath
-} from "./chunk-CSHQEILI.js";
-
-// src/commands/compile.ts
-import { Command } from "commander";
-import path from "path";
-import fs from "fs";
-import chalk from "chalk";
-import { ObjectStackDefinitionSchema } from "@objectstack/spec";
-var compileCommand = new Command("compile").description("Compile ObjectStack configuration to JSON artifact").argument("[config]", "Source configuration file").option("-o, --output <path>", "Output JSON file", "dist/objectstack.json").option("--json", "Output compile result as JSON (for CI)").action(async (configPath, options) => {
-  const timer = createTimer();
-  if (!options.json) {
-    printHeader("Compile");
-  }
-  try {
-    if (!options.json) printStep("Loading configuration...");
-    const { config, absolutePath, duration } = await loadConfig(configPath);
-    if (!options.json) {
-      printKV("Config", path.relative(process.cwd(), absolutePath));
-      printKV("Load time", `${duration}ms`);
-    }
-    if (!options.json) printStep("Validating protocol compliance...");
-    const result = ObjectStackDefinitionSchema.safeParse(config);
-    if (!result.success) {
-      if (options.json) {
-        console.log(JSON.stringify({ success: false, errors: result.error.issues }));
-        process.exit(1);
-      }
-      console.log("");
-      printError("Validation failed");
-      formatZodErrors(result.error);
-      process.exit(1);
-    }
-    if (!options.json) printStep("Writing artifact...");
-    const output = options.output;
-    const artifactPath = path.resolve(process.cwd(), output);
-    const artifactDir = path.dirname(artifactPath);
-    if (!fs.existsSync(artifactDir)) {
-      fs.mkdirSync(artifactDir, { recursive: true });
-    }
-    const jsonContent = JSON.stringify(result.data, null, 2);
-    fs.writeFileSync(artifactPath, jsonContent);
-    const sizeKB = (jsonContent.length / 1024).toFixed(1);
-    const stats = collectMetadataStats(config);
-    if (options.json) {
-      console.log(JSON.stringify({
-        success: true,
-        output: artifactPath,
-        size: jsonContent.length,
-        stats,
-        duration: timer.elapsed()
-      }));
-      return;
-    }
-    console.log("");
-    printSuccess(`Build complete ${chalk.dim(`(${timer.display()})`)}`);
-    console.log("");
-    printMetadataStats(stats);
-    console.log("");
-    printKV("Artifact", `${output} ${chalk.dim(`(${sizeKB} KB`)})`);
-    console.log("");
-  } catch (error) {
-    if (options.json) {
-      console.log(JSON.stringify({ success: false, error: error.message }));
-      process.exit(1);
-    }
-    console.log("");
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-
-// src/commands/validate.ts
-import { Command as Command2 } from "commander";
-import chalk2 from "chalk";
-import { ObjectStackDefinitionSchema as ObjectStackDefinitionSchema2 } from "@objectstack/spec";
-var validateCommand = new Command2("validate").description("Validate ObjectStack configuration against the protocol schema").argument("[config]", "Configuration file path").option("--strict", "Treat warnings as errors").option("--json", "Output results as JSON").action(async (configPath, options) => {
-  const timer = createTimer();
-  if (!options.json) {
-    printHeader("Validate");
-  }
-  try {
-    if (!options.json) printStep("Loading configuration...");
-    const { config, absolutePath, duration } = await loadConfig(configPath);
-    if (!options.json) {
-      printKV("Config", absolutePath);
-      printKV("Load time", `${duration}ms`);
-    }
-    if (!options.json) printStep("Validating against ObjectStack Protocol...");
-    const result = ObjectStackDefinitionSchema2.safeParse(config);
-    if (!result.success) {
-      if (options.json) {
-        console.log(JSON.stringify({
-          valid: false,
-          errors: result.error.issues,
-          duration: timer.elapsed()
-        }, null, 2));
-        process.exit(1);
-      }
-      console.log("");
-      printError("Validation failed");
-      formatZodErrors(result.error);
-      process.exit(1);
-    }
-    const stats = collectMetadataStats(config);
-    if (options.json) {
-      console.log(JSON.stringify({
-        valid: true,
-        manifest: config.manifest,
-        stats,
-        duration: timer.elapsed()
-      }, null, 2));
-      return;
-    }
-    const warnings = [];
-    if (stats.objects === 0) {
-      warnings.push("No objects defined \u2014 this stack has no data model");
-    }
-    if (stats.apps === 0 && stats.plugins === 0) {
-      warnings.push("No apps or plugins defined \u2014 this stack may not do much");
-    }
-    if (!config.manifest?.id) {
-      warnings.push("Missing manifest.id \u2014 required for deployment");
-    }
-    if (!config.manifest?.namespace) {
-      warnings.push("Missing manifest.namespace \u2014 required for multi-app hosting");
-    }
-    console.log("");
-    printSuccess(`Validation passed ${chalk2.dim(`(${timer.display()})`)}`);
-    console.log("");
-    if (config.manifest) {
-      console.log(`  ${chalk2.bold(config.manifest.name || config.manifest.id || "Unnamed")} ${chalk2.dim(`v${config.manifest.version || "0.0.0"}`)}`);
-      if (config.manifest.description) {
-        console.log(chalk2.dim(`  ${config.manifest.description}`));
-      }
-      console.log("");
-    }
-    printMetadataStats(stats);
-    if (warnings.length > 0) {
-      console.log("");
-      for (const w of warnings) {
-        console.log(chalk2.yellow(`  \u26A0 ${w}`));
-      }
-      if (options.strict) {
-        console.log("");
-        printError("Strict mode: warnings treated as errors");
-        process.exit(1);
-      }
-    }
-    console.log("");
-  } catch (error) {
-    if (options.json) {
-      console.log(JSON.stringify({
-        valid: false,
-        error: error.message,
-        duration: timer.elapsed()
-      }, null, 2));
-      process.exit(1);
-    }
-    console.log("");
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-
-// src/commands/info.ts
-import { Command as Command3 } from "commander";
-import chalk3 from "chalk";
-var infoCommand = new Command3("info").description("Display metadata summary of an ObjectStack configuration").argument("[config]", "Configuration file path").option("--json", "Output as JSON").action(async (configPath, options) => {
-  const timer = createTimer();
-  if (!options.json) {
-    printHeader("Info");
-  }
-  try {
-    const { config, absolutePath, duration } = await loadConfig(configPath);
-    const stats = collectMetadataStats(config);
-    if (options.json) {
-      console.log(JSON.stringify({
-        config: absolutePath,
-        manifest: config.manifest || null,
-        stats,
-        objects: (config.objects || []).map((o) => ({
-          name: o.name,
-          label: o.label,
-          fields: o.fields ? Object.keys(o.fields).length : 0
-        })),
-        loadTime: duration
-      }, null, 2));
-      return;
-    }
-    if (config.manifest) {
-      const m = config.manifest;
-      console.log("");
-      console.log(`  ${chalk3.bold(m.name || m.id || "Unnamed")} ${chalk3.dim(`v${m.version || "0.0.0"}`)}`);
-      if (m.id) console.log(chalk3.dim(`  ${m.id}`));
-      if (m.description) console.log(chalk3.dim(`  ${m.description}`));
-      if (m.namespace) printKV("  Namespace", m.namespace);
-      if (m.type) printKV("  Type", m.type);
-    }
-    console.log("");
-    printMetadataStats(stats);
-    if (config.objects && config.objects.length > 0) {
-      console.log("");
-      console.log(chalk3.bold("  Objects:"));
-      for (const obj of config.objects) {
-        const fieldCount = obj.fields ? Object.keys(obj.fields).length : 0;
-        const ownership = obj.ownership || "own";
-        console.log(
-          `    ${chalk3.cyan(obj.name || "?")}` + chalk3.dim(` (${fieldCount} fields, ${ownership})`) + (obj.label ? chalk3.dim(` \u2014 ${obj.label}`) : "")
-        );
-      }
-    }
-    if (config.agents && config.agents.length > 0) {
-      console.log("");
-      console.log(chalk3.bold("  Agents:"));
-      for (const agent of config.agents) {
-        console.log(
-          `    ${chalk3.magenta(agent.name || "?")}` + (agent.role ? chalk3.dim(` \u2014 ${agent.role}`) : "")
-        );
-      }
-    }
-    if (config.apps && config.apps.length > 0) {
-      console.log("");
-      console.log(chalk3.bold("  Apps:"));
-      for (const app of config.apps) {
-        console.log(
-          `    ${chalk3.green(app.name || "?")}` + (app.label ? chalk3.dim(` \u2014 ${app.label}`) : "")
-        );
-      }
-    }
-    console.log("");
-    console.log(chalk3.dim(`  Loaded in ${duration}ms`));
-    console.log("");
-  } catch (error) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: error.message }));
-      process.exit(1);
-    }
-    console.log("");
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-
-// src/commands/init.ts
-import { Command as Command4 } from "commander";
-import chalk4 from "chalk";
-import fs2 from "fs";
-import path2 from "path";
-var TEMPLATES = {
-  app: {
-    description: "Full application with objects, views, and actions",
-    dependencies: {
-      "@objectstack/spec": "workspace:*",
-      "@objectstack/runtime": "workspace:^",
-      "@objectstack/objectql": "workspace:^",
-      "@objectstack/driver-memory": "workspace:^"
-    },
-    devDependencies: {
-      "@objectstack/cli": "workspace:*",
-      "typescript": "^5.3.0"
-    },
-    scripts: {
-      dev: "objectstack dev",
-      start: "objectstack serve",
-      build: "objectstack compile",
-      validate: "objectstack validate",
-      typecheck: "tsc --noEmit"
-    },
-    configContent: (name) => `import { defineStack } from '@objectstack/spec';
-import * as objects from './src/objects';
-
-export default defineStack({
-  manifest: {
-    id: 'com.example.${name}',
-    namespace: '${name}',
-    version: '0.1.0',
-    type: 'app',
-    name: '${toTitleCase(name)}',
-    description: '${toTitleCase(name)} application built with ObjectStack',
-  },
-
-  objects: Object.values(objects),
-});
-`,
-    srcFiles: {
-      "src/objects/index.ts": (name) => `export { default as ${toCamelCase(name)} } from './${name}';
-`,
-      "src/objects/__name__.ts": (name) => `import { Data } from '@objectstack/spec';
-
-const ${toCamelCase(name)}: Data.Object = {
-  name: '${name}',
-  label: '${toTitleCase(name)}',
-  ownership: 'own',
-  fields: {
-    name: {
-      type: 'text',
-      label: 'Name',
-      required: true,
-    },
-    description: {
-      type: 'textarea',
-      label: 'Description',
-    },
-    status: {
-      type: 'select',
-      label: 'Status',
-      options: [
-        { label: 'Draft', value: 'draft' },
-        { label: 'Active', value: 'active' },
-        { label: 'Archived', value: 'archived' },
-      ],
-      defaultValue: 'draft',
-    },
-  },
-};
-
-export default ${toCamelCase(name)};
-`
-    }
-  },
-  plugin: {
-    description: "Reusable plugin with objects and extensions",
-    dependencies: {
-      "@objectstack/spec": "workspace:*"
-    },
-    devDependencies: {
-      "typescript": "^5.3.0",
-      "vitest": "^4.0.18"
-    },
-    scripts: {
-      build: "objectstack compile",
-      validate: "objectstack validate",
-      test: "vitest run",
-      typecheck: "tsc --noEmit"
-    },
-    configContent: (name) => `import { defineStack } from '@objectstack/spec';
-import * as objects from './src/objects';
-
-export default defineStack({
-  manifest: {
-    id: 'com.objectstack.plugin-${name}',
-    namespace: 'plugin_${name}',
-    version: '0.1.0',
-    type: 'plugin',
-    name: '${toTitleCase(name)} Plugin',
-    description: 'ObjectStack Plugin: ${toTitleCase(name)}',
-  },
-
-  objects: Object.values(objects),
-});
-`,
-    srcFiles: {
-      "src/objects/index.ts": (name) => `export { default as ${toCamelCase(name)} } from './${name}';
-`,
-      "src/objects/__name__.ts": (name) => `import { Data } from '@objectstack/spec';
-
-const ${toCamelCase(name)}: Data.Object = {
-  name: '${name}',
-  label: '${toTitleCase(name)}',
-  ownership: 'own',
-  fields: {
-    name: {
-      type: 'text',
-      label: 'Name',
-      required: true,
-    },
-  },
-};
-
-export default ${toCamelCase(name)};
-`
-    }
-  },
-  empty: {
-    description: "Minimal project with just a config file",
-    dependencies: {
-      "@objectstack/spec": "workspace:*"
-    },
-    devDependencies: {
-      "@objectstack/cli": "workspace:*",
-      "typescript": "^5.3.0"
-    },
-    scripts: {
-      build: "objectstack compile",
-      validate: "objectstack validate",
-      typecheck: "tsc --noEmit"
-    },
-    configContent: (name) => `import { defineStack } from '@objectstack/spec';
-
-export default defineStack({
-  manifest: {
-    id: 'com.example.${name}',
-    namespace: '${name}',
-    version: '0.1.0',
-    type: 'app',
-    name: '${toTitleCase(name)}',
-    description: '',
-  },
-});
-`,
-    srcFiles: {}
-  }
-};
-function toCamelCase(str) {
-  return str.replace(/[-_]([a-z])/g, (_, c) => c.toUpperCase());
-}
-function toTitleCase(str) {
-  return str.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-}
-var initCommand = new Command4("init").description("Initialize a new ObjectStack project in the current directory").argument("[name]", "Project name (defaults to directory name)").option("-t, --template <template>", "Template: app, plugin, empty", "app").option("--no-install", "Skip dependency installation").action(async (name, options) => {
-  printHeader("Init");
-  const cwd = process.cwd();
-  const projectName = name || path2.basename(cwd);
-  const template = TEMPLATES[options.template];
-  if (!template) {
-    printError(`Unknown template: ${options.template}`);
-    console.log(chalk4.dim(`  Available: ${Object.keys(TEMPLATES).join(", ")}`));
-    process.exit(1);
-  }
-  if (fs2.existsSync(path2.join(cwd, "objectstack.config.ts"))) {
-    printError("objectstack.config.ts already exists in this directory");
-    console.log(chalk4.dim("  Use `objectstack generate` to add metadata to an existing project"));
-    process.exit(1);
-  }
-  printKV("Project", projectName);
-  printKV("Template", `${options.template} \u2014 ${template.description}`);
-  printKV("Directory", cwd);
-  console.log("");
-  const createdFiles = [];
-  try {
-    const pkgPath = path2.join(cwd, "package.json");
-    if (!fs2.existsSync(pkgPath)) {
-      const pkg = {
-        name: projectName,
-        version: "0.1.0",
-        private: true,
-        type: "module",
-        scripts: template.scripts,
-        dependencies: template.dependencies,
-        devDependencies: template.devDependencies
-      };
-      fs2.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-      createdFiles.push("package.json");
-    } else {
-      printInfo("package.json already exists, skipping");
-    }
-    const configContent = template.configContent(projectName);
-    fs2.writeFileSync(path2.join(cwd, "objectstack.config.ts"), configContent);
-    createdFiles.push("objectstack.config.ts");
-    const tsconfigPath = path2.join(cwd, "tsconfig.json");
-    if (!fs2.existsSync(tsconfigPath)) {
-      const tsconfig = {
-        compilerOptions: {
-          target: "ES2022",
-          module: "ESNext",
-          moduleResolution: "bundler",
-          strict: true,
-          esModuleInterop: true,
-          skipLibCheck: true,
-          outDir: "dist",
-          rootDir: ".",
-          declaration: true
-        },
-        include: ["*.ts", "src/**/*"],
-        exclude: ["dist", "node_modules"]
-      };
-      fs2.writeFileSync(tsconfigPath, JSON.stringify(tsconfig, null, 2) + "\n");
-      createdFiles.push("tsconfig.json");
-    }
-    for (const [filePath, contentFn] of Object.entries(template.srcFiles)) {
-      const resolvedPath = filePath.replace("__name__", projectName);
-      const fullPath = path2.join(cwd, resolvedPath);
-      const dir = path2.dirname(fullPath);
-      if (!fs2.existsSync(dir)) {
-        fs2.mkdirSync(dir, { recursive: true });
-      }
-      fs2.writeFileSync(fullPath, contentFn(projectName));
-      createdFiles.push(resolvedPath);
-    }
-    const gitignorePath = path2.join(cwd, ".gitignore");
-    if (!fs2.existsSync(gitignorePath)) {
-      fs2.writeFileSync(gitignorePath, `node_modules/
-dist/
-*.tsbuildinfo
-`);
-      createdFiles.push(".gitignore");
-    }
-    console.log(chalk4.bold("  Created files:"));
-    for (const f of createdFiles) {
-      console.log(chalk4.green(`    + ${f}`));
-    }
-    console.log("");
-    if (options.install !== false) {
-      printStep("Installing dependencies...");
-      const { execSync: execSync3 } = await import("child_process");
-      try {
-        execSync3("pnpm install", { stdio: "inherit", cwd });
-      } catch {
-        printWarning2("Dependency installation failed. Run `pnpm install` manually.");
-      }
-    }
-    printSuccess("Project initialized!");
-    console.log("");
-    console.log(chalk4.bold("  Next steps:"));
-    console.log(chalk4.dim("    objectstack validate   # Check configuration"));
-    console.log(chalk4.dim("    objectstack dev        # Start development server"));
-    console.log(chalk4.dim("    objectstack generate   # Add objects, views, etc."));
-    console.log("");
-  } catch (error) {
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-function printWarning2(msg) {
-  console.log(chalk4.yellow(`  \u26A0 ${msg}`));
-}
-
-// src/commands/generate.ts
-import { Command as Command5 } from "commander";
-import chalk5 from "chalk";
-import fs3 from "fs";
-import path3 from "path";
-var GENERATORS = {
-  object: {
-    description: "Business data object",
-    defaultDir: "src/objects",
-    generate: (name) => `import { Data } from '@objectstack/spec';
-
-/**
- * ${toTitleCase2(name)} Object
- */
-const ${toCamelCase2(name)}: Data.Object = {
-  name: '${toSnakeCase(name)}',
-  label: '${toTitleCase2(name)}',
-  pluralLabel: '${toTitleCase2(name)}s',
-  ownership: 'own',
-  fields: {
-    name: {
-      type: 'text',
-      label: 'Name',
-      required: true,
-      maxLength: 255,
-    },
-    description: {
-      type: 'textarea',
-      label: 'Description',
-    },
-  },
-};
-
-export default ${toCamelCase2(name)};
-`
-  },
-  view: {
-    description: "List or form view",
-    defaultDir: "src/views",
-    generate: (name) => `import { UI } from '@objectstack/spec';
-
-/**
- * ${toTitleCase2(name)} List View
- */
-const ${toCamelCase2(name)}ListView: UI.View = {
-  name: '${toSnakeCase(name)}_list',
-  label: '${toTitleCase2(name)} List',
-  type: 'list',
-  objectName: '${toSnakeCase(name)}',
-  list: {
-    type: 'grid',
-    columns: [
-      { field: 'name', width: 200 },
-    ],
-    defaultSort: { field: 'name', direction: 'asc' },
-    pageSize: 25,
-  },
-};
-
-export default ${toCamelCase2(name)}ListView;
-`
-  },
-  action: {
-    description: "Button or batch action",
-    defaultDir: "src/actions",
-    generate: (name) => `import { UI } from '@objectstack/spec';
-
-/**
- * ${toTitleCase2(name)} Action
- */
-const ${toCamelCase2(name)}Action: UI.Action = {
-  name: '${toSnakeCase(name)}',
-  label: '${toTitleCase2(name)}',
-  type: 'custom',
-  objectName: '${toSnakeCase(name)}',
-  handler: {
-    type: 'flow',
-    target: '${toSnakeCase(name)}_flow',
-  },
-};
-
-export default ${toCamelCase2(name)}Action;
-`
-  },
-  flow: {
-    description: "Automation flow",
-    defaultDir: "src/flows",
-    generate: (name) => `import { Automation } from '@objectstack/spec';
-
-/**
- * ${toTitleCase2(name)} Flow
- */
-const ${toCamelCase2(name)}Flow: Automation.Flow = {
-  name: '${toSnakeCase(name)}_flow',
-  label: '${toTitleCase2(name)} Flow',
-  type: 'autolaunched',
-  status: 'draft',
-  trigger: {
-    type: 'record_change',
-    object: '${toSnakeCase(name)}',
-    events: ['after_insert', 'after_update'],
-  },
-  nodes: [
-    {
-      id: 'start',
-      type: 'start',
-      name: 'Start',
-      next: 'end',
-    },
-  ],
-};
-
-export default ${toCamelCase2(name)}Flow;
-`
-  },
-  agent: {
-    description: "AI agent",
-    defaultDir: "src/agents",
-    generate: (name) => `import { AI } from '@objectstack/spec';
-
-/**
- * ${toTitleCase2(name)} Agent
- */
-const ${toCamelCase2(name)}Agent: AI.Agent = {
-  name: '${toSnakeCase(name)}_agent',
-  label: '${toTitleCase2(name)} Agent',
-  role: '${toTitleCase2(name)} assistant',
-  instructions: 'You are a helpful ${toTitleCase2(name).toLowerCase()} assistant.',
-  model: {
-    provider: 'openai',
-    model: 'gpt-4o',
-  },
-  tools: [],
-};
-
-export default ${toCamelCase2(name)}Agent;
-`
-  },
-  dashboard: {
-    description: "Analytics dashboard",
-    defaultDir: "src/dashboards",
-    generate: (name) => `import { UI } from '@objectstack/spec';
-
-/**
- * ${toTitleCase2(name)} Dashboard
- */
-const ${toCamelCase2(name)}Dashboard: UI.Dashboard = {
-  name: '${toSnakeCase(name)}_dashboard',
-  label: '${toTitleCase2(name)} Dashboard',
-  widgets: [],
-};
-
-export default ${toCamelCase2(name)}Dashboard;
-`
-  },
-  app: {
-    description: "Application navigation",
-    defaultDir: "src/apps",
-    generate: (name) => `import { UI } from '@objectstack/spec';
-
-/**
- * ${toTitleCase2(name)} App
- */
-const ${toCamelCase2(name)}App: UI.App = {
-  name: '${toSnakeCase(name)}_app',
-  label: '${toTitleCase2(name)}',
-  navigation: {
-    type: 'sidebar',
-    items: [],
-  },
-};
-
-export default ${toCamelCase2(name)}App;
-`
-  }
-};
-function toCamelCase2(str) {
-  return str.replace(/[-_]([a-z])/g, (_, c) => c.toUpperCase());
-}
-function toTitleCase2(str) {
-  return str.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-}
-function toSnakeCase(str) {
-  return str.replace(/[-]/g, "_").replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`).replace(/^_/, "");
-}
-var FIELD_TYPE_MAP = {
-  text: "string",
-  textarea: "string",
-  richtext: "string",
-  html: "string",
-  markdown: "string",
-  number: "number",
-  integer: "number",
-  currency: "number",
-  percent: "number",
-  boolean: "boolean",
-  date: "string",
-  datetime: "string",
-  time: "string",
-  email: "string",
-  phone: "string",
-  url: "string",
-  select: "string",
-  multiselect: "string[]",
-  lookup: "string",
-  master_detail: "string",
-  formula: "unknown",
-  autonumber: "string",
-  json: "Record<string, unknown>",
-  file: "string",
-  image: "string",
-  password: "string",
-  slug: "string",
-  uuid: "string",
-  ip_address: "string",
-  color: "string",
-  rating: "number",
-  geo_point: "{ lat: number; lng: number }",
-  vector: "number[]",
-  encrypted: "string"
-};
-function fieldTypeToTs(fieldType, multiple) {
-  const base = FIELD_TYPE_MAP[fieldType] || "unknown";
-  return multiple ? `${base}[]` : base;
-}
-function generateTypesFromConfig(config) {
-  const lines = [
-    "// Auto-generated by ObjectStack CLI \u2014 do not edit manually",
-    `// Generated at ${(/* @__PURE__ */ new Date()).toISOString()}`,
-    "",
-    "import type { Data } from '@objectstack/spec';",
-    ""
-  ];
-  const objects = [];
-  const rawObjects = config.objects ?? config.data?.objects ?? {};
-  if (Array.isArray(rawObjects)) {
-    objects.push(...rawObjects);
-  } else if (typeof rawObjects === "object") {
-    for (const val of Object.values(rawObjects)) {
-      if (val && typeof val === "object") objects.push(val);
-    }
-  }
-  if (objects.length === 0) {
-    lines.push("// No objects found in configuration");
-    return lines.join("\n") + "\n";
-  }
-  for (const obj of objects) {
-    const name = String(obj.name || "unknown");
-    const typeName = name.split("_").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
-    const fields = obj.fields ?? {};
-    lines.push(`/** ${String(obj.label || typeName)} record type */`);
-    lines.push(`export interface ${typeName}Record {`);
-    lines.push("  id: string;");
-    for (const [fieldName, fieldDef] of Object.entries(fields)) {
-      const fType = String(fieldDef.type || "text");
-      const tsType = fieldTypeToTs(fType, !!fieldDef.multiple);
-      const required = fieldDef.required ? "" : "?";
-      if (fieldDef.label) {
-        lines.push(`  /** ${fieldDef.label} */`);
-      }
-      lines.push(`  ${fieldName}${required}: ${tsType};`);
-    }
-    lines.push("}");
-    lines.push("");
-  }
-  return lines.join("\n") + "\n";
-}
-var generateMetadataCommand = new Command5("metadata").alias("m").description("Generate metadata scaffold (object, view, action, flow, agent, dashboard, app)").argument("<type>", "Metadata type to generate").argument("<name>", "Name for the metadata (use kebab-case)").option("-d, --dir <directory>", "Target directory (overrides default)").option("--dry-run", "Show what would be created without writing files").action(async (type, name, options) => {
-  printHeader("Generate");
-  const generator = GENERATORS[type];
-  if (!generator) {
-    printError(`Unknown type: ${type}`);
-    console.log("");
-    console.log(chalk5.bold("  Available types:"));
-    for (const [key, gen] of Object.entries(GENERATORS)) {
-      console.log(`    ${chalk5.cyan(key.padEnd(12))} ${chalk5.dim(gen.description)}`);
-    }
-    console.log("");
-    console.log(chalk5.dim("  Usage: objectstack generate <type> <name>"));
-    console.log(chalk5.dim("  Example: objectstack generate object project"));
-    console.log(chalk5.dim("  Alias: os g object project"));
-    process.exit(1);
-  }
-  const dir = options.dir || generator.defaultDir;
-  const fileName = `${toSnakeCase(name)}.ts`;
-  const filePath = path3.join(process.cwd(), dir, fileName);
-  console.log(`  ${chalk5.dim("Type:")}  ${chalk5.cyan(type)} \u2014 ${generator.description}`);
-  console.log(`  ${chalk5.dim("Name:")}  ${chalk5.white(name)}`);
-  console.log(`  ${chalk5.dim("File:")}  ${chalk5.white(path3.join(dir, fileName))}`);
-  console.log("");
-  if (options.dryRun) {
-    printInfo("Dry run \u2014 no files written");
-    console.log("");
-    console.log(chalk5.dim("  Content:"));
-    console.log(chalk5.dim("  " + "-".repeat(38)));
-    const content = generator.generate(name);
-    for (const line of content.split("\n")) {
-      console.log(chalk5.dim(`  ${line}`));
-    }
-    console.log("");
-    return;
-  }
-  if (fs3.existsSync(filePath)) {
-    printError(`File already exists: ${filePath}`);
-    process.exit(1);
-  }
-  try {
-    const fullDir = path3.dirname(filePath);
-    if (!fs3.existsSync(fullDir)) {
-      fs3.mkdirSync(fullDir, { recursive: true });
-    }
-    const content = generator.generate(name);
-    fs3.writeFileSync(filePath, content);
-    printSuccess(`Created ${path3.join(dir, fileName)}`);
-    const indexPath = path3.join(process.cwd(), dir, "index.ts");
-    if (fs3.existsSync(indexPath)) {
-      const indexContent = fs3.readFileSync(indexPath, "utf-8");
-      const exportLine = `export { default as ${toCamelCase2(name)} } from './${toSnakeCase(name)}';`;
-      if (!indexContent.includes(toCamelCase2(name))) {
-        fs3.appendFileSync(indexPath, exportLine + "\n");
-        printSuccess(`Updated ${dir}/index.ts with export`);
-      }
-    } else {
-      const exportLine = `export { default as ${toCamelCase2(name)} } from './${toSnakeCase(name)}';
-`;
-      fs3.writeFileSync(indexPath, exportLine);
-      printSuccess(`Created ${dir}/index.ts`);
-    }
-    console.log("");
-    console.log(chalk5.dim(`  Tip: Run \`objectstack validate\` to check your config`));
-    console.log("");
-  } catch (error) {
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-var generateTypesCommand = new Command5("types").description("Generate TypeScript type definitions from ObjectStack configuration").argument("[config]", "Configuration file path").option("-o, --output <file>", "Output file path", "src/types/objectstack.d.ts").option("--dry-run", "Show what would be generated without writing files").action(async (configPath, options) => {
-  printHeader("Generate Types");
-  try {
-    const { loadConfig: loadConfig2 } = await import("./config-UN34WBHT.js");
-    printInfo("Loading configuration...");
-    const { config, absolutePath } = await loadConfig2(configPath);
-    console.log(`  ${chalk5.dim("Config:")} ${chalk5.white(absolutePath)}`);
-    console.log(`  ${chalk5.dim("Output:")} ${chalk5.white(options.output)}`);
-    console.log("");
-    const content = generateTypesFromConfig(config);
-    if (options.dryRun) {
-      printInfo("Dry run \u2014 no files written");
-      console.log("");
-      for (const line of content.split("\n")) {
-        console.log(chalk5.dim(`  ${line}`));
-      }
-      console.log("");
-      return;
-    }
-    const outPath = path3.resolve(process.cwd(), options.output);
-    const outDir = path3.dirname(outPath);
-    if (!fs3.existsSync(outDir)) {
-      fs3.mkdirSync(outDir, { recursive: true });
-    }
-    fs3.writeFileSync(outPath, content);
-    printSuccess(`Generated types at ${options.output}`);
-    console.log("");
-  } catch (error) {
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-function generateClientFromConfig(config) {
-  const lines = [
-    "// Auto-generated by ObjectStack CLI \u2014 do not edit manually",
-    `// Generated at ${(/* @__PURE__ */ new Date()).toISOString()}`,
-    "",
-    "import type { Data } from '@objectstack/spec';",
-    ""
-  ];
-  const objects = [];
-  const rawObjects = config.objects ?? config.data?.objects ?? {};
-  if (Array.isArray(rawObjects)) {
-    objects.push(...rawObjects);
-  } else if (typeof rawObjects === "object") {
-    for (const val of Object.values(rawObjects)) {
-      if (val && typeof val === "object") objects.push(val);
-    }
-  }
-  if (objects.length === 0) {
-    lines.push("// No objects found in configuration");
-    return lines.join("\n") + "\n";
-  }
-  for (const obj of objects) {
-    const name = String(obj.name || "unknown");
-    const typeName = name.split("_").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
-    const fields = obj.fields ?? {};
-    lines.push(`export interface ${typeName}Record {`);
-    lines.push("  id: string;");
-    for (const [fieldName, fieldDef] of Object.entries(fields)) {
-      const fType = String(fieldDef.type || "text");
-      const tsType = fieldTypeToTs(fType, !!fieldDef.multiple);
-      const required = fieldDef.required ? "" : "?";
-      lines.push(`  ${fieldName}${required}: ${tsType};`);
-    }
-    lines.push("}");
-    lines.push("");
-  }
-  lines.push("export class ObjectStackClient {");
-  lines.push("  constructor(private baseUrl: string, private headers: Record<string, string> = {}) {}");
-  lines.push("");
-  lines.push("  private async request<T>(method: string, path: string, body?: unknown): Promise<T> {");
-  lines.push("    const res = await fetch(`${this.baseUrl}${path}`, {");
-  lines.push("      method,");
-  lines.push("      headers: { 'Content-Type': 'application/json', ...this.headers },");
-  lines.push("      body: body ? JSON.stringify(body) : undefined,");
-  lines.push("    });");
-  lines.push("    if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`);");
-  lines.push("    return res.json() as Promise<T>;");
-  lines.push("  }");
-  for (const obj of objects) {
-    const name = String(obj.name || "unknown");
-    const typeName = name.split("_").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
-    const endpoint = `/api/${name}`;
-    lines.push("");
-    lines.push(`  async list${typeName}(): Promise<${typeName}Record[]> {`);
-    lines.push(`    return this.request<${typeName}Record[]>('GET', '${endpoint}');`);
-    lines.push("  }");
-    lines.push("");
-    lines.push(`  async get${typeName}(id: string): Promise<${typeName}Record> {`);
-    lines.push(`    return this.request<${typeName}Record>('GET', '${endpoint}/\${id}');`);
-    lines.push("  }");
-    lines.push("");
-    lines.push(`  async create${typeName}(data: Omit<${typeName}Record, 'id'>): Promise<${typeName}Record> {`);
-    lines.push(`    return this.request<${typeName}Record>('POST', '${endpoint}', data);`);
-    lines.push("  }");
-    lines.push("");
-    lines.push(`  async update${typeName}(id: string, data: Partial<${typeName}Record>): Promise<${typeName}Record> {`);
-    lines.push(`    return this.request<${typeName}Record>('PATCH', '${endpoint}/\${id}', data);`);
-    lines.push("  }");
-    lines.push("");
-    lines.push(`  async delete${typeName}(id: string): Promise<void> {`);
-    lines.push(`    return this.request<void>('DELETE', '${endpoint}/\${id}');`);
-    lines.push("  }");
-  }
-  lines.push("}");
-  lines.push("");
-  return lines.join("\n") + "\n";
-}
-var generateClientCommand = new Command5("client").description("Generate a type-safe client SDK from ObjectStack configuration").argument("[config]", "Configuration file path").option("-o, --output <file>", "Output file path", "src/client/objectstack-client.ts").option("--dry-run", "Show output without writing").action(async (configPath, options) => {
-  printHeader("Generate Client SDK");
-  try {
-    const { loadConfig: loadConfig2 } = await import("./config-UN34WBHT.js");
-    const timer = createTimer();
-    printInfo("Loading configuration...");
-    const { config, absolutePath } = await loadConfig2(configPath);
-    console.log(`  ${chalk5.dim("Config:")} ${chalk5.white(absolutePath)}`);
-    console.log(`  ${chalk5.dim("Output:")} ${chalk5.white(options.output)}`);
-    console.log("");
-    printStep("Generating client SDK...");
-    const content = generateClientFromConfig(config);
-    if (options.dryRun) {
-      printInfo("Dry run \u2014 no files written");
-      console.log("");
-      for (const line of content.split("\n")) {
-        console.log(chalk5.dim(`  ${line}`));
-      }
-      console.log("");
-      return;
-    }
-    const outPath = path3.resolve(process.cwd(), options.output);
-    const outDir = path3.dirname(outPath);
-    if (!fs3.existsSync(outDir)) {
-      fs3.mkdirSync(outDir, { recursive: true });
-    }
-    fs3.writeFileSync(outPath, content);
-    printSuccess(`Generated client SDK at ${options.output} (${timer.display()})`);
-    console.log("");
-  } catch (error) {
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-var FIELD_TYPE_SQL_MAP = {
-  text: "VARCHAR(255)",
-  textarea: "TEXT",
-  richtext: "TEXT",
-  html: "TEXT",
-  markdown: "TEXT",
-  number: "DECIMAL(18,2)",
-  integer: "INTEGER",
-  currency: "DECIMAL(18,2)",
-  percent: "DECIMAL(5,2)",
-  boolean: "BOOLEAN",
-  date: "DATE",
-  datetime: "TIMESTAMP",
-  time: "TIME",
-  email: "VARCHAR(255)",
-  phone: "VARCHAR(50)",
-  url: "VARCHAR(2048)",
-  select: "VARCHAR(255)",
-  multiselect: "TEXT",
-  lookup: "VARCHAR(36)",
-  master_detail: "VARCHAR(36)",
-  formula: "TEXT",
-  autonumber: "SERIAL",
-  json: "JSONB",
-  file: "VARCHAR(2048)",
-  image: "VARCHAR(2048)",
-  password: "VARCHAR(255)",
-  slug: "VARCHAR(255)",
-  uuid: "UUID",
-  ip_address: "VARCHAR(45)",
-  color: "VARCHAR(7)",
-  rating: "INTEGER",
-  geo_point: "POINT",
-  vector: "VECTOR",
-  encrypted: "TEXT"
-};
-function fieldTypeToSql(fieldType) {
-  return FIELD_TYPE_SQL_MAP[fieldType] || "TEXT";
-}
-function generateMigrationSql(config) {
-  const lines = [
-    "-- Auto-generated by ObjectStack CLI \u2014 do not edit manually",
-    `-- Generated at ${(/* @__PURE__ */ new Date()).toISOString()}`,
-    ""
-  ];
-  const objects = [];
-  const rawObjects = config.objects ?? config.data?.objects ?? {};
-  if (Array.isArray(rawObjects)) {
-    objects.push(...rawObjects);
-  } else if (typeof rawObjects === "object") {
-    for (const val of Object.values(rawObjects)) {
-      if (val && typeof val === "object") objects.push(val);
-    }
-  }
-  if (objects.length === 0) {
-    lines.push("-- No objects found in configuration");
-    return lines.join("\n") + "\n";
-  }
-  for (const obj of objects) {
-    const tableName = String(obj.name || "unknown");
-    const fields = obj.fields ?? {};
-    lines.push(`CREATE TABLE IF NOT EXISTS "${tableName}" (`);
-    lines.push('  "id" UUID PRIMARY KEY DEFAULT gen_random_uuid(),');
-    const fieldLines = [];
-    for (const [fieldName, fieldDef] of Object.entries(fields)) {
-      const sqlType = fieldTypeToSql(String(fieldDef.type || "text"));
-      const notNull = fieldDef.required ? " NOT NULL" : "";
-      fieldLines.push(`  "${fieldName}" ${sqlType}${notNull}`);
-    }
-    fieldLines.push('  "created_at" TIMESTAMP NOT NULL DEFAULT now()');
-    fieldLines.push('  "updated_at" TIMESTAMP NOT NULL DEFAULT now()');
-    lines.push(fieldLines.join(",\n"));
-    lines.push(");");
-    lines.push("");
-  }
-  return lines.join("\n") + "\n";
-}
-function generateMigrationTs(config) {
-  const lines = [
-    "// Auto-generated by ObjectStack CLI \u2014 do not edit manually",
-    `// Generated at ${(/* @__PURE__ */ new Date()).toISOString()}`,
-    "",
-    "export async function up(db: any): Promise<void> {"
-  ];
-  const objects = [];
-  const rawObjects = config.objects ?? config.data?.objects ?? {};
-  if (Array.isArray(rawObjects)) {
-    objects.push(...rawObjects);
-  } else if (typeof rawObjects === "object") {
-    for (const val of Object.values(rawObjects)) {
-      if (val && typeof val === "object") objects.push(val);
-    }
-  }
-  if (objects.length === 0) {
-    lines.push("  // No objects found in configuration");
-    lines.push("}");
-    lines.push("");
-    lines.push("export async function down(db: any): Promise<void> {");
-    lines.push("  // No objects found in configuration");
-    lines.push("}");
-    return lines.join("\n") + "\n";
-  }
-  for (const obj of objects) {
-    const tableName = String(obj.name || "unknown");
-    const fields = obj.fields ?? {};
-    lines.push(`  await db.schema.createTable('${tableName}', (table: any) => {`);
-    lines.push("    table.uuid('id').primary().defaultTo(db.fn.uuid());");
-    for (const [fieldName, fieldDef] of Object.entries(fields)) {
-      const fType = String(fieldDef.type || "text");
-      const required = fieldDef.required ? ".notNullable()" : ".nullable()";
-      let colMethod;
-      switch (fType) {
-        case "text":
-        case "email":
-        case "phone":
-        case "url":
-        case "select":
-        case "slug":
-        case "password":
-        case "color":
-        case "ip_address":
-          colMethod = `table.string('${fieldName}')`;
-          break;
-        case "textarea":
-        case "richtext":
-        case "html":
-        case "markdown":
-        case "formula":
-        case "encrypted":
-          colMethod = `table.text('${fieldName}')`;
-          break;
-        case "number":
-        case "currency":
-        case "percent":
-          colMethod = `table.decimal('${fieldName}')`;
-          break;
-        case "integer":
-        case "rating":
-          colMethod = `table.integer('${fieldName}')`;
-          break;
-        case "boolean":
-          colMethod = `table.boolean('${fieldName}')`;
-          break;
-        case "date":
-          colMethod = `table.date('${fieldName}')`;
-          break;
-        case "datetime":
-          colMethod = `table.timestamp('${fieldName}')`;
-          break;
-        case "time":
-          colMethod = `table.time('${fieldName}')`;
-          break;
-        case "json":
-        case "multiselect":
-          colMethod = `table.jsonb('${fieldName}')`;
-          break;
-        case "uuid":
-        case "lookup":
-        case "master_detail":
-          colMethod = `table.uuid('${fieldName}')`;
-          break;
-        default:
-          colMethod = `table.text('${fieldName}')`;
-      }
-      lines.push(`    ${colMethod}${required};`);
-    }
-    lines.push("    table.timestamps(true, true);");
-    lines.push("  });");
-  }
-  lines.push("}");
-  lines.push("");
-  lines.push("export async function down(db: any): Promise<void> {");
-  const tableNames = objects.map((o) => String(o.name || "unknown")).reverse();
-  for (const tableName of tableNames) {
-    lines.push(`  await db.schema.dropTableIfExists('${tableName}');`);
-  }
-  lines.push("}");
-  return lines.join("\n") + "\n";
-}
-var generateMigrationCommand = new Command5("migration").description("Generate database migration from ObjectStack schema").argument("[config]", "Configuration file path").option("-o, --output <file>", "Output file path").option("--format <format>", "Output format: sql or typescript", "typescript").option("--dry-run", "Show output without writing").action(async (configPath, options) => {
-  printHeader("Generate Migration");
-  try {
-    const { loadConfig: loadConfig2 } = await import("./config-UN34WBHT.js");
-    const timer = createTimer();
-    printInfo("Loading configuration...");
-    const { config, absolutePath } = await loadConfig2(configPath);
-    const ext = options.format === "sql" ? "sql" : "ts";
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[-:T]/g, "").slice(0, 14);
-    const defaultOutput = `migrations/${timestamp}_migration.${ext}`;
-    const output = options.output || defaultOutput;
-    console.log(`  ${chalk5.dim("Config:")} ${chalk5.white(absolutePath)}`);
-    console.log(`  ${chalk5.dim("Format:")} ${chalk5.white(options.format)}`);
-    console.log(`  ${chalk5.dim("Output:")} ${chalk5.white(output)}`);
-    console.log("");
-    printStep("Generating migration...");
-    const content = options.format === "sql" ? generateMigrationSql(config) : generateMigrationTs(config);
-    if (options.dryRun) {
-      printInfo("Dry run \u2014 no files written");
-      console.log("");
-      for (const line of content.split("\n")) {
-        console.log(chalk5.dim(`  ${line}`));
-      }
-      console.log("");
-      return;
-    }
-    const outPath = path3.resolve(process.cwd(), output);
-    const outDir = path3.dirname(outPath);
-    if (!fs3.existsSync(outDir)) {
-      fs3.mkdirSync(outDir, { recursive: true });
-    }
-    fs3.writeFileSync(outPath, content);
-    printSuccess(`Generated migration at ${output} (${timer.display()})`);
-    console.log("");
-  } catch (error) {
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-var generateSchemaCommand = new Command5("schema").description("Generate JSON Schema for objectstack.config.ts (for IDE autocomplete)").option("-o, --output <file>", "Output file path", "objectstack.schema.json").option("--dry-run", "Show output without writing").action(async (options) => {
-  printHeader("Generate Schema");
-  try {
-    const timer = createTimer();
-    printStep("Loading ObjectStackDefinitionSchema...");
-    const { z } = await import("zod");
-    const { ObjectStackDefinitionSchema: ObjectStackDefinitionSchema3 } = await import("@objectstack/spec");
-    printStep("Converting to JSON Schema...");
-    const jsonSchema = z.toJSONSchema(ObjectStackDefinitionSchema3, {
-      target: "draft-2020-12"
-    });
-    const schema = {
-      ...jsonSchema,
-      $id: "https://schema.objectstack.io/objectstack.config.json",
-      title: "ObjectStack Configuration",
-      description: "JSON Schema for objectstack.config.ts \u2014 generated from ObjectStackDefinitionSchema"
-    };
-    const content = JSON.stringify(schema, null, 2) + "\n";
-    if (options.dryRun) {
-      printInfo("Dry run \u2014 no files written");
-      console.log("");
-      console.log(content);
-      return;
-    }
-    const outPath = path3.resolve(process.cwd(), options.output);
-    const outDir = path3.dirname(outPath);
-    if (!fs3.existsSync(outDir)) {
-      fs3.mkdirSync(outDir, { recursive: true });
-    }
-    fs3.writeFileSync(outPath, content);
-    printSuccess(`Generated JSON Schema at ${options.output} (${timer.display()})`);
-    console.log("");
-    console.log(chalk5.dim("  Usage: Reference in your IDE or editor for autocomplete"));
-    console.log(chalk5.dim(`  Path:  ${outPath}`));
-    console.log("");
-  } catch (error) {
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-var generateCommand = new Command5("generate").alias("g").description("Generate metadata files or TypeScript types").argument("[type]", "Metadata type to generate (object, view, action, flow, agent, dashboard, app)").argument("[name]", "Name for the metadata (use kebab-case)").option("-d, --dir <directory>", "Target directory (overrides default)").option("--dry-run", "Show what would be created without writing files").addCommand(generateTypesCommand).addCommand(generateClientCommand).addCommand(generateMigrationCommand).addCommand(generateSchemaCommand).action(async (type, name, options) => {
-  if (!type) {
-    printHeader("Generate");
-    console.log(chalk5.bold("  Sub-commands:"));
-    console.log(`    ${chalk5.cyan("types".padEnd(12))} Generate TypeScript type definitions from config`);
-    console.log(`    ${chalk5.cyan("client".padEnd(12))} Generate a type-safe client SDK from config`);
-    console.log(`    ${chalk5.cyan("migration".padEnd(12))} Generate database migration from schema`);
-    console.log(`    ${chalk5.cyan("schema".padEnd(12))} Generate JSON Schema for objectstack.config.ts (IDE autocomplete)`);
-    console.log("");
-    console.log(chalk5.bold("  Metadata types:"));
-    for (const [key, gen] of Object.entries(GENERATORS)) {
-      console.log(`    ${chalk5.cyan(key.padEnd(12))} ${chalk5.dim(gen.description)}`);
-    }
-    console.log("");
-    console.log(chalk5.dim("  Usage: objectstack generate <type> <name>"));
-    console.log(chalk5.dim("  Usage: objectstack generate types [config]"));
-    return;
-  }
-  if (!name) {
-    printError("Missing required argument: <name>");
-    console.log(chalk5.dim("  Usage: objectstack generate <type> <name>"));
-    process.exit(1);
-  }
-  await generateMetadataCommand.parseAsync([type, name, ...process.argv.slice(4)], { from: "user" });
-});
-
-// src/commands/create.ts
-import { Command as Command6 } from "commander";
-import chalk6 from "chalk";
-import fs4 from "fs";
-import path4 from "path";
-var templates = {
-  plugin: {
-    description: "Create a new ObjectStack plugin",
-    files: {
-      "package.json": (name) => ({
-        name: `@objectstack/plugin-${name}`,
-        version: "0.1.0",
-        description: `ObjectStack Plugin: ${name}`,
-        main: "dist/index.js",
-        types: "dist/index.d.ts",
-        scripts: {
-          build: "tsc",
-          dev: "tsc --watch",
-          test: "vitest"
-        },
-        keywords: ["objectstack", "plugin", name],
-        author: "",
-        license: "MIT",
-        dependencies: {
-          "@objectstack/spec": "workspace:*",
-          zod: "^4.3.6"
-        },
-        devDependencies: {
-          "@types/node": "^22.0.0",
-          typescript: "^5.8.0",
-          vitest: "^4.0.0"
-        }
-      }),
-      "tsconfig.json": () => ({
-        extends: "../../tsconfig.json",
-        compilerOptions: {
-          outDir: "dist",
-          rootDir: "src"
-        },
-        include: ["src/**/*"]
-      }),
-      "src/index.ts": (name) => `import type { Plugin } from '@objectstack/spec';
-
-/**
- * ${name} Plugin for ObjectStack
- */
-export const ${toCamelCase3(name)}Plugin: Plugin = {
-  name: '${name}',
-  version: '0.1.0',
-  
-  async initialize(context) {
-    console.log('Initializing ${name} plugin...');
-    // Plugin initialization logic
-  },
-  
-  async destroy() {
-    console.log('Destroying ${name} plugin...');
-    // Plugin cleanup logic
-  },
-};
-
-export default ${toCamelCase3(name)}Plugin;
-`,
-      "README.md": (name) => `# @objectstack/plugin-${name}
-
-ObjectStack Plugin: ${name}
-
-## Installation
-
-\`\`\`bash
-pnpm add @objectstack/plugin-${name}
-\`\`\`
-
-## Usage
-
-\`\`\`typescript
-import { ${toCamelCase3(name)}Plugin } from '@objectstack/plugin-${name}';
-
-// Use the plugin in your ObjectStack configuration
-export default {
-  plugins: [
-    ${toCamelCase3(name)}Plugin,
-  ],
-};
-\`\`\`
-
-## License
-
-MIT
-`
-    }
-  },
-  example: {
-    description: "Create a new ObjectStack example application",
-    files: {
-      "package.json": (name) => ({
-        name: `@example/${name}`,
-        version: "0.1.0",
-        private: true,
-        description: `ObjectStack Example: ${name}`,
-        scripts: {
-          build: "objectstack compile",
-          dev: "objectstack dev",
-          test: "vitest"
-        },
-        dependencies: {
-          "@objectstack/spec": "workspace:*",
-          "@objectstack/cli": "workspace:*",
-          zod: "^4.3.6"
-        },
-        devDependencies: {
-          "@types/node": "^22.0.0",
-          tsx: "^4.21.0",
-          typescript: "^5.8.0",
-          vitest: "^4.0.0"
-        }
-      }),
-      "objectstack.config.ts": (name) => `import { defineStack } from '@objectstack/spec';
-
-// Barrel imports \u2014 add more as you create new type folders
-// import * as objects from './src/objects';
-// import * as actions from './src/actions';
-// import * as apps from './src/apps';
-
-export default defineStack({
-  manifest: {
-    name: '${name}',
-    version: '0.1.0',
-    description: '${name} example application',
-  },
-  
-  objects: [
-    // Object.values(objects),  // Uncomment after creating src/objects/index.ts
-  ],
-  
-  apps: [
-    // Object.values(apps),     // Uncomment after creating src/apps/index.ts
-  ],
-});
-`,
-      "README.md": (name) => `# ${name} Example
-
-ObjectStack example application: ${name}
-
-## Quick Start
-
-\`\`\`bash
-# Build the configuration
-pnpm build
-
-# Run in development mode
-pnpm dev
-\`\`\`
-
-## Structure
-
-- \`objectstack.config.ts\` - Main configuration file
-- \`dist/objectstack.json\` - Compiled artifact
-
-## Learn More
-
-- [ObjectStack Documentation](../../content/docs)
-- [Examples](../)
-`,
-      "tsconfig.json": () => ({
-        extends: "../../tsconfig.json",
-        compilerOptions: {
-          outDir: "dist",
-          rootDir: "."
-        },
-        include: ["*.ts", "src/**/*"]
-      })
-    }
-  }
-};
-function toCamelCase3(str) {
-  return str.replace(/-([a-z])/g, (g) => g[1].toUpperCase());
-}
-var createCommand = new Command6("create").description("Create a new package, plugin, or example from template").argument("<type>", "Type of project to create (plugin, example)").argument("[name]", "Name of the project").option("-d, --dir <directory>", "Target directory").action(async (type, name, options) => {
-  console.log(chalk6.bold(`
-\u{1F4E6} ObjectStack Project Creator`));
-  console.log(chalk6.dim(`-------------------------------`));
-  if (!templates[type]) {
-    console.error(chalk6.red(`
-\u274C Unknown type: ${type}`));
-    console.log(chalk6.dim("Available types: plugin, example"));
-    process.exit(1);
-  }
-  if (!name) {
-    console.error(chalk6.red("\n\u274C Project name is required"));
-    console.log(chalk6.dim(`Usage: objectstack create ${type} <name>`));
-    process.exit(1);
-  }
-  const template = templates[type];
-  const cwd = process.cwd();
-  let targetDir;
-  if (options?.dir) {
-    targetDir = path4.resolve(cwd, options.dir);
-  } else {
-    const baseDir = type === "plugin" ? "packages/plugins" : "examples";
-    const projectName = type === "plugin" ? `plugin-${name}` : name;
-    targetDir = path4.join(cwd, baseDir, projectName);
-  }
-  if (fs4.existsSync(targetDir)) {
-    console.error(chalk6.red(`
-\u274C Directory already exists: ${targetDir}`));
-    process.exit(1);
-  }
-  console.log(`\u{1F4C1} Creating ${type}: ${chalk6.blue(name)}`);
-  console.log(`\u{1F4C2} Location: ${chalk6.dim(targetDir)}`);
-  console.log("");
-  try {
-    fs4.mkdirSync(targetDir, { recursive: true });
-    for (const [filePath, contentFn] of Object.entries(template.files)) {
-      const fullPath = path4.join(targetDir, filePath);
-      const dir = path4.dirname(fullPath);
-      if (!fs4.existsSync(dir)) {
-        fs4.mkdirSync(dir, { recursive: true });
-      }
-      const content = contentFn(name);
-      const fileContent = typeof content === "string" ? content : JSON.stringify(content, null, 2);
-      fs4.writeFileSync(fullPath, fileContent);
-      console.log(chalk6.green(`\u2713 Created ${filePath}`));
-    }
-    console.log("");
-    console.log(chalk6.green("\u2705 Project created successfully!"));
-    console.log("");
-    console.log(chalk6.bold("Next steps:"));
-    console.log(chalk6.dim(`  cd ${path4.relative(cwd, targetDir)}`));
-    console.log(chalk6.dim("  pnpm install"));
-    console.log(chalk6.dim("  pnpm build"));
-    console.log("");
-  } catch (error) {
-    console.error(chalk6.red("\n\u274C Failed to create project:"));
-    console.error(error.message || error);
-    if (fs4.existsSync(targetDir)) {
-      fs4.rmSync(targetDir, { recursive: true });
-    }
-    process.exit(1);
-  }
-});
-
-// src/commands/plugin.ts
-import { Command as Command7 } from "commander";
-import chalk7 from "chalk";
-import fs5 from "fs";
-import path5 from "path";
-function resolvePluginName(plugin) {
-  if (typeof plugin === "string") return plugin;
-  if (plugin && typeof plugin === "object") {
-    const p = plugin;
-    if (typeof p.name === "string") return p.name;
-    if (p.constructor && p.constructor.name !== "Object") return p.constructor.name;
-  }
-  return "unknown";
-}
-function resolvePluginVersion(plugin) {
-  if (plugin && typeof plugin === "object") {
-    const p = plugin;
-    if (typeof p.version === "string") return p.version;
-  }
-  return "-";
-}
-function resolvePluginType(plugin) {
-  if (plugin && typeof plugin === "object") {
-    const p = plugin;
-    if (typeof p.type === "string") return p.type;
-  }
-  return "standard";
-}
-function readConfigText(configPath) {
-  return fs5.readFileSync(configPath, "utf-8");
-}
-function addPluginToConfig(configPath, packageName) {
-  let content = readConfigText(configPath);
-  const shortName = packageName.replace(/^@[^/]+\//, "").replace(/^plugin-/, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
-  const varName = shortName.replace(/-([a-z])/g, (_, c) => c.toUpperCase()) + "Plugin";
-  const importLine = `import ${varName} from '${packageName}';
-`;
-  if (content.includes(packageName)) {
-    throw new Error(`Plugin '${packageName}' is already referenced in the config`);
-  }
-  const importRegex = /^import .+$/gm;
-  let lastImportEnd = 0;
-  let match;
-  while ((match = importRegex.exec(content)) !== null) {
-    lastImportEnd = match.index + match[0].length;
-  }
-  if (lastImportEnd > 0) {
-    content = content.slice(0, lastImportEnd) + "\n" + importLine + content.slice(lastImportEnd);
-  } else {
-    content = importLine + "\n" + content;
-  }
-  if (/plugins\s*:\s*\[/.test(content)) {
-    let replaced = false;
-    content = content.replace(
-      /(plugins\s*:\s*\[)/,
-      (match2) => {
-        if (replaced) return match2;
-        replaced = true;
-        return `${match2}
-    ${varName},`;
-      }
-    );
-  } else {
-    content = content.replace(
-      /(defineStack\(\{[\s\S]*?)(}\s*\))/,
-      `$1  plugins: [
-    ${varName},
-  ],
-$2`
-    );
-  }
-  fs5.writeFileSync(configPath, content);
-}
-function removePluginFromConfig(configPath, pluginName) {
-  let content = readConfigText(configPath);
-  const importRegex = new RegExp(`^import .+['"]${escapeRegex(pluginName)}['"]\\s*;?\\s*$\\n?`, "gm");
-  const hadImport = importRegex.test(content);
-  importRegex.lastIndex = 0;
-  content = content.replace(importRegex, "");
-  const shortName = pluginName.replace(/^@[^/]+\//, "").replace(/^plugin-/, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
-  const varName = shortName.replace(/-([a-z])/g, (_, c) => c.toUpperCase()) + "Plugin";
-  if (!hadImport) {
-    const varImportRegex = new RegExp(`^import .* ${escapeRegex(varName)} .+$\\n?`, "gm");
-    content = content.replace(varImportRegex, "");
-  }
-  const entryPatterns = [
-    new RegExp(`\\s*${escapeRegex(varName)},?\\n?`, "g"),
-    new RegExp(`\\s*['"]${escapeRegex(pluginName)}['"],?\\n?`, "g")
-  ];
-  for (const pattern of entryPatterns) {
-    content = content.replace(pattern, "\n");
-  }
-  content = content.replace(/plugins\s*:\s*\[\s*\],?\n?/g, "");
-  fs5.writeFileSync(configPath, content);
-}
-function escapeRegex(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-var listCommand = new Command7("list").alias("ls").description("List plugins defined in the configuration").argument("[config]", "Configuration file path").option("--json", "Output as JSON").action(async (configSource, options) => {
-  try {
-    const { config } = await loadConfig(configSource);
-    const plugins = config.plugins || [];
-    const devPlugins = config.devPlugins || [];
-    if (options?.json) {
-      const data = {
-        plugins: plugins.map((p) => ({
-          name: resolvePluginName(p),
-          version: resolvePluginVersion(p),
-          type: resolvePluginType(p),
-          dev: false
-        })),
-        devPlugins: devPlugins.map((p) => ({
-          name: resolvePluginName(p),
-          version: resolvePluginVersion(p),
-          type: resolvePluginType(p),
-          dev: true
-        }))
-      };
-      console.log(JSON.stringify(data, null, 2));
-      return;
-    }
-    printHeader("Plugins");
-    if (plugins.length === 0 && devPlugins.length === 0) {
-      printInfo("No plugins configured");
-      console.log("");
-      console.log(chalk7.dim("  Hint: Add plugins to your objectstack.config.ts"));
-      console.log(chalk7.dim("  Or run: os plugin add <package-name>"));
-      console.log("");
-      return;
-    }
-    if (plugins.length > 0) {
-      console.log(chalk7.bold(`
-  Plugins (${plugins.length}):`));
-      for (const plugin of plugins) {
-        const name = resolvePluginName(plugin);
-        const version = resolvePluginVersion(plugin);
-        const type = resolvePluginType(plugin);
-        console.log(
-          `    ${chalk7.cyan("\u25CF")} ${chalk7.white(name)}` + (version !== "-" ? chalk7.dim(` v${version}`) : "") + (type !== "standard" ? chalk7.dim(` [${type}]`) : "")
-        );
-      }
-    }
-    if (devPlugins.length > 0) {
-      console.log(chalk7.bold(`
-  Dev Plugins (${devPlugins.length}):`));
-      for (const plugin of devPlugins) {
-        const name = resolvePluginName(plugin);
-        const version = resolvePluginVersion(plugin);
-        console.log(
-          `    ${chalk7.yellow("\u25CF")} ${chalk7.white(name)}` + (version !== "-" ? chalk7.dim(` v${version}`) : "") + chalk7.dim(" [dev]")
-        );
-      }
-    }
-    console.log("");
-  } catch (error) {
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-var infoSubCommand = new Command7("info").description("Show detailed information about a plugin").argument("<name>", "Plugin name or package name").argument("[config]", "Configuration file path").action(async (name, configSource) => {
-  try {
-    const { config } = await loadConfig(configSource);
-    const allPlugins = [
-      ...config.plugins || [],
-      ...config.devPlugins || []
-    ];
-    const found = allPlugins.find((p) => {
-      const pName = resolvePluginName(p);
-      return pName === name || pName.includes(name);
-    });
-    if (!found) {
-      printError(`Plugin '${name}' not found in configuration`);
-      console.log("");
-      console.log(chalk7.dim("  Available plugins:"));
-      for (const p of allPlugins) {
-        console.log(chalk7.dim(`    - ${resolvePluginName(p)}`));
-      }
-      console.log("");
-      process.exit(1);
-    }
-    printHeader(`Plugin: ${resolvePluginName(found)}`);
-    printKV("Name", resolvePluginName(found));
-    printKV("Version", resolvePluginVersion(found));
-    printKV("Type", resolvePluginType(found));
-    const isDev = (config.devPlugins || []).includes(found);
-    printKV("Environment", isDev ? "development" : "production");
-    if (found && typeof found === "object") {
-      const p = found;
-      if (typeof p.description === "string") {
-        printKV("Description", p.description);
-      }
-      if (Array.isArray(p.dependencies) && p.dependencies.length > 0) {
-        printKV("Dependencies", p.dependencies.join(", "));
-      }
-      if (typeof p.init === "function") {
-        printInfo("This is a runtime plugin instance (has init function)");
-      }
-    }
-    if (typeof found === "string") {
-      printInfo("This is a string reference (will be imported at runtime)");
-    }
-    console.log("");
-  } catch (error) {
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-var addCommand = new Command7("add").description("Add a plugin to objectstack.config.ts").argument("<package>", "Plugin package name (e.g. @objectstack/plugin-auth)").option("-d, --dev", "Add as a dev-only plugin").option("-c, --config <path>", "Configuration file path").action(async (packageName, options) => {
-  try {
-    const configPath = resolveConfigPath(options?.config);
-    printHeader("Add Plugin");
-    console.log(`  ${chalk7.dim("Package:")} ${chalk7.white(packageName)}`);
-    console.log(`  ${chalk7.dim("Config:")}  ${chalk7.white(path5.relative(process.cwd(), configPath))}`);
-    console.log("");
-    addPluginToConfig(configPath, packageName);
-    printSuccess(`Added ${chalk7.cyan(packageName)} to config`);
-    console.log("");
-    console.log(chalk7.dim("  Next steps:"));
-    console.log(chalk7.dim(`  1. Install the package: pnpm add ${packageName}`));
-    console.log(chalk7.dim("  2. Run: os validate"));
-    console.log("");
-  } catch (error) {
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-var removeCommand = new Command7("remove").alias("rm").description("Remove a plugin from objectstack.config.ts").argument("<name>", "Plugin name or package name to remove").option("-c, --config <path>", "Configuration file path").action(async (pluginName, options) => {
-  try {
-    const configPath = resolveConfigPath(options?.config);
-    printHeader("Remove Plugin");
-    console.log(`  ${chalk7.dim("Plugin:")} ${chalk7.white(pluginName)}`);
-    console.log(`  ${chalk7.dim("Config:")} ${chalk7.white(path5.relative(process.cwd(), configPath))}`);
-    console.log("");
-    removePluginFromConfig(configPath, pluginName);
-    printSuccess(`Removed ${chalk7.cyan(pluginName)} from config`);
-    console.log("");
-    console.log(chalk7.dim("  Tip: Run `pnpm remove " + pluginName + "` to uninstall the package"));
-    console.log("");
-  } catch (error) {
-    printError(error.message || String(error));
-    process.exit(1);
-  }
-});
-var pluginCommand = new Command7("plugin").description("Manage plugins (list, info, add, remove)").addCommand(listCommand).addCommand(infoSubCommand).addCommand(addCommand).addCommand(removeCommand);
-
-// src/commands/dev.ts
-import { Command as Command8 } from "commander";
-import chalk8 from "chalk";
-import { execSync, spawn } from "child_process";
-import fs6 from "fs";
-import path6 from "path";
-var devCommand = new Command8("dev").description("Start development mode with hot-reload").argument("[package]", "Package name or filter pattern", "all").option("-w, --watch", "Enable watch mode (default)", true).option("--ui", "Enable Studio UI at /_studio/").option("-v, --verbose", "Verbose output").action(async (packageName, options) => {
-  printHeader("Development Mode");
-  const configPath = path6.resolve(process.cwd(), "objectstack.config.ts");
-  if (packageName === "all" && fs6.existsSync(configPath)) {
-    printKV("Config", configPath, "\u{1F4C2}");
-    printStep("Starting dev server...");
-    const binPath = process.argv[1];
-    const child = spawn(process.execPath, [binPath, "serve", "--dev", ...options.ui ? ["--ui"] : [], ...options.verbose ? ["--verbose"] : []], {
-      stdio: "inherit",
-      env: { ...process.env, NODE_ENV: "development" }
-    });
-    return;
-  }
-  try {
-    const cwd = process.cwd();
-    const workspaceConfigPath = path6.resolve(cwd, "pnpm-workspace.yaml");
-    const isWorkspaceRoot = fs6.existsSync(workspaceConfigPath);
-    if (packageName === "all" && !isWorkspaceRoot) {
-      printError(`Config file not found in ${cwd}`);
-      console.error(chalk8.yellow("  Run in a directory with objectstack.config.ts, or from the monorepo root."));
-      process.exit(1);
-    }
-    const filter = packageName === "all" ? "" : `--filter ${packageName}`;
-    printKV("Package", packageName === "all" ? "All packages" : packageName, "\u{1F4E6}");
-    printKV("Watch", "enabled", "\u{1F504}");
-    const command = `pnpm ${filter} dev`.trim();
-    console.log(chalk8.dim(`$ ${command}`));
-    console.log("");
-    execSync(command, {
-      stdio: "inherit",
-      cwd
-    });
-  } catch (error) {
-    printError(`Development mode failed: ${error.message || error}`);
-    process.exit(1);
-  }
-});
-
-// src/commands/serve.ts
-import { Command as Command9 } from "commander";
-import path8 from "path";
-import fs8 from "fs";
-import net from "net";
-import chalk9 from "chalk";
-import { bundleRequire } from "bundle-require";
-
-// src/utils/studio.ts
-import path7 from "path";
-import fs7 from "fs";
-import { createRequire } from "module";
-import { pathToFileURL } from "url";
-var STUDIO_PATH = "/_studio";
-function resolveStudioPath() {
-  const cwd = process.cwd();
-  const candidates = [
-    path7.resolve(cwd, "apps/studio"),
-    path7.resolve(cwd, "../../apps/studio"),
-    path7.resolve(cwd, "../apps/studio")
-  ];
-  for (const candidate of candidates) {
-    const pkgPath = path7.join(candidate, "package.json");
-    if (fs7.existsSync(pkgPath)) {
-      try {
-        const pkg = JSON.parse(fs7.readFileSync(pkgPath, "utf-8"));
-        if (pkg.name === "@objectstack/studio") return candidate;
-      } catch {
-      }
-    }
-  }
-  const resolutionBases = [
-    pathToFileURL(path7.join(cwd, "package.json")).href,
-    // consumer workspace
-    import.meta.url
-    // CLI package itself
-  ];
-  for (const base of resolutionBases) {
-    try {
-      const req = createRequire(base);
-      const resolved = req.resolve("@objectstack/studio/package.json");
-      return path7.dirname(resolved);
-    } catch {
-    }
-  }
-  const directPath = path7.join(cwd, "node_modules", "@objectstack", "studio");
-  if (fs7.existsSync(path7.join(directPath, "package.json"))) {
-    return directPath;
-  }
-  return null;
-}
-function hasStudioDist(studioPath) {
-  return fs7.existsSync(path7.join(studioPath, "dist", "index.html"));
-}
-function createStudioStaticPlugin(distPath, options) {
-  return {
-    name: "com.objectstack.studio-static",
-    init: async () => {
-    },
-    start: async (ctx) => {
-      const httpServer = ctx.getService?.("http.server");
-      if (!httpServer?.getRawApp) {
-        ctx.logger?.warn?.("Studio static: http.server service not found \u2014 skipping");
-        return;
-      }
-      const app = httpServer.getRawApp();
-      const absoluteDist = path7.resolve(distPath);
-      const indexPath = path7.join(absoluteDist, "index.html");
-      if (!fs7.existsSync(indexPath)) {
-        ctx.logger?.warn?.(`Studio static: dist not found at ${absoluteDist}`);
-        return;
-      }
-      const rawHtml = fs7.readFileSync(indexPath, "utf-8");
-      const rewrittenHtml = rawHtml.replace(
-        /(\s(?:href|src))="\/(?!\/)/g,
-        `$1="${STUDIO_PATH}/`
-      );
-      if (options?.isDev) {
-        app.get("/", (c) => c.redirect(`${STUDIO_PATH}/`));
-      }
-      app.get(STUDIO_PATH, (c) => c.redirect(`${STUDIO_PATH}/`));
-      app.get(`${STUDIO_PATH}/*`, async (c) => {
-        const reqPath = c.req.path.substring(STUDIO_PATH.length) || "/";
-        const filePath = path7.join(absoluteDist, reqPath);
-        if (!filePath.startsWith(absoluteDist)) {
-          return c.text("Forbidden", 403);
-        }
-        if (fs7.existsSync(filePath) && fs7.statSync(filePath).isFile()) {
-          const content = fs7.readFileSync(filePath);
-          return new Response(content, {
-            headers: { "content-type": mimeType(filePath) }
-          });
-        }
-        return new Response(rewrittenHtml, {
-          headers: { "content-type": "text/html; charset=utf-8" }
-        });
-      });
-    }
-  };
-}
-var MIME_TYPES = {
-  ".html": "text/html; charset=utf-8",
-  ".js": "application/javascript; charset=utf-8",
-  ".mjs": "application/javascript; charset=utf-8",
-  ".css": "text/css; charset=utf-8",
-  ".json": "application/json; charset=utf-8",
-  ".svg": "image/svg+xml",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".ico": "image/x-icon",
-  ".woff": "font/woff",
-  ".woff2": "font/woff2",
-  ".ttf": "font/ttf",
-  ".map": "application/json"
-};
-function mimeType(filePath) {
-  const ext = path7.extname(filePath).toLowerCase();
-  return MIME_TYPES[ext] || "application/octet-stream";
-}
-
-// src/commands/serve.ts
-var getAvailablePort = async (startPort) => {
-  const isPortAvailable = (port2) => {
-    return new Promise((resolve) => {
-      const server = net.createServer();
-      server.once("error", (err) => {
-        resolve(false);
-      });
-      server.once("listening", () => {
-        server.close(() => resolve(true));
-      });
-      server.listen(port2);
-    });
-  };
-  let port = startPort;
-  while (!await isPortAvailable(port)) {
-    port++;
-    if (port > startPort + 100) {
-      throw new Error(`Could not find an available port starting from ${startPort}`);
-    }
-  }
-  return port;
-};
-var serveCommand = new Command9("serve").description("Start ObjectStack server with plugins from configuration").argument("[config]", "Configuration file path", "objectstack.config.ts").option("-p, --port <port>", "Server port", "3000").option("--dev", "Run in development mode (load devPlugins)").option("--ui", "Enable Studio UI at /_studio/ (default: true in dev mode)").option("--no-server", "Skip starting HTTP server plugin").action(async (configPath, options) => {
-  let port = parseInt(options.port);
-  try {
-    const availablePort = await getAvailablePort(port);
-    if (availablePort !== port) {
-      port = availablePort;
-    }
-  } catch (e) {
-  }
-  const isDev = options.dev || process.env.NODE_ENV === "development";
-  const absolutePath = path8.resolve(process.cwd(), configPath);
-  const relativeConfig = path8.relative(process.cwd(), absolutePath);
-  if (!fs8.existsSync(absolutePath)) {
-    printError(`Configuration file not found: ${absolutePath}`);
-    console.log(chalk9.dim("  Hint: Run `objectstack init` to create a new project"));
-    process.exit(1);
-  }
-  console.log("");
-  console.log(chalk9.dim(`  Loading ${relativeConfig}...`));
-  const loadedPlugins = [];
-  const shortPluginName = (raw) => {
-    if (raw.includes("objectql")) return "ObjectQL";
-    if (raw.includes("driver") && raw.includes("memory")) return "MemoryDriver";
-    if (raw.startsWith("plugin.app.")) return raw.replace("plugin.app.", "").split(".").pop() || raw;
-    if (raw.includes("hono")) return "HonoServer";
-    return raw;
-  };
-  const trackPlugin = (name) => {
-    loadedPlugins.push(shortPluginName(name));
-  };
-  const originalConsoleLog = console.log;
-  const originalConsoleDebug = console.debug;
-  const origStdoutWrite = process.stdout.write.bind(process.stdout);
-  let bootQuiet = false;
-  const restoreOutput = () => {
-    bootQuiet = false;
-    process.stdout.write = origStdoutWrite;
-    console.log = originalConsoleLog;
-    console.debug = originalConsoleDebug;
-  };
-  const portShifted = parseInt(options.port) !== port;
-  try {
-    bootQuiet = true;
-    process.stdout.write = (chunk, ...rest) => {
-      if (bootQuiet) return true;
-      return origStdoutWrite(chunk, ...rest);
-    };
-    console.log = (...args) => {
-      if (!bootQuiet) originalConsoleLog(...args);
-    };
-    console.debug = (...args) => {
-      if (!bootQuiet) originalConsoleDebug(...args);
-    };
-    const { mod } = await bundleRequire({
-      filepath: absolutePath
-    });
-    const config = mod.default || mod;
-    if (!config) {
-      throw new Error(`No default export found in ${configPath}`);
-    }
-    const { Runtime } = await import("@objectstack/runtime");
-    const loggerConfig = { level: "silent" };
-    const runtime = new Runtime({
-      kernel: {
-        logger: loggerConfig
-      }
-    });
-    const kernel = runtime.getKernel();
-    let plugins = config.plugins || [];
-    if (options.dev && config.devPlugins) {
-      plugins = [...plugins, ...config.devPlugins];
-    }
-    const hasObjectQL = plugins.some((p) => p.name?.includes("objectql") || p.constructor?.name?.includes("ObjectQL"));
-    if (config.objects && !hasObjectQL) {
-      try {
-        const { ObjectQLPlugin } = await import("@objectstack/objectql");
-        await kernel.use(new ObjectQLPlugin());
-        trackPlugin("ObjectQL");
-      } catch (e) {
-      }
-    }
-    const hasDriver = plugins.some((p) => p.name?.includes("driver") || p.constructor?.name?.includes("Driver"));
-    if (isDev && !hasDriver && config.objects) {
-      try {
-        const { DriverPlugin } = await import("@objectstack/runtime");
-        const { InMemoryDriver } = await import("@objectstack/driver-memory");
-        await kernel.use(new DriverPlugin(new InMemoryDriver()));
-        trackPlugin("MemoryDriver");
-      } catch (e) {
-      }
-    }
-    if (config.objects || config.manifest || config.apps) {
-      try {
-        const { AppPlugin } = await import("@objectstack/runtime");
-        await kernel.use(new AppPlugin(config));
-        trackPlugin("App");
-      } catch (e) {
-      }
-    }
-    if (plugins.length > 0) {
-      for (const plugin of plugins) {
-        try {
-          let pluginToLoad = plugin;
-          if (typeof plugin === "string") {
-            try {
-              const imported = await import(plugin);
-              pluginToLoad = imported.default || imported;
-            } catch (importError) {
-              throw new Error(`Failed to import plugin '${plugin}': ${importError.message}`);
-            }
-          }
-          if (pluginToLoad && typeof pluginToLoad === "object" && !pluginToLoad.init) {
-            try {
-              const { AppPlugin } = await import("@objectstack/runtime");
-              pluginToLoad = new AppPlugin(pluginToLoad);
-            } catch (e) {
-            }
-          }
-          await kernel.use(pluginToLoad);
-          const pluginName = plugin.name || plugin.constructor?.name || "unnamed";
-          trackPlugin(pluginName);
-        } catch (e) {
-          console.error(chalk9.red(`  \u2717 Failed to load plugin: ${e.message}`));
-        }
-      }
-    }
-    if (options.server !== false) {
-      try {
-        const { HonoServerPlugin } = await import("@objectstack/plugin-hono-server");
-        const serverPlugin = new HonoServerPlugin({ port });
-        await kernel.use(serverPlugin);
-        trackPlugin("HonoServer");
-      } catch (e) {
-        console.warn(chalk9.yellow(`  \u26A0 HTTP server plugin not available: ${e.message}`));
-      }
-      try {
-        const { createRestApiPlugin } = await import("@objectstack/rest");
-        await kernel.use(createRestApiPlugin());
-        trackPlugin("RestAPI");
-      } catch (e) {
-      }
-      try {
-        const { createDispatcherPlugin } = await import("@objectstack/runtime");
-        await kernel.use(createDispatcherPlugin());
-        trackPlugin("Dispatcher");
-      } catch (e) {
-      }
-    }
-    const enableUI = options.ui ?? isDev;
-    if (enableUI) {
-      const studioPath = resolveStudioPath();
-      if (!studioPath) {
-        console.warn(chalk9.yellow(`  \u26A0 @objectstack/studio not found \u2014 skipping UI`));
-      } else if (hasStudioDist(studioPath)) {
-        const distPath = path8.join(studioPath, "dist");
-        await kernel.use(createStudioStaticPlugin(distPath, { isDev }));
-        trackPlugin("StudioUI");
-      } else {
-        console.warn(chalk9.yellow(`  \u26A0 Studio dist not found \u2014 run "pnpm --filter @objectstack/studio build" first`));
-      }
-    }
-    await runtime.start();
-    await new Promise((r) => setTimeout(r, 100));
-    restoreOutput();
-    printServerReady({
-      port,
-      configFile: relativeConfig,
-      isDev,
-      pluginCount: loadedPlugins.length,
-      pluginNames: loadedPlugins,
-      uiEnabled: enableUI,
-      studioPath: STUDIO_PATH
-    });
-    process.on("SIGINT", async () => {
-      console.warn(chalk9.yellow(`
-
-\u23F9  Stopping server...`));
-      await runtime.getKernel().shutdown();
-      console.log(chalk9.green(`\u2705 Server stopped`));
-      process.exit(0);
-    });
-  } catch (error) {
-    restoreOutput();
-    console.log("");
-    printError(error.message || String(error));
-    if (process.env.DEBUG) console.error(chalk9.dim(error.stack));
-    process.exit(1);
-  }
-});
-
-// src/commands/test.ts
-import { Command as Command10 } from "commander";
-import chalk10 from "chalk";
-import path9 from "path";
-import fs9 from "fs";
-import { QA as CoreQA } from "@objectstack/core";
-function resolveGlob(pattern) {
-  if (!pattern.includes("*")) {
-    return fs9.existsSync(pattern) ? [pattern] : [];
-  }
-  const parts = pattern.split(path9.sep.replace("\\", "/"));
-  const segments = pattern.includes("/") ? pattern.split("/") : parts;
-  let baseDir = ".";
-  let globStart = 0;
-  for (let i = 0; i < segments.length; i++) {
-    if (segments[i].includes("*")) {
-      globStart = i;
-      break;
-    }
-    baseDir = i === 0 ? segments[i] : path9.join(baseDir, segments[i]);
-  }
-  if (!fs9.existsSync(baseDir)) return [];
-  const globPortion = segments.slice(globStart).join("/");
-  const regexStr = globPortion.replace(/\./g, "\\.").replace(/\*\*\//g, "(.+/)?").replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*");
-  const regex = new RegExp(`^${regexStr}$`);
-  const entries = fs9.readdirSync(baseDir, { recursive: true, encoding: "utf-8" });
-  return entries.filter((entry) => regex.test(entry.replace(/\\/g, "/"))).map((entry) => path9.join(baseDir, entry)).filter((fullPath) => fs9.statSync(fullPath).isFile());
-}
-var testCommand = new Command10("test").description("Run Quality Protocol test scenarios against a running server").argument("[files]", 'Glob pattern for test files (e.g. "qa/*.test.json")', "qa/*.test.json").option("--url <url>", "Target base URL", "http://localhost:3000").option("--token <token>", "Authentication token").action(async (filesPattern, options) => {
-  console.log(chalk10.bold(`
-\u{1F9EA} ObjectStack Quality Protocol Runner`));
-  console.log(chalk10.dim(`-------------------------------------`));
-  console.log(`Target: ${chalk10.blue(options.url)}`);
-  const adapter = new CoreQA.HttpTestAdapter(options.url, options.token);
-  const runner = new CoreQA.TestRunner(adapter);
-  const testFiles = resolveGlob(filesPattern);
-  if (testFiles.length === 0) {
-    console.warn(chalk10.yellow(`No test files found matching: ${filesPattern}`));
-    return;
-  }
-  console.log(`Found ${testFiles.length} test suites.`);
-  let totalPassed = 0;
-  let totalFailed = 0;
-  for (const file of testFiles) {
-    console.log(`
-\u{1F4C4} Running suite: ${chalk10.bold(path9.basename(file))}`);
-    try {
-      const content = fs9.readFileSync(file, "utf-8");
-      const suite = JSON.parse(content);
-      const results = await runner.runSuite(suite);
-      for (const result of results) {
-        const icon = result.passed ? "\u2705" : "\u274C";
-        console.log(`  ${icon} Scenario: ${result.scenarioId} (${result.duration}ms)`);
-        if (!result.passed) {
-          console.error(chalk10.red(`     Error: ${result.error}`));
-          result.steps.forEach((step) => {
-            if (!step.passed) {
-              console.error(chalk10.red(`     Step Failed: ${step.stepName}`));
-              if (step.output) console.error(`     Output:`, step.output);
-              if (step.error) console.error(`     Error:`, step.error);
-            }
-          });
-          totalFailed++;
-        } else {
-          totalPassed++;
-        }
-      }
-    } catch (e) {
-      console.error(chalk10.red(`Failed to load or run suite ${file}: ${e}`));
-      totalFailed++;
-    }
-  }
-  console.log(chalk10.dim(`
--------------------------------------`));
-  if (totalFailed > 0) {
-    console.log(chalk10.red(`FAILED: ${totalFailed} scenarios failed. ${totalPassed} passed.`));
-    process.exit(1);
-  } else {
-    console.log(chalk10.green(`SUCCESS: All ${totalPassed} scenarios passed.`));
-    process.exit(0);
-  }
-});
-
-// src/commands/doctor.ts
-import { Command as Command11 } from "commander";
-import chalk11 from "chalk";
-import { execSync as execSync2 } from "child_process";
-import fs10 from "fs";
-import path10 from "path";
-function detectCircularDependencies(objects) {
-  const issues = [];
-  const graph = /* @__PURE__ */ new Map();
-  for (const obj of objects) {
-    const deps = [];
-    if (obj.fields && typeof obj.fields === "object") {
-      for (const field of Object.values(obj.fields)) {
-        if (field?.type === "lookup" && field?.reference) {
-          deps.push(field.reference);
-        }
-      }
-    }
-    graph.set(obj.name, deps);
-  }
-  const visited = /* @__PURE__ */ new Set();
-  const stack = /* @__PURE__ */ new Set();
-  function dfs(node, path11) {
-    if (stack.has(node)) {
-      const cycleStart = path11.indexOf(node);
-      const cycle = path11.slice(cycleStart).concat(node);
-      issues.push(`Circular dependency: ${cycle.join(" \u2192 ")}`);
-      return true;
-    }
-    if (visited.has(node)) return false;
-    visited.add(node);
-    stack.add(node);
-    for (const dep of graph.get(node) || []) {
-      if (graph.has(dep)) {
-        dfs(dep, [...path11, node]);
-      }
-    }
-    stack.delete(node);
-    return false;
-  }
-  for (const name of graph.keys()) {
-    if (!visited.has(name)) {
-      dfs(name, []);
-    }
-  }
-  return issues;
-}
-function findOrphanViews(config) {
-  const objectNames = /* @__PURE__ */ new Set();
-  if (Array.isArray(config.objects)) {
-    for (const obj of config.objects) {
-      if (obj.name) objectNames.add(obj.name);
-    }
-  }
-  const orphans = [];
-  if (Array.isArray(config.views)) {
-    for (const view of config.views) {
-      if (view.object && !objectNames.has(view.object)) {
-        orphans.push(`View "${view.name || "?"}" references non-existent object "${view.object}"`);
-      }
-    }
-  }
-  return orphans;
-}
-function findUnusedObjects(config) {
-  const objectNames = /* @__PURE__ */ new Set();
-  if (Array.isArray(config.objects)) {
-    for (const obj of config.objects) {
-      if (obj.name) objectNames.add(obj.name);
-    }
-  }
-  const referencedObjects = /* @__PURE__ */ new Set();
-  if (Array.isArray(config.views)) {
-    for (const view of config.views) {
-      if (view.object) referencedObjects.add(view.object);
-    }
-  }
-  if (Array.isArray(config.flows)) {
-    for (const flow of config.flows) {
-      if (flow.trigger?.object) referencedObjects.add(flow.trigger.object);
-      if (flow.object) referencedObjects.add(flow.object);
-    }
-  }
-  if (Array.isArray(config.apps)) {
-    for (const app of config.apps) {
-      if (Array.isArray(app.navigation)) {
-        for (const nav of app.navigation) {
-          if (nav.object) referencedObjects.add(nav.object);
-        }
-      }
-    }
-  }
-  if (Array.isArray(config.agents)) {
-    for (const agent of config.agents) {
-      if (Array.isArray(agent.objects)) {
-        for (const o of agent.objects) referencedObjects.add(o);
-      }
-    }
-  }
-  if (Array.isArray(config.objects)) {
-    for (const obj of config.objects) {
-      if (obj.fields && typeof obj.fields === "object") {
-        for (const field of Object.values(obj.fields)) {
-          if (field?.type === "lookup" && field?.reference) {
-            referencedObjects.add(field.reference);
-          }
-        }
-      }
-    }
-  }
-  const unused = [];
-  for (const name of objectNames) {
-    if (!referencedObjects.has(name)) {
-      unused.push(`Object "${name}" is defined but not referenced by any view, flow, app, or agent`);
-    }
-  }
-  return unused;
-}
-function walkDir(dir, ext) {
-  const results = [];
-  if (!fs10.existsSync(dir)) return results;
-  const entries = fs10.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    if (entry.name === "node_modules") continue;
-    const fullPath = path10.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      results.push(...walkDir(fullPath, ext));
-    } else if (entry.name.endsWith(ext)) {
-      results.push(fullPath);
-    }
-  }
-  return results;
-}
-function findMissingTests(cwd) {
-  const specSrcDir = path10.join(cwd, "packages/spec/src");
-  if (!fs10.existsSync(specSrcDir)) return [];
-  const missing = [];
-  const zodFiles = walkDir(specSrcDir, ".zod.ts");
-  for (const zodFile of zodFiles) {
-    const testFile = zodFile.replace(".zod.ts", ".test.ts");
-    if (!fs10.existsSync(testFile)) {
-      const relZod = path10.relative(specSrcDir, zodFile);
-      const relTest = path10.relative(specSrcDir, testFile);
-      missing.push(`Missing test: ${relTest} (for ${relZod})`);
-    }
-  }
-  return missing;
-}
-function findDeprecatedUsages(cwd) {
-  const specSrcDir = path10.join(cwd, "packages/spec/src");
-  if (!fs10.existsSync(specSrcDir)) return [];
-  const deprecated = [];
-  const tsFiles = walkDir(specSrcDir, ".ts").filter((f) => !f.endsWith(".test.ts"));
-  for (const tsFile of tsFiles) {
-    try {
-      const content = fs10.readFileSync(tsFile, "utf-8");
-      const lines = content.split("\n");
-      const relPath = path10.relative(specSrcDir, tsFile);
-      for (let i = 0; i < lines.length; i++) {
-        if (lines[i].includes("@deprecated")) {
-          deprecated.push(`${relPath}:${i + 1} \u2014 @deprecated tag found`);
-        }
-      }
-    } catch {
-    }
-  }
-  return deprecated;
-}
-var DEPRECATED_PATTERNS = [
-  {
-    pattern: /\bEnhancedObjectKernel\b/,
-    description: "EnhancedObjectKernel is deprecated in v3",
-    replacement: "Use ObjectKernel instead"
-  },
-  {
-    pattern: /\bmax_length\b/,
-    description: "snake_case config key: max_length",
-    replacement: "Use maxLength (camelCase)"
-  },
-  {
-    pattern: /\bdefault_value\b/,
-    description: "snake_case config key: default_value",
-    replacement: "Use defaultValue (camelCase)"
-  },
-  {
-    pattern: /\bmin_length\b/,
-    description: "snake_case config key: min_length",
-    replacement: "Use minLength (camelCase)"
-  },
-  {
-    pattern: /\breference_filters\b/,
-    description: "snake_case config key: reference_filters",
-    replacement: "Use referenceFilters (camelCase)"
-  },
-  {
-    pattern: /\bunique_name\b/,
-    description: "snake_case config key: unique_name",
-    replacement: "Use uniqueName (camelCase)"
-  },
-  {
-    pattern: /from\s+['"]@objectstack\/core\/enhanced['"]/,
-    description: "Import from deprecated @objectstack/core/enhanced path",
-    replacement: "Use import from '@objectstack/core'"
-  },
-  {
-    pattern: /from\s+['"]@objectstack\/spec\/dist\/[^'"]+['"]/,
-    description: "Import from deprecated @objectstack/spec/dist/ deep path",
-    replacement: "Use import from '@objectstack/spec'"
-  }
-];
-function scanDeprecatedPatterns(dir) {
-  const results = [];
-  if (!fs10.existsSync(dir)) return results;
-  const tsFiles = walkDir(dir, ".ts").filter((f) => !f.endsWith(".test.ts"));
-  for (const tsFile of tsFiles) {
-    try {
-      const content = fs10.readFileSync(tsFile, "utf-8");
-      const lines = content.split("\n");
-      const relPath = path10.relative(process.cwd(), tsFile);
-      for (let i = 0; i < lines.length; i++) {
-        for (const dp of DEPRECATED_PATTERNS) {
-          if (dp.pattern.test(lines[i])) {
-            results.push({
-              file: relPath,
-              line: i + 1,
-              description: dp.description,
-              replacement: dp.replacement
-            });
-          }
-        }
-      }
-    } catch {
-    }
-  }
-  return results;
-}
-var doctorCommand = new Command11("doctor").description("Check development environment and configuration health").option("-v, --verbose", "Show detailed information").option("--scan-deprecations", "Scan for deprecated ObjectStack patterns").action(async (options) => {
-  printHeader("Environment Health Check");
-  const results = [];
-  try {
-    const nodeVersion = process.version;
-    const majorVersion = parseInt(nodeVersion.slice(1).split(".")[0]);
-    if (majorVersion >= 18) {
-      results.push({
-        name: "Node.js",
-        status: "ok",
-        message: `Version ${nodeVersion}`
-      });
-    } else {
-      results.push({
-        name: "Node.js",
-        status: "error",
-        message: `Version ${nodeVersion} (requires >= 18.0.0)`,
-        fix: "Upgrade Node.js: https://nodejs.org"
-      });
-    }
-  } catch (error) {
-    results.push({
-      name: "Node.js",
-      status: "error",
-      message: "Not found",
-      fix: "Install Node.js: https://nodejs.org"
-    });
-  }
-  try {
-    const pnpmVersion = execSync2("pnpm -v", { encoding: "utf-8" }).trim();
-    results.push({
-      name: "pnpm",
-      status: "ok",
-      message: `Version ${pnpmVersion}`
-    });
-  } catch (error) {
-    results.push({
-      name: "pnpm",
-      status: "error",
-      message: "Not found",
-      fix: "Install pnpm: npm install -g pnpm@10.28.1"
-    });
-  }
-  try {
-    const tscVersion = execSync2("tsc -v", { encoding: "utf-8" }).trim();
-    results.push({
-      name: "TypeScript",
-      status: "ok",
-      message: tscVersion
-    });
-  } catch (error) {
-    results.push({
-      name: "TypeScript",
-      status: "warning",
-      message: "Not found in PATH",
-      fix: "Installed locally via pnpm"
-    });
-  }
-  const cwd = process.cwd();
-  const nodeModulesPath = path10.join(cwd, "node_modules");
-  if (fs10.existsSync(nodeModulesPath)) {
-    results.push({
-      name: "Dependencies",
-      status: "ok",
-      message: "Installed"
-    });
-  } else {
-    results.push({
-      name: "Dependencies",
-      status: "error",
-      message: "Not installed",
-      fix: "Run: pnpm install"
-    });
-  }
-  const specDistPath = path10.join(cwd, "packages/spec/dist");
-  if (fs10.existsSync(specDistPath)) {
-    results.push({
-      name: "@objectstack/spec",
-      status: "ok",
-      message: "Built"
-    });
-  } else {
-    results.push({
-      name: "@objectstack/spec",
-      status: "warning",
-      message: "Not built",
-      fix: "Run: pnpm --filter @objectstack/spec build"
-    });
-  }
-  try {
-    const gitVersion = execSync2("git --version", { encoding: "utf-8" }).trim();
-    results.push({
-      name: "Git",
-      status: "ok",
-      message: gitVersion
-    });
-  } catch (error) {
-    results.push({
-      name: "Git",
-      status: "warning",
-      message: "Not found",
-      fix: "Install Git for version control"
-    });
-  }
-  let hasErrors = false;
-  let hasWarnings = false;
-  console.log("");
-  results.forEach((result) => {
-    const padded = result.name.padEnd(20);
-    if (result.status === "ok") {
-      printSuccess(`${padded} ${result.message}`);
-    } else if (result.status === "warning") {
-      printWarning(`${padded} ${result.message}`);
-    } else {
-      printError(`${padded} ${result.message}`);
-    }
-    if (result.fix && (options.verbose || result.status === "error")) {
-      console.log(chalk11.dim(`      \u2192 ${result.fix}`));
-    }
-    if (result.status === "error") hasErrors = true;
-    if (result.status === "warning") hasWarnings = true;
-  });
-  printStep("Checking for missing test files...");
-  const missingTests = findMissingTests(cwd);
-  if (missingTests.length > 0) {
-    hasWarnings = true;
-    for (const msg of missingTests) {
-      printWarning(msg);
-    }
-  } else {
-    printSuccess("Test coverage         All *.zod.ts files have matching tests");
-  }
-  printStep("Scanning for @deprecated usage...");
-  const deprecatedUsages = findDeprecatedUsages(cwd);
-  if (deprecatedUsages.length > 0) {
-    hasWarnings = true;
-    for (const msg of deprecatedUsages) {
-      printWarning(`Deprecated: ${msg}`);
-    }
-  } else {
-    printSuccess("Deprecations          No @deprecated tags found");
-  }
-  if (configExists()) {
-    printStep("Loading configuration for analysis...");
-    try {
-      const { config } = await loadConfig();
-      if (Array.isArray(config.objects) && config.objects.length > 0) {
-        printStep("Checking for circular dependencies...");
-        const cycles = detectCircularDependencies(config.objects);
-        if (cycles.length > 0) {
-          hasWarnings = true;
-          for (const msg of cycles) {
-            printWarning(msg);
-          }
-        } else {
-          printSuccess("Dependencies          No circular references detected");
-        }
-        printStep("Checking for unused objects...");
-        const unused = findUnusedObjects(config);
-        if (unused.length > 0) {
-          hasWarnings = true;
-          for (const msg of unused) {
-            printWarning(msg);
-          }
-        } else {
-          printSuccess("Object usage          All objects are referenced");
-        }
-      }
-      if (Array.isArray(config.views) && config.views.length > 0) {
-        printStep("Checking for orphan views...");
-        const orphans = findOrphanViews(config);
-        if (orphans.length > 0) {
-          hasWarnings = true;
-          for (const msg of orphans) {
-            printWarning(msg);
-          }
-        } else {
-          printSuccess("View integrity        All views reference valid objects");
-        }
-      }
-    } catch {
-      printWarning("Could not load config for analysis (config checks skipped)");
-      hasWarnings = true;
-    }
-  }
-  if (options.scanDeprecations) {
-    printStep("Scanning for deprecated ObjectStack patterns...");
-    const scanDir = path10.join(cwd, "src");
-    const deprecations = scanDeprecatedPatterns(scanDir);
-    if (deprecations.length > 0) {
-      hasWarnings = true;
-      for (const dep of deprecations) {
-        printWarning(`${dep.file}:${dep.line} \u2014 ${dep.description}`);
-        if (options.verbose) {
-          console.log(chalk11.dim(`      \u2192 ${dep.replacement}`));
-        }
-      }
-      console.log("");
-      printInfo(`Found ${deprecations.length} deprecated pattern(s). Run \`objectstack codemod v2-to-v3\` to auto-fix.`);
-    } else {
-      printSuccess("Deprecation scan      No deprecated patterns found");
-    }
-  }
-  console.log("");
-  if (hasErrors) {
-    console.log(chalk11.red("\u274C Some critical issues found. Please fix them before continuing."));
-    results.filter((r) => r.status === "error" && r.fix).forEach((r) => console.log(chalk11.dim(`   ${r.fix}`)));
-    process.exit(1);
-  } else if (hasWarnings) {
-    console.log(chalk11.yellow("\u26A0\uFE0F  Environment is functional but has some warnings."));
-    console.log(chalk11.dim("   Run with --verbose to see fix suggestions."));
-  } else {
-    console.log(chalk11.green("\u2705 Environment is healthy and ready for development!"));
-  }
-  console.log("");
-});
-
-// src/utils/plugin-commands.ts
-import chalk12 from "chalk";
-async function loadPluginCommands(program) {
-  let config;
-  try {
-    const loaded = await loadConfig();
-    config = loaded.config;
-  } catch {
-    return;
-  }
-  const plugins = [
-    ...config.plugins || [],
-    ...config.devPlugins || []
-  ];
-  const contributions = [];
-  for (const plugin of plugins) {
-    if (!plugin || typeof plugin !== "object") continue;
-    const p = plugin;
-    const manifest = p.manifest;
-    const contributes = manifest?.contributes ?? p.contributes;
-    if (!contributes) continue;
-    const commands = contributes.commands;
-    if (!Array.isArray(commands)) continue;
-    const pluginName = resolvePluginName2(p);
-    for (const cmd of commands) {
-      if (!cmd || typeof cmd.name !== "string") continue;
-      contributions.push({
-        name: cmd.name,
-        description: typeof cmd.description === "string" ? cmd.description : void 0,
-        module: typeof cmd.module === "string" ? cmd.module : void 0,
-        pluginName
-      });
-    }
-  }
-  if (contributions.length === 0) return;
-  for (const contribution of contributions) {
-    try {
-      const commands = await importPluginCommands(contribution);
-      for (const cmd of commands) {
-        program.addCommand(cmd);
-      }
-    } catch (error) {
-      if (process.env.DEBUG) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(
-          chalk12.yellow(`  \u26A0 Failed to load CLI command '${contribution.name}' from plugin '${contribution.pluginName}': ${message}`)
-        );
-      }
-    }
-  }
-}
-async function importPluginCommands(contribution) {
-  const moduleId = contribution.module ? `${contribution.pluginName}/${contribution.module.replace(/^\.\//, "")}` : contribution.pluginName;
-  const mod = await import(moduleId);
-  if (Array.isArray(mod.commands)) {
-    return mod.commands.filter(isCommandInstance);
-  }
-  const defaultExport = mod.default;
-  if (defaultExport) {
-    if (Array.isArray(defaultExport)) {
-      return defaultExport.filter(isCommandInstance);
-    }
-    if (isCommandInstance(defaultExport)) {
-      return [defaultExport];
-    }
-  }
-  const commands = [];
-  for (const key of Object.keys(mod)) {
-    if (isCommandInstance(mod[key])) {
-      commands.push(mod[key]);
-    }
-  }
-  return commands;
-}
-function isCommandInstance(value) {
-  if (value === null || typeof value !== "object") return false;
-  const obj = value;
-  return typeof obj.name === "function" && typeof obj.description === "function" && typeof obj.action === "function" && typeof obj.parse === "function";
-}
-function resolvePluginName2(plugin) {
-  if (typeof plugin.name === "string") return plugin.name;
-  const manifest = plugin.manifest;
-  if (manifest && typeof manifest.name === "string") return manifest.name;
-  if (plugin.constructor && plugin.constructor.name !== "Object") return plugin.constructor.name;
-  return "unknown";
-}
-export {
-  compileCommand,
-  createCommand,
-  devCommand,
-  doctorCommand,
-  generateCommand,
-  infoCommand,
-  initCommand,
-  loadPluginCommands,
-  pluginCommand,
-  serveCommand,
-  templates,
-  testCommand,
-  validateCommand
-};
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+// ─── oclif Command Classes ──────────────────────────────────────────
+// Each command is auto-discovered by oclif from `src/commands/`.
+// These re-exports provide programmatic access for testing and integration.
+export { default as CompileCommand } from './commands/compile.js';
+export { default as ValidateCommand } from './commands/validate.js';
+export { default as InfoCommand } from './commands/info.js';
+export { default as InitCommand } from './commands/init.js';
+export { default as GenerateCommand } from './commands/generate.js';
+export { default as CreateCommand } from './commands/create.js';
+export { default as DevCommand } from './commands/dev.js';
+export { default as ServeCommand } from './commands/serve.js';
+export { default as TestCommand } from './commands/test.js';
+export { default as DoctorCommand } from './commands/doctor.js';
+// ─── Plugin topic subcommands ───────────────────────────────────────
+export { default as PluginListCommand } from './commands/plugin/list.js';
+export { default as PluginInfoCommand } from './commands/plugin/info.js';
+export { default as PluginAddCommand } from './commands/plugin/add.js';
+export { default as PluginRemoveCommand } from './commands/plugin/remove.js';
+//# sourceMappingURL=index.js.map