@eyeauras/insight-cli 0.3.0 → 0.3.1

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 (68) hide show
  1. package/.cli-package-build.json +1 -1
  2. package/SKILL.md +6 -1
  3. package/dist/src/cli.js +9 -2
  4. package/dist/src/initial-model.js +26 -5
  5. package/dist/src/initial-progress.d.ts +4 -0
  6. package/dist/src/initial-progress.js +64 -0
  7. package/dist/src/native-inputs.js +2 -1
  8. package/dist/src/server.js +14 -0
  9. package/package.json +1 -1
  10. package/references/native/InsightImportProgress.java +42 -0
  11. package/references/native/InsightInitialImport.java +8 -2
  12. package/references/native/InsightSdkFiles.java +13 -10
  13. package/references/setup.md +27 -0
  14. package/skill-bundle/insight-artifacts/SKILL.md +1 -1
  15. package/skill-bundle/insight-binary/SKILL.md +1 -1
  16. package/skill-bundle/insight-capture/SKILL.md +1 -1
  17. package/skill-bundle/insight-cli/SKILL.md +6 -1
  18. package/skill-bundle/insight-cli/references/archive.md +32 -0
  19. package/skill-bundle/insight-cli/references/managed-runtime.md +162 -0
  20. package/skill-bundle/insight-cli/references/setup.md +98 -0
  21. package/skill-bundle/insight-die/SKILL.md +1 -1
  22. package/skill-bundle/insight-dnspy/SKILL.md +1 -1
  23. package/skill-bundle/insight-dotnet-dump/SKILL.md +1 -1
  24. package/skill-bundle/insight-dotnet-stack/SKILL.md +1 -1
  25. package/skill-bundle/insight-dotnet-trace/SKILL.md +1 -1
  26. package/skill-bundle/insight-frida/SKILL.md +1 -1
  27. package/skill-bundle/insight-ghidra/SKILL.md +27 -1
  28. package/skill-bundle/insight-ghidra/references/setup.md +27 -0
  29. package/skill-bundle/insight-ilspy/SKILL.md +1 -1
  30. package/skill-bundle/insight-interop/SKILL.md +1 -1
  31. package/skill-bundle/insight-lldb/SKILL.md +1 -1
  32. package/skill-bundle/insight-llvm/SKILL.md +1 -1
  33. package/skill-bundle/insight-managed-heap/SKILL.md +1 -1
  34. package/skill-bundle/insight-managed-metadata/SKILL.md +1 -1
  35. package/skill-bundle/insight-mitmproxy/SKILL.md +1 -1
  36. package/skill-bundle/insight-overview/SKILL.md +1 -1
  37. package/skill-bundle/insight-procmon/SKILL.md +1 -1
  38. package/skill-bundle/insight-re/SKILL.md +6 -1
  39. package/skill-bundle/insight-sevenzip/SKILL.md +1 -1
  40. package/skill-bundle/insight-strace/SKILL.md +1 -1
  41. package/skill-bundle/insight-tshark/SKILL.md +1 -1
  42. package/skill-bundle/insight-windbg/SKILL.md +1 -1
  43. package/skill-bundle/manifest.json +1 -1
  44. package/skills/insight-artifacts/SKILL.md +1 -1
  45. package/skills/insight-binary/SKILL.md +1 -1
  46. package/skills/insight-capture/SKILL.md +1 -1
  47. package/skills/insight-die/SKILL.md +1 -1
  48. package/skills/insight-dnspy/SKILL.md +1 -1
  49. package/skills/insight-dotnet-dump/SKILL.md +1 -1
  50. package/skills/insight-dotnet-stack/SKILL.md +1 -1
  51. package/skills/insight-dotnet-trace/SKILL.md +1 -1
  52. package/skills/insight-frida/SKILL.md +1 -1
  53. package/skills/insight-ghidra/SKILL.md +27 -1
  54. package/skills/insight-ghidra/references/setup.md +27 -0
  55. package/skills/insight-ilspy/SKILL.md +1 -1
  56. package/skills/insight-interop/SKILL.md +1 -1
  57. package/skills/insight-lldb/SKILL.md +1 -1
  58. package/skills/insight-llvm/SKILL.md +1 -1
  59. package/skills/insight-managed-heap/SKILL.md +1 -1
  60. package/skills/insight-managed-metadata/SKILL.md +1 -1
  61. package/skills/insight-mitmproxy/SKILL.md +1 -1
  62. package/skills/insight-overview/SKILL.md +1 -1
  63. package/skills/insight-procmon/SKILL.md +1 -1
  64. package/skills/insight-re/SKILL.md +6 -1
  65. package/skills/insight-sevenzip/SKILL.md +1 -1
  66. package/skills/insight-strace/SKILL.md +1 -1
  67. package/skills/insight-tshark/SKILL.md +1 -1
  68. package/skills/insight-windbg/SKILL.md +1 -1
