iiRecord
Agentic AI Atlas · Directory Moves
page:docs-adapters-terminology-and-structure-gaps-directory-movesa5c.ai
II.
Page JSON

page:docs-adapters-terminology-and-structure-gaps-directory-moves

Structured · live

Directory Moves json

Inspect the normalized record payload exactly as the atlas UI reads it.

File · wiki/docs/adapters/terminology-and-structure-gaps/directory-moves.mdCluster · wiki
Record JSON
{
  "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"
    }
  ]
}