opensocrates 1.2.1 → 1.3.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 (7) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/README.ko.md +65 -55
  3. package/README.md +68 -59
  4. package/SECURITY.md +11 -0
  5. package/VERSION +1 -1
  6. package/installer/opensocrates.mjs +1 -1
  7. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,27 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.3.0] - 2026-09-08
4
+
5
+ - Add agent-directed method retrieval at decision points within an existing turn,
6
+ reusing canonical content and the deterministic router. Mechanical work can
7
+ pass through without loading a method. Delivery, reported availability and
8
+ application evidence remain distinct.
9
+ - Generate separate English/Korean canonical references for all 48 methods and
10
+ six hosts. Codex discovery now exposes the controller, rigor and trace; previous
11
+ per-method invocations migrate through the controller with unchanged Method IDs.
12
+ - Prevent weighted-primary and fallback routing from bypassing contraindications;
13
+ reject malformed feature lists without silently choosing a fallback.
14
+ - Preserve authored procedure bodies and prior rejected experimental baselines.
15
+ No Compact, method-variant or language rewrite is promoted.
16
+ - Add conservative presentation-only EN/KO Guided rules and full visible-output
17
+ measurements while preserving required cards, evidence, stop conditions and user formats.
18
+ - Avoid first-use hook storage initialization, retain safe existing artifact cleanup,
19
+ and provide a persistent packaged decision stream.
20
+ - Separate Chat export validation from cloud activation and postpublication provenance.
21
+ Release evidence and remaining host limits are recorded in
22
+ [the release record](docs/v1.3.0-recovery/PROGRESS.md).
23
+
24
+
3
25
  All notable changes to OpenSocrates are documented here. This project follows
4
26
  [Semantic Versioning](https://semver.org/).
5
27
 
@@ -467,3 +489,5 @@ All notable changes to OpenSocrates are documented here. This project follows
467
489
  [1.1.5]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.4...v1.1.5
468
490
  [1.2.0]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.1.5...v1.2.0
469
491
  [1.2.1]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.2.0...v1.2.1
492
+
493
+ [1.3.0]: https://github.com/ParkerHwang/OpenSocrates/compare/v1.2.1...v1.3.0
package/README.ko.md CHANGED
@@ -1,7 +1,19 @@
1
1
  <p align="center">
2
+
3
+ > OpenSocrates 1.3.0은 결정 지점 조회와 필수 내용을 보존하는 한영 작성 안내를 제공합니다.
4
+ > [릴리스 근거와 지원 한계](docs/v1.3.0-recovery/PROGRESS.md),
5
+ > [이전 안내와 전달 방식](docs/decision-points.ko.md)을 확인하세요.
6
+
2
7
  <img src="https://raw.githubusercontent.com/ParkerHwang/OpenSocrates/main/docs/assets/opensocrates-banner.jpg" alt="OpenSocrates" width="820">
3
8
  </p>
4
9
 
10
+ `gpt-5.6-luna`의 `max` 설정으로 진행한 합성 Codex 시험에서는 요청한 파일이
11
+ 있어도 300초 안에 최종 응답이 끝나지 않은 사례가 있었습니다. 이 릴리스는
12
+ 고정 응답 시간이나 입증된 품질·자연스러움·토큰 비용·속도 개선을 약속하지
13
+ 않습니다. 각 시도의 결과와 소스·설정 차이는 위 릴리스 근거에서 확인할 수
14
+ 있습니다.
15
+
16
+
5
17
  # OpenSocrates
6
18
 
7
19
  [English](README.md) | **한국어**
@@ -28,12 +40,9 @@ OpenSocrates 백엔드가 필요하지 않습니다.
28
40
  런처는 `darwin-arm64`만 허용하며, Intel Mac·Linux·Windows용 런처와 런타임은
29
41
  이번 릴리스에 포함되거나 지원되지 않습니다.
30
42
 
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
- > 대기 중입니다.
43
+ > **OpenSocrates 1.3.0 릴리스 구성:** 같은 요청 안의 선택적 조회, 정본 절차 보존,
44
+ > 필수 내용을 지키는 한영 표현 안내와 명확한 호스트 근거 수준을 제공합니다.
45
+ > Chat 클라우드 활성화는 미검증입니다.
37
46
 
38
47
  ## 호스트 지원 범위
39
48
 
@@ -48,7 +57,7 @@ OpenSocrates 백엔드가 필요하지 않습니다.
48
57
  | Claude Code CLI | `UserPromptSubmit` 훅으로 지원 | 플러그인: `/opensocrates:opensocrates` | `darwin-arm64` 로컬 검증 완료 |
49
58
  | Claude Code 데스크톱 앱 Local 모드 | Claude Code 플러그인이 실행되는 곳에서 지원 | 플러그인: `/opensocrates:opensocrates` | [인증된 훅 생명주기 로컬 검증 완료](docs/claude-desktop-live-probe.md) |
50
59
  | 로컬 플러그인을 사용하는 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) |
