kachow 0.1.0

package/_server/dist/services/managerService.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Manager intelligence service — Phase 8.
+ * Provides VP-level health summaries via OpenAI, team breakdowns,
+ * ADR decision history, and role-based onboarding paths.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getManagerPulse = getManagerPulse;
+exports.getManagerTeams = getManagerTeams;
+exports.getManagerDecisions = getManagerDecisions;
+exports.getOnboardingPath = getOnboardingPath;
+exports.getTeams = getTeams;
+exports.createTeam = createTeam;
+exports.deleteTeam = deleteTeam;
+exports.regenTeamCode = regenTeamCode;
+exports.joinTeamByCode = joinTeamByCode;
+exports.addTeamMember = addTeamMember;
+const openai_1 = __importDefault(require("openai"));
+const crypto_1 = require("crypto");
+const index_js_1 = require("../db/index.js");
+const graphService_js_1 = require("./graphService.js");
+/**
+ * Returns a VP-level pulse summary using OpenAI for the plain-English description.
+ */
+async function getManagerPulse() {
+    const health = (0, graphService_js_1.getSystemHealth)();
+    const nodes = (0, graphService_js_1.getNodes)();
+    const db = (0, index_js_1.getDb)();
+    const criticalNames = nodes.filter(n => n.healthTier === 'critical').map(n => n.name);
+    const warningNames = nodes.filter(n => n.healthTier === 'warning').map(n => n.name);
+    let plainEnglishSummary = `System health is at ${health.overallScore}/100 with ${health.critical} critical and ${health.warning} warning services.`;
+    const apiKey = process.env.OPENAI_API_KEY;
+    if (apiKey) {
+        try {
+            const openai = new openai_1.default({ apiKey });
+            const completion = await openai.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{
+                        role: 'user',
+                        content: `You are briefing a VP of Engineering. In exactly 2-3 sentences, summarize: Overall score ${health.overallScore}/100. Services: ${health.totalServices} total, ${health.critical} critical (${criticalNames.join(', ') || 'none'}), ${health.warning} warning (${warningNames.join(', ') || 'none'}), ${health.healthy} healthy. Be direct and action-oriented.`,
+                    }],
+                temperature: 0.2,
+                max_tokens: 150,
+            });
+            plainEnglishSummary = completion.choices[0]?.message?.content?.trim() ?? plainEnglishSummary;
+        }
+        catch {
+            // Fallback to static summary
+        }
+    }
+    const teams = db.prepare(`
+        SELECT team,
+               COUNT(*)                                                         AS svc_count,
+               ROUND(AVG(health_score), 0)                                      AS avg_health,
+               SUM(CASE WHEN health_tier = 'critical' THEN 1 ELSE 0 END)       AS critical_count
+        FROM services WHERE is_external = 0
+        GROUP BY team
+        ORDER BY avg_health ASC
+    `).all();
+    const topIssues = nodes
+        .filter(n => n.healthTier !== 'healthy')
+        .sort((a, b) => a.healthScore - b.healthScore)
+        .slice(0, 5)
+        .map(n => ({
+        serviceId: n.id,
+        serviceName: n.name,
+        healthScore: n.healthScore,
+        healthTier: n.healthTier,
+    }));
+    return {
+        overallScore: health.overallScore,
+        plainEnglishSummary,
+        topIssues,
+        teamBreakdown: teams.map(t => ({
+            team: t.team ?? 'unassigned',
+            serviceCount: t.svc_count,
+            avgHealth: t.avg_health,
+            criticalCount: t.critical_count,
+        })),
+    };
+}
+// ── Teams ─────────────────────────────────────────────────────────────────────
+function getManagerTeams() {
+    const db = (0, index_js_1.getDb)();
+    return db.prepare(`
+        SELECT team,
+               COUNT(*) AS svc_count,
+               ROUND(AVG(health_score), 0) AS avg_health,
+               SUM(CASE WHEN health_tier = 'critical' THEN 1 ELSE 0 END) AS critical_count
+        FROM services WHERE is_external = 0
+        GROUP BY team ORDER BY avg_health ASC
+    `).all()
+        .map(t => ({
+        team: t.team ?? 'unassigned',
+        serviceCount: t.svc_count,
+        avgHealth: t.avg_health,
+        criticalCount: t.critical_count,
+    }));
+}
+// ── Decisions (ADRs) ──────────────────────────────────────────────────────────
+function getManagerDecisions() {
+    const db = (0, index_js_1.getDb)();
+    return db.prepare(`
+        SELECT a.id, a.title, a.status, a.created_at,
+               ia.trigger_ref, ia.risk_score, ia.trigger_type
+        FROM adrs a
+        JOIN impact_analyses ia ON ia.id = a.analysis_id
+        ORDER BY a.created_at DESC LIMIT 20
+    `).all().map(a => ({
+        id: a.id,
+        title: a.title,
+        status: a.status,
+        riskScore: a.risk_score,
+        triggerRef: a.trigger_ref,
+        triggerType: a.trigger_type,
+        createdAt: a.created_at,
+    }));
+}
+// ── Onboarding path ───────────────────────────────────────────────────────────
+/**
+ * Generates a role-specific onboarding learning path.
+ * Orders services based on the engineer's role focus.
+ */
+function getOnboardingPath(role) {
+    const db = (0, index_js_1.getDb)();
+    const nodes = (0, graphService_js_1.getNodes)();
+    const edges = (0, graphService_js_1.getEdges)();
+    const outDegree = {};
+    for (const e of edges) {
+        outDegree[e.sourceId] = (outDegree[e.sourceId] ?? 0) + 1;
+    }
+    let ordered = [...nodes];
+    if (role === 'backend-engineer') {
+        // High out-degree first (most connected / most impactful)
+        ordered = ordered.sort((a, b) => (outDegree[b.id] ?? 0) - (outDegree[a.id] ?? 0));
+    }
+    else if (role === 'sre') {
+        // Worst health first — focus on fires
+        ordered = ordered.sort((a, b) => a.healthScore - b.healthScore);
+    }
+    else if (role === 'engineering-manager') {
+        // By team, then by health
+        ordered = ordered.sort((a, b) => {
+            const teamCmp = (a.team ?? 'zzz').localeCompare(b.team ?? 'zzz');
+            return teamCmp !== 0 ? teamCmp : a.healthScore - b.healthScore;
+        });
+    }
+    return {
+        role,
+        steps: ordered.slice(0, 8).map((n, i) => {
+            const svcRow = db.prepare('SELECT repo_url FROM services WHERE id = ?').get(n.id);
+            const endpoints = db.prepare('SELECT method, path FROM endpoints WHERE service_id = ? LIMIT 5').all(n.id);
+            const deps = edges.filter(e => e.sourceId === n.id).length;
+            return {
+                step: i + 1,
+                serviceId: n.id,
+                title: `Understand ${n.name}`,
+                description: `${n.name} is a ${n.language ?? 'service'}${n.team ? ` owned by the ${n.team} team` : ''}. Health: ${n.healthScore}/100 (${n.healthTier}). Makes ${deps} downstream call(s).`,
+                keyFiles: [
+                    `${n.name}/src/index.${n.language === 'python' ? 'py' : 'ts'}`,
+                    `${n.name}/src/routes.${n.language === 'python' ? 'py' : 'ts'}`,
+                    `${n.name}/README.md`,
+                ],
+                starterTasks: [
+                    `Read the ${n.name} README`,
+                    ...(endpoints.length > 0 ? [`Trace a request to ${endpoints[0].method} ${endpoints[0].path}`] : []),
+                    `Run the ${n.name} test suite`,
+                    ...(svcRow?.repo_url ? [`Clone and build ${n.name} locally`] : []),
+                ].slice(0, 3),
+                repoUrl: svcRow?.repo_url ?? null,
+                estimatedMinutes: 30 + deps * 5,
+            };
+        }),
+    };
+}
+function generateJoinCode() {
+    return String(Math.floor(100000 + Math.random() * 900000));
+}
+function rowToTeam(row, members) {
+    return {
+        id: row.id,
+        name: row.name,
+        repo: row.repo,
+        joinCode: row.join_code,
+        description: row.description,
+        color: row.color,
+        createdAt: row.created_at,
+        members,
+    };
+}
+function membersForTeam(teamId) {
+    const db = (0, index_js_1.getDb)();
+    return db.prepare(`SELECT * FROM team_members WHERE team_id = ? ORDER BY joined_at ASC`).all(teamId)
+        .map(m => ({
+        id: m.id,
+        name: m.name,
+        role: m.role,
+        online: m.online === 1,
+        progress: m.progress,
+        joinedAt: m.joined_at,
+    }));
+}
+/** Return all teams with their members. */
+function getTeams() {
+    const db = (0, index_js_1.getDb)();
+    const rows = db.prepare(`SELECT * FROM teams ORDER BY created_at ASC`).all();
+    return rows.map(r => rowToTeam(r, membersForTeam(r.id)));
+}
+/** Create a new team and return it. */
+function createTeam(input) {
+    const db = (0, index_js_1.getDb)();
+    // Ensure unique join code
+    let joinCode = generateJoinCode();
+    while (db.prepare(`SELECT 1 FROM teams WHERE join_code = ?`).get(joinCode)) {
+        joinCode = generateJoinCode();
+    }
+    const COLORS = ['#6366F1', '#16A34A', '#D97706', '#0052CC', '#DC2626', '#7C3AED', '#0891B2'];
+    const count = db.prepare(`SELECT COUNT(*) as c FROM teams`).get().c;
+    const color = input.color ?? COLORS[count % COLORS.length];
+    const id = (0, crypto_1.randomUUID)();
+    db.prepare(`
+        INSERT INTO teams (id, name, repo, join_code, description, color)
+        VALUES (?, ?, ?, ?, ?, ?)
+    `).run(id, input.name, input.repo ?? '—', joinCode, input.description ?? '', color);
+    return rowToTeam(db.prepare(`SELECT * FROM teams WHERE id = ?`).get(id), []);
+}
+/** Delete a team (cascades to members). */
+function deleteTeam(teamId) {
+    const db = (0, index_js_1.getDb)();
+    db.prepare(`DELETE FROM teams WHERE id = ?`).run(teamId);
+}
+/** Regenerate a team's join code and return the new code. */
+function regenTeamCode(teamId) {
+    const db = (0, index_js_1.getDb)();
+    let joinCode = generateJoinCode();
+    while (db.prepare(`SELECT 1 FROM teams WHERE join_code = ? AND id != ?`).get(joinCode, teamId)) {
+        joinCode = generateJoinCode();
+    }
+    db.prepare(`UPDATE teams SET join_code = ?, updated_at = datetime('now') WHERE id = ?`).run(joinCode, teamId);
+    return joinCode;
+}
+/** Validate a 6-digit code and return the matching team (for engineers). */
+function joinTeamByCode(joinCode) {
+    const db = (0, index_js_1.getDb)();
+    const row = db.prepare(`SELECT * FROM teams WHERE join_code = ?`).get(joinCode);
+    if (!row)
+        return null;
+    return rowToTeam(row, membersForTeam(row.id));
+}
+/** Add a member to a team (called after an engineer enters a valid code). */
+function addTeamMember(teamId, input) {
+    const db = (0, index_js_1.getDb)();
+    const id = (0, crypto_1.randomUUID)();
+    db.prepare(`INSERT INTO team_members (id, team_id, name, role) VALUES (?, ?, ?, ?)`).run(id, teamId, input.name, input.role ?? 'Engineer');
+    return db.prepare(`SELECT * FROM team_members WHERE id = ?`).get(id);
+}
+//# sourceMappingURL=managerService.js.map

