Jean
fcca8e4e3b
Each service now exposes its help catalog via Service::help_topics; the engine collects them into a network-wide index on Network, reachable through two new NetView methods. HelpServ uses it: HELP <service> [command] (or a bare service name) serves any service's per-command help, bare HELP lists the services, and its own ticket commands still work. No cross-crate dependency: the catalog flows through the SDK's NetView, keeping every module dependent only on echo-api.
64 lines
2.6 KiB
Rust
64 lines
2.6 KiB
Rust
//! ChanFix helps recover an opless channel. The engine continuously scores
|
|
//! op-time per identity from live network state; ChanFix reads those scores to
|
|
//! reop the channel's trusted regulars. It **defers to ChanServ**: a registered
|
|
//! channel is ChanServ's job, so ChanFix refuses to touch one. Operator-only.
|
|
//!
|
|
//! SCORES <#channel> shows the standings; CHANFIX <#channel> performs the fix.
|
|
//! `lib.rs` holds the dispatcher; each command lives in its own file.
|
|
|
|
use echo_api::{HelpEntry, NetView, Sender, Service, ServiceCtx, Store};
|
|
|
|
#[path = "scores.rs"]
|
|
mod scores;
|
|
#[path = "fix.rs"]
|
|
mod fix;
|
|
|
|
const BLURB: &str = "ChanFix recovers opless channels from accumulated op-time. It defers to ChanServ and won't touch a registered channel. Operator-only.";
|
|
|
|
const TOPICS: &[HelpEntry] = &[
|
|
HelpEntry {
|
|
cmd: "SCORES",
|
|
summary: "show a channel's op-time standings",
|
|
detail: "Syntax: \x02SCORES <#channel>\x02\nShows the accumulated op-time scores, highest first. These are the identities ChanFix would reop.",
|
|
},
|
|
HelpEntry {
|
|
cmd: "CHANFIX",
|
|
summary: "reop a channel's trusted regulars",
|
|
detail: "Syntax: \x02CHANFIX <#channel>\x02\nReops the present regulars of an opless channel by their accumulated op-time. Needs the channel opless (under three ops) with real history, and refuses a ChanServ-registered channel.",
|
|
},
|
|
];
|
|
|
|
pub struct ChanFix {
|
|
pub uid: String,
|
|
}
|
|
|
|
impl Service for ChanFix {
|
|
fn nick(&self) -> &str {
|
|
"ChanFix"
|
|
}
|
|
fn uid(&self) -> &str {
|
|
&self.uid
|
|
}
|
|
fn gecos(&self) -> &str {
|
|
"Channel Fixer"
|
|
}
|
|
|
|
fn help_topics(&self) -> (&'static str, &'static [HelpEntry]) {
|
|
(BLURB, TOPICS)
|
|
}
|
|
|
|
fn on_command(&mut self, from: &Sender, args: &[&str], ctx: &mut ServiceCtx, net: &dyn NetView, db: &mut dyn Store) {
|
|
let me = self.uid.as_str();
|
|
// The whole service is operator-only.
|
|
if !from.privs.any() {
|
|
ctx.notice(me, from.uid, "Access denied — ChanFix is for services operators.");
|
|
return;
|
|
}
|
|
match args.first().map(|s| s.to_ascii_uppercase()).as_deref() {
|
|
Some("SCORES") => scores::handle(me, from, args.get(1).copied(), ctx, net),
|
|
Some("CHANFIX") | Some("FIX") => fix::handle(me, from, args.get(1).copied(), ctx, net, db),
|
|
Some("HELP") | None => echo_api::help(me, from, ctx, BLURB, TOPICS, args.get(1).copied()),
|
|
Some(other) => ctx.notice(me, from.uid, format!("I don't know \x02{other}\x02. Try \x02SCORES\x02 or \x02CHANFIX\x02 <#channel>.")),
|
|
}
|
|
}
|
|
}
|