dsh-hyperframes 0.10.1 → 0.11.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 [返回简介](README.md) · [使用说明](docs/USAGE.md) · [验证记录](docs/VALIDATION.md)
 
+## 0.11.0 (2026-10-29)
+
+- 同步官方 HyperFrames 0.8.214 技能、完整资源与渲染器；修正兼容技能入口和上游来源声明中的旧版本。
+- 工程库新增关键词搜索和最近 / 最早更新、自然标题排序；保留返回列表时的筛选条件，提供无匹配提示和清空搜索。
+- Add project search and updated / oldest / natural-title sorting, retained filters on return, and a clear no-results state.
+- 当前工程与归档工程可分别筛选，按标题、正文或模板查找；保留运行任务与未保存修改保护。
+
+## 0.10.2 (2026-10-29)
+
+- 同步仓库与 npm 的简明介绍、中英文 README 和反馈入口；本次为文档与包元数据更新。
+- Sync npm descriptions and both README guides with the repository, including issue and pull-request links.
+- Correct the introductory engine reference to the already included HyperFrames 0.8.211.
+
 ## 0.10.1 (2026-10-28)
 
 - 同步官方 HyperFrames 0.8.211：7 个当前技能、301 项资源逐一比对发布提交；更新两处上游文档，并固定新的 CLI 与渲染环境版本。

package/README.en.md

