novelforge-agent 0.3.0 → 0.4.0

package/README.md

@@ -171,7 +171,7 @@ NOVELFORGE_WORKSPACE = "/absolute/path/where/projects/should/live"
 ## Tool reference
 
 ### Project lifecycle
-- **`start_novel_project`** `(prompt, language?, outputDir?, targetChapters?, plannedTotalChapters?)` — create a new project under `<workspaceRoot>/<outputDir>/<slug>-<rand6>/` and return the first step's instruction. `targetChapters` is the per-batch planning size; MCP defaults to 5. `plannedTotalChapters` is the whole-book target; MCP defaults to 12.
+- **`start_novel_project`** `(prompt, language?, outputDir?, targetChapters?, plannedTotalChapters?)` — create a new project under `<workspaceRoot>/<outputDir>/<prompt-slug>-<rand6>/` and return the first step's instruction. After `novel_metadata` is accepted, the directory is renamed to `<title-slug>-<same-rand6>/`; callers must continue with the returned `state.projectPath`. `targetChapters` is the per-batch planning size; MCP defaults to 5. `plannedTotalChapters` is the whole-book target; MCP defaults to 12.
 - **`list_projects`** `(outputDir?)` — list all projects in the workspace, newest first.
 - **`get_project_status`** `(projectPath)` — compact summary: current step, chapters written, open threads, latest review verdict.
 - **`get_next_step`** `(projectPath)` — return the prompt + packed context for whatever the workflow expects next.
