patchwork-os 0.2.0-alpha.0

package/dist/probe.d.ts

@@ -0,0 +1,35 @@
+export interface ProbeResults {
+    rg: boolean;
+    fd: boolean;
+    git: boolean;
+    gh: boolean;
+    tsc: boolean;
+    eslint: boolean;
+    pyright: boolean;
+    ruff: boolean;
+    cargo: boolean;
+    go: boolean;
+    biome: boolean;
+    prettier: boolean;
+    black: boolean;
+    gofmt: boolean;
+    rustfmt: boolean;
+    vitest: boolean;
+    jest: boolean;
+    pytest: boolean;
+    codex: boolean;
+    universalCtags: boolean;
+    typescriptLanguageServer: boolean;
+    ant: boolean;
+}
+export declare function probeAll(workspace?: string): Promise<ProbeResults>;
+/**
+ * Resolve the executable path for a command.
+ * Returns the absolute local bin path when a workspace-local binary exists,
+ * otherwise returns the bare command name (resolved via system PATH).
+ *
+ * Use this in tool handlers instead of bare command names so that
+ * node_modules/.bin binaries (e.g. rg from @vscode/ripgrep) are invoked
+ * directly without needing them on the system PATH.
+ */
+export declare function resolveCommandPath(cmd: string, workspace: string): string;

package/dist/probe.js

@@ -0,0 +1,143 @@
+import { execFile } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const PROBE_TIMEOUT = 3000;
+async function probeCommand(cmd) {
+    const whichCmd = process.platform === "win32" ? "where" : "which";
+    try {
+        await execFileAsync(whichCmd, [cmd], {
+            timeout: PROBE_TIMEOUT,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check whether a command is available either on the global PATH or as a local
+ * node_modules/.bin binary inside the workspace.
+ *
+ * JS tooling (tsc, eslint, biome, prettier, vitest, jest) is almost always
+ * installed locally rather than globally in Node projects. Checking only the
+ * global PATH causes probes to report false for these tools on VPS / CI
+ * environments where nothing is installed globally, even though the workspace
+ * has a perfectly functional local binary.
+ */
+async function probeCommandWithLocalFallback(cmd, workspace) {
+    // 1. Check global PATH first (fast path for globally installed tools)
+    if (await probeCommand(cmd))
+        return true;
+    // 2. Fall back to workspace-local node_modules/.bin
+    const localBin = path.join(workspace, "node_modules", ".bin", cmd);
+    try {
+        const stat = fs.statSync(localBin);
+        // Must be a file or symlink that is executable
+        return stat.isFile() || stat.isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+/** JS-ecosystem tools that are commonly installed locally rather than globally. */
+const JS_LOCAL_TOOLS = new Set([
+    "tsc",
+    "eslint",
+    "biome",
+    "prettier",
+    "vitest",
+    "jest",
+    // ripgrep and fd-find ship pre-built binaries via npm packages
+    // (@vscode/ripgrep, fd-find) — check node_modules/.bin as fallback
+    "rg",
+    "fd",
+]);
+const COMMANDS = [
+    ["rg", "rg"],
+    ["fd", "fd"],
+    ["git", "git"],
+    ["gh", "gh"],
+    ["tsc", "tsc"],
+    ["eslint", "eslint"],
+    ["pyright", "pyright"],
+    ["ruff", "ruff"],
+    ["cargo", "cargo"],
+    ["go", "go"],
+    ["biome", "biome"],
+    ["prettier", "prettier"],
+    ["black", "black"],
+    ["gofmt", "gofmt"],
+    ["rustfmt", "rustfmt"],
+    ["vitest", "vitest"],
+    ["jest", "jest"],
+    ["pytest", "pytest"],
+    ["codex", "codex"],
+    // universalCtags and typescriptLanguageServer use custom probes below
+];
+/**
+ * Probe for Universal Ctags specifically.
+ * Exuberant Ctags (macOS /usr/bin/ctags, apt install ctags) does NOT support
+ * --output-format=json. We check `ctags --version` output for "Universal Ctags".
+ */
+async function probeUniversalCtags() {
+    try {
+        const { stdout } = await execFileAsync("ctags", ["--version"], {
+            timeout: PROBE_TIMEOUT,
+        });
+        return stdout.toLowerCase().includes("universal ctags");
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Probe for typescript-language-server (npm package).
+ * `tsc` in PATH does NOT imply typescript-language-server is installed.
+ */
+async function probeTypescriptLanguageServer() {
+    return probeCommand("typescript-language-server");
+}
+export async function probeAll(workspace = "") {
+    const entries = await Promise.all(COMMANDS.map(async ([key, cmd]) => {
+        const available = workspace && JS_LOCAL_TOOLS.has(cmd)
+            ? await probeCommandWithLocalFallback(cmd, workspace)
+            : await probeCommand(cmd);
+        return [key, available];
+    }));
+    const [universalCtags, typescriptLanguageServer, ant] = await Promise.all([
+        probeUniversalCtags(),
+        probeTypescriptLanguageServer(),
+        probeCommand("ant"),
+    ]);
+    const base = Object.fromEntries(entries);
+    base.universalCtags = universalCtags;
+    base.typescriptLanguageServer = typescriptLanguageServer;
+    base.ant = ant;
+    return base;
+}
+/**
+ * Resolve the executable path for a command.
+ * Returns the absolute local bin path when a workspace-local binary exists,
+ * otherwise returns the bare command name (resolved via system PATH).
+ *
+ * Use this in tool handlers instead of bare command names so that
+ * node_modules/.bin binaries (e.g. rg from @vscode/ripgrep) are invoked
+ * directly without needing them on the system PATH.
+ */
+export function resolveCommandPath(cmd, workspace) {
+    if (!workspace)
+        return cmd;
+    const localBin = path.join(workspace, "node_modules", ".bin", cmd);
+    try {
+        const stat = fs.statSync(localBin);
+        if (stat.isFile() || stat.isSymbolicLink())
+            return localBin;
+    }
+    catch {
+        // not present — fall through
+    }
+    return cmd;
+}
+//# sourceMappingURL=probe.js.map

package/dist/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"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"}

package/dist/prompts.d.ts

@@ -0,0 +1,27 @@
+export interface McpPromptArgument {
+    name: string;
+    description: string;
+    required?: boolean;
+}
+export interface McpPrompt {
+    name: string;
+    description: string;
+    arguments?: McpPromptArgument[];
+}
+export interface PromptMessage {
+    role: "user" | "assistant";
+    content: {
+        type: "text";
+        text: string;
+    };
+}
+export interface GetPromptResult {
+    description?: string;
+    messages: PromptMessage[];
+}
+export declare const PROMPTS: McpPrompt[];
+/**
+ * Retrieve a filled prompt template.
+ * Returns null if the name is unknown or a required argument is missing.
+ */
+export declare function getPrompt(name: string, args: Record<string, string>): GetPromptResult | null;