60
+ | Claude 웹 및 Desktop Chat | OpenSocrates 훅 미지원 | 독립형 스킬: `/opensocrates` | [v1.3 내보내기 검증, 클라우드 활성화 미검증](docs/claude-chat-upload-probe.md) |
52
61
 
53
62
  상태 열은 서로 다른 네 단계를 뜻하며 같은 의미로 읽으면 안 됩니다.
54
63
 
@@ -75,7 +84,7 @@ canonical 명령으로 `/opensocrates`를 사용합니다. Chat 화면은 패키
75
84
  Claude provenance 세 가지를 분리해서 보세요. installer가 관리하는 로컬 플러그인,
76
85
  Chat에 수동 업로드하는 standalone ZIP, 기존 synced/custom skill은 서로 다른
77
86
  근거입니다. 로컬 플러그인 status는 두 Cloud 상태를 증명하거나 갱신할 수 없습니다.
78
- 현재 기록된 로컬 플러그인 버전은 1.2.1이고 기존 synced/custom 관측은 1.1.2이지만,
87
+ 과거 기록의 로컬 플러그인 버전은 1.2.1이고 기존 synced/custom 관측은 1.1.2이지만,
79
88
  둘 다 정확한 v1.2.1 standalone 릴리스 ZIP을 업로드했다는 증거가 아닙니다.
80
89
 
81
90
  공개된 v1.1.2 Claude 플러그인 아카이브는 Cowork의 문서화된 압축 크기 제한과
@@ -105,7 +114,7 @@ Node.js 20 이상이 필요합니다. npm에 게시된 `opensocrates` 패키지
105
114
  ### 준비된 모든 호스트에 설치
106
115
 
107
116
  ```bash
108
- npx --yes opensocrates@1.2.1 install --host all
117
+ npx --yes opensocrates@1.3.0 install --host all
109
118
  ```
110
119
 
111
120
  모든 호스트 경로는 지원되는 인증 완료 CLI를 찾고, 어느 호스트도 바꾸기 전에
@@ -116,9 +125,9 @@ npx --yes opensocrates@1.2.1 install --host all
116
125
  전체 라이프사이클에서 같은 호스트 값을 사용할 수 있습니다.
117
126
 
118
127
  ```bash
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
128
+ npx --yes opensocrates@1.3.0 status --host all
129
+ npx --yes opensocrates@1.3.0 update --host all
130
+ npx --yes opensocrates@1.3.0 remove --host all
122
131
  ```
123
132
 
124
133
  ### 등록 제거, 소유 payload purge, Codex 신뢰 초기화
@@ -132,11 +141,11 @@ OpenSocrates 플러그인 캐시와 설치 프로그램 desired-state 파일은
132
141
  활성 호스트를 닫은 뒤 명시적인 소유 payload purge를 실행하세요.
133
142
 
134
143
  ```bash
135
- npx --yes opensocrates@1.2.1 remove --host all --purge
136
- # 호스트 하나: npx --yes opensocrates@1.2.1 remove --host claude --purge
144
+ npx --yes opensocrates@1.3.0 remove --host all --purge
145
+ # 호스트 하나: npx --yes opensocrates@1.3.0 remove --host claude --purge
137
146
  # 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
147
+ npx --yes opensocrates@1.3.0 remove --host all --purge --reset-trust
148
+ # Codex만: npx --yes opensocrates@1.3.0 remove --host codex --purge --reset-trust
140
149
  ```
141
150
 
142
151
  Purge는 항목을 삭제하기 전에 canonical 경로, 정확한
@@ -189,13 +198,13 @@ config를 유지하거나 안전하게 rollback할 수 있을 때 트랜잭션
189
198
  기존 사용자와의 호환성을 위해 기본 호스트는 계속 Codex입니다.
190
199
 
