@extenshi/mcp 0.6.0 → 0.8.0

package/dist/docs.js

@@ -156,30 +156,175 @@ export function rankSections(full, query, limit) {
         .sort((a, b) => b.score - a.score);
     return scored.slice(0, Math.max(1, limit)).map((s) => s.section);
 }
-/** Keep each returned section bounded; large enough to hold a full docs page. */
-const MAX_SECTION_CHARS = 8000;
-function clampSection(body) {
-    if (body.length <= MAX_SECTION_CHARS)
-        return body;
-    return `${body.slice(0, MAX_SECTION_CHARS).trimEnd()}\n\n…(section truncated — open the source link for the rest)`;
+const SOURCE_LINE = /^\*Source:\s*(\S+?)\*\s*$/m;
+/** Split `llms-full.txt` into `##`-level passages, fence-aware, carrying the page source URL. */
+export function splitPassages(full) {
+    const passages = [];
+    const urlByTitle = new Map();
+    for (const section of splitSections(full)) {
+        // The export sometimes repeats a page's H1 after its source line; the
+        // repeat inherits the URL recorded for the same title.
+        const url = SOURCE_LINE.exec(section.body)?.[1] ?? urlByTitle.get(section.title);
+        if (url)
+            urlByTitle.set(section.title, url);
+        const body = section.body.replace(SOURCE_LINE, '').trim();
+        let heading;
+        let lines = [];
+        let inFence = false;
+        const flush = () => {
+            const text = lines.join('\n').trim();
+            if (text || heading)
+                passages.push({ page: section.title, heading, url, body: text });
+        };
+        for (const line of body.split('\n')) {
+            if (/^\s*```/.test(line))
+                inFence = !inFence;
+            const h2 = !inFence ? /^##\s+(.+)$/.exec(line) : null;
+            if (h2) {
+                flush();
+                heading = h2[1].trim();
+                lines = [];
+                continue;
+            }
+            lines.push(line);
+        }
+        flush();
+    }
+    return passages;
+}
+/** Passages returned from one page at most, so a single long page cannot crowd out the rest. */
+const MAX_PASSAGES_PER_PAGE = 2;
+/** BM25 parameters: term-frequency saturation and length normalisation. */
+const BM25_K1 = 1.2;
+const BM25_B = 0.75;
+function wordCounts(text) {
+    const counts = new Map();
+    for (const token of text.toLowerCase().split(/[^a-z0-9]+/)) {
+        if (token)
+            counts.set(token, (counts.get(token) ?? 0) + 1);
+    }
+    return counts;
+}
+/**
+ * Rank passages against a query with BM25 over passage bodies, so a long
+ * passage that merely repeats common words does not outrank a short one that
+ * answers the question. Heading and page-title matches add a bonus; hyphenated
+ * or long tokens (command and flag names) get a phrase boost. Pure (no I/O) so
+ * it is unit-testable with a fixture.
+ */
+export function rankPassages(full, query, limit) {
+    const { words, phrases } = tokenize(query);
+    if (words.length === 0)
+        return [];
+    const indexed = splitPassages(full).map((passage, index) => {
+        const body = passage.body.toLowerCase();
+        const tf = wordCounts(body);
+        let len = 0;
+        for (const n of tf.values())
+            len += n;
+        return {
+            passage,
+            index,
+            body,
+            heading: (passage.heading ?? '').toLowerCase(),
+            headingWords: wordCounts(passage.heading ?? ''),
+            pageWords: wordCounts(passage.page),
+            tf,
+            len,
+        };
+    });
+    if (indexed.length === 0)
+        return [];
+    const avgLen = indexed.reduce((sum, d) => sum + d.len, 0) / indexed.length || 1;
+    const n = indexed.length;
+    const idf = (df) => Math.log(1 + (n - df + 0.5) / (df + 0.5));
+    const saturate = (tf, len) => (tf * (BM25_K1 + 1)) / (tf + BM25_K1 * (1 - BM25_B + (BM25_B * len) / avgLen));
+    const wordIdf = new Map(words.map((w) => [w, idf(indexed.filter((d) => d.tf.has(w) || d.headingWords.has(w)).length)]));
+    const phraseIdf = new Map(phrases.map((p) => [p, idf(indexed.filter((d) => d.body.includes(p) || d.heading.includes(p)).length)]));
+    const scored = indexed
+        .map((d) => {
+        let score = 0;
+        for (const w of words) {
+            const weight = wordIdf.get(w) ?? 0;
+            const tf = d.tf.get(w) ?? 0;
+            if (tf > 0)
+                score += weight * saturate(tf, d.len);
+            if (d.headingWords.has(w))
+                score += weight * 2;
+            if (d.pageWords.has(w))
+                score += weight;
+        }
+        for (const p of phrases) {
+            const weight = phraseIdf.get(p) ?? 0;
+            const count = countOccurrences(d.body, p);
+            if (count > 0)
+                score += weight * 1.5 * saturate(count, d.len);
+            if (d.heading.includes(p))
+                score += weight * 3;
+        }
+        return { passage: d.passage, score, index: d.index };
+    })
+        .filter((s) => s.score > 0)
+        .sort((a, b) => b.score - a.score || a.index - b.index);
+    const perPage = new Map();
+    const picked = [];
+    for (const { passage } of scored) {
+        if (picked.length >= Math.max(1, limit))
+            break;
+        const seen = perPage.get(passage.page) ?? 0;
+        if (seen >= MAX_PASSAGES_PER_PAGE)
+            continue;
+        perPage.set(passage.page, seen + 1);
+        picked.push(passage);
+    }
+    return picked;
+}
+/** Default and bounds for the per-result excerpt length (characters). */
+export const DEFAULT_EXCERPT_CHARS = 1500;
+export const MIN_EXCERPT_CHARS = 200;
+export const MAX_EXCERPT_CHARS = 8000;
+/**
+ * Cut a passage to `maxChars` on a line boundary. An unterminated code fence is
+ * closed so the rest of the response still renders as prose.
+ */
+export function excerpt(body, maxChars) {
+    if (body.length <= maxChars)
+        return { text: body, truncated: false };
+    let cut = body.slice(0, maxChars);
+    const lastBreak = cut.lastIndexOf('\n');
+    if (lastBreak > maxChars / 2)
+        cut = cut.slice(0, lastBreak);
+    cut = cut.trimEnd();
+    const fences = cut.split('\n').filter((line) => /^\s*```/.test(line)).length;
+    if (fences % 2 === 1)
+        cut += '\n```';
+    return { text: cut, truncated: true };
 }
 /** Fetch the docs index (`llms.txt`) — the page list returned when no query is given. */
 export async function getDocsIndex(docsUrl) {
     return fetchCached(`${docsUrl}/llms.txt`);
 }
+/** Render ranked passages: page › heading, source URL, bounded excerpt. Pure. */
+export function renderPassages(query, matches, maxChars) {
+    if (matches.length === 0) {
+        return `No documentation passage matched "${query}". The full page index is returned when the query is omitted.`;
+    }
+    const blocks = matches.map((m) => {
+        const title = [m.page || 'Untitled', m.heading].filter(Boolean).join(' › ');
+        const { text, truncated } = excerpt(m.body, maxChars);
+        const source = m.url ? `Source: ${m.url}\n\n` : '';
+        const more = truncated ? `\n\n…(excerpt truncated${m.url ? `; full page: ${m.url}` : ''})` : '';
+        return `## ${title}\n${source}${text}${more}`;
+    });
+    return `Top ${matches.length} documentation passage(s) for "${query}":\n\n${blocks.join('\n\n---\n\n')}`;
+}
 /**
- * Search the docs and return a formatted, LLM-friendly answer: the top matching
- * sections, each with its source link. Falls back to a clear "nothing matched"
- * note pointing at the index.
+ * Search the docs and return the top matching passages, each with its source
+ * link and a bounded excerpt. Falls back to a "nothing matched" note.
  */
-export async function searchDocs(docsUrl, query, limit) {
+export async function searchDocs(docsUrl, query, options) {
     const full = await fetchCached(`${docsUrl}/llms-full.txt`);
-    const matches = rankSections(full, query, limit);
-    if (matches.length === 0) {
-        return (`No documentation section matched "${query}". ` +
-            'Call search_docs with no query to list every available page, then read the relevant one.');
-    }
-    const blocks = matches.map((m) => `## ${m.title || 'Untitled'}\n\n${clampSection(m.body)}`);
-    return `Top ${matches.length} documentation section(s) for "${query}":\n\n${blocks.join('\n\n---\n\n')}`;
+    const maxChars = Math.min(MAX_EXCERPT_CHARS, Math.max(MIN_EXCERPT_CHARS, options.maxChars ?? DEFAULT_EXCERPT_CHARS));
+    return renderPassages(query, rankPassages(full, query, options.limit), maxChars);
 }
 //# sourceMappingURL=docs.js.map

package/dist/docs.js.map

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

package/dist/icon-workflow.d.ts

@@ -1,11 +1,12 @@
 /**
  * Static content for the free `generate_icon_workflow` MCP tool.
  *
- * The free icon path deliberately spends ZERO Extenshi tokens and touches no
- * Extenshi infrastructure: the coding agent draws the SVG itself, and
+ * The free icon path spends ZERO Extenshi tokens and touches no Extenshi
+ * infrastructure: the SVG master is authored locally, and
  * `@extenshi/cli icon preview` renders the verification page fully offline.
- * This tool exists so an agent connected through the MCP connector gets the
- * exact requirements and commands instead of guessing them.
+ * The tool returns the icon specification and the exact commands as reference
+ * material — requirements, file formats and a process description — written so
+ * a developer could read it on its own.
  *
  * Kept as a template function (not a docs fetch) so the tool works without
  * network access and never fails on a docs outage.

package/dist/icon-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icon-workflow.d.ts","sourceRoot":"","sources":["../src/icon-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,gBAAgB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA0DjE"}
+{"version":3,"file":"icon-workflow.d.ts","sourceRoot":"","sources":["../src/icon-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,gBAAgB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA0DjE"}

package/dist/icon-workflow.js

@@ -1,11 +1,12 @@
 /**
  * Static content for the free `generate_icon_workflow` MCP tool.
  *
- * The free icon path deliberately spends ZERO Extenshi tokens and touches no
- * Extenshi infrastructure: the coding agent draws the SVG itself, and
+ * The free icon path spends ZERO Extenshi tokens and touches no Extenshi
+ * infrastructure: the SVG master is authored locally, and
  * `@extenshi/cli icon preview` renders the verification page fully offline.
- * This tool exists so an agent connected through the MCP connector gets the
- * exact requirements and commands instead of guessing them.
+ * The tool returns the icon specification and the exact commands as reference
+ * material — requirements, file formats and a process description — written so
+ * a developer could read it on its own.
  *
  * Kept as a template function (not a docs fetch) so the tool works without
  * network access and never fails on a docs outage.
@@ -13,44 +14,44 @@
 export function renderIconWorkflow(args) {
     const name = args.extensionName?.trim() || 'My Extension';
     const iconFile = 'icon.svg';
-    return `# Browser-extension icon — design requirements and local workflow
+    return `# Browser-extension icon — specification and local workflow
 
-This workflow is FREE and fully local: you (the agent) draw the SVG yourself, and the
+Cost and access: free and fully local. The SVG master is authored in the project, and the
 Extenshi CLI renders an offline verification page. No API key, no credits, no uploads.
 
-## Icon requirements (all stores: Chrome, Firefox, Edge)
+## Icon requirements (Chrome, Firefox, Edge)
 
 - Deliverables: PNG at 16, 32, 48 and 128 px (128 px is the store-listing size), plus the
   SVG master. Chrome Web Store also uses a 440×280 promo tile.
-- The 16 px toolbar render is what users see most. Design for it:
+- The 16 px toolbar render is the most-seen size, so the design targets it:
   - one bold silhouette, minimal interior detail, generous negative space;
-  - no text, no thin outlines (<1.5 px at 16 px they dissolve);
-  - keep ~1 px of breathing room to the edges (toolbar buttons crop nothing, but
+  - no text and no thin outlines (below 1.5 px at 16 px they dissolve);
+  - about 1 px of breathing room to the edges (toolbar buttons crop nothing, but
     adjacent icons sit 8–12 px away).
-- Must survive light AND dark toolbars: avoid mid-gray (#7a7a7a-ish) fills that melt
-  into both themes; prefer a saturated brand color or add a contrasting outline/backdrop shape.
-- Single \`<svg>\` element, square viewBox (e.g. \`viewBox="0 0 24 24"\` or \`0 0 128 128\`),
-  flat shapes, no embedded rasters, no scripts, no external references.
+- Legible on light AND dark toolbars: mid-gray fills (around #7a7a7a) melt into both
+  themes; a saturated brand color or a contrasting outline/backdrop shape holds up.
+- File format: a single \`<svg>\` element, square viewBox (e.g. \`viewBox="0 0 24 24"\` or
+  \`0 0 128 128\`), flat shapes, no embedded rasters, no scripts, no external references.
 
-## Workflow
+## Process
 
-1. **Draw the SVG yourself** — write it to \`${iconFile}\` in the project. Iterate on the
-   silhouette at conceptual 16 px scale before adding any detail.
+1. **Author the SVG master** — saved as \`${iconFile}\` in the project. The silhouette is
+   settled at conceptual 16 px scale before any detail is added.
 2. **Render the verification page** (free, offline):
 
    \`\`\`bash
    npx @extenshi/cli@latest icon preview ${iconFile} --name "${name}"
    \`\`\`
 
-   This writes a self-contained HTML file and opens it: Chrome / Firefox / Edge toolbar
-   mockups with the icon pinned in place, switchable palettes (light, tinted, dark, black,
-   saturated + a custom color picker) with an automatic contrast warning per palette, a
-   store-size matrix, and an 8× pixel magnifier of the 16 px render.
-3. **Ask the human to review the page.** Iterate: edit \`${iconFile}\`, re-run the command
-   (add \`--no-open\` on re-runs; the browser tab just needs a refresh).
-4. **Export** straight from the page buttons: per-size PNGs, or the ZIP containing
-   \`icons/{16,32,48,128}.png\`, the SVG master and \`manifest-icons.json\`; there is also a
-   copy-paste manifest snippet:
+   The command writes a self-contained HTML file and opens it: Chrome / Firefox / Edge
+   toolbar mockups with the icon pinned in place, switchable palettes (light, tinted, dark,
+   black, saturated, plus a custom color picker) with an automatic contrast warning per
+   palette, a store-size matrix, and an 8× pixel magnifier of the 16 px render.
+3. **Review and iterate.** The developer reviews the page; after each edit to \`${iconFile}\`
+   the same command re-renders it (\`--no-open\` on re-runs; refreshing the open tab is enough).
+4. **Export** from the page buttons: per-size PNGs, or a ZIP containing
+   \`icons/{16,32,48,128}.png\`, the SVG master and \`manifest-icons.json\`. The page also shows
+   this manifest snippet:
 
    \`\`\`json
    {
@@ -58,15 +59,15 @@ Extenshi CLI renders an offline verification page. No API key, no credits, no up
    	"action": { "default_icon": { "16": "icons/16.png", "32": "icons/32.png" } }
    }
    \`\`\`
-5. Unpack the exported \`icons/\` folder into the extension and reference it from
-   \`manifest.json\` as above.
+5. **Install** — the exported \`icons/\` folder is unpacked into the extension and referenced
+   from \`manifest.json\` as above.
 
 ## Related
 
-- Hosted AI icon generation (no local agent needed) lives at
-  https://dojo.extenshi.io/tools/icon-generator.
-- Uploading the finished icon into a dojo project is planned but not available yet —
-  do not look for an upload API.
+- Hosted AI icon generation (no local tooling needed): https://dojo.extenshi.io/tools/icon-generator
+- Uploading a finished icon into a dojo project is planned and not available yet; there is
+  no upload API.
+- Documentation: https://docs.extenshi.io/developers/icon-generator
 `;
 }
 //# sourceMappingURL=icon-workflow.js.map

package/dist/icon-workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"icon-workflow.js","sourceRoot":"","sources":["../src/icon-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,UAAU,kBAAkB,CAAC,IAAsB;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,cAAc,CAAA;IACzD,MAAM,QAAQ,GAAG,UAAU,CAAA;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;+CAqBuC,QAAQ;;;;;2CAKZ,QAAQ,YAAY,IAAI;;;;;;;2DAOR,QAAQ;;;;;;;;;;;;;;;;;;;;;CAqBlE,CAAA;AACD,CAAC"}
+{"version":3,"file":"icon-workflow.js","sourceRoot":"","sources":["../src/icon-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,UAAU,kBAAkB,CAAC,IAAsB;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,cAAc,CAAA;IACzD,MAAM,QAAQ,GAAG,UAAU,CAAA;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;4CAqBoC,QAAQ;;;;;2CAKT,QAAQ,YAAY,IAAI;;;;;;;kFAOe,QAAQ;;;;;;;;;;;;;;;;;;;;;CAqBzF,CAAA;AACD,CAAC"}

package/dist/localize-workflow.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Static reference for the free `localize_workflow` MCP tool: the local
+ * localization process, the translation-bundle file format and the release
+ * checks. Written as documentation a developer can read on its own — it
+ * describes the process and its constraints, it does not address the reader.
+ */
+export declare function renderLocalizeWorkflow(): string;
+//# sourceMappingURL=localize-workflow.d.ts.map

package/dist/localize-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localize-workflow.d.ts","sourceRoot":"","sources":["../src/localize-workflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAiG/C"}

package/dist/localize-workflow.js

@@ -0,0 +1,105 @@
+/**
+ * Static reference for the free `localize_workflow` MCP tool: the local
+ * localization process, the translation-bundle file format and the release
+ * checks. Written as documentation a developer can read on its own — it
+ * describes the process and its constraints, it does not address the reader.
+ */
+export function renderLocalizeWorkflow() {
+    return `# Local extension localization — reference
+
+Cost and access: free. No Extenshi credits and no API key. Translation happens with
+whichever translation provider the developer already uses; the Extenshi CLI prepares
+and validates the local files offline.
+
+## Availability
+
+The \`localize\` command ships in recent \`@extenshi/cli\` releases; \`extenshi localize --help\`
+shows whether the installed version includes it. A merged change is not the same as an
+npm release — the npm \`latest\` tag is the reference for what is installable. Inside the
+Extenshi repository the CLI is built with \`yarn workspace @extenshi/cli build\` and run as
+\`node tools/extenshi-cli/dist/cli.js\` from the repository root in place of \`extenshi\`.
+
+## Scope
+
+Input: \`manifest.json\` with \`default_locale\`, plus \`_locales/<default_locale>/messages.json\`.
+Covered: those messages, including the manifest name/description references.
+Not covered: full store descriptions and hardcoded UI strings — they need separate
+extraction and review.
+
+## Step 1 — Prepare
+
+\`\`\`bash
+extenshi localize prepare ./extension --lang fr,de,es --output ./localization --protect MyBrand
+\`\`\`
+
+Output: \`localization-request.json\`, listing missing, stale or untracked messages grouped
+by locale. Each run needs a fresh output directory; prepare does not overwrite an existing
+request. When \`localization.json\` supplies \`targetLocales\`, \`--lang\` is optional, and its
+\`protectedTerms\` are combined with \`--protect\`.
+
+The fields \`version\`, \`sourceLocale\`, the locale keys and \`sourceHashes\` are part of the
+contract and stay unchanged. Per-locale structure (the hash is illustrative; the real
+prepared hash is kept):
+
+\`\`\`json
+{
+  "version": 1,
+  "sourceLocale": "en",
+  "locales": {
+    "fr": {
+      "sourceHashes": { "greeting": "<prepared SHA-256>" },
+      "messages": { "greeting": { "message": "Hello", "description": "Greeting in popup" } }
+    }
+  }
+}
+\`\`\`
+
+## Step 2 — Translate and review
+
+Translation rules:
+
+- Only message text is translated into each target language.
+- Keys, placeholder names and definitions, positional substitutions, escaped dollar signs
+  and protected terms are preserved exactly.
+- Descriptions stay as translator context.
+- Copy reflects the actual product: no new features, guarantees or marketing claims.
+
+The edited bundle is saved as \`./localization/translations.json\`. A \`removeKeys\` array, when
+present, lists translations whose source keys were deleted; it is preserved and reviewed
+together with the translated messages. A removal-only locale has empty \`messages\` and
+\`sourceHashes\` objects and still carries the review marker.
+
+Review covers meaning, tone, brand spelling and truthful claims. Each reviewed locale object
+gets \`"reviewed": true\` next to \`sourceHashes\` and \`messages\`; apply rejects a locale without
+this marker. Source hashes detect source edits made while translation was in progress — when
+the source changed, a fresh prepare and re-translation of the changed entries is required.
+
+## Step 3 — Apply and validate
+
+\`\`\`bash
+extenshi localize apply ./extension --translations ./localization/translations.json --protect MyBrand
+extenshi localize check ./extension --protect MyBrand
+\`\`\`
+
+Apply validates the bundle before it updates \`_locales\`. \`.extenshi-localization.json\` belongs
+in the project: it records source and reviewed target hashes for incremental updates. Direct
+edits to target files require re-review, and changed source messages require a new prepare.
+Validation errors (placeholders, protected terms, listing risks) are resolved in the copy;
+they are not bypassed to reach a passing result.
+
+## Release checks
+
+- \`review-risk\` runs for every target locale (exact syntax: the installed CLI's help); listing
+  risks are resolved against the real build and the reports are kept.
+- A fluent reviewer inspects the copy, full store descriptions and screenshots.
+- The packaged extension is loaded under each target language: popup/options, long strings,
+  truncation and keyboard accessibility. Arabic/Hebrew additionally need RTL direction,
+  layout and mixed text/number checks — a locale file or a passing CLI check does not prove
+  RTL UI support.
+- Every browser artifact is rebuilt and checked. Publication stays within the developer's
+  authorization.
+
+Documentation: https://docs.extenshi.io/developers/localization
+`;
+}
+//# sourceMappingURL=localize-workflow.js.map

package/dist/localize-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localize-workflow.js","sourceRoot":"","sources":["../src/localize-workflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB;IACrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FP,CAAA;AACD,CAAC"}