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

package/skills/cloud-hug-style-transfer/references/products.md

@@ -1,29 +1,99 @@
-# 产品事实：由当次资料确定
+# 产品识别、设定卡与统一确认
 
-## 先分清商品来源与视觉参考
+## 产品的三个计数
 
-同事上传待转换的旧详情页时，**其中售卖的商品就是本次要保留的商品**。识别其形态、部件、材质、款色、数量、尺寸、使用关系和已有文字，再转换品牌标识、人物与视觉表达。不能因为旧页来自其他品牌，就自动换成内置长条抱枕。
+1. **形态数**：轮廓、造型或关键结构不同的款式。兔与狗是两种形态；同一月亮的紫色和绿色是一种形态。
+2. **款色数／卡片数**：每个形态内的各个已识别配色组合，一组合一张卡。纯光线差异、同品重复照片、场景中同款多只不产生新卡。
+3. **展示模块页数**：07–10 这一组按形态数生成，每种形态一页。其余页按页面映射完成本轮产品表达，不按卡片数机械复制。
 
-只有明确标为“仅借构图／动作／版式”的外部参考，才不承担本次商品事实；本次商品由另外提供的实拍、资料或明确指定的历史同款确定。资料同时存在时，以用户最新更正为先，再核对本次产品实拍、规格资料与源页；冲突影响出图或参数时提出具体问题，不凭品牌案例补答案。
+尺寸不同但形态相同时，先记为规格；若轮廓比例显著不同、是否同组影响出图，在统一确认里明确。场景里的普通靠垫、毯子、家具不算在售商品。
 
-- **事实随商品走。** 保留本次真实的长宽比例、结构、面料纹理、颜色及款色范围；不要默认约 110 × 20 cm、法兰绒、PP 棉、四款六色或某种动物造型。品牌配色用于布景与版式，不能重染商品。
-- **用途随源页走。** 保留有效卖点及其证据关系，例如压陷、靠抱、支撑、可拆洗结构或尺寸对照；不把原本没有的使用方式、材质性能和参数加给新商品。明显不清或互相矛盾的关键文字先核实；不能把视觉转换说成性能认证。
-- **数量随任务走。** “全部款色”按当次清单逐一核对；单品摄影、情绪图或部分集合按本屏目的取舍，不额外加入历史动物凑数。普通靠垫、毯子等承托道具不自动成为在售 SKU。
-- **裁切与清晰度随证明内容走。** 触感近景可以出画，尺度／全貌／款色比较应保留必要轮廓与区别；情绪图可以自然遮挡，但不能借裁切掩盖已知结构错误。需要验证商品细节时传入本次相应实拍，不用品牌成稿替代。
+## 先判断整套详情的商品范围
 
-完整 19 屏成稿的视觉认可范围与选图见 [连续详情页正向案例](detail-final-20261016.md)。其中的材质图、尺寸图和功能文案属于当时商品；整体视觉获认可不代表这些事实可迁移给下一件产品。
+先枚举并实际浏览整套旧图，再放大与商品范围、轮廓、结构、配色及材质判断有关的画面。总览缩略用于理解叙事，清楚原图用于辨认细节。图片无法读取时记录缺口并尝试允许的读取方式；未成功查看不能记为已查看，缺口影响关键判断时再向用户说明。
 
-## 内置历史系列：仅限确认是同款时调用
+识别各页承担的作用：本品首屏、卖点／使用场景、商品特写、款色选择、店铺／系列总览、关联推荐、通用参数或价格说明。**整套图中出现过的商品，不自动等于本次需要升级的商品。** 综合主角、连续展示的使用关系、文字指向、明确的本品款色及用户说明，先得到本轮范围，再统计形态和配色。
 
-以下资料记录此前长条抱枕系列，供本次明确涉及该系列时核对。**不作为新任务的默认产品库。** 先查看当次提供的商品；确认同款后才使用 `assets/products/six-variants.webp` 与对应实拍。新资料更正旧资料时，以新资料为准。
+- 用户明确清单优先；否则首屏与多个独立卖点／场景形成的商品叙事是重要依据，不能被一张商品总览直接覆盖。
+- 店铺总览和关联推荐不自动扩充本轮范围；其中与本轮商品对应的格子仍可提供辅助外观依据。不得仅因某页是宫格就排除其全部内容，也不能把任何款色表都当店铺推荐。
+- 不按出现次数投票。只出现一次但有明确本品款色／规格依据的颜色仍应纳入；同款重复摆放、道具和推荐商品不因此变为本轮款式。
+- 证据充分时直接给出范围结论并准备卡片。真正无法判断某款是否属于本次、且影响卡片数量时，先完成已有分析，再通过原生问答工具问一个必要的范围问题。不要把可自行判断的整套商品清单交给用户重新筛选。
 
