@colin4k1024/tsp 2.4.7 → 2.4.8

package/README.md

@@ -80,7 +80,7 @@ TSP 整合了多个社区开源框架的精华能力，而非从零构建：
 
 TSP 当前支持把第三方设计能力作为外部扩展接入使用。设计工具负责高保真 artifact，TSP 负责团队协作、角色分工、handoff、quality gate 与发布收口。
 
-[Open Design](https://github.com/nexu-io/open-design) 是当前已纳入安装面导航的受控可选设计工作台：它提供本地优先 web/daemon、coding-agent CLI 调度、31 个设计 skills、设计系统库、sandbox preview 与 HTML/PDF/PPTX/ZIP/MP4 等导出链路。TSP 侧落点是 [skills/open-design/SKILL.md](skills/open-design/SKILL.md) 与 [docs/runbooks/open-design-integration.md](docs/runbooks/open-design-integration.md)，并通过 `design-prototyping` module 进入 `team` / `full` profile。其中 `full` profile 会自动执行 [scripts/install-open-design.js](scripts/install-open-design.js)，把 Open Design clone/update 到 `~/.tsp/open-design`，并在 `corepack` / `pnpm` 可用时安装依赖。TSP 不 vendoring Open Design 源码、daemon、skills、design-systems 或 SQLite 数据。
+[Open Design](https://github.com/nexu-io/open-design) 是当前已纳入安装面导航的受控可选设计工作台：它提供本地优先 web/daemon、coding-agent CLI 调度、31 个设计 skills、设计系统库、sandbox preview 与 HTML/PDF/PPTX/ZIP/MP4 等导出链路。TSP 侧落点是 [skills/open-design/SKILL.md](skills/open-design/SKILL.md) 与 [docs/runbooks/open-design-integration.md](docs/runbooks/open-design-integration.md)，并通过 `design-prototyping` module 进入 `team` / `full` profile。其中 `full` profile 会自动执行 [scripts/install-open-design.js](scripts/install-open-design.js)，把 Open Design clone/update 到 `~/.tsp/open-design`，并在 `corepack` / `pnpm` 可用时安装依赖；如果 GitHub 网络不可达，该步骤只警告并继续完成 TSP 核心安装。TSP 不 vendoring Open Design 源码、daemon、skills、design-systems 或 SQLite 数据。
 
 [huashu-design](https://github.com/alchaincyf/huashu-design) 仍作为文档级协同能力保留：它偏向高保真设计产出，覆盖 HTML 原生交互原型、浏览器演讲幻灯片、时间轴动画、信息图与 5 维度设计评审。
 

package/manifests/install-modules.json

@@ -344,6 +344,8 @@
         "profiles": [
           "full"
         ],
+        "failureMode": "warn",
+        "failureHint": "Open Design is an optional sidecar. TSP core files are still installed; rerun full install when GitHub access is available to refresh ~/.tsp/open-design.",
         "command": "node",
         "script": "scripts/install-open-design.js",
         "args": []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colin4k1024/tsp",
-  "version": "2.4.7",
+  "version": "2.4.8",
   "description": "Open-source Team Skills Platform for role-based AI delivery workflows, shared skills, hooks, commands, and multi-platform installs.",
   "repository": {
     "type": "git",

package/schemas/install-modules.schema.json

@@ -85,6 +85,58 @@
               "beta",
               "stable"
             ]
+          },
+          "externalInstall": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[a-z0-9-]+$"
+              },
+              "description": {
+                "type": "string",
+                "minLength": 1
+              },
+              "profiles": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "failureMode": {
+                "type": "string",
+                "enum": [
+                  "error",
+                  "warn"
+                ]
+              },
+              "failureHint": {
+                "type": "string"
+              },
+              "command": {
+                "type": "string",
+                "minLength": 1
+              },
+              "script": {
+                "type": "string",
+                "minLength": 1
+              },
+              "args": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "id",
+              "description",
+              "command",
+              "script",
+              "args"
+            ],
+            "additionalProperties": false
           }
         },
         "required": [

package/scripts/install-apply.js

@@ -218,7 +218,8 @@ function printHumanPlan(plan, dryRun, knownRisks = []) {
   if (Array.isArray(plan.externalInstalls) && plan.externalInstalls.length > 0) {
     console.log('\nPlanned external installs:');
     for (const externalInstall of plan.externalInstalls) {
-      console.log(`- ${externalInstall.id}: ${externalInstall.description || externalInstall.script}`);
+      const mode = externalInstall.failureMode === 'warn' ? ' [warn-on-failure]' : '';
+      console.log(`- ${externalInstall.id}${mode}: ${externalInstall.description || externalInstall.script}`);
     }
   }
 

package/scripts/install-plan.js

@@ -156,6 +156,8 @@ function resolvePlanExternalInstalls(plan) {
       args: Array.isArray(externalInstall.args)
         ? externalInstall.args.map(value => String(value))
         : [],
+      failureMode: externalInstall.failureMode === 'warn' ? 'warn' : 'error',
+      failureHint: typeof externalInstall.failureHint === 'string' ? externalInstall.failureHint : '',
       target: plan.target || null,
       profileId: plan.profileId || null,
     }));
@@ -213,7 +215,8 @@ function printPlan(plan) {
     console.log('');
     console.log(`External install plan (${externalInstalls.length}):`);
     for (const externalInstall of externalInstalls) {
-      console.log(`- ${externalInstall.id}: ${externalInstall.description || externalInstall.script}`);
+      const mode = externalInstall.failureMode === 'warn' ? ' [warn-on-failure]' : '';
+      console.log(`- ${externalInstall.id}${mode}: ${externalInstall.description || externalInstall.script}`);
     }
   }
 }

package/scripts/lib/install/apply.js

@@ -219,6 +219,11 @@ function runExternalInstall(externalInstall) {
   });
 
   if (result.status !== 0) {
+    if (externalInstall.failureMode === 'warn') {
+      console.error(`Warning: optional external install failed: ${label}`);
+      console.error(externalInstall.failureHint || 'TSP core install will continue; rerun when the external dependency is reachable.');
+      return;
+    }
     throw new Error(`External install failed: ${label}`);
   }
 }

package/scripts/lib/install-executor.js

@@ -162,6 +162,10 @@ function resolveExternalInstalls(selectedModules, options = {}) {
     const args = Array.isArray(externalInstall.args)
       ? externalInstall.args.map(value => String(value))
       : [];
+    const failureMode = externalInstall.failureMode === 'warn' ? 'warn' : 'error';
+    const failureHint = typeof externalInstall.failureHint === 'string' && externalInstall.failureHint.trim()
+      ? externalInstall.failureHint.trim()
+      : '';
 
     if (!script) {
       throw new Error(`Install module ${module.id} has externalInstall but no script`);
@@ -175,6 +179,8 @@ function resolveExternalInstalls(selectedModules, options = {}) {
       script,
       scriptPath: path.join(sourceRoot, script),
       args,
+      failureMode,
+      failureHint,
       cwd: sourceRoot,
       target,
       profileId,