opensocrates 1.1.5 → 1.2.0

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.
Files changed (6) hide show
  1. package/CHANGELOG.md +49 -0
  2. package/README.ko.md +60 -31
  3. package/README.md +78 -34
  4. package/VERSION +1 -1
  5. package/installer/opensocrates.mjs +931 -276
  6. package/package.json +8 -3
package/CHANGELOG.md CHANGED
@@ -5,6 +5,54 @@ All notable changes to OpenSocrates are documented here. This project follows
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [1.2.0] - 2026-08-13
9
+
10
+ ### Added
11
+
12
+ - Experimental Google Antigravity integration as a content-only global plugin
13
+ with one explicit `opensocrates` skill, 48 internal authored procedures,
14
+ isolated lifecycle ownership, and an `agy 1.0.6` package-validation receipt.
15
+ It deliberately ships no hooks, runtime, background process, or automatic
16
+ selector.
17
+ - Experimental Cursor Agent Plugin integration with one `/opensocrates` skill,
18
+ 48 internal authored procedures, isolated lifecycle ownership, and
19
+ release-gate package validation. It adds no OpenSocrates selector or hook,
20
+ and no live Cursor invocation receipt is claimed.
21
+ - Grok Build is a first-class `grok` installer host with one native,
22
+ auto-selectable `/opensocrates` skill, 48 internal authored procedures,
23
+ deterministic content-only packaging, capability reporting, isolated
24
+ lifecycle ownership, release-gate coverage, and English/Korean support
25
+ documentation. Live Grok Build 1.0.3 evidence bounds automatic activation,
26
+ explicit invocation, hook behavior, and remaining TUI/subagent limitations.
27
+ - First-class OpenCode 1.18.18+ integration using the stable `chat.message`
28
+ hook for live-validated same-turn local activation and a native
29
+ `opensocrates` Agent Skill fallback.
30
+ - Provider-neutral, dependency-free OpenCode bridge with bounded input,
31
+ duplicate prevention, and exception fail-open behavior. A live
32
+ DeepSeek V4 Flash smoke test is recorded without embedding provider settings.
33
+ - OpenCode install, status, verify, update, remove, rollback, automatic-update,
34
+ and `--host all` lifecycle support with exact-path ownership and complete
35
+ installed inventory verification.
36
+ - Deterministic OpenCode package generation, release-gate validation,
37
+ capability reporting, privacy-safe compatibility evidence, and English and
38
+ Korean support documentation.
39
+
40
+ ### Fixed
41
+
42
+ - Pre-release and offline `--host all` transactions now treat supplied
43
+ host-qualified asset pairs as the exact host set. Candidate packages are no
44
+ longer mixed with public-release downloads merely because another supported
45
+ host CLI is available on the machine.
46
+
47
+ ### Security and privacy
48
+
49
+ - The OpenCode installer never rewrites `opencode.json`; it refuses unowned,
50
+ partial, symbolic-link, and unsafe exact paths while preserving unrelated
51
+ plugins, skills, and configuration.
52
+ - The OpenCode bridge makes no network, subprocess, recursive OpenCode, extra
53
+ model, telemetry, or credential access and preserves the complete-procedure
54
+ grounding requirement.
55
+
8
56
  ## [1.1.5] - 2026-08-12
9
57
 
10
58
  ### Added
@@ -340,3 +388,4 @@ All notable changes to OpenSocrates are documented here. This project follows
340
388
  [1.1.3]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.2...v1.1.3
341
389
  [1.1.4]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.3...v1.1.4
342
390
  [1.1.5]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.4...v1.1.5
391
+ [1.2.0]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.5...v1.2.0
package/README.ko.md CHANGED
@@ -11,13 +11,13 @@
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를 위한 로컬 연동 및 저작 추론 프레임워크입니다.
14
+ OpenSocrates는 Claude, Codex, Grok Build, OpenCode를 위한 로컬 연동 및 저작 추론 프레임워크입니다.
15
15
  의도적인 추론이 필요한 요청을 감지하고, 현재 호스트의 새로운 셀렉터에서 적합한
16
16
  추론 시스템을 고른 뒤, 이론과 예제 전체를 활성 작업에 추가합니다. 단순한 사실
17
17
  확인과 기계적인 작업은 그대로 통과할 수 있습니다.
18
18
 
