cluxion-agentplugin-supercoder 0.2.15__tar.gz → 0.2.17__tar.gz

cluxion_agentplugin_supercoder-0.2.17/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "cluxion-agentplugin-supercoder",
+  "version": "0.2.17",
+  "description": "Universal agent coding harness plugin: cursor logic, safe patch, line budget, Rust index, and test gates.",
+  "author": "cluxion",
+  "commands": "./commands",
+  "skills": "./skills"
+}

cluxion_agentplugin_supercoder-0.2.17/.codex-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "cluxion-agentplugin-supercoder",
+  "version": "0.2.17",
+  "description": "Universal agent coding harness plugin: cursor logic, safe patch, line budget, Rust index, and test gates.",
+  "author": "cluxion",
+  "commands": "./commands",
+  "skills": "./skills"
+}

cluxion_agentplugin_supercoder-0.2.17/Docs/agent-surfaces.md

@@ -0,0 +1,48 @@
+# Agent Surfaces
+
+Supercoder uses one root plugin artifact for Codex and Claude Code, plus the existing Hermes
+entry point. Every surface calls the same `cluxion-supercoder` JSON contracts.
+
+## Codex
+
+Codex uses the root marketplace artifact:
+
+```bash
+codex plugin marketplace add cluxion-local /path/to/cluxion-Agentplugin-supercoder
+codex plugin add cluxion-agentplugin-supercoder@cluxion-local
+```
+
+Files:
+
+- `.codex-plugin/plugin.json`
+- `commands/`
+- `skills/supercoder/SKILL.md`
+
+No `[plugins.<name>] command = [...]` schema exists.
+
+## Claude Code
+
+Claude Code uses the same root layout:
+
+- `.claude-plugin/plugin.json`
+- `commands/`
+- `skills/supercoder/SKILL.md`
+
+## Hermes
+
+```bash
+hermes plugins enable cluxion-agentplugin-supercoder
+```
+
+Hermes registers the `supercoder` toolset through `hermes_agent.plugins`.
+
+Tools (10): `supercoder_plan`, `supercoder_repo_map`, `supercoder_read_window`, `supercoder_patch`,
+`supercoder_cursor_map`, `supercoder_syntax_gate`, `supercoder_lint_gate`, `supercoder_test_gate`,
+`supercoder_brief`, `supercoder_doctor`
+
+## Host Agent Rules
+
+1. Run `cluxion-supercoder plan --json-stdin` only for coding requests; respect `mode=bypass`.
+2. Run `read-window` before each patch and use the returned `file_hash`.
+3. Run suggested tests in the host terminal and record evidence in `brief`.
+4. Report stale cursors, retry exhaustion, and blocked checks honestly.

cluxion_agentplugin_supercoder-0.2.17/Docs/installation.md

@@ -0,0 +1,65 @@
+# Installation
+
+## Requirements
+
+- Python 3.11+
+- Optional Rust toolchain for `supercoder-index`
+
+## Python package
+
+```bash
+pip install cluxion-agentplugin-supercoder
+cluxion-supercoder check
+```
+
+Development:
+
+```bash
+uv venv && uv pip install -e ".[dev]"
+uv run pytest
+uv run ruff check .
+```
+
+## Codex marketplace install
+
+Local path example:
+
+```bash
+codex plugin marketplace add cluxion-local /path/to/cluxion-Agentplugin-supercoder
+codex plugin add cluxion-agentplugin-supercoder@cluxion-local
+```
+
+Git URL example:
+
+```bash
+codex plugin marketplace add cluxion https://github.com/cluxion/cluxion-Agentplugin-supercoder
+codex plugin add cluxion-agentplugin-supercoder@cluxion
+```
+
+Do not use a `[plugins.<name>] command = [...]` block; Codex plugins are marketplace plugins.
+
+## Claude Code plugin install
+
+Install the same repository from the root `.claude-plugin/plugin.json`, then use the `supercoder`
+skill or `/supercoder` and `/supercoder-doctor` commands. The commands call `cluxion-supercoder`
+and leave model execution to the host agent.
+
+## Hermes Agent
+
+```bash
+hermes plugins enable cluxion-agentplugin-supercoder
+```
+
+toolset: `supercoder`
+
+Hermes support stays on the existing `hermes_agent.plugins` entry point. Slash commands are registered
+by the plugin at session start.
+
+## Rust sidecar (optional)
+
+```bash
+cargo build --release --manifest-path rust/supercoder_index/Cargo.toml
+export CLUXION_SUPERCODER_INDEX_BIN=/path/to/supercoder-index
+```
+
+`cluxion-supercoder check` reports `rust_index: true` when the sidecar is available.

