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
4 changes: 2 additions & 2 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,6 @@ authors:
repository-code: "https://github.com/KoreanCode/orange-hyper"
url: "https://github.com/KoreanCode/orange-hyper"
license: "MIT"
version: "1.1.0-alpha.7"
date-released: "2026-06-18"
version: "1.1.0-alpha.8"
date-released: "2026-06-19"
abstract: "Lightweight quest and capsule kernel for coding agents."
34 changes: 26 additions & 8 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
<summary>Version metadata details</summary>

- Base README: [README.md](README.md)
- README version: `1.1-doc.7`
- README version: `1.1-doc.8`
- Package version: see [package.json](package.json)
- Adapter JSON contract: `0.1`
- Base language: `ko`
Expand Down Expand Up @@ -58,7 +58,8 @@ What is needed is the space between those two. Small requests should stay small.
- role, MCP, hook, and subagent are not enabled from the start.
- role, MCP, hook, and subagent grow only from repeated evidence.
- Start light and grow gradually.
- Do not write memory automatically.
- Do not accept durable/shared memory automatically.
- On an activated supported host, Orange may automatically manage local runtime state, Quest, Capsule, evidence, working memory, and pending proposal candidates within activation policy.
- Create a Memory Delta Proposal only from a completed Quest.
- Only user-accepted proposals become graph node candidates.
- Only memory with the current `project_id` is treated as current project memory.
Expand Down Expand Up @@ -88,29 +89,29 @@ Installation priority:

1. Standalone binary: install the platform-specific `orange` executable from GitHub Releases into a user-local directory.
2. Future package managers: Homebrew, Scoop, and similar user-scope package managers are future channels.
3. `npx` exact-version fallback: use only for temporary checks, and specify `orange-hyper@1.1.0-alpha.7` or `@alpha`.
3. `npx` exact-version fallback: use only for temporary checks, and specify `orange-hyper@1.1.0-alpha.8` or `@alpha`.
4. Project-local npm install: an advanced/manual option only when the user explicitly asks for it.

Release policy: one `v*` tag push runs the single Release workflow. That workflow performs the test gate, standalone binary matrix build, `install.sh`/`install.ps1`, `checksums.txt`, `release-manifest.json`, GitHub Release asset upload, npm publish, asset gate, and installer smoke together. Existing GitHub Release backfills use the same pipeline through the `workflow_dispatch` `tag` input, so routine releases do not require manual `gh release upload`.

macOS/Linux user-local install:

```bash
curl -fsSL https://github.com/KoreanCode/orange-hyper/releases/download/v1.1.0-alpha.7/install.sh | sh
curl -fsSL https://github.com/KoreanCode/orange-hyper/releases/download/v1.1.0-alpha.8/install.sh | sh
```

Windows PowerShell user-local install:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr https://github.com/KoreanCode/orange-hyper/releases/download/v1.1.0-alpha.7/install.ps1 -OutFile $env:TEMP\orange-install.ps1; & $env:TEMP\orange-install.ps1 -Version 1.1.0-alpha.7"
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr https://github.com/KoreanCode/orange-hyper/releases/download/v1.1.0-alpha.8/install.ps1 -OutFile $env:TEMP\orange-install.ps1; & $env:TEMP\orange-install.ps1 -Version 1.1.0-alpha.8"
```

The installer verifies SHA-256 checksums and stops on mismatch. It does not use npm, create package files, create `node_modules`, or modify the current project.

For fallback package visibility checks, pin the exact version:

```bash
npx -y --package orange-hyper@1.1.0-alpha.7 orange --help
npx -y --package orange-hyper@1.1.0-alpha.8 orange --help
```

This is not the default installation path. AI should not automatically run `npm init -y` or `npm install -D orange-hyper`. The npm package remains available as a developer/fallback channel.
Expand All @@ -122,15 +123,25 @@ Paste this into your AI when you want to use Orange Hyper in a new or existing r
```text
Use Orange Hyper for this project.

Install the Orange Codex Host Binding once.
Activate Orange in the repositories where you want it.
Then work normally.

First, check whether `orange --version` and `orange env --json` work from PATH.

If `orange` is missing, suggest standalone binary installation and install it into a user-local location only after I approve.

Do not run `npm init -y`. Do not use `npm install -D orange-hyper` as the default install path. Do not create or modify project `package.json`, `package-lock.json`, or `node_modules`.

Use npm fallback only if I explicitly ask for it, and then specify `orange-hyper@alpha` or `orange-hyper@1.1.0-alpha.7`.
Use npm fallback only if I explicitly ask for it, and then specify `orange-hyper@alpha` or `orange-hyper@1.1.0-alpha.8`.

If the Orange Codex Host Binding is not installed in this Codex environment, run `orange binding plan --host codex --scope user --json` and show me the read-only binding plan.

