@epilot/cli 0.1.65 → 0.1.67

package/definitions/snapshot.json

@@ -27,6 +27,10 @@
     {
       "name": "Snapshots",
       "description": "Snapshot CRUD and restore operations"
+    },
+    {
+      "name": "ScheduledSnapshots",
+      "description": "Enrollment and configuration for scheduled org snapshots"
     }
   ],
   "paths": {
@@ -160,7 +164,7 @@
       "post": {
         "operationId": "captureOrgSnapshot",
         "summary": "captureOrgSnapshot",
-        "description": "Snapshot the caller's whole organization now. Fetches a fresh inventory\nof the org's configuration resources from configuration-hub-api, persists\nit as an inventory artifact, and starts a `scope: \"org\"` chunked capture.\nAsync — returns immediately with a snapshot ID; client polls `getSnapshot`\nand watches `capture_summary` fill in until `create.status` moves from\n`in_progress` to `completed` or `failed`.\n\nSensitive types (`access_token`, `environment_variable`), types with no\nengine adapter, and any `excluded_types` are dropped from the capture and\nrecorded in the snapshot's coverage report.\n",
+        "description": "Snapshot the caller's whole organization now. Creates a `scope: \"org\"`\nsnapshot row and starts a chunked capture Step Function, then returns\nimmediately. The capture asynchronously fetches a fresh inventory of the\norg's configuration resources from configuration-hub-api, persists it as\nan inventory artifact, and captures each resource. Client polls\n`getSnapshot` and watches `capture_summary` fill in until `create.status`\nmoves from `in_progress` to `completed` or `failed`. An org with no\ncapturable resources finalizes as a completed 0-resource snapshot.\n\nSensitive types (`access_token`, `environment_variable`), types with no\nengine adapter, and any `excluded_types` are dropped from the capture and\nrecorded in the snapshot's coverage report.\n",
         "tags": [
           "Snapshots"
         ],
@@ -187,9 +191,6 @@
           },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
-          },
-          "422": {
-            "$ref": "#/components/responses/UnprocessableEntity"
           }
         }
       }
@@ -383,6 +384,89 @@
         }
       }
     },
+    "/v1/org-snapshot-schedule": {
+      "get": {
+        "operationId": "getOrgSnapshotSchedule",
+        "summary": "getOrgSnapshotSchedule",
+        "description": "Return the scheduled-snapshot enrollment config for the caller's org.\nReturns 404 when the org has not yet enrolled.\n",
+        "tags": [
+          "ScheduledSnapshots"
+        ],
+        "responses": {
+          "200": {
+            "description": "Org snapshot schedule config",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/OrgSnapshotSchedule"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      },
+      "put": {
+        "operationId": "putOrgSnapshotSchedule",
+        "summary": "putOrgSnapshotSchedule",
+        "description": "Create or update the scheduled-snapshot enrollment config for the\ncaller's org (upsert). The cron expression and retention window are\nvalidated server-side; invalid values are rejected with 400.\n\nDefaults applied when a field is omitted on first create:\n  - `cron_expression`: `cron(0 2 * * ? *)` (daily at 02:00)\n  - `timezone`: `Europe/Berlin`\n  - `retention`: `{ value: 90, unit: \"days\" }`\n  - `enabled`: `true`\n\n**Note:** this call persists the row only. EventBridge schedule\nmaterialization is performed by a subsequent reconcile step (Task 6).\nThe row is the authoritative source of truth for the UI.\n",
+        "tags": [
+          "ScheduledSnapshots"
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PutOrgSnapshotScheduleRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Stored config (after upsert)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/OrgSnapshotSchedule"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "deleteOrgSnapshotSchedule",
+        "summary": "deleteOrgSnapshotSchedule",
+        "description": "Remove the scheduled-snapshot enrollment for the caller's org.\nReturns 404 when no schedule exists.\nThe corresponding EventBridge schedule is removed by a reconcile\nstep (Task 6).\n",
+        "tags": [
+          "ScheduledSnapshots"
+        ],
+        "responses": {
+          "204": {
+            "description": "Deleted"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      }
+    },
     "/v1/snapshots:list-dependencies": {
       "post": {
         "operationId": "listDependencies",
@@ -489,16 +573,6 @@
             }
           }
         }
-      },
-      "UnprocessableEntity": {
-        "description": "Unprocessable entity",
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/EmptyInventoryError"
-            }
-          }
-        }
       }
     },
     "schemas": {
@@ -517,38 +591,6 @@
           }
         }
       },
