chore: bump v0.4.2 — Linux build, download page update, block registry fix

Dchuong03 · claude · Dchuong03 · commit bb01a10053f2 · 2026-02-03T02:31:51.000+07:00
- Add x86_64 Linux (ubuntu-22.04) to release build matrix
- Update download page: Linux .deb/.AppImage downloads, macOS Gatekeeper instructions
- Fix block view registration tree-shaking in production builds
- Update SEO metadata and CTA to reflect Linux support

Co-Authored-By: Claude Opus 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -14,6 +14,8 @@ jobs:
             runner: macos-latest
           - target: x86_64-apple-darwin
             runner: macos-15-intel
+          - target: x86_64-unknown-linux-gnu
+            runner: ubuntu-22.04
 
     name: Build (${{ matrix.target }})
     runs-on: ${{ matrix.runner }}
@@ -32,6 +34,12 @@ jobs:
 
       - run: pnpm install --frozen-lockfile
 
+      - name: Install Linux dependencies
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf
+
       - name: Install Rust stable
         uses: dtolnay/rust-toolchain@stable
         with:
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.4.2] - 2026-02-03
+
+### Added
+- **Linux Build:** Release pipeline now builds `.deb` and `.AppImage` for x86_64 Linux
+- **Download Page:** Linux download with `.deb` (primary) and `.AppImage` (alt) options
+- **macOS Instructions:** Gatekeeper bypass guide for first-time app launch on macOS
+
+### Fixed
+- Block view registration tree-shaking issue in production builds (BlockRegistry refactor)
+
+### Changed
+- Updated download page SEO metadata to include Linux
+- Updated FinalCTA to reflect Linux platform support
+
 ## [0.4.0] - 2026-02-02
 
 ### Added
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "sidstack",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "private": true,
   "type": "module",
   "description": "SidStack - Lightweight AI Agent Orchestration Platform",
