forge-openclaw-plugin 0.2.7 → 0.2.10

package/dist/server/services/entity-crud.js

@@ -1,14 +1,14 @@
 import { getDatabase, runInTransaction } from "../db.js";
-import { deleteComment, getCommentById, listComments, updateComment, createComment } from "../repositories/comments.js";
 import { createInsight, deleteInsight, getInsightById, listInsights, updateInsight } from "../repositories/collaboration.js";
-import { createBehaviorPatternSchema, createBehaviorSchema, createBeliefEntrySchema, createCommentSchema, createEmotionDefinitionSchema, createEventTypeSchema, createModeGuideSessionSchema, createModeProfileSchema, createPsycheValueSchema, createTriggerReportSchema, updateBehaviorPatternSchema, updateBehaviorSchema, updateBeliefEntrySchema, updateCommentSchema, updateEmotionDefinitionSchema, updateEventTypeSchema, updateModeGuideSessionSchema, updateModeProfileSchema, updatePsycheValueSchema, updateTriggerReportSchema } from "../psyche-types.js";
+import { createNote, deleteNote, getNoteById, listNotes, unlinkNotesForEntity, updateNote } from "../repositories/notes.js";
+import { createBehaviorPatternSchema, createBehaviorSchema, createBeliefEntrySchema, createEmotionDefinitionSchema, createEventTypeSchema, createModeGuideSessionSchema, createModeProfileSchema, createPsycheValueSchema, createTriggerReportSchema, updateBehaviorPatternSchema, updateBehaviorSchema, updateBeliefEntrySchema, updateEmotionDefinitionSchema, updateEventTypeSchema, updateModeGuideSessionSchema, updateModeProfileSchema, updatePsycheValueSchema, updateTriggerReportSchema } from "../psyche-types.js";
 import { buildSettingsBinPayload, cascadeSoftDeleteAnchoredCollaboration, clearDeletedEntityRecord, getDeletedEntityRecord, listDeletedEntities, restoreAnchoredCollaboration, restoreDeletedEntityRecord, upsertDeletedEntityRecord } from "../repositories/deleted-entities.js";
 import { createGoal, deleteGoal, getGoalById, listGoals, updateGoal } from "../repositories/goals.js";
 import { createBehavior, createBehaviorPattern, createBeliefEntry, createEmotionDefinition, createEventType, createModeGuideSession, createModeProfile, createPsycheValue, createTriggerReport, deleteBehavior, deleteBehaviorPattern, deleteBeliefEntry, deleteEmotionDefinition, deleteEventType, deleteModeGuideSession, deleteModeProfile, deletePsycheValue, deleteTriggerReport, getBehaviorById, getBehaviorPatternById, getBeliefEntryById, getEmotionDefinitionById, getEventTypeById, getModeGuideSessionById, getModeProfileById, getPsycheValueById, getTriggerReportById, listBehaviors, listBehaviorPatterns, listBeliefEntries, listEmotionDefinitions, listEventTypes, listModeGuideSessions, listModeProfiles, listPsycheValues, listTriggerReports, updateBehavior, updateBehaviorPattern, updateBeliefEntry, updateEmotionDefinition, updateEventType, updateModeGuideSession, updateModeProfile, updatePsycheValue, updateTriggerReport } from "../repositories/psyche.js";
 import { createProject, deleteProject, getProjectById, listProjects, updateProject } from "../repositories/projects.js";
 import { createTag, deleteTag, getTagById, listTags, updateTag } from "../repositories/tags.js";
 import { createTask, deleteTask, getTaskById, listTasks, updateTask } from "../repositories/tasks.js";
