@stratta/mcp 1.20.0 → 1.21.0

package/README.md

@@ -333,9 +333,11 @@ contents to depth 2, code URL-encoded, e.g. `stratta://norm/SIA%20267/toc`),
 `stratta://skills/{name}` (one skill as Markdown, the office version when there
 is one). The same five are served by the remote connector.
 
-Three prompts appear as slash commands in clients that support them:
-`investigate-question` (question, project?), `resume-dossier` (name) and
-`check-value` (value, norm?).
+Four prompts appear as slash commands in clients that support them, on the
+local and the remote server alike: `investigate-question` (question,
+project?), `resume-dossier` (name), `check-value` (value, norm?) and
+`apply-method` (task, project?), which follows the method your office wrote
+for the task.
 
 For depositing your own documents, see the bundled **`ingest-norm` skill** —
 a 2-phase hybrid pipeline (since 0.4.0): a Python pre-pass

package/dist/index.js

@@ -18,6 +18,7 @@ import { SESSION_ID, usageDigest } from './usage.js';
 import { SERVER_INSTRUCTIONS } from './tools/catalog.gen.js';
 import { registerResources } from './resources.js';
 import { registerPrompts } from './prompts.js';
+import { claudeMeta } from './tools/claude-meta.gen.js';
 import { TOOLSET_CHOICE } from './mode.js';
 import { toolInChoice } from './tools/toolsets.gen.js';
 /**
@@ -124,6 +125,8 @@ for (const def of [
         description: def.description,
         inputSchema: def.inputSchema,
         annotations: def.annotations,
+        // Claude Code keeps the norm reader loaded and takes a long clause whole.
+        _meta: claudeMeta(def.name),
     }, 
     // The SDK validates `args` against `inputSchema` before this runs, so the
     // handler receives values that already match the declared shape.

package/dist/prompts.d.ts

@@ -1,4 +1,11 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type PromptEntry } from './tools/catalog.gen.js';
-export declare function renderPrompt(p: PromptEntry, args: Record<string, unknown>): string;
+/**
+ * Prompts: the ways a user starts a conversation with Stratta, as slash
+ * commands in the clients that support them (Claude Code, Claude Desktop,
+ * Cursor). The remote server serves the same ones (`convex/mcpPrompts.ts`).
+ *
+ * Text and arguments come from the catalogue, so a wording change is made
+ * once. `{{arg}}` is filled with the argument; an `optional` line is appended
+ * only when its argument was given.
+ */
 export declare function registerPrompts(server: McpServer): void;

package/dist/prompts.js

@@ -1,31 +1,21 @@
 import { z } from 'zod';
-import { PROMPTS } from './tools/catalog.gen.js';
+import { PROMPTS, renderPrompt } from './tools/catalog.gen.js';
 import { choiceHas } from './tools/toolsets.gen.js';
 import { TOOLSET_CHOICE } from './mode.js';
 /**
- * Prompts: the three ways a user starts a conversation with Stratta, as
- * slash commands in the clients that support them (Claude Code, Claude
- * Desktop, Cursor). stdio only: the remote gateway does not carry prompts yet.
+ * Prompts: the ways a user starts a conversation with Stratta, as slash
+ * commands in the clients that support them (Claude Code, Claude Desktop,
+ * Cursor). The remote server serves the same ones (`convex/mcpPrompts.ts`).
  *
  * Text and arguments come from the catalogue, so a wording change is made
  * once. `{{arg}}` is filled with the argument; an `optional` line is appended
  * only when its argument was given.
  */