@@ -207,7 +207,7 @@ Dynamic planning is built into the state machine: after each accepted chapter an
 A project on disk:
 
 ```
-novels/<slug>-<rand6>/
+novels/<title-slug>-<rand6>/
 ├── agent-state.json              # workflow state (currentStep, currentChapter, files map, …)
 ├── novel.json                    # metadata (NovelMetadataSchema)
 ├── characters.json               # independent character state table

package/dist/src/core/fileNames.js

@@ -8,12 +8,12 @@ export function makeProjectSlug(title) {
     const replaced = title
         .trim()
         .split('')
-        .map((char) => PINYIN_FALLBACK[char] || char)
-        .join('-')
+        .map((char) => PINYIN_FALLBACK[char] ? `-${PINYIN_FALLBACK[char]}-` : char)
+        .join('')
         .normalize('NFKD')
         .replace(/[\u0300-\u036f]/g, '')
         .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/[^\p{Letter}\p{Number}]+/gu, '-')
         .replace(/^-+|-+$/g, '');
     return replaced || `novel-${Date.now()}`;
 }

package/dist/src/core/steps/novelMetadata.js

@@ -1,14 +1,59 @@
+import { access, rename } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
 import { NovelMetadataSchema } from '../schemas.js';
 import { saveJsonFile } from '../projectStore.js';
 import { initializeCharacterStates } from '../characterStore.js';
+import { makeProjectSlug } from '../fileNames.js';
 import { parseJson } from './types.js';
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function uniqueProjectPath(parentDir, baseName, currentPath) {
+    let candidate = join(parentDir, baseName);
+    if (candidate === currentPath || !(await pathExists(candidate)))
+        return candidate;
+    for (let index = 2; index < 100; index += 1) {
+        candidate = join(parentDir, `${baseName}-${index}`);
+        if (candidate === currentPath || !(await pathExists(candidate)))
+            return candidate;
+    }
+    throw new Error(`Unable to find available project directory for ${baseName}`);
+}
+async function renameProjectForTitle(projectPath, title) {
+    const parentDir = dirname(projectPath);
+    const currentName = basename(projectPath);
+    const suffix = currentName.match(/-([a-f0-9]{6})$/i)?.[1];
+    const titleSlug = makeProjectSlug(title);
+    const nextName = suffix ? `${titleSlug}-${suffix}` : titleSlug;
+    if (nextName === currentName)
+        return projectPath;
+    const nextPath = await uniqueProjectPath(parentDir, nextName, projectPath);
+    if (nextPath === projectPath)
+        return projectPath;
+    await rename(projectPath, nextPath);
+    return nextPath;
+}
 export const novelMetadataHandler = async (state, content) => {
     const parsed = NovelMetadataSchema.parse(parseJson(content));
     const path = await saveJsonFile(state.projectPath, 'novel.json', parsed);
     const charactersPath = await initializeCharacterStates(state.projectPath, parsed.coreCast);
+    const projectPath = await renameProjectForTitle(state.projectPath, parsed.title);
     return {
-        savedPaths: [path, charactersPath],
+        savedPaths: [
+            projectPath === state.projectPath ? path : join(projectPath, 'novel.json'),
+            projectPath === state.projectPath ? charactersPath : join(projectPath, 'characters.json'),
+        ],
         fileEntries: { novel: 'novel.json', characters: 'characters.json' },
-        next: { kind: 'linear', nextStep: 'story_bible' },
+        next: {
+            kind: 'linear',
+            nextStep: 'story_bible',
+            statePatch: { projectPath },
+        },
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novelforge-agent",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Local-first long-form novel workflow engine for any MCP host (Claude Code, Codex CLI, …) or CLI. State machine + zod schemas + BM25 retrieval + persistent project state. No LLM dependency.",
   "keywords": [
     "mcp",

package/src/core/fileNames.ts

@@ -9,12 +9,12 @@ export function makeProjectSlug(title: string): string {
   const replaced = title
     .trim()
     .split('')
-    .map((char) => PINYIN_FALLBACK[char] || char)
-    .join('-')
+    .map((char) => PINYIN_FALLBACK[char] ? `-${PINYIN_FALLBACK[char]}-` : char)
+    .join('')
     .normalize('NFKD')
     .replace(/[\u0300-\u036f]/g, '')
     .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/[^\p{Letter}\p{Number}]+/gu, '-')
     .replace(/^-+|-+$/g, '');
   return replaced || `novel-${Date.now()}`;
 }

package/src/core/steps/novelMetadata.ts

@@ -1,15 +1,61 @@
+import { access, rename } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
 import { NovelMetadataSchema } from '../schemas.js';
 import { saveJsonFile } from '../projectStore.js';
 import { initializeCharacterStates } from '../characterStore.js';
+import { makeProjectSlug } from '../fileNames.js';
 import { StepHandler, parseJson } from './types.js';
 
+async function pathExists(path: string): Promise<boolean> {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function uniqueProjectPath(parentDir: string, baseName: string, currentPath: string): Promise<string> {
+  let candidate = join(parentDir, baseName);
+  if (candidate === currentPath || !(await pathExists(candidate))) return candidate;
+
+  for (let index = 2; index < 100; index += 1) {
+    candidate = join(parentDir, `${baseName}-${index}`);
+    if (candidate === currentPath || !(await pathExists(candidate))) return candidate;
+  }
+
+  throw new Error(`Unable to find available project directory for ${baseName}`);
+}
+
+async function renameProjectForTitle(projectPath: string, title: string): Promise<string> {
+  const parentDir = dirname(projectPath);
+  const currentName = basename(projectPath);
+  const suffix = currentName.match(/-([a-f0-9]{6})$/i)?.[1];
+  const titleSlug = makeProjectSlug(title);
+  const nextName = suffix ? `${titleSlug}-${suffix}` : titleSlug;
+  if (nextName === currentName) return projectPath;
+
+  const nextPath = await uniqueProjectPath(parentDir, nextName, projectPath);
+  if (nextPath === projectPath) return projectPath;
+  await rename(projectPath, nextPath);
+  return nextPath;
+}
+
 export const novelMetadataHandler: StepHandler = async (state, content) => {
   const parsed = NovelMetadataSchema.parse(parseJson(content));
   const path = await saveJsonFile(state.projectPath, 'novel.json', parsed);
   const charactersPath = await initializeCharacterStates(state.projectPath, parsed.coreCast);
+  const projectPath = await renameProjectForTitle(state.projectPath, parsed.title);
   return {
-    savedPaths: [path, charactersPath],
+    savedPaths: [
+      projectPath === state.projectPath ? path : join(projectPath, 'novel.json'),
+      projectPath === state.projectPath ? charactersPath : join(projectPath, 'characters.json'),
+    ],
     fileEntries: { novel: 'novel.json', characters: 'characters.json' },
-    next: { kind: 'linear', nextStep: 'story_bible' },
+    next: {
+      kind: 'linear',
+      nextStep: 'story_bible',
+      statePatch: { projectPath },
+    },
   };
 };