19
- 버전 `1.1.5`에는 48개의 추론 시스템, Claude의 단일 사용자 진입점, 선택된 절차를
20
- 실제로 읽었는지 확인하는 Claude 접지 게이트, Claude/Codex 통합 라이프사이클,
19
+ 버전 `1.2.0`에는 48개의 추론 시스템과 OpenCode의 안정판 같은 턴 자동 활성화,
20
+ 네이티브 스킬 폴백, Claude/Codex/OpenCode 통합 라이프사이클,
21
21
  선택형 자동 업데이트가 들어 있습니다. 현재 릴리스 플랫폼은 Apple Silicon
22
22
  macOS(`darwin-arm64`)입니다. 기존 호스트 로그인을 사용하므로 API 키나
23
23
  OpenSocrates 백엔드가 필요하지 않습니다.
@@ -26,16 +26,21 @@ OpenSocrates 백엔드가 필요하지 않습니다.
26
26
  런처는 `darwin-arm64`만 허용하며, Intel Mac·Linux·Windows용 런처와 런타임은
27
27
  이번 릴리스에 포함되거나 지원되지 않습니다.
28
28
 
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
- > 업데이트할 수 있습니다.
29
+ > **최신 릴리스: OpenSocrates 1.2.0.** 실험적 Antigravity·Cursor 스킬
30
+ > 패키지, 라이브 검증을 마친 Grok Build 네이티브 지원, OpenCode
31
+ > 1.18.18+의 안정판 `chat.message` 브리지와 네이티브 Agent Skill 폴백을
32
+ > 추가했습니다. `npx --yes opensocrates@1.2.0 update --host all`로 관리
33
+ > 호스트를 함께 업데이트할 수 있습니다.
34
34
 
35
35
  ## 호스트 지원 범위
36
36
 
37
37
  | 호스트 화면 | 자동 선택 | 사용자 진입점 | 검증 상태 |
38
38
  | --- | --- | --- | --- |
39
+ | Google Antigravity CLI | 명시적 스킬만 지원 | `opensocrates` 스킬 | [실험적 콘텐츠 전용 플러그인](docs/antigravity-support.md) |
40
+ | Cursor IDE 및 CLI | 별도 셀렉터 없이 스킬 탐색 | `/opensocrates` | [실험적 콘텐츠 전용 Agent Plugin, 라이브 영수증 없음](docs/cursor-support.md) |
41
+ | Grok Build `grok -p` | 네이티브 스킬로 같은 턴에 지원 | `/opensocrates` | [Grok Build 1.0.3 자동·명시적 네이티브 스킬 검증 완료](docs/grok-support.md) |
42
+ | Grok Build TUI | 헤드리스와 같은 네이티브 플러그인, 활성화 영수증은 대기 중 | `/opensocrates` | [TUI 훅 실행 검증 완료, 네이티브 스킬 마커 테스트는 미완료, 배포 패키지에 훅 없음](docs/grok-support.md) |
43
+ | OpenCode TUI 및 `opencode run` | 안정판 같은 턴 로컬 브리지 | 네이티브 `opensocrates` 스킬 | [OpenCode 1.18.18 TUI, `opencode run` 및 DeepSeek V4 Flash 라이브 스모크 완료](docs/opencode-support.ko.md) |
39
44
  | Codex CLI 및 Desktop | 앱에서 훅을 한 번 승인한 뒤 지원 | OpenSocrates 플러그인 | `darwin-arm64` 패키지·런처 릴리스 검증 완료, 실제 Codex 훅 전달 영수증 없음 |
40
45
  | Claude Code CLI | `UserPromptSubmit` 훅으로 지원 | `/opensocrates` | `darwin-arm64` 로컬 검증 완료 |
41
46
  | Claude Code 데스크톱 앱 | Claude Code 플러그인이 실행되는 곳에서 지원 | `/opensocrates` | [인증된 훅 생명주기 로컬 검증 완료](docs/claude-desktop-live-probe.md) |
@@ -72,6 +77,8 @@ receipt, Stop, 정리 생명주기도 로컬 검증을 마쳤습니다. 버전 1
72
77
 
73
78
  - Claude: Claude Code `2.1.205` 이상과 `claude` 명령
74
79
  - Codex: OAuth 로그인이 완료된 `codex` 명령
