forge-openclaw-plugin 0.2.7 → 0.2.11

package/dist/server/openapi.js

@@ -260,8 +260,9 @@ export function buildOpenApiDocument() {
                     "behavior",
                     "belief_entry",
                     "mode_profile",
+                    "mode_guide_session",
                     "trigger_report",
-                    "comment",
+                    "note",
                     "tag",
                     "task_run",
                     "system",
@@ -306,6 +307,45 @@ export function buildOpenApiDocument() {
             topGoalTitle: nullable({ type: "string" })
         }
     };
+    const noteLink = {
+        type: "object",
+        additionalProperties: false,
+        required: ["entityType", "entityId", "anchorKey"],
+        properties: {
+            entityType: { type: "string" },
+            entityId: { type: "string" },
+            anchorKey: nullable({ type: "string" })
+        }
+    };
+    const note = {
+        type: "object",
+        additionalProperties: false,
+        required: ["id", "contentMarkdown", "contentPlain", "author", "source", "createdAt", "updatedAt", "links"],
+        properties: {
+            id: { type: "string" },
+            contentMarkdown: { type: "string" },
+            contentPlain: { type: "string" },
+            author: nullable({ type: "string" }),
+            source: { type: "string", enum: ["ui", "openclaw", "agent", "system"] },
+            createdAt: { type: "string", format: "date-time" },
+            updatedAt: { type: "string", format: "date-time" },
+            links: arrayOf({ $ref: "#/components/schemas/NoteLink" })
+        }
+    };
+    const noteSummary = {
+        type: "object",
+        additionalProperties: false,
+        required: ["count", "latestNoteId", "latestCreatedAt"],
+        properties: {
+            count: { type: "integer" },
+            latestNoteId: nullable({ type: "string" }),
+            latestCreatedAt: nullable({ type: "string", format: "date-time" })
+        }
+    };
+    const notesSummaryByEntity = {
+        type: "object",
+        additionalProperties: { $ref: "#/components/schemas/NoteSummary" }
+    };
     const achievementSignal = {
         type: "object",
         additionalProperties: false,
@@ -338,7 +378,7 @@ export function buildOpenApiDocument() {
     const dashboardPayload = {
         type: "object",
         additionalProperties: false,
-        required: ["stats", "goals", "projects", "tasks", "tags", "suggestedTags", "owners", "executionBuckets", "gamification", "achievements", "milestoneRewards", "recentActivity"],
+        required: ["stats", "goals", "projects", "tasks", "tags", "suggestedTags", "owners", "executionBuckets", "gamification", "achievements", "milestoneRewards", "recentActivity", "notesSummaryByEntity"],
         properties: {
             stats: {
                 type: "object",
@@ -375,7 +415,8 @@ export function buildOpenApiDocument() {
             gamification: { $ref: "#/components/schemas/GamificationProfile" },
             achievements: arrayOf({ $ref: "#/components/schemas/AchievementSignal" }),
             milestoneRewards: arrayOf({ $ref: "#/components/schemas/MilestoneReward" }),
-            recentActivity: arrayOf({ $ref: "#/components/schemas/ActivityEvent" })
+            recentActivity: arrayOf({ $ref: "#/components/schemas/ActivityEvent" }),
+            notesSummaryByEntity: { $ref: "#/components/schemas/NotesSummaryByEntity" }
         }
     };
     const overviewContext = {
@@ -539,25 +580,27 @@ export function buildOpenApiDocument() {
     const taskContextPayload = {
         type: "object",
         additionalProperties: false,
-        required: ["task", "goal", "project", "activeTaskRun", "taskRuns", "activity"],
+        required: ["task", "goal", "project", "activeTaskRun", "taskRuns", "activity", "notesSummaryByEntity"],
         properties: {
             task: { $ref: "#/components/schemas/Task" },
             goal: nullable({ $ref: "#/components/schemas/Goal" }),
             project: nullable({ $ref: "#/components/schemas/ProjectSummary" }),
             activeTaskRun: nullable({ $ref: "#/components/schemas/TaskRun" }),
             taskRuns: arrayOf({ $ref: "#/components/schemas/TaskRun" }),
-            activity: arrayOf({ $ref: "#/components/schemas/ActivityEvent" })
+            activity: arrayOf({ $ref: "#/components/schemas/ActivityEvent" }),
+            notesSummaryByEntity: { $ref: "#/components/schemas/NotesSummaryByEntity" }
         }
     };
     const projectBoardPayload = {
         type: "object",
         additionalProperties: false,
-        required: ["project", "goal", "tasks", "activity"],
+        required: ["project", "goal", "tasks", "activity", "notesSummaryByEntity"],
         properties: {
             project: { $ref: "#/components/schemas/ProjectSummary" },
             goal: { $ref: "#/components/schemas/Goal" },
             tasks: arrayOf({ $ref: "#/components/schemas/Task" }),
-            activity: arrayOf({ $ref: "#/components/schemas/ActivityEvent" })
+            activity: arrayOf({ $ref: "#/components/schemas/ActivityEvent" }),
+            notesSummaryByEntity: { $ref: "#/components/schemas/NotesSummaryByEntity" }
         }
     };
     const insightsPayload = {
@@ -745,7 +788,17 @@ export function buildOpenApiDocument() {
         additionalProperties: false,
         properties: {
             actor: { type: "string" },
-            note: { type: "string", default: "" }
+            note: { type: "string", default: "" },
+            closeoutNote: {
+                type: "object",
+                additionalProperties: false,
+                required: ["contentMarkdown"],
+                properties: {
+                    contentMarkdown: { type: "string" },
+                    author: nullable({ type: "string" }),
+                    links: arrayOf({ $ref: "#/components/schemas/NoteLink" })
+                }
+            }
         }
     };
     const taskRunFocusInput = {
@@ -1217,12 +1270,13 @@ export function buildOpenApiDocument() {
             conceptModel: {
                 type: "object",
                 additionalProperties: false,
-                required: ["goal", "project", "task", "taskRun", "insight", "psyche"],
+                required: ["goal", "project", "task", "taskRun", "note", "insight", "psyche"],
                 properties: {
                     goal: { type: "string" },
                     project: { type: "string" },
                     task: { type: "string" },
                     taskRun: { type: "string" },
+                    note: { type: "string" },
                     insight: { type: "string" },
                     psyche: { type: "string" }
                 }
@@ -1760,22 +1814,6 @@ export function buildOpenApiDocument() {
             updatedAt: { type: "string", format: "date-time" }
         }
     };
-    const comment = {
-        type: "object",
-        additionalProperties: false,
-        required: ["id", "entityType", "entityId", "anchorKey", "body", "author", "source", "createdAt", "updatedAt"],
-        properties: {
-            id: { type: "string" },
-            entityType: { type: "string" },
-            entityId: { type: "string" },
-            anchorKey: nullable({ type: "string" }),
-            body: { type: "string" },
-            author: nullable({ type: "string" }),
-            source: { type: "string", enum: ["ui", "openclaw", "agent", "system"] },
-            createdAt: { type: "string", format: "date-time" },
-            updatedAt: { type: "string", format: "date-time" }
-        }
-    };
     const triggerReport = {
         type: "object",
         additionalProperties: false,
@@ -1903,7 +1941,7 @@ export function buildOpenApiDocument() {
             "schemaPressure",
             "reports",
             "openInsights",
-            "unresolvedComments",
+            "openNotes",
             "committedActions"
         ],
         properties: {
@@ -1926,7 +1964,7 @@ export function buildOpenApiDocument() {
             }),
             reports: arrayOf({ $ref: "#/components/schemas/TriggerReport" }),
             openInsights: { type: "integer" },
-            unresolvedComments: { type: "integer" },
+            openNotes: { type: "integer" },
             committedActions: arrayOf({ type: "string" })
         }
     };
@@ -1994,7 +2032,10 @@ export function buildOpenApiDocument() {
                 ModeProfile: modeProfile,
                 ModeGuideSession: modeGuideSession,
                 TriggerReport: triggerReport,
-                Comment: comment,
+                NoteLink: noteLink,
+                Note: note,
+                NoteSummary: noteSummary,
+                NotesSummaryByEntity: notesSummaryByEntity,
                 PsycheOverviewPayload: psycheOverviewPayload,
                 Insight: insight,
                 InsightFeedback: insightFeedback,
@@ -2445,14 +2486,14 @@ export function buildOpenApiDocument() {
             },
             "/api/v1/psyche/reports/{id}": {
                 get: {
-                    summary: "Get a trigger report with comments and linked insights",
+                    summary: "Get a trigger report with linked notes and insights",
                     responses: {
                         "200": jsonResponse({
                             type: "object",
-                            required: ["report", "comments", "insights"],
+                            required: ["report", "notes", "insights"],
                             properties: {
                                 report: { $ref: "#/components/schemas/TriggerReport" },
-                                comments: arrayOf({ $ref: "#/components/schemas/Comment" }),
+                                notes: arrayOf({ $ref: "#/components/schemas/Note" }),
                                 insights: arrayOf({ $ref: "#/components/schemas/Insight" })
                             }
                         }, "Trigger report detail"),
@@ -2474,41 +2515,41 @@ export function buildOpenApiDocument() {
                     }
                 }
             },
-            "/api/v1/comments": {
+            "/api/v1/notes": {
                 get: {
-                    summary: "List comments on Forge entities",
+                    summary: "List notes linked to Forge entities",
                     responses: {
-                        "200": jsonResponse({ type: "object", required: ["comments"], properties: { comments: arrayOf({ $ref: "#/components/schemas/Comment" }) } }, "Comment collection"),
+                        "200": jsonResponse({ type: "object", required: ["notes"], properties: { notes: arrayOf({ $ref: "#/components/schemas/Note" }) } }, "Note collection"),
                         default: { $ref: "#/components/responses/Error" }
                     }
                 },
                 post: {
-                    summary: "Create a comment on a Forge entity",
+                    summary: "Create a note linked to one or more Forge entities",
                     responses: {
-                        "201": jsonResponse({ type: "object", required: ["comment"], properties: { comment: { $ref: "#/components/schemas/Comment" } } }, "Created comment"),
+                        "201": jsonResponse({ type: "object", required: ["note"], properties: { note: { $ref: "#/components/schemas/Note" } } }, "Created note"),
                         default: { $ref: "#/components/responses/Error" }
                     }
                 }
             },
-            "/api/v1/comments/{id}": {
+            "/api/v1/notes/{id}": {
                 get: {
-                    summary: "Get a comment",
+                    summary: "Get a note",
                     responses: {
-                        "200": jsonResponse({ type: "object", required: ["comment"], properties: { comment: { $ref: "#/components/schemas/Comment" } } }, "Comment"),
+                        "200": jsonResponse({ type: "object", required: ["note"], properties: { note: { $ref: "#/components/schemas/Note" } } }, "Note"),
                         default: { $ref: "#/components/responses/Error" }
                     }
                 },
                 patch: {
-                    summary: "Update a comment",
+                    summary: "Update a note",
                     responses: {
-                        "200": jsonResponse({ type: "object", required: ["comment"], properties: { comment: { $ref: "#/components/schemas/Comment" } } }, "Updated comment"),
+                        "200": jsonResponse({ type: "object", required: ["note"], properties: { note: { $ref: "#/components/schemas/Note" } } }, "Updated note"),
                         default: { $ref: "#/components/responses/Error" }
                     }
                 },
                 delete: {
-                    summary: "Delete a comment",
+                    summary: "Delete a note",
                     responses: {
-                        "200": jsonResponse({ type: "object", required: ["comment"], properties: { comment: { $ref: "#/components/schemas/Comment" } } }, "Deleted comment"),
+                        "200": jsonResponse({ type: "object", required: ["note"], properties: { note: { $ref: "#/components/schemas/Note" } } }, "Deleted note"),
                         default: { $ref: "#/components/responses/Error" }
                     }
                 }

package/dist/server/psyche-types.js

@@ -3,7 +3,6 @@ const trimmedString = z.string().trim();
 const nonEmptyTrimmedString = trimmedString.min(1);
 const uniqueStringArraySchema = z.array(nonEmptyTrimmedString);
 export const triggerReportStatusSchema = z.enum(["draft", "reviewed", "integrated"]);
-export const commentSourceSchema = z.enum(["ui", "openclaw", "agent", "system"]);
 export const behaviorKindSchema = z.enum(["away", "committed", "recovery"]);
 export const beliefTypeSchema = z.enum(["absolute", "conditional"]);
 export const modeFamilySchema = z.enum(["coping", "child", "critic_parent", "healthy_adult", "happy_child"]);
@@ -225,17 +224,6 @@ export const triggerReportSchema = z.object({
     createdAt: z.string(),
     updatedAt: z.string()
 });
-export const commentSchema = z.object({
-    id: z.string(),
-    entityType: nonEmptyTrimmedString,
-    entityId: nonEmptyTrimmedString,
-    anchorKey: trimmedString.nullable(),
-    body: nonEmptyTrimmedString,
-    author: trimmedString.nullable(),
-    source: commentSourceSchema,
-    createdAt: z.string(),
-    updatedAt: z.string()
-});
 export const schemaPressureEntrySchema = z.object({
     schemaId: z.string(),
     title: nonEmptyTrimmedString,
@@ -252,7 +240,7 @@ export const psycheOverviewPayloadSchema = z.object({
     reports: z.array(triggerReportSchema),
     schemaPressure: z.array(schemaPressureEntrySchema),
     openInsights: z.number().int().nonnegative(),
-    unresolvedComments: z.number().int().nonnegative(),
+    openNotes: z.number().int().nonnegative(),
     committedActions: z.array(trimmedString)
 });
 export const createPsycheValueSchema = z.object({
@@ -376,20 +364,3 @@ export const createTriggerReportSchema = z.object({
     nextMoves: z.array(trimmedString).default([])
 });
 export const updateTriggerReportSchema = createTriggerReportSchema.partial();
-export const createCommentSchema = z.object({
-    entityType: nonEmptyTrimmedString,
-    entityId: nonEmptyTrimmedString,
-    anchorKey: trimmedString.nullable().default(null),
-    body: nonEmptyTrimmedString,
-    author: trimmedString.nullable().default(null)
-});
-export const updateCommentSchema = z.object({
-    body: nonEmptyTrimmedString,
-    author: trimmedString.nullable().default(null)
-});
-export const commentsListQuerySchema = z.object({
-    entityType: nonEmptyTrimmedString.optional(),
-    entityId: nonEmptyTrimmedString.optional(),
-    limit: z.coerce.number().int().positive().max(200).optional()
-});
-export const commentListQuerySchema = commentsListQuerySchema;

package/dist/server/repositories/deleted-entities.js

@@ -107,30 +107,64 @@ export function clearDeletedEntityRecord(entityType, entityId) {
         .run(entityType, entityId);
 }
 export function cascadeSoftDeleteAnchoredCollaboration(parentEntityType, parentEntityId, context, deleteReason = "") {
-    const commentRows = getDatabase()
-        .prepare(`SELECT id, body, author, source, created_at, updated_at
-       FROM entity_comments
-       WHERE entity_type = ? AND entity_id = ?`)
+    const noteRows = getDatabase()
+        .prepare(`SELECT DISTINCT
+         notes.id AS id,
+         notes.content_markdown AS content_markdown,
+         notes.content_plain AS content_plain,
+         notes.author AS author,
+         notes.source AS source,
+         notes.created_at AS created_at,
+         notes.updated_at AS updated_at
+       FROM notes
+       INNER JOIN note_links
+         ON note_links.note_id = notes.id
+       LEFT JOIN deleted_entities
+         ON deleted_entities.entity_type = 'note'
+        AND deleted_entities.entity_id = notes.id
+       WHERE note_links.entity_type = ?
+         AND note_links.entity_id = ?
+         AND deleted_entities.entity_id IS NULL`)
         .all(parentEntityType, parentEntityId);
-    for (const row of commentRows) {
-        upsertDeletedEntityRecord({
-            entityType: "comment",
-            entityId: row.id,
-            title: row.body.slice(0, 72) || "Comment",
-            subtitle: `Comment on ${parentEntityType.replaceAll("_", " ")}`,
-            snapshot: {
-                id: row.id,
-                entityType: parentEntityType,
-                entityId: parentEntityId,
-                body: row.body,
-                author: row.author,
-                source: row.source,
-                createdAt: row.created_at,
-                updatedAt: row.updated_at
-            },
-            deleteReason,
-            context
-        });
+    if (noteRows.length > 0) {
+        const placeholders = noteRows.map(() => "?").join(", ");
+        const linkRows = getDatabase()
+            .prepare(`SELECT note_id, entity_type, entity_id, anchor_key
+         FROM note_links
+         WHERE note_id IN (${placeholders})
+         ORDER BY created_at ASC`)
+            .all(...noteRows.map((row) => row.id));
+        const linksByNoteId = new Map();
+        for (const link of linkRows) {
+            const current = linksByNoteId.get(link.note_id) ?? [];
+            current.push({
+                entityType: link.entity_type,
+                entityId: link.entity_id,
+                anchorKey: link.anchor_key.trim().length > 0 ? link.anchor_key : null
+            });
+            linksByNoteId.set(link.note_id, current);
+        }
+        for (const row of noteRows) {
+            const compact = (row.content_plain || row.content_markdown).replace(/\s+/g, " ").trim();
+            upsertDeletedEntityRecord({
+                entityType: "note",
+                entityId: row.id,
+                title: compact.slice(0, 72) || "Note",
+                subtitle: compact.length > 72 ? compact.slice(72, 168).trim() : `Linked to ${parentEntityType.replaceAll("_", " ")}`,
+                snapshot: {
+                    id: row.id,
+                    contentMarkdown: row.content_markdown,
+                    contentPlain: row.content_plain,
+                    author: row.author,
+                    source: row.source,
+                    createdAt: row.created_at,
+                    updatedAt: row.updated_at,
+                    links: linksByNoteId.get(row.id) ?? []
+                },
+                deleteReason,
+                context
+            });
+        }
     }
     const insightRows = getDatabase()
         .prepare(`SELECT id, title, summary, created_at, updated_at
@@ -160,10 +194,10 @@ export function cascadeSoftDeleteAnchoredCollaboration(parentEntityType, parentE
 export function restoreAnchoredCollaboration(parentEntityType, parentEntityId) {
     getDatabase()
         .prepare(`DELETE FROM deleted_entities
-       WHERE entity_type = 'comment'
+       WHERE entity_type = 'note'
          AND entity_id IN (
-           SELECT id
-           FROM entity_comments
+           SELECT DISTINCT note_id
+           FROM note_links
            WHERE entity_type = ? AND entity_id = ?
          )`)
         .run(parentEntityType, parentEntityId);

package/dist/server/repositories/goals.js

@@ -2,6 +2,7 @@ import { randomUUID } from "node:crypto";
 import { getDatabase, runInTransaction } from "../db.js";
 import { recordActivityEvent } from "./activity-events.js";
 import { filterDeletedEntities, filterDeletedIds, isEntityDeleted } from "./deleted-entities.js";
+import { createLinkedNotes } from "./notes.js";
 import { assertGoalRelations } from "../services/relations.js";
 import { pruneLinkedEntityReferences } from "./psyche.js";
 import { goalSchema } from "../types.js";
@@ -52,6 +53,7 @@ export function createGoal(input, activity) {
             .run(id, input.title, input.description, input.horizon, input.status, input.targetPoints, input.themeColor, now, now);
         replaceGoalTags(id, input.tagIds);
         const goal = getGoalById(id);
+        createLinkedNotes(input.notes, { entityType: "goal", entityId: goal.id, anchorKey: null }, activity ?? { source: "ui", actor: null });
         if (activity) {
             recordActivityEvent({
                 entityType: "goal",
@@ -130,11 +132,6 @@ export function deleteGoal(goalId, activity) {
     }
     return runInTransaction(() => {
         pruneLinkedEntityReferences("goal", goalId);
-        getDatabase()
-            .prepare(`DELETE FROM entity_comments
-         WHERE entity_type = 'goal'
-           AND entity_id = ?`)
-            .run(goalId);
         getDatabase()
             .prepare(`DELETE FROM goals WHERE id = ?`)
             .run(goalId);