cluxion-agentplugin-preprocessing 0.2.0__tar.gz

cluxion_agentplugin_preprocessing-0.2.0/.github/profile/README.md

@@ -0,0 +1,67 @@
+# hermes-cluxion
+
+`hermes-cluxion` is a lightweight Cluxion harness plugin for Hermes Agent.
+
+It keeps Hermes in control of OAuth, provider auth, active model selection, tools, permissions, and final AI completion calls. Cluxion adds deterministic work planning around Hermes: preprocessing, intent routing, honesty contracts, queued segment dispatch, resource admission, and optional local `vllm-mlx` endpoint setup.
+
+## Install
+
+```bash
+python -m pip install "hermes-cluxion==0.1.9"
+hermes-cluxion enable
+hermes-cluxion check
+```
+
+Confirm the plugin is enabled:
+
+```bash
+hermes tools list
+```
+
+Expected:
+
+```text
+Plugin toolsets (cli):
+  ✓ enabled  cluxion  🔌 Cluxion
+```
+
+## Hermes Tools
+
+- `cluxion_plan`
+- `cluxion_bootstrap`
+- `cluxion_serve_local`
+- `cluxion_hermes_config`
+- `cluxion_queue_next`
+- `cluxion_queue_record`
+- `cluxion_queue_brief`
+
+## Execution Model
+
+- Cloud AI calls stay inside Hermes.
+- Local model calls also stay inside Hermes after switching to a custom local provider.
+- Cluxion returns `host_execution`, `answer_policy`, queue metadata, and resource decisions.
+- Short simple prompts do not pay queue or resource snapshot cost.
+- Short verification prompts get required checks without heavy preprocessing.
+- Long work uses durable queued segment dispatch and final briefing synthesis.
+
+## Local MLX Flow
+
+```bash
+hermes-cluxion bootstrap --upgrade
+hermes-cluxion hermes-config \
+  --model mlx-community/Qwen3.6-35B-A3B-OptiQ-4bit \
+  --port 23003 \
+  --context-length 131072
+cluxion-runtime serve-local \
+  --model mlx-community/Qwen3.6-35B-A3B-OptiQ-4bit \
+  --port 23003 \
+  --upgrade-runtime
+```
+
+Then switch Hermes:
+
+```text
+/model custom:cluxion-local:mlx-community/Qwen3.6-35B-A3B-OptiQ-4bit
+```
+
+Full guide: [README](../../README.md)

cluxion_agentplugin_preprocessing-0.2.0/.gitignore

@@ -0,0 +1,10 @@
+.DS_Store
+.ruff_cache/
+.pytest_cache/
+.venv/
+__pycache__/
+*.py[cod]
+build/
+dist/
+*.egg-info/
+rust/**/target/

cluxion_agentplugin_preprocessing-0.2.0/LICENSE

@@ -0,0 +1,197 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      patent license to make, have made, use, offer to sell, sell, import,
+      and otherwise transfer the Work, where such license applies only to
+      those patent claims licensable by such Contributor that are necessarily
+      infringed by their Contribution(s) alone or by combination of their
+      Contribution(s) with the Work to which such Contribution(s) was
+      submitted. If You institute patent litigation against any entity
+      (including a cross-claim or counterclaim in a lawsuit) alleging that
+      the Work or a Contribution incorporated within the Work constitutes
+      direct or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate as
+      of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+      Copyright 2026 Cluxion
+
+      Licensed under the Apache License, Version 2.0 (the "License");
+      you may not use this file except in compliance with the License.
+      You may obtain a copy of the License at
+
+          https://www.apache.org/licenses/LICENSE-2.0
+
+      Unless required by applicable law or agreed to in writing, software
+      distributed under the License is distributed on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+      See the License for the specific language governing permissions and
+      limitations under the License.

