opensocrates 1.3.1 → 1.5.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 (9) hide show
  1. package/CHANGELOG.md +60 -0
  2. package/README.ko.md +90 -82
  3. package/README.md +93 -88
  4. package/SECURITY.md +102 -141
  5. package/VERSION +1 -1
  6. package/installer/managed-hosts.mjs +659 -0
  7. package/installer/opensocrates.mjs +686 -1362
  8. package/installer/windows.ps1 +164 -0
  9. package/package.json +7 -12
package/CHANGELOG.md CHANGED
@@ -1,5 +1,65 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.5.0] - 2026-10-10
4
+
5
+ - Preserve the v1.4 Codex baseline and all 48 authored reasoning methods with
6
+ complete English/Korean procedures. Add reader guidance for source
7
+ reconciliation, stakeholder context, decisions and useful messages.
8
+ - Add bounded, stateless native Claude Code entry on Apple-silicon Mac, a separate
9
+ executable-free Claude account skill ZIP, and modular Antigravity conversation
10
+ application rules/skills on Apple-silicon Mac and Windows x64.
11
+ - Support Claude web Chat, Desktop Chat and Cowork through account ZIP
12
+ verification/export on Mac and Windows. Upload and activation remain separate
13
+ account UI operations. Native Windows Claude Code is outside the release scope.
14
+ - Add owned native Claude/Antigravity install, update, status, diagnose, disable,
15
+ enable and remove; preserve disabled state on update. Add Windows owner/DACL,
16
+ ancestor protection, reparse refusal, safe ZIP extraction and recoverable rollback,
17
+ native filesystem regressions, portable 0644 archive modes and Windows SBOM/CI.
18
+ - Unify conditional attribution across profiles as the exact final line
19
+ `Powered by OpenSocrates`. Require an eligible authored method to be read in
20
+ full and actually applied; reader guidance alone and mechanical work do not
21
+ qualify. Keep structured method identities/revisions, read receipts and repair
22
+ behavior unchanged. Attribution does not prove native application or better results.
23
+ - Publish version-pinned installation/update guides for Mac and Windows.
24
+ The default and `--host all` still select Codex; new profiles require an explicit
25
+ host and have no purge, trust-reset or automatic-update route.
26
+ - Tighten EN/KO reader guidance for absent source mentions, settled follow-up
27
+ facts, persistent unknowns and unauthorized draft commitments. Preserve dated
28
+ observations; source checks do not regrade historical outcomes or establish
29
+ universal quality, token-cost or latency gains.
30
+ - v1.4 Codex와 정본 사고 방법 48개·영어·한국어 전체 절차를 유지하고, 자료·
31
+ 이해관계자 맥락·판단·메시지를 위한 독자 안내를 추가합니다. Apple Silicon
32
+ Mac의 Claude Code 네이티브 연동, Mac·Windows의 계정 ZIP 검증·내보내기,
33
+ Mac·Windows x64의 Antigravity 작업공간·전역 설치 상태 관리를 제공합니다.
34
+ - Windows Claude Code 네이티브 연동은 이번 범위에서 제외합니다. 계정 업로드·
35
+ 활성화는 계정 화면에서 별도로 진행합니다. 업데이트는 비활성화 상태를
36
+ 유지하며 기본값과 `--host all`은 계속 Codex를 선택합니다.
37
+ - 정본 전체를 읽은 적격한 방법을 실제로 적용했을 때만 마지막에
38
+ `Powered by OpenSocrates`를 그대로 표시합니다. 독자 안내만 사용하거나
39
+ 기계적인 작업만 했다면 표시하지 않으며, 문구 자체는 적용 증명이 아닙니다.
40
+ 과거 관찰은 당시 결과로 보존하고 일반적인 품질·비용·속도 향상은 주장하지 않습니다.
41
+
42
+ ## [1.4.0] - 2026-09-16
43
+
44
+ - Focus OpenSocrates on Codex only. Remove Claude Code/Cowork/Chat,
45
+ Antigravity, Cursor, Grok Build and OpenCode runtime adapters, selectors,
46
+ templates, install choices and release archives. `--host all` now means Codex.
47
+ - Preserve the 48 authored methods, all English/Korean procedures, native Codex
48
+ hooks, integrity checks, safe lifecycle rollback and explicit trust reset.
49
+ - Reject retired-host desired state without changing it. Use the previous
50
+ installer version to remove retired integrations before updating Codex.
51
+ - Codex 전용으로 전환하며 다른 호스트 연동과 배포 파일을 제거합니다. 48개 사고
52
+ 방법과 영어·한국어 절차, 무결성·롤백·훅 신뢰 경계는 유지합니다. 이전 버전의
53
+ 다른 호스트 설치는 해당 버전으로 제거한 다음 Codex를 업데이트해야 합니다.
54
+
55
+ - Add native Windows x64 runtime archives, Node launcher and Windows CI builds.
56
+ - Preserve SHA-256 inventories; reject Windows ZIP aliases, traversal and links before extraction.
57
+ - Validate Windows owner ACLs, binary I/O, file locks and explicit manual-update behavior.
58
+ - Keep macOS release gates; distinguish native package tests from authenticated host and Desktop delivery.
59
+ - Windows x64 네이티브 배포·런처·CI, ACL·바이너리 입출력·잠금·ZIP 검사를 추가합니다. 자동 업데이트는 수동 실행 안내로 명시하며 실제 호스트와 Desktop 검증 범위를 구분합니다.
60
+
61
+ See [Windows support](docs/windows-support.md) / [Windows 안내](docs/windows-support.ko.md).
62
+
3
63
  ## [1.3.0] - 2026-09-08
