@agent-plan/core 0.2.19-next.0 → 0.2.19-next.2

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./naming.js";
 export * from "./refs.js";
 export * from "./schema.js";
+export * from "./recap.js";
 export { PlanStore, PlanStoreError, setWriteBusyHook, setWriteNotifyHook, migrateToUuids, withFeatureLock, type PhaseHandoffSummary } from "./plan-store.js";
 export { PlanRenderer } from "./renderer.js";
 export { ExportService } from "./export-service.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,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC7J,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,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC7J,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

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

package/dist/naming.d.ts

@@ -20,6 +20,15 @@ export declare function formatThreeDigitNumber(value: number): string;
  *  feature number is known. Harness-agnostic (used by core handoff listing +
  *  adapters). */
 export declare function formatPhaseRef(phaseNumber: number, featureNumber?: number): string;
+/** Human-readable feature ref: `F00x`. Harness-agnostic. */
+export declare function formatFeatureRef(featureNumber: number): string;
+/** Find the parent feature's number for a phase (for P00x(F00x) composite refs). */
+export declare function featureNumberOfPhase(phase: {
+    featureId?: string | null | undefined;
+}, features: {
+    id: string;
+    number: number;
+}[]): number | undefined;
 export declare function createPhaseId(): string;
 /** True for legacy phase ids that are NOT feature-scoped (e.g. `phase-01-...`). */
 export declare function isLegacyPhaseId(phaseId: string): boolean;

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,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"}
+{"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"}

package/dist/naming.js

@@ -51,6 +51,14 @@ export function formatPhaseRef(phaseNumber, featureNumber) {
     const p = `P${formatThreeDigitNumber(phaseNumber)}`;
     return featureNumber != null ? `${p}(F${formatThreeDigitNumber(featureNumber)})` : p;
 }
+/** Human-readable feature ref: `F00x`. Harness-agnostic. */
+export function formatFeatureRef(featureNumber) {
+    return `F${formatThreeDigitNumber(featureNumber)}`;
+}
+/** Find the parent feature's number for a phase (for P00x(F00x) composite refs). */
+export function featureNumberOfPhase(phase, features) {
+    return phase.featureId ? features.find((f) => f.id === phase.featureId)?.number : undefined;
+}
 export function createPhaseId() {
     return randomUUID();
 }

package/dist/plan-store.d.ts

@@ -34,6 +34,10 @@ export declare class PlanStore {
     private runAsBatch;
     /** Public batch wrapper used by the module-level migrateToUuids helper. */
     runBatchForMigration<T>(fn: () => Promise<T>): Promise<T>;
+    /** Public batch wrapper: suspend autoSync (status rollup) for a sequence of
+     *  writes. Use for priority-only reorders so they don't recompute phase/feature
+     *  status (a reorder must not flip a partially-done feature to in-progress). */
+    runBatch<T>(fn: () => Promise<T>): Promise<T>;
     private maybeAutoSync;
     private normalizeTasks;
     private normalizeFeaturesDocument;
@@ -65,6 +69,10 @@ export declare class PlanStore {
     loadManifest(): Promise<Manifest>;
     loadProject(): Promise<Project>;
     loadPhase(phaseId: string): Promise<Phase>;
+    /** Read raw feature files WITHOUT the derived `status` field. Used
+     *  internally so loadFeatures/loadAll can derive status from phases without
+     *  double-loading. */
+    private loadRawFeatures;
     loadFeatures(): Promise<FeaturesDocument>;
     loadCodebaseProfile(): Promise<CodebaseProfile | null>;
     saveCodebaseProfile(profile: CodebaseProfile): Promise<void>;
@@ -155,10 +163,10 @@ export declare class PlanStore {
     private derivePhaseStatus;
     private deriveFeatureStatus;
     syncStatuses(): Promise<string[]>;
-    /** Optimized rollup: syncs only the affected phase and its parent feature.
-     *  Drastically reduces write operations and 'busy' window for task updates.
-     *  Returns the composite ref of the phase if its handoff was auto-cleared
-     *  (phase transitioned to done), else null. */
+    /** Auto-clear a phase's handoff when its DERIVED status is done. Status itself
+     *  is no longer persisted (derived on read), so the only remaining side effect
+     *  of a task→done transition is clearing a stale handoff on a completed phase.
+     *  Returns the composite ref of the phase if its handoff was cleared, else null. */
     syncTaskStatusRollup(phaseId: string): Promise<string | null>;
     updateProject(updater: (p: Project) => Project): Promise<Project>;
     updateFeatures(updater: (f: FeaturesDocument) => FeaturesDocument): Promise<FeaturesDocument>;

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

@@ -1 +1 @@
-{"version":3,"file":"plan-store.d.ts","sourceRoot":"","sources":["../src/plan-store.ts"],"names":[],"mappings":"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"}
+{"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,6 +1,6 @@
 import { access, copyFile, mkdir, readdir, readFile, rename, stat, unlink, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { CodebaseProfileSchema, FeatureSchema, FeaturesDocumentSchema, ManifestSchema, PhaseSchema, PlanWorkspaceSchema, ProjectSchema, RequirementsDocumentSchema, ResumeFocusSchema, ActivityLogSchema, } from "./schema.js";
+import { CodebaseProfileSchema, FeatureSchema, FeaturesDocumentSchema, ManifestSchema, PhaseSchema, ProjectSchema, RequirementsDocumentSchema, ResumeFocusSchema, ActivityLogSchema, } from "./schema.js";
 import { createFeatureId, createPhaseId, createRequirementId, createShortId, createTaskId, formatPhaseRef, isLegacyPhaseId } from "./naming.js";
 function nowISO() {
     return new Date().toISOString();
@@ -193,7 +193,6 @@ async function readJson(path, schema) {
         throw new PlanStoreError(`read failed: ${path}`, cause);
     }
 }
-// ─── PlanStore ──────────────────────────────────────────────────────────
 export class PlanStore {
     root;
     autoSync = false;
@@ -230,16 +229,15 @@ export class PlanStore {
     async runBatchForMigration(fn) {
         return this.runAsBatch(fn);
     }
+    /** Public batch wrapper: suspend autoSync (status rollup) for a sequence of
+     *  writes. Use for priority-only reorders so they don't recompute phase/feature
+     *  status (a reorder must not flip a partially-done feature to in-progress). */
+    async runBatch(fn) {
+        return this.runAsBatch(fn);
+    }
     async maybeAutoSync() {
-        if (!this.autoSync || this.syncGuard || this.batchInProgress)
-            return;
-        try {
-            this.syncGuard = true;
-            await this.syncStatuses();
-        }
-        finally {
-            this.syncGuard = false;
-        }
+        // No-op: status is derived on read, so there is nothing to sync after a
+        // save. Kept so existing save* call sites compile unchanged.
     }
     normalizeTasks(tasks) {
         let changed = false;
@@ -484,12 +482,19 @@ export class PlanStore {
             "- `schema/plan.schema.json` — JSON Schema for tooling",
         ].join("\n");
         await writeFile(join(this.root, "README.md"), readme, "utf-8");
-        // Write a .gitignore inside .planner/ so transient backup/tmp files are
+        // Write a .gitignore inside .planner/ so transient/derived files are
         // not tracked by the host project's git. Git respects nested .gitignore.
+        // - *.bak/*.tmp.*: crash backups from atomic writes
+        // - resume.json: per-session resume focus + the machine-local guard-bypass
+        //   timestamp (guardBypassUntil must NOT leak into git/other clones)
+        // - generated/: auto-regenerated markdown views (derived from JSON; churn)
         await writeFile(join(this.root, ".gitignore"), [
-            "# Agent Plan transient files — do not track",
+            "# Agent Plan transient/derived files — do not track",
             "*.bak",
             "*.tmp.*",
+            "resume.json",
+            "resume.*.json",
+            "generated/",
             "",
         ].join("\n"), "utf-8");
     }
@@ -510,11 +515,14 @@ export class PlanStore {
         return readJson(this.projectPath(), ProjectSchema);
     }
     async loadPhase(phaseId) {
-        const phase = await readJson(this.phasePath(phaseId), PhaseSchema);
-        return this.normalizePhaseDocument(phase).phase;
-    }
-    async loadFeatures() {
-        // Per-file layout: read features/<id>.json (one file per feature).
+        const raw = await readJson(this.phasePath(phaseId), PhaseSchema);
+        const normalized = this.normalizePhaseDocument(raw).phase;
+        return { ...normalized, status: this.derivePhaseStatus(normalized.tasks) };
+    }
+    /** Read raw feature files WITHOUT the derived `status` field. Used
+     *  internally so loadFeatures/loadAll can derive status from phases without
+     *  double-loading. */
+    async loadRawFeatures() {
         let jsonFiles = [];
         try {
             const all = await readdir(this.featuresDir());
@@ -524,28 +532,41 @@ export class PlanStore {
             // features/ absent → fall through to legacy single-file layout
         }
         if (jsonFiles.length > 0) {
-            const features = [];
+            const out = [];
             for (const f of jsonFiles) {
                 const id = f.replace(/\.json$/, "");
                 try {
-                    features.push(await readJson(this.featurePath(id), FeatureSchema));
+                    out.push(await readJson(this.featurePath(id), FeatureSchema));
                 }
                 catch (err) {
                     // Skip an invalid feature file rather than failing the whole load.
                     console.warn(`[plan-store] skipping invalid feature file ${f}:`, err);
                 }
             }
-            return this.normalizeFeaturesDocument({ features }).doc;
+            // Deterministic order: sort by the persisted `number` (creation order)
+            // so callers that renumber by index (normalizeFeaturesDocument) and
+            // callers that keep persisted numbers (loadAll) agree, regardless of the
+            // filesystem readdir order. Tiebreak by id for full determinism.
+            out.sort((a, b) => (a.number - b.number) || a.id.localeCompare(b.id));
+            return out;
         }
         // Legacy: single features.json (pre-migration read; migration writes on first write op).
         try {
             const legacy = await readJson(this.featuresPath(), FeaturesDocumentSchema);
-            return this.normalizeFeaturesDocument(legacy).doc;
+            const legacyFeatures = legacy.features;
+            legacyFeatures.sort((a, b) => (a.number - b.number) || a.id.localeCompare(b.id));
+            return legacyFeatures;
         }
         catch {
-            return { features: [] };
+            return [];
         }
     }
+    async loadFeatures() {
+        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;
+    }
     async loadCodebaseProfile() {
         try {
             return await readJson(this.codebasePath(), CodebaseProfileSchema);
@@ -731,14 +752,15 @@ export class PlanStore {
         });
     }
     async loadAll() {
-        const [manifest, project, features, requirements, phases] = await Promise.all([
+        const [manifest, project, requirements, phases] = await Promise.all([
             this.loadManifest(),
             this.loadProject(),
-            this.loadFeatures(),
             this.loadRequirements(),
             this.loadAllPhases(),
         ]);
-        return PlanWorkspaceSchema.parse({ manifest, project, features, requirements, phases });
+        const rawFeatures = await this.loadRawFeatures();
+        const features = rawFeatures.map((f) => ({ ...f, status: this.deriveFeatureStatus(f.id, phases) }));
+        return { manifest, project, requirements, phases, features: { features } };
     }
     /** Migrate legacy non-feature-scoped phase ids to feature-scoped ids and repair
      *  dangling feature.phaseIds references. Idempotent. */
@@ -1042,123 +1064,77 @@ export class PlanStore {
         const duplicateShortIds = [...sidCounts.entries()].filter(([, c]) => c > 1).map(([id]) => id);
         return { duplicatePhaseIds, danglingPhaseIds, duplicateShortIds };
     }
-    derivePhaseStatus(phase) {
-        if (phase.tasks.length === 0)
-            return phase.status;
-        const taskStatuses = phase.tasks.map((task) => task.status);
-        const allRejectedOrCanceled = taskStatuses.every((status) => status === "rejected" || status === "canceled");
-        const anyBlocked = taskStatuses.some((status) => status === "blocked");
-        const anyInProgress = taskStatuses.some((status) => status === "in-progress");
-        const anyWaiting = taskStatuses.some((status) => status === "waiting");
-        const anyDeferred = taskStatuses.some((status) => status === "deferred");
-        const anyPlanned = taskStatuses.some((status) => status === "planned");
-        const anyDone = taskStatuses.some((status) => status === "done");
-        if (allRejectedOrCanceled)
+    derivePhaseStatus(tasks) {
+        if (tasks.length === 0)
+            return "draft";
+        const taskStatuses = tasks.map((task) => task.status);
+        // Ignore rejected/canceled tasks (void) when deriving progress.
+        const meaningful = taskStatuses.filter((s) => s !== "rejected" && s !== "canceled");
+        if (meaningful.length === 0)
             return "rejected";
-        if (anyBlocked)
-            return "blocked";
-        if (anyInProgress)
+        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"))
             return "in-progress";
-        if (anyWaiting)
+        // No progress at all ⇒ surface the stall / not-started state (blocked > waiting > deferred > planned).
+        if (meaningful.some((s) => s === "blocked"))
+            return "blocked";
+        if (meaningful.some((s) => s === "waiting"))
             return "waiting";
-        if (anyDeferred)
+        if (meaningful.some((s) => s === "deferred"))
             return "deferred";
-        if (anyPlanned)
-            return "planned";
-        if (anyDone)
-            return "done";
         return "planned";
     }
-    deriveFeatureStatus(featureId, currentStatus, phases) {
+    deriveFeatureStatus(featureId, phases) {
         const featurePhases = phases.filter((phase) => phase.featureId === featureId);
         if (featurePhases.length === 0)
-            return currentStatus;
+            return "planned";
         const phaseStatuses = featurePhases.map((phase) => phase.status);
-        const allRejectedOrCanceled = phaseStatuses.every((status) => status === "rejected" || status === "canceled");
-        const anyBlocked = phaseStatuses.some((status) => status === "blocked");
-        const anyActive = phaseStatuses.some((status) => status === "discovery" || status === "in-progress");
-        const anyWaiting = phaseStatuses.some((status) => status === "waiting");
-        const anyDeferred = phaseStatuses.some((status) => status === "deferred");
-        const anyPlannedLike = phaseStatuses.some((status) => status === "draft" || status === "planned");
-        const anyDone = phaseStatuses.every((status) => status === "done");
-        if (allRejectedOrCanceled)
+        // Ignore rejected/canceled phases when deriving progress.
+        const meaningful = phaseStatuses.filter((s) => s !== "rejected" && s !== "canceled");
+        if (meaningful.length === 0)
             return "rejected";
-        if (anyBlocked)
-            return "blocked";
-        if (anyActive)
+        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"))
             return "in-progress";
-        if (anyWaiting)
+        // No progress at all ⇒ surface the stall / not-started state.
+        if (meaningful.some((s) => s === "blocked"))
+            return "blocked";
+        if (meaningful.some((s) => s === "waiting"))
             return "waiting";
-        if (anyDeferred)
+        if (meaningful.some((s) => s === "deferred"))
             return "deferred";
-        if (anyPlannedLike)
-            return "planned";
-        if (anyDone)
-            return "done";
         return "planned";
     }
     async syncStatuses() {
-        // Run as a batch so the internal saveFeatures + N savePhase calls do not
-        // re-trigger syncStatuses on every write (O(N^2) on large planners).
-        // Returns the composite refs of phases whose handoff was auto-cleared
-        // (phase transitioned to done).
-        const cleared = [];
-        await this.runAsBatch(async () => {
-            await this.migratePhaseIds();
-            const workspace = await this.loadAll();
-            const { phases, features } = workspace;
-            const featNum = new Map(features.features.map((f) => [f.id, f.number]));
-            // 1. Update Phase statuses based on tasks; auto-clear handoff when a
-            //    phase transitions to done (completed phases don't keep stale
-            //    handoffs). handoffUpdatedAt is kept as an audit trail.
-            for (const phase of phases) {
-                const was = phase.status;
-                phase.status = this.derivePhaseStatus(phase);
-                if (phase.status === "done" && was !== "done" && phase.handoff) {
-                    phase.handoff = "";
-                    cleared.push(formatPhaseRef(phase.number, featNum.get(phase.featureId ?? "")));
-                }
-            }
-            // 2. Update Feature statuses based on phases
-            for (const feature of features.features) {
-                feature.status = this.deriveFeatureStatus(feature.id, feature.status, phases);
-            }
-            // 3. Save everything
-            await this.saveFeatures(features);
-            for (const phase of phases) {
-                await this.savePhase(phase);
-            }
-            // 4. Refresh resume focus so a subentrating agent sees current state
-            await this.refreshResume();
-        });
-        return cleared;
-    }
-    /** Optimized rollup: syncs only the affected phase and its parent feature.
-     *  Drastically reduces write operations and 'busy' window for task updates.
-     *  Returns the composite ref of the phase if its handoff was auto-cleared
-     *  (phase transitioned to done), else null. */
+        // No-op: phase/feature status is now DERIVED at read time (never persisted),
+        // so there is nothing to sync. Kept for backward compatibility with callers
+        // (serve.ts, adapters) that invoke it after mutations.
+        return [];
+    }
+    /** Auto-clear a phase's handoff when its DERIVED status is done. Status itself
+     *  is no longer persisted (derived on read), so the only remaining side effect
+     *  of a task→done transition is clearing a stale handoff on a completed phase.
+     *  Returns the composite ref of the phase if its handoff was cleared, else null. */
     async syncTaskStatusRollup(phaseId) {
         const phase = await this.loadPhase(phaseId);
-        const was = phase.status;
-        phase.status = this.derivePhaseStatus(phase);
-        // Auto-clear handoff when the phase transitions to done.
-        const cleared = phase.status === "done" && was !== "done" && phase.handoff !== "";
-        if (cleared)
-            phase.handoff = "";
-        await this.savePhase(phase);
-        let feature;
-        if (phase.featureId) {
-            const featuresDoc = await this.loadFeatures();
-            feature = featuresDoc.features.find((f) => f.id === phase.featureId);
-            if (feature) {
-                // To derive feature status, we still need the statuses of all its phases
-                const allPhases = await this.loadAllPhases();
-                feature.status = this.deriveFeatureStatus(feature.id, feature.status, allPhases);
-                await this.saveFeatures(featuresDoc);
-            }
+        let cleared = null;
+        if (phase.status === "done" && phase.handoff !== "") {
+            await this.updatePhase(phaseId, (p) => ({ ...p, handoff: "", handoffUpdatedAt: nowISO() }));
+            const features = await this.loadFeatures();
+            const feature = features.features.find((f) => f.id === phase.featureId);
+            cleared = formatPhaseRef(phase.number, feature?.number);
         }
         await this.refreshResume();
-        return cleared ? formatPhaseRef(phase.number, feature?.number) : null;
+        return cleared;
     }
     // ── Savers ───────────────────────────────────────────────────────────
     async updateProject(updater) {
@@ -1247,9 +1223,17 @@ 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 updated = await atomicUpdateJson(this.phasePath(phaseId), PhaseSchema, (phase) => this.normalizePhaseDocument(updater(phase)).phase);
+        // 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
+        // not persisted); the return value is re-derived for the caller.
+        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;
+        });
         await this.maybeAutoSync();
-        return updated;
+        return { ...raw, status: this.derivePhaseStatus(raw.tasks) };
     }
     // ── Phase-scoped handoff (entity field, harness-agnostic) ────────────
     /** Get the handoff text for a phase ("" if none). Throws if phase missing. */

package/dist/recap.d.ts

@@ -0,0 +1,32 @@
+import type { PlanStore } from "./plan-store.js";
+/**
+ * Web UI info for the recap (harness-agnostic — no module globals).
+ * Pass { localUrl, lanUrl, port } from whichever harness runs the server.
+ * Omit/empty → the recap notes the dashboard is not running.
+ */
+export interface RecapWebInfo {
+    localUrl?: string | undefined;
+    lanUrl?: string | undefined;
+    port?: number | undefined;
+}
+/** Which harness is presenting the recap — drives command-name hints. */
+export type RecapHarness = "pi" | "mcp";
+export interface RecapOptions {
+    harness?: RecapHarness;
+}
+/**
+ * Build a consolidated planner recap (project state + active focus + pending
+ * handoffs + web URL). SHARED across all harnesses (Pi command, Pi tool,
+ * Claude Code/Codex MCP) so every adapter presents identical content.
+ *
+ * English by default; Italian if project.chatLanguage is set to Italian.
+ * Uses human-readable names/titles plus composite IDs (F00x / P00x(F00x) / T00x)
+ * so the user/agent can reference entities unambiguously.
+ *
+ * Pass opts.harness to get harness-correct command hints in the actionable
+ * lines (e.g. "/planner task start" in Pi vs "planner-task-start" in MCP).
+ * When the plan is fully complete, stale resume.nextSteps are suppressed and a
+ * "plan complete — add a feature/phase to continue" hint is shown instead.
+ */
+export declare function buildRecap(st: PlanStore, web?: RecapWebInfo, opts?: RecapOptions): Promise<string>;
+//# sourceMappingURL=recap.d.ts.map

package/dist/recap.d.ts.map

@@ -0,0 +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,CA+GhH"}

package/dist/recap.js

@@ -0,0 +1,105 @@
+import { formatPhaseRef, formatTwoDigitNumber } from "./naming.js";
+const fref = (n) => `F${formatTwoDigitNumber(n)}`;
+const tref = (n) => `T${formatTwoDigitNumber(n)}`;
+/**
+ * Build a consolidated planner recap (project state + active focus + pending
+ * handoffs + web URL). SHARED across all harnesses (Pi command, Pi tool,
+ * Claude Code/Codex MCP) so every adapter presents identical content.
+ *
+ * English by default; Italian if project.chatLanguage is set to Italian.
+ * Uses human-readable names/titles plus composite IDs (F00x / P00x(F00x) / T00x)
+ * so the user/agent can reference entities unambiguously.
+ *
+ * Pass opts.harness to get harness-correct command hints in the actionable
+ * lines (e.g. "/planner task start" in Pi vs "planner-task-start" in MCP).
+ * When the plan is fully complete, stale resume.nextSteps are suppressed and a
+ * "plan complete — add a feature/phase to continue" hint is shown instead.
+ */
+export async function buildRecap(st, web = {}, opts = {}) {
+    const [plan, resume, handoffs] = await Promise.all([
+        st.loadAll(),
+        st.loadResume().catch(() => null),
+        st.listHandoffs(),
+    ]);
+    const feats = plan.features.features;
+    const phases = plan.phases;
+    const allTasks = phases.flatMap((p) => p.tasks.map((task) => ({ phase: p, task })));
+    const totalF = feats.length;
+    const doneF = feats.filter((x) => x.status === "done").length;
+    const activeF = feats.filter((x) => x.status === "in-progress").length;
+    const totalP = phases.length;
+    const doneP = phases.filter((x) => x.status === "done").length;
+    const activeP = phases.filter((x) => x.status === "in-progress" || x.status === "discovery").length;
+    const totalT = allTasks.length;
+    const doneT = allTasks.filter(({ task }) => task.status === "done").length;
+    const activeT = allTasks.filter(({ task }) => task.status === "in-progress").length;
+    // Plan is fully complete: there is work and all of it is done, nothing active.
+    // (totalT > 0 guards the empty/unstarted case from looking "complete".)
+    const planComplete = totalT > 0 && doneT === totalT && doneP === totalP && doneF === totalF;
+    // Current focus = first in-progress task (and its phase/feature).
+    const focusTask = allTasks.find(({ task }) => task.status === "in-progress");
+    const focusPhase = focusTask?.phase;
+    const focusFeature = focusPhase ? feats.find((x) => x.id === focusPhase.featureId) : undefined;
+    const italian = (plan.project.chatLanguage || "").toLowerCase().includes("ital");
+    // Harness-aware command names for actionable hints.
+    const isPi = opts.harness === "pi";
+    const cmd = (piCmd, mcpCmd) => (isPi ? piCmd : mcpCmd);
+    const taskAddCmd = cmd("/planner task add", "planner-task-add");
+    const taskStartCmd = cmd("/planner task start", "planner-task-start");
+    const featureAddCmd = cmd("/planner feature add", "planner-feature-add");
+    const phaseAddCmd = cmd("/planner phase add", "planner-phase-add");
+    const handoffShowCmd = cmd("/planner handoff show", "planner-handoff-show");
+    const handoffClearCmd = cmd("/planner handoff clear", "planner-handoff-clear");
+    const lines = [];
+    lines.push(italian ? "## Ripresa planner" : "## Planner recap");
+    const name = plan.project.name || "(unnamed project)";
+    lines.push(`${italian ? "Progetto" : "Project"}: ${name}${plan.project.goal ? " — " + plan.project.goal : ""}`);
+    lines.push(italian
+        ? `Avanzamento: feature ${doneF}/${totalF} completate (${activeF} attive) · fasi ${doneP}/${totalP} completate (${activeP} attive) · task ${doneT}/${totalT} completati (${activeT} attivi)`
+        : `Progress: Features ${doneF}/${totalF} done (${activeF} active) · Phases ${doneP}/${totalP} done (${activeP} active) · Tasks ${doneT}/${totalT} done (${activeT} active)`);
+    if (focusTask && focusPhase) {
+        const fr = focusFeature ? fref(focusFeature.number) : "?";
+        const pr = formatPhaseRef(focusPhase.number, focusFeature?.number);
+        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 (planComplete) {
+        lines.push(italian
+            ? "Focus corrente: piano completo — tutte le feature/fasi/task sono concluse."
+            : "Current focus: plan complete — all features/phases/tasks are done.");
+    }
+    else {
+        lines.push(`${italian ? "Focus corrente" : "Current focus"}: ${italian ? "nessun task attivo — rivedi il piano e scegli il prossimo task concreto" : "no active task — review the plan and pick the next concrete task"}`);
+    }
+    // Next step: only surface resume.nextSteps when the plan is NOT complete —
+    // otherwise stale init-time steps (e.g. "bootstrap discovery") leak through
+    // and contradict an all-done plan.
+    if (!planComplete && resume?.nextSteps?.length) {
+        lines.push(`${italian ? "Prossimo step" : "Next step"}: ${resume.nextSteps[0]}`);
+    }
+    if (handoffs.length > 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), poi ${handoffClearCmd} <ref> una volta consumato.`
+            : `→ Read the relevant one with ${handoffShowCmd} <ref> (validate against current state), then call ${handoffClearCmd} <ref> once consumed (delete-on-resume).`);
+    }
+    else if (planComplete) {
+        lines.push("", italian
+            ? `Piano completo — aggiungi una nuova feature (${featureAddCmd}) o fase (${phaseAddCmd}) per continuare.`
+            : `Plan complete — add a new feature (${featureAddCmd}) or phase (${phaseAddCmd}) to continue.`);
+    }
+    else if (activeT === 0) {
+        lines.push("", italian
+            ? `Nessun handoff pendente e nessun task in-progress. Usa ${taskAddCmd} / ${taskStartCmd} per iniziare.`
+            : `No phase handoff pending and no task in-progress. Use ${taskAddCmd} / ${taskStartCmd} to begin work.`);
+    }
+    if (web.localUrl) {
+        lines.push("", italian ? "## Web UI" : "## Web UI", `🌐 Web UI: ${web.localUrl}${web.lanUrl ? " (LAN: " + web.lanUrl + ")" : ""}${web.port ? " (port " + web.port + ")" : ""}`);
+    }
+    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?");
+    return lines.join("\n");
+}

package/dist/refs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAKlD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,GAAG,EAAE,MAAM,GACV,KAAK,GAAG,SAAS,CA2BnB"}
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAKlD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,OAAO,EAAE,EACnB,GAAG,EAAE,MAAM,GACV,KAAK,GAAG,SAAS,CAgCnB"}

package/dist/refs.js

@@ -31,7 +31,12 @@ export function findPhaseByRef(phases, features, ref) {
         if (found)
             return found;
     }
-    // 3. Title fallback (backward compatibility with agents using titles)
+    // 3. ShortId
+    found = phases.find((p) => p.shortId && p.shortId.toLowerCase() === normalized);
+    if (found)
+        return found;
+    // 4. Title fallback (backward compatibility with agents using titles)
+    // 5. Title fallback (backward compatibility with agents using titles)
     return (phases.find((p) => p.title.toLowerCase() === normalized) ??
         phases.find((p) => p.title.toLowerCase().includes(normalized)));
 }

package/dist/schema.d.ts

@@ -727,7 +727,6 @@ export declare const PhaseSchema: z.ZodObject<{
     priority: z.ZodDefault<z.ZodNumber>;
     slug: z.ZodString;
     title: z.ZodString;
-    status: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
     discussedAt: z.ZodDefault<z.ZodString>;
     contextReady: z.ZodDefault<z.ZodBoolean>;
     contextReadyReason: z.ZodDefault<z.ZodString>;
@@ -1052,7 +1051,6 @@ export declare const PhaseSchema: z.ZodObject<{
     handoffUpdatedAt: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     number: number;
-    status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
     dependencies: string[];
     updatedAt: string;
     notes: string;
@@ -1135,7 +1133,6 @@ export declare const PhaseSchema: z.ZodObject<{
     featureId?: string | undefined;
 }, {
     number: number;
-    status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
     updatedAt: string;
     id: string;
     createdAt: string;
@@ -1224,7 +1221,6 @@ export declare const FeatureSchema: z.ZodObject<{
     priority: z.ZodDefault<z.ZodNumber>;
     name: z.ZodString;
     description: z.ZodDefault<z.ZodString>;
-    status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
     discussedAt: z.ZodDefault<z.ZodString>;
     contextReady: z.ZodDefault<z.ZodBoolean>;
     contextReadyReason: z.ZodDefault<z.ZodString>;
@@ -1260,7 +1256,6 @@ export declare const FeatureSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     number: number;
-    status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
     name: string;
     updatedAt: string;
     id: string;
@@ -1286,7 +1281,6 @@ export declare const FeatureSchema: z.ZodObject<{
     workRemaining: string;
     phaseIds: string[];
 }, {
-    status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
     name: string;
     updatedAt: string;
     id: string;
@@ -1321,7 +1315,6 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         priority: z.ZodDefault<z.ZodNumber>;
         name: z.ZodString;
         description: z.ZodDefault<z.ZodString>;
-        status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         discussedAt: z.ZodDefault<z.ZodString>;
         contextReady: z.ZodDefault<z.ZodBoolean>;
         contextReadyReason: z.ZodDefault<z.ZodString>;
@@ -1357,7 +1350,6 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         number: number;
-        status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
         name: string;
         updatedAt: string;
         id: string;
@@ -1383,7 +1375,6 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         workRemaining: string;
         phaseIds: string[];
     }, {
-        status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
         name: string;
         updatedAt: string;
         id: string;
@@ -1413,7 +1404,6 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     features: {
         number: number;
-        status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
         name: string;
         updatedAt: string;
         id: string;
@@ -1441,7 +1431,6 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
     }[];
 }, {
     features: {
-        status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
         name: string;
         updatedAt: string;
         id: string;
@@ -1784,7 +1773,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             priority: z.ZodDefault<z.ZodNumber>;
             name: z.ZodString;
             description: z.ZodDefault<z.ZodString>;
-            status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
             discussedAt: z.ZodDefault<z.ZodString>;
             contextReady: z.ZodDefault<z.ZodBoolean>;
             contextReadyReason: z.ZodDefault<z.ZodString>;
@@ -1820,7 +1808,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             updatedAt: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             number: number;
-            status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
             name: string;
             updatedAt: string;
             id: string;
@@ -1846,7 +1833,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             workRemaining: string;
             phaseIds: string[];
         }, {
-            status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
             name: string;
             updatedAt: string;
             id: string;
@@ -1876,7 +1862,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         features: {
             number: number;
-            status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
             name: string;
             updatedAt: string;
             id: string;
@@ -1904,7 +1889,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }[];
     }, {
         features: {
-            status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
             name: string;
             updatedAt: string;
             id: string;
@@ -2041,7 +2025,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         priority: z.ZodDefault<z.ZodNumber>;
         slug: z.ZodString;
         title: z.ZodString;
-        status: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         discussedAt: z.ZodDefault<z.ZodString>;
         contextReady: z.ZodDefault<z.ZodBoolean>;
         contextReadyReason: z.ZodDefault<z.ZodString>;
@@ -2366,7 +2349,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         handoffUpdatedAt: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         number: number;
-        status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         dependencies: string[];
         updatedAt: string;
         notes: string;
@@ -2449,7 +2431,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         featureId?: string | undefined;
     }, {
         number: number;
-        status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -2535,7 +2516,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
     features: {
         features: {
             number: number;
-            status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
             name: string;
             updatedAt: string;
             id: string;
@@ -2617,7 +2597,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
     };
     phases: {
         number: number;
-        status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         dependencies: string[];
         updatedAt: string;
         notes: string;
@@ -2702,7 +2681,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
 }, {
     features: {
         features: {
-            status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting";
             name: string;
             updatedAt: string;
             id: string;
@@ -2785,7 +2763,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
     };
     phases: {
         number: number;
-        status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -2876,8 +2853,12 @@ export type ActivityEntry = z.infer<typeof ActivityEntrySchema>;
 export type ActivityLog = z.infer<typeof ActivityLogSchema>;
 export type ResumeFocus = z.infer<typeof ResumeFocusSchema>;
 export type FeatureStatus = z.infer<typeof FeatureStatusSchema>;
-export type Feature = z.infer<typeof FeatureSchema>;
-export type FeaturesDocument = z.infer<typeof FeaturesDocumentSchema>;
+export type Feature = z.infer<typeof FeatureSchema> & {
+    status: FeatureStatus;
+};
+export type FeaturesDocument = {
+    features: Feature[];
+};
 export type PhaseStatus = z.infer<typeof PhaseStatusSchema>;
 export type TaskStatus = z.infer<typeof TaskStatusSchema>;
 export type RequirementStatus = z.infer<typeof RequirementStatusSchema>;
@@ -2890,9 +2871,14 @@ export type Subtask = z.infer<typeof SubtaskSchema>;
 export type ChecklistItem = z.infer<typeof ChecklistItemSchema>;
 export type StatusLogEntry = z.infer<typeof StatusLogEntrySchema>;
 export type Task = z.infer<typeof TaskSchema>;
-export type Phase = z.infer<typeof PhaseSchema>;
+export type Phase = z.infer<typeof PhaseSchema> & {
+    status: PhaseStatus;
+};
 export type MacroTask = z.infer<typeof MacroTaskSchema>;
 export type Requirement = z.infer<typeof RequirementSchema>;
 export type RequirementsDocument = z.infer<typeof RequirementsDocumentSchema>;
-export type PlanWorkspace = z.infer<typeof PlanWorkspaceSchema>;
+export type PlanWorkspace = Omit<z.infer<typeof PlanWorkspaceSchema>, "phases" | "features"> & {
+    phases: Phase[];
+    features: FeaturesDocument;
+};
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/schema.js

@@ -171,7 +171,9 @@ export const PhaseSchema = z.object({
     priority: z.number().int().nonnegative().default(0),
     slug: SlugSchema,
     title: z.string().min(1),
-    status: PhaseStatusSchema,
+    // NOTE: `status` is intentionally ABSENT from the schema — it is a DERIVED
+    // value (computed from child tasks at read time) and is never persisted.
+    // The runtime `Phase` type re-adds it as a non-optional field (see below).
     discussedAt: z.string().default(""),
     contextReady: z.boolean().default(false),
     contextReadyReason: z.string().default(""),
@@ -201,7 +203,8 @@ export const FeatureSchema = z.object({
     priority: z.number().int().nonnegative().default(0),
     name: z.string().min(1),
     description: z.string().default(""),
-    status: FeatureStatusSchema,
+    // NOTE: `status` is intentionally ABSENT — it is DERIVED from child phases
+    // at read time and never persisted. The runtime `Feature` type re-adds it.
     discussedAt: z.string().default(""),
     contextReady: z.boolean().default(false),
     contextReadyReason: z.string().default(""),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-plan/core",
-  "version": "0.2.19-next.0",
+  "version": "0.2.19-next.2",
   "private": false,
   "description": "Harness-agnostic core for Agent Plan: schemas, persistence, ordering, status rollups, and markdown rendering.",
   "license": "MIT",