@@ -3,7 +3,7 @@ name: insight-dotnet-stack
3
3
  description: Inspect live managed thread stacks to identify active or waiting work in an explicitly selected .NET process without taking a dump.
4
4
  ---
5
5
 
6
- # Insight .NET Stack 0.3.0
6
+ # Insight .NET Stack 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-dotnet-trace
3
3
  description: Collect and inspect bounded .NET EventPipe traces to identify sampled thread work, waits or runtime activity; distinguish wall-clock samples from CPU consumption.
4
4
  ---
5
5
 
6
- # Insight .NET Trace 0.3.0
6
+ # Insight .NET Trace 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-frida
3
3
  description: Observe native call arguments/results or inspect runtime modules and exports in an explicitly selected authorized process with bounded Frida scripts. Use insight-cli frida to corroborate static findings with actual execution on macOS ARM64.
4
4
  ---
5
5
 
6
- # Insight Frida 0.3.0
6
+ # Insight Frida 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-ghidra
3
3
  description: Inspect or edit native binaries with Ghidra through insight-cli; use isolated contexts, multi-agent merge/refresh, server, GUI or debugger workflows. Choose this for static native behavior and references, not C# recovery from managed IL.
4
4
  ---
5
5
 
6
- # Insight Ghidra 0.3.0
6
+ # Insight Ghidra 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -17,6 +17,32 @@ session/cell ID, await that same execution with the host's wait/poll facility un
17
17
  status and read its stdout/stderr. An empty first chunk is not a lost CLI response. Do not
18
18
  start another open or repeat a CPU mutation while the original command is still running.
19
19
 
20
+
21
+ New targets import **without automatic analysis**. Reuse existing selectors/projects before
22
+ opening another copy; `ghidra open --session <session> --target <target>` preserves its bound
23
+ load settings, including older analysis choices. `--no-analysis` makes the fast choice explicit;
24
+ `--analysis` opts into a full analysis only during the first import of a new target.
25
+ After a fast import, use scoped `ghidra analysis run` to process pending analysis, or
26
+ `ghidra analysis reanalyze` to deliberately queue full reanalysis. These are saved private
27
+ mutations; merge deliberately. For a narrow question prefer bounded function disassembly,
28
+ function creation and decompilation first; inspect help for the exact operation.
29
+
30
+ For long first opens, `ghidra progress --session <session> --target <target> --json`
31
+ reads retained progress without starting Java or repeating the operation. It reports the
32
+ current stage, elapsed time, heartbeat age and native task message/counters when available;
33
+ those counters belong to the current task, not the whole import. Human output also reports
34
+ progress through Factory; `--json` keeps one final JSON result on stdout and stays quiet.
35
+ If the execution host yields, keep its same running execution and inspect progress every
36
+ 5-10 seconds when useful; relay stage changes or meaningful stalls, and do other independent
37
+ work. Do not silently extend waits to minutes or start a second import. Until selectors are
38
+ returned, use the existing `sessions list/status` and `tools processes` inventory to locate the
39
+ reserved scope. A stale heartbeat, dead worker or unknown result is not completion: inspect
40
+ `sessions status` and recovery before continuing. Pre-upgrade workers have no progress record;
41
+ null progress means unavailable, never success. Progress is observational, not a completion receipt. This command tracks first open only;
42
+ its old complete record does not describe later `analysis run`/`reanalyze` operations.
43
+ `operation: initial-model` completes after verified shared-model publication; the private
44
+ session context can still be opening. Inspect `sessions status` for context readiness.
45
+
20
46
  Use `ghidra status` to inspect runtime readiness; `ghidra install` delivers the pinned runtime.
21
47
  For static managed C#/IL research, locate `insight-cli skill insight-ilspy`.