-| 款式 | 已知颜色 | 主要结构与面料依据 | 实拍 |
-| --- | --- | --- | --- |
-| 长条兔 | 粉色、奶白 | 俯卧细长圆柱身体，长软垂耳、小黑眼、小浅橙粉鼻、短爪、小圆尾；浅而不规则短绒块面 | `assets/products/rabbit.jpg` |
-| 长条熊 | 浅杏、奶白 | 同款两色，短圆耳、略长且收窄口鼻、深色椭圆鼻、短爪；不能变兔耳或短身坐姿泰迪 | `assets/products/bear.jpg` |
-| 长条河马 | 粉色 | 宽厚前突吻部、小圆耳、小黑眼；独立柔软布下颌、少量白布牙；细短平顺绒面、细短尾，不能球尾 | `assets/products/hippo.jpg` |
-| 长条小狗 | 栗棕色 | 身体绒条沿长轴凸起延伸，垂耳纹理方向依实拍；黑鼻、小黑眼、少量嘴边绣点、短爪、短条尾 | `assets/products/dog.jpg` |
+典型判断：首屏、连续卖点及后续产品展示均围绕白／棕小熊，只有一张混合总览出现兔、河马和狗；在无相反本品清单的情况下，应识别小熊一形态两配色，总览其余商品不自动纳入。这个结论来自全套内容，不能把“只做小熊”或某个页码写成其他任务的默认值。
 
-历史全色清单为粉兔、奶白兔、浅杏熊、奶白熊、粉河马、栗棕狗；只有本次确需这个系列全款全色时才按六种组合核对，不重复某色凑数。两种奶白款以耳朵和脸区分，浅杏熊保留其本色。
+## 建立简短识别记录
 
