npm - openwriter - Versions diffs - 0.28.2 → 0.29.1 - Mend

openwriter 0.28.2 → 0.29.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/client/assets/{index-DMjEHT50.js → index-DHaZI7nA.js} +57 -57
package/dist/client/index.html +1 -1
package/dist/server/content-type-meta.js +20 -0
package/dist/server/documents.js +88 -4
package/dist/server/index.js +45 -3
package/dist/server/mcp.js +14 -17
package/dist/server/prompt-debug.js +68 -0
package/package.json +1 -1
package/skill/SKILL.md +3 -1

package/dist/client/index.html CHANGED Viewed

@@ -10,7 +10,7 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Charter:ital,wght@0,400;0,700;1,400&family=Crimson+Pro:ital,wght@0,300;0,400;0,600;0,700;1,400&family=DM+Sans:ital,wght@0,400;0,500;0,600;0,700;1,400&family=DM+Serif+Display&family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans:wght@400;500;600&family=Inter:wght@400;500;600;700&family=Libre+Baskerville:ital,wght@0,400;0,700;1,400&family=Literata:ital,opsz,wght@0,7..72,400;0,7..72,600;0,7..72,700;1,7..72,400&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,600;1,6..72,400&family=Playfair+Display:wght@400;600;700;900&family=Source+Serif+4:ital,opsz,wght@0,8..60,400;0,8..60,600;0,8..60,700;1,8..60,400&family=Space+Grotesk:wght@400;500;600;700&family=Space+Mono:wght@400;700&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-DMjEHT50.js"></script>
+    <script type="module" crossorigin src="/assets/index-DHaZI7nA.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-Gdw1m46J.css">
   </head>
   <body>

package/dist/server/content-type-meta.js ADDED Viewed

@@ -0,0 +1,20 @@
+// Single source of truth for content-type scaffolding metadata. Maps a
+// content_type to the frontmatter it needs: the `content_type` field itself
+// (which owns the editor surface — adr: adr/browser-write-fidelity.md) plus the
+// type's context object (tweetContext / articleContext / blogContext / …).
+//
+// Used by both the MCP create_document handler and the HTTP POST /api/documents
+// endpoint (the "Create variant" path) so a typed empty doc is scaffolded the
+// same way regardless of who creates it. adr: docs/variants.md
+export function resolveTypeMeta(type, url) {
+    switch (type) {
+        case 'tweet': return { content_type: 'tweet', tweetContext: { mode: 'tweet' } };
+        case 'reply': return { content_type: 'reply', tweetContext: { mode: 'reply', ...(url ? { url } : {}) } };
+        case 'quote': return { content_type: 'quote', tweetContext: { mode: 'quote', ...(url ? { url } : {}) } };
+        case 'article': return { content_type: 'article', articleContext: { active: true } };
+        case 'linkedin': return { content_type: 'linkedin', linkedinContext: { active: true } };
+        case 'newsletter': return { content_type: 'newsletter', newsletterContext: { active: true } };
+        case 'blog': return { content_type: 'blog', blogContext: { active: true } };
+        default: return undefined;
+    }
+}

package/dist/server/documents.js CHANGED Viewed

@@ -8,6 +8,7 @@ import { join } from 'path';
 import matter from 'gray-matter';
 import trash from 'trash';
 import { tiptapToMarkdownChecked, markdownToTiptap } from './markdown.js';
+import { resolveTypeMeta } from './content-type-meta.js';
 import { parseMarkdownContent } from './compact.js';
 import { getDocument, getTitle, getFilePath, getIsTemp, getMetadata, save, cancelDebouncedSave, setActiveDocument, registerExternalDoc, unregisterExternalDoc, getExternalDocs, cacheActiveDocument, getCachedDocument, invalidateDocCache, removePendingCacheEntry, resetDocVersion, markAsAgentStub, unmarkAgentStub, isAgentStub, } from './state.js';
 import { getDataDir, TEMP_PREFIX, ensureDataDir, filePathForTitle, tempFilePath, generateNodeId, resolveDocPath, isExternalDoc, atomicWriteFileSync, canonicalizePath } from './helpers.js';
@@ -1108,7 +1109,7 @@ export function openFile(fullPath) {
     const filename = isExternalDoc(canonPath) ? canonPath : baseName;
     return { document: getDocument(), title: getTitle(), filename };
 }
