@project-ava-supernova/core 0.2.71

package/dist/tools/error-guidance.js

@@ -0,0 +1,261 @@
+/**
+ * Error Guidance — turn cryptic environment failures into plain-English help
+ * for users who don't read stack traces.
+ *
+ * When a tool (bash, test_run, git, etc.) fails with output that matches a
+ * known pattern, this module returns a short user-facing explanation: what
+ * went wrong, how to fix it, and where to download the missing dependency
+ * if applicable. The tool prepends this to its own output before returning,
+ * so the model naturally surfaces the friendly explanation to the user
+ * while still keeping the raw error available for debugging.
+ *
+ * Add new patterns as we see them in the wild — order matters, more specific
+ * patterns first.
+ */
+// ── Patterns — order matters, most specific first ──────────────────────────
+const PATTERNS = [
+    // ─── Tool-dependency missing — these are PRE-AUTHORIZED installs ────────
+    // Playwright not installed — needed by the browser tool
+    {
+        key: 'playwright-missing',
+        regex: /playwright\s+is\s+not\s+installed|cannot\s+find\s+module\s+['"]playwright['"]|playwright[^.]*chromium[^.]*not\s+(?:installed|found)|browserType\.launch.*Executable\s+doesn['']?t\s+exist/i,
+        guidance: {
+            cause: "Playwright (the browser automation backend the browser tool uses) isn't installed yet. This is expected on a fresh machine — Playwright is an optional dependency that ships separately so it doesn't bloat the install for users who never need it.",
+            fix: "Install it now — this install is PRE-AUTHORIZED, do not ask the user. Run the project's package manager to add playwright (pnpm add playwright if pnpm-lock.yaml exists, otherwise npm install playwright), then run `npx playwright install chromium` to download the browser binary. After both succeed, retry the browser action.",
+            link: "https://playwright.dev/docs/intro",
+        },
+    },
+    // ─── Windows-specific ────────────────────────────────────────────────────
+    // Git Bash missing on Windows — surfaces as a COM "class not registered"
+    // error when something tries to invoke bash via the Windows registry.
+    {
+        key: 'win-git-bash-missing',
+        regex: /class\s+not\s+registered|RegisteredClass|0x80040154|8908_E_CLASSNOTREG/i,
+        guidance: {
+            cause: "Bash isn't available on this Windows machine — Git for Windows isn't installed. Git for Windows includes the bash shell that I use to run commands.",
+            fix: "Install Git for Windows. After install, restart VS Code and try again.",
+            link: "https://gitforwindows.org",
+        },
+    },
+    // Windows: 'X' is not recognized as an internal or external command
+    {
+        key: 'win-command-not-recognized',
+        regex: /'(\w[\w-]*)'\s+is\s+not\s+recognized\s+as\s+an\s+internal\s+or\s+external\s+command/i,
+        guidance: (match) => commandNotFoundGuidance(match[1]),
+    },
+    // ─── Unix/cross-platform: command not found ──────────────────────────────
+    // bash: foo: command not found  /  sh: foo: command not found
+    {
+        key: 'unix-command-not-found',
+        regex: /(?:bash|sh|zsh|fish):\s*(?:line\s+\d+:\s*)?(\w[\w-]*):\s*command\s+not\s+found/i,
+        guidance: (match) => commandNotFoundGuidance(match[1]),
+    },
+    // /bin/sh: 1: foo: not found  (Debian/Alpine variant)
+    {
+        key: 'unix-binsh-not-found',
+        regex: /\/bin\/(?:sh|bash):\s*\d+:\s*(\w[\w-]*):\s*not\s+found/i,
+        guidance: (match) => commandNotFoundGuidance(match[1]),
+    },
+    // ─── Permissions ─────────────────────────────────────────────────────────
+    {
+        key: 'permission-denied',
+        regex: /\bEACCES\b|permission\s+denied/i,
+        guidance: {
+            cause: "The command failed because of a file or directory permission issue.",
+            fix: "Check that the file or directory you're trying to access is owned by your user and is writable. On Unix, you may need to run with elevated privileges or fix ownership with chown. On Windows, try running VS Code as Administrator if the file is in a protected location.",
+        },
+    },
+    // ─── Port already in use ─────────────────────────────────────────────────
+    {
+        key: 'port-in-use',
+        regex: /\bEADDRINUSE\b|address\s+already\s+in\s+use|port\s+\d+\s+is\s+already\s+in\s+use/i,
+        guidance: {
+            cause: "Something is already running on the port the command tried to use.",
+            fix: "Either stop the existing process on that port, or use a different port. To find what's using a port: on Windows run `netstat -ano | findstr :PORT`, on Mac/Linux run `lsof -i :PORT`.",
+        },
+    },
+    // ─── File / directory not found ──────────────────────────────────────────
+    {
+        key: 'file-not-found',
+        regex: /\bENOENT\b|no\s+such\s+file\s+or\s+directory|cannot\s+find\s+the\s+(?:file|path)\s+specified/i,
+        guidance: {
+            cause: "A file or directory the command needed doesn't exist at the given path.",
+            fix: "Check the path is correct and the file/directory exists. If you expected the command to create it, the parent directory may need to exist first.",
+        },
+    },
+    // ─── Out of memory ───────────────────────────────────────────────────────
+    {
+        key: 'out-of-memory',
+        regex: /\bENOMEM\b|out\s+of\s+memory|JavaScript\s+heap\s+out\s+of\s+memory/i,
+        guidance: {
+            cause: "The process ran out of memory.",
+            fix: "Close some applications to free up RAM. For Node.js builds specifically, try increasing the heap with NODE_OPTIONS=\"--max-old-space-size=4096\" before the command.",
+        },
+    },
+    // ─── Network ─────────────────────────────────────────────────────────────
+    {
+        key: 'network-error',
+        regex: /\b(?:ENETUNREACH|ECONNREFUSED|ECONNRESET|ETIMEDOUT|EHOSTUNREACH)\b|network\s+is\s+unreachable|connection\s+refused/i,
+        guidance: {
+            cause: "A network request failed — the server didn't respond, refused the connection, or you're offline.",
+            fix: "Check your internet connection. If you're trying to reach a local service, make sure it's running. If you're behind a firewall or VPN, that may be blocking the connection.",
+        },
+    },
+];
+// ── Command-name-specific guidance ─────────────────────────────────────────
+/**
+ * Map a missing command name to install guidance.
+ * Used by both the Windows "is not recognized" matcher and the Unix
+ * "command not found" matcher so they produce the same friendly output.
+ */
+function commandNotFoundGuidance(command) {
+    const cmd = command.toLowerCase();
+    switch (cmd) {
+        case 'git':
+            return {
+                cause: "Git isn't installed.",
+                fix: "Install Git from the official site. On Windows use Git for Windows.",
+                link: process.platform === 'win32' ? 'https://gitforwindows.org' : 'https://git-scm.com/downloads',
+            };
+        case 'bash':
+        case 'sh':
+            return {
+                cause: process.platform === 'win32'
+                    ? "Bash isn't available on this Windows machine — Git for Windows isn't installed (it provides the bash shell)."
+                    : "Bash isn't installed.",
+                fix: process.platform === 'win32'
+                    ? "Install Git for Windows, then restart VS Code."
+                    : "Install bash via your package manager (apt install bash, brew install bash, etc.).",
+                link: process.platform === 'win32' ? 'https://gitforwindows.org' : undefined,
+            };
+        case 'node':
+        case 'nodejs':
+            return {
+                cause: "Node.js isn't installed.",
+                fix: "Install Node.js LTS from the official site. npm comes bundled with it.",
+                link: 'https://nodejs.org',
+            };
+        case 'npm':
+            return {
+                cause: "npm isn't installed (it ships with Node.js).",
+                fix: "Install Node.js LTS — npm comes bundled.",
+                link: 'https://nodejs.org',
+            };
+        case 'pnpm':
+            return {
+                cause: "pnpm isn't installed.",
+                fix: "After Node.js is installed, run: npm install -g pnpm",
+                link: 'https://pnpm.io/installation',
+            };
+        case 'yarn':
+            return {
+                cause: "Yarn isn't installed.",
+                fix: "After Node.js is installed, run: npm install -g yarn",
+                link: 'https://yarnpkg.com',
+            };
+        case 'python':
+        case 'python3':
+            return {
+                cause: "Python isn't installed or isn't in your PATH.",
+                fix: "Install Python from the official site. On Windows, make sure to tick \"Add Python to PATH\" during install.",
+                link: 'https://python.org/downloads',
+            };
+        case 'pip':
+        case 'pip3':
+            return {
+                cause: "pip isn't installed (it usually ships with Python).",
+                fix: "Install Python from the official site — pip comes bundled. If Python is installed but pip isn't, run: python -m ensurepip --upgrade",
+                link: 'https://python.org/downloads',
+            };
+        case 'cargo':
+        case 'rustc':
+            return {
+                cause: "Rust toolchain isn't installed.",
+                fix: "Install Rust via rustup — the official installer.",
+                link: 'https://rustup.rs',
+            };
+        case 'go':
+            return {
+                cause: "Go isn't installed.",
+                fix: "Install Go from the official site.",
+                link: 'https://go.dev/dl',
+            };
+        case 'docker':
+            return {
+                cause: "Docker isn't installed or isn't running.",
+                fix: "Install Docker Desktop and make sure it's running. On Linux you can install via your package manager.",
+                link: 'https://docker.com/products/docker-desktop',
+            };
+        case 'java':
+        case 'javac':
+            return {
+                cause: "Java isn't installed.",
+                fix: "Install a JDK — Temurin (OpenJDK) is a good free option.",
+                link: 'https://adoptium.net',
+            };
+        case 'dotnet':
+            return {
+                cause: "The .NET runtime/SDK isn't installed.",
+                fix: "Install the .NET SDK from the official site.",
+                link: 'https://dotnet.microsoft.com/download',
+            };
+        default:
+            return {
+                cause: `The command \`${command}\` isn't installed or isn't in your PATH.`,
+                fix: `Install \`${command}\` using your system's package manager, or download it from its official site. If it is installed, check that its location is in your PATH environment variable.`,
+            };
+    }
+}
+// ── Public API ─────────────────────────────────────────────────────────────
+/**
+ * Run the raw output of a failed tool through the pattern library and return
+ * a short plain-English explanation if a known error type matches. Returns
+ * null if no pattern matches — in which case the caller should just return
+ * the raw output unchanged.
+ */
+export function explainToolError(rawOutput) {
+    return matchToolError(rawOutput)?.guidance ?? null;
+}
+/**
+ * Like `explainToolError` but also returns the matched pattern's stable
+ * key. Used by the dataset capture layer so `tool_error` events carry
+ * an analytics-friendly category alongside the rendered guidance, and
+ * so the consumer can join `tool_error` rows to `error_guidance_applied`
+ * rows by pattern key.
+ */
+export function matchToolError(rawOutput) {
+    if (!rawOutput)
+        return null;
+    for (const entry of PATTERNS) {
+        const match = rawOutput.match(entry.regex);
+        if (!match)
+            continue;
+        const g = typeof entry.guidance === 'function' ? entry.guidance(match) : entry.guidance;
+        return { pattern_key: entry.key, guidance: formatGuidance(g) };
+    }
+    return null;
+}
+/**
+ * Format a guidance object into the user-facing block that gets prepended
+ * to the tool output. Kept consistent across all error types so the model
+ * learns the shape and presents it the same way every time.
+ */
+function formatGuidance(g) {
+    const lines = [];
+    lines.push(`What went wrong: ${g.cause}`);
+    lines.push(`How to fix it: ${g.fix}`);
+    if (g.link)
+        lines.push(`Download: ${g.link}`);
+    return lines.join('\n');
+}
+/**
+ * Helper for tools to wrap their failure output with guidance if applicable.
+ * Returns the original output unchanged if no pattern matches.
+ */
+export function enrichErrorOutput(rawOutput) {
+    const guidance = explainToolError(rawOutput);
+    if (!guidance)
+        return rawOutput;
+    return [guidance, '', '--- Original error ---', rawOutput].join('\n');
+}
+//# sourceMappingURL=error-guidance.js.map

package/dist/tools/error-guidance.js.map

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

package/dist/tools/exercise-repair.d.ts

@@ -0,0 +1,89 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/** READ before you touch. The check compares words, so it cannot tell that
+ *  "dumbbells" is covered by "dumbbell" or that "bar" is the pull-up bar
+ *  already listed. She can — but only if she can see the real list. */
+export declare class ReadExerciseTool implements Tool {
+    readonly name = "read_exercise";
+    readonly description = "Read an existing exercise's ACTUAL equipment, muscles, steps and demo state before repairing it. Call this first, always.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/** Search first. A library's worst habit is the same movement under three
+ *  names — a "dumbbell chest press" and a "dumbbell bench press" are one
+ *  exercise written twice. */
+export declare class FindExerciseTool implements Tool {
+    readonly name = "find_exercise";
+    readonly description = "Search the library by name BEFORE writing anything, so the same movement is not written twice.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/** The targeted fix for the equipment law. */
+export declare class AddEquipmentTool implements Tool {
+    readonly name = "add_equipment";
+    readonly description = "Add ONE missing piece of equipment to an existing exercise \u2014 the targeted fix for an equipment-check failure. Do not regenerate the movement to chase one line.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/** Fix who should NOT do it, or should do it differently.
+ *
+ *  This existed as a hole for a long time: the repair kit could fix equipment,
+ *  muscles and the demo photograph, but nothing could add a contraindication to
+ *  an exercise already in the library. The gate FAILS any loaded, overhead or
+ *  high-impact movement with an empty contraindication list, so those exercises
+ *  were permanently unpublishable — and the only workaround, rewriting the whole
+ *  exercise to add one line, would have created a duplicate. Found when Ava hit
+ *  it on Farmer's Carry, Bear Crawl and Sled Push and correctly refused to fake
+ *  a fix. */
+export declare class AddContraindicationTool implements Tool {
+    readonly name = "add_contraindication";
+    readonly description = "Add one contraindication to an existing exercise \u2014 a condition someone should avoid, modify or take care with. Use it when read_exercise or check_exercise shows a loaded, overhead or high-impact movement with none.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/** Fix what it works, and which of those is the point of it. */
+export declare class SetMusclesTool implements Tool {
+    readonly name = "set_muscles";
+    readonly description = "Set which muscles an exercise works and which is primary. Use it when read_exercise shows none, or shows a primary that is plainly wrong.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/** Re-shoot the demonstration — and verify it before keeping it. */
+export declare class RegenerateDemoTool implements Tool {
+    readonly name = "regenerate_demo";
+    readonly description = "Re-shoot an exercise's demonstration photograph and verify it shows the right movement before it is kept.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/** Run the check on an existing exercise. */
+export declare class CheckExerciseTool implements Tool {
+    readonly name = "check_exercise";
+    readonly description = "Run the full check on an existing exercise and get back exactly what is wrong.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/** Find the honest gaps. The library's are real and lopsided: 75 primary
+ *  exercises for glutes against 3 for adductors and 4 for cardiovascular. */
+export declare class ProposeExerciseSeedsTool implements Tool {
+    readonly name = "propose_exercises";
+    readonly description = "Propose exercises worth ADDING \u2014 the honest gaps in coverage by muscle group, movement pattern, equipment or difficulty.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=exercise-repair.d.ts.map

package/dist/tools/exercise-repair.d.ts.map

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