@warlock.js/core 5.30.0 → 5.32.0

package/esm/dev-server/dependency-graph.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-graph.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dependency-graph.ts"],"sourcesContent":["import type { FileManager } from \"./file-manager\";\n\n/**\n * Dependency Graph\n * Tracks bidirectional relationships between files:\n * - dependencies: files that this file imports\n * - dependents: files that import this file\n *\n * Each forward edge also carries an `isTypeOnly` flag so cycle detection\n * can distinguish runtime cycles from ones formed purely by `import type`\n * edges — the latter are erased by TypeScript and have no runtime effect.\n */\nexport class DependencyGraph {\n  /**\n   * Map of file -> files it depends on (imports).\n   * Key: relative file path.\n   * Value: relative dependency path → `{ isTypeOnly }` for that edge.\n   */\n  private dependencies = new Map<string, Map<string, { isTypeOnly: boolean }>>();\n\n  /**\n   * Map of file -> files that depend on it (importers)\n   * Key: relative file path\n   * Value: Set of relative file paths that import this file\n   */\n  private dependents = new Map<string, Set<string>>();\n\n  /**\n   * Reference to the files map for accessing FileManager instances\n   * Used to read per-file typeOnlyDependencies during graph build.\n   */\n  private files: Map<string, FileManager> | null = null;\n\n  /**\n   * Build dependency graph from FileManager map\n   */\n  public build(files: Map<string, FileManager>) {\n    this.files = files;\n\n    this.dependencies.clear();\n    this.dependents.clear();\n\n    for (const [relativePath, fileManager] of files) {\n      if (!this.dependencies.has(relativePath)) {\n        this.dependencies.set(relativePath, new Map());\n      }\n\n      if (!this.dependents.has(relativePath)) {\n        this.dependents.set(relativePath, new Set());\n      }\n\n      for (const dependency of fileManager.dependencies) {\n        const isTypeOnly = fileManager.typeOnlyDependencies.has(dependency);\n\n        this.addDependency(relativePath, dependency, isTypeOnly);\n      }\n    }\n\n    const cycles = this.detectCircularDependencies();\n\n    if (cycles.length > 0) {\n      this.displayCircularDependencyWarnings(cycles);\n    }\n  }\n\n  /**\n   * Add a dependency relationship.\n   * If the edge already exists, the type-only flag is ANDed: any runtime\n   * statement between the two files makes the edge runtime permanently.\n   *\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   * @param isTypeOnly Whether every reference from `file` to `dependency` is type-only\n   */\n  public addDependency(file: string, dependency: string, isTypeOnly: boolean = false) {\n    if (!this.dependencies.has(file)) {\n      this.dependencies.set(file, new Map());\n    }\n\n    if (!this.dependents.has(dependency)) {\n      this.dependents.set(dependency, new Set());\n    }\n\n    const edges = this.dependencies.get(file)!;\n    const existing = edges.get(dependency);\n\n    if (existing) {\n      existing.isTypeOnly = existing.isTypeOnly && isTypeOnly;\n    } else {\n      edges.set(dependency, { isTypeOnly });\n    }\n\n    this.dependents.get(dependency)!.add(file);\n  }\n\n  /**\n   * Remove a dependency relationship\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   */\n  public removeDependency(file: string, dependency: string) {\n    this.dependencies.get(file)?.delete(dependency);\n    this.dependents.get(dependency)?.delete(file);\n  }\n\n  /**\n   * Remove all relationships for a file\n   * @param file The file to remove\n   */\n  public removeFile(file: string) {\n    const deps = this.dependencies.get(file);\n\n    if (deps) {\n      for (const dependency of deps.keys()) {\n        this.dependents.get(dependency)?.delete(file);\n      }\n    }\n\n    const dependents = this.dependents.get(file);\n\n    if (dependents) {\n      for (const dependent of dependents) {\n        this.dependencies.get(dependent)?.delete(file);\n      }\n    }\n\n    this.dependencies.delete(file);\n    this.dependents.delete(file);\n  }\n\n  /**\n   * Update dependencies for a file.\n   *\n   * Accepts the updated `Set<string>` of dependency paths; when the caller\n   * has per-edge type-only info, pass `typeOnlyDependencies` so the new\n   * edges get the correct flag. Missing flag defaults to runtime.\n   *\n   * @param file The file to update\n   * @param newDependencies New set of dependency paths\n   * @param typeOnlyDependencies Subset of `newDependencies` whose edges are type-only\n   */\n  public updateFile(\n    file: string,\n    newDependencies: Set<string>,\n    typeOnlyDependencies: Set<string> = new Set(),\n  ) {\n    const oldEdges = this.dependencies.get(file) ?? new Map<string, { isTypeOnly: boolean }>();\n\n    for (const oldDep of oldEdges.keys()) {\n      if (!newDependencies.has(oldDep)) {\n        this.removeDependency(file, oldDep);\n      }\n    }\n\n    for (const newDep of newDependencies) {\n      const isTypeOnly = typeOnlyDependencies.has(newDep);\n      const existing = oldEdges.get(newDep);\n\n      if (!existing) {\n        this.addDependency(file, newDep, isTypeOnly);\n\n        continue;\n      }\n\n      if (existing.isTypeOnly !== isTypeOnly) {\n        existing.isTypeOnly = isTypeOnly;\n      }\n    }\n  }\n\n  /**\n   * Get files that this file depends on (imports)\n   * @param file The file to check\n   * @returns Set of files this file imports\n   */\n  public getDependencies(file: string): Set<string> {\n    const edges = this.dependencies.get(file);\n\n    if (!edges) {\n      return new Set();\n    }\n\n    return new Set(edges.keys());\n  }\n\n  /**\n   * Check whether the edge `file → dependency` is type-only.\n   * Returns false if the edge does not exist.\n   */\n  public isEdgeTypeOnly(file: string, dependency: string): boolean {\n    return this.dependencies.get(file)?.get(dependency)?.isTypeOnly === true;\n  }\n\n  /**\n   * Get files that depend on this file (importers)\n   * @param file The file to check\n   * @returns Set of files that import this file\n   */\n  public getDependents(file: string): Set<string> {\n    return this.dependents.get(file) || new Set();\n  }\n\n  /**\n   * Get invalidation chain for a file\n   * Returns all files that need to be reloaded when this file changes\n   * Includes the file itself and all transitive dependents\n   * @param file The file that changed\n   * @returns Array of files to invalidate (in order)\n   */\n  public getInvalidationChain(file: string): string[] {\n    const chain: string[] = [file];\n    const visited = new Set([file]);\n\n    const traverse = (current: string) => {\n      const deps = this.getDependents(current);\n      for (const dep of deps) {\n        if (!visited.has(dep)) {\n          visited.add(dep);\n          chain.push(dep);\n          traverse(dep); // Recursive traversal\n        }\n      }\n    };\n\n    traverse(file);\n    return chain;\n  }\n\n  /**\n   * Detect circular dependencies in the dependency graph.\n   * Uses depth-first search to find cycles.\n   *\n   * Filtering rule (per-edge): a cycle is suppressed when **any** edge in\n   * the chain is type-only. TypeScript erases type-only imports entirely,\n   * so a single type-only edge breaks the cycle at runtime. Only warn when\n   * every edge is a runtime binding — that's the cycle that actually loops\n   * at load time.\n   *\n   * @returns Array of circular dependency chains (each chain is an array of file paths)\n   */\n  public detectCircularDependencies(): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const dfs = (file: string, path: string[]): void => {\n      visited.add(file);\n      recursionStack.add(file);\n      path.push(file);\n\n      const edges = this.dependencies.get(file);\n\n      if (edges) {\n        for (const dep of edges.keys()) {\n          if (!visited.has(dep)) {\n            dfs(dep, [...path]);\n          } else if (recursionStack.has(dep)) {\n            const cycleStart = path.indexOf(dep);\n            const cycle = [...path.slice(cycleStart), dep];\n\n            cycles.push(cycle);\n          }\n        }\n      }\n\n      recursionStack.delete(file);\n    };\n\n    for (const file of this.dependencies.keys()) {\n      if (!visited.has(file)) {\n        dfs(file, []);\n      }\n    }\n\n    return cycles.filter((cycle) => this.isRuntimeCycle(cycle));\n  }\n\n  /**\n   * True iff every edge in the cycle is a runtime binding. The cycle array\n   * ends with a duplicate of its start (`[A, B, C, A]`) so we walk the\n   * consecutive pairs once — any type-only edge means TS erases the loop\n   * and there is no runtime cycle to report.\n   */\n  private isRuntimeCycle(cycle: string[]): boolean {\n    for (let index = 0; index < cycle.length - 1; index++) {\n      const from = cycle[index];\n      const to = cycle[index + 1];\n\n      // `index < cycle.length - 1` bounds both reads. Skipping an unreadable\n      // edge rather than defaulting: this decides whether a cycle is\n      // TYPE-ONLY, and a `?? \"\"` would ask `isEdgeTypeOnly(\"\", \"\")`, whose\n      // answer is about a pair of edges that do not exist. A cycle wrongly\n      // classified as type-only is a real circular import reported as harmless.\n      if (from === undefined || to === undefined) continue;\n\n      if (this.isEdgeTypeOnly(from, to)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Display circular dependency warnings in a formatted, user-friendly way\n   * Shows each cycle with visual tree structure and helpful recommendations\n   */\n  private displayCircularDependencyWarnings(cycles: string[][]): void {\n    const colors = {\n      yellow: (text: string) => `\\x1b[33m${text}\\x1b[0m`,\n      cyan: (text: string) => `\\x1b[36m${text}\\x1b[0m`,\n      dim: (text: string) => `\\x1b[2m${text}\\x1b[0m`,\n      bold: (text: string) => `\\x1b[1m${text}\\x1b[0m`,\n      green: (text: string) => `\\x1b[32m${text}\\x1b[0m`,\n    };\n\n    console.log(\"\");\n    console.log(colors.yellow(\"⚠️  Circular Dependencies Detected\"));\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(\"\");\n    console.log(\n      colors.dim(\n        `Found ${colors.bold(cycles.length.toString())} circular dependency chain${cycles.length > 1 ? \"s\" : \"\"}`,\n      ),\n    );\n    console.log(\"\");\n\n    cycles.forEach((cycle, index) => {\n      console.log(colors.cyan(`  ${index + 1}. Cycle with ${cycle.length - 1} files:`));\n      console.log(\"\");\n\n      // Display the cycle chain\n      cycle.forEach((file, fileIndex) => {\n        const isLast = fileIndex === cycle.length - 1;\n        const arrow = isLast ? colors.dim(\"   └─→ \") : colors.dim(\"   ├─→ \");\n        const fileName = file.split(\"/\").pop() || file;\n        const filePath = colors.dim(file.replace(fileName, \"\"));\n\n        if (isLast) {\n          // Last item is the same as first (completes the cycle)\n          console.log(\n            arrow + colors.yellow(`${filePath}${colors.bold(fileName)} (cycle completes)`),\n          );\n        } else {\n          console.log(arrow + filePath + colors.bold(fileName));\n        }\n      });\n\n      console.log(\"\");\n    });\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.yellow(\"💡 How to Fix:\"));\n    console.log(\"\");\n\n    // This whole block prints \"How to Fix\" advice for a cycle that was just\n    // reported, so there is always one — but this is diagnostic OUTPUT, and a\n    // formatter that throws while explaining a problem replaces the problem\n    // with itself. An empty list simply has no example to show.\n    const exampleCycle = cycles[0] ?? [];\n    const fileA = exampleCycle[0]?.split(\"/\").pop() || \"fileA.ts\";\n    const fileB = exampleCycle[1]?.split(\"/\").pop() || \"fileB.ts\";\n    const stripExt = (file: string) => file.replace(/\\.tsx?$/, \"\");\n\n    const kind = classifyCycle(exampleCycle);\n\n    if (kind === \"resource\" || kind === \"model\") {\n      // Cascade's `lazy()` is purpose-built for circular relations between\n      // resources and models — recommend it first, not as a footnote.\n      console.log(colors.green(`  ✨ Use lazy() for the back-reference`));\n      console.log(\n        colors.dim(\n          `   ${kind === \"resource\" ? \"Resources\" : \"Models\"} that reference each other should declare`,\n        ),\n      );\n      console.log(colors.dim(`   one side with lazy() so the import resolves at access time:`));\n      console.log(\"\");\n      console.log(colors.dim(`     import { lazy } from \"@warlock.js/cascade\";`));\n      console.log(colors.dim(`     // inside ${fileB}:`));\n      console.log(\n        colors.dim(\n          `     other: lazy(() => ${kind === \"resource\" ? \"OtherResource\" : \"OtherModel\"})`,\n        ),\n      );\n      console.log(\"\");\n    } else {\n      // Generic cycle — dynamic import is the most common reliable fix.\n      console.log(colors.green(`  ✨ Convert one edge to a dynamic import`));\n      console.log(colors.dim(`   In ${fileB}, change:`));\n      console.log(colors.dim(`     import { SomeClass } from \"./${stripExt(fileA)}\";`));\n      console.log(colors.dim(`   To:`));\n      console.log(colors.dim(`     const { SomeClass } = await import(\"./${stripExt(fileA)}\");`));\n      console.log(\"\");\n    }\n\n    console.log(colors.dim(\"  Other options:\"));\n    console.log(colors.dim(\"    • Extract the shared symbols into a third file both can import.\"));\n    console.log(\n      colors.dim(\"    • Pass the dependency as a constructor/function parameter instead.\"),\n    );\n    console.log(\"\");\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.dim(\"   Circular dependencies can cause HMR issues and hard-to-debug\"));\n    console.log(colors.dim(\"   initialization order problems. Consider refactoring.\"));\n    console.log(\"\");\n  }\n\n  /**\n   * Get statistics about the dependency graph\n   */\n  public getStats() {\n    let totalDependencies = 0;\n    let maxDependencies = 0;\n    let maxDependents = 0;\n    let mostDependedFile = \"\";\n    let mostDependingFile = \"\";\n\n    for (const [file, deps] of this.dependencies) {\n      totalDependencies += deps.size;\n      if (deps.size > maxDependencies) {\n        maxDependencies = deps.size;\n        mostDependingFile = file;\n      }\n    }\n\n    for (const [file, deps] of this.dependents) {\n      if (deps.size > maxDependents) {\n        maxDependents = deps.size;\n        mostDependedFile = file;\n      }\n    }\n\n    return {\n      totalFiles: this.dependencies.size,\n      totalDependencies,\n      avgDependenciesPerFile: totalDependencies / this.dependencies.size || 0,\n      maxDependencies,\n      maxDependents,\n      mostDependingFile,\n      mostDependedFile,\n    };\n  }\n}\n\n/**\n * Pick the most useful \"fix-it\" hint for a cycle by inspecting the file\n * extensions involved. Cascade resources/models have a first-class fix\n * (`lazy()`); generic cycles just want a dynamic import.\n */\nfunction classifyCycle(cycle: string[]): \"resource\" | \"model\" | \"generic\" {\n  const files = cycle.slice(0, -1); // last entry repeats the first\n  if (files.every((file) => file.endsWith(\".resource.ts\") || file.endsWith(\".resource.tsx\"))) {\n    return \"resource\";\n  }\n  if (files.every((file) => file.endsWith(\".model.ts\") || file.endsWith(\".model.tsx\"))) {\n    return \"model\";\n  }\n  return \"generic\";\n}\n"],"mappings":"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"}
+{"version":3,"file":"dependency-graph.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dependency-graph.ts"],"sourcesContent":["import type { FileManager } from \"./file-manager\";\n\n/**\n * Dependency Graph\n * Tracks bidirectional relationships between files:\n * - dependencies: files that this file imports\n * - dependents: files that import this file\n *\n * Each forward edge also carries an `isTypeOnly` flag so cycle detection\n * can distinguish runtime cycles from ones formed purely by `import type`\n * edges — the latter are erased by TypeScript and have no runtime effect.\n */\nexport class DependencyGraph {\n  /**\n   * Map of file -> files it depends on (imports).\n   * Key: relative file path.\n   * Value: relative dependency path → `{ isTypeOnly }` for that edge.\n   */\n  private dependencies = new Map<string, Map<string, { isTypeOnly: boolean }>>();\n\n  /**\n   * Map of file -> files that depend on it (importers)\n   * Key: relative file path\n   * Value: Set of relative file paths that import this file\n   */\n  private dependents = new Map<string, Set<string>>();\n\n  /**\n   * Reference to the files map for accessing FileManager instances\n   * Used to read per-file typeOnlyDependencies during graph build.\n   */\n  private files: Map<string, FileManager> | null = null;\n\n  /**\n   * Build dependency graph from FileManager map\n   */\n  public build(files: Map<string, FileManager>) {\n    this.files = files;\n\n    this.dependencies.clear();\n    this.dependents.clear();\n\n    for (const [relativePath, fileManager] of files) {\n      if (!this.dependencies.has(relativePath)) {\n        this.dependencies.set(relativePath, new Map());\n      }\n\n      if (!this.dependents.has(relativePath)) {\n        this.dependents.set(relativePath, new Set());\n      }\n\n      for (const dependency of fileManager.dependencies) {\n        const isTypeOnly = fileManager.typeOnlyDependencies.has(dependency);\n\n        this.addDependency(relativePath, dependency, isTypeOnly);\n      }\n    }\n\n    const cycles = this.detectCircularDependencies();\n\n    if (cycles.length > 0) {\n      this.displayCircularDependencyWarnings(cycles);\n    }\n  }\n\n  /**\n   * Add a dependency relationship.\n   * If the edge already exists, the type-only flag is ANDed: any runtime\n   * statement between the two files makes the edge runtime permanently.\n   *\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   * @param isTypeOnly Whether every reference from `file` to `dependency` is type-only\n   */\n  public addDependency(file: string, dependency: string, isTypeOnly: boolean = false) {\n    if (!this.dependencies.has(file)) {\n      this.dependencies.set(file, new Map());\n    }\n\n    if (!this.dependents.has(dependency)) {\n      this.dependents.set(dependency, new Set());\n    }\n\n    const edges = this.dependencies.get(file)!;\n    const existing = edges.get(dependency);\n\n    if (existing) {\n      existing.isTypeOnly = existing.isTypeOnly && isTypeOnly;\n    } else {\n      edges.set(dependency, { isTypeOnly });\n    }\n\n    this.dependents.get(dependency)!.add(file);\n  }\n\n  /**\n   * Remove a dependency relationship\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   */\n  public removeDependency(file: string, dependency: string) {\n    this.dependencies.get(file)?.delete(dependency);\n    this.dependents.get(dependency)?.delete(file);\n  }\n\n  /**\n   * Remove all relationships for a file\n   * @param file The file to remove\n   */\n  public removeFile(file: string) {\n    const deps = this.dependencies.get(file);\n\n    if (deps) {\n      for (const dependency of deps.keys()) {\n        this.dependents.get(dependency)?.delete(file);\n      }\n    }\n\n    const dependents = this.dependents.get(file);\n\n    if (dependents) {\n      for (const dependent of dependents) {\n        this.dependencies.get(dependent)?.delete(file);\n      }\n    }\n\n    this.dependencies.delete(file);\n    this.dependents.delete(file);\n  }\n\n  /**\n   * Update dependencies for a file.\n   *\n   * Accepts the updated `Set<string>` of dependency paths; when the caller\n   * has per-edge type-only info, pass `typeOnlyDependencies` so the new\n   * edges get the correct flag. Missing flag defaults to runtime.\n   *\n   * @param file The file to update\n   * @param newDependencies New set of dependency paths\n   * @param typeOnlyDependencies Subset of `newDependencies` whose edges are type-only\n   */\n  public updateFile(\n    file: string,\n    newDependencies: Set<string>,\n    typeOnlyDependencies: Set<string> = new Set(),\n  ) {\n    const oldEdges = this.dependencies.get(file) ?? new Map<string, { isTypeOnly: boolean }>();\n\n    for (const oldDep of oldEdges.keys()) {\n      if (!newDependencies.has(oldDep)) {\n        this.removeDependency(file, oldDep);\n      }\n    }\n\n    for (const newDep of newDependencies) {\n      const isTypeOnly = typeOnlyDependencies.has(newDep);\n      const existing = oldEdges.get(newDep);\n\n      if (!existing) {\n        this.addDependency(file, newDep, isTypeOnly);\n\n        continue;\n      }\n\n      if (existing.isTypeOnly !== isTypeOnly) {\n        existing.isTypeOnly = isTypeOnly;\n      }\n    }\n  }\n\n  /**\n   * Get files that this file depends on (imports)\n   * @param file The file to check\n   * @returns Set of files this file imports\n   */\n  public getDependencies(file: string): Set<string> {\n    const edges = this.dependencies.get(file);\n\n    if (!edges) {\n      return new Set();\n    }\n\n    return new Set(edges.keys());\n  }\n\n  /**\n   * Check whether the edge `file → dependency` is type-only.\n   * Returns false if the edge does not exist.\n   */\n  public isEdgeTypeOnly(file: string, dependency: string): boolean {\n    return this.dependencies.get(file)?.get(dependency)?.isTypeOnly === true;\n  }\n\n  /**\n   * Get files that depend on this file (importers)\n   * @param file The file to check\n   * @returns Set of files that import this file\n   */\n  public getDependents(file: string): Set<string> {\n    return this.dependents.get(file) || new Set();\n  }\n\n  /**\n   * Get invalidation chain for a file\n   * Returns all files that need to be reloaded when this file changes\n   * Includes the file itself and all transitive dependents\n   * @param file The file that changed\n   * @returns Array of files to invalidate (in order)\n   */\n  public getInvalidationChain(file: string): string[] {\n    const chain: string[] = [file];\n    const visited = new Set([file]);\n\n    const traverse = (current: string) => {\n      const deps = this.getDependents(current);\n      for (const dep of deps) {\n        if (!visited.has(dep)) {\n          visited.add(dep);\n          chain.push(dep);\n          traverse(dep); // Recursive traversal\n        }\n      }\n    };\n\n    traverse(file);\n    return chain;\n  }\n\n  /**\n   * Detect circular dependencies in the dependency graph.\n   * Uses depth-first search to find cycles.\n   *\n   * Filtering rule (per-edge): a cycle is suppressed when **any** edge in\n   * the chain is type-only. TypeScript erases type-only imports entirely,\n   * so a single type-only edge breaks the cycle at runtime. Only warn when\n   * every edge is a runtime binding — that's the cycle that actually loops\n   * at load time.\n   *\n   * @returns Array of circular dependency chains (each chain is an array of file paths)\n   */\n  public detectCircularDependencies(): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const dfs = (file: string, path: string[]): void => {\n      visited.add(file);\n      recursionStack.add(file);\n      path.push(file);\n\n      const edges = this.dependencies.get(file);\n\n      if (edges) {\n        for (const dep of edges.keys()) {\n          if (!visited.has(dep)) {\n            dfs(dep, [...path]);\n          } else if (recursionStack.has(dep)) {\n            const cycleStart = path.indexOf(dep);\n            const cycle = [...path.slice(cycleStart), dep];\n\n            cycles.push(cycle);\n          }\n        }\n      }\n\n      recursionStack.delete(file);\n    };\n\n    for (const file of this.dependencies.keys()) {\n      if (!visited.has(file)) {\n        dfs(file, []);\n      }\n    }\n\n    return cycles.filter((cycle) => this.isRuntimeCycle(cycle));\n  }\n\n  /**\n   * True iff every edge in the cycle is a runtime binding. The cycle array\n   * ends with a duplicate of its start (`[A, B, C, A]`) so we walk the\n   * consecutive pairs once — any type-only edge means TS erases the loop\n   * and there is no runtime cycle to report.\n   */\n  private isRuntimeCycle(cycle: string[]): boolean {\n    for (let index = 0; index < cycle.length - 1; index++) {\n      const from = cycle[index];\n      const to = cycle[index + 1];\n\n      // `index < cycle.length - 1` bounds both reads. Skipping an unreadable\n      // edge rather than defaulting: this decides whether a cycle is\n      // TYPE-ONLY, and a `?? \"\"` would ask `isEdgeTypeOnly(\"\", \"\")`, whose\n      // answer is about a pair of edges that do not exist. A cycle wrongly\n      // classified as type-only is a real circular import reported as harmless.\n      if (from === undefined || to === undefined) continue;\n\n      if (this.isEdgeTypeOnly(from, to)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Display circular dependency warnings in a formatted, user-friendly way\n   * Shows each cycle with visual tree structure and helpful recommendations\n   */\n  private displayCircularDependencyWarnings(cycles: string[][]): void {\n    const colors = {\n      yellow: (text: string) => `\\x1b[33m${text}\\x1b[0m`,\n      cyan: (text: string) => `\\x1b[36m${text}\\x1b[0m`,\n      dim: (text: string) => `\\x1b[2m${text}\\x1b[0m`,\n      bold: (text: string) => `\\x1b[1m${text}\\x1b[0m`,\n      green: (text: string) => `\\x1b[32m${text}\\x1b[0m`,\n    };\n\n    console.log(\"\");\n    console.log(colors.yellow(\"⚠️  Circular Dependencies Detected\"));\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(\"\");\n    console.log(\n      colors.dim(\n        `Found ${colors.bold(cycles.length.toString())} circular dependency chain${cycles.length > 1 ? \"s\" : \"\"}`,\n      ),\n    );\n    console.log(\"\");\n\n    cycles.forEach((cycle, index) => {\n      console.log(colors.cyan(`  ${index + 1}. Cycle with ${cycle.length - 1} files:`));\n      console.log(\"\");\n\n      // Display the cycle chain\n      cycle.forEach((file, fileIndex) => {\n        const isLast = fileIndex === cycle.length - 1;\n        const arrow = isLast ? colors.dim(\"   └─→ \") : colors.dim(\"   ├─→ \");\n        const fileName = file.split(\"/\").pop() || file;\n        const filePath = colors.dim(file.replace(fileName, \"\"));\n\n        if (isLast) {\n          // Last item is the same as first (completes the cycle)\n          console.log(\n            arrow + colors.yellow(`${filePath}${colors.bold(fileName)} (cycle completes)`),\n          );\n        } else {\n          console.log(arrow + filePath + colors.bold(fileName));\n        }\n      });\n\n      console.log(\"\");\n    });\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.yellow(\"💡 How to Fix:\"));\n    console.log(\"\");\n\n    // This whole block prints \"How to Fix\" advice for a cycle that was just\n    // reported, so there is always one — but this is diagnostic OUTPUT, and a\n    // formatter that throws while explaining a problem replaces the problem\n    // with itself. An empty list simply has no example to show.\n    const exampleCycle = cycles[0] ?? [];\n    const fileA = exampleCycle[0]?.split(\"/\").pop() || \"fileA.ts\";\n    const fileB = exampleCycle[1]?.split(\"/\").pop() || \"fileB.ts\";\n    const stripExt = (file: string) => file.replace(/\\.tsx?$/, \"\");\n\n    const kind = classifyCycle(exampleCycle);\n\n    if (kind === \"resource\" || kind === \"model\") {\n      // Cascade's `lazy()` is purpose-built for circular relations between\n      // resources and models — recommend it first, not as a footnote.\n      console.log(colors.green(`  ✨ Use lazy() for the back-reference`));\n      console.log(\n        colors.dim(\n          `   ${kind === \"resource\" ? \"Resources\" : \"Models\"} that reference each other should declare`,\n        ),\n      );\n      console.log(colors.dim(`   one side with lazy() so the import resolves at access time:`));\n      console.log(\"\");\n      console.log(colors.dim(`     import { lazy } from \"@warlock.js/cascade\";`));\n      console.log(colors.dim(`     // inside ${fileB}:`));\n      console.log(\n        colors.dim(\n          `     other: lazy(() => ${kind === \"resource\" ? \"OtherResource\" : \"OtherModel\"})`,\n        ),\n      );\n      console.log(\"\");\n    } else {\n      // Generic cycle — dynamic import is the most common reliable fix.\n      console.log(colors.green(`  ✨ Convert one edge to a dynamic import`));\n      console.log(colors.dim(`   In ${fileB}, change:`));\n      console.log(colors.dim(`     import { SomeClass } from \"./${stripExt(fileA)}\";`));\n      console.log(colors.dim(`   To:`));\n      console.log(colors.dim(`     const { SomeClass } = await import(\"./${stripExt(fileA)}\");`));\n      console.log(\"\");\n    }\n\n    console.log(colors.dim(\"  Other options:\"));\n    console.log(colors.dim(\"    • Extract the shared symbols into a third file both can import.\"));\n    console.log(\n      colors.dim(\"    • Pass the dependency as a constructor/function parameter instead.\"),\n    );\n    console.log(\"\");\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.dim(\"   Circular dependencies can cause HMR issues and hard-to-debug\"));\n    console.log(colors.dim(\"   initialization order problems. Consider refactoring.\"));\n    console.log(\"\");\n  }\n\n  /**\n   * Get statistics about the dependency graph\n   */\n  public getStats() {\n    let totalDependencies = 0;\n    let maxDependencies = 0;\n    let maxDependents = 0;\n    let mostDependedFile = \"\";\n    let mostDependingFile = \"\";\n\n    for (const [file, deps] of this.dependencies) {\n      totalDependencies += deps.size;\n      if (deps.size > maxDependencies) {\n        maxDependencies = deps.size;\n        mostDependingFile = file;\n      }\n    }\n\n    for (const [file, deps] of this.dependents) {\n      if (deps.size > maxDependents) {\n        maxDependents = deps.size;\n        mostDependedFile = file;\n      }\n    }\n\n    return {\n      totalFiles: this.dependencies.size,\n      totalDependencies,\n      avgDependenciesPerFile: totalDependencies / this.dependencies.size || 0,\n      maxDependencies,\n      maxDependents,\n      mostDependingFile,\n      mostDependedFile,\n    };\n  }\n}\n\n/**\n * Pick the most useful \"fix-it\" hint for a cycle by inspecting the file\n * extensions involved. Cascade resources/models have a first-class fix\n * (`lazy()`); generic cycles just want a dynamic import.\n */\nfunction classifyCycle(cycle: string[]): \"resource\" | \"model\" | \"generic\" {\n  const files = cycle.slice(0, -1); // last entry repeats the first\n  if (files.every((file) => file.endsWith(\".resource.ts\") || file.endsWith(\".resource.tsx\"))) {\n    return \"resource\";\n  }\n  if (files.every((file) => file.endsWith(\".model.ts\") || file.endsWith(\".model.tsx\"))) {\n    return \"model\";\n  }\n  return \"generic\";\n}\n"],"mappings":"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"}

