@hasna/terminal 2.2.0 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/dist/cli.js +29 -12
  2. package/package.json +1 -1
  3. package/src/ai.ts +50 -36
  4. package/src/cli.tsx +29 -12
  5. package/src/context-hints.ts +89 -0
  6. package/src/discover.ts +238 -0
  7. package/src/economy.ts +53 -0
  8. package/src/output-store.ts +65 -0
  9. package/src/providers/index.ts +4 -4
  10. package/src/sessions-db.ts +81 -0
  11. package/temp/rtk/.claude/agents/code-reviewer.md +221 -0
  12. package/temp/rtk/.claude/agents/debugger.md +519 -0
  13. package/temp/rtk/.claude/agents/rtk-testing-specialist.md +461 -0
  14. package/temp/rtk/.claude/agents/rust-rtk.md +511 -0
  15. package/temp/rtk/.claude/agents/technical-writer.md +355 -0
  16. package/temp/rtk/.claude/commands/diagnose.md +352 -0
  17. package/temp/rtk/.claude/commands/test-routing.md +362 -0
  18. package/temp/rtk/.claude/hooks/bash/pre-commit-format.sh +16 -0
  19. package/temp/rtk/.claude/hooks/rtk-rewrite.sh +70 -0
  20. package/temp/rtk/.claude/hooks/rtk-suggest.sh +152 -0
  21. package/temp/rtk/.claude/rules/cli-testing.md +526 -0
  22. package/temp/rtk/.claude/skills/issue-triage/SKILL.md +348 -0
  23. package/temp/rtk/.claude/skills/issue-triage/templates/issue-comment.md +134 -0
  24. package/temp/rtk/.claude/skills/performance.md +435 -0
  25. package/temp/rtk/.claude/skills/pr-triage/SKILL.md +315 -0
  26. package/temp/rtk/.claude/skills/pr-triage/templates/review-comment.md +71 -0
  27. package/temp/rtk/.claude/skills/repo-recap.md +206 -0
  28. package/temp/rtk/.claude/skills/rtk-tdd/SKILL.md +78 -0
  29. package/temp/rtk/.claude/skills/rtk-tdd/references/testing-patterns.md +124 -0
  30. package/temp/rtk/.claude/skills/security-guardian.md +503 -0
  31. package/temp/rtk/.claude/skills/ship.md +404 -0
  32. package/temp/rtk/.github/workflows/benchmark.yml +34 -0
  33. package/temp/rtk/.github/workflows/dco-check.yaml +12 -0
  34. package/temp/rtk/.github/workflows/release-please.yml +51 -0
  35. package/temp/rtk/.github/workflows/release.yml +343 -0
  36. package/temp/rtk/.github/workflows/security-check.yml +135 -0
  37. package/temp/rtk/.github/workflows/validate-docs.yml +78 -0
  38. package/temp/rtk/.release-please-manifest.json +3 -0
  39. package/temp/rtk/ARCHITECTURE.md +1491 -0
  40. package/temp/rtk/CHANGELOG.md +640 -0
  41. package/temp/rtk/CLAUDE.md +605 -0
  42. package/temp/rtk/CONTRIBUTING.md +199 -0
  43. package/temp/rtk/Cargo.lock +1668 -0
  44. package/temp/rtk/Cargo.toml +64 -0
  45. package/temp/rtk/Formula/rtk.rb +43 -0
  46. package/temp/rtk/INSTALL.md +390 -0
  47. package/temp/rtk/LICENSE +21 -0
  48. package/temp/rtk/README.md +386 -0
  49. package/temp/rtk/README_es.md +159 -0
  50. package/temp/rtk/README_fr.md +197 -0
  51. package/temp/rtk/README_ja.md +159 -0
  52. package/temp/rtk/README_ko.md +159 -0
  53. package/temp/rtk/README_zh.md +167 -0
  54. package/temp/rtk/ROADMAP.md +15 -0
  55. package/temp/rtk/SECURITY.md +217 -0
  56. package/temp/rtk/TEST_EXEC_TIME.md +102 -0
  57. package/temp/rtk/build.rs +57 -0
  58. package/temp/rtk/docs/AUDIT_GUIDE.md +432 -0
  59. package/temp/rtk/docs/FEATURES.md +1410 -0
  60. package/temp/rtk/docs/TROUBLESHOOTING.md +309 -0
  61. package/temp/rtk/docs/filter-workflow.md +102 -0
  62. package/temp/rtk/docs/images/gain-dashboard.jpg +0 -0
  63. package/temp/rtk/docs/tracking.md +583 -0
  64. package/temp/rtk/hooks/opencode-rtk.ts +39 -0
  65. package/temp/rtk/hooks/rtk-awareness.md +29 -0
  66. package/temp/rtk/hooks/rtk-rewrite.sh +61 -0
  67. package/temp/rtk/hooks/test-rtk-rewrite.sh +442 -0
  68. package/temp/rtk/install.sh +124 -0
  69. package/temp/rtk/release-please-config.json +10 -0
  70. package/temp/rtk/scripts/benchmark.sh +592 -0
  71. package/temp/rtk/scripts/check-installation.sh +162 -0
  72. package/temp/rtk/scripts/install-local.sh +37 -0
  73. package/temp/rtk/scripts/rtk-economics.sh +137 -0
  74. package/temp/rtk/scripts/test-all.sh +561 -0
  75. package/temp/rtk/scripts/test-aristote.sh +227 -0
  76. package/temp/rtk/scripts/test-tracking.sh +79 -0
  77. package/temp/rtk/scripts/update-readme-metrics.sh +32 -0
  78. package/temp/rtk/scripts/validate-docs.sh +73 -0
  79. package/temp/rtk/src/aws_cmd.rs +880 -0
  80. package/temp/rtk/src/binlog.rs +1645 -0
  81. package/temp/rtk/src/cargo_cmd.rs +1727 -0
  82. package/temp/rtk/src/cc_economics.rs +1157 -0
  83. package/temp/rtk/src/ccusage.rs +340 -0
  84. package/temp/rtk/src/config.rs +187 -0
  85. package/temp/rtk/src/container.rs +855 -0
  86. package/temp/rtk/src/curl_cmd.rs +134 -0
  87. package/temp/rtk/src/deps.rs +268 -0
  88. package/temp/rtk/src/diff_cmd.rs +367 -0
  89. package/temp/rtk/src/discover/mod.rs +274 -0
  90. package/temp/rtk/src/discover/provider.rs +388 -0
  91. package/temp/rtk/src/discover/registry.rs +2022 -0
  92. package/temp/rtk/src/discover/report.rs +202 -0
  93. package/temp/rtk/src/discover/rules.rs +667 -0
  94. package/temp/rtk/src/display_helpers.rs +402 -0
  95. package/temp/rtk/src/dotnet_cmd.rs +1771 -0
  96. package/temp/rtk/src/dotnet_format_report.rs +133 -0
  97. package/temp/rtk/src/dotnet_trx.rs +593 -0
  98. package/temp/rtk/src/env_cmd.rs +204 -0
  99. package/temp/rtk/src/filter.rs +462 -0
  100. package/temp/rtk/src/filters/README.md +52 -0
  101. package/temp/rtk/src/filters/ansible-playbook.toml +34 -0
  102. package/temp/rtk/src/filters/basedpyright.toml +47 -0
  103. package/temp/rtk/src/filters/biome.toml +45 -0
  104. package/temp/rtk/src/filters/brew-install.toml +37 -0
  105. package/temp/rtk/src/filters/composer-install.toml +40 -0
  106. package/temp/rtk/src/filters/df.toml +16 -0
  107. package/temp/rtk/src/filters/dotnet-build.toml +64 -0
  108. package/temp/rtk/src/filters/du.toml +16 -0
  109. package/temp/rtk/src/filters/fail2ban-client.toml +15 -0
  110. package/temp/rtk/src/filters/gcc.toml +49 -0
  111. package/temp/rtk/src/filters/gcloud.toml +22 -0
  112. package/temp/rtk/src/filters/hadolint.toml +24 -0
  113. package/temp/rtk/src/filters/helm.toml +29 -0
  114. package/temp/rtk/src/filters/iptables.toml +27 -0
  115. package/temp/rtk/src/filters/jj.toml +28 -0
  116. package/temp/rtk/src/filters/jq.toml +24 -0
  117. package/temp/rtk/src/filters/make.toml +41 -0
  118. package/temp/rtk/src/filters/markdownlint.toml +24 -0
  119. package/temp/rtk/src/filters/mix-compile.toml +27 -0
  120. package/temp/rtk/src/filters/mix-format.toml +15 -0
  121. package/temp/rtk/src/filters/mvn-build.toml +44 -0
  122. package/temp/rtk/src/filters/oxlint.toml +43 -0
  123. package/temp/rtk/src/filters/ping.toml +63 -0
  124. package/temp/rtk/src/filters/pio-run.toml +40 -0
  125. package/temp/rtk/src/filters/poetry-install.toml +50 -0
  126. package/temp/rtk/src/filters/pre-commit.toml +35 -0
  127. package/temp/rtk/src/filters/ps.toml +16 -0
  128. package/temp/rtk/src/filters/quarto-render.toml +41 -0
  129. package/temp/rtk/src/filters/rsync.toml +48 -0
  130. package/temp/rtk/src/filters/shellcheck.toml +27 -0
  131. package/temp/rtk/src/filters/shopify-theme.toml +29 -0
  132. package/temp/rtk/src/filters/skopeo.toml +45 -0
  133. package/temp/rtk/src/filters/sops.toml +16 -0
  134. package/temp/rtk/src/filters/ssh.toml +44 -0
  135. package/temp/rtk/src/filters/stat.toml +34 -0
  136. package/temp/rtk/src/filters/swift-build.toml +41 -0
  137. package/temp/rtk/src/filters/systemctl-status.toml +33 -0
  138. package/temp/rtk/src/filters/terraform-plan.toml +35 -0
  139. package/temp/rtk/src/filters/tofu-fmt.toml +16 -0
  140. package/temp/rtk/src/filters/tofu-init.toml +38 -0
  141. package/temp/rtk/src/filters/tofu-plan.toml +35 -0
  142. package/temp/rtk/src/filters/tofu-validate.toml +17 -0
  143. package/temp/rtk/src/filters/trunk-build.toml +39 -0
  144. package/temp/rtk/src/filters/ty.toml +50 -0
  145. package/temp/rtk/src/filters/uv-sync.toml +37 -0
  146. package/temp/rtk/src/filters/xcodebuild.toml +99 -0
  147. package/temp/rtk/src/filters/yamllint.toml +25 -0
  148. package/temp/rtk/src/find_cmd.rs +598 -0
  149. package/temp/rtk/src/format_cmd.rs +386 -0
  150. package/temp/rtk/src/gain.rs +723 -0
  151. package/temp/rtk/src/gh_cmd.rs +1651 -0
  152. package/temp/rtk/src/git.rs +2012 -0
  153. package/temp/rtk/src/go_cmd.rs +592 -0
  154. package/temp/rtk/src/golangci_cmd.rs +254 -0
  155. package/temp/rtk/src/grep_cmd.rs +288 -0
  156. package/temp/rtk/src/gt_cmd.rs +810 -0
  157. package/temp/rtk/src/hook_audit_cmd.rs +283 -0
  158. package/temp/rtk/src/hook_check.rs +171 -0
  159. package/temp/rtk/src/init.rs +1859 -0
  160. package/temp/rtk/src/integrity.rs +537 -0
  161. package/temp/rtk/src/json_cmd.rs +231 -0
  162. package/temp/rtk/src/learn/detector.rs +628 -0
  163. package/temp/rtk/src/learn/mod.rs +119 -0
  164. package/temp/rtk/src/learn/report.rs +184 -0
  165. package/temp/rtk/src/lint_cmd.rs +694 -0
  166. package/temp/rtk/src/local_llm.rs +316 -0
  167. package/temp/rtk/src/log_cmd.rs +248 -0
  168. package/temp/rtk/src/ls.rs +324 -0
  169. package/temp/rtk/src/main.rs +2482 -0
  170. package/temp/rtk/src/mypy_cmd.rs +389 -0
  171. package/temp/rtk/src/next_cmd.rs +241 -0
  172. package/temp/rtk/src/npm_cmd.rs +236 -0
  173. package/temp/rtk/src/parser/README.md +267 -0
  174. package/temp/rtk/src/parser/error.rs +46 -0
  175. package/temp/rtk/src/parser/formatter.rs +336 -0
  176. package/temp/rtk/src/parser/mod.rs +311 -0
  177. package/temp/rtk/src/parser/types.rs +119 -0
  178. package/temp/rtk/src/pip_cmd.rs +302 -0
  179. package/temp/rtk/src/playwright_cmd.rs +479 -0
  180. package/temp/rtk/src/pnpm_cmd.rs +573 -0
  181. package/temp/rtk/src/prettier_cmd.rs +221 -0
  182. package/temp/rtk/src/prisma_cmd.rs +482 -0
  183. package/temp/rtk/src/psql_cmd.rs +382 -0
  184. package/temp/rtk/src/pytest_cmd.rs +384 -0
  185. package/temp/rtk/src/read.rs +217 -0
  186. package/temp/rtk/src/rewrite_cmd.rs +50 -0
  187. package/temp/rtk/src/ruff_cmd.rs +402 -0
  188. package/temp/rtk/src/runner.rs +271 -0
  189. package/temp/rtk/src/summary.rs +297 -0
  190. package/temp/rtk/src/tee.rs +405 -0
  191. package/temp/rtk/src/telemetry.rs +248 -0
  192. package/temp/rtk/src/toml_filter.rs +1655 -0
  193. package/temp/rtk/src/tracking.rs +1416 -0
  194. package/temp/rtk/src/tree.rs +209 -0
  195. package/temp/rtk/src/tsc_cmd.rs +259 -0
  196. package/temp/rtk/src/utils.rs +432 -0
  197. package/temp/rtk/src/verify_cmd.rs +47 -0
  198. package/temp/rtk/src/vitest_cmd.rs +385 -0
  199. package/temp/rtk/src/wc_cmd.rs +401 -0
  200. package/temp/rtk/src/wget_cmd.rs +260 -0
  201. package/temp/rtk/tests/fixtures/dotnet/build_failed.txt +11 -0
  202. package/temp/rtk/tests/fixtures/dotnet/format_changes.json +31 -0
  203. package/temp/rtk/tests/fixtures/dotnet/format_empty.json +1 -0
  204. package/temp/rtk/tests/fixtures/dotnet/format_success.json +12 -0
  205. package/temp/rtk/tests/fixtures/dotnet/test_failed.txt +18 -0
