@systemdox/mcp-server 0.1.43 → 0.1.44

package/dist/cli.js

@@ -2276,7 +2276,11 @@ function registerSkillTools(server2, apiClient2, { localFiles }) {
         } : {},
         files: z13.array(fileSchema).optional().describe(localFiles ? "Only when there is no folder to read" : "Every file of the skill folder"),
         name: z13.string().optional().describe("The skill's name; defaults to SKILL.md's frontmatter name and must match it"),
-        spaceId: z13.string().optional().describe("Space for a NEW skill (default: your default space)")
+        spaceId: z13.string().optional().describe("Space for a NEW skill (default: your default space)"),
+        note: z13.string().max(500).optional().describe(`A short change note for this version, shown in the console's history (e.g. "Fix the GA4 step")`),
+        baseVersion: z13.number().int().positive().optional().describe(
+          "The version these files were edited from. When given, the publish is refused (SYD-K017) if someone published a newer version since, instead of replacing their changes"
+        )
       },
       annotations: { readOnlyHint: false }
     },
@@ -2297,7 +2301,12 @@ function registerSkillTools(server2, apiClient2, { localFiles }) {
       if (!name) throw new Error(`${ENTRY_FILE} has no frontmatter name; pass \`name\`.`);
       const saved = await apiClient2.post(
         `${SKILLS}/${encodeURIComponent(name)}/versions`,
-        { files, ...args2.spaceId ? { spaceId: args2.spaceId } : {} }
+        {
+          files,
+          ...args2.spaceId ? { spaceId: args2.spaceId } : {},
+          ...args2.note ? { note: args2.note } : {},
+          ...args2.baseVersion ? { baseVersion: args2.baseVersion } : {}
+        }
       );
       apiClient2.invalidateCache(SKILLS);
       return text(
@@ -2435,7 +2444,7 @@ var init_server = __esm({
     init_get_prompt_templates();
     init_create_prompt_template();
     init_skills2();
-    SERVER_VERSION = true ? "0.1.43" : "0.0.0-dev";
+    SERVER_VERSION = true ? "0.1.44" : "0.0.0-dev";
   }
 });
 

package/dist/http.js

@@ -2073,7 +2073,11 @@ function registerSkillTools(server, apiClient, { localFiles }) {
         } : {},
         files: z13.array(fileSchema).optional().describe(localFiles ? "Only when there is no folder to read" : "Every file of the skill folder"),
         name: z13.string().optional().describe("The skill's name; defaults to SKILL.md's frontmatter name and must match it"),
-        spaceId: z13.string().optional().describe("Space for a NEW skill (default: your default space)")
+        spaceId: z13.string().optional().describe("Space for a NEW skill (default: your default space)"),
+        note: z13.string().max(500).optional().describe(`A short change note for this version, shown in the console's history (e.g. "Fix the GA4 step")`),
+        baseVersion: z13.number().int().positive().optional().describe(
+          "The version these files were edited from. When given, the publish is refused (SYD-K017) if someone published a newer version since, instead of replacing their changes"
+        )
       },
       annotations: { readOnlyHint: false }
     },
