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,116 @@
+//! Build a `memory.tar.gz` archive containing session logs and MEMORY.md files.
+//!
+//! The archive is uploaded to GCS at session finalize time. The reconstruct
+//! pipeline injects these into the Docker image for full replay fidelity.
+
+use anyhow::{Context, Result};
+
+use super::MemoryStorage;
+
+/// Build a `memory.tar.gz` archive with session logs and MEMORY.md files.
+pub fn build_memory_archive(storage: &MemoryStorage) -> Result<Vec<u8>> {
+    use flate2::Compression;
+    use flate2::write::GzEncoder;
+
+    let buf = Vec::new();
+    let enc = GzEncoder::new(buf, Compression::default());
+    let mut ar = tar::Builder::new(enc);
+
+    // Session logs
+    let sessions_dir = storage.workspace_dir().join("sessions");
+    if sessions_dir.is_dir() {
+        for entry in std::fs::read_dir(&sessions_dir)
+            .context("read sessions dir")?
+            .flatten()
+        {
+            let path = entry.path();
+            if path.extension().and_then(|e| e.to_str()) == Some("md") {
+                let name = format!("workspace/sessions/{}", entry.file_name().to_string_lossy());
+                ar.append_path_with_name(&path, &name)
+                    .with_context(|| format!("archive {name}"))?;
+            }
+        }
+    }
+
+    // MEMORY.md files
+    let global_mem = storage.global_memory_file();
+    if global_mem.is_file() {
+        ar.append_path_with_name(&global_mem, "global/MEMORY.md")
+            .context("archive global MEMORY.md")?;
+    }
+
+    let workspace_mem = storage.workspace_memory_file();
+    if workspace_mem.is_file() {
+        let ws_dir_name = storage
+            .workspace_dir()
+            .file_name()
+            .and_then(|n| n.to_str())
+            .unwrap_or("workspace");
+        let archive_path = format!("{ws_dir_name}/MEMORY.md");
+        ar.append_path_with_name(&workspace_mem, &archive_path)
+            .context("archive workspace MEMORY.md")?;
+    }
+
+    let enc = ar.into_inner().context("finalize tar")?;
+    enc.finish().context("compress tar.gz")
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use tempfile::TempDir;
+
+    fn test_storage(tmp: &TempDir) -> MemoryStorage {
+        let global = tmp.path().join("memory");
+        let workspace = global.join("test_ws");
+        MemoryStorage::with_paths(global, workspace)
+    }
+
+    #[test]
+    fn test_build_empty_archive() {
+        let tmp = TempDir::new().unwrap();
+        let storage = test_storage(&tmp);
+        let archive = build_memory_archive(&storage).unwrap();
+        assert!(!archive.is_empty());
+    }
+
+    #[test]
+    fn test_build_archive_with_files() {
+        let tmp = TempDir::new().unwrap();
+        let storage = test_storage(&tmp);
+        storage.ensure_initialized().unwrap();
+        storage
+            .write_daily_log("2026-03-09", "test", "sess12345678", "# Test", false)
+            .unwrap();
+
+        let archive = build_memory_archive(&storage).unwrap();
+        assert!(archive.len() > 100);
+    }
+
+    #[test]
+    fn test_build_archive_includes_memory_md() {
+        let tmp = TempDir::new().unwrap();
+        let storage = test_storage(&tmp);
+        storage.ensure_initialized().unwrap();
+
+        std::fs::write(storage.global_memory_file(), "# Global Memory").unwrap();
+        std::fs::write(storage.workspace_memory_file(), "# Workspace Memory").unwrap();
+
+        let archive = build_memory_archive(&storage).unwrap();
+        let entries = tar_entry_names(&archive);
+        assert!(entries.contains(&"global/MEMORY.md".to_string()));
+        assert!(entries.contains(&"test_ws/MEMORY.md".to_string()));
+    }
+
+    fn tar_entry_names(gz_bytes: &[u8]) -> Vec<String> {
+        use flate2::read::GzDecoder;
+        let decoder = GzDecoder::new(gz_bytes);
+        let mut archive = tar::Archive::new(decoder);
+        archive
+            .entries()
+            .unwrap()
+            .filter_map(|e| e.ok())
+            .map(|e| e.path().unwrap().display().to_string())
+            .collect()
+    }
+}