@hanna84/mcp-writing 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -4,11 +4,21 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [v2.3.0](https://github.com/hannasdev/mcp-writing.git
+/compare/v2.2.0...v2.3.0)
+
+- feat(styleguide): generate prose styleguide skill from resolved config [`#85`](https://github.com/hannasdev/mcp-writing.git
+/pull/85)
+
 #### [v2.2.0](https://github.com/hannasdev/mcp-writing.git
 /compare/v2.1.0...v2.2.0)
 
+> 25 April 2026
+
 - feat(styleguide): add prose styleguide config resolution and MCP tools [`#84`](https://github.com/hannasdev/mcp-writing.git
 /pull/84)
+- Release 2.2.0 [`58ecb48`](https://github.com/hannasdev/mcp-writing.git
+/commit/58ecb480200498459e3d8876c06554d8a26c2fb5)
 
 #### [v2.1.0](https://github.com/hannasdev/mcp-writing.git
 /compare/v2.0.4...v2.1.0)

package/index.js

@@ -23,6 +23,11 @@ import {
   buildStyleguideConfigDraft,
   resolveStyleguideConfig,
 } from "./prose-styleguide.js";
+import {
+  PROSE_STYLEGUIDE_SKILL_BASENAME,
+  PROSE_STYLEGUIDE_SKILL_DIRNAME,
+  buildProseStyleguideSkill,
+} from "./prose-styleguide-skill.js";
 import {
   REVIEW_BUNDLE_PROFILES,
   REVIEW_BUNDLE_STRICTNESS,
@@ -1513,6 +1518,90 @@ function createMcpServer() {
     }
   );
 
