cluxion-Agentplugin-AutoClearMemory 0.2.0__tar.gz

cluxion_agentplugin_autoclearmemory-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_autoclearmemory-0.2.0/Docs/README.md

@@ -0,0 +1,52 @@
+# ForgetForge Documentation
+
+## 처음 읽는 분
+
+**ForgetForge**는 에이전트 세션의 메모리가 무한히 쌓이는 문제를 막는 **망각·기억 강화 플러그인**입니다.
+
+| 질문 | 답 |
+|------|-----|
+| **무엇을 하나요?** | 기억을 tier(Hot/Warm/Cold)로 나누고, **실제로 회상한 횟수**로 강도를 계산해 오래된 기억을 archive합니다. |
+| **누가 실행하나요?** | **연결된 AI**(Hermes·Claude·Codex·Grok의 모델)가 skill/도구 지시에 따라 `forgetforge_*` 도구나 CLI를 호출합니다. |
+| **플러그인이 모델을 부르나요?** | **아니요.** 점수·tier·DB만 관리합니다. 요약·반영·세션 정리는 **연결된 AI**가 수행합니다. |
+| **왜 Rust인가요?** | retention 계산·tier 판정 hot path를 Rust로 두고, Python은 DB·adapter·CLI만 담당합니다. |
+
+### 연결된 AI 사용 흐름
+
+1. 세션 시작 또는 맥락이 커질 때 → `forgetforge status`로 건강 상태 확인
+2. 과거 사실이 필요할 때 → `forgetforge recall <topic>` (explicit layer)
+3. 응답에 기억을 실제로 썼다면 → `forgetforge_recall` with `layer: implicit`
+4. 세션 마무리 시 사용한 기억을 점검했다면 → `forgetforge_recall` with `layer: reflection`
+5. 사용자 `#keep_forever` / `#forget_this` → `forgetforge keep` / `forgetforge forget`
+6. preprocessing/supercoder brief → `forgetforge import-brief` (또는 Hermes `forgetforge_import_brief`)
+7. store 시 `contradiction_warnings`가 있으면 사용자에게 reconcile 제안
+
+**v0.2 추가:** FTS5 recall, brief handoff, hot inject hook, contradiction hints, Parquet cold archive.
+
+Skill 지시문: [`adapters/claude/skills/forgetforge/SKILL.md`](../adapters/claude/skills/forgetforge/SKILL.md)
+
+### 사람(개발자)이 할 일
+
+```bash
+pip install cluxion-Agentplugin-AutoClearMemory
+forgetforge init --agents=all
+hermes plugins enable forgetforge   # Hermes 예시
+```
+
+## 목차
+
+| 문서 | 내용 |
+|------|------|
+| [architecture.md](architecture.md) | Recall-centric tiers, 데이터 흐름 |
+| [design.md](design.md) | Retention 공식, retrieval layer, pruner |
+| [installation.md](installation.md) | pip 설치, Rust 빌드, adapter |
+| [agent-surfaces.md](agent-surfaces.md) | Hermes / Claude / Codex 연동 |
+| [rust-architecture.md](rust-architecture.md) | Rust 메인 · Python bridge |
+
+## 이 레포에서 다루지 않는 것
+
+- API 키·OAuth (호스트 에이전트 소유)
+- 플러그인 내부의 별도 LLM 호출
+- 비공개 운영·배포 비밀
+
+이슈는 GitHub Issues를 이용해 주세요.

cluxion_agentplugin_autoclearmemory-0.2.0/Docs/agent-surfaces.md