80
+ - Grok Build: `grok 1.0.3` 이상과 기존 Grok 인증(API 키 추가 불필요)
81
+ - OpenCode: OpenCode `1.18.18` 이상, 설정된 공급자/모델 제한 없음
75
82
 
76
83
  Node.js 20 이상이 필요합니다. npm에 게시된 `opensocrates` 패키지는 외부
77
84
  의존성이 없는 작은 설치 프로그램입니다. GitHub Releases에서 호스트 패키지를
@@ -81,20 +88,20 @@ Node.js 20 이상이 필요합니다. npm에 게시된 `opensocrates` 패키지
81
88
  ### 준비된 모든 호스트에 설치
82
89
 
83
90
  ```bash
84
- npx --yes opensocrates@1.1.5 install --host all
91
+ npx --yes opensocrates@1.2.0 install --host all
85
92
  ```
86
93
 
87
94
  모든 호스트 경로는 지원되는 인증 완료 CLI를 찾고, 어느 호스트도 바꾸기 전에
88
- 전체 사전점검을 끝냅니다. 두 패키지를 모두 검증·스테이징한 다음 한 릴리스를
95
+ 전체 사전점검을 끝냅니다. 선택된 패키지를 모두 검증·스테이징한 다음 한 릴리스를
89
96
  트랜잭션으로 활성화합니다. 한 호스트의 활성화가 실패하면 이번 트랜잭션에서 이미
90
97
  바뀐 호스트도 이전 관리형 등록으로 되돌립니다.
91
98
 
92
99
  전체 라이프사이클에서 같은 호스트 값을 사용할 수 있습니다.
93
100
 
94
101
  ```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
102
+ npx --yes opensocrates@1.2.0 status --host all
103
+ npx --yes opensocrates@1.2.0 update --host all
104
+ npx --yes opensocrates@1.2.0 remove --host all
98
105
  ```
99
106
 
100
107
  소유자 전용 `~/.opensocrates/desired-state.json`에는 선택 채널, 설치된 호스트,
@@ -106,15 +113,31 @@ npx --yes opensocrates@1.1.5 remove --host all
106
113
  기존 사용자와의 호환성을 위해 기본 호스트는 계속 Codex입니다.
107
114
 
108
115
  ```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
116
+ npx --yes opensocrates@1.2.0 install
117
+ # 같은 명령: npx --yes opensocrates@1.2.0 install --host codex
118
+ npx --yes opensocrates@1.2.0 install --host claude
119
+ npx --yes opensocrates@1.2.0 install --host antigravity
120
+ npx --yes opensocrates@1.2.0 install --host cursor
121
+ npx --yes opensocrates@1.2.0 install --host grok
122
+ npx --yes opensocrates@1.2.0 install --host opencode
112
123
  ```
113
124
 
125
+ Grok Build는 `~/.grok/plugins/opensocrates`에 네이티브 콘텐츠 전용 플러그인을
126
+ 설치합니다. 자동 선택과 명시적 호출이 가능한 `/opensocrates` 스킬 하나와 내부
127
+ 절차 48개만 포함하며, 훅·명령·에이전트·MCP 서버·런처·런타임·중첩 셀렉터 호출은
128
+ 포함하지 않습니다. 설치 프로그램은 Grok의 기계 판독 상태를 확인하지만 이 정확한
129
+ 디렉터리만 소유하며 Claude 설치를 변경하거나 삭제하지 않습니다. 자세한 내용은
130
+ [Grok Build 지원 경계](docs/grok-support.md)를 참고하세요.
131
+
114
132
  기존 `--host codex` 및 `--host claude` 라이프사이클은 그대로 지원합니다. 호스트별
115
133
  업데이트는 의도적으로 버전 차이를 만들 수 있고, 이후 `update --host all` 또는
116
134
  성공한 자동 조정이 desired state에 기록된 모든 호스트를 다시 한 버전으로 맞춥니다.
117
135
 
136
+ OpenCode 설치는 `~/.config/opencode` 아래의 `plugins/opensocrates.js`, 소유권
137
+ 사이드카, `skills/opensocrates/`만 소유합니다. `opencode.json`이나 관계없는
138
+ 플러그인·스킬은 수정하지 않습니다. 자세한 경계는
139
+ [OpenCode 지원 문서](docs/opencode-support.ko.md)를 참고하세요.
140
+
118
141
  Claude 상태는 활성 설치와 설치됐지만 비활성화된 플러그인을 구분합니다. 원하는
