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

openwriter 0.28.2 → 0.29.0

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 (8) hide show

package/dist/client/assets/{index-DMjEHT50.js → index-SAoCjUU-.js} +57 -57
package/dist/client/index.html +1 -1
package/dist/server/documents.js +16 -4
package/dist/server/index.js +25 -2
package/dist/server/mcp.js +13 -4
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-SAoCjUU-.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-Gdw1m46J.css">
   </head>
   <body>

package/dist/server/documents.js CHANGED Viewed

@@ -1108,7 +1108,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 +1118,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();

package/dist/server/index.js CHANGED Viewed

@@ -15,6 +15,7 @@ import { save, cancelDebouncedSave, load, getDocument, getTitle, getFilePath, ge
 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 { 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,12 @@ 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);

package/dist/server/mcp.js CHANGED Viewed

@@ -497,8 +497,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 +534,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 +587,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.0",
   "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.
 ```