opensocrates 1.1.4 → 1.1.5

package/CHANGELOG.md

@@ -5,6 +5,40 @@ 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
@@ -305,3 +339,4 @@ All notable changes to OpenSocrates are documented here. This project follows
 [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.4`에는 48개의 추론 시스템, Claude의 단일 사용자 진입점, 선택된 절차를
+버전 `1.1.5`에는 48개의 추론 시스템, Claude의 단일 사용자 진입점, 선택된 절차를
 실제로 읽었는지 확인하는 Claude 접지 게이트, Claude/Codex 통합 라이프사이클,
 선택형 자동 업데이트가 들어 있습니다. 현재 릴리스 플랫폼은 Apple Silicon
 macOS(`darwin-arm64`)입니다. 기존 호스트 로그인을 사용하므로 API 키나
@@ -26,17 +26,17 @@ OpenSocrates 백엔드가 필요하지 않습니다.
 런처는 `darwin-arm64`만 허용하며, Intel Mac·Linux·Windows용 런처와 런타임은
 이번 릴리스에 포함되거나 지원되지 않습니다.
 
-> **최신 릴리스: [OpenSocrates 1.1.4](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.4).**
-> Cowork에 업로드할 수 있는 Claude 네이티브 패키지, 호스트별 런타임 분리, 사용할 수
-> 없는 집계와 0회를 구분하는 내용 없는 셀렉터 진단을 추가했습니다.
-> `npx --yes opensocrates@1.1.4 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) |
@@ -47,7 +47,8 @@ OpenSocrates 백엔드가 필요하지 않습니다.
 - **구현 완료** — 코드에 존재하고 패키지에 포함됩니다.
 - **로컬 검증 완료** — 관리자 장비에서 전 구간을 실행했지만 매 빌드마다
   검증하지는 않습니다.
-- **릴리스 검증 완료** — 릴리스 게이트가 매 빌드마다 실행합니다.
+- **릴리스 검증 완료** — 릴리스 게이트가 매 빌드마다 실행합니다. 현재 Codex는
+  패키지와 런처를 검증하며 실제 훅 전달까지 검증했다는 뜻은 아닙니다.
 - **실험적 / 실측 수신 기록 없음** — 구현은 되어 있지만 호스트가 실제로 훅을
   전달했다는 기록이 없습니다. `os capabilities show`는 이 항목들을 사용 가능이
   아니라 `unknown`으로 보고합니다.
@@ -80,7 +81,7 @@ Node.js 20 이상이 필요합니다. npm에 게시된 `opensocrates` 패키지
 ### 준비된 모든 호스트에 설치
 
 ```bash
-npx --yes opensocrates@1.1.4 install --host all
+npx --yes opensocrates@1.1.5 install --host all
 ```
 
 모든 호스트 경로는 지원되는 인증 완료 CLI를 찾고, 어느 호스트도 바꾸기 전에