22
48
  For owned process inventory use `tools processes`; `stop` saves Ghidra contexts, while
@@ -69,3 +69,30 @@ After an import timeout, wait for the original worker to end, raise its budget a
69
69
  the original scope. Incomplete private analysis restarts; a completed receipt is reused.
70
70
  A save timeout reports `phase: save`, the effective budget and `saveSeconds`. Inspect
71
71
  `sessions status`; a native log or broken response stream cannot prove a saved snapshot.
72
+
73
+ ## Initial import and progress
74
+
75
+ New targets import **without automatic analysis**. Reuse existing selectors/projects before
76
+ opening another copy; `ghidra open --session <session> --target <target>` preserves its bound
77
+ load settings, including older analysis choices. `--no-analysis` makes the fast choice explicit;
78
+ `--analysis` opts into a full analysis only during the first import of a new target.
79
+ After a fast import, use scoped `ghidra analysis run` to process pending analysis, or
80
+ `ghidra analysis reanalyze` to deliberately queue full reanalysis. These are saved private
81
+ mutations; merge deliberately. For a narrow question prefer bounded function disassembly,
82
+ function creation and decompilation first; inspect help for the exact operation.
83
+
84
+ For long first opens, `ghidra progress --session <session> --target <target> --json`
85
+ reads retained progress without starting Java or repeating the operation. It reports the
86
+ current stage, elapsed time, heartbeat age and native task message/counters when available;
87
+ those counters belong to the current task, not the whole import. Human output also reports
88
+ progress through Factory; `--json` keeps one final JSON result on stdout and stays quiet.
89
+ If the execution host yields, keep its same running execution and inspect progress every
90
+ 5-10 seconds when useful; relay stage changes or meaningful stalls, and do other independent
91
+ work. Do not silently extend waits to minutes or start a second import. Until selectors are
92
+ returned, use the existing `sessions list/status` and `tools processes` inventory to locate the
93
+ reserved scope. A stale heartbeat, dead worker or unknown result is not completion: inspect
94
+ `sessions status` and recovery before continuing. Pre-upgrade workers have no progress record;
95
+ null progress means unavailable, never success. Progress is observational, not a completion receipt. This command tracks first open only;
96
+ its old complete record does not describe later `analysis run`/`reanalyze` operations.
97
+ `operation: initial-model` completes after verified shared-model publication; the private
98
+ session context can still be opening. Inspect `sessions status` for context readiness.
@@ -3,7 +3,7 @@ name: insight-ilspy
3
3
  description: Recover C#, inspect IL/types/metadata, extract resources or export projects from managed .NET assemblies through insight-cli ILSpy. Choose native analysis for NativeAOT or ordinary PE machine code.
4
4
  ---
5
5
 
6
- # Insight ILSpy 0.3.0
6
+ # Insight ILSpy 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-interop
3
3
  description: Trace a .NET P/Invoke declaration to an explicitly supplied native library export and Ghidra function through insight-cli ilspy query, binary query and scoped ghidra APIs. Use for managed/native linkage evidence while keeping static correspondence separate from observed loading or execution.
4
4
  ---
5
5
 
6
- # Insight Interop 0.3.0
6
+ # Insight Interop 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-lldb
3
3
  description: Observe native runtime arguments, return values, registers, stacks and bounded memory at a selected breakpoint using an owned LLDB launch. Use insight-cli lldb on macOS ARM64 when static findings need a concrete execution check.
4
4
  ---
5
5
 
6
- # Insight LLDB 0.3.0
6
+ # Insight LLDB 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-llvm
3
3
  description: Inspect PE, ELF and Mach-O headers, dependencies, exports and symbols; query PDB debug information or a small instruction window with insight-cli LLVM utilities before opening a full analysis project.
4
4
  ---
5
5
 
6
- # Insight LLVM 0.3.0
6
+ # Insight LLVM 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-managed-heap
3
3
  description: Query structured .NET heap objects, primitive fields and managed stacks from a retained CoreCLR dump through insight-cli dotnet-dump query. Use for bounded offline dump investigation with an explicit matching DAC, preserving uncertainty and immutable input identity.
4
4
  ---
5
5
 
