@effect-app/cli 1.23.0 → 1.23.2

package/src/index.ts

@@ -1,241 +1,675 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
-/* eslint-disable @typescript-eslint/no-unsafe-argument */
-import cp from "child_process"
-import fs from "fs"
-import w from "node-watch"
-import path from "path"
-import readline from "readline/promises"
-import { sync } from "./sync.js"
-
-function askQuestion(query: string) {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  })
-
-  return rl.question(query)
-}
-
-const _cmd = process.argv[2]
-const supportedCommands = [
-  "watch",
-  "index",
-  "index-multi",
-  "packagejson",
-  "packagejson-target",
-  "packagejson-packages",
-  "link",
-  "unlink",
-  "sync"
-] as const
-if (
-  !supportedCommands.includes(_cmd as any)
-) {
-  console.log("unknown command: ", _cmd, "supported commands: ", supportedCommands.join(", "))
-  process.exit(1)
-}
-
-const cmd = _cmd as typeof supportedCommands[number]
-
-const debug = process.argv.includes("--debug")
-
-function touch(path: string) {
-  const time = new Date()
-  try {
-    fs.utimesSync(path, time, time)
-  } catch (err) {
-    fs.closeSync(fs.openSync(path, "w"))
-  }
-}
-
-function* monitorIndexes_(path: string) {
-  yield monitorChildIndexes(path)
-  const indexFile = path + "/index.ts"
-  if (fs.existsSync(indexFile)) {
-    yield monitorRootIndexes(path, indexFile)
-  }
-}
-
-function monitorIndexes(path: string) {
-  return [...monitorIndexes_(path)]
-}
-
-function monitorChildIndexes(path: string) {
-  return w.default(path, { recursive: true }, (evt, path) => {
-    const pathParts = path.split("/")
-    const isController = pathParts[pathParts.length - 1]?.toLowerCase().includes(".controllers.")
-    if (!isController) return
-
-    let i = 1
-    const r = pathParts.toReversed()
-    while (i < r.length) {
-      const files = ["controllers.ts", "routes.ts"]
-        .map((f) => [...pathParts.slice(0, pathParts.length - i), f].join("/"))
-        .filter((f) => fs.existsSync(f))
-      if (files.length) {
+/* eslint-disable no-constant-binary-expression */
+/* eslint-disable no-empty-pattern */
+// import necessary modules from the libraries
+import { Args, Command, Options, Prompt } from "@effect/cli"
+import { Command as NodeCommand, FileSystem, Path } from "@effect/platform"
+import { NodeContext, NodeRuntime } from "@effect/platform-node"
+import { Effect, identity, Stream } from "effect"
+import { ExtractExportMappingsService } from "./extract.js"
+import { packages } from "./shared.js"
+
+Effect
+  .fn("effa-cli")(function*() {
+    const fs = yield* FileSystem.FileSystem
+    const path = yield* Path.Path
+    const extractExportMappings = yield* ExtractExportMappingsService
+
+    /**
+     * Executes a shell command using Node.js Command API with inherited stdio streams.
+     * The command is run through the system shell (/bin/sh) for proper command parsing.
+     *
+     * @param cmd - The shell command to execute
+     * @param cwd - Optional working directory to execute the command in
+     * @returns An Effect that succeeds with the exit code or fails with a PlatformError
+     */
+    const runNodeCommand = (cmd: string, cwd?: string) =>
+      NodeCommand
+        .make("sh", "-c", cmd)
+        .pipe(
+          NodeCommand.stdout("inherit"),
+          NodeCommand.stderr("inherit"),
+          cwd ? NodeCommand.workingDirectory(cwd) : identity,
+          NodeCommand.exitCode
+        )
+
+    /**
+     * Executes a bash script file using Node.js Command API with inherited stdio streams.
+     * The script file is executed directly through the shell (/bin/sh).
+     *
+     * @param file - The path to the bash script file to execute
+     * @param cwd - Optional working directory to execute the script in
+     * @returns An Effect that succeeds with the output or fails with a PlatformError
+     */
+    // const runBashFile = (file: string, cwd?: string) =>
+    //   NodeCommand
+    //     .make("sh", file)
+    //     .pipe(
+    //       NodeCommand.stdout("inherit"),
+    //       NodeCommand.stderr("inherit"),
+    //       cwd ? NodeCommand.workingDirectory(cwd) : identity,
+    //       NodeCommand.string
+    //     )
+
+    /**
+     * Creates a file if it doesn't exist or updates the access and modification times of an existing file.
+     * This is the effectful equivalent of the Unix `touch` command.
+     *
+     * @param path - The path to the file to touch
+     * @returns An Effect that succeeds with void or fails with a FileSystem error
+     */
+    const touch = Effect.fn("touch")(function*(path: string) {
+      const time = new Date()
+
+      yield* fs.utimes(path, time, time).pipe(
+        Effect.catchTag("SystemError", (err) =>
+          err.reason === "NotFound"
+            ? fs.writeFileString(path, "")
+            : Effect.fail(err))
+      )
+    })
+
+    /**
+     * Updates effect-app packages to their latest versions using npm-check-updates.
+     * Runs both at workspace root and recursively in all workspace packages.
+     */
+    const updateEffectAppPackages = Effect.fn("effa-cli.ue.updateEffectAppPackages")(function*() {
+      const filters = ["effect-app", "@effect-app/*"]
+      for (const filter of filters) {
+        yield* runNodeCommand(`pnpm exec ncu -u --filter "${filter}"`)
+        yield* runNodeCommand(`pnpm -r exec ncu -u --filter "${filter}"`)
+      }
+    })()
+
+    /**
+     * Updates Effect ecosystem packages to their latest versions using npm-check-updates.
+     * Covers core Effect packages, Effect ecosystem packages, and Effect Atom packages.
+     * Runs both at workspace root and recursively in all workspace packages.
+     */
+    const updateEffectPackages = Effect.fn("effa-cli.ue.updateEffectPackages")(function*() {
+      const effectFilters = ["effect", "@effect/*", "@effect-atom/*"]
+      for (const filter of effectFilters) {
+        yield* runNodeCommand(`pnpm exec ncu -u --filter "${filter}"`)
+        yield* runNodeCommand(`pnpm -r exec ncu -u --filter "${filter}"`)
+      }
+    })()
+
+    /**
+     * Links local effect-app packages by adding file resolutions to package.json.
+     * Updates the package.json with file: protocol paths pointing to the local effect-app-libs directory,
+     * then runs pnpm install to apply the changes.
+     *
+     * @param effectAppLibsPath - Path to the local effect-app-libs directory
+     * @returns An Effect that succeeds when linking is complete
+     */
+    const linkPackages = Effect.fnUntraced(function*(effectAppLibsPath: string) {
+      yield* Effect.log("Linking local effect-app packages...")
+
+      const packageJsonPath = "./package.json"
+      const packageJsonContent = yield* fs.readFileString(packageJsonPath)
+      const pj = JSON.parse(packageJsonContent)
+
+      const resolutions = {
+        ...pj.resolutions,
+        "@effect-app/eslint-codegen-model": "file:" + effectAppLibsPath + "/packages/eslint-codegen-model",
+        "effect-app": "file:" + effectAppLibsPath + "/packages/effect-app",
+        "@effect-app/infra": "file:" + effectAppLibsPath + "/packages/infra",
+        "@effect-app/vue": "file:" + effectAppLibsPath + "/packages/vue",
+        "@effect-app/vue-components": "file:" + effectAppLibsPath + "/packages/vue-components",
+        ...packages.reduce((acc, p) => ({ ...acc, [p]: `file:${effectAppLibsPath}/node_modules/${p}` }), {})
+      }
+
+      pj.resolutions = resolutions
+
+      yield* fs.writeFileString(packageJsonPath, JSON.stringify(pj, null, 2))
+      yield* Effect.log("Updated package.json with local file resolutions")
+
+      yield* runNodeCommand("pnpm i")
+
+      yield* Effect.log("Successfully linked local packages")
+    })
+
+    /**
+     * Unlinks local effect-app packages by removing file resolutions from package.json.
+     * Filters out all effect-app related file: protocol resolutions from package.json,
+     * then runs pnpm install to restore registry packages.
+     *
+     * @returns An Effect that succeeds when unlinking is complete
+     */
+    const unlinkPackages = Effect.fnUntraced(function*() {
+      yield* Effect.log("Unlinking local effect-app packages...")
+
+      const packageJsonPath = "./package.json"
+      const packageJsonContent = yield* fs.readFileString(packageJsonPath)
+      const pj = JSON.parse(packageJsonContent)
+
+      const filteredResolutions = Object.entries(pj.resolutions as Record<string, string>).reduce(
+        (acc, [k, v]) => {
+          if (k.startsWith("@effect-app/") || k === "effect-app" || packages.includes(k)) return acc
+          acc[k] = v
+          return acc
+        },
+        {} as Record<string, string>
+      )
+
+      pj.resolutions = filteredResolutions
+
+      yield* fs.writeFileString(packageJsonPath, JSON.stringify(pj, null, 2))
+      yield* Effect.log("Removed effect-app file resolutions from package.json")
+
+      yield* runNodeCommand("pnpm i")
+      yield* Effect.log("Successfully unlinked local packages")
+    })()
+
+    /**
+     * Monitors controller files for changes and runs eslint on related controllers.ts/routes.ts files.
+     * Watches for .controllers. files and triggers eslint fixes on parent directory's controller files.
+     *
+     * @param watchPath - The path to watch for controller changes
+     * @param debug - Whether to enable debug logging
+     * @returns An Effect that sets up controller file monitoring
+     */
+    const monitorChildIndexes = Effect.fn("effa-cli.index-multi.monitorChildIndexes")(
+      function*(watchPath: string, debug: boolean) {
+        const fileSystem = yield* FileSystem.FileSystem
+
+        if (debug) {
+          yield* Effect.logInfo(`Starting controller monitoring for: ${watchPath}`)
+        }
+
+        const watchStream = fileSystem.watch(watchPath, { recursive: true })
+
+        yield* watchStream.pipe(
+          Stream.runForEach(
+            Effect.fn("effa-cli.monitorChildIndexes.handleEvent")(function*(event) {
+              const pathParts = event.path.split("/")
+              const fileName = pathParts[pathParts.length - 1]
+              const isController = fileName?.toLowerCase().includes(".controllers.")
+
+              if (!isController) return
+
+              let i = 1
+              const reversedParts = pathParts.toReversed()
+
+              while (i < reversedParts.length) {
+                const candidateFiles = ["controllers.ts", "routes.ts"]
+                  .map((f) => [...pathParts.slice(0, pathParts.length - i), f].join("/"))
+
+                const existingFiles: string[] = []
+                for (const file of candidateFiles) {
+                  const exists = yield* fileSystem.exists(file)
+                  if (exists) existingFiles.push(file)
+                }
+
+                if (existingFiles.length > 0) {
+                  if (debug) {
+                    yield* Effect.logInfo(
+                      `Controller change detected: ${event.path}, fixing files: ${existingFiles.join(", ")}`
+                    )
+                  }
+
+                  const eslintArgs = existingFiles.map((f) => `"../${f}"`).join(" ")
+                  yield* runNodeCommand(`cd api && pnpm eslint --fix ${eslintArgs}`)
+                  break
+                }
+                i++
+              }
+            })
+          )
+        )
+      }
+    )
+
+    /**
+     * Monitors a directory for changes and runs eslint on the specified index file.
+     * Triggers eslint fixes when any file in the directory changes (except the index file itself).
+     *
+     * @param watchPath - The path to watch for changes
+     * @param indexFile - The index file to run eslint on when changes occur
+     * @param debug - Whether to enable debug logging
+     * @returns An Effect that sets up root index monitoring
+     */
+    const monitorRootIndexes = Effect.fn("effa-cli.index-multi.monitorRootIndexes")(
+      function*(watchPath: string, indexFile: string, debug: boolean) {
+        const fileSystem = yield* FileSystem.FileSystem
+
         if (debug) {
-          console.log("change!", evt, path, files)
+          yield* Effect.logInfo(`Starting root index monitoring for: ${watchPath} -> ${indexFile}`)
         }
-        cp.execSync(`cd api && pnpm eslint --fix ${files.map((_) => `"../${_}"`).join(" ")}`)
-        break
+
+        const watchStream = fileSystem.watch(watchPath)
+
+        yield* watchStream.pipe(
+          Stream.runForEach(
+            Effect.fn("effa-cli.index-multi.monitorRootIndexes.handleEvent")(function*(event) {
+              if (event.path.endsWith(indexFile)) return
+
+              if (debug) {
+                yield* Effect.logInfo(`Root change detected: ${event.path}, fixing: ${indexFile}`)
+              }
+
+              yield* runNodeCommand(`pnpm eslint --fix "${indexFile}"`)
+            })
+          )
+        )
       }
-      i++
-    }
-  })
-}
-
-function monitorRootIndexes(path: string, indexFile: string) {
-  return w.default(path, (_, path) => {
-    if (path.endsWith(indexFile)) return
-    // const dirName = pathParts[pathParts.length - 2]!
-    // console.log("change!", evt, path, dirName, indexFile)
-    cp.execSync(`pnpm eslint --fix "${indexFile}"`)
-  })
-}
-
-// TODO: cache, don't do things when it already existed before, so only file is updated, not created.
-
-const startDir = process.cwd()
-
-function packagejson(p: string, levels = 0) {
-  const curDir = process.cwd()
-  let r = ""
-  // TODO: no chdir!
-  try {
-    process.chdir(path.resolve(startDir, p))
-    r = cp.execSync(`sh ${p === "." ? "../.." : startDir}/scripts/extract.sh`, { encoding: "utf-8" })
-  } finally {
-    process.chdir(curDir)
-  }
-
-  const s = r.split("\n").sort((a, b) => a < b ? -1 : 1).join("\n")
-  const items = JSON.parse(`{${s.substring(0, s.length - 1)} }`) as Record<string, unknown>
-
-  const pkg = JSON.parse(fs.readFileSync(p + "/package.json", "utf-8"))
-  const t = levels
-    ? Object
-      .keys(items)
-      .filter((_) => _.split("/").length <= (levels + 1 /* `./` */))
-      .reduce((prev, cur) => {
-        prev[cur] = items[cur]
-        return prev
-      }, {} as Record<string, unknown>)
-    : items
-
-  const exps = {
-    ...(fs.existsSync(p + "/src/index.ts")
-      ? {
-        ".": {
-          "types": "./dist/index.d.ts",
-          "default": "./dist/index.js"
+    )
+
+    /**
+     * Sets up comprehensive index monitoring for a given path.
+     * Combines both child controller monitoring and root index monitoring.
+     *
+     * @param watchPath - The path to monitor
+     * @param debug - Whether to enable debug logging
+     * @returns An Effect that sets up all index monitoring for the path
+     */
+    const monitorIndexes = Effect.fn("effa-cli.index-multi.monitorIndexes")(
+      function*(watchPath: string, debug: boolean) {
+        const fileSystem = yield* FileSystem.FileSystem
+
+        if (debug) {
+          yield* Effect.logInfo(`Setting up index monitoring for path: ${watchPath}`)
+        }
+
+        const indexFile = watchPath + "/index.ts"
+
+        const monitors = [monitorChildIndexes(watchPath, debug)]
+
+        if (yield* fileSystem.exists(indexFile)) {
+          monitors.push(monitorRootIndexes(watchPath, indexFile, debug))
+        } else {
+          yield* Effect.logInfo(`Index file ${indexFile} does not exist`)
         }
+
+        if (debug) {
+          yield* Effect.logInfo(`Starting ${monitors.length} monitor(s) for ${watchPath}`)
+        }
+
+        yield* Effect.all(monitors, { concurrency: monitors.length })
+      }
+    )
+
+    /**
+     * Watches directories for file changes and updates tsconfig.json and vite.config.ts accordingly.
+     * Monitors API resources and models directories for changes using Effect's native file watching.
+     *
+     * @returns An Effect that sets up file watching streams
+     */
+    const watcher = Effect.fn("watch")(function*(debug: boolean) {
+      yield* Effect.log("Watch API resources and models for changes")
+
+      const dirs = ["../api/src/resources", "../api/src/models"]
+      const viteConfigFile = "./vite.config.ts"
+      const fileSystem = yield* FileSystem.FileSystem
+
+      const viteConfigExists = yield* fileSystem.exists(viteConfigFile)
+
+      if (debug) {
+        yield* Effect.logInfo("watcher debug mode is enabled")
       }
-      : undefined),
-    ...Object
-      .keys(t)
-      .reduce((prev, cur) => {
-        if (cur !== "./index" && !cur.includes("/internal/")) prev[cur] = t[cur]
-        return prev
-      }, {} as Record<string, unknown>)
-    // ...pkg.name === "effect-app" ? {
-    //   "./types/awesome": { "types": "./types/awesome.d.ts" }
-    // } : {},
-  }
-  pkg.exports = exps
-  fs.writeFileSync(p + "/package.json", JSON.stringify(pkg, null, 2))
-}
-
-function monitorPackagejson(path: string, levels = 0) {
-  packagejson(path, levels)
-  w.default(path + "/src", { recursive: true }, (_, __) => {
-    packagejson(path, levels)
-  })
-}
-
-let cmds = process.argv.slice(3).filter((_) => _ !== "--debug")
-switch (cmd) {
-  case "link":
-    await import("./link.js")
-    break
-  case "unlink":
-    await import("./unlink.js")
-    break
-  case "watch": {
-    const dirs = ["../api/src/resources", "../api/src/models"]
-    const viteConfigFile = "./vite.config.ts"
-    const viteConfigExists = fs.existsSync(viteConfigFile)
-    dirs.forEach((d) => {
-      if (fs.existsSync(d)) {
-        const files: string[] = []
-        w.default(d, { recursive: true }, (t, f) => {
-          // console.log("change!", d)
-          touch("./tsconfig.json")
-          if (viteConfigExists && t === "update" && !files.includes(f)) {
-            // TODO: only on new files
-            touch(viteConfigFile)
-            files.push(f)
+
+      // validate directories and filter out non-existing ones
+      const existingDirs: string[] = []
+      for (const dir of dirs) {
+        const dirExists = yield* fileSystem.exists(dir)
+        if (dirExists) {
+          existingDirs.push(dir)
+        } else {
+          yield* Effect.logWarning(`Directory ${dir} does not exist - skipping`)
+        }
+      }
+
+      if (existingDirs.length === 0) {
+        return yield* Effect.logWarning("No directories to watch - exiting")
+      }
+
+      // start watching all existing directories concurrently
+      const watchStreams = existingDirs.map((dir) =>
+        Effect.gen(function*() {
+          if (debug) {
+            yield* Effect.logInfo(`Starting to watch directory: ${dir}`)
           }
+
+          const files: string[] = []
+          const watchStream = fileSystem.watch(dir, { recursive: true })
+
+          yield* watchStream.pipe(
+            Stream.runForEach(
+              Effect.fn("effa-cli.watch.handleEvent")(function*(event) {
+                if (debug) {
+                  yield* Effect.logInfo(`File ${event._tag.toLowerCase()}: ${event.path}`)
+                }
+
+                // touch tsconfig.json on any file change
+                yield* touch("./tsconfig.json")
+                if (debug) {
+                  yield* Effect.logInfo("Updated tsconfig.json")
+                }
+
+                // touch vite config only on file updates (not creates/deletes)
+                if (
+                  viteConfigExists
+                  && event._tag === "Update"
+                  && !files.includes(event.path)
+                ) {
+                  yield* touch(viteConfigFile)
+                  if (debug) {
+                    yield* Effect.logInfo("Updated vite.config.ts")
+                  }
+                  files.push(event.path)
+                }
+              })
+            )
+          )
         })
-      }
+      )
+
+      // run all watch streams concurrently
+      yield* Effect.all(watchStreams, { concurrency: existingDirs.length })
     })
 
-    break
-  }
+    /**
+     * Updates a package.json file with generated exports mappings for TypeScript modules.
+     * Scans TypeScript source files and creates export entries that map module paths
+     * to their compiled JavaScript and TypeScript declaration files.
+     *
+     * @param startDir - The starting directory path for resolving relative paths
+     * @param p - The package directory path to process
+     * @param levels - Optional depth limit for export filtering (0 = no limit)
+     * @returns An Effect that succeeds when the package.json is updated
+     */
+    const packagejsonUpdater = Effect.fn("effa-cli.packagejsonUpdater")(
+      function*(startDir: string, p: string, levels = 0) {
+        yield* Effect.log(`Generating exports for ${p}`)
+
+        const exportMappings = yield* extractExportMappings(path.resolve(startDir, p))
+
+        // if exportMappings is empty skip export generation
+        if (exportMappings === "") {
+          yield* Effect.log(`No src directory found for ${p}, skipping export generation`)
+          return
+        }
+
+        const sortedExportEntries = JSON.parse(
+          `{ ${exportMappings} }`
+        ) as Record<
+          string,
+          unknown
+        >
 
-  case "index-multi": {
-    ;[
-      "./api/src"
-    ]
-      .filter(
-        (_) => fs.existsSync(_)
+        const filteredExportEntries = levels
+          ? Object
+            .keys(sortedExportEntries)
+            // filter exports by directory depth - only include paths up to specified levels deep
+            .filter((_) => _.split("/").length <= (levels + 1 /* `./` */))
+            .reduce(
+              (prev, cur) => ({ ...prev, [cur]: sortedExportEntries[cur] }),
+              {} as Record<string, unknown>
+            )
+          : sortedExportEntries
+
+        const packageExports = {
+          ...((yield* fs.exists(p + "/src/index.ts"))
+            && {
+              ".": {
+                "types": "./dist/index.d.ts",
+                "default": "./dist/index.js"
+              }
+            }),
+          ...Object
+            .keys(filteredExportEntries)
+            .reduce(
+              (prev, cur) => ({
+                ...prev,
+                // exclude index files and internal modules from package exports:
+                // - skip "./index" to avoid conflicts with the main "." export
+                // - skip "/internal/" paths to keep internal modules private
+                ...cur !== "./index" && !cur.includes("/internal/") && { [cur]: filteredExportEntries[cur] }
+              }),
+              {} as Record<string, unknown>
+            )
+        }
+
+        const pkgJson = JSON.parse(yield* fs.readFileString(p + "/package.json", "utf-8"))
+        pkgJson.exports = packageExports
+
+        yield* Effect.log(`Writing updated package.json for ${p}`)
+
+        return yield* fs.writeFileString(
+          p + "/package.json",
+          JSON.stringify(pkgJson, null, 2)
+        )
+      }
+    )
+
+    /*
+     * CLI
+     */
+
+    const EffectAppLibsPath = Args
+      .directory({
+        exists: "yes",
+        name: "effect-app-libs-path"
+      })
+      .pipe(
+        Args.withDefault("../../effect-app/libs"),
+        Args.withDescription("Path to the effect-app-libs directory")
       )
-      .forEach(monitorIndexes)
-    break
-  }
-
-  case "index": {
-    monitorIndexes("./src")
-    break
-  }
-
-  case "packagejson": {
-    monitorPackagejson(".")
-    break
-  }
-
-  case "packagejson-target": {
-    const target = process.argv[3]!
-    target.split(",").forEach((_) => monitorPackagejson(_, 1))
-    cmds = process.argv.slice(4)
-    break
-  }
-
-  case "packagejson-packages": {
-    fs
-      .readdirSync(startDir + "/packages")
-      .map((_) => startDir + "/packages/" + _)
-      .filter((_) =>
-        fs.existsSync(_ + "/package.json")
-        && fs.existsSync(_ + "/src")
-        && !_.endsWith("eslint-codegen-model")
-        && !_.endsWith("vue-components")
+
+    const link = Command
+      .make(
+        "link",
+        { effectAppLibsPath: EffectAppLibsPath },
+        Effect.fn("effa-cli.link")(function*({ effectAppLibsPath }) {
+          return yield* linkPackages(effectAppLibsPath)
+        })
       )
-      .forEach((_) => monitorPackagejson(_))
-    break
-  }
-
-  case "sync": {
-    console.log("Sync all snippets?")
-
-    await askQuestion("Are you sure you want to sync snippets")
-    await sync()
-    process.exit(0)
-  }
-}
-
-if (cmds.length) {
-  const p = cp.spawn(cmds[0]!, cmds.slice(1), { stdio: "inherit" })
-  p.on("close", (code) => process.exit(code ?? 0))
-  p.on("exit", (code) => process.exit(code ?? 0))
-  p.on("disconnect", () => process.exit(1))
-}
+      .pipe(Command.withDescription("Link local effect-app packages using file resolutions"))
+
+    const unlink = Command
+      .make(
+        "unlink",
+        {},
+        Effect.fn("effa-cli.unlink")(function*({}) {
+          return yield* unlinkPackages
+        })
+      )
+      .pipe(Command.withDescription("Remove effect-app file resolutions and restore npm registry packages"))
+
+    const ue = Command
+      .make(
+        "ue",
+        {},
+        Effect.fn("effa-cli.ue")(function*({}) {
+          yield* Effect.log("Update effect-app and/or effect packages")
+
+          const prompted = yield* Prompt.select({
+            choices: [
+              {
+                title: "effect-app",
+                description: "Update only effect-app packages",
+                value: "effect-app"
+              },
+              {
+                title: "effect",
+                description: "Update only effect packages",
+                value: "effect"
+              },
+              {
+                title: "both",
+                description: "Update both effect-app and effect packages",
+                value: "both"
+              }
+            ],
+            message: "Select an option"
+          })
+
+          switch (prompted) {
+            case "effect-app":
+              return yield* updateEffectAppPackages.pipe(
+                Effect.andThen(runNodeCommand("pnpm i"))
+              )
+
+            case "effect":
+              return yield* updateEffectPackages.pipe(
+                Effect.andThen(runNodeCommand("pnpm i"))
+              )
+            case "both":
+              return yield* updateEffectPackages.pipe(
+                Effect.andThen(updateEffectAppPackages),
+                Effect.andThen(runNodeCommand("pnpm i"))
+              )
+          }
+        })
+      )
+      .pipe(Command.withDescription("Update effect-app and/or effect packages"))
+
+    const DebugOption = Options.boolean("debug").pipe(
+      Options.withAlias("d"),
+      Options.withDescription("Enable debug logging")
+    )
+
+    const watch = Command
+      .make(
+        "watch",
+        { debug: DebugOption },
+        Effect.fn("effa-cli.watch")(function*({ debug }) {
+          return yield* watcher(debug)
+        })
+      )
+      .pipe(
+        Command.withDescription(
+          "Watch API resources and models for changes and update tsconfig.json and vite.config.ts accordingly"
+        )
+      )
+
+    const indexMulti = Command
+      .make(
+        "index-multi",
+        { debug: DebugOption },
+        Effect.fn("effa-cli.index-multi")(function*({ debug }) {
+          yield* Effect.log("Starting multi-index monitoring")
+
+          const dirs = ["./api/src"]
+          const fileSystem = yield* FileSystem.FileSystem
+
+          const existingDirs: string[] = []
+          for (const dir of dirs) {
+            const dirExists = yield* fileSystem.exists(dir)
+            if (dirExists) {
+              existingDirs.push(dir)
+            } else {
+              yield* Effect.logWarning(`Directory ${dir} does not exist - skipping`)
+            }
+          }
+
+          if (existingDirs.length === 0) {
+            return yield* Effect.logWarning("No directories to monitor - exiting")
+          }
+
+          const monitors = existingDirs.map((dir) => monitorIndexes(dir, debug))
+          yield* Effect.all(monitors, { concurrency: monitors.length })
+        })
+      )
+      .pipe(
+        Command.withDescription(
+          "Monitor multiple directories for index and controller file changes"
+        )
+      )
+
+    const packagejson = Command
+      .make(
+        "packagejson",
+        {},
+        Effect.fn("effa-cli.packagejson")(function*({}) {
+          // https://nodejs.org/api/path.html#pathresolvepaths
+          const startDir = path.resolve()
+
+          return yield* packagejsonUpdater(startDir, ".")
+        })
+      )
+      .pipe(
+        Command.withDescription("Generate and update root-level package.json exports mappings for TypeScript modules")
+      )
+
+    const packagejsonPackages = Command
+      .make(
+        "packagejson-packages",
+        {},
+        Effect.fn("effa-cli.packagejson-packages")(function*({}) {
+          // https://nodejs.org/api/path.html#pathresolvepaths
+          const startDir = path.resolve()
+
+          const packagesDir = path.join(startDir, "packages")
+
+          const packagesExists = yield* fs.exists(packagesDir)
+          if (!packagesExists) {
+            return yield* Effect.logWarning("No packages directory found")
+          }
+
+          // get all package directories
+          const packageDirs = yield* fs.readDirectory(packagesDir)
+
+          const validPackages: string[] = []
+
+          // filter packages that have package.json and src directory
+          for (const packageName of packageDirs) {
+            const packagePath = path.join(packagesDir, packageName)
+            const packageJsonExists = yield* fs.exists(path.join(packagePath, "package.json"))
+            const srcExists = yield* fs.exists(path.join(packagePath, "src"))
+
+            const shouldExclude = false
+              || packageName.endsWith("eslint-codegen-model")
+              || packageName.endsWith("vue-components")
+
+            if (packageJsonExists && srcExists && !shouldExclude) {
+              validPackages.push(packagePath)
+            }
+          }
+
+          if (validPackages.length === 0) {
+            return yield* Effect.logWarning("No valid packages found to update")
+          }
+
+          yield* Effect.log(`Found ${validPackages.length} packages to update`)
+
+          // update each package sequentially
+          yield* Effect.all(
+            validPackages.map((packagePath) =>
+              Effect.gen(function*() {
+                const relativePackagePath = path.relative(startDir, packagePath)
+                yield* Effect.log(`Updating ${relativePackagePath}`)
+                return yield* packagejsonUpdater(startDir, relativePackagePath)
+              })
+            )
+          )
+
+          yield* Effect.log("All packages updated successfully")
+        })
+      )
+      .pipe(Command.withDescription("Generate and update package.json exports mappings for all packages in monorepo"))
+
+    // configure CLI
+    const cli = Command.run(
+      Command
+        .make("effa")
+        .pipe(Command.withSubcommands([
+          ue,
+          link,
+          unlink,
+          watch,
+          indexMulti,
+          packagejson,
+          packagejsonPackages
+        ])),
+      {
+        name: "Effect-App CLI by jfet97 ❤️",
+        version: "v1.0.0"
+      }
+    )
+
+    return yield* cli(process.argv)
+  })()
+  .pipe(
+    Effect.provide(NodeContext.layer),
+    NodeRuntime.runMain
+  )