npm - @legna-lnc/legnacode - Versions diffs - 1.5.3 → 1.5.5 - Mend

@legna-lnc/legnacode 1.5.3 → 1.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -1,723 +1,734 @@
-# Changelog
-🌐 [中文文档](./CHANGELOG.zh-CN.md)
-All notable changes to LegnaCode CLI will be documented in this file.
-## [1.5.3] - 2026-04-21
-### Features
-- **Hermes Self-Evolution Loop** — Automatic learning closed loop: repeated tool patterns (3x) auto-generate SKILL.md via side-channel LLM; behavior corrections auto-write to `.legna/memory/`; no user confirmation needed. Background Review Agent extracts experience insights after each session.
-- **Qwen Model Adapter** — Dedicated adapter for Qwen full series (qwen-plus, qwen-max, qwen-turbo, qwen-coder-plus, qwq-plus, qwen3-235b). Supports `thinking_budget` mapping, DashScope server-side web search (`enable_search`), `reasoning_content` streaming, and `content_filter` stop reason.
-- **WebUI Chat Viewer** — New "聊天记录" panel in admin WebUI. Browse session history with full message rendering, collapsible thinking blocks, tool call visualization (input/output/error), and auto-scroll. Backend `/api/:scope/sessions/:id/messages` endpoint reads JSONL session files.
-- **WebUI Live Chat** — `legna admin` WebUI now supports live chat via SSE streaming. Send messages, see streaming responses with thinking/tool-use visualization. Note: each message starts a new independent session (no multi-turn conversation); intended for quick API connectivity testing, not as a full chat client.
-- **Skill Auto-Create** — `SkillPatternDetector.record()` was already wired but results were never surfaced. Now auto-creates skills from detected patterns and notifies user after the fact.
-- **Skill Improvement Path B** — `skillImprovement` no longer gated to active skill execution. General conversation learning detects workflow preferences, behavior corrections, and coding style preferences every 10 user messages.
-- **Nudge System** — Counter-driven session learning summary. Reports what was automatically learned (skills created, corrections captured, insights recorded) instead of suggesting the user go learn.
-### Improvements
-- **onPreCompress Enhanced** — Working state extraction added alongside existing exchange pair extraction. Captures current task, key decisions, file paths, and error patterns before context compression. High-priority drawer written to DrawerStore.
-- **Skill Version Backup** — `applySkillImprovement` now backs up current SKILL.md to `.versions/` before overwriting. Changelog with last 20 versions maintained automatically.
-- **`/skillify` Unlocked** — Removed `USER_TYPE === 'ant'` gate. All users can now capture session workflows as reusable skills.
-### Bug Fixes
-- **WebUI inline script crash** — Fixed `Unexpected token '<'` error caused by unescaped `</` sequences in inlined JavaScript. JS and CSS are now served as separate files (`/__admin__/app.js`, `/__admin__/app.css`) instead of being inlined into `<script>` tags.
-## [1.5.2] - 2026-04-20
-### Performance
-- **Async CodeGraph** — `build()` and `walkDir()` converted from sync to async, yielding the event loop every 50 files. Added `maxDepth=10` depth limit and `visitedInodes` symlink loop protection. `save()` now uses async `writeFile`.
-- **undoTracker size guard** — Added 1MB file size limit; files exceeding it skip undo snapshot recording (prevents OOM). `readFileSync` → async `readFile`.
-- **Async error file pre-injection** — `extractErrorFiles` converted from `existsSync`+`readFileSync` to async `access`+`readFile`.
-- **stripCode dedup** — `magicKeywords.ts` reduced `stripCode()` from 3-4 calls to 1, passing the result to all downstream functions.
-- **FileMemoryProvider TTL cache** — `searchSolutions` and fallback file search now use 60s TTL cache, avoiding repeated disk reads on every prefetch.
-- **OML_SESSION_GUIDANCE cache** — `attachments.ts` dynamic import cached at module level after first load.
-- **frustrationHint patterns hoisted** — Regex array moved from function body to module-level constant.
-### i18n
-- **Compacting status messages localized** — "Compacting context…" → "凝练上下文…", "Compacting conversation" → "精炼对话中" for Chinese users.
-- **Turn completion verbs localized** — New `getTurnCompletionVerbs()` function; Chinese users see "烹制了 5s" instead of "Baked for 5s".
-### Cleanup
-- Deleted dead code `src/commands/undo.ts` (was never registered in command list).
-- Fixed dead conditional in `extractImports`.
-## [1.5.1] - 2026-04-19
-### Features
-- **Proactive skill invocation** — Wired `OML_SESSION_GUIDANCE` (the "1% rule") into the `skill_listing` attachment. The AI now proactively considers available skills before every response, instead of only responding to explicit `/slash` commands.
-- **Frontend/design auto-guidelines** — New `designPrompt.ts` detects frontend intent (UI, prototype, design exploration) from user input and transparently injects layered design guidelines (oklch colors, responsive layout, animation best practices, design exploration methodology). Zero user action required.
-- **Enhanced designer agent** — `/oml:designer` now carries a full design methodology prompt (oklch palettes, mobile-first, ARIA accessibility, 3+ variation exploration) instead of a one-line description.
-### Bug Fixes
-- **Skills were never proactively used** — `OML_SESSION_GUIDANCE` was defined in `superpowers.ts` but never imported or injected anywhere. Now wired into the skill listing attachment.
-## [1.5.0] - 2026-04-19
-### Bug Fixes
-- **Fix REPL startup deadlock** — The `/undo` command was registered via static `import` in `commands.ts`, creating a circular dependency (`commands.ts` → `undo.ts` → `commands.ts`) that caused Bun's module loader to deadlock. The REPL would hang with no output on launch. Fixed by removing the static import entirely. The `/undo` feature remains available via `src/services/undoTracker.ts` (wired into Edit/Write tools) but is no longer registered as a slash command to avoid the circular dependency.
-### Features (carried from 1.4.8/1.4.9)
-- **AtomCode intelligence fusion** — Pangu CJK spacing, negative feedback detection, tool call loop detection, error file pre-injection, first-read full file
-- **OpenAI-compatible bridge adapter** — Anthropic ↔ OpenAI format translation for DeepSeek/Qwen/GLM/Ollama/vLLM/LM Studio
-- **Code Graph** — Regex-based symbol index + file dependency graph (TS/JS/Python/Go/Rust)
-- **Parallel File Edit** — One sub-agent per file with sibling skeletons
-- **Workflow Engine** — Structured markdown step execution with checks and dependencies
-- **Cross-session knowledge** — Auto-writes `.legna/knowledge.md` on session end
-- **Baseline builds** — No-AVX binaries for older x64 CPUs (darwin-x64-baseline, linux-x64-baseline)
-## [1.4.9] - 2026-04-17
-### Features
-- **Baseline (no-AVX) builds** — New platform packages for older x64 CPUs without AVX instruction set support:
-  - `@legna-lnc/legnacode-darwin-x64-baseline` — macOS Intel (pre-2011 or Hackintosh without AVX)
-  - `@legna-lnc/legnacode-linux-x64-baseline` — Linux x64 servers/VMs without AVX
-  - Fixes `warn: CPU lacks AVX support, strange crashes may occur` error
-  - Install: `npm i -g @legna-lnc/legnacode-darwin-x64-baseline` (use directly, not via main package)
-## [1.4.8] - 2026-04-17
-### Features
-- **AtomCode intelligence fusion (Layer A)** — Lightweight agent intelligence, zero new dependencies:
-  - **Pangu CJK spacing** — Auto-inserts spaces between CJK and ASCII in Markdown rendering
-  - **Negative feedback detection** — Detects frustration ("still broken"/"错了"/"まだ壊れ"), injects strategy-shift hint (EN/ZH/JA)
-  - **Tool call loop detection** — Same (tool, args) 3+ times → blocks. Resets per user message
-  - **Error file pre-injection** — Bash fail → extracts file paths from stderr, auto-reads first 30 lines
-  - **First-read full file** — First encounter ignores offset/limit, forces full read
-- **OpenAI-compatible bridge adapter (Layer B1)** — Full Anthropic ↔ OpenAI format translation:
-  - Message format: `tool_use` ↔ `tool_calls`, `tool_result` ↔ `role: "tool"`
-  - Tool schema: `input_schema` ↔ `function.parameters`
-  - JSON repair for weak models (markdown fences, trailing commas, unbalanced brackets)
-  - Supports: OpenAI, DeepSeek, Qwen, GLM, SiliconFlow, Ollama, vLLM, LM Studio
-  - Activate: `OPENAI_COMPAT_BASE_URL` + `OPENAI_COMPAT_API_KEY` env vars
-- **Code Graph (Layer B2)** — Regex-based symbol index + file dependency graph:
-  - Languages: TypeScript/TSX, JavaScript, Python, Go, Rust
-  - Incremental mtime updates, persisted to `<cwd>/.legna/.palace/graph.json`
-  - **Wired:** auto-builds on session start, injects file summaries into prefetch context
-- **Parallel File Edit (Layer B3)** — "One sub-agent per file" execution model:
-  - Target file full text + sibling skeletons + interface contracts
-  - **Wired:** integrated into `/dispatch` skill prompt with parallel edit instructions
-- **Workflow Engine (Layer B4)** — Structured step execution:
-  - Markdown `## Step N:` format with checks, failure handling, dependencies
-  - **Wired:** WorkflowTool now parses steps, shows status, substitutes args
-- **/undo command** — Reverts the last file edit (Edit or Write tool):
-  - Tracks original content before each edit, max 20 entries per session
-  - New file creation → undo deletes the file
-- **Cross-session knowledge persistence** — Auto-writes `<cwd>/.legna/knowledge.md`:
-  - Extracts key decisions/actions from last 10 assistant messages on session end
-  - Appends timestamped entries, caps at 50KB
-- **Enhanced compiler error detection** — Extended error file pre-injection:
-  - Now matches compiler-style paths (`file.ts:42`, `file.py(10)`) in addition to standard paths
-## [1.4.7] - 2026-04-16
-### Features
-- **claude-mem memory intelligence fusion** — Ported 5 lightweight techniques from claude-mem's persistent memory system into DrawerStore, zero new dependencies:
-  - **Content-hash deduplication** — `sha256(wing + room + content)` with 30-second window prevents duplicate observations during rapid compaction cycles
-  - **Token economics tracking** — Each drawer records `discoveryTokens` (cost to create) and `readTokens` (accumulated recall cost) for memory ROI analysis
-  - **Relevance feedback** — `relevanceCount` incremented on each search hit; frequently recalled memories get up to +100% importance boost via `importance * (1 + 0.1 * min(count, 10))`
-  - **90-day time decay** — `max(0.3, 1.0 - age_days / 90)` applied to both search similarity and importance ranking. Old memories fade but never fully disappear
-  - **Privacy tag filtering** — `<private>...</private>` content stripped to `[REDACTED]` before memory extraction. Zero config, just wrap sensitive text in tags
-### Architecture
-- Modified `src/memdir/vectorStore/types.ts` — Drawer gains `discoveryTokens`, `readTokens`, `relevanceCount`, `contentHash` fields
-- Modified `src/memdir/vectorStore/drawerStore.ts` — Schema migration (4 new columns), content-hash dedup in upsert, relevance feedback in search, time decay in search + topByImportance
-- Modified `src/memdir/vectorStore/exchangeExtractor.ts` — `stripPrivate()` applied before pair extraction
-## [1.4.6] - 2026-04-16
-### Bug Fixes
-- **OML skill crash fix** — All 40 OML skills (16 superpowers + 5 orchestrators + 19 agents) returned `string` instead of `ContentBlockParam[]` from `getPromptForCommand`, causing `result.filter is not a function` crash on `/ultrawork`, `/ralph`, `/autopilot`, etc. Now wrapped as `Promise<[{ type: 'text', text }]>`.
-- **Statusline writes to wrong config dir** — `statuslineSetup` agent hardcoded `~/.claude/settings.json` and `~/.claude/statusline-command.sh`. Fixed to `~/.legna/`.
-### Improvements
-- **Plans moved to project-local** — Default plan directory changed from `~/.legna/plans/` to `<cwd>/.legna/plans/`. Plans now live alongside the project they belong to.
-- **Auto-memory moved to project-local** — Default auto-memory path changed from `~/.legna/projects/<slug>/memory/` to `<cwd>/.legna/memory/`. First startup auto-migrates files from the legacy global path (non-destructive, never overwrites).
-- **Compound engineering seamless fusion** — Knowledge compounding from compound-engineering-plugin, injected into 3 existing automation points with zero new commands:
-  - `onPreCompress`: high-value exchange pairs auto-written to `docs/solutions/` (opt-in via `mkdir docs/solutions`)
-  - `prefetch`: auto-searches `docs/solutions/` for past learnings when user asks related questions
-  - `magicKeywords`: deep scope detection (refactor/migrate/architecture) appends a lightweight compound hint
-- **Legacy path comments cleaned** — Updated stale `~/.claude/projects/` references in memdir, extractMemories, settings types
-## [1.4.5] - 2026-04-13
-### Features
-- **OpenViking content tiering fusion** — Ported L0/L1/L2 three-tier content grading from OpenViking's context database:
-  - **Content Tiering** — Each drawer auto-generates L0 (one-sentence summary, ~25 words) and L1 (core overview, ~200 words) at upsert time. L2 is the full verbatim content.
-  - **Budget-aware wake-up** — `wakeUp()` now accepts a token budget (default 800) and greedily fills it with L1 content, degrading to L0 when budget is tight.
-  - **Budget-capped recall** — New `recallWithBudget()` method: L2→L1→L0 degradation strategy ensures recall never exceeds character budget.
-  - **CJK-aware token estimation** — `estimateTokens()` handles mixed CJK/Latin text.
-  - **SQLite schema migration** — Existing DrawerStore databases auto-migrate with `ALTER TABLE ADD COLUMN`.
-  - **Fixed recallByTopic()** — Now passes actual query for vector ranking instead of empty string.
-## [1.4.4] - 2026-04-11
-### Improvements
-- **Status messages moved to spinner line** — autocompact / output truncated / interrupted status messages no longer insert system messages into the conversation; they now display temporarily on the spinner animation line, flashing briefly without polluting context
-- **ToolUseContext adds setSpinnerMessage** — generic spinner text callback allowing the query loop to update spinner status at any time
-- **LegnaCode vs Claude Code comparison doc** — added [COMPARISON.md](./COMPARISON.md) with 60+ item-by-item comparison across 9 categories
-## [1.4.3] - 2026-04-11
-### Features
-- **mempalace memory architecture integration** — ported mempalace core memory system, pure TypeScript implementation, zero external dependencies:
-  - **DrawerStore** — SQLite-persisted vector memory storage + WAL audit log, deterministic drawer ID (sha256 idempotent upsert)
-  - **TF-IDF vectorizer** — pure TS implementation (Porter stemming + cosine similarity), <10K drawer search <5ms
-  - **4-layer memory stack** — L0 identity (~100 tokens) + L1 top drawers (~500-800 tokens) loaded every turn, L2/L3 recalled on demand. Per-turn tokens reduced from ~8K to ~800 (~88% savings)
-  - **Temporal knowledge graph** — SQLite entity-relation storage, supports triples with validity periods and point-in-time queries
-  - **Room auto-classification** — 6 categories (facts/decisions/events/discoveries/preferences/advice) with keyword scoring
-  - **Exchange pair extractor** — Q+A paired chunking + 5-category tag scoring (decisions/preferences/milestones/problems/emotional)
-  - **Auto-migration** — automatically migrates existing .legna/memory/*.md files to DrawerStore on first startup
-  - **PreCompact memory save** — automatically extracts high-value exchange pairs to DrawerStore before compaction, preventing memory loss
-### Architecture
-- Added `src/memdir/vectorStore/` — complete vector memory system (8 files)
-  - `types.ts` — Drawer, SearchResult, MetadataFilter types
-  - `tfidfVectorizer.ts` — TF-IDF + Porter stemming + cosine similarity
-  - `drawerStore.ts` — SQLite persistence + WAL + vector search
-  - `roomDetector.ts` — content auto-classification
-  - `layeredStack.ts` — 4-layer memory stack
-  - `knowledgeGraph.ts` — temporal knowledge graph
-  - `exchangeExtractor.ts` — exchange pair extraction + tag scoring
-  - `migration.ts` — .md → DrawerStore auto-migration
-- Upgraded `src/memdir/providers/FileMemoryProvider.ts` — DrawerStore + LayeredStack backend
-- Wired `src/services/compact/autoCompact.ts` — calls onPreCompress before compaction
-## [1.4.2] - 2026-04-11
-### Features
-- **verbose enabled by default** — users now see full tool execution progress and status information by default
-- **Token/Timer instant display** — removed 30-second delay, token count and elapsed time shown from second 1
-- **Autocompact status visible** — displays "Compacting conversation context..." system message during conversation compaction
-- **Interrupt reason visible** — shows abort reason on interruption (streaming and tool_execution phases)
-- **Output truncated retry prompt** — displays retry progress during max output tokens recovery
-- **Tool execution logging** — StreamingToolExecutor outputs current tool name and queue depth
-- **Microcompact/Snip logging** — added debug logging for compaction operations
-- **ForkedAgent startup logging** — outputs label and ID when child agent starts
-### Bug Fixes
-- **Apple Terminal notification logic fix** — bell is now sent only when bell is not disabled (logic was previously inverted)
-## [1.4.0] - 2026-04-11
-### Features
-- **MiniMax deep native integration** — when using MiniMax models with `MINIMAX_API_KEY` configured, automatically registers 6 native multimodal tools:
-  - `MiniMaxImageGenerate` — image generation (POST /v1/image_generation)
-  - `MiniMaxVideoGenerate` — video generation + async polling (POST /v1/video_generation)
-  - `MiniMaxSpeechSynthesize` — text-to-speech (POST /v1/t2a_v2)
-  - `MiniMaxMusicGenerate` — music generation (POST /v1/music_generation)
-  - `MiniMaxVisionDescribe` — image understanding VLM (POST /v1/coding_plan/vlm)
-  - `MiniMaxWebSearch` — web search (POST /v1/web_search)
-- **MiniMax auth command** — `/auth-minimax` command to configure API key, persisted to `~/.legna/minimax-credentials.json`
-- **MiniMax tool schema export** — `schemaExport.ts` supports exporting Anthropic-compatible tool schemas
-- **MiniMax multimodal skill pack** — 5 built-in skills (image/video/speech/music/pipeline) guiding AI to orchestrate multimodal workflows
-- **Smart model routing** — heuristic routing to fast/default/strong model tiers based on prompt complexity
-- **Autonomous skill detection** — detects repetitive tool call patterns and prompts users to save as reusable skills
-- **Context compression enhancements**:
-  - Tool output pre-pruning — large tool_result blocks auto-trimmed before compact (head + tail preserved)
-  - Budget pressure injection — injects hints into tool results when context usage exceeds 80%, guiding the model to wrap up
-- **RPC subprocess tool execution** — Unix Domain Socket RPC server + stub generator + code execution runner; AI-generated scripts can call back LegnaCode tools (Bash/Read/Write/Edit/Glob/Grep/WebFetch) via RPC, compressing multi-step operations into a single inference
-- **Memory Provider plugin system** — abstract base class + registry + default FileMemoryProvider; supports one external provider running in parallel with built-in memory, full lifecycle (initialize/prefetch/syncTurn/shutdown) + optional hooks (onTurnStart/onSessionEnd/onPreCompress/onDelegation)
-- **Cross-session memory search** — `/recall` command searches historical session JSONL files with keyword matching + relevance ranking
-- **Worker thread pool** — large file operations / batch searches can be offloaded to worker threads, avoiding main thread blocking
-### Architecture
-- Added `src/tools/MiniMaxTools/` — complete MiniMax multimodal tool directory (client, endpoints, 6 buildTool tools, conditional registration, schema export)
-- Added `src/services/rpc/` — RPC subprocess tool execution (rpcServer.ts, stubGenerator.ts, codeExecutionRunner.ts)
-- Added `src/memdir/providers/` — Memory Provider plugin system (MemoryProvider.ts abstract base class, FileMemoryProvider.ts default implementation, registry.ts registry)
-- Added `src/services/modelRouter.ts` — task complexity estimation + model tier routing
-- Added `src/services/skillAutoCreate.ts` — tool call pattern detector, integrated into toolExecution.ts
-- Added `src/services/compact/toolOutputPruner.ts` — tool output pre-pruning, integrated into autoCompact.ts
-- Added `src/services/compact/budgetPressure.ts` — context budget pressure injection, integrated into query.ts
-- Added `src/services/sessionSearch.ts` — cross-session search engine
-- Added `src/commands/recall/` — `/recall` command
-- Added `src/commands/auth/` — `/auth-minimax` command
-- Added `src/skills/builtin-minimax/` — 5 MiniMax multimodal skill files
-- Added `src/utils/workerPool.ts` — worker thread pool
-## [1.3.7] - 2026-04-09
-### Bug Fixes
-- **Resume session detection** — `legna resume` failed to discover sessions written to `<project>/.legna/sessions/` since v1.3.0. `getStatOnlyLogsForWorktrees()` only scanned the global `~/.legna/projects/`; it now also scans the project-local sessions directory, consistent with `fetchLogs()` behavior
-- **Interrupted diagnostics logging** — added abort reason + call stack logging at `onCancel()` and `query.ts` interrupt points; traceable under `--verbose` mode
-### Enhancements
-- **Priority-now interrupt visibility** — when a queued command interrupts the current task, the command summary is logged to debug log instead of silently aborting
-- **Background task status visibility** — footer pill shows real-time activity summary for a single background agent (latest tool + token stats); task completion notification includes progress statistics
-### Architecture
-- `src/utils/sessionStorage.ts` — `getStatOnlyLogsForWorktrees()` Path A/B both include `.legna/sessions/` scanning
-- `src/query.ts` — abort reason logging added at both `createUserInterruptionMessage` call sites
-- `src/screens/REPL.tsx` — `onCancel()` call stack logging, priority-now useEffect logs command summary
-- `src/tasks/pillLabel.ts` — single agent task displays `getActivitySummary()` real-time activity
-- `src/tasks/LocalMainSessionTask.ts` — `completeMainSessionTask` captures progress, notification includes statistics
-## [1.3.6] - 2026-04-09
-### Bug Fixes
-- **Windows Edit tool path separator false positive** — fixed [#7935](https://github.com/anthropics/claude-code/issues/7935): on Windows, after reading a file with forward slashes (`D:/path`), Edit/MultiEdit tools reported "File has been unexpectedly modified" error. Root cause: `path.normalize()` does not always convert `/` to `\` in certain runtimes (Bun compiled binary + Git Bash/MINGW environment), causing FileStateCache key mismatch
-  - `FileStateCache` added `normalizeKey()` — explicitly replaces `/` with the native separator (Windows: `\`) after `path.normalize()`, ensuring `D:/foo` and `D:\foo` always hit the same cache entry
-  - `expandPath()` added `ensureNativeSeparators()` — all returned paths force backslashes on Windows as a defensive fix
-### Architecture
-- `src/utils/fileStateCache.ts` — `normalizeKey()` replaces bare `normalize()`, imports `sep`
-- `src/utils/path.ts` — `ensureNativeSeparators()` wraps all `normalize()`/`resolve()`/`join()` return values
-## [1.3.5] - 2026-04-07
-### Bug Fixes
-- **SessionStart hook error** — OML's SessionStart hook used `type: 'prompt'`, but the SessionStart phase has no `toolUseContext` (LLM call context), causing a guaranteed crash. Removed SessionStart hook; skill guidance is now exposed through skill descriptions
-- **Windows alt-screen rendering flicker** — in alt-screen mode, `fullResetSequence_CAUSES_FLICKER` was still triggered (viewport changes, scrollback detection, etc.), causing full-screen clear + redraw flicker. Added `altScreenFullRedraw()` method; in alt-screen mode, uses simple `CSI 2J + CSI H` (erase screen + cursor home) instead of `clearTerminal`'s Windows legacy path
-- **Windows drainStdin** — previously skipped stdin draining entirely on Windows; residual mouse events caused input field corruption. Changed to flush buffered input events by toggling raw mode
-### Architecture
-- `src/ink/log-update.ts` — 5 `fullResetSequence_CAUSES_FLICKER` call sites now check `altScreen`, added `altScreenFullRedraw()` method
-- `src/ink/ink.tsx` — Windows `drainStdin` alternative (toggle raw mode)
-- `src/plugins/bundled/oml/definition.ts` — removed SessionStart hook, OML upgraded to 1.2.0
-## [1.3.4] - 2026-04-07
-### New Features
-- **OML Superpowers engineering discipline** — integrated obra/superpowers core skills, enforcing strict software engineering workflows for AI
-  - `/verify` — completion verification discipline: cannot claim completion without fresh evidence
-  - `/tdd` — TDD enforcement: RED-GREEN-REFACTOR, write tests before code
-  - `/debug` — 4-stage systematic debugging, question architecture after 3 failures
-  - `/brainstorm` — Socratic design: hard gate, no implementation allowed until design is approved
-  - `/write-plan` — break design into 2-5 minute tasks, zero placeholders
-  - `/sdd` — sub-agent driven development: implement → spec review → quality review, 3 stages
-  - `/exec-plan` — load plan file and execute tasks sequentially
-  - `/dispatch` — parallel sub-agent dispatch
-  - `/code-review` — dispatch reviewer sub-agent
-  - `/worktree` — Git worktree isolated development
-  - `/finish-branch` — branch wrap-up (merge/PR/keep/discard)
-- **SessionStart skill guidance** — automatically injects OML skill guidance prompt at session start ("1% rule")
-- OML plugin version upgraded to 1.1.0, 35 built-in skills total
-### Architecture
-- `src/plugins/bundled/oml/superpowers.ts` — 11 engineering discipline skills + SessionStart guidance
-- `src/plugins/bundled/oml/definition.ts` — appended superpowers skills + SessionStart hook
-## [1.3.3] - 2026-04-07
-### New Features
-- **OML (Oh-My-LegnaCode) smart orchestration layer** — built-in oh-my-claudecode core functionality, works out of the box
-  - 5 orchestration skills: `/ultrawork` (parallel execution), `/ralph` (persistent loop), `/autopilot` (fully autonomous), `/ralplan` (plan then execute), `/plan-oml` (structured planning)
-  - 19 specialized agent skills: `/oml:explore`, `/oml:planner`, `/oml:architect`, `/oml:executor`, `/oml:verifier`, etc.
-  - Magic Keywords auto-detection: when prompt contains keywords like ultrawork/ralph/autopilot/ultrathink, orchestration directives are auto-injected (supports CJK and Vietnamese)
-  - Can be enabled/disabled via `/plugin` UI (`oml@builtin`, enabled by default)
-  - `OML_BUILTIN` feature flag controls compile-time DCE
-### Bug Fixes
-- **Windows Terminal Fullscreen** — automatically enables alt-screen mode in `WT_SESSION` environment, completely eliminating the cursor-up viewport yank bug (microsoft/terminal#14774). Covers WSL-in-Windows-Terminal. `CLAUDE_CODE_NO_FLICKER=0` to opt-out
-### Architecture
-- `src/plugins/bundled/oml/` — OML plugin module (definition, skills, agents, magicKeywords)
-- `src/plugins/bundled/index.ts` — registered OML builtin plugin
-- `src/utils/processUserInput/processUserInput.ts` — magic keyword detection integration point
-- `src/utils/fullscreen.ts` — Windows Terminal fullscreen condition
-## [1.3.2] - 2026-04-07
-### Breaking Changes
-- **Disabled HISTORY_SNIP** — `bunfig.toml` feature flag set to false, compile-time DCE removes all snip-related code (SnipTool, snipCompact, snipProjection, force-snip command, attachments nudge). Auto-compact is unaffected; context management reverts to the original mechanism
-### Bug Fixes
-- **Windows Terminal streaming text** — no longer disables streaming text display for all Windows; now only disabled under legacy conhost. Windows Terminal (detected via `WT_SESSION` environment variable) restores normal streaming rendering
-## [1.3.1] - 2026-04-06
-### Bug Fixes
-- **Snip-aware context window** — 1M models are no longer prematurely snipped; `KEEP_RECENT` changed from hardcoded 10 to dynamic calculation (1M: 200, 500K: 100, 200K: 10)
-- **Snip nudge frequency** — 1M model nudge threshold raised from 20 to 100 messages
-- **branch command branding** — `/branch` resume prompt changed from `claude -r` to `legna -r`
-- **admin version fallback** — displays correct version number when running from source
-### Architecture
-- `src/services/compact/snipCompact.ts` — added `getSnipThresholds(model)` dynamic threshold function; `snipCompactIfNeeded` and `shouldNudgeForSnips` gained model parameter
-- `src/query.ts` / `src/QueryEngine.ts` / `src/commands/force-snip-impl.ts` — pass model parameter
-## [1.3.0] - 2026-04-04
-### New Features
-- **Project-local storage** — sessions, skills, memory, rules, and settings all moved down to `<project>/.legna/` directory
-  - New sessions written to `<project>/.legna/sessions/<uuid>.jsonl`, traveling with the project
-  - Project-level skills/rules/settings/agent-memory/workflows unified under `.legna/`
-  - `.legna/` automatically added to `.gitignore`
-- **Global data migration** — automatically migrates from `~/.claude/` to `~/.legna/` on first startup (one-way)
-  - Migrates settings.json, credentials, rules, skills, agents, plugins, keybindings, etc.
-  - Does not overwrite existing files; writes `.migration-done` marker on completion
-  - `LEGNA_NO_CONFIG_SYNC=1` to disable
-- **`legna migrate` command** — manual data migration
-  - `--global` migrates global data only
-  - `--sessions` migrates current project sessions to local only
-  - `--all` migrates everything (default)
-  - `--dry-run` preview mode
-- **Three-level fallback reads** — automatically searches `.legna/` → `.claude/` → `~/.legna/` → `~/.claude/` when reading, zero-breakage backward compatibility
-### Architecture
-- `src/utils/legnaPathResolver.ts` — unified path resolution (PROJECT_FOLDER/LEGACY_FOLDER/resolveProjectPath)
-- `src/utils/ensureLegnaGitignored.ts` — auto-gitignore utility
-- `src/utils/envUtils.ts` — refactored global migration logic, removed old syncClaudeConfigToLegna
-- `src/utils/sessionStoragePortable.ts` — added getLocalSessionsDir/getLegacyProjectsDir, refactored resolveSessionFilePath
-- `src/utils/sessionStorage.ts` — session write path switched to project-local
-- `src/utils/listSessionsImpl.ts` — multi-source scan and merge (local + global + legacy)
-- `src/commands/migrate/` — CLI migration command
-## [1.2.1] - 2026-04-04
-### New Features
-- **Model Adapter Layer** — unified third-party model compatibility framework, auto-detects model/endpoint and applies corresponding transforms
-- **MiMo (Xiaomi) adapter** — api.xiaomimimo.com/anthropic, supports mimo-v2-pro/omni/flash (1M ctx)
-  - simplifyThinking + forceAutoToolChoice + normalizeTools + stripBetas + injectTopP(0.95) + stripCacheControl
-  - Handles content_filter / repetition_truncation stop_reason
-- **GLM (ZhipuAI) adapter** — open.bigmodel.cn/api/anthropic, supports glm-5.1/5/5-turbo/4.7/4.6/4.5, etc.
-  - Full standard transform suite, server-side auto-caching (strip cache_control)
-- **DeepSeek adapter** — api.deepseek.com/anthropic, supports deepseek-chat/coder/reasoner
-  - stripReasoningContent to avoid 400 errors, reasoner models auto-strip temperature/top_p
-- **Kimi (Moonshot) adapter** — api.moonshot.ai/anthropic, supports kimi-k2/k2.5/k2-turbo, etc.
-  - Preserves cache_control (Kimi supports prompt caching discount), stripReasoningContent
-- **MiniMax adapter** — api.minimaxi.com/anthropic (China) + api.minimax.io/anthropic (international)
-  - Supports MiniMax-M2.7/M2.5/M2.1/M2 full series (204K ctx), case-insensitive matching
-  - Deep compatibility: preserves metadata, tool_choice, cache_control, top_p (other adapters need strip/force)
-  - Only needs simplifyThinking + normalizeTools + stripBetas + stripUnsupportedFieldsKeepMetadata
-### Architecture
-- `src/utils/model/adapters/index.ts` — adapter registry + match/transform dispatch
-- `src/utils/model/adapters/shared.ts` — 12 shared transform functions (including new stripUnsupportedFieldsKeepMetadata)
-- `src/utils/model/adapters/{mimo,glm,deepseek,kimi,minimax}.ts` — 5 provider adapters
-- `src/services/api/claude.ts` — paramsFromContext() calls applyModelAdapter() at the end
-## [1.2.0] - 2026-04-03
-### New Features
-- **Sessions grouped by project** — WebUI session history panel groups sessions by project path
-- **resume command with cd** — copied resume command auto-includes `cd` to project directory (Windows uses `cd /d`)
-- **Migration supports session history** — config migration panel adds "also migrate session history" option, copies `projects/` directory
-- **Windows native compilation** — Windows binary now compiled natively on Windows
-### Fixed
-- Migration panel field names corrected to match actual settings.json fields
-## [1.1.10] - 2026-04-03
-### Fixed
-- **Windows compile script fix** — `scripts/compile.ts` correctly handles `.exe` suffix on Windows, fixing the issue where compiled output file could not be found
-- **Windows native binary recompiled and published** — recompiled native `legna.exe` using Windows-native Bun, replacing the previous cross-compiled version
-## [1.1.9] - 2026-04-03
-### Fixed
-- **postinstall auto-installs platform package** — added `npm/postinstall.cjs`; during `npm install`, automatically detects and installs the corresponding platform binary package from the official registry, completely solving the issue where optionalDependencies fails on Windows/mirror registries
-- **Force official registry** — postinstall uses `--registry https://registry.npmjs.org` to avoid 404 errors from unsynchronized mirrors (e.g., Taobao)
-- **bin wrapper simplified** — removed runtime auto-install logic, now guaranteed by postinstall
-## [1.1.8] - 2026-04-03
-### Fixed
-- **Windows npm global install missing platform package** — bin wrapper now auto-executes `npm install -g` for the corresponding platform package when it detects the package is not installed, no longer requiring manual user action
-- **bin wrapper path lookup optimization** — fixed scope directory path joining under global node_modules flat layout
-## [1.1.7] - 2026-04-03
-### Fixed
-- **Completely fixed Windows external module error** — cleared the compile external list; all stub modules (`@ant/*`, `@anthropic-ai/*`, native napi) are now bundled into the binary, no longer depending on runtime external modules
-## [1.1.6] - 2026-04-03
-### Fixed
-- **Windows external module error** — removed `@anthropic-ai/sandbox-runtime`, `@anthropic-ai/mcpb`, `@anthropic-ai/claude-agent-sdk`, `audio-capture-napi`, `color-diff-napi`, `modifiers-napi` from the compile external list, letting stub code bundle directly into the binary; Windows no longer reports `Cannot find module`
-- **bin wrapper multi-path lookup** — `npm/bin/legna.cjs` added global node_modules flat path and nested path fallback, improving cross-platform npm global install compatibility
-- **Version number automation** — added `scripts/bump.ts` for one-click sync of version numbers across package.json, bunfig.toml, webui/package.json, and optionalDependencies
-- **Release process automation** — rewrote `scripts/publish.ts` for one-click bump → build webui → compile all → publish npm
-## [1.1.5] - 2026-04-03
-### New Features
-- **WebUI admin panel** — `legna admin` launches a browser-based admin panel (HTTP server + React SPA, default port 3456), visual management of both `~/.claude/` and `~/.legna/` config directories
-- **Config editing** — edit API endpoint, API key, model mapping (Opus/Sonnet/Haiku), timeout, permission mode, language, and all other settings.json fields in the browser
-- **Config file switching** — lists settings*.json files, shows baseUrl/model, one-click swap to activate
-- **Session history browsing** — parses all session JSONL files under the projects directory, displays project path, slug, time, prompt count, and copy resume command
-- **Config migration** — Claude ↔ LegnaCode bidirectional migration, supports full or selective field migration (env/model/permissions, etc.), preview diff before migration
-- **npm cross-platform publishing** — bin wrapper (.cjs), compile-all cross-platform compilation (darwin/linux/win32), publish script
-- **OAuth disabled** — `isAnthropicAuthEnabled()` returns false, removed OAuth login flow
-### Fixed (1.1.1 ~ 1.1.5)
-- bin wrapper changed to `.cjs` to fix ESM `require` error
-- `optionalDependencies` platform package versions aligned
-- Terminal restored on admin server exit with screen clear
-- WebUI frontend inlined into binary, no longer depends on external `webui/dist/`
-- All package versions unified to 1.1.5
-### Architecture
-- Backend: `src/server/admin.ts` — Bun.serve REST API, SPA inlined as string constant
-- Frontend: `webui/` — React 18 + Vite + Tailwind SPA, tab-based scope switching
-- Inlining: `scripts/inline-webui.ts` → `src/server/admin-ui-html.ts`
-- CLI: `src/entrypoints/cli.tsx` — `admin` fast-path, zero extra module loading
-## [1.0.9] - 2026-04-03
-### New Features
-- **i18n multilingual completion** — completed ~100 missing hardcoded English strings across 9 files, covering Spinner, teammate tree, pill labels, keyboard shortcut hints, Tips, and all other UI areas
-- **Built-in styled status bar** — no external script configuration needed; displays directory, Git branch/sync status, model name (smart parsing to friendly name), colored context progress bar, and time by default; cross-platform compatible with Win/Mac/Linux
-- **Config auto-migration** — automatically syncs `~/.claude/settings.json` to `~/.legna/settings.json` on startup; prints warning without overwriting when both sides differ; `LEGNA_NO_CONFIG_SYNC=1` to disable
-### Changed
-- `~/.legna/` is now the preferred config directory, `~/.claude/` serves as compatibility fallback
-- Status bar model name auto-parsing: `Claude-Opus-4-6-Agentic[1m]` → `Opus 4.6`
-- `KeyboardShortcutHint` component "to" connector word internationalized (Chinese displays "→")
-### Files Changed
-| File | Changes |
-|------|---------|
-| `src/utils/i18n/zh.ts` | +50 translation entries |
-| `src/components/Spinner.tsx` | 7 i18n points |
-| `src/components/PromptInput/PromptInputFooterLeftSide.tsx` | 4 i18n points |
-| `src/components/design-system/KeyboardShortcutHint.tsx` | "to" internationalized |
-| `src/components/Spinner/teammateSelectHint.ts` | i18n |
-| `src/components/Spinner/TeammateSpinnerTree.tsx` | 6 i18n points |
-| `src/components/Spinner/TeammateSpinnerLine.tsx` | 7 i18n points |
-| `src/tasks/pillLabel.ts` | all pill labels i18n |
-| `src/services/tips/tipRegistry.ts` | 25 tips i18n |
-| `src/utils/builtinStatusLine.ts` | added: built-in status bar renderer |
-| `src/components/StatusLine.tsx` | integrated built-in status bar |
-| `src/utils/envUtils.ts` | config auto-migration logic |
-## [1.0.8] - 2026-04-02
-### New Features
-- **MONITOR_TOOL** — MCP server health monitoring tool, supports start/stop/status operations, background periodic ping to detect connection status
-- **WORKFLOW_SCRIPTS** — workflow automation system, reads `.claude/workflows/*.md` to execute multi-step workflows, `/workflows` command lists available workflows
-- **HISTORY_SNIP** — session history trimming, model can proactively call SnipTool to remove old messages and free context, `/force-snip` for forced trimming, UI retains full history while model view is filtered
-### Infrastructure
-- Added `src/tools/MonitorTool/MonitorTool.ts` — MCP monitoring tool (buildTool construction)
-- Added `src/tasks/MonitorMcpTask/MonitorMcpTask.ts` — monitoring background task lifecycle management
-- Added `src/components/permissions/MonitorPermissionRequest/` — monitoring permission UI
-- Added `src/components/tasks/MonitorMcpDetailDialog.tsx` — monitoring task detail dialog
-- Added `src/tools/WorkflowTool/WorkflowTool.ts` — workflow execution tool
-- Added `src/tools/WorkflowTool/createWorkflowCommand.ts` — workflow command scanning and registration
-- Added `src/tools/WorkflowTool/bundled/index.ts` — built-in workflow registration entry
-- Added `src/tools/WorkflowTool/WorkflowPermissionRequest.tsx` — workflow permission UI
-- Added `src/commands/workflows/` — `/workflows` slash command
-- Added `src/tasks/LocalWorkflowTask/LocalWorkflowTask.ts` — workflow background task (kill/skip/retry)
-- Added `src/components/tasks/WorkflowDetailDialog.tsx` — workflow detail dialog
-- Added `src/services/compact/snipCompact.ts` — trim trigger logic (rewrote stub)
-- Added `src/services/compact/snipProjection.ts` — model view message filtering
-- Added `src/tools/SnipTool/SnipTool.ts` — model-callable trimming tool
-- Added `src/tools/SnipTool/prompt.ts` — SnipTool constants and prompt
-- Added `src/commands/force-snip.ts` — `/force-snip` slash command
-- Added `src/components/messages/SnipBoundaryMessage.tsx` — trim boundary UI component
-- 3 feature flags flipped: MONITOR_TOOL, WORKFLOW_SCRIPTS, HISTORY_SNIP
-- Cumulative 47/87 feature flags enabled
-## [1.0.7] - 2026-04-02
-### New Features
-- **TERMINAL_PANEL** — `Alt+J` toggles built-in terminal panel (tmux persistent), TerminalCapture tool can read terminal content
-- **WEB_BROWSER_TOOL** — built-in web browsing tool, fetches web page content and extracts text
-- **TEMPLATES** — structured workflow template system, `legna new/list/reply` CLI commands, job status tracking
-- **BG_SESSIONS** — background session management, `legna ps/logs/attach/kill/--bg`, tmux persistence + PID file discovery
-### Infrastructure
-- Added `src/tools/TerminalCaptureTool/` — tmux capture-pane tool (2 files)
-- Added `src/tools/WebBrowserTool/WebBrowserTool.ts` — fetch + HTML text extraction
-- Added `src/jobs/classifier.ts` — workflow turn classifier
-- Added `src/cli/handlers/templateJobs.ts` — template CLI handler
-- Added `src/cli/bg.ts` — background session CLI (5 handlers)
-- Added `src/utils/taskSummary.ts` — periodic activity summary
-- Added `src/utils/udsClient.ts` — active session enumeration
-- Cumulative 44/87 feature flags enabled
-## [1.0.6] - 2026-04-02
-### New Features
-- **CACHED_MICROCOMPACT** — cache-aware tool result compression, deletes old tool_result via API cache_edits directive without breaking prompt cache
-- **AGENT_TRIGGERS** — `/loop` cron scheduling command + CronCreate/Delete/List tools, local scheduled task engine
-- **TREE_SITTER_BASH** — pure TypeScript bash AST parser (~4300 lines), used for command safety analysis
-- **TREE_SITTER_BASH_SHADOW** — tree-sitter vs legacy parser shadow comparison mode
-- **MCP_SKILLS** — auto-discovers and registers skill commands from MCP server `skill://` resources
-- **REACTIVE_COMPACT** — auto-triggers context compression on 413/overload errors
-- **REVIEW_ARTIFACT** — `/review` code review skill + ReviewArtifact tool
-### Infrastructure
-- Rewrote `src/services/compact/cachedMicrocompact.ts` (from stub to 150+ line full implementation)
-- Added `src/services/compact/cachedMCConfig.ts` — synchronous config module
-- Added `CACHE_EDITING_BETA_HEADER` to `src/constants/betas.ts`
-- Added `src/skills/mcpSkills.ts`, `src/services/compact/reactiveCompact.ts`
-- Added `src/tools/ReviewArtifactTool/`, `src/skills/bundled/hunter.ts`
-- Cumulative 40/87 feature flags enabled
-## [1.0.5] - 2026-04-02
-### New Features
-- **AGENT_TRIGGERS** — `/loop` cron scheduling command, CronCreate/Delete/List tools, local scheduled task engine
-- **TREE_SITTER_BASH** — pure TypeScript bash AST parser, used for command safety analysis
-- **TREE_SITTER_BASH_SHADOW** — tree-sitter vs legacy parser shadow comparison mode
-- **MCP_SKILLS** — auto-discovers and registers skill commands from MCP server `skill://` resources
-- **REACTIVE_COMPACT** — auto-triggers context compression on 413/overload errors
-- **REVIEW_ARTIFACT** — `/review` code review skill + ReviewArtifact tool + permission UI
-### Infrastructure
-- Added `src/skills/mcpSkills.ts` — MCP skill discovery module
-- Added `src/services/compact/reactiveCompact.ts` — reactive compression strategy
-- Added `src/tools/ReviewArtifactTool/` — code review tool
-- Added `src/components/permissions/ReviewArtifactPermissionRequest/` — review permission UI
-- Added `src/skills/bundled/hunter.ts` — /review skill registration
-- Cumulative 39/87 feature flags enabled
-## [1.0.4] - 2026-04-02
-### New Features
-- **ULTRAPLAN** — `/ultraplan` structured multi-step planning command
-- **VERIFICATION_AGENT** — auto-spawns verification Agent after batch task completion
-- **AUTO_THEME** — auto-switches dark/light theme by querying terminal background color via OSC 11
-- **AGENT_MEMORY_SNAPSHOT** — Agent memory snapshots
-- **FILE_PERSISTENCE** — file persistence tracking
-- **POWERSHELL_AUTO_MODE** — PowerShell auto mode
-- **HARD_FAIL** — strict error mode
-- **SLOW_OPERATION_LOGGING** — slow operation logging
-- **UNATTENDED_RETRY** — unattended retry
-- **ALLOW_TEST_VERSIONS** — allow test versions
-### Infrastructure
-- Added `src/utils/systemThemeWatcher.ts` — OSC 11 terminal theme detection and real-time monitoring
-- Cumulative 33/87 feature flags enabled
-## [1.0.3] - 2026-04-02
-### New Features
-- **COMMIT_ATTRIBUTION** — tracks Claude's contribution ratio per commit, PR description auto-appends attribution trailer
-- **AWAY_SUMMARY** — displays summary of what happened while user was away
-- **COMPACTION_REMINDERS** — efficiency reminders during context compaction
-- **HOOK_PROMPTS** — allows hooks to request user input
-- **BASH_CLASSIFIER** — shell command safety classifier
-- **EXTRACT_MEMORIES** — auto-extracts persistent memories from conversations
-- **SHOT_STATS** — session statistics panel
-- **PROMPT_CACHE_BREAK_DETECTION** — detects prompt cache invalidation
-- **ULTRATHINK** — deep thinking mode
-- **MCP_RICH_OUTPUT** — MCP tool rich text output
-- **CONNECTOR_TEXT** — connector text enhancement
-- **NATIVE_CLIPBOARD_IMAGE** — native clipboard image support
-- **NEW_INIT** — improved project initialization flow
-- **DUMP_SYSTEM_PROMPT** — debug system prompt export
-- **BREAK_CACHE_COMMAND** — `/break-cache` command
-- **BUILTIN_EXPLORE_PLAN_AGENTS** — built-in Explore/Plan Agents
-### Infrastructure
-- Added `src/utils/attributionHooks.ts`, `attributionTrailer.ts`, `postCommitAttribution.ts` — three attribution modules
-## [1.0.2] - 2026-04-02
-### New Features
-- **QUICK_SEARCH** — `Ctrl+P` quick file open in fullscreen mode, `Ctrl+Shift+F` global symbol/content search
-- **MESSAGE_ACTIONS** — copy, edit, retry and other actions on messages in fullscreen mode
-- **FORK_SUBAGENT** — `/fork <directive>` session fork, child Agent inherits full conversation context and executes tasks in parallel
-- **HISTORY_PICKER** — `Ctrl+R` opens history search dialog, replacing the previous inline search
-### Infrastructure
-- Added `src/commands/fork/` command module and `UserForkBoilerplateMessage` UI component
-## [1.0.1] - 2026-04-02
-### New Features
-- **BUDDY virtual pet companion** — `/buddy hatch` hatches an exclusive coding pet, 18 species, 5 rarities, random attributes
-  - `/buddy hatch` hatch · `/buddy pet` pet · `/buddy stats` stats · `/buddy release` release
-  - Pet comments in cute language based on conversation context, supports multilingual auto-switching
-  - Re-hatching after release gives a different pet (generation counter)
-- **TOKEN_BUDGET** — use `+500k` or `use 2M tokens` in prompts to set token budget, auto-tracks usage
-- **STREAMLINED_OUTPUT** — environment variable `CLAUDE_CODE_STREAMLINED_OUTPUT=true` enables streamlined output
-### Fixes
-- **Build system feature flags fix** — `scripts/build.ts` now correctly reads `bunfig.toml`'s `[bundle.features]` and passes them to the `Bun.build()` API; previously all `feature()` calls defaulted to `false`
-### Infrastructure
-- Added `scripts/compile.ts` replacing bare `bun build --compile`, ensuring compiled binary correctly applies feature flags
-- Added `src/buddy/companionObserver.ts` context-aware pet reaction system
-- Added `src/commands/buddy/` complete command module
-## [1.0.0] - 2026-03-31
-- Initial release: LegnaCode CLI v1.0.0
-- Built on the Claude Code CLI open-source edition
-- Brand adaptation and customization
+# Changelog
+🌐 [中文文档](./CHANGELOG.zh-CN.md)
+All notable changes to LegnaCode CLI will be documented in this file.
+## [1.5.5] - 2026-04-21
+### Bug Fixes
+- **WebUI SSE timeout** — Bun.serve `idleTimeout` raised to 300s; SSE streaming no longer drops after 10s.
+- **WebUI controller double-close crash** — Guard `sendEvent` and `controller.close()` against repeated invocation after client disconnect.
+## [1.5.4] - 2026-04-21
+Republish of 1.5.3 with all platform binaries in sync.
+## [1.5.3] - 2026-04-21
+### Features
+- **Hermes Self-Evolution Loop** — Automatic learning closed loop: repeated tool patterns (3x) auto-generate SKILL.md via side-channel LLM; behavior corrections auto-write to `.legna/memory/`; no user confirmation needed. Background Review Agent extracts experience insights after each session.
+- **Qwen Model Adapter** — Dedicated adapter for Qwen full series (qwen-plus, qwen-max, qwen-turbo, qwen-coder-plus, qwq-plus, qwen3-235b). Supports `thinking_budget` mapping, DashScope server-side web search (`enable_search`), `reasoning_content` streaming, and `content_filter` stop reason.
+- **WebUI Chat Viewer** — New "聊天记录" panel in admin WebUI. Browse session history with full message rendering, collapsible thinking blocks, tool call visualization (input/output/error), and auto-scroll. Backend `/api/:scope/sessions/:id/messages` endpoint reads JSONL session files.
+- **WebUI Live Chat** — `legna admin` WebUI now supports live chat via SSE streaming. Send messages, see streaming responses with thinking/tool-use visualization. Note: each message starts a new independent session (no multi-turn conversation); intended for quick API connectivity testing, not as a full chat client.
+- **Skill Auto-Create** — `SkillPatternDetector.record()` was already wired but results were never surfaced. Now auto-creates skills from detected patterns and notifies user after the fact.
+- **Skill Improvement Path B** — `skillImprovement` no longer gated to active skill execution. General conversation learning detects workflow preferences, behavior corrections, and coding style preferences every 10 user messages.
+- **Nudge System** — Counter-driven session learning summary. Reports what was automatically learned (skills created, corrections captured, insights recorded) instead of suggesting the user go learn.
+### Improvements
+- **onPreCompress Enhanced** — Working state extraction added alongside existing exchange pair extraction. Captures current task, key decisions, file paths, and error patterns before context compression. High-priority drawer written to DrawerStore.
+- **Skill Version Backup** — `applySkillImprovement` now backs up current SKILL.md to `.versions/` before overwriting. Changelog with last 20 versions maintained automatically.
+- **`/skillify` Unlocked** — Removed `USER_TYPE === 'ant'` gate. All users can now capture session workflows as reusable skills.
+### Bug Fixes
+- **WebUI inline script crash** — Fixed `Unexpected token '<'` error caused by unescaped `</` sequences in inlined JavaScript. JS and CSS are now served as separate files (`/__admin__/app.js`, `/__admin__/app.css`) instead of being inlined into `<script>` tags.
+## [1.5.2] - 2026-04-20
+### Performance
+- **Async CodeGraph** — `build()` and `walkDir()` converted from sync to async, yielding the event loop every 50 files. Added `maxDepth=10` depth limit and `visitedInodes` symlink loop protection. `save()` now uses async `writeFile`.
+- **undoTracker size guard** — Added 1MB file size limit; files exceeding it skip undo snapshot recording (prevents OOM). `readFileSync` → async `readFile`.
+- **Async error file pre-injection** — `extractErrorFiles` converted from `existsSync`+`readFileSync` to async `access`+`readFile`.
+- **stripCode dedup** — `magicKeywords.ts` reduced `stripCode()` from 3-4 calls to 1, passing the result to all downstream functions.
+- **FileMemoryProvider TTL cache** — `searchSolutions` and fallback file search now use 60s TTL cache, avoiding repeated disk reads on every prefetch.
+- **OML_SESSION_GUIDANCE cache** — `attachments.ts` dynamic import cached at module level after first load.
+- **frustrationHint patterns hoisted** — Regex array moved from function body to module-level constant.
+### i18n
+- **Compacting status messages localized** — "Compacting context…" → "凝练上下文…", "Compacting conversation" → "精炼对话中" for Chinese users.
+- **Turn completion verbs localized** — New `getTurnCompletionVerbs()` function; Chinese users see "烹制了 5s" instead of "Baked for 5s".
+### Cleanup
+- Deleted dead code `src/commands/undo.ts` (was never registered in command list).
+- Fixed dead conditional in `extractImports`.
+## [1.5.1] - 2026-04-19
+### Features
+- **Proactive skill invocation** — Wired `OML_SESSION_GUIDANCE` (the "1% rule") into the `skill_listing` attachment. The AI now proactively considers available skills before every response, instead of only responding to explicit `/slash` commands.
+- **Frontend/design auto-guidelines** — New `designPrompt.ts` detects frontend intent (UI, prototype, design exploration) from user input and transparently injects layered design guidelines (oklch colors, responsive layout, animation best practices, design exploration methodology). Zero user action required.
+- **Enhanced designer agent** — `/oml:designer` now carries a full design methodology prompt (oklch palettes, mobile-first, ARIA accessibility, 3+ variation exploration) instead of a one-line description.
+### Bug Fixes
+- **Skills were never proactively used** — `OML_SESSION_GUIDANCE` was defined in `superpowers.ts` but never imported or injected anywhere. Now wired into the skill listing attachment.
+## [1.5.0] - 2026-04-19
+### Bug Fixes
+- **Fix REPL startup deadlock** — The `/undo` command was registered via static `import` in `commands.ts`, creating a circular dependency (`commands.ts` → `undo.ts` → `commands.ts`) that caused Bun's module loader to deadlock. The REPL would hang with no output on launch. Fixed by removing the static import entirely. The `/undo` feature remains available via `src/services/undoTracker.ts` (wired into Edit/Write tools) but is no longer registered as a slash command to avoid the circular dependency.
+### Features (carried from 1.4.8/1.4.9)
+- **AtomCode intelligence fusion** — Pangu CJK spacing, negative feedback detection, tool call loop detection, error file pre-injection, first-read full file
+- **OpenAI-compatible bridge adapter** — Anthropic ↔ OpenAI format translation for DeepSeek/Qwen/GLM/Ollama/vLLM/LM Studio
+- **Code Graph** — Regex-based symbol index + file dependency graph (TS/JS/Python/Go/Rust)
+- **Parallel File Edit** — One sub-agent per file with sibling skeletons
+- **Workflow Engine** — Structured markdown step execution with checks and dependencies
+- **Cross-session knowledge** — Auto-writes `.legna/knowledge.md` on session end
+- **Baseline builds** — No-AVX binaries for older x64 CPUs (darwin-x64-baseline, linux-x64-baseline)
+## [1.4.9] - 2026-04-17
+### Features
+- **Baseline (no-AVX) builds** — New platform packages for older x64 CPUs without AVX instruction set support:
+  - `@legna-lnc/legnacode-darwin-x64-baseline` — macOS Intel (pre-2011 or Hackintosh without AVX)
+  - `@legna-lnc/legnacode-linux-x64-baseline` — Linux x64 servers/VMs without AVX
+  - Fixes `warn: CPU lacks AVX support, strange crashes may occur` error
+  - Install: `npm i -g @legna-lnc/legnacode-darwin-x64-baseline` (use directly, not via main package)
+## [1.4.8] - 2026-04-17
+### Features
+- **AtomCode intelligence fusion (Layer A)** — Lightweight agent intelligence, zero new dependencies:
+  - **Pangu CJK spacing** — Auto-inserts spaces between CJK and ASCII in Markdown rendering
+  - **Negative feedback detection** — Detects frustration ("still broken"/"错了"/"まだ壊れ"), injects strategy-shift hint (EN/ZH/JA)
+  - **Tool call loop detection** — Same (tool, args) 3+ times → blocks. Resets per user message
+  - **Error file pre-injection** — Bash fail → extracts file paths from stderr, auto-reads first 30 lines
+  - **First-read full file** — First encounter ignores offset/limit, forces full read
+- **OpenAI-compatible bridge adapter (Layer B1)** — Full Anthropic ↔ OpenAI format translation:
+  - Message format: `tool_use` ↔ `tool_calls`, `tool_result` ↔ `role: "tool"`
+  - Tool schema: `input_schema` ↔ `function.parameters`
+  - JSON repair for weak models (markdown fences, trailing commas, unbalanced brackets)
+  - Supports: OpenAI, DeepSeek, Qwen, GLM, SiliconFlow, Ollama, vLLM, LM Studio
+  - Activate: `OPENAI_COMPAT_BASE_URL` + `OPENAI_COMPAT_API_KEY` env vars
+- **Code Graph (Layer B2)** — Regex-based symbol index + file dependency graph:
+  - Languages: TypeScript/TSX, JavaScript, Python, Go, Rust
+  - Incremental mtime updates, persisted to `<cwd>/.legna/.palace/graph.json`
+  - **Wired:** auto-builds on session start, injects file summaries into prefetch context
+- **Parallel File Edit (Layer B3)** — "One sub-agent per file" execution model:
+  - Target file full text + sibling skeletons + interface contracts
+  - **Wired:** integrated into `/dispatch` skill prompt with parallel edit instructions
+- **Workflow Engine (Layer B4)** — Structured step execution:
+  - Markdown `## Step N:` format with checks, failure handling, dependencies
+  - **Wired:** WorkflowTool now parses steps, shows status, substitutes args
+- **/undo command** — Reverts the last file edit (Edit or Write tool):
+  - Tracks original content before each edit, max 20 entries per session
+  - New file creation → undo deletes the file
+- **Cross-session knowledge persistence** — Auto-writes `<cwd>/.legna/knowledge.md`:
+  - Extracts key decisions/actions from last 10 assistant messages on session end
+  - Appends timestamped entries, caps at 50KB
+- **Enhanced compiler error detection** — Extended error file pre-injection:
+  - Now matches compiler-style paths (`file.ts:42`, `file.py(10)`) in addition to standard paths
+## [1.4.7] - 2026-04-16
+### Features
+- **claude-mem memory intelligence fusion** — Ported 5 lightweight techniques from claude-mem's persistent memory system into DrawerStore, zero new dependencies:
+  - **Content-hash deduplication** — `sha256(wing + room + content)` with 30-second window prevents duplicate observations during rapid compaction cycles
+  - **Token economics tracking** — Each drawer records `discoveryTokens` (cost to create) and `readTokens` (accumulated recall cost) for memory ROI analysis
+  - **Relevance feedback** — `relevanceCount` incremented on each search hit; frequently recalled memories get up to +100% importance boost via `importance * (1 + 0.1 * min(count, 10))`
+  - **90-day time decay** — `max(0.3, 1.0 - age_days / 90)` applied to both search similarity and importance ranking. Old memories fade but never fully disappear
+  - **Privacy tag filtering** — `<private>...</private>` content stripped to `[REDACTED]` before memory extraction. Zero config, just wrap sensitive text in tags
+### Architecture
+- Modified `src/memdir/vectorStore/types.ts` — Drawer gains `discoveryTokens`, `readTokens`, `relevanceCount`, `contentHash` fields
+- Modified `src/memdir/vectorStore/drawerStore.ts` — Schema migration (4 new columns), content-hash dedup in upsert, relevance feedback in search, time decay in search + topByImportance
+- Modified `src/memdir/vectorStore/exchangeExtractor.ts` — `stripPrivate()` applied before pair extraction
+## [1.4.6] - 2026-04-16
+### Bug Fixes
+- **OML skill crash fix** — All 40 OML skills (16 superpowers + 5 orchestrators + 19 agents) returned `string` instead of `ContentBlockParam[]` from `getPromptForCommand`, causing `result.filter is not a function` crash on `/ultrawork`, `/ralph`, `/autopilot`, etc. Now wrapped as `Promise<[{ type: 'text', text }]>`.
+- **Statusline writes to wrong config dir** — `statuslineSetup` agent hardcoded `~/.claude/settings.json` and `~/.claude/statusline-command.sh`. Fixed to `~/.legna/`.
+### Improvements
+- **Plans moved to project-local** — Default plan directory changed from `~/.legna/plans/` to `<cwd>/.legna/plans/`. Plans now live alongside the project they belong to.
+- **Auto-memory moved to project-local** — Default auto-memory path changed from `~/.legna/projects/<slug>/memory/` to `<cwd>/.legna/memory/`. First startup auto-migrates files from the legacy global path (non-destructive, never overwrites).
+- **Compound engineering seamless fusion** — Knowledge compounding from compound-engineering-plugin, injected into 3 existing automation points with zero new commands:
+  - `onPreCompress`: high-value exchange pairs auto-written to `docs/solutions/` (opt-in via `mkdir docs/solutions`)
+  - `prefetch`: auto-searches `docs/solutions/` for past learnings when user asks related questions
+  - `magicKeywords`: deep scope detection (refactor/migrate/architecture) appends a lightweight compound hint
+- **Legacy path comments cleaned** — Updated stale `~/.claude/projects/` references in memdir, extractMemories, settings types
+## [1.4.5] - 2026-04-13
+### Features
+- **OpenViking content tiering fusion** — Ported L0/L1/L2 three-tier content grading from OpenViking's context database:
+  - **Content Tiering** — Each drawer auto-generates L0 (one-sentence summary, ~25 words) and L1 (core overview, ~200 words) at upsert time. L2 is the full verbatim content.
+  - **Budget-aware wake-up** — `wakeUp()` now accepts a token budget (default 800) and greedily fills it with L1 content, degrading to L0 when budget is tight.
+  - **Budget-capped recall** — New `recallWithBudget()` method: L2→L1→L0 degradation strategy ensures recall never exceeds character budget.
+  - **CJK-aware token estimation** — `estimateTokens()` handles mixed CJK/Latin text.
+  - **SQLite schema migration** — Existing DrawerStore databases auto-migrate with `ALTER TABLE ADD COLUMN`.
+  - **Fixed recallByTopic()** — Now passes actual query for vector ranking instead of empty string.
+## [1.4.4] - 2026-04-11
+### Improvements
+- **Status messages moved to spinner line** — autocompact / output truncated / interrupted status messages no longer insert system messages into the conversation; they now display temporarily on the spinner animation line, flashing briefly without polluting context
+- **ToolUseContext adds setSpinnerMessage** — generic spinner text callback allowing the query loop to update spinner status at any time
+- **LegnaCode vs Claude Code comparison doc** — added [COMPARISON.md](./COMPARISON.md) with 60+ item-by-item comparison across 9 categories
+## [1.4.3] - 2026-04-11
+### Features
+- **mempalace memory architecture integration** — ported mempalace core memory system, pure TypeScript implementation, zero external dependencies:
+  - **DrawerStore** — SQLite-persisted vector memory storage + WAL audit log, deterministic drawer ID (sha256 idempotent upsert)
+  - **TF-IDF vectorizer** — pure TS implementation (Porter stemming + cosine similarity), <10K drawer search <5ms
+  - **4-layer memory stack** — L0 identity (~100 tokens) + L1 top drawers (~500-800 tokens) loaded every turn, L2/L3 recalled on demand. Per-turn tokens reduced from ~8K to ~800 (~88% savings)
+  - **Temporal knowledge graph** — SQLite entity-relation storage, supports triples with validity periods and point-in-time queries
+  - **Room auto-classification** — 6 categories (facts/decisions/events/discoveries/preferences/advice) with keyword scoring
+  - **Exchange pair extractor** — Q+A paired chunking + 5-category tag scoring (decisions/preferences/milestones/problems/emotional)
+  - **Auto-migration** — automatically migrates existing .legna/memory/*.md files to DrawerStore on first startup
+  - **PreCompact memory save** — automatically extracts high-value exchange pairs to DrawerStore before compaction, preventing memory loss
+### Architecture
+- Added `src/memdir/vectorStore/` — complete vector memory system (8 files)
+  - `types.ts` — Drawer, SearchResult, MetadataFilter types
+  - `tfidfVectorizer.ts` — TF-IDF + Porter stemming + cosine similarity
+  - `drawerStore.ts` — SQLite persistence + WAL + vector search
+  - `roomDetector.ts` — content auto-classification
+  - `layeredStack.ts` — 4-layer memory stack
+  - `knowledgeGraph.ts` — temporal knowledge graph
+  - `exchangeExtractor.ts` — exchange pair extraction + tag scoring
+  - `migration.ts` — .md → DrawerStore auto-migration
+- Upgraded `src/memdir/providers/FileMemoryProvider.ts` — DrawerStore + LayeredStack backend
+- Wired `src/services/compact/autoCompact.ts` — calls onPreCompress before compaction
+## [1.4.2] - 2026-04-11
+### Features
+- **verbose enabled by default** — users now see full tool execution progress and status information by default
+- **Token/Timer instant display** — removed 30-second delay, token count and elapsed time shown from second 1
+- **Autocompact status visible** — displays "Compacting conversation context..." system message during conversation compaction
+- **Interrupt reason visible** — shows abort reason on interruption (streaming and tool_execution phases)
+- **Output truncated retry prompt** — displays retry progress during max output tokens recovery
+- **Tool execution logging** — StreamingToolExecutor outputs current tool name and queue depth
+- **Microcompact/Snip logging** — added debug logging for compaction operations
+- **ForkedAgent startup logging** — outputs label and ID when child agent starts
+### Bug Fixes
+- **Apple Terminal notification logic fix** — bell is now sent only when bell is not disabled (logic was previously inverted)
+## [1.4.0] - 2026-04-11
+### Features
+- **MiniMax deep native integration** — when using MiniMax models with `MINIMAX_API_KEY` configured, automatically registers 6 native multimodal tools:
+  - `MiniMaxImageGenerate` — image generation (POST /v1/image_generation)
+  - `MiniMaxVideoGenerate` — video generation + async polling (POST /v1/video_generation)
+  - `MiniMaxSpeechSynthesize` — text-to-speech (POST /v1/t2a_v2)
+  - `MiniMaxMusicGenerate` — music generation (POST /v1/music_generation)
+  - `MiniMaxVisionDescribe` — image understanding VLM (POST /v1/coding_plan/vlm)
+  - `MiniMaxWebSearch` — web search (POST /v1/web_search)
+- **MiniMax auth command** — `/auth-minimax` command to configure API key, persisted to `~/.legna/minimax-credentials.json`
+- **MiniMax tool schema export** — `schemaExport.ts` supports exporting Anthropic-compatible tool schemas
+- **MiniMax multimodal skill pack** — 5 built-in skills (image/video/speech/music/pipeline) guiding AI to orchestrate multimodal workflows
+- **Smart model routing** — heuristic routing to fast/default/strong model tiers based on prompt complexity
+- **Autonomous skill detection** — detects repetitive tool call patterns and prompts users to save as reusable skills
+- **Context compression enhancements**:
+  - Tool output pre-pruning — large tool_result blocks auto-trimmed before compact (head + tail preserved)
+  - Budget pressure injection — injects hints into tool results when context usage exceeds 80%, guiding the model to wrap up
+- **RPC subprocess tool execution** — Unix Domain Socket RPC server + stub generator + code execution runner; AI-generated scripts can call back LegnaCode tools (Bash/Read/Write/Edit/Glob/Grep/WebFetch) via RPC, compressing multi-step operations into a single inference
+- **Memory Provider plugin system** — abstract base class + registry + default FileMemoryProvider; supports one external provider running in parallel with built-in memory, full lifecycle (initialize/prefetch/syncTurn/shutdown) + optional hooks (onTurnStart/onSessionEnd/onPreCompress/onDelegation)
+- **Cross-session memory search** — `/recall` command searches historical session JSONL files with keyword matching + relevance ranking
+- **Worker thread pool** — large file operations / batch searches can be offloaded to worker threads, avoiding main thread blocking
+### Architecture
+- Added `src/tools/MiniMaxTools/` — complete MiniMax multimodal tool directory (client, endpoints, 6 buildTool tools, conditional registration, schema export)
+- Added `src/services/rpc/` — RPC subprocess tool execution (rpcServer.ts, stubGenerator.ts, codeExecutionRunner.ts)
+- Added `src/memdir/providers/` — Memory Provider plugin system (MemoryProvider.ts abstract base class, FileMemoryProvider.ts default implementation, registry.ts registry)
+- Added `src/services/modelRouter.ts` — task complexity estimation + model tier routing
+- Added `src/services/skillAutoCreate.ts` — tool call pattern detector, integrated into toolExecution.ts
+- Added `src/services/compact/toolOutputPruner.ts` — tool output pre-pruning, integrated into autoCompact.ts
+- Added `src/services/compact/budgetPressure.ts` — context budget pressure injection, integrated into query.ts
+- Added `src/services/sessionSearch.ts` — cross-session search engine
+- Added `src/commands/recall/` — `/recall` command
+- Added `src/commands/auth/` — `/auth-minimax` command
+- Added `src/skills/builtin-minimax/` — 5 MiniMax multimodal skill files
+- Added `src/utils/workerPool.ts` — worker thread pool
+## [1.3.7] - 2026-04-09
+### Bug Fixes
+- **Resume session detection** — `legna resume` failed to discover sessions written to `<project>/.legna/sessions/` since v1.3.0. `getStatOnlyLogsForWorktrees()` only scanned the global `~/.legna/projects/`; it now also scans the project-local sessions directory, consistent with `fetchLogs()` behavior
+- **Interrupted diagnostics logging** — added abort reason + call stack logging at `onCancel()` and `query.ts` interrupt points; traceable under `--verbose` mode
+### Enhancements
+- **Priority-now interrupt visibility** — when a queued command interrupts the current task, the command summary is logged to debug log instead of silently aborting
+- **Background task status visibility** — footer pill shows real-time activity summary for a single background agent (latest tool + token stats); task completion notification includes progress statistics
+### Architecture
+- `src/utils/sessionStorage.ts` — `getStatOnlyLogsForWorktrees()` Path A/B both include `.legna/sessions/` scanning
+- `src/query.ts` — abort reason logging added at both `createUserInterruptionMessage` call sites
+- `src/screens/REPL.tsx` — `onCancel()` call stack logging, priority-now useEffect logs command summary
+- `src/tasks/pillLabel.ts` — single agent task displays `getActivitySummary()` real-time activity
+- `src/tasks/LocalMainSessionTask.ts` — `completeMainSessionTask` captures progress, notification includes statistics
+## [1.3.6] - 2026-04-09
+### Bug Fixes
+- **Windows Edit tool path separator false positive** — fixed [#7935](https://github.com/anthropics/claude-code/issues/7935): on Windows, after reading a file with forward slashes (`D:/path`), Edit/MultiEdit tools reported "File has been unexpectedly modified" error. Root cause: `path.normalize()` does not always convert `/` to `\` in certain runtimes (Bun compiled binary + Git Bash/MINGW environment), causing FileStateCache key mismatch
+  - `FileStateCache` added `normalizeKey()` — explicitly replaces `/` with the native separator (Windows: `\`) after `path.normalize()`, ensuring `D:/foo` and `D:\foo` always hit the same cache entry
+  - `expandPath()` added `ensureNativeSeparators()` — all returned paths force backslashes on Windows as a defensive fix
+### Architecture
+- `src/utils/fileStateCache.ts` — `normalizeKey()` replaces bare `normalize()`, imports `sep`
+- `src/utils/path.ts` — `ensureNativeSeparators()` wraps all `normalize()`/`resolve()`/`join()` return values
+## [1.3.5] - 2026-04-07
+### Bug Fixes
+- **SessionStart hook error** — OML's SessionStart hook used `type: 'prompt'`, but the SessionStart phase has no `toolUseContext` (LLM call context), causing a guaranteed crash. Removed SessionStart hook; skill guidance is now exposed through skill descriptions
+- **Windows alt-screen rendering flicker** — in alt-screen mode, `fullResetSequence_CAUSES_FLICKER` was still triggered (viewport changes, scrollback detection, etc.), causing full-screen clear + redraw flicker. Added `altScreenFullRedraw()` method; in alt-screen mode, uses simple `CSI 2J + CSI H` (erase screen + cursor home) instead of `clearTerminal`'s Windows legacy path
+- **Windows drainStdin** — previously skipped stdin draining entirely on Windows; residual mouse events caused input field corruption. Changed to flush buffered input events by toggling raw mode
+### Architecture
+- `src/ink/log-update.ts` — 5 `fullResetSequence_CAUSES_FLICKER` call sites now check `altScreen`, added `altScreenFullRedraw()` method
+- `src/ink/ink.tsx` — Windows `drainStdin` alternative (toggle raw mode)
+- `src/plugins/bundled/oml/definition.ts` — removed SessionStart hook, OML upgraded to 1.2.0
+## [1.3.4] - 2026-04-07
+### New Features
+- **OML Superpowers engineering discipline** — integrated obra/superpowers core skills, enforcing strict software engineering workflows for AI
+  - `/verify` — completion verification discipline: cannot claim completion without fresh evidence
+  - `/tdd` — TDD enforcement: RED-GREEN-REFACTOR, write tests before code
+  - `/debug` — 4-stage systematic debugging, question architecture after 3 failures
+  - `/brainstorm` — Socratic design: hard gate, no implementation allowed until design is approved
+  - `/write-plan` — break design into 2-5 minute tasks, zero placeholders
+  - `/sdd` — sub-agent driven development: implement → spec review → quality review, 3 stages
+  - `/exec-plan` — load plan file and execute tasks sequentially
+  - `/dispatch` — parallel sub-agent dispatch
+  - `/code-review` — dispatch reviewer sub-agent
+  - `/worktree` — Git worktree isolated development
+  - `/finish-branch` — branch wrap-up (merge/PR/keep/discard)
+- **SessionStart skill guidance** — automatically injects OML skill guidance prompt at session start ("1% rule")
+- OML plugin version upgraded to 1.1.0, 35 built-in skills total
+### Architecture
+- `src/plugins/bundled/oml/superpowers.ts` — 11 engineering discipline skills + SessionStart guidance
+- `src/plugins/bundled/oml/definition.ts` — appended superpowers skills + SessionStart hook
+## [1.3.3] - 2026-04-07
+### New Features
+- **OML (Oh-My-LegnaCode) smart orchestration layer** — built-in oh-my-claudecode core functionality, works out of the box
+  - 5 orchestration skills: `/ultrawork` (parallel execution), `/ralph` (persistent loop), `/autopilot` (fully autonomous), `/ralplan` (plan then execute), `/plan-oml` (structured planning)
+  - 19 specialized agent skills: `/oml:explore`, `/oml:planner`, `/oml:architect`, `/oml:executor`, `/oml:verifier`, etc.
+  - Magic Keywords auto-detection: when prompt contains keywords like ultrawork/ralph/autopilot/ultrathink, orchestration directives are auto-injected (supports CJK and Vietnamese)
+  - Can be enabled/disabled via `/plugin` UI (`oml@builtin`, enabled by default)
+  - `OML_BUILTIN` feature flag controls compile-time DCE
+### Bug Fixes
+- **Windows Terminal Fullscreen** — automatically enables alt-screen mode in `WT_SESSION` environment, completely eliminating the cursor-up viewport yank bug (microsoft/terminal#14774). Covers WSL-in-Windows-Terminal. `CLAUDE_CODE_NO_FLICKER=0` to opt-out
+### Architecture
+- `src/plugins/bundled/oml/` — OML plugin module (definition, skills, agents, magicKeywords)
+- `src/plugins/bundled/index.ts` — registered OML builtin plugin
+- `src/utils/processUserInput/processUserInput.ts` — magic keyword detection integration point
+- `src/utils/fullscreen.ts` — Windows Terminal fullscreen condition
+## [1.3.2] - 2026-04-07
+### Breaking Changes
+- **Disabled HISTORY_SNIP** — `bunfig.toml` feature flag set to false, compile-time DCE removes all snip-related code (SnipTool, snipCompact, snipProjection, force-snip command, attachments nudge). Auto-compact is unaffected; context management reverts to the original mechanism
+### Bug Fixes
+- **Windows Terminal streaming text** — no longer disables streaming text display for all Windows; now only disabled under legacy conhost. Windows Terminal (detected via `WT_SESSION` environment variable) restores normal streaming rendering
+## [1.3.1] - 2026-04-06
+### Bug Fixes
+- **Snip-aware context window** — 1M models are no longer prematurely snipped; `KEEP_RECENT` changed from hardcoded 10 to dynamic calculation (1M: 200, 500K: 100, 200K: 10)
+- **Snip nudge frequency** — 1M model nudge threshold raised from 20 to 100 messages
+- **branch command branding** — `/branch` resume prompt changed from `claude -r` to `legna -r`
+- **admin version fallback** — displays correct version number when running from source
+### Architecture
+- `src/services/compact/snipCompact.ts` — added `getSnipThresholds(model)` dynamic threshold function; `snipCompactIfNeeded` and `shouldNudgeForSnips` gained model parameter
+- `src/query.ts` / `src/QueryEngine.ts` / `src/commands/force-snip-impl.ts` — pass model parameter
+## [1.3.0] - 2026-04-04
+### New Features
+- **Project-local storage** — sessions, skills, memory, rules, and settings all moved down to `<project>/.legna/` directory
+  - New sessions written to `<project>/.legna/sessions/<uuid>.jsonl`, traveling with the project
+  - Project-level skills/rules/settings/agent-memory/workflows unified under `.legna/`
+  - `.legna/` automatically added to `.gitignore`
+- **Global data migration** — automatically migrates from `~/.claude/` to `~/.legna/` on first startup (one-way)
+  - Migrates settings.json, credentials, rules, skills, agents, plugins, keybindings, etc.
+  - Does not overwrite existing files; writes `.migration-done` marker on completion
+  - `LEGNA_NO_CONFIG_SYNC=1` to disable
+- **`legna migrate` command** — manual data migration
+  - `--global` migrates global data only
+  - `--sessions` migrates current project sessions to local only
+  - `--all` migrates everything (default)
+  - `--dry-run` preview mode
+- **Three-level fallback reads** — automatically searches `.legna/` → `.claude/` → `~/.legna/` → `~/.claude/` when reading, zero-breakage backward compatibility
+### Architecture
+- `src/utils/legnaPathResolver.ts` — unified path resolution (PROJECT_FOLDER/LEGACY_FOLDER/resolveProjectPath)
+- `src/utils/ensureLegnaGitignored.ts` — auto-gitignore utility
+- `src/utils/envUtils.ts` — refactored global migration logic, removed old syncClaudeConfigToLegna
+- `src/utils/sessionStoragePortable.ts` — added getLocalSessionsDir/getLegacyProjectsDir, refactored resolveSessionFilePath
+- `src/utils/sessionStorage.ts` — session write path switched to project-local
+- `src/utils/listSessionsImpl.ts` — multi-source scan and merge (local + global + legacy)
+- `src/commands/migrate/` — CLI migration command
+## [1.2.1] - 2026-04-04
+### New Features
+- **Model Adapter Layer** — unified third-party model compatibility framework, auto-detects model/endpoint and applies corresponding transforms
+- **MiMo (Xiaomi) adapter** — api.xiaomimimo.com/anthropic, supports mimo-v2-pro/omni/flash (1M ctx)
+  - simplifyThinking + forceAutoToolChoice + normalizeTools + stripBetas + injectTopP(0.95) + stripCacheControl
+  - Handles content_filter / repetition_truncation stop_reason
+- **GLM (ZhipuAI) adapter** — open.bigmodel.cn/api/anthropic, supports glm-5.1/5/5-turbo/4.7/4.6/4.5, etc.
+  - Full standard transform suite, server-side auto-caching (strip cache_control)
+- **DeepSeek adapter** — api.deepseek.com/anthropic, supports deepseek-chat/coder/reasoner
+  - stripReasoningContent to avoid 400 errors, reasoner models auto-strip temperature/top_p
+- **Kimi (Moonshot) adapter** — api.moonshot.ai/anthropic, supports kimi-k2/k2.5/k2-turbo, etc.
+  - Preserves cache_control (Kimi supports prompt caching discount), stripReasoningContent
+- **MiniMax adapter** — api.minimaxi.com/anthropic (China) + api.minimax.io/anthropic (international)
+  - Supports MiniMax-M2.7/M2.5/M2.1/M2 full series (204K ctx), case-insensitive matching
+  - Deep compatibility: preserves metadata, tool_choice, cache_control, top_p (other adapters need strip/force)
+  - Only needs simplifyThinking + normalizeTools + stripBetas + stripUnsupportedFieldsKeepMetadata
+### Architecture
+- `src/utils/model/adapters/index.ts` — adapter registry + match/transform dispatch
+- `src/utils/model/adapters/shared.ts` — 12 shared transform functions (including new stripUnsupportedFieldsKeepMetadata)
+- `src/utils/model/adapters/{mimo,glm,deepseek,kimi,minimax}.ts` — 5 provider adapters
+- `src/services/api/claude.ts` — paramsFromContext() calls applyModelAdapter() at the end
+## [1.2.0] - 2026-04-03
+### New Features
+- **Sessions grouped by project** — WebUI session history panel groups sessions by project path
+- **resume command with cd** — copied resume command auto-includes `cd` to project directory (Windows uses `cd /d`)
+- **Migration supports session history** — config migration panel adds "also migrate session history" option, copies `projects/` directory
+- **Windows native compilation** — Windows binary now compiled natively on Windows
+### Fixed
+- Migration panel field names corrected to match actual settings.json fields
+## [1.1.10] - 2026-04-03
+### Fixed
+- **Windows compile script fix** — `scripts/compile.ts` correctly handles `.exe` suffix on Windows, fixing the issue where compiled output file could not be found
+- **Windows native binary recompiled and published** — recompiled native `legna.exe` using Windows-native Bun, replacing the previous cross-compiled version
+## [1.1.9] - 2026-04-03
+### Fixed
+- **postinstall auto-installs platform package** — added `npm/postinstall.cjs`; during `npm install`, automatically detects and installs the corresponding platform binary package from the official registry, completely solving the issue where optionalDependencies fails on Windows/mirror registries
+- **Force official registry** — postinstall uses `--registry https://registry.npmjs.org` to avoid 404 errors from unsynchronized mirrors (e.g., Taobao)
+- **bin wrapper simplified** — removed runtime auto-install logic, now guaranteed by postinstall
+## [1.1.8] - 2026-04-03
+### Fixed
+- **Windows npm global install missing platform package** — bin wrapper now auto-executes `npm install -g` for the corresponding platform package when it detects the package is not installed, no longer requiring manual user action
+- **bin wrapper path lookup optimization** — fixed scope directory path joining under global node_modules flat layout
+## [1.1.7] - 2026-04-03
+### Fixed
+- **Completely fixed Windows external module error** — cleared the compile external list; all stub modules (`@ant/*`, `@anthropic-ai/*`, native napi) are now bundled into the binary, no longer depending on runtime external modules
+## [1.1.6] - 2026-04-03
+### Fixed
+- **Windows external module error** — removed `@anthropic-ai/sandbox-runtime`, `@anthropic-ai/mcpb`, `@anthropic-ai/claude-agent-sdk`, `audio-capture-napi`, `color-diff-napi`, `modifiers-napi` from the compile external list, letting stub code bundle directly into the binary; Windows no longer reports `Cannot find module`
+- **bin wrapper multi-path lookup** — `npm/bin/legna.cjs` added global node_modules flat path and nested path fallback, improving cross-platform npm global install compatibility
+- **Version number automation** — added `scripts/bump.ts` for one-click sync of version numbers across package.json, bunfig.toml, webui/package.json, and optionalDependencies
+- **Release process automation** — rewrote `scripts/publish.ts` for one-click bump → build webui → compile all → publish npm
+## [1.1.5] - 2026-04-03
+### New Features
+- **WebUI admin panel** — `legna admin` launches a browser-based admin panel (HTTP server + React SPA, default port 3456), visual management of both `~/.claude/` and `~/.legna/` config directories
+- **Config editing** — edit API endpoint, API key, model mapping (Opus/Sonnet/Haiku), timeout, permission mode, language, and all other settings.json fields in the browser
+- **Config file switching** — lists settings*.json files, shows baseUrl/model, one-click swap to activate
+- **Session history browsing** — parses all session JSONL files under the projects directory, displays project path, slug, time, prompt count, and copy resume command
+- **Config migration** — Claude ↔ LegnaCode bidirectional migration, supports full or selective field migration (env/model/permissions, etc.), preview diff before migration
+- **npm cross-platform publishing** — bin wrapper (.cjs), compile-all cross-platform compilation (darwin/linux/win32), publish script
+- **OAuth disabled** — `isAnthropicAuthEnabled()` returns false, removed OAuth login flow
+### Fixed (1.1.1 ~ 1.1.5)
+- bin wrapper changed to `.cjs` to fix ESM `require` error
+- `optionalDependencies` platform package versions aligned
+- Terminal restored on admin server exit with screen clear
+- WebUI frontend inlined into binary, no longer depends on external `webui/dist/`
+- All package versions unified to 1.1.5
+### Architecture
+- Backend: `src/server/admin.ts` — Bun.serve REST API, SPA inlined as string constant
+- Frontend: `webui/` — React 18 + Vite + Tailwind SPA, tab-based scope switching
+- Inlining: `scripts/inline-webui.ts` → `src/server/admin-ui-html.ts`
+- CLI: `src/entrypoints/cli.tsx` — `admin` fast-path, zero extra module loading
+## [1.0.9] - 2026-04-03
+### New Features
+- **i18n multilingual completion** — completed ~100 missing hardcoded English strings across 9 files, covering Spinner, teammate tree, pill labels, keyboard shortcut hints, Tips, and all other UI areas
+- **Built-in styled status bar** — no external script configuration needed; displays directory, Git branch/sync status, model name (smart parsing to friendly name), colored context progress bar, and time by default; cross-platform compatible with Win/Mac/Linux
+- **Config auto-migration** — automatically syncs `~/.claude/settings.json` to `~/.legna/settings.json` on startup; prints warning without overwriting when both sides differ; `LEGNA_NO_CONFIG_SYNC=1` to disable
+### Changed
+- `~/.legna/` is now the preferred config directory, `~/.claude/` serves as compatibility fallback
+- Status bar model name auto-parsing: `Claude-Opus-4-6-Agentic[1m]` → `Opus 4.6`
+- `KeyboardShortcutHint` component "to" connector word internationalized (Chinese displays "→")
+### Files Changed
+| File | Changes |
+|------|---------|
+| `src/utils/i18n/zh.ts` | +50 translation entries |
+| `src/components/Spinner.tsx` | 7 i18n points |
+| `src/components/PromptInput/PromptInputFooterLeftSide.tsx` | 4 i18n points |
+| `src/components/design-system/KeyboardShortcutHint.tsx` | "to" internationalized |
+| `src/components/Spinner/teammateSelectHint.ts` | i18n |
+| `src/components/Spinner/TeammateSpinnerTree.tsx` | 6 i18n points |
+| `src/components/Spinner/TeammateSpinnerLine.tsx` | 7 i18n points |
+| `src/tasks/pillLabel.ts` | all pill labels i18n |
+| `src/services/tips/tipRegistry.ts` | 25 tips i18n |
+| `src/utils/builtinStatusLine.ts` | added: built-in status bar renderer |
+| `src/components/StatusLine.tsx` | integrated built-in status bar |
+| `src/utils/envUtils.ts` | config auto-migration logic |
+## [1.0.8] - 2026-04-02
+### New Features
+- **MONITOR_TOOL** — MCP server health monitoring tool, supports start/stop/status operations, background periodic ping to detect connection status
+- **WORKFLOW_SCRIPTS** — workflow automation system, reads `.claude/workflows/*.md` to execute multi-step workflows, `/workflows` command lists available workflows
+- **HISTORY_SNIP** — session history trimming, model can proactively call SnipTool to remove old messages and free context, `/force-snip` for forced trimming, UI retains full history while model view is filtered
+### Infrastructure
+- Added `src/tools/MonitorTool/MonitorTool.ts` — MCP monitoring tool (buildTool construction)
+- Added `src/tasks/MonitorMcpTask/MonitorMcpTask.ts` — monitoring background task lifecycle management
+- Added `src/components/permissions/MonitorPermissionRequest/` — monitoring permission UI
+- Added `src/components/tasks/MonitorMcpDetailDialog.tsx` — monitoring task detail dialog
+- Added `src/tools/WorkflowTool/WorkflowTool.ts` — workflow execution tool
+- Added `src/tools/WorkflowTool/createWorkflowCommand.ts` — workflow command scanning and registration
+- Added `src/tools/WorkflowTool/bundled/index.ts` — built-in workflow registration entry
+- Added `src/tools/WorkflowTool/WorkflowPermissionRequest.tsx` — workflow permission UI
+- Added `src/commands/workflows/` — `/workflows` slash command
+- Added `src/tasks/LocalWorkflowTask/LocalWorkflowTask.ts` — workflow background task (kill/skip/retry)
+- Added `src/components/tasks/WorkflowDetailDialog.tsx` — workflow detail dialog
+- Added `src/services/compact/snipCompact.ts` — trim trigger logic (rewrote stub)
+- Added `src/services/compact/snipProjection.ts` — model view message filtering
+- Added `src/tools/SnipTool/SnipTool.ts` — model-callable trimming tool
+- Added `src/tools/SnipTool/prompt.ts` — SnipTool constants and prompt
+- Added `src/commands/force-snip.ts` — `/force-snip` slash command
+- Added `src/components/messages/SnipBoundaryMessage.tsx` — trim boundary UI component
+- 3 feature flags flipped: MONITOR_TOOL, WORKFLOW_SCRIPTS, HISTORY_SNIP
+- Cumulative 47/87 feature flags enabled
+## [1.0.7] - 2026-04-02
+### New Features
+- **TERMINAL_PANEL** — `Alt+J` toggles built-in terminal panel (tmux persistent), TerminalCapture tool can read terminal content
+- **WEB_BROWSER_TOOL** — built-in web browsing tool, fetches web page content and extracts text
+- **TEMPLATES** — structured workflow template system, `legna new/list/reply` CLI commands, job status tracking
+- **BG_SESSIONS** — background session management, `legna ps/logs/attach/kill/--bg`, tmux persistence + PID file discovery
+### Infrastructure
+- Added `src/tools/TerminalCaptureTool/` — tmux capture-pane tool (2 files)
+- Added `src/tools/WebBrowserTool/WebBrowserTool.ts` — fetch + HTML text extraction
+- Added `src/jobs/classifier.ts` — workflow turn classifier
+- Added `src/cli/handlers/templateJobs.ts` — template CLI handler
+- Added `src/cli/bg.ts` — background session CLI (5 handlers)
+- Added `src/utils/taskSummary.ts` — periodic activity summary
+- Added `src/utils/udsClient.ts` — active session enumeration
+- Cumulative 44/87 feature flags enabled
+## [1.0.6] - 2026-04-02
+### New Features
+- **CACHED_MICROCOMPACT** — cache-aware tool result compression, deletes old tool_result via API cache_edits directive without breaking prompt cache
+- **AGENT_TRIGGERS** — `/loop` cron scheduling command + CronCreate/Delete/List tools, local scheduled task engine
+- **TREE_SITTER_BASH** — pure TypeScript bash AST parser (~4300 lines), used for command safety analysis
+- **TREE_SITTER_BASH_SHADOW** — tree-sitter vs legacy parser shadow comparison mode
+- **MCP_SKILLS** — auto-discovers and registers skill commands from MCP server `skill://` resources
+- **REACTIVE_COMPACT** — auto-triggers context compression on 413/overload errors
+- **REVIEW_ARTIFACT** — `/review` code review skill + ReviewArtifact tool
+### Infrastructure
+- Rewrote `src/services/compact/cachedMicrocompact.ts` (from stub to 150+ line full implementation)
+- Added `src/services/compact/cachedMCConfig.ts` — synchronous config module
+- Added `CACHE_EDITING_BETA_HEADER` to `src/constants/betas.ts`
+- Added `src/skills/mcpSkills.ts`, `src/services/compact/reactiveCompact.ts`
+- Added `src/tools/ReviewArtifactTool/`, `src/skills/bundled/hunter.ts`
+- Cumulative 40/87 feature flags enabled
+## [1.0.5] - 2026-04-02
+### New Features
+- **AGENT_TRIGGERS** — `/loop` cron scheduling command, CronCreate/Delete/List tools, local scheduled task engine
+- **TREE_SITTER_BASH** — pure TypeScript bash AST parser, used for command safety analysis
+- **TREE_SITTER_BASH_SHADOW** — tree-sitter vs legacy parser shadow comparison mode
+- **MCP_SKILLS** — auto-discovers and registers skill commands from MCP server `skill://` resources
+- **REACTIVE_COMPACT** — auto-triggers context compression on 413/overload errors
+- **REVIEW_ARTIFACT** — `/review` code review skill + ReviewArtifact tool + permission UI
+### Infrastructure
+- Added `src/skills/mcpSkills.ts` — MCP skill discovery module
+- Added `src/services/compact/reactiveCompact.ts` — reactive compression strategy
+- Added `src/tools/ReviewArtifactTool/` — code review tool
+- Added `src/components/permissions/ReviewArtifactPermissionRequest/` — review permission UI
+- Added `src/skills/bundled/hunter.ts` — /review skill registration
+- Cumulative 39/87 feature flags enabled
+## [1.0.4] - 2026-04-02
+### New Features
+- **ULTRAPLAN** — `/ultraplan` structured multi-step planning command
+- **VERIFICATION_AGENT** — auto-spawns verification Agent after batch task completion
+- **AUTO_THEME** — auto-switches dark/light theme by querying terminal background color via OSC 11
+- **AGENT_MEMORY_SNAPSHOT** — Agent memory snapshots
+- **FILE_PERSISTENCE** — file persistence tracking
+- **POWERSHELL_AUTO_MODE** — PowerShell auto mode
+- **HARD_FAIL** — strict error mode
+- **SLOW_OPERATION_LOGGING** — slow operation logging
+- **UNATTENDED_RETRY** — unattended retry
+- **ALLOW_TEST_VERSIONS** — allow test versions
+### Infrastructure
+- Added `src/utils/systemThemeWatcher.ts` — OSC 11 terminal theme detection and real-time monitoring
+- Cumulative 33/87 feature flags enabled
+## [1.0.3] - 2026-04-02
+### New Features
+- **COMMIT_ATTRIBUTION** — tracks Claude's contribution ratio per commit, PR description auto-appends attribution trailer
+- **AWAY_SUMMARY** — displays summary of what happened while user was away
+- **COMPACTION_REMINDERS** — efficiency reminders during context compaction
+- **HOOK_PROMPTS** — allows hooks to request user input
+- **BASH_CLASSIFIER** — shell command safety classifier
+- **EXTRACT_MEMORIES** — auto-extracts persistent memories from conversations
+- **SHOT_STATS** — session statistics panel
+- **PROMPT_CACHE_BREAK_DETECTION** — detects prompt cache invalidation
+- **ULTRATHINK** — deep thinking mode
+- **MCP_RICH_OUTPUT** — MCP tool rich text output
+- **CONNECTOR_TEXT** — connector text enhancement
+- **NATIVE_CLIPBOARD_IMAGE** — native clipboard image support
+- **NEW_INIT** — improved project initialization flow
+- **DUMP_SYSTEM_PROMPT** — debug system prompt export
+- **BREAK_CACHE_COMMAND** — `/break-cache` command
+- **BUILTIN_EXPLORE_PLAN_AGENTS** — built-in Explore/Plan Agents
+### Infrastructure
+- Added `src/utils/attributionHooks.ts`, `attributionTrailer.ts`, `postCommitAttribution.ts` — three attribution modules
+## [1.0.2] - 2026-04-02
+### New Features
+- **QUICK_SEARCH** — `Ctrl+P` quick file open in fullscreen mode, `Ctrl+Shift+F` global symbol/content search
+- **MESSAGE_ACTIONS** — copy, edit, retry and other actions on messages in fullscreen mode
+- **FORK_SUBAGENT** — `/fork <directive>` session fork, child Agent inherits full conversation context and executes tasks in parallel
+- **HISTORY_PICKER** — `Ctrl+R` opens history search dialog, replacing the previous inline search
+### Infrastructure
+- Added `src/commands/fork/` command module and `UserForkBoilerplateMessage` UI component
+## [1.0.1] - 2026-04-02
+### New Features
+- **BUDDY virtual pet companion** — `/buddy hatch` hatches an exclusive coding pet, 18 species, 5 rarities, random attributes
+  - `/buddy hatch` hatch · `/buddy pet` pet · `/buddy stats` stats · `/buddy release` release
+  - Pet comments in cute language based on conversation context, supports multilingual auto-switching
+  - Re-hatching after release gives a different pet (generation counter)
+- **TOKEN_BUDGET** — use `+500k` or `use 2M tokens` in prompts to set token budget, auto-tracks usage
+- **STREAMLINED_OUTPUT** — environment variable `CLAUDE_CODE_STREAMLINED_OUTPUT=true` enables streamlined output
+### Fixes
+- **Build system feature flags fix** — `scripts/build.ts` now correctly reads `bunfig.toml`'s `[bundle.features]` and passes them to the `Bun.build()` API; previously all `feature()` calls defaulted to `false`
+### Infrastructure
+- Added `scripts/compile.ts` replacing bare `bun build --compile`, ensuring compiled binary correctly applies feature flags
+- Added `src/buddy/companionObserver.ts` context-aware pet reaction system
+- Added `src/commands/buddy/` complete command module
+## [1.0.0] - 2026-03-31
+- Initial release: LegnaCode CLI v1.0.0
+- Built on the Claude Code CLI open-source edition
+- Brand adaptation and customization