@petercjl/cloud-hug-style-transfer 0.5.0 → 0.5.2

package/skills/cloud-hug-style-transfer/adapters/generic.json

@@ -0,0 +1,74 @@
+{
+  "schema": "portable-skill-adapter",
+  "schema_version": "1.0.0",
+  "platform": "generic",
+  "mappings": [
+    {
+      "capability_id": "media.image.inspect",
+      "status": "implemented",
+      "features": [
+        "local-image",
+        "visual-inspection"
+      ],
+      "implementation": {
+        "type": "agent-native",
+        "discovery": "Inspect the current host tool catalog and schemas; verify reference input and result delivery before invoking.",
+        "invocation": "Use the current host image-viewing tool to inspect actual local source, reference and output pixels; require a vision-capable model.",
+        "configuration": "Host-managed account and provider authorization; no credentials bundled."
+      },
+      "normalization": "Success: {ok:true,artifacts:[],metadata:{},task_id:null,cost:null,warnings:[]}; failure: {ok:false,code,message,capability_id}.",
+      "evidence": []
+    },
+    {
+      "capability_id": "media.image.edit",
+      "status": "implemented",
+      "features": [
+        "multiple-references",
+        "reference-image-edit",
+        "local-reference-input",
+        "viewable-output"
+      ],
+      "implementation": {
+        "type": "cli",
+        "discovery": "Run cloud-hug-style-transfer doctor --json; require dependencies.media.ok and use its verified invocation. Resolve sealseek-media via that CLI skill source --json and load the complete current SKILL.md plus its current host adapter.",
+        "invocation": "Follow the current sealseek-media Discover/Prepare/Validate/Submit/Follow/Deliver contract. Pass application-owned prompt and ordered local references, dry-run first, submit authorized generation via --via sealseek --submit, preserve task IDs and verify local output.",
+        "configuration": "Required @petercjl/sealseek-media-cli >=0.6.1; private media-package authentication, network and credits. Optional CLOUD_HUG_MEDIA_ROOT points to its installed package root.",
+        "failure": "Missing or incompatible package/Skill pauses the entire task before section 1; offer the minimal install prompt and resume only after verification. Service/feature failures pause without native-generation fallback."
+      },
+      "normalization": "Success: {ok:true,artifacts:[],metadata:{},task_id:null,cost:null,warnings:[]}; failure: {ok:false,code,message,capability_id}.",
+      "evidence": [
+        "Canonical sealseek-media 0.6.1 CLI/Skill and live capabilities inspected; paid generation and full host flow not tested."
+      ]
+    },
+    {
+      "capability_id": "media.canvas.compare",
+      "status": "implemented",
+      "features": [
+        "new-canvas",
+        "source-upload",
+        "actual-dimensions",
+        "explicit-placement",
+        "idempotent-pair-import",
+        "verified-save"
+      ],
+      "implementation": {
+        "type": "cli",
+        "discovery": "Use the verified media invocation from doctor; load canonical sealseek-media Skill and its current canvas creation, upload, inspection and explicit batch contract.",
+        "invocation": "Follow references/canvas-comparison.md for application naming, pairing, row state and layout; use media CLI canvas create, image upload, media inspect, canvas batch and canvas get. Pass an explicit canvas ID and archive none during generation; archive each pair after completion.",
+        "configuration": "Existing media-package private authentication and network. canvas_contract version 1; no new provider integration.",
+        "failure": "Pause on missing canvas contract, failed/uncertain creation, upload or pair write. Preserve IDs and original batch; inspect the same canvas before recovery."
+      },
+      "normalization": "Success includes canvas_id, canvas_url and verified pair positions; failure retains code, task/canvas IDs and recovery state.",
+      "evidence": [
+        "Current media CLI contract inspected; deterministic geometry and batch dry-run tested separately from real canvas writes."
+      ]
+    }
+  ],
+  "operating_systems": {
+    "macos": "implemented",
+    "windows": "implemented"
+  },
+  "notes": "Image generation uses the same required sealseek-media-cli on every host. Native viewing and command execution still require host verification. Missing media dependency pauses all tasks.",
+  "host_generation_tested": false,
+  "local_execution": "Use this installed Skill’s scripts/run.mjs for owning-package commands; resolve external media through its independently managed canonical contract."
+}

