@rigstate/mcp 0.4.2

package/src/agents/the-scribe.ts

@@ -0,0 +1,122 @@
+
+import { SupabaseClient } from '@supabase/supabase-js';
+
+/**
+ * The Scribe's core adapter for fetching its own persona from Prompt CMS.
+ */
+export async function getScribePersona(supabase: SupabaseClient) {
+    const { data: persona, error } = await supabase
+        .from('agent_personas')
+        .select('*')
+        .eq('slug', 'the-scribe')
+        .single();
+
+    if (error || !persona) {
+        return {
+            display_name: 'The Scribe',
+            job_title: 'Technical Documentation Lead',
+            content: 'You are The Scribe, an expert in technical manifest generation and investor-ready reporting.'
+        };
+    }
+
+    return persona;
+}
+
+/**
+ * Calculates real-world metrics for the Scribe to report on.
+ * Focuses on Velocity, Quality, and Risk.
+ * IMPORTANT: Excludes is_legacy=true items from velocity calculations
+ * to prevent historical imports from skewing development metrics.
+ */
+export async function calculateScribeMetrics(supabase: SupabaseClient, projectId: string) {
+    // A: Velocity - Average time for agent_bridge tasks in the last 7 days
+    const { data: recentTasks } = await supabase
+        .from('agent_bridge')
+        .select('created_at, updated_at')
+        .eq('project_id', projectId)
+        .eq('status', 'COMPLETED')
+        .gte('created_at', new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString());
+
+    let avgTimeMs = 0;
+    if (recentTasks && recentTasks.length > 0) {
+        const deltas = recentTasks.map(t =>
+            new Date(t.updated_at).getTime() - new Date(t.created_at).getTime()
+        );
+        avgTimeMs = deltas.reduce((a, b) => a + b, 0) / deltas.length;
+    }
+
+    const velocityStr = avgTimeMs > 0
+        ? `${(avgTimeMs / 1000).toFixed(1)}s avg execution time`
+        : "No execution history";
+
+    // B: Active Tasks Completed (EXCLUDES legacy items)
+    const { count: activeTasksCompleted } = await supabase
+        .from('roadmap_chunks')
+        .select('*', { count: 'exact', head: true })
+        .eq('project_id', projectId)
+        .eq('status', 'COMPLETED')
+        .or('is_legacy.is.null,is_legacy.eq.false');
+
+    // C: Legacy Foundations Count (for separate reporting)
+    const { count: legacyCount } = await supabase
+        .from('roadmap_chunks')
+        .select('*', { count: 'exact', head: true })
+        .eq('project_id', projectId)
+        .eq('is_legacy', true);
+
+    // D: Quality - Fetch from intelligence_trends
+    const { data: trends } = await supabase
+        .from('intelligence_trends')
+        .select('correction_count')
+        .order('week_start', { ascending: false })
+        .limit(2);
+
+    let trendDir = 'stable';
+    if (trends && trends.length === 2) {
+        const latest = trends[0].correction_count;
+        const prev = trends[1].correction_count;
+        if (latest < prev) trendDir = 'improving';
+        else if (latest > prev) trendDir = 'declining';
+    }
+    const qualityStr = `Quality trend is ${trendDir}` +
+        (legacyCount && legacyCount > 0 ? `. Built on ${legacyCount} established foundations.` : '');
+
+    // E: Risk - Count PING/CHECK rows
+    const { count: riskCount } = await supabase
+        .from('agent_bridge')
+        .select('*', { count: 'exact', head: true })
+        .eq('project_id', projectId)
+        .or('proposal.ilike.%PING%,proposal.ilike.%CHECK%,summary.ilike.%PING%,summary.ilike.%CHECK%');
+
+    // F: Enhanced Risk - Check for RLS
+    const { count: rlsCount } = await supabase.from('pg_policies').select('*', { count: 'exact', head: true }).eq('schemaname', 'public');
+
+    const riskMitigation = (riskCount || 0) > 0 || (rlsCount || 0) > 0
+        ? `Security posture reinforced by ${rlsCount || 0} RLS policies and ${riskCount || 0} active guardian pings. All access is audited.`
+        : "Security controls inactive. Immediate RLS audit recommended.";
+
+    return {
+        velocity: velocityStr,
+        qualityTrend: qualityStr,
+        riskScore: riskCount || 0,
+        riskMitigation,
+        activeTasksCompleted: activeTasksCompleted || 0,
+        legacyFoundations: legacyCount || 0
+    };
+}
+
+
+/**
+ * Interpolates common variables into the Scribe's prompt.
+ */
+export function interpolateScribePrompt(
+    basePrompt: string,
+    vars: { projectName: string; velocity?: string; quality?: string; riskMitigation?: string }
+): string {
+    let result = basePrompt;
+    result = result.replace(/{{project_name}}/g, vars.projectName);
+    if (vars.velocity) result = result.replace(/{{velocity}}/g, vars.velocity);
+    if (vars.quality) result = result.replace(/{{quality}}/g, vars.quality);
+    if (vars.riskMitigation) result = result.replace(/{{risk_mitigation}}/g, vars.riskMitigation);
+    return result;
+}