binggupack 1.14.0__tar.gz

binggupack-1.14.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BingguPack contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

binggupack-1.14.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: binggupack
+Version: 1.14.0
+Summary: BingguPack — local-first, evidence-backed memory/context pack framework with an installable Claude Code MCP server (stdio JSON-RPC). Python stdlib only.
+Author: BingguPack contributors
+License: MIT
+Project-URL: Homepage, https://github.com/darkjokee-arch/binggupack
+Project-URL: Release, https://github.com/darkjokee-arch/binggupack/releases/tag/v1.14.0
+Keywords: mcp,claude-code,local-first,ontology,context-packs,agi-memory
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# BingguPack
+
+**내가 일할수록 나를 알아가는, 내 PC 안의 개인 지식 노트.**
+
+> 최신: **v1.13.0 — 자기진화 거버넌스(Governance)** 🧭 · 내 학습과 기존 규칙이 충돌하면 양쪽을 보여주고 내가 선택 — 규칙 변경은 사람 손, 안전 규칙은 빙구팩이 못 바꿈.
+> 이전: v1.12.0 화자 축 🗣️ (내 말/AI 요약 따로 쌓기 + 양방향 신뢰도)
+> 🔒 로컬 우선 · 자동 저장 없음 · 내가 고른 것만 저장 · MIT License
+> Release: <https://github.com/darkjokee-arch/binggupack/releases/tag/v1.13.0>
+
+---
+
+## 빙구팩이 뭔가요?
+
+AI와 대화하다 보면 정작 남기고 싶은 것 — **내 판단, 배운 점, 정한 방침** — 이 수십 개 대화창에 흩어져 사라집니다. 그렇다고 전부 자동 저장하면 잡음과 민감정보가 쌓이고 통제권을 잃죠.
+
+빙구팩은 **넓게 줍고, 내가 고른 것만 저장하는** 개인 노트입니다.
+
+- 원본은 전부 내 PC 안 파일 하나(`ledger.sqlite`)에 있습니다. 클라우드가 원본을 갖지 않습니다.
+- **자동으로 저장되는 건 아무것도 없습니다.** 내가 직접 고른 것만 저장됩니다.
+- 쓸수록 빙구팩은 "나"를 알아갑니다 — 내가 어떻게 판단하고, 뭘 선호하고, 어떤 실수를 했는지가 쌓여서, 다음에 비슷한 일이 오면 먼저 짚어줍니다.
+
+## 무엇을 할 수 있나요
+
+| 능력 | 한 줄 설명 |
+|---|---|
+| 🧹 **넓게 수집** | 어느 AI(Claude·ChatGPT·폰·웹)에서 일하든 남길 문장을 후보로 모음 |
+| 👀 **미리보기** | 모은 후보를 먼저 보여줌 — 이 단계에선 저장 0 |
+| ✍️ **내가 골라 저장** | 내가 직접 고른 것만 저장. AI는 저장 못 함 |
+| 🗣️ **화자 축** | 내 말(직감·지적)과 AI 요약(수정·수용·반박)을 **따로** 쌓고, 수용/반박/수정으로 연결 |
+| ⚖️ **양방향 신뢰도** | 내 직감과 AI 반박, **누가 더 잘 맞았나**를 기억. 한쪽 편 안 듦 — 나도 AI도 틀릴 수 있으니까 |
+| 🔁 **자기수정** | 틀린 판단은 고치고, 예측은 결과로 검증해 다음 판단이 똑똑해짐 |
+| 🧭 **충돌 조정(거버넌스)** | 내 학습과 기존 규칙이 부딪치면 양쪽 보여주고 내가 선택 — 규칙 변경은 사람 손(빙구팩은 제안만)·안전 규칙은 못 바꿈 |
+| 🧠 **회상·반문** | 일 시작 전 관련 기억과 과거 실수 패턴을 먼저 떠올려줌 |
+| 📦 **팩 만들기·검증** | 모은 지식을 다른 도구가 쓸 "꾸러미(팩)"로 묶고 구조를 검증 |
+| 🔀 **워크플로우 추천** | "이 목표엔 이런 팩·데이터가 필요해요"를 자동 제안(추천만 — 실행은 사람) |
+| ☁️ **안전하게 내보내기** | 외부 실행 엔진(OpenCrab)으로 보내기 전 안전점검·업로드 준비. 실제 전송은 내가 승인할 때만 |
+| 🔌 **Claude Code 연결** | `clone` 한 번으로 MCP 패키지 설치(도구 8개) |
+| 💻 **어디서나** | Windows · WSL · macOS · Linux |
+
+## 빠른 시작
+
+```bash
+git clone https://github.com/darkjokee-arch/binggupack.git
+cd binggupack
+python binggu.py init                         # 내 노트 만들기
+```
+
+**내 말과 AI 요약을 따로 쌓고 연결하기 (화자 축)**
+
+```bash
+# 내 직감 + AI 요약을 페어로 — relation: accepts(수용) / refutes(반박) / revises(수정)
+python binggu.py pair "이 입찰은 보류한다" "데이터가 부족해 보수적 접근이 맞다" \
+    --relation refutes --confirm "PAIR ai_refutes owner:1 ai:1"
+
+python binggu.py pair "다음엔 이 거래처 우선 검토" --confirm "PAIR owner:1"   # 내 직감만
+
+python binggu.py trust          # 누가 더 잘 맞나 (양방향 신뢰도)
+python binggu.py resolve <n> <id8> --outcome 성공   # 결과 기록 → 적중률 누적
+python binggu.py route "..."    # 뭘 할지 헷갈리면 안내해줌
+```
+
+> 더 자세히: [10분 튜토리얼](docs/BINGGUPACK_TUTORIAL.md) · [설치 가이드](INSTALL.md)
+
+## 팩과 워크플로우 (외부 도구로 연결)
+
+빙구팩은 모은 지식을 **혼자만 쓰는 게 아니라**, 다른 실행 도구(OpenCrab)가 받아 쓸 수 있게 **준비·검증·안전점검**까지 해줍니다.
+
+```
+목표 → 필요한 팩 추천 → 근거 모으기 → 팩 만들기 → 검증 → 발행 안전점검 → 내보내기 준비
+```
+
+- 각 단계가 fail-closed로 막혀, **깨지거나 근거 없는 팩은 외부로 못 나갑니다.**
+- 관계·워크플로우는 **추천만** 합니다 — 무엇을 만들고 내보낼지는 사람이 정합니다.
+- 실제 외부 업로드·클라우드 전송은 **내가 명시 승인하기 전까지 멈춤(HOLD)**. 자동으로 나가는 건 없습니다.
+
+> 흐름 상세: [팩 계약](docs/OPENBINGGU_PACK_CONTRACT.md) · [업로드 흐름](docs/OPENBINGGU_USER_DRIVEN_OPENCRAB_UPLOAD_FLOW.md) · [개인/팀 두 트랙](docs/OPENBINGGU_PRODUCT_DIRECTION_TWO_TRACK.md)
+
+## 자기진화 거버넌스 (충돌 조정)
+
+빙구팩 학습과 기존 규칙이 충돌할 때 — 빙구팩은 **양쪽을 보여주고 제안만**, 규칙 변경의 마지막 손은 **사람**입니다.
+
+- **충돌하면 양쪽 펼쳐 보여줌** → 내가 선택 (자동 결정 0)
+- **누가 더 잘 맞았나 기록** → 단 "참고 신호"일 뿐 결정 근거 아님
+- **규칙 진화는 사람 손** → 빙구팩이 제안 → 내가 진짜(raw) 확인 → 승인 → 변경(되돌리기 가능). 빙구팩은 규칙 파일에 손 못 댐
+- **안전 규칙은 불변** → DB삭제·시크릿 같은 안전 조항은 빙구팩이 무슨 학습을 해도 못 바꿈
+- **세션 마무리 한마디** → "오늘 끝"(말투 자유) 하면 저장 목록 + 정리를 자동 표시(저장은 내가)
+
+> 빙구팩은 똑똑한 비서처럼 조언하고 충돌 시 양쪽을 펼치지만, **도장은 항상 사람이** 찍습니다. 상세: [거버넌스 설계](docs/BINGGUPACK_GOVERNANCE_DESIGN.md).
+
+## 안전 약속
+
+빙구팩의 안전은 말이 아니라 **자동 테스트로 증명**됩니다.
+
+- **자동 저장 없음** — 내가 직접 고른 것만 저장. AI/자동 경로는 차단.
+- **민감정보 차단** — 비밀번호·개인정보는 후보 단계에서 자동 제외.
+- **언제든 되돌리기** — 모든 변경 전 백업 + 되돌리기 가능.
+- **원본은 내 PC** — 클라우드가 내 원본을 갖지 않음. 외부 업로드는 내가 승인하기 전까지 멈춤.
+
+## 더 알아보기
+
+- [자기진화 거버넌스 설계](docs/BINGGUPACK_GOVERNANCE_DESIGN.md) — 학습↔규칙 충돌 조정, self-modifying 회피 (v1.13.0)
+- [화자 축 설계](docs/BINGGUPACK_SPEAKER_AXIS_DESIGN.md) — 내 말/AI 요약 따로 쌓기, 양방향 신뢰도
+- [10분 튜토리얼](docs/BINGGUPACK_TUTORIAL.md) · [설치 가이드](INSTALL.md) · [변경 이력](CHANGELOG.md)
+
+## License
+
+MIT License — Copyright (c) 2026 BingguPack contributors.

