opensocrates 1.1.5 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,131 @@ All notable changes to OpenSocrates are documented here. This project follows
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [1.2.1] - 2026-08-16
9
+
10
+ ### Added
11
+
12
+ - A committed v1.2 adjudication snapshot records 51 EN/KO semantic pairs,
13
+ 49 resolved disagreements, strict Draft 2020-12 schemas, aggregate counts,
14
+ and hashes. Its clean-clone validator and mutation suite check only public
15
+ repository artifacts; maintainer-held packet, reviewer, and raw-result
16
+ evidence remains explicitly unavailable in public mode.
17
+ - `remove --host <host|all> --purge` provides an explicit, idempotent
18
+ complete-uninstall attempt for exact OpenSocrates registrations, verified
19
+ host cache payloads, empty Claude plugin-data directories, OpenCode-owned
20
+ files, the updater, transaction residue, and final installer state.
21
+ - `remove --host <codex|all> --purge --reset-trust` explicitly resets only the
22
+ seven canonical OpenSocrates Codex hook approvals after validating a narrow,
23
+ transactional config update.
24
+ - A same-machine reinstall acceptance workflow binds the candidate commit,
25
+ native artifacts, packed npm installer, purge and reinstall lifecycle,
26
+ manual observations, privacy-safe result bundle, and guarded cleanup without
27
+ presenting the machine as clean-machine evidence.
28
+
29
+ ### Changed
30
+
31
+ - All six generated host packages now carry the same bilingual, three-question
32
+ teacher overlay while preserving their real delivery models: hidden trusted
33
+ hook context for Claude/Codex, explicit content reads for Antigravity/Cursor,
34
+ native skill content for Grok Build, and one question-led compiled procedure
35
+ with the same native fallback for OpenCode.
36
+ - Hook budget fallback now drops teacher questions before binding guardrails,
37
+ instruction artifact schema `/3` reads in-flight `/2` headers with an empty
38
+ question default, and empty or malformed question data no longer refers to
39
+ absent questions.
40
+ - The teacher-question source now has a generated canonical schema and explicit
41
+ overlay identity checks without changing authored per-method content revision
42
+ `1`.
43
+ - Ordinary `remove` now states its narrower registration/managed-root contract,
44
+ reports known remaining OpenSocrates paths, and points to the purge command
45
+ instead of implying that every installed payload was removed.
46
+ - Installer help and English/Korean removal docs now distinguish plugin
47
+ registration, owned payloads, host security trust, and preserved user history.
48
+ - Claude Code, Desktop Local, and Cowork plugin documentation now uses the
49
+ canonical `/opensocrates:opensocrates` namespace, while the separately
50
+ rendered Claude Chat standalone skill keeps `/opensocrates`. Release checks
51
+ reject either command when it appears in the wrong artifact.
52
+ - Claude evidence now keeps the installer-managed local plugin, a manually
53
+ uploaded standalone Chat ZIP, and the pre-existing synced/custom skill as
54
+ separate provenance states. The historical v1.1.2 live receipt remains
55
+ historical, while current-version checks require a version-bound receipt.
56
+ - Codex SessionStart timing evidence now measures `startup` and `compact`
57
+ independently and requires both source sets to pass before release or
58
+ reinstall acceptance can report the timing budget as verified.
59
+ - The exact public v1.2.1 Chat ZIP, checksum, and release commit were unavailable
60
+ at the 2026-08-15 provenance audit. The current Chat receipt and EN/KO
61
+ documentation therefore keep live upload pending instead of inheriting the
62
+ v1.1.2 validation claim.
63
+
64
+ ### Security and privacy
65
+
66
+ - Release-package checks reject evaluation or adjudication paths in every host
67
+ and Claude Chat ZIP. The npm package remains restricted to the installer and
68
+ its public release documents, so source evaluation artifacts do not ship.
69
+ - Purge verifies canonical non-symlink paths, exact package identity,
70
+ manifests, checksums, and ownership markers; live `.in_use` payloads,
71
+ unverified registration, unknown data, and cleanup failures remain pending.
72
+ Unrelated host configuration and user history are preserved. Codex hook trust
73
+ remains preserved unless the explicit reset flag is supplied.
74
+ - The trust reset refuses symlinks, hard links, noncanonical or unexpected
75
+ matching sections, invalid configs, concurrent changes, and failed Codex
76
+ consumption checks. It preserves non-target bytes and restores the exact
77
+ original when rollback remains safe; a later external edit is never
78
+ overwritten.
79
+ - Chat evidence stores only release/archive identity, counts, versions,
80
+ pass/fail booleans, and categorical provenance/routing states. The missing
81
+ exact release artifact at audit time prevented a UI upload attempt, so no
82
+ authentication, 2FA, user-confirmation, prompt, conversation, account, path,
83
+ raw UI, upload content, or credential boundary was crossed.
84
+
85
+ ## [1.2.0] - 2026-08-13
86
+
87
+ ### Added
88
+
89
+ - Experimental Google Antigravity integration as a content-only global plugin
90
+ with one explicit `opensocrates` skill, 48 internal authored procedures,
91
+ isolated lifecycle ownership, and an `agy 1.0.6` package-validation receipt.
92
+ It deliberately ships no hooks, runtime, background process, or automatic
93
+ selector.
94
+ - Experimental Cursor Agent Plugin integration with one `/opensocrates` skill,
95
+ 48 internal authored procedures, isolated lifecycle ownership, and
96
+ release-gate package validation. It adds no OpenSocrates selector or hook,
97
+ and no live Cursor invocation receipt is claimed.
98
+ - Grok Build is a first-class `grok` installer host with one native,
99
+ auto-selectable `/opensocrates` skill, 48 internal authored procedures,
100
+ deterministic content-only packaging, capability reporting, isolated
101
+ lifecycle ownership, release-gate coverage, and English/Korean support
102
+ documentation. Live Grok Build 1.0.3 evidence bounds automatic activation,
103
+ explicit invocation, hook behavior, and remaining TUI/subagent limitations.
104
+ - First-class OpenCode 1.18.18+ integration using the stable `chat.message`
105
+ hook for live-validated same-turn local activation and a native
106
+ `opensocrates` Agent Skill fallback.
107
+ - Provider-neutral, dependency-free OpenCode bridge with bounded input,
108
+ duplicate prevention, and exception fail-open behavior. A live
109
+ DeepSeek V4 Flash smoke test is recorded without embedding provider settings.
110
+ - OpenCode install, status, verify, update, remove, rollback, automatic-update,
111
+ and `--host all` lifecycle support with exact-path ownership and complete
112
+ installed inventory verification.
113
+ - Deterministic OpenCode package generation, release-gate validation,
114
+ capability reporting, privacy-safe compatibility evidence, and English and
115
+ Korean support documentation.
116
+
117
+ ### Fixed
118
+
119
+ - Pre-release and offline `--host all` transactions now treat supplied
120
+ host-qualified asset pairs as the exact host set. Candidate packages are no
121
+ longer mixed with public-release downloads merely because another supported
122
+ host CLI is available on the machine.
123
+
124
+ ### Security and privacy
125
+
126
+ - The OpenCode installer never rewrites `opencode.json`; it refuses unowned,
127
+ partial, symbolic-link, and unsafe exact paths while preserving unrelated
128
+ plugins, skills, and configuration.
129
+ - The OpenCode bridge makes no network, subprocess, recursive OpenCode, extra
130
+ model, telemetry, or credential access and preserves the complete-procedure
131
+ grounding requirement.
132
+
8
133
  ## [1.1.5] - 2026-08-12