@@ -0,0 +1,46 @@
+# Agent Surfaces
+
+ForgetForge는 **하나의 pip 패키지**로 Hermes · Claude Code · Codex · Grok Build를 커버합니다.  
+에이전트별 차이는 adapter·skill뿐이고, **core(Rust + SQLite)는 공유**합니다.
+
+**공통 원칙:** 연결된 AI가 skill/도구 지시에 따라 recall·status·keep·forget을 호출합니다. 플러그인은 LLM을 호출하지 않습니다.
+
+## Hermes
+
+- Entry: `[project.entry-points."hermes_agent.plugins"]`
+- 활성화: `hermes plugins enable forgetforge`
+- Tools: `forgetforge_store`, `forgetforge_recall`, `forgetforge_status`, `forgetforge_keep`, `forgetforge_forget`, `forgetforge_import_brief`, `forgetforge_hot_context`
+- `forgetforge_recall`의 `layer`: `explicit` | `implicit` | `reflection`
+- `pre_llm_call` hook: hot tier 자동 inject
+
+## Claude Code
+
+- Skill: `adapters/claude/skills/forgetforge/SKILL.md`
+- 연결된 AI는 skill 규칙에 따라 CLI 또는 동일 semantics의 도구 호출
+- 세션 마무리 reflection도 **Claude 모델**이 skill 지시에 따라 `layer: reflection` recall 기록
+
+## Codex
+
+- 가이드: `adapters/codex/mcp-snippet.toml`
+- 연결된 AI는 터미널에서 `forgetforge` CLI를 호출 (recall/status/keep/forget)
+- 규칙은 Claude skill과 동일
+
+## Grok Build
+
+- `forgetforge` CLI + 동일 recall 규칙
+- 프로젝트 skill에 `adapters/claude/skills/forgetforge/SKILL.md` 내용을 참고해 연동
+
+## 공통 명령
+
+| Command | Description |
+|---------|-------------|
+| `forgetforge init --agents=all` | DB + config 생성 |
+| `forgetforge recall <query>` | Explicit retrieval |
+| `forgetforge keep <id>` | `#keep_forever` |
+| `forgetforge forget <id>` | `#forget_this` |
+| `forgetforge status` | Memory health |
+| `forgetforge store <id> --content "..."` | Store/update memory |
+| `forgetforge import-brief` | Brief handoff |
+| `forgetforge hot-context` | Hot tier block |
+| `forgetforge prune` | Pruner 1회 |
+| `forgetforge pruner-daemon` | Background pruner |

cluxion_agentplugin_autoclearmemory-0.2.0/Docs/architecture.md

@@ -0,0 +1,53 @@
+# Architecture
+
+## 목표
+
+에이전트 **영구 메모리 bloat**를 **회상(Recall) 중심**으로 해결합니다.  
+저장 횟수가 아니라 **실제 회상 횟수**가 기억 강도를 결정합니다.
+
+## 범용 에이전트 + Rust-First
+
+| 계층 | 구현 |
+|------|------|
+| **Rust** (`forgetforge-engine`) | Retention scoring, tier decision |
+| **Python** (`forgetforge`) | SQLite, recall tracker, pruner, CLI |
+| **Agent adapter** | Hermes plugin, Claude skill, Codex CLI 가이드 |
+
+## 데이터 흐름
+
+```mermaid
+graph TD
+    subgraph Host["연결된 AI (host model)"]
+        Skill[Skill / tool 지시 따름]
+    end
+
+    subgraph Core["ForgetForge Core"]
+        DB[SQLite ~/.forgetforge/db.sqlite]
+        Engine[Rust Scoring Engine]
+        Tracker[Recall Tracker 3-layer]
+        Pruner[Background Pruner]
+    end
+
+    Skill -->|forgetforge_recall / CLI| Tracker
+    Tracker --> Engine
+    Engine --> DB
+    DB --> Pruner
+    DB -->|recall 결과 JSON| Skill
+```
+
+연결된 AI는 recall 결과를 읽고 **자신의 응답 맥락에 반영**합니다. 플러그인이 별도 completion을 생성하지 않습니다.
+
+## Tiered Memory
+
+| Tier | 조건 | 연결된 AI |
+|------|------|-----------|
+| **Hot** | 최근 7일 + N_r ≥ 1 | recall 결과 우선 반영 |
+| **Warm-Episodic** | R ≥ 0.65 | 필요 시 recall |
+| **Warm-Semantic** | R ≥ 0.80 | 장기 사실 유지 |
+| **Warm-Procedural** | skill + N_r ≥ 3 | 절차·스킬 유지 |
+| **Cold** | R < 0.40 or 180일 무회상 | archive, on-demand recall |
+
+## Host 경계
+
+- **Host**: 모델·OAuth·completion·최종 응답
+- **ForgetForge**: 점수·tier·DB·archive·도구 JSON

