@cteno/sdk-linux-x64 0.0.0-stage → 2.10.14

package/plugins/cteno.memory/.cteno-plugin/plugin.json

@@ -0,0 +1,176 @@
+{
+  "schemaVersion": 2,
+  "id": "cteno.memory",
+  "version": "0.3.1",
+  "title": "Cteno Wiki Memory",
+  "icon": "library-outline",
+  "color": "#8E7CFF",
+  "developer": "Cteno",
+  "category": "记忆",
+  "featured": true,
+  "origin": "builtin",
+  "description": "An OKF knowledge wiki that compounds over time — fast daily logs, index-first topic recall, and slow dream consolidation into durable interlinked pages. Self-contained CRUD via the bundled cteno-wiki CLI; LLM consolidation via the host's generic subagent interface.",
+  "defaultEnabled": true,
+  "surfaces": {
+    "prompt": {
+      "fragments": [
+        "skills/cteno.memory.native/SKILL.md"
+      ]
+    },
+    "rpc": {
+      "handler": {
+        "type": "command",
+        "command": "cteno-wiki",
+        "args": [
+          "rpc"
+        ],
+        "timeout_secs": 120
+      }
+    },
+    "tools": [
+      {
+        "id": "memory",
+        "definition": "tools/memory/TOOL.md"
+      }
+    ],
+    "agents": [
+      {
+        "id": "llm-wiki",
+        "definition": "agents/llm-wiki/AGENT.md"
+      }
+    ],
+    "hooks": [
+      {
+        "event": "UserPromptSubmit",
+        "handler": {
+          "type": "command",
+          "command": "cteno-wiki",
+          "args": [
+            "auto-recall-hook"
+          ],
+          "timeoutSecs": 2
+        }
+      },
+      {
+        "event": "UserPromptSubmit",
+        "handler": {
+          "type": "command",
+          "command": "cteno-wiki",
+          "args": [
+            "capture",
+            "--event",
+            "UserPromptSubmit"
+          ],
+          "timeoutSecs": 5
+        }
+      },
+      {
+        "event": "Stop",
+        "handler": {
+          "type": "command",
+          "command": "cteno-wiki capture --event Stop"
+        }
+      },
+      {
+        "event": "SubagentStop",
+        "handler": {
+          "type": "command",
+          "command": "cteno-wiki capture --event SubagentStop"
+        }
+      },
+      {
+        "event": "PostCompact",
+        "handler": {
+          "type": "command",
+          "command": "cteno-wiki capture --event PostCompact"
+        }
+      }
+    ],
+    "pages": [
+      {
+        "id": "memory",
+        "title": "记忆",
+        "entry": "ui/index.html",
+        "slot": "chat-header-memory",
+        "rpc": [
+          "list",
+          "read",
+          "sync_docs",
+          "dream_status",
+          "dream_mark_seen",
+          "dream_dismiss",
+          "capabilities",
+          "dream_proposals",
+          "dream_asks",
+          "dream_proposal_decide",
+          "dream_handoffs",
+          "dream_changes",
+          "dream_undo",
+          "activity",
+          "topics",
+          "search"
+        ],
+        "desktop": {
+          "container": "cef-pane"
+        },
+        "mobile": {
+          "container": "rn-webview"
+        }
+      }
+    ],
+    "messageActions": [
+      {
+        "id": "collect",
+        "title": "记住",
+        "icon": "mci:brain",
+        "rpc": "collect"
+      }
+    ],
+    "externalCli": {
+      "name": "Cteno Wiki CLI",
+      "description": "Self-contained OKF knowledge-wiki memory CLI. Portable CRUD over a Cteno memory bundle, usable by any agent via the shell.",
+      "binary": "cteno-wiki",
+      "statusCommand": "cteno-wiki schema"
+    },
+    "recommendations": [
+      {
+        "id": "cteno-memory-dream",
+        "title": "整理记忆（Dream）",
+        "description": "把最近的 daily logs 归纳合并进 OKF 知识 wiki，并维护主题索引。",
+        "icon": "sparkles-outline",
+        "color": "#8E7CFF",
+        "prompt": "请整理并归纳我的项目记忆：调用 memory 工具的 dream 动作（{\"action\":\"dream\",\"scope\":\"private\"}），把最近的 daily logs 与 raw project docs 合并进 OKF 知识 wiki 的主题页并维护 index.md。当前项目目录由 runtime 自动注入，不要传 project_dir。完成后简要说明更新或新建了哪些主题页。"
+      },
+      {
+        "id": "cteno-memory-recall",
+        "title": "回忆某个主题",
+        "description": "按主题从 OKF wiki 检索相关页面与要点。",
+        "icon": "search-outline",
+        "color": "#8E7CFF",
+        "prompt": "我想回忆一个主题。请用 memory 工具的 recall 动作，按我给的主题词从 OKF 知识 wiki 里检索相关主题页（索引优先、整页返回），汇总要点并列出页面间的关联。"
+      },
+      {
+        "id": "cteno-memory-index",
+        "title": "查看记忆索引",
+        "description": "列出 wiki 的主题索引，了解已沉淀的知识。",
+        "icon": "list-outline",
+        "color": "#8E7CFF",
+        "prompt": "请读取 OKF 知识 wiki 的 index.md，按主题分类列出我已经沉淀的知识页面，并指出哪些主题内容较多、哪些还比较单薄。"
+      }
+    ],
+    "suggestedPrompts": [
+      {
+        "id": "recall",
+        "title": "回忆一下我们之前聊过的事",
+        "prompt": "帮我回忆一下我们之前聊过的事：先问我想回忆哪件事，再从记忆里找出相关的要点，用几句话告诉我。"
+      }
+    ]
+  },
+  "permissions": {
+    "externalProcess": [
+      "cteno-wiki"
+    ],
+    "network": false,
+    "filesystem": []
+  }
+}

