@eyeauras/insight-cli 0.2.4 → 0.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.
- package/.cli-package-build.json +1 -1
- package/SKILL.md +4 -1
- package/dist/src/analysis-storage.d.ts +165 -0
- package/dist/src/analysis-storage.js +562 -0
- package/dist/src/cli.js +24 -6
- package/dist/src/contexts.js +8 -8
- package/dist/src/ghidra-processes.js +5 -4
- package/dist/src/initial-model.js +2 -1
- package/dist/src/native-inputs.js +2 -2
- package/dist/src/runtime-manager.js +6 -5
- package/dist/src/runtime-selection.d.ts +2 -2
- package/dist/src/runtime-selection.js +13 -6
- package/dist/src/saved-materials.js +2 -1
- package/dist/src/tool-runtime/installer.js +7 -6
- package/dist/src/tool-runtime/launch-worker.js +3 -1
- package/package.json +2 -2
- package/references/artifacts.md +1 -1
- package/references/managed-runtime.md +1 -1
- package/references/setup.md +4 -0
- package/references/storage.md +99 -0
- package/runtime/toolbox.json +10 -4
- package/skill-bundle/insight-artifacts/SKILL.md +1 -1
- package/skill-bundle/insight-artifacts/references/artifacts.md +1 -1
- package/skill-bundle/insight-artifacts/references/recovery.md +79 -0
- package/skill-bundle/insight-artifacts/references/storage.md +99 -0
- package/skill-bundle/insight-binary/SKILL.md +1 -1
- package/skill-bundle/insight-capture/SKILL.md +1 -1
- package/skill-bundle/insight-cli/SKILL.md +4 -1
- package/skill-bundle/insight-cli/references/recovery.md +79 -0
- package/skill-bundle/insight-cli/references/storage.md +99 -0
- package/skill-bundle/insight-die/SKILL.md +1 -1
- package/skill-bundle/insight-dnspy/SKILL.md +1 -1
- package/skill-bundle/insight-dotnet-dump/SKILL.md +1 -1
- package/skill-bundle/insight-dotnet-stack/SKILL.md +1 -1
- package/skill-bundle/insight-dotnet-trace/SKILL.md +1 -1
- package/skill-bundle/insight-frida/SKILL.md +1 -1
- package/skill-bundle/insight-ghidra/SKILL.md +1 -1
- package/skill-bundle/insight-ghidra/references/artifacts.md +1 -1
- package/skill-bundle/insight-ghidra/references/managed-runtime.md +1 -1
- package/skill-bundle/insight-ghidra/references/setup.md +4 -0
- package/skill-bundle/insight-ghidra/references/storage.md +99 -0
- package/skill-bundle/insight-ilspy/SKILL.md +1 -1
- package/skill-bundle/insight-interop/SKILL.md +1 -1
- package/skill-bundle/insight-lldb/SKILL.md +1 -1
- package/skill-bundle/insight-llvm/SKILL.md +1 -1
- package/skill-bundle/insight-managed-heap/SKILL.md +1 -1
- package/skill-bundle/insight-managed-metadata/SKILL.md +1 -1
- package/skill-bundle/insight-mitmproxy/SKILL.md +1 -1
- package/skill-bundle/insight-overview/SKILL.md +1 -1
- package/skill-bundle/insight-procmon/SKILL.md +1 -1
- package/skill-bundle/insight-re/SKILL.md +1 -1
- package/skill-bundle/insight-re/references/artifacts.md +1 -1
- package/skill-bundle/insight-re/references/storage.md +99 -0
- package/skill-bundle/insight-sevenzip/SKILL.md +1 -1
- package/skill-bundle/insight-strace/SKILL.md +1 -1
- package/skill-bundle/insight-tshark/SKILL.md +1 -1
- package/skill-bundle/insight-windbg/SKILL.md +1 -1
- package/skill-bundle/manifest.json +1 -1
- package/skills/insight-artifacts/SKILL.md +1 -1
- package/skills/insight-artifacts/references/artifacts.md +1 -1
- package/skills/insight-artifacts/references/recovery.md +79 -0
- package/skills/insight-artifacts/references/storage.md +99 -0
- package/skills/insight-binary/SKILL.md +1 -1
- package/skills/insight-capture/SKILL.md +1 -1
- package/skills/insight-die/SKILL.md +1 -1
- package/skills/insight-dnspy/SKILL.md +1 -1
- package/skills/insight-dotnet-dump/SKILL.md +1 -1
- package/skills/insight-dotnet-stack/SKILL.md +1 -1
- package/skills/insight-dotnet-trace/SKILL.md +1 -1
- package/skills/insight-frida/SKILL.md +1 -1
- package/skills/insight-ghidra/SKILL.md +1 -1
- package/skills/insight-ghidra/references/artifacts.md +1 -1
- package/skills/insight-ghidra/references/managed-runtime.md +1 -1
- package/skills/insight-ghidra/references/setup.md +4 -0
- package/skills/insight-ghidra/references/storage.md +99 -0
- package/skills/insight-ilspy/SKILL.md +1 -1
- package/skills/insight-interop/SKILL.md +1 -1
- package/skills/insight-lldb/SKILL.md +1 -1
- package/skills/insight-llvm/SKILL.md +1 -1
- package/skills/insight-managed-heap/SKILL.md +1 -1
- package/skills/insight-managed-metadata/SKILL.md +1 -1
- package/skills/insight-mitmproxy/SKILL.md +1 -1
- package/skills/insight-overview/SKILL.md +1 -1
- package/skills/insight-procmon/SKILL.md +1 -1
- package/skills/insight-re/SKILL.md +1 -1
- package/skills/insight-re/references/artifacts.md +1 -1
- package/skills/insight-re/references/storage.md +99 -0
- package/skills/insight-sevenzip/SKILL.md +1 -1
- package/skills/insight-strace/SKILL.md +1 -1
- package/skills/insight-tshark/SKILL.md +1 -1
- package/skills/insight-windbg/SKILL.md +1 -1
|
@@ -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.
|
|
6
|
+
# Insight Managed Heap 0.3.0
|
|
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.
|
|
6
|
+
# Insight Managed Metadata 0.3.0
|
|
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.
|
|
6
|
+
# Insight mitmproxy 0.3.0
|
|
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.
|
|
6
|
+
# Insight Overview 0.3.0
|
|
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.
|
|
6
|
+
# Insight ProcMon 0.3.0
|
|
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.
|
|
6
|
+
# Insight RE 0.3.0
|
|
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
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Save ordinary research materials
|
|
2
2
|
|
|
3
3
|
`insight-cli artifacts save <path> --json` saves a file or a settled directory tree in
|
|
4
|
-
the selected profile's AppData. It needs Factory Update permission and does not require
|
|
4
|
+
the selected profile's [analysis storage](storage.md), which defaults to AppData. It needs Factory Update permission and does not require
|
|
5
5
|
Ghidra, Java, authentication, target/session selectors or evidence metadata. Relative input
|
|
6
6
|
paths resolve against the caller's working directory. Use `--help` for generated syntax.
|
|
7
7
|
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
# Analysis storage and migration
|
|
2
|
+
|
|
3
|
+
`storage show --json` reports effective profile storage, availability, active file/byte usage,
|
|
4
|
+
exact included trees and retained migration. The default is Factory profile AppData. No
|
|
5
|
+
checkout, environment or automatic disk fallback changes it. The non-secret setting is
|
|
6
|
+
`analysisDirectory` in Factory's profile (`profile show` also displays it). Use storage commands
|
|
7
|
+
to change it safely.
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
insight-cli permissions grant Update
|
|
11
|
+
insight-cli storage show --json
|
|
12
|
+
insight-cli storage configure --directory "/mnt/analysis volume" --json
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
`configure` requires no existing analysis entries. With existing data use `migrate`.
|
|
16
|
+
The directory is a **base**: the effective root appends `insight-cli/<profile>`, preserving
|
|
17
|
+
profile isolation. Choose an ordinary empty destination profile directory on a mounted local
|
|
18
|
+
filesystem. Spaces and Unicode are supported. Factory restricts the dedicated destination root to the
|
|
19
|
+
current user, including a Windows ACL; a filesystem that cannot apply this protection fails
|
|
20
|
+
before copying.
|
|
21
|
+
|
|
22
|
+
The complete `workspace`, `materials`, `temp` and `runtime` trees move: immutable inputs,
|
|
23
|
+
artifact/candidate snapshots, workspace SQLite DB/WAL, native private project/context DBs,
|
|
24
|
+
local Ghidra Server repositories, operation/publication/import journals, debugger traces,
|
|
25
|
+
process captures, exports, native helper compilation and verification working data.
|
|
26
|
+
**Runtime installations, acquisition caches, selections and process receipts move too**;
|
|
27
|
+
installation staging and activation must share a filesystem. External tool installations and
|
|
28
|
+
user-selected outputs outside these trees keep their locations.
|
|
29
|
+
|
|
30
|
+
Factory keeps profiles, permissions, IPC election/socket, migration-control metadata and
|
|
31
|
+
application logs in current-user AppData. Secrets stay in the OS keyring. Credential/profile
|
|
32
|
+
identities do not change. Updating/installing npm never migrates a profile automatically.
|
|
33
|
+
|
|
34
|
+
## Move an existing profile
|
|
35
|
+
|
|
36
|
+
Finish changing commands, close native contexts, and stop this profile's owned server/tool
|
|
37
|
+
processes through ordinary CLI commands. Inspect `tools processes --json`. Unverified lifetimes
|
|
38
|
+
also block migration. Do not kill guessed PIDs or stop other profiles to make preflight pass.
|
|
39
|
+
Factory retains IPC ownership and command admission; other profiles can keep working.
|
|
40
|
+
|
|
41
|
+
```sh
|
|
42
|
+
insight-cli storage migrate --directory "/mnt/analysis volume" --dry-run --json
|
|
43
|
+
insight-cli storage migrate --directory "/mnt/analysis volume" --json
|
|
44
|
+
insight-cli storage show --json
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Dry-run checks separation, destination contents, access, conservative capacity and quiescence
|
|
48
|
+
without reserving/copying a migration. Source/destination/configuration roots cannot be equal
|
|
49
|
+
or nested. Destination symlink roots, escaping source links, special files, unresolved links
|
|
50
|
+
and inventories above one million entries or 128 directory levels are rejected. Internal
|
|
51
|
+
links retain their exact target strings. Preflight does not reserve space; concurrent disk use
|
|
52
|
+
can still cause a copy failure.
|
|
53
|
+
|
|
54
|
+
Migration durably reserves its journal, hashes stable source bytes, streams/syncs the copy,
|
|
55
|
+
independently hashes destination bytes and rechecks the source. Only then does it replace source
|
|
56
|
+
trees with permanent compatibility links and commit the Factory setting. Original trees are
|
|
57
|
+
renamed into `.storage-retained/<migration>` on their original volume. Copy/activation never
|
|
58
|
+
deletes them, including on failures. Existing IDs, requests, journals, candidate snapshots and
|
|
59
|
+
receipts retain exact bytes. Compatibility paths preserve old absolute references: do not remove
|
|
60
|
+
those links or their profile/source ancestors manually after migrating.
|
|
61
|
+
|
|
62
|
+
## Interruptions, uncertainty and retention
|
|
63
|
+
|
|
64
|
+
```sh
|
|
65
|
+
insight-cli storage resume --json
|
|
66
|
+
insight-cli storage rollback --json
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Ordinary research freezes during incomplete copy/activation/rollback/cleanup. `show` and Factory
|
|
70
|
+
profile inspection remain available. Resume verifies completed files, recopies an incomplete
|
|
71
|
+
file, rechecks capacity and finishes the retained transaction. Source and destination filesystem
|
|
72
|
+
anchor identities are bound durably. Missing/replaced volumes fail without creating a system-disk
|
|
73
|
+
fallback; mount the original volume before resuming.
|
|
74
|
+
|
|
75
|
+
Rollback restores retained source and the prior Factory setting. After activation it requires
|
|
76
|
+
an unchanged destination and a verified retained source. Native reopening or later findings can
|
|
77
|
+
make rollback unsafe, in which case it refuses and preserves both copies. Use forward migration
|
|
78
|
+
to another empty base after using the new location. A rolled-back destination remains for manual
|
|
79
|
+
inspection/removal and is never automatically adopted. Cleanup permanently disables rollback.
|
|
80
|
+
|
|
81
|
+
Unknown script/publication effects do **not** need abandonment before migrating a stopped
|
|
82
|
+
profile. Migration starts no worker, replays no script/check-in and marks no unknown outcome
|
|
83
|
+
applied. Inspect the original request after migrating; existing [recovery](recovery.md)
|
|
84
|
+
restrictions and independent readback requirements still apply.
|
|
85
|
+
|
|
86
|
+
After independent native reopen and saved-file readback, free retained source explicitly:
|
|
87
|
+
|
|
88
|
+
```sh
|
|
89
|
+
insight-cli permissions grant Destructive
|
|
90
|
+
insight-cli storage cleanup --json
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Cleanup verifies retained bytes, records irreversible intent, then deletes only that owned
|
|
94
|
+
backup. Interrupted cleanup continues through `storage resume`; rollback is already disabled.
|
|
95
|
+
Compatibility links, receipts and manifests remain. Clean or roll back the current migration
|
|
96
|
+
before starting another. This release provides no nonempty-destination adoption, reverse
|
|
97
|
+
synchronization, live-DB snapshotting or network-filesystem guarantees. POSIX directory fsync
|
|
98
|
+
is used. Windows has file fsync and rename/junction semantics; Node cannot fsync directories
|
|
99
|
+
there, and internal symlinks can require OS privileges.
|
|
@@ -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.
|
|
6
|
+
# Insight 7-Zip 0.3.0
|
|
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.
|
|
6
|
+
# Insight strace 0.3.0
|
|
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.
|
|
6
|
+
# Insight TShark 0.3.0
|
|
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.
|
|
6
|
+
# Insight WinDbg 0.3.0
|
|
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
|