opensocrates 1.1.3 → 1.1.5

package/CHANGELOG.md

@@ -5,6 +5,73 @@ All notable changes to OpenSocrates are documented here. This project follows
 
 ## [Unreleased]
 
+## [1.1.5] - 2026-08-12
+
+### Added
+
+- Packaged `diagnose` now verifies the complete installed file inventory
+  against `checksums.sha256` and validates the release manifest's runtime
+  version, host, and content revision. Explicit `mismatch`, `unavailable`, and
+  `unverified` states replace presence-based claims
+  ([#64](https://github.com/ParkerHwang/OpenSocrates/issues/64)).
+- Release tests execute the packaged runtime against both intact packages and
+  a staged tampered Claude package so integrity reporting is exercised outside
+  the source process ([#64](https://github.com/ParkerHwang/OpenSocrates/issues/64)).
+
+### Changed
+
+- Claude grounding artifacts now prefer an owner-only, self-ignored
+  `.opensocrates` area inside the active workspace, while retaining the OS
+  temporary directory as a fail-open fallback. Lookup, receipts, expiry, and
+  cleanup handle both roots during upgrades and fallback runs
+  ([#62](https://github.com/ParkerHwang/OpenSocrates/issues/62)).
+- Codex package and installation documentation now requires one interactive
+  hook approval before automatic selection is expected and distinguishes
+  release-validated packaging from unvalidated live hook delivery
+  ([#63](https://github.com/ParkerHwang/OpenSocrates/issues/63)).
+
+### Fixed
+
+- Default-permission `claude -p` sessions can read selected grounding content
+  without `--add-dir`, avoiding the denied-read repair loop caused by placing
+  artifacts only in the system temporary directory
+  ([#62](https://github.com/ParkerHwang/OpenSocrates/issues/62)).
+- `diagnose` no longer reports manifest and checksum verification merely
+  because package files exist ([#64](https://github.com/ParkerHwang/OpenSocrates/issues/64)).
+
+## [1.1.4] - 2026-08-12
+
+### Added
+
+- A privacy-safe Claude selector aggregate records only bounded counts under a
+  closed outcome vocabulary. `diagnose` exposes those counts without prompts,
+  transcripts, session identifiers, paths, model output, credentials, or
+  selector reasoning ([#4](https://github.com/ParkerHwang/OpenSocrates/issues/4)).
+- A sanitized Cowork receipt validates local plugin upload and the native
+  `UserPromptSubmit` → `PostToolUse(Read)` → `Stop` lifecycle, including the
+  authenticated grounding receipt and final cleanup
+  ([#4](https://github.com/ParkerHwang/OpenSocrates/issues/4)).
+
+### Changed
+
+- Native runtime builds are split by host profile. The Claude package excludes
+  the Codex SDK and CLI while the Codex package preserves its existing runtime
+  surface ([#4](https://github.com/ParkerHwang/OpenSocrates/issues/4)).
+- Release tooling derives artifact paths from the detected native target,
+  defaults plugin generation to `dist/runtime/<host>`, and interprets Cowork's
+  50 MB and 200 MB limits conservatively as decimal bytes
+  ([#4](https://github.com/ParkerHwang/OpenSocrates/issues/4)).
+
+### Fixed
+
+- The Claude runtime now uses PyInstaller's no-archive mode, and release checks
+  reject nested ZIP entries before a Cowork package can be published
+  ([#4](https://github.com/ParkerHwang/OpenSocrates/issues/4)).
+- Unreadable selector aggregates report `unavailable` instead of zero attempts.
+  Malformed current-schema documents self-heal on the next valid outcome while
+  unknown future schemas are preserved
+  ([#4](https://github.com/ParkerHwang/OpenSocrates/issues/4)).
+
 ## [1.1.3] - 2026-08-11
 
 ### Added
@@ -271,3 +338,5 @@ All notable changes to OpenSocrates are documented here. This project follows
 [1.1.1]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.0...v1.1.1
 [1.1.2]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.1...v1.1.2
 [1.1.3]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.2...v1.1.3
+[1.1.4]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.3...v1.1.4
+[1.1.5]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.4...v1.1.5

package/README.ko.md

@@ -16,7 +16,7 @@ OpenSocrates는 Claude와 Codex를 위한 로컬 연동 및 저작 추론 프레
 추론 시스템을 고른 뒤, 이론과 예제 전체를 활성 작업에 추가합니다. 단순한 사실
 확인과 기계적인 작업은 그대로 통과할 수 있습니다.
 
-버전 `1.1.3`에는 48개의 추론 시스템, Claude의 단일 사용자 진입점, 선택된 절차를
+버전 `1.1.5`에는 48개의 추론 시스템, Claude의 단일 사용자 진입점, 선택된 절차를
 실제로 읽었는지 확인하는 Claude 접지 게이트, Claude/Codex 통합 라이프사이클,
 선택형 자동 업데이트가 들어 있습니다. 현재 릴리스 플랫폼은 Apple Silicon
 macOS(`darwin-arm64`)입니다. 기존 호스트 로그인을 사용하므로 API 키나
@@ -26,19 +26,20 @@ OpenSocrates 백엔드가 필요하지 않습니다.
 런처는 `darwin-arm64`만 허용하며, Intel Mac·Linux·Windows용 런처와 런타임은
 이번 릴리스에 포함되거나 지원되지 않습니다.
 
-> **최신 릴리스: [OpenSocrates 1.1.3](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.3).**
-> 인증된 실제 호스트 검증, 설치·정리 강화, 엄격한 패키지 지원 범위, 업로드 가능한
-> Claude Chat 스킬 ZIP을 추가했습니다. `npx --yes opensocrates@1.1.3 update --host all`로
-> 관리 중인 두 호스트를 함께 업데이트할 수 있습니다.
+> **최신 릴리스: [OpenSocrates 1.1.5](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.5).**
+> Claude 접지 파일을 추가 디렉터리 권한 없이 읽을 수 있게 하고, `diagnose`에서
+> 설치 패키지를 실제로 검증하며, Codex의 최초 훅 승인 경계를 명확히 했습니다.
+> `npx --yes opensocrates@1.1.5 update --host all`로 관리 중인 두 호스트를 함께
+> 업데이트할 수 있습니다.
 
 ## 호스트 지원 범위
 
 | 호스트 화면 | 자동 선택 | 사용자 진입점 | 검증 상태 |
 | --- | --- | --- | --- |
-| Codex CLI 및 Desktop | 지원 | OpenSocrates 플러그인 | `darwin-arm64` 릴리스 검증 완료 |
+| Codex CLI 및 Desktop | 앱에서 훅을 한 번 승인한 뒤 지원 | OpenSocrates 플러그인 | `darwin-arm64` 패키지·런처 릴리스 검증 완료, 실제 Codex 훅 전달 영수증 없음 |
 | Claude Code CLI | `UserPromptSubmit` 훅으로 지원 | `/opensocrates` | `darwin-arm64` 로컬 검증 완료 |
 | Claude Code 데스크톱 앱 | Claude Code 플러그인이 실행되는 곳에서 지원 | `/opensocrates` | [인증된 훅 생명주기 로컬 검증 완료](docs/claude-desktop-live-probe.md) |
-| Claude Cowork | 실측 설치에서는 자동 훅 미지원 | `/opensocrates` 독립 스킬 | [스킬 로컬 검증 완료, 네이티브 플러그인은 아카이브 제한으로 차단](docs/claude-cowork-live-probe.md) |
+| Claude Cowork | 실측 로컬 플러그인 업로드에서 지원 | `/opensocrates` | [네이티브 훅 생명주기 로컬 검증 완료, 릴리스 직접 업로드 지원, 마켓플레이스 동기화 없음](docs/claude-cowork-live-probe.md) |
 | Claude 웹 및 Desktop Chat | 훅 미지원 | `/opensocrates` | [실제 업로드 및 호출 검증 완료](docs/claude-chat-upload-probe.md) |
 
 상태 열은 서로 다른 네 단계를 뜻하며 같은 의미로 읽으면 안 됩니다.
@@ -46,7 +47,8 @@ OpenSocrates 백엔드가 필요하지 않습니다.
 - **구현 완료** — 코드에 존재하고 패키지에 포함됩니다.
 - **로컬 검증 완료** — 관리자 장비에서 전 구간을 실행했지만 매 빌드마다
   검증하지는 않습니다.
-- **릴리스 검증 완료** — 릴리스 게이트가 매 빌드마다 실행합니다.
+- **릴리스 검증 완료** — 릴리스 게이트가 매 빌드마다 실행합니다. 현재 Codex는
+  패키지와 런처를 검증하며 실제 훅 전달까지 검증했다는 뜻은 아닙니다.
 - **실험적 / 실측 수신 기록 없음** — 구현은 되어 있지만 호스트가 실제로 훅을
   전달했다는 기록이 없습니다. `os capabilities show`는 이 항목들을 사용 가능이
   아니라 `unknown`으로 보고합니다.
@@ -56,12 +58,13 @@ Claude Chat 화면은 플러그인 훅을 실행하지 않습니다. 생성된
 Code와 Cowork 화면에서만 작동합니다. 훅이나 셀렉터를 사용할 수 없으면
 OpenSocrates는 작업을 막지 않고 통과합니다.
 
-현재 실측 UI에서 Cowork는 Claude Code CLI 사용자 마켓플레이스 등록을 네이티브
-Cowork 플러그인으로 가져오지 않습니다. 별도로 업로드한 `/opensocrates` 스킬은
-로컬 검증을 통과했지만, 공개된 v1.1.2 Claude 플러그인 아카이브는 Cowork의 문서화된
-압축 크기 제한과 실측 압축 해제 크기 제한을 모두 초과합니다. 저장소에도 Cowork
-마켓플레이스 매니페스트가 없습니다. Cowork 네이티브 플러그인을 설치하고 훅을 다시
-검증하기 전까지는 독립 스킬 전용 화면으로 취급하세요.
+공개된 v1.1.2 Claude 플러그인 아카이브는 Cowork의 문서화된 압축 크기 제한과
+실측 압축 해제 크기 제한을 모두 초과했습니다. 출시 전 v1.1.3 후보는 압축
+13.8MB, 비압축 34.1MB이며 Codex 런타임과 중첩 ZIP을 포함하지 않고 Cowork 로컬
+업로드를 통과했습니다. UserPromptSubmit, PostToolUse(Read), 인증된 grounding
+receipt, Stop, 정리 생명주기도 로컬 검증을 마쳤습니다. 버전 1.1.4는 검토를 마친
+이 패키지 경계를 처음 배포합니다. 저장소에는 아직 Cowork 마켓플레이스
+매니페스트가 없으므로 저장소 동기화 대신 로컬 플러그인 업로드 경로를 사용합니다.
 
 ## 설치
 
@@ -78,7 +81,7 @@ Node.js 20 이상이 필요합니다. npm에 게시된 `opensocrates` 패키지
 ### 준비된 모든 호스트에 설치
 
 ```bash
-npx --yes opensocrates@1.1.3 install --host all
+npx --yes opensocrates@1.1.5 install --host all
 ```
 
 모든 호스트 경로는 지원되는 인증 완료 CLI를 찾고, 어느 호스트도 바꾸기 전에
@@ -89,9 +92,9 @@ npx --yes opensocrates@1.1.3 install --host all
 전체 라이프사이클에서 같은 호스트 값을 사용할 수 있습니다.
 
 ```bash
-npx --yes opensocrates@1.1.3 status --host all
-npx --yes opensocrates@1.1.3 update --host all
-npx --yes opensocrates@1.1.3 remove --host all
+npx --yes opensocrates@1.1.5 status --host all
+npx --yes opensocrates@1.1.5 update --host all
+npx --yes opensocrates@1.1.5 remove --host all
 ```
 
 소유자 전용 `~/.opensocrates/desired-state.json`에는 선택 채널, 설치된 호스트,
@@ -103,9 +106,9 @@ npx --yes opensocrates@1.1.3 remove --host all
 기존 사용자와의 호환성을 위해 기본 호스트는 계속 Codex입니다.
 
 ```bash
-npx --yes opensocrates@1.1.3 install
-# 같은 명령: npx --yes opensocrates@1.1.3 install --host codex
-npx --yes opensocrates@1.1.3 install --host claude
+npx --yes opensocrates@1.1.5 install
+# 같은 명령: npx --yes opensocrates@1.1.5 install --host codex
+npx --yes opensocrates@1.1.5 install --host claude
 ```
 
 기존 `--host codex` 및 `--host claude` 라이프사이클은 그대로 지원합니다. 호스트별
@@ -122,9 +125,9 @@ Claude 상태는 활성 설치와 설치됐지만 비활성화된 플러그인
 ### 선택형 자동 업데이트
 
 ```bash
-npx --yes opensocrates@1.1.3 auto-update enable --host all
-npx --yes opensocrates@1.1.3 auto-update status
-npx --yes opensocrates@1.1.3 auto-update disable
+npx --yes opensocrates@1.1.5 auto-update enable --host all
+npx --yes opensocrates@1.1.5 auto-update status
+npx --yes opensocrates@1.1.5 auto-update disable
 ```
 
 자동 업데이트는 명시적으로 켜기 전까지 비활성화되어 있습니다. macOS LaunchAgent는
@@ -146,7 +149,7 @@ LaunchAgent를 언로드하고 삭제하며, `remove --host all`도 관리 호
 ### Claude 웹 및 Desktop Chat 스킬
 
 이 화면들은 플러그인 스킬은 지원하지만 훅은 실행하지 않습니다. 릴리스에서
-`opensocrates-1.1.3-claude-chat-skills.zip`을 내려받아 Claude의 **사용자 지정 →
+`opensocrates-1.1.5-claude-chat-skills.zip`을 내려받아 Claude의 **사용자 지정 →
 스킬 → 스킬 업로드** 화면에서 업로드하세요. ZIP은 업로더 요구사항에 맞춰
 최상위 `opensocrates/` 폴더 바로 아래에 `SKILL.md`를 둡니다. 패키지는
 `/opensocrates` 스킬 하나만 노출하고, 48개
@@ -160,21 +163,21 @@ LaunchAgent를 언로드하고 삭제하며, `remove --host all`도 관리 호
 npm 레지스트리를 거치지 않을 때도 같은 호스트 옵션을 사용합니다.
 
 ```bash
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.3 install --host all
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.3 install --host claude
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.3 install --host codex
+npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host all
+npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host claude
+npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host codex
 ```
 
 ### 릴리스 파일 직접 검증
 
-[v1.1.3 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.3)에서
+[v1.1.5 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.5)에서
 `opensocrates.mjs`, 호스트 패키지, `.sha256` 파일을 내려받습니다. Claude의 예:
 
 ```bash
-shasum -a 256 -c opensocrates-1.1.3-claude-plugin.zip.sha256
+shasum -a 256 -c opensocrates-1.1.5-claude-plugin.zip.sha256
 node opensocrates.mjs install --host claude \
-  --asset opensocrates-1.1.3-claude-plugin.zip \
-  --checksum opensocrates-1.1.3-claude-plugin.zip.sha256
+  --asset opensocrates-1.1.5-claude-plugin.zip \
+  --checksum opensocrates-1.1.5-claude-plugin.zip.sha256
 ```
 
 Codex 패키지는 `claude`를 `codex`로 바꾸면 됩니다.
@@ -189,7 +192,7 @@ Codex 패키지는 `claude`를 `codex`로 바꾸면 됩니다.
 ```bash
 claude plugin uninstall opensocrates@OpenSocrates --scope user
 claude plugin marketplace remove OpenSocrates --scope user
-npx --yes opensocrates@1.1.3 install --host claude
+npx --yes opensocrates@1.1.5 install --host claude
 ```
 
 관리형 v1.1.0 Claude 설치를 업데이트하면 패키지 트리 전체가 교체됩니다. 따라서
@@ -204,12 +207,25 @@ Claude나 Codex를 평소처럼 사용하세요. 요청에 판단, 해석, 진
 
 1. 현재 호스트에서 새로운 비영구 셀렉터를 시작합니다.
 2. 저작된 48개 시스템 카탈로그에서 적합한 시스템을 선택합니다.
-3. 선택된 전체 콘텐츠를 소유자 전용 임시 Markdown 파일에 씁니다.
+3. 선택된 전체 콘텐츠를 소유자 전용 Markdown 파일에 씁니다.
 4. 각 방법 ID와 콘텐츠 리비전, 크기 한도 안에 들면 정확한 `Do not use when` 및
    `Stop conditions`를 작은 숨김 컨텍스트에 추가합니다.
 5. 활성 작업이 방법을 적용하기 전에 전체 파일을 읽고, 접지된 답변의 마지막에
    `OpenSocrates grounding: triangulation@1`과 같은 정확한 감사 줄을 남기게 합니다.
 
+Codex에 설치한 뒤에는 대화형 Codex 세션을 한 번 열어 OpenSocrates 훅을 승인해야
+자동 선택을 신뢰할 수 있습니다. 이 승인이 끝나기 전에는 `codex exec` 같은 비대화형
+화면이 신뢰되지 않은 훅을 조용히 건너뛸 수 있습니다.
+
+Claude 훅 화면은 추가 디렉터리 권한 없이 선택 콘텐츠를 읽을 수 있도록 현재
+워크스페이스 안의 소유자 전용 `.opensocrates` artifact 영역을 우선 사용합니다.
+내부 `.gitignore`가 이 영역을 `git status`에서 숨기고 turn·세션 정리 시 파일을
+삭제합니다. 워크스페이스를 사용할 수 없으면 소유자 전용 OS 임시 디렉터리로
+대체합니다. 다만 `.gitignore`나 숨김 디렉터리를 무시하지 않는 별도 백업·동기화
+도구는 artifact가 존재하는 동안 저작된 OpenSocrates 콘텐츠를 볼 수 있습니다.
+artifact에는 원시 프롬프트, 대화 기록, 워크스페이스 콘텐츠, 자격 증명, 셀렉터
+추론이 들어가지 않습니다.
+
 Claude 훅 화면에서는 Read 전용 `PostToolUse` 훅이 현재 turn의 정확한 파일을 첫
 줄부터 종료 표식까지 읽은 경우에만 인증된 영수증을 만듭니다. `Stop` 시 영수증이나
 감사 줄이 없으면 한 번만 보정을 요청하고, `stop_hook_active`로 반복 보정을
@@ -282,6 +298,23 @@ OpenSocrates 기록, 로그, 메트릭, 진단 또는 instruction 파일에 쓰
 남은 파일을 삭제하고, 다음 `SessionStart`는 24시간이 지난 비정상 종료 잔여 파일을
 삭제합니다.
 
+Claude 셀렉터 시도는 `executable_missing`, `request_rejected`, `spawn_failed`,
+`timeout`, `nonzero_exit`, `invalid_output`, `selector_closed`,
+`no_intervention`, `selected`라는 고정 라벨만 사용해 소유자 전용 로컬 집계에
+누적됩니다. `diagnose`는 이 누적 횟수를 표시합니다. 집계에는 시각, 프롬프트,
+대화 기록, 세션·turn ID, 경로, 모델 출력, 자격 증명 또는 추론이 없으며 외부로
+업로드되지 않습니다.
+집계를 읽을 수 없으면 `diagnose`는 시도 0회라고 단정하지 않고 `unavailable`로
+표시합니다. 다음 유효한 셀렉터 결과가 현재 스키마의 손상된 집계를 새로운 제한된
+카운트 문서로 교체하며, 알 수 없는 미래 스키마는 해당 새 런타임을 위해 보존합니다.
+
+패키지의 `diagnose` 명령은 설치 파일 목록을 `checksums.sha256`과 대조하고 릴리스
+manifest가 실행 중인 버전·호스트·콘텐츠 리비전을 가리키는지도 확인합니다. 단순한
+파일 존재 여부로 성공을 추정하지 않고 `verified`, `mismatch`, `unavailable`,
+`unverified`를 표시합니다. 이 해시는 로컬 변경이나 손상을 찾지만 manifest와
+checksum 파일 자체는 서명되지 않았으므로 패키지 전체를 바꿀 수 있는 공격자에 대한
+진본성 증명은 아닙니다.
+
 자동 업데이트를 켜면 앞서 설명한 desired state와 간결한 영수증만 소유자 전용
 권한으로 저장합니다. 실행 중인 Claude나 Codex 세션을 검사하거나 종료하지 않습니다.
 이미 실행 중인 작업은 로드한 플러그인을 계속 쓰고, 새 작업이 조정된 버전을 자연스럽게

package/README.md

@@ -17,7 +17,7 @@ uses a fresh host-native selector to choose relevant systems, and adds their
 complete theory and examples to the active task. Straightforward factual and
 mechanical work can pass through unchanged.
 
-Version `1.1.3` includes 48 reasoning systems, one user-facing Claude entry, a
+Version `1.1.5` includes 48 reasoning systems, one user-facing Claude entry, a
 Claude grounding gate that verifies selected procedures were read, coordinated
 Claude/Codex lifecycle management, and opt-in automatic updates on
 Apple-silicon macOS (`darwin-arm64`). It uses your existing host login and does
@@ -27,20 +27,21 @@ The native plugin archives intentionally ship only `bin/launch.sh`. That
 launcher accepts `darwin-arm64` only; macOS Intel, Linux, and Windows launchers
 and runtimes are not shipped or supported in this release.
 
-> **Latest release: [OpenSocrates 1.1.3](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.3).**
-> It adds authenticated live-host validation, installer and cleanup hardening,
-> strict package support boundaries, and an uploadable Claude Chat skills ZIP.
+> **Latest release: [OpenSocrates 1.1.5](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.5).**
+> It makes Claude grounding readable without extra directory permission,
+> verifies installed package files in `diagnose`, and documents Codex's
+> one-time hook approval boundary.
 > Upgrade both managed hosts together with
-> `npx --yes opensocrates@1.1.3 update --host all`.
+> `npx --yes opensocrates@1.1.5 update --host all`.
 
 ## Host support
 
 | Host surface | Automatic selection | User-facing entry | Validation status |
 | --- | --- | --- | --- |
-| Codex CLI and Desktop | Yes | OpenSocrates plugin | Release-validated on `darwin-arm64` |
+| Codex CLI and Desktop | Yes, after one-time in-app hook approval | OpenSocrates plugin | Package and launcher release-validated on `darwin-arm64`; no live Codex hook-delivery receipt |
 | Claude Code CLI | Yes, through `UserPromptSubmit` | `/opensocrates` | Locally validated on `darwin-arm64` |
 | Claude Code desktop app | Yes, where Claude Code plugins run | `/opensocrates` | [Authenticated hook lifecycle locally validated](docs/claude-desktop-live-probe.md) |
-| Claude Cowork | No automatic hooks in the tested install | `/opensocrates` standalone skill | [Skill locally validated; native plugin blocked by archive limits](docs/claude-cowork-live-probe.md) |
+| Claude Cowork | Yes, in the tested local plugin upload | `/opensocrates` | [Native hook lifecycle locally validated; direct release upload, no marketplace sync](docs/claude-cowork-live-probe.md) |
 | Claude web and Desktop Chat | No hooks | `/opensocrates` | [Live upload and invocation validated](docs/claude-chat-upload-probe.md) |
 
 The status column uses four distinct levels. Do not read them as
@@ -49,7 +50,8 @@ interchangeable:
 - **Implemented** — the integration exists in code and ships in the package.
 - **Locally validated** — exercised end to end on a maintainer machine, but
   not on every build.
-- **Release-validated** — exercised by the release gate on every build.
+- **Release-validated** — exercised by the release gate on every build. For
+  Codex this currently covers the package and launcher, not live hook delivery.
 - **Experimental / no live probe receipt** — implemented, but no captured
   receipt shows the host actually delivering the hook. `os capabilities show`
   reports these capabilities as `unknown`, not as available.
@@ -59,13 +61,15 @@ skills, but automatic per-prompt selection is available only on Claude Code
 and Cowork surfaces that execute the plugin runtime. OpenSocrates fails open
 if a hook or selector is unavailable.
 
-Cowork does not import the Claude Code CLI user-marketplace registration as a
-native Cowork plugin in the current live UI. A separately uploaded
-`/opensocrates` skill is locally validated, but the published v1.1.2 Claude
-plugin archive exceeds Cowork's documented compressed limit and observed
-uncompressed limit. The repository also lacks a Cowork marketplace manifest.
-Until a Cowork-native plugin can be installed and its hooks re-probed, treat
-Cowork as a standalone-skill-only surface.
+The published v1.1.2 Claude plugin archive exceeded Cowork's documented
+compressed limit and observed uncompressed limit. A pre-release v1.1.3
+candidate was 13.8 MB compressed and 34.1 MB uncompressed, contained neither
+the Codex runtime nor a nested ZIP, and passed Cowork's local upload. Its
+UserPromptSubmit, PostToolUse(Read), authenticated grounding receipt, Stop, and
+cleanup lifecycle is locally validated. Version 1.1.4 is the first release to
+ship that reviewed package boundary. The repository still has no Cowork
+marketplace manifest, so Cowork installation uses the local plugin upload path
+rather than repository sync.
 
 ## Install
 
@@ -82,7 +86,7 @@ before registering an owner-marked managed marketplace.
 ### Install every ready host
 
 ```bash
-npx --yes opensocrates@1.1.3 install --host all
+npx --yes opensocrates@1.1.5 install --host all
 ```
 
 The all-host path detects supported, authenticated host CLIs, completes every
@@ -94,9 +98,9 @@ registration.
 Use the same host value for the complete lifecycle:
 
 ```bash
-npx --yes opensocrates@1.1.3 status --host all
-npx --yes opensocrates@1.1.3 update --host all
-npx --yes opensocrates@1.1.3 remove --host all
+npx --yes opensocrates@1.1.5 status --host all
+npx --yes opensocrates@1.1.5 update --host all
+npx --yes opensocrates@1.1.5 remove --host all
 ```
 
 A private `~/.opensocrates/desired-state.json` manifest records the selected
@@ -109,9 +113,9 @@ automatic update, and per-host drift.
 Codex remains the default host for backward compatibility:
 
 ```bash
-npx --yes opensocrates@1.1.3 install
-# Equivalent: npx --yes opensocrates@1.1.3 install --host codex
-npx --yes opensocrates@1.1.3 install --host claude
+npx --yes opensocrates@1.1.5 install
+# Equivalent: npx --yes opensocrates@1.1.5 install --host codex
+npx --yes opensocrates@1.1.5 install --host claude
 ```
 
 Existing `--host codex` and `--host claude` lifecycle commands remain
@@ -131,9 +135,9 @@ commands. The privacy-safe 2.1.226 fixture is under
 ### Opt-in automatic updates
 
 ```bash
-npx --yes opensocrates@1.1.3 auto-update enable --host all
-npx --yes opensocrates@1.1.3 auto-update status
-npx --yes opensocrates@1.1.3 auto-update disable
+npx --yes opensocrates@1.1.5 auto-update enable --host all
+npx --yes opensocrates@1.1.5 auto-update status
+npx --yes opensocrates@1.1.5 auto-update disable
 ```
 
 Automatic updates are disabled until explicitly enabled. The macOS LaunchAgent
@@ -156,7 +160,7 @@ workspace paths. `auto-update disable` unloads and removes the LaunchAgent;
 ### Claude web and Desktop Chat skills
 
 These surfaces support plugin skills but not hooks. Download
-`opensocrates-1.1.3-claude-chat-skills.zip` from the release and upload it from
+`opensocrates-1.1.5-claude-chat-skills.zip` from the release and upload it from
 Claude's **Customize → Skills → Upload skill** UI. The ZIP contains one
 top-level `opensocrates/` folder with `SKILL.md` directly inside, as required by
 the skill uploader. The package exposes exactly one
@@ -170,22 +174,22 @@ because Chat does not execute plugin hooks. See Anthropic's
 The same host option works without the npm registry:
 
 ```bash
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.3 install --host all
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.3 install --host claude
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.3 install --host codex
+npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host all
+npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host claude
+npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host codex
 ```
 
 ### Manual release verification
 
 Download `opensocrates.mjs`, the host package, and its `.sha256` file from the
-[v1.1.3 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.3).
+[v1.1.5 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.5).
 For Claude, for example:
 
 ```bash
-shasum -a 256 -c opensocrates-1.1.3-claude-plugin.zip.sha256
+shasum -a 256 -c opensocrates-1.1.5-claude-plugin.zip.sha256
 node opensocrates.mjs install --host claude \
-  --asset opensocrates-1.1.3-claude-plugin.zip \
-  --checksum opensocrates-1.1.3-claude-plugin.zip.sha256
+  --asset opensocrates-1.1.5-claude-plugin.zip \
+  --checksum opensocrates-1.1.5-claude-plugin.zip.sha256
 ```
 
 Replace `claude` with `codex` for the Codex package.
@@ -200,7 +204,7 @@ what is installed, remove it explicitly:
 ```bash
 claude plugin uninstall opensocrates@OpenSocrates --scope user
 claude plugin marketplace remove OpenSocrates --scope user
-npx --yes opensocrates@1.1.3 install --host claude
+npx --yes opensocrates@1.1.5 install --host claude
 ```
 
 Updating a managed v1.1.0 Claude installation replaces the complete package
@@ -216,14 +220,28 @@ reasoning process. When it intervenes, it:
 
 1. starts a fresh, non-persistent selector in the current host;
 2. chooses from the authored 48-system catalog;
-3. writes the complete selected content to an owner-only temporary Markdown
-   file;
+3. writes the complete selected content to an owner-only Markdown file;
 4. adds a bounded hidden context message with each method ID, content revision,
    and, when they fit, its exact `Do not use when` and `Stop conditions`; and
 5. requires the active task to read the complete file before applying the
    method and to end a grounded response with an exact audit line such as
    `OpenSocrates grounding: triangulation@1`.
 
+After installing for Codex, open one interactive Codex session and approve the
+OpenSocrates hooks before relying on automatic selection. Until that one-time
+approval, non-interactive surfaces such as `codex exec` may silently continue
+without running the untrusted hooks.
+
+Claude hook surfaces prefer an owner-only `.opensocrates` artifact area inside
+the current workspace so Claude can read the selected content without an extra
+directory permission. Its self-contained `.gitignore` keeps the area out of
+`git status`; files are removed on turn/session cleanup. If the workspace is
+unusable, OpenSocrates falls back to the owner-only OS temporary directory.
+Because the preferred area is inside the workspace, a separate backup or sync
+tool that ignores neither `.gitignore` nor hidden directories could observe the
+authored OpenSocrates artifact while it exists. Artifacts never contain the raw
+prompt, transcript, workspace content, credentials, or selector reasoning.
+
 On Claude hook surfaces, a Read-only `PostToolUse` hook records an authenticated
 receipt only when the exact current-turn file is read from its first line
 through a terminal marker. At `Stop`, a missing receipt or audit line requests
@@ -300,6 +318,25 @@ arrives, the next `UserPromptSubmit` in the same session removes every prior
 active tree. `SessionEnd` removes anything still left in the session, and the
 next `SessionStart` removes crash leftovers older than 24 hours.
 
+Claude selector attempts increment one owner-only local aggregate using only
+the fixed labels `executable_missing`, `request_rejected`, `spawn_failed`,
+`timeout`, `nonzero_exit`, `invalid_output`, `selector_closed`,
+`no_intervention`, and `selected`. `diagnose` reports those cumulative counts.
+The aggregate contains no timestamp, prompt, transcript, session or turn ID,
+path, model output, credential, or reasoning, and is never uploaded.
+If the aggregate is unreadable, `diagnose` reports it as `unavailable` instead
+of asserting zero attempts. The next valid selector outcome replaces a
+malformed current-schema aggregate with a fresh bounded count document; an
+unknown future schema is preserved for the newer runtime that owns it.
+
+The packaged `diagnose` command also verifies the installed file inventory
+against `checksums.sha256` and checks that the release manifest identifies the
+running version, host, and content revision. It reports `verified`, `mismatch`,
+`unavailable`, or `unverified` rather than inferring success from file presence.
+These hashes detect local change or damage; the manifest and checksum file are
+not signed and therefore are not an authenticity proof against an attacker who
+can replace the whole package.
+
 When enabled, the updater stores only desired lifecycle state and the concise
 receipt described above, under owner-only permissions. It does not inspect or
 terminate running Claude or Codex sessions; a running task keeps its loaded

package/SECURITY.md

@@ -48,6 +48,13 @@ OpenSocrates 1.x:
   receipts;
 - fails open when the selector cannot safely complete.
 
+The installed `diagnose` command verifies the exact package inventory against
+`checksums.sha256` and validates release-manifest identity for the running
+version, host, and content revision. A mismatch is reported explicitly. These
+files are not signed, so this is local integrity and damage detection, not an
+authenticity guarantee against an attacker able to replace the complete
+package and its checksum metadata.
+
 The Claude selector runs a bounded, non-persistent `claude --safe-mode -p`
 process. Safe mode disables user, project, and plugin customizations, and
 OpenSocrates additionally passes `--tools ""`, `--disallowedTools "mcp__*"`, and
@@ -62,6 +69,17 @@ small set of allowed path variables because the child needs it to locate the
 user's existing Claude login when a non-default config directory is in use.
 OpenSocrates does not copy, inspect, or log credentials from that directory.
 
+For fail-open diagnosis, each Claude selector attempt increments one
+owner-only local aggregate under a closed nine-label vocabulary. The aggregate
+stores counts only: it has no timestamp, prompt, transcript, session or turn
+identifier, path, model output, credential, or reasoning. It is shown by the
+local `diagnose` command and is never transmitted.
+An unreadable aggregate is reported as `unavailable`, never as zero observed
+attempts. The next valid selector outcome atomically replaces only a malformed
+current-schema aggregate with a fresh bounded count document; an unknown future
+schema is preserved. Rejected malformed bytes are never copied into another
+file.
+
 Managed policy settings are part of the host trust boundary and are not disabled.
 Anthropic's [CLI reference](https://code.claude.com/docs/en/cli-reference) states
 that under `--safe-mode` "managed settings policy still applies, including

package/VERSION

@@ -1 +1 @@
-1.1.3
+1.1.5

package/installer/opensocrates.mjs

@@ -24,7 +24,7 @@ import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { fileURLToPath } from "node:url";
 
-export const PRODUCT_VERSION = "1.1.3";
+export const PRODUCT_VERSION = "1.1.5";
 export const REPOSITORY = "ParkerHwang/OpenSocrates";
 export const MARKETPLACE_NAME = "opensocrates";
 export const PLUGIN_NAME = "opensocrates";
@@ -1579,6 +1579,13 @@ async function runInstallOrUpdate(options, action) {
   console.log(
     `OpenSocrates ${PRODUCT_VERSION} ${verb} successfully for ${hosts.join(", ")}.`,
   );
+  if (hosts.includes("codex")) {
+    console.log(
+      "Codex approval required: open one interactive Codex session and approve the " +
+        "OpenSocrates hooks before relying on automatic selection. Non-interactive " +
+        "codex exec silently skips hooks that have not been trusted.",
+    );
+  }
   console.log("Start new host tasks to load the updated skills and hooks.");
   return hosts;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opensocrates",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Install and manage OpenSocrates for Claude Code, Cowork, and Codex.",
   "type": "module",
   "bin": {