{
  "generated_at": "2026-04-10T10:31:25.507Z",
  "system": {
    "id": "topolo-bytes",
    "name": "Bytes",
    "slug": "topolo-bytes",
    "kind": "application",
    "summary": "Media and asset management surface for uploads, organization, review, and sharing.",
    "aliases": [],
    "lifecycle": "active",
    "last_verified": "2026-04-07",
    "owners": [
      "media-platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloBytes"
    ],
    "service_ids": [
      "svc_r2_media_manager"
    ],
    "visibility": "public",
    "api_contract": {
      "type": "curated",
      "source": "PlatformApplications/TopoloDocs/src/content/public/applications/bytes.mdx",
      "notes": "Canonical Bytes coverage now lives in the docs application."
    },
    "primary_hosts": [
      "https://bytes.topolo.app",
      "https://bytes.pages.dev"
    ],
    "doc_paths": [
      "applications/bytes",
      "internal/apps/bytes"
    ],
    "dependencies": [
      "topolo-auth"
    ],
    "public_hub_url": "/systems/topolo-bytes",
    "internal_hub_url": null,
    "application_api_url": "/reference/apps/topolo-bytes",
    "generated_openapi_url": null,
    "machine_urls": {
      "system": "/machine/systems/topolo-bytes.json",
      "application": "/machine/applications/topolo-bytes.json"
    }
  },
  "docs": {
    "public": [
      {
        "id": "applications/bytes.mdx",
        "title": "Topolo Bytes",
        "summary": "Public overview of the media-management and sharing surface built around Cloudflare edge storage and media tooling.",
        "audience": "public",
        "tags": [
          "media",
          "assets",
          "sharing"
        ],
        "url": "/applications/bytes.mdx",
        "last_verified": "2026-04-07"
      }
    ],
    "internal": [],
    "runbooks": []
  },
  "authority": {
    "owners": [
      "media-platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloBytes"
    ],
    "service_ids": [
      "svc_r2_media_manager"
    ],
    "dependencies": [
      "topolo-auth"
    ],
    "aliases": []
  },
  "interfaces": {
    "contract_type": "curated",
    "contract_source": "PlatformApplications/TopoloDocs/src/content/public/applications/bytes.mdx",
    "contract_source_exists": true,
    "openapi": null,
    "readme": {
      "path": "PlatformApplications/TopoloBytes/README.md",
      "intro": [
        "Canonical documentation for Topolo Bytes lives in `PlatformApplications/TopoloDocs`.",
        "Use this repository for implementation only. Local product and operational docs have been retired in favor of the docs application."
      ],
      "headings": [
        "Topolo Bytes"
      ],
      "routeHighlights": [],
      "commandHighlights": []
    }
  },
  "auth": {
    "depends_on_topolo_auth": true,
    "api_key_scopes": [
      {
        "name": "files.read",
        "description": "View and download files",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "files.write",
        "description": "Upload and edit files",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "folders.read",
        "description": "View folder structure",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "folders.write",
        "description": "Create and organize folders",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "shares.read",
        "description": "View shared files and permissions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "shares.write",
        "description": "Share files and manage permissions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "media.read",
        "description": "View media assets",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "media.write",
        "description": "Manage media assets",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "settings.read",
        "description": "View Bytes settings",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "settings.write",
        "description": "Manage Bytes settings",
        "resourcePattern": null,
        "kind": "api_key_scope"
      }
    ],
    "service_permissions": [
      {
        "name": "files:read",
        "description": "View and download files",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "files:write",
        "description": "Upload and edit files",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "files:delete",
        "description": "Delete files and folders",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "folders:read",
        "description": "View folder structure",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "folders:write",
        "description": "Create and organize folders",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "sharing:read",
        "description": "View shared files and permissions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "sharing:write",
        "description": "Share files and manage permissions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "storage:read",
        "description": "View storage usage and analytics",
        "resourcePattern": null,
        "kind": "permission"
      }
    ]
  },
  "runtime": {
    "primary_hosts": [
      "https://bytes.topolo.app",
      "https://bytes.pages.dev"
    ],
    "repo_entries": [
      "PlatformApplications/TopoloBytes/README.md",
      "PlatformApplications/TopoloBytes/apps/",
      "PlatformApplications/TopoloBytes/docker/",
      "PlatformApplications/TopoloBytes/package.json",
      "PlatformApplications/TopoloBytes/pnpm-lock.yaml",
      "PlatformApplications/TopoloBytes/pnpm-workspace.yaml",
      "PlatformApplications/TopoloBytes/scripts/",
      "PlatformApplications/TopoloBytes/src/",
      "PlatformApplications/TopoloBytes/start-dev-simple.sh",
      "PlatformApplications/TopoloBytes/start-dev.sh",
      "PlatformApplications/TopoloBytes/topolo.cloudcontrol.json"
    ],
    "wrangler_surfaces": [
      {
        "path": "PlatformApplications/TopoloBytes/apps/web/wrangler.toml",
        "observabilityEnabled": false,
        "environments": [],
        "routes": [],
        "vars": [],
        "bindings": [],
        "cronTriggers": [],
        "workerName": "bytes",
        "compatibilityDate": "2024-06-05"
      },
      {
        "path": "PlatformApplications/TopoloBytes/apps/worker/wrangler.toml",
        "observabilityEnabled": false,
        "environments": [],
        "routes": [],
        "vars": [
          "SERVICE_ID"
        ],
        "bindings": [
          {
            "kind": "kv",
            "binding": "SHARE_LINKS",
            "sourcePath": "PlatformApplications/TopoloBytes/apps/worker/wrangler.toml",
            "target": "728a7a682f024c468f6f55fd3dce64d6"
          },
          {
            "kind": "vectorize",
            "binding": "VEC",
            "sourcePath": "PlatformApplications/TopoloBytes/apps/worker/wrangler.toml",
            "target": "media-embeddings"
          }
        ],
        "cronTriggers": [
          "*/5 * * * *"
        ],
        "workerName": "r2-media-manager-worker",
        "main": "src/index.ts",
        "compatibilityDate": "2024-06-05"
      }
    ],
    "packages": [
      {
        "path": "PlatformApplications/TopoloBytes/apps/desktop/package.json",
        "name": "desktop",
        "scripts": [
          "dev",
          "build",
          "tauri"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "vite"
          },
          {
            "name": "build",
            "command": "tsc -b && vite build"
          },
          {
            "name": "tauri",
            "command": "tauri"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloBytes/apps/web/package.json",
        "name": "web",
        "scripts": [
          "dev",
          "build",
          "lint",
          "preview",
          "test",
          "typecheck",
          "test:ui",
          "test:coverage",
          "test:watch"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "vite"
          },
          {
            "name": "build",
            "command": "VITE_API_BASE=https://r2-media-manager-worker.topolo.workers.dev tsc -b && vite build"
          },
          {
            "name": "lint",
            "command": "eslint ."
          },
          {
            "name": "preview",
            "command": "vite preview"
          },
          {
            "name": "test",
            "command": "vitest"
          },
          {
            "name": "typecheck",
            "command": "tsc --noEmit"
          },
          {
            "name": "test:ui",
            "command": "vitest --ui"
          },
          {
            "name": "test:coverage",
            "command": "vitest --coverage"
          },
          {
            "name": "test:watch",
            "command": "vitest --watch"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloBytes/apps/worker/package.json",
        "name": "worker",
        "description": "Cloudflare Worker for R2 Media Manager",
        "scripts": [
          "dev",
          "deploy",
          "deploy:dry-run",
          "start",
          "cf-typegen",
          "lint",
          "typecheck",
          "test",
          "build"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "wrangler dev"
          },
          {
            "name": "deploy",
            "command": "wrangler deploy"
          },
          {
            "name": "deploy:dry-run",
            "command": "wrangler deploy --dry-run --config wrangler.toml"
          },
          {
            "name": "start",
            "command": "wrangler dev"
          },
          {
            "name": "cf-typegen",
            "command": "wrangler types"
          },
          {
            "name": "lint",
            "command": "tsc --noEmit"
          },
          {
            "name": "typecheck",
            "command": "tsc --noEmit"
          },
          {
            "name": "test",
            "command": "node --test"
          },
          {
            "name": "build",
            "command": "tsc --noEmit"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloBytes/package.json",
        "name": "r2-media-manager",
        "description": "",
        "scripts": [
          "dev",
          "dev:desktop",
          "dev:worker",
          "dev:worker:bg",
          "dev:worker:remote",
          "dev:web",
          "build",
          "build:desktop",
          "build:all",
          "deploy:worker",
          "deploy:web",
          "deploy",
          "smoke:local",
          "smoke:prod",
          "test"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "concurrently -n \"worker,web\" -c \"cyan,magenta\" \"pnpm run dev:worker:remote\" \"pnpm run dev:web\""
          },
          {
            "name": "dev:desktop",
            "command": "pnpm --filter desktop dev"
          },
          {
            "name": "dev:worker",
            "command": "wrangler dev --persist-to .wrangler/state --config apps/worker/wrangler.toml"
          },
          {
            "name": "dev:worker:bg",
            "command": "wrangler dev --persist-to .wrangler/state --config apps/worker/wrangler.toml --show-interactive-dev-session=false"
          },
          {
            "name": "dev:worker:remote",
            "command": "wrangler dev --remote --config apps/worker/wrangler.toml"
          },
          {
            "name": "dev:web",
            "command": "cd apps/web && pnpm run dev"
          },
          {
            "name": "build",
            "command": "cd apps/web && pnpm run build"
          },
          {
            "name": "build:desktop",
            "command": "pnpm --filter desktop build"
          },
          {
            "name": "build:all",
            "command": "pnpm run --filter worker build && pnpm run --filter web build"
          },
          {
            "name": "deploy:worker",
            "command": "wrangler deploy --config apps/worker/wrangler.toml"
          },
          {
            "name": "deploy:web",
            "command": "cd apps/web && pnpm build && cp -r functions dist/ && npx wrangler pages deploy dist --project-name=bytes --branch=main"
          },
          {
            "name": "deploy",
            "command": "pnpm deploy:worker && pnpm deploy:web"
          },
          {
            "name": "smoke:local",
            "command": "node scripts/smoke.mjs http://localhost:8787"
          },
          {
            "name": "smoke:prod",
            "command": "node scripts/smoke.mjs https://nodomedia.pages.dev"
          },
          {
            "name": "test",
            "command": "pnpm smoke:local"
          }
        ]
      }
    ]
  },
  "data": {
    "env_vars": [
      "SERVICE_ID"
    ],
    "bindings": [
      {
        "kind": "kv",
        "binding": "SHARE_LINKS",
        "sourcePath": "PlatformApplications/TopoloBytes/apps/worker/wrangler.toml",
        "target": "728a7a682f024c468f6f55fd3dce64d6"
      },
      {
        "kind": "vectorize",
        "binding": "VEC",
        "sourcePath": "PlatformApplications/TopoloBytes/apps/worker/wrangler.toml",
        "target": "media-embeddings"
      }
    ],
    "queue_bindings": [],
    "storage_kinds": [
      "kv",
      "vectorize"
    ],
    "workflow_signals": [
      "cron */5 * * * *"
    ]
  },
  "deployment": {
    "commands": [
      {
        "name": "build",
        "command": "PlatformApplications/TopoloBytes/apps/desktop/package.json :: tsc -b && vite build"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloBytes/apps/web/package.json :: VITE_API_BASE=https://r2-media-manager-worker.topolo.workers.dev tsc -b && vite build"
      },
      {
        "name": "preview",
        "command": "PlatformApplications/TopoloBytes/apps/web/package.json :: vite preview"
      },
      {
        "name": "deploy",
        "command": "PlatformApplications/TopoloBytes/apps/worker/package.json :: wrangler deploy"
      },
      {
        "name": "deploy:dry-run",
        "command": "PlatformApplications/TopoloBytes/apps/worker/package.json :: wrangler deploy --dry-run --config wrangler.toml"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloBytes/apps/worker/package.json :: tsc --noEmit"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloBytes/package.json :: cd apps/web && pnpm run build"
      },
      {
        "name": "build:desktop",
        "command": "PlatformApplications/TopoloBytes/package.json :: pnpm --filter desktop build"
      },
      {
        "name": "build:all",
        "command": "PlatformApplications/TopoloBytes/package.json :: pnpm run --filter worker build && pnpm run --filter web build"
      },
      {
        "name": "deploy:worker",
        "command": "PlatformApplications/TopoloBytes/package.json :: wrangler deploy --config apps/worker/wrangler.toml"
      },
      {
        "name": "deploy:web",
        "command": "PlatformApplications/TopoloBytes/package.json :: cd apps/web && pnpm build && cp -r functions dist/ && npx wrangler pages deploy dist --project-name=bytes --branch=main"
      },
      {
        "name": "deploy",
        "command": "PlatformApplications/TopoloBytes/package.json :: pnpm deploy:worker && pnpm deploy:web"
      }
    ],
    "routes": [],
    "environments": [],
    "assets_directories": [],
    "observability_enabled": false
  },
  "debugging": {
    "failure_modes": [],
    "entrypoints": [
      "PlatformApplications/TopoloBytes/apps/web/wrangler.toml",
      "PlatformApplications/TopoloBytes/apps/worker/wrangler.toml",
      "PlatformApplications/TopoloDocs/src/content/public/applications/bytes.mdx",
      "PlatformApplications/TopoloBytes/README.md",
      "PlatformApplications/TopoloBytes/apps/desktop/package.json",
      "PlatformApplications/TopoloBytes/apps/web/package.json",
      "PlatformApplications/TopoloBytes/apps/worker/package.json",
      "PlatformApplications/TopoloBytes/package.json"
    ]
  }
}