cluxion_agentplugin_autoclearmemory-0.2.0/Docs/design.md

@@ -0,0 +1,73 @@
+# Design
+
+## Retention formula
+
+\[
+R = e^{-t / S} \times \left(1 + 0.45 \cdot N_r + 0.30 \cdot I + 0.25 \cdot F \right)
+\]
+
+- \( t \): 마지막 회상 이후 경과일
+- \( S = \ln(1 + N_r) \): Stability (회상 횟수 기반)
+- \( N_r \): Retrieval count (Explicit + Implicit + Reflection)
+- \( I \): Importance (0~1)
+- \( F \): Frequency (secondary)
+
+구현: `rust/forgetforge_engine/src/scoring.rs` (+ Python fallback in `rust_bridge.py`).
+
+## Retrieval 3-layer (연결된 AI가 기록)
+
+플러그인은 별도 LLM을 돌리지 않습니다. **연결된 AI**가 skill·도구 지시에 따라 `forgetforge_recall`을 호출할 때 `layer`로 구분합니다.
+
+| Layer | 연결된 AI가 호출하는 시점 | Boost |
+|-------|---------------------------|-------|
+| `explicit` | `/recall`, 주제 검색, `forgetforge recall` | +0.45 |
+| `implicit` | 응답에 해당 기억을 실제로 사용한 직후 | +0.35 |
+| `reflection` | 세션 마무리 시 “이 기억을 썼는가?” 점검 후 | +0.25 |
+
+모든 이벤트는 `retrieval_events` 테이블에 기록됩니다. recall 시 `importance`·`frequency`가 layer별로 소폭 증가합니다 (`db.bump_recall_stats`).
+
+## FTS5 recall
+
+- `memories_fts` (FTS5, porter tokenizer) — `search_memories`가 bm25 정렬
+- FTS 실패·무결과 시 `LIKE` fallback
+- upsert/forget 시 FTS 동기화
+
+## Brief handoff
+
+`import_brief` — preprocessing/supercoder brief를 episodic memory로 저장:
+
+```bash
+forgetforge import-brief --source supercoder --brief "<json or text>"
+```
+
+Hermes: `forgetforge_import_brief`
+
+## Contradiction hints
+
+`store_memory`는 유사 토큰·부정 쌍(`always/never` 등)을 검사해 `contradiction_warnings`를 반환합니다. 연결된 AI가 사용자에게 reconcile을 제안합니다.
+
+## Hot inject
+
+- `hot_inject.build_hot_context` — hot tier 미리보기 블록
+- Hermes `pre_llm_call` hook — hot 기억을 LLM 호출 전에 자동 주입
+
+## Pruner (6시간 주기)
+
+- Warm → Cold: \( R < 0.40 \)
+- 180일 무회상 → `~/.forgetforge/archive/`에 parquet + jsonl + txt 저장 (`archive.write_cold_archive`)
+- Cold → Warm: recall 발생 시 즉시 승격
+
+주기 실행: `forgetforge prune` (cron/systemd 등).
+
+## User safety tags
+
+- `#keep_forever` → `forgetforge keep <id>`
+- `#forget_this` → `forgetforge forget <id>`
+
+## Package layout
+
+```
+src/forgetforge/          # db, recall, pruner, rust_bridge, cli
+rust/forgetforge_engine/  # scoring + tier (Rust)
+adapters/                 # Hermes README, Claude skill, Codex snippet
+```

cluxion_agentplugin_autoclearmemory-0.2.0/Docs/installation.md