{cluxion_agentplugin_supercoder-0.2.15 → cluxion_agentplugin_supercoder-0.2.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cluxion-agentplugin-supercoder
-Version: 0.2.15
+Version: 0.2.17
 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
@@ -73,7 +73,7 @@ cluxion-supercoder doctor --json   # 구조화 출력
 
 Hermes 안에서는 `supercoder_doctor` 도구로도 노출됩니다.
 
-## Hermes 슬래시 커맨드 (0.2.15+)
+## Slash commands and marketplace plugins (0.2.17+)
 
 ```
 /supercoder fix failing auth tests and run gates
@@ -87,6 +87,13 @@ Hermes 안에서는 `supercoder_doctor` 도구로도 노출됩니다.
 
 `/` 입력 시 `/super`로 필터 가능 · `deliver=agent`로 작업 지시가 에이전트 턴에 전달됩니다.
 
+Codex와 Claude Code는 루트 plugin artifact를 설치합니다:
+
+```bash
+codex plugin marketplace add cluxion-local /path/to/cluxion-Agentplugin-supercoder
+codex plugin add cluxion-agentplugin-supercoder@cluxion-local
+```
+
 ## 라이선스
 
 Apache-2.0
@@ -142,7 +149,7 @@ cluxion-supercoder doctor --json   # structured output
 
 Also exposed inside Hermes as the `supercoder_doctor` tool.
 
-## Hermes slash commands (0.2.15+)
+## Slash commands and marketplace plugins (0.2.17+)
 
 ```
 /supercoder fix failing auth tests and run gates
@@ -156,6 +163,13 @@ Also exposed inside Hermes as the `supercoder_doctor` tool.
 
 Filter with `/super` · uses `deliver=agent` so the harness directive becomes the next agent turn.
 
+Codex and Claude Code install from the root plugin artifact:
+
+```bash
+codex plugin marketplace add cluxion-local /path/to/cluxion-Agentplugin-supercoder
+codex plugin add cluxion-agentplugin-supercoder@cluxion-local
+```
+
 ## License
 
 Apache-2.0

{cluxion_agentplugin_supercoder-0.2.15 → cluxion_agentplugin_supercoder-0.2.17}/README.md

@@ -50,7 +50,7 @@ cluxion-supercoder doctor --json   # 구조화 출력
 
 Hermes 안에서는 `supercoder_doctor` 도구로도 노출됩니다.
 
-## Hermes 슬래시 커맨드 (0.2.15+)
+## Slash commands and marketplace plugins (0.2.17+)
 
 ```
 /supercoder fix failing auth tests and run gates
@@ -64,6 +64,13 @@ Hermes 안에서는 `supercoder_doctor` 도구로도 노출됩니다.
 
 `/` 입력 시 `/super`로 필터 가능 · `deliver=agent`로 작업 지시가 에이전트 턴에 전달됩니다.
 
+Codex와 Claude Code는 루트 plugin artifact를 설치합니다:
+
+```bash
+codex plugin marketplace add cluxion-local /path/to/cluxion-Agentplugin-supercoder
+codex plugin add cluxion-agentplugin-supercoder@cluxion-local
+```
+
 ## 라이선스
 
 Apache-2.0
@@ -119,7 +126,7 @@ cluxion-supercoder doctor --json   # structured output
 
 Also exposed inside Hermes as the `supercoder_doctor` tool.
 
-## Hermes slash commands (0.2.15+)
+## Slash commands and marketplace plugins (0.2.17+)
 
 ```
 /supercoder fix failing auth tests and run gates
@@ -133,6 +140,13 @@ Also exposed inside Hermes as the `supercoder_doctor` tool.
 
 Filter with `/super` · uses `deliver=agent` so the harness directive becomes the next agent turn.
 
+Codex and Claude Code install from the root plugin artifact:
+
+```bash
+codex plugin marketplace add cluxion-local /path/to/cluxion-Agentplugin-supercoder
+codex plugin add cluxion-agentplugin-supercoder@cluxion-local
+```
+
 ## License
 
 Apache-2.0

cluxion_agentplugin_supercoder-0.2.17/commands/supercoder-doctor.md

@@ -0,0 +1,9 @@
+---
+description: Run Cluxion Supercoder diagnostics.
+---
+
+Run:
+
+```bash
+cluxion-supercoder doctor
+```

cluxion_agentplugin_supercoder-0.2.17/commands/supercoder.md

@@ -0,0 +1,18 @@
+---
+description: Run Cluxion Supercoder planning for a coding task.
+argument-hint: "<task>"
+---
+
+Run:
+
+```bash
+cluxion-supercoder plan --json-stdin
+```
+
+stdin:
+
+```json
+{"prompt":"$ARGUMENTS","cwd":"$PWD"}
+```
+
+Use the JSON contract to decide whether the task is a coding task. If `mode` is `coding_queue`, follow the Supercoder workflow from the `supercoder` skill before editing.

{cluxion_agentplugin_supercoder-0.2.15 → cluxion_agentplugin_supercoder-0.2.17}/plugin.yaml

@@ -1,5 +1,5 @@
 name: cluxion-agentplugin-supercoder
-version: 0.2.14
+version: 0.2.17
 description: "Universal agent coding harness: cursor, safe patch, line budget, Rust index."
 author: cluxion
 kind: standalone

{cluxion_agentplugin_supercoder-0.2.15 → cluxion_agentplugin_supercoder-0.2.17}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cluxion-agentplugin-supercoder"
-version = "0.2.15"
+version = "0.2.17"
 description = "Universal agent coding harness plugin: cursor logic, safe patch, line budget, Rust index, test gates."
 readme = "README.md"
 requires-python = ">=3.11"

cluxion_agentplugin_supercoder-0.2.17/skills/supercoder/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: cluxion-supercoder
+description: Use Cluxion Supercoder for coding tasks that need bounded reads, hash-verified patches, syntax/lint/test gates, or evidence-based briefs.
+---
+
+# Cluxion Supercoder
+
+Call the package CLI. It returns JSON contracts; the host agent owns file reads, edits, terminal commands, and final answers.
+
+## Plan
+
+```bash
+cluxion-supercoder plan --json-stdin
+```
+
+Minimum stdin:
+
+```json
+{"prompt":"<user request>","cwd":"<workspace>"}
+```
+
+If the result is `mode=bypass`, continue without Supercoder. If the result is `mode=coding_queue`, follow this workflow:
+
+1. Use the plan and embedded `repo_map` for orientation; call `repo-map` when more map context is needed.
+2. Call `read-window` before each edit and use the returned `file_hash`.
+3. Call `patch` with exact `old_text`, `new_text`, and `expected_file_hash`.
+4. Call `syntax-gate`, `lint-gate`, and `test-gate`; the host must run any suggested tests in the terminal.
+5. Call `brief` with `files_changed`, `tests_run`, `verification_status`, and remaining risks.
+
+## JSON Commands
+
+```bash
+cluxion-supercoder read-window --json-stdin
+cluxion-supercoder patch --json-stdin
+cluxion-supercoder cursor-map --json-stdin
+cluxion-supercoder repo-map --json-stdin
+cluxion-supercoder syntax-gate --json-stdin
+cluxion-supercoder lint-gate --json-stdin
+cluxion-supercoder test-gate --json-stdin
+cluxion-supercoder brief --json-stdin
+```
+
+## Doctor
+
+```bash
+cluxion-supercoder doctor
+cluxion-supercoder doctor --json
+```

{cluxion_agentplugin_supercoder-0.2.15 → cluxion_agentplugin_supercoder-0.2.17}/src/cluxion_agentplugin_supercoder/cli.py

@@ -7,11 +7,23 @@ from collections.abc import Sequence
 from importlib.resources import files
 from pathlib import Path
 
-from cluxion_agentplugin_supercoder import __version__
+from cluxion_agentplugin_supercoder import __version__, runner
 from cluxion_agentplugin_supercoder.doctor import render_json, render_text, run_doctor
 from cluxion_agentplugin_supercoder.doctor.probes import PROBES
 from cluxion_agentplugin_supercoder.rust_bridge import index_available, resolve_backend
 
+_JSON_COMMANDS = {
+    "plan": runner.plan,
+    "read-window": runner.read_window_tool,
+    "patch": runner.patch_tool,
+    "cursor-map": runner.cursor_map_tool,
+    "syntax-gate": runner.syntax_gate_tool,
+    "lint-gate": runner.lint_gate_tool,
+    "repo-map": runner.repo_map_tool,
+    "test-gate": runner.test_gate_tool,
+    "brief": runner.brief_tool,
+}
+
 
 def main(argv: Sequence[str] | None = None) -> int:
     parser = argparse.ArgumentParser(prog="cluxion-supercoder")
@@ -21,6 +33,9 @@ def main(argv: Sequence[str] | None = None) -> int:
     doctor_p = sub.add_parser("doctor", help="Run embedded doctor checks")
     doctor_p.add_argument("--json", action="store_true", help="Output JSON to stdout")
     doctor_p.add_argument("--verbose", action="store_true", help="Verbose text output")
+    for name in _JSON_COMMANDS:
+        command_p = sub.add_parser(name, help=f"Run {name} JSON contract")
+        command_p.add_argument("--json-stdin", action="store_true", help="Read request payload as JSON from stdin")
     args = parser.parse_args(argv)
     if args.command == "check":
         payload = {
@@ -45,10 +60,34 @@ def main(argv: Sequence[str] | None = None) -> int:
         if args.json:
             print(render_json(result))
         return 0 if result.ok else 1
+    if args.command in _JSON_COMMANDS:
+        return _run_json_command(args.command, bool(args.json_stdin))
     parser.print_help(sys.stderr)
     return 2
 
 
+def _run_json_command(command: str, json_stdin: bool) -> int:
+    if not json_stdin:
+        print(json.dumps({"ok": False, "error": "--json-stdin is required"}, ensure_ascii=False, sort_keys=True))
+        return 2
+    try:
+        raw = sys.stdin.read()
+        payload = json.loads(raw or "{}")
+    except json.JSONDecodeError as exc:
+        print(json.dumps({"ok": False, "error": f"invalid JSON stdin: {exc.msg}"}, ensure_ascii=False, sort_keys=True))
+        return 2
+    if not isinstance(payload, dict):
+        print(json.dumps({"ok": False, "error": "JSON stdin must be an object"}, ensure_ascii=False, sort_keys=True))
+        return 2
+    try:
+        result = _JSON_COMMANDS[command](payload)
+    except (ValueError, TypeError, OSError) as exc:
+        print(json.dumps({"ok": False, "error": str(exc)}, ensure_ascii=False, sort_keys=True))
+        return 1
+    print(result.to_json())
+    return 0 if result.ok else 1
+
+
 def load_catalog_for_text(catalog_path):
     # helper to avoid circular, but since framework has load_catalog
     from cluxion_agentplugin_supercoder.doctor.framework import load_catalog

{cluxion_agentplugin_supercoder-0.2.15 → cluxion_agentplugin_supercoder-0.2.17}/src/cluxion_agentplugin_supercoder/plugin.py

@@ -4,7 +4,6 @@ import json
 from collections.abc import Callable, Mapping
 
 from cluxion_agentplugin_supercoder import runner
-from cluxion_agentplugin_supercoder.core.test_gate import suggest_test_commands
 from cluxion_agentplugin_supercoder.schemas import (
     BRIEF_SCHEMA,
     CURSOR_MAP_SCHEMA,
@@ -69,11 +68,11 @@ def register(ctx: object) -> None:
         name="supercoder_test_gate",
         toolset="supercoder",
         schema=TEST_GATE_SCHEMA,
-        handler=_handle_test_gate,
+        handler=_wrap(runner.test_gate_tool),
         emoji="🧪",
     )
     ctx.register_tool(
-        name="supercoder_brief", toolset="supercoder", schema=BRIEF_SCHEMA, handler=_handle_brief, emoji="📋"
+        name="supercoder_brief", toolset="supercoder", schema=BRIEF_SCHEMA, handler=_wrap(runner.brief_tool), emoji="📋"
     )
     # doctor tool registration (additive)
     from importlib.resources import files
@@ -149,34 +148,4 @@ def _wrap(callback: Callable[[dict[str, object]], runner.ToolResult]) -> Callabl
     return handler
 
 
-def _handle_test_gate(args: dict[str, object], **_: object) -> str:
-    from pathlib import Path
-
-    raw_files = args.get("files_changed", [])
-    files_changed = [str(item) for item in raw_files] if isinstance(raw_files, list) else []
-    cwd_raw = str(args.get("cwd", ".")).strip() or "."
-    payload = suggest_test_commands(
-        files_changed,
-        command=str(args.get("command", "")).strip() or None,
-        cwd=Path(cwd_raw).expanduser().resolve(),
-    )
-    return json.dumps(payload, ensure_ascii=False, sort_keys=True)
-
-
-def _handle_brief(args: dict[str, object], **_: object) -> str:
-    return json.dumps(
-        {
-            "ok": True,
-            "brief": {
-                "files_changed": args.get("files_changed", []),
-                "tests_run": args.get("tests_run", []),
-                "verification_status": args.get("verification_status", "unknown_after_check"),
-                "remaining_risks": args.get("remaining_risks", []),
-            },
-        },
-        ensure_ascii=False,
-        sort_keys=True,
-    )
-
-
 __all__ = ["register"]

{cluxion_agentplugin_supercoder-0.2.15 → cluxion_agentplugin_supercoder-0.2.17}/src/cluxion_agentplugin_supercoder/runner.py

@@ -11,6 +11,7 @@ from cluxion_agentplugin_supercoder.core.hash_patch import apply_patch
 from cluxion_agentplugin_supercoder.core.line_budget import budget_for, is_coding_task
 from cluxion_agentplugin_supercoder.core.queue import plan_coding_task
 from cluxion_agentplugin_supercoder.core.safety import pre_tool_gate
+from cluxion_agentplugin_supercoder.core.test_gate import suggest_test_commands
 
 
 def _int(v: object, default: int) -> int:
@@ -199,8 +200,35 @@ def repo_map_tool(payload: Mapping[str, object]) -> ToolResult:
     return ToolResult(bool(result.get("ok", False)), {key: value for key, value in result.items() if key != "ok"})
 
 
+def test_gate_tool(payload: Mapping[str, object]) -> ToolResult:
+    raw_files = payload.get("files_changed", [])
+    files_changed = [str(item) for item in raw_files] if isinstance(raw_files, list) else []
+    cwd_raw = str(payload.get("cwd", ".")).strip() or "."
+    body = suggest_test_commands(
+        files_changed,
+        command=str(payload.get("command", "")).strip() or None,
+        cwd=Path(cwd_raw).expanduser().resolve(),
+    )
+    return ToolResult(bool(body.get("ok", False)), {key: value for key, value in body.items() if key != "ok"})
+
+
+def brief_tool(payload: Mapping[str, object]) -> ToolResult:
+    return ToolResult(
+        True,
+        {
+            "brief": {
+                "files_changed": payload.get("files_changed", []),
+                "tests_run": payload.get("tests_run", []),
+                "verification_status": payload.get("verification_status", "unknown_after_check"),
+                "remaining_risks": payload.get("remaining_risks", []),
+            },
+        },
+    )
+
+
 __all__ = [
     "ToolResult",
+    "brief_tool",
     "cursor_map_tool",
     "lint_gate_tool",
     "patch_tool",
@@ -208,4 +236,5 @@ __all__ = [
     "read_window_tool",
     "repo_map_tool",
     "syntax_gate_tool",
+    "test_gate_tool",
 ]

{cluxion_agentplugin_supercoder-0.2.15 → cluxion_agentplugin_supercoder-0.2.17}/src/cluxion_agentplugin_supercoder/slash_commands.py

@@ -22,10 +22,13 @@ Examples:
 
 Notes:
   - Patches are hash-verified; empty old_text is rejected immediately
-  - Repo map is attached to the plan when available
+  - Slash dispatch skips repo_map (fast); agent calls supercoder_plan for map
   - Diagnostics: /supercoder-doctor
 """
 
+# Hermes Desktop gateway RPC times out at 30s; repo_map on large cwds can exceed that.
+_SLASH_PLAN_KWARGS: dict[str, object] = {"repo_map": False}
+
 
 def build_supercoder_directive(task: str, plan_payload: dict[str, object]) -> str:
     plan_block = json.dumps(plan_payload, ensure_ascii=False, indent=2)
@@ -34,7 +37,7 @@ def build_supercoder_directive(task: str, plan_payload: dict[str, object]) -> st
         "Use the supercoder toolset for all code changes in this task.\n\n"
         f"Task: {task}\n\n"
         "Required sequence:\n"
-        "1. Use the supercoder_plan result below (do not skip repo_map)\n"
+        "1. Use the plan below; call supercoder_plan for a fresh repo_map if needed\n"
         "2. supercoder_read_window before each edit\n"
         "3. supercoder_patch only with verified old_text hashes\n"
         "4. supercoder_syntax_gate → supercoder_lint_gate → supercoder_test_gate after edits\n"
@@ -49,7 +52,9 @@ def handle_supercoder(raw_args: str, ctx: object | None = None) -> str:
     if not task or task.lower() in {"help", "-h", "--help"}:
         return SUPERCODER_HELP
     try:
-        result = runner.plan({"prompt": task, "cwd": str(Path.cwd())})
+        result = runner.plan(
+            {"prompt": task, "cwd": str(Path.cwd()), **_SLASH_PLAN_KWARGS},
+        )
         payload = json.loads(result.to_json())
         if not payload.get("ok"):
             return f"supercoder error: {payload.get('error', 'plan failed')}"

cluxion_agentplugin_supercoder-0.2.17/tests/test_cli_contract.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import json
+
+from cluxion_agentplugin_supercoder import cli
+
+
+def test_plan_cli_reads_json_stdin(tmp_path, monkeypatch, capsys) -> None:
+    monkeypatch.setattr(
+        "sys.stdin",
+        type("Stdin", (), {"read": lambda self: json.dumps({"prompt": "fix tests", "cwd": str(tmp_path)})})(),
+    )
+
+    assert cli.main(["plan", "--json-stdin"]) == 0
+
+    payload = json.loads(capsys.readouterr().out)
+    assert payload["ok"] is True
+    assert payload["mode"] == "coding_queue"
+
+
+def test_cli_reports_bad_json_stdin(monkeypatch, capsys) -> None:
+    monkeypatch.setattr("sys.stdin", type("Stdin", (), {"read": lambda self: "not json"})())
+
+    assert cli.main(["plan", "--json-stdin"]) == 2
+
+    payload = json.loads(capsys.readouterr().out)
+    assert payload["ok"] is False
+    assert "invalid JSON" in payload["error"]

cluxion_agentplugin_supercoder-0.2.17/tests/test_packaging_policy.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import json
+import tomllib
+from pathlib import Path
+
+import yaml
+
+
+def test_root_plugin_artifacts_are_version_synced() -> None:
+    pyproject = tomllib.loads(Path("pyproject.toml").read_text(encoding="utf-8"))
+    version = pyproject["project"]["version"]
+
+    claude = json.loads(Path(".claude-plugin/plugin.json").read_text(encoding="utf-8"))
+    codex = json.loads(Path(".codex-plugin/plugin.json").read_text(encoding="utf-8"))
+    root_yaml = yaml.safe_load(Path("plugin.yaml").read_text(encoding="utf-8"))
+
+    assert claude["version"] == version
+    assert codex["version"] == version
+    assert str(root_yaml["version"]) == version
+    assert Path("commands/supercoder.md").is_file()
+    assert Path("commands/supercoder-doctor.md").is_file()
+    assert Path("skills/supercoder/SKILL.md").is_file()
+
+
+def test_per_surface_adapter_forks_are_removed() -> None:
+    assert not Path("adapters/codex").exists()
+    assert not Path("adapters/claude").exists()
+

{cluxion_agentplugin_supercoder-0.2.15 → cluxion_agentplugin_supercoder-0.2.17}/tests/test_slash_commands.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import json
 
+from cluxion_agentplugin_supercoder import runner
 from cluxion_agentplugin_supercoder.slash_commands import (
     SUPERCODER_HELP,
     build_supercoder_directive,
@@ -28,6 +29,20 @@ def test_handle_supercoder_bypass(tmp_path, monkeypatch) -> None:
     assert "not a coding task" in out
 
 
+def test_handle_supercoder_skips_repo_map_for_fast_dispatch(tmp_path, monkeypatch) -> None:
+    monkeypatch.chdir(tmp_path)
+    captured: list[dict[str, object]] = []
+
+    def _spy(payload: dict[str, object]) -> runner.ToolResult:
+        captured.append(dict(payload))
+        return runner.plan(payload)
+
+    monkeypatch.setattr(runner, "plan", _spy)
+    handle_supercoder("implement pagination in the users API")
+    assert captured
+    assert captured[0].get("repo_map") is False
+
+
 def test_handle_supercoder_returns_directive(tmp_path, monkeypatch) -> None:
     monkeypatch.chdir(tmp_path)
     (tmp_path / "a.py").write_text("x=1\n", encoding="utf-8")

{cluxion_agentplugin_supercoder-0.2.15 → cluxion_agentplugin_supercoder-0.2.17}/uv.lock

@@ -160,7 +160,7 @@ wheels = [
 
 [[package]]
 name = "cluxion-agentplugin-supercoder"
-version = "0.2.15"
+version = "0.2.17"
 source = { editable = "." }
 dependencies = [
     { name = "psutil" },

cluxion_agentplugin_supercoder-0.2.15/Docs/agent-surfaces.md

@@ -1,24 +0,0 @@
-# Agent Surfaces
-
-Supercoder는 Hermes plugin + `supercoder` toolset으로 연결됩니다.  
-**연결된 AI**가 코딩 task에서 `supercoder_*` 도구를 호출합니다.
-
-## Hermes
-
-```bash
-hermes plugins enable cluxion-agentplugin-supercoder
-```
-
-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
-
-동일 tool semantics를 skill·CLI로 안내합니다.  
-코딩 bounded read·patch·evidence 규칙은 Hermes와 같습니다.
-
-## 연결된 AI 규칙
-
-1. 코딩 요청만 `supercoder_plan` — 그 외 `bypass`
-2. patch 전 `read_window`로 hash 확보
-3. 테스트는 host terminal 실행 후 brief에 evidence 기록
-4. stale·blocked 시 사용자에게 명시적 보고

cluxion_agentplugin_supercoder-0.2.15/Docs/installation.md

@@ -1,45 +0,0 @@
-# Installation
-
-## 요구 사항
-
-- Python 3.11+
-- (선택) Rust — `supercoder-index` 빌드
-
-## 설치
-
-```bash
-pip install cluxion-agentplugin-supercoder
-cluxion-supercoder check
-```
-
-개발:
-
-```bash
-uv venv && uv pip install -e ".[dev]"
-uv run pytest
-uv run ruff check .
-```
-
-## Hermes Agent
-
-```bash
-hermes plugins enable cluxion-agentplugin-supercoder
-```
-
-toolset: `supercoder`
-
-레거시 entry point 이름 `hermes-supercoder`도 호환용으로 제공됩니다.
-
-## Rust sidecar (선택)
-
-```bash
-cargo build --release --manifest-path rust/supercoder_index/Cargo.toml
-export CLUXION_SUPERCODER_INDEX_BIN=/path/to/supercoder-index
-```
-
-`cluxion-supercoder check`에서 `rust_index: true` 확인.
-
-## 다른 에이전트
-
-Claude / Codex / Grok: `plugin.yaml`의 `surfaces` 목록 참고.  
-각 환경의 공식 plugin/skill 메커니즘으로 `register()` 또는 skill 문서를 연결합니다.

cluxion_agentplugin_supercoder-0.2.15/adapters/claude/.claude-plugin/plugin.json

@@ -1,6 +0,0 @@
-{
-  "name": "cluxion-supercoder",
-  "version": "0.1.0",
-  "description": "Coding harness plugin for Claude Code",
-  "author": "cluxion"
-}

cluxion_agentplugin_supercoder-0.2.15/adapters/claude/skills/supercoder/SKILL.md

@@ -1,30 +0,0 @@
----
-name: cluxion-supercoder
-description: Coding harness for bounded reads, hash-verified patches, and evidence-based briefs. You (the connected AI) call supercoder tools before editing code.
----
-
-# Supercoder — 연결된 AI 지시문
-
-코딩 작업에서 **당신(연결된 AI)** 이 `supercoder_*` 도구를 호출합니다.
-
-## 흐름
-
-1. `supercoder_plan` — 코딩 task면 WorkUnit 큐, 아니면 `bypass`
-2. `supercoder_cursor_map` / `supercoder_read_window` — bounded context + hashes
-3. `supercoder_patch` — `expected_file_hash` 필수
-4. host terminal에서 테스트 실행
-5. `supercoder_brief` — `files_changed`, `tests_run` evidence 필수
-
-## 규칙
-
-- patch 전 반드시 read_window로 hash 확보
-- stale hash면 patch 거부 — 다시 read
-- 테스트 통과를 주장하려면 실제 실행 결과를 brief에 기록
-- 비코딩 질문은 plan bypass로 오버헤드 최소화
-
-## 설치 확인
-
-```bash
-cluxion-supercoder check
-hermes plugins enable cluxion-agentplugin-supercoder
-```

cluxion_agentplugin_supercoder-0.2.15/adapters/codex/config-snippet.toml

@@ -1,6 +0,0 @@
-# Codex 연동 참고 — 연결된 AI가 supercoder 도구/CLI 사용
-# Hermes: hermes plugins enable cluxion-agentplugin-supercoder
-# Skill 규칙: adapters/claude/skills/supercoder/SKILL.md 와 동일
-
-# 코딩 task 시:
-#   supercoder_plan → read_window → patch (hash) → test (host terminal) → brief

cluxion_agentplugin_supercoder-0.2.15/adapters/hermes/README.md

@@ -1,20 +0,0 @@
-# Hermes adapter
-
-```bash
-pip install cluxion-agentplugin-supercoder
-hermes plugins enable cluxion-agentplugin-supercoder
-cluxion-supercoder check
-```
-
-Tools: `supercoder_plan`, `supercoder_read_window`, `supercoder_patch`, `supercoder_cursor_map`, `supercoder_test_gate`, `supercoder_brief`
-
-연결된 AI가 코딩 task에서 위 도구를 순서대로 호출합니다.
-
-## 슬래시 (0.2.15+)
-
-```
-/supercoder <task>        # 코딩 모드 — plan + 패치/게이트 워크플로우 지시
-/supercoder-doctor
-```
-
-`/` 입력 시 `/super`로 필터 · `/supercoder`는 에이전트 턴으로 전달(`deliver=agent`).