@@ -4,20 +4,21 @@
 
 ![dsh-hyperframes whale girl plugin cover](https://raw.githubusercontent.com/STARDUSTLC666/dsh-hyperframes/master/assets/cover-whale-girl.png)
 
-Bring HyperFrames HTML video creation skills into DSH.
+Create HTML videos in DSH with official HyperFrames skills, template projects, asset upload and ordering, archives, official preview and local MP4 export. Use AI-authored projects or start directly from a workbench template.
 
 [![npm](https://img.shields.io/npm/v/dsh-hyperframes)](https://www.npmjs.com/package/dsh-hyperframes) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-hyperframes-downloads.svg)](https://www.npmjs.com/package/dsh-hyperframes)
 
 Feedback and contributions are welcome: report [issues](https://github.com/STARDUSTLC666/dsh-hyperframes/issues) or submit [pull requests](https://github.com/STARDUSTLC666/dsh-hyperframes/pulls).
 
-Open the new native sidebar workbench after updating and restarting DSH. Settings remains available. See the [workbench guide and validation boundaries](docs/WORKBENCH.md).
+Open the workbench from the native DSH sidebar. See the [workbench guide](docs/WORKBENCH.md) for configuration and operating boundaries.
 
-Bundled skills: official HyperFrames 0.8.209, seven current skills with fourteen previous names retained as compatibility entries.
+Bundled skills: official HyperFrames 0.8.214, seven current skills with fourteen previous names retained as compatibility entries.
 
 Move images up or down in the Media tab, including with the keyboard. The order saves immediately; export again to apply it to a new MP4.
 
 ## What it does
 
+- Search projects and sort by update time or natural title; keep filters when returning to the library.
 - A settings workbench for templates, editable content, media uploads, official Studio preview and local MP4 export.
 - Title card, product card and slideshow templates in landscape, portrait or square format.
 - Editable project backups, cancellable jobs and a warning when an MP4 uses an older revision.

package/README.md

@@ -4,20 +4,21 @@
 
 ![dsh-hyperframes 鲸鱼娘插件封面](https://raw.githubusercontent.com/STARDUSTLC666/dsh-hyperframes/master/assets/cover-whale-girl.png)
 
-把 HyperFrames 的 HTML 视频创作技能接入 DSH。
+在 DSH 中用 HTML 创作视频：官方 HyperFrames 技能、模板工程、素材上传与排序、归档、官方预览和本地 MP4 导出。既可让 AI 编写视频工程，也可直接使用工作台模板。
 
 [![npm](https://img.shields.io/npm/v/dsh-hyperframes)](https://www.npmjs.com/package/dsh-hyperframes) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-hyperframes-downloads.svg)](https://www.npmjs.com/package/dsh-hyperframes)
 
 欢迎使用，遇到问题或有改进建议，请提交 [issues](https://github.com/STARDUSTLC666/dsh-hyperframes/issues) 和 [PR](https://github.com/STARDUSTLC666/dsh-hyperframes/pulls)。
 
-更新并重启 DSH 后，可从原生侧栏打开新版工作台，原设置入口继续保留。详见[工作台说明与验收范围](docs/WORKBENCH.md)。
+从 DSH 原生侧栏打开工作台；配置与操作边界见[工作台说明](docs/WORKBENCH.md)。
 
-技能内容：官方 HyperFrames 0.8.209，7 个当前技能；14 个旧名称保留为兼容入口。
+技能内容：官方 HyperFrames 0.8.214，7 个当前技能；14 个旧名称保留为兼容入口。
 
 在「素材」页上移或下移图片即可调整轮播顺序，支持键盘操作。顺序立即保存；重新导出后应用于新 MP4。
 
 ## 功能
 
+- 工程库按关键词搜索，按最近 / 最早更新或标题排序；返回列表时保留筛选条件。
 - 设置页视频工作台：选模板、编辑内容、上传素材，在官方 Studio 预览并导出本机 MP4。
 - 提供标题卡、产品介绍、图文轮播；支持横屏、竖屏和正方形。
 - 保留可编辑工程备份、渲染记录与取消操作；工程修改后提醒重新导出。

package/docs/WORKBENCH.md

@@ -27,3 +27,9 @@ Edit the template sources and run pnpm run build. Commit generated lib/client.js
 邮件使用受控 AgentMail HTTP 服务，日历使用受控 CalDAV 协议传输；插件处理器、存储、校验和原生宿主均实际运行。未使用真实邮箱、真实日历账号或付费模型。RSS 访问 Node.js 官方公开来源。PPT 实际生成并渲染 PPTX、下载 ZIP；两个视频插件实际运行官方引擎并播放 MP4。
 
 这些是 Web 共用界面的验收结果，不代表已验收 Electron 专属菜单、系统权限、真实账号、全部外部来源或所有可选模型/引擎。Docker、Slack、钉钉继续按用户约定搁置。
+
+## 工程查找 / Find projects
+
+工程列表可按关键词筛选，并按最近更新、最早更新或自然标题顺序排列；多个词需要同时匹配。PPT 只查目录中的标题和工程路径；视频查标题、正文和模板，当前列表与归档列表各自保留筛选条件。清空搜索会恢复完整列表，返回工程库会保留刚才的搜索和排序。筛选只在本机列表中执行，不读取未选工程的完整文件，也不修改工程内容。
+
+Search the local project list and sort by newest update, oldest update or natural title. Multiple terms must all match. PPT searches catalog titles and paths; video searches titles, text and templates, with separate active/archive filters. Clear restores the full list; returning from editing preserves filters. Filtering does not load unselected project files or change project contents.

package/lib/client.js

@@ -595,6 +595,44 @@ function createWorkbenchUI(React) {
 window.__ModuleLoader__.load(__stardustUpdatesWrap({ id: 'dsh-hyperframes', factory: require => {
         const React = require('react'), { useState, useEffect, useRef } = React, h = React.createElement;
         const W = createWorkbenchUI(React);
+// Per-view preferences stay in this plugin instance; user files are never changed.
+const projectLibraryPreferences = new Map();
+function ProjectLibrary({ items, scope = 'projects', language = 'zh', searchText, updatedAt, renderItem, t, searchHint }) {
+  const saved = projectLibraryPreferences.get(scope);
+  const [query, setQuery] = React.useState(saved?.query || '');
+  const [order, setOrder] = React.useState(saved?.order || 'updated');
+  const controlId = React.useId();
+  const normalize = text => String(text ?? '').normalize('NFKC').toLocaleLowerCase(language);
+  const words = normalize(query).trim().split(/\s+/).filter(Boolean);
+  const collator = new Intl.Collator(language, { numeric: true, sensitivity: 'base' });
+  const timestamp = row => { const value = Date.parse(updatedAt(row)); return Number.isFinite(value) ? value : 0; };
+  const visible = items.filter(row => words.every(word => normalize(searchText(row)).includes(word))).sort((a, b) => {
+    const tie = collator.compare(String(a.title || ''), String(b.title || '')) || String(a.id).localeCompare(String(b.id));
+    return order === 'title' ? tie : (order === 'oldest' ? timestamp(a) - timestamp(b) : timestamp(b) - timestamp(a)) || tie;
+  });
+  function change(nextQuery, nextOrder) {
+    projectLibraryPreferences.set(scope, { query: nextQuery, order: nextOrder });
+    setQuery(nextQuery); setOrder(nextOrder);
+  }
+  return h('section', { className: 'project-library', 'aria-label': t('工程查找', 'Find projects') },
+    h('style', null, PROJECT_LIBRARY_CSS),
+    h('div', { className: 'project-library-controls' },
+      h('label', { htmlFor: controlId + '-query' }, t('搜索工程', 'Search projects'),
+        h('input', { id: controlId + '-query', type: 'search', value: query, placeholder: searchHint, maxLength: 200,
+          onChange: e => change(e.target.value, order), onKeyDown: e => { if (e.key === 'Escape' && query) { e.preventDefault(); e.stopPropagation(); change('', order); } } })),
+      h('label', { htmlFor: controlId + '-order' }, t('排序', 'Sort by'),
+        h('select', { id: controlId + '-order', value: order, onChange: e => change(query, e.target.value) },
+          h('option', { value: 'updated' }, t('最近更新', 'Recently updated')),
+          h('option', { value: 'oldest' }, t('最早更新', 'Oldest updated')),
+          h('option', { value: 'title' }, t('标题', 'Title')))),
+      query ? h(W.Button, { variant: 'ghost', onClick: () => change('', order) }, t('清空搜索', 'Clear search')) : null),
+    h('p', { className: 'w-muted project-library-count', role: 'status', 'aria-live': 'polite' },
+      t('显示 ', 'Showing ') + visible.length + ' / ' + items.length + t(' 个工程', ' projects')),
+    visible.length ? visible.map(renderItem) : h(W.Empty, { title: t('没有匹配的工程', 'No matching projects'), icon: 'folder' },
+      t('换个关键词，或清空搜索查看全部工程。', 'Try another keyword or clear the search to show all projects.')));
+}
+const PROJECT_LIBRARY_CSS = `.project-library{min-width:0}.project-library-controls{display:flex;gap:12px;align-items:end;flex-wrap:wrap;padding:12px 0}.project-library-controls>label{display:grid;gap:6px;margin:0!important;min-width:0;color:var(--w-muted);font-size:13px}.project-library-controls>label:first-child{flex:1 1 240px}.project-library-controls>label:nth-child(2){flex:0 1 180px}.project-library-controls input,.project-library-controls select{width:100%;min-width:0;min-height:38px;font:inherit;color:var(--w-text);background:var(--w-bg);border:1px solid var(--w-border);border-radius:8px;padding:8px 10px}.project-library-count{margin:4px 0 12px;font-size:12px}.project-library-controls :focus-visible{outline:2px solid var(--w-accent);outline-offset:3px}@media(max-width:520px){.project-library-controls>label:first-child{flex-basis:100%}.project-library-controls>label:nth-child(2){flex:1 1 160px}}`;
+
 function MediaCanvas({ project, fields, render, dirty, stale, job, running, ready, busy, start, perform, setNotice, t }) {
   const previewing = job?.kind === 'preview' && job.state === 'running';
   const ratio = fields.format === 'portrait' ? '9 / 16' : fields.format === 'square' ? '1 / 1' : '16 / 9';
@@ -836,7 +874,7 @@ const canSave=fields.title.trim().length>0 && fields.title.length<=72 && Number.
  !project && !creating ? libraryTab === 'environment' ? h('section',{className:'media-environment'},h('h3',null,t('渲染环境','Render environment')+(environment.ready?t(' · 已准备',' · ready'):t(' · 首次需下载',' · first download required'))),h('p', { className: 'muted' }, t(environment?.hint, 'First use downloads the official CLI. ' + (engine === 'hyperframes' ? 'Windows uses the official rendering browser; other platforms reuse installed Chrome when available. FFmpeg must be in PATH.' : 'Installed Chrome is reused; a browser is downloaded when needed. Remotion retains its official license.'))),
 engine === 'remotion' && h('p', null, h('a', { href: 'https://www.remotion.dev/license', target: '_blank', rel: 'noreferrer' }, t('查看 Remotion 使用许可证', 'Read the Remotion license'))),
 h('button', { disabled: busy || activeJob, onClick: () => start('prepare') }, environment?.ready ? t('重新检查 / 修复环境', 'Check / repair environment') : t('准备渲染环境', 'Prepare render environment'))) : libraryTab === 'archives' ? archived.length ? h('section',{className:'media-project-list'},h('p', { className: 'muted' }, t('归档保留素材与成品，不占当前 30 个工程名额。恢复后可以继续编辑。', 'Archives retain media and output, freeing an active project slot. Restore to edit again.')),
-archived.map(p => h('div', { className: 'bar', key: p.id }, h('strong', null, p.title), h('button', { disabled: busy || dirty || activeJob, onClick: () => perform(async () => { await api({ action: 'restore', id: p.id, revision: p.revision, confirmed: true }); await refresh(); await open(p.id); setNotice(t('工程已恢复。', 'Project restored.')); }) }, t('恢复工程', 'Restore project'))))) : h(W.Empty,{title:t('没有归档工程','No archived projects'),icon:'folder'}) : projects.length ? h('div',{className:'media-project-list'},projects.map(p=>h(W.Row,{key:p.id,title:p.title,disabled:running,meta:p.duration+t(' 秒 · 修订 ',' sec · revision ')+p.revision,description:(templates.find(row=>row.id===p.template)?.[lang==='en'?'en':'zh'] || p.template),onClick:()=>{setEditorTab('content');navigate(p.id);}}))) : h(W.Empty,{title:t('还没有视频工程','No video projects yet'),icon:'video'},t('点击“新建视频”，选择模板并保存。环境可以稍后准备。','Choose New video, select a template and save. The renderer can be prepared later.')) :
+h(ProjectLibrary,{items:archived,scope:'archives',language:lang,t,searchHint:t('搜索归档工程','Search archived projects'),searchText:p=>[p.title,p.body,p.template].join(' '),updatedAt:p=>p.updated,renderItem:p=>h('div', { className: 'bar', key: p.id }, h('strong', null, p.title), h('button', { disabled: busy || dirty || activeJob, onClick: () => perform(async () => { await api({ action: 'restore', id: p.id, revision: p.revision, confirmed: true }); await refresh(); await open(p.id); setNotice(t('工程已恢复。', 'Project restored.')); }) }, t('恢复工程', 'Restore project')))})) : h(W.Empty,{title:t('没有归档工程','No archived projects'),icon:'folder'}) : projects.length ? h('div',{className:'media-project-list'},h(ProjectLibrary,{items:projects,language:lang,t,searchHint:t('搜索标题、正文或模板','Search titles, text or templates'),searchText:p=>[p.title,p.body,p.template,templates.find(row=>row.id===p.template)?.[lang==='en'?'en':'zh']].join(' '),updatedAt:p=>p.updated,renderItem:p=>h(W.Row,{key:p.id,title:p.title,disabled:running,meta:p.duration+t(' 秒 · 修订 ',' sec · revision ')+p.revision,description:(templates.find(row=>row.id===p.template)?.[lang==='en'?'en':'zh'] || p.template),onClick:()=>{setEditorTab('content');navigate(p.id);}})})) : h(W.Empty,{title:t('还没有视频工程','No video projects yet'),icon:'video'},t('点击“新建视频”，选择模板并保存。环境可以稍后准备。','Choose New video, select a template and save. The renderer can be prepared later.')) :
  editorTab === 'environment' ? h('section',{className:'media-environment'},h('h3',null,t('渲染环境','Render environment')+(environment.ready?t(' · 已准备',' · ready'):t(' · 首次需下载',' · first download required'))),h('p', { className: 'muted' }, t(environment?.hint, 'First use downloads the official CLI. ' + (engine === 'hyperframes' ? 'Windows uses the official rendering browser; other platforms reuse installed Chrome when available. FFmpeg must be in PATH.' : 'Installed Chrome is reused; a browser is downloaded when needed. Remotion retains its official license.'))),
 engine === 'remotion' && h('p', null, h('a', { href: 'https://www.remotion.dev/license', target: '_blank', rel: 'noreferrer' }, t('查看 Remotion 使用许可证', 'Read the Remotion license'))),
 h('button', { disabled: busy || activeJob, onClick: () => start('prepare') }, environment?.ready ? t('重新检查 / 修复环境', 'Check / repair environment') : t('准备渲染环境', 'Prepare render environment'))) : editorTab === 'assets' ? h(MediaAssets,{project,dirty,running,fileRef,upload,perform,setProject,t}) : editorTab === 'exports' ? h(MediaExports,{project,dirty,running,activeJob,busy,setArchiveReview,t}) :
@@ -859,7 +897,7 @@ h('div', { className: 'bar' }, h('button', { disabled: busy || dirty || activeJo
         catch { } W.register(ctx,{id:'dsh-'+engine+'.workbench',label:()=>title,icon:engine==='hyperframes'?'layers':'play',component:Workbench,inject:()=>({locale}),order:engine==='hyperframes'?65:66});
 ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'dsh-' + engine, order: engine === 'hyperframes' ? 62 : 63, label: () => title, inject: () => ({ locale }) }, Workbench)); }
         return { inject: ['slots', 'locale'], apply };
-    } },{"name":"dsh-hyperframes","version":"0.1.0","hasWorkbench":true,"packageVersion":"0.10.1","label":"HyperFrames","labelEn":"HyperFrames","suiteComponent":true}));
+    } },{"name":"dsh-hyperframes","version":"0.1.0","hasWorkbench":true,"packageVersion":"0.11.0","label":"HyperFrames","labelEn":"HyperFrames","suiteComponent":true}));
 
 })();
 

package/lib/media-templates.d.ts

@@ -27,7 +27,7 @@ export interface MediaProject extends MediaFields {
     }>;
 }
 export declare const MEDIA_VERSIONS: {
-    readonly hyperframes: "0.8.211";
+    readonly hyperframes: "0.8.214";
     readonly remotion: "4.0.539";
     readonly gsap: "3.15.0";
 };

package/lib/media-templates.js

@@ -1,4 +1,4 @@
-export const MEDIA_VERSIONS = { hyperframes: '0.8.211', remotion: '4.0.539', gsap: '3.15.0' };
+export const MEDIA_VERSIONS = { hyperframes: '0.8.214', remotion: '4.0.539', gsap: '3.15.0' };
 export const MEDIA_TEMPLATES = [
     { id: 'title', zh: '标题卡', en: 'Title card', description: '一句标题、一段介绍，适合开场与通知。' },
     { id: 'product', zh: '产品介绍', en: 'Product card', description: '深色画布与一张主图，适合产品亮点。' },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-hyperframes",
-  "version": "0.10.1",
-  "description": "DSH 视频插件：HyperFrames 技能、模板与素材工作台、官方预览和本地 MP4 导出。",
+  "version": "0.11.0",
+  "description": "DSH HTML 视频工作台：官方 HyperFrames 技能、工程检索、模板、素材排序、预览与本地 MP4 导出。欢迎提交 issues 和 PR。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "hyperframes",
-  "version": "0.8.211",
+  "version": "0.8.214",
   "description": "Official HyperFrames skill release packaged by dsh-hyperframes. DSH manages this bundle; this manifest supplies the pinned upstream CLI version."
 }

package/skills/NOTICE.md

@@ -1,3 +1,3 @@
 # Upstream notice
 
-The seven canonical HyperFrames skill directories are copied from the official hyperframes@0.8.207 release commit (Git 619b8bc4d7fee406246529a8e214e60424807eda). The three skills included in the npm CLI distribution were also compared against its verified tarball. Their Apache-2.0 license is preserved in UPSTREAM-LICENSE.txt. Fourteen retired DSH names are small compatibility adapters maintained by STARDUSTLC666; they load the current official skills instead of carrying obsolete workflow bodies. plugin.json supplies the upstream launcher's exact CLI release. The DSH adapter code remains under the repository MIT license.
+The seven canonical skill directories come from official HyperFrames 0.8.214 (Git 4719543e972548a261b8354f0a8dada479ae5d93). The three npm-distributed skills retain all 290 files from its integrity-verified CLI tarball, including release-generated helpers; source-only resources retain their verified Git blob bytes. The Apache-2.0 license is retained in UPSTREAM-LICENSE.txt. Fourteen legacy DSH names are compatibility adapters; plugin.json pins their CLI release. DSH adapter code remains MIT licensed.

package/skills/UPSTREAM.json

@@ -1,9 +1,9 @@
 {
   "name": "hyperframes",
-  "version": "0.8.211",
-  "gitHead": "5ed694264e9a48aebca0a0f29b94dbd30c2e29d0",
-  "tarball": "https://registry.npmjs.org/hyperframes/-/hyperframes-0.8.211.tgz",
-  "integrity": "sha512-v1ptp7VmmqXJs5s1GgJ87EY9fA3Uue1eebX+Fq1vq6ApffyKJAuZRNRRASh1A6qENG5BejjMrkxQF3uJr5QX+g==",
+  "version": "0.8.214",
+  "gitHead": "4719543e972548a261b8354f0a8dada479ae5d93",
+  "tarball": "https://registry.npmjs.org/hyperframes/-/hyperframes-0.8.214.tgz",
+  "integrity": "sha512-ZPxgxGB5nYzqq67We1XtSdj6QbXIkubp/QxgVQXl3BvfmZnLmYVLyL2gDPixydV51OpZCG8pBTd5yELzEaahIQ==",
   "node": ">=22",
   "canonical": [
     "figma",
@@ -31,7 +31,7 @@
     "talking-head-recut"
   ],
   "repository": "https://github.com/heygen-com/hyperframes",
-  "checkedAt": "2026-10-28",
+  "checkedAt": "2026-10-29",
   "adaptation": "Official canonical files unchanged; DSH compatibility aliases and upstream launcher manifest.",
   "files": {
     "figma/scripts/verify-motion.mjs": "1988721525e929caa5d3ced6d16c31467996e0c57757d281a971fb77e2297de8",
@@ -230,26 +230,111 @@
     "media-use/scripts/dither.mjs": "8e9f437526f39f417f6793912ddeef71094ddb5a5b8d4893c5339086bc39547f",
     "media-use/scripts/dither.test.mjs": "c22c3a0ae41647ac3f733b489a6bc6043fd294155d00954be5d901b3cff7d216",
     "media-use/scripts/eval.mjs": "fadf274111a682acbfdff91eca75b977e3821c53026cd058551c538027f21f51",
+    "media-use/scripts/lib/adopt.mjs": "82f46374e759a79a88830bd059116835cf71b7fc617a8a23a68523925ed0954d",
+    "media-use/scripts/lib/adopt.test.mjs": "ca19fb75d72e8ed9fd29d81071c73b994a42ff2b71cb1ed17f9ddd45f02618f9",
+    "media-use/scripts/lib/bgm-provider.mjs": "37db0d3e8ee052d1341339a75b68a3f98b2aaf2d3689a682149138ffb4aedf95",
+    "media-use/scripts/lib/brand-provider.mjs": "3519d28f8bb2e59eed0c0706a1f57e0782aa94ed6237338b6110474d9ec093a1",
+    "media-use/scripts/lib/bundled-sfx-provider.mjs": "7d84a20ab0c161653bfd62f3b7f7846c862d21d45bcf819364c09c81db3923c9",
+    "media-use/scripts/lib/bundled-sfx-provider.test.mjs": "a64719e9505c42b0373668d6c181c94e697db21fe0ed23bcfff5dec69c146b93",
+    "media-use/scripts/lib/cache.mjs": "fb2ac16826e5e1bdd318b25673b7410fd836c37b4cc6d3f886260b36c147c713",
+    "media-use/scripts/lib/cache.test.mjs": "c6b7bf9b4e68c5f43a38366edbb918838c7a7699b2f953f9cd6e4d11c54bedab",
+    "media-use/scripts/lib/candidates.mjs": "6aa06d00037330fede903ab9bc95ca8edc0fd5d8be2e8b3988d685d474a2682a",
+    "media-use/scripts/lib/candidates.test.mjs": "bc9a0a625ee2d5e404725f2ba3206e78bfab91fe794cac6db30ac69b2de75c3b",
+    "media-use/scripts/lib/codex-provider.mjs": "1d58d7b3ea07253700f52b7ebb3250d21f9afdbeb06e7cc8b6fae0a429bb48b0",
+    "media-use/scripts/lib/codex-provider.test.mjs": "71d26ffc40296f98040101f8e4543b35b2854a66fea2d360950f96dfcd93f61f",
+    "media-use/scripts/lib/config-lock.d.mts": "dbe72fd0c6870868bb5c3a70bd58df1ab784c35a2a3e94dad0135666f1541cac",
     "media-use/scripts/lib/config-lock.mjs": "a9d1679e2039be38cd1756a1011f813ae4be0577c2ff77b9ed411b99b1c94275",
+    "media-use/scripts/lib/config-lock.test.mjs": "7cf8f19db2f8cf999309c08c24d87463ac5ca204aa64dbce5e83b1a008a81a08",
+    "media-use/scripts/lib/coverage.test.mjs": "d6493cdf4889a80ccd0ceabd6dea5efd6703b19910e8d2ed2f6615b89d69c970",
+    "media-use/scripts/lib/cube-build.mjs": "c57b5561641dc97e73474ceb91f33357792028874eaac8012620d094dcfb2a07",
+    "media-use/scripts/lib/cube-build.test.mjs": "d915460484e53263c792e2d67813895f79fa22f07f002cab46c4f663478da939",
+    "media-use/scripts/lib/cube-validate.mjs": "73f169ce4b767d35646bf01f538d756e2af2ff0aa2e0488bde97f7a32ef3bee6",
+    "media-use/scripts/lib/cube-validate.test.mjs": "9b2acbba85879eb8f75d63c6e6f9162cce61bac266441d4e1b2b1117f16b9bb7",
     "media-use/scripts/lib/cutlist.mjs": "c395f49bdb602b29dfc1ea98b7f6d0d5d8781f00eca1c16d009d10e7ef0205be",
+    "media-use/scripts/lib/cutlist.test.mjs": "ef004b3deee1c704f441ec7d1e265da010150842da7a812f7b80e99cf586742c",
     "media-use/scripts/lib/duck.mjs": "0930aea672a8cb204d344902cb90442491a8979f9f554f9c7c61cd13666a6846",
+    "media-use/scripts/lib/duck.test.mjs": "0686a6e00fce56286d69e1e5558947e26dd0fae7a3c67d0439bdb477bbe40eca",
     "media-use/scripts/lib/error-diffusion.mjs": "aa718fe95f98087979bab5ea31d68b8e45fbde0c5b874c6888ad21923fb45936",
+    "media-use/scripts/lib/error-diffusion.test.mjs": "365640f4035bbd1180b3663adca87d8735fad3c0b20b7fe41a562d8cd71154fd",
+    "media-use/scripts/lib/ff-binaries.mjs": "87b8d6a6fdb46563c404a38070ad6075134d281c1aa154d93c2b92054671ca6e",
+    "media-use/scripts/lib/freeze.mjs": "1b9115cbc06059d4488d1ac93f944b5a222a01155792ce6ce2234ad25d6d426c",
+    "media-use/scripts/lib/freeze.test.mjs": "4c5c339c3ec382442148ee55e4cfd89dd4b23720ddb8d9861b3de353f7b8f503",
+    "media-use/scripts/lib/grade-analyzer.mjs": "525278a155d568d9f62c1991d9eef37417ca46863b1535cb99e5be9fffc93216",
+    "media-use/scripts/lib/grade-analyzer.test.mjs": "a47684600e07b719062879e9fac2eac81f625137d539a9459524974eaec4bd27",
+    "media-use/scripts/lib/heygen-cli.mjs": "32b703f5b7fbc3e07834fd1d81903888115bbc934fa90017a201cddfd05953b1",
+    "media-use/scripts/lib/heygen-cli.test.mjs": "947df3c8cb6f49418c9963047564730bff6ba668193951ab446ad346c6a1da49",
+    "media-use/scripts/lib/heygen-search.mjs": "574e75e0479b3edf4ae5c519a437939b244637807c0094b8de7043f2bfbbdc77",
+    "media-use/scripts/lib/heygen-search.test.mjs": "016cb16093b76a0601613899f92788f1bb112b0c0305aef3ff661a961682c660",
+    "media-use/scripts/lib/heygen-video-provider.mjs": "e6a1be96e2ee883e5adaf152bf14c8b0e45a2e627ad229483e088fc9ff701ee1",
+    "media-use/scripts/lib/heygen-video-provider.test.mjs": "01eff63cd508f7cd8826e1fdf594ebbc4dcd8c4fe3fb86afbe0781d81500b4bd",
+    "media-use/scripts/lib/image-provider.mjs": "73ac032e7cf0bd80a08d3b279a16e60de1a6c010d9e197451d56a5fdd6874481",
     "media-use/scripts/lib/index-gen.mjs": "fde84f36ebfb4fa819935956b2b6dc43a70b749a5c846d5470295d7c439e40e6",
+    "media-use/scripts/lib/local-media-search.mjs": "e327cb5c6154bd6e3484f65fab43c5cab0f155fa2a12f9b2f737fe9519414e5e",
+    "media-use/scripts/lib/local-models.mjs": "46a8cb015426b622203236fcdd4e044bfe7c2c556cbd524ac482316e9fc06641",
+    "media-use/scripts/lib/local-models.test.mjs": "1836a274c146cd8b692f081ebc3dfc52348982c8bf12cbf1d2684052253a0c77",
+    "media-use/scripts/lib/local-run.mjs": "a92698954b5685356a5438b943602997fc13ea4b9b8a8ff86f415e842094b642",
+    "media-use/scripts/lib/local-run.test.mjs": "6d6cbb64c654285796dc2047351f23dd2d1b5f9da30b24b784d683622441277f",
+    "media-use/scripts/lib/logo-provider.mjs": "85b6c328425f1f2af96331e5ee5fa84f10d3af30529e1f343256b96a3f4caac5",
+    "media-use/scripts/lib/logo-provider.test.mjs": "7374f9a1b12c4b3788a069365f6b2cf36c4bf36b3b5c374c3f7a59a3a85e8ae6",
+    "media-use/scripts/lib/ltx-video-provider.mjs": "eab9a1ac88795bf066efe46f1f7e5d0dff4b640e458c47beb2a3464781cc00bc",
+    "media-use/scripts/lib/ltx-video-provider.test.mjs": "67250f197c6c8067d6dacedda7f4c48ee2989cd4c0a5d450512284d26a592b94",
+    "media-use/scripts/lib/lut-preset-provider.mjs": "de18e8cc41dd1a72114b12a76d21557f1b3beff1426a837f4892ba89d21069e6",
+    "media-use/scripts/lib/lut-preset-provider.test.mjs": "245424e4afff88285e6d540277b6b85c81690886219c7fb51b961eb05f68c1b2",
+    "media-use/scripts/lib/main-module.mjs": "61811e09110856e1439c29875e4a4ad7701ae45d4045f9d1dcb6a7929698e4c0",
+    "media-use/scripts/lib/manifest.d.mts": "7756d2ba4d1f176e570c33617efac3c4f20f3bcf3d7eb692d35c90c7b97bad1f",
     "media-use/scripts/lib/manifest.mjs": "67f827f7591241c170fd92eb7fa789df2f1756b2cd4889907141936179f5d00f",
+    "media-use/scripts/lib/manifest.test.mjs": "4258c03c63d5b3dc5a77aa0b411e2b38dae7ae61ce9e9d159c3d2d4cda2c59bb",
+    "media-use/scripts/lib/match.mjs": "82c99f95a578b18f40388a50040d734a156d5cfa17d6ae4ebb514ace1489ff6a",
     "media-use/scripts/lib/media-fetch.mjs": "6a90740eee3e4765b83b4c9726676b2935a7fbc9990f61ad5b166f9263188366",
+    "media-use/scripts/lib/media-fetch.test.mjs": "5bf334bd6ed1ce497579e5a1d03da54d51d4d3a652c4fe8c0a8f074de93b1c85",
     "media-use/scripts/lib/media-home.mjs": "7f69890d7b822f202b44ddec0d8176c767cd8b1da4dfc4d918599c6a05cfecb1",
-    "media-use/scripts/lib/npx-sync.mjs": "1dc7f6372da36242f8c373defcba80fe9e006ce824e0f459e6d56226b3bf919a",
+    "media-use/scripts/lib/media-home.test.mjs": "09fae6bb36fe1d8c54b71d04d7c1eb6874e247332e82788bbbfaa240f4cef2d6",
+    "media-use/scripts/lib/media-search.d.mts": "d99c84604a0abd0651a1aca95ebcca07debaa5713a1a5d9fe2868fbd4ed418b8",
+    "media-use/scripts/lib/media-search.mjs": "aeedce36602c58ca2c14e40d5f3568e03ca2e0fe9b2c567e3a0939269a6e5f80",
+    "media-use/scripts/lib/mflux-provider.mjs": "f2d8913f1759b73f9a3b2cd2e68e0d1f52b442c019b4d38eb5dd2941c8c7c78c",
+    "media-use/scripts/lib/mflux-provider.test.mjs": "03d2497445e4416e5442ee3aaa1775c702c767ea5758adcd940b359beedbcb2b",
+    "media-use/scripts/lib/misses.mjs": "1926e9ba06268e801daefaaf2305a41f2d327c719a281748c90a211b7fa64125",
+    "media-use/scripts/lib/misses.test.mjs": "49d002ea295ea338d99712f5a3031c81766f005dcf1e5dfd163eabda59d9654c",
+    "media-use/scripts/lib/npx-sync.mjs": "dc6b79487293be9040ec3c48db8a919e04a23fa09983fa9eb9bf8c7c6b5098bb",
+    "media-use/scripts/lib/npx-sync.test.mjs": "d477daabcf44ef51563aedb2a03f88c0db49a2048e73f45c25882b59e0a4fa0f",
+    "media-use/scripts/lib/openverse.mjs": "e2b176ed6e0b91231debab84ef6633a1a4885e400b9511a39f11e97acef261bd",
+    "media-use/scripts/lib/openverse.test.mjs": "f8a67597d881984182a1347b9441715af8b3d4d895495ae6fcbd4d012dc97f68",
     "media-use/scripts/lib/parakeet-words.mjs": "d5b66efe6cb8975beab2f523503113c3be3117e687ebc20695e7ab08c2ba1b4d",
+    "media-use/scripts/lib/parakeet-words.test.mjs": "f93f215c8b7e02a262f7aafcf9b09cadab2713bb9d15e6953693e2ac9834387b",
+    "media-use/scripts/lib/prefs-store.concurrent.test.mjs": "e23a60d4dd5d3a1975049433e9d68968ca625f220d129258e245a18e31c8a779",
     "media-use/scripts/lib/prefs-store.mjs": "960429595e5c5dda3f88f2899852d2ac2322a7d26b27ed8139612d0161fff749",
+    "media-use/scripts/lib/prefs-store.test.mjs": "455b3f00e85e98e697fc5aaec4bc4cb238ef5f88a6f03f679661b7afbf1df749",
+    "media-use/scripts/lib/probe.mjs": "97981860e0905f9f183a298fbc7208958492ecf6da981c6a0fc9054a2dbb867c",
+    "media-use/scripts/lib/probe.test.mjs": "89d4a1ace860e3be3d7d89f48603b83a246ec261bb370f8c86419daee8f6d173",
+    "media-use/scripts/lib/providers.mjs": "a8d67479d945a02fa3ee45477526c63770f8b74f952a72f0361c5f7e0129645b",
     "media-use/scripts/lib/recipe-store.mjs": "6d2786c2ba4959178351047c3b6d1d2b29a701685c9b256fcc4793c50717ce83",
+    "media-use/scripts/lib/recipe-store.test.mjs": "c87a9adb78dda9ac5361c8d6a13ec7d08b1db3b6849484a0c0aa9ddfa4bcc7d2",
+    "media-use/scripts/lib/registry.mjs": "073f7953f13e707e1d6ddf9e7535a88a04f0121a33b7994771680ba9ee0df9ae",
+    "media-use/scripts/lib/registry.test.mjs": "bd129d21cdc8d0d40db6dcaa32ee1e36ea50709b143edb4649dd6429be5e94da",
+    "media-use/scripts/lib/search.mjs": "e14bee0c2988abc4c471b7e88ecbf8da7b4b476d67ae1b2c34d4b1293fab47c1",
+    "media-use/scripts/lib/search.test.mjs": "93c20b3628f1f04e35b3bdb382cb0d29df19099de82850c6ef7898a1a6090146",
+    "media-use/scripts/lib/sfx-provider.mjs": "dfc621f5e5966c321a88e832b0671e6a1cc13af7e89f3b462b7d70865b3b002d",
+    "media-use/scripts/lib/specs.mjs": "4e394d41d83fdebe827301d1c3652f0f1975eedf4a3107f17a72fb746b27e21c",
+    "media-use/scripts/lib/specs.test.mjs": "97013dbd34102791e2feba5cc4d586f9f0950e542b361ebbdc15e392ed5a294b",
+    "media-use/scripts/lib/stats.mjs": "4134952ab6d24d1793d0c6f32a98d011bcba11a61c7b6ce05df5a33d8fc40c67",
+    "media-use/scripts/lib/stats.test.mjs": "534ca88d9c4ee893b2224488168e6f607ec53ff76bcb75726dd811a72d0bd826",
+    "media-use/scripts/lib/svg-sanitize.mjs": "b1e620d62818978573ba87a6948af1cec1ca5668bc744a4df7225d7c564ccfbb",
     "media-use/scripts/lib/telemetry.mjs": "292ca36e91189e69d36b197311a345664a3a407b4e3fdb91f8044190649961cd",
-    "media-use/scripts/lib/telemetry.test.mjs": "b7f6513eede2eb33f6fde626162b2fd4ef74b0034a3e81b9eebdede89f766373",
+    "media-use/scripts/lib/telemetry.test.mjs": "230b3c1e16871e73ef81a88b5f8c49170223c4056f8cdc6cf5def5578fd2edd8",
+    "media-use/scripts/lib/test-home.test.mjs": "528fc07b1c6df39e3b4504db38199cbf6b93007562beb18f542d426315b01690",
     "media-use/scripts/lib/transcriptCutFade.mjs": "ee9c7ec28650cf0f6a0f1f21f1c6a1faa5e152337163cccc0cc9a109b3c99805",
+    "media-use/scripts/lib/transcriptCutFade.test.mjs": "e4a085de543c8463fa81bf4125e9e3438c7dd4ed9e338498cd959da216db9de7",
+    "media-use/scripts/lib/tts-local-provider.mjs": "7f6144689bc3fc3a79697150ea783e23d04f1339c08188e1e033a050d85ca1ae",
+    "media-use/scripts/lib/tts-local-provider.test.mjs": "66b51a1f5b8fcd4f935541989b76f358ace8f1a0946b52e5ce264b7b0c2a0d9d",
+    "media-use/scripts/lib/usage.mjs": "0731c6709210ea6384ac70087ef61030e7047fd3075bfd53ceb669520121bb63",
+    "media-use/scripts/lib/usage.test.mjs": "b6ed5dafbdd4f4e3775bf7483b2add22275f4906e9be08cc83f1aeceb2bfa9ca",
+    "media-use/scripts/lib/voice-provider.mjs": "1d83560ca6d78d58c3d85e989245c07530b32186c67508fdfbd145722dd10b85",
+    "media-use/scripts/lib/voice-provider.test.mjs": "6f2904cf374066caca014e4a0a12dfb8d87fbd50bcb09c5c26d6337b063ce9da",
     "media-use/scripts/lib/words.mjs": "bfc1f93523d2fc8ce55580b262efcca537c7feabaf029c1c6f33433591377adb",
     "media-use/scripts/prefs.mjs": "f551d5efe51dea7b59d37595c052b950111c6734d913567630181959e7497a04",
     "media-use/scripts/recipe.mjs": "97d2a12604084668599c44f235d6300b77593f86a9a58a6034cf5aa92c98fcba",
     "media-use/scripts/resolve-plugin.test.mjs": "fe8f4dce139b3a88e9ba817da335ae7667a644a715f250613901f7cc1e75f0ed",
-    "media-use/scripts/resolve.mjs": "85aec401d22b65639fa6a91056e515563135962a127516aaae1e2644d48fa0b9",
+    "media-use/scripts/resolve.mjs": "05df5c0d1c97c0e96f2d8a0941370c4f9b78f413f09a6c0e5de04db684d8da1b",
     "media-use/scripts/transcribe.mjs": "9e0f2fd2775e3a76267fc219d4b5aa52373a95478812884f8f40f6292e09dac7",
     "media-use/scripts/transcribe.test.mjs": "39a456ac37a0eca282417b09d7e556c0f2ac11ab3726bc361ff077e75a963ae1",
     "media-use/scripts/transcript-cut.mjs": "17e148571738ad8cf30b0ccb3f28d0837df5072114b9dfb63bc8d9f5d25e5a5d",

package/skills/embedded-captions/SKILL.md

@@ -7,4 +7,4 @@ description: Compatibility entry for the retired embedded-captions skill; routes
 
 The current official HyperFrames release merged this workflow into the `hyperframes` skill. Load `hyperframes` from the DSH skill registry and follow its current instructions for the user's task. Use its bundled resources; do not reconstruct the retired workflow or download standalone skills.
 
-For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins HyperFrames 0.8.207 and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.
+For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins the HyperFrames release from plugin.json and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.

package/skills/faceless-explainer/SKILL.md

@@ -7,4 +7,4 @@ description: Compatibility entry for the retired faceless-explainer skill; route
 
 The current official HyperFrames release merged this workflow into the `hyperframes` skill. Load `hyperframes` from the DSH skill registry and follow its current instructions for the user's task. Use its bundled resources; do not reconstruct the retired workflow or download standalone skills.
 
-For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins HyperFrames 0.8.207 and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.
+For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins the HyperFrames release from plugin.json and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.

package/skills/general-video/SKILL.md

@@ -7,4 +7,4 @@ description: Compatibility entry for the retired general-video skill; routes to
 
 The current official HyperFrames release merged this workflow into the `hyperframes` skill. Load `hyperframes` from the DSH skill registry and follow its current instructions for the user's task. Use its bundled resources; do not reconstruct the retired workflow or download standalone skills.
 
-For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins HyperFrames 0.8.207 and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.
+For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins the HyperFrames release from plugin.json and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.

package/skills/hyperframes-animation/SKILL.md

@@ -7,4 +7,4 @@ description: Compatibility entry for the retired hyperframes-animation skill; ro
 
 The current official HyperFrames release merged this workflow into the `hyperframes` skill. Load `hyperframes` from the DSH skill registry and follow its current instructions for the user's task. Use its bundled resources; do not reconstruct the retired workflow or download standalone skills.
 
-For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins HyperFrames 0.8.207 and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.
+For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins the HyperFrames release from plugin.json and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.

package/skills/hyperframes-audio/SKILL.md

@@ -7,4 +7,4 @@ description: Compatibility entry for the retired hyperframes-audio skill; routes
 
 The current official HyperFrames release merged this workflow into the `media-use` skill. Load `media-use` from the DSH skill registry and follow its current instructions for the user's task. Use its bundled resources; do not reconstruct the retired workflow or download standalone skills.
 
-For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins HyperFrames 0.8.207 and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.
+For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins the HyperFrames release from plugin.json and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.

package/skills/hyperframes-core/SKILL.md

@@ -7,4 +7,4 @@ description: Compatibility entry for the retired hyperframes-core skill; routes
 
 The current official HyperFrames release merged this workflow into the `hyperframes` skill. Load `hyperframes` from the DSH skill registry and follow its current instructions for the user's task. Use its bundled resources; do not reconstruct the retired workflow or download standalone skills.
 
-For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins HyperFrames 0.8.207 and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.
+For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins the HyperFrames release from plugin.json and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.

package/skills/hyperframes-creative/SKILL.md

@@ -7,4 +7,4 @@ description: Compatibility entry for the retired hyperframes-creative skill; rou
 
 The current official HyperFrames release merged this workflow into the `hyperframes` skill. Load `hyperframes` from the DSH skill registry and follow its current instructions for the user's task. Use its bundled resources; do not reconstruct the retired workflow or download standalone skills.
 
-For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins HyperFrames 0.8.207 and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.
+For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins the HyperFrames release from plugin.json and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.

package/skills/hyperframes-keyframes/SKILL.md

@@ -7,4 +7,4 @@ description: Compatibility entry for the retired hyperframes-keyframes skill; ro
 
 The current official HyperFrames release merged this workflow into the `hyperframes` skill. Load `hyperframes` from the DSH skill registry and follow its current instructions for the user's task. Use its bundled resources; do not reconstruct the retired workflow or download standalone skills.
 
-For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins HyperFrames 0.8.207 and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.
+For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins the HyperFrames release from plugin.json and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.

package/skills/hyperframes-studio/SKILL.md

@@ -7,4 +7,4 @@ description: Compatibility entry for the retired hyperframes-studio skill; route
 
 The current official HyperFrames release merged this workflow into the `hyperframes-cli` skill. Load `hyperframes-cli` from the DSH skill registry and follow its current instructions for the user's task. Use its bundled resources; do not reconstruct the retired workflow or download standalone skills.
 
-For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins HyperFrames 0.8.207 and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.
+For an existing project, preserve its files and dependencies. DSH plugin management owns this installed skill bundle. The upstream plugin launcher pins the HyperFrames release from plugin.json and suppresses standalone skill installation; run it in the user's project directory. This entry preserves the previous DSH skill name while using the current workflow.

package/skills/media-use/scripts/lib/adopt.mjs

@@ -0,0 +1,128 @@
+import { readdirSync, statSync, existsSync } from "node:fs";
+import { join, extname, basename } from "node:path";
+import { readManifest, appendRecord, nextId } from "./manifest.mjs";
+import { regenerateIndex } from "./index-gen.mjs";
+import { probe } from "./probe.mjs";
+import { matchTokens } from "./match.mjs";
+
+const AUDIO_EXT = new Set([".mp3", ".wav", ".ogg", ".m4a", ".aac"]);
+const IMAGE_EXT = new Set([".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg", ".ico"]);
+const VIDEO_EXT = new Set([".mp4", ".webm", ".mov"]);
+
+function inferType(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  if (AUDIO_EXT.has(ext)) {
+    const lower = filePath.toLowerCase();
+    if (lower.includes("/bgm/") || lower.includes("/music/") || lower.startsWith("bgm/"))
+      return "bgm";
+    if (lower.includes("/sfx/") || lower.includes("/sound") || lower.startsWith("sfx/"))
+      return "sfx";
+    if (lower.includes("/voice/") || lower.includes("/narrat") || lower.startsWith("voice/"))
+      return "voice";
+    return "bgm";
+  }
+  if (IMAGE_EXT.has(ext)) {
+    if (ext === ".svg" || ext === ".ico") return "icon";
+    return "image";
+  }
+  if (VIDEO_EXT.has(ext)) return "video";
+  return null;
+}
+
+function walkDir(dir, base = "") {
+  const files = [];
+  if (!existsSync(dir)) return files;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const rel = base ? `${base}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      files.push(...walkDir(join(dir, entry.name), rel));
+    } else {
+      files.push(rel);
+    }
+  }
+  return files;
+}
+
+export function scanExistingAssets(projectDir) {
+  const assetsDir = join(projectDir, "assets");
+  if (!existsSync(assetsDir)) return [];
+
+  const files = walkDir(assetsDir);
+  const found = [];
+  for (const rel of files) {
+    const type = inferType(rel);
+    if (!type) continue;
+    const fullPath = join(assetsDir, rel);
+    const stat = statSync(fullPath);
+    if (stat.size === 0) {
+      // A 0-byte asset would register clean but fail at render — skip it loudly
+      // rather than adopt a broken file.
+      console.error(`media-use: skipping 0-byte asset assets/${rel}`);
+      continue;
+    }
+    const meta = probe(fullPath);
+    found.push({
+      relativePath: `assets/${rel}`,
+      type,
+      size: stat.size,
+      name: basename(rel, extname(rel)),
+      ...meta,
+    });
+  }
+  return found;
+}
+
+export function adoptExistingAssets(projectDir) {
+  const existing = scanExistingAssets(projectDir);
+  if (existing.length === 0) return [];
+
+  const manifest = readManifest(projectDir);
+  const knownPaths = new Set(manifest.map((r) => r.path));
+
+  const adopted = [];
+  for (const asset of existing) {
+    if (knownPaths.has(asset.relativePath)) continue;
+
+    const id = nextId(projectDir, asset.type);
+    const record = {
+      id,
+      type: asset.type,
+      path: asset.relativePath,
+      source: "existing",
+      description: asset.name.replace(/[-_]/g, " "),
+      ...(asset.duration != null && { duration: asset.duration }),
+      ...(asset.width != null && { width: asset.width }),
+      ...(asset.height != null && { height: asset.height }),
+      provenance: { provider: "local", adopted: true },
+    };
+    appendRecord(projectDir, record);
+    adopted.push(record);
+  }
+
+  if (adopted.length > 0) regenerateIndex(projectDir);
+  return adopted;
+}
+
+// Adopt a pre-existing assets/ file only when it shares a meaningful word with
+// the intent. The old test — `name.includes(intent) || intent.includes(name)` —
+// silently returned the WRONG file: "whoosh" grabbed a stray who.mp3, and a
+// one-letter filename matched every intent. A false negative just falls through
+// to a catalog search (safe); a false positive ships the wrong asset. So bias to
+// precision: require a shared token, don't guess from substrings.
+export function findExistingAsset(projectDir, intent, type) {
+  const assetsDir = join(projectDir, "assets");
+  if (!existsSync(assetsDir)) return null;
+  const intentTokens = matchTokens(intent);
+  if (intentTokens.size === 0) return null;
+  for (const rel of walkDir(assetsDir)) {
+    const t = inferType(rel);
+    if (!t || (type && t !== type)) continue;
+    const stem = basename(rel, extname(rel));
+    for (const tok of matchTokens(stem)) {
+      if (intentTokens.has(tok)) {
+        return { relativePath: `assets/${rel}`, type: t, name: stem };
+      }
+    }
+  }
+  return null;
+}