cluxion_agentplugin_preprocessing-0.2.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: cluxion-agentplugin-preprocessing
+Version: 0.2.0
+Summary: Universal agent plugin for Cluxion preprocessing, honesty contracts, clarification, Rust work queue, and resource-aware harness handoff.
+Project-URL: Homepage, https://github.com/cluxion/cluxion-Agentplugin-preprocessing
+Project-URL: Repository, https://github.com/cluxion/cluxion-Agentplugin-preprocessing
+Project-URL: Issues, https://github.com/cluxion/cluxion-Agentplugin-preprocessing/issues
+Author-email: cluxion <algocean1204@users.noreply.github.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: ai-agent,claude-code,cluxion,codex,hermes-agent,plugin,preprocessing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Plugins
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+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'
+Requires-Dist: twine>=6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# cluxion-Agentplugin-preprocessing
+
+범용 에이전트 **전처리 플러그인** — **Hermes, Claude Code, Codex, Grok Build**에서 동일 core로 동작합니다.
+
+**Repository:** https://github.com/cluxion/cluxion-Agentplugin-preprocessing
+
+## 한 줄 요약
+
+작업 시작 전에 **방향·정직함·큐**를 정리합니다. **연결된 AI**가 `cluxion_plan` 등 도구를 호출하고, JSON 계약(`answer_policy`, `host_execution`)에 따라 응답합니다. 플러그인은 추가 LLM 호출 없이 결정론적 plan만 반환합니다.
+
+## 범용 에이전트 + Rust-First
+
+| 계층 | 구현 |
+|------|------|
+| **Rust** (`cluxion-queue`) | SQLite 작업큐, atomic dispatch |
+| **Python** (`cluxion_runtime`, adapter) | harness plan, 전처리, CLI |
+| **Agent adapter** | `adapters/` — Hermes plugin, Claude skill, Codex snippet |
+
+내부 hot path는 **Rust**. Python은 등록·JSON bridge·fallback입니다.
+
+## 이 플러그인의 역할
+
+- **정직함**: context 부족 시 모른다고 답하도록 `answer_policy` 생성
+- **명확화**: 의도가 애매하면 큐 진입 전 질문 (`needs_clarification`)
+- **작업큐**: 긴 입력을 segment로 분할, checksum 보존
+- **리소스 admission**: RAM/CPU 압력에 따른 실행 허용 (결정론적)
+
+**모델·OAuth·provider는 host agent 소유.** Cluxion은 plan·게이트·큐 메타데이터만 반환합니다.
+
+## 연결된 AI가 하는 일
+
+| 단계 | 동작 |
+|------|------|
+| 요청 수신 | `cluxion_plan` 또는 `cluxion-runtime plan` |
+| 명확화 필요 | `clarification.questions`로 사용자에게 질문 |
+| queued 모드 | `cluxion_queue_next` → 처리 → `cluxion_queue_record` → `cluxion_queue_brief` |
+| 응답 | `answer_policy.required_checks` 준수 |
+
+## 설계 요약
+
+```
+User prompt → cluxion_plan → [clarification?] → preprocessing mode
+           → answer_policy + host_execution
+           → (queued) queue_next/record/brief
+```
+
+**설계 원칙**
+
+1. **추가 AI preflight 없음** — 결정론적 plan
+2. 짧은 일반 질문은 `simple_answer` fast path
+3. 불확실 시 fake success 금지 — `needs_clarification`, `unknown_after_check`
+4. **opt-in** — 사용자 동의 없이 권한 확대 없음
+
+## 빠른 시작
+
+```bash
+pip install cluxion-agentplugin-preprocessing
+cluxion-preprocess check
+cluxion-preprocess enable    # Hermes
+```
+
+```bash
+cluxion-runtime plan --surface hermes --prompt "작업 설명"
+```
+
+## 도구 (`cluxion` toolset)
+
+| Tool | 설명 |
+|------|------|
+| `cluxion_plan` | 전처리·방향·큐·리소스 계획 |
+| `cluxion_clarify` | 명확화 질문 목록 |
+| `cluxion_queue_next` / `record` / `brief` | segment 큐 |
+
+## 문서
+
+- [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/rust-architecture.md](Docs/rust-architecture.md)
+
+## License
+
+Apache-2.0

cluxion_agentplugin_preprocessing-0.2.0/README.md

