@hanna84/mcp-writing 2.4.0 → 2.5.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.5.0](https://github.com/hannasdev/mcp-writing.git
+/compare/v2.4.0...v2.5.0)
+
+- feat(styleguide): add prose styleguide bootstrap suggestions [`#87`](https://github.com/hannasdev/mcp-writing.git
+/pull/87)
+
 #### [v2.4.0](https://github.com/hannasdev/mcp-writing.git
 /compare/v2.3.0...v2.4.0)
 
+> 26 April 2026
+
 - feat(styleguide): add config update preview and prose drift checks [`#86`](https://github.com/hannasdev/mcp-writing.git
 /pull/86)
+- Release 2.4.0 [`1655c06`](https://github.com/hannasdev/mcp-writing.git
+/commit/1655c06088824e608c2795b61707b963e541c3fb)
 
 #### [v2.3.0](https://github.com/hannasdev/mcp-writing.git
 /compare/v2.2.0...v2.3.0)

package/index.js

@@ -27,6 +27,7 @@ import {
   updateStyleguideConfig,
 } from "./prose-styleguide.js";
 import {
+  detectStyleguideSignals,
   analyzeSceneStyleguideDrift,
   suggestStyleguideUpdatesFromScenes,
 } from "./prose-styleguide-drift.js";
@@ -1554,7 +1555,10 @@ function createMcpServer() {
         return errorResponse(
           "STYLEGUIDE_CONFIG_REQUIRED",
           "Cannot summarize prose styleguide config before prose-styleguide.config.yaml is set up.",
-          { project_id: project_id ?? null }
+          {
+            project_id: project_id ?? null,
+            next_step: "Run setup_prose_styleguide_config or bootstrap_prose_styleguide_config.",
+          }
         );
       }
 
@@ -1576,6 +1580,101 @@ function createMcpServer() {
     }
   );
 
+  s.tool(
+    "bootstrap_prose_styleguide_config",
+    "Detect dominant prose conventions from existing scenes and suggest initial prose-styleguide config values.",
+    {
+      project_id: z.string().describe("Project ID to analyze (e.g. 'the-lamb' or 'universe-1/book-1')."),
+      scene_ids: z.array(z.string()).optional().describe("Optional scene_id allowlist to analyze."),
+      part: z.number().int().optional().describe("Optional part filter."),
+      chapter: z.number().int().optional().describe("Optional chapter filter."),
+      max_scenes: z.number().int().positive().optional().describe("Maximum number of scenes to analyze (default: 50)."),
+      min_agreement: z.number().min(0).max(1).optional().describe("Minimum agreement ratio for suggested fields (default: 0.6)."),
+      min_evidence: z.number().int().positive().optional().describe("Minimum number of observed scenes per field before suggesting it (default: 3)."),
+      include_scene_signals: z.boolean().optional().describe("If true, include per-scene detected signals in the response."),
+    },
+    async ({
+      project_id,
+      scene_ids,
+      part,
+      chapter,
+      max_scenes = 50,
+      min_agreement = 0.6,
+      min_evidence = 3,
+      include_scene_signals = false,
+    }) => {
+      const projectIdCheck = validateProjectId(project_id);
+      if (!projectIdCheck.ok) {
+        return errorResponse("INVALID_PROJECT_ID", projectIdCheck.reason, { project_id });
+      }
+
+      const targetResolution = resolveBatchTargetScenes(db, {
+        projectId: project_id,
+        sceneIds: scene_ids,
+        part,
+        chapter,
+        onlyStale: false,
+      });
+      if (!targetResolution.ok) {
+        return errorResponse(targetResolution.code, targetResolution.message, targetResolution.details);
+      }
+
+      const targetScenes = targetResolution.rows;
+      if (targetScenes.length === 0) {
+        return errorResponse(
+          "NOT_FOUND",
+          `No scenes were found for project '${project_id}' with the requested filters.`,
+          { project_id, scene_ids: scene_ids ?? null, part: part ?? null, chapter: chapter ?? null }
+        );
+      }
+
+      if (targetScenes.length > max_scenes) {
+        return errorResponse(
+          "VALIDATION_ERROR",
+          `Matched ${targetScenes.length} scenes, which exceeds max_scenes=${max_scenes}.`,
+          { matched_scenes: targetScenes.length, max_scenes, project_id }
+        );
+      }
+
+      const sceneSignals = [];
+      let unreadableScenes = 0;
+
+      for (const scene of targetScenes) {
+        try {
+          const raw = fs.readFileSync(scene.file_path, "utf8");
+          const prose = matter(raw).content;
+          sceneSignals.push({
+            scene_id: scene.scene_id,
+            observed: detectStyleguideSignals(prose),
+          });
+        } catch {
+          unreadableScenes += 1;
+          sceneSignals.push({
+            scene_id: scene.scene_id,
+            observed: {},
+          });
+        }
+      }
+
+      const suggestedConfig = suggestStyleguideUpdatesFromScenes({
+        sceneAnalyses: sceneSignals,
+        resolvedConfig: null,
+        minAgreement: min_agreement,
+        minEvidence: min_evidence,
+      });
+
+      return jsonResponse({
+        ok: true,
+        project_id,
+        checked_scenes: sceneSignals.length,
+        unreadable_scenes: unreadableScenes,
+        suggested_config: suggestedConfig,
+        next_step: "Review suggested_config, then write accepted fields via update_prose_styleguide_config.",
+        scene_signals: include_scene_signals ? sceneSignals : undefined,
+      });
+    }
+  );
+
   s.tool(
     "update_prose_styleguide_config",
     "Update an existing prose-styleguide.config.yaml at sync-root or project-root scope by writing only explicit field changes.",
@@ -1764,7 +1863,10 @@ function createMcpServer() {
         return errorResponse(
           "STYLEGUIDE_CONFIG_REQUIRED",
           "Cannot check prose styleguide drift before prose-styleguide.config.yaml is set up.",
-          { project_id }
+          {
+            project_id,
+            next_step: "Run setup_prose_styleguide_config or bootstrap_prose_styleguide_config.",
+          }
         );
       }
 
@@ -1883,7 +1985,7 @@ function createMcpServer() {
           "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.",
+            next_step: "Run setup_prose_styleguide_config or bootstrap_prose_styleguide_config first.",
           }
         );
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanna84/mcp-writing",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "MCP service for AI-assisted reasoning and editing on long-form fiction projects",
   "type": "module",
   "main": "index.js",