lumitrace 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4be2a97656c1b025f8ae4c8eacf1f1d00969f0759de4b838fdb0681610689e76
-  data.tar.gz: a2142bb03fec41ed02668ae63c27437dfe885f874bbb758cb1b5649fde2df635
+  metadata.gz: 6f9613f9bc59b3d2a7c6db68d99848cd710558e4ca439f4fb53203664cfeeb6f
+  data.tar.gz: e0f9883071d78aa4f58464a00a41548d16acc7b54ad7370734b069e50ad3e1b8
 SHA512:
-  metadata.gz: 42b5a8463939fe9820d9cce36bc56f2b3bb5eb2759096f975f517460d371969353a0fe322181fb7ab153eb94f388888f4118b8c9e5eebcd1b744046c778874e3
-  data.tar.gz: f076ae99fdfd6f0f28d77f29957c504e254609b1812a265b3353c368173007bbd21570c683064b9704bf8e81c49132bef2e03f573987047c27e09229e272082b
+  metadata.gz: 43205f665f9ba2a569fb4557f8c404498c314fe9e8bf6af542903a2522e101d786b6088437337131d10b2a7185b26ca528da3bab051f7006ce295ef3accbf920
+  data.tar.gz: '08241616a2b0c65463290e4f523ff0050d473eb8516d1c3aae5bd2a5602933d27e137786a99abe5c7b4405208127300daf61122d0dcdbc9547c65da4ec0b48dc'

data/README.md

