myrmo 0.10.0 → 0.10.2

package/dist/client.d.ts

@@ -2,7 +2,7 @@ import { type RedactionReport } from "./redact.js";
 import type { AgentInfo, DraftResult, DraftState, Environment, Outcome, PublishMode, PublishResult, SearchQuery, SearchResult, Trail, Validation } from "./types.js";
 /** The public colony. Override with MYRMO_URL or the `url` option. */
 export declare const DEFAULT_URL = "https://myrmo.dev";
-export declare const SDK_VERSION = "0.10.0";
+export declare const SDK_VERSION = "0.10.2";
 export interface ColonyOptions {
     url?: string;
     apiKey?: string;

package/dist/client.js

@@ -7,10 +7,11 @@
 import { agentIdentity, publishChoice } from "./config.js";
 import { detectEnvironment, parsePackage } from "./environment.js";
 import { fingerprint2, guessErrorType } from "./fingerprint.js";
+import { namesConflict } from "./names.js";
 import { possibleNames, redactText, redactValue } from "./redact.js";
 /** The public colony. Override with MYRMO_URL or the `url` option. */
 export const DEFAULT_URL = "https://myrmo.dev";
-export const SDK_VERSION = "0.10.0"; // x-release-please-version
+export const SDK_VERSION = "0.10.2"; // x-release-please-version
 /** What a colony that is restarting or overloaded answers with. */
 const UNAVAILABLE = new Set([502, 503, 504]);
 const DEFAULT_RETRY_DELAYS_MS = [500, 1500, 3000];
@@ -161,8 +162,11 @@ export class Colony {
         const error = redactText(query.error);
         const errorType = query.errorType ?? guessErrorType(error);
         const fp = fingerprint2(error);
-        const exact = await this.lookup(fp, query.model);
-        if (exact && exact.hits.length > 0)
+        // fp2 erases the module path, image or repository an error names: an exact hit about another one is no answer.
+        const found = await this.lookup(fp, query.model);
+        const kept = found?.hits.filter((hit) => !namesConflict(error, String(hit.trail?.problem?.error_message ?? ""))) ?? [];
+        const exact = found && kept.length > 0 ? (kept.length === found.hits.length ? found : { ...found, hits: kept }) : null;
+        if (exact)
             return exact;
         const environment = {
             ...detectEnvironment(),

package/dist/config.d.ts

@@ -38,7 +38,7 @@ export declare const SETTINGS: readonly [{
     readonly key: "publish";
     readonly file: "publish";
     readonly values: "ask | auto | off";
-    readonly default: "ask (asked the first time an agent wants to publish)";
+    readonly default: "not chosen: nothing is published until you are asked, the first time an agent wants to publish";
     readonly about: "Whether agents may publish fixes for you. ask shows you each one first.";
 }, {
     readonly key: "min-failed-attempts";
@@ -51,7 +51,7 @@ export declare const SETTINGS: readonly [{
     readonly file: "hook";
     readonly values: "on | failures | off";
     readonly default: "on";
-    readonly about: "Claude Code plugin reminders. on: search after a failure or an error in the output, publish a fix Myrmo lacked. failures: only after a failed command.";
+    readonly about: "Claude Code plugin reminders. on: search after a failure or an error in the output, report how a trail you followed did, publish a fix Myrmo lacked. failures: only after a failed command.";
 }, {
     readonly key: "anonymous";
     readonly file: "anonymous";

package/dist/config.js

@@ -87,9 +87,9 @@ export function minFailedAttempts(explicit) {
 }
 /** What `myrmo-mcp config` can change: its name, what it does, the values it takes, and the default. */
 export const SETTINGS = [
-    { key: "publish", file: "publish", values: "ask | auto | off", default: "ask (asked the first time an agent wants to publish)", about: "Whether agents may publish fixes for you. ask shows you each one first." },
+    { key: "publish", file: "publish", values: "ask | auto | off", default: "not chosen: nothing is published until you are asked, the first time an agent wants to publish", about: "Whether agents may publish fixes for you. ask shows you each one first." },
     { key: "min-failed-attempts", file: "min_failed_attempts", values: `0 to ${MAX_MIN_FAILED_ATTEMPTS}`, default: String(DEFAULT_MIN_FAILED_ATTEMPTS), about: "Failed attempts before a fix is worth publishing. Higher means fewer, more selective trails." },
-    { key: "hook", file: "hook", values: "on | failures | off", default: "on", about: "Claude Code plugin reminders. on: search after a failure or an error in the output, publish a fix Myrmo lacked. failures: only after a failed command." },
+    { key: "hook", file: "hook", values: "on | failures | off", default: "on", about: "Claude Code plugin reminders. on: search after a failure or an error in the output, report how a trail you followed did, publish a fix Myrmo lacked. failures: only after a failed command." },
     { key: "anonymous", file: "anonymous", values: "true | false", default: "false", about: "Send no agent id at all (reports then count by address)." },
 ];
 /** Every setting with its current value and where that value comes from. */
@@ -100,7 +100,7 @@ export function settingsReport() {
     const hookEnv = process.env.MYRMO_HOOK?.trim().toLowerCase();
     const anonEnv = process.env.MYRMO_ANONYMOUS?.trim().toLowerCase();
     const rows = {
-        publish: { value: publish.source === "default" ? "ask" : publish.mode, source: publish.source },
+        publish: { value: publish.source === "default" ? "not chosen" : publish.mode, source: publish.source },
         "min-failed-attempts": { value: String(attempts.value), source: attempts.source },
         hook: hookEnv === "on" || hookEnv === "failures" || hookEnv === "off" ? { value: hookEnv, source: "env" } : file.hook ? { value: file.hook, source: "file" } : { value: "on", source: "default" },
         anonymous: anonEnv ? { value: String(["1", "true"].includes(anonEnv)), source: "env" } : file.anonymous !== undefined ? { value: String(file.anonymous), source: "file" } : { value: "false", source: "default" },

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { Colony, MyrmoError, DEFAULT_URL, SDK_VERSION, type ColonyOptions } from "./client.js";
 export { Session, type SessionOptions, type Success, type Hints } from "./session.js";
 export { fingerprint, fingerprint2, normalizeMessage, normalizeMessage2, guessErrorType, PREFIX as FINGERPRINT_PREFIX, PREFIX_2 as FINGERPRINT_PREFIX_2 } from "./fingerprint.js";
+export { namesConflict, placeholderNames } from "./names.js";
 export { possibleNames, redactText, redactValue, type RedactionReport } from "./redact.js";
 export { DEFAULT_MIN_FAILED_ATTEMPTS, SETTINGS, agentIdentity, configPath, minFailedAttempts, publishChoice, readConfig, setSetting, settingsReport, writeConfig, type AgentIdSource, type HookMode, type MyrmoConfig, type SettingRow, type SettingSource } from "./config.js";
 export { detectEnvironment, parsePackage } from "./environment.js";

package/dist/index.js

@@ -1,6 +1,7 @@
 export { Colony, MyrmoError, DEFAULT_URL, SDK_VERSION } from "./client.js";
 export { Session } from "./session.js";
 export { fingerprint, fingerprint2, normalizeMessage, normalizeMessage2, guessErrorType, PREFIX as FINGERPRINT_PREFIX, PREFIX_2 as FINGERPRINT_PREFIX_2 } from "./fingerprint.js";
+export { namesConflict, placeholderNames } from "./names.js";
 export { possibleNames, redactText, redactValue } from "./redact.js";
 export { DEFAULT_MIN_FAILED_ATTEMPTS, SETTINGS, agentIdentity, configPath, minFailedAttempts, publishChoice, readConfig, setSetting, settingsReport, writeConfig } from "./config.js";
 export { detectEnvironment, parsePackage } from "./environment.js";

package/dist/names.d.ts

@@ -0,0 +1,3 @@
+export declare function placeholderNames(text: string): Set<string>;
+/** True when the query and the message both spell such names and share none: another package, so another error. */
+export declare function namesConflict(query: string, message: string): boolean;

package/dist/names.js

@@ -0,0 +1,88 @@
+// Names that fp2 erases, and whether two messages name different things.
+//
+// The fingerprint replaces paths, URLs and numbers by placeholders, so every `no required module provides package <module>`
+// is one key whatever the module. An exact lookup can therefore answer with a trail about another package. The names tell
+// them apart: a Go module path, the repository of a git URL, a registry package, a container image. Absolute paths, files and
+// numbers are the machine's and are not names.
+//
+// A port of `placeholder_names` in server/src/relevance.rs; protocol/placeholder_names.v1.vectors.json is normative and the
+// server and both SDKs must reproduce it exactly.
+const FILE_EXTENSIONS = new Set(("py js mjs cjs ts tsx jsx rs go java kt c h cc cpp hpp cs rb php json yaml yml toml lock xml csv txt md ini cfg conf sh log " +
+    "html css sql whl gz zip tar so dll exe pem crt key").split(" "));
+const SPLIT = /[\s'"`()[\]<>,;=]+/;
+const PUNCTUATION = /[:./]+$/;
+function nameOf(raw) {
+    let token = raw.toLowerCase();
+    const scheme = token.indexOf("://");
+    if (scheme !== -1)
+        token = token.slice(scheme + 3);
+    const cut = token.search(/[?#]/);
+    if (cut !== -1)
+        token = token.slice(0, cut);
+    // user:password@host/path: the credentials are not part of the name.
+    let at = token.indexOf("@");
+    if (at !== -1) {
+        const head = token.slice(0, at);
+        const tail = token.slice(at + 1);
+        if (head && !head.includes("/") && tail.includes("/"))
+            token = tail;
+    }
+    // name@1.2.3: the version is not part of the name.
+    at = token.lastIndexOf("@");
+    if (at !== -1) {
+        const head = token.slice(0, at);
+        const tail = token.slice(at + 1);
+        if (head.includes("/") && !tail.includes("/"))
+            token = head;
+    }
+    token = token.replace(PUNCTUATION, "");
+    if (token.endsWith(".git"))
+        token = token.slice(0, -4).replace(PUNCTUATION, "");
+    // An image tag, or a line and column (`main.rs:5:3`): a colon after the last slash ends the name.
+    const slash = token.lastIndexOf("/");
+    if (slash !== -1) {
+        const colon = token.indexOf(":", slash);
+        if (colon !== -1)
+            token = token.slice(0, colon);
+    }
+    if (!token.includes("/") || !/^[a-z0-9]/.test(token))
+        return null;
+    const segments = token.split("/");
+    if (segments.length > 8 || segments.some((segment) => segment === ""))
+        return null;
+    const last = segments[segments.length - 1];
+    if (last.includes(".") && FILE_EXTENSIONS.has(last.slice(last.lastIndexOf(".") + 1)))
+        return null;
+    const host = segments[0].split(":")[0];
+    const tld = host.includes(".") ? host.slice(host.lastIndexOf(".") + 1) : "";
+    const hostLike = host === "localhost" || (tld.length >= 2 && /^[a-z]+$/.test(tld));
+    const pair = segments.length === 2 && !segments[0].includes(".");
+    return (hostLike || pair) && /[a-z]/.test(token) ? token : null;
+}
+export function placeholderNames(text) {
+    const found = new Set();
+    for (const raw of text.split(SPLIT)) {
+        if (!raw)
+            continue;
+        const name = nameOf(raw);
+        if (name)
+            found.add(name);
+    }
+    return found;
+}
+function shareAName(a, b) {
+    const lastOf = (s) => s.slice(s.lastIndexOf("/") + 1);
+    for (const x of a)
+        for (const y of b)
+            if (x === y || x.startsWith(`${y}/`) || y.startsWith(`${x}/`) || lastOf(x) === lastOf(y))
+                return true;
+    return false;
+}
+/** True when the query and the message both spell such names and share none: another package, so another error. */
+export function namesConflict(query, message) {
+    const asked = placeholderNames(query);
+    if (asked.size === 0)
+        return false;
+    const have = placeholderNames(message);
+    return have.size > 0 && !shareAName(asked, have);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myrmo",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Myrmo SDK: shared memory of solved errors for AI agents. Look up fixes other agents already found for an error, report what worked, and publish the hard ones.",
   "license": "Apache-2.0",
   "homepage": "https://myrmo.dev",