@@ -2094,7 +2098,12 @@ function registerSkillTools(server, apiClient, { localFiles }) {
       if (!name) throw new Error(`${ENTRY_FILE} has no frontmatter name; pass \`name\`.`);
       const saved = await apiClient.post(
         `${SKILLS}/${encodeURIComponent(name)}/versions`,
-        { files, ...args.spaceId ? { spaceId: args.spaceId } : {} }
+        {
+          files,
+          ...args.spaceId ? { spaceId: args.spaceId } : {},
+          ...args.note ? { note: args.note } : {},
+          ...args.baseVersion ? { baseVersion: args.baseVersion } : {}
+        }
       );
       apiClient.invalidateCache(SKILLS);
       return text(
@@ -2181,7 +2190,7 @@ ${body}`
 }
 
 // src/server.ts
-var SERVER_VERSION = true ? "0.1.43" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.1.44" : "0.0.0-dev";
 function createServer(apiClient, { localFiles = false } = {}) {
   const server = new McpServer({
     name: "systemdox-mcp-server",

package/dist/index.js

@@ -2055,7 +2055,11 @@ function registerSkillTools(server2, apiClient2, { localFiles }) {
         } : {},
         files: z13.array(fileSchema).optional().describe(localFiles ? "Only when there is no folder to read" : "Every file of the skill folder"),
         name: z13.string().optional().describe("The skill's name; defaults to SKILL.md's frontmatter name and must match it"),
-        spaceId: z13.string().optional().describe("Space for a NEW skill (default: your default space)")
+        spaceId: z13.string().optional().describe("Space for a NEW skill (default: your default space)"),
+        note: z13.string().max(500).optional().describe(`A short change note for this version, shown in the console's history (e.g. "Fix the GA4 step")`),
+        baseVersion: z13.number().int().positive().optional().describe(
+          "The version these files were edited from. When given, the publish is refused (SYD-K017) if someone published a newer version since, instead of replacing their changes"
+        )
       },
       annotations: { readOnlyHint: false }
     },
@@ -2076,7 +2080,12 @@ function registerSkillTools(server2, apiClient2, { localFiles }) {
       if (!name) throw new Error(`${ENTRY_FILE} has no frontmatter name; pass \`name\`.`);
       const saved = await apiClient2.post(
         `${SKILLS}/${encodeURIComponent(name)}/versions`,
-        { files, ...args.spaceId ? { spaceId: args.spaceId } : {} }
+        {
+          files,
+          ...args.spaceId ? { spaceId: args.spaceId } : {},
+          ...args.note ? { note: args.note } : {},
+          ...args.baseVersion ? { baseVersion: args.baseVersion } : {}
+        }
       );
       apiClient2.invalidateCache(SKILLS);
       return text(
@@ -2163,7 +2172,7 @@ ${body}`
 }
 
 // src/server.ts
-var SERVER_VERSION = true ? "0.1.43" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.1.44" : "0.0.0-dev";
 function createServer(apiClient2, { localFiles = false } = {}) {
   const server2 = new McpServer({
     name: "systemdox-mcp-server",

package/dist/tools/skills.js

@@ -236,7 +236,11 @@ function registerSkillTools(server, apiClient, { localFiles }) {
         } : {},
         files: z.array(fileSchema).optional().describe(localFiles ? "Only when there is no folder to read" : "Every file of the skill folder"),
         name: z.string().optional().describe("The skill's name; defaults to SKILL.md's frontmatter name and must match it"),
-        spaceId: z.string().optional().describe("Space for a NEW skill (default: your default space)")
+        spaceId: z.string().optional().describe("Space for a NEW skill (default: your default space)"),
+        note: z.string().max(500).optional().describe(`A short change note for this version, shown in the console's history (e.g. "Fix the GA4 step")`),
+        baseVersion: z.number().int().positive().optional().describe(
+          "The version these files were edited from. When given, the publish is refused (SYD-K017) if someone published a newer version since, instead of replacing their changes"
+        )
       },
       annotations: { readOnlyHint: false }
     },
@@ -257,7 +261,12 @@ function registerSkillTools(server, apiClient, { localFiles }) {
       if (!name) throw new Error(`${ENTRY_FILE} has no frontmatter name; pass \`name\`.`);
       const saved = await apiClient.post(
         `${SKILLS}/${encodeURIComponent(name)}/versions`,
-        { files, ...args.spaceId ? { spaceId: args.spaceId } : {} }
+        {
+          files,
+          ...args.spaceId ? { spaceId: args.spaceId } : {},
+          ...args.note ? { note: args.note } : {},
+          ...args.baseVersion ? { baseVersion: args.baseVersion } : {}
+        }
       );
       apiClient.invalidateCache(SKILLS);
       return text(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@systemdox/mcp-server",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "mcpName": "io.github.puglieseweb/systemdox",
   "type": "module",
   "description": "Give AI coding agents your architecture context over MCP — checks, specs, ADRs, project rules, and docs from SystemDox, delivered at write time",