Commit Graph
286 Commits
Author SHA1 Message Date
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
Godopu 382c314d5e refactor(rules): resolve loop report paths colon-safety and terminology gaps
- Sanitize clean_session in loop path report-final.md Output Report Path to prevent colon characters in folders
- Reconcile automated reports path token in MULTI_AGENT_RULES.md and .ko.md from <agent-session> to <agent_name> or <clean_session_name>
2026-07-12 13:57:04 +09:00
Godopu 65843e0557 docs(rules): update multi-agent rules with job-centric structure pointers
- Document automated job brief path under .mam/jobs/<job_id>/brief.md
- Document automated report redirection under .mam/jobs/<job_id>/<agent-session>-reports/report-final.md
- Correct stop_session.sh report cleanup claim to reflect manual cleanup
- Clarify onboarding brief mechanism under onboarding handshake protocol
2026-07-12 13:50:30 +09:00
Godopu 6186673fb2 chore(cleanup): remove obsolete brief markdown files from reports 2026-07-12 13:30:11 +09:00
Godopu d776273ae9 Revert "chore(cleanup): remove obsolete DONE.md task tracker file"
This reverts commit e305bcb083.
2026-07-12 13:29:37 +09:00
Godopu e305bcb083 chore(cleanup): remove obsolete DONE.md task tracker file 2026-07-12 13:23:28 +09:00
Godopu e44b587c2e chore(cleanup): remove handoff.md and clean temporary test job artifacts
- Remove handoff.md as the optimization is fully merged and verified
- Clean up temporary test jobs and logs from .mam/jobs/
2026-07-12 13:19:09 +09:00
Godopu 35af8e33a2 feat(skills): implement state loader DRY (OP-5) and Job-centric directory structure
- Extract load_state_json centralized helper inside lib.sh to unify state querying
- Refactor status, resume, stop, and monitor scripts to fetch state via MAM_STATE_JSON env var to avoid stdin pipeline collisions
- Restructure delegate-job to provision .mam/jobs/<job_id>/brief.md and direct agents to it, minimizing token size and preventing TUI paste freezes
- Harden send_keys_safe submission loop with was_popup state capture and edge case guards, preventing timing spin false-positives
- Passed cross-verification approved PASS from Planner Claude session
2026-07-12 11:50:38 +09:00
Godopu 76ec0dd929 fix(skills): support automatic bypass of large-session resume warning dialogs
- Add 'Resuming the full session' and 'Resume from summary' patterns to TUI validation constants
- Update handle_startup_dialogs to automatically submit the choice on large-session warnings, preventing start/resume lockups
2026-07-12 10:27:59 +09:00
Godopu cdeea81521 docs(handoff): add session handoff file detailing remaining skill optimizations 2026-07-11 10:25:12 +09:00
Godopu b258d238cb chore(registry): mark planner, reviewer, and creator sessions as stopped 2026-07-11 10:11:49 +09:00
Godopu 7eeb4b709a perf(skills): optimize sleeps and modularize duplication with multi-agent consensus PASS
- OP-1: Implement reactive _wait_session_gone in lib.sh and stop_session.sh with set -e || true guard
- OP-2: Event-driven MQTT subscribe handshake with sub_pid liveness in delegate-job
- OP-3: Replace CPU time.sleep(0.5) spin with threading.Event wait in reconcile.sh
- OP-4: Define mam_tmux dispatcher targeting resolved _REAL_TMUX_PATH to prevent recursion
- OP-6 & OP-7: Add token variables and bash version source check in lib.sh
- Integrate approved optimization plan and PASS review reports from all agents
2026-07-11 10:08:41 +09:00
Godopu 25de01eaad fix(skills): solve set -e error propagation in create_session.sh and include final PASS reviews
- Wrap inject_instructions with safe || rc=0 under set -e to prevent premature exit
- Ensure terminal error events are published on instruction injection failure
- Update 2-reviewers final review reports with Round 3 PASS verdicts
2026-07-11 09:41:49 +09:00
Godopu da895fccd5 fix(skills): resolve blank-padding viewport bug in send_keys_safe and fix rc status leak
- Introduce _pane_tail content helper to filter blank-padded lines in tmux captures
- Apply _pane_tail to _pane_dialog_open, handle_startup_dialogs, and send_keys_safe
- Fix rc status expansion logic in create_session.sh instructions injection check
- Include 3-agent final prompt-lock verification reports
2026-07-11 09:34:25 +09:00
Godopu e613f4aedb fix(skills): evidence-based prompt delivery (send_keys_safe) to end prompt-lock (FW-W2)
- Add send_keys_safe + quiescence/dialog-detection helpers to lib.sh:
  keys are sent on pane evidence, never fixed timers; distinct exit
  codes 1-4; dialogs are never blindly Enter-ed
