ardent-cli-beta 0.0.18 → 0.0.20

package/oclif.manifest.json

@@ -95,6 +95,73 @@
         "status.js"
       ]
     },
+    "branch:connect": {
+      "aliases": [],
+      "args": {},
+      "description": "Connect to the selected active branch with psql, or print a connection string for your driver",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "driver": {
+          "description": "The driver --print writes a connection string for: libpq (psql, psycopg, pgx), node (node-postgres, postgres.js), jdbc (pgjdbc) or prisma (Prisma)",
+          "name": "driver",
+          "default": "libpq",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "libpq",
+            "node",
+            "jdbc",
+            "prisma"
+          ],
+          "type": "option"
+        },
+        "print": {
+          "description": "Print a connection string for --driver and keep the credential active, instead of opening psql",
+          "name": "print",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "to-env": {
+          "description": "Write DATABASE_URL to .env instead of opening psql",
+          "exclusive": [
+            "print",
+            "json"
+          ],
+          "name": "to-env",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "role": {
+          "description": "Sign in as this source role on the branch (for example postgres), with a fresh password that works on this branch only",
+          "name": "role",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "branch:connect",
+      "pluginAlias": "ardent-cli-beta",
+      "pluginName": "ardent-cli-beta",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "helpGroup": "Branches",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "branch",
+        "connect.js"
+      ]
+    },
     "branch:create": {
       "aliases": [],
       "args": {
@@ -104,7 +171,7 @@
           "required": true
         }
       },
-      "description": "Create a branch in the selected connector",
+      "description": "Create a branch in the selected connector and print its connection URL when ready",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -112,6 +179,43 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "allow-cidr": {
+          "description": "Allow connections only from these IPv4/IPv6 CIDRs; repeat for each network. Fixed at creation; omitted means unrestricted.",
+          "name": "allow-cidr",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "driver": {
+          "description": "Connection string format: libpq, node, jdbc or prisma",
+          "name": "driver",
+          "default": "libpq",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "libpq",
+            "node",
+            "jdbc",
+            "prisma"
+          ],
+          "type": "option"
+        },
+        "print": {
+          "description": "Print the connection string when ready (the default behavior)",
+          "name": "print",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "to-env": {
+          "description": "Write DATABASE_URL to .env instead of printing it",
+          "exclusive": [
+            "print",
+            "json"
+          ],
+          "name": "to-env",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -197,6 +301,78 @@
         "list.js"
       ]
     },
+    "branch:recover": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Branch name",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Recover a failed branch in the selected connector on its retained disk",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "branch:recover",
+      "pluginAlias": "ardent-cli-beta",
+      "pluginName": "ardent-cli-beta",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": true,
+      "helpGroup": "Branches",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "branch",
+        "recover.js"
+      ]
+    },
+    "branch:suspend": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Branch name",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Park a branch in the selected connector; it refuses connections until woken",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "branch:suspend",
+      "pluginAlias": "ardent-cli-beta",
+      "pluginName": "ardent-cli-beta",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": true,
+      "helpGroup": "Branches",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "branch",
+        "suspend.js"
+      ]
+    },
     "branch:switch": {
       "aliases": [],
       "args": {
@@ -233,6 +409,42 @@
         "switch.js"
       ]
     },
+    "branch:wake": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Branch name",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Wake a parked branch in the selected connector; a parked branch refuses connections until woken",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "branch:wake",
+      "pluginAlias": "ardent-cli-beta",
+      "pluginName": "ardent-cli-beta",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": true,
+      "helpGroup": "Branches",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "branch",
+        "wake.js"
+      ]
+    },
     "connector:create": {
       "aliases": [],
       "args": {
@@ -270,6 +482,20 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tls-client-cert": {
+          "description": "PEM client certificate file (requires sslmode=require in the URL)",
+          "name": "tls-client-cert",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tls-client-key": {
+          "description": "PEM client private-key file (requires sslmode=require in the URL)",
+          "name": "tls-client-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -289,6 +515,42 @@
         "create.js"
       ]
     },
+    "connector:delete": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Connector name",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Delete a connector in the selected project after its branches are deleted",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "connector:delete",
+      "pluginAlias": "ardent-cli-beta",
+      "pluginName": "ardent-cli-beta",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "helpGroup": "Connectors",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "connector",
+        "delete.js"
+      ]
+    },
     "connector:list": {
       "aliases": [],
       "args": {},
@@ -319,6 +581,78 @@
         "list.js"
       ]
     },
+    "connector:status": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Connector ID returned by create or delete",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Show connector registration or deletion status by ID",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "connector:status",
+      "pluginAlias": "ardent-cli-beta",
+      "pluginName": "ardent-cli-beta",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "helpGroup": "Connectors",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "connector",
+        "status.js"
+      ]
+    },
+    "connector:switch": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Connector name",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Switch to a connector in the selected project",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "connector:switch",
+      "pluginAlias": "ardent-cli-beta",
+      "pluginName": "ardent-cli-beta",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "helpGroup": "Connectors",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "connector",
+        "switch.js"
+      ]
+    },
     "member:delete": {
       "aliases": [],
       "args": {
@@ -574,5 +908,5 @@
       ]
     }
   },
