@cowwo/dsh-lookout 0.1.2 → 0.5.0

package/lib/typert.host.js

@@ -116,11 +116,41 @@ const setRunningRuleRequestSchema = z.object({
 	headerRing: z.boolean().optional()
 })
 
+/**
+ * 工作区偏好(标签 / 颜色 / 置顶 / 隐藏)。
+ *
+ * 与图标 RPC 分开的一对端点:偏好文件坏了最多丢标签,不能拖累 favicon、红点
+ * 和进行中黄点。文档整份读写(客户端每次提交完整文档,宿主整份覆盖)。
+ */
+const workspacePrefsEntrySchema = z.object({
+	// 按 Unicode 字符数(不是 UTF-16 长度)限 6:6 个 emoji 是合法标签。
+	tag: z.string().refine((value) => [...value].length <= 6, { message: 'tag 最多 6 个字符' }),
+	color: z.enum(['red', 'orange', 'yellow', 'green', 'cyan', 'blue', 'purple', 'gray']),
+	pinned: z.boolean(),
+	hidden: z.boolean(),
+	pinAnchor: z.string().nullable()
+})
+
+const workspacePrefsSchema = z.object({
+	version: z.literal(1),
+	workspaces: z.record(z.string().min(1).max(200), workspacePrefsEntrySchema)
+})
+
+/**
+ * set 的请求 schema 故意放宽到"只验形状":端点自己会用 normalize 把非法 tag /
+ * 颜色 / 布尔值降级成默认值,所以旧客户端或手改的文档不会在网关层被整份拒绝,
+ * 从而丢掉本来还能用的那些工作区。
+ */
+const setWorkspacePrefsRequestSchema = z.object({
+	version: z.number().int().optional(),
+	workspaces: z.record(z.string(), z.unknown())
+})
+
 const setIconResultSchema = statusSchema
 
 
 
-/** 一个通道这一次的成败（多通道扇出后，账本里要看得出是哪个通道）。 */
+/** 一个通道这一次的成败（多通道扇出后，要看得出是哪个通道）。 */
 let channelSchema$value;
 const channelSchema = () => (channelSchema$value ??= z.object({
   transport: z.string(),
@@ -142,13 +172,6 @@ const deliverySchema = () => (deliverySchema$value ??= z.object({
   channels: z.array(channelSchema()),
 }));
 
-/** 账本快照。 */
-let stateSchema$value;
-const stateSchema = () => (stateSchema$value ??= z.object({
-  counts: z.object({ sent: z.number(), failed: z.number() }),
-  recent: z.array(deliverySchema()),
-}));
-
 
 
 /** 合并后的 service 模型:A 的 iconCustom + B 的 mailNotify(B 的 model.services 为空)。 */
@@ -250,13 +273,31 @@ const services = [
 						summary: "Set the running-mark switch.",
 						jsDoc: "/** Set the running-mark switch. */",
 						tags: []
+					},
+					{
+						kind: 'method',
+						name: 'getWorkspacePrefs',
+						signature: 'async getWorkspacePrefs(): Promise<{ version: 1; workspaces: Record<string, { tag: string; color: string; pinned: boolean; hidden: boolean; pinAnchor: string | null }> }>',
+						description: "Read the per-workspace preferences (tag, color, pinned, hidden).",
+						summary: "Read workspace preferences.",
+						jsDoc: "/** Read workspace preferences. */",
+						tags: []
+					},
+					{
+						kind: 'method',
+						name: 'setWorkspacePrefs',
+						signature: 'async setWorkspacePrefs(request: { version?: number; workspaces: Record<string, unknown> }): Promise<{ version: 1; workspaces: Record<string, { tag: string; color: string; pinned: boolean; hidden: boolean; pinAnchor: string | null }> }>',
+						description: "Replace the whole workspace-preferences document (dirty fields degrade to defaults).",
+						summary: "Set workspace preferences.",
+						jsDoc: "/** Set workspace preferences. */",
+						tags: []
 					}
 				],
 				types: []
 			}
 ]
 