191
200
  ```bash
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
201
+ npx --yes opensocrates@1.3.0 install
202
+ # 같은 명령: npx --yes opensocrates@1.3.0 install --host codex
203
+ npx --yes opensocrates@1.3.0 install --host claude
204
+ npx --yes opensocrates@1.3.0 install --host antigravity
205
+ npx --yes opensocrates@1.3.0 install --host cursor
206
+ npx --yes opensocrates@1.3.0 install --host grok
207
+ npx --yes opensocrates@1.3.0 install --host opencode
199
208
  ```
200
209
 
201
210
  Grok Build는 `~/.grok/plugins/opensocrates`에 네이티브 콘텐츠 전용 플러그인을
@@ -224,9 +233,9 @@ Claude 상태는 활성 설치와 설치됐지만 비활성화된 플러그인
224
233
  ### 선택형 자동 업데이트
225
234
 
226
235
  ```bash
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
236
+ npx --yes opensocrates@1.3.0 auto-update enable --host all
237
+ npx --yes opensocrates@1.3.0 auto-update status
238
+ npx --yes opensocrates@1.3.0 auto-update disable
230
239
  ```
231
240
 
232
241
  자동 업데이트는 명시적으로 켜기 전까지 비활성화되어 있습니다. macOS LaunchAgent는
@@ -250,14 +259,12 @@ LaunchAgent를 언로드하고 삭제하며, `remove --host all`도 관리 호
250
259
  이 화면들은 별도로 업로드한 독립형 스킬을 사용할 수 있지만 로컬 플러그인 훅은
251
260
  실행하지 않습니다.
252
261
 
253
- 정확한 v1.2.1 Chat 릴리스 아티팩트: **사용 불가, 실제 업로드 대기 중.**
262
+ Chat 독립형 내보내기: **아카이브 계약 검증, 실제 활성화 미검증.**
254
263
 
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)을 확인하세요.
264
+ v1.3.0 독립형 ZIP에는 정본 48개와 한영 참조가 모두 들어 있습니다. 파일 구조·참조
265
+ 무결성 및 공개 배포 출처와 계정 수준의 업로드는 별도 근거입니다. 로컬 설치기는
266
+ 기존 custom/synced 스킬을 자동 갱신하지 않습니다.
267
+ [버전별 지원 근거](docs/claude-chat-upload-probe.md)를 확인하세요.
261
268
 
262
269
  정확한 릴리스가 공개되면 checksum을 먼저 검증한 뒤 Claude의 **사용자 지정 → 스킬
263
270
  → 스킬 업로드** 화면을 사용하세요. ZIP은 업로더 요구사항에 맞춰 최상위
@@ -274,25 +281,23 @@ Code/Cowork 플러그인 아카이브가 아닙니다. 독립형 패키지는 ca
274
281
  npm 레지스트리를 거치지 않을 때는 공개된 태그로 같은 호스트 옵션을 사용합니다.
275
282
 
276
283
  ```bash
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
284
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host all
285
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host claude
286
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host codex
287
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host opencode
281
288
  ```
282
289
 
283
290
  ### 릴리스 파일 직접 검증
284
291
 
285
292
  공개 뒤에는
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의 예:
293
+ [v1.3.0 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.3.0)에서
294
+ `opensocrates.mjs`, 호스트 패키지, `.sha256` 파일을 내려받습니다. 아래 명령은 이름이 일치하는 공개 asset을 확인한 뒤에 사용하세요. Claude의 예:
290
295
 
291
296
  ```bash
292
- shasum -a 256 -c opensocrates-1.2.1-claude-plugin.zip.sha256
297
+ shasum -a 256 -c opensocrates-1.3.0-claude-plugin.zip.sha256
293
298
  node opensocrates.mjs install --host claude \
294
- --asset opensocrates-1.2.1-claude-plugin.zip \
295
- --checksum opensocrates-1.2.1-claude-plugin.zip.sha256
299
+ --asset opensocrates-1.3.0-claude-plugin.zip \
300
+ --checksum opensocrates-1.3.0-claude-plugin.zip.sha256
296
301
  ```
297
302
 
298
303
  다른 호스트 패키지는 `claude`를 `antigravity`, `codex`, `cursor`, `opencode`로 바꾸면 됩니다.
