v2.20.1: Exclude island with isolated shard 0 from rebalancing; write comprehensive log on every move action to a file

Author: dimikot

README.md

@@ -178,6 +178,8 @@ At any moment, you can abort the move with ^C. It is safe: half-moved data will
 
 <figure><img src="https://raw.githubusercontent.com/dimikot/ent-framework/refs/heads/main/gitbook/.gitbook/assets/pg-microsharding-move.png" alt=""><figcaption></figcaption></figure>
 
+In addition to printing to console, `move` action also writes the same output to a log file in `/tmp/pg-microsharding.$uid` directory. Each individual move creates its own file prefixed with a timestamp and including the microshard number moved.
+
 ### Clean Old Moved Copies: pg-microsharding cleanup
 
 ```bash

docs/README.md

@@ -182,6 +182,8 @@ At any moment, you can abort the move with ^C. It is safe: half-moved data will
 
 <figure><img src="https://raw.githubusercontent.com/dimikot/ent-framework/refs/heads/main/gitbook/.gitbook/assets/pg-microsharding-move.png" alt=""><figcaption></figcaption></figure>
 
+In addition to printing to console, `move` action also writes the same output to a log file in `/tmp/pg-microsharding.$uid` directory. Each individual move creates its own file prefixed with a timestamp and including the microshard number moved.
+
 ### Clean Old Moved Copies: pg-microsharding cleanup
 
 ```bash

docs/functions/actionList.md

@@ -8,7 +8,7 @@
 
 > **actionList**(`args`): `Promise`\<`boolean`\>
 
-Defined in: [src/actions/actionList.ts:28](https://github.com/clickup/pg-microsharding/blob/master/src/actions/actionList.ts#L28)
+Defined in: [src/actions/actionList.ts:29](https://github.com/clickup/pg-microsharding/blob/master/src/actions/actionList.ts#L29)
 
 Shows the list of microshards and their weights.
 

docs/functions/actionMove.md

@@ -8,7 +8,7 @@
 
 > **actionMove**(`args`): `Promise`\<`boolean`\>
 
-Defined in: [src/actions/actionMove.ts:19](https://github.com/clickup/pg-microsharding/blob/master/src/actions/actionMove.ts#L19)
+Defined in: [src/actions/actionMove.ts:21](https://github.com/clickup/pg-microsharding/blob/master/src/actions/actionMove.ts#L21)
 
 Moves a shard from one database to another with no downtime.
 

docs/functions/actionRebalance.md

@@ -8,7 +8,7 @@
 
 > **actionRebalance**(`args`): `Promise`\<`boolean`\>
 
-Defined in: [src/actions/actionRebalance.ts:22](https://github.com/clickup/pg-microsharding/blob/master/src/actions/actionRebalance.ts#L22)
+Defined in: [src/actions/actionRebalance.ts:23](https://github.com/clickup/pg-microsharding/blob/master/src/actions/actionRebalance.ts#L23)
 
 Runs a series of shard modes, concurrently, using TMUX if available.
 

docs/functions/calcIslandWeights.md

@@ -14,11 +14,10 @@ Defined in: [src/actions/actionList.ts:193](https://github.com/clickup/pg-micros
 
 | Parameter | Type |
 | ------ | ------ |
-| `__namedParameters` | \{ `dsns`: `string`[]; `weightSql`: `undefined` \| `string`; `verbose`: `boolean`; `includeIsolatedShard0`: `boolean`; \} |
+| `__namedParameters` | \{ `dsns`: `string`[]; `weightSql`: `undefined` \| `string`; `verbose`: `boolean`; \} |
 | `__namedParameters.dsns` | `string`[] |
 | `__namedParameters.weightSql` | `undefined` \| `string` |
 | `__namedParameters.verbose`? | `boolean` |
-| `__namedParameters.includeIsolatedShard0` | `boolean` |
 
 ## Returns
 

docs/functions/weights.md

@@ -6,27 +6,22 @@
 
 # Function: weights()
 
-> **weights**(`__namedParameters`): `Promise`\<`object`[] \| `null`\>
+> **weights**(`__namedParameters`): `Promise`\<`object`[]\>
 
-Defined in: [src/api/weights.ts:16](https://github.com/clickup/pg-microsharding/blob/master/src/api/weights.ts#L16)
+Defined in: [src/api/weights.ts:12](https://github.com/clickup/pg-microsharding/blob/master/src/api/weights.ts#L12)
 
 Similar to listActiveSchemas(), but also returns the weight of each
 microshard and its number.
 
-Returns null in case this DSN needs to be excluded by the caller completely
-(e.g. when includeIsolatedShard0=false, and it's an isolated island with
-shard 0).
-
 ## Parameters
 
 | Parameter | Type |
 | ------ | ------ |
-| `__namedParameters` | \{ `dsn`: `string`; `weightSql`: `undefined` \| `string`; `verbose`: `boolean`; `includeIsolatedShard0`: `boolean`; \} |
+| `__namedParameters` | \{ `dsn`: `string`; `weightSql`: `undefined` \| `string`; `verbose`: `boolean`; \} |
 | `__namedParameters.dsn` | `string` |
 | `__namedParameters.weightSql` | `undefined` \| `string` |
 | `__namedParameters.verbose`? | `boolean` |
-| `__namedParameters.includeIsolatedShard0` | `boolean` |
 
 ## Returns
 
-`Promise`\<`object`[] \| `null`\>
+`Promise`\<`object`[]\>

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "@clickup/pg-microsharding",
   "description": "Microshards support for PostgreSQL",
-  "version": "2.19.3",
+  "version": "2.20.1",
   "license": "MIT",
   "keywords": [
     "postgresql",