package/esm/dev-server/dev-agent-tooling.mjs

@@ -0,0 +1,135 @@
+import { getHttpReadyReport } from "../http/ready-report.mjs";
+import { connectorsManager } from "../connectors/connectors-manager.mjs";
+import { devLogInfo, devLogWarn } from "./dev-logger.mjs";
+import { removeDevServerState, writeDevServerState } from "../tooling/dev-state/dev-server-state.mjs";
+import { DEFAULT_DEVTOOLS_PATH } from "../tooling/devtools/devtools-client.mjs";
+
+//#region ../../packages/core/src/dev-server/dev-agent-tooling.ts
+/** Resolve `devServer.mcp` and the `--mcp` flag (the flag turns it on with the config's options). */
+function resolveDevMcpOptions(flag, config) {
+	if (!flag && !config) return false;
+	const settings = typeof config === "object" ? config : {};
+	return {
+		port: settings.port ?? 0,
+		...settings.token ? { token: settings.token } : {},
+		allowWrites: settings.allowWrites === true
+	};
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/**
+* The agent-facing side of `warlock dev`, all best-effort — none of it may
+* stop the app from serving:
+*
+* - records the server's address in `.warlock/dev-server.json` (read by
+*   `warlock trace` and `warlock mcp`), removed on shutdown;
+* - keeps the generated section of `AGENTS.md` fresh (unless
+*   `devServer.agentsMd: false`), on boot and after each reload, debounced;
+* - with `--mcp` / `devServer.mcp`, serves `warlock mcp` over HTTP on
+*   loopback from this process, so `inspect_*` reads the live registries.
+*
+* The tooling modules are imported lazily: they pull in the TypeScript
+* compiler and the generators, which a dev boot without them never needs.
+*/
+var DevAgentTooling = class {
+	/** @param cwd Project root. Default: `process.cwd()`. */
+	constructor(cwd = process.cwd()) {
+		this.cwd = cwd;
+		this.stateWritten = false;
+	}
+	async start(options) {
+		const http = getHttpReadyReport();
+		const devtoolsActive = connectorsManager.list().some((connector) => connector.name === "devtools" && connector.isActive());
+		if (options.mcp) await this.startMcp(options.mcp, http?.url);
+		if (http) try {
+			writeDevServerState({
+				schemaVersion: 1,
+				pid: process.pid,
+				url: http.url,
+				startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				devtools: devtoolsActive ? { path: DEFAULT_DEVTOOLS_PATH } : null,
+				mcp: this.mcp?.url ? { url: this.mcp.url } : null
+			}, this.cwd);
+			this.stateWritten = true;
+		} catch (error) {
+			devLogWarn(`Could not record the dev server address: ${errorMessage(error)}`);
+		}
+		if (options.agentsMd) await this.startAgentsMd();
+	}
+	/** Called after every hot reload: routes or modules may have changed. */
+	afterReload() {
+		this.refresher?.schedule();
+	}
+	async shutdown() {
+		this.refresher?.dispose();
+		this.refresher = void 0;
+		if (this.mcp) {
+			const server = this.mcp;
+			this.mcp = void 0;
+			try {
+				await server.close();
+			} catch (error) {
+				devLogWarn(`MCP server did not close cleanly: ${errorMessage(error)}`);
+			}
+		}
+		if (this.stateWritten) {
+			this.stateWritten = false;
+			removeDevServerState(process.pid, this.cwd);
+		}
+	}
+	async startAgentsMd() {
+		try {
+			const [{ createAgentsMdRefresher }, { inspectApp }] = await Promise.all([import("../tooling/agents-md/index.mjs"), import("../tooling/inspect/inspect-app.mjs")]);
+			this.refresher = createAgentsMdRefresher({
+				cwd: this.cwd,
+				collect: () => inspectApp({ sections: [
+					"routes",
+					"models",
+					"packages"
+				] }),
+				onWrite: (result) => {
+					if (result.status === "created" || result.status === "updated") devLogInfo(`AGENTS.md generated section ${result.status}`);
+				},
+				onError: (error) => devLogWarn(`AGENTS.md not refreshed: ${errorMessage(error)}`)
+			});
+			this.refresher.schedule();
+		} catch (error) {
+			devLogWarn(`AGENTS.md refresh is off: ${errorMessage(error)}`);
+		}
+	}
+	async startMcp(options, serverUrl) {
+		try {
+			const [{ createMcpContext }, { startWarlockMcpServer }, { inspectApp }, { featuresMap }] = await Promise.all([
+				import("../tooling/mcp/create-mcp-context.mjs"),
+				import("../tooling/mcp/start-mcp-server.mjs"),
+				import("../tooling/inspect/inspect-app.mjs"),
+				import("../generations/features/index.mjs")
+			]);
+			const context = createMcpContext({
+				cwd: this.cwd,
+				allowWrites: options.allowWrites,
+				inspect: (sections) => inspectApp({ sections }),
+				...process.argv[1] ? { cliEntry: process.argv[1] } : {},
+				devtools: serverUrl ? { url: serverUrl } : {},
+				features: Object.keys(featuresMap)
+			});
+			this.mcp = await startWarlockMcpServer({
+				context,
+				transport: {
+					type: "http",
+					host: "127.0.0.1",
+					port: options.port,
+					...options.token ? { token: options.token } : {}
+				}
+			});
+			devLogInfo(`MCP server at ${this.mcp.url ?? "?"} (${options.allowWrites ? "writes allowed" : "read-only"}${options.token ? ", token required" : ""})`);
+		} catch (error) {
+			devLogWarn(`MCP server not started: ${errorMessage(error)}`);
+		}
+	}
+};
+
+//#endregion
+export { DevAgentTooling, resolveDevMcpOptions };
+//# sourceMappingURL=dev-agent-tooling.mjs.map

package/esm/dev-server/dev-agent-tooling.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-agent-tooling.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dev-agent-tooling.ts"],"sourcesContent":["import { connectorsManager } from \"../connectors/connectors-manager\";\nimport { getHttpReadyReport } from \"../http/ready-report\";\nimport { removeDevServerState, writeDevServerState } from \"../tooling/dev-state/dev-server-state\";\nimport { DEFAULT_DEVTOOLS_PATH } from \"../tooling/devtools/devtools-client\";\nimport { devLogInfo, devLogWarn } from \"./dev-logger\";\n\n/** `devServer.mcp` (or `--mcp`) resolved: off, or the HTTP options. */\nexport type DevMcpOptions = false | { port: number; token?: string; allowWrites: boolean };\n\n/** Resolve `devServer.mcp` and the `--mcp` flag (the flag turns it on with the config's options). */\nexport function resolveDevMcpOptions(\n  flag: boolean | undefined,\n  config: boolean | { port?: number; token?: string; allowWrites?: boolean } | undefined,\n): DevMcpOptions {\n  if (!flag && !config) return false;\n\n  const settings = typeof config === \"object\" ? config : {};\n\n  return {\n    port: settings.port ?? 0,\n    ...(settings.token ? { token: settings.token } : {}),\n    allowWrites: settings.allowWrites === true,\n  };\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * The agent-facing side of `warlock dev`, all best-effort — none of it may\n * stop the app from serving:\n *\n * - records the server's address in `.warlock/dev-server.json` (read by\n *   `warlock trace` and `warlock mcp`), removed on shutdown;\n * - keeps the generated section of `AGENTS.md` fresh (unless\n *   `devServer.agentsMd: false`), on boot and after each reload, debounced;\n * - with `--mcp` / `devServer.mcp`, serves `warlock mcp` over HTTP on\n *   loopback from this process, so `inspect_*` reads the live registries.\n *\n * The tooling modules are imported lazily: they pull in the TypeScript\n * compiler and the generators, which a dev boot without them never needs.\n */\nexport class DevAgentTooling {\n  private refresher?: { schedule(): void; dispose(): void };\n  private mcp?: { url?: string; close(): Promise<void> };\n  private stateWritten = false;\n\n  /** @param cwd Project root. Default: `process.cwd()`. */\n  public constructor(private readonly cwd: string = process.cwd()) {}\n\n  public async start(options: { agentsMd: boolean; mcp: DevMcpOptions }): Promise<void> {\n    const http = getHttpReadyReport();\n    const devtoolsActive = connectorsManager\n      .list()\n      .some((connector) => connector.name === \"devtools\" && connector.isActive());\n\n    if (options.mcp) {\n      await this.startMcp(options.mcp, http?.url);\n    }\n\n    if (http) {\n      try {\n        writeDevServerState(\n          {\n            schemaVersion: 1,\n            pid: process.pid,\n            url: http.url,\n            startedAt: new Date().toISOString(),\n            devtools: devtoolsActive ? { path: DEFAULT_DEVTOOLS_PATH } : null,\n            mcp: this.mcp?.url ? { url: this.mcp.url } : null,\n          },\n          this.cwd,\n        );\n        this.stateWritten = true;\n      } catch (error) {\n        devLogWarn(`Could not record the dev server address: ${errorMessage(error)}`);\n      }\n    }\n\n    if (options.agentsMd) {\n      await this.startAgentsMd();\n    }\n  }\n\n  /** Called after every hot reload: routes or modules may have changed. */\n  public afterReload(): void {\n    this.refresher?.schedule();\n  }\n\n  public async shutdown(): Promise<void> {\n    this.refresher?.dispose();\n    this.refresher = undefined;\n\n    if (this.mcp) {\n      const server = this.mcp;\n      this.mcp = undefined;\n\n      try {\n        await server.close();\n      } catch (error) {\n        devLogWarn(`MCP server did not close cleanly: ${errorMessage(error)}`);\n      }\n    }\n\n    if (this.stateWritten) {\n      this.stateWritten = false;\n      removeDevServerState(process.pid, this.cwd);\n    }\n  }\n\n  private async startAgentsMd(): Promise<void> {\n    try {\n      const [{ createAgentsMdRefresher }, { inspectApp }] = await Promise.all([\n        import(\"../tooling/agents-md\"),\n        import(\"../tooling/inspect/inspect-app\"),\n      ]);\n\n      this.refresher = createAgentsMdRefresher({\n        cwd: this.cwd,\n        collect: () => inspectApp({ sections: [\"routes\", \"models\", \"packages\"] }),\n        onWrite: (result) => {\n          if (result.status === \"created\" || result.status === \"updated\") {\n            devLogInfo(`AGENTS.md generated section ${result.status}`);\n          }\n        },\n        onError: (error) => devLogWarn(`AGENTS.md not refreshed: ${errorMessage(error)}`),\n      });\n      this.refresher.schedule();\n    } catch (error) {\n      devLogWarn(`AGENTS.md refresh is off: ${errorMessage(error)}`);\n    }\n  }\n\n  private async startMcp(\n    options: Exclude<DevMcpOptions, false>,\n    serverUrl?: string,\n  ): Promise<void> {\n    try {\n      const [{ createMcpContext }, { startWarlockMcpServer }, { inspectApp }, { featuresMap }] =\n        await Promise.all([\n          import(\"../tooling/mcp/create-mcp-context\"),\n          import(\"../tooling/mcp/start-mcp-server\"),\n          import(\"../tooling/inspect/inspect-app\"),\n          import(\"../generations/features\"),\n        ]);\n      const context = createMcpContext({\n        cwd: this.cwd,\n        allowWrites: options.allowWrites,\n        inspect: (sections) => inspectApp({ sections }),\n        ...(process.argv[1] ? { cliEntry: process.argv[1] } : {}),\n        devtools: serverUrl ? { url: serverUrl } : {},\n        features: Object.keys(featuresMap),\n      });\n\n      this.mcp = await startWarlockMcpServer({\n        context,\n        transport: {\n          type: \"http\",\n          host: \"127.0.0.1\",\n          port: options.port,\n          ...(options.token ? { token: options.token } : {}),\n        },\n      });\n\n      devLogInfo(\n        `MCP server at ${this.mcp.url ?? \"?\"} (${options.allowWrites ? \"writes allowed\" : \"read-only\"}${options.token ? \", token required\" : \"\"})`,\n      );\n    } catch (error) {\n      devLogWarn(`MCP server not started: ${errorMessage(error)}`);\n    }\n  }\n}\n"],"mappings":"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"}

