flower
/
1

review · segments

Forge inventory cleanup: tangols relocation, Herd consolidation, Envoyer doc upd

claude 664 events 4 segments HEAD

segment 1 of 4

Explore _web_admin and Herd to understand Forge inventory and identify Herd-served projects

Done

Explored _web_admin directory finding existing Forge inventory tool (forge-refresh.php, forge-inventory.md). Scanned ~/Herd finding three projects: lsnet (actually tangols.com, 237 commits ahead), tarkovai_backup (dead 2023 scaffold, no remote), tmi-cluster (redundant with code/tmi-cluster). Identified tangols as the misnamed project served from Herd.

outcome

Complete picture: _web_admin already inventories Forge (2 orgs, 24 servers, 41 sites, 87 repos); Herd had 3 projects where lsnet is actually tangols.com, tarkovai_backup and tmi-cluster stale.

next steps

—

key decisions

  • Tangols relocation strategy deferred to user decision.

open questions

—

1 week ago → 1 week ago

segment 2 of 4

Relocate tangols from Herd to code/ and clean stale Herd directories

Done

User decided to push tangols first (237 commits to GitHub), then move ~/Herd/lsnet → ~/Documents/code/tangols, create symlink in Herd for dev URL. Also delete stale ~/Herd/tarkovai_backup and ~/Herd/tmi-cluster (both guard-checked clean). Pushed successfully, moved, symlinked, deleted.

outcome

tangols now at ~/Documents/code/tangols (git remote origin), Herd symlink lsnet → code/tangols; stale dirs removed; Herd clean with only logs and two symlinks.

next steps

—

key decisions

  • Push first before move to avoid losing 237 commits
  • Use symlink in Herd (like tarkovai pattern) so dev URL continues working
  • Delete stale Herd dirs outright (both clean, no unpushed work)

open questions

—

1 week ago → 1 week ago

segment 3 of 4

Update forge-inventory.md documentation to close tangols identification gap

Done

Edited _web_admin/docs/forge-inventory.md: replaced 'tangols.com unidentified app – parked' with detailed note identifying repo mferrara/tangols, relocation, and symlink pattern. Updated open follow-up bullet from unchecked to checked 'resolved 2026-06-27'. Corrected the note about auto-correlation to clarify that Envoyer-managed sites won't auto-link.

outcome

forge-inventory.md now documents tangols identity and relocation; open follow-up resolved.

next steps

—

key decisions

  • Document correctly that Envoyer sites won't auto-correlate in forge-refresh.php
  • Mark tangols identification as resolved

open questions

—

1 week ago → 1 week ago

segment 4 of 4

Implement tangols.test rename, update project files, delegate Envoyer/catalog documentation to Solo agents

In progress

User requested: (1) rename dev URL from lsnet.test to tangols.test, update APP_NAME, update AGENTS.md; (2) hand-wire Envoyer sites into forge-inventory.md; (3) update main code catalog (CLAUDE.md) with tangols row and clarify lsnet. Assistant investigated Herd config, renamed symlink lsnet→tangols, cleaned orphaned nginx conf, re-isolated to PHP 8.4. Spawned two Solo Claude workers: w-envoyer-wire (process 916) to add Envoyer table to forge-inventory.md, and w-catalog-update (process 917) to add tangols row to CLAUDE.md. Both workers completed and posted 'READY FOR REVIEW' comments. Assistant reviewed outputs and found edits correct. Remaining: update tangols .env (APP_NAME, APP_URL), update tangols AGENTS.md with name change note, complete todos, close workers, fix Solo project 15 path.

outcome

Herd URL renamed to tangols.test, PHP 8.4 isolated, orphaned lsnet.test nginx removed. Envoyer table added to forge-inventory.md (5 projects). Catalog updated with tangols row and clarified lsnet. Solo agent edits pending final review/completion. .env and AGENTS.md not yet updated.

next steps

  • Update tangols .env: APP_NAME to Tangols, APP_URL to http://tangols.test
  • Update tangols AGENTS.md to note the rename (lsnet.test→tangols.test, APP_NAME change) for future agents
  • Complete todos 616 and 617 after final verification of worker edits
  • Close Solo worker processes 916 and 917
  • Update Solo project 15 (lsnet) name and path to reflect tangols relocation

key decisions

  • Delegate doc tasks to Solo workers per _solo-playbook.md while orchestrator handles live Herd config
  • Preserve Herd symlink pattern for dev URL (like tarkovai) rather than unlinking
  • Use herd isolate 8.4 explicitly on the new symlink to be robust to default changes

open questions

  • Whether to change tangols AGENTS.md stack note about dev URL (lsnet.test still works as symlink but tangols.test is new canonical)

1 week ago → 1 week ago