v4.0.1

Fixes

• Multi-workspace support in project-context hook — resolveWorkspace() now uses event.context.workspaceDir and scans workspace-* directories (T-123)
• Compaction event listener — hook now listens to session:compact:after, regenerating BOOTSTRAP.md after LCM compaction (T-121)
• Telegram multi-bot auth — allow mini app auth for multiple bot tokens

Chore

• Removed fragile curl workaround from compaction prompt (now handled automatically by hook)

v4.0.0 — Agent-Native Workflows + Idea Canvas

v4.0.0 (2026-03-05) — Agent-Native Workflows + Idea Canvas

• Idea Canvas (sticky notes + connections + clusters) — Visual ideation space with auto-framing for connected notes
• Canvas → Task Promote (Agent-Assisted) — Select a note or cluster → send structured payload → agent creates tasks/specs/subtasks and cleans up notes
• OpenClaw Webhook Session Bridge — Promote delivery via \ (fast, fire-and-forget, no CLI cold-start)
• Parent Tasks + Subtasks UX — Expand/collapse, progress indicator, delete flows support subtasks
• Unified Delete Modal — When a task has subtasks and/or a spec, modal shows checkboxes (delete spec, delete subtasks)
• Mobile/touch hardening — Fixed regressions around popovers, expand toggles, sort toggle, and canvas toolbar interactions
• Security + robustness fixes (from review)
  • XSS hardening in modals (escape user-provided titles)
  • Canvas note text length validation (prevents disk fill)
  • Correct byte-size checks for file writes (Buffer.byteLength)
• Kanban UI fixes — Priority popover rendered at body level (no clipping) + optimistic update revert on failure
• Docs refresh — New README pitch, updated screenshots, extracted CHANGELOG.md

v3.1.0 — UX & Mobile Improvements

What's New

✨ Features

• LAN Access via custom hostname — Auth bypass for local network access via configurable LOCAL_HOSTNAME env var (e.g. secondary Cloudflare Tunnel hostname)
• Delete files from dashboard — Remove files from context/ and specs/ directly in the UI
• Spec content body — POST /specs/:taskId now accepts optional pre-filled content
• Smart session log trimming — project-context hook keeps only last 2 sessions (smaller context)
• Shared UI components — ICONS registry and renderDeleteBtn() for consistent UI

🐛 Bug Fixes

• Restored vertical scroll per column when switching back to Tasks tab (mobile)
• Fixed ghost-tap prevention in file explorer (pendingOpen flag)
• Fixed delete bug: selectedFile was string, not object
• Preserved Kanban scroll position when switching tabs
• No-cache header for HTML to prevent stale UI on mobile
• Fixed spec-open flash (pendingOpen before tree render)

📖 Docs

• Extended PROJECT.md template with Scope, Project Files, context/ convention
• Design guidelines: shared components section added
• Added templates/env.example for easier setup

Branch Strategy

Starting with this release, active development happens on the dev branch. main stays stable.

v3.0.1 — Bugfixes

Bugfixes

• Viewport-Fix: Removed viewportStableHeight JS override — pure 100dvh prevents layout collapse when minimizing/reopening the Telegram Mini App
• File-Tree Auto-Scroll: When opening a file (e.g. spec via badge), the file tree now scrolls automatically to the active entry

v3.0.0 — Telegram Mini App

Highlights

• Cloudflare Tunnel: Dashboard remotely accessible via your own domain
• Telegram Mini App: WebApp-Button in bot, fully responsive
• Auth: Telegram initData HMAC-SHA256 + JWT Session Cookie
• Security: Rate Limiting, CORS, CSP, Security Headers
• Mobile CSS: iOS Files-style Explorer, Kanban Snap-Scroll
• Healthcheck: /api/health endpoint + uptime monitoring integration
• Templates: Systemd, Cloudflare Config, .env.example for self-hosting

v2.5.0 — Spec Files & Auto-Refresh

What's New

Spec File System

• Optional spec files for complex tasks in specs/ folder
• Template: Goal / Done When / Approach / Log (templates/spec.md)
• Lucide SVG icon badge on task cards (click to open, hover to create)
• API: POST /api/projects/:name/specs/:taskId scaffolds + links spec
• Agent auto-loads specs when task moves to in-progress

File Auto-Refresh

• File explorer auto-updates on create/modify/delete (5s polling)
• Fingerprint-based diff detection (path + mtime + size)
• Skips reload during active editing
• Auto-opens first file when selected file is deleted

UI Polish

• Priority popover: fixed horizontal layout
• Auto-expand parent directories when opening files via badge
• Lucide SVG icons (Gateway Dashboard alignment)

Documentation

• Design guidelines reference (docs/design-guidelines.md)
• PROJECT-RULES.md: spec creation/maintenance rules

Installation

• Added dashboard/package.json — npm install works out of the box
• Rewritten Quick Start guide with correct paths

Full Changelog: v2.4.0...v2.5.0

v2.4.0 - Modular Dashboard

What's new

• Dashboard modularized - Split the 1891-line monolith into clean ES modules (kanban.js, file-explorer.js, utils.js, dashboard.css). No build step, native browser modules.
• index.html reduced by 82% - From 1891 to 324 lines, just HTML and module imports now.
• Updated README - New screenshots (Kanban + File Explorer), simplified quick start, clearer architecture docs.

Dashboard structure

canvas/
├── index.html (HTML + module imports)
├── styles/dashboard.css
├── js/
│   ├── utils.js (API calls, helpers)
│   ├── kanban.js (task board logic)
│   └── file-explorer.js (file tree, preview, editing)
└── server.js

All functionality preserved 1:1. No breaking changes.

File Explorer v2.2.0

Initial standalone release

Moved from openclaw-skills monorepo to dedicated repository.

Features

• Tab system (Tasks/Files)
• File tree with loading badges (always/lazy/optional)
• Markdown & JSON preview with syntax highlighting
• Inline file editing with unsaved state indicator
• Context health tracking (4KB size warnings)
• Custom scrollbar UX (16px margin, view-specific visibility)
• Kanban dashboard with drag & drop task management
• Task workflow (open → in-progress → review → done)
• Priority management with popover selector
• Auto-task creation

Installation

git clone https://github.com/rasimme/openclaw-project-mode.git

See README.md for setup instructions.