@petercjl/taobao-ai-ops 0.2.0 → 0.2.1

package/README.md

@@ -59,3 +59,9 @@ taobao-ai-ops tool run tbcli capabilities --json
 Node >=20。Python 研究依赖通过稳定解释器准备；TAOBAO_AI_OPS_PYTHON 可指定已配置解释器。脚本和报告模板来自实际组件目录。原生图片理解由当前 Agent 提供；缺失时报告而非缩减流程。
 
 本地 macOS 确定性安装、更新与恢复测试单独记录；Windows/SealSeek 的真实宿主安装和端到端行为尚待验证。CI 发布前须先有可安装的类目独立包；所有发布通过 GitHub Actions OIDC。
+
+## Audio production
+
+The `seedaudio-tools` node registers the independent `@petercjl/seedaudiocli` package and its canonical `seedaudiocli` Skill. Install with `taobao-ai-ops skill install --agent codex --name seedaudiocli` (or the actual SealSeek target). Discover its source with `taobao-ai-ops skill source --name seedaudiocli --json`, read the complete current Skill and relative resources, then invoke `taobao-ai-ops component run seedaudiocli ...` or `tool run seedaudiocli ...`. Return task IDs and output files to the caller's audio acceptance flow. A missing component requires `components install --agent AGENT --yes`; missing credentials require importing the administrator-provided file through the component CLI.
+
+Before every audio component invocation, the suite checks stable latest, installs a newer component into a separate generation and synchronizes registered managed Skill targets. Configuration and task history remain in user directories. Registry/install failures retain the previous version. Local development checkouts remain Git-managed. `TAOBAO_AI_OPS_AUTO_UPDATE=0` pins the installed set for a specific run. Other components keep their declared update policy. The suite owns installation and invocation; the audio package owns provider integration, validation, authentication, generation and recovery. Prompts and output acceptance belong to the caller.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@petercjl/taobao-ai-ops",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Independent Taobao AI operations SOP skills with a managed suite lifecycle",
   "repository": {
     "type": "git",

package/skills/taobao-ai-operations/SKILL.md

@@ -43,3 +43,9 @@ Missing native image observation stops product visual analysis; an unverified su
 ## QA and maintenance
 
 Confirm the selected node, actual source path, method version, source hashes and full output contract. Keep every Skill's tests independent and exercise suite installation, dependency closure and handoffs separately. Suite targets are implemented, with actual Agent/OS runtime evidence recorded separately. Clean-context regression requires an explicit user request. New business nodes enter the suite registry only with an independent I → S → O, execution and QA contract.
+
+## Audio production
+
+The `seedaudio-tools` node registers the independent `@petercjl/seedaudiocli` package and its canonical `seedaudiocli` Skill. Install with `taobao-ai-ops skill install --agent codex --name seedaudiocli` (or the actual SealSeek target). Discover its source with `taobao-ai-ops skill source --name seedaudiocli --json`, read the complete current Skill and relative resources, then invoke `taobao-ai-ops component run seedaudiocli ...` or `tool run seedaudiocli ...`. Return task IDs and output files to the caller's audio acceptance flow. A missing component requires `components install --agent AGENT --yes`; missing credentials require importing the administrator-provided file through the component CLI.
+
+Before every audio component invocation, the suite checks stable latest, installs a newer component into a separate generation and synchronizes registered managed Skill targets. Configuration and task history remain in user directories. Registry/install failures retain the previous version. Local development checkouts remain Git-managed. `TAOBAO_AI_OPS_AUTO_UPDATE=0` pins the installed set for a specific run. Other components keep their declared update policy. The suite owns installation and invocation; the audio package owns provider integration, validation, authentication, generation and recovery. Prompts and output acceptance belong to the caller.

package/src/cli.mjs

@@ -1,7 +1,7 @@
 import path from 'node:path';
 import {spawnSync} from 'node:child_process';
 import {MANIFEST,PACKAGE,nodeFor,source,nodeVersion,fileHashes,digest,fail,componentRecords,componentRecord} from './core.mjs';
-import {checkComponents,installComponents,registerComponent} from './components.mjs';
+import {checkComponents,installComponents,registerComponent,prepareComponentRun} from './components.mjs';
 import {targetRoot,status,install} from './skill-manager.mjs';
 import {runScript,doctor,toolEntry} from './runtime.mjs';
 import {plan,workflowStatus,createHandoff} from './workflow.mjs';
@@ -14,10 +14,12 @@ export async function main(argv){
  if(['version','--version'].includes(command))return console.log(PACKAGE.version);
  if(command==='script')return runScript(action,rest[0],rest.slice(1));
  if(command==='component'&&action==='run'){
-  const record=componentRecord(rest[0]);const r=spawnSync(process.execPath,[record.entry,...rest.slice(1)],{stdio:'inherit',env:{...process.env,TBCLI_UPDATE_CHECK:'0',SYCMCLI_DISABLE_AUTO_UPDATE:'1'}});if(r.error)throw fail('EXECUTION_FAILED',r.error.message);process.exitCode=r.status??1;return;
+  await prepareComponentRun(rest[0]);
+  const record=componentRecord(rest[0]);const r=spawnSync(process.execPath,[record.entry,...rest.slice(1)],{stdio:'inherit',env:{...process.env,TBCLI_UPDATE_CHECK:'0',SYCMCLI_DISABLE_AUTO_UPDATE:'1',SEEDAUDIO_AUTO_UPDATE:'0'}});if(r.error)throw fail('EXECUTION_FAILED',r.error.message);process.exitCode=r.status??1;return;
  }
  if(command==='tool'&&action==='run'){
-  const entry=toolEntry(rest[0]);const r=spawnSync(entry.command,[...entry.args,...rest.slice(1)],{stdio:'inherit',env:{...process.env,TBCLI_UPDATE_CHECK:'0',SYCMCLI_DISABLE_AUTO_UPDATE:'1'}});if(r.error)throw fail('CAPABILITY_UNAVAILABLE',r.error.message);process.exitCode=r.status??1;return;
+  await prepareComponentRun(MANIFEST.tools[rest[0]]?.component);
+  const entry=toolEntry(rest[0]);const r=spawnSync(entry.command,[...entry.args,...rest.slice(1)],{stdio:'inherit',env:{...process.env,TBCLI_UPDATE_CHECK:'0',SYCMCLI_DISABLE_AUTO_UPDATE:'1',SEEDAUDIO_AUTO_UPDATE:'0'}});if(r.error)throw fail('CAPABILITY_UNAVAILABLE',r.error.message);process.exitCode=r.status??1;return;
  }
  if(command==='nodes'&&action==='list')return print(MANIFEST.nodes);
  if(command==='node'&&action==='show')return print(nodeFor(rest[0]));

package/src/components.mjs

@@ -15,7 +15,7 @@ export async function inspectComponent(id,root){
  if(!p.bin?.[c.bin]||!entry.startsWith(path.resolve(root)+path.sep))throw fail('INVALID_COMPONENT_ENTRY',id);
  const sources={};
  for(const skill of c.skills){
-  const r=spawnSync(process.execPath,[entry,'skill','source','--json'],{encoding:'utf8',timeout:30000,env:{...process.env,TBCLI_UPDATE_CHECK:'0',SYCMCLI_DISABLE_AUTO_UPDATE:'1'}});
+  const r=spawnSync(process.execPath,[entry,'skill','source','--json'],{encoding:'utf8',timeout:30000,env:{...process.env,TBCLI_UPDATE_CHECK:'0',SYCMCLI_DISABLE_AUTO_UPDATE:'1',SEEDAUDIO_AUTO_UPDATE:'0'}});
   if(r.status!==0)throw fail('COMPONENT_SOURCE_FAILED',r.stderr||id);
   const envelope=JSON.parse(r.stdout);
   if(envelope.ok===false)throw fail('COMPONENT_SOURCE_FAILED',id, envelope.error);
@@ -75,3 +75,42 @@ export async function installComponents(opts,services={}){
   }catch(e){await save(old);throw e;}
  });
 }
+
+// Only components declaring this policy update on invocation; other lifecycle stays explicit.
+export async function prepareComponentRun(id,services={}){
+ if(!MANIFEST.components[id]?.automatic_update || process.env.TAOBAO_AI_OPS_AUTO_UPDATE==='0')return;
+ if(componentRecords()[id]?.development)return;
+ return locked(async()=>{
+  const old=componentRecords(),c=MANIFEST.components[id];
+  let latest;
+  try{
+   const r=await (services.registry||fetch)(`https://registry.npmjs.org/${encodeURIComponent(c.package)}/latest`,{signal:AbortSignal.timeout(8000)});
+   if(!r.ok)throw Error('registry');const p=await r.json();
+   if(p.name!==c.package||!/^\d+\.\d+\.\d+$/.test(p.version))throw Error('version');latest=p.version;
+  }catch{if(!old[id])throw fail('COMPONENT_NOT_INSTALLED','Install components while online');console.error('[taobao-ai-ops] Update check unavailable; using installed audio component.');return;}
+  const newer=(a,b)=>{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;};
+  if(old[id]&&!newer(latest,old[id].version))return;
+  const generation=path.join(stateRoot(),'component-generations',randomUUID());await fs.mkdir(generation,{recursive:true});
+  await fs.writeFile(path.join(generation,'previous-components.json'),JSON.stringify(old),{flag:'wx'});
+  const roots=[];
+  for(const name of await fs.readdir(path.join(stateRoot(),'skill-targets')).catch(()=>[])){
+   const info=JSON.parse(await fs.readFile(path.join(stateRoot(),'skill-targets',name),'utf8'));
+   const owner=JSON.parse(await fs.readFile(path.join(info.root,'.taobao-ai-ops-managed.json'),'utf8').catch(()=>'{}'));
+   if(c.skills.some(skill=>owner.skills?.[skill]))roots.push(info.root);
+  }
+  const synced=[];
+  try{
+   await (services.npm||npm)(['install','--prefix',generation,'--no-audit','--no-fund','--ignore-scripts',`${c.package}@${latest}`]);
+   const record=await inspectComponent(id,path.join(generation,'node_modules',...c.package.split('/')));
+   if(record.version!==latest)throw fail('COMPONENT_VERSION_MISMATCH',id);
+   await save({...old,[id]:record});
+   for(const targetDir of roots){await install({targetDir,name:c.skills[0]});synced.push(targetDir);}
+   console.error(`[taobao-ai-ops] ${id} updated to ${latest}.`);
+  }catch(e){
+   await save(old);
+   for(const targetDir of synced)await install({targetDir,name:c.skills[0]});
+   if(!old[id])throw e;
+   console.error(`[taobao-ai-ops] ${e.code||'UPDATE_FAILED'}; using previous audio component.`);
+  }
+ });
+}

package/src/runtime.mjs

@@ -53,6 +53,12 @@ export async function doctor(id,mode='excel'){
   checks.push({id:'procli-runtime',ok:result.status===0&&version===record.version,value:version});
   checks.push({id:'procli-contract',ok:fs.existsSync(path.join(source(n),'capabilities.json'))});
  }
+ if(n.component==='seedaudiocli'){
+  const record=componentRecord(n.component);
+  const result=spawnSync(process.execPath,[record.entry,'doctor','--json'],{encoding:'utf8',timeout:30000,env:{...pythonEnvironment(),SEEDAUDIO_AUTO_UPDATE:'0'}});
+  let detail;try{detail=JSON.parse(result.stdout);}catch{detail={code:'COMPONENT_DOCTOR_FAILED'};}
+  checks.push({id:'seedaudio-runtime-and-config',ok:result.status===0,value:detail});
+ }
  if(n.id==='category-research')checks.push({id:'report-runtime',ok:['assets/report-template.html','assets/chart-views.js'].every(p=>fs.existsSync(path.join(source(n),p)))});
  if(n.id==='product-research'){
   const componentRequire=createRequire(path.join(componentRecord(n.component).root,'package.json'));

package/src/skill-manager.mjs

@@ -1,7 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import os from 'node:os';
-import {randomUUID} from 'node:crypto';
+import {randomUUID,createHash} from 'node:crypto';
 import {PACKAGE,source,nodeVersion,closure,json,stat,fileHashes,digest,fail,stateRoot} from './core.mjs';
 
 const OWNER='.taobao-ai-ops-managed.json';
@@ -79,6 +79,9 @@ export async function install(opts,options={}){
   const ownerPath=path.join(root,OWNER);if(await stat(ownerPath))await fs.copyFile(ownerPath,path.join(transaction,'previous-owner.json'));
   await fs.writeFile(path.join(transaction,'transaction.json'),JSON.stringify({package:PACKAGE.name,root,results},null,2),{flag:'wx'});
   const pending=path.join(root,`${OWNER}.${randomUUID()}.pending`);await fs.writeFile(pending,JSON.stringify(old,null,2),{flag:'wx'});await fs.rename(pending,ownerPath);
+  const registry=path.join(stateRoot(),'skill-targets');await fs.mkdir(registry,{recursive:true});
+  const registration=path.join(registry,createHash('sha256').update(root).digest('hex')+'.json');
+  if(!await stat(registration))await fs.writeFile(registration,JSON.stringify({root}),{flag:'wx'});
   return {ok:true,package:PACKAGE.name,version:PACKAGE.version,targetRoot:root,transaction,skills:results};
  }catch(e){for(const item of changed.reverse()){if(item.backup)await restore(item.backup,item.dest,item.inPlace);else if(await stat(item.dest))await fs.rm(item.dest,{recursive:true,force:true});}throw e;}
  finally{await fs.rmdir(lock);}

package/suite-manifest.json

@@ -9,7 +9,8 @@
       "tbcli-tools",
       "sycmcli-tools",
       "html-report",
-      "project-management"
+      "project-management",
+      "seedaudio-tools"
     ]
   },
   "nodes": [
@@ -20,9 +21,13 @@
       "stage": "shared-reporting",
       "method_version": "commerce-ui-template-pack@1",
       "requires_skills": [],
-      "python_imports": ["jsonschema"],
+      "python_imports": [
+        "jsonschema"
+      ],
       "scripts": [],
-      "native_requirements": ["browser.report.inspect"]
+      "native_requirements": [
+        "browser.report.inspect"
+      ]
     },
     {
       "id": "operations",
@@ -107,7 +112,9 @@
       "python_imports": [],
       "scripts": [],
       "native_requirements": [],
-      "optional_tools": ["dws"]
+      "optional_tools": [
+        "dws"
+      ]
     },
     {
       "id": "tbcli-tools",
@@ -128,6 +135,16 @@
       "python_imports": [],
       "scripts": [],
       "native_requirements": []
+    },
+    {
+      "id": "seedaudio-tools",
+      "skill": "seedaudiocli",
+      "component": "seedaudiocli",
+      "stage": "visual-production-audio",
+      "requires_skills": [],
+      "python_imports": [],
+      "scripts": [],
+      "native_requirements": []
     }
   ],
   "tools": {
@@ -158,6 +175,11 @@
       "minimum_version": "0.5.0",
       "executable_env": "TAOBAO_AI_OPS_YCCLI",
       "role": "authorized Yuce monthly collection; optional for supplied Excel"
+    },
+    "seedaudiocli": {
+      "package": "@petercjl/seedaudiocli",
+      "component": "seedaudiocli",
+      "role": "audio generation, reference voices, image-conditioned audio and task recovery"
     }
   },
   "targets": {
@@ -171,18 +193,25 @@
     "during_run": "installed-component-set",
     "automatic_install": false,
     "offline": "keep-current",
-    "source_checkout": "git-managed"
+    "source_checkout": "git-managed",
+    "automatic_components": [
+      "seedaudiocli"
+    ]
   },
   "components": {
     "procli": {
       "package": "@petercjl/procli",
       "bin": "procli",
-      "skills": ["project-management"]
+      "skills": [
+        "project-management"
+      ]
     },
     "html-report": {
       "package": "@petercjl/commerce-ui",
       "bin": "commerce-ui",
-      "skills": ["compact-commerce-ui"]
+      "skills": [
+        "compact-commerce-ui"
+      ]
     },
     "category-research": {
       "package": "@petercjl/yuce-category-opportunity-report",
@@ -211,6 +240,14 @@
       "skills": [
         "sycmcli"
       ]
+    },
+    "seedaudiocli": {
+      "package": "@petercjl/seedaudiocli",
+      "bin": "seedaudiocli",
+      "skills": [
+        "seedaudiocli"
+      ],
+      "automatic_update": true
     }
   }
 }