@mod-computer/cli 0.2.3 → 0.2.5

package/dist/commands/comment.js

@@ -1,568 +0,0 @@
-import * as Automerge from '@automerge/automerge';
-import path from 'path';
-import fs from 'fs/promises';
-import { createModWorkspace } from '@mod/mod-core';
-import { readConfig, readWorkspaceConnection } from '../lib/storage.js';
-import { listLocalFiles } from '../lib/local-fs.js';
-const INLINE_PREFIXES = ['// @comment:', '# @comment:'];
-// glassware[type="implementation", id="impl-comments-cli-command--f317679a", specifications="specification-spec-comments-cli-add--caae2295,specification-spec-comments-cli-list--823e8bef,specification-spec-comments-cli-reply--1943ca4d,specification-spec-comments-cli-resolve--04be66f3,specification-spec-comments-cli-show--07887a12"]
-export async function commentCommand(args, repo) {
-    const subcommand = args[0];
-    const remaining = args.slice(1);
-    const showLogs = args.includes('--logs');
-    const run = async () => {
-        if (subcommand === 'add') {
-            await commentAddCommand(remaining, repo);
-            return;
-        }
-        if (subcommand === 'list') {
-            await commentListCommand(remaining, repo);
-            return;
-        }
-        if (subcommand === 'reply') {
-            await commentReplyCommand(remaining, repo);
-            return;
-        }
-        if (subcommand === 'resolve') {
-            await commentResolveCommand(remaining, repo);
-            return;
-        }
-        if (subcommand === 'show') {
-            await commentShowCommand(remaining, repo);
-            return;
-        }
-        console.error('Error: Unknown subcommand for comment');
-        console.error('Usage:');
-        console.error('  mod comment add <file> <text>');
-        console.error('  mod comment add <path> [--dry-run] [--remove-inline] [--glob <pattern>]');
-        console.error('  mod comment list [file]');
-        console.error('  mod comment reply <thread> <text>');
-        console.error('  mod comment resolve <thread>');
-        console.error('  mod comment show <thread>');
-        process.exit(1);
-    };
-    if (showLogs) {
-        await run();
-        return;
-    }
-    await withSuppressedLogs(run);
-}
-// glassware[type="implementation", id="impl-comments-cli-add-text--5cfa1217", specifications="specification-spec-comments-cli-add-text--a3b1431f,specification-spec-comments-cli-add--caae2295"]
-async function addTextComment(repo, workspaceId, workspacePath, targetPath, text) {
-    const modWorkspace = createModWorkspace(repo);
-    const workspaceHandle = await modWorkspace.openWorkspace(workspaceId);
-    const resolved = resolveWorkspacePath(targetPath, workspacePath);
-    if (!resolved) {
-        console.error(`Error: ${targetPath} is not under the workspace root`);
-        process.exit(1);
-    }
-    const fileDoc = await workspaceHandle.file.getByPath(resolved.relativePath);
-    if (!fileDoc) {
-        console.error(`Error: File not found in workspace: ${resolved.relativePath}`);
-        process.exit(1);
-    }
-    const fileHandle = await workspaceHandle.file.getHandle(fileDoc.documentId);
-    if (!fileHandle) {
-        console.error(`Error: Failed to open file handle for ${resolved.relativePath}`);
-        process.exit(1);
-    }
-    const content = await safeReadFile(resolved.absolutePath);
-    const firstLine = content?.split(/\r?\n/)[0] ?? resolved.relativePath;
-    const quotedText = firstLine && firstLine.trim().length > 0 ? firstLine : resolved.relativePath;
-    const anchor = buildAnchorForLine(fileHandle.doc(), fileDoc.documentId, 0, quotedText.length, quotedText);
-    const author = getAuthor();
-    const threadId = await fileHandle.comments.create(anchor, {
-        author,
-        text,
-        authorType: 'user'
-    });
-    await flushRepo(repo, [fileDoc.documentId, threadId]);
-    console.log(`Added comment to ${resolved.relativePath}`);
-}
-// glassware[type="implementation", id="impl-comments-cli-list--7374ea5f", specifications="specification-spec-comments-cli-list--823e8bef,specification-spec-comments-cli-list-id--c37d4ff6,specification-spec-comments-cli-list-reply-count--84fc9ab3"]
-async function commentListCommand(args, repo) {
-    const { targetPath } = parseCommentListArgs(args);
-    const connection = requireWorkspaceConnection();
-    const modWorkspace = createModWorkspace(repo);
-    const workspaceHandle = await modWorkspace.openWorkspace(connection.workspaceId);
-    if (targetPath) {
-        const resolved = resolveWorkspacePath(targetPath, connection.workspacePath);
-        if (!resolved) {
-            console.error(`Error: ${targetPath} is not under the workspace root`);
-            process.exit(1);
-        }
-        const fileDoc = await workspaceHandle.file.getByPath(resolved.relativePath);
-        if (!fileDoc) {
-            console.error(`Error: File not found in workspace: ${resolved.relativePath}`);
-            process.exit(1);
-        }
-        const fileHandle = await workspaceHandle.file.getHandle(fileDoc.documentId);
-        if (!fileHandle) {
-            console.error(`Error: Failed to open file handle for ${resolved.relativePath}`);
-            process.exit(1);
-        }
-        const threads = await fileHandle.comments.list();
-        printThreads(resolved.relativePath, threads);
-        return;
-    }
-    const files = await workspaceHandle.file.list();
-    let totalThreads = 0;
-    for (const file of files) {
-        const filePath = file.metadata?.path || file.name;
-        const fileHandle = await workspaceHandle.file.getHandle(file.id);
-        if (!fileHandle)
-            continue;
-        const threads = await fileHandle.comments.list();
-        if (threads.length === 0)
-            continue;
-        totalThreads += threads.length;
-        printThreads(filePath, threads);
-    }
-    if (totalThreads === 0) {
-        console.log('No comment threads found');
-    }
-}
-// glassware[type="implementation", id="impl-comments-cli-reply--f9580150", specifications="specification-spec-comments-cli-reply--1943ca4d,specification-spec-comments-cli-reply-persist--b1e2328b"]
-async function commentReplyCommand(args, repo) {
-    const { threadId, text } = parseCommentReplyArgs(args);
-    if (!threadId || !text) {
-        console.error('Error: Thread and text required');
-        console.error('Usage: mod comment reply <thread> <text>');
-        process.exit(1);
-    }
-    const connection = requireWorkspaceConnection();
-    const modWorkspace = createModWorkspace(repo);
-    const workspaceHandle = await modWorkspace.openWorkspace(connection.workspaceId);
-    const author = getAuthor();
-    await workspaceHandle.comment.reply(threadId, {
-        author,
-        text,
-        authorType: 'user'
-    });
-    await flushRepo(repo, [threadId]);
-    console.log(`Replied to thread ${threadId}`);
-}
-// glassware[type="implementation", id="impl-comments-cli-resolve--d4514340", specifications="specification-spec-comments-cli-resolve--04be66f3,specification-spec-comments-cli-resolve-persist--ca607aa7"]
-async function commentResolveCommand(args, repo) {
-    const { threadId } = parseCommentResolveArgs(args);
-    if (!threadId) {
-        console.error('Error: Thread required');
-        console.error('Usage: mod comment resolve <thread>');
-        process.exit(1);
-    }
-    const connection = requireWorkspaceConnection();
-    const modWorkspace = createModWorkspace(repo);
-    const workspaceHandle = await modWorkspace.openWorkspace(connection.workspaceId);
-    await workspaceHandle.comment.resolve(threadId);
-    await flushRepo(repo, [threadId]);
-    console.log(`Resolved thread ${threadId}`);
-}
-// glassware[type="implementation", id="impl-comments-cli-show--e8618786", specifications="specification-spec-comments-cli-show--07887a12,specification-spec-comments-cli-show-format--38abaa06"]
-async function commentShowCommand(args, repo) {
-    const { threadId } = parseCommentShowArgs(args);
-    if (!threadId) {
-        console.error('Error: Thread required');
-        console.error('Usage: mod comment show <thread>');
-        process.exit(1);
-    }
-    const connection = requireWorkspaceConnection();
-    const modWorkspace = createModWorkspace(repo);
-    const workspaceHandle = await modWorkspace.openWorkspace(connection.workspaceId);
-    let thread = null;
-    try {
-        thread = await workspaceHandle.comment.getThread(threadId);
-    }
-    catch {
-        thread = null;
-    }
-    if (!thread) {
-        console.error(`Error: Thread not found: ${threadId}`);
-        process.exit(1);
-    }
-    printThreadDetails(thread);
-}
-// glassware[type="implementation", id="impl-comments-cli-inline-trigger--71f93e98", specifications="specification-spec-comments-cli-inline-trigger--c1da6532"]
-async function commentAddCommand(args, repo) {
-    const parsed = parseCommentAddArgs(args);
-    if (!parsed.targetPath) {
-        console.error('Error: Path required');
-        console.error('Usage: mod comment add <file> <text>');
-        console.error('       mod comment add <path> [--dry-run] [--remove-inline] [--glob <pattern>]');
-        process.exit(1);
-    }
-    const connection = requireWorkspaceConnection();
-    if (parsed.mode === 'text' && parsed.text) {
-        await addTextComment(repo, connection.workspaceId, connection.workspacePath, parsed.targetPath, parsed.text);
-        return;
-    }
-    await convertInlineAnnotations(repo, connection.workspaceId, connection.workspacePath, parsed.targetPath, parsed.options);
-}
-// glassware[type="implementation", id="impl-comments-cli-inline-options--3a6ce99e", specifications="specification-spec-comments-cli-inline-options--92527951,specification-spec-comments-cli-inline-glob--63dce4ea"]
-export function parseInlineOptions(args) {
-    const options = {
-        dryRun: false,
-        removeInline: false
-    };
-    const positional = [];
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg === '--dry-run') {
-            options.dryRun = true;
-        }
-        else if (arg === '--remove-inline') {
-            options.removeInline = true;
-        }
-        else if (arg === '--glob') {
-            const pattern = args[i + 1];
-            if (!pattern || pattern.startsWith('-')) {
-                console.error('Error: --glob requires a pattern');
-                process.exit(1);
-            }
-            options.glob = pattern;
-            i += 1;
-        }
-        else if (!arg.startsWith('-')) {
-            positional.push(arg);
-        }
-    }
-    return { options, positional };
-}
-export function parseCommentAddArgs(args) {
-    const { options, positional } = parseInlineOptions(args);
-    const targetPath = positional[0] ?? null;
-    const text = positional.slice(1).join(' ').trim();
-    return {
-        targetPath,
-        text: text.length > 0 ? text : null,
-        mode: text.length > 0 ? 'text' : 'inline',
-        options
-    };
-}
-export function parseCommentListArgs(args) {
-    for (const arg of args) {
-        if (!arg.startsWith('-')) {
-            return { targetPath: arg };
-        }
-    }
-    return { targetPath: null };
-}
-export function parseCommentReplyArgs(args) {
-    const positional = args.filter(arg => !arg.startsWith('-'));
-    const threadId = positional[0] ?? null;
-    const text = positional.slice(1).join(' ').trim();
-    return {
-        threadId,
-        text: text.length > 0 ? text : null
-    };
-}
-export function parseCommentResolveArgs(args) {
-    for (const arg of args) {
-        if (!arg.startsWith('-')) {
-            return { threadId: arg };
-        }
-    }
-    return { threadId: null };
-}
-export function parseCommentShowArgs(args) {
-    for (const arg of args) {
-        if (!arg.startsWith('-')) {
-            return { threadId: arg };
-        }
-    }
-    return { threadId: null };
-}
-// glassware[type="implementation", id="impl-comments-cli-inline-format--dfc82aeb", specifications="specification-spec-comments-cli-inline-format--0507e3c0"]
-export function findInlineAnnotations(content) {
-    const newline = content.includes('\r\n') ? '\r\n' : '\n';
-    const lines = content.split(/\r?\n/);
-    const annotations = [];
-    let offset = 0;
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const match = findInlinePrefix(line);
-        const lineStart = offset;
-        const lineEnd = offset + line.length;
-        if (match) {
-            const commentText = line.slice(match.prefixIndex + match.prefix.length).trim();
-            annotations.push({
-                lineIndex: i,
-                lineStart,
-                lineEnd,
-                line,
-                prefixIndex: match.prefixIndex,
-                prefix: match.prefix,
-                commentText
-            });
-        }
-        offset = lineEnd + (i < lines.length - 1 ? newline.length : 0);
-    }
-    return annotations;
-}
-// glassware[type="implementation", id="impl-comments-cli-inline-anchor--1abedfde", specifications="specification-spec-comments-cli-inline-anchor--9de12c54"]
-export function buildAnchorForLine(doc, docId, lineStart, lineEnd, quotedText) {
-    const pathSegments = ['text'];
-    let fromCursor = '';
-    let toCursor = '';
-    try {
-        fromCursor = Automerge.getCursor(doc, pathSegments, lineStart).toString();
-        toCursor = Automerge.getCursor(doc, pathSegments, lineEnd).toString();
-    }
-    catch { }
-    return {
-        docId,
-        fromCursor,
-        toCursor,
-        path: pathSegments,
-        quotedText
-    };
-}
-// glassware[type="implementation", id="impl-comments-cli-inline-remove--90d16357", specifications="specification-spec-comments-cli-inline-remove--60995cac"]
-export function removeInlineAnnotations(content, annotations, convertedLineIndices) {
-    const newline = content.includes('\r\n') ? '\r\n' : '\n';
-    const lines = content.split(/\r?\n/);
-    const updated = [];
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (!convertedLineIndices.has(i)) {
-            updated.push(line);
-            continue;
-        }
-        const annotation = annotations.find(item => item.lineIndex === i);
-        if (!annotation) {
-            updated.push(line);
-            continue;
-        }
-        const beforePrefix = line.slice(0, annotation.prefixIndex);
-        if (beforePrefix.trim().length > 0) {
-            updated.push(beforePrefix.trimEnd());
-        }
-    }
-    return updated.join(newline);
-}
-// glassware[type="implementation", id="impl-comments-cli-inline-dry-run--6126e52b", specifications="specification-spec-comments-cli-inline-dry-run--c8d04d14"]
-async function convertInlineAnnotations(repo, workspaceId, workspacePath, targetPath, options) {
-    const resolvedTarget = resolveWorkspacePath(targetPath, workspacePath);
-    if (!resolvedTarget) {
-        console.error(`Error: ${targetPath} is not under the workspace root`);
-        process.exit(1);
-    }
-    const stat = await fs.stat(resolvedTarget.absolutePath).catch(() => null);
-    if (!stat) {
-        console.error(`Error: Path not found: ${resolvedTarget.absolutePath}`);
-        process.exit(1);
-    }
-    const modWorkspace = createModWorkspace(repo);
-    const workspaceHandle = await modWorkspace.openWorkspace(workspaceId);
-    const targets = stat.isDirectory()
-        ? await listLocalFiles(resolvedTarget.absolutePath, options.glob)
-        : [path.basename(resolvedTarget.absolutePath)];
-    const baseDir = stat.isDirectory() ? resolvedTarget.absolutePath : path.dirname(resolvedTarget.absolutePath);
-    let totalFound = 0;
-    let totalConverted = 0;
-    for (const relativeFile of targets) {
-        const absoluteFile = stat.isDirectory()
-            ? path.join(baseDir, relativeFile)
-            : resolvedTarget.absolutePath;
-        const relativeToWorkspace = resolveWorkspacePath(absoluteFile, workspacePath);
-        if (!relativeToWorkspace)
-            continue;
-        const content = await safeReadFile(absoluteFile);
-        if (content === null)
-            continue;
-        const annotations = findInlineAnnotations(content);
-        if (annotations.length === 0)
-            continue;
-        totalFound += annotations.length;
-        const fileDoc = await workspaceHandle.file.getByPath(relativeToWorkspace.relativePath);
-        if (!fileDoc) {
-            console.warn(`Warning: File not found in workspace: ${relativeToWorkspace.relativePath}`);
-            continue;
-        }
-        const fileHandle = await workspaceHandle.file.getHandle(fileDoc.documentId);
-        if (!fileHandle) {
-            console.warn(`Warning: Failed to open file handle for ${relativeToWorkspace.relativePath}`);
-            continue;
-        }
-        const convertedLineIndices = new Set();
-        const createdThreadIds = [];
-        for (const annotation of annotations) {
-            if (!annotation.commentText) {
-                console.warn(`Warning: Skipping empty inline comment in ${relativeToWorkspace.relativePath}:${annotation.lineIndex + 1}`);
-                continue;
-            }
-            const anchor = buildAnchorForLine(fileHandle.doc(), fileDoc.documentId, annotation.lineStart, annotation.lineEnd, annotation.line);
-            const author = getAuthor();
-            if (!options.dryRun) {
-                const threadId = await fileHandle.comments.create(anchor, {
-                    author,
-                    text: annotation.commentText,
-                    authorType: 'user'
-                });
-                createdThreadIds.push(threadId);
-                convertedLineIndices.add(annotation.lineIndex);
-                totalConverted += 1;
-            }
-        }
-        if (!options.dryRun && options.removeInline && convertedLineIndices.size > 0) {
-            const updatedContent = removeInlineAnnotations(content, annotations, convertedLineIndices);
-            await fs.writeFile(absoluteFile, updatedContent, 'utf-8');
-        }
-        if (!options.dryRun && createdThreadIds.length > 0) {
-            await flushRepo(repo, [fileDoc.documentId, ...createdThreadIds]);
-        }
-    }
-    if (options.dryRun) {
-        console.log(`Found ${totalFound} inline comments (dry run)`);
-    }
-    else {
-        console.log(`Converted ${totalConverted} inline comments`);
-    }
-}
-function findInlinePrefix(line) {
-    let bestIndex = -1;
-    let bestPrefix = null;
-    for (const prefix of INLINE_PREFIXES) {
-        const index = line.indexOf(prefix);
-        if (index === -1)
-            continue;
-        if (bestIndex === -1 || index < bestIndex) {
-            bestIndex = index;
-            bestPrefix = prefix;
-        }
-    }
-    if (bestIndex === -1 || !bestPrefix)
-        return null;
-    return { prefixIndex: bestIndex, prefix: bestPrefix };
-}
-function requireWorkspaceConnection() {
-    const currentDir = process.cwd();
-    const connection = readWorkspaceConnection(currentDir);
-    if (!connection) {
-        console.error('Error: Not connected to a workspace.');
-        console.error('Run `mod init` to connect this directory first.');
-        process.exit(1);
-    }
-    return {
-        workspaceId: connection.workspaceId,
-        workspaceName: connection.workspaceName,
-        workspacePath: connection.path
-    };
-}
-function resolveWorkspacePath(targetPath, workspacePath) {
-    const absolutePath = path.isAbsolute(targetPath)
-        ? targetPath
-        : path.resolve(process.cwd(), targetPath);
-    const relativePath = path.relative(workspacePath, absolutePath);
-    if (relativePath.startsWith('..') || path.isAbsolute(relativePath)) {
-        return null;
-    }
-    return {
-        absolutePath,
-        relativePath: relativePath.replace(/\\/g, '/')
-    };
-}
-async function safeReadFile(filePath) {
-    try {
-        return await fs.readFile(filePath, 'utf-8');
-    }
-    catch {
-        return null;
-    }
-}
-function getAuthor() {
-    const config = readConfig();
-    return config.auth?.email || config.auth?.name || 'Anonymous';
-}
-// glassware[type="implementation", id="impl-comments-cli-persist--422d6a7b", specifications="specification-spec-comments-cli-add-persist--38f941f4,specification-spec-comments-cli-inline-persist--81bda0e1"]
-async function flushRepo(repo, documentIds) {
-    const flush = repo.flush;
-    if (!flush)
-        return;
-    try {
-        await flush.call(repo, documentIds);
-    }
-    catch (error) {
-        console.error('Error: Failed to persist comment changes');
-        process.exit(1);
-    }
-}
-// glassware[type="implementation", id="impl-comments-cli-logs--29a60b58", specifications="specification-spec-comments-cli-list-logs--0544ba41,specification-spec-comments-cli-inline-logs--b839d19b"]
-export async function withSuppressedLogs(fn) {
-    const originalLog = console.log;
-    const originalWarn = console.warn;
-    const originalInfo = console.info;
-    const originalDebug = console.debug;
-    const shouldDrop = (args) => {
-        if (args.length === 0)
-            return false;
-        const message = args
-            .map((arg) => {
-            if (typeof arg === 'string')
-                return arg;
-            if (arg && typeof arg === 'object' && 'message' in arg) {
-                return String(arg.message);
-            }
-            return String(arg);
-        })
-            .join(' ');
-        return message.startsWith('[');
-    };
-    console.log = (...args) => {
-        if (shouldDrop(args))
-            return;
-        originalLog(...args);
-    };
-    console.warn = (...args) => {
-        if (shouldDrop(args))
-            return;
-        originalWarn(...args);
-    };
-    console.info = (...args) => {
-        if (shouldDrop(args))
-            return;
-        originalInfo(...args);
-    };
-    console.debug = (...args) => {
-        if (shouldDrop(args))
-            return;
-        originalDebug(...args);
-    };
-    try {
-        return await fn();
-    }
-    finally {
-        console.log = originalLog;
-        console.warn = originalWarn;
-        console.info = originalInfo;
-        console.debug = originalDebug;
-    }
-}
-// glassware[type="implementation", id="impl-comments-cli-list-id--8fc0544c", specifications="specification-spec-comments-cli-list-id--c37d4ff6,specification-spec-comments-cli-list-reply-count--84fc9ab3"]
-function printThreads(filePath, threads) {
-    console.log(filePath);
-    for (const thread of threads) {
-        const preview = thread.comments[0]?.text ?? '';
-        const replyCount = Math.max(0, thread.comments.length - 1);
-        console.log(`  [${thread.status}] ${thread.id} (replies: ${replyCount}) ${preview}`);
-    }
-}
-// glassware[type="implementation", id="impl-comments-cli-show-format--3d4a7569", specifications="specification-spec-comments-cli-show-format--38abaa06"]
-function printThreadDetails(thread) {
-    console.log(`Thread ${thread.id}`);
-    console.log(`Status: ${thread.status}`);
-    console.log('Anchor:');
-    console.log(`  docId: ${thread.anchor.docId}`);
-    console.log(`  path: ${thread.anchor.path.join('.')}`);
-    if (thread.anchor.quotedText) {
-        console.log(`  quotedText: ${thread.anchor.quotedText}`);
-    }
-    if (thread.comments.length === 0) {
-        console.log('Comments: none');
-        return;
-    }
-    console.log('Comments:');
-    for (const comment of thread.comments) {
-        console.log(`  - ${comment.author} ${comment.createdAt}`);
-        console.log(`    ${comment.text}`);
-    }
-}