@@ -0,0 +1,86 @@
+# cluxion-Agentplugin-preprocessing
+
+범용 에이전트 **전처리 플러그인** — **Hermes, Claude Code, Codex, Grok Build**에서 동일 core로 동작합니다.
+
+**Repository:** https://github.com/cluxion/cluxion-Agentplugin-preprocessing
+
+## 한 줄 요약
+
+작업 시작 전에 **방향·정직함·큐**를 정리합니다. **연결된 AI**가 `cluxion_plan` 등 도구를 호출하고, JSON 계약(`answer_policy`, `host_execution`)에 따라 응답합니다. 플러그인은 추가 LLM 호출 없이 결정론적 plan만 반환합니다.
+
+## 범용 에이전트 + Rust-First
+
+| 계층 | 구현 |
+|------|------|
+| **Rust** (`cluxion-queue`) | SQLite 작업큐, atomic dispatch |
+| **Python** (`cluxion_runtime`, adapter) | harness plan, 전처리, CLI |
+| **Agent adapter** | `adapters/` — Hermes plugin, Claude skill, Codex snippet |
+
+내부 hot path는 **Rust**. Python은 등록·JSON bridge·fallback입니다.
+
+## 이 플러그인의 역할
+
+- **정직함**: context 부족 시 모른다고 답하도록 `answer_policy` 생성
+- **명확화**: 의도가 애매하면 큐 진입 전 질문 (`needs_clarification`)
+- **작업큐**: 긴 입력을 segment로 분할, checksum 보존
+- **리소스 admission**: RAM/CPU 압력에 따른 실행 허용 (결정론적)
+
+**모델·OAuth·provider는 host agent 소유.** Cluxion은 plan·게이트·큐 메타데이터만 반환합니다.
+
+## 연결된 AI가 하는 일
+
+| 단계 | 동작 |
+|------|------|
+| 요청 수신 | `cluxion_plan` 또는 `cluxion-runtime plan` |
+| 명확화 필요 | `clarification.questions`로 사용자에게 질문 |
+| queued 모드 | `cluxion_queue_next` → 처리 → `cluxion_queue_record` → `cluxion_queue_brief` |
+| 응답 | `answer_policy.required_checks` 준수 |
+
+## 설계 요약
+
+```
+User prompt → cluxion_plan → [clarification?] → preprocessing mode
+           → answer_policy + host_execution
+           → (queued) queue_next/record/brief
+```
+
+**설계 원칙**
+
+1. **추가 AI preflight 없음** — 결정론적 plan
+2. 짧은 일반 질문은 `simple_answer` fast path
+3. 불확실 시 fake success 금지 — `needs_clarification`, `unknown_after_check`
+4. **opt-in** — 사용자 동의 없이 권한 확대 없음
+
+## 빠른 시작
+
+```bash
+pip install cluxion-agentplugin-preprocessing
+cluxion-preprocess check
+cluxion-preprocess enable    # Hermes
+```
+
+```bash
+cluxion-runtime plan --surface hermes --prompt "작업 설명"
+```
+
+## 도구 (`cluxion` toolset)
+
+| Tool | 설명 |
+|------|------|
+| `cluxion_plan` | 전처리·방향·큐·리소스 계획 |
+| `cluxion_clarify` | 명확화 질문 목록 |
+| `cluxion_queue_next` / `record` / `brief` | segment 큐 |
+
+## 문서
+
+- [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/rust-architecture.md](Docs/rust-architecture.md)
+
+## License
+
+Apache-2.0

cluxion_agentplugin_preprocessing-0.2.0/adapters/claude/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "cluxion-agentplugin-preprocessing",
+  "version": "0.2.0",
+  "description": "Cluxion preprocessing: honesty, clarification, Rust work queue, resource admission.",
+  "author": "cluxion",
+  "commands": "./commands",
+  "skills": "./skills"
+}