diff --git a/packages/api-server/package.json b/packages/api-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@sidstack/api-server",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "REST API server for SidStack Web UI",
   "license": "MIT",
   "publishConfig": {
diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@sidstack/cli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "SidStack CLI - Project Intelligence for AI Coding Agents",
   "author": "SidStack Team",
   "license": "MIT",
diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@sidstack/mcp-server",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "MCP Server for SidStack - task management, knowledge, and impact analysis for Claude Code",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
diff --git a/packages/shared/package.json b/packages/shared/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@sidstack/shared",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Shared types and utilities for SidStack",
   "license": "MIT",
   "publishConfig": {
diff --git a/packages/vscode-extension/package.json b/packages/vscode-extension/package.json
@@ -2,7 +2,7 @@
   "name": "sidstack",
   "displayName": "SidStack",
   "description": "AI-Powered Project Intelligence - Tasks, Knowledge, Impact Analysis & Governance for Claude Code",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "publisher": "sidstack",
   "license": "MIT",
   "icon": "media/sidstack-icon.png",
diff --git a/src-tauri/Cargo.toml b/src-tauri/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "sidstack"
-version = "0.4.0"
+version = "0.4.2"
 description = "SidStack - AI-Powered Project Intelligence Platform"
 authors = ["SidStack Team"]
 edition = "2021"
diff --git a/src-tauri/tauri.conf.json b/src-tauri/tauri.conf.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "SidStack",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "identifier": "com.sidstack.agent-manager",
   "build": {
     "beforeDevCommand": "pnpm dev",
diff --git a/src/components/blocks/BlockRegistry.ts b/src/components/blocks/BlockRegistry.ts
@@ -2,22 +2,33 @@ import type { ComponentType } from "react";
 
 import type { BlockViewProps, BlockViewType } from "@/types/block";
 
+type ViewMap = Partial<Record<BlockViewType, ComponentType<BlockViewProps>>>;
+
 /**
  * Registry of block view components.
- * Maps view type to the component that renders it.
  *
- * Inspired by WaveTerm's BlockRegistry pattern.
+ * Uses a plain object + getter function instead of Map to avoid
+ * Rollup tree-shaking the .set() calls in production builds.
+ *
+ * Views are registered via setBlockViews() called from views/index.ts.
  */
-export const BlockRegistry = new Map<BlockViewType, ComponentType<BlockViewProps>>();
+let views: ViewMap = {};
 
 /**
- * Register a block view component
+ * Set all block views at once (called during app init)
+ */
+export function setBlockViews(map: ViewMap): void {
+  views = map;
+}
+
+/**
+ * Register a single block view component
  */
 export function registerBlockView(
   viewType: BlockViewType,
   component: ComponentType<BlockViewProps>
 ): void {
-  BlockRegistry.set(viewType, component);
+  views[viewType] = component;
 }
 
 /**
@@ -26,15 +37,12 @@ export function registerBlockView(
 export function getBlockView(
   viewType: BlockViewType
 ): ComponentType<BlockViewProps> | undefined {
-  return BlockRegistry.get(viewType);
+  return views[viewType];
 }
 
 /**
  * Check if a view type is registered
  */
 export function isViewTypeRegistered(viewType: BlockViewType): boolean {
-  return BlockRegistry.has(viewType);
+  return viewType in views;
 }
-
-// Note: Actual component registrations happen in the view files
-// This avoids circular dependencies
diff --git a/src/components/blocks/WorkspaceBlock.tsx b/src/components/blocks/WorkspaceBlock.tsx
@@ -12,9 +12,9 @@ import { memo, useCallback, Suspense } from "react";
 import { useWorkspaceContext } from "@/contexts/WorkspaceContext";
 
 import { getBlockView } from "./BlockRegistry";
+import { ensureBlockViewsRegistered } from "./views";
 
-// Import views to trigger block registration
-import "./views";
+ensureBlockViewsRegistered();
 
 interface WorkspaceBlockProps {
   blockId: string;
diff --git a/src/components/blocks/index.ts b/src/components/blocks/index.ts
@@ -34,8 +34,9 @@ export type { CodeBlockProps } from "./CodeBlock";
 // New WaveTerm-style block system
 export { Block } from "./Block";
 export { BlockFrame } from "./BlockFrame";
-export { BlockRegistry, registerBlockView, getBlockView } from "./BlockRegistry";
+export { registerBlockView, getBlockView } from "./BlockRegistry";
 export { TileLayout } from "./layout";
 
-// Import views to trigger registration
-import "./views";
+// Explicit function call — not tree-shakeable
+import { ensureBlockViewsRegistered } from "./views";
+ensureBlockViewsRegistered();
diff --git a/src/components/blocks/views/index.ts b/src/components/blocks/views/index.ts
@@ -1,21 +1,26 @@
-// Block view exports
-// Each view registers itself in BlockRegistry on import
+// Block view registration
+// Uses setBlockViews() to pass component references directly,
+// preventing Rollup from tree-shaking the registrations.
 
-export { KnowledgeBrowserBlockView } from "./KnowledgeBrowserBlockView";
-export { TaskManagerBlockView } from "./TaskManagerBlockView";
-export { WorktreeStatusBlockView } from "./WorktreeStatusBlockView";
-export { WorktreeOverviewBlockView } from "./WorktreeOverviewBlockView";
-export { TicketQueueBlockView } from "./TicketQueueBlockView";
-export { SettingsBlockView } from "./SettingsBlockView";
-export { TrainingRoomBlockView } from "./TrainingRoomBlockView";
-export { default as ProjectHubBlockView } from "./ProjectHubBlockView";
+import { setBlockViews } from "../BlockRegistry";
+import { KnowledgeBrowserBlockView } from "./KnowledgeBrowserBlockView";
+import { TaskManagerBlockView } from "./TaskManagerBlockView";
+import { WorktreeStatusBlockView } from "./WorktreeStatusBlockView";
+import { WorktreeOverviewBlockView } from "./WorktreeOverviewBlockView";
+import { TicketQueueBlockView } from "./TicketQueueBlockView";
+import { SettingsBlockView } from "./SettingsBlockView";
+import { TrainingRoomBlockView } from "./TrainingRoomBlockView";
+import ProjectHubBlockView from "./ProjectHubBlockView";
 
-// Import all views to trigger registration
-import "./KnowledgeBrowserBlockView"; // Unified knowledge browser via REST API
-import "./TaskManagerBlockView";
-import "./WorktreeStatusBlockView";
-import "./WorktreeOverviewBlockView";
-import "./TicketQueueBlockView";
-import "./SettingsBlockView";
-import "./TrainingRoomBlockView";
-import "./ProjectHubBlockView";
+export function ensureBlockViewsRegistered(): void {
+  setBlockViews({
+    "knowledge-browser": KnowledgeBrowserBlockView,
+    "task-manager": TaskManagerBlockView,
+    "worktree-status": WorktreeStatusBlockView,
+    "worktree-overview": WorktreeOverviewBlockView,
+    "ticket-queue": TicketQueueBlockView,
+    "settings": SettingsBlockView,
+    "training-room": TrainingRoomBlockView,
+    "project-hub": ProjectHubBlockView,
+  });
+}
diff --git a/vite.config.ts b/vite.config.ts
@@ -29,7 +29,7 @@ export default defineConfig(async () => ({
         },
       },
       treeshake: {
-        moduleSideEffects: false,
+        moduleSideEffects: true,
       },
     },
   },

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "sidstack",`
`3`		`- "version": "0.4.1",`
	`3`	`+ "version": "0.4.2",`
`4`	`4`	`"private": true,`
`5`	`5`	`"type": "module",`
`6`	`6`	`"description": "SidStack - Lightweight AI Agent Orchestration Platform",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@sidstack/api-server",`
`3`		`- "version": "0.4.1",`
	`3`	`+ "version": "0.4.2",`
`4`	`4`	`"description": "REST API server for SidStack Web UI",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"publishConfig": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@sidstack/cli",`
`3`		`- "version": "0.4.1",`
	`3`	`+ "version": "0.4.2",`
`4`	`4`	`"description": "SidStack CLI - Project Intelligence for AI Coding Agents",`
`5`	`5`	`"author": "SidStack Team",`
`6`	`6`	`"license": "MIT",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@sidstack/mcp-server",`
`3`		`- "version": "0.4.1",`
	`3`	`+ "version": "0.4.2",`
`4`	`4`	`"description": "MCP Server for SidStack - task management, knowledge, and impact analysis for Claude Code",`
`5`	`5`	`"main": "./dist/index.js",`
`6`	`6`	`"types": "./dist/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@sidstack/shared",`
`3`		`- "version": "0.4.1",`
	`3`	`+ "version": "0.4.2",`
`4`	`4`	`"description": "Shared types and utilities for SidStack",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"publishConfig": {`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://schema.tauri.app/config/2",`
`3`	`3`	`"productName": "SidStack",`
`4`		`- "version": "0.4.1",`
	`4`	`+ "version": "0.4.2",`
`5`	`5`	`"identifier": "com.sidstack.agent-manager",`
`6`	`6`	`"build": {`
`7`	`7`	`"beforeDevCommand": "pnpm dev",`