tmpl/multi-agent-mux
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
224 Commits 4 Branches 0 Tags
2d5e20a6aade20a2f4bf7cb5046b87e58f2054fa
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Godopu 2d5e20a6aa docs(c1): purge all 29 legacy Kanban references from SKILL.md and documentation (100% PASS) 2026-08-06 08:03:15 +09:00
Godopu 924e77e8b8 feat(b1): fix find_workspace_uuid tier-3 identity lookup and add test_b1_tier3_identity.py (100% PASS) 2026-08-05 23:55:21 +09:00
Godopu b6c41e6486 docs(skills): update SKILL.md documentation to reflect HERDR_SESSION_NAME native naming 2026-08-05 10:23:49 +09:00
Godopu 0fe3b9932c fix(refactor): remove tracked tmp file, add *.tmp to gitignore, fix herdr_session lookup in reconcile.sh MQTT handler 2026-08-05 10:13:46 +09:00
Godopu ddd43ecbea fix(refactor): address reviewer findings R-1..R-8, achieve 31/31 test pass 2026-08-05 10:08:59 +09:00
Godopu 8dcb2b2d9e docs(env): replace legacy TMUX_SERVER_NAME with HERDR_SESSION_NAME in .mam.env.example 2026-08-05 09:33:39 +09:00
Godopu 51dcf56c80 feat(scope): implement workspace-scoped session isolation (A-1) and native Herdr session naming (A-5) 2026-08-05 09:31:57 +09:00
Godopu 793a221587 docs: add herdr-server to herdr-session transition task (A-5) to IMPROVEMENTS.md 2026-08-05 09:26:16 +09:00
Godopu addcabf7d3 docs: rename OPTIMIZATION.md to IMPROVEMENTS.md 2026-08-05 09:25:42 +09:00
Godopu aac2960586 docs: consolidate CODEBASE_REVIEW_REPORT.md into OPTIMIZATION.md 2026-08-05 09:24:22 +09:00
Godopu 01c8e60b2f docs: remove resolved issues from OPTIMIZATION.md 2026-08-05 09:13:54 +09:00
Godopu d6b7b97892 docs: update CODEBASE_REVIEW_REPORT.md to exclude resolved defects 2026-08-05 09:11:41 +09:00
Godopu ea36e81624 fix(skills): resolve session resolution, add cancelled event status, and scope mqtt topic 2026-08-05 09:11:35 +09:00
Godopu 68eff79810 feat(deploy): install update/remove scripts into .mam_deploy/ and refine markdown staging 2026-08-04 22:17:59 +09:00
Godopu 2ff8b2c4a9 docs: document .mam.env config file, legacy migration path, and save loop reports 2026-08-04 21:43:00 +09:00
Godopu 7d54fd8104 test: cover .mam.env migration, shadowing, ownership and uninstall preservation 2026-08-04 21:42:58 +09:00
Godopu 40a1c0faa9 fix(deploy): pre-capture env ownership and keep backup/restore symmetric 2026-08-04 21:42:56 +09:00
Godopu 443f381092 fix(deploy): back up MAM-owned env under --force and restrict deletion to --purge-env 2026-08-04 21:42:55 +09:00
Godopu c38c05c1f3 feat(deploy): add shadowing guard and evidence-based legacy env migration 2026-08-04 21:42:53 +09:00
Godopu a832ba75d3 feat(deploy): target .mam.env and add --migrate-legacy flag 2026-08-04 21:42:51 +09:00
Godopu 62dcbb1361 fix(config): resolve wrapper env from repo root and warn on deprecated .env 2026-08-04 21:42:49 +09:00
Godopu 2458995e75 fix(config): resolve dotenv via workspace marker and prefer .mam.env over legacy .env 2026-08-04 21:42:45 +09:00
Godopu 11583eb173 refactor(config): rename .env.example to .mam.env.example and isolate .mam.env in gitignore 2026-08-04 21:42:43 +09:00
Godopu 03ba94a030 refactor: optimize multi-agent-mux-loop spec and clean up workspace docs 
- Add OPTIMIZATION.md detailing Invocation-Aware Scoped Guard, race-free lock design, and DoD verification gates approved via multi-agent loop
- Update root markdown files (README, BOOTSTRAP, MESSAGING) replacing legacy TMUX references with HERDR
- Remove redundant root markdown files and archive promoted reviewer PASS report
 2026-08-02 19:20:43 +09:00
