rtrt-agent 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kim DaeHyun (kernalix7@kodenet.io)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,40 @@
+# rtrt-agent
+
+`rtrt-agent`는 RTRT의 OpenCode provenance 플러그인입니다. 지원되는 OpenCode
+hook 사이에서 상위 session, agent, worktree, invocation 및 permission broker 문맥을
+보존하며 broker는 loopback에서만 실행됩니다.
+
+## 설치
+
+```sh
+npm install rtrt-agent@0.1.0
+```
+
+`opencode.json`의 단수형 `plugin` 배열에 패키지를 등록합니다.
+
+```json
+{
+  "plugin": ["rtrt-agent"]
+}
+```
+
+OpenCode는 이름 있는 `RtrtProvenance` export를 로드합니다. 이 패키지는 의도적으로
+default export를 제공하지 않습니다. 선택 사항인 RTRT TUI statusline은 별도 소스
+통합으로 유지되며 이 패키지에서 export하거나 pack하지 않습니다.
+
+`rtrt setup --agent opencode --apply`는 다른 setup write보다 먼저 인식된 legacy RTRT
+plugin을 제거합니다. Setup은 전체 RTRT 통합을 관리하지만 npm 설치는 수행하지 않으며,
+설정된 패키지는 OpenCode가 시작할 때 설치합니다. Setup은 `rtrt-agent`의 정확히 일치하는
+bare, pinned, ranged, tuple, object 형식만 소유하며 bare `"rtrt-agent"` string 하나로
+정규화합니다. 이전의 미게시 `rtrt`와 초안 `rtrt-opencode` 패키지 spec은 외부 값이며 순서를
+유지합니다. 위 직접 등록과 `opencode plugin rtrt-agent --global`은 계속 유효합니다.
+
+관리 agent 소유권 상태는 다음 순서의 첫 비어 있지 않은 root에서 읽습니다.
+`$OPENCODE_CONFIG_DIR`, `$XDG_CONFIG_HOME/opencode`, `~/.config/opencode`. 공존은 OMO
+4.19.4를 대상으로 CI에서 검사하고 OpenCode 1.18.29에서 직접 검증했으며, 어느 쪽도
+미래 버전 지원을 보장하지 않습니다. RTRT CLI 릴리스가 이를 등록하기 전에
+`rtrt-agent@0.1.0`을 게시해야 합니다.
+
+## 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,41 @@
+# rtrt-agent
+
+`rtrt-agent` is RTRT's OpenCode provenance plugin. It preserves parent session,
+agent, worktree, invocation, and permission-broker context across supported OpenCode
+hooks while keeping the broker loopback-only.
+
+## Install
+
+```sh
+npm install rtrt-agent@0.1.0
+```
+
+Register the package in the singular `plugin` array in `opencode.json`:
+
+```json
+{
+  "plugin": ["rtrt-agent"]
+}
+```
+
+OpenCode loads the named `RtrtProvenance` export. The package intentionally has no
+default export. The optional RTRT TUI statusline remains a separate source integration
+and is not exported or packed by this package.
+
+`rtrt setup --agent opencode --apply` first removes a recognized legacy RTRT plugin
+before any other setup write. It manages the full RTRT integration but performs no npm
+installation; OpenCode installs the configured package at startup. Setup owns exact bare,
+pinned, ranged, tuple, and object forms of `rtrt-agent` only, and normalizes them to one
+bare `"rtrt-agent"` string. Old unpublished `rtrt` and draft `rtrt-opencode` package specs
+are foreign and retain their order. The direct registration above and
+`opencode plugin rtrt-agent --global` remain valid.
+
+Managed-agent ownership state is read from the first nonempty root in this order:
+`$OPENCODE_CONFIG_DIR`, `$XDG_CONFIG_HOME/opencode`, then `~/.config/opencode`.
+Coexistence is CI-gated against OMO 4.19.4 and was verified on OpenCode 1.18.29; neither
+is a future-version guarantee. `rtrt-agent@0.1.0` must be published before an RTRT CLI
+release registers it.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1 @@
+export { RtrtProvenance } from "./rtrt-provenance.js"

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "rtrt-agent",
+  "version": "0.1.0",
+  "description": "RTRT provenance and permission-broker plugin for OpenCode",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "rtrt-provenance.js",
+    "README.md",
+    "README.ko.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test rtrt-provenance.test.mjs package.test.mjs tui/rtrt-statusline.test.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "provenance",
+    "rtrt"
+  ],
+  "author": "Kim DaeHyun <kernalix7@kodenet.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kernalix7/rtrt.git",
+    "directory": "plugins/opencode"
+  },
+  "homepage": "https://github.com/kernalix7/rtrt#readme",
+  "bugs": {
+    "url": "https://github.com/kernalix7/rtrt/issues"
+  },
+  "dependencies": {
+    "@opencode-ai/sdk": "1.15.13"
+  }
+}