unic / unic/unic-agents-plugins
bug(unic-archon-dlc, upstream: Archon): a folder project registered on a parent directory swallows every child clone, and `doctor` passes it
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 1
- Forks
- 0
- Avg merge
- 16h 43m
- Merged PRs (30d)
- 19
Description
Observed
~/.archon/archon.db remote_agent_codebases held one row, FZAG | /home/otf/Sites/FZAG | kind: folder | default_branch: (empty), registered by the maintainer through the Archon Serve UI by mistake (meant the clone). ~/Sites/FZAG is a customer folder with three clones and is not a repository. Effects: a dispatch from inside DXP-DesignSystem printed "Folder project — running in place (no worktree isolation)" and ran on develop in the clone; worktree.baseBranch: develop from the committed .archon/config.yaml was never read (default_branch empty); listChildRepos made the row cover all three FZAG clones. archon doctor reported ✓ Folder project: "FZAG" (runs in place) — 3 contained repo(s) … All checks passed. No CLI verb removes a codebase.
Why it matters
One mis-click removes isolation for every repository under a customer folder, and the health check endorses it. In-place, the Box commits on develop and open-pr cannot push past the pre-push guard, so the leg would end without a PR.
Evidence
- Findings register, § "G. What run 3 taught about the instrument", row G3: https://github.com/unic/unic-agents-plugins/blob/bcf688a/docs/research/2026-08-31-dlc-run-2-findings.md
- Run record and harvested artefacts:
~/Desktop/run3-parked/on the maintainer's machine (run record § the first dispatch;archon doctoroutput quoted there) - Dispatch record: #457 from comment 5698289748 down
Not decided
- Upstream: a repo project inside a folder project's tree should win, or
doctorshould warn when a folder project contains git repositories. - Consumer doc row: verify the codebase row (
kind,default_cwd,default_branch) before any dispatch on a new machine; a dispatch header saying "running in place" means abandon.
Filed 2026-09-17 by wayfinder-orchestrator-10 from run 3's measurements. needs-specs: grill before dispatch.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by tracing codebase registration, listChildRepos, dispatch project selection, and the doctor check; the payload names no source files or tests. Reproduce the parent-folder case with a folder containing multiple clones, then establish the agreed precedence or warning behavior and verify that doctor no longer endorses the unsafe configuration.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript
- Domain
- cli
- Issue type
- Bug
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100