oops-cli 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 238211aa8b381cf9998c6a744627d61d276be3350aa273c9d7fbdba8c078125a
-  data.tar.gz: 1858aff54bd54535e3aa2ebc5b5a0c18b4f6168572c1e55e1dd0d13b97f31fdd
+  metadata.gz: f8a84c3fefd0069ad9b8f6be16f6a14957ed36d3449232c0b8bdbf69f1fe817b
+  data.tar.gz: 8f12fe23babadb66f8c1e156a966c850d564c62c78781df1faef3366a1569b09
 SHA512:
-  metadata.gz: dcae845a6bc939a775258eba59a360dfff475dc91af52be47d7495eea915de21cd04ae1c82afc1ea157df0db3e84b0b576e029d1731e6347c3faa429cd18e0d9
-  data.tar.gz: 14472ae5e385e10142be06be2264eff1d828415fca08388fba48d66d8a7c258b64f8bde75da0f86f94b2ef511cd2b331de972563267f597595aadb7eac074d9c
+  metadata.gz: 429be7bd8136a0a8d3b1a128a485bb58f6eeb71bd478743e728f2a6c5e9335b8d4362db86c72b5b8c177949d4400b54e239c81e9a77528a5c28c430ce005df88
+  data.tar.gz: a4448becb14db389e6bb58da82a9958135603d93f42fb5de46d2193e45fb7b277c0dd72f1584be76da4d2ad35348f45d9703651d92ab6a3ae6ce523534a8fc9f

data/CHANGELOG.ja.md

@@ -2,6 +2,14 @@
 
 [English](CHANGELOG.md) | 日本語
 