binggupack-1.14.0/README.md

@@ -0,0 +1,107 @@
+# BingguPack
+
+**내가 일할수록 나를 알아가는, 내 PC 안의 개인 지식 노트.**
+
+> 최신: **v1.13.0 — 자기진화 거버넌스(Governance)** 🧭 · 내 학습과 기존 규칙이 충돌하면 양쪽을 보여주고 내가 선택 — 규칙 변경은 사람 손, 안전 규칙은 빙구팩이 못 바꿈.
+> 이전: v1.12.0 화자 축 🗣️ (내 말/AI 요약 따로 쌓기 + 양방향 신뢰도)
+> 🔒 로컬 우선 · 자동 저장 없음 · 내가 고른 것만 저장 · MIT License
+> Release: <https://github.com/darkjokee-arch/binggupack/releases/tag/v1.13.0>
+
+---
+
+## 빙구팩이 뭔가요?
+
+AI와 대화하다 보면 정작 남기고 싶은 것 — **내 판단, 배운 점, 정한 방침** — 이 수십 개 대화창에 흩어져 사라집니다. 그렇다고 전부 자동 저장하면 잡음과 민감정보가 쌓이고 통제권을 잃죠.
+
+빙구팩은 **넓게 줍고, 내가 고른 것만 저장하는** 개인 노트입니다.
+
+- 원본은 전부 내 PC 안 파일 하나(`ledger.sqlite`)에 있습니다. 클라우드가 원본을 갖지 않습니다.
+- **자동으로 저장되는 건 아무것도 없습니다.** 내가 직접 고른 것만 저장됩니다.
+- 쓸수록 빙구팩은 "나"를 알아갑니다 — 내가 어떻게 판단하고, 뭘 선호하고, 어떤 실수를 했는지가 쌓여서, 다음에 비슷한 일이 오면 먼저 짚어줍니다.
+
+## 무엇을 할 수 있나요
+
+| 능력 | 한 줄 설명 |
+|---|---|
+| 🧹 **넓게 수집** | 어느 AI(Claude·ChatGPT·폰·웹)에서 일하든 남길 문장을 후보로 모음 |
+| 👀 **미리보기** | 모은 후보를 먼저 보여줌 — 이 단계에선 저장 0 |
+| ✍️ **내가 골라 저장** | 내가 직접 고른 것만 저장. AI는 저장 못 함 |
+| 🗣️ **화자 축** | 내 말(직감·지적)과 AI 요약(수정·수용·반박)을 **따로** 쌓고, 수용/반박/수정으로 연결 |
+| ⚖️ **양방향 신뢰도** | 내 직감과 AI 반박, **누가 더 잘 맞았나**를 기억. 한쪽 편 안 듦 — 나도 AI도 틀릴 수 있으니까 |
+| 🔁 **자기수정** | 틀린 판단은 고치고, 예측은 결과로 검증해 다음 판단이 똑똑해짐 |
+| 🧭 **충돌 조정(거버넌스)** | 내 학습과 기존 규칙이 부딪치면 양쪽 보여주고 내가 선택 — 규칙 변경은 사람 손(빙구팩은 제안만)·안전 규칙은 못 바꿈 |
+| 🧠 **회상·반문** | 일 시작 전 관련 기억과 과거 실수 패턴을 먼저 떠올려줌 |
+| 📦 **팩 만들기·검증** | 모은 지식을 다른 도구가 쓸 "꾸러미(팩)"로 묶고 구조를 검증 |
+| 🔀 **워크플로우 추천** | "이 목표엔 이런 팩·데이터가 필요해요"를 자동 제안(추천만 — 실행은 사람) |
+| ☁️ **안전하게 내보내기** | 외부 실행 엔진(OpenCrab)으로 보내기 전 안전점검·업로드 준비. 실제 전송은 내가 승인할 때만 |
+| 🔌 **Claude Code 연결** | `clone` 한 번으로 MCP 패키지 설치(도구 8개) |
+| 💻 **어디서나** | Windows · WSL · macOS · Linux |
+
+## 빠른 시작
+
+```bash
+git clone https://github.com/darkjokee-arch/binggupack.git
+cd binggupack
+python binggu.py init                         # 내 노트 만들기
+```
+
+**내 말과 AI 요약을 따로 쌓고 연결하기 (화자 축)**
+
+```bash
+# 내 직감 + AI 요약을 페어로 — relation: accepts(수용) / refutes(반박) / revises(수정)
+python binggu.py pair "이 입찰은 보류한다" "데이터가 부족해 보수적 접근이 맞다" \
+    --relation refutes --confirm "PAIR ai_refutes owner:1 ai:1"
+
+python binggu.py pair "다음엔 이 거래처 우선 검토" --confirm "PAIR owner:1"   # 내 직감만
+
+python binggu.py trust          # 누가 더 잘 맞나 (양방향 신뢰도)
+python binggu.py resolve <n> <id8> --outcome 성공   # 결과 기록 → 적중률 누적
+python binggu.py route "..."    # 뭘 할지 헷갈리면 안내해줌
+```
+
+> 더 자세히: [10분 튜토리얼](docs/BINGGUPACK_TUTORIAL.md) · [설치 가이드](INSTALL.md)
+
+## 팩과 워크플로우 (외부 도구로 연결)
+
+빙구팩은 모은 지식을 **혼자만 쓰는 게 아니라**, 다른 실행 도구(OpenCrab)가 받아 쓸 수 있게 **준비·검증·안전점검**까지 해줍니다.
+
+```
+목표 → 필요한 팩 추천 → 근거 모으기 → 팩 만들기 → 검증 → 발행 안전점검 → 내보내기 준비
+```
+
+- 각 단계가 fail-closed로 막혀, **깨지거나 근거 없는 팩은 외부로 못 나갑니다.**
+- 관계·워크플로우는 **추천만** 합니다 — 무엇을 만들고 내보낼지는 사람이 정합니다.
+- 실제 외부 업로드·클라우드 전송은 **내가 명시 승인하기 전까지 멈춤(HOLD)**. 자동으로 나가는 건 없습니다.
+
+> 흐름 상세: [팩 계약](docs/OPENBINGGU_PACK_CONTRACT.md) · [업로드 흐름](docs/OPENBINGGU_USER_DRIVEN_OPENCRAB_UPLOAD_FLOW.md) · [개인/팀 두 트랙](docs/OPENBINGGU_PRODUCT_DIRECTION_TWO_TRACK.md)
+
+## 자기진화 거버넌스 (충돌 조정)
+
+빙구팩 학습과 기존 규칙이 충돌할 때 — 빙구팩은 **양쪽을 보여주고 제안만**, 규칙 변경의 마지막 손은 **사람**입니다.
+
+- **충돌하면 양쪽 펼쳐 보여줌** → 내가 선택 (자동 결정 0)
+- **누가 더 잘 맞았나 기록** → 단 "참고 신호"일 뿐 결정 근거 아님
+- **규칙 진화는 사람 손** → 빙구팩이 제안 → 내가 진짜(raw) 확인 → 승인 → 변경(되돌리기 가능). 빙구팩은 규칙 파일에 손 못 댐
+- **안전 규칙은 불변** → DB삭제·시크릿 같은 안전 조항은 빙구팩이 무슨 학습을 해도 못 바꿈
+- **세션 마무리 한마디** → "오늘 끝"(말투 자유) 하면 저장 목록 + 정리를 자동 표시(저장은 내가)
+
+> 빙구팩은 똑똑한 비서처럼 조언하고 충돌 시 양쪽을 펼치지만, **도장은 항상 사람이** 찍습니다. 상세: [거버넌스 설계](docs/BINGGUPACK_GOVERNANCE_DESIGN.md).
+
+## 안전 약속
+
+빙구팩의 안전은 말이 아니라 **자동 테스트로 증명**됩니다.
+
+- **자동 저장 없음** — 내가 직접 고른 것만 저장. AI/자동 경로는 차단.
+- **민감정보 차단** — 비밀번호·개인정보는 후보 단계에서 자동 제외.
+- **언제든 되돌리기** — 모든 변경 전 백업 + 되돌리기 가능.
+- **원본은 내 PC** — 클라우드가 내 원본을 갖지 않음. 외부 업로드는 내가 승인하기 전까지 멈춤.
+
+## 더 알아보기
+
+- [자기진화 거버넌스 설계](docs/BINGGUPACK_GOVERNANCE_DESIGN.md) — 학습↔규칙 충돌 조정, self-modifying 회피 (v1.13.0)
+- [화자 축 설계](docs/BINGGUPACK_SPEAKER_AXIS_DESIGN.md) — 내 말/AI 요약 따로 쌓기, 양방향 신뢰도
+- [10분 튜토리얼](docs/BINGGUPACK_TUTORIAL.md) · [설치 가이드](INSTALL.md) · [변경 이력](CHANGELOG.md)
+
+## License
+
+MIT License — Copyright (c) 2026 BingguPack contributors.

