---
title: "Engineering notes"
description: "Engineering notes on Rust, NestJS, Cloudflare Workers, and restricted-network shipping — practical and NDA-safe."
author: "Mohammad Pouya Ghourchiani"
canonical: "https://ghourchiani.ir/blog"
image: "https://ghourchiani.ir/og/mark-square.png"
lang: "en"
generated: "2026-11-19"
---
# Engineering notes

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](https://ghourchiani.ir/blog/hello) — Why this site exists — engineering notes on platforms, Rust tooling, and shipping under constrained networks.

## Latest

- **2026-11-17** · [Docker API Permission Denied? 5 Fixes That Actually Work](https://ghourchiani.ir/blog/docker-permission-denied-api-socket) — 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)](https://ghourchiani.ir/blog/ascii-table-hex-to-ascii-terminal) — 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.](https://ghourchiani.ir/blog/fd-weird-filenames-raw-bytes) — 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.

## Rust

- **2026-11-07** · [Your Filename Can Be Weird. Your Tools Shouldn't Make It Weirder.](https://ghourchiani.ir/blog/fd-weird-filenames-raw-bytes) — 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-09-09** · [DNSTT SlipNet Config Notes in Rust](https://ghourchiani.ir/blog/dnstt-slipnet-notes) — Generating and decoding configs for constrained connectivity experiments.

- **2026-09-05** · [One Rust Codebase, Three Interfaces](https://ghourchiani.ir/blog/aurum-three-interfaces) — Sharing core logic across CLI, REST, and TUI.

- **2026-09-01** · [Running Cargo on a Restricted Network](https://ghourchiani.ir/blog/restricted-network-cargo) — How Mohammad Pouya Ghourchiani keeps Rust builds moving when crates.io is unreliable — mirrors, vendor discipline, and installers.

## TypeScript / Nest

- **2026-09-10** · [BidiMD RTL preview notes](https://ghourchiani.ir/blog/bidimd-rtl-preview) — Why Mohammad Pouya Ghourchiani built BidiMD — bilingual Markdown preview that does not fight Persian/Arabic direction.

- **2026-09-07** · [Real-Time IoT Ingestion with NestJS](https://ghourchiani.ir/blog/nestjs-iot-ingestion) — Patterns for queues and time-series ingestion without leaking private systems. Short engineering note from production work — practical, NDA-safe, no fluf

## Infrastructure

- **2026-11-17** · [Docker API Permission Denied? 5 Fixes That Actually Work](https://ghourchiani.ir/blog/docker-permission-denied-api-socket) — Got permission denied while trying to connect to the Docker daemon API? Fix socket group, rootless, DOCKER_HOST, and context mismatches.

- **2026-11-02** · [Your Docker Host Is Fine. Containers Lie (CVE-2026-98432)](https://ghourchiani.ir/blog/cve-2026-98432-docker-container-namespaces) — Host looked patched for CVE-2026-98432. 19/20 Docker containers still had MPTCP on — including Docker DNS at 127.0.0.11.

- **2026-09-18** · [Why restricted-network tooling](https://ghourchiani.ir/blog/why-restricted-network-tooling) — Why Pouya Ghourchiani builds mirrors, installers, and gateways for places where crates.io, npm, and CDN defaults flake.

- **2026-09-12** · [Zero-Downtime Static Releases on Workers](https://ghourchiani.ir/blog/atomic-static-releases) — Gates, atomic deploy, and rollback for a personal SSG site.

- **2026-09-12** · [NebulaGrid control plane notes](https://ghourchiani.ir/blog/nebulagrid-control-plane) — Design notes from Pouya Ghourchiani on NebulaGrid — Rust/Axum gateway plus React control UI for constrained ops networks.

- **2026-09-08** · [Measuring and Switching APT Mirrors](https://ghourchiani.ir/blog/apt-mirror-cli) — CLI workflow for faster mirrors on constrained links.

## Developer tooling

- **2026-11-17** · [Docker API Permission Denied? 5 Fixes That Actually Work](https://ghourchiani.ir/blog/docker-permission-denied-api-socket) — 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)](https://ghourchiani.ir/blog/ascii-table-hex-to-ascii-terminal) — Full printable ASCII table plus xxd one-liners: hex to ASCII, ASCII to hex, char codes, base64, and where UTF-8 starts.

- **2026-10-31** · [AI Writes the Code. Who Owns the System?](https://ghourchiani.ir/blog/ai-writes-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-10** · [Publishing to VS Marketplace and Open VSX](https://ghourchiani.ir/blog/publish-vscode-openvsx) — Checklist from BidiMD dual publishing. Hands-on notes from shipping software

- **2026-09-04** · [Shipping Rust Installers with cargo-dist](https://ghourchiani.ir/blog/cargo-dist-installers) — Cross-platform installers for CLI tools without a custom packaging maze.

- **2026-09-03** · [Fixing a Biome False Positive for forwardRef](https://ghourchiani.ir/blog/biome-forwardref-false-positive) — What broke, what the PR fixed, and how to test lint edge cases.

## AEO / SEO

- **2026-09-08** · [Person JSON-LD without fake awards](https://ghourchiani.ir/blog/person-jsonld-without-fake-awards) — How Pouya Ghourchiani models Person schema honestly — alternateName spellings, sameAs, no invented prizes.

## All notes

- **2026-11-17** · [Docker API Permission Denied? 5 Fixes That Actually Work](https://ghourchiani.ir/blog/docker-permission-denied-api-socket) — 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)](https://ghourchiani.ir/blog/ascii-table-hex-to-ascii-terminal) — 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.](https://ghourchiani.ir/blog/fd-weird-filenames-raw-bytes) — 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)](https://ghourchiani.ir/blog/cve-2026-98432-docker-container-namespaces) — 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?](https://ghourchiani.ir/blog/ai-writes-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](https://ghourchiani.ir/blog/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](https://ghourchiani.ir/blog/upstream-contribution-diary) — 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](https://ghourchiani.ir/blog/mirror-first-dx) — Design CLIs and installers as if registries will flake.

- **2026-09-15** · [Axum Gateway Auth Boundaries Without Secrets](https://ghourchiani.ir/blog/axum-gateway-auth-boundaries) — Where identity stops and routing begins in a Rust control-plane edge.

- **2026-09-14** · [Open VSX vs Marketplace Packaging Checklist](https://ghourchiani.ir/blog/openvsx-marketplace-checklist) — Parity checklist from shipping BidiMD to both registries.

- **2026-09-12** · [Zero-Downtime Static Releases on Workers](https://ghourchiani.ir/blog/atomic-static-releases) — Gates, atomic deploy, and rollback for a personal SSG site.

- **2026-09-12** · [IndexNow and Sitemap Hygiene for a Bilingual SSG](https://ghourchiani.ir/blog/indexnow-bilingual-ssg) — Keep EN/FA URLs discoverable without lying to crawlers.

- **2026-09-12** · [NebulaGrid control plane notes](https://ghourchiani.ir/blog/nebulagrid-control-plane) — 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](https://ghourchiani.ir/blog/workers-atomic-static-swap) — How this site ships HTML without a half-deployed middle state.

- **2026-09-10** · [BidiMD RTL preview notes](https://ghourchiani.ir/blog/bidimd-rtl-preview) — 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](https://ghourchiani.ir/blog/nda-safe-shipping-notes) — How to write about production delivery without leaking private systems.

- **2026-09-10** · [Publishing to VS Marketplace and Open VSX](https://ghourchiani.ir/blog/publish-vscode-openvsx) — Checklist from BidiMD dual publishing. Hands-on notes from shipping software

- **2026-09-09** · [DNSTT SlipNet Config Notes in Rust](https://ghourchiani.ir/blog/dnstt-slipnet-notes) — Generating and decoding configs for constrained connectivity experiments.

- **2026-09-08** · [Measuring and Switching APT Mirrors](https://ghourchiani.ir/blog/apt-mirror-cli) — CLI workflow for faster mirrors on constrained links.

- **2026-09-08** · [Person JSON-LD without fake awards](https://ghourchiani.ir/blog/person-jsonld-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](https://ghourchiani.ir/blog/nestjs-iot-ingestion) — 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](https://ghourchiani.ir/blog/aurum-three-interfaces) — Sharing core logic across CLI, REST, and TUI.

- **2026-09-04** · [Shipping Rust Installers with cargo-dist](https://ghourchiani.ir/blog/cargo-dist-installers) — Cross-platform installers for CLI tools without a custom packaging maze.

- **2026-09-03** · [Fixing a Biome False Positive for forwardRef](https://ghourchiani.ir/blog/biome-forwardref-false-positive) — What broke, what the PR fixed, and how to test lint edge cases.

- **2026-09-01** · [Running Cargo on a Restricted Network](https://ghourchiani.ir/blog/restricted-network-cargo) — How Mohammad Pouya Ghourchiani keeps Rust builds moving when crates.io is unreliable — mirrors, vendor discipline, and installers.

## Occasional notes by email

New posts on Rust, tooling and infrastructure. No schedule, no noise.

  Email address
The spam check needs JavaScript. Or email "subscribe" to [pouya@pouyagh.ir](mailto:pouya@pouyagh.ir?subject=subscribe)

Unsubscribe with one click.