119
142
  설치가 비활성 상태라면 drift로 보고합니다. `install` 또는 `update`를 실행하면 검증된
120
143
  패키지를 의도적으로 다시 활성화하며, 활성화가 실패하면 롤백이 이전의 활성·비활성
@@ -125,9 +148,9 @@ Claude 상태는 활성 설치와 설치됐지만 비활성화된 플러그인
125
148
  ### 선택형 자동 업데이트
126
149
 
127
150
  ```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
151
+ npx --yes opensocrates@1.2.0 auto-update enable --host all
152
+ npx --yes opensocrates@1.2.0 auto-update status
153
+ npx --yes opensocrates@1.2.0 auto-update disable
131
154
  ```
132
155
 
133
156
  자동 업데이트는 명시적으로 켜기 전까지 비활성화되어 있습니다. macOS LaunchAgent는
@@ -149,7 +172,7 @@ LaunchAgent를 언로드하고 삭제하며, `remove --host all`도 관리 호
149
172
  ### Claude 웹 및 Desktop Chat 스킬
150
173
 
151
174
  이 화면들은 플러그인 스킬은 지원하지만 훅은 실행하지 않습니다. 릴리스에서
152
- `opensocrates-1.1.5-claude-chat-skills.zip`을 내려받아 Claude의 **사용자 지정 →
175
+ `opensocrates-1.2.0-claude-chat-skills.zip`을 내려받아 Claude의 **사용자 지정 →
153
176
  스킬 → 스킬 업로드** 화면에서 업로드하세요. ZIP은 업로더 요구사항에 맞춰
154
177
  최상위 `opensocrates/` 폴더 바로 아래에 `SKILL.md`를 둡니다. 패키지는
155
178
  `/opensocrates` 스킬 하나만 노출하고, 48개
@@ -163,24 +186,25 @@ LaunchAgent를 언로드하고 삭제하며, `remove --host all`도 관리 호
163
186
  npm 레지스트리를 거치지 않을 때도 같은 호스트 옵션을 사용합니다.
164
187
 
165
188
  ```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
189
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host all
190
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host claude
191
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host codex
192
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host opencode
169
193
  ```
170
194
 
171
195
  ### 릴리스 파일 직접 검증
172
196
 
173
- [v1.1.5 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.5)에서
197
+ [v1.2.0 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.2.0)에서
174
198
  `opensocrates.mjs`, 호스트 패키지, `.sha256` 파일을 내려받습니다. Claude의 예:
175
199
 
176
200
  ```bash
177
- shasum -a 256 -c opensocrates-1.1.5-claude-plugin.zip.sha256
201
+ shasum -a 256 -c opensocrates-1.2.0-claude-plugin.zip.sha256
178
202
  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
203
+ --asset opensocrates-1.2.0-claude-plugin.zip \
204
+ --checksum opensocrates-1.2.0-claude-plugin.zip.sha256
181
205
  ```
182
206
 
183
- Codex 패키지는 `claude`를 `codex`로 바꾸면 됩니다.
207
+ 다른 호스트 패키지는 `claude`를 `antigravity`, `codex`, `cursor`, `opencode`로 바꾸면 됩니다.
184
208
 
185
209
  ### 1.0 이전 Claude 플러그인에서 이전하기
186
210
 
@@ -192,7 +216,7 @@ Codex 패키지는 `claude`를 `codex`로 바꾸면 됩니다.
192
216
  ```bash
193
217
  claude plugin uninstall opensocrates@OpenSocrates --scope user
194
218
  claude plugin marketplace remove OpenSocrates --scope user
195
- npx --yes opensocrates@1.1.5 install --host claude
219
+ npx --yes opensocrates@1.2.0 install --host claude
196
220
  ```
197
221
 
198
222
  관리형 v1.1.0 Claude 설치를 업데이트하면 패키지 트리 전체가 교체됩니다. 따라서
@@ -201,9 +225,9 @@ npx --yes opensocrates@1.1.5 install --host claude
201
225
 
202
226
  ## 사용법
203
227
 
204
- Claude나 Codex를 평소처럼 사용하세요. 요청에 판단, 해석, 진단, 설명, 계획,
228
+ Claude, Codex, OpenCode를 평소처럼 사용하세요. 요청에 판단, 해석, 진단, 설명, 계획,
205
229
  근거 조정 또는 다른 구조적 추론이 필요하면 OpenSocrates가 개입할 수 있습니다.