package/esm/dev-server/dev-logger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dev-logger.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dev-logger.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport dayjs from \"dayjs\";\nimport { Path } from \"../utils/normalized-path\";\n\n/**\n * Dev server logger — Vite-style formatting helpers.\n */\n\nfunction timestamp(): string {\n  return colors.dim(`${dayjs().format(\"HH:mm:ss A\")}`);\n}\n\nexport function devLog(message: string) {\n  console.log(`${timestamp()} ${message}`);\n}\n\nexport function devLogSuccess(message: string) {\n  console.log(`${timestamp()} ${colors.green(\"✓\")} ${colors.green(message)}`);\n}\n\n/**\n * Colourise a stack trace so the eye lands on *your* code.\n *\n * - Error header (`ReferenceError: x is not defined`) → bold red.\n * - Frames in project `src/` → highlighted: a green `›` pointer, yellow\n *   function name, cyan relative path, dim `:line:col`. These are almost\n *   always where the bug is.\n * - Framework (`@warlock.js`), `node_modules`, and `node:` internal frames\n *   → dimmed and relativised. Still there for context, just out of the way.\n *\n * Source maps are enabled in dev, so the paths/lines here are already the\n * original `.ts` locations — this only changes how they're painted.\n */\nexport function formatErrorStack(stack: string): string {\n  const frame = /^(\\s*)at (.+?) \\((.+):(\\d+):(\\d+)\\)$/;\n  const bareFrame = /^(\\s*)at (.+):(\\d+):(\\d+)$/;\n  let headerDone = false;\n\n  return stack\n    .split(\"\\n\")\n    .map((line) => {\n      const withFn = line.match(frame);\n      const bare = line.match(bareFrame);\n\n      if (!withFn && !bare) {\n        // Header line(s) before the first frame.\n        const painted = headerDone ? colors.dim(line) : colors.bold(colors.red(line));\n        return painted;\n      }\n\n      headerDone = true;\n\n      // Every read here is defaulted rather than asserted, and the reason is\n      // what this function IS: a stack-trace formatter. If it throws while\n      // formatting, it throws INSIDE error reporting — and what the developer\n      // then sees is this function's failure instead of the error they were\n      // actually chasing. An unreadable frame should degrade to a blank field,\n      // never take the report down with it — every fatal needs an\n      // unconditional floor.\n      const fn = (withFn ? withFn[2] : \"\") ?? \"\";\n      const file = (withFn ? withFn[3] : bare?.[2]) ?? \"\";\n      const lineNo = (withFn ? withFn[4] : bare?.[3]) ?? \"\";\n      const col = (withFn ? withFn[5] : bare?.[4]) ?? \"\";\n\n      const isNodeInternal = file.startsWith(\"node:\");\n      const isDep = file.includes(\"node_modules\");\n      const isFramework = /[\\\\/]@warlock\\.js[\\\\/]/.test(file);\n      const isUserCode = !isNodeInternal && !isDep && !isFramework;\n\n      const rel = isNodeInternal ? file : Path.toRelative(file);\n      const loc = `:${lineNo}:${col}`;\n\n      if (isUserCode) {\n        return (\n          `  ${colors.green(\"›\")} ${colors.dim(\"at\")} ` +\n          `${colors.yellow(fn || \"<anonymous>\")} ` +\n          `${colors.cyan(rel)}${colors.dim(loc)}`\n        );\n      }\n\n      const label = fn ? `at ${fn} ${rel}${loc}` : `at ${rel}${loc}`;\n      return `    ${colors.dim(label)}`;\n    })\n    .join(\"\\n\");\n}\n\nexport function devLogError(message: string, error?: any) {\n  console.log(`${timestamp()} ${colors.red(\"✗\")} ${colors.red(message)}`);\n  if (error?.stack) console.log(formatErrorStack(error.stack));\n}\n\nexport function devLogWarn(message: string) {\n  console.log(`${timestamp()} ${colors.yellow(\"⚠\")} ${colors.yellow(message)}`);\n}\n\nexport function devLogInfo(message: string) {\n  console.log(`${timestamp()} ${colors.cyan(message)}`);\n}\n\nexport function devLogDim(message: string) {\n  console.log(`${timestamp()} ${colors.dim(message)}`);\n}\n\nexport function devLogHMR(file: string, dependents?: number, durationMs?: number) {\n  const relativePath = Path.toRelative(file);\n  const depInfo = dependents\n    ? colors.dim(` +${dependents} module${dependents > 1 ? \"s\" : \"\"}`)\n    : \"\";\n  const durationInfo = durationMs !== undefined ? colors.dim(` (${durationMs}ms)`) : \"\";\n  console.log(\n    `${timestamp()} 🔥 ${colors.green(\"hmr update\")} ${colors.dim(relativePath)}${depInfo}${durationInfo}`,\n  );\n}\n\n/**\n * Per-phase breakdown for one hot reload, printed only when\n * `devServer.timings` is on. Phases run in this order: the watcher's\n * `awaitWriteFinish` settle wait, this handler's own debounce wait,\n * module-graph invalidation (version bumps), re-import of the changed\n * modules, and connector restart/rebind.\n */\nexport type ReloadPhaseTimings = {\n  watcherSettleMs: number;\n  debounceWaitMs: number;\n  moduleGraphInvalidationMs: number;\n  reimportMs: number;\n  connectorRestartMs: number;\n};\n\nexport function devLogTimings(timings: ReloadPhaseTimings) {\n  const phase = (label: string, ms: number) => `${colors.dim(label)} ${colors.dim(`${Math.round(ms)}ms`)}`;\n  const line = [\n    phase(\"watcher\", timings.watcherSettleMs),\n    phase(\"debounce\", timings.debounceWaitMs),\n    phase(\"graph\", timings.moduleGraphInvalidationMs),\n    phase(\"reimport\", timings.reimportMs),\n    phase(\"connectors\", timings.connectorRestartMs),\n  ].join(colors.dim(\" · \"));\n  console.log(`${timestamp()}   ${colors.dim(\"⏱\")} ${line}`);\n}\n\nexport function devLogConfig(file: string, connectors?: string[]) {\n  const relativePath = Path.toRelative(file);\n  const connectorInfo =\n    connectors && connectors.length > 0 ? colors.dim(` → restarting ${connectors.join(\", \")}`) : \"\";\n  console.log(\n    `${timestamp()} ${colors.cyan(\"config reload\")} ${colors.dim(relativePath)}${connectorInfo}`,\n  );\n}\n\nexport function devLogReady(message: string) {\n  console.log(`\\n${timestamp()}  ${colors.green(\"➜\")}  ${colors.bold(message)}`);\n}\n\nexport function devLogSection(title: string) {\n  console.log(`\\n${timestamp()} ${colors.bold(colors.cyan(title))}`);\n}\n\n/**\n * Format ERR_MODULE_NOT_FOUND so the displayed paths are relative to the\n * project root. The loader hook keeps source paths in the URL so we only\n * need to strip the absolute prefix — no cache-path translation any more.\n */\nexport function formatModuleNotFoundError(error: Error, suggestions?: string[]): string {\n  const match = error.message.match(/Cannot find module '([^']+)' imported from '([^']+)'/);\n  if (!match) return error.message;\n\n  // Same rule as the frame formatter above: this renders a MODULE NOT FOUND\n  // report, so a missing capture must degrade the message, not replace the\n  // user's error with a crash inside the reporter.\n  const [, rawModulePath, rawImporterPath] = match;\n  const modulePath = rawModulePath ?? \"\";\n  const importerPath = rawImporterPath ?? \"\";\n  const lines: string[] = [\n    \"\",\n    `${colors.red(\"❌ MODULE NOT FOUND\")}`,\n    \"\",\n    `${colors.dim(\"Cannot find:\")} ${colors.cyan(Path.toRelative(modulePath))}`,\n    \"\",\n    `${colors.dim(\"Imported by:\")}`,\n    `  ${colors.yellow(\"→\")} ${colors.white(Path.toRelative(importerPath))}`,\n  ];\n\n  if (suggestions && suggestions.length > 0) {\n    lines.push(\"\");\n    lines.push(`${colors.dim(\"Did you mean?\")}`);\n    suggestions.forEach((s) => lines.push(`  ${colors.cyan(\"→\")} ${colors.green(s)}`));\n  }\n\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n/** @deprecated alias retained for older callers. Use `devLog` directly. */\nexport const devServeLog = devLog;\n"],"mappings":"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"}
+{"version":3,"file":"dev-logger.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dev-logger.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport dayjs from \"dayjs\";\nimport { Path } from \"../utils/normalized-path\";\n\n/**\n * Dev server logger — Vite-style formatting helpers.\n */\n\nfunction timestamp(): string {\n  return colors.dim(`${dayjs().format(\"HH:mm:ss A\")}`);\n}\n\nexport function devLog(message: string) {\n  console.log(`${timestamp()} ${message}`);\n}\n\nexport function devLogSuccess(message: string) {\n  console.log(`${timestamp()} ${colors.green(\"✓\")} ${colors.green(message)}`);\n}\n\n/**\n * Colourise a stack trace so the eye lands on *your* code.\n *\n * - Error header (`ReferenceError: x is not defined`) → bold red.\n * - Frames in project `src/` → highlighted: a green `›` pointer, yellow\n *   function name, cyan relative path, dim `:line:col`. These are almost\n *   always where the bug is.\n * - Framework (`@warlock.js`), `node_modules`, and `node:` internal frames\n *   → dimmed and relativised. Still there for context, just out of the way.\n *\n * Source maps are enabled in dev, so the paths/lines here are already the\n * original `.ts` locations — this only changes how they're painted.\n */\nexport function formatErrorStack(stack: string): string {\n  const frame = /^(\\s*)at (.+?) \\((.+):(\\d+):(\\d+)\\)$/;\n  const bareFrame = /^(\\s*)at (.+):(\\d+):(\\d+)$/;\n  let headerDone = false;\n\n  return stack\n    .split(\"\\n\")\n    .map((line) => {\n      const withFn = line.match(frame);\n      const bare = line.match(bareFrame);\n\n      if (!withFn && !bare) {\n        // Header line(s) before the first frame.\n        const painted = headerDone ? colors.dim(line) : colors.bold(colors.red(line));\n        return painted;\n      }\n\n      headerDone = true;\n\n      // Every read here is defaulted rather than asserted, and the reason is\n      // what this function IS: a stack-trace formatter. If it throws while\n      // formatting, it throws INSIDE error reporting — and what the developer\n      // then sees is this function's failure instead of the error they were\n      // actually chasing. An unreadable frame should degrade to a blank field,\n      // never take the report down with it — every fatal needs an\n      // unconditional floor.\n      const fn = (withFn ? withFn[2] : \"\") ?? \"\";\n      const file = (withFn ? withFn[3] : bare?.[2]) ?? \"\";\n      const lineNo = (withFn ? withFn[4] : bare?.[3]) ?? \"\";\n      const col = (withFn ? withFn[5] : bare?.[4]) ?? \"\";\n\n      const isNodeInternal = file.startsWith(\"node:\");\n      const isDep = file.includes(\"node_modules\");\n      const isFramework = /[\\\\/]@warlock\\.js[\\\\/]/.test(file);\n      const isUserCode = !isNodeInternal && !isDep && !isFramework;\n\n      const rel = isNodeInternal ? file : Path.toRelative(file);\n      const loc = `:${lineNo}:${col}`;\n\n      if (isUserCode) {\n        return (\n          `  ${colors.green(\"›\")} ${colors.dim(\"at\")} ` +\n          `${colors.yellow(fn || \"<anonymous>\")} ` +\n          `${colors.cyan(rel)}${colors.dim(loc)}`\n        );\n      }\n\n      const label = fn ? `at ${fn} ${rel}${loc}` : `at ${rel}${loc}`;\n      return `    ${colors.dim(label)}`;\n    })\n    .join(\"\\n\");\n}\n\nexport function devLogError(message: string, error?: any) {\n  console.log(`${timestamp()} ${colors.red(\"✗\")} ${colors.red(message)}`);\n  if (error?.stack) console.log(formatErrorStack(error.stack));\n}\n\nexport function devLogWarn(message: string) {\n  console.log(`${timestamp()} ${colors.yellow(\"⚠\")} ${colors.yellow(message)}`);\n}\n\nexport function devLogInfo(message: string) {\n  console.log(`${timestamp()} ${colors.cyan(message)}`);\n}\n\nexport function devLogDim(message: string) {\n  console.log(`${timestamp()} ${colors.dim(message)}`);\n}\n\nexport function devLogHMR(file: string, dependents?: number, durationMs?: number) {\n  const relativePath = Path.toRelative(file);\n  const depInfo = dependents\n    ? colors.dim(` +${dependents} module${dependents > 1 ? \"s\" : \"\"}`)\n    : \"\";\n  const durationInfo = durationMs !== undefined ? colors.dim(` (${durationMs}ms)`) : \"\";\n  console.log(\n    `${timestamp()} 🔥 ${colors.green(\"hmr update\")} ${colors.dim(relativePath)}${depInfo}${durationInfo}`,\n  );\n}\n\n/**\n * Per-phase breakdown for one hot reload, printed only when\n * `devServer.timings` is on. Phases run in this order: the watcher's\n * `awaitWriteFinish` settle wait, this handler's own debounce wait,\n * module-graph invalidation (version bumps), re-import of the changed\n * modules, and connector restart/rebind.\n */\nexport type ReloadPhaseTimings = {\n  watcherSettleMs: number;\n  debounceWaitMs: number;\n  moduleGraphInvalidationMs: number;\n  reimportMs: number;\n  connectorRestartMs: number;\n};\n\nexport function devLogTimings(timings: ReloadPhaseTimings) {\n  const phase = (label: string, ms: number) =>\n    `${colors.dim(label)} ${colors.dim(`${Math.round(ms)}ms`)}`;\n  const line = [\n    phase(\"watcher\", timings.watcherSettleMs),\n    phase(\"debounce\", timings.debounceWaitMs),\n    phase(\"graph\", timings.moduleGraphInvalidationMs),\n    phase(\"reimport\", timings.reimportMs),\n    phase(\"connectors\", timings.connectorRestartMs),\n  ].join(colors.dim(\" · \"));\n  console.log(`${timestamp()}   ${colors.dim(\"⏱\")} ${line}`);\n}\n\nexport function devLogConfig(file: string, connectors?: string[]) {\n  const relativePath = Path.toRelative(file);\n  const connectorInfo =\n    connectors && connectors.length > 0 ? colors.dim(` → restarting ${connectors.join(\", \")}`) : \"\";\n  console.log(\n    `${timestamp()} ${colors.cyan(\"config reload\")} ${colors.dim(relativePath)}${connectorInfo}`,\n  );\n}\n\nexport function devLogReady(message: string) {\n  console.log(`\\n${timestamp()}  ${colors.green(\"➜\")}  ${colors.bold(message)}`);\n}\n\nexport function devLogSection(title: string) {\n  console.log(`\\n${timestamp()} ${colors.bold(colors.cyan(title))}`);\n}\n\n/**\n * Format ERR_MODULE_NOT_FOUND so the displayed paths are relative to the\n * project root. The loader hook keeps source paths in the URL so we only\n * need to strip the absolute prefix — no cache-path translation any more.\n */\nexport function formatModuleNotFoundError(error: Error, suggestions?: string[]): string {\n  const match = error.message.match(/Cannot find module '([^']+)' imported from '([^']+)'/);\n  if (!match) return error.message;\n\n  // Same rule as the frame formatter above: this renders a MODULE NOT FOUND\n  // report, so a missing capture must degrade the message, not replace the\n  // user's error with a crash inside the reporter.\n  const [, rawModulePath, rawImporterPath] = match;\n  const modulePath = rawModulePath ?? \"\";\n  const importerPath = rawImporterPath ?? \"\";\n  const lines: string[] = [\n    \"\",\n    `${colors.red(\"❌ MODULE NOT FOUND\")}`,\n    \"\",\n    `${colors.dim(\"Cannot find:\")} ${colors.cyan(Path.toRelative(modulePath))}`,\n    \"\",\n    `${colors.dim(\"Imported by:\")}`,\n    `  ${colors.yellow(\"→\")} ${colors.white(Path.toRelative(importerPath))}`,\n  ];\n\n  if (suggestions && suggestions.length > 0) {\n    lines.push(\"\");\n    lines.push(`${colors.dim(\"Did you mean?\")}`);\n    suggestions.forEach((s) => lines.push(`  ${colors.cyan(\"→\")} ${colors.green(s)}`));\n  }\n\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n/** @deprecated alias retained for older callers. Use `devLog` directly. */\nexport const devServeLog = devLog;\n"],"mappings":"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"}