binggupack-1.14.0/binggupack/__about__.py

@@ -0,0 +1,7 @@
+"""Single source of version truth for BingguPack.
+
+v1.13.0(자기진화 거버넌스) 위 v1.14.0 — MCP save_candidate 크래시 수정(snap_dir)
++ speaker CLI(save --speaker) + post-S4 release readiness docs. main 반영 완료.
+(GitHub release tag 는 owner 결정 — version 파일은 main 코드 상태를 반영한다.)
+"""
+__version__ = "1.14.0"

binggupack-1.14.0/binggupack/__init__.py

@@ -0,0 +1,9 @@
+"""BingguPack — local-first, evidence-backed memory/context pack framework.
+
+v1.11.0 groundwork: 내부 구현을 패키지 모듈로 단계적 이관.
+public entrypoint(scripts/smoke_test.py, scripts/install_claude_mcp.py, binggu.py)는
+backward-compatible 하게 유지된다.
+"""
+from binggupack.__about__ import __version__
+
+__all__ = ["__version__"]

binggupack-1.14.0/binggupack/capture/__init__.py

@@ -0,0 +1,9 @@
+"""capture — 빙구팩 캡처 파이프라인 모듈. v1.11.0 strangler phase5 이관 시작.
+
+현재: buffer(메모리 내 candidate 누적 + preview 렌더, 영속화 0) + session(buffer 를 감싸는
+on_user_prompt/on_session_end entrypoint). scripts/binggu_capture_buffer.py·binggu_capture_session.py
+는 backward-compatible thin wrapper 로 유지된다. classify 정본은 binggupack.classifier.
+"""
+from .buffer import CaptureBuffer  # noqa: F401
+from .session import CaptureSession  # noqa: F401
+from .cli import run_batch  # noqa: F401

