KeiSeiKit-1.0/_primitives/_rust/kei-buddy/src/bin/kei-buddy-tick.rs
Parfii-bot 3f2aa1189b feat(kei-buddy fleet): 5 atomics — google/apple contacts + classifier + tick + slash-commands
Parallel agent batch. All five tasks delivered functional + tested.
NOT deployed — user is in live conversation with the bot.

## Crates added (2 new)

### kei-contacts-google (466 LOC, 5 tests)
Thin Google People API client. Takes pre-acquired access_token from
kei-auth-google's OAuth flow; calls /v1/people/me/connections?personFields=...,
parses 200-entry first page (TODO: pagination via nextPageToken), maps
to kei_social_store::Person. Errors: Http / Auth(401) / Parse.

### kei-contacts-apple (593 LOC, 7 tests + 1 doc-test)
CardDAV client for iCloud Contacts using Basic Auth (Apple ID +
app-specific password). Sends REPORT with addressbook-query XML body,
parses multistatus → embedded vCards → AppleContact. Tiny vCard
parser (~150 LOC) handles FN/N/EMAIL/TEL/ORG/NOTE/UID, single-line
only (no line-folding for MVP). Discovery (PROPFIND .well-known/carddav
→ principal → addressbook-home-set) deferred — user supplies
addressbook URL via with_addressbook_url().

Both crates registered in workspace members.

## kei-buddy crate additions

### src/topic_classify.rs (116 LOC, 3 tests)
Free fn classify_and_store_topic(extractor, topics, chat_id, text)
called from process_text when state == OnboardState::Ready. Builds
classifier prompt → LLM → parses {slug, title} → validates slug
shape (kebab-case, ascii) → Topics::add_topic + add_digest. All
failure paths log + return; conversation never blocks.

### src/tick.rs (188 LOC, 3 integration tests) + src/bin/kei-buddy-tick.rs (67 LOC)
Second binary. Oneshot CLI for systemd timer: walks all known
chat_ids in BuddyStore → lists topics → searches recent chat
messages per topic (configurable window/limit) → LLM digest →
Topics::add_digest. Outputs JSON TickReport to stdout. Env-driven
config. NoOpExtractor fallback when no LLM creds (graceful degradation).

### src/commands.rs (146 LOC) + src/command_exec.rs (111 LOC, 7 tests)
Slash-commands intercepted BEFORE handle_step in process_text:
  /whois <name>   contacts.search_contacts + common_connections for hits
  /find <q>       chat_log.search scoped to chat_id
  /topics         topics.list_topics
  /contacts       contacts.search_contacts("", 10)
  /help           static usage text (Russian)
If command parsed, response built from stores, sent, logged to
chat_log — FSM skipped for that turn.

### src/serve_runner.rs (69 LOC) — refactor
run_serve + start_listener + init_tracing extracted out of serve.rs
to bring serve.rs back to 189 LOC (was 248 after previous wave).

### Wiring
BuddyContext gains `contacts: Arc<Contacts>` and `topics: Arc<Topics>`.
ServeConfig gains contacts_db_path + topics_db_path. Binary reads
KEI_BUDDY_CONTACTS_DB_PATH + KEI_BUDDY_TOPICS_DB_PATH env (defaults
./kei-buddy-contacts.db, ./kei-buddy-topics.db). cmd_migrate applies
schema for all three side-stores (chat_log + contacts + topics).

## Verify-before-commit (RULE 0.13 §)
  * cargo check -p kei-buddy (default + extractor-openai): PASS
  * cargo test -p kei-buddy --lib: 41 passed / 0 failed (was 31)
  * cargo test -p kei-buddy --tests: 3 passed (tick integration)
  * cargo build -p kei-buddy --features extractor-openai: PASS
    (builds both kei-buddy + kei-buddy-tick binaries)
  * cargo check -p kei-contacts-google: PASS (5 tests)
  * cargo check -p kei-contacts-apple: PASS (7 + 1 doc)
  * cargo check --workspace: PASS

## STATUS-TRUTH from all 5 agents: shipped=functional, behaviour-verified=yes

## Follow-up (deferred, non-blocking)
  * Google People API pagination (nextPageToken loop) — first 200 only
  * CardDAV auto-discovery (PROPFIND .well-known/carddav)
  * vCard line-folding (RFC 6350 §3.2)
  * Wire kei-contacts-google + kei-contacts-apple → Contacts.add_contact
    sync command (no glue yet)
  * systemd timer file for kei-buddy-tick (not shipped here — config only)
2026-05-12 16:33:58 +08:00

67 lines
2.1 KiB
Rust

// SPDX-License-Identifier: Apache-2.0
//! `kei-buddy-tick` — oneshot digest-generation binary.
//!
//! Meant for systemd timer / cron. Reads env, calls `run_tick`,
//! prints JSON report to stdout, exits 0.
use kei_buddy::{run_tick, TickConfig};
#[tokio::main]
async fn main() {
init_log();
let cfg = cfg_from_env();
match run_tick(cfg).await {
Ok(report) => {
let out = serde_json::json!({
"topics_processed": report.topics_processed,
"digests_created": report.digests_created,
"errors": report.errors,
});
println!("{}", out);
}
Err(e) => {
let out = serde_json::json!({
"fatal": e.to_string(),
"topics_processed": 0,
"digests_created": 0,
"errors": [e.to_string()],
});
// Print to stdout so callers can parse; fatal still exits 0.
println!("{}", out);
}
}
}
fn cfg_from_env() -> TickConfig {
TickConfig {
buddy_db_path: env_or("KEI_BUDDY_DB_PATH", "./kei-buddy.db"),
chat_log_db_path: env_or("KEI_BUDDY_CHAT_LOG_PATH", "./kei-buddy-chat.db"),
topics_db_path: env_or("KEI_BUDDY_TOPICS_DB_PATH", "./kei-buddy-topics.db"),
since_hours: env_i64("KEI_BUDDY_TICK_SINCE_HOURS", 24),
max_messages_per_topic: env_i64("KEI_BUDDY_TICK_MAX_MESSAGES", 50),
llm_proxy_url: std::env::var("KEI_BUDDY_LLM_PROXY").ok(),
llm_api_key: std::env::var("KEI_BUDDY_LLM_KEY")
.ok()
.or_else(|| std::env::var("OPENAI_API_KEY").ok()),
llm_model: std::env::var("KEI_BUDDY_LLM_MODEL").ok(),
}
}
fn env_or(name: &str, default: &str) -> String {
std::env::var(name).unwrap_or_else(|_| default.to_string())
}
fn env_i64(name: &str, default: i64) -> i64 {
std::env::var(name)
.ok()
.and_then(|v| v.parse().ok())
.unwrap_or(default)
}
fn init_log() {
#[cfg(feature = "serve")]
{
use tracing_subscriber::{fmt, EnvFilter};
let _ = fmt().with_env_filter(EnvFilter::from_default_env()).try_init();
}
}