9
134
 
10
135
  ### Added
@@ -340,3 +465,5 @@ All notable changes to OpenSocrates are documented here. This project follows
340
465
  [1.1.3]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.2...v1.1.3
341
466
  [1.1.4]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.3...v1.1.4
342
467
  [1.1.5]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.4...v1.1.5
468
+ [1.2.0]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.5...v1.2.0
469
+ [1.2.1]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.2.0...v1.2.1
package/README.ko.md CHANGED
@@ -11,13 +11,15 @@
11
11
  [![Release](https://img.shields.io/github/v/release/ParkerHwang/OpenSocrates)](https://github.com/ParkerHwang/OpenSocrates/releases)
12
12
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
13
13
 
14
- OpenSocrates는 Claude와 Codex를 위한 로컬 연동 및 저작 추론 프레임워크입니다.
15
- 의도적인 추론이 필요한 요청을 감지하고, 현재 호스트의 새로운 셀렉터에서 적합한
16
- 추론 시스템을 고른 뒤, 이론과 예제 전체를 활성 작업에 추가합니다. 단순한 사실
17
- 확인과 기계적인 작업은 그대로 통과할 수 있습니다.
18
-
19
- 버전 `1.1.5`에는 48개의 추론 시스템, Claude의 단일 사용자 진입점, 선택된 절차를
20
- 실제로 읽었는지 확인하는 Claude 접지 게이트, Claude/Codex 통합 라이프사이클,
14
+ OpenSocrates는 Google Antigravity, Claude, Codex, Cursor, Grok Build,
15
+ OpenCode를 위한 로컬 연동 및 저작 추론 프레임워크입니다. 호스트별 전달 모델을
16
+ 그대로 지킵니다. Claude/Codex의 숨은 신뢰 컨텍스트는 스승 질문으로 시작하고,
17
+ Antigravity/Cursor/Grok은 질문 우선 전체 절차를 스킬 콘텐츠로 제공하며, OpenCode는
18
+ 같은 절차 하나를 같은 턴에 삽입하고 네이티브 스킬을 폴백으로 사용합니다. 단순한
19
+ 사실 확인과 기계적인 작업은 그대로 통과할 수 있습니다.
20
+
21
+ 버전 `1.2.0`에는 48개의 추론 시스템과 OpenCode의 안정판 같은 턴 자동 활성화,
22
+ 네이티브 스킬 폴백, 6개 호스트 통합 라이프사이클,
21
23
  선택형 자동 업데이트가 들어 있습니다. 현재 릴리스 플랫폼은 Apple Silicon
22
24
  macOS(`darwin-arm64`)입니다. 기존 호스트 로그인을 사용하므로 API 키나
23
25
  OpenSocrates 백엔드가 필요하지 않습니다.
@@ -26,21 +28,27 @@ OpenSocrates 백엔드가 필요하지 않습니다.
26
28
  런처는 `darwin-arm64`만 허용하며, Intel Mac·Linux·Windows용 런처와 런타임은
27
29
  이번 릴리스에 포함되거나 지원되지 않습니다.
28
30
 
29
- > **최신 릴리스: [OpenSocrates 1.1.5](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.5).**
30
- > Claude 접지 파일을 추가 디렉터리 권한 없이 읽을 수 있게 하고, `diagnose`에서
31
- > 설치 패키지를 실제로 검증하며, Codex의 최초 훅 승인 경계를 명확히 했습니다.
32
- > `npx --yes opensocrates@1.1.5 update --host all`로 관리 중인 두 호스트를 함께
33
- > 업데이트할 수 있습니다.
31
+ > **현재 릴리스: OpenSocrates 1.2.1.** mutation 검사를 거친 공개 v1.2
32
+ > adjudication 스냅샷과 한영 세 질문 스승 오버레이를 여섯 호스트 패키지에
33
+ > 추가했습니다. 또한 안전한 완전 제거와 Codex 신뢰 초기화, 더 엄격한 Claude
34
+ > provenance 경계, 동일 머신 재설치 acceptance, source별 Codex SessionStart
35
+ > 타이밍 근거를 제공합니다. 별도의 Claude Chat v1.2.1 실제 업로드 영수증은 아직
36
+ > 대기 중입니다.
34
37
 
35
38
  ## 호스트 지원 범위
36
39
 
37
40
  | 호스트 화면 | 자동 선택 | 사용자 진입점 | 검증 상태 |
38
41
  | --- | --- | --- | --- |
42
+ | Google Antigravity CLI | 명시적 스킬만 지원 | `opensocrates` 스킬 | [실험적 콘텐츠 전용 플러그인](docs/antigravity-support.md) |
43
+ | Cursor IDE 및 CLI | 별도 셀렉터 없이 스킬 탐색 | `/opensocrates` | [실험적 콘텐츠 전용 Agent Plugin, 라이브 영수증 없음](docs/cursor-support.md) |
44
+ | Grok Build `grok -p` | 네이티브 스킬로 같은 턴에 지원 | `/opensocrates` | [Grok Build 1.0.3 자동·명시적 네이티브 스킬 검증 완료](docs/grok-support.md) |
45
+ | Grok Build TUI | 헤드리스와 같은 네이티브 플러그인, 활성화 영수증은 대기 중 | `/opensocrates` | [TUI 훅 실행 검증 완료, 네이티브 스킬 마커 테스트는 미완료, 배포 패키지에 훅 없음](docs/grok-support.md) |
46
+ | OpenCode TUI 및 `opencode run` | 안정판 같은 턴 로컬 브리지 | 네이티브 `opensocrates` 스킬 | [OpenCode 1.18.18 TUI, `opencode run` 및 DeepSeek V4 Flash 라이브 스모크 완료](docs/opencode-support.ko.md) |
39
47
  | Codex CLI 및 Desktop | 앱에서 훅을 한 번 승인한 뒤 지원 | OpenSocrates 플러그인 | `darwin-arm64` 패키지·런처 릴리스 검증 완료, 실제 Codex 훅 전달 영수증 없음 |
40
- | Claude Code CLI | `UserPromptSubmit` 훅으로 지원 | `/opensocrates` | `darwin-arm64` 로컬 검증 완료 |
41
- | Claude Code 데스크톱 앱 | Claude Code 플러그인이 실행되는 곳에서 지원 | `/opensocrates` | [인증된 훅 생명주기 로컬 검증 완료](docs/claude-desktop-live-probe.md) |
42
- | Claude Cowork | 실측 로컬 플러그인 업로드에서 지원 | `/opensocrates` | [네이티브 훅 생명주기 로컬 검증 완료, 릴리스 직접 업로드 지원, 마켓플레이스 동기화 없음](docs/claude-cowork-live-probe.md) |
43
- | Claude 웹 및 Desktop Chat | 훅 미지원 | `/opensocrates` | [실제 업로드 및 호출 검증 완료](docs/claude-chat-upload-probe.md) |
48
+ | Claude Code CLI | `UserPromptSubmit` 훅으로 지원 | 플러그인: `/opensocrates:opensocrates` | `darwin-arm64` 로컬 검증 완료 |
49
+ | Claude Code 데스크톱 앱 Local 모드 | Claude Code 플러그인이 실행되는 곳에서 지원 | 플러그인: `/opensocrates:opensocrates` | [인증된 훅 생명주기 로컬 검증 완료](docs/claude-desktop-live-probe.md) |
50
+ | 로컬 플러그인을 사용하는 Claude Cowork | 실측 로컬 플러그인 업로드에서 지원 | 플러그인: `/opensocrates:opensocrates` | [네이티브 훅 생명주기 로컬 검증 완료, 릴리스 직접 업로드 지원, 마켓플레이스 동기화 없음](docs/claude-cowork-live-probe.md) |
51
+ | Claude 웹 및 Desktop Chat | OpenSocrates 훅 미지원 | 독립형 스킬: `/opensocrates` | [v1.1.2 업로드만 과거 검증 완료, 정확한 v1.2.1 릴리스와 실제 업로드는 대기 중](docs/claude-chat-upload-probe.md) |
44
52
 
45
53
  상태 열은 서로 다른 네 단계를 뜻하며 같은 의미로 읽으면 안 됩니다.
46
54
 
@@ -53,10 +61,22 @@ OpenSocrates 백엔드가 필요하지 않습니다.
53
61
  전달했다는 기록이 없습니다. `os capabilities show`는 이 항목들을 사용 가능이
54
62
  아니라 `unknown`으로 보고합니다.
55
63
 
56
- Claude Chat 화면은 플러그인 훅을 실행하지 않습니다. 생성된 스킬은 사용할 수
57
- 있지만, 프롬프트마다 자동으로 선택하는 기능은 플러그인 런타임을 실행하는 Claude
58
- Code와 Cowork 화면에서만 작동합니다. 훅이나 셀렉터를 사용할 수 없으면
59
- OpenSocrates는 작업을 막지 않고 통과합니다.
64
+ Anthropic의
65
+ [플러그인 namespace 계약](https://code.claude.com/docs/en/plugins)에 따라 Claude
66
+ 플러그인의 canonical 명시적 명령은 `/opensocrates:opensocrates`입니다. 현재 Claude
67
+ 버전은 같은 이름을 차지한 다른 명령이 없을 때 `/opensocrates` bare alias도 제공할
68
+ 수 있지만, 이 alias는 canonical 플러그인 계약이 아니며 어느 스킬 source가
69
+ 응답했는지 증명하지도 않습니다. 별도로 업로드하는 Chat ZIP은 독립형 스킬이므로
70
+ canonical 명령으로 `/opensocrates`를 사용합니다. Chat 화면은 패키지된 OpenSocrates
71
+ 훅을 실행하지 않으며, 프롬프트마다 자동으로 선택하는 기능은 플러그인 런타임을
72
+ 실행하는 Claude Code와 Cowork 화면에서만 작동합니다. 훅이나 셀렉터를 사용할 수
73
+ 없으면 OpenSocrates는 작업을 막지 않고 통과합니다.
74
+
75
+ Claude provenance 세 가지를 분리해서 보세요. installer가 관리하는 로컬 플러그인,
76
+ Chat에 수동 업로드하는 standalone ZIP, 기존 synced/custom skill은 서로 다른
77
+ 근거입니다. 로컬 플러그인 status는 두 Cloud 상태를 증명하거나 갱신할 수 없습니다.
78
+ 현재 기록된 로컬 플러그인 버전은 1.2.1이고 기존 synced/custom 관측은 1.1.2이지만,
79
+ 둘 다 정확한 v1.2.1 standalone 릴리스 ZIP을 업로드했다는 증거가 아닙니다.
60
80
 
61
81
  공개된 v1.1.2 Claude 플러그인 아카이브는 Cowork의 문서화된 압축 크기 제한과
62
82
  실측 압축 해제 크기 제한을 모두 초과했습니다. 출시 전 v1.1.3 후보는 압축
@@ -70,8 +90,12 @@ receipt, Stop, 정리 생명주기도 로컬 검증을 마쳤습니다. 버전 1
70
90
 
71
91
  설치 전에 호스트에 로그인하고 명령을 사용할 수 있는지 확인하세요.
72
92
 
93
+ - Antigravity: `agy 1.0.0` 이상, 명시적 스킬 전용 지원
94
+ - Cursor: Cursor `2.5.0` 이상, 명시적 스킬 우선 지원
73
95
  - Claude: Claude Code `2.1.205` 이상과 `claude` 명령
74
96
  - Codex: OAuth 로그인이 완료된 `codex` 명령
97
+ - Grok Build: `grok 1.0.3` 이상과 기존 Grok 인증(API 키 추가 불필요)
98
+ - OpenCode: OpenCode `1.18.18` 이상, 설정된 공급자/모델 제한 없음
75
99
 
76
100
  Node.js 20 이상이 필요합니다. npm에 게시된 `opensocrates` 패키지는 외부
77
101
  의존성이 없는 작은 설치 프로그램입니다. GitHub Releases에서 호스트 패키지를
@@ -81,22 +105,81 @@ Node.js 20 이상이 필요합니다. npm에 게시된 `opensocrates` 패키지
81
105
  ### 준비된 모든 호스트에 설치
82
106
 
83
107
  ```bash
84
- npx --yes opensocrates@1.1.5 install --host all
108
+ npx --yes opensocrates@1.2.1 install --host all
85
109
  ```
86
110
 
87
111
  모든 호스트 경로는 지원되는 인증 완료 CLI를 찾고, 어느 호스트도 바꾸기 전에
88
- 전체 사전점검을 끝냅니다. 두 패키지를 모두 검증·스테이징한 다음 한 릴리스를
112
+ 전체 사전점검을 끝냅니다. 선택된 패키지를 모두 검증·스테이징한 다음 한 릴리스를
89
113
  트랜잭션으로 활성화합니다. 한 호스트의 활성화가 실패하면 이번 트랜잭션에서 이미
90
114
  바뀐 호스트도 이전 관리형 등록으로 되돌립니다.
91
115
 
92
116
  전체 라이프사이클에서 같은 호스트 값을 사용할 수 있습니다.
93
117
 
94
118
  ```bash
95
- npx --yes opensocrates@1.1.5 status --host all
96
- npx --yes opensocrates@1.1.5 update --host all
97
- npx --yes opensocrates@1.1.5 remove --host all
119
+ npx --yes opensocrates@1.2.1 status --host all
120
+ npx --yes opensocrates@1.2.1 update --host all
121
+ npx --yes opensocrates@1.2.1 remove --host all
122
+ ```
123
+
124
+ ### 등록 제거, 소유 payload purge, Codex 신뢰 초기화
125
+
126
+ 일반 `remove`는 기존과 호환되는 좁은 계약을 유지합니다. 선택한 정확한 호스트 등록과
127
+ 설치 프로그램 관리 루트를 제거하고 업데이터를 조정하지만, 호스트가 소유한
128
+ OpenSocrates 플러그인 캐시와 설치 프로그램 desired-state 파일은 남을 수 있습니다.
129
+ 출력은 남은 것으로 확인된 OpenSocrates 경로와 다음 purge 명령을 표시하며, 이 결과를
130
+ 완전 제거라고 설명하지 않습니다.
131
+
132
+ 활성 호스트를 닫은 뒤 명시적인 소유 payload purge를 실행하세요.
133
+
134
+ ```bash
135
+ npx --yes opensocrates@1.2.1 remove --host all --purge
136
+ # 호스트 하나: npx --yes opensocrates@1.2.1 remove --host claude --purge
137
+ # OpenSocrates Codex 훅 신뢰만 함께 초기화:
138
+ npx --yes opensocrates@1.2.1 remove --host all --purge --reset-trust
139
+ # Codex만: npx --yes opensocrates@1.2.1 remove --host codex --purge --reset-trust
98
140
  ```
99
141
 
142
+ Purge는 항목을 삭제하기 전에 canonical 경로, 정확한
143
+ `opensocrates@opensocrates` 패키지 ID, 매니페스트, 체크섬, 설치 프로그램 소유권
144
+ 표식을 확인합니다. 관리 루트, 정확한 Claude/Codex 캐시 버전, 비어 있는 Claude
145
+ OpenSocrates 플러그인 data 디렉터리, OpenCode 소유 스킬·브리지·사이드카,
146
+ OpenSocrates LaunchAgent, 알려진 트랜잭션 잔여물, 그리고 lifecycle lock 해제 뒤의
147
+ 알려진 최종 설치 프로그램 상태 파일과 빈 상태 디렉터리를 대상으로 합니다.
148
+ `~/.claude/plugins`, `~/.codex/plugins`, `~/.opensocrates` 같은 넓은 상위 경로를
149
+ 재귀 삭제하지 않습니다.
150
+
151
+ 살아 있는 `.in_use/<pid>`가 있는 Claude 캐시, 등록 확인을 막는 누락된 호스트 CLI,
152
+ symlink, 잘못된 소유권 표식이나 매니페스트, 비어 있지 않아 소유권을 증명할 수 없는
153
+ 플러그인 data, 정리·권한 실패가 있으면 결과를 `pending` 또는 실패로 보고하고 명령도
154
+ 실패 종료합니다. 호스트를 닫거나 보고된 경로를 해결한 뒤 같은 purge를 다시
155
+ 실행하세요. 완료된 purge는 여러 번 실행해도 같은 결과를 냅니다. 다른 플러그인과
156
+ 사용자 task·project·chat·plan·history 데이터는 byte-for-byte 보존합니다.
157
+
158
+ 제거 대상 네 가지는 서로 분리됩니다.
159
+
160
+ - **플러그인 등록:** 일반 remove와 purge는 선택한 호스트에 정확한
161
+ `opensocrates@opensocrates` 등록만 제거하도록 요청합니다.
162
+ - **Payload와 설치 프로그램 상태:** `--purge`는 소유권을 검증한 뒤 위에서 설명한
163
+ 정확한 cache/data/관리 상태 경로만 제거합니다.
164
+ - **호스트 보안 신뢰:** Codex 훅 승인은 payload가 아닙니다. 기본 purge는 신뢰를
165
+ 보존하고 그 사실을 보고합니다. `--host codex` 또는 `--host all`에서
166
+ `--reset-trust`를 명시해야 정확한 OpenSocrates 훅 승인 7개만 초기화합니다.
167
+ - **사용자 기록:** task, project, chat, plan, session, history 내용은 제거 대상이
168
+ 아니며 항상 byte-for-byte 보존됩니다.
169
+
170
+ Codex CLI 0.145.0에는 범위가 좁은 공식 신뢰 제거 명령이 없습니다. 따라서 이 opt-in
171
+ fallback은 정확한 `CODEX_HOME/config.toml`만 대상으로 합니다. 해시를 하드코딩하거나
172
+ 출력하지 않고 `pre_tool_use`, `post_tool_use`, `pre_compact`, `session_start`,
173
+ `session_end`, `user_prompt_submit`, `stop`에 해당하는 canonical OpenSocrates section만
174
+ 제거합니다. 다른 설정과 플러그인, 주석, 순서, 공백, LF/CRLF 형식은 보존합니다.
175
+ symlink, canonical이 아닌 일치 section, 예상 밖 key, 잘못된 config, 지원되지 않는
176
+ Codex validator, 동시 변경, 쓰기·검증 실패가 있으면 purge는 partial입니다. 원본
177
+ config를 유지하거나 안전하게 rollback할 수 있을 때 트랜잭션으로 복원합니다. 뒤이은
178
+ 외부 편집 때문에 자동 rollback이 안전하지 않으면 그 편집을 덮어쓰지 않고 소유자
179
+ 전용 복구 사본을 보존합니다. 완료를 주장하지 않습니다. 재설치하면 이 7개 훅이 새
180
+ 승인 대상으로 표시될 것으로 예상되지만, 실제 승인 흐름은 별도 host evidence가
181
+ 필요합니다.
182
+
100
183
  소유자 전용 `~/.opensocrates/desired-state.json`에는 선택 채널, 설치된 호스트,
101
184
  원하는 활성 버전이 기록됩니다. `status --host all`은 원하는 버전과 사용 가능한
102
185
  버전, 마지막 확인, 마지막 성공 자동 업데이트, 호스트별 버전 차이를 보여 줍니다.
@@ -106,15 +189,31 @@ npx --yes opensocrates@1.1.5 remove --host all
106
189
  기존 사용자와의 호환성을 위해 기본 호스트는 계속 Codex입니다.
107
190
 
108
191
  ```bash
109
- npx --yes opensocrates@1.1.5 install
110
- # 같은 명령: npx --yes opensocrates@1.1.5 install --host codex
111
- npx --yes opensocrates@1.1.5 install --host claude
192
+ npx --yes opensocrates@1.2.1 install
193
+ # 같은 명령: npx --yes opensocrates@1.2.1 install --host codex
194
+ npx --yes opensocrates@1.2.1 install --host claude
195
+ npx --yes opensocrates@1.2.1 install --host antigravity
196
+ npx --yes opensocrates@1.2.1 install --host cursor
197
+ npx --yes opensocrates@1.2.1 install --host grok
198
+ npx --yes opensocrates@1.2.1 install --host opencode
112
199
  ```
113
200
 
201
+ Grok Build는 `~/.grok/plugins/opensocrates`에 네이티브 콘텐츠 전용 플러그인을
202
+ 설치합니다. 자동 선택과 명시적 호출이 가능한 `/opensocrates` 스킬 하나와 내부
203
+ 절차 48개만 포함하며, 훅·명령·에이전트·MCP 서버·런처·런타임·중첩 셀렉터 호출은
204
+ 포함하지 않습니다. 설치 프로그램은 Grok의 기계 판독 상태를 확인하지만 이 정확한
205
+ 디렉터리만 소유하며 Claude 설치를 변경하거나 삭제하지 않습니다. 자세한 내용은
206
+ [Grok Build 지원 경계](docs/grok-support.md)를 참고하세요.
207
+
114
208
  기존 `--host codex` 및 `--host claude` 라이프사이클은 그대로 지원합니다. 호스트별
115
209
  업데이트는 의도적으로 버전 차이를 만들 수 있고, 이후 `update --host all` 또는
116
210
  성공한 자동 조정이 desired state에 기록된 모든 호스트를 다시 한 버전으로 맞춥니다.
117
211
 
212
+ OpenCode 설치는 `~/.config/opencode` 아래의 `plugins/opensocrates.js`, 소유권
213
+ 사이드카, `skills/opensocrates/`만 소유합니다. `opencode.json`이나 관계없는
214
+ 플러그인·스킬은 수정하지 않습니다. 자세한 경계는
215
+ [OpenCode 지원 문서](docs/opencode-support.ko.md)를 참고하세요.
216
+
118
217
  Claude 상태는 활성 설치와 설치됐지만 비활성화된 플러그인을 구분합니다. 원하는
119
218
  설치가 비활성 상태라면 drift로 보고합니다. `install` 또는 `update`를 실행하면 검증된
120
219
  패키지를 의도적으로 다시 활성화하며, 활성화가 실패하면 롤백이 이전의 활성·비활성
@@ -125,9 +224,9 @@ Claude 상태는 활성 설치와 설치됐지만 비활성화된 플러그인
125
224
  ### 선택형 자동 업데이트
126
225
 
127
226
  ```bash
128
- npx --yes opensocrates@1.1.5 auto-update enable --host all
129
- npx --yes opensocrates@1.1.5 auto-update status
130
- npx --yes opensocrates@1.1.5 auto-update disable
227
+ npx --yes opensocrates@1.2.1 auto-update enable --host all
228
+ npx --yes opensocrates@1.2.1 auto-update status
229
+ npx --yes opensocrates@1.2.1 auto-update disable
131
230
  ```
132
231
 
133
232
  자동 업데이트는 명시적으로 켜기 전까지 비활성화되어 있습니다. macOS LaunchAgent는
@@ -148,39 +247,55 @@ LaunchAgent를 언로드하고 삭제하며, `remove --host all`도 관리 호
148
247
 
149
248
  ### Claude 웹 및 Desktop Chat 스킬
150
249
 
151
- 이 화면들은 플러그인 스킬은 지원하지만 훅은 실행하지 않습니다. 릴리스에서
152
- `opensocrates-1.1.5-claude-chat-skills.zip`을 내려받아 Claude의 **사용자 지정 →
153
- 스킬 → 스킬 업로드** 화면에서 업로드하세요. ZIP은 업로더 요구사항에 맞춰
154
- 최상위 `opensocrates/` 폴더 바로 아래에 `SKILL.md`를 둡니다. 패키지는
155
- `/opensocrates` 스킬 하나만 노출하고, 48개
156
- 방법 절차와 엄격도·근거·추적 제어는 내부 참조로 둡니다. Chat은 플러그인 훅을
157
- 실행하지 않으므로 자동 선택은 없습니다. Anthropic의
158
- [플러그인 화면 안내](https://support.claude.com/en/articles/13837440-use-plugins-in-claude)를
250
+ 이 화면들은 별도로 업로드한 독립형 스킬을 사용할 수 있지만 로컬 플러그인 훅은
251
+ 실행하지 않습니다.
252
+
253
+ 정확한 v1.2.1 Chat 릴리스 아티팩트: **사용 불가, 실제 업로드 대기 중.**
254
+
255
+ 2026-08-15 검사 시점에 GitHub에는 공개 `v1.2.1` 태그나 릴리스가 없습니다. 따라서
256
+ `opensocrates-1.2.1-claude-chat-skills.zip`, checksum, release commit을 검증하거나
257
+ 업로드할 수 없습니다. source에서 만든 candidate나 Claude Code/Cowork 플러그인
258
+ archive로 대체하지 마세요. 기존 v1.1.2 실제 영수증은 과거 근거일 뿐이며 기존
259
+ synced/custom skill은 변경하지 않았습니다. [버전에 묶인 근거와 상태 전환
260
+ 조건](docs/claude-chat-upload-probe.md)을 확인하세요.
261
+
262
+ 정확한 릴리스가 공개되면 checksum을 먼저 검증한 뒤 Claude의 **사용자 지정 → 스킬
263
+ → 스킬 업로드** 화면을 사용하세요. ZIP은 업로더 요구사항에 맞춰 최상위
264
+ `opensocrates/` 폴더 바로 아래에 `SKILL.md`를 둬야 합니다. 이 파일은 Claude
265
+ Code/Cowork 플러그인 아카이브가 아닙니다. 독립형 패키지는 canonical
266
+ `/opensocrates` 스킬 하나만 노출하고, 48개 방법 절차와 엄격도·근거·추적 제어는
267
+ 내부 참조로 둡니다. Chat은 패키지된 훅을 실행하지 않으므로 훅 기반 자동 선택은
268
+ 없습니다. Anthropic의
269
+ [사용자 정의 스킬 안내](https://support.claude.com/en/articles/12512180-use-skills-in-claude)를
159
270
  참고하세요.
160
271
 
161
272
  ### 태그가 고정된 GitHub 소스에서 설치
162
273
 
163
- npm 레지스트리를 거치지 않을 때도 같은 호스트 옵션을 사용합니다.
274
+ npm 레지스트리를 거치지 않을 때는 공개된 태그로 같은 호스트 옵션을 사용합니다.
164
275
 
165
276
  ```bash
166
- npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host all
167
- npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host claude
168
- npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host codex
277
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host all
278
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host claude
279
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host codex
280
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host opencode
169
281
  ```
170
282
 
171
283
  ### 릴리스 파일 직접 검증
172
284
 
173
- [v1.1.5 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.5)에서
174
- `opensocrates.mjs`, 호스트 패키지, `.sha256` 파일을 내려받습니다. Claude의 예:
285
+ 공개 뒤에는
286
+ [v1.2.1 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.2.1)에서
287
+ `opensocrates.mjs`, 호스트 패키지, `.sha256` 파일을 내려받습니다. 이 릴리스는
288
+ 2026-08-15 검사 시점에 사용할 수 없습니다. 아래 명령은 모든 이름의 asset이 생긴
289
+ 뒤에만 사용하세요. Claude의 예:
175
290
 
176
291
  ```bash
177
- shasum -a 256 -c opensocrates-1.1.5-claude-plugin.zip.sha256
292
+ shasum -a 256 -c opensocrates-1.2.1-claude-plugin.zip.sha256
178
293
  node opensocrates.mjs install --host claude \
179
- --asset opensocrates-1.1.5-claude-plugin.zip \
180
- --checksum opensocrates-1.1.5-claude-plugin.zip.sha256
294
+ --asset opensocrates-1.2.1-claude-plugin.zip \
295
+ --checksum opensocrates-1.2.1-claude-plugin.zip.sha256
181
296
  ```
182
297
 
183
- Codex 패키지는 `claude`를 `codex`로 바꾸면 됩니다.
298
+ 다른 호스트 패키지는 `claude`를 `antigravity`, `codex`, `cursor`, `opencode`로 바꾸면 됩니다.
184
299
 
185
300
  ### 1.0 이전 Claude 플러그인에서 이전하기
186
301
 
@@ -192,7 +307,7 @@ Codex 패키지는 `claude`를 `codex`로 바꾸면 됩니다.
192
307
  ```bash
193
308
  claude plugin uninstall opensocrates@OpenSocrates --scope user
194
309
  claude plugin marketplace remove OpenSocrates --scope user
195
- npx --yes opensocrates@1.1.5 install --host claude
310
+ npx --yes opensocrates@1.2.1 install --host claude
196
311
  ```
197
312
 
198
313
  관리형 v1.1.0 Claude 설치를 업데이트하면 패키지 트리 전체가 교체됩니다. 따라서
@@ -201,18 +316,30 @@ npx --yes opensocrates@1.1.5 install --host claude
201
316
 
202
317
  ## 사용법
203
318
 
204
- Claude나 Codex를 평소처럼 사용하세요. 요청에 판단, 해석, 진단, 설명, 계획,
205
- 근거 조정 또는 다른 구조적 추론이 필요하면 OpenSocrates가 개입할 수 있습니다.
206
- 개입할 때는 다음과 같이 동작합니다.
319
+ 지원되는 호스트를 평소처럼 사용하세요. 요청에 판단, 해석, 진단, 설명, 계획,
320
+ 근거 조정 또는 다른 구조적 추론이 필요하면 OpenSocrates가 참여할 수 있습니다.
321
+ Claude/Codex 네이티브 런타임 화면에서는 다음과 같이 동작합니다.
207
322
 
208
323
  1. 현재 호스트에서 새로운 비영구 셀렉터를 시작합니다.
209
324
  2. 저작된 48개 시스템 카탈로그에서 적합한 시스템을 선택합니다.
210
325
  3. 선택된 전체 콘텐츠를 소유자 전용 Markdown 파일에 씁니다.
211
- 4. 각 방법 ID와 콘텐츠 리비전, 크기 한도 안에 들면 정확한 `Do not use when` 및
212
- `Stop conditions`를 작은 숨김 컨텍스트에 추가합니다.
326
+ 4. 스스로 정리해야 할 스승 질문을 앞에 두고, 각 방법 ID와 콘텐츠 리비전, 크기
327
+ 한도 안에 들면 정확한 `Do not use when` 및 `Stop conditions`를 작은 숨김
328
+ 컨텍스트에 추가합니다.
213
329
  5. 활성 작업이 방법을 적용하기 전에 전체 파일을 읽고, 접지된 답변의 마지막에
214
330
  `OpenSocrates grounding: triangulation@1`과 같은 정확한 감사 줄을 남기게 합니다.
215
331
 
332
+ OpenCode에서는 의존성 없는 안정판 훅이 로컬에서 방법을 고르고 완전한 저작 절차
333
+ 하나를 같은 메시지 턴에 직접 삽입합니다. 그 컴파일된 절차는 스승 질문 세 개로
334
+ 시작하며, 네이티브 `/opensocrates` 폴백도 중복 머리말 없이 같은 절차를 읽습니다.
335
+ artifact나 추가 모델 호출은 만들지 않습니다.
336
+ [OpenCode 지원 경계](docs/opencode-support.ko.md)를 참고하세요.
337
+
338
+ Antigravity와 Cursor는 명시적 콘텐츠 스킬을 사용하고, Grok Build는 네이티브 스킬
339
+ 선택 또는 `/opensocrates`를 사용합니다. 세 패키지 모두 생성된 전체 절차가 활성
340
+ 에이전트가 스스로 정리할 스승 질문으로 시작합니다. 이는 콘텐츠 전용 동작이며
341
+ OpenSocrates 훅 전달을 주장하지 않습니다.
342
+
216
343
  Codex에 설치한 뒤에는 대화형 Codex 세션을 한 번 열어 OpenSocrates 훅을 승인해야
217
344
  자동 선택을 신뢰할 수 있습니다. 이 승인이 끝나기 전에는 `codex exec` 같은 비대화형
218
345
  화면이 신뢰되지 않은 훅을 조용히 건너뛸 수 있습니다.
@@ -245,14 +372,17 @@ Claude 훅 화면에서는 Read 전용 `PostToolUse` 훅이 현재 turn의 정
245
372
  Claude에서는 필요할 때 같은 컨트롤러를 명시적으로 호출할 수 있습니다.
246
373
 
247
374
  ```text
248
- /opensocrates <요청>
249
- /opensocrates auto <요청>
250
- /opensocrates trace
251
- /opensocrates status
375
+ /opensocrates:opensocrates <요청>
376
+ /opensocrates:opensocrates auto <요청>
377
+ /opensocrates:opensocrates trace
378
+ /opensocrates:opensocrates status
252
379
  ```
253
380
 
254
- Claude의 스킬·명령 UI에는 `/opensocrates` 하나만 나타납니다. 컨트롤러가 내부 방법
255
- 참조를 선택해 읽으므로 사용자가 48개 구현 카탈로그를 직접 탐색할 필요가 없습니다.
381
+ 위 명령은 Claude Code/Cowork 플러그인용입니다. 독립형 Chat ZIP은 대신
382
+ `/opensocrates`를 사용합니다. 플러그인의 등록 명령 inventory에는
383
+ `/opensocrates:opensocrates`가 나타나며, bare alias를 source 증거로 사용하면 안
384
+ 됩니다. 컨트롤러가 내부 방법 참조를 선택해 읽으므로 사용자가 48개 구현
385
+ 카탈로그를 직접 탐색할 필요가 없습니다.
256
386
 
257
387
  Claude 셀렉터는 세션을 저장하지 않는 단일 `claude --safe-mode -p` 프로세스를
258
388
  사용합니다. 안전 모드는 사용자, 프로젝트, 플러그인 커스터마이즈를 끕니다.
@@ -354,6 +484,7 @@ make lint
354
484
  make generated-check
355
485
  make content-check
356
486
  make docs-check
487
+ make governance-check
357
488
  make security-scan
358
489
  make smoke
359
490
  npm test
@@ -367,6 +498,10 @@ make release-check
367
498
  | `content/` | 정책, 다국어 메시지, 추론 방법, 이론과 예제 |
368
499
  | `plugin-src/claude/` | Claude 플러그인 템플릿 |
369
500
  | `plugin-src/codex/` | Codex 플러그인 템플릿 |
501
+ | `plugin-src/antigravity/` | 실험적 Antigravity 콘텐츠 전용 플러그인 템플릿 |
502
+ | `plugin-src/cursor/` | 실험적 Cursor Agent Plugin 템플릿 |
503
+ | `plugin-src/grok/` | Grok Build 네이티브 콘텐츠 전용 플러그인 템플릿 |
504
+ | `plugin-src/opencode/` | OpenCode 안정판 브리지 및 네이티브 스킬 템플릿 |
370
505
  | `schemas/source/` | 정규 스키마 정의 |
371
506
  | `schemas/v1/` | 생성된 버전 고정 공개 스키마 |
372
507
  | `installer/` | 외부 의존성이 없는 Node.js GitHub/npx 설치 프로그램 |