cluxion-agentplugin-supercoder 0.1.0__tar.gz → 0.2.0__tar.gz

cluxion_agentplugin_supercoder-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v6.0.3
+      - uses: astral-sh/setup-uv@v8.2.0
+      - name: Set up Python
+        run: uv python install ${{ matrix.python-version }}
+      - name: Install
+        run: uv sync --extra dev --python ${{ matrix.python-version }}
+      - name: Lint
+        run: uv run ruff check .
+      - name: Test
+        run: uv run pytest
+      - name: Cargo test
+        run: cargo test --manifest-path rust/supercoder_index/Cargo.toml
+      - name: Build
+        run: uv run python -m build
+      - name: Check package
+        run: uv run twine check dist/*

cluxion_agentplugin_supercoder-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,109 @@
+name: Publish
+
+on:
+  release:
+    types: ["published"]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6.0.3
+      - uses: astral-sh/setup-uv@v8.2.0
+      - name: Set up Python
+        run: uv python install 3.12
+      - name: Install
+        run: uv sync --extra dev --python 3.12
+      - name: Lint
+        run: uv run ruff check .
+      - name: Test
+        run: uv run pytest
+      - name: Cargo test
+        run: cargo test --manifest-path rust/supercoder_index/Cargo.toml
+
+  # sdist + pure py3-none-any wheel: the fallback pip selects on platforms
+  # without a matching native wheel.
+  build-pure:
+    needs: checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6.0.3
+      - uses: astral-sh/setup-uv@v8.2.0
+      - name: Set up Python
+        run: uv python install 3.12
+      - name: Install build tooling
+        run: uv sync --extra dev --python 3.12
+      - name: Build sdist and pure wheel
+        run: uv run python -m build
+      - name: Check package
+        run: uv run twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-pure
+          path: dist/
+
+  # Platform wheels of the SAME project: the abi3 native module is merged
+  # into the pure wheel and the wheel is retagged. One PyPI project total.
+  build-native:
+    needs: build-pure
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+          - os: ubuntu-latest
+            target: aarch64
+          - os: macos-14
+            target: universal2-apple-darwin
+          - os: windows-latest
+            target: x64
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6.0.3
+      - uses: PyO3/maturin-action@v1
+        with:
+          working-directory: rust/supercoder_index
+          target: ${{ matrix.target }}
+          args: --release --strip --out dist
+          manylinux: auto
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist-pure
+          path: dist-pure/
+      - uses: astral-sh/setup-uv@v8.2.0
+      - name: Merge native module into project wheel
+        shell: bash
+        run: |
+          uv run --no-project --python 3.12 --with wheel \
+            python scripts/repack_native_wheel.py \
+            --pure-wheel dist-pure/*-py3-none-any.whl \
+            --native-wheel rust/supercoder_index/dist/*.whl \
+            --out dist-merged/
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-merged-${{ matrix.os }}-${{ matrix.target }}
+          path: dist-merged/
+
+  publish:
+    name: Publish cluxion-agentplugin-supercoder
+    needs: [build-pure, build-native]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist-pure
+          path: dist/
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: dist-merged-*
+          merge-multiple: true
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

{cluxion_agentplugin_supercoder-0.1.0 → cluxion_agentplugin_supercoder-0.2.0}/Docs/README.md

@@ -15,9 +15,9 @@
 
 ### 연결된 AI 사용 흐름
 
-1. 코딩 요청 → `supercoder_plan` (비코딩이면 `bypass`)
-2. `supercoder_cursor_map` / `supercoder_read_window` — bounded context
-3. `supercoder_patch` — expected hash 필수
+1. 코딩 요청 → `supercoder_plan` (비코딩이면 `bypass`; coding plan에 repo map 포함, `repo_map:false`로 opt-out)
+2. `supercoder_repo_map` / `supercoder_cursor_map` / `supercoder_read_window` — bounded context
+3. `supercoder_patch` — expected hash 필수; `supercoder_syntax_gate` / `supercoder_lint_gate`로 검증
 4. `supercoder_test_gate` — host terminal에서 테스트 실행
 5. `supercoder_brief` — evidence와 함께 완료 보고
 

{cluxion_agentplugin_supercoder-0.1.0 → cluxion_agentplugin_supercoder-0.2.0}/Docs/agent-surfaces.md

@@ -9,7 +9,7 @@ Supercoder는 Hermes plugin + `supercoder` toolset으로 연결됩니다.
 hermes plugins enable cluxion-agentplugin-supercoder
 ```
 
-Tools: `supercoder_plan`, `supercoder_read_window`, `supercoder_patch`, `supercoder_cursor_map`, `supercoder_test_gate`, `supercoder_brief`
+Tools (9): `supercoder_plan`, `supercoder_repo_map`, `supercoder_read_window`, `supercoder_patch`, `supercoder_cursor_map`, `supercoder_syntax_gate`, `supercoder_lint_gate`, `supercoder_test_gate`, `supercoder_brief`
 
 ## Claude / Codex / Grok
 

{cluxion_agentplugin_supercoder-0.1.0 → cluxion_agentplugin_supercoder-0.2.0}/Docs/architecture.md

@@ -19,7 +19,7 @@ flowchart TD
 ```
 src/cluxion_agentplugin_supercoder/
   plugin.py, runner.py
-  core/ — cursor, hash_patch, line_budget, safety, queue
+  core/ — cursor, hash_patch, repo_map, syntax_gate, lint_gate, line_budget, safety, queue
   rust_bridge.py
 rust/supercoder_index/
 ```

{cluxion_agentplugin_supercoder-0.1.0 → cluxion_agentplugin_supercoder-0.2.0}/Docs/capabilities.md

@@ -5,14 +5,16 @@ Supercoder가 **현재 제공하는** 기능입니다.
 ## Hermes 연동
 
 - Plugin entry + `supercoder` toolset
-- Tools: `supercoder_plan`, `supercoder_read_window`, `supercoder_patch`, `supercoder_cursor_map`, `supercoder_test_gate`, `supercoder_brief`
+- Tools (9): `supercoder_plan`, `supercoder_repo_map`, `supercoder_read_window`, `supercoder_patch`, `supercoder_cursor_map`, `supercoder_syntax_gate`, `supercoder_lint_gate`, `supercoder_test_gate`, `supercoder_brief`
 
 ## Core (Python)
 
 - `hash_patch` — exact/fuzzy match, stale detection
 - `cursor` — read_window, cursor_map
+- `repo_map` — budgeted files + top-level symbols (`files_omitted` honesty)
+- `syntax_gate`, `lint_gate` — parse-check and advisory ruff
 - `line_budget`, `safety` gates
-- `TaskQueue` / `plan_coding_task` — WorkUnit 분해
+- `TaskQueue` / `plan_coding_task` — WorkUnit 분해 (plan embeds 2000-char repo map by default)
 
 ## Rust sidecar
 

{cluxion_agentplugin_supercoder-0.1.0 → cluxion_agentplugin_supercoder-0.2.0}/Docs/design.md

@@ -58,6 +58,17 @@ hash/fuzzy match 로직:
 - 테스트: `tests_run` 또는 `tests_not_run_reason`
 - 불확실: `unknown_after_check` 허용, fake certainty 금지
 
+## Repo map
+
+`supercoder_repo_map`은 budgeted text map (files + top-level symbols with line numbers)을 반환합니다.
+budget을 넘는 파일은 `files_omitted`에 집계됩니다. `supercoder_plan`은 coding plan에 기본 2000-char repo map을 embed하며 `repo_map:false`로 opt-out 가능합니다.
+
+## Syntax and lint gates
+
+- `supercoder_syntax_gate` — tree-sitter parse-check (python/rust/js/ts/tsx/json; toml stdlib); unsupported languages fail-open
+- `supercoder_lint_gate` — advisory ruff (suggest-only, never blocks)
+- `supercoder_patch` — 기본 `syntax_gate=true` (parse 실패 시 revert), `lint_gate=true` (advisory findings)
+
 ## Lazy activation
 
 `is_coding_task()`가 false이면 `supercoder_plan`은 `mode=bypass`.

{cluxion_agentplugin_supercoder-0.1.0 → cluxion_agentplugin_supercoder-0.2.0}/Docs/rust-architecture.md

@@ -28,7 +28,7 @@ export CLUXION_SUPERCODER_INDEX_BIN=/path/to/supercoder-index
 
 ## Python 역할
 
-- `hash_patch`, `cursor`, `line_budget`, `safety` — 에이전트 tool handler
+- `hash_patch`, `cursor`, `repo_map`, `syntax_gate`, `lint_gate`, `line_budget`, `safety` — 에이전트 tool handler
 - `TaskQueue` / WorkUnit 분해
 - Hermes `register()` — `supercoder` toolset 등록
 - 연결된 AI가 skill·도구 지시에 따라 `supercoder_*` 호출

cluxion_agentplugin_supercoder-0.2.0/Docs/tools.md

@@ -0,0 +1,74 @@
+# Tools
+
+연결된 AI가 호출하는 `supercoder` toolset입니다.
+
+## `supercoder_plan`
+
+코딩 task를 WorkUnit 큐로 분해합니다. Coding plan에는 compact repo map (files + top-level symbols)이 포함됩니다.
+
+- 비코딩 prompt → `{ "mode": "bypass" }`
+- 코딩 prompt → `map` → `edit` → `verify` → `brief`
+
+입력: `prompt`, `task_id`, `cwd`, `repo_map` (기본 `true`), `repo_map_budget_chars` (기본 2000)
+
+## `supercoder_repo_map`
+
+budgeted repo map: line count가 있는 파일 목록 + top-level symbols (class/function/method/rust item/ts interface)와 line number.
+task 시작 시 orientation용. budget 초과 파일은 `files_omitted`에 집계 (silent drop 없음).
+
+입력: `cwd`, `max_files` (기본 128), `max_symbols_per_file` (기본 24), `budget_chars` (기본 8000)
+
+## `supercoder_read_window`
+
+bounded file read.
+
+입력: `path`, `start_line`, `max_lines` (기본 120), `cwd`  
+출력: `content`, `content_hash`, `file_hash`
+
+## `supercoder_patch`
+
+hash 검증 patch. `expected_file_hash` 없으면 stale로 거부.
+기본 `syntax_gate=true`: parse 실패 시 patch 자동 revert. `lint_gate=true`: 성공 후 advisory ruff findings 첨부 (never blocks).
+
+## `supercoder_syntax_gate`
+
+파일 또는 snippet parse-check (tree-sitter: python/rust/js/ts/tsx/json; stdlib: toml). 미지원 언어는 fail-open.
+
+입력: `path`, `content`, `language`, `cwd`
+
+## `supercoder_lint_gate`
+
+advisory ruff lint for one file (suggest-only; 프로젝트 ruff config 존중).
+
+입력: `path`, `cwd`
+
+## `supercoder_cursor_map`
+
+repo 내 소스 파일 index (확장자·깊이 제한).
+
+## `supercoder_test_gate`
+
+변경 파일 기반으로 테스트 명령을 **제안**합니다.
+
+- Python: `src/pkg/store.py` → matching test file anywhere in repo (`src/`, flat, tests-beside-code)
+- `.rs`/`.go`/`.js`/`.ts`: cargo/go/npm runner when project marker exists
+- `command`로 명시 override 가능
+- **연결된 AI**가 host terminal에서 실행하고, stdout/stderr를 `supercoder_brief.tests_run`에 기록
+
+## `supercoder_brief`
+
+`files_changed`, `tests_run`, `verification_status`, `remaining_risks` 요약.
+
+## WorkUnit 필드
+
+```text
+id, goal, priority
+allowed_paths, line_budget
+dependencies, expected_evidence
+status: pending | running | complete | failed | blocked
+```
+
+## Queue (내부)
+
+`TaskQueue.next_unit()` / `record()` — `supercoder_plan` 흐름에서 사용.  
+연결된 AI는 WorkUnit 순서에 맞게 위 도구를 호출합니다.

{cluxion_agentplugin_supercoder-0.1.0 → cluxion_agentplugin_supercoder-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cluxion-agentplugin-supercoder
-Version: 0.1.0
+Version: 0.2.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
@@ -11,10 +11,13 @@ Keywords: claude-code,cluxion,codex,coding,hermes-agent,plugin
 Requires-Python: >=3.11
 Requires-Dist: psutil>=5.9
 Requires-Dist: pyyaml>=6.0
+Requires-Dist: ruff>=0.8
 Provides-Extra: dev
 Requires-Dist: build>=1.2; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
 Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: twine>=6.0; extra == 'dev'
+Requires-Dist: wheel>=0.45; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # cluxion-Agentplugin-supercoder
@@ -50,9 +53,9 @@ patch 검증·인덱싱은 Rust, orchestration은 Python 래퍼입니다.
 ## 연결된 AI가 하는 일
 
 ```
-코딩 요청 → supercoder_plan
-         → cursor_map / read_window
-         → supercoder_patch (hash 필수)
+코딩 요청 → supercoder_plan (기본 repo map 포함; repo_map:false로 opt-out)
+         → supercoder_repo_map / cursor_map / read_window
+         → supercoder_patch (hash 필수; syntax/lint gate)
          → test_gate (host terminal 실행)
          → supercoder_brief (evidence 필수)
 ```
@@ -67,14 +70,17 @@ cluxion-supercoder check
 hermes plugins enable cluxion-agentplugin-supercoder
 ```
 
-## 도구 (`supercoder` toolset)
+## 도구 (`supercoder` toolset, 9 tools)
 
 | Tool | 설명 |
 |------|------|
-| `supercoder_plan` | WorkUnit 큐 |
+| `supercoder_plan` | WorkUnit 큐 (coding plan에 2000-char repo map 포함; `repo_map:false`로 opt-out) |
+| `supercoder_repo_map` | budgeted repo map (files + top-level symbols; `files_omitted`로 잘림 표시) |
 | `supercoder_read_window` | line-bounded read |
-| `supercoder_patch` | hash 검증 patch |
+| `supercoder_patch` | hash 검증 patch + L1 syntax gate (lint advisory) |
 | `supercoder_cursor_map` | repo index |
+| `supercoder_syntax_gate` | tree-sitter parse-check (python/rust/js/ts/tsx/json; toml stdlib) |
+| `supercoder_lint_gate` | advisory ruff lint (suggest-only) |
 | `supercoder_test_gate` | 테스트 제안 |
 | `supercoder_brief` | evidence 요약 |
 

{cluxion_agentplugin_supercoder-0.1.0 → cluxion_agentplugin_supercoder-0.2.0}/README.md

@@ -31,9 +31,9 @@ patch 검증·인덱싱은 Rust, orchestration은 Python 래퍼입니다.
 ## 연결된 AI가 하는 일
 
 ```
-코딩 요청 → supercoder_plan
-         → cursor_map / read_window
-         → supercoder_patch (hash 필수)
+코딩 요청 → supercoder_plan (기본 repo map 포함; repo_map:false로 opt-out)
+         → supercoder_repo_map / cursor_map / read_window
+         → supercoder_patch (hash 필수; syntax/lint gate)
          → test_gate (host terminal 실행)
          → supercoder_brief (evidence 필수)
 ```
@@ -48,14 +48,17 @@ cluxion-supercoder check
 hermes plugins enable cluxion-agentplugin-supercoder
 ```
 
-## 도구 (`supercoder` toolset)
+## 도구 (`supercoder` toolset, 9 tools)
 
 | Tool | 설명 |
 |------|------|
-| `supercoder_plan` | WorkUnit 큐 |
+| `supercoder_plan` | WorkUnit 큐 (coding plan에 2000-char repo map 포함; `repo_map:false`로 opt-out) |
+| `supercoder_repo_map` | budgeted repo map (files + top-level symbols; `files_omitted`로 잘림 표시) |
 | `supercoder_read_window` | line-bounded read |
-| `supercoder_patch` | hash 검증 patch |
+| `supercoder_patch` | hash 검증 patch + L1 syntax gate (lint advisory) |
 | `supercoder_cursor_map` | repo index |
+| `supercoder_syntax_gate` | tree-sitter parse-check (python/rust/js/ts/tsx/json; toml stdlib) |
+| `supercoder_lint_gate` | advisory ruff lint (suggest-only) |
 | `supercoder_test_gate` | 테스트 제안 |
 | `supercoder_brief` | evidence 요약 |
 

{cluxion_agentplugin_supercoder-0.1.0 → cluxion_agentplugin_supercoder-0.2.0}/pyproject.toml

@@ -4,24 +4,23 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cluxion-agentplugin-supercoder"
-version = "0.1.0"
+version = "0.2.0"
 description = "Universal agent coding harness plugin: cursor logic, safe patch, line budget, Rust index, test gates."
 readme = "README.md"
 requires-python = ">=3.11"
 license = "Apache-2.0"
 authors = [{ name = "cluxion", email = "algocean1204@users.noreply.github.com" }]
 keywords = ["cluxion", "hermes-agent", "claude-code", "codex", "coding", "plugin"]
-dependencies = ["psutil>=5.9", "PyYAML>=6.0"]
+dependencies = ["psutil>=5.9", "PyYAML>=6.0", "ruff>=0.8"]
 
 [project.optional-dependencies]
-dev = ["pytest>=8.0", "ruff>=0.8", "build>=1.2"]
+dev = ["pytest>=8.0", "ruff>=0.8", "build>=1.2", "twine>=6.0", "wheel>=0.45"]
 
 [project.scripts]
 cluxion-supercoder = "cluxion_agentplugin_supercoder.cli:main"
 
 [project.entry-points."hermes_agent.plugins"]
 cluxion-agentplugin-supercoder = "cluxion_agentplugin_supercoder.plugin"
-hermes-supercoder = "cluxion_agentplugin_supercoder.plugin"
 
 [project.urls]
 Homepage = "https://github.com/cluxion/cluxion-Agentplugin-supercoder"