+  s.tool(
+    "setup_prose_styleguide_skill",
+    "Generate skills/prose-styleguide.md from the resolved prose styleguide config and universal craft rules.",
+    {
+      project_id: z.string().optional().describe("Optional project ID for scoped config resolution (e.g. 'the-lamb' or 'universe-1/book-1')."),
+      overwrite: z.boolean().optional().describe("If true, replaces an existing skills/prose-styleguide.md file."),
+    },
+    async ({ project_id, overwrite = false }) => {
+      if (project_id !== undefined) {
+        const projectIdCheck = validateProjectId(project_id);
+        if (!projectIdCheck.ok) {
+          return errorResponse("INVALID_PROJECT_ID", projectIdCheck.reason, { project_id });
+        }
+      }
+
+      if (!SYNC_DIR_WRITABLE) {
+        return errorResponse(
+          "SYNC_DIR_NOT_WRITABLE",
+          "Cannot write prose styleguide skill because WRITING_SYNC_DIR is not writable in this runtime.",
+          { sync_dir: SYNC_DIR_ABS }
+        );
+      }
+
+      const resolved = resolveStyleguideConfig({
+        syncDir: SYNC_DIR,
+        projectId: project_id,
+      });
+      if (!resolved.ok) {
+        return errorResponse(
+          resolved.error.code,
+          resolved.error.message,
+          resolved.error.details
+        );
+      }
+      if (resolved.setup_required || !resolved.resolved_config) {
+        return errorResponse(
+          "STYLEGUIDE_CONFIG_REQUIRED",
+          "Cannot generate prose-styleguide.md before prose-styleguide.config.yaml is set up.",
+          {
+            project_id: project_id ?? null,
+            next_step: "Run setup_prose_styleguide_config first.",
+          }
+        );
+      }
+
+      const skillPath = path.join(SYNC_DIR, PROSE_STYLEGUIDE_SKILL_DIRNAME, PROSE_STYLEGUIDE_SKILL_BASENAME);
+      if (!isPathCandidateInsideSyncDir(skillPath)) {
+        return errorResponse(
+          "INVALID_SKILL_PATH",
+          "Resolved prose styleguide skill path must be inside WRITING_SYNC_DIR.",
+          { target_path: path.resolve(skillPath), sync_dir: SYNC_DIR_ABS }
+        );
+      }
+
+      if (fs.existsSync(skillPath) && !overwrite) {
+        return errorResponse(
+          "STYLEGUIDE_SKILL_EXISTS",
+          "skills/prose-styleguide.md already exists. Set overwrite=true to replace it.",
+          { target_path: path.resolve(skillPath) }
+        );
+      }
+
+      const generated = buildProseStyleguideSkill({
+        resolvedConfig: resolved.resolved_config,
+        sources: resolved.sources,
+        projectId: project_id ?? null,
+      });
+      if (!generated.ok) {
+        return errorResponse(generated.error.code, generated.error.message);
+      }
+
+      fs.mkdirSync(path.dirname(skillPath), { recursive: true });
+      fs.writeFileSync(skillPath, generated.markdown, "utf8");
+
+      return jsonResponse({
+        ok: true,
+        file_path: path.resolve(skillPath),
+        project_id: project_id ?? null,
+        injected_rules: generated.injected_rules,
+        source_count: resolved.sources.length,
+      });
+    }
+  );
+
   // ---- preview_review_bundle ----------------------------------------------
   s.tool(
     "preview_review_bundle",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanna84/mcp-writing",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "MCP service for AI-assisted reasoning and editing on long-form fiction projects",
   "type": "module",
   "main": "index.js",
@@ -18,6 +18,7 @@
     "scene-character-normalization.js",
     "review-bundles.js",
     "prose-styleguide.js",
+    "prose-styleguide-skill.js",
     "scripts/",
     "README.md",
     "CHANGELOG.md"

package/prose-styleguide-skill.js

@@ -0,0 +1,125 @@
+export const PROSE_STYLEGUIDE_SKILL_DIRNAME = "skills";
+export const PROSE_STYLEGUIDE_SKILL_BASENAME = "prose-styleguide.md";
+
+const LANGUAGE_LABELS = {
+  english_us: "English (US)",
+  english_uk: "English (UK)",
+  english_au: "English (AU)",
+  english_ca: "English (CA)",
+  swedish: "Swedish",
+  norwegian: "Norwegian",
+  danish: "Danish",
+  finnish: "Finnish",
+  french: "French",
+  italian: "Italian",
+  russian: "Russian",
+  portuguese_pt: "Portuguese (PT)",
+  portuguese_br: "Portuguese (BR)",
+  german: "German",
+  dutch: "Dutch",
+  polish: "Polish",
+  czech: "Czech",
+  hungarian: "Hungarian",
+  spanish: "Spanish",
+  irish: "Irish",
+  japanese: "Japanese",
+  korean: "Korean",
+  chinese_traditional: "Chinese (Traditional)",
+  chinese_simplified: "Chinese (Simplified)",
+};
+
+const CONFIG_RULE_RENDERERS = {
+  language: (value) => `Primary writing language: ${LANGUAGE_LABELS[value] ?? value}.`,
+  spelling: (value) => `Spelling variant: ${value.toUpperCase()}.`,
+  quotation_style: (value) => {
+    const labels = {
+      double: "double quotes",
+      single: "single quotes",
+      guillemets: "guillemets (« »)",
+      low9: "low-9 quotation marks",
+      dialogue_dash_en: "Scandinavian en-dash dialogue",
+      dialogue_dash_em: "Spanish/Irish em-dash dialogue",
+      corner_brackets: "corner brackets (「 」)",
+    };
+    return `Dialogue quotation style: ${labels[value] ?? value}.`;
+  },
+  quotation_style_nested: (value) => `Nested quotation style: ${value}.`,
+  em_dash_spacing: (value) => `Em dash spacing: ${value}.`,
+  ellipsis_style: (value) => `Ellipsis style: ${value}.`,
+  abbreviation_periods: (value) => `Abbreviation periods: ${value}.`,
+  oxford_comma: (value) => `Oxford comma: ${value}.`,
+  numbers: (value) => `Number formatting rule: ${value}.`,
+  date_format: (value) => `Date format: ${value}.`,
+  time_format: (value) => `Time format: ${value}.`,
+  tense: (value) => `Default narrative tense: ${value}. Flag deviations as questions, not hard errors.`,
+  pov: (value) => `Default POV: ${value}. Flag shifts as intentional-or-drift questions.`,
+  dialogue_tags: (value) => `Dialogue tag policy: ${value}.`,
+  sentence_fragments: (value) => `Sentence fragments policy: ${value}.`,
+};
+
+export function buildProseStyleguideSkill({ resolvedConfig, sources = [], projectId = null }) {
+  if (!resolvedConfig || typeof resolvedConfig !== "object") {
+    return {
+      ok: false,
+      error: {
+        code: "INVALID_STYLEGUIDE_CONFIG",
+        message: "Cannot generate prose-styleguide.md without a resolved config object.",
+      },
+    };
+  }
+
+  const injectedRules = [];
+  for (const [field, renderRule] of Object.entries(CONFIG_RULE_RENDERERS)) {
+    if (resolvedConfig[field] === undefined) continue;
+    injectedRules.push(renderRule(resolvedConfig[field]));
+  }
+
+  const sourceLines = sources.length
+    ? sources.map((source) => `- ${source.scope}: ${source.file_path}`)
+    : ["- none"];
+
+  const voiceNotes = typeof resolvedConfig.voice_notes === "string" && resolvedConfig.voice_notes.trim()
+    ? resolvedConfig.voice_notes.trim().split("\n").map((line) => `> ${line}`).join("\n")
+    : "> None provided.";
+
+  const markdown = [
+    "# Prose Styleguide",
+    "",
+    "## Standing Order",
+    "Apply this styleguide by default for prose critique and edits. Preserve author voice over mechanical cleanup.",
+    "",
+    "## Resolved Scope",
+    `- Project scope: ${projectId ?? "sync-root default"}`,
+    ...sourceLines,
+    "",
+    "## Mechanical Conventions",
+    "These are injected from prose-styleguide.config.yaml and should be applied consistently:",
+    ...injectedRules.map((rule) => `- ${rule}`),
+    "",
+    "## Universal Craft Rules",
+    "- Identify scene purpose before proposing changes.",
+    "- Require transformation (emotional, relational, narrative, or thematic).",
+    "- Prefer critique before rewrite.",
+    "- Preserve cadence and specificity; avoid flattening voice.",
+    "- Ask before normalizing intentional instability (flashbacks, POV drift, syntax breaks).",
+    "",
+    "## Review Posture",
+    "- Prioritize structural issues, then convention drift, then line-level polish.",
+    "- Treat convention drift as a question when intent may be deliberate.",
+    "",
+    "## Edit Posture",
+    "- Do not shorten unless requested.",
+    "- Apply conventions consistently while preserving tone.",
+    "- Justify significant rewrites.",
+    "",
+    "## Voice Notes",
+    voiceNotes,
+    "",
+  ].join("\n");
+
+  return {
+    ok: true,
+    markdown,
+    injected_rules: injectedRules,
+  };
+}