@@ -0,0 +1,49 @@
+# Installation
+
+## pip (모든 에이전트)
+
+```bash
+pip install cluxion-Agentplugin-AutoClearMemory
+forgetforge init --agents=all
+forgetforge check
+```
+
+데이터: `~/.forgetforge/` (`db.sqlite`, `config.yaml`, `archive/`).
+
+## Rust engine (권장)
+
+```bash
+cargo build --release --manifest-path rust/forgetforge_engine/Cargo.toml
+export FORGETFORGE_ENGINE_BIN="$(pwd)/rust/forgetforge_engine/target/release/forgetforge-engine"
+forgetforge check
+```
+
+Rust가 없어도 **Python fallback**으로 scoring/tier가 동작합니다.
+
+## Hermes
+
+```bash
+hermes plugins enable forgetforge
+```
+
+연결된 AI에게 `forgetforge_*` 도구 사용을 skill로 안내합니다.
+
+## Claude Code
+
+`adapters/claude/skills/forgetforge/`를 skills 경로에 추가하거나, `adapters/claude/.claude-plugin/` manifest를 사용합니다.
+
+## Codex
+
+`adapters/codex/mcp-snippet.toml`을 참고합니다. 연결된 AI는 `forgetforge` CLI를 터미널에서 호출합니다.
+
+```bash
+forgetforge recall docker
+forgetforge status
+```
+
+## Environment
+
+| Variable | Purpose |
+|----------|---------|
+| `FORGETFORGE_HOME` | `~/.forgetforge` override |
+| `FORGETFORGE_ENGINE_BIN` | `forgetforge-engine` 경로 |

cluxion_agentplugin_autoclearmemory-0.2.0/Docs/rust-architecture.md

@@ -0,0 +1,34 @@
+# Rust Architecture
+
+## 원칙
+
+ForgetForge는 **Rust가 메인**, **Python은 연결층**입니다.
+
+```
+연결된 AI (Hermes / Claude / Codex / Grok)
+        ↓  skill / forgetforge_* tools / CLI
+forgetforge                    (Python: DB, recall, pruner, CLI)
+        ↓  subprocess JSON
+forgetforge-engine             (Rust: retention, tier)
+```
+
+플러그인은 **연결된 AI에게 지시·도구·점수**를 제공합니다. 별도 LLM을 호출하지 않습니다.
+
+## Rust: `forgetforge-engine`
+
+| 명령 | 역할 |
+|------|------|
+| `score` | RetentionInput → retention, stability, boost |
+| `tier` | TierInput → tier, action, retention |
+
+```bash
+cargo build --release --manifest-path rust/forgetforge_engine/Cargo.toml
+```
+
+## Python 역할
+
+- SQLite schema (`memories`, `retrieval_events`)
+- recall layer 기록 (`explicit` / `implicit` / `reflection`)
+- pruner orchestration
+- Hermes `register()`, CLI
+- Rust 미설치 시 동일 공식 Python fallback

