zall 0.4.1__tar.gz

zall-0.4.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 zall contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

zall-0.4.1/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: zall
+Version: 0.4.1
+Summary: zall — a falsifiable, reproducible coding agent CLI. Model-agnostic, chain-hashed, replayable.
+Author: zall contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/qinrayn/zall
+Project-URL: Repository, https://github.com/qinrayn/zall
+Project-URL: Documentation, https://github.com/qinrayn/zall
+Project-URL: Issues, https://github.com/qinrayn/zall/issues
+Keywords: coding-agent,cli,ai,llm,developer-tools,reproducible
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Debuggers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.5
+Requires-Dist: cryptography>=42
+Requires-Dist: httpx>=0.24
+Requires-Dist: rich>=13
+Requires-Dist: prompt_toolkit>=3.0
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: mypy>=1.7; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Provides-Extra: bs4
+Requires-Dist: beautifulsoup4>=4.0; extra == "bs4"
+Provides-Extra: images
+Requires-Dist: pillow>=10.0; extra == "images"
+Provides-Extra: all
+Requires-Dist: zall[bs4,dev,images]; extra == "all"
+Dynamic: license-file
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/badge/zall-v0.4.1-blue?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a2e">
+    <img alt="zall" src="https://img.shields.io/badge/zall-v0.4.1-blue?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a2e">
+  </picture>
+</p>
+
+<p align="center">
+  <em>A falsifiable, reproducible coding agent CLI — model-agnostic, engineering-grade</em>
+</p>
+
+<p align="center">
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"></a>
+  <a href="https://python.org"><img src="https://img.shields.io/badge/python-≥3.10-blue" alt="Python ≥3.10"></a>
+  <a href="https://github.com/Qinrayn/zall/actions/workflows/ci.yml"><img src="https://github.com/Qinrayn/zall/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/zall/"><img src="https://img.shields.io/pypi/v/zall" alt="PyPI"></a>
+  <br>
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#architecture">Architecture</a> •
+  <a href="#features">Features</a> •
+  <a href="#commands">Commands</a> •
+  <a href="#comparison">Comparison</a>
+</p>
+
+---
+
+## Quick Start
+
+```bash
+# Install
+pip install zall
+
+# Set API key (OpenAI-compatible)
+export ZALL_API_KEY="sk-..."
+export ZALL_MODEL="gpt-4o"
+
+# One-shot task
+zall "refactor the auth module to use async"
+
+# Interactive REPL
+zall
+> /help
+> /lsp status          # live code diagnostics
+> /codegraph index     # build symbol index
+> /codegraph search MyClass  # find symbols
+> /sandbox process     # isolated execution
+> /eval                # evaluate sessions
+> /replay <id>         # replay a session
+```
+
+---
+
+## Features
+
+### 🧠 Code Intelligence
+- **LSP Integration** — live diagnostics, go-to-definition, hover info, completions. Supports pyright, typescript-language-server, rust-analyzer, gopls, clangd.
+- **CodeGraph** — multi-language symbol indexer for Python/JS/TS/Rust/Go/Java/C++/Ruby/PHP/Swift. Search, outline, and navigate your codebase.
+- **`code_understanding` tool** — combine search + outline + read in one agent call.
+
+### 🛡️ Safety & Reproducibility
+- **PR-0**: Architectural hallucination detection — `stop_reason=STOP` with no `tool_calls` → flagged.
+- **Chain-hash timeline** — every session is cryptographically chained and replayable.
+- **ConfirmGate** — three-layer safety (rule engine + gate + override audit).
+- **Sandbox** — process isolation with worktree/process modes, resource limits.
+
+### 🔌 Extensibility
+- **Plugin system** — manifest-based plugins with git install, Python entry points.
+- **21 agent tools** — read/write/edit/bash/grep/glob/list_dir/search/web_fetch/spawn_subagent + LSP + CodeGraph.
+- **MCP support** — connect any MCP server.
+- **AgentDefinition** — YAML-based agent profiles with toolset presets.
+
+### 🎯 Agent Architecture
+- **ChatState** — actor-based message management with events, usage tracking, compaction.
+- **AgentBuilder** — fluent builder for AgentLoop construction.
+- **Subagent** — typed sub-agents (general-purpose, explore, plan) with capability isolation.
+- **5 toolset presets** — `zall`, `explore`, `plan`, `codex`, `opencode`.
+
+---
+
+## Architecture
+
+```
+zall/
+├── core/              # Primitives: model, agent, chat_state, gate, goal, safety, tool
+│   ├── loop.py        # AgentLoop orchestrator
+│   ├── agent.py       # AgentDefinition + ToolsetPreset + CapabilityMode
+│   ├── chat_state.py  # Actor-based message management (NEW)
+│   ├── safety.py      # Three-state context_judge
+│   ├── gate.py        # ConfirmGate state machine
+│   └── verifiability.py  # RunRecorder (chain-hash) + TrustAnchor
+├── cli/               # Rich REPL, 25+ slash commands, replay
+├── tools/             # 21 tools: read/write/edit/bash/grep/lsp/codegraph/…
+├── adapters/          # OpenAI-compat, Anthropic, Gemini, Ollama
+├── codegraph/         # Multi-language symbol indexer (NEW)
+├── lsp/               # LSP client (pyright, rust-analyzer, etc.) (NEW)
+├── sandbox/           # Process isolation (NEW)
+├── plugin/            # Plugin system (NEW)
+├── mcp/               # MCP client
+├── safety/            # Rule loader
+├── eval/              # 5-dimensional R-Metric evaluation
+└── skills/            # Skill loader
+```
+
+---
+
+## Commands
+
+### Built-in (25+)
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show all commands |
+| `/model` | Switch model |
+| `/plan` | Toggle plan mode |
+| `/lsp` | LSP diagnostics & servers (NEW) |
+| `/codegraph` | Code search & outline (NEW) |
+| `/sandbox` | Isolation mode control (NEW) |
+| `/chatstate` | ChatState diagnostics (NEW) |
+| `/plugin` | Plugin management (NEW) |
+| `/add` | Add file(s) to context |
+| `/drop` | Remove file(s) |
+| `/diff` | Show git diff |
+| `/search` | Web search |
+| `/web` | Fetch URL |
+| `/git` | Git commands |
+| `/commit` | Stage + commit |
+| `/sessions` | List sessions |
+| `/resume` | Resume session |
+| `/replay` | Replay session |
+| `/eval` | Evaluate session |
+| `/cost` | Token usage |
+| `/compact` | Compress context |
+| `/undo` | Undo last tool |
+| `/retry` | Retry last response |
+| `/doctor` | Diagnose setup |
+| `/checkpoint` | File snapshots |
+| `/clear` | Clear conversation |
+
+### Agent Tools (21)
+
+| Tool | Purpose |
+|------|---------|
+| `read_file` | Read file content |
+| `write_file` | Create/overwrite file |
+| `edit_file` | Targeted string replacement |
+| `batch_edit` | Multi-file batch edit |
+| `bash` | Shell commands |
+| `grep` | Search file contents |
+| `glob` | Find files by pattern |
+| `list_dir` | List directory |
+| `web_fetch` | Fetch web page |
+| `search` | Web search |
+| `read_image` | Read image content |
+| `spawn_subagent` | Delegate sub-task |
+| `todo_list` | Track progress |
+| `lsp_diagnostics` | Code errors/warnings (NEW) |
+| `lsp_hover` | Symbol info (NEW) |
+| `lsp_goto_definition` | Jump to definition (NEW) |
+| `codegraph_search` | Find symbols (NEW) |
+| `codegraph_outline` | File structure (NEW) |
+| `codegraph_index` | Build index (NEW) |
+| `code_understanding` | Deep code analysis (NEW) |
+| `project_analysis` | Project stats (NEW) |
+
+---
+
+## Comparison
+
+### vs Claude Code / Copilot
+
+| Feature | zall | Claude Code |
+|---------|------|------------|
+| Hallucination detection | **Architectural** (PR-0) | Prompt-based |
+| Reproducibility | Chain-hash + Replay | Log files only |
+| Safety | 3-layer gate | Implicit |
+| Model independence | 4 adapters (Protocol) | Anthropic-only |
+| Code intelligence | LSP + CodeGraph | Limited |
+| Sandbox isolation | Process/Worktree modes | None |
+| Plugin system | Manifest-based | None |
+| Open source | ✅ MIT | ❌ |
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/Qinrayn/zall.git
+cd zall
+pip install -e ".[dev,bs4]"
+python -m pytest tests/
+```
+
+See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+[MIT](LICENSE) © 2026 zall contributors

zall-0.4.1/README.md

@@ -0,0 +1,199 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/badge/zall-v0.4.1-blue?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a2e">
+    <img alt="zall" src="https://img.shields.io/badge/zall-v0.4.1-blue?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a2e">
+  </picture>
+</p>
+
+<p align="center">
+  <em>A falsifiable, reproducible coding agent CLI — model-agnostic, engineering-grade</em>
+</p>
+
+<p align="center">
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"></a>
+  <a href="https://python.org"><img src="https://img.shields.io/badge/python-≥3.10-blue" alt="Python ≥3.10"></a>
+  <a href="https://github.com/Qinrayn/zall/actions/workflows/ci.yml"><img src="https://github.com/Qinrayn/zall/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/zall/"><img src="https://img.shields.io/pypi/v/zall" alt="PyPI"></a>
+  <br>
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#architecture">Architecture</a> •
+  <a href="#features">Features</a> •
+  <a href="#commands">Commands</a> •
+  <a href="#comparison">Comparison</a>
+</p>
+
+---
+
+## Quick Start
+
+```bash
+# Install
+pip install zall
+
+# Set API key (OpenAI-compatible)
+export ZALL_API_KEY="sk-..."
+export ZALL_MODEL="gpt-4o"
+
+# One-shot task
+zall "refactor the auth module to use async"
+
+# Interactive REPL
+zall
+> /help
+> /lsp status          # live code diagnostics
+> /codegraph index     # build symbol index
+> /codegraph search MyClass  # find symbols
+> /sandbox process     # isolated execution
+> /eval                # evaluate sessions
+> /replay <id>         # replay a session
+```
+
+---
+
+## Features
+
+### 🧠 Code Intelligence
+- **LSP Integration** — live diagnostics, go-to-definition, hover info, completions. Supports pyright, typescript-language-server, rust-analyzer, gopls, clangd.
+- **CodeGraph** — multi-language symbol indexer for Python/JS/TS/Rust/Go/Java/C++/Ruby/PHP/Swift. Search, outline, and navigate your codebase.
+- **`code_understanding` tool** — combine search + outline + read in one agent call.
+
+### 🛡️ Safety & Reproducibility
+- **PR-0**: Architectural hallucination detection — `stop_reason=STOP` with no `tool_calls` → flagged.
+- **Chain-hash timeline** — every session is cryptographically chained and replayable.
+- **ConfirmGate** — three-layer safety (rule engine + gate + override audit).
+- **Sandbox** — process isolation with worktree/process modes, resource limits.
+
+### 🔌 Extensibility
+- **Plugin system** — manifest-based plugins with git install, Python entry points.
+- **21 agent tools** — read/write/edit/bash/grep/glob/list_dir/search/web_fetch/spawn_subagent + LSP + CodeGraph.
+- **MCP support** — connect any MCP server.
+- **AgentDefinition** — YAML-based agent profiles with toolset presets.
+
+### 🎯 Agent Architecture
+- **ChatState** — actor-based message management with events, usage tracking, compaction.
+- **AgentBuilder** — fluent builder for AgentLoop construction.
+- **Subagent** — typed sub-agents (general-purpose, explore, plan) with capability isolation.
+- **5 toolset presets** — `zall`, `explore`, `plan`, `codex`, `opencode`.
+
+---
+
+## Architecture
+
+```
+zall/
+├── core/              # Primitives: model, agent, chat_state, gate, goal, safety, tool
+│   ├── loop.py        # AgentLoop orchestrator
+│   ├── agent.py       # AgentDefinition + ToolsetPreset + CapabilityMode
+│   ├── chat_state.py  # Actor-based message management (NEW)
+│   ├── safety.py      # Three-state context_judge
+│   ├── gate.py        # ConfirmGate state machine
+│   └── verifiability.py  # RunRecorder (chain-hash) + TrustAnchor
+├── cli/               # Rich REPL, 25+ slash commands, replay
+├── tools/             # 21 tools: read/write/edit/bash/grep/lsp/codegraph/…
+├── adapters/          # OpenAI-compat, Anthropic, Gemini, Ollama
+├── codegraph/         # Multi-language symbol indexer (NEW)
+├── lsp/               # LSP client (pyright, rust-analyzer, etc.) (NEW)
+├── sandbox/           # Process isolation (NEW)
+├── plugin/            # Plugin system (NEW)
+├── mcp/               # MCP client
+├── safety/            # Rule loader
+├── eval/              # 5-dimensional R-Metric evaluation
+└── skills/            # Skill loader
+```
+
+---
+
+## Commands
+
+### Built-in (25+)
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show all commands |
+| `/model` | Switch model |
+| `/plan` | Toggle plan mode |
+| `/lsp` | LSP diagnostics & servers (NEW) |
+| `/codegraph` | Code search & outline (NEW) |
+| `/sandbox` | Isolation mode control (NEW) |
+| `/chatstate` | ChatState diagnostics (NEW) |
+| `/plugin` | Plugin management (NEW) |
+| `/add` | Add file(s) to context |
+| `/drop` | Remove file(s) |
+| `/diff` | Show git diff |
+| `/search` | Web search |
+| `/web` | Fetch URL |
+| `/git` | Git commands |
+| `/commit` | Stage + commit |
+| `/sessions` | List sessions |
+| `/resume` | Resume session |
+| `/replay` | Replay session |
+| `/eval` | Evaluate session |
+| `/cost` | Token usage |
+| `/compact` | Compress context |
+| `/undo` | Undo last tool |
+| `/retry` | Retry last response |
+| `/doctor` | Diagnose setup |
+| `/checkpoint` | File snapshots |
+| `/clear` | Clear conversation |
+
+### Agent Tools (21)
+
+| Tool | Purpose |
+|------|---------|
+| `read_file` | Read file content |
+| `write_file` | Create/overwrite file |
+| `edit_file` | Targeted string replacement |
+| `batch_edit` | Multi-file batch edit |
+| `bash` | Shell commands |
+| `grep` | Search file contents |
+| `glob` | Find files by pattern |
+| `list_dir` | List directory |
+| `web_fetch` | Fetch web page |
+| `search` | Web search |
+| `read_image` | Read image content |
+| `spawn_subagent` | Delegate sub-task |
+| `todo_list` | Track progress |
+| `lsp_diagnostics` | Code errors/warnings (NEW) |
+| `lsp_hover` | Symbol info (NEW) |
+| `lsp_goto_definition` | Jump to definition (NEW) |
+| `codegraph_search` | Find symbols (NEW) |
+| `codegraph_outline` | File structure (NEW) |
+| `codegraph_index` | Build index (NEW) |
+| `code_understanding` | Deep code analysis (NEW) |
+| `project_analysis` | Project stats (NEW) |
+
+---
+
+## Comparison
+
+### vs Claude Code / Copilot
+
+| Feature | zall | Claude Code |
+|---------|------|------------|
+| Hallucination detection | **Architectural** (PR-0) | Prompt-based |
+| Reproducibility | Chain-hash + Replay | Log files only |
+| Safety | 3-layer gate | Implicit |
+| Model independence | 4 adapters (Protocol) | Anthropic-only |
+| Code intelligence | LSP + CodeGraph | Limited |
+| Sandbox isolation | Process/Worktree modes | None |
+| Plugin system | Manifest-based | None |
+| Open source | ✅ MIT | ❌ |
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/Qinrayn/zall.git
+cd zall
+pip install -e ".[dev,bs4]"
+python -m pytest tests/
+```
+
+See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+[MIT](LICENSE) © 2026 zall contributors