@@ -307,7 +312,7 @@ node opensocrates.mjs install --host claude \
307
312
  ```bash
308
313
  claude plugin uninstall opensocrates@OpenSocrates --scope user
309
314
  claude plugin marketplace remove OpenSocrates --scope user
310
- npx --yes opensocrates@1.2.1 install --host claude
315
+ npx --yes opensocrates@1.3.0 install --host claude
311
316
  ```
312
317
 
313
318
  관리형 v1.1.0 Claude 설치를 업데이트하면 패키지 트리 전체가 교체됩니다. 따라서
@@ -320,14 +325,14 @@ npx --yes opensocrates@1.2.1 install --host claude
320
325
  근거 조정 또는 다른 구조적 추론이 필요하면 OpenSocrates가 참여할 수 있습니다.
321
326
  Claude/Codex 네이티브 런타임 화면에서는 다음과 같이 동작합니다.
322
327
 
323
- 1. 현재 호스트에서 새로운 비영구 셀렉터를 시작합니다.
324
- 2. 저작된 48개 시스템 카탈로그에서 적합한 시스템을 선택합니다.
325
- 3. 선택된 전체 콘텐츠를 소유자 전용 Markdown 파일에 씁니다.
326
- 4. 스스로 정리해야 할 스승 질문을 앞에 두고, 각 방법 ID와 콘텐츠 리비전, 크기
327
- 한도 안에 들면 정확한 `Do not use when` 및 `Stop conditions`를 작은 숨김
328
- 컨텍스트에 추가합니다.
329
- 5. 활성 작업이 방법을 적용하기 전에 전체 파일을 읽고, 접지된 답변의 마지막에
330
- `OpenSocrates grounding: triangulation@1`과 같은 정확한 감사 줄을 남기게 합니다.
328
+ 1. 초기 방법을 고르지 않고 짧은 네이티브 조회 안내를 전달합니다.
329
+ 2. 판단이 달라질 때 활성 에이전트가 적합한 정본 전체를 조회합니다.
330
+ 3. 목표·권한·근거·중단 조건과 요청한 출력 형식을 보존합니다.
331
+ 4. 보호된 내용을 재작성하지 않는 언어별 작성 안내를 제공합니다.
332
+ 5. 전달·에이전트의 가용성 신고·실제 적용을 구분합니다.
333
+
334
+ 설치 런처의 `decision codex --stream`은 임시 조회 세션을 유지합니다.
335
+ 새 프로세스나 문맥은 이전 읽기 신고를 이어받지 않습니다.
331
336
 
332
337
  OpenCode에서는 의존성 없는 안정판 훅이 로컬에서 방법을 고르고 완전한 저작 절차
333
338
  하나를 같은 메시지 턴에 직접 삽입합니다. 그 컴파일된 절차는 스승 질문 세 개로
@@ -341,10 +346,13 @@ Antigravity와 Cursor는 명시적 콘텐츠 스킬을 사용하고, Grok Build
341
346
  OpenSocrates 훅 전달을 주장하지 않습니다.
342
347
 
343
348
  Codex에 설치한 뒤에는 대화형 Codex 세션을 한 번 열어 OpenSocrates 훅을 승인해야
344
- 자동 선택을 신뢰할 수 있습니다. 이 승인이 끝나기 전에는 `codex exec` 같은 비대화형
349
+ 네이티브 조회 안내를 사용할 수 있습니다. 이 승인이 끝나기 전에는 `codex exec` 같은 비대화형
345
350
  화면이 신뢰되지 않은 훅을 조용히 건너뛸 수 있습니다.
346
351
 
347
- Claude 훅 화면은 추가 디렉터리 권한 없이 선택 콘텐츠를 읽을 수 있도록 현재
352
+ ### 보존된 이전 영수증 어댑터
353
+
354
+ 다음은 v1.3 기본 조회 안내 훅이 아닌 호환 셀렉터 경로의 설명입니다.
355
+ 이전 경로의 Claude 훅 화면은 추가 디렉터리 권한 없이 선택 콘텐츠를 읽을 수 있도록 현재
348
356
  워크스페이스 안의 소유자 전용 `.opensocrates` artifact 영역을 우선 사용합니다.
349
357
  내부 `.gitignore`가 이 영역을 `git status`에서 숨기고 turn·세션 정리 시 파일을
350
358
  삭제합니다. 워크스페이스를 사용할 수 없으면 소유자 전용 OS 임시 디렉터리로
