remnote-mcp-server 0.13.1 → 0.14.1

package/dist/remnote-cli/commands/arg-utils.js

@@ -0,0 +1,89 @@
+import { InvalidArgumentError } from 'commander';
+/**
+ * A memory-safe cache that stores the flattened list of registered flags for each Command.
+ * Using a WeakMap ensures that once a Command object is garbage collected (e.g., after a test run),
+ * its associated cache is also freed, preventing memory leaks.
+ */
+const flagCache = new WeakMap();
+/**
+ * Traverses the current Command and all its parent commands to collect every registered flag.
+ * Uses caching to ensure this expensive traversal only happens once per Command instance.
+ *
+ * @param cmd - The Commander.js Command instance to inspect.
+ * @returns An array of all registered short and long flags (e.g., ['-c', '--content', ...]).
+ */
+const getAllRegisteredFlags = (cmd) => {
+    if (flagCache.has(cmd)) {
+        return flagCache.get(cmd);
+    }
+    let flags = [];
+    let current = cmd;
+    while (current) {
+        if (current.options) {
+            const currentFlags = current.options.flatMap((opt) => [opt.short, opt.long].filter(Boolean));
+            flags = [...flags, ...currentFlags];
+        }
+        // Move up the command tree to catch globally registered options
+        current = current.parent;
+    }
+    flagCache.set(cmd, flags);
+    return flags;
+};
+/**
+ * Determines if a given string value looks like a CLI flag instead of a standard argument.
+ * This is used to detect "argument shifting" (e.g., when an empty string "" is swallowed by the shell,
+ * causing the next flag to be incorrectly parsed as the value for the current option).
+ *
+ * @param value - The string argument to evaluate.
+ * @param cmd - (Optional) The Command instance. If provided, enables strict matching against registered flags.
+ * @returns True if the value is likely a shifted flag; otherwise, false.
+ */
+export function isFlag(value, cmd) {
+    if (!value)
+        return false;
+    // Strict Match: If a Command context is provided, check against actually registered flags.
+    if (cmd) {
+        const knownFlags = getAllRegisteredFlags(cmd);
+        if (knownFlags.includes(value))
+            return true;
+    }
+    return false;
+}
+/**
+ * Validates an entire record of parsed arguments to ensure none of them are shifted flags.
+ * Useful for running a bulk check after Commander has finished parsing,
+ * especially when using dynamic commands or positional arguments.
+ *
+ * @param fields - A key-value record of parsed arguments (e.g., { title: '--content', parentId: '123' }).
+ * @param cmd - (Optional) The Command instance for strict flag matching.
+ * @throws {Error} If any value is identified as a shifted flag.
+ */
+export function checkPayloadForFlags(fields, cmd) {
+    for (const [name, value] of Object.entries(fields)) {
+        if (isFlag(value, cmd)) {
+            throw new Error(`Argument shifting detected: "${value}" was misinterpreted as the value for "${name}". ` +
+                `This usually indicates argument shifting (e.g. the shell swallowed an empty string ""). ` +
+                `To fix this, use explicit flags (e.g. --title="", --content="") or check your quoting.`);
+        }
+    }
+}
+/**
+ * A higher-order function designed to be used as a custom processing function in Commander's `.option()`.
+ * It binds the Command context to the validation logic.
+ *
+ * @param cmd - The current Commander instance.
+ * @returns A validation function that throws an InvalidArgumentError if the value is a shifted flag.
+ *
+ * @example
+ * const check = validateNotFlag(program);
+ * program.option('--title <text>', 'Note title', check);
+ */
+export function validateNotFlag(value, cmd) {
+    if (isFlag(value, cmd)) {
+        throw new InvalidArgumentError(`"${value}" looks like a flag but was passed as an option value. ` +
+            `This usually indicates argument shifting (e.g. the shell swallowed an empty string ""). ` +
+            `To fix this, use explicit flags (e.g. --title="", --content="") or check your quoting.`);
+    }
+    return value;
+}
+//# sourceMappingURL=arg-utils.js.map

