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,375 @@
+use std::path::{Path, PathBuf};
+
+const EXCLUDED_DIR_NAMES: &[&str] = &[
+    ".kigi", ".cache", ".daemon", ".config", ".npm", ".cargo", ".rustup", ".vscode", ".gemini",
+    ".hermes", ".claude",
+];
+
+fn known_os_dirs() -> Vec<PathBuf> {
+    [
+        dirs::desktop_dir(),
+        dirs::download_dir(),
+        dirs::document_dir(),
+        dirs::audio_dir(),
+        dirs::video_dir(),
+        dirs::picture_dir(),
+        dirs::public_dir(),
+    ]
+    .into_iter()
+    .flatten()
+    .collect()
+}
+
+pub fn is_project_dir(cwd: &Path) -> bool {
+    if cwd.as_os_str().is_empty() || cwd.parent().is_none() {
+        return false;
+    }
+
+    if cwd.ancestors().any(|p| p.join(".git").exists()) {
+        return true;
+    }
+
+    if has_excluded_component(cwd) {
+        return false;
+    }
+
+    if is_platform_system_dir(cwd) {
+        return false;
+    }
+
+    let Some(home) = dirs::home_dir() else {
+        return false;
+    };
+
+    if cwd == home {
+        return false;
+    }
+
+    if is_platform_home_excluded(cwd, &home) {
+        return false;
+    }
+
+    if known_os_dirs().iter().any(|d| cwd == d) {
+        return false;
+    }
+
+    true
+}
+
+#[cfg(not(target_os = "windows"))]
+fn is_platform_system_dir(cwd: &Path) -> bool {
+    if cwd == Path::new("/tmp")
+        || cwd.starts_with("/tmp/")
+        || cwd == Path::new("/var/tmp")
+        || cwd.starts_with("/var/tmp/")
+        || cwd.starts_with("/var/folders/")
+    {
+        return true;
+    }
+
+    #[cfg(target_os = "macos")]
+    if cwd == Path::new("/private/tmp")
+        || cwd.starts_with("/private/tmp/")
+        || cwd == Path::new("/private/var/tmp")
+        || cwd.starts_with("/private/var/tmp/")
+        || cwd.starts_with("/private/var/folders/")
+    {
+        return true;
+    }
+
+    #[cfg(target_os = "linux")]
+    if cwd == Path::new("/root") {
+        return true;
+    }
+
+    false
+}
+
+#[cfg(target_os = "windows")]
+fn is_platform_system_dir(cwd: &Path) -> bool {
+    if let Ok(temp) = std::env::var("TEMP").or_else(|_| std::env::var("TMP")) {
+        if cwd.starts_with(&temp) {
+            return true;
+        }
+    }
+
+    let path_lower = cwd.to_string_lossy().to_lowercase();
+    if path_lower.contains("\\windows\\")
+        || path_lower.ends_with("\\windows")
+        || path_lower.contains("\\program files")
+    {
+        return true;
+    }
+
+    if cwd.parent().map_or(false, |p| p.parent().is_none()) && cwd.to_string_lossy().len() <= 3 {
+        return true;
+    }
+
+    false
+}
+
+#[cfg(target_os = "macos")]
+fn is_platform_home_excluded(cwd: &Path, home: &Path) -> bool {
+    if cwd.starts_with(home.join("Library"))
+        && !cwd.starts_with(home.join("Library/Mobile Documents"))
+    {
+        return true;
+    }
+    false
+}
+
+#[cfg(target_os = "linux")]
+fn is_platform_home_excluded(cwd: &Path, home: &Path) -> bool {
+    let Ok(relative) = cwd.strip_prefix(home) else {
+        return false;
+    };
+    if relative.components().count() != 1 {
+        return false;
+    }
+    let Some(std::path::Component::Normal(name)) = relative.components().next() else {
+        return false;
+    };
+    let name = name.to_string_lossy().to_lowercase();
+    [
+        "desktop",
+        "downloads",
+        "documents",
+        "pictures",
+        "music",
+        "videos",
+    ]
+    .contains(&name.as_str())
+}
+
+#[cfg(target_os = "windows")]
+fn is_platform_home_excluded(_cwd: &Path, _home: &Path) -> bool {
+    false
+}
+
+fn has_excluded_component(path: &Path) -> bool {
+    for component in path.components() {
+        if let std::path::Component::Normal(name) = component {
+            let name_lower = name.to_string_lossy().to_lowercase();
+
+            if EXCLUDED_DIR_NAMES.contains(&name_lower.as_str()) {
+                return true;
+            }
+
+            if name_lower.starts_with(".kigi-") {
+                return true;
+            }
+        }
+    }
+    false
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[cfg(not(target_os = "windows"))]
+    mod posix {
+        use super::*;
+
+        #[test]
+        fn root_is_unsafe() {
+            assert!(!is_project_dir(Path::new("/")));
+        }
+
+        #[test]
+        fn tmp_is_unsafe() {
+            assert!(!is_project_dir(Path::new("/tmp")));
+            assert!(!is_project_dir(Path::new("/tmp/scratch")));
+        }
+
+        #[test]
+        fn tmp_prefix_not_greedy() {
+            assert!(is_project_dir(Path::new("/tmpdata/foo")));
+        }
+
+        #[test]
+        fn var_folders_is_unsafe() {
+            assert!(!is_project_dir(Path::new("/var/folders/ab/cd")));
+        }
+
+        #[test]
+        fn deep_project_is_safe() {
+            assert!(is_project_dir(Path::new("/Users/someone/my-project/src")));
+        }
+
+        #[test]
+        fn home_subdir_is_safe() {
+            assert!(is_project_dir(Path::new("/Users/someone/my-project")));
+        }
+    }
+
+    #[cfg(target_os = "macos")]
+    mod macos {
+        use super::*;
+
+        #[test]
+        fn private_tmp_is_unsafe() {
+            assert!(!is_project_dir(Path::new("/private/tmp")));
+            assert!(!is_project_dir(Path::new("/private/tmp/scratch")));
+            assert!(!is_project_dir(Path::new("/private/var/folders/ab/cd")));
+        }
+
+        #[test]
+        fn library_is_unsafe() {
+            if let Some(home) = dirs::home_dir() {
+                assert!(!is_project_dir(&home.join("Library")));
+                assert!(!is_project_dir(&home.join("Library/Caches")));
+                assert!(!is_project_dir(&home.join("Library/Application Support")));
+            }
+        }
+
+        #[test]
+        fn icloud_drive_projects_are_safe() {
+            if let Some(home) = dirs::home_dir() {
+                assert!(is_project_dir(&home.join(
+                    "Library/Mobile Documents/com~apple~CloudDocs/Projects/my-app"
+                )));
+            }
+        }
+    }
+
+    #[cfg(target_os = "linux")]
+    mod linux {
+        use super::*;
+
+        #[test]
+        fn bare_root_is_unsafe() {
+            assert!(!is_project_dir(Path::new("/root")));
+        }
+
+        #[test]
+        fn root_project_is_safe() {
+            assert!(is_project_dir(Path::new("/root/my-project")));
+        }
+    }
+
+    mod config_and_cache {
+        use super::*;
+
+        #[test]
+        fn grok_dirs_are_unsafe() {
+            if let Some(home) = dirs::home_dir() {
+                assert!(!is_project_dir(&home.join(".kigi")));
+                assert!(!is_project_dir(&home.join(".kigi/bin")));
+            }
+        }
+
+        #[test]
+        fn grok_prefixed_dirs_are_unsafe() {
+            if let Some(home) = dirs::home_dir() {
+                assert!(!is_project_dir(&home.join(".kigi-proxy-work")));
+            }
+        }
+
+        #[test]
+        fn cache_dirs_are_unsafe() {
+            if let Some(home) = dirs::home_dir() {
+                assert!(!is_project_dir(&home.join(".cache/zoe-proc")));
+                assert!(!is_project_dir(&home.join(".config/nvim")));
+            }
+        }
+
+        #[test]
+        fn other_ai_tool_dirs_are_unsafe() {
+            if let Some(home) = dirs::home_dir() {
+                assert!(!is_project_dir(&home.join(".gemini/antigravity")));
+                assert!(!is_project_dir(&home.join(".hermes/kanban")));
+                assert!(!is_project_dir(&home.join(".claude/projects")));
+            }
+        }
+    }
+
+    mod home_and_os_dirs {
+        use super::*;
+
+        #[test]
+        fn home_is_unsafe() {
+            if let Some(home) = dirs::home_dir() {
+                assert!(!is_project_dir(&home));
+            }
+        }
+
+        #[test]
+        fn home_project_is_safe() {
+            if let Some(home) = dirs::home_dir() {
+                assert!(is_project_dir(&home.join("my-project")));
+            }
+        }
+
+        #[test]
+        fn bare_desktop_is_unsafe() {
+            if let Some(d) = dirs::desktop_dir() {
+                assert!(!is_project_dir(&d));
+            }
+        }
+
+        #[test]
+        fn desktop_project_is_safe() {
+            if let Some(d) = dirs::desktop_dir() {
+                assert!(is_project_dir(&d.join("my-project")));
+            }
+        }
+
+        #[test]
+        fn bare_downloads_is_unsafe() {
+            if let Some(d) = dirs::download_dir() {
+                assert!(!is_project_dir(&d));
+            }
+        }
+
+        #[test]
+        fn bare_documents_is_unsafe() {
+            if let Some(d) = dirs::document_dir() {
+                assert!(!is_project_dir(&d));
+            }
+        }
+    }
+
+    mod edge_cases {
+        use super::*;
+
+        #[test]
+        fn empty_path_is_unsafe() {
+            assert!(!is_project_dir(Path::new("")));
+        }
+
+        #[cfg(not(target_os = "windows"))]
+        #[test]
+        fn unicode_paths_work() {
+            assert!(is_project_dir(Path::new(
+                "/Users/me/code/\u{D3F4}\u{B9AC}\u{B9C8}\u{CF13}"
+            )));
+        }
+
+        #[cfg(not(target_os = "windows"))]
+        #[test]
+        fn spaces_work() {
+            assert!(is_project_dir(Path::new("/Users/me/My Projects/cool app")));
+        }
+    }
+
+    mod git_detection {
+        use super::*;
+
+        #[test]
+        fn inside_git_repo_is_safe() {
+            let tmp = tempfile::tempdir().unwrap();
+            std::fs::create_dir(tmp.path().join(".git")).unwrap();
+            assert!(is_project_dir(tmp.path()));
+        }
+
+        #[test]
+        fn subdirectory_of_git_repo_is_safe() {
+            let tmp = tempfile::tempdir().unwrap();
+            std::fs::create_dir(tmp.path().join(".git")).unwrap();
+            let sub = tmp.path().join("deep/sub/dir");
+            std::fs::create_dir_all(&sub).unwrap();
+            assert!(is_project_dir(&sub));
+        }
+    }
+}