@@ -525,3 +533,5 @@ OpenSocrates는 [MIT 라이선스](LICENSE)로 배포됩니다. 저작권 및
525
533
 
526
534
  OpenSocrates는 독립 오픈 소스 프로젝트이며 Anthropic 또는 OpenAI와 제휴하거나
527
535
  그들의 보증을 받은 프로젝트가 아닙니다.
536
+
537
+ Chat 독립형 내보내기: **아카이브 계약 검증, 실제 활성화 미검증.**
package/README.md CHANGED
@@ -1,7 +1,19 @@
1
1
  <p align="center">
2
+
3
+ > OpenSocrates 1.3.0: decision-point retrieval and conservative Guided EN/KO presentation.
4
+ > See [release evidence and support limits](docs/v1.3.0-recovery/PROGRESS.md) and
5
+ > [migration and delivery modes](docs/decision-points.md).
6
+
2
7
  <img src="https://raw.githubusercontent.com/ParkerHwang/OpenSocrates/main/docs/assets/opensocrates-banner.jpg" alt="OpenSocrates" width="820">
3
8
  </p>
4
9
 
10
+ Bounded synthetic Codex tests with `gpt-5.6-luna` at `max` effort included
11
+ 300-second final-delivery timeouts, even when the requested file existed.
12
+ This release does not promise a fixed response time or demonstrated quality,
13
+ naturalness, token-cost or latency improvement. See the linked release evidence
14
+ for every attempt and its source/configuration boundary.
15
+
16
+
5
17
  # OpenSocrates
6
18
 
7
19
  **English** | [한국어](README.ko.md)
@@ -29,12 +41,9 @@ The native plugin archives intentionally ship only `bin/launch.sh`. That
29
41
  launcher accepts `darwin-arm64` only; macOS Intel, Linux, and Windows launchers
30
42
  and runtimes are not shipped or supported in this release.
31
43
 
32
- > **Current release: OpenSocrates 1.2.1.** It adds a committed, mutation-tested
33
- > v1.2 adjudication snapshot and a bilingual three-question teacher overlay
34
- > across all six host packages. It also adds safe complete-uninstall and Codex
35
- > trust-reset flows, tighter Claude provenance boundaries, same-machine
36
- > reinstall acceptance, and source-complete Codex SessionStart timing evidence.
37
- > The separate Claude Chat v1.2.1 live-upload receipt remains pending.
44
+ > **OpenSocrates 1.3.0 release contents:** in-turn selective retrieval, unchanged
45
+ > canonical procedures, protected presentation-only EN/KO guidance and explicit
46
+ > host evidence levels. Chat cloud activation remains unvalidated.
38
47
 
39
48
  ## Host support
40
49
 
@@ -49,7 +58,7 @@ and runtimes are not shipped or supported in this release.
49
58
  | Claude Code CLI | Yes, through `UserPromptSubmit` | Plugin: `/opensocrates:opensocrates` | Locally validated on `darwin-arm64` |
50
59
  | Claude Code desktop app, Local mode | Yes, where Claude Code plugins run | Plugin: `/opensocrates:opensocrates` | [Authenticated hook lifecycle locally validated](docs/claude-desktop-live-probe.md) |
51
60
  | Claude Cowork with the local plugin | Yes, in the tested local plugin upload | Plugin: `/opensocrates:opensocrates` | [Native hook lifecycle locally validated; direct release upload, no marketplace sync](docs/claude-cowork-live-probe.md) |
52
- | Claude web and Desktop Chat | No OpenSocrates hooks | Standalone skill: `/opensocrates` | [Historical v1.1.2 upload validated; exact v1.2.1 release and live upload pending](docs/claude-chat-upload-probe.md) |
61
+ | Claude web and Desktop Chat | No OpenSocrates hooks | Standalone skill: `/opensocrates` | [v1.3 archive export validated; cloud activation unvalidated](docs/claude-chat-upload-probe.md) |
53
62
 
54
63
  The status column uses four distinct levels. Do not read them as
55
64
  interchangeable:
@@ -77,7 +86,7 @@ runtime. OpenSocrates fails open if a hook or selector is unavailable.
77
86
  Keep three Claude provenance states separate: the installer-managed local
78
87
  plugin, a standalone ZIP manually uploaded to Chat, and any pre-existing
79
88
  synced/custom skill. Local plugin status cannot prove or update either Cloud
