Hoi hoi! 😸
Last week, we successfully abducted 28 cats! 🛸🐈
But there was one tiny problem
WHERE ARE WE SUPPOSED TO KEEP ALL THESE CATS?! 🙀💥
And guess what?
WE HAVE EVEN MORE CATS NOW!!! 🙀🎉
Our little UFO is getting crowded!!
So, I've made a decision.
WE'RE BUILDING A NEW HOUSE!!! 🏠🔨🎉
A place where all our cats can gather, create, share ideas, and build something together!
IT'S STILL UNDER CONSTRUCTION!!! 🚧🐈
Our cats are working hard behind the scenes.
- What will it look like?
- What's going to be inside?
Hehehe... That's a secret for now! 😼
STAY TUNED!!! 🛸💚
🐈 Welcome, New Cats!!
Last week, we had 28 cats.
And now?
34 CATS!!! 🙀🎉
YAY!!! 💚
To everyone who joined our little organization this week WELCOME ABOARD!!! 🛸🐈
Make yourself comfortable!
Our new house isn't ready yet, but there's always room for another cat in our UFO! 😹💚
🏆 New Contributors, Good Cats 😺😺😺
Our GitHub projects have been busy this week!
New documentation, stronger tests, safer tooling, new features, and even some new releases!
Let's celebrate the cats behind all this work! 💚
🧩 is-kit
necoz-oss / is-kit
Build small guards. Compose them. A lightweight, zero-dependency toolkit for building reusable TypeScript type guards that compose, refine, and preserve natural narrowing. Runtime-safe 🛡️, composable 🧩, and ergonomic ✨.
is-kit
Build small guards. Compose them.
is-kit is a lightweight, zero-dependency toolkit for building reusable TypeScript type guards.
is-kit is not just a collection of isX helpers. Its main focus is composing small runtime checks into reusable guards while preserving useful TypeScript narrowing.
It helps you write small isFoo functions, compose them into richer runtime checks, refine properties on values you already know about, and keep TypeScript narrowing natural inside regular control flow. Use it at runtime boundaries when needed, without requiring a schema-first workflow.
Runtime-safe 🛡️, composable 🧩, and ergonomic ✨ without asking you to adopt a heavy schema workflow.
- Build and reuse typed guards
- Compose guards with
and,or,not,oneOf - Use
refineKeyto narrow a child property while preserving its parent type - Validate object shapes and collections when that is useful
- Parse or assert
unknownvalues without a large schema framework
Best…
First up, is-kit v1.16.6 is here! 🎉
This week brought improvements to API documentation, runtime regression tests, and contributor experience.
Special thanks to:
- ArnabOPP — Clarified discriminated-union narrowing behavior in
oneOf. (#461) - Lil-Clanky — Improved
tupleOfdocumentation and strengthenedequalsKeyedge-case tests. (#460, #458) - deba2k5 — Documented
oneOfValuesequality, input forms, and snapshot behavior. (#459) - atokim4 — Clarified the differences between
optional,optionalKey, and their combinations. (#457) - daocuong11 — Updated build documentation, improved
notregression tests, and strengthened the contributor checklist. (#456, #455, #447) - wathsalaggg — Added tests proving that
hasKeyandhasKeysdo not read property values. (#454) - chirag-gupta7 — Strengthened
guardInforwarding tests andequalsreference-identity coverage. (#449, #445) - agenticsymphony-tech — Clarified
safeJsonParseerror boundaries. (#446)
That's a lot of improvements!
And many of them focus on something we care deeply about:
Making small APIs easier to understand, safer to use, and better documented. 🧩
Thank you, everyone! GOOD CATS!!! 😻💚
🤖 changelog-bot
necoz-oss / changelog-bot
Automatic create changelog with AI. 🤖 It provides CLI and github actions. 🚀 https://www.npmjs.com/package/@nyaomaru/changelog-bot
Releases should feel exciting, not tedious.
@nyaomaru/changelog-bot 🤖 turns your Git history and release notes into a polished changelog entry (and optional PR) in a single run. Drop it into CI, run it locally, or hand it to your release captain—either way, you ship with a crisp changelog and zero copy-paste fatigue.
The GitHub repository is necoz-oss/changelog-bot. The npm package name is still @nyaomaru/changelog-bot. In workflows, use necoz-oss/changelog-bot. GitHub Actions does not follow repository redirects for actions or reusable workflows, so keep uses: on the new owner. Web and git URLs for nyaomaru/changelog-bot still redirect.
Why changelog-bot?
- Automated storytelling: Combines commit history, PR titles, and release notes to produce human-ready changelog sections.
- LLM superpowers (optional): Connect OpenAI or Anthropic for tone-aware summaries or skip API keys entirely and rely on a robust heuristic fallback.
- PR-ready output: Can open a pull request with updated changelog, compare links, and…
changelog-bot v0.12.0 has arrived! 🚀
Our journey toward v1.0 continues!
Some exciting improvements landed this week, including audience-aware changelogs and a new check mode.
A huge thank you to:
- MaxonT — Added a
release-notesoutput to the composite GitHub Action. (#378) - noahkhomer18 — Added changelog drift checking and fixed release-note handling, including PR refactor commits and text before the first heading. (#369, #377, #376)
- sorathiya903 — Introduced audience-specific changelog generation. (#367)
- johnnylemonny — Improved classification of breaking-change footers and revert commits. (#366)
- xryanlee — Strengthened concurrency tests, improved cross-platform test compatibility, and fixed Markdown category normalization. (#360, #359, #358)
- dbdefault — Simplified shared runtime guards, improved title lookup coverage, and protected fenced code blocks from unwanted PR linking. (#352, #351, #349, #345)
What's especially exciting?
We're moving beyond simply generating changelogs.
We're improving how changelogs communicate useful information to different readers, how they preserve release-note content, and how projects can check for unexpected changes.
Step by step, our little bot is growing up! 🤖💚
🦀 type-tune
type-tune
Give shared TypeScript types a better home. 😸
Scan. Review. Move. Validate.
type-tune is a Rust-powered CLI that finds shared TypeScript type aliases and interface declarations and helps move them without manually chasing imports.
It creates a reviewable plan, updates supported type imports and re-exports, and validates the rewrite with TypeScript. You decide what moves and where.
Guides for installation, the first scan, and the review workflow live in the official documentation. Releases are listed on GitHub Releases, and the package is type-tune on npm.
Why type-tune?
Types often start next to a component or utility, then end up shared across a project. Moving them later means tracking imports, local dependencies, and barrels by hand.
- Discover shared types with deterministic candidate IDs.
- Review
plan.mdand choose the destination before making changes. - Rewrite supported type-only imports, aliases, and simple barrels while keeping compatibility re-exports at the original…
type-tune v1.1.0 is here!!! 🦀🎉
Our Rust-powered TypeScript refactoring tool just got another update!
This release focuses on making type moves safer and improving compatibility with real-world projects, including Vue and Nuxt!
Some highlights from this week's work:
- #31 — Keep ignored Vue candidates out of approved rewrites
- #33 — Prevent TypeScript build-info artifacts from leaking
- #35 — Safely reject incomplete project-reference analysis
- #37 — Strengthen project boundaries against symlink escapes
We're also continuing to improve cross-platform compatibility and tackle tricky TypeScript resolution edge cases.
Still plenty of adventures ahead!
Scan. Review. Move. Validate. 🦀💚
🛡️ safe-paste
necoz-oss / safe-paste
A lightweight, local-first browser extension for sensitive information before sharing. 😺🔎
SafePaste
A small, local-first browser extension to help developers notice potential sensitive information pasted into GitHub issues and comments. 😺🔎
SafePaste has a development scaffold; product features are not implemented yet. The planned Chrome MVP detects potential GitHub personal access tokens in pasted text, shows non-blocking warnings, and lets users explicitly redact them. Detection is best-effort; always review your text before posting.
Read the MVP scope and draft architecture and join the review in Issue #1 before implementation begins.
A Necoz community project: Small. Simple. Useful.
Development
Use Node.js 22.12 or newer (Node 22 is used in CI; .nvmrc selects that line) and npm.
npm ci npm run check npm ci installs the committed lockfile. Keep package-lock.json in version control when changing development dependencies. There are no runtime dependencies; TypeScript checks types, Vite bundles the content script, and Vitest runs tests.
| Command | Purpose |
|---|---|
npm run typecheck | Strict checks, including a |
Remember the little project that started from a community discussion?
safe-paste! 🎉
It's a browser extension designed to help developers avoid accidentally pasting sensitive information into GitHub issue editors.
And this week, it made some real progress!
- johnnylemonny — Designed the pure TypeScript detection and redaction API, implemented initial GitHub PAT detection rules, and prototyped the GitHub paste adapter. (#9, #17, #12)
We also established the MVP architecture, development environment, and UTF-16 input-budget design.
Our goal remains simple 👇
Warn developers before accidentally exposing secrets, without interrupting their workflow.
No unnecessary network requests.
No permanent storage of pasted content.
Just a small, useful tool!
It's still under development, and there's more safety work ahead.
But seeing a community idea turn into real code?
THAT'S AWESOME!!! 😻💚
👑 Cat of the Necoz
And this week's Cat of the Necoz is
🥁 Drumroll, please...
🐈 @star123
Star has been sharing wonderful programming adventures through the Necoz Planet series, turning Python lessons into fun little stories about cats, UFOs, and our mysterious planet! 🛸🐈
But that's not all!
This week, Star also took an exciting first step into open source by creating her first issue in Forem, the open-source project behind DEV! 🎉
THAT'S AWESOME!!! 😻💚
Thank you for bringing so much creativity, curiosity, and energy to our little community, Star!
Keep learning, keep creating, and keep inspiring other cats!
YOU ARE OFFICIALLY A STAR CAT!!! 🐈⭐🎉
Who will be our next Cat of the Necoz? 👀
🎮 Necoz Quests
Looking for your next adventure? 🐈
We've got plenty of fresh quests for curious cats!
Here are just a few of them. There are many more waiting for you! 🐾
🧩 is-kit
🐾 New Quests — Documentation & Testing
- #475 — Document narrowKeyTo short-circuit behavior
- #474 — Clarify hasKey and hasKeys presence-only checks
- #473 — Document define boolean coercion
- #472 — Clarify safeParse guard-error behavior
- #471 — Clarify assert failure and error behavior
🚧 Major Quest — API Refinement
We're continuing to make is-kit simpler, safer, and easier to use!
🤖 changelog-bot
🐾 New Quests — Test Coverage
- #387 — Verify linked issue extraction order
- #386 — Test release-note whitespace preservation
- #385 — Test case-insensitive sub-change matching
- #384 — Document Unicode title normalization
- #383 — Distinguish permission errors from rate limits
🚧 Major Quest — Road to v1.0
We're improving reliability, classification, and WHY extraction as we work toward v1.0! 🚀
🦀 type-tune
Rust, TypeScript, Vue, and safer refactoring!
New adventures include Linux ARM64 support, circular dependency detection, and Vue/Nuxt compatibility.
🛡️ safe-paste
Our little browser extension for preventing accidental secret leaks!
We're working on safer detection, privacy guarantees, and a non-blocking warning UI.
🐈 Before Starting Your Quest
Found something interesting?
Please check if another cat has already claimed the issue, and leave a comment before starting! 🙏
First contribution? No problem!
Every little contribution matters! 💚
Happy questing, cats! 🐾
📰 Necoz Articles
Our cats have been busy writing again! 😸
And I love seeing how different everyone's interests are!
Rust, C++, Python, web scraping, open source, and even strange earthquakes on the Necoz planet?! 🙀
SO MANY ARTICLES!!! 🎉
Let's check out what our cats have been up to this week! 🐾
🐈 nourdude — Necoz Now Has Another New Home!
WAIT... WHAT?!
ANOTHER NEW HOME?! 🙀🏠🛸
While we're busy building our new house, nourdude has already created another little home for Necoz on Our World of Text (OWOT)! 🎉
THAT'S AWESOME!!! 😻💚
And congratulations, nourdude!
nourdude has officially been appointed as our MONITORING CAT!!! 🐈🔭🎉
🐈 Sᴛᴀʀ⭐ — The Function Factory of Necoz!
A factory full of cat robots?!
WHAT COULD POSSIBLY GO WRONG?! 🙀⚙️
Star continues her wonderful Necoz Planet programming adventures, this time teaching Python functions through a fun story about robots, reusable code, and a little bit of chaos!
🐈 Dev Stack Hub — Geo-Targeted Web Scraping with Proxies
Ever wondered why the same website shows different prices, languages, or products depending on where you are?
Dev Stack Hub shared a detailed guide to geo-targeted web scraping, covering country- and city-level proxies, location signals, and practical examples using Python and Playwright!
A fascinating technical deep dive! 😸🌍
🐈 Sᴛᴀʀ⭐ — Say Hello in Your Language!
HELLO! KONNICHIWA! HOLA! BONJOUR! 👋🌍
Star invited developers from around the world to share a simple greeting in their own languages!
Such a lovely way to bring our international community together! 💚
By the way...
KONNICHIWA FROM JAPAN!!! 🇯🇵🐈




