forge-openclaw-plugin 0.2.18 → 0.2.19

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

@@ -1,5 +1,6 @@
 import { getDatabase, runInTransaction } from "../db.js";
 import { createInsight, deleteInsight, getInsightById, listInsights, updateInsight } from "../repositories/collaboration.js";
+import { createCalendarEvent, createTaskTimebox, createWorkBlockTemplate, deleteCalendarEvent, deleteTaskTimebox, deleteWorkBlockTemplate, getCalendarEventById, getTaskTimeboxById, getWorkBlockTemplateById, listCalendarEvents, listTaskTimeboxes, listWorkBlockTemplates, updateCalendarEvent, updateTaskTimebox, updateWorkBlockTemplate } from "../repositories/calendar.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";
@@ -9,7 +10,11 @@ import { createBehavior, createBehaviorPattern, createBeliefEntry, createEmotion
 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, createHabitSchema, createInsightSchema, createNoteSchema, createProjectSchema, createTagSchema, createTaskSchema, updateGoalSchema, updateHabitSchema, updateInsightSchema, updateNoteSchema, updateProjectSchema, updateTagSchema, updateTaskSchema } from "../types.js";
+import { createCalendarEventSchema, createGoalSchema, createHabitSchema, createInsightSchema, createNoteSchema, createProjectSchema, createTaskTimeboxSchema, createTagSchema, createTaskSchema, createWorkBlockTemplateSchema, updateCalendarEventSchema, updateGoalSchema, updateHabitSchema, updateInsightSchema, updateNoteSchema, updateProjectSchema, updateTaskTimeboxSchema, updateTagSchema, updateTaskSchema, updateWorkBlockTemplateSchema } from "../types.js";
+const ENTITY_CALENDAR_LIST_RANGE = {
+    from: "1970-01-01T00:00:00.000Z",
+    to: "2100-01-01T00:00:00.000Z"
+};
 class AtomicBatchRollback extends Error {
     index;
     code;
@@ -26,6 +31,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     goal: {
         entityType: "goal",
         routeBase: "/api/v1/goals",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listGoals(),
         get: (id) => getGoalById(id),
         create: (data, context) => createGoal(data, context),
@@ -35,6 +42,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     project: {
         entityType: "project",
         routeBase: "/api/v1/projects",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listProjects(),
         get: (id) => getProjectById(id),
         create: (data, context) => createProject(data, context),
@@ -44,6 +53,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     task: {
         entityType: "task",
         routeBase: "/api/v1/tasks",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listTasks(),
         get: (id) => getTaskById(id),
         create: (data, context) => createTask(data, context),
@@ -53,6 +64,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     habit: {
         entityType: "habit",
         routeBase: "/api/v1/habits",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listHabits(),
         get: (id) => getHabitById(id),
         create: (data, context) => createHabit(data, context),
@@ -62,6 +75,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     tag: {
         entityType: "tag",
         routeBase: "/api/v1/tags",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listTags(),
         get: (id) => getTagById(id),
         create: (data, context) => createTag(data, context),
@@ -71,6 +86,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     note: {
         entityType: "note",
         routeBase: "/api/v1/notes",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listNotes(),
         get: (id) => getNoteById(id),
         create: (data, context) => createNote(data, context),
@@ -80,15 +97,52 @@ const CRUD_ENTITY_CAPABILITIES = {
     insight: {
         entityType: "insight",
         routeBase: "/api/v1/insights",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listInsights(),
         get: (id) => getInsightById(id),
         create: (data, context) => createInsight(data, context),
         update: (id, patch, context) => updateInsight(id, patch, context),
         hardDelete: (id, context) => deleteInsight(id, context)
     },
+    calendar_event: {
+        entityType: "calendar_event",
+        routeBase: "/api/v1/calendar/events",
+        deleteMode: "immediate",
+        inBin: false,
+        list: () => listCalendarEvents(ENTITY_CALENDAR_LIST_RANGE),
+        get: (id) => getCalendarEventById(id),
+        create: (data) => createCalendarEvent(data),
+        update: (id, patch) => updateCalendarEvent(id, patch),
+        hardDelete: (id) => deleteCalendarEvent(id)
+    },
+    work_block_template: {
+        entityType: "work_block_template",
+        routeBase: "/api/v1/calendar/work-block-templates",
+        deleteMode: "immediate",
+        inBin: false,
+        list: () => listWorkBlockTemplates(),
+        get: (id) => getWorkBlockTemplateById(id),
+        create: (data) => createWorkBlockTemplate(data),
+        update: (id, patch) => updateWorkBlockTemplate(id, patch),
+        hardDelete: (id) => deleteWorkBlockTemplate(id)
+    },
+    task_timebox: {
+        entityType: "task_timebox",
+        routeBase: "/api/v1/calendar/timeboxes",
+        deleteMode: "immediate",
+        inBin: false,
+        list: () => listTaskTimeboxes(ENTITY_CALENDAR_LIST_RANGE),
+        get: (id) => getTaskTimeboxById(id),
+        create: (data) => createTaskTimebox(data),
+        update: (id, patch) => updateTaskTimebox(id, patch),
+        hardDelete: (id) => deleteTaskTimebox(id)
+    },
     psyche_value: {
         entityType: "psyche_value",
         routeBase: "/api/v1/psyche/values",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listPsycheValues(),
         get: (id) => getPsycheValueById(id),
         create: (data, context) => createPsycheValue(data, context),
@@ -98,6 +152,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     behavior_pattern: {
         entityType: "behavior_pattern",
         routeBase: "/api/v1/psyche/patterns",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listBehaviorPatterns(),
         get: (id) => getBehaviorPatternById(id),
         create: (data, context) => createBehaviorPattern(data, context),
@@ -107,6 +163,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     behavior: {
         entityType: "behavior",
         routeBase: "/api/v1/psyche/behaviors",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listBehaviors(),
         get: (id) => getBehaviorById(id),
         create: (data, context) => createBehavior(data, context),
@@ -116,6 +174,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     belief_entry: {
         entityType: "belief_entry",
         routeBase: "/api/v1/psyche/beliefs",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listBeliefEntries(),
         get: (id) => getBeliefEntryById(id),
         create: (data, context) => createBeliefEntry(data, context),
@@ -125,6 +185,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     mode_profile: {
         entityType: "mode_profile",
         routeBase: "/api/v1/psyche/modes",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listModeProfiles(),
         get: (id) => getModeProfileById(id),
         create: (data, context) => createModeProfile(data, context),
@@ -134,6 +196,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     mode_guide_session: {
         entityType: "mode_guide_session",
         routeBase: "/api/v1/psyche/mode-guides",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listModeGuideSessions(200),
         get: (id) => getModeGuideSessionById(id),
         create: (data, context) => createModeGuideSession(data, context),
@@ -143,6 +207,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     event_type: {
         entityType: "event_type",
         routeBase: "/api/v1/psyche/event-types",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listEventTypes(),
         get: (id) => getEventTypeById(id),
         create: (data, context) => createEventType(data, context),
@@ -152,6 +218,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     emotion_definition: {
         entityType: "emotion_definition",
         routeBase: "/api/v1/psyche/emotions",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listEmotionDefinitions(),
         get: (id) => getEmotionDefinitionById(id),
         create: (data, context) => createEmotionDefinition(data, context),
@@ -161,6 +229,8 @@ const CRUD_ENTITY_CAPABILITIES = {
     trigger_report: {
         entityType: "trigger_report",
         routeBase: "/api/v1/psyche/reports",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listTriggerReports(200),
         get: (id) => getTriggerReportById(id),
         create: (data, context) => createTriggerReport(data, context),
@@ -173,8 +243,8 @@ export function getCrudEntityCapabilityMatrix() {
         entityType: capability.entityType,
         routeBase: capability.routeBase,
         pluginExposed: true,
-        deleteMode: "soft_default",
-        inBin: true
+        deleteMode: capability.deleteMode,
+        inBin: capability.inBin
     }));
 }
 function getCapability(entityType) {
@@ -188,6 +258,9 @@ const CREATE_ENTITY_SCHEMAS = {
     tag: createTagSchema,
     note: createNoteSchema,
     insight: createInsightSchema,
+    calendar_event: createCalendarEventSchema,
+    work_block_template: createWorkBlockTemplateSchema,
+    task_timebox: createTaskTimeboxSchema,
     psyche_value: createPsycheValueSchema,
     behavior_pattern: createBehaviorPatternSchema,
     behavior: createBehaviorSchema,
@@ -206,6 +279,9 @@ const UPDATE_ENTITY_SCHEMAS = {
     tag: updateTagSchema,
     note: updateNoteSchema,
     insight: updateInsightSchema,
+    calendar_event: updateCalendarEventSchema,
+    work_block_template: updateWorkBlockTemplateSchema,
+    task_timebox: updateTaskTimeboxSchema,
     psyche_value: updatePsycheValueSchema,
     behavior_pattern: updateBehaviorPatternSchema,
     behavior: updateBehaviorSchema,
@@ -344,6 +420,17 @@ function matchesLinkedTo(entityType, entity, linkedTo) {
                     link.entityId === linkedTo.id));
         case "insight":
             return entity.entityType === linkedTo.entityType && entity.entityId === linkedTo.id;
+        case "calendar_event":
+            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 "task_timebox":
+            return ((linkedTo.entityType === "task" && entity.taskId === linkedTo.id) ||
+                (linkedTo.entityType === "project" && entity.projectId === linkedTo.id));
         case "psyche_value":
             return ((linkedTo.entityType === "goal" && Array.isArray(entity.linkedGoalIds) && entity.linkedGoalIds.includes(linkedTo.id)) ||
                 (linkedTo.entityType === "project" && Array.isArray(entity.linkedProjectIds) && entity.linkedProjectIds.includes(linkedTo.id)) ||
@@ -412,6 +499,10 @@ function purgeAnchoredCollaboration(entityType, entityId) {
 export function deleteEntity(entityType, id, options, context) {
     const capability = getCapability(entityType);
     const mode = options.mode ?? "soft";
+    if (capability.deleteMode === "immediate") {
+        clearDeletedEntityRecord(entityType, id);
+        return capability.hardDelete(id, context);
+    }
     const existing = capability.get(id);
     if (!existing) {
         const deleted = getDeletedEntityRecord(entityType, id);

package/dist/server/services/projects.js

@@ -3,6 +3,7 @@ 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 { listProjectWorkAdjustmentSecondsMap } from "../repositories/work-adjustments.js";
 import { emptyTaskTimeSummary } from "./work-time.js";
 import { projectBoardPayloadSchema, projectSummarySchema } from "../types.js";
 function projectTaskSummary(tasks) {
@@ -33,25 +34,48 @@ function projectTaskSummary(tasks) {
         nextTaskId: nextTask?.id ?? null,
         nextTaskTitle: nextTask?.title ?? null,
         momentumLabel,
-        time: tasks.reduce((summary, task) => ({
-            totalTrackedSeconds: summary.totalTrackedSeconds + task.time.totalTrackedSeconds,
-            totalCreditedSeconds: Math.round((summary.totalCreditedSeconds + task.time.totalCreditedSeconds) * 100) / 100,
-            activeRunCount: summary.activeRunCount + task.time.activeRunCount,
-            hasCurrentRun: summary.hasCurrentRun || task.time.hasCurrentRun,
-            currentRunId: summary.currentRunId ?? task.time.currentRunId
-        }), emptyTaskTimeSummary())
+        time: tasks.reduce((summary, task) => {
+            const liveTrackedSeconds = task.time.liveTrackedSeconds ?? 0;
+            const liveCreditedSeconds = task.time.liveCreditedSeconds ?? 0;
+            const manualAdjustedSeconds = task.time.manualAdjustedSeconds ?? 0;
+            return {
+                totalTrackedSeconds: summary.totalTrackedSeconds + task.time.totalTrackedSeconds,
+                totalCreditedSeconds: Math.round((summary.totalCreditedSeconds + task.time.totalCreditedSeconds) * 100) / 100,
+                liveTrackedSeconds: summary.liveTrackedSeconds + liveTrackedSeconds,
+                liveCreditedSeconds: Math.round((summary.liveCreditedSeconds + liveCreditedSeconds) * 100) / 100,
+                manualAdjustedSeconds: summary.manualAdjustedSeconds + manualAdjustedSeconds,
+                activeRunCount: summary.activeRunCount + task.time.activeRunCount,
+                hasCurrentRun: summary.hasCurrentRun || task.time.hasCurrentRun,
+                currentRunId: summary.currentRunId ?? task.time.currentRunId
+            };
+        }, emptyTaskTimeSummary())
     };
 }
 export function listProjectSummaries(filters = {}) {
     const goals = new Map(listGoals().map((goal) => [goal.id, goal]));
     const tasks = listTasks();
+    const projectAdjustmentSeconds = listProjectWorkAdjustmentSecondsMap();
     return listProjects(filters).map((project) => {
         const goal = goals.get(project.goalId);
         const projectTasks = tasks.filter((task) => task.projectId === project.id);
+        const taskSummary = projectTaskSummary(projectTasks);
+        const projectAdjustmentSecondsTotal = projectAdjustmentSeconds.get(project.id) ?? 0;
+        const manualAdjustedSeconds = (taskSummary.time.manualAdjustedSeconds ?? 0) + projectAdjustmentSecondsTotal;
+        const time = {
+            totalTrackedSeconds: Math.max(0, taskSummary.time.totalTrackedSeconds + projectAdjustmentSecondsTotal),
+            totalCreditedSeconds: Math.round(Math.max(0, taskSummary.time.totalCreditedSeconds + projectAdjustmentSecondsTotal) * 100) / 100,
+            liveTrackedSeconds: taskSummary.time.liveTrackedSeconds ?? 0,
+            liveCreditedSeconds: taskSummary.time.liveCreditedSeconds ?? 0,
+            manualAdjustedSeconds,
+            activeRunCount: taskSummary.time.activeRunCount,
+            hasCurrentRun: taskSummary.time.hasCurrentRun,
+            currentRunId: taskSummary.time.currentRunId
+        };
         return projectSummarySchema.parse({
             ...project,
             goalTitle: goal?.title ?? "Unknown life goal",
-            ...projectTaskSummary(projectTasks)
+            ...taskSummary,
+            time
         });
     });
 }

package/dist/server/services/reviews.js

@@ -2,9 +2,10 @@ import { listActivityEvents } from "../repositories/activity-events.js";
 import { listGoals } from "../repositories/goals.js";
 import { listHabits } from "../repositories/habits.js";
 import { listTasks } from "../repositories/tasks.js";
+import { getWeeklyReviewClosure } from "../repositories/weekly-reviews.js";
 import { buildGamificationProfile } from "./gamification.js";
 import { weeklyReviewPayloadSchema } from "../types.js";
-function startOfWeek(date) {
+export function startOfWeek(date) {
     const clone = new Date(date);
     const day = clone.getDay();
     const delta = day === 0 ? -6 : 1 - day;
@@ -20,6 +21,9 @@ function addDays(date, days) {
 function formatRange(start, end) {
     return `${start.toLocaleDateString("en-US", { month: "short", day: "numeric" })} - ${end.toLocaleDateString("en-US", { month: "short", day: "numeric" })}`;
 }
+function toDateOnly(date) {
+    return date.toISOString().slice(0, 10);
+}
 function dailyBuckets(tasks, start) {
     return Array.from({ length: 7 }, (_, index) => {
         const current = addDays(start, index);
@@ -40,6 +44,8 @@ export function getWeeklyReviewPayload(now = new Date()) {
     const gamification = buildGamificationProfile(goals, tasks, listHabits(), now);
     const weekStart = startOfWeek(now);
     const weekEnd = addDays(weekStart, 6);
+    const weekKey = toDateOnly(weekStart);
+    const closure = getWeeklyReviewClosure(weekKey);
     const weekTasks = tasks.filter((task) => task.updatedAt >= weekStart.toISOString() && task.updatedAt <= addDays(weekEnd, 1).toISOString());
     const completedTasks = weekTasks.filter((task) => task.completedAt !== null);
     const buckets = dailyBuckets(tasks, weekStart);
@@ -62,6 +68,9 @@ export function getWeeklyReviewPayload(now = new Date()) {
     return weeklyReviewPayloadSchema.parse({
         generatedAt: now.toISOString(),
         windowLabel: formatRange(weekStart, weekEnd),
+        weekKey,
+        weekStartDate: weekKey,
+        weekEndDate: toDateOnly(weekEnd),
         momentumSummary: {
             totalXp,
             focusHours: buckets.reduce((sum, bucket) => sum + bucket.focusHours, 0),
@@ -84,6 +93,11 @@ export function getWeeklyReviewPayload(now = new Date()) {
             title: "Review Completion Bonus",
             summary: "Finalizing the review locks the current cycle into evidence.",
             rewardXp: 250
+        },
+        completion: {
+            finalized: closure !== null,
+            finalizedAt: closure?.createdAt ?? null,
+            finalizedBy: closure?.actor ?? null
         }
     });
 }

package/dist/server/services/work-time.js

@@ -1,4 +1,5 @@
 import { getDatabase } from "../db.js";
+import { listTaskWorkAdjustmentSecondsMap } from "../repositories/work-adjustments.js";
 function readTimeAccountingMode() {
     try {
         const row = getDatabase()
@@ -132,6 +133,9 @@ export function computeWorkTime(now = new Date()) {
         const existing = taskSummaries.get(timing.row.task_id) ?? {
             totalTrackedSeconds: 0,
             totalCreditedSeconds: 0,
+            liveTrackedSeconds: 0,
+            liveCreditedSeconds: 0,
+            manualAdjustedSeconds: 0,
             activeRunCount: 0,
             hasCurrentRun: false,
             currentRunId: null
@@ -139,11 +143,28 @@ export function computeWorkTime(now = new Date()) {
         taskSummaries.set(timing.row.task_id, {
             totalTrackedSeconds: existing.totalTrackedSeconds + elapsedWallSeconds,
             totalCreditedSeconds: roundCreditedSeconds(existing.totalCreditedSeconds + creditedSeconds),
+            liveTrackedSeconds: existing.liveTrackedSeconds + elapsedWallSeconds,
+            liveCreditedSeconds: roundCreditedSeconds(existing.liveCreditedSeconds + creditedSeconds),
+            manualAdjustedSeconds: existing.manualAdjustedSeconds,
             activeRunCount: existing.activeRunCount + (timing.row.status === "active" ? 1 : 0),
             hasCurrentRun: existing.hasCurrentRun || isCurrent,
             currentRunId: isCurrent ? timing.row.id : existing.currentRunId
         });
     }
+    const adjustmentSecondsByTaskId = listTaskWorkAdjustmentSecondsMap();
+    for (const [taskId, adjustmentSeconds] of adjustmentSecondsByTaskId.entries()) {
+        const existing = taskSummaries.get(taskId) ?? emptyTaskTimeSummary();
+        taskSummaries.set(taskId, {
+            totalTrackedSeconds: Math.max(0, existing.totalTrackedSeconds + adjustmentSeconds),
+            totalCreditedSeconds: roundCreditedSeconds(Math.max(0, existing.totalCreditedSeconds + adjustmentSeconds)),
+            liveTrackedSeconds: existing.liveTrackedSeconds,
+            liveCreditedSeconds: existing.liveCreditedSeconds,
+            manualAdjustedSeconds: existing.manualAdjustedSeconds + adjustmentSeconds,
+            activeRunCount: existing.activeRunCount,
+            hasCurrentRun: existing.hasCurrentRun,
+            currentRunId: existing.currentRunId
+        });
+    }
     return {
         mode,
         runMetrics,
@@ -154,6 +175,9 @@ export function emptyTaskTimeSummary() {
     return {
         totalTrackedSeconds: 0,
         totalCreditedSeconds: 0,
+        liveTrackedSeconds: 0,
+        liveCreditedSeconds: 0,
+        manualAdjustedSeconds: 0,
         activeRunCount: 0,
         hasCurrentRun: false,
         currentRunId: null
@@ -168,6 +192,9 @@ export function sumTaskTimeSummaries(taskIds, summaries) {
         return {
             totalTrackedSeconds: accumulator.totalTrackedSeconds + summary.totalTrackedSeconds,
             totalCreditedSeconds: roundCreditedSeconds(accumulator.totalCreditedSeconds + summary.totalCreditedSeconds),
+            liveTrackedSeconds: accumulator.liveTrackedSeconds + summary.liveTrackedSeconds,
+            liveCreditedSeconds: roundCreditedSeconds(accumulator.liveCreditedSeconds + summary.liveCreditedSeconds),
+            manualAdjustedSeconds: accumulator.manualAdjustedSeconds + summary.manualAdjustedSeconds,
             activeRunCount: accumulator.activeRunCount + summary.activeRunCount,
             hasCurrentRun: accumulator.hasCurrentRun || summary.hasCurrentRun,
             currentRunId: accumulator.currentRunId ?? summary.currentRunId