If I approve, run `orange binding install --host codex --scope user --json`. This can prepare the user-scoped marketplace and plugin source only; do not describe marketplace registration as plugin installation, enablement, hook review, or operational status.

Then run `orange activate plan --host codex --scope project --json` and show me the read-only project activation plan.

After install or PATH confirmation, run `orange init --json` for idempotent bootstrap.
If I approve, run `orange activate apply --host codex --scope project --json` to activate this project. Do not report active until an actual lifecycle heartbeat exists.

Then run `orange sync plan --json` and show me the diff. If I approve, run `orange sync apply --json` and `orange sync status --json` to refresh generated Structure Graph and Identity HTML.

Expand Down Expand Up @@ -186,6 +197,7 @@ Orange Hyper is easier to understand by its artifacts than by a feature list.
- Knowledge Graph: accepted memory read as decision, constraint, risk, verification, and component nodes.
- Identity HTML: a single HTML view of project memory, accepted memory graph, growth signals, and eval summary.
- Hook Warning: a warning without automatic repair.
- Activation Runtime: a user-approved supported-host lifecycle binding. Installation alone is not active; a heartbeat is required.
- MCP Suggestion: a tool suggestion without installation.
- Growth Signal: a growth candidate without automatic unlock.
- Eval Report: a local-only evaluation report.
Expand Down Expand Up @@ -221,6 +233,8 @@ Identity HTML currently provides a read-only full-screen Knowledge Graph Dashboa
- [v1 Stabilization Readiness](docs/22_V1_STABILIZATION.md)
- [Project Sync](docs/24_PROJECT_SYNC.md)
- [Standalone Distribution](docs/25_STANDALONE_DISTRIBUTION.md)
- [Activation Runtime](docs/26_ACTIVATION_RUNTIME.md)
- [Codex Binding E2E Checklist](docs/27_CODEX_BINDING_E2E.md)
- [Release Notes](RELEASE_NOTES.md)

## Manual fallback / Kernel command reference
Expand All @@ -235,6 +249,9 @@ The list below is not a long usage guide. It is the top-level kernel surface for

<!-- orange-command-surface:start -->
- `init`
- `activate`
- `lifecycle`
- `host`
- `quest`
- `route`
- `capsule`
Expand All @@ -244,6 +261,7 @@ The list below is not a long usage guide. It is the top-level kernel surface for
- `mcp`
- `growth`
- `adapter`
- `binding`
- `eval`
- `sync`
- `env`
Expand Down
34 changes: 26 additions & 8 deletions README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
<summary>Version metadata の詳細</summary>

- Base README: [README.md](README.md)
- README version: `1.1-doc.7`
- README version: `1.1-doc.8`
- Package version: see [package.json](package.json)
- Adapter JSON contract: `0.1`
- Base language: `ko`
Expand Down Expand Up @@ -58,7 +58,8 @@ Orange Hyper は最初から強い harness を有効にしません。harnessles
- role、MCP、hook、subagent は最初から有効にしません。
- role、MCP、hook、subagent は反復した証拠があるときだけ成長します。
- 軽く始めて、段階的に育てます。
- automatic memory write はしません。
- durable/shared memory の accept は自動化しません。
- activated supported host では、activation policy の範囲内で local runtime state、Quest、Capsule、evidence、working memory、pending proposal candidate を自動管理できます。
- completed Quest からだけ Memory Delta Proposal を作ります。
- ユーザーが accept した proposal だけが graph node candidate になります。
- 現在の `project_id` と一致する memory だけを現在のプロジェクト memory と扱います。
Expand Down Expand Up @@ -88,27 +89,27 @@ Orange Hyper は coding agent のための repo-local project-memory kernel で

1. Standalone binary: GitHub Release から platform 別の `orange` 実行ファイルを user-local ディレクトリにインストールします。
2. Future package manager: Homebrew、Scoop などの user-scope package manager は今後のチャネルです。
3. `npx` exact-version fallback: 一時確認だけに使い、`orange-hyper@1.1.0-alpha.7` または `@alpha` を指定します。
3. `npx` exact-version fallback: 一時確認だけに使い、`orange-hyper@1.1.0-alpha.8` または `@alpha` を指定します。
4. Project-local npm install: ユーザーが明示的に求めた場合だけ使う advanced/manual option です。

macOS/Linux user-local インストール:

```bash
curl -fsSL https://github.com/KoreanCode/orange-hyper/releases/download/v1.1.0-alpha.7/install.sh | sh
curl -fsSL https://github.com/KoreanCode/orange-hyper/releases/download/v1.1.0-alpha.8/install.sh | sh
```

