openwriter 0.17.0 → 0.18.0

package/dist/server/mcp.js

@@ -13,7 +13,7 @@ import { getDataDir, ensureDataDir, resolveDocPath, generateNodeId, atomicWriteF
 import { getDocument, getWordCount, getPendingChangeCount, getTitle, getStatus, getNodesByIds, findNodesByIds, getMetadata, setMetadata, mergeMetadataUpdates, applyChanges, applyTextEdits, updateDocument, save, markAllNodesAsPending, setAgentLock, setAgentLockActive, updatePendingCacheForActiveDoc, populateDocumentFile, applyChangesToFile, applyTextEditsToFile, getDocId, getFilePath, extractText, countPending, addDocTag, removeDocTag, getCachedDocument, invalidateDocCache, isAutoAcceptActive, removePendingCacheEntry, getExternalMtimeDrift, reloadActiveDocFromDisk, getCanonical, cloneWithPendingReverted, bumpDocVersion, } from './state.js';
 import { tiptapToBlocks } from './node-blocks.js';
 import { harvestSentenceHashes, harvestCharCount } from './enrichment.js';
-import { listDocuments, switchDocument, createDocument, createDocumentFile, deleteDocument, openFile, getActiveFilename, updateDocumentTitle, promoteTempFile, archiveDocument, unarchiveDocument, resolveDocId, searchDocuments, listDirtyDocs, crawlDocs, enrichmentFooter, buildEnrichmentInstructions } from './documents.js';
+import { listDocuments, switchDocument, createDocument, createDocumentFile, deleteDocument, openFile, getActiveFilename, updateDocumentTitle, promoteTempFile, archiveDocument, unarchiveDocument, resolveDocId, filenameByDocId, searchDocuments, listDirtyDocs, crawlDocs, enrichmentFooter, buildEnrichmentInstructions } from './documents.js';
 import { extractForwardLinks } from './backlinks.js';
 import { logger, generateRequestId, withRequestId } from './logger.js';
 import { broadcastDocumentSwitched, broadcastDocumentsChanged, broadcastWorkspacesChanged, broadcastTitleChanged, broadcastMetadataChanged, broadcastPendingDocsChanged, broadcastWritingStarted, broadcastWritingFinished, broadcastCommentsChanged } from './ws.js';
@@ -414,8 +414,9 @@ export const TOOL_REGISTRY = [
             empty: z.boolean().optional().describe('ONLY for content_type template docs (tweets, articles) that start blank. Skips the spinner and switches immediately. Do NOT set this for content documents — use the two-step flow (create_document → populate_document) instead.'),
             content_type: z.enum(['document', 'tweet', 'reply', 'quote', 'article', 'linkedin', 'newsletter', 'blog']).describe('Required. Use "document" for plain documents. Tweet/reply/quote/article/linkedin/newsletter/blog set type-specific metadata automatically.'),
             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.'),
         },
-        handler: async ({ title, path, workspace, container, empty, content_type, url }) => {
+        handler: async ({ title, path, workspace, container, empty, content_type, url, afterId }) => {
             // 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").` }] };
@@ -457,7 +458,10 @@ export const TOOL_REGISTRY = [
                     }
                     let wsInfo = '';
                     if (wsTarget) {
-                        addDoc(wsTarget.wsFilename, wsTarget.containerId, result.filename, result.title);
+                        // Resolve afterId: it may be a docId (8-char hex) or containerId.
+                        // filenameByDocId resolves docId→filename; if null, treat as containerId.
+                        const afterRef = afterId ? (filenameByDocId(afterId) ?? afterId) : null;
+                        addDoc(wsTarget.wsFilename, wsTarget.containerId, result.filename, result.title, afterRef);
                         wsInfo = ` → workspace "${workspace}"${container ? ` / ${container}` : ''}`;
                     }
                     const newDocId = getDocId();
@@ -478,7 +482,8 @@ export const TOOL_REGISTRY = [
                 const result = createDocumentFile(title, path, typeMeta);
                 let wsInfo = '';
                 if (wsTarget) {
-                    addDoc(wsTarget.wsFilename, wsTarget.containerId, result.filename, result.title);
+                    const afterRef = afterId ? (filenameByDocId(afterId) ?? afterId) : null;
+                    addDoc(wsTarget.wsFilename, wsTarget.containerId, result.filename, result.title, afterRef);
                     wsInfo = ` → workspace "${workspace}"${container ? ` / ${container}` : ''}`;
                 }
                 // Broadcast spinner keyed by filename so populate_document can clear exactly
@@ -586,6 +591,7 @@ export const TOOL_REGISTRY = [
                 container: z.string().optional().describe('Container name within the workspace (e.g. "Chapters"). Requires workspace.'),
                 url: z.string().optional().describe('Tweet URL — REQUIRED for content_type "reply" or "quote".'),
                 path: z.string().optional().describe('Absolute file path to create the document at. If omitted, creates in ~/.openwriter/.'),
+                afterId: z.string().optional().describe('Place the new doc immediately after this docId or containerId inside its parent. Omit to append to the bottom (default, ascending-order convention). Requires workspace.'),
             })).min(1).describe('List of documents to declare (minimum 1).'),
         },
         handler: async ({ writes }) => {
@@ -612,7 +618,8 @@ export const TOOL_REGISTRY = [
                     const typeMeta = resolveTypeMeta(w.content_type, w.url);
                     const result = createDocumentFile(w.title, w.path, typeMeta);
                     if (wsTarget) {
-                        addDoc(wsTarget.wsFilename, wsTarget.containerId, result.filename, result.title);
+                        const afterRef = w.afterId ? (filenameByDocId(w.afterId) ?? w.afterId) : null;
+                        addDoc(wsTarget.wsFilename, wsTarget.containerId, result.filename, result.title, afterRef);
                     }
                     broadcastWritingStarted(w.title, wsTarget, result.filename);
                     broadcastedKeys.push(result.filename);
@@ -1090,9 +1097,13 @@ export const TOOL_REGISTRY = [
             workspaceFile: z.string().describe('Workspace manifest filename'),
             name: z.string().describe('Container name (e.g. "Chapters", "Research")'),
             parentContainerId: z.string().optional().describe('Parent container ID for nesting (null = root level)'),
+            afterId: z.string().optional().describe('Place the new container 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).'),
         },
-        handler: async ({ workspaceFile, name, parentContainerId }) => {
-            const result = addContainerToWorkspace(workspaceFile, parentContainerId ?? null, name);
+        handler: async ({ workspaceFile, name, parentContainerId, afterId }) => {
+            // Resolve afterId: may be docId (8-char hex) or containerId. filenameByDocId
+            // resolves docId→filename; if null, treat as containerId.
+            const afterRef = afterId ? (filenameByDocId(afterId) ?? afterId) : null;
+            const result = addContainerToWorkspace(workspaceFile, parentContainerId ?? null, name, afterRef);
             broadcastWorkspacesChanged();
             return { content: [{ type: 'text', text: `Created container "${name}" (id:${result.containerId})` }] };
         },

package/dist/server/workspace-tree.js

@@ -89,10 +89,13 @@ export function addDocToContainer(root, containerId, file, title, afterIdentifie
         }
     }
     else {
-        target.unshift(doc);
+        // Default: append to the bottom of the parent's child list. This matches
+        // the ascending-order convention (newest at bottom, oldest at top). Callers
+        // that want top-insertion must pass an explicit afterIdentifier.
+        target.push(doc);
     }
 }
-export function addContainer(root, parentContainerId, name) {
+export function addContainer(root, parentContainerId, name, afterIdentifier) {
     const depth = getContainerDepth(root, parentContainerId);
     if (depth >= MAX_DEPTH) {
         throw new Error(`Maximum nesting depth (${MAX_DEPTH}) reached`);
@@ -106,7 +109,19 @@ export function addContainer(root, parentContainerId, name) {
         name,
         items: [],
     };
-    target.unshift(container);
+    if (afterIdentifier) {
+        const afterIdx = target.findIndex((n) => (n.type === 'doc' && n.file === afterIdentifier) || (n.type === 'container' && n.id === afterIdentifier));
+        if (afterIdx === -1) {
+            target.push(container);
+        }
+        else {
+            target.splice(afterIdx + 1, 0, container);
+        }
+    }
+    else {
+        // Default: append to the bottom (ascending-order convention).
+        target.push(container);
+    }
     return container;
 }
 // ============================================================================

package/dist/server/workspaces.js

@@ -210,9 +210,9 @@ export function reorderDoc(wsFile, file, afterFile) {
 // ============================================================================
 // CONTAINER OPERATIONS
 // ============================================================================
-export function addContainerToWorkspace(wsFile, parentContainerId, name) {
+export function addContainerToWorkspace(wsFile, parentContainerId, name, afterIdentifier) {
     const ws = getWorkspace(wsFile);
-    const container = addContainerToTree(ws.root, parentContainerId, name);
+    const container = addContainerToTree(ws.root, parentContainerId, name, afterIdentifier ?? null);
     writeWorkspace(wsFile, ws);
     return { workspace: ws, containerId: container.id };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openwriter",
-  "version": "0.17.0",
+  "version": "0.18.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",