cluxion_agentplugin_preprocessing-0.2.0/adapters/claude/skills/preprocess/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: cluxion-preprocess
+description: Run Cluxion preprocessing before agent work. You (the connected AI) call cluxion tools/CLI. Use for task planning, long work queueing, or unclear user intent. Enforces honesty and clarification before queueing.
+---
+
+# Cluxion Preprocessing — 연결된 AI 지시문
+
+작업 전에 **당신(연결된 AI)** 이 plan·큐 도구를 호출합니다. 플러그인은 JSON 계약만 반환합니다.
+
+## Plan 호출
+
+```bash
+cluxion-runtime plan --surface claude --json-stdin
+```
+
+stdin: `{"prompt": "<user request>", "cwd": "<workspace>"}`
+
+Hermes에서는 `cluxion_plan` 도구를 동일 목적으로 사용합니다.
+
+## 규칙
+
+1. `clarification.required`이 true이면 사용자에게 질문하고 작업을 시작하지 말 것.
+2. context가 부족하면 모른다고 말할 것 — 사실을 지어내지 말 것.
+3. `queued` 모드: `cluxion_queue_next` → segment 처리 → `cluxion_queue_record` → `cluxion_queue_brief`.
+4. 세션 맥락 보존이 필요하면 brief를 ForgetForge에 넘길 것: `forgetforge import-brief --source preprocessing --brief "<cluxion_queue_brief output>"` (또는 Hermes `forgetforge_import_brief`).
+5. `answer_policy.required_checks`를 응답 전에 따를 것.
+6. 플러그인이 대신 completion을 생성하지 않음 — **당신**이 계약에 맞게 응답할 것.
+
+## 설치 확인
+
+```bash
+cluxion-preprocess check
+```

cluxion_agentplugin_preprocessing-0.2.0/adapters/codex/config-snippet.toml

@@ -0,0 +1,5 @@
+# Add to ~/.codex/config.toml
+[plugins.cluxion_preprocess]
+enabled = true
+command = ["cluxion-runtime", "plan", "--json-stdin", "--surface", "codex"]
+description = "Cluxion preprocessing: honesty, clarification, Rust queue"

cluxion_agentplugin_preprocessing-0.2.0/cluxion-Docs/README.md

@@ -0,0 +1,22 @@
+# Legacy Docs (cluxion-Docs)
+
+> **공개 문서 기준: [`../Docs/`](../Docs/)**  
+> 이 폴더는 이전 `hermes-cluxion` 패키징 시기의 **레거시 참고**입니다.
+
+## 현재 방향 (요약)
+
+- **연결된 AI**가 `cluxion_plan`·큐 도구를 호출하고 JSON 계약을 따릅니다.
+- **모델·OAuth·provider**는 host agent가 소유합니다. 플러그인은 plan·게이트만 반환합니다.
+- 플러그인 내부에서 **별도 LLM을 호출하지 않습니다.**
+
+사용자·에이전트 연동 설명은 **`Docs/README.md`** 를 따르세요.
+
+## 레거시 목차 (기술 참고)
+
+| 문서 | 내용 |
+|------|------|
+| [architecture.md](./architecture.md) | 패키지 경계 (레거시 명칭 포함) |
+| [harness-logic.md](./harness-logic.md) | intent·전처리·큐·resource |
+| [honesty-preprocessing.md](./honesty-preprocessing.md) | answer_policy 계약 |
+| [install-and-operations.md](./install-and-operations.md) | 설치 요약 → `Docs/installation.md` |
+| [security.md](./security.md) | 공개 배포 보안 원칙 |

cluxion_agentplugin_preprocessing-0.2.0/cluxion-Docs/architecture.md

@@ -0,0 +1,36 @@
+# Architecture (legacy reference)
+
+> 최신 문서: [`../Docs/architecture.md`](../Docs/architecture.md)
+
+## 패키지 구성
+
+| 패키지 | 역할 |
+|--------|------|
+| `cluxion_agentplugin_preprocessing` | Hermes plugin, CLI, tool schema |
+| `cluxion_runtime` | `cluxion-runtime plan`, harness 엔진 |
+| `rust/cluxion_queue` | SQLite 작업큐 + dispatch (선택) |
+
+## Host vs Cluxion
+
+**Host agent (연결된 AI)**
+
+- OAuth, provider, **모델 선택**
+- tool 권한, completion, 최종 응답
+- queued segment 처리·synthesis
+
+**Cluxion preprocessing**
+
+- `WorkItem` 정규화, intent 분류
+- `answer_policy` · `host_execution` 계약
+- 명확화·segment 큐·resource admission
+- **추가 LLM 호출 없음**
+
+## 등록 도구 (Hermes `cluxion` toolset)
+
+| Tool | 용도 |
+|------|------|
+| `cluxion_plan` | 전처리·방향·큐·리소스 plan |
+| `cluxion_clarify` | 명확화 질문 |
+| `cluxion_queue_next` / `record` / `brief` | segment 큐 |
+
+모델·provider 변경은 host agent 책임입니다. 전처리 플러그인은 실행 **전** 계약만 제공합니다.

