stackbite 0.5.74 → 0.5.76

package/README.md

@@ -25,9 +25,21 @@ Work Stack 없이 사용할 수 있으며, Work Stack 연결은 Task 권한과
 Alt+Shift+Z로 집중 화면, F6로 Seats 이동을 사용할 수 있습니다. 기존 키맵과 실행
 기본값은 유지됩니다. [Rust 화면과 실행 소유권 안내](docs/release-0.5.20.md)를 참고하세요.
 
+### Windows·macOS·Linux 공통 설치
+
+Windows PowerShell, macOS의 Zsh·Bash, Linux의 Sh·Bash에서 같은 명령을 사용합니다.
+Node.js·Python·WSL을 따로 설치할 필요가 없습니다.
+
+```sh
+curl https://raw.githubusercontent.com/Shinick-Han/stackbite/main/install.cmd -o "$HOME/.stackbite-install.cmd"; . "$HOME/.stackbite-install.cmd" $?
+```
+
+다음부터는 새 터미널에서 `stackbite`를 실행하면 됩니다. 설치기는 내려받은 배포 파일의
+SHA-256을 확인하고 사용자 계정에 설치합니다. 기존 Room·Seat와 실행 중인 세션은 유지합니다.
+
 ### 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 +62,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 +88,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.76",
   "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.76",
+  "commit": "07f3d98e6666b0ff20767f6725a56dbf06af1b66",
   "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.76-windows-x64-07f3d98e6666.zip",
+      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.76/stackbite-0.5.76-windows-x64-07f3d98e6666.zip",
+      "sha256": "aeb8446cce65c557404c804d2860c1b91cdc17e5d707045d94e9743465c48199",
+      "size": 93672028,
+      "root": "stackbite-0.5.76-windows-x64-07f3d98e6666",
+      "manifestSha256": "79105983111db0402b1e900ae102179f0ba7c9c1a276839b65dba7d382730180",
+      "metadataSha256": "523f468c05ab5ace94ac9158f7039f0ca9f5b62a63ccc08b4d80106262d3e7aa"
     },
     "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.76-linux-x86_64-07f3d98e6666.tar.gz",
+      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.76/stackbite-0.5.76-linux-x86_64-07f3d98e6666.tar.gz",
+      "sha256": "08179e3541dd50ac29c3fb2741f6c68fbb63302f382018102c09836ef31a47ab",
+      "size": 74640280,
+      "root": "stackbite-0.5.76-linux-x86_64-07f3d98e6666",
+      "manifestSha256": "1fdd02a879b89588358ca3f9900b8fb08111e12e99e605fbb4528a57e2e544b0",
+      "metadataSha256": "3d873f87d8850554a7b67bc68a694e1acd086dbf8df348f7ef3ba5e6c792648c"
+    },
+    "darwin-arm64": {
+      "asset": "stackbite-0.5.76-macos-arm64-07f3d98e6666.tar.gz",
+      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.76/stackbite-0.5.76-macos-arm64-07f3d98e6666.tar.gz",
+      "sha256": "15f9e848d596404b10e99ac5f6a1f2d416b1f99625e8ddb2df6356cc6cd80bfd",
+      "size": 35827091,
+      "root": "stackbite-0.5.76-macos-arm64-07f3d98e6666",
+      "manifestSha256": "2fea8481bb3584066c147c7625dbece009256df57af91d7bf3f8276baef49445",
+      "metadataSha256": "d580e41c48ad52a5d12c015b7bf0e82216c795c1b1dfac3a9d9dbb1828848818"
     }
   }
 }