stackbite 0.5.74 → 0.5.75

package/README.md

@@ -27,7 +27,7 @@ Alt+Shift+Z로 집중 화면, F6로 Seats 이동을 사용할 수 있습니다.
 
 ### npm / npx 설치
 
-Node.js 20 이상과 `tar`가 있는 Windows x64 또는 glibc Linux x64에서 실행합니다.
+Node.js 20 이상과 `tar`가 있는 Windows x64, glibc Linux x64, Apple Silicon macOS에서 실행합니다.
 Python 설치는 필요하지 않으며 첫 실행은 검증된 런타임을 내려받고 다음부터 캐시를 사용합니다.
 아래 두 방식 중 하나를 선택하면 됩니다. 전역 설치는 작은 런처를 설치하고,
 이어 `stackbite`를 처음 실행할 때 네이티브 런타임을 내려받습니다.
@@ -50,17 +50,19 @@ stackbite
 npx --yes https://github.com/Shinick-Han/stackbite/releases/download/v0.5.18/stackbite-0.5.18.tgz
 ```
 
-macOS·ARM·Alpine은 현재 지원 대상이 아닙니다.
+Mac은 Apple Silicon(M1 이후), macOS 13 이상이 대상입니다. 실제 실행 검증은 M4의
+macOS 26.2에서 진행했습니다. Intel Mac, Linux ARM, Alpine은 현재 지원 대상이 아닙니다.
 [런처 설치·업데이트 안내](packaging/npm/README.md)를 참고하세요.
 
 ### 네이티브 실행 파일
 
 Windows x64 ZIP의 **전체 압축을 해제한 뒤 `stackbite.exe`를 실행**합니다.
-Linux x86_64 tar.gz는 전체를 해제하고 `./stackbite`를 실행합니다. 두 플랫폼 모두
+Linux x86_64 또는 macOS arm64 tar.gz는 전체를 해제하고 `./stackbite`를 실행합니다.
+각 플랫폼 모두
 `runtime/`을 실행 파일 옆에 유지하면 Python이나 소스 checkout 없이 동작합니다.
 Linux의 최소 glibc 요구 사항은 `portable.json`의 `minimum_glibc`에 기록됩니다.
 
-선택적으로 Windows의 `install.cmd` 또는 Linux의 `./install.sh`로 사용자 계정에 설치합니다.
+선택적으로 Windows의 `install.cmd` 또는 Linux·macOS의 `./install.sh`로 사용자 계정에 설치합니다.
 Codex·Claude 등 provider CLI의 설치와 로그인은 별도입니다.
 설치·롤백은 [Windows](packaging/README.md) / [Linux](packaging/linux/README.md) 안내를 따릅니다.
 
@@ -74,7 +76,8 @@ stackbite update --check
 ```
 
 `--help`는 TUI나 백엔드를 시작하지 않습니다. `--version`은 실제 버전·커밋을,
-`--status`는 실행·상태 경로를 확인하는 데 사용합니다. `stackbite update`는 배포 파일과
+`--status`는 실행·상태 경로를 확인하는 데 사용합니다. Mac에서는
+`npm install --global stackbite@latest`로 업데이트합니다. Windows·Linux의 `stackbite update`는 배포 파일과
 체크섬을 검증하여 설치하며, 실행 중인 백엔드와 CLI를 종료하지 않습니다. 소스 checkout은
 Git으로 업데이트합니다. 이미 실행 중인 백엔드는 기존 코드를 사용하므로 새 기능은 그
 백엔드를 명시적으로 재시작한 뒤 적용됩니다. 백엔드 재시작은 실행 중인 CLI를 종료합니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stackbite",
