#!/usr/bin/env tsx
/**
* Detector semanal de padrões sobre a BD Observabilidade (Fase 6A).
*
* Uso:
* sessions-patterns.ts [--week YYYY-Www] [--publish] [--force]
*
* Fluxo:
* 1. Resolver intervalo da semana (segunda 00:00 UTC → domingo 23:59 UTC)
* 2. Correr detectPatterns (6 detectores heurísticos)
* 3. Persistir com upsertPattern + consecutive_weeks
* 4. Se --publish: chamar gateway MCP (desk-crm) para publicar comentário HTML
* na discussão #32, e para padrões com consecutive_weeks>=3 e
* severity∈(warning,action) abrir Ticket no Desk.
* 5. Output JSON-line final com contagens.
*
* Env obrigatório com --publish:
* MCP_GATEWAY_TOKEN Bearer token do gateway MCP
* MCP_GATEWAY_URL URL do MCP desk-crm (default https://gateway.descomplicar.pt/v1/desk-crm/mcp)
*/
import { openSessionsDb, type PatternRecord } from '../services/sessions/db.js'
import { DEFAULT_DB_PATH } from '../services/sessions/indexer.js'
import {
detectPatterns,
toPatternRecord,
weekRange,
type Pattern,
} from '../services/sessions/patterns.js'
interface Args {
week?: string
publish: boolean
force: boolean
}
interface MCPToolCallResult {
content?: Array<{ type: string; text: string }>
isError?: boolean
}
/** Staff ID usado para publicar comentários automáticos (Observabilidade) */
const OBSERVABILIDADE_STAFF_ID = 25
/** Discussão Desk onde os resumos semanais são publicados */
const OBSERVABILIDADE_DISCUSSION_ID = 32
/** Departamento "Geral" no Desk CRM (id=1) */
const OBSERVABILIDADE_DEPARTMENT_ID = 1
function parseArgs(argv: string[]): Args {
const a: Args = { publish: false, force: false }
for (let i = 0; i < argv.length; i++) {
if (argv[i] === '--week') a.week = argv[++i]
else if (argv[i] === '--publish') a.publish = true
else if (argv[i] === '--force') a.force = true
}
return a
}
/** Converte YYYY-Www em intervalo {start,end} UTC. */
function weekIsoToRange(weekIsoStr: string): { start: Date; end: Date; iso: string } {
const m = weekIsoStr.match(/^(\d{4})-W(\d{2})$/)
if (!m) throw new Error(`Formato --week inválido: ${weekIsoStr}`)
const year = parseInt(m[1], 10)
const week = parseInt(m[2], 10)
// ISO week: quinta da semana 1 está sempre em 4 de Janeiro
const jan4 = new Date(Date.UTC(year, 0, 4))
const jan4Dow = jan4.getUTCDay() || 7 // 1..7 (seg..dom)
const mondayWeek1 = new Date(jan4)
mondayWeek1.setUTCDate(jan4.getUTCDate() - (jan4Dow - 1))
const monday = new Date(mondayWeek1)
monday.setUTCDate(mondayWeek1.getUTCDate() + (week - 1) * 7)
return weekRange(monday)
}
function escapeHtml(s: string): string {
return s.replace(/&/g, '&').replace(//g, '>').replace(/"/g, '"')
}
function buildDiscussionHtml(weekIso: string, patterns: PatternRecord[]): string {
const dateStr = new Date().toISOString().slice(0, 10)
const lines: string[] = []
lines.push(`
Semana ${weekIso} — Padrões Detectados Automaticamente
`)
lines.push(`Detector automático Observabilidade — ${patterns.length} padrões analisados.
`)
if (patterns.length === 0) {
lines.push('Nenhum padrão accionável detectado esta semana.
')
} else {
lines.push('Padrões (severity)
')
lines.push('')
for (const p of patterns) {
const samples = p.sample_session_ids
.slice(0, 5)
.map((id) => `${escapeHtml(id.slice(0, 8))}`)
.join(', ')
lines.push(
`- ${escapeHtml(p.title)} [${p.severity}] — ` +
`${p.affected_count} sessões` +
(p.metric_value != null ? `, métrica ${p.metric_value}` : '') +
`
Descrição: ${escapeHtml(p.description)}` +
`
Sample: ${samples}` +
`
Semanas consecutivas: ${p.consecutive_weeks} `,
)
}
lines.push('
')
}
lines.push('
')
lines.push(`Skill: observabilidade-patterns | Data: ${dateStr}
`)
return lines.join('\n')
}
/**
* Chama uma ferramenta do gateway MCP (JSON-RPC 2.0 sobre HTTP).
* O gateway pode responder em SSE (text/event-stream) ou JSON — tratamos ambos.
*/
async function callMcpTool(tool: string, args: Record): Promise {
const url = process.env.MCP_GATEWAY_URL ?? 'https://gateway.descomplicar.pt/v1/desk-crm/mcp'
const token = process.env.MCP_GATEWAY_TOKEN
if (!token) throw new Error('MCP_GATEWAY_TOKEN não definido')
const body = {
jsonrpc: '2.0',
id: Date.now(),
method: 'tools/call',
params: { name: tool, arguments: args },
}
const res = await fetch(url, {
method: 'POST',
headers: {
Authorization: `Bearer ${token}`,
'Content-Type': 'application/json',
Accept: 'application/json, text/event-stream',
},
body: JSON.stringify(body),
})
if (!res.ok) {
const txt = await res.text().catch(() => '')
throw new Error(`MCP gateway ${res.status}: ${txt.slice(0, 300)}`)
}
const raw = await res.text()
// Responde JSON puro ou SSE (linhas "data: {...}")
let payload: string | null = null
for (const line of raw.split(/\r?\n/)) {
const trimmed = line.trim()
if (!trimmed) continue
if (trimmed.startsWith('data: ')) {
payload = trimmed.slice(6)
break
}
if (trimmed.startsWith('{')) {
payload = trimmed
break
}
}
if (!payload) throw new Error(`MCP resposta sem payload JSON: ${raw.slice(0, 200)}`)
const parsed = JSON.parse(payload) as { error?: unknown; result?: MCPToolCallResult }
if (parsed.error) throw new Error(`MCP error: ${JSON.stringify(parsed.error)}`)
const result = parsed.result as MCPToolCallResult | undefined
if (result?.isError) {
const txt = result.content?.map((c) => c.text).join('\n') ?? ''
throw new Error(`MCP tool ${tool} devolveu isError: ${txt.slice(0, 300)}`)
}
return result ?? {}
}
async function postDeskDiscussionComment(html: string): Promise {
return callMcpTool('add_discussion_comment', {
discussion_id: OBSERVABILIDADE_DISCUSSION_ID,
content: html,
staff_id: OBSERVABILIDADE_STAFF_ID,
})
}
async function createDeskTicket(p: PatternRecord): Promise {
const priority = p.severity === 'action' ? 4 : 3 // 4=alta, 3=média
const message = [
`Padrão recorrente detectado automaticamente — ${p.consecutive_weeks} semanas consecutivas.
`,
`${escapeHtml(p.description)}
`,
``,
`- Pattern key:
${escapeHtml(p.pattern_key)} `,
`- Severity: ${p.severity}
`,
`- Affected: ${p.affected_count} sessões
`,
`- Metric: ${p.metric_value ?? 'n/a'}
`,
`- Week: ${p.week_iso}
`,
`
`,
`Sample sessions: ${p.sample_session_ids.map((s) => `${escapeHtml(s)}`).join(', ')}
`,
].join('\n')
return callMcpTool('create_ticket', {
subject: `Padrão recorrente: ${p.title}`,
message,
priority,
department: OBSERVABILIDADE_DEPARTMENT_ID,
})
}
async function main(): Promise {
const args = parseArgs(process.argv.slice(2))
if (args.publish && !process.env.MCP_GATEWAY_TOKEN) {
console.error('[patterns] --publish requer MCP_GATEWAY_TOKEN. Aborta.')
process.exit(1)
}
const dbPath = process.env.OBSERVABILIDADE_DB ?? DEFAULT_DB_PATH
const db = openSessionsDb(dbPath)
const range = args.week ? weekIsoToRange(args.week) : weekRange(new Date())
const weekIso = args.week ?? range.iso
console.error(`[patterns] semana ${weekIso} range=${range.start.toISOString()}..${range.end.toISOString()} db=${dbPath} publish=${args.publish}`)
const detected: Pattern[] = detectPatterns(db, range.start, range.end)
console.error(`[patterns] detectados ${detected.length} padrões`)
const records: PatternRecord[] = []
for (const p of detected) {
// Primeiro upsert com consecutive=1 (placeholder); depois recalcula.
const tmpRec = toPatternRecord(p, weekIso, 1)
db.upsertPattern(tmpRec)
const consecutive = db.getConsecutiveWeeks(p.pattern_key, weekIso)
const rec = toPatternRecord(p, weekIso, consecutive)
db.upsertPattern(rec)
records.push(rec)
}
// Ordenar por severity (action > warning > info) depois affected_count
const sevRank: Record = { action: 3, warning: 2, info: 1 }
records.sort((a, b) => (sevRank[b.severity] - sevRank[a.severity]) || (b.affected_count - a.affected_count))
let commentPosted = false
let ticketsCreated = 0
let publishError: string | null = null
if (args.publish) {
try {
const html = buildDiscussionHtml(weekIso, records)
await postDeskDiscussionComment(html)
commentPosted = true
for (const rec of records) {
if (rec.consecutive_weeks >= 3 && (rec.severity === 'warning' || rec.severity === 'action')) {
try {
await createDeskTicket(rec)
ticketsCreated++
} catch (e) {
console.error(`[patterns] falha ao criar ticket para ${rec.pattern_key}:`, (e as Error).message)
}
}
}
} catch (e) {
publishError = (e as Error).message
}
}
// Dry-run: render HTML para stderr para verificação manual
if (!args.publish) {
const html = buildDiscussionHtml(weekIso, records)
console.error('\n--- HTML (dry-run) ---')
console.error(html)
console.error('--- /HTML ---\n')
for (const rec of records) {
if (rec.consecutive_weeks >= 3 && (rec.severity === 'warning' || rec.severity === 'action')) {
console.error(`[patterns] (dry-run) Ticket seria criado: ${rec.title} — ${rec.consecutive_weeks} sem.`)
}
}
}
const summary = {
week_iso: weekIso,
range: { start: range.start.toISOString(), end: range.end.toISOString() },
detected: records.length,
by_severity: {
action: records.filter((r) => r.severity === 'action').length,
warning: records.filter((r) => r.severity === 'warning').length,
info: records.filter((r) => r.severity === 'info').length,
},
published: commentPosted,
tickets_created: ticketsCreated,
publish_error: publishError,
dry_run: !args.publish,
}
console.log(JSON.stringify(summary))
db.close()
}
main().catch((err) => {
console.error('[patterns] falha fatal:', err)
process.exit(2)
})