@eyeauras/insight-cli 0.2.3 → 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 +31 -6
- package/dist/src/contexts.d.ts +1 -0
- package/dist/src/contexts.js +9 -8
- package/dist/src/decode-results.d.ts +1 -0
- package/dist/src/decode-results.js +21 -0
- package/dist/src/function-inspection.d.ts +31 -0
- package/dist/src/function-inspection.js +78 -0
- package/dist/src/function-results.d.ts +2 -0
- package/dist/src/function-results.js +21 -0
- 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/queries.js +10 -2
- package/dist/src/query-policy.js +1 -1
- package/dist/src/research.d.ts +21 -0
- package/dist/src/research.js +14 -8
- 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/native/InsightResearchQueries.java +33 -2
- package/references/research.md +40 -0
- 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/research.md +40 -0
- 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/research.md +40 -0
- 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-capture
|
|
|
3
3
|
description: Capture one explicitly authorized native program run, exact stdout/stderr and declared file snapshots through insight-cli capture, then inspect or compare retained reports without replay. Use for controlled input/output research, preserving original files and interrupted or unknown outcomes.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Insight Capture 0.
|
|
6
|
+
# Insight Capture 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-cli
|
|
|
3
3
|
description: Choose and prepare reverse-engineering capabilities from the insight-cli toolbox for binary, managed-code and runtime investigations. Use to discover the appropriate tool or its packaged skill before installing native runtimes.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# insight-cli 0.
|
|
6
|
+
# insight-cli 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
|
|
@@ -36,6 +36,9 @@ multi-agent guidance; `skill insight-ghidra`, `skill insight-ilspy` and
|
|
|
36
36
|
installing npm binaries does not register them in an agent host. See
|
|
37
37
|
[agent connection](references/agent-setup.md) for current setup and access requirements.
|
|
38
38
|
|
|
39
|
+
Inspect `storage show --json` before relocating a profile. Use the supported
|
|
40
|
+
[storage workflow](references/storage.md), preserving unknown operations and native folders.
|
|
41
|
+
|
|
39
42
|
Use generated help as the syntax authority. Catalog metadata describes shipped capabilities;
|
|
40
43
|
profile runtime readiness comes from the selected tool's `status`. Unavailable profile/IPC
|
|
41
44
|
access means execution readiness is unknown. Preserve work and diagnose access before trying
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# Continue saved work
|
|
2
|
+
|
|
3
|
+
Retain the session/target returned by initial open. Continue the tuple through
|
|
4
|
+
`insight-cli ghidra open --session <id> --target <id> --json`. Saved private snapshots and
|
|
5
|
+
pending scalar comparisons persist independently of a backend process. Reopening preserves
|
|
6
|
+
private work; it does not silently receive a newer shared version.
|
|
7
|
+
|
|
8
|
+
First-import recovery uses the same scoped `ghidra open` or the original request ID/input.
|
|
9
|
+
Import/analysis writes a private snapshot and completion receipt before any initial publication.
|
|
10
|
+
If its worker is still running, continuation reports busy; wait and continue the same scope.
|
|
11
|
+
If that worker stopped before completing its receipt, continuation can repeat private analysis
|
|
12
|
+
from the immutable input while retaining previous attempts. A completed snapshot is reused.
|
|
13
|
+
Initial publication first creates a uniquely named staging object. A separate read-only process
|
|
14
|
+
verifies its complete saved DB buffers before a conditional server move to the absent canonical
|
|
15
|
+
path. It never checks in a new version of an existing canonical item. Lost promotion replies
|
|
16
|
+
are reconciled against the retained identity, one-version history and complete saved buffers.
|
|
17
|
+
Interrupted staging objects remain retained and can be replaced by another private stage;
|
|
18
|
+
they are not adopted as the canonical model. Foreign or mismatched canonical state stays blocked.
|
|
19
|
+
An older direct create that is provably owned and left only an incomplete `<Recovered>` entry
|
|
20
|
+
can be moved aside without deletion; its bytes and original receipt remain preserved.
|
|
21
|
+
|
|
22
|
+
Legacy first-import failures are also recoverable in the original profile. Continuation first
|
|
23
|
+
establishes that the old owned bootstrap worker has ended, then uses an authoritative repository
|
|
24
|
+
probe. An absent canonical item permits private preparation; an existing first version requires
|
|
25
|
+
independent readback. The old project, intent and original session/target remain preserved.
|
|
26
|
+
|
|
27
|
+
If a response was lost, inspect `sessions status <session> --target <target>`. Never infer
|
|
28
|
+
`applied` from a connection failure. A changing command's optional request ID binds one effective
|
|
29
|
+
intent inside the profile. Repeating the same ID/input retrieves its recorded outcome or
|
|
30
|
+
unresolved state; changing input under that ID fails. Without an ID, calls are new intentions.
|
|
31
|
+
|
|
32
|
+
An unknown or partial effect retains its request intent, snapshots and native stage. Open the
|
|
33
|
+
same tuple to reconcile supported outcomes. A committed merge is verified against its recorded
|
|
34
|
+
server version and complete saved buffers through independent read authority; it is never
|
|
35
|
+
checked in again merely because its response was lost. Until verification succeeds, publication
|
|
36
|
+
for this shared target is blocked across sessions. Saved private work remains retained.
|
|
37
|
+
|
|
38
|
+
Scalar reconciliation observes and saves an already present effect; it does not execute the
|
|
39
|
+
setter again. Supported structural/function edits retain a candidate snapshot after an incomplete
|
|
40
|
+
response; continuation can verify every requested effect in that immutable snapshot and adopt it
|
|
41
|
+
without replay. If the complete result cannot be established, the candidate and previous saved
|
|
42
|
+
private view remain retained. An unproved program/script/external outcome remains unresolved. Preserve the profile
|
|
43
|
+
storage and credential store. Do not delete another session's project, stop a process by guessed
|
|
44
|
+
PID/port, or blindly repeat a script/external action to turn uncertainty into success.
|
|
45
|
+
|
|
46
|
+
The older prototype's `workers`, `findings`, `integrate` and batch `recover` commands are not the
|
|
47
|
+
public facade API. Its coordinator journals remain separate and are never silently migrated.
|
|
48
|
+
|
|
49
|
+
A lost UI navigation response can be verified from the live authenticated cursor without another
|
|
50
|
+
goto. If its original owned GUI process has exited, continuation reports the uncertain UI action
|
|
51
|
+
as disconnected and retains saved program work. It does not recreate the old cursor or re-enable
|
|
52
|
+
a previous prompt policy. Other unproved live UI effects remain retained until their outcome is
|
|
53
|
+
established or the original process is known to have ended.
|
|
54
|
+
|
|
55
|
+
## Abandon an uncertain private program attempt
|
|
56
|
+
|
|
57
|
+
A post-mutation save timeout does not repeat the script or issue another save in the
|
|
58
|
+
error handler. Status exposes the original request identity and retained phase/budget.
|
|
59
|
+
Arbitrary script effects are never inferred from metadata or from an unverified DB.
|
|
60
|
+
After inspecting the retained attempt, explicitly stop only its verified owned worker
|
|
61
|
+
(`tools processes`, then `tools processes kill <process>` if required). Resume the
|
|
62
|
+
last acknowledged private snapshot with:
|
|
63
|
+
|
|
64
|
+
```sh
|
|
65
|
+
insight-cli permissions grant Destructive
|
|
66
|
+
insight-cli ghidra abandon --session <session> --target <target> \
|
|
67
|
+
--request-id <original-request> --acknowledge-unknown-effects --json
|
|
68
|
+
insight-cli ghidra open --session <session> --target <target> --json
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Abandon requires exactly one unresolved private program operation, an unchanged verified
|
|
72
|
+
previous snapshot/generation, a stopped original worker and no active publication or live
|
|
73
|
+
debugger. It retains the native project, candidate artifacts, original intent/execution and
|
|
74
|
+
previous diagnostic result. Its terminal request is `failed` / `state: abandoned` with
|
|
75
|
+
`outcome: unknown`; no effect is marked applied. Repeating abandonment retrieves the same
|
|
76
|
+
result. Earlier saved private edits remain pending. The original changing request ID cannot
|
|
77
|
+
execute again. Abandoning never undoes external effects or establishes what an arbitrary
|
|
78
|
+
script did; the acknowledgement explicitly accepts that uncertainty. Publication recovery,
|
|
79
|
+
initial import, UI and debugger attempts use their own protocols and cannot use this command.
|
|
@@ -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-die
|
|
|
3
3
|
description: Classify unknown executable or container inputs by format, architecture and compiler/runtime/packer signatures with Detect It Easy before choosing managed or native analysis. Use insight-cli die for static triage and preserve scan uncertainty.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Insight Detect It Easy 0.
|
|
6
|
+
# Insight Detect It Easy 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-dnspy
|
|
|
3
3
|
description: Debug a managed Windows EXE at an IL breakpoint and read primitive arguments, or change one expected IL Int32 constant in a new assembly copy through insight-cli dnspy. Use when C# decompilation needs observed execution or a controlled binary edit.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Insight dnSpyEx 0.
|
|
6
|
+
# Insight dnSpyEx 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-dotnet-dump
|
|
|
3
3
|
description: Capture a managed heap dump or inspect compatible .NET dumps with SOS to recover waiting stacks, objects, fields and retention evidence.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Insight .NET Dump 0.
|
|
6
|
+
# Insight .NET Dump 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-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.
|
|
6
|
+
# Insight .NET Stack 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-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.
|
|
6
|
+
# Insight .NET Trace 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-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.
|
|
6
|
+
# Insight Frida 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-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.
|
|
6
|
+
# Insight Ghidra 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
|
|
|
@@ -79,7 +79,7 @@ operations until `connect`/`start`. `server connect/disconnect` retain their con
|
|
|
79
79
|
An external server remains configured through profile server/repository/account fields and Factory
|
|
80
80
|
secrets; `server stop` cannot stop that external service.
|
|
81
81
|
|
|
82
|
-
Code/cache/installation receipts live under
|
|
82
|
+
Code/cache/installation receipts live under configured [analysis storage](storage.md) `runtime/`; research remains under
|
|
83
83
|
`workspace/`, and saved files under `materials/`. One selected immutable installation serves many
|
|
84
84
|
isolated JVM contexts; each has its own projects, home, settings, cache/temp and authenticated
|
|
85
85
|
endpoint. No per-agent copy of the Ghidra code distribution is required. This is process and data
|
|
@@ -99,3 +99,43 @@ publish program work. Switching modes retains private edits and other sessions k
|
|
|
99
99
|
|
|
100
100
|
Selected native SDK commands and their effect/budget contracts are described in
|
|
101
101
|
[native workflows](native-workflows.md).
|
|
102
|
+
|
|
103
|
+
`functions get/decompile` failures include `selector`, stable `reason` and, when supplied by
|
|
104
|
+
native, a sanitized diagnostic of at most 500 Unicode characters. Reasons distinguish
|
|
105
|
+
`function_not_found`, `native_function_failure`, `selector_mismatch`, `invalid_native_shape`,
|
|
106
|
+
`missing_signature` and `missing_decompiler_text`. Missing definitions remain failures; reads
|
|
107
|
+
never create functions or run analysis. JSON-RPC `cli.execute` preserves the same error data.
|
|
108
|
+
|
|
109
|
+
The existing `functions inspect` accepts 1–20 distinct names/addresses. Existing `--fields`
|
|
110
|
+
remain valid; unknown fields fail before dispatch. Decompiled text uses per-item
|
|
111
|
+
`--offset-chars` (default 0), `--limit-chars` (default 16000, maximum 32768), and a shared
|
|
112
|
+
`--total-chars` budget (default 64000, maximum 128000), allocated in selector order.
|
|
113
|
+
Each item retains success/not-found/failure and `text` metadata: full returned-native-text
|
|
114
|
+
SHA-256, Unicode code-point length, window, next offset and native truncation. A zero-length
|
|
115
|
+
window can mean the total budget was exhausted. A last CLI page does not establish native
|
|
116
|
+
completeness. Use fewer selectors to advance a starved item. The one MiB response cap still
|
|
117
|
+
applies to all fields. These are text/result bounds, not a native decompiler CPU budget.
|
|
118
|
+
|
|
119
|
+
Keep `value.view.identity` and supply `--expect-view <identity>` on continuation. An observed
|
|
120
|
+
context generation, snapshot or revision change rejects continuation with `changed_view`.
|
|
121
|
+
Hashes bind each observed native text; compare them across pages as well. A view identity is
|
|
122
|
+
conservative across lifecycle changes and does not assert determinism of the decompiler.
|
|
123
|
+
|
|
124
|
+
For compact evidence, use `--save-owner-directory <absolute-new-path>`. The elected CLI owner
|
|
125
|
+
writes full returned native text (at most four MiB per function, at most 20 functions) to numbered
|
|
126
|
+
hash-named `.c` files and writes `manifest.json` last. The response omits inline code and gives
|
|
127
|
+
absolute paths, coverage, hashes, lengths and native truncation. This directory is on the owner
|
|
128
|
+
host, including through JSON-RPC; it is never silently a client-host path. An existing directory
|
|
129
|
+
is rejected. A filesystem failure can leave a partial new directory without a completed manifest;
|
|
130
|
+
retain it for inspection and choose a fresh directory for another explicit save.
|
|
131
|
+
|
|
132
|
+
`functions decode --address <address> --max-bytes 64 --max-instructions 16` uses Ghidra pseudo
|
|
133
|
+
instructions without defining listing instructions, functions or xrefs, running analyzers or
|
|
134
|
+
saving state. It requires initialized executable memory and currently supports x86 language
|
|
135
|
+
variants; other languages return an explicit unsupported capability error. Bounds are 1–4096
|
|
136
|
+
bytes in one executable block and 1–256 instructions. Results bind input bytes/hash, language,
|
|
137
|
+
compiler and context view to instructions, consumed bytes and stop reason. Direct targets are
|
|
138
|
+
computed from instruction bytes, not proof of function membership or stored xrefs. Indirect
|
|
139
|
+
flow has no invented target. Decoding stops at terminal/unconditional flow, input/instruction
|
|
140
|
+
bounds, undecodable/truncated bytes or unavailable context. Existing `disassemble-bytes` remains
|
|
141
|
+
an Update operation with its original guards.
|
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
# Setup
|
|
2
2
|
|
|
3
|
+
Inspect `storage show --json` and read [analysis storage](storage.md) before moving databases.
|
|
4
|
+
Use `storage configure` for an empty profile or `storage migrate` for existing work. Factory
|
|
5
|
+
control metadata and keyring identity stay in their original locations.
|
|
6
|
+
|
|
3
7
|
Use Node 24+ and `ghidra install` to deliver Ghidra 12.1.2, JDK 21, native components and
|
|
4
8
|
server support. See [managed runtime](managed-runtime.md) for download/install/offline archives,
|
|
5
9
|
external executable paths, status/doctor and safe removal. Existing Factory profile `java` and
|
|
@@ -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-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.
|
|
6
|
+
# Insight ILSpy 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-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.
|
|
6
|
+
# Insight Interop 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-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.
|
|
6
|
+
# Insight LLDB 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-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.
|
|
6
|
+
# Insight LLVM 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-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
|
|