openwriter 0.1.0

package/dist/server/workspace-routes.js

@@ -0,0 +1,176 @@
+/**
+ * Express routes for workspace CRUD, doc/container/tag operations.
+ * Mounted in index.ts to keep the main file lean.
+ */
+import { Router } from 'express';
+import { listWorkspaces, getWorkspace, createWorkspace, deleteWorkspace, reorderWorkspaces, addDoc, removeDoc, moveDoc, reorderDoc, addContainerToWorkspace, removeContainer, renameContainer, reorderContainer, tagDoc, untagDoc, } from './workspaces.js';
+export function createWorkspaceRouter(b) {
+    const router = Router();
+    router.get('/api/workspaces', (_req, res) => {
+        res.json(listWorkspaces());
+    });
+    router.post('/api/workspaces', (req, res) => {
+        try {
+            const result = createWorkspace({
+                title: req.body.title,
+                voiceProfileId: req.body.voiceProfileId,
+            });
+            b.broadcastWorkspacesChanged();
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    router.get('/api/workspaces/:filename', (req, res) => {
+        try {
+            res.json(getWorkspace(req.params.filename));
+        }
+        catch (err) {
+            res.status(404).json({ error: err.message });
+        }
+    });
+    router.delete('/api/workspaces/:filename', (req, res) => {
+        try {
+            deleteWorkspace(req.params.filename);
+            b.broadcastWorkspacesChanged();
+            res.json({ success: true });
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    router.put('/api/workspaces/reorder', (req, res) => {
+        try {
+            const { order } = req.body;
+            if (!Array.isArray(order))
+                return res.status(400).json({ error: 'order must be an array' });
+            reorderWorkspaces(order);
+            b.broadcastWorkspacesChanged();
+            res.json({ success: true });
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    // Doc operations
+    router.post('/api/workspaces/:filename/docs', (req, res) => {
+        try {
+            const ws = addDoc(req.params.filename, req.body.containerId ?? null, req.body.file, req.body.title || req.body.file, req.body.afterFile ?? null);
+            b.broadcastWorkspacesChanged();
+            res.json(ws);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    router.delete('/api/workspaces/:filename/docs/:docFile', (req, res) => {
+        try {
+            const ws = removeDoc(req.params.filename, req.params.docFile);
+            b.broadcastWorkspacesChanged();
+            res.json(ws);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    router.put('/api/workspaces/:filename/docs/:docFile/move', (req, res) => {
+        try {
+            const ws = moveDoc(req.params.filename, req.params.docFile, req.body.targetContainerId ?? null, req.body.afterFile ?? null);
+            b.broadcastWorkspacesChanged();
+            res.json(ws);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    router.put('/api/workspaces/:filename/docs/:docFile/reorder', (req, res) => {
+        try {
+            const ws = reorderDoc(req.params.filename, req.params.docFile, req.body.afterFile ?? null);
+            b.broadcastWorkspacesChanged();
+            res.json(ws);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    // Container operations
+    router.post('/api/workspaces/:filename/containers', (req, res) => {
+        try {
+            const result = addContainerToWorkspace(req.params.filename, req.body.parentContainerId ?? null, req.body.name);
+            b.broadcastWorkspacesChanged();
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    router.delete('/api/workspaces/:filename/containers/:containerId', (req, res) => {
+        try {
+            const ws = removeContainer(req.params.filename, req.params.containerId);
+            b.broadcastWorkspacesChanged();
+            res.json(ws);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    router.put('/api/workspaces/:filename/containers/:containerId', (req, res) => {
+        try {
+            let ws;
+            if (req.body.name !== undefined) {
+                ws = renameContainer(req.params.filename, req.params.containerId, req.body.name);
+            }
+            b.broadcastWorkspacesChanged();
+            res.json(ws || getWorkspace(req.params.filename));
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    router.put('/api/workspaces/:filename/containers/:containerId/reorder', (req, res) => {
+        try {
+            const ws = reorderContainer(req.params.filename, req.params.containerId, req.body.afterIdentifier ?? null);
+            b.broadcastWorkspacesChanged();
+            res.json(ws);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    // Tag operations
+    router.post('/api/workspaces/:filename/tags/:docFile', (req, res) => {
+        try {
+            const ws = tagDoc(req.params.filename, req.params.docFile, req.body.tag);
+            b.broadcastWorkspacesChanged();
+            res.json(ws);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    router.delete('/api/workspaces/:filename/tags/:docFile/:tag', (req, res) => {
+        try {
+            const ws = untagDoc(req.params.filename, req.params.docFile, req.params.tag);
+            b.broadcastWorkspacesChanged();
+            res.json(ws);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    // Cross-workspace move (from one workspace to another)
+    router.post('/api/workspaces/:targetFilename/docs/:docFile/cross-move', (req, res) => {
+        try {
+            const { sourceWorkspace } = req.body;
+            removeDoc(sourceWorkspace, req.params.docFile);
+            const ws = addDoc(req.params.targetFilename, req.body.containerId ?? null, req.params.docFile, req.body.title || req.params.docFile, req.body.afterFile ?? null);
+            b.broadcastWorkspacesChanged();
+            res.json(ws);
+        }
+        catch (err) {
+            res.status(400).json({ error: err.message });
+        }
+    });
+    return router;
+}

package/dist/server/workspace-tags.js

@@ -0,0 +1,33 @@
+/**
+ * Tag index operations for workspace v2.
+ * Tags are a cross-cutting index: tag → [file1, file2, ...].
+ */
+export function addTag(tags, tagName, file) {
+    if (!tags[tagName])
+        tags[tagName] = [];
+    if (!tags[tagName].includes(file))
+        tags[tagName].push(file);
+}
+export function removeTag(tags, tagName, file) {
+    if (!tags[tagName])
+        return;
+    tags[tagName] = tags[tagName].filter((f) => f !== file);
+    if (tags[tagName].length === 0)
+        delete tags[tagName];
+}
+export function removeFileFromAllTags(tags, file) {
+    for (const tagName of Object.keys(tags)) {
+        removeTag(tags, tagName, file);
+    }
+}
+export function listFilesForTag(tags, tagName) {
+    return tags[tagName] || [];
+}
+export function listTagsForFile(tags, file) {
+    const result = [];
+    for (const [tagName, files] of Object.entries(tags)) {
+        if (files.includes(file))
+            result.push(tagName);
+    }
+    return result;
+}

package/dist/server/workspace-tree.js

@@ -0,0 +1,200 @@
+/**
+ * Pure tree operations on WorkspaceNode[].
+ * All functions return mutated copies — caller writes to disk.
+ */
+import { generateContainerId } from './workspace-types.js';
+const MAX_DEPTH = 3;
+/** Recursive find — returns node, its parent array, and index within that array. */
+export function findNode(nodes, predicate, parentRef) {
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        if (predicate(node)) {
+            return { node, parent: parentRef ?? nodes, index: i };
+        }
+        if (node.type === 'container') {
+            const found = findNode(node.items, predicate, node);
+            if (found)
+                return found;
+        }
+        if (node.type === 'doc' && node.children) {
+            for (const child of node.children) {
+                const found = findNode(child.items, predicate, child);
+                if (found)
+                    return found;
+            }
+        }
+    }
+    return null;
+}
+export function findDocNode(root, file) {
+    return findNode(root, (n) => n.type === 'doc' && n.file === file);
+}
+export function findContainer(root, containerId) {
+    return findNode(root, (n) => n.type === 'container' && n.id === containerId);
+}
+/** Get the items array that a container or root holds. */
+function getItemsArray(root, containerId) {
+    if (containerId === null)
+        return root;
+    const found = findContainer(root, containerId);
+    if (!found)
+        return null;
+    return found.node.items;
+}
+// ============================================================================
+// DEPTH
+// ============================================================================
+/** Calculate the depth of a node in the tree. Root level = 0. */
+export function getDepth(root, identifier) {
+    function walk(nodes, depth) {
+        for (const node of nodes) {
+            const id = node.type === 'doc' ? node.file : node.id;
+            if (id === identifier)
+                return depth;
+            if (node.type === 'container') {
+                const found = walk(node.items, depth + 1);
+                if (found >= 0)
+                    return found;
+            }
+        }
+        return -1;
+    }
+    return walk(root, 0);
+}
+/** Calculate the depth of a target container (where we'd insert into). */
+function getContainerDepth(root, containerId) {
+    if (containerId === null)
+        return 0;
+    return getDepth(root, containerId) + 1;
+}
+// ============================================================================
+// ADD
+// ============================================================================
+export function addDocToContainer(root, containerId, file, title, afterIdentifier) {
+    // Check for duplicate
+    if (findDocNode(root, file)) {
+        throw new Error(`Document "${file}" already exists in workspace`);
+    }
+    const target = getItemsArray(root, containerId);
+    if (!target)
+        throw new Error(`Container "${containerId}" not found`);
+    const doc = { type: 'doc', file, title };
+    if (afterIdentifier) {
+        const afterIdx = target.findIndex((n) => (n.type === 'doc' && n.file === afterIdentifier) || (n.type === 'container' && n.id === afterIdentifier));
+        if (afterIdx === -1) {
+            target.push(doc);
+        }
+        else {
+            target.splice(afterIdx + 1, 0, doc);
+        }
+    }
+    else {
+        target.unshift(doc);
+    }
+}
+export function addContainer(root, parentContainerId, name) {
+    const depth = getContainerDepth(root, parentContainerId);
+    if (depth >= MAX_DEPTH) {
+        throw new Error(`Maximum nesting depth (${MAX_DEPTH}) reached`);
+    }
+    const target = getItemsArray(root, parentContainerId);
+    if (!target)
+        throw new Error(`Parent container "${parentContainerId}" not found`);
+    const container = {
+        type: 'container',
+        id: generateContainerId(),
+        name,
+        items: [],
+    };
+    target.unshift(container);
+    return container;
+}
+// ============================================================================
+// REMOVE
+// ============================================================================
+/** Remove a node by file (doc) or id (container). Returns the removed node. */
+export function removeNode(root, identifier) {
+    // Try as doc first, then as container
+    const found = findNode(root, (n) => (n.type === 'doc' && n.file === identifier) || (n.type === 'container' && n.id === identifier));
+    if (!found)
+        throw new Error(`Node "${identifier}" not found`);
+    const parentArray = found.parent instanceof Array ? found.parent : found.parent.items;
+    const [removed] = parentArray.splice(found.index, 1);
+    return removed;
+}
+// ============================================================================
+// MOVE / REORDER
+// ============================================================================
+/**
+ * Move a node to a different container (or root).
+ * afterIdentifier = null → insert at beginning; otherwise insert after that node.
+ */
+export function moveNode(root, identifier, targetContainerId, afterIdentifier) {
+    const removed = removeNode(root, identifier);
+    // Check depth for containers being moved
+    if (removed.type === 'container') {
+        const targetDepth = getContainerDepth(root, targetContainerId);
+        if (targetDepth >= MAX_DEPTH) {
+            // Re-add at root to not lose data, then throw
+            root.push(removed);
+            throw new Error(`Cannot move: would exceed max depth (${MAX_DEPTH})`);
+        }
+    }
+    const target = getItemsArray(root, targetContainerId);
+    if (!target) {
+        root.push(removed); // don't lose data
+        throw new Error(`Target container "${targetContainerId}" not found`);
+    }
+    if (afterIdentifier === null) {
+        target.unshift(removed);
+    }
+    else {
+        const afterIdx = target.findIndex((n) => (n.type === 'doc' && n.file === afterIdentifier) || (n.type === 'container' && n.id === afterIdentifier));
+        if (afterIdx === -1) {
+            target.push(removed);
+        }
+        else {
+            target.splice(afterIdx + 1, 0, removed);
+        }
+    }
+}
+/** Reorder within the same parent. */
+export function reorderNode(root, identifier, afterIdentifier) {
+    const found = findNode(root, (n) => (n.type === 'doc' && n.file === identifier) || (n.type === 'container' && n.id === identifier));
+    if (!found)
+        throw new Error(`Node "${identifier}" not found`);
+    const parentArray = found.parent instanceof Array ? found.parent : found.parent.items;
+    const [removed] = parentArray.splice(found.index, 1);
+    if (afterIdentifier === null) {
+        parentArray.unshift(removed);
+    }
+    else {
+        const afterIdx = parentArray.findIndex((n) => (n.type === 'doc' && n.file === afterIdentifier) || (n.type === 'container' && n.id === afterIdentifier));
+        if (afterIdx === -1) {
+            parentArray.push(removed);
+        }
+        else {
+            parentArray.splice(afterIdx + 1, 0, removed);
+        }
+    }
+}
+// ============================================================================
+// QUERIES
+// ============================================================================
+/** Collect all doc files in the tree. */
+export function collectAllFiles(nodes) {
+    const files = [];
+    for (const node of nodes) {
+        if (node.type === 'doc') {
+            files.push(node.file);
+        }
+        else if (node.type === 'container') {
+            files.push(...collectAllFiles(node.items));
+        }
+    }
+    return files;
+}
+/** Count total doc items in the tree. */
+export function countDocs(nodes) {
+    return collectAllFiles(nodes).length;
+}

package/dist/server/workspace-types.js

@@ -0,0 +1,38 @@
+/**
+ * Workspace v2 type definitions and migration logic.
+ * Unified container model: ordered/unordered containers hold docs, tags are cross-cutting.
+ */
+import { randomUUID } from 'crypto';
+// ============================================================================
+// MIGRATION
+// ============================================================================
+export function isV1(data) {
+    return !data.version || data.version < 2;
+}
+export function migrateV1toV2(legacy) {
+    const tags = {};
+    const root = [];
+    for (const item of legacy.items || []) {
+        root.push({ type: 'doc', file: item.file, title: item.file.replace(/\.md$/, '') });
+        if (item.tag) {
+            if (!tags[item.tag])
+                tags[item.tag] = [];
+            if (!tags[item.tag].includes(item.file))
+                tags[item.tag].push(item.file);
+        }
+    }
+    return {
+        version: 2,
+        title: legacy.title,
+        voiceProfileId: legacy.voiceProfileId ?? null,
+        root,
+        tags,
+        context: legacy.context,
+    };
+}
+// ============================================================================
+// HELPERS
+// ============================================================================
+export function generateContainerId() {
+    return randomUUID().slice(0, 8);
+}