-export function duplicateDocument(filename) {
+export function duplicateDocument(filename, variant) {
     // Cancel any pending debounced save, then save current doc immediately
     cancelDebouncedSave();
     save();
@@ -1118,17 +1119,29 @@ export function duplicateDocument(filename) {
     }
     const raw = readFileSync(sourcePath, 'utf-8');
     const parsed = markdownToTiptap(raw);
+    // Title suffix: variants read as "(Tweet)" / "(Blog)", plain copies as "(Copy)".
+    const suffix = variant?.variantType
+        ? variant.variantType.charAt(0).toUpperCase() + variant.variantType.slice(1)
+        : 'Copy';
     // Generate deduplicated title
-    let newTitle = `${parsed.title} (Copy)`;
+    let newTitle = `${parsed.title} (${suffix})`;
     let filePath = filePathForTitle(newTitle);
     if (existsSync(filePath)) {
         let counter = 2;
-        while (existsSync(filePathForTitle(`${parsed.title} (Copy ${counter})`)))
+        while (existsSync(filePathForTitle(`${parsed.title} (${suffix} ${counter})`)))
             counter++;
-        newTitle = `${parsed.title} (Copy ${counter})`;
+        newTitle = `${parsed.title} (${suffix} ${counter})`;
         filePath = filePathForTitle(newTitle);
     }
     const metadata = { ...parsed.metadata, title: newTitle, docId: generateNodeId() };
+    // Variant relationship — set AFTER the spread so it overrides any inherited
+    // masterDocId/variantType from the source doc. masterDocId points at the
+    // source (the master); variantType labels this copy's intended format.
+    // adr: docs/variants.md
+    if (variant?.masterDocId)
+        metadata.masterDocId = variant.masterDocId;
+    if (variant?.variantType)
+        metadata.variantType = variant.variantType;
     setActiveDocument(parsed.document, newTitle, filePath, false, undefined, metadata);
     const { markdown } = tiptapToMarkdownChecked(parsed.document, newTitle, metadata);
     ensureDataDir();
@@ -1136,6 +1149,77 @@ export function duplicateDocument(filename) {
     const newFilename = filePath.split(/[/\\]/).pop();
     return { document: getDocument(), title: getTitle(), filename: newFilename };
 }
+// Content types that surface an editable title/headline above the body. For
+// these, the doc's frontmatter `title` IS content (blog headline, article title,
+// newsletter subject). For every other type the title is just a sidebar label
+// and the body carries everything. adr: docs/variants.md
+const TITLE_BEARING_TYPES = new Set(['blog', 'article', 'newsletter']);
+/**
+ * Create a variant of `masterFilename` retyped as `variantType`, nested under
+ * the master. Field-projection model (NOT a verbatim clone — that's
+ * duplicateDocument): port the fields the two types share.
+ *  - body: always ported.
+ *  - downcast (title-bearing master → body-only variant): the master's title is
+ *    folded into the body as its first paragraph so the headline isn't lost.
+ *  - the variant is scaffolded with the TARGET type's content_type + context;
+ *    the source's context objects (blogContext, tweetContext, …) are NOT
+ *    inherited — a variant is a new typed doc, not a surface clone.
+ * adr: docs/variants.md
+ */
+export function createVariant(masterFilename, opts) {
+    cancelDebouncedSave();
+    save();
+    const sourcePath = resolveDocPath(masterFilename);
+    if (!existsSync(sourcePath))
+        throw new Error(`Document not found: ${masterFilename}`);
+    const raw = readFileSync(sourcePath, 'utf-8');
+    const parsed = markdownToTiptap(raw);
+    const srcType = deriveContentType(parsed.metadata) || 'document';
+    const tgtType = opts.variantType;
+    const srcTitleBearing = TITLE_BEARING_TYPES.has(srcType);
+    const tgtTitleBearing = TITLE_BEARING_TYPES.has(tgtType);
+    // Body projection. Downcast (title-bearing → body-only): prepend the master's
+    // title as the first paragraph so the headline survives in a surface with no
+    // title field ("title becomes first line, body the next paragraph"). Otherwise
+    // the body ports unchanged.
+    let bodyContent = parsed.document.content || [];
+    if (srcTitleBearing && !tgtTitleBearing && parsed.title) {
+        bodyContent = [
+            { type: 'paragraph', content: [{ type: 'text', text: parsed.title }] },
+            ...bodyContent,
+        ];
+    }
+    const bodyDoc = { ...parsed.document, content: bodyContent };
+    // Title is always label-suffixed: it doubles as the filename + sidebar name,
+    // so it must stay unique vs the master (a raw duplicate title would collide).
+    // The title CONTENT still rides along for title-bearing targets — they render
+    // it as the headline and the user trims the suffix.
+    const Label = tgtType.charAt(0).toUpperCase() + tgtType.slice(1);
+    let newTitle = `${parsed.title} (${Label})`;
+    let filePath = filePathForTitle(newTitle);
+    if (existsSync(filePath)) {
+        let counter = 2;
+        while (existsSync(filePathForTitle(`${parsed.title} (${Label} ${counter})`)))
+            counter++;
+        newTitle = `${parsed.title} (${Label} ${counter})`;
+        filePath = filePathForTitle(newTitle);
+    }
+    // Fresh metadata: target type scaffold + variant relationship only. Source
+    // context objects are intentionally dropped (see header).
+    const metadata = {
+        title: newTitle,
+        docId: generateNodeId(),
+        ...(resolveTypeMeta(tgtType) || {}),
+        masterDocId: opts.masterDocId,
+        variantType: tgtType,
+    };
+    setActiveDocument(bodyDoc, newTitle, filePath, false, undefined, metadata);
+    const { markdown } = tiptapToMarkdownChecked(bodyDoc, newTitle, metadata);
+    ensureDataDir();
+    atomicWriteFileSync(filePath, markdown);
+    const newFilename = filePath.split(/[/\\]/).pop();
+    return { document: getDocument(), title: getTitle(), filename: newFilename };
+}
 export function getActiveFilename() {
     const filePath = getFilePath();
     // For external docs, return the full path as the identifier

package/dist/server/index.js CHANGED Viewed

@@ -14,7 +14,8 @@ import { zodToJsonSchema } from 'zod-to-json-schema';
 import { save, cancelDebouncedSave, load, getDocument, getTitle, getFilePath, getDocId, getMetadata, getStatus, updateDocument, setMetadata, applyTextEdits, isAgentLocked, getPendingDocInfo, getDocTagsByFilename, addDocTag, removeDocTag, markAllNodesAsPending, updatePendingCacheForActiveDoc, removePendingCacheEntry, clearAllCaches, stripPendingAttrs, stripPendingAttrsFromFile, setAutoAcceptOnFile, setSortRequestOnFile, clearSortRequestOnFile, bumpDocVersion, markAsAgentStub, extractText } from './state.js';
 import { syncPostHistory } from './post-sync.js';
 import { enrollManualPostForAutoplug } from './autoplug-enroll.js';
-import { listDocuments, switchDocument, createDocument, deleteDocument, duplicateDocument, reloadDocument, updateDocumentTitle, openFile, reorderDocs, searchDocuments, listArchivedDocuments, archiveDocument, unarchiveDocument, getActiveFilename, batchResolve, listPendingSorts } from './documents.js';
+import { listDocuments, switchDocument, createDocument, deleteDocument, duplicateDocument, createVariant, reloadDocument, updateDocumentTitle, openFile, reorderDocs, searchDocuments, listArchivedDocuments, archiveDocument, unarchiveDocument, getActiveFilename, batchResolve, listPendingSorts } from './documents.js';
+import { writePromptDebug, isPromptDebugEnabled } from './prompt-debug.js';
 import { createWorkspaceRouter } from './workspace-routes.js';
 import { createLinkRouter } from './link-routes.js';
 import { createTweetRouter } from './tweet-routes.js';
@@ -224,6 +225,28 @@ export async function startHttpServer(options = {}) {
             res.status(500).json({ error: err.message });
         }
     });
+    // Prompt debug inspector: write the realized AV prompt to a timestamped .md doc
+    // for hand review. Off by default — gated by OW_PROMPT_DEBUG (see docs/prompt-debug.md).
+    // When off, no-ops so the client POST stays harmless.
+    app.post('/api/prompt-debug', (req, res) => {
+        try {
+            if (!isPromptDebugEnabled()) {
+                res.json({ success: false, skipped: true });
+                return;
+            }
+            const { action, debug, metadata } = req.body;
+            if (!debug) {
+                res.status(400).json({ error: 'debug payload is required' });
+                return;
+            }
+            const filename = writePromptDebug(action, debug, metadata);
+            broadcastDocumentsChanged();
+            res.json({ success: true, filename });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
     // Toggle auto-accept on a workspace or container. Inherits to every doc inside.
     // Body: { wsFile, containerId?, enabled }. Omit containerId to target the
     // whole workspace; pass it to target a specific container.
@@ -601,12 +624,31 @@ export async function startHttpServer(options = {}) {
     });
     app.post('/api/documents/duplicate', (req, res) => {
         try {
-            const { filename } = req.body;
+            const { filename, masterDocId, variantType } = req.body;
             if (!filename) {
                 res.status(400).json({ error: 'filename is required' });
                 return;
             }
-            const result = duplicateDocument(filename);
+            const result = duplicateDocument(filename, (masterDocId || variantType) ? { masterDocId, variantType } : undefined);
+            broadcastDocumentSwitched(result.document, result.title, result.filename);
+            broadcastDocumentsChanged();
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    // Create variant: a retyped derivative nested under the master. Field-projection
+    // (body always; title folds into body on downcast; target type scaffolded) —
+    // NOT a verbatim clone (that's /duplicate). adr: docs/variants.md
+    app.post('/api/documents/variant', (req, res) => {
+        try {
+            const { filename, masterDocId, variantType } = req.body;
+            if (!filename || !masterDocId || !variantType) {
+                res.status(400).json({ error: 'filename, masterDocId, and variantType are required' });
+                return;
+            }
+            const result = createVariant(filename, { masterDocId, variantType });
             broadcastDocumentSwitched(result.document, result.title, result.filename);
             broadcastDocumentsChanged();
             res.json(result);

package/dist/server/mcp.js CHANGED Viewed

@@ -14,6 +14,7 @@ import { getDocument, getWordCount, getPendingChangeCount, getTitle, getStatus,
 import { tiptapToBlocks } from './node-blocks.js';
 import { outline, peek, searchInDoc, truncateRead } from './peek-outline.js';
 import { harvestSentenceHashes, harvestCharCount } from './enrichment.js';
+import { resolveTypeMeta } from './content-type-meta.js';
 import { listDocuments, switchDocument, createDocument, createDocumentFile, deleteDocument, openFile, getActiveFilename, promoteTempFile, archiveDocument, unarchiveDocument, resolveDocId, filenameByDocId, searchDocuments, listDirtyDocs, crawlDocs, enrichmentFooter, buildEnrichmentInstructions, listPendingSorts, sortFooter, buildSortInstructions, stagePendingTitle } from './documents.js';
 import { readFrontmatter, writeFrontmatter, computeBacklinksFor, invalidateBacklinksCache } from './backlinks.js';
 import { logger, generateRequestId, withRequestId } from './logger.js';
@@ -29,19 +30,6 @@ import { tiptapToMarkdown, splitFusedParagraphs } from './markdown.js';
 import { loadDocFromDisk } from './pending-overlay.js';
 import { getComments, getCommentCount, getGlobalCommentSummary, resolveComments } from './comments.js';
 import { readTasks, addTask, updateTask, removeTask } from './tasks.js';
-/** Map a content type string to its frontmatter metadata object. */
-function resolveTypeMeta(type, url) {
-    switch (type) {
-        case 'tweet': return { content_type: 'tweet', tweetContext: { mode: 'tweet' } };
-        case 'reply': return { content_type: 'reply', tweetContext: { mode: 'reply', ...(url ? { url } : {}) } };
-        case 'quote': return { content_type: 'quote', tweetContext: { mode: 'quote', ...(url ? { url } : {}) } };
-        case 'article': return { content_type: 'article', articleContext: { active: true } };
-        case 'linkedin': return { content_type: 'linkedin', linkedinContext: { active: true } };
-        case 'newsletter': return { content_type: 'newsletter', newsletterContext: { active: true } };
-        case 'blog': return { content_type: 'blog', blogContext: { active: true } };
-        default: return undefined;
-    }
-}
 /** Resolve a docId to a full document target. Fast path for active doc (zero I/O). */
 function resolveDocTarget(docId) {
     const filename = resolveDocId(docId);
@@ -497,8 +485,10 @@ export const TOOL_REGISTRY = [
             url: z.string().optional().describe('Tweet URL — REQUIRED for content_type "reply" or "quote" (e.g. "https://x.com/user/status/123"). Sets tweetContext.url automatically. Ignored for other content types.'),
             afterId: z.string().optional().describe('Place the new doc immediately after this docId (8-char hex) or containerId inside its parent. Omit to append to the bottom of the parent (the default — matches ascending-order convention: newest at bottom). Requires workspace.'),
             status: z.enum(['canonical', 'draft']).optional().describe('Agent-owned lifecycle. "canonical" = committed to spine / load-bearing for the workspace (use for Beats docs that have locked, Research Notes, Master References). "draft" = working / not load-bearing yet / scratch (DUMP docs, first-pass beats). Defaults to "draft" when omitted. Change later via set_metadata({ status: ... }) on lifecycle transitions. v0.19.0.'),
+            masterDocId: z.string().optional().describe('Make this doc a VARIANT of another doc. Pass the master doc\'s docId (8-char hex). The variant nests under its master in the sidebar (expandable tree). Use when creating a derivative — e.g. a tweet thread from a blog post. Pair with variantType. See docs/variants.md.'),
+            variantType: z.string().optional().describe('Label for what kind of variant this is (e.g. "tweet", "blog", "linkedin"). Shows as a badge in the sidebar. Only meaningful alongside masterDocId.'),
         },
-        handler: async ({ title, path, workspace, container, empty, content_type, url, afterId, status }) => {
+        handler: async ({ title, path, workspace, container, empty, content_type, url, afterId, status, masterDocId, variantType }) => {
             // Require url for reply/quote
             if ((content_type === 'reply' || content_type === 'quote') && !url) {
                 return { content: [{ type: 'text', text: `Error: content_type "${content_type}" requires a url parameter (e.g. "https://x.com/user/status/123").` }] };
@@ -532,13 +522,20 @@ export const TOOL_REGISTRY = [
             // canonical via set_metadata({ status: "canonical" }) on lifecycle
             // transitions. See brief 2026-05-21-simplify-enrichment-schema-three-fields.
             const statusMeta = { status: status ?? 'draft' };
+            // Variant relationship (optional) — lands on the first disk write so the
+            // doc nests under its master in the sidebar immediately. See docs/variants.md.
+            const variantMeta = {};
+            if (masterDocId)
+                variantMeta.masterDocId = masterDocId;
+            if (variantType)
+                variantMeta.variantType = variantType;
             try {
                 if (empty) {
                     // Immediate switch — no spinner, no populate_document needed
                     const result = createDocument(title, undefined, path);
                     setAgentLock(result.filename);
-                    // Apply status + type-specific metadata in one merge
-                    const initMeta = { ...statusMeta };
+                    // Apply status + variant + type-specific metadata in one merge
+                    const initMeta = { ...statusMeta, ...variantMeta };
                     if (content_type) {
                         const typeMeta = resolveTypeMeta(content_type, url);
                         if (typeMeta)
@@ -578,7 +575,7 @@ export const TOOL_REGISTRY = [
                 // Merge status with any content-type metadata so it lands on the first
                 // disk write.
                 const typeMeta = content_type ? resolveTypeMeta(content_type, url) : undefined;
-                const initialMeta = { ...statusMeta, ...(typeMeta || {}) };
+                const initialMeta = { ...statusMeta, ...variantMeta, ...(typeMeta || {}) };
                 const result = createDocumentFile(title, path, initialMeta);
                 let wsInfo = '';
                 if (wsTarget) {

package/dist/server/prompt-debug.js ADDED Viewed

@@ -0,0 +1,68 @@
+/**
+ * File: prompt-debug.ts
+ * Purpose: Write AV prompt debug data to timestamped .md files for inspection.
+ *   Each enhance creates a new `_prompt-<action>-<ts>.md` doc in the data dir,
+ *   visible in the OpenWriter sidebar — so the exact system+user prompt that was
+ *   sent to the AI can be reviewed by hand.
+ * Control: gated by isPromptDebugEnabled() (OW_PROMPT_DEBUG env). Off by default.
+ *   See docs/prompt-debug.md for the on/off switch.
+ */
+import { getDataDir, ensureDataDir, atomicWriteFileSync } from './helpers.js';
+import { join } from 'path';
+/** True when the prompt-debug inspector is switched on. Read lazily so the
+ *  process picks up OW_PROMPT_DEBUG without code changes. */
+export function isPromptDebugEnabled() {
+    const v = process.env.OW_PROMPT_DEBUG;
+    return v === '1' || v === 'true';
+}
+/**
+ * Write prompt debug info to a timestamped markdown file.
+ * Returns the filename created.
+ */
+export function writePromptDebug(action, debug, metadata) {
+    ensureDataDir();
+    const now = new Date();
+    const ts = now.toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const filename = `_prompt-${action || 'debug'}-${ts}.md`;
+    const filePath = join(getDataDir(), filename);
+    const timeStr = now.toLocaleTimeString('en-US', { hour12: true, hour: '2-digit', minute: '2-digit', second: '2-digit' });
+    let md = `---\ntitle: "Prompt Debug: ${action} @ ${timeStr}"\n---\n\n`;
+    // Metadata summary
+    if (metadata) {
+        md += `## Metadata\n\n`;
+        md += `| Key | Value |\n|-----|-------|\n`;
+        if (metadata.action)
+            md += `| Action | ${metadata.action} |\n`;
+        if (metadata.profileUsed)
+            md += `| Profile | ${metadata.profileUsed} |\n`;
+        if (metadata.nodesIn != null)
+            md += `| Nodes In | ${metadata.nodesIn} |\n`;
+        if (metadata.nodesOut != null)
+            md += `| Nodes Out | ${metadata.nodesOut} |\n`;
+        if (metadata.ragExamples != null)
+            md += `| RAG Examples | ${metadata.ragExamples} |\n`;
+        if (metadata.ragTotalWords != null)
+            md += `| RAG Total Words | ${metadata.ragTotalWords} |\n`;
+        if (metadata.processingTimeMs != null)
+            md += `| Processing Time | ${metadata.processingTimeMs}ms |\n`;
+        if (metadata.estimatedCost != null)
+            md += `| Estimated Cost | $${metadata.estimatedCost.toFixed(4)} |\n`;
+        md += `\n`;
+    }
+    // System prompt
+    md += `## System Prompt\n\n`;
+    md += debug.systemPrompt + '\n\n';
+    // User prompt
+    md += `---\n\n## User Prompt\n\n`;
+    md += debug.userPrompt + '\n\n';
+    // RAG examples
+    if (debug.ragExamples && debug.ragExamples.length > 0) {
+        md += `---\n\n## RAG Examples (${debug.ragExamples.length})\n\n`;
+        for (const ex of debug.ragExamples) {
+            md += `### ${ex.anchor} (${ex.wordCount} words)\n\n`;
+            md += ex.context + '\n\n';
+        }
+    }
+    atomicWriteFileSync(filePath, md);
+    return filename;
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "openwriter",
-  "version": "0.28.2",
+  "version": "0.29.1",
   "description": "The open-source writing surface for AI agents. Markdown-native editor with pending change review — your agent writes, you accept or reject.",
   "type": "module",
   "license": "MIT",

package/skill/SKILL.md CHANGED Viewed

@@ -16,7 +16,7 @@ description: |
   Requires: OpenWriter MCP server configured. Browser UI at localhost:5050.
 metadata:
   author: travsteward
-  version: "0.16.3"
+  version: "0.16.4"
   repository: https://github.com/travsteward/openwriter
 license: MIT
 ---
@@ -346,6 +346,8 @@ This eliminates the need for separate `create_workspace`, `create_container`, an
 ### Batched Creation (multiple docs at once)
+**Variants** — when repurposing a doc into another format (a thread off a blog post, a LinkedIn cut of a newsletter), pass `create_document({ masterDocId, variantType })` so the new doc nests under its master in the sidebar instead of floating off as a disconnected doc. Users do the same via right-click → "Create variant".
 When creating **two or more documents together** — a tweet thread saved as separate docs, a series of blog drafts, newsletter variants, a workspace populated with several files — use `declare_writes` instead of looping `create_document`. It's one tool call, registers all sidebar spinners atomically, and survives app refreshes.
 ```