thinkwell 0.5.4 → 0.5.6

package/dist/cli/dependency-check.js

@@ -1,296 +1,152 @@
-/**
- * Dependency checking for `thinkwell build` and `thinkwell check`.
- *
- * Implements a hybrid detection strategy:
- * - Fast path: Check package.json directly for dependencies
- * - Slow path: Fall back to `<pm> why --json` for workspace-hoisted dependencies
- *
- * @see doc/rfd/explicit-config.md for the full design
- */
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { spawn } from "node:child_process";
-import { detectPackageManager, } from "./package-manager.js";
-/**
- * Read and parse package.json from a directory.
- * Returns null if the file doesn't exist or is invalid JSON.
- */
+import { detectPackageManager } from "./package-manager.js";
 function readPackageJson(dir) {
-    const pkgPath = join(dir, "package.json");
-    if (!existsSync(pkgPath)) {
-        return null;
-    }
-    try {
-        const content = readFileSync(pkgPath, "utf-8");
-        return JSON.parse(content);
-    }
-    catch {
-        return null;
-    }
+  const pkgPath = join(dir, "package.json");
+  if (!existsSync(pkgPath))
+    return null;
+  try {
+    const content = readFileSync(pkgPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
 }
-/**
- * Check if a package is declared in package.json (fast path).
- *
- * Checks dependencies, devDependencies, peerDependencies, and optionalDependencies.
- * Returns the dependency status if found, or null if not found.
- */
 function checkPackageJsonDirect(pkg, packageName) {
-    // Check each dependency type
-    const depTypes = [
-        pkg.dependencies,
-        pkg.devDependencies,
-        pkg.peerDependencies,
-        pkg.optionalDependencies,
-    ];
-    for (const deps of depTypes) {
-        if (deps && packageName in deps) {
-            return {
-                found: true,
-                version: deps[packageName],
-                source: "package.json",
-            };
-        }
-    }
-    return null;
+  const depTypes = [
+    pkg.dependencies,
+    pkg.devDependencies,
+    pkg.peerDependencies,
+    pkg.optionalDependencies
+  ];
+  for (const deps of depTypes)
+    if (deps && packageName in deps)
+      return {
+        found: !0,
+        version: deps[packageName],
+        source: "package.json"
+      };
+  return null;
 }
-// ============================================================================
-// Slow Path: Package Manager CLI Inspection
-// ============================================================================
-/**
- * Execute a command and return its stdout.
- * Rejects if the command fails or returns non-zero exit code.
- */
 function execCommand(cmd, cwd) {
-    return new Promise((resolve, reject) => {
-        const [command, ...args] = cmd;
-        const proc = spawn(command, args, {
-            cwd,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        let stdout = "";
-        let stderr = "";
-        proc.stdout.on("data", (data) => {
-            stdout += data.toString();
-        });
-        proc.stderr.on("data", (data) => {
-            stderr += data.toString();
-        });
-        proc.on("error", (err) => {
-            reject(err);
-        });
-        proc.on("close", (code) => {
-            if (code === 0) {
-                resolve({ stdout, stderr });
-            }
-            else {
-                reject(new Error(`Command failed with exit code ${code}: ${stderr}`));
-            }
-        });
+  return new Promise((resolve, reject) => {
+    const [command, ...args] = cmd, proc = spawn(command, args, {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"]
     });
+    let stdout = "", stderr = "";
+    proc.stdout.on("data", (data) => {
+      stdout += data.toString();
+    }), proc.stderr.on("data", (data) => {
+      stderr += data.toString();
+    }), proc.on("error", (err) => {
+      reject(err);
+    }), proc.on("close", (code) => {
+      code === 0 ? resolve({ stdout, stderr }) : reject(new Error(`Command failed with exit code ${code}: ${stderr}`));
+    });
+  });
 }
-/**
- * Parse pnpm why --json output to determine if a package is installed.
- *
- * pnpm why outputs JSON like:
- * {
- *   "packageName": {
- *     "version": "1.0.0",
- *     "dependents": [...]
- *   }
- * }
- *
- * For workspace-hoisted packages, the package appears with its version.
- */
 function parsePnpmWhyOutput(stdout, packageName) {
-    try {
-        const result = JSON.parse(stdout);
-        // pnpm why returns an object with the package name as key
-        if (result && typeof result === "object" && packageName in result) {
-            const info = result[packageName];
-            return {
-                found: true,
-                version: info?.version,
-                source: "workspace",
-            };
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
+  try {
+    const result = JSON.parse(stdout);
+    return result && typeof result == "object" && packageName in result ? {
+      found: !0,
+      version: result[packageName]?.version,
+      source: "workspace"
+    } : null;
+  } catch {
+    return null;
+  }
 }
-/**
- * Parse npm why --json output to determine if a package is installed.
- *
- * npm why (npm explain) outputs JSON array like:
- * [
- *   {
- *     "name": "packageName",
- *     "version": "1.0.0",
- *     "dependents": [...]
- *   }
- * ]
- *
- * An empty array or error object means the package is not found.
- */
 function parseNpmWhyOutput(stdout, _packageName) {
-    try {
-        const result = JSON.parse(stdout);
-        // npm why returns an array of explanations
-        if (Array.isArray(result) && result.length > 0) {
-            const first = result[0];
-            return {
-                found: true,
-                version: first?.version,
-                source: "workspace",
-            };
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
+  try {
+    const result = JSON.parse(stdout);
+    return Array.isArray(result) && result.length > 0 ? {
+      found: !0,
+      version: result[0]?.version,
+      source: "workspace"
+    } : null;
+  } catch {
+    return null;
+  }
 }
-/**
- * Parse yarn why --json output to determine if a package is installed.
- *
- * Yarn Classic (v1) outputs newline-delimited JSON objects:
- * {"type":"info","data":"Found \"package@version\"..."}
- *
- * Yarn Berry (v2+) outputs similar but structured differently.
- * Exit code 0 with output indicates the package was found.
- */
 function parseYarnWhyOutput(stdout, _packageName) {
-    // If there's any output and the command succeeded (which it did if we got here),
-    // the package was found
-    if (stdout.trim().length > 0) {
-        // Try to extract version from the output
-        // Yarn classic: {"type":"info","data":"Found \"pkg@1.0.0\"..."}
-        let version;
-        try {
-            // Parse each line as JSON (yarn outputs newline-delimited JSON)
-            const lines = stdout.trim().split("\n");
-            for (const line of lines) {
-                const obj = JSON.parse(line);
-                if (obj.type === "info" && obj.data) {
-                    // Extract version from "Found \"pkg@1.0.0\"" pattern
-                    const match = obj.data.match(/"[^@]+@([^"]+)"/);
-                    if (match) {
-                        version = match[1];
-                        break;
-                    }
-                }
-            }
-        }
-        catch {
-            // Couldn't parse version, but package was found
+  if (stdout.trim().length > 0) {
+    let version;
+    try {
+      const lines = stdout.trim().split(`
+`);
+      for (const line of lines) {
+        const obj = JSON.parse(line);
+        if (obj.type === "info" && obj.data) {
+          const match = obj.data.match(/"[^@]+@([^"]+)"/);
+          if (match) {
+            version = match[1];
+            break;
+          }
         }
-        return {
-            found: true,
-            version,
-            source: "workspace",
-        };
+      }
+    } catch {
     }
-    return null;
+    return {
+      found: !0,
+      version,
+      source: "workspace"
+    };
+  }
+  return null;
 }
-/**
- * Check for a package using the package manager's `why` command (slow path).
- *
- * This handles workspace-hoisted dependencies that aren't declared directly
- * in the current package's package.json.
- */
 async function checkViaPackageManager(pm, packageName, cwd) {
-    const cmd = pm.whyCommand(packageName);
-    try {
-        const { stdout } = await execCommand(cmd, cwd);
-        switch (pm.name) {
-            case "pnpm":
-                return parsePnpmWhyOutput(stdout, packageName);
-            case "npm":
-                return parseNpmWhyOutput(stdout, packageName);
-            case "yarn":
-                return parseYarnWhyOutput(stdout, packageName);
-        }
-    }
-    catch {
-        // Command failed — package not found
-        return null;
+  const cmd = pm.whyCommand(packageName);
+  try {
+    const { stdout } = await execCommand(cmd, cwd);
+    switch (pm.name) {
+      case "pnpm":
+        return parsePnpmWhyOutput(stdout, packageName);
+      case "npm":
+        return parseNpmWhyOutput(stdout, packageName);
+      case "yarn":
+        return parseYarnWhyOutput(stdout, packageName);
     }
+  } catch {
+    return null;
+  }
 }
-// ============================================================================
-// Main Check Function
-// ============================================================================
-/**
- * Check whether required dependencies (thinkwell, typescript) are available.
- *
- * Uses a hybrid strategy:
- * 1. Fast path: Check package.json directly
- * 2. Slow path: If not found, check via package manager CLI for workspace-hoisted deps
- *
- * @param projectDir - The project directory to check
- * @returns Status of both dependencies and package manager info
- */
 export async function checkDependencies(projectDir) {
-    const pm = detectPackageManager(projectDir);
-    const pkg = readPackageJson(projectDir);
-    // Initialize results
-    let thinkwellStatus = { found: false };
-    let typescriptStatus = { found: false };
-    // Fast path: check package.json directly
-    if (pkg) {
-        const thinkwellDirect = checkPackageJsonDirect(pkg, "thinkwell");
-        if (thinkwellDirect) {
-            thinkwellStatus = thinkwellDirect;
-        }
-        const typescriptDirect = checkPackageJsonDirect(pkg, "typescript");
-        if (typescriptDirect) {
-            typescriptStatus = typescriptDirect;
-        }
-    }
-    // Slow path: if not found in package.json, check via package manager
-    // This handles workspace-hoisted dependencies
-    if (!thinkwellStatus.found) {
-        const result = await checkViaPackageManager(pm, "thinkwell", projectDir);
-        if (result) {
-            thinkwellStatus = result;
-        }
-    }
-    if (!typescriptStatus.found) {
-        const result = await checkViaPackageManager(pm, "typescript", projectDir);
-        if (result) {
-            typescriptStatus = result;
-        }
-    }
-    return {
-        thinkwell: thinkwellStatus,
-        typescript: typescriptStatus,
-        packageManager: pm,
-    };
+  const pm = detectPackageManager(projectDir), pkg = readPackageJson(projectDir);
+  let thinkwellStatus = { found: !1 }, typescriptStatus = { found: !1 };
+  if (pkg) {
+    const thinkwellDirect = checkPackageJsonDirect(pkg, "thinkwell");
+    thinkwellDirect && (thinkwellStatus = thinkwellDirect);
+    const typescriptDirect = checkPackageJsonDirect(pkg, "typescript");
+    typescriptDirect && (typescriptStatus = typescriptDirect);
+  }
+  if (!thinkwellStatus.found) {
+    const result = await checkViaPackageManager(pm, "thinkwell", projectDir);
+    result && (thinkwellStatus = result);
+  }
+  if (!typescriptStatus.found) {
+    const result = await checkViaPackageManager(pm, "typescript", projectDir);
+    result && (typescriptStatus = result);
+  }
+  return {
+    thinkwell: thinkwellStatus,
+    typescript: typescriptStatus,
+    packageManager: pm
+  };
 }
-/**
- * Check if a project has a package.json.
- * Used to determine if dependency checking should be performed at all.
- */
 export function hasPackageJson(projectDir) {
-    return existsSync(join(projectDir, "package.json"));
+  return existsSync(join(projectDir, "package.json"));
 }
-/**
- * Find the nearest project root by walking up from `startDir`.
- *
- * A project root is a directory containing a `package.json`.
- * Returns the directory path, or undefined if none is found.
- */
 export function findProjectRoot(startDir) {
-    let dir = startDir;
-    while (true) {
-        if (existsSync(join(dir, "package.json"))) {
-            return dir;
-        }
-        const parent = dirname(dir);
-        if (parent === dir) {
-            return undefined;
-        }
-        dir = parent;
-    }
+  let dir = startDir;
+  for (; ; ) {
+    if (existsSync(join(dir, "package.json")))
+      return dir;
+    const parent = dirname(dir);
+    if (parent === dir)
+      return;
+    dir = parent;
+  }
 }
-//# sourceMappingURL=dependency-check.js.map

package/dist/cli/dependency-errors.js

@@ -1,92 +1,20 @@
-/**
- * Error message templates for missing dependencies.
- *
- * When a project has a package.json but is missing required dependencies
- * (thinkwell, typescript), we fail fast with clear remediation guidance.
- *
- * @see doc/rfd/explicit-config.md for the design rationale
- */
-// ============================================================================
-// Error Message Formatting
-// ============================================================================
-/**
- * Format an error message for missing dependencies.
- *
- * The message explains why explicit dependencies are required and provides
- * package-manager-specific commands for remediation.
- */
 export function formatMissingDependencyError(result) {
-    const { thinkwell, typescript, packageManager } = result;
-    const pm = packageManager;
-    // Collect missing dependencies
-    const missing = [];
-    if (!thinkwell.found)
-        missing.push("thinkwell");
-    if (!typescript.found)
-        missing.push("typescript");
-    if (missing.length === 0) {
-        return ""; // No error to format
-    }
-    // Build the error message
-    const lines = [];
-    // Primary error
-    if (missing.length === 1) {
-        lines.push(`Error: This project has a package.json but no dependency on '${missing[0]}'.`);
-    }
-    else {
-        lines.push(`Error: This project has a package.json but is missing required dependencies.`);
-    }
-    lines.push("");
-    // Explanation
-    lines.push("When a project has explicit configuration, thinkwell expects explicit dependencies.");
-    lines.push("This ensures you get the versions you expect, not versions bundled with the CLI.");
-    lines.push("");
-    // Remediation guidance
-    lines.push("Run 'thinkwell init' to add the required dependencies, or add them manually:");
-    // Generate package-manager-specific commands
-    if (!thinkwell.found) {
-        lines.push(`  ${pm.addCommand("thinkwell")}`);
-    }
-    if (!typescript.found) {
-        lines.push(`  ${pm.addCommand("typescript", true)}`);
-    }
-    return lines.join("\n");
+  const { thinkwell, typescript, packageManager } = result, pm = packageManager, missing = [];
+  if (thinkwell.found || missing.push("thinkwell"), typescript.found || missing.push("typescript"), missing.length === 0)
+    return "";
+  const lines = [];
+  return missing.length === 1 ? lines.push(`Error: This project has a package.json but no dependency on '${missing[0]}'.`) : lines.push("Error: This project has a package.json but is missing required dependencies."), lines.push(""), lines.push("When a project has explicit configuration, thinkwell expects explicit dependencies."), lines.push("This ensures you get the versions you expect, not versions bundled with the CLI."), lines.push(""), lines.push("Run 'thinkwell init' to add the required dependencies, or add them manually:"), thinkwell.found || lines.push(`  ${pm.addCommand("thinkwell")}`), typescript.found || lines.push(`  ${pm.addCommand("typescript", !0)}`), lines.join(`
+`);
 }
-/**
- * Check if any required dependencies are missing.
- */
 export function hasMissingDependencies(result) {
-    return !result.thinkwell.found || !result.typescript.found;
+  return !result.thinkwell.found || !result.typescript.found;
 }
-/**
- * Check if required dependencies are missing, with optional typescript check.
- *
- * For `run` and `bundle`, typescript is only required when the script
- * uses `@JSONSchema` markers.
- */
 export function hasMissingDeps(result, options) {
-    if (!result.thinkwell.found)
-        return true;
-    if (options.requireTypescript && !result.typescript.found)
-        return true;
-    return false;
+  return !!(!result.thinkwell.found || options.requireTypescript && !result.typescript.found);
 }
-/**
- * Format an error message for missing dependencies, with optional typescript check.
- *
- * Like `formatMissingDependencyError` but respects whether typescript is required.
- */
 export function formatMissingDepsError(result, options) {
-    if (!options.requireTypescript && result.thinkwell.found) {
-        return "";
-    }
-    // When typescript is not required, mask it as found to suppress its error line
-    if (!options.requireTypescript) {
-        return formatMissingDependencyError({
-            ...result,
-            typescript: { found: true },
-        });
-    }
-    return formatMissingDependencyError(result);
+  return !options.requireTypescript && result.thinkwell.found ? "" : options.requireTypescript ? formatMissingDependencyError(result) : formatMissingDependencyError({
+    ...result,
+    typescript: { found: !0 }
+  });
 }
-//# sourceMappingURL=dependency-errors.js.map

package/dist/cli/fmt.js

@@ -1,14 +1,2 @@
-/**
- * Shared ANSI formatting helpers for CLI help screens.
- *
- * Uses node:util styleText for consistent coloring across all
- * `thinkwell` subcommand help output.
- */
 import { styleText } from "node:util";
-export const cyan = (t) => styleText("cyan", t);
-export const cyanBold = (t) => styleText(["cyan", "bold"], t);
-export const greenBold = (t) => styleText(["green", "bold"], t);
-export const whiteBold = (t) => styleText(["white", "bold"], t);
-export const dim = (t) => styleText("dim", t);
-export const redBold = (t) => styleText(["red", "bold"], t);
-//# sourceMappingURL=fmt.js.map
+export const cyan = (t) => styleText("cyan", t), cyanBold = (t) => styleText(["cyan", "bold"], t), greenBold = (t) => styleText(["green", "bold"], t), whiteBold = (t) => styleText(["white", "bold"], t), dim = (t) => styleText("dim", t), redBold = (t) => styleText(["red", "bold"], t);