@unscientificjszhai/howto 1.0.0-alpha.2

package/dist/validation/command-tool.js

@@ -0,0 +1,185 @@
+import { accessSync, constants } from "fs";
+import { delimiter, isAbsolute, join } from "path";
+import { AiResponseValidationError } from "./ai-response.js";
+const ENV_ASSIGNMENT_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*=.*$/;
+const SHELL_WRAPPERS = new Set(["sh", "bash", "zsh", "fish", "csh", "ksh"]);
+export function checkCommandInPath(command, env = process.env) {
+    const candidates = buildPathCandidates(command, env);
+    for (const candidate of candidates) {
+        if (isExecutable(candidate)) {
+            return {
+                command,
+                found: true,
+                resolvedPath: candidate,
+            };
+        }
+    }
+    return {
+        command,
+        found: false,
+    };
+}
+export function validateUseCommandCandidates(response, useCommand) {
+    if (useCommand === undefined) {
+        return;
+    }
+    response.commands.forEach((candidate, index) => {
+        if (!candidateUsesRequestedCommand(candidate.command, useCommand)) {
+            throw new AiResponseValidationError(`commands[${index}].command must use ${useCommand} as the first executable token after optional environment assignments, sudo, or env`);
+        }
+    });
+}
+export function candidateUsesRequestedCommand(commandText, requestedCommand) {
+    const tokens = tokenizeShellPrefix(commandText);
+    if (tokens === undefined || tokens.length === 0) {
+        return false;
+    }
+    const executable = findFirstExecutableToken(tokens);
+    if (executable === undefined) {
+        return false;
+    }
+    if (SHELL_WRAPPERS.has(executable)) {
+        return false;
+    }
+    return executable === requestedCommand;
+}
+function buildPathCandidates(command, env) {
+    var _a, _b;
+    if (command.includes("/") || isAbsolute(command)) {
+        return [command];
+    }
+    const pathValue = (_a = env.PATH) !== null && _a !== void 0 ? _a : "";
+    const pathExt = process.platform === "win32" ? ((_b = env.PATHEXT) !== null && _b !== void 0 ? _b : ".EXE;.CMD;.BAT;.COM") : "";
+    const extensions = process.platform === "win32" ? pathExt.split(";").filter(Boolean) : [""];
+    const candidates = [];
+    for (const directory of pathValue.split(delimiter)) {
+        if (directory === "") {
+            continue;
+        }
+        for (const extension of extensions) {
+            candidates.push(command.toLowerCase().endsWith(extension.toLowerCase())
+                ? join(directory, command)
+                : join(directory, `${command}${extension}`));
+        }
+    }
+    return candidates;
+}
+function isExecutable(path) {
+    try {
+        accessSync(path, constants.X_OK);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function findFirstExecutableToken(tokens) {
+    let index = 0;
+    while (index < tokens.length && ENV_ASSIGNMENT_PATTERN.test(tokens[index])) {
+        index += 1;
+    }
+    while (index < tokens.length) {
+        const token = tokens[index];
+        if (token === "sudo") {
+            index = skipSudo(tokens, index + 1);
+            continue;
+        }
+        if (token === "env") {
+            index = skipEnv(tokens, index + 1);
+            continue;
+        }
+        if (ENV_ASSIGNMENT_PATTERN.test(token)) {
+            index += 1;
+            continue;
+        }
+        return token;
+    }
+    return undefined;
+}
+function skipSudo(tokens, startIndex) {
+    let index = startIndex;
+    while (index < tokens.length && tokens[index].startsWith("-")) {
+        index += 1;
+    }
+    return index;
+}
+function skipEnv(tokens, startIndex) {
+    let index = startIndex;
+    while (index < tokens.length) {
+        const token = tokens[index];
+        if (ENV_ASSIGNMENT_PATTERN.test(token)) {
+            index += 1;
+            continue;
+        }
+        if (token.startsWith("-")) {
+            index += 1;
+            if ((token === "-u" || token === "--unset") && index < tokens.length) {
+                index += 1;
+            }
+            continue;
+        }
+        return index;
+    }
+    return index;
+}
+function tokenizeShellPrefix(commandText) {
+    const tokens = [];
+    let current = "";
+    let quote;
+    for (let index = 0; index < commandText.length; index += 1) {
+        const character = commandText[index];
+        if (quote !== undefined) {
+            if (character === quote) {
+                quote = undefined;
+            }
+            else if (character === "\\" && quote === '"' && index + 1 < commandText.length) {
+                index += 1;
+                current += commandText[index];
+            }
+            else {
+                current += character;
+            }
+            continue;
+        }
+        if (character === '"' || character === "'") {
+            quote = character;
+            continue;
+        }
+        if (character === "\\") {
+            if (index + 1 >= commandText.length) {
+                return undefined;
+            }
+            index += 1;
+            current += commandText[index];
+            continue;
+        }
+        if (/\s/.test(character)) {
+            if (current !== "") {
+                tokens.push(current);
+                current = "";
+            }
+            continue;
+        }
+        if (isShellControlOperator(character)) {
+            if (current !== "") {
+                tokens.push(current);
+            }
+            break;
+        }
+        current += character;
+    }
+    if (quote !== undefined) {
+        return undefined;
+    }
+    if (current !== "") {
+        tokens.push(current);
+    }
+    return tokens;
+}
+function isShellControlOperator(character) {
+    return (character === "|" ||
+        character === ";" ||
+        character === "&" ||
+        character === "(" ||
+        character === ")");
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@unscientificjszhai/howto",
+  "version": "1.0.0-alpha.2",
+  "type": "module",
+  "description": "Use AI to quickly find commands within the terminal.",
+  "main": "dist/index.js",
+  "bin": {
+    "howto": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "format": "prettier . --write",
+    "format:check": "prettier . --check",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "lint:staged": "lint-staged",
+    "prepare": "husky",
+    "test": "npm run test:unit",
+    "test:unit": "tsc -p tsconfig.test.json && node --test dist-test/tests/unit/*.test.js dist-test/tests/unit/**/*.test.js"
+  },
+  "dependencies": {
+    "@google/genai": "^1.0.0",
+    "@inquirer/prompts": "^7.0.0",
+    "ink": "^7.0.3",
+    "openai": "^4.0.0",
+    "react": "^19.2.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "eslint": "^10.4.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "prettier": "^3.8.3",
+    "typescript": "^5.5.3",
+    "typescript-eslint": "^8.59.4"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{js,json,md,yml,yaml}": "prettier --write"
+  }
+}