@papi-ai/adapter-md 0.1.0-alpha → 0.1.1-alpha

package/dist/index.d.ts

@@ -1,24 +1,7 @@
-import { TaskStatus as TaskStatus$1, TaskPriority as TaskPriority$1, EffortSize as EffortSize$1, ReviewStage as ReviewStage$1, ReviewVerdict as ReviewVerdict$1, TaskComplexity as TaskComplexity$1, TaskType as TaskType$1, isValidStatus as isValidStatus$1, isValidTransition as isValidTransition$1, validateTransition as validateTransition$1 } from '@papi-ai/shared';
+import { TaskStatus as TaskStatus$1, TaskPriority as TaskPriority$1, EffortSize as EffortSize$1, TaskComplexity as TaskComplexity$1, TaskType as TaskType$1, ReviewStage as ReviewStage$1, ReviewVerdict as ReviewVerdict$1, isValidStatus as isValidStatus$1, isValidTransition as isValidTransition$1, validateTransition as validateTransition$1 } from '@papi-ai/shared';
 
 /** Valid phase statuses in the product brief. */
 type PhaseStatus = 'Not Started' | 'In Progress' | 'Done' | 'Deferred';
-/** Feature lifecycle status. */
-type FeatureStatus = 'Not Started' | 'In Progress' | 'Done' | 'Deferred';
-/** A workstream or capability being built. Replaces Phase as the primary planning construct (AD-23). */
-interface Feature {
-    id: string;
-    displayId: string;
-    slug: string;
-    name: string;
-    description: string;
-    status: FeatureStatus;
-    roadmapPosition: number;
-    createdAt: string;
-    completedAt?: string;
-    commitDate?: string;
-    createdSprint: number;
-    completedSprint?: number;
-}
 /** A development phase defined in the product brief. */
 interface Phase {
     id: string;
@@ -27,21 +10,52 @@ interface Phase {
     description: string;
     status: PhaseStatus;
     order: number;
+    /** The stage this phase belongs to (AD-14 hierarchy). */
+    stageId?: string;
+}
+/** Horizon status in the project hierarchy (AD-14). */
+type HorizonStatus = 'active' | 'completed' | 'deferred';
+/** A horizon — the highest level of the project hierarchy (AD-14: Horizon → Stage → Phase → Task). */
+interface Horizon {
+    id: string;
+    slug: string;
+    label: string;
+    description?: string;
+    status: HorizonStatus;
+    sortOrder: number;
+    projectId: string;
+    createdAt: string;
+    updatedAt: string;
 }
-/** Sprint lifecycle status. */
-type SprintStatus = 'planning' | 'active' | 'complete';
-/** A sprint entity giving sprints first-class identity. */
-/** Per-section SHA-256 hashes for context diff optimisation between sprints. */
+/** Stage status in the project hierarchy (AD-14). */
+type StageStatus = 'active' | 'completed' | 'deferred';
+/** A stage — sits between Horizon and Phase in the hierarchy (AD-14: Horizon → Stage → Phase → Task). */
+interface Stage {
+    id: string;
+    slug: string;
+    label: string;
+    description?: string;
+    status: StageStatus;
+    sortOrder: number;
+    horizonId: string;
+    projectId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Cycle lifecycle status (renamed from CycleStatus per AD-14). */
+type CycleStatus = 'planning' | 'active' | 'complete';
+/** Per-section SHA-256 hashes for context diff optimisation between cycles. */
 interface ContextHashes {
     productBrief?: string;
     activeDecisions?: string;
     reviews?: string;
     [key: string]: string | undefined;
 }
-interface Sprint {
+/** A cycle entity — the methodology loop (renamed from Cycle per AD-14). */
+interface Cycle {
     id: string;
     number: number;
-    status: SprintStatus;
+    status: CycleStatus;
     startDate: string;
     endDate?: string;
     goals: string[];
@@ -63,7 +77,7 @@ declare const validateTransition: typeof validateTransition$1;
 declare const isValidStatus: typeof isValidStatus$1;
 /**
  * Context tiers control which tasks the planner sees:
- *   Tier 1 (Sprint-eligible): Bug, Task — fed to planner for scheduling
+ *   Tier 1 (Cycle-eligible): Bug, Task — fed to planner for scheduling
  *   Tier 2 (Plannable): Research — scheduled but output is knowledge not code
  *   Tier 3 (Pre-triage): Idea, Feedback — invisible to planner until promoted
  */
@@ -83,7 +97,7 @@ interface DecisionEvent {
     id: string;
     decisionId: string;
     eventType: DecisionEventType;
-    sprint: number;
+    cycle: number;
     source: DecisionEventSource;
     sourceRef?: string;
     detail?: string;
@@ -93,7 +107,7 @@ interface DecisionEvent {
 interface DecisionScore {
     id: string;
     decisionId: string;
-    sprint: number;
+    cycle: number;
     effort: number;
     risk: number;
     reversibility: number;
@@ -103,11 +117,11 @@ interface DecisionScore {
     rationale?: string;
     createdAt: string;
 }
-/** Sprint health metadata from PLANNING_LOG.md header. */
-interface SprintHealth {
-    totalSprints: number;
-    latestSprintStatus?: string;
-    sprintsSinceLastStrategyReview: number;
+/** Cycle health metadata from PLANNING_LOG.md header. */
+interface CycleHealth {
+    totalCycles: number;
+    latestCycleStatus?: string;
+    cyclesSinceLastStrategyReview: number;
     strategyReviewDue: string;
     boardHealth: string;
     strategicDirection: string;
@@ -122,14 +136,16 @@ interface ActiveDecision {
     confidence: Confidence;
     superseded: boolean;
     supersededBy?: string;
-    createdSprint?: number;
-    modifiedSprint?: number;
+    createdCycle?: number;
+    modifiedCycle?: number;
     body: string;
+    outcome?: 'pending' | 'validated' | 'revised' | 'abandoned' | 'superseded';
+    revisionCount?: number;
 }
-/** A single sprint entry in the planning log. */
-interface SprintLogEntry {
+/** A single cycle entry in the planning log. */
+interface CycleLogEntry {
     uuid: string;
-    sprintNumber: number;
+    cycleNumber: number;
     title: string;
     content: string;
     carryForward?: string;
@@ -137,31 +153,47 @@ interface SprintLogEntry {
 }
 /** A strategy review entry stored in its own table (not planning_log_entries). */
 interface StrategyReviewEntry {
-    sprintNumber: number;
-    sprintRange?: string;
+    cycleNumber: number;
+    cycleRange?: string;
     title: string;
     content: string;
     notes?: string;
     boardHealth?: string;
     strategicDirection?: string;
     recommendations?: unknown;
+    fullAnalysis?: string;
+    velocityAssessment?: string;
+    /** Full ReviewStructuredOutput from the strategy review LLM, stored as JSONB for dashboard querying */
+    structuredData?: Record<string, unknown>;
+    createdAt?: string;
+}
+/** A dogfood observation captured during strategy reviews or releases. */
+interface DogfoodEntry {
+    id?: string;
+    projectId?: string;
+    cycleNumber: number;
+    category: 'friction' | 'methodology' | 'signal' | 'commercial';
+    content: string;
+    sourceTool?: string;
+    status?: 'observed' | 'backlog-created' | 'resolved';
+    linkedTaskId?: string;
     createdAt?: string;
 }
 /** Full parsed contents of PLANNING_LOG.md. */
 interface PlanningLog {
-    sprintHealth: SprintHealth;
+    cycleHealth: CycleHealth;
     northStar: string;
     activeDecisions: ActiveDecision[];
     deferred: string[];
-    sprintLog: SprintLogEntry[];
+    cycleLog: CycleLogEntry[];
 }
 /** A single state transition entry recording when a task changed status. */
 interface StateTransition {
     status: TaskStatus;
     timestamp: string;
 }
-/** A task on the sprint board (parsed from SPRINT_BOARD.md YAML). */
-interface SprintTask {
+/** A task on the board (parsed from CYCLE_BOARD.md YAML). */
+interface CycleTask {
     uuid: string;
     id: string;
     displayId: string;
@@ -170,12 +202,15 @@ interface SprintTask {
     priority: TaskPriority;
     complexity: TaskComplexity;
     module: string;
-    epic: string;
+    /** @deprecated (AD-14): Use phase + stageId instead. Will be removed after taxonomy migration. */
+    epic?: string;
     phase: string;
+    /** Stage FK for AD-14 hierarchy (Horizon → Stage → Phase → Task). */
+    stageId?: string;
     owner: string;
     reviewed: boolean;
-    sprint?: number;
-    createdSprint?: number;
+    cycle?: number;
+    createdCycle?: number;
     createdAt?: string;
     why?: string;
     dependsOn?: string;
@@ -187,6 +222,19 @@ interface SprintTask {
     taskType?: TaskType;
     maturity?: TaskMaturity;
 }
+/** Structured handoff accuracy — replaces coarse scope_accuracy text. */
+interface HandoffAccuracy {
+    scopeMatch: boolean;
+    filesMatch: 'exact' | 'partial' | 'missed';
+    effortMatch: boolean;
+    notes?: string;
+}
+/** Brief implications from a build — discovery learnings that feed back into planning. */
+interface BriefImplication {
+    canvasSection: 'landscape' | 'journeys' | 'mvpBoundary' | 'assumptions' | 'successSignals';
+    type: 'confirm' | 'contradict' | 'new';
+    detail: string;
+}
 /** A build report entry from BUILD_REPORTS.md. */
 interface BuildReport {
     uuid: string;
@@ -195,7 +243,7 @@ interface BuildReport {
     taskId: string;
     taskName: string;
     date: string;
-    sprint: number;
+    cycle: number;
     completed: 'Yes' | 'No' | 'Partial';
     actualEffort: EffortSize;
     estimatedEffort: EffortSize;
@@ -206,6 +254,27 @@ interface BuildReport {
     commitSha?: string;
     filesChanged?: string[];
     relatedDecisions?: string[];
+    handoffAccuracy?: HandoffAccuracy;
+    correctionsCount?: number;
+    briefImplications?: BriefImplication[];
+    deadEnds?: string;
+}
+/** Aggregated recommendation effectiveness row from v_recommendation_effectiveness. */
+interface RecommendationEffectivenessRow {
+    type: string;
+    total: number;
+    actioned: number;
+    dismissed: number;
+    pending: number;
+    acceptanceRate: string;
+    avgCyclesToAction: string | null;
+}
+/** Aggregated estimation calibration row from v_estimation_accuracy. */
+interface EstimationCalibrationRow {
+    estimatedEffort: string;
+    actualEffort: string;
+    accuracyLabel: string;
+    count: number;
 }
 /** A single tool call metric entry from METRICS.md. */
 interface ToolCallMetric {
@@ -216,8 +285,8 @@ interface ToolCallMetric {
     outputTokens?: number;
     estimatedCostUsd?: number;
     model?: string;
-    /** Sprint number when this metric was recorded. Absent on legacy rows. */
-    sprintNumber?: number;
+    /** Cycle number when this metric was recorded. Absent on legacy rows. */
+    cycleNumber?: number;
     /** Context size in bytes for plan tool calls. Absent on non-plan tools. */
     contextBytes?: number;
     /** Context utilisation ratio (0.0–1.0). Fraction of input entities referenced in output. */
@@ -241,8 +310,32 @@ interface CostSummary {
     avgCostPerCall: number;
 }
 /** A cost snapshot persisted in the Cost Summary section of METRICS.md. */
+/** Discovery canvas — progressive discovery sections on product brief. */
+interface DiscoveryCanvas {
+    landscapeReferences?: {
+        name: string;
+        url?: string;
+        notes?: string;
+    }[];
+    userJourneys?: {
+        persona: string;
+        journey: string;
+        priority?: string;
+    }[];
+    mvpBoundary?: string;
+    assumptionsOpenQuestions?: {
+        text: string;
+        status: string;
+        evidence?: string;
+    }[];
+    successSignals?: {
+        signal: string;
+        metric?: string;
+        target?: string;
+    }[];
+}
 interface CostSnapshot {
-    sprint: number;
+    cycle: number;
     date: string;
     totalCostUsd: number;
     totalInputTokens: number;
@@ -268,7 +361,7 @@ type TextClusterer = (entries: ClusterEntry[]) => Promise<ClusterResult[]>;
 interface RecurringSurprise {
     text: string;
     count: number;
-    sprints: number[];
+    cycles: number[];
 }
 /** Build pattern detection results from analyzing recent build reports. */
 interface BuildPatterns {
@@ -278,28 +371,28 @@ interface BuildPatterns {
     scopeAccuracyBreakdown: Record<string, number>;
     untriagedIssues: string[];
 }
-/** Per-sprint estimation accuracy stats. */
-interface SprintEstimationAccuracy {
-    sprint: number;
+/** Per-cycle estimation accuracy stats. */
+interface CycleEstimationAccuracy {
+    cycle: number;
     reports: number;
     matchRate: number;
     mae: number;
     bias: number;
 }
-/** Per-sprint velocity stats. */
-interface SprintVelocity {
-    sprint: number;
+/** Per-cycle velocity stats. */
+interface CycleVelocity {
+    cycle: number;
     completed: number;
     partial: number;
     failed: number;
     effortPoints: number;
 }
-/** A sprint methodology metrics snapshot stored in SPRINT_METRICS.md. */
-interface SprintMetricsSnapshot {
-    sprint: number;
+/** A cycle methodology metrics snapshot stored in CYCLE_METRICS.md. */
+interface CycleMetricsSnapshot {
+    cycle: number;
     date: string;
-    accuracy: SprintEstimationAccuracy[];
-    velocity: SprintVelocity[];
+    accuracy: CycleEstimationAccuracy[];
+    velocity: CycleVelocity[];
 }
 /** A recurring feedback theme detected across human reviews. */
 interface RecurringFeedback {
@@ -313,6 +406,21 @@ interface ReviewPatterns {
     verdictBreakdown: Record<string, number>;
     requestChangesRate: number;
 }
+/** Auto-review verdict from automated code review. */
+type AutoReviewVerdict = 'pass' | 'warn' | 'fail';
+/** A single finding from an automated code review. */
+interface AutoReviewFinding {
+    severity: 'error' | 'warning' | 'info';
+    file?: string;
+    line?: number;
+    message: string;
+}
+/** Automated code review results — supplements human review. */
+interface AutoReview {
+    verdict: AutoReviewVerdict;
+    findings: AutoReviewFinding[];
+    summary: string;
+}
 /** A human review entry stored in REVIEWS.md. */
 interface HumanReview {
     uuid: string;
@@ -321,11 +429,13 @@ interface HumanReview {
     stage: ReviewStage;
     reviewer: string;
     verdict: ReviewVerdict;
-    sprint: number;
+    cycle: number;
     date: string;
     comments: string;
     handoffRevision?: number;
     buildCommitSha?: string;
+    /** Optional automated code review results attached to this review. */
+    autoReview?: AutoReview;
 }
 /** A structured BUILD HANDOFF parsed from the markdown handoff block. */
 interface BuildHandoff {
@@ -334,7 +444,7 @@ interface BuildHandoff {
     createdAt?: string;
     taskId: string;
     taskTitle: string;
-    sprint: number;
+    cycle: number;
     whyNow: string;
     scope: string[];
     scopeBoundary: string[];
@@ -358,8 +468,9 @@ interface StrategyRecommendation {
     type: RecommendationType;
     status: RecommendationStatus;
     content: string;
-    createdSprint: number;
-    actionedSprint?: number;
+    createdCycle: number;
+    actionedCycle?: number;
+    target?: string;
 }
 /** Entity reference — tracks which decisions/entities are used in tool calls. */
 interface EntityReference {
@@ -368,22 +479,30 @@ interface EntityReference {
     entityId: string;
     referenceContext: 'plan_input' | 'plan_output' | 'strategy_input' | 'strategy_output';
     toolName: string;
-    sprintNumber: number;
+    cycleNumber: number;
     createdAt: string;
 }
+/** Per-tool context utilisation summary from v_context_utilisation. */
+interface ContextUtilisationSummary {
+    tool: string;
+    cycleNumber: number;
+    callCount: number;
+    avgUtilisation: number;
+    avgContextBytes: number;
+}
 /** Per-AD usage summary returned by getDecisionUsage. */
 interface DecisionUsageSummary {
     decisionId: string;
     referenceCount: number;
-    lastReferencedSprint: number;
-    sprintsSinceLastReference: number;
+    lastReferencedCycle: number;
+    cyclesSinceLastReference: number;
 }
 /** Options for updateTask to control validation behaviour. */
 interface UpdateTaskOptions {
     /** Skip state-machine transition validation when true. */
     force?: boolean;
 }
-/** Filter options for querying the sprint board. */
+/** Filter options for querying the cycle board. */
 interface BoardQueryOptions {
     status?: TaskStatus[];
     priority?: TaskPriority[];
@@ -391,31 +510,39 @@ interface BoardQueryOptions {
     reviewed?: boolean;
     module?: string;
     epic?: string;
-    /** Filter by context tier (1=sprint-eligible, 2=plannable, 3=pre-triage). */
+    /** Filter by context tier (1=cycle-eligible, 2=plannable, 3=pre-triage). */
     contextTier?: ContextTier;
+    /** Filter to tasks assigned to this cycle or later (cycle >= N). */
+    cycleSince?: number;
 }
 /** Core adapter interface for reading/writing .papi/ markdown files. */
 interface PapiAdapter {
     readPlanningLog(): Promise<PlanningLog>;
-    getSprintHealth(): Promise<SprintHealth>;
+    getCycleHealth(): Promise<CycleHealth>;
     getActiveDecisions(): Promise<ActiveDecision[]>;
-    getSprintLog(limit?: number): Promise<SprintLogEntry[]>;
-    getSprintLogSince(sprintNumber: number): Promise<SprintLogEntry[]>;
-    setSprintHealth(updates: Partial<SprintHealth>): Promise<void>;
-    writeSprintLogEntry(entry: SprintLogEntry): Promise<void>;
-    updateActiveDecision(id: string, body: string, sprintNumber?: number): Promise<void>;
-    queryBoard(options?: BoardQueryOptions): Promise<SprintTask[]>;
-    getTask(id: string): Promise<SprintTask | null>;
-    getTasks(ids: string[]): Promise<SprintTask[]>;
-    createTask(task: Omit<SprintTask, 'id'>): Promise<SprintTask>;
-    updateTask(id: string, updates: Partial<Omit<SprintTask, 'id'>>, options?: UpdateTaskOptions): Promise<void>;
+    getCycleLog(limit?: number): Promise<CycleLogEntry[]>;
+    getCycleLogSince(cycleNumber: number): Promise<CycleLogEntry[]>;
+    setCycleHealth(updates: Partial<CycleHealth>): Promise<void>;
+    writeCycleLogEntry(entry: CycleLogEntry): Promise<void>;
+    updateActiveDecision(id: string, body: string, cycleNumber?: number): Promise<void>;
+    /** Upsert an AD — creates if display_id doesn't exist, updates if it does. */
+    upsertActiveDecision?(id: string, body: string, title: string, confidence: string, cycleNumber: number): Promise<void>;
+    /** Delete an AD permanently by display_id. */
+    deleteActiveDecision?(id: string): Promise<void>;
+    queryBoard(options?: BoardQueryOptions): Promise<CycleTask[]>;
+    getTask(id: string): Promise<CycleTask | null>;
+    getTasks(ids: string[]): Promise<CycleTask[]>;
+    createTask(task: Omit<CycleTask, 'id'>): Promise<CycleTask>;
+    updateTask(id: string, updates: Partial<Omit<CycleTask, 'id'>>, options?: UpdateTaskOptions): Promise<void>;
     updateTaskStatus(id: string, status: TaskStatus): Promise<void>;
+    /** Record a task status transition for audit trail. */
+    recordTransition(taskId: string, fromStatus: string, toStatus: string, changedBy?: string): Promise<void>;
     appendBuildReport(report: BuildReport): Promise<void>;
     getRecentBuildReports(count: number): Promise<BuildReport[]>;
-    getBuildReportsSince(sprintNumber: number): Promise<BuildReport[]>;
+    getBuildReportsSince(cycleNumber: number): Promise<BuildReport[]>;
     getRecentReviews(count?: number): Promise<HumanReview[]>;
     writeReview(review: HumanReview): Promise<void>;
-    compressSprintLog(threshold: number, summary: string): Promise<void>;
+    compressCycleLog(threshold: number, summary: string): Promise<void>;
     compressBuildReports(threshold: number, summary: string): Promise<void>;
     archiveTasks(phases: string[], statuses?: string[]): Promise<{
         archivedCount: number;
@@ -423,38 +550,97 @@ interface PapiAdapter {
     }>;
     readProductBrief(): Promise<string>;
     updateProductBrief(content: string): Promise<void>;
+    /** Read discovery canvas sections from product brief. */
+    readDiscoveryCanvas(): Promise<DiscoveryCanvas>;
+    /** Update discovery canvas sections on product brief. */
+    updateDiscoveryCanvas(canvas: Partial<DiscoveryCanvas>): Promise<void>;
     readPhases(): Promise<Phase[]>;
     writePhases(phases: Phase[]): Promise<void>;
-    readFeatures(): Promise<Feature[]>;
-    getFeature(id: string): Promise<Feature | null>;
-    createFeature(feature: Omit<Feature, 'id'>): Promise<Feature>;
-    updateFeature(id: string, updates: Partial<Omit<Feature, 'id'>>): Promise<void>;
+    /** Read all horizons for the project (AD-14 hierarchy). */
+    readHorizons?(): Promise<Horizon[]>;
+    /** Read all stages for the project, optionally filtered by horizon (AD-14 hierarchy). */
+    readStages?(horizonId?: string): Promise<Stage[]>;
+    /** Update a stage's status (e.g. 'Active' → 'Complete'). */
+    updateStageStatus?(stageId: string, status: string): Promise<void>;
+    /** Update a horizon's status (e.g. 'Active' → 'Complete'). */
+    updateHorizonStatus?(horizonId: string, status: string): Promise<void>;
+    /** Get the currently active stage for the project. */
+    getActiveStage?(): Promise<Stage | undefined>;
+    /** Create a new horizon (AD-14 hierarchy). Returns the created horizon's ID. */
+    createHorizon?(horizon: {
+        slug: string;
+        label: string;
+        description?: string;
+        status: HorizonStatus;
+        sortOrder: number;
+    }): Promise<string>;
+    /** Create a new stage (AD-14 hierarchy). Returns the created stage's ID. */
+    createStage?(stage: {
+        slug: string;
+        label: string;
+        description?: string;
+        status: StageStatus;
+        sortOrder: number;
+        horizonId: string;
+    }): Promise<string>;
+    /** Link phases to a stage by setting their stage_id. */
+    linkPhasesToStage?(stageId: string): Promise<void>;
     appendToolMetric(metric: ToolCallMetric): Promise<void>;
     readToolMetrics(): Promise<ToolCallMetric[]>;
-    getCostSummary(sprintNumber?: number): Promise<CostSummary>;
+    getCostSummary(cycleNumber?: number): Promise<CostSummary>;
     writeCostSnapshot(snapshot: CostSnapshot): Promise<void>;
     getCostSnapshots(): Promise<CostSnapshot[]>;
-    appendSprintMetrics(snapshot: SprintMetricsSnapshot): Promise<void>;
-    readSprintMetrics(): Promise<SprintMetricsSnapshot[]>;
-    readSprints(): Promise<Sprint[]>;
-    createSprint(sprint: Sprint): Promise<void>;
-    getContextHashes?(sprintNumber: number): Promise<Record<string, string> | null>;
+    appendCycleMetrics(snapshot: CycleMetricsSnapshot): Promise<void>;
+    readCycleMetrics(): Promise<CycleMetricsSnapshot[]>;
+    readCycles(): Promise<Cycle[]>;
+    createCycle(cycle: Cycle): Promise<void>;
+    getContextHashes?(cycleNumber: number): Promise<Record<string, string> | null>;
     readRegistries(): Promise<Registries>;
     updateRegistries(registries: Registries): Promise<void>;
     writeRecommendation(rec: Omit<StrategyRecommendation, 'id'>): Promise<StrategyRecommendation>;
     getPendingRecommendations(): Promise<StrategyRecommendation[]>;
-    actionRecommendation(id: string, sprintNumber: number): Promise<void>;
+    actionRecommendation(id: string, cycleNumber: number): Promise<void>;
     appendDecisionEvent(event: Omit<DecisionEvent, 'id' | 'createdAt'>): Promise<DecisionEvent>;
     getDecisionEvents(decisionId: string, limit?: number): Promise<DecisionEvent[]>;
-    getDecisionEventsSince(sprint: number): Promise<DecisionEvent[]>;
+    getDecisionEventsSince(cycle: number): Promise<DecisionEvent[]>;
     writeDecisionScore(score: Omit<DecisionScore, 'id' | 'createdAt' | 'totalScore'>): Promise<DecisionScore>;
     getDecisionScores(decisionId: string): Promise<DecisionScore[]>;
     getLatestDecisionScores(): Promise<DecisionScore[]>;
     logEntityReferences(refs: Omit<EntityReference, 'id' | 'createdAt'>[]): Promise<void>;
-    getDecisionUsage(currentSprint: number): Promise<DecisionUsageSummary[]>;
+    getDecisionUsage(currentCycle: number): Promise<DecisionUsageSummary[]>;
+    /** Get context utilisation summary from v_context_utilisation view. Optional — pg adapter only. */
+    getContextUtilisation?(): Promise<ContextUtilisationSummary[]>;
     writeStrategyReview(review: StrategyReviewEntry): Promise<void>;
-    getLastStrategyReviewSprint(): Promise<number>;
-    getStrategyReviews(limit?: number): Promise<StrategyReviewEntry[]>;
+    getLastStrategyReviewCycle(): Promise<number>;
+    getStrategyReviews(limit?: number, includeFullAnalysis?: boolean): Promise<StrategyReviewEntry[]>;
+    writeDogfoodEntries?(entries: DogfoodEntry[]): Promise<void>;
+    getDogfoodLog?(limit?: number): Promise<DogfoodEntry[]>;
+    getUnactionedDogfoodEntries?(limit?: number): Promise<DogfoodEntry[]>;
+    updateDogfoodEntryStatus?(id: string, status: DogfoodEntry['status'], linkedTaskId?: string): Promise<void>;
+    /**
+     * Optional: return the current (unsuperseded) North Star statement.
+     * When implemented, plan and strategy_review use this instead of relying
+     * on the North Star embedded in PLANNING_LOG.md (which may be stale).
+     */
+    getCurrentNorthStar?(): Promise<string | null>;
+    /**
+     * Optional: return the cycle number when the current North Star was set.
+     * Used for drift detection — flags when North Star hasn't been validated in 10+ cycles.
+     */
+    getNorthStarSetCycle?(): Promise<number | null>;
+    /**
+     * Optional: return both cycle number and set_at date for the current North Star.
+     * Used for hybrid drift detection — warns only when both cycle gap AND time gap exceed thresholds.
+     */
+    getNorthStarStaleness?(): Promise<{
+        setCycle: number;
+        setAt: string;
+    } | null>;
+    /**
+     * Optional: return aggregated estimation calibration data from v_estimation_accuracy.
+     * Used by the planner to adjust effort estimates based on historical patterns.
+     */
+    getEstimationCalibration?(): Promise<EstimationCalibrationRow[]>;
     /**
      * Optional: return recent task comments for plan context.
      * Returns up to `limit` comments across all active tasks, newest first.
@@ -465,6 +651,11 @@ interface PapiAdapter {
         content: string;
         createdAt: string;
     }[]>;
+    /**
+     * Optional: return recommendation effectiveness data from v_recommendation_effectiveness.
+     * Used by strategy review to assess whether past recommendations were followed.
+     */
+    getRecommendationEffectiveness?(): Promise<RecommendationEffectivenessRow[]>;
     /**
      * Optional: return a lean pre-formatted plan context summary.
      * When implemented (e.g. by pg adapter with SQL aggregates), assembleContext
@@ -472,6 +663,12 @@ interface PapiAdapter {
      * Return undefined to fall back to the default assembly path.
      */
     getPlanContextSummary?(): Promise<PlanContextSummary | undefined>;
+    /**
+     * Optional: check if the project exists in the data store.
+     * Returns true if the project is found, false otherwise.
+     * When not implemented, defaults to true (assumes project exists).
+     */
+    projectExists?(): Promise<boolean>;
 }
 /** Lean plan context returned by adapters that support SQL aggregation. */
 interface PlanContextSummary {
@@ -479,25 +676,25 @@ interface PlanContextSummary {
     board: string;
     /** Pre-computed build intelligence: accuracy %, velocity trend, top surprises. */
     buildIntelligence: string;
-    /** Last 3 sprint entries with carry-forward. */
-    sprintLog: string;
+    /** Last 3 cycle entries with carry-forward. */
+    cycleLog: string;
     /** One-liner per active decision: id, title, confidence. */
     activeDecisions: string;
 }
 /** Everything the plan write-back needs to persist in a single transaction. */
 interface PlanWriteBackPayload {
-    /** The NEW sprint number (current + 1). */
-    sprintNumber: number;
-    /** Sprint log entry to upsert. */
-    sprintLog: SprintLogEntry;
+    /** The NEW cycle number (current + 1). */
+    cycleNumber: number;
+    /** Cycle log entry to upsert. */
+    cycleLog: CycleLogEntry;
     /** Health updates: boardHealth, strategicDirection, etc. */
-    healthUpdates: Partial<SprintHealth>;
+    healthUpdates: Partial<CycleHealth>;
     /** New tasks to create (already deduplicated by plan service). */
-    newTasks: Array<Omit<SprintTask, 'id' | 'uuid' | 'displayId'>>;
+    newTasks: Array<Omit<CycleTask, 'id' | 'uuid' | 'displayId'>>;
     /** Board corrections: taskId + partial updates. */
     boardCorrections: Array<{
         taskId: string;
-        updates: Partial<Omit<SprintTask, 'id'>>;
+        updates: Partial<Omit<CycleTask, 'id'>>;
     }>;
     /** Phases parsed from product brief update. Empty array = no phase changes. */
     phases: Phase[];
@@ -513,10 +710,8 @@ interface PlanWriteBackPayload {
         taskId: string;
         handoff: BuildHandoff;
     }>;
-    /** Sprint entity to create. */
-    sprint: Sprint;
-    /** Whether to run feature sync from phases. */
-    featureSync: boolean;
+    /** Cycle entity to create. */
+    cycle: Cycle;
     /** IDs of tasks whose reviewed status should be checked before allowing priority changes. */
     reviewedTaskIds: string[];
 }
@@ -540,33 +735,33 @@ declare class MdFileAdapter implements PapiAdapter {
     private read;
     /** Write UTF-8 text to a .papi/ file. */
     private write;
-    /** Parse the full planning context into structured sections (reads from PLANNING_LOG.md + ACTIVE_DECISIONS.md + SPRINT_LOG.md). */
+    /** Parse the full planning context into structured sections (reads from PLANNING_LOG.md + ACTIVE_DECISIONS.md + CYCLE_LOG.md). */
     readPlanningLog(): Promise<PlanningLog>;
-    /** Read the Sprint Health table from PLANNING_LOG.md. */
-    getSprintHealth(): Promise<SprintHealth>;
+    /** Read the Cycle Health table from PLANNING_LOG.md. */
+    getCycleHealth(): Promise<CycleHealth>;
     /** Read all Active Decisions from ACTIVE_DECISIONS.md. */
     getActiveDecisions(): Promise<ActiveDecision[]>;
-    /** Read sprint log entries (newest first), optionally limited to {@link limit} entries. */
-    getSprintLog(limit?: number): Promise<SprintLogEntry[]>;
-    getSprintLogSince(sprintNumber: number): Promise<SprintLogEntry[]>;
-    /** Merge partial updates into the Sprint Health table and write back. */
-    setSprintHealth(updates: Partial<SprintHealth>): Promise<void>;
-    /** Prepend a new sprint log entry at the top of the Sprint Log section. */
-    writeSprintLogEntry(entry: SprintLogEntry): Promise<void>;
-    /** Write a strategy review — for md adapter, delegates to sprint log. */
+    /** Read cycle log entries (newest first), optionally limited to {@link limit} entries. */
+    getCycleLog(limit?: number): Promise<CycleLogEntry[]>;
+    getCycleLogSince(cycleNumber: number): Promise<CycleLogEntry[]>;
+    /** Merge partial updates into the Cycle Health table and write back. */
+    setCycleHealth(updates: Partial<CycleHealth>): Promise<void>;
+    /** Prepend a new cycle log entry at the top of the Cycle Log section. */
+    writeCycleLogEntry(entry: CycleLogEntry): Promise<void>;
+    /** Write a strategy review — for md adapter, delegates to cycle log. */
     writeStrategyReview(review: StrategyReviewEntry): Promise<void>;
-    /** Get the sprint number of the last strategy review. */
-    getLastStrategyReviewSprint(): Promise<number>;
-    /** Get strategy reviews — md adapter returns empty (reviews live in sprint log). */
-    getStrategyReviews(_limit?: number): Promise<StrategyReviewEntry[]>;
+    /** Get the cycle number of the last strategy review. */
+    getLastStrategyReviewCycle(): Promise<number>;
+    /** Get strategy reviews — md adapter returns empty (reviews live in cycle log). */
+    getStrategyReviews(_limit?: number, _includeFullAnalysis?: boolean): Promise<StrategyReviewEntry[]>;
     /** Update or insert an Active Decision block by ID. */
-    updateActiveDecision(id: string, body: string, sprintNumber?: number): Promise<void>;
-    /** Query the sprint board, optionally filtering by status/priority/phase/etc. */
-    queryBoard(options?: BoardQueryOptions): Promise<SprintTask[]>;
+    updateActiveDecision(id: string, body: string, cycleNumber?: number): Promise<void>;
+    /** Query the cycle board, optionally filtering by status/priority/phase/etc. */
+    queryBoard(options?: BoardQueryOptions): Promise<CycleTask[]>;
     /** Look up a single task by ID, returning null if not found. */
-    getTask(id: string): Promise<SprintTask | null>;
+    getTask(id: string): Promise<CycleTask | null>;
     /** Look up multiple tasks by ID in a single board read. */
-    getTasks(ids: string[]): Promise<SprintTask[]>;
+    getTasks(ids: string[]): Promise<CycleTask[]>;
     /** Warn if a phase name doesn't match any known phase label from PRODUCT_BRIEF.md. */
     private warnInvalidPhase;
     /** Warn if a module name doesn't match any registered module in REGISTRIES.md. */
@@ -574,32 +769,33 @@ declare class MdFileAdapter implements PapiAdapter {
     /** Warn if an epic name doesn't match any registered epic in REGISTRIES.md. */
     private warnInvalidEpic;
     /** Create a new task on the board with an auto-generated sequential ID. */
-    createTask(task: Omit<SprintTask, 'id'>): Promise<SprintTask>;
+    createTask(task: Omit<CycleTask, 'id'>): Promise<CycleTask>;
     /** Update one or more fields on an existing task. Throws if the task ID is not found. */
-    updateTask(id: string, updates: Partial<Omit<SprintTask, 'id'>>, options?: UpdateTaskOptions): Promise<void>;
+    updateTask(id: string, updates: Partial<Omit<CycleTask, 'id'>>, options?: UpdateTaskOptions): Promise<void>;
     /** Shorthand to update only the status field of a task. */
     updateTaskStatus(id: string, status: TaskStatus): Promise<void>;
+    recordTransition(_taskId: string, _fromStatus: string, _toStatus: string, _changedBy?: string): Promise<void>;
     /** Insert a new build report at the top of BUILD_REPORTS.md. */
     appendBuildReport(report: BuildReport): Promise<void>;
     /** Return the most recent {@link count} build reports. */
     getRecentBuildReports(count: number): Promise<BuildReport[]>;
-    /** Return all build reports from sprints >= {@link sprintNumber}. */
-    getBuildReportsSince(sprintNumber: number): Promise<BuildReport[]>;
+    /** Return all build reports from cycles >= {@link cycleNumber}. */
+    getBuildReportsSince(cycleNumber: number): Promise<BuildReport[]>;
     /** Return recent human reviews from REVIEWS.md (newest first), optionally limited to {@link count}. */
     getRecentReviews(count?: number): Promise<HumanReview[]>;
     /** Write a new human review to REVIEWS.md. */
     writeReview(review: HumanReview): Promise<void>;
-    /** Compress old sprint log entries below {@link threshold} into a summary block. */
-    compressSprintLog(threshold: number, summary: string): Promise<void>;
+    /** Compress old cycle log entries below {@link threshold} into a summary block. */
+    compressCycleLog(threshold: number, summary: string): Promise<void>;
     /** Compress old build reports below {@link threshold} into a summary block. */
     compressBuildReports(threshold: number, summary: string): Promise<void>;
     /** Read a .papi/ file, returning empty string if it doesn't exist. */
     private readOptional;
     /** Strip build_handoff and build_report from a task before archiving — these are already in BUILD_REPORTS.md. */
     private stripHeavyFields;
-    /** Append tasks to ARCHIVE_SPRINT_BOARD.md, stripping heavy fields and deduplicating by ID. */
+    /** Append tasks to ARCHIVE_CYCLE_BOARD.md, stripping heavy fields and deduplicating by ID. */
     private appendToArchive;
-    /** Archive tasks matching phases and/or statuses to ARCHIVE_SPRINT_BOARD.md and remove them from active board. */
+    /** Archive tasks matching phases and/or statuses to ARCHIVE_CYCLE_BOARD.md and remove them from active board. */
     archiveTasks(phases: string[], statuses?: string[]): Promise<{
         archivedCount: number;
         taskIds: string[];
@@ -608,38 +804,30 @@ declare class MdFileAdapter implements PapiAdapter {
     readProductBrief(): Promise<string>;
     /** Overwrite PRODUCT_BRIEF.md with new content. */
     updateProductBrief(content: string): Promise<void>;
+    readDiscoveryCanvas(): Promise<DiscoveryCanvas>;
+    updateDiscoveryCanvas(_canvas: Partial<DiscoveryCanvas>): Promise<void>;
     /** Read all phases from PHASES.md (falls back to PRODUCT_BRIEF.md for migration). */
     readPhases(): Promise<Phase[]>;
     /** Write phases to PHASES.md. */
     writePhases(phases: Phase[]): Promise<void>;
-    /** Read all features from FEATURES.md. */
-    readFeatures(): Promise<Feature[]>;
-    /** Get a single feature by UUID. */
-    getFeature(id: string): Promise<Feature | null>;
-    /** Create a new feature and append it to FEATURES.md. */
-    createFeature(feature: Omit<Feature, 'id'>): Promise<Feature>;
-    /** Update an existing feature by UUID. */
-    updateFeature(id: string, updates: Partial<Omit<Feature, 'id'>>): Promise<void>;
-    /** Write all features to FEATURES.md. */
-    private writeFeatures;
     /** Append a tool call metric entry to METRICS.md. */
     appendToolMetric(metric: ToolCallMetric): Promise<void>;
     /** Read all tool call metrics from METRICS.md. */
     readToolMetrics(): Promise<ToolCallMetric[]>;
-    /** Aggregate tool call metrics into a cost summary, optionally filtered by sprint. */
-    getCostSummary(sprintNumber?: number): Promise<CostSummary>;
+    /** Aggregate tool call metrics into a cost summary, optionally filtered by cycle. */
+    getCostSummary(cycleNumber?: number): Promise<CostSummary>;
     /** Write a cost snapshot to the Cost Summary section of METRICS.md. */
     writeCostSnapshot(snapshot: CostSnapshot): Promise<void>;
     /** Read all cost snapshots from the Cost Summary section of METRICS.md. */
     getCostSnapshots(): Promise<CostSnapshot[]>;
-    /** Append a sprint metrics snapshot to SPRINT_METRICS.md. */
-    appendSprintMetrics(snapshot: SprintMetricsSnapshot): Promise<void>;
-    /** Read all sprint metrics snapshots from SPRINT_METRICS.md. */
-    readSprintMetrics(): Promise<SprintMetricsSnapshot[]>;
-    /** Read all Sprint entities from SPRINTS.md (newest first). */
-    readSprints(): Promise<Sprint[]>;
-    /** Write a new Sprint entity to SPRINTS.md. */
-    createSprint(sprint: Sprint): Promise<void>;
+    /** Append a cycle metrics snapshot to CYCLE_METRICS.md. */
+    appendCycleMetrics(snapshot: CycleMetricsSnapshot): Promise<void>;
+    /** Read all cycle metrics snapshots from CYCLE_METRICS.md. */
+    readCycleMetrics(): Promise<CycleMetricsSnapshot[]>;
+    /** Read all Cycle entities from CYCLES.md (newest first). */
+    readCycles(): Promise<Cycle[]>;
+    /** Write a new Cycle entity to CYCLES.md. */
+    createCycle(cycle: Cycle): Promise<void>;
     /** Read module and epic registries from REGISTRIES.md. */
     readRegistries(): Promise<Registries>;
     /** Overwrite REGISTRIES.md with updated registries. */
@@ -652,17 +840,17 @@ declare class MdFileAdapter implements PapiAdapter {
     /** Read all pending (unactioned) strategy recommendations. */
     getPendingRecommendations(): Promise<StrategyRecommendation[]>;
     /** Mark a recommendation as actioned. */
-    actionRecommendation(id: string, sprintNumber: number): Promise<void>;
+    actionRecommendation(id: string, cycleNumber: number): Promise<void>;
     appendDecisionEvent(event: Omit<DecisionEvent, 'id' | 'createdAt'>): Promise<DecisionEvent>;
     getDecisionEvents(decisionId: string, limit?: number): Promise<DecisionEvent[]>;
-    getDecisionEventsSince(sprint: number): Promise<DecisionEvent[]>;
+    getDecisionEventsSince(cycle: number): Promise<DecisionEvent[]>;
     private parseDecisionEvents;
     writeDecisionScore(score: Omit<DecisionScore, 'id' | 'createdAt' | 'totalScore'>): Promise<DecisionScore>;
     getDecisionScores(decisionId: string): Promise<DecisionScore[]>;
     getLatestDecisionScores(): Promise<DecisionScore[]>;
     private parseDecisionScores;
     logEntityReferences(_refs: Omit<EntityReference, 'id' | 'createdAt'>[]): Promise<void>;
-    getDecisionUsage(_currentSprint: number): Promise<DecisionUsageSummary[]>;
+    getDecisionUsage(_currentCycle: number): Promise<DecisionUsageSummary[]>;
 }
 
 /** Validate and normalise an effort string to EffortSize. Returns the value or undefined if invalid. */
@@ -676,10 +864,10 @@ declare function parseBuildHandoff(markdown: string): BuildHandoff | null;
 /** Serialize a BuildHandoff object back into the standard markdown format. */
 declare function serializeBuildHandoff(handoff: BuildHandoff): string;
 
-/** Calculate Tier 1 sprint metrics from build reports. */
-declare function calculateSprintMetrics(reports: BuildReport[], currentSprint: number, window?: number): {
-    accuracy: SprintEstimationAccuracy[];
-    velocity: SprintVelocity[];
+/** Calculate Tier 1 cycle metrics from build reports. */
+declare function calculateCycleMetrics(reports: BuildReport[], currentCycle: number, window?: number): {
+    accuracy: CycleEstimationAccuracy[];
+    velocity: CycleVelocity[];
 };
 /**
  * Detect recurring patterns across build reports.
@@ -687,7 +875,7 @@ declare function calculateSprintMetrics(reports: BuildReport[], currentSprint: n
  * When a TextClusterer is provided, uses LLM-based semantic clustering for surprises
  * instead of normalised string matching.
  */
-declare function detectBuildPatterns(reports: BuildReport[], currentSprint: number, window?: number, clusterer?: TextClusterer): Promise<BuildPatterns>;
+declare function detectBuildPatterns(reports: BuildReport[], currentCycle: number, window?: number, clusterer?: TextClusterer): Promise<BuildPatterns>;
 /** Returns true if the patterns contain any actionable findings. */
 declare function hasBuildPatterns(patterns: BuildPatterns): boolean;
 
@@ -704,7 +892,7 @@ declare function prependReview(review: HumanReview, content: string): string;
  * When a TextClusterer is provided, uses LLM-based semantic clustering for feedback
  * instead of normalised string matching.
  */
-declare function detectReviewPatterns(reviews: HumanReview[], currentSprint: number, window?: number, clusterer?: TextClusterer): Promise<ReviewPatterns>;
+declare function detectReviewPatterns(reviews: HumanReview[], currentCycle: number, window?: number, clusterer?: TextClusterer): Promise<ReviewPatterns>;
 /** Returns true if the patterns contain any actionable findings. */
 declare function hasReviewPatterns(patterns: ReviewPatterns): boolean;
 
@@ -714,8 +902,8 @@ declare function parseToolMetrics(content: string): ToolCallMetric[];
 declare function serializeToolMetric(metric: ToolCallMetric): string;
 /** Append a tool metric row to METRICS.md content. Creates the file template if content is empty. */
 declare function appendToolMetricToContent(metric: ToolCallMetric, content: string): string;
-/** Aggregate tool call metrics into a cost summary, optionally filtered by sprint. */
-declare function aggregateCostSummary(metrics: ToolCallMetric[], sprintNumber?: number): CostSummary;
+/** Aggregate tool call metrics into a cost summary, optionally filtered by cycle. */
+declare function aggregateCostSummary(metrics: ToolCallMetric[], cycleNumber?: number): CostSummary;
 
 /** Parse the PHASES YAML section from PRODUCT_BRIEF.md content. */
 declare function parsePhases(content: string): Phase[];
@@ -724,21 +912,14 @@ declare function serializePhases(phases: Phase[]): string;
 /** Serialize phases and write them into the PHASES section of PRODUCT_BRIEF.md content. */
 declare function writePhasesToContent(phases: Phase[], content: string): string;
 
-/** Parse the FEATURES YAML section from FEATURES.md content. */
-declare function parseFeatures(content: string): Feature[];
-/** Serialize an array of features to a YAML block. */
-declare function serializeFeatures(features: Feature[]): string;
-/** Serialize features and write them into the FEATURES section of FEATURES.md content. */
-declare function writeFeaturesToContent(features: Feature[], content: string): string;
-
-/** Parse SPRINTS.md content into an array of Sprint objects (newest first). */
-declare function parseSprints(content: string): Sprint[];
-/** Serialize sprints to a complete SPRINTS.md file content. */
-declare function serializeSprints(sprints: Sprint[], content: string): string;
-/** Serialize a single Sprint to a YAML string (for display/export). */
-declare function serializeSprint(sprint: Sprint): string;
-/** Add a new sprint to SPRINTS.md (prepended to the array so newest is first). */
-declare function prependSprint(sprint: Sprint, content: string): string;
+/** Parse CYCLES.md content into an array of Cycle objects (newest first). */
+declare function parseCycles(content: string): Cycle[];
+/** Serialize cycles to a complete CYCLES.md file content. */
+declare function serializeCycles(cycles: Cycle[], content: string): string;
+/** Serialize a single Cycle to a YAML string (for display/export). */
+declare function serializeCycle(cycle: Cycle): string;
+/** Add a new cycle to CYCLES.md (prepended to the array so newest is first). */
+declare function prependCycle(cycle: Cycle, content: string): string;
 
 /** Parse REGISTRIES.md content into a Registries object. */
 declare function parseRegistries(content: string): Registries;
@@ -901,4 +1082,4 @@ interface ConflictAlert {
     resolved_at?: string;
 }
 
-export { type Acknowledgement, type AcknowledgementStatus, type ActiveDecision, type BoardQueryOptions, type BuildHandoff, type BuildPatterns, type BuildReport, type ClusterEntry, type ClusterResult, type CommandCost, type Confidence, type ConflictAlert, type ConflictAlertStatus, type ConflictRaisedBy, type ConflictType, type ContextHashes, type ContextTier, type CostSnapshot, type CostSummary, type DecisionEvent, type DecisionEventSource, type DecisionEventType, type DecisionScore, type DecisionUsageSummary, type EffortSize, type EntityReference, type Feature, type FeatureStatus, type HumanReview, MdFileAdapter, type MilestoneDependency, type NorthStar, type PapiAdapter, type Phase, type PhaseStatus, type PlanContextSummary, type PlanWriteBackPayload, type PlanWriteBackResult, type PlanningLog, type Project, type ProjectContribution, type ProjectContributionStatus, type RecommendationStatus, type RecommendationType, type RecurringFeedback, type RecurringSurprise, type Registries, type ReviewPatterns, type ReviewStage, type ReviewVerdict, type SharedDecision, type SharedDecisionConfidence, type SharedDecisionStatus, type SharedMilestone, type SharedMilestoneStatus, type Sprint, type SprintEstimationAccuracy, type SprintHealth, type SprintLogEntry, type SprintMetricsSnapshot, type SprintStatus, type SprintTask, type SprintVelocity, type StateTransition, type StrategyRecommendation, type StrategyReviewEntry, TASK_TYPE_TIERS, type TaskComplexity, type TaskMaturity, type TaskPriority, type TaskStatus, type TaskType, type TextClusterer, type ToolCallMetric, type UpdateTaskOptions, VALID_TRANSITIONS, aggregateCostSummary, appendToolMetricToContent, calculateSprintMetrics, detectBuildPatterns, detectReviewPatterns, hasBuildPatterns, hasReviewPatterns, isValidStatus, isValidTransition, parseBuildHandoff, parseEffortSize, parseFeatures, parsePhases, parseRegistries, parseReviews, parseSprints, parseToolMetrics, prependReview, prependSprint, serializeBuildHandoff, serializeFeatures, serializePhases, serializeRegistries, serializeReview, serializeSprint, serializeSprints, serializeToolMetric, validateTransition, writeFeaturesToContent, writePhasesToContent };
+export { type Acknowledgement, type AcknowledgementStatus, type ActiveDecision, type AutoReview, type AutoReviewFinding, type AutoReviewVerdict, type BoardQueryOptions, type BriefImplication, type BuildHandoff, type BuildPatterns, type BuildReport, type ClusterEntry, type ClusterResult, type CommandCost, type Confidence, type ConflictAlert, type ConflictAlertStatus, type ConflictRaisedBy, type ConflictType, type ContextHashes, type ContextTier, type ContextUtilisationSummary, type CostSnapshot, type CostSummary, type Cycle, type CycleEstimationAccuracy, type CycleHealth, type CycleLogEntry, type CycleMetricsSnapshot, type CycleStatus, type CycleTask, type CycleVelocity, type DecisionEvent, type DecisionEventSource, type DecisionEventType, type DecisionScore, type DecisionUsageSummary, type DiscoveryCanvas, type DogfoodEntry, type EffortSize, type EntityReference, type EstimationCalibrationRow, type Horizon, type HorizonStatus, type HumanReview, MdFileAdapter, type MilestoneDependency, type NorthStar, type PapiAdapter, type Phase, type PhaseStatus, type PlanContextSummary, type PlanWriteBackPayload, type PlanWriteBackResult, type PlanningLog, type Project, type ProjectContribution, type ProjectContributionStatus, type RecommendationEffectivenessRow, type RecommendationStatus, type RecommendationType, type RecurringFeedback, type RecurringSurprise, type Registries, type ReviewPatterns, type ReviewStage, type ReviewVerdict, type SharedDecision, type SharedDecisionConfidence, type SharedDecisionStatus, type SharedMilestone, type SharedMilestoneStatus, type Stage, type StageStatus, type StateTransition, type StrategyRecommendation, type StrategyReviewEntry, TASK_TYPE_TIERS, type TaskComplexity, type TaskMaturity, type TaskPriority, type TaskStatus, type TaskType, type TextClusterer, type ToolCallMetric, type UpdateTaskOptions, VALID_TRANSITIONS, aggregateCostSummary, appendToolMetricToContent, calculateCycleMetrics, detectBuildPatterns, detectReviewPatterns, hasBuildPatterns, hasReviewPatterns, isValidStatus, isValidTransition, parseBuildHandoff, parseCycles, parseEffortSize, parsePhases, parseRegistries, parseReviews, parseToolMetrics, prependCycle, prependReview, serializeBuildHandoff, serializeCycle, serializeCycles, serializePhases, serializeRegistries, serializeReview, serializeToolMetric, validateTransition, writePhasesToContent };