|
| 1 | +# kimiko Context |
| 2 | +> **Auto-Generated:** 2026-06-12 | **Primary Sources:** Makefile, README.md, validator/requirements.txt, scripts/activate-mandate.sh, docs/AGENTS.md |
| 3 | +
|
| 4 | +## 1. System Identity |
| 5 | +| Attribute | Value | Source | |
| 6 | +| :--- | :--- | :--- | |
| 7 | +| Language | Python (3.11+), Shell, PowerShell, Make | Source: README.md:L46-L64 | |
| 8 | +| Runtime | Python, Bash, PowerShell | Source: README.md:L44-L64 | |
| 9 | +| Framework | — | Source: — | |
| 10 | +| Package Manager | pip | Source: validator/requirements.txt | |
| 11 | +| Build System | Make | Source: Makefile:L1-L3 | |
| 12 | + |
| 13 | +## 2. Operational Commands |
| 14 | +| Intent | Command (Exact) | Working Dir | Notes | Source | |
| 15 | +| :--- | :--- | :--- | :--- | :--- | |
| 16 | +| Install | `make install` | Root | Platform-aware installation | Source: Makefile:L160-L174 | |
| 17 | +| Test | `make test` | Root | Runs pytest suite for validator | Source: Makefile:L350-L357 | |
| 18 | +| Lint | `make check` | Root | Validates configuration | Source: Makefile:L325-L341 | |
| 19 | +| Verify | `make verify` | Root | Checks installation files | Source: Makefile:L359-L406 | |
| 20 | +| Uninstall | `make uninstall`| Root | Removes Kimiko-managed files | Source: Makefile:L310-L318 | |
| 21 | +| Deps | `make deps` | Root | Installs Python dependencies | Source: Makefile:L321-L323 | |
| 22 | + |
| 23 | +## 3. Architecture & Conventions |
| 24 | +| Concern | Value | Source | |
| 25 | +| :--- | :--- | :--- | |
| 26 | +| Entrypoint / Bootstrap | `scripts/launch-with-mandate.sh` | Source: Makefile:L266-L271; docs/AGENTS.md:L189-L194 | |
| 27 | +| Routing | — | Source: — | |
| 28 | +| State Management | `kimi.json` and config files deployed to `~/.kimi-code/` | Source: docs/AGENTS.md:L245-L251 | |
| 29 | +| Styling | — | Source: — | |
| 30 | +| Testing | `pytest` | Source: validator/requirements.txt:L3; Makefile:L356 | |
| 31 | +| Linting / Formatting | `ruff` | Source: validator/requirements.txt:L4 | |
| 32 | +| Error Handling / Logging | Session logs in `~/.kimi-code/logs/` | Source: docs/AGENTS.md:L39-L40 | |
| 33 | + |
| 34 | +## 4. Environment Variables |
| 35 | +| Variable | Required | Description | Where Set/Validated | Source | |
| 36 | +| :--- | :---: | :--- | :--- | :--- | |
| 37 | +| `KIMI_GLOBAL_CONFIG` | Yes | — | `scripts/activate-mandate.sh` | Source: scripts/activate-mandate.sh:L29 | |
| 38 | +| `KIMI_MANDATE_ACTIVE` | Yes | — | `scripts/activate-mandate.sh` | Source: scripts/activate-mandate.sh:L30 | |
| 39 | +| `KIMI_ADMIN_MODE` | Yes | — | `scripts/activate-mandate.sh` | Source: scripts/activate-mandate.sh:L31 | |
| 40 | +| `KIMI_ZERO_BLOCKERS` | Yes | — | `scripts/activate-mandate.sh` | Source: scripts/activate-mandate.sh:L32 | |
| 41 | +| `KIMI_DEFAULT_YOLO` | Yes | — | `scripts/activate-mandate.sh` | Source: scripts/activate-mandate.sh:L33 | |
| 42 | +| `KIMI_SKIP_AFK_INJECTION` | Yes | — | `scripts/activate-mandate.sh` | Source: scripts/activate-mandate.sh:L34 | |
| 43 | + |
| 44 | +## 5. Critical Files Map |
| 45 | +| Path | Purpose | Source | |
| 46 | +| :--- | :--- | :--- | |
| 47 | +| `Makefile` | Main build/install configuration | Source: Makefile:L1-L444 | |
| 48 | +| `scripts/activate-mandate.sh` | Bash script to enforce mandate in session | Source: scripts/activate-mandate.sh:L1-L106 | |
| 49 | +| `validator/validate_kimi.py` | Validates config structure and rules | Source: Makefile:L333-L339; docs/AGENTS.md:L308-L328 | |
| 50 | +| `config/config.toml` | Main Kimi CLI config template | Source: docs/AGENTS.md:L170-L173 | |
| 51 | +| `docs/AGENTS.md` | System-level mandate directory and enforcement docs | Source: docs/AGENTS.md:L1-L425 | |
| 52 | + |
| 53 | +## 6. Gaps & Negative Evidence |
| 54 | +| Missing Item | Where You Looked | Result | |
| 55 | +| :--- | :--- | :--- | |
| 56 | +| Node.js / NPM | `.nvmrc`, `package.json`, `Makefile` | Not found | |
| 57 | +| Python version pin | `pyproject.toml`, `.python-version`, `requirements.txt` | No strict pin found | |
0 commit comments