-该系列实拍中的长条比例、绒面差异和部件是核对依据：兔熊不改成粗大羊羔卷、玫瑰花纹或规整压花；河马不复制兔熊纹理，也不改球尾。总表曾标示兔、熊、河马约 110 cm，狗约 100 cm；“亲肤法兰绒”是该项目已有表述。仅在本次同款任务需要且复核有效资料后使用，摄影案例里的变形或纹理不更新商品事实。
+使用稳定的 `group_id` 和 `variant_id`，例如 `moon`、`moon-green`、`moon-purple`。简短记录：
+
+| 记录 | 用途 |
+| --- | --- |
+| 各页作用、本轮纳入／排除的商品及理由 | 区分主推对象与店铺总览，说明本轮范围如何得到 |
+| 形态名、配色名、来源图片 | 让用户能核对每个判断，避免漏款与重复 |
+| 整体比例、轮廓、部件位置、纹理和标识 | 约束后续卡片与摄影 |
+| 可见依据、合理补全部位、尚有歧义 | 区分直接观察与重建设定 |
+| 卡片路径、版本、用户确认状态 | 后续只传入最终认可版本 |
+| 卖点／使用场景及来源 | 提供 12 页讨论基础，不提前定四格动作 |
+
+不要根据内置历史系列默认四款六色、法兰绒、PP 棉或旧尺寸。实际查看用户图片，不能只按文件名认款。若有明确商品清单或用户更正，以其为先并指出与旧图的冲突。
+
+详细记录放入本轮项目文档，用户界面只给简短结论、必要图片和问答卡。用户纠正 Agent 的误识别时，记录为识别纠正，不把原本错误的范围描述成用户临时缩减需求。
+
+## 为每个款色选择并实际传入多视角依据
+
+从整套旧图选择能够互相补充的清楚画面，按可用资料覆盖：整体长宽与头身比例、头脸／五官、侧背／四肢尾部、面料纹理及本款颜色。**有多个有效视角时，必须选择并实际传入互补参考，不能只用一张总览裁图让模型补出全部角度。** 不硬凑固定数量，不把同一视角的重复图当互补信息，也不无差别传入整套页面。
+
+可以裁取目标商品以减少人物、文字和其他商品干扰，但保留需要判断的整体轮廓、接触结构和有效清晰度；保留原图与裁图对应关系。不能因为某张是无人小图就优先于其他清楚的商品画面，不能把小图放大当作新增细节。原图里虽有人物但可辨的商品部位仍可用，明确人物／场景不迁移。
+
+各来源不一致时，先对照清晰度、遮挡／透视、光线及与其他本品图的吻合程度。对商品外观优先采用清楚且互相支持的本品依据；单张低清总览、风格化示意或泛称材质文字不能覆盖多张清楚的纹理和结构。若仍有影响造型／面料／颜色的实质冲突，通过按钮展示候选解释或参考选择再确认，不能把冲突图片混合成平均外观。
+
+每款色建立有序参考清单，注明各图负责约束什么、哪些内容不迁移。确需借同形态另一配色补结构时，明确只借结构，颜色仍以目标款色依据为准。卡片拼版样例只负责版式。提交时核对实际传入列表与清单一致：**Agent 自己看过图片，不等于生图模型已经收到图片。** 按当前工具参考上限保留有用的互补依据；若资料实际只有一个有效视角，记录这一限制，仍可按下文合理补全，不声称使用了多视角。
+
+## 产品卡样式与生成
+
+卡片样式原图已包含在本包：
+
+- `assets/products/dog.jpg`：横向多图拼版，整体侧面、不同观察方向、头脸与纹理细节。
+- `assets/products/rabbit.jpg`：整体轮廓、背面／尾部、头部和面料近摄。
+
+它们对应本次用户提供的示例表达。只学习拼卡与观察方式；除非当前确为同款，不把示例动物的形态、颜色、鼻眼、长条比例或面料作为当前商品依据。
+
+每张卡只展示一个款色，默认横向 6–7 个互补视图：至少有可识别整体形态的视图，再分配侧背、关键结构和材质近摄。格数按可辨识性适度调整，不为凑格数臆造配件。视图之间保持同一轮廓、比例、结构与颜色，用干净中性浅背景、柔和清楚的光线和细分隔；无需人物、标题、品牌标语、尺寸线或未经确认的数值。
+
+通过当前 SealSeek 的参考图生成能力制作**一张完整拼卡图片**。实际输入上一步选定的有序商品参考，必要时附示例卡并明确其仅负责拼版；无需当前模特卡和整套品牌详情页。提示词保留参考可见的具体外观，不用“圆耳、长圆柱、羊羔绒”等泛化标签替代真实比例、五官形状与纹理。工具支持的比例、参考数量和实际分辨率以实时合同为准。卡片属于前置产品资料，不受每屏 A/B/C 数量规则影响：每款色先一张，不默认出三套卡。
+
+已有用户制作的合格卡片时可直接采用并核对，避免无意义再生。来源提供多种颜色而确认清单只需部分颜色时，按明确范围制作。
+
+## 无实物与生成补全
+
+允许根据旧图生成未展示的角度、遮挡部分及合理结构；不以“没有实物”或“缺少背面照片”自动阻塞。**合理补全只用于资料缺失之处，已有清楚依据的部位应尽量保留。** 保护已知轮廓与部件，采用与现有证据相容的补全，简要标明例如“背部接缝依据可见结构补全，请确认”。无法区分到底几款／几色、或已有图存在未解决的实质矛盾时，通过原生问答工具先问最少的关键问题，避免为猜错款色付费。
+
+卡片旁保留补全说明，不把它写成实拍已验证。用户确认后，该卡是本轮视觉制作认可的产品设定；以后用它约束造型、颜色和材质外观。用户也可自行修图、重画或上传替代卡，沿用同一 `variant_id` 更新版本。保留旧版本，不混用未确认的新卡。
+
+视觉卡片不能自动确立材料成分、具体尺寸、载荷、认证或医疗功效。这里不生成参数页面，16–19 仍由同事处理。
+
+## 生成后先对照原图验收
+
+实际打开生成卡及选定的原始商品依据，检查：
+
+- 整体轮廓与头身比例、头脸／眼鼻／耳朵的位置和形状、前后肢及尾部是否接近可见原图；不只检查“还是一只熊”等类别特征。
+- 本款颜色、绒面颗粒／卷曲的大小和方向、起伏与光泽是否接近；不能把明显的大块卷曲统一改成细密颗粒绒，或把有依据的鼻部质感改成通用玩具造型。
+- 同一卡各视角能否解释为同一件商品；同形态各配色是否保留应当一致的结构。没有依据时，不能一色有后脚、另一色没有；真实存在的结构差异则保留。
+- 每个新角度中哪些部分来自原图、哪些属于补全；卡内能否清楚辨认整体和关键部件。
+
+先排除透视、受力与光线造成的合理差异，再判断外观偏离。图像精美、拼版整齐或生成成功不代表产品接近。发现明显偏差时定位参考选取、传入缺失或提示词原因，在已授权范围内修正对应卡；需要额外付费且未获授权时用问答工具说明问题、范围和费用并等待选择，不无限重生。尚未修正的明显偏差不能标为合格，也不能交给后续详情页继续放大。
+
+保留精简对照结论和补全部位，不承诺无实物条件下完全还原。卡片通过已知外观对照后，再进入用户统一确认；用户可直接修订或上传替代卡。用户确认不替代 Agent 的这次原图对照检查。
+
+若用户明确指定采用与旧图不同的修订外观，记录其主动调整并以确认版本作为新设定；不要把用户指定的改动误判成未修正偏差。
+
+## 卡片出齐后的统一确认（进入规划前）
+
+展示所有卡片，并用一句可核对的结果开头，例如：
+
+> 本次识别为 1 种月亮造型，绿色／紫色 2 个配色；产品卡 2 张，款式展示模块 1 页。
+
+展示必要的补全部位和卖点候选，再调用原生问答工具集中收集确认与更正。例如产品问题选项可为“卡片与数量正确”“需要修改卡片或范围”“我会上传修订卡”；卖点问题按实际候选提供采用／调整的选择，并使用宿主自定义回答能力。不把全部问题写进大表格末尾让用户寻找。用户未回复不算确认；仅认可其中一张不能把其他卡自动标为已确认。确认可以一次覆盖全部事项，不要求用户逐张发送固定句式。
+
+12 页始终规划四个图片位，但不强求四个互不重复的“功效”。根据用户确认的卖点及用途形成四个明确展示任务；卖点较少时可提出同一卖点的不同使用场景供确认，较多时请用户选重点或认可 Agent 的优先建议。不能自行填入原模板四种睡姿或编造功能凑数。
+
+收到完整确认及本轮需求后再开始整套规划。记录用户确认的卡片版本、产品分组、配色、卖点和特殊要求，后续从该状态继续；只重问变化或尚未确认的部分。