80
- state. The currently recorded local plugin version is 1.2.1, while the
89
+ state. Historical records report local plugin version 1.2.1, while the
81
90
  pre-existing synced/custom observation is 1.1.2; neither is evidence that an
82
91
  exact v1.2.1 standalone release ZIP was uploaded.
83
92
 
@@ -110,7 +119,7 @@ before registering an owner-marked managed marketplace.
110
119
  ### Install every ready host
111
120
 
112
121
  ```bash
113
- npx --yes opensocrates@1.2.1 install --host all
122
+ npx --yes opensocrates@1.3.0 install --host all
114
123
  ```
115
124
 
116
125
  The all-host path detects supported, authenticated host CLIs, completes every
@@ -122,9 +131,9 @@ registration.
122
131
  Use the same host value for the complete lifecycle:
123
132
 
124
133
  ```bash
125
- npx --yes opensocrates@1.2.1 status --host all
126
- npx --yes opensocrates@1.2.1 update --host all
127
- npx --yes opensocrates@1.2.1 remove --host all
134
+ npx --yes opensocrates@1.3.0 status --host all
135
+ npx --yes opensocrates@1.3.0 update --host all
136
+ npx --yes opensocrates@1.3.0 remove --host all
128
137
  ```
129
138
 
130
139
  ### Remove a registration, purge owned payloads, or reset Codex trust
@@ -139,11 +148,11 @@ result as a complete uninstall.
139
148
  After closing active hosts, request the explicit owned-payload purge:
140
149
 
141
150
  ```bash
142
- npx --yes opensocrates@1.2.1 remove --host all --purge
143
- # One host: npx --yes opensocrates@1.2.1 remove --host claude --purge
151
+ npx --yes opensocrates@1.3.0 remove --host all --purge
152
+ # One host: npx --yes opensocrates@1.3.0 remove --host claude --purge
144
153
  # Also reset only OpenSocrates Codex hook trust:
145
- npx --yes opensocrates@1.2.1 remove --host all --purge --reset-trust
146
- # Codex only: npx --yes opensocrates@1.2.1 remove --host codex --purge --reset-trust
154
+ npx --yes opensocrates@1.3.0 remove --host all --purge --reset-trust
155
+ # Codex only: npx --yes opensocrates@1.3.0 remove --host codex --purge --reset-trust
147
156
  ```
148
157
 
149
158
  Purge verifies canonical paths, the exact `opensocrates@opensocrates` package
@@ -200,13 +209,13 @@ automatic update, and per-host drift.
200
209
  Codex remains the default host for backward compatibility:
201
210
 
202
211
  ```bash
203
- npx --yes opensocrates@1.2.1 install
204
- # Equivalent: npx --yes opensocrates@1.2.1 install --host codex
205
- npx --yes opensocrates@1.2.1 install --host antigravity
206
- npx --yes opensocrates@1.2.1 install --host claude
207
- npx --yes opensocrates@1.2.1 install --host cursor
208
- npx --yes opensocrates@1.2.1 install --host grok
209
- npx --yes opensocrates@1.2.1 install --host opencode
212
+ npx --yes opensocrates@1.3.0 install
213
+ # Equivalent: npx --yes opensocrates@1.3.0 install --host codex
214
+ npx --yes opensocrates@1.3.0 install --host antigravity
215
+ npx --yes opensocrates@1.3.0 install --host claude
216
+ npx --yes opensocrates@1.3.0 install --host cursor
217
+ npx --yes opensocrates@1.3.0 install --host grok
218
+ npx --yes opensocrates@1.3.0 install --host opencode
210
219
  ```
211
220
 
212
221
  Antigravity installs a content-only plugin at
@@ -246,9 +255,9 @@ commands. The privacy-safe 2.1.226 fixture is under
246
255
  ### Opt-in automatic updates
247
256
 
248
257
  ```bash
249
- npx --yes opensocrates@1.2.1 auto-update enable --host all
250
- npx --yes opensocrates@1.2.1 auto-update status
251
- npx --yes opensocrates@1.2.1 auto-update disable
258
+ npx --yes opensocrates@1.3.0 auto-update enable --host all
259
+ npx --yes opensocrates@1.3.0 auto-update status
260
+ npx --yes opensocrates@1.3.0 auto-update disable
252
261
  ```
253
262
 
254
263
  Automatic updates are disabled until explicitly enabled. The macOS LaunchAgent
@@ -273,15 +282,12 @@ workspace paths. `auto-update disable` unloads and removes the LaunchAgent;
273
282
  These surfaces can use a separately uploaded standalone skill but do not run
274
283
  the local plugin hooks.
275
284
 
276
- Exact v1.2.1 Chat release artifact: **unavailable; live upload pending.**
285
+ Chat standalone export: **archive contract validated; live activation unvalidated.**
277
286
 
278
- As of the 2026-08-15 audit, GitHub has no public `v1.2.1` tag or release, so
279
- `opensocrates-1.2.1-claude-chat-skills.zip`, its checksum, and its release
280
- commit cannot be verified or uploaded. Do not substitute a source-built
281
- candidate or the Claude Code/Cowork plugin archive. The existing v1.1.2 live
282
- receipt is historical evidence only, and the existing synced/custom skill was
283
- left unchanged. See the [version-bound evidence and flip
284
- conditions](docs/claude-chat-upload-probe.md).
287
+ The complete v1.3.0 standalone ZIP ships with all 48 methods in EN/KO. Its
288
+ layout/reference integrity and public release provenance are separate from an
289
+ account-level upload. Older custom/synced skills are not automatically upgraded
290
+ by the local installer. See [version-bound support evidence](docs/claude-chat-upload-probe.md).
285
291
 
286
292
  When the exact release is published, verify its checksum before using Claude's
287
293
  **Customize → Skills → Upload skill** UI. The ZIP must contain one top-level
@@ -297,28 +303,27 @@ absent because Chat does not execute the packaged hooks. See Anthropic's
297
303
  The same host option works without the npm registry by using the published tag:
298
304
 
299
305
  ```bash
300
- npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host all
301
- npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host antigravity
302
- npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host claude
303
- npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host codex
304
- npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host cursor
305
- npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host grok
306
- npx --yes github:ParkerHwang/OpenSocrates#v1.2.1 install --host opencode
306
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host all
307
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host antigravity
308
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host claude
309
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host codex
310
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host cursor
311
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host grok
312
+ npx --yes github:ParkerHwang/OpenSocrates#v1.3.0 install --host opencode
307
313
  ```
308
314
 
309
315
  ### Manual release verification
310
316
 
311
317
  After publication, download `opensocrates.mjs`, the host package, and its
312
318
  `.sha256` file from the
313
- [v1.2.1 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.2.1).
314
- That release was unavailable at the 2026-08-15 audit. The following is the
315
- verification command to use only after all named assets exist; for Claude:
319
+ [v1.3.0 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.3.0).
320
+ Verify the named published assets before installation; for Claude:
316
321
 
317
322
  ```bash
318
- shasum -a 256 -c opensocrates-1.2.1-claude-plugin.zip.sha256
323
+ shasum -a 256 -c opensocrates-1.3.0-claude-plugin.zip.sha256
319
324
  node opensocrates.mjs install --host claude \
320
- --asset opensocrates-1.2.1-claude-plugin.zip \
321
- --checksum opensocrates-1.2.1-claude-plugin.zip.sha256
325
+ --asset opensocrates-1.3.0-claude-plugin.zip \
326
+ --checksum opensocrates-1.3.0-claude-plugin.zip.sha256
322
327
  ```
323
328
 
324
329
  Replace `claude` with `antigravity`, `codex`, `cursor`, `grok`, or `opencode` for the matching package.
@@ -333,7 +338,7 @@ what is installed, remove it explicitly:
333
338
  ```bash
334
339
  claude plugin uninstall opensocrates@OpenSocrates --scope user
335
340
  claude plugin marketplace remove OpenSocrates --scope user
336
- npx --yes opensocrates@1.2.1 install --host claude
341
+ npx --yes opensocrates@1.3.0 install --host claude
337
342
  ```
338
343
 
339
344
  Updating a managed v1.1.0 Claude installation replaces the complete package
@@ -347,15 +352,14 @@ needs judgment, interpretation, diagnosis, explanation, planning, evidence
347
352
  reconciliation, or another structured reasoning process. On Claude/Codex
348
353
  native-runtime surfaces it:
349
354
 
