@comment-io/cli 0.1.10-alpha.272 → 0.1.10-alpha.274

package/mcp/comment-mcp.mjs

@@ -27044,6 +27044,7 @@ var agentRules = [
   { id: "agent-role", severity: "must", summary: "Create and work with Comment.io documents when asked." },
   { id: "fetch-current-docs", severity: "must", summary: "Fetch the current agent docs at the start of each session." },
   { id: "bearer-token-is-identity", severity: "must", summary: "Treat the Bearer token as the actor identity." },
+  { id: "markdown-line-breaks", severity: "must", summary: "Do not hard-wrap ordinary prose; use single newlines only for semantic line breaks." },
   { id: "never-send-by", severity: "must", summary: "Never send a client-authored by field." },
   { id: "always-get-before-editing", severity: "must", summary: "Read the current document before editing." },
   { id: "per-doc-token-identify", severity: "must", summary: "Identify anonymous per-document tokens before writing." },
@@ -27055,6 +27056,7 @@ var coreAgentRuleIds = agentRules.map((rule) => rule.id);
 var mcpServerRuleIds = [
   "fetch-current-docs",
   "bearer-token-is-identity",
+  "markdown-line-breaks",
   "never-send-by",
   "always-get-before-editing",
   "per-doc-token-identify",
@@ -27071,6 +27073,8 @@ function formatAgentRuleLine(id, context) {
       return `**Memory:** Save doc URLs and tokens the user gives you. Fetch ${llmsUrl} each session for the latest API.`;
     case "bearer-token-is-identity":
       return "**Identity:** Your Bearer token is your identity. Do **not** send a `by` field - it is rejected with `400 UNEXPECTED_FIELD`. Registered agents (`as_...` tokens) are identified automatically from their handle. Per-doc tokens must register a display name once with `POST /agents/identify { display_name, slug }` before writing, or writes return `412 IDENTIFY_REQUIRED`. The raw query token on a share URL is read-only: call `GET /docs/{slug}?token={share_token}` to mint your personal `your_token`, then use that as your Bearer token.";
+    case "markdown-line-breaks":
+      return "**Markdown line breaks:** When creating or editing docs, do not hard-wrap ordinary prose at 80 columns. Send each prose paragraph as one line with a blank line between paragraphs. Use single newlines only when line breaks are semantically meaningful, such as poems, addresses, short outlines, Markdown table/list syntax, code blocks, or intentional hard-break content.";
     case "never-send-by":
       return "- **Identity is derived from your Bearer token.** Do **not** send a `by` field - requests that include it are rejected with `400 UNEXPECTED_FIELD`. If this is a per-doc token, register a display name once with `POST /agents/identify` (see below) before writing.";
     case "always-get-before-editing":
@@ -27092,6 +27096,9 @@ function formatAgentRuleBullet(id, context) {
   if (id === "report-api-bugs") {
     return "- **Report API bugs while you work.** If a response includes a `feedback` URL and the API behavior looks wrong, contradicts these docs, or documented recovery fails once, POST to that URL with the method, endpoint, request/response summary, `request_id`, what you expected, and what recovery you tried. Report potentially wrong 409/422 responses this way; do not report the same issue twice.";
   }
+  if (id === "markdown-line-breaks") {
+    return "- **Markdown line breaks:** When creating or editing docs, do not hard-wrap ordinary prose at 80 columns. Send each prose paragraph as one line with a blank line between paragraphs. Use single newlines only when line breaks are semantically meaningful, such as poems, addresses, short outlines, Markdown table/list syntax, code blocks, or intentional hard-break content.";
+  }
   return formatAgentRuleLine(id, context);
 }
 function buildMcpServerInstructions(baseUrl = "https://comment.io", sid) {
@@ -27170,6 +27177,7 @@ function apiReference(baseUrl, slug, token, sid) {
     `### Key rules`,
     formatAgentRuleBullet("always-get-before-editing", { baseUrl }),
     formatAgentRuleBullet("bearer-token-is-identity", { baseUrl }),
+    formatAgentRuleBullet("markdown-line-breaks", { baseUrl }),
     `- **The document title is derived from the first non-empty markdown line.** Do **not** send a \`title\` field to \`POST /docs\` or \`PATCH /docs/:slug\`; those requests return \`400 UNEXPECTED_FIELD\`. To rename a doc, edit the first heading/line in \`markdown\`. \`POST /docs\` also accepts optional \`library_target\` for v1 My Files, Team Wiki, or Botlets brain placement; Botlets targets accept stable \`botId\`, optionally paired with \`botSlug\` as a guard/alias, mismatches return \`409 BOT_TARGET_MISMATCH\`, and successful placements return \`library_target_resolution.bot_id\`, \`requested_bot_slug\`, \`canonical_bot_slug\`, and \`slug_resolution\`.`,
     formatAgentRuleBullet("report-api-bugs", { baseUrl }),
     `- **\`quote\` is required** for suggestions and text-selected comments. Plain comments can instead target a durable block with \`block_id\` from \`content_blocks[].id\`; responses include a read-only \`anchor.version=2\` canonical mark anchor, and plain comments may also include \`anchor_block_id\`. Replies use \`reply_to\` and inherit the parent block. Chronological order within the block is the thread.`,
@@ -27640,6 +27648,7 @@ function buildCompleteAgentDocs(baseUrl = "https://comment.io", sid) {
     formatAgentRuleLine("agent-role", { baseUrl }),
     formatAgentRuleLine("fetch-current-docs", { baseUrl }),
     formatAgentRuleLine("bearer-token-is-identity", { baseUrl }),
+    formatAgentRuleLine("markdown-line-breaks", { baseUrl }),
     formatAgentRuleLine("report-api-bugs", { baseUrl }),
     ``,
     `## How agents work with Comment Docs`,
@@ -28187,6 +28196,7 @@ function buildHomeDocs(baseUrl = "https://comment.io", sid) {
     formatAgentRuleLine("agent-role", { baseUrl, llmsUrl }),
     formatAgentRuleLine("fetch-current-docs", { baseUrl, llmsUrl }),
     formatAgentRuleLine("bearer-token-is-identity", { baseUrl, llmsUrl }),
+    formatAgentRuleLine("markdown-line-breaks", { baseUrl, llmsUrl }),
     formatAgentRuleLine("report-api-bugs", { baseUrl, llmsUrl }),
     ``,
     `## How agents work with Comment Docs`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comment-io/cli",
-  "version": "0.1.10-alpha.272",
+  "version": "0.1.10-alpha.274",
   "description": "Comment.io CLI and local notification daemon",
   "private": false,
   "type": "module",