cluxion_agentplugin_preprocessing-0.2.0/cluxion-Docs/harness-logic.md

@@ -0,0 +1,51 @@
+# Harness Logic (legacy reference)
+
+> 최신 문서: [`../Docs/design.md`](../Docs/design.md), [`../Docs/tools.md`](../Docs/tools.md)
+
+## 1. Adapter Payload
+
+```bash
+cluxion-runtime plan --json-stdin --surface <surface>
+```
+
+필수: `prompt`  
+선택: `work_id`, `priority`, `cwd`, `metadata`, `expected_ram_mb`, `context_tokens`
+
+## 2. Intent 분류
+
+`classify_intent()` — **모델 호출 없음**, 결정론적.
+
+- `category`, `operation`, `direction`, `confidence`, `signals`
+- 방향은 host harness (`hermes_harness`, `claude_harness`, …) 또는 `host_managed`
+
+## 3. 전처리 모드
+
+| Mode | 용도 |
+|------|------|
+| `simple_answer` | 짧은 일반 질문 |
+| `verification_answer` | 사실 확인 필요 짧은 질문 |
+| `standard` | 코드·테스트·보안·문서 등 실질 작업 |
+| `queued` | 긴 입력 segment 분할 |
+| `needs_clarification` | 사용자 방향 확정 전 |
+
+모든 모드에 `answer_policy` 포함.
+
+## 4. 작업큐
+
+`AgentWorkQueue` — priority + FIFO. Rust `cluxion-queue` 또는 Python fallback.
+
+## 5. Host Execution
+
+`host_execution` 계약을 **연결된 AI**가 읽고 실행:
+
+- `current_turn_direct_answer`
+- `current_turn_verify_then_answer`
+- `single_host_task`
+- `durable_segment_queue` + `cluxion_queue_*`
+- `ask_user_before_queue`
+
+## 6. Resource Admission
+
+`collect_resource_snapshot()` + `capacity_decision()` — fail-closed RAM/CPU 게이트.
+
+Queued segment content는 out-of-band store에 저장됩니다.

cluxion_agentplugin_preprocessing-0.2.0/cluxion-Docs/honesty-preprocessing.md

@@ -0,0 +1,40 @@
+# Honesty Preprocessing (legacy reference)
+
+> 최신 문서: [`../Docs/design.md`](../Docs/design.md)
+
+플러그인은 모델을 바꾸지 않습니다. **연결된 AI**가 따라야 하는 `answer_policy` 계약을 만듭니다.
+
+## Goals
+
+- 모르면 모른다고 말하게 함
+- 확인하지 않은 실행·파일·환경 상태를 사실처럼 말하지 않게 함
+- 확인한 사실 / 추론 / unknown 분리
+- 짧은 질문에 heavy preprocessing 비용 최소화
+
+## Modes
+
+| Mode | 동작 |
+|------|------|
+| `simple_answer` | segment·resource snapshot 없음 |
+| `verification_answer` | `verification_required` + `required_checks` |
+| `standard` | segment·resource admission·evidence 기반 응답 |
+| `queued` | checksum·순서 보존 합성 |
+
+## Required Checks (대표)
+
+- `verify_current_or_recent_fact`
+- `cite_external_source_or_document`
+- `inspect_runtime_state_before_claiming`
+- `run_requested_check_or_state_not_run`
+- `tie_claims_to_file_diff_or_command_output`
+- `tie_security_claims_to_evidence`
+- `preserve_segment_checksums_in_synthesis`
+
+## Hard Boundaries
+
+- 기억·추정만으로 현재 상태 단정 금지
+- 실행하지 않은 테스트 통과 주장 금지
+- 존재하지 않는 파일·URL·버전 날조 금지
+- ambiguous prompt는 확정 표현 자제
+
+검증·실행·응답은 **연결된 AI** 책임입니다.