forge-openclaw-plugin 0.2.60 → 0.2.61

package/dist/server/server/src/openapi.js

@@ -28,6 +28,13 @@ const HTTP_METHODS = new Set([
     "options",
     "head"
 ]);
+const CALENDAR_PROVIDER_VALUES = [
+    "google",
+    "apple",
+    "microsoft",
+    "caldav",
+    "macos_local"
+];
 const API_TAGS = [
     {
         name: "Meta",
@@ -710,7 +717,7 @@ export function buildOpenApiDocument() {
         ],
         properties: {
             id: { type: "string" },
-            provider: { type: "string", enum: ["google", "apple", "caldav"] },
+            provider: { type: "string", enum: CALENDAR_PROVIDER_VALUES },
             label: { type: "string" },
             accountLabel: { type: "string" },
             status: {
@@ -725,6 +732,134 @@ export function buildOpenApiDocument() {
             updatedAt: { type: "string", format: "date-time" }
         }
     };
+    const calendarConnectionMutationInput = {
+        type: "object",
+        additionalProperties: true,
+        required: ["provider", "label"],
+        properties: {
+            provider: { type: "string", enum: CALENDAR_PROVIDER_VALUES },
+            label: { type: "string" },
+            username: { type: "string" },
+            password: { type: "string" },
+            serverUrl: { type: "string" },
+            authSessionId: { type: "string" },
+            sourceId: { type: "string" },
+            selectedCalendarUrls: arrayOf({ type: "string" }),
+            forgeCalendarUrl: nullable({ type: "string" }),
+            createForgeCalendar: { type: "boolean" },
+            replaceConnectionIds: arrayOf({ type: "string" })
+        }
+    };
+    const calendarConnectionPatchInput = {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+            label: { type: "string" },
+            selectedCalendarUrls: arrayOf({ type: "string" })
+        }
+    };
+    const calendarDiscoveryInput = {
+        type: "object",
+        additionalProperties: true,
+        required: ["provider"],
+        properties: {
+            provider: { type: "string", enum: ["apple", "caldav"] },
+            serverUrl: { type: "string" },
+            username: { type: "string" },
+            password: { type: "string" }
+        }
+    };
+    const calendarDiscoveryCalendar = {
+        type: "object",
+        additionalProperties: true,
+        required: [
+            "url",
+            "displayName",
+            "description",
+            "color",
+            "timezone",
+            "isPrimary",
+            "canWrite",
+            "selectedByDefault",
+            "isForgeCandidate"
+        ],
+        properties: {
+            url: { type: "string" },
+            displayName: { type: "string" },
+            dedupedName: { type: "string" },
+            description: { type: "string" },
+            color: { type: "string" },
+            timezone: { type: "string" },
+            isPrimary: { type: "boolean" },
+            canWrite: { type: "boolean" },
+            selectedByDefault: { type: "boolean" },
+            isForgeCandidate: { type: "boolean" },
+            sourceId: nullable({ type: "string" }),
+            sourceTitle: nullable({ type: "string" }),
+            sourceType: nullable({ type: "string" }),
+            calendarType: nullable({ type: "string" }),
+            hostCalendarId: nullable({ type: "string" }),
+            canonicalKey: nullable({ type: "string" })
+        }
+    };
+    const calendarDiscoveryPayload = {
+        type: "object",
+        additionalProperties: true,
+        required: [
+            "provider",
+            "accountLabel",
+            "serverUrl",
+            "principalUrl",
+            "homeUrl",
+            "calendars"
+        ],
+        properties: {
+            provider: { type: "string", enum: CALENDAR_PROVIDER_VALUES },
+            accountLabel: { type: "string" },
+            serverUrl: { type: "string" },
+            principalUrl: nullable({ type: "string" }),
+            homeUrl: nullable({ type: "string" }),
+            calendars: arrayOf(calendarDiscoveryCalendar)
+        }
+    };
+    const macOSLocalCalendarDiscoveryPayload = {
+        type: "object",
+        additionalProperties: true,
+        required: ["status", "requestedAt", "sources"],
+        properties: {
+            status: {
+                type: "string",
+                enum: [
+                    "not_determined",
+                    "denied",
+                    "restricted",
+                    "full_access",
+                    "unavailable"
+                ]
+            },
+            requestedAt: { type: "string", format: "date-time" },
+            sources: arrayOf({
+                type: "object",
+                additionalProperties: true,
+                required: [
+                    "sourceId",
+                    "sourceTitle",
+                    "sourceType",
+                    "accountLabel",
+                    "accountIdentityKey",
+                    "calendars"
+                ],
+                properties: {
+                    sourceId: { type: "string" },
+                    sourceTitle: { type: "string" },
+                    sourceType: { type: "string" },
+                    accountLabel: { type: "string" },
+                    accountIdentityKey: { type: "string" },
+                    calendars: arrayOf(calendarDiscoveryCalendar)
+                }
+            })
+        }
+    };
     const calendarResource = {
         type: "object",
         additionalProperties: false,
@@ -781,7 +916,7 @@ export function buildOpenApiDocument() {
         ],
         properties: {
             id: { type: "string" },
-            provider: { type: "string", enum: ["google", "apple", "caldav"] },
+            provider: { type: "string", enum: CALENDAR_PROVIDER_VALUES },
             connectionId: nullable({ type: "string" }),
             calendarId: nullable({ type: "string" }),
             remoteCalendarId: nullable({ type: "string" }),
@@ -3218,6 +3353,95 @@ export function buildOpenApiDocument() {
             agentTokens: arrayOf({ $ref: "#/components/schemas/AgentTokenSummary" })
         }
     };
+    const doctorFixProposal = {
+        type: "object",
+        additionalProperties: false,
+        required: ["id", "kind", "title", "description", "requiresConfirmation"],
+        properties: {
+            id: { type: "string" },
+            kind: { type: "string", enum: ["manual", "safe_auto_fix"] },
+            title: { type: "string" },
+            description: { type: "string" },
+            requiresConfirmation: { type: "boolean" }
+        }
+    };
+    const doctorCheck = {
+        type: "object",
+        additionalProperties: false,
+        required: [
+            "id",
+            "group",
+            "title",
+            "status",
+            "severity",
+            "summary",
+            "evidence",
+            "affectedCount"
+        ],
+        properties: {
+            id: { type: "string" },
+            group: { type: "string" },
+            title: { type: "string" },
+            status: { type: "string", enum: ["pass", "warn", "fail", "skipped"] },
+            severity: { type: "string", enum: ["info", "warning", "error"] },
+            summary: { type: "string" },
+            evidence: arrayOf({ type: "string" }),
+            affectedCount: { type: "integer" },
+            fix: { $ref: "#/components/schemas/DoctorFixProposal" }
+        }
+    };
+    const forgeDoctorReport = {
+        type: "object",
+        additionalProperties: true,
+        required: [
+            "ok",
+            "now",
+            "integrity",
+            "runtime",
+            "health",
+            "settingsFile",
+            "settingsSummary",
+            "checks",
+            "issues",
+            "fixProposals",
+            "warnings"
+        ],
+        properties: {
+            ok: { type: "boolean" },
+            now: { type: "string", format: "date-time" },
+            integrity: {
+                type: "object",
+                additionalProperties: true,
+                required: ["score", "status", "headline", "lastCheckedAt"],
+                properties: {
+                    score: { type: "integer" },
+                    status: { type: "string", enum: ["healthy", "warning", "critical"] },
+                    headline: { type: "string" },
+                    lastCheckedAt: { type: "string", format: "date-time" }
+                }
+            },
+            runtime: { type: "object", additionalProperties: true },
+            health: { type: "object", additionalProperties: true },
+            settingsFile: { type: "object", additionalProperties: true },
+            settingsSummary: { type: "object", additionalProperties: true },
+            checks: arrayOf({ $ref: "#/components/schemas/DoctorCheck" }),
+            issues: arrayOf({ $ref: "#/components/schemas/DoctorCheck" }),
+            fixProposals: arrayOf({
+                $ref: "#/components/schemas/DoctorFixProposal"
+            }),
+            warnings: arrayOf({ type: "string" })
+        }
+    };
+    const doctorFixResult = {
+        type: "object",
+        additionalProperties: false,
+        required: ["fixId", "status", "summary"],
+        properties: {
+            fixId: { type: "string" },
+            status: { type: "string", enum: ["applied", "skipped", "failed"] },
+            summary: { type: "string" }
+        }
+    };
     const agentOnboardingPayload = {
         type: "object",
         additionalProperties: false,
@@ -3527,6 +3751,7 @@ export function buildOpenApiDocument() {
                             additionalProperties: false,
                             required: [
                                 "classification",
+                                "aliases",
                                 "summary",
                                 "readRoutes",
                                 "writeRoutes",
@@ -3538,6 +3763,7 @@ export function buildOpenApiDocument() {
                                     type: "string",
                                     enum: ["specialized_domain_surface"]
                                 },
+                                aliases: arrayOf({ type: "string" }),
                                 summary: { type: "string" },
                                 readRoutes: {
                                     type: "object",
@@ -4674,6 +4900,11 @@ export function buildOpenApiDocument() {
                 Project: project,
                 CalendarSchedulingRules: calendarSchedulingRules,
                 CalendarConnection: calendarConnection,
+                CalendarConnectionMutationInput: calendarConnectionMutationInput,
+                CalendarConnectionPatchInput: calendarConnectionPatchInput,
+                CalendarDiscoveryInput: calendarDiscoveryInput,
+                CalendarDiscoveryPayload: calendarDiscoveryPayload,
+                MacOSLocalCalendarDiscoveryPayload: macOSLocalCalendarDiscoveryPayload,
                 CalendarResource: calendarResource,
                 CalendarEventSource: calendarEventSource,
                 CalendarEventLink: calendarEventLink,
@@ -4703,6 +4934,10 @@ export function buildOpenApiDocument() {
                 InsightsPayload: insightsPayload,
                 WeeklyReviewPayload: weeklyReviewPayload,
                 SettingsPayload: settingsPayload,
+                DoctorFixProposal: doctorFixProposal,
+                DoctorCheck: doctorCheck,
+                ForgeDoctorReport: forgeDoctorReport,
+                DoctorFixResult: doctorFixResult,
                 ExecutionSettings: executionSettings,
                 TaskRunClaimInput: taskRunClaimInput,
                 TaskRunHeartbeatInput: taskRunHeartbeatInput,
@@ -4812,6 +5047,52 @@ export function buildOpenApiDocument() {
                     }
                 }
             },
+            "/api/v1/doctor": {
+                get: {
+                    summary: "Run Forge Doctor diagnostics for runtime, settings, storage, entities, hierarchy, rewards, and fix proposals",
+                    responses: {
+                        "200": jsonResponse({
+                            type: "object",
+                            required: ["doctor"],
+                            properties: {
+                                doctor: { $ref: "#/components/schemas/ForgeDoctorReport" }
+                            }
+                        }, "Forge Doctor report")
+                    }
+                }
+            },
+            "/api/v1/doctor/fixes": {
+                post: {
+                    summary: "Apply explicitly requested safe Forge Doctor fixes",
+                    requestBody: {
+                        required: true,
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: "object",
+                                    additionalProperties: false,
+                                    properties: {
+                                        fixIds: arrayOf({ type: "string" }),
+                                        applyAllSafe: { type: "boolean" }
+                                    }
+                                }
+                            }
+                        }
+                    },
+                    responses: {
+                        "200": jsonResponse({
+                            type: "object",
+                            required: ["results", "doctor"],
+                            properties: {
+                                results: arrayOf({
+                                    $ref: "#/components/schemas/DoctorFixResult"
+                                }),
+                                doctor: { $ref: "#/components/schemas/ForgeDoctorReport" }
+                            }
+                        }, "Forge Doctor fix result")
+                    }
+                }
+            },
             "/api/v1/health/sleep": {
                 get: {
                     summary: "Read the Forge sleep overview surface",
@@ -7555,6 +7836,50 @@ export function buildOpenApiDocument() {
                     }
                 }
             },
+            "/api/v1/calendar/macos-local/discovery": {
+                get: {
+                    summary: "Discover calendars already configured on this Mac through EventKit",
+                    responses: {
+                        "200": jsonResponse({
+                            type: "object",
+                            required: ["discovery"],
+                            properties: {
+                                discovery: {
+                                    $ref: "#/components/schemas/MacOSLocalCalendarDiscoveryPayload"
+                                }
+                            }
+                        }, "macOS local calendar discovery"),
+                        default: { $ref: "#/components/responses/Error" }
+                    }
+                }
+            },
+            "/api/v1/calendar/discovery": {
+                post: {
+                    summary: "Discover Apple or custom CalDAV calendars before creating a connection",
+                    requestBody: {
+                        required: true,
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    $ref: "#/components/schemas/CalendarDiscoveryInput"
+                                }
+                            }
+                        }
+                    },
+                    responses: {
+                        "200": jsonResponse({
+                            type: "object",
+                            required: ["discovery"],
+                            properties: {
+                                discovery: {
+                                    $ref: "#/components/schemas/CalendarDiscoveryPayload"
+                                }
+                            }
+                        }, "Calendar discovery"),
+                        default: { $ref: "#/components/responses/Error" }
+                    }
+                }
+            },
             "/api/v1/calendar/connections": {
                 get: {
                     summary: "List connected calendar providers",
@@ -7573,10 +7898,7 @@ export function buildOpenApiDocument() {
                                         "connectionHelp"
                                     ],
                                     properties: {
-                                        provider: {
-                                            type: "string",
-                                            enum: ["google", "apple", "caldav"]
-                                        },
+                                        provider: { type: "string", enum: CALENDAR_PROVIDER_VALUES },
                                         label: { type: "string" },
                                         supportsDedicatedForgeCalendar: { type: "boolean" },
                                         connectionHelp: { type: "string" }
@@ -7591,8 +7913,18 @@ export function buildOpenApiDocument() {
                     }
                 },
                 post: {
-                    summary: "Create a Google, Apple, or custom CalDAV calendar connection",
+                    summary: "Create a Google, Apple, Exchange Online, local Mac, or custom CalDAV calendar connection",
                     description: "Forge first discovers the writable calendars for the account, then stores the chosen mirrored calendars and either reuses the existing shared Forge write target or saves a new one when needed.",
+                    requestBody: {
+                        required: true,
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    $ref: "#/components/schemas/CalendarConnectionMutationInput"
+                                }
+                            }
+                        }
+                    },
                     responses: {
                         "201": jsonResponse({
                             type: "object",
@@ -7607,6 +7939,65 @@ export function buildOpenApiDocument() {
                     }
                 }
             },
+            "/api/v1/calendar/connections/{id}": {
+                patch: {
+                    summary: "Update one calendar connection label or selected mirrored calendars",
+                    requestBody: {
+                        required: true,
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    $ref: "#/components/schemas/CalendarConnectionPatchInput"
+                                }
+                            }
+                        }
+                    },
+                    responses: {
+                        "200": jsonResponse({
+                            type: "object",
+                            required: ["connection"],
+                            properties: {
+                                connection: {
+                                    $ref: "#/components/schemas/CalendarConnection"
+                                }
+                            }
+                        }, "Updated calendar connection"),
+                        default: { $ref: "#/components/responses/Error" }
+                    }
+                },
+                delete: {
+                    summary: "Delete one calendar connection and stop mirroring it",
+                    responses: {
+                        "200": jsonResponse({
+                            type: "object",
+                            required: ["connection"],
+                            properties: {
+                                connection: {
+                                    $ref: "#/components/schemas/CalendarConnection"
+                                }
+                            }
+                        }, "Deleted calendar connection"),
+                        default: { $ref: "#/components/responses/Error" }
+                    }
+                }
+            },
+            "/api/v1/calendar/connections/{id}/discovery": {
+                get: {
+                    summary: "Rediscover available calendars for an existing calendar connection",
+                    responses: {
+                        "200": jsonResponse({
+                            type: "object",
+                            required: ["discovery"],
+                            properties: {
+                                discovery: {
+                                    $ref: "#/components/schemas/CalendarDiscoveryPayload"
+                                }
+                            }
+                        }, "Calendar connection discovery"),
+                        default: { $ref: "#/components/responses/Error" }
+                    }
+                }
+            },
             "/api/v1/calendar/connections/{id}/sync": {
                 post: {
                     summary: "Sync one connected calendar provider",

package/dist/server/server/src/repositories/rewards.js

@@ -27,6 +27,14 @@ const DEFAULT_RULES = [
         description: "Award a small XP bounty for each ten credited minutes of active work.",
         config: { fixedXp: 4, intervalMinutes: 10 }
     },
+    {
+        id: "reward_rule_entity_created",
+        family: "consistency",
+        code: "entity_created",
+        title: "Forge entity created",
+        description: "Award a small activity bounty when the user creates a real Forge entity.",
+        config: { fixedXp: 2 }
+    },
     {
         id: "reward_rule_task_run_completion",
         family: "completion",
@@ -673,6 +681,58 @@ export function recordTaskRunProgressRewards(taskRunId, taskId, actor, source, c
     }
     return rewards;
 }
+export function recordEntityCreationReward(input) {
+    ensureDefaultRewardRules();
+    const reversibleGroup = `entity_created:${input.entityType}:${input.entityId}`;
+    const existing = getDatabase()
+        .prepare(`SELECT
+         id, rule_id, event_log_id, entity_type, entity_id, actor, source,
+         delta_xp, reason_title, reason_summary, reversible_group,
+         reversed_by_reward_id, metadata_json, created_at
+       FROM reward_ledger
+       WHERE reversible_group = ?
+       ORDER BY created_at ASC
+       LIMIT 1`)
+        .get(reversibleGroup);
+    if (existing) {
+        return mapLedger(existing);
+    }
+    const createdAtDate = Number.isNaN(Date.parse(input.createdAt))
+        ? new Date()
+        : new Date(input.createdAt);
+    const rule = getRuleByCode("entity_created");
+    const readableType = input.entityType.replaceAll("_", " ");
+    const title = input.title?.trim() || readableType;
+    const eventLog = recordEventLog({
+        eventKind: "reward.entity_created",
+        entityType: input.entityType,
+        entityId: input.entityId,
+        actor: input.actor ?? null,
+        source: input.source ?? "system",
+        metadata: {
+            entityType: input.entityType,
+            entityId: input.entityId,
+            title,
+            createdAt: input.createdAt
+        }
+    }, createdAtDate);
+    return insertLedgerEvent({
+        ruleId: rule?.id ?? null,
+        eventLogId: eventLog.id,
+        entityType: input.entityType,
+        entityId: input.entityId,
+        actor: input.actor ?? null,
+        source: input.source ?? "system",
+        deltaXp: Number(rule?.config.fixedXp ?? 2),
+        reasonTitle: `Created ${readableType}: ${title}`,
+        reasonSummary: "Small Forge activity XP for creating something concrete.",
+        reversibleGroup,
+        metadata: {
+            entityType: input.entityType,
+            title
+        }
+    }, createdAtDate);
+}
 export function recordWorkAdjustmentReward(input) {
     const { rule, intervalMinutes, intervalSeconds, fixedXp } = getTaskRunProgressRewardCadence();
     const entityType = workAdjustmentEntityTypeSchema.parse(input.entityType);

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

@@ -84,12 +84,13 @@ function ensureDataManagementSettingsRow() {
         preferred_data_root,
         backup_directory,
         backup_frequency_hours,
+        backup_retention_days,
         auto_repair_enabled,
         last_auto_backup_at,
         last_manual_backup_at,
         created_at,
         updated_at
-      ) VALUES (1, ?, ?, NULL, 1, NULL, NULL, ?, ?)`)
+      ) VALUES (1, ?, ?, NULL, 30, 1, NULL, NULL, ?, ?)`)
         .run(dataRoot, backupDirectory, now, now);
 }
 function readDataManagementSettingsRow() {
@@ -99,6 +100,7 @@ function readDataManagementSettingsRow() {
         preferred_data_root,
         backup_directory,
         backup_frequency_hours,
+        backup_retention_days,
         auto_repair_enabled,
         last_auto_backup_at,
         last_manual_backup_at,
@@ -124,12 +126,13 @@ function writeDataManagementSettingsRow(patch) {
        SET preferred_data_root = ?,
            backup_directory = ?,
            backup_frequency_hours = ?,
+           backup_retention_days = ?,
            auto_repair_enabled = ?,
            last_auto_backup_at = ?,
            last_manual_backup_at = ?,
            updated_at = ?
        WHERE id = 1`)
-        .run(next.preferred_data_root, next.backup_directory, next.backup_frequency_hours, next.auto_repair_enabled, next.last_auto_backup_at, next.last_manual_backup_at, next.updated_at);
+        .run(next.preferred_data_root, next.backup_directory, next.backup_frequency_hours, next.backup_retention_days, next.auto_repair_enabled, next.last_auto_backup_at, next.last_manual_backup_at, next.updated_at);
 }
 function resolveCurrentDataManagementSettings() {
     const row = readDataManagementSettingsRow();
@@ -139,6 +142,7 @@ function resolveCurrentDataManagementSettings() {
         preferredDataRoot,
         backupDirectory,
         backupFrequencyHours: row.backup_frequency_hours,
+        backupRetentionDays: row.backup_retention_days,
         autoRepairEnabled: row.auto_repair_enabled === 1,
         lastAutoBackupAt: row.last_auto_backup_at,
         lastManualBackupAt: row.last_manual_backup_at
@@ -461,6 +465,7 @@ export async function createDataBackup(input = { note: "" }, options = {}) {
         }
         if (mode === "automatic") {
             writeDataManagementSettingsRow({ last_auto_backup_at: createdAt });
+            await pruneExpiredAutomaticBackups(settings.backupDirectory, settings.backupRetentionDays);
         }
         return backup;
     }
@@ -468,6 +473,27 @@ export async function createDataBackup(input = { note: "" }, options = {}) {
         await rm(sqliteSnapshot.tempDir, { recursive: true, force: true });
     }
 }
+async function pruneExpiredAutomaticBackups(backupDirectory, retentionDays) {
+    if (!retentionDays) {
+        return;
+    }
+    const cutoff = Date.now() - retentionDays * 24 * 60 * 60 * 1000;
+    const backups = await listDataBackups();
+    for (const backup of backups) {
+        if (backup.mode !== "automatic") {
+            continue;
+        }
+        if (path.resolve(backup.backupDirectory) !== path.resolve(backupDirectory)) {
+            continue;
+        }
+        const createdAtMs = new Date(backup.createdAt).getTime();
+        if (!Number.isFinite(createdAtMs) || createdAtMs >= cutoff) {
+            continue;
+        }
+        await rm(backup.archivePath, { force: true });
+        await rm(backup.manifestPath, { force: true });
+    }
+}
 async function openDatabaseSnapshot(databasePath) {
     const database = new DatabaseSync(databasePath);
     database.exec("PRAGMA busy_timeout = 250;");
@@ -643,6 +669,7 @@ export async function switchDataRoot(input, options = {}) {
         preferred_data_root: targetDataRoot,
         backup_directory: nextBackupDirectory,
         backup_frequency_hours: previousSettings.backupFrequencyHours,
+        backup_retention_days: previousSettings.backupRetentionDays,
         auto_repair_enabled: previousSettings.autoRepairEnabled ? 1 : 0
     });
     await (options.persistPreferredDataRoot ?? writeMonorepoPreferredDataRoot)(targetDataRoot);
@@ -698,6 +725,9 @@ export async function updateDataManagementSettings(input) {
         backup_frequency_hours: parsed.backupFrequencyHours !== undefined
             ? parsed.backupFrequencyHours
             : undefined,
+        backup_retention_days: parsed.backupRetentionDays !== undefined
+            ? parsed.backupRetentionDays
+            : undefined,
         auto_repair_enabled: parsed.autoRepairEnabled !== undefined
             ? parsed.autoRepairEnabled
                 ? 1