cluxion_agentplugin_autoclearmemory-0.2.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: cluxion-Agentplugin-AutoClearMemory
+Version: 0.2.0
+Summary: Universal agent memory plugin (ForgetForge): recall-centric retention, tiered forgetting, Rust scoring engine for Hermes, Claude Code, and Codex.
+Project-URL: Homepage, https://github.com/cluxion/cluxion-Agentplugin-AutoClearMemory
+Project-URL: Repository, https://github.com/cluxion/cluxion-Agentplugin-AutoClearMemory
+Project-URL: Issues, https://github.com/cluxion/cluxion-Agentplugin-AutoClearMemory/issues
+Author-email: cluxion <algocean1204@users.noreply.github.com>
+License-Expression: Apache-2.0
+Keywords: claude-code,cluxion,codex,forgetforge,hermes-agent,memory,plugin,recall
+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: pyarrow>=15.0
+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-AutoClearMemory (ForgetForge)
+
+범용 에이전트 **망각·기억 강화 플러그인** — **Hermes, Claude Code, Codex, Grok Build**에서 동일 core로 동작합니다.
+
+**Repository:** https://github.com/cluxion/cluxion-Agentplugin-AutoClearMemory
+
+## 한 줄 요약
+
+세션 메모리가 쌓일수록 컨텍스트가 비대해집니다. ForgetForge는 **회상(Recall) 횟수**로 기억 강도를 계산하고, 오래되거나 쓰이지 않은 기억을 자동으로 낮은 tier로 내립니다. **연결된 AI**가 skill·도구 지시에 따라 recall/status/keep/forget을 호출합니다.
+
+## 범용 에이전트 + Rust-First
+
+| 계층 | 구현 |
+|------|------|
+| **Rust** (`forgetforge-engine`) | Retention scoring, tier decision |
+| **Python** (`forgetforge`) | SQLite, recall tracker, pruner, CLI |
+| **Agent adapter** | Hermes plugin, Claude skill, Codex CLI 가이드 |
+
+내부 로직은 **Rust 중심**. Python·Skill은 등록·DB·JSON bridge **thin wrapper**입니다.  
+Rust 바이너리가 없어도 **Python fallback**으로 동일 공식이 동작합니다.
+
+## 이 플러그인의 역할
+
+- **Recall이 reinforcement**: 저장 횟수가 아니라 실제 회상 \(N_r\)가 강도를 결정
+- **Tiered Memory**: Hot / Warm-Episodic / Warm-Semantic / Warm-Procedural / Cold
+- **Decay + Boost**: Ebbinghaus forgetting curve + spaced repetition
+- **FTS5 recall**: SQLite full-text search + LIKE fallback
+- **Brief handoff**: preprocessing/supercoder brief → episodic memory (`import-brief`)
+- **Hot inject**: Hermes `pre_llm_call` hook으로 hot tier 자동 주입
+- **Contradiction hints**: store 시 유사·부정 기억 경고
+- **Parquet archive**: cold tier → `~/.forgetforge/archive/` (parquet + jsonl + txt)
+- **Background pruner**: 6시간 주기 tier migration (`forgetforge prune`)
+- **Safety**: `#keep_forever`, `#forget_this` 사용자 태그
+
+ForgetForge는 **모델·OAuth를 소유하지 않습니다.** 연결된 AI가 도구 결과를 읽고 맥락에 반영합니다.
+
+## 연결된 AI가 하는 일
+
+| 상황 | 연결된 AI 동작 |
+|------|----------------|
+| 맥락이 커짐 | `forgetforge status` 또는 `forgetforge_status` |
+| 과거 사실 필요 | `forgetforge recall <topic>` (explicit) |
+| 응답에 기억 사용 | `forgetforge_recall` + `layer: implicit` |
+| 세션 마무리 점검 | `forgetforge_recall` + `layer: reflection` |
+| `#keep_forever` | `forgetforge keep <id>` |
+| `#forget_this` | `forgetforge forget <id>` |
+
+Hermes는 `forgetforge_*` 도구, Claude/Codex는 skill + CLI를 동일 규칙으로 따릅니다.
+
+## Retention formula
+
+\[
+R = e^{-t / S} \times \left(1 + 0.45 \cdot N_r + 0.30 \cdot I + 0.25 \cdot F \right), \quad S = \ln(1 + N_r)
+\]
+
+## Tier 요약
+
+| Tier | 조건 | 연결된 AI 동작 |
+|------|------|----------------|
+| **Hot** | 최근 7일 + \(N_r \geq 1\) | recall 결과를 맥락에 우선 반영 |
+| **Warm-Episodic** | \(R \geq 0.65\) | 필요 시 recall |
+| **Warm-Semantic** | \(R \geq 0.80\) | 장기 사실로 유지 |
+| **Warm-Procedural** | skill + \(N_r \geq 3\) | 절차·스킬로 유지 |
+| **Cold** | \(R < 0.40\) or 180일 무회상 | archive, 필요 시에만 recall |
+
+## 빠른 시작
+
+```bash
+pip install cluxion-Agentplugin-AutoClearMemory
+forgetforge init --agents=all
+forgetforge check
+hermes plugins enable forgetforge   # Hermes
+```
+
+```bash
+# Rust 가속 (선택)
+cargo build --release --manifest-path rust/forgetforge_engine/Cargo.toml
+```
+
+## 공통 명령
+
+| Command | Description |
+|---------|-------------|
+| `forgetforge store <id> --content "..."` | Store or update memory |
+| `forgetforge recall <topic>` | Explicit retrieval + tier boost |
+| `forgetforge keep <id>` | `#keep_forever` |
+| `forgetforge forget <id>` | `#forget_this` |
+| `forgetforge status` | Memory health |
+| `forgetforge prune` | Pruner 1회 실행 |
+| `forgetforge pruner-daemon` | Background pruner (interval from config) |
+| `forgetforge import-brief --source supercoder --brief "..."` | Brief → episodic memory |
+| `forgetforge hot-context` | Hot tier context block (CLI) |
+
+## Hermes 도구 (`forgetforge` toolset)
+
+| Tool | Description |
+|------|-------------|
+| `forgetforge_store` | Save or update memory (contradiction warnings when similar) |
+| `forgetforge_recall` | FTS search + retrieval event (`layer`: explicit / implicit / reflection) |
+| `forgetforge_status` | Tier counts, engine status |
+| `forgetforge_keep` | Pin memory forever |
+| `forgetforge_forget` | Mark for forgetting |
+| `forgetforge_import_brief` | Import preprocessing/supercoder brief |
+| `forgetforge_hot_context` | Hot tier block (also via `pre_llm_call` hook) |
+
+## 문서
+
+- [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/agent-surfaces.md](Docs/agent-surfaces.md)
+- [Docs/rust-architecture.md](Docs/rust-architecture.md)
+
+## License
+
+Apache-2.0