-  "version": "0.0.18"
+  "version": "0.0.20"
 }

package/openapi.json

@@ -650,12 +650,11 @@
           {
             "name": "Idempotency-Key",
             "in": "header",
-            "required": true,
+            "required": false,
             "schema": {
-              "type": "string",
-              "minLength": 1
+              "type": "string"
             },
-            "description": "Required. Trimmed, non-empty, at most 200 UTF-8 bytes. Keep the same key and request fields when retrying the same mutation."
+            "description": "Optional. Trimmed, at most 200 UTF-8 bytes. Omit for a fresh creation; resource conflicts return 409. The same key and inputs replay the original creation result; changed inputs return 409 idempotency_key_conflict."
           }
         ],
         "requestBody": {
@@ -1534,6 +1533,18 @@
                 "format": "date-time"
               }
             }
+          },
+          "ddl_channel": {
+            "type": "object",
+            "required": ["health", "required_version"],
+            "properties": {
+              "health": {"type": "string", "enum": ["healthy", "degraded", "unknown"]},
+              "required_version": {"type": "integer", "minimum": 1},
+              "observed_version": {"type": "integer", "minimum": 0},
+              "status": {"type": "string", "enum": ["current", "worker_upgrade_required", "fresh_origin_required", "binding_repair_failed", "unavailable"]},
+              "observed_at": {"type": "string", "format": "date-time"},
+              "attempted_at": {"type": "string", "format": "date-time"}
+            }
           }
         }
       },
@@ -1564,6 +1575,7 @@
               "registering",
               "registered",
               "failed",
+              "halted",
               "deleting",
               "deleted"
             ]
@@ -1575,7 +1587,7 @@
             "type": "string"
           }
         },
-        "description": "Registration workflow completion is not replication readiness. Deletion status can also be returned by this endpoint."
+        "description": "Registration workflow completion is not replication readiness. Deletion status can also be returned by this endpoint. halted means a source runtime component reported a standing halt; failure is then <component>:<classification>."
       },
       "Branch": {
         "type": "object",
@@ -1596,6 +1608,12 @@
           "updated_at"
         ],
         "properties": {
+          "allowed_cidrs": {
+            "type": "array",
+            "maxItems": 64,
+            "items": {"type": "string"},
+            "description": "IPv4/IPv6 CIDRs allowed to connect. Empty or omitted means unrestricted. Immutable after creation; host bits are masked and duplicates removed. Mapped IPv6 prefixes are refused."
+          },
           "id": {
             "type": "string"
           },
@@ -1831,10 +1849,20 @@
             "minLength": 1,
             "writeOnly": true,
             "description": "PostgreSQL connection URL, including source credentials. Do not log this value."
+          },
+          "tls_client_certificate": {
+            "type": "string",
+            "writeOnly": true,
+            "description": "Optional PEM client certificate, retained byte-for-byte. Must be supplied with tls_client_key."
+          },
+          "tls_client_key": {
+            "type": "string",
+            "writeOnly": true,
+            "description": "Optional PEM private key, retained byte-for-byte. Must be supplied with tls_client_certificate."
           }
         },
         "additionalProperties": false,
-        "description": "One JSON object, at most 16 KiB. String fields are trimmed. Unknown fields are rejected."
+        "description": "One JSON object, at most 160 KiB. Identifier, name, and URL fields are trimmed; PEM fields retain their exact bytes. Unknown fields are rejected."
       },
       "BranchName": {
         "type": "string",
@@ -1850,6 +1878,12 @@
           "request_id"
         ],
         "properties": {
+          "allowed_cidrs": {
+            "type": "array",
+            "maxItems": 64,
+            "items": {"type": "string"},
+            "description": "IPv4/IPv6 CIDRs allowed to connect. Empty or omitted means unrestricted. Immutable after creation; host bits are masked and duplicates removed. Mapped IPv6 prefixes are refused."
+          },
           "connector_id": {
             "type": "string",
             "minLength": 1
@@ -1861,6 +1895,13 @@
             "type": "string",
             "minLength": 1,
             "description": "Trimmed, then limited to 128 UTF-8 bytes; NUL is forbidden. Reuse for retries."
+          },
+          "source_ownership": {
+            "type": "string",
+            "enum": [
+              "seed_origin_v1"
+            ],
+            "description": "Optional birth ownership restoration at the selected latest mark only. Returns 409 source_ownership_unavailable unless that mark matches a supported installation seed origin. Credentials retain public_read_write_v1."
           }
         },
         "additionalProperties": false
@@ -1885,7 +1926,7 @@
       "CLICallback": {
         "type": "string",
         "format": "uri",
-        "description": "Exactly http://127.0.0.1:<port>/callback, port 1–65535; no user information, query, or fragment."
+        "description": "Exactly http://127.0.0.1:<port>/callback, port 1\u201365535; no user information, query, or fragment."
       },
       "CLIRandomValue": {
         "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ardent-cli-beta",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "description": "The Ardent command-line interface",
   "license": "Apache-2.0",
   "type": "module",
@@ -50,5 +50,9 @@
     "@types/node": "^22.0.0",
     "oclif": "^5.0.1",
     "typescript": "^5.9.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArdentAILabs/ardent-cli.git"
   }
 }