package/esm/dev-server/development-server.mjs

@@ -13,6 +13,7 @@ import { restartDevServer } from "./restart-dev-server.mjs";
 import { devServerShortcuts } from "./shortcuts.mjs";
 import { BootPreconditionError } from "./boot-precondition-error.mjs";
 import { buildDevelopmentOpenApiDocument } from "./build-development-openapi-document.mjs";
+import { DevAgentTooling, resolveDevMcpOptions } from "./dev-agent-tooling.mjs";
 import { LayerExecutor } from "./layer-executor.mjs";
 import { printReadyBlock } from "./ready-block.mjs";
 import { registerInstalledDevtools } from "./register-installed-devtools.mjs";
@@ -32,6 +33,7 @@ var DevelopmentServer = class {
 	constructor(options = {}) {
 		this.running = false;
 		this.connectorsStarted = false;
+		this.agentTooling = new DevAgentTooling();
 		this.reloadQueue = Promise.resolve();
 		this.options = options;
 		devLogSection("Starting Development Server...");
@@ -73,6 +75,10 @@ var DevelopmentServer = class {
 			const devServerConfig = await warlockConfigManager.get("devServer");
 			const generateTypings = this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;
 			const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;
+			await this.agentTooling.start({
+				agentsMd: devServerConfig?.agentsMd !== false,
+				mcp: resolveDevMcpOptions(this.options.mcp, devServerConfig?.mcp)
+			});
 			if (generateTypings) await typeGenerator.executeGenerateAllCommand();
 			if (healthCheckers) filesOrchestrator.startCheckingHealth(healthCheckers === true ? void 0 : healthCheckers);
 		} catch (error) {
@@ -108,6 +114,7 @@ var DevelopmentServer = class {
 				...batch.changed,
 				...batch.deleted
 			]);
+			this.agentTooling.afterReload();
 			filesOrchestrator.checkHealth(batch);
 		} catch (error) {
 			devServeLog(colors.redBright(`Failed to execute batch reload: ${error}`));
@@ -144,6 +151,7 @@ var DevelopmentServer = class {
 		devServeLog(colors.redBright("Shutting down Development Server..."));
 		this.running = false;
 		this.connectorsStarted = false;
+		await this.agentTooling.shutdown();
 		await connectorsManager.shutdown();
 		devServeLog(colors.greenBright("Development Server stopped"));
 	}

package/esm/dev-server/development-server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"development-server.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport events from \"@mongez/events\";\nimport { fileExistsAsync, unlinkAsync } from \"@warlock.js/fs\";\nimport { Application } from \"../application\";\nimport { connectorsManager } from \"../connectors/connectors-manager\";\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\nimport { warlockConfigManager } from \"../warlock-config\";\nimport { registerDevelopmentOpenApiProvider } from \"../openapi/development-openapi-provider\";\nimport { BootPreconditionError } from \"./boot-precondition-error\";\nimport { buildDevelopmentOpenApiDocument } from \"./build-development-openapi-document\";\nimport { devLogInfo, devLogSection, devLogWarn, devServeLog } from \"./dev-logger\";\nimport { filesOrchestrator } from \"./files-orchestrator\";\nimport { MANIFEST_PATH } from \"./flags\";\nimport type { IncomingReloadTimings } from \"./layer-executor\";\nimport { LayerExecutor } from \"./layer-executor\";\nimport { printReadyBlock } from \"./ready-block\";\nimport { registerInstalledDevtools } from \"./register-installed-devtools\";\nimport { restartDevServer } from \"./restart-dev-server\";\nimport { collectDevelopmentApiRoutes } from \"./collect-development-api-routes\";\nimport { publishCurrentRouteTypes } from \"./route-types-publisher\";\nimport { devServerShortcuts } from \"./shortcuts\";\nimport type { StartDevServerOptions } from \"./start-development-server\";\nimport { typeGenerator } from \"./type-generator\";\n\ntype Batch = {\n  added: string[];\n  changed: string[];\n  deleted: string[];\n  /** Non-code `watch.include` files that changed; only a restart applies them. */\n  restartTriggers?: string[];\n  timings?: IncomingReloadTimings;\n};\n\n/**\n * Top-level coordinator for `warlock dev`. Wires the file orchestrator, the\n * connectors, and the layer executor together, and listens for the watcher's\n * batched events to drive HMR.\n */\nexport class DevelopmentServer {\n  private layerExecutor?: LayerExecutor;\n  private running = false;\n\n  /** Set once boot begins, so a failed boot still closes connectors that already started. */\n  private connectorsStarted = false;\n  private readonly options: StartDevServerOptions;\n\n  public constructor(options: StartDevServerOptions = {}) {\n    this.options = options;\n    devLogSection(\"Starting Development Server...\");\n  }\n\n  public async start(): Promise<void> {\n    try {\n      this.connectorsStarted = true;\n      const startedAt = performance.now();\n\n      // Devtools reads this through the root barrel, which must not reach dev-server code.\n      registerDevelopmentOpenApiProvider(buildDevelopmentOpenApiDocument);\n\n      // --fresh deletes the manifest so reconciliation re-parses every file\n      // from disk. Transpile caching is owned by the loader hook (in-memory).\n      if (this.options.fresh && (await fileExistsAsync(MANIFEST_PATH))) {\n        await unlinkAsync(MANIFEST_PATH);\n        devServeLog(colors.cyanBright(\"Cleared manifest (--fresh)\"));\n      }\n\n      await filesOrchestrator.init();\n      await filesOrchestrator.initializeAll();\n      await filesOrchestrator.watchFiles();\n\n      filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\n\n      this.setupEventListeners();\n\n      // Decorator-driven registries (models, etc.) must be populated before\n      // routes/services can resolve symbols by name.\n      await this.autoDiscoverFiles();\n\n      await filesOrchestrator.moduleLoader.loadAll();\n\n      // A rejecting validator (Application.onValidateBoot) must abort boot\n      // before late-phase connectors bind a port — this is what makes the\n      // hook actually prevent serving instead of merely being defined.\n      //\n      // Wrapped and re-thrown as a BootPreconditionError: a rejected\n      // validator is, by definition, a precondition whose cause cannot\n      // change because the worker tried again — the supervisor must not\n      // restart into the same rejection. See boot-precondition-error.ts.\n      try {\n        await Application.runStartupValidators();\n      } catch (error) {\n        throw new BootPreconditionError((error as Error).message, { cause: error });\n      }\n\n      // `@warlock.js/devtools` is a dev dependency the config never names;\n      // when installed it joins the late phase here, and only here.\n      await registerInstalledDevtools();\n\n      // Late-phase connectors (http, socket) bind after app code has\n      // registered routes/listeners.\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\n\n      // Web installs its page table from its late connector. Generate only\n      // after that installation so `href()` and the declaration table agree.\n      await publishCurrentRouteTypes(process.cwd(), await collectDevelopmentApiRoutes());\n\n      this.layerExecutor = new LayerExecutor(\n        filesOrchestrator.getDependencyGraph(),\n        filesOrchestrator.specialFilesCollector,\n        filesOrchestrator.moduleLoader,\n        (absolutePath) => filesOrchestrator.bumpVersion(absolutePath),\n        () => filesOrchestrator.flushVersionBumps(),\n      );\n\n      this.running = true;\n\n      const duration = performance.now() - startedAt;\n\n      // App modules are loaded and both connector phases are active — signal a\n      // complete boot so `Application.onceBooted(...)` listeners fire.\n      Application.markBooted({\n        environment: Application.environment,\n        runtimeStrategy: Application.runtimeStrategy,\n        bootDurationMs: duration,\n      });\n\n      // ONE block, AFTER the boot it summarises, replacing the scattered\n      // \"N route(s) registered\" / \"Server ready at …\" / \"ready in …\" lines that\n      // used to arrive in completion order. Warnings logged during boot sit\n      // above it and stay there — see `ready-block.ts`.\n      printReadyBlock(duration);\n\n      // Tell the supervisor (when there is one) that boot completed, so its\n      // healthy-uptime window counts from here rather than from spawn.\n      process.send?.(\"warlock:booted\");\n\n      // Precedence: explicit CLI option > devServer.* config > default.\n      const devServerConfig = await warlockConfigManager.get(\"devServer\");\n      const generateTypings =\n        this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;\n      const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;\n\n      if (generateTypings) await typeGenerator.executeGenerateAllCommand();\n\n      if (healthCheckers) {\n        filesOrchestrator.startCheckingHealth(healthCheckers === true ? undefined : healthCheckers);\n      }\n    } catch (error) {\n      devServeLog(colors.redBright(`Failed to start Development Server: ${error}`));\n      await this.shutdown();\n      throw error;\n    }\n  }\n\n  /**\n   * Eagerly import files whose decorators populate global registries so any\n   * symbol-by-name resolution later in boot finds them.\n   */\n  private async autoDiscoverFiles(): Promise<void> {\n    const discoveryTypes = [\"model\"] as const;\n    for (const file of filesOrchestrator.files.values()) {\n      if (file.type && (discoveryTypes as readonly string[]).includes(file.type)) {\n        await filesOrchestrator.moduleLoader.loadModule(file, file.type);\n      }\n    }\n  }\n\n  /** Tail of the batch-reload chain (see `setupEventListeners`). */\n  private reloadQueue: Promise<void> = Promise.resolve();\n\n  private setupEventListeners(): void {\n    // Reloads run one at a time: a second batch waits for the first to finish\n    // so route re-registration and connector restarts never interleave.\n    events.on(\"dev-server:batch-complete\", (batch: Batch) => {\n      this.reloadQueue = this.reloadQueue\n        .then(() => this.handleBatchComplete(batch))\n        .catch((error) => devServeLog(colors.redBright(`Batch reload failed: ${error}`)));\n    });\n  }\n\n  private async handleBatchComplete(batch: Batch): Promise<void> {\n    if (!this.running || !this.layerExecutor) return;\n\n    // warlock.config.ts holds settings read at boot (CLI commands, build\n    // options, watch patterns, scheduled jobs) and .env feeds every config\n    // that reads it. Neither can be hot-reloaded without leaving running\n    // services configured with stale values, so the only honest response is\n    // a full restart.\n    const restartTrigger = this.findRestartTrigger(batch);\n\n    if (restartTrigger) {\n      // On success this never comes back — the process exits and the\n      // supervisor replaces it. Reaching the next line means the restart was\n      // declined by config or wasn't possible, so we fall through and still\n      // hot-reload whatever ordinary code shared the batch.\n      await this.restartForConfigChange(restartTrigger);\n    }\n\n    // No-op saves (an editor that fsyncs without a content write) are already\n    // filtered upstream by the file hash in FileEventHandler, so batch.changed\n    // only contains genuinely-changed paths by the time it reaches here.\n\n    const total = batch.added.length + batch.changed.length + batch.deleted.length;\n    if (total === 0) return;\n\n    // Boot-time files still ride along in `changed` when a restart was\n    // declined (`restartOnConfigChange: false`) or wasn't possible — they are\n    // never hot-reloaded, so keep them out of the reload set either way.\n    const codeFiles = [...batch.added, ...batch.changed].filter(\n      (p) => !isEnvPath(p) && p !== \"warlock.config.ts\" && !batch.restartTriggers?.includes(p),\n    );\n\n    try {\n      await this.layerExecutor.executeBatchReload(\n        codeFiles,\n        filesOrchestrator.getFiles(),\n        batch.deleted,\n        batch.changed,\n        batch.timings,\n      );\n\n      // `executeBatchReload` includes route re-imports and affected connector\n      // restarts. Publishing earlier could freeze a partial page/API view.\n      // This also refreshes deletion-only batches after their cleanup/restart.\n      await publishCurrentRouteTypes(process.cwd(), await collectDevelopmentApiRoutes());\n\n      typeGenerator.executeTypingsGenerator([...batch.added, ...batch.changed, ...batch.deleted]);\n\n      filesOrchestrator.checkHealth(batch);\n    } catch (error) {\n      devServeLog(colors.redBright(`Failed to execute batch reload: ${error}`));\n    }\n  }\n\n  /**\n   * The boot-time file in this batch that can only be applied by restarting,\n   * or `undefined` when the batch is ordinary application code.\n   */\n  private findRestartTrigger(batch: Batch): string | undefined {\n    if (batch.changed.includes(\"warlock.config.ts\")) {\n      return \"warlock.config.ts\";\n    }\n\n    return [...batch.added, ...batch.changed].find(isEnvPath) ?? batch.restartTriggers?.[0];\n  }\n\n  /**\n   * Restart so a changed boot-time file actually takes effect.\n   *\n   * Opt out with `devServer.restartOnConfigChange: false` and the old\n   * behaviour returns: a warning telling you to restart yourself. If the\n   * restart can't be performed at all (no supervisor, a shutdown that threw),\n   * `restartDevServer` reports it and we fall back to the same warning rather\n   * than leaving the server running against config it isn't using.\n   */\n  private async restartForConfigChange(file: string): Promise<void> {\n    const devServerConfig = await warlockConfigManager.get(\"devServer\");\n\n    if (devServerConfig?.restartOnConfigChange === false) {\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\n      return;\n    }\n\n    devLogInfo(`${file} changed — restarting to apply.`);\n\n    const restarted = await restartDevServer(this);\n\n    if (!restarted) {\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\n    }\n  }\n\n  public async shutdown(): Promise<void> {\n    // Always hand the terminal back, even on a repeat/no-op shutdown — a\n    // process that exits while stdin is still in raw mode leaves the user's\n    // shell without line editing or Ctrl+C.\n    devServerShortcuts.release();\n\n    if (!this.running && !this.connectorsStarted) return;\n    devServeLog(colors.redBright(\"Shutting down Development Server...\"));\n    this.running = false;\n    this.connectorsStarted = false;\n    await connectorsManager.shutdown();\n    devServeLog(colors.greenBright(\"Development Server stopped\"));\n  }\n\n  public isRunning(): boolean {\n    return this.running;\n  }\n}\n\nfunction isEnvPath(path: string): boolean {\n  const basename = path.split(\"/\").pop() ?? path;\n  return basename === \".env\" || basename.startsWith(\".env.\");\n}\n"],"mappings":"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"}
+{"version":3,"file":"development-server.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport events from \"@mongez/events\";\nimport { fileExistsAsync, unlinkAsync } from \"@warlock.js/fs\";\nimport { Application } from \"../application\";\nimport { connectorsManager } from \"../connectors/connectors-manager\";\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\nimport { warlockConfigManager } from \"../warlock-config\";\nimport { registerDevelopmentOpenApiProvider } from \"../openapi/development-openapi-provider\";\nimport { BootPreconditionError } from \"./boot-precondition-error\";\nimport { buildDevelopmentOpenApiDocument } from \"./build-development-openapi-document\";\nimport { DevAgentTooling, resolveDevMcpOptions } from \"./dev-agent-tooling\";\nimport { devLogInfo, devLogSection, devLogWarn, devServeLog } from \"./dev-logger\";\nimport { filesOrchestrator } from \"./files-orchestrator\";\nimport { MANIFEST_PATH } from \"./flags\";\nimport type { IncomingReloadTimings } from \"./layer-executor\";\nimport { LayerExecutor } from \"./layer-executor\";\nimport { printReadyBlock } from \"./ready-block\";\nimport { registerInstalledDevtools } from \"./register-installed-devtools\";\nimport { restartDevServer } from \"./restart-dev-server\";\nimport { collectDevelopmentApiRoutes } from \"./collect-development-api-routes\";\nimport { publishCurrentRouteTypes } from \"./route-types-publisher\";\nimport { devServerShortcuts } from \"./shortcuts\";\nimport type { StartDevServerOptions } from \"./start-development-server\";\nimport { typeGenerator } from \"./type-generator\";\n\ntype Batch = {\n  added: string[];\n  changed: string[];\n  deleted: string[];\n  /** Non-code `watch.include` files that changed; only a restart applies them. */\n  restartTriggers?: string[];\n  timings?: IncomingReloadTimings;\n};\n\n/**\n * Top-level coordinator for `warlock dev`. Wires the file orchestrator, the\n * connectors, and the layer executor together, and listens for the watcher's\n * batched events to drive HMR.\n */\nexport class DevelopmentServer {\n  private layerExecutor?: LayerExecutor;\n  private running = false;\n\n  /** Set once boot begins, so a failed boot still closes connectors that already started. */\n  private connectorsStarted = false;\n  private readonly options: StartDevServerOptions;\n\n  /** `.warlock/dev-server.json`, the AGENTS.md refresher and `--mcp`. */\n  private readonly agentTooling = new DevAgentTooling();\n\n  public constructor(options: StartDevServerOptions = {}) {\n    this.options = options;\n    devLogSection(\"Starting Development Server...\");\n  }\n\n  public async start(): Promise<void> {\n    try {\n      this.connectorsStarted = true;\n      const startedAt = performance.now();\n\n      // Devtools reads this through the root barrel, which must not reach dev-server code.\n      registerDevelopmentOpenApiProvider(buildDevelopmentOpenApiDocument);\n\n      // --fresh deletes the manifest so reconciliation re-parses every file\n      // from disk. Transpile caching is owned by the loader hook (in-memory).\n      if (this.options.fresh && (await fileExistsAsync(MANIFEST_PATH))) {\n        await unlinkAsync(MANIFEST_PATH);\n        devServeLog(colors.cyanBright(\"Cleared manifest (--fresh)\"));\n      }\n\n      await filesOrchestrator.init();\n      await filesOrchestrator.initializeAll();\n      await filesOrchestrator.watchFiles();\n\n      filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\n\n      this.setupEventListeners();\n\n      // Decorator-driven registries (models, etc.) must be populated before\n      // routes/services can resolve symbols by name.\n      await this.autoDiscoverFiles();\n\n      await filesOrchestrator.moduleLoader.loadAll();\n\n      // A rejecting validator (Application.onValidateBoot) must abort boot\n      // before late-phase connectors bind a port — this is what makes the\n      // hook actually prevent serving instead of merely being defined.\n      //\n      // Wrapped and re-thrown as a BootPreconditionError: a rejected\n      // validator is, by definition, a precondition whose cause cannot\n      // change because the worker tried again — the supervisor must not\n      // restart into the same rejection. See boot-precondition-error.ts.\n      try {\n        await Application.runStartupValidators();\n      } catch (error) {\n        throw new BootPreconditionError((error as Error).message, { cause: error });\n      }\n\n      // `@warlock.js/devtools` is a dev dependency the config never names;\n      // when installed it joins the late phase here, and only here.\n      await registerInstalledDevtools();\n\n      // Late-phase connectors (http, socket) bind after app code has\n      // registered routes/listeners.\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\n\n      // Web installs its page table from its late connector. Generate only\n      // after that installation so `href()` and the declaration table agree.\n      await publishCurrentRouteTypes(process.cwd(), await collectDevelopmentApiRoutes());\n\n      this.layerExecutor = new LayerExecutor(\n        filesOrchestrator.getDependencyGraph(),\n        filesOrchestrator.specialFilesCollector,\n        filesOrchestrator.moduleLoader,\n        (absolutePath) => filesOrchestrator.bumpVersion(absolutePath),\n        () => filesOrchestrator.flushVersionBumps(),\n      );\n\n      this.running = true;\n\n      const duration = performance.now() - startedAt;\n\n      // App modules are loaded and both connector phases are active — signal a\n      // complete boot so `Application.onceBooted(...)` listeners fire.\n      Application.markBooted({\n        environment: Application.environment,\n        runtimeStrategy: Application.runtimeStrategy,\n        bootDurationMs: duration,\n      });\n\n      // ONE block, AFTER the boot it summarises, replacing the scattered\n      // \"N route(s) registered\" / \"Server ready at …\" / \"ready in …\" lines that\n      // used to arrive in completion order. Warnings logged during boot sit\n      // above it and stay there — see `ready-block.ts`.\n      printReadyBlock(duration);\n\n      // Tell the supervisor (when there is one) that boot completed, so its\n      // healthy-uptime window counts from here rather than from spawn.\n      process.send?.(\"warlock:booted\");\n\n      // Precedence: explicit CLI option > devServer.* config > default.\n      const devServerConfig = await warlockConfigManager.get(\"devServer\");\n      const generateTypings =\n        this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;\n      const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;\n\n      await this.agentTooling.start({\n        agentsMd: devServerConfig?.agentsMd !== false,\n        mcp: resolveDevMcpOptions(this.options.mcp, devServerConfig?.mcp),\n      });\n\n      if (generateTypings) await typeGenerator.executeGenerateAllCommand();\n\n      if (healthCheckers) {\n        filesOrchestrator.startCheckingHealth(healthCheckers === true ? undefined : healthCheckers);\n      }\n    } catch (error) {\n      devServeLog(colors.redBright(`Failed to start Development Server: ${error}`));\n      await this.shutdown();\n      throw error;\n    }\n  }\n\n  /**\n   * Eagerly import files whose decorators populate global registries so any\n   * symbol-by-name resolution later in boot finds them.\n   */\n  private async autoDiscoverFiles(): Promise<void> {\n    const discoveryTypes = [\"model\"] as const;\n    for (const file of filesOrchestrator.files.values()) {\n      if (file.type && (discoveryTypes as readonly string[]).includes(file.type)) {\n        await filesOrchestrator.moduleLoader.loadModule(file, file.type);\n      }\n    }\n  }\n\n  /** Tail of the batch-reload chain (see `setupEventListeners`). */\n  private reloadQueue: Promise<void> = Promise.resolve();\n\n  private setupEventListeners(): void {\n    // Reloads run one at a time: a second batch waits for the first to finish\n    // so route re-registration and connector restarts never interleave.\n    events.on(\"dev-server:batch-complete\", (batch: Batch) => {\n      this.reloadQueue = this.reloadQueue\n        .then(() => this.handleBatchComplete(batch))\n        .catch((error) => devServeLog(colors.redBright(`Batch reload failed: ${error}`)));\n    });\n  }\n\n  private async handleBatchComplete(batch: Batch): Promise<void> {\n    if (!this.running || !this.layerExecutor) return;\n\n    // warlock.config.ts holds settings read at boot (CLI commands, build\n    // options, watch patterns, scheduled jobs) and .env feeds every config\n    // that reads it. Neither can be hot-reloaded without leaving running\n    // services configured with stale values, so the only honest response is\n    // a full restart.\n    const restartTrigger = this.findRestartTrigger(batch);\n\n    if (restartTrigger) {\n      // On success this never comes back — the process exits and the\n      // supervisor replaces it. Reaching the next line means the restart was\n      // declined by config or wasn't possible, so we fall through and still\n      // hot-reload whatever ordinary code shared the batch.\n      await this.restartForConfigChange(restartTrigger);\n    }\n\n    // No-op saves (an editor that fsyncs without a content write) are already\n    // filtered upstream by the file hash in FileEventHandler, so batch.changed\n    // only contains genuinely-changed paths by the time it reaches here.\n\n    const total = batch.added.length + batch.changed.length + batch.deleted.length;\n    if (total === 0) return;\n\n    // Boot-time files still ride along in `changed` when a restart was\n    // declined (`restartOnConfigChange: false`) or wasn't possible — they are\n    // never hot-reloaded, so keep them out of the reload set either way.\n    const codeFiles = [...batch.added, ...batch.changed].filter(\n      (p) => !isEnvPath(p) && p !== \"warlock.config.ts\" && !batch.restartTriggers?.includes(p),\n    );\n\n    try {\n      await this.layerExecutor.executeBatchReload(\n        codeFiles,\n        filesOrchestrator.getFiles(),\n        batch.deleted,\n        batch.changed,\n        batch.timings,\n      );\n\n      // `executeBatchReload` includes route re-imports and affected connector\n      // restarts. Publishing earlier could freeze a partial page/API view.\n      // This also refreshes deletion-only batches after their cleanup/restart.\n      await publishCurrentRouteTypes(process.cwd(), await collectDevelopmentApiRoutes());\n\n      typeGenerator.executeTypingsGenerator([...batch.added, ...batch.changed, ...batch.deleted]);\n\n      this.agentTooling.afterReload();\n\n      filesOrchestrator.checkHealth(batch);\n    } catch (error) {\n      devServeLog(colors.redBright(`Failed to execute batch reload: ${error}`));\n    }\n  }\n\n  /**\n   * The boot-time file in this batch that can only be applied by restarting,\n   * or `undefined` when the batch is ordinary application code.\n   */\n  private findRestartTrigger(batch: Batch): string | undefined {\n    if (batch.changed.includes(\"warlock.config.ts\")) {\n      return \"warlock.config.ts\";\n    }\n\n    return [...batch.added, ...batch.changed].find(isEnvPath) ?? batch.restartTriggers?.[0];\n  }\n\n  /**\n   * Restart so a changed boot-time file actually takes effect.\n   *\n   * Opt out with `devServer.restartOnConfigChange: false` and the old\n   * behaviour returns: a warning telling you to restart yourself. If the\n   * restart can't be performed at all (no supervisor, a shutdown that threw),\n   * `restartDevServer` reports it and we fall back to the same warning rather\n   * than leaving the server running against config it isn't using.\n   */\n  private async restartForConfigChange(file: string): Promise<void> {\n    const devServerConfig = await warlockConfigManager.get(\"devServer\");\n\n    if (devServerConfig?.restartOnConfigChange === false) {\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\n      return;\n    }\n\n    devLogInfo(`${file} changed — restarting to apply.`);\n\n    const restarted = await restartDevServer(this);\n\n    if (!restarted) {\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\n    }\n  }\n\n  public async shutdown(): Promise<void> {\n    // Always hand the terminal back, even on a repeat/no-op shutdown — a\n    // process that exits while stdin is still in raw mode leaves the user's\n    // shell without line editing or Ctrl+C.\n    devServerShortcuts.release();\n\n    if (!this.running && !this.connectorsStarted) return;\n    devServeLog(colors.redBright(\"Shutting down Development Server...\"));\n    this.running = false;\n    this.connectorsStarted = false;\n    await this.agentTooling.shutdown();\n    await connectorsManager.shutdown();\n    devServeLog(colors.greenBright(\"Development Server stopped\"));\n  }\n\n  public isRunning(): boolean {\n    return this.running;\n  }\n}\n\nfunction isEnvPath(path: string): boolean {\n  const basename = path.split(\"/\").pop() ?? path;\n  return basename === \".env\" || basename.startsWith(\".env.\");\n}\n"],"mappings":"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"}