binggupack-1.14.0/binggupack/capture/buffer.py

@@ -0,0 +1,117 @@
+"""빙구팩 캡처 버퍼 + batch preview 렌더 — 메모리 내만 (v1.11.0 strangler phase5 이관).
+
+scripts/binggu_capture_buffer.py 에서 이 모듈로 이관했다. scripts 파일은 backward-compatible
+thin wrapper(sys.path bootstrap + 전체 심볼 re-export + __main__ _selftest)로 유지되며
+공개 심볼(CaptureBuffer)/동작은 byte-identical 하다(기능 변경 0).
+
+classify import 는 binggupack 정본(binggupack.classifier.classify) 경유로 고정한다
+(scripts 역참조 안 함 — strangler 단방향 원칙). classify 함수 자체는 phase4 에서 이관된
+binggupack.classifier.capture_classifier.classify 와 동일 객체다.
+
+설계: BINGGUPACK_USER_ONTOLOGY_EVENT_SCHEMA_DESIGN.md §4
+- 메모리 buffer만 / ledger write 0 / 파일 저장 0 / OpenCrab 0
+- active 저장 0 / owner approval 처리 0 / candidate→confirmed 전이 0
+- preview_trigger 또는 세션말 시 후보 리스트 렌더(버퍼 삭제 안 함)
+"""
+
+from binggupack.classifier import classify
+
+
+class CaptureBuffer:
+    """메모리 내 candidate 누적 버퍼. 영속화 일절 없음."""
+
+    def __init__(self):
+        self._candidates = []  # 메모리 리스트만
+
+    def feed(self, utterance, prev_turn=None):
+        """발화 1건 처리. captured_candidate면 누적, preview_trigger면 렌더 반환.
+        반환: {"action": "captured"|"preview"|"ignored", "verdict": <classify dict>, "preview": <list|None>}"""
+        v = classify(utterance, prev_turn)
+        if v["state"] == "preview_trigger":
+            return {"action": "preview", "verdict": v, "preview": self.render_preview()}
+        if v["state"] == "captured_candidate":
+            self._candidates.append({
+                "text": utterance.strip(),
+                "pinned": v["pinned"],
+                "confidence": v["confidence"],
+                "signals": list(v["signals"]),
+                "state": "captured_candidate",  # active/confirmed 절대 아님
+            })
+            return {"action": "captured", "verdict": v, "preview": None}
+        return {"action": "ignored", "verdict": v, "preview": None}
+
+    def _ordered(self):
+        # pinned 상단 → 그 외. 안정 정렬(입력 순 보존)
+        return sorted(self._candidates, key=lambda c: 0 if c["pinned"] else 1)
+
+    def render_preview(self):
+        """현재 buffer를 preview 리스트로 렌더. 버퍼 삭제 안 함. write 0."""
+        lines = []
+        for i, c in enumerate(self._ordered(), 1):
+            tags = []
+            if c["pinned"]:
+                tags.append("PINNED")
+            if c["confidence"] == "weak":
+                tags.append("약함")
+            tag = f" [{' · '.join(tags)}]" if tags else ""
+            lines.append({
+                "idx": i,
+                "text": c["text"],
+                "pinned": c["pinned"],
+                "confidence": c["confidence"],
+                "label": f"{i}. {c['text']}{tag}",
+                "state": c["state"],  # 항상 captured_candidate
+            })
+        return {"count": len(lines), "items": lines, "note": "owner 승인 전 candidate (active 아님)"}
+
+    @property
+    def size(self):
+        return len(self._candidates)
+
+
+# ---------------- 셀프테스트 (메모리만, write 0) ----------------
+def _selftest():
+    buf = CaptureBuffer()
+    ok = True
+
+    def check(cond, msg):
+        nonlocal ok
+        mark = "PASS" if cond else "FAIL"
+        if not cond:
+            ok = False
+        print(f"  [{mark}] {msg}")
+        return cond
+
+    # 3개 후보: pinned(명시), 일반(결정), weak(추측+판단)
+    r1 = buf.feed("이거 저장해")
+    check(r1["action"] == "captured" and r1["verdict"]["pinned"], "T1 명시저장 → captured + pinned")
+    r2 = buf.feed("B안으로 결정")
+    check(r2["action"] == "captured" and r2["verdict"]["confidence"] == "normal", "T2 결정 → captured normal")
+    r3 = buf.feed("아마 이게 더 맞을 거야, 캐시 때문에")
+    check(r3["action"] == "captured" and r3["verdict"]["confidence"] == "weak", "T3 추측+판단 → weak 누적")
+
+    # ignored는 누적 안 됨
+    buf.feed("ㅋㅋ 웃기네")
+    check(buf.size == 3, "T4 ignored는 버퍼에 안 들어감 (size=3)")
+
+    # preview 트리거
+    r5 = buf.feed("빙구팩 저장해")
+    pv = r5["preview"]
+    check(r5["action"] == "preview", "T5 '빙구팩 저장해' → preview 액션")
+    check(pv["count"] == 3, "T6 preview 리스트 3개")
+    check(pv["items"][0]["pinned"], "T7 pinned가 맨 위")
+    check(any(it["confidence"] == "weak" for it in pv["items"]), "T8 weak 표시 존재")
+    check("약함" in [t for it in pv["items"] for t in [it["label"]] if "약함" in it["label"]] or
+          any("약함" in it["label"] for it in pv["items"]), "T9 weak 라벨 '약함' 표기")
+
+    # 렌더 후에도 버퍼 유지 + candidate 그대로
+    check(buf.size == 3, "T10 render 후 버퍼 유지 (size=3)")
+    check(all(it["state"] == "captured_candidate" for it in pv["items"]), "T11 candidate→active/confirmed 전이 0")
+
+    print("\n  preview 렌더 결과:")
+    for it in pv["items"]:
+        print("   ", it["label"])
+
+    gate = "GO" if ok else "NO-GO"
+    print(f"\nGATE={gate}")
+    return ok