206
- 개입할 때는 다음과 같이 동작합니다.
230
+ Claude/Codex 네이티브 런타임 화면에서는 다음과 같이 동작합니다.
207
231
 
208
232
  1. 현재 호스트에서 새로운 비영구 셀렉터를 시작합니다.
209
233
  2. 저작된 48개 시스템 카탈로그에서 적합한 시스템을 선택합니다.
@@ -213,6 +237,10 @@ Claude나 Codex를 평소처럼 사용하세요. 요청에 판단, 해석, 진
213
237
  5. 활성 작업이 방법을 적용하기 전에 전체 파일을 읽고, 접지된 답변의 마지막에
214
238
  `OpenSocrates grounding: triangulation@1`과 같은 정확한 감사 줄을 남기게 합니다.
215
239
 
240
+ OpenCode에서는 의존성 없는 안정판 훅이 로컬에서 방법을 고르고 완전한 저작 절차
241
+ 하나를 같은 메시지 턴에 직접 삽입합니다. artifact나 추가 모델 호출은 만들지
242
+ 않습니다. [OpenCode 지원 경계](docs/opencode-support.ko.md)를 참고하세요.
243
+
216
244
  Codex에 설치한 뒤에는 대화형 Codex 세션을 한 번 열어 OpenSocrates 훅을 승인해야
217
245
  자동 선택을 신뢰할 수 있습니다. 이 승인이 끝나기 전에는 `codex exec` 같은 비대화형
218
246
  화면이 신뢰되지 않은 훅을 조용히 건너뛸 수 있습니다.
@@ -367,6 +395,7 @@ make release-check
367
395
  | `content/` | 정책, 다국어 메시지, 추론 방법, 이론과 예제 |
368
396
  | `plugin-src/claude/` | Claude 플러그인 템플릿 |
369
397
  | `plugin-src/codex/` | Codex 플러그인 템플릿 |
398
+ | `plugin-src/grok/` | Grok Build 네이티브 콘텐츠 전용 플러그인 템플릿 |
370
399
  | `schemas/source/` | 정규 스키마 정의 |
371
400
  | `schemas/v1/` | 생성된 버전 고정 공개 스키마 |
372
401
  | `installer/` | 외부 의존성이 없는 Node.js GitHub/npx 설치 프로그램 |
package/README.md CHANGED
@@ -12,14 +12,14 @@
12
12
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
13
13
 
14
14
  OpenSocrates is a local integration and authored reasoning framework for
15
- Claude and Codex. It detects requests that benefit from deliberate reasoning,
15
+ Claude, Codex, Grok Build, and OpenCode. It detects requests that benefit from deliberate reasoning,
16
16
  uses a fresh host-native selector to choose relevant systems, and adds their
17
17
  complete theory and examples to the active task. Straightforward factual and
18
18
  mechanical work can pass through unchanged.
19
19
 
20
- Version `1.1.5` includes 48 reasoning systems, one user-facing Claude entry, a
21
- Claude grounding gate that verifies selected procedures were read, coordinated
22
- Claude/Codex lifecycle management, and opt-in automatic updates on
20
+ Version `1.2.0` adds first-class OpenCode support to the 48 reasoning systems,
21
+ including stable same-turn activation, a native skill fallback, coordinated
22
+ multi-host lifecycle management, and opt-in automatic updates on
23
23
  Apple-silicon macOS (`darwin-arm64`). It uses your existing host login and does
24
24
  not require an API key or an OpenSocrates backend.
25
25
 
@@ -27,17 +27,21 @@ The native plugin archives intentionally ship only `bin/launch.sh`. That
27
27
  launcher accepts `darwin-arm64` only; macOS Intel, Linux, and Windows launchers
28
28
  and runtimes are not shipped or supported in this release.
29
29
 
30
- > **Latest release: [OpenSocrates 1.1.5](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.5).**
31
- > It makes Claude grounding readable without extra directory permission,
32
- > verifies installed package files in `diagnose`, and documents Codex's
33
- > one-time hook approval boundary.
34
- > Upgrade both managed hosts together with
35
- > `npx --yes opensocrates@1.1.5 update --host all`.
30
+ > **Latest release: OpenSocrates 1.2.0.** It adds experimental Antigravity and
31
+ > Cursor skill packages, live-validated native Grok Build support, and OpenCode
32
+ > 1.18.18+ with a stable `chat.message` bridge and native Agent Skill fallback.
33
+ > Upgrade managed hosts together with
34
+ > `npx --yes opensocrates@1.2.0 update --host all`.
36
35
 
