Metadata-Version: 2.4
Name: cluxion-agentplugin-supercoder
Version: 0.1.0
Summary: Universal agent coding harness plugin: cursor logic, safe patch, line budget, Rust index, test gates.
Project-URL: Homepage, https://github.com/cluxion/cluxion-Agentplugin-supercoder
Project-URL: Repository, https://github.com/cluxion/cluxion-Agentplugin-supercoder
Project-URL: Issues, https://github.com/cluxion/cluxion-Agentplugin-supercoder/issues
Author-email: cluxion <algocean1204@users.noreply.github.com>
License-Expression: Apache-2.0
Keywords: claude-code,cluxion,codex,coding,hermes-agent,plugin
Requires-Python: >=3.11
Requires-Dist: psutil>=5.9
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# cluxion-Agentplugin-supercoder

범용 에이전트 **코딩 하네스 플러그인** — **Hermes, Claude Code, Codex, Grok Build**에서 동일 core로 동작합니다.

**Repository:** https://github.com/cluxion/cluxion-Agentplugin-supercoder

## 한 줄 요약

코딩 시 **큰 파일 추측·stale patch**를 막습니다. **연결된 AI**가 `supercoder_*` 도구로 bounded read·hash 검증 patch·evidence brief를 수행합니다.

## 범용 에이전트 + Rust-First

| 계층 | 구현 |
|------|------|
| **Rust** (`supercoder-index`) | file hash, repo scan |
| **Python** (`core/`, `runner`) | cursor, patch, safety, plugin |
| **Agent adapter** | Hermes plugin + `supercoder` toolset |

patch 검증·인덱싱은 Rust, orchestration은 Python 래퍼입니다.

## 이 플러그인의 역할

- **Cursor logic** — line window, file/content hash
- **Safe patch** — hash 검증, stale 차단
- **Line budget** — 과도한 read/write 차단
- **WorkUnit queue** — map → edit → verify → brief
- **Safety gate** — workspace escape·destructive command 차단

**모델·OAuth는 host 소유.** Supercoder는 plan·검증·evidence 계약만 제공합니다.

## 연결된 AI가 하는 일

```
코딩 요청 → supercoder_plan
         → cursor_map / read_window
         → supercoder_patch (hash 필수)
         → test_gate (host terminal 실행)
         → supercoder_brief (evidence 필수)
```

비코딩 질문은 `bypass`로 오버헤드 최소화.

## 빠른 시작

```bash
pip install cluxion-agentplugin-supercoder
cluxion-supercoder check
hermes plugins enable cluxion-agentplugin-supercoder
```

## 도구 (`supercoder` toolset)

| Tool | 설명 |
|------|------|
| `supercoder_plan` | WorkUnit 큐 |
| `supercoder_read_window` | line-bounded read |
| `supercoder_patch` | hash 검증 patch |
| `supercoder_cursor_map` | repo index |
| `supercoder_test_gate` | 테스트 제안 |
| `supercoder_brief` | evidence 요약 |

## Adapters

- `adapters/hermes/` — Hermes enable 가이드
- `adapters/claude/skills/supercoder/` — Claude skill
- `adapters/codex/config-snippet.toml` — Codex 참고

## 문서

- [Docs/README.md](Docs/README.md) — **처음 읽는 분** + 목차
- [Docs/architecture.md](Docs/architecture.md)
- [Docs/design.md](Docs/design.md)
- [Docs/installation.md](Docs/installation.md)
- [Docs/tools.md](Docs/tools.md)
- [Docs/agent-surfaces.md](Docs/agent-surfaces.md)
- [Docs/capabilities.md](Docs/capabilities.md)
- [Docs/rust-architecture.md](Docs/rust-architecture.md)

## License

Apache-2.0