@akalsey/sapience-goals 0.1.2 → 0.2.1

package/dist/src/events.js

@@ -0,0 +1,12 @@
+import { appendFile, mkdir } from "fs/promises";
+import { dirname } from "path";
+export async function appendEvent(eventsPath, event) {
+    try {
+        const full = { ...event, ts: event.ts ?? new Date().toISOString() };
+        await mkdir(dirname(eventsPath), { recursive: true });
+        await appendFile(eventsPath, JSON.stringify(full) + "\n", "utf-8");
+    }
+    catch {
+        // Observability must never break the host plugin.
+    }
+}

package/dist/src/service.js

@@ -5,6 +5,7 @@ import { resolveDataPath, generateId, isWithinActiveHours, nextWeeklyDate } from
 import { loadGoals, saveGoals, addGoal, updateNextDelivery } from "./goal-store.js";
 import { readNewGoals, savePosition } from "./inbox-reader.js";
 import { deliverDecomposition, deliverWeeklyStatus } from "./delivery.js";
+import { appendEvent } from "./events.js";
 function mergeConfig(raw, workspaceDir) {
     return {
         ...DEFAULT_CONFIG,
@@ -14,6 +15,7 @@ function mergeConfig(raw, workspaceDir) {
             ...DEFAULT_CONFIG.output,
             ...(raw.output ?? {}),
             goalsPath: resolveDataPath(raw.output?.goalsPath, workspaceDir, DEFAULT_CONFIG.output.goalsPath),
+            eventsPath: resolveDataPath(raw.output?.eventsPath, workspaceDir, DEFAULT_CONFIG.output.eventsPath),
         },
         inboxPath: resolveDataPath(raw.inboxPath, workspaceDir, DEFAULT_CONFIG.inboxPath),
         inboxPositionPath: resolveDataPath(raw.inboxPositionPath, workspaceDir, DEFAULT_CONFIG.inboxPositionPath),
@@ -27,6 +29,8 @@ export default definePluginEntry({
     name: "Sapience Goals",
     description: "Persistent fuzzy goal tracking with weekly status delivery",
     register(api) {
+        if (!api.runtime?.agent?.resolveAgentWorkspaceDir)
+            return;
         const workspaceDir = api.runtime.agent.resolveAgentWorkspaceDir(api.pluginConfig);
         const config = mergeConfig(api.pluginConfig, workspaceDir);
         api.registerTool({
@@ -58,6 +62,7 @@ export default definePluginEntry({
                     goals = addGoal(goals, goal);
                     await saveGoals(goals, config.output.goalsPath);
                     await deliverDecomposition(description, api);
+                    await appendEvent(config.output.eventsPath, { plugin: "goals", type: "goal_created", goal_id: goal.id });
                     return { content: [{ type: "text", text: JSON.stringify({ id: goal.id }) }] };
                 }
                 catch (err) {
@@ -72,6 +77,7 @@ export default definePluginEntry({
             async execute(_id, _params) {
                 try {
                     if (!isWithinActiveHours(config)) {
+                        await appendEvent(config.output.eventsPath, { plugin: "goals", type: "check_skipped", reason: "outside_hours" });
                         return { content: [{ type: "text", text: "SILENT_REPLY_TOKEN" }] };
                     }
                     let goals = await loadGoals(config.output.goalsPath);
@@ -91,17 +97,24 @@ export default definePluginEntry({
                         };
                         goals = addGoal(goals, goal);
                         await deliverDecomposition(description, api);
+                        await appendEvent(config.output.eventsPath, { plugin: "goals", type: "goal_created", goal_id: goal.id });
                     }
                     if (newDescriptions.length > 0) {
                         await savePosition(newPosition, config.inboxPositionPath);
                     }
+                    let delivered = 0;
                     for (const goal of goals) {
                         if (isWeeklyCheckInDue(goal)) {
                             await deliverWeeklyStatus(goal, api);
+                            delivered++;
+                            await appendEvent(config.output.eventsPath, { plugin: "goals", type: "status_delivered", goal_id: goal.id });
                             goals = updateNextDelivery(goals, goal.id, nextWeeklyDate(config.weeklyCheckInDay, config.weeklyCheckInTime, config.activeHours.timezone));
                         }
                     }
                     await saveGoals(goals, config.output.goalsPath);
+                    if (newDescriptions.length === 0 && delivered === 0) {
+                        await appendEvent(config.output.eventsPath, { plugin: "goals", type: "check_skipped", reason: "nothing_due" });
+                    }
                     return { content: [{ type: "text", text: "SILENT_REPLY_TOKEN" }] };
                 }
                 catch (err) {

package/dist/src/types.js

@@ -5,5 +5,5 @@ export const DEFAULT_CONFIG = {
     weeklyCheckInTime: "09:00",
     inboxPath: "goals/inbox.md",
     inboxPositionPath: "goals/inbox-position.json",
-    output: { goalsPath: "goals/goals.json" },
+    output: { goalsPath: "goals/goals.json", eventsPath: "sapience/events.jsonl" },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akalsey/sapience-goals",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {