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

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./naming.js";
+export * from "./refs.js";
 export * from "./schema.js";
-export { PlanStore, PlanStoreError, setWriteBusyHook, setWriteNotifyHook, migrateToUuids, withFeatureLock } from "./plan-store.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";
 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,aAAa,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnI,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,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,4 +1,5 @@
 export * from "./naming.js";
+export * from "./refs.js";
 export * from "./schema.js";
 export { PlanStore, PlanStoreError, setWriteBusyHook, setWriteNotifyHook, migrateToUuids, withFeatureLock } from "./plan-store.js";
 export { PlanRenderer } from "./renderer.js";

package/dist/naming.d.ts

@@ -1,3 +1,12 @@
+/** Crockford Base32 alphabet — excludes ambiguous characters 0/O/1/I/L
+ *  to minimize human transcription errors. 32 symbols → 5 chars = 33M combos. */
+export declare const CROCKFORD_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
+export declare const SHORT_ID_LENGTH = 5;
+export declare const SHORT_ID_PATTERN: RegExp;
+/** 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). */
+export declare function createShortId(existing?: Set<string>): string;
 export declare function normalizeSlug(input: string): string;
 /** Normalize, truncate to maxLen, and strip dangling dashes so the result
  * always satisfies SlugSchema (/^[a-z0-9]+(?:-[a-z0-9]+)*$/). Returns fallback
@@ -7,6 +16,10 @@ export declare function normalizeSlug(input: string): string;
 export declare function clampSlug(input: string, maxLen?: number, fallback?: string): string;
 export declare function formatTwoDigitNumber(value: number): string;
 export declare function formatThreeDigitNumber(value: number): string;
+/** Human-readable phase composite ref: `P00x` or `P00x(F00x)` when the parent
+ *  feature number is known. Harness-agnostic (used by core handoff listing +
+ *  adapters). */
+export declare function formatPhaseRef(phaseNumber: number, featureNumber?: number): string;
 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,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,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,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

@@ -1,6 +1,26 @@
-import { randomUUID } from "node:crypto";
+import { randomInt, randomUUID } from "node:crypto";
 const SLUG_PATTERN = /[^a-z0-9]+/g;
 const MULTI_DASH_PATTERN = /-+/g;
+/** Crockford Base32 alphabet — excludes ambiguous characters 0/O/1/I/L
+ *  to minimize human transcription errors. 32 symbols → 5 chars = 33M combos. */
+export const CROCKFORD_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
+export const SHORT_ID_LENGTH = 5;
+export const SHORT_ID_PATTERN = /^[A-Z2-9]{5}$/;
+/** 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). */
+export function createShortId(existing = new Set()) {
+    const max = CROCKFORD_ALPHABET.length;
+    for (let attempt = 0; attempt < 64; attempt += 1) {
+        let id = "";
+        for (let i = 0; i < SHORT_ID_LENGTH; i += 1) {
+            id += CROCKFORD_ALPHABET[randomInt(0, max)];
+        }
+        if (!existing.has(id))
+            return id;
+    }
+    throw new Error("createShortId: could not generate a unique id after 64 attempts");
+}
 export function normalizeSlug(input) {
     return input
         .trim()
@@ -24,6 +44,13 @@ export function formatTwoDigitNumber(value) {
 export function formatThreeDigitNumber(value) {
     return String(value).padStart(3, "0");
 }
+/** Human-readable phase composite ref: `P00x` or `P00x(F00x)` when the parent
+ *  feature number is known. Harness-agnostic (used by core handoff listing +
+ *  adapters). */
+export function formatPhaseRef(phaseNumber, featureNumber) {
+    const p = `P${formatThreeDigitNumber(phaseNumber)}`;
+    return featureNumber != null ? `${p}(F${formatThreeDigitNumber(featureNumber)})` : p;
+}
 export function createPhaseId() {
     return randomUUID();
 }

package/dist/plan-store.d.ts

@@ -1,4 +1,4 @@
-import { 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 ActivityEntry, type ActivityLog, type CodebaseProfile, type ResumeFocus } from "./schema.js";
 export declare class PlanStoreError extends Error {
     readonly cause?: unknown | undefined;
     constructor(message: string, cause?: unknown | undefined);
@@ -6,6 +6,16 @@ export declare class PlanStoreError extends Error {
 export declare function setWriteBusyHook(hook: ((busy: boolean) => void) | undefined): void;
 export declare function setWriteNotifyHook(hook: (() => void) | undefined): void;
 export declare function withFeatureLock<T>(featureId: string, fn: () => Promise<T>): Promise<T>;
+/** Summary of a phase that has a non-empty handoff, for the listHandoffs() API. */
+export interface PhaseHandoffSummary {
+    phaseId: string;
+    /** Human-readable composite ref, e.g. `P003` or `P003(F002)`. */
+    compositeRef: string;
+    /** handoffUpdatedAt (falls back to phase.updatedAt if unset). */
+    updatedAt: string;
+    /** First non-empty line of the handoff, leading markdown headers stripped, ~80 chars. */
+    firstLine: string;
+}
 export declare function migrateToUuids(store: PlanStore): Promise<void>;
 export declare class PlanStore {
     readonly root: string;
@@ -36,6 +46,13 @@ export declare class PlanStore {
     private projectPath;
     private requirementsPath;
     private featuresPath;
+    private featuresDir;
+    private featurePath;
+    private withFeaturesLock;
+    /** Idempotent one-time migration: if a legacy features.json exists, split it
+     *  into features/<id>.json (one per feature) and remove the legacy file.
+     *  Must be called under withFeaturesLock. Crash-safe: re-run overwrites. */
+    private migrateLegacy;
     private phasesDir;
     private phasePath;
     private generatedDir;
@@ -95,6 +112,22 @@ export declare class PlanStore {
     cleanupOrphanBackups(): Promise<{
         removed: number;
     }>;
+    /** All non-empty shortIds currently assigned in the project (features + phases + tasks).
+     *  Read-only; used by createShortId collision guard during entity creation. */
+    assignedShortIds(): Promise<Set<string>>;
+    /** Next priority (>=1) for a new entity within its scope.
+     *  - feature: max priority among features + 1
+     *  - phase: max priority among phases of parentId (featureId) + 1
+     *  - task: max priority among tasks of parentId (phaseId) + 1 */
+    nextPriority(kind: "feature" | "phase" | "task", parentId?: string): Promise<number>;
+    /** Idempotent backfill of shortId (globally-unique 5-char Crockford) and priority
+     *  (per-scope display order). Assigns missing shortIds and priorities; never overwrites
+     *  existing non-empty shortIds or non-zero priorities. Safe to run at startup. */
+    ensureShortIdsAndPriority(): Promise<{
+        shortIdsAssigned: number;
+        prioritiesAssigned: number;
+        duplicateShortIds: string[];
+    }>;
     /** Repair dangling references and report integrity. One-shot maintenance op. */
     repair(): Promise<{
         migrated: {
@@ -102,33 +135,57 @@ export declare class PlanStore {
             repaired: number;
             inferred: number;
         };
+        backfill: {
+            shortIdsAssigned: number;
+            prioritiesAssigned: number;
+            duplicateShortIds: string[];
+        };
         integrity: {
             duplicatePhaseIds: string[];
             danglingPhaseIds: string[];
+            duplicateShortIds: string[];
         };
     }>;
     /** Validate plan integrity: globally unique phase ids and resolvable feature.phaseIds. */
     validateIntegrity(): Promise<{
         duplicatePhaseIds: string[];
         danglingPhaseIds: string[];
+        duplicateShortIds: string[];
     }>;
     private derivePhaseStatus;
     private deriveFeatureStatus;
-    syncStatuses(): Promise<void>;
+    syncStatuses(): Promise<string[]>;
     /** Optimized rollup: syncs only the affected phase and its parent feature.
-     *  Drastically reduces write operations and 'busy' window for task updates. */
-    syncTaskStatusRollup(phaseId: string): Promise<void>;
+     *  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. */
+    syncTaskStatusRollup(phaseId: string): Promise<string | null>;
     updateProject(updater: (p: Project) => Project): Promise<Project>;
     updateFeatures(updater: (f: FeaturesDocument) => FeaturesDocument): Promise<FeaturesDocument>;
     updateRequirements(updater: (r: RequirementsDocument) => RequirementsDocument): Promise<RequirementsDocument>;
     saveProject(project: Project): Promise<void>;
     saveFeatures(features: FeaturesDocument): Promise<void>;
+    /** Per-file write of all features + orphan reconcile. No lock (caller holds withFeaturesLock). */
+    private saveFeaturesRaw;
+    /** Granular single-feature write (per-file lock; parallel-safe across features). */
+    saveFeature(feature: Feature): Promise<void>;
     saveRequirements(reqs: RequirementsDocument): Promise<void>;
     savePhase(phase: Phase): Promise<void>;
     /** Atomic read-modify-write on a single phase file. Serializes concurrent
      *  task_create / phase_update calls on the SAME phaseId so batch operations
      *  don't lose tasks (last-write-wins race condition). */
     updatePhase(phaseId: string, updater: (phase: Phase) => Phase): Promise<Phase>;
+    /** Get the handoff text for a phase ("" if none). Throws if phase missing. */
+    getPhaseHandoff(phaseId: string): Promise<string>;
+    /** Set the handoff text for a phase + stamp handoffUpdatedAt. Atomic per-file
+     *  update via updatePhase (so the web UI refreshes via maybeAutoSync). */
+    setPhaseHandoff(phaseId: string, text: string): Promise<void>;
+    /** Clear the handoff text for a phase (handoff=""). handoffUpdatedAt is left
+     *  unchanged as an audit trail (when a handoff last existed). */
+    clearPhaseHandoff(phaseId: string): Promise<void>;
+    /** 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[]>;
     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":"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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,7 +1,7 @@
-import { access, copyFile, mkdir, readFile, rename, stat, unlink, writeFile } from "node:fs/promises";
+import { access, copyFile, mkdir, readdir, readFile, rename, stat, unlink, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { CodebaseProfileSchema, FeaturesDocumentSchema, ManifestSchema, PhaseSchema, PlanWorkspaceSchema, ProjectSchema, RequirementsDocumentSchema, ResumeFocusSchema, ActivityLogSchema, } from "./schema.js";
-import { createFeatureId, createPhaseId, createRequirementId, createTaskId, isLegacyPhaseId } from "./naming.js";
+import { CodebaseProfileSchema, FeatureSchema, FeaturesDocumentSchema, ManifestSchema, PhaseSchema, PlanWorkspaceSchema, ProjectSchema, RequirementsDocumentSchema, ResumeFocusSchema, ActivityLogSchema, } from "./schema.js";
+import { createFeatureId, createPhaseId, createRequirementId, createShortId, createTaskId, formatPhaseRef, isLegacyPhaseId } from "./naming.js";
 function nowISO() {
     return new Date().toISOString();
 }
@@ -108,6 +108,12 @@ async function atomicUpdateJson(path, schema, updater) {
         return parsed;
     });
 }
+/** Extract the first meaningful line of a handoff: skip blank lines, strip a
+ *  leading markdown header (#), trim, and truncate to ~80 chars. */
+function handoffFirstLine(text) {
+    const line = text.trim().split(/\r?\n/).find((l) => l.trim().length > 0) ?? "";
+    return line.replace(/^#+\s*/, "").trim().slice(0, 80);
+}
 export async function migrateToUuids(store) {
     // Run as a batch so internal saveFeatures/savePhase calls do not
     // re-trigger syncStatuses (O(N^2) on large planners). Idempotent: if there
@@ -335,7 +341,7 @@ export class PlanStore {
     }
     async ensureStructureOrdering() {
         return this.runAsBatch(async () => {
-            const featuresDoc = await readJson(this.featuresPath(), FeaturesDocumentSchema).catch(() => ({ features: [] }));
+            const featuresDoc = await this.loadFeatures();
             const phases = await this.loadAllPhases();
             const normalized = this.normalizeStructureSnapshot(featuresDoc, phases);
             if (!normalized.changed)
@@ -360,6 +366,35 @@ export class PlanStore {
     featuresPath() {
         return join(this.root, "features.json");
     }
+    featuresDir() {
+        return join(this.root, "features");
+    }
+    featurePath(featureId) {
+        return join(this.featuresDir(), `${featureId}.json`);
+    }
+    withFeaturesLock(fn) {
+        // Sentinel-keyed mutex (the features dir path) serializing all feature
+        // mutations so read-modify-write via updateFeatures is race-free and the
+        // one-time legacy→per-file migration never interleaves with a writer.
+        return withWriteLock(this.featuresDir(), fn);
+    }
+    /** Idempotent one-time migration: if a legacy features.json exists, split it
+     *  into features/<id>.json (one per feature) and remove the legacy file.
+     *  Must be called under withFeaturesLock. Crash-safe: re-run overwrites. */
+    async migrateLegacy() {
+        let legacy;
+        try {
+            legacy = await readJson(this.featuresPath(), FeaturesDocumentSchema);
+        }
+        catch {
+            return; // no legacy features.json (already migrated or fresh project)
+        }
+        await mkdir(this.featuresDir(), { recursive: true });
+        for (const feat of legacy.features) {
+            await atomicWriteJson(this.featurePath(feat.id), feat);
+        }
+        await unlink(this.featuresPath()).catch(() => { });
+    }
     phasesDir() {
         return join(this.root, "phases");
     }
@@ -388,6 +423,7 @@ export class PlanStore {
         }
         await mkdir(this.root, { recursive: true });
         await mkdir(this.phasesDir(), { recursive: true });
+        await mkdir(this.featuresDir(), { recursive: true });
         await mkdir(join(this.generatedDir(), "phases"), { recursive: true });
         await mkdir(join(this.root, "schema"), { recursive: true });
         await mkdir(join(this.root, "adapters"), { recursive: true });
@@ -478,9 +514,33 @@ export class PlanStore {
         return this.normalizePhaseDocument(phase).phase;
     }
     async loadFeatures() {
+        // Per-file layout: read features/<id>.json (one file per feature).
+        let jsonFiles = [];
         try {
-            const features = await readJson(this.featuresPath(), FeaturesDocumentSchema);
-            return this.normalizeFeaturesDocument(features).doc;
+            const all = await readdir(this.featuresDir());
+            jsonFiles = all.filter((f) => f.endsWith(".json"));
+        }
+        catch {
+            // features/ absent → fall through to legacy single-file layout
+        }
+        if (jsonFiles.length > 0) {
+            const features = [];
+            for (const f of jsonFiles) {
+                const id = f.replace(/\.json$/, "");
+                try {
+                    features.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;
+        }
+        // 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;
         }
         catch {
             return { features: [] };
@@ -795,13 +855,156 @@ export class PlanStore {
         catch { /* best-effort */ }
         return { removed };
     }
+    /** All non-empty shortIds currently assigned in the project (features + phases + tasks).
+     *  Read-only; used by createShortId collision guard during entity creation. */
+    async assignedShortIds() {
+        const features = await this.loadFeatures();
+        const phases = await this.loadAllPhases();
+        const ids = new Set();
+        for (const f of features.features)
+            if (f.shortId)
+                ids.add(f.shortId);
+        for (const p of phases) {
+            if (p.shortId)
+                ids.add(p.shortId);
+            for (const t of p.tasks)
+                if (t.shortId)
+                    ids.add(t.shortId);
+        }
+        return ids;
+    }
+    /** Next priority (>=1) for a new entity within its scope.
+     *  - feature: max priority among features + 1
+     *  - phase: max priority among phases of parentId (featureId) + 1
+     *  - task: max priority among tasks of parentId (phaseId) + 1 */
+    async nextPriority(kind, parentId) {
+        if (kind === "feature") {
+            const features = await this.loadFeatures();
+            const max = features.features.reduce((m, f) => Math.max(m, f.priority ?? 0), 0);
+            return max + 1;
+        }
+        if (kind === "phase") {
+            const phases = await this.loadAllPhases();
+            const siblings = phases.filter((p) => p.featureId === parentId);
+            const max = siblings.reduce((m, p) => Math.max(m, p.priority ?? 0), 0);
+            return max + 1;
+        }
+        // task
+        const phase = parentId ? await this.loadPhase(parentId).catch(() => undefined) : undefined;
+        const tasks = phase?.tasks ?? [];
+        const max = tasks.reduce((m, t) => Math.max(m, t.priority ?? 0), 0);
+        return max + 1;
+    }
+    /** Idempotent backfill of shortId (globally-unique 5-char Crockford) and priority
+     *  (per-scope display order). Assigns missing shortIds and priorities; never overwrites
+     *  existing non-empty shortIds or non-zero priorities. Safe to run at startup. */
+    async ensureShortIdsAndPriority() {
+        return this.runAsBatch(async () => {
+            const featuresDoc = await this.loadFeatures();
+            const phases = await this.loadAllPhases();
+            const existing = new Set();
+            for (const f of featuresDoc.features)
+                if (f.shortId)
+                    existing.add(f.shortId);
+            for (const p of phases) {
+                if (p.shortId)
+                    existing.add(p.shortId);
+                for (const t of p.tasks)
+                    if (t.shortId)
+                        existing.add(t.shortId);
+            }
+            let shortIdsAssigned = 0;
+            let prioritiesAssigned = 0;
+            let featuresDirty = false;
+            const assignPriority = (current, index) => {
+                if (current === 0) {
+                    prioritiesAssigned += 1;
+                    return index + 1;
+                }
+                return current;
+            };
+            // Features: shortId + priority (project scope)
+            const sortedFeatures = [...featuresDoc.features].sort((a, b) => a.number - b.number || a.createdAt.localeCompare(b.createdAt));
+            sortedFeatures.forEach((f, index) => {
+                if (!f.shortId) {
+                    f.shortId = createShortId(existing);
+                    existing.add(f.shortId);
+                    shortIdsAssigned += 1;
+                    featuresDirty = true;
+                }
+                const nextP = assignPriority(f.priority ?? 0, index);
+                if (nextP !== f.priority) {
+                    f.priority = nextP;
+                    featuresDirty = true;
+                }
+            });
+            if (featuresDirty) {
+                featuresDoc.features.sort((a, b) => a.priority - b.priority || a.number - b.number);
+                await this.saveFeatures(featuresDoc);
+            }
+            // Phases + tasks
+            for (const phase of phases) {
+                let phaseDirty = false;
+                if (!phase.shortId) {
+                    phase.shortId = createShortId(existing);
+                    existing.add(phase.shortId);
+                    shortIdsAssigned += 1;
+                    phaseDirty = true;
+                }
+                const phaseIndex = phase.number - 1; // stable pre-migration order
+                const nextPP = assignPriority(phase.priority ?? 0, phaseIndex < 0 ? 0 : phaseIndex);
+                if (nextPP !== phase.priority) {
+                    phase.priority = nextPP;
+                    phaseDirty = true;
+                }
+                const sortedTasks = [...phase.tasks].sort((a, b) => a.number - b.number || a.createdAt.localeCompare(b.createdAt));
+                sortedTasks.forEach((t, index) => {
+                    if (!t.shortId) {
+                        t.shortId = createShortId(existing);
+                        existing.add(t.shortId);
+                        shortIdsAssigned += 1;
+                        phaseDirty = true;
+                    }
+                    const nextTP = assignPriority(t.priority ?? 0, index);
+                    if (nextTP !== t.priority) {
+                        t.priority = nextTP;
+                        phaseDirty = true;
+                    }
+                });
+                if (phaseDirty) {
+                    phase.tasks.sort((a, b) => a.priority - b.priority || a.number - b.number);
+                    phase.taskIds = phase.tasks.map((t) => t.id);
+                    phase.updatedAt = nowISO();
+                    await this.savePhase(phase);
+                }
+            }
+            // Duplicate shortId report (across all entities)
+            const allShortIds = [];
+            for (const f of featuresDoc.features)
+                if (f.shortId)
+                    allShortIds.push(f.shortId);
+            for (const ph of phases) {
+                if (ph.shortId)
+                    allShortIds.push(ph.shortId);
+                for (const t of ph.tasks)
+                    if (t.shortId)
+                        allShortIds.push(t.shortId);
+            }
+            const counts = new Map();
+            for (const id of allShortIds)
+                counts.set(id, (counts.get(id) ?? 0) + 1);
+            const duplicateShortIds = [...counts.entries()].filter(([, c]) => c > 1).map(([id]) => id);
+            return { shortIdsAssigned, prioritiesAssigned, duplicateShortIds };
+        });
+    }
     /** Repair dangling references and report integrity. One-shot maintenance op. */
     async repair() {
         return this.runAsBatch(async () => {
             const migrated = await this.migratePhaseIds();
+            const backfill = await this.ensureShortIdsAndPriority();
             const integrity = await this.validateIntegrity();
             await this.writeGenerated();
-            return { migrated, integrity };
+            return { migrated, backfill, integrity };
         });
     }
     /** Validate plan integrity: globally unique phase ids and resolvable feature.phaseIds. */
@@ -821,7 +1024,23 @@ export class PlanStore {
                     danglingPhaseIds.push(`${feature.id} -> ${ref}`);
             }
         }
-        return { duplicatePhaseIds, danglingPhaseIds };
+        // Duplicate shortIds across all entities
+        const allShortIds = [];
+        for (const f of features.features)
+            if (f.shortId)
+                allShortIds.push(f.shortId);
+        for (const ph of phases) {
+            if (ph.shortId)
+                allShortIds.push(ph.shortId);
+            for (const t of ph.tasks)
+                if (t.shortId)
+                    allShortIds.push(t.shortId);
+        }
+        const sidCounts = new Map();
+        for (const id of allShortIds)
+            sidCounts.set(id, (sidCounts.get(id) ?? 0) + 1);
+        const duplicateShortIds = [...sidCounts.entries()].filter(([, c]) => c > 1).map(([id]) => id);
+        return { duplicatePhaseIds, danglingPhaseIds, duplicateShortIds };
     }
     derivePhaseStatus(phase) {
         if (phase.tasks.length === 0)
@@ -881,13 +1100,24 @@ export class PlanStore {
     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;
-            // 1. Update Phase statuses based on tasks
+            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) {
@@ -901,16 +1131,25 @@ export class PlanStore {
             // 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. */
+     *  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. */
     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();
-            const feature = featuresDoc.features.find((f) => f.id === phase.featureId);
+            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();
@@ -919,6 +1158,7 @@ export class PlanStore {
             }
         }
         await this.refreshResume();
+        return cleared ? formatPhaseRef(phase.number, feature?.number) : null;
     }
     // ── Savers ───────────────────────────────────────────────────────────
     async updateProject(updater) {
@@ -927,7 +1167,13 @@ export class PlanStore {
         return updated;
     }
     async updateFeatures(updater) {
-        const updated = await atomicUpdateJson(this.featuresPath(), FeaturesDocumentSchema, (current) => this.normalizeFeaturesDocument(updater(current)).doc);
+        const updated = await this.withFeaturesLock(async () => {
+            await this.migrateLegacy();
+            const current = await this.loadFeatures();
+            const upd = this.normalizeFeaturesDocument(updater(current)).doc;
+            await this.saveFeaturesRaw(upd);
+            return upd;
+        });
         await this.maybeAutoSync();
         return updated;
     }
@@ -943,8 +1189,45 @@ export class PlanStore {
         await this.maybeAutoSync();
     }
     async saveFeatures(features) {
+        await this.withFeaturesLock(async () => {
+            await this.migrateLegacy();
+            await this.saveFeaturesRaw(features);
+        });
+        await this.touchManifest();
+        await this.maybeAutoSync();
+    }
+    /** Per-file write of all features + orphan reconcile. No lock (caller holds withFeaturesLock). */
+    async saveFeaturesRaw(features) {
         const parsed = FeaturesDocumentSchema.parse(this.normalizeFeaturesDocument(features).doc);
-        await atomicWriteJson(this.featuresPath(), parsed);
+        await mkdir(this.featuresDir(), { recursive: true });
+        const wantIds = new Set(parsed.features.map((f) => f.id));
+        for (const feat of parsed.features) {
+            await atomicWriteJson(this.featurePath(feat.id), feat);
+        }
+        // Orphan reconcile: remove feature files no longer in the document.
+        try {
+            const files = await readdir(this.featuresDir());
+            for (const f of files) {
+                if (!f.endsWith(".json"))
+                    continue;
+                const id = f.replace(/\.json$/, "");
+                if (!wantIds.has(id)) {
+                    await unlink(this.featurePath(id)).catch(() => { });
+                }
+            }
+        }
+        catch {
+            // dir absent — nothing to reconcile
+        }
+    }
+    /** Granular single-feature write (per-file lock; parallel-safe across features). */
+    async saveFeature(feature) {
+        await this.withFeaturesLock(async () => {
+            await this.migrateLegacy();
+            await mkdir(this.featuresDir(), { recursive: true });
+            const parsed = FeatureSchema.parse(feature);
+            await atomicWriteJson(this.featurePath(parsed.id), parsed);
+        });
         await this.touchManifest();
         await this.maybeAutoSync();
     }
@@ -968,6 +1251,45 @@ export class PlanStore {
         await this.maybeAutoSync();
         return updated;
     }
+    // ── Phase-scoped handoff (entity field, harness-agnostic) ────────────
+    /** Get the handoff text for a phase ("" if none). Throws if phase missing. */
+    async getPhaseHandoff(phaseId) {
+        return (await this.loadPhase(phaseId)).handoff;
+    }
+    /** Set the handoff text for a phase + stamp handoffUpdatedAt. Atomic per-file
+     *  update via updatePhase (so the web UI refreshes via maybeAutoSync). */
+    async setPhaseHandoff(phaseId, text) {
+        const now = new Date().toISOString();
+        await this.updatePhase(phaseId, (phase) => ({ ...phase, handoff: text, handoffUpdatedAt: now }));
+    }
+    /** Clear the handoff text for a phase (handoff=""). handoffUpdatedAt is left
+     *  unchanged as an audit trail (when a handoff last existed). */
+    async clearPhaseHandoff(phaseId) {
+        await this.updatePhase(phaseId, (phase) => ({ ...phase, handoff: "" }));
+    }
+    /** 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. */
+    async listHandoffs() {
+        const phases = await this.loadAllPhases();
+        const features = await this.loadFeatures();
+        const featureNumber = new Map();
+        for (const f of features.features)
+            featureNumber.set(f.id, f.number);
+        const out = [];
+        for (const p of phases) {
+            if (!p.handoff)
+                continue;
+            const fnum = p.featureId ? featureNumber.get(p.featureId) : undefined;
+            out.push({
+                phaseId: p.id,
+                compositeRef: formatPhaseRef(p.number, fnum),
+                updatedAt: p.handoffUpdatedAt || p.updatedAt,
+                firstLine: handoffFirstLine(p.handoff),
+            });
+        }
+        out.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+        return out;
+    }
     async deletePhase(phaseId) {
         try {
             await unlink(this.phasePath(phaseId));

package/dist/refs.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Harness-agnostic reference resolution for planner entities.
+ *
+ * Used by adapters (pi-adapter, plan-mcp) and any future harness to resolve a
+ * human-facing ref to a concrete entity. Kept in @agent-plan/core so every
+ * adapter shares the exact same resolution semantics.
+ *
+ * Supported phase refs (case-insensitive):
+ *   - UUID:   "bd6ed366-..."          -> phase.id
+ *   - Short:  "P001" | "p1"          -> phase.number (globally unique)
+ *   - Compos: "P002(F001)"           -> phase.number with parent feature validation
+ *   - Title:  exact match, then includes (backward-compat fallback)
+ */
+import type { Phase, Feature } from "./schema.js";
+/**
+ * Resolve a phase reference to a Phase. Returns `undefined` when not found or
+ * when a composite (F00x) parent does not match the phase's featureId.
+ *
+ * @param phases  all phases (st.loadAllPhases())
+ * @param features all features (st.loadAllFeatures() / loadFeatures())
+ * @param ref     the human-facing ref (P00x / P00x(F00x) / UUID / title)
+ */
+export declare function findPhaseByRef(phases: Phase[], features: Feature[], ref: string): Phase | undefined;
+//# sourceMappingURL=refs.d.ts.map

package/dist/refs.d.ts.map

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

package/dist/refs.js

@@ -0,0 +1,37 @@
+// P00x  or  P00x(F00x)  — accept 1+ digits so "p1" == "p001".
+const PHASE_REF_RE = /^p(\d+)(?:\(f(\d+)\))?$/;
+/**
+ * Resolve a phase reference to a Phase. Returns `undefined` when not found or
+ * when a composite (F00x) parent does not match the phase's featureId.
+ *
+ * @param phases  all phases (st.loadAllPhases())
+ * @param features all features (st.loadAllFeatures() / loadFeatures())
+ * @param ref     the human-facing ref (P00x / P00x(F00x) / UUID / title)
+ */
+export function findPhaseByRef(phases, features, ref) {
+    const normalized = ref.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    // 1. UUID (exact)
+    let found = phases.find((p) => p.id.toLowerCase() === normalized);
+    if (found)
+        return found;
+    // 2. Composite / short ref: P00x or P00x(F00x)
+    const m = normalized.match(PHASE_REF_RE);
+    if (m) {
+        const phaseNum = parseInt(m[1], 10);
+        found = phases.find((p) => p.number === phaseNum);
+        if (found && m[2]) {
+            // validate parent feature when the (F00x) disambiguator is present
+            const featureNum = parseInt(m[2], 10);
+            const feat = features.find((f) => f.number === featureNum);
+            if (!feat || found.featureId !== feat.id)
+                return undefined;
+        }
+        if (found)
+            return found;
+    }
+    // 3. 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

@@ -442,6 +442,8 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
     phaseId: z.ZodString;
     number: z.ZodDefault<z.ZodNumber>;
+    shortId: z.ZodDefault<z.ZodString>;
+    priority: z.ZodDefault<z.ZodNumber>;
     shortName: z.ZodString;
     title: z.ZodString;
     status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
@@ -551,6 +553,8 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         acceptedAt: string;
     }[];
     phaseId: string;
+    shortId: string;
+    priority: number;
     shortName: string;
     statusLog: {
         id: string;
@@ -596,6 +600,8 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         rationale?: string | undefined;
         implementationNotes?: string | undefined;
     }[] | undefined;
+    shortId?: string | undefined;
+    priority?: number | undefined;
     statusLog?: {
         id: string;
         date: string;
@@ -644,6 +650,8 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         acceptedAt: string;
     }[];
     phaseId: string;
+    shortId: string;
+    priority: number;
     shortName: string;
     statusLog: {
         id: string;
@@ -684,6 +692,8 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         rationale?: string | undefined;
         implementationNotes?: string | undefined;
     }[] | undefined;
+    shortId?: string | undefined;
+    priority?: number | undefined;
     statusLog?: {
         id: string;
         date: string;
@@ -713,6 +723,8 @@ export declare const PhaseSchema: z.ZodObject<{
     id: z.ZodString;
     featureId: z.ZodOptional<z.ZodString>;
     number: z.ZodNumber;
+    shortId: z.ZodDefault<z.ZodString>;
+    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"]>;
@@ -757,6 +769,8 @@ export declare const PhaseSchema: z.ZodObject<{
         id: z.ZodString;
         phaseId: z.ZodString;
         number: z.ZodDefault<z.ZodNumber>;
+        shortId: z.ZodDefault<z.ZodString>;
+        priority: z.ZodDefault<z.ZodNumber>;
         shortName: z.ZodString;
         title: z.ZodString;
         status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
@@ -866,6 +880,8 @@ export declare const PhaseSchema: z.ZodObject<{
             acceptedAt: string;
         }[];
         phaseId: string;
+        shortId: string;
+        priority: number;
         shortName: string;
         statusLog: {
             id: string;
@@ -911,6 +927,8 @@ export declare const PhaseSchema: z.ZodObject<{
             rationale?: string | undefined;
             implementationNotes?: string | undefined;
         }[] | undefined;
+        shortId?: string | undefined;
+        priority?: number | undefined;
         statusLog?: {
             id: string;
             date: string;
@@ -959,6 +977,8 @@ export declare const PhaseSchema: z.ZodObject<{
             acceptedAt: string;
         }[];
         phaseId: string;
+        shortId: string;
+        priority: number;
         shortName: string;
         statusLog: {
             id: string;
@@ -999,6 +1019,8 @@ export declare const PhaseSchema: z.ZodObject<{
             rationale?: string | undefined;
             implementationNotes?: string | undefined;
         }[] | undefined;
+        shortId?: string | undefined;
+        priority?: number | undefined;
         statusLog?: {
             id: string;
             date: string;
@@ -1026,6 +1048,8 @@ export declare const PhaseSchema: z.ZodObject<{
     }>, "many">>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
+    handoff: z.ZodDefault<z.ZodString>;
+    handoffUpdatedAt: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     number: number;
     status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
@@ -1046,6 +1070,8 @@ export declare const PhaseSchema: z.ZodObject<{
         implementationNotes: string;
         acceptedAt: string;
     }[];
+    shortId: string;
+    priority: number;
     dependsOn: string[];
     slug: string;
     discussedAt: string;
@@ -1081,6 +1107,8 @@ export declare const PhaseSchema: z.ZodObject<{
             acceptedAt: string;
         }[];
         phaseId: string;
+        shortId: string;
+        priority: number;
         shortName: string;
         statusLog: {
             id: string;
@@ -1102,6 +1130,8 @@ export declare const PhaseSchema: z.ZodObject<{
         startedAt: string;
         completedAt: string;
     }[];
+    handoff: string;
+    handoffUpdatedAt: string;
     featureId?: string | undefined;
 }, {
     number: number;
@@ -1124,6 +1154,8 @@ export declare const PhaseSchema: z.ZodObject<{
         rationale?: string | undefined;
         implementationNotes?: string | undefined;
     }[] | undefined;
+    shortId?: string | undefined;
+    priority?: number | undefined;
     dependsOn?: string[] | undefined;
     featureId?: string | undefined;
     discussedAt?: string | undefined;
@@ -1155,6 +1187,8 @@ export declare const PhaseSchema: z.ZodObject<{
             rationale?: string | undefined;
             implementationNotes?: string | undefined;
         }[] | undefined;
+        shortId?: string | undefined;
+        priority?: number | undefined;
         statusLog?: {
             id: string;
             date: string;
@@ -1180,10 +1214,14 @@ export declare const PhaseSchema: z.ZodObject<{
         startedAt?: string | undefined;
         completedAt?: string | undefined;
     }[] | undefined;
+    handoff?: string | undefined;
+    handoffUpdatedAt?: string | undefined;
 }>;
 export declare const FeatureSchema: z.ZodObject<{
     id: z.ZodString;
     number: z.ZodDefault<z.ZodNumber>;
+    shortId: z.ZodDefault<z.ZodString>;
+    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"]>;
@@ -1236,6 +1274,8 @@ export declare const FeatureSchema: z.ZodObject<{
         implementationNotes: string;
         acceptedAt: string;
     }[];
+    shortId: string;
+    priority: number;
     dependsOn: string[];
     discussedAt: string;
     contextReady: boolean;
@@ -1261,6 +1301,8 @@ export declare const FeatureSchema: z.ZodObject<{
         rationale?: string | undefined;
         implementationNotes?: string | undefined;
     }[] | undefined;
+    shortId?: string | undefined;
+    priority?: number | undefined;
     dependsOn?: string[] | undefined;
     discussedAt?: string | undefined;
     contextReady?: boolean | undefined;
@@ -1275,6 +1317,8 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
     features: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         number: z.ZodDefault<z.ZodNumber>;
+        shortId: z.ZodDefault<z.ZodString>;
+        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"]>;
@@ -1327,6 +1371,8 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
             implementationNotes: string;
             acceptedAt: string;
         }[];
+        shortId: string;
+        priority: number;
         dependsOn: string[];
         discussedAt: string;
         contextReady: boolean;
@@ -1352,6 +1398,8 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
             rationale?: string | undefined;
             implementationNotes?: string | undefined;
         }[] | undefined;
+        shortId?: string | undefined;
+        priority?: number | undefined;
         dependsOn?: string[] | undefined;
         discussedAt?: string | undefined;
         contextReady?: boolean | undefined;
@@ -1379,6 +1427,8 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
             implementationNotes: string;
             acceptedAt: string;
         }[];
+        shortId: string;
+        priority: number;
         dependsOn: string[];
         discussedAt: string;
         contextReady: boolean;
@@ -1406,6 +1456,8 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
             rationale?: string | undefined;
             implementationNotes?: string | undefined;
         }[] | undefined;
+        shortId?: string | undefined;
+        priority?: number | undefined;
         dependsOn?: string[] | undefined;
         discussedAt?: string | undefined;
         contextReady?: boolean | undefined;
@@ -1728,6 +1780,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         features: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             number: z.ZodDefault<z.ZodNumber>;
+            shortId: z.ZodDefault<z.ZodString>;
+            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"]>;
@@ -1780,6 +1834,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 implementationNotes: string;
                 acceptedAt: string;
             }[];
+            shortId: string;
+            priority: number;
             dependsOn: string[];
             discussedAt: string;
             contextReady: boolean;
@@ -1805,6 +1861,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 rationale?: string | undefined;
                 implementationNotes?: string | undefined;
             }[] | undefined;
+            shortId?: string | undefined;
+            priority?: number | undefined;
             dependsOn?: string[] | undefined;
             discussedAt?: string | undefined;
             contextReady?: boolean | undefined;
@@ -1832,6 +1890,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 implementationNotes: string;
                 acceptedAt: string;
             }[];
+            shortId: string;
+            priority: number;
             dependsOn: string[];
             discussedAt: string;
             contextReady: boolean;
@@ -1859,6 +1919,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 rationale?: string | undefined;
                 implementationNotes?: string | undefined;
             }[] | undefined;
+            shortId?: string | undefined;
+            priority?: number | undefined;
             dependsOn?: string[] | undefined;
             discussedAt?: string | undefined;
             contextReady?: boolean | undefined;
@@ -1975,6 +2037,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         id: z.ZodString;
         featureId: z.ZodOptional<z.ZodString>;
         number: z.ZodNumber;
+        shortId: z.ZodDefault<z.ZodString>;
+        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"]>;
@@ -2019,6 +2083,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             id: z.ZodString;
             phaseId: z.ZodString;
             number: z.ZodDefault<z.ZodNumber>;
+            shortId: z.ZodDefault<z.ZodString>;
+            priority: z.ZodDefault<z.ZodNumber>;
             shortName: z.ZodString;
             title: z.ZodString;
             status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
@@ -2128,6 +2194,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 acceptedAt: string;
             }[];
             phaseId: string;
+            shortId: string;
+            priority: number;
             shortName: string;
             statusLog: {
                 id: string;
@@ -2173,6 +2241,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 rationale?: string | undefined;
                 implementationNotes?: string | undefined;
             }[] | undefined;
+            shortId?: string | undefined;
+            priority?: number | undefined;
             statusLog?: {
                 id: string;
                 date: string;
@@ -2221,6 +2291,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 acceptedAt: string;
             }[];
             phaseId: string;
+            shortId: string;
+            priority: number;
             shortName: string;
             statusLog: {
                 id: string;
@@ -2261,6 +2333,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 rationale?: string | undefined;
                 implementationNotes?: string | undefined;
             }[] | undefined;
+            shortId?: string | undefined;
+            priority?: number | undefined;
             statusLog?: {
                 id: string;
                 date: string;
@@ -2288,6 +2362,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }>, "many">>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
+        handoff: z.ZodDefault<z.ZodString>;
+        handoffUpdatedAt: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         number: number;
         status: "planned" | "in-progress" | "done" | "blocked" | "canceled" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
@@ -2308,6 +2384,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             implementationNotes: string;
             acceptedAt: string;
         }[];
+        shortId: string;
+        priority: number;
         dependsOn: string[];
         slug: string;
         discussedAt: string;
@@ -2343,6 +2421,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 acceptedAt: string;
             }[];
             phaseId: string;
+            shortId: string;
+            priority: number;
             shortName: string;
             statusLog: {
                 id: string;
@@ -2364,6 +2444,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             startedAt: string;
             completedAt: string;
         }[];
+        handoff: string;
+        handoffUpdatedAt: string;
         featureId?: string | undefined;
     }, {
         number: number;
@@ -2386,6 +2468,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             rationale?: string | undefined;
             implementationNotes?: string | undefined;
         }[] | undefined;
+        shortId?: string | undefined;
+        priority?: number | undefined;
         dependsOn?: string[] | undefined;
         featureId?: string | undefined;
         discussedAt?: string | undefined;
@@ -2417,6 +2501,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 rationale?: string | undefined;
                 implementationNotes?: string | undefined;
             }[] | undefined;
+            shortId?: string | undefined;
+            priority?: number | undefined;
             statusLog?: {
                 id: string;
                 date: string;
@@ -2442,6 +2528,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             startedAt?: string | undefined;
             completedAt?: string | undefined;
         }[] | undefined;
+        handoff?: string | undefined;
+        handoffUpdatedAt?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     features: {
@@ -2461,6 +2549,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 implementationNotes: string;
                 acceptedAt: string;
             }[];
+            shortId: string;
+            priority: number;
             dependsOn: string[];
             discussedAt: string;
             contextReady: boolean;
@@ -2545,6 +2635,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             implementationNotes: string;
             acceptedAt: string;
         }[];
+        shortId: string;
+        priority: number;
         dependsOn: string[];
         slug: string;
         discussedAt: string;
@@ -2580,6 +2672,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 acceptedAt: string;
             }[];
             phaseId: string;
+            shortId: string;
+            priority: number;
             shortName: string;
             statusLog: {
                 id: string;
@@ -2601,6 +2695,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             startedAt: string;
             completedAt: string;
         }[];
+        handoff: string;
+        handoffUpdatedAt: string;
         featureId?: string | undefined;
     }[];
 }, {
@@ -2621,6 +2717,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 rationale?: string | undefined;
                 implementationNotes?: string | undefined;
             }[] | undefined;
+            shortId?: string | undefined;
+            priority?: number | undefined;
             dependsOn?: string[] | undefined;
             discussedAt?: string | undefined;
             contextReady?: boolean | undefined;
@@ -2706,6 +2804,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             rationale?: string | undefined;
             implementationNotes?: string | undefined;
         }[] | undefined;
+        shortId?: string | undefined;
+        priority?: number | undefined;
         dependsOn?: string[] | undefined;
         featureId?: string | undefined;
         discussedAt?: string | undefined;
@@ -2737,6 +2837,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 rationale?: string | undefined;
                 implementationNotes?: string | undefined;
             }[] | undefined;
+            shortId?: string | undefined;
+            priority?: number | undefined;
             statusLog?: {
                 id: string;
                 date: string;
@@ -2762,6 +2864,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             startedAt?: string | undefined;
             completedAt?: string | undefined;
         }[] | undefined;
+        handoff?: string | undefined;
+        handoffUpdatedAt?: string | undefined;
     }[];
 }>;
 export type Timestamp = z.infer<typeof TimestampSchema>;

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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iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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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

@@ -138,6 +138,8 @@ export const TaskSchema = z.object({
     id: z.string(),
     phaseId: z.string(),
     number: z.number().int().nonnegative().default(0),
+    shortId: z.string().regex(/^(|[A-Z2-9]{5})$/).default(""),
+    priority: z.number().int().nonnegative().default(0),
     shortName: SlugSchema,
     title: z.string().min(1),
     status: TaskStatusSchema,
@@ -165,6 +167,8 @@ export const PhaseSchema = z.object({
     id: z.string(),
     featureId: z.string().optional(),
     number: z.number().int().positive(),
+    shortId: z.string().regex(/^(|[A-Z2-9]{5})$/).default(""),
+    priority: z.number().int().nonnegative().default(0),
     slug: SlugSchema,
     title: z.string().min(1),
     status: PhaseStatusSchema,
@@ -187,10 +191,14 @@ export const PhaseSchema = z.object({
     tasks: z.array(TaskSchema).default([]),
     createdAt: TimestampSchema,
     updatedAt: TimestampSchema,
+    handoff: z.string().default(""),
+    handoffUpdatedAt: z.string().default(""),
 });
 export const FeatureSchema = z.object({
     id: z.string(),
     number: z.number().int().nonnegative().default(0),
+    shortId: z.string().regex(/^(|[A-Z2-9]{5})$/).default(""),
+    priority: z.number().int().nonnegative().default(0),
     name: z.string().min(1),
     description: z.string().default(""),
     status: FeatureStatusSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-plan/core",
-  "version": "0.2.18",
+  "version": "0.2.19-next.0",
   "private": false,
   "description": "Harness-agnostic core for Agent Plan: schemas, persistence, ordering, status rollups, and markdown rendering.",
   "license": "MIT",
@@ -42,6 +42,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "check": "tsc -p tsconfig.json --noEmit"
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json && node --test \"test/**/*.test.mjs\""
   }
 }