openfeel 1.0.0

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "openfeel",
+  "version": "1.0.0",
+  "description": "AI Agent 开发流程治理 CLI 工具",
+  "type": "module",
+  "private": false,
+  "bin": {
+    "openfeel": "./bin/openfeel.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "node build.js",
+    "test": "vitest run",
+    "dev": "vitest",
+    "postinstall": "node scripts/patch-inquirer.js"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.5.2",
+    "commander": "^14.0.0",
+    "fast-glob": "^3.3.3",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^3.0.0",
+    "@vitest/coverage-v8": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Liuary/OpenFeel.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Liuary/OpenFeel/issues"
+  },
+  "keywords": [
+    "ai-agent",
+    "cli",
+    "workflow",
+    "governance",
+    "openfeel"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "schemas",
+    "scripts"
+  ]
+}

package/schemas/spec-driven/schema.yaml

@@ -0,0 +1,50 @@
+name: spec-driven
+version: "1.0"
+description: "规范驱动开发工作流 — proposal → specs → design → tasks → implementation → review → archive"
+
+artifacts:
+  - id: proposal
+    description: "项目提案文档"
+    generates: "docs/proposal.md"
+    template: "proposal.md"
+    requires: []
+    instruction: "创建项目提案文档，描述项目目标、范围和初步技术方案"
+
+  - id: specs
+    description: "功能规范文档"
+    generates: "docs/specs/**/*.md"
+    template: "plan.md"
+    dependsOn: ["proposal"]
+    instruction: "根据提案撰写详细功能规范"
+
+  - id: design
+    description: "技术设计文档"
+    generates: "docs/design.md"
+    template: "design.md"
+    dependsOn: ["specs"]
+    instruction: "根据规范制定技术设计方案"
+
+  - id: tasks
+    description: "任务分解"
+    generates: "docs/tasks.md"
+    template: "tasks.md"
+    dependsOn: ["design"]
+    instruction: "将设计方案分解为可执行的开发任务"
+
+  - id: implementation
+    description: "代码实现"
+    generates: "src/**/*.ts"
+    dependsOn: ["tasks"]
+    instruction: "按照任务列表进行代码实现"
+
+  - id: review
+    description: "代码审查"
+    generates: "docs/review.md"
+    dependsOn: ["implementation"]
+    instruction: "对实现代码进行审查，输出审查报告"
+
+  - id: archive
+    description: "项目归档"
+    generates: "docs/archive.md"
+    dependsOn: ["review"]
+    instruction: "归档项目文档和最终产出"

package/schemas/spec-driven/templates/design.md

@@ -0,0 +1,43 @@
+# 技术设计
+
+> 基于规范：{specs_link}
+
+## 架构概览
+
+<!-- 系统整体架构图（可用 Mermaid 或文字描述） -->
+
+## 技术选型
+
+| 层级 | 技术 | 理由 |
+|------|------|------|
+| | | |
+
+## 模块设计
+
+### 模块 A: {名称}
+
+<!-- 职责、接口、依赖关系 -->
+
+### 模块 B: {名称}
+
+<!-- 职责、接口、依赖关系 -->
+
+## 数据流
+
+<!-- 描述核心业务流程的数据流动 -->
+
+## 接口规范
+
+<!-- 各模块间的契约和接口定义 -->
+
+## 错误处理
+
+<!-- 异常情况的处理策略 -->
+
+## 安全设计
+
+<!-- 安全相关设计（鉴权、数据加密等） -->
+
+## 部署与运维
+
+<!-- 部署方案、监控、日志策略 -->

package/schemas/spec-driven/templates/plan.md

@@ -0,0 +1,46 @@
+# 功能规范
+
+> 基于提案：{proposal_link}
+
+## 功能概览
+
+<!-- 以用户视角描述系统功能 -->
+
+## 用户故事
+
+<!-- 按用户角色编写的功能需求 -->
+
+### 故事 1: {标题}
+
+**作为** {角色}
+**我想要** {功能}
+**以便于** {目标}
+
+#### 验收标准
+
+- [ ] 
+
+## 功能需求
+
+### FR-01: {功能名称}
+
+<!-- 详细描述功能需求 -->
+
+## 非功能需求
+
+- 性能：
+- 安全：
+- 可用性：
+- 可维护性：
+
+## 接口定义
+
+<!-- 如有 API 或模块接口，在此定义 -->
+
+## 数据模型
+
+<!-- 核心数据实体和关系描述 -->
+
+## 边界与约束
+
+<!-- 本阶段的边界条件和限制 -->

package/schemas/spec-driven/templates/proposal.md