350
- 1. starts a fresh, non-persistent selector in the current host;
351
- 2. chooses from the authored 48-system catalog;
352
- 3. writes the complete selected content to an owner-only Markdown file;
353
- 4. adds a bounded hidden context message that leads with teacher questions to
354
- settle, then each method ID, content revision, and, when they fit, its exact
355
- `Do not use when` and `Stop conditions`; and
356
- 5. requires the active task to read the complete file before applying the
357
- method and to end a grounded response with an exact audit line such as
358
- `OpenSocrates grounding: triangulation@1`.
355
+ 1. emits lightweight native discovery guidance without choosing an initial method;
356
+ 2. lets the active agent retrieve eligible complete methods when a judgment changes;
357
+ 3. preserves goals, permissions, evidence/stop requirements and requested output;
358
+ 4. offers Guided locale-specific presentation rules without rewriting protected content; and
359
+ 5. distinguishes delivery and agent-reported availability from actual application.
360
+
361
+ Use the installed launcher with `decision codex --stream` for a persistent volatile
362
+ lookup session; a new process or context must not inherit an old read assertion.
359
363
 
360
364
  On OpenCode, the dependency-free stable hook instead selects locally and
361
365
  injects one complete authored procedure directly into the same message turn.
@@ -371,11 +375,14 @@ using the rest as a check. These content-only paths make no OpenSocrates hook
371
375
  delivery claim.
372
376
 
373
377
  After installing for Codex, open one interactive Codex session and approve the
374
- OpenSocrates hooks before relying on automatic selection. Until that one-time
378
+ OpenSocrates hooks before relying on native discovery guidance. Until that one-time
375
379
  approval, non-interactive surfaces such as `codex exec` may silently continue
376
380
  without running the untrusted hooks.
377
381
 
378
- Claude hook surfaces prefer an owner-only `.opensocrates` artifact area inside
382
+ ### Retained legacy receipt adapter
383
+
384
+ The following describes the compatibility selector path, not the v1.3 default
385
+ discovery-only hook. In that legacy path, Claude hook surfaces prefer an owner-only `.opensocrates` artifact area inside
379
386
  the current workspace so Claude can read the selected content without an extra
380
387
  directory permission. Its self-contained `.gitignore` keeps the area out of
381
388
  `git status`; files are removed on turn/session cleanup. If the workspace is
@@ -566,3 +573,5 @@ license notice are preserved.
566
573
 
567
574
  OpenSocrates is an independent open-source project and is not affiliated with
568
575
  or endorsed by Anthropic or OpenAI.
576
+
577
+ Chat standalone export: **archive contract validated; live activation unvalidated.**
package/SECURITY.md CHANGED
@@ -34,6 +34,17 @@ severity, and the availability of a safe fix.
34
34
 
35
35
  ## Security boundary
36
36
 
37
+ The v1.3 default Claude/Codex submission entry emits discovery guidance only. It
38
+ selects no initial method, starts no selector model call and creates no grounding
39
+ artifact that an abandoned candidate must read at Stop. The decision command
40
+ loads fixed canonical content, keeps only volatile context-scoped delivery
41
+ identities and agent availability assertions, and never claims applied reasoning
42
+ from an assertion. It does not use CWD-controlled fallback content when its fixed
43
+ package/source content pair is absent. No disk state, raw prompt, conversation,
44
+ reasoning, screenshot, authentication call or telemetry is added by that command.
45
+ The selector and native receipt details below describe retained compatibility
46
+ adapters; they must not be presented as observations made by the new default path.
47
+
37
48
  OpenSocrates 1.x:
38
49
 
39
50
  - runs its integration locally through Claude or Codex and uses the user's
package/VERSION CHANGED
@@ -1 +1 @@
1
- 1.2.1
1
+ 1.3.0
package/installer/opensocrates.mjs CHANGED
@@ -34,7 +34,7 @@ import { Readable } from "node:stream";
34
34
  import { pipeline } from "node:stream/promises";
35
35
  import { fileURLToPath } from "node:url";
36
36
 
37
- export const PRODUCT_VERSION = "1.2.1";
37
+ export const PRODUCT_VERSION = "1.3.0";
38
38
  export const REPOSITORY = "ParkerHwang/OpenSocrates";
39
39
  export const MARKETPLACE_NAME = "opensocrates";
40
40
  export const PLUGIN_NAME = "opensocrates";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "opensocrates",
3
- "version": "1.2.1",
3
+ "version": "1.3.0",
4
4
  "description": "Install and manage OpenSocrates for Antigravity, Claude Code, Cowork, Codex, Cursor, Grok Build, and OpenCode.",
5
5
  "type": "module",
6
6
  "bin": {