ডকুমেন্টেশন

পুনরুৎপাদনযোগ্যতা - LeanCTX

পুনরুৎপাদনযোগ্যতা

এজেন্ট রান পুনরুৎপাদনযোগ্য করার উপায়: স্থিতিশীল ইনপুট, স্পষ্ট পলিসি, সেশন স্থায়িত্ব এবং যাচাই গেট।

কী স্থিতিশীল থাকতে হবে

পুনরুৎপাদনযোগ্যতা স্থিতিশীল ইনপুট থেকে শুরু হয় - টুল গ্রাফ ততটাই নির্ধারণবাদী যতটা পরিবেশ।

  • একই প্রজেক্ট রুট + অনুমোদিত পাথ
  • একই কনফিগারেশন এবং মেমরি পলিসি
  • একই কোড + ডিপেন্ডেন্সি (lockfiles)

চুক্তি হিসাবে পলিসি

মেমরি এবং যাচাই সেটিংস নির্ধারণ করে কী সংরক্ষিত হয় এবং কোন পরীক্ষা প্রযোজ্য হবে।

# ~/.lean-ctx/config.toml
[memory]
policy = "balanced"

[verification]
enabled = true

পরামর্শ: পলিসি পরিবর্তন সংস্করণ নিয়ন্ত্রণে রাখুন এবং রিভিউ করুন।

সেশন আর্টিফ্যাক্ট

সেশন রেকর্ড করে কী হয়েছে: টুল কল, মেমরি রাইট, রিলেশন এবং আউটপুট।

# Start a server with a fixed project root
lean-ctx serve --host 127.0.0.1 --port 8080 --project-root /path/to/repo
# Example tool calls that leave an audit trail
ctx_session("load", { id: "..." })
ctx_knowledge("remember", { category: "...", key: "...", value: "..." })

CI গেট

clippy/টেস্ট + যাচাই পরীক্ষাকে অপরিহার্য গুণমান গেট হিসাবে গণ্য করুন।

# CI gates / local checks
cd rust
cargo fmt -- --check
cargo clippy --all-features -- -D warnings

# SSOT drift gate (manifest must be up-to-date)
cargo run -q --bin gen_mcp_manifest
git diff --exit-code ../website/generated/mcp-tools.json

# Core tests (deterministic + bounded)
cargo test --all-features -- --test-threads=1

# Lightweight regression checks (stable thresholds)
cargo test -q --test savings_verification

# Proof artifact (machine-readable attestation, no secrets)
cargo run -q --bin lean-ctx -- proof --summary --no-write

Cookbook: এন্ড-টু-এন্ড উদাহরণ

চলমান সার্ভারের বিরুদ্ধে বাস্তব ইন্টিগ্রেশন চালান (কোনো নকল ডেটা নয়)।

cd cookbook
npm ci
npm run memory-playground
npm run graph-explorer