package/skills/cloud-hug-style-transfer/adapters/sealseek.json

@@ -71,5 +71,6 @@
     "windows": "implemented"
   },
   "notes": "Image generation uses the same required sealseek-media-cli on every host. Native viewing and command execution still require host verification. Missing media dependency pauses all tasks.",
-  "host_generation_tested": false
+  "host_generation_tested": false,
+  "local_execution": "Use this installed Skill’s scripts/run.mjs for owning-package commands; resolve external media through its independently managed canonical contract."
 }

package/skills/cloud-hug-style-transfer/adapters/workbuddy.json

@@ -71,5 +71,6 @@
     "windows": "implemented"
   },
   "notes": "Image generation uses the same required sealseek-media-cli on every host. Native viewing and command execution still require host verification. Missing media dependency pauses all tasks.",
-  "host_generation_tested": false
+  "host_generation_tested": false,
+  "local_execution": "Use this installed Skill’s scripts/run.mjs for owning-package commands; resolve external media through its independently managed canonical contract."
 }

package/skills/cloud-hug-style-transfer/capabilities.json

@@ -2,9 +2,7 @@
   "schema": "portable-skill-capabilities",
   "schema_version": "1.0.0",
   "target_platforms": [
-    "codex",
-    "sealseek",
-    "workbuddy"
+    "generic"
   ],
   "capabilities": [
     {
@@ -134,5 +132,586 @@
       "preflight": "cloud-hug-style-transfer doctor --json",
       "on_missing": "pause-entire-task"
     }
-  ]
+  ],
+  "package_version": "0.5.2",
+  "installationLifecycle": {
+    "agentNeutral": true,
+    "skillRequired": true,
+    "updateRequiresSkillSync": true,
+    "required_components": [
+      "cli",
+      "skill",
+      "runtime"
+    ],
+    "installGuide": "INSTALL.md",
+    "updateGuide": "UPDATE.md",
+    "explicitTargetRequired": true,
+    "hostDiscoveryVerification": true,
+    "physicalCopies": true,
+    "isolatedRuntime": true,
+    "sharedLinks": false,
+    "postBumpIdentityValidation": true,
+    "install": "Resolve own directory; skill install --agent AGENT --path EXACT_SKILL_DIR --json",
+    "update": "Resolve selected target first; update install --yes --path EXACT_SKILL_DIR --json",
+    "verification": "Local runtime version, managed hashes, then host-native discovery",
+    "target_scope": "selected current Agent only",
+    "targetRequired": true,
+    "hostRegistrationRequired": true,
+    "installationMode": "copy",
+    "sharedLinksAllowed": false,
+    "isolatedRuntimeRequired": true
+  },
+  "automaticUpdates": {
+    "enabledByDefault": true,
+    "defaultMode": "notify",
+    "intervalHours": 24,
+    "timeoutMs": 2000,
+    "trigger": "ordinary task entry; excludes help/version/source/task polling",
+    "configuration": "update policy --mode off|notify|auto --yes --path EXACT_SKILL_DIR",
+    "disable": "CLOUD_HUG_AUTO_UPDATE=0",
+    "installation": "explicit standing authorization; compatible stable version only",
+    "recovery": "update operation and resume reuse verified candidate"
+  },
+  "commandContracts": {
+    "version": {
+      "options": {
+        "--json": {
+          "type": "boolean",
+          "description": "Machine-readable JSON (also the default)."
+        },
+        "--help": {
+          "type": "boolean",
+          "description": "Read-only help for this command."
+        }
+      },
+      "sideEffects": "none"
+    },
+    "capabilities": {
+      "options": {
+        "--json": {
+          "type": "boolean",
+          "description": "Machine-readable JSON (also the default)."
+        },
+        "--help": {
+          "type": "boolean",
+          "description": "Read-only help for this command."
+        }
+      },
+      "sideEffects": "none"
+    },
+    "doctor": {
+      "options": {
+        "--json": {
+          "type": "boolean",
+          "description": "Machine-readable JSON (also the default)."
+        },
+        "--help": {
+          "type": "boolean",
+          "description": "Read-only help for this command."
+        },
+        "--agent": {
+          "type": "string",
+          "description": "Target host; defaults to codex."
+        },
+        "--root": {
+          "type": "string",
+          "description": "Skill parent directory; the CLI appends cloud-hug-style-transfer. Requires --agent on doctor and update."
+        },
+        "--no-auto-update": {
+          "type": "boolean",
+          "description": "Perform diagnosis without an automatic update preflight."
+        }
+      },
+      "sideEffects": "none"
+    },
+    "canvas row": {
+      "options": {
+        "--json": {
+          "type": "boolean",
+          "description": "Machine-readable JSON (also the default)."
+        },
+        "--help": {
+          "type": "boolean",
+          "description": "Read-only help for this command."
+        },
+        "--input": {
+          "type": "string",
+          "required": true,
+          "description": "Comparison input JSON file."
+        }
+      },
+      "sideEffects": "none"
+    },
+    "skill source": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "none"
+    },
+    "skill status": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string",
+          "description": "Valid current Agent name; generic fallback for unnamed hosts."
+        },
+        "--path": {
+          "type": "string",
+          "description": "Exact Skill destination resolved by the current Agent."
+        },
+        "--root": {
+          "type": "string",
+          "description": "Legacy explicit parent directory; appends the canonical Skill name."
+        },
+        "--home": {
+          "type": "string",
+          "description": "Legacy explicitly resolved host root; appends skills and Skill name."
+        },
+        "--target-directory": {
+          "type": "string",
+          "description": "Explicit exact Skill destination alias."
+        }
+      },
+      "sideEffects": "none"
+    },
+    "skill install": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string",
+          "description": "Valid current Agent name; generic fallback for unnamed hosts."
+        },
+        "--path": {
+          "type": "string",
+          "description": "Exact Skill destination resolved by the current Agent."
+        },
+        "--root": {
+          "type": "string",
+          "description": "Legacy explicit parent directory; appends the canonical Skill name."
+        },
+        "--home": {
+          "type": "string",
+          "description": "Legacy explicitly resolved host root; appends skills and Skill name."
+        },
+        "--target-directory": {
+          "type": "string",
+          "description": "Explicit exact Skill destination alias."
+        },
+        "--mode": {
+          "type": "string",
+          "enum": [
+            "copy",
+            "link"
+          ],
+          "description": "Legacy link requests migrate to a physical copy."
+        },
+        "--legacy-source": {
+          "type": "string",
+          "description": "Explicit owning package root for verified legacy migration."
+        },
+        "--force": {
+          "type": "boolean",
+          "description": "Accepted legacy flag; local edit protection remains enforced."
+        },
+        "--backup-edits": {
+          "type": "boolean",
+          "description": "Accepted legacy flag; local edits require separate reconciliation."
+        }
+      },
+      "sideEffects": "local-write"
+    },
+    "skill update": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string",
+          "description": "Valid current Agent name; generic fallback for unnamed hosts."
+        },
+        "--path": {
+          "type": "string",
+          "description": "Exact Skill destination resolved by the current Agent."
+        },
+        "--root": {
+          "type": "string",
+          "description": "Legacy explicit parent directory; appends the canonical Skill name."
+        },
+        "--home": {
+          "type": "string",
+          "description": "Legacy explicitly resolved host root; appends skills and Skill name."
+        },
+        "--target-directory": {
+          "type": "string",
+          "description": "Explicit exact Skill destination alias."
+        },
+        "--mode": {
+          "type": "string",
+          "enum": [
+            "copy",
+            "link"
+          ],
+          "description": "Legacy link requests migrate to a physical copy."
+        },
+        "--legacy-source": {
+          "type": "string",
+          "description": "Explicit owning package root for verified legacy migration."
+        },
+        "--force": {
+          "type": "boolean",
+          "description": "Accepted legacy flag; local edit protection remains enforced."
+        },
+        "--backup-edits": {
+          "type": "boolean",
+          "description": "Accepted legacy flag; local edits require separate reconciliation."
+        }
+      },
+      "sideEffects": "local-write"
+    },
+    "update check": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        }
+      },
+      "sideEffects": "none"
+    },
+    "update install": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string",
+          "description": "Valid current Agent name; generic fallback for unnamed hosts."
+        },
+        "--path": {
+          "type": "string",
+          "description": "Exact Skill destination resolved by the current Agent."
+        },
+        "--root": {
+          "type": "string",
+          "description": "Legacy explicit parent directory; appends the canonical Skill name."
+        },
+        "--home": {
+          "type": "string",
+          "description": "Legacy explicitly resolved host root; appends skills and Skill name."
+        },
+        "--target-directory": {
+          "type": "string",
+          "description": "Explicit exact Skill destination alias."
+        },
+        "--yes": {
+          "type": "boolean",
+          "required": true
+        },
+        "--candidate": {
+          "type": "string",
+          "description": "Absolute packed candidate archive for authorized installation."
+        },
+        "--version": {
+          "type": "string",
+          "description": "Exact stable registry version."
+        }
+      },
+      "sideEffects": "package-and-skill-update"
+    },
+    "update operation": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string",
+          "description": "Valid current Agent name; generic fallback for unnamed hosts."
+        },
+        "--path": {
+          "type": "string",
+          "description": "Exact Skill destination resolved by the current Agent."
+        },
+        "--root": {
+          "type": "string",
+          "description": "Legacy explicit parent directory; appends the canonical Skill name."
+        },
+        "--home": {
+          "type": "string",
+          "description": "Legacy explicitly resolved host root; appends skills and Skill name."
+        },
+        "--target-directory": {
+          "type": "string",
+          "description": "Explicit exact Skill destination alias."
+        },
+        "--operation": {
+          "type": "string"
+        }
+      },
+      "sideEffects": "none"
+    },
+    "update resume": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string",
+          "description": "Valid current Agent name; generic fallback for unnamed hosts."
+        },
+        "--path": {
+          "type": "string",
+          "description": "Exact Skill destination resolved by the current Agent."
+        },
+        "--root": {
+          "type": "string",
+          "description": "Legacy explicit parent directory; appends the canonical Skill name."
+        },
+        "--home": {
+          "type": "string",
+          "description": "Legacy explicitly resolved host root; appends skills and Skill name."
+        },
+        "--target-directory": {
+          "type": "string",
+          "description": "Explicit exact Skill destination alias."
+        },
+        "--yes": {
+          "type": "boolean",
+          "required": true
+        },
+        "--operation": {
+          "type": "string"
+        }
+      },
+      "sideEffects": "package-and-skill-update"
+    },
+    "update rollback": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string",
+          "description": "Valid current Agent name; generic fallback for unnamed hosts."
+        },
+        "--path": {
+          "type": "string",
+          "description": "Exact Skill destination resolved by the current Agent."
+        },
+        "--root": {
+          "type": "string",
+          "description": "Legacy explicit parent directory; appends the canonical Skill name."
+        },
+        "--home": {
+          "type": "string",
+          "description": "Legacy explicitly resolved host root; appends skills and Skill name."
+        },
+        "--target-directory": {
+          "type": "string",
+          "description": "Explicit exact Skill destination alias."
+        },
+        "--yes": {
+          "type": "boolean",
+          "required": true
+        },
+        "--operation": {
+          "type": "string"
+        }
+      },
+      "sideEffects": "package-and-skill-update"
+    },
+    "update policy": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string",
+          "description": "Valid current Agent name; generic fallback for unnamed hosts."
+        },
+        "--path": {
+          "type": "string",
+          "description": "Exact Skill destination resolved by the current Agent."
+        },
+        "--root": {
+          "type": "string",
+          "description": "Legacy explicit parent directory; appends the canonical Skill name."
+        },
+        "--home": {
+          "type": "string",
+          "description": "Legacy explicitly resolved host root; appends skills and Skill name."
+        },
+        "--target-directory": {
+          "type": "string",
+          "description": "Explicit exact Skill destination alias."
+        },
+        "--yes": {
+          "type": "boolean"
+        },
+        "--mode": {
+          "type": "string",
+          "enum": [
+            "off",
+            "notify",
+            "auto"
+          ]
+        }
+      },
+      "sideEffects": "local-write",
+      "writeCondition": "Only an authorized explicit --mode change writes policy."
+    },
+    "update status": {
+      "options": {
+        "--json": {
+          "type": "boolean"
+        },
+        "--help": {
+          "type": "boolean"
+        },
+        "--agent": {
+          "type": "string",
+          "description": "Valid current Agent name; generic fallback for unnamed hosts."
+        },
+        "--path": {
+          "type": "string",
+          "description": "Exact Skill destination resolved by the current Agent."
+        },
+        "--root": {
+          "type": "string",
+          "description": "Legacy explicit parent directory; appends the canonical Skill name."
+        },
+        "--home": {
+          "type": "string",
+          "description": "Legacy explicitly resolved host root; appends skills and Skill name."
+        },
+        "--target-directory": {
+          "type": "string",
+          "description": "Explicit exact Skill destination alias."
+        }
+      },
+      "sideEffects": "none"
+    }
+  },
+  "host_resolution": {
+    "fallback_adapter": "generic",
+    "eligibility": "Required capabilities, service and OS prerequisites; Agent names are not an allowlist.",
+    "destination": "The current Agent resolves an explicit Skill destination from its own host configuration."
+  },
+  "maintenanceContract": {
+    "schemaVersion": 1,
+    "agentEligibility": "valid-name-with-generic-fallback",
+    "hostDiscoveryAuthority": "host",
+    "targetOptions": {
+      "--path": {
+        "kind": "skill-directory"
+      },
+      "--target-directory": {
+        "kind": "skill-directory"
+      },
+      "--root": {
+        "kind": "skill-parent"
+      },
+      "--home": {
+        "kind": "host-root"
+      }
+    },
+    "source": {
+      "name": {
+        "field": "name",
+        "type": "string"
+      },
+      "package": {
+        "field": "package",
+        "type": "string"
+      },
+      "version": {
+        "field": "version",
+        "type": "string"
+      },
+      "path": {
+        "field": "source",
+        "type": "string"
+      }
+    },
+    "status": {
+      "name": {
+        "field": "name",
+        "type": "string"
+      },
+      "package": {
+        "field": "package",
+        "type": "string"
+      },
+      "version": {
+        "field": "version",
+        "type": "string"
+      },
+      "target": {
+        "field": "target",
+        "type": "string"
+      },
+      "installed": {
+        "field": "installed",
+        "type": "boolean"
+      },
+      "managed": {
+        "field": "managed",
+        "type": "boolean"
+      },
+      "current": {
+        "field": "up_to_date",
+        "type": "boolean"
+      },
+      "edited": {
+        "field": "editedFiles",
+        "type": "string[]"
+      },
+      "verification": {
+        "field": "verification",
+        "type": "object"
+      },
+      "recovery": {
+        "field": "recovery",
+        "type": "object"
+      }
+    },
+    "legacyFields": {
+      "current": "boolean alias of up_to_date",
+      "edited": "boolean retained; use editedFiles for paths"
+    },
+    "evidenceReuse": "Reuse matching package/version/target/integrity receipts within the operation; repeat only after mutation, conflict or stale channel evidence."
+  }
 }