docs(guides): file-size drift + FileItem/ContextPreset location drift
- guide_ai_client.md: ~116KB -> ~166KB (src/ai_client.py actual size); '46 tools' clarified to '45 MCP tools + the PowerShell shell tool defined here in ai_client.py'. - guide_gui_2.md: '~260KB, ~5400 lines' -> '~437KB, ~8970 lines (as of 2026-07-02)'. - guide_context_curation.md: 'src/models.py:510 + :909' FileItem + ContextPreset line refs -> src/project_files.py + src/context_presets.py (per module_taxonomy_refactor_20260627).
This commit is contained in:
@@ -6,7 +6,7 @@
|
||||
|
||||
## Overview
|
||||
|
||||
`src/ai_client.py` (~116KB) is the **unified LLM client** for 8 providers. It abstracts the differences between providers (Gemini, Anthropic, DeepSeek, MiniMax, Gemini CLI, Qwen, Grok, Llama) behind a single `send()` function.
|
||||
`src/ai_client.py` (~166KB) is the **unified LLM client** for 8 providers. It abstracts the differences between providers (Gemini, Anthropic, DeepSeek, MiniMax, Gemini CLI, Qwen, Grok, Llama) behind a single `send()` function.
|
||||
|
||||
The module is a **stateful singleton** — all provider state is held in module-level globals. There is no class wrapping; the module itself is the abstraction layer.
|
||||
|
||||
@@ -510,7 +510,7 @@ print(r.data)
|
||||
|
||||
- **[guide_architecture.md](guide_architecture.md#ai-client-multi-provider-architecture)** — Threading model and provider dispatch
|
||||
- **[guide_mma.md](guide_mma.md#tier-3-worker-lifecycle-run_worker_lifecycle)** — How Tier 3 workers use ai_client
|
||||
- **[guide_mcp_client.md](guide_mcp_client.md)** — The 46 tools that ai_client can invoke (canonical list in `models.AGENT_TOOL_NAMES`)
|
||||
- **[guide_mcp_client.md](guide_mcp_client.md)** — The 45 MCP tools (plus the PowerShell shell tool defined here in ai_client.py) that ai_client can invoke (canonical list in `models.AGENT_TOOL_NAMES`)
|
||||
- **[guide_rag.md](guide_rag.md)** — RAG engine integration via `rag_engine` parameter
|
||||
- **[guide_state_lifecycle.md](guide_state_lifecycle.md)** — The per-provider history globals (`_anthropic_history`, etc.) are managed here; their locking and reset behavior is documented
|
||||
- **[guide_context_aggregation.md](guide_context_aggregation.md)** — The `aggregate.py` pipeline that produces the markdown the AI client sends
|
||||
|
||||
@@ -319,7 +319,7 @@ This is a UX consolidation, not a data model change. The underlying `ast_mask: d
|
||||
|
||||
- **[guide_context_aggregation.md](guide_context_aggregation.md)** — The full `aggregate.py` pipeline that consumes the FileItem schema documented here. Includes the 7 `view_mode` values (`full`, `summary`, `skeleton`, `outline`, `masked`, `none`, `custom`) and the 3 `aggregation_strategy` values (`auto`, `summarize`, `full`)
|
||||
- **[guide_context_presets.md](guide_context_aggregation.md)** — now part of the Context Aggregation guide — The `ContextPreset` schema (named, persisted set of FileItems)
|
||||
- **[guide_models.md](guide_models.md)** — Full FileItem and ContextPreset dataclass definitions at `src/models.py:510` and `src/models.py:909`
|
||||
- **[guide_models.md](guide_models.md)** — Full FileItem and ContextPreset dataclass definitions (now in `src/project_files.py` and `src/context_presets.py` respectively; moved out of `src/models.py` per `module_taxonomy_refactor_20260627`)
|
||||
- **[guide_architecture.md](guide_architecture.md)** — How the FileItem list is built up in `App.init_state` and how the aggregation pipeline consumes it
|
||||
- **[conductor/tracks/nagent_review_20260608/report.md §6](../conductor/tracks/nagent_review_20260608/report.md)** — Deep-dive on per-file memory; compares Manual Slop's curation dimension (this guide) to nagent's conversation-log dimension
|
||||
- **[conductor/tracks/nagent_review_20260608/nagent_takeaways_20260608.md §4](../conductor/tracks/nagent_review_20260608/nagent_takeaways_20260608.md)** — Actionable: add a `file_id: st_dev:st_ino` field to FileItem for rename-safe identity
|
||||
|
||||
+1
-1
@@ -6,7 +6,7 @@
|
||||
|
||||
## Overview
|
||||
|
||||
`src/gui_2.py` is the **largest file** in the project (~260KB, ~5400 lines). It contains the `App` class — the main ImGui application orchestrator — and ~90 module-level render functions that draw the GUI.
|
||||
`src/gui_2.py` is the **largest file** in the project (~437KB, ~8970 lines as of 2026-07-02; was ~260KB / ~5400 lines when this guide was first written — extended by the 2026-07 hot-reload and event-sourcing refactors). It contains the `App` class — the main ImGui application orchestrator — and ~90 module-level render functions that draw the GUI.
|
||||
|
||||
The file is divided into:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user