feat(J): J-SIGNAL/J-PATTERN/J-PROP/J-DRAFT/J-EVAL/J-APPROVAL/J-ACTIVATE/J-MEASURE — controlled self-improvement backend (signals, patterns, proposals, drafts, evaluation, approval, activation, rollback, impact measurement), 26 tests passing

2026-08-19 01:58:18 +02:00
parent 8ad8e252d8
commit 3854a19705
5 changed files with 1289 additions and 0 deletions
@@ -0,0 +1,159 @@
+/**
+ * Controlled Self-Improvement API client (Phase J).
+ *
+ * All requests use the shared `apiClient` (`baseURL: '/api/v1'`) and target
+ * the self-improvement routes under `/improvement/...`.
+ */
+
+import { apiDelete, apiGet, apiPost, apiPut } from './client';
+
+// ─── Types ───
+
+export type ProposalType =
+  | 'agent'
+  | 'skill'
+  | 'trigger'
+  | 'workflow'
+  | 'miniapp_template'
+  | 'plugin_patch';
+
+export type ProposalStatus =
+  | 'draft'
+  | 'evaluating'
+  | 'pending_approval'
+  | 'approved'
+  | 'rejected'
+  | 'active'
+  | 'rolled_back'
+  | 'expired';
+
+export type SignalType =
+  | 'agent_run'
+  | 'workflow_run'
+  | 'proactive_suggestion'
+  | 'audit_log'
+  | 'entity_history'
+  | 'user_correction'
+  | 'handoff'
+  | 'error_retry';
+
+export interface ImprovementSignal {
+  id: string;
+  signal_type: SignalType;
+  source_ref: string;
+  tenant_id: string;
+  user_id?: string | null;
+  timestamp: string;
+  outcome: string;
+  metadata: Record<string, unknown>;
+}
+
+export interface DetectedPattern {
+  id: string;
+  pattern_type: string;
+  description: string;
+  confidence: number;
+  occurrence_count: number;
+  evidence_refs: string[];
+  metadata: Record<string, unknown>;
+}
+
+export interface EvaluationResult {
+  proposal_id?: string;
+  draft_id?: string;
+  evaluated_at?: string;
+  test_cases: number;
+  passed: number;
+  failed: number;
+  score: number;
+  recommendation: string;
+  details?: unknown[];
+  [key: string]: unknown;
+}
+
+export interface ImprovementProposal {
+  id: string;
+  proposal_type: ProposalType;
+  title: string;
+  description: string;
+  rationale: string;
+  expected_benefit: string;
+  risk_assessment: string;
+  status: ProposalStatus;
+  evidence_refs: string[];
+  pattern_refs: string[];
+  draft_config: Record<string, unknown>;
+  evaluation_result: EvaluationResult;
+  measurement_before: Record<string, unknown>;
+  measurement_after: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+  approved_by?: string | null;
+  activated_at?: string | null;
+}
+
+export interface VersionedDraft {
+  id: string;
+  proposal_id: string;
+  version: number;
+  config: Record<string, unknown>;
+  previous_version_id?: string | null;
+  created_at: string;
+}
+
+export interface ProposalActionResponse {
+  proposal_id: string;
+  status: string;
+  error?: string;
+  approval_id?: string;
+  activated_at?: string;
+  rolled_back_at?: string;
+  rollback_available?: boolean;
+  previous_version_id?: string | null;
+  evaluation?: EvaluationResult;
+  [key: string]: unknown;
+}
+
+// ─── Proposals ───
+
+export const fetchProposals = (status?: ProposalStatus) =>
+  apiGet<ImprovementProposal[]>('/improvement/proposals', {
+    params: status ? { status } : {},
+  });
+
+export const fetchProposal = (id: string) =>
+  apiGet<ImprovementProposal>(`/improvement/proposals/${id}`);
+
+export const approveProposal = (id: string) =>
+  apiPost<ProposalActionResponse>(`/improvement/proposals/${id}/approve`);
+
+export const rejectProposal = (id: string) =>
+  apiPost<ProposalActionResponse>(`/improvement/proposals/${id}/reject`);
+
+export const rollbackProposal = (id: string) =>
+  apiPost<ProposalActionResponse>(`/improvement/proposals/${id}/rollback`);
+
+export const activateProposal = (id: string) =>
+  apiPost<ProposalActionResponse>(`/improvement/proposals/${id}/activate`);
+
+export const deleteProposal = (id: string) =>
+  apiDelete<{ status: string }>(`/improvement/proposals/${id}`);
+
+// ─── Patterns ───
+
+export const fetchPatterns = () => apiGet<DetectedPattern[]>('/improvement/patterns');
+
+// ─── Signals ───
+
+export const fetchSignals = (days?: number) =>
+  apiGet<ImprovementSignal[]>('/improvement/signals', {
+    params: days ? { days } : {},
+  });
+
+// ─── Drafts ───
+
+export const fetchDraft = (proposalId: string) =>
+  apiGet<VersionedDraft>(`/improvement/proposals/${proposalId}/draft`);
+
+export const updateDraft = (proposalId: string, config: Record<string, unknown>) =>
+  apiPut<VersionedDraft>(`/improvement/proposals/${proposalId}/draft`, { config });