cluxion_agentplugin_autoclearmemory-0.2.0/README.md

@@ -0,0 +1,117 @@
+# cluxion-Agentplugin-AutoClearMemory (ForgetForge)
+
+범용 에이전트 **망각·기억 강화 플러그인** — **Hermes, Claude Code, Codex, Grok Build**에서 동일 core로 동작합니다.
+
+**Repository:** https://github.com/cluxion/cluxion-Agentplugin-AutoClearMemory
+
+## 한 줄 요약
+
+세션 메모리가 쌓일수록 컨텍스트가 비대해집니다. ForgetForge는 **회상(Recall) 횟수**로 기억 강도를 계산하고, 오래되거나 쓰이지 않은 기억을 자동으로 낮은 tier로 내립니다. **연결된 AI**가 skill·도구 지시에 따라 recall/status/keep/forget을 호출합니다.
+
+## 범용 에이전트 + Rust-First
+
+| 계층 | 구현 |
+|------|------|
+| **Rust** (`forgetforge-engine`) | Retention scoring, tier decision |
+| **Python** (`forgetforge`) | SQLite, recall tracker, pruner, CLI |
+| **Agent adapter** | Hermes plugin, Claude skill, Codex CLI 가이드 |
+
+내부 로직은 **Rust 중심**. Python·Skill은 등록·DB·JSON bridge **thin wrapper**입니다.  
+Rust 바이너리가 없어도 **Python fallback**으로 동일 공식이 동작합니다.
+
+## 이 플러그인의 역할
+
+- **Recall이 reinforcement**: 저장 횟수가 아니라 실제 회상 \(N_r\)가 강도를 결정
+- **Tiered Memory**: Hot / Warm-Episodic / Warm-Semantic / Warm-Procedural / Cold
+- **Decay + Boost**: Ebbinghaus forgetting curve + spaced repetition
+- **FTS5 recall**: SQLite full-text search + LIKE fallback
+- **Brief handoff**: preprocessing/supercoder brief → episodic memory (`import-brief`)
+- **Hot inject**: Hermes `pre_llm_call` hook으로 hot tier 자동 주입
+- **Contradiction hints**: store 시 유사·부정 기억 경고
+- **Parquet archive**: cold tier → `~/.forgetforge/archive/` (parquet + jsonl + txt)
+- **Background pruner**: 6시간 주기 tier migration (`forgetforge prune`)
+- **Safety**: `#keep_forever`, `#forget_this` 사용자 태그
+
+ForgetForge는 **모델·OAuth를 소유하지 않습니다.** 연결된 AI가 도구 결과를 읽고 맥락에 반영합니다.
+
+## 연결된 AI가 하는 일
+
+| 상황 | 연결된 AI 동작 |
+|------|----------------|
+| 맥락이 커짐 | `forgetforge status` 또는 `forgetforge_status` |
+| 과거 사실 필요 | `forgetforge recall <topic>` (explicit) |
+| 응답에 기억 사용 | `forgetforge_recall` + `layer: implicit` |
+| 세션 마무리 점검 | `forgetforge_recall` + `layer: reflection` |
+| `#keep_forever` | `forgetforge keep <id>` |
+| `#forget_this` | `forgetforge forget <id>` |
+
+Hermes는 `forgetforge_*` 도구, Claude/Codex는 skill + CLI를 동일 규칙으로 따릅니다.
+
+## Retention formula
+
+\[
+R = e^{-t / S} \times \left(1 + 0.45 \cdot N_r + 0.30 \cdot I + 0.25 \cdot F \right), \quad S = \ln(1 + N_r)
+\]
+
+## Tier 요약
+
+| Tier | 조건 | 연결된 AI 동작 |
+|------|------|----------------|
+| **Hot** | 최근 7일 + \(N_r \geq 1\) | recall 결과를 맥락에 우선 반영 |
+| **Warm-Episodic** | \(R \geq 0.65\) | 필요 시 recall |
+| **Warm-Semantic** | \(R \geq 0.80\) | 장기 사실로 유지 |
+| **Warm-Procedural** | skill + \(N_r \geq 3\) | 절차·스킬로 유지 |
+| **Cold** | \(R < 0.40\) or 180일 무회상 | archive, 필요 시에만 recall |
+
+## 빠른 시작
+
+```bash
+pip install cluxion-Agentplugin-AutoClearMemory
+forgetforge init --agents=all
+forgetforge check
+hermes plugins enable forgetforge   # Hermes
+```
+
+```bash
+# Rust 가속 (선택)
+cargo build --release --manifest-path rust/forgetforge_engine/Cargo.toml
+```
+
+## 공통 명령
+
+| Command | Description |
+|---------|-------------|
+| `forgetforge store <id> --content "..."` | Store or update memory |
+| `forgetforge recall <topic>` | Explicit retrieval + tier boost |
+| `forgetforge keep <id>` | `#keep_forever` |
+| `forgetforge forget <id>` | `#forget_this` |
+| `forgetforge status` | Memory health |
+| `forgetforge prune` | Pruner 1회 실행 |
+| `forgetforge pruner-daemon` | Background pruner (interval from config) |
+| `forgetforge import-brief --source supercoder --brief "..."` | Brief → episodic memory |
+| `forgetforge hot-context` | Hot tier context block (CLI) |
+
+## Hermes 도구 (`forgetforge` toolset)
+
+| Tool | Description |
+|------|-------------|
+| `forgetforge_store` | Save or update memory (contradiction warnings when similar) |
+| `forgetforge_recall` | FTS search + retrieval event (`layer`: explicit / implicit / reflection) |
+| `forgetforge_status` | Tier counts, engine status |
+| `forgetforge_keep` | Pin memory forever |
+| `forgetforge_forget` | Mark for forgetting |
+| `forgetforge_import_brief` | Import preprocessing/supercoder brief |
+| `forgetforge_hot_context` | Hot tier block (also via `pre_llm_call` hook) |
+
+## 문서
+
+- [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/agent-surfaces.md](Docs/agent-surfaces.md)
+- [Docs/rust-architecture.md](Docs/rust-architecture.md)
+
+## License
+
+Apache-2.0

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

