Skip to content

fix(skills): remove track-heap-objects from leak hunter workflow - #65

Closed
Cesar-M-Diaz wants to merge 1 commit into
mainfrom
cesar/fix-leak-skills
Closed

fix(skills): remove track-heap-objects from leak hunter workflow#65
Cesar-M-Diaz wants to merge 1 commit into
mainfrom
cesar/fix-leak-skills

Conversation

@Cesar-M-Diaz

@Cesar-M-Diaz Cesar-M-Diaz commented Aug 25, 2026

Copy link
Copy Markdown
Collaborator

asset-summary does not support heap-profile assets (the type produced by track-heap-objects), so Phase 3 of ns-advanced-memory-leak-hunter failed with 'Unsupported asset type' during baseline-vs-peak hunts.

  • Leak hunter now captures the peak with heap-sampling only; closure/retainer suspicion is handled by correlating allocator call stacks with runtime-code
  • Add guardrail documenting the unsupported asset type
  • Update ns-analyze-asset cross-reference (no longer recommends track-heap-objects)
  • Drop track-heap-objects mention from ns-memory-spike-analysis bundle description

Summary by CodeRabbit

  • Documentation
    • Updated memory analysis guidance to use 60-second heap sampling for peak captures.
    • Clarified that unsupported heap-profile assets should not be captured or analyzed.
    • Revised leak investigation recommendations to compare baseline and peak heap samples.
    • Updated related skill descriptions and follow-up guidance for more consistent memory diagnostics.

asset-summary does not support heap-profile assets (the type produced by
track-heap-objects), so Phase 3 of ns-advanced-memory-leak-hunter failed
with 'Unsupported asset type' during baseline-vs-peak hunts.

- Leak hunter now captures the peak with heap-sampling only; closure/retainer
  suspicion is handled by correlating allocator call stacks with runtime-code
- Add guardrail documenting the unsupported asset type
- Update ns-analyze-asset cross-reference (no longer recommends track-heap-objects)
- Drop track-heap-objects mention from ns-memory-spike-analysis bundle description
@coderabbitai

coderabbitai Bot commented Aug 25, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5e7ff0e7-d28d-4249-8f0f-300f3701ad02

📥 Commits

Reviewing files that changed from the base of the PR and between 72ad7a3 and e60f8a5.

📒 Files selected for processing (4)
  • bundle.json
  • packages/core/bundle.json
  • skills/ns-advanced-memory-leak-hunter/SKILL.md
  • skills/ns-analyze-asset/SKILL.md

Included review availability: 4 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 5 reviews per hour.


Walkthrough

The memory analysis guidance now requires baseline and peak heap sampling. It removes track-heap-objects recommendations and documents that asset-summary cannot process its heap-profile assets.

Changes

Memory Analysis Guidance

Layer / File(s) Summary
Standardize heap-sampling workflow
skills/ns-advanced-memory-leak-hunter/SKILL.md
Peak capture now uses 60-second heap-sampling. Closure and retainer investigations use allocator call stacks through Phase 5 runtime-code. Guardrails prohibit unsupported heap-profile assets.
Update skill descriptions
bundle.json, packages/core/bundle.json, skills/ns-analyze-asset/SKILL.md
Skill descriptions now recommend baseline-versus-peak heap sampling instead of track-heap-objects retainer analysis.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: ⚪ Minimal · up to e60f8

This PR removes an unsupported heap-profile capture path from the leak-hunter workflow and updates related documentation; no actionable merge-blocking risk remains beyond normal checks and review.

Poem

A rabbit reviews the sampling trail
Baseline and peak now share the tale
Heap profiles stay outside the gate
Runtime stacks reveal the state
Clean guidance hops into place

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change: removing track-heap-objects from the leak hunter workflow.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (4 skipped: 4 unsupported.)

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch cesar/fix-leak-skills

Comment @coderabbitai help to get the list of available commands.

@ns-control-tower ns-control-tower left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Walkthrough

This docs-only PR removes track-heap-objects from the ns-advanced-memory-leak-hunter workflow because the resulting heap-profile asset is not supported by asset-summary (the tool consumed during baseline-vs-peak hunts), causing Phase 3 to fail with "Unsupported asset type". The peak is now captured with heap-sampling only, closure/retainer suspicion is handled by correlating allocator call stacks with runtime-code, a new guardrail documents the unsupported asset type, and the two bundle.json descriptions plus the ns-analyze-asset cross-reference are updated to stay consistent.

Changes

File(s) Summary
bundle.json, packages/core/bundle.json Drop the track-heap-objects mention from the ns-memory-spike-analysis description; both copies kept in sync.
skills/ns-advanced-memory-leak-hunter/SKILL.md Phase 3 reworked to use heap-sampling only; added a guardrail explaining asset-summary does not support heap-profile assets.
skills/ns-analyze-asset/SKILL.md Follow-up recommendation no longer points to track-heap-objects; now recommends a deeper baseline-vs-peak heap-sampling hunt.

Assessment

  • No code, security, async, or performance surfaces — this is a markdown/JSON skill-description change only, so no sandbox validation was warranted.
  • 🧹 One non-blocking nitpick on ns-analyze-asset/SKILL.md: after the edit, the two consecutive follow-up bullets both point to ns-advanced-memory-leak-hunter, making the second bullet redundant. Optional tidy.
  • The two bundle.json files were correctly kept in sync (identical edits), avoiding a drift between the root and packages/core copies.

Verdict: APPROVE — clean docs-only fix; the only finding is a non-blocking readability nitpick.

Comment on lines +76 to 77
- If allocation stack traces are insufficient, recommend a deeper leak hunt (baseline vs peak heap sampling) via `ns-advanced-memory-leak-hunter`.
- For deeper leak hunting workflows, reference the `ns-advanced-memory-leak-hunter` skill.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick

After this edit both bullets now point to ns-advanced-memory-leak-hunter, making the second bullet largely redundant with the first. Consider merging them into one recommendation, or dropping the second bullet entirely.

Suggested change
- If allocation stack traces are insufficient, recommend a deeper leak hunt (baseline vs peak heap sampling) via `ns-advanced-memory-leak-hunter`.
- For deeper leak hunting workflows, reference the `ns-advanced-memory-leak-hunter` skill.
- If allocation stack traces are insufficient, recommend a deeper leak hunt (baseline vs peak heap sampling) via `ns-advanced-memory-leak-hunter`.

(non-blocking — purely a readability tidy)

@Cesar-M-Diaz

Copy link
Copy Markdown
Collaborator Author

Folded into #64 — the leak-hunter heap-profile fix now rides in the combined asset-tooling PR (see 'Folded from #65' section). Closing this in favor of #64.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants