@epilot/cli 0.1.52 → 0.1.54

package/README.md

@@ -29,7 +29,7 @@ npm install -g @epilot/cli
 
 <!-- usage-help -->
 ```
-epilot v0.1.52 — CLI for epilot APIs
+epilot v0.1.54 — CLI for epilot APIs
 
 USAGE
   epilot <api> <operationId> [params...] [flags]

package/definitions/snapshot.json

@@ -103,6 +103,20 @@
                 "pattern": "^[^:]+:.+$"
               }
             }
+          },
+          {
+            "in": "query",
+            "name": "trigger",
+            "description": "Filter to snapshots with a specific trigger. Uses the `byTrigger` GSI\nfor an efficient indexed query — no table scan. Only snapshots created\nafter the GSI was added carry this index entry; pre-existing rows will\nnot appear in trigger-filtered results.\n",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "manual",
+                "sync",
+                "blueprint_install",
+                "scheduled"
+              ]
+            }
           }
         ],
         "responses": {
@@ -562,7 +576,8 @@
         "properties": {
           "lineage_id": {
             "type": "string",
-            "description": "Cross-service correlation key — matches the lineage row id in\nblueprint-manifest-api's lineage table for `blueprint_install`\nsnapshots. Same as `target_id` for snapshots whose capture\ndoesn't distinguish source vs destination identifiers.\n"
+            "deprecated": true,
+            "description": "Deprecated alias of `target_id`. Always equals `target_id` (the\nimplementation never distinguished them). Use `target_id`.\n"
           },
           "target_id": {
             "type": "string",
@@ -727,17 +742,19 @@
       },
       "RestoreSnapshotRequest": {
         "type": "object",
-        "description": "Both flags default to `false`, which restores every captured resource —\nConfig Hub's manual-restore semantics. blueprint-manifest-api sets\nboth `true` when reverting a blueprint install so user edits and\ncross-blueprint contributions survive. Each flag is independent so a\ncaller can preserve edits without preserving co-ownership (or vice\nversa). Skipped resources surface under `Operation.skipped`.\n",
+        "description": "Apply a captured snapshot to its source org. All filters default to the\nopen setting (apply everything), which keeps Config Hub's manual-restore\nsemantics unchanged.\n",
         "properties": {
           "preserve_modified": {
             "type": "boolean",
             "default": false,
-            "description": "When `true`, skip captured resources whose live destination payload\nhas diverged from the install-time fingerprint stored on lineage.\nSurfaces under `Operation.skipped` with `reason: 'modified'`.\n"
+            "description": "When `true`, skip captured resources whose live payload's content\nfingerprint diverges from the capture-time fingerprint stored on\nthe manifest entry. snapshot-api fetches the live payload and\nhashes it itself; no cross-service lookup. Surfaces under\n`Operation.skipped` with `reason: 'modified'`. Legacy snapshots\ncaptured before fingerprints were stored fail open (applied).\n"
           },
-          "preserve_co_owned": {
-            "type": "boolean",
-            "default": false,
-            "description": "When `true`, skip captured resources whose lineage row carries\nanother blueprint instance's id (co-ownership ≥2). Surfaces under\n`Operation.skipped` with `reason: 'co_owned'`.\n"
+          "exclude_target_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Target ids the caller has decided not to restore. snapshot-api\napplies the manifest minus these ids. Drops are silent — not\nechoed in `Operation.skipped` — because the caller supplied the\nlist and already knows.\n"
           }
         }
       },
@@ -891,7 +908,7 @@
               "partial",
               "failed"
             ],
-            "description": "`partial` indicates the operation completed but skipped at least\none resource — see `skipped`. Only populated by restores triggered\nwith `mode: 'preserve_edits'`.\n"
+            "description": "`partial` indicates the operation completed but snapshot-api\nskipped at least one captured resource via its own drift check\n(see `skipped`).\n"
           },
           "error": {
             "type": "string"
@@ -901,7 +918,7 @@
           },
           "skipped": {
             "type": "array",
-            "description": "Per-resource skips, populated only for restores triggered with\n`mode: 'preserve_edits'`. Empty / absent for Config Hub's\ndefault overwrite-mode restores.\n",
+            "description": "Captured resources snapshot-api elected to skip — currently\nonly drift detections (`preserve_modified: true`). Caller-\nsupplied `exclude_target_ids` skips are NOT echoed here; the\ncaller built the list, the caller knows.\n",
             "items": {
               "$ref": "#/components/schemas/SkippedResource"
             }
@@ -911,20 +928,19 @@
       "SkippedResource": {
         "type": "object",
         "required": [
-          "lineage_id",
+          "target_id",
           "reason"
         ],
         "properties": {
-          "lineage_id": {
+          "target_id": {
             "type": "string"
           },
           "reason": {
             "type": "string",
             "enum": [
-              "modified",
-              "co_owned"
+              "modified"
             ],
-            "description": "- `modified` — current destination payload's fingerprint differs\n  from the install-time fingerprint on the lineage row.\n- `co_owned` — lineage row has ≥2 distinct\n  `blueprint_instance_ids`; restoring would unilaterally affect\n  another blueprint instance's contribution.\n"
+            "description": "- `modified` — live destination payload's content fingerprint\n  differs from the capture-time fingerprint stored on the\n  manifest entry. Only set when the restore was requested with\n  `preserve_modified: true`.\n"
           }
         }
       },

package/dist/bin/epilot.js

@@ -11,7 +11,7 @@ import { defineCommand } from "citty";
 var main = defineCommand({
   meta: {
     name: "epilot",
-    version: "0.1.52",
+    version: "0.1.54",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -31,7 +31,7 @@ var main = defineCommand({
     profile: () => import("../profile-OZJL5ZPT.js").then((m) => m.default),
     config: () => import("../config-DGZIMLZK.js").then((m) => m.default),
     completion: () => import("../completion-4HOIJNFX.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-2IHZJYAW.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-BUHUA47K.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,7 +134,7 @@ process.stderr.on("error", (err) => {
   if (err.code === "EPIPE") process.exit(0);
   throw err;
 });
-var VERSION = true ? "0.1.52" : (await null).default.version;
+var VERSION = true ? "0.1.54" : (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);

package/dist/{upgrade-2IHZJYAW.js → upgrade-BUHUA47K.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.52";
+  if (true) return "0.1.54";
   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.52",
+  "version": "0.1.54",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {