@nestr/mcp 0.1.95 → 0.1.96

package/README.md

@@ -300,7 +300,7 @@ npm run inspect
 ## Resources
 
 - [Setup Guide](https://mcp.nestr.io) - Step-by-step setup instructions
-- [Nestr Help Center](https://help.nestr.io)
+- [Nestr Help Center](https://nestr.io/nestr-help)
 - [Nestr API Documentation](https://app.nestr.io/api/docs)
 - [Model Context Protocol](https://modelcontextprotocol.io)
 
@@ -311,4 +311,4 @@ MIT - see [LICENSE](LICENSE)
 ## Support
 
 - [GitHub Issues](https://github.com/nestr-dev/nestr-mcp/issues)
-- [Nestr Support](https://help.nestr.io)
+- [Nestr Support](https://nestr.io/nestr-help)

package/build/help/topics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"topics.d.ts","sourceRoot":"","sources":["../../src/help/topics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2+C9C,CAAC"}
+{"version":3,"file":"topics.d.ts","sourceRoot":"","sources":["../../src/help/topics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6+C9C,CAAC"}

package/build/help/topics.js

@@ -49,6 +49,7 @@ The internal topics below are curated MCP-flavoured guidance — tool call patte
 
 **Assistant-mode agents should:**
 - Defer to the human for all decisions — suggest, don't decide
+- Treat assisting as a real execution pattern: a role is governance and never executes anything; it is filled by a human or a dedicated agent, and any agent may additionally assist a filler by running that role's work with the filler's authority. Assisting is reactive by nature — you act when the filler engages you, never on a schedule, and you never appear in the role's users. Autonomy belongs only to agents filling roles. Never present a role as if it were an agent: creating a role creates the accountability, not the executor
 - Help the user articulate their tensions including feeling and needs
 - Surface tensions and work items for the user to review and prioritize
 - Confirm before proposing governance changes
@@ -192,16 +193,17 @@ Nestr uses different formats for different fields:
 | Progress updates, status changes, discussion | Comments |
 | Integration metadata, custom tracking | \`data\` (namespace under \`mcp.\`) |
 
-**Important — Always use HTML, not Markdown:** When composing purpose, description, or comment content, you must use HTML tags. This is a common mistake for AI agents that default to Markdown syntax.
+**Formatting — HTML and Markdown both render:** purpose, description and comment content passes through a Markdown renderer with HTML enabled, so \`<b>bold</b>\` and \`**bold**\` both come out bold. Write whichever reads better and stay consistent within one piece of content. Keep titles plain text: markup there is not stripped, it just renders as noise everywhere the title is listed.
 
-| Instead of (Markdown) | Use (HTML) |
-|----------------------|------------|
+| Markdown | HTML |
+|----------|------|
 | \`**bold text**\` | \`<b>bold text</b>\` |
 | \`*italic text*\` | \`<i>italic text</i>\` |
 | \`- list item\` | \`<ul><li>list item</li></ul>\` |
 | \`1. numbered item\` | \`<ol><li>numbered item</li></ol>\` |
 | \`[link text](url)\` | \`<a href="url">link text</a>\` |
-| \`\\n\\n\` (double newline) | \`<br>\` |
+
+What does not render either way is a wall of unbroken prose. Give anything longer than a few sentences headings and lists, so the humans who own the nest can read it.
 
 **Example HTML in purpose:**
 \`\`\`html

package/build/help/topics.js.map

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

package/build/server.js

@@ -35,7 +35,7 @@ Call \`nestr_get_me\` with \`fullWorkspaces: true\` at session start to establis
 
 The response tells you who you are:
 
-- **Assistant mode** (\`mode: "assistant"\`) — Helping a human who fills roles. Defer to them for decisions. Help articulate tensions, draft proposals, surface work for review. Confirm before acting.
+- **Assistant mode** (\`mode: "assistant"\`) — Helping a human who fills roles. Defer to them for decisions. Help articulate tensions, draft proposals, surface work for review. Confirm before acting. Assisting is also a legitimate execution pattern: when the person you help fills a role, you may run that role's work with their authority, reactively — you are never the role's filler and never autonomous.
 - **Role-filler mode** (\`mode: "role-filler"\`) — You energize roles and act from their authority. Process tensions autonomously, maintain skills, communicate via tensions. Act within accountabilities without seeking approval.
 - **Workspace mode** (\`mode: "workspace"\`) — API key with no user identity. Manage structure and operations. User-scoped features (inbox, daily plan, notifications) are unavailable.
 
@@ -47,8 +47,8 @@ Nestr supports any self-organization approach. When the flavour is clear (check
 
 ## Content Format
 
-- **title**: Plain text only (HTML stripped)
-- **purpose, description, comments**: Use HTML, NOT Markdown (\`<b>\` not \`**\`, \`<ul><li>\` not \`-\`)
+- **title**: keep it plain text (markup is not stripped, it just renders as noise in every listing)
+- **purpose, description, comments**: HTML and Markdown both render (\`<b>bold</b>\` and \`**bold**\` both work). Structure anything long with headings and lists rather than one unbroken block
 - **Linking to nests**: every returned nest includes a precomputed \`url\` field — use it directly. Canonical pattern is \`https://app.nestr.io/n/{nestId}\` (path is \`/n/\`, NOT \`/nest/\` or \`/nests/\`). See \`nestr_help({ topic: "linking" })\`.
 
 ## Role Assignments

package/build/skills/workspace-setup.js

@@ -80,9 +80,9 @@ If one workspace exists, check if setup mode applies. If multiple, ask which to
 1. **New or existing?** Setting up from scratch, capturing existing structure, or migrating from another tool.
 
 2. **If migrating:** Direct to help docs:
-   - Holaspirit: \`https://help.nestr.io/en/integrations/importing-data-from-holaspirit\`
-   - Glassfrog: \`https://help.nestr.io/en/integrations/importing-data-from-glassfrog\`
-   - General: \`https://help.nestr.io/en/integrations/importing-and-exporting-your-data-with-nestr\`
+   - Holaspirit: \`https://nestr.io/help/articles/importing-data-from-holaspirit\`
+   - Glassfrog: \`https://nestr.io/help/articles/importing-data-from-glassfrog\`
+   - General: \`https://nestr.io/help/articles/importing-and-exporting-your-data-with-nestr\`
    - CSV: Ask for file content. Expected columns: circle, role, purpose, accountabilities. Parse and create programmatically. After import, skip to Step 5.
 
 3. **Research:** Ask about website, what the org does, who it serves. Present understanding back and refine.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestr/mcp",
-  "version": "0.1.95",
+  "version": "0.1.96",
   "mcpName": "io.nestr/mcp",
   "description": "MCP server for Nestr - the platform for self-organizing teams practicing Holacracy, Sociocracy, and role-based work. Manage circles, roles, tactical meetings, governance meetings, tensions, and more.",
   "author": "Nestr <dev@nestr.io>",

package/web/index.html

@@ -91,7 +91,7 @@
       </div>
       <nav>
         <a href="https://app.nestr.io" target="_blank">Open Nestr</a>
-        <a href="https://help.nestr.io" target="_blank">Help</a>
+        <a href="https://nestr.io/nestr-help" target="_blank">Help</a>
         <a href="https://github.com/nestr-dev/nestr-mcp" target="_blank">GitHub</a>
       </nav>
     </div>