@@ -0,0 +1,35 @@
+# 项目提案
+
+> 项目名称：{project_name}
+
+## 项目目标
+
+<!-- 描述项目要解决的核心问题和期望达成的目标 -->
+
+## 项目范围
+
+<!-- 明确项目边界，列出包含和不包含的功能 -->
+
+### 包含范围
+
+- 
+
+### 不包含范围
+
+- 
+
+## 初步技术方案
+
+<!-- 描述技术选型、架构思路、关键决策 -->
+
+## 成功标准
+
+<!-- 定义项目成功的可衡量标准 -->
+
+## 风险与约束
+
+<!-- 识别已知风险和约束条件 -->
+
+## 时间线
+
+<!-- 粗略的时间估算和里程碑 -->

package/schemas/spec-driven/templates/tasks.md

@@ -0,0 +1,39 @@
+# 任务分解
+
+> 基于设计：{design_link}
+
+## 任务列表
+
+### 阶段 1: {阶段名称}
+
+- [ ] **TASK-001**: {任务标题}
+  - 描述：
+  - 涉及文件：
+  - 预估工时：
+  - 依赖任务：
+
+- [ ] **TASK-002**: {任务标题}
+  - 描述：
+  - 涉及文件：
+  - 预估工时：
+  - 依赖任务：TASK-001
+
+### 阶段 2: {阶段名称}
+
+- [ ] **TASK-003**: {任务标题}
+  - 描述：
+  - 涉及文件：
+  - 预估工时：
+  - 依赖任务：
+
+## 执行顺序
+
+<!-- 任务间的依赖关系和推荐执行顺序 -->
+
+## 风险任务
+
+<!-- 标注高风险的复杂任务 -->
+
+## 预估总工时
+
+<!-- 汇总所有任务的预估工时 -->

package/scripts/patch-inquirer.js

@@ -0,0 +1,70 @@
+/**
+ * 补丁：修复 @inquirer/core 在 Node.js 20 下的兼容性问题
+ *
+ * @inquirer/core@11.1.0+ 使用了 Node.js 22+ 的 `styleText` API（from 'node:util'），
+ * 在 Node.js 20 下报错 "styleText is not exported from node:util"。
+ *
+ * 方案：将 `import { styleText } from 'node:util'` 替换为
+ * 局部定义的等效函数，保留所有调用点不变。
+ */
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const rootDir = resolve(__dirname, '..');
+
+const files = [
+  resolve(rootDir, 'node_modules/@inquirer/core/dist/lib/Separator.js'),
+  resolve(rootDir, 'node_modules/@inquirer/core/dist/lib/theme.js'),
+];
+
+// ANSI 颜色名称到转义码的映射
+const ANSI_CODES = { bold: 1, dim: 2, red: 31, green: 32, yellow: 33, blue: 34, magenta: 35, cyan: 36, white: 37 };
+
+/** 生成 styleText 的替换函数源码 */
+function generateStyleTextFn() {
+  const codeMap = JSON.stringify(ANSI_CODES);
+  return `const styleText = (fmt, txt) => { const c = ${codeMap}[fmt]; return c ? \`\\x1b[\${c}m\${txt}\\x1b[0m\` : txt; };`;
+}
+
+function patchFile(filePath) {
+  if (!existsSync(filePath)) {
+    console.error(`[patch-inquirer] 文件不存在，跳过: ${filePath}`);
+    return false;
+  }
+
+  let content = readFileSync(filePath, 'utf-8');
+  const original = content;
+
+  // 替换: import { styleText } from 'node:util'  →  局部函数定义
+  const importRegex = /import\s*\{[^}]*\bstyleText\b[^}]*\}\s*from\s*['"]node:util['"];?\s*/;
+  if (!importRegex.test(content)) {
+    console.log(`[patch-inquirer] 未找到 styleText 导入，跳过: ${filePath}`);
+    return false;
+  }
+
+  // 检查是否已经有我们的补丁（幂等保护）
+  if (content.includes('// patched by openfeel')) {
+    console.log(`[patch-inquirer] 已修补，跳过: ${filePath}`);
+    return false;
+  }
+
+  content = content.replace(importRegex, generateStyleTextFn() + '\n// patched by openfeel\n');
+
+  if (content === original) {
+    console.log(`[patch-inquirer] 无需修改: ${filePath}`);
+    return false;
+  }
+
+  writeFileSync(filePath, content, 'utf-8');
+  console.log(`[patch-inquirer] ✅ 已修补: ${filePath}`);
+  return true;
+}
+
+// 执行
+let count = 0;
+for (const f of files) {
+  if (patchFile(f)) count++;
+}
+console.log(`[patch-inquirer] 完成: ${count} 个文件已修补`);