Welcome to the Bluefly.io code repository. By logging in, you agree to comply with our terms of service and code of conduct.

Skip to content

Archive Old Structure and Clean Up Migrated Code

Objective

Move all migrated services, documentation, and deprecated files to __DELETE_LATER/ for safe archival before final deletion.

Files to Archive

Service Directories

```bash mv apidog-sync/ __DELETE_LATER/apidog-sync-migrated-to-agent-router/ mv design-system-api/ __DELETE_LATER/design-system-api-migrated-to-studio-ui/ ```

Documentation Files

```bash mv branding/.md __DELETE_LATER/docs-archive/branding/ mv branding/foundations/.md __DELETE_LATER/docs-archive/branding/foundations/ mv openapi/README.md __DELETE_LATER/docs-archive/openapi/ mv apidog-sync/docs/ __DELETE_LATER/docs-archive/apidog-sync/ mv design-system-api/docs/ __DELETE_LATER/docs-archive/design-system-api/ ```

OpenAPI Component Specs

```bash mv openapi/components/ __DELETE_LATER/openapi-components-archive/

Keep only registry.yaml and platform-index.yaml in openapi/

```

Deprecated Scripts

```bash

Find and move all .sh files

find . -name ".sh" -not -path "/node_modules/" -not -path "/__DELETE_LATER/*"
-exec mv {} __DELETE_LATER/deprecated-scripts/ ;

Move any Makefiles

find . -name "Makefile" -not -path "/node_modules/"
-exec mv {} __DELETE_LATER/deprecated-makefiles/ ; ```

Archive Structure

``` __DELETE_LATER/ ├── apidog-sync-migrated-to-agent-router/ │ ├── src/ │ ├── tests/ │ ├── proto/ │ └── README.md ├── design-system-api-migrated-to-studio-ui/ │ ├── src/ │ ├── tests/ │ └── README.md ├── docs-archive/ │ ├── branding/ │ │ ├── BRAND_GUIDELINES.md │ │ ├── foundations/ │ │ └── ... │ ├── openapi/ │ └── apidog-sync/ ├── openapi-components-archive/ │ ├── studio-ui-api.yaml │ ├── agent-mesh-api.yaml │ └── ... ├── deprecated-scripts/ │ └── *.sh files └── deprecated-makefiles/ └── Makefile ```

Create Migration Notes

```markdown

__DELETE_LATER/MIGRATION_NOTES.md

Services Migrated

apidog-sync → agent-router + agent-buildkit

  • When: 2025-10-XX
  • New Locations:
    • Runtime: agent-router/src/services/apidog/
    • CLI: agent-buildkit CLI commands
  • GitLab Issues: #2, #9

design-system-api → studio-ui

  • When: 2025-10-XX
  • New Location: studio-ui/src/api/services/design-system/
  • GitLab Issues: #3, #10

Documentation Migrated to Wiki

  • Brand Guidelines → Wiki: "Brand Guidelines"
  • API Documentation → Wiki: "OpenAPI Registry"
  • All .md files archived here

OpenAPI Specs Decentralized

  • Each service now owns its spec
  • See: GitLab Issue #4
  • Registry index: openapi/registry.yaml

Safe to Delete After

  • All dependent projects updated (Issue #12)
  • CI/CD pipelines passing (Issue #13)
  • Integration tests passing (Issue #16)
  • Minimum 30 days archived ```

Update README

  • Document new structure
  • Add migration guide with links
  • Reference GitLab Wiki for documentation
  • List what stayed vs. what moved
  • Link to Epic #1 for full context

New README Structure

```markdown

Technical Guide - Standards Library

A standards library for the LLM Platform ecosystem.

What's Included

  • Design tokens (colors, typography, spacing)
  • API registry index
  • Brand/API validators
  • Shared OpenAPI schemas

What Moved

  • apidog-sync → agent-router (Issue #2)
  • design-system-api → studio-ui (Issue #3)
  • OpenAPI specs → owning projects (Issue #4)
  • Documentation → GitLab Wiki (Issue #6)

Installation

```bash npm install @bluefly/technical-guide ```

Usage

```typescript import { colors, typography } from '@bluefly/technical-guide/tokens'; import { validateBrand } from '@bluefly/technical-guide/validation'; ```

Documentation

See GitLab Wiki: Technical Guide Documentation ```

Verification Before Archival

  • All services running in new locations
  • All tests passing
  • No references to old paths in code
  • No imports from archived directories
  • CI/CD using new structure

Tasks

  • Create __DELETE_LATER/ directory structure
  • Move apidog-sync
  • Move design-system-api
  • Move all .md documentation files
  • Move OpenAPI component specs
  • Move shell scripts
  • Move Makefiles
  • Create MIGRATION_NOTES.md
  • Update root README.md
  • Verify no broken references
  • Git commit with clear message

Related

  • Epic: #1
  • Depends on: #2-#13 (all migrations and updates complete)
  • Next: #16 (integration testing)

Git Commit Message

``` chore: archive migrated services and documentation

  • Move apidog-sync to __DELETE_LATER/ (migrated to agent-router)
  • Move design-system-api to __DELETE_LATER/ (migrated to studio-ui)
  • Archive documentation (migrated to GitLab Wiki)
  • Archive OpenAPI components (decentralized to projects)
  • Remove shell scripts and Makefiles
  • Update README with new structure

Refs: #1, #2, #3, #4, #6 ```

Success Criteria

  • ✅ All migrated code archived
  • ✅ __DELETE_LATER/ properly structured
  • ✅ MIGRATION_NOTES.md created
  • ✅ README updated
  • ✅ No broken references
  • ✅ Repository clean and < 100MB