@hanna84/mcp-writing 1.8.0 → 1.9.0

package/CHANGELOG.md

@@ -4,11 +4,31 @@ 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).
 
+#### [v1.9.0](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.8.1...v1.9.0)
+
+- feat: add status field to update_scene_metadata and add update_place_sheet tool [`#53`](https://github.com/hannasdev/mcp-writing.git
+/pull/53)
+
+#### [v1.8.1](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.8.0...v1.8.1)
+
+> 19 April 2026
+
+- Fix inferProjectAndUniverse misidentifying two-segment universe paths under projects/ [`#51`](https://github.com/hannasdev/mcp-writing.git
+/pull/51)
+- Release 1.8.1 [`3e97cfa`](https://github.com/hannasdev/mcp-writing.git
+/commit/3e97cfaef2fc55421d43fda4157408a71ae39518)
+
 #### [v1.8.0](https://github.com/hannasdev/mcp-writing.git
 /compare/v1.7.0...v1.8.0)
 
+> 19 April 2026
+
 - feat(search): index metadata keywords in scenes FTS and preserve legacy index data [`#50`](https://github.com/hannasdev/mcp-writing.git
 /pull/50)
+- Release 1.8.0 [`5e3c4fd`](https://github.com/hannasdev/mcp-writing.git
+/commit/5e3c4fd6fa4caade6540d3228bfa52ee5f42c923)
 
 #### [v1.7.0](https://github.com/hannasdev/mcp-writing.git
 /compare/v1.6.3...v1.7.0)

package/README.md

@@ -322,6 +322,7 @@ Outcome: you get AI speed with explicit approval and recoverable history for eve
 | `enrich_scene` | Re-derive lightweight metadata from current prose and clear `metadata_stale` |
 | `update_scene_metadata` | Write metadata fields back to a scene sidecar |
 | `update_character_sheet` | Write fields back to a character sidecar |
+| `update_place_sheet` | Write fields back to a place sidecar |
 | `flag_scene` | Mark a scene with a flag for AI follow-up |
 | `propose_edit` | Stage a scene revision for review without writing it |
 | `commit_edit` | Apply a staged prose edit and create a git-backed snapshot |

package/index.js

