feat(gnovm): VM Instrumentation and Profiling System

[notJoon]

Description

This pull request introduces the instrumentation-first profiling architecture. The VM now emits structured events (CPU/gas samples, allocation events, and line samples) through a instrumentation.Sink interface, and the profiler consumes those events without depending on VM internals.

docs (draft): https://gist.github.com/notJoon/de3a4e4fceeedd25bddcecef289be547

Key Changes

Instrumentation Layer

• Added instrumentation package with SampleContext, FrameSnapshot, AllocationEvent, LineSample, and Sink.
• Machine accepts an optional sink via MachineOptions. When nil, the VM runs with zero additional work (only a nil-check).
• Allocation and line-level hooks now emit events only when a sink advertises interest.

Profiler Core

• The profiler implements the sink interface, maintaining:
  • Canonical frame table (frame interning → stable FrameIDs).
  • Incremental call-tree aggregation.
  • Function statistics (call count, self/total cycles/gas, allocations).
  • Per-function line tables and file-level line stats.
• Sampling updates these aggregates incrementally; final profiles are produced via Profile.WriteFormat.

CLI / Test Harness Integration

• ProfileConfig wires sinks into every test VM, enables gas meters or allocators as needed, and exposes new flags:
  • -profile master switch.
  • -profile-type, -profile-format, -profile-sample-rate, -profile-output, -profile-stdout.
  • -profile-interactive (launch shell) and -profile-line (enable line-level sampling).
• Interactive shell mirrors pprof commands (top, list, calltree, json, text, clear, exit), reusing the captured profile without rerunning tests.

[Gno2D2]

🛠 PR Checks Summary

🔴 Pending initial approval by a review team member, or review from tech-staff

Manual Checks (for Reviewers):

• IGNORE the bot requirements for this PR (force green CI check)

Read More

🤖 This bot helps streamline PR reviews by verifying automated checks and providing guidance for contributors and reviewers.

✅ Automated Checks (for Contributors):

🟢 Maintainers must be able to edit this pull request (more info)
🔴 Pending initial approval by a review team member, or review from tech-staff

☑️ Contributor Actions:

1. Fix any issues flagged by automated checks.
2. Follow the Contributor Checklist to ensure your PR is ready for review.
   • Add new tests, or document why they are unnecessary.
   • Provide clear examples/screenshots, if necessary.
   • Update documentation, if required.
   • Ensure no breaking changes, or include BREAKING CHANGE notes.
   • Link related issues/PRs, where applicable.

☑️ Reviewer Actions:

1. Complete manual checks for the PR, including the guidelines and additional checks if applicable.

📚 Resources:

• Report a bug with the bot.
• View the bot’s configuration file.

Debug

Automated Checks

Maintainers must be able to edit this pull request (more info)

If

🟢 Condition met
└── 🟢 And
    ├── 🟢 The base branch matches this pattern: ^master$
    └── 🟢 The pull request was created from a fork (head branch repo: notJoon/gno-core)

Then

🟢 Requirement satisfied
└── 🟢 Maintainer can modify this pull request

Pending initial approval by a review team member, or review from tech-staff

If

🟢 Condition met
└── 🟢 And
    ├── 🟢 The base branch matches this pattern: ^master$
    └── 🟢 Not (🔴 Pull request author is a member of the team: tech-staff)

Then

🔴 Requirement not satisfied
└── 🔴 If
    ├── 🔴 Condition
    │   └── 🔴 Or
    │       ├── 🔴 At least one of these user(s) reviewed the pull request: [jefft0 leohhhn n0izn0iz notJoon omarsy x1unix] (with state "APPROVED")
    │       ├── 🔴 At least 1 user(s) of the team tech-staff reviewed pull request
    │       └── 🔴 This pull request is a draft
    └── 🔴 Else
        └── 🔴 And
            ├── 🟢 This label is applied to pull request: review/triage-pending
            └── 🔴 On no pull request

Manual Checks

**IGNORE** the bot requirements for this PR (force green CI check)

If

🟢 Condition met
└── 🟢 On every pull request

Can be checked by

• Any user with comment edit permission

[codecov]

Codecov Report

❌ Patch coverage is 55.32451% with 709 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
gnovm/pkg/profiler/profiler.go	69.78%	150 Missing and 44 partials ⚠️
gnovm/pkg/profiler/visualization.go	3.87%	124 Missing ⚠️
gnovm/pkg/gnolang/machine_profiling.go	40.59%	109 Missing and 11 partials ⚠️
gnovm/pkg/test/test.go	45.18%	52 Missing and 22 partials ⚠️
gnovm/pkg/profiler/line_level.go	0.00%	71 Missing ⚠️
gnovm/cmd/gno/profile_shell.go	28.00%	51 Missing and 3 partials ⚠️
gnovm/pkg/profiler/list.go	80.74%	19 Missing and 12 partials ⚠️
gnovm/cmd/gno/test.go	70.73%	22 Missing and 2 partials ⚠️
gnovm/pkg/profiler/instrumentation_adapter.go	78.57%	9 Missing and 3 partials ⚠️
gnovm/pkg/gnolang/machine.go	76.92%	3 Missing ⚠️
... and 1 more

📢 Thoughts on this report? Let us know!