@@ -0,0 +1,6 @@
+{
+  "name": "forgetforge",
+  "version": "0.1.0",
+  "description": "Recall-centric memory plugin (ForgetForge) for Claude Code",
+  "author": "cluxion"
+}

cluxion_agentplugin_autoclearmemory-0.2.0/adapters/claude/skills/forgetforge/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: forgetforge
+description: Recall-centric memory for agent sessions. Use when context grows, when prior facts are needed, or when user tags #keep_forever / #forget_this. You (the connected AI) call forgetforge tools/CLI — the plugin does not call a separate model.
+---
+
+# ForgetForge — 연결된 AI 지시문
+
+ForgetForge는 **당신(연결된 AI)** 이 도구·CLI를 호출해 메모리를 관리합니다. 플러그인은 점수·tier·DB만 제공합니다.
+
+## 설치 확인
+
+```bash
+forgetforge check
+```
+
+## 언제 호출할지
+
+| 상황 | 동작 |
+|------|------|
+| 새 사실·결정 저장 | `forgetforge store <id> --content "..."` 또는 `forgetforge_store` |
+| 세션 시작·맥락 비대 | `forgetforge status` |
+| 과거 사실 필요 | `forgetforge recall <topic>` 또는 `forgetforge_recall` layer=`explicit` |
+| 응답에 기억을 실제 사용 | `forgetforge_recall` layer=`implicit` |
+| 세션 마무리 | 사용한 기억에 대해 `forgetforge_recall` layer=`reflection` |
+| 사용자 `#keep_forever` | `forgetforge keep <id>` |
+| 사용자 `#forget_this` | `forgetforge forget <id>` |
+| preprocessing/supercoder brief 수신 | `forgetforge import-brief` 또는 `forgetforge_import_brief` |
+| store 후 `contradiction_warnings` | 기존 기억과 충돌 여부를 사용자에게 알리고 reconcile |
+
+## 규칙
+
+1. **회상이 강화 신호** — 저장만으로는 강해지지 않음. 사용·recall 시 layer를 기록할 것.
+2. Tier: Hot → Warm (episodic/semantic/procedural) → Cold. Cold는 recall 시에만 다시 가져올 것.
+3. recall 결과를 읽고 **당신의 응답 맥락에 반영**할 것. 플러그인이 응답을 대신 작성하지 않음.
+4. 모르는 사실을 기억에서 찾지 못하면 추측하지 말 것.
+5. Hermes에서는 hot tier가 `pre_llm_call` hook으로 자동 inject됩니다. 수동이 필요하면 `forgetforge_hot_context`를 호출하세요.
+
+## Retention (참고)
+
+R = e^{-t/S} × (1 + 0.45·N_r + 0.30·I + 0.25·F), S = ln(1 + N_r).  
+Scoring은 Rust `forgetforge-engine`이 수행합니다.

