II.
Page JSON
Structured · livepage:docs-adapters-terminology-and-structure-gaps-directory-moves
Directory Moves json
Inspect the normalized record payload exactly as the atlas UI reads it.
{
"id": "page:docs-adapters-terminology-and-structure-gaps-directory-moves",
"_kind": "Page",
"_file": "wiki/docs/adapters/terminology-and-structure-gaps/directory-moves.md",
"_cluster": "wiki",
"attributes": {
"nodeKind": "Page",
"sourcePath": "docs/adapters/terminology-and-structure-gaps/directory-moves.md",
"sourceKind": "repo-docs",
"title": "Directory Moves",
"displayName": "Directory Moves",
"slug": "docs/adapters/terminology-and-structure-gaps/directory-moves",
"articlePath": "wiki/docs/adapters/terminology-and-structure-gaps/directory-moves.md",
"article": "\n# Directory Moves\n\n5 top-level adapter packages + 12 hooks-adapter packages need to move under the `packages/adapters/` umbrella.\n\n## Phase 1: Move Top-Level Adapter Packages\n\n```bash\ngit mv packages/transport-adapter packages/adapters/transport\ngit mv packages/extensions-adapter packages/adapters/extensions\ngit mv packages/triggers-adapter packages/adapters/triggers\ngit mv packages/tasks-adapter packages/adapters/tasks\ngit mv packages/tools-adapter packages/adapters/tools\n```\n\n## Phase 2: Move Hooks-Adapter Under Agent-Adapter\n\n```bash\ngit mv packages/adapters/hooks packages/adapters/hooks\n```\n\nThis moves all 12 hooks-adapter subpackages at once since they're already structured under a parent directory.\n\n## Phase 3: Update All References\n\nAfter directory moves, update:\n1. `package.json` workspace paths in root\n2. `tsconfig.json` references across all packages\n3. Import paths in source code (TypeScript `import ... from \"../../transport-adapter\"` etc.)\n4. `.github/workflows/*.yml` build paths\n5. `packages/atlas/graph/` source refs\n6. `docs/` file references\n\n## Phase 4: Rename Legacy Directories\n\n```bash\ngit mv packages/adapters/adapters-proxy packages/adapters/transport-proxy\ngit mv packages/adapters/meta/config/adapters packages/adapters/meta/config/adapters\n```\n\n## Impact Summary\n\n| Move | Packages Affected | Import Paths to Update |\n|------|------------------|----------------------|\n| transport-adapter → adapters/transport | 1 | ~30 files |\n| extensions-adapter → adapters/extensions | 1 | ~20 files |\n| triggers-adapter → adapters/triggers | 1 | ~15 files |\n| tasks-adapter → adapters/tasks | 1 | ~25 files |\n| tools-adapter → adapters/tools | 1 | ~10 files |\n| hooks-adapter → adapters/hooks | 12 | ~50 files |\n| adapters-proxy → transport-proxy | 1 | ~5 files |\n| **Total** | **18** | **~155 files** |\n\n## Execution Order\n\n1. Move directories (git mv)\n2. Update package.json names\n3. Regenerate package-lock.json\n4. Update all import paths\n5. Update tsconfig references\n6. Update CI workflows\n7. Build and test\n8. Commit\n",
"documents": []
},
"outgoingEdges": [],
"incomingEdges": [
{
"from": "page:docs-adapters-terminology-and-structure-gaps",
"to": "page:docs-adapters-terminology-and-structure-gaps-directory-moves",
"kind": "contains_page"
}
]
}