@kurotako/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,675 @@
+// src/cli.ts
+import { TakoError as TakoError3 } from "@kurotako/core";
+import { defineCommand as defineCommand5, renderUsage, runCommand } from "citty";
+
+// src/commands/check.ts
+import { existsSync as existsSync2 } from "fs";
+import { relative } from "path";
+import { loadConfig } from "@kurotako/config";
+import { run } from "@kurotako/core";
+import { defineCommand } from "citty";
+
+// src/args.ts
+var sharedArgs = {
+  config: {
+    type: "string",
+    description: "path to the tako config file (default: ./tako.config.ts)"
+  },
+  /** Hidden: not advertised, kept minimal. Enables `debug` reporter output. */
+  debug: {
+    type: "boolean",
+    default: false
+  }
+};
+
+// src/diff.ts
+import { existsSync } from "fs";
+import { readdir, readFile } from "fs/promises";
+import path from "path";
+function toPosix(rootDir, absPath) {
+  return path.relative(rootDir, absPath).split(path.sep).join("/");
+}
+async function comparePlanToDisk(args) {
+  const { plan, roots, ignore, rootDir } = args;
+  const plannedByPath = new Map(plan.map((f) => [path.resolve(f.path), f]));
+  const entries = [];
+  for (const [absPath, file] of plannedByPath) {
+    if (!existsSync(absPath)) {
+      entries.push({ kind: "missing", path: toPosix(rootDir, absPath) });
+      continue;
+    }
+    const onDisk = await readFile(absPath, "utf8");
+    if (onDisk !== file.content) {
+      entries.push({ kind: "modified", path: toPosix(rootDir, absPath) });
+    }
+  }
+  const plannedPaths = [...plannedByPath.keys()];
+  const hasPlannedUnder = (dir) => {
+    const prefix = `${dir}${path.sep}`;
+    return plannedPaths.some((p) => p === dir || p.startsWith(prefix));
+  };
+  const seenRoots = /* @__PURE__ */ new Set();
+  for (const root of roots) {
+    const absRoot = path.resolve(root);
+    if (seenRoots.has(absRoot) || !existsSync(absRoot)) {
+      continue;
+    }
+    seenRoots.add(absRoot);
+    await scan(absRoot);
+  }
+  async function scan(dir) {
+    if (!hasPlannedUnder(dir)) {
+      if (await hasNonIgnoredFile(dir)) {
+        entries.push({ kind: "orphan", path: `${toPosix(rootDir, dir)}/` });
+      }
+      return;
+    }
+    for (const dirent of await readdir(dir, { withFileTypes: true })) {
+      const abs = path.join(dir, dirent.name);
+      if (ignore(abs)) {
+        continue;
+      }
+      if (dirent.isDirectory()) {
+        await scan(abs);
+      } else if (dirent.isFile() && !plannedByPath.has(abs)) {
+        entries.push({ kind: "orphan", path: toPosix(rootDir, abs) });
+      }
+    }
+  }
+  async function hasNonIgnoredFile(dir) {
+    for (const dirent of await readdir(dir, { withFileTypes: true })) {
+      const abs = path.join(dir, dirent.name);
+      if (ignore(abs)) {
+        continue;
+      }
+      if (dirent.isFile()) {
+        return true;
+      }
+      if (dirent.isDirectory() && await hasNonIgnoredFile(abs)) {
+        return true;
+      }
+    }
+    return false;
+  }
+  entries.sort(
+    (a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : a.kind < b.kind ? -1 : a.kind > b.kind ? 1 : 0
+  );
+  return entries;
+}
+function ignoreBuildArtifacts(absPath) {
+  return /(^|[/\\])(dist|node_modules)([/\\]|$)/.test(absPath);
+}
+async function hasGeneratedMarker(pkgDir) {
+  try {
+    const pkg = JSON.parse(
+      await readFile(path.join(pkgDir, "package.json"), "utf8")
+    );
+    return typeof pkg["//"] === "string" && pkg["//"].startsWith("Generated by tako");
+  } catch {
+    return false;
+  }
+}
+async function markedPackageDirs(packagesDir) {
+  if (!existsSync(packagesDir)) {
+    return [];
+  }
+  const out = [];
+  for (const dirent of await readdir(packagesDir, { withFileTypes: true })) {
+    if (!dirent.isDirectory()) {
+      continue;
+    }
+    const abs = path.join(packagesDir, dirent.name);
+    if (await hasGeneratedMarker(abs)) {
+      out.push(abs);
+    }
+  }
+  return out.sort();
+}
+
+// src/reporter.ts
+import { childLogger } from "@kurotako/core";
+var ESC = String.fromCharCode(27);
+var ANSI = {
+  debug: `${ESC}[2m`,
+  // dim
+  info: `${ESC}[36m`,
+  // cyan
+  warn: `${ESC}[33m`,
+  // yellow
+  error: `${ESC}[31m`
+  // red
+};
+var ANSI_RESET = `${ESC}[0m`;
+var ConsoleReporter = class {
+  stream;
+  showDebug;
+  color;
+  constructor(options = {}) {
+    this.stream = options.stream ?? process.stderr;
+    this.showDebug = options.debug ?? Boolean(process.env.TAKO_DEBUG);
+    this.color = options.color ?? (Boolean(this.stream.isTTY) && process.env.NO_COLOR === void 0);
+  }
+  debug(msg, meta) {
+    if (this.showDebug) {
+      this.write("debug", msg, meta);
+    }
+  }
+  info(msg, meta) {
+    this.write("info", msg, meta);
+  }
+  warn(msg, meta) {
+    this.write("warn", msg, meta);
+  }
+  error(msg, meta) {
+    this.write("error", msg, meta);
+  }
+  /** A child `Logger` whose calls carry `{ scope: tag }` in `meta`. */
+  child(tag) {
+    return childLogger(this, { scope: tag });
+  }
+  write(level, msg, meta) {
+    const prefix = this.color ? `${ANSI[level]}tako${ANSI_RESET}` : "tako";
+    const detail = meta === void 0 ? "" : ` ${formatMeta(meta)}`;
+    this.stream.write(`${prefix} ${msg}${detail}
+`);
+  }
+};
+function formatMeta(meta) {
+  if (meta !== null && typeof meta === "object" && !Array.isArray(meta)) {
+    return Object.entries(meta).map(([k, v]) => `${k}=${stringify(v)}`).join(" ");
+  }
+  return stringify(meta);
+}
+function stringify(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+
+// src/commands/check.ts
+var checkCommand = defineCommand({
+  meta: {
+    name: "check",
+    description: "check the generated output on disk matches a fresh generate (drift guard)"
+  },
+  args: { ...sharedArgs },
+  run: async ({ args }) => {
+    const reporter = new ConsoleReporter({ debug: Boolean(args.debug) });
+    const cwd = process.cwd();
+    const { config } = await loadConfig({
+      cwd,
+      configPath: args.config || void 0
+    });
+    const { plan = [] } = await run(config, { logger: reporter, plan: true });
+    const roots = [];
+    const ignores = [];
+    for (const output of config.outputs) {
+      if (output.mode === "package") {
+        ignores.push(ignoreBuildArtifacts);
+        if (output.packagesDir) {
+          roots.push(...await markedPackageDirs(output.packagesDir));
+        }
+      } else {
+        const dir = output.dir;
+        if (!dir) {
+          continue;
+        }
+        if (!existsSync2(dir)) {
+          reporter.info(
+            `output directory ${relative(config.rootDir, dir)} does not exist \u2014 run tako generate`
+          );
+          process.exitCode = 1;
+          return;
+        }
+        roots.push(dir);
+      }
+    }
+    const ignore = (absPath) => ignores.some((fn) => fn(absPath));
+    const drift = await comparePlanToDisk({
+      plan,
+      roots,
+      ignore,
+      rootDir: config.rootDir
+    });
+    if (drift.length === 0) {
+      reporter.info("output is in sync");
+      process.exitCode ??= 0;
+      return;
+    }
+    reporter.error(formatDrift(drift));
+    process.exitCode = 1;
+  }
+});
+function formatDrift(drift) {
+  const width = Math.max(...drift.map((entry) => entry.kind.length));
+  const lines = drift.map(
+    (entry) => `  ${entry.kind.padEnd(width)}  ${entry.path}`
+  );
+  return [
+    "drift detected",
+    "",
+    ...lines,
+    "",
+    `${drift.length} files differ from a fresh generate. Run \`tako generate\`.`
+  ].join("\n");
+}
+
+// src/commands/generate.ts
+import { relative as relative2 } from "path";
+import { loadConfig as loadConfig2 } from "@kurotako/config";
+import { run as run2 } from "@kurotako/core";
+import { defineCommand as defineCommand2 } from "citty";
+
+// src/watch.ts
+import { basename, resolve } from "path";
+import {
+  loadConfig as realLoadConfig
+} from "@kurotako/config";
+import { run as realRun, TakoError as TakoError2 } from "@kurotako/core";
+import chokidar from "chokidar";
+
+// src/errors.ts
+import { TakoError } from "@kurotako/core";
+var ConfigExistsError = class extends TakoError {
+  path;
+  constructor(path2) {
+    super(
+      "config_exists",
+      `a config file already exists at '${path2}' (pass --force to overwrite)`
+    );
+    this.path = path2;
+  }
+};
+function renderError(error) {
+  const lines = [`error [${error.code}]: ${error.message}`];
+  const issues = error.issues;
+  if (Array.isArray(issues)) {
+    for (const issue of issues) {
+      const at = issue.path === void 0 || issue.path === "" ? "<root>" : issue.path;
+      lines.push(`  - ${at}: ${issue.message}`);
+    }
+  }
+  const cycle = error.cycle;
+  if (Array.isArray(cycle) && cycle.length > 0) {
+    lines.push(`  cycle: ${cycle.join(" -> ")}`);
+  }
+  const driverName = error.driverName;
+  if (typeof driverName === "string") {
+    const role = error.role;
+    const namespace = error.namespace;
+    const roleLabel = typeof role === "string" ? role : "driver";
+    const where = typeof namespace === "string" ? ` (namespace '${namespace}')` : "";
+    lines.push(`  ${roleLabel}: ${driverName}${where}`);
+  } else {
+    const generator = error.generator;
+    if (typeof generator === "string") {
+      const namespace = error.namespace;
+      const where = typeof namespace === "string" ? ` (namespace '${namespace}')` : "";
+      lines.push(`  generator: ${generator}${where}`);
+    }
+  }
+  const cause = error.cause;
+  if (cause !== void 0 && cause !== null) {
+    const message = cause instanceof Error ? cause.message : String(cause);
+    const code = cause instanceof TakoError ? ` [${cause.code}]` : "";
+    lines.push(`  cause${code}: ${message}`);
+  }
+  return lines.join("\n");
+}
+
+// src/watch.ts
+var DEBOUNCE_MS = 100;
+function chokidarWatcher() {
+  const fsw = chokidar.watch([], {
+    ignoreInitial: true,
+    awaitWriteFinish: { stabilityThreshold: 150, pollInterval: 20 }
+  });
+  return {
+    add: (paths) => fsw.add(paths),
+    unwatch: (paths) => fsw.unwatch(paths),
+    on: (handler) => {
+      fsw.on("add", (p) => handler("add", p));
+      fsw.on("change", (p) => handler("change", p));
+      fsw.on("unlink", (p) => handler("unlink", p));
+    },
+    close: () => fsw.close()
+  };
+}
+function isAbortError(error) {
+  return error instanceof Error && error.name === "AbortError";
+}
+async function watchAndRun(opts, deps = {}) {
+  const { cwd, configPath, reporter } = opts;
+  const createWatcher = deps.createWatcher ?? chokidarWatcher;
+  const loadConfig3 = deps.loadConfig ?? realLoadConfig;
+  const run3 = deps.run ?? realRun;
+  const debounceMs = deps.debounceMs ?? DEBOUNCE_MS;
+  const watcher = createWatcher();
+  let watched = /* @__PURE__ */ new Set();
+  let inFlight = null;
+  let queued = false;
+  let closed = false;
+  let timer = null;
+  let reason = "initial build";
+  const guessedConfigFile = configPath ? resolve(cwd, configPath) : resolve(cwd, "tako.config.ts");
+  function applyWatchSet(desired) {
+    for (const path2 of desired) {
+      if (!watched.has(path2)) {
+        watcher.add(path2);
+      }
+    }
+    for (const path2 of watched) {
+      if (!desired.has(path2)) {
+        watcher.unwatch(path2);
+      }
+    }
+    watched = desired;
+  }
+  async function reconcileWatchSet(loaded) {
+    const desired = /* @__PURE__ */ new Set([loaded.configFile]);
+    for (const [namespace, source] of Object.entries(loaded.config.sources)) {
+      const paths = await source.parser.watchPaths?.({
+        namespace,
+        cwd: loaded.rootDir,
+        logger: reporter
+      }) ?? [];
+      for (const path2 of paths) {
+        desired.add(resolve(loaded.rootDir, path2));
+      }
+    }
+    applyWatchSet(desired);
+  }
+  async function cycle() {
+    const why = reason;
+    reporter.info(`--- rebuild (${why}) ---`);
+    const ac = new AbortController();
+    inFlight = ac;
+    try {
+      const loaded = await loadConfig3({ cwd, configPath });
+      await reconcileWatchSet(loaded);
+      const result = await run3(loaded.config, {
+        logger: reporter,
+        signal: ac.signal,
+        write: true
+      });
+      if (!ac.signal.aborted) {
+        reporter.info(`wrote ${result.files.length} files`);
+      }
+    } catch (error) {
+      if (isAbortError(error) || ac.signal.aborted) {
+      } else if (error instanceof TakoError2) {
+        reporter.error(renderError(error));
+        applyWatchSet(/* @__PURE__ */ new Set([...watched, guessedConfigFile]));
+      } else {
+        reporter.error("internal error (this is a bug):");
+        console.error(error);
+      }
+    } finally {
+      inFlight = null;
+      if (queued && !closed) {
+        queued = false;
+        await cycle();
+      }
+    }
+  }
+  function trigger() {
+    if (inFlight) {
+      queued = true;
+      inFlight.abort();
+      return;
+    }
+    void cycle();
+  }
+  function schedule(event, path2) {
+    if (closed) {
+      return;
+    }
+    reason = `${basename(path2)} ${event === "unlink" ? "removed" : "changed"}`;
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      timer = null;
+      trigger();
+    }, debounceMs);
+  }
+  watcher.on(schedule);
+  applyWatchSet(/* @__PURE__ */ new Set([guessedConfigFile]));
+  await cycle();
+  reporter.info(`watching ${watched.size} paths`);
+  await new Promise((resolvePromise) => {
+    const shutdown = () => {
+      closed = true;
+      if (timer) {
+        clearTimeout(timer);
+      }
+      inFlight?.abort();
+      process.off("SIGINT", shutdown);
+      process.off("SIGTERM", shutdown);
+      void watcher.close().finally(() => resolvePromise());
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+  });
+}
+
+// src/commands/generate.ts
+function outputSummaryDir(output, config) {
+  return output.mode === "package" ? output.packagesDir ?? config.rootDir : output.dir ?? config.rootDir;
+}
+async function loadAndRun(opts) {
+  const loaded = await loadConfig2({
+    cwd: opts.cwd,
+    configPath: opts.configPath
+  });
+  const result = await run2(loaded.config, {
+    logger: opts.reporter,
+    write: opts.write,
+    signal: opts.signal
+  });
+  return {
+    result,
+    config: loaded.config,
+    configFile: loaded.configFile,
+    rootDir: loaded.rootDir
+  };
+}
+var generateCommand = defineCommand2({
+  meta: {
+    name: "generate",
+    description: "run the pipeline and write the generated code"
+  },
+  args: {
+    ...sharedArgs,
+    watch: {
+      type: "boolean",
+      description: "rebuild on every schema / config change",
+      default: false
+    },
+    "dry-run": {
+      type: "boolean",
+      description: "run everything but write nothing",
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    const reporter = new ConsoleReporter({ debug: Boolean(args.debug) });
+    const cwd = process.cwd();
+    const configPath = args.config || void 0;
+    if (args.watch) {
+      await watchAndRun({ cwd, configPath, reporter });
+      return;
+    }
+    const dryRun = Boolean(args["dry-run"]);
+    const { result, config } = await loadAndRun({
+      cwd,
+      configPath,
+      write: !dryRun,
+      reporter
+    });
+    if (dryRun) {
+      reporter.info(`dry run: ${result.files.length} files would be written`);
+      return;
+    }
+    const dirs = config.outputs.map((output) => relative2(cwd, outputSummaryDir(output, config))).join(", ");
+    reporter.info(`wrote ${result.files.length} files -> ${dirs}`);
+  }
+});
+
+// src/commands/init.ts
+import { existsSync as existsSync3, readFileSync } from "fs";
+import { mkdir, writeFile } from "fs/promises";
+import { dirname, relative as relative3, resolve as resolve2 } from "path";
+import { CONFIG_TEMPLATE, CONFIG_TEMPLATE_MONOREPO } from "@kurotako/config";
+import { defineCommand as defineCommand3 } from "citty";
+function detectMonorepo(startDir) {
+  let dir = resolve2(startDir);
+  while (true) {
+    const pkgPath = resolve2(dir, "package.json");
+    if (existsSync3(pkgPath)) {
+      if (existsSync3(resolve2(dir, "pnpm-workspace.yaml"))) {
+        return true;
+      }
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        const ws = pkg.workspaces;
+        if (Array.isArray(ws) || typeof ws === "object" && ws !== null && Array.isArray(ws.packages)) {
+          return true;
+        }
+      } catch {
+      }
+      return false;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) {
+      return false;
+    }
+    dir = parent;
+  }
+}
+var initCommand = defineCommand3({
+  meta: {
+    name: "init",
+    description: "create a tako.config.ts in the current directory"
+  },
+  args: {
+    ...sharedArgs,
+    force: {
+      type: "boolean",
+      description: "overwrite an existing config file",
+      default: false
+    },
+    monorepo: {
+      type: "boolean",
+      description: "write the monorepo config layout (auto-detected from workspaces when unset)",
+      default: void 0
+    }
+  },
+  run: async ({ args }) => {
+    const reporter = new ConsoleReporter({ debug: Boolean(args.debug) });
+    const cwd = process.cwd();
+    const target = args.config ? resolve2(cwd, args.config) : resolve2(cwd, "tako.config.ts");
+    if (existsSync3(target) && !args.force) {
+      throw new ConfigExistsError(target);
+    }
+    const monorepo = typeof args.monorepo === "boolean" ? args.monorepo : detectMonorepo(cwd);
+    await mkdir(dirname(target), { recursive: true });
+    await writeFile(
+      target,
+      monorepo ? CONFIG_TEMPLATE_MONOREPO : CONFIG_TEMPLATE,
+      "utf8"
+    );
+    const name = relative3(cwd, target) || "tako.config.ts";
+    reporter.info(
+      monorepo ? `created ${name} (monorepo layout)` : `created ${name}`
+    );
+  }
+});
+
+// src/commands/validate.ts
+import { defineCommand as defineCommand4 } from "citty";
+var validateCommand = defineCommand4({
+  meta: {
+    name: "validate",
+    description: "check the config and schema without writing anything"
+  },
+  args: { ...sharedArgs },
+  run: async ({ args }) => {
+    const reporter = new ConsoleReporter({ debug: Boolean(args.debug) });
+    await loadAndRun({
+      cwd: process.cwd(),
+      configPath: args.config || void 0,
+      write: false,
+      reporter
+    });
+    reporter.info("config and schema are valid");
+  }
+});
+
+// src/cli.ts
+var VERSION = true ? "0.1.0" : "0.0.0-dev";
+var subCommands = {
+  init: initCommand,
+  generate: generateCommand,
+  validate: validateCommand,
+  check: checkCommand
+};
+var main = defineCommand5({
+  meta: {
+    name: "tako",
+    version: VERSION,
+    description: "synchronise TypeScript schemas from data model to forms"
+  },
+  subCommands
+});
+async function runCli(argv) {
+  const reporter = new ConsoleReporter({
+    debug: argv.includes("--debug") || Boolean(process.env.TAKO_DEBUG)
+  });
+  if (argv.includes("--version") || argv.includes("-v")) {
+    process.stdout.write(`${VERSION}
+`);
+    process.exitCode ??= 0;
+    return;
+  }
+  if (argv.length === 0 || argv.includes("--help") || argv.includes("-h")) {
+    const sub = argv.find((a) => !a.startsWith("-"));
+    const isSub = sub !== void 0 && sub in subCommands;
+    const cmd = isSub ? subCommands[sub] : main;
+    process.stdout.write(
+      `${await renderUsage(cmd, isSub ? main : void 0)}
+`
+    );
+    process.exitCode ??= 0;
+    return;
+  }
+  try {
+    await runCommand(main, { rawArgs: argv });
+    process.exitCode ??= 0;
+  } catch (error) {
+    if (error instanceof TakoError3) {
+      reporter.error(renderError(error));
+      process.exitCode = 1;
+    } else if (error instanceof Error && error.name === "CLIError") {
+      reporter.error(error.message);
+      process.exitCode = 1;
+    } else {
+      reporter.error("internal error (this is a bug):");
+      console.error(error);
+      process.exitCode = 1;
+    }
+  }
+}
+export {
+  ConfigExistsError,
+  ConsoleReporter,
+  comparePlanToDisk,
+  renderError,
+  runCli
+};
+//# sourceMappingURL=index.js.map