package/_server/dist/services/notificationService.js

@@ -0,0 +1,283 @@
+"use strict";
+/**
+ * Notification service — Slack & Jira integrations.
+ *
+ * Sends notifications for critical issues:
+ *   - Slack: Bot Token + chat.postMessage Web API
+ *   - Jira: REST API v3 → add comment or create issue
+ *
+ * Env vars:
+ *   SLACK_BOT_TOKEN      — Slack Bot User OAuth Token (xoxb-…)
+ *   JIRA_BASE_URL        — e.g. https://your-org.atlassian.net
+ *   JIRA_EMAIL           — Atlassian account email
+ *   JIRA_API_TOKEN       — Atlassian API token
+ *   JIRA_PROJECT_KEY     — e.g. "KACHOW" (defaults to KACHOW)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendSlackNotification = sendSlackNotification;
+exports.commentOrCreateJira = commentOrCreateJira;
+const index_js_1 = require("../db/index.js");
+const crypto_1 = require("crypto");
+function resolveIssueContext(issueId) {
+    const db = (0, index_js_1.getDb)();
+    // Agent-sourced issues have IDs like "agent-hi-...", "agent-sh-..."
+    // Healing issues have IDs like "heal-<uuid>"
+    // Incident issues have IDs like "inc-<uuid>"
+    if (issueId.startsWith('heal-')) {
+        const hid = issueId.replace('heal-', '');
+        const row = db.prepare(`
+            SELECT hp.service_id, hp.issue_type, hp.explanation, hp.status,
+                   s.name AS service_name
+            FROM healing_prs hp JOIN services s ON s.id = hp.service_id
+            WHERE hp.id = ?
+        `).get(hid);
+        if (!row)
+            return null;
+        return {
+            serviceId: row.service_id,
+            serviceName: row.service_name,
+            severity: 'warning',
+            title: row.issue_type,
+            description: row.explanation,
+            category: 'quality',
+            file: null, line: null,
+            suggestedFix: null,
+            source: 'healing',
+        };
+    }
+    if (issueId.startsWith('inc-')) {
+        const iid = issueId.replace('inc-', '');
+        const row = db.prepare(`
+            SELECT i.service_id, i.severity, i.title, i.status, i.occurred_at,
+                   s.name AS service_name
+            FROM incidents i JOIN services s ON s.id = i.service_id
+            WHERE i.id = ?
+        `).get(iid);
+        if (!row)
+            return null;
+        return {
+            serviceId: row.service_id,
+            serviceName: row.service_name,
+            severity: row.severity,
+            title: row.title,
+            description: `${row.title} — ${row.status} since ${row.occurred_at}`,
+            category: 'reliability',
+            file: null, line: null,
+            suggestedFix: null,
+            source: 'incident',
+        };
+    }
+    // For agent-sourced issues, we need to look them up from the KG
+    // These are ephemeral IDs generated by getCriticalIssues(), so we
+    // accept the full issue payload from the frontend instead.
+    return null;
+}
+// ── Slack ─────────────────────────────────────────────────────────────────────
+async function sendSlackNotification(payload, issueOverride) {
+    const botToken = process.env.SLACK_BOT_TOKEN;
+    const issue = issueOverride ?? resolveIssueContext(payload.issueId);
+    const severityEmoji = {
+        critical: '🔴', warning: '🟡', info: '🔵',
+    };
+    const emoji = issue ? severityEmoji[issue.severity] ?? '⚪' : '⚪';
+    const blocks = [
+        {
+            type: 'header',
+            text: { type: 'plain_text', text: `${emoji} KA-CHOW Critical Issue Detected`, emoji: true },
+        },
+        {
+            type: 'section',
+            fields: [
+                { type: 'mrkdwn', text: `*Service:*\n${issue?.serviceName ?? 'Unknown'}` },
+                { type: 'mrkdwn', text: `*Severity:*\n${issue?.severity?.toUpperCase() ?? 'UNKNOWN'}` },
+                { type: 'mrkdwn', text: `*Category:*\n${issue?.category ?? 'N/A'}` },
+                { type: 'mrkdwn', text: `*Source:*\n${issue?.source ?? 'N/A'}` },
+            ],
+        },
+        {
+            type: 'section',
+            text: { type: 'mrkdwn', text: `*Issue:*\n${issue?.description ?? payload.issueId}` },
+        },
+    ];
+    if (issue?.file) {
+        blocks.push({
+            type: 'section',
+            text: { type: 'mrkdwn', text: `*File:* \`${issue.file}${issue.line ? `:${issue.line}` : ''}\`` },
+            fields: undefined,
+        });
+    }
+    if (issue?.suggestedFix) {
+        blocks.push({
+            type: 'section',
+            text: { type: 'mrkdwn', text: `*🔧 Suggested Fix:*\n${issue.suggestedFix}` },
+            fields: undefined,
+        });
+    }
+    if (payload.customMessage) {
+        blocks.push({
+            type: 'section',
+            text: { type: 'mrkdwn', text: payload.customMessage },
+            fields: undefined,
+        });
+    }
+    const slackBody = {
+        channel: payload.channel,
+        text: `${emoji} [KA-CHOW] ${issue?.severity?.toUpperCase()}: ${issue?.title ?? payload.issueId} in ${issue?.serviceName ?? 'unknown service'}`,
+        blocks,
+    };
+    // Log to activity feed regardless of webhook config
+    const db = (0, index_js_1.getDb)();
+    db.prepare(`
+        INSERT INTO activity_feed (id, type, title, detail, severity, service_id)
+        VALUES (?, 'SLACK_SENT', ?, ?, ?, ?)
+    `).run((0, crypto_1.randomUUID)(), `Slack notification: ${issue?.title ?? payload.issueId}`, `Sent to ${payload.channel ?? 'default channel'}`, issue?.severity ?? 'info', issue?.serviceId ?? null);
+    if (!botToken) {
+        // No bot token configured — return mock success so the frontend can still work
+        return {
+            sent: false,
+            channel: payload.channel ?? '#general',
+            message: slackBody.text,
+            webhookConfigured: false,
+        };
+    }
+    try {
+        const res = await fetch('https://slack.com/api/chat.postMessage', {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${botToken}`,
+                'Content-Type': 'application/json; charset=utf-8',
+            },
+            body: JSON.stringify({
+                channel: payload.channel ?? '#general',
+                text: slackBody.text,
+                blocks: slackBody.blocks,
+            }),
+        });
+        const data = await res.json();
+        if (!data.ok) {
+            console.error('[Slack] API error:', data.error);
+        }
+        return {
+            sent: !!data.ok,
+            channel: payload.channel ?? '#general',
+            message: slackBody.text,
+            webhookConfigured: true,
+        };
+    }
+    catch (e) {
+        console.error('[Slack] Send failed:', e);
+        return {
+            sent: false,
+            channel: payload.channel ?? '#general',
+            message: slackBody.text,
+            webhookConfigured: true,
+        };
+    }
+}
+// ── Jira ──────────────────────────────────────────────────────────────────────
+async function commentOrCreateJira(payload, issueOverride) {
+    const baseUrl = process.env.JIRA_BASE_URL;
+    const email = process.env.JIRA_EMAIL;
+    const token = process.env.JIRA_API_TOKEN;
+    const projectKey = process.env.JIRA_PROJECT_KEY ?? 'SCRUM';
+    const issue = issueOverride ?? resolveIssueContext(payload.issueId);
+    const db = (0, index_js_1.getDb)();
+    const title = issue?.title ?? payload.issueId;
+    const description = [
+        `*Service:* ${issue?.serviceName ?? 'Unknown'}`,
+        `*Severity:* ${issue?.severity?.toUpperCase() ?? 'UNKNOWN'}`,
+        `*Category:* ${issue?.category ?? 'N/A'}`,
+        `*Source:* ${issue?.source ?? 'N/A'}`,
+        '',
+        `*Description:*`,
+        issue?.description ?? 'No description available',
+        '',
+        issue?.file ? `*File:* ${issue.file}${issue.line ? `:${issue.line}` : ''}` : '',
+        issue?.suggestedFix ? `*Suggested Fix:* ${issue.suggestedFix}` : '',
+        '',
+        '_Auto-generated by KA-CHOW_',
+    ].filter(Boolean).join('\n');
+    // Log to activity feed regardless of Jira config
+    db.prepare(`
+        INSERT INTO activity_feed (id, type, title, detail, severity, service_id)
+        VALUES (?, 'JIRA_COMMENT', ?, ?, ?, ?)
+    `).run((0, crypto_1.randomUUID)(), `Jira ${payload.createNewTicket ? 'ticket' : 'comment'}: ${title}`, payload.jiraIssueKey ?? 'new ticket', issue?.severity ?? 'info', issue?.serviceId ?? null);
+    if (!baseUrl || !email || !token) {
+        // No Jira configured — return mock
+        const mockKey = payload.jiraIssueKey ?? `${projectKey}-${Math.floor(Math.random() * 999)}`;
+        return {
+            success: false,
+            jiraIssueKey: mockKey,
+            action: payload.createNewTicket ? 'created' : 'commented',
+            summary: `[KA-CHOW] ${issue?.severity?.toUpperCase()}: ${title}`,
+            url: null,
+        };
+    }
+    const headers = {
+        'Authorization': `Basic ${Buffer.from(`${email}:${token}`).toString('base64')}`,
+        'Content-Type': 'application/json',
+        'Accept': 'application/json',
+    };
+    try {
+        if (payload.createNewTicket || !payload.jiraIssueKey) {
+            // Create new issue
+            // Team-managed (next-gen) projects use Task; classic projects may have Bug.
+            // We try Task as the safe default since it's available in both project types.
+            const body = {
+                fields: {
+                    project: { key: projectKey },
+                    summary: `[KA-CHOW] ${issue?.severity?.toUpperCase()}: ${title} in ${issue?.serviceName ?? 'unknown'}`,
+                    description: {
+                        type: 'doc', version: 1,
+                        content: [{ type: 'paragraph', content: [{ type: 'text', text: description }] }],
+                    },
+                    issuetype: { name: 'Task' },
+                },
+            };
+            const res = await fetch(`${baseUrl}/rest/api/3/issue`, {
+                method: 'POST', headers, body: JSON.stringify(body),
+            });
+            const data = await res.json();
+            if (!res.ok) {
+                console.error('[Jira] Create issue failed:', res.status, JSON.stringify(data));
+            }
+            return {
+                success: res.ok,
+                jiraIssueKey: data.key ?? `${projectKey}-?`,
+                action: 'created',
+                summary: body.fields.summary,
+                url: data.key ? `${baseUrl}/browse/${data.key}` : null,
+            };
+        }
+        else {
+            // Comment on existing issue
+            const commentBody = {
+                body: {
+                    type: 'doc', version: 1,
+                    content: [{ type: 'paragraph', content: [{ type: 'text', text: description }] }],
+                },
+            };
+            const res = await fetch(`${baseUrl}/rest/api/3/issue/${payload.jiraIssueKey}/comment`, {
+                method: 'POST', headers, body: JSON.stringify(commentBody),
+            });
+            return {
+                success: res.ok,
+                jiraIssueKey: payload.jiraIssueKey,
+                action: 'commented',
+                summary: `Comment added to ${payload.jiraIssueKey}`,
+                url: `${baseUrl}/browse/${payload.jiraIssueKey}`,
+            };
+        }
+    }
+    catch (e) {
+        console.error('[Jira] API call failed:', e);
+        return {
+            success: false,
+            jiraIssueKey: payload.jiraIssueKey ?? `${projectKey}-?`,
+            action: payload.createNewTicket ? 'created' : 'commented',
+            summary: `Failed: ${e.message}`,
+            url: null,
+        };
+    }
+}
+//# sourceMappingURL=notificationService.js.map