4
64
 
5
65
  - Add agent-directed method retrieval at decision points within an existing turn,
package/README.ko.md CHANGED
@@ -4,112 +4,120 @@
4
4
 
5
5
  # OpenSocrates
6
6
 
7
- **에이전트가 지금 내리는 판단에 맞는 사고 방법.**
7
+ **이해하고 판단하고 사용할 수 있는 결과를 위한 사고 지원.**
8
8
 
9
- OpenSocrates는 Claude, Codex, OpenCode, Grok Build, Cursor, Google Antigravity에서
10
- 48개의 정본 사고 방법을 사용할 수 있게 합니다. 평소 쓰는 에이전트 안에서
11
- 가정을 점검하고, 대안을 비교하고, 근거를 평가할 때 활용할 수 있습니다.
9
+ OpenSocrates는 진행 중인 작업에 직접 작성한 48개 사고 방법을 제공합니다.
10
+ 자료를 종합하고, 이해관계자의 관점을 파악하고, 선택지를 비교하고, 필요한
11
+ 메시지를 쓰도록 돕습니다. 원래 영어·한국어 절차는 그대로 유지합니다.
12
+ v1.5의 독자 안내는 결론을 맥락과 다음 행동에 연결합니다. 코딩 전문가 전용
13
+ 기능은 이번 버전에 포함하지 않습니다.
12
14
 
13
15
  [English](README.md) | **한국어**
14
16
 
