ata-coder 2.4.5__tar.gz → 2.4.7__tar.gz

{ata_coder-2.4.5 → ata_coder-2.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ata-coder
-Version: 2.4.5
+Version: 2.4.7
 Summary: ATA Coder — AI-powered coding assistant
 Author: ATA Coder Team
 License-Expression: MIT
@@ -21,13 +21,17 @@ Requires-Dist: pytest-timeout>=2.0; extra == "dev"
 Requires-Dist: tiktoken>=0.5.0; extra == "dev"
 Dynamic: license-file
 
-# ATA Coder v2.4.5
+# ATA Coder v2.4.7
 
 **AI-powered coding assistant — async, AST-aware, single config file.**
 
 [English](#english) | [中文](#中文)
 
-> **v2.4.5** — 🛡️ **Comprehensive Bug & Security Fix**: 19 bugs fixed — thread safety, SSRF IPv6, rate limiter leak, auth hardening, DRY refactoring, CI coverage. 12 files changed.
+> **v2.4.7** — ⚡ **Context Memory Refactor**: O(1) token tracking, ContextManager, section-level prompt caching, pre-tokenized TF-IDF, LRU token cache. ~60% less overhead in the hot loop.
+>
+> > **v2.4.6** — 🔐 **OS-Native Credential Store**: API key encrypted at rest via Windows DPAPI / macOS Keychain / Linux secret-tool. Auto-migrates plaintext keys. Zero dependencies.
+>
+> > **v2.4.5** — 🤖 **Self-Bootstrapped Audit**: ATA Coder found 19 bugs in its own source code and fixed them all — thread safety, SSRF IPv6, rate limiter leak, auth hardening, DRY refactoring, CI coverage. 12 files changed.
 >
 > > **v2.4.4** — 🔒 **Security Hardening**: 19 fixes across safety, storage, and reliability.
 >
@@ -310,6 +314,28 @@ curl -X POST http://localhost:8080/chat \
 | **Token Budget** | Auto-compact at 200k effective tokens, force-truncate at 95% of 1M max |
 | **Diff Preview** | `difflib.unified_diff` + Rich colored output before file writes |
 
+### 🤖 v2.4.5 Self-Bootstrapped Audit
+
+ATA Coder audited its own source code and found **19 bugs across 8 categories**. All self-found, all self-fixed. 12 files changed.
+
+| # | Area | Detail |
+|---|------|--------|
+| 1 | 🐛 **Bug Fixes** | Test assertion sync, thread counter atomicity (Lock), rate limiter memory leak, MCP config clarity |
+| 2 | 🔒 **Security** | Auto-generated API token for localhost, audit logging + CRITICAL hard blocks in allow-all, IPv6 SSRF (12 ranges) |
+| 3 | 🔁 **DRY** | `create_llm_client()` factory, `_init_subsystem()` helper, sys.path.insert standardized |
+| 4 | 🧱 **Quality** | extension.py Chinese→English, class attr types, `py.typed` marker, file cache 50→200 |
+| 5 | 🧪 **CI** | Python 3.14 in matrix, skip reasons documented |
+
+### 🔒 v2.4.4 Security Hardening
+
+19 fixes across safety, storage, and reliability.
+
+| # | Area | Detail |
+|---|------|--------|
+| 1 | 🛡️ **Safety** | Timing-safe auth comparison, path traversal hardening, shell argument escaping |
+| 2 | 💾 **Storage** | Atomic session writes, surrogate-safe JSONL, corrupted file recovery |
+| 3 | ⚡ **Reliability** | Subprocess pipe cleanup, thread cap enforcement, connection pool limits |
+
 ### 🧠 v2.4.3 Comprehensive Refactoring
 
 60+ issues fixed across 15 files. Memory overhaul, unified token counting, safety pipeline unification.
@@ -526,6 +552,32 @@ All 6 findings in this release were discovered by **ATA Coder scanning its own s
 
 ## 中文
 
+> **v2.4.7** — ⚡ **上下文记忆重构**: O(1) Token 追踪、ContextManager、章节级提示缓存、预分词 TF-IDF、LRU Token 缓存。热路径开销降低约 60%。
+>
+> > **v2.4.6** — 🔐 **操作系统凭据存储**: API Key 通过 Windows DPAPI / macOS Keychain / Linux secret-tool 加密存储。自动迁移明文密钥。零依赖。
+>
+> > **v2.4.5** — 🤖 **自举审计**: ATA Coder 审计自身源码发现 19 个 bug 并全部修复 — 线程安全、SSRF IPv6、速率限制器泄漏、认证加固、DRY 重构、CI 覆盖。12 个文件变更。
+>
+> > **v2.4.4** — 🔒 **安全加固**: 19 项修复，覆盖安全、存储与可靠性。
+>
+> > **v2.4.3** — 🧠 **全面重构**: 记忆系统重写、统一 Token 计数、安全管线、工具调用优化。修复 60+ 问题。
+>
+> > **v2.4.2** — 🐾 **Clawd 工作状态 + 窗口 Token**: Clawd 即时显示"工作中"。状态栏显示窗口 token (~120k) 而非累计值 (7.8M)。会话保存支持代理对安全。
+>
+> > **v2.4.1** — 🗂️ **三段哈希会话 ID + /resume**: 会话 ID: `xxxxxxxx-xxxxxxxx-xxxxxxxx`（工作区·时间戳·任务）。`/resume` 列出当前项目目录的会话。支持 8 位哈希恢复。
+>
+> > **v2.4.0** — 💾 **会话自动保存**: 每次对话自动保存至 `~/.ata_coder/sessions/`。基于哈希的会话 ID。通过哈希恢复: `ata --resume xxxxxxxx`。第 9 轮自修复。
+>
+> > **v2.3.11** — ⚡ **自举流式输出 + 崩溃修复**: ATA Coder 审计自身源码发现并修复 15 个 bug — 第 7.5 轮。实时 shell/web 输出、完整命令显示、子进程挂起修复、代理对崩溃修复。
+>
+> > **v2.3.10** — 🐛 **自举 Bug 猎手**: ATA Coder 扫描自身源码发现 25 个 bug，修复 18 个。信号量泄漏、命令注入、缺失导入、内存泄漏 — 第 7 轮闭环自修复。
+>
+> > **v2.3.6** — 🧹 代码质量审计: 版本同步、CI/CD、ruff/mypy 配置。
+> > **v2.3.5** — 🤖 安全审计 v2: 23 项发现，20 项修复。认证、shell/RCE、CORS。
+> > **v2.3.4** — 🤖 首次自举审计。
+
+---
+
 ### 概述
 
 ATA Coder 是一个命令行 AI 编码助手，兼容 OpenAI / Anthropic API。基于 **单线程 asyncio 事件循环** — 无线程、无竞态、低内存。配备确定性 AST 代码编辑、子 Agent 池、MCP 支持和内置 HTTP API 服务。
@@ -582,6 +634,55 @@ ata run "添加类型注解"        # 单任务
 ata server --port 8080       # API 服务
 ```
 
+### 项目结构
+
+```
+ata_coder/
+├── main.py              # CLI 入口 (click) + asyncio.run()
+├── agent.py             # 核心 Agent: 异步运行循环 + 工具执行
+├── agent_controller.py  # asyncio.Task 编排器
+├── agent_subsystems.py  # 子系统容器 dataclass
+├── core/                # 从 agent.py 提取
+│   ├── events.py        # AgentEvent dataclasses
+│   └── state.py         # AgentState dataclass
+├── tools.py             # 15 个内置工具
+├── llm_client.py        # OpenAI 兼容异步客户端 (httpx.AsyncClient)
+├── anthropic_client.py  # Anthropic Messages API 异步客户端
+├── skills.py            # 基于文件夹的 Skill 管理器
+├── skill_extension.py   # Skill → Extension 适配器
+├── extension.py         # 插件/扩展系统
+├── sub_agent.py         # asyncio.Task 子 Agent
+├── sub_agent_manager.py # asyncio.Semaphore 并发池
+├── event_queue.py       # asyncio.Queue 事件总线
+├── mcp_client.py        # 异步 MCP (stdio + HTTP/SSE)
+├── memory.py            # 持久化文件记忆
+├── session.py           # 会话保存/加载/搜索
+├── change_tracker.py    # 文件变更撤销/重做
+├── safety_guard.py      # 基于模式的风险分析
+├── fool_proof.py        # 统一执行前安全检查
+├── permissions.py       # 交互式允许/拒绝规则
+├── privilege.py         # 操作系统感知权限提升
+├── config.py            # 运行时配置（仅读 settings.json）
+├── settings.py          # ~/.ata_coder/settings.json 持久化
+├── self_correct.py      # 错误诊断 + 自动修复（8 种模式）
+├── system_prompt_builder.py
+├── model_registry.py    # 模型元数据 + 定价
+├── model_router.py      # 基于关键词的复杂度分类
+├── commands.py          # 斜杠命令注册表（~40 条命令）
+├── repl_ui.py           # Rich/prompt-toolkit REPL + diff 预览
+├── server.py            # HTTP API 服务 + SSE 流式
+├── utils.py             # 共享工具 + API 错误助手
+├── prompt_template.py   # {% if %} 模板引擎
+├── task_planner.py      # 任务分解
+├── git_workflow.py      # Git 集成
+├── project.py           # 项目自动检测
+├── skills/              # 内置 Skill 文件夹
+├── extensions/          # 插件目录
+├── examples/            # 使用示例
+├── tests/               # pytest 测试套件
+└── README.md
+```
+
 ### 配置
 
 **settings.json 是唯一配置源。** 所有配置在 `~/.ata_coder/settings.json`：
@@ -603,6 +704,20 @@ ata server --port 8080       # API 服务
 - 模型名自动剥离 `[1m]` 后缀
 - API 错误自动附带友好修复建议
 
+### 技能系统
+
+Skill 存放在 `skills/<名称>/` 文件夹中，使用 `SKILL.md` 清单（YAML frontmatter + markdown 正文）。通过关键词匹配单 Skill 激活 — 无需额外 LLM 调用。
+
+```
+skills/weather-skill/
+├── SKILL.md           # name, version, triggers, tools, I/O spec
+├── handler.py         # Python 入口
+├── utils.py           # 辅助工具
+├── prompts/           # LLM 提示模板
+├── resources/         # 静态数据
+└── tests/             # pytest 测试
+```
+
 ### 常用命令
 
 | 命令 | 说明 |
@@ -632,6 +747,43 @@ curl -N -X POST http://localhost:8080/chat/stream \
   -d '{"message": "解释 async/await"}'
 ```
 
+### 设计模式
+
+| 模式 | 实现 |
+|------|------|
+| **异步 LLM** | `BaseLLMClient` ABC — `LLMClient` 和 `AnthropicClient` 使用 `httpx.AsyncClient` |
+| **工具管线** | SafetyCheck → PermissionCheck → PrivilegeCheck → Execute → SelfCorrect |
+| **AST 编辑** | libcst `CSTTransformer` — 解析、匹配、替换、保留格式 |
+| **取消** | `asyncio.Task.cancel()` + `asyncio.CancelledError` — 无线程事件 |
+| **并发** | `asyncio.Semaphore` 子 Agent 限制, `asyncio.gather()` 并行工具 |
+| **事件总线** | `asyncio.Queue` — agent 任务生产, UI 任务消费 |
+| **重试抖动** | LLM 客户端指数退避 + 随机抖动 |
+| **熔断器** | 连续工具失败计数（5 次全失败批次 → 熔断） |
+| **Token 预算** | 200k 有效 token 自动压缩, 1M 上限 95% 强制截断 |
+| **Diff 预览** | `difflib.unified_diff` + Rich 彩色输出 |
+
+### 🤖 v2.4.5 自举审计
+
+ATA Coder 审计自身源码，发现 **8 大类 19 个 bug**。全部自发现、自修复。12 个文件变更。
+
+| # | 领域 | 详情 |
+|---|------|------|
+| 1 | 🐛 **Bug 修复** | 测试断言同步、线程计数器原子性（Lock）、速率限制器内存泄漏、MCP 配置明晰 |
+| 2 | 🔒 **安全** | localhost 自动生成 API token、allow-all 模式审计日志 + CRITICAL 硬阻断、IPv6 SSRF（12 段） |
+| 3 | 🔁 **DRY** | `create_llm_client()` 工厂函数、`_init_subsystem()` 辅助函数、sys.path.insert 统一 |
+| 4 | 🧱 **质量** | extension.py 中→英、类属性类型标注、`py.typed` 标记、文件缓存 50→200 |
+| 5 | 🧪 **CI** | Python 3.14 加入矩阵、跳过原因已注明 |
+
+### 🔒 v2.4.4 安全加固
+
+19 项修复，覆盖安全、存储与可靠性。
+
+| # | 领域 | 详情 |
+|---|------|------|
+| 1 | 🛡️ **安全** | 时序安全认证对比、路径穿越加固、shell 参数转义 |
+| 2 | 💾 **存储** | 会话原子写入、代理对安全 JSONL、损坏文件恢复 |
+| 3 | ⚡ **可靠性** | 子进程管道清理、线程上限执行、连接池限制 |
+
 ### 🧠 v2.4.3 全面重构
 
 跨 15 个文件修复 60+ 问题。记忆系统重构、统一 Token 计算、安全管道优化、工具调用优化。