6
- # Insight Managed Heap 0.3.0
6
+ # Insight Managed Heap 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-managed-metadata
3
3
  description: Query managed assembly metadata, MethodDef tokens, P/Invoke declarations and bounded IL, or compare two C#/.NET assemblies through insight-cli ilspy query/compare. Use for structured static evidence and changed-method research without executing the target.
4
4
  ---
5
5
 
6
- # Insight Managed Metadata 0.3.0
6
+ # Insight Managed Metadata 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-mitmproxy
3
3
  description: Record, inspect and compare HTTP request/response evidence with insight-cli mitmproxy. Use when an owned client can explicitly use a loopback proxy; read native flow archives or HAR without replaying traffic. System interception and global certificate trust are outside this facade.
4
4
  ---
5
5
 
6
- # Insight mitmproxy 0.3.0
6
+ # Insight mitmproxy 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-overview
3
3
  description: Choose bounded tool overviews and focused drilldown through insight-cli without flooding agent context with whole-program code, traces or dumps. Use for tool discovery, scoped evidence paging and keeping native partial coverage separate from complete results.
4
4
  ---
5
5
 
6
- # Insight Overview 0.3.0
6
+ # Insight Overview 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-procmon
3
3
  description: Observe actual file and registry access by an authorized running Windows process through insight-cli procmon. Use when static paths or configuration guesses need runtime evidence; inspect retained captures without collecting again.
4
4
  ---
5
5
 
6
- # Insight ProcMon 0.3.0
6
+ # Insight ProcMon 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-re
3
3
  description: Investigate shipped programs and binary artifacts with insight-cli and other available tools; retain ordinary research files, coordinate independent agents and publish Ghidra annotations. Use for reverse engineering behavior, not ordinary source-repository browsing.
4
4
  ---
5
5
 
6
- # Insight RE 0.3.0
6
+ # Insight RE 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -58,6 +58,11 @@ An unavailable tool is a concrete gap; continue supported work without inventing
58
58
 
59
59
  When using `insight-cli ghidra`, read the skill returned by `insight-cli skill insight-ghidra` and generated help. Open through
60
60
  `insight-cli ghidra open <input> --session new --json` and retain the returned selectors.
61
+ New inputs import without full automatic analysis. Reuse retained targets/contexts; opt into
62
+ initial `--analysis` only when needed. After a fast open, scoped `ghidra analysis run` or
63
+ `analysis reanalyze` performs explicit analysis. For a long first open, inspect `ghidra progress`
64
+ at 5-10 second intervals and report meaningful stage changes; keep the original execution
65
+ and continue independent research while it runs. See the Ghidra skill for progress limits.
61
66
  Every scoped call supplies both `--session` and `--target`. Independent agents use
62
67
  different sessions; callers sharing selectors use one ordered context.
63
68
 
@@ -3,7 +3,7 @@ name: insight-sevenzip
3
3
  description: Inventory, integrity-check and recover files from archives and supported containers with insight-cli 7-Zip, then hand recovered binaries or configuration to the appropriate research tool.
4
4
  ---
5
5
 
6
- # Insight 7-Zip 0.3.0
6
+ # Insight 7-Zip 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-strace
3
3
  description: Observe actual file reads, writes, process creation and network syscalls in an authorized owned native Linux launch using insight-cli strace. Use when static inference needs concrete operating-system interaction evidence.
4
4
  ---
5
5
 
6
- # Insight strace 0.3.0
6
+ # Insight strace 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-tshark
3
3
  description: Inspect an offline PCAP or PCAPNG with insight-cli tshark to identify protocols, HTTP/DNS/TLS fields, packet evidence and reconstructed TCP/UDP streams. Use for captured traffic questions; live acquisition and TLS decryption are separate tasks.
4
4
  ---
5
5
 
6
- # Insight TShark 0.3.0
6
+ # Insight TShark 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized
@@ -3,7 +3,7 @@ name: insight-windbg
3
3
  description: Investigate Windows native user-mode minidumps using bounded stacks, threads, registers, modules, memory and disassembly through insight-cli windbg. Use on Windows x64 when a captured runtime state needs native debugger evidence.
4
4
  ---
5
5
 
6
- # Insight WinDbg 0.3.0
6
+ # Insight WinDbg 0.3.1
7
7
 
8
8
  If local help/status reports AppData or IPC access denied, retry that **read-only probe**
9
9
  with the agent host's normal permission escalation, then use that route for later authorized