feat(FN-1451): complete Step 5 — document hierarchy resolution

This commit is contained in:
gsxdsm
2026-04-13 13:00:05 -07:00
parent c26afccd0c
commit ccb5ef8ce4
3 changed files with 9 additions and 3 deletions

View File

@@ -0,0 +1,5 @@
---
"@gsxdsm/fusion": patch
---
Fix companies.sh agent imports so manager/report references like slugs and relative `AGENTS.md` paths resolve to real Fusion agent IDs, preserving team hierarchy across dashboard and CLI imports.

View File

@@ -429,10 +429,11 @@ Fusion can import agents from [companies.sh](https://companies.sh) packages. The
#### Team Hierarchy #### Team Hierarchy
When importing a companies.sh package with team structure, Fusion preserves the manager/report hierarchy: When importing a companies.sh package with team structure, Fusion preserves the manager/report hierarchy for both dashboard and CLI imports:
- Team managers are imported with their defined capabilities and instructions - Team managers are imported with their defined capabilities and instructions
- Reports are linked to their manager via the `reportsTo` field using Fusion agent IDs - Manifest-style manager references such as `ceo`, `../ceo/AGENTS.md`, and already-valid Fusion agent IDs are resolved into real Fusion `reportsTo` agent IDs before agents are persisted
- Partial imports and `--skip-existing` runs reuse matching existing Fusion agents as managers when possible, so follow-up imports keep the same org tree instead of flattening new reports
- The import summary shows team count and hierarchy links - The import summary shows team count and hierarchy links
#### CLI Usage #### CLI Usage

View File

@@ -241,7 +241,7 @@ Import agents from [companies.sh](https://companies.sh) packages. Supports singl
| `--skip-existing` | Skip agents with names that already exist in Fusion | | `--skip-existing` | Skip agents with names that already exist in Fusion |
**Team hierarchy:** **Team hierarchy:**
When importing a companies.sh package with team structure, the importer preserves manager/report relationships. Agents are linked using Fusion agent IDs (not manifest paths). When importing a companies.sh package with team structure, the importer preserves manager/report relationships for both fresh and partial imports. Manifest-style manager references such as `ceo`, `../ceo/AGENTS.md`, and already-valid Fusion agent IDs are resolved to actual Fusion `reportsTo` agent IDs before agents are created, and `--skip-existing` reuses matching existing managers when available instead of flattening the org tree.
**Examples:** **Examples:**
```bash ```bash