-/** 合并后的宿主端点:A 的 9 条 iconCustom/* + B 的 2 条 mailNotify/*。 */
+/** 合并后的宿主端点:A 的 12 条 iconCustom/* + B 的 1 条 mailNotify/*。 */
 const invocations = [
 {
 			id: 'dsh-lookout#iconCustom/getStatus',
@@ -439,6 +480,45 @@ const invocations = [
 			},
 			sourceLocation: { file: 'lib/index.js', line: 1, column: 1 }
 		},
+		{
+			id: 'dsh-lookout#iconCustom/getWorkspacePrefs',
+			service: 'iconCustom',
+			namespace: 'iconCustom',
+			method: 'getWorkspacePrefs',
+			invocation: { kind: 'direct' },
+			parameters: [],
+			result: {
+				mode: 'strict',
+				typeSymbol: 'dsh-lookout#iconCustom/getWorkspacePrefs:result',
+				create: () => workspacePrefsSchema
+			},
+			sourceLocation: { file: 'lib/index.js', line: 1, column: 1 }
+		},
+		{
+			id: 'dsh-lookout#iconCustom/setWorkspacePrefs',
+			service: 'iconCustom',
+			namespace: 'iconCustom',
+			method: 'setWorkspacePrefs',
+			invocation: { kind: 'direct' },
+			parameters: [
+				{
+					name: 'request',
+					wire: 'request',
+					source: 'json',
+					codec: {
+						mode: 'strict',
+						typeSymbol: 'dsh-lookout#iconCustom/setWorkspacePrefs:request',
+						create: () => setWorkspacePrefsRequestSchema
+					}
+				}
+			],
+			result: {
+				mode: 'strict',
+				typeSymbol: 'dsh-lookout#iconCustom/setWorkspacePrefs:result',
+				create: () => workspacePrefsSchema
+			},
+			sourceLocation: { file: 'lib/index.js', line: 1, column: 1 }
+		},
 		{
 			id: 'dsh-lookout#iconCustom/setUnreadSeen',
 			service: 'iconCustom',
@@ -478,20 +558,6 @@ const invocations = [
       },
       sourceLocation: { file: 'lib/service.js', line: 1, column: 1 },
     },
-    {
-      id: 'dsh-lookout#mailNotify/state',
-      service: 'mailNotify',
-      namespace: 'mailNotify',
-      method: 'state',
-      invocation: { kind: 'direct' },
-      parameters: [],
-      result: {
-        mode: 'strict',
-        typeSymbol: 'dsh-lookout#mailNotify/state:result',
-        create: stateSchema,
-      },
-      sourceLocation: { file: 'lib/service.js', line: 1, column: 1 },
-    },
 ]
 
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cowwo/dsh-lookout",
   "description": "瞭望哨：盯着你的每个会话——谁跑完了、谁出错了、谁卡住了、谁在等你审批，用浏览器图标角标、红点/黄点和邮件通知你；顺带显示当前会话 ID。· Lookout: watches every session — who finished, who errored, who is stuck, and who is waiting for your approval — and notifies you through the browser favicon badge, red/yellow dots, and email, while also showing the current session ID.",
-  "version": "0.1.2",
+  "version": "0.5.0",
   "license": "MIT",
   "type": "module",
   "main": "lib/index.js",

package/lib/notify/state.js

@@ -1,102 +0,0 @@
-// dsh-notify-p · 投递账本（落盘，用于"到底发没发出去"的可验证性）
-//
-// 为什么需要它：cordis 的控制台 exporter 默认只输出 error 级，
-// 插件的 info/warn 日志**不会**出现在 dsh 的 stdout 里——
-// 所以"看日志确认"是不可行的。这里把每次投递结果落成一个 JSON 文件，
-// 出问题时 `cat $DSH_HOME/dsh-notify-p/state.json` 一眼就能看到。
-//
-// 只写真值，不写密钥、不写正文。
-
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-
-/** 账本保留的最近投递条数。 */
-const RECENT_LIMIT = 50;
-
-/**
- * 解析账本路径：配置优先，其次 $DSH_HOME/dsh-notify-p/state.json，
- * 最后回退 ~/.dsh/dsh-notify-p/state.json。
- * @param {string} [configured] 配置里的 statePath
- * @returns {string} 绝对路径
- */
-export function resolveStatePath(configured) {
-  if (typeof configured === 'string' && configured.trim() !== '') return configured.trim();
-  const home = typeof process.env.DSH_HOME === 'string' && process.env.DSH_HOME !== ''
-    ? process.env.DSH_HOME
-    : join(homedir(), '.dsh');
-  return join(home, 'dsh-notify-p', 'state.json');
-}
-
-/**
- * 建一个投递账本。
- * @param {object} [options] 参数
- * @param {string} [options.path] 账本路径
- * @param {object} [options.logger] 日志器
- * @returns {{ record: (entry: object) => void, snapshot: () => object, flush: () => void, path: string }}
- */
-export function createLedger(options = {}) {
-  const logger = options.logger ?? {};
-  const path = resolveStatePath(options.path);
-  const startedAt = new Date().toISOString();
-  /** @type {object[]} */
-  const recent = [];
-  const counts = { sent: 0, failed: 0 };
-
-  const persist = () => {
-    const payload = {
-      version: 1,
-      startedAt,
-      updatedAt: new Date().toISOString(),
-      counts,
-      recent,
-    };
-    try {
-      mkdirSync(dirname(path), { recursive: true });
-      writeFileSync(path, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
-    } catch (error) {
-      // 账本写不进去不能影响发信本身
-      logger.debug?.(`dsh-notify-p: 账本写入失败 / ledger write failed: ${String(error)}`);
-    }
-  };
-
-  // 进程一起来就先落一个文件，避免"文件不存在"被误读成"插件没加载"
-  persist();
-
-  return {
-    path,
-    /**
-     * 记一条投递结果。
-     * @param {object} entry 结果（at/ok/outcome/sessionId/subject/error/attempts）
-     * @returns {void}
-     */
-    record(entry) {
-      if (entry && entry.ok === true) counts.sent += 1;
-      else counts.failed += 1;
-      recent.push(entry);
-      while (recent.length > RECENT_LIMIT) recent.shift();
-      persist();
-    },
-    /**
-     * 当前账本内容。
-     * @returns {object}
-     */
-    snapshot() {
-      return { version: 1, startedAt, updatedAt: new Date().toISOString(), counts, recent: [...recent] };
-    },
-    flush: persist,
-  };
-}
-
-/**
- * 读一个账本文件（排错用）。
- * @param {string} path 账本路径
- * @returns {object|undefined}
- */
-export function readLedger(path) {
-  try {
-    return JSON.parse(readFileSync(path, 'utf8'));
-  } catch {
-    return undefined;
-  }
-}