hackmud-script-manager 0.19.1-98e81f8 → 0.19.1-b040eb5

package/README.md

@@ -1,7 +1,7 @@
 # Hackmud Script Manager
 Command made for [hackmud-environment](https://github.com/samualtnorman/hackmud-environment), which is a scripting environment for hackmud with minification, autocompletes / intellisense, and TypeScript support.
 
-Install with `npm install hackmud-script-manager -g` to make the `hsm` command available everywhere.
+Install with `npm install -g hackmud-script-manager` to make the `hsm` command available everywhere.
 
 ## Features
 - Minification

package/bin/hsm.js

@@ -3,16 +3,16 @@ import { Cache } from "@samual/lib/Cache"
 import { assert } from "@samual/lib/assert"
 import { countHackmudCharacters } from "@samual/lib/countHackmudCharacters"
 import { writeFilePersistent } from "@samual/lib/writeFilePersistent"
-import { readFile, writeFile, mkdir, rmdir } from "fs/promises"
+import { writeFile, readFile } from "fs/promises"
 import { homedir } from "os"
-import { resolve, extname, basename, dirname, relative } from "path"
+import { extname, basename, resolve, dirname, relative } from "path"
 import { supportedExtensions } from "../constants.js"
 import { generateTypeDeclaration } from "../generateTypeDeclaration.js"
 import { pull } from "../pull.js"
 import { syncMacros } from "../syncMacros.js"
+import "@samual/lib/readDirectoryWithStats"
 import "@samual/lib/copyFilePersistent"
-const configDirectoryPath = resolve(homedir(), ".config"),
-	configFilePath = resolve(configDirectoryPath, "hsm.json"),
+const version = "0.19.1-b040eb5",
 	options = new Map(),
 	commands = [],
 	userColours = new Cache(user => {
@@ -20,117 +20,7 @@ const configDirectoryPath = resolve(homedir(), ".config"),
 		for (const char of user) hash += (hash >> 1) + hash + "xi1_8ratvsw9hlbgm02y5zpdcn7uekof463qj".indexOf(char) + 1
 		return [colourJ, colourK, colourM, colourW, colourL, colourB][hash % 6](user)
 	}),
-	logNeedHackmudPathMessage = () =>
-		console.error(
-			colourS(
-				`${colourD("You need to set hackmudPath in config before you can use this command")}\n\n${colourA("To fix this:")}\nOpen hackmud and run "${colourC("#dir")}"\nThis will open a file browser and print your hackmud user's script directory\nGo up 2 directories and then copy the path\nThen in a terminal run "${colourC("hsm")} ${colourL("config set")} ${colourV("hackmudPath")} ${colourB("<the path you copied>")}"`
-			)
-		),
-	logHelp = () => {
-		const pushCommandDescription = "Push scripts from a directory to hackmud user's scripts directories",
-			mangleNamesOptionDescription = "Reduce character count further but lose function names in error call stacks"
-		console.log(colourN("Version") + colourS(": ") + colourV("0.19.1-98e81f8"))
-		switch (commands[0]) {
-			case "config":
-				switch (commands[1]) {
-					case "get":
-						console.log(
-							`\n${colourJ("Retrieve a value from the config file")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(`${commands[0]} ${commands[1]}`)} ${colourB("<key>")}`
-						)
-						break
-					case "set":
-						console.log(
-							`\n${colourJ("Assign a value to the config file")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(`${commands[0]} ${commands[1]}`)} ${colourB("<key> <value>")}`
-						)
-						break
-					case "delete":
-						console.log(
-							`\n${colourJ("Remove a key and value from the config file")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(`${commands[0]} ${commands[1]}`)} ${colourB("<key>")}`
-						)
-						break
-					default:
-						console.log(
-							colourS(
-								`${colourN("Config path")}: ${colourV(configFilePath)}\n\n${colourJ("Modify the config file")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0] + " get")} ${colourB("<key>")}\n    Retrieve a value from the config file\n${colourC("hsm")} ${colourL(commands[0] + " set")} ${colourB("<key> <value>")}\n    Assign a value to the config file\n${colourC("hsm")} ${colourL(commands[0] + " delete")} ${colourB("<key>")}\n    Remove a key and value from the config file`
-							)
-						)
-				}
-				break
-			case "push":
-				console.log(
-					colourS(
-						`\n${colourJ(pushCommandDescription)}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<directory> [<script user>.<script name>...]")}\n\n${colourA("Options:")}\n${colourN("--skip-minify")}\n    Skip minification to produce a readable script\n${colourN("--mangle-names")}\n    ${mangleNamesOptionDescription}\n${colourN("--force-quine-cheats")}\n    Force quine cheats even if the character count is higher`
-					)
-				)
-				break
-			case "dev":
-			case "watch":
-				console.log(
-					colourS(
-						`${colourN("Aliases")}: ${colourV("watch, dev")}\n\n${colourJ("Watch a directory and push a script when modified")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<directory> [<script user>.<script name>...]")}\n\n${colourA("Options:")}\n${colourN("--skip-minify")}\n    Skip minification to produce a readable script\n${colourN("--mangle-names")}\n    ${mangleNamesOptionDescription}\n${colourN("--type-declaration-path")}=${colourB("<path>")}\n    Path to generate a type declaration file for the scripts\n${colourN("--force-quine-cheats")}\n    Force quine cheats even if the character count is higher`
-					)
-				)
-				break
-			case "pull":
-				console.log(
-					colourS(
-						`\n${colourJ("Pull a script a from a hackmud user's script directory")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<script user>")}${colourV(".")}${colourB("<script name>")}`
-					)
-				)
-				break
-			case "minify":
-			case "golf":
-				console.log(
-					colourS(
-						`${colourN("Aliases")}: ${colourV("minify, golf")}\n\n${colourJ("Minify a script file on the spot")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<target> [output path]")}\n\n${colourA("Options:")}\n${colourN("--skip-minify")}\n    Skip minification to produce a readable script\n${colourN("--mangle-names")}\n    ${mangleNamesOptionDescription}\n${colourN("--force-quine-cheats")}\n    Force quine cheats even if the character count is higher\n${colourN("--watch")}\n    Watch for changes`
-					)
-				)
-				break
-			case "generate-type-declaration":
-			case "gen-type-declaration":
-			case "gen-dts":
-			case "gen-types":
-				console.log(
-					colourS(
-						`${colourN("Aliases")}: ${colourV("generate-type-declaration, gen-type-declaration, gen-types, gen-dts")}\n\n${colourJ("Generate a type declaration file for a directory of scripts")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<directory> [output path]")}`
-					)
-				)
-				break
-			case "sync-macros":
-				console.log("\n" + colourJ("Sync macros across all hackmud users"))
-				break
-			default:
-				console.log(
-					colourS(
-						`\n${colourJ("Hackmud Script Manager")}\n\n${colourA("Commands:")}\n${colourL("push")}\n    ${pushCommandDescription}\n${colourL("watch")}, ${colourL("dev")}\n    Watch a directory and push a script when modified\n${colourL("minify")}, ${colourL("golf")}\n    Minify a script file on the spot\n${colourL("generate-type-declaration")}, ${colourL("gen-type-declaration")}, ${colourL("gen-types")}, ${colourL("gen-dts")}\n    Generate a type declaration file for a directory of scripts\n${colourL("sync-macros")}\n    Sync macros across all hackmud users\n${colourL("config")}\n    Modify and view the config file\n${colourL("pull")}\n    Pull a script a from a hackmud user's script directory`
-					)
-				)
-		}
-	},
-	exploreObject = (object, keys, createPath = !1) => {
-		for (const key of keys)
-			object =
-				createPath ?
-					"object" == typeof object[key] ?
-						object[key]
-					:	(object[key] = {})
-				:	object?.[key]
-		return object
-	},
-	logInfo = ({ file, users, minLength, error }, hackmudPath) => {
-		error ?
-			logError(`error "${chalk.bold(error.message)}" in ${chalk.bold(file)}`)
-		:	console.log(
-				`pushed ${chalk.bold(file)} to ${users.map(user => chalk.bold(userColours.get(user))).join(", ")} | ${chalk.bold(minLength + "")} chars | ${chalk.bold(resolve(hackmudPath, users[0], "scripts", basename(file, extname(file))) + ".js")}`
-			)
-	},
-	log = message => {
-		console.log(colourS(message))
-	},
-	logError = message => {
-		console.error(colourD(message))
-		process.exitCode = 1
-	}
+	log = message => console.log(colourS(message))
 for (const argument of process.argv.slice(2))
 	if ("-" == argument[0]) {
 		const [key, valueRaw] = argument.split("=")
@@ -147,35 +37,10 @@ for (const argument of process.argv.slice(2))
 		else for (const option of key.slice(1)) options.set(option, value)
 	} else commands.push(argument)
 if ("v" == commands[0] || "version" == commands[0] || options.get("version") || options.get("v")) {
-	console.log("0.19.1-98e81f8")
+	console.log(version)
 	process.exit()
 }
-let configDidNotExist = !1
-const configPromise = readFile(configFilePath, { encoding: "utf-8" }).then(
-		configFile => {
-			let temporaryConfig
-			try {
-				temporaryConfig = JSON.parse(configFile)
-			} catch {
-				log("Config file was corrupted, resetting")
-				return {}
-			}
-			if (!temporaryConfig || "object" != typeof temporaryConfig) {
-				log("Config file was corrupted, resetting")
-				return {}
-			}
-			if ("hackmudPath" in temporaryConfig && "string" != typeof temporaryConfig.hackmudPath) {
-				log('Property "hackmudPath" of config file was corrupted, removing')
-				delete temporaryConfig.hackmudPath
-			}
-			return temporaryConfig
-		},
-		() => {
-			configDidNotExist = !0
-			return {}
-		}
-	),
-	pushModule = import("../push.js"),
+const pushModule = import("../push.js"),
 	processScriptModule = import("../processScript/index.js"),
 	watchModule = import("../watch.js"),
 	chokidarModule = import("chokidar"),
@@ -200,12 +65,8 @@ let autoExit = !0
 switch (commands[0]) {
 	case "push":
 		{
-			const { hackmudPath } = await configPromise
-			if (!hackmudPath) {
-				logNeedHackmudPathMessage()
-				break
-			}
-			const sourcePath = commands[1]
+			const hackmudPath = getHackmudPath(),
+				sourcePath = commands[1]
 			if (!sourcePath) {
 				logError("Must provide the directory to push from\n")
 				logHelp()
@@ -222,17 +83,20 @@ switch (commands[0]) {
 					break
 				}
 			} else scripts.push("*.*")
-			if (options.has("skip-minify") && options.has("mangle-names")) {
-				logError(`Option ${colourN("--mangle-names")} is not compatible with ${colourN("--skip-minify")}\n`)
+			const optionsHasNoMinify = options.has("no-minify")
+			if ((optionsHasNoMinify || options.has("skip-minify")) && options.has("mangle-names")) {
+				logError(
+					`Options ${colourN("--mangle-names")} and ${colourN(optionsHasNoMinify ? "--no-minify" : "--skip-minify")} are incompatible\n`
+				)
 				logHelp()
 				break
 			}
-			const shouldSkipMinify = options.get("skip-minify")
+			const shouldSkipMinify = options.get("no-minify") || options.get("skip-minify")
 			let shouldMinify
 			if (null != shouldSkipMinify) {
 				if ("boolean" != typeof shouldSkipMinify) {
 					logError(
-						`The value for ${colourN("--skip-minify")} must be ${colourV("true")} or ${colourV("false")}\n`
+						`The value for ${colourN(optionsHasNoMinify ? "--no-minify" : "--skip-minify")} must be ${colourV("true")} or ${colourV("false")}\n`
 					)
 					logHelp()
 					break
@@ -270,12 +134,8 @@ switch (commands[0]) {
 	case "dev":
 	case "watch":
 		{
-			const { hackmudPath } = await configPromise
-			if (!hackmudPath) {
-				logNeedHackmudPathMessage()
-				break
-			}
-			const sourcePath = commands[1]
+			const hackmudPath = getHackmudPath(),
+				sourcePath = commands[1]
 			if (!sourcePath) {
 				logError("Must provide the directory to watch\n")
 				logHelp()
@@ -292,17 +152,20 @@ switch (commands[0]) {
 					break
 				}
 			} else scripts.push("*.*")
-			if (options.has("skip-minify") && options.has("mangle-names")) {
-				logError(`Option ${colourN("--mangle-names")} is not compatible with ${colourN("--skip-minify")}\n`)
+			const optionsHasNoMinify = options.has("no-minify")
+			if ((optionsHasNoMinify || options.has("skip-minify")) && options.has("mangle-names")) {
+				logError(
+					`Options ${colourN("--mangle-names")} and ${colourN(optionsHasNoMinify ? "--no-minify" : "--skip-minify")} are incompatible\n`
+				)
 				logHelp()
 				break
 			}
-			const shouldSkipMinify = options.get("skip-minify")
+			const shouldSkipMinify = options.get("no-minify") || options.get("skip-minify")
 			let shouldMinify
 			if (null != shouldSkipMinify) {
 				if ("boolean" != typeof shouldSkipMinify) {
 					logError(
-						`The value for ${colourN("--skip-minify")} must be ${colourV("true")} or ${colourV("false")}\n`
+						`The value for ${colourN(optionsHasNoMinify ? "--no-minify" : "--skip-minify")} must be ${colourV("true")} or ${colourV("false")}\n`
 					)
 					logHelp()
 					break
@@ -345,34 +208,24 @@ switch (commands[0]) {
 		break
 	case "pull":
 		{
-			const { hackmudPath } = await configPromise
-			if (!hackmudPath) {
-				logNeedHackmudPathMessage()
-				break
-			}
-			const script = commands[1]
+			const hackmudPath = getHackmudPath(),
+				script = commands[1]
 			if (!script) {
 				logError("Must provide the script to pull\n")
 				logHelp()
 				break
 			}
 			const sourcePath = commands[2] || "."
-			try {
-				await pull(sourcePath, hackmudPath, script)
-			} catch (error) {
+			await pull(sourcePath, hackmudPath, script).catch(error => {
 				console.error(error)
 				logError(`Something went wrong, did you forget to ${colourC("#down")} the script?`)
-			}
+			})
 		}
 		break
 	case "sync-macros":
 		{
-			const { hackmudPath } = await configPromise
-			if (!hackmudPath) {
-				logNeedHackmudPathMessage()
-				break
-			}
-			const { macrosSynced, usersSynced } = await syncMacros(hackmudPath)
+			const hackmudPath = getHackmudPath(),
+				{ macrosSynced, usersSynced } = await syncMacros(hackmudPath)
 			log(`Synced ${macrosSynced} macros to ${usersSynced} users`)
 		}
 		break
@@ -389,100 +242,17 @@ switch (commands[0]) {
 			}
 			const sourcePath = resolve(target),
 				outputPath = commands[2] || "./player.d.ts",
-				typeDeclaration = await generateTypeDeclaration(sourcePath, (await configPromise).hackmudPath)
+				typeDeclaration = await generateTypeDeclaration(sourcePath, getHackmudPath())
 			let typeDeclarationPath = resolve(outputPath)
-			try {
-				await writeFile(typeDeclarationPath, typeDeclaration)
-			} catch (error) {
-				assert(error instanceof Error)
+			await writeFile(typeDeclarationPath, typeDeclaration).catch(error => {
+				assert(error instanceof Error, "src/bin/hsm.ts:327:35")
 				if ("EISDIR" != error.code) throw error
 				typeDeclarationPath = resolve(typeDeclarationPath, "player.d.ts")
-				await writeFile(typeDeclarationPath, typeDeclaration)
-			}
+				return writeFile(typeDeclarationPath, typeDeclaration)
+			})
 			log("Wrote type declaration to " + chalk.bold(typeDeclarationPath))
 		}
 		break
-	case "config":
-		switch (commands[1]) {
-			case "get":
-				{
-					const key = commands[2]
-					key ? log(exploreObject(await configPromise, key.split("."))) : console.log(await configPromise)
-				}
-				break
-			case "delete":
-				{
-					const key = commands[2]
-					if (!key) {
-						logError("Must provide a key to delete\n")
-						logHelp()
-						break
-					}
-					const keyParts = key.split("."),
-						pathName = keyParts
-							.map(name => (/^[a-z_$][\w$]*$/i.test(name) ? name : JSON.stringify(name)))
-							.join("."),
-						lastKey = keyParts.pop(),
-						config = await configPromise
-					delete exploreObject(config, keyParts)?.[lastKey]
-					log(`Removed ${colourV(pathName)} from config file`)
-				}
-				break
-			case "set":
-				{
-					const key = commands[2],
-						value = commands[3]
-					if (!key) {
-						logError("Must provide a key and value\n")
-						logHelp()
-						break
-					}
-					const keys = key.split("."),
-						pathName = keys
-							.map(name => (/^[a-z_$][\w$]*$/i.test(name) ? name : JSON.stringify(name)))
-							.join(".")
-					if (!value) {
-						logError(`Must provide a value for the key ${pathName}\n`)
-						logHelp()
-						break
-					}
-					const lastKey = keys.pop(),
-						config = await configPromise
-					if (keys.length || "hackmudPath" != lastKey) {
-						let object = config
-						for (const key of keys)
-							if ("object" == typeof object[key]) object = object[key]
-							else {
-								object[key] = {}
-								object = object[key]
-							}
-						object[lastKey] = value
-					} else config.hackmudPath = resolve(value.startsWith("~/") ? homedir() + value.slice(1) : value)
-					console.log(config)
-					await (async config => {
-						const json = JSON.stringify(config, void 0, "\t")
-						configDidNotExist && log("Creating config file at " + configFilePath)
-						await writeFile(configFilePath, json).catch(async error => {
-							switch (error.code) {
-								case "EISDIR":
-									await rmdir(configFilePath)
-									break
-								case "ENOENT":
-									await mkdir(configDirectoryPath)
-									break
-								default:
-									throw error
-							}
-							await writeFile(configFilePath, json)
-						})
-					})(config)
-				}
-				break
-			default:
-				commands[1] && logError(`Unknown command: ${JSON.stringify(commands[1])}\n`)
-				logHelp()
-		}
-		break
 	case "help":
 	case "h":
 		logHelp()
@@ -510,10 +280,12 @@ switch (commands[0]) {
 				scriptUser =
 					"scripts" == basename(resolve(target, "..")) && "hackmud" == basename(resolve(target, "../../..")) ?
 						basename(resolve(target, "../.."))
-					:	"UNKNOWN",
-				minify = !options.get("skip-minify")
-			if (options.has("skip-minify") && options.has("mangle-names")) {
-				logError(`Option ${colourN("--mangle-names")} would have no effect if minification is skipped\n`)
+					:	void 0,
+				optionsHasNoMinify = options.has("no-minify")
+			if ((optionsHasNoMinify || options.has("skip-minify")) && options.has("mangle-names")) {
+				logError(
+					`Options ${colourN("--mangle-names")} and ${colourN(optionsHasNoMinify ? "--no-minify" : "--skip-minify")} are incompatible\n`
+				)
 				logHelp()
 				break
 			}
@@ -544,36 +316,31 @@ switch (commands[0]) {
 					: fileBaseName + ".js"
 				)
 			const golfFile = () =>
-				readFile(target, { encoding: "utf-8" }).then(
-					async source => {
-						const timeStart = performance.now(),
-							{ script, warnings } = await processScript(source, {
-								minify,
-								scriptUser,
-								scriptName,
-								filePath: target,
-								mangleNames,
-								forceQuineCheats
-							}),
-							timeTook = performance.now() - timeStart
-						for (const { message, line } of warnings)
-							log(`Warning "${chalk.bold(message)}" on line ${chalk.bold(line + "")}`)
-						await writeFilePersistent(outputPath, script)
-							.catch(async error => {
-								if (!commands[2] || "EISDIR" != error.code) throw error
-								outputPath = resolve(outputPath, basename(target, fileExtension) + ".js")
-								await writeFilePersistent(outputPath, script)
-							})
-							.then(
-								() =>
-									log(
-										`Wrote ${chalk.bold(countHackmudCharacters(script))} chars to ${chalk.bold(relative(".", outputPath))} | took ${Math.round(100 * timeTook) / 100}ms`
-									),
-								error => logError(error.message)
+				readFile(target, { encoding: "utf8" }).then(async source => {
+					const timeStart = performance.now(),
+						{ script, warnings } = await processScript(source, {
+							minify: !(options.get("no-minify") || options.get("skip-minify")),
+							scriptUser,
+							scriptName,
+							filePath: target,
+							mangleNames,
+							forceQuineCheats
+						}),
+						timeTook = performance.now() - timeStart
+					for (const { message, line } of warnings)
+						log(`Warning "${chalk.bold(message)}" on line ${chalk.bold(line + "")}`)
+					await writeFilePersistent(outputPath, script)
+						.catch(error => {
+							if (!commands[2] || "EISDIR" != error.code) throw error
+							outputPath = resolve(outputPath, basename(target, fileExtension) + ".js")
+							return writeFilePersistent(outputPath, script)
+						})
+						.then(() =>
+							log(
+								`Wrote ${chalk.bold(countHackmudCharacters(script))} chars to ${chalk.bold(relative(".", outputPath))} | took ${Math.round(100 * timeTook) / 100}ms`
 							)
-					},
-					error => logError(error.message)
-				)
+						)
+				})
 			if (options.get("watch")) {
 				const { watch: watchFile } = await chokidarModule
 				watchFile(target, { awaitWriteFinish: { stabilityThreshold: 100 } })
@@ -584,7 +351,87 @@ switch (commands[0]) {
 		}
 		break
 	default:
-		commands[0] && logError(`Unknown command: ${JSON.stringify(commands[0])}\n`)
+		commands[0] && logError(`Unknown command: ${colourL(commands[0])}\n`)
 		logHelp()
 }
 autoExit && process.exit()
+function logHelp() {
+	const pushCommandDescription = "Push scripts from a directory to hackmud user's scripts directories",
+		forceQuineCheatsOptionDescription = `Force quine cheats on. Use ${colourN("--force-quine-cheats")}=${colourV("false")} to force off`,
+		hackmudPathOption = `${colourN("--hackmud-path")}=${colourB("<path>")}\n    Override hackmud path`
+	console.log(colourN("Version") + colourS(": ") + colourV(version))
+	switch (commands[0]) {
+		case "dev":
+		case "watch":
+		case "push":
+			console.log(
+				colourS(
+					`\n${colourJ("push" == commands[0] ? pushCommandDescription : "Watch a directory and push a script when modified")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB('<directory> ["<script user>.<script name>"...]')}\n\n${colourA("Arguments:")}\n${colourB("<directory>")}\n    The source directory containing your scripts\n${colourB("<script user>")}\n    A user to push script(s) to. Can be set to wild card (${colourV("*")}) which will try\n    and discover users to push to\n${colourB("<script name>")}\n    Name of a script to push. Can be set to wild card (${colourV("*")}) to find all scripts\n\n${colourA("Options:")}\n${colourN("--no-minify")}\n    Skip minification to produce a "readable" script\n${colourN("--mangle-names")}\n    Reduce character count further but lose function names in error call stacks\n${colourN("--force-quine-cheats")}\n    ${forceQuineCheatsOptionDescription}\n${hackmudPathOption}\n${"push" == commands[0] ? "" : `${colourN("--type-declaration-path")}=${colourB("<path>")}\n    Path to generate a type declaration file for the scripts\n`}\n${colourA("Examples:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")}\n\tPushes all scripts found in ${colourV("src")} folder to all users\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("bar")}\n    Pushes a script named ${colourL("bar")} found in ${colourV("src")} folder to user ${userColours.get("foo")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("bar")} ${colourC("baz")}${colourV(".")}${colourL("qux")}\n    Multiple can be specified\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("foo")}${colourV(".")}${colourL("*")}\n\tPushes all scripts found in ${colourV("src")} folder to user ${userColours.get("foo")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("*")}${colourV(".")}${colourL("foo")}\n\tPushes all scripts named ${colourL("foo")} found in ${colourV("src")} folder to all user\n${colourC("hsm")} ${colourL(commands[0])} ${colourV("src")} ${colourC("*")}${colourV(".")}${colourL("*")}\n\tPushes all scripts found in ${colourV("src")} folder to all users`
+				)
+			)
+			break
+		case "pull":
+			console.log(
+				colourS(
+					`\n${colourJ("Pull a script a from a hackmud user's script directory")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<script user>")}${colourV(".")}${colourB("<script name>")}\n\n${colourA("Options:")}\n${hackmudPathOption}`
+				)
+			)
+			break
+		case "minify":
+		case "golf":
+			console.log(
+				colourS(
+					`\n${colourJ("Minify a script file on the spot")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<target> [output path]")}\n\n${colourA("Options:")}\n${colourN("--no-minify")}\n    Skip minification to produce a "readable" script\n${colourN("--mangle-names")}\n    Reduce character count further but lose function names in error call stacks\n${colourN("--force-quine-cheats")}\n    ${forceQuineCheatsOptionDescription}\n${colourN("--watch")}\n    Watch for changes`
+				)
+			)
+			break
+		case "generate-type-declaration":
+		case "gen-type-declaration":
+		case "gen-dts":
+		case "gen-types":
+			console.log(
+				colourS(
+					`${colourJ("Generate a type declaration file for a directory of scripts")}\n\n${colourA("Usage:")}\n${colourC("hsm")} ${colourL(commands[0])} ${colourB("<directory> [output path]")}\n\n${colourA("Options:")}\n${hackmudPathOption}`
+				)
+			)
+			break
+		case "sync-macros":
+			console.log(
+				colourS(
+					`\n${colourJ("Sync macros across all hackmud users")}\n\n${colourA("Options:")}\n${hackmudPathOption}`
+				)
+			)
+			break
+		default:
+			console.log(
+				colourS(
+					`\n${colourJ("Hackmud Script Manager")}\n\n${colourA("Commands:")}\n${colourL("push")}\n    ${pushCommandDescription}\n${colourL("dev")}\n    Watch a directory and push a script when modified\n${colourL("golf")}\n    Minify a script file on the spot\n${colourL("gen-dts")}\n    Generate a type declaration file for a directory of scripts\n${colourL("sync-macros")}\n    Sync macros across all hackmud users\n${colourL("pull")}\n    Pull a script a from a hackmud user's script directory`
+				)
+			)
+	}
+}
+function logInfo({ path, users, characterCount, error }, hackmudPath) {
+	path = relative(".", path)
+	error ?
+		logError(`Error "${chalk.bold(error.message)}" in ${chalk.bold(path)}`)
+	:	log(
+			`Pushed ${chalk.bold(path)} to ${users.map(user => chalk.bold(userColours.get(user))).join(", ")} | ${chalk.bold(characterCount + "")} chars | ${chalk.bold(resolve(hackmudPath, users[0], "scripts", basename(path, extname(path))) + ".js")}`
+		)
+}
+function logError(message) {
+	console.error(colourD(message))
+	process.exitCode = 1
+}
+function getHackmudPath() {
+	const hackmudPathOption = options.get("hackmud-path")
+	if (null != hackmudPathOption && "string" != typeof hackmudPathOption) {
+		logError(`Option ${colourN("--hackmud-path")} must be a string, got ${colourV(hackmudPathOption)}\n`)
+		logHelp()
+		process.exit(1)
+	}
+	return (
+		hackmudPathOption ||
+		process.env.HSM_HACKMUD_PATH ||
+		("win32" == process.platform ? resolve(process.env.APPDATA, "hackmud") : resolve(homedir(), ".config/hackmud"))
+	)
+}