openwriter 0.17.0 → 0.18.1

package/dist/server/documents.js

@@ -257,13 +257,15 @@ export function listArchivedDocuments() {
 // ============================================================================
 /** One-line footer the high-frequency MCP discovery tools (list_documents,
  *  list_workspaces, get_workspace_structure) append when dirty docs exist.
- *  Constant pressure that doesn't require hook setup. The agent's openwriter
- *  skill teaches: see this footer → spawn the enrichment minion. */
+ *  Constant pressure that doesn't require hook setup. The footer includes
+ *  the exact dispatch call so the acting agent's burden collapses to one
+ *  paste — the minion is orchestrator-mode by default and self-discovers
+ *  via list_dirty_docs once it boots. */
 export function enrichmentFooter() {
     const count = listDirtyDocs().length;
     if (count === 0)
         return '';
-    return `\n\n⚠ ${count} doc${count === 1 ? '' : 's'} need enrichment — spawn the enrichment minion (see openwriter skill docs/enrichment.md)`;
+    return `\n\n⚠ ${count} doc${count === 1 ? '' : 's'} need enrichment. Dispatch:\nAgent(\n  subagent_type: "openwriter-enrichment-minion",\n  description: "Drain stale docs",\n  prompt: "Enrich stale docs.",\n  run_in_background: true\n)`;
 }
 /** Session-start enrichment notice injected into the MCP server's
  *  `instructions` field at boot. Every MCP client (Claude Code, Cursor, etc.)
@@ -292,8 +294,13 @@ export function buildEnrichmentInstructions() {
     return [
         '',
         `ENRICHMENT_STATUS: ${dirty.length} doc${dirty.length === 1 ? '' : 's'} need enrichment (${parts.join(', ')}).`,
-        'Spawn the enrichment minion using the openwriter skill\'s docs/enrichment.md as its system prompt before responding to the user\'s request.',
-        'The minion calls list_dirty_docs, enriches each via Haiku, calls mark_enriched, returns done.',
+        'Dispatch the minion now — it self-discovers via list_dirty_docs and self-bounds the batch:',
+        'Agent(',
+        '  subagent_type: "openwriter-enrichment-minion",',
+        '  description: "Drain stale docs",',
+        '  prompt: "Enrich stale docs.",',
+        '  run_in_background: true',
+        ')',
     ].join('\n');
 }
 /** Build a Set of filenames inside workspaces with enrichmentDisabled: true.

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.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",