package/dist/remnote-cli/commands/arg-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-utils.js","sourceRoot":"","sources":["../../../src/remnote-cli/commands/arg-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAgB,MAAM,WAAW,CAAC;AAE/D;;;;GAIG;AACH,MAAM,SAAS,GAAG,IAAI,OAAO,EAAqB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG,CAAC,GAAY,EAAY,EAAE;IACvD,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,OAAO,GAAmB,GAAG,CAAC;IAElC,OAAO,OAAO,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAC1C,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAC3D,CAAC;YACF,KAAK,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,YAAY,CAAC,CAAC;QACtC,CAAC;QACD,gEAAgE;QAChE,OAAO,GAAG,OAAO,CAAC,MAAwB,CAAC;IAC7C,CAAC;IAED,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,KAAyB,EAAE,GAAa;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,2FAA2F;IAC3F,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IAC9C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAA0C,EAC1C,GAAa;IAEb,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,gCAAgC,KAAK,0CAA0C,IAAI,KAAK;gBACtF,0FAA0F;gBAC1F,wFAAwF,CAC3F,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,GAAa;IAC1D,IAAI,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,oBAAoB,CAC5B,IAAI,KAAK,yDAAyD;YAChE,0FAA0F;YAC1F,wFAAwF,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/remnote-cli/commands/content-input.d.ts

@@ -0,0 +1,31 @@
+import { Readable } from 'node:stream';
+export declare const MAX_WRITE_CONTENT_BYTES: number;
+export declare function readContentFileOrStdin(pathOrDash: string, stdin?: Readable): Promise<string>;
+interface OptionalContentArgs {
+    inlineText: string | undefined;
+    filePath: string | undefined;
+    inlineFlag: string;
+    fileFlag: string;
+    stdin?: Readable;
+}
+export declare function resolveOptionalInlineOrFileContent({ inlineText, filePath, inlineFlag, fileFlag, stdin, }: OptionalContentArgs): Promise<string | undefined>;
+interface UpdateContentArgs {
+    appendText: string | undefined;
+    appendFile: string | undefined;
+    replaceText: string | undefined;
+    replaceFile: string | undefined;
+    stdin?: Readable;
+}
+interface ResolvedUpdateContent {
+    appendContent: string | undefined;
+    replaceContent: string | undefined;
+}
+export declare function resolveUpdateContent({ appendText, appendFile, replaceText, replaceFile, stdin, }: UpdateContentArgs): Promise<ResolvedUpdateContent>;
+interface JournalContentArgs {
+    positionalContent: string | undefined;
+    optionContent: string | undefined;
+    contentFile: string | undefined;
+    stdin?: Readable;
+}
+export declare function resolveJournalContent({ positionalContent, optionContent, contentFile, stdin, }: JournalContentArgs): Promise<string>;
+export {};

package/dist/remnote-cli/commands/content-input.js

