Fix onboarding experience

vadimpiven · vadimpiven · commit 7dc7df6af503 · 2026-01-18T15:24:29.000+01:00
diff --git a/.cargo/config.toml b/.cargo/config.toml
@@ -1,5 +1,4 @@
 [build]
-rustc-wrapper = "sccache"
 rustflags = ["-C", "force-frame-pointers=yes"]
 rustdocflags = ["-D", "warnings"]
 
diff --git a/.cursorrules b/.cursorrules
@@ -7,7 +7,7 @@
 - When creating new files, ensure the appropriate SPDX license header is included.
 - Prioritize workspace-level dependency management as outlined in the root configs.
 - Maintain concise, friendly, and professional attitude when assisting with development tasks.
-- **CRITICAL**: AI agents MUST execute `pnpm -w fix` after EVERY modification of code or documentation, and before signaling completion, to ensure strict adherence to project standards (linting, formatting, license headers).
+- **CRITICAL**: AI agents MUST execute `mise run --force fix` after EVERY modification of code or documentation, and before signaling completion, to ensure strict adherence to project standards (linting, formatting, license headers).
 - Use `printf` instead of `echo` for shell commands to ensure portability and avoid issues with interpretation of escape sequences.
 - Use `jq` (for JSON) and `yq` (for YAML and TOML) instead of `grep`, `sed`, or `awk` when processing structured data.
 
diff --git a/.github/actions/init-workflow/action.yaml b/.github/actions/init-workflow/action.yaml
@@ -22,6 +22,7 @@ outputs:
     value: |
       {
         "CI": "true",
+        "MISE_QUIET": "false",
         "CARGO_INCREMENTAL": "0",
         "CARGO_NET_GIT_FETCH_WITH_CLI": "true",
         "RUST_BACKTRACE": "1"
diff --git a/.github/workflows/regular.yaml b/.github/workflows/regular.yaml
@@ -94,7 +94,7 @@ jobs:
           fetch-depth: 1
           persist-credentials: false
       - name: "Run zizmor"
-        uses: "zizmorcore/zizmor-action@e639db99335bc9038abc0e066dfcd72e23d26fb4" # v0.3.0
+        uses: "zizmorcore/zizmor-action@3aa7e2f1ad15075829ef5158ee06938ae12e1769" # v0.4.0
         with:
           persona: "auditor"
         env:
diff --git a/.mise-version b/.mise-version
@@ -1 +1 @@
-v2026.1.3
+v2026.1.4
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -2,9 +2,8 @@
 
 ## Development Basics
 
-- **Task Runner**: Use **mise** for all tasks. Use `mise run --list` to see available tasks.
+- **Task Runner**: Use **mise** for all tasks. Use `mise run` to see available tasks.
 - **Testing**: Use `mise run test` to run all checks (unit tests, doctests, and linter).
-- **Package Manager**: Use **pnpm** for Node.js dependencies. Do not use `npm` or `yarn`.
 
 ## Dependency Management
 
@@ -32,5 +31,5 @@ Keep all dependencies in the workspace root.
 Before submitting a pull request, ensure your code passes the project checks:
 
 ```bash
-mise run check
+mise run --force test
 ```
diff --git a/Cargo.toml b/Cargo.toml
@@ -8,7 +8,6 @@ resolver = "3"
 
 [workspace.package]
 edition = "2024"
-version = "0.0.0"
 license = "Apache-2.0 OR MIT"
 
 [profile.dev]
diff --git a/mise.toml b/mise.toml
@@ -8,11 +8,14 @@ env_file = ".env"
 npm.package_manager = "pnpm"
 rust.cargo_home = ".cache/native/cargo"
 rust.rustup_home = ".cache/native/rustup"
+quiet = true
 
 [env]
 PYTHONUTF8 = "1"
 PYTHONWARNINGS = "ignore"
 SCCACHE_CACHE_SIZE = "1G"
+RUSTC_WRAPPER = "sccache"
+MISE_ACTIVE = "1"
 
 # Cache directories
 CARGO_HOME = "{{ config_root }}/.cache/native/cargo"
@@ -107,24 +110,10 @@ hide = true
 env = { CI = "true", HUSKY = "1" }
 run = [
     "corepack enable pnpm",
-    "pnpm install --frozen-lockfile --prefer-offline",
-    { task = "setup:playwright" },
+    "pnpm install --frozen-lockfile",
 ]
 sources = ["pnpm-lock.yaml", "pnpm-workspace.yaml", "package.json", "packages/**/package.json"]
 
-[tasks."setup:playwright"]
-description = "Install Playwright dependencies"
-hide = true
-usage = """
-arg "[env]" help="Environment name" env="MISE_ENV" default="native"
-"""
-run = """
-{%- if usage.env != "docker" -%}
-  playwright install-deps
-{%- endif -%}
-"""
-sources = ["pnpm-lock.yaml", "pnpm-workspace.yaml", "package.json"]
-
 [tasks."setup:python"]
 description = "Setup Python environment with uv"
 hide = true
@@ -135,7 +124,7 @@ mise sync python --uv
 sources = ["pyproject.toml", "packages/**/pyproject.toml", "uv.lock"]
 
 [tasks.setup]
-description = "Install all tools and dependencies"
+description = "Install all dependencies"
 depends = ["setup:rust", "setup:pnpm", "setup:python"]
 
 # ============================================================================
@@ -402,7 +391,7 @@ run = [{ task = "check:pnpm-audit" }]
 
 # --- Global check/fix tasks ---
 [tasks.check]
-description = "Run all checks"
+description = "Verify code quality"
 alias = "c"
 depends = [
     "check:ruff-lint",
@@ -425,7 +414,7 @@ depends = [
 ]
 
 [tasks.fix]
-description = "Run all fixes"
+description = "Auto-fix code issues"
 alias = "f"
 depends = [
     "fix:ruff-lint",
@@ -478,7 +467,7 @@ docker system prune -af
 """
 
 [tasks.clean]
-description = "Run all cleanup tasks"
+description = "Free up disk space"
 depends = ["clean:pnpm", "clean:cargo", "clean:rustup", "clean:docker"]
 
 # ============================================================================
@@ -501,7 +490,7 @@ hide = true
 run = "uv lock --upgrade --dry-run"
 
 [tasks.update]
-description = "Check for all updates"
+description = "Show available updates"
 alias = "u"
 depends = ["update:pnpm", "update:cargo", "update:uv"]
 
@@ -533,7 +522,7 @@ hide = true
 run = "uv lock --upgrade"
 
 [tasks.upgrade]
-description = "Apply all updates"
+description = "Apply available updates"
 depends = ["upgrade:pnpm", "upgrade:cargo", "upgrade:uv"]
 
 # ============================================================================
@@ -573,7 +562,7 @@ run = """
 """
 
 [tasks.docker]
-description = "Enter docker dev environment"
+description = "Open Docker dev shell"
 alias = "d"
 usage = """
 arg "[mode]" help="Docker mode" default="proxied" { choices "transparent" "proxied" }
@@ -674,7 +663,7 @@ run = "pnpm --filter node-reqwest --if-present run build"
 sources = ["packages/{core,meta,node}/**/*", "Cargo.{toml,lock}"]
 
 [tasks.build]
-description = "Build all packages"
+description = "Compile all packages"
 alias = "b"
 depends = ["build:core", "build:meta", "build:node"]
 
diff --git a/package.json b/package.json
@@ -3,6 +3,9 @@
   "name": "workspace",
   "type": "module",
   "packageManager": "pnpm@10.28.0+sha512.05df71d1421f21399e053fde567cea34d446fa02c76571441bfc1c7956e98e363088982d940465fd34480d4d90a0668bc12362f8aa88000a64e83d0b0e47be48",
+  "engines": {
+    "node": ">=22.19.1"
+  },
   "devDependencies": {
     "@google/gemini-cli": "catalog:",
     "@playwright/test": "catalog:",
@@ -15,7 +18,10 @@
     "vitest": "catalog:"
   },
   "scripts": {
-    "prepare": "husky"
+    "preinstall": "rustup show",
+    "postinstall": "node ./scripts/setup-playwright.ts",
+    "prepare": "husky",
+    "test": "pnpm --recursive --if-present run test"
   },
   "pnpm": {
     "overrides": {
diff --git a/packages/core/Cargo.toml b/packages/core/Cargo.toml
@@ -1,7 +1,6 @@
 [package]
 name = "core"
 edition.workspace = true
-version.workspace = true
 license.workspace = true
 
 [lints]
diff --git a/packages/meta/Cargo.toml b/packages/meta/Cargo.toml
@@ -1,7 +1,6 @@
 [package]
 name = "meta"
 edition.workspace = true
-version.workspace = true
 license.workspace = true
 
 [lints]
diff --git a/packages/node/Cargo.toml b/packages/node/Cargo.toml
@@ -1,7 +1,6 @@
 [package]
 name = "node_reqwest"
 edition.workspace = true
-version.workspace = true
 license.workspace = true
 
 [lints]
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
@@ -32,4 +32,6 @@ catalog:
   vite-plugin-dts: ^4.5.4
   vitest: ^4.0.17
 
+minimumReleaseAge: 1440
+
 strictDepBuilds: true
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,6 +4,7 @@ version = "0.0.0"
 
 [tool.uv]
 required-version = ">=0.9.21"
+exclude-newer = "1 day"
 
 [tool.uv.workspace]
 members = ["packages/node/tests/mitmproxy"]
diff --git a/scripts/setup-playwright.ts b/scripts/setup-playwright.ts
@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: Apache-2.0 OR MIT
+
+import process from 'node:process';
+import { runCommand } from './helpers/run-command.ts';
+import { runScript } from './helpers/run-script.ts';
+
+runScript('Playwright setup', async () => {
+  if (process.env.MISE_ENV !== 'docker') {
+    await runCommand('playwright', ['install-deps']);
+  }
+});
diff --git a/scripts/test-nextest.ts b/scripts/test-nextest.ts
@@ -11,12 +11,20 @@ import { ensureError, runScript } from './helpers/run-script.ts';
 const packageDir: string = process.cwd();
 const projectRoot: string = join(dirname(fileURLToPath(import.meta.url)), '..');
 
+// Check if running under mise (with cargo-nextest and cargo-llvm-cov available)
+const miseActive: boolean = process.env.MISE_ACTIVE === '1';
+
 // Linux binaries require new GLIBC, and there is no support for Windows ARM64
 const skipCoverage: boolean = ['linux', 'win32'].includes(process.platform);
 
 runScript('Nextest execution', async () => {
   const args = process.argv.slice(2);
 
+  // If mise is not active, fall back to plain cargo test
+  if (!miseActive) {
+    return await runCommand('cargo', ['test', ...args]);
+  }
+
   // Ensure lock file exists
   const lockPath: string = join(projectRoot, 'target', '.test-nextest.lock');
   const fileHandle: FileHandle = await open(lockPath, 'a+');
diff --git a/uv.lock b/uv.lock

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,4 @@`
`1`	`1`	`[build]`
`2`		`-rustc-wrapper = "sccache"`
`3`	`2`	`rustflags = ["-C", "force-frame-pointers=yes"]`
`4`	`3`	`rustdocflags = ["-D", "warnings"]`
`5`	`4`
Original file line number	Diff line number	Diff line change
`@@ -22,6 +22,7 @@ outputs:`
`22`	`22`	`value: \|`
`23`	`23`	`{`
`24`	`24`	`"CI": "true",`
	`25`	`+ "MISE_QUIET": "false",`
`25`	`26`	`"CARGO_INCREMENTAL": "0",`
`26`	`27`	`"CARGO_NET_GIT_FETCH_WITH_CLI": "true",`
`27`	`28`	`"RUST_BACKTRACE": "1"`