+## 0.2.0 - 2026-11-01
+
+- `oops status` を追加。`recording`・`paused`・`off` のどれかを 1 行で出力し、記録中のときだけ終了コード 0 を返します。プロンプトやスクリプトから、このシェルが記録されているか確認できます。
+- `--time` オプションを追加。各 `$ コマンド` の前に開始時刻（ローカル時刻）を `# 2026-10-31 19:30:09 +09:00` の行として入れ、`--github` の要約にも足します。
+- `--output-only` オプションを追加。`$ コマンド` の行を省き、出力と `(exit N)` だけをコピーします。
+- `oops` と `oops err` に `-n N` オプションを追加。`oops -n 3` は `oops 3` と同じで、`oops err -n 2` は直近の失敗した 2 コマンドを（成功したコマンドは飛ばして）古い順にコピーします。[@ricky9408](https://github.com/ricky9408) さんによる貢献（[#22](https://github.com/ysb3996-blip/oops/pull/22)）。
+- メールアドレスのマスクが、`/opt/homebrew/opt/mysql@8.4` や `go@1.27` のような版付きの名前を伏せないように修正。ドメインの最後の部分が、実際のトップレベルドメインのように英字のときだけ伏せます（[#24](https://github.com/ysb3996-blip/oops/issues/24)）。
+
 ## 0.1.0 - 2026-10-30
 
 最初のバージョン。

data/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 English | [日本語](CHANGELOG.ja.md)
 
+## 0.2.0 - 2026-11-01
+
+- `oops status` prints `recording`, `paused` or `off` on one line and exits 0 only when recording, so a prompt or script can show whether this shell is recorded.
+- `--time` option: adds the local time each command started as a `# 2026-10-31 19:30:09 +09:00` line before `$ command`, and to the `--github` summary.
+- `--output-only` option: leaves out the `$ command` line and copies only the output and `(exit N)`.
+- `-n N` option for `oops` and `oops err`: `oops -n 3` is the same as `oops 3`, and `oops err -n 2` copies the last 2 failed commands (oldest first), skipping over successful ones. Contributed by [@ricky9408](https://github.com/ricky9408) in [#22](https://github.com/ysb3996-blip/oops/pull/22).
+- Email masking no longer hides versioned names such as `/opt/homebrew/opt/mysql@8.4` or `go@1.27`: the last part of the domain must now be letters, like a real top-level domain ([#24](https://github.com/ysb3996-blip/oops/issues/24)).
+
 ## 0.1.0 - 2026-10-30
 
 First version.

data/README.ja.md

@@ -2,8 +2,12 @@
 
 [English](README.md) | 日本語
 
+[![Gem Version](https://img.shields.io/gem/v/oops-cli)](https://rubygems.org/gems/oops-cli) [![CI](https://github.com/ysb3996-blip/oops/actions/workflows/ci.yml/badge.svg)](https://github.com/ysb3996-blip/oops/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
 直前のシェルコマンドとその出力を、貼り付けられる形でクリップボードにコピーします。
 
+![デモ: テストが失敗し、oops がコマンドと出力をコピーし、コメント行と pbpaste でクリップボードの中身(コードブロック)を見せる。続いて cat .env、oops で API キーが [secret] になる](docs/demo.gif)
+
 コマンドを実行して失敗した。その結果をチャットのアシスタントや Slack の同僚、GitHub の issue に見せたい。普通は、出力をドラッグで選択してコピーし、貼り付けて、コードフェンスを自分で付ける、という手間がかかります。oops なら 2 ステップです。
 
 1. `oops`（直前の失敗したコマンドなら `oops err`）と打つ。
@@ -48,11 +52,13 @@ eval "$(oops init bash)"   # bash
 | コマンド | 内容 |
 |---|---|
 | `oops` | 直前のコマンドとその出力をコピーする |
-| `oops 3` | 直前の 3 コマンドを（古い順に）1 つのコードブロックとしてコピーする |
+| `oops 3` / `oops -n 3` | 直前の 3 コマンドを（古い順に）1 つのコードブロックとしてコピーする |
 | `oops err` | 終了コードが 0 以外だった直近のコマンドをコピーする（成功したコマンドは飛ばす） |
+| `oops err -n 2` | 直近の失敗した 2 コマンドを古い順にコピーする（成功したコマンドは飛ばす） |
 | `oops init zsh` / `oops init bash` | シェルのスニペットを出力する（`eval` 用） |
 | `oops doctor` | 記録・フック・クリップボード・設定・ログサイズを診断する |
 | `oops pause` / `oops resume` | 記録を止める／再開する。停止中は何もディスクに書かれない |
+| `oops status` | `recording`・`paused`・`off` のどれかを 1 行で出力する（スクリプトやプロンプト向け） |
 | `oops record -- <shell>` | 内部用: 記録用プログラムの下でシェルを起動する。スニペットが呼び出す |
 | `oops --version`, `oops --help` | バージョンと使い方 |
 
@@ -60,11 +66,16 @@ eval "$(oops init bash)"   # bash
 
 | オプション | 内容 |
 |---|---|
+| `-n N` | 直前の N コマンドをコピーする（`err` と併用すると直近の失敗した N コマンド） |
 | `--github` | GitHub の issue / PR コメント向けの書式にする |
 | `--tail N` | 出力の最後の N 行だけ残す |
 | `--head N` | 出力の最初の N 行だけ残す（`--tail` と併用すると両端を残す） |
+| `--time` | 各コマンドの開始時刻を `# 2026-10-31 19:30:09 +09:00` の行として付ける |
+| `--output-only` | `$ コマンド` の行を省き、出力だけをコピーする |
 | `--show-secrets` | 秘密情報をマスクせず、置換テーブルも適用しない |
 
+`N` は正の整数で指定します。件数は位置引数の `N` または `-n N` のどちらかで 1 回だけ指定でき、併用や `-n` の繰り返しは使い方の誤りになります。対象のコマンドが指定件数より少なければ、見つかった分をコピーします。`-n` は上記の書式オプションと併用できます。
+
 `oops` 自身はコピー対象になりません。直前のコマンドが `oops` だった場合は、その前のコマンドがコピーされます。
 
 終了コード: `0` コピーした、`1` コピーしなかった（記録していない、まだコマンドがない、失敗したコマンドがない、一時停止中、クリップボードのコマンドが失敗）、`2` 使い方の誤り。
@@ -118,6 +129,22 @@ $ bundle exec rspec
 
 `oops --tail 50` は出力の最後の 50 行を残し、その前に `... 2,950 lines omitted ...` を入れます。`--head 20` は最初の 20 行を残し、その後ろに同じ印を入れます。両方指定すると、中間が印 1 行に置き換わります。`oops 3` では、行数の制限は各コマンドごとに適用されます。
 
+### `--time` と `--output-only`
+
+`oops --time` は、各 `$ コマンド` の前にコマンドを始めたローカル時刻を `#` の行として入れ、`--github` の要約にも時刻を足します。`oops --output-only` は `$ コマンド` の行を省いて出力と `(exit N)` だけを残します。画面に出る `copied: $ ...` の行と `--github` の要約には、コマンドの代わりに終了コードと行数だけが出ます。どちらも他のオプションと併用できます。
+
+````
+```
+# 2026-10-31 19:30:09 +09:00
+....F
+(exit 1)
+```
+````
+
+### `oops status`
+
+`oops status` は `recording`・`paused`・`off`（このシェルが記録されていない、またはログが削除された）のどれかを出力し、記録中のときだけ終了コード `0` を返します。エラーは出さないので、プロンプトやスクリプトから呼べます（例: [starship のカスタムモジュール](https://starship.rs/config/#custom-commands)）。呼ぶたびに Ruby が起動するため 0.1〜0.2 秒ほどかかります。`off` のときの詳しい理由は `oops doctor` で分かります。
+
 ## 設定
 
 任意の設定ファイルは `${XDG_CONFIG_HOME:-~/.config}/oops/config.yml` です。
@@ -143,6 +170,8 @@ clipboard: auto     # auto | pbcopy | wl-copy | xclip | xsel | clip.exe | osc52
 
 ## 仕組み
 
+![oops の仕組み: 録音機があなたとシェルの間にいて、コマンドはディスク上のノートに書かれ、oops と打つと最後のページを秘密を隠して写し、どこにでも貼れる](docs/how-it-works.ja.svg)
+
 1. `oops init` は、rc ファイルから `eval` するスニペットを出力します。まだ記録されていない端末の対話シェルでは、シェルを `oops record` の下で再起動します。
 2. `oops record` は、Ruby 製の小さな pty 中継です。キー入力とシェルの出力をそのまま通し、ウィンドウのリサイズをシェルに伝えます。
 3. シェルのフック（zsh は `preexec`/`precmd`、bash は `DEBUG` トラップと `PROMPT_COMMAND`）が、各コマンドの前後に目に見えない APC マーカーを出力します。中継がそれを取り除くので、端末には見えません。
@@ -152,6 +181,7 @@ clipboard: auto     # auto | pbcopy | wl-copy | xclip | xsel | clip.exe | osc52
 ## プライバシーとセキュリティ
 
 - セッションログには、記録されたすべてのコマンドの生の出力が**マスクされないまま**入っています。マスクと置換テーブルはコピーするときにだけ適用されます。ログは `${XDG_STATE_HOME:-~/.local/state}/oops/sessions/` にあり、あなただけが読めます（ファイルは 0600、ディレクトリは 0700）。すべて削除するには `rm -rf "${XDG_STATE_HOME:-$HOME/.local/state}/oops"` を実行します（標準では `rm -rf ~/.local/state/oops`）。ディスクに残したくない秘密情報を表示する前には `oops pause` を使ってください。
+- セキュリティ上の問題を非公開で報告する方法は [SECURITY.ja.md](SECURITY.ja.md) を見てください。公開の issue には書かないでください。
 - 記録される出力は信頼できません。実行したプログラムは、oops のマーカーに見せかけたテキストを出力できます。そのため oops は、`oops pause` / `oops resume` が作るフラグファイルと一致する一時停止・再開マーカーにだけ従います。出力によって黙って記録を止められることはありません。ただし、プログラムがログ上でコマンドの開始と終了の位置を偽装することはできるので、貼り付ける内容は確認してください。
 
 ## 既知の制限
@@ -207,11 +237,11 @@ bundle exec exe/oops doctor
 
 ```sh
 gem build oops-cli.gemspec
-gem install ./oops-cli-0.1.0.gem     # ファイル名は lib/oops/version.rb に合わせる
+gem install ./oops-cli-0.2.0.gem     # ファイル名は lib/oops/version.rb に合わせる
 rbenv rehash                         # rbenv を使う場合のみ
 ```
 
-- gem は Ruby のバージョンごとに入ります。新しいタブが、インストールした Ruby とは別の Ruby を使っていると（たとえばリポジトリは 4.0.9 を指定しているのに、標準の Ruby が 3.3.5 の場合）、シェルに `oops: command not found` と出ます。その Ruby でも `gem install` を実行してください（例: `RBENV_VERSION=3.3.5 gem install ./oops-cli-0.1.0.gem`）。
+- gem は Ruby のバージョンごとに入ります。新しいタブが、インストールした Ruby とは別の Ruby を使っていると（たとえばリポジトリは 4.0.9 を指定しているのに、標準の Ruby が 3.3.5 の場合）、シェルに `oops: command not found` と出ます。その Ruby でも `gem install` を実行してください（例: `RBENV_VERSION=3.3.5 gem install ./oops-cli-0.2.0.gem`）。
 - 変更のたびに入れ直してください。インストールされた gem はコピーで、チェックアウトへのリンクではありません。
 - 削除するには `gem uninstall oops-cli` です。
 - `eval "$(oops init zsh)"` は、プロンプトで打つだけでなく rc ファイルに書いてください。記録されるシェルは rc ファイルを読み直すため、行がないとフックが入りません（`oops doctor` に `hooks: missing` と出ます）。

data/README.md

@@ -2,8 +2,12 @@
 
 English | [日本語](README.ja.md)
 
+[![Gem Version](https://img.shields.io/gem/v/oops-cli)](https://rubygems.org/gems/oops-cli) [![CI](https://github.com/ysb3996-blip/oops/actions/workflows/ci.yml/badge.svg)](https://github.com/ysb3996-blip/oops/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
 Copy the last shell command and its output to the clipboard, ready to paste.
 
+![Demo: a test fails, oops copies the command and its output, a comment line and pbpaste show what is on the clipboard; then cat .env, oops, and the API key is shown as [secret]](docs/demo.gif)
+
 You ran a command and it failed. You want to show it to a chat assistant, a teammate on Slack, or a GitHub issue. Normally that means dragging to select the output, copying, pasting, and adding the code fences yourself. With oops it is two steps:
 
 1. Type `oops` (or `oops err` for the last failed command).
@@ -48,11 +52,13 @@ To turn oops off for one shell, start it with `OOPS_DISABLE=1` (for example `OOP
 | Command | What it does |
 |---|---|
 | `oops` | Copy the last command and its output |
-| `oops 3` | Copy the last 3 commands (oldest first) as one code block |
+| `oops 3` / `oops -n 3` | Copy the last 3 commands (oldest first) as one code block |
 | `oops err` | Copy the last command that exited non-zero, skipping over successful ones |
+| `oops err -n 2` | Copy the last 2 failed commands (oldest first), skipping over successful ones |
 | `oops init zsh` / `oops init bash` | Print the shell snippet (for `eval`) |
 | `oops doctor` | Diagnose recording, hooks, clipboard, config and log size |
 | `oops pause` / `oops resume` | Stop and restart recording. While paused, nothing is written to disk |
+| `oops status` | Print `recording`, `paused` or `off` on one line, for scripts and prompts |
 | `oops record -- <shell>` | Internal: runs a shell under the recorder. The snippet calls this |
 | `oops --version`, `oops --help` | Version and usage |
 
@@ -60,11 +66,16 @@ Options for `oops`, `oops N` and `oops err`:
 
 | Option | What it does |
 |---|---|
+| `-n N` | Copy the last N commands (with `err`, the last N failed commands) |
 | `--github` | Format for a GitHub issue or PR comment |
 | `--tail N` | Keep only the last N output lines |
 | `--head N` | Keep only the first N output lines (with `--tail`, keeps both ends) |
+| `--time` | Add the time each command started as a `# 2026-10-31 19:30:09 +09:00` line |
+| `--output-only` | Leave out the `$ command` line and copy only the output |
 | `--show-secrets` | Do not mask secrets and do not apply the replace table |
 
+`N` must be a positive integer. Specify the command count once, either as a positional `N` or with `-n N`; combining them or repeating `-n` is a usage error. If fewer matching commands are available, oops copies those it finds. `-n` can be combined with the formatting options above.
+
 `oops` never copies itself: if the previous command was `oops`, you get the command before it.
 
 Exit codes: `0` copied, `1` nothing copied (not recording, no command yet, no failed command, paused, or the clipboard command failed), `2` usage error.
@@ -118,6 +129,22 @@ $ bundle exec rspec
 
 `oops --tail 50` keeps the last 50 lines of output and puts `... 2,950 lines omitted ...` before them. `--head 20` keeps the first 20 and puts the marker after. With both, the middle is replaced by one marker line. With `oops 3`, the limits apply to each command.
 
+### `--time` and `--output-only`
+
+`oops --time` puts the local time the command started on a `#` line before each `$ command`, and adds it to the `--github` summary. `oops --output-only` leaves out the `$ command` line and keeps the output and `(exit N)`; the `copied: $ ...` line on screen and the `--github` summary then show the exit code and line count without the command. Both can be combined with the other options:
+
+````
+```
+# 2026-10-31 19:30:09 +09:00
+....F
+(exit 1)
+```
+````
+
+### `oops status`
+
+`oops status` prints `recording`, `paused` or `off` (this shell is not recorded, or its log was deleted) and exits `0` only when recording. It prints no error, so a prompt or script can call it, for example with a [starship custom module](https://starship.rs/config/#custom-commands). Each call starts Ruby, which takes roughly 0.1 to 0.2 seconds; `oops doctor` tells more when the answer is `off`.
+
 ## Configuration
 
 Optional file at `${XDG_CONFIG_HOME:-~/.config}/oops/config.yml`:
@@ -143,6 +170,8 @@ Masking is pattern based, so it is a safety net, not a guarantee: a secret in a
 
 ## How it works
 
+![How oops works: a recorder sits between you and your shell, every command is written to a notebook on your disk, typing oops copies the last page with secrets hidden, and you paste it anywhere](docs/how-it-works.svg)
+
 1. `oops init` prints a snippet that you `eval` from your rc file. In an interactive shell on a terminal that is not recorded yet, it restarts the shell under `oops record`.
 2. `oops record` is a small Ruby pty relay: it passes your keystrokes and the shell's output through untouched and forwards window resizes to the shell.
 3. Hooks in the shell (zsh `preexec`/`precmd`, bash `DEBUG` trap and `PROMPT_COMMAND`) emit invisible APC markers around each command. The relay strips them, so your terminal never sees them.
@@ -152,6 +181,7 @@ Masking is pattern based, so it is a safety net, not a guarantee: a secret in a
 ## Privacy and security
 
 - The session logs hold the raw, **unmasked** output of every recorded command. Masking and the replace table are applied only when you copy. The logs live under `${XDG_STATE_HOME:-~/.local/state}/oops/sessions/`, readable only by you (mode 0600, directory 0700). To delete all of them, run `rm -rf "${XDG_STATE_HOME:-$HOME/.local/state}/oops"` (by default `rm -rf ~/.local/state/oops`). Use `oops pause` before showing secrets you do not want on disk.
+- To report a security problem privately, see [SECURITY.md](SECURITY.md). Please do not open a public issue for it.
 - Recorded output is untrusted: any program you run can print text that looks like oops's markers. oops therefore obeys a pause or resume marker only when it agrees with the flag file that `oops pause` and `oops resume` set, so output cannot silently pause recording. A program can still fake where a command starts and ends in the log, so check what you paste.
 
 ## Known limitations
@@ -207,11 +237,11 @@ To try it as your shell does, build and install the gem into the Ruby you are us
 
 ```sh
 gem build oops-cli.gemspec
-gem install ./oops-cli-0.1.0.gem     # the file name follows lib/oops/version.rb
+gem install ./oops-cli-0.2.0.gem     # the file name follows lib/oops/version.rb
 rbenv rehash                         # only with rbenv
 ```
 
-- A gem is installed per Ruby version. If a new tab uses another Ruby than the one you installed into (for example the repository pins 4.0.9, but your global Ruby is 3.3.5), the shell prints `oops: command not found`. Run `gem install` again under that Ruby, e.g. `RBENV_VERSION=3.3.5 gem install ./oops-cli-0.1.0.gem`.
+- A gem is installed per Ruby version. If a new tab uses another Ruby than the one you installed into (for example the repository pins 4.0.9, but your global Ruby is 3.3.5), the shell prints `oops: command not found`. Run `gem install` again under that Ruby, e.g. `RBENV_VERSION=3.3.5 gem install ./oops-cli-0.2.0.gem`.
 - Reinstall after every change. The installed gem is a copy, not a link to your checkout.
 - To remove it: `gem uninstall oops-cli`.
 - Put `eval "$(oops init zsh)"` in your rc file, not just at the prompt: the recorded shell reads the rc file again, and without the line it has no hooks (`oops doctor` shows `hooks: missing`).

data/SECURITY.ja.md

@@ -0,0 +1,34 @@
+# セキュリティポリシー
+
+[English](SECURITY.md) | 日本語
+
+oops はシェルの操作を録画し、秘密情報を含みうる文字列を扱います。それがうまくいかないケースを見つけたら、まず非公開で教えてください。
+
+## 対象バージョン
+
+| バージョン | 対応 |
+|---|---|
+| RubyGems 上の最新の 0.x リリース | あり |
+| それより古いリリース | なし。アップグレードしてください |
+
+## セキュリティ問題とみなすもの
+
+- oops がマスクすると言っている形式の秘密情報（README の「設定」を参照）が、マスクされずにコピーされる。
+- セッションログやそのディレクトリが、ファイル `0600`・ディレクトリ `0700` より緩い権限で作られる。
+- 録画機（`oops record`）が、説明された振る舞いを超えて何かをする。どこかへデータを送る、勝手にコマンドを実行する、状態ディレクトリの外に書き込む、など。
+- プログラムの出力によって、ユーザーの操作なしに記録が止まったり再開したり、oops を操れたりする。
+- 設定ファイルや独自の `clipboard:` コマンドで、本来できないはずのコードが実行できる。
+
+oops が対応を謳っていない形式の秘密情報が通るのは脆弱性ではありません。マスクはパターンに基づくもので、README にもそう書いています。パターンの追加は通常の issue で頼んでください（[issue #15](https://github.com/ysb3996-blip/oops/issues/15) を参照）。
+
+## 報告方法
+
+GitHub の非公開の脆弱性報告を使ってください: [アドバイザリの下書きを作る](https://github.com/ysb3996-blip/oops/security/advisories/new)。メンテナだけが読めます。セキュリティ問題は、公開の issue や pull request には書かないでください。
+
+報告には、**実際の秘密情報やセッションログを絶対に貼らないでください**。秘密情報は同じ形の作り物の値（例: `sk-live-XXXXXXXXXXXXXXXX`）に置き換え、ログはファイルを添付せず該当行を言葉で説明してください。セッションログには、記録した全コマンドの生の（マスクされていない）出力が入っています。
+
+## 対応の目安
+
+- 7 日以内に受け取りの連絡をします。
+- パッチリリースで修正し、CHANGELOG に変更を載せます。希望しない場合を除き、そこに報告者の名前を記載します。
+- アドバイザリは修正版のリリース後に公開します。

data/SECURITY.md

@@ -0,0 +1,34 @@
+# Security policy
+
+English | [日本語](SECURITY.ja.md)
+
+oops records your shell session and handles text that may contain secrets. If you find a way for that to go wrong, please tell us privately first.
+
+## Supported versions
+
+| Version | Supported |
+|---|---|
+| Latest 0.x release on RubyGems | Yes |
+| Older releases | No, please upgrade |
+
+## What counts as a security issue
+
+- A secret in a format oops says it masks (see "Configuration" in the README) that is copied unmasked.
+- Session logs, or their directory, created with looser permissions than `0600` for files and `0700` for the directory.
+- The recorder (`oops record`) doing anything beyond its documented behavior: sending data anywhere, running commands on its own, or writing outside the state directory.
+- Program output that can pause or resume recording, or otherwise control oops, without the user asking for it.
+- The config file or a custom `clipboard:` command being able to run code it should not.
+
+A secret in a format oops does not claim to know is not a vulnerability: masking is pattern based and the README says so. Ask for the pattern in a regular issue instead (see [issue #15](https://github.com/ysb3996-blip/oops/issues/15)).
+
+## How to report
+
+Use GitHub's private vulnerability reporting: [open a draft advisory](https://github.com/ysb3996-blip/oops/security/advisories/new). Only the maintainer can see it. Please do not open a public issue or pull request for a security problem.
+
+In the report, **never paste a real secret or a session log**. Replace secrets with made-up values of the same shape (for example `sk-live-XXXXXXXXXXXXXXXX`), and describe the log line instead of attaching the file. Session logs hold the raw, unmasked output of every recorded command.
+
+## What to expect
+
+- An acknowledgement within 7 days.
+- A fix in a patch release, with the change listed in the CHANGELOG. You will be credited there unless you ask not to be.
+- The advisory is published after the fix is released.

data/lib/oops/cli.rb

@@ -11,6 +11,9 @@ module Oops
 
     NO_CLIPBOARD = "no clipboard tool found (tried pbcopy, wl-copy, xclip, xsel, clip.exe, OSC 52).".freeze
     POSITIVE_INTEGER = /\A\d+\z/
+    CopyTarget = Data.define(:count, :failed_only)
+    COUNT_REPEATED = "specify the command count only once (N or -n)".freeze
+    private_constant :CopyTarget, :COUNT_REPEATED
 
     def self.run(argv, env: ENV, stdin: $stdin, stdout: $stdout, stderr: $stderr)
       case argv.first
@@ -18,14 +21,24 @@ module Oops
       when "init" then return init(argv.drop(1), stdout: stdout, stderr: stderr)
       when "doctor" then return doctor(argv.drop(1), env: env, stdin: stdin, stdout: stdout)
       when "pause", "resume" then return toggle(argv.first, argv.drop(1), env: env, stdout: stdout)
+      when "status" then return status(argv.drop(1), env: env, stdout: stdout, stderr: stderr)
       end
 
-      options = { head: nil, tail: nil, github: false, show_secrets: false }
+      options = { head: nil, tail: nil, github: false, show_secrets: false, time: false, output_only: false }
+      count = nil
       parser = OptionParser.new do |o|
-        o.banner = "Usage: oops [N | err] [options]\n       oops init <shell> | pause | resume | doctor"
+        o.banner = "Usage: oops [N | err] [-n N] [options]\n       " \
+                   "oops init <shell> | pause | resume | status | doctor"
+        o.on("-n N", "Copy the last N commands (with err, last N failures)") do |v|
+          raise UsageError, COUNT_REPEATED if count
+
+          count = positive(v, "-n")
+        end
         o.on("--github", "Format for a GitHub issue or PR comment") { options[:github] = true }
         o.on("--tail N", "Keep only the last N output lines") { |v| options[:tail] = positive(v, "--tail") }
         o.on("--head N", "Keep only the first N output lines") { |v| options[:head] = positive(v, "--head") }
+        o.on("--time", "Add the time each command started") { options[:time] = true }
+        o.on("--output-only", "Leave out the command line, keep the output") { options[:output_only] = true }
         o.on("--show-secrets", "Do not mask secrets or apply the replace table") { options[:show_secrets] = true }
         o.on("-v", "--version", "Print version and exit") do
           stdout.puts "oops #{VERSION}"
@@ -36,7 +49,7 @@ module Oops
           return 0
         end
       end
-      copy(target(parser.parse(argv)), options, env: env, stdout: stdout, stderr: stderr)
+      copy(target(parser.parse(argv), count: count), options, env: env, stdout: stdout, stderr: stderr)
     rescue OptionParser::ParseError, UsageError => e
       stderr.puts "oops: #{e.message}"
       2
@@ -51,17 +64,18 @@ module Oops
       value.to_i
     end
 
-    # Positional arguments: none (the last command), N (the last N commands)
-    # or "err" (the last failed command). Returns 1, N or :err.
-    def self.target(args)
+    # Count comes from either a positional N or -n N. "err" filters the
+    # selection to failed commands; without a count, one command is copied.
+    def self.target(args, count:)
       raise UsageError, "unexpected argument: #{args[1]}" if args.size > 1
 
       arg = args.first
-      return 1 if arg.nil?
-      return :err if arg == "err"
-      return positive(arg, "N") if arg.match?(/\A[+-]?\d/)
+      return CopyTarget.new(count: count || 1, failed_only: arg == "err") if arg.nil? || arg == "err"
+
+      raise UsageError, "unknown command: #{arg}" unless arg.match?(/\A[+-]?\d/)
+      raise UsageError, COUNT_REPEATED if count
 
-      raise UsageError, "unknown command: #{arg}"
+      CopyTarget.new(count: positive(arg, "N"), failed_only: false)
     end
 
     def self.copy(target, options, env:, stdout:, stderr:)
@@ -70,8 +84,8 @@ module Oops
 
       config = Config.load(env: env)
       config.warnings.each { |w| stderr.puts "oops: warning: #{w}" }
-      records = target == :err ? [log.last_failed].compact : log.last(target)
-      raise Failure, (target == :err ? "no failed command found." : "no command found yet.") if records.empty?
+      records = log.last(target.count, failed_only: target.failed_only)
+      raise Failure, (target.failed_only ? "no failed command found." : "no command found yet.") if records.empty?
 
       home = env["HOME"].to_s.empty? ? Dir.home : env["HOME"]
       result = Formatter.new(config: config, home: home, **options).format(records)
@@ -144,6 +158,24 @@ module Oops
       stdout.flush
     end
 
+    # `oops status`: one word on stdout. "recording" exits 0; "paused" and
+    # "off" (this shell is not recorded, or its log is gone) exit 1 without a
+    # message, so a prompt can call it.
+    def self.status(args, env:, stdout:, stderr:)
+      unless args.empty?
+        stderr.puts "oops: usage: oops status"
+        return 2
+      end
+
+      path = env["OOPS_SESSION"].to_s
+      word = if path.empty? || !File.file?(path) then "off"
+             elsif SessionLog.new(path).paused? then "paused"
+             else "recording"
+             end
+      stdout.puts word
+      word == "recording" ? 0 : 1
+    end
+
     # `oops doctor`: diagnostics on stdout; always exits 0.
     def self.doctor(args, env:, stdin:, stdout:)
       raise UsageError, "usage: oops doctor" unless args.empty?
@@ -181,6 +213,6 @@ module Oops
     end
 
     private_class_method :positive, :target, :copy, :report_command, :report_counts, :recording_log, :toggle,
-                         :write_marker, :doctor
+                         :write_marker, :status, :doctor
   end
 end

data/lib/oops/formatter.rb

@@ -4,7 +4,9 @@ module Oops
   # Per field (command line and output) the pipeline is: strip ANSI, scrub
   # invalid UTF-8, shorten the home directory to "~", mask secrets, apply the
   # config replace table. Output is then truncated (head/tail) and fenced.
-  # With show_secrets, the home/mask/replace steps are skipped.
+  # With show_secrets, the home/mask/replace steps are skipped. With time, a
+  # "# <local start time>" line precedes each command; with output_only, the
+  # "$ command" line is left out.
   class Formatter
     GITHUB_COLLAPSE_LINES = 30
 
@@ -13,13 +15,18 @@ module Oops
     # command_line: the formatted first command, without "$ " or indentation.
     Result = Struct.new(:text, :lines, :masked_count, :command_line)
 
-    def initialize(config:, home: Dir.home, show_secrets: false, head: nil, tail: nil, github: false)
+    TIME_FORMAT = "%Y-%m-%d %H:%M:%S %:z".freeze
+
+    def initialize(config:, home: Dir.home, show_secrets: false, head: nil, tail: nil, github: false,
+                   time: false, output_only: false)
       @config = config
       @home = home.to_s
       @show_secrets = show_secrets
       @head = head
       @tail = tail
       @github = github
+      @time = time
+      @output_only = output_only
       @masked = 0
     end
 
@@ -37,9 +44,21 @@ module Oops
       shown, count = shown_lines(clean(PromptSp.strip(record.output.to_s)))
       exit_code = record.exit
       exit_code = nil if exit_code.to_i.zero?
-      body = ["$ #{command.gsub("\n", "\n  ").gsub(/^ +$/, '')}", *shown]
+      stamp = start_time(record)
+      body = []
+      body << "# #{stamp}" if stamp
+      body << "$ #{command.gsub("\n", "\n  ").gsub(/^ +$/, '')}" unless @output_only
+      body.concat(shown)
       body << "(exit #{exit_code})" if exit_code
-      { command: command, exit: exit_code, count: count, content: body.join("\n") }
+      { command: command, exit: exit_code, count: count, time: stamp, content: body.join("\n") }
+    end
+
+    # Local time the command started, or nil without --time or for a record
+    # that has no start time.
+    def start_time(record)
+      return nil unless @time && record.started_at
+
+      Time.at(record.started_at.to_i).strftime(TIME_FORMAT)
     end
 
     # Returns [lines to show, real output line count]: trailing blank lines
@@ -98,13 +117,20 @@ module Oops
       parts = []
       parts << "exit #{block[:exit]}" if block[:exit]
       parts << "#{block[:count]} lines"
-      summary = escape_html("$ #{block[:command]}".gsub("\n", " "))
-      "<details>\n<summary><code>#{summary}</code> — #{parts.join(', ')}</summary>\n\n#{fence}\n</details>\n"
+      parts << block[:time] if block[:time]
+      summary = parts.join(", ")
+      unless @output_only
+        command = escape_html("$ #{block[:command]}".gsub("\n", " "))
+        summary = "<code>#{command}</code> — #{summary}"
+      end
+      "<details>\n<summary>#{summary}</summary>\n\n#{fence}\n</details>\n"
     end
 
     def fenced(content, language)
       longest = content.scan(/`+/).map(&:length).max.to_i
       fence = "`" * [3, longest + 1].max
+      return "#{fence}#{language}\n#{fence}\n" if content.empty?
+
       "#{fence}#{language}\n#{content}\n#{fence}\n"
     end
 

data/lib/oops/secrets.rb

@@ -26,7 +26,9 @@ module Oops
       # limit) everything after BEGIN is masked.
       /-----BEGIN [A-Z ]*PRIVATE KEY-----.*?(?:-----END [A-Z ]*PRIVATE KEY-----|\z)/m,
       %r{\b[a-z][a-z0-9+.-]*://(?<secret>[^\s/@:]+:[^\s/@]+)@}i, # URL userinfo
-      %r{[A-Za-z0-9._%+-]+@(?>[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+)(?!:[\w~/])}, # email, not scp-style git@host:path
+      # Email. The last label must be letters, like a real TLD, so versioned
+      # names such as mysql@8.4 stay; the lookahead skips git@host:path.
+      %r{[A-Za-z0-9._%+-]+@(?>(?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,})(?![A-Za-z0-9-])(?!:[\w~/])},
       # Public IPv4: not private/loopback/unspecified, and not part of a longer
       # dotted number such as a version string (1.2.3.4.5).
       Regexp.new(

data/lib/oops/session_log.rb

@@ -93,11 +93,13 @@ module Oops
       nil
     end
 
-    # Newest count finished, non-oops records, oldest first.
-    def last(count, skip_oops: true)
+    # Newest count finished, non-oops records, oldest first. With failed_only,
+    # only records with a non-zero integer exit status count toward the limit.
+    def last(count, skip_oops: true, failed_only: false)
       found = []
       each_backward do |r|
         next if r.exit.nil? || (skip_oops && r.oops_self?)
+        next if failed_only && (!r.exit.is_a?(Integer) || r.exit.zero?)
 
         found << r
         :stop if found.size >= count
@@ -106,10 +108,7 @@ module Oops
     end
 
     def last_failed
-      each_backward do |r|
-        return r if r.exit.is_a?(Integer) && r.exit != 0 && !r.oops_self?
-      end
-      nil
+      last(1, failed_only: true).first
     end
 
     def paused?

data/lib/oops/version.rb

@@ -1,3 +1,3 @@
 module Oops
-  VERSION = "0.1.0".freeze
+  VERSION = "0.2.0".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: oops-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - ysb3996-blip
@@ -22,6 +22,8 @@ files:
 - LICENSE
 - README.ja.md
 - README.md
+- SECURITY.ja.md
+- SECURITY.md
 - exe/oops
 - lib/oops.rb
 - lib/oops/ansi.rb