From d1efce29718c7274853ec4880a57ed17f12fd4e7 Mon Sep 17 00:00:00 2001 From: Godopu Date: Mon, 24 Aug 2026 15:13:46 +0900 Subject: [PATCH] chore(release): bump skills and framework version to v2.2.1 --- .../skills/multi-agent-mux-create/SKILL.md | 2 +- .../multi-agent-mux-delegate-job/SKILL.md | 2 +- .agents/skills/multi-agent-mux-loop/SKILL.md | 2 +- .../skills/multi-agent-mux-monitor/SKILL.md | 2 +- .../multi-agent-mux-orc-onboard/SKILL.md | 2 +- .../skills/multi-agent-mux-resume/SKILL.md | 2 +- .../skills/multi-agent-mux-status/SKILL.md | 2 +- .agents/skills/multi-agent-mux-stop/SKILL.md | 2 +- VERSIONS.md | 35 +++++++++++++------ 9 files changed, 33 insertions(+), 18 deletions(-) diff --git a/.agents/skills/multi-agent-mux-create/SKILL.md b/.agents/skills/multi-agent-mux-create/SKILL.md index 5e5261b..54cb774 100644 --- a/.agents/skills/multi-agent-mux-create/SKILL.md +++ b/.agents/skills/multi-agent-mux-create/SKILL.md @@ -1,7 +1,7 @@ --- name: multi-agent-mux-create description: "Create a new agent session (claude, antigravity/agy) in a dedicated herdr session for context-preserving long-running work. Always creates a herdr session โ€” never backgrounds with nohup/disown. Writes the new session to .mam/agent-sessions.yaml. Use when you want to start a fresh agent (no prior UUID) for a new project workspace." -version: 2.2.0 +version: 2.2.1 author: godopu license: MIT platforms: [linux, macos] diff --git a/.agents/skills/multi-agent-mux-delegate-job/SKILL.md b/.agents/skills/multi-agent-mux-delegate-job/SKILL.md index f48fcaa..2609e01 100644 --- a/.agents/skills/multi-agent-mux-delegate-job/SKILL.md +++ b/.agents/skills/multi-agent-mux-delegate-job/SKILL.md @@ -1,7 +1,7 @@ --- name: multi-agent-mux-delegate-job description: "Delegate a unit of work to any autonomous agent (claude-code, hermes, agy, cline, codex, or a human) and observe it asynchronously over an MQTT event channel. Supported roles include orchestrator, worker, and reviewer." -version: 2.2.0 +version: 2.2.1 author: godopu license: MIT platforms: [linux, macos, windows] diff --git a/.agents/skills/multi-agent-mux-loop/SKILL.md b/.agents/skills/multi-agent-mux-loop/SKILL.md index 8feed70..b6b9526 100644 --- a/.agents/skills/multi-agent-mux-loop/SKILL.md +++ b/.agents/skills/multi-agent-mux-loop/SKILL.md @@ -1,7 +1,7 @@ --- name: multi-agent-mux-loop description: "Run an autonomous planning-execution-review loop using multiple agents (Planner, Creator, Reviewers) in the workspace. Automatically orchestrates plan discussion, code changes, and peer reviews until a unanimous PASS is achieved or the maximum iteration limit is reached." -version: 2.2.0 +version: 2.2.1 author: godopu license: MIT platforms: [linux, macos] diff --git a/.agents/skills/multi-agent-mux-monitor/SKILL.md b/.agents/skills/multi-agent-mux-monitor/SKILL.md index 782eac7..369f568 100644 --- a/.agents/skills/multi-agent-mux-monitor/SKILL.md +++ b/.agents/skills/multi-agent-mux-monitor/SKILL.md @@ -1,7 +1,7 @@ --- name: multi-agent-mux-monitor description: "Run a long-lived reconciler that watches .mam/agent-sessions.yaml against the actual herdr/agent runtime state and reconciles them. Use when you want live visibility into which agent sessions are running, which are dead, which have stale YAML entries, and which have new session ids that haven't been recorded yet. Runs as a persistent loop (`reconcile.sh --subscribe`) that keeps going until it times out, idles out, or is interrupted." -version: 2.2.0 +version: 2.2.1 author: godopu license: MIT platforms: [linux, macos] diff --git a/.agents/skills/multi-agent-mux-orc-onboard/SKILL.md b/.agents/skills/multi-agent-mux-orc-onboard/SKILL.md index 7474b89..49a3de5 100644 --- a/.agents/skills/multi-agent-mux-orc-onboard/SKILL.md +++ b/.agents/skills/multi-agent-mux-orc-onboard/SKILL.md @@ -1,7 +1,7 @@ --- name: multi-agent-mux-orc-onboard description: Register current or specified orchestrator session UUID into agent-sessions.yaml orchestrator_uuids list to prevent sub-agent discovery capture. -version: 2.2.0 +version: 2.2.1 author: godopu license: MIT platforms: [linux, macos] diff --git a/.agents/skills/multi-agent-mux-resume/SKILL.md b/.agents/skills/multi-agent-mux-resume/SKILL.md index 87e9187..1c0a6e5 100644 --- a/.agents/skills/multi-agent-mux-resume/SKILL.md +++ b/.agents/skills/multi-agent-mux-resume/SKILL.md @@ -1,7 +1,7 @@ --- name: multi-agent-mux-resume description: "Resume an existing agent (claude, antigravity/agy) conversation by UUID into a herdr session. Reads .mam/agent-sessions.yaml for the saved session/conversation id, spawns (or reuses) a herdr session of the matching name, and runs `claude -r ` or `agy --conversation ` inside. Use when you want to reattach to a previous session's context, or revive a session whose herdr died but the agent's conversation is still on disk." -version: 2.2.0 +version: 2.2.1 author: godopu license: MIT platforms: [linux, macos] diff --git a/.agents/skills/multi-agent-mux-status/SKILL.md b/.agents/skills/multi-agent-mux-status/SKILL.md index 1e57077..834c790 100644 --- a/.agents/skills/multi-agent-mux-status/SKILL.md +++ b/.agents/skills/multi-agent-mux-status/SKILL.md @@ -1,7 +1,7 @@ --- name: multi-agent-mux-status description: "Read-only instant snapshot of all agent herdr sessions โ€” name, YAML status, herdr alive, pane cmd/cwd, resume UUID on disk, and any drift. No mutation. Reuses reconcile.sh --dry-run for the diff logic. Use when you want to know 'what's running RIGHT NOW' without spinning up the monitor loop." -version: 2.2.0 +version: 2.2.1 author: godopu license: MIT platforms: [linux, macos] diff --git a/.agents/skills/multi-agent-mux-stop/SKILL.md b/.agents/skills/multi-agent-mux-stop/SKILL.md index ba59bba..30b59f9 100644 --- a/.agents/skills/multi-agent-mux-stop/SKILL.md +++ b/.agents/skills/multi-agent-mux-stop/SKILL.md @@ -1,7 +1,7 @@ --- name: multi-agent-mux-stop description: "Stop an agent herdr session (claude, antigravity/agy) and update .mam/agent-sessions.yaml. Default stops gracefully and marks status=stopped with conversation preserved for resume. Does NOT delete on-disk conversation artifacts (jsonl/db) โ€” those are preserved unless --purge-conversation is passed. Use when ending a work session, switching to a different one, or cleaning up before a fresh start." -version: 2.2.0 +version: 2.2.1 author: godopu license: MIT platforms: [linux, macos] diff --git a/VERSIONS.md b/VERSIONS.md index 8d39466..9f8c5fc 100644 --- a/VERSIONS.md +++ b/VERSIONS.md @@ -6,10 +6,11 @@ ## ๐Ÿ“Œ ํ˜„์žฌ ๋ฒ„์ „ ๊ฐœ์š” (Current Release) -- **ํ”„๋ ˆ์ž„์›Œํฌ ๋ฒ„์ „**: `v2.2.0` +- **ํ”„๋ ˆ์ž„์›Œํฌ ๋ฒ„์ „**: `v2.2.1` - **์ตœ์‹  ๋ฆด๋ฆฌ์Šค ์ผ์‹œ**: 2026-08-24 (KST) - **๊ธฐ์ค€ ๋ธŒ๋žœ์น˜**: `main` - **ํ•ต์‹ฌ ์•„ํ‚คํ…์ฒ˜**: + - **Single-Workspace 2xK Multi-Pane Tiling Optimization**: ๊ธฐ๋ณธ ์ตœ์†Œ ํŽ˜์ธ ๋„ˆ๋น„ ์™„ํ™”(`MAM_MIN_PANE_COLS=40`)๋กœ 80~100์ปฌ๋Ÿผ ์ฐฝ์—์„œ 3~4๊ฐœ ์—์ด์ „ํŠธ ๋‹จ์ผ ์›Œํฌ์ŠคํŽ˜์ด์Šค ํƒ€์ผ๋ง ๋ณด์žฅ - **`--herdr-workspace` Option & Runtime Label Sync**: Herdr ์„ธ์…˜ ๋‚ด ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ผ๋ฒจ ๋…๋ฆฝ ์ง€์ • ๋ฐ ๋Ÿฐํƒ€์ž„/YAML ์‹ค์‹œ๊ฐ„ ๋™๊ธฐํ™” - **Legacy Fallback Chain Decoupling**: ๋ฐ๋ชฌ ์†Œ์ผ“(`herdr_session`)๊ณผ ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ผ๋ฒจ(`herdr_workspace`) ์กฐํšŒ ์ฒด์ธ ์›์ฒœ ๋ถ„๋ฆฌ - **Modern Agent Adapter & TUI Readiness**: ์ตœ์‹  Claude Code(`v2.1.241`) ๋ฐฐ๋„ˆ ๋ฐ 4๋Œ€ ์—์ด์ „ํŠธ TUI ์ดˆ๊ณ ์† ๊ฐ์ง€ @@ -21,23 +22,37 @@ ## ๐Ÿงญ ์Šคํ‚ฌ ํŒจํ‚ค์ง€ ๋ฒ„์ „ ๋งคํŠธ๋ฆญ์Šค (Skills Version Matrix) -๋ชจ๋“  8๊ฐœ ์Šคํ‚ฌ์€ YAML frontmatter ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ(`author`, `version`, `platforms`, `environments`) ํ‘œ์ค€ํ™”๋ฅผ ํ†ตํ•ด `v2.2.0`์œผ๋กœ ๋™๊ธฐํ™”๋˜์–ด ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค. +๋ชจ๋“  8๊ฐœ ์Šคํ‚ฌ์€ YAML frontmatter ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ(`author`, `version`, `platforms`, `environments`) ํ‘œ์ค€ํ™”๋ฅผ ํ†ตํ•ด `v2.2.1`์œผ๋กœ ๋™๊ธฐํ™”๋˜์–ด ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค. | ์Šคํ‚ฌ๋ช… | ๋ฒ„์ „ | ์—ญํ•  ๋ฐ ์ฃผ์š” ์ฑ…์ž„ | ์ƒํƒœ | | :--- | :---: | :--- | :---: | -| **`multi-agent-mux-create`** | `2.2.0` | ์—์ด์ „ํŠธ ์„ธ์…˜ ์‹ ๊ทœ ์ƒ์„ฑ ๋ฐ Herdr ์ปจํ…Œ์ด๋„ˆ ๊ฒฉ๋ฆฌ ์Šคํฐ | โœ… ๋ฐฐํฌ | -| **`multi-agent-mux-stop`** | `2.2.0` | ๋Œ€ํ™” UUID ์›์ž์  ์บก์ฒ˜ ๋ฐ ์„ธ์…˜ ์•ˆ์ „ ์ข…๋ฃŒ (Graceful Stop) | โœ… ๋ฐฐํฌ | -| **`multi-agent-mux-resume`** | `2.2.0` | ์˜จ๋””์Šคํฌ ๋Œ€ํ™” ์ปจํ…์ŠคํŠธ ๊ธฐ๋ฐ˜ Tier-1 ์ดˆ๊ณ ์† ์„ธ์…˜ ๋ณต์› | โœ… ๋ฐฐํฌ | -| **`multi-agent-mux-status`** | `2.2.0` | ์‹ค์‹œ๊ฐ„ Herdr ์„ธ์…˜ ๋ฐ ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ ๋“œ๋ฆฌํ”„ํŠธ ์Šค๋ƒ…์ƒท ์กฐํšŒ | โœ… ๋ฐฐํฌ | -| **`multi-agent-mux-monitor`** | `2.2.0` | YAML โ†” ๋Ÿฐํƒ€์ž„ ์ƒํƒœ ๊ฐ„ ์ž์œจ ์กฐ์ •์ž (Reconciler Loop) | โœ… ๋ฐฐํฌ | -| **`multi-agent-mux-delegate-job`** | `2.2.0` | MQTT ์ด๋ฒคํŠธ ์ฑ„๋„ ๊ธฐ๋ฐ˜ ๋น„๋™๊ธฐ ๋‹จ์œ„ ์ž‘์—… ์œ„์ž„ | โœ… ๋ฐฐํฌ | -| **`multi-agent-mux-loop`** | `2.2.0` | Planner-Creator-Reviewer 3์ž ์ž์œจ ๊ณ„ํšยท์‹คํ–‰ยทํ”ผ์–ด๋ฆฌ๋ทฐ ๋ฃจํ”„ | โœ… ๋ฐฐํฌ | -| **`multi-agent-mux-orc-onboard`** | `2.2.0` | ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ดํ„ฐ UUID ๊ฒฉ๋ฆฌ ๋“ฑ๋ก ๋ฐ ์„œ๋ธŒ ์„ธ์…˜ ์˜ค์—ผ ๋ฐฉ์ง€ | โœ… ๋ฐฐํฌ | +| **`multi-agent-mux-create`** | `2.2.1` | ์—์ด์ „ํŠธ ์„ธ์…˜ ์‹ ๊ทœ ์ƒ์„ฑ ๋ฐ Herdr ์ปจํ…Œ์ด๋„ˆ ๊ฒฉ๋ฆฌ ์Šคํฐ | โœ… ๋ฐฐํฌ | +| **`multi-agent-mux-stop`** | `2.2.1` | ๋Œ€ํ™” UUID ์›์ž์  ์บก์ฒ˜ ๋ฐ ์„ธ์…˜ ์•ˆ์ „ ์ข…๋ฃŒ (Graceful Stop) | โœ… ๋ฐฐํฌ | +| **`multi-agent-mux-resume`** | `2.2.1` | ์˜จ๋””์Šคํฌ ๋Œ€ํ™” ์ปจํ…์ŠคํŠธ ๊ธฐ๋ฐ˜ Tier-1 ์ดˆ๊ณ ์† ์„ธ์…˜ ๋ณต์› | โœ… ๋ฐฐํฌ | +| **`multi-agent-mux-status`** | `2.2.1` | ์‹ค์‹œ๊ฐ„ Herdr ์„ธ์…˜ ๋ฐ ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ ๋“œ๋ฆฌํ”„ํŠธ ์Šค๋ƒ…์ƒท ์กฐํšŒ | โœ… ๋ฐฐํฌ | +| **`multi-agent-mux-monitor`** | `2.2.1` | YAML โ†” ๋Ÿฐํƒ€์ž„ ์ƒํƒœ ๊ฐ„ ์ž์œจ ์กฐ์ •์ž (Reconciler Loop) | โœ… ๋ฐฐํฌ | +| **`multi-agent-mux-delegate-job`** | `2.2.1` | MQTT ์ด๋ฒคํŠธ ์ฑ„๋„ ๊ธฐ๋ฐ˜ ๋น„๋™๊ธฐ ๋‹จ์œ„ ์ž‘์—… ์œ„์ž„ | โœ… ๋ฐฐํฌ | +| **`multi-agent-mux-loop`** | `2.2.1` | Planner-Creator-Reviewer 3์ž ์ž์œจ ๊ณ„ํšยท์‹คํ–‰ยทํ”ผ์–ด๋ฆฌ๋ทฐ ๋ฃจํ”„ | โœ… ๋ฐฐํฌ | +| **`multi-agent-mux-orc-onboard`** | `2.2.1` | ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ดํ„ฐ UUID ๊ฒฉ๋ฆฌ ๋“ฑ๋ก ๋ฐ ์„œ๋ธŒ ์„ธ์…˜ ์˜ค์—ผ ๋ฐฉ์ง€ | โœ… ๋ฐฐํฌ | --- ## ๐Ÿ“‹ ๋ฒ„์ „๋ณ„ ์ƒ์„ธ ๋ณ€๊ฒฝ ๋‚ด์—ญ (Changelog) +### ๐Ÿš€ `v2.2.1` โ€” Single-Workspace 2xK Multi-Pane Tiling Optimization & Premature Overflow Fix (2026-08-24) + +> **์ฃผ์š” ๋งˆ์ผ์Šคํ†ค**: `MAM_MIN_PANE_COLS` ๊ธฐ๋ณธ๊ฐ’ 60โ†’40 ์™„ํ™”, ํ‘œ์ค€ 80~100์ปฌ๋Ÿผ ํ„ฐ๋ฏธ๋„ ๋ทฐํฌํŠธ์—์„œ ์กฐ๊ธฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค ์˜ค๋ฒ„ํ”Œ๋กœ(๊ฐ€์ƒ ๋ฐ์Šคํฌํ†ฑ ๋ถ„๋ฆฌ) ๋ฐฉ์ง€ ๋ฐ ๋‹จ์ผ ์›Œํฌ์ŠคํŽ˜์ด์Šค 2x2 ํ†ตํ•ฉ ํƒ€์ผ๋ง ์™„์„ฑ, ์‹ ๊ทœ 80/79 ๊ฒฝ๊ณ„ ๋ฐ 90/100 col ํƒ€์ผ๋ง ํ…Œ์ŠคํŠธ 6์ข… ์ถ”๊ฐ€, ๋‹ค์ค‘ ์—์ด์ „ํŠธ ํ”ผ์–ด ๋ฆฌ๋ทฐ 100% PASS ๋‹ฌ์„ฑ. + +#### 1. 2xK ๋ ˆ์ด์•„์›ƒ ์—”์ง„ ์ตœ์†Œ ํญ ์™„ํ™” (`lib_py/layout.py`, `lib.sh`) +- `compute_2xk_layout` ๊ธฐ๋ณธ `min_cols` ๋ฐ CLI `--min-cols`, `lib.sh:432`์˜ `${MAM_MIN_PANE_COLS:-40}`, `.mam.env.example` ๋ฌธ์„œ๋ฅผ `40`์œผ๋กœ 4์ค‘ ์ผ์น˜ํ™”. +- 90~100์ปฌ๋Ÿผ ๋„ˆ๋น„ ํ„ฐ๋ฏธ๋„์—์„œ 3๋ฒˆ์งธ, 4๋ฒˆ์งธ ์—์ด์ „ํŠธ ์ƒ์„ฑ ์‹œ ๋ถˆํ•„์š”ํ•˜๊ฒŒ ๊ฐ€์ƒ ๋ฐ์Šคํฌํ†ฑ(Workspace)์ด ๋ถ„๋ฆฌ๋˜๋˜ ํ˜„์ƒ ์™„์ „ ํ•ด์†Œ. + +#### 2. ๊ฒฝ๊ณ„๊ฐ’ ๋ฐ ํƒ€์ผ๋ง ์ž๋™ํ™” ํ…Œ์ŠคํŠธ ํ™•์ถฉ (`tests/test_layout.py`, `tests/test_tier1_unit.py`) +- `80` ์ปฌ๋Ÿผ(๋ถ„ํ•  ์„ฑ๊ณต) vs `79` ์ปฌ๋Ÿผ(์˜ค๋ฒ„ํ”Œ๋กœ) ํ•˜ํ•œ ๊ฒฝ๊ณ„๊ฐ’ ๊ฒ€์ฆ. +- `90` ๋ฐ `100` ์ปฌ๋Ÿผ ๋‹จ์ผ ์›Œํฌ์ŠคํŽ˜์ด์Šค 1โ†’2โ†’3โ†’4 ๋‹จ๊ณ„ 2x2 ํƒ€์ผ๋ง ๋ฐ 5๋ฒˆ์งธ ์—์ด์ „ํŠธ ์˜ค๋ฒ„ํ”Œ๋กœ ์ „ ๊ณผ์ • ์ˆ˜๋ช… ์ฃผ๊ธฐ ๊ฒ€์ฆ. + +--- + ### ๐Ÿš€ `v2.2.0` โ€” Herdr Workspace Label Standardization, Runtime Sync & Legacy Fallback Decoupling (2026-08-24) > **์ฃผ์š” ๋งˆ์ผ์Šคํ†ค**: `--herdr-workspace` ์˜ต์…˜ ์ „ ์Šคํ‚ฌ ๋„์ž… ๋ฐ YAML ๋…๋ฆฝ ์ง๋ ฌํ™”, Herdr ๋Ÿฐํƒ€์ž„ ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ ˆ์ด๋ธ” ์‹ค์‹œ๊ฐ„ ๋™๊ธฐํ™”, ๋ ˆ๊ฑฐ์‹œ ์†Œ์ผ“ ํด๋ฐฑ ์ฒด์ธ ๋ถ„๋ฆฌ(Breaking Change ๋ฐฉ์–ด), ์ตœ์‹  Claude Code TUI ๊ฐ์ง€ ํ† ํฐ ๋ฐ˜์˜, 27๊ฐœ ์‹ ๊ทœ ํ…Œ์ŠคํŠธ ์ถ”๊ฐ€ ๋ฐ ๋งŒ์žฅ์ผ์น˜ PASS ๋‹ฌ์„ฑ.