37
36
  ## Host support
38
37
 
39
38
  | Host surface | Automatic selection | User-facing entry | Validation status |
40
39
  | --- | --- | --- | --- |
40
+ | Google Antigravity CLI | No; explicit skill only | `opensocrates` skill | [Experimental content-only plugin; `agy 1.0.6` validation passed](docs/antigravity-support.md) |
41
+ | Cursor IDE and CLI | Cursor may discover the skill; no separate OpenSocrates selector call | `/opensocrates` | [Experimental content-only Agent Plugin; official package contract checked, no live Cursor receipt](docs/cursor-support.md) |
42
+ | Grok Build `grok -p` | Yes; native same-turn skill selection | `/opensocrates` | [Automatic and explicit native skill validated on Grok Build 1.0.3](docs/grok-support.md) |
43
+ | Grok Build TUI | Native plugin is shared with headless; activation receipt pending | `/opensocrates` | [TUI hook execution verified, native skill marker test pending; shipped package has no hooks](docs/grok-support.md) |
44
+ | OpenCode TUI and `opencode run` | Yes; stable same-turn local bridge | Native `opensocrates` skill | [OpenCode 1.18.18 TUI, `opencode run`, and DeepSeek V4 Flash live smoke validated](docs/opencode-support.md) |
41
45
  | 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 |
42
46
  | Claude Code CLI | Yes, through `UserPromptSubmit` | `/opensocrates` | Locally validated on `darwin-arm64` |
43
47
  | Claude Code desktop app | Yes, where Claude Code plugins run | `/opensocrates` | [Authenticated hook lifecycle locally validated](docs/claude-desktop-live-probe.md) |
@@ -75,8 +79,12 @@ rather than repository sync.
75
79
 
76
80
  Before installing, sign in to the host and make sure its command is available:
77
81
 
82
+ - Antigravity: `agy 1.0.0` or later; support is explicit-skill only;
83
+ - Cursor: Cursor `2.5.0` or later; support is explicit-skill first;
78
84
  - Claude: Claude Code `2.1.205` or later and the `claude` command;
79
85
  - Codex: an OAuth-authenticated `codex` command.
86
+ - Grok Build: `grok 1.0.3` or later; existing Grok authentication, with no additional API key.
87
+ - OpenCode: OpenCode `1.18.18` or later; any configured provider/model is accepted.
80
88
 
81
89
  Node.js 20 or later is required. The published `opensocrates` npm package is a
82
90
  small, dependency-free installer. It downloads the matching package from
@@ -86,21 +94,21 @@ before registering an owner-marked managed marketplace.
86
94
  ### Install every ready host
87
95
 
88
96
  ```bash
89
- npx --yes opensocrates@1.1.5 install --host all
97
+ npx --yes opensocrates@1.2.0 install --host all
90
98
  ```
91
99
 
92
100
  The all-host path detects supported, authenticated host CLIs, completes every
93
- preflight before changing either host, verifies and stages both packages, and
94
- then activates one release transactionally. If one activation fails, every
101
+ preflight before changing any host, verifies and stages every selected package,
102
+ and then activates one release transactionally. If one activation fails, every
95
103
  host already changed in that transaction is restored to its previous managed
96
104
  registration.
97
105
 
98
106
  Use the same host value for the complete lifecycle:
99
107
 
100
108
  ```bash
101
- npx --yes opensocrates@1.1.5 status --host all
102
- npx --yes opensocrates@1.1.5 update --host all
103
- npx --yes opensocrates@1.1.5 remove --host all
109
+ npx --yes opensocrates@1.2.0 status --host all
110
+ npx --yes opensocrates@1.2.0 update --host all
111
+ npx --yes opensocrates@1.2.0 remove --host all
104
112
  ```
105
113
 
106
114
  A private `~/.opensocrates/desired-state.json` manifest records the selected
@@ -113,16 +121,40 @@ automatic update, and per-host drift.
113
121
  Codex remains the default host for backward compatibility:
114
122
 