cluxion_agentplugin_autoclearmemory-0.2.0/adapters/codex/mcp-snippet.toml

@@ -0,0 +1,9 @@
+# Codex 연동 참고
+# 연결된 AI가 터미널에서 forgetforge CLI를 호출합니다.
+# 규칙은 adapters/claude/skills/forgetforge/SKILL.md 와 동일합니다.
+
+# forgetforge recall <topic>
+# forgetforge status
+# forgetforge keep <memory_id>
+# forgetforge forget <memory_id>
+# forgetforge prune

cluxion_agentplugin_autoclearmemory-0.2.0/adapters/cron/forgetforge-prune.cron

@@ -0,0 +1,3 @@
+# Install: crontab -e and add this line (adjust forgetforge path if needed)
+# Runs pruner every 6 hours
+0 */6 * * * /usr/bin/env forgetforge prune >> "$HOME/.forgetforge/prune.log" 2>&1

cluxion_agentplugin_autoclearmemory-0.2.0/adapters/hermes/README.md

@@ -0,0 +1,22 @@
+# Hermes adapter
+
+Hermes는 pip entry point로 ForgetForge를 로드합니다.
+
+```bash
+hermes plugins enable forgetforge
+forgetforge init --agents=hermes
+```
+
+## 연결된 AI 도구
+
+| Tool | 용도 |
+|------|------|
+| `forgetforge_store` | 저장/갱신 (contradiction warnings) |
+| `forgetforge_recall` | FTS 검색 + retrieval 기록 (`layer` 필수) |
+| `forgetforge_status` | tier·건강 상태 |
+| `forgetforge_keep` | `#keep_forever` |
+| `forgetforge_forget` | `#forget_this` |
+| `forgetforge_import_brief` | preprocessing/supercoder brief 수입 |
+| `forgetforge_hot_context` | hot tier 블록 (또는 `pre_llm_call` hook) |
+
+연결된 AI는 recall 결과를 읽고 응답 맥락에 반영합니다. Hermes는 hot tier를 `pre_llm_call` hook으로 자동 inject합니다.