@stratta/mcp 1.18.1 → 1.19.0

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

@@ -13,7 +13,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. Never answer from memory a question these documents are meant to settle; 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. 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 CATALOG: CatalogEntry[];
 export type PromptArg = {
     name: 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. Never answer from memory a question these documents are meant to settle; 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. 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 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. Call it once, before the first technical answer of a conversation, and follow it for the rest of the conversation.",
+        "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.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -37,7 +37,7 @@ export const CATALOG = [
     {
         "name": "list_norms",
         "title": "Available norms",
-        "description": "List the norms and reference documents (standards, laws, regulations) published in the signed-in organization, with code, year, title, language and coverage (how much of the norm was ingested). This is the first call of any search: a norm absent from this list cannot be read and must not be answered from memory. A demo entry is fictional and never a technical reference; a sparse entry carries a notice to relay.",
+        "description": "List the norms and reference documents (standards, laws, regulations) published in the signed-in organization, with code, year, title, language and coverage (how much of the norm was ingested). Use this when a question may be settled by the documents of the organization and the norm is not yet known: a norm absent from this list cannot be read here. A demo entry is fictional and never a technical reference; a sparse entry carries a notice to relay.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -138,7 +138,7 @@ export const CATALOG = [
     {
         "name": "search_corpus",
         "title": "Search all norms",
-        "description": "Full-text search across every norm the organization can read, grouped by norm, heading hits from any norm ahead of body hits. Use it first when the question does not name its norm: it tells which norms speak of the subject before any table of contents is opened. Same matching as search_in_norm. Returns, per norm, its code and title and a few hits; continue with get_section on the paths that look relevant.",
+        "description": "Full-text search across every norm the organization can read, grouped by norm, heading hits from any norm ahead of body hits. Use this when the question does not name its norm: it tells which norms speak of the subject before any table of contents is opened. Same matching as search_in_norm. Returns, per norm, its code and title and a few hits; continue with get_section on the paths that look relevant.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -197,7 +197,7 @@ export const CATALOG = [
     {
         "name": "show_citations",
         "title": "Show cited clauses",
-        "description": "Show the person the clauses your answer rests on, as cards they can open and check against the norm. Call it once, after answering, with the sections you actually read with get_section and cited, in the order you cited them. It reads nothing new: it never replaces get_section, and a clause you did not read must not be listed.",
+        "description": "Use this when an answer rests on clauses read with get_section and the person should be able to check them: shows those clauses as cards they can open against the norm, once per answer, in the order they were cited. It reads nothing new and does not replace get_section; only clauses actually read belong in it.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -488,7 +488,7 @@ export const CATALOG = [
     {
         "name": "save_finding",
         "title": "Record evidence",
-        "description": "Record one piece of evidence in a dossier, as you work rather than in a batch at the end. Kinds: reference (what a norm says; always give normCode, sectionPath and page, or it is not a reference), hypothesis (the value the user retains and why, value in value and reasoning in detail), observation (what the site, a borehole or a survey showed, with the date). One clause, one value or one fact per call, in one or two sentences. Pass questionId to file it under the question it serves; without it the entry waits unclassified. Set confidence whenever a value is at stake: established, judgement or to_confirm. Questions go through open_question and decisions through record_decision, not here.",
+        "description": "Use this when a piece of evidence turns up during the work: records it in a dossier, one at a time rather than in a batch at the end. Kinds: reference (what a norm says; always give normCode, sectionPath and page, or it is not a reference), hypothesis (the value the user retains and why, value in value and reasoning in detail), observation (what the site, a borehole or a survey showed, with the date). One clause, one value or one fact per call, in one or two sentences. Pass questionId to file it under the question it serves; without it the entry waits unclassified. Set confidence whenever a value is at stake: established, judgement or to_confirm. Questions go through open_question and decisions through record_decision, not here.",
         "annotations": {
             "readOnlyHint": false,
             "destructiveHint": false,
@@ -518,7 +518,7 @@ export const CATALOG = [
     {
         "name": "record_decision",
         "title": "Record a decision",
-        "description": "Record what the user retained: the decision in one line, why, and the clause it rests on. Pass questionId when the question already exists; otherwise pass dossierId and question (what is settled, in one line) and the question is opened on the spot, already decided. Name the retained option when the question listed some; put the number in value and set confidence when the decision is a value. Only after the user confirmed the decision, never on your own reasoning. Returns entryId.",
+        "description": "Use this when the user has settled a point: records the decision in one line, why, and the clause it rests on. Pass questionId when the question already exists; otherwise pass dossierId and question (what is settled, in one line) and the question is opened on the spot, already decided. Name the retained option when the question listed some; put the number in value and set confidence when the decision is a value. Meant for decisions the user confirmed, not for conclusions of the agent alone. Returns entryId.",
         "annotations": {
             "readOnlyHint": false,
             "destructiveHint": false,
@@ -548,7 +548,7 @@ export const CATALOG = [
     {
         "name": "load_dossier",
         "title": "Load a dossier",
-        "description": "Reload a dossier: its questions with their evidence, options and decisions, open questions first, then the evidence not yet filed under a question, then the comments a colleague left. Do this before answering whenever the user returns to a project already named, otherwise a decision already taken gets taken again. The name is enough; the id is optional.",
+        "description": "Reload a dossier: its questions with their evidence, options and decisions, open questions first, then the evidence not yet filed under a question, then the comments a colleague left. Use this when the user returns to a project already named: the decisions already taken are there. The name is enough; the id is optional.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -587,7 +587,7 @@ export const CATALOG = [
     {
         "name": "list_attachments",
         "title": "Project attachments",
-        "description": "List the project attachments of one dossier: the site reports, borehole logs, meeting minutes and data sheets the user uploaded. Returns for each its id, name, type, page count and extraction status. Read one with read_attachment before answering on the project; a piece is evidence like a clause and is cited the same way.",
+        "description": "List the project attachments of one dossier: the site reports, borehole logs, meeting minutes and data sheets the user uploaded. Returns for each its id, name, type, page count and extraction status. Use this when a question on the project may rest on what the office uploaded; read_attachment opens one, and a piece is cited like a clause.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -664,7 +664,7 @@ export const CATALOG = [
     {
         "name": "list_templates",
         "title": "Dossier templates",
-        "description": "List the checklists the organization wrote for its types of case: each is a set of questions with the clauses they rest on. When a new project matches one, apply it with apply_template instead of opening the questions one by one.",
+        "description": "List the checklists the organization wrote for its types of case: each is a set of questions with the clauses they rest on. Use this when a new project may match a type of case the office already wrote down; apply_template opens all its questions at once.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -757,7 +757,7 @@ export const CATALOG = [
     {
         "name": "get_skill",
         "title": "Read a skill",
-        "description": "Read one skill in full: Markdown with its front matter (name, description) and its steps, rules and output shape. Follow it for the task at hand. The organization version wins over the Stratta version of the same name, because it carries the office plan and wording. Returns null when no skill has that name.",
+        "description": "Read one skill in full: Markdown with its front matter (name, description) and its steps, rules and output shape. Use this when a task matches a skill from list_skills; the skill describes how the office does it. The organization version wins over the Stratta version of the same name, because it carries the office plan and wording. Returns null when no skill has that name.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -1022,7 +1022,7 @@ export const CATALOG = [
     {
         "name": "ingest_status",
         "title": "Check ingestion status",
-        "description": "Check whether a norm (by code) already exists in the workspace, how many sections it has and its coverage score (how much of the norm actually made it in). Call it before creating a document, to avoid duplicates.",
+        "description": "Check whether a norm (by code) already exists in the workspace, how many sections it has and its coverage score (how much of the norm actually made it in). Use this before creating a document, so a norm is not ingested twice.",
         "annotations": {
             "readOnlyHint": true,
             "destructiveHint": false,
@@ -1170,7 +1170,7 @@ export const CATALOG = [
     {
         "name": "ingest_normalize_cross_refs",
         "title": "Normalize cross-references",
-        "description": "Scan every section of a document and rebuild the cross-references to other norms found in its text. Idempotent; run it after the sections are in.",
+        "description": "Scan every section of a document and add the cross-references to other norms found in its text that are not recorded yet; existing ones are kept. Idempotent; run it after the sections are in.",
         "annotations": {
             "readOnlyHint": false,
             "destructiveHint": false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stratta/mcp",
   "mcpName": "ch.stratta/mcp",
-  "version": "1.18.1",
+  "version": "1.19.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>",

package/skills/consult-stratta/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: consult-stratta
-description: Use Stratta to answer civil engineering questions from licensed SIA, Eurocode, or office norms with exact citations, cross-reference checks, figures, and optional project dossiers. Trigger phrases: "selon la norme", "d'apres la SIA", "que dit l'Eurocode", "verifie dans les normes", "reprends le dossier".
+description: Use Stratta to answer professional questions from the norms and reference documents the organization deposited (technical standards such as SIA or Eurocodes, laws, ordinances, regulations, accounting standards, in-house references) with exact citations, cross-reference checks, figures, and optional project dossiers. Trigger phrases: "selon la norme", "que dit la loi", "d'apres la SIA", "que dit l'Eurocode", "verifie dans les normes", "reprends le dossier".
 ---
 
 # Consult Stratta