115
123
  ```bash
116
- npx --yes opensocrates@1.1.5 install
117
- # Equivalent: npx --yes opensocrates@1.1.5 install --host codex
118
- npx --yes opensocrates@1.1.5 install --host claude
124
+ npx --yes opensocrates@1.2.0 install
125
+ # Equivalent: npx --yes opensocrates@1.2.0 install --host codex
126
+ npx --yes opensocrates@1.2.0 install --host antigravity
127
+ npx --yes opensocrates@1.2.0 install --host claude
128
+ npx --yes opensocrates@1.2.0 install --host cursor
129
+ npx --yes opensocrates@1.2.0 install --host grok
130
+ npx --yes opensocrates@1.2.0 install --host opencode
119
131
  ```
120
132
 
133
+ Antigravity installs a content-only plugin at
134
+ `~/.gemini/config/plugins/opensocrates`. It contains one explicit skill and no
135
+ hook, launcher, native runtime, background service, telemetry, or extra model
136
+ selector call. See the [Antigravity support boundary](docs/antigravity-support.md).
137
+ Cursor installs a content-only Agent Plugin at
138
+ `~/.cursor/plugins/local/opensocrates`. It includes one skill and no hook,
139
+ launcher, native runtime, background service, telemetry, or separate selector
140
+ model call. See the [Cursor support boundary](docs/cursor-support.md).
141
+ Grok Build installs a native content-only plugin at
142
+ `~/.grok/plugins/opensocrates`. It exposes one auto-selectable and explicitly
143
+ invocable `/opensocrates` skill with 48 internal procedures. The package has no
144
+ hooks, command, agent, MCP server, launcher, runtime, or nested selector call.
145
+ The installer reads Grok's machine-readable inspection state but owns only that
146
+ exact directory and never modifies or removes a Claude installation. See the
147
+ [Grok Build support boundary](docs/grok-support.md).
121
148
  Existing `--host codex` and `--host claude` lifecycle commands remain
122
149
  supported. A host-specific update can intentionally create drift; a later
123
150
  `update --host all` or successful automatic reconciliation brings every host
124
151
  recorded in desired state back to one version.
125
152
 
153
+ OpenCode installation owns only `plugins/opensocrates.js`, its sidecar, and
154
+ `skills/opensocrates/` beneath `~/.config/opencode`; it never rewrites
155
+ `opencode.json` or unrelated plugins and skills. See the
156
+ [OpenCode support and evidence boundary](docs/opencode-support.md).
157
+
126
158
  For Claude, status distinguishes an enabled installation from an
127
159
  installed-but-disabled plugin. A disabled desired installation is reported as
128
160
  drift. Running `install` or `update` intentionally installs the verified
@@ -135,9 +167,9 @@ commands. The privacy-safe 2.1.226 fixture is under
135
167
  ### Opt-in automatic updates
136
168
 
137
169
  ```bash
138
- npx --yes opensocrates@1.1.5 auto-update enable --host all
139
- npx --yes opensocrates@1.1.5 auto-update status
140
- npx --yes opensocrates@1.1.5 auto-update disable
170
+ npx --yes opensocrates@1.2.0 auto-update enable --host all
171
+ npx --yes opensocrates@1.2.0 auto-update status
172
+ npx --yes opensocrates@1.2.0 auto-update disable
141
173
  ```
142
174
 
143
175
  Automatic updates are disabled until explicitly enabled. The macOS LaunchAgent
@@ -160,7 +192,7 @@ workspace paths. `auto-update disable` unloads and removes the LaunchAgent;
160
192
  ### Claude web and Desktop Chat skills
161
193
 
162
194
  These surfaces support plugin skills but not hooks. Download
163
- `opensocrates-1.1.5-claude-chat-skills.zip` from the release and upload it from
195
+ `opensocrates-1.2.0-claude-chat-skills.zip` from the release and upload it from
164
196
  Claude's **Customize → Skills → Upload skill** UI. The ZIP contains one
165
197
  top-level `opensocrates/` folder with `SKILL.md` directly inside, as required by
166
198
  the skill uploader. The package exposes exactly one
@@ -174,25 +206,29 @@ because Chat does not execute plugin hooks. See Anthropic's
174
206
  The same host option works without the npm registry:
175
207
 
