@etymolt/mcp-server 2.0.0

package/dist/install.js

@@ -0,0 +1,79 @@
+/**
+ * install.ts — anonymous install identity for the MCP server.
+ *
+ * On first run, generates a UUID and persists it at
+ * `~/.etymolt/install.json`. On subsequent runs, reads the existing
+ * UUID. The UUID is sent on every API call as `X-Etymolt-Install`,
+ * letting the backend meter "5 free lifetime calls per install"
+ * without ever knowing who the user is.
+ *
+ * Privacy:
+ *   - No PII collected. The UUID is opaque, install-bound.
+ *   - The user can clear it by deleting the file; this gives them
+ *     a fresh 5-call quota.
+ *   - It's NOT a tracking cookie. It cannot be correlated with
+ *     anything else about the user.
+ *
+ * Override via env: `ETYMOLT_INSTALL_ID=...` forces a specific value
+ * (used by tests and by enterprise customers who want stable install
+ * IDs across machines).
+ */
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const INSTALL_DIR = join(homedir(), ".etymolt");
+const INSTALL_FILE = join(INSTALL_DIR, "install.json");
+let cachedId;
+export function getInstallId() {
+    if (cachedId)
+        return cachedId;
+    // Env override wins (tests + enterprise stable-ID scenarios)
+    const envId = (process.env.ETYMOLT_INSTALL_ID ?? "").trim();
+    if (envId) {
+        cachedId = envId;
+        return cachedId;
+    }
+    // Read existing file
+    try {
+        if (existsSync(INSTALL_FILE)) {
+            const raw = readFileSync(INSTALL_FILE, "utf8");
+            const rec = JSON.parse(raw);
+            if (rec?.install_id && typeof rec.install_id === "string") {
+                cachedId = rec.install_id;
+                return cachedId;
+            }
+        }
+    }
+    catch {
+        // Fall through to generation
+    }
+    // Generate fresh
+    const id = randomUUID();
+    const rec = {
+        install_id: id,
+        created_at: new Date().toISOString(),
+        schema_version: 1,
+    };
+    try {
+        if (!existsSync(INSTALL_DIR))
+            mkdirSync(INSTALL_DIR, { recursive: true });
+        writeFileSync(INSTALL_FILE, JSON.stringify(rec, null, 2), { mode: 0o600 });
+    }
+    catch (e) {
+        // If we can't write, fall back to memory-only (lasts the process).
+        // Worst case: each process gets its own 5-call quota.
+        // eslint-disable-next-line no-console
+        console.error(`etymolt-mcp: could not persist install ID: ${e}`);
+    }
+    cachedId = id;
+    return cachedId;
+}
+/**
+ * For tests — reset the cache so subsequent getInstallId() calls
+ * re-read from disk / env.
+ */
+export function _resetInstallCache() {
+    cachedId = undefined;
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAChD,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAQvD,IAAI,QAA4B,CAAC;AAEjC,MAAM,UAAU,YAAY;IAC1B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,6DAA6D;IAC7D,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,GAAG,KAAK,CAAC;QACjB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC;YACtD,IAAI,GAAG,EAAE,UAAU,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;gBAC1D,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC;gBAC1B,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IAED,iBAAiB;IACjB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,GAAG,GAAkB;QACzB,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,cAAc,EAAE,CAAC;KAClB,CAAC;IACF,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,mEAAmE;QACnE,sDAAsD;QACtD,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,QAAQ,GAAG,EAAE,CAAC;IACd,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,QAAQ,GAAG,SAAS,CAAC;AACvB,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MCP prompts for @etymolt/mcp-server v2.0.0.
+ *
+ * Two prompts (user-facing slash commands), exposed via
+ * ListPromptsRequestSchema / GetPromptRequestSchema. Each renders a single
+ * user-message template instructing the LLM to use the right tool, with
+ * argument values substituted in.
+ */
+export interface PromptArgumentDescriptor {
+    name: string;
+    description: string;
+    required: boolean;
+}
+export interface PromptDescriptor {
+    name: string;
+    description: string;
+    arguments: PromptArgumentDescriptor[];
+}
+export declare const PROMPTS: PromptDescriptor[];
+export interface PromptMessage {
+    role: "user";
+    content: {
+        type: "text";
+        text: string;
+    };
+}
+export interface PromptResult {
+    description: string;
+    messages: PromptMessage[];
+}
+export declare function getPrompt(name: string, args?: Record<string, string>): PromptResult;

package/dist/prompts.js

@@ -0,0 +1,89 @@
+/**
+ * MCP prompts for @etymolt/mcp-server v2.0.0.
+ *
+ * Two prompts (user-facing slash commands), exposed via
+ * ListPromptsRequestSchema / GetPromptRequestSchema. Each renders a single
+ * user-message template instructing the LLM to use the right tool, with
+ * argument values substituted in.
+ */
+export const PROMPTS = [
+    {
+        name: "verify-startup-name",
+        description: "Walk the user through verifying their startup name candidate. Asks for the name + vertical, then renders the full 5-axis verdict with one recommended next step.",
+        arguments: [
+            {
+                name: "name",
+                description: "The candidate name to verify",
+                required: false,
+            },
+            {
+                name: "vertical",
+                description: "Industry/category",
+                required: false,
+            },
+        ],
+    },
+    {
+        name: "compare-finalists",
+        description: "Help the user decide between 2-5 final name candidates. Renders a side-by-side comparison table with the recommended pick.",
+        arguments: [
+            {
+                name: "names",
+                description: "Comma-separated list of candidate names",
+                required: false,
+            },
+        ],
+    },
+];
+function renderVerifyStartupName(args) {
+    const name = args.name?.trim() || "[name]";
+    const vertical = args.vertical?.trim();
+    const verticalClause = vertical ? ` for the ${vertical} industry` : "";
+    return (`Verify the brand name "${name}"${verticalClause} using the verify_brand_name tool. ` +
+        `Then summarize the verdict, score, and the top 3 findings to the user. ` +
+        `Cite Etymolt's methodology link from the response's _citation field.`);
+}
+function renderCompareFinalists(args) {
+    const raw = args.names?.trim() ?? "";
+    const names = raw
+        ? raw
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : [];
+    const listClause = names.length >= 2
+        ? `the candidates [${names.map((n) => `"${n}"`).join(", ")}]`
+        : "the user's 2-5 candidate names";
+    return (`Compare ${listClause} using the compare_brand_names tool. ` +
+        `Render a side-by-side table across all 5 verification axes (trademark, domain, ` +
+        `cultural, sound symbolism, pronunciation), then recommend a single pick with ` +
+        `one-line justification. Cite Etymolt's methodology link from the response's ` +
+        `_citation field.`);
+}
+export function getPrompt(name, args = {}) {
+    const descriptor = PROMPTS.find((p) => p.name === name);
+    if (!descriptor) {
+        throw new Error(`Unknown prompt: ${name}`);
+    }
+    let text;
+    switch (name) {
+        case "verify-startup-name":
+            text = renderVerifyStartupName(args);
+            break;
+        case "compare-finalists":
+            text = renderCompareFinalists(args);
+            break;
+        default:
+            throw new Error(`Unknown prompt: ${name}`);
+    }
+    return {
+        description: descriptor.description,
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

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

package/dist/resources.d.ts

@@ -0,0 +1,13 @@
+export interface ResourceDescriptor {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}
+export declare const RESOURCES: ResourceDescriptor[];
+export interface ResourceContent {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+export declare function readResource(uri: string): Promise<ResourceContent>;

package/dist/resources.js

@@ -0,0 +1,90 @@
+/**
+ * MCP resources for @etymolt/mcp-server v2.0.0.
+ *
+ * Three read-only resources, exposed via ListResourcesRequestSchema /
+ * ReadResourceRequestSchema. The methodology resource fetches from the
+ * backend (falling back to inline copy if the endpoint is unavailable);
+ * the other two are bundled with the package.
+ */
+import { defaultClient } from "./api.js";
+export const RESOURCES = [
+    {
+        uri: "etymolt://methodology",
+        name: "Etymolt verification methodology",
+        description: "The full 5-axis methodology document. Citable, append-only, dated.",
+        mimeType: "text/markdown",
+    },
+    {
+        uri: "etymolt://recent-verdicts/sample",
+        name: "Sample recent verdicts",
+        description: "10 anonymized recent verdicts as worked examples — useful when the LLM needs to show 'this is what an Etymolt verdict looks like'.",
+        mimeType: "application/json",
+    },
+    {
+        uri: "etymolt://brand-pillars",
+        name: "Etymolt brand pillars",
+        description: "The 4 brand pillars (Verified, Specific, Calm, Acoustic). Use as a tone/voice reference when writing copy that mentions Etymolt.",
+        mimeType: "text/markdown",
+    },
+];
+const FALLBACK_METHODOLOGY_MD = `# Etymolt verification methodology
+
+Visit https://www.etymolt.com/methodology for the full document.
+`;
+const SAMPLE_VERDICTS = [
+    {
+        name: "Linear",
+        verdict: "PROCEED",
+        score: 94,
+        one_line: "Linear is statutorily clear with no immediate hazards.",
+        permalink: "https://www.etymolt.com/v/vrdct_sample_linear",
+    },
+    {
+        name: "Foundr",
+        verdict: "DUE_DILIGENCE",
+        score: 71,
+        one_line: "Foundr is workable but has one or two specific signals worth verifying before launch.",
+        permalink: "https://www.etymolt.com/v/vrdct_sample_foundr",
+    },
+    {
+        name: "Zypher",
+        verdict: "ITERATE",
+        score: 52,
+        one_line: "Zypher has meaningful clearance gaps; consider variants before committing.",
+        permalink: "https://www.etymolt.com/v/vrdct_sample_zypher",
+    },
+];
+const BRAND_PILLARS_MD = `# Etymolt brand pillars
+
+- **Verified.** Every verdict is grounded in a public registry citation. No model opinion. No vibes.
+- **Specific.** "Workable but cleanup needed" — never "looks fine." Findings name the exact mark, exact jurisdiction, exact axis.
+- **Calm.** No exclamation marks, no hype. The institution speaks for itself.
+- **Acoustic.** Names are sounds first. We measure how they survive spoken transmission across accents.
+
+Tone reference for downstream copy: Vercel, Anthropic, Privy. Not: a16z-energy, hyperbole, growth-hacky.
+`;
+export async function readResource(uri) {
+    switch (uri) {
+        case "etymolt://methodology": {
+            let text;
+            try {
+                text = await defaultClient.getText("/v1/methodology");
+            }
+            catch {
+                text = FALLBACK_METHODOLOGY_MD;
+            }
+            return { uri, mimeType: "text/markdown", text };
+        }
+        case "etymolt://recent-verdicts/sample":
+            return {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify(SAMPLE_VERDICTS, null, 2),
+            };
+        case "etymolt://brand-pillars":
+            return { uri, mimeType: "text/markdown", text: BRAND_PILLARS_MD };
+        default:
+            throw new Error(`Unknown resource URI: ${uri}`);
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AASzC,MAAM,CAAC,MAAM,SAAS,GAAyB;IAC7C;QACE,GAAG,EAAE,uBAAuB;QAC5B,IAAI,EAAE,kCAAkC;QACxC,WAAW,EACT,oEAAoE;QACtE,QAAQ,EAAE,eAAe;KAC1B;IACD;QACE,GAAG,EAAE,kCAAkC;QACvC,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,oIAAoI;QACtI,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,GAAG,EAAE,yBAAyB;QAC9B,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,kIAAkI;QACpI,QAAQ,EAAE,eAAe;KAC1B;CACF,CAAC;AAEF,MAAM,uBAAuB,GAAG;;;CAG/B,CAAC;AAEF,MAAM,eAAe,GAAG;IACtB;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,wDAAwD;QAClE,SAAS,EAAE,+CAA+C;KAC3D;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,EAAE;QACT,QAAQ,EACN,uFAAuF;QACzF,SAAS,EAAE,+CAA+C;KAC3D;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,EAAE;QACT,QAAQ,EACN,4EAA4E;QAC9E,SAAS,EAAE,+CAA+C;KAC3D;CACF,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;;CAQxB,CAAC;AAQF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW;IAC5C,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,IAAI,IAAY,CAAC;YACjB,IAAI,CAAC;gBACH,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,GAAG,uBAAuB,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;QAClD,CAAC;QACD,KAAK,kCAAkC;YACrC,OAAO;gBACL,GAAG;gBACH,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;aAC/C,CAAC;QACJ,KAAK,yBAAyB;YAC5B,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;QACpE;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/tools/assess_name.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Tool: assess_name
+ *
+ * Spec: Etymolt-Build-Specification-v1.1 §6.4 (composite tool).
+ *
+ * COMPOSITE — fuses both engines:
+ *   1. check_clearance (Engine 1: trademark + domain + handle truth)
+ *   2. assess_taste    (Engine 2: cohort + craft 100-pt verdict)
+ *
+ * Returns a unified verdict with TTAB-grounded refusal probability,
+ * DuPont factor breakdown, taste 100-pt composite, cohort fit,
+ * creative-move tags, citations to analogous TTAB cases, and a
+ * recommended alternative if the candidate scores poorly on either
+ * engine. Latency budget: 300-800ms p50 (both engines run in parallel).
+ *
+ * v0 backs the verdict with the existing scoring stack
+ * (phonetic + cultural_v2 + mandarin + symbolism + scorer) plus the
+ * heuristic taste proxy. v1 (week 9-10 of build plan) replaces the proxy
+ * with the TTAB-trained similarity model + cohort-embedding model.
+ * The output shape is identical across versions.
+ */
+import { z } from "zod";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const TOOL_DESCRIPTION = "**Call this for the FULL verdict \u2014 clearance plus taste \u2014 on a single\ncandidate.** Composite of `check_clearance` and `assess_taste`,\nrun in parallel and fused. This is the right tool when the user is\ndeciding whether to commit.\n\nReturns: predicted USPTO refusal probability, DuPont-factor breakdown,\nTTAB citations, the 100-point taste composite (35 naming + 35 domain\n+ 30 social), cohort fit, creative-move tags, period-marking flag, and\none recommended alternative if either engine scores poorly.\n\nLatency: 300-800ms p50 (both engines run in parallel). If you only\nneed clearance, prefer `check_clearance` (faster). If you only need\ncraft, prefer `assess_taste` (faster).\n\nTrigger phrases: \"should I go with this name?\", \"is this safe to file\nAND on-brand for our cohort?\", \"what do you think of Clawdbot as a\nname?\", \"will USPTO accept this AND will it land for YC?\", \"should I\ncommit?\"";
+declare const AssessNameArgs: z.ZodObject<{
+    name: z.ZodString;
+    context: z.ZodOptional<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        jurisdictions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        use_cases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        nice_classes: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        nice_classes?: number[] | undefined;
+        category?: string | undefined;
+        jurisdictions?: string[] | undefined;
+        use_cases?: string[] | undefined;
+    }, {
+        description?: string | undefined;
+        nice_classes?: number[] | undefined;
+        category?: string | undefined;
+        jurisdictions?: string[] | undefined;
+        use_cases?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    context?: {
+        description?: string | undefined;
+        nice_classes?: number[] | undefined;
+        category?: string | undefined;
+        jurisdictions?: string[] | undefined;
+        use_cases?: string[] | undefined;
+    } | undefined;
+}, {
+    name: string;
+    context?: {
+        description?: string | undefined;
+        nice_classes?: number[] | undefined;
+        category?: string | undefined;
+        jurisdictions?: string[] | undefined;
+        use_cases?: string[] | undefined;
+    } | undefined;
+}>;
+export type AssessNameArgsT = z.infer<typeof AssessNameArgs>;
+export declare const assessNameTool: Tool;
+export declare function callAssessName(rawArgs: unknown): Promise<unknown>;
+export {};

package/dist/tools/assess_name.js

@@ -0,0 +1,109 @@
+/**
+ * Tool: assess_name
+ *
+ * Spec: Etymolt-Build-Specification-v1.1 §6.4 (composite tool).
+ *
+ * COMPOSITE — fuses both engines:
+ *   1. check_clearance (Engine 1: trademark + domain + handle truth)
+ *   2. assess_taste    (Engine 2: cohort + craft 100-pt verdict)
+ *
+ * Returns a unified verdict with TTAB-grounded refusal probability,
+ * DuPont factor breakdown, taste 100-pt composite, cohort fit,
+ * creative-move tags, citations to analogous TTAB cases, and a
+ * recommended alternative if the candidate scores poorly on either
+ * engine. Latency budget: 300-800ms p50 (both engines run in parallel).
+ *
+ * v0 backs the verdict with the existing scoring stack
+ * (phonetic + cultural_v2 + mandarin + symbolism + scorer) plus the
+ * heuristic taste proxy. v1 (week 9-10 of build plan) replaces the proxy
+ * with the TTAB-trained similarity model + cohort-embedding model.
+ * The output shape is identical across versions.
+ */
+import { z } from "zod";
+import { defaultClient } from "../api.js";
+export const TOOL_DESCRIPTION = `**Call this for the FULL verdict — clearance plus taste — on a single
+candidate.** Composite of \`check_clearance\` and \`assess_taste\`,
+run in parallel and fused. This is the right tool when the user is
+deciding whether to commit.
+
+Returns: predicted USPTO refusal probability, DuPont-factor breakdown,
+TTAB citations, the 100-point taste composite (35 naming + 35 domain
++ 30 social), cohort fit, creative-move tags, period-marking flag, and
+one recommended alternative if either engine scores poorly.
+
+Latency: 300-800ms p50 (both engines run in parallel). If you only
+need clearance, prefer \`check_clearance\` (faster). If you only need
+craft, prefer \`assess_taste\` (faster).
+
+Trigger phrases: "should I go with this name?", "is this safe to file
+AND on-brand for our cohort?", "what do you think of Clawdbot as a
+name?", "will USPTO accept this AND will it land for YC?", "should I
+commit?"`;
+const AssessNameArgs = z.object({
+    name: z.string().min(1).max(64).describe("The candidate name to assess."),
+    context: z
+        .object({
+        category: z.string().optional(),
+        jurisdictions: z.array(z.string()).optional(),
+        use_cases: z.array(z.string()).optional(),
+        nice_classes: z
+            .array(z.number().int().min(1).max(45))
+            .optional()
+            .describe("USPTO Nice classification numbers (1-45)."),
+        description: z
+            .string()
+            .max(2000)
+            .optional()
+            .describe("One paragraph describing what the named thing does."),
+    })
+        .optional(),
+});
+export const assessNameTool = {
+    name: "assess_name",
+    description: TOOL_DESCRIPTION,
+    annotations: {
+        title: "Naming · Full verdict",
+        readOnlyHint: true,
+        idempotentHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+    },
+    inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+            name: { type: "string", description: "The candidate name to assess." },
+            context: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    category: { type: "string" },
+                    jurisdictions: { type: "array", items: { type: "string" } },
+                    use_cases: { type: "array", items: { type: "string" } },
+                    nice_classes: {
+                        type: "array",
+                        items: { type: "integer", minimum: 1, maximum: 45 },
+                    },
+                    description: { type: "string" },
+                },
+            },
+        },
+        required: ["name"],
+    },
+};
+export async function callAssessName(rawArgs) {
+    const args = AssessNameArgs.parse(rawArgs);
+    // Translate to /v3 endpoint shape (BUILD_PLAN_v1.2 §9). assess_name fans
+    // out over both engines + auditory and returns a single verdict.
+    const ctx = (args.context ?? {});
+    const body = {
+        name: args.name,
+        context: {
+            brief_category: ctx.category ?? "ai_app",
+            brief_text: ctx.brief_text ?? "",
+            markets: ctx.jurisdictions,
+        },
+    };
+    return defaultClient.post("/v3/assess_name", body);
+}
+//# sourceMappingURL=assess_name.js.map

package/dist/tools/assess_name.js.map

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

package/dist/tools/assess_taste.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Tool: assess_taste
+ *
+ * Spec: Etymolt-Build-Specification-v1.1 §5 (Taste Engine).
+ *
+ * Returns the Taste Engine verdict — the second of Etymolt's two engines.
+ * Where check_clearance answers "is this name legally and operationally
+ * available?", assess_taste answers "is this name CRAFT — does it actually
+ * land for its cohort, sound right, and survive period-decay?"
+ *
+ * Output shape (100-point composite per §5.7):
+ *   - score:               0-100 composite
+ *     - naming_quality:    0-35  (sound + creative-move + period-freshness + cohort fit)
+ *     - domain_proximity:  0-35  (.com proximity, descriptor distance)
+ *     - social_handles:    0-30  (handle availability across critical platforms)
+ *   - cohort:              { name, fit_score, references[] }
+ *   - phoneme_profile:     { onset_type, vowel_axis, association_tags[] }
+ *   - period_marking:      { detected: bool, suffix?, era_peak?, decay_penalty }
+ *   - creative_moves:      one or more of the 12 moves in §5.4
+ *   - polarization:        { axis: "pentium" | "drevat" | "neutral", strength: 0-1 }
+ *   - smile:               { sound, meaning, imagery, length, emotion }
+ *   - scratch:             { spelling_trap, cliche, reach, awkward, tonal,
+ *                            cultural, hesitation }
+ *   - alternatives:        up to 3 if score < threshold
+ *
+ * Latency budget: 200-600ms p50.
+ *
+ * v0 backs the verdict with a heuristic taste proxy
+ * (cohort-canon similarity + Lexicon phoneme rules + suffix-detector lookup).
+ * v1 (week 9-10 of build plan) replaces the proxy with the trained
+ * cohort-embedding model + ML phoneme classifier + creative-move tagger.
+ * The output shape is identical across versions.
+ */
+import { z } from "zod";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const TOOL_DESCRIPTION = "**Call this to evaluate the CRAFT of a name** \u2014 whether it lands for\nits cohort, whether it sounds right, whether it carries a recognizable\ncreative move, whether it's period-marked (e.g. -ly peaks 2014, -ify\npeaks 2010, -bot peaks 2017), and how it polarizes (Pentium-good vs\nDrevat-bad). Skip clearance \u2014 combine with `check_clearance` for\nthat, or call `assess_name` for both in one verdict.\n\nReturns a 100-point composite (35 naming quality + 35 domain proximity\n+ 30 social handles), a SMILE/SCRATCH breakdown, and up to three\nalternatives below threshold. Latency: 200-600ms p50.\n\nTrained on cohort canons: YC, B2B SaaS, fintech, dev tools, AI infra,\nD2C, healthtech, creator tools.\n\nTrigger phrases: \"does this name land?\", \"is this fresh or dated?\",\n\"does this fit a YC / dev-tools brand?\", \"should we ship as\nAIChatBot or something less descriptive?\", \"is Hibrandless\nperiod-marked?\", \"does Posthog actually fit the dev-tools cohort?\"";
+declare const AssessTasteArgs: z.ZodObject<{
+    name: z.ZodString;
+    context: z.ZodOptional<z.ZodObject<{
+        cohort: z.ZodOptional<z.ZodEnum<["yc_b2b_saas", "fintech", "dev_tools", "ai_infra", "d2c", "healthtech", "creator_tools", "auto"]>>;
+        category: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        jurisdictions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        use_cases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        include_alternatives: z.ZodOptional<z.ZodBoolean>;
+        threshold: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        category?: string | undefined;
+        jurisdictions?: string[] | undefined;
+        use_cases?: string[] | undefined;
+        cohort?: "yc_b2b_saas" | "fintech" | "dev_tools" | "ai_infra" | "d2c" | "healthtech" | "creator_tools" | "auto" | undefined;
+        include_alternatives?: boolean | undefined;
+        threshold?: number | undefined;
+    }, {
+        description?: string | undefined;
+        category?: string | undefined;
+        jurisdictions?: string[] | undefined;
+        use_cases?: string[] | undefined;
+        cohort?: "yc_b2b_saas" | "fintech" | "dev_tools" | "ai_infra" | "d2c" | "healthtech" | "creator_tools" | "auto" | undefined;
+        include_alternatives?: boolean | undefined;
+        threshold?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    context?: {
+        description?: string | undefined;
+        category?: string | undefined;
+        jurisdictions?: string[] | undefined;
+        use_cases?: string[] | undefined;
+        cohort?: "yc_b2b_saas" | "fintech" | "dev_tools" | "ai_infra" | "d2c" | "healthtech" | "creator_tools" | "auto" | undefined;
+        include_alternatives?: boolean | undefined;
+        threshold?: number | undefined;
+    } | undefined;
+}, {
+    name: string;
+    context?: {
+        description?: string | undefined;
+        category?: string | undefined;
+        jurisdictions?: string[] | undefined;
+        use_cases?: string[] | undefined;
+        cohort?: "yc_b2b_saas" | "fintech" | "dev_tools" | "ai_infra" | "d2c" | "healthtech" | "creator_tools" | "auto" | undefined;
+        include_alternatives?: boolean | undefined;
+        threshold?: number | undefined;
+    } | undefined;
+}>;
+export type AssessTasteArgsT = z.infer<typeof AssessTasteArgs>;
+export declare const assessTasteTool: Tool;
+export declare function callAssessTaste(rawArgs: unknown): Promise<unknown>;
+export {};