dsh-tiddlywiki 0.7.3 → 0.8.0

package/src/host/config.ts

@@ -16,6 +16,12 @@ import type { TiddlyWebClient } from './tw-api.ts'
 /** Config tiddler (JSON string) where the settings page stores overrides. */
 export const CONFIG_TIDDLER = '$:/plugins/dsh-tiddlywiki/config'
 
+/**
+ * Default dark palette the embedded TW switches to when DSH is dark
+ * (mirrored in src/client/theme-sync.ts — the two bundles cannot share code).
+ */
+export const DARK_PALETTE_DEFAULT = '$:/palettes/CupertinoDark'
+
 /** Extensible, loose plugin config shape (future fields just appear here). */
 export interface PluginConfigShape {
   note?: { tag?: string }
@@ -27,6 +33,14 @@ export interface PluginConfigShape {
     showPanelStatus?: boolean
     /** 是否在界面右下角显示「同步」悬浮按钮（默认 true）。 */
     showSyncButton?: boolean
+    /**
+     * 嵌入式 TW 是否跟随 DSH 深浅主题（默认 true）：DSH 暗色时把 TW 活动
+     * palette 临时切到 `darkPalette`，浅色时恢复用户原 palette；仅内存生效，
+     * 不会写回 wiki。
+     */
+    followDshTheme?: boolean
+    /** DSH 暗色时 TW 使用的 palette tiddler 标题（默认 CupertinoDark）。 */
+    darkPalette?: string
     /**
      * 一键发送给 Agent（TW 笔记 → DSH 会话注入）。
      * `enabled: false` 时路由 403、TW 端按钮点击提示未启用；`token` 非空时

package/src/host/routes.ts

@@ -73,11 +73,25 @@ export interface SessionControllerFace {
   create(request: { cwd?: string; workspaceId?: string }): Promise<{ sessionId: string }>
 }
 
-/** Effective UI visibility flags returned by /status (mirror index.ts). */
+/**
+ * Structural face over the DSH `workspaceRegistry` service (a subset of
+ * dsh-workspace). Only what the agent-create route needs is declared; the
+ * runtime instance is a real Service, never inspected data.
+ */
+export interface WorkspaceRegistryFace {
+  /** Resolve or create the workspace owning `path` — idempotent by canonical path. */
+  create(path: string, title?: string): Promise<{ id: string; path: string }>
+}
+
+/** Effective UI flags returned by /status (mirror index.ts). */
 export interface UiDefaultsPublic {
   showQuickNote: boolean
   showPanelStatus: boolean
   showSyncButton: boolean
+  /** 嵌入式 TW 是否跟随 DSH 深浅主题（false 时客户端停止 palette 同步）。 */
+  followDshTheme: boolean
+  /** DSH 暗色时 TW 使用的 palette tiddler 标题。 */
+  darkPalette: string
 }
 
 export interface RouteDeps {
@@ -91,6 +105,10 @@ export interface RouteDeps {
   /** Optional DSH sessionController service (agent-send routes only); resolved
    *  lazily per request because it may register after webServer appears. */
   getSessionController: () => SessionControllerFace | undefined
+  /** Optional DSH workspaceRegistry service (agent-create route); resolves a
+   *  cwd to a real Workspace so new sessions land inside it instead of the
+   *  ungrouped bucket. */
+  getWorkspaceRegistry: () => WorkspaceRegistryFace | undefined
   /** Whether the one-click send-to-agent feature is enabled (config switch). */
   sendToAgentEnabled: () => boolean
   /** Optional shared token that must match `x-send-to-agent-token` when set. */
@@ -334,10 +352,14 @@ export function registerRoutes(ctx: { webServer: WebServerFace }, deps: RouteDep
   }
 
   /**
-   * POST /dsh-tiddlywiki/agent/create — create (or adopt) one ordinary session,
-   * optionally inside a workspace path. The picker uses it for "new workspace /
-   * new session"; the created session's cwd becomes its workspace. The directory
-   * is materialised so a brand-new workspace actually exists on disk.
+   * POST /dsh-tiddlywiki/agent/create — create (or adopt) one ordinary session
+   * inside a real DSH workspace resolved from the requested path. The picker
+   * uses it for "new workspace / new session": the directory is materialised so
+   * a brand-new workspace actually exists on disk, the path is resolved to its
+   * (idempotent) Workspace, and the session is created with `workspaceId` so it
+   * lands under that workspace in the sidebar. Creating with bare `cwd` instead
+   * would leave the session in the ungrouped bucket even when its working
+   * directory matches an existing workspace path.
    */
   const handleAgentCreate = async (req: IncomingMessage, res: ServerResponse): Promise<void> => {
     try {
@@ -361,10 +383,18 @@ export function registerRoutes(ctx: { webServer: WebServerFace }, deps: RouteDep
         json(res, { ok: false, error: 'session service unavailable' }, 503)
         return
       }
+      const ws = deps.getWorkspaceRegistry()
       if (cwd.length > 0) {
         await mkdir(cwd, { recursive: true })
       }
-      const created = await sc.create({ cwd: cwd.length > 0 ? cwd : undefined })
+      let created: { sessionId: string }
+      if (cwd.length > 0 && ws !== undefined) {
+        const workspace = await ws.create(cwd)
+        created = await sc.create({ workspaceId: workspace.id })
+        json(res, { ok: true, sessionId: created.sessionId, cwd, workspaceId: workspace.id })
+        return
+      }
+      created = await sc.create({ cwd: cwd.length > 0 ? cwd : undefined })
       json(res, { ok: true, sessionId: created.sessionId, cwd: cwd || null })
     } catch (err) {
       json(res, { ok: false, error: err instanceof Error ? err.message : String(err) }, 500)

package/src/host/tools.ts

@@ -18,6 +18,19 @@ import { defineTool } from '../sdk.ts'
 import type { TiddlyWebClient, Tiddler } from './tw-api.ts'
 import type { GitFace } from './git.ts'
 
+/**
+ * 约定标签：标记「由 Agent 撰写」的笔记。
+ * 新建（title 不存在）时由 tiddlywiki_put / tiddlywiki_batch_put 自动补打；
+ * 首页据此把这类笔记单独列在「Agent 区块」并从主标签列表排除。
+ */
+export const AGENT_WRITTEN_TAG = 'agent-written'
+
+/**
+ * 约定标签：标记「Agent 撰写后又经人类编辑」的笔记（双标签分级第二档）。
+ * 人类在编辑某篇 Agent 笔记时手动补打，首页把这类笔记归入「Agent + 人工」档。
+ */
+export const HUMAN_EDITED_TAG = 'human-edited'
+
 /** Structural tool-registry face (subset of the dsh tools service). */
 export interface ToolsCtx {
   tools: { register(tool: unknown): () => void }
@@ -83,6 +96,21 @@ function rewriteRefs(text: string, oldTitle: string, newTitle: string): { text:
   return { text: out, count }
 }
 
+/**
+ * Compute the final tags for a write:
+ * - NEW tiddler (created by this tool) → auto-append the agent-written tag,
+ *   unless it is a `$:/` system tiddler (config/language/theme internals).
+ * - Existing tiddler → keep the caller's tags as-is (an agent maintaining a
+ *   human note must NOT silently claim authorship; an already agent-written
+ *   note keeps its tag because the caller provides the full tag list).
+ */
+function finalTagsForWrite(title: string, existing: Tiddler | undefined, tags: string[]): string[] {
+  if (existing !== undefined) return tags
+  if (title.startsWith('$:/')) return tags
+  if (tags.includes(AGENT_WRITTEN_TAG)) return tags
+  return [...tags, AGENT_WRITTEN_TAG]
+}
+
 export function registerTiddlywikiTools(ctx: ToolsCtx, deps: ToolsDeps): Array<() => void> {
   const disposers: Array<() => void> = []
   const register = (tool: unknown): void => { disposers.push(ctx.tools.register(tool)) }
@@ -227,7 +255,7 @@ export function registerTiddlywikiTools(ctx: ToolsCtx, deps: ToolsDeps): Array<(
   // ── tiddlywiki_put ───────────────────────────────────────────────────────
   register(defineTool({
     name: 'tiddlywiki_put',
-    description: '写入（新建或覆盖）一个 TiddlyWiki tiddler。同名覆盖；tags 为标签数组，fields 为附加自定义字段（json 对象，会写入 tiddler 字段）。写入后触发自动 commit。',
+    description: '写入（新建或覆盖）一个 TiddlyWiki tiddler。同名覆盖；tags 为标签数组，fields 为附加自定义字段（json 对象，会写入 tiddler 字段）。写入后触发自动 commit。新建（title 不存在）时自动补打 agent-written 标签标记「由 Agent 撰写」，无需手动添加。',
     parameters: {
       title: { type: 'string', description: 'tiddler 标题（精确匹配，覆盖同名）', required: true },
       text: { type: 'string', description: 'tiddler 全文（wiki 文本）', required: true },
@@ -249,19 +277,21 @@ export function registerTiddlywikiTools(ctx: ToolsCtx, deps: ToolsDeps): Array<(
     execute: async (args: { title: string; text: string; tags?: string[]; fields?: Record<string, unknown> }): Promise<PutResult> => {
       const wiki = deps.wiki()
       if (wiki === undefined) throw new Error('TiddlyWiki 服务未运行（tiddlywiki_status 可查）')
+      const existing = await wiki.get(args.title).catch(() => undefined)
+      const tags = finalTagsForWrite(args.title, existing, Array.isArray(args.tags) ? args.tags.filter((t) => typeof t === 'string' && t.trim().length > 0) : [])
       const tiddler: Tiddler = { title: args.title, text: args.text }
-      if (Array.isArray(args.tags) && args.tags.length > 0) tiddler.tags = args.tags
+      if (tags.length > 0) tiddler.tags = tags
       if (args.fields !== undefined && typeof args.fields === 'object' && args.fields !== null) Object.assign(tiddler, args.fields)
       await wiki.put(tiddler)
       deps.autoCommit()
-      return { ok: true, title: args.title, tags: args.tags ?? [], fields: args.fields ?? null }
+      return { ok: true, title: args.title, tags, fields: args.fields ?? null }
     },
   }))
 
   // ── tiddlywiki_batch_put ─────────────────────────────────────────────────
   register(defineTool({
     name: 'tiddlywiki_batch_put',
-    description: '批量写入/覆盖多个 TiddlyWiki tiddler（一次工具调用）。overwrite=false 时跳过已存在的标题；返回逐条结果。写入后触发自动 commit。',
+    description: '批量写入/覆盖多个 TiddlyWiki tiddler（一次工具调用）。overwrite=false 时跳过已存在的标题；返回逐条结果。写入后触发自动 commit。新建（title 不存在）的条目会自动补打 agent-written 标签，无需手动添加。',
     parameters: {
       items: {
         type: 'array',
@@ -301,16 +331,15 @@ export function registerTiddlywikiTools(ctx: ToolsCtx, deps: ToolsDeps): Array<(
       for (const item of list) {
         if (typeof item.title !== 'string' || item.title.length === 0) throw new Error('batch_put: 每条 items 都需要非空 title')
         if (typeof item.text !== 'string') throw new Error(`batch_put: items「${item.title}」缺少 text`)
-        if (!overwrite) {
-          const existing = await wiki.get(item.title).catch(() => undefined)
-          if (existing !== undefined) {
-            skipped++
-            results.push({ title: item.title, written: false, skipped: true })
-            continue
-          }
+        const existing = await wiki.get(item.title).catch(() => undefined)
+        if (!overwrite && existing !== undefined) {
+          skipped++
+          results.push({ title: item.title, written: false, skipped: true })
+          continue
         }
+        const tags = finalTagsForWrite(item.title, existing, Array.isArray(item.tags) ? item.tags.filter((t) => typeof t === 'string' && t.trim().length > 0) : [])
         const tiddler: Tiddler = { title: item.title, text: item.text }
-        if (Array.isArray(item.tags) && item.tags.length > 0) tiddler.tags = item.tags
+        if (tags.length > 0) tiddler.tags = tags
         if (item.fields !== undefined && typeof item.fields === 'object' && item.fields !== null) Object.assign(tiddler, item.fields)
         await wiki.put(tiddler)
         written++

package/src/index.ts

@@ -22,8 +22,8 @@ import { watch, type FSWatcher } from 'node:fs'
 import { writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { AutoCommitter, GitFace } from './host/git.ts'
-import { registerRoutes, type SessionControllerFace, type WebServerFace } from './host/routes.ts'
-import { ConfigStore, deepMerge, type PluginConfigShape } from './host/config.ts'
+import { registerRoutes, type SessionControllerFace, type WebServerFace, type WorkspaceRegistryFace } from './host/routes.ts'
+import { ConfigStore, deepMerge, DARK_PALETTE_DEFAULT, type PluginConfigShape } from './host/config.ts'
 import { registerAdminRoutes, ensureLanguage, resolveTwRoot, type AdminDeps } from './host/admin.ts'
 import { seedDocNote, DOC_NOTE_TITLE } from './host/seed-notes.ts'
 import { TiddlyWebClient } from './host/tw-api.ts'
@@ -56,7 +56,7 @@ export interface TiddlywikiConfig {
   port?: number
   git?: { autoCommit?: boolean; debounceMs?: number; remote?: string; branch?: string }
   note?: { tag?: string }
-  ui?: { showQuickNote?: boolean; showPanelStatus?: boolean; showSyncButton?: boolean }
+  ui?: { showQuickNote?: boolean; showPanelStatus?: boolean; showSyncButton?: boolean; followDshTheme?: boolean; darkPalette?: string }
   auth?: { username?: string; password?: string }
 }
 
@@ -77,7 +77,7 @@ interface ResolvedConfig {
   port: number
   git: { autoCommit: boolean; debounceMs: number; remote: string; branch: string }
   note: { tag: string }
-  ui: { showQuickNote: boolean; showPanelStatus: boolean; showSyncButton: boolean; sendToAgent: { enabled: boolean } }
+  ui: { showQuickNote: boolean; showPanelStatus: boolean; showSyncButton: boolean; followDshTheme: boolean; darkPalette: string; sendToAgent: { enabled: boolean } }
   auth: { username?: string; password?: string }
 }
 
@@ -87,7 +87,7 @@ const DEFAULTS: ResolvedConfig = {
   port: 0,
   git: { autoCommit: true, debounceMs: 60_000, remote: '', branch: 'main' },
   note: { tag: 'inbox' },
-  ui: { showQuickNote: true, showPanelStatus: true, showSyncButton: true, sendToAgent: { enabled: true } },
+  ui: { showQuickNote: true, showPanelStatus: true, showSyncButton: true, followDshTheme: true, darkPalette: DARK_PALETTE_DEFAULT, sendToAgent: { enabled: true } },
   auth: { username: '', password: '' },
 }
 
@@ -183,7 +183,9 @@ pull 冲突后：先 \`tiddlywiki_git_resolve files=[冲突文件] strategy=keep
 
 把 wiki 当作长期记忆与知识沉淀的地方：会议纪要、决策记录、调研笔记、随手的想法都可存成独立 tiddler（tag 建议用 inbox/meeting/decision 等便于检索）。
 
-用本插件自动创建笔记时，除了业务性 tag 外，请把「当前工作区（项目）的名字」也作为标签之一加上去（例如 \`tiddlywiki_put\` 的 tags 里带上当前 workspace 名），这样笔记能按项目归集、检索。`
+用本插件自动创建笔记时，除了业务性 tag 外，请把「当前工作区（项目）的名字」也作为标签之一加上去（例如 \`tiddlywiki_put\` 的 tags 里带上当前 workspace 名），这样笔记能按项目归集、检索。
+
+**Agent 笔记标签约定**：\`tiddlywiki_put\` / \`tiddlywiki_batch_put\` 新建笔记时，插件会自动补打 \`agent-written\` 标签（标记「由 Agent 撰写」），无需手动添加，也不要手动移除它（除非用户明确要求）。首页会把 Agent 笔记单独列在「Agent 区块」，主标签列表只统计人类笔记。若某篇 Agent 笔记后续被人类编辑过，请在该笔记上补打 \`human-edited\` 标签，首页会把它归入「Agent + 人工」档。覆盖写入已有的（人类）笔记时不会自动加 agent-written，请保持笔记原本的归属。`
 
 /**
  * Mount the host half.
@@ -212,11 +214,17 @@ export function apply(ctx: HostCtx, rawConfig: TiddlywikiConfig = {}): void {
     const tag = eff().note?.tag
     return typeof tag === 'string' && tag.trim().length > 0 ? tag : config.note.tag
   }
-  const effectiveUi = (): { showQuickNote: boolean; showPanelStatus: boolean; showSyncButton: boolean } => ({
-    showQuickNote: eff().ui?.showQuickNote !== false,
-    showPanelStatus: eff().ui?.showPanelStatus !== false,
-    showSyncButton: eff().ui?.showSyncButton !== false,
-  })
+  const effectiveUi = (): { showQuickNote: boolean; showPanelStatus: boolean; showSyncButton: boolean; followDshTheme: boolean; darkPalette: string } => {
+    const ui = eff().ui ?? {}
+    const palette = typeof ui.darkPalette === 'string' && ui.darkPalette.trim().length > 0 ? ui.darkPalette.trim() : DARK_PALETTE_DEFAULT
+    return {
+      showQuickNote: ui.showQuickNote !== false,
+      showPanelStatus: ui.showPanelStatus !== false,
+      showSyncButton: ui.showSyncButton !== false,
+      followDshTheme: ui.followDshTheme !== false,
+      darkPalette: palette,
+    }
+  }
 
   const disposers: Array<() => void> = []
   const disposeAll = (): void => {
@@ -359,6 +367,8 @@ export function apply(ctx: HostCtx, rawConfig: TiddlywikiConfig = {}): void {
     // agent routes must work whenever a request actually arrives.
     const getSessionController = (): SessionControllerFace | undefined =>
       ctx.get('sessionController') as SessionControllerFace | undefined
+    const getWorkspaceRegistry = (): WorkspaceRegistryFace | undefined =>
+      ctx.get('workspaceRegistry') as WorkspaceRegistryFace | undefined
     const disposeRoutes = registerRoutes({ webServer: ws }, {
       server,
       getClient: client,
@@ -368,6 +378,7 @@ export function apply(ctx: HostCtx, rawConfig: TiddlywikiConfig = {}): void {
       uiDefaults: () => effectiveUi(),
       getWikiPath: () => wikiPath,
       getSessionController,
+      getWorkspaceRegistry,
       sendToAgentEnabled: () => eff().ui?.sendToAgent?.enabled !== false,
       sendToAgentToken: () => {
         const token = eff().ui?.sendToAgent?.token