@ictechgy/lterm 1.0.1 → 1.0.2

package/README.ko.md

@@ -15,6 +15,7 @@
 
 > **보안 모델:** `lterm`은 같은 OS 사용자 안에서 쓰는 편의용 데몬이며 샌드박스가 아닙니다. 다른 사용자의 Unix socket 접근은 거부하고 런타임 디렉터리는 소유자 전용 권한으로 만들지만, 같은 OS 사용자 권한으로 실행되는 프로세스는 세션을 제어할 수 있다고 보아야 합니다.
 > 전체 trust boundary와 audit policy는 [SECURITY.md](SECURITY.md)를 참고하세요.
+> Non-goals(의도적으로 지원하지 않는 항목)는 [docs/non-goals.md](docs/non-goals.md)를 참고하세요.
 
 ## 왜 tmux 대신 lterm인가요?
 
@@ -70,7 +71,7 @@ Homebrew와 npm 모두 `PATH`에 `lterm` 명령을 설치합니다. `lterm --ver
 GitHub에서 Cargo로 설치 (Releases 페이지의 최신 태그를 사용하세요):
 
 ```bash
-cargo install --git https://github.com/ictechgy/light_terminal --tag v1.0.1
+cargo install --git https://github.com/ictechgy/light_terminal --tag v1.0.2
 ```
 
 저장소를 클론한 뒤 직접 빌드하려면 Rust 1.85 이상이 필요합니다.

package/README.md

@@ -15,6 +15,7 @@
 
 > **Security model:** `lterm` is a same-user convenience daemon, not a sandbox. It rejects cross-user Unix-socket peers and uses owner-only runtime directories, but any process running as your OS user should be considered capable of controlling your sessions.
 > See [SECURITY.md](SECURITY.md) for the full trust-boundary and audit policy details.
+> Non-goals: see [docs/non-goals.md](docs/non-goals.md).
 
 ## Why lterm instead of plain tmux?
 
@@ -75,7 +76,7 @@ For the 1.0 command/output stability boundary, see the
 With Cargo from GitHub (use the latest tag from the Releases page):
 
 ```bash
-cargo install --git https://github.com/ictechgy/light_terminal --tag v1.0.1
+cargo install --git https://github.com/ictechgy/light_terminal --tag v1.0.2
 ```
 
 From this checkout, use Rust 1.85 or newer:
@@ -97,10 +98,14 @@ To expose the tmux shim:
 lterm install-shim
 # Add the printed directory to PATH ahead of the real tmux, or eval the helper:
 eval "$(lterm env)"
+# fish:
+lterm env --shell fish | source
 ```
 
 ## Quick start
 
+![lterm quick demo](docs/assets/lterm-demo.svg)
+
 **Create a persistent session and attach immediately:**
 
 ```bash
@@ -139,6 +144,7 @@ lterm -a api
 | Write input to a PTY | `lterm input api 'echo hello' --enter` | `send` |
 | Stop a session | `lterm close api` | `kill` |
 | Diagnose daemon and shim state | `lterm doctor --json` | `status` |
+| Preview local setup steps | `lterm init --shell zsh` | None |
 | Run the background daemon explicitly | `lterm daemon` | None |
 | Stop the daemon and all sessions | `lterm shutdown` | None |
 
@@ -149,13 +155,14 @@ Agent and shim utilities are also product CLI commands, not tmux aliases:
 | Launch a profiled agent session | `lterm agent claude -- --help` | Sibling shortcuts: `lterm claude`, `lterm codex`, `lterm gemini`, `lterm omx`, `lterm omc` |
 | Inspect available agent profiles | `lterm agents --json` | PATH availability probe at command runtime |
 | Install the `tmux` compatibility shim | `lterm install-shim` | Creates a shim that forwards to `lterm tmux-compat` |
-| Print shell exports for tmux compatibility | `eval "$(lterm env)"` | Emits trusted `export` lines that prepend the shim dir to `$PATH` |
+| Print shell exports for tmux compatibility | `eval "$(lterm env)"` (`lterm env --shell fish \| source` for fish) | Emits trusted shell setup that prepends the shim dir to `$PATH` |
 | Send a cmux-friendly notification | `lterm notify --title 'Done' --body 'Tests passed'` | OSC 777 fallback strips terminal controls while preserving Unicode text |
 | Attach to a remote host | `lterm ssh user@host main` | Use trusted hosts; SSH handles host-key checks, and remote PTY bytes pass through without sanitization |
 | Call the tmux shim namespace directly | `lterm tmux-compat list-commands` | Compatibility namespace, not a product alias table |
 
 Use `eval "$(lterm env)"` only when you trust the `lterm` binary on your `PATH`.
 It emits fixed `export` lines that prepend the shim directory to `$PATH`.
+For fish, use `lterm env --shell fish | source` after the same trust check.
 
 `lterm ssh` forwards remote PTY bytes to the local terminal without sanitizing
 terminal control sequences, so a compromised remote can drive terminal features
@@ -439,6 +446,20 @@ LTERM_RUNTIME_DIR="$TMP/run" LTERM_DATA_DIR="$TMP/data" cargo run -- logs test -
 LTERM_RUNTIME_DIR="$TMP/run" LTERM_DATA_DIR="$TMP/data" cargo run -- shutdown
 ```
 
+Release/contract preflight helpers:
+
+```bash
+scripts/release-preflight.sh --contract-only
+scripts/release-preflight.sh --allow-occupied-skip --skip-audit
+scripts/dependency-minor-dry-run.sh
+```
+
+Use `--run-soak` on `scripts/release-preflight.sh` only for the manual
+release-gate soak profile. Use
+[`docs/release-evidence-template.md`](docs/release-evidence-template.md) to
+capture release, audit, contract, dependency, and soak evidence before tagging or
+publishing.
+
 ## License
 
 Licensed under either of:

package/docs/assets/lterm-demo.svg

@@ -0,0 +1,27 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="920" height="420" role="img" aria-labelledby="title desc">
+  <title id="title">lterm quick demo</title>
+  <desc id="desc">Terminal-style demo showing a detached lterm session, sanitized logs, JSON wait, and resume.</desc>
+  <rect width="920" height="420" rx="18" fill="#0b1020"/>
+  <rect x="18" y="18" width="884" height="384" rx="14" fill="#111827" stroke="#334155"/>
+  <circle cx="46" cy="46" r="7" fill="#ef4444"/>
+  <circle cx="70" cy="46" r="7" fill="#f59e0b"/>
+  <circle cx="94" cy="46" r="7" fill="#22c55e"/>
+  <text x="124" y="52" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15" fill="#94a3b8">lterm: persistent terminal sessions for agents</text>
+  <g font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16">
+    <text x="42" y="94" fill="#38bdf8">$</text>
+    <text x="66" y="94" fill="#e5e7eb">lterm start -d -n api -- sh -lc 'echo READY; sleep 60'</text>
+    <text x="66" y="124" fill="#a7f3d0">api    %0    sh -lc 'echo READY; sleep 60'</text>
+
+    <text x="42" y="172" fill="#38bdf8">$</text>
+    <text x="66" y="172" fill="#e5e7eb">lterm logs api -S=-20</text>
+    <text x="66" y="202" fill="#a7f3d0">READY</text>
+
+    <text x="42" y="250" fill="#38bdf8">$</text>
+    <text x="66" y="250" fill="#e5e7eb">lterm wait api --contains READY --json</text>
+    <text x="66" y="280" fill="#a7f3d0">{ &quot;target&quot;: &quot;api&quot;, &quot;matched&quot;: true, &quot;timed_out&quot;: false }</text>
+
+    <text x="42" y="328" fill="#38bdf8">$</text>
+    <text x="66" y="328" fill="#e5e7eb">lterm resume api</text>
+    <text x="66" y="358" fill="#fbbf24">raw PTY attach resumes the live session</text>
+  </g>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ictechgy/lterm",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Lightweight tmux-compatible terminal session daemon with cmux-friendly notifications.",
   "license": "MIT OR Apache-2.0",
   "homepage": "https://github.com/ictechgy/light_terminal#readme",
@@ -23,6 +23,7 @@
   },
   "files": [
     "bin/lterm.js",
+    "docs/assets/lterm-demo.svg",
     "README.md",
     "README.ko.md",
     "LICENSE",
@@ -30,10 +31,10 @@
     "LICENSE-MIT"
   ],
   "optionalDependencies": {
-    "lterm-darwin-arm64": "1.0.1",
-    "lterm-darwin-x64": "1.0.1",
-    "lterm-linux-arm64": "1.0.1",
-    "lterm-linux-x64": "1.0.1"
+    "lterm-darwin-arm64": "1.0.2",
+    "lterm-darwin-x64": "1.0.2",
+    "lterm-linux-arm64": "1.0.2",
+    "lterm-linux-x64": "1.0.2"
   },
   "engines": {
     "node": ">=16"