@colin4k1024/tsp 2.4.0 → 2.4.2

package/scripts/release-health-summary.js

@@ -115,7 +115,7 @@ function buildDocFreshnessCheck(root) {
     id: 'validate-doc-freshness',
     label: 'validate-doc-freshness',
     command: 'node scripts/validate-doc-freshness.js',
-    status: report.errorCount > 0 ? 'fail' : (report.warningCount > 0 ? 'warn' : 'pass'),
+    status: report.errorCount > 0 ? 'fail' : 'pass',
     details: report.errorCount > 0
       ? report.errors[0]
       : (report.warningCount > 0 ? report.warnings[0] : `checked ${report.markdownFileCount} markdown files`),
@@ -148,20 +148,60 @@ function buildPrebuiltCheck(root) {
   };
 }
 
+function packCurrentTarball(root) {
+  const result = spawnSync('npm', ['pack', '--json', '--ignore-scripts'], {
+    cwd: root,
+    encoding: 'utf8',
+  });
+
+  if (result.status !== 0) {
+    throw new Error(summarizeOutput(result.stderr || result.stdout) || `npm pack failed with exit ${result.status}`);
+  }
+
+  let data;
+  try {
+    data = JSON.parse(result.stdout);
+  } catch (error) {
+    throw new Error(`Unable to parse npm pack JSON output: ${error.message}`);
+  }
+
+  if (!Array.isArray(data) || !data[0] || typeof data[0].filename !== 'string' || data[0].filename.length === 0) {
+    throw new Error('npm pack JSON output is missing a filename entry.');
+  }
+
+  const tarballPath = path.join(root, data[0].filename);
+  return {
+    tarballPath,
+    cleanup() {
+      fs.rmSync(tarballPath, { force: true });
+    },
+  };
+}
+
 function buildTarballCheck(options) {
+  let cleanup = null;
   try {
-    const tarballPath = resolveTarballPath({
-      root: options.root,
-      tarball: options.tarball,
-      packJson: options.packJson,
-    });
+    const usingExplicitInput = Boolean(options.tarball || options.packJson);
+    const tarballPath = usingExplicitInput
+      ? resolveTarballPath({
+        root: options.root,
+        tarball: options.tarball,
+        packJson: options.packJson,
+      })
+      : (() => {
+        const packed = packCurrentTarball(options.root);
+        cleanup = packed.cleanup;
+        return packed.tarballPath;
+      })();
     const result = validateTarball(tarballPath, validatePrebuilt({ root: options.root }).platforms);
     return {
       id: 'validate-packed-tarball',
       label: 'validate-packed-tarball',
       command: options.packJson
         ? `node scripts/validate-packed-tarball.js --pack-json ${path.relative(options.root, options.packJson)}`
-        : `node scripts/validate-packed-tarball.js --tarball ${path.relative(options.root, tarballPath)}`,
+        : options.tarball
+          ? `node scripts/validate-packed-tarball.js --tarball ${path.relative(options.root, tarballPath)}`
+          : `npm pack --json --ignore-scripts && node scripts/validate-packed-tarball.js --tarball ${path.relative(options.root, tarballPath)}`,
       status: result.missing.length > 0 ? 'fail' : 'pass',
       details: result.missing.length > 0
         ? result.missing[0]
@@ -187,6 +227,8 @@ function buildTarballCheck(options) {
       status: 'skip',
       details: message,
     };
+  } finally {
+    cleanup?.();
   }
 }
 

package/scripts/release.sh

@@ -65,7 +65,7 @@ if [[ "$PUBLISH" == "true" ]]; then
   echo "    Size: $(( TARBALL_SIZE / 1024 / 1024 ))MB (${TARBALL_SIZE} bytes)"
 
   echo ""
-  echo "🚀  Publishing @colin4k1024/tsp-create@${NEW_VERSION} to npm ..."
+  echo "🚀  Publishing @colin4k1024/tsp@${NEW_VERSION} to npm ..."
   npm publish "${TARBALL}" --access public
   echo "✅  Published to npm."
 

package/scripts/validate-packed-tarball.js

@@ -59,6 +59,25 @@ function parseArgs(argv) {
   return options;
 }
 
+function expectedTarballFilenameForRoot(root) {
+  const packageJsonPath = path.join(root, 'package.json');
+  if (!fs.existsSync(packageJsonPath)) {
+    return null;
+  }
+
+  try {
+    const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+    if (typeof pkg.name !== 'string' || pkg.name.length === 0 || typeof pkg.version !== 'string' || pkg.version.length === 0) {
+      return null;
+    }
+
+    const normalizedName = pkg.name.replace(/^@/, '').replace(/\//g, '-');
+    return `${normalizedName}-${pkg.version}.tgz`;
+  } catch {
+    return null;
+  }
+}
+
 function resolveTarballPath(options) {
   if (options.tarball) {
     return options.tarball;
@@ -92,6 +111,11 @@ function resolveTarballPath(options) {
     throw new Error(`No .tgz tarball found under ${options.root}; pass --tarball or --pack-json explicitly.`);
   }
 
+  const expectedTarballFilename = expectedTarballFilenameForRoot(options.root);
+  if (expectedTarballFilename && candidates.includes(expectedTarballFilename)) {
+    return path.join(options.root, expectedTarballFilename);
+  }
+
   return path.join(options.root, candidates[0]);
 }
 
@@ -142,6 +166,7 @@ if (require.main === module) {
 }
 
 module.exports = {
+  expectedTarballFilenameForRoot,
   main,
   parseArgs,
   resolveTarballPath,

package/scripts/workflow-help.js

@@ -399,7 +399,7 @@ function analyzeTask(options) {
     result.reason = routeReason(catalog, '/team-intake', '未检测到任务 artifact 目录，主链应从 intake 开始。');
     result.missingPrerequisites.push('缺少 docs/artifacts/{YYYY-MM-DD}-{slug}/ 任务目录');
     if (brownfieldRepo) {
-      result.brownfieldSuggestions.push('既有项目建议先执行 /update-codemaps，再进入 /team-plan 补齐 Brownfield Context Snapshot。');
+      result.brownfieldSuggestions.push('既有项目建议先执行 /update-codemaps；需要轻量结构证据时用 Graphify，需要跨模块影响面或 MCP 证据时用 GitNexus，再进入 /team-plan 补齐 Brownfield Context Snapshot。');
     }
     if (!projectContext.exists || projectContext.missingSections.length > 0) {
       addProjectContextRemediation(result, null);
@@ -443,7 +443,7 @@ function analyzeTask(options) {
     result.reason = routeReason(catalog, '/team-plan', '已有 PRD，但尚未形成 Delivery Plan。');
     result.missingPrerequisites.push('缺少 delivery-plan.md');
     if (brownfieldRepo) {
-      result.brownfieldSuggestions.push('如果是 brownfield 任务，在 delivery-plan.md 中补齐 Brownfield Context Snapshot。');
+      result.brownfieldSuggestions.push('如果是 brownfield 任务，在 delivery-plan.md 中补齐 Brownfield Context Snapshot；必要时引用 Graphify 或 GitNexus 图谱证据。');
     }
     addProjectContextRemediation(result, taskDir);
     return finalizeResult(result, catalog);
@@ -462,7 +462,7 @@ function analyzeTask(options) {
 
   const deliveryPlanText = readText(deliveryPlanPath).toLowerCase();
   if (brownfieldRepo && !deliveryPlanText.includes('brownfield context snapshot')) {
-    result.brownfieldSuggestions.push('建议在 delivery-plan.md 中补齐 Brownfield Context Snapshot。');
+    result.brownfieldSuggestions.push('建议在 delivery-plan.md 中补齐 Brownfield Context Snapshot；必要时引用 Graphify 或 GitNexus 图谱证据。');
   }
 
   if (!hasHandoffEvidence && !exists(executeLogPath)) {

package/skills/gitnexus/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: gitnexus
+description: >
+  将 GitNexus 作为受控可选代码智能能力接入，用于 brownfield MCP 查询、影响面分析、
+  detect_changes、多仓分析和更深代码图谱证据。输出必须回落到 `/team-*` 主链和 artifacts。
+origin: abhigyanpatwari/GitNexus (reference-only controlled integration)
+---
+
+# GitNexus
+
+## 用途
+
+- 对存量仓库做更深代码图谱分析：符号上下游、调用链、执行流、跨仓影响面。
+- 在改动前用 `impact` / `detect_changes` 类证据确认 blast radius。
+- 为 `/team-plan`、`/team-execute`、`/team-review` 提供可追溯的 MCP/图谱证据。
+
+## 触发信号
+
+- brownfield 项目改动跨多个模块、服务或仓库。
+- 需要回答“改这个 symbol/API 会影响谁”“这段流程从哪里进入、流向哪里”。
+- 评审或发布前需要对 git diff 做影响面确认。
+- Graphify 的轻量结构扫描不够，需要 MCP tool、资源或多仓上下文。
+
+## 默认工作流
+
+1. 先跑 `npm run gitnexus:doctor`，确认 Node、npm/npx 与上游包元数据。
+2. 用户自行确认 GitNexus 上游许可证和项目使用场景是否匹配。
+3. 在目标项目根目录显式执行索引命令，并保留 TSP 的 AGENTS/CLAUDE 契约：
+   ```bash
+   npx --yes gitnexus@latest analyze --skip-agents-md
+   ```
+4. 通过 MCP 或 CLI 查询 `query/context/impact/detect_changes` 等结果。
+5. 把关键发现回落到主链：
+   - 规划阶段 -> `/team-plan` 的 Brownfield Context Snapshot 和 readiness 证据
+   - 执行阶段 -> `/team-execute` 的 story slice 影响面说明
+   - 评审阶段 -> `/team-review` 的风险、回归边界和放行建议
+
+## 输出约定
+
+- GitNexus 索引由上游工具管理，通常写入目标仓库 `.gitnexus/` 与用户级 registry。
+- TSP 侧只沉淀结论，不沉淀上游数据库：
+  - 分析目标
+  - 查询入口（MCP tool/resource 或 CLI 命令）
+  - 核心发现
+  - 对 `/team-*` 决策的影响
+  - 后续验证或回退建议
+
+## 边界与禁用项
+
+- 不把 GitNexus 当作 TSP 依赖或默认安装项。
+- 不自动运行 `gitnexus setup`，避免改写用户全局 MCP/editor 配置。
+- 不在 TSP 管理仓库里运行不带 `--skip-agents-md` 的 `gitnexus analyze`。
+- 不复制 GitNexus 源码、hooks、skills 或生成产物到 TSP canonical source。
+- 当前按上游 npm 元数据视为非商业许可证约束；商业使用前需要用户自行确认授权。
+
+## 推荐组合
+
+- 轻量 brownfield 结构扫描：`/team-help -> /update-codemaps -> graphify -> /team-plan`
+- 深影响面分析：`/team-help -> /update-codemaps -> GitNexus impact/detect_changes -> /team-plan`
+- 高风险评审：`/team-execute -> GitNexus detect_changes -> /handoff -> /team-review`

package/skills/gitnexus/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "GitNexus Code Intelligence"
+  short_description: "用 GitNexus 补齐 brownfield MCP 查询与影响面证据"
+  default_prompt: "Use $gitnexus when brownfield work needs MCP-backed code intelligence, impact analysis, detect_changes, or multi-repo graph evidence. Keep GitNexus optional, preserve existing AGENTS/CLAUDE contracts, and feed findings back into /team-plan, /team-execute, or /team-review."

package/skills/open-design/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: open-design
+description: >
+  Use Open Design as an external local-first design workbench for prototypes,
+  decks, mobile screens, dashboards, DESIGN.md systems, and exportable visual
+  artifacts. Keep TSP responsible for team workflow, handoff, and quality gates.
+origin: nexu-io/open-design (reference-only controlled integration)
+---
+
+# Open Design
+
+## 用途
+
+- 用 Open Design 生成或迭代高保真视觉 artifacts：web prototype、dashboard、mobile flow、deck、poster、social carousel、runbook/spec 类页面。
+- 在前端任务中把 `DESIGN.md`、设计方向、skill、preview 和 export 结果作为证据回落到 TSP 主链。
+- 让 `product-manager`、`frontend-engineer`、`qa-engineer` 在同一套可预览 artifact 上讨论，而不是只靠文字描述。
+
+## 触发信号
+
+- 用户要“像 Claude Design 那样”快速生成可编辑原型、deck、营销页、移动界面或设计系统。
+- 需求还没有稳定视觉方向，需要先通过表单、方向 picker 或 `DESIGN.md` 锁定风格。
+- `/team-plan` 或 `/team-execute` 进入 UI 实施前，需要可截图、可导出、可评审的设计证据。
+- `/team-review` 需要对 artifact 做视觉、响应式、可访问性、反 AI 味、导出完整性检查。
+
+## 默认工作流
+
+1. 先完成 TSP 侧任务收敛：
+   - 目标、受众、页面/屏幕范围、数据真实性、品牌约束、响应式范围、A11y/性能门禁。
+   - 若任务来自 `/team-*`，把这些约束写入 artifact 或 handoff，不只留在聊天里。
+2. 检查目标项目是否已有 `DESIGN.md`：
+   - 有：把它作为 Open Design 的 active design system 或直接放入 OD 项目工作目录。
+   - 无：先用 `frontend-ui-ux-system` 或 OD 的 design-system 能力生成候选 `DESIGN.md`。
+3. 若用户安装的是 TSP `full` profile，Open Design 默认会由 TSP 安装器准备到 `~/.tsp/open-design`；否则在独立 Open Design checkout 中运行上游工具，不在 TSP 仓库里启动 OD daemon：
+   ```bash
+   # full profile 自动路径
+   cd ~/.tsp/open-design
+
+   # 手动路径
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design
+   corepack enable
+   pnpm install
+   pnpm tools-dev
+   ```
+4. 在 OD 中选择合适 surface：
+   - prototype：`web-prototype`、`saas-landing`、`dashboard`、`mobile-app` 等。
+   - deck：`guizang-ppt`、`simple-deck`、`weekly-update` 等。
+   - document-like：`pm-spec`、`eng-runbook`、`finance-report`、`team-okrs` 等。
+5. 生成后把关键产物回落到 TSP：
+   - artifact 路径或导出文件
+   - 使用的 OD skill、design system、visual direction
+   - 约束与自检结论
+   - 对 `/team-plan`、`/team-execute`、`/team-review` 或 `/team-release` 的决策影响
+6. 若 artifact 会进入实现，frontend 角色必须继续执行 TSP 前端门禁：
+   - 响应式、键盘访问、对比度、性能、加载/空态/错误态
+   - 真实数据与授权素材检查
+   - 不能把 OD 输出直接视为生产代码完成
+
+## 输出约定
+
+- TSP 侧只沉淀集成证据，不复制 Open Design 源码或生成数据库。
+- 推荐在消费方项目中落盘：
+  - `docs/artifacts/<date>-open-design-brief.md`
+  - `docs/artifacts/<date>-open-design-review.md`
+  - 需要长期复用时，将最终 `DESIGN.md` 放在项目根目录或设计文档目录。
+- 最小交付字段：
+  - 任务目标
+  - 使用的 OD skill / design system / visual direction
+  - 产物路径或导出格式
+  - 主要设计决策及证据
+  - 风险、未验证项、下一步 TSP 命令
+
+## 边界与禁用项
+
+- 只有 TSP `full` profile 会自动 clone/update Open Design；其他 profile 只安装 TSP 侧 skill/runbook。
+- 不把 Open Design 当作 TSP 的默认 npm 依赖；它要求独立 Node/pnpm/daemon 生命周期。
+- 不在本仓库 vendoring Open Design 的 `skills/`、`design-systems/`、daemon、web app 或 SQLite 数据。
+- 不把 OD 的视觉结果绕过 `/team-review` 直接发布。
+- 不使用未授权品牌素材、字体、截图或第三方图片作为可分发 artifact。
+- 不在 TSP 管理仓库中运行会改写本仓库 hooks、AGENTS 或 MCP 契约的外部 setup 命令。
+
+## 推荐组合
+
+- 需求到原型：`/team-intake -> frontend-ui-ux-system -> open-design -> /team-plan`
+- UI 实施：`/team-execute -> open-design artifact evidence -> frontend-engineering -> /handoff`
+- 视觉评审：`/team-review -> open-design artifact review -> browser-smoke-testing`
+- Deck / 汇报材料：`frontend-slides -> open-design deck mode -> /team-release`

package/skills/open-design/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Open Design"
+  short_description: "用 Open Design 生成和评审本地优先设计 artifact"
+  default_prompt: "Use $open-design when a TSP task needs local-first prototypes, decks, dashboards, mobile flows, DESIGN.md systems, or exportable visual artifacts. Keep Open Design external, avoid vendoring upstream runtime assets, and feed artifact evidence back into /team-plan, /team-execute, or /team-review."