- inject_instructions delegates to send_keys_safe; create --submit-job
  publishes a terminal error event on delivery failure (no zombie jobs)
- wait_for_tui_ready: drop dialog-ambiguous tokens, treat open dialogs
  as not-ready, return 1 on timeout instead of proceeding
- delegate-job wrapper: replace copy-pasted raw paste/C-m block with
  lib.sh send_keys_safe (restores single source of truth)
- resume: conditional signature-gated dialog handling replaces blind
  Enter/Down/Enter; stop --graceful delivers exitkey safely, fallback
  chain unchanged
- create SKILL: passive capture-pane probe instead of stray Enter
- Mark FW-W2 resolved; add 3-agent analysis/plan reports
2026-07-11 09:24:34 +09:00
Godopu 7fc6c8c7b9 chore(docs): remove obsolete session isolation planning doc set per 3-agent audit
- Delete implementation_plan.session_isolation.md, task.session_isolation.md,
  session_isolation_handover.md, and Problem_Definition.md.
- These are completed-work planning artifacts whose outcomes are already
  fully implemented, verified, and recorded in git history.
2026-07-11 08:59:20 +09:00
Godopu 9b831932b0 chore(docs): remove obsolete root planning docs per 3-agent markdown audit
- Delete task.md / implementation_plan.md (deploy URL parameterization
  shipped in 6408f4a; checklists were stale) and
  session_isolation_discussion.md (superseded by
  implementation_plan.session_isolation.md; feature shipped and PASSed)
- Remove the two inbound links to the deleted discussion doc
- Add reviewer analysis reports and this cleanup plan under .agents/reports/
2026-07-11 08:50:30 +09:00
Godopu 1c2ce0953d refactor(installer): remove sqlite3 CLI false dependency and verify py-sqlite3 module check 2026-07-11 00:58:27 +09:00
Godopu 66fd1c4834 refactor(installer): align create example flags with tmux-server in INSTALL.md and remove flock dependency 2026-07-11 00:45:35 +09:00
Godopu d7e19feaf5 refactor(installer): resolve architectural inconsistencies, pyyaml hard check, and migrate reports to tracked paths 2026-07-11 00:41:12 +09:00
Godopu 6974e316e2 docs(review): synchronize final output details of installer rereview report 2026-07-11 00:33:56 +09:00
Godopu a7aa8a00fd feat(installer): implement MAM skills installer with complete user guide and pass reviewer reviews 2026-07-11 00:33:49 +09:00
Godopu dad99f55c6 feat(isolation): resolve idempotency bypass for late purge and verify Phase 4 integration tests 2026-07-10 23:33:57 +09:00
Godopu e75a3a40c9 docs: update task checklist and handover brief with final pass verdict 2026-07-10 23:18:54 +09:00
Godopu ac94b104c1 docs(review): commit reviewer cline pass report for session isolation 2026-07-10 23:18:40 +09:00
Godopu 4842d0f892 docs(handover): save session isolation handover brief to workspace root 2026-07-10 12:38:12 +09:00
Godopu d76e470942 docs(isolation): commit session isolation design documents and guidelines 2026-07-10 12:28:06 +09:00
Godopu 768cfe5c6d feat(isolation): implement Phase 1-3 session isolation with stop purge and resume safety 2026-07-10 12:24:35 +09:00