Godopu 002d9b268d feat: add force-refresh capability and allow framework-owned skill updates during installation 2026-07-27 13:16:14 +09:00
Godopu 520168ca55 refactor: use delegated python binary in script execution and update resolution logic to prioritize virtual environments 2026-07-25 00:11:32 +09:00
Godopu c4839822ed fix(resume): add --workspace symmetry in resume_session.sh and update test_tier4_e2e for isolation model 2026-07-25 00:03:56 +09:00
Godopu 6918f211e8 fix(stop): use ignore_errors=True when purging brain directory 2026-07-24 23:59:56 +09:00
Godopu 57bc1b2d11 fix(resume): declare default AGENT variable in update_yaml_resumed.sh to avoid unbound variable error 2026-07-24 23:42:41 +09:00
Godopu d2a82478e9 fix(resume): pass workspace, role, and epoch to update_yaml_resumed.sh to fix fallback silent bugs 2026-07-24 23:39:39 +09:00
Godopu d6b523c943 test(challenger): update herdr_session key to herdr_server in test_workspace_server_mapping 2026-07-24 23:38:23 +09:00
Godopu 6d6bc7a13a docs(reports): add peer review report for commits cb88771 and f0a2103 2026-07-24 23:37:40 +09:00
Godopu 9ba45e536f test(tests): update test suite to align with isolation refactor and relative skill path 2026-07-24 23:37:19 +09:00
Godopu cb88771923 fix(resume): auto-create session entry in update_yaml_resumed.sh when missing 2026-07-24 23:21:12 +09:00
Godopu f0a2103edf refactor(isolation): simplify agent session isolation and remove legacy home-isolation helpers 2026-07-23 22:05:29 +09:00
Godopu 15ffc8f6bb feat(mux): implement onboarding prompt initialization, 4-tier UUID validation, and TUI 1:1 cross-matching 2026-07-23 09:41:16 +09:00
Godopu c65b194d88 fix(lib): resolve root causes of login prompt in claude and TOS/theme onboarding in agy 2026-07-22 23:44:49 +09:00
Godopu 8f7f4ed868 docs(reports): add durable peer review reports from multi-agent loop 2026-07-22 08:54:23 +09:00
Godopu c1b74c1b5c docs(report): add architecture and multi-agent orchestration report 2026-07-22 08:53:41 +09:00
Godopu 6692c275ea fix(lib): seed antigravity config, library preferences, app support, and linux XDG paths for agy session isolation to bypass TOS/onboarding prompt 2026-07-22 07:47:31 +09:00
Godopu 36a087af58 refactor: update multi-agent rules to TMUX & refactor MAM skills scripts 
- Update .agents/MULTI_AGENT_RULES.md & .ko.md to align with TMUX concepts
- Add .agents/INSTALL.md guide for MAM setup and workflows
- Clean up legacy markdown reports under .agents/reports/
- Refactor MAM scripts in .agents/skills/ (rename resolve_herdr_session to resolve_herdr_workspace)
- Improve workspace pane splitting/re-use logic in lib.sh
- Reduce paste safety sleep in send_keys_safe and support linking ~/.claude.json
 2026-07-22 06:57:32 +09:00