15
17
  [![CI](https://github.com/ParkerHwang/OpenSocrates/actions/workflows/ci.yml/badge.svg)](https://github.com/ParkerHwang/OpenSocrates/actions/workflows/ci.yml)
16
18
  [![npm](https://img.shields.io/npm/v/opensocrates)](https://www.npmjs.com/package/opensocrates)
17
- [![Release](https://img.shields.io/github/v/release/ParkerHwang/OpenSocrates)](https://github.com/ParkerHwang/OpenSocrates/releases)
18
19
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
19
20
 
20
- [웹사이트](https://opensocrates.parker-j-hwang.chatgpt.site) ·
21
- [v1.3.1 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.3.1) ·
22
- [설치 상세 안내](docs/advanced-usage.ko.md)
21
+ ## Mac과 Windows에서 쓰는 v1.5.0
23
22
 
24
- ## 시작하기
23
+ v1.5.0은 Codex를 유지하면서 Apple Silicon Mac의 Claude Code 네이티브 연동,
24
+ 휴대 가능한 Claude 계정 스킬, Mac·Windows x64의 Antigravity 작업공간·전역
25
+ 규칙과 스킬을 추가합니다. 배포 파일과 SHA-256 파일은
26
+ [v1.5.0 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.0)에서
27
+ 받거나 [npm 설치기](https://www.npmjs.com/package/opensocrates/v/1.5.0)를 사용하세요.
25
28
 
26
- 먼저 호스트에 로그인하고 CLI를 사용할 수 있게 준비하세요. Node.js 20 이상이
27
- 필요합니다. 배포된 네이티브 런타임은 **Apple Silicon macOS**를 지원합니다.
28
- 다른 플랫폼에서 설치하려면 호스트별 지원 문서를 먼저 확인하세요.
29
+ | 호스트 | 전달 방식 | 플랫폼과 활성화 |
30
+ | --- | --- | --- |
31
+ | Codex | 기존 훅·컨트롤러·네이티브 판단 런타임 | Apple Silicon Mac·Windows x64; 대화형 세션에서 훅 7개 검토 |
32
+ | Claude Code CLI / Desktop의 로컬 Code | 상태를 저장하지 않는 네이티브 진입과 설치된 전체 참조 | Apple Silicon Mac; Claude CLI·호스트 로그인·플러그인과 훅 권한 필요 |
33
+ | Claude 웹 / Desktop Chat / Cowork | 실행 코드가 없는 독립 계정 스킬 ZIP | Mac·Windows에서 내보낸 뒤 계정의 Skills 화면에서 업로드·활성화 |
34
+ | Antigravity 대화 애플리케이션 | 소유 범위가 명확한 모듈형 규칙과 스킬 | Apple Silicon Mac·Windows x64; 작업공간 또는 전역 선택 |
35
+
36
+ Windows 터미널이나 Desktop Code의 Claude Code 네이티브 연동은 이번 릴리스
37
+ 범위에서 제외합니다. 계정 콘텐츠는 네이티브 Claude 연동을 설치하지 않습니다.
38
+ [Mac 안내](docs/macos-v1.5.ko.md)와 [Windows 안내](docs/windows-v1.5.ko.md)를 참고하세요.
39
+
40
+ 매번 OpenSocrates 명령을 입력할 필요는 없습니다. 신뢰된 네이티브 훅과
41
+ Antigravity 상시 규칙은 진입 안내를 제공합니다. 계정 스킬은 호스트 모델이
42
+ 선택하므로 호출되지 않을 수 있습니다. 설치·불러오기·전체 읽기·실제 적용·
43
+ 결과의 유용성은 서로 다른 증거이며, 일반적인 품질·토큰 비용·속도 향상을
44
+ 주장하지 않습니다.
45
+
46
+ ## 설치 또는 업데이트
47
+
48
+ Node.js 20 이상과 사용할 호스트를 설치하고 그 호스트에 로그인하세요.
49
+ 네이티브 런타임은 포함되어 있으므로 설치에 Python이 필요하지 않습니다.
50
+ 지원하는 두 플랫폼에서 Codex를 설치하는 예입니다.
51
+
52
+ ```sh
53
+ npx --yes opensocrates@1.5.0 install --host codex
54
+ npx --yes opensocrates@1.5.0 status --host codex
55
+ ```
56
+
57
+ 기존 v1.4 Codex 설치는 다음 명령으로 업데이트합니다.
29
58
 
30
59
  ```sh
31
- # 지원되는 호스트 중 준비된 호스트에 모두 설치
32
- npx --yes opensocrates@1.3.1 install --host all
60
+ npx --yes opensocrates@1.5.0 update --host codex
61
+ ```
62
+
63
+ 대화형 세션에서 Codex 훅 7개를 검토하고 새 대화를 시작하세요. 비대화형 실행은
64
+ 신뢰되지 않은 훅을 건너뛸 수 있습니다. `status`는 설치와 무결성을 보고하며
65
+ 자동 전달을 증명하지 않습니다.
66
+
67
+ Apple Silicon Mac에서는 Claude 네이티브 연동을 설치할 수 있습니다.
33
68
 
34
- # 또는 호스트 하나를 지정
35
- npx --yes opensocrates@1.3.1 install --host codex
36
- npx --yes opensocrates@1.3.1 install --host claude
69
+ ```sh
70
+ npx --yes opensocrates@1.5.0 install --host claude
71
+ npx --yes opensocrates@1.5.0 status --host claude
37
72
  ```
38
73
 
39
- 설치 후 새 작업을 시작하세요. Codex에서는 대화형 세션에서 OpenSocrates 훅을
40
- 승인해야 네이티브 탐색 안내를 사용할 수 있습니다. 호스트의 기존 로그인과 모델
41
- 제공자 설정을 사용하며, 별도의 OpenSocrates 계정이나 API 키는 필요하지 않습니다.
74
+ Antigravity는 이미 존재하는 작업공간의 절대 경로를 선택합니다.
42
75
 
43
- 이미 설치했다면 다음 명령으로 업데이트하고 상태를 확인할 수 있습니다.
76
+ ```sh
77
+ npx --yes opensocrates@1.5.0 install --host antigravity --workspace /absolute/path/to/workspace
78
+ ```
79
+
80
+ Windows에서는 `C:\Work\Reading Workshop`처럼 로컬 드라이브의 절대 경로로
81
+ 바꾸고 따옴표로 감싸세요. `--workspace`를 생략하면 전역 범위를 선택합니다.
82
+ Claude 계정 콘텐츠는 이미 존재하는 폴더의 절대 ZIP 경로로 내보낸 뒤,
83
+ Claude의 Customize > Skills 화면에서 업로드하고 활성화합니다.
44
84
 
45
85
  ```sh
46
- npx --yes opensocrates@1.3.1 update --host all
47
- npx --yes opensocrates@1.3.1 status --host all
86
+ npx --yes opensocrates@1.5.0 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.0-account.zip
48
87
  ```
49
88
 
50
- ## 하는 일
89
+ 플랫폼별 안내에는 Windows 경로, 계정 스킬 교체, 업데이트·비활성화·제거와
90
+ 검증한 로컬 파일 사용법을 설명합니다. 로컬 파일 옵션을 생략하면 설치기는
91
+ GitHub Releases에서 버전을 고정한 v1.5.0 ZIP과 체크섬을 받습니다.
51
92
 
52
- - **판단에 맞는 방법을 선택합니다.** 대안을 비교하거나, 인과관계 주장과 가정을
53
- 점검하거나, 추천을 바꿀 근거가 무엇인지 검토합니다.
54
- - **근거가 바뀌면 결정을 다시 검토합니다.** v1.3.1은 한 요청 안의 여러 결정
55
- 지점에서 방법을 조회할 수 있습니다. 기계적인 단계에는 방법이 필요하지 않습니다.
56
- - **절차 전체를 읽습니다.** 각 방법에는 영어·한국어 지침, 예시, 적용 한계와
57
- 필수 공개 결과가 함께 있습니다.
58
- - **결론과 근거를 연결합니다.** 작성 안내는 불확실성, 권한과 사용자 형식을
59
- 보존하며, 서로 다른 질문의 결론과 재검토 조건을 구분하도록 합니다.
93
+ 새 연동에는 `--host claude`, `--host antigravity`, `--host claude-chat`를
94
+ 명시해야 합니다. 기본값과 `--host all`은 계속 Codex를 선택하며 새 호스트를
95
+ 전부 설치하지 않습니다. 새 연동에는 purge, 신뢰 초기화, 자동 업데이트가 없습니다.
60
96
 
61
- 예를 들어 정해진 예산 안에서 두 공급업체를 비교하거나, 새 감사 결과를 반영해
62
- 추천을 다시 검토하거나, 소규모 파일럿으로 알 수 있는 것과 아직 모르는 것을
63
- 구분하도록 요청할 수 있습니다. 이는 사용 예시이며 측정된 성과를 보장하지 않습니다.
97
+ 과거 여러 호스트 연동을 자동으로 인수하거나 삭제하지 않습니다. 새 설치 전에
98
+ 정확한 출처와 소유 범위를 확인하세요. 기존 OpenSocrates 계정 스킬은 교체 전에
99
+ 백업하고 활성화 상태를 보존합니다.
64
100
 
65
- ## v1.3.1의 동작 방식
101
+ ## 사용 표기가 나오는 조건
66
102
 
67
- Claude/Codex 훅은 가벼운 탐색 안내를 제공합니다. 이후 작업 중인 에이전트가
68
- 패키지의 네이티브 선택기로 적합한 방법 전체를 필요할 때 조회합니다. 런타임을
69
- 사용할 수 없으면 같은 제약을 유지하는 참조 파일 경로를 사용합니다. 다른 호스트의
70
- 전달 방식은 아래와 같습니다. 연동을 사용할 수 없으면 일반 작업을 계속할 수 있습니다.
103
+ 적격한 사고 방법의 정본 전체를 읽고 현재 답변에 실제로 적용했을 때만 답변
104
+ 마지막에 `Powered by OpenSocrates`를 한 줄로 그대로 표시합니다. 영어·한국어에서
105
+ 같은 문구를 사용합니다. 독자 안내만 사용하거나 기계적인 작업만 했다면 표시하지
106
+ 않습니다. 이 문구는 출처 표기이며 네이티브 적용이나 더 나은 결과의 증명은 아닙니다.
71
107
 
72
- 이번 릴리스는 **48개 방법과 96개 영어·한국어 절차 본문**을 그대로 유지합니다.
73
- 작성 정책은 안내이며 자동으로 답변을 다시 쓰는 기능은 아닙니다. 선택·폴백·방법
74
- 가용성의 정확한 계약은 [결정 지점 조회와 이전 안내](docs/decision-points.ko.md)에 있습니다.
108
+ ## 개인정보와 개발
75
109
 
76
- ## 지원 호스트
110
+ 기본 판단 경로는 별도의 선택 모델을 호출하거나 원시 프롬프트·대화·스크린샷·
111
+ 숨겨진 추론을 저장하지 않습니다. Claude 네이티브 진입은 대화를 읽거나
112
+ 데이터베이스를 초기화하지 않습니다. 계정 스킬에는 실행 코드가 없습니다.
113
+ 일반 대화와 모델 요청은 호스트 자체의 인증·권한·보관 설정·약관을 따릅니다.
114
+ [보안 정책](SECURITY.md)에 정확한 경계를 설명합니다.
77
115
 
78
- | 호스트 | 전달 방식과 시작점 | 상세 안내 |
79
- | --- | --- | --- |
80
- | Claude Code / Cowork | 훅이 실행되는 환경에서 플러그인 탐색; `/opensocrates:opensocrates` | [Claude 지원](docs/decision-points.md) |
81
- | Codex CLI / Desktop | 훅 승인 후 탐색; `opensocrates` 컨트롤러 | [전달 방식](docs/decision-points.ko.md) |
82
- | OpenCode | 같은 턴의 로컬 브리지; 네이티브 스킬 폴백 | [OpenCode 지원](docs/opencode-support.md) |
83
- | Grok Build | 네이티브 스킬 선택 또는 `/opensocrates` | [Grok 지원](docs/grok-support.md) |
84
- | Cursor | Agent Plugin 스킬 탐색 또는 명시적 호출 | [Cursor 지원](docs/cursor-support.md) |
85
- | Google Antigravity | 명시적 콘텐츠 스킬 호출 | [Antigravity 지원](docs/antigravity-support.md) |
86
-
87
- Claude 웹과 Desktop Chat은 로컬 플러그인 훅 대신 **별도의 독립형 스킬 ZIP**을
88
- 사용합니다. [v1.3.1 릴리스](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.3.1)에서
89
- 다운로드한 뒤 [Chat 설치 안내](docs/claude-chat-upload-probe.md)를 따르세요.
90
-
91
- Chat 독립형 내보내기: **아카이브 계약 검증, 실제 활성화 미검증.**
92
-
93
- ## 개인정보와 지원 범위
94
-
95
- 연동은 로컬에서 실행되고 제품 텔레메트리나 OpenSocrates 서버를 추가하지 않습니다.
96
- 모델 요청에는 선택한 호스트 서비스의 약관이 적용되며, 별도의 OpenSocrates 계정은
97
- 필요하지 않습니다. 호스트의 신뢰 경계와 유지된 이전 어댑터의 동작은
98
- [SECURITY.md](SECURITY.md)에서 확인할 수 있습니다.
99
-
100
- v1.3.1은 여러 줄 decision 입력을 수정하고 출시 전에 패키지 예제를 검사합니다. 패키지 검증만으로
101
- 모든 호스트의 실사용 동작이나 모델의 실제 방법 적용까지 확인한 것은 아닙니다.
102
- 합성 시험에는 최종 응답 시간 초과와 반복적인 문장이 있었으며, 전반적인 품질·
103
- 자연스러움·토큰 비용·응답 시간 개선을 주장하지 않습니다. 전체 [릴리스 근거](docs/v1.3.1-release.md)와
104
- [배포 검증 기록](https://github.com/ParkerHwang/OpenSocrates/pull/92)에 결과와 한계를 보존했습니다.
105
-
106
- ## 더 알아보기
107
-
108
- - [설치·업데이트·삭제·런타임 상세 안내](docs/advanced-usage.ko.md)
109
- - [정본 방법 카탈로그](content/methods/)
110
- - [변경 기록](CHANGELOG.md)
111
- - [기여와 개발 검사](CONTRIBUTING.md)
112
- - [행동 강령](CODE_OF_CONDUCT.md)
113
-
114
- OpenSocrates는 [MIT 라이선스](LICENSE)의 독립 오픈소스 프로젝트이며,
115
- 지원하는 호스트 제공자와 제휴하거나 그들의 보증을 받지 않습니다.
116
+ - [Mac 설치와 증거의 범위](docs/macos-v1.5.ko.md)
117
+ - [Windows 설치와 증거의 범위](docs/windows-v1.5.ko.md)
118
+ - [사고 방법 원문](content/methods/) · [판단 지점 계약](docs/decision-points.ko.md)
119
+ - [구현 범위](docs/v1.5.0/IMPLEMENTATION_PLAN.md)
120
+ - [변경 이력](CHANGELOG.md) · [기여 안내](CONTRIBUTING.md) · [행동 강령](CODE_OF_CONDUCT.md)
121
+
122
+ OpenSocrates는 [MIT 라이선스](LICENSE)를 따르는 독립 프로젝트이며
123
+ OpenAI·Anthropic·Google의 공식 제품이나 보증을 받은 제품이 아닙니다.
package/README.md CHANGED
@@ -4,118 +4,123 @@
4
4
 
5
5
  # OpenSocrates
6
6
 
7
- **A method for the judgment your agent is making.**
7
+ **Reasoning help for results you can understand, judge, and use.**
8
8
 
9
- OpenSocrates brings 48 authored reasoning methods to Claude, Codex, OpenCode,
10
- Grok Build, Cursor and Google Antigravity. Use it to examine assumptions, compare
11
- options and weigh evidence while you work in your existing agent.
9
+ OpenSocrates brings 48 authored reasoning methods into the task you are already
10
+ doing: synthesize evidence, understand stakeholder perspectives, compare choices,
11
+ and write useful messages. The original English/Korean procedures remain intact.
12
+ The v1.5 reader guides connect conclusions to context and next actions;
13
+ dedicated coding-specialist features are outside this version.
12
14
 
13
15
  **English** | [한국어](README.ko.md)
14
16
 
15
17
  [![CI](https://github.com/ParkerHwang/OpenSocrates/actions/workflows/ci.yml/badge.svg)](https://github.com/ParkerHwang/OpenSocrates/actions/workflows/ci.yml)
16
18
  [![npm](https://img.shields.io/npm/v/opensocrates)](https://www.npmjs.com/package/opensocrates)
17
- [![Release](https://img.shields.io/github/v/release/ParkerHwang/OpenSocrates)](https://github.com/ParkerHwang/OpenSocrates/releases)
18
19
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
19
20
 
20
- [Website](https://opensocrates.parker-j-hwang.chatgpt.site) ·
21
- [v1.3.1 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.3.1) ·
22
- [Installation reference](docs/advanced-usage.md)
21
+ ## v1.5.0 on Mac and Windows
23
22
 
24
- ## Get started
23
+ Version 1.5.0 preserves Codex and adds native Claude Code on Apple-silicon Mac,
24
+ a portable Claude account skill, and Antigravity workspace/global rules and
25
+ skills on Mac and Windows x64. Download archives and SHA-256 files from the
26
+ [v1.5.0 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.5.0),
27
+ or use the [npm installer](https://www.npmjs.com/package/opensocrates/v/1.5.0).
25
28
 
26
- Sign in to your host and make its CLI available. You need Node.js 20 or later.
27
- The distributed native runtimes support **Apple-silicon macOS**; see each host's
28
- support documentation before installing on another platform.
29
+ | Host | Delivery | Platform and activation |
30
+ | --- | --- | --- |
31
+ | Codex | Existing hooks, controller and native decision runtime | Apple-silicon Mac and Windows x64; review the seven hooks in an interactive session |
32
+ | Claude Code CLI / Desktop local Code | Stateless native entry and complete installed references | Apple-silicon Mac; requires the Claude CLI, host login and plugin/hook permissions |
33
+ | Claude web / Desktop Chat / Cowork | Standalone content-only account skill ZIP | Export on Mac or Windows; upload and enable through the account's Skills interface |
34
+ | Antigravity conversation application | Owned modular rule and skill | Apple-silicon Mac and Windows x64; choose workspace or global scope |
35
+
36
+ Windows native Claude Code in a terminal or Desktop Code is outside this
37
+ release's scope. Account content does not install a native Claude integration.
38
+ See the [Mac guide](docs/macos-v1.5.md) and [Windows guide](docs/windows-v1.5.md).
39
+
40
+ Normal requests need no repeated OpenSocrates command. Trusted native hooks and
41
+ Antigravity's standing rule provide entry; account skills are selected by the
42
+ host model and may be missed. Installation, loading, complete reads, application,
43
+ and useful outcomes are separate evidence levels. No general quality, token-cost,
44
+ or latency improvement is claimed.
45
+
46
+ ## Install or update
47
+
48
+ Install Node.js 20+, make the chosen host available, and sign in to that host.
49
+ Native runtimes are bundled; installation does not require Python. Start with
50
+ Codex on either supported platform:
51
+
52
+ ```sh
53
+ npx --yes opensocrates@1.5.0 install --host codex
54
+ npx --yes opensocrates@1.5.0 status --host codex
55
+ ```
56
+
57
+ For an existing v1.4 Codex installation, use:
29
58
 
30
59
  ```sh
31
- # Install for every supported, ready host
32
- npx --yes opensocrates@1.3.1 install --host all
60
+ npx --yes opensocrates@1.5.0 update --host codex
61
+ ```
62
+
63
+ Review the seven Codex hooks in an interactive session and start a fresh
64
+ conversation. Non-interactive execution may skip untrusted hooks. `status`
65
+ reports installation and integrity; it does not prove automatic delivery.
66
+
67
+ On Apple-silicon Mac, install the native Claude companion with:
33
68
 
34
- # Or choose one host
35
- npx --yes opensocrates@1.3.1 install --host codex
36
- npx --yes opensocrates@1.3.1 install --host claude
69
+ ```sh
70
+ npx --yes opensocrates@1.5.0 install --host claude
71
+ npx --yes opensocrates@1.5.0 status --host claude
37
72
  ```
38
73
 
39
- Start a new task after installation. In Codex, approve the OpenSocrates hooks in
40
- an interactive session before relying on native discovery. OpenSocrates uses your
41
- host's existing authentication and provider configuration; it needs no separate
42
- OpenSocrates account or API key.
74
+ For Antigravity, choose an existing absolute workspace directory:
43
75
 
44
- For an existing installation:
76
+ ```sh
77
+ npx --yes opensocrates@1.5.0 install --host antigravity --workspace /absolute/path/to/workspace
78
+ ```
79
+
80
+ On Windows, replace the directory with an absolute local-drive path such as
81
+ `C:\Work\Reading Workshop` and quote it. Omit `--workspace` for the global scope.
82
+ For Claude account content, export to an absolute ZIP filename in an existing
83
+ folder, then upload and enable the ZIP in Claude's Customize > Skills interface:
45
84
 
46
85
  ```sh
47
- npx --yes opensocrates@1.3.1 update --host all
48
- npx --yes opensocrates@1.3.1 status --host all
86
+ npx --yes opensocrates@1.5.0 export --host claude-chat --output /absolute/path/to/opensocrates-1.5.0-account.zip
49
87
  ```
50
88
 
51
- ## What it does
89
+ The platform guides cover Windows paths, account replacement, updates, disabling,
90
+ removal, and verified local-archive alternatives. With no local asset flags,
91
+ the installer downloads the pinned v1.5.0 archive and checksum from GitHub Releases.
52
92
 
53
- - **Choose a method for a judgment.** Compare alternatives, check a causal claim,
54
- examine assumptions or decide which evidence would change a recommendation.
55
- - **Revisit a decision when the facts change.** v1.3.1 supports method retrieval
56
- at multiple decision points within one request. Mechanical steps need no method.
57
- - **Read the complete procedure.** Each method has authored instructions,
58
- examples, applicability limits and required public results, in English and Korean.
59
- - **Keep the answer connected to its evidence.** Guided writing instructions
60
- preserve uncertainty, permissions and the user's format, with separate conclusions
61
- and reopening conditions for separate questions.
93
+ New profiles require explicit `--host claude`, `--host antigravity`, or
94
+ `--host claude-chat`. The default and `--host all` continue to select Codex;
95
+ they do not install every new host. New profiles have no purge, trust-reset,
96
+ or automatic-update route.
62
97
 
63
- For example, ask your agent to compare two vendors under a fixed budget, reconsider
64
- its choice after a new audit, or distinguish what a small pilot supports from what
65
- it leaves unknown. These are use cases, not measured outcome guarantees.
98
+ Old multi-host installations are not silently adopted or erased. Reconcile their
99
+ exact origin and ownership before installing a new profile. Back up an existing
100
+ OpenSocrates account skill and its enabled state before replacing it.
66
101
 
67
- ## How v1.3.1 works
102
+ ## When attribution appears
68
103
 
69
- Claude/Codex hooks provide lightweight discovery guidance. The active agent then
70
- uses the packaged native selector to retrieve eligible complete methods as needed.
71
- If the runtime is unavailable, a constrained reference-file fallback remains.
72
- Other hosts use the delivery paths below. OpenSocrates fails open when its
73
- integration is unavailable so ordinary work can continue.
104
+ A final answer ends with the exact line `Powered by OpenSocrates` only when an
105
+ eligible authored method was read in full and actually applied to that answer.
106
+ The wording is the same in English and Korean. Reader guidance alone and
107
+ mechanical work do not qualify. The line is attribution, not proof of native
108
+ application or a better result.
74
109
 
75
- The release retains all **48 methods and 96 English/Korean procedure bodies**.
76
- Its writing policy is guidance, not automatic rewriting. See
77
- [decision-point retrieval and migration](docs/decision-points.md) for the exact
78
- selection, fallback and method-availability contracts.
110
+ ## Privacy and development
79
111
 
80
- ## Supported hosts
112
+ The default decision path makes no extra selector-model call and stores no raw
113
+ prompts, transcripts, screenshots, or hidden reasoning. The native Claude entry
114
+ does not read transcripts or initialize a database. The account skill has no
115
+ executable surface; normal host conversations and model requests follow the
116
+ host's own authentication, permissions, retention settings, and terms.
117
+ See [SECURITY.md](SECURITY.md).
81
118
 
82
- | Host | Delivery and entry point | Details |
83
- | --- | --- | --- |
84
- | Claude Code / Cowork | Plugin discovery where hooks run; `/opensocrates:opensocrates` | [Claude support](docs/decision-points.md) |
85
- | Codex CLI / Desktop | Discovery after hook approval; `opensocrates` controller | [Delivery modes](docs/decision-points.md) |
86
- | OpenCode | Local same-turn bridge; native skill fallback | [OpenCode support](docs/opencode-support.md) |
87
- | Grok Build | Native skill selection or `/opensocrates` | [Grok support](docs/grok-support.md) |
88
- | Cursor | Agent Plugin skill discovery or explicit invocation | [Cursor support](docs/cursor-support.md) |
89
- | Google Antigravity | Explicit content skill | [Antigravity support](docs/antigravity-support.md) |
90
-
91
- Claude web and Desktop Chat use a **separate standalone skill ZIP**, not the local
92
- plugin hooks. Download it from the [v1.3.1 release](https://github.com/ParkerHwang/OpenSocrates/releases/tag/v1.3.1)
93
- and follow the [Chat installation guide](docs/claude-chat-upload-probe.md).
94
-
95
- Chat standalone export: **archive contract validated; live activation unvalidated.**
96
-
97
- ## Privacy and support boundaries
98
-
99
- The integration runs locally, adds no product telemetry and has no OpenSocrates
100
- backend. Model requests still use your selected host service under its terms.
101
- No separate OpenSocrates account is required. Read [SECURITY.md](SECURITY.md)
102
- for the host trust boundaries and retained legacy adapter behavior.
103
-
104
- v1.3.1 fixes multi-line decision input and checks packaged examples before release. Package verification
105
- does not establish every host's live behavior or the model's actual application
106
- of a method. Synthetic tests include final-delivery timeouts and repetitive output;
107
- no general quality, naturalness, token-cost or response-time improvement is claimed.
108
- The complete [release evidence](docs/v1.3.1-release.md) and
109
- [publication verification](https://github.com/ParkerHwang/OpenSocrates/pull/92)
110
- retain the measured results and limitations.
111
-
112
- ## More information
113
-
114
- - [Detailed installation, updates, removal and runtime behavior](docs/advanced-usage.md)
115
- - [Authored method catalog](content/methods/)
116
- - [Changelog](CHANGELOG.md)
117
- - [Contributing and development checks](CONTRIBUTING.md)
118
- - [Code of Conduct](CODE_OF_CONDUCT.md)
119
-
120
- OpenSocrates is [MIT licensed](LICENSE). It is an independent open-source project,
121
- not affiliated with or endorsed by its supported host providers.
119
+ - [Mac installation and evidence boundaries](docs/macos-v1.5.md)
120
+ - [Windows installation and evidence boundaries](docs/windows-v1.5.md)
121
+ - [Authored methods](content/methods/) · [Decision-point contract](docs/decision-points.md)
122
+ - [Implementation scope](docs/v1.5.0/IMPLEMENTATION_PLAN.md)
123
+ - [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Code of Conduct](CODE_OF_CONDUCT.md)
124
+
125
+ OpenSocrates is [MIT licensed](LICENSE), independent of OpenAI, Anthropic, and
126
+ Google, and not endorsed by them.