Update to Stratta

Changed files

Choose a file to see its text changes. Binary or large files show metadata only.

.codex-plugin/plugin.json →

skills/consult-stratta/SKILL.md →

skills/get-started/SKILL.md →

.codex-plugin/plugin.json

− removed · + added

--- before
+++ after
@@ -1,7 +1,7 @@
 {
   "name": "app-6a958f23ec408191a845944d93e24925",
-  "version": "1.18.0",
-  "description": "Read and cite the engineering norms your organization has licensed in Stratta.",
+  "version": "1.20.0",
+  "description": "Read and cite the norms and reference documents (standards, laws, regulations) your organization has deposited in Stratta.",
   "author": {
     "name": "Hugo Gebel",
     "email": "hello@stratta.ch",
@@ -13,6 +13,8 @@
   "keywords": [
     "mcp",
     "civil-engineering",
+    "regulations",
+    "laws",
     "sia",
     "eurocodes",
     "construction",
@@ -22,12 +24,12 @@
   "mcpServers": "./.mcp.json",
   "interface": {
     "displayName": "Stratta",
-    "shortDescription": "Cited SIA and Eurocode norms",
-    "longDescription": "Stratta answers civil and structural engineering questions from the norms your own organization has uploaded under its own license, and it answers them with a citation you can check: the exact section path and the page number.\n\nEach organization brings its own copies. Stratta does not host a shared corpus and does not redistribute standards: SIA, Eurocode and in-house office norms are ingested by the organization that already holds a license for them, stay inside that organization, and are never visible to another one. A new workspace starts with a small demonstration norm whose content is written by Stratta, so the workflow can be tried before any licensed document is uploaded.\n\nThe agent navigates a norm the way an engineer does. It opens the table of contents, walks down to the chapter that matters, reads the section, follows the cross-references that change the answer, and looks at the figure when a load diagram or a chart carries the rule. Nothing is summarized from memory: every technical claim comes from a section that was actually read.\n\nEvery answer can end with the clauses it rests on, shown as cards: the norm, the section path, the pages, and the sentence quoted, checked word for word against the clause before it is shown. A card opens the full clause in place. The norm reader opens beside the conversation, so a norm can be browsed from its table of contents down to a clause without asking the agent.\n\nProject dossiers keep the trail. A retained value, a hypothesis, a site observation or a question left open is recorded against the project it belongs to, with the clause it came from, so the next conversation resumes where the last one stopped instead of re-deciding what was already decided. The agent reads and amends those questions the way the dossier page does: the options on the table, the evidence with every citation field, the decision, the remarks left along the way, and the activity log.\n\nWritten procedures come with it: a verification note, the project basis and the use agreement of SIA 260, the terrain chapter of a report, the review of open questions for the senior engineer, each drafted from the dossier with every paragraph traced to its source.\n\nFor a site in Switzerland, the agent reads the site sheet the app builds from public cantonal and federal registers: the parcel, the ground elevation, the geology, the boreholes around it with their strata, the polluted sites, the groundwater protection, the natural hazards. A scan can be opened for an address, on the plans that include it.\n\nStratta supports engineering judgment; it does not replace it and it issues no approval. Filing a norm your organization holds a licence for starts from a PDF on your own machine, so it runs on stratta.ch or through the Stratta command-line server, and it is reserved to the owners and administrators of that organization.",
+    "shortDescription": "Cited norms and regulations",
+    "longDescription": "Stratta answers professional questions (engineering, law, accounting, public administration) from the norms and reference documents your own organization has deposited, and it answers them with a citation you can check: the exact section path and the page number.\n\nEach organization brings its own copies. Stratta does not host a shared corpus and does not redistribute standards: technical standards such as SIA and Eurocode, laws, ordinances, regulations, accounting standards and in-house references are deposited by the organization that holds the rights to them, stay inside that organization, and are never visible to another one. A new workspace starts with a small demonstration norm whose content is written by Stratta, so the workflow can be tried before any licensed document is uploaded.\n\nThe agent navigates a norm the way an engineer does. It opens the table of contents, walks down to the chapter that matters, reads the section, follows the cross-references that change the answer, and looks at the figure when a load diagram or a chart carries the rule. Nothing is summarized from memory: every technical claim comes from a section that was actually read.\n\nEvery answer can end with the clauses it rests on, shown as cards: the norm, the section path, the pages, and the sentence quoted, checked word for word against the clause before it is shown. A card opens the full clause in place. The norm reader opens beside the conversation, so a norm can be browsed from its table of contents down to a clause without asking the agent.\n\nProject dossiers keep the trail. A retained value, a hypothesis, a site observation or a question left open is recorded against the project it belongs to, with the clause it came from, so the next conversation resumes where the last one stopped instead of re-deciding what was already decided. The agent reads and amends those questions the way the dossier page does: the options on the table, the evidence with every citation field, the decision, the remarks left along the way, and the activity log.\n\nWritten procedures come with it: a verification note, the project basis and the use agreement of SIA 260, the terrain chapter of a report, the review of open questions for the senior engineer, each drafted from the dossier with every paragraph traced to its source.\n\nFor a site in Switzerland, the agent reads the site sheet the app builds from public cantonal and federal registers: the parcel, the ground elevation, the geology, the boreholes around it with their strata, the polluted sites, the groundwater protection, the natural hazards. A scan can be opened for an address, on the plans that include it.\n\nStratta supports engineering judgment; it does not replace it and it issues no approval. Filing a norm your organization holds a licence for starts from a PDF on your own machine, so it runs on stratta.ch or through the Stratta command-line server, and it is reserved to the owners and administrators of that organization.",
     "developerName": "Hugo Gebel",
     "category": "Productivity",
     "capabilities": [
-      "Read engineering norms your organization has licensed",
+      "Read the norms and reference documents your organization has deposited",
       "Navigate a norm by table of contents and section tree",
       "Quote sections with exact section path and page number",
       "Show the cited clauses as cards, each quote checked against the clause",
@@ -40,16 +42,16 @@
       "Read a Swiss site sheet, its boreholes and their strata",
       "Draft a verification note, project basis or report chapter from a dossier",
       "Scan the public Swiss registers for a building site address",
-      "File a norm your organization holds a licence for"
+      "File a document your organization holds the rights to"
     ],
     "websiteURL": "https://stratta.ch",
     "supportURL": "https://stratta.ch/contact",
     "privacyPolicyURL": "https://stratta.ch/legal/privacy",
     "termsOfServiceURL": "https://stratta.ch/legal/terms",
     "defaultPrompt": [
-      "List the engineering norms available in my Stratta organization.",
-      "Find the clause on wind load on facades and cite its section and page.",
-      "Open a dossier for the Villa Morges project and record the retained value."
+      "Which norms and reference documents can Stratta read for my organization?",
+      "Pick a clause from my norms, explain it with its exact section and page, and show it as a citation card.",
+      "Open a project dossier for Villa Morges and keep the decisions we take in it."
     ],
     "brandColor": "#A87A25",
     "brandColorDark": "#D69A55",
@@ -95,7 +97,7 @@
           ],
           "negative": [
             {
-              "description": "A request with no connection to construction norms must not invoke the app. The app is not invoked: Stratta covers only the construction norms held by the connected organization, and a weather question is outside that scope.",
+              "description": "A request with no connection to reference documents must not invoke the app. The app is not invoked: Stratta covers only the norms and reference documents held by the connected organization, and a weather question is outside that scope.",
               "prompt": "What is the weather in Lausanne tomorrow?"
             },
             {
@@ -144,11 +146,11 @@
           "ES",
           "SE"
         ],
-        "release_notes": "Package 1.18.0, an update of the published plugin. Stratta is a read-and-cite surface over the construction norms an organization has uploaded under its own license: SIA, Eurocodes, and in-house office documents. There is no shared corpus and no redistribution of any standard; each organization sees only its own documents, enforced server-side against the organization the OAuth consent was granted for. The MCP server URL is unchanged.\n\nWhat changed in this version. The remote surface advertises 61 tools; nothing was removed, renamed, or made incompatible. Three are new and serve the person rather than the model. show_citations renders the clauses an answer cites as cards (an MCP App, ui://stratta/reader-*.html): code, section path, pages, and the quoted sentence, which the server checks word for word against the clause and flags when it is not there. open_norm_reader opens the same frame as a norm reader from the thread side panel and the sidebar; it is hidden from the model (visibility app) and only reads the norm list, the table of contents and the sections, through the same tools the model uses. get_profile is the read-only profile tool marked openai/profile, so a person connected to two organizations sees two distinct accounts. The frame declares no network domain: every read goes through the host to these tools. The package now carries nine skills instead of one: get-started (the onboarding skill), consult-stratta, and the seven drafting procedures the server already serves through list_skills (verification note, project basis, use agreement, terrain chapter, review of open questions, instructing a structure, hand-off to Word).\n\nAnnotations: all 61 tools carry explicit readOnlyHint, openWorldHint and destructiveHint values. 35 are read-only; a read records a metered usage event for quota accounting, a write that changes no user data and does not affect the result, which is why those tools stay annotated read-only. 3 are destructive and all three ask for confirmation before they run: delete_option and delete_question remove one item from a project dossier, ingest_delete removes one document from the caller's own organization. scan_site is the only open-world tool: it reads public Swiss registers over the internet.\n\nFor the reviewer: the demonstration account holds only DEMO 001, a fictional document written by Stratta, so review needs no licensed material. list_norms flags it and the served methodology instructs the agent never to use its values. DEMO 001 is served by Stratta to every workspace, so the deletion tools cannot touch it. The five positive test cases run end to end on that account in the order given; the third one shows the citation cards.",
+        "release_notes": "Package 1.20.0, an update of the published plugin, which is 1.18.0. Versions 1.18.1 and 1.19.0 were never submitted, so their changes are listed here too. The remote surface still advertises 61 tools, none was added, removed or renamed since 1.18.0, annotations are unchanged, and the MCP server URL is unchanged.\n\nStratta is a read-and-cite surface over the norms and reference documents an organization has deposited and holds the rights to: technical standards, laws, ordinances, regulations, accounting standards and in-house references. There is no shared corpus and no redistribution of any document; each organization sees only its own documents, enforced server-side against the organization the OAuth consent was granted for. Each deposit requires the depositor to declare the organization holds the rights to the document.\n\nIn 1.18.1: the server instructions, tool descriptions, served methodology and the consult-stratta skill now describe this general corpus instead of construction norms only. The plugin description and subtitle say the same.\n\nIn 1.19.0: every tool now carries its title at the top level as well as in its annotations; eleven descriptions (get_methodology, list_norms, search_corpus, load_dossier, list_attachments, list_templates, show_citations, save_finding, record_decision, get_skill, ingest_status) are rewritten as \"Use this when...\" instead of instructions to the model; ingest_normalize_cross_refs says it adds missing references rather than rebuilding them; the server info carries a title, a description, a website and an icon; the authorization response now names its issuer (RFC 9207); the reader waits ten seconds at most for the host's handshake before saying it could not open. The consult-stratta skill describes the general corpus.\n\nIn 1.20.0: list_norms takes two optional inputs, query (a code or words of the title) and limit, and returns { total, matched, norms, truncated, hint } instead of a bare array, because a 425-norm organization received 170 000 characters; with a query each norm carries its scope. get_section returns the section once, as Markdown with its formulas, tables, figures and references in place, plus the navigation fields (path, title, edition, pages, parent, figure ids, window), instead of the same text again as raw text and JSON. search_in_norm carries the licence on its first hit. get_dossier_activity lists 15 lines by default instead of 50. The consult-stratta skill describes professional questions in general. The starter prompts work on a new account, which holds only the demonstration document, and the get-started skill gives the size of a large corpus instead of listing it.\n\nFor the reviewer: the demonstration account holds only DEMO 001, a fictional document written by Stratta, so review needs no licensed material. list_norms flags it and the served methodology instructs the agent never to use its values. The five positive test cases run end to end on that account in the order given; the third one shows the citation cards.",
         "translations": {
           "fr-FR": {
-            "subtitle": "Normes SIA et Eurocodes cit\u00e9es",
-            "description": "Stratta r\u00e9pond aux questions d\u2019ing\u00e9nierie civile et structurelle \u00e0 partir des normes que votre organisation a d\u00e9pos\u00e9es sous sa propre licence, et chaque r\u00e9ponse porte une citation v\u00e9rifiable : le chemin exact de la clause et le num\u00e9ro de page.\n\nChaque organisation apporte ses propres exemplaires. Stratta n\u2019h\u00e9berge aucun corpus partag\u00e9 et ne redistribue aucune norme : SIA, Eurocodes et normes internes du bureau sont d\u00e9pos\u00e9es par l\u2019organisation qui en d\u00e9tient la licence, restent dans cette organisation et ne sont jamais visibles d\u2019une autre. Un nouvel espace commence avec une norme de d\u00e9monstration \u00e9crite par Stratta, pour essayer avant tout d\u00e9p\u00f4t.\n\nL\u2019agent parcourt une norme comme un ing\u00e9nieur : sommaire, chapitre utile, clause, renvois qui changent la r\u00e9ponse, figure quand un diagramme porte la r\u00e8gle. Rien n\u2019est r\u00e9sum\u00e9 de m\u00e9moire.\n\nUne r\u00e9ponse peut se terminer par les clauses sur lesquelles elle repose, en cartes : la norme, la clause, les pages et la phrase cit\u00e9e, v\u00e9rifi\u00e9e mot pour mot contre la clause avant d\u2019\u00eatre affich\u00e9e. Le lecteur de normes s\u2019ouvre \u00e0 c\u00f4t\u00e9 de la conversation pour parcourir une norme sans passer par l\u2019agent.\n\nLes dossiers de projet gardent la trace des valeurs retenues, des hypoth\u00e8ses et des questions ouvertes, chacune avec sa clause. Des proc\u00e9dures \u00e9crites accompagnent l\u2019agent : note de v\u00e9rification, base du projet et convention d\u2019utilisation selon la SIA 260, chapitre terrain d\u2019un rapport, revue des questions ouvertes.\n\nPour un site en Suisse, l\u2019agent lit la fiche de site construite \u00e0 partir des registres publics cantonaux et f\u00e9d\u00e9raux : parcelle, g\u00e9ologie, sondages, sites pollu\u00e9s, protection des eaux, dangers naturels.\n\nStratta appuie le jugement de l\u2019ing\u00e9nieur sans le remplacer et ne d\u00e9livre aucune approbation."
+            "subtitle": "Normes et r\u00e8glements cit\u00e9s",
+            "description": "Stratta r\u00e9pond aux questions professionnelles (ing\u00e9nierie, droit, comptabilit\u00e9, administration publique) \u00e0 partir des normes et documents de r\u00e9f\u00e9rence que votre organisation a d\u00e9pos\u00e9s, et chaque r\u00e9ponse porte une citation v\u00e9rifiable : le chemin exact de la clause et le num\u00e9ro de page.\n\nChaque organisation apporte ses propres exemplaires. Stratta n\u2019h\u00e9berge aucun corpus partag\u00e9 et ne redistribue aucune norme : SIA, Eurocodes et normes internes du bureau sont d\u00e9pos\u00e9es par l\u2019organisation qui en d\u00e9tient la licence, restent dans cette organisation et ne sont jamais visibles d\u2019une autre. Un nouvel espace commence avec une norme de d\u00e9monstration \u00e9crite par Stratta, pour essayer avant tout d\u00e9p\u00f4t.\n\nL\u2019agent parcourt une norme comme un ing\u00e9nieur : sommaire, chapitre utile, clause, renvois qui changent la r\u00e9ponse, figure quand un diagramme porte la r\u00e8gle. Rien n\u2019est r\u00e9sum\u00e9 de m\u00e9moire.\n\nUne r\u00e9ponse peut se terminer par les clauses sur lesquelles elle repose, en cartes : la norme, la clause, les pages et la phrase cit\u00e9e, v\u00e9rifi\u00e9e mot pour mot contre la clause avant d\u2019\u00eatre affich\u00e9e. Le lecteur de normes s\u2019ouvre \u00e0 c\u00f4t\u00e9 de la conversation pour parcourir une norme sans passer par l\u2019agent.\n\nLes dossiers de projet gardent la trace des valeurs retenues, des hypoth\u00e8ses et des questions ouvertes, chacune avec sa clause. Des proc\u00e9dures \u00e9crites accompagnent l\u2019agent : note de v\u00e9rification, base du projet et convention d\u2019utilisation selon la SIA 260, chapitre terrain d\u2019un rapport, revue des questions ouvertes.\n\nPour un site en Suisse, l\u2019agent lit la fiche de site construite \u00e0 partir des registres publics cantonaux et f\u00e9d\u00e9raux : parcelle, g\u00e9ologie, sondages, sites pollu\u00e9s, protection des eaux, dangers naturels.\n\nStratta appuie le jugement de l\u2019ing\u00e9nieur sans le remplacer et ne d\u00e9livre aucune approbation."
           }
         }
       }