Godopu efadc231fb Delete Flutter-based multi-agent-mux-ui folder and root Melos/Flutter config files 2026-07-20 07:58:43 +09:00
Godopu 3a6e4da1a3 Fix mock pane close command in conftest and resolve pane_id collisions in E2E Scenario 5 tests 2026-07-20 07:48:17 +09:00
Godopu 6df4b03661 Align conftest mock herdr and unit test assertions with Claude's simplified session-based isolation and native herdr command updates 2026-07-20 07:42:05 +09:00
GodopuandClaude Fable 5 cccc30a8ac chore: gitignore Flutter/Dart build artifacts and IDE files, untrack committed .dart_tool 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-19 20:38:04 +09:00
Godopu ff7a2873f9 Implement full E2E, integration, component, and unit tests, and resolve all leftover tmux-to-herdr issues in UI and core scripts 2026-07-19 20:05:48 +09:00
Godopu 30e606b0fa Clean up all tmux occurrences from dev skills and integrate herdr wrapper translation shim with dynamic env and workspace ID parsing 2026-07-19 16:57:00 +09:00
Godopu 42b54d7643 Migrate backend to herdr using a seamless translation shim wrapper 2026-07-19 16:22:58 +09:00
Godopu 507ac1847b docs: add PLAN_HERDR.md and herdr_docs.md reference file 2026-07-19 16:18:09 +09:00
Godopu 945edbe837 docs: archive macOS Keychain and Preflight bypass review reports from cline and claude 2026-07-18 23:29:55 +09:00
Godopu 36b3910ff2 fix(mac-compat): bypass keyring auth check hang and link macOS Library/Keychains to isolated home 2026-07-18 23:23:40 +09:00
Godopu fc24af4683 docs: archive macOS compatibility review reports from cline and claude 2026-07-18 22:37:15 +09:00
Godopu f79fd99de7 fix(mac-compat): resolve absolute path of agent binary and strip macos quarantine attribute to prevent gatekeeper and path-resolution timeouts 2026-07-18 22:26:23 +09:00
Godopu 31ca11c57d docs: archive planning/review reports and issue report from previous multi-agent-mux-loop runs 2026-07-17 21:33:31 +09:00
Godopu b45649de76 feat(delegate-job): support role aliases mapping and run delegate job safely using isolated temp copy with signal cleanups 2026-07-17 17:07:30 +09:00
Godopu 5a6cb91fb0 feat(delegate-job): support --role parameter in submit and update commands to resolve role suitability mismatches 2026-07-17 15:59:14 +09:00
Godopu be46484108 fix(loop): fix wait_for_job hang bug and finalize Creator Self-Planning documentation 2026-07-17 15:51:37 +09:00
Godopu 6c903420d8 fix(skill): resolve hardcoded planner session name and plan file paths dynamically in run_loop.sh 2026-07-16 23:48:13 +09:00
Godopu f85fdfc1f9 docs(skill): genericize multi-agent-mux-loop SKILL manual by replacing hardcoded agent session names with placeholders 2026-07-16 23:46:27 +09:00
Godopu 52c270eea7 docs(skill): update multi-agent-mux-loop SKILL manual to reflect skipped planning mode when --plan is omitted 2026-07-16 23:43:53 +09:00
Godopu 7c94eefb6d docs: add development plan for MAM Web PTY WebSocket Bridge architecture 2026-07-16 23:34:23 +09:00
Godopu f0e2bd26c2 fix(ui): correct libc symbol lookup for direct _exit syscall to achieve async-signal-safety 2026-07-16 23:27:55 +09:00
Godopu 7f1a7e5a50 fix(ui): enforce async-signal-safe exit, blocking waitpid reaping, and unsetenv env isolation inside child PTY process 2026-07-16 23:20:59 +09:00
Godopu a6e4dc97a4 fix(ui): prevent Dart event loop freezing by switching master PTY fd to non-blocking mode via fcntl 2026-07-16 23:19:24 +09:00
Godopu 7781e797aa fix(ui): implement async-signal-safe fork process layout and waitpid child zombie reaping for PTY 2026-07-16 23:11:37 +09:00
Godopu f52f6eb2af fix(ui): resolve M2 blocking bugs with full POSIX fork/exec PTY spawn and tmux environment isolation 2026-07-16 22:56:19 +09:00
Godopu b7901bcce5 feat(ui): complete M2 Milestone - Desktop POSIX PTY FFI implementation and attach terminal tab integration 2026-07-16 22:50:59 +09:00
Godopu 7e4cab6c09 fix(ui): expose stale banner under cold-start failures when no successful snapshot exists 2026-07-16 21:21:07 +09:00
Godopu 7c981549a2 fix(ui): implement cached startup pre-flight check in SessionService and propagate errors in StaleBanner 2026-07-16 21:18:14 +09:00
Godopu 2eb85866b3 feat(ui): complete M1 Milestone - read-only Dashboard and Detail Pane with status.sh integration 2026-07-16 21:09:31 +09:00
Godopu 7d22774d76 feat(loop): allow run_loop.sh to automatically load existing plan if --plan is omitted 2026-07-16 20:54:38 +09:00
Godopu 9778f38d9f feat(ui): scaffold multi-agent-mux-ui monorepo structure with Flutter and Melos configurations 2026-07-16 17:30:03 +09:00
Godopu 39be8d7b43 docs(resume): remove obsolete, hardcoded resume_all.sh script 2026-07-16 15:42:08 +09:00
GodopuandClaude Sonnet 5 35fc44f269 fix(loop): repair review-diff/verdict-parsing bugs, deduplicate session lookups 
Applies the P0-P3 fixes from the multi-agent-mux-loop audit
(.mam/jobs/ab686e47/claude-reports/report-final.md):

