@agent-plan/server 0.2.22-next.2 → 0.2.22-next.3

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;AA8IpC,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;AA65BD,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;AA8IpC,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;AA69BD,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

@@ -6,7 +6,7 @@ import { fileURLToPath } from "node:url";
 import { createAdaptorServer } from "@hono/node-server";
 import { Hono } from "hono";
 import { cors } from "hono/cors";
-import { ExportService, PlanStore, PlanStoreError, createFeatureId, createPhaseId, createChecklistItemId, createTaskId, findPhaseByRef, normalizeSlug, withFeatureLock, needsMotivation } from "@agent-plan/core";
+import { ExportService, PlanStore, PlanStoreError, createFeatureId, createPhaseId, createChecklistItemId, createTaskId, findPhaseByRef, normalizeSlug, withFeatureLock, needsMotivation, checkExplicitTaskStart, recommendNextTask } from "@agent-plan/core";
 import { WsHub } from "./ws-hub.js";
 // ─── Watcher ────────────────────────────────────────────────────────────
 let watcherAbort = null;
@@ -634,6 +634,71 @@ function createApiApp(store, hubRef, apiPrefix = "", uiConfig, isBusy) {
         });
         return c.json({ active, pendingResume });
     });
+    /** Canonical HTTP task-entry path. Generic task updates must never start work,
+     * because start/resume is responsible for clearing checkpoints and closing
+     * any matching return-stack deviation. */
+    app.post(route("/tasks/:id/start"), async (c) => {
+        const taskId = c.req.param("id");
+        const [phases, featuresDoc, project] = await Promise.all([
+            store.loadAllPhases(), store.loadFeatures(), store.loadProject(),
+        ]);
+        const phase = phases.find((entry) => entry.tasks.some((task) => task.id === taskId));
+        const existing = phase?.tasks.find((task) => task.id === taskId);
+        if (!phase || !existing)
+            return c.json({ error: "task not found" }, 404);
+        if (existing.status === "in-progress")
+            return c.json({ error: "task is already in-progress" }, 400);
+        const eligibility = checkExplicitTaskStart(featuresDoc.features, phases, existing.id, project.workDeviations);
+        if (!eligibility.eligible)
+            return c.json({ error: `Task start denied: ${eligibility.reason}` }, 400);
+        const selection = recommendNextTask(featuresDoc.features, phases, project.workDeviations);
+        if (selection.kind === "conflict")
+            return c.json({ error: selection.reason }, 409);
+        if (selection.kind === "active" && selection.candidate?.task.id !== existing.id) {
+            return c.json({ error: `Task start denied: another task is active. Use task_switch to checkpoint it before starting this task.` }, 409);
+        }
+        const now = nowISO();
+        let updated;
+        if (existing.pauseSnapshot) {
+            updated = await store.resumeTask(phase.id, existing.id, now);
+        }
+        else {
+            await store.updatePhase(phase.id, (current) => {
+                const task = current.tasks.find((entry) => entry.id === existing.id);
+                if (!task)
+                    return current;
+                const previousStatus = task.status;
+                applyTaskLifecycleDates(task, "in-progress", now);
+                task.statusLog = [...(task.statusLog ?? []), {
+                        id: createTaskId(),
+                        date: now,
+                        fromStatus: previousStatus,
+                        toStatus: "in-progress",
+                        title: `${previousStatus} → in-progress`,
+                        description: "",
+                    }];
+                task.updatedAt = now;
+                current.updatedAt = now;
+                updated = task;
+                return current;
+            });
+        }
+        const approvedDeviation = project.workDeviations.find((deviation) => deviation.temporaryTaskId === existing.id && deviation.state === "approved");
+        if (approvedDeviation)
+            await store.setWorkDeviationState(approvedDeviation.id, "active", now);
+        const resumedDeviation = project.workDeviations
+            .filter((deviation) => deviation.resumeTaskId === existing.id
+            && (deviation.state === "resume-required" || deviation.state === "resolved"))
+            .sort((left, right) => right.createdAt.localeCompare(left.createdAt))[0];
+        if (resumedDeviation)
+            await store.setWorkDeviationState(resumedDeviation.id, "resumed", now);
+        await store.syncTaskStatusRollup(phase.id);
+        await store.writeGenerated();
+        hub()?.broadcast({ type: "phases-updated", data: { action: "task-started", id: phase.id, phaseId: phase.id, featureId: phase.featureId ?? "", taskId } });
+        hub()?.broadcast({ type: "plan-rendered", data: {} });
+        await store.appendActivity("task_status", existing.id, `Task ${existing.id} → in-progress`);
+        return c.json(updated ?? existing);
+    });
     app.get(route("/tasks/:id"), async (c) => {
         const taskId = c.req.param("id");
         const phases = await store.loadAllPhases();
@@ -655,8 +720,8 @@ 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") || (existing.pauseSnapshot && body.status === "in-progress"))) {
-            return c.json({ error: "Resume checkpoint lifecycle transitions require task_pause/task_switch/task_start so the checkpoint and return stack remain consistent." }, 400);
+        if (body.status && body.status !== existing.status && (body.status === "in-progress" || body.status === "paused" || existing.status === "paused")) {
+            return c.json({ error: "Task start/resume transitions require POST /tasks/:id/start so lifecycle state, checkpoints, and return stacks remain consistent." }, 400);
         }
         // Validate motivation requirement for status transitions. The Web UI is the
         // human supervisor and is exempt (X-Planner-Source: web-ui) — agents calling

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-plan/server",
-  "version": "0.2.22-next.2",
+  "version": "0.2.22-next.3",
   "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.22-next.2"
+    "@agent-plan/core": "0.2.22-next.3"
   },
   "devDependencies": {
     "@types/ws": "^8.18.0"