@objectstack/cli 3.0.0 → 3.0.2

package/dist/index.js

@@ -1,5 +1,6 @@
 import {
   collectMetadataStats,
+  configExists,
   createTimer,
   formatZodErrors,
   loadConfig,
@@ -898,11 +899,383 @@ var generateTypesCommand = new Command5("types").description("Generate TypeScrip
     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).action(async (type, name, options) => {
+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)) {
@@ -1876,7 +2249,237 @@ import chalk11 from "chalk";
 import { execSync as execSync2 } from "child_process";
 import fs10 from "fs";
 import path10 from "path";
-var doctorCommand = new Command11("doctor").description("Check development environment health").option("-v, --verbose", "Show detailed information").action(async (options) => {
+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 {
@@ -1998,6 +2601,87 @@ var doctorCommand = new Command11("doctor").description("Check development envir
     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."));