package/esm/dev-server/extract-translation-keys.mjs

@@ -1,4 +1,4 @@
-import ts from "typescript";
+import { expressionOf, forEachChild, isCallExpression, isIdentifier, isObjectLiteralExpression, isPropertyAssignment, isStringLiteral, keyName, valueText } from "../tooling/syntax/ast.mjs";
 
 //#region ../../packages/core/src/dev-server/extract-translation-keys.ts
 /**
@@ -21,46 +21,45 @@ function extractTranslationKeys(sourceFile) {
 	const keys = /* @__PURE__ */ new Set();
 	const visit = (node) => {
 		if (isGroupedTranslationsCall(node)) collectFromCall(node, keys);
-		ts.forEachChild(node, visit);
+		forEachChild(node, visit);
 	};
-	ts.forEachChild(sourceFile, visit);
+	forEachChild(sourceFile, visit);
 	return Array.from(keys).sort();
 }
 function isGroupedTranslationsCall(node) {
-	return ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "groupedTranslations";
+	return isCallExpression(node) && isIdentifier(expressionOf(node)) && valueText(expressionOf(node)) === "groupedTranslations";
 }
 function collectFromCall(call, keys) {
 	const [first, second] = call.arguments;
 	if (first === void 0) return;
 	if (second !== void 0) {
-		if (ts.isStringLiteral(first) && ts.isObjectLiteralExpression(second)) collectLeaves(second, first.text, keys);
+		if (isStringLiteral(first) && isObjectLiteralExpression(second)) collectLeaves(second, valueText(first), keys);
 		return;
 	}
-	if (ts.isObjectLiteralExpression(first)) for (const property of first.properties) {
-		if (!ts.isPropertyAssignment(property)) continue;
-		const groupName = getPropertyName(property.name);
+	if (isObjectLiteralExpression(first)) for (const property of first.properties) {
+		if (!isPropertyAssignment(property)) continue;
+		const groupName = getPropertyName(property.key);
 		if (groupName === void 0) continue;
-		if (ts.isObjectLiteralExpression(property.initializer)) collectLeaves(property.initializer, groupName, keys);
+		if (isObjectLiteralExpression(property.value)) collectLeaves(property.value, groupName, keys);
 	}
 }
 function collectLeaves(object, prefix, keys) {
 	for (const property of object.properties) {
-		if (!ts.isPropertyAssignment(property)) continue;
-		const key = getPropertyName(property.name);
+		if (!isPropertyAssignment(property)) continue;
+		const key = getPropertyName(property.key);
 		if (key === void 0) continue;
-		if (!ts.isObjectLiteralExpression(property.initializer)) continue;
+		if (!isObjectLiteralExpression(property.value)) continue;
 		const path = `${prefix}.${key}`;
-		if (isLeaf(property.initializer)) keys.add(path);
-		else collectLeaves(property.initializer, path, keys);
+		if (isLeaf(property.value)) keys.add(path);
+		else collectLeaves(property.value, path, keys);
 	}
 }
 /** A locale map (`{ en: "...", ar: "..." }`) has no object-literal children. */
 function isLeaf(object) {
-	return !object.properties.some((property) => ts.isPropertyAssignment(property) && ts.isObjectLiteralExpression(property.initializer));
+	return !object.properties.some((property) => isPropertyAssignment(property) && isObjectLiteralExpression(property.value));
 }
 function getPropertyName(name) {
-	if (name === void 0) return;
-	if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) return name.text;
+	return keyName(name);
 }
 
 //#endregion

