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).
This commit is contained in:
2026-07-17 05:31:01 -04:00
commit d6c20fc13f
2612 changed files with 1353757 additions and 0 deletions
@@ -0,0 +1,101 @@
use std::path::Path;
use ratatui::layout::Rect;
use crate::prompt_images::PastedImage;
use crate::terminal::image::{self as terminal_image, GraphicsProtocol};
pub(super) const MIN_BOX_WIDTH: u16 = 28;
pub(super) const MIN_PIXEL_BOX_HEIGHT: u16 = 8;
pub(super) const MIN_META_BOX_HEIGHT: u16 = 6;
const META_PREVIEW_WIDTH_RATIO: f32 = 0.75;
const META_CONTENT_LINES: u16 = 4;
const META_BOX_CHROME_ROWS: u16 = 2;
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(super) struct ImagePreviewPlan<'a> {
pub(super) show_pixels: bool,
pub(super) display_path: Option<&'a Path>,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(super) struct ImageOverlayGeometry {
pub(super) overlay_rect: Rect,
pub(super) image_placement: Option<ImagePlacement>,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(super) struct ImagePlacement {
pub(super) cols: u16,
pub(super) rows: u16,
pub(super) x: u16,
pub(super) y: u16,
}
pub(super) fn plan_image_preview(
image: &PastedImage,
protocol: GraphicsProtocol,
) -> ImagePreviewPlan<'_> {
ImagePreviewPlan {
show_pixels: protocol.supports_images() && image.preview.prepared().is_some(),
display_path: image.source_path.as_deref(),
}
}
pub(super) fn overlay_geometry(
area: Rect,
show_pixels: bool,
has_path: bool,
dimensions: (u32, u32),
) -> Option<ImageOverlayGeometry> {
let min_height = if show_pixels {
MIN_PIXEL_BOX_HEIGHT
} else {
MIN_META_BOX_HEIGHT
};
if area.width < MIN_BOX_WIDTH || area.height < min_height {
return None;
}
if show_pixels {
let footer_rows = u16::from(has_path);
let max_cols = area.width.saturating_sub(2).max(4);
let max_rows = area
.height
.saturating_sub(2)
.saturating_sub(footer_rows)
.max(2);
let (cols, rows) =
terminal_image::fit_image_to_cells(dimensions.0, dimensions.1, max_cols, max_rows);
let width = (cols.saturating_add(2)).clamp(MIN_BOX_WIDTH, area.width);
let height = (rows.saturating_add(2).saturating_add(footer_rows))
.clamp(MIN_PIXEL_BOX_HEIGHT, area.height);
let x = area.x + area.width.saturating_sub(width) / 2;
let y = area.y + area.height.saturating_sub(height) / 2;
let inner_width = width.saturating_sub(2);
let inner_height = height.saturating_sub(2).saturating_sub(footer_rows);
return Some(ImageOverlayGeometry {
overlay_rect: Rect::new(x, y, width, height),
image_placement: Some(ImagePlacement {
cols,
rows,
x: x + 1 + inner_width.saturating_sub(cols) / 2,
y: y + 1 + inner_height.saturating_sub(rows) / 2,
}),
});
}
let width = ((area.width as f32) * META_PREVIEW_WIDTH_RATIO) as u16;
let width = width.clamp(MIN_BOX_WIDTH, area.width);
let height = (META_CONTENT_LINES + META_BOX_CHROME_ROWS)
.min(area.height)
.max(MIN_META_BOX_HEIGHT)
.min(area.height);
let x = area.x + area.width.saturating_sub(width) / 2;
let y = area.y + area.height.saturating_sub(height);
Some(ImageOverlayGeometry {
overlay_rect: Rect::new(x, y, width, height),
image_placement: None,
})
}