openwriter 0.1.0

package/dist/server/workspaces.js

@@ -0,0 +1,257 @@
+/**
+ * Workspace manifest CRUD for OpenWriter v2.
+ * Unified container model: containers (ordered/unordered) hold docs, tags are cross-cutting.
+ * Manifests live in ~/.openwriter/_workspaces/*.json.
+ */
+import { existsSync, readFileSync, writeFileSync, unlinkSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { randomUUID } from 'crypto';
+import matter from 'gray-matter';
+import { WORKSPACES_DIR, ensureWorkspacesDir, sanitizeFilename, resolveDocPath } from './helpers.js';
+const ORDER_FILE = join(WORKSPACES_DIR, '_order.json');
+import { isV1, migrateV1toV2 } from './workspace-types.js';
+import { addDocToContainer, addContainer as addContainerToTree, removeNode, moveNode, reorderNode, findContainer, collectAllFiles, countDocs, findDocNode } from './workspace-tree.js';
+import { addTag, removeTag, removeFileFromAllTags, listTagsForFile } from './workspace-tags.js';
+// ============================================================================
+// INTERNAL HELPERS
+// ============================================================================
+function workspacePath(filename) {
+    return join(WORKSPACES_DIR, filename);
+}
+function readWorkspace(filename) {
+    const raw = readFileSync(workspacePath(filename), 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (isV1(parsed)) {
+        const migrated = migrateV1toV2(parsed);
+        writeWorkspace(filename, migrated);
+        return migrated;
+    }
+    return parsed;
+}
+function writeWorkspace(filename, workspace) {
+    writeFileSync(workspacePath(filename), JSON.stringify(workspace, null, 2), 'utf-8');
+}
+function readOrder() {
+    try {
+        if (!existsSync(ORDER_FILE))
+            return [];
+        return JSON.parse(readFileSync(ORDER_FILE, 'utf-8'));
+    }
+    catch {
+        return [];
+    }
+}
+function writeOrder(order) {
+    writeFileSync(ORDER_FILE, JSON.stringify(order, null, 2), 'utf-8');
+}
+function readDocFrontmatter(filename) {
+    try {
+        const filePath = resolveDocPath(filename);
+        if (!existsSync(filePath))
+            return null;
+        const raw = readFileSync(filePath, 'utf-8');
+        const { data } = matter(raw);
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// CRUD
+// ============================================================================
+export function listWorkspaces() {
+    ensureWorkspacesDir();
+    const files = readdirSync(WORKSPACES_DIR).filter((f) => f.endsWith('.json') && f !== '_order.json');
+    const infos = files.map((f) => {
+        try {
+            const ws = readWorkspace(f);
+            return { filename: f, title: ws.title, docCount: countDocs(ws.root) };
+        }
+        catch {
+            return null;
+        }
+    }).filter((b) => b !== null);
+    // Sort by persisted order; unknown workspaces append at end
+    const order = readOrder();
+    if (order.length === 0)
+        return infos;
+    const orderIndex = new Map(order.map((f, i) => [f, i]));
+    infos.sort((a, b) => {
+        const ai = orderIndex.get(a.filename) ?? Infinity;
+        const bi = orderIndex.get(b.filename) ?? Infinity;
+        return ai - bi;
+    });
+    return infos;
+}
+export function getWorkspace(filename) {
+    ensureWorkspacesDir();
+    const p = workspacePath(filename);
+    if (!existsSync(p))
+        throw new Error(`Workspace not found: ${filename}`);
+    return readWorkspace(filename);
+}
+export function createWorkspace(options) {
+    ensureWorkspacesDir();
+    const { title, voiceProfileId = null } = options;
+    const slug = sanitizeFilename(title).toLowerCase().replace(/\s+/g, '-');
+    const filename = `${slug}-${randomUUID().slice(0, 8)}.json`;
+    const workspace = { version: 2, title, voiceProfileId, root: [], tags: {} };
+    writeWorkspace(filename, workspace);
+    // Append to order
+    const order = readOrder();
+    order.push(filename);
+    writeOrder(order);
+    return { filename, title, docCount: 0 };
+}
+export function deleteWorkspace(filename) {
+    ensureWorkspacesDir();
+    const p = workspacePath(filename);
+    if (!existsSync(p))
+        throw new Error(`Workspace not found: ${filename}`);
+    unlinkSync(p);
+    // Remove from order
+    const order = readOrder();
+    const idx = order.indexOf(filename);
+    if (idx >= 0) {
+        order.splice(idx, 1);
+        writeOrder(order);
+    }
+}
+export function reorderWorkspaces(orderedFilenames) {
+    ensureWorkspacesDir();
+    writeOrder(orderedFilenames);
+}
+// ============================================================================
+// DOC OPERATIONS
+// ============================================================================
+export function addDoc(wsFile, containerId, file, title, afterFile) {
+    const ws = getWorkspace(wsFile);
+    addDocToContainer(ws.root, containerId, file, title, afterFile);
+    writeWorkspace(wsFile, ws);
+    return ws;
+}
+export function removeDoc(wsFile, file) {
+    const ws = getWorkspace(wsFile);
+    removeNode(ws.root, file);
+    removeFileFromAllTags(ws.tags, file);
+    writeWorkspace(wsFile, ws);
+    return ws;
+}
+export function moveDoc(wsFile, file, targetContainerId, afterFile) {
+    const ws = getWorkspace(wsFile);
+    moveNode(ws.root, file, targetContainerId, afterFile);
+    writeWorkspace(wsFile, ws);
+    return ws;
+}
+export function reorderDoc(wsFile, file, afterFile) {
+    const ws = getWorkspace(wsFile);
+    reorderNode(ws.root, file, afterFile);
+    writeWorkspace(wsFile, ws);
+    return ws;
+}
+// ============================================================================
+// CONTAINER OPERATIONS
+// ============================================================================
+export function addContainerToWorkspace(wsFile, parentContainerId, name) {
+    const ws = getWorkspace(wsFile);
+    const container = addContainerToTree(ws.root, parentContainerId, name);
+    writeWorkspace(wsFile, ws);
+    return { workspace: ws, containerId: container.id };
+}
+export function removeContainer(wsFile, containerId) {
+    const ws = getWorkspace(wsFile);
+    const found = findContainer(ws.root, containerId);
+    if (!found)
+        throw new Error(`Container "${containerId}" not found`);
+    // Collect files in container to clean up tags
+    const files = collectAllFiles(found.node.items || []);
+    removeNode(ws.root, containerId);
+    for (const file of files)
+        removeFileFromAllTags(ws.tags, file);
+    writeWorkspace(wsFile, ws);
+    return ws;
+}
+export function renameContainer(wsFile, containerId, name) {
+    const ws = getWorkspace(wsFile);
+    const found = findContainer(ws.root, containerId);
+    if (!found)
+        throw new Error(`Container "${containerId}" not found`);
+    found.node.name = name;
+    writeWorkspace(wsFile, ws);
+    return ws;
+}
+export function reorderContainer(wsFile, containerId, afterIdentifier) {
+    const ws = getWorkspace(wsFile);
+    reorderNode(ws.root, containerId, afterIdentifier);
+    writeWorkspace(wsFile, ws);
+    return ws;
+}
+// ============================================================================
+// TAG OPERATIONS
+// ============================================================================
+export function tagDoc(wsFile, file, tag) {
+    const ws = getWorkspace(wsFile);
+    if (!findDocNode(ws.root, file))
+        throw new Error(`Document "${file}" not in workspace`);
+    addTag(ws.tags, tag, file);
+    writeWorkspace(wsFile, ws);
+    return ws;
+}
+export function untagDoc(wsFile, file, tag) {
+    const ws = getWorkspace(wsFile);
+    removeTag(ws.tags, tag, file);
+    writeWorkspace(wsFile, ws);
+    return ws;
+}
+export function getDocTags(wsFile, file) {
+    const ws = getWorkspace(wsFile);
+    return listTagsForFile(ws.tags, file);
+}
+// ============================================================================
+// CONTEXT
+// ============================================================================
+export function updateWorkspaceContext(wsFile, context) {
+    const ws = getWorkspace(wsFile);
+    ws.context = { ...ws.context, ...context };
+    writeWorkspace(wsFile, ws);
+    return ws;
+}
+export function getItemContext(wsFile, docFile) {
+    const ws = getWorkspace(wsFile);
+    const found = findDocNode(ws.root, docFile);
+    if (!found)
+        throw new Error(`Document "${docFile}" not found in workspace`);
+    const tags = listTagsForFile(ws.tags, docFile);
+    return {
+        workspaceTitle: ws.title,
+        workspaceContext: ws.context || {},
+        tags,
+    };
+}
+// ============================================================================
+// CROSS-WORKSPACE QUERIES
+// ============================================================================
+export function getWorkspaceAssignedFiles() {
+    const assigned = new Set();
+    const workspaces = listWorkspaces();
+    for (const info of workspaces) {
+        try {
+            const ws = readWorkspace(info.filename);
+            for (const file of collectAllFiles(ws.root))
+                assigned.add(file);
+        }
+        catch { /* skip corrupt manifests */ }
+    }
+    return assigned;
+}
+export function getWorkspaceStructure(filename) {
+    return getWorkspace(filename);
+}
+/** Read the frontmatter title for a doc file. Falls back to filename without extension. */
+export function getDocTitle(filename) {
+    const fm = readDocFrontmatter(filename);
+    if (fm?.title && fm.title !== 'Untitled')
+        return fm.title;
+    return filename.replace(/\.md$/, '');
+}

package/dist/server/ws.js

@@ -0,0 +1,211 @@
+/**
+ * WebSocket handler: pushes NodeChanges to browser, receives doc updates + signals.
+ */
+import { WebSocketServer, WebSocket } from 'ws';
+import { updateDocument, getDocument, getTitle, getFilePath, getDocId, setMetadata, save, onChanges, isAgentLocked, getPendingDocFilenames, getPendingDocCounts, stripPendingAttrs, } from './state.js';
+import { switchDocument, createDocument, deleteDocument } from './documents.js';
+const clients = new Set();
+let currentAgentConnected = false;
+// Debounced auto-save: persist to disk 2s after last doc-update
+let saveTimer = null;
+function debouncedSave() {
+    if (saveTimer)
+        clearTimeout(saveTimer);
+    saveTimer = setTimeout(() => {
+        save();
+        console.log('[WS] Auto-saved to disk');
+    }, 2000);
+}
+export function setupWebSocket(server) {
+    const wss = new WebSocketServer({ server });
+    // Push agent changes to all browser clients
+    onChanges((changes) => {
+        const msg = JSON.stringify({ type: 'node-changes', changes });
+        for (const ws of clients) {
+            if (ws.readyState === WebSocket.OPEN) {
+                ws.send(msg);
+            }
+        }
+        // Notify browser of updated pending docs list (debounced)
+        broadcastPendingDocsChanged();
+    });
+    wss.on('connection', (ws) => {
+        clients.add(ws);
+        console.log(`[WS] Client connected (total: ${clients.size})`);
+        // Send current agent status to newly connected client
+        ws.send(JSON.stringify({ type: 'agent-status', agentConnected: currentAgentConnected }));
+        // Send current sync status if available
+        if (lastSyncStatus) {
+            ws.send(JSON.stringify({ type: 'sync-status', ...lastSyncStatus }));
+        }
+        // Always send authoritative document state on connect — forces browser to adopt server state
+        // (prevents stale browser tabs from displaying old content)
+        const filePath = getFilePath();
+        const filename = filePath ? filePath.split(/[/\\]/).pop() || '' : '';
+        ws.send(JSON.stringify({
+            type: 'document-switched',
+            document: getDocument(),
+            title: getTitle(),
+            filename,
+            docId: getDocId(),
+        }));
+        // Send pending docs info on connect
+        ws.send(JSON.stringify({
+            type: 'pending-docs-changed',
+            pendingDocs: {
+                filenames: getPendingDocFilenames(),
+                counts: getPendingDocCounts(),
+            },
+        }));
+        ws.on('message', (data) => {
+            try {
+                const msg = JSON.parse(data.toString());
+                if (msg.type === 'doc-update' && msg.document) {
+                    if (isAgentLocked()) {
+                        // Agent write in progress — ignore browser doc-updates
+                    }
+                    else {
+                        updateDocument(msg.document);
+                        debouncedSave();
+                    }
+                }
+                // Browser requests fresh state on reconnect (instead of pushing stale state)
+                if (msg.type === 'request-document') {
+                    const filePath = getFilePath();
+                    const filename = filePath ? filePath.split(/[/\\]/).pop() || '' : '';
+                    ws.send(JSON.stringify({
+                        type: 'document-switched',
+                        document: getDocument(),
+                        title: getTitle(),
+                        filename,
+                        docId: getDocId(),
+                    }));
+                }
+                if (msg.type === 'title-update' && msg.title) {
+                    setMetadata({ title: msg.title });
+                    debouncedSave();
+                }
+                if (msg.type === 'save') {
+                    save();
+                }
+                if (msg.type === 'switch-document' && msg.filename) {
+                    try {
+                        const result = switchDocument(msg.filename);
+                        broadcastDocumentSwitched(result.document, result.title, result.filename);
+                    }
+                    catch (err) {
+                        console.error('[WS] Switch document failed:', err.message);
+                    }
+                }
+                if (msg.type === 'create-document') {
+                    try {
+                        const result = createDocument(msg.title);
+                        broadcastDocumentSwitched(result.document, result.title, result.filename);
+                    }
+                    catch (err) {
+                        console.error('[WS] Create document failed:', err.message);
+                    }
+                }
+                if (msg.type === 'pending-resolved' && msg.filename) {
+                    const action = msg.action; // 'accept' or 'reject'
+                    const resolvedFilename = msg.filename;
+                    if (action === 'reject' && msg.wasAgentCreated) {
+                        // Agent-created doc with all content rejected → delete the file
+                        try {
+                            deleteDocument(resolvedFilename);
+                        }
+                        catch (err) {
+                            console.error('[WS] Failed to delete rejected agent doc:', err.message);
+                        }
+                    }
+                    // Strip pending attrs that transferPendingAttrs() re-added from stale server state,
+                    // then save clean markdown to disk.
+                    stripPendingAttrs();
+                    save();
+                    broadcastPendingDocsChanged();
+                }
+            }
+            catch {
+                // Ignore malformed messages
+            }
+        });
+        ws.on('close', () => {
+            clients.delete(ws);
+            console.log(`[WS] Client disconnected (total: ${clients.size})`);
+        });
+    });
+}
+export function broadcastDocumentSwitched(document, title, filename) {
+    const msg = JSON.stringify({ type: 'document-switched', document, title, filename, docId: getDocId() });
+    for (const ws of clients) {
+        if (ws.readyState === WebSocket.OPEN) {
+            ws.send(msg);
+        }
+    }
+}
+export function broadcastDocumentsChanged() {
+    const msg = JSON.stringify({ type: 'documents-changed' });
+    for (const ws of clients) {
+        if (ws.readyState === WebSocket.OPEN) {
+            ws.send(msg);
+        }
+    }
+}
+export function broadcastWorkspacesChanged() {
+    const msg = JSON.stringify({ type: 'workspaces-changed' });
+    for (const ws of clients) {
+        if (ws.readyState === WebSocket.OPEN)
+            ws.send(msg);
+    }
+}
+export function broadcastTitleChanged(title) {
+    const msg = JSON.stringify({ type: 'title-changed', title });
+    for (const ws of clients) {
+        if (ws.readyState === WebSocket.OPEN)
+            ws.send(msg);
+    }
+}
+// Debounced: getPendingDocCounts() scans all files on disk + parses YAML.
+// Rapid agent writes would trigger this scan on every change batch.
+let pendingDocsTimer = null;
+const PENDING_DOCS_DEBOUNCE_MS = 500;
+export function broadcastPendingDocsChanged() {
+    if (pendingDocsTimer)
+        clearTimeout(pendingDocsTimer);
+    pendingDocsTimer = setTimeout(() => {
+        pendingDocsTimer = null;
+        const msg = JSON.stringify({
+            type: 'pending-docs-changed',
+            pendingDocs: {
+                filenames: getPendingDocFilenames(),
+                counts: getPendingDocCounts(),
+            },
+        });
+        for (const ws of clients) {
+            if (ws.readyState === WebSocket.OPEN)
+                ws.send(msg);
+        }
+    }, PENDING_DOCS_DEBOUNCE_MS);
+}
+export function broadcastAgentStatus(connected) {
+    currentAgentConnected = connected;
+    const msg = JSON.stringify({ type: 'agent-status', agentConnected: connected });
+    for (const ws of clients) {
+        if (ws.readyState === WebSocket.OPEN) {
+            ws.send(msg);
+        }
+    }
+}
+let lastSyncStatus = null;
+export function broadcastSyncStatus(status) {
+    lastSyncStatus = status;
+    const msg = JSON.stringify({ type: 'sync-status', ...status });
+    for (const ws of clients) {
+        if (ws.readyState === WebSocket.OPEN) {
+            ws.send(msg);
+        }
+    }
+}
+export function getLastSyncStatus() {
+    return lastSyncStatus;
+}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "openwriter",
+  "version": "0.1.0",
+  "description": "Local TipTap editor for human-agent collaboration via MCP",
+  "type": "module",
+  "license": "MIT",
+  "author": "Travis Steward",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/travsteward/openwriter.git"
+  },
+  "homepage": "https://github.com/travsteward/openwriter",
+  "bugs": "https://github.com/travsteward/openwriter/issues",
+  "keywords": [
+    "editor",
+    "tiptap",
+    "mcp",
+    "ai",
+    "writing",
+    "agent",
+    "local-first",
+    "markdown",
+    "rich-text",
+    "human-agent-collaboration"
+  ],
+  "bin": {
+    "openwriter": "./dist/bin/pad.js"
+  },
+  "scripts": {
+    "dev": "concurrently \"vite\" \"tsx watch server/index.ts\"",
+    "build": "vite build && tsc -p tsconfig.server.json",
+    "preview": "node dist/bin/pad.js",
+    "lint": "eslint src server bin --ext .ts,.tsx"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@tiptap/core": "^3.0.0",
+    "@tiptap/extension-code-block-lowlight": "^3.19.0",
+    "@tiptap/extension-highlight": "^3.19.0",
+    "@tiptap/extension-image": "^3.19.0",
+    "@tiptap/extension-link": "^3.19.0",
+    "@tiptap/extension-placeholder": "^3.0.0",
+    "@tiptap/extension-subscript": "^3.19.0",
+    "@tiptap/extension-superscript": "^3.19.0",
+    "@tiptap/extension-table": "^3.19.0",
+    "@tiptap/extension-task-item": "^3.19.0",
+    "@tiptap/extension-task-list": "^3.19.0",
+    "@tiptap/extension-text-style": "^3.0.0",
+    "@tiptap/extension-typography": "^3.19.0",
+    "@tiptap/extension-underline": "^3.0.0",
+    "@tiptap/extension-unique-id": "^3.0.0",
+    "@tiptap/pm": "^3.0.0",
+    "@tiptap/react": "^3.0.0",
+    "@tiptap/starter-kit": "^3.0.0",
+    "@turbodocx/html-to-docx": "^1.20.1",
+    "@types/multer": "^2.0.0",
+    "express": "^4.21.0",
+    "gray-matter": "^4.0.3",
+    "lowlight": "^3.3.0",
+    "markdown-it": "^14.1.1",
+    "markdown-it-ins": "^4.0.0",
+    "markdown-it-mark": "^4.0.0",
+    "markdown-it-sub": "^2.0.0",
+    "markdown-it-sup": "^2.0.0",
+    "multer": "^2.0.2",
+    "open": "^10.1.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "ws": "^8.18.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/markdown-it": "^14.1.2",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@types/ws": "^8.5.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "concurrently": "^9.1.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vite": "^6.0.0"
+  },
+  "files": [
+    "dist/",
+    "package.json"
+  ]
+}