zall-0.4.1/pyproject.toml

@@ -0,0 +1,95 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zall"
+version = "0.4.1"
+description = "zall — a falsifiable, reproducible coding agent CLI. Model-agnostic, chain-hashed, replayable."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "zall contributors" }]
+keywords = ["coding-agent", "cli", "ai", "llm", "developer-tools", "reproducible"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Software Development :: Debuggers",
+]
+dependencies = [
+    "pydantic>=2.5",
+    "cryptography>=42",
+    "httpx>=0.24",
+    "rich>=13",
+    "prompt_toolkit>=3.0",
+    "tomli>=2.0; python_version < '3.11'",
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4",
+    "mypy>=1.7",
+    "ruff>=0.1",
+    "pytest-cov>=4.0",
+]
+bs4 = [
+    "beautifulsoup4>=4.0",
+]
+images = [
+    "pillow>=10.0",
+]
+all = [
+    "zall[dev,bs4,images]",
+]
+
+[project.urls]
+Homepage = "https://github.com/qinrayn/zall"
+Repository = "https://github.com/qinrayn/zall"
+Documentation = "https://github.com/qinrayn/zall"
+Issues = "https://github.com/qinrayn/zall/issues"
+
+[project.scripts]
+zall = "zall.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.mypy]
+strict = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+disallow_untyped_defs = true
+disallow_any_generics = true
+# 模型无关的 CI 即使是 mypy 检验也强约束 (见 IMPL.md IPR-3)
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+# CI 将加自定义规则禁止 core/ 出现 openai / anthropic 等 import (IPR-3)
+# 见 scripts/check_ipr3.py (实现层下轮)
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v --tb=short"
+
+[tool.coverage.run]
+source = ["zall"]
+omit = ["*/tests/*", "*/__pycache__/*"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if __name__ == .__main__.:",
+    "raise AssertionError",
+    "raise NotImplementedError",
+]

zall-0.4.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

zall-0.4.1/src/zall/__init__.py

@@ -0,0 +1,7 @@
+"""zall — model-agnostic engineering agent.
+
+Model-agnostic engineering agent. This package MUST NOT import any model SDK;
+Model adapters reside in `zall.adapters`. See IMPL.md IPR-3.
+"""
+
+__version__ = "0.2.7"

zall-0.4.1/src/zall/__main__.py

@@ -0,0 +1,3 @@
+from zall.cli import main
+
+raise SystemExit(main())

zall-0.4.1/src/zall/_util/__init__.py

@@ -0,0 +1,15 @@
+"""zall._util — 内部共享toolfunction库。
+
+本包为 zall 内部使用的工具函数, 不构成 public API。
+各模块消除重复代码用 (B22/B23/B24 等)。
+"""
+
+from zall._util.file import is_binary, read_text_file
+from zall._util.path import NOISE_DIRS, is_noise, skip_noise_dirs
+from zall._util.string import unquote
+
+__all__ = [
+    "is_binary", "read_text_file",
+    "NOISE_DIRS", "is_noise", "skip_noise_dirs",
+    "unquote",
+]