package/esm/dev-server/extract-translation-keys.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"extract-translation-keys.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/extract-translation-keys.ts"],"sourcesContent":["import ts from \"typescript\";\n\n/**\n * Extract literal lookup keys registered through `groupedTranslations` calls,\n * statically, without executing the source.\n *\n * Handles both call shapes:\n * - Named-group: `groupedTranslations(\"site\", { home: { en, ar } })`\n * - Object: `groupedTranslations({ site: { home: { en, ar } } })`\n *\n * Groups nest to any depth (`{ detail: { title: { en, ar } } }` yields\n * `products.detail.title`) — an object is a leaf once none of its own\n * properties hold a further object literal.\n *\n * A dynamic group name, dictionary, or property key (an identifier, spread,\n * or computed name instead of a literal) cannot be resolved statically and is\n * silently skipped; such keys must be documented by the app author instead.\n */\nexport function extractTranslationKeys(sourceFile: ts.SourceFile): string[] {\n  const keys = new Set<string>();\n\n  const visit = (node: ts.Node): void => {\n    if (isGroupedTranslationsCall(node)) {\n      collectFromCall(node, keys);\n    }\n\n    ts.forEachChild(node, visit);\n  };\n\n  ts.forEachChild(sourceFile, visit);\n\n  return Array.from(keys).sort();\n}\n\nfunction isGroupedTranslationsCall(node: ts.Node): node is ts.CallExpression {\n  return (\n    ts.isCallExpression(node) &&\n    ts.isIdentifier(node.expression) &&\n    node.expression.text === \"groupedTranslations\"\n  );\n}\n\nfunction collectFromCall(call: ts.CallExpression, keys: Set<string>): void {\n  const [first, second] = call.arguments;\n\n  if (first === undefined) return;\n\n  if (second !== undefined) {\n    if (ts.isStringLiteral(first) && ts.isObjectLiteralExpression(second)) {\n      collectLeaves(second, first.text, keys);\n    }\n    return;\n  }\n\n  if (ts.isObjectLiteralExpression(first)) {\n    for (const property of first.properties) {\n      if (!ts.isPropertyAssignment(property)) continue;\n\n      const groupName = getPropertyName(property.name);\n      if (groupName === undefined) continue;\n\n      if (ts.isObjectLiteralExpression(property.initializer)) {\n        collectLeaves(property.initializer, groupName, keys);\n      }\n    }\n  }\n}\n\nfunction collectLeaves(\n  object: ts.ObjectLiteralExpression,\n  prefix: string,\n  keys: Set<string>,\n): void {\n  for (const property of object.properties) {\n    if (!ts.isPropertyAssignment(property)) continue;\n\n    const key = getPropertyName(property.name);\n    if (key === undefined) continue;\n\n    if (!ts.isObjectLiteralExpression(property.initializer)) continue;\n\n    const path = `${prefix}.${key}`;\n\n    if (isLeaf(property.initializer)) {\n      keys.add(path);\n    } else {\n      collectLeaves(property.initializer, path, keys);\n    }\n  }\n}\n\n/** A locale map (`{ en: \"...\", ar: \"...\" }`) has no object-literal children. */\nfunction isLeaf(object: ts.ObjectLiteralExpression): boolean {\n  return !object.properties.some(\n    (property) =>\n      ts.isPropertyAssignment(property) && ts.isObjectLiteralExpression(property.initializer),\n  );\n}\n\nfunction getPropertyName(name: ts.PropertyName | undefined): string | undefined {\n  if (name === undefined) {\n    return undefined;\n  }\n\n  if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) {\n    return name.text;\n  }\n\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,uBAAuB,YAAqC;CAC1E,MAAM,uBAAO,IAAI,IAAY;CAE7B,MAAM,SAAS,SAAwB;EACrC,IAAI,0BAA0B,IAAI,GAChC,gBAAgB,MAAM,IAAI;EAG5B,GAAG,aAAa,MAAM,KAAK;CAC7B;CAEA,GAAG,aAAa,YAAY,KAAK;CAEjC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,KAAK;AAC/B;AAEA,SAAS,0BAA0B,MAA0C;CAC3E,OACE,GAAG,iBAAiB,IAAI,KACxB,GAAG,aAAa,KAAK,UAAU,KAC/B,KAAK,WAAW,SAAS;AAE7B;AAEA,SAAS,gBAAgB,MAAyB,MAAyB;CACzE,MAAM,CAAC,OAAO,UAAU,KAAK;CAE7B,IAAI,UAAU,QAAW;CAEzB,IAAI,WAAW,QAAW;EACxB,IAAI,GAAG,gBAAgB,KAAK,KAAK,GAAG,0BAA0B,MAAM,GAClE,cAAc,QAAQ,MAAM,MAAM,IAAI;EAExC;CACF;CAEA,IAAI,GAAG,0BAA0B,KAAK,GACpC,KAAK,MAAM,YAAY,MAAM,YAAY;EACvC,IAAI,CAAC,GAAG,qBAAqB,QAAQ,GAAG;EAExC,MAAM,YAAY,gBAAgB,SAAS,IAAI;EAC/C,IAAI,cAAc,QAAW;EAE7B,IAAI,GAAG,0BAA0B,SAAS,WAAW,GACnD,cAAc,SAAS,aAAa,WAAW,IAAI;CAEvD;AAEJ;AAEA,SAAS,cACP,QACA,QACA,MACM;CACN,KAAK,MAAM,YAAY,OAAO,YAAY;EACxC,IAAI,CAAC,GAAG,qBAAqB,QAAQ,GAAG;EAExC,MAAM,MAAM,gBAAgB,SAAS,IAAI;EACzC,IAAI,QAAQ,QAAW;EAEvB,IAAI,CAAC,GAAG,0BAA0B,SAAS,WAAW,GAAG;EAEzD,MAAM,OAAO,GAAG,OAAO,GAAG;EAE1B,IAAI,OAAO,SAAS,WAAW,GAC7B,KAAK,IAAI,IAAI;OAEb,cAAc,SAAS,aAAa,MAAM,IAAI;CAElD;AACF;;AAGA,SAAS,OAAO,QAA6C;CAC3D,OAAO,CAAC,OAAO,WAAW,MACvB,aACC,GAAG,qBAAqB,QAAQ,KAAK,GAAG,0BAA0B,SAAS,WAAW,CAC1F;AACF;AAEA,SAAS,gBAAgB,MAAuD;CAC9E,IAAI,SAAS,QACX;CAGF,IAAI,GAAG,aAAa,IAAI,KAAK,GAAG,gBAAgB,IAAI,KAAK,GAAG,iBAAiB,IAAI,GAC/E,OAAO,KAAK;AAIhB"}
+{"version":3,"file":"extract-translation-keys.mjs","names":["ast.isCallExpression","ast.isIdentifier","ast.expressionOf","ast.valueText","ast.isStringLiteral","ast.isObjectLiteralExpression","ast.isPropertyAssignment","ast.keyName"],"sources":["../../../../../../../../packages/core/src/dev-server/extract-translation-keys.ts"],"sourcesContent":["import * as ast from \"../tooling/syntax/ast\";\n\n/**\n * Extract literal lookup keys registered through `groupedTranslations` calls,\n * statically, without executing the source.\n *\n * Handles both call shapes:\n * - Named-group: `groupedTranslations(\"site\", { home: { en, ar } })`\n * - Object: `groupedTranslations({ site: { home: { en, ar } } })`\n *\n * Groups nest to any depth (`{ detail: { title: { en, ar } } }` yields\n * `products.detail.title`) — an object is a leaf once none of its own\n * properties hold a further object literal.\n *\n * A dynamic group name, dictionary, or property key (an identifier, spread,\n * or computed name instead of a literal) cannot be resolved statically and is\n * silently skipped; such keys must be documented by the app author instead.\n */\nexport function extractTranslationKeys(sourceFile: ast.SourceFile): string[] {\n  const keys = new Set<string>();\n\n  const visit = (node: ast.Node): void => {\n    if (isGroupedTranslationsCall(node)) {\n      collectFromCall(node, keys);\n    }\n\n    ast.forEachChild(node, visit);\n  };\n\n  ast.forEachChild(sourceFile, visit);\n\n  return Array.from(keys).sort();\n}\n\nfunction isGroupedTranslationsCall(node: ast.Node): node is ast.CallExpression {\n  return (\n    ast.isCallExpression(node) &&\n    ast.isIdentifier(ast.expressionOf(node)) &&\n    ast.valueText(ast.expressionOf(node)) === \"groupedTranslations\"\n  );\n}\n\nfunction collectFromCall(call: ast.CallExpression, keys: Set<string>): void {\n  const [first, second] = call.arguments;\n\n  if (first === undefined) return;\n\n  if (second !== undefined) {\n    if (ast.isStringLiteral(first) && ast.isObjectLiteralExpression(second)) {\n      collectLeaves(second, ast.valueText(first), keys);\n    }\n    return;\n  }\n\n  if (ast.isObjectLiteralExpression(first)) {\n    for (const property of first.properties) {\n      if (!ast.isPropertyAssignment(property)) continue;\n\n      const groupName = getPropertyName(property.key);\n      if (groupName === undefined) continue;\n\n      if (ast.isObjectLiteralExpression(property.value)) {\n        collectLeaves(property.value, groupName, keys);\n      }\n    }\n  }\n}\n\nfunction collectLeaves(object: ast.ObjectExpression, prefix: string, keys: Set<string>): void {\n  for (const property of object.properties) {\n    if (!ast.isPropertyAssignment(property)) continue;\n\n    const key = getPropertyName(property.key);\n    if (key === undefined) continue;\n\n    if (!ast.isObjectLiteralExpression(property.value)) continue;\n\n    const path = `${prefix}.${key}`;\n\n    if (isLeaf(property.value)) {\n      keys.add(path);\n    } else {\n      collectLeaves(property.value, path, keys);\n    }\n  }\n}\n\n/** A locale map (`{ en: \"...\", ar: \"...\" }`) has no object-literal children. */\nfunction isLeaf(object: ast.ObjectExpression): boolean {\n  return !object.properties.some(\n    (property) =>\n      ast.isPropertyAssignment(property) && ast.isObjectLiteralExpression(property.value),\n  );\n}\n\nfunction getPropertyName(name: ast.Node | undefined): string | undefined {\n  return ast.keyName(name);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,uBAAuB,YAAsC;CAC3E,MAAM,uBAAO,IAAI,IAAY;CAE7B,MAAM,SAAS,SAAyB;EACtC,IAAI,0BAA0B,IAAI,GAChC,gBAAgB,MAAM,IAAI;EAG5B,aAAiB,MAAM,KAAK;CAC9B;CAEA,aAAiB,YAAY,KAAK;CAElC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,KAAK;AAC/B;AAEA,SAAS,0BAA0B,MAA4C;CAC7E,OACEA,iBAAqB,IAAI,KACzBC,aAAiBC,aAAiB,IAAI,CAAC,KACvCC,UAAcD,aAAiB,IAAI,CAAC,MAAM;AAE9C;AAEA,SAAS,gBAAgB,MAA0B,MAAyB;CAC1E,MAAM,CAAC,OAAO,UAAU,KAAK;CAE7B,IAAI,UAAU,QAAW;CAEzB,IAAI,WAAW,QAAW;EACxB,IAAIE,gBAAoB,KAAK,KAAKC,0BAA8B,MAAM,GACpE,cAAc,QAAQF,UAAc,KAAK,GAAG,IAAI;EAElD;CACF;CAEA,IAAIE,0BAA8B,KAAK,GACrC,KAAK,MAAM,YAAY,MAAM,YAAY;EACvC,IAAI,CAACC,qBAAyB,QAAQ,GAAG;EAEzC,MAAM,YAAY,gBAAgB,SAAS,GAAG;EAC9C,IAAI,cAAc,QAAW;EAE7B,IAAID,0BAA8B,SAAS,KAAK,GAC9C,cAAc,SAAS,OAAO,WAAW,IAAI;CAEjD;AAEJ;AAEA,SAAS,cAAc,QAA8B,QAAgB,MAAyB;CAC5F,KAAK,MAAM,YAAY,OAAO,YAAY;EACxC,IAAI,CAACC,qBAAyB,QAAQ,GAAG;EAEzC,MAAM,MAAM,gBAAgB,SAAS,GAAG;EACxC,IAAI,QAAQ,QAAW;EAEvB,IAAI,CAACD,0BAA8B,SAAS,KAAK,GAAG;EAEpD,MAAM,OAAO,GAAG,OAAO,GAAG;EAE1B,IAAI,OAAO,SAAS,KAAK,GACvB,KAAK,IAAI,IAAI;OAEb,cAAc,SAAS,OAAO,MAAM,IAAI;CAE5C;AACF;;AAGA,SAAS,OAAO,QAAuC;CACrD,OAAO,CAAC,OAAO,WAAW,MACvB,aACCC,qBAAyB,QAAQ,KAAKD,0BAA8B,SAAS,KAAK,CACtF;AACF;AAEA,SAAS,gBAAgB,MAAgD;CACvE,OAAOE,QAAY,IAAI;AACzB"}

package/esm/dev-server/file-manager.d.mts

@@ -1,8 +1,7 @@
 import { FileManifest, FileState, FileType } from "./types.mjs";
 import { FileOperations } from "./file-operations.mjs";
-
 //#region ../../packages/core/src/dev-server/file-manager.d.ts
-type CleanupFunction = () => void;
+export type CleanupFunction = () => void;
 /**
  * FileManager — per-file metadata for the dependency graph.
  *
@@ -11,7 +10,7 @@ type CleanupFunction = () => void;
  * and parse its imports. Its job is keeping the metadata that the
  * orchestrator needs to invalidate dependents on change.
  */
-declare class FileManager {
+export declare class FileManager {
   readonly absolutePath: string;
   files: Map<string, FileManager>;
   fileOperations: FileOperations;
@@ -59,9 +58,7 @@ declare class FileManager {
    * @param force - re-parse even when the hash matches.
    * @returns true if the file was (re)parsed.
    */
-  process({
-    force
-  }?: {
+  process({ force }?: {
     force?: boolean;
   }): Promise<boolean>;
   /**
@@ -81,5 +78,4 @@ declare class FileManager {
   toManifest(): FileManifest;
 }
 //#endregion
-export { FileManager };
 //# sourceMappingURL=file-manager.d.mts.map

package/esm/dev-server/file-manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"file-manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/file-manager.ts"],"mappings":";;;;KASY,eAAA;;AAAZ;;;;AAA2B;AAyB3B;;cAAa,WAAA;EAAA,SAgCO,YAAA;EACT,KAAA,EAAO,GAAA,SAAY,WAAA;EACnB,cAAA,EAAgB,cAAA;EAjClB,YAAA;EACA,YAAA;EACA,IAAA;EACA,MAAA;EAiBM;EAdN,YAAA,EAAY,GAAA;EAsBL;;;;EAhBP,oBAAA,EAAoB,GAAA;EAwBkB;EArBtC,SAAA,EAAS,GAAA;EAmCiB;EAhC1B,UAAA,EAAU,GAAA;EAEV,IAAA,EAAM,QAAA;EAwDsD;EArD5D,OAAA,EAAS,eAAA;EAoIuC;EAjIhD,cAAA;EAEA,KAAA,EAAO,SAAA;cAGI,YAAA,UACT,KAAA,EAAO,GAAA,SAAY,WAAA,GACnB,cAAA,EAAgB,cAAA;EAGlB,UAAA,CAAW,OAAA,EAAS,eAAA,GAAkB,eAAA;EAMtC,YAAA;EAXW;;;;EAmBL,IAAA,CAAK,YAAA,GAAe,OAAA,CAAQ,YAAA,IAAgB,OAAA;EAjBhC;;;;;;;;;;;;;;;EA2CZ,OAAA;IAAU;EAAA;IAAmB,KAAA;EAAA,IAAyB,OAAA;EAhD5D;;;;;;EAAA,UA+FS,qBAAA,IAAyB,OAAA;EA1FhB;;;;;EAAA,UA0HT,gBAAA,CAAiB,YAAA,EAAc,OAAA,CAAQ,YAAA,IAAgB,OAAA;EAAA,UA6B7D,cAAA;EAuBH,UAAA,IAAc,YAAA;AAAA"}
+{"version":3,"file":"file-manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/file-manager.ts"],"mappings":";;;YASY;;;;;;;;;qBAyBC;WAgCO;EACT,OAAO,YAAY;EACnB,gBAAgB;EAjClB;EACA;EACA;EACA;;EAGA,cAAY;;;;;EAMZ,sBAAoB;;EAGpB,WAAS;;EAGT,YAAU;EAEV,MAAM;;EAGN,SAAS;;EAGT;EAEA,OAAO;EAEd,YACkB,sBACT,OAAO,YAAY,cACnB,gBAAgB;EAGlB,WAAW,SAAS,kBAAkB;EAMtC;;;;;EAQM,KAAK,eAAe,QAAQ,gBAAgB;;;;;;;;;;;;;;;;EA0B5C,UAAU;IAAmB;MAAyB;;;;;;;YA+CnD,yBAAyB;;;;;;YAgCzB,iBAAiB,cAAc,QAAQ,gBAAgB;YA6B7D;EAuBH,cAAc"}

package/esm/dev-server/file-operations.d.mts

@@ -2,7 +2,6 @@ import { DependencyGraph } from "./dependency-graph.mjs";
 import { ManifestManager } from "./manifest-manager.mjs";
 import { SpecialFilesCollector } from "./special-files-collector.mjs";
 import { FileManager } from "./file-manager.mjs";
-
 //#region ../../packages/core/src/dev-server/file-operations.d.ts
 /**
  * FileOperations — add/update/delete lifecycle for a single file.
@@ -10,7 +9,7 @@ import { FileManager } from "./file-manager.mjs";
  * Coordinates the dependency graph, manifest, and special-files collector
  * so the orchestrator and event handler can stay declarative.
  */
-declare class FileOperations {
+export declare class FileOperations {
   private readonly files;
   private readonly dependencyGraph;
   private readonly manifest;
@@ -39,5 +38,4 @@ declare class FileOperations {
   syncFilesToManifest(): void;
 }
 //#endregion
-export { FileOperations };
 //# sourceMappingURL=file-operations.d.mts.map