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,180 @@
+//! Node types for the ScopeGraph.
+
+use std::sync::Arc;
+
+use serde::{Deserialize, Serialize};
+
+use crate::types::Range;
+
+/// A symbol extracted from the code.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Symbol {
+    /// The kind/type of symbol (e.g., "function", "class", etc.)
+    pub kind: Arc<str>,
+    /// The range where the symbol appears.
+    pub range: Range,
+}
+
+impl Symbol {
+    /// Create a new symbol.
+    pub fn new(kind: Arc<str>, range: Range) -> Self {
+        Self { kind, range }
+    }
+}
+
+/// An opaque identifier for every symbol in a language.
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Hash)]
+pub struct SymbolId {
+    /// Index into the namespace array.
+    pub namespace_idx: usize,
+    /// Index within the namespace.
+    pub symbol_idx: usize,
+}
+
+impl SymbolId {
+    /// Create a new symbol ID.
+    pub fn new(namespace_idx: usize, symbol_idx: usize) -> Self {
+        Self {
+            namespace_idx,
+            symbol_idx,
+        }
+    }
+
+    /// Get the symbol name from the namespaces.
+    pub fn name<'a>(&self, namespaces: &'a [Vec<String>]) -> Option<&'a str> {
+        namespaces
+            .get(self.namespace_idx)
+            .and_then(|ns| ns.get(self.symbol_idx))
+            .map(|s| s.as_str())
+    }
+}
+
+/// A local scope in the source code.
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Hash, Eq)]
+pub struct LocalScope {
+    /// The range of this scope.
+    pub range: Range,
+}
+
+impl LocalScope {
+    /// Create a new local scope.
+    pub fn new(range: Range) -> Self {
+        Self { range }
+    }
+}
+
+/// A local definition in the source code.
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq, Hash)]
+pub struct LocalDef {
+    /// The range of the identifier being defined.
+    pub range: Range,
+    /// Optional symbol ID for type-aware resolution.
+    pub symbol_id: Option<SymbolId>,
+    /// The scope where this definition is visible.
+    pub scope: LocalScope,
+}
+
+impl LocalDef {
+    /// Create a new local definition.
+    pub fn new(range: Range, symbol_id: Option<SymbolId>, scope: LocalScope) -> Self {
+        Self {
+            range,
+            symbol_id,
+            scope,
+        }
+    }
+
+    /// Get the name of this definition from source bytes.
+    pub fn name<'a>(&self, src: &'a [u8]) -> &'a [u8] {
+        &src[self.range.start_byte()..self.range.end_byte()]
+    }
+
+    /// Get the scope range.
+    pub fn scope_range(&self) -> &Range {
+        &self.scope.range
+    }
+}
+
+/// A local import in the source code.
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq, Hash)]
+pub struct LocalImport {
+    /// The range of the import identifier.
+    pub range: Range,
+}
+
+impl LocalImport {
+    /// Create a new local import.
+    pub fn new(range: Range) -> Self {
+        Self { range }
+    }
+
+    /// Get the name of this import from source bytes.
+    pub fn name<'a>(&self, src: &'a [u8]) -> &'a [u8] {
+        &src[self.range.start_byte()..self.range.end_byte()]
+    }
+}
+
+/// A reference to a symbol in the source code.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Reference {
+    /// The range of the reference.
+    pub range: Range,
+    /// Optional symbol ID for type-aware resolution.
+    pub symbol_id: Option<SymbolId>,
+}
+
+impl Reference {
+    /// Create a new reference.
+    pub fn new(range: Range, symbol_id: Option<SymbolId>) -> Self {
+        Self { range, symbol_id }
+    }
+
+    /// Get the name of this reference from source bytes.
+    pub fn name<'a>(&self, src: &'a [u8]) -> &'a [u8] {
+        &src[self.range.start_byte()..self.range.end_byte()]
+    }
+}
+
+/// The type of a node in the ScopeGraph.
+#[derive(Serialize, Deserialize, Debug, Clone)]
+pub enum NodeKind {
+    /// A scope node.
+    Scope(LocalScope),
+
+    /// A definition node.
+    Def(LocalDef),
+
+    /// An import node.
+    Import(LocalImport),
+
+    /// A reference node.
+    Ref(Reference),
+}
+
+impl NodeKind {
+    /// Construct a scope node from a range.
+    pub fn scope(range: Range) -> Self {
+        Self::Scope(LocalScope::new(range))
+    }
+
+    /// Produce the range spanned by this node.
+    pub fn range(&self) -> Range {
+        match self {
+            Self::Scope(l) => l.range,
+            // For definitions, return the scope range to capture the full context
+            Self::Def(d) => d.scope.range,
+            Self::Ref(r) => r.range,
+            Self::Import(i) => i.range,
+        }
+    }
+
+    /// Get the identifier range (the actual symbol location).
+    pub fn identifier_range(&self) -> Range {
+        match self {
+            Self::Scope(l) => l.range,
+            Self::Def(d) => d.range,
+            Self::Ref(r) => r.range,
+            Self::Import(i) => i.range,
+        }
+    }
+}