@@ -0,0 +1,81 @@
+import { readFile } from 'node:fs/promises';
+export const MAX_WRITE_CONTENT_BYTES = 100 * 1024;
+function formatLimit() {
+    return `${MAX_WRITE_CONTENT_BYTES / 1024} KB`;
+}
+function ensureWithinLimit(byteLength, sourceLabel) {
+    if (byteLength > MAX_WRITE_CONTENT_BYTES) {
+        throw new Error(`${sourceLabel} exceeds ${formatLimit()} limit`);
+    }
+}
+async function readUtf8FromStream(stream, sourceLabel) {
+    const chunks = [];
+    let totalBytes = 0;
+    for await (const chunk of stream) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        totalBytes += buffer.byteLength;
+        ensureWithinLimit(totalBytes, sourceLabel);
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+export async function readContentFileOrStdin(pathOrDash, stdin = process.stdin) {
+    if (pathOrDash === '-') {
+        return readUtf8FromStream(stdin, 'Stdin content');
+    }
+    try {
+        const buffer = await readFile(pathOrDash);
+        ensureWithinLimit(buffer.byteLength, `Content file "${pathOrDash}"`);
+        return buffer.toString('utf8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read content file "${pathOrDash}": ${message}`, {
+            cause: error,
+        });
+    }
+}
+export async function resolveOptionalInlineOrFileContent({ inlineText, filePath, inlineFlag, fileFlag, stdin, }) {
+    if (inlineText !== undefined && filePath !== undefined) {
+        throw new Error(`Cannot use ${inlineFlag} and ${fileFlag} together`);
+    }
+    if (filePath !== undefined) {
+        return readContentFileOrStdin(filePath, stdin);
+    }
+    // convert literal \n strings into actual newline characters
+    return inlineText?.replace(/\\n/g, '\n');
+}
+export async function resolveUpdateContent({ appendText, appendFile, replaceText, replaceFile, stdin, }) {
+    const appendContent = await resolveOptionalInlineOrFileContent({
+        inlineText: appendText,
+        filePath: appendFile,
+        inlineFlag: '--append',
+        fileFlag: '--append-file',
+        stdin,
+    });
+    const replaceContent = await resolveOptionalInlineOrFileContent({
+        inlineText: replaceText,
+        filePath: replaceFile,
+        inlineFlag: '--replace',
+        fileFlag: '--replace-file',
+        stdin,
+    });
+    if (appendContent !== undefined && replaceContent !== undefined) {
+        throw new Error('Cannot combine append and replace content options (--append/--append-file with --replace/--replace-file)');
+    }
+    return { appendContent, replaceContent };
+}
+export async function resolveJournalContent({ positionalContent, optionContent, contentFile, stdin, }) {
+    const providedCount = [positionalContent, optionContent, contentFile].filter((value) => value !== undefined).length;
+    if (providedCount !== 1) {
+        throw new Error('Provide exactly one journal content source: positional <content>, --content <text>, or --content-file <path|->');
+    }
+    if (contentFile !== undefined) {
+        return readContentFileOrStdin(contentFile, stdin);
+    }
+    if (optionContent !== undefined) {
+        return optionContent;
+    }
+    return positionalContent;
+}
+//# sourceMappingURL=content-input.js.map

package/dist/remnote-cli/commands/content-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-input.js","sourceRoot":"","sources":["../../../src/remnote-cli/commands/content-input.ts"],"names":[],"mappings":"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"}

package/dist/remnote-cli/commands/create.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerCreateCommand(program: Command): void;

package/dist/remnote-cli/commands/create.js