package/skills/cloud-hug-style-transfer/references/source-page-three-variants.md

@@ -1,7 +1,3 @@
-# 源页立意优先与同题三案规划（入口）
+# 每屏三案规划（兼容入口）
 
-本主题已合并进 [摄影方法论：柔光生活叙事摄影](photography-method.md)。
-
-同题三案的规则统一以该章为准：共同设计任务的提取、保留项／转换项／变化项的区分、品牌要求的落实方式、每案的完整调度、生成前的核对，以及生成后的单案与多案验收，均见 photography-method.md 的“摄影任务识别”“品牌正例的选择与使用”“工作流程”和“验收与定向修正”各节。
-
-本文件不再维护独立的第二套三案方法。需要三案规则时直接阅读 photography-method.md，避免两处并存产生冲突。
+当前流程按新版模板规划，不再逐张转换旧源页。页面职责与分组见 [页面映射](page-patterns.md)，每屏 A/B/C、生成范围与交付数量见 [规划与清单](planning.md)；摄影调度与同题差异见 [摄影方法](photography-method.md)。

package/skills/cloud-hug-style-transfer/scripts/canvas-row.mjs

@@ -0,0 +1,12 @@
+import fs from 'node:fs';
+import {comparisonRow} from './comparison-layout.mjs';
+
+try {
+  const args = process.argv.slice(2);
+  if (args.length !== 2 || args[0] !== '--input') throw new Error('Usage: node canvas-row.mjs --input ROW.json');
+  const input = JSON.parse(fs.readFileSync(args[1], 'utf8').replace(/^\uFEFF/, ''));
+  console.log(JSON.stringify(comparisonRow(input), null, 2));
+} catch (error) {
+  console.error(JSON.stringify({ok:false, code:error.code || 'INVALID_INPUT', message:error.message}));
+  process.exitCode = 1;
+}