package/plugins/cteno.memory/agents/llm-wiki/AGENT.md

@@ -0,0 +1,96 @@
+---
+name: "LLM Wiki Librarian"
+description: "Consolidates raw memory logs into a persistent, interlinked OKF knowledge wiki."
+version: "1.2.0"
+type: "autonomous"
+# Fire-and-forget dream librarian: nobody is watching to answer a permission
+# card, so run non-interactively. (R4 bubbles INTERACTIVE subagents' permission
+# requests to the parent UI; this agent opts out by pinning bypass.)
+permission_mode: "bypass_permissions"
+# A dream CONSUMES raw memory; it must never PRODUCE it. Plugin lifecycle
+# hooks (the wiki's own capture on UserPromptSubmit/Stop) are not projected
+# into this agent's sessions, otherwise each dream's ~3 KB prompt and closing
+# summary land in the daily log and bump the dirty-gate that spawned it.
+hooks_enabled: false
+expose_as_tool: false
+temperature: 0.2
+max_tokens: 8192
+timeout_seconds: 600
+tools:
+  - memory
+  - read
+  - grep
+  - glob
+---
+
+# LLM Wiki Librarian
+
+You maintain a persistent **knowledge wiki** in the project's memory that
+*compounds* over time. Raw daily logs are your source material; the wiki is the
+compiled, durable result. You read the new raw material, then update the wiki so
+future sessions can recall it.
+
+The wiki is stored in **Open Knowledge Format (OKF)**: a directory of markdown
+files, each with YAML frontmatter and a markdown body, cross-linked with
+standard relative markdown links. The consolidation mechanics (merge loop, OKF
+page shape, safety rules) arrive with each task — follow them exactly; this
+file only adds your tool bindings and durability policy.
+
+## Tool bindings
+
+You work through the `memory` tool:
+
+- Recall (index-first): `memory({action:"recall", query:"<topic>"})` —
+  returns whole pages within a character budget; when nothing matches, the topic
+  `index.md` comes back as a navigation map. Oversized bodies are represented by
+  their path instead of being cut. **A single query can miss a relevant page**
+  when its title/description use different wording (CJK vs English keywords,
+  a different technical term for the same incident). Before deciding no page
+  fits and creating a new one, try at least one rephrased query — swap
+  CJK/English keywords, try the subsystem or file name — and skim the returned
+  `index.md` topic map if still inconclusive.
+- For exact strings or oversized pages, reuse generic `grep` on the OKF path,
+  then generic `read` with `offset`/`limit`. Private OKF is under
+  `<project>/.cteno/memory/`; global OKF defaults to `~/.cteno/memory/`.
+  Prefer durable topic directories and `raw/docs/`; do not grep `logs/` by
+  default. Never edit managed `raw/docs/` pages — update durable topic pages.
+- Read a complete page: `memory({action:"read", file_path:"<path>"})`.
+- Merge/write a page: `memory({action:"overwrite", file_path:"<path>",
+  content:"<full OKF page>", sources:["log: <log path>"]})` — unions `sources[]`
+  provenance and maintains the page's `index.md` entry automatically.
+- Remove an obsolete page: `memory({action:"delete", file_path:"<path>"})`.
+
+- Finish every pass with exactly one outcome report:
+  `memory({action:"dream_report", status:"ok", summary:"…", pages:["<paths written/deleted>"], proposals:[{kind, evidence, action, confidence, needs_user, pages}]})`,
+  or — when you could not complete the pass (tool errors, unreadable material,
+  conflicting pages you could not safely merge) —
+  `memory({action:"dream_report", status:"failed", error:"<what went wrong>", summary:"<what you did get done>"})`.
+  Do not retry a failed pass yourself; the user decides. If the user later
+  continues this session and the pass succeeds, report `ok` again.
+
+## Digest it yourself (proposals)
+
+Every pass also reports **proposals** — the §3.6 table in the task's
+mechanics. Default to deciding yourself: clarify (look it up, else mark
+未证实), conflict (newest direct evidence wins, old claim kept as a trace),
+promote / guard (write the rule), expire (mark stale facts), privacy (remove
+the secret from the page), skillify (write a `workflow/` page) — you do these in
+this pass and report them with `needs_user:false`. followup / stale are handed
+to the main conversation as-is. Only `schedule`, and a `conflict` about money,
+an external commitment or direction whose evidence is equally strong, get
+`needs_user:true` (write their `action`/`evidence` in plain user words — Jelly
+says them in chat verbatim; see the rules); the host shows the user at most one such ask per day and
+remembers every "no" on `knowledge/declined-dream-proposals.md` — never raise
+those again. Every page you write or delete is journaled and can be undone by
+the user, so act; do not ask.
+
+## What to consolidate
+
+- User preferences and feedback that should affect future work.
+- Project decisions, deadlines, incidents, and their rationale when not derivable
+  from code.
+- References to external systems: trackers, dashboards, channels, PRs.
+- Repeated gotchas, validated approaches, and cross-session coordination rules.
+
+Drop anything derivable from the repo or git history, transient task state, and
+ephemera.

