feat: add /help, /history, /uptime commands and enhance /status

- /help: detailed guide with examples for all commands
- /status: overall indicator, emoji markers, updated time, status page link
- /history [count]: recent incidents with impact, dates, links (max 10)
- /uptime: component health with last change time
- Split info commands into bot-info-commands.js for modularity
- Register all 7 commands in bot-setup.js
This commit is contained in:
2026-04-08 23:41:53 +07:00
parent 37c2a01677
commit 30ffaae612
6 changed files with 209 additions and 35 deletions

118
src/bot-info-commands.js Normal file
View File

@@ -0,0 +1,118 @@
import {
fetchComponentByName,
fetchSummary,
fetchIncidents,
formatComponentLine,
formatOverallStatus,
formatIncidentLine,
statusIndicator,
humanizeStatus,
STATUS_URL,
} from "./status-fetcher.js";
/**
* Register info commands: /help, /status, /history, /uptime
*/
export function registerInfoCommands(bot) {
bot.command("help", async (ctx) => {
await ctx.reply(
`<b>Claude Status Bot — Help</b>\n\n` +
`<b>/start</b>\n` +
`Subscribe to Claude status notifications.\n` +
`Default: incidents + component updates.\n\n` +
`<b>/stop</b>\n` +
`Unsubscribe from all notifications.\n\n` +
`<b>/status</b> [component]\n` +
`Show current status of all components.\n` +
`Add a component name for a specific check.\n` +
`Example: <code>/status api</code>\n\n` +
`<b>/subscribe</b> &lt;type&gt;\n` +
`Set what notifications you receive.\n` +
`Options: <code>incident</code>, <code>component</code>, <code>all</code>\n` +
`Example: <code>/subscribe incident</code>\n\n` +
`<b>/history</b> [count]\n` +
`Show recent incidents. Default: 5, max: 10.\n` +
`Example: <code>/history 3</code>\n\n` +
`<b>/uptime</b>\n` +
`Show current component health overview.\n\n` +
`<a href="${STATUS_URL}">status.claude.com</a>`,
{ parse_mode: "HTML", disable_web_page_preview: true }
);
});
bot.command("status", async (ctx) => {
const args = ctx.match?.trim();
try {
if (args) {
const component = await fetchComponentByName(args);
if (!component) {
await ctx.reply(`Component "<code>${args}</code>" not found.`, { parse_mode: "HTML" });
return;
}
await ctx.reply(formatComponentLine(component), { parse_mode: "HTML" });
} else {
const summary = await fetchSummary();
const components = summary.components.filter((c) => !c.group);
const overall = formatOverallStatus(summary.status.indicator);
const lines = components.map(formatComponentLine);
const updated = new Date(summary.page.updated_at).toLocaleString("en-US", {
dateStyle: "medium", timeStyle: "short", timeZone: "UTC",
});
await ctx.reply(
`<b>${overall}</b>\n\n` +
`${lines.join("\n")}\n\n` +
`<i>Updated: ${updated} UTC</i>\n` +
`<a href="${STATUS_URL}">View full status page</a>`,
{ parse_mode: "HTML", disable_web_page_preview: true }
);
}
} catch {
await ctx.reply("Unable to fetch status. Please try again later.");
}
});
bot.command("history", async (ctx) => {
const arg = ctx.match?.trim();
const count = Math.min(Math.max(parseInt(arg, 10) || 5, 1), 10);
try {
const incidents = await fetchIncidents(count);
if (incidents.length === 0) {
await ctx.reply("No recent incidents found.", { parse_mode: "HTML" });
return;
}
const lines = incidents.map(formatIncidentLine);
await ctx.reply(
`<b>Recent Incidents</b>\n\n` +
`${lines.join("\n\n")}\n\n` +
`<a href="${STATUS_URL}/history">View full history</a>`,
{ parse_mode: "HTML", disable_web_page_preview: true }
);
} catch {
await ctx.reply("Unable to fetch incident history. Please try again later.");
}
});
bot.command("uptime", async (ctx) => {
try {
const summary = await fetchSummary();
const components = summary.components.filter((c) => !c.group);
const overall = formatOverallStatus(summary.status.indicator);
const lines = components.map((c) => {
const indicator = statusIndicator(c.status);
const upSince = new Date(c.updated_at).toLocaleString("en-US", {
dateStyle: "medium", timeStyle: "short", timeZone: "UTC",
});
return `${indicator} <b>${c.name}</b>\n Status: <code>${humanizeStatus(c.status)}</code>\n Last change: ${upSince} UTC`;
});
await ctx.reply(
`<b>${overall}</b>\n\n` +
`${lines.join("\n\n")}\n\n` +
`<i>Uptime % not available via public API.</i>\n` +
`<a href="${STATUS_URL}">View uptime on status page</a>`,
{ parse_mode: "HTML", disable_web_page_preview: true }
);
} catch {
await ctx.reply("Unable to fetch uptime data. Please try again later.");
}
});
}