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
7 changes: 7 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -1,3 +1,10 @@
# Generated from upstream license texts; preserve their original whitespace and line endings.
THIRD_PARTY_LICENSES.txt -text -whitespace
crates/xgen-cli/licenses/* -text

# Packed into every npm platform package and then verified byte-for-byte against
# this copy on the runner that assembles the release, so its bytes must not
# depend on the platform that checked it out. The Windows runner's
# `core.autocrlf=true` rewrote it and only the win32-x64 tarball disagreed,
# which failed v0.1.0-rc.3 at the bundle step (2026-10-24).
LICENSE -text
22 changes: 11 additions & 11 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ members = [
resolver = "3"

[workspace.package]
version = "0.1.0-rc.3"
version = "0.1.0-rc.4"
edition = "2024"
rust-version = "1.98"
license = "Apache-2.0"
Expand Down
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Local-first general-purpose agent CLI and harness.

## 설치와 첫 모델 연결

`v0.1.0-rc.3` release artifact가 게시되면 Linux x86-64/ARM64, macOS Intel/Apple Silicon, Windows
`v0.1.0-rc.4` release artifact가 게시되면 Linux x86-64/ARM64, macOS Intel/Apple Silicon, Windows
x86-64용 동일 native binary를 GitHub checksum installer와 npm 두 경로로 제공합니다. Native installer는
Rust, Node.js, Python, SQLite 실행 파일이나 XGEN state용 별도 daemon을 요구하지 않습니다. npm 경로만
얇은 launcher를 위해 Node.js 22.14 이상이 필요하며 install script, GitHub 추가 download와 native
Expand All @@ -18,7 +18,7 @@ Node.js가 이미 있다면 exact RC를 npm으로 설치할 수 있습니다. `-
제거하므로 사용하지 않습니다.

```bash
npm install --global @xgen-ai/cli@0.1.0-rc.3
npm install --global @xgen-ai/cli@0.1.0-rc.4
xgen --version
```

Expand All @@ -30,8 +30,8 @@ Linux/macOS:
installer=$(mktemp "${TMPDIR:-/tmp}/xgen-installer.XXXXXX")
curl -q --proto '=https' --proto-redir '=https' --tlsv1.2 \
--connect-timeout 15 --max-time 60 --max-filesize 1048576 -fsSLo "$installer" \
https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.3/xgen-installer.sh
sh "$installer" --version v0.1.0-rc.3
https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.4/xgen-installer.sh
sh "$installer" --version v0.1.0-rc.4
rm -f "$installer"
export PATH="$HOME/.local/bin:$PATH"
```
Expand All @@ -40,9 +40,9 @@ Windows PowerShell:

```powershell
$installer = Join-Path ([System.IO.Path]::GetTempPath()) "xgen-installer-$([Guid]::NewGuid().ToString('N')).ps1"
curl.exe -q --proto "=https" --proto-redir "=https" --tlsv1.2 --connect-timeout 15 --max-time 60 --max-filesize 1048576 -fsSLo $installer "https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.3/xgen-installer.ps1"
curl.exe -q --proto "=https" --proto-redir "=https" --tlsv1.2 --connect-timeout 15 --max-time 60 --max-filesize 1048576 -fsSLo $installer "https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.4/xgen-installer.ps1"
if ($LASTEXITCODE -ne 0) { throw "XGEN installer download failed" }
& $installer -Version v0.1.0-rc.3
& $installer -Version v0.1.0-rc.4
Remove-Item -LiteralPath $installer
$env:Path = "$env:LOCALAPPDATA\XGEN\bin;$env:Path"
```
Expand Down
2 changes: 1 addition & 1 deletion SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ XGEN는 Developer Preview다. 새 보안 수정은 원칙적으로 가장 최근
더 높은 새 version으로 제공한다. 이미 게시된 GitHub tag, Release asset 또는 npm package version을
이동·교체·재사용하지 않는다.

`v0.1.0-rc.3`이 게시되기 전의 최신 immutable release는 `v0.1.0-rc.2`다. RC3가 게시된 뒤에는 RC2에 새
`v0.1.0-rc.4`가 게시되기 전의 최신 immutable release는 `v0.1.0-rc.2`다. RC3가 게시된 뒤에는 RC2에 새
기능이나 보안 수정을 backport한다고 약속하지 않는다. RC2/RC3 Run의 호환·rollback 경계는
[시작하기](docs/getting-started.md#업데이트와-rc2-rollback)를 따른다.

Expand Down
22 changes: 11 additions & 11 deletions THIRD_PARTY_LICENSES.txt
Original file line number Diff line number Diff line change
Expand Up @@ -6722,7 +6722,7 @@ limitations under the License.
License: Apache License 2.0

Used by:
- xgen-cli 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-cli 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)

==============================================================================
The LLVM Project is under the Apache License v2.0 with LLVM Exceptions:
Expand Down Expand Up @@ -7193,16 +7193,16 @@ limitations under the License.
License: Apache License 2.0

Used by:
- xgen-adapter-filesystem 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-adapter-process 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-adapter-reference 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-domain 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-local-store 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-policy 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-protocol 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-provider-openai 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-runtime 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-workgraph 0.1.0-rc.3 (https://github.com/PlateerLab/xgen-cli)
- xgen-adapter-filesystem 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)
- xgen-adapter-process 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)
- xgen-adapter-reference 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)
- xgen-domain 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)
- xgen-local-store 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)
- xgen-policy 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)
- xgen-protocol 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)
- xgen-provider-openai 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)
- xgen-runtime 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)
- xgen-workgraph 0.1.0-rc.4 (https://github.com/PlateerLab/xgen-cli)
- allocator-api2 0.2.21 (https://github.com/zakarumych/allocator-api2)
- anyhow 1.0.104 (https://github.com/dtolnay/anyhow)
- async-trait 0.1.92 (https://github.com/dtolnay/async-trait)
Expand Down
4 changes: 2 additions & 2 deletions docs/development/rc3-developer-preview-pilot.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# RC3 Developer Preview 파일럿

이 문서는 게시된 `v0.1.0-rc.3` artifact가 일반 개발자의 작은 코딩 작업을 끝까지 수행하는지 확인하는
이 문서는 게시된 `v0.1.0-rc.4` artifact가 일반 개발자의 작은 코딩 작업을 끝까지 수행하는지 확인하는
제한 파일럿 runbook이다. Release 이전 source checkout이나 local build 결과를 사용자 결과로 대체하지
않는다. 파일럿 project와 state는 폐기 가능한 전용 위치에서 만들고 실제 업무 source나 credential을
사용하지 않는다.

## 사전 조건과 중단 조건

- GitHub Release `v0.1.0-rc.3`과 `@xgen-ai/cli@0.1.0-rc.3`이 게시됐고 provenance, checksum과 package
- GitHub Release `v0.1.0-rc.4`와 `@xgen-ai/cli@0.1.0-rc.4`가 게시됐고 provenance, checksum과 package
integrity 검증이 끝나야 한다.
- 각 참여자는 repository checkout이나 Rust compiler 없이 먼저 설치·온보딩 smoke를 통과한다. 언어별
compiler/interpreter는 해당 coding fixture 실행을 위해서만 사용한다.
Expand Down
5 changes: 3 additions & 2 deletions docs/development/rc3-release-candidate.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# Developer Preview RC3 후보

- 후보 version: `0.1.0-rc.3`
- 후보 version: `0.1.0-rc.4`
- version 이력: `v0.1.0-rc.3` tag는 release workflow가 bundle 조립 단계에서 멈춰 게시되지 않았다. Tag는 immutable이라 같은 번호를 다시 쓸 수 없으므로, 같은 RC3 내용에 Windows 체크아웃의 LICENSE 줄바꿈 수정 하나를 더해 `0.1.0-rc.4`로 올린다. 문서의 "RC3"는 이 Developer Preview 세대 이름이고 게시되는 artifact version은 `v0.1.0-rc.4`다.
- protocol: `xgeny.io/v1alpha1`, bundled/offline protocol check
- local store: embedded SQLite physical schema 8와 CLI material catalog schema 1
- 상태: version PR의 필수 CI가 모두 통과하고 main에 merge되기 전에는 게시 가능한 tag가 아니다
Expand Down Expand Up @@ -113,6 +114,6 @@ install smoke를 수행한다.

이 문서를 merge하는 것만으로 release를 게시하지 않는다. Merge 뒤 npm scope/bootstrap, repository secret
`NPM_TOKEN`과 `XGEN_NPM_PUBLISH_ENABLED=true`를 확인하고, 현재 `origin/main` head와 package version이
정확히 일치할 때 별도 보호 tag `v0.1.0-rc.3`을 만들면 release workflow가 모든 release gate를 다시
정확히 일치할 때 별도 보호 tag `v0.1.0-rc.4`를 만들면 release workflow가 모든 release gate를 다시
실행한다. GitHub Release 전 실패한 tag나 asset은 이동·교체·재사용하지 않고 더 높은 새 version으로
수정한다. Immutable GitHub Release 뒤 동일 npm bundle의 부분 실패만 SRI 검증 아래 재실행한다.
2 changes: 1 addition & 1 deletion docs/development/releasing.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ XGEN Intel macOS binary와 installer 검증 범위에는 영향이 없다.
Version을 올린 변경을 먼저 PR로 merge한 뒤 main head에 tag를 만든다. `main`에는 직접 push하지 않는다.

```bash
release_version=0.1.0-rc.3
release_version=0.1.0-rc.4
release_tag="v$release_version"
git fetch origin main
git tag -a "$release_tag" origin/main -m "XGEN $release_version"
Expand Down
2 changes: 1 addition & 1 deletion docs/development/workspace-filesystem-discovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

이 문서는 source/main의 workspace read-only discovery 구현과 회귀 절차다. Directory mode에 추가된
별도 승인형 mutation은 [Workspace atomic write](workspace-atomic-write.md)와
[Workspace apply patch](workspace-apply-patch.md)를 따른다. `v0.1.0-rc.3`부터 `--allow-dir` discovery와
[Workspace apply patch](workspace-apply-patch.md)를 따른다. `v0.1.0-rc.4`부터 `--allow-dir` discovery와
별도 승인형 write/patch가 native release artifact에 포함된다.

## 실행 모드
Expand Down
26 changes: 13 additions & 13 deletions docs/getting-started.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# XGEN 설치와 첫 실행

이 문서는 Developer Preview `v0.1.0-rc.3` release artifact가 게시된 뒤 binary 하나를 설치하고
이 문서는 Developer Preview `v0.1.0-rc.4` release artifact가 게시된 뒤 binary 하나를 설치하고
OpenAI-compatible model에 연결해 파일 읽기부터 프로젝트 탐색·수정·test/build까지 실행하는 최소
절차다. RC3 후보는 exact
`--allow-file`, `--allow-dir` workspace discovery, atomic write/patch와 host-catalogued shell-free
Expand All @@ -15,7 +15,7 @@ launcher용 Node.js 22.14 이상이 필요하다. 사용할 model endpoint 자
22.14 이상이 있는 지원 OS에서는 아래 순서가 가장 짧다.

```bash
npm install --global --include=optional @xgen-ai/cli@0.1.0-rc.3
npm install --global --include=optional @xgen-ai/cli@0.1.0-rc.4
xgen --version
xgen model setup
xgen model check --compatibility
Expand Down Expand Up @@ -56,7 +56,7 @@ Node.js 22.14 이상이 이미 있는 개발자는 RC3가 npm에 게시된 뒤
설치한다. 설치 중 GitHub download나 source compile을 하지 않는다.

```bash
npm install --global @xgen-ai/cli@0.1.0-rc.3
npm install --global @xgen-ai/cli@0.1.0-rc.4
xgen --version
xgen licenses
```
Expand All @@ -71,16 +71,16 @@ Node.js를 설치하고 싶지 않거나 GitHub attestation까지 직접 확인
Installer를 먼저 파일로 받은 뒤 검토·실행한다. Installer는 shell profile이나 user PATH를 자동으로
수정하지 않고 관리자 권한을 요청하지 않는다. RC3는 prerelease이므로 stable release만 가리키는
`releases/latest` 대신 아래 exact tag를 사용한다. 후보 version PR의 merge만으로 artifact가 생기지는
않으므로 GitHub Release에 `v0.1.0-rc.3`이 게시된 것을 확인한 뒤 실행한다.
않으므로 GitHub Release에 `v0.1.0-rc.4`가 게시된 것을 확인한 뒤 실행한다.

Linux/macOS:

```bash
installer=$(mktemp "${TMPDIR:-/tmp}/xgen-installer.XXXXXX")
curl -q --proto '=https' --proto-redir '=https' --tlsv1.2 \
--connect-timeout 15 --max-time 60 --max-filesize 1048576 -fsSLo "$installer" \
https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.3/xgen-installer.sh
sh "$installer" --version v0.1.0-rc.3
https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.4/xgen-installer.sh
sh "$installer" --version v0.1.0-rc.4
rm -f "$installer"
export PATH="$HOME/.local/bin:$PATH"
```
Expand All @@ -89,9 +89,9 @@ Windows PowerShell:

```powershell
$installer = Join-Path ([System.IO.Path]::GetTempPath()) "xgen-installer-$([Guid]::NewGuid().ToString('N')).ps1"
curl.exe -q --proto "=https" --proto-redir "=https" --tlsv1.2 --connect-timeout 15 --max-time 60 --max-filesize 1048576 -fsSLo $installer "https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.3/xgen-installer.ps1"
curl.exe -q --proto "=https" --proto-redir "=https" --tlsv1.2 --connect-timeout 15 --max-time 60 --max-filesize 1048576 -fsSLo $installer "https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.4/xgen-installer.ps1"
if ($LASTEXITCODE -ne 0) { throw "XGEN installer download failed" }
& $installer -Version v0.1.0-rc.3
& $installer -Version v0.1.0-rc.4
Remove-Item -LiteralPath $installer
$env:Path = "$env:LOCALAPPDATA\XGEN\bin;$env:Path"
```
Expand Down Expand Up @@ -124,16 +124,16 @@ xgen licenses
installer=$(mktemp "${TMPDIR:-/tmp}/xgen-installer.XXXXXX")
curl -q --proto '=https' --proto-redir '=https' --tlsv1.2 \
--connect-timeout 15 --max-time 60 --max-filesize 1048576 -fsSLo "$installer" \
https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.3/xgen-installer.sh
sh "$installer" --version v0.1.0-rc.3
https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.4/xgen-installer.sh
sh "$installer" --version v0.1.0-rc.4
rm -f "$installer"
```

```powershell
$installer = Join-Path ([System.IO.Path]::GetTempPath()) "xgen-installer-$([Guid]::NewGuid().ToString('N')).ps1"
curl.exe -q --proto "=https" --proto-redir "=https" --tlsv1.2 --connect-timeout 15 --max-time 60 --max-filesize 1048576 -fsSLo $installer "https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.3/xgen-installer.ps1"
curl.exe -q --proto "=https" --proto-redir "=https" --tlsv1.2 --connect-timeout 15 --max-time 60 --max-filesize 1048576 -fsSLo $installer "https://github.com/PlateerLab/xgen-cli/releases/download/v0.1.0-rc.4/xgen-installer.ps1"
if ($LASTEXITCODE -ne 0) { throw "XGEN installer download failed" }
& $installer -Version v0.1.0-rc.3
& $installer -Version v0.1.0-rc.4
Remove-Item -LiteralPath $installer
```

Expand Down Expand Up @@ -422,7 +422,7 @@ npm 설치본은 새 exact version을 다시 설치해 업데이트한다. `next
가리킬 수 있으므로 파일럿과 장애 재현에는 사용하지 않는다.

```bash
npm install --global --include=optional @xgen-ai/cli@0.1.0-rc.3
npm install --global --include=optional @xgen-ai/cli@0.1.0-rc.4
xgen --version
```

Expand Down
4 changes: 2 additions & 2 deletions npm/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion npm/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "xgen-npm-distribution-workspace",
"version": "0.1.0-rc.3",
"version": "0.1.0-rc.4",
"private": true,
"type": "module",
"packageManager": "npm@11.19.0",
Expand Down
2 changes: 1 addition & 1 deletion npm/packages/cli/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
`@xgen-ai/cli` is the npm distribution wrapper for the native XGEN CLI.

```bash
npm install --global @xgen-ai/cli@0.1.0-rc.3
npm install --global @xgen-ai/cli@0.1.0-rc.4
xgen --version
```

Expand Down
Loading