Commit Graph
50 Commits
Author SHA1 Message Date
GodopuandClaude Opus 5.5 fb1b93c665 fix(followups): F4b - bash integer knobs that reach [ -ge/-le/-gt ] or sleep go through mam_int_knob
A non-numeric MAM_READY_EMPTY_GIVEUP, SKS_EMPTY_GIVEUP, SKS_IDLE_RETRIES,
SKS_IDLE_RETRY_BACKOFF_S, MAM_LOCK_STEAL_RETRIES, MAM_DIFF_MAX_BYTES,
MAM_DIFF_MAX_LINES or RECONCILE_POLL_INTERVAL was a `[` error or a sleep
error at the point of use (PR #43 review claude R3). They now go through
mam_int_knob: decimal, a warning and the default for a bad value. Minimums
are in test_issue26_ints.py INT_KNOBS: 1 for the give-up counts (0 acts as
1), the diff caps (0 truncates every diff) and the poll interval (0 is a
busy loop); 0 for the retry counts (one attempt) and the retry backoff.

SKS_QUIESCENT_INTERVAL stays raw: its default is 0.5 s and sleep's
fraction is its meaning; NOT_ARITHMETIC says so.

loop_lock.sh and diff_collect.sh also run without lib.sh (the Python runner
and the tests source them alone), so mam_int / mam_int_knob move verbatim
to lib_int.sh, which lib.sh sources and those two source when the function
is missing. remove.sh's no-manifest fallback list names the new file
(install copies every file under .agents/skills). test_issue21_loop_b l15,
which builds a control root holding only diff_collect.sh, copies it too.

Tests: the table guard now reads every shell file; scripts sourced alone
read their knobs as decimal; _pane_quiescent with SKS_EMPTY_GIVEUP=abc
gives up with a warning and no `[` error (14 of the new cases fail at
0051fd6).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HCGpJXhSZasJLU38ksDghe
2026-10-02 08:23:31 +09:00
GodopuandClaude Opus 5 fadd38cf56 fix(deploy): #27 - the managed .gitignore block ignores .venv as a file, directory or link
Both installers wrote `/.venv/`, which only matches a directory: a .venv
symlink (the worktree recipe links the control root's) or file showed up as
untracked in installed repositories. The managed block now has `/.venv`.
Existing installations get it on the next install/update, which rewrites the
block between its markers as a whole; the integrity values are unaffected
(.gitignore is in neither asset_hashes.txt nor the install manifest).

Tests W10 (both installers; .venv as link, file and directory all ignored) and
W11 (a pre-#27 block is replaced, user lines outside it are kept, .gitignore
stays out of the ledgers).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017R3Eg7MEpSWnm1oB9ZPP6G
2026-09-14 15:24:10 +00:00
GodopuandClaude Fable 5.1 ea911d7842 fix(issue-8,7): harden install_state merge and pin sibling-workspace edge cases
Round-1 review of 4176d75 (planner-reviewer-claude-01, non-blocking):

- update.sh: merge install_state by exact key match (awk, no regex
  interpretation of the key), skip lines without '=', and terminate a fresh
  install_state that lacks a final newline before appending
- tests (#7): an agent-less pane left behind in a later same-cwd workspace
  is reused instead of splitting or creating; MAM_WS_LABEL renames only the
  workspace that was chosen

Refs #8 #7

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VCgu9Fa9iT7TbJUSzdq4Ff
2026-09-13 12:15:26 +09:00
GodopuandClaude Fable 5.1 e629cc137f fix(issue-12,8,7): keep broker password out of records, keep fresh install stamps, pack sibling workspaces
Issue #12 - MQTT_PASSWORD was copied into every job record, which any
sub-agent can read. BrokerConfig.to_registry_block no longer persists it;
broker_config_from_job layers the password back from the environment
(.mam.env) at connect time, so publish_event still connects from the record.
_atomic_write_record scrubs broker.password from any record it writes, and
`registry.py scrub-secrets [--dry-run]` migrates an existing registry.
auth_token/dispatch_token stay: the agent's own publish_event needs them.

Issue #8 - update.sh restored the pre-update asset_hashes.txt and version.txt
over the installer's fresh ones, so version.txt named the previous commit and
remove.sh backed up every pristine updated file as "locally modified". The
success path now keeps the installer's stamps and only merges install_state
keys the re-install did not write (gitignore_created); the failure path
still restores everything verbatim.

Issue #7 - the shim's new-session took the first same-cwd pane, always found
the full first workspace, judged it overflow and opened another workspace per
agent (4 + 1 + 1). It now walks every same-cwd workspace in pane order and
takes the first with an idle pane or room in its 2xK grid; a workspace is
created only when all are full (4 + 2).

Tests: test_issue7_workspace_packing.py (3; the mock herdr gains an opt-in
per-workspace 2x2 geometry), test_issue8_update_state.py (1, real
install+update cycle), test_issue12_registry_secrets.py (4); registry CLI
snapshot and help capture refreshed for the intentional scrub-secrets
subcommand; registry.md documents the broker block.

Refs #12 #8 #7

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VCgu9Fa9iT7TbJUSzdq4Ff
2026-09-13 11:23:19 +09:00
GodopuandClaude Opus 5 508ca99d71 docs(issue-5): phase 1 benchmark results, contract mapping, task checklist
Records the measured numbers and syncs every document that names the
delegation script paths, then bumps the framework to 4.3.0 in the three-way
lockstep (lib.sh, VERSIONS.md current + matrix, eight SKILL.md frontmatters).

phase1-benchmark.md carries both arms. The deterministic fake transport is what
CI asserts on: 50 publishes cost 50 connections one-shot and 1 persistent, p50
54.813ms -> 0.002ms. The real broker run is informational, since the PoC
default is a public broker: p50 1892.728ms -> 275.992ms, about 85% off.

It also corrects the plan's own estimate rather than repeating it. D8 predicted
the new shell path would drop from 3 forks to 2; the implementation is still 3,
because keeping the `_delegate_script publish_event.py` lookup is the only
thing that produces the "missing script tree does nothing" non-fatal contract
that C-02 pins. Saving that fork would change the contract, so it is deferred
to phase 4 rather than taken quietly.

SKILL.md gains the context table saying which tree wins where, so an operator
reading it knows a frozen loop runs frozen delegation code. The script paths in
every document remain correct and every quoted command still works verbatim.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UrDNJkHmm18uu7n7JwV5Qd
2026-09-06 15:48:38 +09:00
Godopu 76f10b2096 feat(agent): add full codex agent support (v4.2.0)
- Implement CodexAdapter in lib_py/agents/adapters/codex.py with safe flags and TUI readiness
- Extend create_session, resume_session, stop_session, and reconcile for codex CLI
- Support codex agent delegation and loop integration across all multi-agent skills
- Add unit, component, and contract test suites for codex integration
- Verify all 462 tests passing cleanly
2026-09-05 23:02:29 +09:00
Godopu cfa15eadee docs(cleanup): remove redundant root-level bug report and synchronize project documentation to v4.1.3 2026-09-02 09:01:04 +09:00
Godopu f57cd5cdde feat(agent): deprecate and completely remove cline agent support
- Delete adapters/cline.py and unregister from registry.py
- Remove cline branches from lib.sh and all 8 skill scripts (create, resume, stop, status, reconcile, update_yaml_resumed, resolve_session_id, orc_onboard)
- Narrow own-key mapping dictionaries across lib_py core modules to 4 supported agents
- Delete cline-exclusive tests and retarget shared fixtures to grok/hermes/claude
- Update skills documentation and installation guides (439 passed, 0 failures)
- Archive cline deprecation consensus and review reports
2026-08-28 22:38:48 +09:00
Godopu 87b4501bbf feat(mux-loop): redesign role CLI flags with --creator and --planner, drop --target-agent
- Replace '--target-agent' with mandatory '--creator <session>' flag
- Add explicit rejection error for legacy '--target-agent'
- Add '--planner <session>' flag with fail-fast check when '--plan' is missing
- Implement 2-branch session validation ('is not registered' vs 'is not running')
- Update in-repo references in hooks, SKILL.md, INSTALL.md, and tests
- Add tests/test_loop_cli.py with 9 unit/contract tests
2026-08-26 14:03:20 +09:00
Godopu 31b2d70ffe fix(lib,reconcile,test): address Claude review findings and verify 100% PASS
- lib.sh: distinguish unobservable/headless (rc=2) from unsettled panes in _pane_quiescent; restore 10s quiescence window with early giveup (SKS_EMPTY_GIVEUP)
- reconcile.sh: fix SKILLS_DIR command substitution logic (&& pwd instead of || pwd)
- tests/test_b19_headless_reconcile_fixes.py: implement mutation-proven regression tests for headless prompt bypass, slow-settling panes with persistent counters, and real reconcile.sh SKILLS_DIR evaluation
- deploy/ & IMPROVEMENTS.md: document nats submodule access notes and B-19/B-20 evolution
- Promoted Reviewer Claude's final 100% PASS report (report-119b9f57.md)
2026-08-23 20:57:38 +09:00
Godopu f133e52863 docs(deploy): synchronize deploy/ assets with nats-docker submodule and hermes prefix defaults 2026-08-23 16:40:22 +09:00
Godopu adecff2194 docs: synchronize MESSAGING.md, IMPROVEMENTS.md, implementation_plan.md and add D-31/D-32 freshness guards 2026-08-23 16:22:10 +09:00
Godopu caffd04f36 feat(lib): implement A-4 M0~M1 BaseAgentAdapter pattern and resolve_home contract 2026-08-14 08:44:36 +09:00
Godopu e10db8966e refactor(lib): extract large inline python blocks to lib_py package and optimize abstraction layer 2026-08-13 22:57:11 +09:00
Godopu da92624273 docs(deploy): add --remove offboarding command to INSTALL.md and save review report 2026-08-12 14:37:50 +09:00
Godopu f9b51b3ab3 docs(deploy): add multi-agent-mux-orc-onboard section to INSTALL.md 2026-08-12 14:22:15 +09:00
Godopu 6be1b6aecb feat(skill): implement multi-agent-mux-orc-onboard skill and orchestrator_uuids exclusion gate (40/40 PASS) 2026-08-12 12:49:33 +09:00
Godopu c7df7ffd68 fix(loop): resolve O-2 atomic race-free lock and marker ownership release guard (22/22 PASS) 2026-08-11 12:30:16 +09:00
Godopu f8084cd927 fix(loop): resolve P0-1 (B-7) git diff CWD isolation and untracked file capture (20/20 PASS) 2026-08-11 09:39:57 +09:00
Godopu 399242dac5 feat(deploy): implement lib_ownership, registry merge, and deployment test suite 2026-08-07 23:48:49 +09:00
Godopu 5ab76874e4 fix(c2): remove unused .cache directory creation and clean up state dead code (100% PASS) 2026-08-07 09:01:44 +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 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 002d9b268d feat: add force-refresh capability and allow framework-owned skill updates during installation 2026-07-27 13:16:14 +09:00
Godopu f0a2103edf refactor(isolation): simplify agent session isolation and remove legacy home-isolation helpers 2026-07-23 22:05:29 +09:00
Antigravity 974941bdb4 fix(deploy): migrate deployment scripts and docs from tmux to herdr 2026-07-20 12:17:12 +09:00
Godopu 42b54d7643 Migrate backend to herdr using a seamless translation shim wrapper 2026-07-19 16:22:58 +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 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 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 6408f4a5ec feat(deploy): parameterize distribution URLs via MAM_*_URL env vars
- install.sh: REPO_URL and ARCHIVE_URL now use ${MAM_REPO_URL:-...} and ${MAM_ARCHIVE_URL:-...}
- update.sh: INSTALLER_URL now uses ${MAM_INSTALLER_URL:-...} with env-inheritance comment
- .env.example: add MAM_REPO_URL / MAM_ARCHIVE_URL / MAM_INSTALLER_URL section with usage notes
- deploy/README.md: add Custom Fork / Private Mirror installation examples
2026-07-09 12:05:43 +09:00
Godopu 0fa09b4d90 refactor: rename AGENT.md to MULTI_AGENT_RULES.md and consolidate INSTRUCTION.md into AGENTS.md
- .agents/AGENT.md -> .agents/MULTI_AGENT_RULES.md
- .agents/AGENT.ko.md -> .agents/MULTI_AGENT_RULES.ko.md
- INSTRUCTION.md -> AGENTS.md (root-level)
- Update create_session.sh onboarding prompt to reference new path
- All cross-references in BOOTSTRAP.md/.ko.md, README.md/.ko.md, SKILL_FEATURES.md updated
- Fix document title headers (# AGENT.md -> # MULTI_AGENT_RULES.md, # CLAUDE.md -> # AGENTS.md)
2026-07-09 12:04:25 +09:00
Godopu 57d8f6c2ff refactor: move AGENT.md and AGENT.ko.md to .agents/ directory 2026-06-26 21:28:41 +09:00
Godopu b47fcbda9b fix(deploy): resolve TARGET_DIR to absolute path in update.sh 2026-06-24 12:29:00 +09:00
Godopu 5da6e59d2f fix(deploy): fix update.sh fallback mode, trap rollback, and database names 2026-06-24 12:28:17 +09:00
Godopu 701d3f10d9 Add MAM updater script (update.sh) and integrate into installer copy block 2026-06-24 12:24:17 +09:00
Godopu 5d69ad4f0b Harden remove.sh: fix fallback data-loss risk, prevent remove.sh clobbering, and ensure macOS compatibility 2026-06-24 12:08:00 +09:00
Godopu db75b7deb0 Add MAM uninstaller script (remove.sh) and integrate into installer copy block 2026-06-24 11:49:45 +09:00
Godopu b37407874d Harden installer: partial-install detection, complete runtime docs, explicit copy checks 2026-06-24 10:43:08 +09:00
GodopuandClaude Opus 4.8 387b43d8e3 fix(deploy): stage installer download and copy runtime assets no-clobber (FW-D1)
deploy/install.sh extracted the repo archive in-place with
`tar --strip-components=1`, which inside an existing project could silently
overwrite the target's own README.md/FUTURE_WORKS.md/etc and litter it with
this repo's dev docs.

Rebuild the fetch path:
- stage the clone/extract into a `mktemp -d` dir, never in-place
- verify `.agents/skills/lib.sh` is present before copying anything
- copy only runtime assets (.agents/, AGENT.md, .env.example) into the target
  with per-file no-clobber guards (`[ ! -e ]`), so existing files always win
- post-fetch sanity check now tests a file, not just the directory
- fail fast when neither git nor curl is available

Use explicit `[ ! -e ]` guards + a POSIX find merge rather than `cp -n`
(non-portable; emits a deprecation warning on GNU coreutils 9.x). The earlier
`tar --exclude` denylist idea was rejected in review: non-portable and the
unanchored `--exclude="scripts"` pattern stripped the skills' own nested
scripts/ dirs, yielding a silently broken install.

Mark FW-D1 resolved and FW-D2 partially addressed in FUTURE_WORKS.md/.ko.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-24 10:33:05 +09:00
Godopu 7eaaaf8944 fix(lib,install): update locking doc to SQLite transaction, cache NFS check, verify PyYAML 2026-06-23 23:41:18 +09:00
Godopu 25cf729040 fix(deploy): add directory creation guard and sanity check after download in installer 2026-06-23 23:22:45 +09:00
Godopu 1d2eca57ce fix(deploy): automatically download .agents/skills from Gitea if missing in installer 2026-06-23 23:16:00 +09:00
Godopu 82dcb78a85 fix(deploy): refine install.sh variables, pip upgrade, permissions, and active defaults based on review 2026-06-23 08:32:02 +09:00
Godopu 6cd0d5333a feat(deploy): add Gitea deployment templates, installer, and CI/CD workflow 2026-06-23 08:22:41 +09:00