@agent-plan/core 0.2.19-next.16 → 0.2.19-next.18

package/dist/display-status.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Derived parent display-status layer.
+ *
+ * Parent entities (feature, phase) need a presentation-oriented summary of
+ * their children's workflow states that reads clearly in the Web UI, without
+ * overloading the canonical workflow statuses persisted in planner data.
+ *
+ * This module introduces two PARENT-ONLY derived presentation states:
+ * - `started`: the entity has clearly begun (historical progress exists) but
+ *   no child is active now, and the unfinished remainder is mixed or cannot
+ *   honestly collapse to one specific workflow label.
+ * - `closed`: every child is terminal, but outcomes are mixed (e.g.
+ *   `done + canceled`, `canceled + rejected`).
+ *
+ * These are NEVER persisted: they are computed on demand from children's
+ * canonical workflow statuses. The canonical workflow model
+ * (`planned | in-progress | waiting | blocked | deferred | done | canceled |
+ * rejected`) is unchanged.
+ */
+import type { TaskStatus, PhaseStatus } from "./schema.js";
+/**
+ * Canonical workflow status values used by tasks, phases, and features.
+ * Mirrors the union of TaskStatus and PhaseStatus used in the planner data.
+ */
+export type WorkflowStatus = "planned" | "in-progress" | "waiting" | "blocked" | "deferred" | "done" | "canceled" | "rejected";
+/**
+ * Display status adds parent-only presentation states on top of workflow
+ * statuses. Only parent entities (feature, phase) use the full union; leaf
+ * tasks always use plain WorkflowStatus.
+ */
+export type DisplayStatus = WorkflowStatus | "started" | "closed";
+/** Per-status counts for a set of children. */
+export interface StatusBreakdown {
+    planned: number;
+    inProgress: number;
+    waiting: number;
+    blocked: number;
+    deferred: number;
+    done: number;
+    canceled: number;
+    rejected: number;
+}
+/** Derived presentation snapshot for a parent entity. */
+export interface ParentDisplay {
+    /** Single presentation status for badges/summaries. */
+    displayStatus: DisplayStatus;
+    /** Counts of children per canonical workflow status. */
+    breakdown: StatusBreakdown;
+    /** True when at least one meaningful child is not `planned`
+     *  (i.e. the entity has clearly begun). */
+    hasStarted: boolean;
+    /** Total number of children (including canceled/rejected). */
+    totalChildren: number;
+    /** Meaningful children count (canceled/rejected excluded). */
+    meaningfulChildren: number;
+}
+/** Count children per canonical workflow status. Pure; does not mutate input. */
+export declare function countBreakdown(statuses: readonly WorkflowStatus[]): StatusBreakdown;
+/**
+ * Derive the parent display snapshot from its children's canonical statuses.
+ *
+ * Algorithm (locked by P039 accepted decisions):
+ *  1. If any meaningful child is active now → `in-progress`.
+ *  2. If every child is terminal:
+ *       - all `done` → `done`
+ *       - all `canceled` → `canceled`
+ *       - all `rejected` → `rejected`
+ *       - otherwise → `closed` (mixed terminal outcomes)
+ *  3. Compute `unfinished = meaningful ∩ OPEN`.
+ *       - homogeneous `waiting` → `waiting`
+ *       - homogeneous `blocked` → `blocked`
+ *       - homogeneous `deferred` → `deferred`
+ *  4. If all unfinished are `planned` and the entity has not started → `planned`.
+ *  5. Fallback → `started` (mixed non-active remainder, or planned with
+ *     historical progress).
+ *
+ * Edge cases:
+ *  - empty input → `planned` (a parent with no meaningful children yet reads
+ *    as not started; this is the least surprising default for empty phases).
+ *  - `meaningful` excludes `canceled` and `rejected` (terminal non-positive).
+ *  - `hasStarted = meaningful.some(s => s !== "planned")`.
+ *
+ * Pure and non-persisting. Never mutates the input array.
+ */
+export declare function deriveParentDisplay(childStatuses: readonly WorkflowStatus[]): ParentDisplay;
+/**
+ * Narrow an arbitrary canonical status string to a WorkflowStatus.
+ * Useful for adapters that hold the union of task/phase statuses.
+ * Returns `null` when the value is not a recognized workflow status.
+ */
+export declare function toWorkflowStatus(value: string): WorkflowStatus | null;
+/**
+ * Convert a canonical task/phase status into the workflow status union used
+ * by the display layer. Accepts the extra phase statuses and maps them:
+ * - `discovery` → `in-progress` (a phase in discovery is active work)
+ * - `draft` → `planned` (a draft phase has no tasks yet → not started)
+ */
+export declare function fromCanonicalStatus(status: TaskStatus | PhaseStatus): WorkflowStatus;
+//# sourceMappingURL=display-status.d.ts.map

package/dist/display-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-status.d.ts","sourceRoot":"","sources":["../src/display-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,aAAa,GACb,SAAS,GACT,SAAS,GACT,UAAU,GACV,MAAM,GACN,UAAU,GACV,UAAU,CAAC;AAEf;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElE,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,aAAa,EAAE,aAAa,CAAC;IAC7B,wDAAwD;IACxD,SAAS,EAAE,eAAe,CAAC;IAC3B;+CAC2C;IAC3C,UAAU,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAMD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,eAAe,CAkBnF;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,SAAS,cAAc,EAAE,GAAG,aAAa,CAiE3F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAcrE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAIpF"}

package/dist/display-status.js

