banyan-notes 0.0.0-stage → 0.1.0

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "banyan-notes",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Banyan (榕) — a local-first, plugin-based note-taking app for the web. Markdown folder is the only source of truth.",
+  "keywords": [
+    "notes",
+    "markdown",
+    "local-first",
+    "plugins",
+    "cordis",
+    "editor",
+    "knowledge-base"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "banyan": "bin/banyan.mjs"
+  },
+  "files": [
+    "dist/",
+    "client-dist/",
+    "plugins/",
+    "bin/"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/redjoker2025/Banyan.git"
+  },
+  "homepage": "https://github.com/redjoker2025/Banyan#readme",
+  "bugs": {
+    "url": "https://github.com/redjoker2025/Banyan/issues"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.8.1",
+    "ws": "^8.18.0"
+  }
 }

package/plugins/backlinks/client/index.js

@@ -0,0 +1,44 @@
+/**
+ * backlinks client entry — panel.right listing notes that link to the
+ * current note (Markdown links and [[wiki links]] resolved server-side).
+ */
+export function activate(host) {
+  host.registerPanel({
+    side: 'right',
+    title: '反向链接',
+    render(el, api) {
+      let disposed = false
+      const refresh = async () => {
+        if (disposed) return
+        if (!api.currentPath) {
+          el.innerHTML = '<div class="plugin-empty">未打开笔记</div>'
+          return
+        }
+        try {
+          const res = await api.apiFetch(`/api/graph/backlinks?path=${encodeURIComponent(api.currentPath)}`)
+          if (disposed) return
+          const paths = res.paths ?? []
+          el.innerHTML = ''
+          if (!paths.length) {
+            el.innerHTML = '<div class="plugin-empty">暂无反向链接<br /><span>用 [[笔记名]] 或 Markdown 链接引用本笔记</span></div>'
+            return
+          }
+          const list = document.createElement('div')
+          list.className = 'plugin-list'
+          for (const p of paths) {
+            const item = document.createElement('a')
+            item.className = 'plugin-item'
+            item.textContent = p
+            item.onclick = () => api.openNote(p)
+            list.appendChild(item)
+          }
+          el.appendChild(list)
+        } catch (e) {
+          el.innerHTML = `<div class="plugin-empty">加载失败：${e.message}</div>`
+        }
+      }
+      refresh()
+      return api.onNoteChange(refresh)
+    },
+  })
+}

package/plugins/backlinks/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@banyan/plugin-backlinks",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module"
+}

package/plugins/backlinks/plugin.json

@@ -0,0 +1,17 @@
+{
+  "id": "banyan.backlinks",
+  "name": "反向链接",
+  "version": "0.1.0",
+  "banyanApi": "^0.1",
+  "description": "在右侧面板显示当前笔记的反向链接（基于 ctx.graph 的链接图）",
+  "inject": [],
+  "provides": [],
+  "permissions": {
+    "fs": { "globs": [] },
+    "net": { "domains": [] },
+    "exec": false
+  },
+  "entry": {
+    "client": "./client/index.js"
+  }
+}

package/plugins/conflict-demo-a/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@banyan/plugin-conflict-demo-a",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module"
+}

package/plugins/conflict-demo-a/plugin.json

@@ -0,0 +1,17 @@
+{
+  "id": "banyan.demo.conflict-a",
+  "name": "冲突演示 A",
+  "version": "0.1.0",
+  "banyanApi": "^0.1",
+  "description": "演示插件：提供 demo.greeter。与冲突演示 B 同时启用会报 E_CONFLICT（默认禁用）",
+  "inject": ["logger"],
+  "provides": ["demo.greeter"],
+  "permissions": {
+    "fs": { "globs": [] },
+    "net": { "domains": [] },
+    "exec": false
+  },
+  "entry": {
+    "server": "./server/index.ts"
+  }
+}

package/plugins/conflict-demo-a/server/index.ts

@@ -0,0 +1,6 @@
+/** Conflict demo A — provides `demo.greeter`; must never be enabled together with conflict demo B (§4.5). */
+export default {
+  apply(ctx: any) {
+    ctx.logger.info('[conflict-a] demo plugin A is running, providing demo.greeter')
+  },
+}

package/plugins/conflict-demo-b/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@banyan/plugin-conflict-demo-b",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module"
+}

package/plugins/conflict-demo-b/plugin.json

