remnote-mcp-server 0.14.2 → 0.15.0

package/CHANGELOG.md

@@ -7,6 +7,50 @@ Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.15.0] - 2026-05-15
+
+### Added
+
+- Add split RemNote write tools: `remnote_insert_children`, `remnote_replace_children`, and `remnote_update_tags`, plus
+  matching `remnote-cli` commands for ordered child insertion, destructive child replacement, and exact-ID tag mutation.
+- Add exact-ID tag assignment to `remnote_append_journal` and `remnote-cli journal --tag-ids`.
+- Add `remnote-mcp-server daemon` lifecycle commands for detached background startup, status, logs, graceful shutdown,
+  duplicate-start protection, stable log routing, and macOS `launchd` login persistence.
+- Add `~/.remnote-mcp-server/config.toml` for persistent server and daemon defaults, including ports, host, log levels,
+  file logs, and WebSocket request/response JSON Lines logs.
+- Add end-user validation guidance for MCP setup checks, including a zero-config agent validation prompt.
+
+### Changed
+
+- Change `tags` output metadata to preserve exact tag Rem IDs plus names as `{ tagRemId, name }` objects.
+- Change `remnote_search_by_tag` and `remnote-cli search-by-tag --tag-id` to search by exact tag Rem ID instead of tag
+  name or alias lookup.
+- Update `remnote_get_playbook` guidance for the split write tools and exact-ID tag fields without expanding the
+  playbook shape.
+- Limit `remnote_update_note` and `remnote-cli update` to metadata title updates so child and tag writes use focused
+  non-duplicative interfaces.
+- Change `remnote_create_note` and `remnote-cli create` to use exact tag Rem IDs via `tagRemIds` / `--tag-ids` instead
+  of name-based `tags` / `--tags`.
+- Generate MCPB manifest tools and fallback tool metadata from the canonical server tool definitions instead of
+  maintaining those copies by hand.
+- Add daemon startup, status, log, and macOS persistence pointers to installation, configuration, and troubleshooting
+  docs.
+- Make daemon lifecycle commands launchd-aware on macOS when the LaunchAgent is installed, and document the shared
+  control surface.
+- Update agent-assisted live integration safeguards so agents preflight port `3001`, refuse to run when an existing
+  server is listening, and use `run-agent-integration-test.sh --preflight-only` for the same guard as real live runs.
+- Clarify setup documentation for the official bridge plugin, compatible `remnote-mcp-server` versions, and explicit
+  `remnote-mcp-server` versus `remnote-cli` documentation targets.
+
+### Fixed
+
+- Fix OpenAI/Codex tool registration compatibility by removing top-level JSON Schema composition keywords from
+  advertised MCP tool input schemas while keeping server-side validation strict.
+- Align MCPB manifest and fallback tool metadata with the split write tools so local Claude Desktop/MCPB clients no
+  longer see stale `remnote_update_note` content/tag fields or name-based create tags.
+- Tighten runtime validation for split child insertion and tag updates while keeping advertised MCP JSON schemas
+  client-compatible.
+
 ## [0.14.2] - 2026-05-08
 
 ### Changed

package/README.md