@@ -0,0 +1,176 @@
+/**
+ * Derived parent display-status layer.
+ *
+ * Parent entities (feature, phase) need a presentation-oriented summary of
+ * their children's workflow states that reads clearly in the Web UI, without
+ * overloading the canonical workflow statuses persisted in planner data.
+ *
+ * This module introduces two PARENT-ONLY derived presentation states:
+ * - `started`: the entity has clearly begun (historical progress exists) but
+ *   no child is active now, and the unfinished remainder is mixed or cannot
+ *   honestly collapse to one specific workflow label.
+ * - `closed`: every child is terminal, but outcomes are mixed (e.g.
+ *   `done + canceled`, `canceled + rejected`).
+ *
+ * These are NEVER persisted: they are computed on demand from children's
+ * canonical workflow statuses. The canonical workflow model
+ * (`planned | in-progress | waiting | blocked | deferred | done | canceled |
+ * rejected`) is unchanged.
+ */
+const ACTIVE = new Set(["in-progress"]);
+const OPEN = new Set(["planned", "waiting", "blocked", "deferred"]);
+const TERMINAL = new Set(["done", "canceled", "rejected"]);
+/** Count children per canonical workflow status. Pure; does not mutate input. */
+export function countBreakdown(statuses) {
+    const breakdown = {
+        planned: 0, inProgress: 0, waiting: 0, blocked: 0,
+        deferred: 0, done: 0, canceled: 0, rejected: 0,
+    };
+    for (const s of statuses) {
+        switch (s) {
+            case "planned":
+                breakdown.planned++;
+                break;
+            case "in-progress":
+                breakdown.inProgress++;
+                break;
+            case "waiting":
+                breakdown.waiting++;
+                break;
+            case "blocked":
+                breakdown.blocked++;
+                break;
+            case "deferred":
+                breakdown.deferred++;
+                break;
+            case "done":
+                breakdown.done++;
+                break;
+            case "canceled":
+                breakdown.canceled++;
+                break;
+            case "rejected":
+                breakdown.rejected++;
+                break;
+        }
+    }
+    return breakdown;
+}
+function emptyBreakdown() {
+    return { planned: 0, inProgress: 0, waiting: 0, blocked: 0, deferred: 0, done: 0, canceled: 0, rejected: 0 };
+}
+/**
+ * Derive the parent display snapshot from its children's canonical statuses.
+ *
+ * Algorithm (locked by P039 accepted decisions):
+ *  1. If any meaningful child is active now → `in-progress`.
+ *  2. If every child is terminal:
+ *       - all `done` → `done`
+ *       - all `canceled` → `canceled`
+ *       - all `rejected` → `rejected`
+ *       - otherwise → `closed` (mixed terminal outcomes)
+ *  3. Compute `unfinished = meaningful ∩ OPEN`.
+ *       - homogeneous `waiting` → `waiting`
+ *       - homogeneous `blocked` → `blocked`
+ *       - homogeneous `deferred` → `deferred`
+ *  4. If all unfinished are `planned` and the entity has not started → `planned`.
+ *  5. Fallback → `started` (mixed non-active remainder, or planned with
+ *     historical progress).
+ *
+ * Edge cases:
+ *  - empty input → `planned` (a parent with no meaningful children yet reads
+ *    as not started; this is the least surprising default for empty phases).
+ *  - `meaningful` excludes `canceled` and `rejected` (terminal non-positive).
+ *  - `hasStarted = meaningful.some(s => s !== "planned")`.
+ *
+ * Pure and non-persisting. Never mutates the input array.
+ */
+export function deriveParentDisplay(childStatuses) {
+    const statuses = childStatuses;
+    const breakdown = countBreakdown(statuses);
+    const totalChildren = statuses.length;
+    if (totalChildren === 0) {
+        return {
+            displayStatus: "planned",
+            breakdown: emptyBreakdown(),
+            hasStarted: false,
+            totalChildren: 0,
+            meaningfulChildren: 0,
+        };
+    }
+    // Meaningful set excludes terminal non-positive outcomes.
+    const meaningful = statuses.filter((s) => s !== "canceled" && s !== "rejected");
+    const meaningfulChildren = meaningful.length;
+    const hasStarted = meaningful.some((s) => s !== "planned");
+    // 1. Active child work exists now.
+    if (meaningful.some((s) => ACTIVE.has(s))) {
+        return { displayStatus: "in-progress", breakdown, hasStarted, totalChildren, meaningfulChildren };
+    }
+    // 2. All children are terminal.
+    if (statuses.every((s) => TERMINAL.has(s))) {
+        if (statuses.every((s) => s === "done")) {
+            return { displayStatus: "done", breakdown, hasStarted, totalChildren, meaningfulChildren };
+        }
+        if (statuses.every((s) => s === "canceled")) {
+            return { displayStatus: "canceled", breakdown, hasStarted, totalChildren, meaningfulChildren };
+        }
+        if (statuses.every((s) => s === "rejected")) {
+            return { displayStatus: "rejected", breakdown, hasStarted, totalChildren, meaningfulChildren };
+        }
+        return { displayStatus: "closed", breakdown, hasStarted, totalChildren, meaningfulChildren };
+    }
+    // 3. Unfinished meaningful remainder.
+    const unfinished = meaningful.filter((s) => OPEN.has(s));
+    const allWaiting = unfinished.length > 0 && unfinished.every((s) => s === "waiting");
+    if (allWaiting) {
+        return { displayStatus: "waiting", breakdown, hasStarted, totalChildren, meaningfulChildren };
+    }
+    const allBlocked = unfinished.length > 0 && unfinished.every((s) => s === "blocked");
+    if (allBlocked) {
+        return { displayStatus: "blocked", breakdown, hasStarted, totalChildren, meaningfulChildren };
+    }
+    const allDeferred = unfinished.length > 0 && unfinished.every((s) => s === "deferred");
+    if (allDeferred) {
+        return { displayStatus: "deferred", breakdown, hasStarted, totalChildren, meaningfulChildren };
+    }
+    // 4. All unfinished are planned and the entity has never started.
+    const allPlanned = unfinished.length > 0 && unfinished.every((s) => s === "planned");
+    if (allPlanned && !hasStarted) {
+        return { displayStatus: "planned", breakdown, hasStarted, totalChildren, meaningfulChildren };
+    }
+    // 5. Fallback: started (mixed non-active remainder, or planned with history).
+    return { displayStatus: "started", breakdown, hasStarted, totalChildren, meaningfulChildren };
+}
+/**
+ * Narrow an arbitrary canonical status string to a WorkflowStatus.
+ * Useful for adapters that hold the union of task/phase statuses.
+ * Returns `null` when the value is not a recognized workflow status.
+ */
+export function toWorkflowStatus(value) {
+    switch (value) {
+        case "planned":
+        case "in-progress":
+        case "waiting":
+        case "blocked":
+        case "deferred":
+        case "done":
+        case "canceled":
+        case "rejected":
+            return value;
+        default:
+            return null;
+    }
+}
+/**
+ * Convert a canonical task/phase status into the workflow status union used
+ * by the display layer. Accepts the extra phase statuses and maps them:
+ * - `discovery` → `in-progress` (a phase in discovery is active work)
+ * - `draft` → `planned` (a draft phase has no tasks yet → not started)
+ */
+export function fromCanonicalStatus(status) {
+    if (status === "discovery")
+        return "in-progress";
+    if (status === "draft")
+        return "planned";
+    return status;
+}

package/dist/index.d.ts

@@ -3,7 +3,8 @@ export * from "./refs.js";
 export * from "./schema.js";
 export * from "./checklist.js";
 export * from "./recap.js";
-export { PlanStore, PlanStoreError, setWriteBusyHook, setWriteNotifyHook, migrateToUuids, migrateToGlobalSequence, withFeatureLock, type PhaseHandoffSummary } from "./plan-store.js";
+export * from "./display-status.js";
+export { PlanStore, PlanStoreError, setWriteBusyHook, setWriteNotifyHook, migrateToUuids, migrateToGlobalSequence, withFeatureLock, type PhaseHandoffSummary, type OrphanPhaseSummary } from "./plan-store.js";
 export { PlanRenderer } from "./renderer.js";
 export { ExportService } from "./export-service.js";
 export type { CodebaseProfile, ResumeFocus, ActivityEntry, ActivityLog, AmbientFacts } from "./schema.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,uBAAuB,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtL,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,uBAAuB,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC/M,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -3,6 +3,7 @@ export * from "./refs.js";
 export * from "./schema.js";
 export * from "./checklist.js";
 export * from "./recap.js";
+export * from "./display-status.js";
 export { PlanStore, PlanStoreError, setWriteBusyHook, setWriteNotifyHook, migrateToUuids, migrateToGlobalSequence, withFeatureLock } from "./plan-store.js";
 export { PlanRenderer } from "./renderer.js";
 export { ExportService } from "./export-service.js";

package/dist/naming.d.ts

@@ -3,6 +3,20 @@
 export declare const CROCKFORD_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
 export declare const SHORT_ID_LENGTH = 5;
 export declare const SHORT_ID_PATTERN: RegExp;
+/** Loose UUID v4 regex (case-insensitive). Used for input sanity checks. */
+export declare const UUID_PATTERN: RegExp;
+export declare function isUuid(value: unknown): value is string;
+/** Belt-and-suspenders validation: a resolved ref must be a real UUID and the
+ *  target must still exist in the store before we allocate numbers or write.
+ *  Used by adapter create tools (task_create, phase_create). */
+export declare function validateResolvedTarget<T extends {
+    id: string;
+}>(kind: "feature" | "phase", resolvedId: string, loader: () => Promise<T | undefined>): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+}>;
 /** Generate a globally-unique short id (5 chars, Crockford Base32, e.g. `UUXD1`-style
  *  but without 0/1/I/O). Retries until the id is not in `existing` (project-scoped
  *  collision guard). Throws only in the impossible saturation case (~50 retries). */