@@ -0,0 +1,61 @@
+import { createCommandClient } from '../client/command-client.js';
+import { formatResult, formatError } from '../output/formatter.js';
+import { EXIT } from '../config.js';
+import { resolveOptionalInlineOrFileContent } from './content-input.js';
+import { checkPayloadForFlags, validateNotFlag } from './arg-utils.js';
+export function registerCreateCommand(program) {
+    const subprogram = program.command('create [title]');
+    const validate = (val) => validateNotFlag(val, subprogram);
+    subprogram
+        .description('Create a new note in RemNote (title or content required)')
+        .option('--title <text>', 'Note title', validate)
+        .option('-c, --content <text>', 'Note content (markdown/flashcard supported)', validate)
+        .option('--content-file <path>', 'Read note content from UTF-8 file ("-" for stdin)', validate)
+        .option('--parent-id <id>', 'Parent Rem ID', validate)
+        .option('-t, --tags <tags...>', 'Tags to add')
+        .action(async (titleArg, opts) => {
+        const globalOpts = program.opts();
+        const format = globalOpts.text ? 'text' : 'json';
+        const client = createCommandClient(program);
+        try {
+            const payload = {};
+            // Validate shifting flags for positional arguments
+            checkPayloadForFlags({ title: titleArg }, subprogram);
+            const title = titleArg !== undefined ? titleArg : opts.title;
+            if (title !== undefined)
+                payload.title = title;
+            const content = await resolveOptionalInlineOrFileContent({
+                inlineText: opts.content,
+                filePath: opts.contentFile,
+                inlineFlag: '--content',
+                fileFlag: '--content-file',
+            });
+            if (content !== undefined)
+                payload.content = content;
+            if (opts.parentId)
+                payload.parentId = opts.parentId;
+            if (opts.tags && opts.tags.length > 0)
+                payload.tags = opts.tags;
+            const result = await client.execute('create_note', payload);
+            console.log(formatResult(result, format, (data) => {
+                const r = data;
+                const ids = r.remIds || [];
+                const titles = r.titles || [];
+                if (ids.length === 0)
+                    return 'No Rems created.';
+                return titles
+                    .map((t, i) => `Created: ${t || '(untitled)'} (ID: ${ids[i] || 'unknown'})`)
+                    .join('\n');
+            }));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(formatError(message, format));
+            process.exit(EXIT.ERROR);
+        }
+        finally {
+            await client.close();
+        }
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/remnote-cli/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/remnote-cli/commands/create.ts"],"names":[],"mappings":"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"}

package/dist/remnote-cli/commands/journal.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerJournalCommand(program: Command): void;

package/dist/remnote-cli/commands/journal.js

@@ -0,0 +1,52 @@
+import { createCommandClient } from '../client/command-client.js';
+import { formatResult, formatError } from '../output/formatter.js';
+import { EXIT } from '../config.js';
+import { resolveJournalContent } from './content-input.js';
+import { checkPayloadForFlags, validateNotFlag } from './arg-utils.js';
+export function registerJournalCommand(program) {
+    const subprogram = program.command('journal [content]');
+    const validate = (val) => validateNotFlag(val, subprogram);
+    subprogram
+        .description("Append an entry to today's journal")
+        .option('--content <text>', 'Journal entry content', validate)
+        .option('--content-file <path>', 'Read journal entry from UTF-8 file ("-" for stdin)', validate)
+        .option('--no-timestamp', 'Omit timestamp prefix')
+        .action(async (positionalContent, opts) => {
+        const globalOpts = program.opts();
+        const format = globalOpts.text ? 'text' : 'json';
+        const client = createCommandClient(program);
+        try {
+            // Validate shifting for positional content
+            checkPayloadForFlags({ content: positionalContent }, program);
+            const content = await resolveJournalContent({
+                positionalContent: positionalContent,
+                optionContent: opts.content,
+                contentFile: opts.contentFile,
+            });
+            const payload = {
+                content,
+                timestamp: opts.timestamp !== false,
+            };
+            const result = await client.execute('append_journal', payload);
+            console.log(formatResult(result, format, (data) => {
+                const r = data;
+                const ids = r.remIds || [];
+                const titles = r.titles || [];
+                if (ids.length === 0)
+                    return 'No journal entry Rems created.';
+                return titles
+                    .map((t, i) => `Journal entry added: ${t || '(untitled)'} (ID: ${ids[i] || 'unknown'})`)
+                    .join('\n');
+            }));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(formatError(message, format));
+            process.exit(EXIT.ERROR);
+        }
+        finally {
+            await client.close();
+        }
+    });
+}
+//# sourceMappingURL=journal.js.map

package/dist/remnote-cli/commands/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../../src/remnote-cli/commands/journal.ts"],"names":[],"mappings":"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"}

package/dist/remnote-cli/commands/read.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerReadCommand(program: Command): void;

package/dist/remnote-cli/commands/read.js

@@ -0,0 +1,74 @@
+import { createCommandClient } from '../client/command-client.js';
+import { formatResult, formatError } from '../output/formatter.js';
+import { EXIT } from '../config.js';
+export function registerReadCommand(program) {
+    program
+        .command('read <rem-id>')
+        .description('Read a note by its Rem ID')
+        .option('-d, --depth <n>', 'Depth of child hierarchy to render (default: 5)', '5')
+        .option('--include-content <mode>', 'Content rendering mode: "markdown" (default), "none", or "structured"')
+        .option('--child-limit <n>', 'Maximum children per level (default: 100)')
+        .option('--max-content-length <n>', 'Maximum content character length (default: 100000)')
+        .action(async (remId, opts) => {
+        const globalOpts = program.opts();
+        const format = globalOpts.text ? 'text' : 'json';
+        const client = createCommandClient(program);
+        try {
+            const payload = {
+                remId,
+                depth: parseInt(opts.depth, 10),
+            };
+            if (opts.includeContent)
+                payload.includeContent = opts.includeContent;
+            if (opts.childLimit)
+                payload.childLimit = parseInt(opts.childLimit, 10);
+            if (opts.maxContentLength)
+                payload.maxContentLength = parseInt(opts.maxContentLength, 10);
+            const result = await client.execute('read_note', payload);
+            console.log(formatResult(result, format, (data) => {
+                const r = data;
+                const lines = [];
+                if (r.headline) {
+                    lines.push(`Title: ${r.headline}`);
+                }
+                else if (r.title) {
+                    lines.push(`Title: ${r.title}`);
+                }
+                if (r.remId)
+                    lines.push(`ID: ${r.remId}`);
+                if (r.remType)
+                    lines.push(`Type: ${r.remType}`);
+                if (typeof r.parentTitle === 'string' && r.parentTitle.length > 0) {
+                    const parentIdSuffix = typeof r.parentRemId === 'string' ? ` [${r.parentRemId}]` : '';
+                    lines.push(`Parent: ${r.parentTitle}${parentIdSuffix}`);
+                }
+                if (r.aliases && Array.isArray(r.aliases) && r.aliases.length > 0) {
+                    lines.push(`Aliases: ${r.aliases.join(', ')}`);
+                }
+                if (r.tags && Array.isArray(r.tags) && r.tags.length > 0) {
+                    lines.push(`Tags: ${r.tags.join(', ')}`);
+                }
+                if (r.cardDirection)
+                    lines.push(`Card: ${r.cardDirection}`);
+                if (r.contentProperties) {
+                    const cp = r.contentProperties;
+                    lines.push(`Children: ${cp.childrenRendered}/${cp.childrenTotal}${cp.contentTruncated ? ' (truncated)' : ''}`);
+                }
+                if (r.content && typeof r.content === 'string' && r.content.length > 0) {
+                    lines.push('');
+                    lines.push(r.content);
+                }
+                return lines.join('\n');
+            }));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(formatError(message, format));
+            process.exit(EXIT.ERROR);
+        }
+        finally {
+            await client.close();
+        }
+    });
+}
+//# sourceMappingURL=read.js.map

package/dist/remnote-cli/commands/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/remnote-cli/commands/read.ts"],"names":[],"mappings":"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"}

package/dist/remnote-cli/commands/search.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerSearchCommand(program: Command): void;
+export declare function registerSearchByTagCommand(program: Command): void;

package/dist/remnote-cli/commands/search.js

@@ -0,0 +1,107 @@
+import { createCommandClient } from '../client/command-client.js';
+import { formatResult, formatError } from '../output/formatter.js';
+import { EXIT } from '../config.js';
+/** Default number of search results. */
+const DEFAULT_SEARCH_LIMIT = 50;
+/** Compact type prefixes for text output (empty for plain text Rems). */
+const TYPE_TAG = {
+    document: '[doc] ',
+    dailyDocument: '[daily] ',
+    concept: '[concept] ',
+    descriptor: '[desc] ',
+    portal: '[portal] ',
+};
+function applySearchOptions(payload, opts) {
+    if (opts.includeContent)
+        payload.includeContent = opts.includeContent;
+    if (opts.depth)
+        payload.depth = parseInt(opts.depth, 10);
+    if (opts.childLimit)
+        payload.childLimit = parseInt(opts.childLimit, 10);
+    if (opts.maxContentLength)
+        payload.maxContentLength = parseInt(opts.maxContentLength, 10);
+}
+function formatSearchText(data) {
+    const r = data;
+    if (!r.results || r.results.length === 0)
+        return 'No results found.';
+    return r.results
+        .map((note, i) => {
+        const typeTag = TYPE_TAG[note.remType] ?? '';
+        const headline = note.headline || note.title || '(untitled)';
+        let aliasesSuffix = '';
+        if (note.aliases && Array.isArray(note.aliases) && note.aliases.length > 0) {
+            aliasesSuffix = ` (aka: ${note.aliases.join(', ')})`;
+        }
+        let tagsSuffix = '';
+        if (note.tags && Array.isArray(note.tags) && note.tags.length > 0) {
+            tagsSuffix = ` [tags: ${note.tags.join(', ')}]`;
+        }
+        let parentSuffix = '';
+        if (typeof note.parentTitle === 'string' && note.parentTitle.length > 0) {
+            const parentIdSuffix = typeof note.parentRemId === 'string' ? ` [${note.parentRemId}]` : '';
+            parentSuffix = ` <- ${note.parentTitle}${parentIdSuffix}`;
+        }
+        return `${i + 1}. ${typeTag}${headline}${aliasesSuffix}${tagsSuffix}${parentSuffix} [${note.remId}]`;
+    })
+        .join('\n');
+}
+function registerCommonSearchOptions(command) {
+    return command
+        .option('-l, --limit <n>', `Maximum results (default: ${DEFAULT_SEARCH_LIMIT})`, String(DEFAULT_SEARCH_LIMIT))
+        .option('--include-content <mode>', 'Content rendering mode: "none" (default), "markdown", or "structured"')
+        .option('--depth <n>', 'Depth of child hierarchy to render (default: 1)')
+        .option('--child-limit <n>', 'Maximum children per level (default: 20)')
+        .option('--max-content-length <n>', 'Maximum content character length (default: 3000)');
+}
+export function registerSearchCommand(program) {
+    registerCommonSearchOptions(program.command('search <query>').description('Search for notes in RemNote')).action(async (query, opts) => {
+        const globalOpts = program.opts();
+        const format = globalOpts.text ? 'text' : 'json';
+        const client = createCommandClient(program);
+        try {
+            const payload = {
+                query,
+                limit: parseInt(opts.limit, 10),
+            };
+            applySearchOptions(payload, opts);
+            const result = await client.execute('search', payload);
+            console.log(formatResult(result, format, (data) => formatSearchText(data)));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(formatError(message, format));
+            process.exit(EXIT.ERROR);
+        }
+        finally {
+            await client.close();
+        }
+    });
+}
+export function registerSearchByTagCommand(program) {
+    registerCommonSearchOptions(program
+        .command('search-tag <tag>')
+        .description('Search notes by tag with ancestor-context resolution')).action(async (tag, opts) => {
+        const globalOpts = program.opts();
+        const format = globalOpts.text ? 'text' : 'json';
+        const client = createCommandClient(program);
+        try {
+            const payload = {
+                tag,
+                limit: parseInt(opts.limit, 10),
+            };
+            applySearchOptions(payload, opts);
+            const result = await client.execute('search_by_tag', payload);
+            console.log(formatResult(result, format, (data) => formatSearchText(data)));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(formatError(message, format));
+            process.exit(EXIT.ERROR);
+        }
+        finally {
+            await client.close();
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/remnote-cli/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/remnote-cli/commands/search.ts"],"names":[],"mappings":"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"}

package/dist/remnote-cli/commands/status.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerStatusCommand(program: Command): void;

package/dist/remnote-cli/commands/status.js

@@ -0,0 +1,41 @@
+import { createCommandClient } from '../client/command-client.js';
+import { formatResult, formatError } from '../output/formatter.js';
+import { EXIT } from '../config.js';
+export function registerStatusCommand(program) {
+    program
+        .command('status')
+        .description('Check bridge connection status')
+        .action(async () => {
+        const globalOpts = program.opts();
+        const format = globalOpts.text ? 'text' : 'json';
+        const client = createCommandClient(program);
+        try {
+            const result = await client.execute('get_status', {});
+            console.log(formatResult(result, format, (data) => {
+                const r = data;
+                const connected = r.connected ? 'Connected' : 'Not connected';
+                const pluginVersion = r.pluginVersion ? ` (plugin v${r.pluginVersion})` : '';
+                const cliVersion = r.cliVersion ? `CLI: v${r.cliVersion}` : '';
+                const lines = [`Bridge: ${connected}${pluginVersion}`];
+                if (cliVersion)
+                    lines.push(cliVersion);
+                if (r.version_warning)
+                    lines.push(`WARNING: ${r.version_warning}`);
+                return lines.join('\n');
+            }));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes('Cannot connect to MCP server')) {
+                console.error(formatError(message, format));
+                process.exit(EXIT.MCP_SERVER_NOT_RUNNING);
+            }
+            console.error(formatError(message, format));
+            process.exit(EXIT.ERROR);
+        }
+        finally {
+            await client.close();
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/remnote-cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/remnote-cli/commands/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAqB,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,MAAM,GAAiB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAC/D,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAE5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CACT,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACpC,MAAM,CAAC,GAAG,IAA+B,CAAC;gBAC1C,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC9D,MAAM,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7E,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,MAAM,KAAK,GAAG,CAAC,WAAW,SAAS,GAAG,aAAa,EAAE,CAAC,CAAC;gBACvD,IAAI,UAAU;oBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACvC,IAAI,CAAC,CAAC,eAAe;oBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;gBACnE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC5C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/remnote-cli/commands/table.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerReadTableCommand(program: Command): void;