-import { createGoalSchema, createInsightSchema, createProjectSchema, createTagSchema, createTaskSchema, updateGoalSchema, updateInsightSchema, updateProjectSchema, updateTagSchema, updateTaskSchema } from "../types.js";
+import { createGoalSchema, createInsightSchema, createNoteSchema, createProjectSchema, createTagSchema, createTaskSchema, updateGoalSchema, updateInsightSchema, updateNoteSchema, updateProjectSchema, updateTagSchema, updateTaskSchema } from "../types.js";
 class AtomicBatchRollback extends Error {
     index;
     code;
@@ -58,14 +58,14 @@ const CRUD_ENTITY_CAPABILITIES = {
         update: (id, patch, context) => updateTag(id, patch, context),
         hardDelete: (id, context) => deleteTag(id, context)
     },
-    comment: {
-        entityType: "comment",
-        routeBase: "/api/v1/comments",
-        list: () => listComments(),
-        get: (id) => getCommentById(id),
-        create: (data, context) => createComment(data, context),
-        update: (id, patch, context) => updateComment(id, patch, context),
-        hardDelete: (id, context) => deleteComment(id, context)
+    note: {
+        entityType: "note",
+        routeBase: "/api/v1/notes",
+        list: () => listNotes(),
+        get: (id) => getNoteById(id),
+        create: (data, context) => createNote(data, context),
+        update: (id, patch, context) => updateNote(id, patch, context),
+        hardDelete: (id, context) => deleteNote(id, context)
     },
     insight: {
         entityType: "insight",
@@ -175,7 +175,7 @@ const CREATE_ENTITY_SCHEMAS = {
     project: createProjectSchema,
     task: createTaskSchema,
     tag: createTagSchema,
-    comment: createCommentSchema,
+    note: createNoteSchema,
     insight: createInsightSchema,
     psyche_value: createPsycheValueSchema,
     behavior_pattern: createBehaviorPatternSchema,
@@ -192,7 +192,7 @@ const UPDATE_ENTITY_SCHEMAS = {
     project: updateProjectSchema,
     task: updateTaskSchema,
     tag: updateTagSchema,
-    comment: updateCommentSchema,
+    note: updateNoteSchema,
     insight: updateInsightSchema,
     psyche_value: updatePsycheValueSchema,
     behavior_pattern: updateBehaviorPatternSchema,
@@ -312,7 +312,14 @@ function matchesLinkedTo(entityType, entity, linkedTo) {
             return linkedTo.entityType === "goal" && entity.goalId === linkedTo.id;
         case "task":
             return (linkedTo.entityType === "goal" && entity.goalId === linkedTo.id) || (linkedTo.entityType === "project" && entity.projectId === linkedTo.id);
-        case "comment":
+        case "note":
+            return (Array.isArray(entity.links) &&
+                entity.links.some((link) => typeof link === "object" &&
+                    link !== null &&
+                    "entityType" in link &&
+                    "entityId" in link &&
+                    link.entityType === linkedTo.entityType &&
+                    link.entityId === linkedTo.id));
         case "insight":
             return entity.entityType === linkedTo.entityType && entity.entityId === linkedTo.id;
         case "psyche_value":
@@ -378,18 +385,7 @@ function purgeAnchoredCollaboration(entityType, entityId) {
             .prepare(`DELETE FROM deleted_entities WHERE entity_type = 'insight' AND entity_id IN (${placeholders})`)
             .run(...insightIds.map((row) => row.id));
     }
-    const commentIds = getDatabase()
-        .prepare(`SELECT id FROM entity_comments WHERE entity_type = ? AND entity_id = ?`)
-        .all(entityType, entityId);
-    if (commentIds.length > 0) {
-        const placeholders = commentIds.map(() => "?").join(", ");
-        getDatabase()
-            .prepare(`DELETE FROM entity_comments WHERE id IN (${placeholders})`)
-            .run(...commentIds.map((row) => row.id));
-        getDatabase()
-            .prepare(`DELETE FROM deleted_entities WHERE entity_type = 'comment' AND entity_id IN (${placeholders})`)
-            .run(...commentIds.map((row) => row.id));
-    }
+    unlinkNotesForEntity(entityType, entityId, { source: "system", actor: null });
 }
 export function deleteEntity(entityType, id, options, context) {
     const capability = getCapability(entityType);
@@ -417,13 +413,13 @@ export function deleteEntity(entityType, id, options, context) {
                 deleteReason: options.reason ?? "",
                 context
             });
-            if (entityType !== "comment" && entityType !== "insight") {
+            if (entityType !== "note" && entityType !== "insight") {
                 cascadeSoftDeleteAnchoredCollaboration(entityType, id, context, options.reason ?? "");
             }
             return entity;
         }
         clearDeletedEntityRecord(entityType, id);
-        if (entityType !== "comment" && entityType !== "insight") {
+        if (entityType !== "note" && entityType !== "insight") {
             purgeAnchoredCollaboration(entityType, id);
         }
         const deleted = capability.hardDelete(id, context);
@@ -437,7 +433,7 @@ export function restoreEntity(entityType, id) {
         if (!deleted) {
             return undefined;
         }
-        if (entityType !== "comment" && entityType !== "insight") {
+        if (entityType !== "note" && entityType !== "insight") {
             restoreAnchoredCollaboration(entityType, id);
         }
         return getCapability(entityType).get(id) ?? deleted.snapshot;
@@ -539,9 +535,10 @@ export function restoreEntities(input) {
 }
 export function searchEntities(input) {
     const deleted = listDeletedEntities();
+    const defaultEntityTypes = Object.keys(CRUD_ENTITY_CAPABILITIES);
     return {
         results: input.searches.map((search) => {
-            const entityTypes = search.entityTypes && search.entityTypes.length > 0 ? search.entityTypes : Object.keys(CRUD_ENTITY_CAPABILITIES);
+            const entityTypes = search.entityTypes && search.entityTypes.length > 0 ? search.entityTypes : defaultEntityTypes;
             const liveMatches = entityTypes.flatMap((entityType) => getCapability(entityType)
                 .list()
                 .filter((entity) => (search.ids && search.ids.length > 0 ? search.ids.includes(String(entity.id ?? "")) : true))

package/dist/server/services/insights.js

@@ -71,16 +71,16 @@ export function getInsightsPayload(now = new Date()) {
         executionTrends: trends,
         domainBalance,
         coaching: {
-            title: hottestGoal ? `Protect ${hottestGoal.title}` : "Rebuild momentum",
+            title: hottestGoal ? `Protect progress on ${hottestGoal.title}` : "Rebuild momentum",
             summary: blockedTasks > 0
-                ? `${blockedTasks} blocked task${blockedTasks === 1 ? "" : "s"} are leaking velocity out of the system.`
+                ? `${blockedTasks} blocked task${blockedTasks === 1 ? "" : "s"} are slowing active work across Forge right now.`
                 : overdueTasks > 0
-                    ? `${overdueTasks} overdue task${overdueTasks === 1 ? "" : "s"} are the main drag vector right now.`
+                    ? `${overdueTasks} overdue task${overdueTasks === 1 ? "" : "s"} are creating the biggest execution drag right now.`
                     : "Recent evidence shows enough movement to push the next arc more aggressively.",
             recommendation: blockedTasks > 0
-                ? "Clear one blocked task before adding more new work."
+                ? "Clear one blocked task before adding more new work so the active lane can move again."
                 : hottestGoal
-                    ? `Queue the next decisive move for ${hottestGoal.title} and keep a deep-work lane active.`
+                    ? `Create or schedule the next concrete move under ${hottestGoal.title}, then protect one deep-work lane to carry it forward this week.`
                     : "Pick one life goal, one project, and one task to stabilize the next 24 hours.",
             ctaLabel: "Trigger coaching insight"
         },

package/dist/server/services/projects.js

@@ -1,5 +1,6 @@
 import { listActivityEvents } from "../repositories/activity-events.js";
 import { getGoalById, listGoals } from "../repositories/goals.js";
+import { buildNotesSummaryByEntity } from "../repositories/notes.js";
 import { listProjects } from "../repositories/projects.js";
 import { listTasks } from "../repositories/tasks.js";
 import { emptyTaskTimeSummary } from "./work-time.js";
@@ -70,6 +71,7 @@ export function getProjectBoard(projectId) {
         project,
         goal,
         tasks: listTasks({ projectId }),
-        activity: listActivityEvents({ entityType: "project", entityId: projectId, limit: 20 }).concat(listActivityEvents({ entityType: "task", limit: 100 }).filter((event) => listTasks({ projectId }).some((task) => task.id === event.entityId)).slice(0, 20))
+        activity: listActivityEvents({ entityType: "project", entityId: projectId, limit: 20 }).concat(listActivityEvents({ entityType: "task", limit: 100 }).filter((event) => listTasks({ projectId }).some((task) => task.id === event.entityId)).slice(0, 20)),
+        notesSummaryByEntity: buildNotesSummaryByEntity()
     });
 }

package/dist/server/services/psyche.js

@@ -1,6 +1,6 @@
 import { getDomainBySlug } from "../repositories/domains.js";
-import { listComments } from "../repositories/comments.js";
 import { listInsights } from "../repositories/collaboration.js";
+import { listNotes } from "../repositories/notes.js";
 import { listBehaviorPatterns, listBehaviors, listBeliefEntries, listModeProfiles, listPsycheValues, listSchemaCatalog, listTriggerReports } from "../repositories/psyche.js";
 import { psycheOverviewPayloadSchema } from "../psyche-types.js";
 const PSYCHE_ENTITY_TYPE_SET = new Set([
@@ -23,9 +23,9 @@ export function getPsycheOverview() {
     const modes = listModeProfiles();
     const reports = listTriggerReports(5);
     const schemaCatalog = listSchemaCatalog();
-    const comments = listComments({ limit: 200 });
+    const notes = listNotes({ limit: 200 });
     const openInsights = listInsights({ limit: 100 }).filter((insight) => insight.entityType && PSYCHE_ENTITY_TYPE_SET.has(insight.entityType)).length;
-    const unresolvedComments = comments.filter((comment) => PSYCHE_ENTITY_TYPE_SET.has(comment.entityType)).length;
+    const openNotes = notes.filter((note) => note.links.some((link) => PSYCHE_ENTITY_TYPE_SET.has(link.entityType))).length;
     const committedActions = [
         ...values.flatMap((value) => value.committedActions),
         ...behaviors.filter((behavior) => behavior.kind === "committed").map((behavior) => behavior.title),
@@ -57,7 +57,7 @@ export function getPsycheOverview() {
         reports,
         schemaPressure,
         openInsights,
-        unresolvedComments,
+        openNotes,
         committedActions
     });
 }

package/dist/server/types.js

@@ -21,8 +21,9 @@ export const activityEntityTypeSchema = z.enum([
     "behavior",
     "belief_entry",
     "mode_profile",
+    "mode_guide_session",
     "trigger_report",
-    "comment",
+    "note",
     "event_type",
     "emotion_definition",
     "tag",
@@ -50,7 +51,7 @@ export const crudEntityTypeSchema = z.enum([
     "project",
     "task",
     "tag",
-    "comment",
+    "note",
     "insight",
     "psyche_value",
     "behavior_pattern",
@@ -121,6 +122,27 @@ export const taskTimeSummarySchema = z.object({
     hasCurrentRun: z.boolean(),
     currentRunId: z.string().nullable()
 });
+export const noteLinkSchema = z.object({
+    entityType: crudEntityTypeSchema,
+    entityId: nonEmptyTrimmedString,
+    anchorKey: trimmedString.nullable().default(null)
+});
+export const noteSchema = z.object({
+    id: z.string(),
+    contentMarkdown: nonEmptyTrimmedString,
+    contentPlain: trimmedString,
+    author: z.string().nullable(),
+    source: activitySourceSchema,
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    links: z.array(noteLinkSchema).min(1)
+});
+export const noteSummarySchema = z.object({
+    count: z.number().int().nonnegative(),
+    latestNoteId: z.string().nullable(),
+    latestCreatedAt: z.string().nullable()
+});
+export const notesSummaryByEntitySchema = z.record(z.string(), noteSummarySchema);
 export const goalSchema = z.object({
     id: z.string(),
     title: nonEmptyTrimmedString,
@@ -299,7 +321,8 @@ export const dashboardPayloadSchema = z.object({
     gamification: gamificationProfileSchema,
     achievements: z.array(achievementSignalSchema),
     milestoneRewards: z.array(milestoneRewardSchema),
-    recentActivity: z.array(activityEventSchema)
+    recentActivity: z.array(activityEventSchema),
+    notesSummaryByEntity: notesSummaryByEntitySchema.default({})
 });
 export const contextDomainBalanceSchema = z.object({
     tagId: z.string(),
@@ -379,13 +402,15 @@ export const taskContextPayloadSchema = z.object({
     project: projectSummarySchema.nullable(),
     activeTaskRun: taskRunSchema.nullable(),
     taskRuns: z.array(taskRunSchema),
-    activity: z.array(activityEventSchema)
+    activity: z.array(activityEventSchema),
+    notesSummaryByEntity: notesSummaryByEntitySchema.default({})
 });
 export const projectBoardPayloadSchema = z.object({
     project: projectSummarySchema,
     goal: goalSchema,
     tasks: z.array(taskSchema),
-    activity: z.array(activityEventSchema)
+    activity: z.array(activityEventSchema),
+    notesSummaryByEntity: notesSummaryByEntitySchema.default({})
 });
 export const insightsHeatmapCellSchema = z.object({
     id: z.string(),
@@ -697,6 +722,34 @@ export const settingsBinPayloadSchema = z.object({
     countsByEntityType: z.record(z.string(), z.number().int().nonnegative()),
     records: z.array(deletedEntityRecordSchema)
 });
+export const createNoteLinkSchema = z.object({
+    entityType: crudEntityTypeSchema,
+    entityId: nonEmptyTrimmedString,
+    anchorKey: trimmedString.nullable().default(null)
+});
+export const createNoteSchema = z.object({
+    contentMarkdown: nonEmptyTrimmedString,
+    author: trimmedString.nullable().default(null),
+    links: z.array(createNoteLinkSchema).min(1)
+});
+export const nestedCreateNoteSchema = z.object({
+    contentMarkdown: nonEmptyTrimmedString,
+    author: trimmedString.nullable().default(null),
+    links: z.array(createNoteLinkSchema).default([])
+});
+export const updateNoteSchema = z.object({
+    contentMarkdown: nonEmptyTrimmedString.optional(),
+    author: trimmedString.nullable().optional(),
+    links: z.array(createNoteLinkSchema).min(1).optional()
+});
+export const notesListQuerySchema = z.object({
+    linkedEntityType: crudEntityTypeSchema.optional(),
+    linkedEntityId: nonEmptyTrimmedString.optional(),
+    anchorKey: trimmedString.nullable().optional(),
+    author: trimmedString.optional(),
+    query: trimmedString.optional(),
+    limit: z.coerce.number().int().positive().max(200).optional()
+});
 export const taskListQuerySchema = z.object({
     status: taskStatusSchema.optional(),
     owner: nonEmptyTrimmedString.optional(),
@@ -731,7 +784,8 @@ export const createGoalSchema = z.object({
     status: goalStatusSchema.default("active"),
     targetPoints: z.number().int().min(25).max(10000).default(400),
     themeColor: z.string().regex(/^#[0-9a-fA-F]{6}$/).default("#c8a46b"),
-    tagIds: uniqueStringArraySchema.default([])
+    tagIds: uniqueStringArraySchema.default([]),
+    notes: z.array(nestedCreateNoteSchema).default([])
 });
 export const updateGoalSchema = createGoalSchema.partial();
 export const createTagSchema = z.object({
@@ -747,7 +801,8 @@ export const createProjectSchema = z.object({
     description: trimmedString.default(""),
     status: projectStatusSchema.default("active"),
     targetPoints: z.number().int().min(25).max(10000).default(240),
-    themeColor: z.string().regex(/^#[0-9a-fA-F]{6}$/).default("#c0c1ff")
+    themeColor: z.string().regex(/^#[0-9a-fA-F]{6}$/).default("#c0c1ff"),
+    notes: z.array(nestedCreateNoteSchema).default([])
 });
 export const updateProjectSchema = createProjectSchema.partial();
 export const taskMutationShape = {
@@ -763,7 +818,8 @@ export const taskMutationShape = {
     energy: taskEnergySchema.default("steady"),
     points: z.number().int().min(5).max(500).default(40),
     sortOrder: z.number().int().nonnegative().optional(),
-    tagIds: uniqueStringArraySchema.default([])
+    tagIds: uniqueStringArraySchema.default([]),
+    notes: z.array(nestedCreateNoteSchema).default([])
 };
 export const createTaskSchema = z.object(taskMutationShape);
 export const updateTaskSchema = z.object({
@@ -779,7 +835,8 @@ export const updateTaskSchema = z.object({
     energy: taskEnergySchema.optional(),
     points: z.number().int().min(5).max(500).optional(),
     sortOrder: z.number().int().nonnegative().optional(),
-    tagIds: uniqueStringArraySchema.optional()
+    tagIds: uniqueStringArraySchema.optional(),
+    notes: z.array(nestedCreateNoteSchema).optional()
 });
 export const tagSuggestionRequestSchema = z.object({
     title: trimmedString.default(""),
@@ -817,7 +874,8 @@ export const taskRunHeartbeatSchema = z.object({
 });
 export const taskRunFinishSchema = z.object({
     actor: nonEmptyTrimmedString.optional(),
-    note: trimmedString.default("")
+    note: trimmedString.default(""),
+    closeoutNote: nestedCreateNoteSchema.optional()
 });
 export const taskRunFocusSchema = z.object({
     actor: nonEmptyTrimmedString.optional()
@@ -982,7 +1040,8 @@ export const operatorLogWorkSchema = z
     effort: taskEffortSchema.optional(),
     energy: taskEnergySchema.optional(),
     points: z.number().int().min(5).max(500).optional(),
-    tagIds: uniqueStringArraySchema.optional()
+    tagIds: uniqueStringArraySchema.optional(),
+    closeoutNote: nestedCreateNoteSchema.optional()
 })
     .superRefine((value, context) => {
     if (!value.taskId && (!value.title || value.title.trim().length === 0)) {

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.7",
+  "version": "0.2.10",
   "skills": [
     "./skills"
   ],
@@ -17,6 +17,12 @@
       "help": "Forge server port. Change this if your local machine uses another port.",
       "placeholder": "4317"
     },
+    "dataRoot": {
+      "label": "Forge Data Root",
+      "help": "Optional absolute folder path for Forge data. Use this when you want Forge to read and write a specific data directory instead of the runtime working directory.",
+      "placeholder": "/Users/you/forge-data",
+      "advanced": true
+    },
     "apiToken": {
       "label": "Forge API Token",
       "help": "Optional bearer token. Leave blank for one-step localhost or Tailscale operator-session bootstrap.",
@@ -50,6 +56,11 @@
         "maximum": 65535,
         "description": "Forge server port. Override this when your local machine uses a different port."
       },
+      "dataRoot": {
+        "type": "string",
+        "default": "",
+        "description": "Optional absolute path for the Forge data folder root. Leave blank to use the runtime working directory."
+      },
       "apiToken": {
         "type": "string",
         "default": "",

package/package.json

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

package/server/migrations/001_core.sql

@@ -331,3 +331,81 @@ CREATE INDEX IF NOT EXISTS idx_session_events_session ON session_events(session_
 CREATE INDEX IF NOT EXISTS idx_session_events_type ON session_events(event_type, created_at DESC);
 CREATE INDEX IF NOT EXISTS idx_operator_sessions_active
   ON operator_sessions(revoked_at, expires_at, last_used_at DESC);
+
+ALTER TABLE task_runs ADD COLUMN timer_mode TEXT NOT NULL DEFAULT 'unlimited';
+ALTER TABLE task_runs ADD COLUMN planned_duration_seconds INTEGER;
+ALTER TABLE task_runs ADD COLUMN is_current INTEGER NOT NULL DEFAULT 0;
+
+UPDATE task_runs
+SET timer_mode = 'unlimited',
+    planned_duration_seconds = NULL
+WHERE timer_mode IS NULL OR timer_mode = '';
+
+ALTER TABLE app_settings ADD COLUMN max_active_tasks INTEGER NOT NULL DEFAULT 2;
+ALTER TABLE app_settings ADD COLUMN time_accounting_mode TEXT NOT NULL DEFAULT 'split';
+ALTER TABLE app_settings ADD COLUMN psyche_auth_required INTEGER NOT NULL DEFAULT 0;
+
+CREATE INDEX IF NOT EXISTS idx_task_runs_actor_status_claimed
+  ON task_runs(actor, status, claimed_at);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_task_runs_single_current_per_actor
+  ON task_runs(actor)
+  WHERE status = 'active' AND is_current = 1;
+
+CREATE TABLE deleted_entities (
+  entity_type TEXT NOT NULL,
+  entity_id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  subtitle TEXT NOT NULL DEFAULT '',
+  deleted_at TEXT NOT NULL,
+  deleted_by_actor TEXT,
+  deleted_source TEXT NOT NULL,
+  delete_reason TEXT NOT NULL DEFAULT '',
+  snapshot_json TEXT NOT NULL,
+  PRIMARY KEY (entity_type, entity_id)
+);
+
+CREATE INDEX idx_deleted_entities_deleted_at
+  ON deleted_entities (deleted_at DESC);
+
+CREATE TABLE IF NOT EXISTS notes (
+  id TEXT PRIMARY KEY,
+  content_markdown TEXT NOT NULL,
+  content_plain TEXT NOT NULL DEFAULT '',
+  author TEXT,
+  source TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS note_links (
+  note_id TEXT NOT NULL,
+  entity_type TEXT NOT NULL,
+  entity_id TEXT NOT NULL,
+  anchor_key TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  PRIMARY KEY (note_id, entity_type, entity_id, anchor_key),
+  FOREIGN KEY (note_id) REFERENCES notes(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_note_links_target
+  ON note_links (entity_type, entity_id, created_at DESC);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS notes_fts
+USING fts5(
+  note_id UNINDEXED,
+  content_plain,
+  author
+);
+
+INSERT INTO notes_fts (note_id, content_plain, author)
+SELECT
+  notes.id,
+  notes.content_plain,
+  COALESCE(notes.author, '')
+FROM notes
+WHERE NOT EXISTS (
+  SELECT 1
+  FROM notes_fts
+  WHERE notes_fts.note_id = notes.id
+);