@@ -0,0 +1,17 @@
+{
+  "id": "banyan.demo.conflict-b",
+  "name": "冲突演示 B",
+  "version": "0.1.0",
+  "banyanApi": "^0.1",
+  "description": "演示插件：同样提供 demo.greeter。与冲突演示 A 同时启用会报 E_CONFLICT（默认禁用）",
+  "inject": ["logger"],
+  "provides": ["demo.greeter"],
+  "permissions": {
+    "fs": { "globs": [] },
+    "net": { "domains": [] },
+    "exec": false
+  },
+  "entry": {
+    "server": "./server/index.ts"
+  }
+}

package/plugins/conflict-demo-b/server/index.ts

@@ -0,0 +1,6 @@
+/** Conflict demo B — also provides `demo.greeter`; clashes with demo A (§4.5). */
+export default {
+  apply(ctx: any) {
+    ctx.logger.info('[conflict-b] demo plugin B is running, providing demo.greeter')
+  },
+}

package/plugins/daily-note/client/index.js

@@ -0,0 +1,23 @@
+/**
+ * daily-note client entry — registers the command「打开/创建今日笔记」
+ * which opens (creating if needed) the `YYYY-MM-DD.md` note for today.
+ */
+export function activate(host) {
+  host.registerCommand({
+    id: 'banyan.daily-note.open',
+    title: '打开/创建今日笔记',
+    async run(api) {
+      const d = new Date()
+      const name = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}.md`
+      try {
+        await api.apiFetch('/api/note', {
+          method: 'POST',
+          json: { path: name, content: `# ${name.replace(/\.md$/, '')}\n\n` },
+        })
+      } catch (e) {
+        if (e.code !== 'E_CONFLICT') throw e // already exists → just open it
+      }
+      await api.openNote(name)
+    },
+  })
+}

package/plugins/daily-note/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@banyan/plugin-daily-note",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module"
+}

package/plugins/daily-note/plugin.json

@@ -0,0 +1,17 @@
+{
+  "id": "banyan.daily-note",
+  "name": "今日笔记",
+  "version": "0.1.0",
+  "banyanApi": "^0.1",
+  "description": "注册命令「打开/创建今日笔记」，对应 YYYY-MM-DD.md",
+  "inject": [],
+  "provides": [],
+  "permissions": {
+    "fs": { "globs": [] },
+    "net": { "domains": [] },
+    "exec": false
+  },
+  "entry": {
+    "client": "./client/index.js"
+  }
+}

package/plugins/net-violation-demo/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@banyan/plugin-net-violation-demo",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module"
+}

package/plugins/net-violation-demo/plugin.json

@@ -0,0 +1,17 @@
+{
+  "id": "banyan.demo.net-violation",
+  "name": "越权演示",
+  "version": "0.1.0",
+  "banyanApi": "^0.1",
+  "description": "演示插件：声明 net.domains=[example.com] 但启动时尝试访问 api.github.com → 被拦截并写入 audit.jsonl（默认禁用）",
+  "inject": ["net", "logger"],
+  "provides": [],
+  "permissions": {
+    "fs": { "globs": [] },
+    "net": { "domains": ["example.com"] },
+    "exec": false
+  },
+  "entry": {
+    "server": "./server/index.ts"
+  }
+}

package/plugins/net-violation-demo/server/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Net violation demo — declares `net.domains: [example.com]` but attempts to
+ * reach api.github.com at startup. The permission proxy denies the call
+ * BEFORE any network I/O and appends an entry to `audit.jsonl` (§4.5).
+ */
+export default {
+  inject: ['net', 'logger'],
+
+  async apply(ctx: any) {
+    try {
+      await ctx.net.fetch('https://api.github.com/repos/deepseek-ai/deepseek-harness')
+      ctx.logger.warn('[net-violation] call unexpectedly allowed — permission proxy is missing!')
+    } catch (e) {
+      ctx.logger.warn(`[net-violation] blocked as expected: ${e.message}`)
+    }
+  },
+}

package/plugins/tags/client/index.js

