# Scripts Organization

This repository keeps script entrypoints stable while grouping new logic into subfolders.

## Top-level entrypoints

These are the commands you can run directly:

- `scripts/install-production-docker.sh`
- `scripts/finish-initial-setup.sh`
- `scripts/install-host-nextcloud-hybrid.sh`
- `scripts/update-host-nextcloud-hybrid.sh`
- `scripts/restart-host-nextcloud-hybrid.sh`
- `scripts/stop-host-nextcloud-hybrid.sh`
- `scripts/nuqloud-lifecycle.sh`
- `scripts/patch-user-oidc-invite-flow.sh`
- `scripts/setup-appstore-mimic.sh`
- `scripts/ensure-*.sh`
- `scripts/discover-cloud-topology.sh`
- `scripts/apply-topology-profile.sh`
- `scripts/diagnose-*.sh`

Useful diagnostics:

- `scripts/diagnose-nextcloud-occ-readiness.sh`
- `scripts/diagnose-qortal-gateway-route.sh`

## Subfolders

### `scripts/topology/`

Topology-aware setup scaffolding for app-store style installation paths:

- `discover-cloud-topology.sh`
  - detects runtime shape (repo Docker stack vs host Nextcloud)
  - outputs recommendation as JSON or text
- `../nuqloud-lifecycle.sh`
  - smart start/update/rebuild/stop wrapper for repo devprod and host-hybrid installs
  - delegates to the existing mature lifecycle scripts after topology detection
- `apply-topology-profile.sh`
  - applies recommended profile using existing install/recreate scripts
  - currently implemented profiles:
    - `repo-devprod-bootstrap`
    - `host-nextcloud-hybrid` (delegates to the host-hybrid installer)

## Compatibility policy

- Existing top-level script names remain valid.
- New grouped scripts may be called via top-level wrapper scripts.
- Future refactors should preserve wrappers so user workflows do not break.