Pouya Ghourchiani

Engineering notes

Engineering notes by Pouya Ghourchiani (Mohammad Pouya Ghourchiani · Pooya / Puya) — Rust tooling, NestJS delivery, Workers, and shipping on restricted networks. Short, practical, NDA-safe.

25 notes · canonical: ghourchiani.ir

Start here

Intro

Hello, ghourchiani.ir

Why this site exists — engineering notes on platforms, Rust tooling, and shipping under constrained networks.

Latest

Rust

TypeScript / Nest

Infrastructure

Developer tooling

AEO / SEO

All notes

2026-11-17

Docker API Permission Denied? 5 Fixes That Actually Work

Got permission denied while trying to connect to the Docker daemon API? Fix socket group, rootless, DOCKER_HOST, and context mismatches.

2026-11-07

ASCII Table + Hex to ASCII in Your Terminal (Copy-Paste Commands)

Full printable ASCII table plus xxd one-liners: hex to ASCII, ASCII to hex, char codes, base64, and where UTF-8 starts.

2026-11-07

Your Filename Can Be Weird. Your Tools Shouldn't Make It Weirder.

fd --format quietly rewrote non-UTF-8 filenames in pipes, so xargs got paths that did not exist. My fix (sharkdp/fd PR #2197) is merged upstream.

2026-11-02

Your Docker Host Is Fine. Containers Lie (CVE-2026-98432)

Host looked patched for CVE-2026-98432. 19/20 Docker containers still had MPTCP on — including Docker DNS at 127.0.0.11.

2026-10-31

AI Writes the Code. Who Owns the System?

AI made generating code cheap. Deciding whether it belongs, drawing real boundaries and proving it works is still an engineering job — and someone owns it.

2026-09-18

Why restricted-network tooling

Why Pouya Ghourchiani builds mirrors, installers, and gateways for places where crates.io, npm, and CDN defaults flake.

2026-09-17

Upstream Contribution Diary: Biome, Nitro, Watchexec, ripgrep

Lessons from merged upstream PRs (Biome, Nitro, Watchexec, ripgrep) and from keeping independent projects discoverable — small, evidence-backed changes.

2026-09-16

Mirror-First DX: Tools That Assume Bad Egress

Design CLIs and installers as if registries will flake.

2026-09-15

Axum Gateway Auth Boundaries Without Secrets

Where identity stops and routing begins in a Rust control-plane edge.

2026-09-14

Open VSX vs Marketplace Packaging Checklist

Parity checklist from shipping BidiMD to both registries.

2026-09-12

Zero-Downtime Static Releases on Workers

Gates, atomic deploy, and rollback for a personal SSG site.

2026-09-12

IndexNow and Sitemap Hygiene for a Bilingual SSG

Keep EN/FA URLs discoverable without lying to crawlers.

2026-09-12

NebulaGrid control plane notes

Design notes from Pouya Ghourchiani on NebulaGrid — Rust/Axum gateway plus React control UI for constrained ops networks.

2026-09-11

Atomic Static Swaps on Cloudflare Workers

How this site ships HTML without a half-deployed middle state.

2026-09-10

BidiMD RTL preview notes

Why Mohammad Pouya Ghourchiani built BidiMD — bilingual Markdown preview that does not fight Persian/Arabic direction.

2026-09-10

Shipping Nest and Next Under NDA-Safe Constraints

How to write about production delivery without leaking private systems.

2026-09-10

Publishing to VS Marketplace and Open VSX

Checklist from BidiMD dual publishing. Hands-on notes from shipping software

2026-09-09

DNSTT SlipNet Config Notes in Rust

Generating and decoding configs for constrained connectivity experiments.

2026-09-08

Measuring and Switching APT Mirrors

CLI workflow for faster mirrors on constrained links.

2026-09-08

Person JSON-LD without fake awards

How Pouya Ghourchiani models Person schema honestly — alternateName spellings, sameAs, no invented prizes.

2026-09-07

Real-Time IoT Ingestion with NestJS

Patterns for queues and time-series ingestion without leaking private systems. Short engineering note from production work — practical, NDA-safe, no fluf

2026-09-05

One Rust Codebase, Three Interfaces

Sharing core logic across CLI, REST, and TUI.

2026-09-04

Shipping Rust Installers with cargo-dist

Cross-platform installers for CLI tools without a custom packaging maze.

2026-09-03

Fixing a Biome False Positive for forwardRef

What broke, what the PR fixed, and how to test lint edge cases.

2026-09-01

Running Cargo on a Restricted Network

How Mohammad Pouya Ghourchiani keeps Rust builds moving when crates.io is unreliable — mirrors, vendor discipline, and installers.