package/dist/naming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAKA;iFACiF;AACjF,eAAO,MAAM,kBAAkB,qCAAqC,CAAC;AAErE,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,gBAAgB,QAAkB,CAAC;AAEhD;;qFAEqF;AACrF,wBAAgB,aAAa,CAAC,QAAQ,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,MAAM,CAUvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED;;;;8BAI8B;AAC9B,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAK,EAAE,QAAQ,SAAa,GAAG,MAAM,CAGnF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;iBAEiB;AACjB,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlF;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,EAChD,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,GACzC,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtF;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C"}
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAKA;iFACiF;AACjF,eAAO,MAAM,kBAAkB,qCAAqC,CAAC;AAErE,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,gBAAgB,QAAkB,CAAC;AAEhD,4EAA4E;AAC5E,eAAO,MAAM,YAAY,QAAoE,CAAC;AAE9F,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEtD;AAED;;gEAEgE;AAChE,wBAAsB,sBAAsB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACnE,IAAI,EAAE,SAAS,GAAG,OAAO,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,GACnC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAStD;AAGD;;qFAEqF;AACrF,wBAAgB,aAAa,CAAC,QAAQ,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,MAAM,CAUvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED;;;;8BAI8B;AAC9B,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAK,EAAE,QAAQ,SAAa,GAAG,MAAM,CAGnF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;iBAEiB;AACjB,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlF;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,EAChD,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,GACzC,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtF;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C"}

package/dist/naming.js

@@ -6,6 +6,24 @@ const MULTI_DASH_PATTERN = /-+/g;
 export const CROCKFORD_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
 export const SHORT_ID_LENGTH = 5;
 export const SHORT_ID_PATTERN = /^[A-Z2-9]{5}$/;
+/** Loose UUID v4 regex (case-insensitive). Used for input sanity checks. */
+export const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export function isUuid(value) {
+    return typeof value === "string" && UUID_PATTERN.test(value);
+}
+/** Belt-and-suspenders validation: a resolved ref must be a real UUID and the
+ *  target must still exist in the store before we allocate numbers or write.
+ *  Used by adapter create tools (task_create, phase_create). */
+export async function validateResolvedTarget(kind, resolvedId, loader) {
+    if (!isUuid(resolvedId)) {
+        return { ok: false, error: `Resolved ${kind} id is not a valid UUID: ${resolvedId}` };
+    }
+    const target = await loader();
+    if (!target) {
+        return { ok: false, error: `Resolved ${kind} ${resolvedId} no longer exists. Refusing to create child.` };
+    }
+    return { ok: true };
+}
 /** Generate a globally-unique short id (5 chars, Crockford Base32, e.g. `UUXD1`-style
  *  but without 0/1/I/O). Retries until the id is not in `existing` (project-scoped
  *  collision guard). Throws only in the impossible saturation case (~50 retries). */

package/dist/plan-store.d.ts

@@ -1,7 +1,26 @@
-import { type Feature, type FeaturesDocument, type Manifest, type Phase, type PlanWorkspace, type Project, type RequirementsDocument, type ActivityEntry, type ActivityLog, type CodebaseProfile, type ResumeFocus } from "./schema.js";
+import { type Feature, type FeaturesDocument, type Manifest, type Phase, type PlanWorkspace, type Project, type RequirementsDocument, type Requirement, type ActivityEntry, type ActivityLog, type CodebaseProfile, type ResumeFocus } from "./schema.js";
+import { type ParentDisplay } from "./display-status.js";
+export interface PlanStoreErrorDetails {
+    path?: string;
+    operation?: string;
+    backupTried?: boolean;
+    backupFailed?: boolean;
+    jsonParseError?: {
+        message: string;
+        line?: number;
+        column?: number;
+    };
+    validationErrors?: {
+        path: string;
+        message: string;
+    }[];
+    rawPreview?: string;
+    [key: string]: unknown;
+}
 export declare class PlanStoreError extends Error {
     readonly cause?: unknown | undefined;
-    constructor(message: string, cause?: unknown | undefined);
+    readonly details?: PlanStoreErrorDetails | undefined;
+    constructor(message: string, cause?: unknown | undefined, details?: PlanStoreErrorDetails | undefined);
 }
 export declare function setWriteBusyHook(hook: ((busy: boolean) => void) | undefined): void;
 export declare function setWriteNotifyHook(hook: (() => void) | undefined): void;
@@ -21,6 +40,18 @@ export interface PhaseHandoffSummary {
      *  inline without a per-phase fetch. */
     content: string;
 }
+/** Summary of a phase file that exists on disk but no longer resolves to a
+ *  valid owning feature. Missing back-links alone do NOT make a phase orphan:
+ *  if `phase.featureId` still resolves to a known feature, repair can relink
+ *  it. */
+export interface OrphanPhaseSummary {
+    phaseId: string;
+    featureId?: string | undefined;
+    shortId?: string | undefined;
+    compositeRef: string;
+    title: string;
+    reason: string;
+}
 export declare function migrateToUuids(store: PlanStore): Promise<void>;
 /**
  * One-time idempotent migration to GLOBAL F/P/T numbering.
@@ -116,6 +147,12 @@ export declare class PlanStore {
     allocFeatureNumber(): Promise<number>;
     allocPhaseNumber(): Promise<number>;
     allocTaskNumber(): Promise<number>;
+    /** Allocate a globally-unique sequence number. `atomicUpdateJson` already
+     *  serializes concurrent calls via `withWriteLock` on the project file, so
+     *  the read-modify-write is race-free in-process. The collision guard
+     *  additionally skips any candidate that already exists in the data (safety
+     *  net for cross-process races or manual edits) and persists the corrected
+     *  counter. */
     private allocSeqNumber;
     loadPhase(phaseId: string): Promise<Phase>;
     /** Read raw feature files WITHOUT the derived `status` field. Used
@@ -143,7 +180,21 @@ export declare class PlanStore {
     /** Derive an up-to-date resume focus from the current workspace state. */
     refreshResume(notes?: string, lastSessionSummary?: string): Promise<ResumeFocus>;
     loadRequirements(): Promise<RequirementsDocument>;
+    linkedRequirementsForPhase(phaseId: string): Promise<Requirement[]>;
+    loadPhaseWithRequirements(phaseId: string): Promise<Phase & {
+        linkedRequirements: Requirement[];
+    }>;
+    loadAllPhasesWithRequirements(): Promise<Array<Phase & {
+        linkedRequirements: Requirement[];
+    }>>;
     loadAllPhases(): Promise<Phase[]>;
+    /** Derive the parent display snapshot for a phase from its tasks' canonical
+     *  statuses. Pure, non-persisting. */
+    loadPhaseDisplay(phaseId: string): Promise<ParentDisplay>;
+    /** Derive the parent display snapshot for a feature from its phases' DERIVED
+     *  canonical statuses (each phase status is derived from its tasks at read
+     *  time, then mapped via fromCanonicalStatus). Pure, non-persisting. */
+    loadFeatureDisplay(featureId: string): Promise<ParentDisplay>;
     loadAll(): Promise<PlanWorkspace>;
     /** Migrate legacy non-feature-scoped phase ids to feature-scoped ids and repair
      *  dangling feature.phaseIds references. Idempotent. */
@@ -200,6 +251,7 @@ export declare class PlanStore {
             duplicateShortIds: string[];
         };
     }>;