@@ -67,6 +67,9 @@ lumitrace help --format json
 lumitrace schema --format json
 ```
 
+AI-oriented usage guide (Japanese):
+- `docs/tutorial.ja.md` section "AI と使う"
+
 ### Library
 
 Enable instrumentation and HTML output at exit:

data/docs/ai-help.md

@@ -2,7 +2,7 @@
 
 # Lumitrace Help
 
-- Version: 0.4.0
+- Version: 0.4.1
 - Help version: 1
 - Primary JSON entrypoint: `lumitrace help --format json`
 - Schema JSON entrypoint: `lumitrace schema --format json`
@@ -13,6 +13,12 @@
 - Run lumitrace with `--collect-mode` and optional `--max-samples`.
 - Inspect JSON/HTML/text outputs depending on your task.
 
+## AI Usage Tips
+- First run with `--collect-mode types` to get a compact shape of runtime behavior.
+- Then switch to `--collect-mode last` for final value inspection on suspicious lines.
+- Use `--collect-mode history --max-samples N` only when value transitions matter.
+- Combine `--range` or `--git-diff` to keep outputs small and focused.
+
 ## Commands
 - `lumitrace [options] script.rb [ruby_opt]`
   - Run a Ruby script with Lumitrace enabled.

data/docs/ai-schema.md

@@ -2,7 +2,7 @@
 
 # Lumitrace JSON Schema
 
-- Version: 0.4.0
+- Version: 0.4.1
 - Schema version: 1
 - Top level: array of event
 

data/docs/tutorial.ja.md

@@ -294,6 +294,37 @@ GitHub Actions への追加手順（`LUMITRACE_GIT_DIFF` や Pages へのアッ
 
 fork/exec の結果はデフォルトでマージされます。親プロセスが最終出力を行い、子プロセスは `LUMITRACE_RESULTS_DIR` に断片 JSON を保存します。
 
+### AI と使う
+
+AI に読ませる前提なら、次の順番にすると効率が良いです。
+
+1. まず型分布だけ取る（安く全体像を見る）
+
+```bash
+lumitrace --collect-mode types -j path/to/entry.rb
+```
+
+2. 次に最終値を見る（値の当たりを付ける）
+
+```bash
+lumitrace --collect-mode last -j path/to/entry.rb
+```
+
+3. 変化が必要な箇所だけ履歴を見る
+
+```bash
+lumitrace --collect-mode history --max-samples 5 -j path/to/entry.rb
+```
+
+4. 対象を絞る（トークン節約）
+
+```bash
+lumitrace --collect-mode last -j --range path/to/entry.rb:120-180 path/to/entry.rb
+lumitrace --collect-mode last -j -g path/to/entry.rb
+```
+
+補助情報は `lumitrace help --format json` と `lumitrace schema --format json` で機械可読に取得できます。
+
 ## 2. ライブラリとして使う
 
 CLI を使わずアプリに組み込みたい場合はここから始めます。

data/lib/lumitrace/ai_docs.rb

@@ -27,6 +27,11 @@ module Lumitrace
     lines << ""
     lines << "## Recommended Flow"
     data[:recommended_flow].each { |step| lines << "- #{step}" }
+    if data[:ai_usage_tips] && !data[:ai_usage_tips].empty?
+      lines << ""
+      lines << "## AI Usage Tips"
+      data[:ai_usage_tips].each { |tip| lines << "- #{tip}" }
+    end
     lines << ""
     lines << "## Commands"
     data[:commands].each do |cmd|

data/lib/lumitrace/help_manifest.rb

@@ -19,6 +19,12 @@ module Lumitrace
         "Run lumitrace with `--collect-mode` and optional `--max-samples`.",
         "Inspect JSON/HTML/text outputs depending on your task."
       ],
+      ai_usage_tips: [
+        "First run with `--collect-mode types` to get a compact shape of runtime behavior.",
+        "Then switch to `--collect-mode last` for final value inspection on suspicious lines.",
+        "Use `--collect-mode history --max-samples N` only when value transitions matter.",
+        "Combine `--range` or `--git-diff` to keep outputs small and focused."
+      ],
       commands: [
         {
           command: "lumitrace [options] script.rb [ruby_opt]",

data/lib/lumitrace/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lumitrace
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

data/runv/index.html

@@ -4,9 +4,9 @@
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
   <title>LumiTrace Playground</title>
-  <meta name="description" content="Run Ruby in the browser and see traced values inline with lumitrace 0.4.0.">
+  <meta name="description" content="Run Ruby in the browser and see traced values inline with lumitrace 0.4.1.">
   <meta property="og:title" content="LumiTrace Playground">
-  <meta property="og:description" content="Run Ruby in the browser and see traced values inline with lumitrace 0.4.0.">
+  <meta property="og:description" content="Run Ruby in the browser and see traced values inline with lumitrace 0.4.1.">
   <meta property="og:type" content="website">
   <meta property="og:url" content="https://github.com/ko1/lumitrace/tree/master/runv">
   <meta property="og:see_also" content="https://github.com/ko1/lumitrace/tree/master/runv">
@@ -290,7 +290,7 @@
   <header>
     <div>
       <h1>LumiTrace Playground</h1>
-      <p class="sub">Run Ruby in the browser and see traced values inline with lumitrace 0.4.0.</p>
+      <p class="sub">Run Ruby in the browser and see traced values inline with lumitrace 0.4.1.</p>
     </div>
   </header>
 

data/runv/sync_inline.rb

@@ -3,8 +3,14 @@
 index_path = File.expand_path("index.html", __dir__)
 record_path = File.expand_path("../lib/lumitrace/record_instrument.rb", __dir__)
 html_path = File.expand_path("../lib/lumitrace/generate_resulted_html.rb", __dir__)
+version_path = File.expand_path("../lib/lumitrace/version.rb", __dir__)
 
 index = File.read(index_path)
+version_src = File.read(version_path)
+version_match = version_src.match(/VERSION\s*=\s*"([^"]+)"/)
+abort "VERSION not found in #{version_path}" unless version_match
+version = version_match[1]
+
 record_code = File.read(record_path).rstrip
 html_code = File.read(html_path).lines.reject { |line|
   line.match?(/^\s*require_relative\s+["']record_instrument["']\s*$/)
@@ -25,5 +31,6 @@ unless index.match?(pattern)
 end
 
 index.sub!(pattern, generated)
+index.gsub!(/lumitrace \d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?\./, "lumitrace #{version}.")
 File.write(index_path, index)
 puts "updated #{index_path}"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lumitrace
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Koichi Sasada