-  "version": "0.5.74",
+  "version": "0.5.75",
   "description": "Verified native Stackbite CLI bootstrapper",
   "license": "UNLICENSED",
   "engines": {

package/packaging/npm/lib/archive.js

@@ -278,7 +278,7 @@ async function extractArchive(archive, destination, spec, { spawnImpl = spawn }
   const entries = windows ? await zipEntries(input) : await tarEntries(input);
   validateEntries(entries, spec.root, windows);
   await new Promise((resolve, reject) => {
-    const child = spawnImpl(nativeTar(), ['-xf', input, '-C', destination, '--no-same-owner', '--no-same-permissions'],
+    const child = spawnImpl(nativeTar(), ['-xf', input, '-C', destination, '--no-same-owner', ...(spec.platform === 'darwin' ? ['-p'] : ['--no-same-permissions'])],
       { shell: false, stdio: ['ignore', 'ignore', 'pipe'], windowsHide: true });
     let errorBytes = 0;
     const timer = setTimeout(() => { child.kill(); reject(new Error('Native tar extraction timed out')); }, LIMITS.timeout);

package/packaging/npm/lib/bootstrap.js

@@ -34,11 +34,11 @@ function checkPinnedAsset(spec, manifest, root, asset) {
 }
 function releaseSpec(manifest, platform = process.platform, arch = process.arch, runtime = {}) {
   const key = `${platform}-${arch}`;
-  if (!['win32-x64', 'linux-x64'].includes(key)) fail(`Stackbite does not have a native release for ${key}; supported platforms are Windows x64 and Linux x64.`);
+  if (!['win32-x64', 'linux-x64', 'darwin-arm64'].includes(key)) fail(`Stackbite does not have a native release for ${key}; supported platforms are Windows x64, Linux x64 and macOS arm64.`);
   checkLinuxRuntime(platform, runtime);
   checkReleaseIdentity(manifest);
   const spec = manifest.platforms?.[key];
-  const host = platform === 'win32' ? 'windows-x64' : 'linux-x86_64';
+  const host = { win32: 'windows-x64', linux: 'linux-x86_64', darwin: 'macos-arm64' }[platform];
   const root = `stackbite-${manifest.version}-${host}-${manifest.commit.slice(0, 12)}`;
   const asset = root + (platform === 'win32' ? '.zip' : '.tar.gz');
   checkPinnedAsset(spec, manifest, root, asset);
@@ -122,10 +122,10 @@ async function payloadFiles(root, expected, hashes) {
 // The checksum documents themselves are the only unhashed members; Linux also ships the text form.
 async function checkMemberSet(root, spec, hashes, expected, actual) {
   expected.add('SHA256SUMS.json');
-  if (spec.platform === 'linux') {
+  if (spec.platform !== 'win32') {
     expected.add('SHA256SUMS');
     const text = await readSmall(path.join(root, 'SHA256SUMS'));
-    if (text.toString('utf8') !== Object.entries(hashes).map(([name, digest]) => `${digest}  ${name}\n`).join('')) fail('Linux checksum text disagrees with pinned manifest');
+    if (text.toString('utf8') !== Object.entries(hashes).map(([name, digest]) => `${digest}  ${name}\n`).join('')) fail(`${spec.platform === 'linux' ? 'Linux' : 'macOS'} checksum text disagrees with pinned manifest`);
   }
   if (actual.size !== expected.size || [...actual].some(name => !expected.has(name))) fail('Release files disagree with pinned manifest');
 }
@@ -134,7 +134,7 @@ async function checkProductIdentity(root, spec, metadata) {
   for (const value of [metadata, build]) {
     if (value.version !== spec.version || value.commit !== spec.commit || value.product !== 'Stackbite'
         || (value.command !== undefined && value.command !== 'stackbite')
-        || (value.platform !== undefined && value.platform !== spec.host)) fail('Release product/version/commit identity mismatch');
+        || ((spec.platform === 'darwin' || value.platform !== undefined) && value.platform !== spec.host)) fail('Release product/version/commit identity mismatch');
   }
 }
 async function nativeExecutable(root, spec) {
@@ -143,11 +143,14 @@ async function nativeExecutable(root, spec) {
   if (!image.isFile() || image.isSymbolicLink()) fail('Native release executable is missing or a link');
   const file = await fs.open(executable, 'r');
   try {
-    const magic = Buffer.alloc(4);
-    if ((await file.read(magic, 0, 4, 0)).bytesRead !== 4
-        || !(spec.platform === 'win32' ? magic.subarray(0, 2).equals(Buffer.from('MZ')) : magic.equals(Buffer.from([0x7f, 69, 76, 70])))) fail('Invalid native executable identity');
+    const header = Buffer.alloc(spec.platform === 'darwin' ? 16 : 4);
+    if ((await file.read(header, 0, header.length, 0)).bytesRead !== header.length) fail('Invalid native executable identity');
+    const valid = spec.platform === 'win32' ? header.subarray(0, 2).equals(Buffer.from('MZ'))
+      : spec.platform === 'darwin' ? header.readUInt32LE(0) === 0xfeedfacf && header.readUInt32LE(4) === 0x0100000c && header.readUInt32LE(12) === 2
+      : header.equals(Buffer.from([0x7f, 69, 76, 70]));
+    if (!valid) fail('Invalid native executable identity');
   } finally { await file.close(); }
-  if (spec.platform === 'linux' && process.platform !== 'win32' && !(image.mode & 0o111)) fail('Native release executable has no execute permission');
+  if (spec.platform !== 'win32' && process.platform !== 'win32' && !(image.mode & 0o111)) fail('Native release executable has no execute permission');
   return executable;
 }
 async function validatePayload(directory, spec) {

package/packaging/npm/release.json

@@ -1,26 +1,35 @@
 {
   "schema": 1,
-  "version": "0.5.74",
-  "commit": "b040e5b6995424b64c8caa7e872bfe7e7ce3ce3d",
+  "version": "0.5.75",
+  "commit": "5866c4fa78e925cbac4d1c1dbedfa241099db7fb",
   "repository": "Shinick-Han/stackbite",
   "platforms": {
     "win32-x64": {
-      "asset": "stackbite-0.5.74-windows-x64-b040e5b69954.zip",
-      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.74/stackbite-0.5.74-windows-x64-b040e5b69954.zip",
-      "sha256": "139f251c79c7eac6cd785ab4cd2a481a04772796bcb1332ed5628cffac8a8208",
-      "size": 91847386,
-      "root": "stackbite-0.5.74-windows-x64-b040e5b69954",
-      "manifestSha256": "c3632a602991ffc0ad01835c48dcc26238237f379f0e210318d48138daaaa3bf",
-      "metadataSha256": "d5542b60747d491ab02e09535ea260ed25009324ef5f27a3ae54058ee03248ae"
+      "asset": "stackbite-0.5.75-windows-x64-5866c4fa78e9.zip",
+      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.75/stackbite-0.5.75-windows-x64-5866c4fa78e9.zip",
+      "sha256": "b39d53fb18652c95a00587345afdf1f813a15c57adbe2e17a0dbfe6b5b1af482",
+      "size": 91855900,
+      "root": "stackbite-0.5.75-windows-x64-5866c4fa78e9",
+      "manifestSha256": "9d8e2fab09da2cd2f53ab3edfb1064261efa99f95ec9f3d2db4d6495d72c87c9",
+      "metadataSha256": "2daacf032afdbbd20d354b82fd62150ee804de56c3bb22abfd86c7ec92379965"
     },
     "linux-x64": {
-      "asset": "stackbite-0.5.74-linux-x86_64-b040e5b69954.tar.gz",
-      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.74/stackbite-0.5.74-linux-x86_64-b040e5b69954.tar.gz",
-      "sha256": "b7aacc4876cc99e5b90688c5eddf5fa62a3e9b9ce295b164ca1f7d1fc22c2b75",
-      "size": 74530785,
-      "root": "stackbite-0.5.74-linux-x86_64-b040e5b69954",
-      "manifestSha256": "b33a6471c121c1678a433105420df152fbb98c5d55cc1661cf493ef1e1ab29f9",
-      "metadataSha256": "f5c3185a4e0056230c26c0b1887905b21825dd6557319e5d154d735ed831839b"
+      "asset": "stackbite-0.5.75-linux-x86_64-5866c4fa78e9.tar.gz",
+      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.75/stackbite-0.5.75-linux-x86_64-5866c4fa78e9.tar.gz",
+      "sha256": "f0df67b7fad65e4835cdcf4ad3b485596d9dbf9aebaec63aeb2d21a5541012f7",
+      "size": 74535069,
+      "root": "stackbite-0.5.75-linux-x86_64-5866c4fa78e9",
+      "manifestSha256": "22d18f55d18f26bb2cad3f5d8317b211a91411a8e73fec6ffd95311a51c081c6",
+      "metadataSha256": "09e5bbec59c1f2d1855bee456d2d45bc143435e7d75c67a4ff44d2a8ff476ca3"
+    },
+    "darwin-arm64": {
+      "asset": "stackbite-0.5.75-macos-arm64-5866c4fa78e9.tar.gz",
+      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.75/stackbite-0.5.75-macos-arm64-5866c4fa78e9.tar.gz",
+      "sha256": "cbdfe30e185c70fa5d1bcab65ca73c4cdf8e37df926a84c71e63899c1a8e2ff0",
+      "size": 35751576,
+      "root": "stackbite-0.5.75-macos-arm64-5866c4fa78e9",
+      "manifestSha256": "945f85ba7dccf361abe56aad5e3044e81081bd75f808b0c96c10ace571defbf5",
+      "metadataSha256": "6bf11a33f7b70fe4442af231e6ffa18b9e83c9e0d0e0c2341cb23b2a4539c191"
     }
   }
 }