176
208
  ```bash
177
- npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host all
178
- npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host claude
179
- npx --yes github:ParkerHwang/OpenSocrates#v1.1.5 install --host codex
209
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host all
210
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host antigravity
211
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host claude
212
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host codex
213
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host cursor
214
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host grok
215
+ npx --yes github:ParkerHwang/OpenSocrates#v1.2.0 install --host opencode
180
216
  ```
181
217
 
182
218
  ### Manual release verification
183
219
 
184
220
  Download `opensocrates.mjs`, the host package, and its `.sha256` file from the
185
- [v1.1.5 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.1.5).
221
+ [v1.2.0 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.2.0).
186
222
  For Claude, for example:
187
223
 
188
224
  ```bash
189
- shasum -a 256 -c opensocrates-1.1.5-claude-plugin.zip.sha256
225
+ shasum -a 256 -c opensocrates-1.2.0-claude-plugin.zip.sha256
190
226
  node opensocrates.mjs install --host claude \
191
- --asset opensocrates-1.1.5-claude-plugin.zip \
192
- --checksum opensocrates-1.1.5-claude-plugin.zip.sha256
227
+ --asset opensocrates-1.2.0-claude-plugin.zip \
228
+ --checksum opensocrates-1.2.0-claude-plugin.zip.sha256
193
229
  ```
194
230
 
195
- Replace `claude` with `codex` for the Codex package.
231
+ Replace `claude` with `antigravity`, `codex`, `cursor`, `grok`, or `opencode` for the matching package.
196
232
 
197
233
  ### Migrating a pre-1.0 Claude plugin
198
234
 
@@ -204,7 +240,7 @@ what is installed, remove it explicitly:
204
240
  ```bash
205
241
  claude plugin uninstall opensocrates@OpenSocrates --scope user
206
242
  claude plugin marketplace remove OpenSocrates --scope user
207
- npx --yes opensocrates@1.1.5 install --host claude
243
+ npx --yes opensocrates@1.2.0 install --host claude
208
244
  ```
209
245
 
210
246
  Updating a managed v1.1.0 Claude installation replaces the complete package
@@ -213,10 +249,10 @@ commands are therefore removed rather than left visible as stale entries.
213
249
 
214
250
  ## Use
215
251
 
216
- Use Claude or Codex normally. Before a submitted prompt, OpenSocrates may
252
+ Use Claude, Codex, or OpenCode normally. Before a submitted prompt, OpenSocrates may
217
253
  intervene when the request needs judgment, interpretation, diagnosis,
218
254
  explanation, planning, evidence reconciliation, or another structured
219
- reasoning process. When it intervenes, it:
255
+ reasoning process. On Claude/Codex native-runtime surfaces it:
220
256
 
221
257
  1. starts a fresh, non-persistent selector in the current host;
222
258
  2. chooses from the authored 48-system catalog;
@@ -227,6 +263,11 @@ reasoning process. When it intervenes, it:
227
263
  method and to end a grounded response with an exact audit line such as
228
264
  `OpenSocrates grounding: triangulation@1`.
229
265
 
266
+ On OpenCode, the dependency-free stable hook instead selects locally and
267
+ injects one complete authored procedure directly into the same message turn;
268
+ it creates no artifact and makes no extra model call. See the
269
+ [OpenCode support boundary](docs/opencode-support.md).
270
+
230
271
  After installing for Codex, open one interactive Codex session and approve the
231
272
  OpenSocrates hooks before relying on automatic selection. Until that one-time
232
273
  approval, non-interactive surfaces such as `codex exec` may silently continue
@@ -391,6 +432,9 @@ make release-check
391
432
  | `content/` | Policies, localized messages, methods, theory, and examples |
392
433
  | `plugin-src/claude/` | Claude plugin templates |
393
434
  | `plugin-src/codex/` | Codex plugin templates |
435
+ | `plugin-src/antigravity/` | Experimental Antigravity content-only plugin templates |
436
+ | `plugin-src/cursor/` | Experimental Cursor Agent Plugin templates |
437
+ | `plugin-src/grok/` | Native Grok Build content-only plugin templates |
394
438
  | `schemas/source/` | Canonical schema definitions |
395
439
  | `schemas/v1/` | Generated, versioned public schemas |
396
440
  | `installer/` | Dependency-free Node.js GitHub/npx installer |
package/VERSION CHANGED
@@ -1 +1 @@
1
- 1.1.5
1
+ 1.2.0