package/skills/cloud-hug-style-transfer/scripts/check-media.mjs

@@ -0,0 +1,10 @@
+import {mediaDependency} from './media-dependency.mjs';
+
+const args = process.argv.slice(2);
+if (args.length && !(args.length === 2 && args[0] === '--package-root' && args[1])) {
+  console.error(JSON.stringify({ok:false, code:'INVALID_ARGUMENTS', message:'Usage: node check-media.mjs [--package-root VERIFIED_PACKAGE_ROOT]'}));
+  process.exit(1);
+}
+const result = mediaDependency({packageRoot: args[1]});
+console.log(JSON.stringify(result, null, 2));
+process.exitCode = result.ok ? 0 : 1;

package/skills/cloud-hug-style-transfer/scripts/comparison-layout.mjs

@@ -0,0 +1,30 @@
+import { fail } from './runtime.mjs';
+
+// Application layout only: service calls, uploads and verified writes belong
+// to sealseek-media-cli. The original fits the result's row without cropping.
+export function comparisonRow(input) {
+ if(!input || typeof input!=='object' || Array.isArray(input)) throw fail('INVALID_INPUT','Expected a comparison row object.');
+ const {run_id,row_index,top=0,source,result}=input;
+ if(typeof run_id!=='string'||!/^[a-zA-Z0-9_-]{1,80}$/.test(run_id)) throw fail('INVALID_INPUT','run_id must be a stable 1-80 character ASCII operation key.');
+ if(!Number.isSafeInteger(row_index)||row_index<1||row_index>10000||!Number.isFinite(top)||top<0||top>1e9) throw fail('INVALID_INPUT','Invalid row index or top coordinate.');
+ for(const asset of [source,result]) {
+  if(!asset||![asset.width,asset.height].every(v=>Number.isSafeInteger(v)&&v>0)) throw fail('INVALID_INPUT','Both assets need measured positive integer dimensions.');
+  let url;try{url=new URL(asset.url);}catch{throw fail('INVALID_INPUT','Both assets need uploaded HTTP(S) URLs.');}
+  if(!['https:','http:'].includes(url.protocol)||url.username||url.password) throw fail('INVALID_INPUT','Asset URLs must use HTTP(S) without embedded credentials.');
+ }
+ const width=480,horizontalGap=24,verticalGap=32;
+ const height=width*result.height/result.width;
+ const scale=Math.min(width/source.width,height/source.height);
+ const sourceWidth=source.width*scale,sourceHeight=source.height*scale;
+ if(![height,sourceWidth,sourceHeight].every(n=>Number.isFinite(n)&&n>0&&n<=100000)||top+height+verticalGap>1e9) throw fail('LAYOUT_UNSUPPORTED','Image geometry exceeds the canvas contract.');
+ const rects=[{x:(width-sourceWidth)/2,y:top,width:sourceWidth,height:sourceHeight},{x:width+horizontalGap,y:top,width,height}];
+ const media=[source,result].map((asset,index)=>({
+  id:`${run_id}-row-${row_index}-${index===0?'source':'result'}`,kind:'image',urls:[asset.url],
+  placement:{mode:'explicit',positions:[rects[index]]}
+ }));
+ if(result.generationParams!==undefined) {
+  if(!result.generationParams||typeof result.generationParams!=='object'||Array.isArray(result.generationParams)) throw fail('INVALID_INPUT','generationParams must be an object accepted by the media CLI.');
+  media[1].generationParams=result.generationParams;
+ }
+ return {ok:true,row_index,top,next_top:top+height+verticalGap,layout:{column_width:width,horizontal_gap:horizontalGap,vertical_gap:verticalGap},batch:{frames:[],media}};
+}

package/skills/cloud-hug-style-transfer/scripts/media-dependency.mjs

