selftune 0.2.15 → 0.2.18

package/cli/selftune/dashboard-contract.ts

@@ -1,3 +1,71 @@
+// -- Cursor-based pagination types -------------------------------------------
+
+export interface PaginationCursor {
+  timestamp: string;
+  id: number | string;
+}
+
+export interface PaginatedResult<T> {
+  items: T[];
+  next_cursor: PaginationCursor | null;
+  has_more: boolean;
+}
+
+/** Parse a JSON cursor param from a URL search string. Returns null on invalid input. */
+export function parseCursorParam(value: string | null | undefined): PaginationCursor | null {
+  if (!value) return null;
+  try {
+    const parsed: unknown = JSON.parse(value);
+    if (parsed && typeof parsed === "object" && "timestamp" in parsed && "id" in parsed) {
+      const { timestamp, id } = parsed as { timestamp: unknown; id: unknown };
+      if (
+        typeof timestamp === "string" &&
+        (typeof id === "string" || (typeof id === "number" && Number.isFinite(id)))
+      ) {
+        return { timestamp, id };
+      }
+    }
+  } catch {
+    // Invalid cursor JSON — treat as no cursor
+  }
+  return null;
+}
+
+/** Parse an integer query param with bounds clamping. */
+export function parseIntParam(value: string | null | undefined, defaultValue: number): number {
+  if (value == null) return defaultValue;
+  const n = Number.parseInt(value, 10);
+  return Number.isNaN(n) ? defaultValue : Math.max(1, Math.min(n, 10000));
+}
+
+// -- Paginated overview payload (returned when cursor params are provided) ----
+
+export interface OverviewPaginatedPayload {
+  telemetry_page: PaginatedResult<TelemetryRecord>;
+  skills_page: PaginatedResult<SkillUsageRecord>;
+  evolution: EvolutionEntry[];
+  counts: OverviewPayload["counts"];
+  unmatched_queries: UnmatchedQuery[];
+  pending_proposals: PendingProposal[];
+  active_sessions: number;
+  recent_activity: RecentActivityItem[];
+}
+
+export interface SkillReportPaginatedPayload extends Omit<
+  SkillReportPayload,
+  "recent_invocations"
+> {
+  invocations_page: PaginatedResult<{
+    timestamp: string;
+    session_id: string;
+    query: string;
+    triggered: boolean;
+    source: string | null;
+  }>;
+}
+
+// -- Core record types -------------------------------------------------------
+
 export interface TelemetryRecord {
   timestamp: string;
   session_id: string;
@@ -220,6 +288,36 @@ export interface HealthResponse {
 // -- Doctor / health check types ----------------------------------------------
 export type { DoctorResult, HealthCheck, HealthStatus } from "./types.js";
 
+// -- Execution metrics (aggregated from execution_facts enrichment columns) ---
+
+export interface ExecutionMetrics {
+  avg_files_changed: number;
+  total_lines_added: number;
+  total_lines_removed: number;
+  total_cost_usd: number;
+  avg_cost_usd: number;
+  cached_input_tokens_total: number;
+  reasoning_output_tokens_total: number;
+  artifact_count: number;
+  session_type_distribution: Record<string, number>;
+}
+
+// -- Commit summary (aggregated from commit_tracking table) -------------------
+
+export interface CommitRecord {
+  commit_sha: string;
+  commit_title: string | null;
+  branch: string | null;
+  repo_remote: string | null;
+  timestamp: string;
+}
+
+export interface CommitSummary {
+  total_commits: number;
+  unique_branches: number;
+  recent_commits: Array<{ sha: string; title: string; branch: string; timestamp: string }>;
+}
+
 export interface SkillReportResponse extends SkillReportPayload {
   evolution: EvolutionEntry[];
   pending_proposals: PendingProposal[];
@@ -242,6 +340,8 @@ export interface SkillReportResponse extends SkillReportPayload {
   };
   prompt_samples: PromptSample[];
   session_metadata: SessionMeta[];
+  execution_metrics?: ExecutionMetrics | null;
+  commit_summary?: CommitSummary | null;
   description_quality?: {
     composite: number;
     criteria: {

package/cli/selftune/dashboard-server.ts

@@ -448,7 +448,7 @@ export async function startDashboardServer(
           );
         }
         refreshV2Data();
-        return withCors(handleOverview(db, selftuneVersion));
+        return withCors(handleOverview(db, selftuneVersion, url.searchParams));
       }
 
       // ---- GET /api/v2/orchestrate-runs ----
@@ -495,7 +495,7 @@ export async function startDashboardServer(
           );
         }
         refreshV2Data();
-        return withCors(handleSkillReport(db, skillName));
+        return withCors(handleSkillReport(db, skillName, url.searchParams));
       }
 
       // ---- SPA fallback ----

package/cli/selftune/evolution/description-quality.ts

@@ -139,27 +139,27 @@ export function scoreLengthCriterion(description: string): number {
 }
 
 /** Score presence of trigger context words (when/if/before/after etc). */
-export function scoreTriggerContextCriterion(description: string): number {
-  const matches = countWordMatches(description.toLowerCase(), TRIGGER_PATTERNS);
+export function scoreTriggerContextCriterion(description: string, lower?: string): number {
+  const matches = countWordMatches(lower ?? description.toLowerCase(), TRIGGER_PATTERNS);
   if (matches === 0) return 0.0;
   if (matches === 1) return 0.7;
   return Math.min(1.0, 0.7 + 0.15 * (matches - 1));
 }
 
 /** Score absence of vague words (lower is worse). */
-export function scoreVaguenessCriterion(description: string): number {
-  const matches = countWordMatches(description.toLowerCase(), VAGUE_PATTERNS);
+export function scoreVaguenessCriterion(description: string, lower?: string): number {
+  const matches = countWordMatches(lower ?? description.toLowerCase(), VAGUE_PATTERNS);
   if (matches === 0) return 1.0;
   if (matches === 1) return 0.6;
   return Math.max(0.1, 0.6 - 0.15 * (matches - 1));
 }
 
 /** Score whether description specifies at least one concrete action or domain. */
-export function scoreSpecificityCriterion(description: string): number {
-  const lower = description.toLowerCase();
-  const hasAction = ACTION_PATTERNS.some((p) => p.test(lower));
+export function scoreSpecificityCriterion(description: string, lower?: string): number {
+  const l = lower ?? description.toLowerCase();
+  const hasAction = ACTION_PATTERNS.some((p) => p.test(l));
 
-  const fillerCount = FILLER_PHRASES.filter((f) => lower.includes(f)).length;
+  const fillerCount = FILLER_PHRASES.filter((f) => l.includes(f)).length;
   const words = description.split(/\s+/).length;
   const fillerRatio = fillerCount > 0 ? fillerCount / Math.max(1, words / 10) : 0;
 
@@ -204,11 +204,12 @@ const WEIGHTS = {
  * Pure function — no I/O, no LLM calls.
  */
 export function scoreDescription(description: string, skillName?: string): DescriptionQualityScore {
+  const lower = description.toLowerCase();
   const criteria = {
     length: scoreLengthCriterion(description),
-    trigger_context: scoreTriggerContextCriterion(description),
-    vagueness: scoreVaguenessCriterion(description),
-    specificity: scoreSpecificityCriterion(description),
+    trigger_context: scoreTriggerContextCriterion(description, lower),
+    vagueness: scoreVaguenessCriterion(description, lower),
+    specificity: scoreSpecificityCriterion(description, lower),
     not_just_name: scoreNotJustNameCriterion(description, skillName),
   };