- P0-1: capture BASE_COMMIT before Phase 2 and diff against it, so reviewer
  diffs stay non-empty and cumulative even after the Creator commits per the
  documented DoD (bare `git diff` alone showed nothing once committed).
- P0-2: has_verdict now matches only the report's last non-blank line, so a
  stray [VERDICT: ...] token quoted mid-report as a formatting example can no
  longer flip the outcome.
- P1-1: replace the English-only refactor/complex/design/architect keyword
  sniff (dead code against Korean-language reviewer reports) with an explicit
  [ESCALATE: PLANNER] tag the reviewer prompt now asks for.
- P1-2: resolve_all_reviewers/resolve_agent_type/resolve_planner_session now
  read through lib.sh's load_state_json single source of truth instead of
  each hand-rolling its own SQLite+YAML lookup; resolve_agent_type's name
  fallback matches exact hyphen segments instead of a substring `in` check.
- P2-1: warn when --all-reviewer and --reviewer are both given, since the
  latter is silently discarded.
- P2-2: correct the SKILL.md CLI-mapping table row that overstated an
  automated lint gate and an unconditional Planner feedback loop.
- P3: fix lib.sh shellcheck SC2164 (unguarded cd in start_watchdog) and
  annotate the intentional SC2317 dual source/exec guard.

Verified: shellcheck clean on both scripts, bash -n syntax OK, and the
rewritten has_verdict/resolve_* functions were unit-tested against this
repo's live .mam/agent-sessions state.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-07-16 13:50:25 +09:00
Godopu 7fde1d2b8a docs(loop): merge multi_agent_workflow.md into SKILL.md, drop duplicate 2026-07-16 13:36:12 +09:00
Godopu 626f35adfc refactor: harden run_loop.sh verdict parser, add atomic promotion, and revise multi_agent_workflow.md guidelines 2026-07-16 12:57:56 +09:00
Godopu 230e262414 feat(stop): fully purge registry entries on stop --purge-conversation and add zombie pre-gate 2026-07-16 12:06:37 +09:00
Godopu dfdbf69187 fix(loop): correct self-relative REPO_ROOT depth in run_loop.sh 2026-07-16 12:06:37 +09:00
Godopu 9d0fbaec40 fix(deploy): remove deleted creator-claude agent from resume_all.sh 2026-07-16 11:29:57 +09:00
Godopu a671dfbb9d docs(deploy): append git repository recommendation to INSTALL.md 2026-07-16 11:25:50 +09:00
Godopu 91cd08b139 docs(deploy): add multi-agent-mux-loop quick start guide to INSTALL.md 2026-07-16 10:40:16 +09:00
Godopu 0f970b97fa fix(loop): address planner and reviewer architecture defects 
- Fix B-1: Correct Mermaid sequence diagram syntax (fi -> end) in SKILL.md and PLAN_LOOP.md
- Fix B-2: Force target agent exclusion from active reviewers in run_loop.sh and correct creator session role in registry
- Fix B-3 & B-4: Integrate WAIT_TIMEOUT deadline inside wait_for_job
- Fix M-3: Update CHANGES_DIFF to use dynamic cumulative git diff
- Fix M-2: Resolve verdict string parsing and substring collisions
 2026-07-16 08:28:57 +09:00