@@ -0,0 +1,49 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { spawnSync } from 'node:child_process';
+
+const name = '@petercjl/sealseek-media-cli';
+const prompt = `请安装 npm 包 ${name}。`;
+
+// Invoke the verified package entry with the active Node runtime, including on
+// Windows where an npm .cmd shim is not a directly executable program.
+export function mediaDependency({ env = process.env, packageRoot } = {}) {
+ const missing = (code, message) => ({ok:false,code,package:name,message,installPrompt:prompt,action:'pause'});
+ const roots=[];
+ if(packageRoot || env.CLOUD_HUG_MEDIA_ROOT) roots.push(packageRoot || env.CLOUD_HUG_MEDIA_ROOT);
+ else {
+  try { roots.push(path.dirname(createRequire(import.meta.url).resolve(`${name}/package.json`))); } catch {}
+  for(const dir of (env.PATH || '').split(path.delimiter).filter(Boolean)) {
+   roots.push(path.join(dir,'node_modules',...name.split('/')),path.join(dir,'..','lib','node_modules',...name.split('/')));
+   try {
+    const entry=fs.realpathSync(path.join(dir,'sealseek-media'));
+    roots.push(path.resolve(path.dirname(entry),'..'));
+   } catch {}
+  }
+ }
+ for(const candidate of [...new Set(roots)]) {
+  if(!fs.existsSync(path.join(candidate,'package.json'))) continue;
+  try {
+   const root=fs.realpathSync(candidate),pkg=JSON.parse(fs.readFileSync(path.join(root,'package.json'),'utf8'));
+   if(pkg.name!==name) continue;
+   const parts=pkg.version?.split('.').map(Number);
+   if(!/^\d+\.\d+\.\d+$/.test(pkg.version)||!(parts[0]>0||parts[1]>6||(parts[1]===6&&parts[2]>=1))) return missing('DEPENDENCY_INCOMPATIBLE','sealseek-media-cli >=0.6.1 is required; update the package.');
+   if(typeof pkg.bin?.['sealseek-media']!=='string') return missing('DEPENDENCY_INVALID','Media CLI entry is missing.');
+   const entry=fs.realpathSync(path.resolve(root,pkg.bin['sealseek-media']));
+   if(!entry.startsWith(root+path.sep)) return missing('DEPENDENCY_INVALID','Media CLI entry must belong to its package.');
+   const result=spawnSync(process.execPath,[entry,'skill','source','--json'],{encoding:'utf8',timeout:15000,maxBuffer:1024*1024,env:{...env,SEALSEEK_MEDIA_AUTO_UPDATE:'0'}});
+   const data=JSON.parse(result.stdout||'null');
+   if(result.status!==0||data?.ok!==true||data.name!=='sealseek-media'||data.version!==pkg.version||typeof data.source!=='string') return missing('DEPENDENCY_INVALID','Media CLI canonical Skill discovery failed.');
+   const source=fs.realpathSync(data.source);
+   if(!source.startsWith(root+path.sep)||!/^name: sealseek-media\s*$/m.test(fs.readFileSync(path.join(source,'SKILL.md'),'utf8'))) return missing('DEPENDENCY_INVALID','Media companion Skill identity is invalid.');
+   const contract=JSON.parse(fs.readFileSync(path.join(source,'capabilities.json'),'utf8'));
+   const generate=contract.capabilities?.find(c=>c.id==='media.generate');
+   if(!['image','reference-image','dry-run','task-record','local-artifact'].every(f=>generate?.required_features?.includes(f))) return missing('DEPENDENCY_INCOMPATIBLE','Media generation contract is incomplete.');
+   const canvas=contract.canvas_contract;
+   if(canvas?.version!==1||!['explicit-placement','frame-batch','media-inspect'].every(f=>canvas.features?.includes(f))||!canvas.operations?.create||!canvas.operations?.upload?.some(c=>c.startsWith('image upload '))||!canvas.generation_options?.archive?.enum?.includes('none')) return missing('DEPENDENCY_INCOMPATIBLE','Media canvas creation, upload, inspection and explicit batch placement are required.');
+   return {ok:true,package:name,version:pkg.version,entry,source,invocation:{command:process.execPath,args:[entry]},serviceAccess:'requires-live-preflight',generationTested:false};
+  } catch { return missing('DEPENDENCY_INVALID','Media package, CLI or canonical Skill could not be verified.'); }
+ }
+ return missing('DEPENDENCY_MISSING','Required sealseek-media-cli package was not detected. Pause the Skill until it is installed and verified.');
+}

