Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions PARITY.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Python compatibility and npm migration

Updated 2026-10-09 KST. Python reference: **1.0.2**,
Updated 2026-10-12 KST. Python reference: **1.0.2**,
[`47c2371`](https://github.com/abruption/session-peer/tree/47c23713d0a2a3c11ebde6186afd8c43489b8b65/session_peer_core).
This matrix describes the **TS 0.3.3 source/package contract**: the 0.2.0 unified listing, safe home selection,
This matrix describes the **TS 0.3.4 source/package contract**: the 0.2.0 unified listing, safe home selection,
read-only doctor, text/help/positional input, Unicode 14.0.0 name matching and
separately managed TS skill guidance (#16/#17/#18/#19/#25), the
[0.2.1 reliability and hardening](#021-reliability-and-hardening) changes, and the
Expand All @@ -15,6 +15,12 @@ between releases, operators should also align reviewed commits; the wire does no
verify a source commit. `referenceVersion: "1.0.2"` identifies the comparison baseline,
not complete parity. See [VALIDATION.md](VALIDATION.md) for dated evidence.

## 0.3.4 patch preparation — 2026-10-12 KST

[PR #134](https://github.com/abruption/session-peer-ts/pull/134) corrects Windows-destination PowerShell forwarding of native exit codes for version preflight and wire requests. A missing native exit fails with 1; complete validated abnormal responses retain independent submission facts. Strict response limits, exact-version SSH, host-key checks and no automatic resend remain unchanged. This is not delivery or ACK evidence.

The four guides pin independently published TS skill 0.2.0 source `8482cf644507c682915e35c85aa3384c53864906`. The 0.3.4 candidate accepts only the same two exact reviewed profiles as public 0.3.3; 0.3.5 and unreviewed versions remain incompatible. Python reference 1.0.2 is unchanged. Draft 0.4 handoff/app-server/observation and Side Session are excluded.

## Feature and command matrix

**Implemented** means the stated bounded behavior exists. **Partial** means a
Expand Down
14 changes: 7 additions & 7 deletions README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@

<!-- docs-contract: stable-release-source; package=session-peer; bin=session-peer; node=22.13+/24; python-reference=1.0.2 -->

**文書・ソースのバージョン: 0.3.3。** インストール前に、選択したリリースとレジストリのメタデータを確認してください。日付付きの準備・検証記録は [VALIDATION.md](VALIDATION.md)、リリース手順は [RELEASING.md](RELEASING.md) にあります。SSH の両端には同じ TypeScript クライアントのバージョンが必要で、0.3.2 と 0.3.3 は互いの SSH 事前確認を拒否します。
**文書・ソースのバージョン: 0.3.4。** インストール前に、選択したリリースとレジストリのメタデータを確認してください。日付付きの準備・検証記録は [VALIDATION.md](VALIDATION.md)、リリース手順は [RELEASING.md](RELEASING.md) にあります。SSH の両端には同じ TypeScript クライアントのバージョンが必要で、0.3.3 と 0.3.4 は互いの SSH 事前確認を拒否します。

**実行中の Claude Code・Codex セッションを見つけ、ローカルまたは SSH でメッセージを送信します。**
Python 不要の Node.js クライアントです。パッケージ名とコマンド名は `session-peer` です。
Expand Down Expand Up @@ -56,15 +56,15 @@ SSH は既存の鍵・ホスト信頼設定と両端の**同じバージョン
`Get-Command session-peer -All` で PATH を確認してください。利用する実装を選び、
別の管理ツールのファイルを `--force` で上書きしないでください。

**0.3.3 のインストール:** npm の導入・更新例を実行する前に、レジストリで公開状況と選択したリリースを確認してください。利用できない場合は[レビュー済みソースビルド](docs/guide.ja.md#ソースからビルド)を使います。
**0.3.4 のインストール:** npm の導入・更新例を実行する前に、レジストリで公開状況と選択したリリースを確認してください。利用できない場合は[レビュー済みソースビルド](docs/guide.ja.md#ソースからビルド)を使います。

```sh
npm view session-peer@0.3.3 version dist.integrity
npm install --global --ignore-scripts session-peer@0.3.3
npm view session-peer@0.3.4 version dist.integrity
npm install --global --ignore-scripts session-peer@0.3.4
session-peer --version
```

期待する出力: `session-peer 0.3.3 (typescript)`。分離インストール・ソースビルド・
期待する出力: `session-peer 0.3.4 (typescript)`。分離インストール・ソースビルド・
Windows・削除の手順は以下の詳細ガイドを参照してください。

任意の `sp` 短縮名は 0.3.0 以降に含まれ(0.2.1 以前にはありません)、自動では有効になりません。
Expand All @@ -73,12 +73,12 @@ Windows・削除の手順は以下の詳細ガイドを参照してください
### Update

npm で導入したクライアントは npm で更新します。タグと対象バージョンを確認してから
正確なバージョンを指定してください。以下は古い npm 版を公開済みの 0.3.3 に更新する例です。
正確なバージョンを指定してください。以下は古い npm 版を選択した 0.3.4 に更新する例です。
CLI は更新をインストールせず、`session-peer update --check` は確認のみ行います。

```sh
npm view session-peer dist-tags
npm install --global --ignore-scripts session-peer@0.3.3
npm install --global --ignore-scripts session-peer@0.3.4
session-peer --version
```

Expand Down
14 changes: 7 additions & 7 deletions README.ko.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Python을 설치하지 않아도 Node.js에서 실행되는 TypeScript 클라이

<!-- docs-contract: stable-release-source; package=session-peer; bin=session-peer; node=22.13+/24; python-reference=1.0.2 -->

**문서·소스 기준 버전: 0.3.3.** 설치 전에 선택한 릴리스와 레지스트리 메타데이터를 확인하세요. 날짜별 준비·검증 기록은 [VALIDATION.md](VALIDATION.md), 릴리스 절차는 [RELEASING.md](RELEASING.md)에 있습니다. SSH 양쪽에는 같은 TypeScript 클라이언트 버전이 필요하며, 0.3.2와 0.3.3은 서로의 SSH 사전 확인을 거부합니다.
**문서·소스 기준 버전: 0.3.4.** 설치 전에 선택한 릴리스와 레지스트리 메타데이터를 확인하세요. 날짜별 준비·검증 기록은 [VALIDATION.md](VALIDATION.md), 릴리스 절차는 [RELEASING.md](RELEASING.md)에 있습니다. SSH 양쪽에는 같은 TypeScript 클라이언트 버전이 필요하며, 0.3.3과 0.3.4는 서로의 SSH 사전 확인을 거부합니다.

<a id="demo"></a>
## 시연
Expand Down Expand Up @@ -65,15 +65,15 @@ PowerShell에서는 `Get-Command session-peer -All`로 PATH(명령 검색 경로
실행 파일을 찾는지 확인하세요. 사용할 구현을 선택하고 다른 패키지 관리자가 설치한
파일을 `--force`로 덮어쓰지 마세요. 설치와 갱신은 사용자가 npm으로 직접 수행합니다.

**0.3.3 설치:** npm 설치·업데이트 예시를 실행하기 전에 레지스트리 제공 여부와 선택한 릴리스를 확인하세요. 해당 버전이 제공되지 않으면 [검토한 소스 빌드](docs/guide.ko.md#소스에서-빌드)를 사용하세요.
**0.3.4 설치:** npm 설치·업데이트 예시를 실행하기 전에 레지스트리 제공 여부와 선택한 릴리스를 확인하세요. 해당 버전이 제공되지 않으면 [검토한 소스 빌드](docs/guide.ko.md#소스에서-빌드)를 사용하세요.

```sh
npm view session-peer@0.3.3 version dist.integrity
npm install --global --ignore-scripts session-peer@0.3.3
npm view session-peer@0.3.4 version dist.integrity
npm install --global --ignore-scripts session-peer@0.3.4
session-peer --version
```

예상 결과는 `session-peer 0.3.3 (typescript)`입니다. 별도 경로에 설치하거나,
예상 결과는 `session-peer 0.3.4 (typescript)`입니다. 별도 경로에 설치하거나,
소스에서 빌드하거나, Windows에서 설치·제거하는 방법은 [사용자 가이드](docs/guide.ko.md#설치)를 참고하세요.

선택 사항인 `sp` 단축 명령은 0.3.0 이상에 포함되며(0.2.1 이하에는 없음) 자동으로
Expand All @@ -84,13 +84,13 @@ session-peer --version
### 업데이트

npm으로 설치한 클라이언트는 사용자가 직접 npm으로 업데이트합니다. 사용 가능한 배포 태그
(dist-tag)와 대상 버전을 확인한 뒤 해당 버전을 지정해 설치하세요. 아래 예시는 이전 npm 설치본을 공개된 0.3.3으로
(dist-tag)와 대상 버전을 확인한 뒤 해당 버전을 지정해 설치하세요. 아래 예시는 이전 npm 설치본을 선택한 0.3.4로
업데이트합니다. `session-peer` CLI는 업데이트를 설치하지 않습니다. `session-peer
update --check`는 새 버전이 있는지 확인할 뿐입니다.

```sh
npm view session-peer dist-tags
npm install --global --ignore-scripts session-peer@0.3.3
npm install --global --ignore-scripts session-peer@0.3.4
session-peer --version
```

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@

<!-- docs-contract: stable-release-source; package=session-peer; bin=session-peer; node=22.13+/24; python-reference=1.0.2 -->

**Documentation and source version: 0.3.3.** Review the selected release and registry metadata before installation. Dated preparation and validation records are in [VALIDATION.md](VALIDATION.md); release procedures are in [RELEASING.md](RELEASING.md). SSH endpoints require the same TypeScript client version; 0.3.2 and 0.3.3 refuse each other’s SSH preflight.
**Documentation and source version: 0.3.4.** Review the selected release and registry metadata before installation. Dated preparation and validation records are in [VALIDATION.md](VALIDATION.md); release procedures are in [RELEASING.md](RELEASING.md). SSH endpoints require the same TypeScript client version; 0.3.3 and 0.3.4 refuse each other’s SSH preflight.

**Find and message running Claude Code and Codex sessions, locally or over SSH.**
A Node.js client that runs without Python. Package and command: `session-peer`.
Expand Down Expand Up @@ -56,15 +56,15 @@ Check `type -a session-peer` on macOS/Linux or `Get-Command session-peer -All`
in PowerShell before installing. Choose the intended PATH entry; do not use
`--force` to overwrite another manager’s files.

**Version 0.3.3 installation:** check registry availability and review the chosen release before running the npm install/update examples. If that version is unavailable, use the [reviewed source build](docs/guide.md#build-from-source).
**Version 0.3.4 installation:** check registry availability and review the chosen release before running the npm install/update examples. If that version is unavailable, use the [reviewed source build](docs/guide.md#build-from-source).

```sh
npm view session-peer@0.3.3 version dist.integrity
npm install --global --ignore-scripts session-peer@0.3.3
npm view session-peer@0.3.4 version dist.integrity
npm install --global --ignore-scripts session-peer@0.3.4
session-peer --version
```

Expected: `session-peer 0.3.3 (typescript)`. For isolated installation, source
Expected: `session-peer 0.3.4 (typescript)`. For isolated installation, source
builds, Windows and removal, see the detailed guide below.

Optional `sp` shorthand ships with 0.3.0 and later (not 0.2.1 or earlier) and is
Expand All @@ -74,12 +74,12 @@ never enabled automatically. See [explicit activation and collisions](docs/short

Use npm for an npm-managed installation. Check the available tags and review
the target version, then install that exact version; this example updates an
older npm installation to the published 0.3.3 release. The CLI does not install updates;
older npm installation to the selected 0.3.4 release. The CLI does not install updates;
`session-peer update --check` only reports them.

```sh
npm view session-peer dist-tags
npm install --global --ignore-scripts session-peer@0.3.3
npm install --global --ignore-scripts session-peer@0.3.4
session-peer --version
```

Expand Down
14 changes: 7 additions & 7 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@

<!-- docs-contract: stable-release-source; package=session-peer; bin=session-peer; node=22.13+/24; python-reference=1.0.2 -->

**文档和源码版本:0.3.3。** 安装前,请审核所选发布版本和注册表元数据。按日期记录的准备与验证结果见 [VALIDATION.md](VALIDATION.md),发布流程见 [RELEASING.md](RELEASING.md)。SSH 两端必须使用相同的 TypeScript 客户端版本;0.3.2 与 0.3.3 会拒绝彼此的 SSH 预检。
**文档和源码版本:0.3.4。** 安装前,请审核所选发布版本和注册表元数据。按日期记录的准备与验证结果见 [VALIDATION.md](VALIDATION.md),发布流程见 [RELEASING.md](RELEASING.md)。SSH 两端必须使用相同的 TypeScript 客户端版本;0.3.3 与 0.3.4 会拒绝彼此的 SSH 预检。

**发现正在运行的 Claude Code 和 Codex 会话,并在本机或通过 SSH 发送消息。**
这是不需要 Python 的 Node.js 客户端。包名与命令名均为 `session-peer`。
Expand Down Expand Up @@ -54,15 +54,15 @@ session-peer send --to CLAUDE_PID --message '请检查 API 契约并回复。' -
`Get-Command session-peer -All` 检查 PATH。选择所需实现,不要用 `--force`
覆盖其他安装管理器的文件。

**安装 0.3.3:** 运行 npm 安装或更新示例前,请确认注册表可用性并审核所选发布版本。如该版本不可用,请使用[已审核的源码构建](docs/guide.zh-CN.md#从源码构建)。
**安装 0.3.4:** 运行 npm 安装或更新示例前,请确认注册表可用性并审核所选发布版本。如该版本不可用,请使用[已审核的源码构建](docs/guide.zh-CN.md#从源码构建)。

```sh
npm view session-peer@0.3.3 version dist.integrity
npm install --global --ignore-scripts session-peer@0.3.3
npm view session-peer@0.3.4 version dist.integrity
npm install --global --ignore-scripts session-peer@0.3.4
session-peer --version
```

预期输出:`session-peer 0.3.3 (typescript)`。隔离安装、源码构建、Windows 和
预期输出:`session-peer 0.3.4 (typescript)`。隔离安装、源码构建、Windows 和
卸载步骤见下方详细指南。

可选的 `sp` 简写包含在 0.3.0 及更高版本中(0.2.1 及更早版本没有),不会自动启用。
Expand All @@ -71,11 +71,11 @@ session-peer --version
### Update

使用 npm 更新由 npm 管理的安装。先检查标签并审阅目标版本,再安装指定版本。
下面示例将旧 npm 安装更新至已公开发布的 0.3.3。CLI 不会安装更新,`session-peer update --check` 只做检查。
下面示例将旧 npm 安装更新至所选的 0.3.4。CLI 不会安装更新,`session-peer update --check` 只做检查。

```sh
npm view session-peer dist-tags
npm install --global --ignore-scripts session-peer@0.3.3
npm install --global --ignore-scripts session-peer@0.3.4
session-peer --version
```

Expand Down
18 changes: 18 additions & 0 deletions RELEASING.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,24 @@ the historical 0.3.2 settings-read exception is recorded below. The workflow
uses OIDC and no npm token. The protected GitHub environment requires a reviewer
and permits deployments from `main` only.

## 0.3.4 stable preparation — 2026-10-12 KST

The patch integrates [PR #134](https://github.com/abruption/session-peer-ts/pull/134), merged as `c210ee963741f77153df10038c28e228ea7a902f`: Windows native exit forwarding and independently published TS skill guidance. Draft #106–#109 and #82 are excluded. Preparation is not staging or publication approval.

Read-only registry baseline at this checkpoint: `latest=0.3.3`, `preview=0.1.0-preview.1`, and 0.3.4 absent. Previous stable integrity:
`sha512-5OQ7eUlR5Oy3RHFRoR3FuBkV7LT72dfjfBEbWRCY5wYP7Dz8TmN2jlRPpo2SFHPAwosFc0WIt8Iis/vyHckxRg==`.
Previous stable attestation metadata: `https://registry.npmjs.org/-/npm/v1/attestations/session-peer@0.3.3`.
The immutable public 0.3.3 source is `c0ed30273b9e9c0049df86ae3c38486a94289527`. Historical records below are retained.

1. Review and merge this preparation, then require successful exact-main CI/release gate, CodeQL and Windows Node 22/24 for the resulting 40-character main SHA.
2. Fresh authenticated reads must verify ownership, pending npm stages, stage-only Trusted Publisher mapping/permissions, package MFA and protected GitHub npm environment/reviewer/main-only restrictions. Recheck registry tags, previous integrity, provenance content/source and target absence. This preparation performs no authenticated publication settings audit; prior approvals/exceptions do not carry forward.
3. Build and validate the exact-source archive, reproducible packing, isolated installation/removal and every packaged Markdown document. Apply the [artifact documentation gate](#documentation-gate-for-the-next-release); installation examples and runtime/banner/archive must agree on 0.3.4. Preserve historical/fixture and real-effect evidence boundaries.
4. Obtain separate approval naming the exact merged main SHA, `session-peer@0.3.4`, `stable-stage` and eventual `latest` promotion to 0.3.4.
5. Only then dispatch `publish.yml` with `source_sha=<approved SHA>`, `version=0.3.4`, `mode=stable-stage`, `confirmation=session-peer@0.3.4 stable-stage`. Review the retained Actions artifact before protected environment approval. Verify staged bytes and provenance, then obtain separate final npm 2FA approval. Never retry an uncertain upload or broaden publisher permissions.
6. After publication, verify public integrity/provenance/signatures and isolated version/install/removal, and append a dated public record. Leave preview unchanged. Tags/GitHub Releases/fleet installation require their own decisions.

SSH endpoints must both use exactly 0.3.4 when testing this package; public 0.3.3 refuses its banner. Managers/operators own upgrades. No implicit provisioning, postinstall, automatic resend, delivery/ACK support or 0.4 feature promotion is introduced. TS skill metadata/full0.3.2, published pin8482cf6 and Python1.0.2 reference remain independent and unchanged.

## 0.3.3 candidate preparation — #128 (2026-10-09 KST)

This dated checkpoint records preparation only. The candidate integrated reviewed
Expand Down
Loading
Loading