Cargo.toml

[package]
name = "pi_agent_rust"
version = "0.2.0"
edition = "2024"
rust-version = "1.95"
description = "Native AI coding agent CLI - Rust port of Pi Agent"
authors = ["Jeffrey Emanuel"]
license-file = "LICENSE"
repository = "https://github.com/Dicklesworthstone/pi_agent_rust"
homepage = "https://github.com/Dicklesworthstone/pi_agent_rust"
documentation = "https://docs.rs/pi_agent_rust"
readme = "README.md"
keywords = ["ai", "cli", "coding-agent", "llm", "anthropic"]
categories = ["command-line-utilities", "development-tools"]
autobins = false
# Binary organization per bd-uuwgi.1/bd-uuwgi.2 classification:
# - SHIPPING: src/main.rs (pi) - main CLI binary
# - INTERNAL/OPT-IN: src/bin/pi_legacy_capture.rs (pending RULE 1 approval)
# - DEV-ONLY: moved to examples/ (23 files: ext_*, test_*, debug utilities)
include = [
    "/docs/extension-artifact-provenance.json",
    # Compile-time unit-test evidence referenced by src/tools.rs. Keeping it in
    # the source package lets `cargo test` compile after crates.io extraction.
    "/docs/evidence/tool-output-context-cache.jsonl",
    "/docs/wit/extension.wit",
    "/docs/provider-upstream-model-ids-snapshot.json",
    "/docs/schema/extension_protocol.json",
    "/legacy_pi_mono_code/pi-mono/packages/ai/src/models.generated.ts",
    # Compile-time unit-test fixture referenced by src/doctor.rs.
    "/tests/fixtures/agent_mail/schema_corrupt_health.json",
    "/Cargo.toml",
    "/LICENSE",
    "/README.md",
    # Compressed by build.rs and embedded by src/embedded_assets.rs; without it
    # the `cargo publish --dry-run` verify step cannot build the packaged tarball.
    "/CHANGELOG.md",
    "/build.rs",
    "/src/**",
]

[lib]
name = "pi"
path = "src/lib.rs"

[[bin]]
name = "pi"
path = "src/main.rs"
# The `pi` binary is the interactive terminal front-end; it requires the full
# TUI stack (crossterm + charmed_rust). `tui` is in the default feature set, so
# `cargo build` still produces `pi` with no extra flags. A `--no-default-features`
# build correctly skips the binary while the library still compiles for SDK
# consumers that do not want the terminal stack.
required-features = ["tui"]

# RETIRABLE internal conformance utility (pending RULE 1 approval). Keeping it
# behind a non-default feature prevents an ordinary `cargo install
# pi_agent_rust` from installing this unsupported executable. Repository gates
# that exercise it explicitly enable `internal-legacy-capture`; the matching
# integration test is gated below so CARGO_BIN_EXE_pi_legacy_capture is defined
# whenever that test is compiled.
[[bin]]
name = "pi_legacy_capture"
path = "src/bin/pi_legacy_capture.rs"
required-features = ["internal-legacy-capture"]

# Examples (moved from src/bin/ to examples/)
# These binaries are accessible via: cargo run --example <name>

[[example]]
name = "basic_sdk"
path = "examples/basic_sdk.rs"

[[example]]
name = "ext_artifact_manifest"
path = "examples/ext_artifact_manifest.rs"

[[example]]
name = "ext_conformance_matrix"
path = "examples/ext_conformance_matrix.rs"

[[example]]
name = "ext_conformance_report"
path = "examples/ext_conformance_report.rs"

[[example]]
name = "ext_full_validation"
path = "examples/ext_full_validation.rs"

[[example]]
name = "ext_inclusion_list"
path = "examples/ext_inclusion_list.rs"

[[example]]
name = "ext_license_screen"
path = "examples/ext_license_screen.rs"

[[example]]
name = "ext_onboarding_queue"
path = "examples/ext_onboarding_queue.rs"

[[example]]
name = "ext_popularity_snapshot"
path = "examples/ext_popularity_snapshot.rs"