package/plugins/cteno.memory/skills/codebase-wiki/SKILL.md

@@ -0,0 +1,52 @@
+---
+description: OKF codebase memory — recall-before-explore, save-after. Use BEFORE fanning out agents to explore an unfamiliar subsystem (recall accumulated knowledge first; if it answers, skip the exploration), and AFTER discovering durable architecture facts (save them so they compound across sessions). Scoped global + per-project like skills. Backed by the bundled cteno-wiki CLI.
+---
+
+# Cteno Wiki — codebase memory (recall-before-explore, save-after)
+
+A persistent OKF knowledge wiki. **Re-exploring the same subsystem every task is a tax — recall first, and feed back what you learn so it compounds.**
+
+- **CLI:** `cteno-wiki` (bundled in this plugin's `bin/`, on PATH while enabled).
+- **One OKF store, shared with the Cteno runtime** (`<dir>/.cteno/memory`). Two scopes (like skills):
+  - **project** = `--project-dir "${CLAUDE_PROJECT_DIR:-$PWD}"` → `$CLAUDE_PROJECT_DIR/.cteno/memory` — THIS codebase's maps (file:line, gotchas, subsystem designs).
+  - **global** = `--scope global` → `$HOME/.cteno/memory` — cross-project (working habits, general patterns).
+- **Project docs are raw Wiki data:** `docs/**/*.md(x)` is mirrored byte-for-byte
+  to `raw/docs/` with OKF provenance. Run `cteno-wiki sync-docs` for immediate
+  catch-up; Cteno runtime also watches and reconciles active projects.
+
+## RECALL — before exploring (check BOTH scopes)
+```bash
+cteno-wiki sync-docs --project-dir "${CLAUDE_PROJECT_DIR:-$PWD}"
+cteno-wiki recall --project-dir "${CLAUDE_PROJECT_DIR:-$PWD}" --query "$ARGUMENTS" --text
+cteno-wiki recall --scope global --query "$ARGUMENTS" --text
+```
+Index-first: topic index → whole pages → link hops. No match returns the topic
+index as a navigation map — pick a page and `read` it. If it answers, **skip the agent fan-out**.
+
+**Fan-out raw capture is automatic.** `SubagentStop` and Workflow-result hooks
+write the complete Explorer/worker findings to the daily raw log, so do not
+duplicate that payload manually. After using the findings, write only the
+durable merged conclusion to a topic page when it adds lasting value.
+
+## SAVE — after durable findings (route by scope)
+- **Codebase facts** (file:line, gotchas, this-project subsystem design) → **project** scope.
+- **Cross-project** (working habits, general patterns) → **global** scope.
+```bash
+# project scope below; for cross-project swap `--project-dir "${CLAUDE_PROJECT_DIR:-$PWD}"` → `--scope global`
+cteno-wiki overwrite --project-dir "${CLAUDE_PROJECT_DIR:-$PWD}" --file knowledge/<topic>.md --source "<where you learned it>" --content - <<'PAGE'
+---
+type: reference
+title: <title>
+tags: [<tag>, <tag>]
+---
+<durable facts — concrete file:line, the gotcha + why, the decision + judgement>
+Related: [Adjacent page](other-topic.md)
+PAGE
+```
+`overwrite` unions `sources[]`, stamps the timestamp, and upserts the page's `index.md` entry — no separate index step.
+
+## Browse / prune
+- `cteno-wiki list --project-dir "${CLAUDE_PROJECT_DIR:-$PWD}"` · `cteno-wiki read --project-dir "${CLAUDE_PROJECT_DIR:-$PWD}" --file <path>` (add `--scope global` for cross-project)
+- `cteno-wiki delete --project-dir "${CLAUDE_PROJECT_DIR:-$PWD}" --file <path>` removes a stale page + its index entry.
+
+The point: stop re-discovering. Recall (both scopes) → explore only what's missing → save back to the right scope.

package/plugins/cteno.memory/skills/cteno.memory.native/SKILL.md

@@ -0,0 +1,110 @@
+# Cteno Memory Tool
+
+Use Cteno's runtime-native `memory` tool for persistent project and global
+memory. Do not call desktop sidecar CLIs directly.
+
+The runtime injects the active project root; never pass `project_dir` yourself.
+Project memory maps to `.cteno/memory/`. Pass `scope: "global"` only when you
+explicitly want global memory.
+
+To look into ANOTHER project's memory (e.g. from the main conversation, using a
+path listed in `<project_directory>`), pass `project: "<absolute project root>"`
+to `recall`, `read` or `list`. This is read-only and reads only that project's
+`.cteno/memory/`; a project without memory returns an empty result. Page
+writes (`save`/`overwrite`/`delete`/`dream`) reject `project`.
+
+A project decision made in the main conversation is forwarded with
+`log` + `project`: the entry is appended (only appended) to that project's daily
+log with an origin note, a marked copy stays in your own log, and the project's
+dream consolidates it. Only known projects are accepted; pages are never
+touched. Cross-project facts (preferences, machines, brand wording) stay global.
+
+Memory is an **OKF (Open Knowledge Format) wiki**: each page is markdown with a
+YAML frontmatter (`type` required; optional `title`/`description`/`sources`/
+`tags`/`timestamp`), the path is the page identity, and pages cross-link with
+relative markdown links. Files under `docs/` are continuously mirrored,
+byte-for-byte, into `raw/docs/` as `type: raw` Wiki input. A topic-organized
+`index.md` is the entry point; daily
+`logs/YYYY/MM/YYYY-MM-DD.md` hold fast append-only signals; slow consolidation
+(`dream`) merges logs into durable topic pages and maintains `index.md`.
+
+The runtime automatically captures complete user prompts and completed
+Explorer/worker/Subagent findings into the project daily raw log. Do not save
+the same material again manually. Use `save`/`overwrite` only for deliberate
+durable topic edits; `dream` promotes useful raw material into topic pages.
+
+Command schema:
+
+```json
+{
+  "list": {
+    "input": { "action": "list", "scope": "private" },
+    "output": { "success": "boolean", "data": ["[private] file.md", "[global] file.md"] }
+  },
+  "recall": {
+    "input": { "action": "recall", "query": "<string>", "limit": 10, "max_chars": 32000, "project": "<optional absolute project root, read-only>" },
+    "output": { "success": "boolean", "data": [{ "file_path": "string", "content": "whole page or oversized-page descriptor", "score": "real index overlap with link decay" }] },
+    "description": "Wiki recall across BOTH scopes: index-first whole pages under a Unicode-character budget, not keyword chunks. Oversized bodies are represented by path; use existing grep + ranged read."
+  },
+  "read": {
+    "input": { "action": "read", "file_path": "<file_path>", "scope": "private" },
+    "output": { "success": "boolean", "data": "markdown or null" }
+  },
+  "delete": {
+    "input": { "action": "delete", "file_path": "<file_path>", "scope": "private" },
+    "output": { "success": "boolean" },
+    "description": "Delete a memory page and remove its index.md entry."
+  },
+  "save": {
+    "input": { "action": "save", "file_path": "knowledge/<topic>.md", "type": "<required OKF type>", "content": "<markdown>", "scope": "private" },
+    "output": { "success": "boolean" },
+    "description": "Append a durable fact to one indexed OKF topic page. Exact retries are deduplicated; legacy MEMORY.md is redirected to knowledge/general.md."
+  },
+  "overwrite": {
+    "input": { "action": "overwrite", "file_path": "<file_path>", "content": "<OKF markdown>", "sources": ["log: logs/2026/06/..."], "scope": "private" },
+    "output": { "success": "boolean" },
+    "description": "Read-modify-write a page with newly authored OKF content, unioning `sources[]` provenance with the existing page and upserting its index.md entry. The merge primitive for wiki consolidation."
+  },
+  "log": {
+    "input": { "action": "log", "content": "<entry>", "scope": "private" },
+    "output": { "success": "boolean" },
+    "description": "Append a timestamped fast-memory entry to today's daily log. Use for fresh signals, decisions, external events, and handoff facts not yet ready to become durable topic memory."
+  },
+  "migrate": {
+    "input": { "action": "migrate", "scope": "private" },
+    "output": { "success": "boolean" },
+    "description": "One-shot, idempotent migration of the current scope to OKF: rewrite legacy type+date frontmatter, generate index.md, seed log.md."
+  },
+  "sync_docs": {
+    "input": { "action": "sync_docs", "scope": "private" },
+    "output": { "success": "boolean" },
+    "description": "Immediately reconcile docs/**/*.md(x) into raw/docs/. Normally automatic via watcher and read-time catch-up."
+  },
+  "reindex": {
+    "input": { "action": "reindex", "scope": "private" },
+    "output": { "success": "boolean" },
+    "description": "Structurally repair index.md against the pages on disk: drop duplicate entries and entries for deleted pages, add entries for un-indexed pages. Preserves surviving entries' authored text and topic headings, so it is safe to run anytime; idempotent. Run it after merging memory between git branches/worktrees (index.md is union-merged). `refresh_from_pages: true` re-derives entry text from page frontmatter — lossy, since consolidation writes richer text into the index than pages carry."
+  },
+  "dream": {
+    "input": { "action": "dream", "scope": "private" },
+    "output": { "success": "boolean" },
+    "description": "Slow-memory consolidation: spawns the `llm-wiki` librarian subagent in the background to read daily logs and merge durable facts into the OKF wiki (`overwrite` + `index.md`). Fire-and-forget."
+  }
+}
+```
+
+When to use which: `recall` is THE topic recall — index-first Wiki navigation
+returning whole linked pages within `max_chars` (there is no keyword-chunk
+search). If the result is the index map, pick a page and `read` it. If a page is
+oversized or you need an exact string/identifier/regex, reuse the generic tools:
+
+1. Run `memory(recall)` first so raw docs are synchronized and candidate pages
+   are known.
+2. `grep` private OKF under `.cteno/memory/` or global OKF under
+   `~/.cteno/memory/`; prefer `knowledge/`, `project/`, `workflow/`,
+   `incidents/`, and `raw/docs/`, not noisy `logs/`.
+3. Use generic `read(offset, limit)` around the returned lines.
+
+Use `overwrite` (not `save`) when refining an existing page so `sources[]` provenance
+is preserved; `log` for transient signals; `dream` to consolidate logs into the
+durable wiki.