@@ -9,14 +9,19 @@ MCP server and CLI package that bridges AI agents, local scripts, and coding har
 [RemNote](https://remnote.com/) via the [RemNote Automation Bridge
 plugin](https://github.com/robert7/remnote-mcp-bridge).
 
-> If you run into any issues, please [report them here](https://github.com/robert7/remnote-mcp-server/issues).
-
-> **Connection issue? Check the RemNote plugin first.** The RemNote Marketplace may show multiple similarly named
-> `MCP Bridge` plugins. For this server, install the official **MCP/OpenClaw Automation Bridge** plugin by Robert
-> Spiegel and keep it on the same `0.x` minor version line as `remnote-mcp-server` (for example `0.14.x` with
-> `0.14.x`). Wrong plugin flavors or incompatible marketplace copies can connect briefly and then disconnect with a
-> `1008` compatibility message. See the related upstream marketplace confusion report:
-> [quentintou/remnote-mcp-bridge#8](https://github.com/quentintou/remnote-mcp-bridge/issues/8).
+> **Connection issue? Check the RemNote bridge plugin and server versions first.** Use the official
+> **MCP/OpenClaw Automation Bridge** by Robert Spiegel in RemNote, and run a compatible `remnote-mcp-server` on the same
+> `0.x` minor line (for example, `0.15.x` with `0.15.x`). Wrong plugin flavors or mismatched versions can disconnect
+> with a `1008` compatibility message. If Marketplace and npm releases are temporarily out of sync, pin the matching
+> server package or run matching bridge/server checkouts from source. Start with the
+> [version compatibility guide](https://github.com/robert7/remnote-mcp-bridge/blob/main/docs/guides/bridge-consumer-version-compatibility.md),
+> [plugin install guide](https://github.com/robert7/remnote-mcp-bridge/blob/main/docs/guides/install-plugin-via-marketplace-beginner.md),
+> [local plugin guide](https://github.com/robert7/remnote-mcp-bridge/blob/main/docs/guides/development-run-plugin-locally.md), and
+> [server installation guide](docs/guides/installation.md).
+> After setup, see the [agent validation prompts](docs/agent-validation-prompts/README.md) to verify that your chosen AI
+> agent can use the installed RemNote MCP tools end to end.
+> If the guides do not resolve your problem, [open an issue](https://github.com/robert7/remnote-mcp-server/issues) with
+> the relevant versions, setup path, observed behavior, and exact error/status message.
 
 ## What is This?
 
@@ -74,10 +79,10 @@ expose the HTTP endpoint securely. The WebSocket connection always stays local f
 ## Features
 
 - **Create Notes & Flashcards** - Create simple notes, hierarchical markdown trees, or RemNote-native flashcards
-- **Search Knowledge Base** - Run full-text searches or tag-based searches with ancestor context
+- **Search Knowledge Base** - Run full-text searches or exact tag Rem ID searches with ancestor context
 - **Read Notes** - Retrieve note content in markdown or structured form with configurable traversal depth
-- **Update Notes** - Modify titles, append or replace hierarchical content, and manage tags
-- **Journal Entries** - Append timestamped daily entries, including hierarchical markdown content
+- **Update Notes** - Modify titles, insert or replace hierarchical content, and manage tags by exact Rem ID
+- **Journal Entries** - Append timestamped daily entries with hierarchical markdown content and optional exact tag Rem IDs
 - **Agent Playbook** - Return built-in navigation and safety guidance for MCP clients
 - **Connection Status** - Check server and plugin connection health
 
@@ -115,11 +120,29 @@ remnote-mcp-server
 Expected output:
 
 ```text
-RemNote MCP Server v0.14.1 listening { wsPort: 3002, httpPort: 3001 }
+RemNote MCP Server v<version> listening { wsPort: 3002, httpPort: 3001 }
 ```
 
 Keep this terminal running.
 
+For a background server that survives terminal close and writes to a stable log file:
+
+```bash
+remnote-mcp-server daemon start
+remnote-mcp-server daemon status
+remnote-mcp-server daemon logs
+remnote-mcp-server daemon stop
+```
+
+Daemon state and logs default to `~/.remnote-mcp-server/`. On macOS, install a login LaunchAgent for restart/login
+persistence:
+
+```bash
+remnote-mcp-server daemon install-launchd
+```
+
+After installing the LaunchAgent, `remnote-mcp-server daemon status|start|stop|restart` controls the launchd service.
+
 ### 4. Configure Your AI Client
 
 - [Configuration Guide](docs/guides/configuration.md) - Overview and generic setup
@@ -147,8 +170,8 @@ Keep this terminal running.
 
 ### Usage
 
-- **[CLI Options Reference](docs/guides/cli-options.md)** - Command-line options and environment variables
-- **[remnote-cli Command Reference](docs/guides/cli-command-reference.md)** - Shell command reference for the bundled CLI
+- **[remnote-mcp-server Command Reference](docs/guides/remnote-mcp-server-command-reference.md)** - Server executable, daemon, and launchd options
+- **[remnote-cli Command Reference](docs/guides/remnote-cli-command-reference.md)** - Shell command reference for the bundled CLI
 - **[MCP Tools Reference](docs/guides/tools-reference.md)** - Detailed reference for all 9 RemNote tools
 - **[Remote Access Setup](docs/guides/remote-access.md)** - Expose server for cloud clients or remote connector flows
   (ngrok, etc.)
@@ -161,21 +184,26 @@ Keep this terminal running.
 ### Development
 
 - **[Development Setup](docs/guides/development-setup.md)** - Contributing guide for developers
+- **[Testing Strategy](docs/guides/testing-strategy.md)** - Three-level testing model: local quality checks, maintainer
+  live integration, and end-user agent validation
 - **[Integration Testing](docs/guides/integration-testing.md)** - Canonical shared workflow for updating and running MCP server + CLI integration coverage against live RemNote
 - **[Publishing Guide](docs/npm-publishing.md)** - npm publishing process (maintainers only)
 
 ## Available MCP Tools
 
-| Tool                      | Description                                    |
-|---------------------------|------------------------------------------------|
-| `remnote_create_note`     | Create notes, markdown trees, or flashcards with title, content, parent, and tags |
-| `remnote_search`          | Search knowledge base with full-text search and parent-context metadata; `tags` remain optional and SDK-limited |
-| `remnote_search_by_tag`   | Search by tag with ancestor-context resolution |
-| `remnote_read_note`       | Read note by ID with metadata and markdown or structured content; readable `tags` remain SDK-limited |
-| `remnote_update_note`     | Update title, append/replace content, or modify tags |
-| `remnote_append_journal`  | Append hierarchical content to today's daily document |
+| Tool                      | Description                                                                 |
+|---------------------------|-----------------------------------------------------------------------------|
+| `remnote_create_note`     | Create notes, markdown trees, or flashcards with optional exact tag Rem IDs |
+| `remnote_search`          | Search knowledge base with full-text search, parent context, and optional tag IDs/names |
+| `remnote_search_by_tag`   | Search by exact tag Rem ID with ancestor-context resolution |
+| `remnote_read_note`       | Read note by ID with metadata, optional tag IDs/names, and markdown or structured content |
+| `remnote_update_note`     | Update title |
+| `remnote_insert_children` | Insert child Rems at deterministic positions |
+| `remnote_replace_children` | Replace direct children when destructive replacement is enabled |
+| `remnote_update_tags`     | Add or remove tags by exact tag Rem ID |
+| `remnote_append_journal`  | Append hierarchical content to today's daily document with optional tag Rem IDs |
 | `remnote_read_table`      | Read Advanced Table columns, rows, and typed property metadata |
-| `remnote_get_playbook`    | Get recommended MCP usage/navigation playbook  |
+| `remnote_get_playbook`    | Get recommended MCP usage/navigation playbook |
 | `remnote_status`          | Check connection status and statistics         |
 
 Tools that declare an `outputSchema` return MCP `structuredContent` plus a JSON `content` text block for compatibility.
@@ -245,7 +273,21 @@ remnote-mcp-server --http-port 3003 --ws-port 3004
 
 After changing ports, update your MCP client configuration and RemNote plugin settings.
 
-See [CLI Options Reference](docs/guides/cli-options.md) for all options.
+### Background Daemon
+
+```bash
+remnote-mcp-server daemon start
+```
+
+- Default log: `~/.remnote-mcp-server/remnote-mcp-server.log`
+- Duplicate starts are treated as already running when the daemon PID is alive.
+- If the configured HTTP or WebSocket port is already occupied, startup fails before spawning a second server.
+- Use `remnote-mcp-server daemon stop` for graceful shutdown.
+- Use `remnote-mcp-server daemon install-launchd` on macOS to keep the server running across login and unexpected
+  exits.
+- When launchd is installed, the same `daemon status/start/stop/restart` commands control the launchd service.
+
+See [remnote-mcp-server Command Reference](docs/guides/remnote-mcp-server-command-reference.md) for all options.
 
 ## Troubleshooting
 
@@ -295,7 +337,7 @@ See the [Development Setup Guide](docs/guides/development-setup.md) for complete
 
 Pull requests that affect bridge-consumer behavior should follow the shared PR rules in the bridge repo: [Pull Request Guide](https://github.com/robert7/remnote-mcp-bridge/blob/main/docs/guides/pull-request-guide.md). In particular, keep bridge and server-package behavior aligned for shared functionality changes.
 
-For the canonical workflow for updating and running shared live integration coverage, see the [Integration Testing Guide](docs/guides/integration-testing.md).
+For the three-level testing model and links to each verification path, see the [Testing Strategy](docs/guides/testing-strategy.md).
 
 ## Related Projects
 

package/dist/cli.d.ts

@@ -1,4 +1,5 @@
 export interface CliOptions {
+    config?: string;
     wsPort?: number;
     httpPort?: number;
     httpHost?: string;
@@ -13,7 +14,7 @@ export declare function getBundledMcpbPath(): string;
 /**
  * Handle utility commands that do not start the MCP server.
  */
-export declare function handleUtilityCommand(argv?: string[]): boolean;
+export declare function handleUtilityCommand(argv?: string[]): Promise<boolean>;
 /**
  * Parse CLI arguments and return typed options
  */

package/dist/cli.js

@@ -1,6 +1,7 @@
 import { Command } from 'commander';
 import { createRequire } from 'module';
 import { fileURLToPath } from 'url';
+import { handleDaemonCommand, isDaemonCommand } from './daemon.js';
 const require = createRequire(import.meta.url);
 const packageJson = require('../package.json');
 const validLogLevels = ['debug', 'info', 'warn', 'error'];
@@ -11,8 +12,13 @@ export function getBundledMcpbPath() {
 /**
  * Handle utility commands that do not start the MCP server.
  */
-export function handleUtilityCommand(argv = process.argv) {
+export async function handleUtilityCommand(argv = process.argv) {
     if (argv[2] !== MCPB_PATH_COMMAND) {
+        if (isDaemonCommand(argv)) {
+            const result = await handleDaemonCommand(argv);
+            process.exitCode = result.exitCode;
+            return result.handled;
+        }
         return false;
     }
     console.log(getBundledMcpbPath());
@@ -27,10 +33,11 @@ export function parseCliArgs() {
         .name('remnote-mcp-server')
         .description('MCP server bridge for RemNote knowledge base')
         .version(packageJson.version)
-        .addHelpText('after', '\nCommands:\n  mcpb-path                 Print the bundled Claude Desktop MCPB extension path')
+        .addHelpText('after', '\nCommands:\n  mcpb-path                 Print the bundled Claude Desktop MCPB extension path\n  daemon <action>           Manage background server lifecycle and macOS launchd persistence')
         .option('--ws-port <number>', 'WebSocket port (default: 3002, env: REMNOTE_WS_PORT)', parsePort)
         .option('--http-port <number>', 'HTTP MCP port (default: 3001, env: REMNOTE_HTTP_PORT)', parsePort)
         .option('--http-host <host>', 'HTTP server bind address (default: 127.0.0.1, env: REMNOTE_HTTP_HOST). Use 0.0.0.0 for Docker/VPS deployments', validateHost)
+        .option('--config <path>', 'TOML config file path (default: ~/.remnote-mcp-server/config.toml)')
         .option('--log-level <level>', `Console log level: ${validLogLevels.join(', ')} (default: info)`, validateLogLevel)
         .option('--log-level-file <level>', `File log level (default: same as --log-level)`, validateLogLevel)
         .option('--verbose', 'Shorthand for --log-level debug')

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -11,8 +11,20 @@ export interface ServerConfig {
     responseLog?: string;
     prettyLogs: boolean;
 }
+export interface ConfigFileOptions {
+    server?: Partial<Omit<CliOptions, 'config'>>;
+    daemon?: {
+        logFile?: string;
+    };
+}
+export interface ConfigLoadOptions {
+    homeDir?: string;
+}
+export declare const CONFIG_FILE_NAME = "config.toml";
 /**
  * Merge CLI options with environment variables and apply defaults
- * Precedence: CLI > Environment Variables > Defaults
+ * Precedence: CLI > Environment Variables > Config File > Defaults
  */
-export declare function getConfig(cliOptions: CliOptions): ServerConfig;
+export declare function getConfig(cliOptions: CliOptions, loadOptions?: ConfigLoadOptions): ServerConfig;
+export declare function loadConfigFileOptions(configPath?: string, loadOptions?: ConfigLoadOptions): ConfigFileOptions;
+export declare function parseConfigToml(source: string, filePath?: string): ConfigFileOptions;

package/dist/config.js

@@ -1,10 +1,17 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const CONFIG_FILE_NAME = 'config.toml';
 /**
  * Merge CLI options with environment variables and apply defaults
- * Precedence: CLI > Environment Variables > Defaults
+ * Precedence: CLI > Environment Variables > Config File > Defaults
  */
-export function getConfig(cliOptions) {
+export function getConfig(cliOptions, loadOptions = {}) {
+    const homeDir = loadOptions.homeDir ?? homedir();
+    const configFile = loadConfigFileOptions(cliOptions.config, loadOptions);
+    const configOptions = configFile.server ?? {};
     // Apply verbose flag override
-    let logLevel = cliOptions.logLevel || 'info';
+    let logLevel = cliOptions.logLevel ?? (configOptions.verbose ? 'debug' : configOptions.logLevel) ?? 'info';
     if (cliOptions.verbose) {
         logLevel = 'debug';
     }
@@ -17,18 +24,30 @@ export function getConfig(cliOptions) {
         throw new Error(`Invalid HTTP port: ${cliOptions.httpPort}. Must be between 1 and 65535.`);
     }
     // Get ports with CLI > env > default precedence
-    const wsPort = cliOptions.wsPort || parseInt(process.env.REMNOTE_WS_PORT || '3002', 10);
-    const httpPort = cliOptions.httpPort || parseInt(process.env.REMNOTE_HTTP_PORT || '3001', 10);
+    const wsPort = cliOptions.wsPort ??
+        parseOptionalPortEnv(process.env.REMNOTE_WS_PORT) ??
+        configOptions.wsPort ??
+        3002;
+    const httpPort = cliOptions.httpPort ??
+        parseOptionalPortEnv(process.env.REMNOTE_HTTP_PORT) ??
+        configOptions.httpPort ??
+        3001;
     // Get hosts with CLI > env > default precedence
     // SECURITY: WebSocket ALWAYS binds to localhost, regardless of env var or CLI option
     const wsHost = '127.0.0.1';
-    const httpHost = cliOptions.httpHost || process.env.REMNOTE_HTTP_HOST || '127.0.0.1';
+    const httpHost = cliOptions.httpHost ?? process.env.REMNOTE_HTTP_HOST ?? configOptions.httpHost ?? '127.0.0.1';
     // Validate port conflicts
     if (wsPort === httpPort) {
         throw new Error(`WebSocket port and HTTP port cannot be the same (both set to ${wsPort})`);
     }
+    const logFileOption = cliOptions.logFile ?? configOptions.logFile;
+    const logFile = logFileOption ? resolveTilde(logFileOption, homeDir) : undefined;
+    const requestLogOption = cliOptions.requestLog ?? configOptions.requestLog;
+    const requestLog = requestLogOption ? resolveTilde(requestLogOption, homeDir) : undefined;
+    const responseLogOption = cliOptions.responseLog ?? configOptions.responseLog;
+    const responseLog = responseLogOption ? resolveTilde(responseLogOption, homeDir) : undefined;
     // File log level defaults to console log level if not specified
-    const logLevelFile = cliOptions.logLevelFile || (cliOptions.logFile ? logLevel : undefined);
+    const logLevelFile = cliOptions.logLevelFile ?? configOptions.logLevelFile ?? (logFile ? logLevel : undefined);
     // Pretty logs in development (when using pino-pretty)
     const prettyLogs = process.stdout.isTTY === true;
     return {
@@ -38,10 +57,191 @@ export function getConfig(cliOptions) {
         httpHost,
         logLevel,
         logLevelFile,
-        logFile: cliOptions.logFile,
-        requestLog: cliOptions.requestLog,
-        responseLog: cliOptions.responseLog,
+        logFile,
+        requestLog,
+        responseLog,
         prettyLogs,
     };
 }
+export function loadConfigFileOptions(configPath, loadOptions = {}) {
+    const homeDir = loadOptions.homeDir ?? homedir();
+    const resolvedPath = resolveTilde(configPath ?? join('~', '.remnote-mcp-server', CONFIG_FILE_NAME), homeDir);
+    const explicitPath = configPath !== undefined;
+    if (!existsSync(resolvedPath)) {
+        if (explicitPath) {
+            throw new Error(`Config file not found: ${resolvedPath}`);
+        }
+        return {};
+    }
+    return parseConfigToml(readFileSync(resolvedPath, 'utf8'), resolvedPath);
+}
+export function parseConfigToml(source, filePath = CONFIG_FILE_NAME) {
+    const config = {};
+    let section;
+    source.split(/\r?\n/).forEach((rawLine, index) => {
+        const lineNumber = index + 1;
+        const line = stripTomlComment(rawLine).trim();
+        if (!line) {
+            return;
+        }
+        const sectionMatch = line.match(/^\[([A-Za-z0-9_-]+)\]$/);
+        if (sectionMatch) {
+            const parsedSection = sectionMatch[1];
+            if (parsedSection !== 'server' && parsedSection !== 'daemon') {
+                throw new Error(`${filePath}:${lineNumber}: Unknown config section [${parsedSection}]`);
+            }
+            section = parsedSection;
+            config[section] ??= {};
+            return;
+        }
+        if (!section) {
+            throw new Error(`${filePath}:${lineNumber}: Config values must be under [server] or [daemon]`);
+        }
+        const keyValueMatch = line.match(/^([A-Za-z][A-Za-z0-9_]*)\s*=\s*(.+)$/);
+        if (!keyValueMatch) {
+            throw new Error(`${filePath}:${lineNumber}: Invalid TOML assignment`);
+        }
+        const [, key, rawValue] = keyValueMatch;
+        const value = parseTomlValue(rawValue.trim(), filePath, lineNumber);
+        assignConfigValue(config, section, key, value, filePath, lineNumber);
+    });
+    return config;
+}
+function assignConfigValue(config, section, key, value, filePath, lineNumber) {
+    if (section === 'daemon') {
+        if (key !== 'logFile') {
+            throw new Error(`${filePath}:${lineNumber}: Unknown daemon config key "${key}"`);
+        }
+        config.daemon ??= {};
+        config.daemon.logFile = expectString(value, filePath, lineNumber, key);
+        return;
+    }
+    config.server ??= {};
+    switch (key) {
+        case 'wsPort':
+            config.server.wsPort = expectPort(value, filePath, lineNumber, key);
+            return;
+        case 'httpPort':
+            config.server.httpPort = expectPort(value, filePath, lineNumber, key);
+            return;
+        case 'httpHost':
+            config.server.httpHost = validateHost(expectString(value, filePath, lineNumber, key), filePath, lineNumber);
+            return;
+        case 'logLevel':
+            config.server.logLevel = validateLogLevel(expectString(value, filePath, lineNumber, key), filePath, lineNumber);
+            return;
+        case 'logLevelFile':
+            config.server.logLevelFile = validateLogLevel(expectString(value, filePath, lineNumber, key), filePath, lineNumber);
+            return;
+        case 'verbose':
+            config.server.verbose = expectBoolean(value, filePath, lineNumber, key);
+            return;
+        case 'logFile':
+            config.server.logFile = expectString(value, filePath, lineNumber, key);
+            return;
+        case 'requestLog':
+            config.server.requestLog = expectString(value, filePath, lineNumber, key);
+            return;
+        case 'responseLog':
+            config.server.responseLog = expectString(value, filePath, lineNumber, key);
+            return;
+        default:
+            throw new Error(`${filePath}:${lineNumber}: Unknown server config key "${key}"`);
+    }
+}
+function parseOptionalPortEnv(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return parseInt(value, 10);
+}
+function parseTomlValue(value, filePath, lineNumber) {
+    if (value === 'true') {
+        return true;
+    }
+    if (value === 'false') {
+        return false;
+    }
+    if (/^-?\d+$/.test(value)) {
+        return Number(value);
+    }
+    if (value.startsWith('"') && value.endsWith('"')) {
+        return value.slice(1, -1).replace(/\\"/g, '"').replace(/\\\\/g, '\\');
+    }
+    throw new Error(`${filePath}:${lineNumber}: Unsupported TOML value`);
+}
+function stripTomlComment(line) {
+    let inString = false;
+    let escaped = false;
+    for (let i = 0; i < line.length; i += 1) {
+        const char = line[i];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (char === '\\' && inString) {
+            escaped = true;
+            continue;
+        }
+        if (char === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (char === '#' && !inString) {
+            return line.slice(0, i);
+        }
+    }
+    return line;
+}
+function expectString(value, filePath, lineNumber, key) {
+    if (typeof value !== 'string') {
+        throw new Error(`${filePath}:${lineNumber}: Config key "${key}" must be a string`);
+    }
+    return value;
+}
+function expectBoolean(value, filePath, lineNumber, key) {
+    if (typeof value !== 'boolean') {
+        throw new Error(`${filePath}:${lineNumber}: Config key "${key}" must be a boolean`);
+    }
+    return value;
+}
+function expectPort(value, filePath, lineNumber, key) {
+    if (typeof value !== 'number') {
+        throw new Error(`${filePath}:${lineNumber}: Config key "${key}" must be a number`);
+    }
+    if (value < 1 || value > 65535) {
+        throw new Error(`${filePath}:${lineNumber}: Config key "${key}" must be between 1 and 65535`);
+    }
+    return value;
+}
+function validateLogLevel(value, filePath, lineNumber) {
+    const normalized = value.toLowerCase();
+    if (!['debug', 'info', 'warn', 'error'].includes(normalized)) {
+        throw new Error(`${filePath}:${lineNumber}: Invalid log level "${value}"`);
+    }
+    return normalized;
+}
+function validateHost(value, filePath, lineNumber) {
+    if (value === 'localhost' || value === '127.0.0.1' || value === '0.0.0.0') {
+        return value;
+    }
+    const ipv4Pattern = /^(\d{1,3}\.){3}\d{1,3}$/;
+    if (!ipv4Pattern.test(value)) {
+        throw new Error(`${filePath}:${lineNumber}: Invalid HTTP host "${value}"`);
+    }
+    const octets = value.split('.').map(Number);
+    if (octets.some((octet) => octet < 0 || octet > 255)) {
+        throw new Error(`${filePath}:${lineNumber}: Invalid HTTP host "${value}"`);
+    }
+    return value;
+}
+function resolveTilde(pathValue, homeDir) {
+    if (pathValue === '~') {
+        return homeDir;
+    }
+    if (pathValue.startsWith('~/')) {
+        return join(homeDir, pathValue.slice(2));
+    }
+    return pathValue;
+}
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,UAAsB;IAC9C,8BAA8B;IAC9B,IAAI,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,MAAM,CAAC;IAC7C,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,QAAQ,GAAG,OAAO,CAAC;IACrB,CAAC;IAED,0CAA0C;IAC1C,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC;QAC5F,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,CAAC,MAAM,gCAAgC,CAAC,CAAC;IAChG,CAAC;IACD,IACE,UAAU,CAAC,QAAQ,KAAK,SAAS;QACjC,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,GAAG,KAAK,CAAC,EACxD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sBAAsB,UAAU,CAAC,QAAQ,gCAAgC,CAAC,CAAC;IAC7F,CAAC;IAED,gDAAgD;IAChD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAE9F,gDAAgD;IAChD,qFAAqF;IACrF,MAAM,MAAM,GAAG,WAAW,CAAC;IAC3B,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,WAAW,CAAC;IAErF,0BAA0B;IAC1B,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,gEAAgE,MAAM,GAAG,CAAC,CAAC;IAC7F,CAAC;IAED,gEAAgE;IAChE,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAE5F,sDAAsD;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;IAEjD,OAAO;QACL,MAAM;QACN,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,YAAY;QACZ,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,UAAU;KACX,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/daemon.d.ts

@@ -0,0 +1,61 @@
+import { spawn, execFile } from 'node:child_process';
+import type { CliOptions } from './cli.js';
+declare const execFileAsync: typeof execFile.__promisify__;
+export declare const DEFAULT_DAEMON_DIR_NAME = ".remnote-mcp-server";
+export declare const DAEMON_PID_FILE_NAME = "remnote-mcp-server.pid";
+export declare const DAEMON_STATE_FILE_NAME = "daemon.json";
+export declare const DAEMON_LOG_FILE_NAME = "remnote-mcp-server.log";
+export declare const LAUNCHD_LABEL = "com.remnote.mcp-server";
+export interface DaemonCommand {
+    action: DaemonAction;
+    cliOptions: CliOptions;
+    stateDir?: string;
+    timeoutMs?: number;
+    force?: boolean;
+    lines?: number;
+}
+export type DaemonAction = 'start' | 'stop' | 'restart' | 'status' | 'logs' | 'install-launchd' | 'uninstall-launchd';
+export interface DaemonState {
+    pid: number;
+    startedAt: string;
+    entrypointPath: string;
+    logFile: string;
+    httpPort: number;
+    httpHost: string;
+    wsPort: number;
+    wsHost: string;
+}
+export interface DaemonPaths {
+    stateDir: string;
+    pidFile: string;
+    stateFile: string;
+    logFile: string;
+    lockFile: string;
+    launchAgentFile: string;
+}
+export interface DaemonRuntime {
+    argv?: string[];
+    entrypointPath?: string;
+    execPath?: string;
+    homeDir?: string;
+    platform?: NodeJS.Platform;
+    uid?: number;
+    stdout?: Pick<NodeJS.WriteStream, 'write'>;
+    stderr?: Pick<NodeJS.WriteStream, 'write'>;
+    isProcessAlive?: (pid: number) => boolean;
+    canBind?: (host: string, port: number) => Promise<boolean>;
+    getProcessCommand?: (pid: number) => Promise<string | null>;
+    spawnProcess?: typeof spawn;
+    execFile?: typeof execFileAsync;
+    killProcess?: (pid: number, signal: NodeJS.Signals) => void;
+}
+export interface DaemonResult {
+    exitCode: number;
+    handled: true;
+}
+export declare function getDefaultDaemonPaths(homeDir?: string, stateDir?: string): DaemonPaths;
+export declare function isDaemonCommand(argv?: string[]): boolean;
+export declare function handleDaemonCommand(argv?: string[], runtime?: DaemonRuntime): Promise<DaemonResult>;
+export declare function formatDaemonUsage(): string;
+export declare function runDaemonCommand(command: DaemonCommand, runtime?: DaemonRuntime): Promise<number>;
+export {};