M0: compilable skeleton — Kigi 0.1.0 fork surgery

Hard fork of xai-org/grok-build (Apache-2.0) re-targeted as Kigi, an unofficial Kimi Code CLI community build. Rename & identity - 72 xai-*/xai-grok-* crates -> kigi-* (explicit: xai-grok-pager-bin -> kigi-bin [binary `kigi`], xai-grok-pager -> kigi-tui; rest mechanical); ptyctl, ptyctl-cli, third_party/ unchanged; proto package xai.grok.tools.v1 -> kigi.tools.v1 - Config home ~/.kigi (KIGI_SHARE_DIR override), env prefix GROK_* -> KIGI_*, `kigi --version` carries the unofficial-community-build notice - clap identity, help text, startup banner, prompt templates rebranded (templates re-encrypted) Deletions (PRD removal list #5/#6/#7/#9/#10) - voice input (xai-grok-voice) and all TUI wiring - telemetry: Mixpanel client, external OTel stream, Sentry, OTLP layers, trace/GCS/S3 upload queues (kigi-file-utils halved), workspace upload module & dc_log, heap-profile uploader, auth-diagnostics uploader, session-analytics halves of feedback; local zero-egress observability preserved in new kigi-log crate (unified log, --debug firehose, subsystem file logs, opt-in instrumentation) - announcements (crate, remote-settings fields, TUI surfaces) - plugin marketplace (crate, sources/browse/CTA/extensions-modal tab); direct plugin install/uninstall/update via kigi-agent git_install kept - relay/gateway/assets endpoints and features (agent relay, headless relay transport, gateway bridge, LeaderEnvUrls); leader IPC socket now ~/.kigi/leader.sock + KIGI_LEADER_SOCKET, no ws-url derivation - functional types rehomed instead of deleted: PermissionMode -> kigi-config-types, McpInitStrategy -> kigi-mcp, PrCreationSource -> session signals, TerminalDiagnostics -> kigi-pager-render, agent_id -> shell util Endpoints - kigi-env rewritten: single production KigiEndpoints {coding_api_base_url https://api.kimi.com/coding/v1 (KIGI_CODE_BASE_URL), oauth_host https://auth.kimi.com (KIGI_OAUTH_HOST), update_base_url (GitHub Releases API), upgrade_page_url}; GrokBuildEnvironment enum deleted Toolchain & workspace hygiene - Rust 1.97.0 pinned; edition 2024; full cargo update; git2 hoisted to workspace at 0.21 (Option->Result API migration), quick-xml 0.41 - Root Cargo.toml hand-maintained (PRD §8.1): version 0.1.0 inherited by all members, members sorted, unused deps pruned - cargo-deny advisories gate (deny.toml with documented transitive exceptions); CI workflow (check/clippy/fmt/deny/test, macOS+Linux) - cross-crate test seams re-gated behind `test-support` cargo feature; insta snapshot baselines renamed to the kigi_tui prefix - clippy --workspace --all-targets: zero warnings; fmt clean Fixes surfaced by the port - updater probe/installer divergence (bin/kigi vs bin/grok symlink set) - idle model-metadata refresh dead under KIGI_CODE_BASE_URL override (new is_effective_coding_endpoint_url, loopback+override aware) - macOS symlinked-TMPDIR fixture canonicalization (foreign_sessions, fast-worktree); RSS measurement tests serialized via serial_test Docs & legal (Apache §4) - NOTICE added (upstream attribution + change statement); THIRD-PARTY notices sustained; kigi-tools ported-code notices extended; README, CONTRIBUTING, SECURITY, AGENTS.md rewritten Out of scope for M0 (tracked): Kimi auth/inference (M1), search/fetch, command parity, config import (M2), Computer Hub excision & final brand-token sweep (M2), distribution & self-update rewrite (M3).
2026-07-17 05:31:01 -04:00
commit d6c20fc13f
2612 changed files with 1353757 additions and 0 deletions
@@ -0,0 +1,126 @@
+//! `x.ai/debug/*` extension handlers for local client testing.
+//!
+//! These methods bypass heuristics, sampling, cooldowns, and enabled checks
+//! so client engineers can exercise notification → response flows without
+//! needing real experiments, real sessions, or real model inference.
+//!
+//! - `trigger_feedback`: fire a synthetic `FeedbackRequestNotification`.
+//! - `arm_auto_compact`: arm the next turn to unconditionally trigger
+//!   auto-compaction, regardless of context window usage.
+
+use agent_client_protocol as acp;
+
+use super::{ExtResult, parse_params};
+use crate::agent::MvpAgent;
+use crate::session::{ExtMethodResult, SessionCommand};
+
+#[tracing::instrument(skip_all, fields(method = %args.method))]
+pub async fn handle(agent: &MvpAgent, args: &acp::ExtRequest) -> ExtResult {
+    match args.method.as_ref() {
+        "x.ai/debug/trigger_feedback" => {
+            tracing::info!("debug: triggering test feedback request");
+            handle_trigger_feedback(agent, args).await
+        }
+        "x.ai/debug/arm_auto_compact" => handle_arm_auto_compact(agent, args),
+        _ => Err(acp::Error::method_not_found()),
+    }
+}
+
+async fn handle_trigger_feedback(agent: &MvpAgent, args: &acp::ExtRequest) -> ExtResult {
+    use crate::session::feedback::{FeedbackMode, FeedbackTier};
+
+    #[derive(serde::Deserialize)]
+    #[serde(rename_all = "camelCase")]
+    struct DebugTriggerParams {
+        #[serde(alias = "session_id")]
+        session_id: String,
+        /// "tier1" | "tier2" | "tier3" (default: "tier1")
+        #[serde(default)]
+        tier: Option<String>,
+        /// "thumbs" | "stars" | "text" | "thumbs_text" | "stars_text" (default: "thumbs_text")
+        #[serde(default)]
+        mode: Option<String>,
+    }
+
+    let params: DebugTriggerParams = parse_params(args)?;
+
+    let tier = match params.tier.as_deref() {
+        Some("tier2") => FeedbackTier::Tier2,
+        Some("tier3") => FeedbackTier::Tier3,
+        Some("tier1") | None => FeedbackTier::Tier1,
+        Some(other) => {
+            return Err(acp::Error::invalid_params().data(format!(
+                "unknown tier: {other:?} (expected tier1/tier2/tier3)"
+            )));
+        }
+    };
+
+    let mode = match params.mode.as_deref() {
+        Some("thumbs") => FeedbackMode::Thumbs,
+        Some("stars") => FeedbackMode::Stars,
+        Some("text") => FeedbackMode::Text,
+        Some("stars_text") => FeedbackMode::StarsText,
+        Some("thumbs_text") | None => FeedbackMode::ThumbsText,
+        Some(other) => {
+            return Err(acp::Error::invalid_params().data(format!(
+                "unknown mode: {other:?} (expected thumbs/stars/text/thumbs_text/stars_text)"
+            )));
+        }
+    };
+
+    let session_id = acp::SessionId::new(params.session_id.clone());
+    let handle = agent
+        .sessions
+        .borrow()
+        .get(&session_id)
+        .cloned()
+        .ok_or_else(|| {
+            acp::Error::invalid_params().data(format!("session not found: {}", params.session_id))
+        })?;
+
+    let (tx, rx) = tokio::sync::oneshot::channel();
+    handle
+        .cmd_tx
+        .send(SessionCommand::TriggerTestFeedback {
+            tier,
+            mode,
+            respond_to: tx,
+        })
+        .map_err(|_| {
+            acp::Error::internal_error().data("failed to dispatch debug trigger to session")
+        })?;
+
+    rx.await
+        .map_err(|_| acp::Error::internal_error().data("session failed to respond"))?
+        .map_err(|e| acp::Error::internal_error().data(format!("Internal error: {e:?}")))
+}
+
+fn handle_arm_auto_compact(agent: &MvpAgent, args: &acp::ExtRequest) -> ExtResult {
+    let params: serde_json::Value = parse_params(args)?;
+
+    let session_id_str = params["sessionId"]
+        .as_str()
+        .or_else(|| params["session_id"].as_str())
+        .ok_or_else(|| acp::Error::invalid_params().data("sessionId required"))?;
+    let session_id = acp::SessionId::new(session_id_str);
+
+    let handle = agent
+        .sessions
+        .borrow()
+        .get(&session_id)
+        .cloned()
+        .ok_or_else(|| acp::Error::invalid_params().data("unknown session id"))?;
+
+    handle
+        .force_compact
+        .store(true, std::sync::atomic::Ordering::Relaxed);
+
+    tracing::info!(
+        session_id = %session_id_str,
+        "debug: armed auto-compact for next turn"
+    );
+
+    ExtMethodResult::success(serde_json::json!({ "armed": true }))
+        .to_ext_response()
+        .map_err(|e| acp::Error::internal_error().data(e.to_string()))
+}