-const fill = (template, args) => template.replace(/\{\{(\w+)\}\}/g, (_match, key) => String(args[key] ?? ''));
-export function renderPrompt(p, args) {
-    let text = fill(p.text, args);
-    for (const [arg, line] of Object.entries(p.optional ?? {})) {
-        if (args[arg])
-            text += `\n${fill(line, args)}`;
-    }
-    return text;
-}
 export function registerPrompts(server) {
     for (const p of PROMPTS) {
         // A prompt that drives dossier tools is not offered without them.
-        if (p.name === 'resume-dossier' && !choiceHas(TOOLSET_CHOICE, 'dossiers')) {
+        if (p.needs && !choiceHas(TOOLSET_CHOICE, p.needs))
             continue;
-        }
         const shape = {};
         for (const a of p.args) {
             const s = z.string().describe(a.description);

package/dist/tools/catalog.gen.d.ts

@@ -1,3 +1,4 @@
+import type { Toolset } from './toolsets.gen.js';
 export type Transport = 'stdio' | 'remote';
 export type ToolAnnotations = {
     readOnlyHint: boolean;
@@ -13,7 +14,7 @@ export type CatalogEntry = {
     transports: Transport[];
     params: Record<string, string>;
 };
-export declare const SERVER_INSTRUCTIONS = "Stratta serves the norms and reference documents of the signed-in organization (technical standards, laws, ordinances, regulations, accounting standards, internal references), and only those. Call `get_methodology` before the first substantive question of a conversation: it carries the navigation order, the citation rules and the dossier policy. A question these documents are meant to settle is answered from them, not from memory; a norm absent from `list_norms` cannot be read.";
+export declare const SERVER_INSTRUCTIONS = "Stratta serves the norms and reference documents of the signed-in organization (technical standards, laws, ordinances, regulations, accounting standards, internal references), and only those. `get_methodology` returns how these documents are organized, how one is walked down to a clause and how a passage is cited; it is meant for the start of a conversation that relies on them. A norm absent from `list_norms` is not readable here.";
 export declare const CATALOG: CatalogEntry[];
 export type PromptArg = {
     name: string;
@@ -27,8 +28,11 @@ export type PromptEntry = {
     args: PromptArg[];
     text: string;
     optional?: Record<string, string>;
+    needs?: Toolset;
 };
 export declare const PROMPTS: PromptEntry[];
 export declare function catalogEntry(name: string): CatalogEntry;
+/** The message a prompt starts the conversation with, arguments filled in. */
+export declare function renderPrompt(p: PromptEntry, args: Record<string, unknown>): string;
 /** Description of one parameter, as the catalogue words it. */
 export declare function param(tool: string, name: string): string;

package/dist/tools/catalog.gen.js

@@ -1,11 +1,11 @@
 // Generated by scripts/build-mcp-catalog.mjs from convex/mcpCatalog.ts.
 // Do not edit: change the source and run the script.
-export const SERVER_INSTRUCTIONS = "Stratta serves the norms and reference documents of the signed-in organization (technical standards, laws, ordinances, regulations, accounting standards, internal references), and only those. Call `get_methodology` before the first substantive question of a conversation: it carries the navigation order, the citation rules and the dossier policy. A question these documents are meant to settle is answered from them, not from memory; a norm absent from `list_norms` cannot be read.";
+export const SERVER_INSTRUCTIONS = "Stratta serves the norms and reference documents of the signed-in organization (technical standards, laws, ordinances, regulations, accounting standards, internal references), and only those. `get_methodology` returns how these documents are organized, how one is walked down to a clause and how a passage is cited; it is meant for the start of a conversation that relies on them. A norm absent from `list_norms` is not readable here.";
 export const CATALOG = [
     {
         "name": "get_methodology",
         "title": "Working method",
-        "description": "Read the working contract this server expects an agent to follow: how to walk a norm from its table of contents down to a clause, how to cite what it reads, and when to record something in a project dossier. Use this at the start of a conversation that will rely on the documents of the organization; its rules hold for the rest of that conversation.",
+        "description": "Return the conventions of this server: how a norm is walked from its table of contents down to a clause, how a passage is cited, and what a project dossier records. Use this at the start of a conversation that will rely on the documents of the organization.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -267,7 +267,7 @@ export const CATALOG = [
     {
         "name": "get_boreholes",
         "title": "Read the boreholes of a site",
-        "description": "Read the boreholes a site scan found, nearest first, with their logged strata (depth interval, description, period), depth, year, SIA 261 ground class when logged, water table when logged, and links to the cantonal documents. Call it after get_site_context when the question turns on what the ground is actually made of. Each borehole is one observation at one point: quote it with its distance, never interpolate between two of them, and never derive a design value from a layer description.",
+        "description": "Read the boreholes a site scan found, nearest first, with their logged strata (depth interval, description, period), depth, year, SIA 261 ground class when logged, water table when logged, and links to the cantonal documents. Call it after get_site_context when the question turns on what the ground is actually made of. Each borehole is one observation at one point, at the distance given; the ground between two boreholes and the design values of a layer are not in this data.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -287,7 +287,7 @@ export const CATALOG = [
     {
         "name": "get_site_context",
         "title": "Read a site scan",
-        "description": "Read what a site scan found, grouped by topic, each value with its source and the date THE DATA was current. Returns two separate lists: what the registers settled, and what they could NOT settle, with the reason. Report the second list to the user in full: it is what a bid has to budget for. Never derive a design value (friction angle, bearing capacity, modulus) from a geological description returned here; state what the register says and that a local investigation is required.",
+        "description": "Read what a site scan found, grouped by topic, each value with its source and the date THE DATA was current. Returns two separate lists: what the registers settled, and what they could NOT settle, with the reason; the second list is what a bid has to budget for. A geological description returned here is not a design value (friction angle, bearing capacity, modulus): those come from a local investigation.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -722,7 +722,7 @@ export const CATALOG = [
     {
         "name": "write_section",
         "title": "Write a section",
-        "description": "Write one section of a deliverable: the text as it would be printed, and what it rests on. Every sentence of substance must come from a source the section lists: a decision or piece of evidence of the dossier (kind entry, ref the entry id), a fact of the site (kind fact, ref the fact key such as groundwater.level), a clause read in a norm (kind clause, ref the norm code and the section path as in \"SIA 267 s. 9.5.2\"), a page of an attachment (kind attachment, ref the id with #p12), or a reading recorded by the dossier (kind reading, ref the reading id). A section without a source is refused; when the dossier has nothing for it, pass gap true with a body that says what is missing, and the section is printed as something to establish. Replaces what the section held. Never invent a value: a section written from memory is worse than a gap.",
+        "description": "Write one section of a deliverable: the text as it would be printed, and what it rests on. Every sentence of substance must come from a source the section lists: a decision or piece of evidence of the dossier (kind entry, ref the entry id), a fact of the site (kind fact, ref the fact key such as groundwater.level), a clause read in a norm (kind clause, ref the norm code and the section path as in \"SIA 267 s. 9.5.2\"), a page of an attachment (kind attachment, ref the id with #p12), or a reading recorded by the dossier (kind reading, ref the reading id). A section without a source is refused; when the dossier has nothing for it, pass gap true with a body that says what is missing, and the section is printed as something to establish. Replaces what the section held.",
         "annotations": {
             "readOnlyHint": false,
             "destructiveHint": false,
@@ -979,7 +979,7 @@ export const CATALOG = [
     {
         "name": "update_entry",
         "title": "Correct an entry",
-        "description": "Correct a piece of evidence or a decision in place: its wording, its value, its confidence, or the citation (norm, section path, page, edition) when the wrong clause was cited. Pass only the fields to change; pass page null to clear it. The kind and the question do not change here (attach_entry moves an entry). Only when the user asked for the correction; never rewrite what a colleague wrote without saying so.",
+        "description": "Correct a piece of evidence or a decision in place: its wording, its value, its confidence, or the citation (norm, section path, page, edition) when the wrong clause was cited. Pass only the fields to change; pass page null to clear it. The kind and the question do not change here (attach_entry moves an entry). Use this when the user asks for the correction.",
         "annotations": {
             "readOnlyHint": false,
             "destructiveHint": false,
@@ -1260,7 +1260,8 @@ export const PROMPTS = [
                 "required": true
             }
         ],
-        "text": "Resume the project dossier \"{{name}}\": call list_dossiers, then load_dossier on the matching one. Summarise the open questions first, then the decisions taken with the clauses they rest on, then the evidence not yet filed. Do not re-decide what is decided. Ask which open question to work on next."
+        "text": "Resume the project dossier \"{{name}}\": call list_dossiers, then load_dossier on the matching one. Summarise the open questions first, then the decisions taken with the clauses they rest on, then the evidence not yet filed. Do not re-decide what is decided. Ask which open question to work on next.",
+        "needs": "dossiers"
     },
     {
         "name": "check-value",
@@ -1282,6 +1283,28 @@ export const PROMPTS = [
         "optional": {
             "norm": "Check against {{norm}} first."
         }
+    },
+    {
+        "name": "apply-method",
+        "title": "Do a task the way the office does it",
+        "description": "Carry out a task (a project basis, a verification note, a site chapter) by following the method the office has written for it.",
+        "args": [
+            {
+                "name": "task",
+                "description": "What to produce, e.g. \"the project basis for the retaining wall\".",
+                "required": true
+            },
+            {
+                "name": "project",
+                "description": "The project or dossier the task belongs to, if any.",
+                "required": false
+            }
+        ],
+        "text": "Do this task the way the office does it: {{task}}\n\nCall list_skills and pick the method that fits the task, then get_skill on it and follow its steps in order. If no method fits, say so, name the closest one, and ask before going on without one. Every value taken from a norm keeps its citation [CODE section path, p. N].",
+        "optional": {
+            "project": "The task belongs to the project \"{{project}}\": reload its dossier first (list_dossiers, then load_dossier) and work from what it already holds."
+        },
+        "needs": "dossiers"
     }
 ];
 export function catalogEntry(name) {
@@ -1290,6 +1313,16 @@ export function catalogEntry(name) {
         throw new Error(`No catalogue entry for tool "${name}"`);
     return entry;
 }
+const fill = (template, args) => template.replace(/\{\{(\w+)\}\}/g, (_match, key) => String(args[key] ?? ''));
+/** The message a prompt starts the conversation with, arguments filled in. */
+export function renderPrompt(p, args) {
+    let text = fill(p.text, args);
+    for (const [arg, line] of Object.entries(p.optional ?? {})) {
+        if (args[arg])
+            text += `\n${fill(line, args)}`;
+    }
+    return text;
+}
 /** Description of one parameter, as the catalogue words it. */
 export function param(tool, name) {
     const text = catalogEntry(tool).params[name];

package/dist/tools/claude-meta.gen.d.ts

@@ -0,0 +1,28 @@
+/**
+ * What Claude reads in a tool's `_meta`, on both transports.
+ *
+ * This module imports nothing: `scripts/build-mcp-catalog.mjs` copies it
+ * verbatim into the npm package (`claude-meta.gen.ts`), which is published
+ * alone and cannot import from here. A test holds the copy in step.
+ */
+/**
+ * The tools Claude Code keeps loaded instead of deferring them.
+ *
+ * Claude Code defers every MCP tool and finds them by search: only the tool
+ * names and the server instructions load when a session starts
+ * (code.claude.com/docs/en/mcp, « Scale with MCP tool search »). The norm
+ * reader is what every conversation starts with, so it stays at hand; three
+ * to five tools, as the guidance asks, or deferral buys nothing.
+ */
+export declare const ALWAYS_LOADED_TOOLS: ReadonlyArray<string>;
+/**
+ * The reads that may legitimately run long, and how long.
+ *
+ * Past 50 000 characters Claude Code writes a result to a file and hands the
+ * model a reference; a long clause with its tables is exactly that case, and
+ * the agent then cites a text it has not read. The value raises that
+ * threshold for the tool (ceiling 500 000).
+ */
+export declare const LARGE_RESULT_TOOLS: Readonly<Record<string, number>>;
+/** The `_meta` of a tool, or nothing; other hosts ignore the keys. */
+export declare function claudeMeta(name: string): Record<string, boolean | number> | undefined;

package/dist/tools/claude-meta.gen.js

@@ -0,0 +1,48 @@
+// Generated by scripts/build-mcp-catalog.mjs from convex/mcpClaudeMeta.ts.
+// Do not edit: change the source and run the script.
+/**
+ * What Claude reads in a tool's `_meta`, on both transports.
+ *
+ * This module imports nothing: `scripts/build-mcp-catalog.mjs` copies it
+ * verbatim into the npm package (`claude-meta.gen.ts`), which is published
+ * alone and cannot import from here. A test holds the copy in step.
+ */
+/**
+ * The tools Claude Code keeps loaded instead of deferring them.
+ *
+ * Claude Code defers every MCP tool and finds them by search: only the tool
+ * names and the server instructions load when a session starts
+ * (code.claude.com/docs/en/mcp, « Scale with MCP tool search »). The norm
+ * reader is what every conversation starts with, so it stays at hand; three
+ * to five tools, as the guidance asks, or deferral buys nothing.
+ */
+export const ALWAYS_LOADED_TOOLS = [
+    'get_methodology',
+    'list_norms',
+    'search_corpus',
+    'get_toc',
+    'get_section',
+];
+/**
+ * The reads that may legitimately run long, and how long.
+ *
+ * Past 50 000 characters Claude Code writes a result to a file and hands the
+ * model a reference; a long clause with its tables is exactly that case, and
+ * the agent then cites a text it has not read. The value raises that
+ * threshold for the tool (ceiling 500 000).
+ */
+export const LARGE_RESULT_TOOLS = {
+    get_section: 200_000,
+    get_subtree: 200_000,
+    read_attachment: 200_000,
+};
+/** The `_meta` of a tool, or nothing; other hosts ignore the keys. */
+export function claudeMeta(name) {
+    const meta = {};
+    if (ALWAYS_LOADED_TOOLS.includes(name))
+        meta['anthropic/alwaysLoad'] = true;
+    const chars = LARGE_RESULT_TOOLS[name];
+    if (chars !== undefined)
+        meta['anthropic/maxResultSizeChars'] = chars;
+    return Object.keys(meta).length > 0 ? meta : undefined;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stratta/mcp",
   "mcpName": "ch.stratta/mcp",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "MCP server exposing your organization’s norms and reference documents (standards, laws, regulations) to any MCP client, with exact citations, via Stratta TreeRAG.",
   "license": "UNLICENSED",
   "author": "SmartFlow <hello@stratta.ch>",
@@ -42,14 +42,14 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
     "convex": "^1.42.3",
-    "zod": "^4.0.0"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.12"
   },
   "engines": {
     "node": ">=20"