cortico-world-screen-diary 0.2.0 → 0.6.0

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "cortico-world-screen-diary",
-  "version": "0.2.0",
+  "version": "0.6.0",
   "type": "module",
-  "description": "活动日记：消费窥屏助手的事件流，把工作状态投影到二维空间并平滑；细节会淡忘，只留大概。需要 cortico-world-screen-sense。",
+  "description": "活动日记：把窥屏助手的事件流整理成平滑的活动记忆与二维状态；细节会淡忘，只留大概。先安装并启用 cortico-world-screen-sense。",
   "author": "Wwhois163wW",
   "license": "AGPL-3.0-or-later",
   "repository": {
@@ -17,28 +17,52 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "keywords": ["cortico-world", "cortico", "diary", "activity", "screen"],
-  "engines": { "node": ">=22" },
+  "keywords": [
+    "cortico-world",
+    "cortico",
+    "diary",
+    "activity",
+    "screen",
+    "screen-sense"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
   "packageManager": "pnpm@11.28.6",
   "main": "./src/index.ts",
-  "exports": { ".": "./src/index.ts" },
+  "exports": {
+    ".": "./src/index.ts"
+  },
   "cortico": {
     "kind": "world",
     "api": 6,
     "displayName": "活动日记",
-    "tags": ["memory", "requires-extension", "sensitive-data", "experimental"],
+    "tags": [
+      "memory",
+      "requires-extension",
+      "sensitive-data",
+      "experimental"
+    ],
     "icon": "assets/icon.svg",
     "locales": {
       "en": {
         "displayName": "Activity Diary",
-        "description": "Consumes the screen-sense event stream and turns foreground switches and vision captions into a searchable timeline. Requires cortico-world-screen-sense to be installed and enabled."
+        "description": "Activity Diary turns the Screen Sense event stream into smoothed activity memory and a two-axis state; details fade, only the gist remains. Install and enable cortico-world-screen-sense first."
       }
     },
     "describe": "describe.json",
     "webUiClient": "dist/webui.js",
     "webUiStyle": "dist/webui.css"
   },
-  "files": ["src", "assets", "dist", "describe.json", "README.md", "CHANGELOG.md", "LICENSE"],
+  "files": [
+    "src",
+    "assets",
+    "dist",
+    "describe.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "node scripts/build-webui.mjs",
     "test": "vitest run",

package/src/ENV_PROMPT.en.md

@@ -9,4 +9,4 @@ Rules:
 - Use `diary_search` only when exact detail matters. Reaction and thinking do not need precise recall; a rough picture with small inaccuracies is fine.
 - Communication apps are filtered; AI chats are blurred to neutral by default. Do not ask about or guess those.
 - The diary keeps no images; when a picture matters, use the producer's `screen_photo_show`.
-- An empty diary means screen-sense is not installed, not enabled, or has no events yet; do not retry in a loop.
+- screen-diary.reengage means the person came back after quiet time; a light greeting fits, without follow-up questions.\n- screen-diary.checkin means the flow depleted and they may be focused or away; offer a break or a soft check-in once.\n- An empty diary means screen-sense is not installed, not enabled, or has no events yet; do not retry in a loop.

package/src/ENV_PROMPT.md

@@ -9,4 +9,4 @@
 - 只有需要精确细节时才用 `diary_search`。平时的反应与思考不需要精确回忆，允许概括与轻微出入。
 - 通讯类应用已被过滤，AI 对话默认模糊为中性；不要追问或猜测这些内容。
 - 日记不保存原图；需要画面细节时用窥屏助手的 `screen_photo_show`。
-- 日记为空说明窥屏助手未安装、未启用或还没产生事件；不要反复重试。
+- screen-diary.reengage 表示对方在安静一段时间后回来了，适合轻声打招呼，不要连续追问。\n- screen-diary.checkin 表示流枯竭、可能在专注或离开；可以提醒休息或轻声确认，一次就够。\n- 日记为空说明窥屏助手未安装、未启用或还没产生事件；不要反复重试。

package/src/apps.ts

@@ -0,0 +1,88 @@
+/**
+ * Seen applications and their local policy overrides.
+ *
+ * The default projection comes from `state.classify`; a per-app override can change the category
+ * ("word class") or the flow-decay window. Only app names, counters and overrides are stored here;
+ * window titles are never kept.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import type { Category } from './state.ts';
+
+export type AppCategory = Category | 'filtered';
+
+export interface AppRecord {
+  app: string;
+  count: number;
+  lastSeen: string;
+  /** What the built-in classifier says; refreshed on sight. */
+  defaultCategory: AppCategory;
+  /** User/pet override; undefined means follow `defaultCategory`. */
+  category?: AppCategory;
+  /** Per-app flow decay in minutes; undefined means the category default. */
+  decayMinutes?: number;
+}
+
+const FILE = 'apps.json';
+
+export class AppCatalog {
+  private records = new Map<string, AppRecord>();
+
+  constructor(private readonly dir: string) {
+    this.load();
+  }
+
+  /** Count one sighting and refresh the default category. */
+  observe(app: string, at: number, defaultCategory: AppCategory): void {
+    if (!app) return;
+    const seen = new Date(at).toISOString();
+    const record = this.records.get(app);
+    this.records.set(app, record
+      ? { ...record, count: record.count + 1, lastSeen: seen, defaultCategory }
+      : { app, count: 1, lastSeen: seen, defaultCategory });
+  }
+
+  policy(app: string): AppRecord | undefined {
+    return this.records.get(app);
+  }
+
+  /** Set or clear the per-app overrides; returns the updated record. */
+  setPolicy(app: string, category: AppCategory | null | undefined, decayMinutes: number | null | undefined): AppRecord | undefined {
+    const record = this.records.get(app);
+    if (!record) return undefined;
+    const next: AppRecord = { ...record };
+    if (category === null) delete next.category;
+    else if (category !== undefined) next.category = category;
+    if (decayMinutes === null || decayMinutes === 0) delete next.decayMinutes;
+    else if (decayMinutes !== undefined && decayMinutes > 0) next.decayMinutes = Math.min(180, Math.max(1, Math.round(decayMinutes)));
+    this.records.set(app, next);
+    this.save();
+    return next;
+  }
+
+  /** Records sorted by most recently seen. */
+  list(): AppRecord[] {
+    return [...this.records.values()].sort((a, b) => b.lastSeen.localeCompare(a.lastSeen));
+  }
+
+  save(): void {
+    try {
+      writeFileSync(join(this.dir, FILE), JSON.stringify([...this.records.values()], null, 2), 'utf8');
+    } catch {
+      /* the catalog is helpful, not essential */
+    }
+  }
+
+  private load(): void {
+    const path = join(this.dir, FILE);
+    if (!existsSync(path)) return;
+    try {
+      const rows = JSON.parse(readFileSync(path, 'utf8')) as AppRecord[];
+      for (const row of rows) {
+        if (row && typeof row.app === 'string') this.records.set(row.app, row);
+      }
+    } catch {
+      /* a broken catalog starts empty */
+    }
+  }
+}

package/src/book.ts

@@ -130,6 +130,20 @@ export class DiaryBook {
     return this.entries.filter((entry) => localParts(entry.ts, this.timezone).day === key);
   }
 
+  /** All detail entries, oldest first (used by the 0.1 → 0.2 state backfill). */
+  chronological(): DiaryEntry[] {
+    return this.entries.slice().sort((a, b) => a.cursor - b.cursor);
+  }
+
+  /** Drop entries that fail the predicate (privacy migration) and keep the cursor. */
+  retainEntries(keep: (entry: DiaryEntry) => boolean): number {
+    const removed = this.entries.filter((entry) => !keep(entry));
+    if (removed.length === 0) return 0;
+    this.entries = this.entries.filter((entry) => keep(entry));
+    writeFileSync(join(this.dir, ENTRIES), this.entries.map((entry) => `${JSON.stringify(entry)}\n`).join(''), 'utf8');
+    return removed.length;
+  }
+
   /** Newest detail entries first (explicit recall only). */
   recent(limit = 100): DiaryEntry[] {
     return this.entries.slice(-Math.max(1, limit)).reverse();