@agent-plan/server 0.2.19 → 0.2.21

package/dist/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAuIpC,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACzF,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACrC;AAo0BD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,KAAK,CAAC;IACX,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6EvE"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAuIpC,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACzF,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACrC;AAg4BD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,KAAK,CAAC;IACX,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6EvE"}

package/dist/serve.js

@@ -251,6 +251,7 @@ function createApiApp(store, hubRef, apiPrefix = "", uiConfig, isBusy) {
             priority,
             name,
             description: body.description ?? "",
+            descriptionUpdatedAt: now,
             status: "planned",
             discussedAt: "",
             contextReady: false,
@@ -368,6 +369,7 @@ function createApiApp(store, hubRef, apiPrefix = "", uiConfig, isBusy) {
                 contextReadyReason: "",
                 summary: body.summary ?? "",
                 description: body.description ?? "",
+                descriptionUpdatedAt: now,
                 notes: "",
                 goals: [],
                 nonGoals: [],
@@ -471,6 +473,8 @@ function createApiApp(store, hubRef, apiPrefix = "", uiConfig, isBusy) {
         const title = body.title?.trim();
         if (!title)
             return c.json({ error: "title required" }, 400);
+        if (body.status === "paused")
+            return c.json({ error: "A task cannot be created paused without an in-progress checkpoint. Create it planned, then use task_pause/task_switch." }, 400);
         const phase = await store.loadPhase(phaseId).catch(() => null);
         if (!phase)
             return c.json({ error: "phase not found" }, 404);
@@ -499,6 +503,7 @@ function createApiApp(store, hubRef, apiPrefix = "", uiConfig, isBusy) {
             title,
             status: initialStatus,
             description: body.description ?? "",
+            descriptionUpdatedAt: now,
             notes: "",
             statusLog: [],
             decisions: [],
@@ -506,6 +511,8 @@ function createApiApp(store, hubRef, apiPrefix = "", uiConfig, isBusy) {
             checklist: checklistItems,
             subtasks: [],
             dependsOn: [],
+            pauseSnapshot: null,
+            pauseHistory: [],
             startedAt: initialStatus === "in-progress" || initialStatus === "done" ? now : "",
             completedAt: initialStatus === "done" ? now : "",
             createdAt: now,
@@ -566,6 +573,56 @@ function createApiApp(store, hubRef, apiPrefix = "", uiConfig, isBusy) {
         }
         return c.json(Array.from(activeTasksMap.values()));
     });
+    app.get(route("/tasks/focus"), async (c) => {
+        const [phases, featuresDoc, project] = await Promise.all([
+            store.loadAllPhases(), store.loadFeatures(), store.loadProject(),
+        ]);
+        const featureIdToNum = new Map(featuresDoc.features.map((feature) => [feature.id, feature.number]));
+        const openReturn = [...project.workDeviations]
+            .filter((deviation) => deviation.state === "resume-required" || deviation.state === "resolved")
+            .sort((left, right) => right.createdAt.localeCompare(left.createdAt));
+        const pendingByTask = new Map();
+        for (const deviation of openReturn) {
+            if (!pendingByTask.has(deviation.resumeTaskId))
+                pendingByTask.set(deviation.resumeTaskId, deviation);
+        }
+        const pendingOrder = new Map(openReturn.map((deviation, index) => [deviation.id, index]));
+        const active = [];
+        const paused = [];
+        const pendingResume = [];
+        for (const phase of phases) {
+            if (!phase.featureId)
+                continue;
+            for (const task of phase.tasks) {
+                const deviation = pendingByTask.get(task.id);
+                if (task.status !== "in-progress" && task.status !== "paused" && !deviation)
+                    continue;
+                const summary = {
+                    id: task.id,
+                    number: task.number,
+                    shortId: task.shortId,
+                    title: task.title,
+                    phaseId: phase.id,
+                    phaseNumber: phase.number,
+                    featureId: phase.featureId,
+                    featureNumber: featureIdToNum.get(phase.featureId) ?? 0,
+                    status: task.status,
+                    pauseSnapshot: task.pauseSnapshot ?? deviation?.snapshot ?? null,
+                    pendingResume: Boolean(deviation),
+                    deviationId: deviation?.id ?? "",
+                };
+                if (deviation)
+                    pendingResume.push(summary);
+                else if (task.status === "in-progress")
+                    active.push(summary);
+                else if (task.status === "paused")
+                    paused.push(summary);
+            }
+        }
+        pendingResume.sort((left, right) => (pendingOrder.get(left.deviationId) ?? Number.MAX_SAFE_INTEGER) - (pendingOrder.get(right.deviationId) ?? Number.MAX_SAFE_INTEGER));
+        paused.sort((left, right) => (right.pauseSnapshot?.pausedAt ?? "").localeCompare(left.pauseSnapshot?.pausedAt ?? ""));
+        return c.json({ active, paused, pendingResume });
+    });
     app.get(route("/tasks/:id"), async (c) => {
         const taskId = c.req.param("id");
         const phases = await store.loadAllPhases();
@@ -587,6 +644,9 @@ function createApiApp(store, hubRef, apiPrefix = "", uiConfig, isBusy) {
         const existing = phase.tasks.find((t) => t.id === taskId);
         if (!existing)
             return c.json({ error: "task not found" }, 404);
+        if (body.status && body.status !== existing.status && (body.status === "paused" || existing.status === "paused")) {
+            return c.json({ error: "Paused lifecycle transitions require task_pause/task_switch/task_start so the resume checkpoint and return stack remain consistent." }, 400);
+        }
         // Validate motivation requirement for status transitions.
         if (body.status && body.status !== existing.status && needsMotivation(existing.status, body.status)) {
             if (!body.motivation || !body.motivation.trim()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-plan/server",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "private": false,
   "description": "Local HTTP/WebSocket server for Agent Plan dashboards and planner APIs.",
   "license": "MIT",
@@ -41,7 +41,7 @@
     "@hono/node-server": "^1.14.0",
     "hono": "^4.7.0",
     "ws": "^8.18.0",
-    "@agent-plan/core": "0.2.19"
+    "@agent-plan/core": "0.2.21"
   },
   "devDependencies": {
     "@types/ws": "^8.18.0"