+    private repairPhaseFeatureRefs;
     /** Validate plan integrity: globally unique phase ids and resolvable feature.phaseIds. */
     validateIntegrity(): Promise<{
         duplicatePhaseIds: string[];
@@ -263,6 +315,11 @@ export declare class PlanStore {
     /** List all phases that have a non-empty handoff, newest first, with a
      *  human-readable composite ref (P00x or P00x(F00x)) and a first-line excerpt. */
     listHandoffs(): Promise<PhaseHandoffSummary[]>;
+    listOrphanPhases(): Promise<OrphanPhaseSummary[]>;
+    cleanupOrphanPhases(): Promise<{
+        found: OrphanPhaseSummary[];
+        removed: OrphanPhaseSummary[];
+    }>;
     deletePhase(phaseId: string): Promise<void>;
     /** Load the full workspace (manifest + phases + project + requirements + features) */
     loadWorkspace(): Promise<PlanWorkspace>;

package/dist/plan-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-store.d.ts","sourceRoot":"","sources":["../src/plan-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,gBAAgB,EAGrB,KAAK,QAAQ,EAEb,KAAK,KAAK,EAEV,KAAK,aAAa,EAElB,KAAK,OAAO,EAEZ,KAAK,oBAAoB,EAIzB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAOrB,qBAAa,cAAe,SAAQ,KAAK;aAGrB,KAAK,CAAC,EAAE,OAAO;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAeD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAElF;AAKD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAEvE;AAaD,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAStF;AAmDD,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB;4CACwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,wBAAsB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAsEpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAyE/I;AA4BD,qBAAa,SAAS;;IACpB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAO1B,OAAO,CAAC,eAAe,CAAS;gBAEpB,IAAI,EAAE,MAAM;IAIxB;;4EAEwE;IACxE,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAEpC;;;2BAGuB;YACT,UAAU;IAUxB,2EAA2E;IACrE,oBAAoB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/D;;oFAEgF;IAC1E,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;YAIrC,aAAa;IAK3B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,0BAA0B;IAyD5B,uBAAuB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAkB9D;;;;;;mDAM+C;IACzC,kBAAkB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAgCvF,OAAO,CAAC,YAAY;IAGpB,OAAO,CAAC,WAAW;IAGnB,OAAO,CAAC,gBAAgB;IAGxB,OAAO,CAAC,YAAY;IAGpB,OAAO,CAAC,WAAW;IAGnB,OAAO,CAAC,WAAW;IAGnB,OAAO,CAAC,gBAAgB;IAMxB;;gFAE4E;YAC9D,aAAa;IAa3B,OAAO,CAAC,SAAS;IAGjB,OAAO,CAAC,SAAS;IAGjB,OAAO,CAAC,YAAY;IAGpB,OAAO,CAAC,YAAY;IAGpB,OAAO,CAAC,UAAU;IAGlB,OAAO,CAAC,YAAY;IAKd,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkGxC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAW1B,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIjC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;;;;;OAOG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IACrC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IACnC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;YAC1B,cAAc;IAUtB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAMhD;;0BAEsB;YACR,eAAe;IAqCvB,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAOzC,mBAAmB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAQtD,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5D,UAAU,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQzC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBpD;;;;;OAKG;IACG,oBAAoB,CAAC,eAAe,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBjE,qCAAqC;IAC/B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQvC,kEAAkE;IAC5D,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAQnC,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;IAQvC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAaxF,0EAA0E;IACpE,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAqBhF,gBAAgB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAQjD,aAAa,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IA0BjC,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAYvC;4DACwD;IAClD,eAAe,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAmEzF;;;;;OAKG;IACG,oBAAoB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA0B1D;mFAC+E;IACzE,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAY9C;;;qEAGiE;IAC3D,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB1F;;sFAEkF;IAC5E,yBAAyB,IAAI,OAAO,CAAC;QACzC,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;KAC7B,CAAC;IAuFF,gFAAgF;IAC1E,MAAM,IAAI,OAAO,CAAC;QACtB,QAAQ,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAClE,QAAQ,EAAE;YAAE,gBAAgB,EAAE,MAAM,CAAC;YAAC,kBAAkB,EAAE,MAAM,CAAC;YAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QAChG,WAAW,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAChE,SAAS,EAAE;YAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC;YAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;YAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KACrG,CAAC;IAcF,0FAA0F;IACpF,iBAAiB,IAAI,OAAO,CAAC;QAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA4B5H,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,mBAAmB;IAoBrB,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOvC;;;wFAGoF;IAC9E,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoE7D,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAMjE,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY7F,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAM7G,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7D,kGAAkG;YACpF,eAAe;IAsB7B,oFAAoF;IAC9E,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C;;6DAEyD;IACnD,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAgBpF,8EAA8E;IACxE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvD;8EAC0E;IACpE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnE;;wCAEoC;IACpC,OAAO,CAAC,iBAAiB;IAIzB;;kFAE8E;IACxE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;;;;;yFAMqF;IAC/E,uBAAuB,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAyBlF;;;;;wFAKoF;IAC9E,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1E;sFACkF;IAC5E,YAAY,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAsB9C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD,sFAAsF;IAChF,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;IAW7C,iEAAiE;IAC3D,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BzC,qDAAqD;YACvC,aAAa;CAS5B"}
+{"version":3,"file":"plan-store.d.ts","sourceRoot":"","sources":["../src/plan-store.ts"],"names":[],"mappings":"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"}

package/dist/plan-store.js

@@ -1,15 +1,40 @@
-import { access, copyFile, mkdir, readdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { access, copyFile, mkdir, readdir, readFile, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
 import { join } from "node:path";
+import { ZodError } from "zod";
 import { CodebaseProfileSchema, FeatureSchema, FeaturesDocumentSchema, ManifestSchema, PhaseSchema, ProjectSchema, RequirementsDocumentSchema, ResumeFocusSchema, ActivityLogSchema, } from "./schema.js";
 import { createFeatureId, createPhaseId, createRequirementId, createShortId, createStatusLogEntryId, createTaskId, formatPhaseRef, isLegacyPhaseId } from "./naming.js";
+import { deriveParentDisplay, fromCanonicalStatus } from "./display-status.js";
 function nowISO() {
     return new Date().toISOString();
 }
+function resolveStoredFeatureId(features, ref) {
+    const raw = ref?.trim();
+    if (!raw)
+        return undefined;
+    const normalized = raw.toLowerCase();
+    const byId = features.find((feature) => feature.id.toLowerCase() === normalized);
+    if (byId)
+        return byId.id;
+    const byNumber = normalized.match(/^f(\d+)$/)
+        ? features.find((feature) => feature.number === parseInt(normalized.slice(1), 10))
+        : undefined;
+    if (byNumber)
+        return byNumber.id;
+    const byShortId = features.find((feature) => feature.shortId?.toLowerCase() === normalized);
+    if (byShortId)
+        return byShortId.id;
+    const byExactName = features.find((feature) => feature.name.toLowerCase() === normalized);
+    if (byExactName)
+        return byExactName.id;
+    return undefined;
+}
 export class PlanStoreError extends Error {
     cause;
-    constructor(message, cause) {
+    details;
+    constructor(message, cause, details) {
         super(message);
         this.cause = cause;
+        this.details = details;
         this.name = "PlanStoreError";
     }
 }
@@ -32,14 +57,52 @@ let writeNotifyHook;
 export function setWriteNotifyHook(hook) {
     writeNotifyHook = hook;
 }
+const CROSS_PROCESS_LOCK_STALE_MS = 30_000;
+const CROSS_PROCESS_LOCK_RETRY_MS = 10;
+async function acquireCrossProcessLock(path) {
+    const lockPath = `${path}.lock`;
+    for (;;) {
+        try {
+            await mkdir(lockPath);
+            return async () => {
+                await rm(lockPath, { recursive: true, force: true }).catch(() => { });
+            };
+        }
+        catch (error) {
+            const err = error;
+            if (err?.code !== "EEXIST")
+                throw err;
+            try {
+                const info = await stat(lockPath);
+                if (Date.now() - info.mtimeMs > CROSS_PROCESS_LOCK_STALE_MS) {
+                    await rm(lockPath, { recursive: true, force: true });
+                    continue;
+                }
+            }
+            catch {
+                continue;
+            }
+            await new Promise((resolve) => setTimeout(resolve, CROSS_PROCESS_LOCK_RETRY_MS));
+        }
+    }
+}
 function withWriteLock(path, fn) {
     const prev = writeLocks.get(path) ?? Promise.resolve();
     let release;
     const next = new Promise((resolve) => { release = resolve; });
-    writeLocks.set(path, prev.then(() => next));
-    return prev.then(fn).finally(() => {
+    const tail = prev.then(() => next);
+    writeLocks.set(path, tail);
+    return prev.then(async () => {
+        const releaseCrossProcess = await acquireCrossProcessLock(path);
+        try {
+            return await fn();
+        }
+        finally {
+            await releaseCrossProcess();
+        }
+    }).finally(() => {
         release();
-        if (writeLocks.get(path) === prev.then(() => next))
+        if (writeLocks.get(path) === tail)
             writeLocks.delete(path);
     });
 }
@@ -47,10 +110,11 @@ export function withFeatureLock(featureId, fn) {
     const prev = featureLocks.get(featureId) ?? Promise.resolve();
     let release;
     const next = new Promise((resolve) => { release = resolve; });
-    featureLocks.set(featureId, prev.then(() => next));
+    const tail = prev.then(() => next);
+    featureLocks.set(featureId, tail);
     return prev.then(fn).finally(() => {
         release();
-        if (featureLocks.get(featureId) === prev.then(() => next))
+        if (featureLocks.get(featureId) === tail)
             featureLocks.delete(featureId);
     });
 }
@@ -271,20 +335,55 @@ export async function migrateToGlobalSequence(store) {
     });
 }
 async function readJson(path, schema) {
+    let backupTried = false;
+    let backupFailed = false;
+    let rawPreview;
     try {
         const raw = await readFile(path, "utf-8");
+        rawPreview = raw.slice(0, 240);
         return schema.parse(JSON.parse(raw));
     }
     catch (cause) {
         // Try the .bak backup before giving up (recover from external-write corruption).
+        backupTried = true;
         try {
             const bak = await readFile(`${path}.bak`, "utf-8");
+            rawPreview = bak.slice(0, 240);
             return schema.parse(JSON.parse(bak));
         }
         catch {
+            backupFailed = true;
             // fall through to original error
         }
-        throw new PlanStoreError(`read failed: ${path}`, cause);
+        const details = {
+            path,
+            operation: "readJson",
+            backupTried,
+            backupFailed,
+        };
+        if (rawPreview != null)
+            details.rawPreview = rawPreview;
+        if (cause instanceof SyntaxError) {
+            const match = cause.message.match(/position\s+(\d+)/i);
+            const position = match && match[1] ? Number.parseInt(match[1], 10) : undefined;
+            if (rawPreview != null && position != null && position >= 0) {
+                const upTo = rawPreview.slice(0, position);
+                const line = upTo.split("\n").length;
+                const lastNL = upTo.lastIndexOf("\n");
+                const column = position - (lastNL >= 0 ? lastNL : 0);
+                details.jsonParseError = { message: cause.message, line, column };
+            }
+            else {
+                details.jsonParseError = { message: cause.message };
+            }
+        }
+        else if (cause instanceof ZodError) {
+            details.validationErrors = cause.issues.slice(0, 8).map((issue) => ({
+                path: issue.path.map((p) => (typeof p === "number" ? `[${p}]` : String(p))).join("."),
+                message: issue.message,
+            }));
+        }
+        throw new PlanStoreError(`read failed: ${path}`, cause, details);
     }
 }
 export class PlanStore {
@@ -361,7 +460,12 @@ export class PlanStore {
         const phasesByFeature = new Map();
         const orphanPhases = [];
         for (const phase of phases) {
-            if (phase.featureId) {
+            const resolvedFeatureId = resolveStoredFeatureId(featuresDoc.features, phase.featureId);
+            if (resolvedFeatureId && resolvedFeatureId !== phase.featureId) {
+                phase.featureId = resolvedFeatureId;
+                changed = true;
+            }
+            if (phase.featureId && featuresDoc.features.some((feature) => feature.id === phase.featureId)) {
                 const bucket = phasesByFeature.get(phase.featureId) ?? [];
                 bucket.push(phase);
                 phasesByFeature.set(phase.featureId, bucket);
@@ -639,15 +743,46 @@ export class PlanStore {
      * The counter never reuses a number — deletions leave gaps (by design:
      * stable references survive deletion).
      */
-    async allocFeatureNumber() { return this.allocSeqNumber("nextFeatureNumber"); }
-    async allocPhaseNumber() { return this.allocSeqNumber("nextPhaseNumber"); }
-    async allocTaskNumber() { return this.allocSeqNumber("nextTaskNumber"); }
-    async allocSeqNumber(key) {
-        const project = await this.loadProject();
-        const n = project[key];
-        project[key] = n + 1;
-        await this.saveProject(project);
-        return n;
+    async allocFeatureNumber() { return this.allocSeqNumber("nextFeatureNumber", "feature"); }
+    async allocPhaseNumber() { return this.allocSeqNumber("nextPhaseNumber", "phase"); }
+    async allocTaskNumber() { return this.allocSeqNumber("nextTaskNumber", "task"); }
+    /** Allocate a globally-unique sequence number. `atomicUpdateJson` already
+     *  serializes concurrent calls via `withWriteLock` on the project file, so
+     *  the read-modify-write is race-free in-process. The collision guard
+     *  additionally skips any candidate that already exists in the data (safety
+     *  net for cross-process races or manual edits) and persists the corrected
+     *  counter. */
+    async allocSeqNumber(key, kind) {
+        // Load already-used numbers for this kind (best-effort read; the
+        // atomicUpdateJson below is the authoritative write).
+        const used = new Set();
+        if (kind === "task") {
+            const phases = await this.loadAllPhases();
+            for (const p of phases)
+                for (const t of p.tasks)
+                    used.add(t.number);
+        }
+        else if (kind === "phase") {
+            const phases = await this.loadAllPhases();
+            for (const p of phases)
+                used.add(p.number);
+        }
+        else {
+            const feats = await this.loadRawFeatures();
+            for (const f of feats)
+                used.add(f.number);
+        }
+        let allocated = 0;
+        await this.updateProject((project) => {
+            let candidate = project[key];
+            // Collision guard: skip any candidate that already exists.
+            while (used.has(candidate))
+                candidate++;
+            allocated = candidate;
+            project[key] = candidate + 1;
+            return project;
+        });
+        return allocated;
     }
     async loadPhase(phaseId) {
         const raw = await readJson(this.phasePath(phaseId), PhaseSchema);
@@ -700,7 +835,7 @@ export class PlanStore {
         const raws = await this.loadRawFeatures();
         const phases = await this.loadAllPhases();
         const features = raws.map((f) => ({ ...f, status: this.deriveFeatureStatus(f.id, phases) }));
-        return this.normalizeFeaturesDocument({ features }).doc;
+        return this.normalizeStructureSnapshot({ features }, phases).features;
     }
     async loadCodebaseProfile() {
         try {
@@ -831,6 +966,27 @@ export class PlanStore {
             return { requirements: [] };
         }
     }
+    async linkedRequirementsForPhase(phaseId) {
+        const requirements = await this.loadRequirements();
+        return requirements.requirements.filter((requirement) => requirement.linkedPhaseIds.includes(phaseId));
+    }
+    async loadPhaseWithRequirements(phaseId) {
+        const [phase, linkedRequirements] = await Promise.all([
+            this.loadPhase(phaseId),
+            this.linkedRequirementsForPhase(phaseId),
+        ]);
+        return { ...phase, linkedRequirements };
+    }
+    async loadAllPhasesWithRequirements() {
+        const [phases, requirements] = await Promise.all([
+            this.loadAllPhases(),
+            this.loadRequirements(),
+        ]);
+        return phases.map((phase) => ({
+            ...phase,
+            linkedRequirements: requirements.requirements.filter((requirement) => requirement.linkedPhaseIds.includes(phase.id)),
+        }));
+    }
     async loadAllPhases() {
         const { readdir } = await import("node:fs/promises");
         let files;
@@ -861,6 +1017,22 @@ export class PlanStore {
             return left.createdAt.localeCompare(right.createdAt);
         });
     }
+    /** Derive the parent display snapshot for a phase from its tasks' canonical
+     *  statuses. Pure, non-persisting. */
+    async loadPhaseDisplay(phaseId) {
+        const phase = await this.loadPhase(phaseId);
+        const childStatuses = phase.tasks.map((t) => fromCanonicalStatus(t.status));
+        return deriveParentDisplay(childStatuses);
+    }
+    /** Derive the parent display snapshot for a feature from its phases' DERIVED
+     *  canonical statuses (each phase status is derived from its tasks at read
+     *  time, then mapped via fromCanonicalStatus). Pure, non-persisting. */
+    async loadFeatureDisplay(featureId) {
+        const phases = await this.loadAllPhases();
+        const featurePhases = phases.filter((p) => p.featureId === featureId);
+        const childStatuses = featurePhases.map((p) => fromCanonicalStatus(p.status));
+        return deriveParentDisplay(childStatuses);
+    }
     async loadAll() {
         const [manifest, project, requirements, phases] = await Promise.all([
             this.loadManifest(),
@@ -870,7 +1042,8 @@ export class PlanStore {
         ]);
         const rawFeatures = await this.loadRawFeatures();
         const features = rawFeatures.map((f) => ({ ...f, status: this.deriveFeatureStatus(f.id, phases) }));
-        return { manifest, project, requirements, phases, features: { features } };
+        const normalized = this.normalizeStructureSnapshot({ features }, phases);
+        return { manifest, project, requirements, phases: normalized.phases, features: normalized.features };
     }
     /** Migrate legacy non-feature-scoped phase ids to feature-scoped ids and repair
      *  dangling feature.phaseIds references. Idempotent. */
@@ -1129,6 +1302,7 @@ export class PlanStore {
     async repair() {
         return this.runAsBatch(async () => {
             const migrated = await this.migratePhaseIds();
+            await this.repairPhaseFeatureRefs();
             const backfill = await this.ensureShortIdsAndPriority();
             // Rebuild phase containment from each task's own phaseId. Heals plans
             // corrupted by the migrateToGlobalSequence index-mismatch bug (core
@@ -1139,6 +1313,22 @@ export class PlanStore {
             return { migrated, backfill, containment, integrity };
         });
     }
+    async repairPhaseFeatureRefs() {
+        const features = await this.loadRawFeatures();
+        const phases = await this.loadAllPhases();
+        let changed = 0;
+        for (const phase of phases) {
+            const resolvedFeatureId = resolveStoredFeatureId(features, phase.featureId);
+            if (resolvedFeatureId && resolvedFeatureId !== phase.featureId) {
+                await this.savePhase({ ...phase, featureId: resolvedFeatureId });
+                changed += 1;
+            }
+        }
+        if (changed > 0) {
+            await this.updateFeatures((doc) => doc);
+        }
+        return changed;
+    }
     /** Validate plan integrity: globally unique phase ids and resolvable feature.phaseIds. */
     async validateIntegrity() {
         const phases = await this.loadAllPhases();
@@ -1184,18 +1374,28 @@ export class PlanStore {
             return "rejected";
         if (meaningful.every((s) => s === "done"))
             return "done";
-        // Lifecycle truth: any progress (active work OR partial completion) ⇒
-        // in-progress, until fully done. This is what prevents a single
-        // blocked/waiting/deferred task from poisoning the parent when there is
-        // substantial done or in-progress work (the long-standing rollup bug).
-        if (meaningful.some((s) => s === "in-progress") || meaningful.some((s) => s === "done"))
+        const hasDone = meaningful.some((s) => s === "done");
+        const hasActive = meaningful.some((s) => s === "in-progress");
+        const hasPlanned = meaningful.some((s) => s === "planned");
+        const hasBlocked = meaningful.some((s) => s === "blocked");
+        const hasWaiting = meaningful.some((s) => s === "waiting");
+        const hasDeferred = meaningful.some((s) => s === "deferred");
+        if (hasActive)
+            return "in-progress";
+        // If completed work exists and the ONLY remaining meaningful work is deferred,
+        // surface deferred instead of implying active execution.
+        if (hasDone && !hasPlanned && !hasBlocked && !hasWaiting && hasDeferred)
+            return "deferred";
+        // Partial completion with remaining planned/blocked/waiting work still means
+        // the phase has genuinely started and is not terminal yet.
+        if (hasDone)
             return "in-progress";
         // No progress at all ⇒ surface the stall / not-started state (blocked > waiting > deferred > planned).
-        if (meaningful.some((s) => s === "blocked"))
+        if (hasBlocked)
             return "blocked";
-        if (meaningful.some((s) => s === "waiting"))
+        if (hasWaiting)
             return "waiting";
-        if (meaningful.some((s) => s === "deferred"))
+        if (hasDeferred)
             return "deferred";
         return "planned";
     }
@@ -1210,17 +1410,25 @@ export class PlanStore {
             return "rejected";
         if (meaningful.every((s) => s === "done"))
             return "done";
-        // Any progress (an active phase, or a partially-complete done phase) ⇒
-        // in-progress. Prevents a single stalled phase from poisoning the feature
-        // when other phases have done/in-progress work.
-        if (meaningful.some((s) => s === "discovery" || s === "in-progress") || meaningful.some((s) => s === "done"))
+        const hasDone = meaningful.some((s) => s === "done");
+        const hasActive = meaningful.some((s) => s === "discovery" || s === "in-progress");
+        const hasPlanned = meaningful.some((s) => s === "planned");
+        const hasBlocked = meaningful.some((s) => s === "blocked");
+        const hasWaiting = meaningful.some((s) => s === "waiting");
+        const hasDeferred = meaningful.some((s) => s === "deferred");
+        if (hasActive)
+            return "in-progress";
+        // Same rule as phases: done + deferred-only remainder is deferred, not active.
+        if (hasDone && !hasPlanned && !hasBlocked && !hasWaiting && hasDeferred)
+            return "deferred";
+        if (hasDone)
             return "in-progress";
         // No progress at all ⇒ surface the stall / not-started state.
-        if (meaningful.some((s) => s === "blocked"))
+        if (hasBlocked)
             return "blocked";
-        if (meaningful.some((s) => s === "waiting"))
+        if (hasWaiting)
             return "waiting";
-        if (meaningful.some((s) => s === "deferred"))
+        if (hasDeferred)
             return "deferred";
         return "planned";
     }
@@ -1376,7 +1584,17 @@ export class PlanStore {
         await this.touchManifest();
     }
     async savePhase(phase) {
-        const parsed = PhaseSchema.parse(this.normalizePhaseDocument(phase).phase);
+        const features = await this.loadRawFeatures();
+        const resolvedFeatureId = resolveStoredFeatureId(features, phase.featureId);
+        // Referential integrity: if a featureId is present but cannot be resolved
+        // to a known feature, REJECT — never persist an orphan phase.
+        if (phase.featureId && phase.featureId.trim() && !resolvedFeatureId) {
+            throw new PlanStoreError(`Cannot save phase "${phase.title}": featureId "${phase.featureId}" does not match any existing feature. Use a valid feature UUID, F00x ref, or shortId.`);
+        }
+        const normalizedInput = resolvedFeatureId && resolvedFeatureId !== phase.featureId
+            ? { ...phase, featureId: resolvedFeatureId }
+            : phase;
+        const parsed = PhaseSchema.parse(this.normalizePhaseDocument(normalizedInput).phase);
         await mkdir(this.phasesDir(), { recursive: true });
         await atomicWriteJson(this.phasePath(parsed.id), parsed);
         await this.touchManifest();
@@ -1386,6 +1604,7 @@ export class PlanStore {
      *  task_create / phase_update calls on the SAME phaseId so batch operations
      *  don't lose tasks (last-write-wins race condition). */
     async updatePhase(phaseId, updater) {
+        const features = await this.loadRawFeatures();
         // Augment the raw (on-disk) phase with its DERIVED status before handing it
         // to the updater, so updaters that read 'phase.status' see the truth. The
         // returned object's 'status' is stripped by PhaseSchema.parse (status is
@@ -1393,7 +1612,15 @@ export class PlanStore {
         const raw = await atomicUpdateJson(this.phasePath(phaseId), PhaseSchema, (rawPhase) => {
             const current = { ...rawPhase, status: this.derivePhaseStatus(rawPhase.tasks) };
             const next = updater(current);
-            return this.normalizePhaseDocument(next).phase;
+            const resolvedFeatureId = resolveStoredFeatureId(features, next.featureId);
+            // Referential integrity: reject orphan featureId.
+            if (next.featureId && next.featureId.trim() && !resolvedFeatureId) {
+                throw new PlanStoreError(`Cannot update phase: featureId "${next.featureId}" does not match any existing feature.`);
+            }
+            const normalizedInput = resolvedFeatureId && resolvedFeatureId !== next.featureId
+                ? { ...next, featureId: resolvedFeatureId }
+                : next;
+            return this.normalizePhaseDocument(normalizedInput).phase;
         });
         await this.maybeAutoSync();
         return { ...raw, status: this.derivePhaseStatus(raw.tasks) };
@@ -1505,6 +1732,54 @@ export class PlanStore {
         out.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
         return out;
     }
+    async listOrphanPhases() {
+        const phases = await this.loadAllPhases();
+        const featuresDoc = await this.loadFeatures();
+        const out = [];
+        for (const phase of phases) {
+            const resolvedFeatureId = resolveStoredFeatureId(featuresDoc.features, phase.featureId);
+            if (resolvedFeatureId)
+                continue;
+            const reason = phase.featureId?.trim()
+                ? `feature not found: ${phase.featureId}`
+                : "missing featureId";
+            out.push({
+                phaseId: phase.id,
+                featureId: phase.featureId,
+                shortId: phase.shortId,
+                compositeRef: formatPhaseRef(phase.number),
+                title: phase.title,
+                reason,
+            });
+        }
+        out.sort((a, b) => a.compositeRef.localeCompare(b.compositeRef));
+        return out;
+    }
+    async cleanupOrphanPhases() {
+        return this.runAsBatch(async () => {
+            const found = await this.listOrphanPhases();
+            if (found.length === 0)
+                return { found, removed: [] };
+            const orphanIds = new Set(found.map((phase) => phase.phaseId));
+            for (const orphan of found) {
+                try {
+                    await unlink(this.phasePath(orphan.phaseId));
+                }
+                catch {
+                    // already gone
+                }
+            }
+            await this.updateFeatures((doc) => {
+                for (const feature of doc.features) {
+                    feature.phaseIds = feature.phaseIds.filter((id) => !orphanIds.has(id));
+                }
+                return doc;
+            });
+            await this.touchManifest();
+            await this.writeGenerated();
+            return { found, removed: found };
+        });
+    }
     async deletePhase(phaseId) {
         try {
             await unlink(this.phasePath(phaseId));

package/dist/recap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recap.d.ts","sourceRoot":"","sources":["../src/recap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,KAAK,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAKD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,GAAE,YAAiB,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8HhH"}
+{"version":3,"file":"recap.d.ts","sourceRoot":"","sources":["../src/recap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,KAAK,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAKD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,GAAE,YAAiB,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgJhH"}

package/dist/recap.js

@@ -62,6 +62,10 @@ export async function buildRecap(st, web = {}, opts = {}) {
         const tr = tref(focusTask.task.number);
         lines.push(`${italian ? "Focus corrente" : "Current focus"}: ${fr} — ${focusFeature?.name ?? "?"} / ${pr} — ${focusPhase.title} / ${tr} — ${focusTask.task.title} (in-progress)`);
     }
+    else if (handoffs.length > 0) {
+        const top = handoffs[0];
+        lines.push(`${italian ? "Focus corrente" : "Current focus"}: ${italian ? "nessun task attivo" : "no active task"} · ${italian ? "handoff pendente più recente" : "most recent pending handoff"}: ${top.compositeRef} — "${top.firstLine}"`);
+    }
     else if (planComplete) {
         lines.push(italian
             ? "Focus corrente: piano completo — tutte le feature/fasi/task sono concluse."
@@ -92,11 +96,19 @@ export async function buildRecap(st, web = {}, opts = {}) {
         lines.push(staleNote);
     }
     if (handoffs.length > 0) {
+        const top = handoffs[0];
         lines.push("", italian ? `## Handoff di fase pendenti (${handoffs.length})` : `## Pending phase handoffs (${handoffs.length})`);
         handoffs.forEach((h, i) => lines.push(`[${i + 1}] ${h.compositeRef} — ${h.updatedAt} — "${h.firstLine}"`));
-        lines.push("", italian
-            ? `→ Leggi quello pertinente con ${handoffShowCmd} <ref> (valida contro lo stato attuale). L'handoff è MANTENUTO finché un task della fase non parte (auto-archiviato) o la fase non si conclude — non serve cancellarlo a mano.`
-            : `→ Read the relevant one with ${handoffShowCmd} <ref> (validate against current state). It is KEPT until a task in that phase starts (then auto-archived) or the phase completes — no need to clear it manually.`);
+        if (handoffs.length === 1) {
+            lines.push("", italian
+                ? `→ Vuoi riprendere da ${top.compositeRef}? Leggi l'handoff con ${handoffShowCmd} ${top.compositeRef} e avvia il primo task pertinente. L'handoff è MANTENUTO finché un task della fase non parte (auto-archiviato) o la fase non si conclude — non serve cancellarlo a mano.`
+                : `→ Do you want to resume from ${top.compositeRef}? Read the handoff with ${handoffShowCmd} ${top.compositeRef} and start the first relevant task. It is KEPT until a task in that phase starts (then auto-archived) or the phase completes — no need to clear it manually.`);
+        }
+        else {
+            lines.push("", italian
+                ? `→ Scegli da quale fase ripartire. Il più recente è [1] ${top.compositeRef} — leggilo con ${handoffShowCmd} ${top.compositeRef} e avvia il primo task pertinente. Ogni handoff è MANTENUTO finché un task della fase non parte (auto-archiviato) o la fase non si conclude — non serve cancellarlo a mano.`
+                : `→ Choose which phase to resume from. The most recent is [1] ${top.compositeRef} — read it with ${handoffShowCmd} ${top.compositeRef} and start the first relevant task. Each handoff is KEPT until a task in that phase starts (then auto-archived) or the phase completes — no need to clear it manually.`);
+        }
     }
     else if (planComplete) {
         lines.push("", italian
@@ -114,6 +126,6 @@ export async function buildRecap(st, web = {}, opts = {}) {
     else {
         lines.push("", italian ? "## Web UI" : "## Web UI", `🌐 Web UI: ${italian ? "non attiva — avvia con /planner load" : "not running — start with /planner load"}`);
     }
-    lines.push("", italian ? "Vuoi che riprendiamo da qui?" : "Do you want to resume from here?");
+    lines.push("", italian ? "Pronto a riprendere?" : "Ready to resume?");
     return lines.join("\n");
 }

package/dist/schema.d.ts

@@ -486,6 +486,8 @@ export declare const PhaseStatusLogEntrySchema: z.ZodObject<{
 }>;
 export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
+    /** MUST be a phase UUID (not a ref like "P003"). Validated at the schema
+     *  layer so no adapter can persist an unresolved ref string. */
     phaseId: z.ZodString;
     /** Global project-wide task sequence (assigned once at creation from project.nextTaskNumber; stable, gaps on delete). Bare T00x is unambiguous. */
     number: z.ZodDefault<z.ZodNumber>;
@@ -793,6 +795,9 @@ export declare const HandoffHistoryEntrySchema: z.ZodObject<{
 }>;
 export declare const PhaseSchema: z.ZodObject<{
     id: z.ZodString;
+    /** MUST be a feature UUID (not a ref like "F005"). Validated at the schema
+     *  layer so no adapter can persist an unresolved ref string. Optional only
+     *  for legacy pre-feature phases. */
     featureId: z.ZodOptional<z.ZodString>;
     /** Global project-wide phase sequence (assigned once at creation from project.nextPhaseNumber; stable, gaps on delete). Bare P00x is unambiguous. */
     number: z.ZodNumber;
@@ -839,6 +844,8 @@ export declare const PhaseSchema: z.ZodObject<{
     taskIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     tasks: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodObject<{
         id: z.ZodString;
+        /** MUST be a phase UUID (not a ref like "P003"). Validated at the schema
+         *  layer so no adapter can persist an unresolved ref string. */
         phaseId: z.ZodString;
         /** Global project-wide task sequence (assigned once at creation from project.nextTaskNumber; stable, gaps on delete). Bare T00x is unambiguous. */
         number: z.ZodDefault<z.ZodNumber>;
@@ -2342,6 +2349,9 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
     }>;
     phases: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
+        /** MUST be a feature UUID (not a ref like "F005"). Validated at the schema
+         *  layer so no adapter can persist an unresolved ref string. Optional only
+         *  for legacy pre-feature phases. */
         featureId: z.ZodOptional<z.ZodString>;
         /** Global project-wide phase sequence (assigned once at creation from project.nextPhaseNumber; stable, gaps on delete). Bare P00x is unambiguous. */
         number: z.ZodNumber;
@@ -2388,6 +2398,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         taskIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         tasks: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodObject<{
             id: z.ZodString;
+            /** MUST be a phase UUID (not a ref like "P003"). Validated at the schema
+             *  layer so no adapter can persist an unresolved ref string. */
             phaseId: z.ZodString;
             /** Global project-wide task sequence (assigned once at creation from project.nextTaskNumber; stable, gaps on delete). Bare T00x is unambiguous. */
             number: z.ZodDefault<z.ZodNumber>;

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe,aAAwB,CAAC;AACrD,eAAO,MAAM,UAAU,aAAiD,CAAC;AAEzE,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBhC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;IAK5B;;mFAE+E;;;;;;;;;;;;;;;;;;;;;;;;;;EAM/E,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAM9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAexB,gGAAgG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIhG,CAAC;AAEH,eAAO,MAAM,mBAAmB,yGAAuG,CAAC;AACxI,eAAO,MAAM,gBAAgB,yGAAuG,CAAC;AACrI,eAAO,MAAM,iBAAiB,+HAA6H,CAAC;AAC5J,eAAO,MAAM,uBAAuB,yGAAuG,CAAC;AAC5I,eAAO,MAAM,mBAAmB,yGAAuG,CAAC;AAExI,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;EAOxB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;IAE9B;;yDAEqD;;;;;;;;;;;;;;EAIrD,CAAC;AAIH,wEAAwE;AACxE,eAAO,MAAM,8BAA8B,aAEzC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK7E;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAC;AAEH;2EAC2E;AAC3E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;EAOpC,CAAC;AAEH,eAAO,MAAM,UAAU;;;IAGrB,mJAAmJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAnDnJ;;6DAEqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2EpD,CAAC;AAEJ,eAAO,MAAM,yBAAyB;IACpC,+EAA+E;;;IAG/E,yGAAyG;;;;;;;;;;EAEzG,CAAC;AACH,eAAO,MAAM,WAAW;;;IAGtB,qJAAqJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAtCrJ,mJAAmJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAnDnJ;;iEAEqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqHrD;;;kFAG8E;;IAE9E;;;0DAGsD;;QA/CtD,+EAA+E;;;QAG/E,yGAAyG;;;;;;;;;;;IA8CzG,ySAAyS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEzS,CAAC;AAEH,eAAO,MAAM,aAAa;;IAExB,+HAA+H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkB/H,6PAA6P;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI7P,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;QAxBjC,+HAA+H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAkB/H,6PAA6P;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ7P,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;EAO1B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAlN9B,gGAAgG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA8JhG,+HAA+H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkB/H,6PAA6P;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAhE7P,qJAAqJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAtCrJ,mJAAmJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAnDnJ;;qEAEqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqHrD;;;sFAG8E;;QAE9E;;;8DAGsD;;YA/CtD,+EAA+E;;;YAG/E,yGAAyG;;;;;;;;;;;QA8CzG,ySAAyS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgEzS,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAChF,MAAM,MAAM,gBAAgB,GAAG;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAC1E,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/schema.js

@@ -158,7 +158,9 @@ export const PhaseStatusLogEntrySchema = z.object({
 });
 export const TaskSchema = z.object({
     id: z.string(),
-    phaseId: z.string(),
+    /** MUST be a phase UUID (not a ref like "P003"). Validated at the schema
+     *  layer so no adapter can persist an unresolved ref string. */
+    phaseId: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, "phaseId must be a UUID, not a ref string like P003"),
     /** Global project-wide task sequence (assigned once at creation from project.nextTaskNumber; stable, gaps on delete). Bare T00x is unambiguous. */
     number: z.number().int().nonnegative().default(0),
     shortId: z.string().regex(/^(|[A-Z2-9]{5})$/).default(""),
@@ -195,7 +197,10 @@ export const HandoffHistoryEntrySchema = z.object({
 });
 export const PhaseSchema = z.object({
     id: z.string(),
-    featureId: z.string().optional(),
+    /** MUST be a feature UUID (not a ref like "F005"). Validated at the schema
+     *  layer so no adapter can persist an unresolved ref string. Optional only
+     *  for legacy pre-feature phases. */
+    featureId: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, "featureId must be a UUID, not a ref string like F005").optional(),
     /** Global project-wide phase sequence (assigned once at creation from project.nextPhaseNumber; stable, gaps on delete). Bare P00x is unambiguous. */
     number: z.number().int().positive(),
     shortId: z.string().regex(/^(|[A-Z2-9]{5})$/).default(""),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-plan/core",
-  "version": "0.2.19-next.16",
+  "version": "0.2.19-next.18",
   "private": false,
   "description": "Harness-agnostic core for Agent Plan: schemas, persistence, ordering, status rollups, and markdown rendering.",
   "license": "MIT",
@@ -40,6 +40,9 @@
   "dependencies": {
     "zod": "^3.24.0"
   },
+  "devDependencies": {
+    "zod-to-json-schema": "^3.25.2"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "check": "tsc -p tsconfig.json --noEmit",