@@ -0,0 +1,64 @@
+/**
+ * tags client entry — panel.right aggregating the frontmatter `tags` field
+ * across all notes; clicking a tag filters and lists the matching notes.
+ */
+export function activate(host) {
+  host.registerPanel({
+    side: 'right',
+    title: '标签',
+    render(el, api) {
+      let disposed = false
+      let selected = null
+      const refresh = async () => {
+        if (disposed) return
+        try {
+          const res = await api.apiFetch('/api/tags')
+          if (disposed) return
+          const notes = res.notes ?? []
+          const counts = new Map()
+          for (const n of notes) {
+            for (const t of n.tags) counts.set(t, (counts.get(t) ?? 0) + 1)
+          }
+          el.innerHTML = ''
+          const tagList = document.createElement('div')
+          tagList.className = 'plugin-list'
+          if (counts.size === 0) {
+            tagList.innerHTML = '<div class="plugin-empty">暂无标签<br /><span>在笔记 frontmatter 中添加 tags 字段</span></div>'
+          }
+          for (const [tag, count] of [...counts.entries()].sort((a, b) => b[1] - a[1])) {
+            const item = document.createElement('a')
+            item.className = 'plugin-item' + (selected === tag ? ' active' : '')
+            item.textContent = `#${tag}（${count}）`
+            item.onclick = () => {
+              selected = selected === tag ? null : tag
+              refresh()
+            }
+            tagList.appendChild(item)
+          }
+          el.appendChild(tagList)
+
+          if (selected) {
+            const list = document.createElement('div')
+            list.className = 'plugin-list'
+            const head = document.createElement('div')
+            head.className = 'plugin-heading'
+            head.textContent = `包含 #${selected} 的笔记`
+            list.appendChild(head)
+            for (const n of notes.filter((n) => n.tags.includes(selected))) {
+              const item = document.createElement('a')
+              item.className = 'plugin-item'
+              item.textContent = n.path
+              item.onclick = () => api.openNote(n.path)
+              list.appendChild(item)
+            }
+            el.appendChild(list)
+          }
+        } catch (e) {
+          el.innerHTML = `<div class="plugin-empty">加载失败：${e.message}</div>`
+        }
+      }
+      refresh()
+      return api.onNoteChange(refresh)
+    },
+  })
+}

package/plugins/tags/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@banyan/plugin-tags",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module"
+}

package/plugins/tags/plugin.json

@@ -0,0 +1,17 @@
+{
+  "id": "banyan.tags",
+  "name": "标签聚合",
+  "version": "0.1.0",
+  "banyanApi": "^0.1",
+  "description": "聚合全部笔记 frontmatter 的 tags 字段，点击标签可过滤笔记",
+  "inject": [],
+  "provides": [],
+  "permissions": {
+    "fs": { "globs": [] },
+    "net": { "domains": [] },
+    "exec": false
+  },
+  "entry": {
+    "client": "./client/index.js"
+  }
+}

package/plugins/word-count/client/index.js

@@ -0,0 +1,13 @@
+/**
+ * word-count client entry — statusbar item showing the word count of the
+ * current note, published by the server half via `plugin.state`.
+ */
+export function activate(host) {
+  host.registerStatusbar((api) => {
+    if (!api.currentPath) return ''
+    const counts = api.pluginState['banyan.word-count'] ?? {}
+    const count = counts[api.currentPath]
+    if (count === undefined) return ''
+    return `${count} 词`
+  })
+}

package/plugins/word-count/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@banyan/plugin-word-count",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module"
+}

package/plugins/word-count/plugin.json

@@ -0,0 +1,18 @@
+{
+  "id": "banyan.word-count",
+  "name": "字数统计",
+  "version": "0.1.0",
+  "banyanApi": "^0.1",
+  "description": "保存时经 pipeline/save 瀑布链统计字数，在状态栏显示当前笔记字数",
+  "inject": ["pipeline", "broadcast", "logger"],
+  "provides": [],
+  "permissions": {
+    "fs": { "globs": [] },
+    "net": { "domains": [] },
+    "exec": false
+  },
+  "entry": {
+    "server": "./server/index.ts",
+    "client": "./client/index.js"
+  }
+}

package/plugins/word-count/server/index.ts

@@ -0,0 +1,31 @@
+/**
+ * word-count server entry — demonstrates the `pipeline/save` waterfall:
+ * the listener delegates downstream with `next()` first, then counts the
+ * words of the final content and publishes it as `plugin.state`.
+ */
+interface SaveMeta {
+  path: string
+}
+
+export default {
+  inject: ['pipeline', 'broadcast', 'logger'],
+
+  apply(ctx: any) {
+    ctx.on('pipeline/save', async (content: string, meta: SaveMeta, next: () => Promise<string>) => {
+      const result = await next() // delegate to downstream listeners first (onion order)
+      const count = countWords(result)
+      ctx.broadcast({
+        type: 'plugin.state',
+        payload: { plugin: 'banyan.word-count', counts: { [meta.path]: count } },
+      })
+      ctx.logger.info(`[word-count] ${meta.path}: ${count} words`)
+      return result
+    })
+  },
+}
+
+function countWords(content: string): number {
+  const cjk = (content.match(/[\u4e00-\u9fff]/g) ?? []).length
+  const latin = (content.match(/[A-Za-z0-9]+(?:['’-][A-Za-z0-9]+)*/g) ?? []).length
+  return cjk + latin
+}