Experiment with a command-line tool for querying profile contents

.github/workflows/ci.yml

@@ -46,6 +46,21 @@ jobs:
         with:
           fail_ci_if_error: false
 
+  cli-tests:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Setup Node.js and install dependencies
+        uses: ./.github/actions/setup-node-and-install
+
+      - name: Run CLI tests
+        run: yarn test-cli
+
   build-prod:
     runs-on: ${{ matrix.os }}
     strategy:

.gitignore

@@ -14,3 +14,4 @@ webpack.local-config.js
 *.orig
 *.rej
 .idea/
+.profiler-cli-dev/

.prettierignore

@@ -1,5 +1,6 @@
 src/profile-logic/import/proto
 src/types/libdef/npm
+profiler-cli/dist
 docs-user/js
 docs-user/css
 src/test/fixtures/upgrades

bin/output-fixing-commands.js

@@ -13,6 +13,7 @@ const fixingCommands = {
   'lint-css': 'lint-fix-css',
   'prettier-run': 'prettier-fix',
   test: 'test -u',
+  'test-cli': 'test-cli -u',
 };
 
 const command = process.argv.slice(2);

eslint.config.mjs

@@ -18,6 +18,7 @@ export default defineConfig(
     ignores: [
       'src/profile-logic/import/proto/**',
       'src/types/libdef/npm/**',
+      'profiler-cli/dist/**',
       'res/**',
       'dist/**',
       'docs-user/**',
@@ -247,7 +248,7 @@ export default defineConfig(
 
   // Test files override
   {
-    files: ['src/test/**/*'],
+    files: ['src/test/**/*', 'profiler-cli/src/test/**/*'],
     languageOptions: {
       globals: {
         ...globals.jest,

jest.config.js

@@ -2,21 +2,14 @@
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
 
-module.exports = {
-  testMatch: ['<rootDir>/src/**/*.test.{js,jsx,ts,tsx}'],
-  moduleFileExtensions: ['js', 'jsx', 'ts', 'tsx'],
-
-  // Use custom resolver that respects the "browser" field in package.json
-  resolver: './jest-resolver.js',
-
+// Shared config for projects that need a browser-like (jsdom) environment.
+// CLI unit tests use the same environment because they import browser-side
+// fixtures to construct profile data.
+const browserEnvConfig = {
   testEnvironment: './src/test/custom-environment',
   setupFilesAfterEnv: ['jest-extended/all', './src/test/setup.ts'],
-
-  collectCoverageFrom: [
-    'src/**/*.{js,jsx,ts,tsx}',
-    '!**/node_modules/**',
-    '!src/types/libdef/**',
-  ],
+  moduleFileExtensions: ['js', 'jsx', 'ts', 'tsx'],
+  resolver: './jest-resolver.js',
 
   transform: {
     '\\.([jt]sx?|mjs)$': 'babel-jest',
@@ -43,5 +36,53 @@ module.exports = {
     escapeString: true,
     printBasicPrototype: true,
   },
-  verbose: false,
+};
+
+module.exports = {
+  projects: [
+    // ========================================================================
+    // Browser Tests (React/browser environment)
+    // ========================================================================
+    {
+      ...browserEnvConfig,
+      displayName: 'browser',
+      testMatch: ['<rootDir>/src/**/*.test.{js,jsx,ts,tsx}'],
+
+      collectCoverageFrom: [
+        'src/**/*.{js,jsx,ts,tsx}',
+        '!**/node_modules/**',
+        '!src/types/libdef/**',
+      ],
+    },
+
+    // ========================================================================
+    // CLI Unit Tests (browser/jsdom environment - imports browser-side fixtures)
+    // ========================================================================
+    {
+      ...browserEnvConfig,
+      displayName: 'cli',
+      testMatch: ['<rootDir>/profiler-cli/src/test/unit/**/*.test.ts'],
+    },
+
+    // ========================================================================
+    // CLI Integration Tests (Node.js environment - spawns real processes)
+    // ========================================================================
+    {
+      displayName: 'cli-integration',
+      testMatch: ['<rootDir>/profiler-cli/src/test/integration/**/*.test.ts'],
+
+      testEnvironment: 'node',
+
+      setupFilesAfterEnv: ['./profiler-cli/src/test/integration/setup.ts'],
+
+      // Integration tests can be slow (loading profiles, spawning processes)
+      testTimeout: 30000,
+
+      moduleFileExtensions: ['ts', 'js'],
+
+      transform: {
+        '\\.([jt]sx?|mjs)$': 'babel-jest',
+      },
+    },
+  ],
 };

locales/en-US/app.ftl

@@ -125,6 +125,15 @@ CallNodeContextMenu--transform-focus-category = Focus on category <strong>{ $cat
     .title =
         Focusing on the nodes that belong to the same category as the selected node,
         thereby merging all nodes that belong to another category.
+
+# This is used as the context menu item to apply the "Drop category" transform.
+# Variables:
+#   $categoryName (String) - Name of the category to drop.
+CallNodeContextMenu--transform-drop-category = Drop samples with category <strong>{ $categoryName }</strong>
+    .title =
+        Dropping samples with a category removes all samples whose leaf frame
+        belongs to that category.
+
 CallNodeContextMenu--transform-collapse-function-subtree = Collapse function
     .title =
         Collapsing a function will remove everything it called, and assign
@@ -1180,6 +1189,11 @@ TransformNavigator--focus-self = Focus Self: { $item }
 #   $item (String) - Name of the category that transform applied to.
 TransformNavigator--focus-category = Focus category: { $item }
 
+# "Drop samples with category" transform (drop is a verb, as in remove).
+# Variables:
+#   $item (String) - Name of the category that transform applied to.
+TransformNavigator--drop-category = Drop samples with category: { $item }
+
 # "Merge call node" transform.
 # See: https://profiler.firefox.com/docs/#/./guide-filtering-call-trees?id=merge
 # Variables:

package.json

@@ -22,6 +22,9 @@
     "build-symbolicator-cli": "cross-env NODE_ENV=production node scripts/build-symbolicator.mjs",
     "build-prod:quiet": "yarn build-prod",
     "build-symbolicator-cli:quiet": "yarn build-symbolicator-cli",
+    "build-profile-query": "cross-env NODE_ENV=production node scripts/build-profile-query.mjs",
+    "build-profile-query:quiet": "yarn build-profile-query",
+    "build-profiler-cli": "cross-env NODE_ENV=production node scripts/build-profiler-cli.mjs",
     "lint": "node bin/output-fixing-commands.js run-p lint-js lint-css prettier-run",
     "lint-fix": "run-p lint-fix-js lint-fix-css prettier-fix",
     "lint-js": "node bin/output-fixing-commands.js eslint . --report-unused-disable-directives --cache --cache-strategy content",
@@ -43,15 +46,16 @@
     "start-examples": "ws -d examples/ -s index.html -p 4244",
     "start-docs": "ws -d docs-user/ -p 3000",
     "start-photon": "node scripts/run-photon-dev-server.mjs",
-    "test": "node bin/output-fixing-commands.js cross-env LC_ALL=C TZ=UTC NODE_ENV=test jest",
+    "test": "node bin/output-fixing-commands.js cross-env LC_ALL=C TZ=UTC NODE_ENV=test jest --selectProjects=browser",
     "test-node": "node bin/output-fixing-commands.js cross-env LC_ALL=C TZ=UTC NODE_ENV=test JEST_ENVIRONMENT=node jest",
-    "test-all": "run-p --max-parallel 4 ts license-check lint test test-alex test-lockfile",
+    "test-all": "run-p --max-parallel 4 ts license-check lint test test-alex test-lockfile && yarn test-cli",
     "test-build-coverage": "yarn test --coverage --coverageReporters=html",
     "test-serve-coverage": "ws -d coverage/ -p 4343",
     "test-coverage": "run-s test-build-coverage test-serve-coverage",
     "test-alex": "alex ./docs-* CODE_OF_CONDUCT.md CONTRIBUTING.md README.md",
     "test-lockfile": "lockfile-lint --path yarn.lock --allowed-hosts yarn --validate-https",
     "test-debug": "cross-env LC_ALL=C TZ=UTC NODE_ENV=test node --inspect-brk node_modules/.bin/jest --runInBand",
+    "test-cli": "yarn build-profiler-cli && node bin/output-fixing-commands.js cross-env LC_ALL=C TZ=UTC NODE_ENV=test jest --selectProjects=cli cli-integration",
     "postinstall": "patch-package"
   },
   "license": "MPL-2.0",
@@ -88,6 +92,7 @@
     "long": "^5.3.2",
     "memoize-immutable": "^3.0.0",
     "memoize-one": "^6.0.0",
+    "commander": "14.0.3",
     "minimist": "^1.2.8",
     "mixedtuplemap": "^1.0.0",
     "namedtuplemap": "^1.0.0",