remnote-bridge 0.1.0

package/dist/cli/commands/connect.d.ts

@@ -0,0 +1,12 @@
+/**
+ * connect 命令
+ *
+ * 启动后台守护进程（WS Server + webpack-dev-server），等待 Plugin 连接。
+ * - 已在运行 → 打印提示，退出码 0
+ * - stale PID → 清理后正常启动
+ * - 启动失败 → 退出码 1
+ */
+export interface ConnectOptions {
+    json?: boolean;
+}
+export declare function connectCommand(options?: ConnectOptions): Promise<void>;

package/dist/cli/commands/connect.js

@@ -0,0 +1,124 @@
+/**
+ * connect 命令
+ *
+ * 启动后台守护进程（WS Server + webpack-dev-server），等待 Plugin 连接。
+ * - 已在运行 → 打印提示，退出码 0
+ * - stale PID → 清理后正常启动
+ * - 启动失败 → 退出码 1
+ */
+import path from 'path';
+import fs from 'fs';
+import { fork } from 'child_process';
+import { loadConfig, pidFilePath, findProjectRoot } from '../config.js';
+import { checkDaemon } from '../daemon/pid.js';
+import { jsonOutput } from '../utils/output.js';
+function isDaemonMessage(msg) {
+    return (typeof msg === 'object' &&
+        msg !== null &&
+        typeof msg.type === 'string');
+}
+export async function connectCommand(options = {}) {
+    const { json } = options;
+    const projectRoot = findProjectRoot();
+    const config = loadConfig(projectRoot);
+    const pidPath = pidFilePath(projectRoot);
+    // 检查是否已在运行
+    const status = checkDaemon(pidPath);
+    if (status.running) {
+        if (json) {
+            jsonOutput({
+                ok: true, command: 'connect', alreadyRunning: true,
+                pid: status.pid, wsPort: config.wsPort, devServerPort: config.devServerPort,
+            });
+        }
+        else {
+            console.log(`守护进程已在运行（PID: ${status.pid}）`);
+        }
+        process.exitCode = 0;
+        return;
+    }
+    // fork 守护进程
+    const daemonScriptJs = path.resolve(import.meta.dirname, '..', 'daemon', 'daemon.js');
+    const daemonScriptTs = path.resolve(import.meta.dirname, '..', 'daemon', 'daemon.ts');
+    let scriptPath;
+    let execArgv = [];
+    // 判断是 ts 开发模式还是 js 构建后模式
+    if (fs.existsSync(daemonScriptJs)) {
+        scriptPath = daemonScriptJs;
+    }
+    else {
+        scriptPath = daemonScriptTs;
+        // 继承父进程的 tsx loader 参数（排除 --eval 相关项）
+        execArgv = process.execArgv.filter((arg) => !arg.startsWith('--eval') && !arg.includes('const '));
+    }
+    if (!json) {
+        console.log('正在启动守护进程...');
+    }
+    const child = fork(scriptPath, [], {
+        detached: true,
+        stdio: ['ignore', 'ignore', 'ignore', 'ipc'],
+        cwd: projectRoot,
+        execArgv,
+    });
+    // 等待就绪信号，超时 10 秒
+    const ready = await new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            resolve(null);
+        }, 10_000);
+        child.on('message', (msg) => {
+            if (isDaemonMessage(msg)) {
+                clearTimeout(timeout);
+                resolve(msg);
+            }
+        });
+        child.on('error', (err) => {
+            clearTimeout(timeout);
+            resolve({ type: 'error', message: String(err) });
+        });
+        child.on('exit', (code) => {
+            clearTimeout(timeout);
+            if (code !== null && code !== 0) {
+                resolve({ type: 'error', message: `守护进程异常退出（退出码 ${code}）` });
+            }
+        });
+    });
+    // 断开与子进程的连接（让 CLI 进程可以退出）
+    child.unref();
+    child.disconnect?.();
+    if (!ready) {
+        if (json) {
+            jsonOutput({ ok: false, command: 'connect', error: '守护进程启动超时（10 秒）' });
+        }
+        else {
+            console.error('守护进程启动超时（10 秒）');
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (ready.type === 'error') {
+        if (json) {
+            jsonOutput({ ok: false, command: 'connect', error: ready.message });
+        }
+        else {
+            console.error(`守护进程启动失败: ${ready.message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (json) {
+        jsonOutput({
+            ok: true, command: 'connect', alreadyRunning: false,
+            pid: ready.pid, wsPort: ready.wsPort, devServerPort: ready.devServerPort,
+            configPort: ready.configPort,
+            timeoutMinutes: config.daemonTimeoutMinutes,
+        });
+    }
+    else {
+        console.log(`守护进程已启动（PID: ${ready.pid}）`);
+        console.log(`  WS Server:         ws://127.0.0.1:${ready.wsPort}`);
+        console.log(`  webpack-dev-server: http://localhost:${ready.devServerPort}`);
+        console.log(`  配置页面:          http://127.0.0.1:${ready.configPort}`);
+        console.log(`  超时: ${config.daemonTimeoutMinutes} 分钟无 CLI 交互后自动关闭`);
+    }
+    process.exitCode = 0;
+}

package/dist/cli/commands/disconnect.d.ts

@@ -0,0 +1,11 @@
+/**
+ * disconnect 命令
+ *
+ * 停止守护进程，释放端口和资源。
+ * - 守护进程运行中 → 发送 SIGTERM，等待退出
+ * - 守护进程未运行 → 打印提示，退出码 0
+ */
+export interface DisconnectOptions {
+    json?: boolean;
+}
+export declare function disconnectCommand(options?: DisconnectOptions): Promise<void>;

package/dist/cli/commands/disconnect.js

@@ -0,0 +1,100 @@
+/**
+ * disconnect 命令
+ *
+ * 停止守护进程，释放端口和资源。
+ * - 守护进程运行中 → 发送 SIGTERM，等待退出
+ * - 守护进程未运行 → 打印提示，退出码 0
+ */
+import { pidFilePath, findProjectRoot } from '../config.js';
+import { checkDaemon, removePid } from '../daemon/pid.js';
+import { jsonOutput } from '../utils/output.js';
+const WAIT_TIMEOUT_MS = 10_000;
+const POLL_INTERVAL_MS = 200;
+export async function disconnectCommand(options = {}) {
+    const { json } = options;
+    const projectRoot = findProjectRoot();
+    const pidPath = pidFilePath(projectRoot);
+    const status = checkDaemon(pidPath);
+    if (!status.running) {
+        if (json) {
+            jsonOutput({ ok: true, command: 'disconnect', wasRunning: false });
+        }
+        else {
+            console.log('守护进程未在运行');
+        }
+        process.exitCode = 0;
+        return;
+    }
+    const pid = status.pid;
+    if (!json) {
+        console.log(`正在停止守护进程（PID: ${pid}）...`);
+    }
+    // 发送 SIGTERM
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch (err) {
+        // 进程可能已经退出
+        removePid(pidPath);
+        if (json) {
+            jsonOutput({ ok: true, command: 'disconnect', wasRunning: true, pid, forced: false });
+        }
+        else {
+            console.log('守护进程已停止');
+        }
+        process.exitCode = 0;
+        return;
+    }
+    // 等待进程退出
+    const exited = await waitForExit(pid, WAIT_TIMEOUT_MS);
+    if (exited) {
+        removePid(pidPath);
+        if (json) {
+            jsonOutput({ ok: true, command: 'disconnect', wasRunning: true, pid, forced: false });
+        }
+        else {
+            console.log('守护进程已停止');
+        }
+        process.exitCode = 0;
+    }
+    else {
+        try {
+            process.kill(pid, 'SIGKILL');
+        }
+        catch {
+            // 可能已退出
+        }
+        removePid(pidPath);
+        if (json) {
+            jsonOutput({ ok: true, command: 'disconnect', wasRunning: true, pid, forced: true });
+        }
+        else {
+            console.error(`守护进程未在 ${WAIT_TIMEOUT_MS / 1000} 秒内退出，尝试强制终止...`);
+            console.log('守护进程已强制终止');
+        }
+        process.exitCode = 0;
+    }
+}
+function waitForExit(pid, timeoutMs) {
+    return new Promise((resolve) => {
+        const start = Date.now();
+        const check = () => {
+            try {
+                // kill(pid, 0) 不发信号，只检查进程是否存在
+                process.kill(pid, 0);
+                // 进程仍在运行
+                if (Date.now() - start >= timeoutMs) {
+                    resolve(false);
+                }
+                else {
+                    setTimeout(check, POLL_INTERVAL_MS);
+                }
+            }
+            catch {
+                // 进程已退出
+                resolve(true);
+            }
+        };
+        check();
+    });
+}

package/dist/cli/commands/edit-rem.d.ts

@@ -0,0 +1,13 @@
+/**
+ * edit-rem 命令
+ *
+ * 通过 str_replace 编辑 Rem 的 JSON 序列化。
+ * 三道防线保证安全：缓存存在性、并发检测、精确匹配。
+ * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
+ */
+export interface EditRemOptions {
+    json?: boolean;
+    oldStr: string;
+    newStr: string;
+}
+export declare function editRemCommand(remId: string, options: EditRemOptions): Promise<void>;

package/dist/cli/commands/edit-rem.js

@@ -0,0 +1,83 @@
+/**
+ * edit-rem 命令
+ *
+ * 通过 str_replace 编辑 Rem 的 JSON 序列化。
+ * 三道防线保证安全：缓存存在性、并发检测、精确匹配。
+ * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
+ */
+import { sendDaemonRequest, DaemonNotRunningError, DaemonUnreachableError } from '../daemon/send-request.js';
+import { jsonOutput } from '../utils/output.js';
+export async function editRemCommand(remId, options) {
+    const { json, oldStr, newStr } = options;
+    let result;
+    try {
+        result = await sendDaemonRequest('edit_rem', { remId, oldStr, newStr });
+    }
+    catch (err) {
+        if (err instanceof DaemonNotRunningError) {
+            if (json) {
+                jsonOutput({ ok: false, command: 'edit-rem', error: err.message });
+            }
+            else {
+                console.error(`错误: ${err.message}`);
+            }
+            process.exitCode = 2;
+            return;
+        }
+        if (err instanceof DaemonUnreachableError) {
+            if (json) {
+                jsonOutput({ ok: false, command: 'edit-rem', error: err.message });
+            }
+            else {
+                console.error(`错误: ${err.message}`);
+            }
+            process.exitCode = 2;
+            return;
+        }
+        // 业务错误（防线拒绝、Plugin 未连接等）
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        if (json) {
+            jsonOutput({ ok: false, command: 'edit-rem', error: errorMsg });
+        }
+        else {
+            console.error(`错误: ${errorMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const editResult = result;
+    if (json) {
+        jsonOutput({
+            ok: editResult.ok,
+            command: 'edit-rem',
+            changes: editResult.changes,
+            warnings: editResult.warnings,
+            ...(editResult.error ? { error: editResult.error } : {}),
+            ...(editResult.appliedChanges ? { appliedChanges: editResult.appliedChanges } : {}),
+            ...(editResult.failedField ? { failedField: editResult.failedField } : {}),
+        });
+    }
+    else {
+        if (editResult.ok) {
+            if (editResult.changes.length === 0) {
+                console.log('无变更（old_str 和 new_str 产生相同结果）');
+            }
+            else {
+                console.log(`已更新字段: ${editResult.changes.join(', ')}`);
+            }
+        }
+        else {
+            console.error(`错误: ${editResult.error}`);
+            if (editResult.appliedChanges && editResult.appliedChanges.length > 0) {
+                console.error(`警告: 部分写入已生效: ${editResult.appliedChanges.join(', ')}`);
+                console.error('请重新 read-rem 获取当前状态');
+            }
+        }
+        for (const warning of editResult.warnings) {
+            console.warn(`警告: ${warning}`);
+        }
+    }
+    if (!editResult.ok) {
+        process.exitCode = 1;
+    }
+}

package/dist/cli/commands/edit-tree.d.ts

@@ -0,0 +1,14 @@
+/**
+ * edit-tree 命令
+ *
+ * 通过 str_replace 编辑 Rem 子树结构（行级增/删/移/重排）。
+ * - 禁止修改已有行内容（走 edit-rem）
+ * - --json 结构化 JSON 输出
+ * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
+ */
+export interface EditTreeOptions {
+    json?: boolean;
+    oldStr: string;
+    newStr: string;
+}
+export declare function editTreeCommand(remId: string, options: EditTreeOptions): Promise<void>;

package/dist/cli/commands/edit-tree.js

@@ -0,0 +1,67 @@
+/**
+ * edit-tree 命令
+ *
+ * 通过 str_replace 编辑 Rem 子树结构（行级增/删/移/重排）。
+ * - 禁止修改已有行内容（走 edit-rem）
+ * - --json 结构化 JSON 输出
+ * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
+ */
+import { sendDaemonRequest, DaemonNotRunningError, DaemonUnreachableError } from '../daemon/send-request.js';
+import { jsonOutput } from '../utils/output.js';
+export async function editTreeCommand(remId, options) {
+    const { json, oldStr, newStr } = options;
+    let result;
+    try {
+        result = await sendDaemonRequest('edit_tree', { remId, oldStr, newStr });
+    }
+    catch (err) {
+        if (err instanceof DaemonNotRunningError || err instanceof DaemonUnreachableError) {
+            if (json) {
+                jsonOutput({ ok: false, command: 'edit-tree', error: err.message });
+            }
+            else {
+                console.error(`错误: ${err.message}`);
+            }
+            process.exitCode = 2;
+            return;
+        }
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        if (json) {
+            jsonOutput({ ok: false, command: 'edit-tree', error: errorMsg });
+        }
+        else {
+            console.error(`错误: ${errorMsg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const data = result;
+    if (!data.ok) {
+        if (json) {
+            jsonOutput({ ok: false, command: 'edit-tree', error: data.error, ...data.details });
+        }
+        else {
+            console.error(`错误: ${data.error}`);
+            if (data.details) {
+                console.error(JSON.stringify(data.details, null, 2));
+            }
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (json) {
+        jsonOutput({ ok: true, command: 'edit-tree', operations: data.operations });
+    }
+    else {
+        if (data.operations.length === 0) {
+            console.log('无结构变更。');
+        }
+        else {
+            console.log(`执行了 ${data.operations.length} 个操作：`);
+            for (const op of data.operations) {
+                const o = op;
+                console.log(`  - ${o.type}: ${JSON.stringify(o)}`);
+            }
+        }
+    }
+}

package/dist/cli/commands/health.d.ts

@@ -0,0 +1,12 @@
+/**
+ * health 命令
+ *
+ * 检查守护进程、Plugin 连接、SDK 状态，输出 ✅/❌ 列表。
+ * - 全部健康 → 退出码 0
+ * - 部分不健康 → 退出码 1
+ * - 守护进程不可达 → 退出码 2
+ */
+export interface HealthOptions {
+    json?: boolean;
+}
+export declare function healthCommand(options?: HealthOptions): Promise<void>;

package/dist/cli/commands/health.js

@@ -0,0 +1,100 @@
+/**
+ * health 命令
+ *
+ * 检查守护进程、Plugin 连接、SDK 状态，输出 ✅/❌ 列表。
+ * - 全部健康 → 退出码 0
+ * - 部分不健康 → 退出码 1
+ * - 守护进程不可达 → 退出码 2
+ */
+import { findProjectRoot, pidFilePath } from '../config.js';
+import { checkDaemon } from '../daemon/pid.js';
+import { sendDaemonRequest } from '../daemon/send-request.js';
+import { jsonOutput } from '../utils/output.js';
+export async function healthCommand(options = {}) {
+    const { json } = options;
+    const projectRoot = findProjectRoot();
+    const pidPath = pidFilePath(projectRoot);
+    // 先检查 PID 文件
+    const daemonStatus = checkDaemon(pidPath);
+    if (!daemonStatus.running) {
+        if (json) {
+            jsonOutput({
+                ok: false, command: 'health', exitCode: 2,
+                daemon: { running: false },
+                plugin: { connected: false },
+                sdk: { ready: false },
+            });
+        }
+        else {
+            console.log('❌ 守护进程  未运行');
+            console.log('❌ Plugin    未连接');
+            console.log('❌ SDK       不可用');
+            console.log('\n提示: 执行 `remnote-bridge connect` 启动守护进程');
+        }
+        process.exitCode = 2;
+        return;
+    }
+    // 通过 WS 连接守护进程获取状态
+    let status;
+    try {
+        status = await sendDaemonRequest('get_status');
+    }
+    catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        if (json) {
+            jsonOutput({
+                ok: false, command: 'health', exitCode: 2,
+                daemon: { running: true, pid: daemonStatus.pid, reachable: false },
+                plugin: { connected: false },
+                sdk: { ready: false },
+                error: errorMsg,
+            });
+        }
+        else {
+            console.log('❌ 守护进程  不可达');
+            console.log('❌ Plugin    未连接');
+            console.log('❌ SDK       不可用');
+            console.log(`\n错误: ${errorMsg}`);
+        }
+        process.exitCode = 2;
+        return;
+    }
+    // 退出码
+    const allHealthy = status.pluginConnected && status.sdkReady;
+    const exitCode = allHealthy ? 0 : 1;
+    if (json) {
+        jsonOutput({
+            ok: allHealthy, command: 'health', exitCode,
+            daemon: { running: true, pid: daemonStatus.pid, reachable: true, uptime: status.uptime },
+            plugin: { connected: status.pluginConnected },
+            sdk: { ready: status.sdkReady },
+            timeoutRemaining: status.timeoutRemaining,
+        });
+    }
+    else {
+        console.log(`✅ 守护进程  运行中（PID: ${daemonStatus.pid}，已运行 ${formatUptime(status.uptime)}）`);
+        if (status.pluginConnected) {
+            console.log('✅ Plugin    已连接');
+        }
+        else {
+            console.log('❌ Plugin    未连接');
+        }
+        if (status.sdkReady) {
+            console.log('✅ SDK       就绪');
+        }
+        else {
+            console.log('❌ SDK       未就绪');
+        }
+        console.log(`\n超时: ${formatUptime(status.timeoutRemaining)} 后自动关闭`);
+    }
+    process.exitCode = exitCode;
+}
+function formatUptime(seconds) {
+    if (seconds < 60)
+        return `${seconds} 秒`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)} 分钟`;
+    const hours = Math.floor(seconds / 3600);
+    const mins = Math.floor((seconds % 3600) / 60);
+    return `${hours} 小时 ${mins} 分钟`;
+}

package/dist/cli/commands/install-skill.d.ts

@@ -0,0 +1,6 @@
+/**
+ * install skill 命令
+ *
+ * 将 SKILL.md 和 docs/instruction/*.md 安装到 ~/.claude/skills/remnote-bridge/
+ */
+export declare function installSkillCommand(): Promise<void>;

package/dist/cli/commands/install-skill.js

@@ -0,0 +1,39 @@
+/**
+ * install skill 命令
+ *
+ * 将 SKILL.md 和 docs/instruction/*.md 安装到 ~/.claude/skills/remnote-bridge/
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+export async function installSkillCommand() {
+    // 从包安装路径计算包根（dist/cli/commands/install-skill.js → 包根）
+    const packageRoot = path.resolve(import.meta.dirname, '..', '..', '..');
+    const skillSource = path.join(packageRoot, 'skill', 'SKILL.md');
+    const instructionDir = path.join(packageRoot, 'docs', 'instruction');
+    if (!fs.existsSync(skillSource)) {
+        console.error(`错误: 找不到 SKILL.md: ${skillSource}`);
+        process.exitCode = 1;
+        return;
+    }
+    // 目标目录
+    const targetDir = path.join(os.homedir(), '.claude', 'skills', 'remnote-bridge');
+    fs.mkdirSync(targetDir, { recursive: true });
+    // 复制 SKILL.md，更新 instruction 路径引用
+    let skillContent = fs.readFileSync(skillSource, 'utf-8');
+    const targetInstructionDir = path.join(targetDir, 'instruction');
+    // 替换相对路径 docs/instruction/ 为安装后的绝对路径
+    skillContent = skillContent.replace(/docs\/instruction\//g, targetInstructionDir + '/');
+    fs.writeFileSync(path.join(targetDir, 'SKILL.md'), skillContent, 'utf-8');
+    console.log(`  SKILL.md → ${targetDir}/SKILL.md`);
+    // 复制 docs/instruction/*.md
+    if (fs.existsSync(instructionDir)) {
+        fs.mkdirSync(targetInstructionDir, { recursive: true });
+        const files = fs.readdirSync(instructionDir).filter(f => f.endsWith('.md'));
+        for (const file of files) {
+            fs.copyFileSync(path.join(instructionDir, file), path.join(targetInstructionDir, file));
+            console.log(`  ${file} → ${targetInstructionDir}/${file}`);
+        }
+    }
+    console.log(`\nSkill 已安装到 ${targetDir}`);
+}

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

@@ -0,0 +1,20 @@
+/**
+ * read-context 命令
+ *
+ * 读取当前上下文视图。
+ * - --mode focus|page（默认 focus）
+ * - --ancestor-levels N 向上追溯几层祖先（默认 2，仅 focus 模式）
+ * - --depth N 展开深度（默认 3，仅 page 模式）
+ * - --max-nodes N 全局节点上限（默认 200）
+ * - --max-siblings N 每个父节点下展示的 children 上限（默认 20）
+ * - --json 结构化 JSON 输出
+ */
+export interface ReadContextOptions {
+    json?: boolean;
+    mode?: string;
+    ancestorLevels?: string;
+    depth?: string;
+    maxNodes?: string;
+    maxSiblings?: string;
+}
+export declare function readContextCommand(options?: ReadContextOptions): Promise<void>;