@petercjl/cloud-hug-style-transfer 0.4.0 → 0.5.1

package/npm/cli.mjs

@@ -1,39 +1,45 @@
 #!/usr/bin/env node
 import fs from 'node:fs';
 import path from 'node:path';
-import { root, pkg, fail } from './runtime.mjs';
-import { source, resolveTarget, status, install, inventory, skillMetadata } from './skills.mjs';
-import { checkUpdate, installUpdate, globalPrefix } from './update.mjs';
-import { mediaDependency } from './media-dependency.mjs';
-import { comparisonRow } from './canvas-layout.mjs';
-import { parse, manifest } from './arguments.mjs';
-const started=performance.now();
-const out=value=>console.log(JSON.stringify(value,null,2));
-try {
- const {command,options:o,contract}=parse(process.argv.slice(2));
- const identity={package:pkg.name,version:pkg.version,source,entry:{node:process.execPath,cli:path.join(root,'npm/cli.mjs')},owner:globalPrefix()?'global-npm':'source-or-parent'};
- if(command==='help')out({ok:true,...identity,commands:manifest.commandContracts});
- else if(o['--help'])out({ok:true,command,...contract});
- else if(command==='version')out({ok:true,name:pkg.name,...identity});
- else if(command==='capabilities')out({...manifest,...identity});
- else if(command==='canvas row')out(comparisonRow(JSON.parse(fs.readFileSync(o['--input'],'utf8'))));
- else if(command==='skill source')out({ok:true,...identity});
- else if(command.startsWith('skill ')) {
-  const resolution=resolveTarget(o['--agent']||'codex',o['--root']);
-  const result=command==='skill status'?{ok:true,...status(resolution.target),record:undefined}:install(resolution.target);
-  out({...identity,...result,resolution});
- } else if(command==='doctor') {
-  const files=inventory(source),expected=JSON.parse(fs.readFileSync(path.join(root,'npm/integrity.json'),'utf8'));
-  const problems=Object.entries(expected).filter(([name,hash])=>files[name]!==hash).map(([name])=>name);
-  const media=mediaDependency();const metadata=skillMetadata(source);
-  const result={ok:Number(process.versions.node.split('.')[0])>=22&&!problems.length&&metadata.valid&&media.ok,...identity,node:process.versions.node,files:Object.keys(files).length,integrity:{ok:!problems.length,problems},metadata:{valid:metadata.valid},installationReady:!problems.length&&metadata.valid,dependencies:{media},hostCapabilityDependencies:manifest.requirements.host_capability_skills,generation:{provider:'@petercjl/sealseek-media-cli',state:media.ok?'requires-live-preflight':'paused',runtimeTested:false,requiredFeatures:['image-inspection','multiple-reference-edit','local-reference-input','viewable-output']}};
-  if(!media.ok){result.code=media.code;result.action='pause';result.installPrompt=media.installPrompt;}
-  if(o['--agent']){result.resolution=resolveTarget(o['--agent'],o['--root']);result.installation={...status(result.resolution.target),record:undefined};if(!result.installation.current){result.ok=false;result.code||='SKILL_RECONCILIATION_REQUIRED';}}
-  out({...result,timingsMs:{total:performance.now()-started}});if(!result.ok)process.exitCode=1;
- } else if(command.startsWith('update ')) {
-  const resolution=o['--agent']?resolveTarget(o['--agent'],o['--root']):undefined;
-  const registryStarted=performance.now();const check=await checkUpdate();const registryMs=performance.now()-registryStarted;
-  if(command==='update check'){out({...check,...identity,...(resolution?{resolution,installation:{...status(resolution.target),record:undefined}}:{}),timingsMs:{total:performance.now()-started}});if(!check.ok)process.exitCode=1;}
-  else {if(!check.ok)throw fail(check.code,'Registry unavailable; installed version retained.');const result=installUpdate(check,{resolution});out({...result,timingsMs:{...result.timingsMs,registry:registryMs,total:performance.now()-started}});}
+import {spawnSync} from 'node:child_process';
+let lifecycle;try{lifecycle=await import('../lifecycle/engine.mjs');}catch{console.log(JSON.stringify({ok:false,code:'LIFECYCLE_DEPENDENCY_MISSING',message:'Install the owning npm package with its required dependencies before continuing.'}));process.exit(1);}
+const {dispatch,automatic,resolveTarget,status,root,pkg,config,installationLifecycle}=lifecycle;
+const args=process.argv.slice(2);
+if(!await dispatch(args)) {
+ if(args[0]==='version'||args[0]==='--version'){if(args.slice(1).some(x=>x!=='--json')||args.filter(x=>x==='--json').length>1){console.log(JSON.stringify({ok:false,code:'INVALID_ARGUMENT',message:'version accepts only one --json flag.'}));process.exitCode=1;}else console.log(JSON.stringify({ok:true,name:pkg.name,version:pkg.version,entry:process.argv[1]}));}
+ else {
+  let target;
+  try {
+   const declaration=JSON.parse(fs.readFileSync(path.join(root,'capabilities.json'),'utf8'));
+   const doctorRoot=args[0]==='doctor'&&declaration.commandContracts?.doctor?.options?.['--root'];
+   const binding={},clean=[];
+   for(let i=0;i<args.length;i++){
+    const key=args[i];if(!['--agent','--skill-path',...(doctorRoot?['--root']:[])].includes(key)){clean.push(key);continue;}
+    const field=key==='--agent'?'agent':key==='--root'?'root':'skill-path';if(field in binding||!args[i+1]||args[i+1].startsWith('--'))throw Object.assign(Error('Duplicate or missing target binding'),{code:'INVALID_ARGUMENT'});binding[field]=args[++i];
+   }
+   if(Object.keys(binding).length)target=resolveTarget(binding);
+   args.splice(0,args.length,...clean);process.argv.splice(2,process.argv.length-2,...clean);
+
+   const marker=path.join(path.dirname(root),'.agent-package.json');
+   if(!target&&path.basename(root)==='.runtime'&&fs.existsSync(marker)&&JSON.parse(fs.readFileSync(marker)).package===pkg.name)target=resolveTarget({path:path.dirname(root)});
+   else if(!target&&process.env[config.env+'_SKILL_PATH'])target=resolveTarget();
+  }catch(e){console.error(JSON.stringify({ok:false,code:e.code,message:e.message}));process.exit(1);}
+  const ordinary=!args.includes('--help')&&!args.includes('-h')&&!['task','help','--help','-h','_worker','_auth-worker'].includes(args[0])&&args.length;
+  if(ordinary&&!args.includes('--no-auto-update')){
+   const receipt=await automatic(target);
+   if(!['disabled','cached','up-to-date','owner-managed'].includes(receipt.state))console.error(JSON.stringify({automaticUpdate:receipt}));
+   if(receipt.state==='updated'){
+    console.error(JSON.stringify({reloadSkill:true,entry:receipt.receipt.entry}));
+    const r=spawnSync(process.execPath,[receipt.receipt.entry,...args],{stdio:'inherit',env:{...process.env,[config.env+'_AUTO_UPDATE']:'0'},windowsHide:true});process.exit(r.status??1);
+   }
+   if(!receipt.ok){console.error(JSON.stringify(receipt));process.exit(1);}
+  }
+  if(args[0]==='doctor'&&target){
+   const installation=status(target),originalLog=console.log.bind(console);
+   console.log=(text,...rest)=>{let value;try{value=JSON.parse(text);}catch{return originalLog(text,...rest);}if(value&&typeof value==='object'){value.installation=installation;value.resolution=target;if(!installation.current){value.ok=false;value.code||='SKILL_RECONCILIATION_REQUIRED';process.exitCode=1;}}return originalLog(JSON.stringify(value,null,2));};
+  }
+  // Lifecycle and automatic maintenance are owned by the package dispatcher.
+  process.env[config.env+'_AUTO_UPDATE']='0';process.env[config.env+'_UPDATE_CHECK']='0';
+  await import('./business.mjs');
  }
-} catch(e){out({ok:false,code:e.code||'COMMAND_FAILED',message:e.message,...(e.causeCode?{causeCode:e.causeCode}:{}),...(e.backup?{backup:e.backup}:{}),...(e.details?{details:e.details}:{}),timingsMs:{total:performance.now()-started}});process.exitCode=1;}
+}

package/npm/integrity.json

@@ -1,8 +1,9 @@
 {
-  "SKILL.md": "98df8d4271e525c687a1f0b3e877345bd42f3ca537515c0f84a9c0d58b17612b",
-  "adapters/codex.json": "bea8d59e6e0dafae7439693b33356825023516a6f52be02a64c976d7ce47ce76",
-  "adapters/sealseek.json": "04ef053762fd4cfc2309573ec87425afad14b2df85a1ea8ef0aa06d98fee1aee",
-  "adapters/workbuddy.json": "cd0a1d8d5b9fcebc5a709b8c7523911f41973adb95f71af2c0f644473a43a6b4",
+  "SKILL.md": "501ce6f6dfe3e892c889e572df2ceb992bc68ba6dbfaab608b5e6558f67072c1",
+  "adapters/codex.json": "c8f0a3afc937725d561a9713fda9e32be309cb8394f971450b58731568421b62",
+  "adapters/generic.json": "0f1ec9e7b4a698449500af609644c2ef0737ea4a0eb0ccd56a013935a64df2f3",
+  "adapters/sealseek.json": "58cc420131ec37e793fe57900880f86cb30027e2f8cc4713b1a0568df4b78ab8",
+  "adapters/workbuddy.json": "b6f04afd14ccc95539c209f4bd8cf90be09240ff9ac95bcc5b1bd4f5b8b587ef",
   "agents/openai.yaml": "d8ebec24c4e3034f4b45aa052b9468ab35790ec7fd93febcfde512c746d2d1d1",
   "assets/approved/all-colors-user-finish.webp": "539c77de8ec0dd46a29793befecf813e97ce6ae66f7cbe69486846383b2ae936",
   "assets/approved/brand-kv-user-finish-20261012.png": "cb09198481e779444696864b265c689f467207bf7de9610f7adc2b850f0be7b4",
@@ -55,18 +56,19 @@
   "assets/rejected/brand-kv-c2-20261012.webp": "88ed2de0d950ea4a34519661481877ee0899743a6dfce203a2033c0dab6a73f7",
   "assets/rejected/overhead-rest-b.webp": "16e5e6fabdc665868ac244d556f3a8a93db826a34425fdee042e4f7a8ebf64c3",
   "assets/rejected/prone-pile-a.webp": "d07f38bbb69fc23b30dca4ed27faa3d7ae58e2e81840a1c3d46101911c28a7a2",
-  "capabilities.json": "5d40595bf64402acf700cbaea63065d104547b12e59c275bca59cc9b4658de85",
+  "capabilities.json": "cd1fefac8edde8f00bc62f07d428b552b6a1130c7c67b8a89d5352338a4ee8cb",
   "references/assets.md": "98b1a60d70cbc9ceec3e0d11dadbc0dc96344ac6f15cd5289009dfbfd8d71d6e",
   "references/brand-layout.md": "74f2674b7c9987e15a9d2ca7bb18498378eecc2d869d37e9ca1e71bd228ee883",
   "references/canvas-comparison.md": "df85594c92de3e87daa85ee7cd9cc92df4be9049a5d42c32904542faf329a6c7",
   "references/cases.md": "9d0d2d3d210e367411d5a291fc78ef6c9c733afd79c9da76451c580fcbcd4d3e",
   "references/detail-final-20261016.md": "d9311413420db743466bbecfe98c31b9753eeead905472d69839afec9578c557",
   "references/kv-layout-case-20261012.md": "845b287cfc57912aabedc48e558ca661cf86bf136304ea841030205a806ef06f",
-  "references/maintenance.md": "ccaa22cbe537885c7936d76b9091ef681491fd75d3791f6dbcf803d2337cee8e",
+  "references/maintenance.md": "f17e3fa7c74d630db5238fd366b7cd3864ba630a4dbd6e243f21e1337d082f80",
   "references/model-generation.json": "21daa2c3bf7d2000c7ddf52ab0b980cb7ee95d6c9d345602dc59ecbc128ec147",
   "references/model.md": "c4da688e22e2ada3f251fe0dc87effcaf5cb6ed6176f9d9c20a9661414bffab5",
   "references/page-patterns.md": "bdd6756e303c95e432d0239be27ec5af1faf75abf71594917f2e11467255a1b4",
   "references/photography-method.md": "c0e54598863f3b4a2d87f27d6f18afb75db22ae71ce2aead41f817f35258807e",
   "references/products.md": "642795ae16803669b169531240723bf72a388cb6351679a2787e67e181dca9cd",
-  "references/source-page-three-variants.md": "02a265cf11c3ff3bb7796eb289529ce97f6f64f0350a15a7e3275cec24037720"
+  "references/source-page-three-variants.md": "02a265cf11c3ff3bb7796eb289529ce97f6f64f0350a15a7e3275cec24037720",
+  "scripts/run.mjs": "0b71e6de4ae7babfce792869dc538569cc2db1bd95f8690571c951c2873211b1"
 }

package/npm/skills.mjs

@@ -1,104 +1,11 @@
 import fs from 'node:fs';
-import os from 'node:os';
 import path from 'node:path';
-import crypto from 'node:crypto';
-import { metadataPlan } from './metadata.mjs';
-import { stateRoot } from './update.mjs';
-import { root, pkg, fail } from './runtime.mjs';
-
-export const source = path.join(root, 'skills', 'cloud-hug-style-transfer');
-const marker = '.cloud-hug-style-transfer-managed.json';
-const metadata = 'agents/openai.yaml';
-function exists(file) { try { return fs.lstatSync(file); } catch (e) { if (e.code === 'ENOENT') return null; throw e; } }
-export function inventory(dir) {
-  const result = {};
-  function walk(at, prefix = '') {
-    for (const entry of fs.readdirSync(at, { withFileTypes: true })) {
-      if (entry.name === marker) continue;
-      const relative = prefix + entry.name;
-      if (entry.isSymbolicLink()) throw fail('SKILL_UNSAFE_TARGET', 'Skill files must not contain symlinks.');
-      if (entry.isDirectory()) walk(path.join(at, entry.name), relative + '/');
-      else result[relative] = crypto.createHash('sha256').update(fs.readFileSync(path.join(at, entry.name))).digest('hex');
-    }
-  }
-  walk(dir);
-  return result;
-}
-export function resolveTarget(agent='codex', targetRoot) {
-  if (!['codex', 'sealseek', 'workbuddy'].includes(agent)) throw fail('INVALID_AGENT', 'Choose --agent codex, sealseek or workbuddy.');
-  const envName={codex:'CODEX_SKILLS_DIR',sealseek:'SEALSEEK_SKILLS_DIR',workbuddy:'WORKBUDDY_SKILLS_DIR'}[agent];
-  const homeBase=agent==='codex' ? path.join(process.env.CODEX_HOME || path.join(os.homedir(),'.codex'),'skills') : agent==='sealseek' ? path.join(os.homedir(),'.sealseek','workspaces','default','skills') : path.join(os.homedir(),'.workbuddy','skills');
-  const candidates=[targetRoot&&{source:'--root',root:targetRoot},process.env[envName]&&{source:envName,root:process.env[envName]},{source:agent==='codex'&&process.env.CODEX_HOME?'CODEX_HOME':'agent-default',root:homeBase}].filter(Boolean).map(v=>({...v,root:path.resolve(v.root)}));
-  const selected=candidates[0];
-  return {agent,target:path.join(selected.root,'cloud-hug-style-transfer'),root:selected.root,resolvedFrom:selected.source,candidates,warnings:[...new Set(candidates.filter(c=>c.root!==selected.root).map(c=>`${selected.source} takes precedence over ${c.source}.`))]};
-}
+import * as lifecycle from '../lifecycle/engine.mjs';
+import {metadataPlan} from './metadata.mjs';
+export const source=lifecycle.source;
+export const inventory=dir=>lifecycle.inventory(dir,{skip:['.agent-package.json','.runtime','.cloud-hug-style-transfer-managed.json']});
+export const resolveTarget=(agent='generic',targetRoot)=>lifecycle.resolveTarget({agent,root:targetRoot});
 export const targetPath=(agent,targetRoot)=>resolveTarget(agent,targetRoot).target;
-export function skillMetadata(target) {
-  const file=path.join(target,metadata);
-  if(!exists(file))return {valid:false,changed:false,missing:true,warnings:['Skill UI metadata is missing.']};
-  return metadataPlan(fs.readFileSync(file,'utf8'));
-}
-export function status(target) {
-  const st = exists(target);
-  if (!st) return { installed: false, managed: false, current: false, target };
-  if (st.isSymbolicLink() || !st.isDirectory()) return { installed: true, managed: false, current: false, target };
-  let record;
-  try { record = JSON.parse(fs.readFileSync(path.join(target, marker), 'utf8')); } catch { return { installed: true, managed: false, current: false, target }; }
-  if (record.package !== pkg.name || !record.files || typeof record.files !== 'object') return { installed: true, managed: false, current: false, target };
-  if (Object.keys(record.files).some(file => !file || path.isAbsolute(file) || file.includes('\\') || file.split('/').some(part => ['.', '..', ''].includes(part)))) throw fail('SKILL_UNSAFE_TARGET', 'Invalid managed-file path in Skill ownership record.');
-  const files = inventory(target);
-  const edited = Object.entries(record.files).some(([file, hash]) => file !== metadata && files[file] !== hash);
-  const expected = inventory(source);
-  const ui=skillMetadata(target);
-  const current = record.version === pkg.version && ui.valid && !edited && Object.entries(expected).every(([file, hash]) => file === metadata || files[file] === hash);
-  return { installed: true, managed: true, current, edited, target, version: record.version, metadata:{valid:ui.valid,migrationRequired:ui.changed,warnings:ui.warnings}, record };
-}
-export function install(target) {
-  const started=performance.now();
-  let state = status(target);
-  if (state.installed && !state.managed) throw fail('SKILL_UNMANAGED', 'An existing user-owned Skill occupies this target; preserve it and choose a new root or explicitly migrate it.');
-  if (state.edited) throw fail('SKILL_EDITED', 'Managed Skill files contain local edits; preserve and reconcile those edits before updating.');
-  const registry = path.join(stateRoot(), 'skill-targets');
-  fs.mkdirSync(registry, { recursive: true });
-  const registration = path.join(registry, crypto.createHash('sha256').update(target).digest('hex') + '.json');
-  if (!exists(registration)) fs.writeFileSync(registration, JSON.stringify({ target }), { flag: 'wx', mode: 0o600 });
-  const receipt={package:pkg.name,source,owner:'package-managed',verified:true};
-  if (state.current && state.version === pkg.version) return { ...state, record: undefined, ...receipt, ok: true, changed: false, timingsMs:{total:performance.now()-started} };
-  const expected = inventory(source);
-  for (const file of Object.keys(expected)) {
-    if (state.installed && exists(path.join(target, file)) && !(file in state.record.files) && file !== metadata) throw fail('SKILL_UNMANAGED_FILE', 'A new bundled file would overwrite a user-owned file.');
-  }
-  fs.mkdirSync(path.dirname(target), { recursive: true });
-  const lock = target + '.install-lock';
-  let lockfd;
-  try { lockfd = fs.openSync(lock, 'wx', 0o600); } catch (e) { if (e.code === 'EEXIST') throw fail('SKILL_BUSY', 'Another Skill installation holds the lock.'); throw e; }
-  let backup;
-  try {
-    state=status(target);
-    if(state.installed&&!state.managed)throw fail('SKILL_UNMANAGED','Target ownership changed while waiting for the lock.');
-    if(state.edited)throw fail('SKILL_EDITED','Target changed while waiting for the lock.');
-    for(const file of Object.keys(expected))if(state.installed&&exists(path.join(target,file))&&!(file in state.record.files)&&file!==metadata)throw fail('SKILL_UNMANAGED_FILE','Target file ownership changed before the lock.');
-    const ui=state.installed?skillMetadata(target):null;
-    if (state.installed) {
-      backup = path.join(stateRoot(), 'skill-backups', crypto.randomUUID());
-      fs.mkdirSync(path.dirname(backup), { recursive: true });
-      fs.cpSync(target, backup, { recursive: true, errorOnExist: true, force: false });
-    } else fs.mkdirSync(target);
-    // In-place updates support hosts holding a directory handle open. Backup is recoverable.
-    for (const file of Object.keys(expected)) {
-      if (file === metadata && exists(path.join(target, file))) { if(ui.changed)fs.writeFileSync(path.join(target,file),ui.text); continue; }
-      fs.mkdirSync(path.dirname(path.join(target, file)), { recursive: true });
-      fs.copyFileSync(path.join(source, file), path.join(target, file));
-    }
-    for (const file of Object.keys(state.record?.files || {})) {
-      if (file !== metadata && !(file in expected)) fs.unlinkSync(path.join(target, file));
-    }
-    const actual = inventory(target);
-    if (Object.entries(expected).some(([file, hash]) => file !== metadata && actual[file] !== hash)) throw fail('SKILL_VERIFY_FAILED', 'Installed Skill hashes differ from the package.');
-    if(!skillMetadata(target).valid)throw fail('SKILL_VERIFY_FAILED','Skill UI metadata validation failed.');
-    fs.writeFileSync(path.join(target, marker), JSON.stringify({ package: pkg.name, version: pkg.version, files: expected }, null, 2));
-    return { ...receipt, metadata:{valid:true,migrated:ui?.changed||false}, warnings:ui?.warnings||[], timingsMs:{total:performance.now()-started}, ok: true, installed: true, managed: true, current: true, changed: true, target, version: pkg.version, backup: backup || null };
-  } catch (e) {
-    throw Object.assign(fail('SKILL_INSTALL_FAILED', `Skill installation failed; ${backup ? 'restore from ' + backup : 'inspect the partial target at ' + target}.`),{causeCode:e.code,backup:backup||null,target});
-  } finally { fs.closeSync(lockfd); fs.unlinkSync(lock); }
-}
+export const status=target=>lifecycle.status(lifecycle.resolveTarget({path:target}));
+export const install=target=>lifecycle.install(lifecycle.resolveTarget({path:target}));
+export function skillMetadata(target){const p=path.join(target,'agents/openai.yaml');return fs.existsSync(p)?metadataPlan(fs.readFileSync(p,'utf8')):{valid:false,missing:true};}

package/npm/update.mjs

@@ -1,99 +1,6 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import crypto from 'node:crypto';
-import { spawnSync } from 'node:child_process';
-import { packReceipt } from './pack.mjs';
-import { source, resolveTarget, status } from './skills.mjs';
-import { root, pkg, fail } from './runtime.mjs';
-
-export const stateRoot = () => process.env.CLOUD_HUG_STATE_DIR || (process.platform === 'win32' ? path.join(process.env.LOCALAPPDATA || os.homedir(), 'cloud-hug-style-transfer') : path.join(os.homedir(), '.local', 'state', 'cloud-hug-style-transfer'));
-export function newer(a, b) {
-  if (!/^\d+\.\d+\.\d+$/.test(a)) return false;
-  const x=a.split('.').map(Number), y=b.split('.').map(Number);
-  for(let i=0;i<3;i++) { if(x[i]!==y[i]) return x[i]>y[i]; }
-  return false;
-}
-export function globalPrefix(location=root, platform=process.platform) {
-  const modules=path.dirname(path.dirname(location));
-  if(path.basename(modules)!=='node_modules' || fs.existsSync(path.join(location,'.git'))) return null;
-  if(platform==='win32') return path.dirname(modules);
-  return path.basename(path.dirname(modules))==='lib' ? path.dirname(path.dirname(modules)) : null;
-}
-export async function checkUpdate(registry=fetch) {
-  try {
-    const r=await registry(`https://registry.npmjs.org/${encodeURIComponent(pkg.name)}/latest`,{signal:AbortSignal.timeout(8000)});
-    if(!r.ok) throw Error('Registry unavailable');
-    const data=await r.json();
-    if(data.name!==pkg.name || !/^\d+\.\d+\.\d+$/.test(data.version)) throw Error('Invalid stable package');
-    return {ok:true,current:pkg.version,available:data.version,updateAvailable:newer(data.version,pkg.version),tag:'latest'};
-  } catch { return {ok:false,code:'REGISTRY_UNAVAILABLE',current:pkg.version,updateAvailable:false,offline:'keep-current'}; }
-}
-function npm(args) {
-  let cli=process.env.npm_execpath;
-  if(!cli?.endsWith('npm-cli.js')) {
-    const found=spawnSync(process.platform==='win32'?'where':'which',[process.platform==='win32'?'npm.cmd':'npm'],{encoding:'utf8',timeout:10000});
-    const launcher=found.stdout?.trim().split(/\r?\n/)[0];
-    cli=launcher && (process.platform==='win32' ? path.join(path.dirname(launcher),'node_modules','npm','bin','npm-cli.js') : fs.realpathSync(launcher));
-  }
-  if(!cli || !fs.existsSync(cli)) throw fail('NPM_UNAVAILABLE','npm is required for updates.');
-  const r=spawnSync(process.execPath,[cli,...args],{encoding:'utf8',timeout:180000});
-  if(r.status!==0) throw fail('UPDATE_FAILED','npm update failed; check npm connectivity and installation permissions.');
-  return r.stdout;
-}
-export function installUpdate(check, services={}) {
-  if(!check.ok)throw fail(check.code||'REGISTRY_UNAVAILABLE','Registry check failed; installation retained.');
-  const started=performance.now(), prefix=services.prefix || globalPrefix();
-  const state=stateRoot();fs.mkdirSync(state,{recursive:true});
-  const lock=path.join(state,'update.lock');
-  try {fs.mkdirSync(lock);}catch{throw fail('UPDATE_BUSY','Another update is running. Retry after it finishes.');}
-  const run=services.npm||npm, spawn=services.spawn||spawnSync;
-  const entry=path.join(root,'npm','cli.mjs'), targets=[], skills=[];
-  const sync=target=>{
-    const r=spawn(process.execPath,[entry,'skill','update','--agent',target.agent||'codex','--root',path.dirname(target.target),'--json'],{encoding:'utf8',timeout:30000,env:{...process.env,CLOUD_HUG_AUTO_UPDATE:'0'}});
-    let receipt;try{receipt=JSON.parse(r.stdout);}catch{/* malformed receipt is a failure */}
-    if(r.status!==0||!receipt?.ok||!receipt.current||!receipt.verified)throw Object.assign(fail('SKILL_SYNC_FAILED','Managed Skill reconciliation failed.'),{details:{target:target.target,result:receipt||null}});
-    return {...receipt,resolution:target};
-  };
-  let archivePath,mutated=false,version;
-  try {
-    const live=JSON.parse(fs.readFileSync(path.join(root,'package.json'),'utf8'));
-    const packageChanged=newer(check.available,live.version);
-    if(packageChanged&&!prefix)throw fail('UPDATE_OWNER_REQUIRED','This installation is managed by its source checkout or parent package.');
-    if(services.resolution)targets.push(services.resolution);
-    else {
-      const known=[resolveTarget('codex'),resolveTarget('sealseek'),resolveTarget('workbuddy')];
-      const registered=path.join(state,'skill-targets');
-      for(const file of fs.existsSync(registered)?fs.readdirSync(registered):[]) {
-        try{const r=JSON.parse(fs.readFileSync(path.join(registered,file),'utf8'));if(typeof r.target==='string'&&path.isAbsolute(r.target)&&path.basename(r.target)==='cloud-hug-style-transfer')known.push({target:r.target,resolvedFrom:'managed-registration'});}catch{/* invalid registration is ignored */}
-      }
-      for(const r of known)if(!targets.some(t=>t.target===r.target)&&status(r.target).managed)targets.push(r);
-    }
-    // Ownership, local edits and metadata conflicts are checked before replacing the package.
-    for(const t of targets){const s=status(t.target);if(s.installed&&!s.managed)throw fail('SKILL_UNMANAGED','Selected Skill is user-owned.');if(s.edited)throw fail('SKILL_EDITED','Managed Skill contains local edits; reconcile before updating.');}
-    const preflightMs=performance.now()-started;
-    if(packageChanged) {
-      const backup=path.join(state,'package-backups',crypto.randomUUID());fs.mkdirSync(backup,{recursive:true});
-      const archive=packReceipt(run(['pack',root,'--ignore-scripts','--pack-destination',backup,'--json']));
-      if(!archive?.filename||path.basename(archive.filename)!==archive.filename)throw fail('UPDATE_BACKUP_FAILED','Invalid package backup receipt.');
-      archivePath=path.join(backup,archive.filename);
-      if(!fs.statSync(archivePath).size)throw fail('UPDATE_BACKUP_FAILED','Package backup is empty.');
-      mutated=true;
-      run(['install','--global','--prefix',prefix,'--prefer-online','--ignore-scripts','--no-audit','--no-fund',`${pkg.name}@${check.available}`]);
-    }
-    version=JSON.parse(fs.readFileSync(path.join(root,'package.json'),'utf8')).version;
-    if(version!==(packageChanged?check.available:live.version))throw fail('UPDATE_VERIFY_FAILED','Installed package version mismatch.');
-    const packageMs=performance.now()-started-preflightMs;
-    for(const t of targets)skills.push(sync(t));
-    if(skills.some(r=>r.version!==version))throw fail('SKILL_VERIFY_FAILED','Package and Skill versions differ.');
-    return {ok:true,package:pkg.name,source,entry:{node:process.execPath,cli:entry},owner:prefix?'global-npm':'source-or-parent',from:live.version,version,packageChanged,changed:packageChanged||skills.some(r=>r.changed),skills,verified:true,backup:archivePath||null,warnings:targets.length?[]:['No managed Skill target discovered; use an explicit --agent to install one.'],timingsMs:{preflight:preflightMs,package:packageMs,skills:performance.now()-started-preflightMs-packageMs,total:performance.now()-started}};
-  } catch(e) {
-    if(mutated) {
-      try{run(['install','--global','--prefix',prefix,'--ignore-scripts',archivePath]);const restored=JSON.parse(fs.readFileSync(path.join(root,'package.json'),'utf8')).version;if(restored!==pkg.version)throw Error('Rollback version mismatch');}
-      catch{throw Object.assign(fail('ROLLBACK_REQUIRED','Restore the package archive before continuing.'),{backup:archivePath});}
-      for(const t of targets)try{sync(t);}catch{throw Object.assign(fail('ROLLBACK_SYNC_REQUIRED','Package restored; restore affected Skill backups or reconcile local edits.'),{backup:archivePath,details:{skills,cause:e.details||e.message}});}
-    }
-    if(archivePath)e.backup=archivePath;
-    throw e;
-  } finally {fs.rmdirSync(lock);}
-}
+import * as lifecycle from '../lifecycle/engine.mjs';
+export const stateRoot=()=>process.env.CLOUD_HUG_STATE_DIR||lifecycle.root;
+export const globalPrefix=()=>null;
+export const newer=lifecycle.newer;
+export const checkUpdate=()=>Promise.resolve(lifecycle.checkUpdate());
+export const installUpdate=(check,services={})=>{if(!services.resolution)throw lifecycle.fail('TARGET_PATH_REQUIRED','Resolve the selected Skill destination.');return lifecycle.update(services.resolution,{yes:true,version:check.available});};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@petercjl/cloud-hug-style-transfer",
-  "version": "0.4.0",
-  "description": "抱抱云朵社品牌风格转换 Skill，支持 Codex、SealSeek 与 WorkBuddy",
+  "version": "0.5.1",
+  "description": "抱抱云朵社品牌风格转换 Skill，面向具备所需能力的任意 Agent，提供独立安装与更新。",
   "type": "module",
   "bin": {
     "cloud-hug-style-transfer": "npm/cli.mjs"
@@ -11,15 +11,24 @@
     "skills/",
     "capabilities.json",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "lifecycle",
+    "INSTALL.md",
+    "UPDATE.md",
+    "release-integrity.json"
   ],
   "engines": {
     "node": ">=22"
   },
   "scripts": {
-    "test": "node --test test/*.test.mjs",
-    "check": "node --check npm/cli.mjs && node --check npm/skills.mjs && node --check npm/update.mjs && node --check npm/arguments.mjs && node --check npm/metadata.mjs && node --check npm/pack.mjs",
-    "prepack": "npm run check && npm test"
+    "test": "node --test --test-concurrency=2 test/*.test.mjs",
+    "check": "node --check npm/cli.mjs && node --check npm/skills.mjs && node --check npm/update.mjs && node --check npm/arguments.mjs && node --check npm/metadata.mjs && node --check npm/pack.mjs && node --check npm/automatic-update.mjs",
+    "prepack": "node lifecycle/validate-release.mjs && npm run check && npm test",
+    "validate:release": "node lifecycle/validate-release.mjs",
+    "postinstall": "node lifecycle/notice.mjs",
+    "version": "node lifecycle/version.mjs",
+    "verify:packed": "node scripts/verify-packed.mjs",
+    "verify:historical": "node scripts/verify-historical.mjs"
   },
   "publishConfig": {
     "access": "public"
@@ -31,5 +40,12 @@
   "license": "UNLICENSED",
   "dependencies": {
     "yaml": "^2.9.1"
+  },
+  "skillLifecycle": {
+    "skill": "cloud-hug-style-transfer",
+    "entry": "npm/cli.mjs",
+    "env": "CLOUD_HUG",
+    "legacyMarker": ".cloud-hug-style-transfer-managed.json",
+    "contract": 2
   }
 }

package/release-integrity.json

@@ -0,0 +1,100 @@
+{
+  "package": "@petercjl/cloud-hug-style-transfer",
+  "version": "0.5.1",
+  "files": {
+    "package.json": "d5b1f4154ea4707ef49b01c4b7c45707290b0b8601c7a5bf81a2f8aa162ef323",
+    "npm/arguments.mjs": "cc49d94f4f706f21fce0f23d90e33964d999f20dbb5862c20c0fed4640d7e72c",
+    "npm/automatic-update.mjs": "081d68bbc1ff7052a9e8aafc88dc67a1942915210039939338df19528672761c",
+    "npm/business.mjs": "5416ebb725f0a782513e8bcb34bced162187d599d94f8d6f9ca019f7a3f0cd62",
+    "npm/canvas-layout.mjs": "857165f4f02b68b4fd2e48d5e0d954738212818b792499b1a6369e4178d11edf",
+    "npm/cli.mjs": "e7a8907db55c1edaa8160d75f5e3712675b940ba97710f39b15fdc3e611c65f5",
+    "npm/integrity.json": "e31d47750d3ab27db9f68ae465d3aded0cafc798cffc2197ebeef81de029facc",
+    "npm/media-dependency.mjs": "f427dbe1c5d2cb084d1fafd2300f84cf4b3cb6f4516c767cbc9ea321c551a1a9",
+    "npm/metadata.mjs": "fa3a41bc9a81330e7e409aa7b0db29273a87624f616ed3d187277441ffe981ab",
+    "npm/pack.mjs": "b93bc128a23ac539666b9c62e853e0b3256a4739a3fb0f462a7069d3b04eeb90",
+    "npm/runtime.mjs": "2e01cc09e496db5e09e3726af845fac9bdcff7222f0750befc218616f0192913",
+    "npm/skills.mjs": "cd93e26cf286b7e4dfb3256fa710ec4f194343f9d2beae6646a6d657981022d2",
+    "npm/update.mjs": "8449f9ea2639a58b224ec2544e5b608cd64ea495289af8f81f76e9698339299e",
+    "skills/cloud-hug-style-transfer/SKILL.md": "501ce6f6dfe3e892c889e572df2ceb992bc68ba6dbfaab608b5e6558f67072c1",
+    "skills/cloud-hug-style-transfer/adapters/codex.json": "c8f0a3afc937725d561a9713fda9e32be309cb8394f971450b58731568421b62",
+    "skills/cloud-hug-style-transfer/adapters/generic.json": "0f1ec9e7b4a698449500af609644c2ef0737ea4a0eb0ccd56a013935a64df2f3",
+    "skills/cloud-hug-style-transfer/adapters/sealseek.json": "58cc420131ec37e793fe57900880f86cb30027e2f8cc4713b1a0568df4b78ab8",
+    "skills/cloud-hug-style-transfer/adapters/workbuddy.json": "b6f04afd14ccc95539c209f4bd8cf90be09240ff9ac95bcc5b1bd4f5b8b587ef",
+    "skills/cloud-hug-style-transfer/agents/openai.yaml": "d8ebec24c4e3034f4b45aa052b9468ab35790ec7fd93febcfde512c746d2d1d1",
+    "skills/cloud-hug-style-transfer/assets/approved/all-colors-user-finish.webp": "539c77de8ec0dd46a29793befecf813e97ce6ae66f7cbe69486846383b2ae936",
+    "skills/cloud-hug-style-transfer/assets/approved/brand-kv-user-finish-20261012.png": "cb09198481e779444696864b265c689f467207bf7de9610f7adc2b850f0be7b4",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/01.jpg": "ecb481a422b3eadb0050b8c1080a1781e3fbd50ce4479f92e9f4a8beffd91187",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/02.jpg": "676fdc94d3f247f370942f0d1cb1497e59f816b4aba77d551529b22a7a4ca49d",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/03.jpg": "ec5b4f6fb3e86653ff1fff608bce322bc35f8447dfc823038fc3b245570c0461",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/04.jpg": "0750a06d7d4c21077955e1ba991a5477efc33b0370444fc30ce885c93fe17355",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/05.jpg": "75223e46c9ddb288498d64cbc4e8f61e00ed01733b3e5783805aa31d15c2ebd7",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/06.jpg": "410be00a93f5be9e970554b96f950fb5cf6699e3244a2e572233e7e7bfcd8a33",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/07.jpg": "96c2b12650a6cd326631e86f63e522c50afb84162a5d69d39fb3da67223de68a",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/08.jpg": "f20f9a264fc81ae2b7c6e1764b8a3167d434224bed269cd96f826dcd2fd13875",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/09.jpg": "dae56031cc673023ce882f6c9a678d43e31c18e9e7d0ca046248c3ca972cad19",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/10.jpg": "c5ad7bfaf54fb0bd1d74e1833f6c7c1bc42c15f6449fadda0fe8daff2334121a",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/11.jpg": "a0398cca68b2d76907e2c4656c506a4df04c9a38c7f91b160c719bf077ca016a",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/12.jpg": "48e561a28548d4fbd712b1341dd76e3c668d376e13306b65a1ef32ac71ad7705",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/13.jpg": "0ce9293acd81100f47cb9fc4c0064747ca911cae7c6a390da8c8c771d2df5a07",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/14.jpg": "5f2c9dbf350e766c8064a4feaeef430611c02220f10648a099ed34b0b416bdc9",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/15.jpg": "78c623e2c5eadfdd34aaaa7503fa6d975e1f1307016efe832b0fd9d2fd04fb8c",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/16.jpg": "576fe80c894e221acdd7806a7e5892b4ea3922ca62b828ffecd4109c25549137",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/17.jpg": "4cc72bd8cac12be0e8b54659daa3c2f44e8bd8e6953c127ca4adaf669e32e69e",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/18.jpg": "88300f31dd4f1458c1b2fe927570c303a5e80a9c89abbd839d49e5fc808f3930",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/19.jpg": "588a474405e3672e4780252c7c1cc25f558974908628b970026d42575a9d9851",
+    "skills/cloud-hug-style-transfer/assets/approved/detail-final-20261016/sources.json": "38acec5807cfec104ada2cc93a0a1771dae78960cd4402e9550f9aad77e7fd86",
+    "skills/cloud-hug-style-transfer/assets/approved/dog-detail.webp": "e9e73ae4cf35071eea7b1ce161ab7e0a5d7f4a4b8bbeb83be646e1bfec555aa0",
+    "skills/cloud-hug-style-transfer/assets/approved/hippo-detail.webp": "5f3fc742492747166666704adc1744a6859774a95d3d062ee3d17e632f3c7ee5",
+    "skills/cloud-hug-style-transfer/assets/approved/overhead-breathing-user-finish.png": "f65546328c773a5e2837b896237d9b3adcb175c3b6e565b28e7fa2353008dd3f",
+    "skills/cloud-hug-style-transfer/assets/approved/quiet-prone-user-finish.webp": "e01c02a1804a50972eb8ec2438268b89697c4903d3624246d22f1ef8e1698dbf",
+    "skills/cloud-hug-style-transfer/assets/approved/rabbit-detail.webp": "787c296639b0b4922d8aa0668f3d08760ea786f6dad4c3ca20fa5943d2456fe8",
+    "skills/cloud-hug-style-transfer/assets/brand/layout-reference.jpg": "4a100fcb461bb111a671f7051302f9be2f918bca6b3c73eeb2e9ee7f52f5eaba",
+    "skills/cloud-hug-style-transfer/assets/brand/logo-blue.png": "70010f32676c9ed93268efac3dcd5f87b9caf3b57d52932eb2a5d4f7a8a268d9",
+    "skills/cloud-hug-style-transfer/assets/brand/main-kv-dog-rest.webp": "6a237f78ac8cc839a6a7786742bb38921f6dd843313893444d4cfcf8ed257c67",
+    "skills/cloud-hug-style-transfer/assets/brand/main-kv-lounge.webp": "e6f55f9671c2aec17582b742b7ad9575d8e7b39aa8b2d8b6691caf0da86f0405",
+    "skills/cloud-hug-style-transfer/assets/brand/main-kv-seated-hug.webp": "cc7c52883e3732466079b9625110cce09ac7072337587fbb0213f9c31ff7f44b",
+    "skills/cloud-hug-style-transfer/assets/brand/main-kv-sleep.webp": "57425f54c6aa9e9d0e73fa1eb9fc2b64b09ec6f579facbb6d89178c58528953c",
+    "skills/cloud-hug-style-transfer/assets/icon.svg": "49315dda7125ec5fc77ef5f2b96126d8b2121c6e72944b4702972e90f321d3ee",
+    "skills/cloud-hug-style-transfer/assets/model/character-sheet-approved-20261019.png": "55300aa20053612fe132bf0899ba0d3ffd280a197782aeba72fd097df29f51f3",
+    "skills/cloud-hug-style-transfer/assets/products/bear.jpg": "6b182d98bf778f45bd2a498c5e428ac5698a4bfd8425c5ea0c04fbda465456e5",
+    "skills/cloud-hug-style-transfer/assets/products/dog.jpg": "14a513feb9216b04a62e0d78d9b69ca463750ff5e957725512a776de5d7f6d87",
+    "skills/cloud-hug-style-transfer/assets/products/hippo.jpg": "67da5fdaa60274d08cd545ac0c9c891c3cd9761e74dc39c75219b1c676a634af",
+    "skills/cloud-hug-style-transfer/assets/products/rabbit.jpg": "39f250512a465465190e01c25ea3e8c5a8759c12bdd82823d9efbdf11720e332",
+    "skills/cloud-hug-style-transfer/assets/products/six-variants.webp": "a15e1a38bcdcef07c4c00e4978908e8a9054bd91e2c410abea1cbd93b6106763",
+    "skills/cloud-hug-style-transfer/assets/references/kv-layout-source-20261012.webp": "ad98d1b3668080d4cca679eb5a8fd8119d90be38e04b5b1a79f29f33c406af0d",
+    "skills/cloud-hug-style-transfer/assets/references/kv-old-long-20261012.webp": "ba0402fb099bb5561d5351872bb4e63bcee159228016fc28b6c95cfea919608d",
+    "skills/cloud-hug-style-transfer/assets/references/kv-photo-source-20261012.webp": "084d267802a0acf6cd54201215ea2472ffe54f11e37d803a38dbe5e5271771c2",
+    "skills/cloud-hug-style-transfer/assets/references/overhead-cushion-source.webp": "85f7d9636e5c7a4310690027f5dde709cfafbe3abc44804094338faf62bc950d",
+    "skills/cloud-hug-style-transfer/assets/references/prone-pile-source.webp": "4e6537e322fa99e9c23599547bb60c97afc09ef61133c3bb03cd6dab5e8d1588",
+    "skills/cloud-hug-style-transfer/assets/rejected/all-colors-b.webp": "d74a8dc41d9de0f4b024f6ae8b2a02f7fdbb2c9f07d4841c47181002760266aa",
+    "skills/cloud-hug-style-transfer/assets/rejected/brand-kv-a2-20261012.webp": "276ec445939643559708f04c63292ffec384744ea4c7b517d6e1a3abd52397e9",
+    "skills/cloud-hug-style-transfer/assets/rejected/brand-kv-b2-20261012.webp": "80ec90d0b5500d9b661533ad8c59af2c24c89a76f6fc301993462f48a37a7def",
+    "skills/cloud-hug-style-transfer/assets/rejected/brand-kv-c2-20261012.webp": "88ed2de0d950ea4a34519661481877ee0899743a6dfce203a2033c0dab6a73f7",
+    "skills/cloud-hug-style-transfer/assets/rejected/overhead-rest-b.webp": "16e5e6fabdc665868ac244d556f3a8a93db826a34425fdee042e4f7a8ebf64c3",
+    "skills/cloud-hug-style-transfer/assets/rejected/prone-pile-a.webp": "d07f38bbb69fc23b30dca4ed27faa3d7ae58e2e81840a1c3d46101911c28a7a2",
+    "skills/cloud-hug-style-transfer/capabilities.json": "cd1fefac8edde8f00bc62f07d428b552b6a1130c7c67b8a89d5352338a4ee8cb",
+    "skills/cloud-hug-style-transfer/references/assets.md": "98b1a60d70cbc9ceec3e0d11dadbc0dc96344ac6f15cd5289009dfbfd8d71d6e",
+    "skills/cloud-hug-style-transfer/references/brand-layout.md": "74f2674b7c9987e15a9d2ca7bb18498378eecc2d869d37e9ca1e71bd228ee883",
+    "skills/cloud-hug-style-transfer/references/canvas-comparison.md": "df85594c92de3e87daa85ee7cd9cc92df4be9049a5d42c32904542faf329a6c7",
+    "skills/cloud-hug-style-transfer/references/cases.md": "9d0d2d3d210e367411d5a291fc78ef6c9c733afd79c9da76451c580fcbcd4d3e",
+    "skills/cloud-hug-style-transfer/references/detail-final-20261016.md": "d9311413420db743466bbecfe98c31b9753eeead905472d69839afec9578c557",
+    "skills/cloud-hug-style-transfer/references/kv-layout-case-20261012.md": "845b287cfc57912aabedc48e558ca661cf86bf136304ea841030205a806ef06f",
+    "skills/cloud-hug-style-transfer/references/maintenance.md": "f17e3fa7c74d630db5238fd366b7cd3864ba630a4dbd6e243f21e1337d082f80",
+    "skills/cloud-hug-style-transfer/references/model-generation.json": "21daa2c3bf7d2000c7ddf52ab0b980cb7ee95d6c9d345602dc59ecbc128ec147",
+    "skills/cloud-hug-style-transfer/references/model.md": "c4da688e22e2ada3f251fe0dc87effcaf5cb6ed6176f9d9c20a9661414bffab5",
+    "skills/cloud-hug-style-transfer/references/page-patterns.md": "bdd6756e303c95e432d0239be27ec5af1faf75abf71594917f2e11467255a1b4",
+    "skills/cloud-hug-style-transfer/references/photography-method.md": "c0e54598863f3b4a2d87f27d6f18afb75db22ae71ce2aead41f817f35258807e",
+    "skills/cloud-hug-style-transfer/references/products.md": "642795ae16803669b169531240723bf72a388cb6351679a2787e67e181dca9cd",
+    "skills/cloud-hug-style-transfer/references/source-page-three-variants.md": "02a265cf11c3ff3bb7796eb289529ce97f6f64f0350a15a7e3275cec24037720",
+    "skills/cloud-hug-style-transfer/scripts/run.mjs": "0b71e6de4ae7babfce792869dc538569cc2db1bd95f8690571c951c2873211b1",
+    "capabilities.json": "c10b594c9ef708755391b016152475a8d466a9f6094defb252347c8a2ac9817b",
+    "README.md": "4de323933538c1f761a034e93c9f638c3b19680917c1b3d99375033c4ba07bee",
+    "LICENSE": "1bcfea195910091f440b9b09399b5a88a6112a1b0013c3ae5784e2067d986acf",
+    "lifecycle/engine.mjs": "67ee4a2727162930205b2cee172de7df5821a599a84d510ecda253401310a523",
+    "lifecycle/notice.mjs": "2fde2937acb6fa170e1e575b2d65b8a1d7db07794a27ed0abb5571a529132271",
+    "lifecycle/validate-release.mjs": "6c22ff444122d2dbbcf6ae14ea8578d12d74400491b832045e17228599c73b64",
+    "lifecycle/version.mjs": "8f18e243f1af7aa4eef5713054dc187633386076c7d556574ce9727d1c519521",
+    "INSTALL.md": "6b045ff0fc135bb0f1c71760b26c35cbe49d83563f3779d141a86e705159906e",
+    "UPDATE.md": "d9886035f501dcfc0e0b8d0a5a04d361eabfdc4dbd493ffa49add6610f411345"
+  }
+}

package/skills/cloud-hug-style-transfer/SKILL.md

@@ -1,10 +1,22 @@
 ---
 name: cloud-hug-style-transfer
 description: 独立把旧详情页、产品摄影、主KV或SKU转换为抱抱云朵社的品牌视觉与同一模特。保留当次商品、有效文案参数及页面用途，产品款式与材料随新资料变化。内置完整19页定稿、LOGO、人物和摄影排版方法；生图必需 @petercjl/sealseek-media-cli 及其配套 sealseek-media Skill，未检测到即暂停；品牌资料无需私人素材库。用于“抱抱云朵社风格转换”、旧页品牌化、同模特延展与图文设计。
+metadata:
+  package: "@petercjl/cloud-hug-style-transfer"
+  version: 0.5.1
 ---
 
 # 抱抱云朵社风格转换
 
+## Package installation and local execution
+
+The owning npm package is the canonical source. Installation instructions are in its INSTALL.md and UPDATE.md before Skill loading. Resolve the current Agent's supported Skill directory and use explicit `--path` with package-managed install/status/update. Named Agent identities describe conventions, not eligibility or directory defaults.
+
+After managed installation, invoke this Skill's `scripts/run.mjs` with the current Node.js runtime for every owning-package CLI command below. The launcher uses the target-owned `.runtime` and bundled dependencies. Resolve this launcher relative to this Skill's actual directory; do not fall back to a shared global package when the installed runtime is missing. External service dependencies are declared separately and resolve their own canonical Skill through their documented CLI contract.
+
+Maintenance completes CLI/runtime and Skill verification, followed by host-native reload and discovery. CLI receipts leave host discovery pending. Automatic checks notify by default; installation requires separate standing authorization and a compatible stable version. Use update operation/resume for partial or unknown outcomes, preserving the original transaction and backup. Only the selected current Agent is synchronized.
+
+
 使用中文展示名 **抱抱云朵社风格转换**。用本目录内的方法和素材独立完成品牌转换，以当前使用者的明确要求为准；生成能力由必需的 `@petercjl/sealseek-media-cli` 及其规范配套 `sealseek-media` Skill 提供，品牌资料不依赖创建者的历史会话或私人文件权限。
 
 ## 运行合同与平台入口
@@ -17,7 +29,9 @@ description: 独立把旧详情页、产品摄影、主KV或SKU转换为抱抱
 
 ### 入口：必需依赖检查
 
-**每次业务任务先检查依赖，通过后才进入第 1 节；规划任务也遵守此入口。** 执行 `cloud-hug-style-transfer doctor --json`，核对 `dependencies.media.ok`。检查支持当前 npm 安装树、PATH 安装及显式配置的 `CLOUD_HUG_MEDIA_ROOT`；返回的 `dependencies.media.invocation` 是经过包身份核验的 CLI 调用入口，使用宿主当前 Node 运行时，可用于 Agent 管理的运行时或套件组件。
+当前宿主已发现 `sealseek-media` 时，先从该 Skill 的实际目录解析其本地启动入口与规范来源，将其已核验的独立运行包根目录作为 `CLOUD_HUG_MEDIA_ROOT` 传给本应用的诊断与调用。未提供该绑定时，使用依赖检查器声明的发现合同。该绑定只选择当前宿主的依赖安装。
+
+**每次业务任务先检查依赖，通过后才进入第 1 节；规划任务也遵守此入口。** 执行 `cloud-hug-style-transfer doctor --json`；此入口按当前策略自动检测更新，读取 `automaticUpdate`。若其 `reloadSkill` 或 `changed` 为 true，先通过 `skill source --json` 重新加载当前规范 Skill 再继续；CLI 在包替换后会自动以新入口重跑本次检查。核对 `dependencies.media.ok`。检查支持当前 npm 安装树、PATH 安装及显式配置的 `CLOUD_HUG_MEDIA_ROOT`；返回的 `dependencies.media.invocation` 是经过包身份核验的 CLI 调用入口，使用宿主当前 Node 运行时，可用于 Agent 管理的运行时或套件组件。
 
 未检测到 `@petercjl/sealseek-media-cli` 时返回 `DEPENDENCY_MISSING` 并**暂停整个任务**，保留输入和进度，给出最简安装提示词：“请安装 npm 包 @petercjl/sealseek-media-cli。”等待安装并重新检查通过后，从本入口恢复。版本低于 0.6.1、CLI 无法执行、规范 Skill 缺失或合同不兼容同样暂停，按诊断修复后复查。不得以宿主内置生图、其他提供商或继续规划代替依赖通过；本入口不自动安装软件或提交生成。
 

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

@@ -69,5 +69,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."
 }