forge-openclaw-plugin 0.2.15 → 0.2.19

package/dist/server/services/context.js

@@ -1,5 +1,7 @@
 import { listActivityEvents } from "../repositories/activity-events.js";
 import { listGoals } from "../repositories/goals.js";
+import { listHabits } from "../repositories/habits.js";
+import { listRewardLedger } from "../repositories/rewards.js";
 import { listTags, listTagsByIds } from "../repositories/tags.js";
 import { listTasks } from "../repositories/tasks.js";
 import { getDashboard } from "./dashboard.js";
@@ -109,6 +111,7 @@ export function getOverviewContext(now = new Date()) {
     const dashboard = getDashboard();
     const focusTasks = dashboard.tasks.filter((task) => task.status === "focus" || task.status === "in_progress").length;
     const overdueTasks = dashboard.tasks.filter((task) => task.status !== "done" && task.dueDate !== null && task.dueDate < now.toISOString().slice(0, 10)).length;
+    const dueHabits = dashboard.habits.filter((habit) => habit.dueToday).slice(0, 6);
     return overviewContextSchema.parse({
         generatedAt: now.toISOString(),
         strategicHeader: {
@@ -124,8 +127,9 @@ export function getOverviewContext(now = new Date()) {
         projects: dashboard.projects.slice(0, 5),
         activeGoals: dashboard.goals.filter((goal) => goal.status === "active").slice(0, 6),
         topTasks: sortStrategicTasks(dashboard.tasks.filter((task) => task.status !== "done")).slice(0, 6),
+        dueHabits,
         recentEvidence: listActivityEvents({ limit: 12 }),
-        achievements: buildAchievementSignals(listGoals(), listTasks(), now),
+        achievements: buildAchievementSignals(listGoals(), listTasks(), listHabits(), now),
         domainBalance: buildDomainBalance(listGoals(), listTasks()),
         neglectedGoals: buildNeglectedGoals(listGoals(), listTasks(), now)
     });
@@ -133,10 +137,12 @@ export function getOverviewContext(now = new Date()) {
 export function getTodayContext(now = new Date()) {
     const goals = listGoals();
     const tasks = listTasks();
-    const gamification = buildGamificationProfile(goals, tasks, now);
+    const habits = listHabits();
+    const gamification = buildGamificationProfile(goals, tasks, habits, now);
     const inProgressTasks = sortStrategicTasks(tasks.filter((task) => task.status === "in_progress")).slice(0, 4);
     const readyTasks = sortStrategicTasks(tasks.filter((task) => task.status === "focus" || task.status === "backlog")).slice(0, 4);
     const deferredTasks = sortStrategicTasks(tasks.filter((task) => task.status === "blocked")).slice(0, 4);
+    const dueHabits = habits.filter((habit) => habit.dueToday).slice(0, 6);
     const completedTasks = [...tasks]
         .filter((task) => task.status === "done" && task.completedAt !== null)
         .sort((left, right) => Date.parse(right.completedAt ?? "") - Date.parse(left.completedAt ?? ""))
@@ -185,13 +191,17 @@ export function getTodayContext(now = new Date()) {
                 completed: false
             }
         ],
-        milestoneRewards: buildMilestoneRewards(goals, tasks, now),
+        dueHabits,
+        milestoneRewards: buildMilestoneRewards(goals, tasks, habits, now),
+        recentHabitRewards: listRewardLedger({ entityType: "habit", limit: 8 }),
         momentum: {
             streakDays: gamification.streakDays,
             momentumScore: gamification.momentumScore,
-            recoveryHint: overdueCount > 0
-                ? `Clear ${overdueCount} overdue task${overdueCount === 1 ? "" : "s"} to keep momentum from decaying.`
-                : "No overdue drag right now. Preserve the rhythm with one decisive completion."
+            recoveryHint: dueHabits.length > 0
+                ? `${dueHabits.length} habit${dueHabits.length === 1 ? "" : "s"} still need a check-in today. Closing one will keep momentum honest.`
+                : overdueCount > 0
+                    ? `Clear ${overdueCount} overdue task${overdueCount === 1 ? "" : "s"} to keep momentum from decaying.`
+                    : "No overdue drag right now. Preserve the rhythm with one decisive completion."
         }
     });
 }

package/dist/server/services/dashboard.js

@@ -1,5 +1,6 @@
 import { listGoals } from "../repositories/goals.js";
 import { listActivityEvents } from "../repositories/activity-events.js";
+import { listHabits } from "../repositories/habits.js";
 import { buildNotesSummaryByEntity } from "../repositories/notes.js";
 import { listTagsByIds, listTags } from "../repositories/tags.js";
 import { listTasks } from "../repositories/tasks.js";
@@ -116,6 +117,7 @@ function buildGoalSummary(tasks, goalId) {
 export function getDashboard() {
     const goals = listGoals();
     const tasks = listTasks();
+    const habits = listHabits();
     const tags = listTags();
     const now = new Date();
     const weekStart = startOfWeek(now).toISOString();
@@ -150,9 +152,9 @@ export function getDashboard() {
     const suggestedTags = tags.filter((tag) => ["value", "execution"].includes(tag.kind)).slice(0, 6);
     const owners = [...new Set(tasks.map((task) => task.owner).filter(Boolean))].sort((left, right) => left.localeCompare(right));
     const executionBuckets = buildExecutionBuckets(tasks, todayIso, weekEndIso);
-    const gamification = buildGamificationProfile(goals, tasks, now);
-    const achievements = buildAchievementSignals(goals, tasks, now);
-    const milestoneRewards = buildMilestoneRewards(goals, tasks, now);
+    const gamification = buildGamificationProfile(goals, tasks, habits, now);
+    const achievements = buildAchievementSignals(goals, tasks, habits, now);
+    const milestoneRewards = buildMilestoneRewards(goals, tasks, habits, now);
     const recentActivity = listActivityEvents({ limit: 12 });
     const notesSummaryByEntity = buildNotesSummaryByEntity();
     return dashboardPayloadSchema.parse({
@@ -160,6 +162,7 @@ export function getDashboard() {
         goals: goalCards,
         projects,
         tasks,
+        habits,
         tags,
         suggestedTags,
         owners,

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

@@ -1,14 +1,20 @@
 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";
 import { createGoal, deleteGoal, getGoalById, listGoals, updateGoal } from "../repositories/goals.js";
+import { createHabit, deleteHabit, getHabitById, listHabits, updateHabit } from "../repositories/habits.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, createNoteSchema, createProjectSchema, createTagSchema, createTaskSchema, updateGoalSchema, 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;
@@ -25,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),
@@ -34,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),
@@ -43,15 +53,30 @@ 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),
         update: (id, patch, context) => updateTask(id, patch, context),
         hardDelete: (id, context) => deleteTask(id, context)
     },
+    habit: {
+        entityType: "habit",
+        routeBase: "/api/v1/habits",
+        deleteMode: "soft_default",
+        inBin: true,
+        list: () => listHabits(),
+        get: (id) => getHabitById(id),
+        create: (data, context) => createHabit(data, context),
+        update: (id, patch, context) => updateHabit(id, patch, context),
+        hardDelete: (id, context) => deleteHabit(id, context)
+    },
     tag: {
         entityType: "tag",
         routeBase: "/api/v1/tags",
+        deleteMode: "soft_default",
+        inBin: true,
         list: () => listTags(),
         get: (id) => getTagById(id),
         create: (data, context) => createTag(data, context),
@@ -61,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),
@@ -70,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),
@@ -88,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),
@@ -97,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),
@@ -106,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),
@@ -115,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),
@@ -124,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),
@@ -133,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),
@@ -142,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),
@@ -151,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),
@@ -163,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) {
@@ -174,9 +254,13 @@ const CREATE_ENTITY_SCHEMAS = {
     goal: createGoalSchema,
     project: createProjectSchema,
     task: createTaskSchema,
+    habit: createHabitSchema,
     tag: createTagSchema,
     note: createNoteSchema,
     insight: createInsightSchema,
+    calendar_event: createCalendarEventSchema,
+    work_block_template: createWorkBlockTemplateSchema,
+    task_timebox: createTaskTimeboxSchema,
     psyche_value: createPsycheValueSchema,
     behavior_pattern: createBehaviorPatternSchema,
     behavior: createBehaviorSchema,
@@ -191,9 +275,13 @@ const UPDATE_ENTITY_SCHEMAS = {
     goal: updateGoalSchema,
     project: updateProjectSchema,
     task: updateTaskSchema,
+    habit: updateHabitSchema,
     tag: updateTagSchema,
     note: updateNoteSchema,
     insight: updateInsightSchema,
+    calendar_event: updateCalendarEventSchema,
+    work_block_template: updateWorkBlockTemplateSchema,
+    task_timebox: updateTaskTimeboxSchema,
     psyche_value: updatePsycheValueSchema,
     behavior_pattern: updateBehaviorPatternSchema,
     behavior: updateBehaviorSchema,
@@ -312,6 +400,16 @@ 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 "habit":
+            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)) ||
+                (linkedTo.entityType === "task" && Array.isArray(entity.linkedTaskIds) && entity.linkedTaskIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "psyche_value" && Array.isArray(entity.linkedValueIds) && entity.linkedValueIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "behavior_pattern" && Array.isArray(entity.linkedPatternIds) && entity.linkedPatternIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "behavior" && Array.isArray(entity.linkedBehaviorIds) && entity.linkedBehaviorIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "belief_entry" && Array.isArray(entity.linkedBeliefIds) && entity.linkedBeliefIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "mode_profile" && Array.isArray(entity.linkedModeIds) && entity.linkedModeIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "trigger_report" && Array.isArray(entity.linkedReportIds) && entity.linkedReportIds.includes(linkedTo.id)));
         case "note":
             return (Array.isArray(entity.links) &&
                 entity.links.some((link) => typeof link === "object" &&
@@ -322,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)) ||
@@ -390,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/gamification.js