-      "EmptyInventoryError": {
-        "type": "object",
-        "required": [
-          "message",
-          "skipped_types"
-        ],
-        "description": "Returned (422) when the org inventory contains no capturable resources\nafter filtering out sensitive, unsupported, and excluded types. The\n`skipped_types` array explains why every type was dropped.\n",
-        "properties": {
-          "message": {
-            "type": "string",
-            "example": "No capturable resources in the org inventory"
-          },
-          "skipped_types": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "required": [
-                "type",
-                "reason"
-              ],
-              "properties": {
-                "type": {
-                  "type": "string"
-                },
-                "reason": {
-                  "type": "string"
-                }
-              }
-            }
-          }
-        }
-      },
       "ResourceRef": {
         "type": "object",
         "required": [
@@ -929,6 +971,132 @@
             "type": "string"
           }
         }
+      },
+      "RetentionConfig": {
+        "type": "object",
+        "required": [
+          "value",
+          "unit"
+        ],
+        "description": "Flat retention window for a scheduled snapshot.\nConverted to a `ttl` epoch at capture time. Capped at ~24 months.\n",
+        "properties": {
+          "value": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Numeric quantity of retention (e.g. 90 for \"90 days\")."
+          },
+          "unit": {
+            "type": "string",
+            "enum": [
+              "days",
+              "weeks",
+              "months"
+            ]
+          }
+        }
+      },
+      "PutOrgSnapshotScheduleRequest": {
+        "type": "object",
+        "description": "Body for `putOrgSnapshotSchedule`. All fields optional; unset fields\nreceive defaults on first create and are left unchanged on updates\n(except `updated_at`).\n",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": true,
+            "description": "Whether the schedule is active."
+          },
+          "cron_expression": {
+            "type": "string",
+            "description": "6-field EventBridge cron expression, e.g. `cron(0 2 * * ? *)`.\nValidated server-side: minute + hour must be concrete single integers\n(no `*`, lists, ranges, or steps) to cap cadence at ≤ once/day.\nExactly one of day-of-month / day-of-week must be `?`.\n",
+            "example": "cron(0 2 * * ? *)"
+          },
+          "timezone": {
+            "type": "string",
+            "description": "IANA timezone string passed to EventBridge `ScheduleExpressionTimezone`,\ne.g. `Europe/Berlin`. AWS handles DST natively.\n",
+            "example": "Europe/Berlin"
+          },
+          "retention": {
+            "$ref": "#/components/schemas/RetentionConfig"
+          },
+          "excluded_types": {
+            "type": "array",
+            "description": "Resource types to exclude from the scheduled capture, in addition\nto the always-excluded sensitive types (`access_token`,\n`environment_variable`).\n",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "OrgSnapshotSchedule": {
+        "type": "object",
+        "required": [
+          "org_id",
+          "enabled",
+          "cron_expression",
+          "timezone",
+          "retention",
+          "schedule_name",
+          "created_by",
+          "created_at",
+          "updated_at"
+        ],
+        "description": "Enrollment record for a scheduled org snapshot. One row per org.\nThis table — not EventBridge — is the source of truth; the EventBridge\nschedule entry is the materialization of this row (reconciled on write\nby Task 6).\n",
+        "properties": {
+          "org_id": {
+            "type": "string"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "cron_expression": {
+            "type": "string",
+            "description": "Validated 6-field EventBridge cron. Default `cron(0 2 * * ? *)`.",
+            "example": "cron(0 2 * * ? *)"
+          },
+          "timezone": {
+            "type": "string",
+            "description": "IANA timezone. Default `Europe/Berlin`."
+          },
+          "retention": {
+            "$ref": "#/components/schemas/RetentionConfig"
+          },
+          "excluded_types": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "schedule_name": {
+            "type": "string",
+            "description": "Name of the EventBridge Scheduler entry this row owns.\nSet at enrollment time as `org-snapshot-{orgId}`.\n"
+          },
+          "last_started_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "last_completed_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "last_status": {
+            "type": "string",
+            "enum": [
+              "completed",
+              "partial",
+              "failed"
+            ]
+          },
+          "created_by": {
+            "type": "string"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
       }
     }
   }

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-VZZG4HRP.js";
+} from "../chunk-6TKZSKWB.js";
 
 // bin/epilot.ts
 import { runMain } from "citty";
@@ -11,7 +11,7 @@ import { defineCommand } from "citty";
 var main = defineCommand({
   meta: {
     name: "epilot",
-    version: "0.1.65",
+    version: "0.1.67",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -30,8 +30,8 @@ var main = defineCommand({
     auth: () => import("../auth-4HG7B2GC.js").then((m) => m.default),
     profile: () => import("../profile-OZJL5ZPT.js").then((m) => m.default),
     config: () => import("../config-DGZIMLZK.js").then((m) => m.default),
-    completion: () => import("../completion-TNGF5M2C.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-WOJSCMM6.js").then((m) => m.default),
+    completion: () => import("../completion-BZQQTKHB.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-3AUH2MLE.js").then((m) => m.default),
     "access-token": () => import("../access-token-WWE6BDJH.js").then((m) => m.default),
     address: () => import("../address-EH3C4CVB.js").then((m) => m.default),
     "address-suggestions": () => import("../address-suggestions-RRSLOBFW.js").then((m) => m.default),
@@ -134,13 +134,13 @@ process.stderr.on("error", (err) => {
   if (err.code === "EPIPE") process.exit(0);
   throw err;
 });
-var VERSION = true ? "0.1.65" : (await null).default.version;
+var VERSION = true ? "0.1.67" : (await null).default.version;
 var reorderedArgv = hoistFlagsAfterSubcommand(process.argv.slice(2));
 process.argv = [process.argv[0], process.argv[1], ...reorderedArgv];
 var args = process.argv.slice(2);
 var completionsIdx = args.indexOf("--_completions");
 if (completionsIdx >= 0) {
-  const { handleCompletions } = await import("../completion-TNGF5M2C.js");
+  const { handleCompletions } = await import("../completion-BZQQTKHB.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-VZZG4HRP.js → chunk-6TKZSKWB.js}

@@ -143,7 +143,7 @@ var API_LIST = [
     kebabName: "billing",
     title: "Billing API",
     serverUrl: "https://billing.sls.epilot.io",
-    operationCount: 10,
+    operationCount: 14,
     operationIds: [
       "getBillingEvents",
       "createBillingEvent",
@@ -154,6 +154,10 @@ var API_LIST = [
       "createContractEntity",
       "updateContractEntity",
       "deleteContractEntity",
+      "getContractPricingInformation",
+      "getBillingAccountPricingInformation",
+      "getContractConfigurationHistory",
+      "getBillingAccountConfigurationHistory",
       "getCustomerBalance"
     ]
   },
@@ -1202,7 +1206,7 @@ var API_LIST = [
     kebabName: "snapshot",
     title: "Snapshot API",
     serverUrl: "https://snapshot.sls.epilot.io",
-    operationCount: 9,
+    operationCount: 12,
     operationIds: [
       "listSnapshots",
       "createSnapshot",
@@ -1212,6 +1216,9 @@ var API_LIST = [
       "restoreSnapshot",
       "listSnapshotResources",
       "getSnapshotResource",
+      "getOrgSnapshotSchedule",
+      "putOrgSnapshotSchedule",
+      "deleteOrgSnapshotSchedule",
       "listDependencies"
     ]
   },

package/dist/{completion-TNGF5M2C.js → completion-BZQQTKHB.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "./chunk-VZZG4HRP.js";
+} from "./chunk-6TKZSKWB.js";
 import {
   DIM,
   GREEN,

package/dist/{upgrade-WOJSCMM6.js → upgrade-3AUH2MLE.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.65";
+  if (true) return "0.1.67";
   try {
     const output = execSync("npm ls -g @epilot/cli --depth=0 --json 2>/dev/null", {
       encoding: "utf-8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/cli",
-  "version": "0.1.65",
+  "version": "0.1.67",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {