@soleri/core 2.1.0 → 2.5.0

package/src/planning/gap-types.ts

@@ -0,0 +1,61 @@
+/**
+ * Gap analysis types and scoring constants.
+ * Ported from Salvador MCP's multi-pass grading engine.
+ */
+
+// ─── Severity & Category ─────────────────────────────────────────
+
+export type GapSeverity = 'critical' | 'major' | 'minor' | 'info';
+
+export type GapCategory =
+  | 'structure'
+  | 'completeness'
+  | 'feasibility'
+  | 'risk'
+  | 'clarity'
+  | 'semantic-quality'
+  | 'tool-feasibility'
+  | 'flow-alignment'
+  | 'anti-pattern';
+
+export interface PlanGap {
+  id: string;
+  severity: GapSeverity;
+  category: GapCategory;
+  description: string;
+  recommendation: string;
+  /** Where in the plan this gap was found (e.g. 'objective', 'tasks[2]'). */
+  location?: string;
+  /** Machine-readable condition that fired — debug aid only. */
+  _trigger?: string;
+}
+
+// ─── Scoring Constants ───────────────────────────────────────────
+
+/** Points deducted per gap severity. */
+export const SEVERITY_WEIGHTS: Record<GapSeverity, number> = {
+  critical: 30,
+  major: 15,
+  minor: 2,
+  info: 0,
+};
+
+/**
+ * Maximum deduction per category.
+ * Categories not listed here have NO cap — uncapped deductions.
+ */
+export const CATEGORY_PENALTY_CAPS: Record<string, number> = {
+  clarity: 10,
+};
+
+// ─── Validation Thresholds ───────────────────────────────────────
+
+export const MIN_OBJECTIVE_LENGTH = 10;
+export const MIN_SCOPE_LENGTH = 10;
+export const MIN_DECISION_LENGTH = 10;
+
+// ─── Helpers ─────────────────────────────────────────────────────
+
+export function generateGapId(): string {
+  return `gap_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+}