binggupack-1.14.0/binggupack/capture/cli.py

@@ -0,0 +1,93 @@
+"""빙구팩 캡처 수동 호출 경로 (hook 없이) — stateless 배치 (v1.11.0 phase7 이관).
+
+scripts/binggu_capture_cli.py 에서 이 모듈로 이관했다. scripts 파일은 backward-compatible
+thin wrapper(sys.path bootstrap + 전체 심볼 re-export + __main__ run_cli)로 유지되며
+공개 심볼/동작/출력은 byte-identical 하다(기능 변경 0).
+
+CaptureSession import 는 binggupack 정본(binggupack.capture.session) 경유로 고정한다
+(scripts 역참조 0 — strangler 단방향). 서브모듈 직접 import 로 capture/__init__ 순환 회피.
+
+설계: BINGGUPACK_CAPTURE_MCP_EXPOSURE_DESIGN.md §3
+- 발화 리스트를 받아 CaptureSession에 순차 feed → preview 반환.
+- 메모리만 / ledger write 0 / 파일 저장 0 / OpenCrab 0 / active·approval 0.
+- MCP capture_preview(utterances[]) 무상태 노출의 로컬 검증판(동일 엔진).
+
+사용(수동):
+  echo 발화들 | python scripts/binggu_capture_cli.py        # stdin 줄단위
+  python scripts/binggu_capture_cli.py --feed "B안으로 결정" --feed "이거 저장해"
+  → preview JSON(stdout). "빙구팩 저장해" 만나면 그 시점 preview, 아니면 끝에서 preview.
+"""
+
+import json
+from binggupack.capture.session import CaptureSession
+
+
+def run_batch(utterances):
+    """발화 리스트를 무상태로 처리 → preview dict 반환. write 0."""
+    s = CaptureSession()
+    triggered = None
+    for u in utterances:
+        r = s.on_user_prompt(u)
+        if r["action"] == "preview":          # "빙구팩 저장해" 시점
+            triggered = r["preview"]
+    # 명시 트리거 없었으면 세션말 preview
+    preview = triggered if triggered is not None else s.on_session_end()["preview"]
+    return {
+        "trigger": "explicit" if triggered is not None else "session_end",
+        "buffer_size": s.size,
+        "preview": preview,
+        "note": "candidate (owner 승인 전, active 아님). write 0.",
+    }
+
+
+def _read_args(argv):
+    utts = []
+    i = 0
+    while i < len(argv):
+        if argv[i] == "--feed" and i + 1 < len(argv):
+            utts.append(argv[i + 1])
+            i += 2
+        else:
+            i += 1
+    return utts
+
+
+# ---------------- 셀프테스트 (write 0) ----------------
+def _selftest():
+    ok = True
+
+    def check(c, m):
+        nonlocal ok
+        ok = ok and c
+        print(f"  [{'PASS' if c else 'FAIL'}] {m}")
+
+    # 명시 트리거 경로
+    out = run_batch(["B안으로 결정", "이거 저장해", "빙구팩 저장해", "이건 무시될 농담 ㅋㅋ"])
+    check(out["trigger"] == "explicit", "T1 '빙구팩 저장해' → explicit 트리거")
+    check(out["preview"]["count"] == 2, "T2 트리거 시점 후보 2개(결정+pinned)")
+    check(out["preview"]["items"][0]["pinned"], "T3 pinned 맨 위")
+    check(all(it["state"] == "captured_candidate" for it in out["preview"]["items"]), "T4 active 전이 0")
+
+    # 세션말 경로(명시 트리거 없음)
+    out2 = run_batch(["로컬로 가자", "아마 B가 더 나을 거야, 비용 때문에", "ㅋㅋ"])
+    check(out2["trigger"] == "session_end", "T5 트리거 없으면 session_end")
+    check(out2["preview"]["count"] == 2, "T6 세션말 후보 2개(결정+weak)")
+    check(any(it["confidence"] == "weak" for it in out2["preview"]["items"]), "T7 weak 표시")
+    check(out2["buffer_size"] == 2, "T8 ignored(ㅋㅋ) 누적 안 됨")
+
+    print(f"\nGATE={'GO' if ok else 'NO-GO'}")
+    return ok
+
+
+def run_cli(argv=None):
+    """CLI entrypoint. --selftest / --feed / stdin 줄단위. 동작·출력·exit code byte-identical."""
+    import sys
+    argv = sys.argv[1:] if argv is None else argv
+    if "--selftest" in argv:
+        return 0 if _selftest() else 1
+    # 수동 호출: --feed 인자 우선, 없으면 stdin 줄단위
+    utts = _read_args(argv)
+    if not utts and not sys.stdin.isatty():
+        utts = [ln.strip() for ln in sys.stdin if ln.strip()]
+    print(json.dumps(run_batch(utts), ensure_ascii=False, indent=2))
+    return 0

