hngr 0.9.0 → 0.10.0

package/dist/{catalog-CmtREMFr.mjs → catalog-CfpeEevk.mjs}

@@ -53,7 +53,8 @@ const EXCLUDED_PATHS = [
 	"/api/v1/auth/device/deny",
 	"/api/v1/teams/{team_id}/invitations",
 	"/api/v1/team-invitations",
-	"/api/v1/oauth"
+	"/api/v1/oauth",
+	"/api/v1/sync-tasks"
 ];
 /**
 * Single operations whose path still generates other commands. Category
@@ -741,7 +742,7 @@ const COMMANDS = deriveCommands({
 			"patch": {
 				"operationId": "updateMe",
 				"summary": "Update the authenticated Principal's profile.",
-				"description": "Omitted fields are left unchanged and an empty string clears a field.\nCredentials, the username and the platform role are not part of the\nprofile. Agents may change only their display name.\n\n`If-Match` must carry the current strong `ETag` of `GET /me`: a missing\nvalue answers 428 and a stale one 412.\n",
+				"description": "Omitted fields are left unchanged and an empty string clears a field.\nCredentials, the username and the platform role are not part of the\nprofile. Agents may change only their display name.\n\n`If-Match` must carry the current `ETag` of `GET /me`: a missing\nvalue answers 428 and a stale one 412. A `W/` prefix that a compressing\nintermediary added to the tag is tolerated.\n",
 				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
 				"parameters": [{ "$ref": "#/components/parameters/IfMatch" }],
 				"requestBody": {
@@ -1358,7 +1359,7 @@ const COMMANDS = deriveCommands({
 			"patch": {
 				"operationId": "updateCapability",
 				"summary": "Change a Capability's description, visibility or Category.",
-				"description": "Omitted fields are left unchanged. `category` is three-state: omitted\nleaves the Category unchanged, `null` clears it, and a slug replaces it\nwith a live Category of the Capability's own Namespace. The change\napplies to every Version at once and publishes none. `kind`,\n`namespace` and `name` are immutable, so sending any of them returns\n400.\n\nThe caller must manage the Capability's Namespace, under the same\nrules as `createCapability`. A deleted or unavailable Capability, one\nin an unusable Namespace, and a private one the caller does not manage\nreturn 404; those checks come before the precondition. `If-Match`\nmust then carry the current strong `ETag` of `lookupCapability`: a\nmissing value answers 428 and a stale one 412. That `ETag` covers\nmanagement metadata only, including the assigned Category's id, name\nand slug, and excluding `download_count` and caller-relative fields,\nso downloads do not cause spurious 412s.\n",
+				"description": "Omitted fields are left unchanged. `category` is three-state: omitted\nleaves the Category unchanged, `null` clears it, and a slug replaces it\nwith a live Category of the Capability's own Namespace. The change\napplies to every Version at once and publishes none. `kind`,\n`namespace` and `name` are immutable, so sending any of them returns\n400.\n\nThe caller must manage the Capability's Namespace, under the same\nrules as `createCapability`. A deleted or unavailable Capability, one\nin an unusable Namespace, and a private one the caller does not manage\nreturn 404; those checks come before the precondition. `If-Match`\nmust then carry the current `ETag` of `lookupCapability`: a missing\nvalue answers 428 and a stale one 412. A `W/` prefix that a\ncompressing intermediary added to the tag is tolerated, because its\nopaque value still identifies the representation. That `ETag` covers\nmanagement metadata only, including the assigned Category's id, name\nand slug, and excluding `download_count` and caller-relative fields,\nso downloads do not cause spurious 412s.\n",
 				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
 				"parameters": [{ "$ref": "#/components/parameters/IfMatch" }],
 				"requestBody": {
@@ -1858,7 +1859,11 @@ const COMMANDS = deriveCommands({
 							"team.member_removed",
 							"team.invitation_created",
 							"team.invitation_revoked",
-							"team.invitation_accepted"
+							"team.invitation_accepted",
+							"sync_task.created",
+							"sync_task.updated",
+							"sync_task.deleted",
+							"sync_run.triggered"
 						]
 					}
 				},
@@ -1874,7 +1879,9 @@ const COMMANDS = deriveCommands({
 							"device_authorization",
 							"principal",
 							"session",
-							"team"
+							"team",
+							"sync_task",
+							"sync_run"
 						]
 					}
 				},
@@ -2299,6 +2306,235 @@ const COMMANDS = deriveCommands({
 					"default": { "$ref": "#/components/responses/Problem" }
 				}
 			}
+		},
+		"/api/v1/sync-tasks": {
+			"get": {
+				"operationId": "listSyncTasks",
+				"summary": "List sync tasks.",
+				"description": "Platform Admin only. Newest first, paged by cursor.",
+				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
+				"parameters": [
+					{
+						"name": "include_deleted",
+						"in": "query",
+						"description": "Include soft-deleted tasks so their retained history stays reachable.",
+						"schema": {
+							"type": "boolean",
+							"default": false
+						}
+					},
+					{ "$ref": "#/components/parameters/Cursor" },
+					{ "$ref": "#/components/parameters/Limit" }
+				],
+				"responses": {
+					"200": {
+						"description": "One page of sync tasks.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SyncTaskList" } } }
+					},
+					"401": { "$ref": "#/components/responses/Problem" },
+					"403": { "$ref": "#/components/responses/Problem" },
+					"default": { "$ref": "#/components/responses/Problem" }
+				}
+			},
+			"post": {
+				"operationId": "createSyncTask",
+				"summary": "Create a sync task.",
+				"description": "Platform Admin only. The source is fixed to seek. A task is created\ndisabled unless `enabled` is true; the hidden sync Agent is created on\nfirst use. A second live task for the same source and target Namespace\nanswers 409.\n",
+				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
+				"parameters": [{ "$ref": "#/components/parameters/IdempotencyKey" }],
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSyncTaskRequest" } } }
+				},
+				"responses": {
+					"201": {
+						"description": "The created task.",
+						"headers": { "Location": { "schema": { "type": "string" } } },
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SyncTask" } } }
+					},
+					"400": { "$ref": "#/components/responses/Problem" },
+					"401": { "$ref": "#/components/responses/Problem" },
+					"403": { "$ref": "#/components/responses/Problem" },
+					"404": { "$ref": "#/components/responses/Problem" },
+					"409": { "$ref": "#/components/responses/Problem" },
+					"default": { "$ref": "#/components/responses/Problem" }
+				}
+			}
+		},
+		"/api/v1/sync-tasks/{task_id}": {
+			"parameters": [{ "$ref": "#/components/parameters/SyncTaskID" }],
+			"get": {
+				"operationId": "getSyncTask",
+				"summary": "Read one sync task.",
+				"description": "Platform Admin only. A soft-deleted task is returned with `deleted_at` set.",
+				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
+				"responses": {
+					"200": {
+						"description": "The sync task.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SyncTask" } } }
+					},
+					"401": { "$ref": "#/components/responses/Problem" },
+					"403": { "$ref": "#/components/responses/Problem" },
+					"404": { "$ref": "#/components/responses/Problem" },
+					"default": { "$ref": "#/components/responses/Problem" }
+				}
+			},
+			"patch": {
+				"operationId": "updateSyncTask",
+				"summary": "Change a sync task's enabled state, interval or default visibility.",
+				"description": "Platform Admin only. Source and target Namespace are immutable.",
+				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSyncTaskRequest" } } }
+				},
+				"responses": {
+					"200": {
+						"description": "The updated sync task.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SyncTask" } } }
+					},
+					"400": { "$ref": "#/components/responses/Problem" },
+					"401": { "$ref": "#/components/responses/Problem" },
+					"403": { "$ref": "#/components/responses/Problem" },
+					"404": { "$ref": "#/components/responses/Problem" },
+					"default": { "$ref": "#/components/responses/Problem" }
+				}
+			},
+			"delete": {
+				"operationId": "deleteSyncTask",
+				"summary": "Soft-delete a sync task.",
+				"description": "Platform Admin only. Runs and items are retained; Capabilities are never deleted.",
+				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
+				"responses": {
+					"204": { "description": "Deleted." },
+					"401": { "$ref": "#/components/responses/Problem" },
+					"403": { "$ref": "#/components/responses/Problem" },
+					"404": { "$ref": "#/components/responses/Problem" },
+					"default": { "$ref": "#/components/responses/Problem" }
+				}
+			}
+		},
+		"/api/v1/sync-tasks/{task_id}/runs": {
+			"parameters": [{ "$ref": "#/components/parameters/SyncTaskID" }],
+			"get": {
+				"operationId": "listSyncRuns",
+				"summary": "List a task's runs.",
+				"description": "Platform Admin only. Newest first, paged by cursor.",
+				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
+				"parameters": [{ "$ref": "#/components/parameters/Cursor" }, {
+					"name": "limit",
+					"in": "query",
+					"schema": {
+						"type": "integer",
+						"minimum": 1,
+						"maximum": 100,
+						"default": 20
+					}
+				}],
+				"responses": {
+					"200": {
+						"description": "One page of runs.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SyncRunList" } } }
+					},
+					"401": { "$ref": "#/components/responses/Problem" },
+					"403": { "$ref": "#/components/responses/Problem" },
+					"404": { "$ref": "#/components/responses/Problem" },
+					"default": { "$ref": "#/components/responses/Problem" }
+				}
+			},
+			"post": {
+				"operationId": "triggerSyncRun",
+				"summary": "Start a manual run.",
+				"description": "Platform Admin only. The run executes in the background; the response\nis 202 with the running run. A run already in flight answers 409\n`/problems/sync-busy`. dry_run plans without writing Capabilities.\n",
+				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
+				"requestBody": {
+					"required": false,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/TriggerSyncRunRequest" } } }
+				},
+				"responses": {
+					"202": {
+						"description": "The run was accepted.",
+						"headers": { "Location": { "schema": { "type": "string" } } },
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SyncRunSummary" } } }
+					},
+					"400": { "$ref": "#/components/responses/Problem" },
+					"401": { "$ref": "#/components/responses/Problem" },
+					"403": { "$ref": "#/components/responses/Problem" },
+					"404": { "$ref": "#/components/responses/Problem" },
+					"409": { "$ref": "#/components/responses/Problem" },
+					"default": { "$ref": "#/components/responses/Problem" }
+				}
+			}
+		},
+		"/api/v1/sync-tasks/{task_id}/runs/{run_id}": {
+			"parameters": [{ "$ref": "#/components/parameters/SyncTaskID" }, {
+				"name": "run_id",
+				"in": "path",
+				"required": true,
+				"schema": {
+					"type": "string",
+					"format": "uuid"
+				}
+			}],
+			"get": {
+				"operationId": "getSyncRun",
+				"summary": "Read one run with its per-Skill results.",
+				"description": "Platform Admin only.",
+				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
+				"responses": {
+					"200": {
+						"description": "The run.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SyncRun" } } }
+					},
+					"401": { "$ref": "#/components/responses/Problem" },
+					"403": { "$ref": "#/components/responses/Problem" },
+					"404": { "$ref": "#/components/responses/Problem" },
+					"default": { "$ref": "#/components/responses/Problem" }
+				}
+			}
+		},
+		"/api/v1/sync-tasks/{task_id}/items": {
+			"parameters": [{ "$ref": "#/components/parameters/SyncTaskID" }],
+			"get": {
+				"operationId": "listSyncItems",
+				"summary": "Read a task's current per-Skill state.",
+				"description": "Platform Admin only. Ordered by upstream name, paged by cursor.",
+				"security": [{ "sessionCookie": [] }, { "bearerToken": [] }],
+				"parameters": [
+					{
+						"name": "state",
+						"in": "query",
+						"schema": {
+							"type": "array",
+							"items": { "$ref": "#/components/schemas/SyncItemState" }
+						},
+						"style": "form",
+						"explode": true
+					},
+					{
+						"name": "limit",
+						"in": "query",
+						"schema": {
+							"type": "integer",
+							"minimum": 1,
+							"maximum": 500,
+							"default": 50
+						}
+					},
+					{ "$ref": "#/components/parameters/Cursor" }
+				],
+				"responses": {
+					"200": {
+						"description": "One page of items.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SyncItemList" } } }
+					},
+					"400": { "$ref": "#/components/responses/Problem" },
+					"401": { "$ref": "#/components/responses/Problem" },
+					"403": { "$ref": "#/components/responses/Problem" },
+					"404": { "$ref": "#/components/responses/Problem" },
+					"default": { "$ref": "#/components/responses/Problem" }
+				}
+			}
 		}
 	},
 	components: {
@@ -2344,10 +2580,19 @@ const COMMANDS = deriveCommands({
 					"default": 20
 				}
 			},
+			"SyncTaskID": {
+				"name": "task_id",
+				"in": "path",
+				"required": true,
+				"schema": {
+					"type": "string",
+					"format": "uuid"
+				}
+			},
 			"IfMatch": {
 				"name": "If-Match",
 				"in": "header",
-				"description": "The current strong `ETag` of the resource. Not required by the schema because a missing value answers 428, not 400.",
+				"description": "The current `ETag` of the resource. Not required by the schema because a missing value answers 428, not 400. A `W/` prefix, which a compressing intermediary adds to the tag while forwarding the same representation, is tolerated.",
 				"required": false,
 				"schema": { "type": "string" }
 			},
@@ -2443,7 +2688,7 @@ const COMMANDS = deriveCommands({
 		} },
 		"headers": {
 			"ETag": {
-				"description": "A strong entity tag of the resource's management metadata: the fields\nthat describe how the resource is governed, such as a Capability's\nassigned Category's id, name and slug, excluding mutable counters like\na Capability's `download_count` and any caller-relative field. A\ndownload therefore never invalidates an editor's `If-Match`, and every\ncaller sees the same tag.\n",
+				"description": "A strong entity tag of the resource's management metadata: the fields\nthat describe how the resource is governed, such as a Capability's\nassigned Category's id, name and slug, excluding mutable counters like\na Capability's `download_count` and any caller-relative field. A\ndownload therefore never invalidates an editor's `If-Match`, and every\ncaller sees the same tag. A compressing intermediary may weaken the\ntag to `W/\"…\"` in transit; replaying that form as `If-Match` still\nupdates the same representation.\n",
 				"required": true,
 				"schema": { "type": "string" }
 			},
@@ -3110,7 +3355,9 @@ const COMMANDS = deriveCommands({
 							"device_authorization",
 							"principal",
 							"session",
-							"team"
+							"team",
+							"sync_task",
+							"sync_run"
 						]
 					},
 					"resource_id": {
@@ -4228,6 +4475,345 @@ const COMMANDS = deriveCommands({
 					}
 				},
 				"additionalProperties": true
+			},
+			"SyncTask": {
+				"type": "object",
+				"required": [
+					"id",
+					"source",
+					"namespace",
+					"namespace_kind",
+					"default_visibility",
+					"interval_minutes",
+					"enabled",
+					"agent",
+					"created_by",
+					"created_at",
+					"updated_at",
+					"next_run_at",
+					"consecutive_failures",
+					"degraded",
+					"deleted_at",
+					"last_run",
+					"item_counts"
+				],
+				"properties": {
+					"id": {
+						"type": "string",
+						"format": "uuid"
+					},
+					"source": {
+						"type": "string",
+						"enum": ["seek"]
+					},
+					"namespace": { "$ref": "#/components/schemas/Name" },
+					"namespace_kind": {
+						"type": "string",
+						"enum": [
+							"system",
+							"team",
+							"principal"
+						]
+					},
+					"default_visibility": { "$ref": "#/components/schemas/Visibility" },
+					"interval_minutes": {
+						"type": "integer",
+						"minimum": 5,
+						"maximum": 10080
+					},
+					"enabled": { "type": "boolean" },
+					"agent": {
+						"type": "object",
+						"required": ["username"],
+						"properties": { "username": { "type": "string" } }
+					},
+					"created_by": {
+						"type": "string",
+						"format": "uuid"
+					},
+					"created_at": {
+						"type": "string",
+						"format": "date-time"
+					},
+					"updated_at": {
+						"type": "string",
+						"format": "date-time"
+					},
+					"next_run_at": {
+						"type": ["string", "null"],
+						"format": "date-time"
+					},
+					"consecutive_failures": {
+						"type": "integer",
+						"minimum": 0
+					},
+					"degraded": { "type": "boolean" },
+					"deleted_at": {
+						"type": ["string", "null"],
+						"format": "date-time"
+					},
+					"last_run": { "oneOf": [{ "$ref": "#/components/schemas/SyncRunSummary" }, { "type": "null" }] },
+					"item_counts": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "integer",
+							"format": "int64",
+							"minimum": 0
+						}
+					}
+				}
+			},
+			"SyncTaskList": {
+				"type": "object",
+				"required": ["items", "next_cursor"],
+				"properties": {
+					"items": {
+						"type": "array",
+						"items": { "$ref": "#/components/schemas/SyncTask" }
+					},
+					"next_cursor": { "$ref": "#/components/schemas/NextCursor" }
+				}
+			},
+			"CreateSyncTaskRequest": {
+				"type": "object",
+				"required": ["namespace"],
+				"properties": {
+					"namespace": { "$ref": "#/components/schemas/Name" },
+					"interval_minutes": {
+						"type": "integer",
+						"minimum": 5,
+						"maximum": 10080,
+						"default": 60
+					},
+					"default_visibility": {
+						"$ref": "#/components/schemas/Visibility",
+						"default": "internal"
+					},
+					"enabled": {
+						"type": "boolean",
+						"default": false
+					}
+				}
+			},
+			"UpdateSyncTaskRequest": {
+				"type": "object",
+				"minProperties": 1,
+				"properties": {
+					"enabled": { "type": "boolean" },
+					"interval_minutes": {
+						"type": "integer",
+						"minimum": 5,
+						"maximum": 10080
+					},
+					"default_visibility": { "$ref": "#/components/schemas/Visibility" }
+				}
+			},
+			"TriggerSyncRunRequest": {
+				"type": "object",
+				"properties": { "dry_run": {
+					"type": "boolean",
+					"default": false
+				} }
+			},
+			"SyncItemState": {
+				"type": "string",
+				"enum": [
+					"active",
+					"conflict",
+					"missing",
+					"orphaned",
+					"deleted_locally",
+					"error"
+				]
+			},
+			"SyncRunStatus": {
+				"type": "string",
+				"enum": [
+					"running",
+					"succeeded",
+					"partial",
+					"failed",
+					"interrupted",
+					"skipped_overlap"
+				]
+			},
+			"SyncRunItemStatus": {
+				"type": "string",
+				"enum": [
+					"added",
+					"updated",
+					"skipped",
+					"conflict",
+					"missing",
+					"deleted_locally",
+					"failed"
+				]
+			},
+			"SyncRunCounts": {
+				"type": "object",
+				"required": [
+					"added",
+					"updated",
+					"skipped",
+					"conflict",
+					"missing",
+					"failed",
+					"deleted_locally"
+				],
+				"properties": {
+					"added": {
+						"type": "integer",
+						"minimum": 0
+					},
+					"updated": {
+						"type": "integer",
+						"minimum": 0
+					},
+					"skipped": {
+						"type": "integer",
+						"minimum": 0
+					},
+					"conflict": {
+						"type": "integer",
+						"minimum": 0
+					},
+					"missing": {
+						"type": "integer",
+						"minimum": 0
+					},
+					"failed": {
+						"type": "integer",
+						"minimum": 0
+					},
+					"deleted_locally": {
+						"type": "integer",
+						"minimum": 0
+					}
+				}
+			},
+			"SyncRunSummary": {
+				"type": "object",
+				"required": [
+					"id",
+					"task_id",
+					"trigger",
+					"dry_run",
+					"status",
+					"started_at",
+					"finished_at",
+					"counts",
+					"error_summary"
+				],
+				"properties": {
+					"id": {
+						"type": "string",
+						"format": "uuid"
+					},
+					"task_id": {
+						"type": "string",
+						"format": "uuid"
+					},
+					"trigger": {
+						"type": "string",
+						"enum": ["schedule", "manual"]
+					},
+					"dry_run": { "type": "boolean" },
+					"status": { "$ref": "#/components/schemas/SyncRunStatus" },
+					"started_at": {
+						"type": "string",
+						"format": "date-time"
+					},
+					"finished_at": {
+						"type": ["string", "null"],
+						"format": "date-time"
+					},
+					"counts": { "$ref": "#/components/schemas/SyncRunCounts" },
+					"error_summary": { "type": ["string", "null"] }
+				}
+			},
+			"SyncRunItem": {
+				"type": "object",
+				"required": ["upstream_name", "status"],
+				"properties": {
+					"upstream_name": { "type": "string" },
+					"upstream_path": { "type": "string" },
+					"status": { "$ref": "#/components/schemas/SyncRunItemStatus" },
+					"capability_id": {
+						"type": ["string", "null"],
+						"format": "uuid"
+					},
+					"namespace": { "type": "string" },
+					"name": { "type": "string" },
+					"path": { "type": "string" },
+					"version": { "type": ["string", "null"] },
+					"error": { "type": ["string", "null"] }
+				}
+			},
+			"SyncRun": { "allOf": [{ "$ref": "#/components/schemas/SyncRunSummary" }, {
+				"type": "object",
+				"required": ["items"],
+				"properties": { "items": {
+					"type": "array",
+					"items": { "$ref": "#/components/schemas/SyncRunItem" }
+				} }
+			}] },
+			"SyncRunList": {
+				"type": "object",
+				"required": ["items", "next_cursor"],
+				"properties": {
+					"items": {
+						"type": "array",
+						"items": { "$ref": "#/components/schemas/SyncRunSummary" }
+					},
+					"next_cursor": { "$ref": "#/components/schemas/NextCursor" }
+				}
+			},
+			"SyncItem": {
+				"type": "object",
+				"required": [
+					"upstream_name",
+					"state",
+					"content_hash",
+					"last_seen_at"
+				],
+				"properties": {
+					"upstream_name": { "type": "string" },
+					"upstream_path": { "type": "string" },
+					"state": { "$ref": "#/components/schemas/SyncItemState" },
+					"capability_id": {
+						"type": ["string", "null"],
+						"format": "uuid"
+					},
+					"namespace": { "type": "string" },
+					"name": { "type": "string" },
+					"path": { "type": "string" },
+					"version": { "type": ["string", "null"] },
+					"content_hash": { "type": "string" },
+					"last_seen_at": {
+						"type": "string",
+						"format": "date-time"
+					},
+					"last_synced_at": {
+						"type": ["string", "null"],
+						"format": "date-time"
+					},
+					"last_run_id": {
+						"type": ["string", "null"],
+						"format": "uuid"
+					},
+					"error": { "type": ["string", "null"] }
+				}
+			},
+			"SyncItemList": {
+				"type": "object",
+				"required": ["items", "next_cursor"],
+				"properties": {
+					"items": {
+						"type": "array",
+						"items": { "$ref": "#/components/schemas/SyncItem" }
+					},
+					"next_cursor": { "$ref": "#/components/schemas/NextCursor" }
+				}
 			}
 		},
 		"securitySchemes": {
@@ -4382,6 +4968,42 @@ function workflowCatalog() {
 			destructive: false,
 			dryRun: true
 		},
+		{
+			name: "skills restore",
+			summary: "Reinstall the skills a lock file records",
+			group: "skills",
+			args: [{
+				name: "names",
+				required: false,
+				variadic: true,
+				description: "Locked skill names to restore (default: every Hangar entry)"
+			}],
+			flags: [
+				{
+					name: "global",
+					type: "boolean",
+					description: "Read the user-level lock file instead of the project one"
+				},
+				{
+					name: "agent",
+					type: "string",
+					repeatable: true,
+					description: "Agent target id"
+				},
+				{
+					name: "all",
+					type: "boolean",
+					description: "Install to all known agents"
+				},
+				{
+					name: "copy",
+					type: "boolean",
+					description: "Copy instead of canonical + symlink"
+				}
+			],
+			destructive: false,
+			dryRun: true
+		},
 		{
 			name: "skills publish",
 			summary: "Publish a local skill directory as a capability or a new version",