opencode-matrixx 2.6.10 → 2.6.11

package/dist/hooks/start-work/plan-filter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Staleness-aware plan classification for start-work.
+ *
+ * Replaces the bare `!getPlanProgress(p).isComplete` predicate: archived
+ * plans are excluded, `total==0 needsTriage` plans leave the actionable set,
+ * and mtime-stale plans with no linked active tasks are demoted to stale
+ * candidates instead of hijacking auto-select.
+ */
+import type { MatrixxConfig } from "../../config/schema";
+/** Plans under this segment are archived candidates (see Task 6); never listed. */
+export declare const ARCHIVED_PLAN_SEGMENT = "_archive";
+export declare function isArchivedPlan(planPath: string): boolean;
+/** Age of a plan file in ms since last write (mtime). Null when unstatable. */
+export declare function getPlanAgeMs(planPath: string): number | null;
+/**
+ * Stale threshold in ms from plugin config.
+ * `tasks.stale_after_hours` (default 24h, legacy `morpheus.tasks.*`).
+ */
+export declare function getPlansStaleAfterMs(config?: Partial<MatrixxConfig>): number;
+/** A plan whose file cannot be stat'ed is treated as fresh (not stale). */
+export declare function isPlanStale(planPath: string, staleAfterMs: number): boolean;
+/** Human-readable age, e.g. "3h", "2d". Clamped at zero for clock skew. */
+export declare function formatPlanAge(ageMs: number): string;
+export interface ClassifyPlansOptions {
+    staleAfterMs?: number;
+    /**
+     * True when the plan still has linked active tasks. Defaults to false
+     * (stale by mtime alone); the Task 6 reconciler wires the real linkage.
+     */
+    hasLinkedActiveTasks?: (planPath: string) => boolean;
+}
+export interface ClassifiedPlans {
+    /** Fresh incomplete plans — the only auto-select candidates. */
+    actionable: string[];
+    /** Mtime-stale incomplete plans — shown under a stale-candidate section. */
+    staleCandidates: string[];
+    /** total==0 plans — shown with a needsTriage tag, never actionable. */
+    triage: string[];
+    completed: string[];
+}
+/**
+ * Split plans into actionable / stale-candidate / triage / completed.
+ * Input order (findOraclePlans mtime newest-first) is preserved per bucket.
+ */
+export declare function classifyPlans(plans: string[], opts?: ClassifyPlansOptions): ClassifiedPlans;
+export type PlanListTag = "stale" | "needsTriage";
+/** One numbered plan line: progress + mtime age + optional tag. */
+export declare function formatPlanListLine(planPath: string, index: number, tag?: PlanListTag): string;