diff --git a/.agents/skills/multi-agent-mux-create/SKILL.md b/.agents/skills/multi-agent-mux-create/SKILL.md index 5475fd9..5e5261b 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.1.0 +version: 2.2.0 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 d730c37..f48fcaa 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.1.0 +version: 2.2.0 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 6feb146..8feed70 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.1.0 +version: 2.2.0 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 584e697..782eac7 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.1.0 +version: 2.2.0 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 3ba9a52..7474b89 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.1.0 +version: 2.2.0 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 4d683c7..87e9187 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.1.0 +version: 2.2.0 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 8b403c3..1e57077 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.1.0 +version: 2.2.0 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 81a20b5..ba59bba 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.1.0 +version: 2.2.0 author: godopu license: MIT platforms: [linux, macos] diff --git a/VERSIONS.md b/VERSIONS.md index 4611a0f..8d39466 100644 --- a/VERSIONS.md +++ b/VERSIONS.md @@ -6,38 +6,63 @@ ## πŸ“Œ ν˜„μž¬ 버전 κ°œμš” (Current Release) -- **ν”„λ ˆμž„μ›Œν¬ 버전**: `v2.1.0` +- **ν”„λ ˆμž„μ›Œν¬ 버전**: `v2.2.0` - **μ΅œμ‹  릴리슀 μΌμ‹œ**: 2026-08-24 (KST) - **κΈ°μ€€ 브랜치**: `main` - **핡심 μ•„ν‚€ν…μ²˜**: + - **`--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 μ΄ˆκ³ μ† 감지 - **2xK Right-Growth Grid Layout Engine (B-20)**: 동적 터미널 감지 및 2xK 우츑 ν™•μž₯ 타일링 엔진 - - **A-4 Agent Adapter Layer**: 4λŒ€ μ—μ΄μ „νŠΈ(`claude`, `agy`, `hermes`, `cline`) 지식 계측 단일 μ†ŒμŠ€ μΈν„°νŽ˜μ΄μŠ€ - - **Standardized `--herdr-session` & `--agent`**: 슀크립트 μ „λ°˜ μ˜΅μ…˜ ν‘œμ€€ν™” 및 μ™„λ²½ν•œ μ„Έμ…˜ μ „νŒŒ - **Universal Herdr Session Isolation**: 단일 Herdr μ„œλ²„ μ»¨ν…μŠ€νŠΈ 기반 μ„Έμ…˜ 격리 - - **O-3 Orchestrator Scope Guard**: μ˜€μΌ€μŠ€νŠΈλ ˆμ΄ν„°μ˜ 직접 μ½”λ“œ λ³€μ‘° 방지 및 슀크립트 μœ„μž„ ν†΅μ œ - **Tier-1 Fast-Path Lifecycle**: 0ms μ§€μ—°μ˜ λŒ€ν™” UUID 캑처 및 μ΄ˆκ³ μ† 재개(Resume) --- ## 🧭 μŠ€ν‚¬ νŒ¨ν‚€μ§€ 버전 맀트릭슀 (Skills Version Matrix) -λͺ¨λ“  8개 μŠ€ν‚¬μ€ YAML frontmatter 메타데이터(`author`, `version`, `platforms`, `environments`) ν‘œμ€€ν™”λ₯Ό 톡해 `v2.1.0`으둜 λ™κΈ°ν™”λ˜μ–΄ λ°°ν¬λ©λ‹ˆλ‹€. +λͺ¨λ“  8개 μŠ€ν‚¬μ€ YAML frontmatter 메타데이터(`author`, `version`, `platforms`, `environments`) ν‘œμ€€ν™”λ₯Ό 톡해 `v2.2.0`으둜 λ™κΈ°ν™”λ˜μ–΄ λ°°ν¬λ©λ‹ˆλ‹€. | μŠ€ν‚¬λͺ… | 버전 | μ—­ν•  및 μ£Όμš” μ±…μž„ | μƒνƒœ | | :--- | :---: | :--- | :---: | -| **`multi-agent-mux-create`** | `2.1.0` | μ—μ΄μ „νŠΈ μ„Έμ…˜ μ‹ κ·œ 생성 및 Herdr μ»¨ν…Œμ΄λ„ˆ 격리 슀폰 | βœ… 배포 | -| **`multi-agent-mux-stop`** | `2.1.0` | λŒ€ν™” UUID μ›μžμ  캑처 및 μ„Έμ…˜ μ•ˆμ „ μ’…λ£Œ (Graceful Stop) | βœ… 배포 | -| **`multi-agent-mux-resume`** | `2.1.0` | μ˜¨λ””μŠ€ν¬ λŒ€ν™” μ»¨ν…μŠ€νŠΈ 기반 Tier-1 μ΄ˆκ³ μ† μ„Έμ…˜ 볡원 | βœ… 배포 | -| **`multi-agent-mux-status`** | `2.1.0` | μ‹€μ‹œκ°„ Herdr μ„Έμ…˜ 및 λ ˆμ§€μŠ€νŠΈλ¦¬ λ“œλ¦¬ν”„νŠΈ μŠ€λƒ…μƒ· 쑰회 | βœ… 배포 | -| **`multi-agent-mux-monitor`** | `2.1.0` | YAML ↔ λŸ°νƒ€μž„ μƒνƒœ κ°„ 자율 μ‘°μ •μž (Reconciler Loop) | βœ… 배포 | -| **`multi-agent-mux-delegate-job`** | `2.1.0` | MQTT 이벀트 채널 기반 비동기 λ‹¨μœ„ μž‘μ—… μœ„μž„ | βœ… 배포 | -| **`multi-agent-mux-loop`** | `2.1.0` | Planner-Creator-Reviewer 3자 자율 κ³„νšΒ·μ‹€ν–‰Β·ν”Όμ–΄λ¦¬λ·° 루프 | βœ… 배포 | -| **`multi-agent-mux-orc-onboard`** | `2.1.0` | μ˜€μΌ€μŠ€νŠΈλ ˆμ΄ν„° UUID 격리 등둝 및 μ„œλΈŒ μ„Έμ…˜ μ˜€μ—Ό 방지 | βœ… 배포 | +| **`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 격리 등둝 및 μ„œλΈŒ μ„Έμ…˜ μ˜€μ—Ό 방지 | βœ… 배포 | --- ## πŸ“‹ 버전별 상세 λ³€κ²½ λ‚΄μ—­ (Changelog) +### πŸš€ `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 달성. + +#### 1. `--herdr-workspace` μ˜΅μ…˜ λ„μž… 및 Herdr λŸ°νƒ€μž„ λ ˆμ΄λΈ” 동기화 +- **CLI μ˜΅μ…˜ 및 YAML 직렬화 ν‘œμ€€ν™”**: + - `create_session.sh`, `resume_session.sh`, `update_yaml_resumed.sh`, `stop_session.sh`에 `--herdr-workspace ` νŒŒμ„œ 및 ν™˜κ²½λ³€μˆ˜(`HERDR_WORKSPACE`) 지원 μΆ”κ°€. + - `agent-sessions.yaml`에 `herdr_session`(μ†ŒμΌ“λͺ…)κ³Ό `herdr_workspace`(μ›Œν¬μŠ€νŽ˜μ΄μŠ€ 라벨)λ₯Ό 각각 독립 ν•„λ“œλ‘œ 영ꡬ 직렬화. +- **Herdr λŸ°νƒ€μž„ μ›Œν¬μŠ€νŽ˜μ΄μŠ€ λ ˆμ΄λΈ” μ‹€μ‹œκ°„ 연동 (`lib.sh`, `resume_session.sh`)**: + - `herdr workspace create` 호좜 μ‹œ `--label "$MAM_WS_LABEL"` 전달 및 κΈ°μ‘΄ μ›Œν¬μŠ€νŽ˜μ΄μŠ€ μ‚¬μš© μ‹œ `herdr workspace rename` μžλ™ 호좜. + - `resume_session.sh` μ‹€ν–‰ μ‹œ μ €μž₯된 `herdr_workspace`λ₯Ό 읽어 Herdr λŸ°νƒ€μž„ λ ˆμ΄λΈ” 볡원 보μž₯. + +#### 2. λ ˆκ±°μ‹œ μ†ŒμΌ“ 폴백 체인 뢄리 및 Breaking Change μ›μ²œ 차단 +- **μ†ŒμΌ“ vs μ›Œν¬μŠ€νŽ˜μ΄μŠ€ ν•¨μˆ˜ μ™„μ „ 뢄리 (`lib.sh`)**: + - `resolve_herdr_session()`: 데λͺ¬/μ†ŒμΌ“ μ„Έμ…˜λͺ…λ§Œ λ°˜ν™˜ (row `herdr_session` -> row `herdr_server` -> env -> slug). + - `resolve_herdr_workspace()`: μ›Œν¬μŠ€νŽ˜μ΄μŠ€ 라벨만 λ°˜ν™˜ (row `herdr_workspace` -> `pane.cwd` slug -> caller `ws` arg). + - κΈ°μ‘΄ μ½”λ“œλ² μ΄μŠ€ 6개 지점(`lib.sh:1027`, `reconcile.sh:135, 399, 495`, `status.sh:145, 270`)μ—μ„œ μ†ŒμΌ“ 검색 μ‹œ `herdr_workspace`λ₯Ό 였인 μ°Έμ‘°ν•˜λ˜ ꡬ문을 μ™„μ „νžˆ 제거. +- **μ™ΈλΆ€ μ„Έμ…˜ μž…μ–‘(Drift-B) 보강 (`reconcile.sh`)**: + - μ™ΈλΆ€ μ„Έμ…˜ μž…μ–‘ μ‹œ `herdr_workspace`와 `herdr_server`λ₯Ό μžλ™ μ±„λ²ˆ 및 직렬화. + +#### 3. μ΅œμ‹  μ—μ΄μ „νŠΈ TUI μ€€λΉ„ 감지 보강 (`claude.py`, `lib.sh`) +- μ΅œμ‹  Claude Code(`v2.1.241`)의 μ‹œμž‘ λ°°λ„ˆ(`Claude Code`, `Opus 5 with high effort` λ“±)λ₯Ό `ready_tokens`에 μΆ”κ°€ν•˜μ—¬ μ„Έμ…˜ 생성 νƒ€μž„μ•„μ›ƒ 방지. + +--- + ### πŸš€ `v2.1.0` β€” 2xK Grid Layout Engine, Explicit Agent Standardization & Herdr Session Hardening (2026-08-24) > **μ£Όμš” λ§ˆμΌμŠ€ν†€**: 2xK 우츑 μ„±μž₯ κ·Έλ¦¬λ“œ λ ˆμ΄μ•„μ›ƒ 엔진(`lib_py.layout`) ꡬ좕(B-20), μ „ 슀크립트 `--agent` / `--herdr-session` ν‘œμ€€ν™” 및 μ „νŒŒ κ°€λ“œ, 전체 346개 ν…ŒμŠ€νŠΈ μŠ€μœ„νŠΈ 100% PASS 달성.