[[example]]
name = "ext_release_binary_e2e"
path = "examples/ext_release_binary_e2e.rs"

[[example]]
name = "ext_runtime_risk_ledger"
path = "examples/ext_runtime_risk_ledger.rs"

[[example]]
name = "ext_score_candidates"
path = "examples/ext_score_candidates.rs"

[[example]]
name = "ext_stress"
path = "examples/ext_stress.rs"

[[example]]
name = "ext_tiered_corpus"
path = "examples/ext_tiered_corpus.rs"

[[example]]
name = "ext_unvendored_fetch_run"
path = "examples/ext_unvendored_fetch_run.rs"

[[example]]
name = "ext_validate_dedup"
path = "examples/ext_validate_dedup.rs"

[[example]]
name = "ext_workloads"
path = "examples/ext_workloads.rs"

[[example]]
name = "pi_debug"
path = "examples/pi_debug.rs"

[[example]]
name = "pijs_workload"
path = "examples/pijs_workload.rs"

[[example]]
name = "session_workload_bench"
path = "examples/session_workload_bench.rs"

[[example]]
name = "test_duration"
path = "examples/test_duration.rs"

[[example]]
name = "test_infinite_loop"
path = "examples/test_infinite_loop.rs"

[[example]]
name = "test_time"
path = "examples/test_time.rs"

[dependencies]
# CLI
clap = { version = "4.5.60", features = ["derive", "env", "string"] }
clap_complete = "4.5.66"

# Async runtime
asupersync = { version = "0.3.9", default-features = false, features = ["tls-webpki-roots", "test-internals"] }
futures = "0.3"
async-trait = "0.1"

# URL parsing/building
url = "2"

# Signals
ctrlc = "3.5.2"

# Serialization
serde = { version = "1", features = ["derive", "rc"] }
serde_json = { version = "1", features = ["raw_value"] }
json5 = "1.3.1"

# Error handling
anyhow = "1.0.104"
thiserror = "2"

# Terminal output (rich_rust for beautiful TUI).
# rich_rust is shared by non-TUI code paths (plain styled stdout/markdown
# rendering in src/tui.rs and elsewhere), so it stays unconditional.
rich_rust = { version = "0.2.2", features = ["markdown"] }
# crossterm is the low-level terminal driver used exclusively by the
# interactive front-end, so it is gated behind the `tui` feature.
crossterm = { version = "0.29", optional = true }
enable-ansi-support = "0.2"

# Interactive TUI (charmed_rust - bubbletea/lipgloss/bubbles/glamour).
# These are used exclusively by the interactive terminal front-end and are
# gated behind the `tui` feature so SDK/library consumers can build the lib
# with `--no-default-features` without pulling in the terminal stack.
bubbletea = { package = "charmed-bubbletea", version = "0.2.0", optional = true }
lipgloss = { package = "charmed-lipgloss", version = "0.2.0", optional = true }
bubbles = { package = "charmed-bubbles", version = "0.2.0", optional = true }
glamour = { package = "charmed-glamour", version = "0.2.0", optional = true }
# unicode-width / textwrap are TUI-layout helpers consumed only by the
# interactive render code, so they are gated with the rest of the TUI stack.
unicode-width = { version = "0.2", optional = true }
textwrap = { version = "0.16", optional = true }
arboard = { version = "3.6.1", optional = true }

# Filesystem
dirs = "6"
tempfile = "3.25.0"
fs4 = "0.13"
glob = "0.3"
ignore = "0.4"
rustix = { version = "1.1.4", features = ["fs", "process"] }
crossbeam-queue = "0.3"
sqlmodel-sqlite = { version = "0.2.2" }
sqlmodel-core = { version = "0.2.2" }

# Time
chrono = { version = "0.4", features = ["serde"] }

# Logging
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }

# Utilities
uuid = { version = "1.21.0", features = ["v4"] }
memchr = "2.8.0"
base64 = "0.22"
flate2 = "1.1.9"
sha2 = "0.10"
sha1 = "0.10"
md-5 = "0.10"
hmac = "0.12"
pbkdf2 = { version = "0.12.2", features = ["hmac"] }
scrypt = { version = "0.11.0", default-features = false }
getrandom = "0.4.1"
regex = "1.12.3"
ring = "0.17.14"
semver = "1.0.27"
crc32c = "0.6"
ast-grep-core = "0.40"
ast-grep-language = { version = "0.40", default-features = false, features = [
    "tree-sitter-bash",
    "tree-sitter-python",
    "tree-sitter-javascript",
    "tree-sitter-typescript",
    "tree-sitter-ruby",
] }
unicode-normalization = "0.1"
xxhash-rust = { version = "0.8", features = ["xxh32"] }
similar = "2"
sysinfo = "0.39.6"
rquickjs = { version = "0.11", features = ["futures", "loader"] }
swc_common = "18.0.1"
swc_ecma_codegen = "23.0.0"
swc_ecma_ast = "20.0.1"
swc_ecma_parser = "34.0.0"
swc_ecma_transforms_base = "37.0.0"
swc_ecma_transforms_typescript = "41.0.0"
swc_ecma_visit = "20.0.0"
wasmtime = { version = "47.0.3", features = ["component-model"], optional = true }
filetime = "0.2.27"

# Image processing (optional)
image = { version = "0.25", optional = true }

[build-dependencies]
crc32c = "0.6.8"
flate2 = "1.1.9"
vergen-gix = { version = "9.1.0", features = ["build", "cargo", "rustc"] }

[dev-dependencies]
arbitrary = { version = "1", features = ["derive"] }
pretty_assertions = "1"
insta = { version = "1", features = ["filters"] }
tempfile = "3.25.0"
asupersync = { version = "0.3.9", default-features = false, features = ["test-internals"] }
criterion = { version = "0.8.2", features = ["html_reports"] }
jsonschema = { version = "0.42.0", default-features = false }
proptest = "1.10.0"
wat = "1.255.0"
toml = "1.0.3"
# Pinned to the reviewed upstream root-stack configurability change from
# tokio-rs/loom#412. Loom 0.7.2 hard-codes the model root coroutine to 4 KiB,
# which overflows before these hostcall models can begin exploring. The exact
# revision is immutable and remains test-only until upstream publishes it.
loom = { version = "0.7.2", git = "https://github.com/ongardie-atomix/loom", rev = "2b7c402034cc041b5e325384c67bb43bff93c048" }
signal-hook = "0.4.4"

[[bench]]
name = "tools"
harness = false

[[bench]]
name = "extensions"
harness = false

[[bench]]
name = "extension_budget_inputs"
harness = false

[[bench]]
name = "semantic_context"
harness = false

[[bench]]
name = "system"
harness = false

[[bench]]
name = "tui_perf"
harness = false

# Gap H: jemalloc for 10-20% allocation-heavy path improvement.
# Keep the global jemalloc override to targets where tikv-jemallocator is a
# supported allocator choice. BSD-family targets stay on the platform allocator.
[target.'cfg(any(target_os = "linux", target_os = "macos"))'.dependencies]
tikv-jemallocator = { version = "0.6", optional = true }

# FreeBSD: third-party libs live under /usr/local and rquickjs-sys doesn't
# ship pre-generated bindings for this target, so regenerate at build time
# via the `bindgen` feature (uses /usr/bin/clang from the base system).
[target.'cfg(target_os = "freebsd")'.dependencies]
rquickjs = { version = "0.11", features = ["futures", "loader", "bindgen"] }

# Android (including Termux on-device): rquickjs-sys 0.11 ships pre-generated
# bindings for aarch64-linux-android only for some Cargo versions and not
# others; the canonical fix is to regenerate via the `bindgen` feature so we
# stop depending on a missing bindings/aarch64-linux-android.rs in the
# upstream crate. Termux ships clang under $PREFIX/bin which bindgen picks
# up automatically.
[target.'cfg(target_os = "android")'.dependencies]
rquickjs = { version = "0.11", features = ["futures", "loader", "bindgen"] }