@@ -1219,6 +1219,7 @@ function createMcpServer() {
       fields: z.object({
         title:             z.string().optional(),
         logline:           z.string().optional(),
+        status:            z.string().optional().describe("Workflow status (e.g. 'draft', 'revision', 'complete'). Free text — no fixed vocabulary."),
         save_the_cat_beat: z.string().optional(),
         pov:               z.string().optional(),
         part:              z.number().int().optional(),
@@ -1311,6 +1312,45 @@ function createMcpServer() {
     }
   );
 
+  // ---- update_place_sheet --------------------------------------------------
+  s.tool(
+    "update_place_sheet",
+    "Update structured metadata fields for a place (name, associated_characters, tags). Writes to the .meta.yaml sidecar — never modifies the prose notes file. Changes are immediately reflected in the index. Only available when the sync dir is writable.",
+    {
+      place_id: z.string().describe("The place_id to update (e.g. 'place-harbor-district'). Use list_places to find valid IDs."),
+      fields: z.object({
+        name:                  z.string().optional(),
+        associated_characters: z.array(z.string()).optional(),
+        tags:                  z.array(z.string()).optional(),
+      }).describe("Fields to update. Only supplied keys are changed."),
+    },
+    async ({ place_id, fields }) => {
+      if (!SYNC_DIR_WRITABLE) {
+        return errorResponse("READ_ONLY", "Cannot update place: sync dir is read-only.");
+      }
+      const place = db.prepare(`SELECT file_path FROM places WHERE place_id = ?`).get(place_id);
+      if (!place) {
+        return errorResponse("NOT_FOUND", `Place '${place_id}' not found.`);
+      }
+      try {
+        const { meta } = readMeta(place.file_path, SYNC_DIR, { writable: true });
+        const updated = { ...meta, ...fields };
+        writeMeta(place.file_path, updated);
+
+        // Update DB directly
+        db.prepare(`UPDATE places SET name = ? WHERE place_id = ?`)
+          .run(updated.name ?? meta.name ?? place_id, place_id);
+
+        return { content: [{ type: "text", text: `Updated place sheet for '${place_id}'.` }] };
+      } catch (err) {
+        if (err.code === "ENOENT") {
+          return errorResponse("STALE_PATH", `Place file for '${place_id}' not found at indexed path — the file may have moved. Run sync() to refresh.`, { indexed_path: place.file_path });
+        }
+        return errorResponse("IO_ERROR", `Failed to write place metadata for '${place_id}': ${err.message}`);
+      }
+    }
+  );
+
   // ---- flag_scene ----------------------------------------------------------
   s.tool(
     "flag_scene",

package/metadata-lint.js

@@ -35,6 +35,7 @@ const sceneSchema = z.object({
   pov: z.string().min(1).optional(),
   logline: z.string().min(1).optional(),
   save_the_cat_beat: z.string().min(1).optional(),
+  status: z.string().min(1).optional(),
   timeline_position: z.number().int().optional(),
   story_time: z.string().min(1).optional(),
   word_count: z.number().int().nonnegative().optional(),

package/package.json

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

package/sync.js

@@ -96,17 +96,66 @@ export function normalizeSceneMetaForPath(syncDir, filePath, meta = {}) {
   };
 }
 
+// Structural directory names that are never project slugs under projects/<id>/.
+const PROJECT_STRUCTURAL_DIRS = new Set(["world", "scenes", "misc", "fragments", "feedback", "draft"]);
+
+// Cache universe project root existence checks during sync scans.
+const UNIVERSE_PROJECT_ROOT_CACHE = new Map();
+
+// Returns true for known structural path segments directly under a project root
+// (named dirs like "world", "scenes", and part-N / chapter-N path segments).
+function isProjectStructuralDir(name) {
+  const normalized = String(name ?? "").toLowerCase();
+  return PROJECT_STRUCTURAL_DIRS.has(normalized)
+    || /^part-\d+$/.test(normalized)
+    || /^chapter-\d+$/.test(normalized);
+}
+
+function isBookSlug(name) {
+  return /^book-[a-z0-9][a-z0-9-]*$/i.test(String(name ?? ""));
+}
+
+function hasUniverseProjectRoot(syncDir, universeId, projectSlug) {
+  const key = `${syncDir}::${universeId}/${projectSlug}`;
+  if (UNIVERSE_PROJECT_ROOT_CACHE.has(key)) {
+    return UNIVERSE_PROJECT_ROOT_CACHE.get(key);
+  }
+
+  const exists = fs.existsSync(path.join(syncDir, "universes", universeId, projectSlug));
+  UNIVERSE_PROJECT_ROOT_CACHE.set(key, exists);
+  return exists;
+}
+
 export function inferProjectAndUniverse(syncDir, filePath) {
   const rel = path.relative(syncDir, filePath);
   const parts = rel.split(path.sep);
 
   if (parts[0] === "universes" && parts.length >= 3) {
+    // Case-sensitive "world" intentionally matches isWorldFile() which also uses lowercase.
     if (parts[2] === "world") {
       return { universe_id: parts[1], project_id: null };
     }
     return { universe_id: parts[1], project_id: `${parts[1]}/${parts[2]}` };
   }
   if (parts[0] === "projects" && parts.length >= 2) {
+    // Detect accidental two-segment layout: projects/<universe>/<book>/...
+    // This occurs when a universe-scoped project_id (e.g. "universe-1/book-1-the-lamb")
+    // is written under projects/ instead of universes/.
+    // Detection is deliberately conservative to avoid mis-classifying valid nested
+    // project layouts (e.g. projects/my-novel/notes/...). All three conditions must hold:
+    //   1. parts[2] matches a book-* slug pattern (book-1, book-one, book-1-the-lamb, …)
+    //   2. parts[3] is a known structural directory (scenes, world, part-N, chapter-N, …)
+    //   3. A matching universes/<universe>/<book> directory exists on disk
+    if (
+      parts.length >= 4
+      && parts[2] !== undefined
+      && parts[3] !== undefined
+      && isBookSlug(parts[2])
+      && isProjectStructuralDir(parts[3])
+      && hasUniverseProjectRoot(syncDir, parts[1], parts[2])
+    ) {
+      return { universe_id: parts[1], project_id: `${parts[1]}/${parts[2]}` };
+    }
     return { universe_id: null, project_id: parts[1] };
   }
   return { universe_id: null, project_id: parts[0] ?? "default" };
@@ -539,6 +588,10 @@ export function indexSceneFile(db, syncDir, file, meta, prose) {
 }
 
 export function syncAll(db, syncDir, { quiet = false, writable = false } = {}) {
+  // Reset per-run inference cache so filesystem changes between sync calls
+  // (for example after imports or path repairs) are reflected immediately.
+  UNIVERSE_PROJECT_ROOT_CACHE.clear();
+
   const files = walkFiles(syncDir);
   let indexed = 0;
   let staleMarked = 0;