@colin4k1024/tsp 2.4.0 → 2.4.1

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."