@@ -12,9 +12,15 @@ function startOfWeek(date) {
 function dayKey(isoDate) {
     return isoDate.slice(0, 10);
 }
-function calculateStreak(tasks, now) {
-    const completedDays = new Set(tasks
-        .flatMap((task) => (task.status === "done" && task.completedAt !== null ? [dayKey(task.completedAt)] : [])));
+function isAlignedHabitCheckIn(habit, checkIn) {
+    return (habit.polarity === "positive" && checkIn.status === "done") || (habit.polarity === "negative" && checkIn.status === "missed");
+}
+function calculateStreak(tasks, habits, now) {
+    const completedDays = new Set([
+        ...tasks
+            .flatMap((task) => (task.status === "done" && task.completedAt !== null ? [dayKey(task.completedAt)] : [])),
+        ...habits.flatMap((habit) => habit.checkIns.filter((checkIn) => isAlignedHabitCheckIn(habit, checkIn)).map((checkIn) => checkIn.dateKey))
+    ]);
     if (completedDays.size === 0) {
         return 0;
     }
@@ -41,17 +47,27 @@ function latestCompletionForTasks(tasks) {
         .flatMap((task) => (task.completedAt ? [task.completedAt] : []))
         .sort((left, right) => Date.parse(right) - Date.parse(left))[0] ?? null;
 }
-export function buildGamificationProfile(goals, tasks, now = new Date()) {
+function latestAlignedHabitAt(habits) {
+    return habits
+        .flatMap((habit) => habit.checkIns
+        .filter((checkIn) => isAlignedHabitCheckIn(habit, checkIn))
+        .map((checkIn) => checkIn.createdAt))
+        .sort((left, right) => Date.parse(right) - Date.parse(left))[0] ?? null;
+}
+export function buildGamificationProfile(goals, tasks, habits, now = new Date()) {
     const weekStart = startOfWeek(now).toISOString();
     const doneTasks = tasks.filter((task) => task.status === "done");
     const totalXp = getTotalXp();
     const weeklyXp = getWeeklyXp(weekStart);
     const focusTasks = tasks.filter((task) => task.status === "focus" || task.status === "in_progress").length;
     const overdueTasks = tasks.filter((task) => task.status !== "done" && task.dueDate !== null && task.dueDate < now.toISOString().slice(0, 10)).length;
+    const dueHabits = habits.filter((habit) => habit.dueToday).length;
+    const alignedHabitCheckIns = habits.flatMap((habit) => habit.checkIns.filter((checkIn) => isAlignedHabitCheckIn(habit, checkIn)));
+    const habitMomentum = habits.reduce((sum, habit) => sum + habit.streakCount * 3 + (habit.dueToday ? -4 : 2), 0);
     const alignedDonePoints = doneTasks
         .filter((task) => task.goalId !== null && task.tagIds.length > 0)
         .reduce((sum, task) => sum + task.points, 0);
-    const streakDays = calculateStreak(tasks, now);
+    const streakDays = calculateStreak(tasks, habits, now);
     const levelState = calculateLevel(totalXp);
     const goalScores = goals
         .map((goal) => ({
@@ -69,17 +85,20 @@ export function buildGamificationProfile(goals, tasks, now = new Date()) {
         weeklyXp,
         streakDays,
         comboMultiplier: Number((1 + Math.min(0.75, streakDays * 0.05)).toFixed(2)),
-        momentumScore: Math.max(0, Math.min(100, Math.round(weeklyXp / 6 + alignedDonePoints / 20 + focusTasks * 5 - overdueTasks * 9))),
+        momentumScore: Math.max(0, Math.min(100, Math.round(weeklyXp / 6 + alignedDonePoints / 20 + focusTasks * 5 + alignedHabitCheckIns.length * 4 + habitMomentum - overdueTasks * 9 - dueHabits * 3))),
         topGoalId: topGoal?.goalId ?? null,
         topGoalTitle: topGoal?.goalTitle ?? null
     });
 }
-export function buildAchievementSignals(goals, tasks, now = new Date()) {
-    const profile = buildGamificationProfile(goals, tasks, now);
+export function buildAchievementSignals(goals, tasks, habits, now = new Date()) {
+    const profile = buildGamificationProfile(goals, tasks, habits, now);
     const doneTasks = tasks.filter((task) => task.status === "done");
     const alignedDoneTasks = doneTasks.filter((task) => task.goalId !== null && task.tagIds.length > 0);
     const focusTasks = tasks.filter((task) => task.status === "focus" || task.status === "in_progress");
     const highValueGoals = goals.filter((goal) => doneTasks.some((task) => task.goalId === goal.id));
+    const alignedHabitCount = habits.reduce((sum, habit) => sum + habit.checkIns.filter((checkIn) => isAlignedHabitCheckIn(habit, checkIn)).length, 0);
+    const topHabitStreak = Math.max(0, ...habits.map((habit) => habit.streakCount));
+    const latestHabitWin = latestAlignedHabitAt(habits);
     return [
         {
             id: "streak-operator",
@@ -125,15 +144,34 @@ export function buildAchievementSignals(goals, tasks, now = new Date()) {
             progressLabel: `${Math.min(focusTasks.length, 1)}/1 live directives`,
             unlocked: focusTasks.length > 0,
             unlockedAt: focusTasks.length > 0 ? now.toISOString() : null
+        },
+        {
+            id: "habit-keeper",
+            title: "Habit Keeper",
+            summary: "Turn recurring behavior into visible operating evidence.",
+            tier: alignedHabitCount >= 12 ? "gold" : alignedHabitCount >= 6 ? "silver" : "bronze",
+            progressLabel: `${Math.min(alignedHabitCount, 12)}/12 aligned habit wins`,
+            unlocked: alignedHabitCount >= 12,
+            unlockedAt: alignedHabitCount >= 12 ? latestHabitWin : null
+        },
+        {
+            id: "ritual-pressure",
+            title: "Ritual Pressure",
+            summary: "Keep one habit alive long enough that it changes the texture of the week.",
+            tier: topHabitStreak >= 10 ? "gold" : "silver",
+            progressLabel: `${Math.min(topHabitStreak, 10)}/10 habit streak`,
+            unlocked: topHabitStreak >= 10,
+            unlockedAt: topHabitStreak >= 10 ? latestHabitWin : null
         }
     ].map((achievement) => achievementSignalSchema.parse(achievement));
 }
-export function buildMilestoneRewards(goals, tasks, now = new Date()) {
-    const profile = buildGamificationProfile(goals, tasks, now);
+export function buildMilestoneRewards(goals, tasks, habits, now = new Date()) {
+    const profile = buildGamificationProfile(goals, tasks, habits, now);
     const doneTasks = tasks.filter((task) => task.status === "done");
     const topGoal = profile.topGoalId ? goals.find((goal) => goal.id === profile.topGoalId) ?? null : null;
     const topGoalXp = topGoal ? doneTasks.filter((task) => task.goalId === topGoal.id).reduce((sum, task) => sum + task.points, 0) : 0;
     const completedToday = doneTasks.filter((task) => task.completedAt?.slice(0, 10) === now.toISOString().slice(0, 10)).length;
+    const alignedHabitCount = habits.reduce((sum, habit) => sum + habit.checkIns.filter((checkIn) => isAlignedHabitCheckIn(habit, checkIn)).length, 0);
     return [
         {
             id: "next-level",
@@ -174,13 +212,23 @@ export function buildMilestoneRewards(goals, tasks, now = new Date()) {
             current: topGoal ? topGoalXp : 0,
             target: topGoal ? topGoal.targetPoints : 1,
             completed: topGoal ? topGoalXp >= topGoal.targetPoints : false
+        },
+        {
+            id: "habit-mass",
+            title: "Habit mass threshold",
+            summary: "Make recurring behavior part of the same reward engine as tasks and projects.",
+            rewardLabel: "Consistency cache +75 xp",
+            progressLabel: `${Math.min(alignedHabitCount, 14)}/14 aligned habit check-ins`,
+            current: alignedHabitCount,
+            target: 14,
+            completed: alignedHabitCount >= 14
         }
     ].map((reward) => milestoneRewardSchema.parse(reward));
 }
-export function buildXpMomentumPulse(goals, tasks, now = new Date()) {
-    const profile = buildGamificationProfile(goals, tasks, now);
-    const achievements = buildAchievementSignals(goals, tasks, now);
-    const milestoneRewards = buildMilestoneRewards(goals, tasks, now);
+export function buildXpMomentumPulse(goals, tasks, habits, now = new Date()) {
+    const profile = buildGamificationProfile(goals, tasks, habits, now);
+    const achievements = buildAchievementSignals(goals, tasks, habits, now);
+    const milestoneRewards = buildMilestoneRewards(goals, tasks, habits, now);
     const nextMilestone = milestoneRewards.find((reward) => !reward.completed) ?? milestoneRewards[0] ?? null;
     const unlockedAchievements = achievements.filter((achievement) => achievement.unlocked).length;
     const status = profile.momentumScore >= 80 ? "surging" : profile.momentumScore >= 60 ? "steady" : "recovering";
@@ -206,10 +254,10 @@ export function buildXpMomentumPulse(goals, tasks, now = new Date()) {
         nextMilestoneLabel: nextMilestone?.rewardLabel ?? "Keep building visible momentum"
     };
 }
-export function buildGamificationOverview(goals, tasks, now = new Date()) {
+export function buildGamificationOverview(goals, tasks, habits, now = new Date()) {
     return gamificationOverviewSchema.parse({
-        profile: buildGamificationProfile(goals, tasks, now),
-        achievements: buildAchievementSignals(goals, tasks, now),
-        milestoneRewards: buildMilestoneRewards(goals, tasks, now)
+        profile: buildGamificationProfile(goals, tasks, habits, now),
+        achievements: buildAchievementSignals(goals, tasks, habits, now),
+        milestoneRewards: buildMilestoneRewards(goals, tasks, habits, now)
     });
 }

package/dist/server/services/insights.js

@@ -1,6 +1,7 @@
 import { listActivityEvents } from "../repositories/activity-events.js";
 import { listInsights } from "../repositories/collaboration.js";
 import { listGoals } from "../repositories/goals.js";
+import { listHabits } from "../repositories/habits.js";
 import { listTasks } from "../repositories/tasks.js";
 import { getOverviewContext } from "./context.js";
 import { buildGamificationProfile } from "./gamification.js";
@@ -33,7 +34,7 @@ function buildHeatmap(tasks, now) {
 export function getInsightsPayload(now = new Date()) {
     const goals = listGoals();
     const tasks = listTasks();
-    const gamification = buildGamificationProfile(goals, tasks, now);
+    const gamification = buildGamificationProfile(goals, tasks, listHabits(), now);
     const overview = getOverviewContext(now);
     const activity = listActivityEvents({ limit: 60 });
     const trends = Array.from({ length: 6 }, (_, offset) => {

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
         });
     });
 }