[features]
default = ["sqlite-sessions", "tui"]
full = [
    "image-resize",
    "jemalloc",
    "clipboard",
    "wasm-host",
    "sqlite-sessions",
    "syntax-highlighting",
    "tui",
    "rich_rust/full",
]
# Interactive terminal front-end (crossterm + charmed_rust stack). Enabled by
# default so CLI users get an identical `pi` binary with no action required.
# Disabling it (`--no-default-features`) lets SDK/library consumers compile the
# `pi` library without the terminal UI dependencies.
tui = [
    "dep:crossterm",
    "dep:bubbletea",
    "dep:lipgloss",
    "dep:bubbles",
    "dep:glamour",
    "dep:unicode-width",
    "dep:textwrap",
]
image-resize = ["image"]
clipboard = ["dep:arboard"]
wasm-host = ["dep:wasmtime"]
sqlite-sessions = []
syntax-highlighting = ["rich_rust/syntax"]
ext-conformance = []
fuzzing = []
# Internal-only legacy capture utility. This is deliberately non-default so
# end-user `cargo install` installs only the supported `pi` executable. The
# single integration test that executes it is gated at the test-function level
# so the rest of that target remains in ordinary test runs.
internal-legacy-capture = []
# Opt-in loom model-checking lane. These tests are excluded from default
# all-target gates because loom explores scheduler interleavings aggressively.
loom-tests = []
# Opt-in wall-clock/process timing regressions. These are intentionally
# excluded from default test gates because scheduler-sensitive coverage should
# use deterministic clocks.
manual-timing-tests = []
jemalloc = ["dep:tikv-jemallocator"]

[[test]]
name = "hostcall_queue_loom"
path = "tests/hostcall_queue_loom.rs"
required-features = ["loom-tests"]

[profile.release]
opt-level = "z"
lto = true
codegen-units = 1
panic = "abort"
strip = true

[profile.dev]
opt-level = 0
debug = true

[profile.test]
# Full-suite RCH workers have limited artifact storage; keep test binaries
# debuggable enough for line traces without emitting full debug sections.
debug = "line-tables-only"
incremental = false

# Performance benchmarking profile: opt-level=3, with debug info.
[profile.perf]
inherits = "release"
opt-level = 3
lto = "thin"
debug = 1
strip = false

[lints.rust]
unsafe_code = "forbid"

[lints.clippy]
pedantic = { level = "warn", priority = -1 }
nursery = { level = "warn", priority = -1 }
# Allow some common patterns
missing_errors_doc = "allow"
missing_panics_doc = "allow"
module_name_repetitions = "allow"

# ---------------------------------------------------------------------------
# Local development with sibling crates
# ---------------------------------------------------------------------------
# This project depends on published crates.io versions of asupersync,
# rich_rust, charmed-*, and sqlmodel-*. CI builds verify this (no sibling
# repos are checked out).
#
# To develop against LOCAL checkouts of these crates, uncomment the
# [patch.crates-io] section below. Cargo will use the local paths when they
# satisfy the version requirement and fall back to crates.io otherwise.
#
# IMPORTANT: Do NOT commit this section. To prevent accidental commits:
#   git update-index --skip-worktree Cargo.toml
# To re-enable tracking:
#   git update-index --no-skip-worktree Cargo.toml
#
# [patch.crates-io]
# asupersync = { path = "../asupersync" }
# rich_rust = { path = "../rich_rust" }
# charmed-bubbletea = { path = "../charmed_rust/crates/bubbletea" }
# charmed-bubbletea-macros = { path = "../charmed_rust/crates/bubbletea-macros" }
# charmed-lipgloss = { path = "../charmed_rust/crates/lipgloss" }
# charmed-bubbles = { path = "../charmed_rust/crates/bubbles" }
# charmed-glamour = { path = "../charmed_rust/crates/glamour" }
# charmed-harmonica = { path = "../charmed_rust/crates/harmonica" }
# sqlmodel-core = { path = "../sqlmodel_rust/crates/sqlmodel-core" }
# sqlmodel-sqlite = { path = "../sqlmodel_rust/crates/sqlmodel-sqlite" }