Godopu bacf139447 feat(skills): add multi-agent-mux-loop autonomous loop orchestrator 
Implement a new autonomous planning-execution-review orchestration loop
supporting:
- Collaborative planning & creator-planner challenge discussions (--plan-talk)
- Self-planning and self-review fallbacks
- Custom reviewer target list and all-reviewer unanimous PASS verdicts
- API-cost runaway safety limits via --max-loop

Integrated inside deploy/install.sh checklist and deploy/gitea-ci.yml.
 2026-07-16 08:12:24 +09:00
Godopu ff01984a69 docs(workflow): clarify agent standby behavior after PASS verdict 
Update the multi-agent workflow guidelines to explicitly specify that
agent sessions should not be stopped automatically upon receiving a PASS
verdict. Instead, they must remain in a standby (running) state, awaiting
further task instructions from the user, consistent with the project's
lifecycle charter.
 2026-07-12 23:18:30 +09:00
Godopu 787fe58298 fix(skills): robustify load_state_json against lone surrogates 
Implement a clean_surrogates helper inside lib.sh's load_state_json function
to recursively replace lone surrogates (e.g. from partial TUI screen dumps)
with replacement chars before printing, preventing UnicodeEncodeError on stdout.
 2026-07-12 17:19:44 +09:00
Godopu f8675ab377 docs(roadmap): sync FW-D4 path and lint count in FUTURE_WORKS 
Correct scripts/generate-env.sh -> deploy/generate-env.sh and update shellcheck unlinted count in both English and Korean versions, as eb733cf already resolved the generate-env.sh lint gap.

Addresses Reviewer Claude's non-blocking nit.
 2026-07-12 16:59:58 +09:00
Godopu eb733cf7c1 refactor(deploy): consolidate install scripts and INSTALL.md into deploy/ 
- Move scripts/install_mam.sh → deploy/install_mam.sh (local-clone installer)
- Move scripts/generate-env.sh → deploy/generate-env.sh (env helper)
- Move .agents/INSTALL.md → deploy/INSTALL.md (user manual)
- Update install_mam.sh to copy INSTALL.md + generate-env.sh from new paths
- Ship INSTALL.md via deploy/install.sh remote path too (manifest-tracked)
- Update README/BOOTSTRAP generate-env.sh references & repository ASCII layout
- Extend deploy/README.md structure section; extend gitea-ci.yml lint list
- Remove now-empty scripts/ directory
- Fix duplicate ### 2. subsection headers in deploy/README.md (address B-2)
- Correct deploy/INSTALL.md dependency description to match actual checks (address M-1)
- Add local-clone lifecycle caveat (no update.sh/remove.sh) (address M-2)

Closes the deploy consolidation plan and addresses Planner / Reviewer feedback.
 2026-07-12 16:30:15 +09:00
Godopu 2d2510f391 refactor(lib): add robust TUI readiness tokens for cline 
- Include 'What can I do' and 'slash commands' to grep search pattern
- Avoid false-positive timeouts when welcome screen branding logo is skipped
 2026-07-12 15:44:01 +09:00