binggupack-1.14.0/binggupack/capture/session.py

@@ -0,0 +1,115 @@
+"""빙구팩 캡처 세션 entrypoint — buffer/classifier를 감싸는 트리거 함수 (v1.11.0 phase6 이관).
+
+scripts/binggu_capture_session.py 에서 이 모듈로 이관했다. scripts 파일은 backward-compatible
+thin wrapper(sys.path bootstrap + 전체 심볼 re-export + __main__ _selftest)로 유지되며
+공개 심볼(CaptureSession)/동작은 byte-identical 하다(기능 변경 0).
+
+CaptureBuffer import 는 binggupack 정본(binggupack.capture.buffer) 경유로 고정한다
+(scripts 역참조 0 — strangler 단방향). 서브모듈 직접 import 로 capture/__init__ 순환 회피.
+
+설계: BINGGUPACK_USER_ONTOLOGY_EVENT_SCHEMA_DESIGN.md §4
+- 메모리만 / ledger write 0 / 파일 저장 0 / OpenCrab 0 / active·confirmed·approval 0
+- 신규 hook 등록 0 (수동 호출 가능한 entrypoint 함수까지만).
+
+연결 지점(확인만, 등록은 미래 별도 GO):
+- UserPromptSubmit hook → on_user_prompt(utterance)  (발화 캡처 + "빙구팩 저장해" preview)
+- Stop hook            → on_session_end()            (세션말 preview)
+- "빙구팩 저장해" 감지 = 기존 detect-bingoo-trigger.sh 패턴 재사용 가능
+"""
+
+from binggupack.capture.buffer import CaptureBuffer
+
+
+class CaptureSession:
+    """세션 1개 동안의 캡처 흐름. 전부 메모리. 영속화 0."""
+
+    def __init__(self):
+        self.buf = CaptureBuffer()
+
+    def on_user_prompt(self, utterance, prev_turn=None):
+        """발화 1건 진입점(UserPromptSubmit 연결 후보).
+        captured면 누적, '빙구팩 저장해'면 preview 반환."""
+        return self.buf.feed(utterance, prev_turn)
+
+    def on_session_end(self):
+        """세션말 진입점(Stop hook 연결 후보). preview 반환, buffer 삭제 안 함."""
+        return {"action": "preview", "trigger": "session_end", "preview": self.buf.render_preview()}
+
+    @property
+    def size(self):
+        return self.buf.size
+
+
+# ---------------- 셀프테스트 (메모리만, write 0) ----------------
+def _selftest():
+    ok = True
+
+    def check(cond, msg):
+        nonlocal ok
+        if not cond:
+            ok = False
+        print(f"  [{'PASS' if cond else 'FAIL'}] {msg}")
+
+    s = CaptureSession()
+
+    # 1) 일반 후보 2개 누적
+    s.on_user_prompt("로컬 정본으로 가자")
+    s.on_user_prompt("이건 절대 운영DB 건들지 마")
+    check(s.size == 2, "T1 일반 후보 2개 누적")
+
+    # 2) 명시저장 pinned 누적
+    s.on_user_prompt("이거 저장해")
+    check(s.size == 3, "T2 '이거 저장해' pinned 누적 (size=3)")
+
+    # 3) "빙구팩 저장해" preview 반환
+    r = s.on_user_prompt("빙구팩 저장해")
+    check(r["action"] == "preview" and r["preview"]["count"] == 3, "T3 '빙구팩 저장해' → preview 3개")
+    check(r["preview"]["items"][0]["pinned"], "T3b pinned 맨 위")
+
+    # 4) 세션말 함수 호출 preview 반환
+    e = s.on_session_end()
+    check(e["action"] == "preview" and e["trigger"] == "session_end" and e["preview"]["count"] == 3,
+          "T4 세션말 함수 → preview 3개")
+
+    # 5) preview 후 buffer 유지
+    check(s.size == 3, "T5 preview 후 buffer 유지 (size=3)")
+
+    # 6) active/confirmed 전이 0
+    check(all(it["state"] == "captured_candidate" for it in e["preview"]["items"]),
+          "T6 active/confirmed 전이 0")
+
+    # 7) 실발화 20개 경계 보정 (캡처 10 + 제외 10 기대)
+    print("\n  [실발화 20개 흘림]")
+    capture_expect = [
+        "로컬 정본으로 가자", "이건 절대 운영DB 건들지 마", "마감 임박건 우선 처리해",
+        "난 짧은 보고를 선호해", "나중에 이거 유료로 팔 거야", "그게 아니라 캐시부터 확인해야지",
+        "이거 저장해", "테스트는 항상 먼저 돌려", "아마 B가 더 나을 거야, 비용 때문에",
+        "위험해, 마감 직전에 터질 수 있어",
+    ]
+    ignore_expect = [
+        "ㅋㅋ 그래", "지금 진행상황 보여줘", "와 잘됐다", "테스트 한번 돌려봐", "음 그렇구나",
+        "고마워 수고했어", "아마 그럴걸", "이거 뭐였지?", "좀 피곤하네", "로그 확인 좀",
+    ]
+    s2 = CaptureSession()
+    cap_hit = ign_hit = 0
+    mis = []
+    for u in capture_expect:
+        st = s2.on_user_prompt(u)["verdict"]["state"]
+        if st == "captured_candidate":
+            cap_hit += 1
+        else:
+            mis.append(("누락", u, st))
+    base = s2.size
+    for u in ignore_expect:
+        st = s2.on_user_prompt(u)["verdict"]["state"]
+        if st == "ignored":
+            ign_hit += 1
+        else:
+            mis.append(("오탐", u, st))
+    print(f"    캡처 적중 {cap_hit}/10, 제외 적중 {ign_hit}/10, 버퍼 누적={s2.size}")
+    for kind, u, st in mis:
+        print(f"    - [{kind}] {u!r} → {st}")
+    check(cap_hit >= 9 and ign_hit >= 9, "T7 실발화 경계: 캡처/제외 각 9/10 이상")
+
+    print(f"\nGATE={'GO' if ok else 'NO-GO'}")
+    return ok