forge-openclaw-plugin 0.2.49 → 0.2.50

package/dist/server/server/src/repositories/wiki-memory.js

@@ -1,7 +1,7 @@
 import { createHash, randomUUID } from "node:crypto";
 import AdmZip from "adm-zip";
-import { existsSync, mkdirSync, readdirSync, unlinkSync, rmSync, writeFileSync } from "node:fs";
-import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { existsSync, readdirSync, unlinkSync, rmSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { z } from "zod";
 import { resolveDataDir, getDatabase } from "../db.js";
@@ -718,7 +718,7 @@ function mapWikiSpace(row) {
     });
 }
 function getWikiRootDir() {
-    return path.join(resolveDataDir(), "wiki");
+    return path.join(resolveDataDir(), "wiki-ingest");
 }
 function getSpaceStorageDir(space) {
     if (space.visibility === "shared") {
@@ -726,16 +726,9 @@ function getSpaceStorageDir(space) {
     }
     return path.join(getWikiRootDir(), "users", space.ownerUserId ?? space.slug);
 }
-function getSpaceIndexPath(space) {
-    return path.join(getSpaceStorageDir(space), "index.md");
-}
 function getSpaceRawDir(space) {
     return path.join(getSpaceStorageDir(space), "raw");
 }
-function getNoteStoragePath(note, space) {
-    const directory = note.kind === "wiki" ? "pages" : "evidence";
-    return path.join(getSpaceStorageDir(space), directory, `${note.slug}.md`);
-}
 function buildNoteFrontmatter(note) {
     return {
         ...note.frontmatter,
@@ -761,20 +754,6 @@ function buildNoteFrontmatter(note) {
         author: note.author
     };
 }
-function stringifyFrontmatterValue(value) {
-    if (typeof value === "string") {
-        return JSON.stringify(value);
-    }
-    return JSON.stringify(value);
-}
-function renderFrontmatter(frontmatter) {
-    const lines = ["---"];
-    for (const [key, value] of Object.entries(frontmatter)) {
-        lines.push(`${key}: ${stringifyFrontmatterValue(value)}`);
-    }
-    lines.push("---", "");
-    return lines.join("\n");
-}
 function hashContent(value) {
     return createHash("sha256").update(value).digest("hex");
 }
@@ -1152,7 +1131,7 @@ async function compileImageWithLlm(profile, secrets, input) {
             title: parsed.title?.trim() || input.titleHint || "Imported image",
             summary: parsed.summary?.trim() || "",
             markdown: parsed.markdown?.trim() ||
-                `# ${parsed.title?.trim() || input.titleHint || "Imported image"}\n\nImage imported into the wiki vault.\n`,
+                `# ${parsed.title?.trim() || input.titleHint || "Imported image"}\n\nImage imported into Forge wiki memory.\n`,
             tags: normalizeTags(parsed.tags),
             entityProposals: Array.isArray(parsed.entityProposals)
                 ? parsed.entityProposals.filter((entry) => entry !== null && typeof entry === "object")
@@ -1239,7 +1218,7 @@ function ensureSharedWikiSpace() {
     getDatabase()
         .prepare(`INSERT INTO wiki_spaces (id, slug, label, description, owner_user_id, visibility, created_at, updated_at)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
-        .run("wiki_space_shared", "shared", "Shared Forge Memory", "Shared wiki space for file-backed Forge knowledge.", null, "shared", now, now);
+        .run("wiki_space_shared", "shared", "Shared Forge Memory", "Shared wiki space for SQLite-backed Forge knowledge.", null, "shared", now, now);
     const space = getWikiSpaceById("wiki_space_shared");
     ensureWikiSpaceSeedPages(space.id);
     return space;
@@ -1346,7 +1325,6 @@ function ensureWikiSpaceSeedPages(spaceId) {
         for (const note of insertedNotes) {
             syncNoteWikiArtifacts(note);
         }
-        syncWikiSpaceIndex(spaceId);
     }
 }
 function resolveSpaceId(spaceId, userId) {
@@ -1385,44 +1363,33 @@ export function prepareNoteWikiFields(input) {
     };
 }
 export function syncNoteWikiArtifacts(note) {
-    const space = getWikiSpaceById(note.spaceId) ?? ensureSharedWikiSpace();
-    const filePath = getNoteStoragePath(note, space);
     const frontmatter = buildNoteFrontmatter(note);
-    const payload = `${renderFrontmatter(frontmatter)}${note.contentMarkdown.trim()}\n`;
-    const revisionHash = hashContent(payload);
-    mkdirSync(path.dirname(filePath), { recursive: true });
-    if (note.sourcePath && note.sourcePath !== filePath) {
-        if (existsSync(note.sourcePath)) {
-            rmSync(note.sourcePath, { force: true });
-        }
-    }
-    writeFileSync(filePath, payload, "utf8");
+    const revisionHash = hashContent(JSON.stringify({
+        frontmatter,
+        contentMarkdown: note.contentMarkdown
+    }));
     const now = nowIso();
     getDatabase()
         .prepare(`UPDATE notes
        SET source_path = ?, frontmatter_json = ?, revision_hash = ?, last_synced_at = ?
        WHERE id = ?`)
-        .run(filePath, JSON.stringify(frontmatter), revisionHash, now, note.id);
+        .run("", JSON.stringify(frontmatter), revisionHash, now, note.id);
     upsertWikiSearchRow({
         ...note,
-        sourcePath: filePath,
+        sourcePath: "",
         frontmatter,
         revisionHash,
         lastSyncedAt: now
     });
     rebuildWikiLinkEdges({
         ...note,
-        sourcePath: filePath,
+        sourcePath: "",
         frontmatter,
         revisionHash,
         lastSyncedAt: now
     });
-    syncWikiSpaceIndex(space.id);
 }
 export function deleteNoteWikiArtifacts(note) {
-    if (note.sourcePath && existsSync(note.sourcePath)) {
-        rmSync(note.sourcePath, { force: true });
-    }
     deleteWikiSearchRow(note.id);
     getDatabase()
         .prepare(`DELETE FROM wiki_link_edges WHERE source_note_id = ?`)
@@ -1433,66 +1400,6 @@ export function deleteNoteWikiArtifacts(note) {
     getDatabase()
         .prepare(`DELETE FROM wiki_media_assets WHERE note_id = ? OR transcript_note_id = ?`)
         .run(note.id, note.id);
-    syncWikiSpaceIndex(note.spaceId);
-}
-function buildWikiIndexMarkdown(space, pages) {
-    const wikiPages = [...pages]
-        .filter((page) => page.kind === "wiki")
-        .sort((left, right) => left.parentSlug === right.parentSlug
-        ? left.indexOrder - right.indexOrder ||
-            left.title.localeCompare(right.title)
-        : (left.parentSlug ?? "").localeCompare(right.parentSlug ?? ""));
-    const evidencePages = [...pages]
-        .filter((page) => page.kind === "evidence")
-        .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
-    const lines = [
-        `# ${space.label}`,
-        "",
-        "Explicit Forge wiki index generated from the local vault.",
-        "",
-        "## How To Use",
-        "",
-        "- Start here when an agent needs a crawlable catalog of the space.",
-        "- `pages/` contains durable wiki articles.",
-        "- `evidence/` contains shorter notes and work traces.",
-        "- `raw/` contains imported source material for future recompilation.",
-        "",
-        `Generated at ${nowIso()}.`,
-        "",
-        "## Wiki Index",
-        ""
-    ];
-    if (wikiPages.length === 0) {
-        lines.push("_No wiki pages yet._", "");
-    }
-    else {
-        for (const page of wikiPages) {
-            const depth = page.parentSlug ? 1 : 0;
-            const prefix = `${"  ".repeat(depth)}- `;
-            lines.push(`${prefix}[[${page.slug}]]${page.summary ? ` - ${page.summary}` : ""}`);
-        }
-        lines.push("");
-    }
-    lines.push("## Evidence Pages", "");
-    if (evidencePages.length === 0) {
-        lines.push("_No evidence pages yet._", "");
-    }
-    else {
-        for (const page of evidencePages.slice(0, 200)) {
-            lines.push(`- [[${page.slug}]]${page.summary ? ` - ${page.summary}` : ""}`);
-        }
-        lines.push("");
-    }
-    return `${lines.join("\n")}\n`;
-}
-function syncWikiSpaceIndex(spaceId) {
-    const space = getWikiSpaceById(spaceId) ?? ensureSharedWikiSpace();
-    const rootDir = getSpaceStorageDir(space);
-    mkdirSync(path.join(rootDir, "pages"), { recursive: true });
-    mkdirSync(path.join(rootDir, "evidence"), { recursive: true });
-    mkdirSync(path.join(rootDir, "assets"), { recursive: true });
-    mkdirSync(path.join(rootDir, "raw"), { recursive: true });
-    writeFileSync(getSpaceIndexPath(space), buildWikiIndexMarkdown(space, listWikiPages({ spaceId, limit: 10_000 })), "utf8");
 }
 function upsertWikiSearchRow(note) {
     deleteWikiSearchRow(note.id);
@@ -1710,92 +1617,13 @@ export async function syncWikiVaultFromDisk(input) {
         : listWikiSpaces();
     let updated = 0;
     for (const space of spaces) {
-        for (const directoryName of ["pages", "evidence"]) {
-            const directory = path.join(getSpaceStorageDir(space), directoryName);
-            try {
-                const entries = await readdir(directory);
-                for (const entry of entries) {
-                    if (!entry.endsWith(".md")) {
-                        continue;
-                    }
-                    const filePath = path.join(directory, entry);
-                    const content = await readFile(filePath, "utf8");
-                    const parsedFile = parseFrontmatter(content);
-                    const noteId = typeof parsedFile.frontmatter.id === "string"
-                        ? parsedFile.frontmatter.id
-                        : null;
-                    if (!noteId) {
-                        continue;
-                    }
-                    const existing = getNoteByIdRaw(noteId);
-                    if (!existing) {
-                        continue;
-                    }
-                    const markdown = parsedFile.body.trim();
-                    const contentPlain = buildContentPlain(markdown);
-                    const title = typeof parsedFile.frontmatter.title === "string"
-                        ? parsedFile.frontmatter.title
-                        : inferTitle(markdown, existing.title);
-                    const aliases = normalizeAliases(Array.isArray(parsedFile.frontmatter.aliases)
-                        ? parsedFile.frontmatter.aliases.filter((entry) => typeof entry === "string")
-                        : []);
-                    const summary = typeof parsedFile.frontmatter.summary === "string"
-                        ? parsedFile.frontmatter.summary
-                        : inferSummary(markdown);
-                    const payload = `${renderFrontmatter(parsedFile.frontmatter)}${markdown}\n`;
-                    const revisionHash = hashContent(payload);
-                    const now = nowIso();
-                    getDatabase()
-                        .prepare(`UPDATE notes
-               SET title = ?, slug = ?, kind = ?, space_id = ?, parent_slug = ?, index_order = ?, show_in_index = ?, aliases_json = ?, summary = ?, content_markdown = ?, content_plain = ?,
-                   source_path = ?, frontmatter_json = ?, revision_hash = ?, last_synced_at = ?, updated_at = ?
-               WHERE id = ?`)
-                        .run(title, typeof parsedFile.frontmatter.slug === "string"
-                        ? parsedFile.frontmatter.slug
-                        : existing.slug, directoryName === "pages" ? "wiki" : "evidence", space.id, typeof parsedFile.frontmatter.parentSlug === "string"
-                        ? parsedFile.frontmatter.parentSlug
-                        : existing.parent_slug, typeof parsedFile.frontmatter.indexOrder === "number"
-                        ? Math.trunc(parsedFile.frontmatter.indexOrder)
-                        : existing.index_order, parsedFile.frontmatter.showInIndex === false ? 0 : 1, JSON.stringify(aliases), summary, markdown, contentPlain, filePath, JSON.stringify(parsedFile.frontmatter), revisionHash, now, now, noteId);
-                    const note = mapNoteRow(getNoteByIdRaw(noteId), listLinkRowsForNotes([noteId]));
-                    upsertWikiSearchRow(note);
-                    rebuildWikiLinkEdges(note);
-                    updated += 1;
-                }
-            }
-            catch {
-                continue;
-            }
+        for (const note of listWikiPages({ spaceId: space.id, limit: 10_000 })) {
+            syncNoteWikiArtifacts(note);
+            updated += 1;
         }
-        syncWikiSpaceIndex(space.id);
     }
     return { updated };
 }
-function parseFrontmatter(markdown) {
-    const match = markdown.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
-    if (!match) {
-        return { frontmatter: {}, body: markdown };
-    }
-    const frontmatter = {};
-    for (const line of match[1].split("\n")) {
-        const separatorIndex = line.indexOf(":");
-        if (separatorIndex <= 0) {
-            continue;
-        }
-        const key = line.slice(0, separatorIndex).trim();
-        const rawValue = line.slice(separatorIndex + 1).trim();
-        if (!key) {
-            continue;
-        }
-        try {
-            frontmatter[key] = JSON.parse(rawValue);
-        }
-        catch {
-            frontmatter[key] = rawValue.replace(/^"(.*)"$/, "$1");
-        }
-    }
-    return { frontmatter, body: match[2] };
-}
 function findMatchingWikiNoteIds(query) {
     const ftsQuery = buildWikiFtsQuery(query);
     if (!ftsQuery) {
@@ -1953,8 +1781,6 @@ export function getWikiHealth(input = {}) {
     const pages = listWikiPages({ spaceId, limit: 10_000 });
     const noteIds = pages.map((page) => page.id);
     const noteIdSet = new Set(noteIds);
-    const rootDir = getSpaceStorageDir(space);
-    const indexPath = getSpaceIndexPath(space);
     const rawDirectoryPath = getSpaceRawDir(space);
     const edgeRows = getDatabase()
         .prepare(`SELECT e.source_note_id, e.target_type, e.target_note_id, e.raw_target, e.updated_at, n.slug AS source_slug, n.title AS source_title
@@ -1994,7 +1820,7 @@ export function getWikiHealth(input = {}) {
         .get(spaceId).count;
     return wikiHealthPayloadSchema.parse({
         space,
-        indexPath,
+        indexPath: "",
         rawDirectoryPath,
         pageCount: pages.length,
         wikiPageCount: pages.filter((page) => page.kind === "wiki").length,

package/dist/server/server/src/services/data-management.js

@@ -430,10 +430,6 @@ export async function createDataBackup(input = { note: "" }, options = {}) {
             current: snapshot
         }, null, 2), "utf8"));
         const currentRoot = getEffectiveDataRoot();
-        const wikiPath = path.join(currentRoot, "wiki");
-        if (existsSync(wikiPath)) {
-            zip.addLocalFolder(wikiPath, "wiki");
-        }
         const wikiIngestPath = path.join(currentRoot, "wiki-ingest");
         if (existsSync(wikiIngestPath)) {
             zip.addLocalFolder(wikiIngestPath, "wiki-ingest");
@@ -455,7 +451,7 @@ export async function createDataBackup(input = { note: "" }, options = {}) {
             manifestPath,
             databasePath: snapshot.databasePath,
             sizeBytes: archiveStat.size,
-            includesWiki: existsSync(wikiPath),
+            includesWiki: false,
             includesSecretsKey: existsSync(secretsKeyPath),
             counts: snapshot.counts
         });
@@ -596,7 +592,6 @@ function runtimeAssetPaths(dataRoot) {
     return {
         dataRoot: resolvedRoot,
         databasePath: resolveDatabasePathForDataRoot(resolvedRoot),
-        wikiPath: path.join(resolvedRoot, "wiki"),
         wikiIngestPath: path.join(resolvedRoot, "wiki-ingest"),
         secretsKeyPath: path.join(resolvedRoot, ".forge-secrets.key")
     };
@@ -605,11 +600,10 @@ async function copyRuntimeAssets(sourceRoot, targetRoot) {
     const source = runtimeAssetPaths(sourceRoot);
     const target = runtimeAssetPaths(targetRoot);
     await mkdir(target.dataRoot, { recursive: true });
-    if (existsSync(target.databasePath) || existsSync(target.wikiPath) || existsSync(target.secretsKeyPath)) {
+    if (existsSync(target.databasePath) || existsSync(target.secretsKeyPath)) {
         throw new HttpError(409, "target_data_root_not_empty", `Forge found existing runtime data under ${target.dataRoot}. Pick another folder or adopt the existing runtime instead.`);
     }
     await copyIfExists(source.databasePath, target.databasePath);
-    await copyIfExists(source.wikiPath, target.wikiPath);
     await copyIfExists(source.wikiIngestPath, target.wikiIngestPath);
     await copyIfExists(source.secretsKeyPath, target.secretsKeyPath);
 }
@@ -685,7 +679,6 @@ export async function restoreDataBackup(backupId, input, options = {}) {
             await removeIfExists(path.join(currentRoot, ".forge-secrets.key"));
         }
         await copyIfExists(restoredDatabasePath, path.join(currentRoot, "forge.sqlite"));
-        await copyIfExists(path.join(tempDir, "wiki"), path.join(currentRoot, "wiki"));
         await copyIfExists(path.join(tempDir, "wiki-ingest"), path.join(currentRoot, "wiki-ingest"));
         await copyIfExists(restoredSecretsPath, path.join(currentRoot, ".forge-secrets.key"));
         await applyRuntimeRootSwitch(currentRoot, options.secretsManager);

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "forge-openclaw-plugin",
   "name": "Forge",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
-  "version": "0.2.49",
+  "version": "0.2.50",
   "skills": [
     "./skills"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-openclaw-plugin",
-  "version": "0.2.49",
+  "version": "0.2.50",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
   "type": "module",
   "license": "MIT",

package/server/migrations/019_wiki_memory.sql

@@ -57,7 +57,7 @@ VALUES (
   'wiki_space_shared',
   'shared',
   'Shared Forge Memory',
-  'Shared wiki space for file-backed Forge knowledge.',
+  'Shared wiki space for SQLite-backed Forge knowledge.',
   NULL,
   'shared',
   CURRENT_TIMESTAMP,

package/server/migrations/054_sqlite_backed_wiki_memory.sql

@@ -0,0 +1,8 @@
+UPDATE wiki_spaces
+SET description = 'Shared wiki space for SQLite-backed Forge knowledge.'
+WHERE id = 'wiki_space_shared'
+  AND description != 'Shared wiki space for SQLite-backed Forge knowledge.';
+
+UPDATE notes
+SET source_path = ''
+WHERE source_path != '';

package/skills/forge-openclaw/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: forge-openclaw
+name: forge-openclaw-plugin
 description: use when the user wants to save, search, update, review, start, stop, reward, explain, compare, or run Forge records, or when the conversation is clearly about a Forge entity such as a goal, project, strategy, task, habit, note, calendar_event, work_block_template, task_timebox, task_run, insight, preference item, preference context, preference catalog, questionnaire instrument, questionnaire run, self observation, psyche_value, behavior_pattern, behavior, belief_entry, mode_profile, mode_guide_session, trigger_report, event_type, emotion_definition, sleep_session, or workout_session. identify the exact Forge object, keep the main conversation natural, guide psyche intake with active listening before storing it, and for psyche issues that need understanding first usually begin with one exploratory question before any formulation or save suggestion.
 ---
 
@@ -59,7 +59,7 @@ PM surface rule:
   human/bot ownership filters.
 - Guided modal flows handle create, edit, move, link, and closeout actions.
 
-Forge has four major surfaces. The planning side covers goals, projects, strategies, tasks, habits, notes, calendar events, recurring work blocks, task timeboxes, live work sessions, and agent-authored insights. The Health side covers sleep sessions, sports and workout sessions, companion pairing, and habit-generated workout records that should still stay linked to the broader Forge graph. The Preferences side covers contextual taste modeling, pairwise comparisons, direct signals, editable concept libraries, and preference items that can come from Forge entities or seeded concept domains such as food, activities, places, countries, fashion, people, media, and tools. The Psyche side covers values, patterns, behaviors, beliefs, modes, guided mode sessions, trigger reports, event types, and reusable emotion definitions. Forge also has a file-first Wiki memory layer with explicit spaces, local markdown pages, backlinks, optional embeddings, and structured links back to Forge entities. Forge is also multi-user: every entity can belong to a typed `human` or `bot` user through `userId`, and read routes can scope to one or many users with `userId` or repeated `userIds`. The current access posture is configurable through a directional user graph, but the live default is still permissive: Forge can list users directly, every relationship edge starts open, and a user can read or affect another user's linked records when the route explicitly asks for them. Use `forge_get_user_directory` when owner identity or cross-user access matters. Strategies can also be locked into a contract with `isLocked`; once locked, do not mutate the graph or target structure unless the user explicitly wants the strategy unlocked first. The model should use the real entity names, not vague substitutes. Say `project`, not “initiative”. Say `behavior_pattern`, not “theme”. Say `trigger_report`, not “incident note”.
+Forge has four major surfaces. The planning side covers goals, projects, strategies, tasks, habits, notes, calendar events, recurring work blocks, task timeboxes, live work sessions, and agent-authored insights. The Health side covers sleep sessions, sports and workout sessions, companion pairing, and habit-generated workout records that should still stay linked to the broader Forge graph. The Preferences side covers contextual taste modeling, pairwise comparisons, direct signals, editable concept libraries, and preference items that can come from Forge entities or seeded concept domains such as food, activities, places, countries, fashion, people, media, and tools. The Psyche side covers values, patterns, behaviors, beliefs, modes, guided mode sessions, trigger reports, event types, and reusable emotion definitions. Forge also has a SQLite-backed Wiki memory layer with explicit spaces, Markdown content in database rows, backlinks, optional embeddings, and structured links back to Forge entities. Forge is also multi-user: every entity can belong to a typed `human` or `bot` user through `userId`, and read routes can scope to one or many users with `userId` or repeated `userIds`. The current access posture is configurable through a directional user graph, but the live default is still permissive: Forge can list users directly, every relationship edge starts open, and a user can read or affect another user's linked records when the route explicitly asks for them. Use `forge_get_user_directory` when owner identity or cross-user access matters. Strategies can also be locked into a contract with `isLocked`; once locked, do not mutate the graph or target structure unless the user explicitly wants the strategy unlocked first. The model should use the real entity names, not vague substitutes. Say `project`, not “initiative”. Say `behavior_pattern`, not “theme”. Say `trigger_report`, not “incident note”.
 Habits are a first-class recurring entity in the planning side.
 NEGATIVE HABIT CHECK-IN RULE: for a `negative` habit, the correct aligned/resisted outcome is `missed`. `missed` means the bad habit was resisted, the user stayed aligned, and the habit should award its XP bonus.
 
@@ -74,9 +74,9 @@ Preferences rule:
 Wiki rule:
 
 - Treat the Wiki as the canonical long-form memory surface, not as a loose note dump.
-- Use the wiki tools when the user wants file-first reference pages, backlink-aware recall, ingest from a URL or local file, or wiki maintenance work such as unresolved-link cleanup.
+- Use the wiki tools when the user wants SQLite-backed reference pages, backlink-aware recall, ingest from a URL or local file, or wiki maintenance work such as unresolved-link cleanup.
 - `forge_ingest_wiki_source` now queues the ingest as background work; use the Forge UI handoff when the user wants to review or keep only selected wiki/entity candidates after the ingest finishes.
-- Keep evidence notes and wiki pages conceptually distinct: evidence notes are linked operating records, while wiki pages are the curated memory vault.
+- Keep evidence notes and wiki pages conceptually distinct: evidence notes are linked operating records, while wiki pages are curated long-form memory.
 
 Wiki navigation and search rule:
 
@@ -90,7 +90,7 @@ Wiki navigation and search rule:
 - Use `forge_search_wiki` as the default wiki recall tool. It is the main route for people, conversations, concepts, and exact page lookup.
 - Use `forge_list_wiki_pages` when the user wants to browse structure, inspect a branch, or understand how pages are organized rather than search by phrase.
 - Use `forge_get_wiki_page` after search yields a likely hit, or when the user already identified the page to open.
-- Use `forge_get_wiki_settings` or `forge_get_wiki_health` when the task is about wiki maintenance, indexing, unresolved links, ingest setup, or vault integrity rather than content recall.
+- Use `forge_get_wiki_settings` or `forge_get_wiki_health` when the task is about wiki maintenance, indexing, unresolved links, ingest setup, or memory integrity rather than content recall.
 
 Health rule:
 
@@ -353,7 +353,7 @@ Use the batch entity tools for stored records:
 These tools operate on:
 `goal`, `project`, `strategy`, `task`, `habit`, `tag`, `note`, `insight`, `calendar_event`, `work_block_template`, `task_timebox`, `psyche_value`, `behavior_pattern`, `behavior`, `belief_entry`, `mode_profile`, `mode_guide_session`, `trigger_report`, `event_type`, `emotion_definition`, `preference_catalog`, `preference_catalog_item`, `preference_context`, `preference_item`, `questionnaire_instrument`, `sleep_session`, `workout_session`
 
-Use the wiki tools for file-first memory work:
+Use the wiki tools for SQLite-backed memory work:
 `forge_get_wiki_settings`, `forge_list_wiki_pages`, `forge_get_wiki_page`, `forge_search_wiki`, `forge_upsert_wiki_page`, `forge_get_wiki_health`, `forge_sync_wiki_vault`, `forge_reindex_wiki_embeddings`, `forge_ingest_wiki_source`
 
 Use the health tools for review and reflective enrichment, not as the default CRUD architecture:

package/skills/forge-openclaw/entity_conversation_playbooks.md

@@ -63,6 +63,11 @@ Forge correctly, and gather only the structure that still matters.
   and then act.
 - Once the route family is clear, say it plainly enough that another agent could follow
   the same path without guessing.
+- For updates, start with the smallest thing that now feels wrong, newly true, or
+  newly visible. Do not make the user retell the whole record unless the change is
+  genuinely structural.
+- For review requests, ask what practical question they want the read to answer before
+  you ask for more scope.
 - For meaning-bearing updates, especially in Psyche-adjacent work, briefly say what
   feels newly true before you ask for the one structural detail that still changes the
   save.
@@ -222,6 +227,31 @@ When you are about to save:
   enough or needs one correction
 - if the user confirms it, stop asking and save
 
+## Update And Review Shortcuts
+
+Use these when the user is correcting, reviewing, or tightening something that already
+exists.
+
+- When the user already gave the correction in usable language, reflect what still
+  seems true, then ask only for the one thing that no longer fits.
+- A good narrow update line is:
+  "I can stay narrow here. What is the one thing that no longer fits?"
+- When the user is revising placement, timing, or ownership rather than meaning, do
+  not reopen the whole story. Confirm only the parent, interval, owner, or route scope
+  that changes the write.
+- When the record is abstract or reusable and the user wants an update, ask what
+  future decision, comparison, or retrieval moment got muddy with the old wording.
+- When the user wants review rather than mutation, ask what answer they need from the
+  read:
+  what this would help them decide later is often the clearest scope signal.
+- For specialized surfaces, ask what exact saved object, span, weekday, flow, run, or
+  node the user wants to check before you ask why it matters.
+- If the next answer would not change the route, wording, timing, links, or useful
+  interpretation, stop asking and act.
+- Close cleanly:
+  once the user says the wording or route lands, summarize once and move to the read
+  or write.
+
 When an adjacent record becomes visible:
 
 - name it gently and ask whether it should be linked now, saved separately later, or

package/skills/forge-openclaw/psyche_entity_playbooks.md

@@ -72,6 +72,10 @@ Forge without turning the conversation into a worksheet.
   container first and hold the others lightly until the user wants to map them.
 - When the user has said enough for an accurate working formulation, stop deepening and
   help them name it cleanly.
+- For Psyche updates, begin with the smallest part of the old wording that no longer
+  fits instead of reopening the whole formulation immediately.
+- Do not reopen the full origin story when the update is really about one changed
+  meaning, one newly visible protection, or one new sentence the user can already say.
 
 ## First reflection menu
 
@@ -193,6 +197,23 @@ opening:
 - one missing-detail question
 - then move toward the write instead of forcing exploration
 
+## Update micro-openers
+
+Use these when the user is revising an existing Psyche record and the tone should stay
+therapist-like without becoming expansive again.
+
+- "Something about the old wording no longer holds the whole experience. What felt
+  different in the moment that made that visible?"
+- "The old name was trying to protect something real. What part of the recent episode
+  made it feel too small or off?"
+- "It sounds like the same pain, but not quite the same meaning. What changed in what
+  it started to say?"
+- If the user already gave the new sentence in usable language, reflect it once, ask
+  what part of the old wording it replaces, and then save.
+- If the user wants review rather than storage, ask whether they need clearer
+  language, better understanding, or next-step help before you reopen the whole
+  formulation.
+
 ## Therapeutic turn shapes
 
 Keep the pacing human and intentional.