@@ -0,0 +1,248 @@
1
+ use crate::config;
2
+ use crate::tracking;
3
+ use sha2::{Digest, Sha256};
4
+ use std::path::PathBuf;
5
+
6
+ const TELEMETRY_URL: Option<&str> = option_env!("RTK_TELEMETRY_URL");
7
+ const TELEMETRY_TOKEN: Option<&str> = option_env!("RTK_TELEMETRY_TOKEN");
8
+ const PING_INTERVAL_SECS: u64 = 23 * 3600; // 23 hours
9
+
10
+ /// Send a telemetry ping if enabled and not already sent today.
11
+ /// Fire-and-forget: errors are silently ignored.
12
+ pub fn maybe_ping() {
13
+ // No URL compiled in → telemetry disabled
14
+ if TELEMETRY_URL.is_none() {
15
+ return;
16
+ }
17
+
18
+ // Check opt-out: env var
19
+ if std::env::var("RTK_TELEMETRY_DISABLED").unwrap_or_default() == "1" {
20
+ return;
21
+ }
22
+
23
+ // Check opt-out: config.toml
24
+ if let Some(false) = config::telemetry_enabled() {
25
+ return;
26
+ }
27
+
28
+ // Check last ping time
29
+ let marker = telemetry_marker_path();
30
+ if let Ok(metadata) = std::fs::metadata(&marker) {
31
+ if let Ok(modified) = metadata.modified() {
32
+ if let Ok(elapsed) = modified.elapsed() {
33
+ if elapsed.as_secs() < PING_INTERVAL_SECS {
34
+ return;
35
+ }
36
+ }
37
+ }
38
+ }
39
+
40
+ // Touch marker file immediately (before sending) to avoid double-ping
41
+ touch_marker(&marker);
42
+
43
+ // Spawn thread so we never block the CLI
44
+ std::thread::spawn(|| {
45
+ let _ = send_ping();
46
+ });
47
+ }
48
+
49
+ fn send_ping() -> Result<(), Box<dyn std::error::Error>> {
50
+ let url = TELEMETRY_URL.ok_or("no telemetry URL")?;
51
+ let device_hash = generate_device_hash();
52
+ let version = env!("CARGO_PKG_VERSION").to_string();
53
+ let os = std::env::consts::OS.to_string();
54
+ let arch = std::env::consts::ARCH.to_string();
55
+ let install_method = detect_install_method();
56
+
57
+ // Get stats from tracking DB
58
+ let (commands_24h, top_commands, savings_pct, tokens_saved_24h, tokens_saved_total) =
59
+ get_stats();
60
+
61
+ let payload = serde_json::json!({
62
+ "device_hash": device_hash,
63
+ "version": version,
64
+ "os": os,
65
+ "arch": arch,
66
+ "install_method": install_method,
67
+ "commands_24h": commands_24h,
68
+ "top_commands": top_commands,
69
+ "savings_pct": savings_pct,
70
+ "tokens_saved_24h": tokens_saved_24h,
71
+ "tokens_saved_total": tokens_saved_total,
72
+ });
73
+
74
+ let mut req = ureq::post(url).set("Content-Type", "application/json");
75
+
76
+ if let Some(token) = TELEMETRY_TOKEN {
77
+ req = req.set("X-RTK-Token", token);
78
+ }
79
+
80
+ // 2 second timeout — if server is down, we move on
81
+ req.timeout(std::time::Duration::from_secs(2))
82
+ .send_string(&payload.to_string())?;
83
+
84
+ Ok(())
85
+ }
86
+
87
+ fn generate_device_hash() -> String {
88
+ let hostname = hostname::get()
89
+ .map(|h| h.to_string_lossy().to_string())
90
+ .unwrap_or_default();
91
+ let username = std::env::var("USER")
92
+ .or_else(|_| std::env::var("USERNAME"))
93
+ .unwrap_or_default();
94
+
95
+ let mut hasher = Sha256::new();
96
+ hasher.update(hostname.as_bytes());
97
+ hasher.update(b":");
98
+ hasher.update(username.as_bytes());
99
+ format!("{:x}", hasher.finalize())
100
+ }
101
+
102
+ fn get_stats() -> (i64, Vec<String>, Option<f64>, i64, i64) {
103
+ let tracker = match tracking::Tracker::new() {
104
+ Ok(t) => t,
105
+ Err(_) => return (0, vec![], None, 0, 0),
106
+ };
107
+
108
+ let since_24h = chrono::Utc::now() - chrono::Duration::hours(24);
109
+
110
+ // Get 24h command count and top commands from tracking DB
111
+ let commands_24h = tracker.count_commands_since(since_24h).unwrap_or(0);
112
+
113
+ let top_commands = tracker.top_commands(5).unwrap_or_default();
114
+
115
+ let savings_pct = tracker.overall_savings_pct().ok();
116
+
117
+ let tokens_saved_24h = tracker.tokens_saved_24h(since_24h).unwrap_or(0);
118
+
119
+ let tokens_saved_total = tracker.total_tokens_saved().unwrap_or(0);
120
+
121
+ (
122
+ commands_24h,
123
+ top_commands,
124
+ savings_pct,
125
+ tokens_saved_24h,
126
+ tokens_saved_total,
127
+ )
128
+ }
129
+
130
+ fn detect_install_method() -> &'static str {
131
+ let exe = match std::env::current_exe() {
132
+ Ok(p) => p,
133
+ Err(_) => return "unknown",
134
+ };
135
+ let real_path = std::fs::canonicalize(&exe)
136
+ .unwrap_or(exe)
137
+ .to_string_lossy()
138
+ .to_string();
139
+ install_method_from_path(&real_path)
140
+ }
141
+
142
+ fn install_method_from_path(path: &str) -> &'static str {
143
+ if path.contains("/Cellar/rtk/") || path.contains("/homebrew/") {
144
+ "homebrew"
145
+ } else if path.contains("/.cargo/bin/") || path.contains("\\.cargo\\bin\\") {
146
+ "cargo"
147
+ } else if path.contains("/.local/bin/") || path.contains("\\.local\\bin\\") {
148
+ "script"
149
+ } else if path.contains("/nix/store/") {
150
+ "nix"
151
+ } else {
152
+ "other"
153
+ }
154
+ }
155
+
156
+ fn telemetry_marker_path() -> PathBuf {
157
+ let data_dir = dirs::data_local_dir()
158
+ .unwrap_or_else(|| PathBuf::from("/tmp"))
159
+ .join("rtk");
160
+ let _ = std::fs::create_dir_all(&data_dir);
161
+ data_dir.join(".telemetry_last_ping")
162
+ }
163
+
164
+ fn touch_marker(path: &PathBuf) {
165
+ let _ = std::fs::write(path, b"");
166
+ }
167
+
168
+ #[cfg(test)]
169
+ mod tests {
170
+ use super::*;
171
+
172
+ #[test]
173
+ fn test_device_hash_is_stable() {
174
+ let h1 = generate_device_hash();
175
+ let h2 = generate_device_hash();
176
+ assert_eq!(h1, h2);
177
+ assert_eq!(h1.len(), 64); // SHA-256 hex
178
+ }
179
+
180
+ #[test]
181
+ fn test_marker_path_exists() {
182
+ let path = telemetry_marker_path();
183
+ assert!(path.to_string_lossy().contains("rtk"));
184
+ }
185
+
186
+ #[test]
187
+ fn test_install_method_unix_paths() {
188
+ assert_eq!(
189
+ install_method_from_path("/opt/homebrew/Cellar/rtk/0.28.0/bin/rtk"),
190
+ "homebrew"
191
+ );
192
+ assert_eq!(
193
+ install_method_from_path("/usr/local/homebrew/bin/rtk"),
194
+ "homebrew"
195
+ );
196
+ assert_eq!(
197
+ install_method_from_path("/home/user/.cargo/bin/rtk"),
198
+ "cargo"
199
+ );
200
+ assert_eq!(
201
+ install_method_from_path("/home/user/.local/bin/rtk"),
202
+ "script"
203
+ );
204
+ assert_eq!(
205
+ install_method_from_path("/nix/store/abc123-rtk/bin/rtk"),
206
+ "nix"
207
+ );
208
+ assert_eq!(install_method_from_path("/usr/bin/rtk"), "other");
209
+ }
210
+
211
+ #[test]
212
+ fn test_install_method_windows_paths() {
213
+ assert_eq!(
214
+ install_method_from_path("C:\\Users\\user\\.cargo\\bin\\rtk.exe"),
215
+ "cargo"
216
+ );
217
+ assert_eq!(
218
+ install_method_from_path("C:\\Users\\user\\.local\\bin\\rtk.exe"),
219
+ "script"
220
+ );
221
+ assert_eq!(
222
+ install_method_from_path("C:\\Program Files\\rtk\\rtk.exe"),
223
+ "other"
224
+ );
225
+ }
226
+
227
+ #[test]
228
+ fn test_detect_install_method_returns_known_value() {
229
+ let method = detect_install_method();
230
+ assert!(
231
+ ["homebrew", "cargo", "script", "nix", "other", "unknown"].contains(&method),
232
+ "Unexpected install method: {}",
233
+ method
234
+ );
235
+ }
236
+
237
+ #[test]
238
+ fn test_get_stats_returns_tuple() {
239
+ let (cmds, top, pct, saved_24h, saved_total) = get_stats();
240
+ assert!(cmds >= 0);
241
+ assert!(top.len() <= 5);
242
+ assert!(saved_24h >= 0);
243
+ assert!(saved_total >= 0);
244
+ if let Some(p) = pct {
245
+ assert!((0.0..=100.0).contains(&p));
246
+ }
247
+ }
248
+ }