@@ -91,9 +92,9 @@ npx --yes opensocrates@1.1.4 install --host all
 전체 라이프사이클에서 같은 호스트 값을 사용할 수 있습니다.
 
 ```bash
-npx --yes opensocrates@1.1.4 status --host all
-npx --yes opensocrates@1.1.4 update --host all
-npx --yes opensocrates@1.1.4 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`에는 선택 채널, 설치된 호스트,
@@ -105,9 +106,9 @@ npx --yes opensocrates@1.1.4 remove --host all
 기존 사용자와의 호환성을 위해 기본 호스트는 계속 Codex입니다.
 
 ```bash
-npx --yes opensocrates@1.1.4 install
-# 같은 명령: npx --yes opensocrates@1.1.4 install --host codex
-npx --yes opensocrates@1.1.4 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` 라이프사이클은 그대로 지원합니다. 호스트별
@@ -124,9 +125,9 @@ Claude 상태는 활성 설치와 설치됐지만 비활성화된 플러그인
 ### 선택형 자동 업데이트
 
 ```bash
-npx --yes opensocrates@1.1.4 auto-update enable --host all
-npx --yes opensocrates@1.1.4 auto-update status
-npx --yes opensocrates@1.1.4 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는
@@ -148,7 +149,7 @@ LaunchAgent를 언로드하고 삭제하며, `remove --host all`도 관리 호
 ### Claude 웹 및 Desktop Chat 스킬
 
 이 화면들은 플러그인 스킬은 지원하지만 훅은 실행하지 않습니다. 릴리스에서
-`opensocrates-1.1.4-claude-chat-skills.zip`을 내려받아 Claude의 **사용자 지정 →
+`opensocrates-1.1.5-claude-chat-skills.zip`을 내려받아 Claude의 **사용자 지정 →
 스킬 → 스킬 업로드** 화면에서 업로드하세요. ZIP은 업로더 요구사항에 맞춰
 최상위 `opensocrates/` 폴더 바로 아래에 `SKILL.md`를 둡니다. 패키지는
 `/opensocrates` 스킬 하나만 노출하고, 48개
@@ -162,21 +163,21 @@ LaunchAgent를 언로드하고 삭제하며, `remove --host all`도 관리 호
 npm 레지스트리를 거치지 않을 때도 같은 호스트 옵션을 사용합니다.
 
 ```bash
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.4 install --host all
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.4 install --host claude
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.4 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.4 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.4)에서
+[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.4-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.4-claude-plugin.zip \
-  --checksum opensocrates-1.1.4-claude-plugin.zip.sha256
+  --asset opensocrates-1.1.5-claude-plugin.zip \
+  --checksum opensocrates-1.1.5-claude-plugin.zip.sha256
 ```
 
 Codex 패키지는 `claude`를 `codex`로 바꾸면 됩니다.
@@ -191,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.4 install --host claude
+npx --yes opensocrates@1.1.5 install --host claude
 ```
 
 관리형 v1.1.0 Claude 설치를 업데이트하면 패키지 트리 전체가 교체됩니다. 따라서
@@ -206,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`로 반복 보정을
@@ -294,6 +308,13 @@ Claude 셀렉터 시도는 `executable_missing`, `request_rejected`, `spawn_fail
 표시합니다. 다음 유효한 셀렉터 결과가 현재 스키마의 손상된 집계를 새로운 제한된
 카운트 문서로 교체하며, 알 수 없는 미래 스키마는 해당 새 런타임을 위해 보존합니다.
 
+패키지의 `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.4` 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,17 +27,18 @@ 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.4](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.4).**
-> It adds a Cowork-uploadable native Claude package, host-split runtimes, and
-> content-free selector diagnostics that distinguish unavailable data from zero.
+> **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.4 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 | 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) |
@@ -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.
@@ -84,7 +86,7 @@ before registering an owner-marked managed marketplace.
 ### Install every ready host
 
 ```bash
-npx --yes opensocrates@1.1.4 install --host all
+npx --yes opensocrates@1.1.5 install --host all
 ```
 
 The all-host path detects supported, authenticated host CLIs, completes every
@@ -96,9 +98,9 @@ registration.
 Use the same host value for the complete lifecycle:
 
 ```bash
-npx --yes opensocrates@1.1.4 status --host all
-npx --yes opensocrates@1.1.4 update --host all
-npx --yes opensocrates@1.1.4 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
@@ -111,9 +113,9 @@ automatic update, and per-host drift.
 Codex remains the default host for backward compatibility:
 
 ```bash
-npx --yes opensocrates@1.1.4 install
-# Equivalent: npx --yes opensocrates@1.1.4 install --host codex
-npx --yes opensocrates@1.1.4 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
@@ -133,9 +135,9 @@ commands. The privacy-safe 2.1.226 fixture is under
 ### Opt-in automatic updates
 
 ```bash
-npx --yes opensocrates@1.1.4 auto-update enable --host all
-npx --yes opensocrates@1.1.4 auto-update status
-npx --yes opensocrates@1.1.4 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
@@ -158,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.4-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
@@ -172,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.4 install --host all
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.4 install --host claude
-npx --yes github:ParkerHwang/OpenSocrates#v1.1.4 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.4 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.4).
+[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.4-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.4-claude-plugin.zip \
-  --checksum opensocrates-1.1.4-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.
@@ -202,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.4 install --host claude
+npx --yes opensocrates@1.1.5 install --host claude
 ```
 
 Updating a managed v1.1.0 Claude installation replaces the complete package
@@ -218,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
@@ -313,6 +329,14 @@ 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

package/VERSION

@@ -1 +1 @@
-1.1.4
+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.4";
+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.4",
+  "version": "1.1.5",
   "description": "Install and manage OpenSocrates for Claude Code, Cowork, and Codex.",
   "type": "module",
   "bin": {