chore: group src/ by clients, domain, and runtime (#5)

The flat src/ had clients, business logic, and process plumbing
sitting side by side, with a types.ts grab-bag that held unrelated
shapes for unrelated consumers. Grouping by role gives each folder
a single reason to exist: clients/ is everything that talks to the
outside world, domain/ is what a migration means (no HTTP, no
config, no process plumbing), and runtime/ is how the two get
wired to RabbitMQ and env vars.

types.ts splits along the same lines. Config moves next to
loadConfig in runtime/config.ts, the client response shapes
(NextcloudEntry, CozyFile, DiskUsage) move next to StackClient
in clients/stack-client.ts, and the tracking/migration data
contract stays in domain/types.ts.

File history is preserved through git mv. No behavior change;
typecheck and all 47 tests pass.

Author: rezk2ll

docs/development.md

@@ -25,19 +25,29 @@ cp .env.example .env
 
 ## Project structure
 
+The `src/` tree is grouped by role so each folder has a single reason to exist.
+
 ```
 src/
-  index.ts            Entry point — connects RabbitMQ, subscribes, handles shutdown
-  consumer.ts         Message handler — validation, idempotency, quota check, early ACK
-  migration.ts        Core logic — lazy directory traversal, file transfers, progress tracking
-  stack-client.ts     HTTP client for the Cozy Stack API (token refresh on 401)
-  cloudery-client.ts  HTTP client for the Cloudery token endpoint
-  tracking.ts         Tracking document helpers with CouchDB 409 conflict retry
-  config.ts           Environment variable parsing
-  types.ts            Type definitions and message validation
+  index.ts                  Entry point — connects RabbitMQ, subscribes, handles shutdown
+
+  clients/                  External integrations. Everything that talks to something outside the process.
+    stack-client.ts         Cozy Stack API (token refresh on 401)
+    cloudery-client.ts      Cloudery token endpoint
+    cozy-stack-client.d.ts  Type shim for the cozy-stack-client library
+
+  domain/                   What a migration is. No HTTP, no config, no process plumbing.
+    migration.ts            Core logic — lazy directory traversal, file transfers, progress tracking
+    tracking.ts             Tracking document helpers with CouchDB 409 conflict retry
+    doctypes.ts             Cozy doctype identifiers used across the codebase
+    types.ts                Migration command + tracking document schema
+
+  runtime/                  Process wiring. How domain + clients get started and fed.
+    consumer.ts             Message handler — validation, idempotency, quota check, early ACK
+    config.ts               Environment variable parsing + Config type
 
 test/
-  *.test.ts           Unit tests for each module (mocked HTTP, no real services needed)
+  *.test.ts                 Unit tests for each module (mocked HTTP, no real services needed)
 ```
 
 ## Testing

src/cloudery-client.ts src/clients/cloudery-client.tssrc/cloudery-client.ts renamed to src/clients/cloudery-client.ts

@@ -1,5 +1,5 @@
 import type { Logger } from 'pino'
-import { MIGRATION_TOKEN_SCOPE } from './doctypes.js'
+import { MIGRATION_TOKEN_SCOPE } from '../domain/doctypes.js'
 
 export interface ClouderyClient {
   getToken(workplaceFqdn: string): Promise<string>

src/cozy-stack-client.d.ts src/clients/cozy-stack-client.d.tssrc/cozy-stack-client.d.ts renamed to src/clients/cozy-stack-client.d.ts

@@ -2,13 +2,30 @@ import type { Logger } from 'pino'
 import cozyStackClientPkg from 'cozy-stack-client'
 import type { CozyStackClient as CozyStackClientType } from 'cozy-stack-client'
 import type { ClouderyClient } from './cloudery-client.js'
-import type {
-  NextcloudEntry,
-  CozyFile,
-  DiskUsage,
-  TrackingDoc,
-} from './types.js'
-import { DOCTYPES } from './doctypes.js'
+import type { TrackingDoc } from '../domain/types.js'
+import { DOCTYPES } from '../domain/doctypes.js'
+
+export interface NextcloudEntry {
+  type: 'file' | 'directory'
+  name: string
+  path: string
+  size: number
+  mime: string
+}
+
+/** Unwrapped from the Stack's JSON-API response. Size is parsed from string. */
+export interface CozyFile {
+  id: string
+  name: string
+  dir_id: string
+  size: number
+}
+
+export interface DiskUsage {
+  used: number
+  /** 0 means unlimited in Cozy Stack. */
+  quota: number
+}
 
 // cozy-stack-client is published as CommonJS with `__esModule: true`, which
 // means Node's ESM→CJS interop surfaces module.exports under the default

src/stack-client.ts src/clients/stack-client.tssrc/stack-client.ts renamed to src/clients/stack-client.ts

@@ -1,5 +1,5 @@
 import type { Logger } from 'pino'
-import type { StackClient } from './stack-client.js'
+import type { StackClient } from '../clients/stack-client.js'
 import type { MigrationCommand } from './types.js'
 import {
   setRunning,

src/doctypes.ts src/domain/doctypes.tssrc/doctypes.ts renamed to src/domain/doctypes.ts

@@ -1,4 +1,4 @@
-import type { StackClient } from './stack-client.js'
+import type { StackClient } from '../clients/stack-client.js'
 import type { TrackingDoc, TrackingError, TrackingSkipped } from './types.js'
 
 const MAX_CONFLICT_RETRIES = 5

src/migration.ts src/domain/migration.tssrc/migration.ts renamed to src/domain/migration.ts

@@ -38,28 +38,6 @@ export interface TrackingSkipped {
   size: number
 }
 
-export interface NextcloudEntry {
-  type: 'file' | 'directory'
-  name: string
-  path: string
-  size: number
-  mime: string
-}
-
-/** Unwrapped from the Stack's JSON-API response. Size is parsed from string. */
-export interface CozyFile {
-  id: string
-  name: string
-  dir_id: string
-  size: number
-}
-
-export interface DiskUsage {
-  used: number
-  /** 0 means unlimited in Cozy Stack. */
-  quota: number
-}
-
 /**
  * Validates and extracts a MigrationCommand from a raw RabbitMQ message.
  * @param msg - Raw message payload from RabbitMQ
@@ -85,15 +63,3 @@ export function parseMigrationCommand(msg: Record<string, unknown>): MigrationCo
     timestamp: typeof timestamp === 'number' ? timestamp : Date.now(),
   }
 }
-
-export interface Config {
-  rabbitmqUrl: string
-  clouderyUrl: string
-  clouderyToken: string
-  logLevel: string
-  flushInterval: number
-  /** URL scheme used when addressing the target Cozy Stack. Defaults to
-   * `https`; set `STACK_URL_SCHEME=http` for local development against a
-   * non-TLS Stack. */
-  stackUrlScheme: 'http' | 'https'
-}

src/tracking.ts src/domain/tracking.tssrc/tracking.ts renamed to src/domain/tracking.ts

@@ -1,9 +1,9 @@
 import pino from 'pino'
 import { RabbitMQClient, type RabbitMQMessage } from '@linagora/rabbitmq-client'
-import { loadConfig } from './config.js'
-import { createClouderyClient } from './cloudery-client.js'
-import { handleMigrationMessage } from './consumer.js'
-import { parseMigrationCommand } from './types.js'
+import { loadConfig } from './runtime/config.js'
+import { createClouderyClient } from './clients/cloudery-client.js'
+import { handleMigrationMessage } from './runtime/consumer.js'
+import { parseMigrationCommand } from './domain/types.js'
 
 const EXCHANGE = 'migration'
 const ROUTING_KEY = 'nextcloud.migration.requested'

src/types.ts src/domain/types.tssrc/types.ts renamed to src/domain/types.ts

@@ -1,4 +1,14 @@
-import type { Config } from './types.js'
+export interface Config {
+  rabbitmqUrl: string
+  clouderyUrl: string
+  clouderyToken: string
+  logLevel: string
+  flushInterval: number
+  /** URL scheme used when addressing the target Cozy Stack. Defaults to
+   * `https`; set `STACK_URL_SCHEME=http` for local development against a
+   * non-TLS Stack. */
+  stackUrlScheme: 'http' | 'https'
+}
 
 function requireEnv(name: string): string {
   const value = process.env[name]