gudong-inbox-cli 1.0.0

package/dist/note/service.test.js

@@ -0,0 +1,274 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { NoteService, ConflictError, extractTagsFromContent } from './service.js';
+const VALID_ID = 'b10a4576df11401c8673';
+function makeNoteJson(id, overrides = {}) {
+    return Buffer.from(JSON.stringify({
+        id,
+        ver: 1,
+        meta: {
+            created_at: '2026-06-01T00:00:00.000Z',
+            updated_at: overrides.updated_at ?? '2026-06-02T00:00:00.000Z',
+            device_id: 'test',
+        },
+        content: {
+            content: overrides.content ?? 'hello world',
+            title: overrides.title ?? null,
+            tags: overrides.tags ?? [],
+            links: [],
+            assets: [],
+        },
+        flags: {
+            is_removed: overrides.is_removed ?? false,
+            is_top: false,
+            favorite: false,
+        },
+        parent_id: overrides.parent_id ?? null,
+    }));
+}
+function makeNoteFile(id) {
+    return { id, key: `inBox/notes/note-${id}.json` };
+}
+/**
+ * In-memory mock cloud provider for testing.
+ * Stores notes in a Map and simulates read/write/list operations.
+ */
+class MockCloud {
+    type = 's3';
+    store = new Map();
+    constructor(notes = []) {
+        for (const n of notes) {
+            this.store.set(`inBox/notes/note-${n.id}.json`, n.data);
+        }
+    }
+    async listNotes(notesDir) {
+        const prefix = `${notesDir}/`;
+        const out = [];
+        for (const key of this.store.keys()) {
+            if (!key.startsWith(prefix))
+                continue;
+            const m = key.match(/note-([a-f0-9]{20})\.json$/);
+            if (m)
+                out.push({ id: m[1], key });
+        }
+        return out;
+    }
+    async readNote(key) {
+        const buf = this.store.get(key);
+        if (!buf)
+            throw new Error(`not found: ${key}`);
+        return buf;
+    }
+    async writeNote(key, data) {
+        this.store.set(key, data);
+    }
+}
+describe('extractTagsFromContent', () => {
+    it('extracts simple tags', () => {
+        expect(extractTagsFromContent('hello #idea world')).toEqual(['idea']);
+    });
+    it('extracts hierarchical tags', () => {
+        expect(extractTagsFromContent('#work/project/alpha')).toEqual([
+            'work/project/alpha',
+        ]);
+    });
+    it('extracts Chinese tags', () => {
+        expect(extractTagsFromContent('#标签 测试')).toEqual(['标签']);
+    });
+    it('deduplicates tags', () => {
+        expect(extractTagsFromContent('#idea #idea #work')).toEqual(['idea', 'work']);
+    });
+    it('does not match email @ or plain hash', () => {
+        expect(extractTagsFromContent('test@example.com #')).toEqual([]);
+    });
+});
+describe('NoteService', () => {
+    let cloud;
+    let svc;
+    beforeEach(() => {
+        cloud = new MockCloud([
+            { id: VALID_ID, data: makeNoteJson(VALID_ID, { tags: ['old'] }) },
+        ]);
+        svc = new NoteService(cloud, 'inBox/notes', { cacheTtlMs: 0 });
+    });
+    describe('listRecent', () => {
+        it('returns non-removed notes sorted by updated_at desc', async () => {
+            cloud = new MockCloud([
+                {
+                    id: 'a'.repeat(20),
+                    data: makeNoteJson('a'.repeat(20), { updated_at: '2026-06-01T00:00:00.000Z' }),
+                },
+                {
+                    id: 'b'.repeat(20),
+                    data: makeNoteJson('b'.repeat(20), { updated_at: '2026-06-03T00:00:00.000Z' }),
+                },
+                {
+                    id: 'c'.repeat(20),
+                    data: makeNoteJson('c'.repeat(20), { updated_at: '2026-06-02T00:00:00.000Z' }),
+                },
+            ]);
+            svc = new NoteService(cloud, 'inBox/notes', { cacheTtlMs: 0 });
+            const notes = await svc.listRecent({ limit: 10 });
+            expect(notes).toHaveLength(3);
+            expect(notes[0].id).toBe('b'.repeat(20));
+            expect(notes[1].id).toBe('c'.repeat(20));
+            expect(notes[2].id).toBe('a'.repeat(20));
+        });
+        it('excludes removed notes', async () => {
+            cloud = new MockCloud([
+                { id: 'a'.repeat(20), data: makeNoteJson('a'.repeat(20), { is_removed: false }) },
+                { id: 'b'.repeat(20), data: makeNoteJson('b'.repeat(20), { is_removed: true }) },
+            ]);
+            svc = new NoteService(cloud, 'inBox/notes', { cacheTtlMs: 0 });
+            const notes = await svc.listRecent({});
+            expect(notes).toHaveLength(1);
+            expect(notes[0].id).toBe('a'.repeat(20));
+        });
+    });
+    describe('search', () => {
+        it('matches in content', async () => {
+            cloud = new MockCloud([
+                { id: 'a'.repeat(20), data: makeNoteJson('a'.repeat(20), { content: 'Flutter tips' }) },
+                { id: 'b'.repeat(20), data: makeNoteJson('b'.repeat(20), { content: 'nothing here' }) },
+            ]);
+            svc = new NoteService(cloud, 'inBox/notes', { cacheTtlMs: 0 });
+            const notes = await svc.search('flutter');
+            expect(notes).toHaveLength(1);
+            expect(notes[0].id).toBe('a'.repeat(20));
+        });
+    });
+    describe('listTags', () => {
+        it('counts tags across all non-removed notes', async () => {
+            cloud = new MockCloud([
+                { id: 'a'.repeat(20), data: makeNoteJson('a'.repeat(20), { tags: ['work', 'idea'] }) },
+                { id: 'b'.repeat(20), data: makeNoteJson('b'.repeat(20), { tags: ['idea', 'work'] }) },
+                { id: 'c'.repeat(20), data: makeNoteJson('c'.repeat(20), { tags: ['idea'], is_removed: true }) },
+            ]);
+            svc = new NoteService(cloud, 'inBox/notes', { cacheTtlMs: 0 });
+            const tags = await svc.listTags();
+            const tagMap = new Map(tags.map((t) => [t.tag, t.count]));
+            expect(tagMap.get('idea')).toBe(2); // c is removed
+            expect(tagMap.get('work')).toBe(2);
+        });
+    });
+    describe('createNote', () => {
+        it('creates a note with merged tags from content', async () => {
+            const result = await svc.createNote({
+                content: 'hello #flutter world',
+                tags: ['explicit'],
+            });
+            // Read it back
+            const note = await svc.readById(result.id);
+            expect(note).not.toBeNull();
+            expect(note.tags).toContain('explicit');
+            expect(note.tags).toContain('flutter');
+        });
+        it('generates a 20-hex-char id', async () => {
+            const result = await svc.createNote({ content: 'test' });
+            expect(result.id).toMatch(/^[a-f0-9]{20}$/);
+        });
+    });
+    describe('updateNote', () => {
+        it('updates content and preserves existing tags when --tag not given', async () => {
+            await svc.updateNote({
+                id: VALID_ID,
+                content: 'updated #newtag content',
+            });
+            const note = await svc.readById(VALID_ID);
+            expect(note.content).toBe('updated #newtag content');
+            // Without explicit --tag, existing tags are preserved (#newtag is NOT auto-added)
+            expect(note.tags).toEqual(['old']);
+        });
+        it('merges explicit tags with content-extracted tags when --tag given', async () => {
+            await svc.updateNote({
+                id: VALID_ID,
+                content: 'updated #newtag content',
+                tags: ['explicit'],
+            });
+            const note = await svc.readById(VALID_ID);
+            expect(note.tags).toContain('explicit');
+            expect(note.tags).toContain('newtag');
+        });
+        it('preserves fields that are not provided', async () => {
+            await svc.updateNote({ id: VALID_ID, title: 'New Title' });
+            const note = await svc.readById(VALID_ID);
+            expect(note.title).toBe('New Title');
+            expect(note.content).toBe('hello world');
+        });
+        it('throws ConflictError when remote is newer', async () => {
+            // Use a service with cache enabled, so fetchAll returns the old cached version.
+            // We then modify the cloud store behind its back to simulate a remote write.
+            const cachedSvc = new NoteService(cloud, 'inBox/notes', { cacheTtlMs: 60_000 });
+            await cachedSvc.fetchAll(); // prime cache with old data
+            const newerJson = makeNoteJson(VALID_ID, {
+                updated_at: '2026-06-10T00:00:00.000Z',
+                content: 'remote change',
+            });
+            cloud.store.set(`inBox/notes/note-${VALID_ID}.json`, newerJson);
+            await expect(cachedSvc.updateNote({ id: VALID_ID, content: 'local change' })).rejects.toThrow(ConflictError);
+        });
+        it('succeeds when remote is same or older', async () => {
+            // Remote updated_at is same as cached — should be fine
+            await svc.updateNote({ id: VALID_ID, content: 'safe update' });
+            const note = await svc.readById(VALID_ID);
+            expect(note.content).toBe('safe update');
+        });
+    });
+    describe('deleteNote', () => {
+        it('soft-deletes without clearing content', async () => {
+            await svc.deleteNote(VALID_ID);
+            const note = await svc.readById(VALID_ID);
+            expect(note.is_removed).toBe(true);
+            expect(note.content).toBe('hello world'); // content preserved
+        });
+        it('is idempotent for already-removed notes', async () => {
+            await svc.deleteNote(VALID_ID);
+            const result = await svc.deleteNote(VALID_ID);
+            expect(result.deleted).toBe(false);
+        });
+        it('throws ConflictError when remote is newer', async () => {
+            const cachedSvc2 = new NoteService(cloud, 'inBox/notes', { cacheTtlMs: 60_000 });
+            await cachedSvc2.fetchAll(); // prime cache with old data
+            cloud.store.set(`inBox/notes/note-${VALID_ID}.json`, makeNoteJson(VALID_ID, {
+                updated_at: '2026-06-10T00:00:00.000Z',
+                content: 'remote change',
+            }));
+            await expect(cachedSvc2.deleteNote(VALID_ID)).rejects.toThrow(ConflictError);
+        });
+    });
+    describe('cache stays sorted after writes', () => {
+        it('createNote puts the new note at the front of cache', async () => {
+            const cachedSvc = new NoteService(cloud, 'inBox/notes', { cacheTtlMs: 60_000 });
+            await cachedSvc.fetchAll();
+            const result = await cachedSvc.createNote({ content: 'fresh note' });
+            // listRecent with limit 1 must return the freshly created note
+            const recent = await cachedSvc.listRecent({ limit: 1 });
+            expect(recent).toHaveLength(1);
+            expect(recent[0].id).toBe(result.id);
+        });
+        it('updateNote moves the updated note to the front of cache', async () => {
+            cloud = new MockCloud([
+                { id: 'a'.repeat(20), data: makeNoteJson('a'.repeat(20), { updated_at: '2026-06-01T00:00:00.000Z' }) },
+                { id: 'b'.repeat(20), data: makeNoteJson('b'.repeat(20), { updated_at: '2026-06-03T00:00:00.000Z' }) },
+            ]);
+            const cachedSvc = new NoteService(cloud, 'inBox/notes', { cacheTtlMs: 60_000 });
+            await cachedSvc.fetchAll();
+            await cachedSvc.updateNote({ id: 'a'.repeat(20), content: 'updated' });
+            const recent = await cachedSvc.listRecent({ limit: 1 });
+            expect(recent[0].id).toBe('a'.repeat(20));
+        });
+        it('deleteNote moves the soft-deleted note to the front of cache', async () => {
+            cloud = new MockCloud([
+                { id: 'a'.repeat(20), data: makeNoteJson('a'.repeat(20), { updated_at: '2026-06-01T00:00:00.000Z' }) },
+                { id: 'b'.repeat(20), data: makeNoteJson('b'.repeat(20), { updated_at: '2026-06-03T00:00:00.000Z' }) },
+            ]);
+            const cachedSvc = new NoteService(cloud, 'inBox/notes', { cacheTtlMs: 60_000 });
+            await cachedSvc.fetchAll();
+            await cachedSvc.deleteNote('a'.repeat(20));
+            // Soft-deleted note is at front of cache array
+            const allCached = await cachedSvc.fetchAll();
+            expect(allCached[0].id).toBe('a'.repeat(20));
+            expect(allCached[0].flags.is_removed).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=service.test.js.map

package/dist/note/service.test.js.map

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

package/dist/note/types.d.ts

@@ -0,0 +1,72 @@
+export type AssetType = 'image' | 'video' | 'audio' | 'attachment';
+export type AssetStorageType = 'local' | 'webdav' | 's3' | 'minio' | 'aliyun' | 'tencent' | 'generic';
+export interface NoteLink {
+    text?: string | null;
+    targetId: string;
+}
+export interface NoteAsset {
+    type: AssetType;
+    path: string;
+    storageType: AssetStorageType;
+    cloudUrl?: string | null;
+    mime_type: string;
+    size: number;
+    width?: number | null;
+    height?: number | null;
+    duration?: number | null;
+}
+export interface NoteMeta {
+    created_at: string;
+    updated_at: string;
+    device_id: string;
+}
+export interface NoteContent {
+    content: string;
+    title?: string | null;
+    tags: string[];
+    links: NoteLink[];
+    assets: NoteAsset[];
+    box?: string | null;
+}
+export interface NoteFlags {
+    is_removed: boolean;
+    is_top: boolean;
+    favorite: boolean;
+}
+export interface NoteJson {
+    id: string;
+    ver: number;
+    meta: NoteMeta;
+    content: NoteContent;
+    flags: NoteFlags;
+    parent_id?: string | null;
+}
+/** Format a UTC ISO string into a human-readable local time (Asia/Shanghai, UTC+8). */
+export declare function toLocalTime(iso: string | null | undefined): string | null;
+export interface NoteSummary {
+    id: string;
+    title: string | null;
+    updated_at: string;
+    updated_at_local: string | null;
+    tags: string[];
+    content_preview: string;
+}
+export interface NoteDetail {
+    id: string;
+    title: string | null;
+    content: string;
+    tags: string[];
+    links: NoteLink[];
+    assets: Array<Pick<NoteAsset, 'type' | 'path' | 'size' | 'mime_type' | 'cloudUrl' | 'storageType'>>;
+    created_at: string;
+    updated_at: string;
+    created_at_local: string | null;
+    updated_at_local: string | null;
+    is_top: boolean;
+    favorite: boolean;
+    is_removed: boolean;
+}
+export interface TagCount {
+    tag: string;
+    count: number;
+}

package/dist/note/types.js

@@ -0,0 +1,16 @@
+/** Format a UTC ISO string into a human-readable local time (Asia/Shanghai, UTC+8). */
+export function toLocalTime(iso) {
+    if (!iso)
+        return null;
+    const ms = Date.parse(iso);
+    if (!Number.isFinite(ms))
+        return null;
+    const dt = new Date(ms + 8 * 3600 * 1000); // shift to UTC+8
+    const y = dt.getUTCFullYear();
+    const m = String(dt.getUTCMonth() + 1).padStart(2, '0');
+    const d = String(dt.getUTCDate()).padStart(2, '0');
+    const h = String(dt.getUTCHours()).padStart(2, '0');
+    const min = String(dt.getUTCMinutes()).padStart(2, '0');
+    return `${y}-${m}-${d} ${h}:${min}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/note/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/note/types.ts"],"names":[],"mappings":"AAyDA,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,GAA8B;IACxD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,iBAAiB;IAC5D,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;IAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "gudong-inbox-cli",
+  "version": "1.0.0",
+  "description": "CLI tool that lets AI agents read and write your inBox notes from S3/WebDAV. No MCP needed, just a command.",
+  "type": "module",
+  "bin": {
+    "gudong-inbox": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "skill"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "inbox",
+    "notes",
+    "cli",
+    "s3",
+    "webdav",
+    "local-first",
+    "ai",
+    "agent"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.700.0",
+    "webdav": "^5.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "prettier": "^3.3.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: gudong-inbox
+description: 读取和管理 inBox 笔记。当用户问笔记、记录、灵感、知识库相关问题时使用此 skill。如"看看笔记""今天记了什么""搜索关于XX的笔记"等。
+version: 1.0.0
+---
+
+# inBox 笔记读取器
+
+通过 `gudong-inbox` 命令行工具读取和管理用户的 inBox 笔记（本地优先笔记 App，通过 S3/WebDAV 云存储同步）。
+
+## 前置检查
+
+首次使用前，先检查 CLI 是否安装、配置是否就绪：
+
+```bash
+gudong-inbox --version          # 确认 CLI 已安装
+gudong-inbox config show        # 查看当前配置（密钥已脱敏）
+```
+
+如果提示命令找不到或配置不存在，走「安装和配置」流程。
+
+## 命令清单
+
+| 操作 | 命令 | 用途 |
+------|------|------|
+| 列出笔记 | `gudong-inbox list` | 按时间列出笔记摘要，支持过滤 |
+| 读取笔记 | `gudong-inbox read --id <id>` | 读取单条笔记完整内容 |
+| 搜索笔记 | `gudong-inbox search --query "关键词"` | 在标题、正文、标签中搜索 |
+| 查看标签 | `gudong-inbox tags` | 列出所有标签及使用次数 |
+| 创建笔记 | `gudong-inbox create --content "内容"` | 写入新笔记到用户的 inBox |
+| 更新笔记 | `gudong-inbox update --id <id>` | 部分更新已有笔记 |
+| 删除笔记 | `gudong-inbox delete --id <id> --confirm` | 软删除笔记（需确认） |
+| 查看配置 | `gudong-inbox config show` | 查看当前配置（密钥已脱敏） |
+| 测试连接 | `gudong-inbox config test` | 测试云存储连接是否正常 |
+
+## 参数速查
+
+### list
+`--limit`（默认 20）、`--since`（ISO-8601）、`--until`（ISO-8601）、`--field`（`updated_at` 或 `created_at`，默认 `updated_at`）
+
+**查今天创建的笔记**：
+```bash
+gudong-inbox list --since 2026-06-25T00:00:00+08:00 --field created_at
+```
+
+### read
+`--id`（必填，20 位 hex 格式）
+
+从 `list` 或 `search` 结果中拿到 `id` 字段后使用。
+
+### search
+`--query`（必填）、`--limit`（默认 20）
+
+### create
+`--content`（必填）、`--title`（可选）、`--tag`（可重复）、`--box`（可选）
+
+### update
+`--id`（必填）、`--content`、`--title`、`--tag`、`--box`（只改传入的字段）
+
+### delete
+`--id`（必填）、`--confirm`（必填，必须显式传 true）
+
+## 使用建议
+
+1. **先 list 再 read**：`list` 返回摘要（含 200 字预览），需要看全文再用 `read`。
+2. **时间过滤**：用户说"今天"时，用上海时区 0 点作为 `--since`。注意 ISO-8601 要带时区偏移（`+08:00`）。
+3. **搜索比 list 灵活**：不确定日期时，直接用 `search` 按关键词找。
+4. **所有命令输出都是 JSON**：直接解析 stdout 的 JSON 即可。
+
+## 输出格式
+
+所有命令成功时 exit code = 0，stdout 输出 JSON。失败时 exit code = 1，stderr 输出错误信息。
+
+## 安装和配置
+
+如果 `gudong-inbox` 未安装或未配置：
+
+```bash
+# 安装 CLI
+npm install -g gudong-inbox-cli
+
+# 配置（S3 示例）
+gudong-inbox config init \
+  --cloud-type s3 \
+  --endpoint https://s3.example.com \
+  --bucket my-bucket \
+  --access-key AKID... \
+  --secret-key SECRET... \
+  --region cn-south-1 \
+  --work-dir inBox
+
+# 验证
+gudong-inbox config test
+```
+
+配置保存在 `~/.gudong-inbox/config.json`，也支持环境变量（`CLOUD_TYPE`、`S3_ENDPOINT` 等）作为 fallback。
+
+## 创建笔记的两阶段确认
+
+创建、更新、删除笔记属于写操作。虽然 CLI 本身不需要 confirmation token，但建议在 AI 对话中遵循两阶段确认：
+
+1. 先向用户展示要写入的内容摘要
+2. 用户确认后再执行命令