feat(init): bundle contract templates into project root

Author: SeasonsChange422

TMLSPEC-cli/.gitignore

@@ -1,4 +1,5 @@
 node_modules/
+contract/
 dist/
 *.log
 npm-debug.log*

TMLSPEC-cli/README.md

@@ -7,6 +7,7 @@ TMLSPEC CLI 是一个轻量初始化工具，用于向当前工作区注入项
 - 安装 `tml-spec` 命令
 - 执行 `tml-spec init` 选择目标工具
 - 向对应工具目录下的 `tml-spec/` 子目录注入 `project` 与 `requirement` 两个命令文件
+- 将打包内置的 `contract/` 模板目录复制到目标项目根目录
 
 ## 快速开始
 
@@ -46,7 +47,8 @@ tml-spec init
 - 决定是否覆盖已有文件。
 
 7. 初始化完成后，到对应工具目录下的 `tml-spec/` 子目录使用生成的 `project` 和 `requirement` 命令文件。
-8. 在模型会话输入框中输入/tml-spec xxx调用对应的命令
+8. 在目标项目根目录查看自动复制的 `contract/` 模板目录。
+9. 在模型会话输入框中输入/tml-spec xxx调用对应的命令
 
 ### 方式二：在仓库中本地开发和调试
 
@@ -109,6 +111,7 @@ registry=https://registry.npmjs.org/
 
 ## 生成结果
 
+- `contract/`（复制到目标项目根目录）
 - `.claude/commands/tml-spec/project.md`
 - `.claude/commands/tml-spec/requirement.md`
 - `~/.codex/prompts/tml-spec-project.md`

TMLSPEC-cli/package-lock.json

@@ -1,20 +1,23 @@
 {
   "name": "@tml/tmlspec-cli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Inject project and requirement command files for team workflows.",
   "type": "module",
   "bin": {
     "tml-spec": "bin/tml-spec.js"
   },
   "files": [
     "bin",
+    "contract",
     "dist",
     "src/core/commands",
     "README.md"
   ],
   "scripts": {
+    "prebuild": "node ./scripts/sync-contract.mjs",
     "build": "tsc -p tsconfig.json",
     "dev": "tsx src/cli/index.ts",
+    "prepack": "node ./scripts/sync-contract.mjs",
     "start": "node ./bin/tml-spec.js"
   },
   "keywords": [

TMLSPEC-cli/package.json

@@ -0,0 +1,18 @@
+import { cpSync, existsSync, mkdirSync, rmSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const currentDir = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(currentDir, '..');
+const sourceDir = path.resolve(packageRoot, '..', 'contract');
+const targetDir = path.join(packageRoot, 'contract');
+
+if (!existsSync(sourceDir)) {
+  throw new Error(`Contract source directory does not exist: ${sourceDir}`);
+}
+
+rmSync(targetDir, { recursive: true, force: true });
+mkdirSync(packageRoot, { recursive: true });
+cpSync(sourceDir, targetDir, { recursive: true });
+
+console.log(`Synchronized contract directory to ${targetDir}`);

TMLSPEC-cli/scripts/sync-contract.mjs

@@ -1,9 +1,14 @@
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { checkbox, confirm, input } from '@inquirer/prompts';
 import { getAdapter } from './adapters/index.js';
 import { TOOL_OPTIONS } from './catalog.js';
 import type { InitAnswers, ToolId } from './types.js';
-import { writeTextFile } from '../utils/fs.js';
+import { copyDirectory, writeTextFile } from '../utils/fs.js';
+
+const currentDir = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(currentDir, '../..');
+const bundledContractDirectory = path.join(packageRoot, 'contract');
 
 interface InitOverrides {
   projectRoot?: string;
@@ -91,16 +96,21 @@ export async function runInit(overrides: InitOverrides = {}): Promise<void> {
     }
   }
 
+  const contractTargetPath = path.join(answers.projectRoot, 'contract');
+  const contractCopied = await copyDirectory(bundledContractDirectory, contractTargetPath, answers.force);
+
   const relativeRoot = path.relative(process.cwd(), answers.projectRoot) || '.';
   console.log('TML Spec 命令已初始化。');
   console.log(`项目根目录: ${relativeRoot}`);
   console.log(`已选择工具: ${answers.tools.join(', ')}`);
   console.log(`写入文件数: ${writtenFiles}`);
   console.log(`跳过文件数: ${skippedFiles}`);
+  console.log(`contract 模板目录: ${contractCopied ? '已写入项目根目录' : '已存在，未覆盖'}`);
   console.log('下一步:');
   console.log('1. 在你的 IDE 中打开生成的命令或 prompt 文件。');
-  console.log('2. 使用 tml-spec 命名空间下的 project 命令处理项目级文档工作。');
-  console.log('3. 使用 tml-spec 命名空间下的 requirement 命令处理需求级工作，并路由到 openspec。');
+  console.log('2. 在项目根目录下查看 contract 模板目录，并按需补充团队规范。');
+  console.log('3. 使用 tml-spec 命名空间下的 project 命令处理项目级文档工作。');
+  console.log('4. 使用 tml-spec 命名空间下的 requirement 命令处理需求级工作，并路由到 openspec。');
 }
 
 export function parseInitOverrides(options: {

TMLSPEC-cli/src/core/init.ts

@@ -1,4 +1,4 @@
-import { access, mkdir, writeFile } from 'node:fs/promises';
+import { access, cp, mkdir, rm, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 
 export async function ensureDirectory(dirPath: string): Promise<void> {
@@ -22,4 +22,22 @@ export async function writeTextFile(filePath: string, content: string, overwrite
   await ensureDirectory(path.dirname(filePath));
   await writeFile(filePath, content, 'utf8');
   return true;
+}
+
+export async function copyDirectory(sourcePath: string, targetPath: string, overwrite = true): Promise<boolean> {
+  if (!await pathExists(sourcePath)) {
+    throw new Error(`Source directory does not exist: ${sourcePath}`);
+  }
+
+  if (!overwrite && await pathExists(targetPath)) {
+    return false;
+  }
+
+  if (overwrite && await pathExists(targetPath)) {
+    await rm(targetPath, { recursive: true, force: true });
+  }
+
+  await ensureDirectory(path.dirname(targetPath));
+  await cp(sourcePath, targetPath, { recursive: true, force: overwrite });
+  return true;
 }