@effect-app/cli 1.23.1 → 1.23.3

package/src/index.ts

@@ -1,283 +1,691 @@
-/* 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",
-  "ncu:effect",
-  "ncu:effect-app"
-] 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++
+                }
+              })
+            )
+          )
+          .pipe(
+            Effect.forkScoped
+          )
+      }
+    )
+
+    /**
+     * 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}"`)
+              })
+            )
+          )
+          .pipe(
+            Effect.forkScoped
+          )
       }
-      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 })
       }
-      : 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)
-  })
-}
-
-function updateEffectAppPackages() {
-  const filters = ["effect-app", "@effect-app/*"]
-  for (const filter of filters) {
-    cp.execSync(`pnpm exec ncu -u --filter "${filter}"`, { stdio: "inherit" })
-    cp.execSync(`pnpm -r exec ncu -u --filter "${filter}"`, { stdio: "inherit" })
-  }
-}
-
-function updateEffectPackages() {
-  const effectFilters = ["effect", "@effect/*", "@effect-atom/*"]
-  for (const filter of effectFilters) {
-    cp.execSync(`pnpm exec ncu -u --filter "${filter}"`, { stdio: "inherit" })
-    cp.execSync(`pnpm -r exec ncu -u --filter "${filter}"`, { stdio: "inherit" })
-  }
-
-  updateEffectAppPackages()
-}
-
-;(async () => {
-  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": {
+    )
+
+    /**
+     * 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 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)
-            }
-          })
-        }
-      })
+      const fileSystem = yield* FileSystem.FileSystem
 
-      break
-    }
+      const viteConfigExists = yield* fileSystem.exists(viteConfigFile)
 
-    case "index-multi": {
-      ;[
-        "./api/src"
-      ]
-        .filter(
-          (_) => fs.existsSync(_)
-        )
-        .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")
-        )
-        .forEach((_) => monitorPackagejson(_))
-      break
-    }
+      if (debug) {
+        yield* Effect.logInfo("watcher debug mode is enabled")
+      }
 
-    case "sync": {
-      console.log("Sync all snippets?")
+      // 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`)
+        }
+      }
 
-      await askQuestion("Are you sure you want to sync snippets")
-      await sync()
-      return process.exit(0)
-    }
+      if (existingDirs.length === 0) {
+        return yield* Effect.logWarning("No directories to watch - exiting")
+      }
 
-    case "ncu:effect": {
-      console.log("Updating effect & effect-app dependencies...")
+      // start watching all existing directories concurrently
+      const watchStreams = existingDirs.map((dir) =>
+        Effect.gen(function*() {
+          if (debug) {
+            yield* Effect.logInfo(`Starting to watch directory: ${dir}`)
+          }
 
-      updateEffectPackages()
+          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)
+                  }
+                })
+              )
+            )
+            .pipe(
+              Effect.forkScoped
+            )
+
+          // also start monitoring indexes in the watched directory
+          yield* monitorIndexes(dir, debug)
+        })
+      )
+
+      // run all watch streams concurrently
+      yield* Effect.all(watchStreams, { concurrency: existingDirs.length })
+    })
+
+    /**
+     * 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
+        }
 
-      cp.execSync("pnpm i", { stdio: "inherit" })
+        const sortedExportEntries = JSON.parse(
+          `{ ${exportMappings} }`
+        ) as Record<
+          string,
+          unknown
+        >
+
+        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>
+            )
+        }
 
-      break
-    }
+        const pkgJson = JSON.parse(yield* fs.readFileString(p + "/package.json", "utf-8"))
+        pkgJson.exports = packageExports
 
-    case "ncu:effect-app": {
-      console.log("Updating effect-app dependencies...")
+        yield* Effect.log(`Writing updated package.json for ${p}`)
 
-      updateEffectAppPackages()
+        return yield* fs.writeFileString(
+          p + "/package.json",
+          JSON.stringify(pkgJson, null, 2)
+        )
+      }
+    )
 
-      cp.execSync("pnpm i", { stdio: "inherit" })
+    /*
+     * CLI
+     */
 
-      break
-    }
-  }
+    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")
+      )
+
+    const link = Command
+      .make(
+        "link",
+        { effectAppLibsPath: EffectAppLibsPath },
+        Effect.fn("effa-cli.link")(function*({ effectAppLibsPath }) {
+          return yield* linkPackages(effectAppLibsPath)
+        })
+      )
+      .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"
+          })
 
-  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))
-  }
-})()
+          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.scoped,
+    Effect.provide(NodeContext.layer),
+    NodeRuntime.runMain
+  )