Windows PowerShell user-local インストール:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr https://github.com/KoreanCode/orange-hyper/releases/download/v1.1.0-alpha.7/install.ps1 -OutFile $env:TEMP\orange-install.ps1; & $env:TEMP\orange-install.ps1 -Version 1.1.0-alpha.7"
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr https://github.com/KoreanCode/orange-hyper/releases/download/v1.1.0-alpha.8/install.ps1 -OutFile $env:TEMP\orange-install.ps1; & $env:TEMP\orange-install.ps1 -Version 1.1.0-alpha.8"
```

インストーラーは SHA-256 checksum を検証し、失敗したら停止します。npm は使わず、package files や `node_modules` を作らず、現在のプロジェクトも変更しません。

fallback としてパッケージの可視性だけを確認する場合は exact version を指定します。

```bash
npx -y --package orange-hyper@1.1.0-alpha.7 orange --help
npx -y --package orange-hyper@1.1.0-alpha.8 orange --help
```

これはデフォルトのインストール方法ではありません。AI は `npm init -y` や `npm install -D orange-hyper` を自動実行してはいけません。npm package は developer/fallback channel として残します。
Expand All @@ -120,15 +121,25 @@ npx -y --package orange-hyper@1.1.0-alpha.7 orange --help
```text
このプロジェクトで Orange Hyper を使ってください。

Install the Orange Codex Host Binding once.
Activate Orange in the repositories where you want it.
Then work normally.

まず PATH で `orange --version` と `orange env --json` が動くか確認してください。

`orange` がない場合は standalone binary のインストールを提案し、私が承認した後で user-local の場所にインストールしてください。

`npm init -y` を実行しないでください。`npm install -D orange-hyper` をデフォルトのインストール方法にしないでください。プロジェクトの `package.json`、`package-lock.json`、`node_modules` を作成または変更しないでください。

npm fallback は私が明示的に求めた場合だけ使い、その場合も `orange-hyper@alpha` または `orange-hyper@1.1.0-alpha.7` を指定してください。
npm fallback は私が明示的に求めた場合だけ使い、その場合も `orange-hyper@alpha` または `orange-hyper@1.1.0-alpha.8` を指定してください。

この Codex 環境に Orange Host Binding がまだない場合は、`orange binding plan --host codex --scope user --json` で read-only binding plan を見せてください。

私が承認したら、`orange binding install --host codex --scope user --json` を実行してください。このコマンドが準備できるのは user-scoped marketplace と plugin source だけです。marketplace 登録を plugin installation、enable、hook review、operational status として説明しないでください。

その後、`orange activate plan --host codex --scope project --json` で read-only project activation plan を見せてください。

インストールまたは PATH 確認の後、`orange init --json` で idempotent bootstrap を実行してください
私が承認したら、`orange activate apply --host codex --scope project --json` でこのプロジェクトを有効化してください。実際の lifecycle heartbeat が記録されるまでは active と報告しないでください

その後 `orange sync plan --json` で diff を見せてください。私が承認したら、`orange sync apply --json` と `orange sync status --json` で generated Structure Graph と Identity HTML を更新してください。

Expand Down Expand Up @@ -184,6 +195,7 @@ Orange Hyper は機能リストよりも、残すものから見ると理解し
- Knowledge Graph: accepted memory を decision、constraint、risk、verification、component node として読むグラフ。
- Identity HTML: project memory、accepted memory graph、growth signal、eval summary をひとつの HTML で見る画面。
- Hook Warning: 自動修正をしない警告。
- Activation Runtime: ユーザーが承認した supported-host lifecycle binding。インストールだけでは active ではなく、heartbeat が必要です。
- MCP Suggestion: インストールしないツール提案。
- Growth Signal: 自動 unlock しない成長候補。
- Eval Report: local-only の評価レポート。
Expand Down Expand Up @@ -219,6 +231,8 @@ Identity HTML は Orange Hyper Identity の primary product surface です。v1.
- [v1 Stabilization Readiness](docs/22_V1_STABILIZATION.md)
- [Project Sync](docs/24_PROJECT_SYNC.md)
- [Standalone Distribution](docs/25_STANDALONE_DISTRIBUTION.md)
- [Activation Runtime](docs/26_ACTIVATION_RUNTIME.md)
- [Codex Binding E2E Checklist](docs/27_CODEX_BINDING_E2E.md)
- [Release Notes](RELEASE_NOTES.md)

## Manual fallback / Kernel command reference
Expand All @@ -233,6 +247,9 @@ Identity HTML は Orange Hyper Identity の primary product surface です。v1.

<!-- orange-command-surface:start -->
- `init`
- `activate`
- `lifecycle`
- `host`
- `quest`
- `route`
- `capsule`
Expand All @@ -242,6 +259,7 @@ Identity HTML は Orange Hyper Identity の primary product surface です。v1.
- `mcp`
- `growth`
- `adapter`
- `binding`
- `eval`
- `sync`
- `env`
Expand Down
Loading
Loading