package/skills/cloud-hug-style-transfer/scripts/plan-inventory.mjs

@@ -0,0 +1,76 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
+
+const directions = ['A', 'B', 'C'];
+const keyPattern = /^[a-z0-9][a-z0-9_-]{0,79}$/;
+const fail = message => { throw new Error(message); };
+
+// Enumerates files only. It neither infers products nor grants generation approval.
+export function planInventory(input) {
+  if (!input || typeof input !== 'object' || Array.isArray(input)) fail('Expected an input object.');
+  const {groups, mode = 'assets', selected_pages} = input;
+  if (!['assets', 'pages'].includes(mode)) fail('mode must be assets or pages.');
+  if (!Array.isArray(groups) || !groups.length) fail('groups must contain at least one confirmed shape group.');
+  const seenGroups = new Set(), seenVariants = new Set();
+  for (const group of groups) {
+    if (!group || typeof group.id !== 'string' || !keyPattern.test(group.id) || seenGroups.has(group.id)) fail('Each group needs a unique ASCII id.');
+    seenGroups.add(group.id);
+    if (!Array.isArray(group.variants) || !group.variants.length) fail('Each group needs at least one variant id.');
+    for (const variant of group.variants) {
+      if (typeof variant !== 'string' || !keyPattern.test(variant) || seenVariants.has(variant)) fail('Variant ids must be unique ASCII keys.');
+      seenVariants.add(variant);
+    }
+  }
+  const single = id => ({page_id:id, template:id, group_id:null, slots:['main']});
+  const pages = [
+    ...['03','04','05','06'].map(single),
+    ...groups.map(group => ({page_id:`07_${group.id}`, template:'07-10', group_id:group.id, slots:['top','bottom-left','bottom-right']})),
+    single('11'),
+    {page_id:'12', template:'12', group_id:null, slots:['top-left','top-right','bottom-left','bottom-right']},
+    ...['13','14','15'].map(single)
+  ];
+  const allowed = new Set(pages.map(page => page.page_id));
+  let requested = allowed;
+  if (selected_pages !== undefined) {
+    if (!Array.isArray(selected_pages) || !selected_pages.length || new Set(selected_pages).size !== selected_pages.length) fail('selected_pages must be a nonempty list of unique page ids.');
+    for (const id of selected_pages) if (!allowed.has(id)) fail(`Unknown or excluded page: ${id}`);
+    requested = new Set(selected_pages);
+  }
+  const selected = pages.filter(page => requested.has(page.page_id));
+  const outputs = [];
+  for (const page of selected) {
+    for (const direction of directions) {
+      for (const slot of mode === 'pages' ? ['page'] : page.slots) {
+        outputs.push({page_id:page.page_id, template:page.template, group_id:page.group_id, direction, slot, file_key:`${page.page_id}_${direction}_${slot}`});
+      }
+    }
+  }
+  return {
+    ok:true,
+    generation_authorized:false,
+    note:'Inventory only; require confirmed products, approved plans and selected generation scope before execution.',
+    mode,
+    shape_groups:groups.length,
+    product_cards:seenVariants.size,
+    all_page_count:pages.length,
+    selected_page_count:selected.length,
+    selected_photo_slots:selected.reduce((sum, page) => sum + page.slots.length, 0),
+    output_count:outputs.length,
+    excluded_templates:['01','02','16','17','18','19'],
+    pages:selected,
+    outputs
+  };
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try {
+    const args = process.argv.slice(2);
+    if (args.length !== 2 || args[0] !== '--input') fail('Usage: node plan-inventory.mjs --input INVENTORY.json');
+    const input = JSON.parse(fs.readFileSync(args[1], 'utf8').replace(/^\uFEFF/, ''));
+    console.log(JSON.stringify(planInventory(input), null, 2));
+  } catch (error) {
+    console.error(JSON.stringify({ok:false, code:'INVALID_INPUT', message:error.message}));
+    process.exitCode = 1;
+  }
+}

package/skills/cloud-hug-style-transfer/scripts/runtime.mjs

@@ -0,0 +1,2 @@
+// The copied layout module only requires this error helper, not an npm runtime.
+export const fail = (code, message) => Object.assign(new Error(message), { code });