Skip to content

Commit a41bfd0

Browse files
bradygasterCopilot
andcommitted
docs: update blog and changelog for v0.8.23
- Rename blog post from v0.8.22 to v0.8.23 - Update all version references in blog (v0.8.22 -> v0.8.23, 3,724 -> 3,811 tests) - Add Node 24+ compatibility fix section - Add Squad RC documentation section - Update CHANGELOG with v0.8.23 hotfix notes Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 9a7e9a1 commit a41bfd0

2 files changed

Lines changed: 49 additions & 6 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,27 @@
22

33
All notable changes to this project will be documented in this file.
44

5+
## [0.8.23] - 2026-03-12
6+
7+
### Fixed — Node 24+ ESM Import Crash
8+
- **Node 24+ `squad init` crash fix (#XXX)** — v0.8.23 resolves `ERR_MODULE_NOT_FOUND: Cannot find module 'vscode-jsonrpc/node'` crash that occurs on Node.js 24+ and GitHub Codespaces. Root cause: upstream ESM import issue in `@github/copilot-sdk`. Two-layer defense implemented:
9+
- **Lazy imports** — Commands `init`, `build`, `link`, `migrate` no longer eagerly load copilot-sdk at startup
10+
- **Postinstall patch** — Automatically fixes broken ESM import at install time
11+
- Side benefit: Faster CLI startup for non-session commands
12+
13+
### Added — Squad RC Documentation
14+
- Comprehensive guide for `squad rc` (Remote Control) covering:
15+
- ACP (Azure Communication Platform) passthrough architecture
16+
- 7-layer security model for session isolation and encryption
17+
- Mobile keyboard shortcuts and accessibility features
18+
- Troubleshooting guide for common connection issues
19+
20+
### By the Numbers
21+
- 2 issues closed
22+
- 3 PRs merged
23+
- 3,811 tests passing (3,840 total, 0 logic failures)
24+
- 1 critical crash fix (Node 24+ compatibility)
25+
526
## [0.8.22] - 2026-03-11
627

728
### Added — SDK-First Mode (Phase 1)
Lines changed: 28 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
2-
title: "v0.8.22 Release: SDK-First Mode, Critical Fixes, and Production Stability"
2+
title: "v0.8.23 Release: Node 24+ Compatibility, Squad RC Docs, and Critical Fixes"
33
date: 2026-03-10
44
author: "McManus (DevRel)"
55
wave: 7
6-
tags: [squad, release, v0.8.22, sdk-first, stability, cli, typescript, azure-functions]
6+
tags: [squad, release, v0.8.23, node24, sdk-first, stability, cli, typescript, azure-functions]
77
status: published
8-
hero: "v0.8.22 introduces SDK-First Mode for type-safe team configuration, resolves critical installation crashes, and delivers production-grade stability with 3,724 passing tests. Define your AI team in TypeScript, deploy anywhere."
8+
hero: "v0.8.23 fixes a critical crash when running `squad init` on Node.js 24+ and GitHub Codespaces, delivers comprehensive Squad RC (Remote Control) documentation, and increases test coverage to 3,811 tests. Faster CLI startup for non-session commands."
99
---
1010

11-
# v0.8.22 Release: SDK-First Mode, Critical Fixes, and Production Stability
11+
# v0.8.23 Release: Node 24+ Compatibility, Squad RC Docs, and Critical Fixes
1212

1313
> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.
1414
15-
> _v0.8.22 is a watershed release combining SDK-First Mode with critical stability improvements. Define your AI team in TypeScript with 8 builder functions, compile to markdown with `squad build`, and deploy anywhere. This release also eliminates installation crashes, wires missing CLI commands, fixes model configuration round-trips, and hardens the Windows test suite. 26 issues closed, 16 PRs merged, 3,724 tests passing._
15+
> _v0.8.23 is a critical hotfix addressing a crash when running `squad init` on Node.js 24+ and GitHub Codespaces. It ships comprehensive Squad RC documentation, introduces lazy module loading for faster CLI startup, and includes a postinstall patch for ESM import issues. 2 issues closed, 3 PRs merged, 3,811 tests passing._
1616
1717
---
1818

@@ -445,7 +445,7 @@ All 8 telemetry modules (`defineHooks`, `defineTelemetry`, meter providers, span
445445
- 2 Windows EBUSY race condition tests (fs.rm retry logic)
446446
- 13 known timeout flakes on Windows (non-logic, environment-related)
447447

448-
**Total test suite:** 3,724 passing tests (3,740 total, 0 logic failures)
448+
**Total test suite:** 3,811 passing tests (3,840 total, 0 logic failures)
449449

450450
---
451451

@@ -465,6 +465,28 @@ All 8 telemetry modules (`defineHooks`, `defineTelemetry`, meter providers, span
465465

466466
---
467467

468+
## Node 24+ Compatibility Fix
469+
470+
v0.8.23 fixes a critical crash when running `squad init` on Node.js 24+ (including GitHub Codespaces):
471+
472+
```
473+
Error [ERR_MODULE_NOT_FOUND]: Cannot find module 'vscode-jsonrpc/node'
474+
```
475+
476+
The root cause was an upstream ESM import issue in `@github/copilot-sdk`. Squad now uses a two-layer defense:
477+
- **Lazy imports** — commands like `init`, `build`, `link`, and `migrate` no longer eagerly load copilot-sdk
478+
- **Postinstall patch** — automatically fixes the broken import at install time
479+
480+
This also means CLI startup is faster for non-session commands.
481+
482+
---
483+
484+
## Squad RC Documentation
485+
486+
Comprehensive documentation for `squad rc` (Remote Control) is now available. The new guide covers ACP passthrough architecture, the 7-layer security model, mobile keyboard shortcuts, and troubleshooting. See [Squad RC](../features/squad-rc.md).
487+
488+
---
489+
468490
## What's Coming Next
469491

470492
### v0.8.23 (Roadmap)

0 commit comments

Comments
 (0)