foundry sync
Reconcile intent (the manifest) against reality (the filesystem) and write .foundry/workspace.yml — a path map telling Foundry where each declared service actually lives on disk, plus any drift.
Usage
foundry sync [--dry-run]Options
| Flag | Description |
|---|---|
--dry-run | Show what would be resolved without writing workspace.yml |
When to run it
- After adding or removing services in
foundry.json - After renaming a service directory
- After pulling changes that modify the project structure
- Any time you want to verify the workspace state
Drift
Sync reports three kinds of drift between the manifest and the filesystem:
| Kind | Meaning |
|---|---|
| Undeclared | A component directory exists on disk but is not in the manifest |
| Missing | A service is declared in the manifest but has no directory on disk |
| Mismatch | The detected runtime differs from the manifest's declared stack.framework |
workspace.yml
The output is intentionally minimal — service→path mappings plus drift. All other service metadata stays in foundry.json. workspace.yml is committed (team-shared); see .foundry/workspace.yml for its structure.