Godopu dc1a2718d1 refactor(lib): extend wait_for_tui_ready timeout to 30 seconds 
- Allow slow-starting node standalone CLI processes to boot without false-positive timeouts
- Mitigate disk I/O constraints on isolated DB provisioning
 2026-07-12 15:43:04 +09:00
Godopu 742e71b784 refactor(lib): map cline isolation paths directly to root without data subfolder 
- Align symlink and copy paths directly under isolation root (no data/ intermediate directory)
- Correctly restore global settings and SQLite databases for standalone CLI execution
 2026-07-12 15:42:21 +09:00
Godopu f1e754d73e refactor(lib): physically copy sqlite DBs instead of symlinking for cline 
- Prevent sqlite DB locking errors across concurrent isolated sessions
- Use cp -p for files inside data/db/ during provision_isolation
 2026-07-12 15:41:59 +09:00
Godopu a57ce0a1b8 refactor(lib): seed db/ subfolder for cline isolation to preserve oauth and provider states 
- Symlink all database files inside data/db/ under isolation root
- Prevent cline CLI from bouncing back to the initial Welcome provider selection screen
 2026-07-12 15:41:17 +09:00
Godopu ae8ea9b939 refactor(lib): target correct data subfolder for cline isolation seeding 
- Place data/settings/ and data/globalState.json inside isolation root
- Align directories with cli --data-dir internal structure to prevent startup authentication crashes
 2026-07-12 15:35:25 +09:00
Godopu 559240f3c8 refactor(create): force state isolation by default for new sessions 
- Update default ISOLATE value to 1 in create_session.sh
- Add --no-isolate option to allow opting out of directory isolation if desired
- Keep --isolate flag for legacy syntax compatibility
 2026-07-12 15:34:00 +09:00
Godopu ed126ba37f docs(install): drop broken PATH export and un-escape $UUID in resume guide 
- Fix R-1 bug by dropping PATH='$PATH' to prevent PATH environment variable corruption
- Allow calling shell to expand $UUID inline prior to tmux spawn
 2026-07-12 15:19:51 +09:00
Godopu 9182d89dbd docs(install): address R-1, R-2, and R-3 feedback in resume guidelines 
- Align step label languages to Korean (R-2)
- Reintroduce -r $UUID and --dangerously-skip-permissions to claude spawn (R-1)
- Add isolation environment path mapping caveats pointing back to authorative SKILL.md (R-3)
 2026-07-12 15:17:31 +09:00
Godopu 875740788a docs(install): clarify install pre-requisites and concrete resume command examples 
- Add source repo clone pre-requisite statement in INSTALL.md section 2
- Incorporate concrete tmux new-session and update_yaml_resumed commands in INSTALL.md section 3
 2026-07-12 14:52:30 +09:00
Godopu 49176b43b6 refactor(lib): hash entire session dictionary to widen YAML write-gate 
- Prevent YAML<->SQLite sync drift on completed jobs (R-1 Option A)
- Hash session dict to trigger YAML rewrite on any field updates
 2026-07-12 14:37:42 +09:00
Godopu 60f3af4af9 refactor(monitor): keep sessions alive on job completion, kill only on errors 
- Modify reconcile.sh mutation logic to clear delegate_job_id instead of calling tmux kill-session on 'completed' events
- Retain process termination behavior on 'error' events for safety
 2026-07-12 14:24:02 +09:00
Godopu 288132c7ba refactor(install): port venv bootstrap, config tools and gitignore exclusions to installer 
- Port .venv creation and dependency pip install bootstrap sequence from deploy/install.sh into scripts/install_mam.sh
- Include .env.example and scripts/generate-env.sh copies under rsync target deployment
- Add .venv/ to target gitignore list to prevent virtualenv bloating
- Add empty-UUID resume safety guard in INSTALL.md
 2026-07-12 14:15:04 +09:00